The Touchpoint Server runs inside a web container. The default web container shipped with TDI is configured by the following properties in global.properties or solution.properties:
The Touchpoint Server first considers the value of the api.remote.bind.address property and if that is not set, the value of the com.ibm.di.default.bind.address property. In this way it is able to effectively filter the access to "multi-homed" hosts.
The web container is able to use SSL for securing the transportation layer. It reuses the Remote API's settings and is enabled by setting the api.remote.ssl property. SSL client authentication is enabled by the api.remote.ssl.client.auth.on property. The server SSL keys are configured using the well known Remote API properties:
HTTP basic authentication (http://tools.ietf.org/html/rfc2617) can be configured using the tp.server.auth and tp.server.auth.realm properties. It is disabled by default. See section Authentication for more information on authentication.
The configuration of the Touchpoint Server is specified using an XML file. The path to this file is specified in the global.properties or solution.properties file using the property tp.server.config. An example Touchpoint Server configuration file is shipped in the etc directory of the TDI installation.
The following syntax is used by the Touchpoint Server configuration file:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <tp:tpServerConfig xmlns:tp="http://www.ibm.com/xmlns/prod/tdi/71/tp" tp:version="1.0"> <!-- specifies the entryption settings used when encrypting passwords --> <tp:encryptionConfig stash="idisrv.sth"> <tp:keyStore>testserver.jks</tp:keyStore> <tp:keyStoreType>jks</tp:keyStoreType> <tp:keyAlias>server</tp:keyAlias> <tp:transformation>RSA</tp:transformation> </tp:encryptionConfig> <tp:templateConfig> <tp:baseTemplate>etc/TouchpointTemplate.xml</tp:baseTemplate> <!-- Specify the path to the directory that holds the Touchpoint templates. --> <!-- <tp:customTemplatesDir>templates</tp:customTemplatesDir> --> </tp:templateConfig> <!-- specifies the persistence settings that configure the place to persist the state --> <tp:persistenceConfig> <tp:enabled>true</tp:enabled> <tp:location>tp_state</tp:location> </tp:persistenceConfig> <!-- configures the touchpuoint providers (nodes) --> <tp:nodeConfigs> <!-- Default connection to the local server --> <tp:tdiNodeConfig tp:local="true" tp:id="default"> <!-- The host of the remote node which all Provider Touchpoint Instances will receive requests on --> <tp:providerHost>localhost</tp:providerHost> <!-- The port of the remote node which all Provider Touchpoint Instances will receive requests on --> <tp:providerPort>1097</tp:providerPort> <tp:title>Example Touchpoint Provider</tp:title> <tp:author>John Doe</tp:author> <tp:email>jdoe@example.org</tp:email> <tp:summary>Example Touchpoinet Provider Atom Entry</tp:summary> <tp:conatct>Local Administrator</tp:conatct> <tp:location>Main building, 5th fl.</tp:location> <tp:organization>Example Organization</tp:organization> </tp:tdiNodeConfig> <!-- Here is an example of a remote server connection --> <!-- <tp:tdiNodeConfig id="remote" local="false"> <tp:title>Example Touchpoint Provider</tp:title> <tp:author>John Doe</tp:author> <tp:email>jdoe@example.org</tp:email> <tp:summary>Example Touchpoinet Provider</tp:summary> <tp:host>localhost</tp:host> <tp:port>1099</tp:port> <tp:user>username</tp:user> <tp:password protect="true" encrypted="false">password</tp:password> <tp:contact>Jack Smith</tp:contact> <tp:location>5th fl.</tp:location> <tp:organization>Example Organization</tp:organization> <tp:providerHost>locahost</tp:providerHost> <tp:providerPort>1097</tp:providerPort> </tp:tdiNodeConfig> --> </tp:nodeConfigs> </tp:tpServerConfig>