Manual Chapter : Upgrading BIG-IQ Overview

Applies To:

Show Versions Show Versions

BIG-IQ Centralized Management

  • 7.1.0
Manual Chapter

Upgrading BIG-IQ Overview

Upgrading BIG-IQ to the latest version

What BIG-IQ setup does this upgrade process support?

This process supporting upgrading BIG-IQ version 5.4.0 and later without a data collection device (DCD) cluster to the latest version.
If your BIG-IQ is not currently running one of these versions, or includes a DCD, refer to the supported upgrade paths section in the release notes for this BIG-IQ version.

What happens during a BIG-IQ upgrade

This example represents a BIG-IQ in a high availability configuration. During the upgrade, the BIG-IQ suspends BIG-IP device management. This can result in a downtime of services. The amount of downtime depends on the size of your system's setup. BIG-IQ services resume when the active BIG-IQ is upgraded and restarted.

Tasks to complete before you start the upgrade process

Before upgrading F5 BIG-IQ Centralized Management, complete these tasks.
Additional information
Download the latest BIG-IQ software image and Pre-upgrade Check tool from the F5 Downloads site.
To ensure that the pre-upgrade script runs correctly, make sure you always download the latest version of the tool from
Prepare your statistics for the upgrade process
See Prepare statistics for upgrade. If your BIG-IQ CM is in an HA pair, ensure that this process is completed on each node.
Run the pre-upgrade check script on the primary BIG-IQ by typing the following commands:
  1. #
    cd /shared/scripts/preUpgradeChecks
  2. #
This script verifies the following for BIG-IQ:
  • Disk assessment and partition size.
  • Health checks
  • Licensing verification.
  • CPU and memory assessment.
For additional detail about this script, refer to the AskF5 article K15988343 on
Depending on the version of BIG-IQ software you are upgrading from, the connectivity requirements for your system may be different in the version you are upgrading to. Refer to the AskF5 Knowledge Center article
K15612: Connectivity requirements for the BIG-IQ system
to confirm that the ports you need are configured correctly.
Additional information on network connectivity requirements is available in the
Planning and Implementing a BIG-IQ Deployment
Deploy any staged configuration changes to your managed BIG-IP devices.
When addressing configuration conflicts for each BIG-IP device, F5 recommends you use BIG-IP to override the configuration settings stored on BIG-IQ.
Decide which disk volume you want to install the BIG-IQ software on. You must have at least two volumes to upgrade BIG-IQ.
If you don't have two volumes, you can add the second volume as part of the upgrade.
If you are currently using a self-IP address for device discovery, make a note of that IP address.
You'll need to enter that IP address when you perform setup after you upgrade and reboot the BIG-IQ system.
Upgrade all managed BIG-IP devices to version 12.1 or later.
For you to manage BIG-IP devices from BIG-IQ Centralized Management, the BIG-IP devices must be running version 12.1 or later.
Run the following command to view all daemons running on the BIG-IQ, and their status:
admin@(ip-10-1-1-4)(cfg-sync Standalone)(Active)(/Common)(tmos)# show /sys service
Make a note of the daemons running on BIG-IQ and their status. After the upgrade, verify that all daemons are running as expected.

Summary of tasks to upgrade BIG-IQ to the latest version

The upgrade process can take up to several hours depending on how many BIG-IP devices you are managing.
To upgrade F5 BIG-IQ Centralized Management, perform these procedures. Upgrading BIG-IQ to the most recent version requires that you update its configuration to incorporate new features that have been introduced. It's a good idea to set aside at least several hours to complete this process.
It is important that you follow these tasks in the order stated.
Upgrading BIG-IQ systems in a high availability configuration
  • Remove standby BIG-IQ from active BIG-IQ.
  • Upgrade the primary BIG-IQ.
  • Upload the BIG-IQ software image to the standby BIG-IQ and upgrade it.
Complete the post-upgrade process
  • Add the secondary BIG-IQ to the active BIG-IQ to re-establish the HA configuration.
  • Upgrade the BIG-IP framework on your managed devices.
  • Rediscover your BIG-IP devices, and re-import their services.
  • If you have a VMware service scaling group configured, you'll need to re-install the vCenter host root certificate on BIG-IQ.