.. _xivosolutions_release: ************* Release Notes ************* .. _quantum_release: Quantum ======= Below is a list of *New Features* and *Behavior Changes* compared to the previous LTS version, Pollux (2025.10). New Features ------------ **Assistants (UC, CC)** * Users' Do Not Disturb status now appears in the search results - see :ref:`Search for UC App ` and :ref:`Search for CC Agent App `. **WebRTC** * Audio devices verification feature: test the configured audio device (input/output) inside the configuration - see :ref:`webrtc_testing_audio_device` * Headset call control: added Yealink headset brand added - see :ref:`headset_call_control` **Reporting** * Metabase BI tool integration (replaces SpagoBI) * Add group table to be able to do statistics on groups and not only queues **Resilience** * Introducing Automatic or Manual failover mode - see :ref:`resilience_architecture_failover_mode` * Adding node type in Web interface - see :ref:`resilience_administration_node_type` * **With Edge**, users can automatically reconnect (or with a refresh) to the active stack **XiVO PBX** * CSV user import: ability to import and update SIP options * *Provisioning*: Extended device line support up to 256 lines * (*Since Quantum.03*) **Simultaneous calls limit**: The simultcalls parameter now tracks all active calls (outgoing, incoming via groups/queues, boss-secretary filter etc.) - see to :ref:`users_simultaneous_calls` **API** * Configmgt API for schedule management in web interface * Schedule associations endpoints * Resilience API enhancements **Edge**: * Add timestamp with correct timezone for SIP proxy (kamailio) and TURN server (coturn) logs **Meetingroom** * User joining via the sharing link enters now the Meetingroom **as Guest** (previously it entered as Moderator) - this behavior can be reverted, see :ref:`meetingrooms_enable_moderator_for_external_participants`. * A lobby room can now be configured for guest participants - see :ref:`meetingrooms_enable_lobby_for_external_participants` * (**from Quantum.03**) Can pre-fill visioconference invitation emails with configurable template using meetingroom parameters and attached data from ongoing call **System** * Debian 13 migration for XiVO PBX, XiVO CC, Edge, and Meeting Rooms * *Edge*: SIP proxy (Kamailio) version was bumped from 5.5.0 to 6.1.1 Behavior Changes ---------------- **System** * XiVO PBX, XiVO CC, Edge, and Meeting Rooms now install on **Debian 13 (Trixie)** * **Timezone**: Docker containers take now there timezone from the environment variable ``TZ``. It defaults `Europe/Paris`. It can be **customized** by adding in the :file:`custom.env` file with the ``TIMEZONE`` env var. * xuc JVM option is now defined as ``JAVA_OPTS=${JAVA_OPTS_XUC:--Xms512m -Xmx2048m}`` (instead of ``JAVA_OPTS=-Xms512m -Xmx2048m``). Therefore it can be easily overriden in :file:`custom.env`. * Launching an upgrade now requires an explicit ``y`` answer (applies to ``xivo-upgrade``, ``mds-upgrade``, ``xivocc-upgrade``) * New log files for: * ``xivocc-configure-xivopbx`` script in ``/var/log/xivocc_configure_xivopbx_*.log`` * ``xivouc-installer`` script in ``/var/log/xivouc_installer_*.log`` * The ``xivocc-recording-config`` script now automatically sanitizes IPBX name (removes space and dash (``-``) characters) **API** * Config Mgt ``update_ha_config`` API now uses **POST** instead of **GET** * Schedules are now managed with configmgt APIs in the web-interface. It means configmgt must be running to be able to list / create / update / delete schedules and associate / deassociate schedules items in the web-interface **Edge** * The Kamailio component from Edge is now automatically selecting the xivo main (also known as mds0) without needing to pass it as extra_host * The use of ``XIVO_MDS_HOST_DEFAULT`` is now deprecated and can safely be removed from .env and from extra_host in file ``kamailio-edge.yml`` * OCSP check deactivated by default on Edge Web Proxy **Meetingroom** * User's rights changed when joining a meetingroom: a user joining via the sharing link enters now the Meetingroom **as Guest** (previously it entered as Moderator) - this behavior can be reverted, see :ref:`meetingrooms_enable_moderator_for_external_participants`. +------------------------------------------------------+-----------+-----------+ | | Before | After | +======================================================+===========+===========+ | User joins **via sharing link** | Moderator | **Guest** | +------------------------------------------------------+-----------+-----------+ | User joins via Assistant (UC, CC Agent, Switchboard) | Moderator | Moderator | +------------------------------------------------------+-----------+-----------+ **Provisioning** * When synchronizing a device: * if ip and remote_state_sip_username are known, two NOTIFY will be sent to the device: one by uri and the other by peer * if the notify by peer fails (for example if user is on MDS), it will fallback to another NOTIFY by uri constructed from ip and remote_state_sip_username **Reporting BI** * Metabase installed has been automated using the package xivocc-metabase only **Resilience** * New visuals for resilience, with a dedicated resilience management page, and some informations alongside the monitoring page (displayed by default after login) **XiVO PBX** * The reverse lookup should only match the fields defined in directories and not Outgoing_caller_id for example * Recording mode description added in webi * When creating a queue in webi, recording activation checkbox is no longer displayed * (*Since Quantum.03*) **Simultaneous calls limit enforcement**: The simultcalls parameter now provides consistent enforcement across all call types. Previously, the limit was only enforced for direct incoming call to the user. The counter now tracks outgoing calls, calls received via groups etc. Below is a table listing the major behavior differences. .. note:: See :ref:`users_simultaneous_calls` for more details. Given a user U1 with simultcalls = 1, G1 and G2 [2]_ groups which U1 is a member of, and Q1 and Q2 [2]_ queues which U1's agent is a member of: +----------------------------+--------------------------------+-----------------------------+-----------------------------+ | U1 Current Call State | New Call Towards U1 | Before (Pre-Quantum) | After (Quantum) | +============================+================================+=============================+=============================+ | U1 calls [1]_ | U2 calls U1 directly | U1 **rings** | **Busy** | +----------------------------+--------------------------------+-----------------------------+-----------------------------+ | U1 calls [1]_ | U2 calls G1 or Q1 | U1 not called (InUse) | U1 not called (InUse) | +----------------------------+--------------------------------+-----------------------------+-----------------------------+ | U1 calls [1]_ | U2 calls group G2 or Q2 [2]_ | U1 **called** | **U1 not called** | +----------------------------+--------------------------------+-----------------------------+-----------------------------+ | U1 on call | U2 calls U1 directly | U1 **rings** | **Busy** | | (via group/queue) | | | | +----------------------------+--------------------------------+-----------------------------+-----------------------------+ | U1 on call (via | U2 calls U1 directly | U1 **rings** | **Busy** | | Boss/secretary filter) | | | | +----------------------------+--------------------------------+-----------------------------+-----------------------------+ .. [1] Call emitted by the user to other users, groups, queues, external numbers, conferences, meeting rooms. .. [2] Group G2 (Queue Q2) has the *Call a member already in line* option activated Deprecations ------------ This release deprecates: * `LTS Kuma (2023.05) `_ : This version is no longer supported. * SpagoBi has been deprecated in favor of Metabase. * On newer Debian13 installs, there is longer the :file:`/etc/timezone`: it should be removed from any docker compose volume definition. Upgrade ------- .. _upgrade_lts_manual_steps: **Manual steps for LTS upgrade** .. warning:: **Don't forget** to read carefully the specific steps to upgrade from another LTS version .. toctree:: :maxdepth: 1 upgrade_from_jabbah_to_kuma upgrade_from_kuma_to_luna upgrade_from_luna_to_maia upgrade_from_maia_to_naos upgrade_from_naos_to_orion upgrade_from_orion_to_pollux upgrade_from_pollux_to_quantum **Generic upgrade procedure** Then, follow the generic upgrade procedures: * :ref:`XiVO PBX upgrade procedure ` * :ref:`XiVO CC upgrade procedure ` * :ref:`XDS upgrade procedure ` * :ref:`Resilience upgrade procedure ` Quantum 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 | 2026.05.03 | +----------------------------+--------------+ | config-mgt | 2026.05.03 | +----------------------------+--------------+ | db | 2026.05.02 | +----------------------------+--------------+ | outcall | 2026.05.02 | +----------------------------+--------------+ | db_replic | 2026.05.00 | +----------------------------+--------------+ | nginx | 2026.05.00 | +----------------------------+--------------+ | webi | 2026.05.03 | +----------------------------+--------------+ | stats-reports-exporter | 2026.05.03 | +----------------------------+--------------+ | usage-writer | 2026.05.00 | +----------------------------+--------------+ | usage-collector | 2026.05.00 | +----------------------------+--------------+ | agid | 2026.05.03 | +----------------------------+--------------+ | confgend | 2026.05.03 | +----------------------------+--------------+ | asterisk | 8:22.2.0-1 | +----------------------------+--------------+ | docker-ce | 5:28.5.2 | +----------------------------+--------------+ | **XiVO CC** | | +----------------------------+--------------+ | mattermost | 2026.05.00 | +----------------------------+--------------+ | nginx | 2026.05.00 | +----------------------------+--------------+ | pack-reporting | 2026.05.00 | +----------------------------+--------------+ | pgxivocc | 2026.05.00 | +----------------------------+--------------+ | recording-rsync | 2024.10.04 | +----------------------------+--------------+ | recording-server | 2026.05.02 | +----------------------------+--------------+ | metabase | 2026.05.03 | +----------------------------+--------------+ | full-stats | 2026.05.02 | +----------------------------+--------------+ | xucserver | 2026.05.03 | +----------------------------+--------------+ | xucmgt | 2026.05.04 | +----------------------------+--------------+ | **Edge** | | +----------------------------+--------------+ | edge | 2026.05.02 | +----------------------------+--------------+ | nginx | 2026.05.00 | +----------------------------+--------------+ | kamailio | 2026.05.00 | +----------------------------+--------------+ | coturn | 2026.05.00 | +----------------------------+--------------+ | **Meeting Rooms** | | +----------------------------+--------------+ | meetingroom | 2026.05.00 | +----------------------------+--------------+ | web-jitsi | 2026.05.00 | +----------------------------+--------------+ | jicofo-jitsi | 2026.05.00 | +----------------------------+--------------+ | prosody-jitsi | 2026.05.00 | +----------------------------+--------------+ | jvb-jitsi | 2026.05.00 | +----------------------------+--------------+ | jigasi-jitsi | 2026.05.00 | +----------------------------+--------------+ | **IVR** | | +----------------------------+--------------+ | ivr-editor | 2026.05.00 | +----------------------------+--------------+ 2026.05.04 (Quantum.04): June 2026 ---------------------------------- Consult the `2026.05.04 (Quantum.04) Roadmap `_. Components updated: Docker: xucmgt **UC App** * `#9127 `_ - Xucmgt applications should not retry the connexion for every auth error types 2026.05.03 (Quantum.03): June 2026 ---------------------------------- Consult the `2026.05.03 (Quantum.03) Roadmap `_. Components updated: Docker: config-mgt, metabase_export_import, xivo-agid, xivo-confgend, xivo-metabase, xivo-metabase-reports, xivo-stats-reports-exporter, xivo-web-interface, xucmgt, xucserver Debian: xivo-config, xivo-service, xivo-upgrade, xivocc-installer, xivo **API** * `#9109 `_ - API - handle error cases for schedules **CCAgent** * `#9099 `_ - Agents and activities popover may breaks display in desktop assistant **CTI** * `#9067 `_ - Resilience - After a fallback on standby stack UC app is stuck * `#9088 `_ - Upgrade to latest JDK bugfix - stats report exporter **Meeting Room** * `#9027 `_ - As a user I can send the meetingroom share link via mail with template **Reporting** * `#9070 `_ - Agents report - Queues calls counter wrong when a call overflow from one queue to the other **Reporting BI** * `#9021 `_ - Add doc for Metabase * `#9022 `_ - Enhance sample reports import .. important:: **Behavior change** metabase installed has been automated using the package xivocc-metabase only **System** * `#8801 `_ - Resilience (BRP/PRA) - As an admin I want to be able to chose between auto or manual takeover * `#9025 `_ - Resilience - Add resilience management table in web interface monitoring page .. important:: **Behavior change** New visuals for resilience, with a dedicated resilience management page, and some informations alongside the monitoring page (displayed by default after login) * `#9066 `_ - Resilience - Can't login after a fallback on standby stack * `#9089 `_ - Resilience - Fix service order and refresh in resilience management page **UC App** * `#9090 `_ - Forward destination not displayed in header when fwd number enter in E.164 format **WebRTC** * `#9116 `_ - UA account is not detected as WebRTC if there is another custom sip options set before webrtc **XiVO PBX** * `#8643 `_ - Take into account user's simultcall for incoming and outgoing calls .. important:: **Behavior change** The simultcalls parameter now provides consistent enforcement across all call types. Previously, the limit was only enforced for direct incoming call to the user. The counter now tracks outgoing calls, calls received via groups etc. See :ref:`users_simultaneous_calls` for details. * `#9032 `_ - Debian 13 - Upgrade fixes 2026.05.02 (Quantum.02): May 2026 --------------------------------- Consult the `2026.05.02 (Quantum.02) Roadmap `_. Components updated: Docker: config-mgt, edge-kamailio, edge-nginx, rabbitmq, recording-server, xivo-agid, xivo-confgend, xivo-db, xivo-db-replication, xivo-edge, xivo-full-stats, xivo-outcall, xivo-web-interface, xucmgt, xucserver Debian: xivo-confd, xivo-provisioning, xivo-sysconfd, xivo-upgrade, xivocc-installer, xivocc-recording, xivo **API** * `#9009 `_ - As an admin using XiVO APIs in the swagger is more guided **CTI** * `#9057 `_ - Token expiration and renewal problem between xuc and xivo (auth, dird, ctid ...) **Edge** * `#9060 `_ - Add time in Edge components log * `#9063 `_ - Edge - Remove schedules API available through edge (revert #9026) **Meeting Room** * `#9037 `_ - Meetingrooms - Distinguish between internal users as admin and guests as guest **Provisioning** * `#9036 `_ - Webi - Installing plugin does not work **Recording** * `#9055 `_ - Empty recording file is not deleted **System** * `#9023 `_ - As an admin I want a verification popup when I chose to start/stop services on Main/Standby * `#9024 `_ - Debian 13 - Update db, confgend, agid to Debian13 * `#9043 `_ - Enable services when disabling HA **UC App** * `#8984 `_ - Fix Mattermost version to 2026.05 * `#9046 `_ - Incorrect title for meeting room status **XiVO PBX** * `#9013 `_ - It's not possible to order schedules * `#9034 `_ - Webi - Control system menu is not visible if Resilience is not activated * `#9061 `_ - Manual post installation wizard configuration ends with a timezone error * `#9064 `_ - Ensure xivo repo key is updated during upgrade 2026.05.01 (Quantum.01): April 2026 ----------------------------------- Consult the `2026.05.01 (Quantum.01) Roadmap `_. Components updated: Debian: xivo-dao, xivo **CC Agent** * `#9033 `_ - Not possible to log agent 2026.05.00 (Quantum.00): April 2026 ----------------------------------- Consult the `2026.05.00 (Quantum.00) Roadmap `_. Components updated: Docker: config-mgt, debian-builder, edge-kamailio, edge-nginx, recording-server, xivo-agid, xivo-confgend, xivo-db, xivo-edge, xivo-metabase, xivoxc-nginx, xucmgt, xucserver Debian: xivo-agentd, xivo-agentd-cli, xivo-agentd-client, xivo-amid, xivo-amid-client, xivo-auth, xivo-auth-client, xivo-auth-keys, xivo-bus, xivo-call-logs, xivo-confd, xivo-confd-client, xivo-config, xivo-dao, xivo-dird, xivo-dird-client, xivo-dird-phoned, xivo-dist, xivo-dxtora, xivo-dxtorc, xivo-fetchfw, xivo-lib-python, xivo-lib-rest-client, xivo-manage-db, xivo-monitoring, xivo-provd-cli, xivo-provd-client, xivo-provisioning, xivo-purge-db, xivo-python-celery-packaging, xivo-python-dumbnet-packaging, xivo-service, xivo-sync, xivo-sysconfd, xivo-upgrade, xivo-utils, xivocc-installer, xivocc-recording, xivo Others: xivo-desktop-assistant, xivo-install-script, xivo-test-helpers **API** * `#8876 `_ - Configmgt - I can remove all dialaction referencing a user * `#9026 `_ - Edge - Add schedules API available through edge **Desktop Assistant** * `#8993 `_ - Add Always on top icon in desktop assistant **Edge** * `#8699 `_ - Resilience (BCP/PCA) - with Edge - As a User I want to be able to reconnect automatically (or with a refresh) to the Active stack .. important:: **Behavior change** The Kamailio component from Edge is now automatically selecting the the xivo main (also known as mds0) without needing to pass it as extra_host. Thus the use of XIVO_MDS_HOST_DEFAULT is now deprecated and can safely be removed from .env and from extra_host in file `kamailio-edge.yml` Check the Edge Configuration on Resilience Installation to see what to change for resilience on a edge deployment. **Reporting BI** * `#8943 `_ - ✨️ Be able to create a dashboard for queue report * `#8999 `_ - Access Metabase on its HTTPS url follow up **System** * `#8950 `_ - Debian 13 - Build asterisk and dahdi-dkms * `#8962 `_ - Slave services must be stopped after resilience init * `#8977 `_ - Tell monit to remonitor the services after slave services are started **UC App** * `#5212 `_ - As a user, I want to know when my colleague is in Do Not Disturb status * `#9008 `_ - As a user I want to be able to verify my audio devices * `#9017 `_ - PhoneStatusUpdate message is incorrect after asterisk crash **XiVO PBX** * `#8820 `_ - XiVO PBX can be installed on Debian 13 * `#9029 `_ - Asterisk configuration reload might fail because confgend is not ready Quantum Intermediate Versions ============================= .. toctree:: :maxdepth: 2 quantum_iv