Installing controller service » History » Version 4

Tom Clegg, 06/15/2018 07:41 PM

1 1 Tom Clegg
h1. Installing controller service
2 1 Tom Clegg
3 2 Tom Clegg
refs #13497
4 2 Tom Clegg
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 4 Tom Clegg
* Add to @/etc/arvados/config.yml@: <pre><code class="yaml">
8 1 Tom Clegg
Clusters:
9 1 Tom Clegg
  {your-uuid-prefix}:
10 3 Tom Clegg
    NodeProfiles:
11 4 Tom Clegg
      apiserver:
12 1 Tom Clegg
        arvados-controller:
13 1 Tom Clegg
          Listen: ":9004" # choose a port
14 1 Tom Clegg
        arvados-api-server:
15 1 Tom Clegg
          Listen: ":8000" # must match Rails server port in your Nginx config
16 1 Tom Clegg
</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 1 Tom Clegg
* 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 1 Tom Clegg
** Add: <pre>
21 1 Tom Clegg
upstream arvados-controller {
22 1 Tom Clegg
  server                  127.0.0.1:9004;
23 1 Tom Clegg
}
24 1 Tom Clegg
</pre>
25 1 Tom Clegg
** Update server section that currently forwards traffic to @http://api@: <pre><code class="diff">
26 1 Tom Clegg
 server {
27 1 Tom Clegg
   listen                  [your public IP address]:443 ssl;
28 1 Tom Clegg
   server_name             uuid_prefix.your.domain;
29 1 Tom Clegg
   # ...
30 1 Tom Clegg
   location  / {
31 1 Tom Clegg
-    proxy_pass            http://api;
32 1 Tom Clegg
+    proxy_pass            http://arvados-controller;
33 1 Tom Clegg
     # ...
34 1 Tom Clegg
   }
35 1 Tom Clegg
 }
36 1 Tom Clegg
</code></pre>
37 1 Tom Clegg
38 1 Tom Clegg
Update install docs:
39 1 Tom Clegg
* Add arvados-controller to the list of deb/rpm packages to install
40 4 Tom Clegg
* Create @/etc/arvados/config.yml@ (as above)
41 4 Tom Clegg
* Create @/etc/arvados/environment@ (as above)
42 1 Tom Clegg
* If using systemd, run @systemctl start arvados-controller@ and confirm running status
43 1 Tom Clegg
* If not using systemd, set up a supervised service using runit