.. _p_create_a_provider:

Create a Provider
-----------------

.. note::

   References to HCM-F and Shared Data Repository (SDR) are only relevant if
   installed.
   
   In VOSS-4-UC, the provider name is set to the current service provider name
   in HCM-F.

**Perform these steps**:

1. Log in to VOSS-4-UC as hcsadmin at sys.hcs.
#. On the **Providers** form (default menu **Provider Management > Providers**),
   click **Add**.
#. On the **Service Provider Details** tab, complete the following fields:

   .. tabularcolumns:: |p{4cm}|p{11cm}|

   +--------------------+-----------------------------------------------+
   | Field              | Description                                   |
   +====================+===============================================+
   |                    | The name of the provider. The name is         |
   |                    | automatically set to the current service      |
   |                    | provider name in HCM-F. You can keep the      |
   |                    | existing name or overwrite with a more        |
   |                    | meaningful name. This field is mandatory.     |
   |                    |                                               |
   |                    | Note:                                         |
   |                    |                                               |
   | Name               | Once you have saved the provider, you cannot  |
   |                    | change the provider name.                     |
   |                    |                                               |
   |                    | Note:                                         |
   |                    |                                               |
   |                    | Any spaces in the provider name are converted |
   |                    | to underscores in the provider local          |
   |                    | administrator name and email, if the **Create |
   |                    | Local Admin** check box is selected.          |
   +--------------------+-----------------------------------------------+
   |                    | Select to set a provider name in VOSS-4-UC    |
   |                    | that is different from the service provider   |
   |                    | name in HCM-F. Service provider names that    |
   |                    | were synchronized from VOSS-4-UC 8.1(x) or    |
   | Decouple SDR Name  | are set to "All Service Providers" can        |
   |                    | remain unchanged in HCM-F.                    |
   |                    |                                               |
   |                    | If you leave clear, the provider name you     |
   |                    | enter in the **Name** field is synchronized   |
   |                    | into HCM-F as the service provider name.      |
   +--------------------+-----------------------------------------------+
   | SDR Name           | The service provider name to store in the SDR |
   |                    | on HCM-F. This field appears only if          |
   |                    | **Decouple SDR Name** is selected.            |
   +--------------------+-----------------------------------------------+
   | Description        | A description of the provider.                |
   +--------------------+-----------------------------------------------+
   |                    | The domain of the provider. For example,      |
   |                    | provider.com. Used when creating the default  |
   | Domain Name        | local administrator so the administrator can  |
   |                    | log in with an email ID such as               |
   |                    | ProviderAdmin@provider.com. This field is     |
   |                    | mandatory.                                    |
   +--------------------+-----------------------------------------------+
   | Create Local Admin | Controls whether a default local              |
   |                    | administrator is created.                     |
   +--------------------+-----------------------------------------------+
   |                    | The HCS default provider role used to create  |
   |                    | a new role prefixed with the provider name.   |
   | Cloned Admin Role  | The created provider role, shown in the       |
   |                    | **Default Admin Role** field, is assigned to  |
   |                    | the default local administrator. This field   |
   |                    | appears only if the **Create Local Admin**    |
   |                    | check box is selected.                        |
   +--------------------+-----------------------------------------------+
   |                    | The created provider 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 mandatory field appears   |
   |                    | only if the **Create Local Admin** check box  |
   |                    | is selected.                                  |
   +--------------------+-----------------------------------------------+
   | Repeat Default     | Confirm the default local administrator       |
   | Admin Password     | password. This mandatory field appears only   |
   |                    | if the **Create Local Admin** check box is    |
   |                    | selected.                                     |
   +--------------------+-----------------------------------------------+

4. On the **Contact Information** tab, enter address, email, and phone
   information as appropriate.
#. Click **Save**.

The provider hierarchy node in VOSS-4-UC, and optionally a default provider
administrator are created.