=============================================================================== 1.0 DRIVER DESCRIPTION The CS8900/CS8920 EtherJet Adapter driver for SCO UNIX is a STREAMS-based Logical Link Interface (LLI) driver. 1.2.1 Driver Name: cs 1.2.2 Files in the Driver Package: ./usr/lib/lli/cs/Driver.o - LLI driver object code ./usr/lib/lli/cs/Space.c - LLI driver C code ./usr/lib/lli/cs/Master - configuration file ./usr/lib/lli/cs/Node - configuration file ./usr/lib/lli/cs/System - configuration file ./usr/lib/lli/info/cs0 - netconfig file ./usr/lib/lli/init/cs0 - driver installation script ./usr/lib/lli/remove/cs0 - driver removal script ./usr/lib/lli/reconf/cs0 - driver reconfiguration script ./usr/lib/custom/cs.rmv - custom removal script ./usr/lib/mkdev/cs - mkdev script ./etc/copyrights/08.zeitnet - copyright banner ./usr/lib/lli/cs/cssetup - Installation binary ./etc/rc2.d/S15cs - multiuser mode script ./usr/lib/lli/cs/csgetinfo - multiuser mode binary 2.0 ADAPTER CONFIGURATION =============================================================================== The IBM EtherJet ISA adapters are configured as Plug and Play enabled by default. However, since SCO UNIX is not a PnP compatible operating system, you must boot DOS and run the LANAID Utility to disable PnP and configure the adapter. (The LANAID Utility is a DOS-based applicaiton. It will not run under SCO UNIX.) Failure to do this can prevent the driver from communicating with the adpater. ********************************************************* * NOTE: * * * * YOU MUST RUN THE LANAID UTILITY DISK 2 TO DISABLE * * PnP SUPPORT AND CONFIGURE THE ADAPTER. * * ********************************************************* 3.0 EtherJet LAN(tm) DRIVER INSTALLATION and CONFIGURATION =============================================================================== The following procedure assumes either SCO UNIX Open Desktop 3.0 or Open Server 5.0 have been installed on the target system. If not, do so now. Also, it is assumed you will be using the SCO UNIX 'custom' and 'netconfig' utilities to install and configure the driver and protocol(s). 3.1 Driver Installation Procedure 1.) Configure the EtherJet LAN Ethernet Adapter and boot SCO UNIX in single-user mode. 2.) Place the "EtherJet LAN CS8900/CS8920 SCO UNIX Driver" 'custom' diskette into the floppy drive /dev/fd0 (typically drive A:). Refer to section "4.0 Creating a 'custom' Diskette" if you received the driver package in a tape archive file format (escoisa.tar). 3.) Use the SCO UNIX 'custom" command to install the driver package. Refer to the SCO UNIX installation guides for information on using the 'custom' utility. a.) Start 'custom' and select the option to install new software. b.) Select the option to install from the host system and use floppy drive 0 as the installation media. c.) When prompted for "full" or "partial" installation, select "full" installation. 4.) The driver files will be copied from the floppy to the host system. When installation is complete, "CS8900/CS8920 Ethernet Adapter's LLI driver" should be listed in the list of installed software. 5.) Exit the 'custom' utility and start 'netconfig'. Refer to the SCO UNIX installation guides for information on using the 'netconfig' utility. 6.) Use the 'Add new LAN hardware' option to add the adapter. Select "CS8900/CS8920 Ethernet Adapter driver" when presented the list of supported adapters. 7.) Select the network protocol(s) you want to link to the adapter and configure them as prompted. 8.) Exit 'netconfig' and relink the kernel when prompted. 9.) Reboot and check for error messages as the system boots. Also, take note of the status messages as you enter multi-user mode. You will get an error message if the adapter did not successfully connect to the network. 4.0 BUILDING A 'CUSTOM' DISKETTE =============================================================================== Driver installation using the SCO 'custom' command requires the driver and support files be available in a format expected by the 'custom' utility. If you received the driver package in a tape archive file (escoisa.tar) on a DOS diskette (or you downloaded it from a BBS or Web site to a DOS diskette) use the following procedure to build a 'custom" diskette. 4.1 Custom Diskette Build Procedure 1.) On a SCO UNIX system, make a temporary directory. This example uses the /tmp/cs directory. Type mkdir /tmp/cs 2.) Move to the temporary directory you just created. cd /tmp/cs 3.) Insert the DOS diskette containing the escoisa.tar file in the floppy drive /dev/fd0 (typically the A: drive) and copy escoisa.tar to the temporary directory using the DOS-to-UNIX copy command. doscp a:escoisa.tar . (the . is part of the command) 4.) Extract the driver files from the .tar file. tar -xvf escoisa.tar 5.) Remove the .tar file from the temporary directory. rm escoisa.tar 6.) Place a formatted diskette into /dev/fd0 (drive A:) and type tar -cv . (the . is part of the command) to create the custom diskette. If you are running SCO Open Server 5.0, use the version of the command: tar -cvP . (the . is part of the command) 7.) Change to the root directory (cd /) and remove the temporary directory: rm -r /tmp/cs 8.) Remove the diskette from the floppy drive and label as "EthetJet LAN CS8900/CS8920 SCO UNIX Driver".