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
- 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
- Choose the newest version of Tomcat 5.5
- 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.
<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
- Scroll page down to Mac OS X downloads
- Choose your mac architecture (powerpc, 64-bit powerpc or x86)
- 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
- 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
<< Back to HOWTO index