Documentation produit
Citrix ADC
Current Release 13.0 12.1
Voir PDF

Considérations relatives à la mise à niveau des fichiers de configuration personnalisés du répertoire /etc

December 16, 2022
Contributeur: 
C

Les fichiers de configuration suivants peuvent être modifiés dans le répertoire /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

Remarque :

de nouveaux fichiers peuvent être ajoutés à la liste ci-dessus en fonction de la version Citrix ADC exécutée sur l’appliance. Vous pouvez afficher une liste de fichiers mise à jour en exécutant la commande shell suivante dans l’interface de ligne de commande Citrix ADC :

grep NSETC= /etc/rc

Si vous avez modifié l’un des fichiers de configuration du répertoire /etc et que vous l’avez copié dans le répertoire /nsconfig, pour préserver la persistance, l’appliance Citrix ADC crée un lien symbolique dans /etc pointant vers le fichier dans /nsconfig.

Pa exemple : /etc/httpd.conf -> /nsconfig /httpd.conf

Un package de version peut contenir sa propre version des fichiers de configuration du répertoire /etc. Ces fichiers de configuration incluent des mises à jour importantes qui sont nécessaires au bon fonctionnement de l’appliance Citrix ADC. La mise à niveau d’une appliance Citrix ADC vers une version remplace les fichiers de configuration du répertoire /etc par les fichiers de configuration contenant les mises à jour de version.

Prenons l’exemple d’un fichier de configuration personnalisé example.conf, présent dans le répertoire /etc. Le fichier example.conf est copié dans le répertoire /nsconfig pour préserver sa persistance. L’appliance Citrix ADC crée un lien symbolique /etc pointant vers le fichier dans /nsconfig: /etc/example.conf -> / nsconfig /example.conf

En outre, un package de version inclut sa propre version de example.conf, qui contient des mises à jour importantes. Le comportement suivant est observé lors de la mise à niveau de l’appliance Citrix ADC vers la version :

Le lien symbolique /etc/example.conf étant déjà présent, l’appliance Citrix ADC ne place pas la copie du package de example.conf dans le répertoire /etc pendant le processus de mise à niveau.

Comme la copie du package de example.conf contient des mises à jour importantes, son absence dans le répertoire /etc peut entraîner l’échec ou le mauvais fonctionnement de l’appliance Citrix ADC.

Étapes pour préserver les modifications apportées aux mises à niveau

Pour vous assurer que les mises à jour de version et vos personnalisations ne sont pas perdues, effectuez les opérations suivantes :

Sauvegarder le fichier personnalisé avant la mise à niveau

Effectuez une sauvegarde des fichiers personnalisés présents dans le répertoire /nsconfig avant de mettre à niveau l’appliance.

Créez un répertoire /var/nsconfig_backup et déplacez les fichiers personnalisés vers ce répertoire. En d’autres termes, déplacez tous les fichiers que vous avez modifiés dans le répertoire /etc et dans lesquels vous avez copié /nsconfig en exécutant la commande suivante à l’invite du shell :

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

Exemple :

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

Suppression de la persistance du fichier personnalisé avant la mise à niveau

Supprimez les liens symboliques /etc pointant vers les fichiers /nsconfig avant de mettre à niveau l’appliance.

  1. Vérifiez les liens symboliques existants dans le répertoire /etc en exécutant la commande suivante à l’invite du shell :

    ls -la /etc
<!--NeedCopy-->

  2. Supprimez un lien symbolique /etc pointant vers un fichier /nsconfig en exécutant la commande suivante à l’invite du shell :

    unlink /etc/<filename>
<!--NeedCopy-->

    Exemple :

    unlink /etc/httpd.conf
<!--NeedCopy-->

  3. Vérifiez que le lien symbolique est supprimé en exécutant la commande suivante à l’invite du shell :

    cat /etc/<filename>
<!--NeedCopy-->

    Exemple :

    cat /etc/httpd.conf
<!--NeedCopy-->

    Cette commande n’affiche aucun contenu si le lien symbolique est supprimé.

Application de personnalisations au fichier mis à niveau et ajout de persistance après la mise à niveau

Si vous avez effectué une sauvegarde d’un fichier de configuration /nsconfig modifié sur /var/nsconfig_backup, procédez comme suit après la mise à niveau de l’appliance :

  1. Comparez le fichier présent dans les répertoires /var/nsconfig_backup et /etc. Ajoutez manuellement les modifications appropriées au fichier /etc contenant déjà les mises à jour de version.

    Important :

    Le remplacement direct du fichier /etc par le fichier /var/nsconfig_backup supprime toutes les mises à jour de version ajoutées au fichier pendant le processus de mise à niveau. Cette suppression des mises à jour peut entraîner l’échec ou le mauvais fonctionnement des fonctionnalités associées de Citrix ADC.

  2. Pour maintenir la persistance, copiez le fichier mis à jour présent dans le répertoire /etc dans le répertoire /nsconfig en exécutant la commande suivante à l’invite du shell :

    cp /etc/<filename> /nsconfig/
<!--NeedCopy-->

    Exemple :

    cp /etc/httpd.conf /nsconfig/
<!--NeedCopy-->

  3. Répétez les deux étapes ci-dessus pour chaque fichier personnalisé présent dans le répertoire /var/nsconfig_backup.

  4. Redémarrez l’appliance pour que les modifications soient prises en compte.

Considérations relatives à la mise à niveau des fichiers de configuration personnalisés du répertoire /etc
December 16, 2022
Contributeur: 
C
December 16, 2022
Contributeur: 
C

Dans cet article

Commentaires sur le site | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement
© 1999- Cloud Software Group, Inc. All rights reserved.