Installing the standalone Collection Agent

Before you start using the product, you need to decide the Agent type that you want to use for the data collection. For more information, see Agent types.

If you decide to use the standalone Collection Agent for your data collection purposes, you need to install the standalone Collection Agent on each of the target hosts from which you want to collect data.

BMC recommends you to not install the standalone Collection Agent on the computer where the product is already installed. To collect data from the computer where all the components of the product are installed, you must use the Collection Station. If the Collection Station is not able to handle the current load, then you need to consider scaling the Collection Station. For more information, see Multiple-server deployment.

Before you begin

Read the Planning topic.

Verify that the target host on which you want to install the standalone Collection Agent meets the system requirements.

Ensure that you have installed the product. For more information, see Installing.

Ensure that the ports used for connecting with the Collection Station are not in use. For more information, see Communication ports and protocols.

If you want to use a secured connection between the standalone Collection Agent and the Collection Station, ensure that you have already followed the steps described at Enabling security for the Collection Station.

To install the standalone Collection Agent

1. Locate the following standalone Collection Agent installation package by navigating to the %BMC_ITDA_HOME%\utilities\ location:

   Windows	Linux
   TrueSight_ITDA_Agent_Rel_1.1_30.windows	TrueSight_ITDA_Agent_Rel_1.1_30.linux.tar

2. Copy the standalone Collection Agent installation package to the target host and unzip it.
3. Navigate to the setup (for Windows) or setup.bin (for Linux) file and run the file to start the installation program. Click Next.
4. Read the license agreement and agree to the terms. Click Next.  
    

5. Provide the following details:

   Field	Description
   Agent Name	Name to identify the Collection Agent. By default, the value displays the target host name prefixed with collection-agent_. For example, collection-agent_Host1.bmc.com. The same name is displayed in the Collection Host list while creating a data collector. Therefore, BMC recommends you to not change the prefix so that the Collection Agent is easily identifiable from the Collection Host list.
   Collection Station Details
   HTTP Service Protocol	Select one of the following options depending on whether you want to use a secured connection between the Collection Station and the Collection Agent. HTTP  HTTPS
   Collection Station Host	Host name of the Collection Station with which the Collection Agent must connect.
   HTTP Service Port	The HTTP service bind port number that the Collection Agent must use to connect with the Collection Station. Default: 8080
   Payload Service Port	The Payload Service bind port number that the Collection Station must use for listening to incoming data. Default: 41414

6. Click Add to add the Collection Station details.
   

   If you want this Collection Agent to connect with multiple Collection Stations, continue adding details as described in the preceding step and click Add. Click Next.
   If you want to remove the Collection Station details already added, select the Collection Station instance in the list of added Collection Stations and click Remove. 
   

7. The directory location defaults 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.
8. If you want to start the Collection Agent immediately after the installation completes, keep the check box selection for starting the standalone Collection Agent service unchanged. Click Next.
   If you clear the check box selection, ensure that you manually start the standalone Collection Agent service later. For more information, see Starting or stopping product services.
   
9. Click Install to start the installation. 
10. (Optional) Click View Log to see the installation log.

11. To exit the installation program, click Done.
    By default, the following environment variable pointing to the standalone Collection Agent installation path is automatically set:

    
    

    Windows	Linux
    %BMC_ITDA_HOME%	$BMC_ITDA_HOME