Upgrading IT Data Analytics in a single server environment silently

Where you are in the Upgrade process

Failed to execute the [excerpt-include] macro.

You can upgrade IT Data Analytics using one of these settings:

  • Typical: Upgrades all the components of IT Data Analytics (Collection Station, Configuration Database, Console Server, Indexer, and Search) using the default settings for the host, ports, and protocols. This is recommended for trial and small deployments.
  • Custom: Allows you to customize these settings and authenticate users using Remedy Single Single-On (Remedy SSO). 

 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.


To perform a typical upgrade silently

  1. Failed to execute the [excerpt-include] macro.
  2. Failed to execute the [excerpt-include] macro.

  3. 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/
  4. You can save the sample options file, or generate one. To generate the options file, go to Step 6.
    Open the file:

  5. Save 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.

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

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

      • (Windows) setup.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.

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

  8. 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.01 install succeeded

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

    • (Windows) %BMC_ITDA_HOME%
    • (Linux) $BMC_ITDA_HOME

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

  11. (Optional) Start using Remedy Single Sign-On as your authentication mechanism by running the enablesso CLI command. Using Remedy Single Sign-On is required if you plan to use TrueSight IT Data Analytics in conjunction with the TrueSight products For more information, see User-authentication-options.
  12. Failed to execute the [excerpt-include] macro.
  13. Failed to execute the [excerpt-include] macro.


To perform a custom upgrade silently

Do the following:

  1. Failed to execute the [excerpt-include] macro.
  2. Failed to execute the [excerpt-include] macro.
  3. 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/

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

    1. From the command prompt, run the following command to generate the options file:
      • (Windows) setup.exe –DGENERATE_OPTIONS_FILE=pathToOptionsFile
      • (Linux) As a non-root user, run setup.bin –DGENERATE_OPTIONS_FILE=pathToOptionsFile
        NotepathToOptionsFile 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.

    You can create custom options files for Indexer, Search Server Configuration Database, Search, Collection Station, and Console Server.

    BMC recommends that you keep the generated 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, ensure that you change the value of the installLocation property in the options file. 

  5. You will need to type the Remedy Single Sign-On password in an encrypted form in the options file in Step 6. Encrypt this password using the EncryptPWD utility:


    1. Open the EncryptPWD utility by navigating to:
      • (Windows) <DownloadLocation>\BMC-TrueSight-IT-Data-Analytics\Disk1\utility\EncryptPWD
      • (Linux) <DownloadLocation>/BMC-TrueSight-IT-Data-Analytics/Disk1/utility/EncryptPWD 
    2. Run the tool, and click the Encrypt tab.
    3. Type the password, confirm it, and click Encrypt.
    4. Note down the encrypted password (from the Encrypted Password field)


  6. Open and edit the options file. You can either retain the default values for the properties or change them, and save the file. The options file defines the installation properties in the form of a prefix tag followed by a property name and value pair.

    Property details

    Prefix tags for silent installation properties:

    • -P: Precedes directory properties
    • -A: Precedes application features
    • -J: Precedes Java properties
  7. 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.
  8. You can periodically check the installation status by checking the itda_install_log.txt file located at:
    • (Windows)%temp%
    • (Linux)  /tmpSearch 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.01 install succeeded
  9. The following environment variable points to the IT Data Analytics installation path after the upgrade.
    • (Windows) %BMC_ITDA_HOME%
    • (Linux) $BMC_ITDA_HOME
  10. 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.
  11. (Optional) Start using Remedy Single Sign-On as your authentication mechanism by running the enablesso CLI command. Using Remedy Single Sign-On is required if you plan to use TrueSight IT Data Analytics in conjunction with the TrueSight products For more information, see User-authentication-options.
  12. Failed to execute the [excerpt-include] macro.
  13. Failed to execute the [excerpt-include] macro.

Failed to execute the [excerpt-include] macro.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*