Citrix Application Delivery Management

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. Al ejecutar 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 de servidor virtual y servicios y direcciones IP. Puede utilizar la función de trabajos de configuración para lograr esto mediante el uso de variables para definir los nombres y las direcciones IP del servidor virtual y los servicios.

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 Citrix ADM:

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

  2. Haga clic en Crear trabajo.

  3. En la página Crear Trabajo, seleccione los parámetros de trabajo personalizados, 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 campo ipaddress del servidor de equilibrio de carga y haga clic en Convertir a variable como se muestra en la siguiente imagen.

    Imagen localizada

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

    Imagen localizada

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

    Imagen localizada

  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 Redes > 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 modifica un trabajo de configuración, vaya a Red > Trabajos de configuración, seleccione el nombre del trabajo y haga clic en Modificar. 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.

    Imagen localizada

  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.

    Imagen localizada

  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 de variable, seleccione la opción Cargar archivo de entrada para valores variables y, a continuación, haga clic en Descargar archivo de 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 modificarlo especificando los valores de variable para cada instancia de Citrix ADC que haya seleccionado anteriormente y haga clic en Cargar para cargar el archivo de clave de entrada en Citrix ADM. Haga clic en Siguiente. El archivo de clave de entrada se descarga en el sistema local y puede modificarlo especificando los valores de variable para cada instancia de Citrix ADC 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 en todas las instancias. Los valores de variables de nivel de grupo de instancias se aplican a todas las instancias definidas en un grupo. Los valores de variable de nivel de instancia solo se aplican a una instancia específica.

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

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

    Imagen localizada

    Importante

    Cuando carga un archivo CSV desde un Mac, 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 enCargarpara cargar el archivo de clave de entrada en Citrix 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 ejecutados al crear un trabajo de configuración, vaya a Red > Trabajos de configuración y haga clic en Crear trabajo. En la página Crear 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).

    Para ver los trabajos de configuración ya ejecutados mientras modifica un trabajo de configuración, vaya a Red > Trabajos de configuración, seleccione el nombre del trabajo y haga clic en Modificar. 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 elegir ejecutar su trabajo ahora o programarlo para que se ejecute más adelante. También puede elegir qué acción debe realizar Citrix 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.

    Imagen localizada

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

Imagen localizada

Nota

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

Usar variables en trabajos de configuración