Documentation forSolarWinds Platformand Orion Platform

Install an additional polling engine, additional web server, or high availability server

Use the SolarWinds Installer to install scalability engines (additional polling engines, additional web servers, and high availability backup servers).

Additional polling engines (APEs) or an additional web server (AWS) can be used to increase the monitoring capacity of your Orion Platform products. High availability (HA) provides a backup server to protect your main SolarWinds Platform server.

Requirements and recommendations

Before you begin, be sure your scalability engine servers meet the following requirements:

  • Installing an APE and an AWS on the same host is not supported.

  • All APEs must be set to the same time zone as the SolarWinds Platform database server.

    If APEs and the SolarWinds Platform database server are set to different time zones, polled data can be confusing or misleading. For example, data can have a time stamp that is in the future.

  • The main polling engine and the APE must be able to resolve each other's host names to an IP address.

  • Orion Platform 2017.3 HF3 or later is required to install scalability engines with the SolarWinds Installer.

    To determine the Orion Platform version, log in to the SolarWinds Platform Web Console and find the Orion Platform version in the footer. If the version is between 2016.2 and 2017.3 HF2, use the legacy Orion Scalability Engine Installer.

SolarWinds recommends using the online installer to install scalability engines, even if the server does not have access to the Internet. Internet access is not required. When you install a scalability engine, the installer downloads the required product information from your primary SolarWinds Platform server.

Prepare for the installation

Before you install a scalability engine in your environment, complete the following actions:

Install or upgrade the primary SolarWinds Platform server first. Then install each APE.

When you install an APE or AWS, verify the port requirements:

If you are going to install a backup server for High Availability, review the SolarWinds High Availability requirements.
Acquire a user name and password with administrative privileges to the SolarWinds Platform Web Console on your primary SolarWinds Platform server.
Be sure the APE uses the same SolarWinds Platform database as the primary SolarWinds Platform server.
Verify the latency between your SolarWinds Platform database server and the APE. Performance degradation can begin around 200 ms. Ping the SolarWinds Platform database server to find the current latency.
If you configured an alert with a Send Email action to trigger on a node monitored by an APE, confirm that the APE can access your SMTP server.

Add the IP address of your APE to Windows Servers on the Security tab.

Make sure that the following options are set:

  • Ensure that a case-sensitive community name has been specified.
  • Ensure that Accept SNMP packets from any host is selected or ensure that the APE is listed within the Accept SNMP packets from these hosts list.
  • Ensure that your network devices allow SNMP access from the new polling engine. For example, on Cisco devices, you can modify the Access Control List.

Install the scalability engine

Task 1: Download the installer

  1. Download the online installer from either of the following locations:
    • Download the online installer from the Customer Portal.

      To install a scalability engine, the online installer does not require Internet access.

      1. Log in to the Customer Portal.
      2. Under Latest Downloads for Your Products, locate one of your SolarWinds Platform products and click Choose.
      3. In the online installation box, click Download.
    • Download the installer through the SolarWinds Platform Web Console (HA Deployment Summary page):
      1. Click Settings > All Settings.
      2. Under Product Specific Settings, click High Availability Deployment Summary.
      3. Click Set Up a New HA Server.
      4. Click the How Do I Set It Up tab, and then click Download the Orion HA Installer.
      5. Click the Download Installer Now button.
    • Download the installer through the SolarWinds Platform Web Console (Polling Engines page):

      1. Click Settings > All Settings.

      2. Under Details, click Polling Engines.

      3. Click the Download Installer Now button.

  2. Save the installer on the server where you want to install the APE, AWS, or HA backup server.

Task 2: Run the installer

The installer checks your main polling engine for products and versions, and then it downloads the latest versions and any hotfixes from the main polling engine .

Keep the Orion services running on the main polling engine when installing an additional polling engine or additional web server.

  1. Run the installer .exe file on your scalability engine server as Administrator.

    The Welcome screen is displayed. (If you do not see the Welcome screen, you have already installed Orion Platform components on the server.)

  2. On the Welcome screen:
    1. Select Add a Scalability Engine.
    2. Set the Destination Folder.

      You cannot install on a remote mapped drive, read-only drive, compressed drive, or compressed HDD.

    3. Click Next.
  3. Enter the following information, and then click Next:

    • IP address or host name of your primary SolarWinds Platform server
    • User name and password used to log in to the SolarWinds Platform server

    The installer connects to your SolarWinds Platform server and verifies compatibility.

  4. Select the type of scalability engine to install, and then click Next.

    Option Description
    Additional Polling Engine Installs an APE that collects data for any Orion Platform product.

    Additional Polling Engine for Server & Application Monitor, Server Configuration Manager, Storage Resource Monitor, Virtualization Manager, or Log Analyzer

    The exact text for this option varies depending on which products you use.

    Installs an APE that does not require a license for SAM, SCM, SRM, VMAN, and LA users. These APEs collect only SAM, SCM, SRM, VMAN, or LA data.

    You cannot use multiple licenses (also known as stacked licenses) on this type of APE.

    Additional Website Installs an Additional Web Server.
    High Availability - Backup Server for Main Server Protection Installs a secondary server in an HA pair to protect the Orion primary server. All modules that are installed on your primary server will also be installed on this server.
    High Availability - Backup Server for Orion module Additional Polling Engine(s) Installs a secondary server in an HA pair to protect one or more Additional Polling Engines.
    High Availability - Backup Server for Storage Resource Monitor or Virtualization Manager Additional Polling Engine(s) Installs a secondary server in an HA pair to protect an SRM or VMAN Additional Polling Engine.
  5. 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.
  6. Review the EULA. If you agree, click the accept option, 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

When the installation is complete, the Configuration wizard opens. Depending on the component you installed, the wizard might include additional options and screens.

  1. In the Welcome dialog box, click Next.
  2. If prompted to stop services, click Yes.
  3. On the Database Settings panel:
    1. Select your existing Orion SQL server.
    2. Select the authentication method used by your existing SolarWinds Platform database, and enter login credentials if necessary.
    3. Click Next.
  4. If you receive a warning message that the user does not have permission to create a new database, click OK.
  5. Select your existing database from the drop-down menu, and click Next.
  6. If you receive a message that the user does not have permission to create a new database account, click OK.
  7. Select your SQL Server account and enter your password.
  8. At the SNMP Trap Service not disabled message, click Yes.
  9. Click Next to start the configuration.

Task 4: For an APE, specify the nodes to be polled

If you installed an additional polling engine, specify which nodes you want it to poll.