Usar variables en trabajos de configuración

Un trabajo de configuración es un conjunto de comandos de configuración que se pueden ejecutar en una o más instancias administradas. Cuando ejecuta la misma configuración en varias instancias, es posible que quiera utilizar valores diferentes para los parámetros utilizados en la configuración. Puede definir variables que le permitan asignar valores diferentes para estos parámetros o ejecutar un trabajo en varias instancias.

Por ejemplo, considere una configuración básica de equilibrio de carga en la que agregue un servidor virtual de equilibrio de carga, agregue dos servicios y vincule los servicios al servidor virtual. Ahora, es posible que quiera tener la misma configuración en dos instancias, pero con valores diferentes para los nombres y direcciones IP del servidor y los servicios virtuales. Puede utilizar la función de trabajos de configuración para lograrlo mediante variables para definir los nombres y las direcciones IP del servidor y los servicios virtuales.

En este ejemplo, se utilizan los siguientes comandos y variables:

add lb vserver <servername> HTTP <ipaddress> <portnumber>

add service <servicename1> <ipaddress1> HTTP 80

add service <servicename2> <ipaddress2> HTTP 80

bind lb vserver <servername> <servicename1>

bind lb vserver <servername> <servicename2>

Para crear un trabajo de configuración definiendo variables en NetScaler ADM:

1. Vaya a Infraestructura > Trabajos de configuración.

2. Haga clic en Crear trabajo.

3. En la página Crear trabajo, seleccione los parámetros personalizados del trabajo, como el nombre del trabajo, el tipo de instancia y el tipo de configuración.

4. En el Editor de configuración, escriba los comandos para agregar un servidor virtual de equilibrio de carga, dos servicios y enlazar los servicios al servidor virtual. Haga doble clic para seleccionar los valores que quiere convertir en una variable y, a continuación, haga clic en Convertir en variable. Por ejemplo, seleccione la dirección IP del servidor de equilibrio de carga y *ipaddress*haga clic en Convertir en variable.

5. Una vez que vea signos de dólar encierran el valor de la variable, haga clic en la variable para especificar más detalles de la variable, como el nombre, el nombre para mostrar y el tipo. También puede hacer clic en la opción Avanzado si quiere especificar un valor predeterminado para la variable. Haga clic en Guardar y, a continuación, haga clic en Siguiente.

   Escriba el resto de sus comandos y defina todas las variables.

6. Puede revisar todas las variables que ha definido al crear o modificar un trabajo de configuración en una sola vista consolidada.

7. Siga uno de estos procedimientos para ver todas las variables en una sola vista consolidada:

   • Mientras crea un trabajo de configuración, vaya a Infraestructura > Trabajos de configuración, seleccione Crear trabajo. En la página Crear Trabajo, puede revisar todas las variables que ha agregado al crear el trabajo de configuración.

   • Mientras edita un trabajo de configuración, vaya a Red > Trabajos de configuración , seleccione el nombre del trabajo y haga clic en Editar . En la página Configurar trabajo, puede revisar todas las variables que se agregaron al crear el trabajo de configuración.

8. A continuación, puede hacer clic en la ficha Vista previa de variables para obtener una vista previa de las variables en una única vista consolidada que haya definido al crear o modificar un trabajo de configuración.

9. Aparece una nueva ventana emergente que muestra todos los parámetros de variables como Nombre, Nombre para mostrar, Tipo y valor predeterminado en un formato tabular. También puede modificar y modificar estos parámetros. Haga clic en el botón Listo después de modificar o modificar cualquiera de los parámetros.

   

10. A continuación, puede reorganizar y reordenar los comandos en el editor de configuración según corresponda. Puede mover el comando de una línea a otra arrastrando y soltando la línea de comandos. También puede mover o reorganizar la línea de comandos de una línea a cualquier línea de destino simplemente cambiando el número de línea de comandos en el cuadro de texto.

11. Seleccione las instancias en las que quiere ejecutar el trabajo de configuración.

12. En la ficha Especificar valores variables, seleccione la opción Cargar archivo de entrada para valores variablesy, a continuación, haga clic en Descargar archivo clave de entrada. En nuestro ejemplo, deberá especificar el nombre del servidor en cada instancia, las direcciones IP del servidor y los servicios, los números de puerto y los nombres de servicio. Guarde el archivo y cárguelo. Si sus valores no están definidos con precisión, el sistema podría generar un error.

13. El archivo de clave de entrada se descarga en su sistema local y puede modificar lo especificando los valores de las variables para cada instancia de NetScaler que haya seleccionado anteriormente y hacer clic en Cargar para cargar el archivo de clave de entrada en NetScaler ADM. Haga clic en Siguiente. El archivo de clave de entrada se descarga en su sistema local y puede modificarlo especificando los valores de las variables para cada instancia de NetScaler que haya seleccionado anteriormente.

    Nota En el archivo de clave de entrada, las variables se definen en tres niveles:

    • Nivel mundial
    • Nivel de grupo de instancias
    • Nivel de instancia

    Las variables globales son valores variables que se aplican a todas las instancias. Los valores de las variables de nivel de grupo de instancias se aplican a todas las instancias que se definen en un grupo. Los valores de las variables de nivel de instancia solo se aplican a una instancia específica.

    NetScaler ADM da la primera prioridad a los valores a nivel de instancia. Si no se proporcionan valores a las variables de las instancias individuales, NetScaler ADM utiliza el valor proporcionado a nivel de grupo. Si no se proporcionan valores a nivel de grupo, NetScaler ADM utiliza el valor de la variable proporcionado a nivel global. Si proporciona una entrada para una variable en los tres niveles, NetScaler ADM utiliza el valor de nivel de instancia como valor predeterminado.

14. Haga clic en Cargar para cargar el archivo de clave de entrada a NetScaler ADM. Haga clic en Siguiente.

    

    Importante

    Cuando subes un archivo CSV desde un Mac, el Mac almacena el archivo CSV con punto y coma en lugar de comas. Esto hará que la configuración falle al cargar el archivo de entrada y ejecutar el trabajo. Si está utilizando un Mac, utilice un editor de texto para realizar los cambios necesarios y, a continuación, cargue el archivo.

15. También puede proporcionar valores de variable comunes en todas las instancias y hacer clic en Cargarpara cargar el archivo de clave de entrada en NetScaler ADM.

    Los archivos de entrada clave que contienen los valores de las variables se conservan (con el mismo nombre de archivo) en los trabajos de configuración. Puede ver y modificar estos archivos de entrada que ha utilizado y cargado anteriormente al crear o modificar los trabajos de configuración.

    Para ver los trabajos de configuración en ejecución al crear un trabajo de configuración, vaya a Red > Trabajos de configuracióny haga clic en Crear trabajo. En la página Crear trabajo. En la ficha Especificar valores de variables, seleccione la opción Valores de variables comunes para todas las instancias para ver los archivos cargados. Para modificar los archivos de entrada, descargue el archivo de entrada y, a continuación, modifique y cargue los archivos (manteniendo el mismo nombre de archivo).

    Para ver los trabajos de configuración ya ejecutados al editar un trabajo de configuración, vaya a Red > Trabajos de configuración , seleccione el nombre del trabajo y haga clic en Editar . En la página Configurar Trabajo, en la ficha Especificar Valores de Variable, seleccione la opción Valores de Variable Comunes para todas las Instancias para ver los archivos cargados. Para modificar los archivos de entrada, descargue el archivo de entrada y, a continuación, modifique y cargue los archivos (manteniendo el mismo nombre de archivo).

16. En la ficha Vista previa del trabajo, puede evaluar y comprobar los comandos que se van a ejecutar en cada instancia o grupo de instancias.

17. En la ficha Ejecutar, puede optar por ejecutar el trabajo ahora o programarlo para que se ejecute posteriormente. También puede elegir qué acción debe tomar NetScaler ADM si el comando falla y si quiere enviar una notificación por correo electrónico sobre el éxito o el fracaso del trabajo junto con otros detalles.

    

Después de configurar sus trabajos y ejecutarlos, puede ver los detalles del trabajo en Infraestructura > Trabajos de configuración y seleccionar el trabajo que acaba de configurar. Haga clic en Detalles y, a continuación, en Detalles de la variable para ver la lista de variables agregadas a su trabajo.

Nota

NetScaler ADM conserva los valores que ha proporcionado para las variables en PASO 5 al guardar el trabajo y salir, o al programar la ejecución de un trabajo en un momento posterior.