X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/87c2b7450a906fbfc87c90b1e30cff11ac5e2aca..de76be07dcbb36d38f6714480570cddaeabe2194:/doc/install/install-keepstore.html.textile.liquid?ds=sidebyside diff --git a/doc/install/install-keepstore.html.textile.liquid b/doc/install/install-keepstore.html.textile.liquid index 750b7a47ef..64a710f912 100644 --- a/doc/install/install-keepstore.html.textile.liquid +++ b/doc/install/install-keepstore.html.textile.liquid @@ -198,19 +198,52 @@ Repeat the above sections to prepare volumes and bring up supervised services on h3. Tell the API server about the Keepstore servers -The API server needs to be informed about the presence of your Keepstore servers. For each of the Keepstore servers you have created, please execute the following commands on your shell server. +The API server needs to be informed about the presence of your Keepstore servers. -Make sure to update the @service_host@ value to match each of your Keepstore servers. +First, if you don't already have an admin token, create a superuser token: + +{% include 'create_superuser_token' %} + +Configure your environment to run @arv@ using the output of create_superuser_token.rb: + +
+export ARVADOS_API_HOST=zzzzz.example.com
+export ARVADOS_API_TOKEN=zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz
+
+ +Use this command to register each keepstore server you have installed. Make sure to update the @service_host@ value.
~$ prefix=`arv --format=uuid user current | cut -d- -f1`
 ~$ echo "Site prefix is '$prefix'"
 ~$ read -rd $'\000' keepservice <<EOF; arv keep_service create --keep-service "$keepservice"
 {
- "service_host":"keep0.$prefix.your.domain",
+ "service_host":"keep0.$uuid_prefix.your.domain",
  "service_port":25107,
  "service_ssl_flag":false,
  "service_type":"disk"
 }
 EOF
 
+ +h3(#testing). Testing keep + +Install the "Python SDK":{{site.baseurl}}/sdk/python/sdk-python.html + +@ARVADOS_API_HOST@ and @ARVADOS_API_TOKEN@ must be set in the environment. + +You should now be able to use @arv-put@ to upload collections and @arv-get@ to fetch collections: + +
+$ echo "hello world!" > hello.txt
+
+$ arv-put --portable-data-hash hello.txt
+2018-07-12 13:35:25 arvados.arv_put[28702] INFO: Creating new cache file at /home/example/.cache/arvados/arv-put/1571ec0adb397c6a18d5c74cc95b3a2a
+0M / 0M 100.0% 2018-07-12 13:35:27 arvados.arv_put[28702] INFO:
+
+2018-07-12 13:35:27 arvados.arv_put[28702] INFO: Collection saved as 'Saved at 2018-07-12 17:35:25 UTC by example@example'
+59389a8f9ee9d399be35462a0f92541c+53
+
+$ arv-get 59389a8f9ee9d399be35462a0f92541c+53/hello.txt
+hello world!
+