# AWC Plug-in User Guide 3.1.0

# Manage AP Registration

Register AP
Register AP Manually
Import AP from CSV File
Register AP From Guest Node AP List
Zero Touch Configuration
Edit AP
Delete AP
Prerequisites For Using DHCP

This section describes how to register, edit, and delete managed APs.

## Register AP

There are three ways to register APs in the AWC Plug-in's management database: registering them manually, importing their data from a CSV file, and registering them from a guest node list.
AP properties such as Device Name, IP Address, MAC Address, Management Group, and Tags can be edited after the AP is registered to the database.
If the AMF network is properly configured, you can easily register a guest node AP by specifying a guest port on the parent AMF device, instead of specifying the AP's address. This is called Zero Touch Configuration.
In this case, the AWC Plug-in can identify the AP even if the AP's IP or MAC address changes.
This is useful when you want to provision management information on the AWC Plug-in before connecting the AP to the network, or if you want to replace the failed AP with the same model and have the AWC Plug-in automatically apply the same configuration to the new AP.
To perform Zero Touch Configuration, the following requirements must be met:

- AMF Network
  - The Management VLAN of the AP (TQ Series) is untagged.
  - The AP is detected as a guest node, and a parent AMF node is configured to collect the guest node information automatically (dynamic discovery).
  - On the parent AMF node, DHCP Snooping is enabled for the AP's management VLAN.

    > Note

    > > On the AMF node, make sure you enable DHCP Snooping on the AP management VLAN only.

- Vista Manager EX
  - The AMF Network is registered in the management database.
- AP
  - TQ series firmware version 6.0.x, 5.2.x - 5.4.x, 4.2.x - 4.3.x Bxx or 4.1.x Sxx is installed.
  - The DHCP Client is enabled (default) on the AP, and the AP acquired its IP address from a DHCP server.

    > Note

    > > If you specify a username and a password for the AP's guest-class on a parent AMF node, make sure that the AP's login username and password are the same as the ones configured for the guest-class.

Refer to the AlliedWare Plus documentation for more details about AMF guest node and DHCP Snooping.

> Note

> > The maximum number of APs (TQ and MWS AP series) that can be assigned to a single Management Group is 350.

> Note

> > To add an MWS AP series to the management database of the AWC Plug-in, you have to factory-reset the AP and configure its IP address appropriately.
> > Moreover, if you are planning to use both LAN1/LAN2 ports on an MWS2533AP, you should configure STP or LACP in addition to its IP address.
> > Please refer to the MWS AP Series Reference Manual for information about how to configure the MWS AP.

> Note

> > For TQ series, configuring APs, LLDP, Ethernet, and HTTP/HTTPS is only possible from the AP's own management web interface. Please follow the steps described in Configure AP through Its Own Web Interface to perform that configuration.
> > For detailed explanations on configuring TQ series APs, refer to "AT-TQ series Reference Manual" on our website.

> Note

> > If you manage guest node APs with the AWC Plug-in, AMF backup and manual recovery of the guest node is not supported.

### Register AP Manually

1. Select "Wireless Configuration" > "AP Settings" from the AWC Plug-in menu.
2. Click the "Gear" icon at the top right of the Content section.
3. Click "Manual Registration" from the menu.
4. The "Wireless AP Registration" dialog box will appear.

   Table 1: "Wireless AP Registration" dialog box (manual)
   Item Name | Description
   --- | ---
   Device Name | Enter a name for the AP. Max 100 characters If you leave this field empty, the name of the AP will be automatically filled in. The name depends on the "Use AMF for AP Provisioning" setting: When "Use AMF for AP Provisioning" is disabled: The name will be set to the AP's MAC address. When "Use AMF for AP Provisioning" is enabled: The name will be set to "(Parent Node Name)-(Port Number)" (e.g. "x230_1-port1.0.1").
   Management Group | Specify a Management Group to which you want the AP to belong. (mandatory).
   Tag | Enter a tag of your choice and press the Enter key. A tag can contain up to 100 characters, but cannot contain successive spaces. To delete a tag, click "x" to the right of the tag. Note If you paste a tag string from the clipboard, not all text may be visible. In that case, press Enter to make a tag from the entire pasted string. Note Pasting a tag containing a newline is not supported. Note Tag names may be truncated in the tag filter list on the Nodes Map, Floor Map Details and Device Search pages. To avoid this, use shorter names for the tags.
   Use AMF for AP Provisioning | Select whether or not the AWC Plug-in uses the AMF guest node information to identify the AP. If you select "Disable", the AWC Plug-in identifies the AP by its IP and MAC addresses. This requires that the AP's IP address is preconfigured. If you select "Enable", the AWC Plug-in identifies the AP by using AMF guest node information for the AP (AMF network, area, parent node, and the port to which the AP is connected). "Enable" will not be available unless AMF areas are configured in the Management Group. The default is "Disable". Depending on this setting, you have to supply different information to add an AP: When "Use AMF for AP Provisioning" is disabled: IP Address: Specify an IP address for the AP List (mandatory). To set the IP address from a DHCP server, select "DHCP". Note When using DHCP, DHCP option 43 (vendor specific information) must be set on the DHCP server in advance. Refer to Prerequisites For Using DHCP for more details If you have set a static IP address in advance, select "STATIC" and enter the IP address assigned to the AP. MAC Address: Specify the MAC address of the AP (mandatory). Specify the MAC address for the AP in "xx:xx:xx:xx:xx:xx" format. For TQ5403 and MWS2533AP, specify the MAC address of LAN1 port regardless of the connected port. Note You have to supply a MAC address to manage an AP. When "Use AMF for AP Provisioning" is enabled: Network Name: Select an AMF Network to which the guest node AP belongs (mandatory). Area Name: Select an AMF area to which the guest node AP belongs (mandatory). Node Name: Select an AMF node to which the guest node AP is connected (mandatory). Port Number: Enter a switchport number on the parent AMF node to which the guest node AP is connected (mandatory).
   "Add" button | Add the AP to the AWC Plug-in's management database with the specified information.
   "Cancel" button | Cancel registering the APs.

5. When you have entered all required information for the floor map, click "Add".
6. Next, you have to assign an AP Profile to the AP.
   For detailed procedures of how to apply an AP Profile to an AP, refer to Change Management Group or AP Profile for AP.

### Import AP from CSV File

> Note

> > The maximum number of APs which can be imported in a single operation is 1000.

1. Select "Wireless Configuration" > "AP Settings" from the AWC Plug-in menu.
2. Click the "Gear" icon at the top right of the Content section.
3. Click "Import from CSV" on the displayed menu.
4. The "Registration from CSV File" dialog box will appear.

   Table 2: "Registration from CSV File" dialog box.
   Item Name | Description
   --- | ---
   "Select File" button | Opens a file dialog box to specify a CSV file. The required fields in a CSV file vary depending on the "Use AMF for AP Provisioning" setting: When "Use AMF for AP Provisioning" is disabled: The CSV file must contain the following data: * Lines starting with "#" are ignored. 1st column: Device Name 2nd column: IP Address (Required if DHCP in 4th column is 0 or blank) 3rd column: MAC Address 4th column: Whether to use DHCP (0: not used, 1: used) Note When using DHCP, DHCP option 43 (vendor specific information) must be set on the DHCP server in advance. Refer to Prerequisites For Using DHCP for more details 5th column: Tag Names (separated by a comma. CSV escape required) * Do not include any fields after the 5th column. For TQ5403 and MWS2533AP, specify the MAC address of LAN1 port regardless of the connected port. When "Use AMF for AP Provisioning" is enabled: The CSV file must contain the following data: * Lines starting with "#" are ignored. 1st column: Device Name 2nd column: Network Name (mandatory) 3rd column: Area Name (mandatory) 4th column: Node Name (mandatory) 5th column: Port Number (mandatory) 6th column: Tag Names (seperated by a comma. CSV escape required) * Do not include any fields after the 6th column. A sample CSV file is found in the following directory: [Vista Manager EX Installation Directory]\Plugins\AT-AWC\tools\import_wireless_APs_sample.csv Note When an error is found, the AWC Plug-in always reports that there is an error in the 1st column (Device Name), regardless of which columns have errors. Note Only CSV format is supported for import.
   Management Group | Specify a Management Group to which you want the AP to belong.
   Use AMF for AP Provisioning | Select whether or not the AWC Plug-in uses the AMF guest node information to identify the AP. If you select "Disable", specify APs by their IP and MAC addresses. If you select "Enable", specify APs by their parent node's switch ports. This is useful when the APs get their IP addresses from a DHCP server. "Enable" will not be available unless AMF areas are configured in the Management Group. The default is "Disable".
   "Add" button | Register APs from the specified CSV file.
   "Cancel" button | Cancel registering the APs.

   > Note

   > > When using DHCP, DHCP option 43 (vendor specific information) must be set on the DHCP server in advance.
   > > Refer to Prerequisites For Using DHCP for more details

5. When you have entered all required information for the floor map, click "Add".
6. Next, you have to assign an AP Profile to the AP.
   For detailed procedures of how to apply an AP Profile to an AP, refer to Change Management Group or AP Profile for AP.

### Register AP From Guest Node AP List

> Note

> > This page shows candidate guest node APs in the AMF area/network configured in the specified Management Group.

> Note

> > This page only shows the guest node APs which are not registered to the management database.

> Note

> > The MWS AP Series cannot be added by this method because they cannot join the AMF network as guest nodes. Register them manually or import them from a CSV file.

> Note

> > When registering the AT-TQ series as a guest node, if you do not use zero touch configuration or auto recovery, connect the wireless client using the DHCP client function to the same VLAN as the management VLAN of the wireless AP. In this case, set the discovery method of the guest node to "static".
> > You have to choose "dynamic" method when you use Zero Touch Configuration and/or Auto Recovery. In that case, make sure you set a VAP VLAN that is different from the AP's management VLAN. Also make sure that DHCP snooping is only enabled on the AP's management VLAN, and it is disabled on the VAP VLAN if wireless clients use DHCP.

1. Select "Wireless Configuration" > "AP Settings" from the AWC Plug-in menu.
2. Click the "Gear" icon at the top right of the Content section.
3. Click "Registration from Guest Node" on the displayed menu.
4. The "Registration from Guest Node" dialog box will appear.

   Section 1

   Table 3
   Item Name | Description
   --- | ---
   Management Group | Specify a Management Group to which you want the AP to belong.
   Use AMF for AP Provisioning | Select whether or not the AWC Plug-in uses the AMF guest node information to identify the AP. If you select "Disable", specify APs by their IP and MAC addresses. If you select "Enable", specify APs by their parent node's switch ports. This is useful when the APs get their IP addresses from a DHCP server. "Enable" will not be available unless AMF areas are configured in the Management Group. The default is "Disable".
   "Add" button | Add the selected APs to the management database.
   "Cancel" button | Cancel registering the APs.

   Section 2

   Table 4
   Item Name | Description
   --- | ---
   X GUESTS | Shows the number of guest nodes.
   X SELECTED | Shows the number of guest nodes that are selected (checked).
   Search Guest Node | Lets you search guest nodes. You can filter entries in the list by entering a partial string in the search box. The Search field lets you enter a partial string to match. The screen displays entries with that string in one of the following fields: "MAC Address", "IP Address", "Guest Node Name", "AMF Network", "AMF Area", "Parent Node" or "Interface". To remove the filter, delete the string from the Search field and press Enter. Note The search is case-sensitive.
   "All" icon button | Shows all guest nodes.
   "AP List" button | Shows wireless APs only.

   Section 3

   Table 5
   Item Name | Description
   --- | ---
   Checkbox | Lets you select guest node APs to register. Checking the box in the heading row selects all guest nodes in the list. Unchecking the box in the heading row deselects all entries in the list.
   MAC Address | Shows the device's MAC address.
   IP Address | Shows the management IP address.
   Guest Node Name | Shows the guest node name.
   AMF Network | Shows the AMF network name to which the guest node belongs.
   AMF Area | Shows the AMF area name to which the guest node belongs.
   Parent Node | Shows the parent AMF node name to which the guest node is connected.
   Interface | Shows the interface name on the parent AMF node to which the guest node is connected.

   Section 4

   Table 6
   Item Name | Description
   --- | ---
   << | Go to the first page in the list.
   (Page Number) | Shows the current page number in the list.
   >> | Go to the last page in the list.

5. When you have entered all required information for the floor map, click "Add".
6. Next, you have to assign an AP Profile to the AP.
   For detailed procedures of how to apply an AP Profile to an AP, refer to Change Management Group or AP Profile for AP.

#### Zero Touch Configuration

If the AMF network is properly configured, you can easily add a guest node AP by specifying a guest port on the parent AMF device, instead of specifying the AP's address (Zero Touch Configuration).
When using Zero Touch Configuration, you do not have to know the AP's IP or MAC addresses in advance. This is also useful when you want to just replace the failed AP with the same model and make AWC Plug-in to automatically apply the same configuration to the new AP.
For more details and procedures, refer to Operation Reference > Miscellaneous Settings > Zero Touch Configuration and Auto Recovery.

> Note

> > To perform Zero Touch Configuration, the AMF network must be properly configured.

## Edit AP

1. Select "Wireless Configuration" > "AP Settings" from the AWC Plug-in menu.
2. Click the "Edit" icon in the rightmost column of the AP to edit the AP.
3. The "Wireless AP Edit" dialog box will appear.

4. Click "Save" when finished editing.

## Delete AP

> Note

> > If you delete all entries on the last page of the list, the page won't be deleted and an empty list page will be displayed. The number of pages will be refreshed after moving to another page or reloading the browser.

1. Select "Wireless Configuration" > "AP Settings" from the AWC Plug-in menu.
2. Check the APs to delete on the list.
3. Click the "Gear" icon at the top right of the Content section.
4. Click "Delete" from the menu.
5. The "Confirm" dialog box will appear.
6. Click "Delete".

## Prerequisites For Using DHCP

If the IP address of the wireless AP is not known in Register AP, you can obtain the IP address from the DHCP server and register the AP based only on the MAC address of the AP.
When configuring to obtain an IP address from a DHCP server, it is necessary to specify the IP address and monitoring port number (65437) of the AWC Plug-in as DHCP option 43 (vendor specific information) on the DHCP server side.

> Note

> > When using DHCP option 43, be careful not to let the DHCP server assign an IP address that conflicts with the IP address of the AP already registered to the AWC Plug-in.

DHCP option 43 is set only once for the DHCP pool.
DHCP option 43 is required only in case the AP requests a DHCP server for a dynamic IP address. If the DHCP server has static entry with each AP's MAC address, and all APs are to be registered to the AWC Plug-in with the IP addresses which are statically assigned from the DHCP server, you do not need to set DHCP option 43.
The format of the AWC server information passed as an optional setting value is as follows.
The following setting shows an example in which the IP address of the AWC Plug-in is set to "192.168.1.250":

Table 7: DHCP option 43 format
Field name | Field length | Description | Variable / Fixed | Setting Example
--- | --- | --- | --- | ---
Content | Hexadecimal value
Header | 1 octet | Information header to be passed as vendor-specific information. | Fixed | 207 | CF
Option 1 type | 1 octet | Indicates that the following field is the IP address of the AWC Plug-in. | Fixed | 1 | 01
Option 1 value | 4 octets | Specify the IPv4 address of the AWC Plug-in. | Variable | 192.168.1.250 | C0A801FA
Option 2 type | 1 octet | Indicates that the following field is the monitoring port number of the AWC Plug-in. | Fixed | 2 | 02
Option 2 value | 2 octets | Specify the monitoring port number of the AWC Plug-in. | Fixed | 65437 | FF9D

If the AMF device is running the DHCP service and the AWC Plug-in is installed on the IP address "192.168.1.250", the following settings must be added to the corresponding DHCP pool.
Here, it is assumed that the DHCP option name to be set is "awcserver" and the DHCP pool name is "pool1".

`awplus#configure terminal
awplus(config)#ip dhcp option 43 name awcserver hex
awplus(config)#ip dhcp pool pool1
awplus(dhcp-config)#option awcserver cf01c0a801fa02ff9d
`

13 Mar 2020 16:32