Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.Sign up
Installing Debian Packaged Version
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
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
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
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
Logrotate is used to manage the log files so that OpenLI try to avoid filling up
/var/ over time with log messages.