.. _cross_mds_user_group_feature:

*******************************
Cross-MDS User Group Management
*******************************

Overview
---------

This feature allows administrators to add users to groups regardless of their MDS location within a XiVO system. It simplifies group management by enabling the creation of diverse groups that span multiple MDS instances.

Benefits
---------

- **Flexible Group Management**: Create groups with users from any MDS, enhancing organizational flexibility.
- **Unified Group Calling**: Ensure that all users in a group receive calls simultaneously, regardless of their MDS location.
- **Simplified Administration**: Manage groups centrally while maintaining MDS associations.

Use Cases
---------

- **Distributed Teams**: Manage teams distributed across different locations by creating groups that include users from multiple MDS.
- **Unified Customer Service**: Ensure consistent customer service by creating groups that handle calls across different MDS instances.

.. _device_sharing_configuration:

Configuration
-------------

To enable this experimental feature, you must configure the XiVO system to allow device state sharing and cross-MDS user group management. This requires updating the relevant configuration files and ensuring all MDS instances are properly connected.

1. **Set the `XDS_MULTI_MDS_CALLGROUP` variable to `TRUE` in the XiVO configuration:**

   Edit the file :file:`/etc/docker/xivo/custom.env` and add the following line:

   .. code-block:: ini

      XDS_MULTI_MDS_CALLGROUP=TRUE

2. **Update the service to take configuration into account:**

   .. code-block:: bash

      xivo-dcomp up -d
      asterisk -rx "core reload"

3. **Repeat this configuration on all MDS instances:**

   Edit the file :file:`/etc/docker/mds/custom.env` on each MDS instance and add the same line:

   .. code-block:: ini

      XDS_MULTI_MDS_CALLGROUP=TRUE

4. **Update the MDS service to apply the configuration:**

   .. code-block:: bash

      xivo-dcomp up -d
      asterisk -rx "core reload"


.. note::

   This configuration enables device state sharing and cross-MDS user group management across your XiVO and MDS servers.
   Ensure you apply these changes to every relevant instance for the feature to function correctly.