Globus Connect Server Node List

Name

globus-connect-server node list - List data transfer nodes used by an endpoint

Synopsis

globus-connect-server node list [OPTIONS]…​

Description

The globus-connect-server node list command displays a summary of the data transfer nodes that exist on an endpoint.

By default, this command displays a table of data that includes the node id, ip_addresses, and status (active or inactive). Alternatively, it can display a JSON document containing the list results. Use the -F json command-line option to enable this output format.

The node status is stored in the endpoint configuration, and is only updated by the globus-connect-server node update, globus-connect-server node cleanup or globus-connect-server node setup commands.

If a data transfer node is having problems, an administrator should use the globus-connect-server node update command to set it to inactive to remove it from the DNS entry for the endpoint so that clients will not interact with the broken node.

See globus-connect-server node update for more information on the fields returned in the output of node list.

Options

-h, --help

Show help message and exit.

--version

Show the version and exit.

-F, --format "text"|"json"

Output format for this command. If the format is json, then the node document is displayed.

--use-explicit-host IP_ADDRESS (new in 5.4.23)

IP address of the GCS node to use for this request. If not specified, any available GCS node in the endpoint will be used.

--sort "IP" (new in 5.4.59)

Sort table entries in TEXT format by the given field. Supported fields: IP.

Example

This example lists the nodes on an endpoint:

globus-connect-server node list
ID                                   | IP Addresses  | Status
------------------------------------ | ------------- | ------
bd26a9e2-b1d2-4f1b-8bd4-5d4f50992e8e | 192.168.89.50 | active
cab100e5-ca94-488d-b156-7338de54036b | 192.168.23.88 | active