The module "iris" contains the following directory structure:
Contains base configuration files and iris.bat/iris.sh
Contains the main build.xml file used to build IRIS
Contains DocBook source for IRIS docs.
Java source code for core IRIS services
Contains third-party libraries used by IRIS
IRIS documentation
Testing source for running IRIS unit tests
Contains IRIS source that is specific to using third-party applications.
Contains the source and build system for the IRIS Universal Libraries.
The main IRIS Ant build file is located at iris/src/build.xml. The following Ant tasks exist:
Note: when building IRIS it is recommended to set ANT_OPTS=-mx1024m or else the build can failCleans all distribution including IRIS and IRIS plugin output. One of the goals of the IRIS build is that the following procedure results in a clean CVS state:.
Clean CVS Checkout
"ant test"
Run IRIS in "Full Configuration"
Shut down IRIS
"ant clean"
After these 5 steps the IRIS CVS wil be in the exact state it was checked out in, with no modified, missing or new files (this also assumes 'ant test' succeeds). Furthermore, it is also a goal that after running "ant test" a CVS update shows no modified files. Note: this procedure is currently checked by hand occasionally and not automatically verified with the nightly build.
Builds all of IRIS and all IRIS Plugins. This task does not run unit tests. Use "ant test" for this.
Will build a zip file in iris/dest/ of the distribution and documentation.
Builds IRIS and runs all unit tests. See the testing chapter for more information.
Note that running unit tests requires port 5007 to be available (used to run unit tests in debugging mode)Will validate all OWL files in iris/data (recursively) using Pellet. The IRIS build also runs this task.
Manually generates POJOs for ontolgoy usage documentation. The IRIS build also runs this task. POJOs are described in more detail later in this document.
Generates PubSub task parameters. The IRIS build runs this task automatically. Task Parameters are described later in this document.
Builds only iris/src and no plugins. This task is useful when just the core IRIS is updated because building all the plugins can take a while even if the plugins are already built.
IRIS has a nightly build process which builds and runs unit tests To download nightly build installers and/or source packages visit http://www.openiris.org/download. To see the results of the nightly build unit tests, visit http://www.openiris.org/downloads/IRIS-nightly/doc-current/dest/test/html/