Smilehouse Workspace HOWTO Articles

Installing Workspace on Windows - Installing Platform Softwares

Before you can start the Workspace installer, you must have the following software installed.

Java 2 Standard Edition Development Kit (JDK 6 update 20) or newer.
You can download Java at


Open the downloaded .exe file and install the software with default settings.

After installation has been completed, you can check that Java has been installed correctly by going to Command Prompt
(Start -> Programs -> Accessories -> Command Prompt) and type java -version:
C:\>java version
This command should return you the version of the Java installed. You may need to adjust PATH environment variable if incorrect Java version gets executed or java is not found.

Apache Tomcat 5.5 or 6.
You can download Tomcat at

  2. Select Tomcat 5.5 (or newer) or Tomcat 6.x from the left.
  3. From the Binary Distributions list select Core and Windows Service Installer.

Download and open the .exe file and run the installer.


  • During the installation you are asked where to install Tomcat.
    It is recommended that you don't use the default location (C:\Program Files\...).
    Instead, use for example C: drive's root (eg. C:\tomcat_5). Just make sure
    that the directory path does not contain any whitespace in it. This directory will be referred to as TOMCAT_HOME.
  • The installer asks where you have installed your J2SE.
    This is usually C:\Program Files\Java\jdk1.6.0_20 or similar.
  • Depending on architecture, you may need to replace the tcnative-1.dll and tomcat5.exe in the installation directory with 64-bit versions from appropriate subdirectory. However, if you get problems connecting to the tomcat with Opera and/or from other computers, remove or rename the tcnative-1.dll so that Tomcat can not use that library. This may solve the problem.

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.

You should also set Tomcat as a system service, so that it will be started automatically when Windows reboots.
You can do this by going Start -> Programs -> Apache Tomcat -> Configure Tomcat or simply click the tray icon.

You should change the Startup Type into Automatic and click Start if the service has not yet been started.

Now the Tomcat is installed and running.

MySQL 5.0 Database
You can download MySQL Community Server at and selecting the "Archives" tab.

Download the Community Server .zip file with installer (SETUP.EXE) and extract it on your hardware.
Run SETUP.EXE and follow the instructions given. Choose the configuration that best fits your needs.

  • When asked for the default character set, choose "Best Support For Multilingualism (UTF8)"
  • Answer yes, when asked should MySQL be installed as Windows service. This will install MySQL as a service that will be started the next time you reboot Windows.
  • You may need to open the port 3306 in your firewall to allow access to the database server. Windows firewall can be configured in Start -> Control Panel -> Security Center -> Windows Firewall. Click the Add port button on the Exceptions tab and fill in MySQL as name and 3306 as port number. For increased security you can also click the Change Scope button and set the scope to My network (subnet) only.
You can also start/stop MySQL server manually in the service list in Control Panel -> Performance and Maintenance -> Administrative Tools -> Services

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

  2. Notice the "looking for previous GA versions?" link. Follow that as desired.
  3. Select zip archive

Download and extract the .zip file. Inside the extracted folder there should be a file called mysql-connector-java-5.0.8-bin.jar or similar.
Place that file under the shared\lib directory under you Tomcat installation directory.
For example C:\Program Files\Apache Software Foundation\Tomcat 5.5\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