Sun GlassFish Enterprise Server v2.1.1 High Availability Administration Guide

Management Agent Command Syntax

The syntax of the management agent ma command is:

ma [common-options] 
[ service-options] 
config-file

Where:

Table 3–1 Management Agent Common Options

Option 

Description 

Default 

--define name=value-D

Assign value to property name, where property is one of the properties defined in Configuration File. This option can be repeated multiple times.

None 

--help-? 

Display help information. 

False 

--javahome path-j

Use Java Runtime Environment (1.4 or later) located at path.

None 

--systemroot path-y

Path to the operating system root as normally set in %SystemRoot%. 

None 

--version-V 

Display version information. 

False 

Table 3–2 describes options for starting the management agent as a Windows service. The -i, -r, and -s options are mutually exclusive; that is, use only one of them at a time.

On Windows, when specifying paths for property values in the configuration file or on the command line, escape file paths containing spaces with double quotes ("). Escape drive and directory separators, : and \, with double quotes and a backslash: "\: and \".

Table 3–2 Management Agent Service Options (Windows Only)

Option 

Description 

Default 

--install-i 

Install the agent as a Windows service and start the service. Use only one of -i, -r, and -s options. 

False 

--name servicename-n

Use specified name for the service when running multiple agents on a host. 

HADBMgmtAgent 

--remove-r 

Stop the service and delete the agent from the Windows service manger. Use only one of -i, -r, and -s options. 

False 

--service-s 

Run the agent as a Windows service. Use only one of -i, -r, and -s options. 

False