CLI Menu

Command Line Interface (CLI) CLI QuickStart GuideCommand Line Interface (CLI) ExamplesUsing the CLI with High Assurance Resources

NAME

globus endpoint server add - Add a server to an endpoint.

SYNOPSIS

globus endpoint server add 'OPTIONS' 'ENDPOINT_ID'

DESCRIPTION

The globus endpoint server add command adds a server to an existing endpoint.

An endpoint must be a Globus Connect Server endpoint to have servers.

The --hostname option is required.

OPTIONS

--hostname 'TEXT'

Url or file name of the server.

--outgoing-data-ports 'TEXT'

Indicate to firewall administrators at other sites how to allow outgoing traffic from this server to their own. Specify as either 'unspecified', 'unrestricted', or as range of ports separated by a hyphen (e.g. '50000-51000') within the 1024-65535 range.

--incoming-data-ports 'TEXT'

Indicate to firewall administrators at other sites how to allow incoming traffic to this server from their own. Specify as either 'unspecified', 'unrestricted', or as range of ports separated by a hyphen (e.g. '50000-51000') within the 1024-65535 range.

--subject 'TEXT'

Subject of the X509 Certificate of the server. When unspecified, the CN must match the server hostname.

--port 'INTEGER'

Port for Globus control channel connections. Default is 2811.

--scheme '[gsiftp|ftp]'

Scheme for the Server. Default is gsiftp

--map-http-status 'TEXT'

Map non success HTTP response codes to exit codes other than 1. e.g. "--map-http-satus 403=0,404=0" would exit with 0 even if a 403 or 404 http error code was received. Valid exit codes are 0,1,50-99.

-F, --format '[json|text]'

Set the output format for stdout. Defaults to "text".

--jq, --jmespath 'EXPR'

Supply a JMESPath expression to apply to json output. Takes precedence over any specified '--format' and forces the format to be json processed by this expression.

A full specification of the JMESPath language for querying JSON structures may be found at https://jmespath.org/

-h, --help

Show help text for this command.

-v, --verbose

Control the level of output.

Use -v or --verbose to show warnings and any additional text output.

Use -vv to add informative logging.

Use -vvv to add debug logging and full stack on any errors. (equivalent to -v --debug)

EXAMPLES

Add a server with a url of gridftp.example.org to an endpoint

$ ep_id=ddb59aef-6d04-11e5-ba46-22000b92c6ec
$ globus endpoint server add $ep_id --hostname gridftp.example.org

EXIT STATUS

0 on success.

1 if a network or server error occurred, unless --map-http-status has been used to change exit behavior on http error codes.

2 if the command was used improperly.

© 2010- The University of Chicago Legal