Documentation forAppOptics

Installation - Windows

Installation with TLS encrypted REST API is not supported in Windows environments. The REST API is exposed over a named pipe with access restricted to the "solarwinds" user or to users with elevated privileges

Easy installation

Click Infrastructure in the AppOptics side navigation to add a new host. If you are not automatically redirected to the onboarding wizard, click the settings icon in the top right corner to add a host. The onboarding wizard steps you through installing the SolarWinds Snap Agent:

  1. Download agent msi installer from https://files.solarwinds.cloud/windows-solarwinds-snap-agent/solarwinds-snap-agent.msi
  2. Run the installer as Administrator and provide your API key when requested. The installer also supports command line installation.

If agent installation fails, you can check the C:\ProgramData\SolarWinds\Snap\log directory for the installation log file.

Advanced Installation

Follow these steps to manually and install the agent:

  1. Download agent msi installer from https://files.solarwinds.cloud/windows-solarwinds-snap-agent/solarwinds-snap-agent.msi

  2. Copy solarwinds-snap-agent.msi file to a temporary location like C:\temp.

  3. Open a command prompt as Administrator and run following command with your API token:

    set SOLARWINDS_TOKEN=<your api token>
msiexec /q /lv* swisnap.log /i c:\temp\solarwinds-snap-agent.msi EULA=accept TOKEN=%SOLARWINDS_TOKEN%

Read more about msiexec Command-Line Options.

If agent installation fails, you can check c:\temp\swisnap.log for any installation errors.

Upgrade

To find the easy installation guide, go to the AppOptics home page and click on the "Add Host" button. It will show you the steps to install the agent via our msi package:

  1. Download agent msi installer from https://files.solarwinds.cloud/windows-solarwinds-snap-agent/solarwinds-snap-agent.msi
  2. Run the installer as Administrator.

If you've made local changes to C:\ProgramData\SolarWinds\Snap\config.yaml or default task files under C:\ProgramData\SolarWinds\Snap\tasks.d, the package manager should preserve those changes either by default or with an optional setting, please refer to your package manager manual for details.

Troubleshooting

To learn more about how to restart the SolarWinds Snap Agent, where its log file is located, and other common troubleshooting techniques, please check the Troubleshooting page.

Uninstall

You can uninstall the SolarWinds Snap Agent software from the Programs and Features Control Panel. The SolarWinds Snap Agent will be automatically removed from the Infastructure Host view after 60 minutes.

Navigation Notice: When the APM Integrated Experience is enabled, AppOptics shares a common navigation and enhanced feature set with other integrated experience products. How you navigate AppOptics and access its features may vary from these instructions.

The scripts are not supported under any SolarWinds support program or service. The scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The risk arising out of the use or performance of the scripts and documentation stays with you. In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation.