public inbox for [email protected]  
help / color / mirror / Atom feed
Correction for 9.6 documentation for OpenBSD
3+ messages / 3 participants
[nested] [flat]

* Correction for 9.6 documentation for OpenBSD
@ 2018-04-03 05:29 PG Doc comments form <[email protected]>
  2018-06-29 20:57 ` Re: Correction for 9.6 documentation for OpenBSD Daniel Gustafsson <[email protected]>
  0 siblings, 1 reply; 3+ messages in thread

From: PG Doc comments form @ 2018-04-03 05:29 UTC (permalink / raw)
  To: [email protected]; +Cc: [email protected]

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.


^ permalink  raw  reply  [nested|flat] 3+ messages in thread

* Re: Correction for 9.6 documentation for OpenBSD
  2018-04-03 05:29 Correction for 9.6 documentation for OpenBSD PG Doc comments form <[email protected]>
@ 2018-06-29 20:57 ` Daniel Gustafsson <[email protected]>
  2018-07-15 10:12   ` Re: Correction for 9.6 documentation for OpenBSD Peter Eisentraut <[email protected]>
  0 siblings, 1 reply; 3+ messages in thread

From: Daniel Gustafsson @ 2018-06-29 20:57 UTC (permalink / raw)
  To: [email protected]; [email protected]

> On 3 Apr 2018, at 07:29, PG Doc comments form <[email protected]> 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>



^ permalink  raw  reply  [nested|flat] 3+ messages in thread

* Re: Correction for 9.6 documentation for OpenBSD
  2018-04-03 05:29 Correction for 9.6 documentation for OpenBSD PG Doc comments form <[email protected]>
  2018-06-29 20:57 ` Re: Correction for 9.6 documentation for OpenBSD Daniel Gustafsson <[email protected]>
@ 2018-07-15 10:12   ` Peter Eisentraut <[email protected]>
  0 siblings, 0 replies; 3+ messages in thread

From: Peter Eisentraut @ 2018-07-15 10:12 UTC (permalink / raw)
  To: Daniel Gustafsson <[email protected]>; [email protected]; [email protected]

On 29.06.18 22:57, Daniel Gustafsson wrote:
> 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).

That part of the documentation describes how to set up a PostgreSQL
instance from the sources.  So that is what a packager might read.  If
you want to know how a package sets things up, you need to read the
package's documentation.

We could document the setup of popular packages in the main
documentation, but we currently don't, and we would have to do it more
consistently across platforms.

-- 
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services





^ permalink  raw  reply  [nested|flat] 3+ messages in thread


end of thread, other threads:[~2018-07-15 10:12 UTC | newest]

Thread overview: 3+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2018-04-03 05:29 Correction for 9.6 documentation for OpenBSD PG Doc comments form <[email protected]>
2018-06-29 20:57 ` Daniel Gustafsson <[email protected]>
2018-07-15 10:12   ` Peter Eisentraut <[email protected]>

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox