Installing controller service » History » Version 1

Tom Clegg, 06/15/2018 04:27 PM

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