@@ -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
395406List
0 commit comments