Applying the IT Data Analytics Fix Pack using the command line interface

This topic explains how to apply feature packs or fix packs on TrueSight IT Data Analytics using the command line interface.

Before you begin

• Ensure that you have performed all the tasks listed in Preparing to apply fix packs to IT Data Analytics components.
• Download the installation files for the TrueSight IT Data Analytics Fixed Pack and extract the contents of the zipped distribution file to an appropriate directory on the IT Data Analytics host computer. See the Release notes and notices page for information about specific Fix Pack installation files.
• Ensure that the IT Data Analytics Configuration Database component is up and running.

To apply Fix Pack on TrueSight IT Data Analytics running in a Windows environment 

On IT Data Analytics:

1. Download and extract the TrueSight_ITDA_11.0.00.002_windows.zip on all the computers where IT Data Analytics is installed.

2. Open the ITDA_FixPack_11.0.00.002.properties file and update the database URL, database port and database password of the ITDA server on which the Fix Pack needs to be applied.

   Property	Change to be made
   jdbc.url	Update the database host name and database port. Database host name will be localhost for a standalone deployment and the host name of the database server for a custom deployment. Note: Ensure that the host name and port are correct.
   jdbc.user	Update the database user. The default value is sa.
   jdbc.password	Update the database password. The password can be in plain text or in an encrypted format based on the value set for the property password.encrypted. The encrypted value of password can be referred from jdbc.password property set in olaengineConfig.properties file located in /opt/bmc/TrueSight/ITDA/conf/server folder.

3. Run the following batch file with administrator permissions on all the computers where IT Data Analytics is installed.
   <EXTRACT_TO_DIR>\TrueSight_ITDA_11.0.00.002_windows\ITDA_FixPack_11.0.00.002.bat 
4. A message will be displayed on the command prompt after successful application of the fix pack. The logs can be viewed in the patch-installer.log file located in the  <EXTRACT_TO_DIR>\TrueSight_ITDA_11.0.00.002_windows\logs folder.

On IT Data Analytics Agent:

1. Download and extract the TrueSight_ITDA_Agent_11.0.00.002_windows.zip on all the computers where the ITDA Agents are installed.
2. Run the following batch file with administrator permissions.
   <EXTRACT_TO_DIR>\TrueSight_ITDA_Agent_11.0.00.002_windows\ITDA_Agent_Fixpack_11.0.00.002.bat
3. A message will be displayed on the command prompt after successful application of the fixed pack. The logs can be viewed in the patch-installer.log file located in the <EXTRACT_TO_DIR>\TrueSight_ITDA_Agent_11.0.00.002_windows\logs folder.

To apply Fix Pack on TrueSight IT Data Analytics running in a Linux environment 

On IT Data Analytics:

1. Download and extract the TrueSight_ITDA_11.0.00.002_linux.tar on all the computers where IT Data Analytics is installed.
2. Extract the downloaded file to a folder <EXTRACT_TO_DIR>  using the following command;
   unzip TrueSight_ITDA_11.0.00.002_linux.tar -d <EXTRACT_TO_DIR> 
3. Provide read, write, and execute permission to all the file at location<EXTRACT_TO_ DIR> if not already given.
4. Open the ITDA_FixPack_11.0.00.002.properties file and update the database URL, Database port and database password of the ITDA server on which the Fix Pack needs to be applied.
   

   Property	Change to be made
   jdbc.url	Update the database host name and database port. Database host name will be localhost for a standalone deployment and the host name of the database server for a custom deployment. Note: Ensure that the host name and port are correct.
   jdbc.user	Update the database user. The default value is sa.
   jdbc.password	Update the database password. The password can be in plain text or in an encrypted format based on the value set for the property password.encrypted. The encrypted value of password can be referred from jdbc.password property set in olaengineConfig.properties file located in /opt/bmc/TrueSight/ITDA/conf/server folder.

5. Run the following file to apply the Fix Pack.
   <EXTRACT_TO_DIR>/ITDA_FixPack_11.0.00.002.sh
6. A message will be displayed on the command prompt after successful application of the fixed pack. The logs can be viewed in the patch-installer.log file located in the
   <EXTRACT_TO_DIR>\logs folder.

On IT Data Analytics Agent:

1. Download the TrueSight_ITDA_Agent_11.0.00.002_linux.tar on all the computers where ITDA Agents are installed.
2. Extract the downloaded file to a folder <EXTRACT_TO_DIR> using the following command:
   unzip TrueSight_ITDA_Agent_11.0.00.002_linux.tar -d <EXTRACT_TO_DIR> 
3. Provide read, write, and execute permission to all the file at location<EXTRACT_TO_ DIR> if not already given.
4. Run the following file to apply the Fix Pack.
   <EXTRACT_TO_DIR>/ITDA_Agent_Fixpack_11.0.00.002.sh
5. A message will be displayed on the command prompt after successful application of the fixed pack. The logs can be viewed in the patch-installer.log file located in the
   <EXTRACT_TO_DIR>\logs folder.

To verify the IT Data Analytics upgrade was successful

1. Clear the browser cache and open the IT Data Analytics login page.
2. Verify that the version displayed is 11.0.00.002. 
3. Log in to IT Data Analytics and navigate to Administrator>Components page. All the IT Data Analytics component versions should be updated to 11.0.00.002.
4. Verify that the ITDA Standalone Agent service is up and running.

To roll back the Fix Pack on TrueSight IT Data Analytics

On IT Data Analytics: 

1. Open <EXTRACT_TO_DIR>/ITDA_FixPack_11.0.00.002_revert.properties and update the following properties:
   
   

   Property	Change to be made for reverting
   jdbc.url	Update the database host name and database port. Database host name will be localhost for a standalone deployment and the host name of the database server for a custom deployment. Note: Ensure that the host name and port are correct.
   jdbc.user	Update the database user. The default value is sa.
   jdbc.password	Update the database password. The password can be in plain text or in an encrypted format based on the value set for the property password.encrypted. The encrypted value of password can be referred from jdbc.password property set in olaengineConfig.properties file located in /opt/bmc/TrueSight/ITDA/conf/server folder.

2. Do the following to revert the Fix Pack:
   
   • (Windows) Run  the  ITDA_FixPack_11.0.00.002_revert.bat utility located in the <EXTRACT_TO_DIR> on all the hosts where the IT Data Analytics components are installed.
   • (Linux)   Provide the read, write, and execute permission to all the file at location<EXTRACT_TO_ DIR> if not already given, and run the ITDA_FixPack_11.0.00.002_revert.sh utility located in the <EXTRACT_TO_DIR> on all the hosts where the IT Data Analytics components are installed.
3. Wait for the current execution to be completed and verify the following:
   
   • (Windows) There is no error message displayed at the command prompt. Logs are found in the patch-installer.log file located in <EXTRACT_TO_DIR>/logs folder.
   • (Linux) There is no error message displayed on the Console. Logs are found in the patch-installer.log file located in <EXTRACT_TO_DIR>/logs folder.
4. Verify that ITDA services are up and running after applying the patch and start the ITDA component service.

 On IT Data Analytics Agent:

1. Do the following:
   (Windows) Run <EXTRACT_TO_DIR>/ITDA_Agent_FixPack_11.0.00.002_revert.bat
   (Linux) Run <EXTRACT_TO_DIR>/ITDA_Agent_FixPack_11.0.00.002_revert.sh
2. Wait for the current execution to be completed and verify the following:
   
   • (Windows) There is no error message displayed at the command prompt. Logs are found in the patch-installer.log file located in <EXTRACT_TO_DIR>/logs folder.
   • (Linux) There is no error message displayed on the Console. Logs are found in the patch-installer.log file located in <EXTRACT_TO_DIR>/logs folder.
3. Verify that ITDA services are up and running after applying the patch and start the ITDA component service.

To verify the IT Data Analytics rollback was successful

1. Clear the browser cache and open the IT Data Analytics login page.
2. Verify that the version displayed is 11.0.00. 
3. Log in to IT Data Analytics and navigate to Administrator>Hosts page. 
4. Verify that the ITDA Standalone Agent version is 11.0.00.