database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-07-21 16:02:15 +03:00
Code Activity

documentation updating to 6.0 release

Browse Source
This commit is contained in:
Bruce Momjian
1997-01-03 06:08:21 +00:00
parent 4f8db3eb4c
commit 461d22206f
4 changed files with 51 additions and 75 deletions
Download Patch File Download Diff File Expand all files Collapse all files

92
INSTALL
View File

@ -2,7 +2,7 @@ POSTGRESQL INSTALLATION INSTRUCTIONS
Copyright (c) 1996 Regents of the University of California Copyright (c) 1996 Regents of the University of California
This directory contains the source and documentation for PostgreSQL This directory contains the source and documentation for PostgreSQL
(version 1.09) PostgreSQL is a derivative of POSTGRES 4.2 (the last (version 6.0) PostgreSQL is a derivative of POSTGRES 4.2 (the last
release of the UC Berkeley research project). For copyright terms for release of the UC Berkeley research project). For copyright terms for
PostgreSQL, please see the file named COPYRIGHT. This version was PostgreSQL, please see the file named COPYRIGHT. This version was
developed by a team of developers on the postgres developers mailing developed by a team of developers on the postgres developers mailing
@ -15,23 +15,21 @@ REQUIREMENTS TO RUN POSTGRESQL
PostgreSQL has been tested on the following platforms: PostgreSQL has been tested on the following platforms:
alpha - DEC Alpha AXP on OSF/1 2.0 aix IBM on AIX 3.2.5
hpux - HP PA-RISC on HP-UX 9.0 alpha DEC Alpha AXP on OSF/1 2.0
i386_solaris - i386 Solaris BSD44_derived OSs derived from 4.4-lite BSD (NetBSD, FreeBSD)
sparc_solaris - SUN SPARC on Solaris 2.4 bsdi BSD/OS 2.0, 2.01, 2.1
sparc - SUN SPARC on SunOS 4.1.3 dgux DG/UX 5.4R3.10
ultrix4 - DEC MIPS on Ultrix 4.4 hpux HP PA-RISC on HP-UX 9.0
linux - Intel x86 on Linux 1.2 (or above) ELF or a.out i386_solaris i386 Solaris
BSD44_derived - OSs derived from 4.4-lite BSD (NetBSD, FreeBSD) irix5 SGI MIPS on IRIX 5.3
bsdi - BSD/OS 2.0 and 2.01 linux Intel x86 on Linux 1.2 and Linux ELF
bsdi_2_1 - BSD/OS 2.1 (For non-ELF Linux, see LINUX_ELF below).
aix - IBM on AIX 3.2.5 next Motorola MC68K or Intel x86 on NeXTSTEP 3.2
irix5 - SGI MIPS on IRIX 5.3 sparc_solaris SUN SPARC on Solaris 2.4
dgux - DG/UX 5.4R3.10 sunos4 SUN SPARC on SunOS 4.1.3
Some hooks are provided for svr4 Intel x86 on Intel SVR4
svr4 - Intel x86 on Intel SVR4 ultrix4 DEC MIPS on Ultrix 4.4
next - Motorola MC68K or Intel x86 on NeXTSTEP 3.2
but these are guaranteed not to work as of yet.
PostgreSQL is also known to work on a number of other platforms that the PostgreSQL is also known to work on a number of other platforms that the
authors have not personally tested. authors have not personally tested.
@ -40,18 +38,13 @@ 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. hold the source, binaries, and user databases.
MIGRATING FROM POSTGRES VERSION 1.0 MIGRATING FROM POSTGRES VERSION 1.*
----------------------------------- -----------------------------------
Version 1.01 and 1.02 (and above) are mostly backward compatible with Version People migrating data from earlier releases must dump the data under
1.0, but the database format is incompatible, so if you have databases that 1.09 and reload them under 6.0. The pg_dump utility is designed to do
you use with Version 1, you need to convert them before you can use them with this. It is important you use 1.09 because earlier releases may not
Version 1.02. Once you do that, you won't be able to use them with Version 1 have the proper copy format to load into the 6.0 database.
anymore.
For details on how to do this conversion, see the files doc/MIGRATION_1.0_to_1.01
and MIGRATION_to_1.02.1
INSTALLING POSTGRESQL INSTALLING POSTGRESQL
--------------------- ---------------------
@ -64,11 +57,11 @@ system to use it.
To install PostgreSQL on UNIX platforms: To install PostgreSQL on UNIX platforms:
1. Unpack the source distribution into a source directory. We'll assume 1. Unpack the source distribution into a source directory. We'll assume
"/usr/src/postgres95" in this discussion. This should be a new directory. "/usr/src/pgsql" in this discussion. This should be a new directory.
2. Set your current directory to the source directory: 2. Set your current directory to the source directory:
cd /usr/src/postgres95 cd /usr/src/pgsql
3. Build PostgreSQL: 3. Build PostgreSQL:
@ -102,12 +95,6 @@ To install PostgreSQL on UNIX platforms:
- POSTGRESDIR specifies the top-level directory where PostgreSQL - POSTGRESDIR specifies the top-level directory where PostgreSQL
binaries, header files, libraries, and databases are installed. binaries, header files, libraries, and databases are installed.
- NAMEDATALEN and OIDNAMELEN allows you to set the maximum length of
system identifiers (table names, function names, etc.) It
defaults to 32. You may alter this if you like, but be aware that
databases created with different NAMEDATALEN's do not
interoperate.
- USE_READLINE specifies whether you want to use the GNU readline and - USE_READLINE specifies whether you want to use the GNU readline and
history libraries for the psql interactive frontend program. GNU history libraries for the psql interactive frontend program. GNU
readline is not supplied with PostgreSQL and can be found in the readline is not supplied with PostgreSQL and can be found in the
@ -123,7 +110,7 @@ To install PostgreSQL on UNIX platforms:
% cd src % cd src
% gmake % gmake
The gmake ultimately issues the message "All of Postgres95 is The gmake ultimately issues the message "All of PostgreSQL is
successfully made. Ready to install." If you don't get that, the make 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. failed, and there should be error messages at the end detailing why.
@ -164,7 +151,7 @@ The program initdb (part of Postgres) is what initializes (creates) a
database system. Initdb uses the defaults specified in Makefile.global. database system. Initdb uses the defaults specified in Makefile.global.
See the man page for initdb for more information. See the man page for initdb for more information.
% initdb % initdb --pgdata=/usr/local/pgsql/data --pglib=/usr/local/pgsql/lib
By default, the user issuing the initdb command becomes the Postgres By default, the user issuing the initdb command becomes the Postgres
superuser, and only the unix superuser can specify any other user as the superuser, and only the unix superuser can specify any other user as the
@ -189,12 +176,10 @@ Postgres superuser. See the postgres man page.
So, for example, you can login as the Postgres superuser and issue the So, for example, you can login as the Postgres superuser and issue the
command: command:
% postmaster -S -D/usr/lib/postgres/postgres_data -p5432 $ nohup postmaster -D/usr/local/pgsql/data >server.log 2>&1 &
This says to run the postmaster against the database system created above, This says to run the postmaster against the database system created
to accept connections from users on the conventional TCP port 5432, and above.
(-S) to run in the background without issuing messages about normal
execution.
This is a good daemon to start via system startup scripts, using su (be 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). careful NOT to run the postmaster as the unix superuser by mistake).
@ -208,20 +193,16 @@ installed successfully and works as designed in your environment. The
regression tests can be found in src/test/regress. (see regression tests can be found in src/test/regress. (see
src/test/regress/README for more details) src/test/regress/README for more details)
% cd /usr/src/postgres95/src/test/regress % cd /usr/src/pgsql/test/regress
% gmake all runtest % gmake all runtest
This will run a whole slew of regression tests and might take a long time This will run a whole slew of regression tests and might take an hour
to run. When it's done, the output is in the file obj/regress.out. You to run. When it's done, the output is in the file obj/regress.out. You
can compare this to a sample run that we supply in the file can compare this to a sample run that we supply in the file
sample.regress.out. (You should get roughly the same output except for sample.regress.out. (You should get roughly the same output except for
some pathnames.) some pathnames.)
% diff obj/regress.out sample.regress.out % diff expected.out regress.out
The regression test takes about half an hour to run on a Sparc 10. You
may want to use 'grep -v' to remove unsignificant differences.
PLAYING WITH POSTGRESQL PLAYING WITH POSTGRESQL
----------------------- -----------------------
@ -231,15 +212,12 @@ daemon is running, and the regression tests have passed, you'll want to
see PostgreSQL do something. That's easy. Invoke the interactive interface see PostgreSQL do something. That's easy. Invoke the interactive interface
to PostgreSQL, psql, and start typing SQL: to PostgreSQL, psql, and start typing SQL:
% psql -p 5432 template1 $ psql template1
(psql has to open a particular database, but at this point the only one (psql has to open a particular database, but at this point the only one
that exists is the template1 database, which always exists. We will connect that exists is the template1 database, which always exists. We will connect
to it only long enough to create another one and switch to it). to it only long enough to create another one and switch to it).
Note that we have told psql to connect to Port 5432, which is what we told
the postmaster to listen on when we started it above.
The response from psql is: The response from psql is:
type \? for help on slash commands type \? for help on slash commands
@ -280,11 +258,11 @@ QUESTIONS? BUGS? FEEDBACK?
First, please read the Frequently Asked Questions and answers in the file First, please read the Frequently Asked Questions and answers in the file
called FAQ. called FAQ.
If you still have questions, please send them to If you still have questions, please send them to:
postgres95@postgres95.vnet.net. questions@postgreSQL.org
If you have a bug report to make, please send a filled out version of If you have a bug report to make, please send a filled out version of
the file named "bug.template" to pg95-dev@ki.net. the file named "bug.template" to hackers@postgreSQL.org.
If you would like to help out with the development and maintenance of If you would like to help out with the development and maintenance of
PostgreSQL, send subscribe to the developers mailing list. See PostgreSQL, send subscribe to the developers mailing list. See

6
README
View File

@ -1,13 +1,13 @@
POSTGRES95 Data Base Management System POSTGRES95 Data Base Management System
This directory contains the 2.0 release of Postgres95. See INSTALL for This directory contains the 6.0 release of PostgreSQL. See INSTALL for
the installation notes and HISTORY for the changes. the installation notes and HISTORY for the changes.
We also have a WWW home page located at: We also have a WWW home page located at:
http://www.ki.net/postgres95 http://www.postgreSQL.org
Postgres95 is not public domain software. It is copyrighted by the PostgreSQL is not public domain software. It is copyrighted by the
University of California but may be used according to the licensing University of California but may be used according to the licensing
terms of the the copyright below: terms of the the copyright below:

4
doc/bug.template
View File

@ -1,5 +1,5 @@
To report a bug, please complete the following form and send it by To report a bug, please complete the following form and send it by
email to pg95-dev@ki.net email to hackers@postgreSQL.org.
============================================================================ ============================================================================
POSTGRES95 BUG REPORT TEMPLATE POSTGRES95 BUG REPORT TEMPLATE
@ -16,7 +16,7 @@ System Configuration
Operating System (example: Linux 1.3.42 ELF) : Operating System (example: Linux 1.3.42 ELF) :
Postgres95 version (example: Postgres95-1.01) : Postgres95-1.02 PostgreSQL version (example: Postgres95-1.01) : PostgreSQL-6.0
Compiler used (example: gcc 2.7.0) : Compiler used (example: gcc 2.7.0) :

24
src/Makefile.global
View File

@ -7,7 +7,7 @@
# #
# #
# IDENTIFICATION # IDENTIFICATION
# $Header: /cvsroot/pgsql/src/Attic/Makefile.global,v 1.80 1996/12/30 23:19:23 bryanh Exp $ # $Header: /cvsroot/pgsql/src/Attic/Makefile.global,v 1.81 1997/01/03 06:07:18 momjian Exp $
# #
# NOTES # NOTES
# Essentially all Postgres make files include this file and use the # Essentially all Postgres make files include this file and use the
@ -45,23 +45,21 @@
# of the port. # of the port.
# The name of the port. Valid choices are: # The name of the port. Valid choices are:
# aix IBM on AIX 3.2.5
# alpha DEC Alpha AXP on OSF/1 2.0 # alpha DEC Alpha AXP on OSF/1 2.0
# hpux HP PA-RISC on HP-UX 9.0
# i386_solaris i386 Solaris
# sparc_solaris SUN SPARC on Solaris 2.4
# sunos4 SUN SPARC on SunOS 4.1.3
# ultrix4 DEC MIPS on Ultrix 4.4
# linux Intel x86 on Linux 1.2 and Linux ELF
# (For non-ELF Linux, see LINUX_ELF below).
# BSD44_derived OSs derived from 4.4-lite BSD (NetBSD, FreeBSD) # BSD44_derived OSs derived from 4.4-lite BSD (NetBSD, FreeBSD)
# bsdi BSD/OS 2.0, 2.01, 2.1 # bsdi BSD/OS 2.0, 2.01, 2.1
# aix IBM on AIX 3.2.5
# irix5 SGI MIPS on IRIX 5.3
# dgux DG/UX 5.4R3.10 # dgux DG/UX 5.4R3.10
# Some hooks are provided for # hpux HP PA-RISC on HP-UX 9.0
# svr4 Intel x86 on Intel SVR4 # i386_solaris i386 Solaris
# irix5 SGI MIPS on IRIX 5.3
# linux Intel x86 on Linux 1.2 and Linux ELF
# (For non-ELF Linux, see LINUX_ELF below).
# next Motorola MC68K or Intel x86 on NeXTSTEP 3.2 # next Motorola MC68K or Intel x86 on NeXTSTEP 3.2
# but these are guaranteed not to work as of yet. # sparc_solaris SUN SPARC on Solaris 2.4
# sunos4 SUN SPARC on SunOS 4.1.3
# svr4 Intel x86 on Intel SVR4
# ultrix4 DEC MIPS on Ultrix 4.4
# #
# Note that portname is defined here to be UNDEFINED to remind you # Note that portname is defined here to be UNDEFINED to remind you
# to change it in Makefile.custom. # to change it in Makefile.custom.