Globus Connect Server Command Line

Command-Line Reference
Audit
LoadQueryDumpDatabase SchemaFile Format
Endpoint
Endpoint Migrate53Endpoint SetupEndpoint ShowEndpoint UpdateEndpoint CleanupEndpoint Domain
OIDC
CreateShowUpdate
Node
CreateSetupListShowUpdateCleanupDelete
Login
Session
ShowUpdate
WhoamiLogout
Storage Gateway
CreateListShowUpdateDelete
Collection
CreateListShowUpdateDeleteDomain
Sharing Policy
CreateListShowDelete
Role
CreateListShowDelete
Skip to main content
Globus Docs
  • APIs
    • Auth
    • Transfer
    • Groups
    • Search
    • Python SDK
    • Helper Pages
  • How To
  • Guides
    • Globus Connect Server Installation Guides
    • High Assurance Collections for Protected Data
    • Management Console Guide
    • Command Line Interface
    • Premium Storage Connectors
    • Security
    • Modern Research Data Portal
  • Support
    • FAQs
    • Mailing Lists
    • Contact Us
    • Check Support Tickets
  1. Home
  2. Globus Connect Server
  3. Installation Guide
  4. Command-Line Reference
  5. Collection

Collections

  • v4
  • v5.3
  • v5.4

Collections

Collections are discoverable access points that allow data to be transferred through GridFTP or HTTPS.

A collection consists of metadata about the collection, a DNS domain for access data on the collection, and configuration on the Data Transfer Nodes to access the collection data. Globus Connect Server version 5 supports two types of collections: mapped and guest.

Mapped Collections

A mapped collection allows access to data for users who have accounts in the storage gateway’s user space (or local account). The collection uses the identity mapping method configured on the storage gateway to map the Globus account of the user accessing the collection to an account in the Storage Gateway’s user space. All accesses to the data on the collection are performed using the local account and (if needed for the storage gateway) the account’s credentials.

Mapped collections can only be created by those with an administrator or owner role on the Endpoint, and can be created against any storage gateway that exists on the endpoint.

In addition, a mapped collection has optional properties to allow users to share data. The properties allow_guest_collections and sharing_restrict_paths configure the sharing option. These options are only allowed on endpoints covered under a subscription.

Globus Connect Server v5.4.18 introduces APIs to manage user-specific sharing path restrictions.

Currently, mapped collections can be created using the globus-connect-server collection create command line tool.

Guest Collections

A guest collection is a collection that uses an existing mapped collection and adds the ability of a user to share access to their data on that collection. All access to the data is performed using the account of the user who created the guest collection. That user can also add entries to an access control list to allow others to access some parts of the guest collection owner’s data.

A guest collection document has additional properties mapped_collection_id and user_credential_id to describe the relationship between the collection and a mapped collection where it was created and the credential used for data access.

Currently, guest collections can be created using the Shares tab of the collection’s endpoint on the Globus web application.

Data Access

Both mapped and guest collections can be accessed using the Globus transfer service or (if the endpoint is managed), via HTTPS on the Data Transfer nodes. In either case, access to a collection is authenticated with Globus Auth-issued access tokens, with data access policies defined in the storage gateway and collection.

Commands

globus-connect-server collection create

Create a new collection.

globus-connect-server collection delete

Delete a collection.

globus-connect-server collection list

List collections.

globus-connect-server collection show

Show information about a collection.

globus-connect-server collection update

Update information about a collection.

globus-connect-server collection domain

Manage the domain name and certificate for a collection (new in v5.4.13)

Command-Line Reference
Audit
LoadQueryDumpDatabase SchemaFile Format
Endpoint
Endpoint Migrate53Endpoint SetupEndpoint ShowEndpoint UpdateEndpoint CleanupEndpoint Domain
OIDC
CreateShowUpdate
Node
CreateSetupListShowUpdateCleanupDelete
Login
Session
ShowUpdate
WhoamiLogout
Storage Gateway
CreateListShowUpdateDelete
Collection
CreateListShowUpdateDeleteDomain
Sharing Policy
CreateListShowDelete
Role
CreateListShowDelete
© 2010- The University of Chicago Legal Accessibility