Manual Chapter : Upgrade the Data Collection Devices in Your Cluster

Applies To:

Show Versions Show Versions

BIG-IQ Centralized Management

  • 5.3.0
Manual Chapter

Upgrading the data collection devices to version 5.3

After you prepare the data collection device (DCD) cluster for upgrade, use these procedures to upgrade the DCDs in your cluster. Perform the following tasks for each DCD in the cluster.

  1. Upload the BIG-IQ® version 5.3 software image.
  2. From the BIG-IP® device(s), take the DCD out of the alert-traffic flow.
  3. Deactivate data collection services.
  4. Upgrade the DCD to version 5.3.
  5. Confirm that the DCD is back in service
  6. Reactivate data collection services.
  7. From the BIG-IP device(s), bring the DCD back online.

What you need to do before you upgrade the data collection device from version 5.2 to 5.3

Before upgrading the F5® BIG-IQ® Centralized Management data collection device, perform these tasks.

Tasks Additional information
Re-activate the BIG-IQ system license. You must do this for each data collection device in the cluster. For specific instructions about how to reactivate a license, refer to the F5® BIG-IQ® Central Management: Licensing and Initial Setup guide.
Decide which disk volume you want to install the upgrade on. You must have at least two volumes to upgrade BIG-IQ. If the machine you are upgrading does not have two volumes, you must create one using a sequence of tmsh commands. The upgrade task provides options for either case.

Upload the BIG-IQ version 5.3 software image

Before you can upload the software image to your data collection device (DCD), you must have first downloaded it from the F5 Downloads site.

You upload the BIG-IQ® version 5.3 software image to your DCD to make it available for this upgrade.

  1. At the top of the screen, click System.
  2. On the left, expand THIS DEVICE > Software Management , then click Available Images.
    The Available Images screen lists the software image files that are available for install on this BIG-IQ.
  3. Click the Upload Image button.
  4. Click the Choose File button and go to the location to which you downloaded the image, and click the Open button to upload it to BIG-IQ.
  5. Click the Upload button.
    The screen refreshes to display the progress of the upload.
When the image is done uploading, it shows in the Available Images list.

Upgrade the data collection devices from version 5.2 to 5.3

Note: If the machine you are upgrading does not have two volumes, you must create one using a sequence of tmsh commands. The following steps provide options for either case.
Before upgrading the data collection device (DCD), you must have downloaded the BIG-IQ version 5.3 .iso image from the F5 downloads site.

The upgrade process installs the new version of the software on one DCD. You must repeat this process for each DCD in your cluster.

  1. At the top of the screen, click System.
  2. On the left, expand THIS DEVICE > Software Management , then click Available Images.
    The Available Images screen lists the software image files that are available for install on this BIG-IQ.
  3. Select the check box for the image you want to install and click Install.
  4. From the Target Volume list, select the volume you want to install the image on.
    Note: If the Target Volume list is empty, the machine you are upgrading does not have a second volume available for you to install the upgrade. You must create one to proceed.
    • If you selected a target volume, complete the remaining steps to finish the upgrade.
    • If you do not have a second volume, use the following sequence of tmsh commands to install the upgrade for this machine:
      • Use SSH to log in to the machine you want to upgrade. You must log in as root to perform this procedure.
      • Navigate to the folder where you install software using the command: cd /shared/images
      • Install the upgrade to a new volume using one of the following commands:
        • If you are upgrading a virtual machine: tmsh install sys software image <full name of the iso file> volume hd1.2 create-volume reboot
        • If you are upgrading a BIG-IQ 7000 series platform: tmsh install sys software image <full name of the iso file> volume md1.2 create-volume reboot
      • While the system installs the upgrade to the new volume, you can check on the status of the upgrade using the command: tmsh show sys soft.
      • When the upgrade finishes installing, the machine reboots. Proceed to the next to the last (login) step in this task.
  5. To prompt the data collection device to reboot into the new software installation volume, select the Reboot into Target Volume check box.
  6. Click the Install button.
    A confirmation dialog box appears.
  7. Click the Continue button.
  8. Wait while the data collection device loads the new software and reboots.
    Depending on your configuration and the number of devices you are managing, this could take up to 15 minutes. During this time, it is important that you not interrupt the installation process by restarting services or the server.
  9. Log back in to the data collection device to confirm that the upgrade succeeded.
  10. If needed, extend the /var partition.
    The default size of the /var file system in a newly installed node is 10 GB. This volume size might be insufficient to store your data. You can see how to extend this file system to a larger size in knowledge article K16103. refer to: K16103: Extending disk space on BIG-IQ Virtual Edition at support.f5.com/csp/article/K16103. Because upgrading a node requires at least two volumes, you must ensure that both volumes can have their /var file system extended to the same size, or upgrades might fail.
Important: In the unlikely event that you are unable to log in to a BIG-IQ® 7000 series platform after you upgraded it, refer to SOL40338232: The BIG-IQ system interface might be inaccessible after the BIG-IQ system is upgraded from BIG-IQ Centralized Management version to 5.2.0 at support.f5.com/kb/en-us/solutions/public/k/40/sol40338232.html for more information.