Release Notes for Cisco Unity Connection ViewMail for Microsoft Outlook Release 11.0(1)

---

Single-inbox users	Users get voice messages in the same Inbox as their email. Voice messages sent from Outlook do not appear in the Sent Items folder. ViewMail for Outlook is not required with the single-inbox feature. Without it, however, users can only play voice messages; they cannot compose, reply to, or forward them. ViewMail for Outlook is required for users to play secure messages in the Exchange mailbox.
IMAP users	Users get voice messages in a separate mail folder in Outlook. New voice messages get identified by a separate voice message icon. ViewMail for Outlook is required for users to play secure messages in the Unity Connection mailbox.

Compatibility Information

• For information on all qualified version combinations of ViewMail for Outlook, Cisco Unity Connection, and the software on user workstations, see Compatibility Matrix for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/compatibility/matrix/cucclientmtx.html. The document also contains the support policy for software on user workstations.
• For a list of all languages available for ViewMail for Outlook, see the “Available Languages for Cisco Unity Connection Components” section of System Requirements for Cisco Unity Connection Release 11.x at http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/11x/requirements/11xcucsysreqs.html .

Determining the ViewMail for Outlook Version

To Determine the ViewMail for Outlook Version in Use from Outlook

 

In Outlook on the user workstation:

 

 

---

---

Additional Languages for ViewMail for Outlook

All locales are released for ViewMail for Outlook 11.0(1) release.

For a list of all languages available for ViewMail for Outlook, see the “Available Languages for Cisco Unity Connection Components” section of System Requirements for Cisco Unity Connection Release 11.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/11x/requirements/11xcucsysreqs.html.

Task List for Installing ViewMail for Outlook 11.0(1) for the First Time

Do the following tasks in the order listed for a new ViewMail for Outlook installation.

1. Confirm that ViewMail requirements and prerequisites have been met. See the “Requirements” section and the “Prerequisites” section.

2. Download ViewMail for Outlook from the Cisco Download Software website. See the “Downloading ViewMail for Outlook 11.0(1)” section.

3. Optional: Customize ViewMail for Outlook setup. See the “Customizing ViewMail for Outlook Setup” section.

4. Optional: Provide users with ViewMail for Outlook files for installation.

5. Install ViewMail for Outlook. Provide users with instructions, if applicable. See the “Installing or Upgrading to ViewMail for Outlook 11.0(1)” section.

6. Link users’ email accounts with the voicemail server:

a. Using the ViewMail for Outlook Initialization wizard: When they restart Outlook following ViewMail installation, the Initialization wizard prompts users for any required information that was not already prepopulated.

b. Using the ViewMail Options or Settings dialog: Enter the required information. Provide users with instructions, if applicable. See the “Installing ViewMail for Outlook 11.0(1) Using Command Line Switches” section.

Task List for Upgrading to ViewMail for Outlook 11.0(1)

---

Note If you are upgrading from a ViewMail for Outlook version earlier than 11.0(1), see the “Task List for Installing ViewMail for Outlook 11.0(1) for the First Time” section instead. The older version is uninstalled automatically, and installing 11.0(1) is considered a new installation.

Do the following tasks in the order listed to upgrade ViewMail for Outlook to a later version.

1. Confirm that ViewMail requirements and prerequisites have been met. See the “Requirements” section and the “Prerequisites” section.

2. Download ViewMail for Outlook from the Cisco Download Software website. See the “Downloading ViewMail for Outlook 11.0(1)” section.

3. Optional: Customize ViewMail for Outlook setup for the upgrade, if applicable. See the “Customizing ViewMail for Outlook Setup” section.

4. Optional: Provide users with ViewMail for Outlook files for the upgrade.

5. Upgrade ViewMail for Outlook. Provide users with instructions, if applicable. See the “Installing or Upgrading to ViewMail for Outlook 11.0(1)” section.

---

Note Existing email account and ViewMail for Outlook settings remain unchanged during an upgrade.

Prerequisites

• Prerequisites for Using ViewMail for Outlook with the Single-Inbox Feature
• Prerequisites for Using ViewMail for Outlook with IMAP
• Creating and Configuring an Account in Outlook to Access Voice Messages (IMAP Users Only)

Prerequisites for Using ViewMail for Outlook with the Single-Inbox Feature

For ViewMail for Outlook users who will access Unity Connection voice messages by using synchronized Unity Connection and Microsoft Exchange mailboxes (single-inbox), confirm that the following prerequisites have been met:

• The single-inbox feature is enabled.

(See the Unified Messaging Guide for Cisco Unity Connection Release 11.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/11x/unified_messaging/guide/11xcucumgx.html.)

• An Exchange email account in Outlook points to each user’s Exchange mailbox.

Prerequisites for Using ViewMail for Outlook with IMAP

For ViewMail for Outlook users who will access Unity Connection voice messages by using IMAP, confirm that the following prerequisites have been met:

• Users’ corporate email addresses are configured as SMTP proxy addresses.

(See the “ Users ” chapter of chapter of the System Administration Guide for Cisco Unity Connection Release 11.x at http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/11x/administration/guide/11xcucsagx.html.)

• Users are associated with a class of service enabled for accessing voice messages by using an IMAP client.

(See the “User Attributes” chapter of the System Administration Guide for Cisco Unity Connection Release 11.x.)

• The Unity Connection server is configured to allow SMTP connections from IMAP clients.

(See the Unified Messaging Guide for Cisco Unity Connection Release 11.x at http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/11x/unified_messaging/guide/11xcucumgx.html.)

• If Transport Layer Security for untrusted IP addresses is configured to be required or optional: The Connection server is configured to provide a secure IMAP connection.

(See the Security Guide for Cisco Unity Connection Release 11.x at http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/connection/11x/security/guide/11xcucsecx.html.)

• An IMAP email account is configured in Outlook for each ViewMail for Outlook user.

(See the “Creating and Configuring an Account in Outlook to Access Voice Messages (IMAP Users Only)” section of these release notes.)

Creating and Configuring an Account in Outlook to Access Voice Messages (IMAP Users Only)

Do the applicable procedure—depending on the Outlook version—for ViewMail for Outlook users who will access Connection voice messages by using IMAP:

• To Create and Configure an Account in Outlook 2010 or 2013 to Access Voice Messages (IMAP Users)
• To Create and Configure an Account in Outlook 2007 to Access Voice Messages (IMAP Users)
• To Create and Configure an Account in Outlook 2003 to Access Voice Messages (IMAP Users)

To Create and Configure an Account in Outlook 2010 or 2013 to Access Voice Messages (IMAP Users)

---

Step 1 Start Outlook.

Step 2 On the File tab, select Info, then Add Account.

Step 3 Confirm that Email Account (the default) is selected, then enter user information:

a. In the Your Name field, enter a display name for the account. This typically is the full name of the user.

b. In the Email Address field, enter the Connection SMTP address of the user.

The address is available in the SMTP Address field on the User Basics page in Connection Administration, and typically uses the following format:

<username>@<SMTP domain name of the Unity Connection server or cluster>

c. In the Password field, enter the user’s Cisco PCA password (also known as the web application password).

d. In the Retype Password field, enter the Cisco PCA password again.

Step 4 Select Next.

Step 5 If you see the “Problem Connecting to Server” message about an unavailable encrypted connection: Select Next to use an unencrypted connection.

Step 6 When the email-account configuration is complete, select Finish.

---

Note If Outlook 2013 is getting crashed when you click on Draft Message/Sent Message/Calendar/Contacts, make sure that the IntResource64.dll library file does not exist in the %temp%\AppData\Local\Temp\ folder. If the file exists in the specified location, delete the file before starting Outlook to resolve this issue.

 

To Create and Configure an Account in Outlook 2007 to Access Voice Messages (IMAP Users)

---

Step 1 Start Outlook.

Step 2 From the Outlook Tools menu, select Account Settings.

Step 3 In the Account Settings dialog, on the Email tab, select New.

Step 4 In the Add New Email Account wizard, select Microsoft Exchange, POP3, IMAP or HTTP as the email service, then select Next.

Step 5 Enter user information:

a. In the Your Name field, enter a display name for the account. This typically is the full name of the user.

b. In the Email Address field, enter the Connection SMTP address of the user.

The address is available in the SMTP Address field on the User Basics page in Connection Administration, and typically uses the following format:

<username>@<SMTP domain name of the Unity Connection server or cluster>

c. In the Password field, enter the user’s Cisco PCA password (also known as the web application password).

d. In the Retype Password field, enter the Cisco PCA password again.

Step 6 Select Next.

Step 7 If you see the Problem Connecting to Server message about an unavailable encrypted connection: Select Next to use an unencrypted connection.

Step 8 When the email-account configuration is complete, select Finish.

 

To Create and Configure an Account in Outlook 2003 to Access Voice Messages (IMAP Users)

---

Step 1 Start Outlook.

Step 2 From the Outlook Tools menu, select Email Accounts.

Step 3 In the Email Accounts wizard, under Email, select Add a New Email Account, then select Next.

Step 4 Under Server Type, select IMAP as the email service, then select Next.

Step 5 On the Internet Email Settings (POP 3) dialog, enter the applicable information in the User, Server, and Logon sections, then select Next.

Step 6 When the email-account configuration is complete, select Finish.

 

Downloading ViewMail for Outlook 11.0(1)

To Download ViewMail for Outlook 11.0(1)

---

Step 1 On a computer with a high-speed Internet connection, go to the Voice and Unified Communications download page at http://www.cisco.com/cisco/software/navigator.html?mdfid=280082558.

---

Note To access the software download page, you must be signed in to Cisco.com as a registered user.

Step 2 In the tree control on the download page, expand Products> Unified Communications> Unified Communications Applications> Messaging> Cisco Unity Connection, and select Cisco ViewMail for Microsoft Outlook Version 11.0.

Step 3 In the Latest Releases folder, select VMO 11.0(1).

Step 4 On the right side of the page, select Download Now, and follow the on-screen prompts to complete the download.

 

Customizing ViewMail for Outlook Setup

The file AdminConfig.xml is available in the ViewMail for Outlook installation folder. Use the file to prepopulate user and voicemail server information when the ViewMail for Outlook installation or upgrade is being pushed out to users.

After entering information in AdminConfig.xml, leave the file in the ViewMail installation folder when you make it available to users.

Installing or Upgrading to ViewMail for Outlook 11.0(1)

By default, ViewMail for Outlook files are installed in the directory C:\Program Files\Cisco Systems\ViewMail for Outlook. You can specify a different directory during the software installation.

Do the procedure in this section to install or upgrade ViewMail for Outlook on user workstations. You can also install ViewMail for multiple users who share a workstation.

To Install or Upgrade to ViewMail for Outlook 11.0(1)

---

Step 1 If Microsoft Outlook is running, exit the application.

Step 2 In the ViewMail folder, double-click the applicable file:

 

Step 3 Follow the on-screen prompts to complete the installation.

Step 4 Restart Outlook.

 

Installing ViewMail for Outlook 11.0(1) Using Command Line Switches

To install ViewMail for Outlook 11.0(1) through command line switches:

---

Step 1 Run the following command on command prompt:

<Path of the VMO setup directory>setup.exe /i /qb /logfile <File Name>

---

Note <File Name> is the name of the log file.

 

Step 2 Restart Outlook.

 

Associating the Applicable Email Account with the Voicemail Server

---

Note If you are upgrading ViewMail for Outlook from 8.5(x) to a later version, skip this task. Existing email account and ViewMail settings remain unchanged during an upgrade.

You must link the applicable IMAP account or Exchange account with the voicemail server. This ensures that messages composed by using ViewMail for Outlook are sent to the voicemail server.

Do the following procedure on each user workstation.

To Associate an Email Account with a Voicemail Server

---

Step 1 In Outlook, open the ViewMail Settings or Options dialog:

 

Step 2 Select Add, then select the account to associate with a voicemail server.

Step 3 Enter the applicable information in each field:

 

Step 4 Select Test Settings to verify the information that was entered.

Step 5 Select OK.

 

Incompatibility with Exchange System Management Tools

ViewMail for Outlook version 11.0(1) does not work correctly when it is installed on a computer that also has Microsoft Exchange System Management Tools installed.

Installing a New Version of Outlook Requires Uninstalling ViewMail First

When installing a new version of Microsoft Outlook on user workstations, you must first uninstall ViewMail for Outlook. After you have installed Outlook, reinstall ViewMail.

Otherwise, ViewMail for Outlook will seem to be installed properly with the new version of Outlook, but it may not work.

Message Sensitivity Displays as Blank for Normal Sensitivity Messages Recorded in ViewMail

Users whose Outlook clients are configured to display the Sensitivity field in the message-list view may notice that messages recorded in ViewMail for Outlook with the Sensitivity set to Normal do not display any text in the Sensitivity field.

Messages recorded by using the Cisco Unity Connection phone interface (as well as email messages composed in Outlook) display “Normal” in the Sensitivity field.

Some Software on User Workstations Can Cause ViewMail to Fail

Some security and VPN software installed on user workstations may cause ViewMail for Outlook to fail. In particular, software that offers personal firewalls is problematic.

Exceptions may need to be added to the problematic software to allow ViewMail to work. Alternatively, you can set up ViewMail so that users can play messages with audio devices on their computers.

---

Note In ViewMail for Outlook 11.0(1) and later, if the user connects or disconnects the audio devices, it is recommended to restart Outlook, so that ViewMail for Outlook displays the status of currently attached recording and playback devices only.

To Compose Voice Messages, Unity Connection Server Must Be Available

In order to compose voice messages by using ViewMail for Outlook with Cisco Unity Connection 8.5 and later, ViewMail must be able to contact the Unity Connection server. If the server is not available, users will see the following message: “The requested action could not be performed because the voicemail server was not available.”

In earlier ViewMail versions, voice messages could be recorded while the Unity Connection server was unavailable and were sent when the server became available again.

ViewMail for Outlook 11.0(1) Limitations Regarding Reply and Forward Cisco Unity Voice Messages

In Unity Connection, users cannot reply to, or forward Cisco Unity voice messages or.wav files by using ViewMail for Outlook version 11.0(1).

ViewMail for Outlook 11.0(1) Limitations Regarding Icon Update when a Voice Message is read or unread

When a voice mail is marked read or unread using ViewMail for Outlook 11.0(1), the state of voice mail Icon is not updated regardless of the Microsoft Outlook version.

ViewMail for Outlook 11.0(1) Limitations Regarding Cisco Unity 5 Message Playback

When playing a Cisco Unity 5 message using ViewMail for Outlook with "VMO Play Attachment" feature, audio progress bar is not updated and time duration is not displayed on the ViewMail audio pane of the VoiceMail.

ViewMail for Outlook 64-Bit Limitation Regarding G.729

ViewMail for Outlook 64 bit version is not supported for G.729 codec.

ViewMail for Outlook Limitation Regarding Secured Voice Message Play with OpenAM SSO

If OpenAM Single Sign-On for Cisco PCA is enabled in ViewMail for Outlook, we recommend not to play the secure messages. If you still play the secure messages after enabling OpenAM Single Sign-On, VMO displays the “Loading Audio” prompt and never plays the audio message.

To play secure messages using ViewMail for Outlook with OpenAM SSO configuration, perform the following steps:

1. In Cisco Unity Connection OS Administration, disable SSO for REST API.

2. Create a rule that puts "/ciscopca/unitymessageserver/ums.do?*" in the "Not Enforced URI" rule section of OpenAM.

---

Note The limitation of secured voice message play with OpenAM Single Sign-On is not applicable for Cisco Unity Connection Release 11.x.

---

Open Caveats—Release 11.0(1)

There is no list of open caveats for this release.

Resolved Caveats—Release 11.0(1)

This section lists the resolved caveats that includes resolved CFDs (Severity 1, 2, 3, 4, and 5) and IFDs (Severity 1, 2, and 3) when ViewMail for Outlook version 11.0(1) was released. Select a link in the Caveat Number column to view the latest information of the caveat in Bug Toolkit. (Caveats are listed in order by severity, then by component, then by caveat number.)

 

---

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

© 2015 Cisco Systems, Inc. All rights reserved.