Application Delivery Management

Migrar el paquete de configuración de un StyleBook a otro StyleBook

En NetScaler Application Delivery Management (ADM), los paquetes de configuración siempre están enlazados al StyleBook desde el que se crean. Cualquier actualización del paquete de configuración solo se puede realizar a través del StyleBook al que está enlazado el paquete de configuración. NetScaler 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 vinculado 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 NetScaler ADC. Ha creado un paquete de configuración CP1 a partir de este StyleBook en una instancia de NetScaler ADC. Más tarde, se dio cuenta de que su StyleBook no incluye una configuración de supervisión. Por lo tanto, ahora ha creado 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 el paquete de configuración CP1 para agregar algunos monitores. Anteriormente, tenía que eliminar el paquete de configuración CP1 y crear un paquete de configuración CP2 desde el nuevo StyleBook para agregar monitores a la configuración. La eliminación de CP1 da como resultado la eliminación de toda la configuración creada en el paquete de configuración CP1 en una o más instancias de NetScaler ADC. Anteriormente, tenía que volver a crear un nuevo 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 de ejemplo-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 de NetScaler ADC en las que se implementó el paquete de configuración. Tiene que proporcionar solo los detalles del monitor ahora. La configuración existente implementada en las instancias de NetScaler ADC que no ha cambiado no se verá afectada.

Migrar paquete de configuración

Para migrar un paquete de configuración creado con 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 ejemplo-lb que habría creado anteriormente y haga clic en Migrar Configpack.

    imagen traducida

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

    imagen traducida

    Si migras 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. Es posible que algunos de los parámetros del nuevo StyleBook sean nuevos o que haya 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 StyleBook de ejemplo.

    imagen traducida

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

    imagen traducida

    En este caso, puede ver que los StyleBooks conservan los valores anteriores para la configuración básica del balanceador de carga. Sin embargo, debe escribir manualmente los valores de 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 recientemente de las instancias de 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.

    Nota

    También puede hacer clic en el icono de actualización para agregar instancias de Citrix ADC descubiertas recientemente. Por lo tanto, estas instancias están disponibles al instante 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. 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 han eliminado de la configuración.

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

imagen traducida

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

Crea sus StyleBooks

El contenido completo de example-lbStyleBook 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
<!--NeedCopy-->

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
<!--NeedCopy-->
Migrar el paquete de configuración de un StyleBook a otro StyleBook