Guía de configuración CLI para el controlador Omada SDN (v5.9.9 y superior)

A partir de la versión 5.9, Omada SDN Controller admite la función de configuración de CLI, que le permite crear y emitir perfiles de configuración mediante CLI. Esta función está diseñada como un enfoque complementario cuando algunas funciones o configuraciones no están disponibles en la GUI.

El controlador Omada SDN admite dos tipos de configuración CLI: CLI del sitio y CLI del dispositivo.

■ CLI del sitio: se emitirán perfiles de configuración para todos los dispositivos que admitan la configuración CLI

■ CLI del dispositivo: se emitirán perfiles de configuración para los dispositivos seleccionados que admitan la configuración CLI.

Actualmente, solo los conmutadores Omada admiten la configuración CLI. Para obtener más información sobre los comandos de la CLI para los conmutadores Omada, consulte la Guía de referencia de la CLI .

Antes de usar la configuración CLI, asegúrese de leer atentamente las siguientes precauciones y la Guía del usuario para evitar errores inesperados. Si encuentra algún problema, puede comunicarse con el soporte técnico de TP-Link.

 

1. Precauciones

1.1 Precauciones generales

1. La configuración de GUI y CLI debe planificarse globalmente de acuerdo con la topología y los requisitos reales de la red.

2. No utilice la configuración de CLI para configurar las funciones que ya están disponibles en la GUI, ya que esto puede causar conflictos y hacer que la configuración de los dispositivos no se ajuste a sus expectativas.

a. Al adoptar un nuevo dispositivo, el controlador aplicará configuraciones al dispositivo en el orden de GUI, CLI del sitio y luego CLI del dispositivo. Si hay un conflicto de configuración, entra en vigor la última configuración aplicada.

b. Los perfiles CLI (incluidos los perfiles CLI del sitio y los perfiles CLI del dispositivo) solo se emitirán a los dispositivos una vez después de aplicados, a menos que se haga clic en el botón "Aplicar de nuevo" en el Resultado de la aplicación para activar la aplicación de configuraciones completas.

C. Cuando un dispositivo actualiza su firmware, el controlador aplicará las configuraciones completas al dispositivo en el orden de GUI, CLI del sitio y luego CLI del dispositivo.

d. Tenga en cuenta que la configuración posterior puede anular la configuración anterior, lo que da como resultado diferentes configuraciones de ejecución para diferentes dispositivos después de que la misma función se haya modificado varias veces a través de la GUI, la CLI del sitio o la CLI del dispositivo.

3. Omada Controller no verificará las configuraciones existentes de GUI y CLI de los dispositivos. Asegúrese de verificar las configuraciones existentes antes de realizar nuevas configuraciones. De lo contrario, pueden ocurrir resultados inesperados después de aplicar las configuraciones, y los dispositivos pueden incluso desconectarse.

4. Para evitar conflictos de configuración, si necesita configurar una función mediante la CLI, se recomienda que no la configure a través de la GUI al mismo tiempo.

5. Para evitar la desconexión de dispositivos del controlador debido a errores o conflictos de configuración, se recomienda configurar VLAN, interfaces VLAN, direcciones IP, ACL, etc. solo a través de la GUI y evitar modificar las configuraciones relevantes a través de la CLI.

 

1.2 Comandos que no surten efecto

Tenga en cuenta que es posible que algunos comandos no funcionen correctamente debido a la asignación de recursos de hardware en el modo Controlador. Incluso si los perfiles CLI que contienen estos comandos se pueden emitir y enumerar correctamente en la configuración en ejecución, es posible que no surtan efecto porque el dispositivo no tiene recursos de hardware para ejecutarlos.

Los comandos CLI de los siguientes módulos de funciones no pueden configurarse ni tener efecto, y deben evitarse:

• VLAN de protocolo
• L2PT
• ERP
• MAC/IP/Contenido del paquete/IPv6 ACL
• IMPB IPv4
• IMPB IPv6
• Filtro DHCPv4
• Filtro DHCPv6
• DoS Defend

 

2. CLI del sitio

Descripción general

Site CLI permite configuraciones por lotes de todos los dispositivos que admiten la configuración de CLI en el sitio a través de líneas de comando.

Configuración

1. Vaya a Configuración > Configuración de la CLI > CLI del sitio .

2. Haga clic en Crear nuevo perfil CLI del sitio y cree un perfil CLI según sus necesidades.

Nota:

• El carácter # es un comando especial que indica que se ingresa al modo de configuración. Úselo en una línea separada. Si agrega otros comandos después de este en la misma línea, se ignorarán. • Si un comando comienza con ! carácter, el comando será ignorado.

 

Nombre	Especifique el nombre del perfil CLI.
Descripción	(Opcional) Introduzca una descripción para la identificación.
CLI	Introduzca las líneas de comando manualmente.
Importar CLI desde el dispositivo	Haga clic y seleccione un dispositivo que admita la configuración CLI para importar su configuración en ejecución.
Importar CLI desde archivo	Haga clic y seleccione un archivo de comando existente para importar líneas de comando.

3. Haga clic en Guardar para agregar el perfil. El nuevo perfil está en estado inactivo y no se aplicará a los dispositivos.

4. Haga clic en Aplicar para aplicar la CLI. El perfil cambiará al estado activo y aplicará configuraciones a todos los dispositivos que admitan la configuración CLI en el sitio.

Nota:

Una vez que el perfil se active, no podrá editarlo.

Para verificar si el perfil se aplicó con éxito a los dispositivos y tiene efecto, haga clic en Ver detalles de la CLI para ver los resultados de la configuración en la página Dispositivos > Resultado de la aplicación .

Nota:

La eliminación de un perfil CLI no tendrá efecto en las configuraciones existentes en los dispositivos. Para borrar las configuraciones, utilice el comando “no”.

 

3. CLI del dispositivo

Descripción general

Device CLI permite la configuración por lotes de dispositivos específicos a través de líneas de comando.

La CLI del dispositivo admite variables. Puede usar el formato %x% para definir una variable x y luego establecer diferentes valores para diferentes conmutadores. Cuando el controlador aplica la configuración de la CLI del dispositivo a los conmutadores, modificará automáticamente la variable %x% a los valores establecidos.

Configuración

1. Vaya a Configuración > Configuración de la CLI > CLI del dispositivo . Haga clic en Crear nuevo perfil CLI de dispositivo y cree un perfil CLI según sus necesidades.

Nota:

•El carácter # es un comando especial, que indica el ingreso al modo de configuración. Úselo en una línea separada. Si agrega otros comandos después de este en la misma línea, se ignorarán. •Si un comando comienza con ! carácter, el comando será ignorado.

 

Nombre	Especifique el nombre del perfil CLI.
Descripción	(Opcional) Introduzca una descripción para la identificación.
CLI	Introduzca las líneas de comando manualmente. Puede ingresar %xxx% en la plantilla CLI para definir variables.
Importar CLI desde el dispositivo	Haga clic y seleccione un dispositivo que admita la configuración CLI para importar su configuración en ejecución.
Importar CLI desde archivo	Haga clic y seleccione un archivo de comando existente para importar líneas de comando.

2. Haga clic en Siguiente . Seleccione los dispositivos para aplicar el perfil CLI.

3. Haga clic en Guardar para agregar el perfil. El nuevo perfil está en estado inactivo y no se aplicará a los dispositivos.

4. Haga clic en Aplicar para aplicar la CLI. El perfil cambiará al estado activo y aplicará configuraciones a los dispositivos que seleccionó.

Nota:

Una vez que el perfil se active, no podrá editarlo.

Para verificar si el perfil se aplicó con éxito a los dispositivos y tiene efecto, haga clic en Ver detalles de la CLI para ver los resultados de la configuración en la página Dispositivos > Resultado de la aplicación .

Nota:

La eliminación de un perfil CLI no tendrá efecto en las configuraciones existentes en los dispositivos. Para borrar las configuraciones, utilice el comando “no”.