movecollectors CLI command

Use this command to move data collectors from one or more hosts (where the Collection Stations or Collection Agents are installed) to the target host based on the criterion specified. Additionally, you can preview the data collectors that will be affected by the criterion that you specify.

Note

This command is not supported for the following data collectors:

To understand the syntax and examples, see:

Related topics

deletecollector CLI command

exportcollector CLI command

Collecting data into the system

Agent types

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

movecollectors -c <criterion> -d <hostName> -p 
<portNumber> -u <userName> -w <password> -t 
<targetHostName> [-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:

Parameter	Description
-c	Criterion to be used for moving collectors. This parameter must be specified in the format `key=value`, as follows: `collectorName="<Data Collector Name>`" where `<Data Collector Name>` refers to the name of the data collector that you want to move. Notes: The value provided must be enclosed in double quotes. The value can be a comma-separated list of names. For example, `collectorName="Collector1,Collector2,Collector3"`. To move multiple data collectors with a similar name, you can use asterisk () as a wildcard character to substitute portions of the value. You can use asterisk as the wildcard character even while specifying a comma-separated list of data collector names. For example, `collectorName="Access,bppm*"`.
-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.
-t	Name of the Collection Station (or Collection Agent) where the data collectors need to be moved.
-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.
-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`.
-v	(Optional) Version of the IT Data Analytics product.
-s	(Optional) Indicates an HTTPS connection.

Example inputs

The following example provides the input for moving the data collectors starting with the names punWin and punLin:

movecollectors -c collectorName="punWin*,punLin" -d localhost -p 9797 -u admin -w admin12345 -t collection-station_WRG-13.bmc.com

The following example provides the input for moving multiple data collectors as per the names specified:

movecollectors -c collectorName="punWindowsEvents,punScriptOverSSH" -d localhost -p 9797 -u admin -w admin12345 -t collection-station_WRG-13.bmc.com

movecollectors CLI command

Syntax

Example inputs

Comments