Troubleshooting Message Waiting Indicators (MWIs) in Cisco Unity Connection 10.x

This chapter describes message waiting indicators (MWIs), what causes Cisco Unity Connection to turn MWIs on and off, and methods for troubleshooting problems with MWIs.

See the following sections:

Triggers for Turning MWIs On and Off

An MWI is a lamp, flashing LCD panel, or special dial tone on user phones that lets users know a voice message is waiting. The type of indicator depends on the phone system and the user phones. Phone systems that support message counts may also display the number of messages that the user has.

MWIs are not the same as message notification, which is the feature that notifies a user of new voice messages by calling a phone, pager, or other device, or by sending an email message.

The following events trigger Cisco Unity Connection to turn MWIs on and off:

  • When a message for a user arrives on the Unity Connection message store, Unity Connection notifies the phone system to turn on an MWI on the phone for that user.

Any message that arrives on the Unity Connection message store (for example, voice messages, emails, and faxes) trigger turning MWIs on and off.

  • When the user saves or deletes a read message, Unity Connection notifies the phone system to turn off the MWI on the phone.
  • When a user deletes a new message without listening to it, Unity Connection notifies the phone system to turn off the MWI on the phone.
  • When MWIs are synchronized, Unity Connection queries the message store to determine the status of MWIs on all phones, and resets the applicable MWIs.

However, an MWI remains on under the following conditions:

  • More messages are waiting to be heard. When all new messages are listened to, the MWI is turned off.
  • A new message arrives while the user is listening to the original message. When all new messages are listened to, the MWI is turned off.
  • The user listens on the phone to only part of the message, then either hangs up or skips to the next message before hearing the entire message.
  • The user listens the entire message on the phone. You can perform either of the following to turn off the MWI:

blank.gif Save or Delete the message after listening it.

blank.gif In Cisco Unity Connection Administration, Select Users. On the Search Users page, Select the alias of the user. On the Edit User Basics page of the user, navigate Edit > Playback Message Settings. On the Playback Message Settings page, Select Saved under When Disconnected or User Hangs Up During Message Playback field.

  • In an email application, in the Web Inbox, or in the Messaging Inbox, the user marks a listened-to message as unread.

Messages in an external message store do not trigger Unity Connection to turn MWIs on and off.

MWI Problems

See the following sections for information on troubleshooting problems with MWIs:

MWIs Do Not Turn On or Off

When MWIs do not turn on or off, use the following task list to determine the cause and to resolve the problem. Do the tasks in the order presented until the problem is resolved.

Following are the tasks to troubleshoot when MWIs do not turn on or off:

1.blank.gif Run the Check Telephony Configuration test. See the “Running the Check Telephony Configuration Test” section.

2.blank.gif Confirm that there are voice messaging ports for the phone system integration that are assigned to send MWI requests. To view the settings, in Cisco Unity Connection Administration, select Telephony Integrations > Ports.

note.gif

Noteblank.gif PIMG/TIMG serial integrations do not send MWI requests through voice messaging ports.


3.blank.gif Confirm that the voice messaging ports that are assigned to send MWI requests are enabled. To view the settings, in Cisco Unity Connection Administration, select Telephony Integrations > Ports.

4.blank.gif Confirm that an adequate number of voice messaging ports for the phone system integration are assigned to send MWI requests. Otherwise, the ports may be too busy to dial out immediately to turn MWIs on and off. To view the ports, in Cisco Unity Connection Administration, select Telephony Integrations > Ports.

5.blank.gif Confirm that the port groups for the phone system integration enable MWIs. To view the Enable Message Waiting Indicators check box, in Cisco Unity Connection Administration, select Telephony Integrations > Port Group > Port Group Basics.

6.blank.gif (Cisco Unified CM SCCP integrations only) Confirm that the settings are correct for the MWI On Extension field and the MWI Off Extension field. To view the Cisco Unified CM settings, in Cisco Unified Communications Manager Administration, select Voice Mail > Message Waiting. To view the Unity Connection settings, in Cisco Unity Connection Administration, select Telephony Integrations > Port Group > Port Group Basics.

7.blank.gif (PIMG/TIMG serial integrations only) Confirm that a separate port group exists to send MWI requests to the master PIMG/TIMG unit. To view the port groups, in Connection Administration, select Telephony Integrations > Port Group. For details on the MWI port group, see the applicable Integration Guide for Cisco Unity Connection at http://www.cisco.com/en/US/products/ps6509/products_installation_and_configuration_guides_list.html.

8.blank.gif Confirm that MWIs for the phone system are not forced off. To view the Force All MWIs Off for This Phone System check box, in Cisco Unity Connection Administration, select Telephony Integrations > Phone System > Phone System Basics.

9.blank.gif Confirm that the MWI is enabled for the user. To view the Enabled check box, in Cisco Unity Connection Administration, select Users > Users > Messaging Waiting Indicators.

10.blank.gif Confirm that the correct phone system is assigned to the MWI for the user. To view the Phone System field, in Cisco Unity Connection Administration, select Users > Users > Messaging Waiting Indicators.

11.blank.gif (Cisco Unified CM SCCP integrations only) Confirm that the extensions that turn MWIs on and off are in the same calling search space that contains the phones and voicemail ports. From a phone, dial the extension that turns on the MWI. If you hear the reorder tone, the extension for turning on MWIs is not assigned to the correct calling search space in Cisco Unified CM Administration. If you do not hear the reorder tone, but the MWI is not turned on or off, a route plan may be causing the problem.

To view the calling search space for the MWI extensions, in Cisco Unified CM Administration, select Voice Mail > Message Waiting.

12.blank.gif (Cisco Unified CM SCCP integrations only) Confirm that the dial plan does not overlap with the MWI extensions. MWI extensions must be unique. To view the dial plan, in Cisco Unified CM Administration, select Call Routing > Dial Plan Installer.

13.blank.gif (PIMG/TIMG serial integrations only) Confirm that the RS-232 serial cable is firmly seated in the serial port of the master PIMG/TIMG unit and in the serial port of the phone system.

14.blank.gif Verify whether the Unity Connection server was upgraded, restored using the Disaster Recovery System, or experienced an event that disrupted MWI synchronization. See the “Synchronizing MWIs” section.

15.blank.gif If the preceding tasks did not resolve the MWI problem, enable macro traces for MWIs. For detailed instructions on enabling the applicable traces and viewing the trace logs, see the “Diagnostic Traces in Cisco Unity Connection 10.x” chapter.

Running the Check Telephony Configuration Test

note.gif

Noteblank.gif The Check Telephony Configuration test does not test IPv6 connectivity. (IPv6 is supported in Unity Connection for Cisco Unified Communications Manager integrations.) The test confirms that Unity Connection can communicate with the phone system using IPv4 addressing.


To Run the Check Telephony Configuration Test


Step 1blank.gif In Cisco Unity Connection Administration, in the Related Links list in the upper right corner of any Telephony Integrations page, select Check Telephony Configuration and select Go.

If the test is not successful, the Task Execution Results displays one or more messages with troubleshooting steps. After correcting the problems, run the test again.

Step 2blank.gif In the Task Execution Results window, select Close.


 

Synchronizing MWIs

We recommend resynchronizing MWIs for the system in the following circumstances:

  • After a server is restored using the Disaster Recovery System.
  • After upgrading a system.
  • After a WAN outage in a system that has distributed voice messaging through Cisco Unified Survivable Remote Site Telephony (SRST) routers or Cisco Unified Communications Manager Express routers in SRST mode.

To Synchronize MWIs for a Phone System Integration


Step 1blank.gif In Cisco Unity Connection Administration, expand Telephony Integrations and select Phone System. On the Search Phone Systems page, select the name of the phone system for which you want to synchronize all MWIs.

Step 2blank.gif On the Phone System Basics page, under Message Waiting Indicators, select Run.

note.gif

Noteblank.gif Synchronizing MWIs for the phone system may affect system performance. We recommend that you do this task when phone traffic is light.



 

MWIs Turn On but Do Not Turn Off

Use the troubleshooting information in this section if MWIs turn on but do not turn off. See the following possible causes:

  • For PIMG/TIMG integrations, certain phone systems require that Cisco Unity Connection use port memory to turn off MWIs so that the same port is used for turning off an MWI that was used for turning on the MWI. See the “Confirm that Unity Connection Uses Port Memory (PIMG/TIMG Integrations)” section.
  • For PIMG/TIMG integrations, if the phone system requires port memory, one or more of the ports used to set MWIs were deleted or were reconfigured not to set MWIs. You must have the phone system turn off all MWIs, then have Unity Connection resynchronize all MWIs.

To avoid this problem when deleting or reconfiguring MWI ports not to set MWIs, see the “Deleting or Reconfiguring MWI Ports When Port Memory is Used (PIMG/TIMG Integrations)” section.

Confirm that Unity Connection Uses Port Memory (PIMG/TIMG Integrations)

When MWIs turn on but do not turn off, the cause may be port memory. For Avaya, Rolm, and Siemens Hicom phone system integrations, Cisco Unity Connection must use the same port for turning off an MWI that was used for turning on the MWI. When Unity Connection is integrated with one of these phone systems and uses a different port for turning off an MWI, the MWI request for turning off the MWI fails.

note.gif

Noteblank.gif This problem does not apply to PIMG/TIMG serial integrations.


To Confirm Unity Connection Uses Port Memory (PIMG/TIMG Integrations)


Step 1blank.gif In Cisco Unity Connection Administration, expand Telephony Integrations and select Phone System.

Step 2blank.gif On the Search Phone Systems page, select the name of the phone system.

Step 3blank.gif On the Phone System Basics page, under Message Waiting Indicators, confirm that the Use Same Port for Enabling and Disabling MWIs check box is checked and select Save.


 

Deleting or Reconfiguring MWI Ports When Port Memory is Used (PIMG/TIMG Integrations)

If Unity Connection must use the same port for turning off an MWI that was used for turning on the MWI, and you want to delete an MWI port or reconfigure an MWI port not to set MWIs, do the applicable procedure.

To Delete MWI Ports When Port Memory is Used (PIMG/TIMG Integrations)


Step 1blank.gif In Cisco Unity Connection Administration, expand Telephony Integrations and select Phone System. On the Search Phone Systems page, select the name of the phone system.

Step 2blank.gif On the Phone System Basics page, under Message Waiting Indicators, check the Force All MWIs Off for This Phone System check box and select Save. All MWIs for the phone system are turned off.

Step 3blank.gif In the left pane, select Port.

Step 4blank.gif On the Search Ports page, check the check boxes of the MWI ports that you want to delete and select Delete Selected.

Step 5blank.gif In the left pane, select Phone System. On the Search Phone Systems page, select the name of the phone system.

Step 6blank.gif On the Phone System Basics page, under Message Waiting Indicators, uncheck the Force All MWIs Off for This Phone System check box and select Save.

Step 7blank.gif To the right of Synchronize All MWIs on This Phone System, select Run. All MWIs for the phone system are synchronized.


 

To Reconfigure MWI Ports When Port Memory is Used (PIMG/TIMG Integrations)


Step 1blank.gif In Cisco Unity Connection Administration, expand Telephony Integrations and select Phone System. On the Search Phone Systems page, select the name of the phone system.

Step 2blank.gif On the Phone System Basics page, under Message Waiting Indicators, check the Force All MWIs Off for This Phone System check box and select Save. All MWIs for the phone system are turned off.

Step 3blank.gif In the left pane, select Port. On the Search Ports page, select the display name of the first MWI port that you want to reconfigure not to set MWIs.

Step 4blank.gif On the Port Basics page, under Port Behavior, enter the applicable settings and select Save.

Step 5blank.gif If there are more MWI ports that you want to reconfigure not to set MWIs, select Next. Otherwise, skip to Step 7blank.gif.

Step 6blank.gif Repeat Step 4 and Step 5 for all remaining MWI ports that you want to configure not to set MWIs.

Step 7blank.gif In the left pane, select Phone System.

Step 8blank.gif On the Search Phone Systems page, select the name of the phone system.

Step 9blank.gif On the Phone System Basics page, under Message Waiting Indicators, uncheck the Force All MWIs Off for This Phone System check box and select Save.

Step 10blank.gif To the right of Synchronize All MWIs on This Phone System, select Run. All MWIs for the phone system are synchronized.


 

Delay for MWIs to Turn On or Off

Use the troubleshooting information in this section if there is a delay for MWIs to turn on or off. See the following possible causes:

  • If MWIs are being synchronized for a phone system integration, this may result in delayed MWIs for messages. This is due to the additional MWI requests that are being processed.
  • The number of ports assigned to handle MWI requests is insufficient. To evaluate the current MWI port activity, see the “Determining the MWI Port Activity” section.

For systems that handle a large volume of calls, you may need to install additional ports.

Determining the MWI Port Activity

To Determine the MWI Port Activity


Step 1blank.gif In Cisco Unity Connection Serviceability, on the Tools menu, select Reports.

Step 2blank.gif On the Serviceability Reports page, select Port Activity Report.

Step 3blank.gif On the Port Activity Report page, select the applicable options for the report.

Step 4blank.gif Select Generate Report.


 

Configuring the MWI On and Off Extensions for Port Groups (SCCP Integrations Only)

For Cisco Unified CM SCCP integrations, the phone system integration may have two or more port groups, one of which might be missing the MWI on and off extension settings.

To Configure the MWI On and Off Extensions for Port Groups (SCCP Integrations Only)


Step 1blank.gif In Cisco Unity Connection Administration, expand Telephony Integrations, then select Port Group. On the Search Port Groups page, select the name of the first port group for the SCCP integration.

Step 2blank.gif On the Port Group Basics page, under Message Waiting Indicator Settings, in the MWI On Extension field, confirm that the extension for turning on MWIs is entered. If the field is blank, enter the MWI On extension.

Step 3blank.gif In the MWI Off Extension field, confirm that the extension for turning off MWIs is entered. If the field is blank, enter the MWI Off extension and select Save.

Step 4blank.gif Select Next.

Step 5blank.gif Repeat Step 2 through Step 3 for the remaining port groups in the SCCP integration.


 

No Message Count Sent on Phone When MWI is On

For Cisco Unified CM integrations, Unity Connection typically provides a message count when the user signs in by phone. If the message count is not given, message counts have not been enabled for new messages or for the type of new message that is in the user voice mailbox. For example, if message counts are enabled only for voice messages, no message count is given when a new email or fax message arrives, even if the MWI is on.

To Enable Message Counts for the Applicable New Messages


Step 1blank.gif In Cisco Unity Connection Administration, expand Users and select Users. On the Search Users page, select the alias of the applicable user.

Step 2blank.gif On the Edit User Basics page, on the Edit menu, select Playback Message Settings.

Step 3blank.gif On the Playback Message Settings page, under For New Messages, Play, check the applicable check boxes:

    • Message Count Totals —Unity Connection announces the total number of messages that are marked new, including voice, email, and fax messages.
    • Voice Message Counts —Unity Connection announces the total number of voice messages that are marked new.
    • Email Message Counts —Unity Connection announces the total number of email messages that are marked new.
    • Fax Message Counts —Unity Connection announces the total number of fax messages that are marked new.
    • Receipt Message Counts —Unity Connection announces the total number of receipts that are marked new.

Step 4blank.gif Select Save.


 

Incorrect Message Count and False MWI Notification Sent on Phone

If a user gets MWI on and there is no new voice messages in the mailbox of the user. The user may get this issue in the following scenarios:

Scenario 1:

Users may have same MWI Extension and different primary extension in a Phone System

If two or more users have different primary extension and same MWI extension within a Phone System, any of the user will get false MWI notification and incorrect message count on the phone. For example, a user A has primary extension and MWI extension as 1001 and another user B has primary extension 1002 and MWI extension as 1001. If user B gets a new voice message, the MWI notification turns on for extension 1001, which is the primary extension of the user A. Hence user A also gets MWI notification but there is no new message in his mailbox.

To stop the false MWI notification on the phone, do the following:


Step 1blank.gif Execute the below command to identify the users having same MWI extension.

run cuc dbquery unitydirdb select u.alias, n.mwiextension from tbl_notificationmwi n

inner join vw_user u on n.subscriberobjectid=u.objectid where n.mwiextension='<Extension on which user get false MWI notification>'

Example: If user gets false MWI notification on extension 1001, the command will be

run cuc dbquery unitydirdb select u.alias, n.mwiextension from tbl_notificationmwi n inner join vw_user u on n.subscriberobjectid=u.objectid where n.mwiextension= 1001

Step 2blank.gif On the Search Users page of Cisco Unity Connection Administrator, check the primary extension of the users that have same MWI extension.

Step 3blank.gif The configuration is incorrect for the user, which have different primary and MWI extension. This causes the false MWI notification on the phone.

Step 4blank.gif To change the MWI extension of the user, go to Edit User Basics page of that user and navigate Edit > Message Waiting Indicators. In Extension field of Edit Message Waiting Indicators page, update the correct extension for MWI notification.


 

Scenario 2:

User may exist in different partition having same primary extension

If two or more users have same primary extension in different partition, one of the user will get the false MWI notification on the phone. For example, a user A has primary as well as MWI extension as 1001 in partition A and other user B also has same extension 1001 as primary and MWI extension in partition B. If user B gets a new voice message, the MWI notification turns on for extension 1001, which is also the MWI extension of user A. Hence user A gets false MWI notification on the phone.

To stop the false MWI notification in different partition, do the following:


Step 1blank.gif Execute the below command to get the list of extension numbers and number of users corresponding to each extension (dtmfaccessid)

run cuc dbquery unitydirdb select first 10 dtmfaccessid,count(dtmfaccessid) from vw_user

group by dtmfaccessid order by count(dtmfaccessid) desc

Step 2blank.gif Execute the below command to get the alias of the users having same extension (dtmfaccessid)

run cuc dbquery unitydirdb select first 10 dtmfaccessid,count(dtmfaccessid),alias from vw_user group by dtmfaccessid,alias order by count(dtmfaccessid)

Step 3blank.gif Check the Phone System associated with the users having same extension on Edit User Basics page of

the users.

Step 4blank.gif If the users have same Phone System then select the different Phone System for each user through Edit User Basics page of Cisco Unity Connection Administrator.