mirror of
https://github.com/postgres/postgres.git
synced 2025-04-22 23:02:54 +03:00
Added bug reporting guidelines
Some corrections in installation procedure
This commit is contained in:
parent
8e7764d9c2
commit
16ace63c6b
103
INSTALL
103
INSTALL
@ -1,18 +1,11 @@
|
|||||||
Installation instructions for PostgreSQL 7.0.
|
Installation instructions for PostgreSQL 7.0.
|
||||||
|
|
||||||
Commands were tested on RedHat Linux version 5.2 using the bash shell.
|
|
||||||
Except where noted, they will probably work on most systems. Commands like
|
|
||||||
ps and tar may vary wildly between platforms on what options you should use.
|
|
||||||
Use common sense before typing in these commands.
|
|
||||||
|
|
||||||
If you haven't gotten the PostgreSQL distribution, get it from
|
If you haven't gotten the PostgreSQL distribution, get it from
|
||||||
ftp.postgresql.org, then unpack it:
|
ftp.postgresql.org, then unpack it:
|
||||||
|
|
||||||
$ gunzip postgresql-7.0.tar.gz
|
gunzip postgresql-7.0.tar.gz
|
||||||
$ tar -xf postgresql-7.0.tar
|
tar -xf postgresql-7.0.tar
|
||||||
$ mv postgresql-7.0 /usr/src
|
mv postgresql-7.0 /usr/src
|
||||||
|
|
||||||
Again, these commands might differ on your system.
|
|
||||||
|
|
||||||
Before you start
|
Before you start
|
||||||
|
|
||||||
@ -22,7 +15,7 @@ systems you may find that GNU make is installed under the name "gmake". We
|
|||||||
will use that name from now on to indicate GNU make, no matter what name it
|
will use that name from now on to indicate GNU make, no matter what name it
|
||||||
has on your system. To test for GNU make enter
|
has on your system. To test for GNU make enter
|
||||||
|
|
||||||
$ gmake --version
|
gmake --version
|
||||||
|
|
||||||
If you need to get GNU make, you can find it at ftp://ftp.gnu.org.
|
If you need to get GNU make, you can find it at ftp://ftp.gnu.org.
|
||||||
|
|
||||||
@ -46,7 +39,7 @@ extra 20MB.
|
|||||||
|
|
||||||
To check for disk space, use
|
To check for disk space, use
|
||||||
|
|
||||||
$ df -k
|
df -k
|
||||||
|
|
||||||
Considering today's prices for hard disks, getting a large and fast hard
|
Considering today's prices for hard disks, getting a large and fast hard
|
||||||
disk should probably be in your plans before putting a database into
|
disk should probably be in your plans before putting a database into
|
||||||
@ -77,7 +70,7 @@ For a fresh install or upgrading from previous releases of PostgreSQL:
|
|||||||
You now need to back up your existing database. To dump your fairly
|
You now need to back up your existing database. To dump your fairly
|
||||||
recent post-6.0 database installation, type
|
recent post-6.0 database installation, type
|
||||||
|
|
||||||
$ pg_dumpall > db.out
|
pg_dumpall > db.out
|
||||||
|
|
||||||
If you wish to preserve object id's (oids), then use the -o option when
|
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
|
running pg_dumpall. However, unless you have a special reason for doing
|
||||||
@ -96,14 +89,18 @@ For a fresh install or upgrading from previous releases of PostgreSQL:
|
|||||||
backup. If necessary, bring down postmaster, edit the permissions in file
|
backup. If necessary, bring down postmaster, edit the permissions in file
|
||||||
/usr/local/pgsql/data/pg_hba.conf to allow only you on, then bring
|
/usr/local/pgsql/data/pg_hba.conf to allow only you on, then bring
|
||||||
postmaster back up.
|
postmaster back up.
|
||||||
|
|
||||||
3. If you are upgrading an existing system then kill the database server
|
3. If you are upgrading an existing system then kill the database server
|
||||||
now. Type
|
now. Type
|
||||||
|
|
||||||
$ ps ax | grep postmaster
|
ps ax | grep postmaster
|
||||||
|
|
||||||
This should list the process numbers for a number of processes, similar
|
or
|
||||||
to this:
|
|
||||||
|
ps -e | grep postmaster
|
||||||
|
|
||||||
|
(It depends on your system which one of these two works. No harm can be
|
||||||
|
done by typing the wrong one.) This should list the process numbers for
|
||||||
|
a number of processes, similar to this:
|
||||||
|
|
||||||
263 ? SW 0:00 (postmaster)
|
263 ? SW 0:00 (postmaster)
|
||||||
777 p1 S 0:00 grep postmaster
|
777 p1 S 0:00 grep postmaster
|
||||||
@ -112,20 +109,20 @@ For a fresh install or upgrading from previous releases of PostgreSQL:
|
|||||||
process postmaster (263 in the above case). (Do not use the id for the
|
process postmaster (263 in the above case). (Do not use the id for the
|
||||||
process "grep postmaster".)
|
process "grep postmaster".)
|
||||||
|
|
||||||
$ kill pid
|
kill pid
|
||||||
|
|
||||||
Tip: On systems which have PostgreSQL started at boot time,
|
Tip: On systems which have PostgreSQL started at boot time,
|
||||||
there is probably a startup file which will accomplish the
|
there is probably a startup file which will accomplish the
|
||||||
same thing. For example, on a Redhat Linux system one might
|
same thing. For example, on a Redhat Linux system one might
|
||||||
find that
|
find that
|
||||||
|
|
||||||
$ /etc/rc.d/init.d/postgres.init stop
|
/etc/rc.d/init.d/postgres.init stop
|
||||||
|
|
||||||
works.
|
works.
|
||||||
|
|
||||||
Also move the old directories out of the way. Type the following:
|
Also move the old directories out of the way. Type the following:
|
||||||
|
|
||||||
$ mv /usr/local/pgsql /usr/local/pgsql.old
|
mv /usr/local/pgsql /usr/local/pgsql.old
|
||||||
|
|
||||||
or replace your particular paths.
|
or replace your particular paths.
|
||||||
|
|
||||||
@ -134,7 +131,7 @@ For a fresh install or upgrading from previous releases of PostgreSQL:
|
|||||||
make choices about what gets installed. Change into the src
|
make choices about what gets installed. Change into the src
|
||||||
subdirectory and type:
|
subdirectory and type:
|
||||||
|
|
||||||
$ ./configure
|
./configure
|
||||||
|
|
||||||
followed by any options you might want to give it. For a first
|
followed by any options you might want to give it. For a first
|
||||||
installation you should be able to do fine without any. For a complete
|
installation you should be able to do fine without any. For a complete
|
||||||
@ -176,30 +173,32 @@ For a fresh install or upgrading from previous releases of PostgreSQL:
|
|||||||
|
|
||||||
5. Compile the program. Type
|
5. Compile the program. Type
|
||||||
|
|
||||||
$ gmake
|
gmake
|
||||||
|
|
||||||
The compilation process can take anywhere from 10 minutes to an hour.
|
The compilation process can take anywhere from 10 minutes to an hour.
|
||||||
Your milage will most certainly vary.
|
Your milage will most certainly vary. Remember to use GNU make.
|
||||||
|
|
||||||
The last line displayed will hopefully be
|
The last line displayed will hopefully be
|
||||||
|
|
||||||
All of PostgreSQL is successfully made. Ready to install.
|
All of PostgreSQL is successfully made. Ready to install.
|
||||||
|
|
||||||
Remember, "gmake" may be called "make" on your system.
|
|
||||||
|
|
||||||
6. Install the program. Type
|
6. Install the program. Type
|
||||||
|
|
||||||
$ gmake install
|
gmake install
|
||||||
|
|
||||||
7. Tell your system how to find the new shared libraries. How to do this
|
7. Tell your system how to find the new shared libraries. How to do this
|
||||||
varies between platforms. What tends to work everywhere is to set the
|
varies between platforms. What tends to work everywhere is to set the
|
||||||
environment variable LD_LIBRARY_PATH:
|
environment variable LD_LIBRARY_PATH:
|
||||||
|
|
||||||
$ LD_LIBRARY_PATH=/usr/local/pgsql/lib
|
LD_LIBRARY_PATH=/usr/local/pgsql/lib
|
||||||
$ export LD_LIBRARY_PATH
|
export LD_LIBRARY_PATH
|
||||||
|
|
||||||
You might want to put this into a shell startup file such as
|
on sh, ksh, bash, zsh or
|
||||||
~/.bash_profile.
|
|
||||||
|
setenv LD_LIBRARY_PATH /usr/local/pgsql/lib
|
||||||
|
|
||||||
|
on csh or tcsh. You might want to put this into a shell startup file
|
||||||
|
such as /etc/profile.
|
||||||
|
|
||||||
On some systems the following is the preferred method, but you must
|
On some systems the following is the preferred method, but you must
|
||||||
have root access. Edit file /etc/ld.so.conf to add a line
|
have root access. Edit file /etc/ld.so.conf to add a line
|
||||||
@ -211,7 +210,7 @@ For a fresh install or upgrading from previous releases of PostgreSQL:
|
|||||||
If in doubt, refer to the manual pages of your system. If you later on
|
If in doubt, refer to the manual pages of your system. If you later on
|
||||||
get a message like
|
get a message like
|
||||||
|
|
||||||
./psql: error in loading shared libraries
|
psql: error in loading shared libraries
|
||||||
libpq.so.2.1: cannot open shared object file: No such file or directory
|
libpq.so.2.1: cannot open shared object file: No such file or directory
|
||||||
|
|
||||||
then the above was necessary. Simply do this step then.
|
then the above was necessary. Simply do this step then.
|
||||||
@ -219,10 +218,10 @@ For a fresh install or upgrading from previous releases of PostgreSQL:
|
|||||||
8. Create the database installation. To do this you must log in to your
|
8. Create the database installation. To do this you must log in to your
|
||||||
PostgreSQL superuser account. It will not work as root.
|
PostgreSQL superuser account. It will not work as root.
|
||||||
|
|
||||||
$ mkdir /usr/local/pgsql/data
|
mkdir /usr/local/pgsql/data
|
||||||
$ chown postgres /usr/local/pgsql/data
|
chown postgres /usr/local/pgsql/data
|
||||||
$ su - postgres
|
su - postgres
|
||||||
$ /usr/local/pgsql/initdb -D /usr/local/pgsql/data
|
/usr/local/pgsql/initdb -D /usr/local/pgsql/data
|
||||||
|
|
||||||
The -D option specifies the location where the data will be stored. You
|
The -D option specifies the location where the data will be stored. You
|
||||||
can use any path you want, it does not have to be under the
|
can use any path you want, it does not have to be under the
|
||||||
@ -235,7 +234,7 @@ For a fresh install or upgrading from previous releases of PostgreSQL:
|
|||||||
9. The previous step should have told you how to start up the database
|
9. The previous step should have told you how to start up the database
|
||||||
server. Do so now.
|
server. Do so now.
|
||||||
|
|
||||||
$ /usr/local/pgsql/bin/postmaster -D /usr/local/pgsql/data
|
/usr/local/pgsql/bin/postmaster -D /usr/local/pgsql/data
|
||||||
|
|
||||||
This will start the server in the foreground. To make it detach to the
|
This will start the server in the foreground. To make it detach to the
|
||||||
background, use the -S.
|
background, use the -S.
|
||||||
@ -243,7 +242,7 @@ For a fresh install or upgrading from previous releases of PostgreSQL:
|
|||||||
10. If you are upgrading from an existing installation, dump your data back
|
10. If you are upgrading from an existing installation, dump your data back
|
||||||
in:
|
in:
|
||||||
|
|
||||||
$ /usr/local/pgsql/bin/psql < db.out
|
/usr/local/pgsql/bin/psql -d template1 -f db.out
|
||||||
|
|
||||||
You also might want to copy over the old pg_hba.conf file and any other
|
You also might want to copy over the old pg_hba.conf file and any other
|
||||||
files you might have had set up for authentication, such as password
|
files you might have had set up for authentication, such as password
|
||||||
@ -266,8 +265,8 @@ suggestions.
|
|||||||
|
|
||||||
* You probably want to install the man and HTML documentation. Type
|
* You probably want to install the man and HTML documentation. Type
|
||||||
|
|
||||||
$ cd /usr/src/pgsql/postgresql-7.0/doc
|
cd /usr/src/pgsql/postgresql-7.0/doc
|
||||||
$ gmake install
|
gmake install
|
||||||
|
|
||||||
This will install files under /usr/local/pgsql/doc and
|
This will install files under /usr/local/pgsql/doc and
|
||||||
/usr/local/pgsql/man. To enable your system to find the man
|
/usr/local/pgsql/man. To enable your system to find the man
|
||||||
@ -281,20 +280,16 @@ suggestions.
|
|||||||
Postscript files using a print filter, then to print the User's Guide
|
Postscript files using a print filter, then to print the User's Guide
|
||||||
simply type
|
simply type
|
||||||
|
|
||||||
$ cd /usr/local/pgsql/doc
|
cd /usr/local/pgsql/doc
|
||||||
$ gunzip -c user.ps.tz | lpr
|
gunzip -c user.ps.tz | lpr
|
||||||
|
|
||||||
Here is how you might do it if you have Ghostscript on your system and
|
Here is how you might do it if you have Ghostscript on your system and
|
||||||
are writing to a laserjet printer.
|
are writing to a laserjet printer.
|
||||||
|
|
||||||
$ alias gshp='gs -sDEVICE=laserjet -r300 -dNOPAUSE'
|
gunzip -c user.ps.gz | gs -sDEVICE=laserjet -r300 -q -dNOPAUSE -sOutputFile=- | lpr
|
||||||
$ export GS_LIB=/usr/share/ghostscript:/usr/share/ghostscript/fonts
|
|
||||||
$ gunzip user.ps.gz
|
|
||||||
$ gshp -sOUTPUTFILE=user.hp user.ps
|
|
||||||
$ gzip user.ps
|
|
||||||
$ lpr -l -s -r manpage.hp
|
|
||||||
|
|
||||||
If in doubt, confer your manuals or your local expert.
|
Printer setups can vary wildly from system to system. If in doubt,
|
||||||
|
consult your manuals or your local expert.
|
||||||
|
|
||||||
The Adminstrator's Guide should probably be your first reading if you
|
The Adminstrator's Guide should probably be your first reading if you
|
||||||
are completely new to PostgreSQL, as it contains information about how
|
are completely new to PostgreSQL, as it contains information about how
|
||||||
@ -352,3 +347,15 @@ suggestions.
|
|||||||
into production use. The file
|
into production use. The file
|
||||||
/usr/src/pgsql/postgresql-7.0/src/test/regress/README has detailed
|
/usr/src/pgsql/postgresql-7.0/src/test/regress/README has detailed
|
||||||
instructions for running and interpreting the regression tests.
|
instructions for running and interpreting the regression tests.
|
||||||
|
|
||||||
|
To start "playing around", set up the paths as explained above and start the
|
||||||
|
server. To create a database, type
|
||||||
|
|
||||||
|
createdb testdb
|
||||||
|
|
||||||
|
Then enter
|
||||||
|
|
||||||
|
psql testdb
|
||||||
|
|
||||||
|
to connect to that database. At the prompt you can enter SQL and start
|
||||||
|
experimenting.
|
||||||
|
@ -8,24 +8,15 @@
|
|||||||
</Para>
|
</Para>
|
||||||
</Abstract>
|
</Abstract>
|
||||||
|
|
||||||
<Para>
|
|
||||||
Commands were tested on RedHat Linux version 5.2 using the bash shell.
|
|
||||||
Except where noted, they will probably work on most systems. Commands
|
|
||||||
like <command>ps</command> and <command>tar</command> may vary wildly
|
|
||||||
between platforms on what options you should use.
|
|
||||||
<Emphasis>Use common sense</Emphasis> before typing in these commands.
|
|
||||||
</Para>
|
|
||||||
|
|
||||||
<Para>
|
<Para>
|
||||||
If you haven't gotten the <ProductName>PostgreSQL</ProductName> distribution,
|
If you haven't gotten the <ProductName>PostgreSQL</ProductName> distribution,
|
||||||
get it from <ULink url="ftp://ftp.postgresql.org">ftp.postgresql.org</ULink>,
|
get it from <ULink url="ftp://ftp.postgresql.org">ftp.postgresql.org</ULink>,
|
||||||
then unpack it:
|
then unpack it:
|
||||||
<ProgramListing>
|
<ProgramListing>
|
||||||
$ gunzip postgresql-7.0.tar.gz
|
gunzip postgresql-7.0.tar.gz
|
||||||
$ tar -xf postgresql-7.0.tar
|
tar -xf postgresql-7.0.tar
|
||||||
$ mv postgresql-7.0 /usr/src
|
mv postgresql-7.0 /usr/src
|
||||||
</ProgramListing>
|
</ProgramListing>
|
||||||
Again, these commands might differ on your system.
|
|
||||||
</Para>
|
</Para>
|
||||||
|
|
||||||
<Sect1>
|
<Sect1>
|
||||||
@ -41,7 +32,7 @@ $ mv postgresql-7.0 /usr/src
|
|||||||
<Application>make</Application>, no matter what name it has on your system.
|
<Application>make</Application>, no matter what name it has on your system.
|
||||||
To test for <acronym>GNU</acronym> <Application>make</Application> enter
|
To test for <acronym>GNU</acronym> <Application>make</Application> enter
|
||||||
<programlisting>
|
<programlisting>
|
||||||
$ <userinput>gmake --version</userinput>
|
<userinput>gmake --version</userinput>
|
||||||
</programlisting>
|
</programlisting>
|
||||||
If you need to get <acronym>GNU</acronym> <Application>make</Application>, you can
|
If you need to get <acronym>GNU</acronym> <Application>make</Application>, you can
|
||||||
find it at <ULink url="ftp://ftp.gnu.org">ftp://ftp.gnu.org</ULink>.
|
find it at <ULink url="ftp://ftp.gnu.org">ftp://ftp.gnu.org</ULink>.
|
||||||
@ -74,7 +65,7 @@ $ <userinput>gmake --version</userinput>
|
|||||||
<Para>
|
<Para>
|
||||||
To check for disk space, use
|
To check for disk space, use
|
||||||
<programlisting>
|
<programlisting>
|
||||||
$ df -k
|
df -k
|
||||||
</programlisting>
|
</programlisting>
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
@ -125,12 +116,12 @@ If you are not upgrading an existing system then skip to
|
|||||||
You now need to back up your existing database.
|
You now need to back up your existing database.
|
||||||
To dump your fairly recent post-6.0 database installation, type
|
To dump your fairly recent post-6.0 database installation, type
|
||||||
<programlisting>
|
<programlisting>
|
||||||
$ pg_dumpall > db.out
|
pg_dumpall > db.out
|
||||||
</programlisting>
|
</programlisting>
|
||||||
If you wish to preserve object id's (oids), then use the -o
|
If you wish to preserve object id's (oids), then use the -o
|
||||||
option when running <application>pg_dumpall</application>.
|
option when running <application>pg_dumpall</application>.
|
||||||
However, unless you have a
|
However, unless you have a
|
||||||
special reason for doing this (such as using OIDs as keys
|
special reason for doing this (such as using OIDs as keys
|
||||||
in tables), don't do it.
|
in tables), don't do it.
|
||||||
</Para>
|
</Para>
|
||||||
|
|
||||||
@ -164,8 +155,14 @@ then back it up again.
|
|||||||
<Para>
|
<Para>
|
||||||
If you are upgrading an existing system then kill the database server now. Type
|
If you are upgrading an existing system then kill the database server now. Type
|
||||||
<ProgramListing>
|
<ProgramListing>
|
||||||
$ ps ax | grep postmaster
|
ps ax | grep postmaster
|
||||||
</ProgramListing>
|
</ProgramListing>
|
||||||
|
or
|
||||||
|
<ProgramListing>
|
||||||
|
ps -e | grep postmaster
|
||||||
|
</ProgramListing>
|
||||||
|
(It depends on your system which one of these two works. No harm can be done
|
||||||
|
by typing the wrong one.)
|
||||||
This should list the process numbers for a number of processes, similar
|
This should list the process numbers for a number of processes, similar
|
||||||
to this:
|
to this:
|
||||||
<ProgramListing>
|
<ProgramListing>
|
||||||
@ -176,7 +173,7 @@ Type the following line, with <replaceable>pid</replaceable>
|
|||||||
replaced by the process id for process <literal>postmaster</literal>
|
replaced by the process id for process <literal>postmaster</literal>
|
||||||
(263 in the above case). (Do not use the id for the process "grep postmaster".)
|
(263 in the above case). (Do not use the id for the process "grep postmaster".)
|
||||||
<programlisting>
|
<programlisting>
|
||||||
$ kill <replaceable>pid</replaceable>
|
kill <replaceable>pid</replaceable>
|
||||||
</programlisting>
|
</programlisting>
|
||||||
</Para>
|
</Para>
|
||||||
|
|
||||||
@ -186,7 +183,7 @@ On systems which have <productname>PostgreSQL</productname> started at boot time
|
|||||||
is probably a startup file which will accomplish the same thing. For example, on a
|
is probably a startup file which will accomplish the same thing. For example, on a
|
||||||
Redhat Linux system one might find that
|
Redhat Linux system one might find that
|
||||||
<programlisting>
|
<programlisting>
|
||||||
$ /etc/rc.d/init.d/postgres.init stop
|
/etc/rc.d/init.d/postgres.init stop
|
||||||
</programlisting>
|
</programlisting>
|
||||||
works.
|
works.
|
||||||
</para>
|
</para>
|
||||||
@ -195,7 +192,7 @@ works.
|
|||||||
<Para>
|
<Para>
|
||||||
Also move the old directories out of the way. Type the following:
|
Also move the old directories out of the way. Type the following:
|
||||||
<programlisting>
|
<programlisting>
|
||||||
$ mv /usr/local/pgsql /usr/local/pgsql.old
|
mv /usr/local/pgsql /usr/local/pgsql.old
|
||||||
</programlisting>
|
</programlisting>
|
||||||
or replace your particular paths.
|
or replace your particular paths.
|
||||||
</Para>
|
</Para>
|
||||||
@ -209,7 +206,7 @@ you can specify your actual installation path for the build process
|
|||||||
and make choices about what gets installed. Change into the <filename>src</filename>
|
and make choices about what gets installed. Change into the <filename>src</filename>
|
||||||
subdirectory and type:
|
subdirectory and type:
|
||||||
<ProgramListing>
|
<ProgramListing>
|
||||||
$ ./configure
|
./configure
|
||||||
</ProgramListing>
|
</ProgramListing>
|
||||||
followed by any options you might want to give it. For a first installation
|
followed by any options you might want to give it. For a first installation
|
||||||
you should be able to do fine without any.
|
you should be able to do fine without any.
|
||||||
@ -287,10 +284,10 @@ For a complete list of options, type:
|
|||||||
<Para>
|
<Para>
|
||||||
Compile the program. Type
|
Compile the program. Type
|
||||||
<ProgramListing>
|
<ProgramListing>
|
||||||
$ gmake
|
gmake
|
||||||
</ProgramListing>
|
</ProgramListing>
|
||||||
The compilation process can take anywhere from 10 minutes to an hour.
|
The compilation process can take anywhere from 10 minutes to an hour.
|
||||||
Your milage will most certainly vary.
|
Your milage will most certainly vary. Remember to use GNU make.
|
||||||
</Para>
|
</Para>
|
||||||
|
|
||||||
<Para>
|
<Para>
|
||||||
@ -298,8 +295,6 @@ The last line displayed will hopefully be
|
|||||||
<programlisting>
|
<programlisting>
|
||||||
All of PostgreSQL is successfully made. Ready to install.
|
All of PostgreSQL is successfully made. Ready to install.
|
||||||
</programlisting>
|
</programlisting>
|
||||||
Remember, <Quote>gmake</Quote> may be called <Quote>make</Quote> on
|
|
||||||
your system.
|
|
||||||
</Para>
|
</Para>
|
||||||
</Step>
|
</Step>
|
||||||
|
|
||||||
@ -307,7 +302,7 @@ your system.
|
|||||||
<Para>
|
<Para>
|
||||||
Install the program. Type
|
Install the program. Type
|
||||||
<ProgramListing>
|
<ProgramListing>
|
||||||
$ gmake install
|
gmake install
|
||||||
</ProgramListing>
|
</ProgramListing>
|
||||||
</Para>
|
</Para>
|
||||||
</Step>
|
</Step>
|
||||||
@ -318,11 +313,16 @@ Tell your system how to find the new shared libraries. How to do this varies bet
|
|||||||
platforms. What tends to work everywhere is to set the environment variable
|
platforms. What tends to work everywhere is to set the environment variable
|
||||||
<envar>LD_LIBRARY_PATH</envar>:
|
<envar>LD_LIBRARY_PATH</envar>:
|
||||||
<programlisting>
|
<programlisting>
|
||||||
$ LD_LIBRARY_PATH=/usr/local/pgsql/lib
|
LD_LIBRARY_PATH=/usr/local/pgsql/lib
|
||||||
$ export LD_LIBRARY_PATH
|
export LD_LIBRARY_PATH
|
||||||
</programlisting>
|
</programlisting>
|
||||||
|
on sh, ksh, bash, zsh or
|
||||||
|
<programlisting>
|
||||||
|
setenv LD_LIBRARY_PATH /usr/local/pgsql/lib
|
||||||
|
</programlisting>
|
||||||
|
on csh or tcsh.
|
||||||
You might want to put this into a shell startup file such as
|
You might want to put this into a shell startup file such as
|
||||||
<filename>~/.bash_profile</filename>.
|
<filename>/etc/profile</filename>.
|
||||||
</Para>
|
</Para>
|
||||||
|
|
||||||
<Para>
|
<Para>
|
||||||
@ -338,7 +338,7 @@ Then run command <Command>/sbin/ldconfig</Command>.
|
|||||||
If in doubt, refer to the manual pages of your system. If you later on get
|
If in doubt, refer to the manual pages of your system. If you later on get
|
||||||
a message like
|
a message like
|
||||||
<programlisting>
|
<programlisting>
|
||||||
./psql: error in loading shared libraries
|
psql: error in loading shared libraries
|
||||||
libpq.so.2.1: cannot open shared object file: No such file or directory
|
libpq.so.2.1: cannot open shared object file: No such file or directory
|
||||||
</programlisting>
|
</programlisting>
|
||||||
then the above was necessary. Simply do this step then.
|
then the above was necessary. Simply do this step then.
|
||||||
@ -351,10 +351,10 @@ Create the database installation. To do this you must log in to your
|
|||||||
<ProductName>PostgreSQL</ProductName> superuser account. It will not
|
<ProductName>PostgreSQL</ProductName> superuser account. It will not
|
||||||
work as root.
|
work as root.
|
||||||
<ProgramListing>
|
<ProgramListing>
|
||||||
$ mkdir /usr/local/pgsql/data
|
mkdir /usr/local/pgsql/data
|
||||||
$ chown postgres /usr/local/pgsql/data
|
chown postgres /usr/local/pgsql/data
|
||||||
$ su - postgres
|
su - postgres
|
||||||
$ /usr/local/pgsql/initdb -D /usr/local/pgsql/data
|
/usr/local/pgsql/initdb -D /usr/local/pgsql/data
|
||||||
</ProgramListing>
|
</ProgramListing>
|
||||||
</Para>
|
</Para>
|
||||||
<Para>
|
<Para>
|
||||||
@ -372,7 +372,7 @@ superuser, you may have to log in as root temporarily to create the data directo
|
|||||||
The previous step should have told you how to start up the database server.
|
The previous step should have told you how to start up the database server.
|
||||||
Do so now.
|
Do so now.
|
||||||
<programlisting>
|
<programlisting>
|
||||||
$ /usr/local/pgsql/bin/postmaster -D /usr/local/pgsql/data
|
/usr/local/pgsql/bin/postmaster -D /usr/local/pgsql/data
|
||||||
</programlisting>
|
</programlisting>
|
||||||
This will start the server in the foreground. To make it detach to
|
This will start the server in the foreground. To make it detach to
|
||||||
the background, use the <option>-S</option>.
|
the background, use the <option>-S</option>.
|
||||||
@ -383,7 +383,7 @@ the background, use the <option>-S</option>.
|
|||||||
<para>
|
<para>
|
||||||
If you are upgrading from an existing installation, dump your data back in:
|
If you are upgrading from an existing installation, dump your data back in:
|
||||||
<programlisting>
|
<programlisting>
|
||||||
$ /usr/local/pgsql/bin/psql < db.out
|
/usr/local/pgsql/bin/psql -d template1 -f db.out
|
||||||
</programlisting>
|
</programlisting>
|
||||||
You also might want to copy over the old <filename>pg_hba.conf</filename>
|
You also might want to copy over the old <filename>pg_hba.conf</filename>
|
||||||
file and any other files you might have had set up for authentication, such
|
file and any other files you might have had set up for authentication, such
|
||||||
@ -421,8 +421,8 @@ and <filename>initdb</filename>.
|
|||||||
You probably want to install the <application>man</application> and
|
You probably want to install the <application>man</application> and
|
||||||
<acronym>HTML</acronym> documentation. Type
|
<acronym>HTML</acronym> documentation. Type
|
||||||
<ProgramListing>
|
<ProgramListing>
|
||||||
$ cd /usr/src/pgsql/postgresql-7.0/doc
|
cd /usr/src/pgsql/postgresql-7.0/doc
|
||||||
$ gmake install
|
gmake install
|
||||||
</ProgramListing>
|
</ProgramListing>
|
||||||
This will install files under <filename>/usr/local/pgsql/doc</filename>
|
This will install files under <filename>/usr/local/pgsql/doc</filename>
|
||||||
and <filename>/usr/local/pgsql/man</filename>. To enable your system
|
and <filename>/usr/local/pgsql/man</filename>. To enable your system
|
||||||
@ -439,20 +439,16 @@ a Postscript printer, or have your machine already set up to accept
|
|||||||
Postscript files using a print filter, then to print the User's Guide
|
Postscript files using a print filter, then to print the User's Guide
|
||||||
simply type
|
simply type
|
||||||
<programlisting>
|
<programlisting>
|
||||||
$ cd /usr/local/pgsql/doc
|
cd /usr/local/pgsql/doc
|
||||||
$ gunzip -c user.ps.tz | lpr
|
gunzip -c user.ps.tz | lpr
|
||||||
</programlisting>
|
</programlisting>
|
||||||
Here is how you might do it if you have Ghostscript on your system and are
|
Here is how you might do it if you have Ghostscript on your system and are
|
||||||
writing to a laserjet printer.
|
writing to a laserjet printer.
|
||||||
<programlisting>
|
<programlisting>
|
||||||
$ alias gshp='gs -sDEVICE=laserjet -r300 -dNOPAUSE'
|
gunzip -c user.ps.gz | gs -sDEVICE=laserjet -r300 -q -dNOPAUSE -sOutputFile=- | lpr
|
||||||
$ export GS_LIB=/usr/share/ghostscript:/usr/share/ghostscript/fonts
|
|
||||||
$ gunzip user.ps.gz
|
|
||||||
$ gshp -sOUTPUTFILE=user.hp user.ps
|
|
||||||
$ gzip user.ps
|
|
||||||
$ lpr -l -s -r manpage.hp
|
|
||||||
</programlisting>
|
</programlisting>
|
||||||
If in doubt, confer your manuals or your local expert.
|
Printer setups can vary wildly from system to system.
|
||||||
|
If in doubt, consult your manuals or your local expert.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<para>
|
<para>
|
||||||
@ -551,6 +547,21 @@ instructions for running and interpreting the regression tests.
|
|||||||
</listitem>
|
</listitem>
|
||||||
|
|
||||||
</itemizedlist>
|
</itemizedlist>
|
||||||
|
|
||||||
|
<Para>
|
||||||
|
To start <quote>playing around</quote>, set up the paths as explained above
|
||||||
|
and start the server. To create a database, type
|
||||||
|
<ProgramListing>
|
||||||
|
createdb testdb
|
||||||
|
</ProgramListing>
|
||||||
|
Then enter
|
||||||
|
<ProgramListing>
|
||||||
|
psql testdb
|
||||||
|
</ProgramListing>
|
||||||
|
to connect to that database. At the prompt you can enter SQL and start
|
||||||
|
experimenting.
|
||||||
|
</Para>
|
||||||
|
|
||||||
</Sect1>
|
</Sect1>
|
||||||
|
|
||||||
</Chapter>
|
</Chapter>
|
||||||
|
@ -73,6 +73,7 @@
|
|||||||
&about;
|
&about;
|
||||||
&info;
|
&info;
|
||||||
¬ation;
|
¬ation;
|
||||||
|
&bug-reporting;
|
||||||
&y2k;
|
&y2k;
|
||||||
&legal;
|
&legal;
|
||||||
|
|
||||||
|
@ -1,6 +1,7 @@
|
|||||||
<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
|
<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
|
||||||
|
|
||||||
<!entity about SYSTEM "about.sgml">
|
<!entity about SYSTEM "about.sgml">
|
||||||
|
<!entity bug-reporting SYSTEM "bug-reporting.sgml">
|
||||||
<!entity history SYSTEM "history.sgml">
|
<!entity history SYSTEM "history.sgml">
|
||||||
<!entity info SYSTEM "info.sgml">
|
<!entity info SYSTEM "info.sgml">
|
||||||
<!entity legal SYSTEM "legal.sgml">
|
<!entity legal SYSTEM "legal.sgml">
|
||||||
|
@ -1,6 +1,7 @@
|
|||||||
<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
|
<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
|
||||||
|
|
||||||
<!entity about SYSTEM "about.sgml">
|
<!entity about SYSTEM "about.sgml">
|
||||||
|
<!entity bug-reporting SYSTEM "bug-reporting.sgml">
|
||||||
<!entity history SYSTEM "history.sgml">
|
<!entity history SYSTEM "history.sgml">
|
||||||
<!entity info SYSTEM "info.sgml">
|
<!entity info SYSTEM "info.sgml">
|
||||||
<!entity legal SYSTEM "legal.sgml">
|
<!entity legal SYSTEM "legal.sgml">
|
||||||
|
Loading…
x
Reference in New Issue
Block a user