Project

General

Profile

Actions

Idea #8332

closed

[Docs] Fix flow of Rails servers' install guides

Added by Brett Smith about 8 years ago. Updated almost 5 years ago.

Status:
Closed
Priority:
Normal
Assigned To:
Category:
Documentation
Target version:
-
Start date:
02/01/2016
Due date:
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 3 (0 open3 closed)

Task #8369: Test processClosed02/01/2016Actions
Task #8368: Update docsClosed02/01/2016Actions
Task #8367: ReviewClosed02/01/2016Actions
Actions #1

Updated by Brett Smith about 8 years ago

  • Target version set to 2016-02-17 Sprint
Actions #2

Updated by Brett Smith about 8 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.)

Actions #3

Updated by Tom Clegg about 8 years ago

  • Story points set to 1.0
Actions #4

Updated by Peter Amstutz about 8 years ago

  • Assigned To set to Peter Amstutz
Actions #5

Updated by Brett Smith about 8 years ago

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

Updated by Brett Smith about 8 years ago

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

Updated by Tom Morris over 7 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.)

Actions #8

Updated by Nico César almost 5 years ago

  • Status changed from New to Closed
Actions #9

Updated by Tom Morris almost 5 years ago

  • Target version deleted (Arvados Future Sprints)
Actions

Also available in: Atom PDF