Manual Chapter :
Upgrading BIG-IQ with a Data Collection Device Cluster
Applies To:
Show VersionsBIG-IQ Centralized Management
- 8.0.0
Upgrading BIG-IQ with a Data Collection Device Cluster
Upgrade the active BIG-IQ and Data Collection Device
Cluster
Before upgrading the primary BIG-IQ system and data collection device (DCD) cluster, you
must have completed the upgrade preparation.
You upgrade BIG-IQ and the devices in your DCD cluster to the latest version from the
primary BIG-IQ system.
Depending on your system
setup, the update process can take several hours. During this time system services,
including data collection, will become temporarily unavailable. It is important that you
not interrupt the installation process by restarting services or the
server.
- Log in to the primary BIG-IQ system.
- At the top of the screen, clickDevices.
- On the left, clickbutton.
- On the left, clickUpgrade.A popup screen notifies you that you are about to upgrade this BIG-IQ system and all of the devices in the associated DCD cluster. ClickContinueto proceed.
- For the Upgrade Process, make sureRegular Upgradeis selected.TheRolling Upgrade(minimal downtime) option is not available to BIG-IQ systems running version 7.1.x or earlier.
- From theSoftware Imagelist, select the image you want to install.
- Decide which cluster members you want to back up as part of this upgrade.
- To back up the BIG-IQ device, selectBack up the BIG-IQ system before upgrade.
- To back up the DCD devices in your cluster, selectBack up the Data Collection Device cluster before upgrade.
- By default,Snapshot the Data Collection Device cluster before upgradeis selected. F5 recommends to de-select this option, as it is not required for backing up data.During the upgrade process, the system automatically creates a new partition to store the data until it can be integrated following the device update. Creating a snapshot is optional and will add time to the upgrade process.If you would like to save a snapshot externally, the system needs a remote storage location. For more information, refer toDefine external storage snapshots locationin thePlanning a Centralized Management and Visibility Deploymentguide onsupport.askf5.com.
- Under Devices, for each listed BIG-IP device and DCD, specify theTarget Volumelist, select the volume you want to install the image on for each device in the cluster.You can either choose an existing (inactive) volume, or create a new volume. If theTarget Volumelist 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.
- To install to an existing volume, selectTarget Volume, then clickSelect, and select the volume for the upgrade.
- To install to a new volume, selectNew Volume, and type the new volume name.
- Click theInstallbutton.This action begins the device upgrade process. During this time, it is important that you not interrupt the installation process by restarting services or the server.A confirmation dialog box opens. Wait while the DCD cluster upgrade process completes. Depending on your configuration and the number of devices you are managing, this could take approximately 45-60 minutes per device. When the BIG-IQ primary device upgrades, it becomes briefly inaccessible (time varies depending on your system). When you can log in to the BIG-IQ again, the device upgrade process is complete.In the event that the system is unavailable for longer than 60 minutes, or the upgrade fails, generate a qkview and report the issue atsupport.f5.com.
- Log in to BIG-IQ when the primary device upgrade is complete and system displays the log in screen.The device upgrade is complete, but post-upgrade processes can take several hours to complete, depending on your system setup.
- 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.
Even though you can log in to this BIG-IQ system after the software
is installed, the system continues the post-upgrade process, which includes re-indexing
in the background. The time required for re-indexing varies, depending on the size of
your system configuration. If you perform any searches on objects and historical
statistics data during 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 BIG-IQ software image to the standby
BIG-IQ
Before you can
upload the software image to the standby BIG-IQ, you
must have first downloaded it from the F5 Downloads
site.
You upload the BIG-IQ version
software image to the standby BIG-IQ system to
make it available for this upgrade.
- On the left, click.
- ClickUpload Imagebutton.
- ClickChoose Filebutton navigate to the downloaded image files, and click theOpen.
- ClickUploadbutton.The screen refreshes to display the progress of the upload.
Upgrade the standby BIG-IQ
Before you can upgrade the standby BIG-IQ system,
you must have uploaded the software to it.
The
active BIG-IQ is upgraded automatically, directly after the devices in the DCD cluster are
finished upgrading, but you have to manually upgrade the standby BIG-IQ system.
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 standby
BIG-IQ system. This command removes all stored data. If you run this command from the
active BIG-IQ system, you'll permanently lose all of your saved data.
- Log in to the standby BIG-IQ system's command line asrootand 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 will synchronize its database with this BIG-IQ system and repopulate the database.
- Log in to the system that you are going to establish as the standby BIG-IQ system's user interface.
- At the top of the screen, clickDevices.
- On the left click.
- ClickUpgrade.
- For the Software Image, select the image you want to install.
- From theTarget Volumelist, select the volume you want to install the image on.You can either choose an existing (inactive) volume, or create a new volume. If theTarget Volumelist 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.
- To install to an existing volume, selectTarget Volumeand select the volume for the upgrade.
- To install to a new volume, selectNew Volume, and type the new volume name.
- To back up the BIG-IQ device, selectBackup the BIG-IQ System before upgrade.
- ClickInstallat the bottom of the screen.
Wait while the BIG-IQ standby device upgrade
process completes. During this time, it is important that you not interrupt the
installation process by restarting services or the server. When the BIG-IQ upgrades, it
becomes inaccessible briefly. When you can log in to the BIG-IQ again, the process is
complete.