Create the HCM-F Device

Note

This section is only applicable 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.

After you create the HCM-F device, data synchronization 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-4-UC as hcsadmin at sys.hcs.

  2. Create a new HCM-F instance:

    1. Choose 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. Choose the HCM-F Version from the drop-down list.

    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-4-UC CLI:
      1. ssh platform@<v4uc hostname>
      2. network domain

  4. After a couple of minutes, verify that the initial synchronization between VOSS-4-UC 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. Choose Apps Management > HCM-F and click the HCM-F device.
  2. Update the Hostname and click Save.
  3. Import the new HCM-F:
    1. Choose 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.