ADC

Upgrade considerations for customized configuration files in the /etc directory

The following configuration files are supported to be modified in the /etc directory:

  • 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

Note:

New files might be added to the above list depending on the NetScaler build running on the appliance. You can display an updated list of files by running the following shell command in the NetScaler command line interface:

grep NSETC= /etc/rc

If you have modified any of the configuration files in the /etc directory and copied it to the /nsconfig directory, to maintain persistency, the NetScaler appliance creates a symlink in /etc pointing to the file in /nsconfig.

For example: /etc/httpd.conf -> /nsconfig/httpd.conf

A release package might contain its own version of the configuration files in the /etc directory. These configuration files include important updates that are required for the NetScaler appliance to properly function. Upgrading a NetScaler appliance to a release replaces the configuration files in the /etc directory with the configuration files containing the release updates.

Consider an example of a customized configuration file, example.conf, which is present in the /etc directory. The example.conf file is copied to the /nsconfig directory to maintain persistency. The NetScaler appliance creates a symlink in /etc pointing to the file in /nsconfig: /etc/example.conf -> /nsconfig/example.conf

Also, a release package includes its own version of example.conf, which contains important updates. The following behavior is observed when you upgrade the NetScaler appliance to the release:

Because the symlink /etc/example.conf is already present, the NetScaler appliance does not place the release package copy of the example.conf in the /etc directory during the upgrade process.

As the release package copy of example.conf contains important updates, the absence of it in the /etc directory can cause the NetScaler appliance to fail or to not properly function.

Steps to preserve upgrade changes and customization

To ensure that both release updates and your customizations are not lost, perform the following steps:

Back up customized file before upgrade

Take a backup of the customized files present in the /nsconfig directory before upgrading the appliance.

Create a /var/nsconfig_backup directory and move the customized files to this directory. That is, move any files that you modified in the /etc directory and copied to /nsconfig by running the following command at the shell prompt:

mv /nsconfig/<filename> /var/nsconfig_backup/

Example:

mv /nsconfig/httpd.conf /var/nsconfig_backup/

Remove persistency of customized file before upgrade

Delete the /etc symlinks that are pointing to the /nsconfig files before upgrading the appliance.

  1. Check the existing symlinks in the /etc directory by running the following command at the shell prompt:

    ls -la /etc
  2. Delete a /etc symlink pointing to a /nsconfig file by running the following command at the shell prompt:

    unlink /etc/<filename>

    Example:

    unlink /etc/httpd.conf
  3. Verify that the symlink is removed by running the following command at the shell prompt:

    cat /etc/<filename>

    Example:

    cat /etc/httpd.conf

    This command does not display any content if the symlink is removed.

Apply customizations to upgraded file and add persistency after upgrade

If you have taken a backup of any modified /nsconfig config file to the /var/nsconfig_backup, do the following after upgrading the appliance:

  1. Compare the file present in the /var/nsconfig_backup and the /etc directories. Manually add the appropriate changes to the /etc file already containing the release updates.

    Important:

    Directly replacing the /etc file with the /var/nsconfig_backup file removes any release updates added to the file during the upgrade process. This removal of updates can cause the related NetScaler functionalities to fail or to not work properly.

  2. To maintain persistency, copy the updated file present in the /etc directory to the /nsconfig directory by running the following command at the shell prompt:

    cp /etc/<filename> /nsconfig/

    Example:

    cp /etc/httpd.conf /nsconfig/
  3. Repeat the above two steps for each customized file present in the /var/nsconfig_backup directory.

  4. Restart the appliance to put the changes into effect.

Upgrade considerations for customized configuration files in the /etc directory