head	1.4;
access;
symbols;
locks
	marc:1.4; strict;
comment	@# @;


1.4
date	93.02.23.02.05.32;	author marc;	state Exp;
branches;
next	1.3;

1.3
date	93.02.17.02.49.56;	author marc;	state Exp;
branches;
next	1.2;

1.2
date	93.02.17.02.45.47;	author marc;	state Exp;
branches;
next	1.1;

1.1
date	93.02.17.02.38.04;	author marc;	state Exp;
branches;
next	;


desc
@quick and dirty setup information
@


1.4
log
@more info
@
text
@These are the quick setup instructions -- see doc/postgres-setup.cat
for more detail concerning this release.

Also, note that this distribution comes with a compiled and ready
to run installed system -- so unless your sure you want to recompile
the world, you might want to read the README first.

------

Building this version of POSTGRES requires a new version of make which
is distributed within this package.  By default, this make is installed
as the command "bmake" so that it does not conflict with the normal "make"
on your system.  The default location it is installed is
/usr/local/bin with supporting files in /usr/local/lib.  If you prefer
to have it installed elsewhere you can change it, as long as you 
make sure the target directory is in your shell PATH.  After "bmake" 
is installed and the other setup steps are finished, rebuilding the 
system (whole or in part) is simple and requires little more than 
typing "bmake install" where ever you are.  What follows is a step by 
step list to get this release up and running.


----------------

1)	Cd into the src/ directory and edit the file "Makefile.global".
	By default the PORTNAME is "ultrix4".  Change this to "sparc"
	if you are running on the sparcstation.  Also, if you do not
	want "bmake" installed into /usr/local/bin and /usr/local/lib,
	change the values of TOOLSBINDIR and TOOLSLIBDIR and make sure
	these directories exist.  Also, note it is not possible to move
	the bmake(1) library files after the bmake(1) executable is built
	since the pathname to the lib/ directory is hardcoded into the
	executable.  If you wish to move the library files elsewhere, you
	have to change TOOLSLIBDIR in the source and goto step 2) which
	makes and installs bmake(1).

	At this point you can also change where the postgres executable
	files are installed and where it looks for the database
	directory.

2)	Cd into src/tools/bmake and type

		make -f Makefile.boot

	You may get warning messages during this bootstapping process
	about "illegal combination of pointer and integer" -- just ignore them.
	This should compile and install the "bmake" program and
	its supporting files, including the postgres related
	makefile templates.  If all went well you will now be able
	to use the new make program by typing "bmake".

3)	In this same directory, now type

		bmake install

	This builds and installs the entire system.  The Makefiles
	contain directives for running all the underlying Makefiles
	in all the directories, so the whole this should unfold and
	compile beautifully and install to the target directory.  This
	would be a great opportunity to get some donuts and
	coffee.  Also, on the outside chance that things do not
	unfold quite as beautifully as we'd like -- i.e. if it's
	an awful ugly mess, it would be a good idea to save the results
	of the compile in a file.  If you run csh(1), you could type
		
		bmake install >& mk.log

	and if you run ksh(1) or sh(1), type

		bmake install > mk.log 2>&1

	This will save the results in the file "mk.log" so you
	can inspect it later.

4)	If all went well in 4, at this point you have successfully
	built an installed the postgres system.  Make sure you add
	the directory where the postgres executables were put to
	your shell PATH variable.  By default it installs into
	/usr/local/postgres/bin.  The last step is to initialize
	the database directory (/usr/local/postgres/data) by typing

		initdb

-----------------------------------------------------------------------

And that's it.  Now you can try typing "createdb foobar" to make
sure postgres can create databases for you.

This outlines the steps necessary to initially build and install postgres.
Now that this is done, if you change a source file and wish to rebuild
and install the system, all you need to do is 

	bmake install

in the corresponding directory and bmake will rebuild and install just
that part of the system.  Be aware that if you make substantive changes
that might change the system database cataloges, then you may have to
recreate your database directory by deleting the existing one and
reinstalling the entire system ("bmake install" in the src/ directory)
and doing "initdb" again.  Also, if you are a postgres developer, you
should make dependencies by running "bmake depend" at the top of the
src/ directory.

@


1.3
log
@typo
@
text
@d1 2
a2 2
** These are the quick setup instructions -- see doc/obj/postgres-setup.cat
** for more detail concerning this release.
d4 6
d13 1
a13 1
or your system.  The default location it is installed is
d30 6
a35 1
	these directories exist.
d38 1
a38 1
	fiels are installed and where it looks for the database
d45 2
d52 1
a52 16
3)	Cd back to src/ and type

		bmake localobj

	This creates an obj/ directory in every directory where there
	is a Makefile.  All compiler objects and temporary files are
	kept put there, which keeps the source directories clean.
	Later on when you rebuild parts of the systems, you should
	remember that all the .o's and targets are actually in the
	obj/ directory below.  The other reason we use obj/ directories
	is that the tree can actually be setup to provide a readonly
	NFS mountable source tree that clients can build off directly --
	but that is an option not discussed here (this is the quick and
	no-frills setup).

4)	In this same directory, now type
d75 1
a75 1
5)	If all went well in 4, at this point you have successfully
d79 2
a80 2
	/private/deval/postgres/bin.  The last step is to initialize
	the database directory (/private/devel/postgres/data) by typing
d100 3
a102 1
and doing "initdb" again.
@


1.2
log
@minor typo fixes
@
text
@d4 1
a4 1
Building this version of POSTGRGES requires a new version of make which
@


1.1
log
@Initial revision
@
text
@d1 3
d7 8
a14 8
or your system.  The default location it is installed in is
/usr/local/bin with supporting files in /usr/local/lib.  If you do
not like this you can change it, as long as you make sure the directory
is in your shell PATH.  After "bmake" is installed and the other setup
steps are finished, rebuilding the system (or parts thereof) is simple
and requires little more than typing "bmake install" whereever you
are.  What follows is a step by step list to get this release up and
running.
d26 2
a27 2
	You can also at this point change where postgres installs 
	it's executable files and where it looks for the database
d35 1
a35 1
	it's supporting files, including the postgres related
d100 1
a100 1
recreate your database direcory by deleting the existing one and
@
