applycollectionprofilestohost CLI command
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:
- Set up the CLI. For more information, see Managing the product from the command line interface.
- Prefix this command with the following, as appropriate:
- For Windows: itda.bat
- For Linux: ./itda.sh
applycollectionprofilestohost -d <hostName> -p <portNumber> -u <userName> -w <password> -host <targetHost> -cp <listOfCollectionProfiles> -agent <associatedAgent> [-l <locale>] [-y] [-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:
| Parameter | Description |
|---|---|
-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:
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:
Example: If you want to set the locale as Simplified Chinese, you need to specify, |
-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. |
-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
Comments
Log in or register to comment.