Communication machinery corporation Emulationengine 11a/b/g User manual

v2.3

Communication Machinery Corporation | 402 E. Gutierrez Street | Santa Barbara, CA. 93101

Phone: 1.805.879.1521| Fax: 1.805.564.7188 | Web: www.cmc.com

Communication Machinery Corporation (CMC)

ii 080104

rights reserved. This document may not be reproduced in whole or in part

by any means without the written consent of CMC.

EmulationEngine and vSTA are registered trademarks of Communication

Machinery Corporation.

The web-based user interface uses the GoAhead WebServer: Copyright (c)

Radio Frequency Interference Requirements

802.11a devices transmit in the 5 GHz band. 802.11b and 802.11g

devices transmit in the 2.4 GHz band. FCC regulations require this product

to be used indoors to reduce the potential for interference with (to or

from) other devices that operate in the same frequency range.

FCC Warning

This equipment has been tested and found to comply with the limits for a

Class B digital device, pursuant to Part 15 of the FCC rules. These limits

are designed to provide reasonable protection against harmful

interference in a residential installation. This equipment generates, uses,

and can radiate radio frequency energy and, if not installed and used in

accordance with the instructions, may cause harmful interference to radio

communications. There is no guarantee that interference will not occur in

a particular installation. If this equipment does cause harmful interference

to radio or television reception, which can be determined by turning the

equipment off and on, the user is encouraged to try to correct the

interference by one or more of the following measures:

!" Reorient or relocate the radio /TV receiving antenna.

!" Increase the separation between the equipment and the radio/TV receiver.

!" Connect the equipment to an outlet that is on a different circuit from

where the radio/TV receiver is connected.

!" Consult the dealer or an experienced radio/TV technician for help.

Unless expressly approved by CMC, modifications to this product could

void the user's authority to operate the equipment.

RF Exposure Requirements

To ensure compliance with FCC RF exposure requirements, the antenna

used for this device must be installed to provide a separation distance of

at least 20 cm from all persons and must not be co-located or operating in

conjunction with any other antenna or radio transmitter. Installers and

end-users must follow the installation instructions provided in this guide.

EmulationEngine 11a/b/g User's Guide

080104 iii

TABLE OF CONTENTS

CHAPTER 1:

CHAPTER 1:CHAPTER 1:

CHAPTER 1: Overview

OverviewOverview

Overview ................................

................................................................

..................................

....

..1

---1

Packaging Checklist ................................................................................... 1-1

Feature List .............................................................................................. 1-2

Files......................................................................................................... 1-3

System Requirements................................................................................ 1-3

Hardware Characteristics............................................................................ 1-4

General Usage Notes ................................................................................. 1-4

CHAPTER 2:

CHAPTER 2:CHAPTER 2:

CHAPTER 2: Connectors, LEDs & Antennas

Connectors, LEDs & AntennasConnectors, LEDs & Antennas

Connectors, LEDs & Antennas................................

................................................................

.............................................................

..........................................................

.............................2

---1

Front Panel/LEDs....................................................................................... 2-1

Back Panel................................................................................................ 2-2

Connectors............................................................................................ 2-2

Antennas............................................................................................... 2-2

Reset Button.......................................................................................... 2-2

CHAPTER 3:

CHAPTER 3:CHAPTER 3:

CHAPTER 3: Installation

InstallationInstallation

Installation................................

................................................................

.................................

...3

---1

Connecting Directly to a Command PC ......................................................... 3-1

Connecting Through an Ethernet Hub/Switch ................................................ 3-1

Connecting to the Serial Port (Optional) ....................................................... 3-1

CHAPTER 4:

CHAPTER 4:CHAPTER 4:

CHAPTER 4: Initial Setup

Initial SetupInitial Setup

Initial Setup................................

................................................................

...............................................................

..............................................................

...............................4

---1

For an Ethernet Port Connection.................................................................. 4-1

For a Serial Port Connection........................................................................ 4-3

CHAPTER 5:

CHAPTER 5:CHAPTER 5:

CHAPTER 5: The Web

The WebThe Web

The Web-

---Based User Interface

Based User InterfaceBased User Interface

Based User Interface................................

................................................................

............................................................

........................................................

............................5

---1

System Requirements................................................................................ 5-1

Start-Up/Login.......................................................................................... 5-1

Choosing a Scenario/Test ........................................................................... 5-1

Create New Scenario .............................................................................. 5-3

Open Existing Scenario ........................................................................... 5-4

The Main Page ....................................................................................... 5-4

Creating an Internal Mode/Ping Test......................................................... 5-5

Creating an External Mode Test................................................................ 5-8

Running a Test.......................................................................................... 5-9

About/Using the Main Page........................................................................5-11

Group Control Grid ................................................................................5-14

Load Profile ..........................................................................................5-18

Target Systems.....................................................................................5-18

Load Profile/Monitor Graphs....................................................................5-19

Range Checking/Error Messages..............................................................5-20

Using Load Profiles ................................................................................5-20

vSTA Side Bar..........................................................................................5-22

vSTA->New Group ................................................................................5-22

vSTA->New Group->vSTA...................................................................5-22

vSTA->New Group->Traffic .................................................................5-24

vSTA->New Group->Runtime ..............................................................5-26

vSTA->New Group->On Error..............................................................5-27

vSTA->New Group->Encryption...........................................................5-29

vSTA->Edit Group .................................................................................5-30

vSTA->Delete Group .............................................................................5-31

vSTA->Add New vSTA to Group ..............................................................5-31

EE (EmulationEngine) Side Bar...................................................................5-32

EE->Select SUT ....................................................................................5-33

EE->Join SUT .......................................................................................5-34

EE->Configure EE..................................................................................5-34

EE->Configure EE->UI........................................................................5-34

EE->Configure EE->EE/Basic...............................................................5-36

EE->Configure EE->EE/Radio...............................................................5-38

EE->Configure EE->EE/Power..............................................................5-39

Communication Machinery Corporation (CMC)

iv 080104

EE->Reconnect EE.................................................................................5-41

EE->Reset EE .......................................................................................5-42

EE->Reboot EE .....................................................................................5-42

Monitors Side Bar .....................................................................................5-43

Monitors->New Monitor..........................................................................5-43

Monitors->New Monitor->Predefined ....................................................5-43

Monitors->New Monitor->Summary .....................................................5-44

Monitors->New Monitor->vSTA............................................................5-45

Monitors->Delete Monitor.......................................................................5-47

Monitors->Clear Monitor ........................................................................5-47

Monitors->Export Monitor.......................................................................5-48

Monitors->Config Monitors .....................................................................5-49

Event Log Side Bar ...................................................................................5-50

Event Log->Event Log ...........................................................................5-50

Event Log->Clear Log ............................................................................5-51

Event Log->Export Log ..........................................................................5-52

Event Log->Configure Log......................................................................5-52

Reports Side Bar ......................................................................................5-53

Reports->EE Configuration .....................................................................5-54

Reports->Scenario Summary..................................................................5-54

Reports->Group Summary .....................................................................5-55

Reports->vSTA Master...........................................................................5-56

Reports->vSTA Detail ............................................................................5-57

Reports->Export Reports........................................................................5-57

Configuration Side Bar ..............................................................................5-58

Configuration->Encryption .....................................................................5-58

Configuration->Ping Defaults..................................................................5-59

Configuration->Preferences....................................................................5-60

Menus & Toolbars.....................................................................................5-60

File Toolbar ..........................................................................................5-61

Edit Toolbar..........................................................................................5-61

Scenario Toolbar ...................................................................................5-61

vSTA Toolbar........................................................................................5-61

Reports Toolbar ....................................................................................5-62

Monitor Toolbar.....................................................................................5-62

File Menu .............................................................................................5-64

Edit Menu.............................................................................................5-66

Scenario Menu ......................................................................................5-66

Group Menu..........................................................................................5-67

vSTA Menu...........................................................................................5-68

Reports Menu .......................................................................................5-68

Options Menu .......................................................................................5-69

CHAPTER 6:

CHAPTER 6:CHAPTER 6:

CHAPTER 6: The Command Line Interface (CLI)

The Command Line Interface (CLI)The Command Line Interface (CLI)

The Command Line Interface (CLI)................................

................................................................

....................................................

........................................

....................6

---1

CLI Usage Notes........................................................................................ 6-1

User Log-In .............................................................................................. 6-1

User Log-Off ............................................................................................. 6-2

CLI Commands.......................................................................................... 6-2

System Under Test Commands.................................................................... 6-4

bssid (get/set/clear) ............................................................................... 6-5

get bssid............................................................................................ 6-5

set bssid ............................................................................................ 6-5

clear bssid.......................................................................................... 6-5

bsslist (get)........................................................................................... 6-5

join ...................................................................................................... 6-6

scan ..................................................................................................... 6-6

wirelessmode (get/set) ........................................................................... 6-7

EmulationEngine 11a/b/g User's Guide

080104 v

get wirelessmode ................................................................................ 6-7

set wirelessmode ................................................................................ 6-8

Virtual Station Set-Up & Control Commands ................................................. 6-8

acquireip..............................................................................................6-10

assoc...................................................................................................6-10

auth ....................................................................................................6-10

autoconf...............................................................................................6-11

autorun................................................................................................6-14

conf.....................................................................................................6-15

deauth.................................................................................................6-16

disassoc...............................................................................................6-16

group (clear/del/get/reset/save/set)........................................................6-17

clear group stats................................................................................6-17

del group ..........................................................................................6-17

get group..........................................................................................6-17

reset group .......................................................................................6-19

save group stats ................................................................................6-19

save group summary..........................................................................6-19

set group ..........................................................................................6-19

halt .....................................................................................................6-21

init ......................................................................................................6-22

releaseip ..............................................................................................6-22

run......................................................................................................6-22

vsta (clear/del/get/reset/save/set)..........................................................6-23

clear vsta stats ..................................................................................6-23

del vsta.............................................................................................6-23

get vsta ............................................................................................6-23

reset vsta..........................................................................................6-27

save vsta stats...................................................................................6-28

save vsta all summary........................................................................6-28

set vsta.............................................................................................6-28

Statistics File Commands...........................................................................6-31

Delete Statistics File ..............................................................................6-31

del statfile group................................................................................6-31

del statfile vsta ..................................................................................6-31

del summfile group.............................................................................6-31

del summfile vsta all...........................................................................6-31

Get/Display Statistics File.......................................................................6-31

get statfile group................................................................................6-31

get statfile vsta..................................................................................6-32

get summfile group ............................................................................6-32

get summfile vsta all ..........................................................................6-32

Event Log Commands ...............................................................................6-32

Clear Event Log.....................................................................................6-32

clear evlog buffer ...............................................................................6-32

clear evlog file ...................................................................................6-32

Get/Display Event Log ...........................................................................6-33

get evlog buffer .................................................................................6-33

get evlog file......................................................................................6-33

get evlog settings...............................................................................6-34

Save Event Log (save evlog)...................................................................6-34

Set Event Log Controls...........................................................................6-34

set evlog...........................................................................................6-34

set evlog console................................................................................6-34

set evlog file......................................................................................6-34

set evlog level ...................................................................................6-35

Communication Machinery Corporation (CMC)

vi 080104

set evlog module................................................................................6-35

EmulationEngine Commands......................................................................6-35

association (get) ...................................................................................6-37

channel (get)........................................................................................6-37

config (get) ..........................................................................................6-37

countrycode (get/set) ............................................................................6-38

get countrycode .................................................................................6-38

set countrycode .................................................................................6-38

date (set).............................................................................................6-38

eemac (get/reset/set)............................................................................6-38

get eemac.........................................................................................6-39

reset eemac ......................................................................................6-39

set eemac .........................................................................................6-39

eemask (get/set) ..................................................................................6-39

get eemask .......................................................................................6-39

set eemask........................................................................................6-40

eestatus (get).......................................................................................6-40

exec ....................................................................................................6-40

factorydefault (set)................................................................................6-40

features (get/set)..................................................................................6-41

get features.......................................................................................6-41

set features.......................................................................................6-41

frequency (get).....................................................................................6-41

ftp.......................................................................................................6-42

gateway (get/set) .................................................................................6-42

get gateway ......................................................................................6-42

set gateway.......................................................................................6-43

hardware (get) .....................................................................................6-43

help.....................................................................................................6-43

history.................................................................................................6-43

hwtxretries (get/set) .............................................................................6-43

get hwtxretries ..................................................................................6-43

set hwtxretries...................................................................................6-44

ipaddr (get/set) ....................................................................................6-44

get ipaddr .........................................................................................6-44

set ipaddr..........................................................................................6-44

ipmask (get/set) ...................................................................................6-44

get ipmask ........................................................................................6-44

set ipmask ........................................................................................6-44

key (del/get/set)...................................................................................6-44

del key..............................................................................................6-44

get key .............................................................................................6-45

set key .............................................................................................6-45

keyentrymethod (get/set) ......................................................................6-45

get keyentrymethod ...........................................................................6-45

set keyentrymethod............................................................................6-45

get login ...........................................................................................6-45

set login............................................................................................6-46

password (set)......................................................................................6-46

ping.....................................................................................................6-46

pmmode (get/set).................................................................................6-46

get pmmode......................................................................................6-46

set pmmode ......................................................................................6-47

power (get/set).....................................................................................6-47

get power..........................................................................................6-47

EmulationEngine 11a/b/g User's Guide

080104 vii

set power..........................................................................................6-47

psinterval (get/set) ...............................................................................6-48

get psinterval ....................................................................................6-48

set psinterval.....................................................................................6-48

quit .....................................................................................................6-48

rate (get/set)........................................................................................6-48

get rate.............................................................................................6-48

set rate.............................................................................................6-49

reboot..................................................................................................6-49

sntpserver (get/set/clear) ......................................................................6-49

clear sntpserver .................................................................................6-49

get sntpserver ...................................................................................6-49

set sntpserver....................................................................................6-50

station (get) .........................................................................................6-50

systemname (clear/get/set) ...................................................................6-50

clear systemname ..............................................................................6-50

get systemname ................................................................................6-50

set systemname.................................................................................6-50

telnet (get/set) .....................................................................................6-50

get telnet ..........................................................................................6-50

set telnet ..........................................................................................6-50

time (set).............................................................................................6-51

timeofday.............................................................................................6-51

tzone (get/set) .....................................................................................6-51

get tzone ..........................................................................................6-51

set tzone...........................................................................................6-51

uptime (get).........................................................................................6-51

version (get) ........................................................................................6-51

802.11b/g Commands...............................................................................6-52

basic11b (get/set).................................................................................6-52

get basic11b (11b only) ......................................................................6-52

set basic11b (11b only).......................................................................6-52

ctsmode (get/set) .................................................................................6-53

get ctsmode (11g only).......................................................................6-53

set ctsmode (11g only).......................................................................6-53

ctsrate (get/set)....................................................................................6-53

get ctsrate (11g only).........................................................................6-53

set ctsrate (11g only) .........................................................................6-53

ctstype (get/set)...................................................................................6-53

get ctstype (11g only) ........................................................................6-53

set ctstype (11g only).........................................................................6-54

shortpreamble (get/set).........................................................................6-54

get shortpreamble (11b/11g)...............................................................6-54

set shortpreamble (11b/11g)...............................................................6-54

shortslottime (get/set)...........................................................................6-54

get shortslottime (11g only) ................................................................6-54

set shortslottime (11g only) ................................................................6-54

Administrative Mode Commands.................................................................6-55

admin (clear)........................................................................................6-55

basic11g (get/set).................................................................................6-56

get basic11g (11g only) ......................................................................6-56

set basic11g (11g only).......................................................................6-56

boot ....................................................................................................6-56

bootrom...............................................................................................6-57

calibration (get/set)...............................................................................6-57

get calibration....................................................................................6-57

Communication Machinery Corporation (CMC)

viii 080104

set calibration....................................................................................6-57

cp .......................................................................................................6-57

format .................................................................................................6-57

hostipaddr (get/set) ..............................................................................6-57

get hostipaddr ...................................................................................6-57

set hostipaddr....................................................................................6-57

ls ........................................................................................................6-58

mv ......................................................................................................6-58

regulatorydomain (set) ..........................................................................6-58

rm.......................................................................................................6-58

trace....................................................................................................6-58

watchdog (get/set)................................................................................6-59

get watchdog.....................................................................................6-59

set watchdog.....................................................................................6-59

Example Configurations.............................................................................6-59

Example First Time Configuration............................................................6-59

Example Security Configuration...............................................................6-60

Changing the EmulationEngine IP Address................................................6-61

CLI Editor................................................................................................6-64

Movement & Search Commands..............................................................6-65

Insert Commands..................................................................................6-65

Editing Commands ................................................................................6-66

Special Commands................................................................................6-66

CHAPTER 7:

CHAPTER 7:CHAPTER 7:

CHAPTER 7: The Programming Interface (Perl)

The Programming Interface (Perl)The Programming Interface (Perl)

The Programming Interface (Perl)................................

................................................................

.......................................................

..............................................

.......................7

---1

CHAPTER 8:

CHAPTER 8:CHAPTER 8:

CHAPTER 8: Event Logging

Event LoggingEvent Logging

Event Logging ................................

................................................................

..........................................................

....................................................

..........................8

---1

Overview.................................................................................................. 8-1

Event Record Format ................................................................................. 8-1

CLI Commands.......................................................................................... 8-2

The Web-Based User Interface.................................................................... 8-2

CHAPTER 9:

CHAPTER 9:CHAPTER 9:

CHAPTER 9: Statistics Counters

Statistics CountersStatistics Counters

Statistics Counters ................................

................................................................

..................................................

....................................

..................9

---1

Individual Virtual Station Counters .............................................................. 9-1

Individual Virtual Station 802.11 Management Counters ............................. 9-1

Individual Virtual Station Signal Quality Indication...................................... 9-1

Individual Virtual Station Frame Counts .................................................... 9-1

Individual Virtual Station Ping Statistics .................................................... 9-2

Individual Virtual Station Error Statistics ................................................... 9-2

Summary Statistics.................................................................................... 9-3

Summary Signal Counters....................................................................... 9-3

Summary Transmit Statistics................................................................... 9-3

Summary Receive Statistics..................................................................... 9-4

Summary Error Statistics ........................................................................ 9-5

CHAPTER 10:

CHAPTER 10:CHAPTER 10:

CHAPTER 10: Troubleshooting

TroubleshootingTroubleshooting

Troubleshooting ................................

................................................................

...............................................

..............................

...............10

1010

10-

---1

Using a Third-Party Load Generator ............................................................10-1

Web-Based User Interface Start-Up Error ....................................................10-1

Web-Based User Interface Login Error.........................................................10-2

Hardware Installation/LEDs........................................................................10-2

EmulationEngine Busy or Not Responding....................................................10-3

Loading Files from the Command PC...........................................................10-4

Missing Key File........................................................................................10-4

Configuration Records...............................................................................10-6

APPENDIX A:

APPENDIX A:APPENDIX A:

APPENDIX A: Specifications

SpecificationsSpecifications

Specifications................................

................................................................

...........................................................

......................................................

...........................A

A-

---1

Hardware ................................................................................................. A-1

Software .................................................................................................. A-2

Performance ............................................................................................. A-3

EmulationEngine 11a/b/g User's Guide

080104 ix

APPENDIX B:

APPENDIX B:APPENDIX B:

APPENDIX B: Software Upgrades

Software UpgradesSoftware Upgrades

Software Upgrades................................

................................................................

.................................................

..................................

.................B

B-

---1

APPENDIX C:

APPENDIX C:APPENDIX C:

APPENDIX C: C

Cable Pin Assignments

able Pin Assignmentsable Pin Assignments

able Pin Assignments................................

................................................................

..........................................

....................

..........C

C-

---1

Standard Ethernet Cable ............................................................................ C-1

Ethernet Cross-Over Cable ......................................................................... C-1

RJ-45 Connector........................................................................................ C-1

Serial Cable .............................................................................................. C-1

APPENDIX D:

APPENDIX D:APPENDIX D:

APPENDIX D: Error and Status Messages

Error and Status MessagesError and Status Messages

Error and Status Messages................................

................................................................

...................................

......

... D

D-

---1

EmulationEngine or Virtual Station Control Messages .....................................D-1

MAC Layer Management Messages...............................................................D-1

Standard 802.11 WLAN Reason Codes .........................................................D-2

Standard 802.11 WLAN Status Codes...........................................................D-2

Communication Machinery Corporation (CMC)

x 080104

Table of contents

Popular Wireless Access Point manuals by other brands

TRENDnet

TRENDnet TPL-410AP user guide

EnGenius

EnGenius EWS377-FIT quick start guide

D-Link

D-Link DWL-6700AP Quick installation guide

Aerohive Networks

Aerohive Networks Aerohive AP121 Hardware reference guide

Vonets

Vonets VAP11G Step-by-step guide

Ubiquiti

Ubiquiti UniFi AP AC Outdoor quick start guide

Monoprice

Monoprice MW301A user guide

D-Link

D-Link DWL-2700AP - AirPremier Outdoor Wireless Access... user manual

D-Link

D-Link DWL-2100AP - AirPlus Xtreme G Quick installation guide

TP-Link

TP-Link Auranet EAP225 Quick installation guide

D-Link

D-Link DWL-2100AP - AirPlus Xtreme G Quick installation guide

Ubiquiti

Ubiquiti NanoStation NSM2 quick start guide

Aruba

Aruba IAP-335 user guide

Advantek Networks

Advantek Networks AWN-AP-54MR user manual

IP-COM

IP-COM AP355 user guide

Buffalo

Buffalo AirStation WLA-L11G user manual

EnGenius

EnGenius EnStationACv2 user manual

D-Link

D-Link DAP-3662 Quick installation guide

Communication Machinery Corporation EmulationEngine 11a/b/g User manual

Popular Wireless Access Point manuals by other brands