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
- Select "Download JDK 5.0 Update 6" (or newer)
- 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
- Select Download Tomcat 5.x from the left
- 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.
<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
- 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