ADC

Consideraciones de actualización para configuraciones con directivas clásicas

Las directivas clásicas están en desuso en la versión 12.0, compilación 56.20 de NetScaler. A partir de la versión 13.1, se ha eliminado la compatibilidad con las directivas clásicas de algunas de las funciones. Para conocer la lista completa de funciones o comandos que no se admiten en la versión 13.1, consulte la tabla 2 del anuncio de cambio de estado de las funciones y funcionalidades basadas en directivas de NetScaler Classic.

Como requisito previo para actualizar a la versión 13.1 o posterior, le recomendamos que convierta las políticas clásicas en políticas avanzadas para las funciones compatibles con la herramienta NSPEPI. Para conocer las funciones que admite la herramienta NSPEPI, consulte Comandos o funciones gestionadas por la herramienta de conversión nspepi. Si no convierte a directivas avanzadas antes de la actualización, la actualización fallará debido a una configuración no válida.

Importante:

Antes de actualizar a la versión 13.1 o posterior, le recomendamos que ejecute la herramienta de comprobación previa a la configuración. Esta herramienta garantiza que la configuración no contenga comandos relacionados con las funciones obsoletas o eliminadas. Si hay algún comando relacionado con las funciones obsoletas o eliminadas, la herramienta arroja un error y es posible que se pierda la configuración. Te recomendamos que descargues la última versión de la herramienta de verificación previa a la configuración desde el enlace público de GitHub: https://github.com/citrix/ADC-scripts/tree/master/nspepi.

Para obtener más información, consulte la herramienta de comprobación previa a la configuración antes de la actualización.

Si hay algún error como parte de la comprobación previa a la configuración, le recomendamos que utilice la herramienta nspepi para convertir las configuraciones no válidas en configuraciones válidas. Descargue la versión más reciente de la herramienta nspepi desde el enlace público de GitHub: https://github.com/citrix/ADC-scripts/tree/master/nspepi. Para obtener más información sobre la conversión de expresiones de directiva mediante la herramienta nspepi, consulte Convertir expresiones de directiva mediante la herramienta NSPEPI.

Si no logras convertir las directivas clásicas antes de la actualización, puede optar por convertirlas en directivas avanzadas durante la actualización. Como parte de la actualización, puede elegir una de las opciones que se describen en la tabla siguiente mientras ejecuta el comando ./installns.

Opción Descripción
Sin opción Si se produce algún error como parte de la comprobación previa a la configuración, la instalación se detiene. Debe convertir las directivas clásicas en directivas avanzadas para continuar con el proceso de actualización.
-M La herramienta NSPEPI se ejecuta como parte de la instalación y convierte las directivas clásicas en directivas avanzadas.
-Y No se recomienda esta opción. En esta opción, se omite la comprobación previa a la configuración y, por lo tanto, se puede perder cualquier configuración válida.

Para convertir las directivas clásicas en directivas avanzadas durante la actualización, seleccione la opción -M. La opción -M activa la herramienta NSPEPI y actualiza el archivo ns.conf existente con la configuración modificada. La configuración anterior está presente en /nsconfig/ns.conf_old para consultarla en el futuro.

./installns -M`
<!--NeedCopy-->

Si encuentra algún error durante la conversión avanzada de directivas, póngase en contacto con el soporte de NetScaler.

La herramienta nspepi no gestiona la conversión de algunos comandos o funciones. Consulte Comandos o funciones no gestionados por la herramienta de conversión nspepi para obtener la lista completa.

Nota:

Si tiene directivas clásicas y quiere convertirlas en avanzadas durante la actualización, puede usar el procedimiento de actualización normal (HA o configuración de clúster o independiente), pero usar la opción “-M” con el comando installns.

Si quiere convertir la configuración antes de la actualización, lleve a cabo los siguientes pasos para cada configuración:

  1. Ejecute la herramienta nspepi en las versiones 12.1 o 13.0 de Citrix ADC para convertir el archivo ns.conf. La herramienta NSPEPI genera dos archivos con los prefijos new_ y warn_. El archivo con el prefijo new_ contiene la configuración convertida, y el archivo con el prefijo warn_ contiene las advertencias y los errores.
  2. Compruebe el archivo con el prefijo warn_ y corrija los errores (si los hubiera).
  3. Pruebe la configuración convertida. Aplique la configuración convertida mediante una de las siguientes opciones:
    1. Ejecute el comando clear config -f basic y, a continuación, ejecute el comando source /nsconfig/new_ns.conf para obtener la configuración convertida.
    2. Quite los comandos clásicos manualmente (desvinculando y eliminando las directivas) y, a continuación, ejecute el comando source /nsconfig/new_ns.conf para obtener la configuración convertida.

      Nota:

      Es posible que aparezca el error “El recurso ya existe” en las configuraciones que no se borran con el clear config -f basic comando. Puede ignorar estos errores.

  4. Guarde la configuración.

Tras convertir correctamente las configuraciones no válidas en configuraciones válidas, compruebe si hay otros requisitos previos y, a continuación, proceda a la actualización. Para obtener más información, consulte Actualización y degradación de un dispositivo NetScaler.

Consideraciones de actualización para configuraciones con directivas clásicas

En este artículo