ADC

/etc ディレクトリ内のカスタマイズされた設定ファイルのアップグレードに関する考慮事項

/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

注:

アプライアンスで実行されているCitrix ADCビルドによっては、上記のリストに新しいファイルが追加される場合があります。Citrix ADCコマンドラインインターフェイスで次のシェルコマンドを実行すると、更新されたファイルリストを表示できます。

grep NSETC= /etc/rc

/etcディレクトリ内の構成ファイルを変更して/nsconfigディレクトリにコピーした場合、永続性を維持するために、Citrix ADCアプライアンスは/nsconfig中のファイルを指すシンボリックリンクを/etcに作成します 。

たとえば、次のようになります:/etc/httpd.conf -> /nsconfig /httpd.conf

リリースパッケージには、 /etc ディレクトリに独自のバージョンの設定ファイルが含まれている場合があります。これらの構成ファイルには、Citrix ADCアプライアンスが正常に機能するために必要な重要な更新が含まれています。Citrix ADCアプライアンスをリリースにアップグレードすると、 /etc ディレクトリ内の構成ファイルがリリースアップデートを含む構成ファイルに置き換えられます。

/etcディレクトリにある、カスタマイズされた設定ファイルexample.confの例を考えてみましょう。 example.confファイルは、 永続性を維持するために/nsconfigディレクトリにコピーされます。Citrix ADCアプライアンスは、 /nsconfigで次のファイルを指すシンボリックリンクを/etcに作成します 。 /etc/example.conf -> / nsconfig /example.conf

また、リリースパッケージには、重要な更新を含む独自のバージョンのexample.confが含まれています。Citrix ADCアプライアンスをリリースにアップグレードすると、次の動作が観察されます。

シンボリックリンク/etc/example.confはすでに存在するため、Citrix ADCアプライアンスは、アップグレードプロセス中にexample.confのリリースパッケージコピーをディレクトリ/etcに配置しません。

example.confのリリースパッケージコピーには重要な更新が含まれているため、/etcディレクトリに更新がないと、Citrix ADCアプライアンスが失敗したり、正しく機能しなくなる可能性があります。

アップグレードの変更とカスタマイズを保持する手順

リリースの更新とカスタマイズの両方が失われないようにするには、次の手順を実行します。

アップグレード前にカスタマイズしたファイルをバックアップする

アプライアンスをアップグレードする前に、 /nsconfig ディレクトリにあるカスタマイズファイルのバックアップを作成します。

/var/nsconfig_backup ディレクトリを作成し、カスタマイズしたファイルをこのディレクトリに移動します。つまり、シェルプロンプトで次のコマンドを実行して、/etcディレクトリで変更して/nsconfigにコピーしたファイルを移動します。

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

:

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

アップグレード前にカスタマイズしたファイルの永続性を削除する

アプライアンスをアップグレードする前に、/nsconfigファイルを指している/etcシンボリックリンクを削除します。

  1. シェルプロンプトで次のコマンドを実行して、 /etc ディレクトリ内の既存のシンボリックリンクを確認します。

    ls -la /etc
    <!--NeedCopy-->
    
  2. シェルプロンプトで次のコマンドを実行して、/nsconfigファイルを指す/etcシンボリックリンクを削除します。

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

    例:

    unlink /etc/httpd.conf
    <!--NeedCopy-->
    
  3. シェルプロンプトで次のコマンドを実行して、シンボリックリンクが削除されたことを確認します。

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

    例:

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

    シンボリックリンクが削除されると、このコマンドはコンテンツを表示しません。

アップグレードしたファイルにカスタマイズを適用し、アップグレード後に永続性を追加

変更した/nsconfig設定ファイルのバックアップを/var/nsconfig_backupに取った場合は 、アプライアンスのアップグレード後に次の操作を行います。

  1. /var/nsconfig_backup/etcディレクトリにあるファイルを比較します。リリースアップデートをすでに含んでいる/etcファイルに、適切な変更を手動で追加します。

    重要:

    /etcファイルを/var/nsconfig_backupファイルに直接置き換えると、アップグレードプロセス中にファイルに追加されたリリースアップデートが削除されます。この更新プログラムの削除により、関連するCitrix ADC機能が失敗するか、正しく動作しなくなる可能性があります。

  2. 永続性を維持するには、シェルプロンプトで次のコマンドを実行して、/etcディレクトリにある更新されたファイルを/nsconfigディレクトリにコピーします。

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

    例:

    cp /etc/httpd.conf /nsconfig/
    <!--NeedCopy-->
    
  3. /var/nsconfig_backupディレクトリにあるカスタマイズしたファイルごとに、上記の 2 つの手順を繰り返します。

  4. アプライアンスを再起動して、変更を有効にします。

/etc ディレクトリ内のカスタマイズされた設定ファイルのアップグレードに関する考慮事項