Guest

Cisco Unity

Import COBRAS to Unity Connection 8.5 from Unity 5.x Configuration Example

Cisco - Import COBRAS to Unity Connection 8.5 from Unity 5.x Configuration Example

Document ID: 113181

Updated: Jan 18, 2012

   Print

Introduction

This document provides a sample configuration for importing Cisco Objected Backup and Restore Application Suite (COBRAS) to Cisco Unity Connection 8.5 from Cisco Unity 5.x.

Prerequisites

Requirements

There are no specific requirements for this document.

Components Used

The information in this document is based on these software and hardware versions:

  • Cisco Unity 5.x

  • Cisco Unity Connection 8.5

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. If your network is live, make sure that you understand the potential impact of any command.

Conventions

Refer to the Cisco Technical Tips Conventions for more information on document conventions.

Configure

COBRAS provides an external application that runs on the administrator’s workstation and provides a tool to migrate user data and messages from earlier version of specific voice-messaging systems to the current Cisco Unity Connection server.

COBRAS captures the entire directory structure when performing a backup. After you export the necessary information using the COBRAS Export Utility, you need to access the COBRAS Import Utility from www.ciscounitytools.com and import the needed data to Cisco Unity Connection.

Complete these steps in order to import COBRAS to Unity Connection 8.5:

  1. Configure a user without a mailbox.

  2. Set the database proxy service shutdown time.

  3. Activate the remote database proxy service.

  4. Enable SMTP connectivity for importing messages.

Configure a User without a Mailbox

Complete these steps in order to configure a user without a mailbox:

  1. Go to the Cisco Unity Connection Administration web interface.

  2. Create a user without a mailbox:

    1. Go to User > New User.

      cobras-cucx-01.gif

    2. Choose User Without Mailbox from the User Type drop-down list.

      cobras-cucx-02.gif

    You can leverage a user with or without a mailbox for off-box data access purposes. However, for security reasons, it is strongly recommended that you create a new user without a mailbox to be used solely for the purpose of remote administration tasks. If you are backing up messages, you must use a user without a mailbox for this purpose; a user with a mailbox may not be allowed to extract messages from other mailboxes, whereas a user without a mailbox should have no problem.

  3. Make sure that the web administration password for the user is configured not to require a change at first login:

    1. Choose the User from the User Page.

    2. Click on Edit > Password Settings.

      cobras-cucx-03.gif

    3. Make sure that the User Must Change at Next Sign-In check box is not checked.

      cobras-cucx-04.gif

  4. If necessary, change the web administration password on the Change Password page.

    Note: Only the web application password comes into play for remote data access.

  5. On the Edit Roles page for the user, add the Remote Administrator and the System Administrator roles to the Assigned Roles list, and click Save. You can assign any or all other roles too, but for the purposes of remote access to the database and making updates to users, these two roles are necessary.

    cobras-cucx-05.gif

Set the Database Proxy Service Shutdown Time

Out of the box, the database proxy service is not running, and, if you try to start the service, it will immediately shut down.

Complete these steps in order to start the service:

  1. Go to System Settings > Advanced > Connection Administration on the Cisco Unity Connection Administration page.

  2. Set the Database Proxy: Service Shutdown Timer value high at 999. By default, this is set to 0.

    cobras-cucx-06.gif

After the number of days configured here, the remote database proxy service will shut down. This is useful if, as an example, you want to do some migration work and do not want to forget to have the service disabled for security reasons.

Activate the Remote Database Proxy Service

If you restart the server, the remote database proxy service will remain shut off. After a system restart, the service that listens to remote database requests is not active and you must turn it on manually.

Complete these steps in order to activate the remote database proxy service:

  1. Go to the Cisco Unity Connection Serviceability web administration page.

    cobras-cucx-07.gif

  2. Go to Tools > Service Management.

    cobras-cucx-08.gif

  3. The Connection Database Proxy item under the Optional Services section is marked as "Deactivated" and stopped. Choose Activate, and it will be activated and started automatically.

    cobras-cucx-09.gif

Once you have started the proxy service, you can connect with any tool that needs off-box database access using user name and web administration password.

Enable SMTP Connectivity for Importing Messages

You will need to enable access to send SMTP mail messages to the system. You must disable any authentication restrictions on the SMTP service in order to do this.

  1. Go to the SMTP Configuration section of the System Settings on the Cisco Unity Connection Administration web page.

  2. On the Server page, check Allow Connections from Untrusted IP Addresses.

  3. Choose Disabled for the Transport Layer Security from Untrusted IP Addresses, and save your changes.

After these steps have been completed, open the COBRAS Import utility to begin the import operation. Select the database file that was exported by browsing to the desired file. The wizard begins by presenting a series of options, where the user can select which subscribers and objects are to be imported to Cisco Unity Connection. After the import operation has been completed, the COBRAS utility can be closed.

Note:  For troubleshooting issues, refer to www.ciscounitytools.com. This website has many useful tools, updates, and training information.

Troubleshoot

This section provides information you can use to troubleshoot your configuration.

Error: Could not attach to DOH for message extraction

When trying to export messages using the COBRAS tool, this error message is received:

Could not attach to DOH for message extraction- be sure you are logged
in as the account associated with the AvCsMgr service before selecting
this option

In order to resolve this issue, make sure that the Exchange store service is running.

Error: SMTP connection to server failed

COBRAS import fails with the SMTP connection to server failed error message and the COBRAS import log shows this error message:

538 Encryption required for requested authenticated mechanism

In order to resolve this issue, complete these steps:

  1. Go to the SMTP Configuration section of the System Settings on the Cisco Unity Connection Administration web page.

  2. On the Server page, check Allow Connections from Untrusted IP Addresses.

  3. Choose Disabled for the Transport Layer Security from Untrusted IP Addresses, and save your changes.

Error: Login to remote Conection server via ODBC failed

COBRAS import fails with this warning message:

Login to remote Conection server via ODBC failed
Error number=2147217843.System error 908.This usually means the server is not 
found or that ODBC Proxy is not enabled or cannot be reached on port 20532. 
Make sure that port is not being blocked,that the database proxy 
service is currently active and running and that the server name can be resolved
properly from this Windows machine.

In order to resolve this issue, complete these steps:

  1. Go to System Settings > Advanced > Connection Administration located on the Cisco Unity Connection Administration page.

  2. In the field next to Database Proxy: Service Shutdown Timer (in days), enter a value between 1 and 999 days.

    Note: A value of 0 (zero) disables the Database Proxy Service.

  3. Click Save.

    cobras-cucx-10.gif

  4. Go to Tools > Service Management on the Cisco Unity Connection Serviceability web administration page.

  5. From the Server drop-down box, choose the Cisco Unity Connection server or the server.Click Go.

  6. In order to activate the Connection Database Proxy service under Optional Services, choose Activate. It will be activated and started automatically.

cobras-cucx-11.gif

Error: csp_AllocateVOiceFile failed to execute in bCanUploadWAVFile

COBRAS import fails with this error message:

(error)csp_AllocateVOiceFile failed to execute in bCanUploadWAVFile.

Unable to upload WAV file to the remote Connection server. Make sure that
you turn off web proxies and ensure that HTTP traffic on port 80 and 443 to
the Connection server is not being blocked by a virus scanner or a firewall.

Solution

If you are using Windows 7, try the import using Windows XP. Also, restart the Connection Database Proxy service in order to resolve the issue.

COBRAS SMTP connect fails

This SMTP connect error message is received while running COBRAS:

cobras-cucx-12.gif

Solution

This issue can occur if antivirus is blocking the traffic to port 25 which is being used by CUC for the SMTP. In order to resolve this issue, disable the antivirus and run the Import utility or open port 25.

Related Information

Updated: Jan 18, 2012
Document ID: 113181