Preparing to upgrade IT Data Analytics

Before upgrading TrueSight IT Data Analytics, ensure that your environment meets the installation requirements, and complete the tasks described in this section.

This topic contains the following:

TrueSight IT Data Analytics can be installed as a standalone product or can be integrated with TrueSight Presentation Server so that you can send the monitoring events from TrueSight IT Data Analytics to the TrueSight Presentation Server console. If you want to integrate TrueSight IT Data Analytics with TrueSight Presentation Server, or if you want to use Remedy Single Sign-On (Remedy SSO) as the authentication tool to manage user groups and users, ensure that Remedy SSO is installed with the TrueSight Presentation Server.

Complete the pre-installation tasks

Ensure that the target computer meets the system requirements for TrueSight IT Data Analytics.
Review the Known and corrected issues section for any installation-related issues.
Ensure that the PowerShell environment path variable is set correctly.

Complete the additional tasks for Windows

Ensure that you have the following privileges as a non-admin user,
- Write permissions to the directory in which you want to install the product. Admin users are expected to have these permissions.
- Write permissions to the C:\Windows directory; this is needed by the installer to create the ProductRegistry.xml file.
  Recommendation
  
  To avoid any upgrade issues it is recommended that you do not modify the location and the content of this file.
Ensure that the host name to IP address mapping is correctly set in the hosts file at C:\Windows\System32\drivers\etc\hosts. This is necessary to ensure that the communication between the product components works properly.

Complete the additional tasks for Linux

Ensure that you have a non-root user created. You can install TrueSight IT Data Analytics only as a non-root user.
Non-root user permissions. To be able to perform the installation, a non-root user needs the following permissions:
- Execute permission for the /Disk1/setup.bin file.
- Read, write, and execute permissions for the IT Data Analytics installation directory.
- Read and write permissions for the /opt/bmc directory.
  
  The ProductRegistry.xml file is created in the /opt/bmc directory. It maintains the registry of the BMC product installations on the host. Therefore, the /opt/bmc directory requires read and write permissions. If the bmc directory does not exist, create it with read and write permissions.
  BMC recommends that you do not modify the location or content of this file to avoid any upgrade issues.
Ensure that the non-root user who installs the product has the home directory and it contains the user profile file on the host computer where TrueSight IT Data Analyticsis to be installed. This is required for setting the BMC_ITDA_HOME environment variable in the user profile file.
If you are installing the TrueSight IT Data Analyticson a remote Linux computer, enable the X Window System and set the DISPLAY variable to launch the installer user interface.
DISPLAY=hostName:0.0
export DISPLAY
where hostName is the name of the computer on which you want to launch the installer.
BMC recommends that you use MobaXterm as the UI to install TrueSight Infrastructure Management on Linux computers.

Configure the environment

As a root user, you can change the configurations either manually or by running the preinstallconfig.sh script.

Ensure that the minimum system configurations required are met by doing one of the following:

Configure the properties by running the script

On the host computer, navigate to the <INSTALLER_LOCATION>/BMC-TrueSight-IT-Data-Analytics/Disk1/utility/ folder, and run the preinstallconfig.sh script:
sh preinstallconfig.sh MODIFY_CONFIG <NON_ROOT_ITDA_USER>
sh preinstallconfig.sh ALL <NON_ROOT_ITDA_USER> <ITDA_INSTALL_DIR>
<NON_ROOT_ITDA_USER> is the non-root username with which you want to install TrueSight IT Data Analytics.
Important
- The TrueSight IT Data Analytics installation or upgrade on Linux must to be run as a non-root user.
- The preinstallconfig.sh script must be run as a root user.
After you run the script, open a new Linux user session, and log in as a non-root user before launching the TrueSight IT Data Analytics installer.
This utility ensures that the minimum required system configurations are carried out for TrueSight IT Data Analytics installation.

The following table lists the possible arguments that this script can accept:

Possible script arguments What the script does

/bin/bash preinstallconfig.sh ALL <NON_ROOT_ITDA_USER> <ITDA_INSTALL_DIR> Modifies the owner of the TrueSight IT Data Analytics with the specified owner.
Note: If TrueSight IT Data Analytics is not installed on the Linux environment, the <ITDA_INSTALL_DIR> parameter is used for creating the directories, and a new owner is set to this location.

/bin/bash preinstallconfig.sh MODIFY_CONFIG <NON_ROOT_ITDA_USER>

Updates the system configuration files (if required).
Allows write permission to the system directories and files for the new TrueSight IT Data Analytics owner.

Note: If TrueSight IT Data Analytics is already installed with a non-root user, then executing the script MODIFY_CONFIG will be sufficient.

/bin/bash preinstallconfig.sh ALL <NON_ROOT_ITDA_USER> <ITDA_INSTALL_DIR>

Modifies the owner of TrueSight IT Data Analytics with the specified owner.
Updates the system configuration files (if required).
Allows write permission to the system directories and files for the new TrueSight IT Data Analytics owner.

Note: If TrueSight IT Data Analytics is not installed on the Linux environment, the <ITDA_INSTALL_DIR> parameter is used for creating the directories, and a new owner is set to this location.

Note

If the script finds the BMC_ITDA_HOME environment variable either from environments or from /etc/bmc.profile, then it assumes that the current installation is an upgrade path. The script modifies the owner of the directory that is set to BMC_ITDA_HOME.

Configure the properties manually
1. As a root user, add the properties as listed in the System configuration settings table to the limits.conf file and the sysctl.conf file.
2. After configuring the virtual memory, run the following command to refresh the configuration changes:
  sysctl -p
3. After you run the script, open a new Linux user session, and log in as a non-root user before launching the TrueSight IT Data Analytics installer.

System configuration settings

File name	Property	Description
/etc/security/limits.conf	<NON_ROOT_ITDA_USER> soft nofile 65536 <NON_ROOT_ITDA_USER> `hard nofile 65536`	The number of open files must be at least 65536.
	<NON_ROOT_ITDA_USER> `soft nproc 4096` <NON_ROOT_ITDA_USER> `hard nproc 4096`	The number of open processes must be at least 4096.
	<NON_ROOT_ITDA_USER> soft memlock unlimited <NON_ROOT_ITDA_USER> hard memlock unlimited	The memory lock must be set to unlimited.
	<NON_ROOT_ITDA_USER>`soft as unlimited` <NON_ROOT_ITDA_USER> `hard as unlimited`	The maximum virtual memory must be unlimited. To configure the value for non-root user, some operating systems require that root user should also have unlimited maximum virtual memory. In such instances, add the following lines: root soft as unlimited root hard as unlimited
/etc/sysctl.conf	`vm.max_map_count=262144`	The maximum number of memory map areas a process can have.The virtual memory property `max_map_count` must be configured to at least 262144.

Complete the additional tasks if you are upgrading from IT Data Analytics 2.7

Re-indexing is required when upgrading from IT Data Analytics 2.7 to TrueSight IT Data Analytics 11.3.01. The data that was indexed earlier is not compatible with TrueSight IT Data Analytics 11.3.01. The earlier data has to be processed for a successful upgrade. You must upgrade to at least 2.7 version in a phased manner to be able to upgrade to TrueSight IT Data Analytics 11.3.01.

If you are upgrading from TrueSight IT Data Analytics 2.7.00 and if you have indexes that were created in 2.1 or earlier versions, you are prompted to run a utility before the upgrade.

Indexes created in TrueSight IT Data Analytics 2.1 or earlier versions cannot be directly upgraded to TrueSight IT Data Analytics 11.3.01. You must use the IndexerDataMigrationTool to migrate these indexes. If no such indexes are found, you can directly proceed with the upgrade.

To migrate the indexes before upgrading

TrueSight IT Data Analytics does not automatically back up indexed data. BMC recommends you to create a backup of the indexed data at an appropriate location.
Ensure that the Collection Stations in your environment are stopped and the Indexers in your environment are up and running. For more information, see Starting or stopping product services
Create a back up of the indexed data at an appropriate location. For more information, see Backing up and Backing up and restoring data .

Log in to the host computer on which you want to upgrade IT Data Analytics, and delete all the files from the temporary directory:
- (Windows) %temp%
- (Linux) /tmp
Extract the downloaded files (the installer) to a temporary location outside the following location to avoid any file sharing conflicts.
- (Windows) C:\Program Files
- (Linux) /opt
Navigate to the utility folder:
- (Windows): <INSTALLER_DIRECTORY>\BMC-TrueSight-IT-Data-Analytics\Disk1\utility\IndexUpgradeUtility.zip
- (Linux): <INSTALLER_DIRECTORY>\BMC-TrueSight-IT-Data-Analytics\Disk1\utility\IndexUpgradeUtility.tar

3. Extract the IndexUpgradeUtility utility files.

4. Run the IndexerDataMigrationTool migration utility:

- (Windows): IndexerDataMigrationTool.bat
- (Linux): IndexerDataMigrationTool.sh
  
  The re-indexing progress is displayed. After the re-indexing is complete, you can proceed with the upgrade.

Where to go from here

If you are upgrading the product, perform the other pre-upgrade tasks listed in the Preparing to upgrade TrueSight Operations Management solution page.