OSDN Git Service

From: David Friend <dfriend@atlsci.atlsci.com>
authorMarc G. Fournier <scrappy@hub.org>
Wed, 7 May 1997 03:15:36 +0000 (03:15 +0000)
committerMarc G. Fournier <scrappy@hub.org>
Wed, 7 May 1997 03:15:36 +0000 (03:15 +0000)
Subject: [PATCHES] New INSTALL file.

I have created a much more comprehensive version of the
/usr/src/pgsql/INSTALL file.  It should replace the current 970428 version
of this file.

INSTALL

diff --git a/INSTALL b/INSTALL
index 8956d8e..92dd3ea 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -1,14 +1,36 @@
 POSTGRESQL INSTALLATION INSTRUCTIONS
-Copyright (c) 1996 Regents of the University of California
+Copyright (c) 1997 Regents of  the University of California
 
-This directory contains the source and documentation for PostgreSQL
-(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
+This is file /usr/src/pgsql/INSTALL.  It contains notes on how to install
+PostgreSQL v6.1.  Up to date information on PostgreSQL may be found at
+http://www.postgresql.org.
+
+PostgreSQL is a database server.  It is not completely ANSI SQL
+compliant, but with each release it gets closer.
+
+PostgreSQL, formerly called Postgres95, 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
 list.  Version 1 (through 1.01) was developed by Jolly Chen and Andrew
 Yu.
 
+The installation notes below assume the following (except where noted):
+  - Commands were tested on RedHat Linux version 4.0 using the bash
+    shell.  Except where noted, they will probably work on most
+    systems.  USE COMMON SENSE before typing in these commands.
+    Commands like ps and tar vary wildly on what options you should
+    use on each platform.
+  - Defaults are assumed.
+  - User postgres is the postgres superuser.
+
+Our Makefiles require GNU make (called gmake in this document) and
+also assume that "install" accepts BSD options. The INSTALL
+variable in the Makefiles is set to the BSD-compatible version of
+install. On some systems, you will have to find a BSD-compatible
+install command (eg. bsdinst, which comes with the MIT X Window System
+distribution) 
+
 
 REQUIREMENTS TO RUN POSTGRESQL
 ------------------------------
@@ -41,198 +63,409 @@ You should have at least 8 MB of memory and at least 30 MB of disk space to
 hold the source, binaries, and user databases.
 
 
-MIGRATING FROM POSTGRES VERSION 1.*
------------------------------------
-
-People migrating data from earlier releases must dump the data under
-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.1 database.
-
-INSTALLING POSTGRESQL
----------------------
-
-Installing PostgreSQL encompasses only installing the software on your system
-so you can use it to access (or create or manipulate) databases.  This
-step does not include actually creating any database or configuring your 
-system to use it.
-
-Before you start, if you are using GNU flex, you should ensure that you
-are not using Version 2.5.3. If you have this version, you should either
-change to 2.5.2 or 2.5.4 or apply the patch in doc/README.flex
-
-To install PostgreSQL on UNIX platforms:
-
-1. Unpack the source distribution into a source directory.  We'll assume
-   "/usr/src/pgsql" in this discussion.  This should be a new directory.
-  
-2. Set your current directory to the source directory:
-
-   cd /usr/src/pgsql
-
-3. Build PostgreSQL:
-
-   If you're installing PostgreSQL on Ultrix 4.x or Linux, see the 
-   porting notes at the end for additional packages that you need to install
-   before installing PostgreSQL.
-
-   If using Linux or Irix, you should also read the machine-specific FAQs.
-
-   Our Makefiles require GNU make (called gmake in this document) and
-   also assume that "install" accepts BSD options. The INSTALL
-   variable in the Makefiles is set to the BSD-compatible version of
-   install. On some systems, you will have to find a BSD-compatible
-   install to the location of this program. (eg. bsdinst, which comes
-   with the MIT X Window System distribution) 
-
-   In the simplest version, you can just do the following:
-
-     % cd src
-     % ./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
-                       
-     --enable-cassert  Enables ASSERT_CHECKING (default)
-
-     --disable-cassert Disables ASSERT_CHECKING
-                       
-     --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 
+To upgrade to PostgreSQL v6.1 do the following:
+----------------------------------------------
+
+  1) Read any last minute information and platform specific porting
+     notes.  There are some platform specific notes at the end of this
+     file for Ultrix4.x, Linux, BSD/OS and NeXT.  There are other
+     files in directory /usr/src/pgsql/doc, including platform specific
+     notes for Irix and Linux.  Also look in directory
+     ftp://ftp.postgresql.org/pub.
+
+  2) Create account postgres if it does not already exist.
+
+  3) Log into account postgres.
+
+  4) Ftp file ftp://ftp.postgresql.org/pub/postgresql-v6.1.tar.gz from the
+     internet.
+
+  5) Some platforms, like Linux and BSD/OS use flex.  If your system uses
+     flex then make sure you have a good version.  Type
+        flex -- version
+
+     If the version is 2.5.2 or 2.5.4 or greater then you are okay.  If it
+     is 2.5.3 or before 2.5.2 then you will have to upgrade flex.  You may
+     get it at ftp://prep.ai.mit.edu/pub/gnu/flex-2.5.4.tar.gz.
+
+     To install it, type the following:
+        cd
+        gunzip -c flex-2.5.4.tar.gz | tar xvf -
+        cd flex-2.5.4
+        configure --prefix=/usr
+        make
+        make check
+        # You must be root when typing the next line.
+        make install
+        cd
+        rm -rf flex-2.5.4
+
+     This will update files /usr/man/man1/flex.1, /usr/bin/flex,
+     /usr/lib/libfl.a, /usr/include/FlexLexer.h and will add link
+     /usr/bin/flex++ which points to flex.
+
+     If you have flex v2.5.3 and do not have handy access to the
+     internet, you can apply the patch in /usr/src/pgsql/doc/README.flex
+     instead.
+
+  6) If you are upgrading an existing system then back up the current
+     database.  Type
+        cd
+        pg_dumpall > db.out
+     If you wish to preserve object id's (oids), type
+        cd
+        pg_dumpall -o > db.out
+     instead.  However, unless you have a special reason for doing this,
+     don't do it.
+
+     Please note that if you are upgrading from a version prior to
+     Postgres95 v1.09 then you must back up your database, install
+     Postgres95 v1.09, restore your database, then back it up again.
+
+  7) If you are upgrading an existing system then kill the postmaster.  Type
+       ps -ax | grep postmaster
+     This should list the process numbers for a number of processes.  Type
+     the following line, with "???" replaced by the process id for process
+     "postmaster".  (Do not use the id for process "grep postmaster".)  Type
+       kill ???
+     with "???" modified as indicated.
+
+     You must make sure that your database is not updated in the middle of
+     your backup.  If necessary, bring down postmaster, edit the permissions
+     in file /usr/local/pgsql/data/pg_hba.conf to allow only you on, then
+     bring postmaster back up.
+
+  8) If you are upgrading an existing system then move the old directories
+     out of the way.  If you are short of disk space then you may have to
+     back up and delete the directories instead.  If you do this, save the
+     old database in the /usr/local/pgsql/data directory tree.  At a
+     minimum, save file /usr/local/pgsql/data/pg_hba.conf.
+
+     Type the following:
+        su
+        cd /usr/src
+        mv pgsql pgsql_6_0
+        cd /usr/local
+        mv pgsql pgsql_6_0
+        exit
+
+     If you are not using /usr/local/pgsql/data as your data directory
+     (check to see if environment variable PGDATA is set to something
+     else) then you will also want to move this directory in the same
+     manner.
+
+  9) Make new source and install directories.  Type
+        su
+        cd /usr/src
+        mkdir pgsql
+        chown postgres pgsql
+        chgrp postgres pgsql
+        cd /usr/local
+        mkdir pgsql
+        chown postgres pgsql
+        chgrp postgres pgsql
+        exit
+
+ 10) Unzip and untar the new source file.  Type
+        cd /usr/src/pgsql
+        gunzip -c ~/postgresql-v6.1.tar.gz | tar xvf -
+
+ 11) Configure the source code for your system.  Type
+        cd /usr/src/pgsql/src
+        ./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
+
+       --enable-cassert   Enables ASSERT_CHECKING (default)
+
+       --disable-cassert  Disables ASSERT_CHECKING
+               
+       --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
-   successfully made.  Ready to install."  If you don't get that, the make
-   failed, and there should be error messages at the end detailing why.
-
-4. Install PostgreSQL
-
-   Installing just means placing all the files built in the previous step
-   into their live locations on your system. 
+     Of course, in a real shell, you would type these three lines all
+     on the same line.
+
+ 12) If you plan to run the regression tests, then turn off the genetic
+     (GEQ) optimizer.  Edit file /usr/src/pgsql/src/include/config.h
+     to comment out the line containing "#define GEQ" near the end of
+     the file.
+
+ 13) Compile the program.  Type
+        cd /usr/src/pgsql/src
+        gmake all &> make.log &
+        tail -f make.log
+     The last line displayed will hopefully be "All of PostgreSQL is
+     successfully made. Ready to install."  At this point, or earlier
+     if you wish, type control-C to get out of tail.  (If you have
+     problems later on you may wish to examine file make.log for
+     warning and error messages.)
+
+     If your computer does not have gmake (GNU make) then try running
+     make instead throughout the rest of these notes.
+
+     Please note that you will probably find a number of warning
+     messages in make.log.  Unless you have problems later on, these
+     messages may be safely ignored.
+
+ 14) Install the program.  Type
+        cd /usr/src/pgsql/src
+        gmake install &> make.install.log &
+        tail -f make.install.log
+     The last line displayed will be "gmake[1]: Leaving directory
+     `/usr/src/pgsql/src/man'".  At this point, or earlier if you wish,
+     type control-C to get out of tail.
+
+ 15) If necessary, tell UNIX how to find your shared libraries.  If you
+     are using Linux-ELF do ONE of the following, preferably the first:
+
+       a) As root, edit file /etc/ld.so.conf.  Add line
+             /usr/local/pgsql/lib
+          to the file.  Then run command /sbin/ldconfig.
+
+       b) In a bash shell, type
+             export LD_LIBRARY_PATH=/usr/local/pgsql/lib
+
+       c) In a csh shell, type
+             setenv LD_LIBRARY_PATH /usr/local/pgsql/lib
+
+     Please note that the above commands may vary wildly for different
+     operating systems.  Check the platform specific notes, such as
+     those for Ultrix4.x or and for non-ELF Linux.
+
+     If, when you create the database, you get the message "pg_id: can't
+     load library 'libpq.so'" then the above step was necessary.  Simply
+     do this step, then try to create the database again.
+
+ 16) If it has not already been done, then prepare account postgres
+     for using PostgreSQL.  Any account that will use PostgreSQL must
+     be similarily prepared.  (The following instructions are for a
+     bash shell.  Adapt accordingly for other shells.)
+
+     Add the following lines to your login shell, ~/.bash_profile:
+        PATH=$PATH:/usr/local/pgsql/bin
+        MANPATH=/usr/local/pgsql/man
+        PGLIB=/usr/local/pgsql/lib
+        PGDATA=/usr/local/pgsql/data
+        export PATH MANPATH PGLIB PGDATA
+
+     Make sure that you have defined these variables before continuing
+     with the remaining steps.  The easiest way to do this is to type:
+        source ~/.bash_profile
+
+ 17) Create the database.  DO NOT DO THE FOLLOWING AS ROOT!  This would
+     be a major security hole.  Type
+        initdb
+
+ 18) Set up permissions to access the database system.  Do this by editing
+     file /usr/local/pgsql/data/pg_hba.conf.  The instructions are
+     included in the file.  (If your database is not located in the
+     default location, i.e. if PGDATA is set to point elsewhere, then the
+     location of this file will change accordingly.)  This file should be
+     made read only again once you are finsihed.
+
+     If you are upgrading from v6.0 you can copy file pg_hba.conf from
+     your old database on top of the one in your new database, rather than
+     redoing this from scratch.
+
+ 19) If you are going to skip the regression tests then skip to step number
+     24.  It is highly recommended that you do these tests in order to
+     make sure that PostgreSQL is working on your system.  However, running
+     them will probably increase your installation time by an hour or so.
+
+     If you did not turn off the genetic optimizer (GEQ) before compiling
+     then you should skip the regression tests.
+
+ 20) Log into a second shell as user postgres.  Set the timezone for Berkley,
+     California.  On some systems you may do this by setting environment
+     variable TZ.  I.e., using bash, type
+        export TZ=PST8PDT7,M04.01.0,M10.0503
+     Now run postmaster by typing
+        postmaster
+     Leave this program running until after you finish running the regression
+     tests in the other shell.  DO NOT RUN POSTMASTER FROM THE ROOT ACCOUNT.
+
+ 21) Run the regression tests.  From the first shell type
+
+        cd /usr/src/pgsql/src/test/regress
+        gmake clean
+        gmake all runtest
+
+     You do not need to type "gmake clean" if this is the first time you
+     are running the tests.
+
+     You should get on the screen (and also written to file ./regress.out)
+     a series of statements stating which tests passed and which tests
+     failed.  Currently, tests sanity_check, float8, select and misc fail.
+     (This may change between the time this note was written and the final
+     release of v6.1.)  See the notes in file README for more detailed
+     explanations.
+
+     If you wish to know why some of the tests failed, you may use diff
+     to compare the files in directories ./results and ./expected.
+
+     If you did not set the timezone as indicated above or if you did not
+     disable the genetic optimizer (GEQ) as described in step 8 then you
+     will get a lot of failures.
+
+     After running the tests, type
+        cd /usr/src/pgsql/src/test/regress
+        gmake clean
+
+ 22) In the other window that is running postmaster, press control-C to
+     stop the process.  Restore the timezone to normal.  (If you simply
+     set TZ for this one shell, this is as simple of logging out of the
+     shell.)
+
+ 23) Recompile the back end with the genetic optimizer (GEQ) turned on.
+     This is not necessary but is highly recommended if you plan to use
+     large databases.
+
+     Go and restore file /usr/src/pgsql/src/include/config.h to the
+     original state where "#define GEQ" is not commented out.
+
+     Type the following:
+        cd /usr/src/pgsql/src
+        gmake all &> make2.log &
+        tail -f make2.log
+        # Once compiling is done, control-C out of tail.
+        cd /usr/src/pgsql/src
+        gmake install &> make.install2.log &
+        tail -f make.install2.log
+        # Once compiling is done, control-C out of tail.
+
+ 24) If you were skipping the regression tests then you skipped steps 20
+     to 23 and continued here.
+
+ 25) Start the postmaster daemon running.  Type
+        cd
+        nohup postmaster > server.log 2>&1 &
+     Run postmaster from your postgres super user account.  DO NOT RUN
+     POSTMASTER FROM THE ROOT ACCOUNT.
+
+ 26) If you haven't already done so, this would be a good time to modify
+     your computer so that it will automatically start postmaster whenever
+     you boot your computer.
+
+     Here are some suggestions on how to do this, contributed by various
+     users.
+
+     Whatever you do, postmaster must be run by user postgres, AND NOT BY
+     ROOT.  This is why all of the examples below start by switching user
+     (su) to postgres.  These commands also take into account the fact
+     that environment variables like PATH and PGDATA may not be set properly.
+
+     The examples are as follows.  Use them with extreme caution.
+
+       a) Edit file rc.local on NetBSD or file rc2.d on SPARC Solaris
+          2.5.1 to contain the following single line:
+             su postgres -c "/usr/local/pgsql/bin/postmaster -S -D
+                     /usr/local/pgsql/data"
+
+       b) In RedHat v4.0 Linux edit file /etc/inittab to contain the
+          following single line:
+             pg:2345:respawn:/bin/su - postgres -c
+                     "/usr/local/pgsql/bin/postmaster -D/usr/local/pgsql/data
+                     >> /usr/local/pgsql/server.log 2>&1" /dev/null
+          (The author of this example says this example will revive the
+          postmaster if it dies, but he doesn't know if there are other side
+          effects.)
+
+       c) In FreeBSD edit an unspecified file that will, on boot up, run
+          a file containing the short line followed by the following single
+          line:
+             #!/bin/sh
+             [ -x /usr/local/pgsql/bin/postmaster ] && su -l pgsql -c
+                     '/usr/local/pgsql/bin/postmaster -D/usr/local/pgsql/data
+                     -o -F > /usr/local/pgsql/errlog &' && echo -n ' pgsql'
+
+       d) In RedHat v4.0 Linux edit an unspecified file to contain the
+          following single line:
+             su -c "cd ~postgres; nohup /usr/local/pgsql/bin/postmaster
+                     -D /usr/local/pgsql/data  > server.log 2>&1 &" postgres
+
+     You might also want to modify your computer so that cron will run
+     the vacuum command nightly.
+
+ 27) If you are upgrading an existing system then install your old database.
+     Type
+        cd
+        psql -e template1 < db.out
+
+ 28) If you are a new user, you may wish to play with postgres as described
+     below.
+
+ 29) Clean up after yourself.  Type
+        rm -rf /usr/src/pgsql_6_0
+        rm -rf /usr/local/pgsql_6_0
+        # Also delete old database directory tree if it is not in
+        #  /usr/local/pgsql_6_0/data
+        rm ~/postgresql-v6.1.tar.gz
+
+ 30) You will probably want to print out the documentation.  Here is how
+     you might do it if you have Ghostscript on your system and are
+     writing to a laserjet printer.
+        alias gshp='gs -sDEVICE=laserjet -r300 -dNOPAUSE'
+        export GS_LIB=/usr/share/ghostscript:/usr/share/ghostscript/fonts
+        # Print out the man pages.
+        man -a -t /usr/local/pgsql/man/*/* > manpage.ps
+        gshp -sOUTPUTFILE=manpage.hp manpage.ps
+        rm manpage.ps
+        lpr -l -s -r manpage.hp
+        # Print out the Postgres95 User Manual, version 1.0,
+        #  Sept. 5, 1996.
+        cd /usr/src/pgsql/doc
+        gshp -sOUTPUTFILE=userguide.hp userguide.ps
+        lpr -l -s -r userguide.hp
+
+     If you are a developer, you will probably want to also print out
+     the Postgres Implemention Guide, version 1.0, October 1, 1995.
+     This is a WWW document located at
+     http://www.postgresql.org/docs/impguide.
+
+ 31) Now create, access and manipulate databases as desired.  Write client
+     programs to access the database server.  In other words, ENJOY!
 
-     % gmake install
-
-   This will narrate all the files being installed.  You should watch and 
-   be sure the files are going to reasonable places and confirm for yourself
-   that they ended up where they belong.
-
-   Any error messages indicate something is wrong and you probably have to
-   correct it before PostgreSQL will work.
-
-
-HOW TO CREATE A DATABASE SYSTEM
--------------------------------
-
-Once you have Postgres installed, you'll need at least one database system
-on which to operate.  A database system is a collection of databases that
-are used together and fall under a single authority.  You can have as many
-database systems as you want on a single unix system.
-
-You select a unix user to be the "postgres superuser" for a database
-system and that user, for one thing, owns all the unix files that hold
-all the data for that database system.  It is usually a good idea to create
-a user for the sole purpose of being a postgres superuser.
-
-WARNING: PostgreSQL is not secure.  Anyone who can connect to a database
-system can easily assume all the unix privileges of its Postgres
-superuser.  The simplest way is by creating and running a C language
-function.  There are plans to remedy this in future developent.
-
-The program initdb (part of Postgres) is what initializes (creates) a
-database system.  Initdb uses the defaults specified in Makefile.global
-or Makefile.custom. See the man page for initdb for more information.
-
-  % initdb --pgdata=/usr/local/pgsql/data --pglib=/usr/local/pgsql/lib
-
-By default, the user issuing the initdb command becomes the Postgres
-superuser, and only the unix superuser can specify any other user as the
-Postgres superuser.
-
-Setting up Permissions
-----------------------
-
-The first thing you should do after creating a database system is set up
-the permissions for connecting to the database.  These are kept in the 
-file pg_hba.conf in the lib directory.  Initdb creates a sample version of
-this file, which contains comments telling you how to set it up.
-
-The Postmaster Daemon
----------------------
-
-Finally, in order to use the database system, you'll need to have a
-postmaster daemon running.  There is one postmaster process per database
-system.  The postmaster runs the program "postgres" and must run as the
-Postgres superuser.  See the postgres man page.
-
-So, for example, you can login as the Postgres superuser and issue the
-command:
-
-  $ nohup postmaster -D/usr/local/pgsql/data >server.log 2>&1 &
-
-This says to run the postmaster against the database system created
-above.
-
-This is a good daemon to start via system startup scripts, using su (be
-careful NOT to run the postmaster as the unix superuser by mistake).
-
-
-TESTING POSTGRESQL
-------------------
-
-We suggest you run the regression tests to make sure the release was
-installed successfully and works as designed in your environment.  The
-regression tests can be found in src/test/regress. (see
-src/test/regress/README for more details)
-
-     % cd /usr/src/pgsql/src/test/regress
-     % gmake all runtest
-
-This will run a whole slew of regression tests and might take an hour
-to run.  
 
 PLAYING WITH POSTGRESQL
 -----------------------
@@ -263,13 +496,13 @@ template1=> CREATE DATABASE FOO;
 INSERT 773248
 
 (Don't ever forget those SQL semicolons.  Psql won't execute anything until it
-sees the semicolon).
+sees the semicolon.)
 
 template1=> \c foo
 closing connection to database: template1
 connecting to new database: foo
 
-(\ commands aren't SQL, so no semicolon.  Use \? to see all the \ commands).
+(\ commands aren't SQL, so no semicolon.  Use \? to see all the \ commands.)
 
 template1=> CREATE TABLE bar (column1 int4, column2 char16);
 CREATE
@@ -281,57 +514,18 @@ template1=> \d bar
 You get the idea.
 
 
+QUESTIONS?  BUGS?  FEEDBACK?
+----------------------------
 
-QUESTIONS? BUGS? FEEDBACK?
---------------------------
-
-First, please read the Frequently Asked Questions and answers in the file
-called FAQ.
-
-If you still have questions, please send them to:
-questions@postgreSQL.org
-
-If you have a bug report to make, please send a filled out version of
-the file named "bug.template" to bugs@postgreSQL.org.
-
-If you would like to help out with the development and maintenance of
-PostgreSQL, send subscribe to the developers mailing list.  See
-README.support for more information
-
-----------------------------------------------------------------------
-
-Porting Notes:
--------------
-Ultrix4.x:
-       You need to install the libdl-1.1 package since Ultrix 4.x doesn't
-       have a dynamic loader. It's available in
-          s2k-ftp.CS.Berkeley.EDU:pub/personal/andrew/libdl-1.1.tar.Z
-
-Linux:
-       The linux port defaults to the ELF binary format. (Note that if you're
-       using ELF, you don't need dld because you'll be using the dl library
-       that comes with Linux ELF instead.)
+First, read files doc/FAQ in directory /usr/src/pgsql.  The latest version
+of the FAQ may be found at http://www.postgresql.org/ under documentation.
 
-       To compile on non-ELF Linux, comment out the LINUX_ELF line in
-       src/mk/port/postgres.mk.linux. Also, the dld library MUST be obtained
-       and installed on the system. It enables dynamic link loading capability
-       to the postgres port. The dld library can be obtained from the sunsite
-       linux distributions. The current name is dld-3.2.5.
-                               (Jalon Q. Zimmerman 
-                               <sneaker@powergrid.electriciti.com> 5/11/95)
+If PostgreSQL failed to compile on your computer then fill out the form
+in file /usr/src/pgsql/doc/bug.template and mail it to
+pgsql-ports@postgresql.org.
 
-       To compile with flex, you need a recent version (2.5.2 or
-       later). Otherwise, you will get a 'yy_flush_buffer' undefined error.
-        Note, however, that flex v2.5.3 has a bug. See the FAQs.
+Mail questions to pgsql-questions@postgresql.org.  For more information
+on the various mailing lists, see http://www.postgresql.org under mailing
+lists.
 
-BSD/OS:
-       For BSD/OS 2.0 and 2.01, you will need to get flex version 2.5.2
-       as well as the GNU dld library.  Flex version 2.5.3 has a known bug.
 
-NeXT: 
-       The NeXT port was supplied by Tom R. Hageman <tom@basil.icce.rug.nl>.
-       It requires a SysV IPC emulation library and header files for 
-        shared libary and semaphore stuff.   Tom just happens to sell such 
-        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.