-
Notifications
You must be signed in to change notification settings - Fork 48
System Configuration
-
Configuration file behaviour
-
Configuration file location
-
Configuring logs
-
Network settings
-
Language
-
Other settings
The configuration of the java library has impacts on the behaviour of all the connectors and can be modified by means of the configuration.properties file.
The connector reads the configuration just once, when the java library is first loaded by the JVM.
The connector looks for the configuration file in the current directory first and, if the file is not found, it tries to read the SDMX_CONF environment variable. If this variable is not set or the file is not found again, a default configuration is applied (default configuration should fit most environments, anyway).
The tracing level is set, by default, to INFO and writes to stdout. To modify it you can change some of the following parameters:
SDMX.level = FINER
### Logging configuration
#handlers= java.util.logging.FileHandler
handlers= java.util.logging.ConsoleHandler
java.util.logging.ConsoleHandler.level = FINER
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
You can modify the trace level, format and destination. Refer to the Java Util Logging documentation for details.
If you have to use the connectors through a proxy, you can add the following entries to the configuration file:
#### Network configuration
http.proxy.default = yourProxyHostDefault:yourProxyPortDefault
http.proxy.name0 = yourProxyHostname0:yourProxyPort0
http.proxy.name0.urls = sdw-wsrest.ecb.europa.eu,stats.oecd.org, ...
If needed, you can also specify different provider URLs for different proxies, adding http.proxy.name1, http.proxy.name1.urls, etc.
If your proxy needs authentication (we only support kerberos and basic type), you can specify it by the following entries:
KERBEROS
http.auth.preference = Kerberos
java.security.krb5.conf = yourKRB5ConfigurationFile
java.security.auth.login.config = yourJAASLoginConfigurationFile
BASIC
http.auth.preference = basic
http.auth.user = yourDomain\\yourUser (OPTIONAL)
http.auth.pw = yourPassword (OPTIONAL)
NOTE about basic authentication:
It is not advisable to leave the password in a plain text file. For this reason, if basic auth is configured, but user and password fields are not filled, the connector will interactively ask for proxy credentials at startup.
HTTPS and certificates
If a provider uses the HTTPS protocol, the Java Virtual Machine has to be instructed for using a keystore where the provider certificates have been loaded. In this case you can use the following configuration property:
javax.net.ssl.trustStore = full/path/to/your/KeyStore
If you want to temporarily disable certificate check (this is useful for testing purposes, but not advisable in general), you can do it using the following property:
ssl.disable.cert.check = false
The default language of the connectors is English. This means that, if names and descriptions for the SDMX elements are found in multiple languages, they will be returned in english (if present). To change the preferred language you can use the sdmx.lang property to a valid locale. E.g.:
sdmx.lang = it