Release Notes

Naos

Below is a list of New Features and Behavior Changes compared to the previous LTS version, Maia (2024.05).

New Features

CC Agent

  • When selecting a pause status in the drop down it is now possible to filter them via a search bar - see Pause Cause and Status

  • When clicking on a search result and then on the information icon, a contact sheet with various details opens. - see Contact modal

USM

  • More information available about the xivo configuration & the xivo usage of client

  • Add provd stats to usm conf database

  • Add applicationType in LoginEvent event

  • Version infos available in the existing config table

  • New USM counters pushed to the backend

Edge

Recording

  • Improvement of record search in the recording server to enhance user experience (from Maia.05). Currently, there are a simple search and an advanced search tabs with many more filters.

  • In queues with the Recording mode set to Recorded on demand, calls for which recording was never started will not appear anymore in the recording list in the recording server.

XiVO PBX

  • Be abe to customize factory dialplan via templates

XiVOCC Infra

  • CC Postgres now synchronized with the XiVO database container version.

Xuc Server

  • (Since Naos.02) Websocket messages throttling parameters can now be confiugred via env variable - see Throttling

  • (Since Naos.10) PhoneStatusUpdate api can now be based on contact instead of extension - see Phone Status Update

System

Behavior Changes

System

  • Since SpagoBI is outdated and no longer receives open-source updates, we’ll stop building our SpagoBI image after Maia: 2024.05.latest. This image will continue to work for future releases, starting with Naos.

XiVO PBX

  • Added support for dialplan templating:

    The dialplan was previously directly installed by xivo-config` as .conf files under /usr/share/xivo-config/dialplan/asterisk. Now, those files are installed as templates under /usr/share/xivo-config/templates/dialplan/asterisk. Calling xivo-update-config replaces the content from the executed /usr/share/xivo-config/dialplan/asterisk to override such template DO NOT edit it directly as it would be invalidated by a xivo-config upgrade. Please instead go to /etc/xivo/custom-templates/dialplan/asterisk , create a file with the same name and content as the one you want to override, edit this one file and apply your modifications by calling xivo-update-config. xivo-update-config also reloads the dialplan if it changed something.

Recording

  • In queues with the Recording mode set to Recorded on demand, calls for which recording was never started will not appear anymore in the recording list in the recording server.

Deprecations

This release deprecates:

Upgrade

Manual steps for LTS upgrade

Warning

Don’t forget to read carefully the specific steps to upgrade from another LTS version

Generic upgrade procedure

Then, follow the generic upgrade procedures:

Naos Bugfixes Versions

Components version table

Table listing the current version of the components.

Note

Because the SpagoBI technology is growing old and does not receive open-source updates, we won’t build our SpagoBI image after the one from Maia: 2024.05.latest. That image will still work just as before for further releases, starting with Naos.

Component

current ver.

XiVO

xivo

2024.10.13

config-mgt

2024.10.11

db

2024.10.02

outcall

2024.10.00

db_replic

2024.10.08

nginx

2024.10.13

web-interface

2024.10.11

switchboard_reports

2024.10.00

usage-writer

2024.10.13

usage-collector

2024.10.08

agid

2024.10.12

confgend

2024.10.10

asterisk

8:20.6.0-1

docker-ce

5:25.0.5

docker-compose

2.26.1

XiVO CC

mattermost

2024.10.00

nginx

2024.10.03

pack-reporting

2024.10.00

pgxivocc

2024.10.00

recording-rsync

2024.10.00

recording-server

2024.10.00

spagobi

2024.05.00

full-stats

2024.10.07

xucserver

2024.10.13

xucmgt

2024.10.13

Edge

edge

2024.10.10

nginx

2024.10.08

kamailio

2024.10.01

coturn

2024.10.00

Meeting Rooms

meetingroom

2024.10.00

web-jitsi

2024.10.00

jicofo-jitsi

2024.10.00

prosody-jitsi

2024.10.00

jvb-jitsi

2024.10.00

jigasi-jitsi

2024.10.00

IVR

ivr-editor

2024.10.02

2024.10.13 (Naos.13): May 2026

Consult the 2024.10.13 (Naos.13) Roadmap.

Components updated:

Docker: xivo-usage-writer, xivo-webi-nginx, xucmgt, xucserver

Debian: xivocc-installer, xivo

CC Agent

  • #8824 - Pause status list is not updated in CC Agent when agent (un)paused from elsewhere

CC Manager

  • #8792 - CC Manager - Some actions on agents are not displayed

CTI

  • #8857 - Introducing remote actor for Conference tracker

  • #8878 - Deactivate mattermost rate limiting per user

Mobile App

  • #8834 - MobileApp >= 2.6.4 cannot connect on UC Addon server - missing version file

Usage statistics

  • #8891 - USM metrics to fix

WebRTC

  • #8930 - Palliative for no sound on first call with Windows 11 and Chrome

2024.10.11 (Naos.11) - 2024.10.12 (Naos.12): November 2025

Consult the 2024.10.11 (Naos.11) Roadmap.

Components updated:

Docker: config-mgt, xivo-agid, xivo-web-interface, xucmgt, xucserver

Debian: xivo-config, xivo-fetchfw, xivo-utils, xivo

CC Agent

  • #8011 - [C] - impossible de connecter/deconnecter ou mettre en pause un agent avec les extensions: *30<PHONE NUMBER>*<AGENT NUMBER>

CC Manager

  • #8704 - [C] - Can’t change activity failed destination from CC Manager

CTI

  • #8720 - As a user I would like to be able to reset the fwd value

    Important

    Behavior change It is now possible to reset the value of the forward from UC app or Webi.

Provisioning

  • #8690 - Provd is not using the http proxy anymore

UC App

  • #5419 - [C] - Cannot transfer because of ghost calls in xuc

XiVO PBX

  • #8292 - Callerid(name) might be erased after having passed through in_callerid AGI

    Important

    Behavior change This bugfix (for Caller Number Normalization) keeps the CallerID(name) from incoming sources if there was any, where it was erased before. This may have the side effect of disabling reverse lookup Reverse lookup for some callers (those who already had a CallerID(name) won’t see it changed).

  • #8403 - Call fails when push notification fails when WebAppAndMobileApp is chosen

  • #8722 - Change asterisk log format to ISO 8601 with milliseconds

    Important

    Behavior change Asterisk log dateformat is now using ISO8601 with ms : YYYY-mm-dd HH:MM:SS.MMM`

    Before

    After

    [Nov 13 10:50:56] VERB…

    [2025-11-13 10:50:56.252] VERB

2024.10.10 (Naos.10): October 2025

Consult the 2024.10.10 (Naos.10) Roadmap.

Components updated:

Docker: xivo-agid, xivo-confgend, xivo-edge, xivo-usage-collector, xivo-usage-writer, xucmgt, xucserver

Debian: xivocc-installer, xivo

CTI

  • #8478 - User cannot include a participant into an audio conference because the xuc wrongly sees him in a finished conference

Edge

  • #8396 - SIP packets sent by kamailio are seen coming from another port than 5060

System

  • #8603 - Missing getter setter asterisk java

  • #8620 - asterisk-java-lib - unexpected warnings on MeetMeJoinEvent, MeetMeLeaveEvent, DAHDIChannelEvent, MeetMeTalkingEvent, ManagerEvent

UC App

  • #8358 - Update Moment.js dependency to 2.29.2

  • #8362 - Update jquery-ui to 1.13.3

  • #8364 - Number display on contact sheet bug

  • #8374 - Be able to link PhoneStatusUpdate API to phone registration status (instead of its hint status)

    Important

    Behavior change No change by default: Phone Status Update API is plugged on the registration status of the endpoint and its calling status.

    But there is a new option XUC_PHONE_STATUS_FROM_SIP_CONTACT which, if set to true will plug the Phone Status Update API to the the registration status only.

  • #8390 - PhoneHintStatusEvent not properly updated

  • #8432 - Cannot import personal contacts

  • #8453 - UA - Unconditionnal forward activated by a UA user toward an internal user on same MDS is not followed when UA user is in WebRTC mode

Usage statistics

  • #8329 - USM - I want to known the clients addon configured

WebRTC

  • #8331 - Given a SIP video device calling a WebRTC user, the call fails

XiVO PBX

  • #8467 - chan_sip rtp{keepalive,holdtimeout} options not translated to their pjsip equivalent

  • #8468 - Fix contact generation when auth username contains a domain (id@domain)

  • #8469 - Fix contact generation when auth username contains a domain (id@domain) ensuring URI contains port

    Important

    Behavior change Before this version, the contact URI of the trunk aor was created:

    1. from the Rewriting the From field-User field,

    2. and if not present from the Authentication username field

    Now the contact URI of the trunk aor is created from the Authentication username: field only:

    • if the Authentication username field does not contain any @ (the usual case) then the contact URI is created with Authentication username @ Host : Port

    • but, if the Authentication username field does contain an @:

      • if Authentication username contains a domain which is not void (e.g the @ is not the last character) then the contact URI is directly created out of Authentication username : Port

      • if Authentication username does not really contain a domain (e.g. the @ is the last character) then the contact URI is created out of Authentication username Host : Port

2024.10.09 (Naos.09): April 2025

Consult the 2024.10.09 (Naos.09) Roadmap.

Components updated:

Docker: config-mgt, xivo-agid, xivo-ctid, xucmgt

Debian: xivo-utils, xivo

API

  • #8321 - Configmgt - Fix swagger definition for /api/2.0/users/username/

Asterisk

  • #8340 - Automate asterisk crash information backup and retrieval

    Important

    Behavior change It adds the cron xivo-save-asterisk-crash-info which runs daily to seek for new asterisk crashes (core dump). When there is a core dump found it will retrieve the asterisk full and syslog logs files.

    Warning: depending on the size of these logs it may load the system during the execution of the cron.

CC Manager

  • #8328 - CC Manager - Add PercentageAnsweredTotal in the Queue view

CTI

  • #8338 - Can’t connect more than 1024 UC user

XiVO PBX

  • #8301 - Add xivo username available in usercallback context

2024.10.08 (Naos.08): April 2025

Consult the 2024.10.08 (Naos.08) Roadmap.

Components updated:

Docker: config-mgt, edge-nginx, xivo-agid, xivo-db-replication, xivo-usage-collector, xivo-usage-writer, xivo-web-interface, xucmgt

Debian: xivo-config, xivo-fetchfw, xivo-upgrade, xivo

Asterisk

  • #8254 - add global subroutine in user callback

    Important

    Behavior change A new global subroutine is available in usercallback context.

CCManager

  • #8225 - CC Manager - Pause status

Edge

  • #6882 - Kerberos - Authorization header too long when using Edge Browser

Mobile App

  • #8240 - Application Mobile : Optimisations xivo_global.conf

Provisioning

  • #8291 - Cannot download Yealink firmwares

Reporting

  • #8231 - Add replicated fields in xivo_stats database

System

  • #8246 - Be able to specify the linename when creating or updating a line

    Important

    Behavior change Configmgt API to create or update a line now allows to specify the line name.

UC App

  • #8293 - Use all available space between avatar and buttons for contact information

Usage statistics

  • #8212 - USM - Send mobile usage data to usm server

  • #8220 - USM - Fix Usage Writer config_xivo Delays

XiVO PBX

  • #8219 - XDS - Enable/Disable voicemail thanks to *90 does not function

  • #8228 - New Display cannot receive fields and thus be configured

  • #8268 - Upgrade XiVO PBX/CC: –force upgrade for the playbook (no questions asked)

    Important

    Behavior change On a regular upgrade for xivo,mds and/or xivocc towards this version and higher, any versionned file will be reset to the upstream version. If you had some specific configuration in a versionned file filename, it will automatically be moved to filename.dpkg-old ; you’ll have to retrieve them manually if you need to. Most of our versionned files already come with a way to override them in a non-versionned way, you may want to persist those changes this way.

2024.10.07 (Naos.07): February 2025

Consult the 2024.10.07 (Naos.07) Roadmap.

Components updated:

Docker: config-mgt, xivo-full-stats, xivo-web-interface, xucmgt

Debian: xivo-config, xivo

Reporting

  • #8169 - Stat - Call thread id is broken when user_id is void

System

  • #8162 - API Group - Group members are not managed by group CRUD APIs

UC App

  • #8186 - I want to be able to make a consultation call while I’m in an audio conference

XiVO PBX

  • #8140 - xivo-config update should reload templated dialplan

  • #8200 - Call logs - No data

2024.10.06 (Naos.06): December 2024

Consult the 2024.10.06 (Naos.06) Roadmap.

Components updated:

Docker: xivo-web-interface, xucmgt, xucserver

CC Agent

  • #8132 - Update phone number after logout impossible on CCAgent and Switchboard

    Important

    Behavior change - Agents can now change the phone number they are connected to using a dedicated button in the CC Agent application. See Switch phone number - Agents no longer have to re-enter their login and password if they attempt to connect with an incorrect number or are already connected to a different number.

CCAgent

  • #8105 - Call qualification does not open sometimes

CTI

  • #8129 - Aastra phone auto answer in the speaker instead of the headset

UC App

  • #8136 - We should not send multiples history requests if a user log in / log out without restart the page

XiVO PBX

  • #8123 - Can’t save a field (userfield or description) containing a simple quote

2024.10.05 (Naos.05): November 2024

Consult the 2024.10.05 (Naos.05) Roadmap.

Components updated:

Docker: xivo-agid, xivo-full-stats, xucmgt, xucserver

Debian: xivo-config, xivo-service, xivo-sysconfd, xivocc-installer, xivo

Others: xivo-desktop-assistant

CTI

  • #8053 - As a UC Assistant user, I should be able to include a participant in an audio conference after being invited to a conference

  • #8087 - AMI keep alive mecanism sometimes missed ping if they were received too fast

Important

Behavior change AMI Connection keep alive:

  • The connection between the Xuc server and the Asterisk AMI is now monitored by periodic pings

  • These pings ensure regular traffic to keep the session active and help to detect connection instabilities

  • See details in AMI Keepalive

Desktop Assistant

  • #8075 - Desktop Assistant make tray icon more visible

    Important

    Behavior change The Desktop Assistant tray icon was updated to be more visible in OS task bar.

Recording

  • #2101 - Upgrade recording_rsync component AND disable reverse lookup in config

Reporting

  • #8092 - Stat - A call answered by a user in a group may associate this to call to a random agent in xc_queue_call

System

  • #8082 - Fix postgres path for High Availability

XiVO PBX

  • #8017 - As a XiVO User on MDS I want to be able to receive my calls on XConnect

  • #8018 - As a XiVO user I want my incoming call (via my DID) ring my XConnect user

  • #8067 - After xivo-service restart some services are not working (like dird search)

  • #8084 - Make xivo-naos default LTS for install scripts

2024.10.04 (Naos.04) - 2024-11

Consult the 2024.10.04 (Naos.04) Roadmap.

Components updated:

Others: xivo-desktop-assistant

Docker: xucmgt

CC Agent

  • #8072 - The “activities” menu is not displayed in CC Agent

  • #8073 - The minimize button is not displayed in CC Agent

  • #8074 - Links open from the Desktop application are open in electron window instead of browser window

2024.10.03 (Naos.03) - 2024-11

Consult the 2024.10.03 (Naos.03) Roadmap.

Components updated:

Docker: call-qualification, edge-nginx, xivo-web-interface, xivoxc-nginx, xucmgt, xucserver

Debian: xivo-upgrade, xivocc-installer, xivo

CC Agent

  • #8054 - In CC Agent when a pause state has a name > 80 char, it can’t be applied

CTI

  • #7988 - 💡 - As an admin I want to be able to control the keepalive for AMI connections

Call Qualification

  • #8055 - Call Qualification - Préselectionner le motif quand il n’y a qu’un choix

Switchboard

  • #8058 - The button to put a call in hold queue are not displayed anymore in the switchboard

System

  • #7927 - 💡 - Nginx should be extendable outside of it’s container

  • #8004 - Last version container download added

  • #8034 - Ansible upgrade playbook for UC Addon is broken

UC App

  • #8059 - Call popup on autoanswered calls is sometimes not properly closed

Usage statistics

  • #7984 - USM - Connection to RabbitMq for Usage Event is not created if rabbitmq is not accessible during xuc start up

2024.10.02 (Naos.02) - 2024-10

Consult the 2024.10.02 (Naos.02) Roadmap.

Components updated:

Docker: call-qualification, call-qualification-backend, edge-nginx, ivr-editor, xivo-db, xivo-edge, xivo-usage-writer, xivo-web-interface, xucmgt, xucserver

Debian: xivo-dird, xivocc-installer, xivo

CCAgent

  • #8003 - CC Agent - a user status update, updates the status of all the search result

  • #8013 - Hide contact perso edit button and fix tooltip

DevSpe

  • #7976 - Call qualification - Clarify XUC_HOST usage

  • #7977 - Call qualification - Be able to create a qualification without a call

Usage statistics

  • #7987 - USM - Writer for provd stats is not robust enough

Web Assistant

  • #8024 - Toast when inviting someone in a Meeting room is not displayed

XUC Server

  • #7990 - XuC - As a XiVO CC maintainer, i’d like to configure CTI Keepalive timer

    Important

    Behavior change Added option to configure CtiLink KeepAlive interval (by default 10mins) by passing the its duration in seconds to the following env variable in custom.env : XIVO_CTI_KEEP_ALIVE_INTERVAL

  • #8002 - Rest API get current agent config for user

  • #8023 - Websocket message rate limiting should be configurable per env var

    Important

    Behavior change WS Message throttling:

    • By default, the number of websocket messages is raised to 90 request messages within 30 seconds with a burst of 180

    • These values are now configurable by setting WS_THROTTLING_NB_MESSAGES and WS_THROTTLING_NB_MESSAGES_BURST environment variables in custom.env

    • See details in Throttling

XiVO PBX

  • #7961 - Ivr editor - Update color

  • #7981 - Can’t create a user without a line

  • #8020 - Refactore IVR documentation

  • #8031 - At each startup db complains that role rwfluentd does not exist

  • #8033 - Directory search for phone do not work out of the box following Contact Sheet

XiVOCC Infra

  • #7934 - Update date in release note to be more clearer

Edge

  • #7350 - Edge - Having a web page to validate Edge configuration (WS, TURN connectivity …)

  • #8030 - Edge Nginx - Increase default workers setting to (at least) allow 10K users to connect to XiVO UC through edge

    Important

    Behavior change Two changes for the Edge Nginx component:

    • it is now configured to set the worker_connections to 20000 by default - see ref:edge_feature_proxy_web_nb_connection.

    • it is now configured to tune the worker_processes at startup - see ref:edge_feature_proxy_web_nb_connection.

2024.10.01 (Naos.01) - 2024-10

Consult the 2024.10.01 (Naos.01) Roadmap.

Components updated:

Docker: edge-kamailio, xucserver

edge

  • #7989 - XiVO Bridge can open Sip websocket via edge

2024.10.00 (Naos.00) - 2024-09

Consult the 2024.10.00 (Naos.00) Roadmap.

Components updated:

Debian: xivo-config, xivo-purge-db, xivo-upgrade, xivocc-installer, xivo Docker: xivo-grafana, xivo-usage-collector, xivo-usage-writer, xivo-web-interface, xucmgt, xucserver

CCAgent

  • #7932 - CC Agent - (Very) long pause name is not correctly displayed in pause status list

SpagoBi

  • #7938 - Spagobi: legacy dependencies from the build have been (re)moved

    Important

    Behavior change The image won’t receive updates anymore :: 2024.05-latest is the last SpagoBI version on XiVO ecosystem.

Switchboard

  • #7955 - Switchboard and recording

Usage statistics

  • #7889 - USM - Add applicationType in LoginEvent event

Web Assistant

  • #7970 - Wrong color when missed called in UC assistant

XiVO PBX

  • #6879 - php 8 to webi

  • #7713 - As a Connect user I want to be able to call a XiVO user with it’s phone number

  • #7935 - USM - Add provd stats to usm conf database

  • #7936 - USM - I want to have version infos in the existing config table

  • #7937 - USM - We want to push the new USM counters to the backend

  • #7963 - Make upgrade scripts exit with error when there is an error

  • #7969 - [C] - Impossible d’enregistrer un utilisateur comme destination dans les périodes non ouvrés du premier coup

Naos Intermediate Versions