(Page 1 of 1 in this chapter)


Chapter 4

Verifying the Installation


4.1 Introduction
4.2 Windows NT
4.2.1 The tx2diag and tx3diag Utilities 34
4.2.2 The cpcon Utility 36
4.3 UnixWare 2.x
4.3.1 TX 2000/TX 3000 Board Statistics 38
4.3.2 The tx2diag and tx3diag Utilities 40
4.3.3 The cpcon Utility 42
4.4 Solaris x86
4.4.1 TX 2000/TX 3000 Board Statistics 44
4.4.2 The tx2diag and tx3diag Utilities 46
4.4.3 The cpcon Utility 48

4.1 Introduction

This chapter lists the procedures to verify that your TX 2000/TX 3000 board is installed and configured properly.

4.2 Windows NT

After you have installed the TX hardware/software and rebooted your system, you can verify the installation is successful with the following steps:

  1. Using Event Viewer (usually found in the Start menu under Programs/Administrative Tools), you can verify that the TXn000 device driver has successfully located the installed TX board.

    
    In the Event Viewer system log, you will see one or more messages from the following source:
         TxNtPktD
    
    

4.2.1 The tx2diag and tx3diag Utilities

The tx2diag and tx3diag programs are diagnostic utilities for the TX 2000 and TX 3000 boards, respectively. When run, the tx2diag and tx3diag programs perform a very thorough test of the TX hardware selected. These programs are located in \tektx\soft\util and must be run from this directory

To run the tx2diag or tx3diag utility, perform the following steps:

  1. From a DOS prompt, navigate to the \tektx\soft\util directory and type:

tx2diag (if you are using a TX 2000 board)

or

tx3diag (if you are using a TX 3000 board).

The following options are available:

CP # <ENTER> Only the CP indicated in the CP # parameter will be diagnosed.

<ENTER> All available CPs will be diagnosed.

other key <ENTER> Typing any other key and pressing enter will abort the test and shut down the utility.

  1. tx2diag/tx3diag will run a series of tests to check the status of the EEPROM, the memory on the board, the 68360 processors, and the NMI (Non-maskable Interrupt).

    
    tx2diag/tx3diag will either report a success or failure after each test. When the last test has finished, you can check the results of each test by scrolling up.
  2. Press <ENTER> to close the utility.

    
     

4.2.2 The cpcon Utility

The cpcon utility displays detailed information on the TX software that is used to configure and communicate with the TX 2000/TX 3000 board. It is located in the \tektx\soft\util\ directory.

To run the cpcon utility, type:

cpcon

The following table lists the available commands, as well as a description of each:
Command

Description

help

Shows the full command set OR details of a specified command.

tasks

Shows all tasks that have been created.

mem

Show total amount of memory in use and available.

memreg

Shows assignments for all memory regions.

tmem

Shows all memory regions assigned to the specified task.

pmem

Shows the percentage of memory assigned to each task.

timers

Shows all timers that exist on the system.

util

Shows the current and average system utilization.

kernel

Shows information from the main KERNEL control structure.

vol

Shows all volumes - mounted tasks (I/O/ aaccessible)

lfd

Shows a list of all open files (Logical File Descriptors).

time

Shows the current time (as viewed by the CP).

date

Shows the current date (as viewed by the CP).

ques

Shows the list of priority queues (tasks waiting to execute).

log

· Shows the KERNEL error log.

· Shows the KERNEL debug log.

mvip

Shows all current MVIP stream/timeslot assignments.

t1cfg

Shows the T1/E1 configuration.

t1stat

Shows T1/E1 statistics information.

scc

Shows information for each serial communications controller.

vports

Shows all virtual ports currently defined.

res

Shows all resources currently defined.

resdet

Shows all resources currently defined.

if

Shows all interfaces currently defined.

q32

Shows information about each 360 operating in QUICC32 mode.

names

Shows all named objects defined in the system.

dump

Displays a hex/ASCII dump of the memory address specified.

Type quit to exit the cpcon utility.

4.3 UnixWare 2.x

If you are experiencing problems communicating with a TX 2000/TX 3000 board after installing the TX hardware and software, try rebooting your system and watching for the driver initialization message from the TX Series driver. This is one of the first messages displayed and goes by fast. The initialization message can indicate whether or not the TX 2000/TX 3000 board(s) and driver are installed correctly.

Successful Installation

For each board that is installed and configured, you should see a message similar to the following:

NMS TXn000 Driver Unit(0) V(202) irq(10) addr(0x000cc000)


 Unsuccessful Installation

An unsuccessful installation will result in a message similar to this:

TXn000 driver no board for unit(0)


This indicates that the Dual Port RAM driver has not recognized the TX 2000/TX 3000 board on the bus at the specified memory location.

Possible explanations:

Recheck the board switch settings. If they are correct, check the current configured value by looking at the contents of the file /etc/conf/sdevice.d/tx2.

The file looks similar to this:

tx2 Y 0 5 1 10 0 0 cc000 cdfff -1 0

In this example, the sixth column 10 indicates the IRQ setting and the ninth column cc000 indicates the Dual Port RAM address.

These two values must agree with the switch settings on the TX 2000/TX 3000 board. If the driver needs to be reconfigured:

  1. Use txninst to delete the driver and then add it back in with the new configuration values.

    
    Note:	 Do not edit /etc/conf/sdevice.d/tx2 directly; the changes will not take effect, even if the kernel has been rebuilt. If you are interested in the details of how this configuration is handled, you can examine the txninst script, which may be found in the /usr/bin directory.

4.3.1 TX 2000/TX 3000 Board Statistics

The cputil utility, found in the /usr/bin/ directory, can be used to access a TX 2000/TX 3000 board's statistics. This can be useful in troubleshooting problems with a TX board.

  1. As root, at the command prompt type:

cputil -b 1 -R

This command will reset board number 1.

  • Type:

    
    
    cputil -b 1 -C

    This command clears the statistics counters for board 1.

    
     

  • Type:

    
    
    cputil -b 1 -S

    This is an example of the output:

    TXN000 board(1) statistics:
    Total Interrupts              [0]
    Transmits Started             [0]
    Receives                      [0]
    OS READY interrupts           [0]
    MSG interrupts                [0]
    MSGACK interrupts             [0]
    RXACK interrupts              [0]
    OS LOAD packet interrupts     [0]
    Stray interrupts              [0]
    Out of State errors           [0]
    Out of Memory errors          [0]
    Messages for Unbound Channel  [0]
    Unknown errors                [0]
    Successful OS runs            [0]
    Unexpected ACK received       [0]
    Unexpected ACK during load    [0]
    
    
    
    1. Next, download the kernel to the board as follows:

    cplot -c 1 -f /usr/lib/txn/cpk2000.lo -k -a

    or

    cplot -c 1 -f /usr/lib/txn/cpk3000.lo -k -a

    depending on whether your TX board is a TX 2000 or a TX 3000. This command produces the following output:

    Loading: 5.5 Txn000 Kernel (c) 1996-1997 Natural
    MicroSystems, Inc. 7/15/98
    Note: If the output hangs after printing the first line or displays an error message, either the driver configuration does not match the IRQ setting on the board, or there may still be a memory conflict with another device. Recheck board settings and driver configuration.

    1. After the kernel download is complete, print the current counter values for the board as follows:

    cputil -b 1 -S

    The following statistics reflect a successful kernel download and communication with the host processor (actual numbers may vary slightly):

    Total Interrupts              [239]
    Transmits Started             [0]
    Receives                      [0]
    OS READY interrupts           [1]
    MSG interrupts                [1]
    MSGACK interrupts             [0]
    RXACK interrupts              [0]
    OS LOAD packet interrupts     [237]
    Stray interrupts              [0]
    Out of State errors           [0]
    Out of Memory errors          [0]
    Messages for Unbound Channel  [1]
    Unknown errors                [0]
    Successful OS runs            [1]
    Unexpected ACK received       [0]
    Unexpected ACK during load    [0]
    
    
    
    The important items to note are the Successful OS runs, which should be 1 after the first kernel download, and OS LOAD packet interrupts, with 237 being a typical value.
  • 4.3.2 The tx2diag and tx3diag Utilities

    The tx2diag and tx3diag programs are diagnostic utilities for the TX 2000 and TX 3000 boards, respectively. When run, the tx2diag and tx3diag programs perform a very thorough test of the TX hardware selected. These programs are located in /tektx/soft/util and must be run from this directory

    To run the tx2diag or tx3diag utility, perform the following steps:

    1. From a UNIX prompt, navigate to the /tektx/soft/util directory and type:

    tx2diag (if you are using a TX 2000 board)

    or

    tx3diag (if you are using a TX 3000 board).

    The following options are available:

    CP # <ENTER> Only the CP indicated in the CP # parameter will be diagnosed.

    <ENTER> All available CPs will be diagnosed.

    other key <ENTER> Typing any other key and pressing enter will abort the test and shut down the utility.

    1. tx2diag/tx3diag will run a series of tests to check the status of the EEPROM, the memory on the board, the 68360 processors, and the NMI (Non-maskable Interrupt).

      
      tx2diag/tx3diag will either report a success or failure after each test. When the last test has finished, you can check the results of each test by scrolling up.
    2. Press <ENTER> to close the utility.

      
       

    4.3.3 The cpcon Utility

    The cpcon utility displays detailed information on the TX software that is used to configure and communicate with the TX 2000/TX 3000 board. It is located in the /tektx/soft/util/ directory.

    To run the cpcon utility, type:

    cpcon

    The following table lists the available commands, as well as a description of each:
    Command

    Description

    help

    Shows the full command set OR details of a specified command.

    tasks

    Shows all tasks that have been created.

    mem

    Show total amount of memory in use and available.

    memreg

    Shows assignments for all memory regions.

    tmem

    Shows all memory regions assigned to the specified task.

    pmem

    Shows the percentage of memory assigned to each task.

    timers

    Shows all timers that exist on the system.

    util

    Shows the current and average system utilization.

    kernel

    Shows information from the main KERNEL control structure.

    vol

    Shows all volumes - mounted tasks (I/O/ aaccessible)

    lfd

    Shows a list of all open files (Logical File Descriptors).

    time

    Shows the current time (as viewed by the CP).

    date

    Shows the current date (as viewed by the CP).

    ques

    Shows the list of priority queues (tasks waiting to execute).

    log

    · Shows the KERNEL error log.

    · Shows the KERNEL debug log.

    mvip

    Shows all current MVIP stream/timeslot assignments.

    t1cfg

    Shows the T1/E1 configuration.

    t1stat

    Shows T1/E1 statistics information.

    scc

    Shows information for each serial communications controller.

    vports

    Shows all virtual ports currently defined.

    res

    Shows all resources currently defined.

    resdet

    Shows all resources currently defined.

    if

    Shows all interfaces currently defined.

    q32

    Shows information about each 360 operating in QUICC32 mode.

    names

    Shows all named objects defined in the system.

    dump

    Displays a hex/ASCII dump of the memory address specified.

    Type quit to exit the cpcon utility.

    4.4 Solaris x86

    If you are experiencing problems communicating with a TX 2000/TX 3000 board after installing the TX hardware and software, try rebooting your system and watching for the driver initialization message from the TX Series driver. This is one of the first messages displayed and goes by fast. The initialization message can indicate whether or not the TX 2000/TX 3000 board(s) and driver are installed correctly.

    Successful Installation

    For each board that is installed and configured, you should see a message similar to the following:

    NMS TXn000 Driver Unit(0) V(202) irq(10) addr(0x000cc000)

    
     Unsuccessful Installation

    An unsuccessful installation will result in a message similar to this:

    TXn000 driver no board for unit(0)

    
    
    This indicates that the Dual Port RAM driver has not recognized the TX 2000/TX 3000 board on the bus at the specified memory location.

    Possible explanations:

    Recheck the board switch settings. If they are correct, check the current configured value by looking at the contents of the file /platform/i86pc/kernel/drv/tx2.conf.

    The file looks similar to this:

    name= "tx2"
    class="sysbus"
    hwtype=1
    cntls=1 minors=16
    reg=0,0Xcc000,8102
    intr=5,10
    shared-interrupts=0
    
    
    In this example, the second number of the reg= line (0Xcc000) indicates the Dual Port RAM address and the second number of the intr= line (10) indicates the IRQ setting.

    These two values must agree with the switch settings on the TX 2000/TX 3000 board. If the driver needs to be reconfigured:

    1. Use txninst to delete the driver and then add it back in with the new configuration values.

      
      Note:	 Do not edit /platform/i86pc/kernel/drv/tx2.conf directly; the changes will not take effect, even if the kernel has been rebuilt. If you are interested in the details of how this configuration is handled, you can examine the txninst script, which may be found in /usr/bin.

    4.4.1 TX 2000/TX 3000 Board Statistics

    The cputil utility found in /usr/bin/ can be used to access a TX 2000/TX 3000 board's statistics. This can be useful in troubleshooting problems with a TX board.

    1. As root, at the command prompt type:

    cputil -b 1 -R

    This command will reset board number 1.

  • Type:

    
    
    cputil -b 1 -C

    This command clears the statistics counters for board 1.

    
     

  • Type:

    
    
    cputil -b 1 -S

    This is an example of the output:

    TXN000 board(1) statistics:
    Total Interrupts             [0]
    Transmits Started            [0]
    Receives                     [0]
    OS READY interrupts          [0]
    MSG interrupts               [0]
    MSGACK interrupts            [0]
    RXACK interrupts             [0]
    OS LOAD packet interrupts    [0]
    Stray interrupts             [0]
    Out of State errors          [0]
    Out of Memory errors         [0]
    Messages for Unbound Channel [0]
    Unknown errors               [0]
    Successful OS runs           [0]
    Unexpected ACK received      [0]
    Unexpected ACK during load   [0]
    
    
    1. Next, download the kernel to the board as follows:

    cplot -c 1 -f /usr/lib/txn/cpk2000.lo -k -a

    or

    cplot -c 1 -f /usr/lib/txn/cpk3000.lo -k -a

    depending on whether your TX board is a TX 2000 or a TX 3000. This command produces the following output:

    Loading: 5.5 Txn000 Kernel (c) 1996-1997 Natural MicroSystems, Inc. 7/15/98
    
    
    Note:	 If the output hangs after printing the first line or displays an error message, either the driver configuration does not match the IRQ setting on the board, or there may still be a memory conflict with another device. Recheck board settings and driver configuration.

    1. After the kernel download is complete, print the current counter values for the board:

    cputil -b 1 -S

    The following statistics reflect a successful kernel download and communication with the host processor (Actual numbers may vary slightly):

    Total Interrupts             [239]
    Transmits Started            [0]
    Receives                     [0]
    OS READY interrupts          [1]
    MSG interrupts               [1]
    MSGACK interrupts            [0]
    RXACK interrupts             [0]
    OS LOAD packet interrupts    [237]
    Stray interrupts             [0]
    Out of State errors          [0]
    Out of Memory errors         [0]
    Messages for Unbound Channel [1]
    Unknown errors               [0]
    Successful OS runs           [1]
    Unexpected ACK received      [0]
    Unexpected ACK during load   [0]
    
    
    The important items to note are the Successful OS runs, which should be 1 after the first kernel download, and OS LOAD packet interrupts, with 237 being a typical value.
  • 4.4.2 The tx2diag and tx3diag Utilities

    The tx2diag and tx3diag programs are diagnostic utilities for the TX 2000 and TX 3000 boards, respectively. When run, the tx2diag and tx3diag programs perform a very thorough test of the TX hardware selected. These programs are located in /tektx/soft/util and must be run from this directory

    To run the tx2diag or tx3diag utility, perform the following steps:

    1. From a UNIX prompt, navigate to the /tektx/soft/util directory and type:

    tx2diag (if you are using a TX 2000 board)

    or

    tx3diag (if you are using a TX 3000 board).

    The following options are available:

    CP # <ENTER> Only the CP indicated in the CP # parameter will be diagnosed.

    <ENTER> All available CPs will be diagnosed.

    other key <ENTER> Typing any other key and pressing enter will abort the test and shut down the utility.

    1. tx2diag/tx3diag will run a series of tests to check the status of the EEPROM, the memory on the board, the 68360 processors, and the NMI (Non-maskable Interrupt).

      
      tx2diag/tx3diag will either report a success or failure after each test. When the last test has finished, you can check the results of each test by scrolling up.
    2. Press <ENTER> to close the utility.

      
       

    4.4.3 The cpcon Utility

    The cpcon utility displays detailed information on the TX software that is used to configure and communicate with the TX 2000/TX 3000 board. It is located in the /tektx/soft/util/ directory.

    To run the cpcon utility, type:

    cpcon

    The following table lists the available commands, as well as a description of each:
    Command

    Description

    help

    Shows the full command set OR details of a specified command.

    tasks

    Shows all tasks that have been created.

    mem

    Show total amount of memory in use and available.

    memreg

    Shows assignments for all memory regions.

    tmem

    Shows all memory regions assigned to the specified task.

    pmem

    Shows the percentage of memory assigned to each task.

    timers

    Shows all timers that exist on the system.

    util

    Shows the current and average system utilization.

    kernel

    Shows information from the main KERNEL control structure.

    vol

    Shows all volumes - mounted tasks (I/O/ aaccessible)

    lfd

    Shows a list of all open files (Logical File Descriptors).

    time

    Shows the current time (as viewed by the CP).

    date

    Shows the current date (as viewed by the CP).

    ques

    Shows the list of priority queues (tasks waiting to execute).

    log

    · Shows the KERNEL error log.

    · Shows the KERNEL debug log.

    mvip

    Shows all current MVIP stream/timeslot assignments.

    t1cfg

    Shows the T1/E1 configuration.

    t1stat

    Shows T1/E1 statistics information.

    scc

    Shows information for each serial communications controller.

    vports

    Shows all virtual ports currently defined.

    res

    Shows all resources currently defined.

    resdet

    Shows all resources currently defined.

    if

    Shows all interfaces currently defined.

    q32

    Shows information about each 360 operating in QUICC32 mode.

    names

    Shows all named objects defined in the system.

    dump

    Displays a hex/ASCII dump of the memory address specified.

    Type quit to exit the cpcon utility.



    (Page 1 of 1 in this chapter)


    tech_support@nmss.com
    Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.