database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-06-13 07:41:39 +03:00
Code Activity

Improve installation instructions with pg_ctl in documentation

Browse Source 
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
This commit is contained in:
Michael Paquier
2019-02-02 13:23:26 +09:00
parent 558d77f20e
commit 3e938a83b2
2 changed files with 5 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
doc/src/sgml/installation.sgml
View File

@ -37,7 +37,7 @@ mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data chown postgres /usr/local/pgsql/data
su - postgres su - postgres
/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data /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/createdb test
/usr/local/pgsql/bin/psql test /usr/local/pgsql/bin/psql test
</synopsis> </synopsis>

12
doc/src/sgml/standalone-install.xml
View File

@ -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 The previous <command>initdb</command> step should have told you how to
start up the database server. Do so now. The command should look start up the database server. Do so now. The command should look
something like: something like:
<programlisting>/usr/local/pgsql/bin/postgres -D /usr/local/pgsql/data</programlisting> <programlisting>/usr/local/pgsql/bin/pg_ctl -D /usr/local/pgsql/data start</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 \
&lt;/dev/null &gt;&gt;server.log 2&gt;&amp;1 &lt;/dev/null &amp;</programlisting>
</para> </para>
<para> <para>
To stop a server running in the background you can type: 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> </para>
</step> </step>
<step> <step>
<para> <para>
Create a database: Create a database:
<screen><userinput>createdb testdb</userinput></screen> <screen><userinput>/usr/local/pgsql/bin/createdb testdb</userinput></screen>
Then enter: 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 to connect to that database. At the prompt you can enter SQL
commands and start experimenting. commands and start experimenting.
</para> </para>