Prerequisites

Before deploying the Classic Gateway virtual machine using the OpsRamp-provided ISO, ensure that your environment meets all the necessary requirements to support a successful installation and connection to the OpsRamp Cloud platform.

  1. Supported Hypervisor
    For detailed information, refer to the Support Matrix document.

  2. System and Server Requirements
    Verify that your infrastructure meets the minimum hardware and software specifications required to run the Classic Gateway VM.
    For detailed information, refer to the Prerequisites document.

  3. Network Access and Whitelisting
    To ensure seamless communication between the Gateway and the OpsRamp SaaS platform:
    • Whitelist the required IP addresses and URLs in your firewall or security group settings.
    • For the complete list of domains and endpoints, refer to the IP Whitelist documentation.

  4. Proxy Configuration (Optional)
    If your organization uses a proxy server to control outbound traffic for security or compliance reasons:
    • To configure proxy settings, log in to the Gateway Admin UI at https://<Gateway IP>:5480 and navigate to Network > Network Connection Settings.
    • This ensures that all outbound requests from the Gateway (including registration and tunnel connectivity) are routed through the proxy.

Step 1: Download the Classic Gateway OVA

To download the Classic Gateway OVA from OpsRamp Portal, follow the steps below:

  1. From All Clients, select a client.
  2. Go to Setup > Account > Collector Profile.
  3. Click + ADD on the Collector Profiles page.
ISO download
  1. Enter the following details on the configuration page:
    • Profile Name: Provide a name for the profile you are creating.
    • Profile Type: By default, the Standard profile type is selected.
    • Description: (Optional) Add a short description for the profile.
    • Gateway Collector (Classic): Select the VIRTUAL APPLIANCE (OVA) tile. You can also choose the desired Gateway version from the available options.
ISO download
  1. Click NEXT to proceed.

  2. Finally, download the Gateway by clicking on the VIRTUAL APPLIANCE (OVA) tile.

OVA download
  1. Once the OVA is downloaded, you can proceed to the installation Step.

Step 2: Prepare the Gateway VM using OVA

Refer to the Prepare Gateway VM using OVA document for step-by-step instructions to deploy the Classic Gateway as a virtual machine using an OVA image.

Step 3: Change Password

  1. Open the Gateway Admin UI at: https://<Gateway IP>:5480.
  2. From the Administration Menu, go to Password and change the password.
    ISO download

Step 4: Update Hostname and IP Address

  1. Open the Gateway Admin UI at: https://<Gateway IP>:5480.
  2. From the Administration Menu, go to Network and update the Hostname and IP Address.
    ISO download

Step 5: Register the Gateway

Refer to the Register the Gateway document to activate the Gateway collector. This guide provides step-by-step instructions for completing the Gateway installation.