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
# 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=""/>
Host mapping for organizations is discussed in next chapter.