You can use Web Admin or the Admin API to change the configuration of a monitoring point to use a static IP address instead of a DHCP-assigned address, or assign a different static IP address.

Potential loss of connectivity: Care must be taken when changing the IP address on the primary network connection. If the new address is in a different subnet than the old one, you’ll lose network connectivity to the monitoring point after restarting networking.

Web admin

  1. Log in to web admin.
  2. Click Network Configuration.
  3. Click on an existing interface.
  4. Make your changes.
  5. Restart networking.

Web admin

  1. Log in to web admin.
  2. Navigate to Network Settings > Network Interfaces.
  3. Click > Edit.
  4. For Addressing select Static.
  5. Make your changes.
  6. Restart networking.

Admin API

  1. In APM, navigate to > Manage Monitoring Points.
  2. Find the hostname of your monitoring point in the Name column of the table.
  3. Access the Admin API using https://<hostname>/swagger/index.html.
    • Substitute <hostname> with the hostname of your monitoring point.
  4. Determine which interfaces are already configured.
    1. Navigate to Interface > GET /interface/ and click Submit.
      • The Response Body section shows the configured interfaces.
  5. Set a static IP address for an interface using the following JSON text.

    {
      "name": "<interface_name>",
      "method": "static",
      "address": "<address>",
      "netmask": "<netmask>",
      "gateway": "<gateway>"
    }
    
    1. Substitute the appropriate values for <interface_name>, <address>, <netmask>, and <gateway> in the text above and copy it to the clipboard.
      • <address> - the IP address you are adding to the interface. Either an IPv4 or an IPv6 address can be specified.
      • <gateway> - (optional) the IP address of the gateway the monitoring point uses to access the Internet for the configured address. If not specified, the default gateway configured on the interface is used.
      • <interface_name> - the name of the interface you are configuring.
      • <netmask> - the netmask of the IP address you are adding. Use a prefix (e.g., 64) for IPv6. Use either a prefix or a dotted decimal mask (e.g., 255.255.255.0) for IPv4.
    2. Navigate to Interface > POST /interface/.
    3. In the Parameters section, paste the clipboard to the body field.
    4. Click Submit.
      • In the Response Body section, look for "success": true to confirm that the interface creation was successful.
  6. Restart networking to apply the changes.
    1. Navigate to Service > PUT /service/{service_name}/.
    2. In the Parameters section:
      1. Set service_name to “networking”.
      2. Set action to “restart”.
      3. Click Submit.
        • You will briefly lose connectivity to the admin API.
  7. Verify that the changes were properly applied.
    1. Navigate to Interface > GET /interface/{interface_name}/address/.
    2. In the Parameters section:
      1. Set interface_name to the name of the interface you configured.
      2. Set config_state to “active”.
      3. Set family as appropriate for IPv4 or IPv6 addressing.
      4. Click Submit.
        • The Response Body section shows the addresses configured on the interface.