After deploying the NextGen Gateway as a virtual machine, it is strongly recommended to assign a unique hostname and configure the appropriate static IP address before proceeding with the Kubernetes installation. This ensures reliable identification of the Gateway within your network and avoids potential hostname conflicts - especially in environments with multiple deployed nodes.

Update the Hostname

Terminal UI
CLI
  1. Run below command to open Terminal UI:
    opsramp-collector-start terminal-ui
  2. Use Update Hostname to change the system hostname.
    FieldDescription
    HostnameDefines the new hostname.
    Select Execute to save the entered information.
  3. Press ESC to close the Terminal UI.
To set a new hostname, use the following command:
opsramp-collector-start setup updatehostname --hostName <hostname>

Replace <new-hostname> with your desired hostname (e.g., opsramp-gateway).

Example Output:

opsramp-collector-start setup updatehostname --hostName gateway1

This command updates the hostname both at the system level and in the /etc/hosts file, ensuring consistency across network and local name resolution.

Next Steps:

  • Verify the hostname change using hostnamectl or cat /etc/hostname.

Updating the IP Address

Terminal UI
CLI
  1. Run below command to open Terminal UI:
    opsramp-collector-start terminal-ui
  2. Use Configure Network to update host network settings.
    FieldDescriptionExample
    InterfaceExisting network interface name.ens160 or eth0
    Use DHCP (IPv4)Checkbox: checked for DHCP, unchecked for static IPUnchecked for the static example below
    Static IPv4 AddressIPv4 address, optionally including CIDR prefix192.168.10.25 or 192.168.10.25/24
    Subnet Mask (IPv4)Dotted-decimal subnet mask; optional when the address includes /prefix.255.255.255.0
    Default GatewayGateway IP address.192.168.10.1
    DNS ServersComma-separated IP addresses.192.168.10.10, 192.168.10.11
    Search DomainsComma-separated domain names.corp.example.com, example.com
    Static RoutesComma-separated routes: via metric ; metric is optional.10.20.0.0/16 via 192.168.10.254 metric 100
    Select Execute to save the entered information.
  3. Press ESC to close the Terminal UI.

To change your NextGen Gateway’s network configuration from a dynamic (DHCP) IP address to a static IP address, follow these steps:

  1. Log in to the Gateway
    Login to the NextGen Gateway using the gateway-admin user account.
  2. Identify Network Interface
    Run the following command to list network interfaces and identify the active interface name:
    ip addr
  3. Modify Netplan Configuration
    Navigate to the Netplan configuration directory:
    cd /etc/netplan
    Open the existing Netplan YAML file (e.g., 50-cloud-init.yaml) with a text editor such as vi or nano:
    sudo nano 50-cloud-init.yaml
  4. Update Configuration File
    Replace the existing content with the following template, updating placeholders with your network-specific details:
    network:
  ethernets:
    <InterfaceName>:
      addresses:
        - <IpAddr>/<NetMask>
      nameservers:
        addresses:
          - <DNSserver1>
          - <DNSserver2>
      routes:
        - to: 0.0.0.0/0
          via: <DefaultGateway>
  renderer: networkd
  version: 2
    Replace the placeholders as follows:
    • <InterfaceName>: Your network interface name (e.g., ens160)
    • <IpAddr>: The static IP address to assign (e.g., 172.25.249.111)
    • <NetMask>: The subnet mask in CIDR notation (e.g., 16 for 255.255.0.0)
    • <DefaultGateway>: Your network’s default gateway IP address (e.g., 172.25.0.1)
    • <DNSserver1>, <DNSserver2>: One or more DNS server IP addresses (e.g., 172.25.1.51, 8.8.8.8)
  5. Example Configuration
    network:
  ethernets:
    ens160:
      addresses:
        - 172.25.249.111/16
      nameservers:
        addresses:
          - 172.25.1.51
          - 8.8.8.8
      routes:
        - to: 0.0.0.0/0
          via: 172.25.0.1
  renderer: networkd
  version: 2
  6. Apply the Configuration
    Save the changes and exit the editor. Then, apply the new network settings with:
    sudo netplan apply
  7. Verify the Static IP
    Confirm the static IP configuration by running:
    ip addr show <InterfaceName>

    Replace <InterfaceName> with your actual interface name.
Tabbed Interface with Table