ACC X.25 Data Analyzer User’s Guide Edition 1 HP 9000 Networking Manufacturing Part Number : Z7345-90004 E0204 © Copyright 2004 Hewlett-Packard Company.
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.
This software is based in part on the Fourth Berkeley Software Distribution under license from the Regents of the University of California. ©copyright 1980, 1984, 1986 Novell, Inc. ©copyright 1986-1992 Sun Microsystems, Inc. ©copyright 1985-86, 1988 Massachusetts Institute of Technology. ©copyright 1989-93 The Open Software Foundation, Inc. ©copyright 1986 Digital Equipment Corporation. ©copyright 1990 Motorola, Inc.
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.
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.
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 • • • • • • • • • • • • • 8 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.
Contents 1. Overview Data Analyzer Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Data Analyzer Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Data Analyzer Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 2. Installing the Data Analyzer Installing the Analyzer Software . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . runc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
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 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.
Overview Data Analyzer Overview Figure 1-1 Overview of ACC based Data Analyzer 8 port PCI & mux card(s) Uses software access only Configuration information Capture / Filter Daemon runc pcapture Data capture File(s) Commands to Filter Display / Control Program Analyzer Application Software Chapter 1 13
Overview Data Analyzer Overview 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.
Overview Data Analyzer Features 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.
Overview Data Analyzer Requirements 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.
2 Chapter 2 Installing the Data Analyzer 17
Installing the Data Analyzer Installing the Analyzer Software 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.
Installing the Data Analyzer Installing the Analyzer Software 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.
Installing the Data Analyzer Installing the Analyzer Software 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.
Installing the Data Analyzer Installing the Analyzer Software However, the prompt Display> indicates that pdisplay is ready for interactive commands, and you can still use it for this installation verification procedure. Use help or ?? to display the possible commands. The next command (see below) will display the first four events in the sample capture file. Here the option “-e 1 4” selects the first four events.
Installing the Data Analyzer Installing the Analyzer Software When complete, the Display> prompt reappears. More commands can be entered now, or the program may be terminated by entering exit at the prompt.
Installing the Data Analyzer Configuring the Analyzer Configuring the Analyzer The analyzer can be configured dynamically, as needed, and this is the recommended method. The analyzer is configured dynamically by the following steps: • For 8-Channel EISA or NIO multiplexers connect an analyzer cable. • Start the ACC subsystem with the daemon pcapture running (this can be added to the zmasterd_list configuration file). • Use pdisplay to configure (use the runc command), start and stop the analyzer.
Installing the Data Analyzer Configuring the Analyzer For example, you can set-up and run the analyzer on the first two ports of the first 8-Channel multiplexer card in the ACC subsystem by entering the runc command as follows: Display> runc 0 0 All of the options that are applicable to the run command also apply to the runc command. See the entry for the runc command on page 37. NOTE 24 For the 4-port cards and Z7340A 8-port PCI card, all channels can be monitored.
3 Data Analyzer Commands This chapter describes each of the pdisplay program commands. Each command is described in detail and followed by example of use of the command.
Data Analyzer Commands Detailed Command Descriptions Detailed Command Descriptions The following sections describes each of the pdisplay program commands. Each command is described in detail and followed by example of use of the command. The following list shows all of the commands available. 26 display Display capture (.
Data Analyzer Commands display display The display command displays the contents of the capture file (.eve) to the screen or to standard out. Format display filename [-f] [-o opts] [-e e1 [e2]] [-l lcn#1 ...] Description The display command options have the following meanings: Chapter 3 -f Follow the end of the file (i.e. wait and display data as it arrives). -o Set the display options (see the options command for details of option setting).
Data Analyzer Commands display Example The following example demonstrates usage for this command. NOTE See “Typical X.25 and Data Analyzer Sessions” on page 53 for examples of both X.25 and ISDN analyzer sessions. Display> display x25bc.eve -e 1 3 event 0001 Chan:00 00:00:00.000 lead status: RS DTR CS DSR CD event 0002 Chan:00 00:00:00.788 LAPB:INFO C Addr01 Nr4 Ns7 X.25:CALL REQUEST mod8 LCI 20 Called addr 46500561 Calling addr 46500561 event 0003 Chan:00 00:00:00.917 LAPB:INFO C Addr03 Nr0 Ns4 X.
Data Analyzer Commands display X.
Data Analyzer Commands exit exit The exit command is used to exit from pdisplay. Note that when pdisplay is exited, any analyzer sessions that have been previously started will continue to run even after pdisplay has stopped. To stop the analyzer sessions use the stop command.
Data Analyzer Commands help help help displays help information on available commands, and details on each of the commands. Format ?? [command] or: ? [command] or: help [command] Examples Display> ?? Help table Command ?, ?? help show shutdown run stop runc stopd display options protocol exit /e - Description ...........
Data Analyzer Commands options options The options command shows or sets the display options. Format options [set ] or: options [show] or: options [default] Description The options command sets the display options for subsequent display or run commands. Once set, the options remain in effect until altered, or until pdisplay is restarted. The following options are available: 32 a Display raw data in ASCII8. b Display raw data in EBCDIC.
Data Analyzer Commands options z/Z Turn off/ON Level 4 raw display (s/S option gives raw mode). To change the option setting use the set parameter followed by one or more of the letters in the table above; for example, the command below turns off the event and timestamp display, enables the Level 4 raw data display, and turns on the Modem control lead change display. Display> options set eZL To show the current option setting, use just the options command by itself or use the show parameter.
Data Analyzer Commands protocol protocol The protocol command Selects Level 2/Level 3 protocols for display of analyzer trace data. Format protocol l2 lap/lapb/lapbe/lapd/hdlc/sdlc l3 x25/q931 Description Entering the protocol command without arguments displays the current Level 2 and Level 3 protocol selection. This command lets you specify a level 2 or level 3 protocol for analysis and display. It is usually followed by use of the run, runc or display command.
Data Analyzer Commands run run The run command starts the analyzer on a specified pair of ZLUs. Format run ZLU [-n filename] [-s filesize] [-l lcn#1 ..] -o {opts] -f Description The run command starts the analyzer running on a specified ZLU. It will automatically find the associated partner ZLU so that the correct DCE and DTE ZLUs are started together. Chapter 3 -n Specify the capture file. If not given it will be defaulted to /var/opt/acc/log/anz_ZLU.
Data Analyzer Commands run -p Specify level 2 or level 3 protocol for analysis and trace display. See the protocol command for specific details on format for option -p. Examples To start the analyzer on ZLUs 19 and 20 use the command: run 19 The command run 20 would have the same effect. In this example the default file name would be /var/opt/acc/log/anz_19.eve. If run 20 had been used the file name would have been /var/opt/acc/log/anz_20.eve, but the data captured would have been the same.
Data Analyzer Commands runc runc The command runc creates a pair of analyzer ZLUs using the specified interface card, port and subchannel, and runs the analyzer on these ZLUs. Format runc card port [subch] [-dce | dte] [] Description For cards which support subchannelling (T1/E1 cards for example) the subchannel number is mandatory.
Data Analyzer Commands show show This command displays all the ZLUs configured in the ACC Mux system. Format show Description The show command shows the mode, state, and file information for each ZLU. For example: Display> show ZLU.# MX 19 02 2 20 02 3 21 02 4 22 02 5 23 02 6 24 02 7 P Sub Typ AZLU# Mode Stat LC.M size 000 DTE 20 Halt Stop None 508 000 DCE 19 Halt Stop None 508 000 DTE 22 Halt Run None 256 000 DCE 21 Halt Run None 256 000 DTE 24 Halt Stop None 0 000 DCE 23 Halt Stop None 0 Filename....
Data Analyzer Commands show Chapter 3 AZLU This is the partner ZLU, which should also appear in the display. The partner ZLU must be a different type (DCE if this ZLU is a DTE, and DTE if DCE). Mode The mode field gives the action that pcapture takes when the capture file is full. It may be Halt or Wrap. If Halt is indicated then the analyzer will halt when the file is full; if Wrap is indicated then the file will be overwritten with new data.
Data Analyzer Commands shutdown shutdown The shutdown command shuts down the pcapture program. Format shutdown Description This command is used to cleanly shut down the pcapture program. When this command is invoked pdisplay will prompt to ensure that the shutdown is to proceed. If this question is answered with a “y” then a message is sent to pcapture to shut it down. The pcapture program will then shut down all current analyzer traces, close all analyzer files, and then shut itself down and exit.
Data Analyzer Commands stop stop The stop command stops the analyzer on a specified pair of ZLUs.: Format stop ZLU Description This command stops the analyzer running on the ZLU specified and its partner ZLU. It shuts down the two ZLUs and closes the capture file. To stop the analyzer on ZLU 19 and 20, use the stop 19 command; The command stop 20 has the same effect.
Data Analyzer Commands stopd stopd The stopd command stops the analyzer and deletes the analyzer ZLUs in use provided that they were dynamically configured by previous use of the runc command. Format stopd card port [subchannel] Description This command stops the protocol analyzer on the specified card, port and (if an applicable card type is in use) subchannel. pdisplay then deletes the corresponding pair of analyzer ZLUs.
A Appendix A Network Configuration 43
Network Configuration Setting Up the Network Configuration File Setting Up the Network Configuration File The first step is to configure the analyzer ports into the ttgen configuration file. A sample file is supplied with the product to illustrate how the configuration should be done. This file is called /opt/acc/cfg/x25an_sample.answ, or x25an_4ch_sample.answ. A full listing of these files is given at the end of this appendix.
Network Configuration Setting Up the Network Configuration File Port Definitions Each port on each multiplexer card to be used for the Data Analyzer must be correctly configured to support the Frame capture firmware protocol. Note the following configuration requirements: • Select the correct mux and port for each analyzer connection. • Set RS232 mode for both RS-232 and V.35 analyzer ports. • The baud rate is not important but set for an expected nominal rate (57600 chosen here).
Network Configuration Setting Up the Network Configuration File Follow the steps below to configure the ZLUs, refer to the examples above for clarification. In the example, ZLUs 19 and 20 form an analyzer pair, so do 21 and 22, and 23 and 24. • Choose ZLU numbers for each of the analyzer ports so they are unique within the whole ttgen configuration file. • Note the ZLU numbers for each analyzer pair; there should always be an even number of analyzer ZLUs.
Network Configuration Setting Up the Network Configuration File $ ttgen -o /opt/acc/cfg/x25an_sample.answ \ /opt/acc/cfg/x25an_sample.tmem Here the -o option allows a previous copy of the output file /opt/acc/cfg/x25an_sample.tmem to be overwritten if it already exists. If there are inconsistencies in the configuration file, ttgen may report errors or warnings. These should be corrected and ttgen rerun until it runs without error.
Network Configuration Setting Up the Network Configuration File Pcapture runs as a daemon and reports its errors to the ACC Mux message file. If pcapture is not running correctly, look at the end of the daily ACC Mux log file, or on the system console if console logging has been enabled for ACC Mux. The log file name depends on the day of the week (i.e., /var/opt/acc/log/mon.tlog is Monday’s file). To look at the end of this file: $ tail -20 /var/opt/acc/log/mon.
Network Configuration Setting Up the Network Configuration File $pdisplay options Current option settings Level 2 Decode header: Display raw data: Yes u/U No v/V Display Event# & time (e/E) No Display Lead changes (l/L) Yes Raw data display (see below) Level 3 Decode header: Yes w/W ASCII8 Raw data single or full (s/S) Single Decode facilities: Yes x/X Display raw data No y/Y Exit program $ This method may be used to save the display output from a capture file to a file, or to pipe the output to
Network Configuration Sample Network Configuration File Sample Network Configuration File The sample network configuration file (ttgen configuration file) supplied with the product is shown below. The file is installed in /opt/acc/cfg/x25an_sample.answ when swinstall is run.
Network Configuration Sample Network Configuration File Terminal-Definition Term 0017 0:0 X25.LAPB option 30h * no_autostart last_pvc 0 first_insvc 0 last_insvc 0 first_svc 1 last_svc 3 first_outsvc 0 last_outsvc 0 def_inpacket 8 def_outpacket 8 Term 0500 0:0 x25.svc.io Repeat Term 0531 0:1 x25.svc.io Term Term Term Term Term Term ”Level.2 DCE” 0000h 0000h 99 0 0 0 0 ”Level.3 SVC in” 8009H 43EAH 10 0 0 0 0 ”Level.2 DTE” 2 Term 0018 0:1 X25.
Network Configuration Sample Network Configuration File 52 Appendix A
B Appendix B Typical X.
Typical X.25 and Data Analyzer Sessions Introduction Introduction This section provides the results of actual Data Analyzer sessions that were run using this software. The sessions were run on an 8-Channel multiplexer. Because the 8-Channel multiplexer was not designed to provide ISDN service, only an X.25 session is described for this product.