ESC Host Adapter Supplement Release and Installation Notes Version 1.2.0 15 December 1990 1. Preface The ESC Host Adapter Supplement provides your UNIX(r) System with the following: o an EISA (extended industry standard architecture) SCSI device driver that enables your computer to use the full capabilities of the EISA bus SCSI controller. (A device driver is a special pro- gram that is installed in the UNIX operating system to allow pro- grams and commands to be sent to or received from a hardware dev- ice.) o a standby power supply (SPS) package that allows your computer to continue working when power has failed if your system contains the optional SPS power unit. The SPS package includes an SPS background program (called a daemon). This daemon is automati- cally invoked when your computer is brought from single-user to multiuser mode at boot time. It detects A/C power failures and safely shuts down the system while it is running on battery power. In addition, the daemon writes messages to the front panel display to keep the operator apprised of power conditions. When installed, the daemon is stored in the /etc/sps_daem file. The /etc/rc2.d/S49sps file starts this daemon. o a device driver that permits messages to be written to the front panel display of your computer (if you have installed the ESC Host Adapter Supplement on a CP486 computer). The device file that is created is /dev/front_ panel. This device allows the SPS package to monitor the status of the power supply. You can also use this device name to write simple test messages to verify suc- cessful installation. The command for this test is described later in the ``Testing the Installation'' section. 2. Configuration Requirements You need the following resources to install and run the ESC Host Adapter Supplement: 15 December 1990 - 1 - The Santa Cruz Operation, Inc. Release Notes ______________________________________ |COMPUTER | DEC DS425 or | | | Olivetti EISA Sys- | | | tems CP486 or M486 | |______________|______________________| |OPERATING | UNIX System V/386 | |SYSTEM | Release 3.2v2.0 or | | | SCO Open Desktop (r) | | | Release 1.0.0 or SCO | | | Open Desktop Release | | | 1.1.0 (with Update | | | F) | |______________|______________________| |DISK CAPACITY | No additional | | | storage space is | | | needed for this sup- | | | plement | |______________|______________________| |RAM | No additional RAM is | | | needed for this sup- | | | plement | |______________|______________________| 3. Installing the ESC Host Adapter Supplement After you have installed SCO UNIX System V/386 Release 3.2v2.0 or SCO Open Desktop Release 1.0.0 or 1.1.0, follow the steps outlined in the following procedure to install the ESC Host Adapter Supplement using the custom utility. You should install the ESC Host Adapter Supple- ment after you install the operating system installation but before you install any other software. ********************************************************************* NOTE If you have already installed Open Desktop 1.0 with Maintenance Sup- plement UFE, please refer to the section ``Installation Order with Open Desktop and UFE'' later in these notes for special installation instructions. ********************************************************************* During this installation procedure, if you have previously configured a Keyboard Mouse for use on your system (such as during the installa- tion of Open Desktop), you are prompted if you want to change the reference from Keyboard Mouse to Olivetti New Advanced Mouse. Change the reference if you are using an Olivetti New Advanced Mouse to allow the software to conform to Olivetti documentation. Changing the reference has no effect on mouse performance. You are not prompted to change the reference if there is no Keyboard Mouse configured on the system. However, the init script adds the Olivetti New Advanced Mouse to the list of mouse drivers that are supported by the mkdev mouse utility. 15 December 1990 - 2 - The Santa Cruz Operation, Inc. ESC Host Adapter Supplement To install the ESC Host Adapter Supplement, follow these steps: 1. Reboot the system and enter single-user mode. You must be in single-user mode to install the ESC Host Adapter Supplement. 2. Type custom and press . Select Install from the initial custom menu, then select A New Product from the next menu. 3. Choose the menu selection Entire Product from the displayed menu. This selection installs the ESC Host Adapter Supplement operating system supplement package. 4. You are prompted to insert Distribution Volume 1. Insert the ESC Host Adapter Supplement diskette into floppy drive 0 and press to continue. You see the messages Installing custom data files..., Executing Product Prep Script, and Creat- ing file lists.... 5. You are prompted to insert the ESC Host Adapter Supplement Volume 1. Because you have already inserted it, press to continue. 6. If you are installing on Open Desktop, you see a copyright mes- sage after the volume is extracted. You are prompted to enter the serial number and the activation key. Enter the same number and key that were supplied with the operating system. If you are not installing on Open Desktop, skip to the next step. 7. This message is displayed: EISA Driver Installation The following supplemental drivers will be installed: esc - EISA SCSI adapter driver fpan - front panel driver The front panel driver requires that the Streams driver be configured into the kernel. The EISA driver installation procedure will configure Streams automatically. 8. As the drivers are installed, messages announcing that they were added are displayed. 9. If you have previously selected a Keyboard Mouse for use on your system, you are shown a list of terminals on which the Keyboard Mouse is configured for use. You are asked if you want to change all references from Keyboard Mouse to Olivetti New Advanced Mouse. Enter y if you want to change the reference, n if you want to leave the reference as Keyboard Mouse. 15 December 1990 - 3 - The Santa Cruz Operation, Inc. Release Notes 10. You are prompted if you want to create a new kernel. ********************************************************************* NOTE If you have already installed Open Desktop 1.0 with Maintenance Sup- plement UFE, please refer to the section ``Installation Order with Open Desktop and UFE'' for special installation instructions before relinking the kernel. ********************************************************************* Enter y. 11. This message is displayed: The UNIX Operating System will now be rebuilt. This will take a few minutes. Please wait. You may also see this message: warning: no dma channel specified for scsi device: prefix oha You can ignore this warning, even if it is displayed more than once. 12. You are prompted to decide if the new kernel is to boot by default. Enter y. 13. After the operating system is rebuilt, you are prompted to decide if you want the kernel environment rebuilt. Enter y. 14. The message Press any key to continue is displayed. Press any key. You see the message Checking file permissions. 15. The custom menu is displayed. Select Quit to leave the custom menu, and enter y to exit custom. 16. Remove the distribution volume from the floppy drive. 17. Type reboot and press . 4. Installation Order with Open Desktop 1.0 and UFE If you have already installed Open Desktop 1.0 and the Maintenance Supplement UFE on your system, follow this installation order: 1. Begin installing the ESC Host Adapter Supplement. When you are prompted to relink the kernel, be sure to answer n. 2. Press any key to return to the custom menu. 3. Use custom to install the Maintenance Supplement UFE again. Follow the instructions provided in the cover letter that accom- panies the supplement. Note that you can relink the kernel when you are prompted to do so. 15 December 1990 - 4 - The Santa Cruz Operation, Inc. ESC Host Adapter Supplement 4. Exit from custom. You can now install any other supplements. 5. Testing the Installation You can test the installation by using the front panel driver. Enter this command to display the phrase ``Hello, World'' on the front panel: echo -n "Hello, World" >> /dev/front_panel If the message is displayed, the front panel driver (and presumably the rest of the installation) was installed successfully. If you do not have a front panel display, execute the same command. If you receive no error messages, then the installation was success- ful. 6. Notes The following sections describe issues you should be aware of concern- ing the ESC Host Adapter Supplement. 6.1 WARNING: Accessing Raw Devices on an ODT 1.0.0 and Update E System If you are using SCO Open Desktop 1.0.0 and you have Update E installed on your system, you can access the raw device only in multi- ples of the device's block size. For a hard disk, this is 512 bytes. For example, when using the dd(C) utility on a hard disk raw device, you cannot use the bs=block_size option unless block_size is some mul- tiple of 512 bytes. Failure to heed this warning can result in freezing, or hanging, your system. If this occurs, you must reboot the system. This restriction does not apply if your system is running UNIX System V/386 Release 3.2v2.0 SCO Open Desktop 1.1.0, nor does it apply if your system is running SCO Open Desktop 1.0.0 but you do not have Update E installed. 6.2 Reinstalling the Link Kit If you need to reinstall the Link Kit after you have installed the ESC Host Adapter Supplement, you must reinstall the supplement before con- figuring the kernel. ********************************************************************* NOTE Reinstalling the Link Kit if you are using Open Desktop 1.0 is not advised. ********************************************************************* 15 December 1990 - 5 - The Santa Cruz Operation, Inc. Release Notes 6.3 Relinking the Kernel Each time that you relink the kernel, you may see this message: warning: no dma channel specified for scsi device: prefix oha You can continue to ignore this message. 6.4 Extended Memory Support If you are installing on an Open Desktop 1.0.0 system, the ESC Host Adapter Supplement provides extended memory support. The extended memory support allows your system to recognize and use up to 256 MB of RAM. 6.5 Tape Drive Accessing Delay If you are installing the ESC Host Adapter Supplement on a machine with less than 4 megabytes (MB) of RAM, there is a two-minute delay in accessing the tape drive. This does not occur if you use 8 MB of RAM. 7. Selecting Boot and Root Devices When your system boots, the Basic Input/Output System (BIOS) searches for a hard disk device, or boot device, from which to load the operat- ing system. Once the BIOS passes control to the operating system, the operating system looks for its root filesystem on a hard disk, or root device. The boot and root devices should match. The BIOS uses a standard search sequence to look for the boot device, first looking for a WD1007-type controller, then looking for other devices (such as a SCSI host adapter). The operating system dupli- cates this search sequence when locating the root device. Before you install the ESC Host Adapter Supplement, the ESC-1 host adapter board emulates a WD1007-type controller by default, for AT compatibility. The operating system finds this emulated WD device first and uses the ESC-1 AT compatibility mode for a boot device. This mode is a low-performance mode that does not take advantage of SCSI or ESC-1 features. Installing the ESC host adapter supplement modifies the system's default search sequence so that the system searches for SCSI devices first. This new search sequence allows the system to find ESC-1 and use it as a high-performance, SCSI host adapter. After you install the supplement, you can change the default so that the search sequence again looks for WD1007-type controllers first. You need to make this change if you have both a WD1007-type controller and an ESC-1 host adapter on your system, to match the boot and root devices. After you reset the search sequence to look for WD1007-type controllers first, the WD disk is both the root and boot device, and any SCSI disks are secondary. 15 December 1990 - 6 - The Santa Cruz Operation, Inc. ESC Host Adapter Supplement To configure the system to boot using the WD disk driver, you must change the variable root_on_Sdsk in the file /etc/conf/pack.d/hd/space.c. Use a text editor, such as vi(C), to set this variable as follows: o Set the variable to 0 (zero) to boot using the WD disk drive or to boot using the SCSI disk in AT Emulation mode if no other disks are present. o Set the variable to 1, which is the default, to boot using a ESC Disk Controller. After altering the variable in the space.c file you must relink the kernel to activate your changes. To relink the kernel, first change to the /etc/conf/cf.d directory: cd /etc/conf/cf.d Enter the following command to relink the kernel: ./link_unix 8. Advanced SPS Operation The effects of an unexpected power outage on a multiuser computer sys- tem are substantially greater than for a standalone system. For that reason, your system supports a more advanced method of SPS operation when installed on the Olivetti CP486 and when acting as a file-server in a multiuser environment. This allows automatic ``graceful'' shut- downs to be performed under operating-system control, without the need for system administrator intervention. This feature is currently sup- ported by the latest version of SCO UNIX System V/386 as described in the following procedure: 1. A loss of external power of less than 20 seconds has no immedi- ate effect on the system; the SPS switches in to supply system power and the LCD panel displays: STANDBY POWER ON If external power is restored in that time, the system switches back to external power and the message returns to the default message (usually SYSTEM ACTIVE ). 2. If external power is still absent after 20 seconds, the UNIX System starts a graceful shutdown procedure, called a ``power- fail process,'' and the LCD panel displays alternately: SHUTDOWN IN PROGRESS and STANDBY 15 December 1990 - 7 - The Santa Cruz Operation, Inc. Release Notes 3. The powerfail process records the information necessary to res- tart the system at the next power-up and broadcasts a warning message to all users of the system (terminals in remote loca- tions might not be directly affected by the power outage). UNIX processes are forewarned and terminated 40 seconds later, and the powerfail process logs the event and finishes with a call to the system console for a conditional power-down. 4. A conditional power-down means that: o If external power was not restored, the console switches off the system. o If external power is restored, but the SPS battery voltage is too low, then the console still switches off the system. o If external power is restored and the SPS batteries contain sufficient charge to support another outage, then the sys- tem resets and does not power down. 5. The front panel stays on even after the computer has been shut down. The LCD panel displays: PROG SHUTDOWN 6. When power is restored after the system has been switched off, the system reboots automatically. 15 December 1990 - 8 - The Santa Cruz Operation, Inc. ESC Host Adapter Supplement Release and Installation Notes Version 1.2.0 1. Preface 1 2. Configuration Requirements 1 3. Installing the ESC Host Adapter Supplement 2 4. Installation Order with Open Desktop 1.0 and UFE 4 5. Testing the Installation 5 6. Notes 5 6.1 WARNING: Accessing Raw Devices on an ODT 1.0.0 and Update E System 5 6.2 Reinstalling the Link Kit 5 6.3 Relinking the Kernel 6 6.4 Extended Memory Support 6 6.5 Tape Drive Accessing Delay 6 7. Selecting Boot and Root Devices 6 8. Advanced SPS Operation 7 15 December 1990 - i - The Santa Cruz Operation, Inc.