Globus Connect Server Node Update

Name

globus-connect-server node update - Update a data transfer node

Synopsis

globus-connect-server node update NODE_ID [OPTIONS]…​

Description

The globus-connect-server node update command updates information about a Data Transfer Node configured to run services for an endpoint. Its primary use is to disable or re-enable a node when doing system maintenance. It can change the IP address associated with the node. After disabling a node, the endpoint may have intermittent errors for up to two minutes while DNS changes propagate.

In order to use this command, one of your Globus identities must have an administrator role on the endpoint.

An active node will accept requests and participate in end user file transfers. However this does not guarantee that the node is fully operational only that it is included in servicing requests for the endpoint. A disabled node does not participate in servicing the endpoint.

To disable a node, use the command-line option --disable. This will have the following effects:

  • The node’s IP address is removed from the DNS entry used by the Globus Services. This may take a few minutes to propagate.

  • Future requests for management or data transfer service that are sent to the disabled node are rejected with a 503 Service Unavailable error. You can also use systemctl stop gcs_manager and systemctl stop gcs_manager_assistant to stop the Globus services entirely.

Important
If you use this command with the --disable option to disable all nodes for an endpoint, you will no longer be able to access the endpoint for any management or data access tasks. To fix this problem, use the globus-connect-server node setup command on any of the nodes. This will reset the node’s status to active and restart the services on that node.

To re-enable a node, use the command-line option --enable. This will update the node’s status to active and add it back to the DNS entry for the endpoint.

You can also use this command to change the IP address associated with a node, for example, if you are changing the network configuration of the node. To do so, pass the --ip-address IP-ADDRESS parameter on the command-line.

Options

-h, --help

Show help message and exit.

--version

Show the version and exit.

--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.

--enable / --disable

Set the node state to 'active' or 'inactive'.

--incoming-port-range LOW_PORT HIGH_PORT

Range of TCP ports to allow the GridFTP server to listen for data channel connections on. By default, Globus Connect Server uses the range [50000, 51000].

--outgoing-port-range LOW_PORT HIGH_PORT

Range of TCP ports to allow the GridFTP server to use as source ports for data channel connections to other GridFTP servers. By default, this is unconstrained.

-i, --ip-address ADDRESS

IP Address of this Data Transfer Node. By default this program will attempt to discover the public IP address that is used by the node. If it is unable to do so, you may be required to provide it on the command line using this option. Use this option multiple times to set multiple IPs.

--data-interface ADDRESS

The IP Address of the network interface to use for GridFTP data transfers. By default, this is set to the value of --ip-address if only one address is given. This option is required if multiple instances of --ip-address are given.

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

Output format for this command. If the format is json, then the full response from the GCS Manager is displayed.

Example

This example disables a node.

globus-connect-server node update --disable a42357fb-9d67-4510-9068-13f57dc2a62c