User Tools

Site Tools


osrf-devel:installing_software

User Comments

OpenSRF currently contains a makefile at the top of the src directory (OpenSRF/src). This makefile can be used to build/install all of the OpenSRF components. The makefile requires a number of environment variables to be defined before the build can take place. For convenience sake, OpenSRF is presently built as a part of Open-ILS and Evergreen by a top level makefile at the root of the ILS build tree. This makefile walks you through the process of setting up the correct environment variables.

When the CVS tree is newly unpacked, there will be a file called 'install.conf.default'. This file contains all of the default build environment variables. Running 'make' will kick off the configure script which prompts you to fill in the correct variable values using the values in install.conf.default as default. One of these will be the setting for the build targets. For OpenSRF, there are a couple of build options:

opensrf_all - builds all OpenSRF compenents
opensrf_jserver - custom 'single-domain' jabber server which may be used in place of jabberd2
opensrf_router - jabber router.
opensrf_gateway - mod_ils_gateway, Apache module for proxying API calls
opensrf_srfsh - diagnostic shell interface to OpenSRF
opensrf_core - install the OpenSRF perl modules and core files for running opensrf

Most of these should be fairly self explanatory. If you only wish to run the core server, then install opensrf_core. All other components are only necessary if the machine you are building them on is meant to run those services. If you are doing a single host install, then building opensrf_all is likely your best bet.

see install.conf.default for full documentation on the build targets.


Once the config has completed, it will continue on to the build process. If the build is successfull, entering 'make install' will copy over and install all of the appropriate files.

If you would like to change the build config, simply run 'make config' or edit install.conf manually.

osrf-devel/installing_software.txt · Last modified: 2005/08/15 09:09 (external edit)

© 2008-2017 GPLS and others. Evergreen is open source software, freely licensed under GNU GPLv2 or later.
The Evergreen Project is a member of Software Freedom Conservancy.