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 crearon. 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. Ha creado un paquete de configuración CP1 a partir de este StyleBook en una instancia de NetScaler. 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. 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 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 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
-
En NetScaler ADM, vaya aAplicaciones> Configuraciones. La página Configuraciones muestra todos los paquetes de configuración presentes en el sistema.
-
Desplácese hacia abajo para buscar el paquete de configuración ejemplo-lb que habría creado anteriormente y haga clic en Migrar Configpack.
-
Se abre la página Elegir StyleBook de destino para la migración, que muestra todos los StyleBooks disponibles en NetScaler 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.
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.
La imagen siguiente muestra los parámetros después de migrar el paquete de configuración a example-lb-mon StyleBook.
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.
-
Escriba los valores de los nuevos parámetros utilizados para crear monitores en la instancia.
-
En Instancias de destino, haga clic y seleccione la dirección IP de la instancia de NetScaler en la que desee ejecutar la configuración. Tenga en cuenta que puede implementar la configuración en más de un NetScaler especificando tantas instancias de destino como sea necesario.
-
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 NetScaler.
-
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 NetScaler 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 NetScaler 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.
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 NetScaler 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-->