Comtrol SCO OpenServer User Manual

Software Installation

and

Configuration Guide

SCO

®

OpenServer

™

Copyright © 1998. Comtrol Corporation.
All Rights Reserved.
Fourth Edition, July 7, 1998

Comtrol Corporation makes no representations or warranties with
regard to the contents of this guide or to the suitability of the Comtrol
products for any particular purpose. Specifications subject to change
without notice. Some software or features may not be available at the
time of publication. Contact your reseller for current product
information.

Trademarks

RocketPort is a registered trademark and Comtrol and RocketModem
are trademarks of Comtrol Corporation.

OpenServer is a trademark and SCO is a registered trademark of The
Santa Cruz Operation.

Other product names mentioned herein may be trademarks and/or
registered trademarks of their respective companies.

Comtrol Corporate Headquarters:

Internet URL: www.comtrol.com
email: [e-mail]
FTP site: ftp.comtrol.com
FAX: [phone]
Phone: [phone]

Comtrol Europe:

Internet URL: www.comtrol.co.uk
email: [e-mail]
FAX: [phone]
Phone: [phone]

Document Part Number: 6543D

Table of Contents

Introduction ......................................................................7

Overview.................................................................................................. 7

Operating System Requirements...........................................................7

Technical Support................................................................................... 8

Comtrol Corporate Headquarters.................................................... 9

Comtrol Europe ................................................................................9

Software and Document Updates .......................................................... 9

SCO OpenServer............................................................ 11

Overview................................................................................................ 11

Installation Prerequisites..................................................................... 12

Removing an Existing Driver...............................................................12

Installing the New Driver ....................................................................12

Extracting the Driver Files............................................................ 12

Software Installation......................................................................13

Rebooting the System..................................................................... 14

Verifying Installation.....................................................................15

Configuring Ports.................................................................................. 15

Enabling Ports................................................................................ 17

Disabling Ports...............................................................................17

Viewing Settings.............................................................................17

Hardware Flow Control ................................................................. 17

Baud Rate Mapping.............................................................................. 18

Setbaud........................................................................................... 18

Baud.init......................................................................................... 19

Terminal Sessions in SCO OpenServer............................................... 19

Enabling Login Services ................................................................ 19

RS-485 Configuration........................................................................... 21

RS485.............................................................................................. 21

RS485.init....................................................................................... 21

3

Table of Contents

Configuring Modems............................................................................. 22

Using Dialers ........................................................................................ 24

RocketModem: Dialer file entries..................................................24

RocketModem: atDialer program ..................................................25

RocketModem: dialRCKT............................................................... 25

Configuring Printers............................................................................. 27

Printer Administration Commands............................................... 27

Transparent Print ..........................................................................28

TPRINT.CFG.................................................................................. 28

PSETUP.......................................................................................... 30

Testing Transparent Print.............................................................31

Troubleshooting ....................................................................................32

PCI-Bus I/O Conflicts.....................................................................32

Modem-Related Error Messages.................................................... 33

Solving Modem-related Problems.................................................. 33

Using RocketModem Reset (rktmodemreset) ............................... 34

Solving Printer-related Problems..................................................35

Checking Flow Control Configuration...........................................35

Software (XON/XOFF) Flow Control............................................. 36

Hardware (CTS/RTS) Flow Control...............................................36

UNIX Spooler Problems.................................................................37

Possible Solutions...........................................................................37

Retaining Non-default Parameters on a Disabled Port................38

Transparent Print: Known Issues.................................................38

Index................................................................................. 39

4

List of Tables

Introduction

Table 1. Support Call Information....................................................... 8

Table 2. Device Drivers for RocketPort and RocketModem ............. 10

SCO OpenServer

Table 3. Device Names....................................................................... 16

Table 4. Baud Rate Mapping ............................................................. 18

Table 5. RocketModem Country Codes.............................................. 24

Table 6. dialRCKT Country Codes .................................................... 25

Table 7. makefile Country Codes....................................................... 26

Table 8. Printer Administration Files............................................... 27

Table 9. Printer Administration Commands ....................................27

Table 10. TPRINT.CFG Keywords....................................................... 29

Table 11. ASCII Control Code Mnemonics.......................................... 30

5

6

Introduction

Overview

The Comtrol RocketPort/RocketModem Software Installation and
Configuration Guide covers the following Comtrol software products:

• RocketPort/RocketModem Windows NT Driver (6540)

• RocketPort/RocketModem Windows 95/98 Driver (6533)

• RocketPort/RocketModem Novell NetWare Driver (6535)

• RocketPort/RocketModem SCO OpenServer Driver (6543)

• RocketModem AT Command Set
Please note that these software drivers support a broad range of

Comtrol hardware products, and that both this guide and the driver
you install may include features not applicable to your installation.

Each Comtrol adapter, board, or interface comes packaged with a
Hardware Reference Card, which covers hardware-specific installation
instructions and performance characteristics. For more information
about your Comtrol product, see the Hardware Reference Card.

Operating System Requirements

The drivers discussed in this document work with the following
operating systems:

• Microsoft Windows

Note: NT 4.0 or higher is required to support Multilink PPP.

RAS or RRAS is required to support Remote Access Service.
Under NT 4.0, Service Pack 3 is required to support RAS.

®

•Citrix

• Microsoft Windows

• Novell
or NetWare Connect 2.0.30 or higher)

• Novell IntranetWare I (with NIAS and Support Pack v1.0)

•SCO

Overview 7

WinFrame® (1.7 or later)

®

NetWare® 3.12, 3.2, or 4.1x (with MPR 3.1A or higher and/

®

OpenServer™ (5.0.x)

®

NT (3.51, 4.0, or higher)

®

95 and Windows® 98

Introduction

Technical Support

Comtrol has a staff of support technicians available to help you. U.S.
and U.K. telephone support is available during business hours,
Monday through Friday (holidays excluded), at the phone number(s)
listed on the previous page. Before you call Comtrol technical support,
please have the following information available.

Table 1. Support Call Information

Item Information

Product name
Country where used
Serial number*
Part number**
I/O address***
Interrupt (IRQ)***
Operating system type and

release
OS service pack number
Driver version number
Computer make, model,

and speed
Other Comtrol products

installed and their I/O
addresses, if applicable

Other serial port adapters
installed and respective
COM port numbers

* Serial numbers can be found on a printed tag on the RocketPort/

RocketModem circuit board.

** Part numbers can be found on both the box and on a tag on the

circuit board. It is a six-digit number similar to this:

96850-4

.

*** The I/O address is set in two places: in the DIP switch block on

the circuit board, and in the driver software. The IRQ, if used, is
set in the driver software only.

8 Technical Support

Comtrol Corporate Headquarters

Introduction

Internet URL:
email:

[e-mail]

FTP site:

www.comtrol.com

ftp.comtrol.com

FAX: [phone]
Phone: [phone]

Comtrol Europe

Internet URL:
email:

[e-mail]

www.comtrol.co.uk

FAX: [phone]
Phone: [phone]

Software and Document Updates

For information not in this guide, see the

README

files on the installation media.
Comtrol manuals and other documents are available in electronic form

on the Comtrol corporate headquarters (U.S.) web site. Driver software
updates can be downloaded at no charge from the Comtrol U.S. ftp site.
Always check the web and ftp sites to make sure that you have the
current driver and documentation.

• Comtrol U.S. web site:

• Comtrol U.S. ftp site:

http://www.comtrol.com

ftp://ftp.comtrol.com

The current released version of the software is stored in the Rocket
directory. If a newer version has reached the beta testing stage, it can
be found in the BETA directory. Beta software is made available on an

“as-is”

basis and users of beta software assume all risks and liabilities

relating thereto.

Note: Downloadable driver software files are stored in either zipped

(filename.zip) or self-extracting zip (filename.exe) format. You
must extract the zipped files before installing a downloaded file.
For more information, see the appropriate section for your
server operating system.

and/or online Help

Software and Document Updates 9

Introduction

Table 2. Device Drivers for RocketPort and RocketModem

Operating System (Level)

BSDI (3.0)
FreeBSD 2.2+
FreeBSD 3.0
Linux (V1.2.0 or higher)
MS-DOS (5.0 and 6.2) Int 14 & FOSSIL
Novell (3.12 through 4.11)
OS/2 (2.X and 3.X) not WARP Connect
QNX 4.X (16- and 32-bit)
SCO OpenServer (5.0.X)
SCO UNIX/Open Desktop (3.2v4.2 & 3.2v5)
Solaris X86 (2.4, 2.5.1, and 2.6)
SVR3.2 UNIX (3.2v3 and 3.2v4)
SVR4 UNIX (SVR4.2 and UnixWare 1.X)
SVR4 UNIX (UnixWare 2.1.X)
Windows 3.1 and WFWG 3.11
Windows 95/98
Windows NT (3.51 and 4.0) I386
Windows NT (3.51 and 4.0)

DEC ALPHA

ISA

PCI

RocketPort

RockePort

RocketPort

Part Number
†**
†**
†**

†† * *
6546 *****
6535 * * * *

6522†† * *

6523 * *
6543 * * * *
6500 *
6519 *
6502 *
6503 *
6544 * *
6536 * *
6533 * * *
6540 ****

6540R ****

Plus

RocketPort

485

RocketModem

*
*
*

†

See the README the FTP site or use the search engine on the Web site

††

ftp://tsx-11.mit.edu/pub/linux/packages/comtrol/comtrol-1.12.tar.gz

10 Software and Document Updates

.

SCO OpenServer

Overview

Use this section to install and configure the RocketPort/RocketModem
SCO OpenServer Driver. This driver supports both the RocketPort

series of multiport serial boards and the RocketModem series of
integrated multimodem boards.

You can install up to four RocketPort/RocketModem boards in one
computer, including a combination of RocketPort and RocketModem
and ISA- and PCI-bus adapters. This driver supports a maximum of
128 serial I/O ports or modems per computer, and each port can be
driven at baud rates up to 230.4K bps, depending on the model of
RocketPort or RocketModem installed.

•All RocketModem boards support their own built-in modems
exclusively.

•All RocketPort boards support external RS-232 devices at speeds up
to 230.4K bps. Selected models also support RS-422 or RS-485.

For more information regarding the specific capabilities of your
RocketPort or RocketModem board, see the Hardware Reference Card
that is packaged with each board.

Note: While the driver and boards are capable of this performance,

older versions of UUCP and CU (prior to 5.0.4c) are limited to a
maximum baud rate of 38.4 Kbps.

This product was developed and tested using SCO OpenServer 5.0.4c.
You must install your RocketPort/RocketModem controller board(s)

before installing the device driver software. This section discusses how
to install, configure, and test the SCO OpenServer device driver
software.

If you need more information about baud rate support, see the manual
page for termio on your system. If you need to access rates higher than

38.4 Kbps, see the section on Baud Rate Mapping on page 18.

For more information about signals, cables, and pinouts, see the
Hardware Reference Card that came with your board and interface.

Overview 11

SCO OpenServer

Installation Prerequisites

Before you install the SCO OpenServer device driver, you must:

• Obtain the current driver, either on media or from the Comtrol web
or ftp site.

• Remove any older RocketPort/RocketModem driver that may be on
your system.

• Extract the current driver files and create an installation diskette.

Removing an Existing Driver

If upgrading from an earlier version of the driver, remove the old
driver before installing the new one. Follow these steps:

1. Log in as the system administrator (root).

2. Invoke the custom utility.

3. Select the RocketPort/RocketModem device driver to be removed.

4. Select the Software option.

5. Select Remove Software.

6. Select Remove to confirm your choice.

7. Type Y to boot the kernel by default.

8. Type Y to rebuild the kernel environment.

9. Press any key to return to the custom menu.

10. Select Host and Exit to exit the custom utility.

11. If you have other drivers to remove at this time, do so.

12. Reboot the kernel so that your changes take effect.

Installing the New Driver

Use the following instructions to extract and install the RocketPort/
RocketModem SCO OpenServer driver.

Extracting the Driver Files

The RocketPort/RocketModem SCO OpenServer driver is distributed
as either a UNIX install diskette or as a compressed DOS-format file
named 6543.z. If you have the UNIX version, skip to Driver
Installation on page 13.

12 Installation Prerequisites

SCO OpenServer

If you have obtained 6543.z, either by downloading it from the Comtrol
ftp site or on DOS-formatted media, follow these steps to extract the
file and create a UNIX installation diskette.

1. If needed, copy the file to your UNIX server. For example, if
copying from a DOS diskette in your A: drive, enter this command:

doscp a:6543.z

2. Enter this command to rename the file: mv 6543.z 6543.Z

3. Enter this command to extract the driver: uncompress 6543.Z

4. Enter this command to copy the resulting file to a blank diskette:

dd if=6543 of=/dev/rfd?135ds18

Where ? is 0 if this is the primary or 1 if it is the secondary drive.

Software Installation

If you have changed the hardware configuration, added or removed
controller boards, or are upgrading to a new version of the driver,
remove the existing RocketPort/RocketModem device driver before
proceeding. For more information, see Removing the Existing Driver.

To install a new device driver, follow these steps:

1. Boot the system and log in as the system administrator (root).

2. Invoke the custom utility.
For more information about the custom utility, see the System

Administrator’s Guide or the online manual page for custom.

3. Select Software.

4. Select Install New.

5. Select From scosysv (where scosysv is your system name).

6. Insert the installation diskette in the primary drive. Select the
appropriate device (e.g., floppy disk drive 0) and press Enter.

7. Select Install.

8. Enter the number of ISA RocketPort/RocketModem boards
installed in the system.

9. Choose a valid I/O address for each ISA controller board. These
must match the I/O addresses set using the DIP switches on the
boards during hardware installation. (For more information see
the Hardware Reference Card that came with your board.)

10. Enter the number of PCI RocketPort/RocketModem boards
installed in the system.

11. If you do not have any RocketModem boards installed in your
system, press N.

Installing the New Driver 13