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.
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 Unavailableerror. You can also use
systemctl stop gcs_managerand
systemctl stop gcs_manager_assistantto stop the Globus services entirely.
--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
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.
- -h, --help
Show help message and exit.
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.