Arvados

h1. Installing controller service

refs #13497

Add to "upgrading to master" section of doc.arvados.org:

* Create /etc/arvados/config.yml on your API server node, if you haven't already

* Add to /etc/arvados/config.yml: <pre><code class="yaml">

Clusters:

  {your-uuid-prefix}:

    SystemNodes:

      *:

        arvados-controller:

          Listen: ":9004" # choose a port

        arvados-api-server:

          Listen: ":8000" # must match Rails server port in your Nginx config

</code></pre>

* Install the arvados-controller package on your API server node

* 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).

** Add: <pre>

upstream arvados-controller {

  server                  127.0.0.1:9004;

}

</pre>

** Update server section that currently forwards traffic to @http://api@: <pre><code class="diff">

 server {

   listen                  [your public IP address]:443 ssl;

   server_name             uuid_prefix.your.domain;

   # ...

   location  / {

-    proxy_pass            http://api;

+    proxy_pass            http://arvados-controller;

     # ...

   }

 }

</code></pre>

Update install docs:

* Add arvados-controller to the list of deb/rpm packages to install

* Create /etc/arvados/config.yml (as above)

* If using systemd, run @systemctl start arvados-controller@ and confirm running status

* If not using systemd, set up a supervised service using runit