Download: Mirror Download [FCC.gov] Document ID 827939 Application ID us5akyksSN6LkGWFoevg2Q== Document Description User Manual 2 Short Term Confidential No Permanent Confidential No Supercede No Document Type User Manual Display Format Adobe Acrobat PDF - pdf Filesize 116.44kB (1455504 bits) Date Submitted 2007-08-10 00:00:00 Date Available 2007-08-10 00:00:00 Creation Date 2007-05-14 03:57:37 Producing Software Acrobat Distiller 7.0.5 (Windows) Document Lastmod 2007-08-08 16:45:41 Document Title IxWLANUserGuide.book Document Creator FrameMaker 7.1 Document Author: eramboi
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
Cipher ....................
Data Encryption ...........
Shared-key Index ..........
Fragmentation Threshold ...
RTS Threshold .............
Mode ......................
Layer ..................
Load Application ..........
Target IP Address .........
Ping Transmit Count .......
Ping Data Size ............
WEP(RC4)
Off
2346
2346
internal
ping
10.1.83.1
100
1024
NOTE: By default, all virtual stations that are created in the CLI are assigned to
group 1. This can be changed using the set vsta group
command.
autorun
Automatically runs one or more configured virtual stations that are in the ready
state. It is intended for use in conjunction with the autoconf command. Any
other use may produce unexpected results.The command issues the run command for the specified number of virtual stations.
autorun [nVstas]
[nVstas]: Optional number of virtual stations (1…128). If this parameter is omitted, the total number of auto-configured (autoconf) virtual stations is used.
clear group
Clears the certfile, SSID, or statistics for the specified vSTA or all vSTAs within
the specified group.
clear group
Valid objects are:
: Clears vSTA group certfile names.
: Clears vSTA group SSIDs.
: Clears vSTA group statistics.
clear vsta
Clears all statistics for one or more virtual stations.
clear vsta :all:master:
: Virtual Station ID (1…128), all, or master. If is set to all
(that is, clear vsta all stats), this command clears all statistics for all virtual stations. If is set to master (that is, clear vsta master stats), this command
clears all statistics for IxWLAN.
IxWLAN User Guide, Release 6.20
5-23
5
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
Example:
[wport1]IxWLAN -> clear vsta 1 stats
[wport1]IxWLAN ->
Valid objects are:
: Clears vSTA certfile names.
: Clears vSTA SSIDs.
: Clears vSTA statistics.
conf
Configures a virtual station. It specifies a virtual station's IP address, WLAN
MAC address, and load application mode. It also specifies the load application
protocol, target host, and application specific parameters. After a virtual station is
configured, it must be initialized using the init command. The virtual station’s
wport attribute defaults to the current wport.
conf
: Virtual Station ID (1…128)
: Specifies the virtual station’s WLAN IP address
(nnn.nnn.nnn.nnn) or a . can be on, off, or auto. on
= manual (needs the acquireip command to start), off = DHCP is not active.
vSTA(s) must have a static IP address, auto = initiate lease negotiation if association succeeds.
: Virtual station’s WLAN MAC address (xx:xx:xx:xx:xx:xx). The starting
MAC address must be within the range of MAC addresses defined by the WLAN
Base MAC Address and WLAN MAC Mask configured for the specified wport
(see set wlanmac on page 5-85 and set wlanmask on page 5-85).
: external or internal. If external mode is used, the remaining parameters
( ) are optional.
: Specifies the Load Application Protocol (ping).
: Target IP address (nnn.nnn.nnn.nnn)
: Number of ICMP Echo Requests to transmit: 0…2,147,483,647.
: Number of data bytes to be included in ICMP Echo Requests: 64…1024.
The conf command does not include the full set of attributes that can be assigned
to a virtual station. When these attributes are not otherwise specified, IxWLAN
uses the default values for these attributes, as listed in Table 5-1 on page 5-25.
5-24
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
Table 5-1.
Attributes
Attribute
Default Value
authentication
open-system
certfile
(not set)
cipher
wep
csmode
persistent
dhcplease
3600
dhcpretry
dhcpinterval
dhcpoffers
dhcpserver
0.0.0.0
eapalgorithm
tls
encryption
off
fastradius
disabled
fragmentthreshold
2346
gateway
0.0.0.0
group
inneralgorithm
ms-chapv2
ipmask
255.255.255.0
keyindex
0 (not defined)
kmtime-out
0 (that is, no time-out)
layer
outeridentity
(not set)
passphrase
(not set)
password
(not set)
pmkcache
enabled
psk
(not set)
retry
roamtype
reassociation
rtsthreshold
2346
timeout
300
SSID
(not set)
IxWLAN User Guide, Release 6.20
5-25
5
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
Attribute
Default Value
userid
(not set)
wport
The set vsta command allows you to change any of these default values.
Example:
[wport1]IxWLAN
1024
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
-> conf 3 10.1.40.20 00:0b:cd:59:00:01 internal ping 10.1.40.16 64000
->
->
->
->
->
->
->
OK
conf 1 10.1.35.150 02:CF:1F:00:00:01 int ping 10.1.35.38 10 1024
OK
conf 1 on 02:CF:1F:00:00:01 int ping 10.1.35.38 10 1024
OK
conf 1 auto 02:CF:1F:00:00:01 int ping 10.1.35.38 10 1024
OK
NOTE: By default, all virtual stations that are created in the CLI are assigned to
group 1. This can be changed using the set vsta group
command.
deauth
Starts the de-authentication sequence for one or more virtual stations. This
sequence also drops any WPA/RSN security associations. The virtual station(s)
must be configured, initialized, and authenticated before this command can be
used. The following command starts the de-authentication sequence for one or all
virtual stations.
deauth vsta
: Virtual Station ID (1…128) or all. If is set to all (that is,
deauth vsta all), the de-authentication sequence is initiated for all virtual stations.
The following command starts the de-authentication sequence for all virtual stations in a specified group.
deauth group
: Group ID (1…128)
Example:
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
2003
[wport1]IxWLAN
5-26
-> deauth vsta 1
-> OK
-> vSTA ID:1 NOTIFY Operation DEAUTH succeeded - TUE JUL 15 03:09:56
->
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
del group
Clears all configuration parameters for a specified group and removes the group
from the system.
del group
: Group Number (1…128)
Example:
[wport1]IxWLAN -> del
5 vSTAs deleted
[wport1]IxWLAN -> OK
[wport1]IxWLAN ->vSTA
07:35:27 2003
[wport1]IxWLAN -> OK
[wport1]IxWLAN ->vSTA
07:35:27 2003
[wport1]IxWLAN -> OK
[wport1]IxWLAN ->vSTA
07:35:27 2003
[wport1]IxWLAN -> OK
[wport1]IxWLAN ->vSTA
07:35:28 2003
[wport1]IxWLAN -> OK
[wport1]IxWLAN ->vSTA
07:35:28 2003
[wport1]IxWLAN ->
del vSTA
group 2
ID:6 NOTIFY DELETED - reason: delete command - WED JUL 16
ID:7 NOTIFY DELETED - reason: delete command - WED JUL 16
ID:8 NOTIFY DELETED - reason: delete command - WED JUL 16
ID:9 NOTIFY DELETED - reason: delete command - WED JUL 16
ID:10 NOTIFY DELETED - reason: delete command - WED JUL 16
Clears all configuration attributes for one or more virtual stations and removes
the virtual station(s) from the system.
del vsta
: Virtual Station ID (1…128) or all. If is set to all (that is, del
vsta all), all virtual stations are deleted.
Example:
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
07:44:09 2003
[wport1]IxWLAN
disassoc
-> del vsta 1
-> OK
->vSTA ID:1 NOTIFY DELETED - reason: delete command - WED JUL 16
->
Starts the 802.11 disassociation sequence for one or more virtual stations. This
sequence also drops any WPA/RSN security associations. The virtual station(s)
must be configured, initialized, authenticated, and associated before this command can be used. The following command starts the disassociation sequence for
one or all virtual stations.
disassoc vsta
IxWLAN User Guide, Release 6.20
5-27
5
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
: Virtual Station ID (1…128) or all. If is set to all (that is, disassoc vsta all), the disassociation sequence starts for all virtual stations.
The following command initiates the disassociation sequence for all virtual stations in a specified group.
disassoc group
: Group ID (1…128)
Example:
[wport1]IxWLAN -> disassoc vsta 1
[wport1]IxWLAN -> OK
[wport1]IxWLAN ->vSTA ID:1 NOTIFY Operation DISASSOC
succeeded - TUE JUL 15 03:09:50 2003
[wport1]IxWLAN ->
get group
Retrieves and shows a configuration parameter or statistics for all virtual stations
in a group.
get group
: Group Number (1…128). If is summary, you may specify
all as the group number (that is, get group all summary) to show summary statistics for all groups.
: The attribute of the information to get/display. It can be one of the
following (See set group on page 5-42 for a more detailed description of the
information that may be shown by each of these attributes):
5-28
•
authentication: Shows the group’s authentication mode (open-system,
shared-key, wpa-psk, wpa, rsn, or rsn-psk).
•
certfile: If authentication is rsn or wpa, shows the group’s certificate file
name.
•
cipher: Shows the group’s cipher mode (wep, tkip, or aes-ccm).
•
conf: Displays the group’s configuration and adds the wports assigned to it.
•
count: If mode is internal, shows the configured ping count
(0…2,147,483,647).
•
csmode: Shows the group’s connection mode (persistent or non-persistent)
•
dhcpinfo: If dhcpmode is on or auto, shows DHCP information.
•
dhcpmode: Shows the DHCP Mode setting (on, off, or auto).
•
dhcplease: Displays the dhcpLease attribute of the specified vSTA, all
vSTAs, or all vSTAs within the specified group.
•
dhcpretry: Displays the dhcpRetry attribute of the specified vSTA, all vSTAs,
or all vSTAs within the specified group.
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
•
dhcpinterval: Displays the dhcpInterval attribute of the specified vSTA, all
vSTAs, or all vSTAs within the specified group.
•
dhcpoffers: Displays the dhcpOffer attribute of the specified vSTA, all
vSTAs, or all vSTAs within the specified group.
•
dhcpserver: Displays the dhcpServer attribute of the specified vSTA, all
vSTAs, or all vSTAs within the specified group.
•
eapalgorithm: If authentication mode is rsn or wpa, shows the group's
authentication protocol: TLS, PEAP, or TTLS.
•
encryption: Shows the group’s encryption mode: on or off.
•
fastradius: Shows the group’s fast RADIUS reconnection mode: enabled or
disabled.
•
fragmentthreshold: Shows the fragmentation threshold setting (256…2346).
•
gateway: Displays the gateway attribute of the specified vSTA or all vSTAs
within the specified group.
•
inneralgorithm: If eapalgorithm is peap or ttls, shows the group's Phase 2
authentication algorithm: ms-chapv2 or eap-ms-chapv2.
•
ipmask: Displays the ipmask attribute of the specified vSTA or all vSTAs
within the specified group.
•
keyindex: Shows the group’s shared-key index (1, 2, 3, or 4).
•
kmTimeout: AKMP Timeout shows the wait state timer for virtual stations in
this group.
•
layer: If mode is external, shows the method (layer 2 or 3) that is used to capture external data frames.
•
lp: Shows the group’s load protocol: ping.
•
mode: Shows the group’s test mode (external or internal)
•
outeridentity: If eapalgorithm is peap or ttls, shows the group's separate user
ID that is used in Phase 1 authentication. It can be a string of up to 64 characters.
•
passphrase: If authentication is rsn-psk or wpa-psk, shows the group's passphrase (up to 63 ASCII characters).
•
password: If eapalgorithm is peap or ttls, shows the group's password that is
used in Phase 2 authentication. It can be a string of up to 64 characters.
•
pmkcache: Shows the group’s PMKSA cache mode: enabled or disabled.
•
psk: If authentication is rsn-psk or wpa-psk, shows the group's Pre-Shared
Key (64 ASCII-hex characters).
•
retry: Shows the configured Authentication/Association retry limit
(1…2,147,483,647 or zero (=no retries)).
•
roamtype: Shows the group’s Roam type: reassociation or disassociation.
•
rtsthreshold: Shows the group’s RTS threshold setting (1…2346).
•
size: If mode is internal, shows the configured ping packet size (64…1024).
IxWLAN User Guide, Release 6.20
5-29
5
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
•
ssid: Shows the group’s SSIDs.
•
state: Shows the current state of each virtual station in the group.
•
stats: Shows statistics counters for all virtual stations in a group.
•
summary: Shows cumulative summary statistics for all virtual stations in one
or all groups.
•
target: If mode is internal, shows the configured target IP address.
•
timeout: Shows the configured Authentication/Association timeout in milliseconds (1…2,147,483,647 or zero (0=immediate timeout)).
•
userid: For groups configured for WPA or RSN authentication and a certificate file, shows the group’s user ID string that is needed for the certificate
file.
•
wport: Displays the wport assigned the identified group.
Example:
[wport1]IxWLAN ->
vSTA 1 connection
vSTA 2 connection
vSTA 3 connection
vSTA 4 connection
vSTA 5 connection
5 vSTAs found
[wport1]IxWLAN ->
get vsta
get group 1 csmode
mode: persistent
mode: persistent
mode: persistent
mode: persistent
mode: persistent
Retrieves and displays a configuration attribute or statistics for one or all virtual
stations.
get vsta
: Virtual Station ID (1…128). Use all to show for all virtual
stations. If is set to stats to show statistics, the can be set to
master to show statistics for IxWLAN (that is, get vsta master stats). If
is summary, must be set to all.
: The attribute of the information to get. Omit this attribute (for
example, get vsta 1) to show a virtual station's complete configuration or use one
of the following attributes to show a specific configuration attribute. See set vsta
on page 5-46 for a more detailed description of the information that can be shown
by each of these attributes.
5-30
•
authentication: Shows the virtual station’s authentication mode: open-system, shared-key, rsn, rsn-psk, wpa, or wpa-psk.
•
certfile: If authentication is wpa or rsn, shows the virtual station’s certificate
file name.
•
cipher: Shows the virtual station’s cipher mode: wep, tkip, or aes-ccm.
•
conf: Shows the virtual station's complete configuration data.
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
•
count: If mode is internal, shows the configured ping count
(0…2,147,483,647).
•
csmode: Displays the virtual station’s connection mode: persistent or nonpersistent.
•
dhcpinfo: If dhcpmode is on or auto, shows DHCP information.
•
dhcpmode: Displays the DHCP Mode setting: on, off, or auto.
•
dhcplease: Displays the dhcpLease attribute of the specified vSTA.
•
dhcpretry: Displays the dhcpRetry attribute of the specified vSTA.
•
dhcpinterval: Displays the dhcpInterval attribute of the specified vSTA.
•
dhcpoffers: Displays the dhcpOffer attribute of the specified vSTA.
•
dhcpserver: Displays the dhcpServer attribute of the specified vSTA.
•
eapalgorithm: If authentication mode is rsn or wpa, shows the authentication
protocol: tls, peap, or ttls.
•
encryption: Shows the virtual station’s encryption mode: on or off.
•
fastradius: Shows the virtual station’s fast RADIUS reconnection mode:
enabled or disabled.
•
fragmentthreshold: Shows the fragmentation threshold setting (256…2346).
•
gateway: Displays the gateway attribute of the specified vSTA.
•
inneralgorithm: If eapalgorithm is range or ttls, shows the inner algorithm
(ms-chapv2 or eap-ms-chapv2) to be used in Phase 2 authentication.
•
ipmask: Displays the ipmask attribute of the specified vSTA.
•
keyindex: If encryption is on, shows the virtual station’s shared-key index (1,
2, 3, or 4).
•
kmTimeout: AKMP Timeout shows the virtual station’s wait state timer.
•
layer: Shows the method (layer 2 or 3) used to capture external data frames.
•
lp: If mode is internal, shows the virtual station’s Load Protocol (ping).
•
mode: Shows the virtual station’s test mode: external or internal.
•
outeridentity: If eapalgorithm is peap or ttls, shows the user ID that is used in
Phase 1 authentication algorithm. It can be a string of up to 64 characters.
•
passphrase: If authentication is rsn-psk or wpa-psk, shows the passphrase
(up to 63 ASCII characters) assigned to one or more virtual stations.
•
password: If eapalgorithm is peap or ttls, shows the user password that is
used in Phase 2 authentication. It can be a string of up to 64 characters.
•
pmkcache: Shows the virtual station’s PMKSA cache mode: enabled or disabled.
•
psk: If authentication is rsn-psk or wpa-psk, shows the Pre-Shared Key (64
ASCII-hex characters) assigned to one or more virtual stations.
•
retry: Shows the Authentication/Association retry limit (1…2,147,483,647 or
zero (0=no retries)).
IxWLAN User Guide, Release 6.20
5-31
5
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
•
roamtype: Shows the virtual station’s Roam type: reassociation or disassociation.
•
rtsthreshold: Shows the RTS threshold setting (1…2346).
•
size: If mode is internal, shows the configured ping packet size (64…1024).
•
ssid: Shows the vSTA’s SSID.
•
state: Shows the virtual station’s current state.
•
stats: Depending on the value of , shows statistics counters for one virtual station, all virtual stations, or IxWLAN.
•
summary: Shows cumulative summary statistics for all virtual stations
•
target: If mode is internal, shows the configured ping target IP address (that
is, 10.1.35.100).
•
timeout: Shows the Authentication/Association timeout in milliseconds
(1…2,147,483,647 or zero (0=immediate timeout)).
•
userid: For virtual stations configured for WPA or RSN authentication and a
certificate file (certfile), shows the user ID string that is needed for the certificate file.
•
wport: Displays the wport assigned the identified vSTA(s).
Example for get vsta dhcpinfo:
[wport1]IxWLAN -> get vsta 1 dhcpinfo
** vSTA 1 DHCP Lease Information **
State ............ BOUND
Last XID ......... 0x0000167e
Try limit ........ 4
Current try ...... 0
Offer limit ...... 1
Current offer .... 1
Try interval ..... 8 (Secs)
Current timer .... 0 (Secs)
Pkts xmtd ok ..... 2
DISCOVERs ...... 1
REQUESTs ....... 1
RENEWALs ...... 0
REBINDs ........ 0
RELEASEs ....... 0
DECLINEs ....... 0
Pkts xmtd err .... 0
Pkts rcvd ok ..... 3
OFFERs ......... 2
ACKs ........... 1
NAKs ........... 0
Pkts rcvd err .... 0
state err ...... 0
xid err ........ 1
Requested lease .. 3600
Lease duration ... 3600
Expiration ticks . 3577
Renewal ticks .... 1777
Rebind ticks ..... 3127
5-32
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
Leased Address ...
DHCP Server ......
Relay ............
Server/relay MAC .
Subnet Mask ......
Gateway ..........
DNS Server .......
[wport1]IxWLAN ->
10.1.35.56
10.2.10.10
10.1.35.1
00:00:00:00:00:00
255.255.255.0
10.1.35.1
0.0.0.0
Example for get vsta conf:
[wport1]IxWLAN -> get vsta 1 conf
vSTA Configuration:
ID ........................ 1
Group ID .................. 1
wport...................... 1
IP Address ................ 10.1.83.2
DHCP ................... Off
MAC Address ............... 00:0b:16:01:00:01
Connection Mode ........... persistent
Auth/Assoc Retry .......... 2
Authentication Timeout .... 300 mSec
Association Timeout ....... 300 mSec
Authentication ............ RSN
Pre-Shared Key ............ Not set
Passphrase ................ Not set
EAP Algorithm.............. TTLS
Inner Auth Algorithm....... ms-chapv2
Certfile .................. jqp.pfx
Userid .................... jqp
Wport ..................... 3
Password................... one1two2three3
Outer ID................... OuterIDString
AKMP Timeout .............. 0 Seconds
Cipher .................... AES-CCM
Data Encryption ........... On
Shared-key Index .......... 0
Fragmentation Threshold ... 2346
RTS Threshold ............. 2346
Mode ...................... External
Layer .................. 2
Load Application .......... ping
Target IP Address ......... 10.1.83.253
Ping Transmit Count ....... 1000
Ping Data Size ............ 1024
[wport1]IxWLAN ->
Example for get vsta count:
[wport1]IxWLAN -> get vsta 1 count
vSTA 1 Ping count: 1000
[wport1]IxWLAN ->
Example for get vsta state:
[wport1]IxWLAN -> get vsta 1 state
IxWLAN User Guide, Release 6.20
5-33
5
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
vSTA: 1
State: Running
Mode: internal
vStaPingRcv:Active
vStaPingXmt:Active
[wport1]IxWLAN ->
Example for get vsta stats:
[wport1]IxWLAN -> get vsta 1 stats
vSTA 1: MAC 00:0b:cd:59:00:01, IP 10.1.35.150, State:
Running
Authentications:
1,
Deauthentications:
Associations:
1,
Disassociations:
Rcv Sig Strength:
72,
Ack Sig Strength:
83
Rcv Rate: 24,
Tx SF Rate: 54,
Tx LF Rate: 54
Frame counts: MSDUs
Data
Mcast
Mgmt
Ctrl
Rcv
240
238
Tx
95
97
vSTA 1 Ping statistics:
Transmit count:
1000
Transmit data size:
1024
Packets transmitted:
96
Round-trip (uSec):
Bytes transmitted:
99072
Min:
50000
Transmit ENOBUFS:
Max:
100000
Packets received:
96
Avg:
74725
Bytes received:
99072
Stddev:
25137
vSTA 1 WPA/RSN statistics:
Total EAPOL Frames Tx: 0, WPA/RSN Auth Failure Ct: 0
Total EAPOL Frames Rx: 0, WPA/RSN Authentication Ct: 0
EAPOL Key Frames Rx: 0, EAPOL Key Frames Tx: 0
EAPOL Request Frames Rx: 0, Invalid EAPOL Frames Rx: 0
EAPOL Rsp Id Frames Tx: 0, EAPOL Rsp Frames Tx: 0
EAPOL Req Id Frames Rx: 0, EAPOL Len Err Frames Rx: 0
4Way Handshake Msg1 Rx: 0, 4Way Handshake Msg2 Tx: 0
4Way Handshake Msg3 Rx: 0, 4Way Handshake Msg4 Tx: 0
Group Key Msg1 Rx: 0, Group Key Msg2 Tx: 0
TKIP Local MIC Failures: 0, TKIP Rply Ctr Failures: 0
TKIP ICV Errors: 0, CCMP Rply Ctr Failures: 0
CCMP Decrypt Errors: 0, MIC Failure Reports Tx: 0
Last EAPOL Frame Ver: 0, EAPOL Start Frames Tx: 0
Rcv Errors:
Rcv PHY Errors:
Rcv CRC Errors:
Rcv Duplicates:
Rcv Discarded:
Ack Rcv Fails:
Encryption:
Rcv Decrypt Errs:
[wport1]IxWLAN ->
1,
1,
0,
0,
0,
0,
Off,
0,
Tx Errors:
Excess Retries:
Total Retries:
Tx Filtered:
Tx Discarded:
RTS Fails:
FCS Fails:
WEP Excluded:
Example for get vsta all summary:
[wport1]IxWLAN -> get vsta all summary
Summary statistics for 5 vSTAs:
5-34
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
Authentications:
Deauthentications:
Associations:
Disassociations:
Pre-Authentication: 2 attempts, 1 successful, 1 failed
PMKSA cache: 2 entries BSSID
PMKID
entry 0 00:12:d9:c4:1d:d0 0x62151d5ca3b2c4ea8545842f9a7adb6b
entry 1 00:15:70:00:77:50 0x7dad3ec63036b7af087bd9c595035e50
Signal Quality:
Min
Max
Avg
Rcv Strength
61
36
Ack Strength
60
35
Rcv Rate
54
54
54
Tx SF Rate
54
54
54
Tx LF Rate
54
54
54
Rcv Frames:
Min
Max
Avg
Total
MSDUs
10
30
Data
Multicast
Management
18
Control
12
Error
Tx Frames:
Min
Max
Avg
Total
MSDUs
12
Data
Multicast
Management
12
Control
Error
Tx Retries
Rcv Errors:
0,
Tx Errors:
Rcv PHY Errors:
0,
Excess Retries:
Rcv CRC Errors:
0,
Total Retries:
Rcv Duplicates:
3,
Tx Filtered:
Rcv Discarded:
0,
Tx Discarded:
Ack Rcv Fails:
0,
RTS Fails:
Rcv Decrypt Errs:
0,
WEP Excluded:
FCS Fails:
WPA statistics:
Min
Max
Avg
Total
Auth Okay
Auth Fail
EAPOL Rx
EAPOL Tx
EAPOL Key Rx
EAPOL Key Tx
EAPOL Req Rx
EAPOL Rsp Tx
EAPOL Req Id Rx
EAPOL Rsp Id Tx
EAPOL Start Tx
EAPOL Inv Rx
EAPOL Len Err Rx
4Way Msg1 Rx
4Way Msg2 Tx
4Way Msg3 Rx
4Way Msg4 Tx
Grp Key Msg1 Rx
Grp Key Msg2 Tx
TKIP Lcl Mic Fail
IxWLAN User Guide, Release 6.20
5-35
5
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
TKIP Rply Fail
TKIP ICV Err
CCMP Dcrpt Err
CCMP Rply Fail
MIC Fail Rpt Tx
[wport1]IxWLAN ->
Example for get vsta all wport:
[wport2]IxWLAN -> get vsta all wport
vSTA 1 Wport: 2
vSTA 2 Wport: 2
vSTA 3 Wport: 1
halt
Starts an immediate halt of the load application currently being run by one or
more virtual stations. The virtual station(s) must be configured, initialized,
authenticated, associated, and running a load application. As long as the specified
virtual station remains in the associated state, the load application may be restarted by issuing a run command. The following command executes a halt for
one or all virtual stations.
halt vsta :all
: Virtual Station ID (1…128) or all. If is set to all (that is, halt
vsta all), the halt command is sent to all virtual stations.
The following command executes the halt for all virtual stations in a group.
halt group
: Group ID (1…128)
Example:
[wport1]IxWLAN -> halt vsta 1
[wport1]IxWLAN ->
vSTA ID:1 halted OK
[wport1]IxWLAN ->
init
Initialize one or more virtual stations. A virtual station must be configured before
it can be initialized. See conf on page 5-24.
The following command initializes one or all virtual stations.
init vsta : all
: Virtual Station ID (1…128) or all. If is set to all (that is, init
vsta all), all virtual stations are initialized.
The following command initializes all virtual stations in a specified group.
5-36
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
init group
: Group ID (1…128)
Example:
[wport1]IxWLAN -> init vsta 1
[wport1]IxWLAN -> OK
[wport1]IxWLAN ->
preauth
Starts the 802.11i pre-authentication with the indicated BSSID. The vSTA’s
authentication mode must be RSN and the vSTA must be in the Ready or Running state with its current BSS. IxWLAN stores the PMKSA resulting from a
successful Preauthentication completion in the corresponding vSTA PMKSA
cache.
The following command starts the 802.11i pre-authentication for one or for all
virtual stations.
preauth vsta
: Virtual Station ID (1…128) or all. If is set to all (that is, init
vsta all), all virtual stations are initialized.
Example:
[wport1]IxWLAN -> preauth vsta 1 00:0B:CD:59:23:44
[wport1]IxWLAN -> OK
vSTA ID:1 NOTIFY Preauth with remote AP succeeded - THU FEB 23 18:15:50 2006
The following command starts the 802.11i pre-authentication for all virtual
stations within a specified group.
preauth group
: Group ID (1…128).
releaseip
Releases the specified virtual station’s DHCP IP address lease. Following successful completion of this command, the specified virtual station(s) transit(s) to
the lowest state needed to initiate DHCP lease negotiations. The vSTA’s current
IP address is set to zero. If the vSTA is operating in internal mode, it is removed
from the ARP table.
The following command releases the DHCP IP address lease for one or all virtual
stations.
releaseip vsta
: Virtual Station ID (1…128) or all. If is set to all (that is,
releaseip vsta all), the DHCP IP address lease is released for all virtual stations.
IxWLAN User Guide, Release 6.20
5-37
5
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
The following command releases the DHCP IP address lease for all virtual stations in a specified group.
releaseip group
: Group ID (1…128)
Example:
[wport1]IxWLAN -> releaseip vsta 1
[wport1]IxWLAN -> 10.1.35.10 (10.1.35.10) deleted
OK
reset group
Resets all virtual stations in a group to the Initialized state and clears all group
statistics counters.
reset group
: Group Number (1…128)
Example:
[wport1]IxWLAN -> reset group 1
5 vSTAs reset
[wport1]IxWLAN ->
reset vsta
Resets virtual stations to the Initialized state and clears the virtual station's statistics counters.
reset vsta
: Virtual Station ID (1…128) or all. If is set to all (that is,
reset vsta all), this command resets all virtual stations.
Example:
[wport1]IxWLAN -> reset vsta 1
[wport1]IxWLAN ->
roam
Starts a Roam of the specified vSTAs to the target AP indicated by its BSSID.
The following command roams the identified vSTA(s) to the BSS. The Roam
sequence includes a Probe Request for each vSTA unless the noprobe option is
present. The Roam sequence includes the 802.11 authentication for each vSTA
unless the noauth option is present.
roam vsta|group |all [noprobe] [noauth]
: the virtual station or group identifier
5-38
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
: the BSSID to which the vSTA(s) are to roam
Example for roam vsta all [noprobe] [noauth]:
roam vsta all 00:06:2e:35:6b:1d noprobe
Example for roam vsta [noprobe] [noauth]:
roam vsta 6 00:06:2e:35:6b:1d noprobe
Example for roam group [noprobe] [noauth]:
roam group 2 00:06:2e:35:6b:1d noprobe
run
Starts running the load application for one or more virtual stations. The virtual
station(s) must be configured, initialized, authenticated, and associated before
issuing this command. After a run command has completed, it may be reissued/
restarted as long as the virtual station remains in the associated state. The following command starts running the load application for one or all virtual stations.
run vsta
: Virtual Station ID (1…128) or all. If is set to all (that is, run
vsta all), the run command is sent to all virtual stations.
The following command starts running the load application for all virtual stations
in a specified group.
run group
= Group ID (1…128)
Example:
[wport1]IxWLAN ->run vsta 1
[wport1]IxWLAN ->
vSTA ID:1 running OK
[wport1]IxWLAN ->vSTA ID:1 NOTIFY Operation RUN completed.
[wport1]IxWLAN ->
save group(stats/
summary)
save group stats
Saves statistics information in a file for all virtual stations in a specified group.
Each virtual station in the group is saved to its own file. The file is stored in the /
Statistics subdirectory and named Vsta#Stats.dat (where # is the virtual station
ID).
IxWLAN User Guide, Release 6.20
5-39
5
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
save group stats
: Group ID (1…128)
save group summary
Saves cumulative summary statistics in a file for all virtual stations in one or all
groups. Each group is saved to its own file. The file is stored in the /Statistics
subdirectory and named Grp#Summ.dat (where # is the group ID).
save group summary
: Group ID (1…128) or all. If is set to all (that is, save group all
summary), summary statistics are saved for all virtual stations in all groups.
save vsta(stats/
summary)
save vsta stats
Writes all statistics for virtual stations to a file in the flash file system. The file is
stored in the /Statistics subdirectory and named Vsta#Stats.dat (where # is the
virtual station ID).
save vsta stats
: Virtual Station ID (1…128), all, or master. If is set to all
(that is, save vsta all stats), statistics for all virtual stations are written to individual files. If is set to master (that is, save vsta master stats), IxWLAN
statistics information are written in the /Statistics/VstaMasterStats.dat file.
Example:
[wport1]IxWLAN -> save vsta 1 stats
Wrote vSTA 1 statistics to file
[wport1]IxWLAN ->
save vsta all summary
Saves cumulative summary statistics for all virtual stations to the /Statistics/
VstaAllSumm.dat file.
save vsta all summary
Example:
[wport1]IxWLAN -> save vsta all summary
Wrote vSTA all summary to file
[wport1]IxWLAN ->
sendprobe
5-40
Starts the probe operation for the specified vSTA or group. The only state restrictions placed on a probe operation are:
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
•
The vSTA must be in Initialized state or higher
•
IxWLAN must be joined with an AP.
sendprobe
A given IxWLAN may have many SSIDs configured, a global SSID, and up to
128 per-vSTA SSIDs.
The rules that determine which SSID is used when a specific vSTA probes, associates, and re-associates with an AP are:
•
If a vSTA’s SSID attribute is set, it is always used.
•
If a vSTA’s SSID attribute is not set and the AP beacons a hidden SSID, the
SSID used is either the global IxWLAN SSID (if set) or the broadcast SSID.
•
If a vSTA’s SSID attribute is not set and the AP does not beacon a hidden
SSID, the SSID contained within the AP’s beacon frame is used.
•
The global IxWLAN SSID is set by default to be string “IxWLAN Test Wireless Network,” which is interpreted by the IxWLAN as not set.
A probe request frame is constructed and transmitted for the specified vSTA or
for each vSTA within the specified group. The SSID information element in the
probe request is set by using the previously stated rules.
The probe operation consists of probe transmission, waiting on a probe response,
and retrying if no response is received within a timeout period.
A NOTIFY message is generated upon completion of a probe operation. The status field indicates if a response was received or not.
IxWLAN User Guide, Release 6.20
5-41
5
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
Example:
sendprobe vsta 1
vSTA ID:1 NOTIFY Operation PROBE succeddedsendprobe vsta 2
vSTA ID:2 NOTIFY Operation PROBE failed-reason:No response from AP-
set group
Modifies configuration attributes for all virtual stations in a specified group.
set group
: Group Number (1…128)
/: The allowable / combinations are
defined in Table 5-2.
Table 5-2.
Allowable Attributes
Default
authentication
open-system, shared-key, rsn, rsn-psk, wpa, or wpa-psk
open-system
certfile
certificate file name string
none
cipher
wep, tkip, or aes-ccm
wep
count
0…2,147,483,647
1000
csmode
persistent or non-persistent
persistent
dhcpmode
on, off, or auto
off
dhcplease
300...-1
3600
dhcpretry
0...5
dhcpinterval
1...64
dhcpoffers
1...3
dhcpserver
IP address of the server
0.0.0.0
eapalgorithm
tls, peap, or ttls
tls
encryption
on or off
off
fastradius
enabled/disabled
disabled
fragmentthreshold 256…2346
2346
gateway
IP address of the gateway to be used by the vSTA(s)
0.0.0.0
inneralgorithm
ms-chapv2 or eap-ms-chapv2
ms-chapv2
ipmask
Subnet mask to be used by a vSTA
255.255.255.0
keyindex
1, 2, 3, or 4
0 (not defined)
kmTime-out
0…3600 s
0 (no timeout)
5-42
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
Default
layer
2 or 3
lp
ping
ping
mode
external or internal
internal
outeridentity
up to 64 ASCII characters
none (displayed as “Not Set”)
passphrase
up to 63 ASCII characters
none (displayed as “Not Set”)
password
up to 64 ASCII characters
none (displayed as “Not Set”)
pmkcache
on/off
on
psk
64 ASCII-hex characters
none (displayed as “Not Set”)
retry
0…2,147,483,647
roamtype
disassociation/ reassociation
reassociation
rtsthreshold
1…2346
2346
size
64…1024
1024
ssid
text string or hexadecimal string
(not set)
target
An IP address in ASCII Dotted Decimal Notation:
nnn.nnn.nnn.nnn (for example, 10.1.35.100).
none
timeout
0…2,147,483,647
300
userid
user ID string
none
wport
1...3
The attributes are:
•
authentication: Sets the authentication mode (open-system, shared-key, rsn,
rsn-psk, wpa, or wpa-psk) for all virtual stations in the specified group.
•
certfile: If authentication is rsn or wpa, this attribute defines a certificate file
name for all virtual stations in the specified group.
•
cipher: Defines a cipher mode (wep, tkip, or aes-ccm) for all virtual stations
in the specified group. If authentication is open-system or shared-key, wep
is the only valid selection.
•
count: If mode is internal, this attribute sets the ping count
(0…2,147,483,647).
•
csmode: When csmode is enabled (persistent), virtual stations in this group
remain persistent (connected) if the System Under Test deauthenticates or
disassociates. If IxWLAN loses connection to a System Under Test, persistence allows it to recover and continue the test at the point where it was interrupted. For example, if a virtual station is in a run or associated state and an
802.11 management frame (deauth or disassoc) is sent by the System Under
Test and received by IxWLAN, the virtual station tries to return to the state it
was in before the management frame was received. If the virtual station was
IxWLAN User Guide, Release 6.20
5-43
5
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
running a ping test, the ping test continues. If it was in an associated state, the
virtual station reissues the associate request.
5-44
•
dhcpmode: The DHCP mode allows virtual stations to have IP addresses
dynamically acquired from a DHCP server on the network rather than a fixed,
configured IP address. If dhcpmode is off, DHCP mode is not active and virtual stations must have a static IP address. If dhcpmode is on, the acquireip
command must be used to initiate lease negotiation. If dhcpmode is auto,
IxWLAN automatically starts lease negotiation if association succeeds. The
default value is off.
•
dhcplease: Sets the dhcpLease attribute of the specified vSTA, all vSTAs, or
all vSTAs within the specified group to the given value, specifying the lease
time a vSTA requests.
•
dhcpretry: Sets the dhcpRetry attribute of the specified vSTA, all vSTAs, or
all vSTAs within the specified group to the given value, specifying the number of times a vSTA retries a DHCP operation (discover, request) before timing out.
•
dhcpinterval: Sets the dhcpInterval attribute of the specified vSTA, all
vSTAs, or all vSTAs within the specified group to the given value, specifying
the interval between retries.
•
dhcpoffers: Sets the dhcpOffer attribute of the specified vSTA, all vSTAs, or
all vSTAs within the specified group to the given value, specifying the number of offers to ignore before generating a request.
•
dhcpserver: Sets the dhcpServer attribute of the specified vSTA, all vSTAs, or
all vSTAs within the specified group to the given value, specifying the DHCP
server from which a vSTA is to accept offers.
•
eapalgorithm: If authentication is rsn or wpa, this parameter specifies the
authentication protocol: tls, peap, or ttls.
•
encryption: Sets the encryption mode (on or off) for all virtual stations in the
specified group.
•
fastradius: Sets the vSTA’s fast RADIUS reconnection mode: enabled or disabled.
•
fragmentthreshold: Defines the fragmentation threshold for the virtual station(s) configured by this command. The fragmentation threshold limits the
number of bytes in any 802.11 frame transmitted by the vSTA. If is
set to 2346 (that is, the maximum 802.11 frame size), fragmentation is effectively disabled. The default value is 2346.
•
gateway: Sets the gateway attribute of the specified vSTA or all vSTAs within
the specified group to the given value, specifying the IP address of the gateway to be used by the vSTA(s).
•
inneralgorithm: If eapalgorithm is peap or ttls, this parameter specifies an
inner authentication algorithm (ms-chapv2 or eap-ms-chapv2) to be used in
Phase 2 authentication. ms-chapv2 is normally used for ttls. eap-ms-chapv2
is normally used for peap.
•
ipmask: Sets the ipmask attribute of the specified vSTA or all vSTAs within
the specified group to the given value, specifying the subnet mask to be used
by a vSTA.
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
•
keyindex: If authentication is shared-key, this attribute assigns a shared key
index number (1…4) to all virtual stations in the specified group. The shared
keys are defined by the set key command.
•
kmTimeout: AKMP Timeout sets a wait state timer for virtual stations in the
specified group. In situations where the System Under Test does not start or
respond during a 4-way handshake, the affected virtual station may stall in a
wait state. This timer can be used to recover the virtual station into an operable state. If the virtual station remains in a wait state until this timer expires, it
is 802.11 de-authenticated and returned to the initialized state.
•
layer: If mode is external, this attribute specifies how the external data
stream is captured. If layer is 2, frames is captured based on the source 802.3
MAC address. If layer is 3, frames is captured based on the source IP address.
The default value is 3.
•
lp: If mode is internal, this attribute defines the Load Protocol (ping).
•
mode: Defines the test mode (internal or external) for all virtual stations in the
specified group.
•
outeridentity: If eapalgorithm is peap or ttls, this parameter assigns a separate user ID for use in Phase 1 authentication. It can be up to 64 characters in
the range A…Z, a…z, 0…9, or other legal characters: period (.), dash (-), atsign (@).
•
passphrase: If authentication is rsn-psk or wpa-psk, this attribute defines a
passphrase of up to 63 ASCII characters. If the passphrase contains spaces,
the passphrase must be specified in double-quotes “like so”. To specify a
passphrase that contains a double-quote, you must escape the double-quote
“like \” so”.
•
password: If eapalgorithm is peap or ttls, this parameter assigns a user password for use in Phase 2 authentication. It can be up to 64 characters.
•
pmkcache: When enabled (on), vSTA uses cached PMKSA info, if any, to
skip up 802.1X authentication and proceed to 4-Way handshake immediately
after the 802.11 association frame exchange. Upon (re)associating to a given
APUT, if PMKSA caching is enabled and there is a matching PMKID in the
vsta PMKSA cache, IxWLAN inserts the PMKID in the RSN Information
Element included in (re)association request frame. Default is on.
•
psk: If authentication is rsn-psk or wpa-psk, this attribute defines a PreShared Key (64 ASCII-hex characters) for all virtual stations in this group.
•
retry: Defines the group’s Authentication/Association retry limit (zero = no
retries).
•
roamtype: Selects the Disassociation Roam or Reassociation Roam
type.When set to disassociation, the default message sequence upon a roam
event is achieved by disassociation from the old AP and subsequent authentication and association with the new AP; when set to reassociation, the
default roam sequence is Auth (new AP), Reassociate (new AP), with no disassociation from the old AP. The default is reassociation.
•
rtsthreshold: Defines the RTS threshold for the virtual station(s) configured
by this command. Any frame to be transmitted by a vSTA that exceeds the
vSTA’s RTS threshold needs a successful RTS/CTS frame exchange before
IxWLAN User Guide, Release 6.20
5-45
5
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
the frame is transmitted. The minimum value (1) effectively needs RTS/CTS
for all transmit frames. The maximum value (2346) is the maximum 802.11
frame size and effectively disables RTS. The default value is 2346.
•
size: If mode is internal, this attribute defines the Ping Packet Size
(64…1024).
•
ssid: Defines the SSID to be used in probes and association.
•
target: If mode is internal, this attribute defines the target IP address.
•
timeout: Defines the Authentication/Association timeout in ms(0=immediate
timeout).
•
userid: If authentication is rsn or wpa, this attribute defines a user ID string
that is needed for a certificate file (certfile) for all virtual stations in the specified group. It can be up to 64 characters in the range A…Z, a…z, 0…9, or
other legal characters: period (.), dash (-), at-sign (@).
•
wport: Assigns the identified vSTA(s) to the specified wport. Values range
between 1 and 3, depending on the number of wports present. The default
value is 1.
Example:
[wport2]IxWLAN -> set group 1 size 64
5 vSTAs updated
OK
[wport2]IxWLAN -> set group 2 wport 1
OK
set vsta
Modifies virtual station attributes.
set vsta
: Virtual Station ID (1…128). If is anything other than ip or
mac, the can be all to apply the configuration attribute to all virtual stations.
/: The allowable / combinations are
defined in Table 5-3.
Table 5-3.
Allowable Attributes
Default
authentication
open-system, shared-key, rsn, rsn-psk, wpa, or wpa-psk
open-system
certfile
certificate file name string
none
cipher
wep, tkip, or aes-ccm
wep
count
0…2,147,483,647
1000
csmode
persistent or non-persistent
persistent
5-46
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
Default
dhcpmode
on, off, or auto
off
dhcplease
300...-1
3600
dhcpretry
0...5
dhcpinterval
1...64
dhcpoffers
1...3
dhcpserver
IP address of the server
0.0.0.0
eapalgorithm
tls, peap, or ttls
tls
encryption
on or off
off
fastradius
enabled, disabled
disabled
fragmentthreshold 256…2346
2346
gateway
IP address of the gateway to be used by the vSTA, in ASCII
Dotted Decimal Notation: nnn.nnn.nnn.nnn
0.0.0.0
group
1…128
inneralgorithm
ms-chapv2 or eap-ms-chapv2
ms-chapv2
ip
IP address in ASCII Dotted Decimal Notation:
nnn.nnn.nnn.nnn (for example, 10.1.35.100)
none
ipmask
Subnet mask to be used by a vSTA
255.255.255.0
keyindex
1, 2, 3, or 4
0 (not defined)
kmTimeout
0…3600 seconds
0 (no timeout)
layer
2 or 3
lp
ping
ping
mac
MAC address in ASCII Colon Separated Hexadecimal
Notation: xx:xx:xx:xx:xx:xx (for example, 02:cf:1f:00:00:01)
none
mode
external or internal
internal
outeridentity
up to 64 ASCII characters
none (displayed as “Not Set”)
passphrase
up to 63 ASCII characters
none (displayed as “Not Set”)
password
up to 64 ASCII characters
none (displayed as “Not Set”)
pmkcache
enabled, disabled
enabled
psk
64 ASCII-hex characters
none (displayed as “Not Set”)
retry
0…2,147,483,647
roamtype
reassociation, disassociation
reassociation
rtsthreshold
1…2346
2346
size
64…1024
1024
IxWLAN User Guide, Release 6.20
5-47
5
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
Default
ssid
text string or hexadecimal string
(not set)
target
an IP address in ASCII Dotted Decimal Notation:
nnn.nnn.nnn.nnn (for example, 10.1.35.100).
none
timeout
0…2,147,483,647
300
userid
user ID string
none
wport
1...3
The attributes are:
5-48
•
authentication: Sets the authentication mode for virtual station(s) configured
by this command. It can be one of the following: open-system, shared-key,
rsn, rsn-psk, wpa, or wpa-psk.
•
certfile: If authentication is wpa or rsn, this attribute defines a certificate file
name for virtual station(s) configured by this command.
•
cipher: Sets the cipher mode (wep, tkip, or aes-ccm) for virtual station(s)
configured by this command. If authentication is open-system or sharedkey, wep is the only valid selection.
•
count: If mode is internal, this attribute sets the ping count
(0…2,147,483,647)
•
csmode: When csmode is enabled (persistent), virtual stations remain persistent (connected) if the System Under Test deauthenticates or disassociates. If
IxWLAN loses connection to a System Under Test, persistence allows it to
recover and continue the test at the point where it was interrupted. For example, if a virtual station is in a run or associated state and an 802.11 management frame (deauth or disassoc) is sent by the System Under Test and
received by IxWLAN, the virtual station tries to return to the state it was in
before the management frame was received. If the virtual station was running
a ping test, the ping test continues. If it was in an associated state, the virtual
station reissues the associate request.
•
dhcpmode: The DHCP mode allows virtual stations to have IP addresses
dynamically acquired from a DHCP server on the network rather than a fixed,
configured IP address. If dhcpmode is off, DHCP mode is not active and virtual stations must have a static IP address. If dhcpmode is on, the acquireip
command must be used to initiate lease negotiation. If dhcpmode is auto,
IxWLAN automatically starts lease negotiation if association succeeds. The
default value is off.
•
dhcplease: Sets the dhcpLease attribute of the specified vSTA to the given
value, specifying the lease time a vSTA requests.
•
dhcpretry: Sets the dhcpRetry attribute of the specified vSTA to the given
value, specifying the number of times a vSTA retries a DHCP operation (discover, request) before timing out.
•
dhcpinterval: Sets the dhcpInterval attribute of the specified vSTA to the
given value, specifying the interval between retries.
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
•
dhcpoffers: Sets the dhcpOffer attribute of the specified vSTA to the given
value, specifying the number of offers to ignore before generating a request.
•
dhcpserver: Sets the dhcpServer attribute of the specified vSTA to the given
value, specifying the DHCP server from which a vSTA is to accept offers.
•
eapalgorithm: If authentication is rsn or wpa, this parameter specifies the
authentication protocol: tls, peap, or ttls.
•
encryption: Sets the encryption mode (on or off) for virtual station(s) configured by this command.
•
fastradius: Sets the vSTA’s fast RADIUS reconnection mode: enabled or disabled.
•
fragmentthreshold: Defines the fragmentation threshold for the virtual station(s) configured by this command. The fragmentation threshold limits the
number of bytes in any 802.11 frame transmitted by the vSTA. If is
set to 2346 (that is, the maximum 802.11 frame size), fragmentation is effectively disabled. The default value is 2346.
•
group: The value of this attribute assigns one or more virtual stations to a
group (1…128).
•
gateway: Sets the gateway attribute of the specified vSTA to the given value,
specifying the IP address of the gateway to be used by the vSTA.
•
inneralgorithm: If eapalgorithm is peap or ttls, this parameter specifies an
inner authentication algorithm (ms-chapv2 or eap-ms-chapv2) to be used in
Phase 2 authentication. ms-chapv2 is normally used for ttls. eap-ms-chapv2
is normally used for peap.
•
ip: Assigns an IP address to an individual virtual station.
•
ipmask: Sets the ipmask attribute of the specified vSTA to the given value,
specifying the subnet mask to be used by a vSTA.
•
keyindex: If authentication is shared-key, this attribute assigns a shared key
index number (1…4) to virtual station(s) configured by this command. The
shared keys are defined by the set key command.
•
kmTimeout: AKMP Timeout Sets a wait state timer for virtual station(s) configured by this command. In situations where the System Under Test does not
initiate or respond during a 4-way handshake, the affected virtual station may
stall in a wait state. This timer can be used to recover the virtual station into
an operable state. If the virtual station remains in a wait state until this timer
expires, it is 802.11 de-authenticated and returned to the initialized state.
•
layer: If mode is external, this attribute specifies how the external data
stream is captured. If layer is 2, frames are captured based on the source
802.3 MAC address. If layer is 3, are be captured based on the source IP
address. The default value is 3.
•
lp: If mode is internal, this attribute defines the Load Protocol (ping).
•
mac: Assigns an MAC address to an individual virtual station.
•
mode: Defines the test mode (internal or external) for virtual station(s) configured by this command.
IxWLAN User Guide, Release 6.20
5-49
5
The Command Line Interface (CLI)
Virtual Station Setup and Control Commands
5-50
•
outeridentity: If eapalgorithm is peap or ttls, this parameter assigns a separate user ID for use in Phase 1 authentication. It can be up to 64 characters in
the range A…Z, a…z, 0…9, or other legal characters: period (.), dash (-), atsign (@).
•
passphrase: If authentication is rsn-psk or wpa-psk, this attribute defines a
passphrase of up to 63 ASCII characters. If the passphrase contains spaces,
the passphrase must be specified in double-quotes “like so”. To specify a
passphrase that contains a double-quote, you must escape the double-quote
“like \” so”.
•
password: If eapalgorithm is peap or ttls, this parameter assigns a user password for use Phase 2 authentication. It can be up to 64 characters.
•
pmkcache: When enabled (on), vSTA uses cached PMKSA info, if any, to
skip up 802.1X authentication and proceed to 4-Way handshake immediately
after the 802.11 association frame exchange. Upon (re)associating to a given
APUT, if PMKSA caching is enabled and there is a matching PMKID in the
vSTA PMKSA cache, IxWLAN inserts the PMKID in the RSN Information
Element included in (re)association request frame. Default is on.
•
psk: If authentication is rsn-psk or wpa-psk, this attribute defines a PreShared Key (64 ASCII-hex characters) for all virtual station(s) configured by
this command.
•
retry: Defines the Authentication/Association retry limit (zero = no retries).
•
roamtype: Selects the Disassociation Roam or Reassociation Roam
type.When set to disassociation, the default message sequence upon a roam
event is achieved by disassociation from the old AP and subsequent authentication and association with the new AP; when set to reassociation, the
default roam sequence is Auth (new AP), Reassociate (new AP), with no disassociation from the old AP. The default is reassociation.
•
rtsthreshold: Defines the RTS threshold for the virtual station(s) configured
by this command. Any frame to be transmitted by a vSTA that exceeds the
vSTA’s RTS threshold needs a successful RTS/CTS frame exchange before
the frame is transmitted. The minimum value (1) effectively needs RTS/CTS
for all transmit frames. The maximum value (2346) is the maximum 802.11
frame size and effectively disables RTS. The default value is 2346.
•
size: If mode is internal, this attribute defines the Ping Packet Size
(64…1024).
•
ssid: Defines the SSID to be used in probes and association.
•
target: If mode is internal, this attribute defines the target IP address.
•
timeout: Defines the Authentication/Association timeout in ms (0=immediate
timeout).
•
userid: For RSN or WPA authentication and a certificate file (certfile), this
attribute defines a user ID string that is needed for the certificate file. It can be
up to 64 characters in the range A…Z, a…z, 0…9, or other legal characters:
period (.), dash (-), at-sign (@).
•
wport: Assigns the identified vSTA(s) to the specified wport. Values range
between 1 and 3, depending on the number of wports present. The default
value is 1.
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Statistics File Commands
Example:
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
[wport1]IxWLAN
->
->
->
->
->
->
->
->
->
->
->
->
set
OK
set
OK
set
OK
set
OK
set
OK
set
OK
vsta 1 count 100
vsta 1 csmode persistent
vsta 1 csmode non-persistent
vsta 1 dhcpmode auto
vsta 1 fragmentthreshold 1000
vsta 1 rtsthreshold 1000
Statistics File Commands
The following commands allow you to show and delete statistics files:
del
del
get
get
statfile
summfile
statfile
summfile
-----
Delete a vSTA statistics file
Delete a vSTA statistics summary file
Display vSTA statistics from file
Display vSTA statistics summary from file
See Chapter 7, Statistics Counters for a description of the fields that may be displayed by any of the commands in this group that show statistics counters. Also
see the group and vsta commands under Virtual Station Setup and Control
Commands on page 5-14 for commands that display, clear, and save statistics
counters for a group or one or more virtual stations.
This section covers the following topics:
Delete Statistics File
•
Delete Statistics File on page 5-51.
•
Get/Display Statistics File on page 5-52.
del statfile group
Deletes the statistic file for all virtual stations in a specified group.
del statfile group
: Group ID (1…128)
del statfile vsta
Deletes the statistic file for one or more virtual stations.
del statfile vsta
IxWLAN User Guide, Release 6.20
5-51
5
The Command Line Interface (CLI)
Statistics File Commands
: Virtual Station ID (1…128), all, or master. If is set to all
(that is, del statfile vsta all), this command deletes the statistics file for all virtual
stations. If is set to master (that is, del statfile vsta master), this command deletes the statistics file for IxWLAN.
Example:
[wport1]IxWLAN -> del statfile vsta 1
Deleted vSta 1 statistics file
[wport1]IxWLAN ->
del summfile group
Deletes the group summary statistics file for one or all groups.
del summfile group
: Group ID (1…128) or all. If is set to all (that is., get group all
summfile), group summary statistics are deleted for all groups.
del summfile vsta all
Deletes the overall summary statistics file for all virtual stations.
del summfile vsta all
Get/Display
Statistics File
get statfile group
Retrieves and shows a statistics file for all virtual stations in a specified group.
get statfile group
: Group ID (1…128)
get statfile vsta
Retrieves and shows a statistics file for one or more virtual stations.
get statfile vsta
: Virtual Station ID (1…128), all, or master. If is set to all
(that is, get statfile vsta all), this command shows the statistics file for all virtual
stations. If is set to master (that is, get statfile vsta master), this command shows the statistics file for IxWLAN.
5-52
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Event Log Commands
get summfile group
Shows cumulative statistics from a summary statistics file for all virtual stations
in one or all groups.
get summfile group
: Group ID (1…128) or all. If is set to all (that is, get summfile
group all), group summary statistics are shown for all groups.
get summfile vsta all
Shows cumulative statistics from a summary statistics file for all virtual stations.
get summfile vsta all
Event Log Commands
These commands can be used to clear the event log, show the event log, set event
log controls, and save the event log in a file.
clear evlog
get evlog
save evlog
set evlog
-----
Clear event log file or buffer
Display event log data
Save the event log buffer to file
Set event log controls
Also see Appendix B, Event Logging, for more information about how IxWLAN
creates and maintains the event log.
This section covers the following topics:
Clear Event Log
•
Clear Event Log on page 5-53.
•
Get/Display Event Log on page 5-54.
•
Save Event Log (save evlog) on page 5-56.
•
Set Event Log Controls on page 5-56.
clear evlog buffer
Clears IxWLAN's event log buffer.
clear evlog buffer
Example:
[wport1]IxWLAN -> clear evlog buffer
IxWLAN User Guide, Release 6.20
5-53
5
The Command Line Interface (CLI)
Event Log Commands
clear evlog file
Clears a log file.
clear evlog file
: A or B
Example:
[wport1]IxWLAN -> clear evlog file A
[wport1]IxWLAN ->
Get/Display Event
Log
get evlog buffer
Shows event log data from the event log buffer.
get evlog buffer
: the number of records to show. The CLI shows the last number of
records in the buffer. Omit this parameter to view all records in the buffer.
Example:
[wport1]IxWLAN -> get evlog buffer
1/17/2003,10:25:14,5527.040462,0, Joined, BSSID 00:04:e2:38:52:18, chan 5280
1/17/2003,10:27:19,5651.922666,1, vSta conf ID 1, IP 10.1.35.231, mac
02:22:33:44:55:61, mode external
1/17/2003,10:27:19,5652.172465,2, vSta conf ID 2, IP 10.1.35.232, mac
02:22:33:44:55:62, mode external
1/17/2003,10:27:20,5652.672575,3, vSta init ID 1
1/17/2003,10:27:20,5652.922582,4, vSta init ID 2
1/17/2003,10:27:21,5653.839116,5, vSta auth ID 1
1/17/2003,10:27:22,5654.339023,6, vSta auth ID 2
1/17/2003,10:27:23,5655.339004,7, vSta assoc ID 1
1/17/2003,10:27:23,5655.839090,8, vSta assoc ID 2
[wport1]IxWLAN ->
5-54
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Event Log Commands
set evlog file
Shows event log data from an event log file.
get evlog file [ []]
get evlog file ?
: A or B
: The first record to be shown. Omit this parameter to start with the
first record in the file.
: The number of records to be shown. Omit this parameter to show all
remaining records in the file. This parameter can only be used if is
specified.
Use? to show the number of records in the file.
Example:
[wport1]IxWLAN -> get evlog file A ?
Log file A has 15 records
[wport1]IxWLAN -> get evlog file A
1/1/1970,0:00:37,30.963149,0, CLI: set date 5/5/2003 15:21
5/5/2003,15:21:03,34.229892,1, CLI: (null)
5/5/2003,15:21:21,52.663185,2, CLI: autoconf 5 ip 10.1.35.150 mac 00:0b:cd:59:00:01
1 mode external
5/5/2003,15:21:23,54.646520,3, CLI: join
5/5/2003,15:21:23,61.952464,4, Joined, BSSID 00:04:e2:3a:3c:32, chan 5180
5/5/2003,15:21:45,83.939091,5, CLI: autoconf 2 ip 10.1.35.150 mac 00:0b:cd:59:00:02
mode external
5/5/2003,15:21:45,83.939443,6, vSTA 1: configured, IP 10.1.35.150, mac
00:0b:cd:59:00:03, mode external
5/5/2003,15:21:45,84.189298,7, vSTA 2: configured, IP 10.1.35.151, mac
04:cf:1f:00:00:02, mode external
5/5/2003,15:21:46,84.439303,8, vSTA 1: initialized
5/5/2003,15:21:46,84.689242,9, vSTA 2: initialized
5/5/2003,15:21:46,85.022468,10, vSTA 1: authenticated
5/5/2003,15:21:47,85.272568,11, vSTA 2: authenticated
5/5/2003,15:21:47,85.522474,12, vSTA 1: associated
5/5/2003,15:21:47,85.772538,13, vSTA 2: associated
5/5/2003,15:21:53,91.422499,22, CLI: save evlog
[wport1]IxWLAN ->
get evlog settings
Shows the current event log control settings.
get evlog settings
Example:
[wport2]IxWLAN -> get ev set
Event logging is enabled
IxWLAN User Guide, Release 6.20
5-55
5
The Command Line Interface (CLI)
Event Log Commands
Event log verbosity : critical events only
WLANTX module: disabled
WLANRX module: disabled
IxWLAN module: enabled
VSTA module: enabled
UI module: enabled
WPA/RSN module: enabled
DHCP module: disabled
Event data to console: disabled
Event data to file
: disabled
[wport2]IxWLAN ->
If Event data to console shows enabled, this command also shows whether logging to console is enabled to this or another CLI console.
Example:
Event data to console: enabled to this CLI console
or
Event data to console: enabled to another CLI console
Save Event Log
(save evlog)
Flushes all records from the log buffer to the current log file, even if log to file is
not enabled.
save evlog
NOTE: When logging to file is enabled (that is, set evlog file enable), event
records are automatically written to the log file as they occur. The save evlog
command is intended for use when log to file is not enabled, but there are
significant events in the event log buffer that you want to save to file.
Set Event Log
Controls
set evlog
Enables/disables event logging.
set evlog
: enable/disable
Example:
[wport1]IxWLAN -> set evlog enable
[wport1]IxWLAN ->
set evlog console
Enables/disables event logging to the console.
5-56
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
Event Log Commands
set evlog console
: enable/disable
When set evlog console enable is entered at a CLI console (that is, connected to
the serial port or via a telnet session), event data is posted to that console only.
No more than one console receives event data at a given time. When set evlog
console disable is entered at a CLI console, event logging is disabled to all consoles.
Example:
[wport1]IxWLAN -> set evlog console enable
Event data to this CLI console is enabled
[wport1]IxWLAN ->
set evlog file
Enables/disables event logging to event log files.
set evlog file
: enable/disable
Example:
[wport1]IxWLAN -> set evlog file enable
[wport1]IxWLAN ->
set evlog level
Sets the level at which events are logged. The verbosity level sets an importance
threshold for events: at lower verbosity, only more important events are logged;
at higher verbosity, less important events may also be logged.
set evlog level
: 0 or critical = Log critical events only, 1 or low = Set log level to low
verbosity, 2 or medium = Set log level to medium verbosity, 3 or high = Set log
level to high verbosity.
Example:
[wport1]IxWLAN -> set evlog level 1
[wport1]IxWLAN ->
set evlog module
Enables/disables event logging for specific modules.
set evlog module
IxWLAN User Guide, Release 6.20
5-57
5
The Command Line Interface (CLI)
IxWLAN Commands
: WLANTX = 802.11 WLAN frame transmissions, WLANRX
= 802.11 WLAN frame receptions, IxWLAN = IxWLAN control, vSTA = Virtual station control, UI = User interface actions, WPA = WPA/RSN Events.
: enable/disable
Example:
[wport1]IxWLAN -> set evlog module IxWLAN enable
[wport1]IxWLAN ->
IxWLAN Commands
The commands in this group allow to show and modify the IxWLAN configuration.
clear sntpserver
clear systemname
cryptotest
del key
exec
ftp
get association
get bkjoin
get bootscan
get channel
get config
get countrycode
get cryptocap
get features
get frequency
get gateway
get hardware
get ipaddr
get ipmask
get key
get keyentrymethod
get login
get mic
get multiradiomode
get pmmode
get power
get psinterval
get rate
get sntpserver
get station
get status
get systemname
get telnet
get tzone
get uptime
get vsta
get wirelessmode
get wlanmac
5-58
---------------------------------------
Clear SNTP/NTP server IP address
Clear the IxWLAN system name
Crypto hardware self-test
Delete Encryption key
Execute a command file
Software update via FTP
Display Association Table
Display Background Join
Display Boot Scan Mode
Display Radio Channel
Display current IxWLAN configuration
Display Country Code
Display crypto hardware capabilities
Display authorized features
Display Radio Frequency (MHz)
Display Gateway IP Address
Display Hardware Revisions
Display IP Address
Display IP Subnet Mask
Display Encryption Key
Display Encryption Key Entry Method
Display Login User Name
Display Software MIC Control
Display multi-radio mode
Display Power Management Mode
Display Transmit Power Setting
Display Power Save Listen Interval
Display Data Rate
Display SNTP/NTP Server IP Address
Display Station Status
Display IxWLAN status
Display the IxWLAN system name
Display Telnet Mode
Display Time Zone Setting
Display UpTime
Display vSTA information
Display Wireless LAN Mode
Display Wireless LAN MAC Address
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
IxWLAN Commands
get wlanmask
get wport
help
history
import
ping
quit
reboot
reset wlanmac
set bkjoin
set bootscan
set countrycode
set date
set factorydefault
set features
set gateway
set ipaddr
set ipmask
set key
set keyentrymethod
set login
set mic
set multiradiomode
set password
set pmmode
set power
set psinterval
set rate
set sntpserver
set systemname
set telnet
set time
set tzone
set wirelessmode
set wlanmac
set wlanmask
set wport
timeofday
version
----------------------------------------
version
Display Wireless LAN Address Mask
Display wport information
Display CLI Command List
Display the command line history
Import PKCS#12 certfile via FTP
Ping
Logoff
Reboot the IxWLAN
Reset the WLAN MAC address to default value
Set Background Join
Set Bootscan mode
Set Country Code
Set the system date
Restore to Default Factory Settings
Upgrade current feature set
Set Gateway IP Address
Set IP Address
Set IP Subnet Mask
Set Encryption Key
Select Encryption Key Entry Method
Modify Login User Name
Set Software MIC Control
Set multi-radio mode
Modify Password
Set Power Management Mode
Set Transmit Power
Set Power Save Listen Interval
Set Data Rate
Set SNTP/NTP Server IP Address
Set the IxWLAN system name
Set Telnet Mode
Set the system time
Set Time Zone Setting
Set Wireless LAN Mode
Set WLAN MAC Address
Set WLAN Address Mask
Set wport for configuration
Display Current Time of Day
Software version
-- Software version
Warning: When IxWLAN configuration settings are changed using many of
these commands, the device writes all settings to a new configuration file in
Flash. This process is delayed to allow multiple parameters to be changed. The
new file is written within one minute from the time the first parameter is
changed. The CLI shows the following warning and confirmation:
**
** DO NOT REMOVE POWER FROM THE IxWLAN HARDWARE!
** Wait for the IxWLAN to update the configuration file in
** Flash or use the "reboot" command for immediate
** update & reboot.
** Automatic update will be done within one minute.
**
...Configuration file update completed.
IxWLAN User Guide, Release 6.20
5-59
5
The Command Line Interface (CLI)
IxWLAN Commands
This section describes the following commands:
5-60
•
clear sntpserver on page 5-62.
•
clear systemname on page 5-62.
•
cryptotest on page 5-62.
•
del key on page 5-63.
•
exec on page 5-63.
•
ftp on page 5-64.
•
get association on page 5-65.
•
get bkjoin on page 5-65.
•
get bootscan on page 5-65.
•
get channel on page 5-66.
•
get config on page 5-66.
•
get countrycode on page 5-68.
•
get cryptocap on page 5-68.
•
get features on page 5-69.
•
get frequency on page 5-69.
•
get gateway on page 5-69.
•
get hardware on page 5-69.
•
get ipaddr on page 5-70.
•
get ipmask on page 5-70.
•
get key on page 5-70.
•
get keyentrymethod on page 5-70.
•
get login on page 5-70.
•
get mic on page 5-71.
•
get multiradiomode on page 5-71.
•
get pmmode on page 5-71.
•
get power on page 5-71.
•
get psinterval on page 5-71.
•
get rate on page 5-72.
•
get sntpserver on page 5-72.
•
get station on page 5-72.
•
get status on page 5-72.
•
get systemname on page 5-73.
•
get telnet on page 5-73.
•
get tzone on page 5-73.
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
IxWLAN Commands
•
get uptime on page 5-73.
•
get wirelessmode on page 5-73.
•
get wlanmac on page 5-73.
•
get wlanmask on page 5-74.
•
get wport on page 5-74.
•
help on page 5-75.
•
history on page 5-75.
•
import on page 5-75.
•
ping on page 5-76.
•
quit on page 5-77.
•
reboot on page 5-77.
•
reset wlanmac on page 5-77.
•
set bkjoin on page 5-77.
•
set bootscan on page 5-77.
•
set countrycode on page 5-78.
•
set date on page 5-78.
•
set factorydefault on page 5-79.
•
set features on page 5-79.
•
set gateway on page 5-79.
•
set ipaddr on page 5-80.
•
set ipmask on page 5-80.
•
set key on page 5-80.
•
set keyentrymethod on page 5-80.
•
set login on page 5-80.
•
set mic on page 5-81.
•
set multiradiomode on page 5-81.
•
set password on page 5-81.
•
set pmmode on page 5-81.
•
set power on page 5-82.
•
set psinterval on page 5-83.
•
set rate on page 5-83.
•
set sntpserver on page 5-84.
•
set systemname on page 5-84.
•
set telnet on page 5-84.
•
set time on page 5-84.
IxWLAN User Guide, Release 6.20
5-61
5
The Command Line Interface (CLI)
IxWLAN Commands
clear sntpserver
•
set tzone on page 5-85.
•
set wirelessmode on page 5-85.
•
set wlanmac on page 5-85.
•
set wlanmask on page 5-85.
•
set wport on page 5-85.
•
timeofday on page 5-86.
•
version on page 5-86.
Clears the IP Address of the SNTP server.
clear sntpserver
clear systemname
Clears the IxWLAN system name.
clear systemname
cryptotest
Starts a self-test of the crypto hardware. It indicates past cumulative results for
each test type and results for the current run.
cryptotest
Example:
[wport1]IxWLAN -> cryptotest
Running crypto hardware self-test...
...Crypto hardware self-test PASSED! Details:
Test Name
History
Current Test
-------------------------Raw RC4 :
OK
Passed
40-bit WEP :
OK
Passed
TKIP :
OK
Passed
Raw AES :
OK
Passed
AES-CCM :
OK
Passed
3DES :
OK
Passed
MD5 :
OK
Passed
HMAC_MD5 :
OK
Passed
SHA-1 :
OK
Passed
HMAC_SHA-1 :
OK
Passed
ModExp :
OK
Passed
RSA :
OK
Passed
RNG :
OK
Passed
If any faults were detected in the current self-test, this command shows the failure condition.
Example:
...Crypto hardware self-test FAILED! Details:
Test Name
History
Current Test
5-62
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
IxWLAN Commands
-------------------------Raw RC4 :
OK
Passed
40-bit WEP * Faulted
FAILED: status 5 (0x00000005):
EXCRYPT_STAT_INSUFF_RESOURCE: insufficient resources
TKIP :
OK
Passed
Raw AES :
OK
Passed
AES-CCM :
OK
Passed
3DES :
OK
Passed
MD5 :
OK
Passed
HMAC_MD5 :
OK
Passed
SHA-1 :
OK
Passed
HMAC_SHA-1 :
OK
Passed
ModExp :
OK
Passed
RSA :
OK
Passed
RNG :
OK
Passed
Driver-specific error code 0 (0x00000000): OK
If any faults were detected in a previous self-test but the current tests are successful, the History column shows the failure condition.
Example:
...Crypto hardware
Test Name
--------Raw RC4 :
40-bit WEP :
TKIP :
Raw AES :
AES-CCM :
3DES :
MD5 :
HMAC_MD5 :
SHA-1 :
HMAC_SHA-1 :
ModExp :
RSA :
RNG :
self-test
History
------OK
Faulted
OK
OK
OK
OK
OK
OK
OK
OK
OK
OK
OK
PASSED! Details:
Current Test
-----------Passed
Passed
Passed
Passed
Passed
Passed
Passed
Passed
Passed
Passed
Passed
Passed
Passed
If no crypto hardware was detected at startup, the following information displays:
[wport1]IxWLAN -> cryptotest
Running crypto hardware self-test...
...Self-test not supported at this time
del key
Deletes the encryption key.
del key
exec
Executes a command file. The command file must contain a series of CLI commands. When this command is executed, the commands in the file are treated/
executed as entered using the CLI.
exec
IxWLAN User Guide, Release 6.20
5-63
5
The Command Line Interface (CLI)
IxWLAN Commands
: The name of the command file to be executed
Example: The try.txt file in this example contains the version and get association CLI commands.
[wport1]IxWLAN -> exec try.txt
run -> version
Ixia IxWLAN Rev 5.00
run -> get association
STA
MAC Address
00:04:E2:38:56:78
SUT
00:04:E2:38:A8:D2
[wport1]IxWLAN ->
State
up
up
NOTE: Use the ftp command to download the command file from the command
PC to the IxWLAN flash file system.
ftp
Transfers a file between the IxWLAN flash file system and the command PC. It
is most often used to download new software from the command PC to the IxWLAN SED/SED-MR+ chassis. It can also be used to download command files
(executed by the exec command) from the command PC to the IxWLAN SED/
SED-MR+ chassis.
ftp
: The IP address of the target host.
NOTE: An FTP server must be running on .
The CLI opens for the following entries:
Username: The user name needed to access the remote file.
Password: The password needed to access the remote file.
Remote File: The file name on the remote host. The full pathname should be
included (that is, c:\ixia\ixwlan.sys).
Local File: The name of the file to be used in IxWLAN.
download or upload: download (to transfer a file from the remote host to the
IxWLAN chassis) or upload (to transfer a file from the IxWLAN chassis to the
remote host). This entry is case-sensitive.
Example:
[wport1]IxWLAN -> ftp 192.168.0.2
Username:
Password:
Remote File: c:\ixwlan.sys
Local File: ixwlanNEW.sys
5-64
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
IxWLAN Commands
download or upload: download
Getting @192.168.0.2:c:\ixwlan.sys -> ixwlanNEW.sys
###########################################################
###########################################################
###########################################################
###########################################################
###########################################################
###########################################################
###########################################################
###########################################################
###########################################################
###########################################################
###########################################################
###########################################################
done
1007441 bytes
[wport1]IxWLAN ->
get association
Shows a list of known stations and their association status. This list includes the
master station, the System Under Test, and all virtual stations.
get association
Example:
[wport1]IxWLAN -> get association
AID
vSTA
DEV
MAC Address
SUT
wlan0
00:04:E2:37:E6:A1
wlan0
00:0B:16:57:00:01
wlan0
00:0B:16:57:00:02
get bkjoin
State
Up
Associated
Associated
Shows the Background Join mode.
get bkjoin
Example:
[wport1]IxWLAN ->get bkjoin
Background Join is enabled
[wport1]IxWLAN ->
get bootscan
Shows the Scan at Boot mode.
[wport1]IxWLAN -> get bootscan
Example:
[wport1]IxWLAN -> get bootscan
Scan at Boot mode: enabled
IxWLAN User Guide, Release 6.20
5-65
5
The Command Line Interface (CLI)
IxWLAN Commands
get channel
Shows the radio channel/frequency used by IxWLAN. The channel is set automatically when it joins with the System Under Test.
get channel
Example:
[wport1]IxWLAN -> get channel
Radio Frequency: 5260 MHz (IEEE 52)
[wport1]IxWLAN ->
get config
Shows the IxWLAN configuration.
get config
Example:
[wport2]IxWLAN -> get config
========== System Attributes ==========
IxWLAN Cfg Rev: 4
System Name:
Login Username: Admin
IP Address: 10.10.10.15
IP Mask: 255.255.255.0
Host IP Address: 10.10.10.25
Gateway IP Address: 0.0.0.0
SNTP/NTP Server IP Address:
Time Zone:
Telnet Access: Enabled
========== Global Radio Attributes ==========
Multi-radio Mode: dynamic
Country Code: NA
Scan at Boot: enabled
Background Join: disabled
========== Per-Radio Attributes ==========
******************************
wport1
******************************
SSID: IxWLAN Test Wireless Network
BSSID of System Under Test: 00:0b:6b:30:05:9f
WLAN MAC Address: 00:0b:6b:4e:ef:7f (default)
WLAN MAC Address Mask: ff:ff:ff:ff:00:00
Wireless Mode: 802.11a
Data Rate: best
DTIM: 1
HW Transmit Retry Limit: 4
Configured Transmit Power: full
Current Runtime Transmit Output Power 18.0 dBm
Default transmit key: 1
Shared Key 1, size 40, 1234567890
Key Entry Method: hexadecimal
******************************
wport2
5-66
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
IxWLAN Commands
******************************
SSID: IxWLAN Test Wireless Network
BSSID of System Under Test: 00:0b:6b:30:05:9f
WLAN MAC Address: 00:0b:6b:4f:ef:7f (set by user)
WLAN MAC Address Mask: ff:ff:ff:ff:00:00
Wireless Mode: 802.11a
Data Rate: best
DTIM: 1
HW Transmit Retry Limit: 4
Configured Transmit Power: full
Current Runtime Transmit Output Power 18.0 dBm
Default transmit key: 1
Shared Key 1, size 40, 1234567890
Key Entry Method: hexadecimal
******************************
wport3
******************************
SSID: IxWLAN Test Wireless Network
BSSID of System Under Test: 00:0b:6b:30:05:9f
WLAN MAC Address: 00:0b:6b:50:ef:7f (set by user)
WLAN MAC Address Mask: ff:ff:ff:ff:00:00
Wireless Mode: 802.11a
Data Rate: best
DTIM: 1
HW Transmit Retry Limit: 4
Configured Transmit Power: full
Current Runtime Transmit Output Power 18.0 dBm
Default transmit key: 1
Shared Key 1, size 40, 1234567890
Key Entry Method: hexadecimal
[wport2]IxWLAN ->
IxWLAN User Guide, Release 6.20
5-67
5
The Command Line Interface (CLI)
IxWLAN Commands
get countrycode
Shows the country code that is currently configured in IxWLAN.
get countrycode
Example:
[wport1]IxWLAN -> get country code
Country Code: US
[wport1]IxWLAN ->
get cryptocap
Identifies the crypto hardware installed on the IxWLAN SED/SED-MR+ chassis,
the capabilities supported by that hardware, and includes an indication of the
cumulative fault status.
get cryptocap
Example:
[wport1]IxWLAN -> get cryptocap
Crypto hardware: cn505
Hardware capabilities:
Raw RC4 (ARC4) encryption
40(64)-bit WEP encryption
104(128)-bit WEP encryption
TKIP encryption
Raw AES encryption
AES-CCM (CCMP) encryption
3DES encryption
MD5 hash
HMAC_MD5 authentication
SHA-1 hash
HMAC_SHA-1 authentication
Modular exponentiation
RSA public key encryption
Random number generator
Crypto hardware status: OK
[wport1]IxWLAN ->
If any faults were detected in a self-test, the following message displays:
Crypto hardware status: Faulted, run "cryptotest" command for details
If no crypto hardware was detected at startup, the following information displays:
[wport1]IxWLAN -> get cryptocap
Crypto hardware: None
Hardware capabilities: None
[wport1]IxWLAN ->
If crypto hardware was detected at startup, but the license key does not include
WPA/RSN, the following information displays:
[wport1]IxWLAN -> get cryptocap
Crypto hardware: Detected but not licensed
Hardware capabilities: None
5-68
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
IxWLAN Commands
get features
Shows features that have been enabled by your authorization code/feature key:
get features
Example:
[wport1]IxWLAN -> get features
Features: 802.11A, 802.11B, 802.11G, WPA/RSN
[wport1]IxWLAN ->
See 802.11b/g Commands on page 5-86 for more commands that are available if
your feature set includes 802.11B or 802.11G. If the feature key includes WPA/
RSN, but no crypto hardware was detected at startup, this command displays the
following message:
[wport1]IxWLAN -> get features
Features: 802.11A, 802.11B, 802.11G
* * WARNING: licensed for WPA but no encryption hardware
get frequency
Shows IxWLAN's radio frequency setting.
get frequency
Example:
[wport1]IxWLAN -> get frequency
Radio Frequency: 5260 MHz (IEEE 52)
[wport1]IxWLAN ->
get gateway
Shows IxWLAN's default gateway IP address defined in the configuration file
(set by set gateway).
get gateway
Example:
[wport1]IxWLAN -> get gateway
Gateway's IP Address:10.1.35.1 (config file value)
[wport1]IxWLAN ->
get hardware
Shows hardware revisions.
[wport1]IxWLAN -> get hardware
Example:
[wport1]IxWLAN -> get hardware
wlan1 revisions: mac 5.6 phy 4.1 analog 1.7
PCI Vendor ID: 0x168c, Device ID: 0x13
Sub Vendor ID: 0x168c, Sub Device ID: 0x2026
IxWLAN User Guide, Release 6.20
5-69
5
The Command Line Interface (CLI)
IxWLAN Commands
get ipaddr
Shows IxWLAN's IP address.
get ipaddr
Example:
[wport1]IxWLAN -> get ipaddr
IP Address: 192.168.0.50
[wport1]IxWLAN ->
get ipmask
Shows IxWLAN's IP subnet mask defined in the configuration file (set by set
ipmask).
get ipmask
Example:
[wport1]IxWLAN -> get ipmask
IP Subnet Mask: 255.255.0.0 (config file value)
[wport1]IxWLAN ->
get key
Shows an encryption key.
get key
: Key Number (1…4)
Example:
[wport1]IxWLAN -> get key 1
Shared Key 1, size 40, 1234567890
[wport1]IxWLAN ->
get keyentrymethod
Shows the current WEP Encryption Key Entry Method:
get keyentrymethod
Example:
[wport1]IxWLAN -> get keyentrymethod
Key Entry Method: Hexadecimal
[wport1]IxWLAN ->
get login
Shows the logon user name.
-> get login
Login Username:
5-70
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
IxWLAN Commands
Example:
[wport1]IxWLAN -> get login
Login Username: My_User_Name
[wport1]IxWLAN ->
get mic
Shows the MIC check setting that is currently configured on the IxWLAN chassis.
get mic
Example:
[wport1]IxWLAN -> get mic
MIC check enabled
get multiradiomode
Displays the multi-radio mode.
get multiradiomode
Example:
[wport1]IxWLAN -> get multiradiomode
Multi-radio mode: Dynamic
get pmmode
Shows the IxWLAN power management mode.
get pmmode
Example:
[wport1]IxWLAN -> get pmmode
Power Management mode ........ Power Save
Power Save listen interval ... 1 beacon period
[wport1]IxWLAN ->…
get power
Shows the IxWLAN transmit power setting.
get power
Example:
[wport1]IxWLAN -> get power
TransmitPower: half (-3 dB)
Current Transmit Output Power 18 dBm
[wport1]IxWLAN ->
get psinterval
Shows the power save interval.
get psinterval
IxWLAN User Guide, Release 6.20
5-71
5
The Command Line Interface (CLI)
IxWLAN Commands
Example:
[wport1]IxWLAN -> get psinterval
Power Save listen interval ... 3 beacon periods
Power Management mode ........ Power Save
[wport1]IxWLAN ->
get rate
Shows the IxWLAN data rate.
get rate
Example:
[wport1]IxWLAN -> get rate
Data Rate: best
[wport1]IxWLAN ->
get sntpserver
Shows the IP Address of the SNTP server.
get sntpserver
get station
Shows the status of an 802.11 STA from the IxWLAN station’s information
base. This command is intended for diagnostic purposes.
get station
: Station Index
get status
Shows a high-level summary of IxWLAN's current status. It includes: the BSSID
of the System Under Test, an indication of whether this system has been detected
and if IxWLAN is joined with it, and a count of the current virtual stations.
For the IxWLAN SED chassis, this command displays the MAC address of the
additional Ethernet port and adds the Mgmt or Data prefix for each port.
get status
Example:
[wport2]IxWLAN -> get status
IxWLAN(tm) software version 6.20.0.127 EB
Number of wports present ....... 3
Multi-radio mode ............... Dynamic
Mgmt LAN MAC address ........... 00:08:9b:68:2c:81
Data LAN MAC address ........... 00:08:9b:68:2c:82
MIC check ...................... Enabled
Crypto hardware ................ OK
1 vSTA currently in the system:
1 vSTA in External mode:
1 in the Initialized state.
Group 128 has 1 vSTA.
5-72
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
IxWLAN Commands
get systemname
Shows the IxWLAN system name.
get systemname
get telnet
Shows the telnet mode and the current state of telnet connections.
get telnet
Example:
[wport1]IxWLAN -> get telnet
Telnet Access: Enabled
1 of 4 connections active
2 connection attempts
2 good logins
0 failed logins
[wport1]IxWLAN ->
get tzone
Shows the current time zone setting.
get tzone
Example:
[wport1]IxWLAN -> get tzone
SNTP/NTP Time Zone: -8
[wport1]IxWLAN ->
get uptime
Shows the elapsed time since IxWLAN has been up and running.
get uptime
Example:
[wport1]IxWLAN -> get uptime
IxWLAN Uptime -- 5 days, 15:32:29
[wport1]IxWLAN ->
get wirelessmode
Shows the current Wireless LAN Mode (11a, 11b, or 11g).
get wirelessmode
Example:
[wport1]IxWLAN -> get wirelessmode
Wireless LAN Mode: 11g
[wport1]IxWLAN ->
get wlanmac
Shows the current Wireless LAN MAC Address.
get wlanmac
IxWLAN User Guide, Release 6.20
5-73
5
The Command Line Interface (CLI)
IxWLAN Commands
Example:
[wport1]IxWLAN -> get wlanmac
WLAN MAC Address: 00:0b:cd:59:23:44
[wport1]IxWLAN ->
get wlanmask
Shows the Wireless LAN Address Mask.
get wlanmask
Example:
[wport1]IxWLAN -> get wlanmask
WLAN Address Mask: ff:ff:ff:ff:00:00
[wport1]IxWLAN ->
get wport
Displays wport information.
get wport [stats]
get wport
Displays a summary status report for wport .
get wport
: the wport number. The default value is 1. Must be in the 1...3 range,
depending on the number of wports present.
Example:
[wport1]IxWLAN -> get wport 2
WLAN mode ......................
WLAN MAC address ...............
WLAN address mask ..............
BSSID of System Under Test .....
IxWLAN-SUT connection status ...
Power Management mode ..........
1 vSTA on wport 2:
1 vSTA in Internal mode:
1 in the Running state.
Group 1 has 1 vSTA: ID 3
get wport stats
802.11b
00:02:6f:05:16:34
ff:ff:ff:ff:00:00
00:04:e2:83:cb:3f
Joined
Active (always awake)
Displays a statistics report for wport .
get wport stats
stats: statistics reports including per-wport counters and statistical information
Example:
[wport1]IxWLAN -> get wport 2 stats
5-74
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
IxWLAN Commands
Wport 2: MAC 00:02:6f:05:16:34
Authentications:
10,
Associations:
10,
Reassociations:
Rcv Sig Strength:
49,
Rcv Rate: 6,
Tx SF Rate: 18,
Frame counts: MSDUs
Data
Rcv
3429
700
Tx
595
525
Rcv Errors:
Rcv PHY Errors:
Rcv CRC Errors:
Rcv Duplicates:
Rcv Discarded:
Ack Rcv Fails:
Encryption:
Rcv Decrypt Errs:
0,
0,
0,
0,
0,
0,
n/a,
0,
Deauthentications:
Disassociations:
Ack Sig Strength:
Tx LF Rate: 18
Mcast
Mgmt
3729
70
58
Ctrl
Tx Errors:
Excess Retries:
Total Retries:
Tx Filtered:
Tx Discarded:
RTS Fails:
FCS Fails:
WEP Excluded:
NOTE: This subcommand is similar to the get vsta master stats command,
which displays aggregate statistics for the entire IxWLAN unit.
help
Shows all commands available in the CLI command set.
help
history
Shows the last 20 commands that were entered in the CLI.
history
Example:
[wport1]IxWLAN -> history
1 set date 2/4/03 11:09:30
2 join
3 autoconf 2 ip 10.1.35.231 mac 10:20:30:40:50:61 mode
external
4 get vsta 1 conf
[wport1]IxWLAN ->
import
Imports a PKCS#12 certificate file via FTP. The successful completion of this
command stores the specified certificate file in the /Certificates directory in the
IxWLAN flash file system. The specified password (Certfile password) is
encrypted and stored in the /Cache directory (only visible in admin mode).
import certfile [] [certpass ]
[ftphost ] [ftpuser ] [ftppass
]
Prompts for parameters that are not specified in the command line.
IxWLAN User Guide, Release 6.20
5-75
5
The Command Line Interface (CLI)
IxWLAN Commands
Example:
[wport1]IxWLAN -> import certfile
Remote Certfile: c:\myCert.pfx
Certfile password: ****
FTP Hostname: 192.168.0.2
FTP Username:
FTP Password:
Importing @192.168.0.2:c:\myCert.pfx -> /Certificates/
myCert.pfx
#####
myCert.pfx imported successfully
remote certfile []: The file name on the remote host. The full
path name must be included (for example, c:\myCert.pfx).
certfile password [certpass ]: The password associated with the certificate file.
ftp hostname [ftphost ]: The IP address of the FTP host where the
certificate file resides.
ftp username [ftpuser ]: The user name needed to access the certificate file on the FTP host.
ftp password [ftppass ]: The password needed to access the certificate file on the FTP host.
NOTE: An FTP server must be running on FTP Hostname.
ping
Allows you to ping other hosts on the subnet. If is not supplied, three
pings are sent.
ping
: Host name.
: Number of ping packets to send: 0…2,147,483,647.
Example:
[wport1]IxWLAN -> ping 10.10.10.233 3
PING 10.10.10.233: 56 data bytes
64 bytes from here(10.10.10.233) : icmp-seq=O. time=O. ms
64 bytes from here(10.10.10.233) : icmp-seq=l. time=O. ms
64 bytes from here(10.10.10.233) : icmp-seq=2. time=O. ms
----10.10.10.233 PING Statistics ---3 packets transmitted, 3 packets received, 0% packet loss
round-trip (ms) min/avg/max = 0/0/0
-> ping 10.10.10.233 1
10.10.10.233 is alive
[wport1]IxWLAN ->
5-76
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
IxWLAN Commands
quit
Exits the CLI.
quit
You must reopen the telnet connection to log on after this command is used.
reboot
Reboots IxWLAN.
reboot
reset wlanmac
Resets the Wireless LAN MAC Address to its default value:
reset wlanmac
Example:
[wport1]IxWLAN -> reset wlanmac
**
** DO NOT REMOVE POWER FROM THE IxWLAN HARDWARE!
** Wait for the IxWLAN to update the configuration file in
Flash
** or use the "reboot" command for immediate update &
reboot.
** Automatic update will be done within one minute.
**
set bkjoin
Selects the Background Join mode.
This setting is saved in the configuration file and is stored upon the reboot of the
system.
The default setting for the Background Join mode is enabled.
set bkjoin enabled/disabled
Example:
[wport1]IxWLAN ->set bkjoin enabled
Background Join is enabled
set bootscan
Selects the Scan at Boot mode.
It can be set to:
•
enabled: scans the configured wireless mode (that is, 802.a/b/g).
•
allmode: scans all valid wireless modes at boot time.
•
disabled: no scan at boot time.
This persistent setting is saved in the configuration file and restored upon the
reboot of the system.
IxWLAN User Guide, Release 6.20
5-77
5
The Command Line Interface (CLI)
IxWLAN Commands
The default setting for Scan in Boot mode is enabled.
set bootscan enabled/allmode/disabled
Example:
[wport1]IxWLAN -> set bootscan allmode
Scan at Boot mode: allmode
set countrycode
Updates the IxWLAN configuration with the new country code and reboots the
system.
set countrycode
: An ISO standard country code (for example, DB - DEBUG, NA NO_COUNTRY_SET, PR - PUERTO_RICO, US - UNITED_STATES, and so
on)
Example:
[wport1]IxWLAN -> set countrycode
Setting the country code will reboot the system, continue?
[y/n: y]? n
[wport1]IxWLAN ->
If there are any vSTAs in the authenticated or above state, the command informs
the user that all vSTAs must be deauthenticated before invoking the command.
Example:
[wport1]IxWLAN -> set countrycode
Setting the country code will reboot the system, continue?
[y/n: y]? y
Error: 1 vSTA active, all vSTAs must be at state configured
or initialized.
[wport1]IxWLAN ->
set date
Sets the current system date and (optionally) time in IxWLAN.
set date []
: Current date in the format: mm/dd/yyyy
: Current time in the format: hh:mm:ss. Use 24-hour clock numbers (that
is, 13:30:00 = 1:30 p.m.). This parameter is optional. If not specified, the current
system time is used. The system time starts at midnight when the unit is powered
on or reset. If the time is given, the seconds component is optional. If not specified, the seconds value is initialized to zero.
5-78
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
IxWLAN Commands
Example:
[wport1]IxWLAN -> set date 06/04/03 06:14:15
System date & time: THU JUL 31 09:00:00 2003
Use the "set date" or "set time" command to adjust
[wport1]IxWLAN ->
set factorydefault
Resets the IxWLAN configuration to default factory settings and reboots the system.
[wport1]set factorydefault
Resetting to factory defaults will reboot the system,
continue? [y/n:y]? n
[wport1]IxWLAN ->
If there are any vSTAs in the authenticated or above state, the command informs
the user that all vSTAs must be deauthenticated before invoking the command.
[wport1]set factorydefault
Resetting to factory defaults will reboot the system,
continue? [y/n:y]? y
Error: 1 vSTA active, all vSTAs must be at state configured
or initialized.
[wport1]IxWLAN ->
set features
This command can be used to modify your authorization code keyfile in the flash
file system to enable new features (for example, 802.11b, 802.11g, WPA/RSN).
[wport1]IxWLAN -> set features
This command will modify your system!!
Do you have your new Activation Codes ready (y/n)y
*** This IxWLAN has not been Node Locked
*** Please enter "admin" to continue
[wport1]IxWLAN -> admin
Password: ***
Ok
Please Enter IxWLAN Authorization Codes for MAC:
00:0b:16:00:00:07
Input? ba27108c5b7d16dda96094be96b3105f34643030303030300000
Thank you...Authorization Codes Accepted
CONGRATULATIONS! you have been authorized for
Features: 802.11A, 802.11B and 802.11G
[wport1]IxWLAN ->
This command is used only when you upgrade the IxWLAN software with new
features.
set gateway
Sets the IxWLAN default gateway IP address.
IxWLAN User Guide, Release 6.20
5-79
5
The Command Line Interface (CLI)
IxWLAN Commands
set gateway
: A valid IP address in ASCII dotted-decimal notation
(nn.nn.nn.nn). Use an IP address that is compatible with the network addressing
scheme at your facility. The default gateway address is 0.0.0.0.
set ipaddr
Sets the IxWLAN IP address.
set ipaddr
: A valid IP address in ASCII dotted-decimal notation
(nn.nn.nn.nn). Use an IP address that is compatible with the network addressing
scheme at your facility. The default IP address is 192.168.0.50.
set ipmask
Sets the IxWLAN IP subnet mask.
set ipmask
: A valid IP address mask in ASCII dotted-decimal notation
(nn.nn.nn.nn).
set key
Sets an encryption key or default shared key.
set key["keynum"|unique][40|104|128]keystring
set key [1-4] default
Example:
[wport1]IxWLAN -> set key
set key [1-4] default
set key ["keynum"|unique] [40|104|128] value
[wport1]IxWLAN ->
[wport1]IxWLAN -> set key 1 40 1234567890
Shared Key 1, size 40: 1234567890
[wport1]IxWLAN ->
[wport1]IxWLAN -> get key 1
Shared Key 1, size 40, 1234567890
[wport1]IxWLAN ->
set keyentrymethod
Sets the WEP Encryption Key Entry Method.
set keyentrymethod
: hexadecimal = Key contains (0 - 9, A - F), asciitext = Key contains
keyboard characters
set login
Sets the logon user name. The logon user name is a text string and can be up to 32
characters. Control characters are not permitted.
set login
5-80
IxWLAN User Guide, Release 6.20
The Command Line Interface (CLI)
IxWLAN Commands
Example:
[wport1]IxWLAN -> set login Your_User_Name
Login Username: Your_User_Name
[wport1]IxWLAN ->
set mic
Sets the MIC check configuration parameter for IxWLAN.
set mic
: enable, disable, or spot. The default value is enabled.
set multiradiomode
Sets the multi-radio mode.
set multiradiomode static|dynamic
static: Sets the multi-radio mode to be static. In the static mode, each wport is
totally independent of the others and must have non-matching MACs, and the
system does not support vSTA migration among wports for roaming or other purposes. The assignment of vSTAs to wports can still be changed, but must ensure
vSTA MAC consistency with its wport. The wport hardware for wports 1, 2, and
3 is each programmed by the system with its configured WLAN MAC address, if
set, or else it defaults to factory settings. The system ensures that each has a suitably unique WLAN MAC address and overrides the factory default, if necessary.
dynamic: The wports are used as a virtual extension of one another with consistent MACs to the extent of the WLAN address mask, and vSTAs may be moved
among wports. The wport hardware for wports 2 and 3 is programmed by the system with a WLAN MAC address consistent with that of wport1.
Default is static.
Example:
[wport1]IxWLAN -> set multiradiomode dynamic
Multi-radio mode: Dynamic
set password
Sets the password needed to log on to the IxWLAN command line interface and
web-based user interface. Type the new password twice to confirm the use of the
new password. The password is a text string and can be up to 32 characters. Control characters are not permitted. The password is case-sensitive.
[wport1]IxWLAN -> set password
Password: *******
Type password again to confirm: *******
Password confirmed
[wport1]IxWLAN ->
set pmmode
Sets the IxWLAN power management mode.
IxWLAN User Guide, Release 6.20
5-81
5
The Command Line Interface (CLI)
IxWLAN Commands
set pmmode