.. _p_create_a_site:

Create a Site
-------------

.. note::

   References to HCM-F and Shared Data Repository (SDR) are only relevant if
   installed.
   
   In VOSS-4-UC, if the site name matches an HCM-F customer location, you can
   migrate the customer location as a site.

1. Log in as provider, reseller, or customer administrator.
#. Make sure that the hierarchy is set to the customer for whom you are
   creating the site.
#. On the **Sites** form (default menu **Site Management > Sites**), click **Add**.
#. Complete the following fields:

.. tabularcolumns:: |p{3cm}|p{12cm}|

+----------------------+---------------------------------------------+
| Option               | Description                                 |
+======================+=============================================+
|                      | The name of the site. This field is         |
|                      | mandatory.                                  |
|                      |                                             |
|                      | Note:                                       |
|                      |                                             |
|                      | Any spaces in the site name are converted   |
|                      | to underscores in the site local            |
|                      | administrator name and email, if the        |
|                      | **Create Local Admin** check box is         |
|                      | selected.                                   |
|                      |                                             |
|                      | Note: A customer location that has been     |
|                      | configured in HCM-F and synced into         |
|                      | VOSS-4-UC may exist at the sys.hcs          |
|                      | hierarchy. If the Site Name you enter       |
|                      | matches this customer location, the         |
| Site Name            | **Migrate from HCM-F to VOSS-4-UC** check   |
|                      | box is displayed. Click **Save** to migrate |
|                      | this customer location to a site at the     |
|                      | current hierarchy level. The fields are     |
|                      | populated with the values that were         |
|                      | configured in HCM-F. If you do not want to  |
|                      | migrate the customer location, enter a      |
|                      | different Site Name.                        |
|                      |                                             |
|                      | You cannot migrate a customer location to a |
|                      | site if the customer for the site is        |
|                      | different than the customer associated with |
|                      | the customer location.                      |
|                      |                                             |
|                      | When migrating a customer location to a     |
|                      | site, an NDL is not selected for the site.  |
|                      | You can set the NDL for the site later.     |
+----------------------+---------------------------------------------+
| Description          | A description for the site.                 |
+----------------------+---------------------------------------------+
|                      | External clients can use the Extended Name  |
|                      | of the site if needed. This field is not    |
|                      | used by other components within Cisco HCS.  |
|                      |                                             |
|                      | Note:                                       |
|                      |                                             |
|                      | This field exists in the Customer Location  |
|                      | record in SDR. When the customer is managed |
| Extended Name        | by Cisco Unified Communications Domain      |
|                      | Manager 8.1(x), the Extended Name is synced |
|                      | from Cisco Unified Communications Domain    |
|                      | Manager 8.1(x) to the Customer Location     |
|                      | record in SDR. When the customer is managed |
|                      | by VOSS-4-UC, the Extended Name is synced   |
|                      | from VOSS-4-UC to the Customer Location     |
|                      | record in SDR.                              |
+----------------------+---------------------------------------------+
|                      | External clients can use the External ID of |
| External ID          | the site if needed. This field is not used  |
|                      | by other components within Cisco HCS.       |
+----------------------+---------------------------------------------+
| Create Local Admin   | Controls whether a default local            |
|                      | administrator is created for the site.      |
+----------------------+---------------------------------------------+


.. tabularcolumns:: |p{3cm}|p{12cm}|

+----------------------+----------------------------------------------+
| Option               | Description                                  |
+======================+==============================================+
|                      | The customer role used to create a new role  |
|                      | prefixed with the site name. The created     |
| Cloned Admin Role    | site role, shown in the **Default Admin      |
|                      | Role** field, is assigned to the default     |
|                      | local administrator user. This field appears |
|                      | only if the **Create Local Admin** check box |
|                      | is selected.                                 |
+----------------------+----------------------------------------------+
|                      | The created site role that is assigned to    |
| Default Admin Role   | the default local administrator. This field  |
|                      | is read-only and appears only if the         |
|                      | **Create Local Admin** check box is          |
|                      | selected.                                    |
+----------------------+----------------------------------------------+
| Default Admin        | The password to assign to the default local  |
| Password             | administrator. This field appears only if    |
|                      | the **Create Local Admin** check box is      |
|                      | selected.                                    |
+----------------------+----------------------------------------------+
| Repeat Default Admin | Confirm the default local administrator      |
| Password             | password. This field appears only if the     |
|                      | **Create Local Admin** check box is          |
|                      | selected.                                    |
+----------------------+----------------------------------------------+
|                      | The country is used to determine which dial  |
| Country              | plan to download to the site when the dial   |
|                      | plan is configured on the site. This field   |
|                      | is mandatory.                                |
+----------------------+----------------------------------------------+
|                      | Choose the NDL containing the UC             |
|                      | applications and WebEx to be used by the     |
| Network Device List  | site. Once an NDL has been set for the       |
|                      | site, it cannot be removed from the site,    |
|                      | nor can the NDL be changed to another NDL.   |
+----------------------+----------------------------------------------+
|                      | If enabled, users are automatically pushed   |
|                      | to the Cisco Unified Communications Manager  |
|                      | that is associated with the NDL. The         |
|                      | default is disabled.                         |
|                      | Note: You can edit the site later, and       |
|                      | select this check box for one of the         |
|                      | following reasons:                           |
|                      |                                              |
| Auto Push Users to   | * To automatically push users at the site    |
| CUCM                 |   to the Cisco Unified Communications        |
|                      |   Manager. User surname must be filled in.   |
|                      | * To perform an Auto User Push when an       |
|                      |   NDL is added to the site.                  |
|                      | * To perform an Auto User Push when a        |
|                      |   Cisco Unified Communications Manager is    |
|                      |   associated with an NDL.                    |
|                      |                                              |
|                      | Only users with user type "End User" are     |
|                      | pushed to the Cisco Unified                  |
|                      | Communications Manager.                      |
|                      |                                              |
+----------------------+----------------------------------------------+

5. Click **Save**.

Once saved, the following occurs:

* A Site hierarchy node is created.
* A Location is created.
* A Customer Location in the SDR is created.
* Optionally, a default site administrator is created.
* If the **Auto Push Users to CUCM** check box is selected:
  
  * All users associated with the NDL are pushed to the Cisco Unified Communications Manager associated
    with the NDL. User surname must be filled in.
  * Only users with user type "End User" are pushed to the Cisco Unified Communications Manager.