From ControlTier

Jump to: navigation, search

ControlTier has 2 dependencies:

This section covers installing the dependencies and setting up the Self Contained Directory Convention described in the previous two sections.




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 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

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

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" 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:

java -version

...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!



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
$ dot -V
dot version 2.2 (Tue Mar 22 18:02:44 UTC 2005)

If it is not installed go to 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.

Personal tools