Servicio Citrix Application Delivery Management

Utilizar la plantilla de configuración maestra

El uso de una plantilla de configuración maestra es una opción flexible para crear e implementar una configuración maestra en varias instancias de Citrix ADC.

Como administrador, es posible que quiera realizar cambios en la configuración y guardar licencias, certificados y otros archivos en una instancia de Citrix ADC. Puede guardar la nueva configuración como una plantilla de configuración maestra (archivo CONF).

Para guardar la plantilla de configuración maestra desde una instancia de Citrix ADC, puede realizar una de las siguientes acciones:

  • En la solicitud de comando, escriba save ns config. La configuración se guarda en la memoria FLASH de la instancia en el archivo /nsconfig/ns.conf.
  • Desde la interfaz gráfica de usuario de la instancia de Citrix ADC, vaya a Diagnósticos > Ver configuración. Elija el tipo de configuración que quiere guardar. Por ejemplo, si quiere guardar la configuración guardada de su instancia de Citrix ADC, seleccione Configuración guardada. Haga clic en el enlace Guardar texto en un archivo para guardar el archivo ‘ns.conf’ en su equipo local.

Cuando implementa la plantilla de configuración maestra mediante la plantilla de configuración ‘DeployMasterConfiguration’ mientras crea un trabajo, puede personalizarla aún más para cada instancia específica de Citrix ADC agregando comandos adicionales, modificando los comandos existentes y proporcionando diferentes valores de variable en el cuadro de diálogo archivo de entrada.

Por ejemplo, como administrador, es posible que quiera cargar claves de certificado en las instancias de Citrix ADC además del archivo ns.conf e implementar la configuración maestra en ellas también.

Importante

No puede ejecutar un trabajo de configuración con la plantilla DeployMasterConfiguration en instancias CPX de Citrix ADC, instancias de Citrix ADC configuradas en un clúster o instancias de Citrix ADC particionadas.

Para crear un trabajo de configuración con la plantilla de configuración Master Config en Citrix ADM:

  1. En Citrix Application Delivery Management (ADM), vaya a Redes > Trabajos de configuración y, a continuación, haga clic en Crear trabajo.

  2. En la página Crear Trabajo, en la ficha Seleccionar Configuración, especifique el Nombre del Trabajo y seleccione el Tipo de Instancia en la lista desplegable.

  3. Seleccione Configuración maestra en la lista desplegable Origen de configuración. Arrastre los comandos de la plantilla DeployMasterConfiguration al panel derecho. También puede agregar, modificar o eliminar comandos en el panel derecho. Haga clic en Siguiente.

    Nota

    Puede agregar comandos put para agregar archivos de entrada a su plantilla. En nuestro ejemplo, necesitamos cargar los archivos de certificado y clave además del archivo de plantilla de configuración y los archivos de entrada de variables.

    Configuración maestra

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

  5. 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.

  6. 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.

    Vista previa de configuración de ejemplo

  7. 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.

    Variables especificadas

  8. Seleccione las instancias en las que quiere ejecutar el trabajo de configuración y, a continuación, haga clic en Siguiente.

  9. En la ficha Especificar valores de variable, cargue lo siguiente:

    • Archivo de plantilla de configuración (CONF): Cargue el archivo CONF que extrajo de una instancia de Citrix ADC.
    • Cargar el archivo de entrada (.xml/csv): Cargar el archivo de entrada con valores para las variables que ha definido en sus comandos.

    Aquí se proporciona un archivo xml de ejemplo para su uso. Asegúrese de que los archivos xml contienen los detalles correspondientes a las instancias ADC que está utilizando.

    
    <?xml version="1.0" encoding="UTF-8" ?>
    
    <properties>
    
    <!-- 
    
    Provide inputs for all the parameters defined in the master config file.
    
    -  global. This tag contains all the common parameters and value.
    
    -  devicegroup. This tag contains all the instance group specific parameters and values.
    
    If the same parameters are defined in global and instance tags, the instance specific parameters value will take precedence over the instance group. The instance group specific parameters value will take precedence over global parameters in the execution.	        
    
    -  name. This attribute represents the name of the instance group.
    
    -  device. This tag contains all the instance specific parameters and value. 
    
    If the same parameters are defined in global and instance tags, the instance specific parameters value will take precedence in the execution.
    
    -  name. This attribute represents the IP Address of the instance. Host name is not supported for the attibute.
    
    HA pair should be represented as <primaryip>-<secondaryip>. Example 10.102.2.1-10.102.2.2
    
    In the template file, the parameter name must be specified within the dollar sign,Example: $NSIP$, $CC_Trap_Dest$ and parameters names are case sensitive.
    -->
    
    <global>
    
    </global>
    <devicegroup name="BLR_DEVS">
    </devicegroup>
    <device name="10.106.101.209">
    <param name="IP" value="10.106.101.209"/>
    </device>
    
    <!-- HA PAIR-->
    <!--<device name="10.102.43.154-10.102.43.155">
    <param name="NSIP" value="10.102.43.154"/>
    <param name="HostName" value="NS43HA"/>
    <param name="LBSERVER" value="haserver43http"/>
    <param name="SNMPTrapDest" value="10.102.43.130"/>
    </device>-->
    </properties>
    
    

    Aquí se proporciona un archivo csv de ejemplo para su uso.

    #job-s_variable_input_key_file ,,,,
    ,,,,
    #Global,NSIP,HostName,LBSERVER,SNMPTrapDest
    Global Values,,,,
    #InstanceGroup,NSIP,HostName,LBSERVER,SNMPTrapDest
    example_doc,,,,
    #Instance(s),NSIP,HostName,LBSERVER,SNMPTrapDest
    10.xx.xx.xx,,,,
    

    El mismo archivo se muestra en Microsoft excel:

    Ejemplo CSV en excel

  10. Haga clic en Siguiente.

    Seleccionar archivos

    Los archivos de entrada 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).

  11. 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 y, a continuación, hacer clic en Siguiente.

    Imagen localizada

  12. 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.

    También puede optar por permitir que los usuarios autorizados ejecuten trabajos en las instancias administradas, y puede elegir 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 ejecutar el trabajo, puede ver los detalles del trabajo navegando a Redes > Trabajos de configuración y seleccione el trabajo que acaba de configurar. Haga clic en Detalles y, a continuación, haga clic en Resumen de ejecución para ver los detalles de su trabajo. Haga clic en la instancia para ver los registros de comandos para ver los comandos ejecutados en el trabajo.

    Imagen localizada

Utilizar la plantilla de configuración maestra