SCO OpenServer Handbook

Table of Contents

• About this book
  • How this book is organized
  • Related documentation
    • Development documentation
    • Driver development
  • Typographical conventions
  • How can we improve this book?
• Chapter 1: About SCO OpenServer systems
  • System configurations
    • SCO OpenServer systems
    • Media
    • Printed documentation
  • Additional licenses and products
    • Licensing and registration terminology
  • Accessing SCO Services information online
    • Finding SCO training
• Chapter 2: Installing or upgrading an SCO system
  • Installation and upgrade checklist
  • Responding to prompts
  • Installing boot-time loadable drivers
  • Booting from CD-ROM
  • The installation and upgrade procedure
  • After installation
  • Choosing an upgrade path
    • About the Upgrade installation type
    • About the Preserve hard disk option
    • About the Interactive disk setup option
    • About other hard disk setup options
  • Issues with any upgrade
    • Restoring user accounts
    • User-configured files and directories
    • Upgrading a non-primary hard disk
    • Upgrading third-party drivers
    • Upgrading SCO OpenServer Development System
  • Upgrading from release 5.0
    • Missing user-created files
    • Third-party products and system serial numbers
    • Upgrading to the Enterprise configuration from Host or Desktop
    • IPX/SPX upgrades overwrite *_tune.h files
    • Upgrading SCO Merge
    • Additional product documentation unavailable after upgrades
  • Upgrading from release 3.0
  • Upgrading from release 2.0
• Chapter 3: Troubleshooting the installation
  • Solving problems during installation
    • System does not boot during installation
    • Error reading a floppy disk
    • Errors when using SCSI installation devices
    • System reboots from Boot Disk or screen blanks after Boot: prompt
    • System hangs at hardware configuration screen
    • Hardware self-check stops
    • System does not boot from the hard disk
  • Solving problems after installation
    • Console screen looks strange
    • Graphical scologin screen on tty02 looks strange
    • Hardware does not work
    • DOS does not work
    • System not licensed or unregistered software
    • Error message: Can´t fork
    • Error message: X TOOLKIT ERROR
    • Common system resource error messages
  • Solving undocumented installation problems
    • Hardware and operating systems
    • Identifying the problem
  • Before calling for help
    • A description of the problem
    • System configuration
• Chapter 4: Installing and managing software components
  • The Software Manager interface
  • Installing software
    • Loading software
    • About products, components, and packages
  • Removing software
    • About dependencies
  • Examining software packages
  • Verifying software
  • About software patches
• Chapter 5: Creating an emergency boot floppy disk set
  • Configuring the floppy disks
  • Adding files to the root floppy disk
  • Testing your emergency boot floppy disk set
    • Reading backups
    • Emergency boot floppy set and mirrored root disks
    • Booting from the hard disk
• Chapter 6: Licensing and registering SCO products
  • The License Manager interface
  • Licensing products
    • Licensing additional users and CPUs
    • Removing product licenses
  • Registering products
  • Displaying login licenses in use
  • Troubleshooting license and registration problems
    • License Manager will not accept registration key
    • License Manager will not accept license information
    • Licensing Policy Manager Daemon (ifor_pmd) has terminated
    • OpenServer license has expired
    • No user licenses were found on this machine
    • LOGIN: ERROR- Failed to initialize policy manager
• Chapter 7: Using other operating systems with an SCO system
  • Installing OS/2 or Windows NT^(TM) partitions
  • Creating and formatting a physical DOS partition
    • DOS partition restrictions
    • Using low-level format programs
    • Converting fdisk numbers
  • Partitioning the hard disk using fdisk (Interactive installation)
    • Displaying current partition table
  • Switching operating systems
    • Booting a DOS partition
    • Booting an arbitrary partition
    • Booting DOS from a floppy disk
  • Installing a UNIX partition on a DOS system
  • Using an SCO system and DOS with two hard disks
  • Removing an operating system from the hard disk
  • Managing DOS files with doscmd(C)
    • doscmd(C) default file
  • Mounting DOS filesystems or partitions
    • Accessing DOS partitions on a second disk
• Chapter 8: Using the system
  • What do I need to know?
  • Command lines, operating systems, and networks
  • Starting the Desktop
    • Exiting the Desktop
    • Using Desktop features
    • Using the mouse
    • Pressing onscreen buttons
    • Using windows
    • Scrolling
    • Using menus
    • Using icons
    • An overview of the SCO Panner window manager
  • Getting help
    • Getting character-based help
  • Sending and receiving mail
    • Sending e-mail
    • Replying to e-mail
    • Saving messages
    • Deleting and restoring messages
    • Getting more information about Mail
• Chapter 9: Administering SCO systems
  • Understanding the basics
    • What is system administration?
    • What to read if you are new
    • Keeping a system log
    • The superuser account
    • The keyboard
    • Running programs simultaneously with multiscreen displays
    • System security
  • Administering your system with SCOadmin
    • Starting SCOadmin from the command line
    • About Sysadmsh Legacy
    • Refreshing data in the display
    • Using point help
    • Using the toolbar
    • Using SCOadmin in character mode
    • Administering other systems with SCOadmin
    • Using the System Defaults Manager
    • Controlling processes with the Process Manager
    • Troubleshooting SCOadmin
  • Educating users
  • Planning your site
    • User resource considerations
    • Network considerations
    • Hardware considerations
  • Summary of system administration tasks
• Chapter 10: Starting and stopping the system
  • Starting the system
    • Loading the operating system
    • Saving/deleting a system memory image
    • Cleaning filesystems
    • Choosing the mode of system operation
    • Setting the time and date at startup
    • Setting the time and date during normal operation
    • Changing the system time zone
    • Checking the security databases
  • Stopping the system
    • Using the shutdown command line
    • Using the haltsys command
  • Logging in as the superuser
  • Understanding the hardware information displayed at boot time
  • Changing the startup process
    • Changing the system restart options
    • Changing the default bootstring (DEFBOOTSTR)
    • Booting an old kernel
  • Troubleshooting system startup
    • About missing or corrupted system files
    • Restoring critical security database files
    • System fails to boot or displays ``NO OS'' message
    • boot not found
    • unix not found
    • Cannot load floating point emulator
    • Cannot exec /bin/login: No such file or directory
    • Cannot open /etc/inittab
    • /etc/initscript: /bin/sulogin: not found
    • /etc/initscript: /etc/bcheckrc: not found
    • no utmp entry. You must log in from lowest level -sh
    • Fork failed... Resource temporarily unavailable
    • System hangs at boot time
    • Console keyboard locks up
    • Cannot log into console
• Chapter 11: Customizing startup of the Graphical Environment
  • Starting a Graphical Environment session
    • Running scologin
      • Configuring scologin's startup behavior
      • Defining X server sessions
      • Logging out of scologin
    • Running the startx script
    • Using grey-scale monochrome monitors with the X server
    • Solving problems exiting the X server
    • Using the session manager
      • Starting scosession
      • Stopping scosession
      • Using scosession options
  • Using environment variables
  • Customizing scologin
    • Using the scologin administration script
    • Configuring scologin on multiple displays
    • About XDMCP X server options
    • Running scologin with XDMCP
    • Running scologin with the Xservers file
      • Step 1: Stopping existing scologin processes
      • Step 2: Editing the Xservers file
      • Step 3: Enabling access to the remote display
      • Step 4: Running the X server on the remote display
      • Step 5: Starting scologin
  • Using X terminals
    • Managing an X terminal display with scologin
      • X terminals that do not support XDMCP
      • X terminals that support XDMCP
    • Running a session on an X terminal without scologin
• Chapter 12: Specifying the locale
  • The International Settings Manager interface
  • Setting locales
    • Localization of system software
    • Setting the system locale
    • Setting user locales
    • About locales
  • Setting the system keyboard
  • Selecting codesets
    • Setting the internal system codeset
    • Setting the console codeset
    • Translating files between different codesets
  • Setting device character mapping
    • Device mapping
    • Creating a character mapping table
    • Configuring SCOterm for European languages
    • Language behavior in SCOadmin
    • Using mail in 8-bit (European) locales
    • UUCP dialer scripts
    • Calendars
    • Timezones
    • Clients
    • Documentation and scohelp
  • Enabling Euro currency symbol support
    • Setting the ISO8859-15 codeset
    • Using the Euro currency symbol
    • Printing the Euro currency symbol
• Chapter 13: Troubleshooting system-level problems
  • Other troubleshooting documentation
  • Preparing to recover from problems
    • Recording your root disk layout
  • Restoring a corrupted root filesystem
  • System crashes
    • Recovering from a system panic
    • Recovering after a power failure
    • Automatic reboot
  • Analyzing system failures
    • Traps, faults, and exceptions
    • Console panic information
    • Getting the EIP number
    • Checking error messages
    • Checking system files with error histories
    • Checking system configuration
    • Generating a system dump image with sysdump (ADM)
  • Examining a memory dump with crash(ADM)
    • Studying a panic
    • Additional help from SCO Support
  • Common system-wide problems
  • cron, at, and batch troubleshooting
    • cron daemon is not running
    • at command fails: cannot change mode of job
  • Runaway processes
• Chapter 14: Basic hardware configuration
  • Accessing the SCO Compatible Hardware Web Pages
  • Supported architecture
  • General compatibility issues
  • Typical device interrupts
  • Configuring devices with bootstrings
  • Using bootstrings
    • Advanced Power Management bootstrings
    • QIC-02 tape drive bootstrings
    • SCSI peripheral bootstrings
    • SCSI host adapter bootstrings
    • Root hard disk bootstrings
    • Disabling drivers with bootstrings
    • Specifying the location of an EIDE (IDE) CD-ROM
    • Memory bootstrings
    • cache bootstring
    • System console bootstring
  • Using boot-time loadable drivers
    • Adding BTLDs at boot time
    • Adding BTLDs after initial installation
  • Configuring drivers with the Hardware/Kernel Manager
    • The Hardware/Kernel Manager interface
    • About device driver configuration
  • Relinking the kernel
  • Configuring Power Management
    • Configuring APM using pwrsh
• Chapter 15: Adding memory and bus cards
  • Installing bus cards
    • DIP switches and jumpers
    • Installing the hardware
    • Avoiding interrupt clashes on PCI/ISA bus machines
    • Using the manufacturer's setup program
  • Adding more memory
    • Memory card compatibility notes
    • Disabled high memory on Corollary architectures
    • 32-bit memory
  • High-speed cache memory
  • Adding math coprocessors
    • Specific math coprocessor issues
  • Adding an external floppy to an IBM PS/2
• Chapter 16: Adding SCSI host adapters and peripherals
  • SCSI addresses
  • Adding a SCSI peripheral device
  • Boot time messages from host adapter drivers
  • Adding SCSI/EIDE CD-ROM drives
  • Adding floptical drives
  • Troubleshooting SCSI host adapters
    • Installing when SCSI host adapters share interrupts
    • Mixing scatter-gather and non scatter-gather host adapters
    • SCSI peripherals not recognized
• Chapter 17: Installing Plug and Play devices
  • The ISA PnP Configuration Manager interface
  • Physically adding an ISA PnP card
  • Selecting a card and device to configure
    • Modifying resource allocation for a device
    • Enabling BIOS resource allocation
    • Disabling a device
  • Resolving configuration conflicts
  • Relinking the kernel and rebooting the system
  • Troubleshooting card configuration
  • Terminology and concepts
• Chapter 18: Adding hard disks
  • Supported hard disk configurations
  • Adding secondary hard disks
  • Configuring a SCSI hard disk
  • Installing a hard disk
    • Changing default disk parameters using dkinit
    • Partitioning a hard disk using fdisk
    • Scanning a disk for defects using badtrk
    • Dividing a disk partition into divisions using divvy
  • Overcoming BIOS limitations
    • Defining IDE and ESDI disk geometry in the BIOS
    • Overriding the root disk geometry stored in the BIOS
    • Writing a new masterboot block
    • BIOS support for disks larger than 1024 cylinders
  • Configuring IDE disks and disk controllers
  • Replacing the root hard disk
    • Configuring the root hard disk
  • Troubleshooting hard disks
    • Fixing bad tracks and bad blocks on hard disks
    • Setting hard disk interleave
    • Formatting hard disks
• Chapter 19: Adding tape drives
  • Installing a tape drive
    • Installing a QIC-02 cartridge tape drive
    • Installing an Irwin mini-cartridge tape drive
    • Installing a QIC-40/80 floppy tape drive
    • Installing a SCSI tape drive
    • Installing a Compaq CPQS tape drive
  • Changing the default tape drive
  • Troubleshooting tape drives
    • General problems with tape drives
    • Problems with QIC-02 cartridge tape drives
    • Problems with SCSI tape drives
    • Problems with Irwin and QIC-40/80 tape drives
• Chapter 20: Configuring video adapters
• Chapter 21: Adding serial and parallel ports
  • Adding and configuring SCO-supported serial cards
    • The Serial Manager interface
    • Configuring a serial card
    • Configuring a serial port
    • Serial ports on multi-function cards
    • Combining single port and multiport serial cards
    • Serial cards on ISA and EISA machines
    • Serial cards on Micro Channel Architecture machines
  • Adding and configuring parallel ports
  • Troubleshooting serial cards
• Chapter 22: Adding mice and bitpads
  • Bus mice
  • Serial mice
  • Keyboard mice
  • Configuring a mouse
    • Changing mouse ports
    • Testing a mouse
    • Removing a mouse
  • Changing the keyboard mouse resolution setting
  • Using a mouse
    • Using a mouse with multiscreens
    • Using a mouse on serial terminals
    • Sharing a mouse with several terminals
    • Using a mouse with keyboard-based programs
    • Using the pseudo-mouse driver
  • Installing a bitpad
  • Troubleshooting mice and bitpads
    • Solving slow or no response from keyboard mice
• Chapter 23: Adding printers
  • Installing parallel and serial printers
  • Troubleshooting printers
    • Setting up RTS/CTS protocol (hardware flow control) printers
• Chapter 24: Adding modems
  • Supported modems
  • Installing a modem
    • Choosing which serial port to use
    • Connecting a modem to your computer
    • The Modem Manager interface
    • Configuring modems
    • Detecting a modem automatically
    • Adding a modem manually
    • Modifying the configuration of a modem
    • Removing a modem
  • Guidelines for non-supported modems
  • Configuring UUCP for modems
  • Using dialers
    • Dialers file entries
    • atdialer and dialer programs
    • Understanding modem commands and setup strings
    • Creating a new atdial dialer
    • Creating a new dial dialer
  • Setting hardware flow control
  • Testing your modem connection
    • Testing whether you can dial out
    • Testing whether you can dial in
  • Troubleshooting modems
    • Problems dialing out
    • Problems dialing in
• Chapter 25: Adding serial terminals
  • Installing serial terminals
  • Testing a terminal connection
  • Changing default terminal line characteristics
    • Changing entries in /etc/gettydefs
    • Checking terminal settings
    • Changing serial line operation
  • Setting the terminal type at login
    • Setting the terminal type automatically
  • Removing terminals
  • Setting up serial consoles
  • Setting up scancode-compatible terminals
    • Installing scancode-compatible terminals
    • Using function keys in scancode mode
    • Running applications on scancode terminals
  • Troubleshooting terminals
    • Restoring non-functional terminals
    • Fixing hung terminals
    • Fixing scrambled terminal display
    • Unlocking locked terminals
    • Restoring non-echoing terminals
    • Correcting hung scancode-compatible terminals
    • Wyse 60 terminal in scancode mode
• Chapter 26: Configuring Internet services
  • Starting the Internet Manager
  • Configuring network connections
    • Accessing the network
    • Configuring network cards
    • Using a modem to connect to the Internet
  • Configuring Internet services
    • Web
    • Mail
    • FTP
    • Net
    • Security
• Chapter 27: Managing virtual domains
  • Enabling virtual domains
  • Adding and deleting virtual domains
  • Configuring services
    • Configuring SYSTEM-WIDE
    • Configuring interfaces
  • Viewing properties of virtual domains
    • Virtual domain name and DNS
    • Administrative users
    • Configuring e-mail
    • Locking and unlocking an interface
  • Remote administration of virtual domains
• Chapter 28: Configuring network connections
• Appendix A: Configuration parameters
• Appendix B: SCSI host adapters
• Appendix C: Serial adapters
  • AMI lamb serial adapter
  • Arnet serial adapter (MCA)
  • AST serial adapter
  • CTC Versanet serial adapter
  • Digiboard serial adapter
  • Olivetti RS232C multiport adapter
  • Quadram serial adapter
  • Stargate serial adapters on the Apricot Qi (MCA)
  • Tandon serial adapter
• Appendix D: Mice and bitpads
  • Logitech bus mouse
  • Microsoft bus mouse
  • Olivetti bus mouse
  • Logitech serial mice
• Appendix E: Modems
  • Smartmodem 1200 or compatible
  • Smartmodem 2400, V-series 9600 or compatible
  • Telebit Trailblazer
• Appendix F: Network adapters
• Appendix G: Kernel initialization check letters
• Appendix H: vi command summary
• Index