### TechNote

Number:06801-07
Date:September 1994

## Madge driver support for SCO UNIX workstations

This document describes how to install or update the Madge driver for SCO UNIX workstations.

The Madge driver for version 2.0 and higher of the SCO (Santa Cruz Operation) Unix System V Release 3.2 Operating System is called mtok. This driver supports all Smart 16/4 Ringnodes. It is available on request from Madge either on disk (part number: 87-00) or from the Bulletin Board System.

Note

You cannot install the mtok driver as part of the SCO Open Desktop/Server/Server Enterprise installation process. Install SCO first, and then follow the instructions in this TechNote.

The driver (called tok), which can be specified during the Open Desktop installation process, is a driver for IBM Token-Ring adapters. If you install this by mistake, you can remove it using the Remove Chain option of the netconfig utility.

### 1 Installing or updating the SCO driver from the Madge BBS

This section tells you how to create an installation disk by using the mtoklli.img and makedisk files. These are the files that are generated when you "un-zip" the mtoklli.zip file from the BBS.

1. Using the DOS computer that you downloaded mtoklli.zip onto, copy the mtoklli.img and makedisk files onto a floppy disk.

2. Log into your SCO UNIX system as "root".

3. Use the doscp program to copy mtoklli.img and makedisk into the "/tmp" directory on your SCO UNIX system. To do this, type:

       cd /tmp
       doscp A:MTOKLLI.IMG mtoklli.img
       doscp A:MAKEDISK makedisk

4. Place a blank, formatted, 3.5inch disk in drive A: and type sh makedisk (if you are using the Korn shell, type: ksh makedisk) and follow the instructions on the screen.

5. The disk in drive A: is now an installation disk for your Madge LLI driver. Proceed to Section 3.

### 2 Installing or updating the SCO driver from a Madge floppy disk

1. Boot your computer into single-user mode.

2. Run the custom utility.

   For a description of how to use the custom utility to install additional software, refer to the SCO Open Desktop Installation Guide or the SCO Unix Operating System Installation Guide.

   Select Install. Choose A New Product. Select the Entire Product option. Insert the floppy disk containing mtok using the instructions on your screen.

3. The custom utility installs the files from the floppy disk and executes an installation script. This asks you whether you wish to configure the driver (under netconfig) now or later. If you elect to configure the driver now, you must already have installed the higher-level protocols (for example, TCP/IP, OSI, or LMX). If you have not installed these yet, exit at this point, and configure the mtok driver after you have installed them. You can configure the driver at any time using the netconfig command. When you do this, it is best if you are in single-user mode.

4. Proceed to Section 3.

### 3 Configuring the SCO driver using netconfig

1. Run netconfig. When you configure the driver using netconfig, the options you have are to add, remove, or reconfigure a chain.

   When you add a chain that ends with the driver you are installing (and you have not configured the driver before), or when you configure the driver part of a chain, the program prompts you for certain pieces of information. You need to know:

   - The type of Ringnode you are installing the driver for. The Smart 16/4 MC32 Ringnode is covered by the MC option.

   - The I/O location that your Ringnode is using (or the slot number, if you are configuring the driver for the Smart 16/4 EISA Ringnode).

   - The DMA channel that your Ringnode is using. This applies to Smart 16/4 AT Ringnodes only. If you specify none, the Ringnode uses PIO mode.

   - The IRQ number that your Ringnode is using.

   Caution

   Use IRQ 10 (or another alternative) for your Smart 16/4 Ringnode. IRQ 15 (the default) conflicts with the setting that is reserved by SCO for the Adaptec SCSI Adapter. This is so even if you do not have an Adaptec SCSI Adapter installed.

2. When you have finished configuring the various chains, relink the kernel. You can do this either by accepting netconfig's offer to do it for you, or by typing the following command at the prompt:

   `/etc/conf/cf.d/link_unix -y`

### 4 Setting a maximum frame size for your Ringnode

On your network you may have bridges, routers, or IBM adapters that cannot accept large frames. If so, you may want to set a maximum frame size for your Ringnode that is lower than the maximum frame size supported by your network. To set a maximum frame size for your Ringnode, perform the following:

1. Configure the driver using netconfig.

2. Go to the directory in the kernel link kit where the mtok driver is kept, by typing:

   `cd /etc/conf/pack.d/mtok0`

3. Edit the file space.c by substituting the maximum frame size you require for the string: MAX_16MB_FRAME_SIZE. You only need to make this change to one line. The line is similar to the following:

   `nusigned int mtok_frame_size_limit = MAX_16MB_FRAME_SIZE;`

   The following example sets the maximum frame size to 2048 bytes:

   `unsigned int mtok_frame_size_limit = 2048;`

4. Relink the kernel by typing:

   `/etc/conf/cf.d/link_unix -y`

5. If you want to make this change permanent, edit the mtok_frame_size_limit definition in the following file to reflect your amendment to the space.c file:

   `/usr/lib/lli/mtok/Space.c`