Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The CLI provides the ability to stop/start/get status of installed Precise agents in a similar manner to AdminPoint->Agents dialog. There are 2 types of agents CLI•    Remote

  • Remote Agent Control: Allows all operations on all agents on all servers, except for starting Precise Listener or Precise FocalPoint agent. It should be executed in the main Precise FocalPoint.

...

  • Info

    Usage of remote CLI is preferred since it requires less manual action items (enablement of the CLI on the server).

...

  • Local Agent Control: Allows all operations on all agents on a specific server. It must be executed on the agent server.

Anchor
RemoteAgentControl
RemoteAgentControl
Remote Agent Control

To use Remote Agent Control CLI, run the following command on the main Precise FocalPoint

Windows  

...

 infra\bin\psin_cli.bat
                    -i3-user

...

<user_

...

name>
                    {-i3-encrypted-password

...

<encrypted_

...

password> | -i3-clear-password

...

<clear_

...

password>}
                    -action control-agent
                    [-proxy-alias

...

<node_

...

alias>]
                    -product <product_code>
                    -server <server_name>
                    -installation <installation_code>
                    -type <type

...

>
                    [-instance-name

...

<instance_

...

name>]

...

UNIX            ./infra/bin/psin_cli.sh
                    -i3-user

...

<user_

...

name>
                    {-i3-encrypted-password

...

<encrypted_

...

password> | -i3-clear-password

...

<clear_

...

password>}
                    -action control-agent
                    [-proxy-alias

...

<node_

...

alias>]
                    -product <product_code>
                    -server <server_name>
                    -installation <installation_code>
                    -type <type

...

>
                    [-instance-name

...

<instance_

...

name>]

 

Table 6-1    Elements 1 Elements if the Remote Agent ControlElement    Description

ElementDescription
i3-

...

userSee Authenticate to CLI Utility on page 8.

...

i3-encrypted-

...

passwordSee Authenticate to CLI Utility on page 8.

...

action

...

Values: control-agent

Mandatory: Yes

...

server

The agent's server.

Values: string

Mandatory: Yes

proxy-

...

alias

The proxy alias.

Values: alias of the related node

Mandatory: Only for a federated installation

...

product

The agent's product code.

Values: See Product Codes on page 175.

Mandatory: Yes

installation

...

The agent installation type code.

Values: See Installation Type Codes on page 175.

Mandatory: Yes

...

type

Operation to perform on the agent.

Values: One of

...

STATUS STOP START

Mandatory:

instance-

...

name

The agent's instances name.

Values: string

Mandatory: Instance name argument should be supplied for agent which are per instance (instance column in AdminPoint>Agent, contains instance name)

Anchor
LocalAgentControl
LocalAgentControl
Local Agent Control

...