For documentation on the current version, please check Knowledge Base.
Logging
This page contains some notes on how to enable and configure database logging of view requests handled by the IOS extension. These fields can be logged for each view : Customer name, Timestamp, View size and Layerlist.
The EOS server also has logging capabilities.
Configuration File
The following entries must be added to the <installation root>/config/ios.ini file :
############################## IOS LOG SETTINGS ############################# wms.log.view.enabled false wms.log.view.datasourcename logdb wms.log.view.tablename views wms.log.view.url.prefix /customer/ wms.log.view.url.suffix /ios
These settings are :
- wms.log.view.enabled : Logging enabled?
- wms.log.view.datasourcename : Name of the datasource, containing the 'views' table.
- wms.log.view.tablename : Name of the 'views' table.
- wms.log.view.url.prefix : Customer name prefix.
- wms.log.view.url.suffix : Customer name suffix.
Database Setup
You must prepare a table (default name is 'views') defining the following columns :
- customer (text) : Name of the customer
- when (date/time) : Timestamp
- width (number) : Width of the view
- height (number) : Height of the view
- layers (text) : Comma-separated list of layers
The server accesses this table through a 'datasource'. A datasource defines the access to a database for the eos server.
Using the JDSA utility, you can add the datasource.
Customer Definition
Standard WMS services are more or less generic services that don't need you to perform any 'login' or 'logout' operations.
This implies that it is impossible to detect which user makes which request.
To solve this, IOS also logs a customer name. This customer name is extracted from each request URL handled by the ios extension.
To extract a customer name the wms.log.view.url.prefix and wms.log.view.url.suffix settings define a prefix and suffix.
The customer name is extracted from the request URL by detecting what's inbetween the prefix and the suffix strings.
Example : Requests for a client using http://www.server.com:90/customer/Steve/ios? as its base url, will be logged for customer 'Steve'.