"SSA INTEGRATION PACK FOR SSA ERP LN - VERTEX O SERIES" - CONFIGURATION OPTIONS
-------------------------------------------------------------------------------
General
-------
All bridge-specific configuration files can be found in the directory
<installDir>/etc where <installDir> is the bridge's installation directory.
As shipped, the files contain reasonable defaults. None the less, you are likely
to have to edit the configuration in order to get a working setup. Especially
take a look at the sections 'The bus component' and 'The bridge' in this
document.

Defaults
--------
As shipped, the configuration files are suitable for a system as described
below.
 - Your OpenWorld system has a bus component called 'vertex' configured that
   your bridge installation can listen on. For example, a bus component with a
   URI of the form 'socket://<host>:9090', where <host> is the name of the
   machine on which the bridge is installed.
 - The vertex web service is running on the same machine as the bridge is
   running on.
 - The vertex web service is listening on port 8080 and is installed in the
   default web context (there where the vertex documentation suggests it should
   be installed)
 - Within the vertex environment a user 'ssa' is defined with password 'ssa123'
   that has sufficient rights to perform tax calculations and update the tax
   register
If any of these statements do not hold for your system, you will need to alter
the configuration files to fit.

The bus component
-----------------
Relevant configuration file:
  <installDir>/etc/buscomponent.cfg
The 'SSA Integration Pack for SSA ERP LN - Vertex O Series' needs an 
OpenWorld bus component to listen on. SSA ERP can then send requests for the 
'SSA Integration Pack for SSA ERP LN - Vertex O Series' to this bus component. 
By default this bus component is named 'vertex'. Of course a bus component with
that name also needs to actually exist in the OpenWorld system. Read the
OpenWorld documentation to find out how to create and edit bus components.
If you want the 'SSA Integration Pack for SSA ERP LN - Vertex O Series' 
to listen on a bus component with a different name, 
edit the buscomponent.cfg configuration file. This file simply
contains the name of the bus component to use. Be carefull not to put any
additional unnecessary characters in this file.

The bridge
----------
Relevant configuration file:
  <installDir>/etc/vertex.properties
To establish a connection to the Vertex web service a number of parameters are
needed. They are configured in the vertex.properties configuration file. The
file contains a list of key/value pairs, each pair on a separate line. Lines
starting with '#' or '!' are ignored, as are empty lines. For details of the
file format (such as how to include non-ASCII characters), see documentation for
the standard Java class java.util.Properties (http://java.sun.com).
The recognised keys are:
  address.lookup.tax.areas
    The HTTP URL to use when looking up tax areas.
  address.calculate.tax
    The HTTP URL to use when calculating tax and updating the tax register.
  user.name
    The user name to use when connecting to Vertex.
  password
    The password to use when connecting to Vertex.

Logging
-------
Relevant configuration file:
  <installDir>/etc/logging.properties
The 'SSA Integration Pack for SSA ERP LN - Vertex O Series' makes use of the 
standard Java logging facility. There are many configuration options for this 
framework. For details read the documentation which comes with the J2SE download 
(http://java.sun.com).
The shipped default configuration logs errors and warnings to the console. There
is also a log file configured which contains more information (it contains
details of all inbound/outbound requests and responses). The log file is
configured to rotate every 1,000,000 bytes. By default the file current log file
(if only one bridge is running) is called taxbridge0.log0 and can be found in
the home directory of the user under who's user id the bridge is running.
As an example of how to alter the logging configuration: to maximise the amount
of detail shown in the log file change the line
  .level= INFO
to
  .level= FINEST
in the logging.properties configuration file.
If a problem cannot be diagnosed using the log file described above, it may be
necessary to examine the OpenWorld logging. See the OpenWorld documentation on
how to configure and use this.

Other configuration files
-------------------------
Relevant configuration files:
  <installDir>/etc/james.cfg
  <installDir>/etc/bridge.properties
The files listed above must not be changed. They are only of interest to the
developers of the 'SSA Integration Pack for SSA ERP LN - Vertex O Series'. 
Changing the contents of these files will almost certainly cause the 
'SSA Integration Pack for SSA ERP LN - Vertex O Series' to break.
