XiVOcc Installation Troubleshooting¶

In order for the XiVOcc components to be fully functional, some customizations need to be done on the XiVOcc and the XiVO PBX.

This page can help to check that all the correct customization have been done by the installation package.

For the rest of this page we well make the following assumptions: - XiVO PBX has the IP 192.168.0.1 - XiVO CC has the IP 192.168.0.2

Important

Refer to the Architecture & Flows diagram.

Check XiVOcc Configuration¶

Check the prerequisites¶

the OS must be Debian 11 (Bullseye), 64 bit,
Docker must be installed,
Docker-compose must be installed,
the XiVO PBX must be reachable on the network.

Check ntp installation¶

The XiVO CC server and the XiVO server must be synchronized to the same source NTP source.

Check Logrotate configuration¶

A file /etc/logrotate.hourly/docker-container must be present which should log rotate files /var/lib/docker/containers/*/*.log

You can test it with logrotate -fv /etc/logrotate.hourly/docker-container. You should get some output and a new log file with suffix [CONTAINER ID]-json.log.1 should be created. This file is compressed in next rotation cycle.

Check Docker compose¶

No alias for docker-compose should be defined. The following command should return “OK”:
```
alias |grep -E 'docker-compose|dcomp' || echo "OK"
```
The version of the docker images in the file /etc/docker/compose/docker-xivocc.yml must be in the form ${XIVOCC_TAG}.${XIVOCC_DIST} and these variables must be set in the /etc/docker/compose/factory.env file:
```
...
xivo_stats:
    image: xivoxc/xivo-full-stats:${XIVOCC_TAG}.${XIVOCC_DIST}
...

xuc:
    image: xivoxc/xuc:${XIVOCC_TAG}.${XIVOCC_DIST}
...
```

Check the services¶

The list of the services launched should look like :

# xivocc-dcomp ps
           Name                         Command               State                        Ports
---------------------------------------------------------------------------------------------------------------------
xivocc_elasticsearch_1      /usr/local/bin/docker-entr ...   Up             0.0.0.0:9200->9200/tcp, 0.0.0.0:9300->9300/tcp
xivocc_kibana_1             /usr/local/bin/dumb-init - ...   Up             0.0.0.0:5601->5601/tcp
xivocc_logstash_1           /usr/local/bin/docker-entr ...   Up             0.0.0.0:5044->5044/tcp, 9600/tcp
xivocc_pack_reporting_1     /bin/sh -c echo "WEEKS_TO_ ...   Up
xivocc_pgxivocc_1           docker-entrypoint.sh postgres    Up             0.0.0.0:5443->5432/tcp
xivocc_recording_rsync_1    /usr/local/sbin/run-rsync.sh     Up             0.0.0.0:873->873/tcp
xivocc_recording_server_1   bin/recording-server-docker      Up             0.0.0.0:9400->9000/tcp
xivocc_spagobi_1            /bin/sh -c /root/start.sh        Up             0.0.0.0:9500->8080/tcp
xivocc_xivo_stats_1         /usr/local/bin/start.sh /o ...   Up
xivocc_mattermost_1         /entrypoint.sh mattermost        Up (healthy)   8000/tcp
xivocc_nginx_1              /bin/sh -c /bin/bash -c "e ...   Up             0.0.0.0:443->443/tcp, 0.0.0.0:80->80/tcp,
                                                                            0.0.0.0:8443->8443/tcp, 0.0.0.0:9100->9100/tcp
xivocc_xuc_1                bin/xuc_docker                   Up             0.0.0.0:8090->9000/tcp
xivocc_xucmgt_1             bin/xucmgt_docker                Up             0.0.0.0:8070->9000/tcp

Check the XiVO PBX¶

Check PostgreSQL configuration¶

Connection from the XiVO CC for user asterisk must be authorized. See file /var/lib/postgresql/11/main/pg_hba.conf which must contain a line:
```
host asterisk all 192.168.0.2/32 md5
```
A user stats must exists. Use command \dg in psql.

Check AMI configuration¶

A xuc user must be configured in the file /etc/asterisk/manager.d/02-xivocc.conf
The command:
```
asterisk -rx "manager show user xuc"
```

must show the user.

CEL Configuration¶

The correct events must be activated in the file /etc/asterisk/cel.conf:

[general]
enable = yes
apps = dial,park,queue
events = APP_START,CHAN_START,CHAN_END,ANSWER,HANGUP,BRIDGE_ENTER,BRIDGE_EXIT,USER_DEFINED,LINKEDID_END,HOLD,UNHOLD,BLINDTRANSFER,ATTENDEDTRANSFER

[manager]
enabled = yes

Check CTI configuration¶

In Services ‣ IPBX ‣ Users a user the must be created with the following parameters:

CTI login : xuc
CTI password : <randomly generated password>
Profile supervisor

Check WS configuration¶

In Configuration ‣ Web Services Access a user must be created with the following parameters :

Login : xivows
Password : xivows
Host : 192.168.0.2

Check ACD configuration¶

In Services ‣ Ipbx ‣ Advanced configuration make sure Multiqueues call stats sharing is checked.

Check the phone integration¶

Verify that the phone configuration where customized as detailed in Required configuration for phone integration.

Check the recording¶

The package xivocc-recording must be installed on XiVO PBX (see Recording) and configured (see Recording).