    INSTALLATION AND CONFIGURATION INSTRUCTIONS FOR MADGE NETWORKS
    ==============================================================
     SMART 16/4 ISA & PCI RINGNODES UNDER AIX 4.1 ON THE POWERPC
     ===========================================================


February 1996
-------------

Summary
-------

Several types of Madge Smart Ringnode may be used under AIX 4.1 on the  PowerPC.
These are:

    ISA bus:

        Smart 16/4 AT Ringnode
        Smart 16/4 AT Plus Ringnode
        Smart 16/4 ISA Client Ringnode
        Smart 16/4 ISA Client Plus Ringnode
        Smart 16 Ringnode
        Smart 16/4 ISA Client PnP Ringnode

    PCI bus:

        Smart 16/4 PCI (bm) Ringnode

The  driver  for  these ringnodes is called MTOKDD.   The following instructions
describe how to install the driver software and how to  configure the driver for
use.

Notes: (a) Since  AIX  4.1  does  not  include  support  for  ISA  Plug and Play 
           configuration, Smart 16/4 ISA Client PnP Ringnodes  must  be  set  to
           none  Plug  and  Play  mode  using  the  trcfgc  utility found on the
           diskettes shipped with the Ringnode.

       (b) For Smart 16/4 AT Ringnodes and Smart 16/4 ISA Client  Ringnodes  you
           must know what hardware resources the Ringnode has been configured to
           use.   That  is  the "Bus I/O Address", the "Bus Interrupt Level" and
           for AT Ringnodes, the "DMA Level".   These values are set by switches
           on the Ringnode.


0. CREATING AN INSTALLATION DISKETTE
------------------------------------

If  you  have  received  your  Madge driver on an installation diskette then you 
should  skip  this  section  and  proceed directly to section 1.   This  section
describes how to create an installation diskette with the  installation diskette
image file mdgaix41.img from the Madge CD or bulletin board.

To create an installation disk:

    a) Log into your AIX system as "root".

    b) Copy the mdgaix41.img file into the /tmp directory.
 
    c) Place a blank formatted disk 3.5inch diskette in the  diskette driver and
       enter the command

       dd if=/tmp/mdgaix41.img of=/dev/fd0
      
    d) The  diskette  is  now  an  installation disk for your the MTOKDD driver.


1. INSTALLING THE DRIVER SOFTWARE FOR THE FIRST TIME
----------------------------------------------------
 
To install the MTOKDD software run the "smit" utility whilst logged in as "root"
and choose the following sequence of options:

    Software Installation & Maintenance
    Install and Update Software
    Install/Update Selectable Software (Custom Install)
    Install New Software Product at Latest Level

You will then be prompted for the name of the device containing the software  to
be installed.   Ensure  that the MTOKDD installation diskette is in the diskette
drive and enter the text "/dev/fd0"  if  the  diskette is in the first (or only)
drive, or "/dev/fd1" if it is in the second.   After pressing ENTER or selecting
"DO" you will be prompted for the name of the software to  install.   Enter  the
text "all_licensed" (in lower case) and press ENTER or select "DO".  Answer "OK"
to  the  message  asking  you  if you are sure you wish to install the software.

The installation process will now run.  This takes around a minute.

Once the installation process has completed the driver software will  have  been
installed into the correct places in the AIX file system.   However,  the driver
software  will  not  have been configured for use with a Ringnode.   Follow  the
instructions in section 3 to configure the driver.


2. UPGRADING FROM AN EARLIER VERSION OF THE DRIVER
--------------------------------------------------

2.1 DE-CONFIGURING THE EXISTING DRIVER
--------------------------------------
 
Before installing the new software you must de-configure your  existing  driver.
First  terminate  any  applications  you  may  have  running  that use any Madge
Ringnodes.   Second use the following command to find out the name of your Madge
Ringnode devices:

    lsdev -C | more

You will see a list of device names in the left hand column and  descriptions in
the right hand column.  There should be an entry for one or more Madge Ringnodes
with device names "tok0", "tok1", "tok2" etc.

Stop  the  TCP/IP  stack from using any Madge Ringnodes by entering the command:

    ifconfig XXX detach

for each ringnode. "XXX" is "tr0" for a ringnode with device name "tok0",  "tr1"
for a ringnode with device name "tok1" and so on.

Thirdly stop any other protocol stacks from  using  any  Madge  Ringnodes.   For
example,  if  you  have  a  DLC  interface  installed  you should remove any DLC
bindings to your Madge Ringnodes.   (This  may  be done from the Devices menu in
"smit".)

Finally de-configure any Madge Ringnodes with the command:

    rmdev -l YYY -d

for each ringnode. "YYY" are the Madge Ringnode device names e.g. "tok0", "tok1"
etc.


2.2 INSTALLING THE NEW DRIVER SOFTWARE
--------------------------------------

To update the MTOKDD software run the "smit" utility whilst logged in  as "root"
and choose the following sequence of options:

    Software Installation & Maintenance
    Install and Update Software
    Install/Update Selectable Software (Custom Install)
    Update Currently Installed Software to Latest Level

You will then be prompted for the name of the device containing the  software to
be installed.   Ensure  that the MTOKDD installation diskette is in the diskette
drive  and  enter  the text "/dev/fd0" if the diskette is in the first (or only)
drive, or "/dev/fd1" if it is in the second.   After pressing ENTER or selecting
"DO"  you will be prompted for the name of the software to install.   Enter  the
text "_update_all" (in lower case) and press ENTER or select "DO".   Answer "OK"
to  the  message  asking  you  if you are sure you wish to install the software.

The installation process will now run. This takes around a minute.

Once the installation process has completed the driver software will  have  been
installed into the correct places in the AIX file system.  However,  the  driver
software  will  not  have been configured for use with an adapter.   Follow  the
instructions in section 3 to configure the driver.


3. CONFIGURING THE DRIVER
-------------------------

The driver software is now installed but the driver has not been  configured  to
work with any Madge Ringnodes.  That is the driver does not known what slots the
ringnodes are in or what their memory requirements are.

    BEFORE  PROCEEDING  ENSURE  THAT  YOUR  MADGE  RINGNODE(S)  ARE   PHYSICALLY
    INSTALLED IN YOUR WORKSTATION AND THAT THE LOBE CABLE(S) IS(ARE) PLUGGED IN.
    IF THIS NOTE THE CASE SHUTDOWN  YOUR WORKSTATION AND INSTALL THE RINGNODE(S)
    AND  PLUG  IN  THE  LOBE  CABLE(S) BEFORE PROCEEDING. OTHERWISE THE RINGNODE
    DRIVER WILL NOT BE PROPERLY CONFIGURED.


3.1 SETTING RESOURCES FOR ISA BUS RINGNODES
-------------------------------------------

If you have a PCI bus Ringnode then proceed to section 3.2.

Unlike  PCI  bus  devices,  ISA  bus  devices do not automatically tell AIX what
hardware resources they require;  so you must tell AIX.   There  are two ways to
do this. You can either configure MTOKDD manually or use a utility provided with
MTOKDD to configure MTOKDD for you.  For the older Ringondes with switches, i.e.
the Smart 16/4 AT Ringnode and Smart 16/4 ISA Client Ringnode,  MTOKDD  must  be
configured manually.

3.1.1 Automatic Configuration
-----------------------------

In "smit" choose the following sequence of options:

    Devices
    ISA Adapters
    List Unused Madge Smart ISA Ringnodes

"smit"  will  invoke  a utility that lists all of the unused Madge ISA Ringnodes 
present  (Ringnodes  may  be omitted if their bus I/O addresses clash with other
devices in use in the computer).  MTOKDD can be configured automatically for any
Ringnode that is not marked as "** CANNOT AUTOMATICALLY INSTALL".

To  automatically  configure MTOKDD for a Ringnode select the following sequence
of options in "smit":

    Devices
    ISA Adapters
    Automatically Add a Madge Smart ISA Ringnode

After  a  short  pause  a  form  will  appear  with a single field.   This field 
specifies  for which of the Madge ISA Ringnodes present in the  computer  MTOKDD
should be configured.  To select a Ringnode click on the "List" button (or press
F4 in character mode "smit") and pick a Ringnode from the list.  Now press ENTER
or  select  DO  and  MTOKDD  will  automatically  be configured for the selected
Ringnode.

Once you have completed this step proceed to section 3.2.

3.1.2 Manual Configuration
--------------------------

To  manually  configure  MTOKDD  for  a  Madge ISA Ringnode choose the following
sequence of options in "smit".

    Devices
    ISA Adapters
    Add an ISA Adapter

You  will  be  presented  with a list of the ISA bus adapters for which a device
driver may be configured.  Choose the appropriate Madge Ringnode.  AIX will then
ask you to confirm the location of the device.   After a short pause you will be
presented with a form  describing  how MTOKDD thinks the Ringnode is configured.
Ensure that the values match the real configuration of the Ringnode.   The  most
important values are "Bus I/O Address", "Bus Interrupt Level", and  if  you have
an AT or AT Plus Ringnode, "DMA Level".  A descripton of the values on this form
can be found in section 6.  Finally press ENTER or select "DO".

It  is  possible  that  "smit" may display an error message indicating that your
Ringnode wants to use a hardware resource that another  device is already using.
If this is the case then leave smit, change  the  configuration of your Ringnode
with its switches or using trcfgc and repeat this step.

Once you have completed this step proceed to section 3.2.


3.2 COMMON CONFIGURATION
------------------------

To  configure  you  Madge Ringnode for use by a communications stack perform the
following.  Select the following sequence of options in "smit":

    Devices
    Configure Devices Added After IPL

The  driver  configuration process will now run.   Once  this has completed your 
ringnode driver will be configured to work with your Madge Ringnodes.

If you wish to start the TCP/IP stack select the following  sequence  of  "smit"
options:

    Communications Applications and Services
    TCP/IP
    Minimum Configuration & Startup

From  the  list  of  options  that  is  displayed  choose  one of the token ring
interfaces.   You  will  now  be  prompted to fill in various details about your
workstation such as its internet address and network mask.   Please  consult the
IBM  AIX  documentation  and/or  your  system administrator about these details.


4. REMOVING A MADGE RINGNODE
----------------------------

Before  removing  a  Madge  Ringnode  you  should  carry out the instructions in 
section 2.1 to de-configure the driver.


5. MOVING A MADGE RINGNODE
--------------------------

If  you  need  to  move  a  Madge  Ringnode  to  a  different slot carry out the 
instructions in section 2.1 to de-configure the driver.  Shutdown and power-down
your workstation.  Move the ringnode.  Re-start your workstation and then follow
the instructions in section 3 to configure the driver.


6. CHANGING THE CHARACTERISTICS OF THE RINGNODE DRIVER
------------------------------------------------------

There  are  various  characteristics  of  your Madge Ringnode driver that may be
changed such as its node address and maximum frame size.  These  characteristics
may be changed by running "smit".  First, however, any applications that use the
ringnode  must  be  terminated  and  the  TCP/IP stack must be stopped using the
"ifconfig XXX detach" command (see section 2.1 -  but  do  NOT  de-configure the
device with "rmdev").

Whilst  logged  in  as  "root"  run  "smit" and select the following sequence of
options:

    Devices
    Communications
    Token Ring
    Adapter
    Change / Show Characteristics of a Token Ring Adapter

From the list of Token Ring devices that is displayed choose the Madge  Ringnode
of which you wish to change the characteristics.  "smit"  will  then  display  a
form containing the various characteristics.  The values that may be changed are
described below:

    Bus I/O Address

                         This  is  the  I/O  address  at  which your Ringnode is 
                         configured.  For ISA bus devices every device must have
                         a unique bus I/O address.

    Bus Interrupt Level

                         This  is  the  interrupt  level used by the Ringnode to
                         request attention for the  workstation.   For  ISA  bus
                         devices every device must have a unqiue  bus  interrupt
                         level.

    DMA Level  

                         If an ISA bus Ringnode can perform bus master  DMA  (AT
                         and  AT  Plus  Ringnodes)  then  it  must be assigned a 
                         unqiue DMA channel to communicate with the workstation.

    Transfer Type

                         Madge  Ringnodes  support  one or both of two  transfer 
                         modes.  DMA uses special hardware to allow the Ringnode
                         to   access   the  workstation's  memory  without   the
                         workstation  CPU  being   involved.    PIO   uses   the
                         workstation  CPU  to  transfer  data  to  and  from the 
                         Ringnode.   Unless  you  experience   problems  it   is
                         recomended  that  you use DMA if your Ringnode supports
                         it.

    Transmit/Receive Pipeline Slots

                         The high performance FastMAC Plus software that runs on
                         your Madge Ringnode uses a  number of slots to pipeline
                         transmission and receipt of frames.  The default values
                         have been chosen to give best results under normal use.
                         If  you  have  a  heavily loaded server you may wish to
                         increase these values.

    Maximum Frame Size  
   
                         This  is  the maximum size of frames that the  Ringnode
                         will send or receive.  The allowable  range  is 1024 to
                         17839 bytes for most  Ringnodes  and 1024 to 8192 bytes
                         for the Client Ringnodes.   The  default value is 2048.
                         Only  increase  the maximum frame size if you  need  to
                         since  doing  so  increases  the  amount of memory that
                         MTOKDD needs for buffer space.

    Transmit Queue Size  

                         This is the number of frames that MTOKDD can  queue for
                         transmission.

    Ring Speed          
   
                         This is the speed at which your token ring is  running.
                         It may be 4 or 16 (MBit/s).   Check  with  your  system
                         administrator for the correct value.

    Receive Attention MAC Frames
    Receive Beacon MAC Frames
  
                         These  characteristics  control  whether  attention and
                         beacon  MAC  frames  are  passed  up  to  users  of the 
                         ringnode driver.  Unless your  application specifically
                         requires  these  frames these characteristics should be
                         left at the default value of "no".

    Enable Alternate Token Ring Address

                         This  characteristics  controls  whether  an  alternate 
                         token  ring  address  should  be  used.   Normally  the 
                         Ringnode uses a token ring  address that is stored on a
                         ROM  on  the Ringnode.   Setting this characteristic to
                         "yes"  means  that  the  ringnode   will   the  address 
                         specified  in  the   Alternate   Token   Ring   address 
                         characteristic.

    Alternate Token Ring Address

                         This characteristic contains the alternative token ring
                         address.   This  should  be  a twelve digit hexidecimal
                         number with the leading digit in the range 4 to 7. e.g.
                         0x40001234abcd.   The alternate token ring  address  is
                         sometimes  called  a  "locally  administered  address".

    Apply Changes to Database Only

                         Normally any changes you make to MTOKDD's 
                         characteristics will be applied to MTOKDD  immediately;
                         which is why there must not be  any  applications using
                         the Ringnode.   However  if you set this characteristic
                         to  "yes"  the  changes  will  only  be  made  to   the 
                         configuration database.   This  means  that the changes
                         will not come into effect until  the  machine  is  next
                         shutdown and re-started.

Once you have made any changes you require press ENTER or select "DO".  You  can
now re-start the TCP/IP stack.

7. TROUBLE SHOOTING
-------------------
 
If  your  Madge  Ringnode fails to work correctly an error message may have been 
written into a file called "/tmp/mtokdd.log".   To  view  this  file  enter  the
command:

    cat /tmp/mtokdd.log


Copyright (c) Madge Networks Ltd 1996

**** End of MTOKDD.INF ****
