ControlTier has 2 dependencies:
- Java 1.5/1.6 : The install process requires that the latest version of Java Development Kit 1.5 or 1.6 be installed. You must have the JAVA_HOME environment variable defined in your JDK environment before running the install script. See below for instructions on installing Java.
- Graphviz (Optional) : Graphviz is a visualization software package that must be installed in order to see graphs (command workflows, object relationships, etc.) in the Workbench web interface . It is the only part of the server install that is platform specific. See below for instructions on installing Graphviz. It's also worth noting that Workbench can function without Graphviz with the consequence being the graphing action will result in a broken image in the graph display area.
This section covers installing the dependencies and setting up the Self Contained Directory Convention described in the previous two sections.
- The typographic convention: "$ " (Unix/Linux) and "C:\>" (Windows) is used to indicate the system for which the commands are intended.
- These instructions work equally well from a Bash shell on a Unix/Linux system, or on a Windows system using the Command Prompt.
The first step is to choose the value of the CTIER_ROOT. For the purpose of these instructions, we assume CTIER_ROOT to have the default value. Avoid choosing a directory that contains spaces since this is not handled reliably throughout the system (this particularly eliminates anything under "C:\Documents and Settings" on Windows).
Self contained directory convention
Create the basic directory structure as per the Self Contained Directory Convention
The following layout is the best-practice convention that has been adopted as the standard installation layout:
CTIER_ROOT Defaults to $HOME/ctier on *nix and C:\ctier on Windows, but is relocatable ctl CTL_BASE src Module library source code demo Optional directory of demonstration applications jobcenter JOBCENTER_BASE reportcenter REPORTCENTER_BASE workbench Workbench runtime files jackrabbit Apache Jackrabbit file repository data pkgs Software installations to support the ControlTier installation ControlTier-3.x Staging directory for the ControlTier installer ctl-1.x.x CTL_HOME apache-forrest-0.8 FORREST_HOME graphviz-2.xx.x GRAPHVIZ_HOME for a Windows installer install j2sdk1.5.0_xx JAVA_HOME for the ControlTier installation jetty-6.x.x JETTY_HOME
$ export CTIER_ROOT=~/ctier $ mkdir -p $CTIER_ROOT/pkgs
C:\>set CTIER_ROOT=C:\ctier C:\>mkdir %CTIER_ROOT%\pkgs
Both the Open JDK and Sun (Oracle) JVMs can be used. Earlier versions of ControlTier require Java 1.5. Java 1.6 will work fine with releases beginning with 3.4.8. We also encourage that you provide a separate Java install to support ControlTier deployment. Doing this will isolate the ControlTier install from system wide or application specific changes and needs.
On a Unix/Linux system download the latest self-extracting file version of http://java.sun.com/javase/downloads/index_jdk5.jsp appropriate for your system into $CTIER_ROOT/pkgs and install it as follows. e.g:
$ cd $CTIER_ROOT/pkgs $ sh j2sdk-1_5_0_15-linux-i586.bin . . . Creating j2sdk1.5.0_15/jre/lib/plugin.jar Creating j2sdk1.5.0_15/jre/javaws/javaws.jar Done.
This should result in a new $CTIER_ROOT/pkgs subdirectory containing the Java install (eg, "j2sdk1.5.0_15"). Do not register browsers with this version if you do not want to replace your currently installed Java version.
Mac OS X
On a Mac OS X system your Java home will be set to a logical path like
/Library/Java/Home with a set of symbolic links pointing to a particular version.
These links also add the "java" executable to the "/usr/bin" path. Eg;
$ which java /usr/bin/java
Calling the executable will show you what version it is currently pointing to:
$ java -version java version "1.5.0_16" Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_16-b06-284) Java HotSpot(TM) Client VM (build 1.5.0_16-133, mixed mode, sharing)
The system-wide Java version is set via "Java Preferences.app" which you can find in /Applications/Utilities/Java. If you are currently running a non 5.0 version you can run the "Java Preferences" application and change it to 5.0
Alternatively, you can set the correct JAVA_HOME and PATH via your login initialization profile. You can see the available versions in: /System/Library/Frameworks/JavaVM.framework/Versions:
$ ls 1.3@ 1.4.1@ 1.5.0/ A/ 1.3.1/ 1.4.2/ 1.6@ Current@ 1.4@ 1.5@ 1.6.0/ CurrentJDK@
You can therefore set your JAVA_HOME to: /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0/Home
On a Windows system, download the latest "Offline Installation" version of Sun's 1.5.0 J2SE SDK and install it into %CTIER_ROOT%\pkgs as follows:
Be sure you have the correct version of Java.
Run the "java" executable with the "-version" flag:
...and you should see the output show the version number:
java version "1.5.0_17" Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_17-b04) Java HotSpot(TM) Client VM (build 1.5.0_17-b04, mixed mode)
Make sure it is the right version!
- If you have previously set the
JRE_HOMEvariable, you will need to reset it to point to
JAVA_HOME(or the same path)
Graphviz is used to generate diagrams in Workbench.
On a Unix/Linux system ensure that version 2.x of Graphviz is installed as part of the operating system image:
$ which dot /usr/bin/dot $ dot -V dot version 2.2 (Tue Mar 22 18:02:44 UTC 2005)
If it is not installed go to http://www.graphviz.org and locate the Download page. There are Linux, Mac and Windows distributions. Of course, they have instructions to build it from source, too.
On a Windows system, download the current stable release of the binary distribution of the 2.x version of the [installer] and install it into %CTIER_ROOT%\pkgs as follows. e.g.:
At this point you are ready to proceed with the ZIP installer interface based installation of the ControlTier software depending on your circumstances and preferences.