[Index]

Model: data/HcsNumberManagementLogDAT

Directory Number Inventory Audit Tool

When you run the Directory Number Inventory (DNI) Audit Tool, the tool checks and updates your directory number inventory since the last data sync. A sync of device/cucm/Line from the Unified CM will 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.

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.

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:

• If a line is assigned to at least one of: phone, device profile, or remote destination profile, then it will be marked used = true and available will be left as true.
• If a number is used as a Hunt Pilot - it will mark the number used = true and available = false.
• Any other usage of the line is not handled, for example CTI route point. So while these numbers are added to the inventory, they will not be marked used or unavailable through the audit process.

The tool is run from the Dial Plan Management > Number Management menu. When you run the tool, it creates new DNs for lines that don't have them.

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

• Customer Create
  • Always creates new DN Inventory at the customer hierarchy level.
  • This option is only available for non-SLC dial plans, for instance Type 4 or non-SLC shell dial plan.
  • The DN inventory will be created at Customer hierarchy if the line exists at the customer level or at a site. The reason is that even if the administrator moves the line to a site later, the DN inventory at the customer level still applies. If the DN inventory already exists, it will be updated.
• Site Create
  • Always creates new DN Inventory at the site hierarchy level.
  • This option applies to any type of dial plan.
  • The DN inventory is created at the first site the line is encountered. If more than one line with the same pattern but different partitions exist, the DN inventory will be created for the first line encountered with that pattern.
  • If the line exists at customer level, a warning message is logged and the DN inventory is not created. If the DN inventory already exists, it will be updated.
• Smart Create
  • Create new DN Inventory at the site hierarchy level.
  • If the line exists at a site and is not used by a phone in another site, this option creates a new DN inventory at the hierarchy where the line exists.
  • If the line exists at a site, is referenced by one or more phones in other sites, and the dial plan type is non-SLC, thats is type 4, this option creates a new DN inventory at the Customer level.
  • If the line exists at a site, is referenced by one or more phones in other sites, and the dial plan type is SLC, that is type 1-3, a new DN inventory is created at the site where the line exists.
  • If the line exists at customer level, a warning message is logged and the DN inventory is not created. If the DN inventory already exists, it will be updated.

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 Dial Plan Management > Number Management > Directory Number Inventory, you can see a list of DNs and move, delete, and export them as desired.

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

Common Errors and Caveats

• Duplicate device profiles (same profile name) in different clusters.

  Ensure device profiles are not duplicated across the sites.

• Duplicate phones (same MAC) in different clusters.

  Ensure phones are not duplicated across the clusters

• Same directory number in one or more clusters.

  Ensure directory numbers (even in different partitions) are not duplicated across clusters.

Procedure

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

2. Choose Dial Plan Management > Number Management > Directory Number Inventory Audit Tool.

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.

Audit Number Inventory

Audit Number Inventory

This feature performs an audit of the number inventory and makes sure that the Status and Usage of each number aligns to the devices or services configured with these matching numbers. See Number Status and Usage for more details about these values.

For Microsoft environments, available numbers are added (else updated if present) to the inventory, with:

• status: Available
• vendor: Microsoft
• number type: Operator Connect or Calling Plan

For more details, see: Audit Process in Microsoft Environments

The audit will create new numbers for devices or services that don't already exist, as well as update existing number entries to make sure the Status and Usage fields reflect the correct information at the time the audit is run. Number entries will not be deleted.

To access the flowcharts, view the topic via the release documentation at: https://documentation.voss-solutions.com/automate.html

Specify where you want to run and create a new number inventory:

• Customer

  • Running the number inventory audit at Customer level will add directory numbers at Customer level for services which exist at Site or Customer, provided there is not already a directory number for that service at Site level. If there are already directory numbers at the Site level then those will also get updated.

    This is a mixed mode of audit, which audits directory numbers at both Customer and Site level. For example, if directory numbers only exist at Customer level, then the audit will only add and update directory numbers that exist at the Customer. If there are directory numbers at Site level, the audit will still add new directory numbers at the Customer level, but will also update the existing directory numbers at Site level.

• Site

  • Running the number inventory audit at Site level will add directory numbers at site level, and update any existing directory numbers at site level only. No Customer level directory numbers will be audited and no directory numbers will be added to Customer level for Customer level services.
  • You can choose to audit either All the Sites for the Customer or selected Sites.

For sites using Site Location Code-based dial plans, number inventories can be created only at the site hierarchy, the customer hierarchy will not be available.

From the Number Inventory form (default menu Number Management > Number Inventory), you can see a list of internal numbers and move, delete, and export them as desired.

HcsNumberManagementLogDAT

Model Details: data/HcsNumberManagementLogDAT