Manual Chapter :
Upgrading BIG-IQ from
Version
5.2 or 5.3
Applies To:
Show VersionsBIG-IQ Centralized Management
- 6.0.1
Upgrading BIG-IQ from
Version
5.2 or 5.3
Remove the secondary
BIG-IQ system from the HA pair
If the F5 BIG-IQ Centralized Management system is
configured in an HA pair, you must remove the secondary BIG-IQ system before you upgrade
the primary BIG-IQ.
- At the top of the screen, clickSystem.
- On the left, clickBIG-IQ HA.
- ClickRemove Secondary.A dialog box opens, prompting you to confirm that you want to remove the HA secondary device from this group.
- ClickRemoveto confirm that you want to take the HA secondary device out of the group.The system logs you out of the BIG-IQ while it removes the secondary device.
- Log back in to the primary BIG-IQ.For a while, both the primary and the secondary BIG-IQ devices continue to display. After a few minutes, the screen updates to display a single standalone device.
Upgrade primary
BIG-IQ to the latest version
If the machine you are upgrading does not have two volumes, you must create one using the command line interface. The following steps provide options for either case.
- Prepare the DCD cluster for upgrade. SeePrepare for Data Collection Device Upgradeonsupport.f5.com.
- Update the DCDs in the cluster.
- Download the latest BIG-IQ version software image from the F5 downloads site.
You upgrade the BIG-IQ primary to take advantage of the newest
functionality and features.
- Log in to the primary BIG-IQ system with your admin user name and password.
- At the top of the screen, clickSystem.
- On the left, expand, then clickAvailable Images.The Available Images screen lists the software image files that are available for install on this BIG-IQ.
- Select the check box for the image you want to install and clickInstall.
- From theTarget Volumelist, select the volume you want to install the image on.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 procedure to install the upgrade for this machine:
- Use SSH to log in to the machine you want to upgrade. You must log in asrootto 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 software status.
- When the upgrade finishes installing, the machine reboots. Proceed to the next to the last (login) step in this task.
- To prompt BIG-IQ to reboot into the new software installation volume, select theReboot into Target Volumecheck box.
- Click theInstallbutton.
- Click theContinuebutton.
- Wait while BIG-IQ loads the new software and reboots.Depending on your configuration and the number of devices you are managing, this could take up to an hour. During this time, it is important that you not interrupt the installation process by restarting services or the server.
- Confirm that the upgrade completed successfully.
- At the top of the screen, clickSystem.
- On the left click.
- Under Last Upgrade, click the name of the just completed upgrade to open the properties screen.
- On the properties screen for the upgrade, under General Properties, note theStatus. If there is a green icon and the wordsSuccessfully completed the upgradeappear, then the upgrade is complete and successful.
- If needed, extend the/varpartition.The default size of the/varfile system in a newly installed or upgraded node is 30 GB. This amount of available storage might not be enough to store your data. If you previously extended your disk space, you'll need to do it again after you upgrade. For information about how to do that, refer to: K16103: Extending disk space on BIG-IQ Virtual Edition And remember, upgrading a node requires at least two volumes, so be sure you can extend the/varfile system on both volumes to the same size, or upgrades might fail.
Even though you can log in to this BIG-IQ system after the software is installed, the system
continues some database re-indexing processes in the background. The time required re-indexing
varies, depending on the size of your system configuration. If you perform any searches on
objects before it's done re-indexing, BIG-IQ might not return the expected results. During
this time, you can continue with the rest of the upgrade process.
During the period of re-indexing, do not restart the BIG-IQ system
until you confirm a successful upgrade.
Upload the latest
version of the software image to the version 5.2 or 5.3 secondary BIG-IQ
Before you can upload the software image to the secondary BIG-IQ system, you must have
first downloaded it from the F5 Downloads site.
You upload the BIG-IQ version software image to the secondary
BIG-IQ system to make it available for this upgrade.
- At the top of the screen, clickSystem.
- On the left, click.
- Click theUpload Imagebutton.
- Click theChoose Filebutton and go to the location to which you downloaded the image, and click theOpenbutton to upload it to BIG-IQ.
- Click theUploadbutton.The screen refreshes to display the progress of the upload.
When the image is done uploading, it
shows in the Available Images list.
Upgrade secondary
BIG-IQ to the latest version
If the machine you are upgrading does not have two volumes, you must create one using the command line interface. The following steps provide options for either case.
You install the latest version of the BIG-IQ software on the peer BIG-IQ system so it will be
running the same version as the primary BIG-IQ system you are upgrading. After you upgrade the
secondary BIG-IQ, you can re-establish their connection and synchronize their configuration
for high availability.
Use the following command only in very specific
circumstances, such as this one, since it clears the majority of a BIG-IQ system's
configuration. Before you run the command, be sure you are on the secondary BIG-IQ system.
This command removes all stored data. If you run this command from the primary BIG-IQ
system, you'll permanently lose all of your saved data.
- Log in asrootto the system you are going to establish as the secondary BIG-IQ system's command line and type the following command:/usr/bin/clear-rest-storage.While this step is not required, it clears the database storage on the system so the upgrade goes more quickly. After you upgrade both peer systems and re-establish the HA pair, the peer BIG-IQ synchronizes its database with this BIG-IQ system, and repopulates the database.
- Log in to the system you are going to establish as the secondary BIG-IQ system's user interface.
- At the top of the screen, clickSystem.
- On the left, clickSoftware Management.
- If you're upgrading from BIG-IQ version 5.4.0 or 6.0.0, clickINSTALLATIONbutton, and then click theUpgradebutton.
- If you're upgrading from BIG-IQ version 5.2.0 or 5.3.0, clickAvailable Images, select the image, and click theInstallbutton.
- Select theBack up the BIG-IQ system before upgradecheck box.
- From theTarget Volumelist, select the volume you want to install the image on.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 procedure to install the upgrade for this machine:
- Use SSH to log in to the machine you want to upgrade. You must log in asrootto 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 software status.
- When the upgrade finishes installing, the machine reboots. Proceed to the next to the last (login) step in this task.
- To prompt BIG-IQ to reboot into the new software installation volume, select theReboot into Target Volumecheck box.
- Click theInstallbutton.
- Click theContinuebutton.
- Wait while BIG-IQ loads the new software and reboots.Depending on your configuration and the number of devices you are managing, this could take up to an hour. During this time, it is important that you not interrupt the installation process by restarting services or the server.
- Log in to the BIG-IQ that will be the secondary BIG-IQ system to confirm that the upgrade succeeded and complete the setup wizard.To complete the setup task, you must supply a master key pass phrase that all devices in the DCD cluster must share. Make note of the phrase you use. Each logging node, as well as the primary and secondary BIG-IQ systems must use this phrase before they can join the cluster.
- If needed, extend the/varpartition.The default size of the/varfile system in a newly installed or upgraded node is 30 GB. This amount of available storage might not be enough to store your data. If you previously extended your disk space, you'll need to do it again after you upgrade. For information about how to do that, refer to: K16103: Extending disk space on BIG-IQ Virtual Edition And remember, upgrading a node requires at least two volumes, so be sure you can extend the/varfile system on both volumes to the same size, or upgrades might fail.