-
Notifications
You must be signed in to change notification settings - Fork 44
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #655 from aturner-epcc/aturner-epcc/globus-cli-645
Updates Globus docs to add CLI info and image alt text
- Loading branch information
Showing
2 changed files
with
55 additions
and
32 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,102 +1,123 @@ | ||
# Using Globus to transfer data to/from ARCHER2 filesystems | ||
# Globus | ||
|
||
## Setting up ARCHER2 filesystems | ||
Globus is a service that enables high-performance and convenient data transfer and sharing of large amounts of data. | ||
|
||
- [Globus website](https://www.globus.org/) | ||
- [Globus documentation and tutorials](https://docs.globus.org/guides/) | ||
|
||
## Using Globus on ARCHER2 | ||
|
||
The ARCHER2 filesystems have a Globus Collection (formerly known as an endpoint) with the name "Archer2 file systems" | ||
A full step-by-step guide on transferring data to/from ARCHER2 is provided below | ||
|
||
## Step-by-step example | ||
|
||
### Setting up ARCHER2 filesystems | ||
|
||
Navigate to [https://app.globus.org](https://app.globus.org) | ||
|
||
Log in with your Globus identity (this could be a globusid.org or other identity) | ||
|
||
![image](../images/globus/1-login.jpg) | ||
![Globus web app data transfer interface at login](../images/globus/1-login.jpg) | ||
|
||
|
||
In File Manager, use the search tool to search for “Archer2 file systems”. Select it. | ||
|
||
![image](../images/globus/2-archer2-search.jpg) | ||
![Using the app to locate the ARCHER2 collection](../images/globus/2-archer2-search.jpg) | ||
|
||
In the transfer pane, you are told that Authentication/Consent is required. Click Continue. | ||
|
||
![image](../images/globus/3-continue.jpg) | ||
![Continuing to the authetication step](../images/globus/3-continue.jpg) | ||
|
||
![image](../images/globus/4-link-archer2.jpg) | ||
![Interface required SAFE login](../images/globus/4-link-archer2.jpg) | ||
|
||
Click on the ARCHER2 Safe (safe.epcc.ed.ac.uk) link | ||
|
||
![image](../images/globus/5-safe.jpg) | ||
![Login to ARCHER2 SAFE and link account](../images/globus/5-safe.jpg) | ||
|
||
Select the correct User account (if you have more than one) | ||
|
||
Click Accept | ||
|
||
![image](../images/globus/6-continue.jpg) | ||
![Return to Globus web app](../images/globus/6-continue.jpg) | ||
|
||
Now confirm your Globus credentials – click Continue | ||
|
||
![Linking credentials at Globus web app](../images/globus/7-identity.jpg) | ||
|
||
![image](../images/globus/7-identity.jpg) | ||
Click on the SAFE ID you selected previously | ||
|
||
Click on the SAFE id you selected previously | ||
|
||
![image](../images/globus/8-safe.jpg) | ||
![Select the correct user account in SAFE](../images/globus/8-safe.jpg) | ||
|
||
Make sure the correct User account is selected and Accept again | ||
|
||
Your ARCHER2 /home directory will be shown | ||
|
||
![image](../images/globus/9-home.jpg) | ||
![Web app interface showing ARCHER2 home directory](../images/globus/9-home.jpg) | ||
|
||
You can switch to viewing e.g. your /work directory by editing the path, or using the "up one folder" and selecting folders to move down the tree, as required | ||
|
||
![image](../images/globus/9-work.jpg) | ||
![Web app interface showing ARCHER2 work directory](../images/globus/9-work.jpg) | ||
|
||
|
||
## Setting up the other end of the transfer | ||
### Setting up the other end of the transfer | ||
|
||
![image](../images/globus/10a-two-pane.jpg) | ||
![Illustration of two-panel view in web interface](../images/globus/10a-two-pane.jpg) | ||
|
||
Make sure you select two-panel view mode | ||
|
||
### Laptop | ||
#### Laptop | ||
|
||
![image](../images/globus/10-destination.jpg) | ||
![Illustrating search option in right panel](../images/globus/10-destination.jpg) | ||
|
||
If you wish to transfer data to/from your personal laptop or other device, click on the Collection Search in the right-hand panel | ||
|
||
![image](../images/globus/11-globus-connect-personal.jpg) | ||
![Illustrating connection to laptop step](../images/globus/11-globus-connect-personal.jpg) | ||
|
||
Use the link to “Get Globus Connect Personal” to create a Collection for your local drive. | ||
|
||
![image](../images/globus/12-to-laptop.jpg) | ||
![Interface showing local laptop view](../images/globus/12-to-laptop.jpg) | ||
|
||
### Other server e.g. JASMIN | ||
#### Other server e.g. JASMIN | ||
|
||
If you wish to connect to another server, you will need to search for the Collection e.g. JASMIN Default Collection and authenticate | ||
|
||
Please see the [JASMIN Globus page for more information](https://help.jasmin.ac.uk/docs/data-transfer/globus-transfers-with-jasmin/) | ||
|
||
![image](../images/globus/13-jasmin.jpg) | ||
![Illustration of connecting to JASMIN Collection](../images/globus/13-jasmin.jpg) | ||
|
||
## Setting up and initiating the transfer | ||
### Setting up and initiating the transfer | ||
|
||
Once you are connected to both the Source and Destination Collections, you can use the File Manager to select the files to be transferred, and then click the Start button to initiate the transfer | ||
|
||
![image](../images/globus/14-transfer.jpg) | ||
![Selecting data you want to transfer](../images/globus/14-transfer.jpg) | ||
|
||
A pop-up will appear once the Transfer request has been submitted successfully | ||
|
||
Clicking on the “View Details” will show the progress and final status of the transfer | ||
|
||
![image](../images/globus/15-result.jpg) | ||
![Progress indicator](../images/globus/15-result.jpg) | ||
|
||
![image](../images/globus/16-transferred.jpg) | ||
![Interface once data transfer is complete](../images/globus/16-transferred.jpg) | ||
|
||
## Using a different ARCHER2 account | ||
### Using a different ARCHER2 account | ||
|
||
If you want to use Globus with a different account on ARCHER2, you will have to go to Settings | ||
|
||
![image](../images/globus/17-settings.jpg) | ||
![Settings to change ARCHER2 account](../images/globus/17-settings.jpg) | ||
|
||
Manage Identities | ||
|
||
![image](../images/globus/18-unlink.jpg) | ||
![Multiple identities view](../images/globus/18-unlink.jpg) | ||
|
||
And Unlink the current ARCHER2 safe identity, then repeat the link process with the other ARCHER2 account | ||
|
||
## Globus Command Line Interface (CLI) | ||
|
||
The Globus CLI is also available on ARCHER2 for transferring data. You can make it available with | ||
|
||
``` | ||
module load globus-cli | ||
``` | ||
|
||
And Unlink the current ARCHER2 safe identity, then repeat the link process with the other ARCHER2 account | ||
For more information on use, see the [Globus CLI documentation](https://docs.globus.org/cli/). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters