Project

General

Profile

Installing controller service » History » Revision 5

Revision 4 (Tom Clegg, 06/15/2018 07:41 PM) → Revision 5/6 (Nico César, 07/10/2018 08:55 PM)

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}: 
     NodeProfiles: 
       apiserver: 
         arvados-controller: 
           Listen: ":9004" # choose a port 
         arvados-api-server: 
           Listen: ":8000" # must match Rails server port in your Nginx config 
 </code></pre> 
 * Create @/etc/arvados/environment@ containing one line, @ARVADOS_NODE_PROFILE=apiserver@ 
 * 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) 
 * Create @/etc/arvados/environment@ (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 

 h1. Verify it's working as expected 

 ....