HP 11i User manual

ACC X.25 Data Analyzer User’s Guide

Edition 1

HP 9000 Networking

Manufacturing Part Number : Z7345-90004

E0204

2

3

Legal Notices

The information in this document is subject to change without notice.

Hewlett-Packard makes no warranty of any kind with regard to this

manual, including, but not limited to, the implied warranties of

merchantability and fitness for a particular purpose. Hewlett-Packard

shall not be held liable for errors contained herein or direct, indirect,

special, incidental or consequential damages in connection with the

furnishing, performance, or use of this material.

Warranty. A copy of the specific warranty terms applicable to your

Hewlett- Packard product and replacement parts can be obtained from

your local Sales and Service Office.

Restricted Rights Legend. Use, duplication or disclosure by the U.S.

Government is subject to restrictions as set forth in subparagraph (c) (1)

(ii) of the Rights in Technical Data and Computer Software clause at

DFARS 252.227-7013 for DOD agencies, and subparagraphs (c) (1) and

(c) (2) of the Commercial Computer Software Restricted Rights clause at

FAR 52.227-19 for other agencies.

HEWLETT-PACKARD COMPANY 3000 Hanover Street Palo Alto,

California 94304 U.S.A.

Use of this manual and flexible disk(s) or tape cartridge(s) supplied for

this pack is restricted to this product only. Additional copies of the

programs may be made for security and back-up purposes only. Resale of

the programs in their present form or with alterations, is expressly

prohibited.

Reproduction, adaptation, or translation of this document without prior

written permission is prohibited, except as allowed under the copyright

laws.

California

4

This software is based in part on the Fourth Berkeley Software

Distribution under license from the Regents of the University of

California.

Trademark Notices UNIX is a registered trademark in the United

States and other countries, licensed exclusively through X/Open

Company Limited.

X Window System is a trademark of the Massachusetts Institute of

Technology.

MS-DOS and Microsoft are U.S. registered trademarks of Microsoft

Corporation.

OSF/Motif is a trademark of the Open Software Foundation, Inc. in the

U.S. and other countries.

5

Publishing History

The manual publishing date and part number indicate its current

edition. The publishing date will change when a new edition is

published. Minor changes may be made without changing the publishing

date. The manual part number will change when extensive changes are

made.

Manual updates may be issued between editions to correct errors or

document product changes. To ensure that you receive the updated or

new editions, you should subscribe to the appropriate product support

service. See your HP sales representative for details.

First Edition February 2004 Release 1.0

6

7

Preface

This manual describes the Data Analyzer accessory product for the ACC

family of multiplexers.

Manual Organization

This manual contains the following chapters and appendices:

Chapter 1 Chapter 1, “Overview,” provides an overview of the

data analyzer, a description of data analyzer features,

and data analyzer requirements.

Chapter 2 Chapter 2, “Installing the Data Analyzer,” describes

how to install analyzer Y-cables, install the analyzer

software, and configure the analyzer.

Chapter 3 Chapter 3, “Data Analyzer Commands,” describes each

of the data analyzer program commands. Each

command is described in detail and followed by

example of use of the command.

Appendix A Appendix A, “Network Configuration,” provides

detailed information on setting up the network

configuration file.

Appendix B Appendix B, “Typical X.25 and Data Analyzer

Sessions,” provides the results of actual data analyzer

sessions that were run using this software.

8

Related Documentation

The documentation available for the Multiprotocol ACC family of

products includes the following hardware and software manuals:

Hardware Manuals

• 8 Channel PCI ACC Multiplexer Hardware Installation and

Reference Manual

Software Manuals

• ACC Installation and Configuration Guide

• ACC Utilities Reference Guide

• ACC Programmer’s Reference Guide

• ACC Error Guide

• HDLC Frame Protocol User’s Guide

• ACC X.25 Protocol User’s Guide

• ACC X.25 Data Analyzer User’s Guide

• ACC HDLC/LAP-B (ABM) Protocol User’s Guide

• HDLC-NRM (SDLC) Protocol User’s Guide

• X.25/ACC Installation and Configuration Guide

• X.25/ACC Update Guide

• X.25/9000 User’s Guide

• X.25/9000 Programmer’s Guide

9

Contents

1. Overview

Data Analyzer Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Data Analyzer Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Data Analyzer Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

2. Installing the Data Analyzer

Installing the Analyzer Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Software Removal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Software Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Verifying Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Configuring the Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Dynamic Set-Up of Analyzer Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

3. Data Analyzer Commands

Detailed Command Descriptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

display. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

run. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Contents

10

Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

runc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

shutdown . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

stopd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

A. Network Configuration

Setting Up the Network Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Mux Firmware Download File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

Port Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

ZLU Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Running TTGEN and Starting the ACC Mux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Starting ACC Subsystem and Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Running PDISPLAY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

Sample Network Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

B. Typical X.25 and Data Analyzer Sessions

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

General Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Chapter 1 11

1 Overview

This chapter provides an overview of the data analyzer, a description of

data analyzer features, and data analyzer requirements.

Overview

Data Analyzer Overview

Chapter 112

Data Analyzer Overview

The data analyzer is supplied with the ACC Base System product. It is a

software based tool that allows real-time capture and analysis of X.25

traffic on one or more X.25 links simultaneously. It runs within an

HP-UX based HP 9000 system. Although the data analyzer is designed to

monitor X.25 or ISDN traffic from the ACC products, it can be attached

to any RS-232 or V.35 X.25 connections with line speeds up to 1222 Kb/s.

Each X.25 connection to be monitored on an 8-Channel card requires two

ACC multiplexer ports, thus a single 8-channel ACC multiplexer card

can support up to four analyzer sessions. Two ports are required on the

8-channel PCI card only if a non-ACC X.25 link is being monitored. The

analyzer can provide up to 8 concurrent sessions by using the ports on

two or more 8-Channel ACC cards. For ISDN traffic analysis, each

connection requires only one sub-channel.

The Data Analyzer is composed of three major components:

• HDLC frame receiver multiplexer firmware

• HP-UX capture/filter daemon

• Display and analysis program

Figure 1-1 on page 13 shows the relationships between these

components, as well as the unique 'software-only' input configuration

with respect to the 8-Channel PCI ACC products. Configuration

information is set up either in the ACC TTGEN configuration file, or

dynamically by means of the convenient runc command.

Overview

Data Analyzer Overview

Chapter 1 13

Figure 1-1 Overview of ACC based Data Analyzer

Capture / Filter

Daemon

Data capture

File(s)

Commands to

Filter

Configuration

information

pcapture

Uses software

access only

runc

8 port PCI &

mux card(s)

Display / Control

Program

Analyzer Application Software

Overview

Data Analyzer Overview

Chapter 114

Only one copy of the capture daemon runs in each HP 9000 system. It

handles all analyzer sessions. The control of these sessions comes from

one or more invocations of the Display program. The pdisplay program

is designed to work on any HP-UX TTY device. Several copies of the

pdisplay program can independently control several analyzer sessions

simultaneously, or one pdisplay program may control multiple sessions.

The pcapture program can monitor all traffic on a particular X.25 link,

or it can selectively monitor only traffic belonging to certain Virtual

Circuits (VCs) on a link. The VCs of interest are identified by their

Logical Channel Number (LCN); up to six filter LCNs may be specified

for each X.25 analyzer session. By using this filter option, the size of the

capture file can be minimized.

The pdisplay program also provides a filtering mechanism to select

events from the capture file by LCN. Both these filtering mechanisms are

independent. The pdisplay program also provides many options for

displaying the captured X.25 or ISDN traffic (see “display” on page 27 for

a detailed description of the display command).

Overview

Data Analyzer Features

Chapter 1 15

Data Analyzer Features

The following list summarizes the features offered by the ACC X.25 data

analyzer.

• Simultaneous monitoring of up to 8 X.25 lines - up to 32 may be

configured

• Line speeds of up to 2Mb/s supported on 8-channel PCI mux cards

• V.35 and RS 232 support

• Capture file size up to 2Gb (depends on the size of HP-UX disk

subsystem)

• Pre-processing filtering by LCN available (up to 6 LCNs)

• Real-time display of X.25 or ISDN events

• Post-processing filtering by LCN number (up to 6 LCNs)

• Review of capture files by event number or range

• X.25 L2 LAP-B header decoding

• X.25 Packet header decoding

• X.25 facilities decoding

• Raw data display in Hex, ASCII, and EBCDIC

• Event number and time-stamp display

See Chapter 3, “Data Analyzer Commands,” on page 25 for detailed

descriptions of how to use the data analyzer commands.

Overview

Data Analyzer Requirements

Chapter 116

Data Analyzer Requirements

The data analyzer requires that the ACC Base System product has been

installed, including at least one ACC Interface card and (if the hardware

is 8-Channel) a selected multiplexer panel.

Chapter 2 17

2 Installing the Data Analyzer

Installing the Data Analyzer

Installing the Analyzer Software

Chapter 218

Installing the Analyzer Software

The data analyzer software is provided with the ACC Base Product,

which comes in SD-UX format.

Installation requires the following general steps:

1. Remove any previous version of the data analyzer software with

swremove.

2. Use swinstall to install the ACC base product (or just the data

analyzer software if ACC base software is already installed).

3. Check /var/adm/sw/swagent.log for any errors during install.

4. Configure the analyzer.

Software Removal

If a previous version of the ACC X.25 Protocol Analyzer product is

already on the target system, remove it before the new software is

installed.

CAUTION It is very important to follow the instructions, provided with the ACC

software that is currently installed in the system, to shut down and

remove that software. This procedure may change between major

releases of the ACC product.

Step 1. Log in to the system as superuser.

Step 2. Terminate the ACC Mux Subsystem by typing:

% zmasterd kill

Step 3. Run swremove to remove the ACC X.25 Protocol Analyzer product.

% swremove

Installing the Data Analyzer

Installing the Analyzer Software

Chapter 2 19

NOTE swremove will fail if any ACC daemon is still active. Terminate any

active ACC daemon indicated in the log file and try again.

Any or all of the ACC related products besides Data Analyzer can be

removed by selecting them and then marking them for removal. (Both

the terminal interface and the GUI interface for swremove behave the

same; only the means for selecting items differs.)

Step 4. Select the items to be removed in the “Software Selection Window” and

mark for removal, using the “Mark for Remove” function under the

“Actions” menu.

When all items are marked, select the “Remove(analysis)” action.

Open “Logfile” to view running status of the removal process, and follow

any screen prompts until the removal process is done.

Software Installation

The ACC Data Analyzer software is read from the HP-UX Application

CD-ROM, in superuser mode, using the swinstall utility. The steps are

shown below.

Step 1. Log in to the system as “root.”

Step 2. Place the media in a local or remote CD-ROM drive.

Step 3. Run swinstall, which behaves the same in the GUI interface as for the

terminal interface. When the “Specify Source” box opens, select “Source

Depot Type” to “Local CDROM,” or for a remote CD-ROM driver, select

for “Network Directory/CDROM” and set “Source Host Name...”. Select

“OK.”

Step 4. Select the ACC Base Product (or the bundle that contains this). If the

ACC Base Product is already installed, you may just select the Analyzer

fileset from the ACC Base Product (hit the [Return] key to step into the

product). Open the “Actions” menu and select “Mark for Install.”

Step 5. When this item has been marked, select “Install (analysis);” select “OK”

and proceed.

Installing the Data Analyzer

Installing the Analyzer Software

Chapter 220

The “Install (analysis)” window allows you to track summary progress of

the installation process. Use the “Logfile” feature to display a detailed

status, which is logged to /var/adm/sw/swagent.log.

Verifying Installation

Check the end of the swinstall log file /var/adm/sw/swagent.log to

ensure that there were no errors during the installation. If errors

occurred, correct the problem and repeat the swremove and swinstall

steps.

The Data Analyzer software contains a sample capture file. This file is

installed into the directory /var/opt/acc/log and is called sample.eve.

This file can be viewed using the pdisplay program. To try this, run

pdisplay from the shell prompt.

If neither the ZCOM subsystem nor the pcapture program are currently

up and running, the following message will be displayed:

$ pdisplay

Bad zinit call, error:ZCOM system is not started up

Bad zopen call, error:Must call ZINIT first

Bad zname call, error:Must call ZINIT first

***** Warning *****

Cannot find primary ZLU of pcapture - pcapture probably not running

Some functions of this program will not be available

***** Warning *****

Cannot get storage offset for label ANLYZR,Error:Must call ZINIT first

Display>

If the ZCOM subsystem is up and running but the pcapture daemon is

not running, the following message will be displayed:

$ pdisplay

***** Warning *****

Cannot find primary ZLU of pcapture - pcapture probably not running

Some functions of this program will not be available

***** Warning *****

Display>

Page is loading ...

HP 11i User manual

HP 11i User manual

Related papers

Other documents