Table of Contents
AXL Configuration
VSM use AXL API to collect data from CUCM, this can be achieved by creating user with AXL Capabilities within CUCM.
Enable AXL Service
Go to Cisco Unified Serviceability.
Logging to Serviceability
Go to Tools >>Control Centre - Feature Service.
Tools>>Feature service
Select server – Choose Publisher
Make Sure AXL Web Service status is started, otherwise start it if it was deactivated or stopped.
AXL Web Service status
Create CUCM AXL User
Log in to Cisco Unified CM Administration to create AXL user.
Log in to Cisco Unified CM Administration
Create Access control group with AXL privilege for AXL user.
Go to User Management>>User Settings >>Access Control Group>>Add new
Access Control Group
Add New Access Control Group
Enter the Access control group name and click save.
Create Access Control Group
On the related links on click Assign Role to Access Control Group
Access Control Group Related Links
Assign Role to Access Control Group
On the Access Control Group Information Click on Assign Role to Group.
Assign Role to Group
List of Roles of page appear with all the roles.
List of Roles
Select the checkbox for the following rules and click Add Selected:
- Standard AXL API Access.
- Standard CCM Admin Users.
- Standard SERVICEABILITY Read Only.
The following Page displays, click save.
Access Control Group with Roles assigned
Go to User Management>>Application User>>Click Add New
Application User Page
Enter user details in the Application User Information.
Application User Information
Field | Value |
User ID | This is the user that is going to be used by VSM to access the CUCM |
Password | Enter the password for the new user. |
Confirm Password | Type the same password again. |
Application User Information
VSM Application User
Under Permission Information in the new created Application User click on Add to Access Control Group.
Application User Configuration – Permission Information
In the search bar type the name of previously created Access Control Group.
Find and List Access Control Groups
Enter the name of previously created Access Control Group >>Click Find>>Check the checkbox next to Access control Group and Click Add Selected.
Assign AXL Access Control Group to the VSM AXL User
Click Save under Application User Configuration.
Application user with the new Access Groups Assigned
Once You click Save it will show the list of roles assigned to the user.
Application User Final Status
Make sure you can sign in to CUCM with the newly created account by signing out and sign back in again with the your new account.
Signing to CUCM with the new AXL Account
CUCM SNMP Configuration
SNMP configuration is required as part of CUCM Monitoring, SNMP can be configured as V1 ,V2 or V3 based on the customer requirements.
Configure SNMP V1/V2
Navigate to Cisco Unified Serviceability>>SNMP>>V1/V2>>Community String
Cisco Unified Serviceability Navigation
SNMP V1/V2
SNMP Community String Configuration
From the drop down List Choose the server you want to configure SNMP and click find>>Add new if none was configured.
SNMP need to be configured on all the servers in CUCM Cluster.
SNMP Community String Configuration
Fill in the SNMP Community String Page with the following values.
SNMP Community String Configuration
Field | Value |
Community String Name | Enter the required Name |
Hosted IP Address Information | Choose one of the following based on the client requirements 1- Accept SNMP Packets from Any host. 2- Accept SNMP Packets only from these Hosts If you choose Accept SNMP Packets only form these hosts make sure to enter IP Address of VSM Probe server under Host IP Address |
Access Privilege | Choose ReadNotifyOnly unless something else required from the customer |
Apply to All Nodes | Check the check box to apply configuration to all servers within the cluster. |
SNMP Community String Configuration
SNMP Sample Configuration
When you click save warning will display notifying of restarting SNMP Master Agent Service for the change to take effect, click ok to restart the service.
SNMP Service Restart
Once completed the following message display with the status of the restart.
SNMP Service Restart Status
Configure CUCM to send SNMP Traps by navigating to SNMP>>V1/V2>>Notification Destination
SNMP Notification Destination
Field | Value |
Host IP Address | VSM Probe IP Address |
Notification Type | Trap |
SNMP Notification Destination
Choose server >>Find>>Click Add New
SNMP Notification Destination Server Selection
The following page appear, from the drop down list choose Add new.
SNMP Notification Destination Configuration
SNMP Notification Destination Configuration Drop Down List
Enter the Values in the page as per following
SNMP Notification Destination
Field | Value |
Host IP Addresses | Add New is selected |
Host IP Address | VSM Probe IP Address |
Port Number | Default is 162, change it only if needed |
SNMP Version | Choose either V1/V2C |
Notification Type Information | Trap |
SNMP Notification Destination Configuration – Add New Page
SNMP Notification Destination Configuration Sample Configuration
Once you choose Notification Type Community String Information will display.
Choose the community String created earlier and check apply to All Nodes.
SNMP Notification Destination Configuration – Apply To All Nodes
Click ok for the pop to restart the SNMP Master Agent Service as before unless client want to do it later.
Notification Destination Service Restart.
Once restart is completed SNMP Notification Destination Configuration will show the new Destination IP Address.
SNMP Notification Destination Configuration Status
CUCM SNMP V3 Configuration
Navigate to Cisco Unified Serviceability>>SNMP>>V3>>SNMP Destination Configuration and follow the same steps described earlier to add SNMP V2 Destination
SNMP V3 SNMP Destination Configuration
Select Server from the drop down list and click find.
SNMP V3 User Configuration
Click Add New to create SNMP User
SNMP V3 User configuration
Field | Value |
User Name | Enter SNMP User Name |
Authentication Required | Check the checkbox of Authentication |
Password | Enter the Password |
Protocol | Choose either MD5 or SHA |
Privacy Required | Optional/check the checkbox if required |
Password | Enter the password |
Protocol | Choose the preferred Protocol (DES/AES128) |
Accept SNMP Packets from Anyhost | Uncheck the checkbox |
Accept SNMP Packets only from these Hosts | Check the Check box |
Host IP Address | Enter the IP Address of the VSM Probe and click Insert |
Access Privileges | Choose ReadNotify Only |
Apply to All Nodes | Check the checkbox |
SNMP V3 User Configuration Page
SNMP V3 User Configuration Example
Click ok to the pop up to restart SNMP master agent for configuration to take effect
SNMP Master Agent Pop UP to restart the service
Once restart is completed SNMP user configuration will be displayed with the new user configured.
SNMP V3 User Configuration
Follow the same steps described in configuring SNMP Notification Configuration on SNMP V2 section.
SNMP V3 Notification Configuration
CUCM syslog configuration
Navigate to Cisco Unified CM Administration >> System >> Cisco Syslog Agent >>Remote Syslog Server Name
Enter the IP Address of VSM Probe as one of Remote Syslog Severs.
Syslog Severity for Remote Syslog messages >> Choose based on the requirements
CUCM Syslog configuration
CDR Configuration
Navigate to Cisco Unified Serviceability>>Tools >> Control Centre – Feature Service >>Select Publisher from the drop down list and make sure All CDR services are up.
Start the services if it was deactivated or stopped.
Control Centre – Feature Service CDR Services
Navigate to Cisco Unified Serviceability >> Tools >> Control Centre – Network Services >> Select Publisher from the drop down list and make sure all CDR services are up.
Control Centre – Network Services Publisher CDR Services
Navigate to Cisco Unified Serviceability >> Tools >> Control Centre – Network Services >> Select Subscriber from the drop down list and make sure CDR Agent service is running.
Repeat the above step for all subscribers in the Cluster.
Control Centre - Network Services Subscriber CDR Service
Navigate to Cisco Unified CM Administration >> System >> Service Parameter >> Call Manager Service. Set the CDR Enabled Flag to True. This has to be done for all the nodes in the server.
CUCM Service Parameters Configuration
Set up CDR Enabled Flag and CDR Log Calls with Duration to True
Repeat above step for all CUCM Servers in the cluster.
navigate to System >> Service Parameter >> Call Manager Service>> Clusterwide Parameters >> Call Diagnostics Enabled parameter to Enabled Only When CDR Enabled Flag is True
Setup Call Diagnostics – Enable CMR
Now add SFTP server/Billing Server where the files are to be sent. Navigate to Cisco Unified Serviceability > Tools > CDR Management and add new billing server.
CDR Management Page
Billing Application Server Parameters
Field | Value |
Host Name /IP Address | Enter Probe IP server |
Username | Enter username details for SFTP |
Password | Enter Password details for SFTP |
Protocol | SFTP |
Directory Path | \ |
Resend on Failure | Check the checkbox |
Billing Application Server Parameters
CUCM Backup Configuration
The following is required to configure VSM as destination for backup files. These Backup files will be sent from the VSM Probe to the Virsae Cloud.
Navigate Disaster Recovery System >> Backup >> Backup Device >> Add New
Disaster Recovery Page
Enter the required details for the Backup Device
Backup Device Details
Field | Value |
Backup Device Name | Enter Any name |
Host name / IP Address | VSM Probe IP Address |
Path name | \ |
User name | VSM SFTP server username |
Password | VSM SFTP server password |
Number of backups to store on Directory | Leave it to default – VSM Probe will send the backups to Virsae Cloud. |
Configure backup scheduler by navigating to Backup >> Scheduler.
Define Scheduler Name. Select the Device name (the device created earlier) and check the features you want to backup, ideally check all the options.
If using CUCM prior to Version 12.0, the features are CDR_CAR, UCM and PLM. If using CUCM Version 12.0 and later, the features are CDR_CAR, UCM and IM_AND_PRESENCE.
CUCM Backup features prior to Version 12.0
CUCM Backup features for Version 12.0 and later
Configure a schedule backup based on your scenario, recommended Daily backup after hours.
Backup Schedule
Click on Save and notice the warning as shown in the image. Click on OK in order to move forward.
Backup Warning
Once the Backup Schedule is created, click on Enable Schedule
Enable Schedule
Make sure the schedule status is changed to Enabled.
Schedule Backup Enabled
Web Portal Configuration
Add CUCM
Login to the VSM web portal using your credentials and password.
For your customer, select Service Desk > Equipment Locations. Right-click on the Equipment Location (Appliance) that will serve this particular UC Server and select ‘Manage Equipment’
At the bottom of the ‘Manage Equipment’ page click on the ‘Add Equipment’ Button
A form will open which you can populate with the equipment details as per table 8.
Select the Vendor ‘Cisco Systems’ and Product ‘Unified Communications Manager’.
Web Portal – Add Equipment
If you are adding more than one piece of the same equipment type check the ‘Add another’ box at the bottom of the form and the bulk of the configuration will be carried over for the next item.
Web Portal – Add CUCM Field Description
Field | Setting |
Vendor | Cisco Systems |
Product | Unified Communications Manager |
Equipment Name | Friendly name for this CUCM |
Username | Administrative Username |
Password | Administrative Password |
IP Address / Host Name | IP Address of server (Virtual in duplicated servers) |
Site | Free text field, this information will be included in alarm notifications from the VSM Workflow. |
Use Cisco APIs | Select if Using Cisco APIs for advanced options |
Info |
---|
Site ID information in the ‘Site’ field will advise your NOC staff of the site where the Microsoft Server is physically located. This is particularly helpful when the customer has multiple sites. |
Web Portal - CUCM Configure Equipment
Complete the Equipment tab and then click on the ‘SNMP Query’ tab.
Click on the down arrow, and select the SNMP version you wish VSM to use for querying the CUCM:
SNMP V1 or V2
Web Portal – CUCM SNMP V1/V2 Query
CUCM SNMP V1/V2 Field Descriptions
Fields | Setting |
Version | V1, V2 |
SNMP Community String | Community String as administered on the CUCM |
SNMP V3
Web Portal – CUCM SNMP V3 Query
CUCM SNMP V3 Field Description
Fields | Setting |
Version | V3 |
Username | SNMP V3 Username |
Authentication Protocol | SHA (recommended) |
Authentication Password | Password |
Privacy Protocol | DES (recommended) |
Privacy Password | Password |
Once all fields are populated Click on the Test Access button. This will test that VSM can connect to the CUCM using the settings you have entered:
Web Portal – CUCM Test Access
Both SSH and SNMP should return success. If not, trouble-shoot the configuration.
Info |
---|
The SSH test ensures the VSM probe can connect to, and login using the account configured. |
Info |
---|
The SNMP test ensures an SNMP query can be run. |
Once testing is successful, click Add.