Globus Connect Server Administration Guides
  • Quickstart Guide
  • Installation Guide
  • Data Access Admin Guide
  • Domain Guide
  • HTTPS Access to Collections
  • Identity Mapping Admin Guide
  • Globus OIDC Installation Guide
  • Troubleshooting Guide
  • Command-Line Reference
    • Command summary
    • Audit
      • Load
      • Query
      • Dump
    • Endpoint
      • Setup
      • Show
      • Update
      • Reset Advertised Owner String
      • Set Advertised Owner String
      • Set Owner
      • Set Subscription ID
      • Cleanup
      • Key Convert
      • Domain
      • Role
      • Upgrade
    • OIDC
      • Create
      • Delete
      • Register
      • Show
      • Update
    • Node
      • Create
      • Disable
      • Enable
      • New Secret
      • Setup
      • List
      • Show
      • Update
      • Cleanup
      • Delete
    • Login
    • Session
      • Consent
      • Show
      • Update
    • Whoami
    • Logout
    • Storage Gateway
      • Create
      • List
      • Show
      • Update
      • Delete
    • Collection
      • Create
      • List
      • Show
      • Batch Delete
      • Reset Advertised Owner String
      • Set Advertised Owner String
      • Set Owner
      • Set Subscription Admin Verified Collection Property
      • Update
      • Delete
      • Domain
      • Check
      • Role
    • Auth Policy
      • Create
      • List
      • Show
      • Update
      • Delete
    • Sharing Policy
      • Create
      • List
      • Show
      • Delete
    • User Credentials
      • Activescale Create
      • OAuth Create
      • Delete
      • List
      • S3 Create
      • S3 Keys Add
      • S3 Keys Delete
      • S3 Keys Update
    • Self Diagnostic
  • Globus Connect Server Manager API
    • Authorization
    • Versioning
    • Endpoint
    • Roles
    • Nodes
    • Storage Gateways
    • Collections
    • User Credentials
    • Domains
    • Sharing Policies
  • API Access for Portals
  • Automated Endpoint Deployment
  • Data Access Application Guide
  • Application Migration Guide
  • Change Log
Skip to main content
Globus Docs
  • APIs
    Auth Flows Groups Search Timers Transfer Globus Connect Server Compute Helper Pages
  • Applications
    Globus Connect Personal Globus Connect Server Premium Storage Connectors Compute Command Line Interface Python SDK JavaScript SDK
  • Guides
  • Support
    FAQs Mailing Lists Contact Us Check Support Tickets
  1. Home
  2. Globus Connect Server
  3. v5.4
  4. Command-Line Reference
  5. Endpoint
  6. Update

Globus Connect Server Endpoint Update

Name

globus-connect-server endpoint update - Update an endpoint

Synopsis

globus-connect-server endpoint update [OPTIONS]…​

Description

The globus-connect-server endpoint update command updates information about the Globus Connect Server Endpoint. This can be used to update properties of the endpoint that may enable different functionality, tune performance, or make the endpoint easier to search for.

In order to use this command, one of your Globus identities must have an administrator or owner role on the endpoint (except for the --subscription-id parameter).

Subscription

The --subscription-id parameter can be used by a subscription manager who does not have an administrator or owner role on an endpoint if the following are true:

  • The endpoint is public

  • The endpoint is currently not managed

It can be used by an administrator or owner if the argument to that parameter is null and the endpoint is managed to alter the endpoint to be unmanaged.

Endpoint Visibility

The command line options --public and --private control whether the endpoint is visible to globus users who do not have a role on the endpoint. If the endpoint is set to private, then it is not visible in the Globus Transfer API unless the caller has a role on that endpoint.

Network Use

The command line option --network-use can be used to alter the network performance and scalability of your endpoint. The network use value may only be modified from the normal value on a managed endpoint. If the network use is set to custom, then all of the --preferred-parallelism, --max-parallelism, --preferred-concurrency, and --max-concurrency options must also be set. See the network use section of the installation guide for a description of what these values mean.

Endpoint Information

The --keywords, --department, --contact-email, --contact-info, --info-link, --description, --display-name options all add metadata to your endpoint in order to make it easier for users to search for useful endpoints.

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 full response from the GCS Manager 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.

--public / --private

Set the Endpoint to be public or private

--preferred-parallelism INTEGER

Set the Endpoint’s preferred parallelism; requires --network-use=custom

--max-parallelism INTEGER

Set the Endpoint’s max parallelism; requires --network-use=custom

--preferred-concurrency INTEGER

Set the Endpoint’s preferred concurrency; requires --network-use=custom

--max-concurrency INTEGER

Set the Endpoint’s max concurrency; requires --network-use=custom

--network-use "normal"|"minimal"|"aggressive"|"custom"

Set the Endpoint’s network use level. If using custom, the Endpoint’s max and preferred concurrency and parallelism must be set

--subscription-id UUID|"DEFAULT"|"null"

Set the Endpoint as a managed Endpoint with the given subscription ID or DEFAULT. Pass --subscription-id DEFAULT if are subscription manager for only one subscription, or pass '--subscription-id null' to set an endpoint’s subscription ID to null.

--keywords KEYWORD,…​

Comma-separated list of keywords to help searches for this endpoint.

--department DEPARTMENT

Department within the organization that runs the Data Transfer Nodes.

--contact-email ADDRESS

Email address of the support contact for this endpoint. This is visible to end users so that they may contact your organization for support.

--contact-info INFO

Other non-email contact information for the endpoint, e.g. phone and mailing address. This is visible to end users for support.

--info-link URL

Link to a web page with more information about the endpoint. The administrator is responsible for running a website at this URL and verifying that it"s accepting public connections.

--description DESCRIPTION

Description of this endpoint.

--display-name NAME

Name of this endpoint.

--gridftp-control-channel-port PORT (new in 5.4.55)

Set the TCP port that the GridFTP server listens for connections on.

  • Quickstart Guide
  • Installation Guide
  • Data Access Admin Guide
  • Domain Guide
  • HTTPS Access to Collections
  • Identity Mapping Admin Guide
  • Globus OIDC Installation Guide
  • Troubleshooting Guide
  • Command-Line Reference
    • Command summary
    • Audit
      • Load
      • Query
      • Dump
    • Endpoint
      • Setup
      • Show
      • Update
      • Reset Advertised Owner String
      • Set Advertised Owner String
      • Set Owner
      • Set Subscription ID
      • Cleanup
      • Key Convert
      • Domain
      • Role
      • Upgrade
    • OIDC
      • Create
      • Delete
      • Register
      • Show
      • Update
    • Node
      • Create
      • Disable
      • Enable
      • New Secret
      • Setup
      • List
      • Show
      • Update
      • Cleanup
      • Delete
    • Login
    • Session
      • Consent
      • Show
      • Update
    • Whoami
    • Logout
    • Storage Gateway
      • Create
      • List
      • Show
      • Update
      • Delete
    • Collection
      • Create
      • List
      • Show
      • Batch Delete
      • Reset Advertised Owner String
      • Set Advertised Owner String
      • Set Owner
      • Set Subscription Admin Verified Collection Property
      • Update
      • Delete
      • Domain
      • Check
      • Role
    • Auth Policy
      • Create
      • List
      • Show
      • Update
      • Delete
    • Sharing Policy
      • Create
      • List
      • Show
      • Delete
    • User Credentials
      • Activescale Create
      • OAuth Create
      • Delete
      • List
      • S3 Create
      • S3 Keys Add
      • S3 Keys Delete
      • S3 Keys Update
    • Self Diagnostic
  • Globus Connect Server Manager API
    • Authorization
    • Versioning
    • Endpoint
    • Roles
    • Nodes
    • Storage Gateways
    • Collections
    • User Credentials
    • Domains
    • Sharing Policies
  • API Access for Portals
  • Automated Endpoint Deployment
  • Data Access Application Guide
  • Application Migration Guide
  • Change Log
© 2010- The University of Chicago Legal Privacy Accessibility