Preparing to Upgrade the Appliance

Fulfill software and hardware requirements

Ensure that you fulfill the following requirements:

• Software download access to the TIBCO eDelivery website or TIBCO Support website.

  If you do not have access, register at TIBCO Support website or contact Technical Support by email.

• Check which TIBCO LogLogic® Log Source Packages versions are compatible with LogLogic LMI. If your appliance is using an earlier version of LogLogic® LSP, you must first upgrade to one of the supported LogLogic LSP versions of the LogLogic LMI release to which you want to upgrade. See "LogLogic LMI-LogLogic LSP Upgrade Matrix" in TIBCO LogLogic® Log Management IntelligenceRelease Notes.

  The LogLogic LSP documentation is available on the TIBCO eDelivery website or TIBCO Support website after logging in.

• A null modem cable (if connecting to the appliance by using a console)

Verify disk space requirements

Verify that the appliance has sufficient disk space available for the upgrade:

1. Log in to the appliance via SSH and run the following command:

   df -h

2. In the Available column, the disk space required for the partitions must be as follows:

   Partition	Upgrade path	Disk space
   /	All	100 MB
   /loglogic	From LogLogic LMI and LogLogic EVA version 6.3.0 or 6.3.1 to 6.4.0	4 GB

3. Ensure that the maximum used space of the /loglogic directory, excluding the /loglogic/data and /loglogic/update subdirectories, is up to 9 GB. Run the following command::

   $du -sh --exclude=/loglogic/data --exclude=/loglogic/update /loglogic

Back up the appliance data

It is strongly recommended that you back up your data on the appliance before performing an upgrade.

Just after a software upgrade, you must wait at least one day to back up the appliance data, otherwise the backed up log data is inconsistent with the platform software.

For more information, see the Backup and Restore section in TIBCO LogLogic® Log Management Intelligence Administration.

Apply Hotfixes

Apply the appropriate hotfixes.

Configure parameters

• CPU and memory configuration
• Active Directory
• Data vault

JAVA_OPTS="$JAVA_OPTS -Dcom.sun.jndi.ldap.object.disableEndpointIdentification=true"

system data_vault enable_auto_unlock

Disable file system checks

Disable file system checks by performing the following steps:

1. Before starting the upgrade process, run the CLI command > system fsck disable to prevent running a file system check during upgrade.
2. After the upgrade process is complete, run the CLI command > system fsck enable to reenable the check if needed.

Download and extract the upgrade package

Log in to the TIBCO eDelivery website or TIBCO Support website and download the latest software update that you want to apply to the appliance.

1. Download the update package (in .tar format), TIB_loglmi_<version>_fileupgrade.tar

   The package contains the following files. The bz2 and bz2.sig files are required to perform the file update process.

   File name	Description
   bz2	The update file
   bz2.sig	The signature file for the upgrade file
   healthcheck.tar.gz	The health check utility tool

2. Connect to the appliance from the shell login as the toor user and the password that was created during Setting up the Appliance by Using the Console. Use the command line through the serial port with a null modem cable or by using SSH. It is recommended to use the serial port; by using SSH, the connection is lost after the final reboot but only temporarily.
3. Extract all files into the destination directory (/loglogic/update) on the appliance by running the following command:

   $ tar xf <filepath_update_package> -C /loglogic/update

4. Clean up the directories by running the following command:

   $ rm -f <filepath_update_package>

Extract and run the health check script

The health check package includes the following files:

• TIB_loglmi_<version>_healthcheck.tar.gz
• healthcheck.sh

1. Extract the health check package contents by running the following command:

   $ tar zxvf <filepath_healthcheck_package> -C /loglogic/update

   where: <filepath_healthcheck_package> is the file path. For example:

   /loglogic/update/healthcheck/healthcheck.tar.gz

2. (Only for TIBCO LogLogic® LX1025R1 Appliance) Run the following command to bypass the swap file check:

   $ touch /loglogic/update/flag_skip_for_LX1025R1

3. Run the health check script:

   $ /loglogic/update/healthcheck/healthcheck.sh

Health Check - Failure Scenarios

Scenarios when the health check script might fail and the workaround in each scenario are as follows:

/ free 100 MB check FAILED

Ignore the inconsistency?[yes/no]:

Schema consistency checking failed

use logappconfig
alter table oddsfieldtags drop FOREIGN KEY oddsfieldtags_ibfk_1;
alter table oddsfieldtags drop index msgPatternId;
alter table oddsfieldtags add index oddsfieldtags_ibfk_1(msgPatternId);
alter table oddsfieldtags add constraint oddsfieldtags_ibfk_1 FOREIGN KEY (msgPatternId) REFERENCES oddsmessagepattern(uuid) ON DELETE CASCADE;

There is report data on the system that was not converted after the last upgrade. Do you want to convert this data now? [yes/no]:

Data Vault is turned on but auto-unlock is not enabled.

system data_vault enable_auto_unlock

WARNING: Advanced Features may not perform correctly with the current memory configuration on LMI 6.2.0 and above! Do you want to continue upgrade? [yes/no]

Please turn off Advanced Features before proceeding with the upgrade.