Smilehouse Workspace HOWTO Articles

Installing Workspace on Windows - Running Workspace Installer

After installing platform softwares and setting environment variables, you are ready to run the Workspace installer.

Download the Developer version installer at or use the installer you acquired on your license CD.

New installation procedure requires that each organization has a virtualhost defined.
You should also change your network DNS settings to match with this configuration.
Create a CNAME record that points to the server. For example for "ws-serverX" server create "*.ws-serverX" CNAME.

How to set up DNS settings you can watch at

Installing Workspace base System

Create %WORKSPACE_HOME%\client_app_base and %WORKSPACE_HOME%\releases directory and place the preferred Workspace version inside it.

Go to Command Prompt(To open Command Prompt, click Start, click Run, type cmd, and then click OK or click Start, point to All programs, point to Accessories, and then click Command prompt) and from %WORKSPACE_HOME% directory extract the Workspace directory layout with the following command:
java -jar releases/Workspace_Standard-v(version)_shared-(build).zip

Set the database connectivity in the %WORKSPACE_HOME%\conf\ and %WORKSPACE_HOME%\conf\workspace_standard_(build).properties files:

Step 1/6 - JDBC Protocol Name
This is "mysql" if using MySQL.

Step 2/6 - Hostname
Usually "localhost" (database on the same computer).

Step 3/6 - TCP/IP Port
This can be left empty (default is used).

Step 4/6 - JDBC Username
This is usually "root"

Step 5/6 - JDBC Password
Check the password of databace. It is empty by default.

Step 6/6 - JDBC driver
Give the classname of your JDBC driver.
Usually: "com.mysql.jdbc.Driver"

The database connection is built.

Installing Workspace Organization

Execute the installation program with terminal from folder (WORKSPACE_HOME)\installers\Workspace_Standard-v(version)_shared-(build)

Create Organization
Create organization with following command: create.bat verkkokauppa.

Set host
Set the correct base url for the shop with following command: sethost.bat verkkokauppa

Open $WORKSPACE_HOME\ file for example like this: notepad %WORKSPACE_HOME%\ and map the virtualhost to organization.

Tomcat configuration
Create virtual host for the Workspace version to (TOMCAT_HOME)\conf\server.xml.

	<Host name="(build)" appBase="(WORKSPACE_HOME)\client_app_base" unpackWARs="false">
		<Context docBase="(WORKSPACE_HOME)\clients\workspace.client_standard_(build).war" path=""/>
	<Host name="localhost" appBase="(WORKSPACE_HOME)\admins" unpackWARs="false">
		<Context docBase="(TOMCAT_HOME)\webapps\ROOT" path=""/>

After the installation

After the installation you should restart Tomcat.

The Workspace Administration Interface should now be found at:
Depending on the options you selected while installing Workspace.

The default user name and password for the Administration Interface are user and password.

After the first login, you should change the password into something else.

< Previous page     Page 3 / 3

^ Contents
<< Back to HOWTO index