Skip to content

Commit 4f7035f

Browse files
authored
Fixes for rc4 (#191)
1 parent 0352760 commit 4f7035f

File tree

2 files changed

+13
-2
lines changed

2 files changed

+13
-2
lines changed

docs/source/getting_started.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ The paths to ``e3sm_unified`` activation scripts are machine dependent:
2626
**NERSC**
2727
::
2828

29-
source /global/cfs/cdirs/e3sm/software/anaconda_envs/load_latest_e3sm_unified_cori-haswel.sh
29+
source /global/common/software/e3sm/anaconda_envs/load_latest_e3sm_unified_cori-haswell.sh
3030

3131

3232
**Anvil**

docs/source/usage.rst

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -292,6 +292,10 @@ where
292292

293293
* ``--hpss=<path to HPSS>`` specifies the destination path on the HPSS file system.
294294
Note that if ``--hpss=none``, then ``--keep`` is automatically set to ``True``.
295+
The option also accepts a Globus URL, ``globus://<Globus endpoint UUID/<path to archive>``.
296+
Then zstash will use `Globus <https://globus.org/>`_ to extract from a zstash archive on a Globus endpoint.
297+
Names ``alcf`` and ``nersc`` are recognized as referring to the ALCF HPSS and NERSC HPSS endpoints,
298+
e.g. ``globus://nersc/~/my_archive``.
295299
* ``--workers=<num of processes>`` an optional argument which specifies the number of
296300
processes to use, resulting in extracting being done in parallel.
297301
**Using a high number will result in slow downloads for each of the tars since your bandwidth is limited.**
@@ -300,7 +304,7 @@ where
300304
* ``--keep`` to keep a copy of the tar files on the local file system after
301305
they have been extracted from the archive. Normally, they are deleted after
302306
successful transfer.
303-
* ``--tars`` to specify specific tars to check. See "Check" above for example usage.
307+
* ``--tars`` to specify specific tars to extract. See "Check" above for example usage.
304308
* ``-v`` increases output verbosity.
305309
* ``[files]`` is a list of files to be extracted (standard wildcards supported).
306310

@@ -390,6 +394,13 @@ You may specify the cache with the ``--cache`` option. Notice that there is no n
390394
--cache=/p/user_pub/e3sm/archive/1_1/BGC-v1/20181217.BCRC_CNPCTC20TR_OIBGC.ne30_oECv3.edison \
391395
"*cam.h3.1906-01-*-*.nc"
392396

397+
Example with Globus
398+
-------------------
399+
400+
To extract from the archive created with Globus in the ``zstash create`` example, you would run: ::
401+
402+
$ zstash extract --hpss=globus://9cd89cfd-6d04-11e5-ba46-22000b92c6ec/~/test/E3SM_simulations/20170731.F20TR.ne30_ne30.anvil
403+
393404
.. _zstash-list:
394405

395406
List

0 commit comments

Comments
 (0)