Reference9:IQM Server Setup

The parameters for the setup of the iQM sever are configured here.

iQM Version 1.50

Panel COMMUNICATION

IP Address PBX

IP address of the innovaphone PBX, for example 172.14.5.6. If you operate the innovaphone PBX on a specified Port address you have to specify this (for example “172.14.5.6:1234” for port 1234), in usual setups not necessary.

Admin user

Admin user for login the PBX (for example “admin”)

Admin Password

the password to access to the PBX (for example “ip800”). Please note that the credentials must be the one of the administrator, the SOAP session requires full access to the PBX.

Dyna-PBX-id

if the iQM should work on a dyna-PBX (multiple PBX) you must define the ID of that PBX (example: “987654321”, see dyna PBX for the ID). Left blank if iQM is not working on a Queue located in a dyna-PBX (typical setup).

HTTPS

Select if you have activated the HTTPS flag in the PBX. Please note that a port indicated in the IP Address PBX field is ignored. Do not flag if no HTTPS is switched on in the PBX.

iQMagent client port

Indicate the port for the iQM clients, default is “9090”. Of cause you must also indicate the same port in the iQMclient setup. In the iQMclient you have to indicate also the IP-address of the PC where iQMserver is running. The field “own IP address” shows you the IP address of the iQM server PC.

If you install on a PC several iQM remember to assign in the Setup for each different Port Number for the communication with the client. If you leave default port (and so the same one) the second iQM will crash after start-up.

Panel STANDBY PBX

Standby PBX IP-Adr.

IP address of the innovaphone Standby-PBX, for example 172.14.5.6. If you operate the innovaphone PBX on a specified Port address you have to specify this (for example “172.14.5.6:1234” for port 1234), in usual setups not necessary.

If this field is blank no standby PBX is defined.

Admin user

Admin user for login the Standby-PBX (for example “admin”)

Admin Password

Indicate the password to access to the Standby PBX (for example “ip800”). Please note that the credentials must be the one of the administrator, the SOAP session requires full access to the PBX.

HTTPS

Select if you have activated the HTTPS flag in the Standby-PBX. Please note that a port indicated in the IP Address PBX field is ignored. Do not flag if no HTTPS is switched on in the Standby-PBX.

Panel SOAP

SOAP user

indicate the name of the SOAP use in the innovaphone PBX. Remember that the “soap user” is just a normal user object, requires no license and has no number. PBX: Specify a new user in the PBX (to simplify we recommend to give name, short name and display name the same one) and assign a group to this object and make the group active (*). Remember that all agents have to be in that group, but nor active.

Panel QUEUE

Queue Long Name

Long Name of the waiting queue to monitor (example: "myQueue”) . PBX: Assign an active group to this Queue in the PBX and put also all Agents in. This is also the Primary group to point on in the WQ configuration. This group must be a dynamic group for Agents. See picture at the end of this article or local help or read the howto article if not clear.

Agent Group

in this field you specify the primary agent group name (the one where the waiting queue is pointing on). See picture at the end of this article or local help or read the howto article if not clear.

Note: from version 1.54 on this information will be read out from the PBX setup and has not to be configured.

PC sound if Alarm

If one of the thresholds is reached and the iQM signals an alarm (relative button is flashing red and alarm counter is increased) the PC play the Wave file indicated in the “File” field. If no file is indicated the innovaphone MOH is played.

Alarm auto reset

the PC will play the file in loop until the alarm is quitted if this field is blank. Here you can define in seconds a maximum duration of playing even is the alarm is not quitted. Example: “10” – the PC will play for 10 seconds after the alarm goes on and then stop playing.

File: pressing the button a file dialog windows appears and you can define the wave file to play.

2nd Queue Name

in this field you specify the primary agent group name (the one where the waiting queue is pointing on). See picture at the end of this article or local help or read the howto article if not clear.

2nd Dyna Agent Group

name of the second agent group (the one where the second waiting queue is pointing on). See picture at the end of this article or local help or read the howto article if not clear.

Note: from version 1.54 on this information will be read out from the PBX setup and has not to be configured.

Panel DATA LOGGING

Actual path of log files

iQM stress the files as default (on first start up and if never defined a path) in the application user directory (typically “C:\Users\YourAccount\AppData\Roaming\”). If more than one iQM should work on one single PC you can activate them installing using different PC users. But it is simpler install all the iQM’s with the same user indicating different path for data logging (and user setup, it will be used is the same path). So in this filed you will see the actual path. Remember that even the setup data are stored in a file in this directory. All iQM files will start with “iQMxxx” and are simple text or XML files.

Set log directory

if you press this button a path dialog window will appear and you can define the path for data and setup data. This path will be stored in the directory where iQM is running in a file named “iQM_Logdir.txt”. If that file exists iQM will load the path and then try to load and store the data there. If you like return to the default path (“C:\Users\YourAccount\AppData\Roaming\”) you have to indicate that in the Path or delete the file “iQM_Logdir.txt”.

CSV character

In the log file a record contains different data. If nothing indicated in this filed a space will separate the single data fields in a record. Example “10.01.2011 17:44:00 00000:12” – between date, time and counter value is a space. If in this filed you indicate for example a “/” the result will be: “10.01.2011/17:44:00/00000:12”.

iQM ID

iQM can send an Email to the supervisor. In the object field will be indicated the text of this field (max. 20 character). This is usefully if more iQM reports to the same supervisor, so with a glance he can identify the iQM “sender”.

e-mail

e-mail account: the e-mail destination adress for the reports (example: kwa@innovaphone.com)

e-mail server: e-mail server address (example: 135.23.34.1)

Password: password for e-mail (not necessary if MS exchange)

The following four options switch on the sending of e-mails:

Mail each hour: the Actual hour counters are send to the supervisor each hour.

Mail each day: the Actual day counters are send to the supervisor each midnight

Mail if alarm: if an Alarm trigger an email containing the alarm counters value is send to the supervisor.

Note: if email is activated (account/server defined) an email is automatically generated when the reset button is pressed, the value of the resettable counters are transmitted.

Panel LAYOUT

Montore Label

is the label displayed in the top line if iQM

Language

Select the language. See relative Wiki article for further information.

Always in foreground

if selected the iQM form is displayed always on top of other windows even without focus.

Layout

different background colors are available.

Password for setup

if defined it is necessary to input the password to access to this menu, if black direct access is possible. Please note that after inserting the password you have to press the “setup” button again.

Panel AGENT EXCEL LOGGING

Logging ON

Select if you want switch on the Excel Data logging. Please not hat Excel has to be installed on the IQM server PC. Panel disabled if iQM detect no Excel installed.

Send Agent Data each day

If selected the statistical data will be transmitted each day at midnight (if not just at the end of the month).

Notes

All parameters are stored in an xml file named “iQM_Setup.xml” in the directory of the log files. If deleted the iQM will start blank (in this case no communication is tried) like after a initial installation, if this file is copied to an other installation you have done a clone (just from the setup,remember that the license is stored in the PBX). In theroy this file can also be edited with a normal text editor.

Until this page is open communication with Agent/the PBX is interrupted. Therefore a long opened session will cause a new setup session for the SOAP communication while Agents probably will go into a timeout and have to restart their session. This behavior is independent if the setup is leaved with or without saving of the setup data.

Some setup parameter requires a reset (for example a new IP-Adress), means a new start of the application, some not (for example a different Layout). A warning triangle will show you in the iQM view if a restart is necessary or not.