.. _emcc_group_management:

EMCC Groups
------------

.. _19.2.1|VOSS-205:


Overview
.........

An Extension Mobility Cross Cluster (EMCC) group is a collection of clusters and
countries that essentially forms an 'EMCC Cloud', which determines the specific
clusters between which a user can roam.

.. note::

   A cluster can only be included in one group.

EMCC groups typically cater for situations where all the clusters are in different
countries, and are managed by the same platform instance. To support multiple
clusters in the same country, you need to refine the geolocations and geolocation
filters to uniquely identify the clusters in the default provisioning of country.
This is supported by using the home cluster setup for each of the clusters in the
group.

The EMCC Group screen allows a provider administrator to add or remove clusters
and countries to or from an EMCC group, or to modify/delete an existing EMCC Group.



.. _add_emcc_group:

Add an EMCC Group
..................

When adding an EMCC Group, the cluster the user is on when taking this action is
automatically selected/included in the new group.


**Prerequisites**: 

* Create the required route patterns. See :ref:`add_emcc_route_pattern`.


**Perform these steps**:

1. Log in as Provider administrator or higher.
#. Choose **Customer Management > EMCC > EMCC Group**.
#. Click **Add**.
#. Choose the required customer from the **Hierarchy** drop-down list. 
#. On the **EMCC Group** screen, enter the mandatory EMCC Group Name in the **Name** field.
#. Choose the required CUCM Clusters and Countries to include in the EMCC Group by
   selecting single or multiple entries in the **Available** areas of the screen,
   and then clicking **Select** to move them to the **Selected** area of the screen.
   Use the Remove, Move Up and Move Down buttons as required to assist in creating
   the EMCC Group. An EMCC Group **must contain** a minimum of two clusters.
#. Ensure that the required CUCM Clusters and Countries are listed in the CUCM
   Clusters and Countries areas of the screen respectively.
#. Click **Save** to add the EMCC group to VOSS Automate.

   Once the EMCC Group is created, the following elements are provisioned per
   country and EMCC route pattern:
   
   * Route list
   * Geolocation filter
   * SIP profile
   * IP phone services
   * SIP trunk
   * Geolocation
   * Route partition
   * CSS
   * Device pool
   * Route pattern



.. _modify_emcc_group:

Modify an EMCC Group
........................

1. Log in as Provider administrator or higher.
#. Choose **Customer Management > EMCC > EMCC Group**.
#. Click on the EMCC Group that you want to modify. 
#. On the **EMCC Group** screen, add or remove the CUCM Clusters and 
   Countries within the EMCC Group by selecting single or multiple entries in 
   the **Available** or **Selected** areas of the screen, and then 
   clicking **Select** or **Remove** to include or exclude them
   from the group as required.
   Use the Move Up and Move Down buttons as required to assist in creating the
   EMCC Group.
#. Click **Save** to save the modified EMCC group to the VOSS Automate database.



Delete an EMCC Group
.....................

To delete an EMCC Group, click on the Group to delete on the EMCC Group screen 
and then click **Delete** on the button bar.