Preparing for installation

 This topic provides information that you can use to prepare your environment for installing the product. 

Related topics

System-requirements

Planning

Recommendation for TrueSight Operations Management User

Do not install IT Data Analytics on the same computer where you have installed Integration Service. Installing both on the same computer stops the Infrastructure Management event collection in 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.

Preparing for installation on a Windows computer

Ensure that you meet the following requirements for installing the product on a Windows computer:

  • Read the Planning topic.
  • Verify that your environment meets system requirements.
  • Download and unzip the zipped product files (the installer) at your preferred location.
  • Ensure that the ports that you use for installing the various components are not in use.
  • 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.

      BMC recommends you to 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 for installation on a Linux computer

  • Read the Planning topic.
  • Verify that your environment meets system requirements.
  • Download and unzip the zipped product files (the installer) at your preferred location.
  • Ensure that the ports that you use for installing the various components are not in use.
  • IT Data Analytics does not support installation using 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.
  • Access the command-line interface and change to the directory that contains the last extracted file. For example: /opt/BMC-TrueSight-IT-Data-Analytics/Disk1.

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

System configuration settings before installing or upgrading on Linux

Before installing or upgrading on Linux, you must modify certain system configuration settings. You must do so by logging on as a root user and change the required configurations by either one of the following ways:

  • 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 with root user.

    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 with root user.

    <INSTALLER_LOCATION>/BMC-TrueSight-IT-Data-Analytics/Disk1/utility/preinstallconfig.sh
    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 on 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:

    The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.

    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 following directories:

    The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
    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 with root user permissions.

    The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
    After configuring the virtual memory, execute the following command     to refresh with the new configuration::

    sysctl -p

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

Install the product in one of the following ways:

 

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