VLANs

Enable 802.1Q vlan tagging.

Web admin

  1. Complete monitoring point setup.
  2. Log in to web admin
  3. Click ‘network configuration’.
  4. Click ‘add vlan tagged interface’.
  5. Make your changes.
  6. Restart networking.

Admin API

  1. Complete monitoring point setup.
  2. Discover your monitoring point hostname at > Manage Monitoring Points.
  3. Find out what interfaces are already configured by plugging the monitoring point hostname into this url, under the interface resource open GET /interface/ and click submit.
  4. Open POST /interface/.

  5. Sub in an interface name and method into this json, paste it into the white box, and click submit. The interface name should have the form ‘ethX.Y’ and the options for method are ‘manual’, ‘static’, or ‘dhcp’.

    {
  "name": "IFNAME",
  "method": "METHOD",
  "address":"IP_ADDRESS",
  "netmask":"NETMASK"
}
  6. In the response, look for 'success': true, which lets you know that the interface was successfully created and configured.
  7. Next we’ll need to restart the networking service in order to apply the changes. Under the service resource open PUT /service/{service_name}/, set ‘service_name’ to ‘networking’, ‘action’ to ‘restart’, and then click submit. You will briefly lose connectivity to the admin API.
  8. Verify that your new interface exists by repeating Step 3.

curl

  1. Complete monitoring point setup.
  2. Discover your monitoring point hostname at > Manage Monitoring points.

  3. Find out what interfaces are already configured.

    curl -X GET --header "Accept: application/json" "https://HOSTNAME/api/v1/interface/?config_state=active"
  4. Create a file called vlan-config.json containing one of the objects from the admin api section. Make sure you sub in your details.

  5. Add a new vlan interface.

    curl -k -X POST --header "Content-Type: application/json" --data-binary @vlan-config.json https://admin:ADMINPASS@HOSTNAME/api/v1/interface/

  6. Verify that your changes are pending.

    curl -k https://admin:ADMINPASS@HOSTNAME/api/v1/interface/?config_state=pending

  7. Restart networking. You will briefly lose connectivity to the admin API.

    curl -k -X PUT --header "Content-Type: application/json" https://admin:ADMINPASS@HOSTNAME/api/v1/service/networking?action=restart
  8. Verify that your new interface exists by repeating Step 3.

USB

  1. Download the vlan config file from here, and save it to an empty, fat32-formatted usb stick.
  2. Uncomment the section you need and replace specify the items in arrow brackets.
  3. Insert the usb stick into your device, and monitor device feedback.
  4. Wait for the monitoring point to return to ready.