In general, transmission parameters (Maximum Transmission Unit (MTU), Auto negotiation, Speed, and Duplex) use default values but can be changed if necessary.

View transmission parameters

Web admin

  1. Log in to Web Admin.
  2. Navigate to Network Settings > Network Interfaces.
  3. For the interface you want to view, select > Edit.
  4. Click Advanced Configuration (at the bottom of the page).
    • The advanced configuration parameters appear.

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.
      • mtu - Maximum Transmission Unit (“null” by default, meaning “1500”).
      • autoneg - Auto Negotiation (“on” by default).
      • speed - Speed (“null” by default, meaning “Auto”).
      • duplex - Duplex (“null” by default, meaning “Auto”).

curl

  1. In APM, navigate to > Manage Monitoring Points.
  2. Click the monitoring point you want to connect to.
    • The Name field contains the hostname.
    • The Local Network Interface field in the right pane contains the IP address.
      • Use the Public IP if you are connecting across the Internet.
  3. View the interface configuration using:

    curl -k -u <username> -X GET --header 'Accept: application/json' 'https://<hostname>/api/v1/interface/<interface_name>/?config_state=active' | python -m json.tool
    

The variables above are defined as follows:

  • <username> - the user name on the monitoring point.
  • <hostname> - the hostname or IP address of the monitoring point.
  • <interface_name> - the interface you are interested in.

The response shows the interface configuration including:

  • mtu - Maximum Transmission Unit (“null” by default, meaning “1500”).
  • autoneg - Auto Negotiation (“on” by default).
  • speed - Speed (“null” by default, meaning “Auto”).
  • duplex - Duplex (“null” by default, meaning “Auto”).

Web admin

  1. Log in to Web Admin
  2. Click Network Configuration.
  3. Click on the interface you are interested in.
  4. Click Advanced Settings (at the bottom of the page).
    • The advanced configuration parameters appear (Duplex and Speed and MTU).

Edit transmission parameters

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. Click Advanced Configuration (at the bottom of the page).
    • The advanced configuration parameters appear.
  5. Update the transmission parameters as required.
  6. Click Submit.
  7. Restart networking.
    • The changes are applied to the interface.

Admin API

  1. Access the Admin API.
  2. Navigate to Interface > PUT /interface/{interface name}/.
  3. In the Parameters section, in the interface_name field, enter the interface you want to edit (e.g., eth1).
  4. In the body section, click the Model Schema on the right.
    • The text is copied to the body field.
  5. Within body, update the fields as appropriate.
  6. Click Submit.
    • In the Response Body section, look for "success": true to confirm that the interface was updated.
  7. Restart networking. You will briefly lose connectivity to the Admin API.
    • The interface is reconfigured when networking restarts.

curl

  1. In APM, navigate to > Manage Monitoring Points.
  2. Click the monitoring point you want to connect to.
    • The Name field contains the hostname.
    • The Local Network Interface field in the right pane contains the IP address.
      • Use the Public IP if you are connecting across the Internet.
  3. Edit the transmission parameters using:

    curl -k -u <username> -X PUT --header 'Content-Type: application/json' --header 'Accept: application/json' -d '{"mtu": "<mtu>", "autoneg": "<autoneg>", "speed": "<speed>", "duplex": "<duplex>"}' 'https://<hostname>/api/v1/interface/<interface_name>/'  | python -m json.tool
    
    • Omit optional key:value pairs you are not using. Remove the comma after the final key:value pair.

The variables above are defined as follows:

  • <username> - the user name on the monitoring point.
  • <hostname> - the hostname or IP address of the monitoring point.
  • <interface_name> - the interface you are configuring.
  • <mtu> - Maximum Transmission Unit (“1500” by default.).
  • <autoneg> - Auto Negotiation (“on” or “off”. “on” by default.).
  • <speed> - Speed (“10”, “100”, “1000”, or “auto”. “auto” by default.).
  • <duplex> - Duplex (“half”, “full”, or “auto”. “auto” by default.).

Web admin

  1. Log in to Web Admin
  2. Click Network Configuration.
  3. Click on the interface you are interested in.
  4. Click Advanced Settings (at the bottom of the page).
    • The transmission parameters appear (Duplex and Speed and MTU).
  5. Update the transmission parameters as required.
  6. Click Save.
  7. Click Restart Networking.