Merge branch '3147-py-collection-retries-wip2'
[arvados.git] / doc / install / create-standard-objects.html.textile.liquid
1 ---
2 layout: default
3 navsection: installguide
4 title: Create standard objects
5
6 ...
7
8
9
10 h3. "All users" group
11
12 The convention is to add every active user to this group. We give it a distinctive UUID that looks like an IP broadcast address.
13
14 <pre>
15 prefix=`arv --format=uuid user current | cut -d- -f1`
16
17 echo "Site prefix is '$prefix'"
18 # (Make sure it matches your configured 5-character site prefix.)
19
20 read -rd $'\000' newgroup <<EOF; arv group create --group "$newgroup"
21 {
22  "uuid":"$prefix-j7d0g-fffffffffffffff",
23  "name":"All users"
24 }
25 EOF
26 </pre>
27
28 h3. "arvados" repository
29
30 This will be readable by the "All users" group, and therefore by every active user. This makes it possible for users to run the bundled Crunch scripts by specifying @"script_version":"master","repository":"arvados"@ rather than pulling the Arvados source tree into their own repositories.
31
32 <pre>
33 prefix=`arv --format=uuid user current | cut -d- -f1`
34
35 echo "Site prefix is '$prefix'"
36 # (Make sure it matches your configured 5-character site prefix.)
37
38 all_users_group_uuid="$prefix-j7d0g-fffffffffffffff"
39 repo_uuid=`arv --format=uuid repository create --repository '{"name":"arvados"}'`
40 echo "Arvados repository uuid is '$repo_uuid'"
41
42 read -rd $'\000' newlink <<EOF; arv link create --link "$newlink" 
43 {
44  "tail_uuid":"$all_users_group_uuid",
45  "head_uuid":"$repo_uuid",
46  "link_class":"permission",
47  "name":"can_read" 
48 }                                         
49 EOF
50 </pre>
51
52 h3. Keep disks
53
54 Currently, you need to tell Arvados about Keep services manually. You'll need at least two "disk" services.
55
56 Example:
57
58 <pre>
59 prefix=`arv --format=uuid user current | cut -d- -f1`
60 echo "Site prefix is '$prefix'"
61 # (Make sure it matches your configured 5-character site prefix.)
62
63 read -rd $'\000' keepservice <<EOF; arv keep_service create --keep-service "$keepservice"
64 {
65  "service_host":"keep0.$prefix.arvadosapi.com",
66  "service_port":25107,
67  "service_ssl_flag":false,
68  "service_type":"disk"
69 }
70 EOF
71 </pre>