Performing actions on a PATROL Agent by using CLI

You can use Command Line Interface (CLI) commands to run the managepaactions utility. With this utility, you can send the following commands to multiple PATROL Agents at once:

sendSyncMsg
executePSL

These commands can be accessed from the <installationDirectory>\TrueSightPServer\truesightpserver\bin folder.

The `sendSyncMsg` command

Use the sendSyncMsg command to restart multiple or all PATROL Agents at once. The following parameters are available for the sendSyncMsg command:

managepaactions sendSyncMsg user=<userName> [agentFile=<agentFileName>] [syncMsg=all] [waitInterval=<waitInterval>] [port=<port>] [protocol=<protocol>]

The parameters in sendSyncMsg are described in the following table:

Parameter	Description
`user=<username>`	The name of the user who runs the utility.
`agentFile=<agentFileName>`	Optional. Use this parameter to send the `sync` command to a few PATROL Agents. You can specify these PATROL Agents in the *agentFileName* file. Use this parameter instead of the `syncMsg=all` parameter. Open the Command Prompt and run the following commands to get the list of the PATROL Agents that you have saved in the *agentFileName* file: `CD /D "%TRUESIGHTPSERVER_HOME%\truesightpserver\modules\pgsql\bin\"` `psql -U <dbUserName> -d <dbname>` where `<dbUSerName>` is the database user that you provided during the TrueSight Presentation Server installation. For example: `psql -U admin -d truesight` `\copy` to select `serverid`, `moinstanceid`,`hostname` from `patrolagent_details` to the *agentFileName* file. `\q` Note <`agentFileName`> is the parameter to provide the file that contains the details of PATROL Agents with the location of the file. For example: `"C:\tableOut.txt"`
`syncMsg=all`	Optionial. Use this parameter to send the `sync` command to all PATROL Agents. Use this parameter instead of the `agentFile` parameter.
`waitInterval=<waitIntervalInMin>`	Optional. Use this parameter to specify the time delay to send the `sync` command. The default value of this parameter is 2 minutes. If you do not specify a value for this parameter, the `sync` command is sent after an interval of 2 minutes. If you specify 0 in this parameter, the `sync` command is sent immediately.
`port=<port>` `protocol=<protocol>`	Optional. The default values are: `port`: 443 `protocol`: https

The executePSL command

Use the executePSL command to send the PSL command to multiple or all PATROL Agents at once. The following parameters are available for the executePSL command:

managepaactions executePSL user=<userName> pslFile=<PSLFilename> [agentFile=<agentFileName>] [pslCmd=all] [waitInterval=<waitInterval>] [port=<port>] [protocol=<protocol>]

The parameters in executePSL are described in the following table:

Parameter	Description
`user=<username>`	The name of the user who runs the utility.
`pslFile=<PSLFileName>`	Use this parameter to send the `PSL` command to all PATROL Agents that you specify in the PSLFilename file.
`agentFile=<agentFileName>`	Optional. Use this parameter to send the `PSL` command to a few PATROL Agents. You can specify these PATROL Agents in the agentFileName file. Open the Command Prompt and run the following commands to get the list of the PATROL Agents that you have saved in the *agentFileName* file: `CD /D "%TRUESIGHTPSERVER_HOME%\truesightpserver\modules\pgsql\bin\"` `psql -U <dbUserName> -d <dbname>` where `<dbUSerName>` is the database user that you provided during the TrueSight Presentation Server installation. For example: `psql -U admin -d truesight` `\copy` to select `serverid`, `moinstanceid`,`hostname` from `patrolagent_details` to the *agentFileName* file. `\q` Note <`agentFileName`> is the parameter to provide the file that contains the details of PATROL Agents with the location of the file. For example: `"C:\tableOut.txt"`
`pslCmd=all`	Use this parameter to send the `PSL` command to all PATROL Agents. Use this parameter instead of the `agentFile` and `pslfile` parameters.
`waitInterval=<waitIntervalInMin>`	Optional. Use this parameter to specify the time delay to send the `PSL` command. The default value of this parameter is 2 minutes. If you do not specify a value for this parameter, the `PSL` command is sent after an interval of 2 minutes. If you specify 0 in this parameter, the `PSL` command is sent immediately.
`port=<port>` `protocol=<protocol>`	Optional. The default values are: `port`: 443 `protocol`: https

Performing actions on a PATROL Agent by using CLI

The sendSyncMsg command

The executePSL command

Comments

The `sendSyncMsg` command