Documentation forSolarWinds Platform

Install SolarWinds Platform products in a new environment

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

If you're installing EOC, it must be installed on its own server. To install EOC, download the appropriate installer and run it, as described in the following sections. The installer automatically installs only EOC.

Before you start

Use the information in this topic to access system requirements and prepare your environment.

SolarWinds strongly recommends that you install the SolarWinds Platform on a server that is neither public, nor internet-facing. To learn about best practices for configuring your SolarWinds Platform installation securely, see Secure Configuration for the SolarWinds Platform.

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 https://www.solarwinds.com.

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

  1. Log in to the Customer Portal.

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

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

  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.

      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.
  4. Save the installer on your SolarWinds Platform server.

Task 2: Run the installer on the main 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.

  2. On the Welcome page, click Start.

  3. On the Installation Type page, click Standard Platform. Then click Next.

    To install a scalability engine, see Install an additional polling engine, additional web server, or SolarWinds Platform high availability server.

  4. On the License Agreement page, review the EULA. If you agree, select the checkbox, and then click Next.

  5. On the Installation Options page:
    1. Under SQL Server, select one of the following: 

      • For a standard installation (for example, in a production environment), select Use SQL Server.

        A dedicated, separate SQL Server Standard or Enterprise database (physical or virtual machine) must be available on the SolarWinds Platform database server. For the requirements for the SolarWinds Platform database, see the SolarWinds Platform System Requirements. For Microsoft SQL Server installation instructions, see the SQL Server Installation Guide.

      • For a lightweight installation, select Install SQL Server Express.

        SQL Server Express is approved only for evaluations. This option installs SQL Server Express locally and then installs SolarWinds 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 SolarWinds Platform deployments. If you later require a larger database, you must migrate to a SQL Server Standard or Enterprise database.

    2. Choose the language.

      This cannot be changed later.

    3. (Optional) If you do not want to install SolarWinds Platform products in the default location, browse to the desired location and select it.

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

    4. Click Next.

      The installer performs a system check to ensure that your environment meets the minimum requirements and to look for any potential problems. The results of the system check are displayed on the Installation Report page.

  6. On the Installation Report page:

    1. Review the results of the system check. If any issues were found, 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.

    2. If any issues were found, click the to see detailed information about the issue.
    3. If there are issues that prevent installation, resolve them and click Retest to run the system check again.
    4. Click Install to start the installation.

      When the installation is complete, a confirmation 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 SolarWinds 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 SolarWinds Platform, remember to exempt that user account from any password change policies. An expired password will cause the SolarWinds 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 SolarWinds Platform website. If SSL is selected, port 443 is used. Otherwise, port 80 is used.
    2. Specify the Port.

      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 you are prompted to create a directory or website, click Yes.
  8. Review the list of services to install, and click Next.
  9. Click Yes if you are prompted to disable the SNMP Trap Service and enable the SolarWinds Trap Service.
  10. On the Completing 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.