Cameo Communications USR5453 Users Manual
Professional Access Point
Administrator Guide
SNMP
The Simple Network Management Protocol (SNMP) is an Internet standard protocol that facilitates the
monitoring and managing of network devices. SNMP lets you monitor events on your network through an
SNMP software application.
The following sections describe how to configure SNMP on your network:
• Understanding SNMP
• Navigating to Simple Network Management Protocol
• Enabling and Disabling Simple Network Management Protocol (SNMP)
• Updating Settings
• Configuring Your Network Management System
Understanding SNMP
SNMP defines a standard for recording, storing, and sharing information about network devices. SNMP is
a subset of Transmission Control Protocol/Internet Protocol (TCP/IP) that facilitates network management,
troubleshooting, and maintenance.
Key components of any SNMP-managed network are managed devices, SNMP agents, and a network
management system. The agents, store data about their devices in Management Information Bases
(MIBs) and return this data to the network management system when requested. Managed devices can be
network nodes such as access point base stations, routers, switches, bridges, hubs, servers, or printers.
The Professional Access Point can function as an SNMP managed device for seamless integration into
network management systems such as HP OpenView. The Professional Access Point supports the
following SNMP MIBs:
• Standard SNMP MIBs
• SNMP v1 and v2 MIBs
• IEEE802.11 MIB
• Proprietary MIB
• USR5453-PRODUCTS MIB—stores product identification information.
• USR5453-SYSTEM MIB—facilitates system-level requests, such as reboot and upgrade.
• USR5453-WIRELESS-CHAN MIB—maintains channel assignment information for access points
in a cluster.
• USR5453-WIRELESS-MIB—stores information about the wireless system, including peer statistics, beacon report, radio, and client statistics tables.
For more information about SNMP, visit http://www.snmplink.org.
SNMP - 155
Professional Access Point
Administrator Guide
Navigating to Simple Network Management Protocol
To enable SNMP, click the Advanced menu’s SNMP tab and update the fields as described below.
Enabling and Disabling Simple Network Management Protocol
(SNMP)
To configure your access point to use Simple Network Management Protocol (SNMP) server, first enable
the SNMP option that you want to use, and then provide the name of the community or host that can use
SNMP - 156
Professional Access Point
Administrator Guide
the option.
Field Description
Enable SNMP SNMP provides a way for the access point to store management information
and to provide the information to a network-management system (NMS). (See
http://www.snmplink.org/ for more general information on SNMP.)
Choose to either enable (default) or disable use of Simple Network Management Protocol:
Read-only Community Name (entire
MIB)
Allow SNMP SET Requests Choose to either enable or disable the honouring of SNMP SET requests:
Read-write community name (for permitted SETs)
If SNMP is enabled, enter the name of the community that is allowed to make
information queries against the MIB.
The community name acts an as authentication mechanism. The name functions as a password, and a request is considered authentic if the requester
knows the password.
The community name is alphanumeric; do not use special characters or
spaces.
• Enable—Machines on the network that provide the correct community name
can issue SET requests.
• Disable—(default) SET requests are not honoured.
SET requests are restricted to the USR5453-SYSTEM MIB and USR5453WIRELESS-CHAN MIB..
If SET requests are enabled, enter the name of the community that is allowed
to make SET requests.
The community name acts an as authentication mechanism. The name functions as a password, and a request is considered authentic if the requester
knows the password.
Designate source of permitted SNMP
requests
The community name is alphanumeric; do not use special characters or
spaces.
Choose to either enable or disable designating the source of the SNMP
requests:
• Enable—(default) A machine must be designated in the Source field in order
for its requests to be honoured.
• Disable—Any machine in the network may issue requests.
SNMP - 157
Professional Access Point
Administrator Guide
Field Description
Source (hostname or subnet) If source designation is enabled, enter the IP address of the host or subnet that
is allowed to issue SNMP requests to the access point.
If you use this option, the Professional Access Point honours requests from the
specified host or subnet only.
If you also enable a read-write community, the specified source must be a
member of that community in order for the access point to honour the source’s
requests.
Note: Even if you explicitly name a machine or a subnet in this field, any
machine issuing a request must also know the proper community name in
order to have the request honoured.
To shut down SNMP on the access point, select Disable in the SNMP field.
Updating Settings
To apply your changes, click Update.
Configuring Your Network Management System
In order to access the USRobotics proprietary MIBs, you need to import the MIBs into your network
management system. You can find the MIB files in the Mib folder on the USRobotics CD-ROM. Refer to
your network management system for instructions on importing and compiling MIBs.
SNMP - 158
Professional Access Point
Administrator Guide
Reboot
For maintenance purposes or as a troubleshooting measure, you can reboot the Professional Access Point
as follows.
1. Click the Advanced menu’s Reboot tab.
2. Click the Reboot button.
The access point reboots. If the IP address of the access point changes after the reboot, you need to
specify the new address in your Web browser in order to access the Web User Interface.
Reset Configuration
If you are experiencing extreme problems with the Professional Access Point and have tried all other
troubleshooting measures, use the Reset Configuration function. This will restore factory defaults and clear
all settings, including settings such as a new password and wireless settings.
1. Click the Advanced menu’s Reset Configuration tab.
Reboot - 159
Professional Access Point
Administrator Guide
2. Click the Reset button.
Factory defaults are restored.If the IP address of the access point changes after the reset, you need to
specify the new address in your Web browser in order to access the Web User Interface.
Note
Keep in mind that if you do reset the configuration from this page, you are doing so for this access
point only; not for other access points in the cluster.
For information on the factory default settings, see “Default Settings for the Professional Access Point”
on page 6.
If you cannot access the Web User Interface, you can reset the access point by using a thin object,
such as a paper clip, to press the Reset button until both the LAN and WLAN LEDs turn off briefly.
Upgrade
As new versions of the Professional Access Point firmware become available, you can upgrade the
Upgrade - 160
Professional Access Point
Administrator Guide
firmware on your devices to take advantages of new features and enhancements.
Caution
Do not upgrade the firmware from a wireless client that is associated with the access point you are
upgrading. Doing so will cause the upgrade to fail. Furthermore, all wireless clients will be disassociated and no new associations will be allowed.
If you are reading this section because you already tried to upgrade the firmware through a wireless
client, use a wired client to regain access to the access point as follows:
• Create a wired Ethernet connection from a PC to the access point.
• Open the Web User Interface.
Repeat the upgrade process using with the wired client.
Caution
The upgrade process may take several minutes during which time the access point will be unavailable.
Do not power down the access point while the upgrade is in process. When the upgrade is complete,
the access point will restart and resume normal operation.
Note
You must upgrade firmware for each access point; you cannot upgrade firmware automatically across
the cluster.
To upgrade the firmware on a particular access point:
1. Navigate to Advanced menu’s Upgrade tab on the Web User Interface for that access point.
Upgrade - 161
Professional Access Point
Administrator Guide
Information about the current firmware version is displayed and an option to upgrade a new firmware
image is provided.
2. If you know the path to the New Firmware Image file, enter it in the textbox. Otherwise, click the Browse
button and locate the firmware image file.
3. Click Update to apply the new firmware image.
A confirmation window describes the upgrade process.
4. Click OK to confirm the upgrade and start the process.
Caution
The firmware upgrade takes approximately 5 minutes, during which the Web User Interface displays a status message and progress bar. Do not power off the access point, and do not navigate
away from the upgrade page in your Web browser during the firmware upgrade.
When the upgrade is complete, the Web User Interface redisplays the Upgrade firmware page. You
can verify that the ugrade was successful by checking the firmware version shown on that page.
Backup/Restore
You can save a copy of the current settings on the Professional Access Point to a backup configuration file.
The backup file can be used at a later date to restore the access point to the previously saved
configuration.
• Navigating to Backup and Restore Settings
• Backing up Configuration Setting for an Access Point
• Restoring Access Point Settings to a Previous Configuration
Navigating to Backup and Restore Settings
To backup or restore a configuration for an access point, click the Advanced menu’s Backup and Restore tab
and use the Web User Interface as described below.
Backup/Restore - 162
Professional Access Point
Administrator Guide
Backing up Configuration Setting for an Access Point
To save a copy of the current settings on an access point to a backup configuration file (
1. Click the download configuration link.
A File Download or Open dialogue is displayed.
2. Choose the Save option on this first dialogue.
This brings up a file browser.
3. Use the file browser to navigate to the directory where you want to save the file, and click Save to save
the file.
You can use the default file name (
to save the file with a
.cbk
extension.
apconfig.cbk
) or type a new name for the backup file, but be sure
.cbk
format):
Restoring Access Point Settings to a Previous Configuration
To restore the configuration on an access point to previously saved settings:
Backup/Restore - 163
Professional Access Point
Administrator Guide
1. Select the backup configuration file you want to use, either by typing the full path and file name in the
Restore field or by clicking Browse, selecting the file, and clicking
Open.
(Only those files that were created with the Backup function and saved as
files are valid to use with Restore; for example,
apconfig.cbk
.)
.cbk
backup configuration
2. Click the Restore button.
The access point will reboot.
Note
When you click Restore, the access point will reboot. A reboot confirmation dialogue and follow-on
rebooting status message will be displayed. Wait a minute or two for the reboot process to complete. Then try to access the Web User Interface as described in the next step; the Web User Interface will not be accessible until the access point has rebooted.
3. When the access point has rebooted, access the Web User Interface either by clicking again on one of
the tabs (if the Web User Interface is still displayed) or by typing the IP address the Professional
Access Point as a URL in the address field of the Web browser. Enter the URL for the access point as
http://IPAddressOfAccessPoint
.
The Web User Interface displays the configuration settings restored from the backup file that you
selected.
Backup/Restore - 164
Professional Access Point
Administrator Guide
Command Line Interface
In addition to the Web-based user interface, the Professional Access Point includes a command line
interface (CLI) for administering the access point. The CLI lets you view and modify status and
configuration information.
From the client station perspective, even a single deployed Professional Access Point broadcasting its
"network name" to clients constitutes a wireless network. Keep in mind that CLI configuration commands,
like Web User Interface settings, can affect a single access point running in stand-alone mode or
automatically propagate to a network of clustered access points that share the same settings. (For more
information on clustering, see “Access Points” on page 33
to stand-alone or cluster mode from the CLI, see “Set Configuration Policy for New Access Points” on
page 29)
This part of the Professional Access Point Administrator Guide introduces the interface and provides a
complete description of classes and their associated fields:
. For information on how to set an access point
• Class Structure, Commands, and Examples
• Class and Field Reference
Class Structure, Commands, and Examples
The following topics in this appendix provide an introduction to the class structure upon which the CLI is
based, CLI commands, and examples of using the CLI to get or set configuration information on an access
point or cluster of APs:
• Comparison of Settings Configurable with the CLI and Web User Interface
• How to Access the CLI for an Access Point
• Telnet Connection to the Access Point
• SSH2 Connection to the Access Point
• Quick View of Commands and How to Get Help
• Command Usage and Configuration Examples
• Understanding Interfaces as Presented in the CLI
• Saving Configuration Changes
• Basic Settings
Class Structure, Commands, and Examples - 165
• Access Point and Cluster Settings
• User Accounts
• Status
• Ethernet (Wired) Interface
• Wireless Interface
• Security
• Enable/Configure Guest Login Welcome Page
• Configuring Multiple BSSIDs on Virtual Wireless Networks
• Radio Settings
• MAC Filtering
• Load Balancing
Professional Access Point
Administrator Guide
• Quality of Service
• Wireless Distribution System
• Time Protocol
• Reboot the Access Point
• Reset the Access Point to Factory Defaults
• Keyboard Shortcuts and Tab Completion Help
• CLI Class and Field Overview
Comparison of Settings Configurable with the CLI and Web
User Interface
The command line interface (CLI) and the Web User Interface to the Professional Access Point are
designed to suit the preferences and requirements for different types of users or scenarios. Most
administrators will probably use both interfaces in different contexts. Some features (such as Clustering)
can only be configured from the Web User Interface, and some details and more complex configurations
are only available through the CLI.
The CLI is particularly useful in that it provides an interface to which you can write programmatic scripts for
access point configurations. Also, the CLI may be less resource-intensive than a Web interface.
The following table shows a feature-by-feature comparison of which settings can be configured through the
CLI or the Web User Interface, and which are configurable with either.
Class Structure, Commands, and Examples - 166
Professional Access Point
Administrator Guide
Feature or Setting Configurable from CLI Configurable
from Web User
Interface
Basic Settings
• Getting/changing Administrator Password
• Getting/changing access point name and
location
• Viewing information like MAC, IP address,
and Firmware version
Access Point and Cluster Settings Get existing settings only.
User Accounts
User Database Backup and Restore You cannot backup or restore a user data-
Sessions The CLI does not provide session monitor-
yes yes
You cannot set configuration policy or
other cluster features from the CLI.
Use for clustering settings.
yes yes
base from the CLI.
To restore a user database, use the Web
User Interface as described in “Backing
Up and Restoring a User Database” on
page 46.
ing information.
yes
yes
yes
To view client sessions, use the Web User
Interface.
Channel Management You cannot configure Channel Manage-
ment from the CLI.
To configure channel management, use
the Web User Interface as described in
“Channel Management” on page 53
Wireless Neighborhood You cannot view the cluster-based "Wire-
less Neighborhood" from the CLI.
To view the wireless neighbourhood,use
the Web User Interface as described in
“Wireless Neighborhood” on page 61
Status
yes yes
.
.
yes
yes
Class Structure, Commands, and Examples - 167
Professional Access Point
Administrator Guide
Feature or Setting Configurable from CLI Configurable
from Web User
Interface
Ethernet (Wired) Interface
Wireless Interface
Security
Set Up Guest Access
Enable/Configure Guest Login Welcome Page
Configuring Multiple BSSIDs on Virtual Wireless Networks
Radio Settings
MAC Filtering
yes
You can configure all Ethernet (Wired)
settings from the CLI except "Connection
Type".
To change the Connection Type from
DHCP to Static IP addressing (or vice
versa), you must use the Web User Interface.
yes yes
yes yes
yes yes
yes
yes yes
yes
You can configure all Radio settings from
the CLI except for turning on/off Super G.
yes yes
yes
yes
Load Balancing
Quality of Service
Wireless Distribution System
Time Protocol
Reboot the Access Point
Reset the Access Point to Factory Defaults
Upgrade the Firmware You cannot upgrade the firmware from the
Backup and Restore You cannot backup or restore an access
yes yes
yes yes
yes yes
yes yes
yes
yes yes
CLI. To upgrade firmware, use the Web
User Interface as described in “Upgrade”
on page 160.
point configuration from the CLI. To
backup or restore an access point configuration, use the Web User Interface as
described in “Backup/Restore” on
page 162.
yes
yes
Class Structure, Commands, and Examples - 168
Professional Access Point
Administrator Guide
How to Access the CLI for an Access Point
Use one of the following methods to access the command line interface (CLI) for the access point or
wireless network:
• Telnet Connection to the Access Point
• SSH2 Connection to the Access Point
Telnet Connection to the Access Point
If you already have your network deployed and know the IP address of your access point, you can use a
remote Telnet connection to the access point to view the system console over the network.
Notes
The default Static IP address is 192.168.1.10. If there is no DHCP server on the network, the
access point retains this static IP address at first-time startup. You can use the Detection Utility to
find the IP address of the access point. (For more about IP addressing, see “Understanding
Dynamic and Static IP Addressing on the Professional Access Point” on page 10)
1. Bring up a command window on your PC.
(For example, from the Start menu, select Run to bring up the Run dialogue, type
and click OK.)
2. At the command prompt, type the following:
telnet
where
(If your Domain Name Server is configured to map domain names to IP addresses via DHCP, you can
also telnet to the domain name of the access point.)
3. You will be prompted for an Administrator user name and password for the access point.
USR5453-AP login:
Password:
Enter the default Administrator username and password for the Professional Access Point (
admin
screen.)
When the user name and password is accepted, the screen displays the Professional Access Point
help command prompt.
IPAddressOfAccessPoint
IPAddressOfAccessPoint
), and press "Enter" after each. (The password is masked, so it will not be displayed on the
is the address of the access point you want to monitor.
cmd
in the Open field,
admin
,
USR5453-AP login:
Password:
Enter 'help' for help.
You are now ready to enter CLI commands at the command line prompt.
admin
Class Structure, Commands, and Examples - 169
Professional Access Point
Administrator Guide
SSH2 Connection to the Access Point
If you already have your network deployed and know the IP address of your access point, you can use a
remote SSH2 connection to the access point to view the system console over the network.
Notes
The Professional Access Point supports SSH version 2 only.
The default Static IP address is 192.168.1.10. If there is no DHCP server on the network, the
access point retains this static IP address at first-time startup. You can use the Detection Utility to
find the IP address of the access point. (For more about IP addressing, see “Understanding
Dynamic and Static IP Addressing on the Professional Access Point” on page 10.)
Using an SSH2 connection to the access point is similar to Telnet in that it gives you remote access to the
system console and CLI. SSH2 has the added advantage of being a secure connection traffic encrypted.
To use an SSH2 connection, you need to have SSH software installed on your PC (such as PuTTY, which
is available at http://www.chiark.greenend.org.uk/~sgtatham/putty/).
1. Start your SSH application. (This example uses PuTTY.)
2. Enter the IP address of the access point and click Open.
(If your Domain Name Server is configured to map domain names to IP addresses via DHCP, you can
enter the domain name of the access point instead of an IP address.)
This brings up the SSH command window and establishes a connection to the access point. The login
prompt is displayed.
login as:
3. Enter the default Administrator username and password for the Professional Access Point (
admin
), and press "Enter" after each. (The password is masked, so it will not be displayed on the
Class Structure, Commands, and Examples - 170
admin
,
screen.)
Professional Access Point
Administrator Guide
login as:
admin@10.10.100.110's password:
Enter 'help' for help.
When the user name and password is accepted, the screen displays the Professional Access Point
help command prompt.
USR5453-AP#
You are now ready to enter CLI commands at the command line prompt.
admin
Quick View of Commands and How to Get Help
• Commands and Syntax
• Getting Help on Commands at the CLI
•
Ready to Get Started?
Caution
Settings updated from the CLI (with get, set, add, remove commands) will not be saved to the startup
configuration unless you explicitly save them via the save-running command. For a description of configurations maintained on the access point and details on how to save your updates, see ““Saving Con-
figuration Changes” on page 178.
Commands and Syntax
The CLI for the Professional Access Point provides the following commands for manipulating objects.
Notes
•
named_class
named.
•
instance
• field values cannot contain spaces unless the value is in quotes
For a detailed class and field reference, see “Class and Field Reference” on page 239
is a class of an object from the configuration whose instances are individually
is a name of an instance of class.
.
Class Structure, Commands, and Examples - 171
Professional Access Point
Administrator Guide
Command Description
get The "get" command allows you to get the field values of existing instances of a class.
Classes can be "named" or "unnamed". The command syntax is:
get unnamed-class [ field ... | detail ]
get named-class [ instance | all [ field ... | name | detail ] ]
The rest of the command line is optional. If provided, it is either a list of one or more
fields
An example of using the "get" command on an unnamed class with a single instance is:
, or the keyword detail.
get log
(There is only one log on the access point. This command returns information on the log
file.)
An example of using the "get" command on an unnamed class with multiple instances
is:
get log-entry
(There are multiple log entries but they are not named. This command returns all log
entries.)
An example of using the "get" command on a named class with multiple instances is:
get bss wlan0bssInternal
(There are multiple bss’s and they are named. This command returns information on the
BSS named "wlan0bssInternal".)
An example of using the "get" command on a named class to get all instances:
get radius-user all name
get radius-user all
Note: "
wlan0bssInternal
network (
as Presented in the CLI” on page 177.
wlan0
interface). For information on interfaces, see “Understanding Interfaces
" is the name of the basic service set (BSS) on the internal
Class Structure, Commands, and Examples - 172
Professional Access Point
Administrator Guide
Command Description
set The "set" command allows you to set the field values of existing instances of a class.
set unnamed-class [ with qualifier-field qualifier-value ... to ] field value . . .
The first argument is an unnamed class in the configuration.
After this is an optional qualifier that restricts the set to only some instances. For singleton classes (with only one instance) no qualifier is needed. If there is a qualifier, it starts
with the keyword with, then has a sequence of one or more qualifier-field
value pairs, and ends with the keyword to. If these are included, then only instances
whose present value of qualifier-field is qualifier-value will be set. The qualifier-value
arguments cannot contain spaces. Therefore, you cannot select instances whose
desired qualifier-value has a space in it.
The rest of the command line contains field-value pairs.
set named-class instance | all [ with qualifier-field qualifier-value ... to ] field value . . .
The first argument is either a named class in the configuration.
qualifier-
The next argument is the name of the instance to set, or the keyword all, which indicates that all instances should be set. Classes with multiple instances can be set consecutively in the same command line as shown in Example 4 below. The qualifier-value
arguments cannot contain spaces.
Here are some examples. (Bold text indicates class names, field names, or keywords;
text that is not bold indicates values to which the fields are being set.)
set interface wlan0 ssid "Vicky's AP"
1.
2.
set radio all beacon-interval 200
3.
set tx-queue wlan0 with queue data0 to aifs 3
4.
set tx-queue wlan0 with queue data0 to aifs 7 cwmin 15 cwmax
burst
5.
Note: For information on interfaces used in this example (such as
see “Understanding Interfaces as Presented in the CLI” on page 177
add The "add" command allows you to add a new instance of a class.
add named-class instance [ field value ... ]
add anonymous-class [ field value ... ]
For example:
0
set bridge-port br0 with interface eth0 to path-cost
add radius-user wally
200
wlan0, br0
.
, or
1024
eth0
)
Class Structure, Commands, and Examples - 173
Professional Access Point
Administrator Guide
Command Description
remove The "remove" command allows you to remove an existing instance of a class.
remove unnamed-class [ field value . . . ]
remove named-class instance | all [ field value . . .]
For example:
remove radius-user wally
The CLI also includes the following commands for maintenance tasks:
save-running The save-running command saves the running configuration as the startup configuration.
For more information, see ““Saving Configuration Changes” on page 178.
reboot The reboot command restarts the access point (a soft reboot).
For more information, see ““Reboot the Access Point” on page 233.
factory-reset The factory-reset command resets the access point to factory defaults and reboots.
For more information, see ““Reset the Access Point to Factory Defaults” on page 233
.
Getting Help on Commands at the CLI
Help on commands can be requested at the command line interface (CLI) by using the TAB key. This is a
quick way to see all valid completions for a class.
Hitting TAB once will attempt to complete the current command.
If multiple completions exist, a beep will sound and no results will be displayed. Enter TAB again to display
all available completions.
• Example 1: At a blank command line, hit TAB twice to get a list of all commands.
USR5453-AP#
add Add an instance to the running configuration
factory-reset Reset the system to factory defaults
get Get field values of the running configuration
reboot Reboot the system
remove Remove instances in the running configuration
save-running Save the running configuration
set Set field values of the running configuration
• Example 2: Type "get " TAB TAB (including a space after get) to see a list of all field options for the get
command.
USR5453-AP# get
association Associated station
basic-rate Basic rate of the radio
bridge-port Bridge ports of bridge interfaces
bss Basic Service Set of the radio
cluster Clustering-based configuration settings
Class Structure, Commands, and Examples - 174
Professional Access Point
Administrator Guide
cluster-member Member of a cluster of like-configured access points
config Configuration settings
detected-ap Detected access point
dhcp-client DHCP client settings
dot11 IEEE 802.11
host Internet host settings
interface Network interface
ip-route IP route entry
klog-entry Kernel log entry
log Log settings
log-entry Log entry
mac-acl MAC address access list item
ntp Network Time Protocol client
portal Guest captive portal
radio Radio
radius-user RADIUS user
ssh SSH access to the command line interface
supported-rate Supported rate of the radio
system System settings
telnet Telnet access to the command line interface
tx-queue Transmission queue parameters
wme-queue Transmission queue parameters for stations
• Example 3: Type "get system v" TAB. This will result in completion with the only matching field, "get sys-
tem version". Hit ENTER to display the output results of the command.
For detailed examples on getting help, see “Tab Completion and Help” on page 234.
Ready to Get Started?
If you know the four basic commands shown above (get, set, remove, and add) and how to get help at the
CLI using tab completion, you are ready to get started.
The best way to get up-to-speed quickly is to bring up the CLI on your access point and follow along with
some or all of the examples in the next topic “Command Usage and Configuration Examples” on page 175
Command Usage and Configuration Examples
“Understanding Interfaces as Presented in the CLI” on page 177
“Saving Configuration Changes” on page 178
“Basic Settings” on page 179
“Access Point and Cluster Settings” on page 183
“User Accounts” on page 183
.
“Status” on page 186
“Ethernet (Wired) Interface” on page 194
Class Structure, Commands, and Examples - 175
“Wireless Interface” on page 200
“Security” on page 200
“Enable/Configure Guest Login Welcome Page” on page 215
“Configuring Multiple BSSIDs on Virtual Wireless Networks” on page 216
“Radio Settings” on page 217
“MAC Filtering” on page 222
“Load Balancing” on page 224
“Quality of Service” on page 224
“Wireless Distribution System” on page 231
“Time Protocol” on page 232
“Reboot the Access Point” on page 233
Professional Access Point
Administrator Guide
“Reset the Access Point to Factory Defaults” on page 233
“Keyboard Shortcuts” on page 234
Class Structure, Commands, and Examples - 176
Professional Access Point
Administrator Guide
Understanding Interfaces as Presented in the CLI
The following summary of interface names is provided to help clarify the related CLI commands and output
results. These names are not exposed on the Web User Interface, but are used throughout the CLI. You
get and set many configuration values on the access point by referring to interfaces. In order to configure
the access point through the CLI, you need to understand which interfaces are available on the access
point, what role they play (corresponding setting on the Web User Interface), and how to refer to them.
Interface Description
lo Local loopback for data meant for the access point itself.
eth0 The wired (Ethernet) interface for the Internal network.
br0 The Internal bridge represents the Internal interface for the access point. To telnet
or ssh into the access point, use the IP address for this interface.
br0 consists:
• eth0 (or vlan
• wlan0
The IP address of the access point is provided in the output detail for br0. So, a
useful command is get interface. This gives you common information on all interfaces. From the output results, you can find the IP address for
address to connect to the access point.
brguest The Guest bridge, which consists of eth1 and wlan0guest.
brvwn1 The bridge interface for Virtual Wireless Network (VWN) 1.
The bridge interface for VWN1 consists of:
SomeNumber
if you have VLANs configured)
• wlan0vwn1
•
vlanVLANID
example, if you provided a VLAN ID of 1234, the VLAN interface would be
"
vlan1234
brvwn2 This is for the second Virtual Wireless Network (VWN) 2.
The bridge interface for VWN2 consists of:
where
"
VLANID
is a four-digit VLAN ID that you provided. (For
• wlan0vwn1
br0
. Use this IP
•
vlanVLANID
example, if you provided a VLAN ID of 1234, the VLAN interface would be
vlan1234
wlan0 The wireless (radio) interface for the Internal network.
wlan0guest The wireless (radio) interface for the Guest network.
wlan0vwn1 The wireless interface for Virtual Wireless Network (VWN) 1.
wlan0vwn2 The wireless interface for Virtual Wireless Network (VWN) 2.
.)
where
VLANID
is a four-digit VLAN ID that you provided. (For
Class Structure, Commands, and Examples - 177
Interface Description
Professional Access Point
Administrator Guide
wlan0wdsx
vlanxxxx
A wireless distribution system (WDS) interface where "x" indicates the number of
the WDS link. (For example,
A VLAN interface for VLAN ID
(Internal, Guest, VWN1 or VWN2), use the following command to look at the "
field:
wlan0wds1
xxxx
.)
. To find out what this VLAN interface is
role
"
get interface vlanVLANID role
For example:
get interface vlan
1234
role
Saving Configuration Changes
The Professional Access Point maintains three different configurations.
• Factory Default Configuration - This configuration consists of the default settings shipped with the
access point (as specified in
You can always return the access point to the factory defaults by using the factory-reset command, as
described in
“Reset the Access Point to Factory Defaults” on page 233.
• Startup Configuration - The startup configuration contains the settings that the access point will use
the next time it starts up (for example, upon reboot).
“Default Settings for the Professional Access Point” on page 6).
To save configuration updates made from the CLI to the startup configuration, you must execute the
save-running or "set config startup running" command from the CLI after making changes.
• Running Configuration - The running configuration contains the settings with which the access point
is currently running.
When you view or update configuration settings through the command line interface (CLI) using get,
set, add, and remove commands, you are viewing and changing values on the running configuration
only. If you do not save the configuration (by executing the save-running or "set config startup running"
command at the CLI), you will lose any changes you submitted via the CLI upon reboot.
The save-running command saves the running configuration as the startup configuration. (The save-running
command is a shortcut command for "set config startup running", which accomplishes the same thing)
Settings updated from the CLI (with get, set, add, remove commands) will not be saved to the startup
configuration unless you explicitly save them via the save-running command. This gives you the option of
maintaining the startup configuration and trying out values on the running configuration that you can
discard (by not saving).
By contrast, configuration changes made from the Web User Interface are automatically saved to both the
running and startup configurations. If you make changes from the Web User Interface that you do not want
to keep, your only option is to reset to factory defaults. The previous startup configuration will be lost.
Class Structure, Commands, and Examples - 178
Professional Access Point
Administrator Guide
Basic Settings
Note
Before configuring this feature, make sure you are familiar with the names of the interfaces as
described in “Understanding Interfaces as Presented in the CLI” on page 177
reference in a command determines whether a setting applies to a wired or wireless interface, or to the
Internal or Guest network.
The following CLI command examples correspond to tasks you can accomplish on the Basic Settings tab
of the Web User Interface for access points with clustering capabilities. In some cases, the CLI get
command provides additional details not available through the Web User Interface.
This table shows a quick view of Basic Settings commands and provides links to detailed examples.
Basic Setting Example
. The interface name you
Get the IP Address for the Internal Interface on an Access Point
Get the MAC Address for an Access Point
Get Both the IP Address and MAC
Address
Get Common Information on All Interfaces
for an Access Point
Get the Firmware Version for the Access
Point
Get the Location of the Access Point
Set the Location for an Access Point
get interface br0 ip
or
get interface
get interface is a catch-all command that shows common information
on all interfaces for the access point such as IP addresses, MAC
addresses, and so on. The IP address for the Internal interface (and
the one used to access the access point) is that shown for br0. (See
“Understanding Interfaces as Presented in the CLI” on page 177
)
get interface br0 mac
get interface br0 mac ip
get interface
get system version
get cluster location
set system location NewLocation
For example:
set system location hallway
or
set system location "Vicky’s Office
"
Get the Current Password
Set the Password
Get the Wireless Network Name (SSID))
get system encrypted-password
set system password NewPassword
For example:
set system password admin
get interface wlan0 ssid
Class Structure, Commands, and Examples - 179
Basic Setting Example
Professional Access Point
Administrator Guide
Set the Wireless Network Name (SSID)
set interface wlan0 ssid NewSSiD
For example:
set interface wlan0 ssid Vicky
set interface wlan0 ssid "Vicky’s AP"
Get the IP Address for the Internal Interface on an Access Point
In the following example, the IP address for the access point is: 10.10.55.216. Use the get command as
shown to obtain the IP address for the Internal network.
USR5453-AP#
get interface br0 ip
10.10.55.216
Get the MAC Address for an Access Point
In the following example, the MAC address for the access point is: 00:a0:c9:8c:c4:7e. Use the get
command as shown to obtain the MAC address.
USR5453-AP#
get interface br0 mac
00:a0:c9:8c:c4:7e
Get Both the IP Address and MAC Address
The following command returns both the IP address and the MAC address for an access point:
USR5453-AP#
get interface br0 mac ip
Field Value
--------------------ip 10.10.55.216
mac 00:a0:c9:8c:c4:7e
Get Common Information on All Interfaces for an Access Point
The following example shows common information (including IP addresses) for all interfaces.
USR5453-AP#
get interface
name type status mac ip mask
---------------------------------------------------------------------------
----lo up 00:00:00:00:00:00 127.0.0.1 255.0.0.0
eth0 up 00:02:B3:01:01:01
eth1 down 00:02:B3:02:02:02
br0 bridge up 00:02:B3:01:01:01 10.10.100.110
255.255.255.0
brguest bridge down 00:00:00:00:00:00
wlan0 service-set up 00:0C:41:16:DF:A6
wlan0guest service-set up
wlan0wds0 wds down
Class Structure, Commands, and Examples - 180
wlan0wds1 wds down
wlan0wds2 wds down
wlan0wds3 wds down
USR5453-AP#
Professional Access Point
Administrator Guide
Class Structure, Commands, and Examples - 181
Professional Access Point
Administrator Guide
Get the Firmware Version for the Access Point
In the following example, the access point is running Firmware Version: 1.0.0.9. Use the get command as
shown to obtain the Firmware Version.
USR5453-AP#
get system version
1.0.0.9
Get the Location of the Access Point
In the following example, the location of the access point has not been set. Use the get command as
shown to obtain the location of the access point.
USR5453-AP#
get cluster location
not set
Set the Location for an Access Point
To set the location for an access point, use the set command as follows:
USR5453-AP# set system location
USR5453-AP# set system location
hallway
"Vicky's Office"
To check to make sure that the location was set properly, use the get command again to find out the
location
USR5453-AP#
get system location
Vicky’s Office
Get the Current Password
USR5453-AP#
get system encrypted-password
2yn.4fvaTgedM
Set the Password
USR5453-AP#
set system password admin
USR5453-AP# get system encrypted-password
/rYSvxS4Okptc
Get the Wireless Network Name (SSID)
USR5453-AP#
get interface wlan0 ssid
Internal Instant802 Network
Set the Wireless Network Name (SSID)
USR5453-AP#
USR5453-AP#
set interface wlan0 ssid
get interface wlan0 ssid
Vicky’s AP
"Vicky’s AP"
Class Structure, Commands, and Examples - 182
Professional Access Point
Administrator Guide
Access Point and Cluster Settings
The command examples in this section show how to get the configuration for a cluster of access points.
These settings generally correspond to those on the Cluster menu’s Access Points tab in the Web User
Interface.
Note
You cannot use the CLI to add or remove an access point from a cluster or set the configuration policy.
If you want to configure clustering, please use the Web User Interface as described in “Access Points”
on page 33
This table provides a quick view of Access Point Cluster commands and provides links to detailed
examples.
Cluster Command Example
Determine whether the Access Point is a Cluster Member or is in
Stand-alone Mode
Get MAC Addresses for all Access Points in the Cluster
get cluster detail
get clustered-ap all name
Determine whether the Access Point is a Cluster Member or is in Stand-alone Mode
This command shows whether the access point is clustered or not. If the command returns 0, the access
point is in stand-alone mode (not clustered). If the command returns 1, the access point is a member of a
cluster. In the following example, the access point is in stand-alone mode.
USR5453-AP# get cluster detail
Field Value
-------------------clustered 0
clusterable 0
kickstarted 0
location not set
formation
Get MAC Addresses for all Access Points in the Cluster
USR5453-AP# get cluster-member all
name mac ip location removed
--------------------------------------------------------------------00:e0:b8:76:23:b4 00:e0:b8:76:23:b4 10.10.10.248 not set 0
00:e0:b8:76:16:88 00:e0:b8:76:16:88 10.10.10.230 not set 0
User Accounts
The following command examples show configuration tasks related to user accounts. These tasks
correspond to the Cluster menu’s User Management tab in the Web User Interface.
Class Structure, Commands, and Examples - 183
Professional Access Point
Administrator Guide
This table shows a quick view of User Management commands and provides links to detailed examples.
User Account Command Example
Get All User Accounts To view all usernames:
get radius-user all name
To view all user accounts:
get radius-user all
Add Users
To set the user’s real name:
To set user’s password:
Remove a User Account
Get All User Accounts
To view all user names:
USR5453-AP#
get radius-user all name
name
-------larry
add radius-user
For example:
UserName
add radius-user samantha
set radius-user
For example:
UserName RealName
set radius-user samantha "Elizabeth Montgomery"
(or
set radius-user samantha Elizabeth
set radius-user
For example:
UserName
password
Password
)
set radius-user samantha password westport
remove radius-user UserName
To view all user accounts:
USR5453-AP# get radius-user all
name username disabled password realname
-----------------------------------------------------------larry David White
(At the start, "larry" is the only user configured.)
Add Users
In this example, you will add four new users: (1) samantha, (2) endora, (3) darren, and (4) wally. You will
set up user names, real names, and passwords for each.
1. Add username "samantha":
USR5453-AP#
add radius-user samantha
Class Structure, Commands, and Examples - 184
Loading...