Manual Chapter : Prepare statistics for upgrade

Applies To:

Show Versions Show Versions

BIG-IQ Centralized Management

  • 7.1.0
Manual Chapter

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.
  1. Log into the BIG-IQ command line
  2. Use a text editor to create the following customized startup script in the file
    /config/startup_analytics_upgrade_change.sh
    .
  3. 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
  4. Save your changes to
    /config/startup_analytics_upgrade_change.sh
    and exit the text editor
  5. Enable executable mode for the
    /config/startup_analytics_upgrade_change.sh
    file, and type the following command:
    chmod +x /config/startup_analytics_upgrade_change.sh
  6. Change permissions on
    /config/startup
    file to allow modifications by typing the following command:
    chmod +w /config/startup
  7. Using a text editor, edit the
    /config/startup
    file, 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.
  8. Save changes to
    /config/startup
    and 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