Installation Guide for CiscoWorks QoS Policy Manager 4.0 on Windows
Chapter 4 Upgrading and Migrating QPM

Table Of Contents

Upgrading and Migrating QPM

Upgrading QPM 3.2 or QPM 3.2.x to QPM 4.0

Migrating to a New QPM Server

Migrating QPM 3.2.x Data to a Remote QPM 4.0 Server

Exporting and Importing QPM Application Data

Exporting QPM  Application Data

Importing QPM  Application Data


Upgrading and Migrating QPM


This chapter contains the following topics:

Upgrading QPM 3.2 or QPM 3.2.x to QPM 4.0

Migrating to a New QPM Server

Migrating QPM 3.2.x Data to a Remote QPM 4.0 Server

Exporting and Importing QPM Application Data

Upgrading QPM 3.2 or QPM 3.2.x to QPM 4.0

QPM 4.0 supports upgrade from QPM 3.2 or QPM 3.2.x.

To perform upgrade, make sure that you have purchased the upgrade license for QPM 4.0, and also the additional incremental device pack licenses for QPM 4.0 (in case QPM 3.2.x already has the the device limit of more than 500 devices).

Before upgrading to QPM 4.0, it is recommended that you export the QPM application data from QPM 3.2 or QPM 3.2.x, by copying and running the export.pl utility (available in the QPM 4.0 product DVD), in the MDC\qpm\bin folder in the QPM 3.2 or QPM 3.2.x server.

For this, you can follow the steps mentioned in Migrating QPM 3.2.x Data to a Remote QPM 4.0 Server.

To upgrade QPM 3.2 or QPM 3.2.x to QPM 4.0, use the following installation sequence:


Step 1 Install CiscoWorks Common Services 3.0.5 over QPM 3.2 or QPM 3.2.x. See Installing Common Services on Windows, page 2-2.

The CS 2.2 data is migrated automatically to CS 3.0.5 during this process. You can also back up the CS 2.2 data to a location you specify during this install process.

Step 2 Install QPM 4.0. See Installing QPM on Windows, page 2-7 for details.

QPM application data is migrated automatically when upgrading QPM 3.2 or QPM 3.2.x to QPM 4.0.


Before you begin to work with QPM, ensure that you have the appropriate permissions. See Chapter 3, "Setting Up the QPM Server" for details.

If you are working with ACS user permissions, register the new QPM user permissions in CiscoWorks and ACS, if required. See Working with ACS Device Groups and User Permissions, page 3-10 for details.

Migrating to a New QPM Server

You can migrate QPM information from one QPM 4.0 server to another. This section describes the sequence of tasks for migrating QPM 4.0 information to a new QPM 4.0 server running Windows.


Note You need to buy a new license for remote migration beacuse QPM license is a node-lock license. Also, the device limit with the new license should be equal to or more than the device limit supported in the old server.


To migrate QPM data from one QPM 4.0 server to another:


Step 1 Take a backup of the CS 3.0.5 data using the Common Services Backup utility (available in QPM 4.0 under Administration > Configuration Backup).

Step 2 Export all QPM 4.0 application data from the old QPM server using the export.pl utility, either in the QPM DVD or in the MDC\qpm\bin folder.

See Exporting QPM  Application Data for details.

Step 3 Copy the CS backup data and the QPM export data to the new server.

Step 4 Install CiscoWorks Common Services 3.0.5. on the new server.

See Installing Common Services on Windows, page 2-2. for details.

Step 5 Install QPM 4.0 on the new server.

See Installing QPM on Windows, page 2-7 for details.

Step 6 Execute the restorebackup.pl script (in CS 3.0.5) to restore the CS data in the new server.

Step 7 Import the QPM 4.0 application data using the import.pl utility in the MDC\qpm\bin folder in the new server.

See Importing QPM  Application Data for details.


Before you begin to work with QPM, ensure that you have the appropriate permissions. See Chapter 3, "Setting Up the QPM Server" for details.

If you are working with ACS user permissions, register the new QPM server in CiscoWorks and ACS. See Setting up ACS Device Groups and User Permissions for QPM, page 3-11 for details.

Migrating QPM 3.2.x Data to a Remote QPM 4.0 Server

You can migrate QPM data alone from a QPM 3.2.x server to a remote QPM 4.0 server, and use that data in the QPM 4.0 server


Note To migrate QPM data, you should have obtained the relevant license for QPM 4.0 to support the device limit in QPM 3.2.x.


To migrate QPM 3.2.x data alone to a remote QPM 4.0 server:


Step 1 Copy the export.pl script from the QPM 4.0 DVD (or from the QPM 4.0 server) to the MDC\qpm\bin folder in the QPM 3.2.x machine.

Step 2 Export the QPM data from the QPM 3.2.x machine using this export.pl script. See Exporting QPM  Application Data for details.

Step 3 Copy the exported QPM 3.2.x data to the QPM 4.0 server.

Step 4 Import the copied data into QPM 4.0 using the import.pl script. See Importing QPM  Application Data for details.


Exporting and Importing QPM Application Data

The following topics describe how to use the QPM export and import utilities:

Exporting QPM  Application Data

Importing QPM  Application Data


Note The export utility is available on the QPM DVD, and is also copied to the QPM server during the installation process. The import utlity will be available in the QPM server after the installation.


Exporting QPM  Application Data

You can export the following QPM application data during an upgrade:

QPM database containing device and policy information

QPM monitoring task information

QPM reports

QPM configuration information

Use the export utility when you want to migrate and upgrade QPM 3.2 or QPM 3.2.x application data to QPM 4.0, or when you want to migrate QPM 4.0 from one server to another.

You need to specify the destination folder to which you want to export the application data.

To export QPM application data:


Step 1 Open a Command window:

a. Select Start > Run.

The Run dialog box opens.

b. Enter cmd, and click OK.

The Command window opens.

To run the export utility from the QPM server, in Windows Explorer go to the installation folder. Right-click the MDC\qpm\bin folder, and select Cmd prompt here. The Command window opens in the folder containing the export utility.

Step 2 Run the export utility:

To start the utility from the QPM installation DVD, in the Command window, enter
cd d:\QPM4_0\QPM_4_0_installation\Windows_K9
where d is your DVD drive, and then enter
NMSROOT\bin\perl\export.pl destination folder,
where NMSROOT is the CS installation folder and destination folder is the full path of an existing folder to which you want to export the data.

To start the utility from the QPM server, in the Command window:

If necessary, change to the drive on which QPM is installed and then change directory to the NMSROOT\MDC\qpm\bin folder in the Common Services installation folder.

Enter NMSROOT\bin\perl export.pl destination folder,
where NMSROOT is the CS installation folder, and destination folder is the full path of an existing folder to which you want to export the data.

Step 3 Press Enter.

The utility stops CiscoWorks services, and exports the QPM information to the specified destination folder.

After the export process has completed, the CiscoWorks services are restarted.


Importing QPM  Application Data

Use the import utility to import any QPM application data, which was exported using the QPM 4.0 export utility, into QPM 4.0.


Note The exported data is platform dependent. Therefore you cannot import the QPM data onto a Windows server if this data was exported from a Solaris server.


When you use the import utility, any existing QPM data is overwritten.

To import QPM application data:


Step 1 Open a Command window:

a. Select Start > Run.

The Run dialog box opens.

b. Enter cmd, and click OK.

The Command window opens.

To run the import utility from the QPM server, in Windows Explorer go to the installation folder. Right-click the MDC\qpm\bin folder, and select Cmd prompt here. The Command window opens in the folder containing the import utility.

Step 2 Run the import utility:

To start the utility from the QPM server, in the Command window:

If necessary, change to the drive on which QPM is installed and then change directory to the CSCOpx\MDC\qpm\bin folder in the Common Services installation folder.

Enter NMSROOT\bin\perl import.pl export folder,
where NMSROOT is the QPM installation folder, export folder is the full path of the folder to which you exported the data.

Step 3 Press Enter.

The utility stops CiscoWorks services, and imports the QPM information.

After the import process has completed, the CiscoWorks services are restarted.