[Docs] Fix flow of Rails servers' install guides
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:
- 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.)
- Install the Rails package.
- Edit the Rails package's configuration files.
- (API only: set up the Puma runit service.)
- Edit the nginx configuration to proxy the Rails server.
- 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.
#2 Updated by Brett Smith about 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.)