Application Delivery Management

Migración local de NetScaler ADM a Citrix Cloud

Puede migrar NetScaler ADM 13.0 64.35 local o una versión posterior a Citrix Cloud. Si su ADM tiene 12.1 o una versión anterior, primero debe actualizar a 13.0 64.35 o una versión posterior y, a continuación, migrar a Citrix Cloud. Para obtener más información, consulte la sección Actualización.

El servicio ADM a través de Citrix Cloud le permite obtener:

  • Lanzamientos más rápidos, aproximadamente cada dos semanas con las últimas actualizaciones de funciones.

  • Análisis basado en aprendizaje automático para seguridad de aplicaciones y bot, rendimiento y uso.

  • Varias otras funciones que actualmente solo se admiten en el servicio ADM, como análisis de períodos de pico y lean, análisis basado en aprendizaje automático para seguridad de aplicaciones y bot, análisis de CPU de aplicaciones y muchas más.

Para una migración correcta, debe:

  • Asegúrese de tener conexión a Internet en ADM local para la accesibilidad de Citrix Cloud

  • Configurar el agente de servicio ADM

  • Obtenga el cliente y el archivo CSV secreto de Citrix Cloud

  • Validar las licencias de servicio ADM

  • Migrar mediante un script

Después de migrar de ADM local a un servicio ADM, si quiere volver a continuar con ADM local, puede usar el script de reversión. Para obtener más información, consulte Volver a ADM local.

Configurar el agente de servicio ADM

Para habilitar las comunicaciones entre las instancias de NetScaler ADC y NetScaler ADM, debe configurar un agente. De forma predeterminada, los agentes de NetScaler ADM se actualizan automáticamente a la versión más reciente. También puede seleccionar una hora específica para la actualización del agente. Para obtener más información, consulte Configuración de los valores de actualización del agente.

  • Si el ADM local existente (par independiente o HA) no tiene agentes locales configurados, debe configurar al menos un agente para el servicio ADM.

  • Si el ADM local existente (par independiente o HA) se ha configurado con agentes locales para implementaciones multisitio, debe configurar el mismo número de agentes para el servicio ADM.

Para obtener más información sobre la configuración de un agente, consulte la sección Introducción.

Obtenga el cliente y el archivo CSV secreto de Citrix Cloud

Después de configurar el agente, obtenga el cliente y el archivo CSV secreto de la página de Citrix Cloud:

  1. Inicie sesión en citrix.cloud.com

  2. Haga clic en el icono Inicio y seleccione Administración de identidades y accesos.

    Administración de acceso e identidad

  3. En la ficha Acceso API, introduzca un nombre de cliente seguro y haga clic en Crear cliente.

    Acceso API

  4. Se generan ID y Secret. Haga clic en Descargar y guarde el archivo CSV en el ADM local.

    Por ejemplo, guarde el archivo CSV en el directorio /var.

    ID y archivo secreto

Validar las licencias de servicio ADM

Debe obtener licencias para el servicio ADM.

  • Las licencias VIP en el servicio ADM deben ser superiores o iguales a las licencias VIP locales.

    Nota

    Si las licencias VIP son menores, los servidores virtuales se seleccionan aleatoriamente y se produce un error en la configuración de nivel VIP para el servicio ADM.

  • Si utiliza la implementación local de ADM como servidor de licencias, reasigne las licencias al servicio ADM antes de la migración. Para obtener más información, consulte Configurar un servidor ADM solo como servidor de licencias agrupado y Cómo reasignar un archivo de licencias.

  • Si utiliza las licencias agrupadas en ADM local, debe obtener las licencias agrupadas para el servicio ADM y, a continuación, asignar licencias a las instancias de ADC. Para obtener más información, consulte Configurar licencias agrupadas. Las siguientes versiones admitidas de ADC permiten modificar la asignación de licencias desde ADM:

    • NetScaler ADC SDX: 13.0 74.11 o versiones posteriores.

    • NetScaler ADC VPX y MPX: 13.0 47.24 o versiones posteriores, 12.1 58.14 o versiones posteriores y 11.1 65.10 o versiones posteriores.

Migrar mediante un script

  • Con la compilación ADM 82.x, puede seleccionar la función y, a continuación, migrar.

  • Para las compilaciones ADM 76.x o posteriores, los scripts de migración (servicemigrationtool.py y config_collect_onprem.py) están disponibles como parte de la compilación, disponible en cd /mps/scripts.

  • Para compilaciones de ADM anteriores a 76.x, debe descargar los scripts de migración y copiar los scripts en ADM local.

    Nota

    Asegúrese de que el ADM local tenga conectividad a Internet durante la migración.

  1. Con un cliente SSH, inicie sesión en el ADM local.

    Nota

    Para un par ADM HA, inicie sesión en el nodo principal.

  2. Escribe shell y presiona Entrar para cambiar al modo bash.

  3. Copie el ID de cliente y el archivo CSV secreto. Por ejemplo, copie el archivo en el directorio /var.

    Después de copiar el archivo CSV, puede validar si el archivo CSV está presente.

    Agregar CSV

    Nota

    Para un par ADM HA, copie el archivo CSV en el nodo principal.

  4. Para la versión ADM 13.0 82.xx, ejecute los siguientes comandos para completar la migración:

    1. cd /mps/scripts

    2. python servicemigrationtool.py <path of ClientID/Secret File in on-premises Citrix ADM VM>

    Por ejemplo, python servicemigrationtool.py /var/secureclient.csv

    Después de ejecutar el script de migración, la herramienta muestra las siguientes opciones:

    Opciones de migración de funciones inteligentes

    Según la opción que proporcione, solo esa función se migra al servicio ADM.

    En el ejemplo, se selecciona la opción 1. La herramienta completa la migración de Administración y supervisión (M&M) y muestra el siguiente mensaje:

    Finalización de migración

    La función de gestión y supervisión (M&M) incluye:

    • Instancias ADC, etiquetas, grupos de instancias, perfiles, aplicaciones personalizadas, trabajos de configuración, SNMP, configuraciones de syslog.

    • Sitios, bloqueos de IP, informes de red, umbrales de análisis, configuración de notificaciones, configuración de eliminación de datos.

    • Configura plantillas de auditoría, intervalos de sondeo, reglas de eventos y ajustes.

    • Grupos, roles y directivas de RBAC

    La función de análisis incluye:

    • Configuración de Appflow por servidor virtual desde instancias de ADC.

    • Configuración de Appflow por dispositivo SD-WAN.

    Nota:

    • La función Administración y supervisión (M&M) se migra automáticamente, incluso si selecciona cualquier otra función (2, 3 o 4).

    • Solo puede especificar una función a la vez.

    • Después de completar la migración de cualquier función, si quiere migrar cualquier otra función más adelante, la función que ya se ha migrado no se muestra en la lista. Por ejemplo, si primero completa la migración de la función de Analytics, la próxima vez que ejecute el script de migración, solo podrá ver las opciones StyleBooks, Licencias agrupadas y Todo.

  5. Para la versión de ADM 13.0 76.xx, ejecute los siguientes comandos para completar la migración:

    1. cd /mps/scripts

    2. python servicemigrationtool.py <path of ClientID/Secret File in on-premises Citrix ADM VM>

    Por ejemplo, python servicemigrationtool.py /var/secureclient.csv

  6. Para ADM anterior a 13.0 76.xx versión:

    1. Descargue el script de migración desde la siguiente ubicación: https://download.citrixnetworkapi.net/root/download/v1/public/software?product=admonprem&build=migrationtool&model=servicemigrationtool_27.tgz

      The downloaded file comprises two bundle scripts, servicemigrationtool_27.py and config_collect_onprem_27.py.

    2. Guarde los dos scripts en ADM local. Por ejemplo, guarde en el directorio /var

    3. Ejecute los siguientes comandos para migrar:

      1. cd /var

      2. servicemigrationtool_27.py <path of ClientID/Secret File in on-premises ADM VM>

        Por ejemplo, python servicemigrationtool_27.py /var/secureclient.csv

Después de ejecutar el script, comprueba los requisitos previos y, a continuación, procede con la migración. En primer lugar, el script comprueba la disponibilidad de la licencia. El siguiente mensaje solo se muestra si tiene una licencia de servicio ADM menor que la licencia local.

Licencias locales menores

Si selecciona Y, la migración continúa otorgando licencias al VIP aleatoriamente. Si selecciona N, el script detiene la migración.

Si tiene la versión de instancia ADC no compatible para el servidor de licencias agrupado, aparecerá el siguiente mensaje:

Versión de ADC no compatible

Si selecciona Y, el proceso de migración continúa cambiando el servidor de licencias. Si selecciona N, el script le preguntará si quiere continuar con el resto de la migración. El script detiene la migración si selecciona N.

Dependiendo de la configuración local, el tiempo aproximado para completar la migración es entre unos minutos y unas horas. Una vez completada la migración, verá el siguiente mensaje:

Estado completo de la migración

La migración se realiza correctamente una vez que todas las instancias de ADC y SD-WAN WANOP y sus respectivas configuraciones se mueven correctamente al servicio ADM. Después de la migración correcta, NetScaler ADM local deja de procesar los siguientes eventos de instancia:

  • Certificados de SSL

  • Mensajes de Syslog

  • Backup

  • Cluster de agentes

  • Informes de rendimiento

  • Auditoría de configuración

  • Emon programador

Volver a ADM local

Si quiere volver a ADM local, asegúrese de que se cumplan los requisitos previos.

Requisitos previos

Si su ADM local (antes de migrar al servicio ADM) es:

  • Si se utiliza como servidor de licencias agrupadas, asegúrese de tener las licencias agrupadas necesarias en la ADM local.

  • Configurado con agentes ADM locales, asegúrese de que los agentes estén disponibles en estado “ACTIVO”.

Usar el script de reversión

Nota

Después de la reversión, las mismas configuraciones (antes de la migración) en Analytics, SNMP y las licencias agrupadas vuelven a estar disponibles en ADM local. Si ha realizado algún cambio en estas configuraciones después de la migración, estos cambios no se reflejan en ADM local.

  • Para compilaciones de ADM 82.xx o posteriores, el script de reversión está disponible como parte de la compilación y se puede acceder a él en /mps/scripts.

  • Para compilaciones de ADM anteriores a 79.xx, puede actualizar a la compilación 82.x y usar el script de rollback o puede descargar el script de rollback y copiar el script en ADM local.

  1. Con un cliente SSH, inicie sesión en el ADM local.

  2. Escribe shell y presiona Enter para cambiar al modo bash.

  3. Para la compilación ADM 13.0 82.xx, ejecute los siguientes comandos para completar la reversión:

    1. cd /mps/guiones

    2. python rollback_to_onprem.py <path of ClientID/Secret File in ADM on-prem VM>

      Por ejemplo, python rollback_to_onprem.py /var/ secureclient.csv.csv

      La herramienta inicia la operación de reversión y un mensaje le pregunta si quiere continuar. Escriba Y para continuar.

      Continuar con la reversión

      Puede ver el siguiente mensaje después de que se complete la reversión.

      Reversión completa

  4. Para la compilación ADM anterior a la versión 82.xx:

    1. Descargue el script de reversión desde la siguiente ubicación:

      https://download.citrixnetworkapi.net/root/download/v1/public/software?product=admonprem&build=migrationtool&model=servicemigrationtool_27.tgz

    2. Para las compilaciones de ADM 79.xx y 76.xx, guarde el script /mps/scripts y ejecute los siguientes comandos para la reversión:

      1. cd /mps/scripts

      2. python rollback_to_onprem.py < path of client/secret csv file in ADM on-prem>

        Por ejemplo, python rollback_to_onprem.py /var/ secureclient.csv

    3. Para compilaciones de ADM anteriores a 76.xx, guarde el script en ADM local. Por ejemplo, guárdelo en la ubicación /var y ejecute los siguientes comandos para la reversión:

      1. cd /var

      2. python rollback_to_onprem_27.py < path of client/secret csv file in ADM on-prem>

        Por ejemplo, python rollback_to_onprem_27.py /var/secureclient.csv

      La herramienta inicia la operación de reversión y un mensaje le pregunta si quiere continuar. Escriba Y para continuar.

Migración local de NetScaler ADM a Citrix Cloud