2 Installing and Updating Workspace


2.5 Initial Preparations  <<  2.6  >>  2.7 Installing Workspace Organization 

2.6 Installing Workspace base System

Create $WORKSPACE_HOME/releases directory and place the preferred Workspace version inside it

Extract the Workspace directory layout with the following command
# cd $WORKSPACE_HOME
# java -jar releases/Workspace_Standard-v(version)_shared-(build).zip
New files and directories are being created


  • installers - Contains a directory for each installed version of Workspace.


    • Use the scripts inside these directories to install, upgrade and modify organizations



  • admins - Workspace administration webapps

  • clients - Workspace webshop webbapps

  • conf - Configuration file for each installed Workspace version

  • filemanager - Files for each installed organization

  • logs - Workspace related log files

  • plugins - Workspace plugins

  • temp - Temporary files

  • organization.properties - Maps each virtualhost to organization

Because nowadays Tomcat deploys every webapp and directory inside appBase we need to create empty directory $WORKSPACE_HOME/client_app_base

Set the database connectivity


  • $WORKSPACE_HOME/conf/operator.properties

  • $WORKSPACE_HOME/conf/workspace_standard_(build).properties

Create virtual host for the Workspace version to (TOMCAT_HOME)/conf/server.xml


  • The client webapps hostnames are based on build numbers

  • All admin webapps share one virtualhost and appBase

<Host name="localhost" appBase="($WORKSPACE_HOME)/admins" unpackWARs="false">
  <Context docBase="(TOMCAT_HOME)/webapps/ROOT" path=""/>
  <Alias>admin.ws-serverX.smilehouse.com</Alias>
</Host>
Host mapping for organizations is discussed in next chapter.