Installing TrueSight IT Data Analytics in a multiple server environment silently

Where you are in the Installation process

You can install IT Data Analytics in a multiple server environment, silently, by doing a custom installation. The silent installation obtains the required user inputs from the options files. You can download sample options files from within the procedure below, or you can generate them.

To perform a custom installation using the silently

Do the following:

  1. Log in to the host computer on which you want to install IT Data Analytics. BMC recommends that you delete all the files from the temporary directory:
    • (Windows) %temp%
    • (Linux) /tmp
  2. Extract the downloaded files to a temporary location outside the following location to avoid any file sharing conflicts:
    • (Windows) C:\Program Files
    • (Linux) /opt
    It is strongly recommended that you exit all programs before starting the installation.
  3. Open the command prompt and navigate to:
    • (Windows) Windows\Disk1
    • (Linux) Linux/Disk1

  4. Download the following sample options files depending on the component that you want to install and your environment, or generate one. To generate the file, go to Step 6.

  5. Copy the sample options file to the following folder on every computer where you want to install the components:

    • (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:
    • (Windows) setup.exe –DGENERATE_OPTIONS_FILE=pathToOptionsFile
    • (Linux) As a non-root user, run setup.bin –DGENERATE_OPTIONS_FILE=pathToOptionsFile
    Where, pathToOptionsFile is the path, including the name of the file, to which you want to copy the silent installation properties. If the file name or path includes a space, enclose the file path 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"
    The command launches the TrueSight IT Data Analytics wizard-based installer. Select the component that you want to install and for which you want the options file. Complete the installation once to populate the options file with properties. Now, your options file is 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. 
  7. You will need to type the Remedy Single Sign-On password in an encrypted form in the options file in Step 8. 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)
  1. 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
  2. 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.
  3. You can periodically check the installation status by checking the itda_install_log.txt file located at:
    • (Windows)%temp%
    • (Linux)  /tmp
  4. 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.
  5. Verify that the following environment variable points to the installation path:
    • (Windows) %BMC_ITDA_HOME%
    • (Linux) $BMC_ITDA_HOME
  6. 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.
  7. If errors occur when you run  the status command, stop IT Data Analytics services and then start them again.
    Click here for instructions
    Stop IT Data Analytics services by running the following command:
    • (Windows)stop.bat
    • (Linux) stop.sh
    Start IT Data Analytics services by running the following command:
    • (Windows) run.bat
    • (Linux)run.sh
  8. Open a supported browser and access TrueSight IT Data Analytics using the following address:http(s)://<itda_servername_FQDN>:<tomcat_port>
  9. Log in using the default Admin credentials:User name: adminPassword: admin12345
  10. Change the password for the Admin user. Click Admin > Change Password.
  11. Log out of the IT Data Analytics console, and log in with the new Admin credentials.Your installation is complete.
  12. Apply the product license. When you install the product, a default license gets installed which is valid for 30 days from the date of installation. To continue using the product after 30 days, get the license by contacting BMC Support.
    To apply the license on Microsoft Windows system
    a. Copy the LicenseKey file to the location %BMC_ITDA_HOME%.
      • You must replace the LicenseKey file that already exists.
    b. Restart the IT Data Analytics server.
     
    To apply the license on Linux system
    a. Copy the LicenseKey file to the location $BMC_ITDA_HOME.
      • You must replace the LicenseKey file that already exists. Ensure that you apply the license key with non-root user permissions.
    b. Restart the IT Data Analytics server.

Troubleshooting installation issues

If you face issues during installation, see Troubleshooting the IT Data Analytics.

Next step in the Installation process

Now that you have successfully installed IT Data Analytics, you must complete the post-installation activities.