Add 'sdk/java-v2/' from commit '55f103e336ca9fb8bf1720d2ef4ee8dd4e221118'
[arvados.git] / doc / user / tutorials / tutorial-keep-get.html.textile.liquid
index b47b63cbfd62c47672085c6987d594c3fe0ab22c..f206d302dee334c1287cae1f41c5dee6009fdbe1 100644 (file)
@@ -3,8 +3,11 @@ layout: default
 navsection: userguide
 title: "Downloading data"
 ...
+{% comment %}
+Copyright (C) The Arvados Authors. All rights reserved.
 
-{% include 'tutorial_expectations' %}
+SPDX-License-Identifier: CC-BY-SA-3.0
+{% endcomment %}
 
 Arvados Data collections can be downloaded using either the arv commands or using Workbench.
 
@@ -14,6 +17,8 @@ Arvados Data collections can be downloaded using either the arv commands or usin
 
 h2(#download-using-arv). Downloading using arv commands
 
+{% include 'tutorial_expectations' %}
+
 You can download Arvados data collections using the command line tools @arv-ls@ and @arv-get@.
 
 Use @arv-ls@ to view the contents of a collection:
@@ -54,6 +59,19 @@ You can also download individual files:
 </code></pre>
 </notextile>
 
+h3. Federated downloads
+
+If your cluster is "configured to be part of a federation":{{site.baseurl}}/admin/federation.html you can also download collections hosted on other clusters (with appropriate permissions).
+
+If you request a collection by portable data hash, it will first search the home cluster, then search federated clusters.
+
+You may also request a collection by UUID.  In this case, it will contact the cluster named in the UUID prefix (in this example, @qr1hi@).
+
+<notextile>
+<pre><code>~$ <span class="userinput">arv-get qr1hi-4zz18-fw6dnjxtkvzdewt/ .</span>
+</code></pre>
+</notextile>
+
 h2(#download-using-workbench). Downloading using Workbench
 
 You can also download Arvados data collections using the Workbench.
@@ -74,6 +92,6 @@ This will create a sharing link for the collection as shown below. You can copy
 
 !{display: block;margin-left: 25px;margin-right: auto;border:1px solid lightgray;}{{ site.baseurl }}/images/shared-collection.png!
 
-A user with this url can download this collection by simply accessing this url. It will present a downloadable version of the collection as shown below.
+A user with this url can download this collection by simply accessing this url using browser. It will present a downloadable version of the collection as shown below.
 
 !{display: block;margin-left: 25px;margin-right: auto;border:1px solid lightgray;}{{ site.baseurl }}/images/download-shared-collection.png!