VLAN Interfaces

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.

Web admin

1. Complete monitoring point setup.
2. Log in to Web Admin.
3. Click Network Settings.
4. Click Network Interfaces.
5. Click Add Network Interface.
6. Select the ‘VLAN’ interface type and make your changes.
7. 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:<password>@<hostname>/api/v1/interface/
   

6. Verify that your changes are pending.

   curl -k https://admin:<password>@<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" -d {} https://admin:<password>@<hostname>/api/v1/service/networking/?action=restart
   

8. Verify that your new interface exists by repeating Step 3.

USB

To add a VLAN interface:

1. Download the VLAN interface config file.
2. 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).
3. Copy the file onto a USB stick.
4. Make sure the monitoring point is ready.
5. 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.
6. Wait until the monitoring point is finished.
7. 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.
8. 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.