Running the FRINX ODL Distribution
This guide explains how to run the distribution for the first time. If you have run it previously, please see this guide
RAM: 2GB minimum; we recommend 4GB.
Java: Releases based on Beryllium and Boron (and subsequent releases) require Java 8.
Linux: Unless stated otherwise, this documentation assumes you are using Linux.
Download and activate the FRINX ODL Distribution
Please click on the following link to download a zip archive of the FRINX ODL Distribution:
By downloading the file you accept the FRINX software agreement: EULA
Start your FRINX ODL Distribution for the first time
To activate your installation, unzip the file and open the directory. Enter the following commands in a terminal (the token is unique to your user account on frinx.io and cannot be shared with other users).
bin/karaf frinx.createtoken [frinx-license_secret-token]
Activating the FRINX ODL Distribution behind a proxy
Please set up java system properties as described here: https://docs.oracle.com/javase/6/docs/technotes/guides/net/proxies.html
This means running karaf with something like this:
JAVA_OPTS="-Dhttp.proxyHost=10.0.0.100 -Dhttp.proxyPort=8800" bin/karaf frinx.createtoken
Activating the FRINX ODL Distribution on a server without Internet access
Let’s call the connected computer ONLINE and the one where you want to run karaf OFFLINE.
OFFLINE# TOKEN="insert your token here"
OFFLINE# KARAF_HOME="insert path to karaf"
OFFLINE# echo "token=$TOKEN" > $KARAF_HOME/etc/frinx.license.cfg
Generate fingerprint json to a local file:
OFFLINE# $KARAF_HOME/bin/karaf frinx.fingerprint > fingerprint.txt
Now, copy fingerprint.txt to the ONLINE machine:
ONLINE# curl https://license.frinx.io/api/v1/obtain-license -d "@fingerprint.txt" -H 'Content-Type: application/json' -X PUT > frinx.license.cfg
Copy frinx.license.cfg back to OFFLINE machine, replacing the file in karaf’s etc folder. You will be able to start karaf normally: