| Distribution list names on SRSV-CUE can only contain the characters a-z, A-Z, 0-9, hyphen, underscore, dot, and plus. Make sure distribution list names do not contain any characters not in this list and are limited to 64 characters.

+

| Distribution list names on SRSV-CUE can only contain the characters a-z, A-Z, 0-9, hyphen, underscore, dot, and plus as defined by the regular expression "[-a-zA-Z0-9._+]*". Make sure distribution list names do not contain any characters not in this list and are limited to 64 characters.

|-

|-

| Invalid subscriber/user alias

| Invalid subscriber/user alias

-

| SRSV-CUE limits user aliases to start with a letter (a-z, A-Z); must be followed by one or more letters (a-z, A-Z), numbers (0-9), hyphen (-), underscore (_), dot (.); and ended with a letter (a-z, A-Z) or number (0-9). Make sure user names are restricted to the pattern described and have at least 2 characters no more than 31 characters.

+

| SRSV-CUE limits user aliases to start with a letter (a-z, A-Z); must be followed by one or more letters (a-z, A-Z), numbers (0-9), hyphen (-), underscore (_), dot (.); and ended with a letter (a-z, A-Z) or number (0-9) as defined by the regular expression "[a-zA-Z][-a-zA-Z0-9_\.]*[a-zA-Z0-9]". Make sure user names are restricted to the pattern described and have at least 2 characters no more than 31 characters.

General SRSV Troubleshooting

Using Traces for Troubleshooting

Use the trace exec mode CLI to turn on the desired traces. Configuring trace srsx srsv-engine all on SRSV-UMG is a good place to start.

Issue the command show trace buffer tail on the SRSV-UMG CLI in exec mode. The CLI will stop taking input and output trace messages as they are generated.

Issue Ctrl-C to stop the trace and resume the SRSV-UMG CLI.

Check the alerts displayed for failures on SRSV-UMG using show srsx alerts on CLI or the dashboard on the GUI.

Error Retrieving Voicemail Common Configuration

Check the network connectivity test from SRSV-UMG.

Check if the REST credentials set for the CUC server on SRSV-UMG match the CUC server Admin login credentials.

Error: Hostname not found in DNS

If you see “Hostname not found in DNS” error while adding devices, make sure that these devices are configured in DNS server in both reverse and forward lookup zones.

After creating these zones, if you still hit hostname not found errors, give clear ip dns cache in the CLI on SRSV-UMG and retry adding devices.

Unable to Connect to SRSV: Socket Timeout

Check the network connectivity test from the SRSV-UMG GUI for success for that branch voicemail server.

if the SRSV-CUE is behind a NAT also check the following

Check if the SRSV-CUE is registered with the correct PAT port number in the branch voicemail server page from the SRSV-UMG GUI.

Check the NAT/PAT translations setup on the NAT router.

Check the TLS security setting on the System > SRSV settings page in the SRSV-UMG GUI.

Language Not Installed

Problem: Language <language> is not installed.

Explanation: Not all Cisco Unity Connection configuration settings apply to the SRSV-CUE device.

Recommended Action 1: Check to see if the system default language on Cisco Unity Connection is installed on the SRSV-CUE device.

Recommended Action 2: Check to see if the subscriber’s default language is installed on the SRSV-CUE device.

Mailbox Count Reached Licensed Mailbox Count

Problem: Mailbox count reached or licensed mailbox count reached.

Solution: Check to see if there are enough mailbox licenses for subscribers. Use the show license CLI command on the SRSV-CUE to see how many mailboxes are licensed. Order and install more mailbox licenses if all installed licenses are active. If licenses are not active use license activate srsv mailboxes <number> on the SRSV-CUE CLI to enable the mailbox licenses.

Error Updating REST Passwords

Re-register the SRSV-CUE to make the passwords in sync with SRSV-UMG. In SRSV-CUE to register, use the CLI messaging-gateway srsx register <umg-ip-addr> user <name> password <passwd> command.

Security Certificate Troubleshooting

Checking that the Certificates are Copied Correctly

Check if the crypto certificates of CUC and CUCM are copied onto SRSV-UMG. Use the following CLI command to copy the certificates:

crypto key import trustcacert label CUC80 url ftp:

SSL/TLS Handshake Fails when Getting SRST References

Check if the services on CUCM are up and running.

Check that you can ping CUCM from SRSV-UMG.

Run a network connectivity test from the SRSV-UMG GUI.

Ensure that the CUCM certificate is copied onto SRSV-UMG.

SRST References Failed

Check if the CUCM AXL credentials on SRSV-UMG are configured correctly.

Check that the CUCM services are up and SRSV-UMG can reach CUCM.

Run a network connectivity test from the SRSV-UMG GUI.

Ensure that the AXL service is up on CUCM.

Ensure that the CUCM certificate is set up on SRSV-UMG.

Use the sh trace buffer tail CLI command.

HTTPS Hostname Mismatch with X.509 Certificate

Check if the certificate from CUCM has the CN as the fully qualified domain name. For example, CN=cucm80.conn.cisco.com. Can be checked from SRSV-UMG using the CLI command show crypto key all.

If not, then add the DNS server name and domain name to CUCM. Check Show > Network from the CUCM OS administration. Regenerate the certificate on CUCM from Security > Certificate Management and do the CLI command generate new.

Reload CUCM and check that the new tomcat certificate has the full CN name.

Check if the validity time on certificate is not later than the time on SRSV-UMG and then copy the certificate to UMG.

Certificate Installation Fails

If certificate installation fails with “Failed due to importing certificate is not yet valid”, check the validity of the certificate and the clock on SRSV-UMG/SRSV-CUE.

Provisioning Errors

Problem: Provisioning fails because the system has reached the maximum mailbox size.

Solution: Reduce the mailbox size by updating the Mailbox Size parameter on the Site Template Profile page.

Problem: The set time for scheduled provisioning was missed because the system was down for maintenance.

Solution 1: Wait until the next provisioning time.

Solution 2: Perform a manual provision.

Problem: Provisioning fails for a site with the alert "SRSV provisioning failed for site SITE_NAME for reason Not all configuration could be successfully applied".

Solution: Some configuration item from the central voicemail system failed to be provisioned for that site. To determine the cause use the following technique.

Enable the traces using either the GUI or CLI. The CLI trace commands shown below can be enabled on the GUI from the page "Troubleshoot -> traces".

trace srsx call-agent-client all

trace srsx vm-server-client all

trace srsx srsv-engine all

Run a provisioning cycle.

Collect the trace output using the GUI or CLI. One the CLI you can use "show trace buffer tail" and on the GUI you can go to "Troubleshoot -> View -> Trace Buffer".

Look for 4xx or 5xx failures in the traces. When you find the failure the cause will be found in the response message contents. An example for a problem with a display list name is shown below (The XML has been reformatted here for readability).

In this example the distribution list name being provisioned called "ted & bill list" has invalid characters in it. The error response is indicating that only character (A-Z and a-z), numbers (0-9), hyphen (-), underscore (_), dot (.), and plus (+) are allowed. Taking into account HTML escaping, the problem distribution list name uses two invalid characters: space ( ) and ampersand (&). This error can be corrected by renaming the distribution list as "ted_and_bill_list".

The table below shows most of the commonly found problems that can lead to SRSV provisioning problems.

Common Provisioning errors

Problem

Solution

Invalid Distribution list name

Distribution list names on SRSV-CUE can only contain the characters a-z, A-Z, 0-9, hyphen, underscore, dot, and plus as defined by the regular expression "[-a-zA-Z0-9._+]*". Make sure distribution list names do not contain any characters not in this list and are limited to 64 characters.

Invalid subscriber/user alias

SRSV-CUE limits user aliases to start with a letter (a-z, A-Z); must be followed by one or more letters (a-z, A-Z), numbers (0-9), hyphen (-), underscore (_), dot (.); and ended with a letter (a-z, A-Z) or number (0-9) as defined by the regular expression "[a-zA-Z][-a-zA-Z0-9_\.]*[a-zA-Z0-9]". Make sure user names are restricted to the pattern described and have at least 2 characters no more than 31 characters.

Invalid spoken name

Recorded spoken names on SRSV-CUE must be recorded in G711 codec and be 10 seconds or less in length. If the spoken names learned from the central voicemail server do not meet these requirements they will not be provisioned.

Backup and Restore Troubleshooting

Problem: The backup and/or restore process failed.

Solution: Ensure that you correctly configured the backup server.

SRSV-CUE Registration Troubleshooting

Problem: SRSV-CUE device registration failed.

Solution: Ensure that the user who is doing the registering has the srsx privilege.

Problem: SRSV-CUE registration reports "HTTP Failure: Bad Request" such as shown in the following example.

Solution: The most common cause for this failure is missing DNS configuration. To determine the cause of the failure you are seeing enable "srsv configuration" tracing, run the registration, then dump the trace buffer. An example is shown below (NOTE: XML in traces below has been reformatted from console output to make it more readable).

In this instance the UMG is rejecting registration because the SRSV-CUE at the address 192.168.28.133 is not in DNS (see the Message content in the 400 error response above -- "SRSV-CUE 192.168.28.133 has not been configured in DNS"). To correct this problem add the reverse lookup for 192.168.28.133 to it's fully qualified domain name in DNS. Once in DNS you can use the host or nslookup command on a linux/unix or Windows system respectively to ensure the entry is now in DNS as shown below.

Also ensure the forward DNS lookup is configured for the SRSV-CUE then reset the DNS cache on the UMG (NOT THE SRSV-CUE) with the command shown below in CLI exec mode.

SRSV-UMG# clear ip dns cache

Try registering the SRSV-CUE again and this time it should work.

Mailbox Management

Problem: A subscriber who was just created in Cisco Unity Connection and was provisioned on Cisco Unified SRSV does not know their PIN.

Reason: The subscriber must set up their voicemail preferences on Cisco Unity Connection before they can log in to Cisco Unified SRSV-CUE devices. In rare cases the subscriber may have setup their mailbox but the SRSV system may not have been able to provision the new pin to the subscribers SRSV mailbox before the SRSV-CUE became active.

Solution: A temporary pin can be created on the SRSV-CUE with the CLI user <userid> generate pin. Give the pin number generated to the user to access their voicemail while SRSV-CUE is active. The subscriber will still need to setup their mailbox when CUC service is restored.

Message Waiting Indicator (MWI) Issues

Problem: The MWI feature does not work in SRSV mode for unsolicited.

Solution: Ensure that the MWI feature is enabled for the site template. Then ensure that the correct site template is applied to the site.

Problem: The MWI feature does not work in SRSV mode for sub-notify.

Solution 1: Check the configuration on IOS.

Solution 2:Ensure that the MWI feature is enabled for the site template. Then ensure that the correct site template is applied to the site.

Solution 3:To see if the MWI feature works, enter the CLI command mwi refresh all on the SRSV-CUE device.

PINless Login

Problem: The system prompts subscribers for a PIN when dialing in to their voicemail using the TUI.

Solution 1: Ensure that the PINless login feature has been configured for the subscriber on Cisco Unity Connection by using the following CLI command: show voicemail detail mailbox user_name.

Solution 2: Ensure that the provisioning was successful.

Solution 3: Ensure that you have configured the PINless settings for the subscriber.

Problem: The subscriber cannot log in from any phone without a PIN.

Solution: Manually configure PINless login so that subscribers can log in without a PIN from any phone.

Live Record Issues

Problem: The live record feature does not work.

Solution 1: On the SRSV-UMG GUI, ensure that the live record feature is enabled for the site template. Then ensure that the correct site template is applied to the site. Ensure that provisioning has been enabled for the site and was successful.

Solution 2: Ensure that the live record pilot number is correctly configured for the site template.

Solution 3: On Cisco Unified Communications Manager Express, ensure that a dummy ephone-dn is configured as the live record pilot number and has “call forward all” to the Cisco Unified SRSV-CUE devices voicemail number.

Solution 4: Ensure that the live record feature is performed from the subscriber’s extension.

Problem: The live record beep does not get played in the middle of a live record call.

Solution: Ensure that the live record feature is enabled for the site template on the SRSV-UMG GUI.

Live Reply Issues

Problem: The live reply feature is not enabled on Cisco Unity Express after provisioning.

Solution: On the SRSV-UMG, ensure that the live reply feature is enabled for the site template. Then ensure that the correct site template is applied to the site.

Problem: Subscribers are unable to live reply to a message using the TUI and hear the message “Invalid selection. Try again.”

Solution: Ensure that you are not using an invalid message type for the live reply feature. Live reply is not supported for broadcast and expired messages, non-delivery receipt delayed delivery receipt messages, and messages from local GDM (GTP Director Module).

Deleted Messages

Problem: Deleted messages on Cisco Unity Express appear as new messages in Cisco Unity Connection after being uploaded.

Possible Cause: In Cisco Unity Connection Release 7.1.3, the system uploads deleted voicemails as new. The subscriber must manually log in to his voicemail on Cisco Unity Connection and delete the message again.

In Cisco Unity Connection Release 8.0, the system uploads deleted voicemails as deleted.

Licensing Troubleshooting

Mailbox Licenses Not Installed

Problem: Mailbox licenses need to be installed.

Recommended Actions:

View the error messages in the UMG trace buffer or log file (syslog).

Verify license status on the SRSV-CUE by issuing the CLI command show license status application.

There are two options to enable mailbox creation:

Install a permanent license on the SRSV-CUE and perform a reload.

Activate the evaluation (trial period) license and reload.

After reloading, check the license status and show the licenses in-use. If the license state shows "License State: Active, Not in Use", then activate the license with the CLI command license activate srsv mailboxes.

All Mailboxes Not Provisioned to SRSV-CUE

Note: Mailbox provisioning will take place in alphabetic order until the number of mailboxes licensed is exceeded.

View the error message in the UMG trace buffer.

Install additional mailbox licenses in the SRSV-CUE equal to or greater than the number of mailboxes to be provisioned to the site.

Users Cannot Access SRSV-CUE Mailbox

Subscribers will encounter a busy tone when attempting to access the SRSV-CUE mailbox if there are no port licenses installed or if there are more subscribers trying to access their mailbox simultaneously than there are port licenses installed.

Recommended Actions:

View the error messages in the SRSV-CUE messages.log (syslog).

Verify license status on the SRSV-CUE by issuing the CLI command show license status application

There are two options to enable port creation:

Install a permanent license on the SRSV-CUE and perform a reload.

Activate the evaluation (trial period) license and reload.

After reloading, check the license status and show the licenses in-use. If the license state shows "License State: Active, Not in Use", then activate the license with the CLI command license activate srsv ports.

Cannot Register SRSV-CUE

Problem: Not enough SRSV node licenses are available in the SRSV-UMG.

Possible Symptoms: The branch voicemail server will not be assigned to a site and can be viewed through the "Unassigned Branch Voicemail Servers" page on the GUI. You may see error messages in the Alert History page on the GUI or in the log file in the SRSV-UMG GUI.

Recommended Action: Install port licenses.

Voicemail Upload Troubleshooting

Note: The SRSV Activity History Report in the GUI shows how many undeliverable voicemails there are in the system.

Voicemail Upload Fails Due to Connectivity Issues

Note: Use the show voicemail mailbox CLI command to check if a voicemail message was not uploaded from the mailbox of a Cisco Unified SRSV-CUE device.

Problem: Voicemail upload fails due to connectivity issues.

Possible Cause 1: Make sure that the Cisco Unity Connection can be reached from SRSV-UMG and that the SRSV-UMG can be reached from the Cisco Unified SRSV-CUE device.

Recommended Action 1: Run network connectivity tests.

Possible Cause 2: The SRSV-UMG system does not have the correct Cisco Unity Connection credentials configured.

Recommended Action 2: Configure the correct credentials.

Possible Cause 3: You are not using the correct REST password.

Recommended Action 3: Use the correct REST password.

Possible Cause 4: The security certificates are not current or have not been installed.

Recommended Action 4: Check that the security certificates are correctly installed by using the show crypto key all CLI command.

Voicemail Uploading Problems

Possible Cause 1: The secondary SRSV-UMG system does not have the correct Cisco Unity Connection credentials configured.

Recommended Action 1: Configure the correct credentials.

Possible Cause 2: You are not using the correct SRSV-UMG REST password. The REST passwords must be the same for both the primary and the secondary SRSV-UMG systems.

Recommended Action 2: Use the correct REST password.

Possible Cause 3: The security certificates are not current.

Recommended Action 3: Check that the security certificates are correctly installed by using the show crypto key all CLI command.

Problem: The sender’s mailbox in Cisco Unity Connection has a non-delivery receipt (NDR) message for a message that was not delivered to a VPIM contact. Or you see an error message in the trace that says “No user or contact found.”

Solution 1: Ensure that the VPIM contact was properly created in the Cisco Unity Connection contact list.

Solution 2: Ensure that you properly addressed the VPIM contact.

Solution 3: Ensure that you dial the numbers in the same way that you dial on Cisco Unity Connection to reach a VPIM contact.

Problem: Voicemails uploaded through HTTPS fail.

Solution: Ensure that the certificate generated from SRSV-UMG is installed on the branch voicemail server and vice versa (if HTTPS is enabled on both).

Distribution List Issues

Problem: Distribution list names are not provisioned on a Cisco Unified SRSV-CUE device.

Solution: Turn on traces on Cisco Unified SRSV-UMG by running the show trace buffer tail CLI command. Then use the trace srsx srsv-engine all CLI command to check which distribution lists were provisioned on the system.