Manual Chapter :
Prepare statistics for upgrade
Applies To:
Show VersionsBIG-IQ Centralized Management
- 7.1.0
Prepare statistics for upgrade
Before you begin the upgrade process, use the
following steps to prevent statistics migration errors. This procedure is done to ensure
that all statistics stored on your pre-upgrade version are properly migrated over the
course of the upgrade. To do so, you must modify the active and standby machines of the
BIG-IQ CM. If you do not complete this task, there is a possibility that your statistics
will not be migrated to your upgraded version.
You must complete this entire process for both the active and
standby machines of BIG-IQ CM.
- Log into the BIG-IQ command line
- Use a text editor to create the following customized startup script in the file/config/startup_analytics_upgrade_change.sh.
- Add the following lines to the file#!/bin/bash es_client_file="/var/config/appiq/upgrade/es_client.py" upgrade_analytics_data_5_6_file="/var/config/appiq/upgrade/upgrade_analytics_data_5_6.py" appiq_version=`grep -P -o "Version: [\w.]+" /VERSION|cut -d ':' -s -f2|tr -d '[:space:]'` appiq_product=`grep -P -o "Product: [\w.-]+" /VERSION|cut -d ':' -s -f2|tr -d '[:space:]'` timeout_perl_cmd="perl -p -i -e 's/(timeout=)14400/\${1}144000/g'" reindex_tries_cmd="perl -p -i -e 's/(\s+.*reindex\(.*tries = )10(.*)/\${1}1\${2}/g'" reindex_no_delete_tries_cmd="perl -p -i -e 's/(\s+.*reindex_no_delete\(.*tries = )10(.*)/\${1}1\${2}/g'" function log() { ###log error messages### [ ! "$1" ] && return 0 /bin/echo -e "[$(/bin/date +%m/%d/%y\ %H:%M:%S.%2N)] - $1" >> /var/log/upgrade_analytics_data.log } if [ $appiq_product != "BIG-IQ" ]; then log "not \"BIG-IQ\" product, (found: $appiq_product)! exiting..." exit 99 fi if [ $appiq_version != "7.1.0" ]; then log "not \"7.1.0\" version, (found: $appiq_version)! exiting..." exit 99 fi log "Modifying \"$es_client_file\" file" if [ -f $es_client_file ]; then $(eval "$timeout_perl_cmd $es_client_file") $(eval "$reindex_tries_cmd $es_client_file") $(eval "$reindex_no_delete_tries_cmd $es_client_file") log "\"$es_client_file\" file has been modified!" else log "file \"$es_client_file\" doesn't exist...skipping parsing!" fi log "Modifying \"$upgrade_analytics_data_5_6_file\" file" if [ -f $upgrade_analytics_data_5_6_file ]; then $(eval "$timeout_perl_cmd $upgrade_analytics_data_5_6_file") log "\"$upgrade_analytics_data_5_6_file\" file has been modified!" else log "file \"$upgrade_analytics_data_5_6_file\" doesn't exist...skipping parsing!" fi
- Save your changes to/config/startup_analytics_upgrade_change.shand exit the text editor
- Enable executable mode for the/config/startup_analytics_upgrade_change.shfile, and type the following command:chmod +x /config/startup_analytics_upgrade_change.sh
- Change permissions on/config/startupfile to allow modifications by typing the following command:chmod +w /config/startup
- Using a text editor, edit the/config/startupfile, and append the following line to the end of the file:/config/startup_analytics_upgrade_change.sh &The ampersand symbol (&) at the end of the line is required.
- Save changes to/config/startupand exit the text editor.
Once you have completed your pre-upgrade task
list, you can proceed to the upgrade process. Depending on the volume of statistics in
your pre-upgrade system, the migration process to your upgraded system can vary from one
hour to four days.
Following the upgrade to version 7.1, you can verify the
statistics migration by checking the log file
/var/log/upgrade_analytics_data.log
of the active BIG-IQ
CM. The end of the log should include the
text:REINDEX statistics completed successfully