Migrar la configuración de aplicaciones Citrix ADC con StyleBooks Configuration Builder

Nota

Esta función está en la vista previa técnica.

El generador de configuración de StyleBooks se utiliza para crear una configuración de aplicación StyleBook a partir de una configuración de Citrix ADC existente. Esta función también automatiza la migración de configuración de aplicaciones de una instancia de Citrix ADC a otra instancia.

Usando Configuration Builder puede simplificar el requisito de crear un StyleBook personalizado. Esta función le permite crear un StyleBook sin un conocimiento profundo de la gramática y construcciones de StyleBooks. De lo contrario, el conocimiento de la gramática y construcciones de StyleBooks es necesario para crear un StyleBook.

Configuration Builder también crea un ConfigPack que refleja la misma configuración de ADC en una nueva instancia de ADC. Con este ConfigPack, la configuración inicial de ADC de una instancia de ADC se puede duplicar en otra instancia de ADC. El origen de configuración inicial puede ser uno de los siguientes:

  • Una instancia de Citrix ADC: Especifique la instancia en la que está alojada la configuración de la aplicación que quiere duplicar.

  • Un conjunto de comandos CLI: Pegue la configuración desdens.conf oApplication config.

Configuration Builder identifica la lista de distintas aplicaciones incrustadas en la configuración de origen. Cuando selecciona la configuración de la aplicación de su interés, Configuration Builder extrae el conjunto de comandos CLI para la aplicación seleccionada. Estos comandos de CLI se extraen de la configuración de origen. Además, identifica los atributos de configuración que requieren su entrada. Estos atributos pueden ser contraseñas o certificados especificados en la configuración de origen. Después de especificar la información necesaria, comience a migrar o duplicar la configuración de la aplicación en una instancia ADC de destino.

Flujo de trabajo del generador de configuración de StyleBooks

Una vez completada la migración, se crea un ConfigPack en Citrix ADM junto con su StyleBook correspondiente. Este ConfigPack representa la configuración de la aplicación en la instancia ADC de destino. Para ver el ConfigPack creado, vaya a Aplicaciones > StyleBooks > Configuraciones.

Solo puede seleccionar una configuración de aplicación para duplicarla a la vez. Repita el proceso para duplicar las demás configuraciones de aplicación presentes en la configuración de origen.

Funciones admitidas de Citrix ADC

El generador de configuración de StyleBook reconoce y admite las siguientes funciones de Citrix ADC en la configuración de origen:

  • Cambio de contenido
  • Equilibrio de carga
  • Supervisión
  • Descarga SSL
  • Reescribe
  • Respondedor

Crear un StyleBook para migrar la configuración de la aplicación Citrix ADC

El procedimiento siguiente consiste en crear un StyleBook que migra la migración de aplicaciones Citrix ADC en Citrix ADM:

  1. Vaya a Aplicaciones > StyleBooks > Configuraciones.

  2. Haga clic en Migrar configuración de ADC.

  3. Haga clic en Get Started.

  4. En la ficha Especificar configuración, seleccione el origen de configuración:

    • Importar desde un ADC: Esta opción detecta las aplicaciones activas en la instancia de ADC seleccionada.

    • Importar mediante comandos CLI: Esta opción analiza los comandos CLI y extrae las aplicaciones de los comandos CLI.

  5. Especifique la instancia de ADC de origen desde la que quiere migrar o duplicar la configuración de la aplicación.

  6. Especifique la instancia de ADC de destino a la que quiere migrar o duplicar la configuración de la aplicación.

  7. En la ficha Elegir aplicación, seleccione la aplicación que quiere migrar y haga clic en Siguiente.

  8. En la ficha Comandos equivalentes de CLI, revise los comandos y haga clic en Siguiente.

    Estos comandos son específicos de la configuración de la aplicación seleccionada.

  9. En la ficha Atributos de configuración, especifique los detalles necesarios y haga clic en Siguiente.

    Esta ficha enumera los secretos, como claves para descifrar contraseñas y certificados.

    Nota

    Antes de iniciar la migración, las configuraciones perdidas o no admitidas se muestran en cualquiera de las fichas siguientes:

    • Configuraciones no admitidas
    • Configuraciones globales no admitidas

    Para migrar estas configuraciones correctamente, debe aplicar las configuraciones perdidas o no admitidas por separado en la instancia de destino. Y, haga clic en Siguiente.

  10. En la ficha Migrar, especifique los detalles de StyleBook requeridos. Haga clic en Migrate.

Limitaciones

  • Las expresiones nombradas y responderhtmlpages mencionadas en la instancia de origen no se identifican. Asegúrese de configurar las expresiones con nombre asignado y responderhtmlpages en la instancia de destino antes de la migración.

  • Si el origen tiene una configuración para el grupo de servicios y el enlace del monitor de la siguiente manera:

    bind serviceGroup <Name> <Port> -monitorName <Monitor_Name>

    Aparece el siguiente error:

     CLI Command conversion failed: 100 - No such command [{ "errorcode": 1090, "message": "No such argument [XXX]", "severity": "ERROR" }]
    

    Este error se produce porque Citrix ADC guarda el enlace entre Service Group y Monitor en un formato no válido. Este problema se ha corregido desde la compilación de Citrix ADC 12.1.52.15.

Migrar la configuración de aplicaciones Citrix ADC con StyleBooks Configuration Builder