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.
Table of Contents Introduction ......................................................................7 Overview.................................................................................................. 7 Operating System Requirements........................................................... 7 Technical Support ................................................................................... 8 Comtrol Corporate Headquarters.................................................... 9 Comtrol Europe ....
Table of Contents Configuring Modems............................................................................. 22 Using Dialers ........................................................................................ 24 RocketModem: Dialer file entries .................................................. 24 RocketModem: atDialer program .................................................. 25 RocketModem: dialRCKT............................................................... 25 Configuring Printers.........
List of Tables Introduction Table 1. Support Call Information....................................................... 8 Table 2. Device Drivers for RocketPort and RocketModem ............. 10 SCO OpenServer Table 3. Table 4. Table 5. Table 6. Table 7. Table 8. Table 9. Table 10. Table 11. Device Names ....................................................................... 16 Baud Rate Mapping ............................................................. 18 RocketModem Country Codes........................
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 gui
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.
Introduction Comtrol Corporate Headquarters Internet URL: www.comtrol.com email: support@comtrol.com FTP site: ftp.comtrol.com FAX: (651) 631-8117 Phone: (651) 631-7654 Comtrol Europe Internet URL: www.comtrol.co.uk email: support@comtrol.co.uk FAX: +44 (0) 1 869-323-211 Phone: +44 (0) 1 869-323-220 Software and Document Updates For information not in this guide, see the README and/or online Help files on the installation media.
Introduction RocketPort ISA RocketPort PCI RockePort Plus RocketPort 485 RocketModem Operating System (Level) Part Number Table 2. Device Drivers for RocketPort and RocketModem BSDI (3.0) † * * FreeBSD 2.2+ † * * FreeBSD 3.0 † * * †† * * MS-DOS (5.0 and 6.2) Int 14 & FOSSIL 6546 * * * Novell (3.12 through 4.11) 6535 * * * 6522†† * * QNX 4.X (16- and 32-bit) 6523 * * SCO OpenServer (5.0.X) 6543 * * SCO UNIX/Open Desktop (3.2v4.2 & 3.2v5) 6500 * Solaris X86 (2.4, 2.
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.
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.
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.
SCO OpenServer If you do have one or more RocketModem boards installed, press Y, then select the code for the country where the modem will be used. Values are: F France G Germany I Italy S Sweden K United Kingdom U USA/North America 12. If you do not have a RocketPort 485 board installed in your system, press N. If you do have a RocketPort 485 installed, press Y.
SCO OpenServer Verifying Installation If the hardware and software installations were successful, the following message displays for each board after you reboot: % Rocket ###h - ###h- - YYY nports=X vx.xx Where ###h - ###h is the I/O address of the board, YYY indicates ISA or PCI board, X is the number of ports on the controller, vx.xx is driver revision number, and is the driver release date. Note: The driver sees all RocketModem ISA boards as 8-port boards.
SCO OpenServer Board 4 Board 3 Board 2 Board 1 Table 3.
SCO OpenServer Enabling Ports To enable a port, enter this command: enable portname Where portname is the device name as shown in the Device Names table. For example, to enable Board 1, Port 0 for direct communications, enter: enable ttyr0a For more information, see the online manual page for enable. Disabling Ports To disable a port, enter this command: disable portname Where portname is the device name as shown in the Device Names table.
SCO OpenServer Baud Rate Mapping Older versions of UUCP and CU do not support baud rates above 38.4K bps. (This was corrected in 5.0.4c.) Therefore, to take full advantage of the RocketPort or RocketModem board’s potential speed with either older or current versions, use one of the following methods to remap baud rates: • setbaud This program enables you to remap baud rates for one or more ports, for the current session only. • baud.
SCO OpenServer Baud.init Follow these steps to permanently remap baud rates: 1. Edit the /comtrol/rckt/baud.cfg file to list the ports for which you are remapping baud rates. To use the remapped rates listed in the setbaud table, simply list the devices names. For example: /dev/ttyr0a /dev/ttyr0A /dev/ttyr0b /dev/ttyr0B To create a custom mapping scheme, enter the device name, the old rate, and the new rate the old rate is mapped to.
SCO OpenServer 4. Enter this command to enable the port: enable ttyr0a The system should respond with: /etc/inittab updated /etc/conf/init.d/rckt updated 5. From the terminal, enter your login name and password. If you cannot log in, check the baud rate setting on the terminal and verify that it matches the baud rate setting on the server port. To see the current settings for the port, enter this command on the system console: stty -a < /dev/ttyr0a 6.
SCO OpenServer RS-485 Configuration If you have installed a RocketPort that supports RS-485 and have configured one or more ports for RS-485 operation (see the Hardware Reference Card), there are two ways to configure RS-485 service. • rs485 This program enables you to remap a port to enable or disable RS-485, for the current session only. • rs485.init This enables you to remap a port to enable or disable RS-485 automatically each time the system is rebooted.
SCO OpenServer Configuring Modems The following procedure describes how to set up a RocketModem for dial-in and dial-out operations. If you are using another brand of modem attached to a RocketPort serial port, copy and adapt this procedure as needed (substituting the setup strings for your modem), or use the vendor-provided files for your third-party modem. Setup strings can generally be found in the modem owner’s manual. 1. Verify that UUCP is installed.
SCO OpenServer 7. If these devices are not owned by uucp, use the chown command to change the device owner and group names. For example: chown uucp:uucp /dev/ttyr0A chown uucp:uucp /dev/ttyr0a 8. Enter this command to connect to the non-modem control port: cu -s 38400 -l /dev/portname The system should respond: connected 9. Type in atz and press Enter. The modem should respond: OK 10. After verifying that the modem is responding, close the connection by entering ~./ 11.
SCO OpenServer Using Dialers For dialing, both CU and UUCP use a dialer defined by an entry in /usr/lib/uucp/Devices. The dialer can be: • an entry in the /usr/lib/uucp/Dialers file • a symbolic link to atdialer, together with a suitable configuration file in /usr/lib/uucp/default • a standalone program such as /usr/lib/uucp/dialRCKT Comtrol provides the necessary dialer files for each of these types of dialers to support the RocketModem. These files are included with SCO OpenServer driver v2.
SCO OpenServer RocketModem: atDialer program During installation, the following files are installed to use with the atdialer program supplied by SCO.
SCO OpenServer Change it to read: EXES=dialHA96V dialMUL dialTBIT atdialer dialRCKT b. Find the line that reads: CFLAGS = -O -DHDUU -DAUTOCONNECT Change it to read: CFLAGS = -O -DHDUU -DAUTOCONNECT -DROW -D Where is the name of the country where this modem will be used. Values are: Table 7. makefile Country Codes Code Country FRANCE France GERMANY Germany ITALY Italy SWEDEN Sweden UNITEDKINGDOM United Kingdom UNITEDSTATES USA/North America 5.
SCO OpenServer Configuring Printers The following files are used to administer printers connected directly to serial ports under SCO OpenServer: Table 8.
SCO OpenServer Transparent Print The transparent print feature enables users to attach a printer to the auxiliary port available on most video display terminals. Data can then be directed from the host through the terminal to the printer, without disturbing the normal keyboard entry and display functions. This enables you to attach a terminal and a printer to the same port. Follow these basic steps to set up transparent print: 1. Attach a printer to the auxiliary port on the terminal. 2.
SCO OpenServer Table 10. TPRINT.CFG Keywords Keyword Description device This specifies the printer device for a group of statements, and must be the first line in each group of statements describing a device. All statements that follow this statement and come before the next device statement (or the end of the file) will apply to the named device. Example: device=tpr0a This specifies the control sequence that must be sent to the terminal to enable transparent printing.
SCO OpenServer Table 11. ASCII Control Code Mnemonics Mnemonic ASCII ack 06h etx 03h bel 07h ff 0Ch bs 08h fs 1Ch can 18h gs 1Dh cr 0Dh ht 09h dc1 11h lf 0Ah dc2 12h nak 15h dc3 13h nul 00h dc4 14h rs 1Eh dle 10h si 0Fh em 19h so 0Eh enq 05h soh 01h eot 04h stx 02h esc 1Bh sub 1Ah etb 17h syn 16h eot 04h us 1Fh Code Mnemonic ASCII Code PSETUP After tprint.
SCO OpenServer Testing Transparent Print The following example uses an IBM InfoWindow II 3153 and an Epson LQ-510 printer. Copy and adapt these procedures as needed. The terminal is set up as follows: 1. 2. 3. 4. emulation=wyse60 enhanced mode=on commmode=full duplex Host/Printer=EIA/None EIAbaud=38400 AUXbaud=38400 EIAdata=8/1/N AUXdata=8/1/N Use a null-modem cable to connect the SES1-EIA port on the terminal to RocketPort Board 1, Port 0 (ttyr0a).
SCO OpenServer Troubleshooting Before you call Comtrol technical support, please check the following: • • Check to make sure all cables are connected properly. Check the signals between your peripherals and the RocketPort interface box to verify that they match (if applicable). See the RocketPort Hardware Reference Card for port pinouts.
SCO OpenServer Modem-Related Error Messages The following list describes some of the more common error messages seen while performing the exercises in this manual, and their causes. For additional assistance, see the “Troubleshooting Modems” section in the SCO OpenServer Handbook. Message: Cause: Connect failed: SYSTEM NOT IN Systems FILE Missing or incorrect entry in /usr/lib/uucp/Devices. Message: Cause: Connect failed: NO DEVICES AVAILABLE Missing or incorrect entry in /usr/lib/uucp/Devices.
SCO OpenServer 5. After issuing the cu command, press Enter several times and watch the lights on the modem. The receive light should flash. If only the send light flashes, the local echo may be turned off. Use the ATE1 command to turn on the modem’s local echo feature. 6. If no lights flash, the modem cable may be defective. Replace it. 7. Use the RocketPort Diagnostics to verify that the port is working.
SCO OpenServer Solving Printer-related Problems To identify and resolve printer-related problems, follow these steps: 1. Verify that the printer is powered up, connected to the correct port, and on-line. 2. Verify that the printer is connected using the correct cable. See the RocketPort Hardware Reference Card and your printer manual for connector pinouts and cable specifications. 3. Move the printer to a standard serial port, and try it there.
SCO OpenServer -parenb -parodd cs8 -cstopb hupcl cread -clocal -loblk -ctsflow -rtsflow -ignbrk brkint ignpar -parmrk -inpck -istrip -inlcr -igncr icrnl -iuclc -ixon -ixany -ixoff isig icanon -xcase echo -echoe echok -echonl -noflsh opost -olcuc onlcr -ocrnl -onocr -onlret -ofill -ofdel cr0 nl0 tab3 bs0 vt0 ff0 Note: These lines are shown for example only. The parameters for your system will probably be different.
SCO OpenServer UNIX Spooler Problems The System V lp spooler has a known problem that causes serial ports with buffers beyond the UNIX internal c-lists to drop characters at the end of print jobs. When the lp spooler daemon wants to print something, it forks a child process. The child opens the printer port, then forks a process to run the interface shell script. When the shell is finished printing, it exits.
SCO OpenServer Retaining Non-default Parameters on a Disabled Port Drivers only retain stty settings for a particular line as long as that line is open. Likewise, when you do an stty on a closed port, the stty settings are not retained. When you apply stty settings to your login tty, the changes are retained because even after stty terminates, the login shell continues to hold the line open.
Index A ASCII control character mnemonics 30 B baud rates maximum under SCO 11 remapping under SCO 18, 19 baud.
Index extracting the SCO device driver 12 I/O addresses 13, 16 modems under SCO 22 obtaining the SCO device driver 12 port configuration under SCO 15 removing an existing SCO driver 12 RocketModem SCO dialer files 25 using the RocketPort Diagnostics 32 verifying SCO installation 15 viewing port settings under SCO 17 ISA-bus 16 K kernel relinking 32 L login services enabling under SCO 19 lpadmin 27 lpsched 27 lpstat 27 M messages error 33 modems atdialer 24 dialRCKT 25 enable/disable hardware flow contro
Index psetup 28, 30 R rebooting a SCO system 14 relinking the kernel 32 remapping baud rates 19 remapping baud rates under SCO 18 Remote Access Service 7 removing the SCO device driver 12 RocketModem dialer file entries 24 dialRCKT 25 RocketPort board numbering 16 S SCO removing the existing driver 12 SCO commands printer administration 27 SCO OpenServer ACU 22 atdialer 24 custom 20 dialers 24 dialRCKT 25 error messages 15 haltsys 14 rebooting the system 14 shutdown 14 tprint 28 versions supported 7 setb
Index uucp 11, 18, 22, 24 W Web support 8 Windows 95/98 versions supported 7 Windows NT Citrix WinFrame 7 multilink PPP 7 RAS 7 versions supported 7 WinFrame 7 42
