Citrix ADC

Consideraciones sobre la actualización de los archivos de configuración personalizados en el directorio /etc

December 16, 2022

Contribución de:

Se admite la modificación de los siguientes archivos de configuración en el directorio /etc:

inetd.conf
syslog.conf
newsyslog.conf
ntp.conf
crontab
host.conf
hosts
ttys
sshd_config
httpd.conf
monitrc
rc.conf
ssh_config
localtime
issue
issue.net
ldap.conf
motd

Nota:

Es posible que se agreguen nuevos archivos a la lista anterior en función de la compilación Citrix ADC que se ejecute en el dispositivo. Puede mostrar una lista actualizada de archivos ejecutando el siguiente comando de shell en la interfaz de línea de comandos de Citrix ADC:

grep NSETC= /etc/rc

Si ha modificado alguno de los archivos de configuración del directorio /etc y lo ha copiado en el directorio /nsconfig, para mantener la persistencia, el dispositivo Citrix ADC crea un enlace simbólico en /etc que apunta al archivo de /nsconfig.

Por ejemplo: /etc/httpd.conf -> /nsconfig /httpd.conf

Un paquete de versión puede contener su propia versión de los archivos de configuración del directorio /etc. Estos archivos de configuración incluyen actualizaciones importantes que se requieren para que el dispositivo Citrix ADC funcione correctamente. La actualización de un dispositivo Citrix ADC a una versión reemplaza los archivos de configuración del directorio /etc por los archivos de configuración que contienen las actualizaciones de la versión.

Considere un ejemplo de un archivo de configuración personalizado, example.conf, que está presente en el directorio /etc. El archivo example.conf se copia en el directorio /nsconfig para mantener la persistencia. El dispositivo Citrix ADC crea un enlace simbólico que /etc apunta al archivo en /nsconfig: /etc/example.conf -> / nsconfig /example.conf

Además, un paquete de versión incluye su propia versión de example.conf, que contiene actualizaciones importantes. Se observa el siguiente comportamiento al actualizar el dispositivo Citrix ADC a la versión:

Como el enlace simbólico /etc/example.conf ya está presente, el dispositivo Citrix ADC no coloca la copia del paquete de versión de example.conf en el directorio /etc durante el proceso de actualización.

Como la copia del paquete de versión de example.conf contiene actualizaciones importantes, su ausencia en el directorio /etc puede provocar que el dispositivo Citrix ADC falle o no funcione correctamente.

Pasos para conservar los cambios de actualización y la personalización

Para asegurarse de que no se pierdan ni las actualizaciones de la versión ni las personalizaciones, lleve a cabo los siguientes pasos:

Pasos previos a la actualización:
- Realizar una copia de seguridad del archivo personalizado antes de la actualización
- Eliminar la persistencia del archivo personalizado antes de la actualización
Pasos posteriores a la actualización:
- Aplicar personalizaciones al archivo actualizado y agregar persistencia tras la actualización
  
  Importante:
  
  NO sustituya directamente el archivo personalizado de la carpeta /etc. Al reemplazar directamente un archivo /etc por el archivo personalizado de copia de seguridad, se eliminan las actualizaciones de versión agregadas al archivo durante el proceso de actualización.

Realizar una copia de seguridad del archivo personalizado antes de la actualización

Realice una copia de seguridad de los archivos personalizados presentes en el directorio /nsconfig antes de actualizar el dispositivo.

Cree un directorio /var/nsconfig_backup y mueva los archivos personalizados a este directorio. Es decir, mueva los archivos que haya modificado en el directorio /etc y que haya copiado en /nsconfig ejecutando el siguiente comando en el intérprete de comandos:

mv /nsconfig/<filename> /var/nsconfig_backup/
<!--NeedCopy-->

Ejemplo:

mv /nsconfig/httpd.conf /var/nsconfig_backup/
<!--NeedCopy-->

Eliminar la persistencia del archivo personalizado antes de la actualización

Elimine los enlaces simbólicos /etc que apuntan a los archivos /nsconfig antes de actualizar el dispositivo.

Compruebe los enlaces simbólicos existentes en el directorio /etc ejecutando el siguiente comando en el símbolo del shell:
```
ls -la /etc

```
Para eliminar un enlace simbólico /etc que apunte a un archivo /nsconfig, ejecuta el siguiente comando en el símbolo del shell:
```
unlink /etc/<filename>

```
Ejemplo:
```
unlink /etc/httpd.conf

```
Verifique que el enlace simbólico se haya eliminado ejecutando el siguiente comando en el indicador de shell:
```
cat /etc/<filename>

```
Ejemplo:
```
cat /etc/httpd.conf

```
Este comando no muestra ningún contenido si se quita el enlace simbólico.

Aplicar personalizaciones al archivo actualizado y agregar persistencia tras la actualización

Si ha realizado una copia de seguridad de cualquier archivo de configuración /nsconfig modificado en /var/nsconfig_backup, haga lo siguiente después de actualizar el dispositivo:

Compare el archivo presente en los directorios /var/nsconfig_backup y /etc. Agregue manualmente los cambios correspondientes al archivo /etc que ya contiene las actualizaciones de la versión.

Importante:

Al reemplazar directamente el archivo /etc por el archivo /var/nsconfig_backup, se eliminarán las actualizaciones de versión agregadas al archivo durante el proceso de actualización. Esta eliminación de actualizaciones puede provocar que las funcionalidades relacionadas de Citrix ADC fallen o no funcionen correctamente.
Para mantener la persistencia, copie el archivo actualizado presente en el directorio /etc en el directorio /nsconfig ejecutando el siguiente comando en el símbolo del shell:
```
cp /etc/<filename> /nsconfig/

```
Ejemplo:
```
cp /etc/httpd.conf /nsconfig/

```
Repita los dos pasos anteriores para cada archivo personalizado presente en el directorio /var/nsconfig_backup.
Reinicie el dispositivo para aplicar los cambios.

La versión oficial de este contenido está en inglés. Para mayor comodidad, parte del contenido de la documentación de Citrix solo tiene traducción automática. Citrix 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 Citrix 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 Citrix, 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. Citrix no se hace responsable de los daños o los problemas que puedan surgir del uso del contenido traducido automáticamente.

¿Le ha resultado útil?

Consideraciones sobre la actualización de los archivos de configuración personalizados en el directorio /etc

December 16, 2022

Contribución de:

December 16, 2022

Contribución de:

En este artículo

Pasos para conservar los cambios de actualización y la personalización
Realizar una copia de seguridad del archivo personalizado antes de la actualización
Eliminar la persistencia del archivo personalizado antes de la actualización
Aplicar personalizaciones al archivo actualizado y agregar persistencia tras la actualización

¿Le ha resultado útil?