Transmission Parameters
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
- Log in to Web Admin.
- Navigate to Network Settings > Network Interfaces.
- For the interface you want to view, select > Edit.
- Click Advanced Configuration (at the bottom of the page).
- The advanced configuration parameters appear.
Admin API
- Log in to Admin API.
- Navigate to Interface > GET /interface/{interface_name}/.
- In the Parameters section, specify the interface_name you are interested in.
- 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”).
- The Response Body section shows the interface configuration including.
curl
- In APM, navigate to > Manage Monitoring Points.
- 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.
-
View the interface configuration using:
curl -k -u <username> -X GET -H '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
- Log in to Web Admin
- Click Network Configuration.
- Click on the interface you are interested in.
- Click Advanced Settings (at the bottom of the page).
- The advanced configuration parameters appear (Duplex and Speed and MTU).
Edit transmission parameters
Web admin
- Log in to Web Admin.
- Navigate to Network Settings > Network Interfaces.
- For the interface you want to edit, select > Edit.
- Click Advanced Configuration (at the bottom of the page).
- The advanced configuration parameters appear.
- Update the transmission parameters as required.
- Click Submit.
- Restart networking.
- The changes are applied to the interface.
Admin API
- Access the Admin API.
- Navigate to Interface > PUT /interface/{interface name}/.
- In the Parameters section, in the interface_name field, enter the interface you want to edit (e.g., eth1).
- In the body section, click the Model Schema on the right.
- The text is copied to the body field.
- Within body, update the fields as appropriate.
- Click Submit.
- In the Response Body section, look for
"success": true
to confirm that the interface was updated.
- In the Response Body section, look for
- Restart networking. You will briefly lose connectivity to the Admin API.
- The interface is reconfigured when networking restarts.
curl
- In APM, navigate to > Manage Monitoring Points.
- 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.
-
Edit the transmission parameters using:
curl -k -u <username> -X PUT -H 'Content-Type: application/json' -H '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
- Log in to Web Admin
- Click Network Configuration.
- Click on the interface you are interested in.
- Click Advanced Settings (at the bottom of the page).
- The transmission parameters appear (Duplex and Speed and MTU).
- Update the transmission parameters as required.
- Click Save.
- Click Restart Networking.