Installation on AWS
OpsRamp enables discovery and monitoring of your AWS resources via the Classic Gateway. By deploying the Gateway as an EC2 instance using the provided Amazon Machine Image (AMI), you can seamlessly connect your AWS environment to the OpsRamp platform for service visibility and operational insights.
Prerequisites
Before deploying the Classic Gateway on AWS, ensure your environment meets the necessary prerequisites to support a successful deployment and connection to the OpsRamp Cloud.
1. System and Server Requirements
Make sure your infrastructure meets the minimum hardware and software specifications for running the Classic Gateway virtual machine.
- For detailed requirements, refer to the Classic Gateway Prerequisites documentation.
2. Network Access and Whitelisting
To enable uninterrupted communication between the Gateway and the OpsRamp SaaS platform:
- Whitelist all required IP addresses, domains, and ports in your firewall or AWS security group settings.
- This includes endpoints necessary for registration, updates, and data transmission.
- For the complete list of required addresses, refer to the IP Whitelist documentation.
3. Proxy Configuration (Optional)
If your organization uses a proxy server for outbound traffic control:
- Access the Gateway Admin UI at https://< Gateway IP >:5480.
- Navigate to Network > Network Connection Settings.
- Configure the appropriate proxy details to ensure all outbound communication (e.g., registration, monitoring data, and tunnel connectivity) is routed correctly.
Note
This step should be performed only after the successful preparation of the Classic Gateway Virtual Machine (VM). Ensure that the VM is fully configured and operational, and that port 5480 is accessible from your network before proceeding.- Subscribe to Ubuntu 22.04 LTS (Jammy Jellyfish)
If you’re deploying the Gateway for the first time:- Ensure your AWS account is subscribed to the Ubuntu 22.04 LTS - Jammy image from the Amazon Marketplace.
- This OS version is required for compatibility with the latest Gateway build.
Installation and Registration steps
Step 1: Prepare the Classic Gateway VM
Refer to the Prepare Classic Gateway using OpsRamp Image document for details.
Step 2: Change the Default Password
After launching your Gateway EC2 instance, the first step is to secure your system by changing the default password.
To change the password,
Open the Gateway Admin UI:
- In your browser, go to https://< Gateway IP >:5480
- Replace < Gateway IP > with the actual public or private IP address of your EC2 instance.
Log in using the default credentials.
From the left menu, go to Administration > Password for password setting.
Enter a strong, secure password that follows your organization’s security policies.
Note
- If you’re accessing the Gateway Admin UI for the first time, the system will prompt you to change the default password immediately.
- This is a mandatory step and a critical security measure to prevent unauthorized access.
- Use a complex password including a mix of letters, numbers, and special characters.
Step 3: Update Hostname and IP Address (Optional but Recommended)
Customizing your Gateway’s hostname and ensuring the IP settings are accurate helps with better identification and network configuration, especially in larger environments.
To update Hostname and IP,
- Open the Gateway Admin UI. Visit https://< Gateway IP >:5480
- From the Administration menu, select Network > Hostname and IP Settings
- Enter the following details:
- Enter the desired Hostname.
- Set or verify the IP Address, Gateway, and DNS if needed.
- Apply the changes and restart the network services if prompted.
Ensure that the hostname is unique and recognizable, especially if deploying multiple Gateways.
Step 4: Register the Gateway
The final setup step is to register the Gateway so that it becomes active in the OpsRamp platform and can begin performing discovery and monitoring tasks.
To register the gateway,
- Refer to the official Register the Gateway document provided by OpsRamp.
- The guide walks you through:
- Connecting the Gateway to the OpsRamp SaaS platform
- Entering required authentication details
- Completing the registration process
Registration activates the Gateway as a collector and connects it to your client environment in OpsRamp.
Installation on Azure
Refer to the Microsoft Azure tab in the Prepare Classic Gateway using OpsRamp Image document.
Installation on GCP
Refer to the GCP tab in the Prepare Classic Gateway using OpsRamp Image document.