Page tree
Skip to end of metadata
Go to start of metadata


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

 

Before you begin

  • 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.

    PropertyChange 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 %BMC_ITDA_HOME%/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_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.

    PropertyChange 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 $BMC_ITDA_HOME/conf/server folder.

  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:

    PropertyChange 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 %BMC_ITDA_HOME%/conf/server folder.

  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.