HP DECprint Supervisor (DCPS) for OpenVMS
Software Installation Guide

Appendix A
Sample Installation Session

Example A-1 shows a sample installation of the DECprint Supervisor software on an OpenVMS I64 system with no previous DCPS queues running. Example A-2 shows a sample installation on an OpenVMS Alpha system in a cluster with running DCPS queues.

Example A-1 Sample New Installation on an OpenVMS I64 System

$ PRODUCT INSTALL DCPS /SOURCE=DQA0:[DCPS027.KIT] 1 - HP AXPVMS DCPS V2.7 Layered Product 2 - HP I64VMS DCPS V2.7 Layered Product 3 - HP VAXVMS DCPS V2.7 Layered Product 4 - All products listed above 5 - Exit Choose one or more items from the menu separated by commas: 2 The following product has been selected: HP I64VMS DCPS V2.7 Layered Product Do you want to continue? [YES] [Return] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. HP I64VMS DCPS V2.7: HP DECprint Supervisor for OpenVMS © Copyright 2005 Hewlett-Packard Development Company, L.P. Examining system environment ... * This product does not have any configuration options. Execution phase starting ... Do you want to continue? [YES] [Return] The following product will be installed to destination: HP I64VMS DCPS V2.7 DISK$SYS_SARAH:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% The following product has been installed: HP I64VMS DCPS V2.7 Layered Product %PCSI-I-IVPEXECUTE, executing test procedure for HP I64VMS DCPS V2.7 ... %DCPS-I-JOBSTART, Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 150) started on DCPS$IVP_TEST Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 150) completed %DCPS-I-JOBSTART, Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 151) started on DCPS$IVP_TEST Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 151) completed %DCPS-I-JOBSTART, Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 152) started on DCPS$IVP_TEST Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 152) completed %DCPS-I-JOBSTART, Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 153) started on DCPS$IVP_TEST Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 153) completed %DCPS-I-JOBSTART, Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 154) started on DCPS$IVP_TEST Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 154) completed %DCPS-I-JOBSTART, Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 155) started on DCPS$IVP_TEST Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 155) completed %DCPS-I-JOBSTART, Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 156) started on DCPS$IVP_TEST Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 156) completed %PCSI-I-IVPSUCCESS, test procedure completed successfully HP I64VMS DCPS V2.7: HP DECprint Supervisor for OpenVMS DCPS Release Notes (text and PostScript) have been provided in SYS$HELP

Example A-2 Sample Upgrade Installation on an OpenVMS Alpha System

$ PRODUCT INSTALL DCPS /SOURCE=DQA0:[DCPS027.KIT] 1 - HP AXPVMS DCPS V2.7 Layered Product 2 - HP I64VMS DCPS V2.7 Layered Product 3 - HP VAXVMS DCPS V2.7 Layered Product 4 - All products listed above 5 - Exit Choose one or more items from the menu separated by commas: 1 The following product has been selected: HP AXPVMS DCPS V2.7 Layered Product Do you want to continue? [YES] [Return] The following product will be installed to destination: HP AXPVMS DCPS V2.7 DISK$SYS_JULIE:[VMS$COMMON.] The following product will be removed from destination: HP AXPVMS DCPS V2.5 DISK$SYS_JULIE:[VMS$COMMON.] Configuration phase starting ... You will be asked to choose options, if any, for each selected product and for any products that may be installed to satisfy software dependency requirements. HP AXPVMS DCPS V2.7: HP DECprint Supervisor for OpenVMS © Copyright 2005 Hewlett-Packard Development Company, L.P. Examining system environment ... You should stop all running DCPS queues on this system (JULIE). Do you want to see a list of queues that will be stopped? [NO] Y Choose from the following options: 1 - Stop the 15 DCPS queues on this system 2 - Stop the 171 DCPS queues in the cluster 3 - Do not stop any queues (not recommended) Enter option: [1] Queue Status Node Device ----- ------ ---- ------ HP1320_LPD Idle JULIE "IP_LPD/lj1320" HP1320_RAW Idle JULIE "IP_RawTCP/lj1320:9100" HP2430_LPD Idle JULIE "IP_LPD/lj2430" HP2430_LPDREMOTE Idle JULIE "IP_LPD/unixsystem:hp2430_raw" HP3800_LPD Idle JULIE "IP_LPD/clj3800" HP3800_RAW Idle JULIE "IP_RawTCP/clj3800:9100" HP4600_LPD Idle JULIE "IP_LPD/dcpshp4600" HP4600_RAW Idle JULIE "IP_RawTCP/dcpshp4600:9100" HP4700_RAW Idle JULIE "IP_RawTCP/clj4700:9100" HP5200_LPD Idle JULIE "IP_LPD/lj5200" HP5200_RAW Idle JULIE "IP_RawTCP/lj5200:9100" HP9000MFP_RAW Idle JULIE "IP_RawTCP/hp03026.zko.dec.com:9100" HP9000_POD Idle JULIE "IP_RawTCP/hp34hp312.zko.dec.com:9100" LN28_LPD Idle JULIE "IP_RawTCP/ln28:9100" LN32_LAT Idle JULIE "serial/DCPS_LN32" Do you want to stop the queues and continue the installation? [YES] [Return] If the installation fails, DCPS queues may need to be restarted manually. Stopping DCPS queues ... DCPS, when so configured, will store temporary spool files in directory [DCPS$SPOOL]. By default, this directory is created in SYS$COMMON. It is recommended that you choose a non-system disk for this directory. Enter location for DCPS spool directory: [SYS$COMMON] DISK$HELPER The following DCPS spool directory will be created: DISK$HELPER:[DCPS$SPOOL] Is this correct? [YES] [Return] * This product does not have any configuration options. Execution phase starting ... The following product will be installed to destination: HP AXPVMS DCPS V2.7 DISK$SYS_JULIE:[VMS$COMMON.] The following product will be removed from destination: HP AXPVMS DCPS V2.5 DISK$SYS_ROUTE2:[VMS$COMMON.] Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90% Starting DCPS queues ... ...100% The following product has been installed: HP AXPVMS DCPS V2.7 Layered Product The following product has been removed: HP AXPVMS DCPS V2.5 Layered Product %PCSI-I-IVPEXECUTE, executing test procedure for HP AXPVMS DCPS V2.7 ... %DCPS-I-JOBSTART, Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 157) started on DCPS$IVP_TEST Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 157) completed %DCPS-I-JOBSTART, Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 158) started on DCPS$IVP_TEST Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 158) completed %DCPS-I-JOBSTART, Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 159) started on DCPS$IVP_TEST Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 159) completed %DCPS-I-JOBSTART, Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 160) started on DCPS$IVP_TEST Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 160) completed %DCPS-I-JOBSTART, Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 161) started on DCPS$IVP_TEST Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 161) completed %DCPS-I-JOBSTART, Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 162) started on DCPS$IVP_TEST Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 162) completed %DCPS-I-JOBSTART, Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 163) started on DCPS$IVP_TEST Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 163) completed %PCSI-I-IVPSUCCESS, test procedure completed successfully HP AXPVMS DCPS V2.7: HP DECprint Supervisor for OpenVMS DCPS Release Notes (text and PostScript) have been provided in SYS$HELP

Appendix B
Installing the Software with VMSINSTAL

This appendix describes how to install DECprint Supervisor software using the VMSINSTAL utility. VMSINSTAL is used to install DCPS on systems running versions of OpenVMS older than V6.2. If you are not familiar with the VMSINSTAL utility, refer to the HP OpenVMS System Manager's Manual.

B.1 Overview

Follow the steps in Section 2.1 to prepare for the DCPS installation.

B.2 VMSINSTAL Conventions

VMSINSTAL will prompt you for site-specific information. Questions are preceded by an asterisk (*) and may be followed by default responses enclosed in brackets ([]). Enter your response followed by [Return].

Press [Return] to enter the default response. If you are not sure of the response, enter a question mark (?). VMSINSTAL displays explanatory text and repeats the prompt.

Messages specific to the installation of DECprint Supervisor software are listed in Section B.4.

B.3 Installing the Software

Note

This section does not reproduce all of the text you may see on your screen during the installation of the DCPS software. Sample VMSINSTAL installation scripts are shown in Section B.5.

To install the software, use the following procedure:

Invoke the VMSINSTAL procedure.
Enter the following command:
$ @SYS$UPDATE:VMSINSTAL DCPSpppnnn device-id [OPTIONS N]
You supply the following information:
- DCPSpppnnn is the save set name, with ppp designating the platform (AXP [Alpha] or VAX) and nnn designating the version (for example, 027 for V2.7).
- device-id is the name of the device on which you want to mount the media, such as DQA0:.
- OPTIONS N allows you to request release notes. If you do not include the OPTIONS N parameter, VMSINSTAL does not ask you about the release notes. Review the release notes before proceeding with the installation. If you are restarting the installation and have already reviewed the release notes, you do not need to specify OPTIONS N.
First, VMSINSTAL displays a banner line with the date and time, and instructions for running the dialog. You may receive one or more of the following warning messages when VMSINSTAL starts up. Exit from the procedure, correct the cause of the warning message, and start the VMSINSTAL procedure again.
- If you are not currently logged in to the SYSTEM account, the following message is displayed:
  %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account.
- If processes are running while VMSINSTAL is running, the following message is displayed:
  %VMSINSTAL-W-ACTIVE, The following processes are still active: process-name
Other processes may cause the installation of HELP to fail. When any of these messages are displayed, the following question is displayed to allow you to terminate VMSINSTAL and correct the situation:
* Do you want to continue anyway [NO]?
Enter YES to continue. If you answer NO, the VMSINSTAL procedure is terminated immediately.
You can enter a question mark (?) at this time to display advice from the VMSINSTAL software. For example:
The above conditions may cause VMSINSTAL to function improperly. In particular, problems may occur with file ownership if you are not logged into the SYSTEM account.

Ensure that existing software is saved.
VMSINSTAL then asks the following question:

* Are you satisfied with the backup of your system disk [YES]?

Enter YES to continue, or enter NO to exit VMSINSTAL to make a backup and run VMSINSTAL again.
If you enter a question mark (?) in response to this question, VMSINSTAL displays the following explanation:

VMSINSTAL attempts to ensure that a power failure or system crash will not corrupt your system disk. However, for absolute safety we recommend that you back it up before installing new products. Please see the documentation for more information on crashes during installation.

Confirm that distribution media is loaded.
VMSINSTAL asks for confirmation that the distribution media has been mounted.
Please mount the first volume of the set on device-id: * Are you ready?

Announce products to be installed.
VMSINSTAL then announces the products to be installed where ppp designates the platform and n.n designates the version.

The following products will be processed: DCPSppp Vn.n Beginning installation of DCPSppp Vn.n at 13:45 %VMSINSTAL-I-RESTORE, Restoring product saveset A

Obtain the release notes.
If you specified OPTIONS N in the VMSINSTAL command line, the following Release Notes options are displayed:

Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: Release Notes Options: (1) Display release notes (2) Print release notes (3) Both 1 and 2 (4) None of the above

After you enter the release note option, VMSINSTAL asks whether you want to continue the installation procedure:

Do you want to continue the installation [NO]?

If you did not include the OPTIONS N portion of the VMSINSTAL command line, VMSINSTAL does not display this question. Instead, the following message is displayed:

%VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP

Check for active DCPS queues.
If DCPS print queues are active while VMSINSTAL is running, messages similar to the following are displayed:

%DCPSVAX-W-QUEACTIVE, The following DCPS queues are still active: Queue Device Status ----- ------ ------ LN09 DAN::LTA9000: IDLE LN17 DAN::"AppleTalk/Dan's LN17+ps" IDLE LN40 DAN::"IP_RawTCP/ln40:6869" IDLE LPS32 DAN::"IP_CPAP/lps32.office.genicom.com" IDLE %DCPSVAX-I-NUMQUEUES, 4 existing DCPS queues, with 4 active Previously installed DCPS queues are still running. Continuing this installation without entering STOP/QUEUE/RESET for each such queue can cause inconsistent behavior among queues and can cause the IVP to fail. Note that if you choose to have this installation procedure automatically stop such queues, and the installation subsequently aborts, this procedure will not automatically restart them. * Do you want these queues automatically stopped and restarted [YES]?

If you do not want the installation procedure to automatically stop them, you are given the options of aborting the installation or continuing with the queues active. Continuing is not recommended.

Check for sufficient disk space.
VMSINSTAL checks to see if the amount of disk space required for the installation is available. If the space is not available, a message indicates the amount of disk space that is required, and the installation is aborted. You must allocate sufficient disk space and then start the VMSINSTAL procedure again. However, if you have already provided enough disk space, the installation procedure continues.

Purge extraneous versions of files.
VMSINSTAL asks if you want to purge any files that are being replaced.

* Do you want to purge files replaced by this installation [YES]?

Enter YES if you want to save disk space or NO if you think the files may still be of use.
If you enter a question mark (?) in response to this query, the following message is displayed:

During this installation, new files will be provided to replace existing versions. You may purge these older versions to save disk space, or keep them if you feel they may be of use. Purging is recommended.

Define DCPS$LAYUP.
Next, the installation procedure looks for a definition of the logical name DCPS$LAYUP in the system table in executive mode.
- If a definition exists, the following message is displayed:
  %DCPSppp-I-LAYUPDEF, DCPS$LAYUP is already defined -DCPSppp-I-LAYUPDEF, This installation will use its value
- If a definition does not exist, the procedure asks you for a definition. Press [Return] to select the default,
  SYS$SYSROOT:[SYSHLP.EXAMPLES.DCPS], or enter a directory specification where the system layup definition files should be stored.
  * Full definition for DCPS$LAYUP [SYS$SYSROOT:[SYSHLP.EXAMPLES.DCPS]]:
  The procedure will validate the definition you provide. If you do not accept the default location and the specified directory does not exist, the procedure will ask you if you want to create it:
  DISK$USER:[MY-LAYUP-DIR] does not exist. * Create it? [N]?
  If you answer NO, the procedure will ask again for a definition.

Create directories.
VMSINSTAL then attempts to create several directories. If they already exist, it displays additional messages indicating this:

%VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSTEST.DCPS]. %CREATE-I-EXISTS, VMI$ROOT:[SYSTEST.DCPS] already exists %VMSINSTAL-I-SYSDIR, This product creates system disk directory VMI$ROOT:[SYSHLP.EXAMPLES.DCPS]. %CREATE-I-EXISTS, VMI$ROOT:[SYSHLP.EXAMPLES.DCPS] already exists

Make sure the queue manager is running.
VMSINSTAL checks to see if the queue manager is running on your system.
If the queue manager is not present, the Installation Verification Procedure (IVP) does not run, and the following messages are displayed on your screen:
%DCPSppp-I-NOQUEMGR, System queue manager is not running -DCPSppp-I-NOQUEMGR, IVP will NOT run. Installation continuing ...
The queue manager must be running if you want the installation to run the IVP.
Stop queues.
At this point, VMSINSTAL displays the following message on your screen:
%DCPSppp-I-NOQUEST, No further questions will be asked.
VMSINSTAL stops active DCPS queues, if any and if desired.
%DCPSppp-I-STOPQUEUES, Stopping queues previously reported as active.
Restore the remaining save sets. As it restores each save set, VMSINSTAL reports on its progress:
VMSINSTAL-I-RESTORE, Restoring product saveset B ... VMSINSTAL-I-RESTORE, Restoring product saveset C ...
This operation may require up to 10 minutes to complete.
When all the save sets have been restored, VMSINSTAL instructs you to perform postinstallation procedures. Refer to the System Manager's GuideSystem Manager's Guide for full instructions.
Next, VMSINSTAL moves the files from the temporary locations used during installation to their permanent directories.
%VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...

Verify a successful software loading procedure.
The IVP verifies that the software was loaded properly. If the system queue manager is running, the IVP runs automatically and VMSINSTAL performs the following:

Creates a temporary print queue
Queues the test files in [SYSTEST.DCPS] to the temporary print queue DCPS$IVP_TEST
Displays messages similar to the following:

Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 43) started on DCPS$IVP_TEST %DCPS-I-JOBSTART, Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 43) started on DCPS$IVP_TEST Job DCPS$IVP_POST (queue DCPS$IVP_TEST, entry 43) completed Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 44) started on DCPS$IVP_TEST %DCPS-I-JOBSTART, Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 44) started on DCPS$IVP_TEST Job DCPS$IVP_ANSI (queue DCPS$IVP_TEST, entry 44) completed Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 45) started on DCPS$IVP_TEST %DCPS-I-JOBSTART, Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 45) started on DCPS$IVP_TEST Job DCPS$IVP_REGIS (queue DCPS$IVP_TEST, entry 45) completed Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 46) started on DCPS$IVP_TEST %DCPS-I-JOBSTART, Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 46) started on DCPS$IVP_TEST Job DCPS$IVP_TEK4014 (queue DCPS$IVP_TEST, entry 46) completed Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 47) started on DCPS$IVP_TEST %DCPS-I-JOBSTART, Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 47) started on DCPS$IVP_TEST Job DCPS$IVP_PCL (queue DCPS$IVP_TEST, entry 47) completed Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 48) started on DCPS$IVP_TEST %DCPS-I-JOBSTART, Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 48) started on DCPS$IVP_TEST Job DCPS$IVP_PROPRINTER (queue DCPS$IVP_TEST, entry 48) completed Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 49) started on DCPS$IVP_TEST %DCPS-I-JOBSTART, Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 49) started on DCPS$IVP_TEST Job DCPS$IVP_LIST (queue DCPS$IVP_TEST, entry 49) completed

Note

The IVP does not produce any hardcopy output.

The IVP procedure automatically deletes the temporary queue when the IVP completes. You can print the IVP test files to a real printer later. (Refer to the System Manager's GuideSystem Manager's Guide.)
You can also manually invoke the IVP after the installation by entering:

$ @SYS$TEST:DCPS$IVP

VMSINSTAL issues an informational message when the IVP is completed:

IVP successful for OpenVMS DECprint Supervisor Software

Restart queues.
VMSINSTAL restarts previously stopped queues if the installation is successful and issues its final messages:

%DCPSppp-I-STARTQUEUES, Restarting queues previously reported as active. Installation of DCPSppp Vn.n completed at 14:04 VMSINSTAL procedure done at 14:08 $

Where to go from here.
Refer to the System Manager's GuideSystem Manager's Guide for instructions on how to create print queues and customize your printing environment.

Contents

Index

HP DECprint Supervisor (DCPS) for OpenVMSSoftware Installation Guide