From: David Friend <dfriend@atlsci.atlsci.com>

Subject: [PATCHES] INSTALL changes

This patch modifies the INSTALL file.  The changes are:
  - SPARC/Linux-ELF was added to the list of supported platforms.
    The special notes for it at the bottom of the file were removed.
  - Changed "database server" to "RDBMS database server".
  - Modified step 6 so that when you restore your database the
    tables will be owned by the original owners instead of the
    postgresql superuser.
  - Modified step 19 on diagnosing the regression tests for the
    SPARC Linux platform with a beta release.
  - Other minor changes.
This commit is contained in:
Marc G. Fournier 1997-05-26 00:43:41 +00:00
parent cf88367751
commit 8ab1271f09
1 changed files with 33 additions and 51 deletions

84
INSTALL
View File

@ -5,7 +5,7 @@ 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
PostgreSQL is an RDBMS 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
@ -49,6 +49,7 @@ PostgreSQL has been tested on the following platforms:
i386_solaris i386 Solaris
irix5 SGI MIPS on IRIX 5.3
linux Intel x86 on Linux 2.0 and Linux ELF
SPARC on 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
@ -82,7 +83,7 @@ To upgrade to PostgreSQL v6.1 do the following:
3) Log into account postgres.
4) Ftp file ftp://ftp.postgresql.org/pub/postgresql-v6.1.tar.gz from the
internet.
internet. Store it in your home directory.
5) Some platforms use flex. If your system uses flex then make sure
you have a good version. Type
@ -116,15 +117,20 @@ To upgrade to PostgreSQL v6.1 do the following:
/usr/bin/flex++ which points to flex.
6) If you are upgrading an existing system from any version before
version 6.1 beta release 970512 then back up the current
database. Type
version 6.1 beta release 970525 then back up the current
database. (If you don't mind the restored tables being owned by
the postgres account then you may use your current pg_dumpall
script instead of the new pg_dumpall script used below.) Type
(with the gunzip line and the following line typed as one line):
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.
gunzip -c postgresql-v6.1.tar.gz |
tar xvf - src/bin/pg_dump/pg_dumpall
chmod a+x src/bin/pg_dump/pg_dumpall
src/bin/pg_dump/pg_dumpall > db.out
rm -rf src
If you wish to preserve object id's (oids), then use the -o
option when running pg_dumpall. 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
@ -370,15 +376,22 @@ To upgrade to PostgreSQL v6.1 do the following:
in error handling for those math functions between this platform
and the original Sun (?) Postgres v4.2 development environment.
Here is an example from a SPARC/Linux-ELF platform (note that this is
for an "unsupported" platform). Using the 970516 beta version of
PostgreSQL v6.1 the following tests "failed". float8 and geometry
"failed" due to minor precision differences in floating point numbers.
timespan and horology had different values from the expected
"14 secs ago". datetime, abstime and tinterval had "GMT" for the time
zone rather than "PST" or "PDT". These differences were due to a
mis-typed string for the TZ environment variable from step (18).
select_views failed for unknown reasons.
Here is an example from the SPARC/Linux-ELF platform. Using the
970525 beta version of PostgreSQL v6.1 the following tests "failed".
float8 and geometry "failed" due to minor precision differences in
floating point numbers. float8 also "failed" due to a table being
printed out in place of the expected warning message of a floating
point number being out of range. timespan and horology fail
because of a bug on this platform that causes a timespan of
"14 secs ago" to be returned as "1 day 23 hours 59 mins 46 secs
ago". (If you don't intend to use the timespan data type, then
this will not be a problem for you.) datetime also fails due
to similar problems with the timespan data type. errors fail
due to a parsing error. (This bug was introduced within the
previous week, and is probably in the regression test itself.)
select_views produces massively different output, but the
differences are probably due to the same reasons the other tests
failed.
Conclusion? If you do see failures, try to understand the nature of
the differences and then decide if those differences will affect your
@ -592,14 +605,8 @@ Linux:
(Jalon Q. Zimmerman
<sneaker@powergrid.electriciti.com> 5/11/95)
To compile with flex, you need a recent version (v2.5.2 or v2.5.4 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.
BSD/OS:
For BSD/OS 2.0 and 2.01, you will need to get flex version 2.5.2 or
flex version 2.5.4 as well as the GNU dld library.
Flex version 2.5.3 has a known bug on all platforms.
For BSD/OS 2.0 and 2.01, you will need to get the GNU dld library.
NeXT:
The NeXT port was supplied by Tom R. Hageman <tom@basil.icce.rug.nl>.
@ -609,28 +616,3 @@ NeXT:
binary releases of PostgreSQL for NEXTSTEP will be made available to
the general public. Contact Info@RnA.nl for information.
SPARC Linux-elf:
There was not time to finish adding support for this in the v6.1
release. However, if you are running RedHat Linux v4.0 on a
SPARC platform then install flex v2.5.4 and tell configure you
have a "linux-elf" platform. After running "configure" and before
compiling PostgreSQL, make the following changes:
1) Edit src/GNUmakefile to comment out the call to lexflex and
the if-then-else test that follows it. (This may not be
necessary by the time v6.1 gets released.)
2) Edit src/Makefile.global to change "-O2" to "-O".
3) Edit src/backend/libpq/pqcomprim.c, near the start to replace
#ifdef HAVE_ENDIAN_H
# include <endian.h>
#endif
with
/*
#ifdef HAVE_ENDIAN_H
# include <endian.h>
#endif
*/
#define BYTE_ORDER LITTLE_ENDIAN
For more details, look in ftp://ftp.postgresql.org/pub/majordomo/ports
for a May 16, 1997 mail message called "regression tests on a
SPARC/Linux platform".