Migrar configpack de un StyleBook a otro StyleBook

En Citrix Application Delivery Management (ADM), los configpacks siempre están enlazados al StyleBook desde el que se crean. Cualquier actualización del paquete de configuración solo se puede hacer a través del StyleBook al que está vinculado el paquete de configuración. Citrix ADM ahora le permite migrar un paquete de configuración existente a un nuevo StyleBook. El nuevo StyleBook puede ser una versión más original del StyleBook actual que está enlazado al paquete de configuración. O bien, también puede migrar el paquete de configuración a un StyleBook completamente diferente.

Por ejemplo, creó un StyleBook llamado example-lb. Este StyleBook se utiliza para implementar una configuración básica del equilibrador de carga en una instancia de Citrix ADC. Ha creado un CP1 de configpack a partir de este StyleBook en una instancia de Citrix ADC. Más tarde, se dio cuenta de que su StyleBook no incluye una configuración de supervisión. Por lo tanto, ahora creó un StyleBook llamado example-lb-mon. Este StyleBook tiene la misma configuración del equilibrador de carga que example-lb StyleBook, pero agrega la capacidad de configurar monitores.

Ahora quiere actualizar la configuración existente que se creó en configpack CP1 para agregar algunos monitores. Anteriormente, tenía que eliminar el paquete de configuración CP1 y crear un paquete de configuración CP2 del nuevo StyleBook para agregar monitores a su configuración. La eliminación de CP1 da como resultado la eliminación de toda la configuración creada en configpack CP1 en una o más instancias de Citrix ADC. Anteriormente, tenía que volver a crear un paquete de configuración a través del nuevo StyleBook escribiendo valores para todos los parámetros.

En su lugar, ahora puede migrar el paquete de configuración CP1 existente al nuevo styleBook example-lb-mon. Su nuevo StyleBook puede configurar los detalles del monitor de monitores. Solo los objetos de configuración relacionados con el monitor se agregan a las instancias Citrix ADC donde se implementó el paquete de configuración. Tienes que proporcionar solo los detalles del monitor ahora. La configuración existente implementada en las instancias de Citrix ADC que no ha cambiado no se verá afectada.

Migración de configpacks

Para migrar un paquete de configuración creado usando example-lb StyleBook a example-lb-mon StyleBook

  1. En Citrix ADM, vaya a Aplicaciones > Configuraciones. La página Configuraciones muestra todos los paquetes de configuración presentes en el sistema.

  2. Desplácese hacia abajo para buscar el paquete de configuración example-lb que habría creado anteriormente y haga clic en Migrar paquete de configuración.

    Imagen localizada

  3. Se abre la página Elegir StyleBook de destino para la migración que enumera todos los StyleBooks disponibles en Citrix ADM. Desplácese hacia abajo para buscar el ejemplo-lb-mon StyleBook y haga clic en Seleccionar EstiloBook. También puede buscar el StyleBook escribiendo example-lb-mon.

    Imagen localizada

    Si migra de un StyleBook a otro, es posible que todos los parámetros de los dos StyleBooks no tengan la misma estructura. Si la estructura de parámetros es similar, los valores anteriores se conservan automáticamente en los campos de parámetros. Algunos de los parámetros en el nuevo StyleBook pueden ser nuevos, o puede haber un cambio en su estructura. En tal caso, debe rellenar manualmente los valores de los parámetros de StyleBook. Por ejemplo, la siguiente imagen muestra los parámetros del ejemplo-lb StyleBook.

    Imagen localizada

    La siguiente imagen muestra los parámetros después de migrar el paquete de configuración a example-lb-mon StyleBook.

    Imagen localizada

    En este caso, puede ver que los StyleBooks conservan los valores anteriores para la configuración básica del equilibrador de carga. Sin embargo, debe escribir manualmente los valores para los parámetros del monitor.

  4. Escriba los valores de los nuevos parámetros utilizados para crear monitores en la instancia.

  5. En Instancias de destino, haga clic en y seleccione la dirección IP de la instancia de Citrix ADC en la que quiere ejecutar la configuración. Tenga en cuenta que puede implementar la configuración en más de un Citrix ADC, especificando tantas instancias de destino como sea necesario.

  6. Haga clic en Ejecutar en seco. La página Objetos muestra los objetos que se crearían, modificarían o eliminarían de las instancias Citrix ADC.

  7. Haga clic en Crear para crear o actualizar la configuración de las instancias seleccionadas. El paquete de configuración se crea si las instancias de destino son nuevas. De lo contrario, se actualizan las configuraciones existentes implementadas en las instancias.

    NotaTambién

    puede hacer clic en el icono de actualización para agregar instancias de Citrix ADC detectadas recientemente. Por lo tanto, estas instancias están disponibles instantáneamente en la lista de instancias de esta ventana. El icono de actualización solo está disponible actualmente en Citrix ADM.

También puede migrar un paquete de configuración de una versión de un StyleBook a la siguiente versión. Aquí también es posible que tenga que escribir los valores de cualquier nuevo parámetro requerido presente en la nueva versión. También puede migrar el paquete de configuración a una versión anterior del StyleBook. En este caso, se eliminan los parámetros adicionales que no están presentes en el StyleBook anterior. La página Objetos muestra cualquiera de los objetos que se quitan de la configuración.

Después de una migración exitosa, el ConfigPack está enlazado al nuevo StyleBook.

Imagen localizada

Puede ver que el nombre del paquete de configuración y el ID de paquete de configuración son los mismos que antes. Pero Citrix ADM actualiza el nombre de StyleBook a example-lb-mon desde example-lb.

Crea tus StyleBooks

El contenido completo de example-lb StyleBook se proporciona a continuación para su referencia:

name: example-lb
namespace: examples.stylebooks
version: "1.0"
display-name: Basic Load Balancer App
description: This is an example StyleBook that creates a load balancer application
schema-version: "1.0"
import-stylebooks:
  -
    namespace: com.citrix.adc.stylebooks
    prefix: stlb
    version: "1.0"
parameters-default-sources:
  - stlb::lb
components:
  -
    name: lb-comp
    type: stlb::lb
    description: Uses the default lb StyleBook to build the typical lb configuration objects
    properties-default-sources:
      - $parameters

El contenido completo de example-lb-mon StyleBook se proporciona a continuación para su referencia:

name: example-lb-mon
namespace: examples.stylebooks
version: "1.0"
description: This is an example StyleBook that creates a load balancer application with monitors
display-name: Basic Load Balancer App with Monitors
schema-version: "1.0"
import-stylebooks:
  -
    namespace: netscaler.nitro.config
    prefix: ns
    version: "10.5"
  -
    namespace: com.citrix.adc.stylebooks
    prefix: stlb
    version: "1.0"
  -
    namespace: com.citrix.adc.commontypes
    prefix: cmtypes
    version: "1.0"
parameters-default-sources:
  - stlb::lb
parameters:
  -
    name: monitors
    label: "List of Monitors"
    description: "List of Monitors to monitor Application Servers"
    type: cmtypes::monitor[]
substitutions:
  mon-name(appname, monname): $appname + "-mon-" + $monname
components:
  -
    name: lb-comp
    type: stlb::lb
    description: Uses the default lb StyleBook to build the typical lb configuration objects
    properties-default-sources:
      - $parameters
  -
    name: monitors-comp
    type: cmtypes::monitor
    condition: $parameters.monitors
    repeat: $parameters.monitors
    repeat-item: mon
    repeat-index: ndx
    description: Builds a list of Citrix ADC monitor objects and binds them to the servicegroup of this LB config
    properties-default-sources:
      - $mon
    properties:
        monitorname: $substitutions.mon-name($parameters.lb-appname, $mon.monitorname)
    components:
      -
        name: monitor-svcg-binding-comp
        condition:  $parameters.svc-servers
        type: ns::servicegroup_lbmonitor_binding
        properties:
          servicegroupname: $components.lb-comp.outputs.servicegroup.properties.servicegroupname
          monitor_name: $parent.properties.monitorname

Migrar configpack de un StyleBook a otro StyleBook