Sharing an Endpoint

This page explains how to share an endpoint using Globus.


Contents

https://arccwiki.atlassian.net/wiki/spaces/DOCUMENTAT/pages/64192662

https://arccwiki.atlassian.net/wiki/spaces/DOCUMENTAT/pages/33184


Transferring Data Using the Globus Web Interface

Logging In

Login to the Globus website:

  1. Go to globus.org and click the Login button.

  2. In the drop-down list, select "University of Wyoming" and click Continue.

  3. This redirects to a UWyo login page, log in as normal there. (The first time logging in, follow the prompts to complete account set up, including accepting Terms of Service.)

  4. After logging in, get to a Transfer Files page, from which various types of file transfers can be done.

Submitting a Transfer Request

  1. Go to Transfer Files page:

    • If you don't automatically get to the Transfer File page, then select it in the menu at the top of the page.

  2. Select the two endpoints that data will be transferred between:

    • If either one is a personal endpoint, make sure that Globus Connect Personal is running. The path for a personal endpoint may show up a little differently than expected – instead of starting at the path of the endpoint, it starts at the root of the path and it is necessary to browse to the directory which is the endpoint (although only subdirectories leading to the endpoint will be available to choose from). While this may seem unintuitive for an endpoint containing only one directory, it allows the ability to use endpoints that contain more than one directory at different locations.

    • If an endpoint is a server endpoint, then it will be necessary to login to access it. For the ARCC servers, this uses two-factor authentication. For example, for the endpoint arcc#petaLibrary, the Username is the UW username, and the Password is the UW password followed by a comma followed by the YubiKey token.

  3. Select files/directories to transfer:

    • Once both endpoints have been selected, double-click on the necessary folder/directory links to navigate to the locations between which the transfer will occur. Select the file or directory to transfer with a single click.

  4. Initiate transfer:

    • When a selection has been made for which a transfer is possible, one of the two gray arrows at the top of the page will change to blue. (The arrow indicates the direction of the transfer.) To initiate the transfer, click the blue arrow. In the example below, the selected file will be transferred from the server to the personal endpoint when the blue arrow is clicked.

    • There are some options that can be used with transfers:

      • Label: A transfer may optionally be given a label — if used, it will label the transfer on the Activity page and in any email notifications related to the transfer. If not used, the transfers will simply be labeled by the names of the endpoints. So using labels can be helpful for distinguishing between different transfers between the same endpoints.

      • Settings: The following settings can be turned on or off for each transfer:

        • sync (default off): transfer only new or changed files

        • delete destination files, not on the source (default off): makes destination match source

        • preserve source modifications times (default off): if off, destination modification time will be the time the transfer occurred

        • verify integrity (default on): uses checksums to ensure that source and destination files are identical, and automatically retransmits if they aren't

        • encryption (default off): can be used if supported by the endpoints

Status and Results

  1. (Optional) To see details on current and recent transfers:

    • The Activity page shows current and recent transfers with their status (completed, in progress, canceled, interrupted). To see details, like effective speed or progress, click the link for that transfer.

  2. Completion notification:

    • When the transfer is complete, an email notification about it is sent. If a transfer is interrupted, it is automatically retried for up to 3 days and will resume from the point of failure rather than retransmitting files already copied. If an interrupted transfer can't be resumed for 3 days, email notification of failure is sent. Even transfers too large to complete within the authentication expiration period of an endpoint can be handled — if endpoint credentials expire before a transfer completes, email notice to re-authenticate will be sent.

Sharing an Endpoint (or "Creating a Shared Endpoint")

The steps below apply to both server endpoints (e.g. "ARCC petaLibrary" and "ARCC Teton") and personal endpoints, but for personal endpoints, some additional setup is needed.

  1. Login at globus.org and go to the Transfer Files page. For one of the endpoints, select the endpoint to share. Navigate to the particular folder to be shared, and single-click the folder name to select it.

  2. Click the menu icon in the top right corner of the navigation box and choose the option "share".

    This loads a page to create the share, with the endpoint and path already selected. Enter the "Share Display Name", and optionally a Description, and click "Create".

  3. On the next page, select the user or group to share the endpoint with, and the sharing permissions (read-only or read-write), and follow the prompts on the page to add the permission.