Skip to content

Commit ebd2a86

Browse files
committed
Update gocmd usage guidance
1 parent a6ef7de commit ebd2a86

File tree

3 files changed

+12
-7
lines changed

3 files changed

+12
-7
lines changed

docs/instructions/day2.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,19 +23,24 @@ permalink: /instructions/day2/
2323
GOCMD_VER=$(curl -L -s https://raw.githubusercontent.com/cyverse/gocommands/main/VERSION.txt); \
2424
curl -L -s https://github.com/cyverse/gocommands/releases/download/${GOCMD_VER}/gocmd-${GOCMD_VER}-linux-amd64.tar.gz | tar zxvf -
2525

26-
# Initialize and verify identity
26+
# Initialize and authenticate
2727
./gocmd init
28-
./gocmd whoami
28+
./gocmd auth login # follow prompts for CyVerse credentials
29+
30+
# Optionally confirm access to your home directory
31+
./gocmd ls i:/iplant/home/YOUR_USER
2932
```
3033

34+
> Remote Data Store paths must include the `i:` prefix (for example, `i:/iplant/home/...`). Local paths should omit it.
35+
3136
**Example transfers:**
3237

3338
```bash
3439
# Upload a local file to the Data Store
35-
./gocmd put ./outputs/figure1.png /iplant/home/YOUR_USER/sprint/figure1.png
40+
./gocmd put ./outputs/figure1.png i:/iplant/home/YOUR_USER/sprint/figure1.png
3641

3742
# Download from the Data Store to your working dir
38-
./gocmd get /iplant/home/YOUR_USER/sprint/input.csv ./data/input.csv
43+
./gocmd get i:/iplant/home/YOUR_USER/sprint/input.csv ./data/input.csv
3944
```
4045

4146
> Keep large data out of GitHub. Store externally, link from the **Data** page.

docs/instructions/save-to-persistent-storage.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,12 +14,12 @@ curl -L -s https://github.com/cyverse/gocommands/releases/download/${GOCMD_VER}/
1414

1515
# Configure iRODS (accept defaults for Host/Port/Zone; use your CyVerse creds)
1616
./gocmd init
17-
./gocmd whoami
17+
./gocmd auth login # follow prompts to authenticate with CyVerse
1818
```
1919

2020
**Community folder root (read/write for teams):**
2121
```
22-
/iplant/home/shared/esiil/Innovation_summit/<GROUP_NAME>
22+
i:/iplant/home/shared/esiil/Innovation_summit/<GROUP_NAME>
2323
```
2424

2525
Set environment variables:

docs/project_template.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -107,7 +107,7 @@ Project one-liner: _(write it here)_
107107
GOCMD_VER=$(curl -L -s https://raw.githubusercontent.com/cyverse/gocommands/main/VERSION.txt); \
108108
curl -L -s https://github.com/cyverse/gocommands/releases/download/${GOCMD_VER}/gocmd-${GOCMD_VER}-linux-amd64.tar.gz | tar zxvf -
109109
./gocmd init
110-
./gocmd whoami
110+
./gocmd auth login # follow prompts to authenticate
111111
```
112112

113113
> *(macOS uses a different tarball)*

0 commit comments

Comments
 (0)