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

Install Microsoft Windows OS Integration

Refer to Install Microsoft Windows OS Integration document.

Download the Agent MSI File

Refer Download Windows Agent document.

Install the Agent

  1. Navigate to the downloaded MSI file.
  2. Right click on the MSI 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.

Configure the MSI file using the Command line

  1. Open the command window with administrator privileges.

  2. Using the authentication credentials from the Instructions, run the following command to install the agent with core functionality and all features enabled. See the following command examples for other installation options:

        msiexec.exe /i ".msi file path" /quiet WRAPPED_ARGUMENTS="/silent /apiserver={apiserver} /key={key} /secret={secret} "

    To connect using a proxy, without credentials:

        msiexec.exe /i ".msi file path" /quiet WRAPPED_ARGUMENTS="/silent /apiserver=apiserver /key=key /secret=secret /proxyip=proxyIP /proxyport=proxyport /gatewayprofileuuid=profile_UUID_of_the_gateway**"

    To connect using a proxy, using credentials:

        msiexec.exe /i ".msi file path" /quiet WRAPPED_ARGUMENTS="/silent /apiserver=apiserver /key=key /secret=secret /proxyip=proxyIP /proxyport=proxyport /gatewayprofileuuid=profile_UUID_of_the_gateway /proto=http or https /proxyusername=proxy_server_username /proxypassword=proxy_server_b64encoding_password"

    Specify the features you want to enable if you do not want all features enabled by default. Supported feature command line arguments, comma-separated, include:

    • agent:RemoteConsole
    • agent:RemoteCommand
    • agent:PatchManagement
    • agent:Automation

The following command line example uses the feature argument to enable all features:

/features=agent:RemoteConsole,agent:RemoteCommand,agent:PatchManagement,agent:Automation

The following example installs the agent with RemoteConsole and RemoteCommand features, only:

/features=agent:RemoteConsole,agent:RemoteCommand

The following example installs the agent with the auto-monitoring option enabled:

/automonitoring=true