Upgrade and downgrade
Each NetScaler BLX release offers new and updated features with increased functionality. We recommend you to upgrade NetScaler BLX to the latest release to avail of the new features and bug fixes. A comprehensive list of enhancements, known issues, and bug fixes is included in the release notes accompanying every release announcement.
Before you begin
- You must evaluate your organization’s support agreement. Document the support agreement and contact details for support from NetScaler® technical support or the NetScaler authorized partner.
- It is also important to understand the licensing framework and the types of licenses that can be used before upgrading. For more information, see NetScaler BLX licensing.
- You must check the New and deprecated commands, parameters, and SNMP OIDs topics.
- Back up the configuration files of NetScaler BLX. For information on how to backup and restore, see How to backup and restore your NetScaler to recover lost configuration.
Note:
For the more details on the list of files that are backed up, see the List of backed up files.
-
Upgrading or downgrading NetScaler BLX is the same as Installation of NetScaler BLX. The package manager of the Linux host manages the upgrade or downgrade operation based on the build numbers.
- If necessary, you can try upgrading or downgrading a NetScaler BLX in a test environment.
Upgrade NetScaler BLX
- Download the NetScaler BLX release package that you want to upgrade to. For more information, see Download the NetScaler BLX package on the Linux host.
-
Install the downloaded package using the Linux host CLI. For more information, see Install NetScaler BLX on a Debian-based Linux host or Install NetScaler BLX on an RPM-based Linux host.
Note:
If you have configured the NetScaler BLX managed host, do the following steps before installing the downloaded package:
- Log in to the host IP address.
- Stop NetScaler BLX using the
systemctl stop blxcommand. - Reconnect to host IP address.
Downgrade NetScaler BLX
- Download the NetScaler BLX release package that you want to downgrade to. For more information, see Download the NetScaler BLX package on the Linux host.
-
Install the downloaded package using the Linux host CLI. For more information, see Install NetScaler BLX on a Debian-based Linux host or Install NetScaler BLX on an RPM-based Linux host.
Note:
-
If you have configured the NetScaler BLX managed host, do the following steps before installing the downloaded package:
- Log in to the host IP address.
- Stop NetScaler BLX using the
systemctl stop blxcommand. - Reconnect to host IP address.
-
- For NetScaler BLX managed host configured using the auto-configuration feature, when you downgrade NetScaler BLX from version 13.1 build 45.64 or later to version 13.1 build 42.47 or earlier, do the following steps:
- Open the
blx.conffile in the directory/etc/blx/. - Uncomment the
interfacesparameter and specify the interfaces that you want to dedicate to NetScaler BLX in theblx.conffile. - Uncomment the
ip-addressparameter and specify the NSIP address for NetScaler BLX. - Uncomment the
defaultparameter and specify the default route for NetScaler BLX. - Save the
blx.conffile. - Restart NetScaler BLX using the
systemctl restart blxcommand.
- Open the
Verify entity status on NetScaler BLX after the upgrade or downgrade
After NetScaler BLX is upgraded or downgraded, verify the following:
- Virtual servers are in UP state
- Monitors are in UP state
- All certificates are present on NetScaler BLX
- All the licenses are present on NetScaler BLX