This topic describes how to install and register the gateway on Windows.
Prerequisite
Ensure the Windows Gateway Requirements are met.
Download and install
- Go to Setup > Downloads > Gateway and download Installer for Windows OS.
- 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 theOpsRampWindowsGatewayInstallation
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.
- Go to Setup > Resources > Management Profiles.
- Click +Add to create a profile.
- From the Management Profile page, select the Client Name for gateway registration.
- Select Gateway for the Profile type.
- Enter a Profile Name.
- 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.
- 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.
- Log in to the Windows server where you installed the Windows Gateway application.
- Open the command prompt as an administrator.
- 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:
- Log in to the Windows server where you installed the Windows Gateway application.
- Open the command prompt as an administrator.
- Copy the command from the View Management Profile page and add the parameters,
proxy_ip
andproxy_port
. - 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:
- Log in to the Windows server where you installed the Windows Gateway application.
- Open the command prompt as an administrator.
- Copy the command from the View Management Profile page and add the parameters,
proxy_ip
,proxy_port
,proxy_username
, andproxy_password
. - 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
Note
Supported Windows OS installation language for Windows Gateway: EnglishFollow Guidelines and Limitations for Windows gateway: