Managing the Grid Service Agent

To start a Grid Service Agent:

Command:

gs.{sh/bat} host run-agent

Description:

This command starts a Grid Service Agent on the current host.

Input Example: 

<GS_HOME>/bin/gs host run-agent

Parameters and Options:

Item Name Description
- - If no additional options are configured, run a Grid Service Agent without starting any additional services.
Option —auto Automatically resolve which service to run on the current host (local manager, Web Management Console, etc.).
Option —gsc Start a container on the host.
Option —containers=<number> Specify the number of containers to start (default is 0).
Option —manager Run one instance of the Manager (from the cluster of Managers).
Option —webui Start the Web Management Console. If you don't want to start the Web Management Console, set this option to --webui=false.
Option —custom=<String, Integer> Specify which custom service The Grid Service Agent should run (for example: --custom=global.lus=1).

The Manager configuration is applied from the GS_MANAGER_SERVERS environment variable. To configure a cluster of Managers on 1 or 3 machines (including this one), edit the setenv-overrides script and set the GS_MANAGER_SERVERS environment variable to list the designated Manager servers.

To run a standalone Manager on your machine, use the --auto command without configuring the GS_MANAGER_SERVERS environment variable.

To stop a Grid Service Agent:

Command:

gs.{sh/bat} host kill-agent

Description:

This command terminates the Grid Service Agent that is running on the current host.

Input Example: 

<GS_HOME>/bin/gs host kill-agent

Parameters and Options:

Item Name Description
- - Terminate the single running Grid Service Agent on the current host.
Parameter [pids] Display a whitespace-delimited list of process IDs (for example, 8361 1123 4270)
Option —all Terminates all Grid Service Agents on the current host.