Network Analyzer for Windows
Mobile

Table of Contents

Introduction

System
Requirements

Installation

Usage

Advanced

FAQ

Known
Issues

Introduction

Network Analyzer for Windows
Mobile runs ping,
ipconfig, netstat and other network utilities on PocketPC and Smartphone devices
and displays the results in a UI. This harness is extensible and more
user-defined tests (DLLs) can be added to the list of tests to be executed. The
list of tests to be executed can also be controlled through an xml input file.
You can also capture network traffic (.cap files can be viewed with Network
Monitor or Ethereal).

This webpage includes basic installation and usage
instructions. There is also a section for advanced functionality and an FAQ
section (work in progress).

Back
to Top

System Requirements

Supported Operating
Systems:

• Microsoft® Windows Mobile®
5.0

Back
to Top

Installation

Copy the installer file ( *.msi )
to the PC

Open the installer file and run
the installer

Accept the license agreement and
continue to install the package

Upon finish, you'll be ask to
check the mobile device to complete the process, click OK

Note: On the mobile device, you
may be optionally asked where the application should be installed if you have
a storage card. DO NOT install the application to the storage card.
Always install directly to the device.

After the application is installed
successfully, you might be asked to restart the device. After reboot the
application is ready

Back to Top

Usage

After installation is complete, you
can start Network Analyzer by selecting the icon from the start menu. Select Quit to exit
the application.

Back
to Top

Advanced

Excluding tests to execute from
Network Analyzer
The list of tests to run is read from the xml file at
\Program Files\Network
Analyzer\analyzer.xml. If you
want to exclude any test from the list of tests to execute, simply delete that
entry from the xml file.

Writing custom Test Dlls to run
as part of Network Analyzer
You can write your own tests to run as part
of the Network Analyzer as well. The test should be a dll and should export
the function 'RunAnalyzerTest'. Then just add an entry in the xml file (see
above) and you should be good to go!

Capturing Network Traffic (
NetMon ) Logs
You can capture the network traffic log for post mortem
analysis. To start the logging run the start up script 'start analyzer' located under the 'Program' folder. Run the script
'stop analyzer' to stop. The log will be placed
under

\NetworkLogs ( or \Storage
Card\NetworkLogs if you have one )

Back
to Top

FAQ

During installation I got a
dialog box saying 'this is from an untrusted publisher...' - what do I
do?
You should select yes to that dialog box, otherwise the
installation will fail. Note that some functionality (capturing network
traffic) is disabled if the cab was from an unsigned
publisher.

Can I install it on the Storage
Card instead of on the device itself?
Unfortunately, installation on the Storage card is
not supported for this version. You should install this tool on the 'Device'.
You might be able to configure the paths appropriately though and get it
working. For more details and advanced troubleshooting, please review the FAQ
below.

There is no '\Program Files' on
my device! Where was Network Analyzer installed!?
Network Analyzer
should be installed to \Program
Files\Network Analyzer by
default. Note that \Program
Files might be
under \Storage\Program
Files on your device. You might
need to update your lnk files under Programs menu. You can copy the .lnk
file(s) from \Windows\Start
Menu\Programs to your desktop
over Active Sync, open the files in Notepad and edit/save them. Once you are
done, you can move them back to the same location on the device where you
copied them from. The three files you need to modify are: 1) Network
Analyzer.lnk, 2) start analyzer.lnk, 3) stop analyzer.lnk.

You should
modify the following line in analyzer.xml appropriately as well. Note that
analyzer.xml is located at \Program Files\Network Analyzer.

<ApplicationSetting Name="GUIPath" Type="String">\Program
Files\Network Analyzer\AnalyzerGUI.exe</ApplicationSetting>

How do I remove Network
Analyzer from my device?
You can remove the program from your device at
any time by System->Remove Programs. Note the actual link for Remove
programs might be different on your device, depending on the version of the OS
and the type of device.

Where do the logs
go?
You can view the logs via Menu->Show Log. If you have a storage
card inserted, Network Analyzer will write all logs under \Storage
Card\NetworkLogs. If there is no \Storage Card, it will write all logs under
\NetworkLogs. When you run Start Analyzer.exe it
will display the location of the logs.

Can this tool capture NetMon
captures?
Yes. You can run start analyzer.exe from
the Programs menu to start the capture. At this time you can continue the
scenario you are interested in capturing. When you are done, you can run
stop analyzer.exe from the Programs menu. Logs will be
created and the location of these logs will be displayed as well.

Back
to Top

Known Issues

Back
to Top

Last Updated: 09/07/06.