Create the HCM-F Device#

provider-only

Only in the Provider deployment

Note

This topic is relevant only to HCM-F.

Prerequisites:

  • Install and configure HCM-F.

  • Verify that the NBI REST SDR Web Service is running:

    1. Log in to the HCM-F CLI as the user administrator.

    2. Run the utils service list command. Verify that the Cisco HCS NBI REST SDR Web Service is running.

    3. If not running, start it with the utils service start Cisco HCS NBI REST SDR Web Service command.

Once you create the HCM-F device, the data sync begins (if there is a network connection and the NBI REST service is running on the HCM-F server).

Perform these steps:

  1. Log in to VOSS Automate as entadmin or hcsadmin at sys.hcs.

  2. Create a new HCM-F instance:

    1. Go to (default menus) Apps Management > HCM-F, and click Add.

    2. Enter the HCM-F hostname.

    3. Enter the HCM-F administrator Username.

    4. Enter the HCM-F administrator Password.

    5. Select the HCM-F Version from the drop-down.

    Note: Once the HCM-F Version is set to a new version, it cannot be changed to an older one.

    1. Click Save.

  3. If the previous step fails:

    • Verify that HCM-F Hostname is correct.

    • Verify that HCM-F administrator Username and administrator Passwords are correct.

    • Verify that HCM-F Version is correct.

    • Verify that the domain is set correctly using the VOSS Automate CLI:

      1. ssh platform@<v4uc hostname>

      2. network domain

  4. After a couple of minutes, verify that the initial synchronization between VOSS Automate and HCM-F is successful:

    1. Choose Provider Management > Advanced > SDR Service Provider.

    2. The sync is successful if the default entry, “Service Provider Name”, appears.

Next Steps

If the initial sync is not working after following the previous steps, verify that the HCM-F REST API is working by browsing to the following:

http://<hcmf_app_node_host>/sdr/rest/<hcmf_version>/entity/ServiceProvider

This command returns the JSON representation of the predefined ServiceProvider instance in the HCM-F Shared Data Repository (SDR). If you get an error, log in as the administrator on the HCM-F app node CLI and verify that the REST service is running:

To display the services, run the command: utils service list.

In the output, you see Cisco HCS NBI REST SDR Web Service[STARTED].

If this service is not started, start it with the command: utils service start Cisco HCS NBI REST SDR Web Service

For data sync failures, try importing the new HCM-F:

  1. Go to (default menus) Apps Management > HCM-F and click the HCM-F device.

  2. Update the Hostname, then click Save.

  3. Import the new HCM-F:

    1. Go to (default menus) Apps Management > Advanced > Perform Publisher Actions.

    2. From the Action drop-down, choose Import.

    3. From the App Type drop-down, choose the HCM-F server.

    4. Click Save and wait a few minutes.

  4. Check the provider under Provider Management > Advanced > SDR Service Provider.