Application Delivery Management

Migración local de NetScaler ADM a Citrix Cloud

January 30, 2024

Contribución de:

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:

Inicie sesión en citrix.cloud.com
Haga clic en el icono Inicio y seleccione Administración de identidades y accesos.
En la ficha Acceso API, introduzca un nombre de cliente seguro y haga clic en Crear cliente.
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.

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.

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

Nota

Para un par ADM HA, inicie sesión en el nodo principal.
Escribe shell y presiona Entrar para cambiar al modo bash.
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.

Nota

Para un par ADM HA, copie el archivo CSV en el nodo principal.
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:

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:

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.
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
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.

Con un cliente SSH, inicie sesión en el ADM local.
Escribe shell y presiona Enter para cambiar al modo bash.
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.
  
  Puede ver el siguiente mensaje después de que se complete la reversión.
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.

La versión oficial de este contenido está en inglés. Para mayor comodidad, parte del contenido de la documentación de Cloud Software Group solo tiene traducción automática. Cloud Software Group no puede controlar el contenido con traducción automática, que puede contener errores, imprecisiones o un lenguaje inadecuado. No se ofrece ninguna garantía, ni implícita ni explícita, en cuanto a la exactitud, la fiabilidad, la idoneidad o la precisión de las traducciones realizadas del original en inglés a cualquier otro idioma, o que su producto o servicio de Cloud Software Group se ajusten a cualquier contenido con traducción automática, y cualquier garantía provista bajo el contrato de licencia del usuario final o las condiciones de servicio, o cualquier otro contrato con Cloud Software Group, de que el producto o el servicio se ajusten a la documentación no se aplicará en cuanto dicha documentación se ha traducido automáticamente. Cloud Software Group no se hace responsable de los daños o los problemas que puedan surgir del uso del contenido traducido automáticamente.

Migración local de NetScaler ADM a Citrix Cloud

January 30, 2024

Contribución de:

January 30, 2024

Contribución de:

En este artículo

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
Volver a ADM local