Skip to content

Upgrading to 1.0.4

Shane Alcock edited this page Feb 10, 2020 · 4 revisions

In OpenLI 1.0.4, the format of the provisioner configuration file has changed significantly -- intercept-related configuration (i.e. IP and VOIP intercepts, agency details and core server information) has been moved into a separate config file that is now managed by the provisioner itself.

Configuration relating to the specific operation of the provisoner component (e.g. ports to listen on for connections from mediators and collectors) remains in the provisioner config file.

Users who are upgrading from an earlier version of OpenLI to OpenLI 1.0.4 will need to modify their existing provisioner configuration to conform to the new layout.

Manual fix

This can be done manually by following the steps given below:

  1. Choose a location for your intercept configuration file. /etc/openli/running-intercepts.yaml is a good option if you have no strong preferences.
  2. Create an empty file at that location and copy all YAML configuration for the listed sections from your provisioner config file (e.g. /etc/openli/provisioner-config.yaml) into your new file:
ipintercepts:
voipintercepts:
agencies:
radiusservers:
sipservers:
  1. Save the new intercept config file and remove the configuration that you just copied from the provisioner config file.
  2. Add a new line to your provisioner config file (replace with filename with the one you chose in step 1, if you picked something different):
intercept-config-file: /etc/openli/running-intercepts.yaml
  1. Restart your provisioner service.

Scripted fix

If you are not confident with using the manual approach, we have implemented a python script that will split your old provisioner config into two files for you.

The script can be found at https://github.com/wanduow/openli/blob/master/utils/update-provconf-1.0.4.py

The script requires python3 and pyyaml to run.

Make sure you read all of the documentation at the top of the script file before running the script, as there are a few caveats to be aware of.

Clone this wiki locally