Performance Endpoints

Windows XP (64-bit)
November 2003
THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT ARE FURNISHED UNDER AND ARE SUBJECT TO THE TERMS OF A
LICENSE AGREEMENT OR A NON-DISCLOSURE AGREEMENT. EXCEPT AS EXPRESSLY SET FORTH IN SUCH LICENSE AGREEMENT OR NON-
DISCLOSURE AGREEMENT, NETIQ CORPORATION PROVIDES THIS DOCUMENT AND THE SOFTWARE DESCRIBED IN THIS DOCUMENT “AS
IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. SOME STATES DO NOT ALLOW DISCLAIMERS OF EXPRESS OR IMPLIED
WARRANTIES IN CERTAIN TRANSACTIONS; THEREFORE, THIS STATEMENT MAY NOT APPLY TO YOU.

This document and the software described in this document may not be lent, sold, or given away without the prior
written permission of NetIQ Corporation, except as otherwise permitted by law. Except as expressly set forth in such
license agreement or non-disclosure agreement, no part of this document or the software described in this document
may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, or
otherwise, without the prior written consent of NetIQ Corporation. Some companies, names, and data in this document
are used for illustration purposes and may not represent real companies, individuals, or data.

This document could include technical inaccuracies or typographical errors. Changes are periodically made to the
information herein. These changes may be incorporated in new editions of this document. NetIQ Corporation may
make improvements in or changes to the software described in this document at any time.

© 1995-2003 NetIQ Corporation, all rights reserved.

U.S. Government Restricted Rights: If the software and documentation are being acquired by or on behalf of the U.S.
Government or by a U.S. Government prime contractor or subcontractor (at any tier), in accordance with 48 C.F.R.
227.7202-4 (for Department of Defense (DOD) acquisitions) and 48 C.F.R. 2.101 and 12.212 (for non-DOD
acquisitions), the government’s rights in the software and documentation, including its rights to use, modify,
reproduce, release, perform, display or disclose the software or documentation, will be subject in all respects to the
commercial license rights and restrictions provided in the license agreement.

ActiveAgent, ActiveAnalytics, ActiveAudit, ActiveKnowledge, ActiveReporting, ADcheck, AppAnalyzer, Application

Scanner, AppManager, AuditTrack, AutoSync, Chariot, ClusterTrends, CommerceTrends, Configuration Assessor,
ConfigurationManager, the cube logo design, DBTrends, DiagnosticManager, Directory and Resource Administrator,
Directory Security Administrator, Domain Migration Administrator, End2End, Exchange Administrator, Exchange
Migrator, Extended Management Pack, FastTrends, File Security Administrator, Firewall Appliance Analyzer, Firewall
Reporting Center, Firewall Suite, Ganymede, the Ganymede logo, Ganymede Software, Group Policy Administrator,
Intergreat, Knowledge Scripts, Migrate.Monitor.Manage, Mission Critical Software, Mission Critical Software for E-
Business, the Mission Critical Software logo, MP3check, NetIQ, the NetIQ logo, the NetIQ Partner Network design,
NetWare Migrator, OnePoint, the OnePoint logo, Operations Manager, PentaSafe, PSAudit, PSDetect,
PSPasswordManager, PSSecure, Qcheck, RecoveryManager, Security Analyzer, Security Manager, Server Consolidator,
SQLcheck, VigilEnt, Visitor Mean Business, Vivinet, W logo, WebTrends, WebTrends Analysis Suite, WebTrends for
Content Management Systems, WebTrends Intelligence Suite, WebTrends Live, WebTrends Log Analyzer, WebTrends
Network, WebTrends OLAP Manager, WebTrends Report Designer, WebTrends Reporting Center, WebTrends
Warehouse, Work Smarter, WWWorld, and XMP are trademarks or registered trademarks of NetIQ Corporation or its
subsidiaries in the United States and other jurisdictions. All other company and product names mentioned are used
only for identification purposes and may be trademarks or registered trademarks of their respective companies.
Contents
About This Book and the Library.......................................................................................v

Chapter 1
Microsoft Windows XP (64-bit) 1
Installation Requirements for 64-bit Windows XP Endpoints ...........................................1
Endpoint Installation for Windows XP...............................................................................2
Unattended Installation for 64-bit Windows XP....................................................4
What We Do During Installation........................................................................................5
Removing the Endpoint Package (Uninstall) ........................................................6
Removing the Endpoint Manually .........................................................................6
Configuring 64-bit Windows XP Endpoints .......................................................................6
Windows XP Configuration for TCP/IP .................................................................7
Determining Your IP Network Address.................................................................7
Trying Out the TCP/IP Connection .......................................................................8
Sockets Port Number..............................................................................................8
Running 64-bit Windows XP Endpoints.............................................................................8
Starting a Windows XP Endpoint...........................................................................9
Stopping a Windows XP Endpoint ........................................................................9
Disable Your Screen Saver.....................................................................................9
Disabling Automatic Startup...................................................................................9
How to Tell If a Windows XP Endpoint Is Active .............................................. 10
The SetAddr Utility for 64-bit Windows .............................................................. 10
Logging and Messages ...................................................................................................... 11
Getting the Latest Fixes and Service Updates.................................................................. 12
Updates and Information for Windows XP ......................................................... 12

Chapter 2
Performance Endpoints 13
Endpoint Requirements and Capabilities ......................................................................... 13
Operating System and Protocol Stack Support ................................................... 13
Endpoint Capabilities ........................................................................................................ 17
Performance Endpoint Support for Chariot Functions ....................................... 18
Performance Endpoint Support for End2End Functions..................................... 20
Endpoint Computer Resource Guidelines ........................................................... 22
Endpoint Versions ................................................................................................ 24

Chapter 3
Endpoint Initialization File 25
ALLOW .................................................................................................................. 26
SECURITY_AUDITING ......................................................................................... 27
AUDIT_FILENAME................................................................................................ 27

Contents iii
 ENABLE_PROTOCOL ...........................................................................................28
SAFESTORE_DIRECTORY ....................................................................................28
UPDATE_SERVER .................................................................................................29
END2END_SERVER...............................................................................................29
Customizing endpoint.ini for Windows Endpoints..........................................................29
Configuring Endpoints for Large-Scale Customization........................................30
Using WinZip ........................................................................................................31

Chapter 4
Distributing Endpoints Using SMS 33
Installing Endpoints Using SMS ........................................................................................33
Uninstalling Endpoints Using SMS....................................................................................35

Index 37

iv Performance Endpoints
About This Book and the Library
This brief guide provides conceptual information about the free Performance
Endpoint software NetIQ Corporation provides in association with its Network
Performance Management products, and covers installation and configuration
for one specific endpoint platform. For information about installing and
configuring all the endpoint platforms, including HP-UX, IBM AIX, IBM MVS,
Linux, Microsoft Windows 95, Windows 98, Windows Me, Windows NT, and
Windows 2000, Windows XP, Windows Server 2003, Novell NetWare, Sun
Solaris, Compaq Tru64 UNIX, FreeBSD UNIX, IBM OS/2, Linux IA-64, Microsoft
Windows 3.1, SCO UnixWare, SGI IRIX, and Spirent TeraMetrics, is available in
the HTML-formatted Performance Endpoints Guide in your product’s Help
system, or you can download other individual endpoint guides in .PDF format
from the World Wide Web at http://www.netiq.com/support/pe/pe.asp.

Intended Audience
This book provides information about Performance Endpoint software for
users of NetIQ End2End, Chariot and Qcheck.

Other Information in the Library

The library provides the following information resources:
User Guides for Chariot and End2End
Provide general information about each product and guide you through
installation and use.
Messages and Application Scripts Guide
Describes the application scripts included with End2End and Chariot
and provides a detailed reference to the error messages for all NetIQ
Network Performance Management products.

NetIQ Products
NetIQ Corporation provides integrated products that simplify and unify
systems management, security, and network performance management in your
extended enterprise. These products also help organizations prepare for and
migrate to Windows 2000 and Windows .NET. NetIQ Corporation offers the
following solutions:

About This Book and the LIbrary v

 Performance and Availability Management
These products allow you to manage, analyze, and report on the
health, performance, and availability of your mission-critical Windows
and UNIX applications and servers. With these products, you can
pinpoint network problems and resolve them quickly and effectively.
Security Management and Administration
These products provide real-time Windows security event
consolidation, configuration management, host-based intrusion
detection, centralized assessment and incident management,
vulnerability assessment and prevention, firewall log analysis and
reporting, and Windows security administration. With these products,
you can also manage group policy, administration workflows, and
permissions on vital assets throughout your enterprise.
VoIP Management and Network Testing
These products enable you to evaluate your network for Voice over IP
(VoIP) traffic before deployment, as well as manage and troubleshoot
VoIP during and after deployment. With these products, you can also
test application or hardware performance and predict the impact of
network changes, such as adding users or new applications.
Web Analytics and Management
These products deliver important insight into every element of Web
site visitor activity, as well as improved Web site performance and
availability. These solutions enhance your e-business performance,
resulting in higher returns on infrastructure and marketing investments
and improved visitor-to-customer conversion rates.
Windows and Exchange Management
These products enable you to manage all Windows and Exchange
essentials, from ensuring optimal availability and performance to
seamless migration, secure administration, and in-depth analysis.

Contacting NetIQ Corporation

Please contact us with your questions and comments. We look forward to
hearing from you. For support around the world, please contact your local
partner. For a complete list of our partners, please see our Web site. If you
cannot contact your partner, contact our Technical Support team.

Telephone: 503-223-3023
Email: [email protected]
Support: [email protected]
Web Site: www.netiq.com

vi Performance Endpoints
Chapter 1
Microsoft Windows XP (64-bit)

The following topics explain the installation, configuration, and operation of

the Performance Endpoint software for 64-bit Microsoft Windows XP.
This endpoint is designed to run on the IA-64 architecture, which requires a
64-bit operating system.
The endpoint for Windows supports the 32-bit version of XP. Download and
install the Windows endpoint to run the endpoint on 32-bit Windows XP.

Installation Requirements for 64-bit Windows XP

Endpoints
Here’s what you need to run the endpoint program with 64-bit Microsoft
Windows XP:
• A computer capable of running 64-bit Windows XP well.
The computer should have a processor based on the IA-64 architecture,
such as the Intel Itanium.
• 1 GByte of random access memory (RAM).
The total RAM requirement depends on the RAM usage of the underlying
protocol stack and the number of concurrent connection pairs. For very
large tests involving hundreds of connections through a single endpoint,
additional memory may be required.
• A hard disk with at least 8 MBytes of space available.
• 64-bit Microsoft Windows XP

You also need compatible network protocol software:

for RTP, TCP, and UDP
TCP/IP software is provided as part of the network support with
Windows XP.
for IPX, SPX and APPC
Windows XP does not support IPX/SPX or APPC.

Chapter 1 • Microsoft Windows XP (64-bit) 1

 We recommend that you get up-to-date with the latest Windows service levels.
“Updates and Information for Windows XP” on page 12 discusses where to get
the latest software upgrades.

Endpoint Installation for Windows XP

We recommend configuring your networking software—and ensuring that it is
working correctly—before installing our software. See the Help for your
networking software, and see “Configuring 64-bit Windows XP Endpoints” on
page 6 for more assistance.
The endpoint for Windows XP is installed and runs as a service. Only a user
with Administrator authority is permitted to install services. To successfully
install the endpoint, you must be logged in with Administrator authority. If you
are installing the endpoint in an NTFS directory, the permissions of the
directory must also be set to allow the SYSTEM (the operating system) full
control access. Be sure to give the System “Full Control” permission on all files
in the NetIQ\Endpoint directory or the directory where you’ve installed the
endpoint, plus any relevant subdirectories, if any.
Following are directions for installing the endpoint from a CD-ROM and from
the World Wide Web:
To install the endpoint from a CD-ROM, do the following:
1. Put the CD-ROM in your CD-ROM drive.
2. Navigate to the directory WIN64 and enter the following:
[drive:]\Endpoint\Win64\gsendw64.exe

3. If you have a previous installation of the endpoint, you will be asked if

you want it removed. If you select “yes,” the previous installation is
removed, and the new installation continues. If you select “no,” the
installation program exits with no changes to your existing installation
because a new version cannot be added until the old version is removed.
The installation program adds the endpoint program as a service.
4. Select the directory where the endpoint will be installed. We recommend
installing it on a local hard disk of the computer you’re using. If you install
on a LAN drive, the additional network traffic may influence your
performance results. The default directory is \Program
Files\NetIQ\Endpoint, on your boot drive.

5. The next dialog box contains two checkboxes.

2 Performance Endpoints
 − Install prebuilt data files. We recommend you leave this box
checked. You can save a small amount of disk space by not installing
the files used for compression testing—but the defaults in many
application scripts specify these files. If these .cmp files are not installed,
many application scripts cannot be used in tests until they are
modified.
− Start the endpoint on installation. If you leave the box unchecked,
the endpoint starts when you restart the computer. No window is
shown while the endpoint is running, since it runs as a service.
A Windows XP service is controlled from the Services dialog box,
accessible by selecting Programs\Administrative Tools\Services from
the Start menu. If you want to restart a service without restarting Windows,
use the Services dialog box. Go to the Services dialog box, select NetIQ
Endpoint, and select a Startup type from the pulldown. Press Start to start
the endpoint.
You can also manually start the endpoint after installation. See “Starting a
Windows XP Endpoint” on page 9 for instructions.
The copying of files is now complete; you can remove the CD-ROM from its
drive.
To prevent the endpoint from running automatically on startup, see “Disabling
Automatic Startup” on page 9.
When you’ve completed installation, refer to “Configuring 64-bit Windows XP
Endpoints” on page 6 to make sure your endpoint is ready for testing and
monitoring.
To install an endpoint you’ve downloaded from the World Wide Web,
do the following:
1. Save the gsendw64.exe file to a local directory.
2. Use the Windows Explorer to navigate to the file and double-click to start
the installation.
3. The first screen after the Setup dialog lets you select the directory where
the endpoint will be installed. We recommend installing it on a local hard
disk of the computer you’re using. If you install on a LAN drive, the
additional network traffic may influence your performance results. The
default directory is \Program Files\NetIQ\Endpoint, on your boot drive.
4. If you have a previous installation of the endpoint, you will be asked if
you want it removed. If you select “yes,” the previous installation is
removed, and the new installation continues. If you select “no,” the install
program exits with no changes to your existing installation because a new
version cannot be added until the old version is removed.
The installation then adds the endpoint program as a service.
5. The next dialog box contains two checkboxes.

Chapter 1 • Microsoft Windows XP (64-bit) 3

 − Install prebuilt data files. We recommend you leave this box
checked. You can save a small amount of disk space by not installing
the files used for compression testing--but the defaults in many
application scripts specify these files. If these .cmp files are not installed,
many application scripts cannot be used in tests until they are
modified.
− Start the endpoint on installation. If you leave the box unchecked,
the endpoint starts when you restart the computer. No window is
shown while the endpoint is running, since it runs as a service.
A Windows XP service is controlled from the Services dialog, accessible by
selecting Programs\Administrative Tools\Services from the Start menu.
If you want to restart a service without restarting Windows, from the
Services dialog box, select NetIQ Endpoint, and select a Startup type from
the pulldown. Click Start to start the endpoint.
You can also manually start the endpoint after installation. See “Starting a
Windows XP Endpoint” on page 9 for instructions.
The copying of files is now complete.
To prevent the endpoint from running automatically on startup, see “Disabling
Automatic Startup” on page 9.
If you want to restore the setting later, you must do so manually.
When you’ve completed installation, refer to “Configuring 64-bit Windows XP
Endpoints” on page 6 to make sure your endpoint is ready for testing and
monitoring.

Unattended Installation for 64-bit Windows XP

Unattended installation (also called silent installation) is available. You install
an endpoint once, by hand, while the install facility saves your input in a
response file. You can then install that same endpoint silently on other
computers, that is, without providing input other than the answer file.
First, unzip the gsendw64.exe file from the CD-ROM. We recommend using
WinZip version 7.0 and higher. Refer to “Using WinZip” on page 31 for
instructions.
When installing, specify the “-r” option on SETUP to save your input. For
example, to install for the first time, enter:
[drive:]\SETUP -r

where “[drive:]” is the drive where the install package is located. This
produces the response file named setup.iss, which can then be used on
subsequent silent installations. The setup.iss answer file is created in your
Windows directory (which is usually c:\windows).
If you want to create a response file without actually installing an endpoint,
enter:
[drive:]\SETUP noinst -r

4 Performance Endpoints
 To perform a silent installation, specify the “-s” option on SETUP. Make sure
the answers documented in the answer file setup.iss are appropriate for the
silent installation. If the setup.iss file is not in the same directory as
setup.exe, then specify the path and filename with the “-f1” option. For
example, here’s how to install using the setup.iss file we placed in the
\Program Files\NetIQ\Endpoint directory on our n: LAN drive:

SETUP -s -f1n:\Program Files\NetIQ\Endpoint\setup.iss

Don’t mix the .iss files among different Windows operating systems because
their endpoint installations require slightly different input.
The results of the silent installation are recorded in a file named setup.log,
which is created in your Windows directory.
It’s common to use unattended install from a LAN drive. Be sure you’ve copied
all of the files for each type of endpoint into a single directory (rather than into
separate diskette images), and you’ve created your initial setup.iss file from
that directory.

What We Do During Installation

Here’s what happens during the installation steps. Let’s say you install the
endpoint into the directory \Program Files\NetIQ\Endpoint. A directory is
created with the following contents:
• the executable programs;
• the README file;
• the directory Cmpfiles. This directory contains files with the .CMP file
extension. These are files containing data of different types, such as typical
text or binary data. These files are used by the endpoint as data on SEND
commands. The different data types can be used to vary the data
compression performance of your network hardware and software.
• the file endpoint.ini
See “Endpoint Initialization File” on page 25 for information about tailoring
this file for individual endpoints.
• the directory Updates.

This directory contains files to support an endpoint upgrade function that

works with our End2End product. The directory contains a file called
update.iss. This file is used to determine the proper responses for the
installation dialog boxes in later silent installations. See “Customizing
endpoint.ini for Windows Endpoints” on page 29 and “UPDATE_SERVER”
on page 29 for more information.

Chapter 1 • Microsoft Windows XP (64-bit) 5

 The endpoint is installed as a service, which means there’s nothing visible
while it’s running. During installation, the endpoint is configured to
automatically start when the system reboots. Controlling the endpoint from the
Services dialog box is described in “Running 64-bit Windows XP Endpoints” on
page 8.
Should you have reason to install an older endpoint, you should delete any
safestore files, taking the following steps:
1. Stop the endpoint.
2. Delete the safestore files from the endpoint directory (or from the directory
specified by the SAFESTORE_DIRECTORY keyword in endpoint.ini).
Safestore files have an extension of .q*; you may delete them using the
command delete *.q*.
3. Uninstall the current endpoint.
4. Install the desired endpoint.

Removing the Endpoint Package (Uninstall)

To remove the endpoint package from your hard disk, follow these steps:
1. Click Start > Settings > Control Panel.
2. Click Add or Remove Programs. The Add or Remove Programs
Properties dialog box is shown.
3. Highlight NetIQ Endpoint and press Change/Remove. The uninstallation
program begins. After the program is completed, the endpoint should be
uninstalled.

Removing the Endpoint Manually

If the uninstallation program is unable to uninstall the endpoint, you will need
to manually uninstall it. For detailed instructions on manually removing the
endpoints, see the Performance Endpoints FAQ page in the Knowledge Base
on our Web site at www.netiq.com/support/pe/default.asp.

Configuring 64-bit Windows XP Endpoints

The endpoint program uses network application programming interfaces like
WinSock for all of its communications. The endpoint dynamically configures its
own programs, so you do not have to update the configuration files for your
communications software. However, your communications software must be
configured and running correctly. The following steps guide you through this
verification process.
1. Determine the network addresses of the computers to be used in tests.
2. Select a service quality.

6 Performance Endpoints
 3. Verify the network connections.
The following topics describe how to accomplish these steps for XP.

Windows XP Configuration for TCP/IP

The RTP, TCP, and UDP protocols use TCP/IP software for network
communications. TCP/IP offers two forms of network addresses: IP addresses
and domain names. An IP address is a 32-bit numeric address. It is represented
in dotted notation as a set of four numbers separated by periods, such as
199.72.46.202. An alternative, domain names are in a format that is easier to
recognize and remember, such as www.netiq.com. To use domain names, you
need either a Domain Name Server (DNS) set up in your network or an
/etc/hosts file on each computer.

Determining Your IP Network Address

To determine an XP computer’s local IP address, enter the following at a
command prompt:
IPCONFIG

If your TCP/IP stack is configured correctly, your output will look like the
following:
Windows IP Configuration

Ethernet adapter Local Area Connection:

Connection-specific DNS Suffix . :
IP Address. . . . . . . . . . . . : 10.41.2.19
Subnet Mask . . . . . . . . . . . : 255.255.0.0
Default Gateway . . . . . . . . . : 10.41.1.254

The local IP address is shown in the first row; here it’s 10.41.2.19.
You can also find your IP address using the graphical user interface. Select
Settings\Control Panel, then double-click on the Network Connections
icon. Select Local Area Connection and click Properties. In the Local Area
Connection Properties dialog box, double-click Internet Protocol (TCP/IP) in
the list. Your IP address and subnet mask are shown.
To determine a Windows XP computer’s local hostname, enter the following at
a command prompt:
HOSTNAME

The current hostname is shown in the first row.

From the graphical user interface, return to Internet Protocol (TCP/IP)
configuration. Press Advanced and then select the DNS tab to see or change
your DNS servers. If the DNS tab is empty, avoid using domain names as
network addresses; use numeric IP addresses instead.
The default location for the /etc/hosts file is the following:

Chapter 1 • Microsoft Windows XP (64-bit) 7

 d:\WINDOWS\SYSTEM32\DRIVERS\ETC\HOSTS

Trying Out the TCP/IP Connection

Ping is a simple utility program, included in all TCP/IP implementations. To
check the connection from one computer to another, enter the following at a
command prompt:
ping xx.xx.xx.xx

Replace the x’s with the IP address of the target computer. If Ping returns a
message that says “Reply from xx.xx.xx.xx ...,” the Ping worked. If it says
“Request timed out,” the Ping failed, and you have a configuration problem.
Make sure that you can run Ping successfully from the Chariot or Qcheck
Console or the End2End server to each computer serving as Endpoint 1, and
between each pair of endpoints involved in a test, before starting your testing
with TCP/IP.

Sockets Port Number

TCP/IP applications use their network address (as described above) to decide
which computer to connect to in a network. They use a Sockets port number
to decide which application program to connect to within a computer.
The TCP/IP sockets port for endpoints is 10115. This port number is used
during the initialization of a test; during the actual running of the test, other
port numbers are used. If the script specifies “port_number=AUTO” on the
CONNECT_ACCEPT command, additional ports are dynamically acquired from the
protocol stack. Otherwise, the endpoint issuing the CONNECT_ACCEPT commands
(usually Endpoint 2) uses the port number specified in the script.

Running 64-bit Windows XP Endpoints

The following topics describe starting and stopping an endpoint running on
the Windows XP operating system, as well as some of the messages and
information that become available during testing with this endpoint. The
Windows XP 64-bit endpoint is controlled from the Services dialog box, which
you access by selecting Programs\Administrative Tools\Services from the
Start menu. The Services dialog box lets you start or stop the endpoint, listed
as NetIQ Endpoint.
Only a user with Administrator authority is permitted to start or stop Windows
XP services.

8 Performance Endpoints
Starting a Windows XP Endpoint
By default, the endpoint program is configured to start automatically, which
means that you will not see a window for the program when it is running.
Because the endpoint runs as a service, you do not have to be logged into
your workstation for the endpoint to run.
If you stop the endpoint service, you can restart it without restarting Windows
XP. There are two ways to restart the endpoint service:
1. At a command prompt, enter:
net start netiqendpoint

2. In the Services dialog box, double-click NetIQ Endpoint and press Start.
The status changes to “started” when the endpoint is successfully started.
A single running copy of the endpoint service handles one or multiple
concurrent tests.

Stopping a Windows XP Endpoint

There are two ways to stop the endpoint service:
• At a command prompt, enter the following:
net stop netiqendpoint

• In the Services dialog box, double-click NetIQ Endpoint and click Stop.
The status is blank when the endpoint program has stopped.

Disable Your Screen Saver

Screen savers can significantly lower the throughput that’s measured by an
endpoint. We recommend disabling your screen saver at endpoint computers
while running tests.

Disabling Automatic Startup

To disable the automatic starting of the Windows XP (64-bit) endpoint, take
the following steps:
1. From the Windows Start menu, select Programs\Administrative
Tools\Services. The Services dialog is shown.
2. Double-click NetIQ Endpoint.
3. From the Startup type menu, select Manual.
4. Press OK to save the new setting and exit the dialog. The endpoint will no
longer start automatically when you restart the computer. However, you
can manually start the endpoint.

Chapter 1 • Microsoft Windows XP (64-bit) 9

How to Tell If a Windows XP Endpoint Is Active
The status field in the Services dialog box shows whether the NetIQ Endpoint
service has started.

The SetAddr Utility for 64-bit Windows

Endpoints for Windows operating systems now ship with a utility that helps
you quickly create virtual IP addresses on 64-bit Windows endpoint
computers. Virtual addresses are chiefly useful when you’re testing hundreds
or even thousands of endpoint pairs using only a few computers as endpoints.
To all intents and purposes, the traffic on the network is identical, whether
you’re using “real” or virtual addresses.
For more information about creating virtual addresses, consult “Configuring
Virtual Addresses on Endpoint Computers” in the User Guide for Chariot.
When you install a Windows endpoint, Setaddr.exe for 64-bit Windows is
automatically installed in the same directory. The usage is as follows:
setaddr [-dr] -a N -f Addr -t Addr -i Addr -s Addr
| -l[a]
| -da
| -ds -f Addr -s Addr

(where “N” indicates the adapter number of the NIC card you’re assigning
virtual addresses to, and “Addr” indicates the virtual addresses or subnet
mask you're assigning to it).
Options:
-l List all network adapters
-la List all network adapters and their IP addresses
-a Adapter to modify (number given by -l options)
-dr Delete a range of addresses
-da Delete all addresses
-ds Delete a single address
-f From address
-t To address
-i Increment by
-s Subnet Mask

The -d flags cannot be used to delete a computer’s primary IP address.

The -i flag lets you determine how the range of addresses will be created.
This is an optional field; by default, SetAddr increments the range by one in
the final byte only. This “increment by” value is represented as “0.0.0.1”.
Enter a value (0-255) for each byte of the 4-byte IP address. A value of 1
specifies that the address values in that byte will be incremented by one when
SetAddr creates the range. For example, enter
setaddr -f 10.40.1.1 -t 10.40.4.250 -i 0.0.1.1 -s 255.255.0.0

SetAddr creates 1,000 virtual addresses.

10 Performance Endpoints
 Known Limitations
• IPv4 only.
• A version of SetAddr is also available for Windows NT, Windows 2000, and
Windows XP 32-bit computers. This 64-bit Windows version of SetAddr
does not work on 32-bit systems.
• SetAddr only works on computers with fixed IP addresses. DHCP-enabled
adapters can’t be used.
• You must restart the computer to whose NIC you've assigned virtual IP
addresses before you begin testing with that computer. SetAddr modifies
some Windows Registry keys, and restarting is required for the changes to
take effect.
• The number of virtual addresses you can assign to a single adapter
depends on the protocol stack and the size of the Windows Registry. We
benchmarked measurements using computers running up to 2500 virtual
addresses, which is a recommended limit.
• No checking is done to ensure that thousands of addresses are not being
created. Be careful! More TCP/IP stack resources are required to manage
virtual addresses.
• You may only add Class A, B, and C virtual IP addresses. Loopback
addresses and Class D and E IP addresses are invalid. Valid address ranges,
then, are 1.x.x.x to 233.x.x.x, excluding 127.x.x.x.
• When more than 2250 virtual address are defined on Windows 2000
computers, all the LAN adaptor icons disappear from the “Network and
Dial-up Connections” dialog box in “My Network Places.” You can still
see the adaptors by invoking ipconfig or setaddr from the command line,
and the addresses are still reachable. Removing some virtual addresses so
that fewer than 2250 were specified and restarting the computer solved the
problem.

Logging and Messages

While most endpoint error messages are returned to the Chariot or Qcheck
Console or the End2End server, some may be logged to disk. Errors are saved
in a file named ENDPOINT.LOG, in the directory where you installed the
endpoint. To view an error log, use the command-line program named
FMTLOG.EXE. Program FMTLOG.EXE reads from a binary log file, and writes its
formatted output to stdout. Use the following FMTLOG command:
FMTLOG log_filename > output_file

This endpoint has extensive internal cross-checking to catch unexpected

conditions early. If an assertion failure occurs, the file assert.err is written to
the directory where you installed the endpoint.

Chapter 1 • Microsoft Windows XP (64-bit) 11

Getting the Latest Fixes and Service Updates
We’ve found that communications software is often fragile. Its developers are
constantly working to make it more robust, as the software gets used in an
ever-wider set of situations.
We therefore recommend working with the very latest software for the
underlying operating system and communications software. Following are the
best sources we’ve found for information and upgrades for 64-bit Windows XP.

Updates and Information for Windows XP

Microsoft posts links to technical information, code, and driver updates to the
following Web site: www.microsoft.com/windowsxp/64bit/default.asp. For
service packs and other downloads, go to
www.microsoft.com/downloads/search.asp
The following Web site provides information about Windows XP (64-bit):
www.microsoft.com/technet/treeview/default.asp?url=/TechNet/prodtechnol/w
inxppro/evaluate/xp64ovw.asp.

12 Performance Endpoints
Chapter 2
Performance Endpoints

This guide contains information about the Performance Endpoints, which are
available for more than 20 different operating systems.
All the information you need to install, configure, and run the endpoints in
your network is included here and in the printed version of the Performance
Endpoints guide. In addition to topics discussing issues common to all the
endpoints, these guides also contain information about each operating system,
organized in separate chapters.

Endpoint Requirements and Capabilities

The following topics describe the software and hardware requirements and the
supported functions of the Performance Endpoints, version 4.4.
The latest version of the endpoint software can always be downloaded free
from the Internet. A single installable file is available for each operating
system. Endpoints are available for downloading at
www.netiq.com/support/pe/pe.asp.
You cannot run endpoint software from a CD-ROM; you must install it on a
computer.

Operating System and Protocol Stack Support

The following tables list the software with which we have tested the
Performance Endpoints for each operating system.

Note
Versions listed are the earliest, not necessarily the only, versions supported.

Chapter 2 • Performance Endpoints 13

 Endpoint OS version TCP, IP IPX/SPX APPC stack
UDP, Multicast stack version
RTP version

Cobalt Linux v. 2.0 included kernel no no

RaQ/RaQ2 for MIPS 2.0.32
(MIPS)

Cobalt kernel included kernel no no

RaQ3 (x86) 2.0.32 2.0.32

Compaq Digital included v4.0B no no

Tru64 UNIX UNIX 4.0B
or Compaq
Tru64 Unix
for Alpha

FreeBSD BSD v3.1 included v3.1 no no

UNIX

HP-UX HP-UX included v10.10 no no

v10.10

IBM AIX AIX v4.1.4 included v4.1.4 no no

IBM MVS MVS/ESA See no no IBM

SP v4R2.2 “MVS ACF/VTAM
TCP/IP for MVS/ESA
Stacks” v3R4.2

IBM OS/2 OS/2 Warp Download Download Download IBM

4, Warp TCP 4.1 TCP 4.1 Novell CommServer
Connect 3 Netware for OS/2 v4.1
Client
v2.12

Linux (x86 kernel included kernel no no

and MIPS) 2.0.32 2.0.32

Linux IA-64 kernel included kernel no no

2.4.0test7- 2.4.0test7-
42 42

Microsoft Windows see Chameleon no no

Windows 3.1 or “Microsoft 7.0, as E2
3.1 Windows Windows
for 3.1
Workgroups TCP/IP
3.11 Stacks”

Microsoft Windows included no Download IBM PComm

Windows 95 Novell v4.3 for
95 Netware Windows 95
Client
v3.21

14 Performance Endpoints
Endpoint OS version TCP, IP IPX/SPX APPC stack
UDP, Multicast stack version
RTP version

Microsoft Windows Download included included IBM PComm

Windows 95 with WinSock v4.3 for
95 with WinSock 2 2 Windows 95
WinSock 2 installed

Microsoft Windows included included included IBM PComm

Windows 98 v4.3 for
98 Windows 98

Microsoft Windows included included included IBM PComm

Windows Me v4.3 for
Millennium Windows 98
Edition
(Me)

Microsoft Windows included SP3 included IBM PComm

Windows NT SP 4 (IGMPv1) v4.3, or IBM
NT 4 SP4 CommServer
(IGMPv2) v5.0 (for
Windows
NT), or
Microsoft
SNA Server
v4.0s for
Windows NT

Microsoft Windows included SP3 included Microsoft

Windows NT4 SP 3 (IGMPv1) SNA Server
NT 4 for SP4 for Alpha
Alpha (IGMPv2) v4.0 with
SP1 or v3.0
with SP2

Microsoft Windows included included included IBM PCOMM

Windows 2000 version 5.0,
2000 or IBM
CommServer
v6.0

Microsoft Windows included included included IBM PCOMM

Windows XP (32-bit) version 5.0,
XP or IBM
CommServer
v6.0

Microsoft Windows included included no no

Windows XP (64-bit)
XP (64-bit)

Novell v3.12 included v4.0 included no

NetWare

Chapter 2 • Performance Endpoints 15

 Endpoint OS version TCP, IP IPX/SPX APPC stack
UDP, Multicast stack version
RTP version

SCO UnixWare included v7.0 no no

UnixWare v2.1

SGI IRIX IRIX v6.2 included v6.2 no no

with
patches

Spirent kernel included kernel no no

Terametrics 2.2.11 2.2.11

Sun Solaris Solaris v2.4 included v2.4 no no

for SPARC

Sun Solaris Solaris v2.4 included v2.4 no no

for x86

Microsoft Windows 3.1 TCP/IP Stacks

The Microsoft Windows 3.1 Performance Endpoint software supports the
following TCP/IP stacks:
• Microsoft 32-bit stack, shipped on the Windows NT 4.0 Server CD-ROM
• Frontier Technologies SuperTCP v2.2
• FTP Software OnNet for Windows v2.1
• NetManage Chameleon NFS v4.6.3 (IP Multicast support requires version
7.0 or later)
• Novell Client 3.1 for DOS and Windows 3.x v2.71
• Novell Client for DOS/Win (VLMs) v1.21
• WRQ TCP Connection for Windows v5.1

Because Windows 3.x lacks thread support, you cannot use the Windows 3.1
endpoint as Endpoint 1 in an IP Multicast test.

MVS TCP/IP Stacks

The MVS Performance Endpoint software supports the following TCP/IP
stacks:
• TCP/IP versions 3.2 through 3.8, from IBM. Version 2.6 of OS/390 (TCP/IP
version 3.5) and higher includes support for IP Multicast testing with
Chariot.
• SOLVE:TCPaccess versions 4.1 and 5.2 stack from Sterling Software. A set of
PTFs is required for operation with version 4.1.

16 Performance Endpoints
Endpoint Capabilities
The following table indicates which endpoints have been tested with and are
supported by NetIQ products. Shaded rows indicate endpoints that have been
archived at previous versions. For more details on specific product capabilities,
see the topics below.

NetIQ Product Qcheck Chariot End2End Chariot VoIP Manger

VoIP Call
Endpoint Assessor Performance

Compaq Tru64 Yes Yes Yes No No

UNIX

FreeBSD UNIX Yes Yes Yes No No

HP-UX Yes Yes Yes No No

IBM AIX Yes Yes Yes No No

IBM MVS, Yes Yes Yes No No

Windows install

IBM OS/2 Yes Yes Yes No No

Linux for Cobalt Yes Yes Yes No No

RaQ/RaQ2 (MIPS)

Linux for Cobalt Yes Yes Yes Yes No

RaQ3 (x86)

Linux x86 (TAR) Yes Yes Yes Yes No

Linux x86 (RPM) Yes Yes Yes Yes No

Linux IA-64 Yes Yes Yes No No

(TurboLinux)

Microsoft Windows Yes Yes Yes No No

95

Microsoft Windows Yes Yes Yes Yes Yes

98

Microsoft Windows Yes Yes Yes Yes Yes

Me/NT/2000/XP

Microsoft Windows Yes Yes No Yes No

98 (Web-Based)

Microsoft Windows Yes Yes No Yes No

Me/NT/2000/XP
(Web-Based)

Microsoft Windows Yes Yes Yes No No

XP (64-Bit)

Chapter 2 • Performance Endpoints 17

 NetIQ Product Qcheck Chariot End2End Chariot VoIP Manger
VoIP Call
Endpoint Assessor Performance

Microsoft Windows Yes Yes Yes No No

3.1

Novell NetWare Yes Yes Yes No No

SCO UnixWare Yes Yes Yes No No

SGI IRIX Yes Yes Yes No No

Spirent Yes Yes Yes Yes No

Communications
TeraMetrics

Sun Solaris Yes Yes Yes Yes No

(SPARC)

Sun Solaris Yes Yes Yes Yes No

Endpoint (x86)

Endpoints for Windows 2000 and Windows XP also support testing with IPv6.
Refer to the following topic, “Performance Endpoint Support for Chariot
Functions” below for more information.

Performance Endpoint Support for Chariot Functions

The following table describes the Performance Endpoint capabilities for the
supported operating systems. Shaded rows indicate endpoints that have been
archived at previous versions. These endpoints may not support functionality
new in the latest versions of NetIQ Chariot.

Endpoint OS IP QoS Traceroute CPU Util. VoIP IPv6

(DiffServ, Test Test
GQOS, TOS) Module Module

Cobalt RaQ or RaQ2 TOS no yes no no

(MIPS)

Cobalt RaQ3 (x86) TOS yes yes yes no

Compaq Tru64 UNIX TOS no yes no no

FreeBSD UNIX TOS no yes no no

HP-UX TOS yes yes no no

IBM AIX TOS yes yes no no

IBM MVS no no no no no

IBM OS/2 TOS no yes no no

Linux TOS yes yes yes no

Linux IA-64 TOS yes yes no no

18 Performance Endpoints
Endpoint OS IP QoS Traceroute CPU Util. VoIP IPv6
(DiffServ, Test Test
GQOS, TOS) Module Module

Microsoft Windows no no no no no
3.1

Microsoft Windows no no yes no no

95

Microsoft Windows TOS (UDP, yes yes no no

95 with WinSock 2 RTP)

Microsoft Windows GQOS yes yes yes no

98 (RSVP), TOS
(UDP, RTP)

Microsoft Windows GQOS yes yes yes no

Me (RSVP)

Microsoft Windows TOS (UDP, yes yes yes no

NT 4 RTP)

Microsoft Windows no yes yes no no

NT 4 for Alpha

Microsoft Windows DiffServ, yes yes yes yes. See

2000 GQOS, TOS “IPv6
(via Registry) Test
Module
Support”

Microsoft Windows yes no yes yes no

98 (Web-Based)

Microsoft Windows yes no yes yes no

Me/NT/2000/XP
(Web-Based)

Microsoft Windows DiffServ, yes yes yes yes. See

XP GQOS, TOS “IPv6
(via Registry) Test
Module
Support”

Microsoft Windows DiffServ, yes no yes no

XP (64-bit) GQoS, TOS

Novell NetWare no no no, v3.12; no no

yes, v4.0

SCO UnixWare TOS (bits 3- no no no no

5)

SGI IRIX TOS no yes no no

Spirent Terametrics TOS yes yes yes no

Chapter 2 • Performance Endpoints 19

 Endpoint OS IP QoS Traceroute CPU Util. VoIP IPv6
(DiffServ, Test Test
GQOS, TOS) Module Module

Sun Solaris for TOS yes yes yes no

SPARC

Sun Solaris for x86 TOS yes yes yes no

IPv6 Test Module Support

Currently, testing with version 6 of the Internet Protocol (IPv6) is only
supported on endpoints for Windows 2000 and Windows XP (32-bit only).
You must first install IPv6 support on these endpoints before you begin
testing. You must also purchase the separately licensed IPv6 Test Module.
In addition, Windows 2000 requires a patch called the “Microsoft IPv6
Technology Preview for Windows 2000 Network Protocol Stack,” which you
can download from
http://msdn.microsoft.com/Downloads/sdks/platform/tpipv6/readme.asp.

Performance Endpoint Support for End2End

Functions
The following table shows which endpoint platforms are supported for
End2End functions, particularly for the different types of monitoring End2End
performs. Shaded rows indicate endpoints that have been archived at previous
versions. These endpoints may not support functionality new in the latest
version of NetIQ End2End.

Endpoint OS System Application Network Service Traceroute Auto-

Mon. Mon. Mon. Mon. Upgrade

Cobalt RaQ or no no yes no no no

RaQ2 (MIPS)

Cobalt RaQ3 (x86) no no yes no yes no

Compaq Tru64 no no yes no no no

UNIX

FreeBSD UNIX no no yes no no no

HP-UX yes no yes no yes no

IBM AIX yes no yes no yes no

IBM MVS no no yes no no no

IBM OS/2 no no yes no no no

Linux no no yes no yes no

Linux IA-64 no no no no yes no

20 Performance Endpoints
Endpoint OS System Application Network Service Traceroute Auto-
Mon. Mon. Mon. Mon. Upgrade

Microsoft Windows no no yes no no no

3.1

Microsoft Windows yes yes yes no no yes

95

Microsoft Windows yes yes yes no yes yes

95 with WinSock 2

Microsoft Windows yes yes yes yes yes yes

98

Microsoft Windows yes yes yes yes yes yes

Me

Microsoft Windows yes yes yes yes yes yes

NT 4

Microsoft Windows yes no yes no yes no

NT 4 for Alpha

Microsoft Windows yes yes yes yes yes yes

2000

Microsoft Windows no no no no no no
98 (Web-Based)

Microsoft Windows no no no no no no
Me/NT/2000/XP
(Web-Based)

Microsoft Windows yes yes yes yes yes yes

XP

Microsoft Windows no no yes no yes no

XP (64-bit)

Novell NetWare no no yes no no no

SCO UnixWare no no yes no no no

SGI IRIX no no yes no no no

Spirent no no yes no yes no

Terametrics

Sun Solaris for yes no yes no yes no

SPARC

Sun Solaris for x86 yes no yes no yes no

Chapter 2 • Performance Endpoints 21

Endpoint Computer Resource Guidelines
Determining the computer requirements for a given endpoint can be
challenging. There are many variables involved, such as processor speed,
operating system, protocol stack, memory, disk space, and the underlying
network.
To determine your computer requirements, you must first define how you plan
to use Chariot or End2End. The type of information you need depends upon
your usage. The following topics provide recommended endpoint computer
specifications according to different testing scenarios.

Generating Maximum Throughput

The main factors in getting the most throughput from a computer are CPU
speed and memory. You need a CPU that is fast enough to match your
network capacity, and with enough memory to hold the code and data used
for the test. For best throughput, we recommend using a 32-bit (or better)
operating system. The memory you need is based on your operating system.
Make sure that you have enough memory at the endpoints so that no
swapping takes place while running a test. The following table shows some
guidelines in determining the best CPU for different network speeds.

Throughput Recommended computer

less than 100 Mbps PCI-based computer with a 32-bit operating system

100 to 200 Mbps Pentium 166 or greater (consider multiple concurrent pairs)

200 to 500 Mbps Pentium II or greater (consider multiprocessors)

over 500 Mbps latest Pentium III or equivalent, with the latest NICs (consider
multiprocessors)

The following observations may help guide your throughput testing.

• Windows NT, Windows 2000, Windows XP, and Linux yield the highest
throughput. If you test on one of the Windows OSs with the Chariot
benchmark script called High_Performance_Throughput, the endpoints can
make use of Microsoft’s WinSock 2 overlapped I/O to achieve much
greater throughput on high-speed networks (100 MB and faster). In a test
of Gigabit Ethernet throughput using Windows 2000 Server and two
Pentium III computers, each having two 933-MHz processors, 1 Gigabyte
of RAM, and a single Gigabit NIC, we generated 943 Mbps with six pairs.
• We have also observed some improvements in throughput measurements
after changing the TcpWindowSize setting in the Windows NT Registry to
65536. You can set this parameter in the following Registry key:

HKEY_LOCAL_MACHINES\SYSTEM\CurrentControlSet\Services\Tcpip
\Parameters

Set the key as a type REG_DWORD.

Refer to the Windows NT Resource Kit for more information.

22 Performance Endpoints
Calculating Memory Requirements
Endpoints are designed to run in any computer that has sufficient memory to
run the operating system well. If you plan to use multiple pairs on a single
computer, you may want to calculate the number of pairs that will run without
causing the operating system to swap either code or data.
The following table can be used to plan for multiple pairs. The Base RAM
column indicates the amount of memory that is allocated by the endpoint
before running any pairs. If the endpoint is not being used, this amount may
go toward zero if the operating system supports swapping. The protocol
columns indicate the amount of memory required for a pair of that protocol.

Operating Base TCP RTP or SPX IPX APPC

System RAM (in KB/pair UDP KB/pair KB/pair KB/pair
KB) KB/pair

MVS 666 25-48 24-52 n/a n/a n/a

NetWare 1100 80-110 320-340 70-100 260-280 n/a

OS/2 1096 50-65 150-170 315-340 150-170 65-90

UNIX (AIX) 1176 132-284 146-296 n/a n/a n/a

Windows 550 72-600 72-600 n/a n/a n/a

3.1

Windows 1100 40-65 100-145 40-65 55-75 n/a

95/98/Me

Windows 2076 35-60 160-180 35-60 160-180 n/a

NT/2000/XP

These RAM usage numbers represent sending with the variable send_datatype
set to ZEROS. Other send_datatypes require memory buffers roughly equivalent
to the disk space of the .cmp file being used. Add 2 KBytes when using
send_datatype = NOCOMPRESS. See the Application Scripts guide for more
information on script variables.

Endpoint Pair Capacity

The following table shows some example pair capacities we have tested on
various computers. These pairs ran on a 10 Mbps Ethernet LAN. The values in
the pairs columns represent the number of pairs this computer supported as
Endpoint 2 for a single test. We used the default values for all tests, with two
exceptions: for datagram testing, we lengthened the timeout values, as well as
the initial_delay in test scripts.
This table does not represent the full capacities of these operating systems and
stacks, just some representative tests we have run in our test lab.

Chapter 2 • Performance Endpoints 23

 Operating Installed TCP pairs RTP or SPX pairs IPX pairs APPC pairs
System RAM UDP pairs

AIX 4.1 64 MB 200 180 n/a n/a n/a

NetWare 64 MB 500 200 100 100 n/a

4.12

OS/2 4.0 32 MB 500 200 20 20 500

Windows 3.1 8 MB 1 1 n/a n/a n/a

Windows 16 MB 18 100 40 175 n/a

95/98/Me

Windows 32 MB 500 100 300 100 200

NT/2000/XP

Notes
• On Windows NT and Windows 2000, APPC pairs were run using Microsoft
SNA Server.
• On Windows 95, Windows 98, and Windows Me, SPX and IPX pairs were
run using Novell Client32 for SPX and IPX.
• On OS/2 4.0, IPX and SPX pairs were run using Novell Client for OS/2.

Chariot now supports larger tests under certain conditions using TCP. See
“Internet-Scale Testing” in the User Guide for Chariot for more information
about requirements for large tests.

Endpoint Versions
With each new release of NetIQ Chariot and End2End, the endpoints are
updated to support new functionality. However, because some endpoint
operating systems are rarely used or provide limited support for Chariot and
End2End features, such as End2End service monitoring, endpoints for a few
operating systems have been archived. These endpoints are still made
available on the Performance Endpoints CD-ROM and on the NetIQ Web site;
however, they may not support the latest capabilities of Chariot and End2End.
The Endpoint README file, included in the root directory of the endpoint
CD-ROM, provides a list of all available endpoints and indicates their versions
if they are different from the current endpoint level.

24 Performance Endpoints
Chapter 3
Endpoint Initialization File

An endpoint initialization file is installed with each Performance Endpoint.

With this file, you can do the following:
• Restrict the use of this endpoint to specific Chariot or Qcheck Consoles or
End2End servers.
• Control which access attempts are logged in an audit file.
• Change the filename of the audit file.
• Enable only particular protocols on this endpoint for setup connections.
• Change the filename of the End2End safestore file.
• Change the location of the endpoint software used for automatic updating.

On most operating systems, this file is named endpoint.ini (on MVS, see data
set HLQ.SLQ.JCL(ENDPTINI), where “HLQ” and “SLQ” are the high-level and
second-level qualifiers entered during MVS endpoint installation). This file has
the same format and structure on all the operating systems.
Here are the default contents of the endpoint initialization file. You can change
these keywords and their parameters to tailor individual endpoints for your
needs.

Keyword Parameters

ALLOW ALL

SECURITY_AUDITING NONE

AUDIT_FILENAME ENDPOINT.AUD

ENABLE_PROTOCOL ALL

SAFESTORE_DIRECTORY (the directory where the endpoint is installed)

UPDATE_SERVER endpointupdate.ganymede.com

END2END_SERVER No default

Note
For the MVS endpoint, the default filename of ENDPOINT.AUD is ENDPTAUD.

Chapter 3 • Endpoint Initialization File 25

 This file is an editable text file. There is a separate copy for each operating
system. You might want to make changes to it once, before endpoint
installation, which are then incorporated into all the installs for different sets of
computers. You can modify this text file before installation by copying the
endpoint installation directory for an operating system to a hard drive
(preferably a LAN drive), and then modifying the file before running the install
from that drive.
We strongly recommend that you make any changes to your endpoint.ini
files once, before you install any endpoints, as opposed to installing the
endpoints and then going back to each of them and separately modifying each
one. If you’re using Windows (32-bit or 64-bit) endpoints, we’ve included a
utility to help you edit the endpoint.ini files before installing the endpoints,
should you wish to prepare the endpoints for future automatic upgrades. See
“Customizing endpoint.ini for Windows Endpoints” on page 29 for more
information.

ALLOW
This keyword determines which Chariot or Qcheck Consoles or End2End
servers can run tests using this endpoint.
To allow any user to run tests on this endpoint, use the ALL parameter, which
is the installation default:
ALLOW ALL

However, the default “ALLOW ALL” is NOT RECOMMENDED. Although

“ALLOW ALL” makes it easy to install an endpoint and see that it’s running, it
also lets any user who can reach the endpoint potentially use that endpoint as
a traffic generator. For example, End2End administrators who deploy
endpoints widely in their networks probably don’t expect to have those
endpoints used in network stress testing.
To allow only specific users to run tests with this endpoint, remove the “ALLOW
ALL” line and identify one or more specific Chariot or Qcheck Consoles or
End2End servers by their network addresses. You can specify more than one
address per protocol. For example,
ALLOW TCP 192.86.77.120
ALLOW TCP 192.86.77.121
ALLOW APPC netiq.johnq

Specify a connection-oriented protocol (that is, APPC, TCP, or SPX) as the first
parameter and provide its corresponding network address as the second
parameter. Endpoints only listen for incoming tests on connection-oriented
protocols, like TCP. Datagram tests are set up and results are returned using
their “sister” connection-oriented protocol; thus, UDP tests are set up using
TCP, and IPX tests are set up using SPX.
The network address cannot be an alias or hostname; that is, in APPC it must
be a fully qualified LU name, in TCP/IP it must be an IP address in dotted
notation, and in IPX/SPX it must be an IPX address with hex network address
and node address.

26 Performance Endpoints
 Endpoints do not respond to End2End endpoint discovery requests unless the
IP address of the End2End server is specifically allowed (or unless “ALLOW ALL”
is specified). This prevents the user of an End2End server from finding
endpoints to which it should not have access.
You cannot use the ALLOW parameter to restrict access from one endpoint to
another endpoint. The ALLOW parameter can only be used to permit (or
prevent) access from specific Chariot or Qcheck Consoles or End2End servers
to the endpoint at which the parameter is defined.
If, for some reason, you need to restrict your endpoint to access only your
own computer, specify your own IP network address rather than 127.0.0.1.
Specifying 127.0.0.1 (the equivalent of localhost) allows any other user who
specifies “localhost” as Endpoint 1 to access your computer as Endpoint 2.

SECURITY_AUDITING
This keyword determines which access attempts the endpoint keeps track of in
its audit file. Here are the possible parameters:

NONE Nothing is written to the audit file.

PASSED Only access attempts that passed the ALLOW address check are logged.

REJECTED Only access attempts that failed the ALLOW address check are logged.

ALL Both passed and rejected access attempts are logged.

If a test initialization fails for a reason other than address checking, no entry is
made in the audit file.

AUDIT_FILENAME
This keyword specifies the filespec for the audit file. See
SECURITY_AUDITING on page 27 to understand the types of events logged in
its audit file. The default filename, in endpoint.ini, is endpoint.aud. If no
drive or path is specified, the audit file uses the drive and path of the endpoint
program.
This file contains at most two lines for each endpoint pair that is started on this
endpoint. These two lines represent the start of an endpoint instance and the
end of that instance.
Each line written to the audit file consists of a set of information about the
endpoint instance and what it has been asked to do. The information is written
in comma-delimited form, so you can load the audit file into a spreadsheet or
database. When the audit file is created, an initial header line explains the
contents of the subsequent entries.
The following table shows the fields of each entry in the audit file:

Chapter 3 • Endpoint Initialization File 27

 Time The date and time when the entry was created, in the local
time zone.

Action Whether this entry indicates that an endpoint instance was

“Started” or “Ended.”

Endpoint Whether the endpoint is in the role of Endpoint 1 or Endpoint

2.

Protocol of Chariot The network protocol used to contact Endpoint 1.

Console or End2End
server

Network Address of The network address as seen by Endpoint 1. If you encounter

Chariot Console or problems setting up your ALLOW entries, this is the value to
End2End server use for the protocol address.

Security Result Whether this SECURITY_AUDITING “passed” or was

“rejected.” If this is an entry for an “Ended” action, this field is
reported as “n/a.”

Endpoint Partner Protocol The network protocol used to run the test with our partner
endpoint.

Endpoint Partner Address The network address of our partner endpoint.

ENABLE_PROTOCOL
This keyword lets you control which connection-oriented protocols this
endpoint uses to listen for setup connections. This does not affect the network
protocols, which can be used to run tests. Here are the possible parameters:
ALL
APPC
SPX
TCP

In general, you should use the ALL setting (the default). Specify protocols
explicitly to reduce the overhead of listening on the other protocols or if
you’re encountering errors when listening on the other protocols.
See the discussion of the ALLOW keyword on page 26 for information about
support of the datagram protocols, IPX, RTP, and UDP.

SAFESTORE_DIRECTORY
Use the SAFESTORE_DIRECTORY keyword to change the filename of the End2End
safestore files, which hold the endpoint’s schedule and any results that have
not yet been sent to the End2End server. This keyword has no effect on
Chariot users.
For example, the following line causes the endpoint to write its safestore files
to the directory d:\NetIQ\Endpoint:
SAFESTORE_DIRECTORY D:\NETIQ\ENDPOINT

28 Performance Endpoints
UPDATE_SERVER
This keyword lets you specify the Uniform Resource Locator (URL) of the Web
server containing the upgraded Performance Endpoint software. This location
is used when the endpoint receives a request from an End2End server to
download and install upgraded endpoint software. The URL is the “scheme-
specific” part of a valid Uniform Resource Locator, that is, the part after
“http://” (see RFC 1738). The default for this keyword is:
UPDATE_SERVER ENDPOINTUPDATE.GANYMEDE.COM

You can also configure your endpoints to automatically download upgrades

from a local server. If you don’t want to perform a separate configuration of
each endpoint’s endpoint.ini file to change the location of the server, you
can modify an executable file included in the endpoint packaging for all
Win32 endpoints. When the endpoints are installed, they will automatically use
the customized endpoint.ini file you edited. See “Customizing endpoint.ini
for Windows Endpoints“ on page 29 for more information.

END2END_SERVER
This keyword allows you to specify one or more End2End servers to which the
endpoint will initiate a connection. The server is polled every 15 minutes until
contacted.
These endpoints are subject to the rules governing inbound endpoints, as
defined in the End2End server’s Global Endpoint Defaults.
TCP is the only protocol supported for polling at this time. Here’s the syntax:
END2END_SERVER protocol name | address

Here’s an example of the statement using an IP address. Multiple iterations are

allowed:
END2END_SERVER TCP 192.86.77.120

For more information about inbound endpoints, see the User Guide for
End2End.

Customizing endpoint.ini for Windows Endpoints

Endpoints for Windows can be set up to automatically upgrade themselves.
These endpoint computers must be able to contact a Web server where the
upgraded software is stored. Although the default Web server for endpoint
upgrades is accessible on the Internet at
http://endpointupdate.ganymede.com/, in endpoint.ini you can configure the
location and directory of any Web server from which the upgraded software
can be accessed. See the section titled “UPDATE_SERVER” on page 29 for
more information on the endpoint upgrade procedure.

Chapter 3 • Endpoint Initialization File 29

 We’ve included a utility, gsendw32.exe for Windows and gsendw64.exe for 64-
bit Windows, to help you configure endpoint.ini for Windows endpoint
upgrades. To modify endpoint.ini before installing an endpoint for Windows,
unzip the self-extracting gsendw32.exe (or gsendw64.exe) installation file and
make the changes before starting the endpoint installation. Consult “Using
WinZip” on page 31 for information about unzipping files.
When you click Extract, the endpoint files are extracted (including
endpoint.ini) to the directory you selected.

If you are installing over an existing endpoint, the endpoint.ini file is not
installed by default. To install the new file, use the following option for SETUP:
SETUP replace_ini

This option reinstalls the endpoint. If an endpoint encounters an error while

processing the endpoint.ini file, no one is allowed to use the endpoint in
tests. That means no Chariot Console, End2End server, or Qcheck program will
be able to run tests with the endpoint.

Configuring Endpoints for Large-Scale Customization

To customize features such as automatic upgrades, you must edit the
endpoint.ini file for each endpoint. For obvious reasons, you may not want
to undertake such a potentially lengthy procedure. You can extract the files
located in gsendw32.exe if you need to perform a large-scale customization of
endpoint.ini. In addition to WinZip 7.0, you’ll need the WinZip command-
line support add-on and WinZip Self-Extractor. Here’s how to use it:
1. Open the file gsendw32.exe using WinZip. See “Using WinZip” on page 31
for more information.
2. Extract the files to a temporary directory.
3. Edit or replace the endpoint.ini that is now in the temporary directory.
4. Using WinZip, create a new archive that contains all the files in the
temporary directory.
5. Using the WinZip Self-Extractor, create a self-extracting executable; for the
command line to run, enter the following:
SETUP.EXE replace_ini

Now, anyone who executes the new executable you’ve created will
automatically have the endpoint installed using the endpoint.ini file that
you’ve customized.
To create a file that silently self-installs with a custom endpoint.ini, take
the following steps:
1. Open the file gsendw32.exe using WinZip. See “Using WinZip” on page 31
for more information.
2. Extract the files to a temporary directory.

30 Performance Endpoints
 3. Edit or replace the endpoint.ini that is now in the temporary directory.
4. Create a custom response file (say, customer.iss); enter
i. SETUP -noinst -r -f1.\customer.iss

5. Using WinZip, create a new archive that contains all the files in the
temporary directory.
6. Using the WinZip Self-Extractor, create a self-extracting executable; for the
command line to run, enter the following:
SETUP.EXE replace_ini -s -f1.\CUSTOMER.ISS

Now, anyone who executes the file you’ve created will automatically have the
endpoint installed using customer.iss as the response file, and the
endpoint.ini file installed will also be the customized version you created.

See “UPDATE_SERVER” on page 29 for information on endpoint upgrades.

Using WinZip
If you are installing endpoints on Windows, you first need to unzip the
gsendw32.exe file from the CD. For Windows 3.1, the zip file is called
win31.zip. We recommend using WinZip version 7.0. Follow these steps to
unzip the file:
1. Open the WinZip program.
2. On the File menu, click Open Archive.
3. In the Open Archive dialog box, browse to the Endpoint\Win32 directory
on the endpoint CD-ROM and select the executable endpoint file
gsendw32.exe.

4. Click Open to unzip the files. The files that were unzipped are shown in
the Window.
5. On the Action menu, click Extract.
6. In the Extract dialog box, browse to the directory where you want to save
the files. This location should be accessible by users who need to install
the endpoint.
7. Click Extract. The files are extracted to the directory you selected.

Chapter 3 • Endpoint Initialization File 31

32 Performance Endpoints
Chapter 4
Distributing Endpoints Using SMS

Endpoints can be installed and uninstalled on Windows computers

automatically using Microsoft’s Systems Management Server (SMS). This
discussion assumes you are already familiar with package distribution via SMS.
• The SMS Server software must be installed and running properly on a
Windows NT server.
• The SMS Client software must be installed and running properly on the
Windows computers (that is, Windows 3.1x, plus all Win32 operating
systems) where you want to remotely install endpoints. A folder titled “SMS
Client” is present when the software has been installed correctly.

Our testing indicates that Version 1.2 of SMS (with Service Pack 2) or later is
required.

Installing Endpoints Using SMS

Follow these steps to install endpoints with SMS version 1.2.
1. If you are installing endpoints on Windows, you need to unzip the
gsendw32.exe file from the CD. Refer to “Using WinZip” on page 31 for
instructions.
2. Once the files are extracted and saved to the directory you selected, create
a response file for each distinct set of client computers.
You need to create a response file (typically named setup.iss) for each
unique installation. Each different operating system or target path is a unique
installation. For example, you may have a set of Windows NT x86 computers
where you want to install the endpoint in a directory named for our software
(that is, d:\Program Files\NetIQ\Endpoint) and another set where you want
to install to a directory named c:\Programs\Endpoint. In this case, you would
create two separate response files, one for each distinct set of installations.
To create a response file for a set of computers, go to one of the computers in
the set and change the current working directory to the one where you
extracted and saved the installation files for that computer. Enter a command
like the following:
setup -noinst -r -f1d:\yourdirectory\setup.iss

Chapter 4 • Distributing Endpoints Using SMS 33

 It is important to run SETUP from that directory, because the version of
setup.exe in your Windows directory will not work.

Here are the parameters for the SETUP command:

-noinst No install: create the setup.iss file, but don’t really install the endpoint right
now. This is a NetIQ-specific option and must appear before any setup-
defined options, like “-r.”

-r Records the installation actions in an .iss file.

-f1 Gives the path name for the output response file.

1. Copy the endpoint installation files from the directory to a hard disk, along
with the setup.iss file.
2. For each distinct set of client computers, create a directory on a hard disk
available to the SMS Server. Into each directory, copy the corresponding
endpoint installation files. In addition, copy the new setup.iss file you just
created to the matching directory.
For example, create directories on the SMS Server’s hard disk named
\Endpoint_WNT1 and \Endpoint_WNT2 for the two sets of client computers
discussed in the preceding step. Copy all the unzipped installation files to
each of these directories. Finally, copy the setup.iss file for the first set of
client computers into directory \Endpoint_WNT1; copy the other setup.iss
file into the second directory.
3. Inside the SMS program at the SMS Server, select File, then New. Click
Import. Navigate to the drive and path where you’ve copied the endpoint
installation files and their setup.iss file. Choose the corresponding .pdf
file, which should be shown in the file list.
A dialog box should appear showing the correct package installation
information.
4. Click Workstations. In the dialog box that follows, move to the same
drive and path you selected in step 3 by clicking the “...” symbol under
“Source Directory.” Then choose “Automated Installation” and click
Properties. You should see the command line string necessary to install
the endpoint, similar to the string you entered to create the setup.iss file.
5. Click OK, Close, and then OK to finish creating the SMS package. Repeat
these steps for each distinct set of client computers.
6. Configure the packages at the SMS Server for your schedules and sites.
7. Decide when you want the endpoints installed, and on which computers.
Configure these schedules and sites in SMS as you would with other SMS
packages. See the SMS documentation for assistance.
Our software supports SMS Inventory Information, which has been encoded in
the .pdf files.

34 Performance Endpoints
Uninstalling Endpoints Using SMS
Follow these steps to remove endpoint packages, using SMS version 1.2:
1. At the SMS Server, select a package to delete and update the name of the
Delsl?.isu file.

2. Inside the SMS program at the SMS Server, select File, then Open the
endpoint package you want to uninstall.
3. Click Workstations. In the dialog box that follows, move to the drive and
path for the package by clicking the “...” symbol under “Source Directory.”
Then choose Automated Uninstallation and click Properties. It should
show the command line string necessary to uninstall the endpoint, similar
to the string you entered to create the setup.iss file. You should see a
sequence that looks like “ fDelsl?.isu” in the middle of the string. The “?”
here is a number, representing the latest installation on the client
computer. For example, if the endpoint has been installed twice, the client
computer will have a file named “Delsl2.isu” in the directory where you
installed the endpoint. This filename at the SMS Server must exactly match
the filename at the SMS Client where the endpoint is being uninstalled.
4. Click OK, Close, and then OK to finish the update of the SMS package.
Repeat these steps for each distinct set of client computers.
5. Configure the packages at the SMS Server for your schedules and sites.
6. Decide when you want the endpoints uninstalled, and on which
computers. Configure these schedules and sites in SMS as you would with
other SMS packages. See the SMS documentation for assistance.

Chapter 4 • Distributing Endpoints Using SMS 35

36 Performance Endpoints
Index

endpointupdate.ganymede.com URL
A 29
ALLOW keyword 26
archived endpoints 24 G
AUDIT_FILENAME keyword 27
automatic upgrade 29 gsendw32.exe 29, 30
self-install 30 gsendw64.exe 29

C H
calculating memory requirements 23 hardware requirements 13
capacities of endpoints 23
I
E IBM MVS endpoint
ENABLE_PROTOCOL keyword 28 TCP 16
End2End 20, 29 inbound endpoints 29
END2END_SERVER keyword 29 installation requirements
endpoint capabilities Windows XP 64-bit endpoint 1
Chariot 18 installing endpoints using SMS 33
End2End 20 IPv6 Test Module
endpoint capacities 23 support for 20
endpoint initialization file 25
default keywords 25 M
endpoint versions 24
Microsoft overlapped I/O 22
endpoint.aud 27
endpoint.ini 25
ALLOW keyword 26 R
AUDIT_FILENAME keyword 27 requirements 22
customizing for upgrades 29 response file 31, 33
ENABLE_PROTOCOL keyword 28 restricting access to endpoints 26
END2END_SERVER keyword 29
SAFESTORE_DIRECTORY keyword
28 S
SECURITY_AUDITING keyword 27 SAFESTORE_DIRECTORY keyword 28
UPDATE_SERVER keyword 29 SECURITY_AUDITING keyword 27
endpoints SetAddr utility 10
automatically upgrading 29 setup.iss file 33
installing with SMS 33 SMS installation 33
uninstalling with SMS 35 software requirements

Index 37
 protocol support 13 VoIP Test Module
support for OS support for 18
Windows XP 64-bit 12
Systems Management Server (SMS) 33 W
Windows 3.1 endpoint
T TCP/IP stacks 16
TCPaccess Windows XP 64-bit endpoint
versions supported for MVS configuring 6
endpoint 16 directories 5
TcpWindowSize 22 disabling automatic startup 9
throughput 22 installation 2
generating maximum 22 manual uninstall 6
messages 11
U removing 6
requirements 1
uninstall running 8
via SMS 35 SetAddr utility 10
UPDATE_SERVER keyword 29 starting 9
upgrade (automatic) 29 stopping 9
unattended installation 4
V updates 12
with TCP/IP 7
version WinZip 31
of endpoint 24
virtual addresses in Windows 10

38 Performance Endpoints