Please note that these instructions only target software developers. The installation for a production version does not require Eclipse.
Please also note that the name Toro is currently used in the source code instead of Tricia. This will be changed in the next releases.
There are two major prerequisites, which have to be in place to use Tricia. For persistent storage, Tricia requires a relational database. Currently only MySQL is guaranteed to be supported. The MySQL database can be downloaded from http://dev.mysql.com/downloads/.
As a second prerequisite, Toro makes heavy use of the Eclipse IDE. There are several Eclipse plugins, which ease the development of an application with Tricia. In the following we describe how to create a workplace with Eclipse, all Tricia plugins for Eclipse, and the necessary Triciaprojects. In this installation guide, we assume that there is one dedicated Eclipse installation for Tricia. This is not a must, but rather a best practice.
1.) Download the Eclipse zip file from http://download.eclipse.org/eclipse/downloads/. Unzip the eclipse directory to a location of your choice on your computer:
[your path]/eclipse
2.) Create a new workspace directory for the eclipse workspace. A good practice is to put it in the same location on your hard drive you chose for the eclipse directory:
[your path]/eclipse-workspace
3.) Download the Tricia zip file from the location provided by Thomas Büchner. Unzip the toro directory inside the zip file to the same location on your computer you chose for the eclipse directory:
[your path]/toro
You have now created all the directories needed for your installation. The Toro framework needs to know three things:
4.) This information must be written into the file:
[your path]/toro/localProperties.txt
This file, as the name suggests, stores all local settings of your machine for Toro. Opening localProperties.txt displays the following three variables:
eclipse.dir=C:/Programme/eclipse-SDK-3.4RC3-win32
eclipse.workspace.dir=C:/Programme/eclipse-SDK-3.4RC3-win32/workspace
JAVA_HOME=C:/Programme/Java/jdk1.6.0_06/bin
Replace this text appropriately. Make sure, that you use forward slashed "/".
5.) You must now start Eclipse to continue the installation. You should not start eclipse directly by launching [your path]/eclipse/eclipse.exe, but rather launch it with a small script, which sets some command line arguments for you:
[your path]/toro/start-eclipse.bat
6.) Once Eclipse has started, you should import some preferences, which provide shortcuts and templates to make the development of Tricia applications easier. To do so, select "File -> Import and then General -> Preferences", choose the file [your path]/toro/preferences.epf, and import them by clicking on "Finish".
7.) Now you can install the Tricia Plugins. This is done by telling Eclipse where to look for Toro plugins through a so called 'extension directory' in the toro folder. The extension location is registered via: "Help -> Software Updates -> Manage Configuration...", and then click on the "Add an extension location" link. In the directory selector that appears, select the following directory:
[your path]/toro/eclipse extension/
Confirm with "OK", and allow Eclipse to restart.
If your Eclipse does not provide the option "Software Updates -> Manage Configuration...", you have to manually activate this capability (for discussion see http://wiki.eclipse.org/Equinox_p2): Select "Window -> Preferences", and then choose "General -> Capabilities". Click on the Checkbox next to "Classic Update", and click "OK". If you imported the Toro preferences as described in step 6, this should not be necessary.
8.) When Eclipse returns, you can check the installation of the plugins by activating an important tool, the "Consistency Checker", which makes sure all HTML files have all the Java code they need in their corresponding Java Handlers to substitute values for placeholder insideof the HTML code. To do this, select "Window -> Show View -> Other -> IMF -> Consistency".
Finally, you must import the toro projects into your Workspace. One, called platform - toro contains the code and templates for the platform which underlies the Toro application. The other project, toro, contains the code for the Toro application.
9.) To import these two projects, select "File -> Import and then General -> Existing Projects into Workspace". In the "Select root directory" box, browse to the Directory:
[your path]/toro/projects/
In the selection box, a whole list of projects will appear. Uncheck all, except toro and platform - toro, and import them by clicking on "Finish".
Tricia - Printout