Skip to content

Installing Debian Packaged Version

Shane Alcock edited this page Mar 25, 2019 · 4 revisions

This page covers instructions that will help with installing and configuring OpenLI via the Debian / Ubuntu packages that we have created.

Getting the packages

WAND maintains an (unofficial) Debian & Ubuntu apt repository on Bintray where we make packaged versions of our software available to the public.

To enable the OpenLI repository on Debian or Ubuntu, run the following commands:

sudo apt-get install apt-transport-https curl
echo "deb https://dl.bintray.com/wand/general $(lsb_release -sc) main" | sudo tee -a /etc/apt/sources.list.d/wand.list
echo "deb https://dl.bintray.com/wand/libtrace $(lsb_release -sc) main" | sudo tee -a /etc/apt/sources.list.d/wand.list
echo "deb https://dl.bintray.com/wand/OpenLI $(lsb_release -sc) main" | sudo tee -a /etc/apt/sources.list.d/wand.list
curl --silent "https://bintray.com/user/downloadSubjectPublicKey?username=wand" | sudo apt-key add -
sudo apt-get update

Now you should be able to install the packages for any of the OpenLI components using:

sudo apt-get install openli-<component>

(where component is one of 'mediator', 'provisioner' or 'collector').

Configuring the OpenLI components

The configuration files for each component are located in /etc/openli/. The names of the files that the OpenLI services will attempt to read as configuration files are provisioner-config.yaml, mediator-config.yaml, and collector-config.yaml -- it should be fairly obvious which file is used to configure each component.

You will also find some example configuration files for each component installed in the /etc/openli directory.

More details on the configuration file formats and the meaning of each field within can be found in the documentation installed in /usr/share/doc/openli or within the doc/ directory of the source code.

Running the OpenLI components

Each OpenLI component that you install will register itself as a service with systemd, so you can start an OpenLI component simply by running:

sudo systemctl start openli-provisioner.service    OR
sudo service openli-provisioner start

Old-school types who hate systemd can also invoke the init script directly:

sudo /etc/init.d/openli-provisioner start

By default, the OpenLI component services will NOT be enabled to start on boot; however you can do this yourself fairly trivially via systemd.

Stopping an OpenLI component

Simply repeat the command that you used to start the OpenLI service, except replace the start with stop.

Reloading the configuration for an OpenLI component

If you've modified one of the configuration files and would like to have the running component re-load its configuration and apply any changes, simply do one of the following:

sudo systemctl reload openli-provisioner.service    OR
sudo service openli-provisioner reload              OR
sudo /etc/init.d/openli-provisioner reload

Reading component logs

Each OpenLI component will write any log messages to /var/log/openli.

Logrotate is used to manage the log files so that OpenLI try to avoid filling up /var/ over time with log messages.

You can’t perform that action at this time.