Skip to content

Usage and Integration

Arun Kumar edited this page Jul 21, 2024 · 4 revisions

0.General configuration

In order to work correctly you need to tell oxalis what configuration should be used. There are three things that need to be done :

0.1. Create configuration files

-oxalis.conf

-oxalis-logback.xml

0.2 Create a keystore

Besides those two files you need a keystore(jks) in which your peppol certificate is present. This is described in : https://github.com/OxalisCommunity/oxalis/blob/master/doc/keystore.adoc

0.3 Set environment variable

Create an Oxalis home directory in which you place files that do not change between new releases of Oxalis. We recommend that you name the Oxalis home directory .oxalis in what is considered the home directory of the user running Oxalis. If you are using Tomcat, it should be the home directory of the tomcat user. Remember to set the $OXALIS_HOME environment variable referencing your Oxalis home directory in your shell startup script. Example: export OXALIS_HOME=~/.oxalis

After doing this there are several ways Oxalis could be used :

1. Oxalis running on Tomcat application server (Incoming)

This is a common used option, the oxalis.war is run on Tomcat application server.

Basic setup for this is described in : https://github.com/OxalisCommunity/oxalis/blob/master/doc/installation.md

The AS4 extention andhow to implement this is described in the following document : https://github.com/OxalisCommunity/Oxalis-AS4/blob/master/docs/installation/tomcat.md

2. Oxalis running as a docker image (Incoming)

Docker images can be found at https://hub.docker.com/r/norstella/oxalis/tags

You can run the image via the following command :

docker run --rm -id -v "/somelocation:/oxalis/conf" -v "/somelocation/ext:/oxalis/ext" -v "/somelocation/plugin:/oxalis/plugin" -v "/somelocation/outbound:/oxalis/outbound" -v "/somelocation/inbound:/oxalis/inbound" --name "yourcontainername" -p 8080:8080 norstella/oxalis:latest

Please be sure to provide the correct volume and port mappings

3. Oxalis run as standalone server/Jetty (Incoming)

Oxalis can be used as as standalone item with integrated webserver.

The easiest way is to download the full server package from Maven : https://search.maven.org/search?q=a:oxalis-server

You can unzip this which results in the following directory structure :

-bin

-conf

-ext

-inbound

-lib

-plugin

Within the bin directory you can start the server with the run.sh or run.bat command In the conf directory you need to define your oxalis.conf as described in : To be further documented

4. Outbound with oxalis-standalone.jar (Outgoing)

Place oxalis (e.g. oxalis-distribution-6.6.0-distro) and oxalis-as4 (e.g. oxalis-as4-6.6.0-dist) in classpath. Make sure oxalis.conf is configured with relevant details. You can send document to Peppol network using below commands:

For windows: java -cp "D:\oxalis-distribution-6.6.0-distro\bin\*;D:\oxalis-as4-6.6.0-dist\*" eu.sendregning.oxalis.Main -f "D:\document.xml"

For Linux: java -cp "D:\oxalis-distribution-6.6.0-distro\bin\*:D:\oxalis-as4-6.6.0-dist\*" eu.sendregning.oxalis.Main -f "D:\document.xml"