Updated: 11 December 1998 |
OpenVMS System Manager's Manual
Previous | Contents | Index |
When you use a single DCL command to install or configure more than one
product and write the responses to a PCF, the information for all the
products that are installed or configured is in a single PCF. Use
separate operations to install or configure a set of products when you
want to keep each product's configuration values in its own PCF.
3.7.4.4 Modifying an Existing PCF
You can use DCL to modify an existing file. Specify the name of the PCF to be modified and the name of the PCF to be created. Include both the INPUT and the OUTPUT keywords with the /CONFIGURATION qualifier on the PRODUCT CONFIGURE command line. For example, read the default values in the file PRODUCTA_REV1.DAT, make changes to the file, and save the changes to PRODUCTA_REV2.DAT, the output file:
$ PRODUCT CONFIGURE - _$ /CONFIGURATION=(INPUT=PRODUCTA_REV1.DAT,OUTPUT=PRODUCTA_REV2.DAT) - _$ PRODUCTA |
The POLYCENTER Software Installation utility automatically stores information about product
installation, configuration choices, and objects, such as files and
directories, that make up the product in the product database. The
product database is useful for recalling information about products
installed on your system and for detecting and tracking product
dependencies.
3.7.5.1 Adding Information to the Database
Although the POLYCENTER Software Installation utility stores product information for you automatically, you can also add your own information. When you perform a task, you can include a remark---a comment to be recorded in the product database---along with the other information about the task being performed.
To add a remark to the product database, use the /REMARK qualifier with any of the following DCL commands:
Refer to the OpenVMS System Management Utilities Reference Manual for information about this command and the
/REMARK qualifier.
3.7.5.2 Registering a Noncompliant Product
To register a product that was installed with a tool other than the POLYCENTER Software Installation utility, enter PRODUCT REGISTER PRODUCT. This command records information that a PDF provides. For example:
$ PRODUCT REGISTER PRODUCT TOOLCHEST |
If you do not have a PDF for a product you want to register, enter the following command:
$ @SYS$UPDATE:PCSI$REGISTER_PRODUCT.COM |
This procedure prompts you for the product name, version, and producer. For example, the producer for DIGITAL products is DEC. The procedure uses this information to create a temporary, minimal PDF. It then executes the PRODUCT REGISTER PRODUCT command to register the product, and deletes the temporary PDF.
Because PCSI$REGISTER_PRODUCT.COM creates only a minimal PDF, it cannot register with the POLYCENTER Software Installation utility database all the information about the product. For this reason, if a PDF for the product is available, use it.
Although a transition PDF is intended specifically for PRODUCT REGISTER
PRODUCT, you can also register full and operating system PDFs.
3.7.5.3 Detecting and Tracking Software Dependencies
Some software products depend on other software products to work
correctly. For example, a product might work only when a specific
version of another product is installed on the system. The
POLYCENTER Software Installation utility detects and tracks the dependencies of the products that
you install. The utility also attempts to satisfy the requirements of
multiple products. In some instances, the POLYCENTER Software Installation utility is unable to
resolve product dependency issues. In such instances, the utility
provides feedback on the nature of the conflict and asks you to decide
how to proceed.
3.8 Installing with the POLYCENTER Software Installation Utility
The basic steps for installing a software product are:
Before installing software, follow these steps:
For many operations, you must specify a location where the software kit resides and a location where you want to install the software. Two methods are available for identifying these locations:
You can also define logical names, and then override them by using the /SOURCE and /DESTINATION qualifiers on the PRODUCT command.
If you do not deassign logical names after they are used, they can cause unexpected results in future operations of the POLYCENTER Software Installation utility. Compaq recommends that you use the /SOURCE and /DESTINATION qualifiers. |
Logical name PCSI$SOURCE defines the location of the software kits you want to install. Logical name PCSI$DESTINATION defines the location where you want to install the software. For example, if the software is located in DISK1:[KITS] and you want to install it in DISK2:[APPLICATIONS], use the following commands:
$ DEFINE PCSI$SOURCE DISK1:[KITS] $ DEFINE PCSI$DESTINATION DISK2:[APPLICATIONS] |
You can override the logical name definitions by using /SOURCE and /DESTINATION qualifiers on the PRODUCT command to specify a different source and destination.
If you do not define PCSI$DESTINATION, the utility installs the
software product in SYS$COMMON:[VMS$COMMON] and directories under it.
3.8.1.2 Installing Prerequisite Software
Install any prerequisite software or perform any prerequisite tasks. This information should be in the software product's installation instructions or release notes.
Note that the POLYCENTER Software Installation utility will perform
this automatically if the kits are available.
3.8.1.3 Identifying Postinstallation Procedures
Note any postinstallation procedures. This information should also be
in the software product's installation instructions or release notes.
3.8.2 Extracting a Product's Release Notes
To read a product's release notes, extract the notes to a file. For example, use either of the following commands to copy the CMS product release notes to a text file:
$ PRODUCT EXTRACT RELEASE_NOTES CMS/FILE=CMS_RELNOTES.TXT $ PRODUCT EXTRACT RELEASE_NOTES CMS/SOURCE=WORK_DISK:[KITS]/FILE=CMS_RELNOTES.TXT |
If you do not specify a file name, the release notes are written to a
file named DEFAULT.PCSI$RELEASE_NOTES in the current directory. It is
not necessary to install a software product before you use the
POLYCENTER Software Installation utility to extract its release notes.
3.8.3 Installing a Product
To start an installation, enter the PRODUCT INSTALL command. For example:
$ PRODUCT INSTALL CMS |
To install more than one product at a time, enter a list of product names separated by commas. You can use asterisk (*) wildcard characters in the product names. For example:
$ PRODUCT INSTALL CMS/VERSION=3.4,LSE,COB*/VERSION=5.0 |
Table 3-7 lists some of the features you can control with command qualifiers. A complete list is in the OpenVMS System Management Utilities Reference Manual and in online help.
Feature | Qualifier |
---|---|
Supply answers from a PCF | /CONFIGURATION=INPUT= pcf-name |
Create a new PCF | /CONFIGURATION=OUTPUT= pcf-name 1 |
Specify where to install the files | /DESTINATION= location |
Display full descriptions of all product installation options and information | /HELP |
Display log messages on your terminal | /LOG |
Include a remark in the product database | /REMARK |
Specify where the distribution kit is located | /SOURCE |
Specify configuration variables | /CONFIGURATION= keyword 2 |
Specify a work area for temporary files | /WORK= device |
Section 3.7.4 describes how to create a PCF before installing a product. To use this existing PCF during the installation, use the /CONFIGURATION=INPUT qualifier with PRODUCT INSTALL. For example, to install CMS and use configuration choices recorded in the PCF named DEC-VAXVMS-CMS.PCSI$CONFIGURATION:
$ PRODUCT INSTALL/CONFIGURATION=INPUT=DEC-VAXVMS-CMS.PCSI$CONFIGURATION - _$ CMS/VERSION=3.4 |
If you did not create a PCF before the installation, you can create one during the installation. Use the /CONFIGURATION=OUTPUT=pcf-name qualifier with PRODUCT INSTALL. For example:
$ PRODUCT INSTALL/CONFIGURATION=OUTPUT=CMSV3.DAT CMS/VERSION=3.0 |
As you respond to questions about the options for CMS Version 3.0, your responses are recorded in the PCF named CMSV3.DAT in your current default directory.
For more information about product configuration files, see
Section 3.7.1 and Section 3.7.4.
3.8.4 Responding to Installation Questions
During an installation, you can request a full description of product
options or an explanation to any single question. You can also accept
the default value to any single question or to an entire subset of
questions.
3.8.4.1 Requesting an Explanation to Questions
To request a full description of all product options and information, use the /HELP qualifier with PRODUCT INSTALL. To request help about an individual question, press the Help key or PF2 in response to the question. The POLYCENTER Software Installation utility displays a description (if one is available) and a summary of disk and memory requirements for the option.
The following example uses the Help key:
$ PRODUCT INSTALL UCX . . . Optional example files may be installed... [YES] [Help] The example files include client server programming examples. Block Size - Total: 507 Optional: 0 Required: 507 Global Pages - Total: 0 Optional: 0 Required: 0 Global Sections - Total: 0 Optional: 0 Required: 0 Optional example files may be installed... [YES] [Return] . . . |
The amount of information varies; some products provide more
information than others, and some products provide no information.
3.8.4.2 Accepting Default Answers
Default answers come from one of three places:
If you specify an input PCF and it contains an answer for an option, the default answer from the PCF is used. Depending on the entry in the PCF, the default answer may or may not be allowed to change.
If no input PCF exists, or if the input PCF does not contain an answer for an option, the default answer comes from either the PDB or the PDF. If the PDB is present and contains the option, then the default answer comes from the PDB. If the PDB is not present (a new installation) or does not contain the option (a new option), then the default comes from the PDF. Default answers that come from either the PDB or PDF may be changed.
To answer an option, either press Return to accept the default answer, or supply your own answer and then press Return.
Some products contain a subset of questions or options. During an installation procedure, you can accept the default values for an entire subset or you can answer each option in the subset.
When you select an option that has suboptions, the POLYCENTER Software Installation utility will ask:
Do you want the defaults for all options? [YES] |
After you respond to questions about product options, the POLYCENTER Software Installation utility can display a summary of your answers. For example:
Do you want to review the options? [YES] [Return] DEC TCP/IP Services for OpenVMS Optional example files may be installed...: NO Optional NFS files may be installed...: NO Optional applications may be installed...: YES |
The POLYCENTER Software Installation utility then asks:
Are you satisfied with these options? [YES] [Return] |
If you are not, answer NO to this question. You can then either enter your answers again or exit the installation procedure:
Do you want to change any options? [YES] NO [Return] %PCSIUI-I-USERABORT, operation terminated by user |
By answering NO to this question, you can end the installation
procedure. The product is not installed; your system remains unchanged.
3.8.5.1 Updating DCL Help Text
When you install a layered product that updates DCL Help text, the PRODUCT INSTALL command requires exclusive access to the DCL Help library file, SYS$HELP:HELPLIB.HLB. For example, if a user is accessing HELP while an installation is trying to update the help library, you see several messages and are asked to respond to several questions. These messages and questions appear in the following order:
%PCSI-I-PRCOUTPUT, output from subprocess follows ... %LIBRAR-F-OPENIN, error opening disk:[SYS0.SYSCOMMON.] [SYSHLP]HELPLIB.HLB;1 as input -RMS-E-FLK, file currently locked by another user %PCSI-E-MODREPLFLK1, error replacing module module-name in library disk:[SYS0.SYSCOMMON.][SYSHLP]HELPLIB.HLB -PCSI-E-MODREPLFLK2, library update failed because it is currently accessed by one or more users -PCSI-E-MODREPLFLK3, after the file is closed, answer YES at the prompt to retry the update |
Do you want to take this action? [YES] YES |
Do you want to take this action? [YES] NO Do you want to continue? [YES] NO %PCSI-E-CANCEL_WIP, termination resulted in an incomplete modification to the system |
To run the POLYCENTER Software Installation utility as a batch job, include PRODUCT commands in a command procedure file and then submit the file to a batch queue. In the command procedure, include the /CONFIGURATION qualifier to specify an existing PCF so the POLYCENTER Software Installation utility can respond to questions about product options and configuration choices. If you do not specify /CONFIGURATION, the defaults are used.
Example 3-2 shows how a product might be installed using a command procedure. The example sets and restores VERIFY, and times the installation.
Example 3-2 Sample Command Procedure for Installing a Product |
---|
$ SAVE_PROC_VERIFY = F$ENVIRONMENT("VERIFY_PROCEDURE") $ SAVE_IMAGE_VERIFY = F$ENVIRONMENT("VERIFY_IMAGE") $ SET VERIFY $ ON ERROR THEN GOTO ERROR_EXIT $ START_TIME = F$TIME() $ WRITE SYS$OUTPUT "START TIME -- ''START_TIME'" $ PRODUCT INSTALL CHESSMASTER - /CONFIGURATION=PRODUCER - /HELP - /LOG $ERROR_EXIT: $ END_TIME = F$TIME() $ TEMP = F$VERIFY(SAVE_PROC_VERIFY,SAVE_IMAGE_VERIFY) $ WRITE SYS$OUTPUT " --------------------------------" $ WRITE SYS$OUTPUT " END TIME -- ''END_TIME'" $ WRITE SYS$OUTPUT " START TIME -- ''START_TIME'" $ WRITE SYS$OUTPUT " --------------------------------" $ EXIT |
You can perform other operations on installed software products (for
example, reconfiguring choices made during the installation, recording
changes in volume label, or copying the software to a new location or
to different media). You might also want to convert a kit to a new
format, display product information, display the contents of a
sequentially packaged product kit, or extract any file from a
sequentially packaged kit.
3.9.1 Reconfiguring an Installed Product
After you install a product, you can change the configuration choices made during the installation. This is called reconfiguration. You choose the options you want; the POLYCENTER Software Installation utility makes all the necessary changes.
To change the configuration choices for an installed product, use the PRODUCT RECONFIGURE command. The product kit must be present in the user's default directory or specified by the /SOURCE qualifier or by the PCSI$SOURCE logical name.
Previous | Next | Contents | Index |
Copyright © Compaq Computer Corporation 1998. All rights reserved. Legal |
6017PRO_007.HTML
|