This topic describes how to install and register the gateway on Windows.

Prerequisite

Ensure the Windows Gateway Requirements are met.

Download and install

  1. Go to Setup > Downloads > Gateway and download Installer for Windows OS.
  2. Run the installer .exe file as an Administrator to start the installation.
  • Windows Gateway is a silent installation.
  • To check the progress of the installation, go to the C:\Windows\Temp folder and open the OpsRampWindowsGatewayInstallation log file.

The log file includes installation details.

A confirmation message displays when the installation is complete.

Register the gateway

To register Gateway, create a management profile in the console and register using the command line interface.

Step 1: Create a management profile

Create a management profile and copy the command required for registration.

  1. Go to Setup > Resources > Management Profiles.
  2. Click +Add to create a profile.
  3. From the Management Profile page, select the Client Name for gateway registration.
  4. Select Gateway for the Profile type.
  5. Enter a Profile Name.
  6. Enter a Profile Description and click Submit.. The details are displayed on the View Management Profile page. The How to Activate a gateway? section displays steps to activate the gateway.
  7. Follow the instructions and register the gateway.

Step 2: Register using the command-line interface

You can register and activate Windows Gateway with one of the following options:

  • Direct connection
  • Proxy server

Direct connection

Register Windows Gateway directly.

  1. Log in to the Windows server where you installed the Windows Gateway application.
  2. Open the command prompt as an administrator.
  3. Paste the command under the option Gateway Installed on Windows platform copied from the View Management Profile page and press Enter.

The status of the registration is displayed in the command prompt. Example:

    cd "C:\Program Files\OpsRamp\Gateway\bin"
    GatewayConfig.exe --api_server  *.api.opsramp.net --activation_key  8120d33a-b301-482d-841c-1f562f3abcde

Proxy connection

You can register Windows Gateway using a proxy server in the following ways:

  • Register without authentication
  • Register with Authentication

Register the Windows gateway without authentication:

  1. Log in to the Windows server where you installed the Windows Gateway application.
  2. Open the command prompt as an administrator.
  3. Copy the command from the View Management Profile page and add the parameters, proxy_ipand proxy_port.
  4. Press Enter to run the command.

The status of the registration is displayed in the command prompt. Example:

   cd "C:\Program Files\OpsRamp\Gateway\bin"
    GatewayConfig.exe --api_server  *.api.opsramp.net --activation_key 8120d33a-b301-482d-841c-1f562f3abcde --proxy_ip 192.168.1.2 --proxy_port  3128

Register the Windows Gateway with authentication:

  1. Log in to the Windows server where you installed the Windows Gateway application.
  2. Open the command prompt as an administrator.
  3. Copy the command from the View Management Profile page and add the parameters, proxy_ip, proxy_port, proxy_username, and proxy_password.
  4. Press Enter to run the command. The status of the registration is displayed in the command prompt.

Example:

    cd "C:\Program Files\OpsRamp\Gateway\bin"
    GatewayConfig.exe --api_server  *.api.opsramp.net --activation_key 8120d33a-b301-482d-841c-1f562f3abcde --proxy_ip 192.168.1.1 --proxy_port  3128 --proxy_username admin --proxy_password Pass@1234

Follow Guidelines and Limitations for Windows gateway: