Page tree

This topic provides the instructions for 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.

    WindowsLinux

    TrueSight_ITDA_Agent_REL_2.1_8.windows.zip

    TrueSight_ITDA_Agent_REL_2.1_8.linux.tar.gz

  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:

    FieldDescription
    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 ProtocolSelect 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 PortThe 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 and 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:

    WindowsLinux
    %BMC_ITDA_HOME%$BMC_ITDA_HOME

Post-installation task

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

If you restart the standalone Collection Agent anytime 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

2 Comments

  1.  

    1.