Migrar de Citrix Ready KVM VPX a NetScaler VPX™ oficialmente compatible en Nutanix AHV
El NetScaler VPX basado en KVM de Citrix Ready® en Nutanix AHV ha sido utilizado por muchos clientes, pero no cuenta con soporte oficial de Citrix® ni con funciones avanzadas de automatización. Por lo tanto, recomendamos a nuestros clientes migrar de Citrix Ready KVM VPX a NetScaler VPX oficialmente compatible en Nutanix AHV.
Requisito previo
Antes de migrar, revise las limitaciones de la imagen VPX específica de Nutanix AHV para asegurarse de que su entorno no dependa de ninguna característica excluida. Para obtener más información, consulte Funciones y limitaciones no compatibles.
Puede migrar de Citrix Ready KVM VPX a NetScaler VPX oficialmente compatible en Nutanix AHV utilizando uno de los siguientes métodos:
-
Actualización in situ de Citrix Ready KVM VPX a NetScaler VPX oficialmente compatible en Nutanix AHV
-
Migrar utilizando el reemplazo de alta disponibilidad (HA) nodo a nodo
Actualización in situ de Citrix Ready KVM VPX a NetScaler VPX oficialmente compatible en Nutanix AHV
A partir de la versión 14.1 compilación 66.x de NetScaler, puede realizar una actualización in situ de las instancias VPX basadas en KVM de Citrix Ready a NetScaler VPX oficialmente compatible en Nutanix AHV.
Importante:
Las instancias VPX de Citrix Ready que se actualicen a la versión 14.1-66.x o posterior deben utilizar el paquete de actualización específico de Nutanix oficialmente compatible. El paquete de actualización estándar no es compatible con esta migración.
Requisitos previos
-
Versión mínima de NetScaler: Asegúrese de que la versión actual de NetScaler sea 14.1–56.74 o posterior. Si la versión actual es anterior, actualice el dispositivo utilizando el paquete de actualización estándar antes de continuar.
-
Requisitos de hardware: Se requiere un mínimo de 2 GB de RAM por cada vCPU. Por ejemplo, una VM con 4 vCPU debe tener al menos 8 GB de RAM asignados.
-
Revisar limitaciones: Revise las limitaciones de VPX específicas de Nutanix AHV antes de continuar.
Consideraciones críticas antes de proceder con la actualización
-
Instantánea de la VM (obligatorio): Debe crear una instantánea de la VM en ejecución antes de proceder con la actualización. Esto le permite restaurar la VM si hay alguna pérdida de configuración. Para obtener más información, consulte Creación manual de una instantánea de VM.
-
Copia de seguridad externa (recomendado): Le recomendamos que cree una copia de seguridad externa de las configuraciones críticas y los datos personalizados, especialmente para los archivos ubicados fuera de los directorios preservados. Este paso es opcional si ya se ha tomado una instantánea de la VM.
-
Copia de seguridad y preservación de datos: Revise la sección Copia de seguridad y preservación de datos durante la actualización.
Copia de seguridad y preservación de datos durante la actualización
-
La actualización preserva automáticamente los archivos personalizados, los certificados y los archivos de firma dentro de directorios específicos. Los datos ubicados fuera de estas rutas no se preservan y requieren una copia de seguridad y restauración manuales.
Directorios preservados:
/flash/nsconfig/flash/boot/flash/configdb/var/tmp/*.csv/var/AAA/var/analytics_conf/var/download/var/krb/var/learnt_data/var/metrics_conf/var/netscaler/gui/var/netscaler/locdb/var/netscaler/logon/var/netscaler/ssl/var/nstemplates/var/vpn/var/vpns/var/clusterd/nsclusterd.conf
-
Si ha personalizado archivos de configuración en el directorio
/etc, consulte Consideraciones de actualización para archivos de configuración personalizados en el directorio /etc, antes de continuar con la migración. -
Las personalizaciones realizadas en los siguientes archivos se conservan durante el proceso de migración, pero es posible que no funcionen igual que antes de la migración:
rc.netscalernsbefore.shnsafter.shcrontab
Debe revisar y actualizar estos archivos de personalización para garantizar la compatibilidad con el NetScaler actualizado.
Procedimiento de actualización
-
Descargue el paquete de actualización de NetScaler VPX compatible con Nutanix AHV (formato:
build-<version-build>_lx_64.tgz) desde la página de descargas de Citrix. -
Vaya a Citrix.com > Downloads > NetScaler > Virtual Appliances y descargue el paquete de actualización de NetScaler VPX compatible con Nutanix AHV desde la página Citrix Downloads.
-
Copie el archivo
build-<version-build>_lx_64.tgzdescargado en el directorio/var/nsinstall/del shell de NetScaler VPX y extráigalo. -
Ejecute
./installnsy reinicie el dispositivo cuando se le solicite. No apague la VM durante los múltiples reinicios necesarios para el proceso.
Validación posterior a la actualización
-
Inicie sesión en la GUI/CLI de NetScaler VPX y verifique que la versión en ejecución coincida con la versión del paquete de actualización de destino.
-
Valide todos los servicios virtuales, certificados SSL y políticas para garantizar un funcionamiento correcto.
Migrar utilizando el método de reemplazo de alta disponibilidad (HA) nodo por nodo
La metodología de reemplazo nodo por nodo de HA permite una actualización con cero tiempo de inactividad y totalmente compatible desde Citrix Ready KVM VPX a la imagen de Nutanix AHV VPX oficialmente compatible. Esta transición desbloquea capacidades de automatización avanzadas, soporte oficial completo y una plataforma de implementación modernizada para NetScaler.
Paso 1: Bloquee el estado de HA de su nodo principal heredado.
-
Inicie sesión en su nodo principal de Citrix Ready KVM VPX y ejecute el siguiente comando:
set ha node -hastatus STAYPRIMARY <!--NeedCopy--> -
En el nodo secundario heredado, elimine su emparejamiento HA con el nodo principal usando el siguiente comando:
rm ha node <primary-nsip> <!--NeedCopy--> -
Verifique que el nodo principal siga sirviendo el tráfico sin interrupciones mientras procede con las tareas de migración o reemplazo.
Paso 2: Implemente un nuevo nodo secundario.
- Aprovisione una nueva instancia de NetScaler VPX utilizando la imagen oficial de Nutanix AHV 14.1-51.x.
- Asigne la dirección IP de administración utilizada anteriormente por su nodo secundario heredado.
- Complete la configuración inicial, aplique la licencia y verifique que la configuración de red sea correcta.
-
Una los nodos HA ejecutando el siguiente comando:
add ha node <primary-nsip> <!--NeedCopy--> -
Verifique que el estado de HA sea UP y que la sincronización sea exitosa usando el siguiente comando:
show ha node status <!--NeedCopy-->
Paso 3: Promueva el nuevo nodo secundario a principal.
-
En el nodo principal antiguo (el KVM VPX heredado), desactive el estado de permanencia como principal usando el siguiente comando:
unset ha node -stayprimary <!--NeedCopy--> -
Fuerce una conmutación por error usando el siguiente comando:
force ha failover <!--NeedCopy--> -
Verifique que el nodo secundario recién implementado se haya convertido con éxito en el nodo principal y esté completamente operativo.
show ha node status <!--NeedCopy--> -
Configure el nuevo nodo principal para que permanezca como principal usando el siguiente comando:
set ha node -hastatus STAYPRIMARY <!--NeedCopy-->Nota:
Si la sincronización de HA falla, sincronice manualmente las contraseñas RPC en ambos nodos usando el comando
set rpcNode <peer-ip> -password <password>. -
Si surge algún problema durante este paso, vuelva al primario antiguo y restaure el nodo secundario heredado. Para obtener ayuda, póngase en contacto con el equipo de soporte de Citrix.
Paso 4: Reemplace el secundario heredado con un nuevo VPX.
-
Elimine el nodo secundario heredado de la configuración de HA utilizando el siguiente comando:
rm ha node <legacy-secondary-nsip> <!--NeedCopy--> - Aprovisione otra nueva instancia de VPX utilizando la imagen oficial de Nutanix AHV 14.1-51.x.
- Asigne la dirección IP de administración del nodo secundario heredado a la nueva instancia de VPX.
-
Complete la configuración y la activación de la licencia.
-
Una este nuevo VPX al par de HA utilizando el siguiente comando:
add ha node <new-primary-nsip> <!--NeedCopy--> -
Verifique que el estado de HA sea estable, “UP” (activo) y sincronizado utilizando el siguiente comando.
show ha node status <!--NeedCopy-->
Paso 5: Valide y finalice.
- Verifique los roles de HA y el estado de sincronización en ambos nodos nuevos.
- Valide todos los servicios virtuales, certificados SSL y políticas para garantizar un funcionamiento correcto.
- Realice pruebas de conmutación por error y recuperación para verificar la redundancia.
- Realice una copia de seguridad de todas las configuraciones y cree una instantánea del nuevo entorno.
- Después de una validación exitosa, elimine las instancias de VPX heredadas para liberar recursos.
Consideraciones críticas
-
Copia de seguridad: Es esencial conservar copias de seguridad de sus nodos heredados hasta que el nuevo entorno VPX haya sido completamente validado y sea estable.
-
Funciones no compatibles: No se recomienda la migración si su implementación actual depende de funciones que no son compatibles con la nueva imagen VPX de Nutanix AHV. Para obtener más información, consulte Funciones y limitaciones no compatibles.