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