Installing the standalone Collection Agent silently

This topic provides instructions for performing a silent installation of the standalone Collection Agent:

Related topics

Multiple-server deployment Open link

Using a Collection Agent for remote data collection Open link

Installing the product

Installing the product silently Open link

Standalone Agent and Standalone Collection Agent

All references to the Standalone Agent or Standalone Collection Agent in this document is applicable only if you are using IT Data Analytics version 11.3.01. The latest version released for a Standalone Agent is 11.3.01. Starting from version 11.3.02, no more versions will be released for the Standalone Agent. However, you can make a note of the following information:

  • You can continue to use Standalone Agent version 11.3.01 with IT Data Analytics version 11.3.02.
  • If you have created Data Collectors using a Standalone Agent in version 11.3.01, the data collection will continue to work with IT Data Analytics version 11.3.02.
  • You can also edit the Data Collectors to use PATROL Agent instead of a Standalone Agent in IT Data Analytics version 11.3.02.

Before you begin

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

Manually generate an options file with silent installation properties or make appropriate changes in the sample options file provided.

Using the sample options file for running the silent installation

Depending on your platform, you can use one of the following sample options files to perform the silent installation.

To be able to use the sample options file, you might need to first edit it and change certain property values. For example, you might need to change the value of the Collection Station host name before using the file directly. For more information about the properties, see Silent installation properties.

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

WindowsLinux

TrueSight_ITDA_Agent_11.3.01_windows.zip

TrueSight_ITDA_Agent_11.3.01_linux.tar.gz

Copy the standalone Collection Agent installation package to the target host and unzip it. 

Generating an options file with silent installation properties

Use the following steps to generate a custom file with the appropriate silent installation properties:

  1. Navigate to Start > Run > CMD and depending on your platform run the following command:
    • Windows: setup.exe –DGENERATE_OPTIONS_FILE=pathToOptionsFile
    • Linux: setup.bin –DGENERATE_OPTIONS_FILE=pathToOptionsFile
      In the preceding command syntax, pathToOptionsFile refers to the path including the name of the file into which you want to copy the silent installation properties.

      Note

      If the file name or path includes a space, then enclose the file path in double quotes.

  2. Specify the required components (properties) for the silent installation and generate the file. 
    For more information, see Silent installation properties.

Installing the standalone Collection Agent silently

  1. Log on to the computer on which you want to perform the silent installation.
  2. Run the following command, as appropriate:
    • Windows: setup.exe -silent -DOPTIONS_FILE=pathToOptionsFile
    • Linux: setup.bin -silent -DOPTIONS_FILE=pathToOptionsFile
      In the preceding command syntax, pathToOptionsFile refers to the path including the name of the file into which you want to copy the silent installation properties. If the file name or path includes a space, then enclose the file path in double quotes.

      Note

      On the Windows platform, after the installation completes, press Enter to return to the command prompt.

Silent installation properties

This section provides information about property values listed in the silent installation options file. The options file is a text file that defines the type of installation, the components to install, the installation location, and the configuration settings for the components. The installation properties are in the form of a prefix tag followed by a property name and value pair.

Prefix tags

The following table lists the prefix tags that precede the installation properties.

Prefix tags for silent installation properties

Property flagDescription

-J

Precedes Java properties

-P

Precedes directory properties

-A

Precedes application features

Installation properties

The following table lists the installation properties that succeed the prefix tags.

Installation properties

Property nameDescription
Installation

-P installLocation

Specifies the full path to the installation directory.

Default value:

  • Windows: C:\Program Files\BMC Software\TrueSight\ITDA
  • Linux: /opt/bmc/TrueSight/ITDA
Example: -P installLocation=C:\Program Files\BMC Software\TrueSight\ITDA
Collection Agent name
-J agent.name

Indicates the name of the Collection Agent.

Set the value to the name by which you want to identify the Collection Agent.

Example: -J agent.name=collection-agent1.bmc.com

Collection Station details
-J station.host

Indicates the host name of that Collection Station with which the Collection Agent must communicate in the process of data collection.

Example: -J station.host=StationHost1.bmc.com

-J station.port

Indicates the port number of that Collection Station with which the Collection Agent must communicate in the process of data collection.

Example: -J station.Port=8080

-J stationprotocol

Indicates the protocol to be used between the Collection Station and the Collection Agent.

Se the value to 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

Example: -J stationprotocol=HTTP

Collection profile details
-J collection.profile.name

Indicates the collection profiles that you want to associate with the standalone Collection Agent for creating data collectors.

Set the value to a comma-separated list of collection profile names.

Example: -J collection.profile.name=profile1,profile2

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].

-J collection.profile.
<CollectionProfileName>.macros

Use this property if you want to override the macro values existing in one of the collection profiles specified.

In the property name, <CollectionProfileName> is a variable which indicates the name of the collection profile, in which you want to override macro values. You need to replace this variable with the correct collection profile name.

The value of this property must be a comma separated list of macro macro name:value pairs. These pairs must be enclosed in double quotes as given in the following format:

-J collection.profile.<CollectionProfileName>.macros="<MacroName1>":"<MacroValue1>", "<MacroName2>":"<MacroValue2>"

Starting services
STARTSERVICES_ITDA

Specifies whether you want to start the Collection Agent service immediately after the installation is complete.

Example: -J STARTSERVICES_ITDA=true

Was this page helpful? Yes No Submitting... Thank you

Comments