Manual Chapter : Updating a BIG-IP VE Virtual Machine

Applies To:

Show Versions Show Versions

BIG-IP Edge Gateway

  • 11.2.1


  • 11.2.1


  • 11.2.1

BIG-IP WebAccelerator

  • 11.2.1


  • 11.2.1


  • 11.2.1


  • 11.2.1
Manual Chapter

About updates to the BIG-IP VE virtual machine

BIG-IP VE updates within the same major version are installed in the same manner as updates to BIG-IP software already installed on BIG-IP hardware. You do not need to reinstall BIG-IP VE in the hypervisor guest environment to upgrade your system. To update a BIG-IP VE virtual machine, you can use the Software Management tool in the Configuration utility, or you can upgrade the software from the command line. The update procedure described in this guide uses the Software Management tool.

Downloading and importing a BIG-IP VE update

  1. In a browser, open the F5 Downloads page (
  2. Download the version's base ISO file, such as 11.1, and its associated MD5 checksum file.
    Important: The BIG-IP VE base ISO file for the associated hotfix version must be in the /shared/images directory of the BIG-IP VE virtual machine before any updates can apply.
  3. Download the update ISO file, such as Hotfix-BIGIP-11.1.1-511.0-HF3.iso, and its associated MD5 checksum file.
    Attention: Before you perform the installation, F5 recommends testing the integrity of the ISO files to verify that you have downloaded clean copies. Use an MD5 verification program to ensure that the downloaded ISO files checksums match the values in their corresponding MD5 files.
  4. On the Main tab, expand System, and click Software Management. The Software Management screen opens.
  5. At the right-side of the screen, click Import. The Import Software Image screen opens.
  6. Click Browse to navigate to the downloaded installation file.
  7. When the image name appears in the Software Image field, click Import to begin the operation.
    Important: If you navigate away from this screen before the operation completes, the system might not import the image successfully. Therefore, F5 recommends that you wait for the operation to complete before continuing with any other work on the BIG-IP VE system.
    The system presents a progress indicator during the operation.

Installing a BIG-IP VE update

After you download the software installation image and import the software image to the /shared/images directory on the BIG-IP VE system, you can initiate the installation operation. The destination you specify for installation must represent a hard drive volume or partition on the BIG-IP system.
  1. On the Main tab of the navigation pane, expand System, and click Software Management. The Software Management screen opens.
  2. From the Available Images table, click the link representing the software image you want to install. The image properties screen opens.
  3. In the Installation Targets column, select the check box associated with the location where you want to install.
  4. Click Install. The installation confirmation screen opens.
  5. To begin the installation operation, click Install. The Installation Status screen opens.
  6. To watch the progress of the installation operation, click the Refresh button, or specify a value for the Auto Refresh setting. The upgrade process installs the software on the inactive installation location that you specify. This process usually takes between three and seven minutes.
    Tip: If there is a problem during installation, you can use log messages to troubleshoot a solution. The system stores the installation log file as /var/log/liveinstall.log.
When the installation operation is complete, the system removes the refresh options. When that occurs, you can safely reboot the newly installed volume or partition.

Rebooting after a BIG-IP VE update

When the installation operation is complete, you can safely reboot into the newly installed volume or partition.

  1. On the Main tab of the navigation pane, expand System, and click Software Management. The Software Management screen opens.
  2. On the menu bar, click Boot Locations. The Boot Locations screen opens.
  3. In the Boot Location column, click the link representing the boot location you want to activate. The properties screen for the boot location opens.
  4. Click Activate. A confirmation screen opens.
  5. Click OK to initiate the reboot operation. The system presents progress messages during the restart operation.
When the BIG-IP VE system reboot is complete, the system presents the login screen. To configure the system, log in using an account that has administrative permissions.

Upgrading BIG-IP VE from version 10.2.x to 11.1

Follow these steps as specified to upgrade from BIG-IP VE version 10.2.x to BIG-IP VE version 11.1 that is available for your hypervisor.
Note: The BIG-IP VE commands in this procedure are run using the BIG-IP command-line interface within the hypervisor.
  1. Download the base ISO files and MD5 files for versions 10.2.x and version 11.1 from the F5 Downloads page (, and verify the downloaded ISO files against their corresponding MD5 files.
    Important: If a 10.2.x hotfix is installed, the 10.2.x and hotfix ISO files can be found in /shared/images on the BIG-IP VE virtual machine, and will need to be backed up for use later. Be sure to back up the hotfix and 10.2.x ISO files from the virtual machine beforehand to avoid downloading the files again.
  2. Save a UCS file offline for the BIG-IP VE system you are upgrading.
    Important: An SCF will not suffice for this procedure.
  3. Required: Make sure to note the host name for UCS restoration. The command string tmsh list sys global-settings hostname will show you the active host name.
  4. In the Citrix®XenCenter® client, power off (shut down) the BIG-IP VE virtual machine.
  5. Take a snapshot and back up your BIG-IP VE virtual machine.
  6. Under the storage tab for BIG-IP VE, click Click here to create a DVD drive and then pick the ISO image from your ISO storage repository.
  7. Under Startup Options, configure the virtual machine to boot from the DVD drive first.
  8. Select the virtual disk in the list and click Detach. Click OK to confirm the operation.
    Important: Use Detach so that the disk is available for recovery purposes.
  9. Add a hard disk.
    1. Under the Storage tab, click Add.
    2. Name the disk, delegate a size of 100 GB, choose a location for the disk (if necessary), and click Add.
      Other sizes are not supported and unexpected problems can occur if a size other than 100 GB is used.
    At this point:
    • A CD/DVD drive has been configured to attach when powering on the BIG-IP VE 10.2.x ISO image.
    • The legacy 40 GB disk was removed.
    • A new 100 GB disk has been created.
  10. Select BIG-IP VE from the inventory screen and click the Start icon.
  11. You will be prompted for an unattended default installation. Press Enter to continue.  BIG-IP VE version 10.2.2 and later 10.x versions should proceed normally. Versions 10.2.0 and 10.2.1 will return the message: No configuration provided for hardware type Z100. For these versions, use the command diskinit --style volumes to format the volume and then use the command image2disk --nosaveconfig --instslot HD1.1 to install the image. This will prepare the disk and automatically install the 10.2.x system onto boot volume HD1.1.
  12. When the installation is complete for version 10.2.2 and later, the system prompt shows this message: Remove media, then press [Enter] to reboot. Press Enter to reboot the machine. For versions 10.2.0 and 10.2.1, type reboot and press Enter.
  13. Boot into the 10.2.x BIG-IP VE system.
  14. Log in to the console and run config to configure the management port's IP address.
  15. Copy the 10.2.x and 11.1 ISO files to /shared/images.
  16. If a hotfix was installed, copy the hotfix ISO file to /shared/images and then perform a live installation of the hotfix onto the system's HD1.2. When finished, reboot into the hotfix image before restoring the UCS.
  17. Copy the UCS to /var/local/ucs/ on the BIG-IP VE.
  18. Run the command tmsh modify sys global-settings hostname, where is the previously collected host name.
  19. Restore the UCS. For example, if the UCS is named webfarm1.ucs and is stored in /var/local/ucs, then the restoration command is tmsh load sys ucs webfarm1. At this point, the system is active with the 10.2.x configuration restored.
  20. Perform a live installation of BIG-IP VE 11.1 on the system.
  21. When the live installation is complete, halt and power off the BIG-IP VE virtual machine.
  22. Within the hypervisor, open the guest settings for the BIG-IP VE.
  23. Adjust the memory reservation from 2 GB to 4 GB to match the memory configuration.
    Important: BIG-IP VE version 11.1 includes new high-availability features. You should consider adding another network interface at this point in order to avoid a reboot at a later time.
  24. Power on the BIG-IP VE virtual machine. Your BIG-IP VE virtual machine will boot into version 11.1.