Software Product Library CD-ROM User's Guide AA-QDGSE-XE September 1999 This guide describes how to mount and control access to the Software Product Library CD-ROMs, use the CDMENU utility, access the contents of the CD-ROMs, and install layered products from the CD-ROMs. This guide also describes how to access ECOs and MUPs for users who have purchased the Consolidated Software Engineering Change Order distribution. Platforms Supported: OpenVMS VAX OpenVMS Alpha Tru64 UNIX Revision/Update Information: This is a revised document. Compaq Computer Corporation Houston, Texas ________________________________________________________________ September 1999 The optical disc publication and all component parts as appearing herein are copyrighted. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Compaq Computer Corporation or an authorized sublicensor. Compaq Computer Corporation shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is subject to change without notice. (c) 1999 Compaq Computer Corporation COMPAQ, the Compaq logo, and the Digital logo are Registered in the U.S. Patent and Trademark Office. UNIX is a registered trademark and The Open Group is a trademark of The Open Group in the US and other countries. Other product names mentioned herein may be the trademarks of their respective companies. _________________________________________________________________ Contents Preface................................................... v 1 Overview of the CD-ROM User's Guide 1.1 About These CD-ROMs .......................... 1-1 1.1.1 Before Using the CD-ROMs ................. 1-1 1.1.2 Handling the CD-ROMs...................... 1-1 1.2 Product Licensing Agreements.................. 1-2 2 OpenVMS VAX Software Product Library 2.1 Mounting and Controlling Access to a CD-ROM... 2-1 2.2 Using the CDMENU Utility...................... 2-1 2.3 Accessing a Software CD-ROM................... 2-3 2.3.1 OpenVMS VAX CD-ROM Directory Structure.... 2-3 2.3.2 Release Notes and Other Documentation..... 2-5 2.3.3 Printing the Documents.................... 2-5 2.4 Installing Layered Products................... 2-6 2.4.1 Location of Product Save Sets and Installation Instructions................. 2-6 2.4.2 Installation Methods...................... 2-6 2.4.2.1 Using VMSINSTAL......................... 2-6 2.4.2.2 Using the POLYCENTER Software Installation Utility.................... 2-7 2.5 ECOs and MUPs................................. 2-8 3 OpenVMS Alpha Software Product Library 3.1 Mounting and Controlling Access to a CD-ROM... 3-1 3.2 Using the CDMENU Utility...................... 3-1 3.3 Accessing a Software CD-ROM................... 3-3 3.3.1 OpenVMS Alpha CD-ROM Directory Structure................................. 3-3 3.3.2 Release Notes and Other Documentation..... 3-5 3.3.3 Printing the Documents.................... 3-5 3.4 Installing Layered Products................... 3-6 3.4.1 Location of Product Save Sets and Installation Instructions................. 3-6 3.4.2 Installation Methods...................... 3-6 3.4.2.1 Using VMSINSTAL......................... 3-6 3.4.2.2 Using the POLYCENTER Software Installation Utility.................. 3-7 3.5 ECOs and MUPs................................. 3-8 iii 4 Compaq Tru64 UNIX Software Product Library 4.1 Mounting and Controlling Access to a CD-ROM... 4-1 4.2 Using the cdmenu Utility...................... 4-3 4.3 Accessing a Software CD-ROM................... 4-4 4.3.1 Tru64 UNIX CD-ROM Directory Structure................................. 4-5 4.3.2 Other Documentation....................... 4-8 4.3.3 Printing the Documents.................... 4-8 4.4 Installing Layered Products................... 4-9 4.4.1 Location of Product Subsets and Installation Instructions................. 4-9 4.4.2 Installation Methods...................... 4-9 4.4.2.1 Using setld............................. 4-9 4.5 ECOs and MUPs................................. 4-10 Index iv _________________________________________________________________ Preface This guide provides introductory information about the Software Product Library CD-ROMs. Contents of this Guide Chapter 1 begins with an overview, providing information about the Software Product Library CD-ROMs that is common to all platforms. Chapter 2 to Chapter 4 describe platform-specific information for the following platforms: o Chapter 2 describes OpenVMS VAX information. o Chapter 3 describes OpenVMS Alpha information. o Chapter 4 describes Compaq Tru64 UNIX information. The platform-specific information in Chapters 2 to 4 describes: o Mounting and controlling access to a CD-ROM o Using the CDMENU utility o Accessing information on a software CD-ROM o Installing layered products o ECOs and MUPs v Ordering Information Compaq Computer Corporation provides the following: o Product binaries - Through quarterly consolidated distributions - Through individual kit purchases o Product documentation - Through online documentation CD-ROMs included with the Software Product Library or as a separate consolidated offering - In printed format o ECO and MUP distribution - As a separate consolidated offering - On some platforms, MUPs may be part of the Software Product Library at the time of the platform's quarterly release For individual product ordering information, consult your Compaq account representative. Call 1-344-4825 to place orders in the United States. Contact your local Compaq subsidiary outside the United States. Order numbers for software kits, printed manuals, and software service are included in product cover letters or are listed on the SPDs. vi Conventions The following conventions are used in this guide: For OpenVMS platforms: ___________________________________________________________ Convention Meaning ___________________________________________________________ For OpenVMS platforms: ___________________________________________________________ UPPERCASE TEXT Uppercase letters indicate the name of a command, a file, a parameter, a procedure, or utility. $ The dollar sign ($) indicates the Digital Command Language (DCL) prompt on OpenVMS systems. This prompt may be different on your system. ___________________________________________________________ For Compaq[R] Tru64[TM] UNIX[R] systems: ___________________________________________________________ % The percent sign (%) indicates the user prompt on Tru64 UNIX systems. # The pound sign (#) indicates the system manager prompt on UNIX systems. Tru64 UNIX, References to Tru64 UNIX and Tru64 Tru64 UNIX Systems UNIX Systems refer to the Tru64 UNIX operating system running on Alpha processor hardware. ___________________________________________________________ For all platforms: ___________________________________________________________ $ MOUNT DKA400: Boldface monospace text represents VAXDOCMAR991 user input in interactive examples. $ mount -r /dev/rz4c/mnt device-name volume- Lowercase italics indicate a variable label string. These variables include product identifiers, hardware devices, directory locations, file names, and mount points. ___________________________________________________________ vii 1 _________________________________________________________________ Overview of the CD-ROM User's Guide The following information about the Compaq Software Product Library CD-ROMs applies to all platforms. 1.1 About These CD-ROMs The Compaq Software Product Library CD-ROMs compose a software delivery vehicle that allows you to receive an update of consolidated software products on a regular basis. This method of distribution does not change the content of any individual product. There is no impact on product compatibility; individual products are neither more nor less compatible with each other as a result of consolidated distribution. 1.1.1 Before Using the CD-ROMs Make sure you are familiar with the system hardware, including your CD-ROM drive. Refer to the Optical Disc Drive Owner's Manual for your CD-ROM reader for instructions on using the CD-ROM drive. 1.1.2 Handling the CD-ROMs The CD-ROMs accompanying this booklet are enclosed in an antistatic envelope. In handling the CD-ROM, always grasp it by its edges only. For information about inserting the CD-ROM in the disc drive, refer to the Optical Disc Drive Owner's Manual. 1-1 1.2 Product Licensing Agreements The media and the software programs contained on these CD-ROMs belong to Compaq. Use of the software products is authorized only if you have a valid software license from Compaq. Therefore, you must purchase the appropriate software license for each product you want to use from this consolidated distribution. A License Management Facility (LMF) Product Authorization Key (PAK) allows you to access a software product. A PAK must be registered and loaded before you can install the associated product from the Software Product Library CD-ROM. Each product has a unique LMF PAK name. Refer to your license agreements for license terms and conditions. See your operating system documentation for information on using the License Management Facility. 1-2 2 _________________________________________________________________ OpenVMS VAX Software Product Library This chapter describes how to use the OpenVMS VAX Software Product Library CD-ROMs. 2.1 Mounting and Controlling Access to a CD-ROM To access the files on an OpenVMS VAX Software Product Library CD-ROM, mount the CD-ROM using the following procedure: 1. Find the appropriate volume label on the face of the CD-ROM. 2. Log in to the system manager's account (SYSTEM). 3. Mount the CD-ROM by entering the MOUNT command in the following format: MOUNT device-name: volume-label For example: $ MOUNT DKA400: VAXBINMAR991 2.2 Using the CDMENU Utility The CDMENU utility provides a menu interface that helps you perform the following tasks easily: o Display a master index of all products o Display new and updated products o Fetch or copy release notes o Display and print installation guides and other documentation o Install products 2-1 To invoke the CDMENU utility: 1. Mount the CD-ROM as described in Section 2.1. 2. Define the logical name CD_DIRECTORY in your LOGIN.COM file. - To access a single CD-ROM, enter a command in the following format: $ DEFINE CD_DIRECTORY device-name:[CDROM] For example: $ DEFINE CD_DIRECTORY DKA400:[CDROM] - To access multiple CD-ROMs, define CD_DIRECTORY as a search list, entering a command in the following format: $ DEFINE CD_DIRECTORY device1:[CDROM],device2:[CDROM],device3:[CDROM] For example: $ DEFINE CD_DIRECTORY DKA200:[CDROM],DKA300:[CDROM],DKA400:[CDROM] 3. Define the logical name CD_EDIT to indicate the editor to use while displaying documentation on your screen. For example: $ DEFINE CD_EDIT LSE In this example, the Language Sensitive Editor (LSE) is invoked. 4. Enter the following command at the system prompt to invoke the CDMENU utility: $ RUN CD_DIRECTORY:CDMENU The CDMENU main menu is displayed. 5. Follow the directions on the screen to choose the option for the task you want to perform. 2-2 ________________________ Note ________________________ CDMENU assumes the CD-ROMs identified in the CD_DIRECTORY logical name definition are from the same release because it utilizes the first instance of CD_CONTENTS.DAT located in the [CDROM] directory. ______________________________________________________ 2.3 Accessing a Software CD-ROM OpenVMS VAX Software Product Library CD-ROMs contain directories for each product. These directories contain save sets of the binary images included in the software product and product installation documentation in PostScript and ASCII text formats. Each product directory begins with a unique name for that product. 2.3.1 OpenVMS VAX CD-ROM Directory Structure Table 2-1 shows the structure of the OpenVMS VAX Software Product Library CD-ROMs. The [README] directory, located on the first CD-ROM, contains the documents you should read first. In most cases, these documents are available in ASCII text and PostScript format. ________________________ Note ________________________ If present, the files SPECIAL_NOTES.TXT and SPECIAL_NOTES.PS in the [README] directory contain important information about specific products in this release. ______________________________________________________ For each product, the name of the root directory usually corresponds to the name of the product save set. The kit save sets are located in the KIT subdirectory. Documentation is located in the DOCUMENTATION subdirectory. 2-3 Table 2-1 OpenVMS VAX CD-ROM Directory Structure ______________________________________________________________ Directory File Contents ______________________________________________________________ [README] Documentation you should read first. CDMASTER_INDEX.PS Lists all products in this (.TXT) release, including which CD-ROM contains each product and the directory name for each product. SW_COMPAT_MATRIX.PS Indicates operating system (.TXT) versions that support each layered product. USER_GUIDE.PS (.TXT) User guides. SW_LICENSE_DOC.PS Software License (.TXT) Description. SPECIAL_NOTES.PS Contains last minute (.TXT) information on selected products. [CDROM] The CDMENU utility and related files. [product] Top level product directory, as shown in the OpenVMS VAX Software Product Library Master Index. [product.KIT] Product subdirectory containing save sets and/or .PCSI files. [product.DOCUMENTATION] Product subdirectory containing documentation in .PS and .TXT formats. product_IGUIDE.PS Installation guides. (.TXT) product_COVER.PS Cover letters. (.TXT) product_SPD.PS (.TXT) Software Product Descriptions. ______________________________________________________________ 2-4 2.3.2 Release Notes and Other Documentation Release notes for layered products are included in the kits and may be retrieved using the appropriate command in the VMSINSTAL utility or the POLYCENTER Software Installation utility. You may also use the CDMENU utility to perform this task (see Section 2.2). Other product documentation not listed in Table 2-1 is available in two ways: o On OpenVMS VAX Online Documentation Library CD-ROMs in an electronically viewable format o As individual product documentation sets in hardcopy format Either may be ordered separately by contacting your Compaq account representative. 2.3.3 Printing the Documents You can print the documentation for the OpenVMS VAX Software Product Library either by using the CDMENU utility (see Section 2.2) or by entering a DCL command. You do not need a product license to print these documents. See the OpenVMS VAX Software Product Library Master Index for pointers to product directory specifications. To print a document in Table 2-1 for text output, send the file to an ASCII printer by entering a command in one of the following formats: $ PRINT/QUEUE=queue_ANSI device:[README]file-name.TXT $ PRINT/QUEUE=queue_ANSI device:[product.DOCUMENTATION]file-name.TXT To print a document in Table 2-1 for PostScript output, send the file to a PostScript printer by entering a command in one of the following formats: $ PRINT/QUEUE=queue_POST device:[README]file-name.PS $ PRINT/QUEUE=queue_POST device:[PRODUCT.DOCUMENTATION]file-name.PS In the preceding examples, device represents the name of the drive on which you have placed your OpenVMS VAX Software Product Library CD-ROM. 2-5 2.4 Installing Layered Products This section describes how to install layered products on an OpenVMS VAX system. 2.4.1 Location of Product Save Sets and Installation Instructions The OpenVMS VAX Software Product Library Master Index gives the directory locations of the products on the software binaries CD-ROMs. This information is also available in the CDMASTER_INDEX.PS and CDMASTER_INDEX.TXT files in the [README] directory on the first CD-ROM. Installation information for each product, in PostScript and ASCII formats, is located in [product.DOCUMENTATION] directories, where product is the product directory name as given in the OpenVMS VAX Software Product Library Master You do not need a product license to print the information in these directories. Read the Ordering Information section in the product SPD for product ordering information. 2.4.2 Installation Methods Install layered products using one of the following methods: o Using the CDMENU utility (see Section 2.2). o Using the VMSINSTAL. o Using the POLYCENTER Software Installation utility. 2.4.2.1 Using VMSINSTAL Individual layered product kits are located in their own directory hierarchies. For this reason, when you install a layered product, you must use a VMSINSTAL command line that is slightly different from the one given in the product's installation guide. 2-6 When you enter the VMSINSTAL command line, specify the disc drive and the directory by entering a command in the following format: @SYS$UPDATE:VMSINSTAL product drive:[directory.KIT] For example: $ @SYS$UPDATE:VMSINSTAL FORT065 DKA400:[FORT065.KIT] Additionally, certain system privileges must be enabled before you run VMSINSTAL. You must be logged in to a privileged account (such as the system manager's account, SYSTEM) that has the SETPRV privilege or at least the following privileges enabled: o CMKRNL o SYSPRV o WORLD To check whether your process has SETPRV or other privileges enabled, enter the following command: $ SHOW PROCESS/PRIVILEGES 2.4.2.2 Using the POLYCENTER Software Installation Utility Beginning with OpenVMS VAX Version 6.1, some products can be installed using the POLYCENTER Software Installation utility. Not all products are available with this installation technology. Use a command in the following format to install one or more software products that support installations by means of POLYCENTER Software Installation utility: PRODUCT INSTALL product/VERSION=number /SOURCE=drive:[directory.KIT] For example: $ PRODUCT INSTALL DQS/VERSION=1.3 /SOURCE=DKA400:[DQS013.KIT] 2-7 Additionally, certain system privileges must be enabled before you install products. You must be logged in to a privileged account (such as the system manager's account, SYSTEM) that has at least the following privileges enabled: o BYPASS o CMKRNL o SYSLCK To check whether your process has these privileges enabled, enter the following command: $ SHOW PROCESS/PRIVILEGES To see whether a previous version of a product is installed, use the PRODUCT SHOW PRODUCT command. For example: $ PRODUCT SHOW PRODUCT FORTRAN Refer to the product's installation guide for more information on installing products using the POLYCENTER Software Installation utility. To use other features of the POLYCENTER Software Intallation utility, see the POLYCENTER Software Installation Utility User's Guide. 2.5 ECOs and MUPs This section describes the Consolidated Software Engineering Change Order distribution for OpenVMS VAX. This distribution provides ECOs and MUPs. Use these instructions if you have purchased the Consolidated Software Engineering Change Order distribution. ________________________ Note ________________________ To purchase the Consolidated Software Engineering Change Order distribution for OpenVMS VAX, contact your local service office. ______________________________________________________ 2-8 ECOs and MUPs are provided on a separate set of CD-ROMs. Table 2-2 describes the arrangement of files on these CD-ROMs. Table 2-2 OpenVMS VAX ECO and MUP CD-ROM Directory Structure ______________________________________________________________ Directory Contents ______________________________________________________________ [ECOname.KIT] ECO or MUP save sets. [ECOname.DOCUMENTATION] Documentation in ASCII and PostScript format. (Includes a cover letter for each ECO and MUP.) [CDROM] CDMENU utility and associated files. [README] Documentation you should read first. This directory is located only on the first ECO/MUP CD-ROM. USER_GUIDE.PS (.TXT) User guide. CDMASTER_INDEX.PS OpenVMS VAX Consolidated (.TXT) Software Engineering Change Order Master Index. ______________________________________________________________ To access an ECO or MUP, do the following: 1. Mount the first CD-ROM as described in Section 2.1. 2. Print the file CDMASTER_INDEX.PS or CDMASTER_INDEX.TXT and use it to determine which CD-ROM contains the ECO or MUP you are interested in. These files are located in the [README] directory on the first ECO/MUP CD-ROM and provide a listing of products with ECOs and MUPs, a pointer to the CD-ROM on which each resides, and their directory names. 2-9 3. Invoke the ECO/MUP CDMENU utility as described in Section 2.2. This version of the CDMENU utility, located in the [CDROM] directory on the ECO/MUP CD-ROMs, is provided to assist in using the ECO/MUP CD-ROMS. An advantage of using the ECO/MUP version of CDMENU to install an ECO or MUP is that a product history is created, which you can reference at a future date. ________________________ Note ________________________ Do not use this ECO/MUP version of CDMENU with the Software Products Library CD-ROMs. ______________________________________________________ 4. Use CDMENU to print or view the product's ECO/MUP cover letter. To determine the applicability of an ECO or MUP, read the information in the cover letter which discusses the problems addressed in the kit. 5. Install the ECO or MUP using one of the methods described in Section 2.4.2. 2-10 3 _________________________________________________________________ OpenVMS Alpha Software Product Library This chapter describes how to use the OpenVMS Alpha Software Product Library CD-ROMs. 3.1 Mounting and Controlling Access to a CD-ROM To access the files on an OpenVMS Alpha Software Product Library CD-ROM, mount the CD-ROM using the following procedure: 1. Find the appropriate volume label on the face of the CD-ROM. 2. Log in to the system manager's account (SYSTEM). 3. Mount the CD-ROM by entering the MOUNT command in the following format: MOUNT device-name: volume-label For example: $ MOUNT DKA400: AXPBINMAR991 3.2 Using the CDMENU Utility The CDMENU utility provides a menu interface that helps you perform the following tasks easily: o Display a master index of all products o Display new and updated products o Fetch or copy release notes o Display and print installation guides and other documentation o Install products 3-1 To invoke the CDMENU utility: 1. Mount the CD-ROM as described in Section 3.1. 2. Define the logical name CD_DIRECTORY in your LOGIN.COM file. - To access a single CD-ROM, enter a command in the following format: $ DEFINE CD_DIRECTORY device-name:[CDROM] For example: $ DEFINE CD_DIRECTORY DKA400:[CDROM] - To access multiple CD-ROMs, define CD_DIRECTORY as a search list, entering a command in the following format: $ DEFINE CD_DIRECTORY device1:[CDROM],device2:[CDROM],device3:[CDROM] For example: $ DEFINE CD_DIRECTORY DKA200:[CDROM],DKA300:[CDROM],DKA400:[CDROM] 3. Define the logical name CD_EDIT to indicate the editor to use while displaying documentation on your screen. For example: $ DEFINE CD_EDIT LSE 4. Enter the following command at the system prompt to invoke the CDMENU utility: $ RUN CD_DIRECTORY:CDMENU The CDMENU main menu is displayed. 5. Follow the directions on the screen to choose the option for the task you want to perform. 3-2 ________________________ Note ________________________ CDMENU assumes the CD-ROMs identified in the CD_DIRECTORY logical name definition are from the same release because it utilizes the first instance of CD_CONTENTS.DAT located in the [CDROM] directory. ______________________________________________________ 3.3 Accessing a Software CD-ROM OpenVMS Alpha Software Product Library CD-ROMs contain directories for each product. These directories contain save sets of the binary images included in the software product and product installation documentation in PostScript and ASCII text formats. Each product directory begins with a name unique for that product. 3.3.1 OpenVMS Alpha CD-ROM Directory Structure Table 3-1 shows the structure of the OpenVMS Alpha Software Product Library CD-ROMs. The [README] directory, located on the first CD-ROM, contains the documents you should read first. In most cases, these documents are available in ASCII text and PostScript format. ________________________ Note ________________________ If present, the files SPECIAL_NOTES.TXT and SPECIAL_NOTES.PS in the [README] directory contain important information about specific products in this release. ______________________________________________________ For each product, the name of the root directory usually corresponds to the name of the product save set. The product save sets are located in the KIT subdirectory. Documentation is located in the DOCUMENTATION subdirectory. 3-3 Table 3-1 OpenVMS Alpha CD-ROM Directory Structure ______________________________________________________________ Directory File Contents ______________________________________________________________ [README] Documentation you should read first. CDMASTER_INDEX.PS Lists all products in this (.TXT) release, including which CD-ROM contains each product and the directory name for each product. SW_COMPAT_MATRIX.PS Indicates operating system (.TXT) versions that support each layered product. USER_GUIDE.PS (.TXT) User guide. SW_LICENSE_DOC.PS Software License (.TXT) Description. SPECIAL_NOTES.PS Contains last minute (.TXT) information on selected products. [CDROM] The CDMENU utility and related files. [product] Top level product directory, as shown in the OpenVMS Alpha Software Product Library Master Index. [product.KIT] Product subdirectory containing save sets and/or .PCSI files. [product.DOCUMENTATION] Product subdirectory containing documentation in .PS and .TXT formats. product_IGUIDE.PS Installation guides. (.TXT) product_COVER.PS Cover letters. (.TXT) product_SPD.PS (.TXT) Software Product Descriptions. ______________________________________________________________ 3-4 3.3.2 Release Notes and Other Documentation Release notes for layered products are included in the kits and may be retrieved by entering the appropriate command in the VMSINSTAL utility or the POLYCENTER Software Installation utility. You may also use the CDMENU utility to perform this task. Other product documentation not listed in Table 3-1 is available in two ways: o On OpenVMS Alpha Online Documentation Library CD-ROMs in an electronically viewable format o As individual product documentation sets in hardcopy format Either may be ordered separately by contacting your Compaq account representative. 3.3.3 Printing the Documents You can print the documentation for the OpenVMS Alpha Software Product Library either by using the CDMENU utility (see Section 3.2) or by entering an operating system command. You do not need a product license to print these documents. See the OpenVMS Alpha Software Product Library Master Index for pointers to product directory specifications. To print a document in Table 3-1 for text output, send the file to an ASCII printer by entering a command in one of the following formats: $ PRINT/QUEUE=queue_ANSI device:[README]file-name.TXT $ PRINT/QUEUE=queue_ANSI device:[product.DOCUMENTATION]file-name.TXT To print a document in Table 3-1 for PostScript output, send the file to a PostScript printer by entering a command in one of the following formats: commands: $ PRINT/QUEUE=queue_POST device:[README]file-name.PS $ PRINT/QUEUE=queue_POST device:[product.DOCUMENTATION]file-name.PS In the preceding examples, device represents the name of the drive on which you have placed your OpenVMS Alpha Software Product Library CD-ROM. 3-5 3.4 Installing Layered Products This section describes how to install layered products on an OpenVMS Alpha system. 3.4.1 Location of Product Save Sets and Installation Instructions The OpenVMS Alpha Software Product Library Master Index gives the directory locations of the products on the software binaries CD-ROMs. This information is also available in the CDMASTER_INDEX.PS and CDMASTER_INDEX.TXT files in the [README] directory on the first CD-ROM. Installation information for each product, in PostScript and ASCII text formats, is located in [product.DOCUMENTATION] directories, where product is the product directory name as given in the OpenVMS Alpha Software Product Library Master Index. You do not need a product license to print the information in these directories. Read the Ordering Information section in the product SPD for product ordering information. 3.4.2 Installation Methods Install layered products using one of the following methods: o Using the CDMENU utility (see Section 3.2). o Using the VMSINSTAL utility. o Using the POLYCENTER Software Installation utility. 3.4.2.1 Using VMSINSTAL Individual layered product kits are located in their own directory hierarchies. For this reason, when you install a layered product, you must use a VMSINSTAL command line that is slightly different from the one given in the product's installation guide. 3-6 When you enter the VMSINSTAL command line, specify the disc drive and the directory by entering a command in the following format: @SYS$UPDATE:VMSINSTAL product drive:[directory.KIT] For example: $ @SYS$UPDATE:VMSINSTAL DECFMS024 DKA400:[DECFMS024.KIT] Additionally, certain system privileges must be enabled before you run VMSINSTAL. You must be logged in to a privileged account (such as the system manager's account, SYSTEM) that has the SETPRV privilege or at least the following privileges enabled: o CMKRNL o SYSPRV o WORLD To check whether your process has SETPRV or other privileges enabled, enter the following command: $ SHOW PROCESS/PRIVILEGES 3.4.2.2 Using the POLYCENTER Software Installation Utility Beginning with OpenVMS Alpha Version 6.1, some products can be installed using the POLYCENTER Software Installation utility. Not all products are available with this installation technology. Use a command in the following format to install one or more software products that support installations by means of POLYCENTER Software Installation utility: PRODUCT INSTALL product/VERSION=number /SOURCE=disc-drive:[directory.KIT] For example: $ PRODUCT INSTALL DQS/VERSION=1.3 /SOURCE=DKA400:[DQS013.KIT] 3-7 Additionally, certain system privileges must be enabled before you install products. You must be logged in to a privileged account (such as the system manager's account, SYSTEM) that has at least the following privileges enabled: o CMKRNL o SYSLCK o SYSPRV To check whether your process has these privileges enabled, enter the following command: $ SHOW PROCESS/PRIVILEGES To see whether a previous version of a product is installed, use the PRODUCT SHOW PRODUCT command. For example: $ PRODUCT SHOW PRODUCT FORTRAN Refer to the product's installation guide for more information on installing products using the POLYCENTER Software Installation utility. To use other features of the POLYCENTER Software Intallation utility, see the POLYCENTER Software Installation Utility User's Guide. 3.5 ECOs and MUPs This section describes the OpenVMS Alpha Consolidated Software Engineering Change Order distribution, which provides ECOs and MUPs. Use these instructions if you have purchased the Consolidated Software Engineering Change Order distribution. ________________________ Note ________________________ To purchase the Consolidated Software Engineering Change Order distribution for OpenVMS Alpha, contact your local service office. ______________________________________________________ 3-8 ECOs and MUPs are provided on a separate set of CD-ROMs. Table 3-2 describes the arrangement of files on these CD-ROMs. Table 3-2 OpenVMS Alpha ECO and MUP CD-ROM Directory Structure ______________________________________________________________ Directory Contents ______________________________________________________________ [ECOname.KIT] ECO or MUP save sets and/or .PCSI files. [ECOname.DOCUMENTATION] Documentation in ASCII and PostScript format. (Includes a cover letter for each ECO and MUP.) [CDROM] CDMENU utility and associated files. [README] Documentation you should read first. This directory is located only on the first ECO/MUP CD-ROM. USER_GUIDE.PS (.TXT) User guide. CDMASTER_INDEX.PS OpenVMS Alpha Consolidated (.TXT) Software Engineering Change Order Master Index. ______________________________________________________________ To access an ECO or MUP, do the following: 1. Mount the first CD-ROM as described in Section 3.1. 2. Print the file CDMASTER_INDEX.PS or CDMASTER_INDEX.TXT and use it to determine which CD-ROM contains the ECO or MUP you are interested in. These files are located in the [README] directory on the first ECO/MUP CD-ROM and provide a listing of products with ECOs and MUPs, a pointer to the CD-ROM on which each resides, and their directory names. 3-9 3. Invoke the ECO/MUP CDMENU utility as described in Section 3.2. This version of the CDMENU utility, located in the [CDROM] directory on the ECO/MUP CD-ROMs, is provided to assist in using the ECO/MUP CD-ROMS. An advantage of using the ECO/MUP version of CDMENU to install an ECO or MUP is that a product history is created, which you can reference at a future date. ________________________ Note ________________________ Do not use this version of CDMENU with the Software Products Library CD-ROMs. ______________________________________________________ 4. Use CDMENU to print or view the product's ECO/MUP cover letter. To determine the applicability of an ECO or MUP, read the information in the cover letter which discusses the problems addressed in the kit. 5. Install the ECO or MUP using one of the methods described in Section 3.4.2. 3-10 4 _________________________________________________________________ Compaq Tru64 UNIX Product Library This chapter describes how to use the Tru64 UNIX Software Product Library CD-ROMs. 4.1 Mounting and Controlling Access to a CD-ROM To access the files on a Tru64 UNIX Software Product Library CD-ROM, mount the CD-ROM using the following procedure: 1. Load the CD-ROM into the drive. 2. Log in as root or become superuser: % su Password: 3. If you do not know the device name for the CD-ROM drive, use the file command to find it. # file /dev/rrz*c The file command returns output similar to that shown in the following example. Note that the entry for the disc drive includes the words RRD42 disk. /dev/rrz1c: character special (8/1740) SCSI #1 RRD42 disk #12 (SCSI ID #1) /dev/rrz2c: character special (8/2050) SCSI #0 RRD42 disk #16 (SCSI ID #2) /dev/rrz3c: character special (8/3074) SCSI #0 RZ25 disk #24 (SCSI ID #3) /dev/rrz4c: character special (8/4098) SCSI #0 RRD42 disk #32 (SCSI ID #4) /dev/rrz8c: character special (8/16386) SCSI #1 RZ56 disk #64 (SCSI ID #0) 4-1 4. Create a directory that will be the mount point for the CD-ROM, using a command in the following format: mkdir /mount-point For example: # mkdir /mnt If you are going to mount multiple CD-ROMs, create multiple mount points using the mkdir command. 5. Mount the CD-ROM using the -r option to indicate that the CD-ROM is read-only. o For a single CD-ROM, use a command in the following format: # mount -r /dev/rzunit_numberc /mount-point where: unit-number is the unit number of your disc drive. mount-point is the mount point you have just created. For example: # mount -r /dev/rz2c /mnt o For multiple CD-ROMs, use commands in the following format: # mount -r /dev/rz1c /mnt1 # mount -r /dev/rz2c /mnt2 In these examples, /mnt is the mount point for a single CD-ROM, whereas /mnt1 and /mnt2 are mount points for multiple CD-ROMs. 4-2 6. To dismount a CD-ROM, use a command in one of the following formats: # umount /mnt or # /sbin/umount /dev/rz4c 8. To ensure that a CD-ROM is remounted in the event that your system crashes or is rebooted, follow these steps: a. Using the text editor of your choice, open the file /sbin/bcheckrc and search for the following section: # # mount local (non-nfs) filesystems # echo 'Mounting local filesystems' /sbin/mount -a -v -t nonfs b. To ensure that your CD-ROM will be mounted at system startup, add the following lines after the mount local section, replacing unit-number with the actual device number of your disc drive, and mount-point with the directory on which you mounted the CD-ROM: # # mount CD # echo 'Mounting CDROM' /sbin/mount -r /dev/rzunit-numberc /mount-point The system will mount the CD-ROM on the mount point you specify on every reboot. 4-3 4.2 Using the cdmenu Utility The cdmenu utility provides a menu interface that helps you perform the following tasks easily: o Display a master index of all products o Display new and updated products o Display and print installation guides and other documentation o Install products To invoke the cdmenu utility: 1. Log in as superuser. 2. Mount the CD-ROM as described in Section 4.1. 3. Using the c shell (csh), define the environment variable CD_DIRECTORY in your .login or .cshrc file by entering a command in one of the following formats: o For a single binary CD-ROM: setenv CD_DIRECTORY /mount-point:/mount-point/cdrom where: mount-point is the directory where the CD-ROM is mounted. For example: # setenv CD_DIRECTORY /mnt:/mnt/cdrom o For multiple CD-ROMs: setenv CD_DIRECTORY /mount-point1:/mount-point2:/mount-point1/cdrom For example: # setenv CD_DIRECTORY /mnt1:/mnt2:/mnt1/cdrom 4-4 4. Set the environment variable CD_EDIT to indicate the editor to use while displaying documentation on your screen. For example: # setenv CD_EDIT vi 5. Enter one of the following commands at the system prompt to invoke the cdmenu utility. (The examples assume a /mnt mount point.) o For a single CD-ROM: # /mnt/cdrom/cdmenu o For multiple CD-ROMs: # /mnt1/cdrom/cdmenu The CDMENU main menu is displayed. 6. Follow the directions on the screen to choose the option for the task you want to perform. ________________________ Note ________________________ The cdmenu utility assumes the CD-ROMs identified in the CD_DIRECTORY environment variable are from the same release because it utilizes the first instance of cd_contents.dat located in the /cdrom directory. ______________________________________________________ 4.3 Accessing a Software CD-ROM Tru64 UNIX Software Product Library CD-ROMs contain directories for each product. These directories contain subsets of the binary images included in the software product and product installation documentation in PostScript and ASCII text formats. Each product directory begins with a name unique for that product. 4-5 4.3.1 Tru64 UNIX CD-ROM Directory Structure Table 4-1 shows the structure of the Tru64 UNIX Software Product Library CD-ROMs. The /readme directory, located on the first CD-ROM, contains the documents you should read first. In most cases, these documents are available in ASCII and PostScript format. ________________________ Note ________________________ If present, the files special_notes.txt and special_notes.ps in the /readme directory contain important information about specific products in this release. ______________________________________________________ For each product, the name of the root directory usually corresponds to the name of the product subset. The product subsets are located in the /kit subdirectory. Documentation is located in the /documentation subdirectory. Table 4-1 Compaq Tru64 UNIX CD-ROM Directory Structure ____________________________________________________________ Directory File Contents ____________________________________________________________ /readme Documentation you should read first. cdmaster_index.ps Lists all products in this (.txt) release, including which CD-ROM contains each product and the directory name for each product. sw_compat_matrix.ps Indicates operating system (.txt) versions that support each layered product. user_guide.ps (.txt) User guide. sw_license_doc.ps Software License (.txt) Description. special_notes.ps Contains last-minute (.txt) information on selected products. 4-6 Table 4-1 Compaq Tru64 UNIX CD-ROM Directory Structure Cont. ____________________________________________________________ Directory File Contents ____________________________________________________________ /cdrom The cdmenu utility and related files. /product Top-level product directory, as shown in the Tru64 UNIX Alpha Software Product Library Master Index. /product/kit Product subdirectory containing subsets. /product/documentation Product subdirectory containing documentation in .ps and .txt formats. product_iguide.ps Installation guides. (.txt) product_cover.ps Cover letters. (.txt) product_relnotes.ps Release notes. (.txt) product_spd.ps (.txt) Software Product Descriptions. ____________________________________________________________ 4.3.2 Other Documentation Other product documentation not listed in Table 4-1 is available in two ways: o On the Tru64 UNIX Online Documentation Library CD-ROMs in an electronically viewable format o As individual product documentation sets in hardcopy format Either may be ordered separately by contacting your Compaq account representative. 4-7 4.3.3 Printing the Documents You can print the documentation for the Tru64 UNIX Software Product Library either by using the CDMENU utility (see Section 4.2) or by entering an operating system command. You do not need a product license to print these documents. See the Tru64 UNIX Software Product Library Master Index for pointers to product directory specifications. To print a document in Table 4-1 for text output, send the file to an ASCII printer by entering a command in one of the following formats. (The examples assume a /mnt mount point.) % lpr -Pqueue-name /mnt/product/documentation/file-name.txt % lpr -Pqueue-name /mnt/readme/file-name.txt To print a document in Table 4-1 for PostScript output, send the file to a PostScript printer by entering a command in one of the following formats: % lpr -Pqueue-name /mnt/product/documentation/file-name.ps % lpr -Pqueue-name /mnt/readme/file-name.ps 4-8 4.4 Installing Layered Products This section describes how to install layered products on a system running the Tru64 UNIX operating system. 4.4.1 Location of Product Subsets and Installation Instructions The Tru64 UNIX Software Product Library Master Index gives the directory locations of the products on the software binaries CD-ROMs. This information is also available in the cdmaster_index.ps and cdmaster_index.txt files in the /readme directory on the first CD-ROM. Installation information for each product, in PostScript and ASCII text formats, is located in product/documentation directories, where product is the product directory name as given in the Tru64 UNIX Software Product Library Master Index. You do not need a product license to print the information in these directories. Read the Ordering Information section in the product SPD for product ordering information. 4.4.2 Installation Methods Install layered products using one of the following methods: o Using the cdmenu utility (see Section 4.2). o Using the setld command. 4.4.2.1 Using setld Individual layered product kits are located in their own directory hierarchies. When you install a layered product, you must use the complete path name on the setld command line. 4-9 To install products from the Tru64 UNIX Software Product Library: 1. Log in as superuser. 2. Enter a setld command that specifies the load function -l (ell). Use the following format: % /sbin/setld -l /mount-point/product/kit For example: % /sbin/setld -l /mnt/pas570/kit This command installs subsets requested from the /pas570/kit subdirectory on the device mounted to the directory /mnt. 4.5 ECOs and MUPs This section describes the Tru64 UNIX Consolidated Software Engineering Change Order distribution, which provides ECOs and MUPs. Use these instructions if you have purchased the Consolidated Software Engineering Change Order distribution. ________________________ Note ________________________ To purchase the Consolidated Software Engineering Change Order distribution for Tru64 UNIX, contact your local service office. ______________________________________________________ ECOs and MUPs are provided on a separate set of CD-ROMs. Table 4-2 describes the arrangement of files on these CD-ROMs. 4-10 Table 4-2 Tru64 UNIX ECO and MUP CD-ROM Directory Structure ____________________________________________________________ Directory Contents ____________________________________________________________ /ECOname/kit ECO or MUP subsets. /ECOname Documentation in ASCII and /documentation PostScript format. (Includes a cover letter for each ECO /MUP.) /cdrom CDMENU utility and associated files. /readme Documentation you should read first. This directory is located only on the first ECO/MUP CD-ROM. /readme/cdmaster_index.ps Tru64 UNIX Consolidated (.txt) Software Engineering Change Order Master Index. /readme/user guide.ps User guide. (.txt) ____________________________________________________________ To access an ECO or MUP, do the following: 1. Mount the first CD-ROM as described in Section 4.1. 2. Print the file cdmaster_index.ps or cdmaster_index.txt and use it to determine which CD-ROM contains the ECO or MUP you are interested in. These files are located in the /readme directory on the first ECO/MUP CD-ROM and provide a listing of products with ECOs and MUPs, a pointer to the CD-ROM on which each resides, and their directory names. 3. Invoke the ECO/MUP CDMENU utility as described in Section 4.2. This version of the CDMENU utility, located in the /cdrom directory on the ECO/MUP CD-ROMs, is provided to assist in using the ECO/MUP CD-ROMS. When you use the ECO/MUP version of CDMENU to install an ECO or MUP, a product history is created, which you can reference at a future date. 4-11 ________________________ Note ________________________ Do not use this version of CDMENU with the Software Products Library CD-ROMs. ______________________________________________________ 4. Use CDMENU to print or view the product's ECO/MUP cover letter. To determine the applicability of an ECO or MUP, read the information in the cover letter which discusses the problems addressed in the kit. 5. Install the ECO or MUP using one of the methods described in Section 4.4.2. 4-12 _________________________________________________________________ Index C Compact discs See CD-ROMs CD-ROM hardware documentation on, 1-1 D CD-ROMs Discs accessing on Tru64 UNIX, 4-5 See CD-ROMs on OpenVMS Alpha, 3-3 Documentation on OpenVMS VAX, 2-3 ordering, vi controlling access E on Tru64 UNIX, 4-1 ECOs on OpenVMS Alpha, 3-1 for Tru64 UNIX, 4-10 on OpenVMS VAX, 2-1 for OpenVMS Alpha, 3-8 for OpenVMS VAX, 2-8 directory structure on Tru64 UNIX, 4-5 ordering, vi on OpenVMS Alpha, 3-3 Engineering Change Orders on OpenVMS VAX, 2-3 See ECOs handling, 1-1 mounting I on Tru64 UNIX, 4-1 Installation on OpenVMS Alpha, 3-1 instructions on OpenVMS VAX, 2-1 on Tru64 UNIX, 4-9 on OpenVMS Alpha, 3-6 CDMENU utility on OpenVMS VAX, 2-6 invoking on Tru64 UNIX, 4-4 layered products on OpenVMS Alpha, 3-2 on Tru64 UNIX, 4-9 on OpenVMS VAX, 2-2 on OpenVMS Alpha, 3-6 on OpenVMS VAX, 2-6 Index-1 L______________________________ OpenVMS Alpha documentation, 3-5 OpenVMS VAX documentation, License Management Facility 2-5 (LMF), 1-2 LMF Product Authorization Keys See License Management (PAKS), 1-2 Facility S _______________________________ M______________________________ Save set locations Mandatory Updates on OpenVMS Alpha, 3-6 on OpenVMS VAX, 2-6 See MUPs setld utility Mounting CD-ROMs on Tru64 UNIX, 4-9 on Tru64 UNIX, 4-1 on OpenVMS Alpha, 3-1 Subset locations on OpenVMS VAX, 2-1 on Tru64 UNIX, 4-9 MUPs for Tru64 UNIX, 4-10 V______________________________ for OpenVMS Alpha, 3-8 VMSINSTAL utility for OpenVMS VAX, 2-8 on OpenVMS Alpha, 3-6 ordering, vi on OpenVMS VAX, 2-6 O______________________________ Ordering documentation, vi ECOs and MUPs, vi products, vi P______________________________ PAKS See Product Authorization Keys POLYCENTER Software Installation utility on OpenVMS Alpha, 3-7 on OpenVMS VAX, 2-6 Printing Tru64 UNIX documentation, 4-8 Index-2