Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

This document only addresses:

Panel
indent

# the Web services directory structure that is being deployed by
ISDA-
 DSPS,
\\
# the Web services system environmental variable and its related configuration files,
\\
# the Web services system environmental variable and its related sub-directories, and
the containers directory.
\\
# the *containers* directory.\\

1. Web services directory structure that is being deployed by

...

DSPS

Panel

Below is the directory structure that is currently being deployed by ISDA- DSPS.

2. Web services system environmental variable and its related configuration files

Panel

WSETCDIR is a system environmental variable and a JVM property that contains the directory path to the 'root' of the web services directory structure. The $WSETCDIR root directory contains 2 properties files, webserviceConfig.properties and mastermanagement.properties, and are described below:

  webserviceConfiguration.property file

Section
Column
width2%

Column
width98%

File name

webserviceConfig.properties

Path

$WSETCDIR/webserviceConfig.properties

Type

Java properties file

Description

This file contains the directory paths that is used by a web service to access to access resources that it needs.  See the Directory Structure above.

Section
Column
width2%

Column
width98%

The syntax of each entry of this file is:

    <key>=<directory path>

Where <key> can be any of the following:

key

description

logsdir

path to where the web service log files are to be stored. This keyword is required.

basedir

this the directory under which all other web service directories and files are found. This must correspond to the value of the environmental variable $WSETCDIR. This keyword is required.

containersdir

path to the containers directory. This keyword is required.

keystoredir

path to the keystore directory. This keyword is required.

jmxmastermanagement

path to the mastermanagement.properties file. This keyword is required.

applicationcertificatejks

path to the application certificate java keystore that is used by JMX. This keyword is required.

servertruststorejks

path to the trusted servers java keystore that is used by JMX. This keyword is required.

When specifying the path, the path must be explicated defined. Do not use the environmental variable. Below is an example. Assume that $WSETCDIR contains /usr/local/etc/map/ws.

      logsdir=/usr/local/etc/map/ws/logs
      basedir=/usr/local/etc/map/ws
      containersdir=/usr/local/etc/map/ws/containers
      keystoredir=/usr/local/etc/map/ws/keystore
      jmxdir=/usr/local/etc/map/ws/jmx
      krbdir=/usr/local/etc/map/ws/krb
      jmxmastermanagement=/usr/local/etc/map/ws/mastermanagement.properties
      applicationcertificatejks=/usr/local/etc/map/ws/keystore/mapping.app.mit.edu.jks
      servertruststorejks=/usr/local/etc/map/ws/keystore/serverTrustStore.jks

In the above, mapping.app.mit.edu.jks is the application certificate keystore and serverTrustStore.jks is the trusted server keystore.

  mastermanagement.property file
Section
Column
width2%

Column
width98%

File name

mastermanagement.properties

Path

$WSETCDIR/mastermanagement.properties

Type

Java properties file

Description

This file contains the Tomcat container/JMX port mapping. The properties file is configured and deployed by ISDA- DSPS.

No further description of this file will be provided other than to say that the mastermanagement.properties file is auto generated and should not be modified.

...