Page tree

You can install product components on multiple servers by performing a custom installation. This type of installation is recommended for performing a large scale product deployment. For more information, see Hardware sizing recommendations.

Best practice

As a best practice, after completing the installation, create a backup super admin user that can be used in a scenario where you are unable to access the product.

This topic contains the following information:

Related topics

Before you begin

Ensure that you have completed the tasks in Preparing for installation.

Ensure that you install the product components on servers in the same time zone.

If you want to use the Collection Agent as your data collection mechanism, then ensure that you read the following topics:

If you are scaling up your deployment by adding multiple components of the product on separate servers, ensure that have the following information:

If you are scaling upWhat you need to know?
Indexer

The host name and corresponding port number of the master Indexer installed on the primary node.

Search
  • The host name and corresponding port number of the master Indexer installed on the primary node.
  • The host name and port number of the Configuration Database to be used by the Search component.
Collection Station
  • The IP address and port number to be used for binding the Collection Station's HTTP service and Payload service.
    This information is required by the Collection Agents for connecting with the Collection Station.
  • The host name and corresponding port number of the master Indexer installed on the primary node.
  • The host name and port number of the Configuration Database to be used by the Collection Station.

For more information about default ports, see Communication ports and protocols.

To perform a custom installation

  1. Start the installation program by running the setup (for Windows) or setup.bin (for Linux) file. Click Next.
  2. Read the license agreement and agree to the terms. Click Next.
  3. Select Custom Setup and click Next.  
  4. Select one or more of the components that you want to install, and then click Next.

  5. Provide details for each of the following components listed in the following table; when you are finished, click Next.

    Note

    The following table lists the components in the same sequence as the installer screens that appear if you select all the components.


    FieldDescription
    Indexer
    Host

    Host name of the computer where you want to install the Indexer. The default is your local host name.

    PortPort number of the computer where you want to install the Indexer. The default is 9300.
    For more information about the ports supported, see Communication ports and protocols.
    Primary Node in Cluster
    If you are installing an Indexer that must function as the master, leave this field blank.

    If you are installing an Indexer that must function as a peer, provide the fully qualified host name and port number of the master Indexer, installed on the primary node. This value must be in the format, hostName1:Port.

    Configuration Database
    Host

    Host name of the computer where you want to install the configuration database. The default is your local host name.

    PortPort number of the computer where you want to install the configuration database. The default is 9999.
    For more information about the ports supported, see Communication ports and protocols.
    Collection Station
    Collection Host (Agent)
    Name of the Collection Station as it must be displayed under the Administration > Hosts tab.
    HTTP Service

    This channel is used by the Collection Agent and Console Server for connecting with the Collection Station for the following purposes:

    • By the Collection Agent: To get configuration information such as from where to collect the data, frequency of collecting the data, and so on.
    • By the Console Server: To get information such as data pattern detection and preview of results during data collector creation, to send commands about starting or stopping data collection, and so on.

    Bind Address

    The HTTP service bind address that the Collection Agent and the Console Server must use to connect with the Collection Station. The default is 0.0.0.0.

    Bind Port

    The HTTP service bind port number that the Collection Agent and the Console Server must use to connect with the Collection Station. The default is 8080.

    For more information about the ports supported, see Communication ports and protocols.

    Payload Service

    This channel is used by the Collection Station for listening to incoming data collected and sent by the Collection Agent.

    Bind Address

    The Payload Service bind address that the Collection Station must use for listening to incoming data. The default is 0.0.0.0.

    Bind Port

    The Payload Service bind port number that the Collection Station must use for listening to incoming data. The default is 41414.

    For more information about the ports supported, see Communication ports and protocols.

    Search and Console Server
    Host

    Host name of the computer where you want to install the Console Server and the Search component. The default is your local host name.

    PortPort number of the computer where you want to install the Console Server and the Search component. The default is 9797.
    For more information about the ports supported, see Communication ports and protocols.
  6.  The directory location defaults to the following:
    • Windows: C:\Program Files\BMC Software\TrueSight\ITDA. 
    • Linux: /opt/bmc/TrueSight/ITDA
    You can change the destination directory by clicking Browse. Click Next to display the BMC TrueSight IT Data Analytics Settings screen.
  7. Perform the following actions depending on your platform and click Next.
    • Windows: Pin the product to your Start menu, and start the product services immediately after the installation is complete.  
    • Windows and Linux: Start the product services immediately after the installation is complete. 
    The Installation Preview screen is displayed, providing information about the features to be installed, the total disk size, the destination directory, and so on.
  8. Click Install to start the installation.
  9. (Optional) Click View Log to see the installation log.
  10. To exit the installation program, click Done.

    By default, the following environment variable pointing to the product installation path is automatically set:

    WindowsLinux
    %BMC_ITDA_HOME%$BMC_ITDA_HOME


Getting and applying the product license

When you install the product, a default license gets installed which is valid for 30 days from the date of installation. 

Tip

When the license validity is less than 90 days, a message indicating the expiry date is displayed on the logon page.

To continue using the product after 30 days

  1. Get the license by contacting BMC Support.
  2. Apply the license by copying the LicenseKey to the location where the product is installed (for example, %BMC_ITDA_HOME%). You need to overwrite the license file that already exists.
  3. Re-start the BMC TrueSight IT Data Analytics server. For more information, see Starting or stopping product services.

Where to go from here

(Optional) Verify if the installation completed successfully.

Access the product by using the Start menu.

While running the installer, if you did not have the product start services immediately, then manually start the services.

Perform configurations such as enabling security for the product, configuring the email setting, and adding Indexers to the Indexer cluster.

Start data collection immediately after installation, by making the following configurations:

  • (Optional) Create Data patterns to define how the data collected must be indexed and displayed.
  • Create data collectors to define the type of data to be collected and how it must be collected, and to start the data-collection process.

 

  • No labels