.. _emcc-group-management:

EMCC groups
------------

.. _19.2.1|VOSS-205:


.. tip:: 

   :ref:`use-action-search-to-navigate-automate`



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 geo-locations and geo-location
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** page 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 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.
#. Go to the **EMCC Group** page. 
#. Click the Plus icon (+) to add a new record.
#. Choose the required customer from the **Hierarchy** drop-down list. 
#. On the **EMCC Group** page, fill out the mandatory EMCC group name.
#. 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.

   .. note:: 

      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**. 

   The EMCC group is added to Automate. Once 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 EMCC group
........................

1. Log in as Provider administrator or higher.
#. Go to **EMCC Group**. 
#. Click on the EMCC group that you want to modify. 
#. On the **EMCC Group** page, 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.

   .. note:: 

      Use the Move Up and Move Down buttons as required to assist in creating the EMCC Group.

#. Save your changes. 


Delete EMCC group
.....................

To delete an EMCC Group, click on the Group to delete on the EMCC Group page, then click **Delete**.
