Cisco UCM VKM Configuration Guide

Overview

Cisco Unified Communications Manager (CUCM) provides signaling and call control services to Cisco integrated telephony and third-party applications.

The CUCM Vendor Knowledge Module (VKM) provides health and performance monitoring, inventory discovery, CDR collection, and dependency trees for the CUCM platform. The VKM provides system monitoring as part of the Nectar Foundation solution and used by the Nectar Call Analysis and Recording Assurance Modules.

About this Guide

This guide provides the instructions to configure the monitoring and management of the CUCM VKM, a component of Nectar Foundation.

This guide explains how to: 

• Configure the Nectar RIG
• Configure Cisco UCM
• Configure SNMP on Routers/Voice Gateways
• Configure CUCM VKM
• Configure CUCM Alarms
• Manage Trunk Types
• Configure VKM Options
• View Inventory
• CUCM VKM and Nectar UCMP
• Troubleshoot Communications from CUCM to RIG
• Manage CUCM Clusters

Supported Software Versions

• Nectar UCMP v8.7
• Cisco UCM v10.x and above

Configure the Nectar RIG

Configuring the Nectar RIG includes the following tasks:

• Enable the Cisco UCM VKM
• Configure the server.properties File
• Configure the ciscoucm-module.properties File
• Configure the receiver-module.properties File

Enable the Cisco UCM VKM

Follow these steps to enable the Cisco UCM VKM:

1. Navigate to RIG > Module Configuration.
   The Module Configuration window appears.
2. Select Cisco UCM.
   
   
   Enable CUCM VKM 
3. Click Apply.
4. To restart the RIG and apply the changes:
   1. Navigate to RIG > Admin > Restart.
   2. When the following message appears, click Yes.
      
      
      Restart 

Configure the server.properties File

Follow these steps to locate, download, update, and save the server.properties file:

1. Navigate to RIG > File Manager.
   The File Manager window appears.
   
   
   server.properties File 
2.  Look for the Remote File System pane on the right; then navigate to the etc\ server.properties configuration file in the RIG installation directory.
   
   
   server.properties File
3.  Right-click on the server.properties file and select Download.
4. Save the server.properties file to the local destination.
5. Navigate to the server.properties file.
6. Right-click on the server.properties file and select Open With.
7. Open the file using Notepad.
8. See Configure RIG Credentials for FTP  below
9. See Configure to Collect CDRs below
10. Navigate to File > Save to save any changes.
11. Navigate to RIG > File Manager.
    The File Manager window appears.
12. Navigate to the etc\server.properties configuration file in the RIG installation directory.
13. Right-click on the server.properties file and select Upload.
14. Browse to the updated server.properties file, select, and click Open. 
    The Upload File window appears.
    
    
    Upload
15.  Click Upload.
16. To restart the RIG and apply the changes:
    1. Navigate to RIG > Admin > Restart.
    2. When the following message appears, click Yes.
       
       
       Restart

Configure RIG Credentials for FTP

Before administering CDRs on the Cisco UCM, you must configure credentials from the RIG for SFTP/FTP. These credentials are stored in the etc\server.properties configuration file located in the RIG installation directory. 

1. Create a username and password for SFTP/FTP connections.
2. Add these credentials to the configuration file, as shown in the following example:
   
   
   FTP Credentials
   NOTE

   If there are already existing properties for these credentials, they must be updated.
   Alternatively, you can use the superuser credentials, if you know the respective password that is stored in the configuration file in encrypted form.

3.  Record the credentials, which will be needed when managing CDRs (see Manage CDRs).

Configure to Collect CDRs

Add the following line to the server.properties file PRIOR to the start of the modules in order to collect CDRs.

sshAllowInsecureAlgorithms=true

View the following example.

sshAllowInsecureAlgorithms 

Configure the ciscoucm-module.properties File

Follow these steps to locate, download, update, and save the ciscoucm-module.properties file:

1. Navigate to RIG > File Manager. The File Manager window appears.
   
   
   Remote File System 
2.  Look for the Remote File System pane on the right; then navigate to the \etc\ciscoucm- module.properties configuration file in the RIG installation directory.
   
   
   ciscoucm-module.properties File 
3.  Right-click on the ciscoucm-module.properties file and select Download.
4. Save the ciscoucm-module.properties file to the local destination.
5. Navigate to the ciscoucm-module.properties file.
6. Right-click on the ciscoucm-module.properties file and select Open With.
7. Open the file using Notepad.
8. See Enable Registration Events below.
9. See Change CDR Retention below.
10. Navigate to File > Save to save the changes.
11. Navigate to RIG > File Manager.
    The File Manager window appears.
12. Navigate to the \etc\ciscoucm-module.properties configuration file in the RIG installation directory.
13. Right-click on the ciscoumc-module.properties file and select Upload.
14. Browse to the updated ciscoumc-module.properties file, select, and click Open.
    The Upload File window appears.
15. Click Upload.
16. To restart the RIG and apply the changes:
    1. Navigate to RIG > Admin > Restart.
    2. When the following message appears, click Yes.
       
       
       Restart

Enable Registration Events

Follow these steps to receive events for registration and de-registration of phones:

1.  Locate the send.registration.event parameter.
2. Change the value to true, as shown below:
   
   
   Cisco Unified Serviceability

    The default value is false (or disabled).

Change CDR Retention

Follow these steps to change the CDR retention value in order to limit data that is stored:

1. Locate the cdrAgeDays parameter.
2. Enter a new value. The default value is 30 days, as shown in Figure cdrAgeDays
   
    
   cdrAgeDays 
   NOTE

   If the cdrAgeDays parameter is set to less than 5, then it will default to 30 days for Cisco UCM module.

Configure the receiver-module.properties File

Follow these steps to locate, download, update, and save the receiver-module.properties file, as needed:

1. Navigate to RIG > File Manager.
   The File Manager window appears.
   
   
   Remote File System 
2.  Look for the Remote File System pane on the right; then navigate to the etc\receiver- module.properties configuration file in the RIG installation directory.
   
   
   receiver-module.properties File 
3. Right-click on the receiver-module.properties file and select Download.
4. Save the receiver-module.properties file to the local destination.
5. Navigate to the receiver-module.properties file.
6. Right-click on the receiver-module.properties file and select Open With.
7. Open the file using Notepad.
8. See Enable Syslog below.
9. Navigate to File > Save to save the changes.
10. Navigate to RIG > File Manager.
    The File Manager window appears.
11. Navigate to the etc\receiver-module.properties configuration file in the RIG installation directory.
12. Right-click on the receiver-module.properties file and select Upload.
13. Browse to the updated receiver-module.properties file, select, and click Open.
    The Upload File window appears.
14. Click Upload.
15. To restart the RIG and apply the changes:
    1. Navigate to RIG > Admin > Restart.
    2. When the following message appears, click Yes.
       
       
       Restart

Enable Syslog

To enable Syslog, add the following property and value:

syslog.enable 

Configure Cisco UCM

Configuring the CUCM includes the following tasks:

• Configure SNMP
• Configure Nectar User
• Activate Services
• Administer Call Detail Records
• Edit Performance Monitoring Parameter
• Verify Cisco RisPort Service Activation

Configure SNMP

Configuring the SNMP includes the following tasks:

• Create the SNMP Community String
• Add a SNMP Notification Destination

Create the SNMP Community String

Follow these steps to create the SNMP community string:

1. Access Cisco Unified Serviceability using the drop-down; then click Go.
   
   
   Cisco Unified Serviceability 
2. Enter your Username and Password; then click Login.
   
   
   Login 
3. Navigate to SNMP > V1/V2 > Community String.
   The SNMP Community String Configuration window appears.
   
   
   Select a Server 
4.  Select a Server* using the drop-down; then click Find.
   A list of community strings appears.
   
   
   Search Results/Community Strings 
   NOTE

   You can also use the Find Community Strings where Name field to search for existing community strings.
5. To add a new community string, click Add New.
   A new SNMP Community String Configuration window appears.
   
   
   Add a New Community String 
6. Complete the following to define the new community string:
   1. This shows the server you selected in step 4.
   2. Enter the name of the community string, such as cmpreadonly.
   3. Select Accept SNMP Packets only from these hosts.
   4. Enter the IP address of the Nectar RIG that will monitor the Cisco system; then click Insert.
   5. The IP address will appear in the Host IP Addresses field.
   6. Click the drop-down arrow and select ReadNotifyOnly for access privileges. This option means the community string can read the values of MIB objects and also send the values for trap and inform messages.

• Select Apply To All Nodes to apply to all servers in the cluster.
• Click Save to save the new community string (or updates to an existing community string), restart the SNMP master agent service, and apply the changes.

Add a SNMP Notification Destination

Follow these steps to add a SNMP notification destination:

1. Access Cisco Unified Serviceability using the drop-down; then click Go.
   
   
   Cisco Unified Serviceability 
2. Enter your Username and Password; then click Login.
   
   
   Login
3. Navigate to SNMP > V1/V2 > Notification Destination.
   The SNMP Notification Destination Configuration window appears.
   
   
   SNMP Notification Destination Configuration
4. Select a Server* using the drop-down; then click Find.
5. Click Add New.
   A new SNMP Notification Destination Configuration window appears.
   
   
   Add a New Notification Destination 
6. Complete the following to define the new notification destination:
   1. This shows the server you selected in Step 4.
   2. Select Add New for Host IP Addresses* using the drop-down
   3. Enter the IP address of the Nectar RIG.
   4. Enter the port number, such as 162, if not already populated.
   5. Select SNMP Version V2C.
   6. Select Trap as the Notification Type* using the drop-down.
   7. Select the community string using the drop-down, such as cmpreadonly.
      NOTE

      You can also click Create New Community String to add a new community string. For more information, see Create the SNMP Community String above.
   8. Select Apply To All Nodes to apply to all servers in the cluster.
   9. Click Insert to restart the SNMP master agent service and apply the changes.

Configure Nectar User

Follow these steps to configure the Nectar User to be used when you onboard a CUCM cluster:

1. Access Cisco Unified CM Administration using the drop-down; then click Go.
   
   
   Cisco Unified CM Administration 
2. Enter your Username and Password; then click Login.
   
   
   Login 
3. Navigate to User Management > Application User.
   The Find and List Application Users window appears.
   
   
   Find and List Application Users 
4. Click Add New.
   The Application User Configuration window appears.
   
   
   Application User Configuration 
5. Enter the following information in the Application User Information area:
   
   

   Parameter	Enter
   User ID*	Name of the new AXL user, such as NectarUser1.
   Password	Password associated with the new AXL user.
   Confirm Password	Password to confirm.

6. Click Add to Access Control Group.
   
   
   Add to Access Control Group 
   
   The Find and List Access Control Groups window appears.
   
   
   Find and List Access Control Groups
7. Select the following Access Control Groups, as shown in Find and List Access Control Groups.
   1. Standard AXL User
   2. Standard CCM Read Only
   3. Standard RealtimeAndTrace Collection
8. Click Add Selected.
   The Application User Configuration window appears with the new Access Control Groups listed.
   
   
   Application User Configuration 
9. Click Save.
   Notice that the Roles pane populates with the roles associated with the Application User.
   
   
   Roles 

Activate Services

Follow these steps to activate service:

1. Access Cisco Unified Serviceability using the drop-down; then click Go.
   
   
   Cisco Unified Serviceability 
2. Enter your Username and Password; then click Login.
   
   
   Login 
3. Navigate to Tools > Service Activation.
   The Service Activation window appears.
   
   
   Select a Server 
4. Select a Server* using the drop-down; then click Go.
   The Service Activation window appears.
   
   
   Service Activation 
5. Confirm that the following services are selected for CDR Services:
   NOTE

   If other services are selected, do not change.
   1. Cisco SOAP - CDRonDemand Service
   2. Cisco CAR Web Service
      
      
      CDR Services 
6. Confirm the following services are selected for Database and Admin Services:
   1. Cisco Bulk Provisioning Service
   2. Cisco AXL Web Service
      
      
      Database and Admin Services 
7. Confirm the following services are selected for Performance and Monitoring Services:
   1. Cisco Serviceability Reporter
   2. Cisco CallManager SNMP Service
      
      
      Performance and Monitoring Services 
8. Click Save.
   
   
   Save 

Administer Call Detail Records

Configuring the Cisco UCM to deliver call detail records (CDRs) to the Nectar RIG via SFTP includes the following tasks:

• Configure System Parameters
• Manage CDRs

Configure System Parameters

To ensure that CDRs and call management records (CMRs) can be generated, follow these steps to enable certain Cisco UCM service parameters:

1. Access Cisco Unified CM Administration using the drop-down; then click Go.
   
   
   Cisco Unified CM Administration 
2. Enter your Username and Password; then click Login.
   
   
   Login 
3. Navigate to System > Service Parameters.
   The Service Parameters Configuration window appears.
   
   
   Select Server and Service 
4. Select the Server* using the drop-down.
5. Select the Service* (in this case, Cisco CallManager (Active)) using the drop-down.
   The Service Parameter Configuration window expands to show the service parameters.
   
   
   Service Parameters Configuration 
   NOTE

   The default value for each system parameter is false. You must enable, if not already, using the information in Step 6 in order for the RIG to retrieve Call Manager and Call Detail records.
6. Specify the value for the following parameters:
   Table - System Parameters

   Parameter	Description
   CDR Enabled Flag	Determines whether or not CDRs are generated. Set value to True to generate CDRs. Enable this parameter on ALL servers.
   CDR Log Calls with Zero Duration Flag	Set value to True.Enables or disables the logging of CDRs for calls that never connected or lasted less than one second.

   Table - Clusterwide Parameters (Device - General)

   Parameter	Description
   Call Diagnostics Enabled*	Set value to Enabled when CDR Enabled flag is set to True. Enables CMRs/diagnostic records to be generated.
   Show Line Group Member DN in finalCalledPartyNumber CDR Field	Set value to True to show the finalCalledPartyNumber field in the CDRs. Shows the directory number (DN) of the line group member who answered the call or the hunt pilot DN.

   Table - Clusterwide Parameters (Device - Phone)

   Parameter	Description
   Add Incoming Number Prefix to CDR*Add Incoming Number Prefix to CDR*	Located under Advanced of the Service Parameter Configuration window. Set value to Enabled. Causes Cisco UCM to add the incoming prefix to the calling party number in the CDRs for that call (as specified in the National Number Prefix, International Number Prefix, Subscriber Number Prefix, and Unknown Number Prefix service parameters).

7. Click Save.

Manage CDRs

Follow these steps to manage the CDRs:

1. Access Cisco Unified Serviceability using the drop-down; then click Go.
   
   
   Cisco Unified Serviceability 
2. Enter your Username and Password; then click Login.
   
   
   Login 
3. Navigate to Tools > CDR Management.
   The CDR Management window appears.
   
   
   CDR Management 
4. In the Billing Application Server Parameters area, click Add New.
   
   
   Billing Application Server Parameters
5. Using Billing Application Server Parameters (above), complete the following:
   1. Enter the IP address of the RIG.
   2. Enter the Super User name and password from Configure System Parameters above.
      NOTE

      If the Super Username or password is preceded with a dash, it must be included, for example, -98765432101111111.

   3. Enter the protocol as FTP.
   4. Enter the directory path as /cucm/.
6. Click Add.

Verify Load CDR Only Option

Follow these steps to verify that the Load CDR Only check box is NOT selected:

1. Access Cisco Unified Serviceability using the drop-down; then click Go.
   
   
   Cisco Unified Serviceability 
2. Enter your Username and Password; then click Login.
   
   
   Login 
3. Navigate to Tools > CDR Analysis and Reporting.
   
   
   Tools > CDR Analysis and Reporting
   
   The Cisco Unified CM CDR Analysis and Reporting window appears.
4. Navigate to System > Scheduler > CDR Load.
   
   
   System > Scheduler > CDR Load 
   
   The CDR Load window appears.
   
   
   CDR Load 
5. Verify that the Load CDR Only check box is not selected.
6. Click Update.
   NOTE

   Changes will take effect at midnight.
   For the changes to take effect immediately, restart the Cisco CDR Analysis and Reporting Scheduler service.

Edit Performance Monitoring Parameter

Follow these steps to edit the number of performance monitoring requests that are allowed per minute. The default value is 50.

1. Access Cisco Unified Serviceability using the drop-down; then click Go.
2. Navigate to System > Enterprise Parameters.
   The Enterprise Parameters Configuration window appears.
   
   
   Enterprise Parameters Configuration 
3. Scroll down to CCM Web Services Parameters area.
   The Enterprise Parameters Configuration window appears.
   
   
   CCM Web Services Parameters 
4. Change the Allowed Performance Queries Per Minute parameter to 80.
5. Click Save; then Apply Config.

Verify Cisco RisPort Service Activation

Follow these steps to verify that the Cisco RisPort Service is activated.

1. Access Cisco Unified Serviceability using the drop-down; then click Go.
2. Navigate to Tools > Control Center - Network Services.
   The Control Center - Network Services window appears.
   
   
   Control Center - Network Services 
3. Select a Server* using the drop-down; then click Go.
4. Scroll down to Soap Services area.
5. Verify that the SOAP - Real-Time Service APIs is running, which means the RisPort service is also activated.
   
   
   SOAP - Real-Time Service APIs - Running 

Configure SNMP on Routers/Voice Gateways

You must enable SNMP on any route or voice gateway that the Nectar software monitors. Follow these steps to configure SNMP on a router or voice gateway to be monitored:

1. Login to the router or voice gateway command line interface (CLI) via SSH or Telnet:
   1. Enter Enable mode.
   2. Enter Configuration mode using config terminal.
2. Add an Access Control List (ACL) with the IP address of the Nectar RIG that monitors the router. In this example, the RIG is 10.65.1.252.
   1. hostname# config t
   2. hostname(config)# access-list 1 permit 10.65.1.252
3. Add a SNMP community string for polling from Nectar Foundation:
   NOTE

   The community string should be the same one used in Create the SNMP Community String above.
   1. hostname(config)# snmp-server
   2. hostname(config)# snmp-server community cmpreadonly ro 1
   3. hostname(config)# exit
   4. hostname# write memory

Configure CUCM VKM

Configuring CUCM VKM includes the following tasks:

• Add a New Cluster Configuration
• View Collections
• Remove or Offboard a Cluster Configuration
• CUCM CDR File Storage

Add a New Cluster Configuration

Follow these steps to add a new cluster configuration:

1. Navigate to Modules > Cisco > UCM.
   
   
   Modules > Cisco > UCM
   
   The Cisco UCM Setup - Configurations window appears.
2. Click Add.
   
   
   Cisco UCM Setup - Configurations 
   
   The Add Cisco UCM - General window appears.
   
   

   Add Cisco UCM

3. Enter the following information; then click Next.
   
    - Add Cisco UCM

   Parameter	Enter...
   Name	Name of the onboarding cluster configuration.
   Description	Description of the cluster configuration.

   The Add Cisco UCM - SNMP window appears.
   
   
   Add Cisco UCM - SNMP 
4. Enter the following SNMP information; then click Next.
   Table - Add Cisco UCM - SNMP

   Parameter	Enter or select...
   IP Address	IP address of the Publisher server of the cluster.
   SNMP Version	SNMP version from the following: V1 V2 V3
   Port	SNMP port, such as 161.
   Community	Community string previously configured, such as cmpreadonly.
   Authentication	Authentication from one of the following: None MD5 SHA
   User ID	User ID previously set up for the SNMP community string.
   Password	Password previously set up for the SNMP community string.
   Privacy Protocol	Protocol from one of the following: None DES AES AES-192 AES-256 NOTE Enabled for SNMP V3 only.
   Privacy Password	Password for the Privacy Protocol. NOTE Enabled for SNMP V3 only.

   The Add Cisco UCM - AXL window appears.
   
   
   Add Cisco UCM - AXL 
5. Enter the following AXL User information; then click Next.
   Table - Add Cisco UCM - AXL

The Add Cisco UCM - Gateways window appears.

Add Cisco UCM - Gateways 

6. Perform the following; then click Next:

• Specify whether or not you want to Discover SIP Gateways.
• Select the gateway(s) you want to monitor.

7. Click Finish.

The Cisco UCM Setup window appears with the new cluster configuration listed.

• Cluster Configuration 

The VKM collection processes and Nectar monitoring are also initiated. For more information, see View Collections below.

View Collections

Follow these steps to view a list of collections for the CUCM cluster:

1. Navigate to Modules > Cisco > UCM.
   The Cisco UCM Setup - Configurations window appears.
2. Select the new cluster configuration; then click View Collections.
   
   
   View Collections 
   
   The Collections window appears.
   
   
   Collections
3. View collection data for the system configuration, such as:
   1. Name
   2. Enabled
   3. Status
   4. Schedule
   5. Last Execution
   6. Last Execution Duration
4. Right-click on a collection and select one of the following:
   
   
   Collections 
   
   For more information, see Manage Collections under Manage CUCM Clusters.

Remove or Offboard a Cluster Configuration

Follow these steps to remove or offboard a cluster configuration:

1. Navigate to Modules > Cisco > UCM.
   
   
   Modules > Cisco > UCM
   
   The Cisco UCM Setup - Configurations window appears.
   
   
   Cisco UCM Setup - Configurations 
2. Select an existing cluster configuration that you want to remove or offboard.
3. Click Remove.
4. When the following message appears, click Yes.
   
   
   Remove 
   
   The cluster configuration is removed and no longer appears in the list on the Cisco UCM Setup- Configurations window.

CUCM CDR File Storage

The CUCM VKM generates csv files for the collected CDRs. These files are generated and stored in the following directories:

• cdr/cucm
• archive/cucm

When these files get created, the data is first stored in the cdr/cucm folder until the files are transferred to the destination Call Analysis Module (CAM). After the files are successfully transferred, they are then stored in the archive/cucm folder. Any files that remain in the cdr/ cucm folder did not transfer.

cdr folder

Follow these steps to navigate to the cdr/cucm folder:

1. Navigate to RIG > File Manager. The File Manager window appears.
2. Locate the cdr folder in the Apps folder.
3. Locate the cucm folder in the cdr folder.
4. View the following example path.
   <dir>:\applicationhomedirectory\cdr\cucm
5. View a list of archived files in the cucm folder.

archive folder

Follow these steps to navigate to the archive folder:

1. Navigate to RIG > File Manager. The File Manager window appears.
2. Navigate to the folder where the application is installed.
3. Locate the archive folder in the application folder.
4. Locate the cucm folder in the archive folder.
5. View the following example path:
   <dir>:\applicationhomedirectory\archive\cucm
6. View a list of archived files in the cucm folder.

Configure CUCM Alarms

Follow these steps to configure the CUCM to forward all alarms that meet or exceed the configured severity to the RIG:

1. Access Cisco Unified CM Administration using the drop-down; then click Go.
   
   
   Cisco Unified CM Administration 
2. Enter your Username and Password; then click Login.
   
   
   Login 
3. Navigate to System > Enterprise Parameters.
   The Enterprise Parameters Configuration window appears.
4. Scroll down to the Cisco Syslog Agent area.
   
   
   Cisco Syslog Agent 
5. Enter the following information:
   Table - Parameters

   Parameters	Enter...
   Remote Syslog Server Name 1, 2, etc.	IP address(es) of the RIG(s) that will receive the alarms.
   Syslog Severity for Remote Syslog Messages	WARNING, which is the lowest CUCM alarm severity that the CUCM VKM will receive and process.

6. Click Save; then click Apply Config.

Manage Trunk Types

Managing trunk types includes the following tasks:

• Add a Trunk Type
• Edit a Trunk Type
• Remove a Trunk Type

Add a Trunk Type

Follow these steps to add a trunk type:

1. Navigate to Modules > Cisco > UCM.
   The Cisco UCM Setup - Configurations window appears.
2. Click the Trunk Types tab.
   The Cisco UCM Setup - Trunk Types window appears.
   
   
   Cisco UCM Setup - Trunk Types 
3. Right click and select Add.
   
   
   Add Trunk Type 
   
   The Add Trunk Type window appears.
   
   
   Add Trunk Type 
4. Enter the following information:
   Table - Add a Trunk Type

   Parameter	Enter or select ...
   Cluster ID	Cluster ID associated with this trunk type.
   Call Manager ID	Call Manager ID associated with this trunk type.
   Trunk Type	One of the following: CARRIER INTERNAL UNKNOWN
   Trunk Near IP	IP address near the trunk.
   Trunk Far IP	IP address furthest from the trunk.
   Rate Call	One of the following to indicate whether or not it is a rate call: Yes No

5. Click OK.

Edit a Trunk Type

Follow these steps to edit a trunk type:

1. Navigate to Modules > Cisco > UCM.
   The Cisco UCM Setup - Configurations window appears.
2. Click the Trunk Types tab.
   The Cisco UCM Setup - Trunk Types window appears.
   
   
   Cisco UCM Setup - Trunk Types 
3. Right-click on a trunk type and select Edit.
   
   
   Edit Trunk Type 
   
   The Edit Trunk Type window appears.
   
   
   Edit Trunk Type 
4. Make changes, as needed.
5. Click OK.

Remove a Trunk Type

Follow these steps to remove a trunk type:

1. Navigate to Modules > Cisco > UCM.
   The Cisco UCM Setup - Configurations window appears.
2. Click the Trunk Types tab.
   The Cisco UCM Setup - Trunk Types window appears.
   
   
   Cisco UCM Setup - Trunk Types 
3. Right-click on a trunk type to delete and select Remove.
   
   
   Remove Trunk Type 
   
   The Remove window appears.
   
   
   Remove 
4. Click Yes.

Configure VKM Options

Follow these steps to configure the VKM options for the CUCM:

View Inventory

Follow these steps to view inventory data for a specific cluster or all clusters: 

1. Navigate to Reports > Inventory > Cisco > UCM.
   
   
   Reports > Inventory > Cisco UCM 
   
   The Cisco UCM Inventory window appears with a list of the inventory categories.
   
   
   Cisco UCM Inventory 
2. Select an inventory category, such as Call Manager. The Listing window appears with data for Call Manager.
   
   
   Call Manager - Example 
3. Notice the CUCM Clusters drop-down.
   You can click the drop-down to select a specific cluster when there is multiple onboarded clusters on the same RIG to filter the data that is displayed.

CUCM VKM and Nectar UCMP

After deployment, the CUCM VKM creates elements, dependency trees, and call detail that you can view:

• View Elements
• View Dependency Tree
• View Call Details

View Elements

Viewing elements includes the following tasks:

• View Agents and Poll Functions
• Edit Poll Thresholds
• Change Poller Data Storage Setting
• Edit an SNMP Connection Test Poll Function

View Agents and Poll Functions

The CUCM VKM adds an agent and poll functions for each onboarded cluster.

Follow these steps to view the new agent and poll functions that were created for each cluster:

1. Navigate to Health > Elements.
   
   
   Health > Elements 
   
   The Elements window appears.
   
   
   Elements 
2. Click Agents.
   A list of agents appears.
   
   
   Agents 
   
   
   
   NOTE

   The actual list of agents will depend on the architecture of each individual CUCM deployment.

   
   
3. Click on an agent to view the poll functions for that agent.
   View the following example.
   
   
   Poll Functions 

Edit Poll Thresholds

Follow these steps to edit a poll threshold:

1. See View Agents and Poll Functions above.
2. Select a poll function; then right-click and select Edit.
   
   
   Edit Poll Function 
   
   The Edit Poll Functions - Parameters window appears.
   
   
   Edit Poll Functions 
3. Click the Thresholds tab.
   
   
   Threshold Values 
4. View the various threshold values.
5. Perform one of the following as needed:

• Click Add to add a new threshold for the poll function.
• Edit a threshold value; then click Update to save.
• Click Cancel to close the window after viewing the threshold(s).

Change Poller Data Storage Setting

By default, the Compression setting (or storage of poller data) is one month. Follow these steps to change the compression setting:

1. See View Agents and Poll Functions above.
2. Right-click on a poll function and select Edit.
   The Edit Poll Functions - Parameters window appears.
3. Click ... for Compression.
   The Edit Compression window appears.
   
   
   Edit Compression 
4. Select one of the following values:
   - 1 Week
   - 2 Weeks
   - 1 Month
   - 3 Months
   - (Do Not Store)
   
   
   NOTE

   Click Edit to add or remove a compression strategy.

   
   
5. Click Select.
6. Click Update.

Edit an SNMP Connection Test Poll Function

You can edit the Allowed Failures and Previous Failure Count for the SNMP Connection Test poll function.

Follow these steps to edit an SNMP Connection Test poll function:

View Dependency Trees

View a dependency tree using one of the following:

• View Dependency Tree
• View Publisher Connectivity Node
• View Subscriber Connectivity Node

View Dependency Tree

Follow these steps to view the created dependency tree:

View Publisher Connectivity Node

Follow these steps to view the Publisher Connectivity node:

• AXL API Connection Test
• Perfmon Connection Test
• SNMP Connection Test

Publisher Connectivity Tree 

View Subscriber Connectivity Node

Follow these steps to view the Subscriber Connectivity node:

• Perfmon Connection Test
• SNMP Connection Test

Subscriber Connectivity Tree 

View Call Details

Follow these steps to view more information about a specific call.

1. Navigate to Health > Quality Management > Call Details.
   The Call Details window appears.
   
   
   Call Details 
2. Select a call; then right-click and select View Details.
   
   
   Call Details 
   
   The Call Detail window appears with the call details. The following example shows a sampling of the window and highlights the following parameters:
   Table - Call Detail

   Parameter	Description
   PKID	Identifies a text string that the database uses internally to uniquely identify each row; provides no meaning to the call itself.
   Origination Details: Media Cap Bandwidth	Identifies the media bandwidth that is used at the origination of the call; default value is 0.
   Destination Details: Media Cap Bandwidth	Identifies the media bandwidth that is used at the destination of the call; default value is 0.
   Cisco Headset Information
   Concealed Seconds (CS)	Represents the time during which some concealment is observed during a call.
   Severely Concealed Seconds (SCS)	Represents the time during which a significant amount of concealment is observed during a call.

   
   
   
   
   Call Detail 

Troubleshoot Communications from CUCM to RIG

With access to the CUCM command line, the following commands can be used to help troubleshoot communications between CUCM and the management station:

Follow these steps to verify traffic:

1. Log on to the CUCM command line via ssh.
2. Perform one of the following:
   1.  To verify that SNMP traffic is flowing between Call Manager and the RIG, enter the following command:
      utils network capture host ip [address] port 161
   2. To verify that SOAP/AXL traffic is flowing between Call Manager and the RIG, enter the following command:
      utils network capture host ip [address] port 8443
   3. To verify that CDR traffic is flowing from Call Manager and the RIG, enter the following command:
      utils network capture host ip [address] port 22
   4. To stop the capture, press Ctrl + C.
      This causes the capture process to end; no new packets are added to the capture dump.
   5. To collect the capture from the server, transfer the capture file using one of the following.
      NOTE

      The capture files are stored in the activelog platform/cli/ location on the server.

      
      

Transfer Capture File through the CLI to a SFTP server

1. Use the command file get activelog platform/cli/packets.cap to collect the packets.cap file to the SFTP server.
2. Enter the SFTP server IP/FQDN, port, username, password, and directory information. The CLI should indicate success or failure of the file transfer to the SFTP server.

Transfer Capture File to Local PC Using Real-Time Monitoring Tool (RTMT)

1. Launch RTMT.
   If it is not installed on the local PC, install the appropriate version from the CUCM Administration window. Navigate to Applications > Plugins menu. Click System; then Trace & Log Central. Double-click Collect Files. Click Next through the first menu.
   
   
   RTMT Window 
2. From the Collect Files window, select Packet Capture Logs.
   
   
   Collect Files 
3. Select a time range when the capture is performed and a download directory on the local PC:
   
   
   Collection Time 
   
   RTMT closes this window, proceeds to collect the file, and stores it on the local PC in the specified location.

Manage CUCM Clusters

This section explains several tasks that can be used to manage the CUCM clusters, as needed.

• Edit a Cluster Configuration
• Manage Collections

Edit a Cluster Configuration

Follow these steps to edit a cluster configuration:

Manage Collections

Managing collections includes the following tasks:

• Enable a Collection
• Disable a Collection
• Change a Collection Schedule
• Execute a Collection

Enable a Collection

Follow these steps to enable a collection for a particular cluster configuration:

1. See View Collections. under Configure CUCM VKM.
2. Select the collection you want to enable.
3. Right-click on the collection and select Enable.

The Enabled column for the system changes to Yes.

Disable a Collection

Follow these steps to disable a collection for a particular cluster configuration:

1. See View Collections. under Configure CUCM VKM.
2. Select the collection you want to disable.
3. Right-click on the collection and select Disable. 

Change a Collection Schedule

Follow these steps to change the collection schedule for a particular cluster configuration:

1. See View Collections under Configure CUCM VKM.
2. Select the collection you want to change.
3. Right-click on the collection and select Change Cron String.
   The Update Cron String window appears.
   
   
   Update Cron String 
4. Enter the new collection schedule using a Cron expression.
5. Click OK.

Execute a Collection

Follow these steps to execute a collection:

1. See View Collections under Configure CUCM VKM.
2. Select the collection you want to execute.
3. Right-click on the collection and select Execute Now.