Table Of Contents

Upgrading and Migrating QPM

Upgrading from QPM 4.0 to QPM 4.1

Migrating to a New QPM Server on Windows

Migrating QPM Information from One QPM 4.1 Server to Another

Migrating QPM Information from a QPM 4.0 Server to a QPM 4.1 Server

Backing Up and Restoring CS and QPM Application Data

Backing Up CS and QPM  Application Data

Restoring CS and QPM  Application Data

Importing QPM  Application Data

Exporting QPM Application Data

Upgrading and Migrating QPM

---

This chapter contains the following topics:

•Upgrading from QPM 4.0 to QPM 4.1

•Migrating to a New QPM Server on Windows

•Backing Up and Restoring CS and QPM Application Data

•Importing QPM  Application Data

•Exporting QPM Application Data

Upgrading from QPM 4.0 to QPM 4.1

QPM 4.1 supports upgrade from QPM 4.0 and QPM 4.0.x. All the QPM application data is preserved during the upgrade.

---

Note Before you upgrade from QPM 4.0.x to QPM 4.1, to ensure that there is no loss of historical monitoring data, you must:

•Stop the historical jobs that are currently being monitored and in the Running state. The historical jobs move from the Running to Stopped state, and then to the Finished state.

•Start the Upgrade after the historical jobs move to the Finished state.

After you successfully upgrade to QPM 4.1, you can create new monitoring jobs.

---

To upgrade QPM 4.0.x to QPM 4.1:

---

Step 1 Install CiscoWorks Common Services 3.2 over QPM 4.0.x.

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

The CS 3.0.5 application data is migrated automatically to CS 3.2 during this process.

Step 2 Install QPM 4.1.

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

---

Note During this upgrade, Step 7 of fresh installation is not available. Instead, the upgrade license is automatically installed.

---

The QPM 4.0.x application data is migrated automatically to QPM 4.1 during this process.

---

---

Note While upgrading, the QPM application data is automatically backed up at NMSROOT\temp\QPMexport, where NMSROOT is the Common Services installation directory.

---

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-8 for details.

Migrating to a New QPM Server on Windows

You can migrate QPM application data from:

A QPM 4.1 server to another QPM 4.1 server. See Migrating QPM Information from One QPM 4.1 Server to Another for details.

A QPM 4.0 server to a QPM 4.1 server. See Migrating QPM Information from a QPM 4.0 Server to a QPM 4.1 Server for details.

---

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

---

Migrating QPM Information from One QPM 4.1 Server to Another

This section describes how to migrate QPM 4.1 information to a new QPM 4.1 server that runs on Windows.

To migrate QPM information to a new QPM 4.1 server:

---

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

See Backing Up CS and QPM  Application Data for details.

Step 2 Copy the backup data to the new server.

Step 3 Install CiscoWorks Common Services 3.2. on the new server.

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

Step 4 Install QPM 4.1 on the new server.

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

Step 5 Run the restorebackup.pl script (in Common Services) to restore the QPM data in the new server.

See Restoring CS and 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-9 for details.

Migrating QPM Information from a QPM 4.0 Server to a QPM 4.1 Server

This section describes how to migrate QPM 4.0 information to a new QPM 4.1 server that runs on Windows.

---

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

---

To migrate QPM information from a QPM 4.0 server to a QPM 4.1 server:

---

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).

See Backing Up CS and QPM  Application Data for details.

Step 2 Take a backup of QPM 4.0.x data.

See Exporting QPM Application Data for details.

Step 3 Copy the backup data to the new server.

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

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

Step 5 Install QPM 4.1 on the new server.

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

Step 6 Run the restorebackup.pl script (in Common Services) to restore the CS data on the new server.

See Restoring CS and QPM  Application Data for details.

Step 7 Restore the QPM application data.

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-9 for details.

Backing Up and Restoring CS and QPM Application Data

The following topics describe how to use the backup and restore utilities for QPM application data:

•Backing Up CS and QPM  Application Data

•Restoring CS and QPM  Application Data

Backing Up CS and QPM  Application Data

You can take a backup of the following:

•Common Services application data

•QPM application data

–QPM database containing device and policy information

–QPM monitoring jobs that contain network traffic data

–QPM reports

–QPM configuration information

You can use the Backup utility when you want to:

•Migrate QPM 4.0.x application data to a QPM 4.1 server.

•Migrate QPM 4.1 application data from one QPM 4.1 server to another.

•Back up QPM application data.

---

Note While migrating from QPM 4.0.x to QPM 4.1, the Backup and Restore utilities will restore only Common Services data on the QPM 4.1 server. To back up QPM 4.0.x application data, see Exporting QPM Application Data.

---

You must specify the directory to which you want to backup the application data.

To back up QPM application data:

---

Step 1 In QPM, go to Administration > Configuration Backup.

You are redirected to the Backup Job page in CiscoWorks Common Services.

Step 2 In the Backup Job page, enter the path of the Backup Directory, or click Browse to select the directory.

Step 3 Click Apply.

---

Restoring CS and QPM  Application Data

Use the restorebackup.pl utility in Common Services to restore the QPM application data that was backed up.

---

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

---

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

To restore QPM application data:

---

Step 1 Log in as Super User.

Step 2 Copy the backed up data to the new server.

Step 3 Stop all processes by entering the following at the command prompt:

net stop crmdmgtd

Step 4 Restore the database by entering the following command:

NMSROOT\bin\perl NMSROOT\bin\restorebackup.pl -d BKP [-t temporary_directory]

where BKP is the backup directory.

You must enter the absolute path for BKP. For example, if BKP is under C:\, enter the path as NMSROOT\bin\perl NMSROOT\bin\restorebackup.pl -d C:\BKP.

Step 5 Restart the processes by entering the following command:

net start crmdmgtd

---

---

Note While migrating from QPM 4.0.x to QPM 4.1, the Restore utility will restore only Common Services data on the QPM 4.1 server. To restore QPM application data, see Importing QPM  Application Data.

---

Importing QPM  Application Data

Use the import.pl utility to import any QPM 4.0.x application data into QPM 4.1.

---

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.

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.

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

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

---

If you export the QPM 4.0.x data in ACS mode, and import the data in QPM 4.1 Non-ACS mode, you may not be able to log in to QPM 4.1 after the import. This is because the login mode automatically changes to ACS mode in QPM 4.1.

So, after the import, you must reset the login mode of QPM 4.1 to Non-ACS. See Obtaining Debug Information for Cisco Technical Support, page A-4 for information on how to reset the login mode.

Exporting QPM Application Data

You can export the following QPM 4.0.x application data during an upgrade to QPM 4.1:

•QPM database containing device and policy information

•QPM monitoring jobs that contain network traffic data

•QPM reports

•QPM configuration information

Use the Export utility when you want to migrate and upgrade QPM 4.0.x application data to QPM 4.1.

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

To export QPM application data from QPM 4.0.x:

---

Step 1 Run the Export 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 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 2 Press Enter.

This 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.

---