git.postgresql.org Git - postgresql.git/commitdiff

git projects / postgresql.git / commitdiff

summary | shortlog | log | commit | commitdiff | tree
raw | patch | inline | side by side (parent: 558d77f)

Improve installation instructions with pg_ctl in documentation

author Michael Paquier <michael@paquier.xyz>

Sat, 2 Feb 2019 04:23:26 +0000 (13:23 +0900)

committer Michael Paquier <michael@paquier.xyz>

Sat, 2 Feb 2019 04:23:26 +0000 (13:23 +0900)

The documentation includes sections to be able to initialize and start
Postgres via a couple of commands. Some of its recommendations involve
using directly "postgres", which is inconsistent with the recommendation
given by initdb. At the same time make some other command calls more
consistent with the rest, by using an absolute path when creating a
database.

Author: Andreas Scherbaum
Reviewed-by: Michael Banck, Ryan Lambert

doc/src/sgml/installation.sgml patch | blob | blame | history

doc/src/sgml/standalone-install.xml patch | blob | blame | history

diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml

index ee518fb9b6b39606d534fff3255e4e3646e002ee..449386243b28545148c01b4a82a361c02b44c463 100644 (file)

--- a/doc/src/sgml/installation.sgml

+++ b/doc/src/sgml/installation.sgml

@@ -37,7 +37,7 @@ mkdir /usr/local/pgsql/data

chown postgres /usr/local/pgsql/data

su - postgres

/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data

-/usr/local/pgsql/bin/postgres -D /usr/local/pgsql/data >logfile 2>&1 &

+/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data -l logfile start

/usr/local/pgsql/bin/createdb test

/usr/local/pgsql/bin/psql test

</synopsis>

diff --git a/doc/src/sgml/standalone-install.xml b/doc/src/sgml/standalone-install.xml

index 62582effed20b1439c0313e3129231428a9e91f6..f584789f9a49ff545ad9721ec79dea291e857c22 100644 (file)

--- a/doc/src/sgml/standalone-install.xml

+++ b/doc/src/sgml/standalone-install.xml

@@ -77,25 +77,21 @@ postgres$ <userinput>/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data</useri

The previous <command>initdb</command> step should have told you how to

start up the database server. Do so now. The command should look

something like:

-<programlisting>/usr/local/pgsql/bin/postgres -D /usr/local/pgsql/data</programlisting>

- This will start the server in the foreground. To put the server

- in the background use something like:

-<programlisting>nohup /usr/local/pgsql/bin/postgres -D /usr/local/pgsql/data \

- </dev/null >>server.log 2>&1 </dev/null &</programlisting>

+<programlisting>/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start</programlisting>

</para>

<para>

To stop a server running in the background you can type:

-<programlisting>kill `cat /usr/local/pgsql/data/postmaster.pid`</programlisting>

+<programlisting>/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data stop</programlisting>

</para>

</step>

<step>

<para>

Create a database:

-<screen><userinput>createdb testdb</userinput></screen>

+<screen><userinput>/usr/local/pgsql/bin/createdb testdb</userinput></screen>

Then enter:

-<screen><userinput>psql testdb</userinput></screen>

+<screen><userinput>/usr/local/pgsql/bin/psql testdb</userinput></screen>

to connect to that database. At the prompt you can enter SQL

commands and start experimenting.

</para>

This is the main PostgreSQL git repository.