Please note that these instructions specifically target software developers.The instructions for users who want to download and install Tricia can be found here.

Prerequisites

There are two major prerequisites, which have to be in place to install Tricia:

1. As a first prerequisiste, a current (1.6) Java runtime has to be installed. Java can be downloaded from http://www.java.com.
2. We use Mercurial as our version control system, so you have to install Mercurial on your machine. Binary packages of Mercurial can be found at http://www.selenic.com/mercurial/wiki/index.cgi/BinaryPackages. A good introduction on how to use ssh on Windows can be found here: http://www.codza.com/mercurial-with-ssh-setup-on-windows. A good book about Mercurial (including a brief basic tutorial) can be found here.

For persistent storage, Tricia requires a relational database. The Tricia workspace contains the relational in-memory database hsqldb, which is fine for testing purposes.  If you want to develop using a production-ready relational database, you have to install MySQL (see Installing MySQL).

Eclipse

Since we believe, that a modern IDE improves the developer experience a lot ,we strongly recommend using the Eclipse IDE for developing Tricia applications. We provide special Tricia Eclipse plugins, which are necessary for some development tasks. The easiest way to get these plugins is by cloning our BitBucket repository eclipse-dropins. This repository additionally contains some useful existing plugins (Aptana, QuantumDB, JAutoDoc, RegExp). The following steps explain the installation of a fresh Eclipse:

1. Download Eclipse 3.5 from http://download.eclipse.org/eclipse/downloads/, and extract the zip file to %ECLIPSE_HOME%.
2. Go on the command-line into %ECLIPSE_HOME%, and delete the empty dropins folder.
3. Call hg clone http://bitbucket.org/infoasset/eclipse-dropins dropins , which creates a new dropins-folder containing the bundled plugins.
4. Start Eclipse.
5. The Tricia plugins now can be activated in Eclipse by Window -> Show View -> Other -> IMF -> Consistency

Tricia Download

You can download Tricia by going to a root folder (e.g., C:\development), and running on the command line

hg clone http://bitbucket.org/infoasset/tricia

Finally, you must import the Tricia plugins into your Workspace. Start Eclipse and select "File -> Import and then General -> Existing Projects into Workspace". In the "Select root directory" box, browse to the Directory [your path]/tricia/plugins/. In the selection box, a whole list of projects will appear. The simplest option is to import all of them.

Eclipse Preferences

Tricia comes with some Eclipse preferences, which make the development of Tricia applications easier. These preferences can be activated in Eclipse by File -> Import -> General -> Preferences, then select in From preference file the file /plugins/toro/preferences.epf, and click Finish.

Running Tricia

Now you can start the project allPlugins in test mode by right-clicking on allPlugins/allPlugins-test.launch, and then Run As -> allPlugins-test

From now on, documentation in Javadoc is available:

• Open class IndexDoc (Ctrl-Shift-R, DocumentationDoc.java) and view the documentation with the Eclipse Javadoc view
• or see the HTML version here