Documentation forSolarWinds Platformand Orion Platform

Install Orion Platform products in a new environment

Complete the following tasks to install one or more Orion Platform products on a server that does not already have Orion Platform products installed.

If you have already installed one or more Orion Platform products, see one of the following topics for information about installing additional products in an existing Orion deployment:

Before you start

Use the information in this topic to access system requirements, prepare your environment, and review the list of "gotchas".

Task 1: Get the installer

If you are new to SolarWinds, you can download a trial version of any product from the product page on

If you are a SolarWinds customer, download the SolarWinds Installer from the Customer Portal:

  1. Log in to the Customer Portal.

  2. Select an SolarWinds Platform product under Latest Downloads for Your Products, and click Choose.

    In most cases, you need to download only one product module, even if you plan to install multiple products.

    To install the DPA Integration Module without SolarWinds SAM, you must download the DPAIM installer. Other product installers do not include DPAIM in the list of products. See DPAIM installation options.

  3. Click Download to download either the online or offline installer:

    • Online: Use this option if your SolarWinds Platform server has internet access. This option guarantees that you have an up-to-date installer with the latest optimizations and fixes. It is the most efficient option, because it downloads only what it needs and nothing more.

      Also use online installation to install a scalability engine, even in environments without Internet access. Installing a scalability engine doesn't require Internet access. See Install an Additional Polling Engine, Additional Web Server, or HA server for details.

    • Offline:  Use this option for installations without Internet access. The offline installer is a prepackaged file that includes everything you need for a large combination of dependencies and products.
  4. Save the installer on your SolarWinds Platform server.

Task 2: Run the installer on the primary SolarWinds Platform server

Some third-party software, such as .NET 4.8, is required. If it is not found on the server, it is downloaded and installed when you run the installer.

To minimize the time required to run the SolarWinds Installer, install .NET 4.8 on your primary SolarWinds Platform servers and all scalability engines before you run the installer.

  1. Run the installer .exe file on your primary SolarWinds Platform server as Administrator.

    If you are installing Orion Platform products in a new environment (not updating an existing installation), the Welcome page is displayed.

  2. On the Welcome page:
    1. Select the type of installation:
      • Lightweight Installation: Use this option only for evaluations, small deployments, or Enterprise Operations Console (EOC) installations. It installs SQL Server Express locally and then installs Orion Platform products as quickly as possible using global settings. You select only the installation location and your preferred product language.

        SQL Server Express has a 10 GB storage limit, which is not sufficient for many Orion deployments. If you choose Lightweight Installation and later require a larger database, you must migrate to a SQL Server Standard or Enterprise database.

      • Standard Installation: Install Orion Platform products with an existing or licensed SQL Server Standard or Enterprise database.

      • Add a scalability engine: Install an Additional Polling Engine, Additional Web Server, or High Availability server. If you are installing a new scalability engine, see Install an Additional Polling Engine, Additional Web Server, or HA server.

    2. Set the Destination Folder.

      Orion Platform products cannot be installed on a remote mapped drive, read-only drive, compressed drive, or compressed HDD.

    3. Click Next.

      The Select Products page lists the products that you can install.

      • HF indicates a hotfix.
      • RC indicates a release candidate.
  3. On the Select Products page:

    1. Select the products to install.

    2. Select the language of the installed products.

      You cannot change the language after installation.

    3. Click Next.
  4. On the Install Report page, review the information under System Check Results.

    The installer runs a series of checks per product to verify that your server meets system requirements and recommendations. If your environment does not meet specifications, the installer displays one or more messages:

    • Informational and warning messages recommend actions and best practices to optimize performance. These do not block the installation.

    • Critical issues describe changes that are required to support the products. These block the installation until they are resolved.

    1. Investigate and resolve any issues:

      • Click the details link to display additional information and suggested resolutions.
      • To save the list of issues, click Save System Check Results.
      • After resolving any blocking issues, click Run Checks Again.
    2. Click Next.
  5. Review the EULA. If you agree, click I accept, and then click Next.

    The Installation page displays progress messages. If the installer encounters any issues, the installation stops so you can resolve them. The installer might run multiple product installations before running the Configuration wizard.

    If a reboot is required as part of the installation, a message is displayed.

Task 3: Complete the Configuration wizard

If database configuration is required, the Configuration wizard automatically opens. Depending on your products, the wizard might include options and pages not described here.

  1. On the Welcome page, click Next.
  2. If prompted to stop services, click Yes.
  3. If you performed a Standard installation with an existing SQL Server database, select one of the following for authentication:
    • Authenticate as currently logged in user: Pass through authentication to the database server using the account currently logged in for installing the Orion Platform product.

    • Switch user: Provide credentials automatically detected as either SQL or Windows credentials, allowing Windows authentication for the initial setup even if the SolarWinds Platform server is not joined to a domain or the current account does not have permissions to the database server.

    If you intend to use Windows authentication for the Orion Platform, remember to exempt that user account from any password change policies. An expired password will cause the Orion Platform to stop data collection and interrupt SolarWinds Platform Web Console access.

  4. On the Database Settings page, select your existing SolarWinds Platform database, or create a new database for a new installation, and click Next.
  5. On the Database Account page, create an account or specify an existing account that the polling engine and SolarWinds Platform Web Console will use to access the database. The account can be a Windows or SQL Server account.

  6. On the Website Settings page:
    1. Select All Unassigned unless your environment requires a specific IP address for the Orion website. If SSL is selected, port 443 is used. Otherwise, port 80 is used.
    2. Specify the Port and the Website Root Directory where the system installs the web console files.

      If you specify any port other than 80, include that port in the URL used to access the SolarWinds Platform Web Console.

    3. To configure SSL, click Enable HTTPS and select your SSL certificate.

      If a certificate is not available, select the option to Generate Self-Signed Certificate. The Configuration wizard automatically generates a self-signed certificate issued to the hostname or FQDN and adds it to the trusted certificate store.

      If you select Skip website binding, the Configuration wizard does not make changes within the website configuration in your IIS. This option prevents IP address, port, and SSL certificate options.

  7. If prompted to create a directory or website, click Yes.
  8. Review the list of services to install, and click Next.
  9. Click Yes if prompted to disable the SNMP Trap Service and enable the SolarWinds Trap Service.
  10. On the Completing the Orion Configuration Wizard page, click Next.
  11. When the configuration is complete, click Finish to launch the SolarWinds Platform Web Console.

    If the SolarWinds Platform Web Console doesn't open automatically (for example, if it times out before opening), do one of the following to open it manually:

    • Click Start > All Programs > SolarWinds > SolarWinds Platform Web Console.

    • Open a web browser on your SolarWinds Platform server and enter http://ipAddress or http://hostname, where ipAddress is the IP address of your server and hostname is the host name of your server. Enter https:// if you selected SSL.

  1. Log in with user name admin. Enter a password for the admin account, confirm the password, and then click Save & Login.

Task 4: Activate licenses

Activate the licenses for your new products.

Get the license key for your product from the Customer Portal. You might need multiple licenses: one for each product, HA backup server, additional polling engine, and additional Web server.

  1. In the Customer Portal, select License Management.
  2. Select the product.
  3. Copy the license key.

Add and activate the license key using the web-based License Manager in the SolarWinds Platform Web Console.

  1. Open the SolarWinds Platform Web Console in a web browser.
  2. Click Settings > All Settings > License Manager.
  3. Click Add/Upgrade License.
  4. Enter the Activation Key and Registration Information, and click Activate.

To activate an offline license, see Activate licenses offline.