granicus.if.org Git - postgresql/blob - doc/FAQ_SCO

   1 ============================================================
   2 Frequently Asked Questions (FAQ) for PostgreSQL 7.2
   3 SCO UnixWare and OpenServer specific
   4 to be read in conjunction with the installation instructions
   5 ============================================================
   6 last updated:           $Date: 2001/08/29 19:14:39 $
   7
   8 current maintainer:     Billy G. Allie (Bill.Allie@mug.org)
   9 original author:        Andrew Merrill (andrew@compclass.com)
  10
  11
  12 PostgreSQL 7.1 can be built on SCO UnixWare 7 and SCO OpenServer 5.
  13 On OpenServer, you can use either the OpenServer Development Kit or
  14 the Universal Development Kit.
  15
  16 However, some tweaking may be needed, as described below.
  17
  18 Topics:
  19 *) Skunkware
  20 *) GNU Make
  21 *) Readline
  22 *) Using the UDK on OpenServer
  23 *) Compiling PostgreSQL using the UDK
  24 *) Reading the PostgreSQL man pages
  25
  26
  27 ***************************************************************************
  28 *) Skunkware
  29
  30 You should locate your copy of the SCO Skunkware CD.  The Skunkware CD is
  31 included with UnixWare 7 and current versions of OpenServer 5.
  32
  33 Skunkware includes ready-to-install versions of many popular programs that
  34 are available on the Internet.  For example, gzip, gunzip, GNU make, flex,
  35 and bison are all included.
  36
  37 If you do not have this CD, the software on it is available via anonymous
  38 ftp from ftp.sco.com/skunkware.
  39
  40 For UnixWare 7.1, this CD is now labeled "Open License Software Supplement".
  41
  42 Skunkware has different versions for UnixWare and OpenServer.  Make sure
  43 you install the correct version for your operating system, except as noted
  44 below.
  45
  46
  47 ***************************************************************************
  48 *) GNU Make
  49
  50 You need to use the GNU make program, which is on the Skunkware CD.  By
  51 default, it installs as /usr/local/bin/make.  To avoid confusion with the
  52 SCO make program, you may want to rename GNU make to gmake.
  53
  54
  55 ***************************************************************************
  56 *) Readline
  57
  58 If you install the readline library, then psql (the PostgreSQL command line
  59 SQL interpreter) remembers each command you type, and allows you to use
  60 arrow keys to recall and edit previous commands.  This is very helpful, and
  61 is strongly recommended.  The readline library is on the Skunkware CD.
  62
  63 The readline library is not included on the UnixWare 7.1 Skunkware CD.  If
  64 you have the UnixWare 7.0.0 or 7.0.1 Skunkware CDs, you can install it from
  65 there.  Otherwise, try ftp.sco.com/skunkware.
  66
  67 By default, readline installs into /usr/local/lib and /usr/local/include.
  68 However, the PostgreSQL configure program will not find it there without
  69 help.  If you installed readline, then use the following options to
  70 configure:
  71
  72 configure --with-libs=/usr/local/lib --with-includes=/usr/local/include
  73
  74
  75 ***************************************************************************
  76 *) Using the UDK on OpenServer
  77
  78 If you are using the new Universal Development Kit (UDK) compiler on
  79 OpenServer, you need to specify the locations of the UDK libraries:
  80
  81 configure --with-libs=/udk/usr/lib --with-includes=/udk/usr/include
  82
  83 Putting these together with the readline options from above:
  84
  85 ./configure --with-libs="/udk/usr/lib /usr/local/lib" --with-includes="/udk/usr/include /usr/local/include"
  86
  87
  88 ***************************************************************************
  89 *) Compiling PostgreSQL 7.1 with the UDK
  90
  91 The program, backend/utils/adt/int8.c, tickles a compiler bug with in the
  92 following versions (and probably others as well) of the C compiler:
  93
  94         Optimizing C Compilation System  (CCS) 3.2  08/18/98
  95         Optimizing C Compilation System  (CCS) 3.2  09/28/99
  96
  97 If you encounter an error compiling backend/utils/adt/int8.c, please apply
  98 the following patch:
  99
 100 ------------------------------8< CUT HERE >8------------------------------
 101 *** src/backend/utils/adt/int8.c.orig   Sat Oct  7 20:48:17 2000
 102 --- src/backend/utils/adt/int8.c        Sat Oct  7 20:52:03 2000
 103 ***************
 104 *** 489,495 ****
 105         if (arg1 < 1)
 106                 result = 0;
 107         else
 108 !               for (i = arg1, result = 1; i > 0; --i)
 109                         result *= i;
 110
 111         PG_RETURN_INT64(result);
 112 --- 489,495 ----
 113         if (arg1 < 1)
 114                 result = 0;
 115         else
 116 !               for (i = arg1, result = 1; i; --i)
 117                         result *= i;
 118
 119         PG_RETURN_INT64(result);
 120 ------------------------------8< CUT HERE >8------------------------------
 121
 122 This compiler bug seems to be fixed at least in
 123
 124         Optimizing C Compilation System  (CCS) 4.0  10/23/00 (UDK FS 7.1.1b)
 125
 126
 127 ***************************************************************************
 128 *) Reading the PostgreSQL man pages
 129
 130 By default, the PostgreSQL man pages are installed into
 131 /usr/local/pgsql/man.  By default, UnixWare does not look there for
 132 man pages.  To be able to read them you need to modify the MANPATH
 133 variable in /etc/default/man.  I use:
 134
 135         MANPATH=/usr/lib/scohelp/%L/man:/usr/dt/man:/usr/man:/usr/share/man:scohelp:/usr/local/man:/usr/local/pgsql/man
 136
 137 On OpenServer, some extra research needs to be invested to make the
 138 man pages usable, because the man system is a bit different from other
 139 platforms.  Currently, PostgreSQL will not install them at all.