Upgrading the GS-Agent Command
When the new Command Line Interface was introduced in GigaSpaces Platform and GigaSpaces release 12.3, it included the host run-agent command for starting a GigaSpaces agent on the current host.
While the legacy gs-agent script is still supported, it has been deprecated as of GigaSpaces Platform and GigaSpaces release 14.0 and will be removed in a future version. Customers upgrading from older versions are encouraged to upgrade to the new CLI command. The new CLI only supports working with the GigaSpaces Manager.
To get started with the new CLI command, simply run gs host run-agent --help
from the product's bin
Commonly Used Options
The following commonly-used options have the same functionality, except for the command name:
Task | Old Command | New Command |
---|---|---|
Run GigaSpaces Manager | gs-agent --manager
|
<GS_HOME>/bin/gs host run-agent --manager
|
Run "N' Grid Service Containers (GSCs) | gs-agent --gsc=N
|
<GS_HOME>/bin/gs host run-agent --gsc=N
|
Run the Web Management Console (web-ui) | gs-agent --webui
|
<GS_HOME>/bin/gs host run-agent --webui
|
Starting a Local Manager
The --manager-local
option was used in the previous version to start a GigaSpaces Manager on a local environment without configuration. This is superseded by the --auto
option in the new version, which has the following improved functionality:
- If GigaSpaces Manager is not configured, the command starts a local manager.
- If GigaSpaces Manager is configured, the configuration is inspected to check whether or not a manager should be started on the current host, and the command is executed accordingly.
Task | Old Command | New Command |
---|---|---|
Run a local GigaSpaces Manager | gs-agent --manager-local
|
<GS_HOME>/bin/gs host run-agent --auto
|
Custom Component
The gs-agent is extensible, and allows users to create custom options using .xml
files that describe what those options do. This customization is still supported in the new syntax, but now requires a --custom
prefix, to instruct the command line interpreter to skip syntax validation for the custom option.
Task | Old Command | New Command |
---|---|---|
Start "N' instances of foo.xml |
gs-agent --foo=N
|
<GS_HOME>/bin/gs host run-agent --custom foo=N
|
Starting Management Components Manually
Before the GigaSpaces Manager was introduced in release 12.1, users had to manually start the GSM Grid Service Manager. This is is a service grid component that manages a set of Grid Service Containers (GSCs). A GSM has an API for deploying/undeploying Processing Units. When a GSM is instructed to deploy a Processing Unit, it finds an appropriate, available GSC and tells that GSC to run an instance of that Processing Unit. It then continuously monitors that Processing Unit instance to verify that it is alive, and that the SLA is not breached. and Lookup Service management components. This option is not available in the new command because the GigaSpaces Manager is now the recommended option, and the ability to start a management environment without it has been deprecated.
You can still start GSM and LUS Lookup Service.
This service provides a mechanism for services to discover each other. Each service can query the lookup service for other services, and register itself in the lookup service so other services may find it. using the --custom
option, but we recommend doing this only as an interim step within the migration process, because support for non-manager environments will be removed in a future version.
In addition to the above, the global
modifier is not available in the new command because it is only relevant for multicast discovery, and the GigaSpaces Manager uses unicast discovery. You can use the --custom
option as a workaround for this.
Task | Old Command | New Command |
---|---|---|
Run Grid Service Manager (GSM) | gs-agent --gsm=1
|
<GS_HOME>/bin/gs host run-agent --custom gsm=1
|
Run Lookup Service (LUS) | gs-agent --lus=1
|
<GS_HOME>/bin/gs host run-agent --custom lus=1
|
Run Global Grid Service Manager (GSM) | gs-agent --global.gsm=1
|
<GS_HOME>/bin/gs host run-agent --custom global.gsm=1
|
Run Global Lookup Service (LUS) | gs-agent --global.lus=1
|
<GS_HOME>/bin/gs host run-agent --custom global.lus=1
|