Fix up INSTALL file
From Andrew
This commit is contained in:
Marc G. Fournier
parent
f59a46a8c8
commit
6ada9dfdce
68
INSTALL
68
INSTALL
@ -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.
|
||||
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user