Apache Gump™: Getting Started

The bare minimum required to get started is a JDK, a JAXP 1.1 compliant parser, a command prompt (bash or Windows NT/2K), and Perl. Perl is only used at the moment for some of the publishing and notification, so it can be omitted.

It is highly recommended at this point that you review the description of the data definitions used by Apache Gump, starting with the overview.

Pre-requisites

Source Control System

One of these two is required.

• CVS -- Concurrent Versioning System
• SVN -- Subversion

Jar Downloading

This is optional.

• Depot -- Depot Updater

Getting the source

Gump source code resides in Subversion here.

      svn checkout https://svn.apache.org/repos/asf/gump/trunk/ gump 
      

This checks out the source code into a sub-directory called gump. Export $GUMP_HOME to (fully qualified) point to that directory.

Getting the metadata

If you have checked out the code then you already have the metadata in gump/metadata.

The shared Gump metadata resides in SVN here.

      svn checkout https://svn.apache.org/repos/asf/gump/trunk/metadata metadata
      

A sample workspace is provided, in 'workspace.xml', with some relative paths (and a basedir of '.'). Edit this to fit your environment/needs. The suggested name for the file you create is your host name.

'workspace.xml' comes referencing profile/minimal-profile.xml, a very small profile (containing things up to Ant). Edit the workspace to point to 'profile/gump.xml' for a full Gump.

Again, reference the overview to see how you can add projects, define your own profiles, and the modify which version of referenced projects you want to build.

Packages for which source is not easily accessible are not built by Gump. Where such packages are required prerequisites for building other projects, Gump allows binary versions of the package to be installed to satisfy the prerequisites. Your workspace definition specifies where installed packages are to be found.

A list of some of the packages you might want to install can be found here.

JDK 1.4 includes both jaxp and jsse which were previously available as separately installable packaged. The dependencies on these packages are now marked as optional. If you are using a JDK prior to 1.4, the packages must be installed. For JDK 1.4 and later the packages need not be installed and the version provided with the JDK will be utilised.