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
![Communication Machinery Corporation (CMC) 6-6 080104 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 <Enter> key to select an active scan. Just press the <Enter> 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]?](https://usermanual.wiki/Ixia/EE11ABG3.User-Manual-part-3/User-Guide-421988-Page-6.png)
![EmulationEngine 11a/b/g User's Guide 080104 6-7 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 SSID -------- ------- ---- ----- ---- SUT BSS 5.220 ( 44) 31 00:04:e2:38:a7:87 jeff SUT BSS 5.260 ( 52) 55 00:04:e2:38:a8:d2 SMC_03 SUT BSS 5.280 ( 56) 46 00:04:e2:38:56:68 DSM APDUT SUT BSS 5.300 ( 60) 44 00:04:e2:37:e6:a1 CMC/KDB SMC-1 SUT: 4, Ad-Hoc: 0. Total BSS: 4 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](https://usermanual.wiki/Ixia/EE11ABG3.User-Manual-part-3/User-Guide-421988-Page-7.png)
![EmulationEngine 11a/b/g User's Guide 080104 6-11 The following command will initiate the authentication sequence for all virtual stations in a specified group. auth group <grpId> <grpId>: 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 <num> mac <mac_addr> ip <ip_addr> [group <grpId>] [csmode persistent|non-persistent] [retry <integer>] [timeout <integer>] [authentication open-system|shared-key] [encryption on|off] [keyindex <integer>] [cipher wep] [mode internal|external] [target <ip_addr>] [count <integer>] [size <integer>] [dhcpmode <off|on|auto>] [layer <2|3>] [fragmentthreshold <nBytes>] [rtsthreshold <nBytes>] <num>: 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 <num>. Default: None. mac <mac_address>: 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 <ip_address>: 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.](https://usermanual.wiki/Ixia/EE11ABG3.User-Manual-part-3/User-Guide-421988-Page-11.png)
![Communication Machinery Corporation (CMC) 6-12 080104 [group <grpId>]: Optional group ID number (1...64). [csmode persistent|non-persistent]: Connection mode (persistent or non-persistent). [retry <integer>]: If csmode is presistent, this parameter specifies the Authentication/Association retry limit (1...2,147,483,647 or zero (=no retries)). [timeout <integer>]: 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 (open-system or shared-key). [encryption on|off]: Encryption mode (on or off). [keyindex <integer>]: 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 <ip_address>]: Target host's IP address. If mode is Internal this parameter is required. Default: None. [count <integer>]: Number of ping packets to send: 0...2,147,483,647. Default: 1000. [size <integer>]: Size of ping data buffer (64...1024). Default: 1024. [dhcpmode <off|on|auto>]: 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 <nBytes>]: <nBytes> 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 <nBytes> is set to 2346 (i.e., the maximum 802.11 frame size), fragmentation is effectively disabled. The default value is 2346.](https://usermanual.wiki/Ixia/EE11ABG3.User-Manual-part-3/User-Guide-421988-Page-12.png)
![EmulationEngine 11a/b/g User's Guide 080104 6-13 [rtsthreshold <nBytes>]: <nBytes> 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 ........................ 1 Group ID .................. 1 IP Address ................ 10.1.35.234 DHCP ................... Off MAC Address ............... 00:0b:16:57:00:01 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 ... 750 RTS Threshold ............. 2346 Mode ...................... internal Layer .................. 3 Load Application .......... ping Target IP Address ......... 10.1.35.10 Ping Transmit Count ....... 1000 Ping Data Size ............ 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 ........................ 1 Group ID .................. 1 IP Address ................ 10.1.35.97 DHCP ................... Off MAC Address ............... 00:0b:16:57:00:01](https://usermanual.wiki/Ixia/EE11ABG3.User-Manual-part-3/User-Guide-421988-Page-13.png)
![Communication Machinery Corporation (CMC) 6-14 080104 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 ........................ 2 Group ID .................. 1 IP Address ................ 0.0.0.0 DHCP ................... Off MAC Address ............... 00:0b:16:57:00:02 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 .................. 2 Load Application .......... ping Target IP Address ......... 0.0.0.0 Ping Transmit Count ....... 1000 Ping Data Size ............ 1024 CMC_EE -> 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 <vStaId> group <grpId>” 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]](https://usermanual.wiki/Ixia/EE11ABG3.User-Manual-part-3/User-Guide-421988-Page-14.png)
![EmulationEngine 11a/b/g User's Guide 080104 6-15 [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 <vStaId> <ip|dhcp_value> <mac> <mode> <lp> <targetIP> <count> <size> <vStaId>: Virtual Station ID (1...64) <ip|dhcp_value>: Specify the virtual station’s WLAN IP address (nnn.nnn.nnn.nnn) – OR – a <dhcp_value>. <dhcp_value> 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. <mac>: 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”). <mode>: external or internal. If external mode is used, the remaining parameters (<lp> <target> <count> <size>) are optional. <lp>: Specifies the Load Application Protocol (ping). <targetIP>: Target IP address (nnn.nnn.nnn.nnn) <count>: Number of ICMP Echo Requests to transmit: 0...2,147,483,647. <size>: 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: Attribute Default Value authentication open-system cipher wep csmode persistent encryption off fragmentthreshold 2346 group 1 keyindex 1 (i.e., shared key 0) layer 3 retry 2 rtsthreshold 2346](https://usermanual.wiki/Ixia/EE11ABG3.User-Manual-part-3/User-Guide-421988-Page-15.png)
![EmulationEngine 11a/b/g User's Guide 080104 6-33 Get/Display Event Log get evlog buffer This command displays event log data from the event log buffer. get evlog buffer <n> <n>: the number of records to display. The CLI will display the last <n> 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 <fileAorB> [<startRec#> [<count>]] get evlog file <fileAorB> ? <fileAorB>: A or B <startRec#>: The first record to be displayed. Omit this parameter to start with the first record in the file. <count>: The number of records to display. Omit this parameter to show all remaining records in the file. This parameter can only be used if <startRec#> 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](https://usermanual.wiki/Ixia/EE11ABG3.User-Manual-part-3/User-Guide-421988-Page-33.png)
![Communication Machinery Corporation (CMC) 6-38 080104 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 <country_code> <country_code>: 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 <date> [<time>] <date>: current date in the format: mm/dd/yyyy <time>: current time in the format: hh:mm:ss. Use 24-hour clock numbers (i.e., 13:30:00 = 1:30PM). 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. Example: CMC_EE -> 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 CMC_EE -> eemac (get/reset/set) These commands are used to get (display), reset, and set the Wireless LAN MAC Address. The Wireless LAN MAC address defaults to a unique address (typically in the 00:0b:cd:xx:xx:xx range). It is a globally unique MAC address that is programmed in to the](https://usermanual.wiki/Ixia/EE11ABG3.User-Manual-part-3/User-Guide-421988-Page-38.png)
![EmulationEngine 11a/b/g User's Guide 080104 6-45 del key <key_number> get key This command displays an encryption key. get key <key_number> Example: CMC_EE -> get key 1 Shared Key 1, size 40, 1234567890 CMC_EE -> set key This command sets an encryption key or default shared key. set key["keynum"|unique][40|104|128]keystring set key [1-4] default Example: CMC_EE -> set key set key [1-4] default set key ["keynum"|unique] [40|104|128] value CMC_EE -> CMC_EE -> set key 1 40 1234567890 Shared Key 1, size 40: 1234567890 CMC_EE -> CMC_EE -> get key 1 Shared Key 1, size 40, 1234567890 CMC_EE -> keyentrymethod (get/set) get keyentrymethod This command displays the current Encryption Key Entry Method: get keyentrymethod Example: CMC_EE -> get keyentrymethod Key Entry Method: Hexadecimal CMC_EE -> set keyentrymethod This command sets the Encryption Key Entry Method: set keyentrymethod <method> <method>: hexadecimal = Key contains (0 - 9, A - F), asciitext = Key contains keyboard characters login (get/set) get login This command displays the login user name. -> get login Login Username: Example: CMC_EE -> get login Login Username: My_User_Name CMC_EE ->](https://usermanual.wiki/Ixia/EE11ABG3.User-Manual-part-3/User-Guide-421988-Page-45.png)
![Communication Machinery Corporation (CMC) 6-56 080104 command is not case sensitive. The administrative mode password that is required to successfully execute this command is also case sensitive. basic11g (get/set) get basic11g (11g only) This command displays the current setting of 802.11g wireless mode basic rates: get basic 11g Example: CMC_EE -> get basic11g Basic Rate Set (11g): (1, 2, 5.5, 11) CMC_EE -> set basic11g (11g only) This command sets the basic rates to be used in 802.11g wireless mode. set basic11g <mode> <mode>: 11 = Use Basic rates (1, 2), 11b = Use Basic rates (1, 2, 5.5, 11), 11g = Use Basic rates (1, 2, 5.5, 11, 6, 12, 24), ofdm = Use Basic rates (6, 12, 24). boot This command can be used to reboot the EmulationEngine from flash or the network. CMC_EE -> boot <source> <file> [hostname [hostIP [username [password] <source>: flash or ethernet <filename>: The name of an image file (.sys) to use to boot the EmulationEngine. <hostname>: If <source> is ethernet, the name of the host computer where <filename> resides. <hostIP>: If <source> is ethernet, the IP address of the host computer where <filename> resides. <username>: If <source> is ethernet, the user name required to access <hostname>. <password>: If <source> is ethernet, the password required to access <hostname>. Examples: CMC_EE -> boot flash ee22.sys boot device : tffs: unit number : 0 processor number : 0 file name : /fl/ee22.sys inet on ethernet (e) : 192.168.0.50 host inet (h) : 192.168.0.2 gateway inet (g) : 10.10.5.1 user (u) : anonymous ftp password (pw) : atheros flags (f) : 0x0 other (o) : dp](https://usermanual.wiki/Ixia/EE11ABG3.User-Manual-part-3/User-Guide-421988-Page-56.png)
![EmulationEngine 11a/b/g User's Guide 080104 8-1 CHAPTER 8: Event Logging Overview During normal operation, the EmulationEngine processes and can log various types of events. When an event is logged, a record of the event is stored for future analysis. The event record includes a timestamp, an indicator of the type of event that occurred, and a limited amount of data to describe the event. Event logging is controlled on three levels: 1) master enable (controlled by set evlog enable/disable) 2) verbosity level (controlled by set evlog level <level>) 3) module enable (controlled by set evlog module <module name> enable/disable) 1) The master enable controls whether event logging occurs at all. The master control is independent of other filters. If "set evlog disable" is used, enabling event logging for a particular module has no effect. 2) 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. 3) Each event is processed by a given module or process within the EmulationEngine. The various processes of the system can be individually enabled for event logging. The event logging function stores event records into a buffer area in memory. The log buffer is a circular buffer that can store 512 event records. The "get evlog buffer" command can be used to display the contents of the buffer at any time. Event data can also be written to a log file in Flash. When writing to a file is enabled by the "set evlog file enable" command, the log buffer is flushed to a file every 30 seconds or every time it wraps at the 512-record limit (which ever comes first). There are two log files, A and B. The EmulationEngine will alternate between the two files so that at least one full file is available at any given time. Each log file can store up to 4,000 event records. You can display the records stored in either file using the "get evlog file A" and "get evlog file B" CLI commands. Event Record Format Event records are printed in the following format: [header]: [message] [optional parameters] [header] is a standard header consisting of a timestamp, microsecond clock reference and sequence number (e.g.: 12/27/2002, 9:59:57, 2296.320226,11396). timestamp = time the event occurred, taken from the system clock (e.g., 12/27/2002,9:59:57). microsecond clock reference = time in seconds, resolution to 1 microsecond, not synchronized to timestamp (e.g, 2296.320226). sequence number = a sequential number assigned to each record (e.g., 11396; next event would be 11397, 11398, etc.) [message] is very brief text string (typically < 15-20 characters) indicating the type of event that occurred (e.g.: RX: ok indicates a valid 802.11 frame received without error).](https://usermanual.wiki/Ixia/EE11ABG3.User-Manual-part-3/User-Guide-421988-Page-69.png)
![Communication Machinery Corporation (CMC) 8-2 080104 [optional parameters] describe the specific circumstances of this particular occurrence of the event. It can be up to four 32-bit parameters. Example: pDesc 0x9326c0 hwStatus 01cd803c:0be20203 numRxDesc 9643712. Example: 12/27/2002,9:59:57,2296.320226,11396: RX: ok pDesc 0x9326c0 hwStatus 01cd803c:0be20203 numRxDesc 9643712 CLI Commands The following CLI commands control event logging: set evlog enable/disable: This is the master control to enable or disable event logging (i.e., to the event log buffer in RAM). The default is enabled. set evlog level <level>: This command sets the verbosity level (0/critical, 1/low, 2/medium, or 3/high) for event logging. The default is critical. set evlog module <module> enable/disable: This command enables or disables logging of events from a specified module or process: EmulationEngine control, virtual station control, WLAN transmit/receive events, and User Interface events. By default, the following processes are enabled for event logging: EmulationEngine control events and virtual station control events. The following processes are disabled for event logging: WLAN transmit and receive events and User Interface events. set evlog console enable/disable: This command enables or disables logging directly to the console. The default is disabled. set evlog file enable/disable: This command enables or disables recording logged events to file. The default is disabled. get evlog settings: This command shows the current event log control settings. get evlog buffer [n] – This command prints the last n events logged to the log buffer in memory. If [n] is omitted or zero, all events currently in the log buffer will be displayed. get evlog file A/B <startRec#> <count>: This command displays event records in log file A or B. If no starting record number <startRec#> is given, records are displayed starting with the first record in the file. If no count of records is given, all records are displayed. You can also use "?" to display the number of records in the file. clear evlog file A/B: This command clears all records from log file A or B clear evlog buffer: This command clears all event records from the log buffer. save evlog: This command flushes all records from the log buffer to the log file, even if log to file is not enabled. NOTE: Event log control settings are not permanent. They are not saved with other configuration controls. They must be entered following startup as desired to change event log operation from the default settings. The Web-Based User Interface You can configure and display the event log by selecting the Logging tab in the web-based user interface side bar. See the "Event Log Side Bar" in Chapter 5 for details.](https://usermanual.wiki/Ixia/EE11ABG3.User-Manual-part-3/User-Guide-421988-Page-70.png)
