Smilehouse Workspace HOWTO Articles

Installing Workspace on Mac OS X - Installing Platform Softwares

Before you can start the Workspace installer, you must have the following software installed.

Java 2 Standard Edition Development Kit (J2SE 5.0 / JDK 5.0) or newer.
You can download Java at

  2. Select and download "J2SE 5.0 Release 4" (or newer)

Run downloaded J2SE50Release4.dmg package and follow the instructions
Java is located in "/Library/Java/Home" folder. This is a symlink to /System/Library/Frameworks/JavaWM.framework/Home directory. Make sure that symlinks are updated and points to 1.5.0 Java version.

You can update symlink with following commands (in Terminal application)

  • cd /System/Library/Frameworks/JavaWM.framework/Versions
  • sudo rm CurrentJDK
  • sudo ln -sf 1.5 CurrentJDK

Now you should have Java in your system. Try typing "java -version" in Terminal to see what version of Java you are running. Your correct JAVA_HOME environment variable is /Library/Java/Home

Apache Tomcat 5.5.
You can download Tomcat at

  2. Choose the newest version of Tomcat 5.5
  3. From the Binary Distributions list select Core and tar.gz

Copy the downloaded tar.gz file to /usr/local and extract it for example in Terminal with command: tar -zxvf apache-tomcat-5.5.17.tar.gz

You should make symbolic link. It makes easier to update Tomcat.
For example: ln -s /usr/local/tomcat-5.5.17 /usr/local/tomcat5

You can start the tomcat from Terminal with command: sudo /usr/local/tomcat5/bin/
and stop the tomcat with command: sudo /usr/local/tomcat5/bin/

After installation is completed, you should test your Tomcat installation by going
http://localhost:8080/ with your browser. If everything is ok, you should see the following page.

Now the Tomcat is installed and running.

NOTIFY! Tomcat 5.5 and uses ISO-8859-1 for URI encoding/decoding by default. Workspace follows the W3C recommendation and uses UTF-8 for URI encoding/decoding. For enabling compatible URI encoding you must edit tomcat's server.xml file and add attributes URIEncoding="UTF-8" and useBodyEncodingForURI="true" into the Connector elements. For example:
<Connector port="80" URIEncoding="UTF-8" useBodyEncodingForURI="true" maxThreads="150" minSpareThreads="150" maxSpareThreads="150" redirectPort="8443" acceptCount="100" debug="0" connectionTimeout="20000" disableUploadTimeout="true" />

MySQL 4 or MySQL 5 Database
You can download mysql at

  2. Scroll page down to Mac OS X downloads
  3. Choose your mac architecture (powerpc, 64-bit powerpc or x86)
  4. Select Standard version and press Download link

Double click on downloaded dmg file (in Finder application) and it will open up a folder window.
To install MySQL, double click on the file in that folder named "mysql-standard-5.0.22-osx10.4-powerpc.pkg" and answer the prompts.
We recommend to change the password of mysql root user. It is empty by default. For more detailed information, please visit

JDBC driver for the database
MySQL is compatible with MySQL Connector. We recommend using connector version 5.0.x.
You can download this at

  2. Select Source and Binaries (zip)

Download and extract the .zip file. Inside the extracted folder there should be a file called mysql-connector-java-5.0.5-bin.jar or similar.
Place that file under the shared/lib directory under your Tomcat installation directory.
For example /usr/local/tomcat5/shared/lib/

Now you have all the necessary platform software installed and you can proceed to the next step.

Page 1 / 3     Next page >

^ Contents
<< Back to HOWTO index