SolarWinds Installation Instructions

How to Integrate SolarWinds with BigPanda

Create an App Key

First create an App Key. You'll need a separate App Key for each integrated system

Select an Install Method

GUI Installer
CLI Installer

GUI Installer

Download the Installer

Please download the correct installer for the system you wish to perform the install from.

Note: You may also run the installer from a remote computer (not directly on the SolarWinds server) as long as you can access the SolarWinds REST API.

Windows

Mac OSX

Run the Installer

1. Run the BigPanda SolarWinds Setup tool you downloaded

Must be run on either the SolarWinds server or another machine which has network access to the SolarWinds server

2. Fill in the details for your SolarWinds server and admin account

Make sure that SolarWinds Server REST API URL contains the port for your SolarWinds server's REST API. If you're not sure what it is you can try the default port, 17778

3. Fill in the following for BigPanda App Key and BigPanda Token

App KeyToken
$YOUR_APP_KEY$TOKEN

4. Click Install and wait for installation to complete

Depending on how many alert configurations you have this may take a couple minutes

Validate the Install

If you wish to validate the install was sucessful, please perform the following steps.

1. Navigate to Settings > All Settings

2. Under Alerts & Reports select Manage Alerts

3. Open the Action Manager tab

4. Search for BigPanda and ensure that both the Send to BigPanda - Trigger and the Send to BigPanda - Reset actions show up

5. Ensure that both actions are assigned to all of your alerts

Troubleshooting

Please see: https://docs.bigpanda.io/docs/solarwinds#section-troubleshooting

CLI Installer

Download the Installer

Please download the correct installer for the system you wish to perform the install from.

You may also run the installer from a remote computer (not directly on the SolarWinds server) as long as you can access the SolarWinds REST API.

Windows

Mac OSX

Run the Installer

Run the CLI installer, calling the install command. Please provide the following flags:

  • -t $TOKEN
  • -k $YOUR_APP_KEY
  • -u SOLARWINDS_USERNAME
  • -p SOLARWINDS_PASSWORD
  • -d https://SOLARWINDS_SERVER:17778

eg. bigpanda-solarwinds-setup install -t $TOKEN -k $YOUR_ID -u admin -p secretpassword -d https://127.0.0.1:17778

It may take a couple minutes for the install to complete. In the event of failure you will be provided with an error message.

Flag Reference:

  • -t, --bp_api_token – BigPanda API Token
  • -k, --bp_app_key – BigPanda App Key
  • -u, --sw_username – SolarWinds Username
  • -p, --sw_password – SolarWinds Password
  • -d, --sw_server_url – SolarWinds Server URL
  • -l, --proxy – Http Proxy Address (Optional)
  • -h, --help – help for install

Validate the Install

If you wish to validate the install was sucessful, please perform the following steps.

1. Navigate to Settings > All Settings

2. Under Alerts & Reports select Manage Alerts

3. Open the Action Manager tab

4. Search for BigPanda and ensure that both the Send to BigPanda - Trigger and the Send to BigPanda - Reset actions show up

5. Ensure that both actions are assigned to all of your alerts

Troubleshooting

Please see the Solar Winds Troubleshooting documentation