README

   1 README for OpenSRF 1.0 RC
   2
   3 Installing prerequisites:
   4 ========================
   5
   6 OpenSRF has a number of prerequisite packages that must be installed
   7 before you can successfully configure, compile, and install OpenSRF.
   8 On Debian and Ubuntu, the easiest way to install these prerequisites
   9 is to use the Makefile.install prerequisite installer for Evergreen.
  10
  11 Issue the following commands as the root user to install prerequisites
  12 using the Makefile.install prerequisite installer, substituting "debian"
  13 or "ubuntu" for <osname> below:
  14
  15 aptitude install wget make
  16 wget http://svn.open-ils.org/trac/ILS/export/10741/trunk/Open-ILS/src/extras/Makefile.install
  17 make -f Makefile.install <osname>
  18
  19 Note: You may also be able to use "centos" to install the OpenSRF
  20 prerequisites for CentOS 5 and RHEL 5, or "gentoo" for Gentoo - but
  21 these are less tested distributions. Your patches and suggestions for
  22 improvement are welcome!
  23
  24 Configuration and compilation instructions:
  25 ==========================================
  26
  27 For the time being, we are still installing everything in the /openils/
  28 directory (with the exception of the Perl modules, which are installed
  29 into system directories). Issue the following commands to configure and
  30 build OpenSRF:
  31
  32 ./configure --prefix=/openils --sysconfdir=/openils/conf
  33 make
  34
  35 Installation instructions:
  36 =========================
  37
  38 Once you have configured and compiled OpenSRF, issue the following
  39 command as the root user to install OpenSRF:
  40
  41 make install
  42
  43 This will install OpenSRF, including example configuration files in
  44 /openils/conf/ that you can use as templates for your own configuration files.
  45
  46 Adjust the system dynamic library path:
  47 ======================================
  48
  49 Add /usr/local/lib/dbd and /openils/lib/ to the system's dynamic library path.
  50 On most systems, you can add these entries to /etc/ld.so.conf or a file within
  51 the /etc/ld.so.conf.d/ directory and then running "ldconfig" as root.
  52
  53 Getting help:
  54 ============
  55
  56 Need help installing or using OpenSRF? Join the mailing lists at
  57 http://evergreen-ils.org/listserv.php or contact us on the Freenode
  58 IRC network on the #evergreen channel.