This guide describes how to install the OpsRamp Agent on windows using Agent MSI file.
Step 1: Install the Microsoft Windows OS Integration
Step 2: Choose connection type (Direct or Proxy) and download the MSI file:
Step 3: Install the Agent using command line arguments
Permissions
Following are the required permissions to install the integration.
Category
Permission Type
Permission Value
Account Administration
Devices
Create
Collectors
Manage Management Profile
View
Refer to the Permission Sets document for more details on obtaining the necessary permissions.
Download the Agent MSI File
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.
Navigate to Setup > Account. The Account Details screen is displayed.
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.
Click + ADD on the Installed Integrations page. It will redirect to the Available Integrations page.
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.
Click ADD on the Microsoft Windows OS tile. The Install Windows Agent page appears.
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 MSI widget and then click Download Windows Agent MSI button to download the MSI file or copy SHA-256 checksum.
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 MSI widget and then click Download Windows Agent MSI button to download the MSI file.
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.
The file is downloaded and saved in your local system.
Install the Agent using MSI File
Navigate to the downloaded MSI file.
Open the command prompt with administrator privileges.
Using the authentication credentials from the Instructions page, run the following command to install the agent:
Note: Provide your preferred path for /custominstallationpath parameter.
If the preferred installation folder is not found, the installation process of the agent will stop and the agent will not be installed.
