This file contains information on installing, building and using
omniNotify on Unix platforms.

It should be possible to build omniNotify on most 
of the platforms on which one can build the omniORB libraries.
So far we have successfully built omniNotify on: 
 
 * Linux 2.x (x86)/egcs-1.1.2/binutils-2.9.1.0.14/GNU Libc version 2
 * Solaris 2.{5,6}/ Sun SparcCompiler C++ version 4.2
 * SGI Irix 6.x/SGI C++ compiler 7.2
 * HP-UP 11.0 / aCC

If you find that some changes are required to build omniNotify
on another platform, please send us the changes so that we can
incorporate them into the omniNotify source tree.
(See the contact information in the README.FIRST file.)

Roadmap
=======

We assume you have an instance of the omniORB source tree,
with root at <OMNI_TOP>.  (For instructions on obtaining
this tree, see the README.OMNIORB file.)

The omniNotify source tree should be checked out from a
CVS repository (or unpacked from a tarball) so that
the top-level 'omniNotify' directory is an immediate
subdirectory of <OMNI_TOP>/src/services

** We refer to directory <OMNI_TOP>/src/services/omniNotify
as <NOTIFY_TOP>.

The directory structure under <NOTIFY_TOP>:

./daemon		: source files for the omniNotify daemon
./examples		: source files for examples
./include		: include files
./lib			: source files for the omniNotify library
./wwwfiles		: omniNotify WEB pages

Configuration
=============
 
omniNotify uses the platform configuration files provided by the 
omniORB release.  Please refer to appropriate README files under
<OMNI_TOP>.  <OMNI_TOP>/README.FIRST is a good starting point.

The makefiles in this distribution only work with GNUmake.  Make
sure that you have the program installed and invoke it directly.

Make sure that the root directory of omniNotify, which is
called 'omniNotify', is located under 
<OMNI_TOP>/src/services.  As mentioned above, we refer to
this directory as <NOTIFY_TOP>.

To build and install everything, simply go into the directory 
<NOTIFY_TOP> and type 'gnumake export'. If all goes 
well, the libraries and executables will be installed into
<OMNI_TOP>/lib/<platform>/ and <OMNI_TOP>/bin/<platform>/ --
note that these directories are located under the top of the 
omniORB installation tree, not the omniNotify subtree.
You can skip this step if this is a pre-compiled 
binary distribution.

If you have already added the omniORB libraries to search path, 
there is nothing else that needs to be done.  Otherwise, you must
add the library directory to the search path.  For example:

    On Solaris 2.5
       $ LD_LIBRARY_PATH=<absolute pathname of <OMNI_TOP>/lib/sun4_sosV_5.5>
       $ export LD_LIBRARY_PATH
 
Building the examples
=====================

You are strongly encouraged to try out the examples provided in 
<NOTIFY_TOP>/examples.  Go into <NOTIFY_TOP>/examples and type 'gnumake all'.

The file <NOTIFY_TOP>/examples/README describes what the example programs
do and how to run them.

