Project

General

Profile

Actions

Idea #8332

closed

[Docs] Fix flow of Rails servers' install guides

Added by Brett Smith over 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

Also available in: Atom PDF