This guide describes how to install the OpsRamp Agent on windows using Agent EXE file.

  • Step 1: Configure and Install the Microsoft Windows OS Integration
  • Step 2: Choose connection type (Direct or Proxy) and download the EXE file:
  • Step 3: Install the Agent with Admin

Permissions

Following are the required permissions to install the integration.

CategoryPermission TypePermission Value
Account AdministrationDevicesCreate
CollectorsManage Management ProfileView

Refer to the Permission Sets document for more details on obtaining the necessary permissions.

Download the Agent

  1. To select your client, navigate to All Clients, and click the Client/Partner dropdown menu.
    Note: You may either type your client’s name in the search bar or select your client from the list.
  2. Navigate to Setup > Account. The Account Details screen is displayed.
  3. Click Integrations. The Installed Integrations screen is displayed with all the installed applications.
    Note: If you do not have any installed applications, you will be navigated to the Available Integrations page with all the available applications.
  4. Click + ADD on the Installed Integrations page. It will redirect to the Available Integrations page.
  5. Search for the integration (Microsoft Windows OS) either by entering the name of the integration in the search bar or by selecting the category (Servers and VMs) from the All Categories dropdown list.
  6. Click ADD on the Microsoft Windows OS tile. The Install Windows Agent page appears.
  7. Select your agent connection type and platform to download and install agent on the machines you want to manage. Note: Do not modify the file name of the Agent installer during the installation. Agent installs in silent mode and does not require a reboot.
    • If you selected Agent Type as Direct, then
      • Click on Windows Agent EXE widget and then click Download Windows Agent EXE button to download the EXE file or copy SHA-256 checksum.
      • Enter the Email id to download the URL.
      • You can refer the instruction page to see the downloadable steps (optional).
    • If you selected Agent Type as Proxy, then
      • From the Primary proxy profile section, select the primary proxy profile.
      • To include the secondary proxy profile, enable the “Add Secondary Proxy” checkbox. (Optional)
      • Once enabled, select the secondary proxy profile from the dropdown list.
      • Now, click on Windows Agent EXE widget and then click Download Windows Agent EXE button to download the EXE file.
      • Enter the Email id to download the URL.
      • You can refer the instruction page to see the downloadable steps (optional).
        Note: Make sure that you verify the SHA-256 checksum of the downloaded file.
  8. The file is downloaded and saved in your local system.

Install the Agent

  1. Navigate to the downloaded EXE file.
  2. Right click on the EXE file and Run as administrator.
  3. Silent installation process will start automatically.
  4. The server appears on the OpsRamp Infrastructure page within a few seconds.
  5. You do not need to reboot your system after installation.

View the installation logs in the C:\Windows\Temp\OpsRampAgentInstallation.log.

Uninstall the Agent

  1. Open the control panel.
  2. Right click on the OpsRamp Agent and Uninstall.

See the C:\Windows\Temp\OpsRampAgentUninstallation.log file for uninstall progress.