Software Product Library CD-ROM

User's Guide

 

AA-QDGSE-XE

 

September 1999

This guide describes how to mount and control access to the Software Product Library CD-ROMs, use the CDMENU utility, access the contents of the CD-ROMs, and install layered products from the CD-ROMs.

This guide also describes how to access ECOs and MUPs for users who have purchased the Consolidated Software Engineering Change Order distribution.

Revision/Update Information: This is a revised manual.
Operating System and Version: OpenVMS VAX
OpenVMS Alpha
Tru64 UNIX
Software Version: Product Version 1.0

Compaq Computer Corporation
Houston, Texas


September 1999

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

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

Compaq Computer Corporation shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is subject to change without notice.

COMPAQ, the Compaq logo, and the Digital logo are Registered in the U.S. Patent and Trademark Office.

UNIX is a registered trademark and The Open Group is a trademark of The Open Group in the US and other countries.

Other product names mentioned herein may be the trademarks of their respective companies.


Table of Contents

Preface
Chapter 1 Overview of the CD-ROM User's Guide
1.1 About These CD-ROMs
1.1.1 Before Using the CD-ROMs
1.1.2 Handling the CD-ROMs
1.2 Product Licensing Agreements
Chapter 2 OpenVMS VAX Software Product Library
2.1 Mounting and Controlling Access to a CD-ROM
2.2 Using the CDMENU Utility
2.3 Accessing a Software CD-ROM
2.3.1 OpenVMS VAX CD-ROM Directory Structure
2.3.2 Release Notes and Other Documentation
2.3.3 Printing the Documents
2.4 Installing Layered Products
2.4.1 Location of Product Save Sets and Installation Instructions
2.4.2 Installation Methods
2.4.2.1 Using VMSINSTAL
2.4.2.2 Using the POLYCENTER Software Installation Utility
2.5 ECOs and MUPs
Chapter 3 OpenVMS Alpha Software Product Library
3.1 Mounting and Controlling Access to a CD-ROM
3.2 Using the CDMENU Utility
3.3 Accessing a Software CD-ROM
3.3.1 OpenVMS Alpha CD-ROM Directory Structure
3.3.2 Release Notes and Other Documentation
3.3.3 Printing the Documents
3.4 Installing Layered Products
3.4.1 Location of Product Save Sets and Installation Instructions
3.4.2 Installation Methods
3.4.2.1 Using VMSINSTAL
3.4.2.2 Using the POLYCENTER Software Installation Utility
3.5 ECOs and MUPs
Chapter 4 Compaq UNIX Software Product Library
4.1 Mounting and Controlling Access to a CD-ROM
4.2 Using the CDMENU Utility
4.3 Accessing a Software CD-ROM
4.3.1 Tru64 UNIX CD-ROM Directory Structure
4.3.2 Other Documentation
4.3.3 Printing the Documents
4.4 Installing Layered Products
4.4.1 Location of Product Subsets and Installation Instructions
4.4.2 Installation Methods
4.4.2.1 Using setld
4.5 ECOs and MUPs

Preface

This guide provides introductory information about the Software Product Library CD-ROMs.

Contents of this Guide

Chapter 1 begins with an overview, providing information about the Software Product Library CD-ROMs that is common to all platforms.

Chapter 2 to Chapter 4 describe platform-specific information for the following platforms:

The platform-specific information in Chapters 2 to 4 describes:

Ordering Information

Compaq Computer Corporation provides the following:

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

Call 1-800-344-4825 to place orders in the United States. Contact your local Compaq subsidiary outside the United States.

Order numbers for software kits, printed manuals, and software service are included in product cover letters or are listed on the SPDs.

Convention

Meaning

For_OpenVMS_platforms:

 

UPPERCASE TEXT

Uppercase letters indicate the name of a command, a file, a parameter, a procedure, or utility.

$

The dollar sign ($) indicates the DIGITAL Command Language (DCL) prompt on OpenVMS systems.
This prompt may be different on your system.

For Compaq® Tru64™ UNIX® systems

 

%

The percent sign (%) indicates the user prompt on Tru64 UNIX systems.

#

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

Tru64 UNIX, Tru64 UNIX Systems

References to Tru64 UNIX and Tru64 UNIX Systems refer to the Tru64 UNIX operating system running on Alpha processor hardware.

For_all_platforms

 

$ MOUNT DKA400: VAXDOCMAR991 mount -r /dev/rz4c/mnt

Boldface monospace text represents user input interactive examples.

device-name volume-label

Lowercase italics indicate a variable label string. These variables include product identifiers, hardware devices, directory locations, file names, and mount points.



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

The following information about the Compaq Software Product Library CD-ROMs applies to all platforms.

1.1 About These CD-ROMs

The Compaq Software Product Library CD-ROMs compose a software delivery vehicle that allows you to receive an update of consolidated software products on a regular basis.

This method of distribution does not change the content of any individual product. There is no impact on product compatibility; individual products are neither more nor less compatible with each other as a result of consolidated distribution.

1.1.1 Before Using the CD-ROMs

Make sure you are familiar with the system hardware, including your CD-ROM drive. Refer to the Optical Disc Drive Owner’s Manual for your CD-ROM reader for instructions on using the CD-ROM drive.

1.1.2 Handling the CD-ROMs

The CD-ROMs accompanying this booklet are enclosed in an antistatic envelope. In handling the CD-ROM, always grasp it by its edges only.

For information about inserting the CD-ROM in the disc drive, refer to the Optical Disc Drive Owner's Manual.

1.2 Product Licensing Agreements

The media and the software programs contained on these CD-ROMs belong to Compaq. Use of the software products is authorized only if you have a valid software license from Compaq. Therefore, you must purchase the appropriate software license for each product you want to use from this consolidated distribution.

A License Management Facility (LMF) Product Authorization Key (PAK) allows you to access a software product. A PAK must be registered and loaded before you can install the associated product from the Software Product Library CD-ROM. Each product has a unique LMF PAK name.

Refer to your license agreements for license terms and conditions.

See your operating system documentation for information on using the License Management Facility.



Chapter 2
OpenVMS VAX Software Product Library

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

2.1 Mounting and Controlling Access to a CD-ROM

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

  1. Find the appropriate volume label on the face of the CD-ROM.
  2. Log in to the system manager's account (SYSTEM).
  3. Mount the CD-ROM by entering the MOUNT command in the following format:
  4. MOUNT device-name: volume-label

    For example:

    $ MOUNT DKA400: VAXBINMAR991

2.2 Using the CDMENU Utility

The CDMENU utility provides a menu interface that helps you perform the following tasks easily:

  • Display a master index of all products
  • Display new and updated products
  • Fetch or copy release notes
  • Display and print installation guides and other documentation
  • 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.
  4. For example:

    $ DEFINE CD_EDIT LSE

    In this example, the Language Sensitive Editor (LSE) is invoked.

  5. Enter the following command at the system prompt to invoke the CDMENU utility:
  6. $ RUN CD_DIRECTORY:CDMENU

    The CDMENU main menu is displayed.

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

2.3 Accessing a Software CD-ROM

OpenVMS VAX Software Product Library CD-ROMs contain directories for each product. These directories contain save sets of the binary images included in the software product and product installation documentation in PostScript and ASCII text formats. Each product directory begins with a unique name for that product.

2.3.1 OpenVMS VAX CD-ROM Directory Structure

Table 2-1 shows the structure of the OpenVMS VAX Software Product Library CD-ROMs.

The [README] directory, located on the first CD-ROM, contains the documents you should read first. In most cases, these documents are available in ASCII text and PostScript format.

Note

If present, the files SPECIAL_NOTES.TXT and SPECIAL_NOTES.PS in the [README] directory contain important information about specific products in this release.

For each product, the name of the root directory usually corresponds to the name of the product save set. The kit save sets are located in the KIT subdirectory. Documentation is located in the DOCUMENTATION subdirectory.

Table 2-1 OpenVMS VAX CD-ROM Directory Structure

Directory

File

Contents

[README]

 

Documentation you should read first.

 

CDMASTER_INDEX.PS (.TXT)

Lists all products in this release, including which CD-ROM contains each product and the directory name for each product.

 

SW_COMPAT_MATRIX.PS (.TXT)

Indicates operating system versions that support each layered product.

 

USER_GUIDE.PS (.TXT)

User guide.

 

SW_LICENSE_DOC.PS (.TXT)

Software License Description.

 

SPECIAL_NOTES.PS (.TXT)

Contains last minute information on selected products.

[CDROM]

 

The CDMENU utility and related files.

[product]

 

Top level product directory, as shown in the OpenVMS VAX Software Product Library Master Index.

[product.KIT]

 

Product subdirectory containing save sets and/or PCSI files.

[product.DOCUMENTATION]

 

Product subdirectory containing documentation in .PS and .TXT formats.

 

product_IGUIDE.PS (.TXT)

Installation guides.

product_COVER.PS (.TXT)

Cover letters.

product_SPD.PS (.TXT)

Software Product Descriptions.

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:

  • On OpenVMS VAX Online Documentation Library CD-ROMs in an electronically viewable format
  • As individual product documentation sets in hardcopy format

Either may be ordered separately by contacting your Compaq account representative.

2.3.3 Printing the Documents

You can print the documentation for the OpenVMS VAX Software Product Library either by using the CDMENU utility (see Section 2.2) or by entering a DCL command. You do not need a product license to print these documents.

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

To print a document in Table 2-1 for text output, send the file to an ASCII printer by entering a command in one of the following formats:

$ PRINT/QUEUE=queue_ANSI device:[README]file-name.TXT

$ PRINT/QUEUE=queue_ANSI device:[product.DOCUMENTATION]file-name.TXT

To print a document in Table 2-1 for PostScript output, send the file to a PostScript printer by entering a command in one of the following formats:

$ PRINT/QUEUE=queue_POST device:[README]file-name.PS

$ PRINT/QUEUE=queue_POST device:[PRODUCT.DOCUMENTATION]file-name.PS

In the preceding examples, device represents the name of the drive on which you have placed your OpenVMS VAX Software Product Library CD-ROM.

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

  • Using the CDMENU utility (see Section 2.2).
  • Using the VMSINSTAL.
  • Using the POLYCENTER Software Installation utility.

2.4.2.1 Using VMSINSTAL

Individual layered product kits are located in their own directory hierarchies. For this reason, when you install a layered product, you must use a VMSINSTAL command line that is slightly different from the one given in the product's installation guide.

When you enter the VMSINSTAL command line, specify the disc drive and the directory by entering a command in the following format:

@SYS$UPDATE:VMSINSTAL product drive:[directory.KIT]

For example:

$ @SYS$UPDATE:VMSINSTAL FORT065 DKA400:[FORT065.KIT]

Additionally, certain system privileges must be enabled before you run VMSINSTAL. You must be logged in to a privileged account (such as the system manager's account, SYSTEM) that has the SETPRV privilege or at least the following privileges enabled:

  • CMKRNL
  • SYSPRV
  • 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:

  • BYPASS
  • CMKRNL
  • SYSLCK

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

$ SHOW PROCESS/PRIVILEGES

To see whether a previous version of a product is installed, use the PRODUCT SHOW PRODUCT command. For example:

$ PRODUCT SHOW PRODUCT FORTRAN

Refer to the product's installation guide for more information on installing products using the POLYCENTER Software Installation utility.

To use other features of the POLYCENTER Software Intallation utility, see the POLYCENTER Software Installation Utility User's Guide.

2.5 ECOs and MUPs

This section describes the Consolidated Software Engineering Change Order distribution for OpenVMS VAX. This distribution provides ECOs and MUPs. Use these instructions if you have purchased the Consolidated Software Engineering Change Order distribution.

Note

To purchase the Consolidated Software Engineering Change Order distribution for OpenVMS VAX, contact your local service office.

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

Table 2-2 OpenVMS VAX ECO and MUP CD-ROM Directory Structure

Directory

Contents

[ECOname.KIT]

ECO or MUP save sets.

[ECOname.DOCUMENTATION]

Documentation in ASCII and PostScript format. (Includes a cover letter for each ECO and MUP.)

[CDROM]

CDMENU utility and associated files.

[README]

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

USER_GUIDE.PS (.TXT)

User guide.

CDMASTER_INDEX.PS (.TXT)

OpenVMS VAX Consolidated Software Engineering Change Order Master Index.

To access an ECO or MUP, do the following:

  1. Mount the first CD-ROM as described in Section 2.1.
  2. Print the file CDMASTER_INDEX.PS or CDMASTER_INDEX.TXT and use it to determine which CD-ROM contains the ECO or MUP you are interested in.
  3. 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.

  4. Invoke the ECO/MUP CDMENU utility as described in Section 2.2.
  5. This version of the CDMENU utility, located in the [CDROM] directory on the ECO/MUP CD-ROMs, is provided to assist in using the ECO/MUP CD-ROMS.

    An advantage of using the ECO/MUP version of CDMENU to install an ECO or MUP is that a product history is created, which you can reference at a future date.

    Note

    Do not use this ECO/MUP version of CDMENU with the Software Products Library CD-ROMs.
  6. Use CDMENU to print or view the product's ECO/MUP cover letter.
  7. To determine the applicability of an ECO or MUP, read the information in the cover letter which discusses the problems addressed in the kit.

  8. Install the ECO or MUP using one of the methods described in Section 2.4.2.



Chapter 3
OpenVMS Alpha Software Product Library

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

3.1 Mounting and Controlling Access to a CD-ROM

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

  1. Find the appropriate volume label on the face of the CD-ROM.
  2. Log in to the system manager's account (SYSTEM).
  3. Mount the CD-ROM by entering the MOUNT command in the following format:
  4. MOUNT device-name: volume-label

    For example:

    $ MOUNT DKA400: AXPBINMAR991

3.2 Using the CDMENU Utility

The CDMENU utility provides a menu interface that helps you perform the following tasks easily:

  • Display a master index of all products
  • Display new and updated products
  • Fetch or copy release notes
  • Display and print installation guides and other documentation
  • 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.
  4. For example:

    $ DEFINE CD_EDIT LSE

  5. Enter the following command at the system prompt to invoke the CDMENU utility:
  6. $ RUN CD_DIRECTORY:CDMENU

    The CDMENU main menu is displayed.

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

Lists all products in this release, including which
CD-ROM contains each product and the directory name for each product.

 

SW_COMPAT_MATRIX.PS (.TXT)

Indicates operating system versions that support each layered product.

 

USER_GUIDE.PS (.TXT)

User guide.

 

SW_LICENSE_DOC.PS (.TXT)

Software License Description.

 

SPECIAL_NOTES.PS (.TXT)

Contains last minute information on selected products.

[CDROM]

 

The CDMENU utility and related files.

[product]

 

Top level product directory, as shown in the OpenVMS Alpha Software Product Library Master Index.

[product.KIT]

 

Product subdirectory containing save sets and/or PCSI files.

[product.DOCUMENTATION]

 

Product subdirectory containing documentation in .PS and .TXT formats.

 

product_IGUIDE.PS (.TXT)

Installation guides.

product_COVER.PS (.TXT)

Cover letters.

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.

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

  • On OpenVMS Alpha Online Documentation Library CD-ROMs in an electronically viewable format
  • As individual product documentation sets in hardcopy format

Either may be ordered separately by contacting your Compaq account representative.

3.3.3 Printing the Documents

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

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

To print a document in Table 3-1 for text output, send the file to an ASCII printer by entering a command in one of the following formats:

$ PRINT/QUEUE=queue_ANSI device:[README]file-name.TXT

$ PRINT/QUEUE=queue_ANSI device:[product.DOCUMENTATION]file-name.TXT

To print a document in Table 3-1 for PostScript output, send the file to a PostScript printer by entering a command in one of the following formats:

$ PRINT/QUEUE=queue_POST device:[README]file-name.PS

$ PRINT/QUEUE=queue_POST device:[product.DOCUMENTATION]file-name.PS

In the preceding examples, device represents the name of the drive on which you have placed your OpenVMS Alpha Software Product Library CD-ROM.

3.4 Installing Layered Products

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

3.4.1 Location of Product Save Sets and Installation Instructions

The OpenVMS Alpha Software Product Library Master Index gives the directory locations of the products on the software binaries CD-ROMs. This information is also available in the CDMASTER_INDEX.PS and CDMASTER_INDEX.TXT files in the [README] directory on the first CD-ROM.

Installation information for each product, in PostScript and ASCII text formats, is located in [product.DOCUMENTATION] directories, where product is the product directory name as given in the OpenVMS Alpha Software Product Library Master Index.

You do not need a product license to print the information in these directories.

Read the Ordering Information section in the product SPD for product ordering information.

3.4.2 Installation Methods

Install layered products using one of the following methods:

  • Using the CDMENU utility (see Section 3.2).
  • Using the VMSINSTAL utility.
  • 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]

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:

  • CMKRNL
  • SYSPRV
  • WORLD

To check whether your process has SETPRV or other privileges enabled, enter the following command:

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:

  • CMKRNL
  • SYSLCK
  • SYSPRV

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

$ SHOW PROCESS/PRIVILEGES

To see whether a previous version of a product is installed, use the PRODUCT SHOW PRODUCT command. For example:

$ PRODUCT SHOW PRODUCT FORTRAN

Refer to the product's installation guide for more information on installing products using the POLYCENTER Software Installation utility.

To use other features of the POLYCENTER Software Intallation utility, see the POLYCENTER Software Installation Utility User's Guide.

3.5 ECOs and MUPs

This section describes the OpenVMS Alpha Consolidated Software Engineering Change Order distribution, which provides ECOs and MUPs. Use these instructions if you have purchased the Consolidated Software Engineering Change Order distribution.

Note

To purchase the Consolidated Software Engineering Change Order distribution for OpenVMS Alpha, contact your local service office.

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

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

Directory

Contents

[ECOname.KIT]

ECO or MUP save sets and/or .PCSI files.

[ECOname.DOCUMENTATION]

Documentation in ASCII and PostScript format. (Includes a cover letter for each ECO and MUP.)

[CDROM]

CDMENU utility and associated files.

[README]

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

USER_GUIDE.PS (.TXT)

User guide.

CDMASTER_INDEX.PS (.TXT)

OpenVMS Alpha Consolidated Software Engineering Change Order Master Index.

To access an ECO or MUP, do the following:

  1. Mount the first CD-ROM as described in Section 3.1.
  2. Print the file CDMASTER_INDEX.PS or CDMASTER_INDEX.TXT and use it to determine which CD-ROM contains the ECO or MUP you are interested in.
  3. 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.

  4. Invoke the ECO/MUP CDMENU utility as described in Section 3.2.
  5. This version of the CDMENU utility, located in the [CDROM ] directory on the ECO/MUP CD-ROMs, is provided to assist in using the ECO/MUP CD-ROMS.

    An advantage of using the ECO/MUP version of CDMENU to install an ECO or MUP is that a product history is created, which you can reference at a future date.

    Note

    Do not use this version of CDMENU with the Software Products Library CD-ROMs.
  6. Use CDMENU to print or view the product's ECO/MUP cover letter.
  7. To determine the applicability of an ECO or MUP, read the information in the cover letter which discusses the problems addressed in the kit.

  8. Install the ECO or MUP using one of the methods described in Section 3.4.2.



Chapter 4
Compaq Tru 64 UNIX Software Product Library

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

4.1 Mounting and Controlling Access to a CD-ROM

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

  1. Load the CD-ROM into the drive.
  2. Log in as root or become superuser:
  3. % su

    Password:

  4. If you do not know the device name for the CD-ROM drive, use the file command to find it.
  5. # 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)

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

    For example:

    # mkdir /mnt

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

  8. Mount the CD-ROM using the -r option to indicate that the CD-ROM is read-only.
    • 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

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

  9. To dismount a CD-ROM, use a command in one of the following formats:
  10. # umount /mnt

    or

    # /sbin/umount /dev/rz4c

  11. To ensure that a CD-ROM is remounted in the event that your system crashes or is rebooted, follow these steps:
    1. Using the text editor of your choice, open the file /sbin/bcheckrc and search for the following section:
    2. #

      # mount local (non-nfs) filesystems

      #

      echo 'Mounting local filesystems'

      /sbin/mount -a -v -t nonfs

    3. 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:
    4. #

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

  • Display a master index of all products
  • Display new and updated products
  • Display and print installation guides and other documentation
  • 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:
    • 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

    • 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.
  5. For example:

    # setenv CD_EDIT vi

  6. Enter one of the following commands at the system prompt to invoke the cdmenu utility. (The examples assume a /mnt mount point.)
    • For a single CD-ROM:

    # /mnt/cdrom/cdmenu

    • For multiple CD-ROMs:
    • # /mnt1/cdrom/cdmenu

      The CDMENU main menu is displayed.

  7. Follow the directions on the screen to choose the option for the task you want to perform.
Note

The cdmenu utility assumes the CD-ROMs identified in the CD_DIRECTORY environment variable are from the same release because it utilizes the first instance of cd_contents.dat located in the /cdrom directory.

4.3 Accessing a Software CD-ROM

Tru64 UNIX Software Product Library CD-ROMs contain directories for each product. These directories contain subsets of the binary images included in the software product and product installation documentation in PostScript and ASCII text formats. Each product directory begins with a name unique for that product.

4.3.1 Tru64 UNIX CD-ROM Directory Structure

Table 4-1 shows the structure of the Tru64 UNIX Software Product Library CD-ROMs.

The /readme directory, located on the first CD-ROM, contains the documents you should read first. In most cases, these documents are available in ASCII and PostScript format.

Note

If present, the files special_notes.txt and special_notes.ps in the /readme directory contain important information about specific products in this release.

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

Table 4-1 Compaq Tru64 UNIX CD-ROM Directory Structure

Directory

File

Contents

/readme

 

Documentation you should read first.

 

cdmaster_index.ps (.txt)

Lists all products in this release, including which CD-ROM contains each product and the directory name for each product.

 

sw_compat_matrix.ps (.txt)

Indicates operating system versions that support each layered product.

 

user_guide.ps (.txt)

User guide.

 

sw_license_doc.ps (.txt)

Software License Description.

 

special_notes.ps (.txt)

Contains last-minute information on selected products.

/cdrom

 

The cdmenu utility and related files.

/product

 

Top-level product directory, as shown in the Tru64 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 (.txt)

Installation guides.

product_cover.ps (.txt)

Cover letters.

product_relnotes.ps (.txt)

Release notes.

 

product_spd.ps (.txt)

Software Product Descriptions.

4.3.2 Other Documentation

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

  • On the Tru64 UNIX Online Documentation Library CD-ROMs in an electronically viewable format
  • As individual product documentation sets in hardcopy format

Either may be ordered separately by contacting your Compaq account representative.

4.3.3 Printing the Documents

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

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

To print a document in Table 4-1 for text output, send the file to an ASCII printer by entering a command in one of the following formats. (The examples assume a /mnt mount point.)

% lpr -Pqueue-name /mnt/product/documentation/file-name.txt

% lpr -Pqueue-name /mnt/readme/file-name.txt

To print a document in Table 4-1 for PostScript output, send the file to a PostScript printer by entering a command in one of the following formats:

% lpr -Pqueue-name /mnt/product/documentation/file-name.ps

% lpr -Pqueue-name /mnt/readme/file-name.ps

4.4 Installing Layered Products

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

4.4.1 Location of Product Subsets and Installation Instructions

The Tru64 UNIX Software Product Library Master Index gives the directory locations of the products on the software binaries CD-ROMs. This information is also available in the cdmaster_index.ps and cdmaster_index.txt files in the /readme directory on the first CD-ROM.

Installation information for each product, in PostScript and ASCII text formats, is located in product/documentation directories, where product is the product directory name as given in the Tru64 UNIX Software Product Library Master Index.

You do not need a product license to print the information in these directories.

Read the Ordering Information section in the product SPD for product ordering information.

4.4.2 Installation Methods

Install layered products using one of the following methods:

  • Using the cdmenu utility (see Section 4.2).
  • 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 Tru64 UNIX Software Product Library:

  1. Log in as superuser.
  2. Enter a setld command that specifies the load function -l (ell). Use the following format:
  3. % /sbin/setld -l /mount-point/product/kit

    For example:

    % /sbin/setld -l /mnt/pas570/kit

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

4.5 ECOs and MUPs

This section describes the Tru64 UNIX Consolidated Software Engineering Change Order distribution, which provides ECOs and MUPs. Use these instructions if you have purchased the Consolidated Software Engineering Change Order distribution.

Note

To purchase the Consolidated Software Engineering Change Order distribution for Tru64 UNIX, contact your local service office.

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

Table 4-2 Tru64 UNIX ECO and MUP CD-ROM Directory Structure

Directory

Contents

/ECOname/kit

ECO or MUP subsets.

/ECOname/documentation

Documentation in ASCII and PostScript format. (Includes a cover letter for each ECO /MUP.)

/cdrom

CDMENU utility and associated files.

/readme

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

/readme/cdmaster_index.ps (.txt)

Tru64 UNIX Consolidated Software Engineering Change Order Master Index.

/readme/user guide.ps (.txt)

User guide.

To access an ECO or MUP, do the following:

  1. Mount the first CD-ROM as described in Section 4.1.
  2. Print the file cdmaster_index.ps or cdmaster_index.txt and use it to determine which
    CD-ROM contains the ECO or MUP you are interested in.
  3. 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.

  4. Invoke the ECO/MUP CDMENU utility as described in Section 4.2.
  5. 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.
  6. Use CDMENU to print or view the product's ECO/MUP cover letter.
  7. To determine the applicability of an ECO or MUP, read the information in the cover letter which discusses the problems addressed in the kit.

  8. Install the ECO or MUP using one of the methods described in Section 4.4.2.