Smilehouse Workspace HOWTO Articles

Installing Workspace on Linux - 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://java.sun.com/j2se/1.5.0/download.jsp
  2. Select "Download JDK 5.0 Update 6" (or newer)
  3. From the following page, select Linux Platform - J2SE(TM) Development Kit 5.0 Update 6 or newer installation method that is suitable for your system.

Copy the downloaded .bin file to /usr/local and extract it for example in Terminal with command: sh jdk-1_5_0_06-linux-i586.bin
You should make symbolic link. It makes easier to update Java.
For example: ln -s /usr/local/jdk1.5.0_06 /usr/local/jdk1.5

Now you should have Java in your system.

Apache Tomcat 5.5.
You can download Tomcat at

  1. http://jakarta.apache.org/tomcat/
  2. Select Download Tomcat 5.x from the left
  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 can also start the tomcat from Terminal with command: /usr/local/tomcat5/bin/startup.sh (if /usr/local/tomcat5 is the location of tomcat)
You should also set Tomcat to start on boot. For more detailed information, please check http://tomcat.apache.org/tomcat-5.5-doc/setup.html

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

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.

NOTICE! 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
If your Linux distribution doesn't contain MySQL, you can download it at http://dev.mysql.com/downloads/.

Follow the installation instructions described in official documentation
For more detailed information, please visit http://dev.mysql.com/doc/refman/5.0/en/installing.html
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/5.0/en/default-privileges.html




JDBC driver for the database
MySQL is compatible with MySQL Connector/J. 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