Re: Correction for 9.6 documentation for OpenBSD

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: tech(at)aadu(dot)rocks, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Correction for 9.6 documentation for OpenBSD
Date: 2018-06-29 20:57:12
Message-ID: 91962FC4-8302-4617-B989-19D0AFA350BA@yesql.se
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 3 Apr 2018, at 07:29, PG Doc comments form <noreply(at)postgresql(dot)org> wrote:
>
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/9.6/static/server-start.html
> Description:
>
> OpenBSD 6.1 i386
> PostgreSQL 9.6
>
> In Section 18.3. Starting the Database Server, I did something different
> from the documentation. Instead of editing the file /etc/rc.local, as the
> documentation indicated, I ran the command
>
> doas rcctl set postgresql status on
>
> That command changed the file /etc/rc.conf.local. When I rebooted, the
> PostgreSQL server was running.

That’s because your postgresql server was installed via the ports system, which
provides an rc.d startup script for use with rcctl. The referenced
documentation describes how to start the server without a service script.

That being said, since the ports tree is the “recommended” method for
installing software perhaps the documentation should mention it? Perhaps
something along the lines of the below (a similar stanza could be added for
FreeBSD but I don’t it well enough to make an attempt).

cheers ./daniel

diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index 1c92e7df75..01f5eacfcc 100644
--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
@@ -377,6 +377,11 @@ if [ -x /usr/local/pgsql/bin/pg_ctl -a -x /usr/local/pgsql/bin/postgres ]; then
su -l postgres -c '/usr/local/pgsql/bin/pg_ctl start -s -l /var/postgresql/log -D /usr/local/pgsql/data'
echo -n ' postgresql'
fi
+</programlisting>
+ If <productname>PostgreSQL</productname> is installed via ports, it can
+ be started as a service with <application>rcctl</application>:
+<programlisting>
+rcctl set postgresql status on
</programlisting>
</para>
</listitem>

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2018-07-01 02:53:10 Bad external link in documentation.
Previous Message Daniel Gustafsson 2018-06-29 16:51:03 Re: Documented toolchain for building docs on Windows