Skip to content

Configuration Guide

Arun Kumar edited this page Feb 16, 2025 · 1 revision

Table of Contents

Configurations introduced in Oxalis-NG 1
Configurations introduced in Oxalis 7
Configurations introduced in Oxalis 5
Configurations introduced in Oxalis 4
Proxy Configuration
Legacy Configuration


Configurations introduced in Oxalis-NG 1

access.point.isReceiverCheckEnabled=false
my.access.point.url="http://api.example.com/oxalis-ng/as4"
access.point.name="YOUR_AP_NAME_HERE"
access.point.logo="YOUR_AP_LOGO_HTTPS_URL_HERE"

Configurations introduced in Oxalis 7

lookup.locator.busdox.timeout=30
lookup.locator.busdox.maxRetries=3
lookup.locator.busdox.enablePublicDNS = false 
lookup.locator.bdxl.timeout=20
lookup.locator.bdxl.maxRetries=2
lookup.locator.bdxl.enablePublicDNS = false

Configurations introduced in Oxalis 5

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

#For default CNAME lookup
lookup.locator.class=network.oxalis.vefa.peppol.lookup.locator.BusdoxLocator
#For NAPTR lookup
#lookup.locator.class=network.oxalis.vefa.peppol.lookup.locator.BdxlLocator

Configurations introduced in Oxalis 4

oxalis.path.inbound = "C:/OXALIS_HOME/inbound-files/"
oxalis.logging.config = logback.xml
# Timeouts & HTTP Pool
oxalis.http.timeout.connect=3300000
oxalis.http.timeout.read=3300000
oxalis.http.pool.validate_after_inactivity=3300000
oxalis.http.pool.time_to_live=3300000
oxalis.http.pool.max_route = 2
oxalis.http.pool.total = 20

Proxy Configuration

Proxy is configured using Java properties as described in the Java 11 documentation

Some relevant properties

  • java.net.useSystemProxies
  • http.proxyHost
  • http.proxyPort
  • http.nonProxyHosts
  • https.proxyHost
  • https.proxyPort

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 properties 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

Legacy Configuration

oxalis.database.datasource = dbcp
oxalis.database.driver.class=org.mariadb.jdbc.Driver
oxalis.database.jdbc.connection="jdbc:mysql://127.0.0.1/oxalis"
oxalis.database.jdbc.username="root"
oxalis.database.jdbc.password="<SOME-PASSWORD>"
oxalis.database.dbcp.max.idle = 30
oxalis.database.dbcp.max.total = 100
oxalis.database.dbcp.validation = select 1