Floppy Tape EFS Release and Installation Notes 19 September 1991 Release 1.0.0 TABLE OF CONTENTS ----------------- 1. Introduction 1.1 Contents of This Release 1.2 About These Notes 1.3 Conventions Used in This Guide 2. Installing the Floppy Tape EFS 2.1 Installation Requirements 2.2 Installation Procedure 3. Configuring the Floppy Tape EFS 4. Removing the Floppy Tape EFS 5. Setting Drive Select or Soft Select 6. Notes 6.1 Installation and /usr/lib/mkdev/tape 6.2 Installation and Korn Shell 6.3 QIC-40XL Format Compatibility 6.4 System Floppy Controller Connections 6.5 Simultaneous Access to Floppy Tape and Floppy Disk 6.6 Floppy Cables and System Set-up 6.7 Memory Allocation During Device Open Time 6.8 Killing Tape Processes 7. Supported Hardware 1. INTRODUCTION ================= This document introduces the Floppy Tape EFS (Extended Functionality Supplement), describes the contents of this release, provides installation and configuration information, describes software notes, and lists supported hardware. The Floppy Tape EFS adds the following features to the SCO UNIX System V operating system: o support for QIC-80 floppy tape drives o support for Soft Select compatibility in QIC-40 and QIC-80 drives, enabling them to operate on the floppy bus without a drive select line o support for extended length tape for QIC-40 (60-Mbyte extended capa- city) and QIC-80 (120-Mbyte extended capacity) drives The Floppy Tape EFS installs on SCO UNIX System V/386 Release 3.2 Version 2.0 as well as SCO Open Desktop Version 1.1.0 with Update F. 1.1 Contents of This Release ------------------------------ The Floppy Tape EFS includes the following materials: o two Floppy Tape EFS distribution diskettes, one 5.25" and one 3.5" o these Release and Installation Notes o new manual pages in hardcopy and online formats for tape(HW), tape(C), and mkdev(ADM) 1.2 About These Notes ---------------------- These notes contain instructions that allow you to install the Floppy Tape EFS and configure the floppy tape driver on an existing SCO UNIX system. It is assumed that you are familiar with basic UNIX system administration tasks; for more information, see the chapter `Using Floppy Disks and Tape Drives' in either the SCO UNIX System Administrator's Guide or the SCO Open Desktop Administrator's Guide. 1.3 Conventions Used in This Guide ----------------------------------- This guide uses the following notational conventions: bold shows commands, command options and parameters in files italics represents files and directories < > enclose special keys that you press; for example, means to press the Return key Courier shows system responses and screen displays ++ indicates sysadmsh menu selection sequences -> indicates the next selection in a sysadmsh sequence 2. Installing the Floppy Tape EFS ================================== This section describes how to install the Floppy Tape EFS using the custom(ADM) utility. 2.1 Installation Requirements ------------------------------ Before you install the Floppy Tape EFS, you must already have installed your operating system, either: o SCO UNIX System V/386 Release 3.2 Version 2.0 o SCO Open Desktop Version 1.1.0 with Update F The Link Kit package must be installed in the operating system before installing the Floppy Tape EFS; without the Link Kit, you cannot install the supplement. The Floppy Tape EFS does not have memory or disk requirements beyond those required by SCO UNIX System V. If you wish to install the Maintenance Supplement Version 1.0 for SCO UNIX System V/386 Release 3.2 Version 2.0, we recommend that you do so before installing the Floppy Tape EFS. If you install the Maintenance Supplement after the Floppy Tape EFS, you will have a version of the tape(C) and tape(HW) on-line man pages installed on your system which is incorrect for the Floppy Tape EFS. You must know how your floppy tape drive is configured (that is, whether the drive is in Hard/Drive Select or Soft Select mode) before installing the Floppy Tape EFS. Refer to the hardware manufacturer's manual for your drive to ensure that the hardware is configured properly. 2.2 Installation Procedure --------------------------- To install the Floppy Tape EFS under SCO UNIX System V, follow this procedure: 1. Log in as root and enter the following command to shut down the system: /etc/shutdown -g0 -y When the system reboots, you are prompted to either press d or enter the root password. 2. Type the root password and press to enter system mainte- nance mode. 3. Enter the following command: custom ++ sysadmsh users select: System->Software The main custom menu appears: --------------------------------------------- begin screen display --- Custom Install Remove List Quit Install software SCO System V Operating System --------------------------------------------- end screen display ----- 4. The menu is already set to select Install; press to con- tinue. 5. You see the next screen: --------------------------------------------- begin screen display --- Install Select a product to install and press Press to cancel, movement keys are active Select a product : [ ] Choose an option : [ Entire Product ] Packages Files *A New Product SCO System V Operating System --------------------------------------------- end screen display ----- A New Product is highlighted. Press and the Entire Pro- duct option is highlighted. Press once again. (If you have SCO Open Desktop or other products installed, your list of products may be different.) 6. The following menu appears: --------------------------------------------- begin screen display --- Install Insert the requested volume and press to continue the installation Insert: Distribution Floppy Volume 1 Continue Quit --------------------------------------------- end screen display ----- Insert the appropriate product distribution disk as instructed and press . Shortly after you do so, you are prompted again to insert the first volume, this time by its actual name, Floppy Tape EFS. Simply press . The message Extracting files ... is displayed; after a few seconds, the screen clears and displays Executing Floppy Tape EFS Init Script. 7. After a short time, you see the initial System Configuration values for the Floppy Tape EFS: --------------------------------------------- begin screen display --- Executing Floppy Tape EFS Init Script System Configuration Drivetype: FT_QIC40; Select mode: FT_HARD_SELECT; Driver allocation done at: FT_INIT_TIME; Min number of buffers: 3; Max number of buffers: 8; The ft driver is: INACTIVE This configuration can be changed by running mkdev tape before relinking. (Or modifying /etc/conf/pack.d/ft/space.c) The currently installed functionality will not become active until you run mkdev tape, then relink and reboot the kernel. Press return to continue --------------------------------------------- end screen display ----- The values shown are the EFS defaults unless a floppy tape driver has been previously installed. In this case, defaults are taken from the previous installation. You are reminded that the currently installed functionality does not become active until you run mkdev tape, relink the kernel, and reboot the system. Press to continue. 8. If the QIC-40/QIC-80 driver has not been previously installed (that is, if the ft driver appears INACTIVE in the previous menu), go to step 9. If it was installed, the current System Configuration values were displayed in the previous screen and you are asked if you would like to relink the kernel. Answer no, unless you want to keep the current configuration, which is, QIC-40 in Hard Select mode without extended length tape func- tionality. 9. When the product installation is complete, press any key to con- tinue; you then return to the custom menu. If you are finished, exit custom by selecting Quit from the main custom menu and con- firming your selection. To activate the driver or to change the current configuration, follow the instructions in the next sec- tion, `Configuring the Floppy Tape EFS.' 3. Configuring the Floppy Tape EFS =================================== Once the Floppy Tape EFS is installed, you must configure it and relink the kernel before it is operational. ********************************************************************* NOTE It will be helpful to have the manual for your tape drive available to assist you during the configuration process. ********************************************************************* To configure the floppy tape driver, follow this procedure: 1. Enter the following command to shut down the system: /etc/shutdown -g0 -y When the system reboots, you are prompted to either press d or enter the root password. 2. Type the root password and press to enter system maintenance mode. 3. Enter the following command: mkdev tape ++ sysadmsh users select: System->Hardware->Tape 4. You see the following menu: --------------------------------------------- begin screen display --- Tape Drive Configuration Program 1. Install a Tape Drive 2. Remove a Tape Drive 3. Change default Tape Drive Select an option or enter q to quit: --------------------------------------------- end screen display ----- Enter 1 to add the drive. 5. You are asked to select the type of tape drive you want to install: --------------------------------------------- begin screen display --- Tape Drive Installation Menu 1. Install Cartridge Tape Drive 2. Install Mini-Cartridge Tape Drive 3. Install QIC-40 or QIC-80 Tape Drive 4. Install SCSI Tape Drive Select an option or enter q to return to the main menu: --------------------------------------------- end screen display ----- Enter 3. 6. You are asked to select the drive type, QIC-40 or QIC-80: --------------------------------------------- begin screen display --- 1. Install a QIC-40 Tape Drive 2. Install a QIC-80 Tape Drive Select an option or enter q to return to the main menu: --------------------------------------------- end screen display ----- Select the appropriate option. If you are unsure of your choice, refer to the manual for your tape drive. 7. You are asked if you wish to enable extended tape length mode: --------------------------------------------- begin screen display --- 1. Do not enable Extended Length Mode 2. Enable Extended Length Mode Select an option or enter q to return to the main menu: --------------------------------------------- end screen display ----- Select the appropriate option; see the new tape(HW) manual page for further information. Refer to your tape drive manual to determine if your drive supports extended length mode. 8. You then see the following: --------------------------------------------- begin screen display --- Enter one of the following: 1-4 the drive select unit number for the QIC-40 or QIC-80 Tape Driver s a Soft Select mode drive with no select jumpers installed Return the default value of 2 Select an option or enter q to return to the main menu: --------------------------------------------- end screen display ----- Select the appropriate option; refer to your hardware manual to determine your drive's current drive select option setting, or if your drive is in Soft Select mode. See Section 5, "Setting Drive Select or Soft Select," for additional information. The system configuration is updated and the new device files are created and displayed on the screen: --------------------------------------------- begin screen display --- Updating system configuration ... System files have been successfully updated. The following special devices have been created: /dev/rft0 /dev/xft0 Default special devices have been created with the following links: /dev/rctmini linked to /dev/rft0 /dev/xctmini linked to /dev/xft0 --------------------------------------------- end screen display ----- See Chapter 8 of the System Administrator's Guide for information on changes to boot messages and /etc/default files. 9. If no other tape drive is previously installed, go to step 10. If another tape drive is installed and currently listed as the default, you will see the following screen: --------------------------------------------- begin screen display --- Another Tape Drive is currently listed as the default in /etc/default/tape. Do you wish to change this to the current QIC-40 or QIC-80 Tape Drive? (y/n) --------------------------------------------- end screen display ----- Select the appropriate option. 10. You are then returned to the Tape Drive Configuration Program menu. Enter q to exit this menu unless you wish to perform other tape drive tasks. If you do, enter q when you are finished. 11. The following prompt appears: --------------------------------------------- begin screen display --- You must create a new kernel to effect the driver change you specified. Do you wish to create a new kernel now? (y/n) --------------------------------------------- end screen display ----- Enter y to relink the kernel and to have it recognize the QIC- 40/QIC-80 drive. Enter y for the remaining prompts until you are prompted to reboot. 12. To reboot, remove the Floppy Tape EFS distribution diskette from the floppy drive and enter the following command at your shell prompt: /etc/shutdown -g0 -y You must reboot with the new kernel to activate your kernel modifications. 4. Removing the Floppy Tape EFS ================================ You cannot remove the Floppy Tape EFS using custom. The driver may be removed from the kernel using mkdev tape. This section describes how to deconfigure (or disable) the floppy tape driver using the mkdev tape utility. ********************************************************************* Warning Do not use custom to remove the Floppy Tape EFS. Doing so may corrupt the Link Kit and require you to reinstall and reconfigure the kernel. ********************************************************************* To deconfigure the floppy tape driver, follow this procedure: 1. Log in as root and enter the following command to shut down the system: /etc/shutdown -g0 -y When the system reboots, you are prompted to either press d or enter the root password. 2. Type the root password and press to enter system mainte- nance mode. 3. Enter the following command: mkdev tape ++ sysadmsh users select: System->Hardware->Tape The following menu appears: --------------------------------------------- begin screen display --- Tape Drive Configuration Program 1. Install a Tape Drive 2. Remove a Tape Drive 3. Change default Tape Drive Select an option or enter q to quit: --------------------------------------------- end screen display ----- Enter 2 to deconfigure the drive. 4. You are then asked to select the type of installed tape drive you wish to remove: --------------------------------------------- begin screen display --- Tape Drive Removal Menu 1. Remove Cartridge Tape Drive 2. Remove Mini-Cartridge Tape Drive 3. Remove QIC-40 or QIC-80 Tape Drive 4. Remove SCSI Tape Drive Select an option or enter q to return to the main menu: --------------------------------------------- end screen display ----- Enter 3. 5. You see the following messages: --------------------------------------------- begin screen display --- Updating system files to effect removal of driver ... System files have been updated. Removing default tape devices. QIC-40 or QIC-80 Tape Driver and associated devices have been removed. --------------------------------------------- end screen display ----- You are then returned to the Tape Drive Configuration Program menu. When you quit, you are asked if you wish to relink the kernel. Answer yes for the remaining prompts. 5. Setting Drive Select or Soft Select ======================================= This section gives additional information for configuring your drive using the mkdev tape utility. If you are using drive select [1-4] with your QIC-40 or QIC-80 tape drive, you need to physically set the drive select position on the drive. For example, if you are configuring your tape drive as the second device on your floppy controller, set the physical drive select jumper on your tape drive to the second position and indicate ``2'' for the drive select unit number on the mkdev tape menu. Some QIC-40 and QIC-80 tape drives have a Soft Select mode. The most common use of Soft Select is to allow the tape drive to be attached to the floppy controller as a third device when the floppy controller only supports two physical devices. It is also possible to use Soft Select in the following scenarios: 1. when the floppy tape drive is one of two physical devices attached to a floppy controller that supports only two devices 2. when the floppy tape drive is one of three or four physical dev- ices attached to a floppy controller that supports four devices It is not possible to use Soft Select to configure your tape drive as a fifth device when the floppy controller supports four physical devices. This is a limitation of the operating system. (Consult your hardware manual to determine if your tape drive supports Soft Select mode.) If you are adding a QIC-40 or QIC-80 tape drive in Soft Select mode, remove any drive select jumpers on the tape drive and consult your hardware manual for additional instructions (if any) for configuring your drive in Soft Select mode. You then pick the ``s'' option for Soft Select from the mkdev tape menu. 6. Notes ========== This section describes issues you should be aware of concerning the Floppy Tape EFS. 6.1 Installation and /usr/lib/mkdev/tape ----------------------------------------- During installation of the Floppy Tape EFS, the existing /usr/lib/mkdev/tape file (used when running mkdev tape) is backed up under the file /usr/lib/mkdev/.tape.ftefs. If you need to access your original /usr/lib/mkdev/tape file, issue the command /usr/lib/mkdev/.tape.ftefs instead of /usr/lib/mkdev tape. 6.2 Installation and Korn Shell -------------------------------- If you are installing or configuring the Floppy Tape EFS using mkdev tape under the Korn shell, you may see the following message when mkdev tape is creating the floppy tape devices: mk_nodes[nnn]: ft: bad number (where nnn is a three digit number) This message only occurs when using the Korn shell and has no affect on the functionality of the driver or in the creation of the floppy tape devices. This message does not occur when using the C-shell or the Bourne shell. Therefore it is recommended that you use the C-shell or the Bourne shell when installing or configuring the Floppy Tape EFS using mkdev tape. 6.3 QIC-40XL Format Compatibility ---------------------------------- The QIC-40 extended length capability is not fully described in the QIC-40 specification. Therefore, we cannot guarantee compatibility when QIC-40 extended length cartridges, formatted under SCO UNIX System V, are used on a non-SCO system, or vice versa. 6.4 System Floppy Controller Connections ----------------------------------------- The Floppy Tape drive must be connected to the system floppy controller. Secondary floppy controllers are not supported. 6.5 Simultaneous Access to Floppy Tape and Floppy Disk ------------------------------------------------------- The floppy tape and the floppy disk share the same system resources (such as address, DMA, and interrupt vector), preventing access by an operation when either device is depending on the other for completion. Attempts for simultaneous access may cause a deadlock condition when one device (the floppy tape) has not released the system resources and the other device (the floppy disk) requires the system resources for part of the operation. An example of this is a copy operation between the floppy disk and floppy tape using: dd if=/dev/rfd096ds15 of=/dev/rft0 In this case, data is transferred from the floppy disk to the floppy tape. However, a deadlock condition may occur between the floppy tape and floppy disk if the floppy disk needs system resources to complete its task while the floppy tape is holding on to the system resources. Multiple operations that access the floppy tape or floppy disk may be executed simultaneously as long as they are independent of each other, that is, there is no interaction between the operations). An example of this is: o one user accesses the floppy drive by executing: tar tvf /dev/rfd096ds15 o a second user accesses the floppy tape by executing: tar tvf /dev/rft0 In this situation, the operations will take turns using system resources until they are completed, although the floppy tape will hold the system resources most of the time. An exception to this is when the tape access is a tape format command. During formatting, there is no sharing of system resources. Simultaneous access to the floppy drive during a tape format will wait until formatting is completed. 6.6 Floppy Cables and System Set-up -------------------------------------- Some systems may have specific cabling and system set up requirements for attaching a floppy tape device to your system. Consult your hardware manual for your system to determine if there are specific requirements such as: o cabling o cable connector position o termination resistors o jumper settings 6.7 Memory Allocation During Device Open Time ---------------------------------------------- If you manually set the ft_alloc_switch variable in the file /etc/conf/pack.d/ft/space.c to change memory allocation from init time (default) to device open time, you may receive the following messages when using cpio, tar, dd, and tape commands (your specific installation may use /dev/rctmini and /dev/xctmini instead of /dev/rft0 and /dev/xft0): cpio: /dev/rft0: cannot create tar: cannot open: /dev/rft0 dd: cannot create: /dev/rft0: Not enough space tape: can't open: '/dev/xft0': Not enough space This may indicate that your system lacks enough memory at device open time for accessing the floppy tape. To ensure that sufficient memory is allocated, set the ft_alloc_switch variable in /etc/conf/pack.d/ft/space.c to FT_INIT_TIME to allocate memory during system initialization time. See the tape(HW) manual page section `Floppy Tape Drive Configuration and Media' for information on the ft_alloc_switch variable. 6.8 Killing Tape Processes --------------------------- The command kill -9 PID (where PID is a process ID) does not kill a tape process. The floppy tape is required to run at a high system priority level and cannot be killed. You must wait for the process to complete. 7. Supported Hardware ====================== The Floppy Tape EFS supports the following floppy tape drives: Manufacturer Drive Format Select Mode Hard Soft ____________________________________________________________ Archive XL5540 QIC-40 yes no* Archive XL5580 QIC-80 yes no* Archive [mc]- XL3540 QIC-40 yes no* Archive [mc] XL3580 QIC-80 yes no* Mountain TD4000 internal QIC-40 yes yes Mountain Filesafe4000 internal QIC-40 yes yes Mountain TD8000 internal QIC-80 yes yes Mountain Filesafe8000 internal QIC-80 yes yes Mountain [mc] TD4000 internal QIC-40 yes yes Mountain [mc] Filesafe4000 internal QIC-40 yes yes Mountain [mc] TD8000 internal QIC-80 yes yes Mountain [mc] Filesafe8000 internal QIC-80 yes yes TecmarTM QT-40I QIC-40 yes no Tecmar MiniVault 120I QIC-80 yes no Tecmar [mc] QT-40I/PS QIC-40 yes no Tecmar [mc] MiniVault 120I/PS QIC-80 yes no Wangtek FAD 3500 QIC-40 yes no Wangtek 3040F QIC-40 yes no Wangtek 3080F QIC-80 yes no Wangtek [mc] FAD 3500 QIC-40 yes no Wangtek [mc] 3040P QIC-40 yes no Wangtek [mc] 3080P QIC-80 yes no * later model drives may support Soft Select; consult the manufacturer for further information - [mc] indicates drives supported for the Microchannel Architecture The Floppy Tape EFS driver is designed to conform to the relevant QIC specifications, principally, QIC-40, QIC-80, and QIC-117.