Manual Chapter : BIG-IP Software Upgrades

Applies To:

Show Versions Show Versions

BIG-IQ Centralized Management

  • 5.0.0
Manual Chapter

How do I manage software for BIG-IP devices?

A key feature of BIG-IQ® is the ability to manage software images for multiple remote devices from one location. You can deploy software without having to log in to each individual BIG-IP® device.

There are three steps to managing software images for devices:

  1. Download the software image from F5 Networks.
  2. Upload the software image to BIG-IQ.
  3. Install the software image on a device in the BIG-IP Device inventory in one of the following two ways:
    • Managed Device Upgrade - use this process for installing a software image on managed BIG-IP devices running version 11.5.0 or later.
    • Legacy Device Upgrade - use this process for installing a software image on BIG-IP devices running versions 10.2.4 to 11.4.1.
Note: Before you can manage a legacy device running versions 10.2.0 - 11.4.1, you must upgrade the device to version 11.5.0 or later.

Downloading a software image from F5 Networks

Downloading a software image from F5 Networks is the first step to making it available to install on a managed device.

  1. Log in to the F5 Downloads site, https://downloads.f5.com, and click the Find a Download button.
  2. Click the name of the product line.
  3. Click the version of the product you want to download.
  4. Read the End User License Agreement, and click the I Accept button if you agree with the terms.
  5. Click the name of the file you want to download.
  6. Click the name of the closest geographical location to you.
    The screen refreshes to display the progress of your download.
After you download the software image, you can upload it to BIG-IQ®.

Uploading a software image to BIG-IQ

Before you can upload a software image to BIG-IQ®, you must download it from the https://downloads.f5.com site.

You upload a software image to make it available to deploy to managed BIG-IP® devices.

Important: To make sure the software image successfully uploads, don't log out of BIG-IQ or close the browser window until the software image name appears in the Software Image list.
  1. Log in to the BIG-IQ® system with your user name and password.
  2. At the top left of the screen, select Device Management from the BIG-IQ menu.
  3. At the top of the screen, click Operations.
  4. On the left, click SOFTWARE MANAGEMENT > Available Images .
  5. Click the Upload Image button.
  6. Click the Choose File button and navigate to the location to which you downloaded the image, and click the Open button to upload it to BIG-IQ.
  7. Click the Upload button.
    The screen refreshes to display the progress of the upload.
When BIG-IQ uploads the software, it verifies the image. This verification process can take several minutes. When BIG-IQ is finished uploading and verifying the image, the software image displays as Verified and is available for installation on a device.

Installing a software image onto a managed device

Before you can install a software image onto a device, you must download it from the F5 Downloads site, https://downloads.f5.com, and upload it to the BIG-IQ® system. To apply a hotfix, you must have the base software image (as well as the hotfix) uploaded to, and verified by, BIG-IQ.

Note: You can deploy software images only to BIG-IP® devices running version 11.5.0 or later. Refer to the Upgrading a legacy device section for specific instructions about upgrading devices running version 10.2.0 - 11.4.1.

Install software images to your managed devices so the versions are up to date, and in sync. This helps you manage your network traffic more efficiently. When you install software images from BIG-IQ, you have the option to stage the software installation for deploying later, as well as the option to have the installation paused after the software image is copied to the device and before the device reboots. While the software installs on the BIG-IP devices, you can continue doing other tasks on the BIG-IQ system.

Tip: Install a software image during a maintenance window when you are not directing traffic to the target BIG-IP device.
  1. Log in to the BIG-IQ® system with your user name and password.
  2. At the top left of the screen, select Device Management from the BIG-IQ menu.
  3. At the top of the screen, click Operations.
  4. On the left, click SOFTWARE MANAGEMENT > Available Images .
  5. Select the check box next to the software image you want to install and then click the Managed Device Install button at the top of the screen.
  6. In the Name field, type a name to identify this installation.
  7. For the Options setting, you can select any of the following:
    • If you want to copy the image to the device, but wait until later install it, select the check box next to :

      Pause after the software image is copied has been copied to devices.

    • If you want to wait to reboot the image to the new volume so you can verify the software installation, select the check box next to:

      Pause for reboot confirmation.

  8. Click the Add/Remove Devices button to select devices to install this software on.
  9. From the Available list, select the devices you want to upgrade and click -> to move it to the Selected list.
  10. When you're done adding devices to the Selected list, click the Apply button.
  11. To set the location for where BIG-IQ installs this software image, select Target Volume.
  12. To assign a new location to install the software image, select New Volume and type the volume and partition you want it installed.
  13. If you want to set the target volume for all the BIG-IP devices you are upgrading, click the Set Default Volume button and select an option:
    • Install at the next available volume to install the software there.
    • Volume Name and type a new volume install the software there.
  14. Click the Run button to start the installation immediately, or click the Save button to save this job for deploying at a later time.
The software installation deployment and its status display in the Software Installations list.

If you selected an option save the deployment or to pause the process at certain points, click the name of the software installation on the Software Installation list, and click the Continue button when you're ready to continue the software installation.

How do I upgrade the BIG-IP REST framework so I can manage it from BIG-IQ?

To properly communicate, BIG-IQ® and BIG-IP® devices must be running compatible versions of the REST framework. If the REST 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. If you upgraded BIG-IQ from version 4.6.0 to version 5.0, you must also upgrade the REST framework for all BIG-IP devices (not running version 12.0.0) currently in the BIG-IP Device inventory.

  1. Log in to the BIG-IQ® system with your user name and password.
  2. At the top left of the screen, select Device Management from the BIG-IQ menu.
  3. At the top of the screen, click Inventory.
  4. Hover over the yellow triangle to display a message to confirm that the reason it is yellow is because the REST framework for the device needs an update.
  5. Select the check box next to the device you want to upgrade the framework for.
  6. Click the More button, and select Upgrade Framework.
    A popup screen opens.
  7. Into the fields, type the required credentials, and click the Continue button.
    A REST Framework upgrade in progress message displays.
After the REST framework is updated, you can successfully manage this device.

Upgrading a legacy device (version 10.2.0 - 11.4.1)

Before you can upgrade a device, you must first download the software image from the F5 Downloads site, https://downloads.f5.com to the BIG-IQ® system. You need the root user name and password for the device to upgrade it.

A BIG-IP® device running versions 10.2.0 - 11.4.1 is considered a legacy device. You must upgrade a legacy device to version 11.5.0 or later before you can add it to the BIG-IP Device Inventory and start managing it from BIG-IQ.

If you were managing a device running versions 10.2.0 - 11.4.1 from a previous version of BIG-IQ, and upgraded to version 5.0, the device displays as impaired with a yellow triangle next to it in the BIG-IP Devices Inventory. To manage the legacy device, you must upgrade it to 11.5.0 or later.

  1. Log in to the BIG-IQ® system with your user name and password.
  2. At the top left of the screen, select Device Management from the BIG-IQ menu.
  3. At the top of the screen, click Operations.
  4. On the left, click SOFTWARE MANAGEMENT > Software Images .
  5. In the Software Images list, select the check box next to the image you want to install and click Legacy Device Install button at the top of the screen
  6. In the Device IP Address field, type the IP address for the legacy device that you want to upgrade.
  7. In the Admin User Name and Admin Password fields, type the administrator's user name and password for this device.
  8. In the Root User Name and Root Password fields, type the user name and password for the root user for this device.
  9. Click the Upgrade button to start the upgrade.
When the upgrade to version 11.5.0 or later is complete, you can discover the device from BIG-IQ.