Skip to content

P
Postgres FD Implementation
Commit abc40591 authored by Thomas G. Lockhart's avatar Thomas G. Lockhart
Browse files
Options

Cut down to 80 columns per Bruce. Mostly hacked at the porting table.

parent 50d2e68a
Show whitespace changes
Inline Side-by-side
Showing with 182 additions and 146 deletions
INSTALL
View file @ abc40591
PostgreSQL Installation Guide PostgreSQL Installation Guide
by The PostgreSQL Development Team by The PostgreSQL Development Team
Edited by Thomas Lockhart
PostgreSQL is 1996-9 by the Postgres Global Development Group.
PostgreSQL is 1998-9 by the Postgres Global Development Group.
Table of Contents Table of Contents
Summary Summary
...@@ -33,12 +32,6 @@ Table of Contents ...@@ -33,12 +32,6 @@ Table of Contents
Multi-Version Concurrency Control Multi-Version Concurrency Control
Detailed Change List Detailed Change List
List of Tables
2-1. Supported Platforms
2-2. Possibly Incompatible Platforms
4-1. Kerberos Parameter Examples
Summary Summary
Postgres, developed originally in the UC Berkeley Postgres, developed originally in the UC Berkeley
...@@ -83,32 +76,35 @@ Currently Supported Platforms ...@@ -83,32 +76,35 @@ Currently Supported Platforms
2.2.x-4.0 (mailto:t-ishii@sra.co.jp), 2.2.x-4.0 (mailto:t-ishii@sra.co.jp),
Marc Fournier Marc Fournier
(mailto:scrappy@hub.org)) (mailto:scrappy@hub.org))
DGUX m88k v6.3 1998-03-01 v6.4 probably OK. Needs new DGUX m88k v6.3 1998-03-01 v6.4 probably OK.
5.4R4.11 maintainer. (Brian E Gallew 5.4R4.11 Needs new maintainer.
(Brian E Gallew
(mailto:geek+@cmu.edu)) (mailto:geek+@cmu.edu))
Digital Alpha v6.4 1998-10-29 Minor patchable problems Digital Alpha v6.4 1998-10-29 Minor patchable problems
Unix 4.0 (Pedro J. Lobo Unix 4.0 (Pedro J. Lobo
(mailto:pjlobo@euitt.upm.es)) (mailto:pjlobo@euitt.upm.es))
HPUX PA-RISC v6.4 1998-10-25 Both 9.0x and 10.20 (Tom Lane HPUX PA-RISC v6.4 1998-10-25 Both 9.0x and 10.20
(mailto:tgl@sss.pgh.pa.us), (Tom Lane (mailto:tgl@sss.pgh.pa.us),
Stan Brown Stan Brown (mailto:stanb@awod.com))
(mailto:stanb@awod.com)) IRIX 6.5 MIPS v6.4 1998-12-29 IRIX 5.x is different
IRIX 6.5 MIPS v6.4 1998-12-29 IRIX 5.x is different (Mark Dalphin (Mark Dalphin (mdalphin@amgen.com))
(mdalphin@amgen.com))
linux Alpha v6.3.2 1998-04-16 Mostly successful. Needs linux Alpha v6.3.2 1998-04-16 Mostly successful. Needs
2.0.x work for v6.4. (Ryan Kirkpatrick 2.0.x work for v6.4.
(Ryan Kirkpatrick
(mailto:rkirkpat@nag.cs.colorado.edu)) (mailto:rkirkpat@nag.cs.colorado.edu))
linux x86 v6.4 1998-10-27 (Thomas Lockhart linux x86 v6.4 1998-10-27 (Thomas Lockhart
2.0.x/libc5 (mailto:lockhart@alumni.caltech.edu)) 2.0.x/libc5 (mailto:lockhart@alumni.caltech.edu))
linux x86 v6.5 1999-05-24 (Thomas Lockhart linux x86 v6.4 1999-05-24 (Thomas Lockhart
2.0.x/glibc (mailto:lockhart@alumni.caltech.edu)) 2.0.x/glibc2 (mailto:lockhart@alumni.caltech.edu))
linux MIPS v6.4 1998-12-16 Cobalt Qube (Tatsuo Ishii linux MIPS v6.4 1998-12-16 Cobalt Qube (Tatsuo Ishii
2.0.x (mailto:t-ishii@sra.co.jp)) 2.0.x (mailto:t-ishii@sra.co.jp))
linux Sparc v6.4 1998-10-25 (Tom Szybist linux Sparc v6.4 1998-10-25 (Tom Szybist
2.0.x (mailto:szybist@boxhill.com)) 2.0.x (mailto:szybist@boxhill.com))
linuxPPC PPC603e v6.4 1998-10-26 Powerbook 2400c (Tatsuo Ishii linuxPPC PPC603e v6.4 1998-10-26 Powerbook 2400c
2.1.24 (mailto:t-ishii@sra.co.jp)) 2.1.24 (Tatsuo Ishii
mklinux DR3 PPC750 v6.4 1998-09-16 PowerMac 7600 (Tatsuo Ishii (mailto:t-ishii@sra.co.jp))
mklinux PPC750 v6.4 1998-09-16 PowerMac 7600
DR3 (Tatsuo Ishii
(mailto:t-ishii@sra.co.jp)) (mailto:t-ishii@sra.co.jp))
NetBSD arm32 v6.5 1999-04-14 (Andrew McMurry NetBSD arm32 v6.5 1999-04-14 (Andrew McMurry
(mailto:a.mcmurry1@physics.oxford.ac.uk)) (mailto:a.mcmurry1@physics.oxford.ac.uk))
...@@ -117,8 +113,8 @@ Currently Supported Platforms ...@@ -117,8 +113,8 @@ Currently Supported Platforms
NetBSD m68k v6.4.2 1998-12-28 Mac SE/30 (Mr. Mutsuki NetBSD m68k v6.4.2 1998-12-28 Mac SE/30 (Mr. Mutsuki
Nakajima, Tatsuo Ishii Nakajima, Tatsuo Ishii
(mailto:t-ishii@sra.co.jp)) (mailto:t-ishii@sra.co.jp))
NetBSD- NS32532 v6.4 1998-10-27 small problems in date/time NetBSD- NS32532 v6.4 1998-10-27 small problems
current math (Jon Buller current in date/time math (Jon Buller
(mailto:jonb@metronet.com)) (mailto:jonb@metronet.com))
NetBSD/sp- Sparc v6.4 1998-10-27 (Tom I Helbekkmo NetBSD/sp- Sparc v6.4 1998-10-27 (Tom I Helbekkmo
arc 1.3H (mailto:tih@hamartun.priv.no)) arc 1.3H (mailto:tih@hamartun.priv.no))
...@@ -134,13 +130,14 @@ Currently Supported Platforms ...@@ -134,13 +130,14 @@ Currently Supported Platforms
2.6-2.7 (mailto:szybist@boxhill.com), 2.6-2.7 (mailto:szybist@boxhill.com),
Frank Ridderbusch Frank Ridderbusch
(mailto:ridderbusch.pad@sni.de)) (mailto:ridderbusch.pad@sni.de))
SunOS Sparc v6.3 1998-03-01 Patches submitted (Tatsuo Ishii SunOS Sparc v6.3 1998-03-01 Patches submitted
4.1.4 (mailto:t-ishii@sra.co.jp)) 4.1.4 (Tatsuo Ishii
(mailto:t-ishii@sra.co.jp))
SVR4 MIPS v6.4 1998-10-28 No 64-bit int compiler SVR4 MIPS v6.4 1998-10-28 No 64-bit int compiler
support (Frank Ridderbusch support (Frank Ridderbusch
(mailto:ridderbusch.pad@sni.de)) (mailto:ridderbusch.pad@sni.de))
Windows x86 v6.4 1999-01-06 Client-side libraries or Windows x86 v6.4 1999-01-06 Client-side libraries
ODBC/JDBC. No server yet. or ODBC/JDBC. No server yet.
(Magnus Hagander (Magnus Hagander
(mha@sollentuna.net) (mha@sollentuna.net)
Windows NT x86 v6.5 1999-05-26 Working with the Cygwin Windows NT x86 v6.5 1999-05-26 Working with the Cygwin
...@@ -170,16 +167,17 @@ Unsupported Platforms ...@@ -170,16 +167,17 @@ Unsupported Platforms
MacOS all v6.3 1998-03-01 Not library compatible; MacOS all v6.3 1998-03-01 Not library compatible;
use ODBC/JDBC use ODBC/JDBC
NextStep x86 v6.x 1998-03-01 Client-only support; NextStep x86 v6.x 1998-03-01 Client-only support;
v1.0.9 worked with v1.0.9 worked with patches
patches (David Wetzel (David Wetzel
(mailto:dave@turbocat.de)) (mailto:dave@turbocat.de))
SVR4 4.4 m88k v6.2.1 1998-03-01 Confirmed with patching; SVR4 4.4 m88k v6.2.1 1998-03-01 Confirmed
with patching;
v6.4.x will need TAS v6.4.x will need TAS
spinlock code (Doug Winterburn spinlock code (Doug
Winterburn
(mailto:dlw@seavme.xroads.com)) (mailto:dlw@seavme.xroads.com))
Ultrix MIPS,VAX? v6.x 1998-03-01 No recent reports; obsolete? Ultrix MIPS,VAX? v6.x 1998-03-01 No recent reports;
obsolete?
Chapter 3. Installation Chapter 3. Installation
...@@ -194,8 +192,10 @@ Chapter 3. Installation ...@@ -194,8 +192,10 @@ Chapter 3. Installation
o Commands are Unix-compatible. See note below. o Commands are Unix-compatible. See note below.
o Defaults are used except where noted. o Defaults are used except where noted.
o User postgres is the Postgres superuser. o User postgres is the Postgres superuser.
o The source path is /usr/src/pgsql (other paths are possible). o The source path is /usr/src/pgsql (other paths are
o The runtime path is /usr/local/pgsql (other paths are possible). possible).
o The runtime path is /usr/local/pgsql (other paths
are possible).
Commands were tested on RedHat Linux version 5.2 Commands were tested on RedHat Linux version 5.2
using the tcsh shell. Except where noted, they will using the tcsh shell. Except where noted, they will
...@@ -245,6 +245,7 @@ Requirements to Run Postgres ...@@ -245,6 +245,7 @@ Requirements to Run Postgres
Installation Procedure Installation Procedure
Postgres Installation Postgres Installation
...@@ -281,8 +282,11 @@ Installation Procedure ...@@ -281,8 +282,11 @@ Installation Procedure
the remaining steps in the installation will the remaining steps in the installation will
happen in this account. happen in this account.
4. Ftp file 4. Ftp file
ftp://ftp.postgresql.org/pub/postgresql-v6.5.tar.gz ftp://ftp.postgresql.org/pub/postgresql-v6.5.tar.-
from the Internet. Store it in your home directory. gz
(ftp://ftp.postgresql.org/pub/postgresql-v6.5.tar-
.gz) from the Internet. Store it in your home
directory.
5. Some platforms use flex. If your system uses flex 5. Some platforms use flex. If your system uses flex
then make sure you have a good version. To check, then make sure you have a good version. To check,
type type
...@@ -479,29 +483,46 @@ Installation Procedure ...@@ -479,29 +483,46 @@ Installation Procedure
configuration. To see them all, type configuration. To see them all, type
./configure --help ./configure --help
Some of the more commonly used ones are: Some of the more commonly used ones are:
--prefix=BASEDIR Selects a different base directory for the --prefix=BASEDIR Selects a different
installation of the Postgres configuration. base directory for the
The default is /usr/local/pgsql. installation of the
Postgres configuration.
The default is
/usr/local/pgsql.
--with-template=TEMPLATE --with-template=TEMPLATE
Use template file TEMPLATE - the template Use template file
files are assumed to be in the directory TEMPLATE - the template
src/template, so look there for proper values. files are assumed
--with-tcl Build interface libraries and programs requiring to be in the directory
Tcl/Tk, including libpgtcl, pgtclsh, and pgtksh. src/template, so
--with-perl Build the Perl interface library. look there for proper values.
--with-odbc Build the ODBC driver package. --with-tcl Build interface
--enable-hba Enables Host Based Authentication (DEFAULT) libraries and programs requiring
--disable-hba Disables Host Based Authentication Tcl/Tk, including
libpgtcl, pgtclsh, and pgtksh.
--with-perl Build the Perl
interface library.
--with-odbc Build the ODBC
driver package.
--enable-hba Enables Host Based
Authentication (DEFAULT)
--disable-hba Disables Host Based
Authentication
--enable-locale Enables USE_LOCALE --enable-locale Enables USE_LOCALE
--enable-cassert Enables ASSERT_CHECKING --enable-cassert Enables
ASSERT_CHECKING
--with-CC=compiler --with-CC=compiler
Use a specific C compiler that the configure Use a specific C
compiler that the configure
script cannot find. script cannot find.
--with-CXX=compiler --with-CXX=compiler
--without-CXX --without-CXX
Use a specific C++ compiler that the configure Use a specific C++
script cannot find, or exclude C++ compilation compiler that the configure
altogether. (This only affects libpq++ at script cannot find,
or exclude C++ compilation
altogether. (This
only affects libpq++ at
present.) present.)
c. Here is the configure script used on a Sparc c. Here is the configure script used on a Sparc
Solaris 2.5 system with /opt/postgres Solaris 2.5 system with /opt/postgres
...@@ -703,7 +724,7 @@ Installation Procedure ...@@ -703,7 +724,7 @@ Installation Procedure
o Edit file rc.local on NetBSD or file rc2.d on o Edit file rc.local on NetBSD or file rc2.d on
SPARC Solaris 2.5.1 to contain the following SPARC Solaris 2.5.1 to contain the following
single line: single line:
su postgres -c "/usr/local/pgsql/bin/postmaster \ su postgres -c "/usr/local/pgsql/bin/postmaster
-S -D /usr/local/pgsql/data" -S -D /usr/local/pgsql/data"
o In FreeBSD 2.2-RELEASE edit o In FreeBSD 2.2-RELEASE edit
/usr/local/etc/rc.d/pgsql.sh to contain the /usr/local/etc/rc.d/pgsql.sh to contain the
...@@ -712,10 +733,10 @@ Installation Procedure ...@@ -712,10 +733,10 @@ Installation Procedure
#!/bin/sh #!/bin/sh
[ -x /usr/local/pgsql/bin/postmaster ] && { [ -x /usr/local/pgsql/bin/postmaster ] && {
su -l pgsql -c 'exec su -l pgsql -c 'exec
/usr/local/pgsql/bin/postmaster \ /usr/local/pgsql/bin/postmaster
-D/usr/local/pgsql/data \ -D/usr/local/pgsql/data
-S -o -F > /usr/local/pgsql/errlog' \ -S -o -F > /usr/local/pgsql/errlog' &
& echo -n ' pgsql' echo -n ' pgsql'
} }
You may put the line breaks as shown above. The You may put the line breaks as shown above. The
shell is smart enough to keep parsing beyond shell is smart enough to keep parsing beyond
...@@ -730,9 +751,9 @@ Installation Procedure ...@@ -730,9 +751,9 @@ Installation Procedure
o In RedHat Linux edit file /etc/inittab to add the o In RedHat Linux edit file /etc/inittab to add the
following as a single line: following as a single line:
pg:2345:respawn:/bin/su - postgres -c pg:2345:respawn:/bin/su - postgres -c
"/usr/local/pgsql/bin/postmaster \ "/usr/local/pgsql/bin/postmaster
-D/usr/local/pgsql/data \ -D/usr/local/pgsql/data
>> /usr/local/pgsql/server.log 2>&1 \ >> /usr/local/pgsql/server.log 2>&1
</dev/null" </dev/null"
(The author of this example says this example (The author of this example says this example
will revive the postmaster if it dies, but he will revive the postmaster if it dies, but he
...@@ -825,8 +846,10 @@ Installation Procedure ...@@ -825,8 +846,10 @@ Installation Procedure
polygon geometric data types, then you will need polygon geometric data types, then you will need
to upgrade any columns containing those types. To to upgrade any columns containing those types. To
do so, type (from within psql) do so, type (from within psql)
UPDATE FirstTable SET PathCol = UpgradePath(PathCol); UPDATE FirstTable SET PathCol =
UPDATE SecondTable SET PathCol = UpgradePath(PathCol); UpgradePath(PathCol);
UPDATE SecondTable SET PathCol =
UpgradePath(PathCol);
... ...
VACUUM; VACUUM;
UpgradePath() checks to see that a path value is UpgradePath() checks to see that a path value is
...@@ -841,7 +864,8 @@ Installation Procedure ...@@ -841,7 +864,8 @@ Installation Procedure
26. Clean up after yourself. Type 26. Clean up after yourself. Type
$ rm -rf /usr/src/pgsql_6_5 $ rm -rf /usr/src/pgsql_6_5
$ rm -rf /usr/local/pgsql_6_5 $ rm -rf /usr/local/pgsql_6_5
# Also delete old database directory tree if it is not in # Also delete old database directory tree if it is
not in
# /usr/local/pgsql_6_5/data # /usr/local/pgsql_6_5/data
$ rm ~/postgresql-v6.5.tar.gz $ rm ~/postgresql-v6.5.tar.gz
27. You will probably want to print out the 27. You will probably want to print out the
...@@ -857,7 +881,8 @@ Installation Procedure ...@@ -857,7 +881,8 @@ Installation Procedure
$ alias gshp='gs -sDEVICE=laserjet -r300 $ alias gshp='gs -sDEVICE=laserjet -r300
-dNOPAUSE' -dNOPAUSE'
$ export $ export
GS_LIB=/usr/share/ghostscript:/usr/share/ghostscript/fonts GS_LIB=/usr/share/ghostscript:/usr/share/ghostscr-
ipt/fonts
$ gunzip user.ps.gz $ gunzip user.ps.gz
$ gshp -sOUTPUTFILE=user.hp user.ps $ gshp -sOUTPUTFILE=user.hp user.ps
$ gzip user.ps $ gzip user.ps
...@@ -940,12 +965,18 @@ Playing with Postgres ...@@ -940,12 +965,18 @@ Playing with Postgres
foo=> \d bar foo=> \d bar
Table = bar Table = bar
+--------------+---------------+-------+ +----------------------------------+-----------------
| Field | Type | Length| ------------------+-------+
+--------------+---------------+-------+ | Field |
| i | int4 | 4 | Type | Length|
| c | (bp)char | 16 | +----------------------------------+-----------------
+--------------+---------------+-------+ ------------------+-------+
| i | int4
| 4 |
| c | (bp)char
| 16 |
+----------------------------------+-----------------
------------------+-------+
And so on. You get the idea. And so on. You get the idea.
...@@ -982,36 +1013,52 @@ Parameters for Configuration (configure) ...@@ -982,36 +1013,52 @@ Parameters for Configuration (configure)
installers: installers:
Directory and file names: Directory and file names:
--prefix=PREFIX install architecture-independent files in PREFIX --prefix=PREFIX install
architecture-independent files in PREFIX
[/usr/local/pgsql] [/usr/local/pgsql]
--bindir=DIR user executables in DIR [EPREFIX/bin] --bindir=DIR user executables in DIR
--libdir=DIR object code libraries in DIR [EPREFIX/lib] [EPREFIX/bin]
--includedir=DIR C header files in DIR [PREFIX/include] --libdir=DIR object code libraries in
--mandir=DIR man documentation in DIR [PREFIX/man] DIR [EPREFIX/lib]
--includedir=DIR C header files in DIR
[PREFIX/include]
--mandir=DIR man documentation in DIR
[PREFIX/man]
Features and packages: Features and packages:
--disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no) --disable-FEATURE do not include FEATURE
(same as --enable-FEATURE=no)
--enable-FEATURE[=ARG] include FEATURE [ARG=yes] --enable-FEATURE[=ARG] include FEATURE [ARG=yes]
--with-PACKAGE[=ARG] use PACKAGE [ARG=yes] --with-PACKAGE[=ARG] use PACKAGE [ARG=yes]
--without-PACKAGE do not use PACKAGE (same as --with-PACKAGE=no) --without-PACKAGE do not use PACKAGE (same as
--with-PACKAGE=no)
--enable and --with options recognized: --enable and --with options recognized:
--with-template=template --with-template=template
use operating system template file use operating system
template file
see template directory see template directory
--with-includes=incdir site header files for tk/tcl, etc in DIR --with-includes=incdir site header files for
--with-libs=incdir also search for libraries in DIR tk/tcl, etc in DIR
--with-libraries=libdir also search for libraries in DIR --with-libs=incdir also search for libraries
in DIR
--with-libraries=libdir also search for libraries
in DIR
--enable-locale enable locale support --enable-locale enable locale support
--enable-recode enable cyrillic recode support --enable-recode enable cyrillic recode
support
--with-mb=encoding enable multi-byte support --with-mb=encoding enable multi-byte support
--with-pgport=portnum change default startup port --with-pgport=portnum change default startup port
--with-maxbackends=n set default maximum number of --with-maxbackends=n set default maximum number of
server processes server processes
--with-tcl build Tcl interfaces and pgtclsh --with-tcl build Tcl interfaces and
--with-tclconfig=tcldir tclConfig.sh and tkConfig.sh are in DIR pgtclsh
--with-tclconfig=tcldir tclConfig.sh and
tkConfig.sh are in DIR
--with-perl build Perl interface --with-perl build Perl interface
--with-odbc build ODBC driver package --with-odbc build ODBC driver package
--with-odbcinst=odbcdir change default directory for odbcinst.ini --with-odbcinst=odbcdir change default directory
--enable-cassert enable assertion checks (debugging) for odbcinst.ini
--enable-cassert enable assertion checks
(debugging)
--with-CC=compiler use specific C compiler --with-CC=compiler use specific C compiler
--with-CXX=compiler use specific C++ compiler --with-CXX=compiler use specific C++ compiler
--without-CXX prevent building C++ code --without-CXX prevent building C++ code
...@@ -1101,11 +1148,15 @@ Parameters for Building (make) ...@@ -1101,11 +1148,15 @@ Parameters for Building (make)
POSTGRESDIR= /opt/postgres/current POSTGRESDIR= /opt/postgres/current
CFLAGS+= -m486 # -g -O0 CFLAGS+= -m486 # -g -O0
USE_TCL= true
TCL_LIB= -ltcl
X_LIBS= -L/usr/X11/lib
TK_LIB= -ltk
# documentation # documentation
HSTYLE= /home/lockhart/SGML/db118.d/docbook/html HSTYLE= /home/tgl/SGML/db118.d/docbook/html
PSTYLE= /home/lockhart/SGML/db118.d/docbook/print PSTYLE= /home/tgl/SGML/db118.d/docbook/print
...@@ -1272,10 +1323,8 @@ Operation ...@@ -1272,10 +1323,8 @@ Operation
Table 4-1. Kerberos Parameter Examples Table 4-1. Kerberos Parameter Examples
Parameter Example Parameter Example
user frew@S2K.ORG user frew@S2K.ORG
user aoki/HOST=miyu.S2K.Berkel- user aoki/HOST=miyu.S2K.Berkeley.EDU@S2K.ORG
ey.EDU@S2K.ORG host postgres_dbms/ucbvax@S2K.ORG
host postgres_dbms/ucbvax@S2K.-
ORG
...@@ -1339,19 +1388,6 @@ Release 6.5 ...@@ -1339,19 +1388,6 @@ Release 6.5
Most interfaces have new versions, and existing Most interfaces have new versions, and existing
functionality has been improved. functionality has been improved.
Documentation
New and updated material is present throughout the
documentation. New FAQs have been contributed for SGI
and AIX platforms. The Tutorial has introductory
information on SQL from Stefan Simkovics. For the User's
Guide, there are reference pages covering the postmaster
and more utility programs, and a new appendix contains
details on date/time behavior. The Administrator's Guide
has a new chapter on troubleshooting from Tom Lane. And
the Programmer's Guide has a description of query
processing, also from Stefan, and details on obtaining
the Postgres source tree via anonymous CVS and CVSup.
Migration to v6.5 Migration to v6.5
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment