X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/679d5507d6c390fd03e5c71300001f2696b1f5b1..d4ed3e6460469f2766e1f1676c538d6c86e000b6:/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 05a6a0d538..5044cc0c21 100644 --- a/doc/install/install-keepstore.html.textile.liquid +++ b/doc/install/install-keepstore.html.textile.liquid @@ -11,7 +11,9 @@ SPDX-License-Identifier: CC-BY-SA-3.0 Keepstore provides access to underlying storage for reading and writing content-addressed blocks, with enforcement of Arvados permissions. Keepstore supports a variety of cloud object storage and POSIX filesystems for its backing store. -We recommend installing at least two Keepstore servers. By convention, we use the following hostname pattern: +We recommend starting off with two Keepstore servers. Exact server specifications will be site and workload specific, but in general keepstore will be I/O bound and should be set up to maximize aggregate bandwidth with compute nodes. To increase capacity (either space or throughput) it is straightforward to add additional servers, or (in cloud environments) to increase the machine size of the existing servers. + +By convention, we use the following hostname pattern:
+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'"
+~$ uuid_prefix=`arv --format=uuid user current | cut -d- -f1`
+~$ echo "Site prefix is '$uuid_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
+$ 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! +