Install Guide

There are several ways you can take to install this project's artifact into your local Maven repository. Anyone of them will do.

After installation, head over to the Quickstart Guide for instructions on how to use it.

Install Using the Packaged Binaries

Download a binary package:

$ curl -o semispace-tim-1.3.1-bin.zip \
  http://forge.terracotta.org/projects/semispace-tim/downloads/semispace-tim-1.3.1-bin.zip

Unpack:

$ unzip semispace-tim-1.3.1-bin.zip

Install (you will need to do this for all JAR files included in the package):

$ cd semispace-tim-1.3.1
$ mvn install:install-file \
  -DgroupId=org.semispace \
  -DartifactId=semispace-tim \
  -Dversion=1.3.1 \
  -Dpackaging=jar \
  -Dfile=semispace-tim-1.3.1.jar

Install Using the Packaged Source

Download a source package:

$ curl -o semispace-tim-1.3.1-src.zip \
  http://forge.terracotta.org/projects/semispace-tim/downloads/semispace-tim-1.3.1-src.zip

Unpack:

$ unzip semispace-tim-1.3.1-src.zip

Install:

$ cd semispace-tim-1.3.1
$ mvn clean install

Install Using the Source from Subversion

Checkout the project:

$ svn checkout \
  http://www.semispace.org/svn/tags/semispace-1.3.1/semispace-tim \
  semispace-tim-1.3.1

Install:

$ cd semispace-tim-1.3.1
$ mvn clean install

Install in Local Terracotta Installation

You don't need to install the semispace-tim artifacts in your local Maven repository to use it. You can also choose to install these into your local Terracotta DSO installation's modules folder.

Assuming you've already downloaded and installed Terracotta, and the you've set the TC_INSTALL_DIR environment variable to point to your Terracotta installation:

$ curl -o semispace-tim-1.3.1-bin.zip \
  http://forge.terracotta.org/projects/semispace-tim/downloads/semispace-tim-1.3.1-bin.zip
$ unzip semispace-tim-1.3.1-bin.zip
$ cd semispace-tim-1.3.1
$ cp *.jar ${TC_INSTALL_DIR}/modules

Install in Arbitrary Location

If you don't want to pollute your local Terracotta installation, you can also install an Integration Module at an arbitrary location:

$ curl -o semispace-tim-1.3.1-bin.zip \
  http://forge.terracotta.org/projects/semispace-tim/downloads/semispace-tim-1.3.1-bin.zip
$ unzip semispace-tim-1.3.1-bin.zip
$ mkdir ~/terracotta-modules
$ cd semispace-tim-1.3.1
$ cp *.jar ~/terracotta-modules

You will have to add a <repository/> section in your tc-config.xml file to tell Terracotta where it can find these modules:

<clients>
   <modules>
      <repository>%(user.home)/modules</repository>
      <module name="semispace-tim"
         version="1.3.1"
         group-id="org.semispace"/>
   </modules>
</clients>