Smilehouse Workspace HOWTO Articles

Installing Workspace on Mac OS X - Setting Environment Variables

Before you can start the Workspace installer, you must have the following environment variables set correctly.

WORKSPACE_HOME
Gives the Workspace installation directory.
For example /home/workspce

JAVA_HOME
Gives the Java installation directory.
For example /Library/Java/Home

CATALINA_HOME
Gives the Tomcat installation directory.
For example /usr/local/tomcat5

CLASSPATH
The Java class path. CLASSPATH must include at least the JDBC driver.
For example $CATALINA_HOME/shared/lib/jdbc-driver.jar
or /usr/local/tomcat5/shared/lib/jdbc-driver.jar (if the CATALINA_HOME is /usr/local/tomcat5)


The variables set to profile (recommended)

Add the following lines to the .bash_profile file in your login directory (use your own values instead of example values):
export WORKSPACE_HOME=/home/workspace
export JAVA_HOME=/Library/Java/Home
export CATALINA_HOME=/usr/local/tomcat5
export CLASSPATH=$CATALINA_HOME/shared/lib/jdbc-driver.jar (jdbc-driver.jar assumed to be the name of the JDBC driver)

If .bash_profile file doesn't exist, create it. You can edit the .bash_profile file in Terminal for example with command: sudo nano .bash_profile

You must add this line "export WORKSPACE_HOME=/home/workspace" also to /etc/init.d/tomcat5 file because of sudo's new security features.
Restart the Terminal application. Now you should have the variables in use.
You can test it in Terminal with command: echo $variable.
For example echo $JAVA_HOME

If variables are ok you can skip the next section "The variables set using a Terminal" and proceed to next page.

The variables set using a Terminal

If you don't want to set variables to profile you can also use the Terminal and set the variables every time you need them.

Open Terminal.
Type (use your own values instead of example values):
export WORKSPACE_HOME=/home/workspce   (Press Enter)
export JAVA_HOME=/Library/Java/Home   (Press Enter)
export CATALINA_HOME=/usr/local/tomcat5   (Press Enter)
export CLASSPATH=$CATALINA_HOME/shared/lib/jdbc-driver.jar   (Press Enter)(jdbc-driver.jar assumed to be the name of the JDBC driver)



You can see the value of set value with command echo $variable.
For example echo $JAVA_HOME
Don't close the Terminal. You need it in next stage. It is recommended to use the same Terminal for setting variables and for installation.

Now you have the necessary platform softwares installed and required environment variables set and you can run the Workspace installer.



< Previous page     Page 2 / 3     Next page >

^ Contents
<< Back to HOWTO index