Preparing to install IT Data Analytics

Before installing TrueSight IT Data Analytics, ensure that your environment meets the installation requirements, and complete the tasks described in this section.

• Ensure that the ports that you use for installing the various components are not in use.

• TrueSight IT Data Analytics can be installed as a standalone product or can be integrated with TrueSight Presentation Server so that you can send the monitoring events from TrueSight IT Data Analytics to the TrueSight Presentation Server console. If you want to integrate TrueSight IT Data Analytics with TrueSight Presentation Server, or if you want to use Remedy Single Sign-On (Remedy SSO) as the authentication tool to manage user groups, and users, ensure that Remedy SSO is installed along with the TrueSight Presentation Server.
• If you planning to monitor event collection, do not install TrueSight TrueSight IT Data Analytics on the same computer where you have installed the Integration Service.  Installing both on the same computer stops the Infrastructure Management event collection in TrueSight IT Data Analytics. However, you can install the IT Data Analytics Collection Agent and Integration Service on the same computer if you are monitoring only the log collection and not event collection.

• Ensure that the PowerShell environment path variable is set correctly.

This topic contains the following:

• • Preparing to install on a Windows computer
  • Preparing to install on a Linux computer
  • Where to go from here

Preparing to install on a Windows computer

As a non-admin user, ensure that you have the write permissions to the directory in which you want to install the product. 
(Generally, admin users are expected to already have these permissions.)

• Write permissions to the directory in which you want to install the product.

• Write permissions to the C:\Windows directory; this is needed by the installer to create the ProductRegistry.xml file.
  
  

  Recommendation

  BMC recommends that you should not modify the location and the content of this file to avoid any upgrade issues.

• Ensure that the host name to IP address mapping is correctly set in the hosts file at C:\Windows\System32\drivers\etc\hosts.
  This is necessary to ensure that the communication between the product components works properly.

Preparing to install on a Linux computer

• TrueSight IT Data Analytics does not support installation as a root user. It is mandatory to have a non-root user access to be able to install on a Linux computer. As a non-root user, ensure that you have the write permissions to the directory in which you want to install the product.
• Ensure that as a non-root user you have the home directory on the computer where the product is to be installed. Ensure that the user's home directory contains the user profile file. This is required for the BMC_ITDA_HOME environment variable to be set in the user profile file.

• To perform the installation on a remote Linux computer, enable the X Window System and set the DISPLAY variable to launch the installer user interface. To do so, run the following command:
  
  

  DISPLAY=hostName:0.0

  export DISPLAY

  where hostName refers to the name of the computer on which you want to launch the installer.

• Modify the system configuration settings. You must do so by logging in as a root user and changing the required configurations using one of the following options:
  
  -By running a script preinstallconfig.sh located in the Utility folder
  -By manually configuring the properties in the configuration files

  
  
  By running a script preinstallconfig.sh located in the Utility folder

  To configure the minimum values by executing a script, the minimum requirement for installing the indexer component is to run the following utility as a root user:

  <INSTALLER_LOCATION>/BMC-TrueSight-IT-Data-Analytics/Disk1/utility/preinstallconfig.sh

  Though the Truesight IT Data Analytics installation or upgrade in Linux needs to be carried out as a non-root user, the utility needs to be run as a root user.
  Examples:

  sh preinstallconfig.sh MODIFY_CONFIG <NON_ROOT_ITDA_USER>

  sh preinstallconfig.sh ALL <NON_ROOT_ITDA_USER> <ITDA_INSTALL_DIR>

  In the above examples, <NON_ROOT_ITDA_USER> is the non-root username with which you want to install Truesight IT Data Analytics. After you run the script, log in again by opening a new Linux user session before launching the installer. This utility ensures that the minimum required system configurations are carried out for Truesight IT Data Analytics installation. The following table shows the possible arguments that this command can take:

  If the script finds the environment variable BMC_ITDA_HOME either from environments or from /etc/bmc.profile, then the script assumes that the current installation would be an upgrade path. The script will modify the owner of the directory set to BMC_ITDA_HOME.

  
  
  By manually configuring the properties in the configuration files

  Before manually configuring the properties, you need to give write permissions to the /opt and /opt/bmc directories, which are needed by the installer to create the ProductRegistry.xml file. The ProductRegistry.xml file maintains the registry of the BMC product installations on the host. Note that you need to create the opt/bmc directory.
  

  Recommendation

  BMC recommends that you do not modify the location or content of this file to avoid any upgrade issues.

  To change the system configurations manually, add the properties as given in the following table to the limits.conf file or the sysctl.conf file as specified.
  You must configure the values given in the table using values that have root user permissions.

  After configuring the virtual memory, execute the command to refresh with the new configuration: sysctl -p
  

  Tip

  After making the configuration changes either by running the script or manually, log in again by opening a new Linux user session and launching the installer.

  
  

Where to go from here

If you are installing the product, perform the other preinstallation tasks listed in the Preparing-to-install-the-TrueSight-Operations-Management-solution page.