Diskless_Driver_for_Digital_UNIX______________ Installation Guide December 1996 This guide describes how to install and use Diskless Driver for Digital UNIX on a system running the Digital UNIX operating system. It also descibes how to access the online release notes before or after installing the product. Revision/Update Information: This is a new guide. Operating System & Version: Digital UNIX. See SPD 56.37.xx for supported versions. Software Version: Diskless Driver for Digital UNIX Version 2.0 Digital Equipment Corporation Maynard, Massachusetts __________________________________________________________ First Printing, July 1996 Revised, December 1996 The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013. © Digital Equipment Corporation 1996. All Rights Reserved. The postpaid Reader's Comments forms at the end of this document request your critical evaluation to assist in preparing future documentation. The following are trademarks of Digital Equipment Corporation: Alpha AXP, AXP, DEC, Digital, Digital UNIX, and the DIGITAL logo. The following are third-party trademarks: X Window System, Version 11 and its derivations (X, X11, X Version) are trademarks of the Massachusetts Institute of Technology. UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Ltd. Open Software Foundation, OSF, the OSF logo, OSF/1, OSF/Motif, and Motif are trademarks of the Open Software Foundation, Inc. POSTSCRIPT[R] and Adobe are registered trademarks of Adobe Systems Incorporated. X/Open is a trademark of the X/Open Company, Ltd. in the U.K. and other countries. System V and AT&T are registered trademarks of American Telephone & Telegraph Company in the U.S. and other countries. BSD is a trademark of University of California, Berkeley. NFS is a trademark of Sun Microsystems, Inc. All other trademarks are registered trademarks are property of their respective holders. ________________________________________________________________ Contents Preface.................................................. v 1 Preparing for Diskless Driver for Digital UNIX Installation 1.1 Product Overview................................ 1-1 1.2 Reading the Online Release Notes................ 1-2 1.3 Registering Your Software License .............. 1-2 1.4 Checking the Software Distribution Kit.......... 1-3 1.5 Checking Installation Procedure Requirements.... 1-4 1.5.1 Checking Login Privileges .................... 1-4 1.5.2 Checking Hardware Requirements ............... 1-4 1.5.3 Checking Software Requirements ............... 1-5 1.5.4 Determining Which Subsets to Load ............ 1-6 1.5.5 Determining Disk Space Requirements .......... 1-6 1.6 Installing from Media or Using RIS.............. 1-8 1.7 Backing Up Your System Disk..................... 1-9 1.8 Stopping the Installation....................... 1-9 2 Installing Diskless Driver for Digital UNIX 2.1 Installing from the CD-ROM...................... 2-1 2.2 Installing from a RIS Distribution Area ........ 2-2 2.3 Responding to Installation Procedure Prompts.... 2-3 2.3.1 Selecting Subsets ............................ 2-3 2.3.2 Monitoring Displays During the Subset Loading Process....................................... 2-4 iii 3 After Installation 3.1 Running the Installation Verification Procedure ................................................ 3-1 3.2 Configuring Diskless Driver for Digital UNIX.... 3-1 3.3 Disabling Local Paging.......................... 3-2 3.4 Advanced DDU Options............................ 3-2 3.4.1 Boosting the System Pager Thread Priority .... 3-3 3.4.2 Adjusting the Number of Diskless Worker Threads....................................... 3-3 3.4.3 Example: Editing sysconfigtab To Increase Available Threads and Boost Pager Priority.... 3-3 3.5 Tuning the Virtual Memory Subsystem............. 3-3 3.6 Deleting Diskless Driver for Digital UNIX from Your System..................................... 3-4 3.7 Displaying Documentation from CD-ROM............ 3-5 A Sample Listings A.1 Sample Diskless Driver for Digital UNIX Installation Using the setld Command............ A-1 A.2 Sample Diskless Driver for Digital UNIX Installation Using the dmu Utility.............. A-3 A.3 Sample Client Configuration..................... A-8 B Recovering from Errors B.1 Failures During Product Installation ........... B-1 B.2 Failures During Product Use..................... B-2 B.3 Reporting Problems.............................. B-2 Index Tables 1 Conventions Used in this Guide .............. vi 1-1 Diskless Driver for Digital UNIX Subset Sizes (Kilobytes Required).......................... 1-7 iv ________________________________________________________________ Preface This installation procedure creates the Diskless Driver for Digital UNIX directory structures subordinate to the /usr/lib, /usr/bin, and /usr/man directories, and loads the Diskless Driver for Digital UNIX subset components into them. Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall Diskless Driver for Digital UNIX for any other reason. Purpose of This Guide This guide describes how to install and use Diskless Driver for Digital UNIX on a system running the Digital UNIX operating system. Intended Audience This guide is intended for system managers who install Diskless Driver for Digital UNIX. Associated Documentation In addition to this guide, installers should refer to: o Guide to Sharing Software Over a LAN v Conventions Table 1 describes the conventions used in this guide. Table_1_Conventions_Used_in_this_Guide____________________ Convention_____Meaning____________________________________ # A pound sign (#) is the default superuser prompt. % A percent sign (%) is the default user prompt. In examples, a boxed symbol indicates that you must press the named key on the keyboard. Ctrl/C This symbol indicates that you must press the Ctrl key while you simultaneously press another key (in this case, C). user input In interactive examples, this typeface indicates input entered by the user. filesystem In text, this typeface indicates the exact name of a command, routine, partition, pathname, directory, or file. This typeface is also used in interactive examples and other screen displays. UPPERCASE The Digital UNIX operating system lowercase differentiates between lowercase and uppercase characters. Examples, syntax descriptions, function definitions, and literal strings that appear in text must be typed exactly as shown. (continued on next page) vi Table_1_(Cont.)_Conventions_Used_in_this_Guide____________ Convention_____Meaning____________________________________ setld(8) Cross-references to online reference pages include the appropriate section number in parentheses. For example, setld(8) indicates that you can find the material on the setld command in Section 8 of the reference pages. [y] In a prompt, square brackets indicate that the enclosed item is the default response. For example, [y] means the default response _______________is_Yes.____________________________________ vii 1 ________________________________________________________________ Preparing for Diskless Driver for Digital UNIX Installation Your distribution kit includes a cover letter discussing important information that might not be included in this guide or in release notes. You should read this letter now. The letter also resides on the online documentation CD- ROM, in the Diskless Driver for Digital UNIX bookshelf, under the title Diskless Driver for Digital UNIX Read Before Installing. 1.1 Product Overview Diskless Driver for Digital UNIX is an extension of Dataless Management Services (DMS). DMS is required for installation and use of Diskless Driver for Digital UNIX. In a dataless management environment, a server system maintains the root, /usr, and /var file systems for all client systems. The server maintains one copy of root for each client. The /usr file system is exported read only and is shared by all clients registered to the environment. Client systems have their own /var file system. All swapping and dumping is done on the client's local disk. When used with DMS, Diskless Driver for Digital UNIX eliminates the need for a local disk. A Single Board Computer (SBC) or workstation can run Digital UNIX without a disk by booting over the network and paging to a server system using the Network File System (NFS). The features of Diskless Driver for Digital UNIX are desirable to customers who need to place their system in hostile environments (for example, on airplanes, ships, or tanks) where disks tend to be the first component to fail. Diskless Driver for Digital UNIX will allow them to Preparing for Diskless Driver for Digital UNIX Installation 1-1 Preparing for Diskless Driver for Digital UNIX Installation 1.1 Product Overview boot and page over the network from a server outside the hostile environment or from a system in the environment containing ruggedized disks. 1.2 Reading the Online Release Notes Diskless Driver for Digital UNIX provides online release notes. Digital strongly recommends that you read the release notes before using the product. The release notes may contain information about changes to the software. Online release notes in text format are supplied in an optional installation subset and are placed in the directory /usr/opt/DDU200. The release notes for Diskless Driver for Digital UNIX are in the following file: /usr/opt/DDU200/ddu200_relnotes.* For information about installing these release notes before installing Diskless Driver for Digital UNIX, see Section 2.3.1. The release notes are provided in PostScript and text formats. You can use the following command to read the text version of the release notes after Diskless Driver for Digital UNIX is installed: % more /usr/opt/DDU200/ddu200_relnotes.txt 1.3 Registering Your Software License Diskless Driver for Digital UNIX includes support for the License Management Facility (LMF). You must register your License Product Authorization Key (License PAK) in the License Database (LDB) in order to use Diskless Driver for Digital UNIX on a newly licensed node. The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order. If you are installing Diskless Driver for Digital UNIX as an update on a node already licensed for this software, you have already completed the License PAK registration requirements. 1-2 Preparing for Diskless Driver for Digital UNIX Installation Preparing for Diskless Driver for Digital UNIX Installation 1.3 Registering Your Software License If you are installing prerequisite or optional software along with the Diskless Driver for Digital UNIX software, review the PAK status and install the PAKs for any prerequisite or optional software before you install Diskless Driver for Digital UNIX. To register a license under the Digital UNIX operating system, first log in as superuser. You then have a choice of two ways to perform the PAK registration in the License Database (LDB): o Before installing Diskless Driver for Digital UNIX At the superuser prompt, edit an empty PAK template with the lmf register command and include all the information on your License PAK as follows: # lmf register o After installing Diskless Driver for Digital UNIX At the superuser prompt, edit the partially completed PAK template in /usr/var/adm/lmf/DDU-BASE with the lmf register command to add your unique License PAK information as follows: # lmf register -