Some monitoring point models (m22, m30, r40 and r400) support configuring either DHCP or a single static IP address on an interface. These support IPv4 addressing.

The other models support configuring DHCP and/or multiple static IP addresses on an interface. For these, up to 128 IP addresses can be configured on an interface and at least one is required (either static or DHCP). Both IPv4 and IPv6 addresses are supported in these cases. Multiple static IP addresses are supported on Ethernet, VLAN, and Wireless interface types.

While it is possible to configure multiple IPv6 addresses, policy routing for IPv6 is not supported at this time.

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 will lose network connectivity to the monitoring point after restarting networking.

View addresses

Web admin

  1. Log in to Web Admin.
  2. Navigate to Network Settings > Network Interfaces.
  3. For the interface you want to view, the Active column contains the interface IP address.

Admin API

  1. Log in to Admin API.
  2. Navigate to Interface > GET /interface/{interface_name}/.
  3. In the Parameters section, specify the interface_name you are interested in.
  4. Click Submit.
    • The Response Body section shows the interface configuration including the addresses configured on the interface.

curl

  1. In APM, navigate to > Manage Monitoring Points.
  2. Find the hostname of your monitoring point in the Name column of the table.
  3. View the interface configuration (including the addresses) using:

    curl -X GET –header ‘Accept: application/json’ ‘https:///api/v1/interface//?config_state=active’

Web admin

  1. Log in to Web Admin
  2. Click Network Configuration.
  3. Click on the interface you are interested in.
  4. The Address Source field shows the interface address.

Add static IP addresses

Web admin

  1. Log in to Web Admin.
  2. Navigate to Network Settings > Network Interfaces.
  3. For the interface you want to add a static IP address to, select > Edit.
  4. In the Static Address field, specify the Address, Netmask, and Gateway you want to add and click .
    • The address is added to the Interface Addresses field.
  5. Repeat the previous step for all the addresses you want to add.
  6. Click Submit.
    • The address(es) specified are added to the interface but the change does not take effect until networking is restarted.
  7. Restart networking.
    • The changes are applied to the interface.

Admin API

  1. Log in to Admin API.
  2. Determine which interfaces are available.
    1. Navigate to Interface > GET /interface/ and click Submit.
      • The Response Body section shows the configured interfaces.
  3. Navigate to Interface > POST /interface/{interface_name}/address/.
  4. In the Parameters section:
    1. Set interface_name to the name of the interface you are configuring (e.g., eth0).
    2. Set family as appropriate. “inet” for IPv4, and “inet6” for IPv6.
  5. In the body section, click the Model Schema on the right.
    • The text is copied to the body field.
  6. Edit the text in the body field as follows:
    1. <address> - the IP address you are adding to the interface. Either an IPv4 or an IPv6 address can be specified.
    2. <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.
    3. <netmask> - the netmask of the IP address you are adding. Use a prefix (e.g., 64) for IPv6. Use either a prefix (e.g., 24) or a dotted decimal mask (e.g., 255.255.255.0) for IPv4.
      1. Click Submit.
        • In the Response Body section, look for "success": true to confirm that the address was added successfully.
  7. Repeat the steps from 3 above for all the addresses you want to add.
  8. 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.
  9. 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. “inet” for IPv4, and “inet6” for IPv6.
      4. Click Submit.
        • The Response Body section shows the addresses configured on the interface.

curl

  1. In APM, navigate to > Manage Monitoring Points.
  2. Find the hostname of your monitoring point in the Name column of the table.
  3. Determine which interfaces are available.

    curl -k -X GET --header "Accept: application/json" "https://admin:<password>@<hostname>/api/v1/interface/?config_state=active"
    
  4. Configure an additional IP address for an interface.

    curl -k -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{"address": "<address>", "netmask": "<netmask>", "gateway": "<gateway>"}' 'https://admin:<password>@<hostname>/api/v1/interface/<interface_name>/address/?family=<addr_type>'
    
    • gateway is optional.
  5. Verify that your changes are pending.

    curl -k https://admin:<password>@<hostname>/api/v1/interface/<interface_name>/address/?config_state=pending
    
  6. Restart networking.

    curl -k -X PUT --header "Content-Type: application/json" -d {} https://admin:<password>@<hostname>/api/v1/service/networking/?action=restart
    
    • You will briefly lose connectivity to the Admin API.
  7. Verify that the new address exists on the interface.

    curl -k https://admin:<password>@<hostname>/api/v1/interface/<interface_name>/address/?config_state=active
    

The variables above are defined as follows:

  • <address> - the IP address you are adding to the interface. Either an IPv4 or an IPv6 address can be specified.
  • <addr_type> - the type of IP address. Use “inet” for IPv4 and “inet6” for IPv6 addresses.
  • <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.
  • <hostname> - the monitoring point hostname. Alternatively, the monitoring point IP address can be 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.
  • <password> - the administrator password on the monitoring point.

USB

To add an IP address to an interface:

  1. Download the additional static IP addresses config file.
  2. In the downloaded file contains the following editable fields:
    • <interface> - the interface you are configuring (e.g., eth0).
    • <inet for ipv4 or inet6 for ipv6> - the address family you are using. Use inet for IPv4 and inet6 for IPv6.
    • <address> - the IP address you are adding to the interface. Either an IPv4 or an IPv6 address can be specified.
    • <netmask> - the netmask of the IP address you are adding. Use a prefix (e.g., 64) for IPv6. Use either a prefix (e.g., 24) or a dotted decimal mask (e.g., 255.255.255.0) for IPv4.
    • <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.
    • Repeat address, netmask, and gateway as a group for each additional address to be configured.
  3. Edit the downloaded config file for your needs.
    • Uncomment sections to be used (if required).
    • Replace content in arrow brackets (no arrow brackets should remain).
  4. Copy the file onto a USB stick.
  5. Make sure the monitoring point is ready.
  6. Insert the USB stick into the monitoring point.
    • The monitoring point reads the configuration from the USB stick and indicates that it is doing so.
  7. Wait until the monitoring point is finished.
  8. Remove the USB stick.
    • The monitoring point configuration is updated.
    • Any problems updating the configuration are logged in the usb.log file on the USB stick.
  9. Verify that the interface acquired an IP address.
    1. In APM, navigate to > Manage Monitoring Points.
    2. Select the monitoring point you are interested in.
    3. On the right side panel, check Local Network Interfaces for an IP address on the interface.

Web admin

  1. Log in to Web Admin
  2. Click Network Configuration.
  3. Click on the interface you are interested in.
  4. In the Address Source field, select Static configuration.
    • In the IP Address field, add the static IP address (e.g., 192.168.1.1).
    • In the Netmask field, add the netmask (e.g., 255.255.255.0).
  5. Click Save.
  6. Click Restart Networking.

Edit static IP addresses

Web admin

  1. Log in to Web Admin.
  2. Navigate to Network Settings > Network Interfaces.
  3. For the interface you want to edit, select > Edit.
  4. In the Interface Addresses field, edit the Static IP address configuration and click .
  5. Click Submit.
    • The address is changed but the change does not take effect until networking is restarted.
  6. Restart networking.
    • The changes are applied to the interface.

Web admin

  1. Log in to Web Admin
  2. Click Network Configuration.
  3. Click on the interface you are interested in.
  4. In the Address Source field, edit the IP Address and Netmask fields as appropriate.
  5. Click Save.
  6. Click Restart Networking.

Delete static IP addresses

Web admin

  1. Log in to Web Admin.
  2. Navigate to Network Settings > Network Interfaces.
  3. For the interface you want to edit, select > Edit.
  4. In the Interface Address field, click next to the address you want to delete.
    • The address is deleted from the Interface Addresses section.
  5. Repeat the previous step for all the addresses you want to delete.
  6. Click Submit.
    • The address(es) specified are removed from the interface but the change does not take effect until networking is restarted.
  7. Restart networking.
    • The changes are applied to the interface.

Admin API

  1. Log in to Admin API.
  2. Determine which interfaces are available.
    1. Navigate to Interface > GET /interface/ and click Submit.
      • The Response Body section shows the configured interfaces.
  3. Specify the IP address to delete from an interface using the following JSON text.

    {
      "address": "<address>"
    }
    
    1. Substitute the appropriate values for <address> in the text above and copy it to the clipboard.
      • <address> - the IP address you are deleting from the interface. Either an IPv4 or an IPv6 address can be specified.
    2. Navigate to Interface > DELETE /interface/{interface_name}/address/.
    3. In the Parameters section:
      1. Set interface_name to the name of the interface you are deleting.
      2. In the body field, paste the contents of the clipboard.
      3. Click Submit.
        • In the Response Body section, look for "success": true to confirm that the address was deleted successfully.
  4. 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.
  5. 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. “inet” for IPv4, and “inet6” for IPv6.
      4. Click Submit.
        • The Response Body section shows the addresses configured on the interface.

curl

  1. In APM, navigate to > Manage Monitoring Points.
  2. Find the hostname of your monitoring point in the Name column of the table.
  3. Determine which interfaces are available.

    curl -k -X GET --header "Accept: application/json" "https://<hostname>/api/v1/interface/?config_state=active"
    
  4. Determine which addresses exist on the interface.

    curl -k https://admin:<password>@<hostname>/api/v1/interface/<interface_name>/address/?config_state=active
    
  5. Delete an IP address from an interface.

    curl -k -X DELETE --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{"address": "<address>"}' 'https://admin:<password>@<hostname>/api/v1/interface/<interface_name>/address/?family=<addr_type>'
    
    • You cannot delete the last address on an interface.
  6. Verify that your changes are pending.

    curl -k https://admin:<password>@<hostname>/api/v1/interface/<interface_name>/address/?config_state=pending
    
  7. Restart networking.

    curl -k -X PUT --header "Content-Type: application/json" -d {} https://admin:<password>@<hostname>/api/v1/service/networking/?action=restart
    
    • You will briefly lose connectivity to the Admin API.
  8. Verify that the address was removed from the interface.

    curl -k https://admin:<password>@<hostname>/api/v1/interface/<interface_name>/address/?config_state=active
    

The variables above are defined as follows:

  • <address> - the IP address you are deleting from the interface. Either an IPv4 or an IPv6 address can be specified.
  • <addr_type> - the type of IP address. Use “inet” for IPv4 and “inet6” for IPv6 addresses.
  • <hostname> - the monitoring point hostname. Alternatively, the monitoring point IP address can be used.
  • <interface_name> - the name of the interface you are configuring.
  • <password> - the administrator password on the monitoring point.

Web admin

  1. Log in to Web Admin
  2. Click Network Configuration.
  3. Click on the interface you are interested in.
  4. In the Address Source field, select From DHCP.
    • The interface address and netmask will be obtained from DHCP.
  5. Click Save.
  6. Click Restart Networking.