Browser Client Layout

Introduction

Starting with KCML 7.09 mod_wcm.so has been modified to make it easier to set up a browser client system by separating out the different components into separate sub-directories. Most of these subdirectories will be symbolic links to the KCML installation of JClient or to a standard place for jQuery, for example. Also it is now possible to support several services with a single Directory setting in the Apache configuration by using subdirectories named after the service.

user1/apache			Top level - will appear as in the Apache configuration.
	DRIVE		The name of a service.
		jclient	Will be a symbol link to a JClient installation such as /usr/local/kcml/JClient.
		jquery	Will be a symbol link to a directory containging jquery.js
		settings	Contains FormColor.css and FormColor.js. Typically will be a symbolic link to $KBIN/settings
		images	Will be a directory containing all application images. Contents will be created by the ico2png utility.
	DRIVE2		Another service. Several services can use a single Apache directory configuration.
		...
	login		Optional directory for a login web page.
		login.htm
	cgi		Optional directory for cgi scripts

Apache configuration

Alias /jclient /user1/apache
<Directory /user1/apache>
	Options All
	AllowOverride None
	Allow from all
	# This necessary for local page
	DirectoryIndex local.htm
	# Optional gzip of output, requires mod_deflate
	AddOutputFilterByType deflate text/plain text/html text/css application/x-javascript
	# Set this to use connection manager
	KcmlAppServers localhost:790
	KcmlLogging /tmp/kcml.log 9
	<Files Start*>
		# For authentication so we have a user to launch kcml
		#AuthName "TOOLSET2 realm"
		AuthType wcm
		KcmlAuthProvider                cm
		KcmlAuthSecret  auto
		ErrorDocument 401 /jclient/login/login.htm
		Require valid-user
		# For development systems set this to On; for live set to Off
		KcmlExpandJs On
	</Files>
</Directory>
<Location /jclient/cgi>
	Options 	+ExecCGI
	SetHandler	cgi-script
</Location>

A KcmlAuthSecret value of auto will generate, and store, a random key in /etc/kcml/KcmlAuthSecret .

mod_wcm.so