Crear y editar un paquete de configuración
En NetScaler Console, puede crear un paquete de configuración a partir de un StyleBook. El paquete de configuración está vinculado al StyleBook desde el que se crea. Cualquier actualización del paquete de configuración se realiza a través del StyleBook al que está vinculado.
Crear un paquete de configuración
Para crear un paquete de configuración a partir de un StyleBook, haga lo siguiente:
-
Vaya a Aplicaciones > Configuración > Paquetes de configuración.
-
Haga clic en Agregar.
-
En Elegir StyleBooks, seleccione los StyleBooks necesarios a partir de los cuales desea crear un paquete de configuración.Esta página clasifica los StyleBooks en StyleBooks predeterminados, empresariales y personalizados. Seleccione las pestañas respectivas para encontrar los StyleBooks necesarios.
-
Opcional: especifique una Clave de configuración única para su paquete de configuración. Esta clave aparece como Clave de visualización para este paquete de configuración.
-
Si especifica una Clave de configuración que ya existe, NetScaler Console no puede crear el paquete de configuración.
-
Si no especifica una Clave de configuración, NetScaler Console asigna automáticamente el ID del paquete de configuración. Sin embargo, este valor no aparece como Clave de visualización.
-
Si no especifica una Clave de configuración y alguno de los parámetros de StyleBook ha establecido el atributo
key, ese valor de parámetro aparece como la Clave de visualización. Para obtener más información, consulte Parámetros.
-
-
Especifique los detalles necesarios, como el nombre de la aplicación, la dirección IP, el puerto o el tipo de protocolo.Los campos de la GUI difieren de un StyleBook a otro.
-
En Instancias de destino, seleccione las instancias o grupos de instancias donde desea ejecutar la configuración.Nota:Puede implementar la configuración en más de un NetScaler, especificando tantas instancias de destino como sea necesario.
-
Haga clic en Ejecución en seco.La página Objetos muestra los objetos que se crean, modifican o eliminan de las instancias de NetScaler.
-
Haga clic en CrearEl paquete de configuración aparece en la página StyleBook > Configuraciones.
Si desea editar los paquetes de configuración existentes, seleccione el paquete de configuración y haga clic en Editar.
Reutilice configuraciones creadas fuera de StyleBooks y comparta configuraciones entre paquetes de configuración
A veces, es posible que haya creado configuraciones de NetScaler® fuera de Stylebooks, ya sea debido a necesidades operativas particulares o a configuraciones heredadas. Ahora puede integrar y administrar estas configuraciones preexistentes como parte de los paquetes de configuración de Stylebook, lo que permite una gestión más flexible y centralizada.
Por ejemplo, antes de esta función, si NetScaler ya estaba configurado con un perfil SSL, y si la operación del paquete de configuración de StyleBook intentaba crear un perfil SSL con el mismo nombre, la operación del paquete de configuración habría fallado con el error "El recurso ya existe". Ahora, con esta función habilitada, la operación del paquete de configuración se realiza correctamente y el perfil SSL existente con el mismo nombre se puede reutilizar en el nuevo paquete de configuración.
Del mismo modo, también puede encontrarse con escenarios en los que se requieren recursos como la configuración de red, las políticas de seguridad o parte de las configuraciones de aplicaciones en varias aplicaciones o configuraciones. Esta función le permite compartir las configuraciones entre varios paquetes de configuración.
Para habilitar esta función, siga estos pasos:
-
Vaya a Aplicaciones > Configuración > Stylebooks.
-
En la página Stylebooks, seleccione el Stylebook que utilizará para crear un nuevo paquete de configuración o el asociado al paquete de configuración que está editando.
-
En Seleccionar acción, haga clic en Configurar ajustes.


-
Ajuste la configuración eligiendo una o ambas de las siguientes opciones:
-
Para permitir la reutilización de recursos existentes en NetScaler al crear configuraciones, seleccione la opción Permitir la reutilización de recursos existentes en NetScaler al crear configuración(es).
-
Para retener los recursos reutilizados en NetScaler al eliminar configuraciones, seleccione la opción ¿Retener los recursos reutilizados en NetScaler al eliminar configuración(es)?. Esta opción retiene los recursos creados originalmente fuera de los Stylebooks en NetScaler, incluso si se elimina el último paquete de configuración que los referencia, lo que garantiza su disponibilidad continua.
-
-
Haga clic en Aceptar.
Cambiar el StyleBook de un paquete de configuración
A veces, es necesario actualizar el StyleBook para añadir funcionalidades o corregir un problema. Si ya ha creado paquetes de configuración utilizando el StyleBook antiguo, es posible que desee actualizarlos para usar el nuevo StyleBook actualizado. Para usar un nuevo StyleBook, cambie el StyleBook existente del paquete de configuración.
Considere un StyleBook de ejemplo example-lb que implementa una configuración básica de balanceador de carga en una instancia de NetScaler. Y, cree un paquete de configuración CP1 a partir de este StyleBook.
Para configurar monitores con la configuración básica del balanceador de carga, necesita un nuevo StyleBook. Para ello, cree un StyleBook example-lb-mon que incluya la capacidad de configurar monitores junto con la configuración básica del balanceador de carga.
Después de crear un StyleBook, actualice el paquete de configuración CP1 existente para añadir monitores. Para actualizar el paquete de configuración, haga lo siguiente:
-
Vaya a Applications > Configuration > Config Packs.
-
Seleccione el paquete de configuración para el que desea cambiar el StyleBook.En este ejemplo, seleccione CP1 de la lista.
-
Haga clic en Cambiar StyleBook.
-
Seleccione el StyleBook requerido de la lista. Luego, haga clic en Guardar selección.
-
Haga clic en Cambiar.En este ejemplo, seleccione example-lb-mon de la lista.Cuando cambia el StyleBook de un paquete de configuración, los parámetros del nuevo StyleBook pueden tener una estructura diferente a la del StyleBook existente. Si la estructura de los parámetros es similar a la del StyleBook anterior, los valores de los parámetros se conservan automáticamente en sus campos respectivos. De lo contrario, solo se transfieren los parámetros que tienen la misma estructura entre los dos StyleBooks. Por ejemplo, el mismo nombre de parámetro, tipo, padre de parámetro y más.Nota:La página Compatibilidad de StyleBook muestra las diferencias en los parámetros. Esta página le ayuda a decidir si cambiar el StyleBook o continuar con el StyleBook existente. Si desea cambiar el StyleBook, revise los cambios y, a continuación, haga clic en Siguiente.Si se añaden nuevos parámetros en el nuevo StyleBook, después de cambiar el StyleBook, debe especificar manualmente los valores de dichos parámetros.En este ejemplo, los parámetros que aparecen en la página de configuración del StyleBook example-lb son los siguientes:
Los parámetros que aparecen en la página de configuración del nuevo StyleBook example-lb-mon son los siguientes:
En este caso, los StyleBooks conservan los valores anteriores para la configuración básica del equilibrador de carga porque el nuevo StyleBook no ha cambiado los parámetros existentes. Y solo añade los nuevos parámetros. Para los parámetros del monitor, especifique manualmente los valores requeridos. -
En Instancias de destino, revise las instancias seleccionadas y actualice la lista si es necesario.
-
Haga clic en Ejecución de prueba.La página Objetos muestra los objetos que se crean, modifican o eliminan de las instancias de NetScaler.
-
Haga clic en Aceptar.En la página StyleBook > Configurations, la columna StyleBook Name muestra el nuevo nombre de StyleBook para el paquete de configuración seleccionado. En este caso, muestra example-lb-mon.
Cambiar el StyleBook que tiene varios paquetes de configuración
Cuando desee cambiar un StyleBook existente que tiene varios paquetes de configuración, haga lo siguiente:
-
Importe un nuevo StyleBook a NetScaler Console.Normalmente, el nuevo StyleBook tiene el mismo nombre y espacio de nombres con una versión superior a la del StyleBook existente. Sin embargo, puede omitir este paso si el nombre, el espacio de nombres o la versión son diferentes.
-
Cambie el StyleBook para los paquetes de configuración asociados con el StyleBook existente.Puede seleccionar Cambiar StyleBook solo cuando los paquetes de configuración seleccionados estén asociados con el mismo StyleBook.Para los paquetes de configuración seleccionados, NetScaler Console cambia correctamente el StyleBook cuando se cumplen las siguientes condiciones:
-
Todos los parámetros de configuración del StyleBook existente deben estar presentes en el StyleBook seleccionado.
-
Los nuevos parámetros del StyleBook seleccionado son opcionales.
Para ver el progreso de los paquetes de configuración seleccionados, seleccione Configurations in Progress/Failed en la página Configurations. -
-
Elimine el StyleBook antiguo de NetScaler Console una vez que todos los paquetes de configuración estén vinculados al nuevo StyleBook.
Exportar o importar paquetes de configuración
Puede exportar o importar un paquete de configuración como los StyleBooks. Con esta función, puede compartir fácilmente la configuración de StyleBook con otro servidor de NetScaler Console. Al exportar un paquete de configuración, se descarga un paquete
tgz o zip en su equipo local. Este paquete incluye un archivo JSON con todos los parámetros definidos en un paquete de configuración.
Exportar configuración
Realice lo siguiente para exportar un paquete de configuración:
-
Vaya a Aplicaciones > Configuración > Paquetes de configuración.
-
Seleccione un paquete de configuración que desee exportar.
-
En Seleccionar acción, seleccione Exportar configuración.Opción de exportar configuración(/en-us/netscaler-console-service/media/export-configuration-pack.png)
-
En el panel Exportar configuración, especifique lo siguiente:
-
Información de la(s) instancia(s) de destino en la que se implementa la configuración: Seleccione esta opción para incluir la información de las instancias de destino con el paquete de exportación.
-
StyleBook asociado a la configuración: Seleccione esta opción para incluir el StyleBook en el paquete de exportación.
-
Contraseña para proteger los datos de configuración de exportación: Especifique una contraseña para cifrar el paquete de exportación. Esta contraseña protege los datos confidenciales de un paquete de configuración.
-
Tipo de archivo comprimido: Seleccione el tipo de archivo ZIP o TGZ.
Exportar paquete de configuración(/en-us/netscaler-console-service/media/export-configuration-options.png) -
-
Haga clic en Exportar.Guarde el paquete de exportación en su equipo local.
Importar configuración
Puede importar un paquete de configuración desde su equipo local a un servidor de NetScaler Console diferente. Para importar un paquete de configuración, haga lo siguiente:
-
Vaya a Aplicaciones > Configuración > Paquetes de configuración.
-
Seleccione Importar configuración.
-
Elija el paquete de archivos de importación de su equipo.
-
Utilice la frase de contraseña que especificó durante la exportación.
-
Opcional, en Opciones avanzadas, seleccione Permitir solo la creación de una nueva configuración si todos los objetos de configuración ya existen en NetScaler.Esta opción no altera los objetos que ya están creados en la instancia de NetScaler.Considere que ha añadido la misma instancia de NetScaler en dos servidores de NetScaler Console. Y desea migrar un paquete de configuración de un servidor de NetScaler Console a otro. Utilice esta opción para importar un paquete de configuración sin alterar sus objetos de configuración en una instancia de NetScaler.Importante:Para usar esta opción, asegúrese de que el paquete de configuración especificado contenga la información de las instancias de destino. Consulte (#export-configuration).Esta opción solo migra la configuración si todos los objetos están presentes en la instancia de destino.
-
Haga clic en Importar.
Al importar un paquete de configuración, NetScaler Console verifica lo siguiente:
-
StyleBook asociado: Si el StyleBook asociado no está en NetScaler Console, importa el StyleBook junto con el paquete de configuración.
-
Instancias de destino: Comprueba las instancias de destino e implementa la configuración en las instancias de destino especificadas. Si las instancias de NetScaler mencionadas no están presentes en NetScaler Console, el paquete de configuración se importa sin instancias de destino.
-
NetScaler Console de origen: Si está importando un paquete de configuración en el mismo servidor de NetScaler Console, el paquete seleccionado actualiza el paquete de configuración existente.
Guardar un paquete de configuración como borrador
La opción Guardar como borrador en los paquetes de configuración le permite guardar los cambios de configuración como borradores. Esta función guarda los cambios sin implementarlos inmediatamente en una instancia de NetScaler.
Para guardar un paquete de configuración como borrador, siga estos pasos:
-
Vaya a Aplicaciones > Configuración > Paquetes de configuración.
-
En la página Configuraciones, haga clic en Agregar.
-
Seleccione el Stylebook deseado y haga clic en Seleccionar.
-
En la página Crear configuración, haga clic en Guardar como borrador.
Una vez que el paquete de configuración se guarda como borrador, los cambios de configuración no se implementan directamente en la instancia de NetScaler. En su lugar, los paquetes de configuración se almacenan como borradores en la ficha Configuraciones de borrador en Configuraciones pendientes.
En la ficha Configuraciones de borrador, seleccione el paquete de configuración para realizar las siguientes operaciones:
-
Editar la configuración del borrador.
-
Implementar la configuración en una instancia de NetScaler.
-
Eliminar el borrador.
También puede programar cuándo implementar sus borradores guardados.
Para obtener más información, consulte Crear una programación para un paquete de configuración.
Crear una programación para un paquete de configuración
Cuando crea un paquete de configuración, este se implementa automáticamente en una instancia de NetScaler de forma predeterminada. Con esta función, puede programar la implementación de paquetes de configuración.
Para crear una programación para un paquete de configuración, siga estos pasos:
-
Vaya a Aplicaciones > Configuración > Paquetes de configuración.
-
En la página Configuraciones, haga clic en Agregar.
-
Seleccione el StyleBook y haga clic en Seleccionar.
-
En la página Crear configuración, en Ejecución, seleccione Más tarde en la lista Modo de ejecución.
-
Seleccione la hora y la fecha deseadas para la programación y haga clic en Enviar.
Todas las configuraciones programadas se almacenan en la ficha Configuraciones programadas en Configuraciones pendientes. Puede seleccionar la programación creada para editar los parámetros de configuración, implementar o cancelar la programación.
Nota:
La implementación de un paquete de configuración programado cancela la programación y ejecuta la configuración inmediatamente.
Para un paquete de configuración implementado
También puede crear una programación para editar y eliminar un paquete de configuración implementado.
Programar una operación de edición para un paquete de configuración
Para crear una programación para editar el paquete de configuración implementado, siga estos pasos:
-
Vaya a Aplicaciones > Configuración > Paquetes de configuración.
-
En la página Configuraciones, seleccione un StyleBook y haga clic en Editar.
-
En la página Editar configuración, edite el paquete de configuración.
-
En la lista Modo de ejecución, seleccione Más tarde.
-
Seleccione la hora y fecha deseadas para la programación y haga clic en Enviar.
Programar una operación de eliminación para un paquete de configuración
Para crear una programación para eliminar el paquete de configuración implementado, siga estos pasos:
-
Vaya a Aplicaciones > Configuración > Paquetes de configuración.
-
En la página Configuraciones, seleccione un StyleBook y haga clic en Eliminar.
-
En la lista Modo de ejecución, seleccione Más tarde.
-
Seleccione la hora y fecha deseadas para la programación y haga clic en Aceptar.
Desasociar una instancia de destino de un paquete de configuración
Para desasociar una instancia de destino de un paquete de configuración, haga lo siguiente:
-
Vaya a Aplicaciones > Configuración > Paquetes de configuración.
-
Seleccione el paquete de configuración con una instancia de destino que desee eliminar.
-
En Seleccionar acción, seleccione Desasociar destinos.
-
En el panel Desasociar destinos, seleccione la instancia de destino que desea eliminar del paquete de configuración.

-
Haga clic en Aceptar.
Se muestra un mensaje que confirma la creación de un paquete de configuración duplicado con la instancia de destino ahora eliminada.
Cree sus StyleBooks
El contenido completo de StyleBook example-lb se proporciona para su referencia a continuación:
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 StyleBook example-lb-mon se proporciona para su referencia a continuación:
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