Ixia EE11ABG3 802.11 a/b/g Emulation Engine User Manual EmulationEngine 11a b g User s Guide
Ixia 802.11 a/b/g Emulation Engine EmulationEngine 11a b g User s Guide
Ixia >
Contents
- 1. User Manual part 1
- 2. User Manual part 2
- 3. User Manual part 3
User Manual part 3
EmulationEngine 11a/b/g User's Guide CHAPTER 6: The Command Line Interface (CLI) The CLI can be used to display and modify the configuration of the EmulationEngine from a PC that is connected via Telnet or the serial port. The CLI also includes commands to configure and run virtual stations, display statistics, and to access the System Under Test. The EmulationEngine maintains statistics and event log files that you can configure and display using CLI commands. CLI Usage Notes 1) CLI commands are not case sensitive (e.g., "set Date" is the same as "set date"). 2) You do not need to enter the entire command string to execute a command. Only the number of unique characters required to identify the command are needed (e.g., "se da" will execute the "set date" command because there are no other CLI commands that begin with “se” and no other set objects that begin with "da"). 3) Some parameters can be assigned very large values in the range: 0...2,147,483,647. Do not enter commas (,) for values larger than 999 (e.g., use 1000 rather than 1,000). 4) It is very important to keep a printed record of configuration parameters. See "Configuration Records" in Chapter 9. User Log-In The EE login prompt is displayed after you successfully establish a connection to the EmulationEngine. See “Initial Setup” in Chapter 4. When you have successfully established this connection, the CLI prompts you to enter a log in name and password. EE login: Admin Password: ** The default log in user name is "Admin". The default password is "EE". Both entries are case sensitive (i.e., the default user name is "Admin", not "admin"). After you enter a valid user name and password, the CLI displays a version banner, the current system time and status, and a CLI prompt. Communication Machinery Corporation EmulationEngine(tm) 11a/b/g Rev 2.3.0.a1 System date & time: THU JAN 01 00:00:20 2004 Use the "set date" or "set time" command to adjust EmulationEngine 11a/b/g software version 2.3.0.a1 WLAN mode .................... 802.11a WLAN MAC address ............. 00:02:8a:b6:1e:c9 WLAN address mask ............ ff:ff:ff:ff:00:00 LAN MAC address .............. 00:0b:16:00:00:57 BSSID of System Under Test ... 00:04:e2:38:a7:9c EE-SUT connection status ..... SUT not detected in most recent scan Power Management mode ........ Active (always awake) 0 vSTAs currently in the system. CMC_EE -> The CLI is now ready to accept your commands. 080104 6-1 Communication Machinery Corporation (CMC) NOTE: If the CLI displays the message “This EmulationEngine has not been Node Locked” after you enter the EE login name and password, see “Missing Key File” in Chapter 9, Troubleshooting. User Log-Off Use the quit command to log off from the CLI: CMC_EE -> quit After log-off, you must reopen the telnet connection to log in to the CLI. CLI Commands The “help” command will display a list of all CLI commands. Example: CMC_EE -> help List of EmulationEngine CLI commands: assoc -- Associate a vSTA with the SUT auth -- Authenticate a vSTA with the SUT acquireip -- Acquire an IP address for a vSTA releaseip -- Release a vSTA's IP address autoconf -- Autoconfig-init-auth-assoc N vSTAs autorun -- Run N configured/associated vSTAs clear bssid -- Clear BSSID for System Under Test clear evlog -- Clear event log file or buffer clear group -- Clear vSTA group data clear sntpserver -- Clear SNTP/NTP server IP address clear systemname -- Clear the EmulationEngine system name clear vsta -- Clear vSTA data conf -- Configure a vSTA deauth -- Deauthenticate a vSTA del group -- Delete a vSTA group del key -- Delete Encryption key del statfile -- Delete a vSTA statistics file del summfile -- Delete a vSTA statistics summary file del vsta -- Delete a vSTA disassoc -- Disassociate a vSTA exec -- Execute a command file ftp -- Software update via FTP get association -- Display Association Table get basic11b -- Display Basic 11b Rates get bssid -- Display BSSID of System Under Test get bsslist -- Display list of discovered BSSIDs get channel -- Display Radio Channel get config -- Display current EmulationEngine configuration get countrycode -- Display Country Code get ctsmode -- Display CTS mode (11g) get ctsrate -- Display CTS rate (11g) get ctstype -- Display CTS type (11g) get eemac -- Display Wireless LAN MAC Address get eemask -- Display Wireless LAN Address Mask get eestatus -- Display EmulationEngine status get evlog -- Display event log data get features -- Display authorized features get frequency -- Display Radio Frequency (MHz) get gateway -- Display Gateway IP Address get group -- Display information for a vSTA group get hardware -- Display Hardware Revisions get ipaddr -- Display IP Address get ipmask -- Display IP Subnet Mask get key -- Display Encryption Key 6-2 080104 EmulationEngine 11a/b/g User's Guide get keyentrymethod -- Display Encryption Key Entry Method get login -- Display Login User Name get pmmode -- Display Power Management Mode get power -- Display Transmit Power Setting get psinterval -- Display Power Save Listen Interval get rate -- Display Data Rate get shortpreamble -- Display Short Preamble (11b/11g) Usage get shortslottime -- Display Short Slot Time (11g) Usage get sntpserver -- Display SNTP/NTP Server IP Address get ssid -- Display Service Set ID get statfile -- Display vSTA statistics from file get station -- Display Station Status get summfile -- Display vSTA statistics summary from file get systemname -- Display the EmulationEngine system name get telnet -- Display Telnet Mode get tzone -- Display Time Zone Setting get uptime -- Display UpTime get version -- Display Firmware Version get vsta -- Display vSTA information get wirelessmode -- Display Wireless LAN Mode halt -- Halt a running vSTA help -- Display CLI Command List history -- Display the command line history init -- Initialize a configured vSTA join -- Join the EE with the System Under Test ping -- Ping quit -- Logoff reboot -- Reboot the EmulationEngine reset eemac -- Reset the WLAN MAC address to default value reset group -- Reset a vSTA group to the initialized state reset vsta -- Reset a vSTA to the initialized state run -- Run an associated vSTA save evlog -- Save the event log buffer to file save group -- Save vSTA group data save vsta -- Save vSTA data scan -- Acquire SUT (scan/join) set basic11b -- Set Use of Basic 11b Rates set bssid -- Set the BSSID for the System Under Test set countrycode -- Set Country Code set ctsmode -- Set CTS Mode (11g) set ctsrate -- Set CTS Rate (11g) set ctstype -- Set CTS Type (11g) set date -- Set the system date set eemac -- Set WLAN MAC Address set eemask -- Set WLAN Address Mask set evlog -- Set event log controls set factorydefault -- Restore to Default Factory Settings set features -- Upgrade current feature set set gateway -- Set Gateway IP Address set group -- Set vSTA group configuration parameters set ipaddr -- Set IP Address set ipmask -- Set IP Subnet Mask set key -- Set Encryption Key set keyentrymethod -- Select Encryption Key Entry Method set login -- Modify Login User Name set password -- Modify Password set pmmode -- Set Power Management Mode set power -- Set Transmit Power set psinterval -- Set Power Save Listen Interval set rate -- Set Data Rate 080104 6-3 Communication Machinery Corporation (CMC) set shortpreamble -- Set Short Preamble (11b/11g) Usage set shortslottime -- Set Short Slot Time (11g) Usage set sntpserver -- Set SNTP/NTP Server IP Address set ssid -- Set Service Set ID set systemname -- Set the EmulationEngine system name set telnet -- Set Telnet Mode set time -- Set the system time set tzone -- Set Time Zone Setting set vsta -- Set vSTA configuration parameters set wirelessmode -- Set Wireless LAN Mode timeofday -- Display Current Time of Day version -- Software version CMC_EE -> This list does not include the commands that are available in administrative mode. See “Administrative Mode Commands” for a list of additional commands that are available in administrative mode. System Under Test Commands These commands are used to scan for and join with a device that can be tested by the EmulationEngine. These commands must be used to select and join with a System Under Test before you can use the Virtual Station Set-Up and Control Commands described below. clear bssid -- Clear BSSID for System Under Test get bssid -- Display BSSID of System Under Test get bsslist -- Display list of discovered BSSIDs get wirelessmode -- Display Wireless LAN Mode join -- Join the EE with the System Under Test scan -- Acquire SUT (scan/join) set bssid -- Set the BSSID for the System Under Test set wirelessmode -- Set Wireless LAN Mode These commands can also be used to change the System Under Test while virtual stations are defined and active. Use the following command sequence: 1) Use the reset command to return all virtual stations to an initialized state: reset vsta all 2) If the new System Under Test is not in the EmulationEngine's BSS list, a scan is required: scan 3) Use the set bssid command to set the EmulationEngine to another System Under Test: set bssid4) Use the join command to join with the System Under Test: join 5) Issue the authenticate command for all virtual stations: auth vsta all 6) Issue the associate command for all virtual stations: assoc vsta all 7) Run the test for all virtual stations: run vsta all 6-4 080104 EmulationEngine 11a/b/g User's Guide bssid (get/set/clear) get bssid This command shows the current BSSID/MAC address of the system that is being tested. get bssid Example: CMC_EE -> get bssid BSSID of System Under Test: 00:04:e2:34:e0:a8 CMC_EE -> set bssid This command specifies the BSSID/MAC address of the system to be tested. This is the System Under Test that the EmulationEngine will scan for and join with. The default value is all zeros. NOTE: The EmulationEngine must be configured with a non-zero BSSID in order to perform a Join operation and to create and run virtual stations. set bssid : MAC address of the System Under Test. Example: CMC_EE -> set bssid 00:04:e2:34:e0:a8 BSSID of System Under Test: 00:04:e2:34:e0:a8 CMC_EE -> CMC_EE -> get bssid BSSID of System Under Test: 00:04:e2:34:e0:a8 CMC_EE -> clear bssid This command clears the current BSSID. clear bssid Example: CMC_EE -> clear bssid BSSID 00:04:e2:34:e0:a8 cleared use the set bssid CLI command to set the BSSID of the System Under Test CMC_EE -> bsslist (get) This command shows the Basic Service Sets discovered in the most recent scan. See the scan command. get bsslist Example: CMC_EE -> get bsslist BSS Type Channel RSSI BSSID -------- ---------- ----SUT BSS 5.180 ( 36) 38 00:04:e2:37:e6:a1 SUT BSS 5.200 ( 40) 36 00:05:5d:89:c5:f9 SUT BSS 5.220 ( 44) 35 00:04:e2:38:a7:87 SUT BSS 5.260 ( 52) 68 00:04:e2:38:a8:d2 SUT: 4, Ad-Hoc: 0. Total BSS: 4 CMC_EE -> 080104 SSID ---CMC/KDB SMC-1 Noah - DLink jeff SMC_03 6-5 Communication Machinery Corporation (CMC) join This command joins with the System Under Test. It must be present in the current Basic Service Set list. See the bsslist command. join Example: CMC_EE -> join The join should take about 1 sec CMC_EE -> EE Join: Checking BSS ... OK EE Join: Checking channel ... OK EE Join: Initiating JOIN ... Infrastructure 5.260 55 00:04:e2:38:a8:d2 SMC_03 EE Join: channel 5260, SMC_03 OK CMC_EE -> vSTA ID:0 NOTIFY Operation JOIN succeeded. - WED JUL 09 10:12:24 2003 CMC_EE -> scan This command scans for Basic Service Set IDs and, optionally, joins with the System Under Test. The EmulationEngine’s wireless mode affects the type of devices that can be discovered in a scan. See “set wirelessmode” to change the EmulationEngine’s wireless mode. NOTE: If a test is in process (see the run command), a scan operation will be disruptive to the normal testing operations of the EmulationEngine. CMC_EE -> scan Active (probe request) or passive (listen for beacons) [a/p: p]? Enter "a" and press the key to select an active scan. Just press the key to select the default passive mode. If passive mode is selected, the CLI will prompt for the following scanning options: Channel (0 = all) [0]? Channel timeout in msec [300]? Attempt a join with SUT 00:04:e2:34:e0:a8 [y/n: n]? If active mode is selected, the CLI will prompt for the following scanning options: Broadcast or directed probe request [b/d: d]? Channel (0 = all) [0]? Channel timeout in msec [300]? Attempt a join with SUT 00:04:e2:38:56:78 [y/n: n]? n In response to the Channel prompt, you may enter zero for all channels or any valid 802.11a or 802.11b/g channel number or frequency. The range of channels/frequencies depends on the wireless mode and the features that are enabled on the EmulationEngine. See the specifications in Appendix A for a list of valid channel numbers and frequencies for 802.11a, 802.11b, and 802.11g. Examples: CMC_EE -> scan Active (probe request) or passive (listen for beacons) [a/p:p]? Channel (0 = all) [0]? Channel timeout in msec [300]? 6-6 080104 EmulationEngine 11a/b/g User's Guide Attempt a join with SUT 00:04:e2:38:a8:d2 [y/n: n]? The scan should take about 4 sec CMC_EE -> OK CMC_EE -> CMC_EE -> Passive scanning 5 GHz 54Mbps (802.11a) channels for 4 seconds... BSS No. 0 BSSID 00:04:E2:38:A8:D2 BSS No. 1 BSSID 00:04:E2:38:56:68 BSS No. 2 BSSID 00:04:E2:37:E6:A1 BSS No. 3 BSSID 00:04:E2:38:A7:87 Select BSS: Looking for .. 00:04:E2:38:A8:D2 Select BSS: Found ........ 00:04:E2:38:A8:D2 => BSS'es from the selected wireless mode <= BSS Type Channel RSSI BSSID -------- ---------- ----SUT BSS 5.220 ( 44) 31 00:04:e2:38:a7:87 SUT BSS 5.260 ( 52) 55 00:04:e2:38:a8:d2 SUT BSS 5.280 ( 56) 46 00:04:e2:38:56:68 SUT BSS 5.300 ( 60) 44 00:04:e2:37:e6:a1 SUT: 4, Ad-Hoc: 0. Total BSS: 4 SSID ---jeff SMC_03 DSM APDUT CMC/KDB SMC-1 vSTA ID:0 NOTIFY Operation SCAN succeeded. - WED JUL 09 10:12:19 2003 CMC_EE -> scan Active (probe request) or passive (listen for beacons) [a/p: p]? a Broadcast or directed probe request [b/d: d]? Channel (0 = all) [0]? 2412 Channel timeout in msec [300]? Attempt a join with SUT 00:04:e2:38:a8:d2 [y/n: n]? The scan should take about 1 sec CMC_EE -> OK CMC_EE -> CMC_EE -> InitSingleScan -- 2412, a00 cck 2.4 Active scanning 2.4GHz 11Mbps (802.11b) channels for 1 seconds... wlanMlmeProbeRequest -- channel 2412 Select BSS: Looking for .. 00:04:E2:38:A8:D2 Select BSS: Found ........ 00:04:E2:38:A8:D2 InitSingleScan -- 2412, a00 cck 2.4 Active scanning 2.4GHz 11Mbps (802.11b) channels for 1 seconds... wlanMlmeProbeRequest -- channel 2412 vSTA ID:0 NOTIFY Operation SCAN succeeded. - THU JUL 24 09:59:06 2003 CMC_EE -> wirelessmode (get/set) get wirelessmode This command displays the current Wireless LAN Mode (11a, 11b, or 11g): get wirelessmode 080104 6-7 Communication Machinery Corporation (CMC) Example: CMC_EE -> get wirelessmode Wireless LAN Mode: 11g CMC_EE -> set wirelessmode This command sets the EmulationEngine’s Wireless LAN Mode: set wirelessmode : 11a = 802.11a, 11b = 802.11b, or 11g = 802.11g. The default value is 11g. NOTE: The feature set you ordered from CMC may limit the number of available wireless mode selections. The CLI will display an error message if the wireless mode selection is not in your feature set. Virtual Station Set-Up & Control Commands The following commands configure and activate virtual stations. Most of these commands require that you select and join with a System Under Test before the command is issued (see the “System Under Test Commands”). acquireip -- Acquire an IP address for a vSTA assoc -- Associate a vSTA with the SUT auth -- Authenticate a vSTA with the SUT autoconf -- Autoconfig-init-auth-assoc N vSTAs autorun -- Run N configured/associated vSTAs clear group -- Clear vSTA group data clear vsta -- Clear vSTA data conf -- Configure a vSTA deauth -- Deauthenticate a vSTA del group -- Delete a vSTA group del vsta -- Delete a vSTA disassoc -- Disassociate a vSTA get group -- Display information for a vSTA group get vsta -- Display vSTA information halt -- Halt a running vSTA releaseip –- Release a vSTA’s IP address init -- Initialize a configured vSTA reset group -- Reset a vSTA group to the initialized state reset vsta -- Reset a vSTA to the initialized state run -- Run an associated vSTA save group -- Save vSTA group data save vsta -- Save vSTA data set group -- Set vSTA group configuration parameters set vsta -- Set vSTA configuration parameters Most of the commands in this group require that you join with a System Under Test. If a join or scan has not been done, the CLI will display the following message: **You must do a "join" or a "scan" with the join option first. Use the System Under Test commands described above to join with a System Under Test before using the commands in this group. The following diagram illustrates the life cycle of a virtual station from its null (un-configured) state to its running state in the active execution of a test. This illustration will help you determine the sequence of commands to use to achieve the desired results with virtual station setup and control commands. 6-8 080104 EmulationEngine 11a/b/g User's Guide NOTES: The state names used in the diagram are defined as follows: Null: The virtual station does not yet exist, it hasn't been created (i.e., configured). Configured: The initial configuration parameters for the virtual station have been defined. Initialized: The virtual station has been added to the system's internal tables (addressing, etc.). Authenticated: The virtual station has been authenticated with the System Under Test. Associated: The virtual station has been associated with the System Under Test. Ready: The virtual station has received an IP address via DHCP or was configured with a static IP address. Running: The virtual station is running, either its internal load application or externally supplied network traffic. 080104 6-9 Communication Machinery Corporation (CMC) acquireip This command initiates the DHCP negotiation process for the specified virtual station(s). The virtual station must be in the 802.11 Associated state and the vSTA’s DHCP mode (dhcpmode) must be set to “on”. See the autoconf, conf, and set vsta commands for information about setting DHCP mode. acquireip : Virtual Station ID (1...64), Group ID (1...64), or “all” Example: CMC_EE -> acquireip vsta 1 CMC_EE -> OK vSTA ID:1 NOTIFY Operation ACQIP (10.1.35.10) succeeded - THU JAN 08 10:04:31 2004 assoc This command initiates the association sequence for one or more virtual stations. The virtual station(s) must be configured, initialized, and authenticated before this command can be used. The following command will initiate the association sequence for one or all virtual stations. assoc vsta : Virtual Station ID (1...64) or "all". If is set to "all" (i.e., assoc vsta all), the association sequence is initiated for all virtual stations. The following command will initiate the association sequence for all virtual stations in a specified group. assoc group : Group ID (1...64) Example: CMC_EE -> assoc vsta 1 CMC_EE -> OK CMC_EE -> vSTA ID:1 NOTIFY Operation ASSOC succeeded - TUE JUL 15 03:08:38 2003 CMC_EE -> auth This command initiates the authentication sequence for one or more virtual stations. The virtual station(s) must be configured and initialized before this command can be used. NOTE: The EmulationEngine supports both open system and shared key authentication. The following command will initiate the authentication sequence for one or all virtual stations. auth vsta : Virtual Station ID (1...64) or "all". If is set to "all" (i.e., auth vsta all), the authentication sequence is initiated for all virtual stations. 6-10 080104 EmulationEngine 11a/b/g User's Guide The following command will initiate the authentication sequence for all virtual stations in a specified group. auth group : Group ID (1...64) Example: CMC_EE -> auth vsta 1 CMC_EE -> OK CMC_EE ->vSTA ID:1 NOTIFY Operation AUTH succeeded - TUE JUL 15 03:08:15 2003 autoconf This command can be used to configure, initialize, authenticate and associate a number of virtual stations using a single command. It can be issued multiple times. The first time the command is issued the base MAC and IP virtual station addresses must be specified. For subsequent commands, the IP and MAC address parameters are not required. The specified number of virtual stations will be configured using either default values or the values specified in the command line. Except for the number of virtual stations to be configured, values are specified using a "name/value" pair syntax and may be given in any order. autoconf mac ip [group ] [csmode persistent|non-persistent] [retry ] [timeout ] [authentication open-system|shared-key] [encryption on|off] [keyindex ] [cipher wep] [mode internal|external] [target ] [count ] [size ] [dhcpmode ] [layer <2|3>] [fragmentthreshold ] [rtsthreshold ] : The number of virtual stations to be configured (1...64). If this is not the first autoconf command, new virtual stations will be configured starting at the last virtual station and incrementing for . Default: None. mac : Base/starting value to be used for virtual station MAC addresses. This parameter is required for the first autoconf command and should not be specified for subsequent commands. Default: Last MAC address + 1. The starting MAC address must be within the range of MAC addresses defined by the WLAN Base MAC Address and WLAN MAC Mask in EmulationEngine configuration (see “set eemac” & “set eemask”). ip : Base/starting value to be used for virtual station IP addresses. This parameter is required for the first autoconf command and should not be specified for subsequent commands. Default: Last IP address + 1. 080104 6-11 Communication Machinery Corporation (CMC) [group ]: Optional group ID number (1...64). [csmode persistent|non-persistent]: Connection mode (persistent or nonpersistent). [retry ]: If csmode is presistent, this parameter specifies the Authentication/Association retry limit (1...2,147,483,647 or zero (=no retries)). [timeout ]: If csmode is presistent, this parameter specifies the Authentication/Association timeout in milliseconds (1...2,147,483,647 or zero (=immediate timeout)). [authentication open-system|shared-key]: Authentication mode (opensystem or shared-key). [encryption on|off]: Encryption mode (on or off). [keyindex ]: If encryption is on, a shared key index number (1...4). [cipher wep]: Enables WEP cipher mode. [mode internal|external]: If mode is internal, virtual station(s) will generate data using Ping (ICMP Echo Request) packets. Each virtual station will run a ping transmitter process. The packets will contain virtual station IP and MAC source address. If Internal is specified the "target" parameter must also be specified. If mode is external, data for virtual station(s) will be generated by an external host connected to the same LAN as the EmulationEngine. For vSTAs configured at layer 3, IP and ARP packets generated from this host that contain the virtual station's IP address as a source will be translated at the MAC layer to appear as if sourced from the virtual station's MAC address. Default: Internal. [target ]: Target host's IP address. If mode is Internal this parameter is required. Default: None. [count ]: Number of ping packets to send: 0...2,147,483,647. Default: 1000. [size ]: Size of ping data buffer (64...1024). Default: 1024. [dhcpmode ]: The DHCP mode allows virtual stations to have IP addresses dynamically assigned 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, the EmulationEngine will automatically initiate lease negotiation if association succeeds. The default value is off. [layer <2|3>]: If mode is external, this parameter specifies how the external data stream is captured. If layer is 2, frames will be captured based on the source 802.3 MAC address. If layer is 3, frames will be captured based on the source IP address. The default value is 3. [fragmentthreshold ]: can be a value in the range 256...2346 and defines the fragmentation threshold for the virtual station(s) configured by this command. The fragmentation threshold will limit the number of bytes in any 802.11 frame transmitted by the vSTA. If is set to 2346 (i.e., the maximum 802.11 frame size), fragmentation is effectively disabled. The default value is 2346. 6-12 080104 EmulationEngine 11a/b/g User's Guide [rtsthreshold ]: can be a value in the range 1...2346 and 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 will require a successful RTS/CTS frame exchange before the frame is transmitted. The minimum value (1) effectively requires 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. Examples: CMC_EE -> autoconf 1 ip 10.1.35.234 mac 00:0b:16:57:00:01 target 10.1.35.10 fragmentthreshold 750 vSTA ID:1 IP:10.1.35.234 MAC:00:0b:16:57:00:01 CONF OK vSTA ID:1 INIT OK vSTA ID:1 AUTH CMD OK vSTA ID:1 AUTH NOTIFY OK vSTA ID:1 ASSOC CMD OK vSTA ID:1 ASSOC NOTIFY OK CMC_EE -> get vsta 1 conf vSTA Configuration: ID ........................ Group ID .................. IP Address ................ DHCP ................... MAC Address ............... Connection Mode ........... Auth/Assoc Retry .......... Authentication Timeout .... Association Timeout ....... Authentication ............ Cipher .................... Data Encryption ........... Shared-key Index .......... Fragmentation Threshold ... RTS Threshold ............. Mode ...................... Layer .................. Load Application .......... Target IP Address ......... Ping Transmit Count ....... Ping Data Size ............ 10.1.35.234 Off 00:0b:16:57:00:01 persistent 300 mSec 300 mSec Open-System WEP(RC4) Off 750 2346 internal ping 10.1.35.10 1000 1024 CMC_EE -> autoconf 1 ip 10.1.35.97 mac 00:0b:16:57:00:01 mode external layer 3 vSTA ID:1 IP:10.1.35.97 MAC:00:0b:16:57:00:01 CONF OK vSTA ID:1 INIT OK vSTA ID:1 AUTH CMD OK vSTA ID:1 AUTH NOTIFY OK vSTA ID:1 ASSOC CMD OK vSTA ID:1 ASSOC NOTIFY OK CMC_EE -> get vsta 1 conf vSTA Configuration: ID ........................ Group ID .................. IP Address ................ DHCP ................... MAC Address ............... 080104 10.1.35.97 Off 00:0b:16:57:00:01 6-13 Communication Machinery Corporation (CMC) Connection Mode ........... persistent Auth/Assoc Retry .......... 2 Authentication Timeout .... 300 mSec Association Timeout ....... 300 mSec Authentication ............ Open-System Cipher .................... WEP(RC4) Data Encryption ........... Off Shared-key Index .......... 0 Fragmentation Threshold ... 2346 RTS Threshold ............. 2346 Mode ...................... external Layer .................. 3 Load Application .......... ping Target IP Address ......... 0.0.0.0 Ping Transmit Count ....... 1000 Ping Data Size ............ 1024 CMC_EE -> autoconf 1 layer 2 mode external vSTA ID:2 IP:0.0.0.0 MAC:00:0b:16:57:00:02 CONF OK vSTA ID:2 INIT OK vSTA ID:2 AUTH CMD OK vSTA ID:2 AUTH NOTIFY OK vSTA ID:2 ASSOC CMD OK vSTA ID:2 ASSOC NOTIFY OK CMC_EE -> get vsta 2 conf vSTA Configuration: ID ........................ Group ID .................. IP Address ................ DHCP ................... MAC Address ............... Connection Mode ........... Auth/Assoc Retry .......... Authentication Timeout .... Association Timeout ....... Authentication ............ Cipher .................... Data Encryption ........... Shared-key Index .......... Fragmentation Threshold ... RTS Threshold ............. Mode ...................... Layer .................. Load Application .......... Target IP Address ......... Ping Transmit Count ....... Ping Data Size ............ CMC_EE -> 0.0.0.0 Off 00:0b:16:57:00:02 persistent 300 mSec 300 mSec Open-System WEP(RC4) Off 2346 2346 external ping 0.0.0.0 1000 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 This command automatically runs one or more configured virtual stations that are in the associated state. It is intended for use in conjunction with the autoconf command. Any other use may produce unexpected results. It will issue the run command for the specified number of virtual stations. autorun [nVstas] 6-14 080104 EmulationEngine 11a/b/g User's Guide [nVstas]: Optional number of virtual stations (1...64). If this parameter is omitted, the total number of auto-configured (autoconf) virtual stations is used. conf This command 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 with the "init" command. conf : Virtual Station ID (1...64) : Specify the virtual station’s WLAN IP address (nnn.nnn.nnn.nnn) – OR – a . can be on, off, or auto. on = manual (requires the acquireip command to initiate), 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 in EmulationEngine configuration (see “set eemac” & “set eemask”). : 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. Note that 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, the EmulationEngine uses the following default values for these attributes: 080104 Attribute Default Value authentication open-system cipher wep csmode persistent encryption off fragmentthreshold 2346 group keyindex 1 (i.e., shared key 0) layer retry rtsthreshold 2346 6-15 Communication Machinery Corporation (CMC) Attribute Default Value timeout 300 The “set vsta” command can be used to change any of these default values. Examples: CMC_EE -> conf 3 10.1.40.20 00:0b:cd:59:00:01 internal ping 10.1.40.16 64000 1024 CMC_EE -> OK CMC_EE -> conf 1 10.1.35.150 02:CF:1F:00:00:01 int ping 10.1.35.38 10 1024 CMC_EE -> OK CMC_EE -> conf 1 on 02:CF:1F:00:00:01 int ping 10.1.35.38 10 1024 CMC_EE -> OK CMC_EE -> conf 1 auto 02:CF:1F:00:00:01 int ping 10.1.35.38 10 1024 CMC_EE -> 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 This command initiates the de-authentication sequence for one or more virtual stations. The virtual station(s) must be configured, initialized and authenticated before this command can be used. The following command will initiate the de-authentication sequence for one or all virtual stations. deauth vsta : Virtual Station ID (1...64) or "all". If is set to "all" (i.e., deauth vsta all), the de-authentication sequence is initiated for all virtual stations. The following command will initiate the de-authentication sequence for all virtual stations in a specified group. deauth group : Group ID (1...64) Example: CMC_EE -> deauth vsta 1 CMC_EE -> OK CMC_EE ->vSTA ID:1 NOTIFY Operation DEAUTH succeeded - TUE JUL 15 03:09:56 2003 disassoc This command initiates the disassociation sequence for one or more virtual stations. The virtual station(s) must be configured, initialized, authenticated, and associated before this command can be used. The following command will initiate the disassociation sequence for one or all virtual stations. disassoc vsta : Virtual Station ID (1...64) or "all". If is set to "all" (i.e., disassoc vsta all), the disassociation sequence is initiated for all virtual stations. 6-16 080104 EmulationEngine 11a/b/g User's Guide The following command will initiate the disassociation sequence for all virtual stations in a specified group. disassoc group : Group ID (1...64) Example: CMC_EE -> disassoc vsta 1 CMC_EE -> OK CMC_EE ->vSTA ID:1 NOTIFY Operation DISASSOC succeeded - TUE JUL 15 03:09:50 2003 group (clear/del/get/reset/save/set) These commands display and modify group configuration. Group commands are a convenient way to reference multiple virtual stations using a single command. For example, the "set group" command will assign the specified parameters to all virtual stations in the group. clear group stats This command clears all statistics for all virtual stations in a specified group. clear group stats : Group ID (1...64) del group This command clears all configuration parameters for a specified group and removes the group from the system. del group : Group Number (1...64) Example: CMC_EE -> del group 2 5 vSTAs deleted CMC_EE -> OK CMC_EE ->vSTA ID:6 NOTIFY DELETED - reason: delete command WED JUL 16 07:35:27 2003 CMC_EE -> OK CMC_EE ->vSTA ID:7 NOTIFY DELETED - reason: delete command WED JUL 16 07:35:27 2003 CMC_EE -> OK CMC_EE ->vSTA ID:8 NOTIFY DELETED - reason: delete command WED JUL 16 07:35:27 2003 CMC_EE -> OK CMC_EE ->vSTA ID:9 NOTIFY DELETED - reason: delete command WED JUL 16 07:35:28 2003 CMC_EE -> OK CMC_EE ->vSTA ID:10 NOTIFY DELETED - reason: delete command WED JUL 16 07:35:28 2003 get group This command retrieves and displays a configuration parameter or statistics for all virtual stations in a group. get group 080104 6-17 Communication Machinery Corporation (CMC) : Group Number (1...64). If is “summary”, you may specify “all” as the group number (i.e., get group all summary) to display summary statistics for all groups. : The attribute of the information to get/display. It can be one of the following. See the set group command for a more detailed description of the information that may be shown by each of these attributes. !" authentication: Display the group’s authentication mode (open-system or shared-key). !" cipher: Display the group’s cipher mode (wep) !" count: If mode is “internal”, display the configured ping count (0...2,147,483,647) !" csmode: Display the group’s connection mode (persistent or nonpersistent) !" encryption: Display the group’s encryption mode: on or off. !" dhcpinfo: If dhcpmode is “on” or “auto”, display DHCP information. !" dhcpmode: Display the DHCP Mode setting (on, off, or auto). !" fragmentthreshold: Display fragmentation threshold setting (256...2346). !" keyindex: Display the group’s shared-key index (1, 2, 3, or 4) !" layer: If mode is “external”, display the method (layer 2 or 3) that is used to capture external data frames. !" lp: Load Protocol: ping !" mode: Display the group’s test mode (external or internal) !" retry: If csmode is “persistent”, display the configured Authentication/Association retry limit (1...2,147,483,647 or zero (=no retries)). !" rtsthreshold: Display group’s RTS threshold setting (1...2346). !" size: If mode is “internal”, display the configured ping packet size (64...1024). !" stats: Displays statistics counters for all virtual stations in a group. !" summary: Displays cumulative summary statistics for all virtual stations in one or all groups. !" target: If mode is “internal”, display the configured target IP address. !" timeout: If csmode is “persistent”, display the configured Authentication/Association timeout in milliseconds (1...2,147,483,647 or zero (=immediate timeout). Example: CMC_EE -> get group 1 csmode vSTA 1 connection mode: persistent vSTA 2 connection mode: persistent vSTA 3 connection mode: persistent vSTA 4 connection mode: persistent vSTA 5 connection mode: persistent 5 vSTAs found CMC_EE -> 6-18 080104 EmulationEngine 11a/b/g User's Guide reset group This command resets all virtual stations in a group to the Initialized state and clears all group statistics counters. reset group : Group Number (1...64) Example: CMC_EE -> reset group 1 5 vSTAs reset CMC_EE -> save group stats This command 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 will be stored in the /Statistics subdirectory and named "Vsta#Stats.dat" (where "#" is the virtual station ID). save group stats : Group ID (1...64) save group summary This command 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 will be stored in the /Statistics subdirectory and named "Grp#Summ.dat" (where "#" is the group ID). save group summary : Group ID (1...64) or "all". If is set to "all" (i.e., save group all summary), summary statistics are saved for all virtual stations in all groups. set group This command modifies configuration parameters for all virtual stations in a specified group. set group : Group Number (1...64) / : The allowable / combinations are defined in the following table. 080104 Default authentication “open-system” or “shared-key” open-system cipher “wep” wep count 0...2,147,483,647 1000 csmode “persistent” or “non-persistent” persistent dhcpmode “on”, “off”, or “auto” off encryption “on” or “off” off fragmentthreshold 256...2346 2346 keyindex 1, 2, 3, or 4 1 (i.e., shared key 0) 6-19 Communication Machinery Corporation (CMC) Default layer 2 or 3 lp “ping” ping mode “external” or “internal” internal retry 0...2,147,483,647 rtsthreshold 1...2346 2346 size 64...1024 1024 target An IP address in ASCII Dotted Decimal Notation: nnn.nnn.nnn.nnn (e.g., 10.1.35.100). none timeout 0...2,147,483,647 300 authentication: This attribute sets the authentication mode (opensystem or shared-key) for all virtual stations in the specified group. cipher: This attribute sets the cipher mode (wep) for all virtual stations in the specified group. 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 will remain persistent (connected) if the System Under Test deauthenticates or disassociates. If the EmulationEngine loses connection to a System Under Test, persistence will allow 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 the EmulationEngine, the virtual station will attempt 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 will continue. If it was in an associated state, the virtual station will reissue the associate request. dhcpmode: The DHCP mode allows virtual stations to have IP addresses dynamically assigned 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, the EmulationEngine will automatically initiate lease negotiation if association succeeds. The default value is off. encryption: This attribute sets the encryption mode (on or off) for all virtual stations in the specified group. fragmentthreshold: This attribute defines the fragmentation threshold for the virtual station(s) configured by this command. The fragmentation threshold will limit the number of bytes in any 802.11 frame transmitted by the vSTA. If is set to 2346 (i.e., the maximum 802.11 frame size), fragmentation is effectively disabled. The default value is 2346. keyindex: If encryption is “on”, this attribute assigns a shared key index number to all virtual stations in the specified group. 6-20 080104 EmulationEngine 11a/b/g User's Guide layer: If mode is external, this parameter specifies how the external data stream is captured. If layer is 2, frames will be captured based on the source 802.3 MAC address. If layer is 3, frames will 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). mode: This attribute defines the test mode (internal or external) for all virtual stations in the specified group. retry: If csmode is “persistent”, this attribute defines the group’s Authentication/Association retry limit (zero = no retries). rtsthreshold: This attribute 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 will require a successful RTS/CTS frame exchange before the frame is transmitted. The minimum value (1) effectively requires 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). target: If mode is “internal”, this attribute defines the target IP address. timeout: If csmode is “persistent”, this attribute defines the Authentication/Association timeout in milliseconds (zero = immediate timeout) Example: CMC_EE -> set group 1 size 64 5 vSTAs updated OK CMC_EE -> halt This command initiates 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 re-started by issuing a run command. The following command will execute the halt for one or all virtual stations. halt vsta : Virtual Station ID (1...64) or "all". If is set to "all" (i.e., halt vsta all), the halt command will be sent to all virtual stations. The following command will execute the halt for all virtual stations in a specified group. halt group : Group ID (1...64) Example: CMC_EE -> halt vsta 1 CMC_EE -> vSTA ID:1 halted OK CMC_EE -> 080104 6-21 Communication Machinery Corporation (CMC) init This command initializes one or more virtual stations. A virtual station must be configured before it can be initialized. See the "conf" command. The following command initializes one or all virtual stations. init vsta : Virtual Station ID (1...64) or "all". If is set to "all" (i.e., init vsta all), all virtual stations are initialized. The following command initializes all virtual stations in a specified group. init group : Group ID (1...64) Example: CMC_EE -> init vsta 1 CMC_EE -> OK releaseip This command releases the specified virtual station’s DHCP IP address lease. Following successful completion of this command, the specified virtual station(s) will transition to the lowest state required for initiating DHCP lease negotiations. The vSTA’s current IP address will be set to zero. If the vSTA is operating in internal mode, it will be removed from the ARP table. releaseip : Virtual Station ID (1...64), Group ID (1...64), or “all” Example: CMC_EE -> releaseip vsta 1 CMC_EE -> 10.1.35.10 (10.1.35.10) deleted OK run This command 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/re-started 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...64) or "all". If is set to "all" (i.e., 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...64) Example: CMC_EE ->run vsta 1 CMC_EE -> vSTA ID:1 running OK CMC_EE ->vSTA ID:1 NOTIFY Operation RUN completed. CMC_EE -> 6-22 080104 EmulationEngine 11a/b/g User's Guide vsta (clear/del/get/reset/save/set) These commands can be used to clear virtual station statistics, delete virtual stations from the system, display virtual station configuration and statistics, reset virtual stations, save virtual station statistics in a file, and to set virtual station parameters. clear vsta stats This command clears all statistics for one or more virtual stations. clear vsta stats : Virtual Station ID (1...64), "all", or "master". If is set to "all" (i.e., clear vsta all stats), this command will clear all statistics for all virtual stations. If is set to "master" (i.e., clear vsta master stats), this command will clear all statistics for the EmulationEngine. Example: CMC_EE -> clear vsta 1 stats CMC_EE -> del vsta This command clears all configuration parameters for one or more virtual stations and removes the virtual station(s) from the system. del vsta : Virtual Station ID (1...64) or "all". If is set to "all" (i.e., del vsta all), all virtual stations are deleted. Example: CMC_EE -> del vsta 1 CMC_EE -> OK CMC_EE ->vSTA ID:1 NOTIFY DELETED - reason: delete command WED JUL 16 07:44:09 2003 CMC_EE -> get vsta This command gets (retrieves and displays) a configuration parameter or statistics for one or all virtual stations. get vsta : Virtual Station ID (1...64). Use "all" to display for all virtual stations. If the is set to “stats” to display statistics, the can be set to “master” to show statistics for the EmulationEngine (i.e., get vsta master stats). If is “summary”, must be set to “all” : The attribute of the information to get. Omit this parameter (e.g., get vsta 1) to show a virtual station's complete configuration. Or, use one of the following attributes to show a specific configuration parameter. See the set vsta command for a more detailed description of the information that may be displayed by each of these attributes. 080104 !" authentication: Display the virtual station’s authentication mode (opensystem or shared-key). !" cipher: Display the virtual station’s cipher mode (wep). !" count: If mode is “internal”, display the configured ping count (0...2,147,483,647). 6-23 Communication Machinery Corporation (CMC) !" csmode: Display the virtual station’s connection mode (persistent or nonpersistent). !" dhcpinfo: If dhcpmode is “on” or “auto”, display DHCP information. !" dhcpmode: Display the DHCP Mode setting (on, off, or auto). !" encryption: Display the virtual station’s encryption mode (on or off). !" fragmentthreshold: Display the fragmentation threshold setting (256...2346). !" keyindex: If encryption is “on”, display the virtual station’s shared-key index (1, 2, 3, or 4). !" layer: Display the method (layer 2 or 3) that is used to capture external data frames. !" lp: If mode is “internal”, display the virtual station’s Load Protocol (ping). !" mode: Display the virtual station’s test mode (external or internal). !" retry: If csmode is “persistent”, display the Authentication/Association retry limit (1...2,147,483,647 or zero (=no retries)). !" rtsthreshold: Display the RTS threshold setting (1...2346). !" size: If mode is “internal”, display the configured ping packet size (64...1024). !" stats: Depending on the value of , display statistics counters for one virtual station, all virtual stations, or the EmulationEngine. !" summary: Display cumulative summary statistics for all virtual stations !" target: If mode is “internal”, display the configured ping target IP address (e.g., 10.1.35.100). !" timeout: If csmode is “persistent”, display the Authentication/Association timeout in milliseconds (1...2,147,483,647 or zero (=immediate timeout)). Example get vsta dhcpinfo: CMC_EE-> 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 6-24 080104 EmulationEngine 11a/b/g User's Guide Pkts rcvd err .... state err ...... xid err ........ Requested lease .. Lease duration ... Expiration ticks . Renewal ticks .... Rebind ticks ..... Leased Address ... DHCP Server ...... Relay ............ Server/relay MAC . Subnet Mask ...... Gateway .......... DNS Server ....... 3600 3600 3577 1777 3127 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 get vsta : CMC_EE->get vsta 1 vSTA Configuration: ID ........................ Group ID .................. IP Address ................ DHCP ................... MAC Address ............... Connection Mode ........... Auth/Assoc Retry .......... Authentication Timeout .... Association Timeout ....... Authentication ............ Cipher .................... Data Encryption ........... Shared-key Index .......... Fragmentation Threshold ... RTS Threshold ............. Mode ...................... Layer .................. Load Application .......... Target IP Address ......... Ping Transmit Count ....... Ping Data Size ............ CMC_EE -> 0.0.0.0 Auto 02:0b:cd:59:00:01 persistent 300 mSec 300 mSec Open-System WEP(RC4) Off 2346 2346 internal ping 10.1.38.38 1000 1024 Example get vsta count: CMC_EE -> get vsta 1 count vSTA 1 Ping count: 1000 Example get vsta state: CMC_EE -> get vsta 1 state vSTA: 1 State: Running Mode: internal vStaPingRcv:Active vStaPingXmt:Active CMC_EE -> Example get vsta stats: CMC_EE -> 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: 080104 6-25 Communication Machinery Corporation (CMC) 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 Packet loss: 0% Rcv Errors: 64, Tx Errors: 4 Rcv PHY Errors: 0, Excess Retries: Rcv CRC Errors: 64, Total Retries: Rcv Duplicates: 146, Tx Filtered: Rcv Discarded: 146, Tx Discarded: Ack Rcv Fails: 0, RTS Fails: Authentication Type: Open System Encryption: Off, FCS Fails: Rcv Decrypt Errs: 0, WEP Excluded: CMC_EE -> Example get vsta all summary: CMC_EE -> get vsta all summary Summary statistics for 5 vSTAs: Authentications: Deauthentications: Associations: Disassociations: 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 MSDUs 10 Data Multicast Management Control Error Tx Frames: Min Max Avg MSDUs Data Multicast Management 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: 6-26 Total 30 18 12 Total 12 12 080104 EmulationEngine 11a/b/g User's Guide Example get vsta all conf: CMC_EE -> get vsta all conf vSTA Configuration: ID ........................ Group ID .................. IP Address ................ DHCP ................... MAC Address ............... Connection Mode ........... Auth/Assoc Retry .......... Authentication Timeout .... Association Timeout ....... Authentication ............ Cipher .................... Data Encryption ........... Shared-key Index .......... Fragmentation Threshold ... RTS Threshold ............. Mode ...................... Layer .................. Load Application .......... Target IP Address ......... Ping Transmit Count ....... Ping Data Size ............ 0.0.0.0 Auto 02:0b:cd:59:00:01 persistent 300 mSec 300 mSec Open-System WEP(RC4) Off 2346 2346 internal ping 10.1.38.38 1000 1024 vSTA Configuration: ID ........................ Group ID .................. IP Address ................ DHCP ................... MAC Address ............... Connection Mode ........... Auth/Assoc Retry .......... Authentication Timeout .... Association Timeout ....... Authentication ............ Cipher .................... Data Encryption ........... Shared-key Index .......... Fragmentation Threshold ... RTS Threshold ............. Mode ...................... Layer .................. Load Application .......... Target IP Address ......... Ping Transmit Count ....... Ping Data Size ............ 0.0.0.0 Auto 02:0b:cd:59:00:02 persistent 300 mSec 300 mSec Open-System WEP(RC4) Off 2346 2346 internal ping 10.1.38.38 1000 1024 2 vSTAs found CMC_EE -> reset vsta This command resets virtual stations to the Initialized state and clears the virtual station's statistics counters. reset vsta : Virtual Station ID (1...64) or "all". If is set to all (i.e., reset vsta all), this command will reset all virtual stations. 080104 6-27 Communication Machinery Corporation (CMC) Example: CMC_EE -> reset vsta 1 CMC_EE -> save vsta stats This command writes all statistics for virtual stations to a file in the flash file system. The file will be stored in the /Statistics subdirectory and named "Vsta#Stats.dat" (where "#" is the virtual station ID). save vsta stats : Virtual Station ID (1...64), "all", or "master". If is set to all (i.e., save vsta all stats), statistics for all virtual stations are written to individual files. If is set to "master" (i.e., save vsta master stats), EmulationEngine statistics information are written in the file /Statistics/VstaMasterStats.dat. Example: CMC_EE -> save vsta 1 stats Wrote vSTA 1 statistics to file CMC_EE -> save vsta all summary This command saves cumulative summary statistics for all virtual stations to the file /Statistics/VstaAllSumm.dat. save vsta all summary Example: CMC_EE -> save vsta all summary Wrote vSTA all summary to file CMC_EE -> set vsta This command modifies virtual station parameters. set vsta : Virtual Station ID (1...64). If is anything other than "ip" or "mac", the can be given as "all" to apply the configuration parameter to all virtual stations. / : The allowable / combinations are defined in the following table. 6-28 Default authentication “open-system” or “shared-key” open-system cipher “wep” wep count 0...2,147,483,647 1000 csmode “persistent” or “non-persistent” persistent dhcpmode “on”, “off”, or “auto” off encryption “on” or “off” off fragmentthreshold 256...2346 2346 group 1...64 ip IP address in ASCII Dotted none 080104 EmulationEngine 11a/b/g User's Guide Default Decimal Notation: nnn.nnn.nnn.nnn (e.g., 10.1.35.100) keyindex 1, 2, 3, or 4 1 (i.e., shared key 0) layer 2 or 3 lp “ping” ping mac MAC address in ASCII Colon Separated Hexadecimal Notation: xx:xx:xx:xx:xx:xx (e.g., 02:cf:1f:00:00:01) none mode “external” or “internal” internal retry 0...2,147,483,647 rtsthreshold 1...2346 2346 size 64...1024 1024 target An IP address in ASCII Dotted Decimal Notation: nnn.nnn.nnn.nnn (e.g., 10.1.35.100). none timeout 0...2,147,483,647 300 authentication: This attribute sets the authentication mode (opensystem or shared-key) for virtual station(s) configured by this command. cipher: This attribute sets the cipher mode (wep) for virtual station(s) configured by this command. count: If mode is “internal”, this attribute sets the ping count (0...2,147,483,647) csmode: When csmode is enabled (persistent), virtual stations will remain persistent (connected) if the System Under Test de-authenticates or disassociates. If the EmulationEngine loses connection to a System Under Test, persistence will allow 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 the EmulationEngine, the virtual station will attempt 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 will continue. If it was in an associated state, the virtual station will reissue the associate request. dhcpmode: The DHCP mode allows virtual stations to have IP addresses dynamically assigned 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, the EmulationEngine will automatically initiate lease negotiation if association succeeds. The default value is off. 080104 6-29 Communication Machinery Corporation (CMC) encryption: This attribute sets the encryption mode (on or off) for virtual station(s) configured by this command. fragmentthreshold: This attribute defines the fragmentation threshold for the virtual station(s) configured by this command. The fragmentation threshold will limit the number of bytes in any 802.11 frame transmitted by the vSTA. If is set to 2346 (i.e., 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...64). ip: This attribute assigns an IP address to an individual virtual station. keyindex: If encryption is “on”, this attribute assigns a shared key index number to virtual station(s) configured by this command. layer: If mode is external, this parameter specifies how the external data stream is captured. If layer is 2, frames will be captured based on the source 802.3 MAC address. If layer is 3, frames will 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: This attribute assigns an MAC address to an individual virtual station. mode: This attribute defines the test mode (internal or external) for virtual station(s) configured by this command. retry: If csmode is “persistent”, this attribute defines the Authentication/Association retry limit (zero = no retries). rtsthreshold: This attribute 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 will require a successful RTS/CTS frame exchange before the frame is transmitted. The minimum value (1) effectively requires 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). target: If mode is “internal”, this attribute defines the target IP address. timeout: If csmode is “persistent”, this attribute defines the Authentication/Association timeout in milliseconds (zero = immediate timeout). Examples: CMC_EE -> set CMC_EE -> OK CMC_EE -> set CMC_EE -> OK CMC_EE -> set CMC_EE -> OK CMC_EE -> set CMC_EE -> OK CMC_EE -> set CMC_EE -> OK CMC_EE -> set CMC_EE -> OK 6-30 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 080104 EmulationEngine 11a/b/g User's Guide Statistics File Commands The del del get get following commands can be used to display and delete statistics files: statfile -- Delete a vSTA statistics file summfile -- Delete a vSTA statistics summary file statfile -- Display vSTA statistics from file summfile -- Display vSTA statistics summary from file See "Chapter 8, Statistics Counters" for a description of the fields that may be displayed by any of the commands in this group that display statistics counters. Also see the “group” and “vsta” commands under “Virtual Station Setup & Control Commands” above for commands that display, clear, and save statistics counters for a group or one or more virtual stations. Delete Statistics File del statfile group This command deletes the statistic file for all virtual stations in a specified group. del statfile group : Group ID (1...64) del statfile vsta This command deletes the statistic file for one or more virtual stations. del statfile vsta : Virtual Station ID (1...64), "all", or "master". If is set to "all" (i.e., del statfile vsta all), this command will delete the statistics file for all virtual stations. If is set to "master" (i.e., del statfile vsta master), this command will delete the statistics file for the EmulationEngine. Example: CMC_EE -> del statfile vsta 1 Deleted vSta 1 statistics file CMC_EE -> del summfile group This command deletes the group summary statistics file for one or all groups. del summfile group : Group ID (1...64) or "all". If is set to "all" (i.e., get group all summfile), group summary statistics are deleted for all groups. del summfile vsta all This command deletes the overall summary statistics file for all virtual stations. del vsta all summfile Get/Display Statistics File get statfile group This command retrieves and displays a statistics file for all virtual stations in a specified group. 080104 6-31 Communication Machinery Corporation (CMC) get statfile group : Group ID (1...64) get statfile vsta This command retrieves and displays a statistics file for one or more virtual stations. get statfile vsta : Virtual Station ID (1...64), "all", or "master". If is set to "all" (i.e., get statfile vsta all), this command will display the statistics file for all virtual stations. If is set to "master" (i.e., get statfile vsta master), this command will display the statistics file for the EmulationEngine. get summfile group This command displays cumulative statistics from a summary statistics file for all virtual stations in one or all groups. get summfile group : Group ID (1...64) or "all". If is set to "all" (i.e., get summfile group all), group summary statistics are displayed for all groups. get summfile vsta all This command displays 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, display the event log, set event log controls, and save the event log in a file. clear evlog -- Clear event log file or buffer get evlog -- Display event log data save evlog -- Save the event log buffer to file set evlog -- Set event log controls Also see "Chapter 7, Event Logging" for more information about how the EmulationEngine creates and maintains the event log. Clear Event Log clear evlog buffer This command clears the EmulationEngine's event log buffer. clear evlog buffer Example: CMC_EE -> clear evlog buffer clear evlog file This command clears a log file. clear evlog file : A or B Example: CMC_EE -> clear evlog file A 6-32 080104 EmulationEngine 11a/b/g User's Guide Get/Display Event Log get evlog buffer This command displays event log data from the event log buffer. get evlog buffer : the number of records to display. The CLI will display the last number of records in the buffer. Omit this parameter to show all records in the buffer. Example: CMC_EE -> 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 get evlog file This command displays event log data from an event log file. get evlog file [ [ ]] get evlog file ? : A or B : The first record to be displayed. Omit this parameter to start with the first record in the file. : The number of records to display. Omit this parameter to show all remaining records in the file. This parameter can only be used if is specified. Use "?" to display the number of records in the file. Example: CMC_EE -> get evlog file A ? Log file A has 15 records CMC_EE -> 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 080104 6-33 Communication Machinery Corporation (CMC) 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 get evlog settings This command displays the current event log control settings. get evlog settings Example: CMC_EE -> get evlog settings Event logging is enabled Event log verbosity : critical events only WLANTX module: disabled WLANRX module: disabled EE module: enabled VSTA module: enabled UI module: disabled Event data to console: disabled Event data to file : disabled CMC_EE -> Save Event Log (save evlog) This command 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 (i.e., 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 This command enables/disables event logging. set evlog : enable/disable Example: CMC_EE -> set evlog enable set evlog console This command enables/disables event logging to the console. set evlog console : enable/disable Example: CMC_EE -> set evlog console enable set evlog file This command enables/disables event logging to event log files. set evlog file 6-34 080104 EmulationEngine 11a/b/g User's Guide : enable/disable Example: CMC_EE -> set evlog file enable set evlog level This command 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: CMC_EE -> set evlog level 1 set evlog module This command enables/disables event logging for specific modules. set evlog module : WLANTX = 802.11 WLAN frame transmissions, WLANRX = 802.11 WLAN frame receptions, EE = EmulationEngine control, VSTA = Virtual station control, UI = User interface actions : enable/disable Example: CMC_EE -> set evlog module EE enable EmulationEngine Commands The commands in this group can be used to display and modify the EmulationEngine configuration. clear sntpserver -- Clear SNTP/NTP server IP address clear systemname -- Clear the EmulationEngine system name del key -- Delete Encryption key exec -- Execute a command file ftp -- Software update via FTP get association -- Display Association Table get channel -- Display Radio Channel get config -- Display current EmulationEngine configuration get countrycode -- Display Country Code get eemac -- Display Wireless LAN MAC Address get eemask -- Display Wireless LAN Address Mask get eestatus -- Display EmulationEngine status get features -– Display authorized features get frequency -- Display Radio Frequency (MHz) get gateway -- Display Gateway IP Address get hardware -- Display Hardware Revisions get hwtxretries – Display HW Transmit Retry Limit get ipaddr -- Display IP Address get ipmask -- Display IP Subnet Mask get key -- Display Encryption Key get keyentrymethod -- Display Encyrption Key Entry Method get login -- Display Login User Name 080104 6-35 Communication Machinery Corporation (CMC) get pmmode -- Get Power Management Mode get power -- Display Transmit Power Setting get psinterval -– Get Power Save Interval get rate -- Display Data Rate get sntpserver -- Display SNTP/NTP Server IP Address get station -- Display Station Status get systemname -- Display the EmulationEngine system name get telnet -- Display Telnet Mode get tzone -- Display Time Zone Setting get uptime -- Display UpTime help -- Display CLI Command List history -- Display the command line history ping -- Ping quit -- Logoff reboot -- Reboot the EmulationEngine reset eemac -- Reset the WLAN MAC address to default value set countrycode -- Set Country Code set date -- Set the system date set eemac -- Set WLAN MAC Address set eemask -- Set WLAN Address Mask set factorydefault -- Restore to Default Factory Settings set features -- Upgrade current feature set set gateway -- Set Gateway IP Address set hwtxretries – Set HW Transmit Retry Limit set ipaddr -- Set IP Address set ipmask -- Set IP Subnet Mask set key -- Set Encryption Key set keyentrymethod -- Select Encryption Key Entry Method set login -- Modify Login User Name set password -- Modify Password set pmmode -- Set Power Management Mode set power -- Set Transmit Power set psinterval -- Set Power Save Interval set rate -- Set Data Rate set sntpserver -- Set SNTP/NTP Server IP Address set systemname -- Set the EmulationEngine system name set telnet -- Set Telnet Mode set time -- Set the system time set tzone -- Set Time Zone Setting timeofday -- Display Current Time of Day version -- Software version !WARNING!: When EmulationEngine configuration settings are changed using many of these commands, the device will write all settings to a new configuration file in Flash. This process is delayed to allow multiple parameters to be changed. The new file will be written within one minute from the time the first parameter is changed. The EmulationEngine will display the following warning and confirmation: ** ** DO NOT REMOVE POWER FROM THE EmulationEngine! ** Wait for the EE 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. 6-36 080104 EmulationEngine 11a/b/g User's Guide association (get) This command shows a list of known stations and their association status. This list will include the master station, the System Under Test, and all virtual stations. get association Example: CMC_EE -> 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 State Up Associated Associated channel (get) This command displays the radio channel/frequency used by the EmulationEngine. The channel is set automatically when it joins with the System Under Test. get channel Example: CMC_EE -> get channel Radio Frequency: 5260 MHz (IEEE 52) CMC_EE -> config (get) This command displays the EmulationEngine configuration. get config Example: This example shows the default configuration. CMC_EE -> get config EmulationEngine Cfg Rev: 2 File Write Count: 5 Country Code: NA Wireless Mode: 802.11a Data Rate: best Login Username: Admin BSSID of System Under Test: 00:04:e2:38:a7:9c WLAN MAC Address: 00:00:00:00:00:00 WLAN MAC Address Mask: ff:ff:ff:ff:00:00 SSID: CMC EE Test Wireless Network System Name: DTIM: 1 IP Address: 192.168.0.50 IP Mask: 255.255.255.0 Host IP Address: 0.0.0.0 Gateway IP Address: 192.168.1.254 SNTP/NTP Server IP Address: Time Zone: HW Transmit Retry Limit: 4 TransmitPower: full Current Transmit Output Power 15.0 dBm Default transmit key: 1 Shared Key 1, size 40, 1234567890 Key Entry Method: hexadecimal Telnet: Enabled CMC_EE -> 080104 6-37 Communication Machinery Corporation (CMC) countrycode (get/set) get countrycode This command displays the country code that is currently configured in the EmulationEngine. get countrycode Example: CMC_EE -> get country code Country Code: US - UNITED_STATES set countrycode This command sets the country code configuration parameter for the EmulationEngine. set : An ISO standard country code (e.g., DB - DEBUG, NA - NO_COUNTRY_SET, PR - PUERTO_RICO, US - UNITED_STATES, etc.) Example: CMC_EE -> set countrycode us Country Code: US ** **DO NOT REMOVE POWER FROM THE EmulationEngine! **Wait for the EE to update the configuration file in Flash **or use the "reboot" command for immediate update & reboot. **Automatic update will be done within one minute. ** CMC_EE -> ...Configuration file update completed. get countrycode Country Code: US CMC_EE -> date (set) This command sets the current system date and (optionally) time in the EmulationEngine. set date [