 



















                    Software_Product_Library____________________________
                    CD-ROM User's Guide

                    AA-QDGSD-XE


                    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
                                                  Digital UNIX[R]
                                                  (formerly DEC OSF/1[R])
                                                  ULTRIX VAX and ULTRIX
                                                  RISC

                    Revision/Update Information:  This is a revised
                                                  document.

                    Digital Equipment Corporation
                    Maynard, Massachusetts

 






          ________________________________________________________________
          July 1995

          The optical disc publication and all component parts as
          appearing herein are copyrighted.

          Digital Equipment Corporation makes no representations
          that the use of its products in the manner described in
          this publication will not infringe on existing or future
          patent rights, nor do the descriptions contained in this
          publication imply the granting of licenses to make, use,
          or sell equipment or software in accordance with the
          description.

          Possession, use, or copying of the software described in
          this publication is authorized only pursuant to a valid
          written license from Digital or an authorized sublicensor.

           Digital Equipment Corporation 1995. All rights reserved.

          The following are trademarks of Digital Equipment
          Corporation: Digital, DOCUMENT, OpenVMS, POLYCENTER,
          ULTRIX, VAX, VAXcluster, VMS, and the DIGITAL logo.

          The following are third-party trademarks:

          PostScript is a registered trademark of Adobe Systems,
          Incorporated.
          OSF/1 is a registered trademark of the Open Software
          Foundation, Inc.
          UNIX is a registered trademark in the United States and
          other countries, licensed exclusively through X/Open
          Company, Ltd.

          All other trademarks and registered trademarks are the
          property of their respective holders.

          This document was prepared using VAX DOCUMENT Version 2.1.

 














  _________________________________________________________________

                                                           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









                                                                iii

 







    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-4
          3.3.3     Printing the Documents....................    3-5
          3.4   Installing Layered Products...................    3-5
          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

    4  Digital UNIX Software Product Library

          4.1   Mounting and Controlling Access to a CD-ROM...    4-1
          4.2   Using the cdmenu Utility......................    4-4
          4.3   Accessing a Software CD-ROM...................    4-5
          4.3.1     Digital UNIX CD-ROM Directory Structure...    4-6
          4.3.2     Release Notes and Other Documentation.....    4-7
          4.3.3     Printing the Documents....................    4-8
          4.4   Installing Layered Products...................    4-8
          4.4.1     Location of Product Subsets and
                    Installation Instructions.................    4-8
          4.4.2     Installation Methods......................    4-9
          4.4.2.1     Using setld.............................    4-9
          4.5   ECOs and MUPs.................................   4-10

    5  ULTRIX Software Product Library

          5.1   Mounting and Controlling Access to a CD-ROM...    5-1
          5.2   Using the cdmenu Utility......................    5-3
          5.3   Accessing a Software CD-ROM...................    5-4
          5.3.1     ULTRIX CD-ROM Directory Structure.........    5-4
          5.3.2     Other Documentation.......................    5-6
          5.3.3     Printing the Documents....................    5-6
          5.4   Installing Layered Products...................    5-7
          5.4.1     Location of Product Subsets and
                    Installation Instructions.................    5-7

    iv

 







              5.4.2     Installation Methods......................    5-7
              5.4.2.1     Using setld(8)..........................    5-8
              5.5   ECOs and MUPs.................................    5-8

        Index


        Tables

              2-1       OpenVMS VAX CD-ROM Directory Structure....    2-4

              2-2       OpenVMS VAX ECO and MUP CD-ROM Directory
                        Structure ................................    2-8

              3-1       OpenVMS Alpha CD-ROM Directory
                        Structure.................................    3-3

              3-2       OpenVMS Alpha ECO and MUP CD-ROM Directory
                        Structure ................................    3-8

              4-1       Digital UNIX CD-ROM Directory Structure...    4-6

              4-2       Digital UNIX ECO and MUP CD-ROM Directory
                        Structure ................................   4-10

              5-1       ULTRIX CD-ROM Directory Structure.........    5-5

              5-2       ULTRIX ECO and MUP CD-ROM Directory
                        Structure.................................    5-9
















                                                                        v

 












        _________________________________________________________________

                                                                  Preface



              This guide provides introductory information about
              the Software Product Library CD-ROMs for the following
              platforms:

              o  OpenVMS VAX (see Chapter 2)

              o  OpenVMS Alpha (see Chapter 3)

              o  Digital UNIX (see Chapter 4)

              o  ULTRIX VAX and ULTRIX RISC (see Chapter 5)

        Contents of this Guide

              This guide begins with an overview chapter providing
              information about the Software Product Library CD-ROMs
              that is common to all platforms.

              The rest of the guide consists of chapters for each
              operating system, describing:

              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

          Digital Equipment 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 released eight
                times a year

             -  On some platforms, as part of the software product
                library at the time of the platform's quarterly
                release

          For individual product ordering information, consult your
          Digital account representative.

          Call 1-800-DIGITAL to place orders in the United States.
          Contact your local Digital 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.

    Providing Feedback

          Digital welcomes your comments on its products.

          To make it easy for you to provide feedback, Digital has
          created the following Internet mail account:

          cdrom_docs@zko.dec.com

          Use this account to provide comments on this guide, and the
          Software Product Library Master Index for your platform.

    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_platforms_based_on_UNIX_systems:_______________________

              %                     The percent sign (%) indicates the
                                    user prompt on ULTRIX and Digital
                                    UNIX systems.

              #                     The pound sign (#) indicates the
                                    system manager prompt on ULTRIX and
                                    Digital UNIX systems.

              Digital UNIX,         References to Digital UNIX and
              Digital UNIX Systems  Digital UNIX Systems refer to the
                                    Digital UNIX (formerly DEC OSF/1)
                                    operating system running on Alpha
                                    processor hardware.









                                                                      vii

 






          ___________________________________________________________
          ___________________________________________________________

          For_all_platforms:_________________________________________

          $ MOUNT DKA400: VAXDOCNOV941    Boldface monospace text
          		                  represents user input in 
				          interactive examples.
          $ mount -r /dev/rz4c/mnt

          device-name volume-label   Lowercase italics indicate a 
          			     variable string. These variables 
                                     include product identifiers, 
                                     hardware devices, directory 
				     locations, file names, and
          ___________________________mount_points.___________________































    viii

 










                                                                        1
        _________________________________________________________________

                                      Overview of the CD-ROM User's Guide


              The following information about Digital's Software Product
              Library CD-ROMs applies to all platforms.

        1.1 About These CD-ROMs

              Digital's 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. To be mounted on your system, a CD-ROM
              must be removed from this envelope and loaded into a caddy.
              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.




                                  Overview of the CD-ROM User's Guide 1-1

 



    Overview of the CD-ROM User's Guide
    1.2 Product Licensing Agreements


    1.2 Product Licensing Agreements

          The media and the software programs contained on these
          CD-ROMs belong to Digital. Use of the software products
          is authorized only if you have a valid software license
          from Digital. 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 Overview of the CD-ROM User's Guide

 










                                                                        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. Load the CD-ROM into a protective caddy.

              3. Insert the caddy into the drive.

              4. Log in to the system manager's account (SYSTEM).

              5. Mount the CD-ROM by entering the MOUNT command in the
                 following format:

                 MOUNT device-name: volume-label

                 For example:

                 $ MOUNT DKA400: VAXBINJAN941

        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

                                 OpenVMS VAX Software Product Library 2-1

 



    OpenVMS VAX Software Product Library
    2.2 Using the CDMENU Utility


          o  Install products

          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.

             ________________________ Note ________________________

             CDMENU assumes the CD-ROMs identified in the 
             CD_DIRECTORY logical name definition are from the same

    2-2 OpenVMS VAX Software Product Library

 



                                     OpenVMS VAX Software Product Library
                                             2.2 Using the CDMENU Utility


                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 name unique 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.







                                 OpenVMS VAX Software Product Library 2-3

 



    OpenVMS VAX Software Product Library
    2.3 Accessing a Software CD-ROM


          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.

                  SW_COMPAT_MATRIX.PS    Indicates operating system
                  (.TXT)                 versions that support each
                                         layered product.

                  USER_GUIDE.PS (.TXT)   This 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 VAX
                                         Software Product Library
                                         Master Index.

             [product.KIT]               Product subdirectory
                                         containing save sets.

             [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 OpenVMS VAX Software Product Library

 



                                     OpenVMS VAX Software Product Library
                                          2.3 Accessing a Software CD-ROM


        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 Digital
              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 preceeding examples, device represents the name
              of the drive on which you have placed your OpenVMS VAX
              Software Product Library CD-ROM.

                                 OpenVMS VAX Software Product Library 2-5

 



    OpenVMS VAX Software Product Library
    2.4 Installing Layered Products


    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
          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.

    2.4.2 Installation Methods

          Install layered products using one of the following
          methods:

          o  Using the CDMENU utility (see Section 2.2).

          o  Invoking VMSINSTAL.

          o  Invoking 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.

          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]

    2-6 OpenVMS VAX Software Product Library

 



                                     OpenVMS VAX Software Product Library
                                          2.4 Installing Layered Products


              For example:

              $ @SYS$UPDATE:VMSINSTAL FORT061 DKA400:[FORT061.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]

              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  SYSPRV

              To check whether your process has these privileges enabled,
              enter the following command:

              $ SHOW PROCESS/PRIVILEGES

                                 OpenVMS VAX Software Product Library 2-7

 



    OpenVMS VAX Software Product Library
    2.4 Installing Layered Products


          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.

             ______________________________________________________

          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.

                                             (continued on next page)



    2-8 OpenVMS VAX Software Product Library

 



                                     OpenVMS VAX Software Product Library
                                                        2.5 ECOs and MUPs


              Table 2-2 (Cont.) OpenVMS VAX ECO and MUP CD-ROM Directory
              __________________Structure________________________________

              Directory__________________Contents________________________

              [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)   This user guide.

                  ECOMASTER_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 ECOMASTER_INDEX.PS or ECOMASTER_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 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.

                                 OpenVMS VAX Software Product Library 2-9

 



    OpenVMS VAX Software Product Library
    2.5 ECOs and MUPs


             ________________________ 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 OpenVMS VAX Software Product Library

 










                                                                        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. Load the CD-ROM into a protective caddy.

              3. Insert the caddy into the drive.

              4. Log in to the system manager's account (SYSTEM).

              5. Mount the CD-ROM by entering the MOUNT command in the
                 following format:

                 MOUNT device-name: volume-label

                 For example:

                 $ MOUNT DKA400: AXPBINNOV941

        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

                               OpenVMS Alpha Software Product Library 3-1

 



    OpenVMS Alpha Software Product Library
    3.2 Using the CDMENU Utility


          o  Install products

          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.

             ________________________ 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-2 OpenVMS Alpha Software Product Library

 



                                   OpenVMS Alpha Software Product Library
                                          3.3 Accessing a Software CD-ROM


        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.

              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.

                                                 (continued on next page)

                               OpenVMS Alpha Software Product Library 3-3

 



    OpenVMS Alpha Software Product Library
    3.3 Accessing a Software CD-ROM


          Table_3-1_(Cont.)_OpenVMS_Alpha_CD-ROM_Directory_Structure_

          Directory_File___________________Contents__________________

                  SW_COMPAT_MATRIX.PS    Indicates operating system
                  (.TXT)                 versions that support each
                                         layered product.

                  USER_GUIDE.PS (.TXT)   This 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.

             [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.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.

    3-4 OpenVMS Alpha Software Product Library

 



                                   OpenVMS Alpha Software Product Library
                                          3.3 Accessing a Software CD-ROM


              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 Digital
              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 preceeding examples, device represents the name
              of the drive on which you have placed your OpenVMS Alpha
              Software Product Library CD-ROM.

        3.4 Installing Layered Products

              This section describes how to install layered products on
              an OpenVMS Alpha system.

                               OpenVMS Alpha Software Product Library 3-5

 



    OpenVMS Alpha Software Product Library
    3.4 Installing Layered Products


    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.

          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]

    3-6 OpenVMS Alpha Software Product Library

 



                                   OpenVMS Alpha Software Product Library
                                          3.4 Installing Layered Products


              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]

              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  SYSPRV

              To check whether your process has these privileges enabled,
              enter the following command:

              $ SHOW PROCESS/PRIVILEGES

                               OpenVMS Alpha Software Product Library 3-7

 



    OpenVMS Alpha Software Product Library
    3.4 Installing Layered Products


          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.

             ______________________________________________________

          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.

                                             (continued on next page)



    3-8 OpenVMS Alpha Software Product Library

 



                                   OpenVMS Alpha Software Product Library
                                                        3.5 ECOs and MUPs


              Table 3-2 (Cont.) OpenVMS Alpha ECO and MUP CD-ROM
              __________________Directory_Structure______________________

              Directory__________________Contents________________________

              [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)   This user guide.

                  ECOMASTER_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 ECOMASTER_INDEX.PS or ECOMASTER_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 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.

                               OpenVMS Alpha Software Product Library 3-9

 



    OpenVMS Alpha Software Product Library
    3.5 ECOs and MUPs


             ________________________ 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 OpenVMS Alpha Software Product Library

 










                                                                        4
        _________________________________________________________________

                                    Digital UNIX Software Product Library


              This chapter describes how to use the Digital UNIX Software
              Product Library CD-ROMs.

        4.1 Mounting and Controlling Access to a CD-ROM

              To access the files on a Digital UNIX Software Product
              Library CD-ROM, mount the CD-ROM using the following
              procedure:

              1. Load the CD-ROM into a protective caddy.

              2. Insert the caddy into the drive.

              3. Log in as root or become superuser:

                 % su
                 Password:

              4. 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)

              5. Create a directory that will be the mount point for the
                 CD-ROM, using a command in the following format:

                 mkdir /mount-point

                                Digital UNIX Software Product Library 4-1

 



    Digital UNIX Software Product Library
    4.1 Mounting and Controlling Access to a CD-ROM


             For example:

             # mkdir /mnt

             If you are going to mount multiple CD-ROMs, create
             multiple mount points using the mkdir command.

          6. Mount the CD-ROM using the -dr or -r option to indicate
             that the CD-ROM is read-only. Use the -dr command if you
             are using a version of the operating system lower than
             Version 1.3. Use the -r option if your operating system
             is Version 1.3 or higher.

































    4-2 Digital UNIX Software Product Library

 



                                    Digital UNIX Software Product Library
                          4.1 Mounting and Controlling Access to a CD-ROM


                 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.

              7. 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:

                                Digital UNIX Software Product Library 4-3

 



    Digital UNIX Software Product Library
    4.1 Mounting and Controlling Access to a 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.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 Digital UNIX Software Product Library

 



                                    Digital UNIX Software Product Library
                                             4.2 Using the cdmenu Utility


              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

              Digital 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.



                                Digital UNIX Software Product Library 4-5

 



    Digital UNIX Software Product Library
    4.3 Accessing a Software CD-ROM


    4.3.1 Digital UNIX CD-ROM Directory Structure

          Table 4-1 shows the structure of the Digital 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_Digital_UNIX_CD-ROM_Directory_Structure__________

          Directory_File___________________Contents__________________

          /readme                        Documentation you should
                                         read first.

                  cdmaster_index.ps      Lists all products in this
                  (.txt)                 release.

                  user_guide.ps (.txt)   This 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.

                                             (continued on next page)

    4-6 Digital UNIX Software Product Library

 



                                    Digital UNIX Software Product Library
                                          4.3 Accessing a Software CD-ROM


              Table_4-1_(Cont.)_Digital_UNIX_CD-ROM_Directory_Structure__

              Directory_File___________________Contents__________________

              /product                       Top-level product directory,
                                             as shown in the Digital UNIX
                                             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 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 setld procedure. You may also use the cdmenu utility to
              perform this task.

              Other product documentation not listed in Table 4-1 is
              available in two ways:

              o  On the Digital 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 Digital
              account representative.

                                Digital UNIX Software Product Library 4-7

 



    Digital UNIX Software Product Library
    4.3 Accessing a Software CD-ROM


    4.3.3 Printing the Documents

          You can print the documentation for the Digital 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 Digital 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

          Note that for some products, there is no PostScript or
          ASCII documentation. Instead, an electronically viewable
          format of the documentation is provided on the Digital UNIX
          Online Documentation Library CD-ROM.

    4.4 Installing Layered Products

          This section describes how to install layered products on a
          system running the Digital UNIX operating system.

    4.4.1 Location of Product Subsets and Installation Instructions

          The Digital 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.

    4-8 Digital UNIX Software Product Library

 



                                    Digital UNIX Software Product Library
                                          4.4 Installing Layered Products


              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 Digital 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.

              To install products from the Digital 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/pas120/kit

                 This command installs subsets requested from the
                 /pas120/kit subdirectory on the device mounted to the
                 directory /mnt.

                                Digital UNIX Software Product Library 4-9

 



    Digital UNIX Software Product Library
    4.5 ECOs and MUPs


    4.5 ECOs and MUPs

          This section describes the Digital 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 Digital 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.

          Table 4-2 Digital UNIX ECO and MUP CD-ROM Directory
          __________Structure________________________________________

          Directory__________________Contents________________________

          /mount-point/ECOname/kit   ECO or MUP subsets.

          /mount-point/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.

              ecomaster_index.ps     Digital UNIX Consolidated
              (.txt)                 Software Engineering Change
                                     Order Master Index.

          ____user_guide.ps_(.txt)___This_user_guide.________________

          To access an ECO or MUP, do the following:

          1. Mount the first CD-ROM as described in Section 4.1.

    4-10 Digital UNIX Software Product Library

 



                                    Digital UNIX Software Product Library
                                                        4.5 ECOs and MUPs


              2. Print the file ecomaster_index.ps or ecomaster_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.

                ________________________ 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.









                               Digital UNIX Software Product Library 4-11

 










                                                                        5
        _________________________________________________________________

                                          ULTRIX Software Product Library


              This chapter describes how to use the ULTRIX Software
              Product Library CD-ROMs.

        5.1 Mounting and Controlling Access to a CD-ROM

              To access the files on an ULTRIX Software Product Library
              CD-ROM, mount the CD-ROM using the following procedure:

              1. Load the CD-ROM into a protective caddy.

              2. Insert the caddy into the drive.

              3. Log in as root or become superuser:

                 % su
                 Password:

              4. If you do not know the device name for the disc drive,
                 use the following 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)

              5. 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

                                      ULTRIX Software Product Library 5-1

 



    ULTRIX Software Product Library
    5.1 Mounting and Controlling Access to a CD-ROM


             If you are going to mount multiple CD-ROMs, create
             multiple mount points using the mkdir command.

          6. Mount the CD-ROM using the -r option to indicate that
             the CD-ROM is read-only, as follows:

             o  For a single binary 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/rz4c /mnt

             o  For multiple CD-ROMs, use commands in the following
                format:

                # /etc/mount -r /dev/rz1c  /mnt1
                # /etc/mount -r /dev/rz2c  /mnt2

                In these examples, /mnt1 and /mnt2 are mount points
                for multiple CD-ROMs.

          7. To dismount a CD-ROM, use a command in one of the
             following formats:

             # umount /mnt

             or

             # /etc/umount /dev/rz4c

          8. To ensure that the CD-ROM is remounted if your system
             crashes or is rebooted, open the /etc/fstab file. Using
             the text editor of your choice, add a line to this
             file containing the following information. See the file
             /usr/include/fstab.h for a description of each field.

             spec:file:type:freq:passno:name:opts

             For example:

             /dev/rz4c:/mnt:ro:0:0:ufs::

             The system will now mount the CD-ROM on /mnt on every
             reboot.

    5-2 ULTRIX Software Product Library

 



                                          ULTRIX Software Product Library
                                             5.2 Using the cdmenu Utility


        5.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 5.1.

              3. 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. Set the environment variable CD_EDIT to indicate the
                 editor to use while displaying documentation on your
                 screen.

                 For example:

                 # setenv CD_EDIT vi

                                      ULTRIX Software Product Library 5-3

 



    ULTRIX Software Product Library
    5.2 Using the cdmenu Utility


          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 binary 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.

             ______________________________________________________

    5.3 Accessing a Software CD-ROM

          ULTRIX 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.

    5.3.1 ULTRIX CD-ROM Directory Structure

          Table 5-1 shows the structure of the ULTRIX 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

    5-4 ULTRIX Software Product Library

 



                                          ULTRIX Software Product Library
                                          5.3 Accessing a Software CD-ROM


                important information about specific products in this
                release. Note that the special_notes files for ULTRIX
                VAX and ULTRIX RISC are different.

                ______________________________________________________

              For each product, the name of the root directory usually
              corresponds to the name of the product. The products are
              located in the /kit subdirectory. Documentation is located
              in the /documentation subdirectory.

              Table_5-1_ULTRIX_CD-ROM_Directory_Structure________________

              Directory_File___________________Contents__________________

              /readme                        Documentation you should
                                             read first.

                      cdmaster_index.ps      Lists all products in this
                      (.txt)                 release.

                      user_guide.ps (.txt)   This 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 ULTRIX
                                             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)

                                                 (continued on next page)

                                      ULTRIX Software Product Library 5-5

 



    ULTRIX Software Product Library
    5.3 Accessing a Software CD-ROM


          Table_5-1_(Cont.)_ULTRIX_CD-ROM_Directory_Structure________

          Directory_File___________________Contents__________________

                  product_cover.ps       Cover letters.
                  (.txt)

                  product_relnotes.ps    Release notes.
                  (.txt)

                  product_spd.ps (.txt)  Software Product
          _______________________________Descriptions._______________

    5.3.2 Other Documentation

          Other product documentation not listed in Table 5-1 is
          available in two ways:

          o  On the ULTRIX 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 Digital
          account representative.

    5.3.3 Printing the Documents

          You can print the documentation for the ULTRIX Software
          Product Library either by using the cdmenu utility (see
          Section 5.2) or by entering an operating system command.
          You do not need a product license to print these documents.

          See the ULTRIX Software Product Library Master Index for
          pointers to product directory specifications.

          To print a document in Table 5-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/readme/cdmaster_index.txt

          % lpr -Pqueue-name /mnt/documentation/product_iguide.txt

    5-6 ULTRIX Software Product Library

 



                                          ULTRIX Software Product Library
                                          5.3 Accessing a Software CD-ROM


              To print a document in Table 5-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/readme/cdmaster_index.ps

              % lpr -Pqueue-name /mnt/documentation/product_iguide.ps

        5.4 Installing Layered Products

              This section describes how to install layered products
              on a system running the ULTRIX operating system or ULTRIX
              Worksystem software.

        5.4.1 Location of Product Subsets and Installation Instructions

              The ULTRIX 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 ULTRIX 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.

        5.4.2 Installation Methods

              Install layered products using one of the following
              methods:

              o  Using the cdmenu utility (see Section 5.2).

              o  Using the setld(8) command.




                                      ULTRIX Software Product Library 5-7

 



    ULTRIX Software Product Library
    5.4 Installing Layered Products


    5.4.2.1 Using setld(8)

          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(8) command
          line.

          To install products from the ULTRIX Software Product
          Library:

          1. Log in as superuser.

          2. Enter a setld command that specifies the load function
             -l (ell). Use the following format:

             # setld -l /mount-point/product/kit

             For example:

             # setld -l /mnt/pas120/kit

             This command installs subsets requested from the
             /pas120/kit subdirectory on the device mounted to the
             /mnt directory.

    5.5 ECOs and MUPs

          This section describes the Consolidated Software
          Engineering Change Order distribution for ULTRIX. 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 ULTRIX, contact your
             local service office.

             ______________________________________________________

          ECOs and MUPs are provided on a separate set of CD-ROMs.
          Table 5-2 describes the arrangement of files on these
          CD-ROMs.

    5-8 ULTRIX Software Product Library

 



                                          ULTRIX Software Product Library
                                                        5.5 ECOs and MUPs


              Table_5-2_ULTRIX_ECO_and_MUP_CD-ROM_Directory_Structure____

              Directory__________________Contents________________________

              /mount-point/ECOname/kit   ECO or MUP subsets.

              /mount-point/ECOname       Documentation in ASCII and
              /documentation             PostScript format. (Includes
                                         a cover letter for each ECO
                                         /MUP.)

              /cdrom                     cdmenu utility and associated
                                         files.

                  cdmenu_vax             cdmenu utility for ULTRIX VAX.

                  cdmenu_risc            cdmenu utility for ULTRIX RISC.

              /readme                    Documentation you should read
                                         first. This directory is located
                                         only on the first ECO/MUP
                                         CD-ROM.

                  ecomaster_index.ps     ULTRIX Consolidated Software
                  (.txt)                 Engineering Change Order Master
                                         Index.

              ____user_guide.ps_(.txt)___This_user_guide.________________

              To access an ECO or MUP, do the following:

              1. Mount the first CD-ROM as described in Section 5.1.

              2. Print the file ecomaster_index.ps or ecomaster_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 5.2, with the following modifications:

                 o  When you define the environment variable
                    CD_DIRECTORY, append the appropriate ECO/MUP cdmenu
                    saveset name to the command:

                       cdmenu_vax or
                       cdmenu_risc

                                      ULTRIX Software Product Library 5-9

 



    ULTRIX Software Product Library
    5.5 ECOs and MUPs


                For example:

                # setenv CD_DIRECTORY /mnt:/mnt/cdrom/cdmenu_vax

             o  When you invoke the cdmenu utility, substitute the
                appropriate ECO/MUP cdmenu subset name for cdmenu.

                For example:

                % /mnt/cdrom/cdmenu_vax

             These versions of the cdmenu utility, located in the
             /cdrom directory on the ECO/MUP CD-ROMs, are 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.

             ________________________ Note ________________________

             Do not use the ECO/MUP versions 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 by following the installation
             instructions in the ECO/MUP documentation.

             ________________________ Note ________________________

             Some of the ECOs and MUPs on these discs are not tar
             files and cannot be installed using setld.

             ______________________________________________________



    5-10 ULTRIX Software Product Library

 














     _________________________________________________________________

                                                                 Index



     C                                 Compact discs
     _______________________________     See CD-ROMs
     CD-ROM hardware
       documentation on, 1-1           D______________________________
     CD-ROMs                           Discs
       accessing
          on Digital UNIX, 4-5           See CD-ROMs
          on OpenVMS Alpha, 3-3        Documentation
          on OpenVMS VAX, 2-3            ordering,  vi

          on ULTRIX, 5-4
       controlling access              E______________________________
          on Digital UNIX, 4-1         ECOs
          on OpenVMS Alpha, 3-1          for Digital UNIX,  4-10
          on OpenVMS VAX, 2-1            for OpenVMS Alpha,  3-8
          on ULTRIX, 5-1                 for OpenVMS VAX,  2-8
       directory structure               for ULTRIX,  5-8
          on Digital UNIX, 4-6           ordering,  vi
          on OpenVMS Alpha, 3-3        Engineering Change Orders
          on OpenVMS VAX, 2-3            See ECOs
          on ULTRIX, 5-4
       handling, 1-1
       mounting                        I______________________________

          on Digital UNIX, 4-1         Installation
          on OpenVMS Alpha, 3-1          instructions
          on OpenVMS VAX, 2-1               on Digital UNIX,  4-8
          on ULTRIX, 5-1                    on OpenVMS Alpha,  3-6
     cdmenu utility                         on OpenVMS VAX,  2-6
       invoking                             on ULTRIX,  5-7
          on Digital UNIX, 4-5           layered products
          on ULTRIX, 5-3                    on Digital UNIX,  4-8
     CDMENU utility                         on OpenVMS Alpha,  3-5
       invoking                             on OpenVMS VAX,  2-6
          on OpenVMS Alpha, 3-2             on ULTRIX,  5-7
          on OpenVMS VAX, 2-2

                                                               Index-1

 







    Internet account                   Printing (cont'd)
      for providing feedback,  vi       OpenVMS Alpha documentation,

                                           3-5
    L______________________________     OpenVMS VAX documentation,

    License Management Facility            2-5
       (LMF), 1-2                       ULTRIX documentation,  5-6
    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 Digital UNIX,  4-9
      on Digital UNIX,  4-1             on ULTRIX,  5-8
      on OpenVMS Alpha,  3-1           Subset locations
      on OpenVMS VAX,  2-1              on Digital UNIX,  4-8
      on ULTRIX,  5-1                   on ULTRIX,  5-7
    MUPs
      for Digital UNIX,  4-10          V______________________________
      for OpenVMS Alpha,  3-8          VMSINSTAL utility
      for OpenVMS VAX,  2-8             on OpenVMS Alpha,  3-6
      for ULTRIX,  5-8                  on OpenVMS VAX,  2-6
      ordering,  vi

    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-7
    Printing
      Digital UNIX documentation,
         4-8

    Index-2
