.. _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.
2. Make sure that the hierarchy is set to the customer for whom you are
   creating the site.
3. Choose **Site Management > Sites**.
4. Click **Add**.
5. 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.                                  |
|                      | * 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.                   |
+----------------------+---------------------------------------------+

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