Configuration files

This page provides information on configuring the WallStreet Adapter.

The following configuration files can be found under the <framework_root>/global_config/overrides/WallStreetAdapter/etc directory when the adapter is deployed to the Caplin Deployment Framework.

Adapter configuration files

The following configuration files are provided with the adapter.

adapter.conf

Reserved for future use.

app.properties

WSS client-library configuration file.

Connection
Item Default Description

objecttoolkit.typed

POOLED

Do not change.

objecttoolkit.server

Required. The hostname or IP address of your WSS core server. Example: 192.168.1.60

objecttoolkit.port

Required. The port number of your WSS core server. Example: 8080

objecttoolkit.user

Required. The username with which the Wallstreet Adapter authenticates with your WSS core server. Example: bob

objecttoolkit.pass

Required. The password with which the Wallstreet Adapter authenticates with your WSS core server. Example: letmein

Pool of physical socket connections
Item Default Description

objecttoolkit.pool.preload

4

Number of idle connection objects with which to preload the pool.

objecttoolkit.pool.apache.minEvictableIdleTimeMillis

1740000

The minimum amount of time (in milliseconds) an object may sit idle in the pool before it is eligible for eviction due to idle time. Specify -1 to stop threads from being evicted on the basis of idle time alone.

objecttoolkit.pool.apache.timeBetweenEvictionRunsMillis

30000

Indicates how long the eviction thread should sleep before "runs" of examing idle objects. Specify -1 to disable the eviction of idle threads.

objecttoolkit.pool.apache.maxActive

-1

Maximum number of connection objects, whether active or idle, that are allowed in the pool. Specify -1 for no limit.

objecttoolkit.pool.apache.maxIdle

-1

Maximum number of connection objects that are allowed to sit idle in the pool. Specify -1 for no limit.

Pool of JBS user sessions
Item Default Description

jbs.pool.apache.maxActive

-1

Maximum number of connection objects, whether active or idle, that are allowed in the pool. Specify -1 for no limit.

jbs.pool.apache.maxIdle

-1

Maximum number of connection objects that are allowed to sit idle in the pool. Specify -1 for no limit.

Licence file locations
Item Default Description

objecttoolkit.license

license.txt

The location of the Wallstreet client licence file.

objecttoolkit.license.signature

signature.txt

The location of the Wallstreet client signature file.

jbs.server.wsscore.xml.file

wsscore.xml

The location of the Wallstreet client configuration file.

SSL/TLS configuration
Item Default Description

objecttoolkit.keyStorePassPhrase

The pass phrase to the Java key store containing the adapter’s TLS certificates

objecttoolkit.sslKeyStore

The path to the Java key store holding the adapter’s TLS client certificate.

objecttoolkit.sslTrustStore

The path to the Java key store holding the adapter’s TLS trusted certificates.

objecttoolkit.sslKeyManager

For example, Ibmx509

objecttoolkit.sslSSLProvider

For example, com.ibm.jsse2.IBMJSSEProvider2

objecttoolkit.sslContext

Leave blank or specify TLS. Defaults to TLS if left blank.

datasource-overrides.conf

Contains the following DataSource configuration items:

  • Peer definition (add-peer) for Liberator

  • Peer definition (add-peer) for Transformer

  • The location of the adapter’s log directory (log-dir)

  • The adapter’s logging level (log-level)

For more information on DataSource configuration, see DataSource Configuration Reference: Introduction.

log4j2.xml

Configuration file for Apache Log4J 2.

For more information on Log4J configuration, see Log4J Configuration Syntax.

permissions.yaml

Caplin Permissioning API for Java configuration file.

trading-provider.properties

Caplin Trading API for Java configuration file.

WSS client-licence files

The Wall Street Systems client licence files are not provided with the adapter.

Request a client licence from Wall Street Systems and copy the licence files to the <framework_root>/global_config/overrides/WallStreetAdapter/etc/ directory. Alternatively, copy the licence files to custom locations, and specify the custom locations using the configuration options in the Licence file locations table above.

Wall Street Systems client licence files
Licence file Description

license.txt

Client licence.

signature.txt

Digital signature of the client licence.

wsscore.xml

Client licence configuration file.

Do not edit the files of the client licence. The licence is digitally signed, and editing the licence invalidates it.