add gsm

Adds a global service manager to the Global Data Services framework.

Syntax

add gsm -gsm gsm_name
        -catalog connect_id
       [-pwd password]
       [-wpwd password]
       [-region region_name]
       [-localons ons_port]
       [-remoteons ons_port]
       [-listener listener_port]
       [-endpoint gmsendpoint]
       [-remote_endpoint remote_endpoint]
       [-trace_level level]
       [-encryption encryption]
       [-validate_network]

Options

Table 2-9 GDSCTL add gsm Options

Option	Description
`-catalog connect_id`	Specify the connect identifier for the Global Data Services catalog database. If a network service name is specified, it must be resolvable by the local naming method to a connect descriptor that allows the global service manager being added to connect to the catalog database.
`-endpoint gsmendpoint`	Specifies the protocol address that the global services manager listens on for client connection requests. If you use this option, the value that you specify overrides the default endpoint.
`-gsm gsm_name`	Specify the name of the global service manager that you want to add. If you do not specify a name, then GDSCTL uses the current global service manager name for the session (specified with the command set gsm.
`-listener listener_port`	Specify the listener port. The default port is 1522.
`-localons ons_port`	Specify the local ONS port. If you do not specify this option, then GDSCTL uses the default ONS port (which is 6123 on most platforms).
`-pwd password`	Specify the password for the `GSMCATUSER`. If you do not specify a password, then you are prompted to enter one.
`-region region_name`	Specify the region to which the global service manager belongs. The value for `region_name` must match the name of an existing Global Data Services region. If you do not specify a region, then GDSCTL adds the global service manager without assigning a region.
`-remote_endpoint remote_endpoint`	Specifies the protocol address that is used by the global service manager to receive database registration requests and communicate with other global service managers in the configuration. If you use this option, the value that you specify overrides the default endpoint.
`-remoteons ons_port`	Specify the remote ONS port. If you do not specify this option, then GDSCTL uses the default ONS port (which is 6234 on most platforms).
`-trace_level level`	Specify the global service manager trace level (to be used as directed by Oracle Support Services).
`-wpwd` `password`	Specify a password to protect the global service manager wallet. If a wallet password is not specified, a system-generated password is used instead. Note that if a password is specified with this option, the wallet cannot be modified without supplying that password.
`-encryption` `encryption`	Encryption protocol for Advanced Network Option (ANO) used between GSM, GDSCTL and databases. OFF means that ANO is disabled. ( AES256 \| AES192 \| OFF).
`-validate_network`	This flag enables several network validation checks, including checking network connectivity between hosts and checking VNCR entries are valid.

Usage Notes

You must specify the Global Data Services catalog database when using this command.
You must run this command, locally, on the computer where you want to add the global service manager.
You must have operating system privileges on the computer where you want to add the global service manager to run this command.
When you run this command, GDSCTL connects to the Global Data Services catalog as the GSMCATUSER user and prompts you for the GSMCATUSER password.

Example

Add a global service manager named gsm1, specifying the location of the Global Data Services catalog database, DB1.

GDSCTL> add gsm -gsm gsm1 -catalog 127.0.0.1:1521:db1

Parent topic: Global Data Services Control Utility (GDSCTL) Command Reference