95 lines
2.8 KiB
Plaintext
95 lines
2.8 KiB
Plaintext
Using PostgreSQL package in OpenBSD environment:
|
|
------------------------------------------------
|
|
|
|
If you are installing PostgreSQL for the first time, the following steps
|
|
required:
|
|
|
|
1. Create PostgreSQL user and group:
|
|
|
|
# adduser -batch pgsql "" "PostgreSQL pseudo-user" "*" \
|
|
-home /var -noconfig -group pgsql -shell nologin
|
|
|
|
2. Initialize PostgreSQL databases:
|
|
|
|
# install -d -o pgsql -g pgsql -m 755 /var/pgsql
|
|
# install -d -o pgsql -g pgsql -m 700 /var/pgsql/data
|
|
# pgwrap initdb
|
|
|
|
If you are upgrading PostgreSQL you don't need these steps. Read
|
|
@PREFIX@/share/doc/pgsql/INSTALL for more information on how to
|
|
upgrade your existing databases. See also `Special notes for OpenBSD
|
|
port' below.
|
|
|
|
If you wish to start PostgreSQL automatically during system startup,
|
|
add the following lines to /etc/rc.local:
|
|
|
|
if [ -x @PREFIX@/bin/pgwrap -a -x @PREFIX@/pgsql/bin/postmaster ]; \
|
|
then
|
|
@PREFIX@/bin/pgwrap -o /var/pgsql/log \
|
|
pg_ctl -w -o "-i -S -o -F" start
|
|
echo -n ' pgsql'
|
|
fi
|
|
|
|
Don't forget to add @PREFIX@/pgsql/lib directory to shared libraries path in
|
|
/etc/rc.conf (if your architecture supports shared libraries):
|
|
|
|
shlib_dirs="@PREFIX@/pgsql/lib"
|
|
|
|
Add @PREFIX@/pgsql/man to ${MANPATH} if you wish to use PostgreSQL
|
|
manual pages or update your /etc/man.conf:
|
|
|
|
#PostgreSQL man pages
|
|
_whatdb /usr/local/pgsql/man/whatis.db
|
|
_subdir manl
|
|
_build .l /usr/bin/nroff -man %s
|
|
_default /usr/local/pgsql/man/
|
|
pgsql /usr/local/pgsql/man/
|
|
1 /usr/local/pgsql/man/man1
|
|
l /usr/local/pgsql/man/manl
|
|
|
|
|
|
Please note that OpenBSD port of PostgreSQL requires a kernel compiled
|
|
with SYSVMSG, SYSVSEM and SYSVSHM options for proper operation.
|
|
The GENERIC kernel contains these options.
|
|
|
|
|
|
Special notes for OpenBSD port:
|
|
-------------------------------
|
|
|
|
OpenBSD port of PostgreSQL does NOT use shell startup files to
|
|
set up environment for postgres administrative programs (such as
|
|
initdb). This mean that you should use a wrapper program `pgwrap'
|
|
to run these programs instead of `su'. For example, you
|
|
should execute
|
|
# pgwrap initdb
|
|
instead of
|
|
# su -l pgsql -c 'exec initdb'
|
|
|
|
The `pgwrap' automatically sets up proper environment and permissions
|
|
for PostgreSQL programs. The syntax for `pgwrap' program is:
|
|
|
|
pgwrap [-n] [-o file] cmd [arg ...]
|
|
-n - Do not add @PREFIX@/pgsql/bin prefix to cmd.
|
|
-o file - Redirect stdout & atderr to file (write permissions
|
|
for `pgsql' user or group required).
|
|
|
|
`pgwrap' automatically sets up the following environment variables:
|
|
|
|
System variables (these variables are always set to the following values):
|
|
|
|
PATH=@PREFIX@/pgsql/bin:/bin:/usr/bin
|
|
USER=pgsql
|
|
LOGNAME=pgsql
|
|
SHELL=/bin/sh
|
|
HOME=/var/pgsql
|
|
|
|
PostgreSQL variables (these variables are set to the following values,
|
|
unless already set):
|
|
|
|
PGLIB=@PREFIX@/pgsql/lib
|
|
PGDATA=/var/pgsql/data
|
|
|
|
You must have root privilegies to run `pgwrap'.
|
|
|
|
$OpenBSD: README.OpenBSD.in,v 1.3 2000/05/23 16:31:41 form Exp $
|