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 Check that you are able to access the Arvados API server using the following command:
  11
  12 notextile. <pre><code>$ <span class="userinput">arv user current</span></code></pre>
  13
  14 If you receive the message "ARVADOS_API_HOST and ARVADOS_API_TOKEN need to be defined as environment variables", follow the instructions for "getting an API token,":{{site.basedoc}}/user/reference/api-tokens.html then return to this document.
  15
  16 When @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 This 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:
  21
  22 <notextile>
  23 <pre><code>$ <span class="userinput">arv -h user current</span>
  24 {
  25  "href":"https://qr1hi.arvadosapi.com/arvados/v1/users/qr1hi-xioed-9z2p3pn12yqdaem",
  26  "kind":"arvados#user",
  27  "etag":"8u0xwb9f3otb2xx9hto4wyo03",
  28  "uuid":"qr1hi-tpzed-92d3kxnimy3d4e8",
  29  "owner_uuid":"qr1hi-tpqed-23iddeohxta2r59",
  30  "created_at":"2013-12-02T17:05:47Z",
  31  "modified_by_client_uuid":"qr1hi-xxfg8-owxa2oa2s33jyej",
  32  "modified_by_user_uuid":"qr1hi-tpqed-23iddeohxta2r59",
  33  "modified_at":"2013-12-02T17:07:08Z",
  34  "updated_at":"2013-12-05T19:51:08Z",
  35  "email":"you@example.com",
  36  "full_name":"Example User",
  37  "first_name":"Example",
  38  "last_name":"User",
  39  "identity_url":"https://www.google.com/accounts/o8/id?id=AItOawnhlZr-pQ_Ic2f2W22XaO02oL3avJ322k1",
  40  "is_active": true,
  41  "is_admin": false,
  42  "prefs":{}
  43 }
  44 </code></pre>
  45 </notextile>
  46
  47 You are now ready proceed to the first tutorial: "Fetching data from Arvados using Keep.":{{site.basedoc}}/user/tutorials/intro-keep.html