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

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:

    Possible script argumentsWhat the script does
    /bin/bash preinstallconfig.sh ALL <NON_ROOT_ITDA_USER> <ITDA_INSTALL_DIR>

    -Modifies the owner of TrueSight IT Data Analytics with the specified owner.

    -Updates the system configuration files if required.

    -Allows write permission to the system directories and files for the new TrueSight IT Data Analytics owner.

    NOTE:-If TrueSight IT Data Analytics is not installed in the Linux environment, the parameter <ITDA_INSTALL_DIR> would be used for creating the directories and a new owner is set for this location.

    /bin/bash preinstallconfig.sh MODIFY_OWNER <NON_ROOT_ITDA_USER> <ITDA_INSTALL_DIR>

    -Modifies the owner of TrueSight IT Data Analytics with the specified owner.

    NOTE: If TrueSight IT Data Analytics is not installed in the Linux environment, the parameter <ITDA_INSTALL_DIR> would be used for creating the directories and a new owner would be set for this location.

    /bin/bash preinstallconfig.sh MODIFY_CONFIG <NON_ROOT_ITDA_USER>

    -Updates the system configuration files if required.

    -Allows write permission to the system directories and files for the new TrueSight IT Data Analytics owner.

    NOTE: If TrueSight IT Data Analytics is already installed with a non-root user, then executing the script MODIFY_CONFIG will be sufficient.

    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.

    FilenamePropertyDescription

    /etc/security/limits.conf





    <NON_ROOT_ITDA_USER> soft nofile 65536
    <NON_ROOT_ITDA_USER> hard nofile 65536
    The number of open files must be atleast 65536.
    <NON_ROOT_ITDA_USER> soft nproc 4096
    <NON_ROOT_ITDA_USER> hard nproc 4096
    The number of open processes must be at least 4096.
    <NON_ROOT_ITDA_USER> soft memlock unlimited
    <NON_ROOT_ITDA_USER> hard memlock unlimited
    The memory lock should be set to unlimited.
    <NON_ROOT_ITDA_USER> soft as unlimited
    <NON_ROOT_ITDA_USER> hard as unlimited

    The maximum virtual memory should be unlimited.

    To configure the value for non-root user, some operating systems require that root user should also have unlimited maximum virtual memory. In such instances, add the following lines:

    root soft as unlimited
    root hard as unlimited
    /etc/sysctl.confvm.max_map_count=262144The maximum number of memory map areas a process can have.The virtual memory property max_map_count must be configured to at least 262144.


    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. 

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

Comments