This command sets the facility type for remote logging of syslog messages.
Syntax
logging facility-type <type>
type - A number that indicates the facility used by the syslog server to
dispatch log messages to an appropriate service. (Range: 16-23)
Default Setting
16
Command Mode
Global Configuration
7
7-31
Command Line Interface
7
Command Usage
The command specifies the facility type tag sent in syslog messages. (See
RFC 3164.) This type has no effect on the kind of messages reported by the
bridge. However, it may be used by the syslog server to sort messages or to
store messages in the corresponding database.
This command displays log messages stored in the bridge’s memory.
Syntax
show event-log
Command Mode
Exec
Example
Enterprise AP#show event-log
Mar 09 11:57:55 Information: 802.11g:11g Radio Interface Enabled
Mar 09 11:57:55 Information: 802.11g:Radio channel updated to 8
Mar 09 11:57:34 Information: 802.11g:11g Radio Interface Enabled
Mar 09 11:57:18 Information: 802.11g:11g Radio Interface Enabled
Mar 09 11:56:35 Information: 802.11a:11a Radio Interface Enabled
Mar 09 11:55:52 Information: SSH task: Set SSH server port to 22
Mar 09 11:55:52 Information: SSH task: Enable SSH server.
Mar 09 11:55:52 Information: Enable Telnet.
Mar 09 11:55:40 Information: 802.11a:11a Radio Interface Disabled
Mar 09 11:55:40 Information: 802.11a:Transmit Power set to QUARTER
Press <n> next. <p> previous. <a> abort. <y> continue to end :
Enterprise AP#configure
Enter configuration commands, one per line. End with CTRL/Z
Enterprise AP(config)#logging clear
System Clock Commands
7
These commands are used to configure SNTP and system clock settings on the
bridge.
Table 7-7. System Clock Commands
CommandFunctionModePage
sntp-server ipSpecifies one or more time serversGC7-34
sntp-server enable Accepts time from the specified time serversGC7-34
sntp-server date-timeManually sets the system date and timeGC7-35
sntp-server
daylight-saving
sntp-server timezoneSets the time zone for the bridge’s internal clockGC7-36
show sntpShows current SNTP configuration settingsExec 7-37
Sets the start and end dates for daylight savings timeGC7-36
7-33
Command Line Interface
7
sntp-server ip
This command sets the IP address of the servers to which SNTP time requests are
issued. Use the this command with no arguments to clear all time servers from the
current list.
Syntax
sntp-server ip <1 | 2> <ip>
• 1 - First time server.
• 2 - Second time server.
• ip - IP address of an time server (NTP or SNTP).
Default Setting
137.92.140.80
192.43.244.18
Command Mode
Global Configuration
Command Usage
When SNTP client mode is enabled using the sntp-se rver enable command,
the sntp-server ip command specifies the time servers from which the bridge
polls for time updates. The bridge will poll the time servers in the order
specified until a response is received.
Example
Enterprise AP(config)#sntp-server ip 10.1.0.19
Enterprise AP#
Related Commands
sntp-server enable (7-34)
show sntp (7-37)
sntp-server enable
This command enables SNTP client requests for time synchronization with NTP or
SNTP time servers specified by the sntp-server i p command. Use the no form to
disable SNTP client requests.
Syntax
sntp-server enable
no sntp-server enable
Default Setting
Enabled
7-34
System Clock Commands
Command Mode
Global Configuration
Command Usage
The time acquired from time servers is used to record accurate dates and
times for log events. Without SNTP, the bridge only records the time starting
from the factory default set at the last bootup (i.e., 00:14:00, January 1, 1970).
This example sets the system clock to 17:37 June 19, 2003.
Enterprise AP#sntp-server date-time
Enter Year<1970-2100>: 2003
Enter Month<1-12>: 6
Enter Day<1-31>: 19
Enter Hour<0-23>: 17
Enter Min<0-59>: 37
Enterprise AP#
7
Related Commands
sntp-server enable (7-34)
7-35
Command Line Interface
7
sntp-server daylight-saving
This command sets the start and end dates for daylight savings time. Use the no
form to disable daylight savings time.
Syntax
sntp-server daylight-saving
no sntp-server daylight-saving
Default Setting
Disabled
Command Mode
Global Configuration
Command Usage
The command sets the system clock back one hour during the specified
period.
Example
This sets daylight savings time to be used from July 1st to September 1st.
Enterprise AP(config)#sntp-server daylight-saving
Enter Daylight saving from which month<1-12>: 6
and which day<1-31>: 1
Enter Daylight saving end to which month<1-12>: 9
and which day<1-31>: 1
Enterprise AP(config)#
sntp-server timezone
This command sets the time zone for the bridge’s internal clock.
Syntax
sntp-server timezone <hours>
hours - Number of hours before/after UTC.
(Range: -12 to +12 hours)
Default Setting
-5 (BOGOTA, EASTERN, INDIANA)
Command Mode
Global Configuration
7-36
System Clock Commands
Command Usage
This command sets the local time zone relative to the Coordinated Universal
Time (UTC, formerly Greenwich Mean Time or GMT), based on the earth’s
prime meridian, zero degrees longitude. To display a time corresponding to
your local time, you must indicate the number of hours and minutes your time
zone is east (before) or west (after) of UTC.
This command displays the current time and configuration settings for the SNTP
client.
Command Mode
Exec
Example
Enterprise AP#show sntp
SNTP Information
=========================================================
Service State : Enabled
SNTP (server 1) IP : 137.92.140.80
SNTP (server 2) IP : 192.43.244.18
Current Time : 08 : 04, Jun 20th, 2003
Time Zone : +8 (TAIPEI, BEIJING)
Daylight Saving : Enabled, from Jun, 1st to Sep, 1st
=========================================================
Enterprise AP#
7
7-37
Command Line Interface
7
DHCP Relay Commands
Dynamic Host Configuration Protocol (DHCP) can dynamically allocate an IP
address and other configuration information to network clients that broadcast a
request. To receive the broadcast request, the DHCP server would normally have to
be on the same subnet as the client. However, when the bridge’s DHCP relay agent
is enabled, received client requests can be forwarded directly by the bridge to a
known DHCP server on another subnet. Responses from the DHCP server are
returned to the bridge, which then broadcasts them back to clients.
Table 7-8. DHCP Relay Commands
CommandFunctionModePage
dhcp-relay enableEnables the DHCP relay agentGC7-38
dhcp-relaySets the primary and secondary DHCP server
show dhcp-relayShows current DHCP relay configuration settingsExec 7-39
address
dhcp-relay enable
This command enables the bridge’s DHCP relay agent. Use the no form to disable
the agent.
Syntax
[no] dhcp-rel ay enable
Default Setting
Disabled
Command Mode
Global Configuration
Command Usage
• For the DHCP relay agent to function, the primary DHCP server must be
configured using the dhcp-relay primary command. A secondary DHCP
server does not need to be configured, but it is recommended.
• If there is no response from the primary DHCP server, and a secondary
server has been configured, the agent will then attempt to send DHCP
requests to the secondary server.
This command displays the current DHCP relay configuration.
Command Mode
Exec
Example
Enterprise AP#show dhcp-relay
DHCP Relay : ENABLED
Primary DHCP Server : 192.168.1.10
Secondary DHCP Server : 0.0.0.0
Enterprise AP#
7
7-39
Command Line Interface
7
SNMP Commands
Controls access to this bridge from management stations using the Simple Network
Management Protocol (SNMP), as well as the hosts that will receive trap messages.
Table 7-9. SNMP Commands
CommandFunctionModePage
snmp-ser ver communitySets up th e commun ity ac cess st ring to permit access
snmp-server contact Sets the system contact stringGC7-41
snmp-server location Sets the system location string GC7-42
snmp-server enable server Enables SNMP service and trapsGC7-42
snmp-server host Specifies the recipient of an SNMP notification
snmp-server trapEnables specific SNMP notific atio nsGC7-44
snmp-server engine idSets the engine ID for SNMP v3GC7-45
snmp-server userSets the name of the SNMP v3 userGC7-46
snmp-server targetsConfigures SNMP v3 notification targetsGC7-48
snmp-server filterConfigures SNMP v3 notification filtersGC7-49
snmp-server
filter-assignments
show snmp groupsDisplays the pre-defined SNMP v3 groupsExec7-50
show snmp usersDisplays SNMP v3 user settingsExec7-51
show snmp
group-assignments
show snmp targetDisplays the SNMP v3 notification targetsExec7-52
show snmp filterDisplays the SNMP v3 notification filtersExec7-52
to SNMP commands
operation
Assigns SNMP v3 notification filters to targetsGC7-50
Displays the assignment of users to SNMP v3 groups Exec7-51
GC7-41
GC7-43
show snmp
filter-assignments
show snmpDisplays the status of SNMP communicationsExec 7-54
Displays the SNMP v3 notification filter assi gnm en ts Exec7-53
7-40
SNMP Commands
snmp-server community
This command defines the community access string for the Simple Network
Management Protocol. Use the no form to remove the specified community string.
This command enables SNMP management access and also enables this device to
send SNMP traps (i.e., notifications). Use the no form to disable SNMP service and
trap messages.
Syntax
snmp-server enable ser ver
no sn mp-server enab le server
Default Setting
Enabled
7-42
SNMP Commands
Command Mode
Global Configuration
Command Usage
• This command enables both authentication failure notifications and
link-up-down notifications.
•The snmp- server host command specifies the host device that will receive
SNMP notifications.
Example
Enterprise AP(config)#snmp-server enable server
Enterprise AP(config)#
Related Commands
snmp-server host (7-43)
snmp-server host
This command specifies the recipient of an SNMP notification. Use the no form to
remove the specified host.
• host_ip_address - IP of the host (the targeted recipient).
• host_name - Name of the host. (Range: 1-63 characters)
• community-string - Password-like community string sent with the
notification operation. Although you can set this string using the
snmp-server host command by itself, we recommend that you define this
string using the snmp-s er ver community command prior to using the
This command is used for SNMP v3. It is used to uniquely identify the bridge among
all bridges in the network. Use the no form to delete the engine ID.
Syntax
snmp-server engine-id <engine-id>
no sn mp-server eng ine-id
engine-id - Enter engine-id in hexadecimal (5-32 characters).
Default Setting
Enabled
7-45
Command Line Interface
7
Command Mode
Global Configuration
Command Usage
• This command is used in conjunction with the
• Entering this command invalidates all engine IDs that have been previously
configured.
• If the engineID is deleted or changed, all SNMP users will be cleared. You
will need to reconfigure all existing users
This command configures the SNMP v3 users that are allowed to manage the
bridge. Use the no form to delete an SNMP v3 user.
Syntax
snmp-server user <user-n ame>
user-name - A user-defined string for the SNMP user. (32 characters
maximum)
Default Setting
None
Command Mode
Global Configuration
Command Usage
• Up to 10 SNMPv3 users can be configured on the bridge.
• The SNMP engine ID is used to compute the authentication/privacy digests
from the pass phrase. You should therefore configure the engine ID with the
snmp-server engine-id command before using this configuration
command.
• The bridge enables SNMP v3 users to be assigned to three pre-defined
groups. Other groups cannot be defined. The available groups are:
- RO - A read-only group using no authentication and no data encryption.
Users in this group use no security, either authentication or encryption, in
SNMP messages they send to the agent. This is the same as SNMP v1
or SNMP v2c.
7-46
SNMP Commands
- RWAuth - A read/write group using authentication, but no data
encryption. Users in this group send SNMP messages that use an MD5
key/password for authentication, but not a DES key/password for
encryption.
- RWPriv - A read/write group using authentication and data encryption.
Users in this group send SNMP messages that use an MD5 key/
password for authentication and a DES key/password for encryption.
Both the MD5 and DES key/passwords must be defined.
• The command prompts for the following information to configure an SNMP
v3 user:
- user-name - A user-defined string for the SNMP user. (32 characters
maximum)
- group-name - The name of the SNMP group to which the user is
assigned (32 characters maximum). There are three pre-defined groups:
RO, RWAuth, or RWPriv.
- auth-proto - The authentication type used for user authentication: md5 or
none.
-auth-passphrase - The user password required when authentication is
used (8 – 32 characters).
- priv-proto - The encryption type used for SNMP data encryption: des or
none.
- priv-passphrase - The user password required when data encryption is
used (8 – 32 characters).
• Users must be assigned to groups that have the same security levels. If a
user who has “AuthPriv” security (uses authentication and encryption) is
assigned to a read-only (RO) group, the user will not be able to access the
database. An AuthPriv user must be assigned to the RWPriv group with the
AuthPriv security level.
• To configure a user for the RWAuth group, you must include the auth-proto
and auth-passphrase keywords.
• To configure a user for the RWPriv group, you must include the auth-proto, auth-passphrase, pr iv -p ro to , and priv-passphrase keywords.
Example
Enterprise AP(config)#snmp-server user
User Name<1-32> :chris
Group Name<1-32> :RWPriv
Authtype(md5,<cr>none):md5
Passphrase<8-32>:a good secret
Privacy(des,<cr>none) :des
Passphrase<8-32>:a very good secret
Enterprise AP(config)#
7
7-47
Command Line Interface
7
snmp-server targets
This command configures SNMP v3 notification targets. Use the no form to delete
an SNMP v3 target.
• filter-id - A user-defined name that identifies an SNMP v3 notification filter.
(Maximum length: 32 characters)
• include - Defines a filter type that includes objects in the MIB subtree.
• exclude - Defines a filter type that excludes objects in the MIB subtree.
• subtree - The part of the MIB subtree that is to be filtered.
• mask - An optional hexadecimal value bit mask to define objects in the MIB
subtree.
Default Setting
None
Command Mode
Global Configuration
Command Usage
• The bridge allows up to 10 notification filters to be created. Each filter can
be defined by up to 20 MIB subtree ID entries.
• Use the command more than once with the same filter ID to build a filter that
includes or excludes multiple MIB objects. Note that the filter entries are
applied in the sequence that they are defined.
• The MIB subtree must be defined in the form “.1.3.6.1” and always start with
a “.”.
• The mask is a hexadecimal value with each bit masking the corresponding
ID in the MIB subtree. A “1” in the mask indicates an exact match and a “0”
indicates a “wild card.” For example, a mask value of 0xFFBF provides a bit
mask “1111 1111 1011 1111.” If applied to the subtree
1.3.6.1.2.1.2.2.1.1.23, the zero corresponds to the 10th subtree ID. When
there are more subtree IDs than bits in the mask, the mask is padded with
ones.
This command displays the SNMP v3 notification filter assignments.
Syntax
show snmp filter-assignments
Command Mode
Exec
Example
Enterprise AP#show snmp filter-assignments
HostID FilterID
mytraps trapfilter
Enterprise AP#
7
7-53
Command Line Interface
7
show snmp
This command displays the SNMP configuration settings.
Command Mode
Exec
Example
Enterprise AP#show snmp
SNMP Information
==============================================
Service State : Enable
Community (ro) : *****
Community (rw) : *****
Location : WC-19
Contact : Paul
These commands are used to manage the system code or configuration files.
Table7-10. Flash/File Commands
CommandFunctionModePage
bootfileSpecifies the file or image used to start up the system GC7-55
7
copy Copies a code image or configuration between flash
delete Deletes a file or code image Exec7-57
dir Displays a list of files in flash memory Exec7-58
show bootfileDisplays the name of the current operation code file that
memory and a FTP/TFTP server
booted the system
Exec7-56
Exec7-58
bootfile
This command specifies the image used to start up the system.
Syntax
bootfile <filenam e >
filename - Name of the image file.
Default Setting
None
Command Mode
Exec
Command Usage
• The file name should not contain slashes (\ or /), the leading letter of the file
name should not be a period (.), and the maximum length for file names is
32 characters. (Valid characters: A-Z, a-z, 0-9, “.”, “-”, “_”)
• If the file contains an error, it cannot be set as the default file.
Example
Enterprise AP#bootfile -img.bin
Enterprise AP#
7-55
Command Line Interface
7
copy
This command copies a boot file, code image, or configuration file between the
bridge’s flash memory and a FTP/TFTP server. When you save the configuration
settings to a file on a FTP/TFTP server, that file can later be downloaded to the
bridge to restore system operation. The success of the file transfer depends on the
accessibility of the FTP/TFTP server and the quality of the network connection.
Syntax
copy <ftp | tftp> file
copy config <ftp | tftp>
• ftp - Keyword that allows you to copy to/from an FTP server.
• tftp - Keyword that allows you to copy to/from a TFTP server.
• file - Keyword that allows you to copy to/from a flash memory file.
• config - Keyword that allows you to upload the configuration file from flash
memory.
Default Setting
None
Command Mode
Exec
Command Usage
• The system prompts for data required to complete the copy command.
• Only a configuration file can be uploaded to an FTP/TFTP server, but every
type of file can be downloaded to the bridge.
•
The destination file name should not contain slashes (\ or /),
letter of the file name should not be a period (.), and the maximum length
for file names on the FTP/TFTP server is 255 characters or 32 characters
for files on the bridge. (Valid characters: A-Z, a-z, 0-9, “.”, “-”, “_”)
• Due to the size limit of the flash memory, the bridge supports only two
operation code files.
• The system configuration file must be named “syscfg” in all copy
commands.
Example
The following example shows how to upload the configuration settings to a file on
the TFTP server:
The following example shows how to download a configuration file:
Enterprise AP#copy tftp file
1. Application image
2. Config file
3. Boot block image
Select the type of download<1,2,3>: [1]:2
TFTP Source file name:syscfg
TFTP Server IP:192.168.1.19
Enterprise AP#
delete
This command deletes a file or image.
Syntax
delete <filename>
filename - Name of the configuration file or image name.
Default Setting
None
Command Mode
Exec
Caution: Beware of deleting application images from flash memory. At least one
application image is required in order to boot the bridge. If there are multiple
image files in flash memory, and the one used to boot the bridge is deleted, be
sure you first use the bootfile command to update the application image file
booted at startup before you reboot the bridge.
7
Example
This example shows how to delete the test.cfg configuration file from flash memory.
Enterprise AP#delete test.cfg
Are you sure you wish to delete this file? <y/n>:
Enterprise AP#
Related Commands
bootfile (7-55)
dir (7-58)
7-57
Command Line Interface
7
dir
This command displays a list of files in flash memory.
Command Mode
Exec
Command Usage
File information is shown below:
Column HeadingDescription
File NameThe name of the file.
Type(2) Operation Code and (5) Configuration file
File SizeThe length of the file in bytes.
Example
The following example shows how to display all file information:
This command displays the name of the current operation code file that booted the
system.
Syntax
show snmp filter-assignments
Command Mode
Exec
Example
Enterprise AP#show bootfile
Bootfile Information
===================================
Bootfile : ec-img.bin
===================================
Enterprise AP#
7-58
RADIUS Client
RADIUS Client
Remote Authentication Dial-in User Service (RADIUS) is a logon authentication
protocol that uses software running on a central server to control access for
RADIUS-aware devices to the network. An authentication server contains a
database of credentials, such as users names and passwords, for each wireless
client that requires access to the bridge.
Table7-11. RADIUS Client
CommandFunctionModePage
radius-server addressSpecifies the RADIUS server GC7-59
radius-server port Sets the RADIUS server network port GC7-60
radius-server key Sets the RADIUS encryption key GC7-60
radius-server retransmit Sets the number of retries GC7-61
7
radius-server timeout Sets the interval between sending authentication
radius-server
port-accounting
radius-server
timeout-interim
radius-server
radius-mac-format
radius-server vlan-formatSets the format for specifying VLAN IDs on the
show radiusShows the current RADIUS sett ing sExec7-6 4
requests
Sets the RADIUS Accounting server network portGC7-62
Sets the interval between transmitting accounting
updates to the RADIUS server
Sets the format for specifying MAC addresses on the
RADIUS server
RADIUS server
GC7-61
GC7-62
GC7-63
GC7-63
radius-server address
This command specifies the primary and secondary RADIUS servers.