Documentation is now available for the Fall 2020 Update release!

Deploying Gateways on Azure

Describes how to deploy the gateway on Microsoft Azure by configuring Azure and OpsRamp.

Leave Feedback

Introduction

The gateway is deployed in Azure Cloud environment to monitor and manage your resources.

Prerequisites

To obtain an Azure Gateway VDI, submit a ticket to the OpsRamp Support team (support@opsramp.com). An email is sent with the required URL to access blobs and containers.

Azure configuration

Azure configuration involves the following steps:

  1. Creating resource groups.
  2. Setting up the gateway with Storage Explorer.
  3. Creating an image.
  4. Deploying a virtual machine (VM) using the gateway image.

Step 1: Create resource groups

This step creates resource group with a storage account using an Azure account.

A resource is a manageable item that is available through Azure. Virtual machines, storage accounts, web apps, databases, and virtual networks are examples of resources.

To create resource groups:

  1. Log into the Azure account where you want to install the gateway.
  2. Create a resource group for the OpsRamp gateway:
    1. On the left pane, click Resource groups.
    2. From the Resource groups screen, click +Add.
    3. Provide the Resource group name, select the required Resource group location, and click Create.
    4. Verify that the Resource Group was created.
  3. Create a storage account within the same resource group:
    1. On the left pane, click Storage accounts and click +Add.
    2. Select the resource group that you created for the OpsRamp gateway and click Review and Create.
Storage Account

Storage Account

Step 2: Setup a gateway with Storage Explorer

To setup the OpsRamp gateway using Storage Explorer:

  1. Install Storage Explorer.
  2. Open Azure Storage Explorer and add the Azure account (the same account that you created in previous steps).
  3. Copy the OpsRamp VHD file to the Azure account and do the following:
    1. Go to Storage account and select the storage account that was created.
    2. Click the Connection icon to launch the Connect to Azure Storage screen.
    3. Select the Use a shared access signature (SAS) URI option and click Next.
    4. From the Attach with SAS URI screen, enter the Gateway blob container link (provided by OpsRamp support) and click Next.
    5. Click Connect.
      The VHD file is downloaded.
    6. Copy the OpsRamp gateway VHD file from the OpsRamp blob container to the Azure account blob container that you created.
Storage Explorer Summary

Storage Explorer Summary

Step 3: Create an image

Azure allows you to define VM images or use pre-defined images. These images can be used to create one or more VM instances that look alike.

To create a new image for the gateway:

  1. On the left pane, click +Create a resource.
  2. Enter Image in the search bar.
  3. Click Create.
  4. From the Create Image screen, provide the following:
    • Name: Enter a unique name for the gateway.
    • Subscription: Select the account for spining up the gateway.
    • Resource Group: Select the resource created for the gateway.
    • Location: Select the location from the drop-down options.
    • OS disk: Linux
    • Storage Blob: Browse and select the downloaded OpsRamp Gateway VHD file and click Create.
  5. Verify that the new image was created.
Created Image

Created Image

Step 4: Deploy a VM

To deploy a VM for the gateway using the created image:

  1. From Images list, click the name of the image for the VM.
  2. Click +Create VM, provide the following information and click Next.
    • Resource Group: Resources created for the OpsRamp gateway.
    • Virtual Machine Name: Unique name for the VM.
    • Image: Gateway image that was created.
    • Size: Minimum requirement is 2 vCPUs, 4GiB memory.
    • Authentication Type: Password or SSH public key.
  3. On the disk screen, specify Premium SSD for the OS disk type and click Next.
  4. Go to NIC network security group > Advanced and ensure that port 22 and port 5480 are allowed on the gateway.
    These ports are required for accessing the web and serial user interface.
  5. Click Next.
  6. (Optional) Configure Advanced and Tags and click Review + Create.
  7. From the Validation screen, click Create.
Deployment Complete

Deployment Complete

Gateway registration

Gateway registration includes the following steps:

  1. Creating a management profile
  2. Configuring the gateway registration

Step 1: Create a management profile

To create a management profile:

  1. Go to Setup > Device Management > Management Profile.
  2. Select the client for gateway registration.
  3. Click +Add to create a profile.
  4. From the Management Profile page, specify OpsRamp Gateway for the Profile type.
  5. Enter Profile Name and click Submit.
    Note: The activation token is automatically generated.
  6. Copy the activation token.
Management Profile - Register Gateway

Management Profile - Register Gateway

Step 2: Configure the gateway registration

After creating a management profile, configure the gateway registration using one of the following methods:

  • Gateway administration console
  • Gateway web user interface

Configuring with the administration console

To configure the gateway using the administration console:

  1. Log into the gateway VM with provided username and password.
    For default login credentials to log into the administration console, contact OpsRamp Support.
  2. From the left pane, click General.
  3. Verify that the Registration Status is Not Registered and the Tunnel Status is Not Established.
    Note: During the installation of the OpsRamp gateway, the first screen prompts you to set a hostname for the gateway. If the hostname is not provided, the gateway is identified based on the MAC Address that is displayed across the user interface.
  4. Click Network, select Use Static IP address and then click Save.
  5. To configure gateway to use Proxy, use CTRL+P to navigate to Proxy Settings. By default, Direct connection to the Internet is selected.
  6. Provide the OpsRamp server (api.opsramp.com) information and enter the activation token.
  7. Click Update Now to register the gateway to OpsRamp.
  8. Verify that the gateway is registered with OpsRamp.
Gateway Registration Success

Gateway Registration Success

Configuring with the web user interface

To configure the gateway using the web user interface:

  1. On the web browser, enter the URL using the following syntax: https://<enter Gateway IP address>:5480.
  2. From the gateway login screen, provide a default username and password.
  3. Click Network. If required, clear the Obtain an IP Address from DHCP selection and provide the static address.
  4. (Optional) Enter VLAN, Static Routing, Proxy information.
  5. From the Administration menu, click Registration and provide the activation token.
  6. Provide the OpsRamp SaaS endpoint details (app.opsramp.com) and click Activate.
  7. Verify that the Registration Status displays a Registered and Success status.
Registration URL

Registration URL