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

  1. http://developer.apple.com/java/download/
  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

  1. http://tomcat.apache.org/download-55.cgi
  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/startup.sh
and stop the tomcat with command: sudo /usr/local/tomcat5/bin/shutdown.sh

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

  1. http://dev.mysql.com/downloads/mysql/5.0.html
  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 http://dev.mysql.com/doc/refman/4.1/en/default-privileges.html




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

  1. http://www.mysql.com/downloads/api-jdbc.html
  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