Documentation forDatabase Performance Analyzer

Install DPA on Linux

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

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.

Install the fonts as system fonts in the default location

To install the fonts that DPA requires in the default location, 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

Install the fonts in a different location

In some cases, the fonts cannot be added to the default system location. For example, if the DPA server is on an Oracle Engineered System, Oracle removes the fonts from the default location each time the server is updated. Complete the following steps to add the fonts to a different folder and configure the JDK to look for them in that folder.

  1. Download the fonts and extract them in a subdirectory in the DPA directory:
    1. Run the following command to download the fonts:

      >$ wget https://yum.oracle.com/repo/OracleLinux/OL7/7/base/x86_64/getPackage/urw-fonts-2.4-16.el7.noarch.rpm

    2. Unzip the file in a target directory:

      >$ rpm2cpio urw-fonts-2.4-16.el7.noarch.rpm | cpio -idmv

    3. Copy or move the following folder containing unzipped fonts into the DPA directory:

      /usr/share/fonts/default/Type1/

      For example:

      /home/dpa/dpa_2020_2_731; /home/dpa/Type1

  2. Configure the JDK to use fonts from an external source:
    1. Create a file called fontconfig.properties in the DPA embedded Java home folder: 

      <DPA_home>/iwc/jre_linux/lib

    2. Add the following content to the fontconfig.properties file:

      >$ touch <DPA_home>/iwc/jre_linux/lib/fontconfig.properties
      >$ vi <DPA_home>/iwc/jre_linux/lib/fontconfig.properties
      ############################
      Version
      version=1
      sequence.allfonts=latin-1
      AWT X11 font paths
      awtfontpath.latin-1=<path_to_Type1_folder>
      ############################
      awtfontpath.latin-1=/home/dpa/Type1
    3. Restart DPA. DPA.

When you install future DPA upgrades, you must copy the fontconfig.properties file into the following directory for the new version:

<DPA_home>/iwc/jre_linux/lib

Install DPA

  1. Download the installation file from the SolarWinds Customer Portal.

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

  2. Create a directory to hold this version of DPA. For example: /home/dpa.
  3. Extract the downloaded TAR installation file into the new directory.
  4. 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

  5. When prompted, create a directory on the server for installation. This becomes the DPA Home directory.
  6. 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.