Info |
---|
This section makes frequent use of data contained in the Technical Requirements. All relevant sections of the Technical Requirements Data collection should be completed or known before commencing with the steps in this section. |
Table of Contents
AXL Configuration
VSM use uses AXL API to collect data from CUCM, ; this can be achieved by creating a user with AXL Capabilities within CUCM.
Enable AXL Service
Go to Browse to the CUCM, then select "Cisco Unified Serviceability" from the navigation menu.
Logging to Serviceability
Go to Tools >>Control > Control Centre - Feature Service.
Tools>>Feature service
Select server – Choose PublisherClick on the select server dropdown menu and choose the CUCM Publisher. Then click 'Go'.
Make Sure AXL Web Service status is started, otherwise start it if it was deactivated or stopped.
If the AXL Web Service statusis deactivated or stopped, start it from the top of the page.
Create CUCM AXL User
Log in to Browse to the CUCM, then select 'Cisco Unified CM Administration to create AXL user' from the navigation menu. Once selected, click 'Go'.
Log in to Cisco Unified CM Administration
Create AXL privileged Access control group
...
Go to User Management > User Management>>User Settings >>Access Control Group>>Add new
Settings > Access Control Group.
Click the "Add New" button to create a new Access Control Groupgroup.
Enter the an Access control Control group name and click save.
Create Access Control Group
, e.g. VSM-Access-Control-Group.
In the top right corner, click on the related links dropdown menu. Next, select the "On the related links on click Assign Role to Access Control Group" option, then click 'Go'.
Access Control Group Related Links
Assign Role to Access Control Group
On the Access Control Group Information Click on Under 'Role Assignment', click the "Assign Role to Group" button.
Assign Role to Group
List of Roles of page appear with all the A page will appear with a list of all available roles.
List of Roles
Select the checkbox for the following rules and roles, then click 'Add Selected':
- Standard AXL API Access.
- Standard CCM Admin Users.
- Standard SERVICEABILITY Read Only.
The following Page displays, click saveAfter being added, the following page will appear - click 'Save'.
Access Control Group with Roles assigned
Go to User Management>>Application User>>Click Add New
Create an AXL User
From the CUCM Administration page go to User Management > Application User > then Click 'Add New'.
Application User Page
Enter user details in the Application User Information, using the following table.
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
Figure 16 – VSM Application User
...
Here is an example of the form being filled out.
Under 'Permission Information' for the newly created Application User, click 'Add to Access Control Group'.
Figure 17 – Application User Configuration – Permission Information
In the search bar
...
, enter the name of
...
the newly created Access Control Group - then click find.
Figure 18 – Find and List Access Control Groups
...
Check the checkbox next to the created Access control Group and
...
then click 'Add Selected'.
Figure 19 – Assign AXL Access Control Group to the VSM AXL User
Click Save under 'Application User Configuration'.
Figure 20 – Application user with the new Access Groups Assigned
Once
...
you click 'Save', it will show the list of roles assigned to the user.
...
Tip |
---|
Make sure you can sign in to CUCM with the newly created account by signing out and |
...
then signing back in |
...
with |
...
your new 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.
...
Info |
---|
Changes to the SNMP configuration on CUCM will require a service restart to take effect. |
Browse to the CUCM, then select "Cisco Unified Serviceability" from the navigation menu.
Configure SNMP V1/V2
Navigate to
...
Figure 23 – Cisco Unified Serviceability Navigation
Figure 24 – SNMP SNMP > V1/V2 Figure 25 – SNMP > Community String Configuration.
From the drop-down
...
list, choose the server you want to configure SNMP
...
for, then click find.
If no community strings are listed, or if you want to configure a new one, press the "Add New" button at the bottom of the page.
Note |
---|
SNMP needs |
...
to be configured on all the servers in the CUCM Cluster. |
Figure 26 – SNMP Community String Configuration
Fill in the SNMP Community String Page with the following values.
Table 2 – 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 to Accept SNMP Packets only |
from these hosts, make sure to enter the IP Address of the VSM Probe server under Host IP Address. | |
Access Privilege | Choose ReadNotifyOnly unless something else required from the customer. |
Apply to All Nodes | Check the |
checkbox to apply |
the configurations to all servers within the cluster. |
Figure 27 – SNMP Community String Configuration
Below is an example of the form being filled out.
Figure 28 – SNMP Sample Configuration
When you click save, a warning will
...
be displayed notifying you that you need to restart SNMP Master Agent Service for the
...
changes to take effect
...
.
Click 'OK' to restart the service.
Figure 29 – SNMP Service Restart
Once completed, the following message
...
will be displayed with the status of the restart.
Figure 30 – SNMP Service Restart Status
SNMP Traps
Configure CUCM to send SNMP Traps by navigating to
...
SNMP > V1/V2 > Notification Destination.
...
Table 3 – SNMP Notification Destination
Field | Value |
Host IP Address | VSM Probe IP Address |
Notification Type | Trap |
Figure 31 – SNMP Notification Destination
Choose server
...
> Find > Click "Add New
...
".
Figure 32 – SNMP Notification Destination Server Selection
The following page
...
appears; from the drop-down list, choose "Add
...
New".
Figure 33 – SNMP Notification Destination Configuration
Figure 34 – SNMP Notification Destination Configuration Drop Down List
- Enter the Values in the page as per following
Enter values into the page you are taken to as per the following table.
Table 4 – 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 |
Figure 35 – SNMP Notification Destination Configuration – Add New Page
...
Tip |
---|
Once you choose |
...
"Notification Type", the Community String Information will |
...
be displayed. Choose the Community String created earlier and check |
...
"Apply to All Nodes |
...
". |
When you click 'Insert', a warning will be displayed notifying you that a restart of SNMP Master Agent Service is required for the changes to take effect.
Click 'OK' to restart the service, or press 'Cancel' if you wish
...
Figure 37 – SNMP Notification Destination Configuration – Apply To All Nodes
...
to do it later.
Figure 38 – Notification Destination Service Restart.
...
After restarting, SNMP Notification Destination Configuration will show the new Destination IP Address.
Figure 39 – SNMP Notification Destination Configuration Status
...
CUCM SNMP V3 Configuration
Navigate
...
to
...
SNMP > V3 > User.
Select a server
Figure 40 – SNMP V3 SNMP Destination Configuration
...
from the drop-down list and click
...
'Find'.
Figure 41 – SNMP V3 User Configuration
Click 'Add New' to create an SNMP User
...
, then fill out the form using the table below.
Table 5 – 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 |
any host | 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 |
Figure 42 – SNMP V3 User Configuration Page
Figure 43 – SNMP V3 User Configuration Example
- Click ok to the pop up to restart SNMP master agent for configuration to take effect
Figure 44 – SNMP Master Agent Pop UP to restart the service
...
When you click 'Insert', a warning will be displayed notifying you that a restart of SNMP Master Agent Service is required for the changes to take effect.
Click 'OK' to restart the service.
After restarting, the SNMP user configuration will be displayed with the new user configured.
...
Navigate to SNMP > V3 > Notification Destination.
Choose server >Find > Click 'Add New'.
The following page will appear. From the drop-down list, choose 'Add New'.
Enter values into the page as per the following table.
SNMP Notification Destination Configuration Table
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 |
Security Level | Choose based on the security level configured for the user |
User Information | Check the checkbox next to a created user |
Apply to All Nodes | Check the checkbox next to Apply to All Nodes |
Click Insert.
When you click 'Insert', a warning will be displayed notifying you that a restart of SNMP Master Agent Service is required for the changes to take effect.
Click 'OK' to restart the service.
CUCM Syslog
Figure 45 – SNMP V3 User Configuration
- Follow the same steps described in configuring SNMP Notification Configuration on SNMP V2 section.
Figure 46 – SNMP V3 Notification Configuration
...
configuration
Navigate to Cisco Unified CM Administration
...
> System
...
> Cisco Syslog Agent
...
> Remote Syslog Server Name.
Enter the IP Address of the VSM Probe as one of the Remote Syslog
...
Servers.
Choose the Syslog Severity for Remote Syslog messages
...
based on
...
your requirements
...
.
Figure 47 – CUCM Syslog configuration
...
CDR Configuration
Navigate to Cisco Unified
...
Serviceability.
From there, navigate to Tools > Control Centre – Feature Service
...
> Select 'Publisher' from the drop-down list
...
.
Make sure All CDR services are up.
...
Start the services if it was deactivated or stopped.
Figure 48 – Control Centre – Feature Service CDR Services
Navigate to Cisco Unified Serviceability
...
> Tools
...
> Control Centre – Network Services
...
> Select Publisher from the drop-down list
...
.
Make sure all CDR services are up.
Figure 49 – Control Centre – Network Services Publisher CDR Services
Navigate to Cisco Unified Serviceability
...
> Tools
...
> Control Centre – Network Services
...
> Select Subscriber from the drop-down list
...
.
Make sure the CDR Agent service is running.
...
Repeat the above step for all subscribers in the Cluster.
Figure 50 – Control Centre - Network Services Subscriber CDR Service
Navigate to Cisco Unified CM Administration
...
> System
...
> Service Parameter
...
> Call Manager Service.
Set the 'CDR Enabled Flag' and the 'CDR Log Calls with Zero Duration Flag' to 'True'.
Note |
---|
This |
...
must be done for all the nodes in the server |
...
Figure 51 – CUCM Service Parameters Configuration
Figure 52 – Set up CDR Enabled Flag and CDR Log Calls with Duration to True
...
, as well as all CUCM servers in the cluster. |
...
Navigate to System
...
> Service Parameter
...
> Call Manager
...
Service > Clusterwide Parameters
...
.
Set the 'Call Diagnostics Enabled' parameter to 'Enabled Only When CDR Enabled Flag is True
...
'.
Navigate to Cisco Unified Serviceability > Tools >System > Scheduler > CDR Load
Make Sure that Continuous Loading 24/7 checkbox is selected.
Now add an
Figure 53 – Setup Call Diagnostics – Enable CMR
...
SFTP server/Billing Server where the files
...
will be sent to. Navigate to Cisco Unified Serviceability > Tools > CDR Management
...
> Add New Billing Server.
...
Figure 54 – CDR Management Page
Table 6 – 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 |
Figure 55 – Billing Application Server Parameters
...
Anchor CUCM Backup Configuration CUCM Backup Configuration
CUCM Backup Configuration
CUCM Backup Configuration | |
CUCM Backup Configuration |
The following is required to configure VSM as a destination for backup files. These Backup files will be sent from the VSM Probe to the Virsae Cloud.
Navigate to Disaster Recovery System
...
.
Navigate to Backup > Backup Device
...
> Add New
...
.
Figure 56 – Disaster Recovery Page
Enter the required details for the Backup Device
...
using the details in the following table.
Table 7 – 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 a Scheduler Name. Select the Device name (the device created earlier) and check the features you want to backup; ideally,
...
check all the options.
Tip |
---|
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. |
Figure 57 –CUCM CUCM Backup features prior to Version 12.0
Figure 58 - CUCM Backup features for Version 12.0 and later
Configure a backup schedule
...
based on your
...
situation.
We recommended a daily backup to occur after hours.
Figure 59 – Backup Schedule
Click
...
'Save'. A warning message, as shown in the image below, will pop up.
Click
...
'OK'.
...
Figure 60 – Backup Warning
Once the Backup Schedule is created, click on Enable Schedule
...
.
Note |
---|
...
Make sure the schedule status is changed to Enabled. |
Figure 62 – Schedule Backup Enabled
...
Once complete you can move on to the administration in the VSM Web Portal.
Web Portal Configuration
...
Add CUCM
Login Log in to the VSM web portal using your VSM credentials and password.
...
At the bottom of the ‘Manage Equipment’ page click on the ‘Add Equipment’ Buttonbutton.
A form will open which you can populate with the equipment details as per table 8the table below.
Select the Vendor ‘Cisco Systems’ and Product ‘Unified Communications Manager’.Figure 63 – Web Portal – Add Equipment
Info |
---|
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. |
...
Info |
---|
Site ID information in the ‘Site’ field will advise your NOC staff of the site where the CUCM Server is physically located. This is particularly helpful when the customer has multiple sites. |
Table 8 - Web Portal – Add CUCM Field Description Anchor AddCUCMFields AddCUCMFields
Field | Setting |
Vendor | Cisco Systems |
Product | Unified Communications Manager |
Equipment Name | Friendly name for this CUCM |
AXL Username |
AXL Username |
AXL Password |
AXL Password | |
IP Address / Host Name | IP Address of server |
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
- 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.
Figure 64 - Web Portal - CUCM Configure Equipment
...
SNMP
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
Figure 65 - Web Portal – CUCM SNMP V1/V2 Query
Table 9 - CUCM SNMP V1/V2 Field Descriptions
Fields | Setting |
Version | V1, V2 |
SNMP Community String | Community String as administered on the CUCM |
SNMP V3
Figure 66 - Web Portal – CUCM SNMP V3 Query
Table 10 - 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 |
Test Access
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:
Figure 67 - Web Portal – CUCM Test Access
Both SSH API and SNMP should return success. If not, trouble-shoot troubleshoot the configuration.
Info |
---|
The |
...
API test ensures the VSM probe can connect to, and |
...
log in using the account configured. |
Info |
---|
The SNMP test ensures an SNMP query can be run. |
Once testing is successful, click Add.
...