* Fixed template so subsections only show up in userguide
[arvados.git] / doc / user / getting_started / check-environment.textile
1 ---
2 layout: default
3 navsection: userguide
4 title: "Checking your environment"
5 navorder: 10
6 ---
7
8 h1. Checking your environment
9
10 First you should "log into an Arvados VM instance":{{site.basedoc}}/user/getting_started/ssh-access.html#login if you have not already done so.
11
12 Check that you are able to access the Arvados API server using the following command:
13
14 notextile. <pre><code>$ <span class="userinput">arv user current</span></code></pre>
15
16 If @arv user current@ is able to access the API server, it will print out the unique identifier associated with your account.  Here is an example (you will receive a different identifier):
17
18 bc. qr1hi-xioed-9z2p3pn12yqdaem
19
20 However, if you receive the following message:
21
22 bc. ARVADOS_API_HOST and ARVADOS_API_TOKEN need to be defined as environment variables
23
24 Then follow the instructions for "getting an API token,":{{site.basedoc}}/user/reference/api-tokens.html and return to this document.
25
26 The unique identifier represents your identity in the Arvados system and is similar to the concept of a pointer or a foreign key.  You may de-reference (get the contents of) any identifier returned by the "arv" command using the @-h@ command line option.  For example:
27
28 <notextile>
29 <pre><code>$ <span class="userinput">arv -h user current</span>
30 {
31  "href":"https://qr1hi.arvadosapi.com/arvados/v1/users/qr1hi-xioed-9z2p3pn12yqdaem",
32  "kind":"arvados#user",
33  "etag":"8u0xwb9f3otb2xx9hto4wyo03",
34  "uuid":"qr1hi-tpzed-92d3kxnimy3d4e8",
35  "owner_uuid":"qr1hi-tpqed-23iddeohxta2r59",
36  "created_at":"2013-12-02T17:05:47Z",
37  "modified_by_client_uuid":"qr1hi-xxfg8-owxa2oa2s33jyej",
38  "modified_by_user_uuid":"qr1hi-tpqed-23iddeohxta2r59",
39  "modified_at":"2013-12-02T17:07:08Z",
40  "updated_at":"2013-12-05T19:51:08Z",
41  "email":"you@example.com",
42  "full_name":"Example User",
43  "first_name":"Example",
44  "last_name":"User",
45  "identity_url":"https://www.google.com/accounts/o8/id?id=AItOawnhlZr-pQ_Ic2f2W22XaO02oL3avJ322k1",
46  "is_active": true,
47  "is_admin": false,
48  "prefs":{}
49 }
50 </code></pre>
51 </notextile>
52
53 You are now ready proceed to the first tutorial: "Storing and retrieving data using Arvados Keep.":{{site.basedoc}}/user/tutorials/tutorial-keep.html