Page tree
Skip to end of metadata
Go to start of metadata

Use this command to associate one or more collection profiles to a host. Doing this can enable you to automatically create data collectors based on the templates included in the collection profiles.

To understand the syntax and examples, see:

Syntax

Note

Before you run the command, note the following points:

 

applycollectionprofilestohost -d <hostName> -p <portNumber> -u <userName> -w <password> -host <targetHost> -cp <listOfCollectionProfiles> -agent <associatedAgent> [-l <locale>] [-y] [-v] [-s]

 

  • Angle brackets (< >) indicate a variable value that needs to be user defined.

  • Square brackets ([ ]) indicate optional parameters.

The following table describes the parameters used in the syntax:

ParameterDescription
-d
Host name of the Console Server
-p
Port number of the Console Server.
-u
User name to use to connect with the Console Server.
-w
Password corresponding to the user name to use to connect with the Console Server.
-host

Name of the host with which you want to associate the collection profiles.

This name should be the same as it appears on the Administration > Hosts page.

-cp

Name of the collection profiles that you want to associate with the host.

If the collection profile that you want to associate 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]

To associate multiple collection profiles, you can provide a comma-separated list of names.

Note: You can associate only those collection profiles that are already created.

-agent

Name of the Collection Station or Collection Agent provided associated with the host.

This name should be the same as it appears on the Administration > Hosts page.

-l

(Optional) Indicates the locale in which you want to display messages when the command is run.

You can set one of the following locales:

  • English
  • Simplified Chinese
  • German
  • French

By default, the messages are displayed in the locale of the system on which the CLI is run.

The value can be set to one of the following depending on the locale you choose:

  • English: en
  • Simplified Chinese: chs
  • German: de
  • French: fr

Example: If you want to set the locale as Simplified Chinese, you need to specify, l=chs.

-y

(Optional) Preview the status of the data collectors that will be affected by this command.

Note: This parameter only provides a preview and does not actually run the command. To run the command, you must exclude this parameter.

-v
(Optional) Version of the IT Data Analytics product.
-s
(Optional) Indicates an HTTPS connection.

Example inputs

The following example provides the input for associating the following collection profiles:

  • "OracleDBCP"
  • "ITDAMetricsCP" imported via the content pack, "ITDA Pack".
applycollectionprofilestohost -u admin -w admin12345 -p 9797 -d localhost -host Winhost -cp OracleDBCP, ITDAMetricsCP [ITDA Pack] -agent collection-station_HOU02.bmc.com