Story #8332

[Docs] Fix flow of Rails servers' install guides

Added by Brett Smith over 3 years ago. Updated 3 months ago.

Assigned To:
Target version:
Start date:
Due date:
% Done:


Estimated time:
(Total: 0.00 h)
Story points:


All the install guides for Rails servers currently tell you to install the Rails package, then install nginx. This now generates confusing warnings, because the Rails server postinst scripts try to find the Web server they're running under, and may not find anything if you're really starting from scratch.

The best flow now is:

  1. Install all the software we're going to install, except the Rails package itself. (This is a good chance of unify on the language from the SSO server about how when you're installing nginx, you only follow one page of instructions.)
  2. Install the Rails package.
  3. Edit the Rails package's configuration files.
  4. (API only: set up the Puma runit service.)
  5. Edit the nginx configuration to proxy the Rails server.
  6. Reconfigure/reinstall the Rails package.

If you do that right, everything should be working at the end of the last step, and it requires a minimum of backtracking.


Task #8369: Test processClosed

Task #8368: Update docsClosed

Task #8367: ReviewClosed


#1 Updated by Brett Smith over 3 years ago

  • Target version set to 2016-02-17 Sprint

#2 Updated by Brett Smith over 3 years ago

High priority because you can't follow the install guides as they are: the Rails packages won't install /etc/arvados/SERVER for you to edit configuration files until it can find a Web server. (Arguably a separate bug in the postinst script, but there it is.)

#3 Updated by Tom Clegg over 3 years ago

  • Story points set to 1.0

#4 Updated by Peter Amstutz over 3 years ago

  • Assigned To set to Peter Amstutz

#5 Updated by Brett Smith over 3 years ago

  • Assigned To deleted (Peter Amstutz)
  • Target version changed from 2016-02-17 Sprint to 2016-03-02 sprint

#6 Updated by Brett Smith over 3 years ago

  • Target version changed from 2016-03-02 sprint to Arvados Future Sprints

#7 Updated by Tom Morris almost 3 years ago

  • Assigned To set to Nico César

Nico / Javier - Is this still an issue? Since you did some manual installs recently I'm hoping you know off the top of your head.
(Assigned purely for triage, not fixing.)

#8 Updated by Nico César 4 months ago

  • Status changed from New to Closed

#9 Updated by Tom Morris 3 months ago

  • Target version deleted (Arvados Future Sprints)

Also available in: Atom PDF