Fix up INSTALL file

From Andrew
This commit is contained in:
Marc G. Fournier 1996-10-30 06:01:55 +00:00
parent f59a46a8c8
commit 6ada9dfdce
1 changed files with 35 additions and 33 deletions

68
INSTALL
View File

@ -1,19 +1,19 @@
POSTGRES95 INSTALLATION INSTRUCTIONS
POSTGRESQL INSTALLATION INSTRUCTIONS
Copyright (c) 1996 Regents of the University of California
This directory contains the source and documentation for Postgres95
(version 2) Postgres95 is a derivative of POSTGRES 4.2 (the last
This directory contains the source and documentation for PostgreSQL
(version 1.09) PostgreSQL is a derivative of POSTGRES 4.2 (the last
release of the UC Berkeley research project). For copyright terms for
postgres95, 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
list. Version 1 (through 1.01) was developed by Jolly Chen and Andrew
Yu.
REQUIREMENTS TO RUN POSTGRES95
REQUIREMENTS TO RUN POSTGRESQL
------------------------------
Postgres95 has been tested on the following platforms:
PostgreSQL has been tested on the following platforms:
alpha - DEC Alpha AXP on OSF/1 2.0
hpux - HP PA-RISC on HP-UX 9.0
@ -33,33 +33,33 @@ Postgres95 has been tested on the following platforms:
next - Motorola MC68K or Intel x86 on NeXTSTEP 3.2
but these are guaranteed not to work as of yet.
Postgres95 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.
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
---------------------------------
MIGRATING FROM POSTGRES VERSION 1.0
-----------------------------------
Version 2 is mostly backward compatible with Version 1, but the database
Version 1.02 is mostly backward compatible with Version 1.0, but the database
format is incompatible, so if you have databases that you use with Version
1, you need to convert them before you can use them with Version 2. Once
1, you need to convert them before you can use them with Version 1.02. Once
you do that, you won't be able to use them with Version 1 anymore.
For details on how to do this conversion, see the file MIGRATION_V1_TO_V2.
INSTALLING POSTGRES95
INSTALLING POSTGRESQL
---------------------
Installing Postgres95 encompasses only installing the software on your system
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.
To install Postgres95 on UNIX platforms:
To install PostgreSQL on UNIX platforms:
1. Unpack the source distribution into a source directory. We'll assume
"/usr/src/postgres95" in this discussion. This should be a new directory.
@ -68,11 +68,12 @@ To install Postgres95 on UNIX platforms:
cd /usr/src/postgres95
3. Build Postgres95:
3. Build PostgreSQL:
If you're installing Postgres95 on Ultrix 4.x or Linux, see the
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 Postgres95.
before installing PostgreSQL. For Linux and Irix, read the machine-
specific FAQs.
If using Linux or Irix, you should also read the machine-specific FAQs.
@ -84,12 +85,12 @@ To install Postgres95 on UNIX platforms:
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 Postgres95
the various configuration options here, such as where the PostgreSQL
executable files are installed and where postgres looks for the database
directory. 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 Postgres95 is being build
- PORTNAME specifies the platform on which PostgreSQL is being build
(BSD44_derived is the default). You might 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)
@ -97,7 +98,7 @@ To install Postgres95 on UNIX platforms:
- SRCDIR specifies where the source files are located. (defaults to
$(POSTGRESDIR)/src.)
- POSTGRESDIR specifies the top-level directory where Postgres95
- POSTGRESDIR specifies the top-level directory where PostgreSQL
binaries, header files, libraries, and databases are installed.
- NAMEDATALEN and OIDNAMELEN allows you to set the maximum length of
@ -108,14 +109,14 @@ To install Postgres95 on UNIX platforms:
- 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 postgres95 and can be found in the
readline is not supplied with PostgreSQL and can be found in the
usual ftp sites for GNU software.
- HBA specifies whether you wish to use host-based authentication
for postgres95. See the section "How to Create a Database System"
for PostgreSQL. See the section "How to Create a Database System"
for how to set up the HBA permissions if you decide to use HBA.
After editing src/Makefile.global, you are ready to compile Postgres95
After editing src/Makefile.global, you are ready to compile PostgreSQL
(it takes about 10 minutes on a 133Mhz Pentium running linux):
% cd src
@ -125,7 +126,7 @@ To install Postgres95 on UNIX platforms:
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 Postgres95
4. Install PostgreSQL
Installing just means placing all the files built in the previous step
into their live locations on your system.
@ -137,7 +138,7 @@ To install Postgres95 on UNIX platforms:
that they ended up where they belong.
Any error messages indicate something is wrong and you probably have to
correct it before Postgres95 will work.
correct it before PostgreSQL will work.
HOW TO CREATE A DATABASE SYSTEM
@ -153,7 +154,7 @@ 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: Postgres95 is not secure. Anyone who can connect to a database
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.
@ -203,7 +204,7 @@ 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 POSTGRES95
TESTING POSTGRESQL
------------------
We suggest you run the regression tests to make sure the release was
@ -226,13 +227,13 @@ 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 POSTGRES95
PLAYING WITH POSTGRESQL
-----------------------
After Postgres95 is installed, a database system is created, a postmaster
After PostgreSQL is installed, a database system is created, a postmaster
daemon is running, and the regression tests have passed, you'll want to
see Postgres95 do something. That's easy. Invoke the interactive interface
to Postgres95, psql, and start typing SQL:
see PostgreSQL do something. That's easy. Invoke the interactive interface
to PostgreSQL, psql, and start typing SQL:
% psql -p 5432 template1
@ -290,7 +291,7 @@ 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.
If you would like to help out with the development and maintenance of
postgres95, send subscribe to the developers mailing list. See
PostgreSQL, send subscribe to the developers mailing list. See
README.support for more information
----------------------------------------------------------------------
@ -317,6 +318,7 @@ Linux:
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.
BSD/OS:
For BSD/OS 2.0 and 2.01, you will need to get flex version 2.5.2
@ -327,7 +329,7 @@ NeXT:
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 postgres95 for NEXTSTEP will be made available to
binary releases of PostgreSQL for NEXTSTEP will be made available to
the general public. Contact Info@RnA.nl for information.