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

  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

  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/ (if /usr/local/tomcat5 is the location of tomcat)
You should also set Tomcat to start on boot. For more detailed information, please check

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

Follow the installation instructions described in official documentation
For more detailed information, please visit
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/J. 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