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, see this knowledge article.

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.

Upgrades from DPA 2024.4.200 and earlier

If you are upgrading from DPA 2024.4.200 and earlier and added or changed any of the additional properties within the server.xml file, you must manually configure those properties. This is required, for example, if you are using a custom SSL certificate.

The DPA installer creates a backup of the server.xml file. The file name is appended with the 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 tables below.

  1. Open the new server.xml file in a text editor:

    C:\Program Files\SolarWinds\DPA\iwc\tomcat\conf\server.xml

  2. Change the values of the following properties to match the corresponding property from your old server.xml file.

    Old property New property
    keystoreFile="conf/.keystore" certificateKeystoreFile="conf/.keystore"
    keystoreType="PKCS12" certificateKeystoreType="PKCS12"

    The file should look similar to the following example:

    <SSLHostConfig hostName="dpasslhost">
     <Certificate certificateKeystoreFile="conf/.keystore"
         certificateKeystoreType="PKCS12"
         type="RSA" />
    </SSLHostConfig>
  3. If the following properties are present in the old server.xml file, add the corresponding property to the SSLHostConfig property in the new server.xml file.

    Add only the properties that were already in your server.xml file. If a property listed below was not in the old file, do not add it to the new file.

    Old property New property
    keystorePass="password" certificateKeystorePassword="password"
    keyPass="keypassword" certificateKeyPassword="keypassword"
    keyAlias="alias" certificateKeyAlias="alias"

    The new SSLHostConfig property within the Connector property should look similar to the following example:

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