Project

General

Profile

Installing controller service » History » Version 5

Nico César, 07/10/2018 08:55 PM

1 1 Tom Clegg
h1. Installing controller service
2
3 2 Tom Clegg
refs #13497
4
5 1 Tom Clegg
Add to "upgrading to master" section of doc.arvados.org:
6 4 Tom Clegg
* Create @/etc/arvados/config.yml@ on your API server node, if you haven't already
7
* Add to @/etc/arvados/config.yml@: <pre><code class="yaml">
8 1 Tom Clegg
Clusters:
9
  {your-uuid-prefix}:
10 3 Tom Clegg
    NodeProfiles:
11 4 Tom Clegg
      apiserver:
12 1 Tom Clegg
        arvados-controller:
13
          Listen: ":9004" # choose a port
14
        arvados-api-server:
15
          Listen: ":8000" # must match Rails server port in your Nginx config
16
</code></pre>
17 4 Tom Clegg
* Create @/etc/arvados/environment@ containing one line, @ARVADOS_NODE_PROFILE=apiserver@
18 1 Tom Clegg
* Install the arvados-controller package on your API server node
19
* Update your Nginx configuration so incoming traffic for $ARVADOS_API_HOST is routed to port 9004 (or whichever port you chose for arvados-controller in your config).
20
** Add: <pre>
21
upstream arvados-controller {
22
  server                  127.0.0.1:9004;
23
}
24
</pre>
25
** Update server section that currently forwards traffic to @http://api@: <pre><code class="diff">
26
 server {
27
   listen                  [your public IP address]:443 ssl;
28
   server_name             uuid_prefix.your.domain;
29
   # ...
30
   location  / {
31
-    proxy_pass            http://api;
32
+    proxy_pass            http://arvados-controller;
33
     # ...
34
   }
35
 }
36
</code></pre>
37
38
Update install docs:
39
* Add arvados-controller to the list of deb/rpm packages to install
40 4 Tom Clegg
* Create @/etc/arvados/config.yml@ (as above)
41
* Create @/etc/arvados/environment@ (as above)
42 1 Tom Clegg
* If using systemd, run @systemctl start arvados-controller@ and confirm running status
43
* If not using systemd, set up a supervised service using runit
44 5 Nico César
45
h1. Verify it's working as expected
46
47
....