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.

Important: 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

   Copy

   #!/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:

   Copy

   chmod +x /config/startup_analytics_upgrade_change.sh

6. Change permissions on /config/startup file to allow modifications by typing the following command:

   Copy

    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:

   Copy

    /config/startup_analytics_upgrade_change.sh &

   Important: 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