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:

Remove any previous version of the data analyzer software with swremove.
Use swinstall to install the ACC base product (or just the data analyzer software if ACC base software is already installed).
Check /var/adm/sw/swagent.log for any errors during install.
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.

Log in to the system as superuser.
Terminate the ACC Mux Subsystem by typing:
```
% zmasterd kill
```
Run swremove to remove the ACC X.25 Protocol Analyzer product.
```
% swremove 
```
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.)
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.

Log in to the system as “root.”
Place the media in a local or remote CD-ROM drive.
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.”
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.”
When this item has been marked, select “Install (analysis);” select “OK” and proceed.
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 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>

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. (Refer to the “display” and “options” commands in Chapter 3 “Data Analyzer Commands”) After this command has been successfully performed, proceed to the section on “Configuring the Analyzer”.

Display> display /var/opt/acc/log/sample.eve -e 1 4

The following four events will be displayed:

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.25:INCOMING CALL   
            mod8   LCI 1   
            Called addr  46500561
            Calling addr 46500561
 
event   0004 Chan:00        00:00:00.927
      LAPB:INFO    C Addr01 Nr5 Ns0
      X.25:CALL ACCEPTED   
           mod8   LCI 1   
           Called addr  Addr length = 0
           Calling addr Addr length = 0
Total events =251, events displayed =4
Display>

When complete, the Display> prompt reappears. More commands can be entered now, or the program may be terminated by entering exit at the prompt. The program will exit and the shell prompt displayed:

Display> exit
Exit Program
$

Installing the Analyzer Software

Technical documentation

» Table of Contents

» Index

Software Removal

Software Installation

Verifying Installation