Get started with QueueMetrics Live

Thanks for choosing QueueMetrics Live!

We already have taken care of the installation of your system; all you have to do now is to install Uniloader, our data loader.
That's quite simple, just follow the steps.


Installing on FreePBX, Elastix and RPM-based distros

In order to connect your PBX, install the Loway repository then install Uniloader with yum:

wget -P /etc/yum.repos.d http://yum.loway.ch/loway.repo
yum install uniloader


After that open the /etc/sysconfig/uniloader file; delete or comment the Local QueueMetrics section and uncomment all the QueueMetrics-Live section, then replace the instance name and the password with the ones you received from our team.

Now install the QueueMetrics dialplan, first of all copy the file into the right path:

cp /usr/local/uniloader/extensions/extensions_queuemetrics.conf /etc/asterisk/.


And now include it into the dialplan, by adding #include extensions_queuemetrics.conf at the end of /etc/asterisk/extensions_custom.conf, or if don't exists in /etc/asterisk/extensions.conf.

Now restart your PBX machine, then connect to your QueueMetrics-Live instance using the demoadmin user and the password you received and verify that you're receiving data from the PBX, in System Diagnostic Tools -> Live DB inspector.

Installing Uniloader on Yeastar S PBXs

Click here to see how to connect your Yeastar S-series PBX to QueueMetrics-Live directly from your MyPBX control panel.

Installing Uniloader on Yeastar U/N PBXs

In order to connect your Yeastar PBX to QueueMetrics-live, firstly download our auto-configurating script:

wget http://get.queuemetrics-live.com/yeastar

Then execute it:

sh yeastar

Follow the automated procedure, then reboot the system when finished. Then connect to your QueueMetrics-Live instance using the "demoadmin" user and the password you received and verify that you're receiving data from the PBX, in "System Diagnostic Tools" -> "Live DB inspector".

The last step is to setup the AMI connection, create in your PBX an admin AMI user then go into QueueMetrics configuration, from the "Edit system parameters" page and find the callfile.dir property and set it as follows:

callfile.dir=tcp:username:password@127.0.0.1
In Yeastar machines by default you already have an "admin" user and the password is "password".
Keep in mind that 127.0.0.1 is correct, since this connection string has to be seen from the Uniloader point of view, which resides on the PBX machine.

Installing Uniloader on other PBXs

You should have received an email that specified:

  • Your access URL
  • Your unique instance code
  • A default admin login
  • A default password

Keep them close at hand.

  1. Log into your PBX as root

  2. Download and Uncompress Uniloader:
    cd /opt wget http://downloads.loway.ch/qm/uniloader-0.2.0.tar.gz
    tar xzf uniloader-0.2.0.tar.gz

  3. You'll notice that in the uniloader-0.2.0 path you have a bin and a extensions directory.
    In the bin directory you have three different executables, your choice depends on the architecture of your system (amd64, 386, arm7); in this example we'll use the amd_64 and we'll copy it in the main directory for our convenience.
    cp /opt/uniloader-0.2.0/bin/uniloader_amd64 /opt/uniloader-0.2.0/uniloader
  4. Now we'll make sure that Uniloader starts together with the system, adding the following command at the end of the /etc/rc-local file:
    nohup nice /opt/uniloader-0.2.0/uniloader --src=/var/log/yslog/queue_log upload --uri http://my.queuemetrics-live.com/QMLIVE_ID --login webqloader --pass PASSWORD &
    Replace the QM-Live ID and Password with the one you received in the email.

  5. Now install the QueueMetrics dialplan, first of all copy the file into the right path:
    cp /opt/uniloader-0.2.0/extensions/extensions_queuemetrics.conf /etc/asterisk/.
    And now include it into the dialplan, by adding this line at the end of /etc/asterisk/extensions_custom.conf, or if don't exists in /etc/asterisk/extensions.conf

  6. Now restart your PBX machine, then connect to your QueueMetrics-Live instance using the "demoadmin" user and the password you received and verify that you're receiving data from the PBX, in "System Diagnostic Tools" -> "Live DB inspector".

  7. The last step is to setup the AMI connection, create in your PBX an admin AMI user then go into QueueMetrics configuration, from the "Edit system parameters" page and find the callfile.dir property and set it as follows:
    callfile.dir=tcp:username:password@127.0.0.1
    Keep in mind that 127.0.0.1 is correct, since this connection string has to be seen from the Uniloader point of view, which resides on the PBX machine.

What's next?

Create your queues in QueueMetrics
QueueMetrics will only report on queues that you have defined, so make sure you create them from the Queues menu. Just add a name and the very same code used on the PBX.

Create your own agents
By creating your own agents, you will see their own names and not the codes used to track them.

Create users for your agents so that they can log-in
If you want your agents to be able to use QueueMetrics as their workbench, just create new users for them in class "AGENTS". The login must match the agent code used on the PBX.


Need help?

QueueMetrics ships with very extensive documentation; you can find it here.

Encountering any problems during your trial? Contact us.
Comments? Suggestions? Let us know.