Manual Chapter : Completing Post-Upgrade Processes

Applies To:

Show Versions Show Versions

BIG-IQ Centralized Management

  • 5.4.0
Manual Chapter

Complete post upgrade processing

After you upgrade the DCDs and primary BIG-IQ® in your cluster, you need to complete the post-upgrade processing. This is an automated process.
Note: Perform this task on the DCD cluster's primary BIG-IQ system.
  1. At the top of the screen, click System.
  2. At the top of the screen, click System, and then, on the left, click BIG-IQ DATA COLLECTION and select BIG-IQ Data Collection Devices.
    The first time you access this screen after performing an upgrade, it triggers a dialog box that prompts you to start the post upgrade processing tasks.
  3. Click Continue.
    The system restores your cluster to the pre-upgrade state. This includes restoring the data snapshot. Because it is restoring this snapshot for the first time (on your upgraded device), if you have a substantial amount of data, this process takes an extended amount of time.
Once your cluster is back online, you need to upgrade the secondary device and rediscover your devices to complete the upgrade.

Reestablish the HA configuration after upgrading to BIG-IQ version 5.4

After you upgrade both F5® BIG-IQ® Centralized Management systems in a HA configuration, you can re-associate the secondary system with the primary BIG-IQ system.
  1. Log in to primary BIG-IQ system with your administrator user name and password.
  2. At the top of the screen, click System.
  3. On the left, click BIG-IQ HA.
  4. Click the Add Secondary button.
  5. In the IP Address field, type the discovery address you specified on the BIG-IQ system during setup.
    This is the same IP address the peers in a high availability confirmation use to communicate.
  6. In the User name and Password fields, type the administrative user name and password for the system.
  7. In the Root Password field, type the root password for the system.
  8. Click the Add button to add this device to this high availability configuration.

Even though you can log in to the secondary BIG-IQ after the you reestablish 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.

Next, you should verify that both BIG-IQ systems have the same configuration.

Upgrade the statistics agent

If you collected statistics in the prior version, then when you finish upgrading the primary BIG-IQ, you need to upgrade the statistics agent on each BIG-IP device that had statistics enabled before the upgrade.

Note: Perform this task on the primary BIG-IQ that manages the DCD cluster.
  1. At the top of the screen, click Devices.
  2. Select all of the BIG-IP devices managed by this DCD cluster by selecting the check box next to Status.
  3. Click More, and then select Upgrade Stats Agent.
    The Statistics Collection Agent Upgrade screen opens.
  4. For Modules/Services, select the check box next to the services that you collected statistics for in the previous version.
  5. For Frequency select how often you want the DCD to collect statistics for these services.
  6. Click the Continue button.
  7. Wait while the stats collection agent for each BIG-IP device is upgraded.
    Depending on the number of devices in your cluster, this could take several minutes to complete.
    When the agent is upgraded on each BIG-IP device, the status icon turns to green.

Recheck data collection device health

You can use the Summary Status screen to review the overall health and status of the data collection devices you've configured. You can use the data displayed on this screen both before and after an upgrade to verify that your data collection device cluster configuration is as you expect.
  1. At the top of the screen, click System, and then, on the left, click BIG-IQ DATA COLLECTION and select BIG-IQ Data Collection Cluster.
    • Under Summary, you can view information detailing how much data is stored, as well as how the data is stored.
    • Under Configuration, you can access the screens that control DCD cluster performance.
  2. Note the status icon color for the cluster. If it is not green yet, wait until it turns to green before proceeding. When the icon turns green it indicates that the primary BIG-IQ DCD cluster is functioning again.
  3. Analyze the data collection device cluster details listed in the Summary area, and make sure that the values after upgrade match the values from the health check you did before the upgrade. At a minimum, you should confirm that the Data Node Count value is correct.

Upgrade the BIG-IP framework

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 the latest version, 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.

  1. At the top of the screen, click Devices.
  2. Select the check box next to a device, click the More button, and select Upgrade Framework.
    A popup screen opens.
  3. Into the fields, type the required credentials, and click the Continue button.
    A REST Framework upgrade in progress message displays.
After the framework is updated, you can successfully manage this device.
Repeat these steps for each device.

Re-discover devices and re-import services

After you upgrade F5® BIG-IQ Centralized Management, you must rediscover your managed devices and reimport their services for AFM, ASM, DNS, and LTM so you can start managing those devices with the new features introduced in this release.
  1. At the top of the screen, click Devices.
  2. Select the check box next to the devices you want to rediscover and reimport services for.
  3. Click the More button and select Re-discover and Re-import.
  4. In the Name and Description fields, type a name and an optional description to identify this task.
  5. For the Conflict Resolution Policy setting, select an option for how you want to handle any differences found between the configuration on BIG-IQ and the BIG-IP device during the re-discover and re-import task.
    • Use BIG-IQ to use the configuration setting stored on BIG-IQ if any differences are found.
    • Use BIG-IP to override the configuration settings stored on BIG-IQ with the settings from the BIG-IP device.

    Some new features are introduced with each BIG-IQ release so it's a good idea to use the BIG-IP device's configuration after you upgrade BIG-IQ. This ensures you don't inadvertently overwrite a configuration that wasn't previously supported. BIG-IP devices are re-imported in the order listed, from top to bottom. You can use the arrow keys to change the processing order.

    When you select Use BIG-IP to resolve conflicts, the BIG-IP device used to resolve those conflicts should appear last in the re-import list. If two or more BIG-IP devices contain the same object with different values, only the value in the last imported BIG-IP is used to resolve the conflict for all the BIG-IP devices.

  6. If you want to save a snapshot of the BIG-IP device's configuration before importing their services, select the Create a snapshot of the current configuration before importing check box.
  7. Click the Create button at the bottom of the screen.