Cisco Unified MeetingPlace Release 7.0 -- Migrating to Cisco Unified MeetingPlace Release 7.0.3 from Release 6.0

From DocWiki

(Difference between revisions)
Jump to: navigation, search
(Procedure)
(Backing Up the Web Conferencing Data Before a Migration)
Line 1,017: Line 1,017:
==== Backing Up the Web Conferencing Data Before a Migration ====
==== Backing Up the Web Conferencing Data Before a Migration ====
-
This is '''Step 12''' of the [[Cisco Unified MeetingPlace Release 7.0 -- Migrating to Cisco Unified MeetingPlace Release 7.0.3 from Release 6.0#Migration Process|Migration Process]].
+
This is '''Step 12''' of the [[Cisco Unified MeetingPlace Release 7.0 -- Migrating to Cisco Unified MeetingPlace Release 7.0.3 from Release 6.0#Migration Process|Migration Process]].  If your Cisco Unified MeetingPlace system includes a Microsoft Outlook plug-in integration and users schedule meetings through Cisco Unified MeetingPlace (back-end integration), then complete [[Cisco Unified MeetingPlace Release 7.0 -- Migrating to Cisco Unified MeetingPlace Release 7.0.3 from Release 6.0#Exporting the ICalendarMeetings table from the Cisco Unified MeetingPlace 6.0 (MR5) Web Conferencing Server Database to a Text File|Exporting the ICalendarMeetings table from the Cisco Unified MeetingPlace 6.0 (MR5) Web Conferencing Server Database to a Text File]] ('''Step 11''') before starting this step.
The Cisco Unified MeetingPlace Web Conferencing Backup or Restore Wizard generates an executable that migrates configuration settings and meeting information from one Web Server to another. If you have a load-balancing cluster of Web Servers, complete the following procedures on each server in the cluster.  
The Cisco Unified MeetingPlace Web Conferencing Backup or Restore Wizard generates an executable that migrates configuration settings and meeting information from one Web Server to another. If you have a load-balancing cluster of Web Servers, complete the following procedures on each server in the cluster.  

Revision as of 23:57, 16 November 2010

Cisco Unified MeetingPlace, Release 7.0 > Installation > Migrating to Cisco Unified MeetingPlace Release 7.0.3 from Release 6.0



This page only describes migrations to Cisco Unified Meeting Place Release 7.0.3 (MR2) from Release 5.4 or 6.0. If you want to upgrade from Cisco Unified Meeting Place Release 7.0, then see How to Upgrade to Cisco Unified MeetingPlace Release 7.0.


Contents

About Migration

Because of the different system architectures between Cisco Unified MeetingPlace Release 7.0 and previous releases of Cisco Unified MeetingPlace, you cannot upgrade to this release of Cisco Unified MeetingPlace from a previous 5.4 or 6.0 release. However, you can migrate to this release from a previous release. Migration preserves some of the existing customer and system data while installing a new system.




Migration Process

We currently only support migrations from Cisco Unified MeetingPlace Release 6.0 maintenance release 5 (MR5) to Release 7.0.3 (MR2). If you are using an earlier version of Cisco Unified MeetingPlace and want to migrate to Release 7.0.3, then you must first upgrade to Cisco Unified MeetingPlace Release 6.0 MR5.

The following table presents an overview of the major steps required to migrate a Cisco Unified MeetingPlace Release 6.0 MR5 system to Cisco Unified MeetingPlace Release 7.0.3 (MR2).

Note: This table is written in the order in which you should proceed with your migration. We recommend you familarize yourself with the overall process, as written in the table, before actually proceeding with the migration. You may also want to print a copy of this migration procedure, as a reference.


Procedure
Step # Step Description Related Topics

Step 1.

If your system is earlier than Cisco Unified MeetingPlace6.0 MR5, then first upgrade your system to this version.

Migration Path Matrix.


Step 2.

Prepare for the migration.

Continue with About Migration Paths through Setting Up a Trial System. Be sure to get the appropriate licenses for your Release 7.0.3 system. Cisco Unified MeetingPlace 6.0 licenses do not work with a 7.0 system.

Step 3.

Apply the latest hotfixes and patches to your 6.0 Audio Server and MeetingTime.

Ensure that the Audio Server is version 6.0.5.17 or later.

Ensure that MeetingTime is version 6.0.5.9 or later.

Note: If you do not have these latest patches and hotfixes, then open in a new tab or window. http://tools.cisco.com/support/downloads/go/Model.x?mdfid=282340975&mdfLevel=Software%20Version/Option&treeName=Voice%20and%20Unified%20Communications&modelName=Cisco%20Unified%20MeetingPlace%207.0&treeMdfId=278875240. (This Cisco Unified MeetingPlace Release 7.0.3 Prerequisite Package is mandatory before you start the migration.) Select Unified MeetingPlace Application Server > 7.0(3), then download 70MR2_Prerequisite.zip. Extract the files on your local system.

Step 4.

Read through and complete the necessary migration best practices.

How to Prepare for a Migration.

Note: To save time, you can perform these Migration Best Practices at the same time as the next step (exporting data from the Audio Server).

Step 5.

Migrate existing data from your existing Cisco Unified MeetingPlace Audio Server.

Migrating Data from a Cisco Unified MeetingPlace Release 6.0 Audio Server to a Cisco Unified MeetingPlace Release 7.0.3 Application Server.

Note: You cannot use a Cisco Unified MeetingPlace Release 6.0 Audio Server with a 7.0 system.

Step 6.

Install the Cisco Unified MeetingPlace Release 7.0 Application Server on a new machine.

Tip: Open in a new tab or window. How to Install the Cisco Unified MeetingPlace Application Server.

Step 7.

Import the existing data from the 6.0 Audio Server to the 7.0 Application Server.

Importing the Data to the Cisco Unified MeetingPlace Release 7.0.3 Application Server.

Step 8.

Fix any Application Server migration errors.

Troubleshooting the Application Server Data Migration.

Step 9.

Migrate the directory service.

Migrating Cisco Unified MeetingPlace Release 6.0 Directory Service to Cisco Unified MeetingPlace Release 7.0.3.

Step 10.

Apply the latest hotfixes and patches to your 6.0 Web Conferencing Server.

Ensure that the Web Server has Hotfix HF 6.0.639.99. See Ensuring that Cisco Unified MeetingPlace Release 6.0 MR5 Web Conferencing Server Has Hotfix HF 6.0.639.99.

Step 11.

If your Cisco Unified MeetingPlace system includes a Microsoft Outlook plug-in integration and users schedule meetings through Cisco Unified MeetingPlace (back-end integration), then export the ICalendarMeetings table from the Web Conferencing Server Database to a text file.

Exporting the ICalendarMeetings table from the Cisco Unified MeetingPlace 6.0 (MR5) Web Conferencing Server Database to a Text File.

Step 12.

Back up the existing Web Server database.

Backing Up the Web Conferencing Data Before a Migration.

Step 13.

Install the 7.0 Web Conferencing Server.

Complete one of the following:

Step 14.

Synchronize data between the 7.0 Application Server and the 7.0 Web Conferencing Server.

Synchronizing Meeting Data Between the Cisco Unified MeetingPlace Web Conferencing Server and the Cisco Unified MeetingPlace Application Server.

Step 15.

If applicable, migrate your Microsoft Outlook plug-in.

Migrating Your Microsoft Outlook Plug-In.


Depending on your Outlook integration, complete one of the following:

Step 16.

Test your migration to ensure it was successful.

Depending on your company requirements, test the migration by attending meetings, running reports, testing failover (if applicable), and so on. See General Migration Errors and Troubleshooting and Testing that the Migrated System Works Correctly.

Migration Path Matrix

This is Step 1 of the Migration Process.


The following table lists supported migrations for Cisco Unified MeetingPlace Release 5.4 and 6.0, and the corresponding maintenance releases (MR).


Note: You must be at Cisco Unified MeetingPlace Release 6.0 MR5 to migrate to Cisco Unified MeetingPlace Release 7.0.3 (MR2). Obtain the latest software patches and hotfixes for the Audio Server (6.0.5.17 or later), Web Server 6.0.639.99, and MeetingTime (version 6.0.5.9 or later) before starting the migration. These patches and hotfixes are in the Cisco Unified MeetingPlace Release 7.0.3 Prerequisite Package. See the following table, for information on how to obtain this package.


Note: If you have various Cisco Unified MeetingPlace system components at different versions, then bring all components to the same Cisco Unified MeetingPlace version, before starting the migration.


Table: Cisco Unified MeetingPlace Release Matrix
MIgrating From Migrating To 7.0.3 (MR2) Then Do This

5.4

3 step

Tip: Open these links in a new tab or window.

  1. Upgrade to 6.0 MR4: Upgrading to Cisco Unified MeetingPlace Release 6.0.
  2. Follow the same procedure as in Step 1 and upgrade to 6.0 MR5: Upgrading to Cisco Unified MeetingPlace Release 6.0.
  3. Obtain the Cisco Unified MeetingPlace Release 7.0.3 Prerequisite Package: http://tools.cisco.com/support/downloads/go/Model.x?mdfid=282340975&mdfLevel=Software%20Version/Option&treeName=Voice%20and%20Unified%20Communications&modelName=Cisco%20Unified%20MeetingPlace%207.0&treeMdfId=278875240 (select Unified MeetingPlace Application Server > 7.0(3), and download 70MR2_Prerequisite.zip), then continue with Step 2 of the Migration Process.

Caution! If the migration fails, then remain at Cisco Unified MeetingPlace 6.0 MR5 and contact Cisco TAC for further assistance. Once you have started the migration, you will not be able to revert back to a Cisco Unified MeetingPlace 5.4 system.

6.0

3 step

Tip: Open these links in a new tab or window.

  1. Upgrade to 6.0 MR4: Upgrading to Cisco Unified MeetingPlace Release 6.0.
  2. Follow the same procedure as in Step 1 and upgrade to 6.0 MR5: Upgrading to Cisco Unified MeetingPlace Release 6.0.
  3. Obtain the Cisco Unified MeetingPlace Release 7.0.3 Prerequisite Package: http://tools.cisco.com/support/downloads/go/Model.x?mdfid=282340975&mdfLevel=Software%20Version/Option&treeName=Voice%20and%20Unified%20Communications&modelName=Cisco%20Unified%20MeetingPlace%207.0&treeMdfId=278875240 (select Unified MeetingPlace Application Server > 7.0(3), and download 70MR2_Prerequisite.zip), then continue with Step 2 of the Migration Process.

Caution! If the migration fails, then keep your system at Cisco Unified MeetingPlace 6.0 MR5 and contact Cisco TAC for further assistance. Once you have started the migration, you will not be able to revert back to a Cisco Unified MeetingPlace 6.0 system.

6.0 MR1

3 step

Tip: Open these links in a new tab or window.

  1. Upgrade to 6.0 MR4: Upgrading to Cisco Unified MeetingPlace Release 6.0.
  2. Follow the same procedure as in Step 1 and upgrade to 6.0 MR5: Upgrading to Cisco Unified MeetingPlace Release 6.0.
  3. Obtain the Cisco Unified MeetingPlace Release 7.0.3 Prerequisite Package: http://tools.cisco.com/support/downloads/go/Model.x?mdfid=282340975&mdfLevel=Software%20Version/Option&treeName=Voice%20and%20Unified%20Communications&modelName=Cisco%20Unified%20MeetingPlace%207.0&treeMdfId=278875240 (select Unified MeetingPlace Application Server > 7.0(3), and download 70MR2_Prerequisite.zip), then continue with Step 2 of the Migration Process.

Caution! If the migration fails, then keep your system at Cisco Unified MeetingPlace 6.0 MR5 and contact Cisco TAC for further assistance. Once you have started the migration, you will not be able to revert back to a Cisco Unified MeetingPlace 6.0 MR1 system.

6.0 MR2

3 step

Tip: Open these links in a new tab or window.

  1. Upgrade to 6.0 MR4: Upgrading to Cisco Unified MeetingPlace Release 6.0.
  2. Follow the same procedure as in Step 1 and upgrade to 6.0 MR5: Upgrading to Cisco Unified MeetingPlace Release 6.0.
  3. Obtain the Cisco Unified MeetingPlace Release 7.0.3 Prerequisite Package: http://tools.cisco.com/support/downloads/go/Model.x?mdfid=282340975&mdfLevel=Software%20Version/Option&treeName=Voice%20and%20Unified%20Communications&modelName=Cisco%20Unified%20MeetingPlace%207.0&treeMdfId=278875240 (select Unified MeetingPlace Application Server > 7.0(3), and download 70MR2_Prerequisite.zip), then continue with Step 2 of the Migration Process.


Caution! If the migration fails, then keep your system at Cisco Unified MeetingPlace 6.0 MR5 and contact Cisco TAC for further assistance. Once you have started the migration, you will not be able to revert back to a Cisco Unified MeetingPlace 6.0 MR2 system.

6.0 MR3

3 step

Tip: Open these links in a new tab or window.

  1. Upgrade to 6.0 MR4: Upgrading to Cisco Unified MeetingPlace Release 6.0.
  2. Follow the same procedure as in Step 1 and upgrade to 6.0 MR5: Upgrading to Cisco Unified MeetingPlace Release 6.0.
  3. Obtain the Cisco Unified MeetingPlace Release 7.0.3 Prerequisite Package: http://tools.cisco.com/support/downloads/go/Model.x?mdfid=282340975&mdfLevel=Software%20Version/Option&treeName=Voice%20and%20Unified%20Communications&modelName=Cisco%20Unified%20MeetingPlace%207.0&treeMdfId=278875240 (select Unified MeetingPlace Application Server > 7.0(3), and download 70MR2_Prerequisite.zip), then continue with Step 2 of the Migration Process.


Caution! If the migration fails, then keep your system at Cisco Unified MeetingPlace 6.0 MR5 and contact Cisco TAC for further assistance. Once you have started the migration, you will not be able to revert back to a Cisco Unified MeetingPlace 6.0 MR3 system.

6.0 MR4

2 step

Tip: Open these links in a new tab or window.

  1. Upgrade to 6.0 MR5: Upgrading to Cisco Unified MeetingPlace Release 6.0.
  2. Obtain the Cisco Unified MeetingPlace Release 7.0.3 Prerequisite Package: http://tools.cisco.com/support/downloads/go/Model.x?mdfid=282340975&mdfLevel=Software%20Version/Option&treeName=Voice%20and%20Unified%20Communications&modelName=Cisco%20Unified%20MeetingPlace%207.0&treeMdfId=278875240 (select Unified MeetingPlace Application Server > 7.0(3), and download 70MR2_Prerequisite.zip), then continue with Step 2 of the Migration Process.

Caution! If the migration fails, then keep your system at Cisco Unified MeetingPlace 6.0 MR5 and contact Cisco TAC for further assistance. Once you have started the migration, you will not be able to revert back to a Cisco Unified MeetingPlace 6.0 MR4 system.

6.0 MR5

Yes

Tip: Open this link in a new tab or window.

Obtain the Cisco Unified MeetingPlace Release 7.0.3 Prerequisite Package: http://tools.cisco.com/support/downloads/go/Model.x?mdfid=282340975&mdfLevel=Software%20Version/Option&treeName=Voice%20and%20Unified%20Communications&modelName=Cisco%20Unified%20MeetingPlace%207.0&treeMdfId=278875240 (select Unified MeetingPlace Application Server > 7.0(3), and download 70MR2_Prerequisite.zip), then continue with Step 2 of the Migration Process.

Caution! If the migration fails, then keep your system at Cisco Unified MeetingPlace 6.0 MR5 and contact Cisco TAC for further assistance.


This completes Step 1 of the Migration Process.

About Migration Paths

This is Step 2 of the Migration Process. Be sure you have completed Step 1 (Migration Path Matrix) before starting this step.

We currently only support migrations from Cisco Unified MeetingPlace Release 6.0 maintenance release 5 (MR5) to Release 7.0.3 (MR2). If you are using an earlier version of Cisco Unified MeetingPlace and want to migrate to Release 7.0.3, then you must first upgrade to Cisco Unified MeetingPlace Release 6.0 MR5. If you want to migrate to Release 7.0.1 or 7.0.2, then see How to Migrate to Cisco Unified MeetingPlace Release 7.0.1 or 7.0.2.


For more information on supported migrations, see Migration Path Matrix.


Web Servers

Before the Web Server migration, back up your Web Server data.


You can either reuse an existing Cisco MCS for the Web Server or you can install a newer Cisco MCS. Click-to-attend (CTA) links can only be migrated if the Cisco Unified MeetingPlace Release 7.0.3 Web Server has the same hostname as the Cisco Unified MeetingPlace Release 6.0 Web Server.

  • If you are installing the Cisco Unified MeetingPlace Release 7.0.3 Web Server on a new machine, then restore your existing Web Server data on the new machine.
  • If you are retaining the same hardware for Cisco Unified MeetingPlace Release 7.0.3 Web Server, then temporarily use another machine to back up your existing Web Server data.

Caution! If you choose to continue using the same hardware for your Web Server, then make sure that it meets the minimum requirements for the Cisco Unified MeetingPlace 7.0.3 Web Server.


For more information on supported Cisco MCS, see System Requirements and Compatibility Matrix for Cisco Unified MeetingPlace Release 7.0 at http://www.cisco.com/en/US/products/sw/ps5664/ps5669/products_device_support_tables_list.html

Audio and Application Servers

Cisco Unified MeetingPlace Release 6.0 uses an Audio Server 8100 series. Cisco Unified MeetingPlace Release 7.0 no longer uses an Audio Server but instead uses an Application Server. The Application Server is installed on a Cisco MCS. This component must be installed new and cannot be upgraded from Cisco Unified MeetingPlace Release 6.0. You can migrate data from the Audio Server to the Application Server.


Video Systems

If you currently use a Cisco Unified MeetingPlace 3545 Media Server for Cisco Unified MeetingPlace Release 6.0, you can reuse the chassis and the Video Blade. However, you must upgrade the software for the video blade.

Tip: Open these links in a new tab or window.

  • Cisco Unified MeetingPlace Release 7.0:
http://tools.cisco.com/support/downloads/pub/Model.x?mdfid=282340975&mdfLevel=Software%20Version/Option&treeName=Video%2C%20Cable%20and%20Content%20Delivery&modelName=Cisco%20Unified%20MeetingPlace%207.0&treeMdfId=268438145


Because of the different configurations, you cannot reuse any part of the Cisco Unified MeetingPlace 3515 Media Server nor can you reuse the Audio Blade of the Cisco Unified MeetingPlace 3545 Media Server.


You cannot reuse the Cisco Unified MeetingPlace Release 6.0 video software or video configurations.

Prerequisites for the Migration

  • Read System Requirements and Compatibility Matrix for Cisco Unified MeetingPlace Release 7.0 at http://www.cisco.com/en/US/products/sw/ps5664/ps5669/products_device_support_tables_list.html.
  • If you have not done so already, download the Cisco Unified MeetingPlace Release 7.0.3 Prerequisite Package to obtain the hotfixes and patches for the migration at http://tools.cisco.com/support/downloads/go/Model.x?mdfid=282340975&mdfLevel=Software%20Version/Option&treeName=Voice%20and%20Unified%20Communications&modelName=Cisco%20Unified%20MeetingPlace%207.0&treeMdfId=278875240. Select Unified MeetingPlace Application Server > 7.0(3), then download 70MR2_Prerequisite.zip. Extract the files on your local system.
  • Familiarize yourself with the configuration of the Cisco Unified MeetingPlace Release 7.0 system. See the previous sections in this Installation Guide, as well as the Configuration Guide for Cisco Unified MeetingPlace Release 7.0.
  • Get new licenses for your Cisco Unified MeetingPlace Release 7.0 system. Licenses for Cisco Unified MeetingPlace Release 6.0 do not work with a Cisco Unified MeetingPlace Release 7.0 system. For example, Cisco Unified MeetingPlace Release 6.0 used a license called Exchange and Cisco Unified MeetingPlace Release 7.0 uses a license called msft_int. See Planning Guide for Cisco Unified MeetingPlace Release 7.0 for more information about Cisco Unified MeetingPlace Release 7.0 licenses.
  • Do not run backups during the migration process. If you have scheduled automatic backups, ensure that you suspend them.
  • If you have not run the vfptrfix command within the last 2-3 months, we highly recommend running it to fix voice pointer errors, before exporting data from the Cisco Unified MeetingPlace 6.0 Audio Server (Step 5 of the Migration Process.) (Although this command may take several hours to complete, it helps prevent the MigrateData Capture tool from failing, due to too many voice pointer errors.) Using telnet, sign in to the CLI in Cisco Unified MeetingPlace as the admin user. Then, sign in as the CSC user (su), and enter the password of the day (contact Cisco TAC to obtain the password). Run the vfptrfix -f -v command.
  • If you are using the Cisco Unified MeetingPlace Microsoft Outlook plug-in, then make sure that you export the ICalendarMeetings table before migrating your Web Server to Release 7.0. Complete this export as Step 11 of the Migration Process.

About Preserved and Lost Data


Preserved Data

The migration process preserves the following data for the preceding 38 days or the number of days until the meeting statistics are purged, whichever number is lower:

  • Future meetings, including invited participants (except for video terminals)
  • History of past meetings and meeting participants (preceding 38 days or the number of days until the meeting statistics are purged)
  • Continuous meetings that are still active (ongoing)
  • Recorded user names
  • Recorded meetings (for both voice and web) and attachments (these can only be accessed from the web) for completed meetings (preceding 38 days or the number of days until the meeting statistics are purged)
  • Future meetings
You may be able to access recordings older than 38 days. See Retaining Recordings For More Than 38 Days
  • Recurring meeting instances that occur after the cutoff date (preceding 38 days or the number of days until the meeting statistics are purged)
  • Users and groups
  • Web customizations
  • Click-to-attend links in previous e-mail notifications (only if the Cisco Unified MeetingPlace Release 7.0 Web Server has the same hostname as the Cisco Unified MeetingPlace Release 6.0 Web Server)
  • Old Microsoft Outlook notifications
  • Old IBM Lotus Notes notifications
  • Old e-mail notifications

Lost Data

During the migration process, the following will be lost:

  • The ability to use most of your current hardware.
  • Video reservations, including any video terminals that were invited, for all meetings
  • Video terminal information. You must recreate all video terminal accounts after the migration.
  • High definition video capability
  • Meeting statistics and billing information
  • Meeting categories (user profiles and scheduled meetings that use custom categories will revert to using the standard meeting category)
  • System configuration
  • Team information (no concept of teams in Cisco Unified MeetingPlace Release 7.0)
  • Audio customizations such as voice prompts and flex fields
  • Customizations for Cisco Unified MeetingPlace integrations (for example, Microsoft Outlook templates)


Related Topics

About Migration Paths


Retaining Recordings For More Than 38 Days

The migration process documented in this module retains historical meeting data for up to 38 days. If you want to retain data for a longer period, you may chose one of the following options.

  • You can keep the legacy Cisco Unified MeetingPlace system for historical data.
We recommend you restrict users from starting new meetings on the legacy system. You can rename the legacy Cisco Unified MeetingPlace system with a new name, and retain the existing name on the new Cisco Unified MeetingPlace 7.0.3 system for an easier transition.
  • Retain the existing Cisco Unified MeetingPlace system for a specified period, and ask meeting hosts and participants to download historical meetings and attachments on to their own machine.
After the specified time, you can bring down the legacy system.

Setting Up a Trial System

If you are unsure if you want to migrate to Cisco Unified MeetingPlace Release 7.0.3, you can first set up a Cisco Unified MeetingPlace Release 7.0.3 trial system.


To set up a trial system, you will need new hardware. You can either temporarily install a Cisco Unified MeetingPlace Web Server or you can permanently install a new Cisco Unified MeetingPlace Web Server to replace your older Cisco Unified MeetingPlace Web Server.


With the trial system, you can import groups and profiles. However, you cannot import meetings, due to the risk of sending out conflicting or invalid notifications.


If you decide to convert your trial system to a Cisco Unified MeetingPlace Release 7.0.3 production system, you must first clear out the trial data and then import the actual data from the older system.


Note: All recordings made between when you import the data to the trial system, to when you import the data again before converting the trial system to production, are lost.


This completes Step 2 of the Migration Process.

What To Do Next

If you have not done so already, complete Step 3 of the Migration Process by applying the latest hotfixes and patches to your 6.0 Audio Server and MeetingTime. Ensure that the Audio Server is version 6.0.5.17 or later and that MeetingTime is version 6.0.5.9 or later.

How to Prepare for a Migration

This is Step 4 of the Migration Process. Be sure you have completed Step 3 (applying the latest hotfixes and patches to your 6.0 Audio Server and MeetingTime) before starting this step.

During a migration, many errors can occur. We strongly recommend that you thoroughly review this section before you begin a migration.


Migration Considerations

Caution! Do not run any other processes or tasks on your Cisco Unified MeetingPlace Release 6.0 system during a migration, especially during the data backup process. This can potentially affect the data that is being transferred from one system to another.

  • The migration script converts Cisco Unified MeetingPlace Release 6.0 users of the type "technician" to users of the type "delegate" in Cisco Unified MeetingPlace Release 7.0.
  • The allowed range for the value for the GROUP_ATTR_PREFERREDUNIT parameter in Cisco Unified MeetingPlace Release 6.0 was 0-32767. In Cisco Unified MeetingPlace Release 7.0, the allowed range for that value is 0-999. If your Cisco Unified MeetingPlace Release 6.0 system has values that are higher than 999, the migration will produce an error.
  • The system migrates Cisco Unified MeetingPlace Release 6.0 meetings with passwords but problems can arise if the Cisco Unified MeetingPlace Release 6.0 password is less than the minimum password length required in Cisco Unified MeetingPlace Release 7.0. Therefore, we suggest that you set the value for the "Minimum meeting password length" parameter in Cisco Unified MeetingPlace Release 7.0 to the same value as or a smaller value than the parameter value in Cisco Unified MeetingPlace Release 6.0.
  • Service codes associated with video meetings are not migrated. When a meeting with video endpoints that was migrated from Cisco Unified MeetingPlace Release 6.0 to Cisco Unified MeetingPlace Release 7.0 starts, the system uses the appropriate Cisco Unified MeetingPlace Release 7.0 service code that matches the Application Server configuration for video rate and audio quality.
  • E-mail formats are mapped as follows:
Table: E-Mail Type Mappings
E-Mail Type (Release 6.0) E-Mail Type and Format (Release 7.0) License Needed (Release 7.0)

none

SMTP (HTML)

--

cc:Mail

SMTP (HTML)

--

Lotus Notes

IBM Lotus Notes (Plain text)

lotusnotes

Microsoft Mail

SMTP (HTML)

--

Microsoft Exchange

Microsoft Exchange (Rich Text Format)

msft_int

Qualcomm Eudora

SMTP (HTML)

--

Netscape Messenger

SMTP (HTML)

--

Other

SMTP (HTML)

--

Migration Best Practices

Caution! Make sure that you back up your existing Cisco Unified MeetingPlace 6.0 system. It is important to have a backup of your data should the migration fail, or you need to cancel the migration.


To avoid multiple errors when importing data from the Cisco Unified MeetingPlace Release 6.0 system to the Cisco Unified MeetingPlace Release 7.0.3 system, follow these tips. To save time, you may choose to complete these best practices while exporting data from the Audio Server (Exporting Data from the Cisco Unified MeetingPlace Release 6.0 Audio Server).

  • Ensure that you have Cisco Unified MeetingPlace Release 7.0 licenses. This avoids errors about audio ports that need to be reserved for meetings.
  • Ensure that the values for the system, meeting, and user configuration parameters for the Cisco Unified MeetingPlace Release 7.0.3 system are as close as possible to those values for the same parameters on the Cisco Unified MeetingPlace Release 6.0 system.
    Note: These are critical initial settings for the Cisco Unified MeetingPlace Release 7.0.3 system. After the migration is complete, you can change these system parameters with no repercussions.
    Both systems must have the same values for the following fields:
    • Minimum profile password length
    • Minimum user password length
    • Maximum ports per scheduled meeting
    • Maximum ports per reservationless meeting
    • Maximum meeting length (minutes)
    • Meeting ID start guard time (minutes)
    • Meeting ID end guard time (minutes)
    • Minimum meeting password length
    • Maximum advance days to schedule
    • Minimum meeting ID length
  • Language settings for users are preserved. However, you will need to configure the language systems on the Cisco Unified MeetingPlace 7.0.3 Application Server.
  • Keep a record of your existing system configuration parameters so that you can use these to configure your Cisco Unified MeetingPlace 7.0.3 system.
  • Ensure that the Cisco Unified MeetingPlace Release 7.0.3 system has enough ports for the largest meeting scheduled on the Cisco Unified MeetingPlace Release 6.0 system.
  • During the migration, you will need to transfer files between servers. Be sure to have a file transfer application, such as WinSCP, available to transfer these files.

General Migration Errors and Troubleshooting

  • If there are errors (for example, with a user or meeting record) the migration does not stop, but skips those records.
  • If you see the following error, it is because a password is required for the meeting in Cisco Unified MeetingPlace Release 7.0.3 but there was no password for the meeting in Cisco Unified MeetingPlace Release 6.0. The system has automatically set the meeting password to 12345 and imported the meeting:


Error Message: Error in record 1, meeting id "xxxx": Password is configured to be mandatory, but none was provided.

  • You must install the Cisco Unified MeetingPlace Release 7.0 licenses before the migration. If you did not install the lotusnotes or the msft_int license and you migrate a meeting that uses that license, the system maps the meeting to the generic SMTP (HTML) format (see Table: E-Mail Type Mappings) and displays the following error message:


Error Message: Changing email format to RTF for group xxx. Import line: "",87,"","4353","xxx","Yes","No","Yes","Beep","BeepName

  • To prevent file corruption, edit the migration files with a text editor. Turn off the word wrap option to improve readability. When finished, save the file with a .csv extension.
  • Experienced users can use Microsoft Excel to edit the migration files. If you use Microsoft Excel, then reopen the saved file with a text editor and remove all the commas in the first line. When finished, save the file with a .csv extension.

Note: If you use Microsoft Excel to edit migration files, you might experience the file formats changing or invisible hex characters being added to the header. We recommend only experienced users use Microsoft Excel.

This completes Step 4 of the Migration Process.

How to Migrate Data from a Cisco Unified MeetingPlace Release 6.0 System to a Cisco Unified MeetingPlace Release 7.0.3 System


Migrating Data from a Cisco Unified MeetingPlace Release 6.0 Audio Server to a Cisco Unified MeetingPlace Release 7.0.3 Application Server

This is Step 5 of the Migration Process. Be sure you have completed Step 4 (How to Prepare for a Migration) before starting this step.

Because of the hardware differences, you must migrate from a Cisco Unified MeetingPlace Release 6.0 Audio Server to a Cisco Unified MeetingPlace Release 7.0.3 Application Server. You cannot use a Cisco Unified MeetingPlace Release 6.0 Audio Server with a Cisco Unified MeetingPlace Release 7.0.3 system and you cannot upgrade from a Cisco Unified MeetingPlace Release 6.0 Audio Server to a Cisco Unified MeetingPlace Release 7.0.3 Application Server.


Note: We recommend that you keep the legacy Cisco Unified MeetingPlace 6.0 Audio Server until you confirm that the migration to Cisco Unified MeetingPlace 7.0.3 is successful.


Note: Plan accordingly, as the Audio Server data migration may take 24 to 48 hours to complete. The time depends on multiple factors including the database, the number of recordings, the number of meetings, number of users, number of notifications, and so on.


To migrate data from an Audio Server to an Application Server, perform the following tasks in this order:

  1. Check free disk space. See Ensuring There is Sufficient Disk Space.
  2. Export data from the old system. See Exporting Data from the Cisco Unified MeetingPlace Release 6.0 Audio Server.
  3. Install the Cisco Unified MeetingPlace Release 7.0 Application Server.
    Tip: Open in a new tab or browser window. How to Install the Cisco Unified MeetingPlace Application Server.
  4. Import the data to the new system. See Importing the Data to the Cisco Unified MeetingPlace Release 7.0.3 Application Server.


Ensuring There is Sufficient Disk Space

Make sure that you have sufficient free disk space on the Cisco Unified MeetingPlace Release 6 Audio Server for certain file systems.


Procedure
  1. Sign in to the Cisco Unified MeetingPlace Audio Server command-line interface as the CSC user (contact Cisco TAC to obtain the password of the day).
  2. Enter the df command to check the space utilization on the root, db, and tmp file systems.
  • The root file system should have less than 65 percent utilization.
mtgplace# df /
Filesystem BlkSize Blocks Used Free  %
/dev/sdncr.1a 16384 31999 19569 12430 61%
If the root file system utilization is higher than 65 percent, then check /usr/users/csc for old case log files and remove them. If you still cannot find enough free space, then contact Cisco TAC for further assistance.
  • The DB filesystem should have less than 60 percent utilization:
mtgplace# df /lat/db
Filesystem BlkSize Blocks Used Free  %
/dev/sdncr.0c 16384 320000 138058 181942 43%
If the db file system utilization is higher than 60 percent, then contact Cisco TAC for further assistance.
  • The tmp file system should have less than 80 percent utilization.
mtgplace# df /tmp
Filesystem BlkSize Blocks Used Free  %
/dev/sdncr.1b 16384 51200 24633 26567 48%
If the tmp file system utilization is higher than 80 percent, then check /tmp/update for old update files and remove them.

Exporting Data from the Cisco Unified MeetingPlace Release 6.0 Audio Server

Before You Begin

You must have the following software installed before starting your Audio Server migration:

  • Cisco Unified MeetingPlace MeetingTime Release 6.0.5.9 or later
  • Cisco Unified MeetingPlace Audio Server Release 6.0.5.17 or later


Note: You must be at Cisco Unified MeetingPlace 6.0 MR5, or the migration tool will fail.

Restriction

Do not run any other processes or tasks on your systems during a migration. This can potentially affect the data that is being transferred from one system to another.

Procedure
  1. Stop the Gateway SIM and Web Conferencing services. See "How to Use the Cisco Unified MeetingPlace Web Conferencing Service" in the Configuration Guide for Cisco Unified MeetingPlace Release 7.0 or the online help in the administrator interface.
  2. Use MeetingTime and sign in, as a system administrator, to the Cisco Unified MeetingPlace 6.0 MR5 Audio Server.
  3. Go to Options > Edit Settings.
  4. Use the arrows to set the Minutes to wait for report results to 300.
    Setting this value to the maximum value of 300, effectively results in no timeout limit.
  5. Telnet to the Cisco Unified MeetingPlace 6.0 MR5 Audio Server CLI as the admin user. Enter restart enable on the command-line interface to reboot the Cisco Unified MeetingPlace Audio Server.
    Complete this command immediately before capturing the migration data.
  6. Use MeetingTime to sign in, as a system administrator, to the Cisco Unified MeetingPlace 6.0 MR5 Audio Server.
  7. Go to Administration > Report.
  8. Click MigrateData Capture from the left panel.
  9. Select the time period for retaining the history of completed meetings and meeting participants. Click 38 from the right panel and use the arrows, if you want to select a shorter time period. Then click OK.
    The maximum time period is 38 days.
  10. Click migratedata.zip from the right panel. Click OK to save the file to the default location, or click Browse to navigate to the directory where you want to save this file. Click Save.
  11. Click Generate Report.
    The system displays a message stating that this report can generate a high data transfer load on the Audio Server and is intended only as a migration tool to Cisco Unified MeetingPlace Release 7.0. Do not run this report during periods of active utilization.
  12. Click Yes to acknowledge the message, then click Yes again, when the system asks if you want to continue.
    When complete, the system returns you to the Report tab.
    The migratedata.zip file contains the following:
    • mpweb_purge_mtgs.sql
    • MtgCat.xml
    • mtversion.txt
    • RawGroup.txt
    • RawMeetings.txt
    • RawMtgCat.txt
    • RawPartAtt.txt
    • RawProfile.txt
    • RecordedNames.zip
    The MigrateData Capture report exports all the .wav files (for recorded names) to the Reports folder in the directory in which Cisco Unified MeetingPlace MeetingTime is installed.
    Note: The system does not remove these files after creating the RecordedNames.zip file. Therefore, if you want to capture migration data from another Cisco Unified MeetingPlace Release 6.0 Audio Server, or redo the migration data capture by using the current Audio Server, then remove all of the .wav files from the Reports folder.

This completes Step 5 of the Migration Process.

What To Do Next
  1. Complete Step 6 of the Migration Process by installing the Cisco Unified MeetingPlace Release 7.0 Application Server. Follow the steps in How to Install the Cisco Unified MeetingPlace Application Server.
    Tip: Open this procedure in a new tab or browser window.
    Be sure you have completed Step 5 (Migrating Data from a Cisco Unified MeetingPlace Release 6.0 Audio Server to a Cisco Unified MeetingPlace Release 7.0.3 Application Server) before starting this step.
  2. When finished with the installation, proceed to Importing the Data to the Cisco Unified MeetingPlace Release 7.0.3 Application Server.

Importing the Data to the Cisco Unified MeetingPlace Release 7.0.3 Application Server

This is Step 7 of the Migration Process. Be sure you have completed Step 6 (How to Install the Cisco Unified MeetingPlace Application Server) before starting this step.

Use the Migration Import Tool in the Cisco Unified MeetingPlace Release 7.0 Administration Center to import the data from the Cisco Unified MeetingPlace Release 6.0 Audio Server to the Cisco Unified MeetingPlace Release 7.0 Application Server.


Restriction
  • Ensure that the Cisco Unified MeetingPlace Release 7.0 Application Server has been installed prior to starting the restore process.
    Tip: Open in a new tab or browser window. See How to Install the Cisco Unified MeetingPlace Application Server.
  • Do not run any other processes or tasks on your systems during a migration. This can potentially affect the data that is being transferred from one system to another.
Procedure
  1. Sign in to the Application Server command-line interface as the root user. (For more information, see CLI User Level Options.)
  2. Navigate to the /tmp directory and use the touch command to create a file, .migrate (an empty file).
    [root@<server_name> tmp]# touch .migrate
  3. Verify that an empty .migrate file has been created.
    find . -empty -exec ls {} \;
    This command returns a list of all empty files. For example:
    [root@<server_name> tmp]# find . -empty -exec ls {} \;
    ./dbtasklocks/TRIGGER_WATCH
    ./.migrate
    ./brassd.log
  4. Sign in to the Administration Center on the Application Server.
  5. Choose Maintenance > Migration Import Tool.
  6. Click Browse to navigate to the data file that contains the import data.
  7. Click Execute.
    After the import is completed, the system displays a new tab stating that the import has finished.
  8. Click See Result to confirm the status.
    This popup window displays the detailed status.
  9. Restart the Application Server when the data migration is complete.

This completes Step 7 of the Migration Process.

Troubleshooting the Application Server Data Migration

This is Step 8 of the Migration Process. Be sure you have completed Step 7 (Importing the Data to the Cisco Unified MeetingPlace Release 7.0.3 Application Server) before starting this step.

  • The system always generates the following error messages during the data migration, due to the differences in system profile designs between Cisco Unified MeetingPlace Release 6.0 and Cisco Unified MeetingPlace Release 7.0. These messages can be ignored:


Error Message: Error importing record 2: Profile number 0001 already exists. Import line: "Sales","Engineer","salesengineer","0001","","gd","System"," Error importing record 3: Profile number 0002 already exists. Import line: "Tech","Engineer","technician","0002","","gd","System","0","

  • If the migration import fails, scan the output file for the failure reasons. Fix any errors manually or by using Cisco Unified MeetingPlace MeetingTime. If you use Cisco Unified MeetingPlace MeetingTime, you must export the migrate file again from the Cisco Unified MeetingPlace Release 6.0 Audio Server.
  • Always scan the results of the migration import on the Cisco Unified MeetingPlace Release 7.0.3 system. The most common problems occur when importing the first records from user groups and user profiles. If you see problems, cancel the migration and correct the errors.
    • Sign in as root on the Cisco Unified MeetingPlace 7.0 Application Server command-line interface, and enter mpx_sys restart to cancel the migration.
    • Clean up the database on the Cisco Unified MeetingPlace Release 7.0 Application Server command-line interface by entering /opt/cisco/meetingplace/application/current/bin/cleardb.
  • If more than 5000 errors occur during a migration, then the migration terminates with an error message:


Error Message: Maximum errors reached. Aborting action.

Contact Cisco TAC for further assistance.


Error Message: Migration import is not allowed. Check version of meetingtime used for creating migrate.zip.

If you see the preceding error message when importing migratedata.zip from the Administration Center on the Application Server, then check the following:

  • Make sure the correct version of MeetingTime and the Audio Server are being used to export the database as per Migration_Requirements.
  • Make sure there is no existing data in the Application Server by running the dbsize command as the root user. If there is any data, then run the cleardb command to clean up the data.
  • Check the migration logs located at migrate*.log in the /tmp folder and at migrate*.html.info in the /mpx-record/migrate folder.
  • Check the mpx-record/migrate folder and see if all the contents of migratedata.zip are unzipped.
  • If the contents of migratedata.zip are not completely unzipped or are missing, then manually unzip migratedata.zip by running unzip migratedata.zip from the mpx-record/migrate folder through the command-line interface.



Fixing Migration Data Errors

Problem: If there are errors during a migration (for example, with a user or meeting record), then the migration skips those records. Depending on the number of errors, there are two solutions.

Solution: If there aren't too many errors for users or meetings, then we recommend you recreate the user profiles and meetings.

Solution: If the number of errors is higher, then complete the following steps.


  1. Run raw profile and raw meeting export reports from the Cisco Unified MeetingPlace Release 6 system.
  2. Fix the problem(s) in the .csv file.
    If you use Microsoft Excel to make your changes, then reopen the saved file with a text editor and remove all the commas in the first line. When finished, save the file with a .csv extension.
  3. Import this file into the Cisco Unified MeetingPlace Release 7 system.
    Tip: Open in a new tab or browser window. Import Meetings Page.

Note: With this process, no recorded name gets migrated. If a failed meeting record includes recurrence, then the recurrence is broken at that meeting instance. Manually cancel, then reschedule the meeting with recurrence.

This completes Step 8 of the Migration Process.

Related Topics

General Migration Errors and Troubleshooting.

Migrating Cisco Unified MeetingPlace Release 6.0 Directory Service to Cisco Unified MeetingPlace Release 7.0.3

This is Step 9 of the Migration Process. Be sure you have completed Step 8 (Troubleshooting the Application Server Data Migration) before starting this step.


About Migrating Non-Local Users from Cisco Unified MeetingPlace Release 6.0 to Cisco Unified MeetingPlace Release 7.0.3

The Cisco Unified MeetingPlace Release 6.0 database contains two types of users: local and non-local. Local users were manually created using Cisco Unified MeetingPlace and non-local users were imported into Cisco Unified MeetingPlace from an external directory by Cisco Unified MeetingPlace Directory Services.


The migration process imports all users as local users. Cisco Unified MeetingPlace Release 7.0.3 cannot modify the user profiles for user who had non-local status before but that now have local status.


The following process restores the local or non-local status for users to the original value.

Restoring the Local and Non-Local Status for Users

Before You Begin
  • You have installed the Cisco Unified MeetingPlace Release 7.0.3 Application Server.
  • You have migrated data from the Cisco Unified MeetingPlace Release 6.0 Audio Server to the Cisco Unified MeetingPlace Release 7.0.3 Application Server.
Procedure
  1. Sign in as the administrator to the Cisco Unified MeetingPlace Release 6.0 Web Server and as a superuser to the Cisco Unified MeetingPlace Release 7.0.3 Application Server.
  2. On the Cisco Unified MeetingPlace Release 7.0.3 Application Server, navigate to the following directory: /opt/cisco/meetingplace/migrationtools/current/directoryservice/etc. This directory contains two files: SunOne_ldaptools.zip and MP6.0_MPDSMigrationHelper.bat.
  3. Copy those two files to a local directory on the Cisco Unified MeetingPlace Release 6.0 Web Server where Cisco Unified MeetingPlace Directory Services is running.
  4. Navigate to the directory to which you just copied the files.
  5. Unzip the SunOne_ldaptools.zip file to a new directory.
  6. Copy the MP6.0_MPDSMigrationHelper.bat file to the same new directory.
  7. Navigate to the new directory that you just created.
  8. Enter MP6.0_MPDSMigrationHelper.bat <FQDN of machine where MPDS is running> <LDAP port> <MPDS admin password> to run the Directory Services migration script.
    An example is:
    MP6.0_MPDSMigrationHelper.bat MP6mpds.cisco.com 389 mpds123
    The system writes the output to a file called LocalMPUsers.txt in the current directory.
  9. Copy the output file called LocalMPUsers.txt to the \tmp directory on the Cisco Unified MeetingPlace Release 7.0.3 Application Server.
  10. Sign in as a superuser to the Release 7.0.3 Application Server.
  11. Navigate to the /opt/cisco/meetingplace/migrationtools/current/directoryservice/bin directory.
  12. Enter the following to run the MPDSMigrationHelper script: ./ MPDSMigrationHelper.sh <input file location> <update | getStatus>
    An example is:
    ./ MPDSMigrationHelper.sh /tmp/LocalMPUsers.txt update
    The system writes the log file to the console and to this location: /tmp/MPDSMigrationToMP7.0.log
  13. Enter the following to verify that the migration worked:
    ./ MPDSMigrationHelper.sh /tmp/LocalMPUsers.txt getStatus
    This command writes the local and non-local status of the user to the migration log file and to the console. The output looks like the following:
    User user1 isLocalUser? true

Troubleshooting the Directory Service Migration

If you did not restore the local and non-local user status for users, the system generates the following error message when you try to manage the user profiles:


Error Message: Validation exception: The user ID xxxx is already being used.


The reason is that the Cisco Unified MeetingPlace Release 7.0.3 version of Directory Service tries to create the same users on Cisco Unified MeetingPlace Release 7.0.3 and cannot get user updates from Active Directory or Cisco Unified Communications Manager.


To trigger a full synchronization from Active Directory or Cisco Unified Communications Manager and to update the users, follow the steps in this procedure.



Procedure
  1. Sign in to the Administration Center.
  2. Click User Configuration > Directory Service > Directory Service Configuration.
  3. Enter values for the AXL username, AXL password, and AXL URL fields.
  4. Check the boxes next to Update Now and Perform full sync with Cisco Unified Communications Manager.
  5. Click Save.


This completes Step 9 of the Migration Process.


Related Topics
  • See the Configuration Guide for Cisco Unified MeetingPlace Release 7.0 or the online help in the administrator interface for more information about the Directory Service Configuration page.

Migrating Data from a Cisco Unified MeetingPlace Release 6.0 Web Conferencing Server to a Cisco Unified MeetingPlace Release 7.0.3 Web Conferencing Server

To migrate Web Server data, complete the following procedures, in this order:

  1. Ensuring that Cisco Unified MeetingPlace Release 6.0 MR5 Web Conferencing Server Has Hotfix HF 6.0.639.99.
  2. (Only if you are using the Microsoft Outlook plug-in as a front-end integration.) Exporting the ICalendarMeetings table from the Cisco Unified MeetingPlace 6.0 (MR5) Web Conferencing Server Database to a Text File.
  3. Backing Up the Web Conferencing Data Before a Migration.
  4. Installing the Cisco Unified MeetingPlace 7.0.3 Web Conferencing Server. Complete one of the following:
  5. Synchronizing Meeting Data Between the Cisco Unified MeetingPlace Web Conferencing Server and the Cisco Unified MeetingPlace Application Server.


Note: The backup and restore of Cisco Unified MeetingPlace Web server conferencing data takes approximately 15-30 minutes for each phase.


Ensuring that Cisco Unified MeetingPlace Release 6.0 MR5 Web Conferencing Server Has Hotfix HF 6.0.639.99

This is Step 10 of the Migration Process. Be sure you have completed Step 9 (Migrating Cisco Unified MeetingPlace Release 6.0 Directory Service to Cisco Unified MeetingPlace Release 7.0.3) before starting this step.

Ensure that you install hotfix HF60.639.99 on the Web Server before migrating the Web Server data. This hotfix corrects the version of the database schema, to enable a migration to a Cisco Unified MeetingPlace Release 7 Web Conferencing Server. This hotfix is contained in the Cisco Unified MeetingPlace Release 7.0.3 Prerequisite Package. You may download this package at http://tools.cisco.com/support/downloads/go/Model.x?mdfid=282340975&mdfLevel=Software%20Version/Option&treeName=Voice%20and%20Unified%20Communications&modelName=Cisco%20Unified%20MeetingPlace%207.0&treeMdfId=278875240. Select Unified MeetingPlace Application Server > 7.0(3), then download 70MR2_Prerequisite.zip. Extract the files on your local system.



You can check if you have this hotfix installed by completing the following.

  • Sign in to a Microsoft Windows machine running either SQL Server Enterprise Manager and run the following command:
SELECT TOP 1 * FROM [MPWEB].[dbo].[Version] ORDER BY SchemaVersion DESC;
The return value must be 92.


Note: Follow the instructions in the included README to install the hotfix.


Caution! If the Web Server migration fails, and you need to revert back to Cisco Unified MeetingPlace 6.0 MR5 Web Conferencing Server, then make sure to remove this hotfix before reusing your existing system. The README contains the information to remove this hotfix.

This completes Step 10 of the Migration Process.

Exporting the ICalendarMeetings table from the Cisco Unified MeetingPlace 6.0 (MR5) Web Conferencing Server Database to a Text File

This is Step 11 of the Migration Process. Be sure you have completed Step 10 (Ensuring that Cisco Unified MeetingPlace Release 6.0 MR5 Web Conferencing Server Has Hotfix HF 6.0.639.99) before starting this step.

Note: Only complete this procedure if your Cisco Unified MeetingPlace system has a Microsoft Outlook plug-in with a back-end integration (users schedule meetings through Cisco Unified MeetingPlace). If you do not utilize the Microsoft Outlook plug-in, or you have a front-end integration (users schedule Outlook meetings through Microsoft Outlook), then do not complete this procedure.


Caution! Complete this procedure before migrating your Cisco Unified MeetingPlace 6.0 MR5 Web Server.


This process takes approximately a few minutes.


Procedure
  1. As an administrative user, sign in to a Microsoft Windows machine that can access the Cisco Unified MeetingPlace 6.0 MR5 Web Conferencing Server database.
  2. Start the DTS Import/Export Wizard. Go to Start > All Programs > Microsoft SQL Server > Import and Export Data. Click Next.
  3. Choose a Data Source from the drop-down list. Then, enter the Server name, choose the Authentication, and enter the username and password for the MPWEB database. Click Next.
  4. Choose the Destination, Text File, from the drop-down list. Enter the path and the name of the text file, for example, ICalendarMeetings.txt. Click Next.
  5. Select Copy table(s) and view(s) from the source database. Click Next.
  6. Select the destination file format. Click Next.
    • Source: ICalendarMeetings table
    • Delimited
    • File type: ANSI
    • Row delimiter: {CR}{LF}
    • Column delimiter: Comma
    • Text qualifier: Double Quote {"}
  7. Check the Run Immediately check box. Click Next.
  8. Click Finish to complete the DTS Import/Export Wizard.
    You will import the ICalendarMeetings.txt file to the Cisco Unified MeetingPlace 7.0 MR2 Application Server.


This completes Step 11 of the Migration Process.

Backing Up the Web Conferencing Data Before a Migration

This is Step 12 of the Migration Process. If your Cisco Unified MeetingPlace system includes a Microsoft Outlook plug-in integration and users schedule meetings through Cisco Unified MeetingPlace (back-end integration), then complete Exporting the ICalendarMeetings table from the Cisco Unified MeetingPlace 6.0 (MR5) Web Conferencing Server Database to a Text File (Step 11) before starting this step.

The Cisco Unified MeetingPlace Web Conferencing Backup or Restore Wizard generates an executable that migrates configuration settings and meeting information from one Web Server to another. If you have a load-balancing cluster of Web Servers, complete the following procedures on each server in the cluster.

Note: The restore file generated by the Cisco Unified MeetingPlace Web Conferencing Backup or Restore Wizard cannot be used to revert to Release 6.0 if the migration fails. You will need to have a manual backup created if you need to revert to the original release. For more information, open, in a new tab or browser window, How to Back Up and Restore MPWEB SQL Database.

Note: If you are planning to install the Cisco Unified MeetingPlace Release 7.0.3 Web Conferencing Server on the same hardware as the legacy Cisco Unified MeetingPlace Release 6.0 Web Conferencing Server, then back up your Web conferencing data on a different server.


Cisco Unified MeetingPlace Web Conferencing Backup Utility

The Cisco Unified MeetingPlace web conferencing backup utility is included in the Cisco Unified MeetingPlace 7.0 MR2 Web Server download package. Copy it to the Cisco Unified MeetingPlace 6.0 MR5 Web Server to execute your backup.


The Web Conferencing backup utility uses the Microsoft Windows backup tool as its underlying backup engine. Since the Windows backup tool does not perform any compression, the total size of your projected backup equals the total data size of the files and folders that you want to back up. You may use the Properties function in Windows Explorer to get the size of each folder and add them together to get the total size of back up data.


By default, the backup utility backs up data from the following folders:

  • C:\Program Files\Microsoft SQL Server\MSSQL\Data
  • C:\Program Files\Cisco Systems\MPWeb\Meetings
  • C:\Program Files\Cisco Systems\MPWeb\WebConf\content\7
The \MPWeb\WebConf\content\7 folder contains an extremely large number of folders and files.


These folders are based on the default set up of the local SQL Server database on the Cisco MCS server and on the lack of a shared storage location.


Note: The Web Conferencing backup utility cannot back up data from a shared storage location. To back up such data, manually navigate to the location of your shared storage location, copy the contents of the entire folder, then paste them into another location.


The utility then stores the backed up data in the following folder by default:


C:\Program Files\Cisco Systems\MPWeb\MPBackup


If you run the backup utility in command line mode, you can specify a different location. See Specifying a Different Backup Destination Folder.


Specifying a Different Backup Destination Folder

Complete this procedure if you want to set up your own destination backup folder, where your backed up data will be stored. If you do not do this procedure, the Web Conferencing backup utility will store its backed up data in C:\Program Files\Cisco Systems\MPWeb\MPBackup by default.


If you choose to use the default destination folder, go to Backing Up Data from the Source Web Server.


Procedure
  1. Open a DOS command window.
    1. Select Start > Run.
    2. Enter cmd.
  2. Navigate to the folder where the backup utility is located. Example: C:\Temp\mpweb_software>
  3. Enter the location of your backup destination folder by reviewing the following examples:
    Example 1:
    If you enter ciscounifiedmeetingplacewebconferencingbackup.exe f:
    the backup utility will create a folder called f:\MPBackup and use it as the destination folder for your backed up data.
    Example 2:
    If you enter ciscounifiedmeetingplacewebconferencingbackup.exe f:\backup
    the backup utility will create a folder called f:\backup\MPBackup and use it as the destination folder for your backed up data.
    Note: If you specify f:\ instead of f:, or f:\backup\ instead of f:\backup, the backup utility will fail and abort. In other words, do not include the \ as the last character in your path specification.
    Example 3:
    Specify your destination backup folder by using a UNC path:
    Enter ciscounifiedmeetingplacewebconferencingbackup.exe \\hostname\temp
Backing Up Data from the Source Web Server

As a precaution, complete this procedure even if you will be using the same hardware for the Cisco Unified MeetingPlace 7.0 Web Server.


Before You Begin
  • Manually estimate the total data size of your backup operation to ensure that your destination has enough disk space to hold the backed up data files.
  • Manually stop the MSSQLSERVER service and disable the service until the backup is done.


Note: This backup takes 15-30 minutes, depending on the number of users, meetings, attachments, and recordings. For example, the backup takes about 10 minutes for a system with about 300,000 profile users and 400,000 meetings, with a small number of attachments and recordings.



Procedure
  1. On the original Cisco Unified MeetingPlace 6.0 MR5 Web Conferencing Server, exit any open applications.
  2. Copy CiscoUnifiedMeetingPlaceWebConferencingBackup.exe from the Cisco Unified MeetingPlace 7.0 MR2 Web Server download package and copy it to the Cisco Unified MeetingPlace 6.0 MR5 Web Server.
  3. Double-click CiscoUnifiedMeetingPlaceWebConferencingBackup.exe.
    Note: To store the backup data in a different location, run the following from the command prompt: CiscoUnifiedMeetingPlaceWebConferencingBackup <location>
  4. Click Next in the first dialog box of the Backup or Restore Wizard and follow the prompts.
    The Backup or Restore Wizard creates a restore file called CiscoUnifiedMeetingPlaceWebConferencingRestore.exe that you can use on a separate Web Server.
  5. Set the MSSQLSERVER service back to its original settings.


This completes Step 12 of the Migration Process.

Installing the Cisco Unified MeetingPlace 7.0.3 Web Conferencing Server

This section describes how to set up and install the Cisco Unified MeetingPlace 7.0 Web Server on your existing hardware.
This section describes how to migrate data, such as meeting recordings, attachments, custom strings, and MPWEB database information from the Cisco Unified MeetingPlace 6.0 Web Server to the Cisco Unified MeetingPlace 7.0 Web Server on new hardware.


Using the Same Hardware for Your Cisco Unified MeetingPlace Release 7.0.3 Web Conferencing Server

This is Step 13 of the Migration Process. You only need to perform this procedure if you are using the same hardware for both the Cisco Unified MeetingPlace Release 6.0 and Cisco Unified MeetingPlace Release 7.0 Web Servers. If you are using new hardware, then go to the instructions in Using New Hardware for Your Cisco Unified MeetingPlace Release 7.0.3 Web Conferencing Server.

Restrictions
  • Do not run any other processes or tasks on your systems during a migration. This can potentially affect the data that is being transferred from one system to another.
  • You cannot migrate the Cisco Unified MeetingPlace Web Server when the Application Server is being rebooted. The 7.0.3 Application Server must be running before you can migrate the Web Server.
To ensure that the Application Server is running, sign in to the CLI as mpxadmin and enter swstatus. For more information about using the CLI, see the Configuration Guide for Cisco Unified MeetingPlace Release 7.0 or the online help in the administrator interface.
  • Click-to-attend (CTA) links can only be migrated if the Cisco Unified MeetingPlace Release 7.0.3 Web Conferencing Server has the same hostname as the Cisco Unified MeetingPlace Release 6.0 Web Conferencing Server.
Before You Begin
  • You have migrated data from a Cisco Unified MeetingPlace Release 6.0 Audio Server to a Cisco Unified MeetingPlace Release 7.0.3 Application Server.
  • Look up the value of the "Hostname [Home Page]" parameter for the Cisco Unified MeetingPlace Release 6.0 Web Server and resolve it to obtain the IP address of the NIC that is used during the installation of the Cisco Unified MeetingPlace 7.0.3 Web Conferencing Server. Enter this value when prompted for the local IP address during the Web Server installation.
Note: The correct IP address (hostname) is not necessarily that of NIC 1; therefore, we recommend that you look at the administrator interface for the value of the "Hostname [Home Page]" parameter.
  • If your Cisco Unified MeetingPlace Release 6.0 system was enabled for video, use the Add/Remove Programs function to remove the video program from the Web Server. The video program that worked in Cisco Unified MeetingPlace Release 6.0 does not work in Cisco Unified MeetingPlace Release 7.0.3.
  • Verify that the Cisco Unified MeetingPlace Release 6.0 Web Server has network connectivity to the Cisco Unified MeetingPlace Release 7.0.3 Application Server by running the nslookup hostname and then pinging the hostname.
  • Detach the Cisco Unified MeetingPlace Release 6.0 Web Server from the Cisco Unified MeetingPlace Release 6.0 Audio Server.
Procedure
  1. On the original Cisco Unified MeetingPlace 6.0 MR5 Web Server, exit any open applications.
  2. Although it is not mandatory, we recommend you clean up old files and applications on your existing hardware, before installing the Cisco Unified MeetingPlace 7.0.3 Web Conferencing Server. After cleaning up your system, it should be a clean Cisco MCS.
    1. Using Microsoft Add/Remove Programs, remove Cisco Unified MeetingPlace Web Conferencing.
      Tip: Open in a new tab or browser window. See Uninstalling Web Conferencing Software.
    2. Delete the C:\Program Files\Cisco Systems folder.
    3. Using Microsoft Add/Remove Programs, remove Microsoft SQL Server.
      Tip: Open in a new tab or browser window. See Uninstalling SQL Server Software and Removing MPWEB SQL Database Files.
  3. Use Microsoft Management Console and ensure that no Cisco Unified MeetingPlace services are running.
  4. Restore the Web Server conferencing data.
    1. Copy CiscoUnifiedMeetingPlaceWebConferencingRestore.exe to the destination computer and double-click this file.
      The Backup or Restore Wizard window displays.
    2. Click Next. Select Restore files and settings, then click Next.
    3. Click Browse and navigate to your MeetingPlacebackup.bkf file. Click Next.
    4. Double-click an item in the left pane to see its contents. Check the items you want to restore. Then click Next.
      Ensure that all drives and multiple folder options are checked.
    5. Click Finish to close the Wizard.
      The restore operation proceeds.
    6. Click Close to close the Cisco Unified MeetingPlace Restore window.
  5. Install the Cisco Unified MeetingPlace Release 7.0.3 Web Conferencing software, including Gateway SIM.
    Tip: Open in a new tab or browser window. See Installing the Cisco Unified MeetingPlace Web Conferencing Server.
  6. Enter the hostname of the Cisco Unified MeetingPlace Release 7.0.3 Application Server when the system prompts you for the hostname of the Primary Server.
  7. Enter the IP address associated with the "Hostname [Home Page]" value when the system prompts you for the local IP address.
    The system continues the installation.
  8. Follow the screen prompts to reboot the Web Conferencing Server.
    The system reboots and continues the installation.

This completes Step 13 of the Migration Process.

What to Do Next
Using New Hardware for Your Cisco Unified MeetingPlace Release 7.0.3 Web Conferencing Server

This is Step 13 of the Migration Process. You only need to perform this procedure if you are using new hardware for Cisco Unified MeetingPlace Release 7.0 Web Server. If you are using existing hardware, then go to the instructions in Using the Same Hardware for Your Cisco Unified MeetingPlace Release 7.0.3 Web Conferencing Server.

Restrictions
  • Do not run any other processes or tasks on your systems during a migration. This can potentially affect the data that is being transferred from one system to another.
  • You cannot migrate the Cisco Unified MeetingPlace Web Conferencing Server when the Application Server is being rebooted. The 7.0.3 Application Server must be running before you can upgrade the Web Conferencing Server.
To ensure that the Application Server is running, sign in to the CLI as mpxadmin and enter swstatus. For more information about using the CLI, see the Configuration Guide for Cisco Unified MeetingPlace Release 7.0 or the online help in the administrator interface.
  • Click-to-attend (CTA) links can only be migrated if the Cisco Unified MeetingPlace Release 7.0.3 Web Conferencing Server has the same hostname as the Cisco Unified MeetingPlace Release 6.0 Web Conferencing Server.
Before You Begin
This backup directory includes MeetingPlacebackup.bkf and CiscoUnifiedMeetingPlaceWebConferencingRestore.exe.
  • Ensure that the migration to the new 7.0.3 Application Server has already been completed.
  • Ensure that the Microsoft SQL Server account on the new Web Conferencing Server uses the same username and password as the SQL Server account on the source Web Conferencing Server.


Note: This restore process takes approximately the same amount of time as the backup.

Procedure
  1. Copy CiscoUnifiedMeetingPlaceWebConferencingRestore.exe to the destination computer.
  2. Double-click this file.
    The Backup or Restore Wizard window displays.
  3. Click Next.
  4. Select Restore files and settings. Click Next.
  5. Click Browse and navigate to your MeetingPlacebackup.bkf file. Click Next.
  6. Double-click an item in the left pane to see its contents.
  7. Check the items you want to restore. Click Next.
    Ensure that all drives and multiple folder options are checked.
  8. Click Finish to close the Wizard.
    The restore operation proceeds.
  9. Click Close to close the Cisco Unified MeetingPlace Restore window.


What to Do Next
  1. Install the Cisco Unified MeetingPlace Release 7.0.3 Web Conferencing software on a new Cisco MCS
    Tip: Open in a new tab or browser window and follow the instructions in Installing the Cisco Unified MeetingPlace Web Conferencing Server.
  2. Synchronizing Meeting Data Between the Cisco Unified MeetingPlace Web Conferencing Server and the Cisco Unified MeetingPlace Application Server.


This completes Step 13 of the Migration Process.

Synchronizing Meeting Data Between the Cisco Unified MeetingPlace Web Conferencing Server and the Cisco Unified MeetingPlace Application Server

This is Step 14 of the Migration Process.


When you migrated your Cisco Unified MeetingPlace Audio Server data, you selected the historical time period for retaining the history of completed meetings and the meeting participants. Run the mpweb_purge_mtgs.sql script to delete all meetings data (including CTA links) from the Web Server database older than the time period you specified when creating migratedata.zip. See Exporting Data from the Cisco Unified MeetingPlace Release 6.0 Audio Server.


Note: Although synchronization between the Application Server and the Web Server happens automatically, we recommend that you execute this script before starting the Web Server.


Note: The script execution takes 15 to 30 minutes, depending on the number of users, meetings, attachments, and recordings. For example, it takes about 5 minutes for a system with about 300,000 profile users and 400,000 meetings with minimal attachments and recordings.


Procedure
  1. Stop the Web Server.
    1. Choose Settings > Control Panel > Administrative Tools > Services from the Windows Start menu.
    2. Stop the Cisco Unified MeetingPlace Web Server and Gateway SIM service.
  2. Sign in to the Cisco Unified MeetingPlace Application Server command-line interface as the mpxadmin user.
  3. Navigate to the /mpx-record/migrate directory.
  4. Run the mpweb_purge_mtgs.sql script. Complete one of the following:
    • Copy mpweb_purge_mtgs.sql to a Microsoft Windows machine running either SQL Server Enterprise Manager or SQL Query Analyzer. Using one of these tools, open and execute mpweb_purge_mtgs.sql against the newly restored Web Conferencing Server 7.0.3 database.
    • Run the following command:
    osql -U sa -P <password for system administrator account to access the Web Server database> -i <location of mpweb_purge_mtgs.sql script>
    The script removes any meeting data older than 38 days (or the time period you selected when exporting the Audio Server data.
  5. Restart the Cisco Unified MeetingPlaceWeb Server and Gateway SIM services (refer to Step 1 and start the services). You can now sign into your Web Server, after completing the migration.


This completes Step 14 of the Migration Process.

Migrating Your Microsoft Outlook Plug-In

This is Step 15 of the Migration Process.


In Cisco Unified MeetingPlace Release 6.0, the Microsoft Outlook for Cisco Unified MeetingPlace integration resides on the Web Conferencing Server. For Cisco Unified MeetingPlace Release 7.0.3, the Microsoft Outlook for Cisco Unified MeetingPlace integration resides on the Application Server.


Note: You can migrate your deployment from Cisco Unified MeetingPlace Release 6.0 (MR5) to Release 7.0.3 (MR2) only. Migrations from other Cisco Unified MeetingPlace 6.0 releases to 7.0.3 (MR2) are not supported.


This section describes how to migrate Microsoft Outlook users so that users can attend meetings that were scheduled before the migration.


Users can schedule meetings either from Microsoft Outlook (front-end integration), or from Cisco Unified MeetingPlace, through the Cisco Unified MeetingPlace web user portal, Conference Manager, or MeetingTime (back-end integration).

Note: Select the appropriate migration procedure for your Microsoft Outlook deployment, then test your deployment.


When the migration is complete, the system will automatically replace all future meeting requests that contain the URL of the Cisco Unified MeetingPlace Release 6.0 system with the URL of the Cisco Unified MeetingPlace Release 7.0.3 system.


Before You Begin

Migrating the Microsoft Outlook Users Who Schedule Meetings From Outlook

Complete this procedure if your Cisco Unified MeetingPlace system has a front-end integration with the Microsoft Outlook plug-in


Note: Ensure that you have already upgraded your Cisco Unified MeetingPlace Application Server and Web Conferencing Server to version 7.0.3.


Procedure
  1. Navigate to the /opt/cisco/meetingplace/migrationtools/current/outlook directory on the Cisco Unified MeetingPlace Release 7.0.3 Application Server.
    This directory contains two files:
    • mpoutlook.asp-The asp file used to redirect users to the Cisco Unified MeetingPlace Release 7.0.3 server.
    • mpolhost.tpl-The template file used to get the host name of the Cisco Unified MeetingPlace Release 7.0.3 server.
  2. Copy (and overwrite if it exists) the file called mpoutlook.asp to the C:\Program Files\Cisco Systems\MPWeb\Scripts directory on the Cisco Unified MeetingPlace Release 7.0.3 Web Conferencing Server.
    Note: This must replace the previous file with the same name.
  3. Copy (and verwrite if it exists) the file called mpolhost.tpl to the C:\Program Files\Cisco Systems\MPWeb\Template directory on the Cisco Unified MeetingPlace 7.0.3 Web Conferencing Server.
  4. Open the new mpoutlook.asp file.
  5. Find the following lines:
    Force overwrite of server
    strAppServer = http://<new MP7.0 server>
  6. Replace <new MP7.0 server> with the fully qualified domain name (FQDN) hostname of the Cisco Unified MeetingPlace Release 7.0.3 Application Server.
  7. Uncomment the lines by removing the single quote.
  8. Save and close the file.
What To Do Next

Testing the Outlook Migration

Migrating the Microsoft Outlook Users Who Schedule Meetings from Cisco Unified MeetingPlace

This procedure is for users who schedule meetings through the Cisco Unified MeetingPlace web user portal, Conference Manager, or MeetingTime (back-end integration).


Complete these procedures, in this order:

  1. Exporting the ICalendarMeetings table from the Cisco Unified MeetingPlace 6.0 (MR5) Web Conferencing Server Database to a Text File.
  2. Copying the ICalendarMeetings Text File to a Cisco Unified MeetingPlace7.0.3 (MR2) Application Server.
  3. Executing the migrateFromMP6MR5.sh Script.


Copying the ICalendarMeetings Text File to a Cisco Unified MeetingPlace7.0.3 (MR2) Application Server
Procedure
  1. Using an SSH client, log in to the Application Server command-line interface as the mpxadmin user.
  2. By using SCP file transfer, copy the exported ICalendarMeetings.txt file to the /opt/cisco/meetingplace/migrationtools/current/notifications directory.
  3. Continue to the next procedure, Executing the migrateFromMP6MR5.sh Script.


Executing the migrateFromMP6MR5.sh Script

Caution! Only execute the migrateFromMP6MR5.sh script as part of the Microsoft Outlook plug-in migration from Cisco Unified MeetingPlace 6.0 MR5 to Cisco Unified MeetingPlace 7.0.3 (MR2). Do not execute this script on a live Cisco Unified MeetingPlace 7.0.3 system, or you will overwrite Outlook meetings data.


Note: Ensure that you have created the ICalendarMeetings.txt file and copied it to the Cisco Unified MeetingPlace 7.0.3 Application Server.

The time to complete this procedure depends on the size of your ICalendarMeetings table. For example, an ICalendarMeetings table with 12,500 records and a file size of approximately 1.5 MB takes approximately 10 minutes.

Procedure
  1. Change to the root user by entering su - and enter the root password.
  2. Navigate to the /opt/cisco/meetingplace/migrationtools/current/notifications directory.
    The migrateFromMP6MR5.sh script and the ICalendarMeetings.txt file should be in this directory.
  3. Execute the migrateFromMP6MR5.sh script.
    >./ migrateFromMP6MR5.sh ICalendarMeetings
    After execution, the script reports the total number of inserted, updated, and skipped NotifItemInfo records. The script also creates the migrateFromMP6MR5.log file in the same folder.


What To Do Next

Testing the Outlook Migration

Testing the Outlook Migration

Note: Ensure that you have already migrated your Cisco Unified MeetingPlace Web Server to Release 7.0.3, before completing this procedure.


Procedure
  1. On your Microsoft Outlook calendar, find a future meeting that was scheduled from the Release 6.0 system.
  2. Open the appointment.
  3. Go to the MeetingPlace tab.
  4. If prompted, sign in to the Cisco Unified MeetingPlace Release 7.0.3 system.
    Note: If this is the first time that you are logging in to the Cisco Unified MeetingPlace Release 7.0.3 system, the system opens a new appointment. If this happens, close the new appointment and reopen the appointment that you opened in Step 2.
  5. Verify that the meeting details are the same as they were on the Cisco Unified MeetingPlace Release 6.0 system.
  6. Test if notifications are working properly by making an update to this meeting. The meeting host and all the meeting participants should receive notifications and their Outlook calendars should be correctly updated.

This completes Step 15 of the Migration Process.

Testing that the Migrated System Works Correctly

This is Step 16 of the Migration Process.

Once your migration to Cisco Unified MeetingPlace 7.0.3 is complete, we suggest you run some functional tests on the new system, tailored to your system configuration.


On the command-line interface:

  • Check that all the appropriate services are running.


On the Administration Center:

  • Add a new user.
  • Edit an existing user.
  • Delete an existing user.
  • Add a new group.
  • Delete an existing group.
  • Run a Meeting Information Report from the Administration Center for the last 38 days (or your selected historical time period).


On the Cisco Unified MeetingPlace web user portal:

  • Schedule a meeting.
  • Attend a meeting.
  • Reschedule a series of recurring meetings.
  • Reschedule a single meeting.
  • Delete a single meeting.
  • Delete a series of recurring meetings.
  • Delete a single future meeting.
  • Open the attachment of a future or past meeting.
  • Play an audio recording of a previous meeting.
  • Play an audio and web recording.
  • Look up a historical meeting older than 38 days (or your selected historical time period). These should have been purged from your system.


On the phone user interface:

  • Play recorded usernames.

This completes Step 16 of the Migration Process.

Rating: 0.0/5 (0 votes cast)

Personal tools