FAQs contributed for this release.

27 years ago · 39c02dfefa
parent 5b1b477cca
commit 39c02dfefa
2 changed files with 297 additions and 0 deletions
--- a/doc/FAQ_AIX
+++ b/doc/FAQ_AIX
@ -0,0 +1,51 @@
 From - Thu May 27 03:10:25 1999
 Received: from localhost (lockhart@localhost [127.0.0.1])
 	by localhost (8.8.7/8.8.7) with ESMTP id RAA08251
 	for <lockhart@localhost>; Wed, 26 May 1999 17:49:20 GMT
 Received: from apop-server.alumni.caltech.edu
 	by localhost with POP3 (fetchmail-4.7.9)
 	for lockhart@localhost (single-drop); Wed, 26 May 1999 17:49:20 +0000 (UTC)
 Received: from gandalf.telecom.at (gandalf.telecom.at [194.118.26.84])
 	by alumnus.caltech.edu (8.9.1/8.9.1) with ESMTP id KAA01676
 	for <lockhart@alumni.caltech.edu>; Wed, 26 May 1999 10:46:19 -0700 (PDT)
 Received: from sdexcgtw01.sd.spardat.at (sdexcgtw01.sd.spardat.at [172.18.99.31])
 	by gandalf.telecom.at (xxx/xxx) with ESMTP id MAA12220;
 	Wed, 26 May 1999 12:02:50 +0200
 Received: by sdexcgtw01.f000.d0188.sd.spardat.at with Internet Mail Service (5.5.2448.0)
 	id <K49AQPB3>; Wed, 26 May 1999 12:02:51 +0200
 Message-ID: <219F68D65015D011A8E000006F8590C60267B37B@sdexcsrv1.f000.d0188.sd.spardat.at>
 From: ZEUGSWETTER Andreas IZ5 <Andreas.Zeugswetter@telecom.at>
 To: "'Thomas Lockhart'" <lockhart@alumni.caltech.edu>
 Cc: "'hackers@postgresql.org'" <hackers@postgresql.org>
 Subject: AW: [HACKERS] Call for updates!
 Date: Wed, 26 May 1999 12:02:48 +0200
 MIME-Version: 1.0
 X-Mailer: Internet Mail Service (5.5.2448.0)
 Content-Type: text/plain
 X-UIDL: 220301b41f1310903e8d55cb7ecc5f4b
 X-Mozilla-Status: 8001
 X-Mozilla-Status2: 00000000
 > Hi. I'd like to update the ports list in the docs to include
 > references to v6.5 for the various platforms for which PostgreSQL-6.5b
 > has been tested.
 > 
 Current CVS (after pgindent) compiles and regresses ok on AIX 4.3.2 
 using the IBM compiler. It has the following problems:
 1. AIX has int8,int16,int32,int64 in /usr/include/inttypes.h 
 	--> configure fails to find snprintf support for int8 (because it
 includes stdio.h)
 	I feel this is an IBM problem. I changed my inttypes.h
 2. No AIX in Makefile.shlib --> plpgsql.so is not built / no rule.
 	a number of other platforms are also missing there
 	a working rule is often in Makefile.port, but only for a single
 object
 	not multiple, which plpgsql has.
 	The single object rule in Makefile.aix can be used to make a
 plpgsql.so
 	from libplpgsql.a. I built it manually.
 3. libpq++ does not work because xlC does not have the string type/class ? 
 Andreas
--- a/doc/FAQ_SCO
+++ b/doc/FAQ_SCO
@ -0,0 +1,246 @@
 =======================================================
 Frequently Asked Questions (FAQ) for PostgreSQL  V6.5
 SCO UnixWare and OpenServer Specific
 TO BE READ IN CONJUNCTION WITH THE NORMAL FAQ
 =======================================================
 last updated:           Tue May 25 12:00:00 PDT 1999
 current maintainer:     Andrew Merrill (andrew@compclass.com)
 original author:        Andrew Merrill (andrew@compclass.com)
 PostgreSQL 6.5 can be built on SCO UnixWare 7 and SCO OpenServer 5.
 On OpenServer, you can use either the OpenServer Development Kit or 
 the Universal Development Kit.
 However, some tweaking may be needed, as described below.
 Topics:
 *) Skunkware
 *) GNU Make
 *) C++ and libpq++
 *) Readline
 *) Using the UDK on OpenServer
 *) Shared Memory and SHMMAX
 *) Java and JDBC
 *) Reading the PostgreSQL man pages on UnixWare
 ***************************************************************************
 *) Skunkware
 You should locate your copy of the SCO Skunkware CD.  The Skunkware CD
 is included with UnixWare 7 and current versions of OpenServer 5.
 Skunkware includes ready-to-install versions of many popular programs that
 are available on the Internet.  For example, gzip, gunzip, GNU make, flex,
 and bison are all included.
 If you do not have this CD, the software on it
 is available via anonymous ftp from ftp.sco.com/skunkware.
 For UnixWare 7.1, this CD is now labeled "Open License Software Supplement".
 Skunkware has different versions for UnixWare and
 OpenServer.  Make sure you install the correct version for your
 operating system, except as noted below.
 ***************************************************************************
 *) GNU Make
 You need to use the GNU make program, which is on the Skunkware CD.
 By default, it installs as /usr/local/bin/make.  To avoid confusion
 with the SCO make program, you may want to rename GNU make to gmake.
 ***************************************************************************
 *) C++ and libpq++
 I have not been able to build libpq++, the PostgreSQL C++ interface, with
 the UnixWare or OpenServer C++ compilers.  By default, building PostgreSQL
 also builds the libpq++ interface.  When that fails, it causes the entire
 build of PostgreSQL to fail.
 This is the problem if you see the following error message:
 "pgenv.cc", line 47: error: no default constructor exists for class "string"
 If you have this problem, you can disable building of libpq++ with the 
 following configure option:
 configure --without-CXX
 ***************************************************************************
 *) Readline
 If you install the readline library, then psql (the PostgreSQL command
 line SQL interpreter) remembers each command you type, and allows
 you to use arrow keys to recall and edit previous commands.  This is
 very helpful, and is strongly recommended.  The readline library is
 on the Skunkware CD.
 The readline library is not included on the UnixWare 7.1 Skunkware CD.  If
 you have the UnixWare 7.0.0 or 7.0.1 Skunkware CDs, you can install it
 from there.  Otherwise, try ftp.sco.com/skunkware.
 By default, readline installs into /usr/local/lib and /usr/local/include.
 However, the PostgreSQL configure program will not find it there without
 help.  If you installed readline, then use the following options to configure:
 configure --with-libs=/usr/local/lib --with-includes=/usr/local/include
 Putting this together with the no-C++ option above yields:
 configure --with-libs=/usr/local/lib --with-includes=/usr/local/include --without-CXX
 ***************************************************************************
 *) Using the UDK on OpenServer
 If you are using the new Universal Development Kit (UDK) compiler on
 OpenServer, you need to use different arguments to the configure program.
 First, you need to specify the "unixware" template instead of the default.
 Second, you need to specify the locations of the UDK libraries.
 Putting these together:
 configure --with-template=unixware --with-libs=/udk/usr/lib --with-includes=/udk/usr/include
 Putting these together with the no-C++ and readline options from above:
 ./configure --with-template=unixware --with-libs="/udk/usr/lib /usr/local/lib" --with-includes="/udk/usr/include /usr/local/include" --without-CXX
 ***************************************************************************
 *) Shared Memory and SHMMAX
 PostgreSQL supports multiple backend daemons running at once.  A block
 of shared memory is used by the backend processes.  A larger block
 of shared memory allows PostgreSQL to run faster and support more
 complicated queries.
 By default, UnixWare 7 and OpenServer are confiugured to support shared memory
 blocks that are no larger than 524288 bytes, or 512K.  By default, PostgreSQL
 tries to allocate a shared memory block that is larger than this.  If
 you don't do anything, this allocation will fail, and the postmaster
 daemon will not be able to run.
 The error message looks like this (the numbers may be different):
 IpcMemoryCreate: shmget failed (Invalid argument) key=5432001, size=831176, permission=600
 FATAL 1:  ShmemCreate: cannot create region
 You have two choices: tell PostgreSQL to allocate a smaller shared memory
 block, or tell Unix to allow larger shared memory blocks.  The latter
 is the preferred solution, but it requires a kernel tunable change and a 
 reboot to implement.
 To configure the size of the PostgreSQL shared memory block, use the -B
 option to the postmaster command, which configures the number of buffers
 used by PostgresSQL.  (The shared memory block consists of these buffers
 and around 300K of other stuff.)  Each buffer uses 8K, and by default
 there are 64 buffers, or 64*8*1024 = 524288 bytes (plus the ~300K of other
 stuff).
 To use PostgreSQL without doing any kernel tuning, use a -B value of 
 about 24.  This would take up 24*8*1024 = 196608 bytes, plus ~300K
 of other stuff, yields about 500000, which will fit in under the
 default 512K limit.
 Example: postmaster -B 24
 The recommended option is to instead raise the kernel tunable SHMMAX, 
 which controls the size of the largest allowed shared memory block.
 *** Tuning SHMMAX on UnixWare ***
 To display the current value of SHMMAX, run:
 /etc/conf/bin/idtune -g SHMMAX
 which displays the current, default, minimum, and maximum values, in bytes.
 To set a new value for SHMMAX, run:
 /etc/conf/bin/idtune SHMMAX value
 where value is the new value you want to use (in bytes).
 After setting SHMMAX, rebuild the kernel and reboot.
 To rebuild the kernel:
 /etc/conf/bin/idbuild -B
 *** Tuning SHMMAX on OpenServer ***
 First, cd to /etc/conf/cf.d.
 To display the current value of SHMMAX, in bytes, run:
 ./configure -y SHMMAX
 To set a new value for SHMMAX, run:
 ./configure SHMMAX=value
 where value is the new value you want to use (in bytes).
 After setting SHMMAX, rebuild the kernel and reboot.
 To rebuild the kernel:
 ./link_unix
 ***************************************************************************
 *) Java and JDBC
 The JDBC interface will not build on UnixWare or OpenServer without changes.  
 The JDBC Makefile in src/interfaces/jdbc/Makefile uses the $$( ) construction
 to run an external shell command, instead of the older ` ` syntax.
 However, the $$( ) syntax does not work on UnixWare or OpenServer.  
 So, each of the two uses of it must be replaced with backquotes.  You can 
 search for $$( to locate the two lines that need changing.
 In the file src/interfaces/jdbc/Makefile :
 change:
    make $$($(JAVA) makeVersion)
 to:
    make `$(JAVA) makeVersion`
 and change:
    $(JAR) -c0f $@ $$($(FIND) postgresql -name "*.class" -print)
 to:
    $(JAR) -c0f $@ `$(FIND) postgresql -name "*.class" -print`
 Of course, you also need to have installed Java on your system, and 
 make sure that /usr/java/bin is in your PATH.
 And, remember to use GNU make, as always.
 ***************************************************************************
 *) Reading the PostgreSQL man pages on UnixWare
 By default, the PostgreSQL man pages are installed into /usr/local/pgsql/man.
 By default, UnixWare does not look there for man pages, so you will not
 be able to read them.
 You need to make two changes to access the PostgreSQL man pages from UnixWare.
 1) You need to modify the MANPATH environment variable.  I use:
 MANPATH=/usr/local/pgsql/man:/usr/dt/man:/usr/man:/usr/share/man:scohelp
 export MANPATH
 2) The man pages for SQL commands are, by default, placed in section l
 (normally used for "l"ocal pages).  UnixWare does not support the l section.
 The solution I use is to move all these pages from section l to an unused
 section, such as section 6.  To accomplish that:
 cd /usr/local/pgsql/man
 mv manl man6
 cd man6
 for file in *.l
 do
 	mv $file `basename $file .l`.6
 done
 I have not tried using the PostgreSQL man pages on OpenServer.  Volunteers??