Documentation forDatabase Performance Analyzer

Install DPA on a Linux-based OS

To install DPA on a different platform, see Install DPA on Windows, Install DPA on Azure Marketplace, or Launch DPA on Amazon Web Services.

SolarWinds strongly recommends that you install Database Performance Analyzer on a server that is neither public, nor internet-facing. To learn about best practices for configuring your Database Performance Analyzer installation securely, see Best practices to secure SolarWinds Products.

Before you start

Before you install Database Performance Analyzer, be sure to review the pre-installation checklist.

Install the required fonts

If the required fonts are not installed, you will receive a Status 500 Internal Server Error when you attempt to start DPA. For more information, see this article.

To install the fonts that DPA requires, run one of the following commands on the DPA server:

  • For Deb-based distributions (for example, Debian and Ubuntu):

    apt-get install fontconfig

  • For RPM-based Linux distributions (for example, RHEL, Fedora, and CentOS):

    yum install urw-fonts

Download the installation file and verify the signature

To verify that the installation file is unmodified, use a public key to confirm that the signature of the installation file matches the signature of the corresponding .sig file.

  1. Download the installation file and the corresponding .sig file from the SolarWinds Customer Portal. The file names are as follows, where YYYY-Q-BBBB is the DPA version number:

    • Installation file: SolarWinds-DPA-YYYY-Q-BBBB-64bit.tar.gz
    • Signature file: SolarWinds-DPA-YYYY-Q-BBBB-64bit.tar.gz.sig

    If you have not yet created a SolarWinds account, see Access the Customer Portal to create an account.

  2. Copy one of the following public keys into a file, name the file public.pem, and save it in the same directory as the tar.gz and tar.gz.sig files:

    • If you are installing DPA 2023.2 or later, copy the following public key:

      -----BEGIN PUBLIC KEY----- 
MIGbMBAGByqGSM49AgEGBSuBBAAjA4GGAAQBwzDldHd3s548ogwcCVTRF2WXcfJj
BIfElvDzX+5zjDghxCJzFO4pXSMtUFoB2fD2BGjVgdcZRDRacrv/9GS52fcBV9sY
qRjkQVVzsodD02QokDTnTLOAig4LMvnEJWO1F8UGM5gbiaXtuUNMFNEFElCN3FH6
a8eT4QRV5XoKNZz3mo4=
-----END PUBLIC KEY-----

    • If you are installing DPA 2023.1 or earlier, copy the following public key:

      -----BEGIN PUBLIC KEY-----
MIGbMBAGByqGSM49AgEGBSuBBAAjA4GGAAQAOmd4V9OCdJF2cZ73G2IqrW9G/3Ny
Qeh2jOwg0VJaCecsNxXmpsjvJ2YMQJHMBddB++c81ys3NLwUGsJswxm/rCMA7bN1
q/zOV3oCoDfvXN2B6o1kTMJNebF6VDBc+c2phlrkJDjctSSVigTxYpZ33bgX9IxZ
NImi0LvVvOSNaQi1jR4=
-----END PUBLIC KEY-----

  3. Run one of the following commands to verify the signature:

    openssl dgst -sha512 -keyform PEM -verify public.pem -signature <signature_file_name> <dpa_installer_file_name>
 
Expect: Verified OK

    or

    openssl dgst -binary -sha512 <dpa_installer_file_name> > digest.bin
openssl pkeyutl -verify -pubin -keyform PEM -inkey public.pem -in digest.bin -sigfile <signature_file_name>
 
Expect: Signature Verified Successfully

Install DPA

  1. Create a directory to hold this version of DPA. For example: /home/dpa.
  2. Extract the downloaded TAR installation file into the new directory.
  3. Use either of the following methods to run the dpa_version_installer.sh script from the command line:

    • Make it executable and run it directly:

      chmod +x dpa_version_installer.sh

      ./dpa_version_installer.sh

    • Run it in the shell:

      sh dpa_version_installer.sh

  4. When prompted, create a directory on the server for installation. This becomes the DPA Home directory.

  5. Start DPA by running the following command from the Home directory:

    ./startup.sh

Next steps

Go to https://yourServer:8124 in a web browser and create the repository database.