Page tree

Skip to end of metadata
Go to start of metadata

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

Recommendation

While installing the product components, it is recommended that all the components operate in the same time zone. The Collection Agent is not a product component. The Collection Agents can operate in different time zones.

This topic contains the following information:

Related topics

Multiple-server deployment

Troubleshooting common issues

Installing Atrium SSO 9.0

Authenticating users with Atrium Single Sign-On or IT Data Analytics

Before you begin

Ensure that the following requirements are met:

  • Ensure that you have completed the tasks in Preparing for installation.
  • 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.

     Information that you need before scaling up

    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.

Performing a custom installation

Follow these steps for a custom installation. Navigate through the installation wizard by clicking Next.

1. Start the installation program

Run the setup (for Windows) or setup.bin (for Linux) file. 

2. Agree to the terms of use

 Read the license agreement and agree to the terms.

3. Select Custom Setup

Allows you to select and install one or more components on multiple servers (multiple-server deployment).

To understand the component fundamentals, see the product architecture.

4. Select the components to install

The components to install depends on your deployment plan.

For more information, see Multiple-server deployment.

5. Provide component configuration details (including Atrium Single-Sign On)

Provide details for each of the components selected in the preceding step.

Note

Configuring Atrium Single Sign-On is optional. You can choose to configure Atrium Single Sign-On while configuring the Console Server.

The following table lists the components in the sequence in which the installer screens 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
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 or a component that communicates with the Indexer, 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.

Port

Port 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 Station's Name
Name of the Collection Station as it must be displayed under the Administration > Hosts tab.
Enable Redundancy

To implement data collection redundancy, leave this selection unchanged. For more information, see Collection Station redundancy.

This selection implies that the Collection Station installed will be added to a common pool. If this Collection Station goes down, Collection Agents communicating with the Collection Station are moved to the other Collection Station in the pool.

HTTP Service 

 Read more about what purpose the HTTP channel serves

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 

 Read more about what purpose the Payload Service channel serves

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
Host

Host name of the computer where you want to install the Search component.

The default is your local host name.

Port

Port number of the computer where you want to install the Search component.

The default is 9797.

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

Console Server
 Host

Host name of the computer where you want to install the Console Server component.

The default is your local host name.

 Port

Port number of the computer where you want to install the Console Server component.

The default is 9797.

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

Atrium Single Sign-On

Enable SSO

Select this check box if you want to use Atrium Single Sign-On as an authentication mechanism.

After doing this, provide credentials for connecting with the Atrium Single Sign-On server.

Notes:

  • Configuring Atrium Single Sign-On is an optional step. If you do not want to use Atrium Single Sign-On as your authentication mechanism or if you want to install a standalone instance of IT Data Analytics, you can skip this step by leaving this setting unchanged and clicking Next.
  • If you are upgrading from an earlier version of the product, Atrium Single Sign-On configuration is not supported. However, you can manually configure the Atrium Single Sign-On server by using the enablesso CLI command CLI command.
HostFully Qualified Domain Name (FQDN) of the Atrium Single Sign-On server.
Port

Port number of the Atrium Single Sign-On server.

The default is 8443.

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

Tenant

Name of the tenant (also known as Realm in Atrium Single Sign-On) that you configured while integrating IT Data Analytics with TrueSight Presentation Server. For more information, see Integrating with TrueSight Presentation Server.

If you want to use Atrium Single Sign-On without integrating with TrueSight Presentation Server, then provide the name of the tenant that is present on Atrium Single Sign-On.

Username

User name for connecting with the Atrium Single Sign-On server.

The default Atrium Single Sign-On administrator user name is "amadmin".

Password

Password for connecting with the Atrium Single Sign-On server.

The password corresponding to the default user name is the same as what you provided while installing Atrium Single Sign-On.

6. Choose the directory location for installation

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.

7. Configure the basic settings

Configure the following settings depending on your platform.  

PlatformSetting
Windows
  • Pin the product to your Start menu. 

  • Start the product services immediately after the installation completes.  Otherwise, clear the Start BMC TrueSight IT Data Analytics Services check box if you want to configure any of the components before you start the product services  For more information, see Sizing and scalability considerations.

  • Help BMC improve the product by sharing usage information. This information can help BMC improve the product in ways that are more relevant to your needs.

    To enable the collection of usage information, keep the selection of the Allow BMC to collect product usage information check box unchanged, otherwise clear the selection. This check box is displayed while installing the Console Server.

    For more information, see Information notice on product usage.

Linux
  • Start the product services immediately after the installation completes. Otherwise, clear the Start BMC TrueSight IT Data Analytics Services check box if you want to configure any of the components before you start the product services.
    For more information, see Sizing and scalability considerations.
  • Help BMC improve the product by sharing usage information. This information can help BMC improve the product in ways that are more relevant to your needs.

    To enable the collection of usage information, keep the selection of the Allow BMC to collect product usage information check box unchanged, otherwise clear the selection. This check box is displayed while installing the Console Server.

    For more information, see Information notice on product usage.

Click Next to view the Installation Preview screen. This screen provides information about the features to be installed, the total disk size, the destination directory, and so on.


8. Click Install
Starts the installation.
9. Click View Log
This is an optional step.
10. Click Done

To exit the installation program, click Done. 

Depending on your platform, the following environment variable pointing to the product installation path is automatically set:
 

WindowsLinux
%BMC_ITDA_HOME%$BMC_ITDA_HOME

Extending 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, you need to extend the license. For more information, see Getting and applying the product license.

Where to go from here

(Optional) Verify if the installation completed successfully.

Access the product by using the Start menu.

If required, start the services manually.

Perform configurations such as enabling security for the product, configuring the email setting, and configurations required before scaling up.

Understand the various ways in which you can authenticate users.

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. For more information, see Setting up data collection.