Documentation forDatabase Performance Analyzer

Upgrade DPA on Windows

If you are upgrading from DPA 2022.3 and you configured DPA 2022.3 for SAML authentication, be aware that DPA 2022.4 and later include changes to the SAML configuration. After the upgrade, no one will be able to log in with SAML until you update the configuration.

  • Before you upgrade, make sure you have a local login available.

  • After the upgrade, log in as a local user and complete the steps under "SAML configuration changes" in the DPA 2022.4 Release Notes to update the SAML configuration.

The log created during a Windows installation is located in C:\Programdata\Solawinds\DPA\installer\log.

  1. Review the upgrade checklist and prepare your environment.
  2. Download the most recent version of DPA from the SolarWinds Customer Portal.
  3. Log in to the Windows server as an administrator.
  4. Run the installer.

  5. Extract the contents of the downloaded installation ZIP file.

  6. Run SolarWindsDPASetup-x64.exe. When the installer starts, click Next.
  7. If you accept the terms of the license agreement, select I accept. Click Next.

  8. Click Next, and then click Install to start the upgrade.

  9. When the upgrade is complete, click Finish.

    If one or more DPA licenses are expired, you must remove the expired licenses before DPA can complete the repository upgrade. When all licenses are compliant, you can complete the upgrade process by opening DPA and clicking Proceed with upgrade.

If you are upgrading from DPA 2024.4.200 or earlier to DPA 2025.2 and added or changed any of the additional properties within the server.xml file, you need to manually configure those properties. The DPA installer will create a backup of the server.xml in the format appended with date, for example: server-20250513-083327-backup.

Manually update the new server.xml file at C:\Program Files\SolarWinds\DPA\iwc\tomcat\conf\server.xml. Map the old properties to the new properties as shown in the table below.

Old Property New Property Formatting example
keystoreType="PKCS12" certificateKeystoreType="PKCS12"

The updated format should look like the example below.

<SSLHostConfig hostName="dpasslhost"> <Certificate certificateKeystoreFile="conf/.keystore" certificateKeystoreType="PKCS12" type="RSA" /> </SSLHostConfig>

keystorePass="password" certificateKeystorePassword="password"

The updated format should look like the example below.

<SSLHostConfig hostName="dpasslhost"><Certificate certificateKeystoreFile="conf/.keystore"certificateKeystoreType="PKCS12"certificateKeyAlias="somealias"certificateKeystorePassword="password"certificateKeyPassword="keypassword"type="RSA" /></SSLHostConfig>
keyPass="keypassword" certificateKeyPassword="keypassword"

The updated format should look like the example below.

<SSLHostConfig hostName="dpasslhost"><Certificate certificateKeystoreFile="conf/.keystore"certificateKeystoreType="PKCS12"certificateKeyAlias="somealias"certificateKeystorePassword="password"certificateKeyPassword="keypassword"type="RSA" /></SSLHostConfig>
keyAlias="somealias" certificateKeyAlias="somealias"

The updated format should look like the example below.

<SSLHostConfig hostName="dpasslhost"><Certificate certificateKeystoreFile="conf/.keystore"certificateKeystoreType="PKCS12"certificateKeyAlias="somealias"certificateKeystorePassword="password"certificateKeyPassword="keypassword"type="RSA" /></SSLHostConfig>