Bug #7623

[Documentation] Missing documentation on Create arvados-server client

Added by Guillermo Carrasco almost 4 years ago. Updated almost 4 years ago.

Status:
Resolved
Priority:
Normal
Assigned To:
Category:
SSO
Target version:
Start date:
10/21/2015
Due date:
% Done:

100%

Estimated time:
1.00 h
Story points:
-

Description

In the documentation related to installing the SSO server, in the section "Create arvados-server client", seems to be missing documentation.

If I execute RAILS_ENV=production bundle exec rails console, then I get: Could not locate Gemfile or .bundle/ directory

I think you should be in the package installation directory, wherever the Gemfile is located (which will vary among distributions), and there execute those commands.

Associated revisions

Revision 689f463b (diff)
Added by Ward Vandewege almost 4 years ago

SSO installation doc fix: to run rails console, you need to be in the
/var/www/arvados-sso/current directory.

closes #7623

History

#1 Updated by Ward Vandewege almost 4 years ago

  • Assigned To set to Ward Vandewege

#2 Updated by Brett Smith almost 4 years ago

After more discussion on IRC, it sounds like there's a more general problem that the postinst script isn't running fully after reinstalling the package.

#3 Updated by Ward Vandewege almost 4 years ago

Thank you for filing this bug. Your assessment with regard to running rails console is correct. I've updated the documentation accordingly.

#4 Updated by Ward Vandewege almost 4 years ago

  • Status changed from New to Resolved
  • % Done changed from 0 to 100

Applied in changeset arvados|commit:689f463bbd231fba8e32b6d46a963d0dacf0e509.

#5 Updated by Ward Vandewege almost 4 years ago

Brett Smith wrote:

After more discussion on IRC, it sounds like there's a more general problem that the postinst script isn't running fully after reinstalling the package.

I just installed SSO server in a blank CentOS6 docker container, following our installation instructions. I did not encounter any problems with the postinst script not running.

#6 Updated by Ward Vandewege almost 4 years ago

  • Target version set to 2015-10-28 sprint

#7 Updated by Ward Vandewege almost 4 years ago

  • Subject changed from Missing documentation on Create arvados-server client to [Documentation] Missing documentation on Create arvados-server client

#8 Updated by Guillermo Carrasco almost 4 years ago

Hi,

thanks for updating the documentation.

Regarding the initialisation of the database, it is possible that I messed it up a bit when creating the database user and updating the configuration files, making them disagree on usernames and passwords. I'll check it out as soon as I can and let you know. In any case, thanks again for the quick update and the help!

#9 Updated by Guillermo Carrasco almost 4 years ago

Hi,

I spotted the problem. It turns out that after a fresh install I still had the same problem. This is the output from "yum reinstall arvados-sso-server"

@[root@sso current]# sudo yum reinstall arvados-sso-server
Loaded plugins: fastestmirror
Setting up Reinstall Process
Loading mirror speeds from cached hostfile * base: ftp.crc.dk * extras: mirror.one.com * updates: ftp.uninett.no
Resolving Dependencies
--> Running transaction check
---> Package arvados-sso-server.x86_64 0:0.1.20150928214138.593c076-1 will be reinstalled
--> Finished Dependency Resolution

Dependencies Resolved

=====================================================================================================================
Package Arch Version Repository Size =====================================================================================================================
Reinstalling:
arvados-sso-server x86_64 0.1.20150928214138.593c076-1 arvados 202 k

Transaction Summary =====================================================================================================================
Reinstall 1 Package(s)

Total download size: 202 k
Installed size: 511 k
Is this ok [y/N]: y
Downloading Packages:
arvados-sso-server-0.1.20150928214138.593c076-1.x86_64.rpm | 202 kB 00:01
Running rpm_check_debug
Running Transaction Test
Transaction Test Succeeded
Running Transaction
Installing : arvados-sso-server-0.1.20150928214138.593c076-1.x86_64 1/1
Non-fatal POSTIN scriptlet failure in rpm package arvados-sso-server-0.1.20150928214138.593c076-1.x86_64

Warning: web service (Nginx or Apache) not found.

To override, set the WEB_SERVICE environment variable to the name of the service
hosting the Rails server. Alternativey, install nginx.

For Debian-based systems, then reconfigure this package with dpkg-reconfigure.

For RPM-based systems, then reinstall this package.

Assumption: is configured to serve your SSO server URL from
/var/www/arvados-sso/current
Assumption: configuration files are in /etc/arvados/sso
Assumption: and passenger run as apache:apache

Symlinking files from /etc/arvados/sso ...... done.
Running bundle install ...Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
... done.
Ensuring directory and file permissions ...chown: invalid user: `apache:apache'
warning: %post(arvados-sso-server-0.1.20150928214138.593c076-1.x86_64) scriptlet failed, exit status 1
Verifying : arvados-sso-server-0.1.20150928214138.593c076-1.x86_64 1/1

Installed:
arvados-sso-server.x86_64 0:0.1.20150928214138.593c076-1

Complete!@

The poblem is that no apache or nginx server was installed. After installing apache, it did work fine. IMHO, its not clear in the documentation, wouldn't hurt a note that it needs to be installed before :-)

Thanks!

#10 Updated by Brett Smith almost 4 years ago

Guillermo Carrasco wrote:

The poblem is that no apache or nginx server was installed. After installing apache, it did work fine. IMHO, its not clear in the documentation, wouldn't hurt a note that it needs to be installed before :-)

Under Prerequisites, the SSO install guide has a section "Set up a Web server" that goes over this, and recommends installing Nginx. How would you like to see this improved? Should it be more prominent? Somewhere else on the page? Include more specific instructions? Other ideas?

#11 Updated by Guillermo Carrasco almost 4 years ago

Sorry I totally missed that, my bad. You're right and the info is there in requirements. I don't know if it could/should be more obvious, but I think it's okay.

Thanks!

Also available in: Atom PDF