This document describes how to install and build the Goanna Log4E examples.
You can install Goanna Log4E using a pre-packaged tar file or by checking out the latest source from its CVS repository at SourceForge.
A pre-packaged installation will normally give you a more stable version than a checkout from CVS. Tar files are created at every major milestone of the project and represent a tested release.
Pre-packaged tar files are available from SourceForge in the Downloads section. Download the latest tar file from here and extract into a directory of your choice.
If you wish to use the latest source from CVS follow the instructions on the Project Goanna CVS page for Anonymous CVS Access.
Due to a few limitations of CVS, and a major restructuring of the source tree, you may end up with a number of empty directories when you checkout the source. If you execute:
cvs update -Pd
these directories will be removed. You can also add the -P option to the initial checkout command.
Once installed, create an environment variable named LOG4E
that points to the root directory of the installation.
The Goanna Log4E source tree contains the following top level directories:
Installation of Goanna Log4E requires a number of third party
Eiffel libraries to be installed and built. Each distinct library is reverenced
using an environment variable that points to the
top level directory of the library.
The following table lists the third-party libraries used by Goanna Log4E
| Library | Version | Authors | Description | Variable |
| gobo | 3.0 | Eric Bezault | Portable Eiffel libraries and tools. | GOBO |
| EiffelNet | EiffelStudio 5.1 | Eiffel Software Inc. (aka ISE) | Optional. Used for socket examples and the logvision application | N/A |
| EiffelVision2 | EiffelStudio 5.1 | Eiffel Software Inc. | Optional. Used for the logvision applicaiton | N/A |
It is important to have a recent version of the GOBO libraries. Log4E has been developed using the prerelease 3.0 version of GOBO to make use of the new GOBO XML parser and GOBO tools.
The NT event log appender requires a C library that encapsulates the Win32 event logging functions. This library will need to be compiled using a C compiler before attempting to compile and use an NT event log appender. A batch file is provided in the library folder (library/appenders/nt/lib) that can be used to perform the compilation. once compiled you must make sure the created DLL is available on the path by either copying it to an appropriate folder or adding the lib folder to your path.
To compile all of the examples you can use the GOBO geant tool and run geant compile at the top level of the installation. Each example can also be compiled individually by changing to the appropriate folder and running geant compile.
Ace files for each Eiffel compiler are also provided so that you can compile by hand. You may need to tweak the Ace files before compilation to match your environment.