<==========================================================================>
| Ositech Four of Diamonds Trumpcard |
| UnixWare Driver Package Installation |
| Version 1.26 |
| Copyright (c) 1994-1996, Ositech Communications Inc. |
<==========================================================================>
This document supplements the Ositech Four of Diamonds user's guides and
the accompanying software. This document describes the installation of the
UnixWare driver package. Please read this document in its entirety before
installing this software.
This document contains information specific to this "Four of Diamonds
Trumpcard SCO Unix and UnixWare Drivers Diskette". More general, up-to-date
information on Version 1.10 of the Ositech Four of Diamonds Trumpcard
software, including a directory map of all text/readme files on all
diskettes, can be found in the README.TXT file located on the "Four of
Diamonds Trumpcard Diagnostics, Utilities and Modem Scripts Diskette".
Contents
========
1. Requirements
1.1 Installing the Ethernet Support Package
2. Software Distribution
2.1 UnixWare 1.1 and 2.x Network Installation
2.2 Compressed ZIP Archive (.exe) Distribution
2.3 File Archive (.tar) Distribution
2.4 Diskette Distribution
2.4.1 DOS Distribution Diskette
2.4.1.1 DOS Diskette Installation Walkthrough
2.4.2 UnixWare Diskette
3. Utilities
3.1 irqcheck
3.2 netrun
3.3 README.eth
4. Things You Should NOT Do
5. Trademarks
6. Technical Support
==========================================================================
1. Requirements
In order to install the otceth driver, you must have the following:
> an Intel 365 compatible or Databook compatible PCMCIA adapter
> a bootable UnixWare 1.1 (or later) system, or a UnixWare 2.0 (or
later) system, or a UnixWare AS set up as an install server
> access to the UnixWare root account
> knowledge of the IRQs, I/O ports and memory windows that you wish to
assign to the Trumpcard functions.
> If using an ISA PCMCIA controller in a PCI Bus machine, you should use
the BIOS to open an ISA Memory window for the Trumpcard
==========================================================================
1.1 Installing the Ethernet Support Package
The OTCETH STREAMS driver depends upon the package nsu "Network Support
Utilities" which must be installed prior to the installation of the Trumpcard
Ethernet driver package. The nsu package is part of the Personal Edition and
Application Server versions of UnixWare. Please refer to the README.eth file
for more information on installing the Ethernet support package.
==========================================================================
2. Software Distribution
You may receive the Ethernet Support Package via any one of five
distribution methods:
> a UnixWare 1.1 and 2.0 Network distribution
> a compressed ZIP archive (.exe) distribution
> a file archive (.tar) distribution
> one of two diskette distribution methods:
> a DOS distribution diskette
> a UnixWare diskette
2.1 UnixWare 1.1 and 2.x Network Installation
You can use the Trumpcard Ethernet Driver to perform network
installations of the UnixWare system from an Install Server on your network.
Please refer to the NET_INST.TXT file for more information on using the
Trumpcard to perform a network install.
2.2 Compressed ZIP Archive (.exe) Distribution
If the driver was obtained in an (.exe) format, then you must run the
.exe file under DOS with the -d option to create any subdirectories. The
destination should be a diskette drive, in this case diskette drive A:
unixware.exe -d a:\
This will generate an image of the DOS distribution diskette with only
the UnixWare directories and files present. Please refer to the DOS diskette
distribution section below for more instructions.
2.3 File Archive (.tar) Distribution
If the package is stored in a file archive (.tar) format, you can
extract the files in the file archive using the following command entered in
a Terminal window:
tar -xf osi_uw.tar
This will extract the contents of the file archive (for example, the
compressed datastream file, trumpc.Z, and this README file). First,
uncompress the datastream using the following command executed in the same
directory as the trumpc.Z file:
# uncompress trumpc
To start the installation of the Trumpcard Ethernet Support Package,
logon as "root", change to the same directory as the trumpc file that was
previously uncompressed and extracted from the file archive, and issue the
following command:
# pkgadd -d /{path_to_trumpc}/trumpc
Simply complete the installation screens and the package will be installed.
Following a shutdown, the OTCETH driver should be loaded.
If you wish to store this package on a floppy disk, you will need a Unix
formatted floppy and pkgtrans (also available on the SDK or as pkgtrn.tar).
Execute the following commands to create the installation diskette:
# format -v /dev/rdsk/f03ht (or f13ht if disk is in B:)
# pkgadd -d /{path_to_trumpc}/trumpc -s /var/spool/pkg otceth
# pkgtrans -s /var/spool/pkg diskette1 otceth (or diskette2 if it's B:)
2.4 Diskette Distribution
There are two diskette distribution methods:
> DOS distribution diskette
> UnixWare diskette
2.4.1 DOS Distribution Diskette
Copy the install script from the diskette using the doscp command:
$ doscp a:unix/uw/install /tmp/install
$ su
Password:
# cd /tmp
# sh install
Then simply follow the instructions provided by the install script. You will
also need a blank diskette which will become your UnixWare Trumpcard Driver
installation diskette.
2.4.1.1 DOS Diskette Installation Walkthrough
The following is a walkthrough of the install script:
$ su
Password:
# cd /tmp
# doscp a:unix/uw/install install
# sh install
If you have DOS merge installed then the script will copy the
file archive for the DOS distribution diskette.
The install script will now attempt to extract the contents of the
of the /unix/uw/osi_uw.tar archive file previously copied from the
DOS distribution diskette to the UNIX /tmp directory. In order for
this installation script to be successful, you must have installed
the following patches:
ptf240 - Slink patch for UnixWare 1.1.2
NOTE: You must be root user in order to run this script
Press ENTER to continue Q)uit
Please insert the DOS distribution diskette in drive A:
Press ENTER to continue
Copying osi_uw.tar file archive from diskette ...done.
Extracting files from the archive ...
x README.4od, 18523 bytes, 37 tape blocks
x README.eth, 18523 bytes, 37 tape blocks
x install, 7902 bytes, 16 tape blocks
x irqcheck, 567 bytes, 2 tape blocks
x netrun, 2962 bytes, 6 tape blocks
x trumpc.Z, 150774 bytes, 295 tape blocks
Install Drivers for:
4 OSITECH Four of Diamonds Trumpcard
J OSITECH Jack of Diamonds Trumpcard
A Abort installation
Choice (4/J/A) 4
Please remove any diskette from the 3.5-inch drive.
Then insert a blank 3.5-inch high density diskette that will be
formatted to become the Ositech Trumpcard Driver Install Floppy.
WARNING: All data on this diskette will be lost!
Press ENTER when ready...
formatting................
Formatted 160 tracks: 0 thru 159, interleave 1.
Spooling the datastream image ...
Transferring <otceth> package instance to
</var/spool/pkg> in file system format
Processing the datastream image. This may take a few minutes ...
Insert a diskette into Floppy Drive 1.
Type [go] when ready,
or [q] to quit: (default: go)
Transferring <otceth> package instance to
</dev/rdsk/f0t> in datastream format
Removing the spooled datastream ...
The following package is currently spooled:
otceth Trumpcard Ethernet Hardware Support
(386) 1.26
Do you want to remove this package [yes,no,?,quit] y
Removing spooled package instance <otceth>
done
In order to use the OSITECH PCMCIA Trumpcard, you must configure the
drivers by providing the I/O addresses and IRQs that you wish to assign
to the various Trumpcard functions.
The archive contains the readme file /tmp/README which has more
detailed technical information on this installation process.
Do you wish to view the readme file before continuing? (y/n/q) n
Invoking pkgadd -d diskette1 to install the Ositech Trumpcard Driver
Package
Insert diskette into Floppy Drive 1.
Type [go] when ready,
or [q] to quit: (default: go)
Installation in progress. Do not remove the diskette.
The following packages are available:
1 otceth Trumpcard Ethernet Hardware Support
(386) 1.26
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,quit]:
PROCESSING:
Package: Trumpcard Ethernet Hardware Support (otceth) from
<diskette1>.
Trumpcard Ethernet Hardware Support
(386) 1.26
Using </> as the package base directory.
Copyright (c) OSITECH Communications, Inc. 1994-1996
All rights reserved.
[Screen 1]
+---------------------------------------------------------------------------+
| Trumpcard Hardware Support Adapter Selection Menu |
|---------------------------------------------------------------------------|
| Following is a list of the supported Trumpcard network cards. |
| You may select one (or more) of each kind of Trumpcard. |
| |
| Jack of Diamonds (OTCETH_JOD): 1 |
| Four of Diamonds (OTCETH_4OD): 0 |
| +-----+ +-----+ |
| |Apply| |Reset| |
| +-----+ +-----+ |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| Use TAB/BACK TAB to move between fields. When form is complete, TAB to the|
| "Action:" field, select "Apply", and press the space bar to continue. |
|--------------------------------------------------------+------------------|
|How many Trumpcard PCMCIA Cards you wish to use (0-1)? | Del=Cancel F1=Help|
+--------------------------------------------------------+------------------+
[Screen 2]
+---------------------------------------------------------------------------+
| Trumpcard Hardware Support OTCETH_4OD Parameter Selection |
|---------------------------------------------------------------------------|
| ADAPTER: OTCETH_4OD |
| |
| This screen allows you to select various parameters to be configured |
| for Trumpcard 1. |
| |
| Interrupt Vector: 5 |
| I/O Address: 300 31F |
| RAM Address: C8000 C8FFF |
| Cable Type: 10BASET |
| Zero Wait State: Enable |
| +-----+ +-----+ |
| |Apply| |Reset| |
| +-----+ +-----+ |
| |
| |
| |
| |
| Use TAB/BACK TAB to move between fields. When form is complete, TAB to the|
| "Action:" field, select "Apply", and press the space bar to continue. |
|-----------------------------------------------------+---------------------|
|Right/Left arrow keys for new choice (4 choices) | Del=Cancel F1=Help |
+-----------------------------------------------------+---------------------+
## Processing package information.
## Processing system information.
## Verifying package dependencies.
Installing Trumpcard Ethernet Hardware Support as <otceth>
## Installing part 1 of 1.
/tmp/irqcheck
/tmp/netrun
[ verifying class <none> ]
/tmp/jod/otceth/Driver.o
/tmp/jod/otceth/Drvmap
/tmp/jod/otceth/Master
/tmp/jod/otceth/Node
/tmp/jod/otceth/Space.c
/tmp/jod/otceth/System
/tmp/jod/otceth/otceth.bcfg
/usr/include/sys/lmstruct.h
/usr/include/sys/otceth.h
[ verifying class <otceth> ]
## Executing postinstall script.
[ customizing otceth/System file for board 1 ]
[ Customizing for UnixWare version 2.1 ]
[ installing instance <otceth> of otceth ]
[ reconfiguring kernel ]
UX:idbuild: INFO: The following loadable modules will be configured now:
otceth
UX:idbuild: INFO: Module configuration is completed.
[ installing class <none> ]
[ installing class <otceth> ]
Installation of Trumpcard Ethernet Hardware Support (otceth) was
successful.
Insert diskette into Floppy Drive 1.
Type [go] when ready,
or [q] to quit: (default: go) q
*** IMPORTANT NOTICE ***
If installation of all desired packages is complete,
the machine should be rebooted in order to
ensure sane operation. Execute the shutdown
command with the appropriate options to reboot.
Do you wish to move the utility scripts to /home/owner/bin? (y/n/q) y
Do you wish to copy the documentation to /home/owner? (y/n/q) y
# cd /
# shutdown -y
2.4.2 UnixWare Diskette
If you received the Trumpcard driver package on a diskette, or if you
created an installation diskette, then logon as "root", and install the
package using the following command:
$ su
Password:
# pkgadd -d diskette1
Simply fill in the screens and the driver packages will be installed.
Following a shutdown and possibly a kernel rebuild, the drivers should be
loaded.
==========================================================================
3. Utilities
There are several utility scripts that are placed in the /tmp directory
during the installation of the packages:
/tmp/irqcheck
/tmp/netrun
Since the files in the /tmp directory will be removed upon rebooting the
machine, these files should be moved to a permanent directory such as your
home directory, or /usr/sbin or any other directory.
3.1 irqcheck
This script file can be used to determine what IRQs are available on
your machine. Simply logon as "root" and execute it:
$ su
Password:
# sh irqcheck
CAUTION: Hardware that is present in this machine, but has not
been configured using UnixWare, will not be reported.
1 kd
2 [8259 Cascade -> IRQ9]
3 asyc
4 asyc
5 otceth
6 fd
7 lp
8 rtc
9 asyc
10 adss
11 ** THIS IRQ AVAILABLE **
12 ** THIS IRQ AVAILABLE **
13 ** THIS IRQ AVAILABLE **
14 dcd
15 ** THIS IRQ AVAILABLE **
#
3.2 netrun
This script can be used to start and stop the networking under UnixWare
1.x. Please refer to the README.eth file for more information about the
netrun utility.
3.3 README.eth
Please review the various README files on the DOS installation diskette,
or that have been placed in the /tmp directory during the installation of one
or more of the Trumpcard packages, for the latest release information on the
various packages.
==========================================================================
4. Things You Should NOT Do
DO NOT remove the card while running unless you have demand unloaded the
OTCETH network driver first. There is NO support for hot swapping.
==========================================================================
5. Trademarks
NetWare is a registered trademark of Novell, Inc.
UNIX is a registered trademark and UnixWare is a trademark of
UNIX Systems Laboratories, Inc.
Trumpcard is a trademark of Ositech Communications, Inc.
Ethernet is a trademark of Xerox Corporation.
==========================================================================
6. Technical Support
If you have any problems with your Ositech Trumpcard adapter, please
call our technical support staff toll free in Canada and the United States
at 1-800-563-2365, FAX at 1-519-836-6156, Internet e-mail at
support@ositech.com, CompuServe (GO OSITECH), or mail to the following
address:
Ositech Communications, Inc.
679 Southgate Drive,
Guelph, Ontario N1G 4S2
CANADA
Tel: 1 (519) 836-8063
FAX: 1 (519) 836-6156
BBS: 1 (519) 836-1196
WWW: http://www.ositech.com/
FTP: ftp.ositech.com
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.