This documentation describes how to build BASE from a local working copy of the subversion checkout.
ContentsThe BASE source code lives in a Subversion server. It is a versioning system that enables us to keep track of all changes made to the code. You will need a client for subversion to be able to get the source code. If you are using Eclipse there is an excellent subversion plugin.
Check out the source code with the command:
svn checkout https://base.thep.lu.se/svn/trunk/ base
This will create a sub-directory base with all source files. Anonymous checkouts are allowed, but write permission is only granted to developers. The trunk version is the head of the development and should be used for testing purposes only. For information about how to get other version, including specific releases and bugfix branches, read the information on the BASE download page or check the subversion source repository directly.
The configuration files included with a binary distribution are located
in the config/dist
directory. You should never modify these files
directly for your local setup. Instead, place a copy of files that you need to
modify in the config/local
directory. When building BASE all targets
exception the 'dist' target will first check the local configuration files.
Note that the build process usually copies the configuration files to the
www/WEB-INF/classes
directory. The reason is that Tomcat
can't read file outside the WEB-INF
directory and this makes
the subversion working copy identical to a binary distribution.
www/WEB-INF/classes
.
config/local
and config/dist
directories.
ant clean
will remove the copied configuration files.
We use Ant to compile BASE. You will need
at least version 1.6. All build instructions are in the build.xml
file.
A build is started with the command:
ant <target>
where <target> is one of the named targets defined in the build file. You may specify multiple targets:
ant web jobagent
These targets works on the entire BASE source code. They may take some time to finish, but everything will be checked and recompiled if needed.
dist
subdirectory.
These targets are quicker to use if you know that you have only made changes to a specific module.
If you have followed the instructions so far the subversion working copy installation is compatible with a binary distribution. You will the installation programs, web application and all other things in the same places as for a binary installation. Read the BASE 2 installation instructions document for more information.