Submit a ticketCall us

Have You Auto Renewed? If not, you're missing out.
The SolarWinds Renewal Program comes with a host of benefits including the most recent product updates, 24/7 technical support, virtual instructor-led training and more. Experience all of this with the convenience of Auto Renewal, and never worry about missing any of these great benefits. Learn More.

Home > Success Center > Database Performance Analyzer (DPA) > DPA Upgrade Guide

DPA Upgrade Guide

Last Updated: October 30, 2017 | SolarWinds Upgrade Guide

Supports: DPA 11.1 and earlier

This guide walks you through upgrading your DPA product. We include checklists to prepare and complete your upgrade, including gotchas and troubleshooting steps.

Supported upgrade paths

The supported upgrade paths are:

  • DPA 10.0 → 11.1
  • DPA 10.1 → 11.1
  • DPA 10.2 → 11.1
  • DPA 8.4 Free → 9.2 → 10.0 → 11.1

My upgrade plan checklist

This preflight checklist details a number of important steps to help plan and prep for your upgrade.

Review release notes Review product release notes and available documentation in our Success Center.
Review system requirements

Make sure your environment has all of the required hardware and software needs for your installations. See the DPA system requirements.

Review licenses 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.
Run all operating system updates Before upgrading, 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 Send a message to 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?

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

Since every configuration is different, we cannot predict exactly how long your upgrade will take. DPA upgrades typically take fewer than 10 minutes, however.

Gotchas you should review

  • When upgrading to DPAIM 11.1, if you added a site binding to a host name before you upgrade, you must bind the Orion Web Console to a fully qualified domain name (FQDN). See this article.
  • When upgrading to DPAIM 11.1 with custom menus, you can not see the Performance Dashboard link in the menu. For details, see this article.
  • Integrated DPAIM 11.1 no longer supports Windows OS 2008 and 2008 R2 and Microsoft SQL Server 2008 R2 for Orion Platform installations. For more information, see End of support notices.
  • Java version: DPA requires JRE 1.8. If you configured DPA to use an external JRE, DPA will verify it is version 1.8 or later. If the verification fails, DPA will use the JRE included with the installation.
  • Integration with Orion: If DPA is installed on the same server as NPM or SAM, see this KB article for special upgrade instructions.

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.

1. Back up your DPA server

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

2. Back up your repository database

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.

3. Stop DPA

In Windows, stop the Ignite PI Service on the DPA server.

In Linux, 

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

After the upgrade check your system

The new product version should be installed properly. You should open DPA and verify the version displayed on the login screen or in the header on the home page. Try current and new features with your system to check performance and expected functionality. If you run into issues, check the troubleshooting tips.

Troubleshooting

If you receive errors, try the following:

  • If you experience issues and are not on the latest product version, we recommend completing a full upgrade.
  • Check our Success Center for troubleshooting. We recommend searching the name of the product, the version number, any error codes or messages displayed, and the general issue you found.
  • Check your Customer Portal for any new hotfixes.

If an issue occurs you need additional help with, contact Support. We recommend gathering a screenshot of the issue and any error codes you receive. Attach and add this information to your ticket.

Legal notices

© 2017 SolarWinds Worldwide, LLC. All rights reserved.

This document may not be reproduced by any means nor modified, decompiled, disassembled, published or distributed, in whole or in part, or translated to any electronic medium or other means without the prior written consent of SolarWinds. All right, title, and interest in and to the software and documentation are and shall remain the exclusive property of SolarWinds and its respective licensors.

SOLARWINDS DISCLAIMS ALL WARRANTIES, CONDITIONS OR OTHER TERMS, EXPRESS OR IMPLIED, STATUTORY OR OTHERWISE, ON SOFTWARE AND DOCUMENTATION FURNISHED HEREUNDER INCLUDING WITHOUT LIMITATION THE WARRANTIES OF DESIGN, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL SOLARWINDS, ITS SUPPLIERS, NOR ITS LICENSORS BE LIABLE FOR ANY DAMAGES, WHETHER ARISING IN TORT, CONTRACT OR ANY OTHER LEGAL THEORY EVEN IF SOLARWINDS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

The SolarWinds and other SolarWinds marks, identified on the SolarWinds website, as updated from SolarWinds from time to time and incorporated herein, are registered with the U.S. Patent and Trademark Office and may be registered or pending registration in other countries. All other SolarWinds trademarks may be common law marks or registered or pending registration in the United States or in other countries. All other trademarks or registered trademarks contained and/or mentioned herein are used for identification purposes only and may be trademarks or registered trademarks of their respective companies.

 

 
Last modified

Tags

Classifications

Public