Troubleshooting Fax in Cisco Unity Connection 10.x

See the following sections:

Problems with Fax Delivery to Users

When faxes are not delivered to users, 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 fax delivery to users:

1.blank.gif Determine whether the fax is being sent by enabling the MTA micro trace (all levels). For detailed instructions on enabling the micro trace and viewing the trace logs, see the “Using Cisco Unity Connection Serviceability Traces to Troubleshoot Problems” section.

2.blank.gif If the trace logs show that the fax was sent, investigate how the SMTP server handles faxes by enabling the SMTP micro trace (all levels). For detailed instructions on enabling the micro trace and viewing the trace logs, see the “Using Cisco Unity Connection Serviceability Traces to Troubleshoot Problems” section.

3.blank.gif Confirm that the SMTP server configuration lists the IP address of the Cisco Fax Server and allows a Unity Connection. See the “Confirm that SMTP Server Configuration is Correct” section.

4.blank.gif Check for the fax in the POP3 mailbox by connecting an email client to the POP3 mailbox.

note.gif

Noteblank.gif The email client must be configured to leave messages in the POP3 mailbox.


5.blank.gif In the RightFax Email Gateway, confirm that the POP3 mailbox name and password are correct. See the “Confirming that POP3 Mailbox Name and Password are Correct” section.

6.blank.gif On the network, confirm that the account for the POP3 mailbox is set to never expire the password. An expired password prevents faxes from being routed.

7.blank.gif Confirm that faxes are delivered to Cisco Unity Connection. See the “Confirming Fax is Delivered to Unity Connection” section.

Confirm that SMTP Server Configuration is Correct

To Confirm that SMTP Server Configuration is Correct


Step 1blank.gif In Cisco Unity Connection Administration, expand System Settings and select SMTP Configuration > Server.

Step 2blank.gif On the SMTP Server Configuration page, on the Edit menu, select Search IP Address Access List.

Step 3blank.gif On the Search IP Address Access List page, confirm that the IP address of the Cisco Fax Server appears in the list. If not, select Add New to add the IP address.

Step 4blank.gif Check the Allow Unity Connection check box for the IP address of the Cisco Fax Server, if it is not already checked and select Save.


 

Confirming that POP3 Mailbox Name and Password are Correct

To Confirm that POP3 Mailbox Name and Password are Correct


Step 1blank.gif On the Windows Start menu, select Control Panel > RightFax Email Gateway.

Step 2blank.gif In the Email Configuration window, select the General tab.

Step 3blank.gif In the POP3 Mailbox Name field, confirm that the entry matches the SMTP address for the Cisco Fax Server on the System Settings > Fax Server > Edit Fax Server Configuration page in Cisco Unity Connection Administration.

Step 4blank.gif In the Mailbox Password field, confirm that the password is correct.

Step 5blank.gif In the Email Deliver Direction field, confirm that Both is selected and select OK.


 

Confirming Fax is Delivered to Unity Connection

To Confirm that Fax is Delivered to Unity Connection


Step 1blank.gif On the Windows Start menu, select All Programs > RightFax FaxUtil.

Step 2blank.gif In the RightFax FaxUtil window, in the left pane, select the user who sends the test fax.

Step 3blank.gif On the Fax menu, select New.

Step 4blank.gif In the Fax Information dialog box, select the Main tab.

Step 5blank.gif Under the Name field, select the drop-down arrow and select Email Address.

Step 6blank.gif In the Email Address field, enter the email address of the user who has the fax delivery problem.

Step 7blank.gif Select Save.

Step 8blank.gif In the right pane, note the status of the test fax as it is being sent.

note.gif

Noteblank.gif To refresh the status display of the fax progress, press F5.



 

Problems with Fax Delivery to a Fax Machine

When faxes are not delivered to a fax machine, 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 fax delivery issues in a fax machine:

1.blank.gif Determine the status of the fax that was sent to a fax machine. See the “Determine the Status of a Fax Delivered to a Fax Machine” section.

2.blank.gif Confirm that the fax is in the POP3 mailbox by connecting an email client to the POP3 mailbox.

Note that the email client must be configured to leave messages in the POP3 mailbox.

3.blank.gif In the RightFax Email Gateway, confirm that the POP3 mailbox name and password are correct. See the “Confirm that POP3 Mailbox Name and Password are Correct” section.

4.blank.gif On the network, confirm that the account for the POP3 mailbox is set to never expire the password. An expired password prevents faxes from being routed.

5.blank.gif Confirm that the SMTP server configuration lists the IP address of the Cisco Fax Server and allows a Unity Connection. See the “Confirming that SMTP Server Configuration is Correct” section.

6.blank.gif Troubleshoot how the SMTP server handles faxes by enabling the SMTP micro trace (all levels). For detailed instructions on enabling the micro trace and viewing the trace logs, see the “Using Cisco Unity Connection Serviceability Traces to Troubleshoot Problems” section.

7.blank.gif If the trace logs show that the SMTP message was not sent, investigate how the fax is sent by enabling the MTA micro trace (all levels). For detailed instructions on enabling the micro trace and viewing the trace logs, see the “Using Cisco Unity Connection Serviceability Traces to Troubleshoot Problems” section.

8.blank.gif Confirm that the file extension of the file that the user attempted to fax is included in the list of faxable file types. See the “Confirming that Faxable File Types List is Correct” section.

Determine the Status of a Fax Delivered to a Fax Machine

To Confirm the Status of a Fax Delivered to the Cisco Fax Server


Step 1blank.gif On the Windows Start menu, select All Programs > RightFax FaxUtil.

Step 2blank.gif In the RightFax FaxUtil window, in the left pane, select the user who sent the fax to the fax machine, then select All.

Step 3blank.gif In the right pane, note the status of the fax and any problems that are reported.


 

Confirm that POP3 Mailbox Name and Password are Correct

To Confirm that POP3 Mailbox Name and Password are Correct


Step 1blank.gif On the Windows Start menu, select Control Panel > RightFax Email Gateway.

Step 2blank.gif In the Email Configuration window, select the General tab.

Step 3blank.gif In the POP3 Mailbox Name field, confirm that the entry matches the SMTP address for the Cisco Fax Server on the System Settings > Fax Server > Edit Fax Server Configuration page in Cisco Unity Connection Administration.

Step 4blank.gif In the Mailbox Password field, confirm that the password is correct.

Step 5blank.gif In the Email Deliver Direction field, confirm that Both is selected and select OK.


 

Confirming that SMTP Server Configuration is Correct

To Confirm that SMTP Server Configuration is Correct


Step 1blank.gif In Cisco Unity Connection Administration, expand System Settings and select SMTP Configuration > Server.

Step 2blank.gif On the SMTP Server Configuration page, on the Edit menu, select Search IP Address Access List.

Step 3blank.gif On the Search IP Address Access List page, confirm that the IP address of the Cisco Fax Server appears in the list. If not, select Add New to add the IP address.

Step 4blank.gif Check the Allow Unity Connection check box for the IP address of the Cisco Fax Server, if it is not already checked and select Save.


 

Confirming that Faxable File Types List is Correct

To Confirm that Faxable File Types List is Correct


Step 1blank.gif In Cisco Unity Connection Administration, expand System Settings, then select Advanced > Fax.

Step 2blank.gif On the Fax Configuration page, in the Faxable File Types field, note the file extensions that are listed.

Step 3blank.gif If the file extension of the file that the user attempted to fax is not in the list, enter a comma followed by the file extension and select Save.


 

Problems with Fax Notifications

Confirm that fax notification from Unity Connection is enabled for the user.

To Confirm that Fax Notification is Enabled for the User


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

Step 2blank.gif On the Edit menu, select Notification Devices.

Step 3blank.gif On the Notification Devices page, select the name of the applicable notification device.

Step 4blank.gif On the Edit Notification Device page, under Notification Rule Events, check the Fax Messages check box and select Save.


 

Problems with Fax Receipts

See the following sections, as applicable:

Fax Receipts Not Delivered

To Verify Prefixes for Delivery Receipts and Nondelivery Receipts on the Cisco Fax Server


Step 1blank.gif On the Windows Start menu, select Control Panel > RightFax Enterprise Fax Manager.

Step 2blank.gif In the Email Configuration window, select the General tab.

Step 3blank.gif In the left pane of the RightFax Enterprise Fax Manager window, select the name of the Cisco Fax Server.

Step 4blank.gif In the right pane, under Service Name, scroll down to RightFax eTransport Module.

Step 5blank.gif Right-click RightFax eTransport Module and select Configure Services.

Step 6blank.gif Select the Custom Messages tab.

Step 7blank.gif In the applicable fields, verify the fax failure prefix at the beginning of the text (the default fax failure prefix is [Fax Failure]). We recommend that the fax failure prefix appear at the beginning of the following fields:

    • Imaging Error
    • Bad Form Type
    • Bad Fax Phone Number
    • Too Many Retries
    • Sending Error
    • Incomplete Fax
    • Invalid Billing Code
    • Fax Needs Approval
    • Fax Number Blocked
    • Human Answered Fax
    • Fax Block by Do Not Dial

When the text at the beginning of the field matches the value for the Subject Prefix for Notification of a Failed Fax field on the System Settings > Advanced > Fax page of Cisco Unity Connection Administration, Unity Connection notifies the user of the failed fax.

Step 8blank.gif In the Successful Send field, verify the fax success prefix at the beginning of the text (the default fax success prefix is [Fax Success]).

When the text at the beginning of the field matches the value for the Subject Prefix for Notification of a Successful Fax field on the System Settings > Advanced > Fax page of Connection Administration, Unity Connection notifies the user of the successful fax.

Step 9blank.gif Select OK.


 

To Verify Prefixes for Delivery Receipts and Nondelivery Receipts on Cisco Unity Connection


Step 1blank.gif In Cisco Unity Connection Administration, expand System Settings, then select Advanced > Fax.

Step 2blank.gif On the Fax Configuration page, in the Subject Prefix for Notification of a Successful Fax field, confirm that the setting matches the prefix for the Successful Send field that is described in Step 8 of the To Verify Prefixes for Delivery Receipts and Nondelivery Receipts on the Cisco Fax Server.

Step 3blank.gif In the Subject Prefix for Notification of a Failed Fax field, confirm that the setting matches the prefix for the fields that are described in Step 7 of the To Verify Prefixes for Delivery Receipts and Nondelivery Receipts on the Cisco Fax Server.

Step 4blank.gif Select Save.


 

User Mailbox is Filled with Fax Notifications

To Disable Fax Notifications


Step 1blank.gif In the RightFax Enterprise Fax Manager window, in the right pane, expand Users, right-click the user for whom you want to disable fax notifications, and select Edit.

Step 2blank.gif In the User Edit dialog box, select the Notifications tab.

Step 3blank.gif Under Notification About Received Faxes, uncheck the When Initially Received check box.

Step 4blank.gif Select OK.

Step 5blank.gif Repeat Step 1 through Step 4 for all remaining users for whom you want to disable fax notifications.

Step 6blank.gif Close the RightFax Enterprise Fax Manager window.


 

Problems with Printing Faxes

When you send a fax to a fax machine for printing but portions of the document are not printed, do the following:

Confirming that Faxable File Types List is Correct

To Confirm that Faxable File Types List is Correct


Step 1blank.gif In Cisco Unity Connection Administration, expand System Settings, then select Advanced > Fax.

Step 2blank.gif On the Fax Configuration page, in the Faxable File Types field, note the file extensions that are listed.

Step 3blank.gif If the file extension of the file that the user attempted to fax is not in the list, enter a comma followed by the file extension and select Save.