Story #8332

[Docs] Fix flow of Rails servers' install guides

Added by Brett Smith almost 3 years ago. Updated about 2 years ago.

Status:
New
Priority:
Normal
Assigned To:
Category:
Documentation
Target version:
Start date:
02/01/2016
Due date:
% Done:

0%

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

Description

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.


Subtasks

Task #8369: Test processNew

Task #8368: Update docsNew

Task #8367: ReviewNew

History

#1 Updated by Brett Smith almost 3 years ago

  • Target version set to 2016-02-17 Sprint

#2 Updated by Brett Smith almost 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 almost 3 years ago

  • Story points set to 1.0

#4 Updated by Peter Amstutz almost 3 years ago

  • Assigned To set to Peter Amstutz

#5 Updated by Brett Smith almost 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 almost 3 years ago

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

#7 Updated by Tom Morris about 2 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.)

Also available in: Atom PDF