Breadcrumbs

Configuration

The global server settings are defined in a default Java properties file. The application contains a file with default settings that can be either edited directly in the file or overloaded with an external properties file. Changes to the settings only come into effect after the application has been restarted.

[WEB-APP-ROOT]/WEB-INF/classes/settings.properties
[WEB-APP-ROOT]/ssu_web-x.x.x.x.war/WEB-INF/classes/settings.properties

This section describes the possible settings in the properties file and how these settings can be configured.

The following pages describe the various areas of configuration options:


Environment and system variables

Every setting in the properties file can also be configured/overwritten by Java system properties and environment variables. The points in the variable names can be replaced by underscores (optional).

Format:
signotec.ssu.[SETTING]

Examples:

  • Bash
    export signotec_ssu_business_licenseKey=myLicenseKey
    
  • Bash
    set signotec.ssu.business.licenseKey=myLicenseKey
    
  • Bash
    -Dsignotec.ssu.business.licenseKey=myLicenseKey
    
  • Environment variables containing full stops are not permitted in every operating system. We recommend replacing all full stops with underscores. signotec.ssu.business.licenseKey - > signotec_ssu_business_licenseKey

  • We recommend using the Java system properties as retrieving the environment variables can vary between different Java servers.

Outsourcing configuration

To simplify application maintenance, settings should be stored separately from the web application. Instead of editing the default settings in the delivery package, settings should be defined in an external properties file. Make a copy of the default settings and use the environment variable signotec_ssu_externalpropertiesfile to specify the storage location for the copy.

Bash
export signotec_ssu_externalpropertiesfile=/myConfigFolder/ssu/settings.properties

The default settings will load initially when starting signoSign/Universal and these will then be expanded/overwritten by the external settings.