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_2.7.00.001_windows.zip on all the computers where IT Data Analytics is installed.

2. Open the ITDA_FixPack_2.7.00.001.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.

   The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
   This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.
   

3. Run the following batch file with administrator permissions on all the computers where IT Data Analytics is installed.
   <EXTRACT_TO_DIR>\TrueSight_ITDA_2.7.00.001_windows\ITDA_FixPack_2.7.00.001\ITDA_FixPack_2.7.00.001.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_2.7.00.001_windows\ITDA_FixPack_2.7.00.001\logs folder.

On IT Data Analytics Agent:

1. Download and extract the TrueSight_ITDA_Agent_2.7.00.001_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_2.7.00.001_windows\ITDA_Agent_Fixpack_2.7.00.001.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_2.7.00.001_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_2.7.00.001_linux.tar.gz 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;
   tar -xvf TrueSight_ITDA_2.7.00.001_linux.tar.gz
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_2.7.00.001.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.

   The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
   This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.
   

5. Run the following file to apply the Fix Pack.
   <EXTRACT_TO_DIR>/ITDA_FixPack_2.7.00.001/ITDA_FixPack_2.7.00.001.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>/ITDA_FixPack_2.7.00.001/logs folder.

On IT Data Analytics Agent:

1. Download the TrueSight_ITDA_Agent_2.7.00.001_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:
   tar -xvf TrueSight_ITDA_Agent_2.7.00.001_linux.tar.gz 
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_2.7.00.001/ITDA_Agent_Fixpack_2.7.00.001.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>/ITDA_Agent_FixPack_2.7.00.001/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 2.7.00.001. 
3. Log in to IT Data Analytics and navigate to Administrator>Components page. All the IT Data Analytics component versions should be updated to 2.7.00.001.
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_2.7.00.001/ITDA_FixPack_2.7.00.001_revert.properties and update the following properties:
   
   

   The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
   This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.
   

2. Do the following to revert the Fix Pack:
   
   • (Windows) Run  the  ITDA_FixPack_2.7.00.001_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_2.7.00.001_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>\TrueSight_ITDA_2.7.00.001_windows\ITDA_FixPack_2.7.00.001\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>/ITDA_FixPack_2.7.00.001/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>/TrueSight_ITDA_Agent_FixPack_2.7.00.001/ITDA_Agent_FixPack_2.7.00.001_revert.bat
   (Linux) Run <EXTRACT_TO_DIR>/ITDA_Agent_FixPack_2.7.00.001/ITDA_Agent_FixPack_2.7.00.001_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>\TrueSight_ITDA_2.7.00.001_windows\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>/TrueSight_ITDA_2.7.00.001_windows/logs folder.
3. Verify that ITDA services are up and running after applying the patch and start the ITDA component service.

TrueSight_ITDA_2.7.00.001_windows

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 2.7.00.
3. Log in to IT Data Analytics and navigate to Administrator>Hosts page. 
4. Verify that the ITDA Standalone Agent version is 2.7.00.