Advertise filters param in discovery doc.
[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 h1. Create standard objects
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 user current | cut -d- -f1`
16 read -rd $'\000' newgroup <<EOF; arv group create --group "$newgroup"
17 {
18  "uuid":"$prefix-j7d0g-fffffffffffffff",
19  "name":"All users"
20 }
21 EOF
22 </pre>
23
24 h3. "arvados" repository
25
26 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 a commit like "arvados:HEAD", rather than having to pull the Arvados git tree into their own repositories.
27
28 <pre>
29 prefix=`arv user current | cut -d- -f1`
30 all_users_group_uuid="$prefix-j7d0g-fffffffffffffff"
31 repo_uuid=`arv repository create --repository '{"name":"arvados"}'`
32 echo "Arvados repository uuid is $repo_uuid"
33
34 read -rd $'\000' newlink <<EOF; arv link create --link "$newlink" 
35 {
36  "tail_kind":"arvados#group",
37  "tail_uuid":"$all_users_group_uuid",
38  "head_kind":"arvados#repository",
39  "head_uuid":"$repo_uuid",
40  "link_class":"permission",
41  "name":"can_read" 
42 }                                         
43 EOF
44 </pre>
45
46 h3. Keep disks
47
48 Currently, you need to tell Arvados about Keep disks manually.
49
50 <pre>
51 secret=`ruby -e 'print rand(2**512).to_s(36)[0..49]'`
52 arv keep_disk create --keep-disk <<EOF
53 {
54  "service_host":"keep0.xyzzy.arvadosapi.com",
55  "service_port":25107,
56  "service_ssl_flag":false,
57  "ping_secret":"$secret"
58 }
59 EOF
60 </pre>