Migrating Uniloader from RPM to tar.gz installation
Uniloader used to be installed and updated with yum install uniloader. The Loway yum repository is no longer available, so installations made this way can no longer be updated with yum. This tutorial shows how to move to the .tar.gz release, which is installed with a script called install.sh, without losing your configuration.
How to migrate Uniloader from the yum (RPM) package to the tar.gz installation
If you installed Uniloader on FreePBX, PBXact, Elastix or any other RPM-based system with yum, you have to switch to the .tar.gz installation the next time you want to upgrade. It takes about ten minutes, and from then on every update is just one script: you download the new package and run install.sh again.
The new installation script also takes care of your settings: it finds the configuration files of the old installation and places them in /etc/default/, so you do not have to type them in again.
The procedure has five steps:
- Back up your configuration files
- Remove the RPM package
- Install the new version with
install.sh - Check the configuration that was migrated
Before you start
- You need root access to the PBX (or to the machine where Uniloader runs).
- The system must be running systemd. Most current distributions have it, including the CentOS-based ones used by FreePBX and PBXact. The script will abort if the system does not meet this requirement.
- The machine needs internet access to download the package from
downloads.loway.ch. If the PBX is isolated, download the file elsewhere and copy it over. - Plan a short maintenance window: data is not uploaded while Uniloader is stopped.
Step 1 - Back up your configuration files
Never start by removing anything. Even if the installation script migrates your settings for you, we always recommend keeping a copy of the originals first. This command packs every configuration file that exists on your system into one archive:
tar czf /root/etc-backup-$(date +%F).tar.gz /etc
Copy the archive off the machine as well (with scp, for example): if something goes wrong with the PBX itself, you still have your settings.
The files that should be included in the /etc directory, along with the Uniloader file, are:
| File | What it is |
|---|---|
/etc/sysconfig/uniloader |
Main Uniloader configuration |
/etc/sysconfig/unitracker |
Event tracking service |
/etc/uniloader_splitter.json |
Splitter configuration, if you use it |
/etc/audiovault |
AudioVault, if you use it |
Step 2 - Remove the RPM package
Stop the service and remove the package:
systemctl stop uniloader
yum remove uniloader
The last command checks that nothing is left, so it should print nothing. If it lists other Uniloader packages, remove them too:
rpm -qa uniloader
If you do not use the Loway repository for any other package, you can also delete the repository file, which is no longer useful and may cause warnings when you run yum:
rm /etc/yum.repos.d/loway.repo
If you installed the Loway repository alongside another repository, please edit the command and remove the repository entry that contains your settings.
Otherwise, removing the repository is not mandatory.
Step 3 - Install the new Uniloader version with install.sh
Download, extract, and install it using the following commands:
wget https://downloads.loway.ch/software/uniloader/uniloader-26.10.1.tar.gz
tar xf uniloader-26.10.1.tar.gz
cd uniloader-26.10.1
./install.sh
The installation script does the following for you:
- installs Uniloader system-wide, so that you can call it from any shell
- finds the configuration files of your previous installation and places them in
/etc/default/, so the new services start from your old settings - restarts all related services and makes it start automatically at boot
- installs a script called
check.shthat tests the settings of each service
Step 4 - Check the configuration that was migrated
The configuration files of every service are now in /etc/default/.
Check that your parameters are correctly configured and have been successfully migrated from the old path.
If a value is missing or wrong, correct it by hand using the backup as a reference. The new files contain comments that explain each setting. Logs are now available with journalctl -u uniloader.
Keep the configuration file readable only by root, since it contains a password.
The connection type
If your old file used a direct MySQL connection (a URI starting with mysql:), it is kept as it was, with URI, LOGIN, the password and TOKEN (the partition).
This is however a good moment to switch to the HTTP/S connection with the webqloader user, which is the new and recommended way of sending data: see our tutorial on migrating Uniloader from a MySQL connection to the webqloader user.
If you use QueueMetrics Live, the URI is the address of your instance and LOGIN is webqloader.
Updating in the future
From now on, updating is the easy part. Download the new package, unpack it and run the installation script again:
wget https://downloads.loway.ch/software/uniloader/uniloader-<new-version>.tar.gz
tar xf uniloader-<new-version>.tar.gz
cd uniloader-<new-version>
./install.sh
When updating, your configuration files are not changed, while the unit files are replaced with the current version.
QueueMetrics References
For more technical information about QueueMetrics call center solution please refer to the User Manual.
About QueueMetrics
QueueMetrics is a highly scalable monitoring software that lets you track agent productivity, payrolls, measure targets, conversion rates, queues/ACDs, IVRs, music-on-hold, generate outbound campaign statistics and monitor realtime processes with customizable wallboards.
You can measure all activities in your contact center with more than 200 different metrics and manage realtime processes with live alarms and full control on calls and extensions, including whisper, spy and barge modes.
QueueMetrics is available on premise or as a cloud hosted service, and it is compatible with FreePBX, Grandstream, Issabel, MiRTA, Enswitch, Yeastar S PBX, VitalPBX, FusionPBX and many other Asterisk- and Freeswitch-based systems. It also supports Microsoft Teams telephony.
For more technical information please refer to the User Manual.
Visit www.queuemetrics.com for a free 15-day full-featured trial.
keyboard_arrow_left Back