Dependencies
From ControlTier
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.
Note
- 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.
Contents |
Set CTIER_ROOT
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
Unix
$ export CTIER_ROOT=~/ctier $ mkdir -p $CTIER_ROOT/pkgs
Windows
C:\>set CTIER_ROOT=C:\ctier C:\>mkdir %CTIER_ROOT%\pkgs
Java
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.
Unix
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
Windows
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:
Verify
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!
JRE_HOME
- If you have previously set the
JRE_HOMEvariable, you will need to reset it to point toJAVA_HOME(or the same path)
Graphviz
Graphviz is used to generate diagrams in Workbench.
Unix
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.
Windows
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.
| ||||||||||||||
