Installing the standalone Collection Agent

Before you begin

Ensure that you have completed the tasks in Preparing-for-installing-the-standalone-Collection-Agent.

To install the standalone Collection Agent

1. Locate the following standalone Collection Agent installation package by navigating to the %BMC_ITDA_HOME%\utilities\ location.The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
   This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.
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 to proceed to the next step.
   
4. Read the license agreement and agree to the terms. Click Next to proceed to the next step.
   

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
   Station 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 To be able to select HTTPS, you must have already configured a secured connection between the Collection Station and the Collection Agent. For more information, see Enabling-security-for-the-Collection-Station.
   Station Host	Host name of the Collection Station with which the Collection Agent must connect.
   Station Port	The HTTP service bind port number that the Collection Agent must use to connect with the Collection Station. Default: 8080

6. (Optional) In the Name field, provide the name of the collection profile which you want to associate with this standalone Collection Agent for creating data collectors.
   
   Note that if you want to associate a collection profile that is imported via a content pack, then you need to specify the name in the format, "<collectionProfileName> [<contentPackName>]." For example, to associate a collection profile "OracleCP" imported via the content pack "Database Pack", you need to specify, OracleCP [Database Pack].
   
   Click Add to add the collection profile details. You can add multiple collection profile names by providing the name and click Add. Click Next to proceed to the next step.
   
   After providing the collection profile details, you can choose to override the macro values existing in those collection profiles. To do this, in the Select Profile list, select the collection profile. Furthermore, in the Macro Name box, provide the name of the macro for which you want to override the value and in the Macro Value field, provide the new value. Click Add to add these details. You can continue to select additional collection profiles from the Select Profile and provide the macro name and value and click Add. Click Next to proceed to the next step.

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 to proceed to the next step.
    

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

    Note

    The same environment variables are set when you install the standalone Collection Agent and the IT Data Analytics product.

    If you install the standalone Collection Agent on the same computer where you have installed the IT Data Analytics product (but in a different location), the preceding variables are updated to point to the standalone Collection Agent instead of the IT Data Analytics product.

Post-installation task

This information is applicable only if you performed the installation without root privileges on a Linux host.

If you restart the standalone Collection Agent any time after installation, the service associated with the standalone Collection Agent does not start automatically. To enable this, you need to perform the following steps:

1. Open the command prompt and navigate to the directory, /etc/init.d.

2. Run the following command:
   

   ln -s $BMC_ITDA_AGENT_PATH/agent/services/bin/collection_agent collection_agent
3. Run the following command:
   chkconfig  --add collection_agent