[Index]

Model: view/HcsDNInventoryMgmtView

Directory Number Inventory Audit Tool

A sync of device/cucm/Line from the Unified CM can result in various line types being brought in - including lines assigned to devices, CTI devices, and so on - essentially anything that would be seen under Directory Numbers in Unified CM.

Misalignment between Unified CM and VOSS-4-UC can therefore take place, for example:

The DN Audit tool aligns the directory number inventory with the lines information by generating and updating DNs in the correct hierarchy for any line synced into VOSS-4-UC that does not have a corresponding DN in the system.

This will create a number inventory entry for all the device/cucm/Lines that are in the system and at the site level. Any lines not at the site level will not be processed in the audit tool.

Note

This can result in inventory entries being created for lines that are not just user device related, for example CTI ports, CTI route points, and so on. The Audit will not remove number inventory entries if a corresponding device/cucm/Line does not exist, for example if it is removed outside of VOSS-4-UC.

The Number Inventory audit then includes logic to then determine if a number is used or not and to set the number inventory value accordingly. That logic handles the following cases:

When you run the tool, it creates new DNs for lines that don't have them.

System Message: ERROR/3 (<string>, line 52)

Unknown directive type "uml".

.. uml::

   @startuml
   !include style.iuml

   start
   while (Number Management enabled for customer? [default] ) is (No)
     :[[../src/user/create-customer.html Enable Number Management]];
   endwhile (Yes)
   :Choose Directory Number Inventory Creation Policy option;
   note right
     Options:
     * Customer Create
       (not available for customers with
       Site Location Code-based dial plans)
     * Site Create
     * Smart Create
   end note
   :Save;
   stop
   @enduml




You specify where you want the tool to run and create a new DN inventory:

For sites using Site Location Code-based dial plans, DN inventories can be created only at the Site hierarchy. The option to create DN inventories at the Customer hierarchy is unavailable in this case.

The DN Inventory Audit Tool will mark data/InternalNumberInventory instances as Shared across sites if a line is associated with multiple devices.

From Directory Number Inventory, you can see a list of DNs and move, delete, and export them as desired.

Log Messages provides information and warning messages generated by the Directory Number Inventory Audit Tool.

Note

You cannot run the Directory Number Inventory Audit Tool if number management has been disabled for the customer.

Common Errors and Caveats

Procedure

  1. Log in to VOSS-4-UC as provider or reseller administrator.

  2. Open the Directory Number Inventory Audit Tool form.

  3. If prompted, choose the correct hierarchy and click OK.

    Note

    The tool can only be run from Customer hierarchies. If you run the tool from a hierarchy that is not of type Customer, the tool will automatically provide you with a valid Customer hierarchy choice.

  4. From the Directory Number Inventory Creation Policy drop-down, choose an option.

    Note

    Customers with Site Location Code-based dial plans will not see the Customer Create option.

  5. Click Save.

The DN inventory is updated at the hierarchy you specified and below.

Model Details

Title Description Details
Tool Information Overview of Tool's Creation Policy Choices Default: {{ fn.localize data.HcsLocalizedStringDat.value | key: dninv_tool_info }}
  • Field Name: info
  • Type: String
  • Default: {{ fn.localize data.HcsLocalizedStringDat.value | key: dninv_tool_info }}
Directory Number Inventory Creation Policy * Select a Directory Number (DN) Inventory Creation Policy
  • Field Name: dn_ht
  • Type: String
  • Choices: [" "]
API reference for view/HcsDNInventoryMgmtView