Manual Chapter : Logging Node Upgrade Overview with Data

Applies To:

Show Versions Show Versions

BIG-IQ Centralized Management

  • 5.2.0, 5.1.0, 5.0.0
Manual Chapter

Which upgrade workflow should I use?

There are two workflows you can follow to upgrade BIG-IQ® Centralized Management Logging Node cluster. Before you start the upgrade process, decide which workflow is appropriate for you.

  • To preserve the data collected with the current version of BIG-IQ Logging Node, use the work flow in this guide (BIG-IQ® Centralized Management: Upgrading Logging Nodes to Version 5.2 While Preserving Existing Data.
  • If you just want to upgrade, and do not care about your data, use F5® BIG-IQ® Centralized Management: Upgrading Logging Nodes to Version 5.2 Without Preserving Existing Data

How do I upgrade my Logging Node cluster to version 5.2 and preserve my existing data?

A Logging Node cluster is made up of all of your Logging Nodes, the BIG-IQ® Centralized Management device you use to manage them, and any BIG-IQ peer devices. If you use a Logging Node cluster to store and manage your alerts and events, there are additional steps in the upgrade process.

Important: Upgrading the Logging Node cluster requires taking the cluster offline. To prevent losing alerts and event log data, you must perform this process during a maintenance window.
Important: In version 5.2, the name of the device referred to in version 5.1 as a "Logging Node" is changed. As the diagram shows, after the upgrade, the device is referred to as a "Data Collection Device" or DCD.

The diagram illustrates the process workflow:

Logging Node upgrade worfklow

Note: For a successful upgrade, it is essential that you perform the tasks in the sequence detailed here. You cannot perform these tasks in parallel.

Logging Node cluster update requirements

There are a number of items that you need to have ready access to, before you can successfully complete the Logging Node cluster update. It might be helpful to use the following table to record the values so you have them at hand when needed.

Device Information needed Information Recorded
Primary BIG-IQ Centralized Management device Management IP address

admin user name and password

 
  root access password  
Secondary BIG-IQ device Management IP address  
  root access password  
Logging Nodes Management IP address  
  root access password  
Storage Machine IP-address  
  storage file path  
  Read/Write permissions for the storage file path  
  root access password  
All devices To successfully complete some of the procedures in the upgrade process, rudimentary knowledge of Linux commands is very helpful.

Logging Node preparation options

Before you start the upgrade, there are a few tasks to do. To make sure that this process goes smoothly, F5 provides a script that automates the preparation process. You can either run this script, or perform the preparation tasks yourself.

The diagram illustrates these two work flows, automated on the left: