Upgrade Guide for Cisco Unity Connection Release 8.x
Migrating from Cisco Unity 4.x or Later to Cisco Unity Connection 8.x by Using a Flash Cutover
Downloads: This chapterpdf (PDF - 188.0KB) | Feedback

Table of Contents

Migrating from Cisco Unity 4.0(3) or Later to Cisco Unity Connection 8.x by Using a Flash Cutover

Overview of a Flash Cutover from Cisco Unity to Connection 8.x

About the Tools Used for Migrating from Cisco Unity 4.0(3) or Later to Connection 8.x by Using a Flash Cutover

How Migrated Messages Can Exceed Available Disk Space on the Connection8.x Server

About the Behavior of Mailbox Synchronization If You Migrate Messages (Connection 8.5 and Later Only)

Removing Cisco Unity Data from Active Directory

Enabling FIPS Mode in Connection 8.6

Task List for Migrating from Cisco Unity4.0(3) or Later to Connection8.x by Using a Flash Cutover

Installing a Memory Upgrade or Replacing All Hard Disks to Support Connection 8.x (Selected Servers Only)

Preparing to Create User Accounts by Using Multiple Connection 8.x Templates

Importing User Data and Messages into Connection 8.x by Using COBRAS

Importing User Data and Messages into Connection 8.x by Using the Cisco Unity to Connection Migration Export Tool

Overview of a Flash Cutover from Cisco Unity to Connection 8.x

Added November 16, 2010

See the following sections:

About the Tools Used for Migrating from Cisco Unity 4.0(3) or Later to Connection 8.x by Using a Flash Cutover

To migrate user data and, optionally, voice messages from a Cisco Unity 4.0(3) or later system to Connection 8.x, you must export the data and messages from the Cisco Unity system by using either COBRAS (Cisco Objected Backup and Restore Application Suite) or the Cisco Unity 4.x to Connection 2.x Migration Export Tool.

COBRAS

COBRAS exports more data than the Cisco Unity to Connection Migration Export tool. In addition, COBRAS does not require a server running a secure shell (SSH) server application, as the Cisco Unity to Connection Migration Export Tool does.

COBRAS and COBRAS help are available at http://www.ciscounitytools.com/Applications/General/COBRAS/COBRAS.html .

Cisco Unity to Connection Migration Export Tool

The main use for the Cisco Unity to Connection Migration Export Tool is as a backup migration method in case you encounter problems with COBRAS. However, it requires a server running a secure shell (SSH) server application to import Cisco Unity 4.0(5) and later data and messages. Configuring an SSH server application can be a complicated and time-consuming process.

The Migration Export tool and Help for the tool are available at http://www.ciscounitytools.com/Applications/CxN/UnityToConnectionMigrationExport/UnityToConnectionMigrationExport.html .

How Migrated Messages Can Exceed Available Disk Space on the Connection 8.x Server

We discourage migrating messages from Cisco Unity to Connection because you can easily fill the hard disk on the Connection server with messages migrated from Cisco Unity. Like Exchange, Connection supports single-instance messaging, meaning that when a message is sent to a distribution list, only one copy is stored. However, COBRAS cannot retain single-instance messaging for a migration, so for every message sent to a distribution list and migrated to Connection, the Connection database contains one copy of the message for each recipient. For example, if you send a Cisco Unity voice message to a distribution list that has 10 members and then migrate that message to Connection, the Connection database will contain 10 copies of the message.

To complicate matters further, there is no way to estimate the total size of all voice messages when messages to distribution lists are expanded from single-instance messaging. As a result, you can easily fill the hard disk on the Connection server with migrated messages.

Instead of migrating messages, we recommend that you leave the Cisco Unity servers running for a few weeks so users can continue to access messages that were left before the migration.

COBRAS never migrates secure messages, faxes, or receipts.

About the Behavior of Mailbox Synchronization If You Migrate Messages (Connection 8.5 and Later Only)

As noted in the “How Migrated Messages Can Exceed Available Disk Space on the Connection 8.x Server” section, we discourage migrating messages. However, if you must migrate messages from Cisco Unity to Connection 8.5 or later, and if you configure Connection and Exchange mailbox synchronization (single inbox), note the following:

  • Migrated messages will appear in the Connection mailbox and in the Exchange mailbox for each user.
  • COBRAS retains the read/unread status of the migrated messages. If a user played a message in Cisco Unity before the message was migrated, the message will be read both in Connection and in the Exchange mailbox.
  • If you migrate messages for the same Cisco Unity subscriber more than once, the corresponding Connection user will have one more copy of each migrated message in Connection and in Exchange for each additional migration attempt.

If the Cisco Unity server is configured as unified messaging, we further discourage migrating messages because of the following behaviors.

  • Two copies of migrated messages will appear in the Exchange mailbox for each user: the original message and the migrated message that is synchronized into the Exchange mailbox when single inbox is configured.
  • If a user uses Outlook to play the original message in Exchange (the copy that Cisco Unity put into Exchange when the message was received), the message will remain unread in Connection, and the message waiting indicator will remain on. This only happens with migrated messages. Playing the migrated message (the copy that was synchronized into the Exchange mailbox by the single inbox feature) or playing messages that are received after the migration will turn off the message waiting indicator on the new extension as appropriate.

In only one configuration must you migrate messages: you configured secure messaging for Cisco Unity subscribers, and you want the corresponding Connection users to be able to use Cisco Unity Connection ViewMail for Microsoft Outlook to play messages from the Cisco Unity server after the migration. In this configuration, you must also upgrade to Cisco Unity Connection ViewMail for Microsoft Outlook version 8.5 because Cisco Unity ViewMail version 8.0 cannot access secure messages in Connection, and Cisco Unity Connection ViewMail for Microsoft Outlook version 8.5 cannot access secure messages in Cisco Unity.

Removing Cisco Unity Data from Active Directory

Depending on the Cisco Unity configuration, after the migration is complete, you may want to remove Cisco Unity–specific attributes from Active Directory accounts or delete the Active Directory accounts by using the Uninstall Unity tool, the Bulk Subscriber Delete tool, or both. Regardless of the method you use for removing Cisco Unity–specific attributes or removing Active Directory accounts, after you migrate Cisco Unity data to Connection, you should still run Uninstall Unity on the server to remove Cisco Unity objects from Active Directory.

In a flash cutover migration and a Unified Messaging configuration, use the Uninstall Unity utility to remove Cisco Unity–specific attributes from Active Directory accounts. The tool removes Cisco Unity attributes from Active Directory accounts for all of the Cisco Unity subscribers who are homed on the current server.

In a Voice Messaging configuration for which you created duplicate Active Directory accounts in the corporate forest for Cisco Unity subscribers, you will probably want to remove the Active Directory accounts, not just Cisco Unity–specific attributes. To remove Active Directory accounts, you must use the Bulk Subscriber Delete tool in Tools Depot.

In a Voice Messaging configuration for which you created a separate forest, removing Active Directory attributes and accounts is unnecessary if you are going to reinstall the operating system on the Cisco Unity servers and on the domain controllers and global catalog servers.

Enabling FIPS Mode in Connection 8.6

Added TBD

If both of the following are true, enabling FIPS mode in Connection 8.6 will prevent a Connection user from signing in to the telephone user interface (TUI) to play or send voice messages or to change user settings:

  • The user was created in Cisco Unity 5.x or earlier.
  • The Connection user still has a TUI PIN that was assigned in Cisco Unity 5.x or earlier.

A user signs in to the TUI by entering an ID (usually the user’s extension) and a PIN. The ID and PIN are assigned when the user is created; either an administrator or the user can change the PIN. To prevent administrators from accessing PINs in Connection Administration, PINs are hashed. In Cisco Unity 5.x and earlier, Cisco Unity hashed the PIN by using an MD5 hashing algorithm. In Cisco Unity 7.x and later, and in Connection, the PIN is hashed by using an SHA-1 algorithm, which is much harder to decrypt and is FIPS compliant. (MD5 is not FIPS compliant.)

When a user calls Connection and enters an ID and PIN, Connection checks the database to determine whether the user’s PIN was hashed with MD5 or SHA-1. Connection then hashes the PIN that the user entered and compares it with the hashed PIN in the Connection database. If the PINs match, the user is logged in.

In Connection 8.6 and later, if you enable FIPS mode, Connection no longer checks the database to determine whether the user’s PIN was hashed with MD5 or SHA-1. Instead, Connection simply hashes the PIN with SHA-1 and compares it with the hashed PIN in the Connection database. If the PIN was hashed with MD5, the PIN that the user entered and the PIN in the database will not match, and the user is not allowed to sign in.

If any Connection user accounts were originally created in Cisco Unity 5.x or earlier, you may not care whether their PINs were MD5 hashed. If users never log in by using the TUI, it does not matter that their PIN is invalid. If you do have user accounts for which the PIN may have been hashed with MD5, here are some suggestions for replacing the MD5-hashed passwords with SHA-1–hashed passwords:


Note Earlier versions of the Subscriber Information Dump utility do not include the Pin_Hash_Type column.


Alternatively, after you migrate to Connection, use the latest version of the User Data Dump utility to determine how many users still have MD5-hashed PINs. For each user, the Pin_Hash_Type column contains either MD5 or SHA1 . To download the latest version of the utility and to view the Help, see the User Data Dump page on the Cisco Unity Tools website at http://ciscounitytools.com/Applications/CxN/UserDataDump/UserDataDump.html .


Note Earlier versions of the User Data Dump utility do not include the Pin_Hash_Type column.


  • Before you migrate to Connection, check the User Must Change Password at Next Login check box on the Subscribers > Subscribers > Phone Password page in the Cisco Unity Administrator. Then encourage users to sign in to Cisco Unity and change their PINs.

Alternatively, after you migrate to Connection and before you enable FIPS mode, check the User Must Change at Next Sign-In check box on the Password Settings page in Connection Administration. Then encourage users to sign in to Connection and change their PINs.

  • After you migrate to Connection, if you still have users who have not changed their PINs, you can run the Bulk Password Edit utility. Bulk Password Edit lets you selectively change PINs (for example, for all users who still have PINs that were hashed with MD5) to random values. The utility also exports data on the changes to a .csv file. The export file includes the name, alias, email address, and new PIN for each user whose PIN was changed. You can use the .csv file to send an email to each user with the new PIN. The utility is available on the Cisco Unity Tools website at http://www.ciscounitytools.com/Applications/CxN/BulkPasswordEdit/BulkPasswordEdit.html .

Task List for Migrating from Cisco Unity 4.0(3) or Later to Connection 8.x by Using a Flash Cutover

Revised TBD

Use the following high-level task list to migrate to Connection 8.x correctly. The tasks reference detailed instructions in this guide and in other Connection documentation as noted. Follow the documentation for a successful migration.


Note For information on migrating from Cisco Unity to Connection by gradually moving data, see the “Migrating from Cisco Unity to Cisco Unity Connection 8.x by Gradually Moving Data” chapter.


1. If you are reusing the current Cisco Unity server rather than installing a new server, review the applicable Cisco Unity Connection 8.<x> Supported Platforms List to determine whether the server requires replacement hard disks or additional RAM. The document is available at http://www.cisco.com/en/US/products/ps6509/products_data_sheets_list.html .

2. If you are enabling FIPS mode: Review the discussion of telephone user interface (TUI) PINs that are not FIPS compliant and that can prevent users from signing in to the TUI. See the “Enabling FIPS Mode in Connection 8.6” section.

3. Copy or obtain reissued Cisco Unity license files, and obtain a Connection upgrade license:

a. Copy or obtain reissued Cisco Unity license files, depending on whether you’re reusing the Cisco Unity server for Connection:

 

Reusing current Cisco Unity server
rather than installing a new server

Copy the Cisco Unity license files to a network location. Do not install the license files now; you do so later in the migration process.

Installing a new server

a. Obtain reissued Cisco Unity license files with the MAC address of the new Cisco Unity Connection server. See the “Managing Licenses in Cisco Unity Connection 8.x” chapter of the System Administration Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/8x/administration/guide/8xcucsagx.html .

b. Save the reissued license files to a network location. Do not install the license files now; you do so later in the migration process.

b. Obtain a Connection upgrade license, which enables Connection 8.x and is required for Connection-specific features.

See the “Managing Licenses in Cisco Unity Connection 8.x” chapter of the System Administration Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/8x/administration/guide/8xcucsagx.html .

4. Review the “Requirements for Migrating from Cisco Unity 4.0(3) or Later to Cisco Unity Connection Version 8.x” section of System Requirements for Cisco Unity Connection 8.x at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/8x/requirements/8xcucsysreqs.html .

5. See the applicable version of Release Notes for Cisco Unity Connection for additional information on the shipping version of Cisco Unity Connection. In particular, note the items in the section “Installation and Upgrade Information.” Release notes are available at http://www.cisco.com/en/US/products/ps6509/prod_release_notes_list.html .

6. If the Cisco Unity server is running version 4.0(1) through 4.0(4): Download the software for upgrading to Cisco Unity 4.0(3) or later. For more information, see the section on downloading software in the applicable release notes at http://www.cisco.com/en/US/products/sw/voicesw/ps2237/prod_release_notes_list.html .

7. Download the following tools:

8. Install the tools that you downloaded in Step 7.

When Cisco Unity failover is configured:

Install the Cisco Unity Disaster Recovery Backup tool on the secondary server.

Install all other tools on the active server, regardless of whether the active server is the primary or secondary server.

9. Back up the server by using the Cisco Unity Disaster Recovery tools. This backup will not be used to restore data on the Connection 8.x system; we recommend it only so you can revert to Cisco Unity if necessary.

10. If you want to use the Migration Export tool, and if you do not already have a secure shell (SSH) server application installed on a server that is accessible to the Cisco Unity server: Install an SSH server application. The migration tool that imports Cisco Unity data into Connection 8.x uses SSH to access the exported user data and messages.


Note Only OpenSSH for Windows was tested, and customers have reported problems migrating using other SSH applications.


11. Optional: Use the Cisco Unity to Connection Migration Export tool to export Cisco Unity data and messages. You will use the data exported by this tool only if COBRAS fails for some reason. For more information, see Help for the tool at http://www.ciscounitytools.com/Applications/CxN/UnityToConnectionMigrationExport/UnityToConnectionMigrationExport.html .

If you have a secure shell (SSH) server application installed on a server that is accessible to the Cisco Unity server, export to the SSH server. If you do not have an SSH server, you can export data to any network location. You can set up an SSH server later if necessary.

12. If the Cisco Unity server is running version 4.0(1) through 4.0(4): Upgrade to Cisco Unity 4.0(3) or later. For more information, see the following documentation:

13. Use COBRAS to export Cisco Unity data and, optionally, messages. For more information, see Help for the tool at http://www.ciscounitytools.com/Applications/General/COBRAS/COBRAS.html .

If you are configuring single inbox, and if Cisco Unity is configured as unified messaging, so Connection voice messages that are synchronized to Exchange will be saved in the same mailbox that Cisco Unity voice messages are stored in now, we recommend that you select the Include Corporate Email Addresses from Backup for New User Creation checkbox in COBRAS. When you restore Cisco Unity data on the Connection server, the Exchange email addresses associated with Cisco Unity users will be saved in the Corporate Email Address field on the User Basics page in Cisco Unity Connection Administration. This will simplify configuration of single inbox later in the migration process.

14. If additional memory or replacement hard disks are required: Add memory or replace hard disks. See the “Installing a Memory Upgrade or Replacing All Hard Disks to Support Connection 8.x (Selected Servers Only)” section.

15. Install and begin configuring Connection 8.x. See Part 1 through Part 3 in the “Task List for Installing a Cisco Unity Connection 8.x System (Without a Connection Cluster)” in the “Overview of Mandatory Tasks for Installing a Cisco Unity Connection 8.x System” chapter of the Installation Guide for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/8x/installation/guide/8xcucigx.html .

16. Restore Cisco Unity data on the Connection server by using COBRAS. See the following documentation:

If you need to instead restore data by using the Migration Import tool, see the following documentation:

17. Finish configuring Connection 8.x. See Part 5 through Part 9 in the “Task List for Installing a Cisco Unity Connection 8.x System (Without a Connection Cluster)” in the “Overview of Mandatory Tasks for Installing a Cisco Unity Connection 8.x System” chapter of the Installation Guide for Cisco Unity Connection .


Note When you install licenses, if you are configuring a Connection cluster, the license that has the MAC address of the publisher server must be installed on the publisher server. The license that has the MAC address of the subscriber server must be installed on the subscriber server.


18. Test Connection to confirm that the migration was successful.

19. If Cisco Unity attributes and objects are in the corporate directory: Uninstall Cisco Unity, which removes Cisco Unity attributes and objects from Active Directory. For more information, see the “Removing Cisco Unity Data from Active Directory” section.

Installing a Memory Upgrade or Replacing All Hard Disks to Support Connection 8.x (Selected Servers Only)


Note If you are upgrading a server that does not require a memory upgrade or a hard-disk replacement, skip this section.


Some servers that are qualified for use with Cisco Unity Connection require a memory upgrade or a hard-disk replacement, either to support Connection 8.x or to support Connection 8.x features.

See the applicable server-specific table in the Cisco Unity Connection 8.<x> Supported Platforms List at http://www.cisco.com/en/US/products/ps6509/products_data_sheets_list.html .


Warning Before working on a system that has an on/off switch, turn OFF the power and unplug the power cord. Statement 1



Warning Before opening the chassis, disconnect the telephone-network cables to avoid contact with telephone-network voltages. Statement 2



Warning This equipment is to be installed and maintained by service personnel only as defined by AS/NZS 3260 Clause 1.2.14.3 Service Personnel. Statement 88



Warning During this procedure, wear grounding wrist straps to avoid ESD damage to the card. Do not directly touch the backplane with your hand or any metal tool, or you could shock yourself. Statement 94



Warning The safety cover is an integral part of the product. Do not operate the unit without the safety cover installed. Operating the unit without the cover in place will invalidate the safety approvals and pose a risk of fire and electrical hazards. Statement 117



Warning Do not work on the system or connect or disconnect cables during periods of lightning activity. Statement 1001



Warning Read the installation instructions before connecting the system to the power source. Statement 1004



Warning To prevent bodily injury when mounting or servicing this unit in a rack, you must take special precautions to ensure that the system remains stable. The following guidelines are provided to ensure your safety:
• This unit should be mounted at the bottom of the rack if it is the only unit in the rack.
• When mounting this unit in a partially filled rack, load the rack from the bottom to the top with the heaviest component at the bottom of the rack.
• If the rack is provided with stabilizing devices, install the stabilizers before mounting or servicing the unit in the rack. Statement 1006



Warning There is the danger of explosion if the battery is replaced incorrectly. Replace the battery only with the same or equivalent type recommended by the manufacturer. Dispose of used batteries according to the manufacturer’s instructions. Statement 1015



Warning This unit is intended for installation in restricted access areas. A restricted access area can be accessed only through the use of a special tool, lock and key, or other means of security. Statement 1017



Warning To avoid electric shock, do not connect safety extra-low voltage (SELV) circuits to telephone-network voltage (TNV) circuits. LAN ports contain SELV circuits, and WAN ports contain TNV circuits. Some LAN and WAN ports both use RJ-45 connectors. Use caution when connecting cables. Statement 1021



Warning To reduce the risk of fire, use only No. 26 AWG or larger telecommunication line cord. Statement 1023



Warning This equipment must be grounded. Never defeat the ground conductor or operate the equipment in the absence of a suitably installed ground conductor. Contact the appropriate electrical inspection authority or an electrician if you are uncertain that suitable grounding is available. Statement 1024



Warning Blank faceplates and cover panels serve three important functions: they prevent exposure to hazardous voltages and currents inside the chassis; they contain electromagnetic interference (EMI) that might disrupt other equipment; and they direct the flow of cooling air through the chassis. Do not operate the system unless all cards, faceplates, front covers, and rear covers are in place. Statement 1029



Warning Only trained and qualified personnel should be allowed to install, replace, or service this equipment. Statement 1030



Warning Ultimate disposal of this product should be handled according to all national laws and regulations. Statement 1040


(For translations of the preceding safety warnings, see Regulatory Compliance and Safety Information for Cisco Unity Connection at http://www.cisco.com/en/US/docs/voice_ip_comm/connection/regulatory/compliance/ucwarns.html .)

To Install a Memory Upgrade or Replace All Hard Disks to Support Connection 8.x (Selected Servers Only)


Step 1 Remove the cover.

Step 2 If you are not installing a memory upgrade, skip to Step 3.

Install the memory modules in the applicable slots or locations, depending on the server model, as documented in the Cisco Unity Connection 8.<x> Supported Platforms List at http://www.cisco.com/en/US/products/ps6509/products_data_sheets_list.html .


Caution If you install new memory modules in the wrong slots, the server and operating system may not recognize that they have been installed, and Cisco Unity Connection performance may suffer.

Step 3 If you are not replacing hard disks, skip to Step 4.


Caution You must remove existing hard disks and install exactly as many hard disks as you remove, or Cisco Unity Connection installation will fail.

Replace the hard disks:

a. Make note of the current locations of the hard disks in the server, including which hard disk is in which hard disk slot. If the replacement fails and you want to revert to the current configuration, you must put the existing hard disks back into their current locations.

b. Remove the drive trays from the server.

c. Remove the old hard disks from the drive trays.

d. Insert the new hard disks into the drive trays.

e. Reinstall the drive trays in the locations that you made note of in Step a.

Step 4 Reattach the cover.


 

Preparing to Create User Accounts by Using Multiple Connection 8.x Templates

The utility that exports user data from Cisco Unity 4.0(3) and later creates one CSV file with data for all users, and the utility that imports this data into Connection 8.x creates all of the new user accounts by using the same template. If you want to create user accounts by using two or more templates, you may want to split the CSV file into one file per template. (Depending on how you want to split users among templates, it might be faster to create all user accounts with the same template and then update user settings individually.)

To Prepare Multiple CSV Files for Creating User Accounts by Using Multiple Connection 8.x Templates


Step 1 In the location to which you exported Cisco Unity 4.0(5) and later data, create a subfolder for each template that you want to use. Give each subfolder the same name as the corresponding template.

Step 2 Copy the CSV file to each subfolder. Use the same filename as the original CSV file, or the import will fail.

Step 3 Copy all of the recorded-name WAV files from the location to which you exported Cisco Unity 4.0(5) and later data to each subfolder that you created in Step 1. Filenames are in the format <user_alias>_VOICE_NAME.wav.

When you import user data from a CSV file, the corresponding recorded-name WAV files are also imported. The import utility looks for these files only in the folder that contains the CSV file from which you are importing.

Step 4 Open the CSV file in each subfolder, and delete the rows for the users who you do not want to import by using the corresponding template.

For example, if you were editing the CSV file in a SalesStaffTemplate folder, you would delete all of the rows for all of the users who you do not want to create by using the SalesStaffTemplate.


 

Importing User Data and Messages into Connection 8.x by Using COBRAS

For extensive information on importing user data and, optionally, messages into Connection, see the COBRAS Help at http://www.ciscounitytools.com/Applications/General/COBRAS/COBRAS.html .

Importing User Data and Messages into Connection 8.x by Using the Cisco Unity to Connection Migration Export Tool


Note If you exported data by using the COBRAS tool, see COBRAS Help (http://www.ciscounitytools.com/Applications/General/COBRAS/COBRAS.html) for information on importing data and messages.


If you exported both user data and messages, you must import user data before you import messages.


Caution Passwords for Cisco Unity web applications cannot be exported because they are stored in Active Directory. When you create new user accounts by importing data, every account will get the same password, which is the password in the template that you specify when you import data.

When you import user data into Cisco Unity Connection 8.x, the Migrate Users utility does not confirm that passwords meet the password requirements specified by Connection credential policies. The first time users sign in to Connection 8.x by phone or sign in to a web tool, they are prompted to change the password. Credential policies will enforce password requirements. If the user data you import contains any blank passwords, those new user accounts will be created with the default password of the chosen template.

This section contains two procedures, one for importing user data and the other for importing messages.

To Import User Data into Connection 8.x by Using the Cisco Unity to Connection Migration Export Tool


Step 1 In Cisco Unity Connection Administration, expand Tools , expand Migration Utilities , and select Migrate Users .

Step 2 In the Server Name or IP Address field, enter the name or the IP address of the SSH server to which you copied Cisco Unity user data.

Step 3 In the Path Name field, enter the path to the folder that contains the user data that you want to import.

The format of the path depends on how you configured the SSH server application for access to that folder.

Step 4 In the User Name and Password fields, enter the account name and password for an account that has the permissions required to access the server and files to which you exported the data.

Step 5 For User Template , select the template whose settings you want to apply to all of the users you are creating with the imported data.

Step 6 In the Failed Objects Filename field, enter the filename for the log file. Connection will save information in the specified file about users whose data could not be imported.

Step 7 Select Submit .

When the import is finished, the Status displays “Bulk Administration Tool completed,” as well as the number of users for which the import process succeeded and the number for which it failed.

Step 8 If the import failed for any users, review the file that you specified in Step 6 for information on which user accounts could not be created, and correct the errors as applicable.

You can ignore errors for accounts that are common to all versions of Connection, for example, Operator and UndeliverableMessagesMailbox.

If the import failed for only a few accounts, it may be faster to create the missing accounts manually in Cisco Unity Connection Administration.


Caution If you create accounts manually and you want to import messages that you exported from Cisco Unity, you must give each account the exact alias and SMTP address that the corresponding Cisco Unity account had. If you give the new account a different alias and/or SMTP address, Connection 8.x will not be able to associate the imported messages with the new accounts.

Step 9 Correct user data that could not be imported and reimport it, if applicable:

a. Save the log file locally. This file, which contains only rows for the users who could not be imported, is the file you specified in the Failed Objects Filename field in Step 6.

b. Correct data in the log file.

c. Change the name of the log file to match the name of the CSV file that you imported from, UnityMigrationOutput.csv.

d. Copy the renamed log file into the folder that contains the CSV file that you imported from, and overwrite the original CSV file.

e. Repeat Step 2 through Step 8 until all of the accounts are successfully imported.


Caution If you exported messages as well as user data, you must successfully create all user accounts before you import messages, or the message import will fail.

Step 10 If you created more than one CSV file so that you could import by using more than one template, repeat Step 2 through Step 8 for each of the remaining CSV files that you created in the To Prepare Multiple CSV Files for Creating User Accounts by Using Multiple Connection 8.x Templates.


 

To Import Messages into Connection 8.x by Using the Cisco Unity to Connection Migration Export Tool


Step 1 In Cisco Unity Connection Administration, expand Tools , expand Migration Utilities , and select Migrate Messages .

Step 2 In the Server Name or IP Address field, enter the name or the IP address of the SSH server to which you exported Cisco Unity user data and messages.

Step 3 In the Path Name field, enter the path to the folder that contains the messages that you want to import.

The format of the path depends on how you configured the SSH server application for access to that folder.

Step 4 In the User Name and Password fields, enter the account name and password for an account that has the permissions required to access the server and files to which you exported the data.

Step 5 Select Submit .

When the import is finished, the Status displays “Bulk Administration Tool completed,” as well as the number of messages migrated.