USER GUIDE

e-Tester User Guide

Version 5.1
Empirix, Inc.
Copyright
Copyright Notice

Copyright 1997-2001 Empirix Inc. All rights reserved. The contents

of this document and the associated e-TEST suite software are the
property of Empirix Inc. and are copyrighted. No part of this document
may be copied or distributed, transmitted, transcribed, stored in a
retrieval system, or translated into any human or computer language, in
any form, or by any means, electronic, mechanical, magnetic, manual, or
otherwise, or disclosed to third parties without the express written
permission of Empirix Inc.
Printed in the United States of America

Trademarks
Data Bank Wizard, e-Manager, e-Reporter, e-Spider, e-TEST, e-Tester,
d-Tracker, ServerStats, TrueLoad, and Visual Scripts, are all trademarks or
service marks and e-Load and e-Monitor, are registered trademarks of
Empirix Inc in the United Stats and other countries. Microsoft is a
registered trademark and Windows, Visual C++, Visual J++, and Visual
Basic are trademarks of Microsoft Corporation. Java is a trademark of
Sun Microsystems. Pentium is a registered trademark of the Intel

Corporation. All other names are used for identification purposes only
and may be trademarks of their respective owners.

Empirix Inc.

1430 Main St.

Waltham, MA 02451
Ph: 781-993-8500
Fax: 781-993-8600
Web: http://www.empirix.com
Email: webtest@empirix.com
USA, Japan, Singapore, UK/Europe

To contact a local Empirix office, visit our Web site at www.empirix.com

Contents

Contents
Preface
About This Guide ............................................................................................v
Related Documentation...................................................................................vi
e-TEST Suite Printed Manuals ..............................................................vi
Other Printed Manuals ..........................................................................vii
Electronic Documentation......................................................................vii
Using Help ...................................................................................................viii
Conventions.....................................................................................................ix
Obtaining Technical Support .........................................................................ix
Chapter 1

Introduction
Recording WAP Applications .........................................................................2
Playing Back Visual Scripts for Wireless Applications ...................................2

Contents

iii

Contents

Chapter 2

Using the Openwave Browser

Installing the Openwave Browser ....................................................................3
Installing from the CDROM...................................................................3
Downloading and Installing .....................................................................3
Setting the Home URL...................................................................................4
Selecting the WAP Browser Emulation ..........................................................6
Recording Using the Openwave Browser .......................................................7
Viewing Page Source and Properties......................................................10

Chapter 3

Using the Nokia Browser

Installing the Openwave Browser ....................................................................3
Downloading and Installing .....................................................................3
Selecting the WAP Browser Emulation ..........................................................4
Recording Using the Nokia Browser ..............................................................5
Viewing Page Source and Properties........................................................7

iv

e-Tester for WAP User Guide

Preface
Welcome to the e-Tester for WAP User Guide. This guide explains how
to use the features and options of e-Tester for testing Wireless
applications.
This guide is intended for Web test engineers who will be developing
e-Tester Visual Scripts for regression and performance (load and
scalability) testing of a Wireless Application Protocol (WAP) Web site or
application. This guide is a supplement to the e-Tester User Guide, which
you should refer to for detailed information about using e-Tester features.

About This Guide

This guide contains the following chapters:
Chapter 1 Introduction: provides an overview of the major features of

e-Tester for WAP.

Chapter 2 Using the Openwave Browser: explains how to install and

setup the WAP application browsers from Openwave.com.

Chapter 2 Using the Nokia Browser: explains how to install and setup

the WAP application browsers from Nokia.

Preface

Related Documentation
The e-TEST suite includes a complete set of printed manuals, electronic
manuals, and online help.

e-TEST Suite Printed Manuals

The e-TEST suite includes the following printed manuals:
Getting Started with e-TEST suite introduces the software tools in the
e-TEST suite and provides step-by-step tutorials for e-Tester, e-Manager,
e-Monitor, and e-Load (which includes ServerStats and e-Reporter).
e-Tester User Guide explains how to use the features and options of
e-Tester to create Visual Scripts for regression/performance testing and
monitoring of Web sites or applications. This guide also includes
reference information for using the e-Tester Programming Interface for
expanding Visual Script capabilities using Visual Basic for Applications
(VBA).
e-Tester for WAP User Guide explains how to use the Wireless
Application Protocol recording features of e-Tester. This manual is a
supplement to the e-Tester User Guide and is included only if you have
the WAP enabled version of e-Tester.
e-Manager User Guide explains how to use the features and options of
e-Manager to schedule and play back multiple Visual Scripts for
regression testing of Web sites or applications. e-Manager uses the Visual
Scripts developed by e-Tester.
e-Monitor User Guide explains how to use the features and options of
e-Monitor to perform periodic or continuous monitoring of Web sites
and related servers. e-Monitor uses the Visual Scripts developed by
e-Tester.
e-Load User Guide explains how to use the features and options of
e-Load to simulate multiple users accessing a Web site or application for
performance testing. e-Load uses the Visual Scripts developed by
e-Tester.

vi

e-Tester for WAP User Guide

Preface

ServerStats User Guide explains how to use the features and options of
ServerStats to monitor operational performance of a variety of application
servers, Web servers, database servers and systems.
e-Reporter User Guide explains how to use the features and options of
e-Reporter and WebReporter to generate graphs and reports for e-Load,
e-Monitor, and ServerStats performance data.

Other Printed Manuals

In addition to the e-TEST suite documentation set, the following printed
manuals are available with the d-Tracker product:
d-Tracker User Guide explains how to use the features and options of
d-Tracker for issue/defect tracking and management.
d-Tracker Administrator Guide explains how to use the administrative
features and options of d-Tracker for customizing the terminology and
appearance of d-Tracker for your organizations requirements.

Electronic Documentation
The e-TEST suite download from our Web site automatically installs an
Adobe Portable Document Format (PDF) version of the Getting Started
with e-TEST suite manual and an e-Spider Tutorial. These documents
require the Adobe Acrobat Reader, version 4.x, to open and view the
.PDF files. You can download the free Acrobat Reader from the Adobe
Web site: http://www.adobe.com/products/acrobat/readstep2.html.
The Getting Started with e-TEST suite PDF file is an option on the
e-TEST suite Start menu. The e-Spider Tutorial PDF file is copied to the
e-TEST suite installation directory (C:\Empirix\eTEST is the default).
The installation also includes a readme.doc file that contains release notes
and the latest updates to the product documentation. The readme.doc file
opens in Microsoft Wordpad when you select the Release Notes option
on the e-TEST suite Start menu. Also included is an e-Monitor v5.0 to
v5.1 conversion documentation (Wm50-51Conv.pdf) file that explains how
to migrate existing 5.0 Shell Scripts to 5.1 jobs and schedules.
The full e-TEST suite documentation set is provided on the product CDROM in Adobe Portable Document Format (PDF). You can use the
Preface

vii

Preface

Acrobat Reader, version 4.x, to view, search, and print the documentation
set. The e-TEST suite CD-ROM includes the Acrobat Reader application.
You can install Acrobat Reader using the e-TEST suite CD-ROM setup
program or by selecting ar40eng.exe in the Acrobat Reader directory. See
the Adobe Web site, http://www.adobe.com, for additional information
about Acrobat Reader.
The full documentation set includes the following files:
E e-Test Suite Getting Started.pdf
E e-Tester User Guide.pdf
E e-Tester for WAP User Guide.pdf
E e-Manager User Guide.pdf
E e-Monitor User Guide.pdf
E e-Load User Guide.pdf

E WebReporter User Guide.pdf

E e-Spider Tutorial.pdf
E d-Tracker User Guide.pdf
E d-Tracker Administrator Guide.pdf
E readme.doc
E Wm50-51Conv.pdf

All of the .PDF files are in the Documentation directory of the product
CD-ROM. The e-Test Suite Getting Started.pdf, e-Spider Tutorial.pdf,
WM50-51Conv.pdf, and readme.doc files are installed during the e-TEST
suite setup procedure. You can copy the user guide .PDF files to a local
drive or open them in Acrobat Reader from the CD-ROM.
If you downloaded the product from the our Web site and wish to receive
electronic versions of the User Guides in .PDF format, please send an
email message to webtest_support@empirix.com. Youll need the Acrobat
Reader v4 to open and view the documents.
The e-TEST suite CD-ROM also includes the Microsoft Visual Basic
Scripting Edition (VBScript) Language Reference documentation. You
can install the files using the e-TEST suite CD-ROM setup program or by
selecting vbsdoc.exe in the MS VB Script Documentation directory.

Using Help
e-Tester provides a comprehensive on-line help system. The help topics
include step-by-step how to instructions for common tasks and a
complete reference.
You can press the F1 key at any open dialog box for an explanation of the
options. You can select Help Contents to open the on-line help contents
and index.

viii

e-Tester for WAP User Guide

Preface

Conventions
This guide uses the following typographical conventions to identify
specific items:
Convention

Description

Bold Sans Serif

Menu options and dialog box

selections.

Sans Serif Underlined

Web page hyperlinks.

Sans Serif

File names and Visual Script

nodes.

Fixed-Pitch type

Program code.

Arrow between menu options.

Select each option in sequence.

Obtaining Technical Support

If you have questions about e-TEST suite, first look in this guide, the
online Help, and the release notes delivered with the software.
You can also check our Web site for the latest information about upgrades
and other issues at http://www.empirix.com.
If you wish to contact Empirix Web Test + Monitoring Support, please
use the following contact numbers and email addresses:
Tel.

North America: (781) 993-8562 (8 a.m. to 8 p.m. EST)

Europe: +44(0) 1344 725801 (8:30 - 18:00 GMT)
Japan: (03) 3791-2336

Fax.

North America: (781) 993-8600

Email

North America: webtest_support@empirix.com

Europe: europe_webtest_support@empirix.com

Key Requests: To request a software license key, please call (781) 9938500 or send your request via email to keys@empirix.com.
Preface

ix

Preface

[This page intentionally left blank]

e-Tester for WAP User Guide

Chapter 1

Introduction
e-Tester can record and play back applications designed for wireless
devices using the Wireless Application Protocol (WAP). e-Tester
monitors HTTP socket activity to record the XML-based Wireless
Markup Language (WML) used to create the cards and decks of a
wireless application.
e-Tester records the WML cards and decks as nodes in the Visual Script.
Once a Visual Script is recorded for a WML wireless application, the
Visual Script can be played back against the application in e-Tester,
e-Load, and e-Monitor.
Recording WML wireless applications in e-Tester differs somewhat from
recording HTML applications. e-Tester provides an option for opening a
WAP application browser before recording the application. After you start
recording, you navigate the WML wireless application using the WAP
application browser. e-Tester records actions in the WAP application
browser to a Visual Script in the e-Tester window.
This document explains how to set up the WAP application browser and
use e-Tester to record and play back Visual Scripts against WML wireless
applications.

Introduction

Recording WAP Applications

The procedure for recording WAP applications depends upon which
WAP browser emulator you are using. e-Tester supports the following
WAP browser emulators:
E Phone.com 4.0
E Openwave 4.1
E Nokia 2.0 or Nokia 2.1

The following chapters of this guide explain the procedures for installing
the browser emulator, specifying the browser emulator in e-Tester, and
how to recording WAP applications with the specific browsers.
The Openwave 4.1 browser emulator is an updated version of the
Phone.com 4.0 browser emulator. The procedure for recording WAP
applications with either the Phone.com or Openwave emulator is the same
and is explained in Chapter 2.
The Nokia 2.1 browser emulator is and updated version of the Nokia 2.0
browser emulator. Nokia 2.1 requires version 1.3 of the Java Runtime
Environment. Nokia 2.0 requires version 1.2 of the Java Runtime
Environment. The procedure for recording WAP applications is the same
and is explained in Chapter 3.

Playing Back Visual Scripts for Wireless

Applications
Once you have recorded a WAP application to a Visual Script, you can
play back the Visual Script using e-Tester, e-Load, and e-Monitor. No
special steps are required.

e-Tester for WAP User Guide

Chapter 2

Using the Openwave Browser

e-Tester can use the Phone.com 4.0 or Openwave 4.1 WAP application
browsers available from Openwave.com. Before you can record WAP
applications using e-Tester, the WAP browser you plan to use must be
installed on the system. The following sections explain how to install and
use the Openwave browser.

Installing the Openwave Browser

The e-TEST suite CDROM includes the setup files for the Openwave
UP.Simulator browser. You can install the UP.Simulator browser from
the CDROM or download the setup files from Openwave.com. The
following sections explain the procedures:

Installing from the CDROM

To install the UP.Simulator browser from the e-TEST suite CDROM:
1.

Copy the Openwave.com UP.SDK package from the openwave

directory on the CDROM to a temporary directory on a local drive.

2.

Run upsdkw41e.exe to start the setup program.

Downloading and Installing

To download and install the UP.Simulator browser:
3.

Download the UP.SDK package from:

http://www.openwave.com/

4.

Save the file to a temporary directory on a local drive.

5.

Run the setup program to install the SDK.

3

Setting the Home URL

Setting the Home URL

Before using the UP.Simulator browser with e-Tester, you should set the
default home URL setting. The default home URL is the location of the
WML application that will be automatically started when you open the
WAP application browser.
To set the home URL:
1.

Select Start Programs UP.SDK 4.1

4.1 UP.Simulator. The
UP.Simulator browser window opens and connects to the default link
location.

e-Tester for WAP User Guide

Setting the Home URL

2.

Select Settings UP.Link Settings.

3.

Verify that HTTP Direct is selected.

4.

Change the Home URL setting to the location of the .wml file of your
WML wireless application.

5.

Click OK.

6.

Select File Exit to close the UP.Simulator browser. When you test
your WAP application, you will use the features of e-Tester to relaunch the UP.Simulator browser.

Chapter 2: Using the Openwave Browser

Selecting the WAP Browser Emulation

Selecting the WAP Browser Emulation

e-Tester uses an HTTP spy to monitor and record socket activity between
a Wireless Application Protocol (WAP) browser and a Web Server. You
must have the appropriate Empirix WAP license before e-Tester enables
WAP features.
To select the WAP application browser emulation:

1.

Select Start Programs ee-TEST suite ee-Tester.

2.

Select Options WAP Options.

3.

Select the Openwave browser.

4.

Click OK.

e-Tester for WAP User Guide

Recording Using the Openwave Browser

Recording Using the Openwave Browser

Once you have installed the WAP browser and selected the e-Tester
WAP option, you can record actions in the WAP browser to a Visual
Script.
1.

Start e-Tester

2.

Select File New Script.

3.

Select Tools WAP Script Recorder or click the toolbar button.

e-Tester automatically opens the WAP browser emulator.

4.

Press F12 or select Edit Clear Cache in the WAP application

browser to clear the browser cache. The browser loads the home URL
specified in UP Link settings.

5.

Click the e-Tester Record toolbar button.

Chapter 2: Using the Openwave Browser

Recording Using the Openwave Browser

6.

Navigate the WML application using the WAP application browser.

The following illustration shows the basic features and controls of the
Openwave browser.
URL or
File Location

Browser Pane
Selected Item

Left Select

Right Select

Scroll Selector
Browser Home

Browser Back

See the Using the UP.Browser (PDF) in the UP.SDK

documentation for additional information about the phone browser
features and options.

e-Tester for WAP User Guide

Recording Using the Openwave Browser

As you navigate the WML application, e-Tester records your actions

to a Visual Script in the e-Tester window. The e-Tester browser pane
shows the XML structure of the WML decks as they are recorded.
XML/WML Source
Hierarchy

The XML structure of the WML deck is stored in a temporary

temp.xml file in the C:\Empirix\eTEST\Temp directory. The e-Tester
browser pane shows the structure of the last recorded deck.
You can click the plus (+) and minus (-) nodes to expand and
collapse the XML nodes.

Chapter 2: Using the Openwave Browser

Recording Using the Openwave Browser

The pages in the Visual Script include an xmls node with subnodes
that show the WML card structure of the deck.

WML Page Structure

in Visual Script

e-Tester records a new page to the Visual Script when the WAP
application navigates to a new deck.
7.

Save the Visual Script.

Viewing Page Source and Properties

You can view the deck source using the HTML node in the Visual
Script. Select the HTML node of a Visual Script page, click the right
mouse button, and select Properties.
You can view the attributes and values of cards and other nodes of a
WML deck in the Visual Script. Select the node, click the right
mouse button and select Properties.
You can view the WML application deck in the e-Tester browser
pane. Double-click the HTML node. However, navigation of the
WML application is not supported in the e-Tester browser.

10

e-Tester for WAP User Guide

Chapter 3

Using the Nokia Browser

e-Tester can use WAP application browsers available from Nokia. Before
you can record WAP applications using e-Tester, the WAP browser you
plan to use must be installed on the system. The following sections explain
how to install and use the Nokia browser.

Installing the Nokia Browser

The Nokia browser emulator is included with the Nokia WAP Toolkit.
You need to download the toolkit from the Nokia Web site and install it
on the e-Tester workstation before e-Tester can record using the Nokia
browser emulator.
Note: Nokia Toolkit 2.1 requires version 1.3 of the Java Runtime

Environment. Nokia Toolkit 2.0 requires version 1.2 of the Java Runtime
Environment.

Downloading and Installing

To download and install the Nokia WAP Toolkit:
1.

Download the Nokia WAP Toolkit package from:

http://forum.nokia.com/

2.

Save the file to a temporary directory on a local drive.

3.

Run the setup program to install the toolkit.

11

Selecting the WAP Browser Emulation

Selecting the WAP Browser Emulation

e-Tester uses an HTTP spy to monitor and record socket activity between
a Wireless Application Protocol (WAP) browser and a Web Server. You
must have the appropriate Empirix WAP license before e-Tester enables
WAP features.
To select the WAP application browser emulation:

12

1.

Select Start Programs ee-TEST suite ee-Tester.

2.

Select Options WAP Options.

3.

Select the Nokia 2.0 or 2.1browser.

4.

Click OK.

e-Tester for WAP User Guide

Recording Using the Nokia Browser

Recording Using the Nokia Browser

Once you have installed the WAP browser and selected the e-Tester
WAP option, you can record actions in the WAP browser to a Visual
Script.
1.

Start e-Tester

2.

Select File New Script.

3.

Select Tools WAP Script Recorder or click the toolbar button.

4.

Enter the URL where you wan to start recording in the Location field
of the Nokia WAP Toolkit window and press Enter.

Enter WAP URL

5.

Click the e-Tester Record toolbar button.

Chapter 3: Using the Nokia Browser

13

Recording Using the Nokia Browser

6.

Navigate the WML application using the WAP application browser.

See the User Guide in the Nokia documentation for additional
information about the phone browser features and options.
As you navigate the WML application, e-Tester records your actions
to a Visual Script in the e-Tester window. The e-Tester browser pane
shows the XML structure of the WML decks as they are recorded.

XML/WML Source
Hierarchy

The XML structure of the WML deck is stored in a temporary

temp.xml file in the C:\RSW\Temp directory. The e-Tester browser
pane shows the structure of the last recorded deck.
You can click the plus (+) and minus (-) nodes to expand and
collapse the XML nodes.

14

e-Tester for WAP User Guide

Recording Using the Nokia Browser

The pages in the Visual Script include an xmls node with subnodes
that show the WML card structure of the deck.

WML Page Structure

in Visual Script

e-Tester records a new page to the Visual Script when the WAP
application navigates to a new deck.
7.

Save the Visual Script.

Viewing Page Source and Properties

You can view the deck source using the HTML node in the Visual
Script. Select the HTML node of a Visual Script page, click the right
mouse button, and select Properties.
You can view the attributes and values of cards and other nodes of a
WML deck in the Visual Script. Select the node, click the right
mouse button and select Properties.
You can view the WML application deck in the e-Tester browser
pane. Double-click the HTML node. However, navigation of the
WML application is not supported in the e-Tester browser.

Chapter 3: Using the Nokia Browser

15

Recording Using the Nokia Browser

[This page intentionally left blank]

16

e-Tester for WAP User Guide