X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/7d6ff766d02ddc486cb61be3a0bb9ce12e7a29ff..6d95130da47af9fd0290d3c8f80a0364faf74957:/doc/install/install-sso.html.textile.liquid diff --git a/doc/install/install-sso.html.textile.liquid b/doc/install/install-sso.html.textile.liquid index a3064038e8..fbed12495b 100644 --- a/doc/install/install-sso.html.textile.liquid +++ b/doc/install/install-sso.html.textile.liquid @@ -3,6 +3,11 @@ layout: default navsection: installguide title: Install the Single Sign On (SSO) server ... +{% comment %} +Copyright (C) The Arvados Authors. All rights reserved. + +SPDX-License-Identifier: CC-BY-SA-3.0 +{% endcomment %} h2(#dependencies). Install prerequisites @@ -10,7 +15,7 @@ The Arvados package repository includes an SSO server package that can help auto h3(#install_ruby_and_bundler). Install Ruby and Bundler -{% include 'install_ruby_and_bundler' %} +{% include 'install_ruby_and_bundler_sso' %} h3(#install_web_server). Set up a Web server @@ -77,68 +82,12 @@ There are other configuration options in @/etc/arvados/sso/application.yml@. See h2(#database). Set up the database -If PostgreSQL was newly installed as a dependency of the @arvados-sso-server@ package, you will need to start the service. - -On a Debian-based system: - - -
~$ sudo service postgresql start
-
-
- -On a Red Hat-based system, we also need to initialize the database system: - - -
~$ sudo service postgresql initdb
-~$ sudo service postgresql start
-
-
- -{% include 'notebox_begin' %} - -If you are installing on CentOS6, you will need to modify PostgreSQL's configuration to allow password authentication for local users. The default configuration allows 'ident' only. The following commands will make the configuration change, and restart PostgreSQL for it to take effect. -
- -
~$ sudo sed -i -e "s/127.0.0.1\/32          ident/127.0.0.1\/32          md5/" /var/lib/pgsql/data/pg_hba.conf
-~$ sudo sed -i -e "s/::1\/128               ident/::1\/128               md5/" /var/lib/pgsql/data/pg_hba.conf
-~$ sudo service postgresql restart
-
-
-{% include 'notebox_end' %} - - -Next, generate a new database password. Nobody ever needs to memorize it or type it, so make a strong one: - - -
~$ ruby -e 'puts rand(2**128).to_s(36)'
-abcdefghijklmnopqrstuvwxyz012345689
-
- -Configure the SSO server to connect to your database by updating @/etc/arvados/sso/database.yml@. Replace the @xxxxxxxx@ database password placeholder with the new password you generated above. Be sure to update the @production@ section. +Configure the SSO server to connect to your database by updating @/etc/arvados/sso/database.yml@. Replace the @xxxxxxxx@ database password placeholder with the "password you generated during database setup":install-postgresql.html#sso. Be sure to update the @production@ section.
~$ editor /etc/arvados/sso/database.yml
 
-Create a new database user with permission to create its own databases. - - -
~$ sudo -u postgres createuser --createdb --encrypted -R -S --pwprompt arvados_sso
-Enter password for new role: paste-database-password-you-generated
-Enter it again: paste-database-password-you-generated
-
- -Rails will take care of creating the database, based on the information from @/etc/arvados/sso/database.yml@. - -Alternatively, if the database user you intend to use for the SSO server should not be allowed to create new databases, the user and the database can be created like this: - - -
~$ sudo -u postgres createuser --encrypted -R -S --pwprompt arvados_sso
-Enter password for new role: paste-database-password-you-generated
-Enter it again: paste-database-password-you-generated
-~$ sudo -u postgres createdb arvados_sso_production -E UTF8 -O arvados_sso -T template0
-
- h2(#reconfigure_package). Reconfigure the package {% assign railspkg = "arvados-sso-server" %} @@ -287,9 +236,9 @@ In order to use Google+ authentication, you must use the