Applying feature packs or fix packs on IT Data Analytics silently

To apply feature packs or fix packs on IT Data Analytics silently

The silent upgrade obtains the required user inputs from the options file. You can download a sample options file from within the upgrade procedure below, or you can generate one.

  1. 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
  1. Extract the downloaded files (the installer) to a temporary location outside the following location to avoid any file sharing conflicts.

    • (WindowsC:\Program Files
    • (Linux) /opt
  1. It is strongly recommended that you exit all programs before starting the installation.

  2. From the command prompt, navigate to the Disk1 folder:

    • (Windows) <DownloadLocation>\BMC-TrueSight-IT-Data-Analytics\Disk1\
    • (Linux) <DownloadLocation>/BMC-TrueSight-IT-Data-Analytics/Disk1/
  3. You can download the sample options file, or generate one. To generate the options file, go to Step 6.
    Download the file:

  4. Copy the sample options file to the following folder:

    • (Windows) C:\Program Files\BMC Software\TrueSight\ITDA
    • (Linux) /opt/bmc/TrueSight/ITDA

    To install the product in a different location, change the value of the installLocation property in the options file.

  5. Run the following command to generate the options file:

    1. From the command prompt, run the following command to generate the options file:

      • (Windowssetup.exe –DGENERATE_OPTIONS_FILE=pathToOptionsFile

      • (Linux) As a non-root user, run setup.bin –DGENERATE_OPTIONS_FILE=pathToOptionsFile

        Note

        pathToOptionsFile must contain the name of the options file. If the file name or path includes a space, enclose the path and name in double quotes.


      Examples:

      • (Windows - path with space) setup.exe –DGENERATE_OPTIONS_FILE="C:\temp folder\Disk1\options File.txt"

      • (Linux - path with space) setup.bin –DGENERATE_OPTIONS_FILE="opt/temp folder/Disk1/options File.txt"

    2. This command launches the TrueSight IT Data Analytics installation wizard. You must complete the wizard-based installation once, to populate the options file with properties. Your options file is then ready to be used in silent installation.
  6. Run the following command to start the silent installation. Type the complete path to the options file in the command. If the path includes a blank space, enclose the path within double quotes.

    • (Windows) setup.exe -silent -DOPTIONS_FILE="<path_to_itda_silent_options_file>"

    • (Linux) ./setup.bin -silent -DOPTIONS_FILE="<path_to_itda_silent_options_file>"

    The installation may take up to 10 minutes. After the installation is complete, the Installation Summary page is displayed.

  7. You can periodically check the installation status by checking the itda_install_log.txt file located at: 

    • (Windows)%temp%
    • (Linux /tmp

      Search for the following log message in the itda_install_log.txt file to ensure that  TrueSight IT Data Analytics  is installed successfully:

      BMC TrueSight IT Data Analytics 11.3.xx install succeeded

  8. The following environment variable points to the IT Data Analytics installation path after the upgrade. 

    • (Windows) %BMC_ITDA_HOME%

    • (Linux) $BMC_ITDA_HOME

  9. Run the following command to verify the TrueSight IT Data Analytics status:

    • (Windows) Navigate to the TrueSight\ITDA\bin directory, and run run.bat -status command.
    • (Linux) Navigate to the TrueSight/ITDA/bin directory, and run ./run.sh -status command.

    A list of IT Data Analytics services are displayed as shown in the following example:

    TrueSight IT Data Analytics Indexer:
    The requested service has already been started.
    TrueSight IT Data Analytics ConfigDB:
    The requested service has already been started.
    TrueSight IT Data Analytics Server:
    The requested service has already been started.
    TrueSight IT Data Analytics Collection Station:
    The requested service has already been started.
  10. Restore the backed up keystore file (bmcitda.jks), and restart the IT Data Analytics server after upgrading.

    Note: The bmcitda.jks keystore file is backed up before upgrading to ensure that the custom certificates are not lost after upgrading.


  11. Apply the IT Data Analytics 11.3.02.000.001 hotfix.

    The TrueSight IT Data Analytics 11.3.02.000.001 hotfix ensures that the TrueSight IT Data Analytics licence key is decoded and read correctly. Without the hotfix, the Console server fails to start.

    Do the following:

    1. Ensure that:
      • You apply the hotfix using the same user account that you used for installing TrueSight IT Data Analytics 11.3.01.
      • You apply the TrueSight IT Data Analytics hotfix for version 11.3.02 on the computer where the BMC TrueSight IT Data Analytics Server service is running.
      • You set the BMC_ITDA_HOME environment variable.
    2. Download the file attached here Open link (ftp://ftp.bmc.com/pub/ITDA_patches), and extract the file to a temporary directory. The following file is available:
      • (Windows) ITDA_HotFix_11.3.02.000.001.zip
      • (Linux) ITDA_HotFix_11.3.02.000.001.tar
    3. Unzip the extracted file:

      • (Windows)
        Unzip the ITDA_HotFix_11.3.02.000.001.zip file.
        The contents of the files are extracted into the ITDA_HotFix_11.3.02.000.001 directory.

      • (Linux)
        Run the following command:

        tar -xvf ITDA_HotFix_11.3.02.000.001.tar

    4. In a custom environment, in the ITDA_HotFix_11.3.02.properties file, change localhost to the FQDN of the computer where the BMC TrueSight IT Data Analytics ConfigDB service is running. 
    5. Run the following command:

      (Windows)

      ITDA_HotFix_11.3.02.bat

      (Linux)

      ITDA_HotFix_11.3.02.sh

      Note: Reverting the hotfix

      If required, you can revert the hotfix. Do the following:

      1. In a custom environment, in the ITDA_HotFix_11.3.02_revert.properties file, change localhost to the FQDN of the computer where the BMC TrueSight IT Data Analytics ConfigDB service is running.
      2. Run the following command:

        (Windows)

        ITDA_HotFix_11.3.02_revert.bat

        (Linux)

        ITDA_HotFix_11.3.02_revert.sh

Troubleshooting a failed upgrade

If you face any upgrade-related issues, consider rolling back to an earlier version before you try upgrading again. For more information, Rolling back a failed upgrade.

Where to go from here

Now that you have installed the feature pack or fix pack on the TrueSight Operations Management solution, see the Release notes and notices to learn about the product enhancements and fixes.

Was this page helpful? Yes No Submitting... Thank you

Comments