Manual Chapter : Upgrade the Logging Nodes in Your Cluster

Applies To:

Show Versions Show Versions

BIG-IQ Centralized Management

  • 5.2.0, 5.1.0, 5.0.0
Manual Chapter

Upgrade the Logging Nodes to version 5.2

After you prepare the Logging Node cluster for upgrade, use these procedures to upgrade the Logging Nodes in your cluster.

What you need to do before you upgrade the Logging Node from version 5.x to 5.2

Before upgrading the F5® BIG-IQ® Centralized Management Logging Node, perform these tasks.

Tasks Additional information
Re-activate the BIG-IQ system license. You must do this on both the active and the secondary BIG-IQ if they are running in an HA pair. 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 you are running BIG-IQ Virtual Edition and you don't have two volumes, refer to: K1740617406: Using the tmsh utility to create a new software volume for installing a new image or hotfix on the BIG-IQ system at: support.f5.com/csp/article/K17406

Gather the following information.

Required information For my configuration
You'll need to create a passphrase for the Master Key. The passphrase must contain:
  • At least 16 characters
  • Contain at least 1 capital letter
  • Contain at least 1 lower case letter
  • Contain at least 1 number
  • Contain at least 1 special character
    Important: You must use the same Master Key Passphrase for each BIG-IQ system in an HA pair and every device in a Logging Node cluster. The upgrade will complete without it, but the HA pair or Logging Node cluster will not function if the pass phrases don't match.
 

Download the BIG-IQ version 5.2 software image from F5 Networks

Downloading a software image from F5 Networks is the first step to making it available to install on the Logging Node.
  1. Log in to the F5 Downloads site, downloads.f5.com.
  2. Click the Find a Download button.
  3. Click the name of the product line.
  4. Click the product name, Centralized Management.
  5. Click V5.2.0.
  6. Read the End User Software License agreement and click the I Accept button if you agree with the terms.
  7. Click the BIG-IQ version 5.2 .iso file name.
  8. Click the name of the closest geographical location to you.
    The software image downloads to your local system
The software image is now available for you to upload to the Logging Node.

Upload the BIG-IQ version 5.2 software image

Before you can upload the software image to your Logging Node, you must have first downloaded it from the F5 Downloads site.

You upload the BIG-IQ version 5.2 software image to your Logging Node to make it available for this upgrade.

  1. At the top of the screen, click System Management.
  2. At the top of the screen, click Inventory.
  3. On the left, click SOFTWARE MANAGEMENT > Available Images .
  4. Click the Upload Image button.
  5. 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.
  6. 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 Logging Node to version 5.2

The default size of the /var file system in a newly installed Logging Node is 10 GB. That may be insufficient to store logging data. Extending this file system to a larger size is explained in SOL 17406. Because upgrading a Logging Node installation requires at least two volumes, you must ensure that both volumes can have their /var file system extended to the same size, or upgrades may fail. If you are running BIG-IQ Virtual Edition and don't have two volumes, refer to: SOL17406: Using the tmsh utility to create a new software volume for installing a new image or hotfix on the BIG-IQ system at support.f5.com/kb/en-us/solutions/public/17000/400/sol17406.html

Before upgrading Logging Node, you must have downloaded the BIG-IQ version 5.2 .iso image from the F5 downloads site.

The upgrade process involves installing the new version of the software, booting into that new version, and reviewing the settings on the setup screens.

  1. Log in to the Logging Node with your admin user name and password.
  2. At the top of the screen, click System Management.
  3. At the top of the screen, click Inventory.
  4. On the left, click BIG-IQ HA.
  5. Click the name of the Logging Node.
  6. On the left, click Software Version.
  7. Click the Update button.
  8. From the Software Image list, select the image you want to install.
  9. From the Target Volume list, select the volume you want to install the image on.
  10. To prompt the Logging Node to reboot into the new software installation volume, select the Reboot into Target Volume check box.
  11. Click the Apply button.
    A popup screen opens, prompting you to confirm the installation.
  12. Click the Continue button.
  13. Wait while the Logging Node 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.
  14. Log back in to the Logging Node.
  15. 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.

After you upgrade to version 5.2

After you upgrade to BIG-IQ® version 5.2, you will notice a few differences in performance.

In BIG-IQ Logging, Logging Node, and logging configuration:

  • In version 5.2, the Logging Node is referred to as a data collection device.
  • When you configure the data collection device, you need to create a passphrase for the Master Key. You must use the same Master Key passphrase for each device in the data collection device cluster.

In Network Security:

  • Web Application Security event logs created in a previous version of BIG-IQ are not compatible with BIG-IQ version 5.2.