Skip to content

Latest commit

 

History

History
314 lines (223 loc) · 6.89 KB

configuration.adoc

File metadata and controls

314 lines (223 loc) · 6.89 KB

Configuration

lookup.locator.busdox.maxRetries=1
lookup.locator.busdox.timeout=30  # in seconds
lookup.locator.bdxl.maxRetries=1
lookup.locator.bdxl.timeout=30 # in seconds

Upgrading to 5.0

Oxalis already supporting default CNAME lookup, so configuration 'lookup.locator.class' is Not required in oxalis.conf. If it exist then either remove it or comment it out: #lookup.locator.class=network.oxalis.vefa.peppol.lookup.locator.BusdoxLocator

HTTP Client parameters (validate_after_inactivity & time_to_live) made configurable

oxalis.http.pool.validate_after_inactivity = 1000
oxalis.http.pool.time_to_live = 30

Upgrading to 4.0

This is an overview of keys used for configuration when converting from Oxalis version 2.x/3.x to Oxalis version 4.x.

As of version 4.0 is the configuration file named oxalis.conf.

oxalis-globals.properties (pre 4.0) oxalis.conf (4.0+) Default value (4.0+)

Database

oxalis.datasource.jndi.name

oxalis.database.jndi.resource

jdbc/oxalis

oxalis.jdbc.driver.class

oxalis.database.driver.class

org.h2.Driver

oxalis.jdbc.class.path

oxalis.database.driver.path

null

oxalis.jdbc.connection.uri

oxalis.database.jdbc.connection

jdbc:h2:file:data/oxalis

oxalis.jdbc.dialect

Removed

oxalis.jdbc.user

oxalis.database.jdbc.username

sa

oxalis.jdbc.password

oxalis.database.jdbc.password

blank

oxalis.jdbc.validation.query

oxalis.database.dbcp.validation

select 1

HTTP

oxalis.connection.timeout

oxalis.http.timeout.connect

0

oxalis.read.timeout

oxalis.http.timeout.read

0

Keystore

oxalis.keystore

oxalis.keystore.path

oxalis-keystore.jks

oxalis.keystore.password

oxalis.keystore.password

changeit

New

oxalis.keystore.key.alias

ap

New

oxalis.keystore.key.password

changeit

Logging

oxalis.app.log.config

Removed

oxalis.inbound.log.config

oxalis.logging.config

logback.xml

Lookup

oxalis.sml.hostname

Removed - Depending on mode

Mode

oxalis.operation.mode

Removed - Detected using certificate

Proxy

oxalis.httpProxyHost

See Proxy.

oxalis.httpProxyPort

oxalis.proxyUser

oxalis.proxyPassword

Storage

oxalis.inbound.message.store

oxalis.path.inbound

inbound

oxalis.persistence.class.path

oxalis.persister.payload.service

default

oxalis.persister.receipt.service

default

Truststore

oxalis.truststore.password

Removed

Database

Data Source

Oxalis supports two different datasources out of the box;

  • dbcp - DBCP

  • jndi - JNDI

Default configuration
oxalis.database.datasource = dbcp

Driver

This is used when setting Data Source to dbcp.

Default configuration
oxalis.database.driver.class = org.h2.Driver
# oxalis.database.driver.path = (not set)

JDBC

This is used when setting Data Source to dbcp.

Default configuration
oxalis.database.jdbc.connection = "jdbc:h2:file:./data/oxalis"
oxalis.database.jdbc.username = sa
oxalis.database.jdbc.password = "" # (blank)

DBCP

This is used when setting Data Source to dbcp.

Default configuration
oxalis.database.dbcp.max.idle = 30
oxalis.database.dbcp.max.total = 100
oxalis.database.dbcp.validation = select 1

JNDI

This is used when setting Data Source to jndi.

Default configuration
oxalis.database.jndi.resource = jdbc/oxalis

File system

Home folder

Home folder is set as the first occurance in this list:

  1. Path specified in JDNI context with key java:comp/env/OXALIS_HOME.

  2. Path specified as a Java property with key OXALIS_HOME.

  3. Path specified as an environment variable with key OXALIS_HOME.

  4. Path .oxalis in home folder.

Other folders

Default configuration
oxalis.path.conf = "" # Blank
oxalis.path.inbound = inbound
# oxalis.path.plugin = (not set)

HTTP outbound

Outbound HTTP connections use Apache HttpComponents.

Connection pool

Oxalis uses a shared connection pool of keep-alive connections to speed up transmission.

Default configuration
oxalis.http.pool.max_route = 2
oxalis.http.pool.total = 20
oxalis.http.pool.validate_after_inactivity = 1000
oxalis.http.pool.time_to_live = 30

Proxy

Proxy is configured using Java properties as described in the Java 8 documentation.

Some relevant properties
  • java.net.useSystemProxies

  • http.proxyHost

  • http.proxyPort

  • http.nonProxyHosts

  • https.proxyHost

  • https.proxyPort

  • http.proxyUser

  • http.proxyPassword

Timeouts

Default configuration
oxalis.http.timeout.connect = 0
oxalis.http.timeout.read = 0

Java properties

It is recommended to set Java properties as part of running Oxalis - not having Oxalis set Java properties.

The recommended way of setting properties on command line.
java -Dhttp.proxyHost=10.0.0.50 -Dhttp.proxyPort=8080 ...

In some situations may it be needed to put Java properties in the configuration file. Java propterties in the configuration file will be set just after configuration is loaded.

Properties are added by simple prefixing them with oxalis.java.

Example Java properties in Oxalis configuration file.
oxalis.java.http.proxyHost = 10.0.0.50
oxalis.java.http.proxyPort = 80

Key store

keystore.path

Path to file containing key store. JKS is the historical format used, however PKCS#12 has shown to be possible to use as a replacement without changes to the code.

keystore.password

Password used to unlock the provided key store.

keystore.key.alias

Alias identifying the private key inside the key store to be used.

keystore.key.password

Password used to unlock the private key to be used.

Note
All configuration of key store and key is case sensitive.
Default configuration (review carefully)
oxalis.keystore.path = oxalis-keystore.jks
oxalis.keystore.password = changeit
oxalis.keystore.key.alias = ap
oxalis.keystore.key.password = changeit

Logging