Copyright (c) 1996 Regents of the University of California
This directory contains the source and documentation for PostgreSQL
-(version 6.0) PostgreSQL is a derivative of POSTGRES 4.2 (the last
+(version 6.1) PostgreSQL is a derivative of POSTGRES 4.2 (the last
release of the UC Berkeley research project). For copyright terms for
PostgreSQL, please see the file named COPYRIGHT. This version was
developed by a team of developers on the postgres developers mailing
linux Intel x86 on Linux 1.2 and Linux ELF
(For non-ELF Linux, see LINUX_ELF below).
sparc_solaris SUN SPARC on Solaris 2.4
- sunos4 SUN SPARC on SunOS 4.1.3
+ sunos4 SUN SPARC on SunOS 4.1.3
svr4 Intel x86 on Intel SVR4
ultrix4 DEC MIPS on Ultrix 4.4
-----------------------------------
People migrating data from earlier releases must dump the data under
-1.09 and reload them under 6.0. The pg_dump utility is designed to do
+1.09 and reload them under 6.1. The pg_dump utility is designed to do
this. It is important you use 1.09 because earlier releases may not
-have the proper copy format to load into the 6.0 database.
+have the proper copy format to load into the 6.1 database.
INSTALLING POSTGRESQL
---------------------
install to the location of this program. (eg. bsdinst, which comes
with the MIT X Window System distribution)
- Customization can be done by editing src/Makefile.global. You may change
- the various configuration options here, such as where the PostgreSQL
- executable files are installed and where postgres looks for the database
- directory.
-
- PostgreSQL V6.0 also supports src/Makefile.custom. This is not supplied
- with the distribution, but may be created to contain only the options
- you wish to change in src/Makefile.global. This has the advantage that
- it will not be overwritten when you install a new version of PostgreSQL
- over the top of your current installation.
-
- The configuration switches are fairly self-explanatory, but we
- will go over some of the more commonly-changed options:
-
- - PORTNAME specifies the platform on which PostgreSQL is being built.
- This is set to UNDEFINED. You will need to change it to reflect
- your platform. (sparc for SunOS 4.1.x, sparc_solaris for Solaris
- 2.4, ultrix4 for Ultrix 4.4, and hpux for HP-UX 9.0, etc.)
-
- - SRCDIR specifies where the source files are located. (defaults to
- $(POSTGRESDIR)/src.)
-
- - POSTGRESDIR specifies the top-level directory where PostgreSQL
- binaries, header files, libraries, and databases are installed.
-
- - USE_READLINE specifies whether you want to use the GNU readline and
- history libraries for the psql interactive frontend program. GNU
- readline is not supplied with PostgreSQL and can be found in the
- usual ftp sites for GNU software.
-
- In the simplest case, you would create src/Makefile.custom containing
- just the line:
-
- PORTNAME= portname
-
- (where you replace portname with the name of the system you are using).
-
- Even easier is to enter the src directory and run the customize shell
- script which will prompt you with various questions and create
- Makefile.custom for you:
+ In the simplest version, you can just do the following:
% cd src
- % customize
-
- After editing src/Makefile.global or src/Makefile.custom, you are ready
- to compile PostgreSQL (it takes about 10 minutes on a 133Mhz Pentium
- running linux):
-
- % cd src ( if you're not already there )
+ % ./configure
+
+ The configure program will list the template files available and ask
+ you to choose one. A lot of times, an appropriate template file is
+ chosen for you, and you can just press Enter to accept the default. If
+ the default is not appropriate, then type in the appropriate template
+ file and press Enter. (If you do this, then send email to scrappy@hub.org
+ stating the output of the program './config.guess' and what the template
+ file should be.)
+
+ Once you have entered the template file, you will be asked a number of
+ questions about your particular configuration. These can be skipped by
+ adding parameters to the configure command above. The following parameters
+ can be tagged onto the end of the configure command:
+
+ --prefix=BASEDIR Selects a different base directory for the installation
+ of the PostgreSQL configuration. The default is
+ /usr/local/pgsql
+
+ --enable-hba Enables Host Based Authentication
+
+ --disable-hba Disables Host Based Authentication
+
+ --enable-locale Enables USE_LOCALE
+
+ --disable-locale Disables USE_LOCALE
+
+ --with-template=TEMPLATE
+ Use template file TEMPLATE - the template files are
+ assumed to be in the directory src/template, so look
+ there for proper values. (If the configure script
+ cannot find the specified template file, it will ask
+ you for one).
+
+ --with-pgport=PORT Sets the port that the postmaster process listens
+ for incoming connections on. The default for this
+ is port 5432.
+
+ As an example, here is the configure script I use on a Sparc
+ Solaris 2.5 system with /opt/postgres being the install base.
+
+ % ./configure --prefix=/opt/postgres
+ --with-template=sparc_solaris-gcc --with-pgport=5432
+ --enable-hba --disable-locale
+
+ Of course, in a real shell, you would type these three lines all on the
+ same line.
+
+ After configure has completed running, you can make the binaries. We use
+ 'gmake' to mean GNU make.
+
% gmake
The gmake ultimately issues the message "All of PostgreSQL is
a product so contact him for information. He has also indicated that
binary releases of PostgreSQL for NEXTSTEP will be made available to
the general public. Contact Info@RnA.nl for information.
-
-