Prepare to upgrade DPA

Use the following information to prepare for your upgrade.

Supported upgrade paths

The supported upgrade paths are:

  • DPA 10.2 → 11.0 → 12.1
  • DPA 11.0 → 12.1
  • DPA 11.1 → 12.1
  • DPA 12.0 → 12.1

For information about upgrading from DPA Free, see Upgrade from DPA Free to DPA.

My upgrade plan checklist

Use this preflight checklist to help plan and prepare for your upgrade.

Review the release notes for information about new features, fixed issues, and known issues.

Review the system requirements to make sure your environment meets all hardware and software requirements.

Review your current product licenses and determine if you need to make any changes. You can download any updated license keys for your upgrade through your Customer Portal. Verify any license upgrades and needs with your SolarWinds account manager or contact SolarWinds.
Gather credentials. Make sure you have your SolarWinds account and local administrator credentials for the DPA server.
Check for and run all Windows or Linux operating system updates.

Schedule the upgrade. Set up the maintenance window, preferably during off-peak hours. The duration depends on the size of your repository database and the number of monitored database instances.

Upgrades will require database monitoring to be offline for a period of time.

Notify your company of the upgrade schedule and maintenance window. If you need additional help, contact and allocate specific staff to be available.

How long does an upgrade take?

DPA upgrades typically take fewer than 10 minutes. The time it takes to complete an upgrade depends on:

  • Hardware
  • DPA server performance
  • Repository database server performance and database size
  • Number of monitored database instances

Because every configuration is different, we cannot predict exactly how long your upgrade will take.

Gotchas you should review

  • If you have specified that DPA use a Java installation other than the default version that DPA installs, you must update it to a supported version. (See End of Support in the DPA 12.1 Release Notes for more information.)

  • In previous versions of DPA, SQL Server 2005 repository databases functioned (even though they were not supported). In DPA 12.1, SQL Server 2005 repository databases will no longer function. If you are still using a SQL Server 2005 database as the DPA repository, you must upgrade to a supported repository database version before you upgrade to DPA 12.1.

Prepare your environment to upgrade

When you are ready to upgrade, complete these steps. They include the common actions you need to complete before upgrading DPA.

If you have a test or staging environment, we highly recommend testing the upgrade first. You cannot roll back an installation once completed.

Back up your DPA server. If you have your DPA server on a VM, create a snapshot or copy of your VM.

Back up your repository database. If you need help, please check your vendor's site for documentation and instructions.

You cannot roll back an upgrade. Always create a repository database backup.

Stop DPA.

  • In Windows, stop the Ignite PI Service on the DPA server.
  • In Linux, run the following command from the DPA directory:
    shutdown.sh

Upgrade DPA

Follow the upgrade instructions based on the operating system of your DPA server:

  1. Select your environment below to upgrade DPA.
  2. If you have the DPA Integration Module in the Orion Web Console, upgrade that after the DPA upgrade is complete.

After the upgrade, check your system

Open DPA and verify the version displayed on the login screen or in the header on the homepage. Try current and new features to check performance and expected functionality.