Manual Chapter : Installing BIG-IP Version 17.1.1

Applies To:

Show Versions Show Versions


  • 17.1.1

BIG-IP Link Controller

  • 17.1.1

BIG-IP Analytics

  • 17.1.1


  • 17.1.1


  • 17.1.1


  • 17.1.1


  • 17.1.1


  • 17.1.1


  • 17.1.1
Manual Chapter

Installing BIG-IP Version 17.1.1

Installation overview

This document covers very basic steps for installing the software. You can find complete, step-by-step installation and upgrade instructions in BIG-IP Systems: Upgrading Software, and we strongly recommend that you reference this information to ensure successful completion of the installation process.

Installation checklist

Before you begin:
  • Use BIG-IP iHealth to verify your configuration file. For more information, see K12878: Generating diagnostic data using the qkview utility.
  • Update/reactivate your system or vCMP host license, if needed, to ensure that you have a valid service check date. For more information, see K7727: License activation may be required before a software upgrade for the BIG-IP or Enterprise Manager system.
  • Ensure that your system is running version 14.x or later.
  • Download the
    file from F5 Downloads to
    on the source for the operation. (If you need to create this directory, use the exact name
  • Configure a management port.
  • Set the console and system baud rate to
    , if it is not already.
  • Log on as an administrator using the management port of the system you want to upgrade.
  • Check all DNSSEC Key generation's 'expiration' and 'rollover' date:time fields before performing a GTM sync group upgrade. If any of the DNSSEC Key generations are set to rollover or expire during the planned upgrade window, modify the date:time of the 'expiration' and/or 'rollover' fields to extend past the anticipated upgrade window, to a date:time when all units in the sync group will again have GTM config sync enabled.
  • Boot into an installation location other than the target for the installation.
  • Save the user configuration set (UCS) in the
    directory on the source installation location, and copy the UCS file to a safe place on another device.
  • Log on to the standby unit, and only upgrade the active unit after the standby upgrade is satisfactory.
  • Turn off mirroring.
  • If you are running Policy Enforcement Manager, set provisioning to
  • If you are running Advanced Firewall Manager, set provisioning to

Installing the software

You can install the software at the command line using the Traffic Management shell,
, or in the browser-based Configuration utility using the Software Management screens, available in the System menu. Choose the installation method that best suits your environment.
Installation method
Install to existing volume, migrate source configuration to destination
tmsh install sys software image [
image name
] volume [
volume name
Install from the browser-based Configuration utility
Use the Software Management screens in a web browser.

Sample installation command

The following is an example command to install version 17.1.1 to volume 3 of the main hard drive:
tmsh install sys software image BIGIP- volume HD1.3

Post-installation tasks

After the installation finishes, you must complete the following steps before the system can pass traffic.
  1. Ensure the system rebooted to the new installation location.
  2. Use BIG-IP iHealth to verify your configuration file. For more information, see K12878: Generating diagnostic data using the qkview utility.
  3. Log on to the browser-based Configuration utility.
  4. Change the password for the root and admin account.
    All administrative users must change their passwords on first login after the user ID is created.
  5. Run the Setup utility.
  6. Provision the modules.
You can find information about running the Setup utility and provisioning the modules in
BIG-IP TMOS implementations
Creating an Active-Standby Configuration Using the Setup Utility and Creating an Active-Active Configuration Using the Setup Utility.

Installation tips and important notes

  • The upgrade process installs the software on the inactive installation location that you specify. This process usually takes between three minutes and seven minutes. During the upgrade process, you see messages posted on the screen. For example, you might see a prompt asking whether to upgrade the End User Diagnostics (EUD), depending on the version you have installed. To upgrade the EUD, type
    , otherwise, type
  • You can check the status of an active installation operation by running the command
    watch tmsh show sys software
    , which runs the
    show sys software
    command every two seconds. Pressing Ctrl + C stops the watch feature.
  • If installation fails, you can view the log file. The system stores the installation log file as
    The upgrade process does not update Tcl scripts (such as iRules) in the configuration. This might cause issues when iRule syntax changes between releases. After upgrading, you might need to modify iRules to reflect any changes in iRule syntax.