15572: Ongoing install guide refresh/refactor
[arvados.git] / doc / install / install-postgresql.html.textile.liquid
1 ---
2 layout: default
3 navsection: installguide
4 title: Install PostgreSQL 9.4+
5 ...
6 {% comment %}
7 Copyright (C) The Arvados Authors. All rights reserved.
8
9 SPDX-License-Identifier: CC-BY-SA-3.0
10 {% endcomment %}
11
12 Arvados requires at least version *9.4* of PostgreSQL.
13
14 * "CentOS 7":#centos7
15 * "Debian or Ubuntu":#debian
16
17 h3(#centos7). CentOS 7
18 {% assign rh_version = "7" %}
19 {% include 'note_python_sc' %}
20
21 # Install PostgreSQL
22   <notextile><pre># <span class="userinput">yum install rh-postgresql95 rh-postgresql95-postgresql-contrib</span>
23 ~$ <span class="userinput">scl enable rh-postgresql95 bash</span></pre></notextile>
24 # Initialize the database
25   <notextile><pre># <span class="userinput">postgresql-setup initdb</span></pre></notextile>
26 # Configure the database to accept password connections
27   <notextile><pre><code># <span class="userinput">sed -ri -e 's/^(host +all +all +(127\.0\.0\.1\/32|::1\/128) +)ident$/\1md5/' /var/lib/pgsql/data/pg_hba.conf</span></code></pre></notextile>
28 # Configure the database to launch at boot
29   <notextile><pre># <span class="userinput">systemctl enable rh-postgresql95-postgresql</span></pre></notextile>
30 # Start the database
31   <notextile><pre># <span class="userinput">systemctl start rh-postgresql95-postgresql</span></pre></notextile>
32
33 h3(#debian). Debian or Ubuntu
34
35 Debian 8 (Jessie) and Ubuntu 16.04 (Xenial) and later versions include a sufficiently recent version of Postgres.
36
37 Ubuntu 14.04 (Trusty) requires an updated PostgreSQL version, see "the PostgreSQL ubuntu repository":https://www.postgresql.org/download/linux/ubuntu/
38
39 # Install PostgreSQL
40   <notextile><pre># <span class="userinput">apt-get --no-install-recommends install postgresql postgresql-contrib</span></pre></notextile>
41 # Configure the database to launch at boot
42   <notextile><pre># <span class="userinput">systemctl enable postgresql</span></pre></notextile>
43 # Start PostgreSQL
44   <notextile><pre># <span class="userinput">systemctl start postgresql</span></pre></notextile>
45
46 {% comment %}
47 h2(#sso). Set up SSO server credentials and database
48
49 {% assign service_role = "arvados_sso" %}
50 {% assign service_database = "arvados_sso_production" %}
51 {% assign use_contrib = false %}
52 {% include 'install_postgres_database' %}
53
54 {% endcomment %}