Before upgrading F5® BIG-IQ® Centralized Management, perform the following tasks.
|Re-activate the BIG-IQ system license.||You must do this on both the active and the secondary BIG-IQ if they are running in an HA pair. For specific instructions about how to reactivate a license, refer to the F5® BIG-IQ® Central Management: Licensing and Initial Setup guide.|
|Create a backup of the BIG-IQ system's current compressed user configuration set (UCS) and store it on a remote server.||The UCS file includes: system-specific configuration files, license, user account and password information, and SSL certificates and keys. You can use this backup in the event you want to restore to the previous version of BIG-IQ.|
|Decide which disk volume you want to install the upgrade on. You must have at least two volumes to upgrade BIG-IQ.||If you are running BIG-IQ Virtual Edition and you don't have two volumes, refer to: K17406: Using the tmsh utility to create a new software volume for installing a new image or hotfix on the BIG-IQ system at: support.f5.com/csp/article/K17406|
|Deploy any staged configuration changes to your managed devices.||
This step is required only if you are going to use the script to re-discover and re-import BIG-IP devices and services after the upgrade (as outlined in the section titled, Re-discover devices and re-import services in bulk using a script).You must deploy configuration changes you have staged for your devices if you use this script, because they'll be overwritten on BIG-IQ after you run the script. If you'd rather re-discover devices and re-import services from the BIG-IQ user interface (instead of in bulk) so you can address any potential configuration conflicts for each BIG-IP device, refer to the section titled, Re-discover devices and re-import services from the user interface.
Gather the following information:
|Required information||For my configuration|
|You'll need to create a passphrase for the Master Key. The passphrase must
|Get the discovery address you specified on the BIG-IQ system during setup. This is the same IP address that the peers in a high availability confirmation use to communicate. You can find this IP address on the BIG-IQ HA screen.|
|Get your BIG-IQ administrator and root passwords.|
|Get the name for the secondary HA BIG-IQ system if configured in an HA pair.|
If you're currently running a version of BIG-IQ prior to version 5.0, you must first upgrade to version 5.0 before you can upgrade to version 5.3. For more information, refer to the guide titled, F5 BIG-IQ Centralized Management: Upgrading BIG-IQ to Version 5.0.
If you're upgrading BIG-IQ Data Collection Device clusters, refer to the guide titled, F5 BIG-IQ Centralized Management: Upgrading Data Collection Device clusters to version 5.3.
The user interface for BIG-IQ® Centralized Management has changed between releases. Before you start the upgrade process, decide which workflow is appropriate for you.
|If you're upgrading from:||Use this guide:||Note:|
|Version 5.0||F5 BIG-IQ Centralized Management: Upgrading Version 5.0 to Version 5.1||For all tasks and references of v5.1.0, substitute v5.3.0.|
|Version 5.1||F5 BIG-IQ Centralized Management: Upgrading Version 5.x to Version 5.2||For all tasks and references of v5.1.0 or v5.2.0, substitute v5.3.0.|
|Version 5.2||F5 BIG-IQ Centralized Management: Upgrading Version 5.x to Version 5.3||N/A|
To upgrade F5® BIG-IQ® Centralized Management from BIG-IQ version 5.x to 5.3, perform these procedures. Upgrading BIG-IQ to the most recent version requires that you update its configuration to incorporate new features introduced. It's a good idea to set aside at least a few hours to complete this process.
Upload the BIG-IQ version 5.3 software image to the primary BIG-IQ system to make it available for this upgrade.
You need at least two volumes to upgrade F5® BIG-IQ® Centralized Management. If you are running BIG-IQ Virtual Edition and don't have two volumes, refer to: K17406: Using the tmsh utility to create a new software volume for installing a new image or hotfix on the BIG-IQ system at support.f5.com/csp/article/K17406.htmlBefore upgrading the primary BIG-IQ you must download the BIG-IQ version 5.3 .iso image from the F5 downloads site.
Upgrade BIG-IQ to take advantage of the newest functionality and features.
After you upgrade the primary BIG-IQ® Centralized Management system to version 5.3, you can upgrade a secondary BIG-IQ system for an HA configuration.You need at least two volumes to install BIG-IQ software. If you are running BIG-IQ Virtual Edition and you don't have two volumes, refer to: K17406: Using the tmsh utility to create a new software volume for installing a new image or hotfix on the BIG-IQ system at https://support.f5.com/csp/article/K17406.
Even though you can log in to the secondary BIG-IQ after the you re-establish the HA configuration, the system continues some database re-indexing processes in the background. For larger configurations, that can take up to an hour. If you perform any searches on objects before it's done re-indexing, BIG-IQ might not return the expected results. During this time, you can use the primary BIG-IQ.
To properly communicate, BIG-IQ® Centralized Management and managed BIG-IP® devices must be running a compatible version of its framework. If the frameworks are incompatible, BIG-IQ displays a yellow triangle next to the device in the BIG-IP Device inventory.
When you upgrade a BIG-IP device running version 11.5.x to another 11.5.x version, or to an 11.6.x version (for example, from version 11.5.3 to 11.5.4, or from version 11.5.3 to version 11.6.1), you must upgrade the REST framework so BIG-IQ can manage the device.
When you upgrade BIG-IQ from version 5.x to 5.3, you must also upgrade the REST framework for all BIG-IP devices (currently in the BIG-IP Device inventory) running a version prior to 12.0.0.