Crear y modificar 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 creó. 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 quiere crear un paquete de configuración.
Esta página clasifica los StyleBooks en libros de estilo predeterminados, empresariales y personalizados. Seleccione las fichas 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 existente, NetScaler Console no podrá 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, el valor de ese parámetro aparecerá como 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 GUI difieren de un StyleBook a otro StyleBook.
-
En Instancias de destino, seleccione instancias o grupos de instancias en los que quiera 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 Ejecutar en seco.
La página Objetos muestra los objetos que se crean, modifican o eliminan de las instancias de NetScaler.
-
Haga clic en Crear
El 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 .
Cambiar el StyleBook de un paquete de configuración
A veces, debe actualizar el StyleBook para agregar funcionalidad o solucionar un problema. Si ya ha creado paquetes de configuración con el StyleBook anterior, es posible que desee actualizarlos para usar el nuevo StyleBook actualizado. Para utilizar un nuevo StyleBook, cambie el StyleBook existente del paquete de configuración.
Considere un ejemplo de StyleBook example-lb que implementa una configuración básica de balanceador de carga en una instancia de NetScaler. Además, se crea un paquete de configuración CP1 a partir de este StyleBook.
Para configurar los monitores con la configuración básica del equilibrador de carga, necesita un StyleBook nuevo. 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 cargas.
Tras crear un StyleBook, actualice el paquete de configuración CP1 existente para agregar monitores. Para actualizar el paquete de configuración, haga lo siguiente:
-
Vaya a Aplicaciones > Configuración > Paquetes de configuración.
-
Seleccione el paquete de configuración para el que quiere cambiar el StyleBook.
En este ejemplo, seleccione CP1 de la lista.
-
Haga clic en Cambiar StyleBooks.
-
Seleccione el StyleBook requerido de la lista. A continuación, haga clic en Guardar selección.
-
Haga clic en Change.
En este ejemplo, seleccione ejemplo-lb-mon de la lista.
Al cambiar 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 parámetros es similar a la StyleBook anterior, los valores de los parámetros se conservan automáticamente en sus respectivos campos. De lo contrario, solo se transfieren los parámetros que tengan la misma estructura entre los dos StyleBooks. Por ejemplo, el mismo nombre de parámetro, tipo, principal de parámetro y mucho más.
Nota:
La página de compatibilidad de StyleBook muestra las diferencias en los parámetros. Esta página le ayuda a decidir si quiere cambiar el StyleBook o continuar con el StyleBook existente. Si quiere cambiar el StyleBook, revise los cambios y, a continuación, haga clic en Siguiente.
Si se agregan nuevos parámetros al 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 ejemplo-lb StyleBook son los siguientes:
Los parámetros que aparecen en la página de configuración del nuevo ejemplo-lb-mon StyleBook son los siguientes:
En este caso, los StyleBooks conservan los valores más antiguos de la configuración básica del balanceador de cargas porque el nuevo StyleBook no ha cambiado los parámetros existentes. Y, agrega solo los nuevos parámetros. Para parámetros de supervisión, especifique manualmente los valores necesarios.
-
En Instancias de destino, revise las instancias seleccionadas y actualice la lista si es necesario.
-
Haga clic en Ejecutar en seco.
La página Objetos muestra los objetos que se crean, modifican o eliminan de las instancias de NetScaler.
-
Haga clic en OK.
En la página StyleBook > Configuraciones, la columna Nombre del StyleBook muestra el nuevo nombre de StyleBook para el paquete de configuración seleccionado. En este caso, muestra ejemplo-lb-mon.
Cambie 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 StyleBook nuevo 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 por los paquetes de configuración asociados al StyleBook existente.
Puede seleccionar Cambiar StyleBook solo cuando los paquetes de configuración seleccionados estén asociados al mismo StyleBook.
Para los paquetes de configuración seleccionados, la consola de NetScaler 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 Configuraciones en curso/fallidas en la página de configuraciones .
-
-
Elimine el StyleBook antiguo de la consola NetScaler una vez que todos los paquetes de configuración estén vinculados al nuevo StyleBook.
Exportación o importación de paquetes de configuración
Puede exportar o importar un paquete de configuración como StyleBooks. Con esta función, puede compartir fácilmente la configuración de StyleBook con otro servidor de NetScaler Console. Cuando exporta un paquete de configuración, un paquete tgz o un paquete zip se descarga al equipo local. Este paquete incluye un archivo JSON con todos los parámetros definidos en un paquete de configuración.
Exportar configuración
Haga lo siguiente para exportar un paquete de configuración:
-
Vaya a Aplicaciones > Configuración > Paquetes de configuración.
-
Seleccione el paquete de configuración que quiera exportar.
-
En Seleccionar acción, seleccione Exportar configuración.
-
En el panel Configuración de exportación, especifique lo siguiente:
-
Información de instancias de destino en las 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 Configuración: Seleccione esta opción para incluir el StyleBook en el paquete de exportación.
-
Frase de contraseña para proteger los datos de configuración de exportación: especifique una frase de contraseña para cifrar el paquete de exportación. Esta frase de contraseña protege los datos confidenciales de un paquete de configuración.
-
Comprimir tipo de archivo: seleccione el tipo de archivo ZIP o TGZ.
-
-
Haga clic en Exportar.
Guarde el paquete de exportación en el equipo local.
Importar configuración
Puede importar un paquete de configuración de su equipo local a otro servidor de NetScaler Console. 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 desde el equipo.
-
Utilice la contraseña que especificó durante la exportación.
-
Opcionalmente, 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.
Tenga en cuenta que agregó la misma instancia de NetScaler en dos servidores de NetScaler Console. Además, desea migrar un paquete de configuración de un servidor de NetScaler Console a otro servidor. Utilice esta opción para importar un paquete de configuración sin modificar 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 tenga la información de las instancias de destino. Consulte Configuración de exportación.
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, la consola de NetScaler comprueba lo siguiente:
-
StyleBookasociado : si el StyleBook asociado no está en la consola de NetScaler, importa el StyleBook junto con el paquete de configuración.
-
Instancias de destino: compruebe las instancias de destino e implementa la configuración en las instancias de destino especificadas. Si las instancias de NetScaler mencionadas no están en la consola de NetScaler, el paquete de configuración se importa sin las instancias de destino.
-
NetScaler Console de origen: si importa 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 de 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 libro de estilos que desee 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 pestaña Borrador de configuraciones, en Configuraciones pendientes.
En la pestaña Borrador de configuraciones, 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 los 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
Al crear un paquete de configuración, el paquete de configuración se implementa automáticamente en una instancia de NetScaler de forma predeterminada. Con esta función, puede programar la implementación de los 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 libro de estilos 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 fecha y hora deseadas para la programación y haga clic en Enviar.
Todas las configuraciones programadas se almacenan en la pestaña 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 de inmediato.
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 fecha y hora 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 fecha y hora deseadas para la programación y haga clic en Aceptar.
Separar una instancia de destino de un paquete de configuración
Para separar 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 quiera eliminar.
-
En Seleccionar acción, seleccione Separar objetivos.
-
En el panel Separar objetivos, seleccione la instancia de destino que quiere eliminar del paquete de configuración.
-
Haga clic en OK.
Aparece un mensaje que confirma la creación de un paquete de configuración duplicado con la instancia de destino ahora eliminada.
Crea sus StyleBooks
El contenido completo de example-lb StyleBook se proporciona para su referencia de la siguiente manera:
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 para su referencia de la siguiente manera:
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-->
En este artículo
- Crear un paquete de configuración
- Cambiar el StyleBook de un paquete de configuración
- Exportación o importación de paquetes de configuración
- Guardar un paquete de configuración como borrador
- Crear una programación para un paquete de configuración
- Separar una instancia de destino de un paquete de configuración
- Crea sus StyleBooks