Previous | Contents |
Compaq recommends that you do a system disk backup before installing
any software. Use the backup procedures that are established at your
site. For details on performing a system disk backup, see the
Using VMS BACKUP manual.
1.6 Recovering from Installation Errors
Errors can occur during the installation if any of the following conditions exist:
For descriptions of error messages generated by these and related conditions, see the OpenVMS Alpha documentation on system messages and software installation or the online HELP/MESSAGE command. Take the appropriate action described in the message.
For information on system requirements for installing Compaq Fortran, see Section 1.2.
For a list of problems that can cause an unsuccessful installation, see Section 3.9.
To report a problem to Compaq, see Section 3.10.
This chapter describes:
Before you start the installation, read Chapter 1, which describes
the general options and requirements for installing Compaq Fortran.
After you complete installation, see Chapter 3.
2.1 Compaq Fortran Installation Instructions
The installation procedure loads Compaq Fortran product distribution files on to the system disk on the system where you perform the installation.
You must first install the Compaq Fortran Run-Time Library (RTL) before you install the Compaq Fortran compiler. |
Follow these steps to install Compaq Fortran from the OpenVMS Alpha Software Products Library CD-ROM set:
$ SET PROCESS/PRIVILEGE=(BYPASS,CMKRNL,SYSLCK,SYSPRV) |
$ SHOW PROCESS/PRIVILEGES |
$ SHOW DEVICE DKA400 |
DKA400 is the device name used in examples in this document to show where the appropriate media CD-ROM has been mounted. |
$ MOUNT DKA400 label |
$ DIRECTORY *.PCSI Directory DKA400:[dir.subdir] DEC-AXPVMS-FORRTL-Vnnnn-x-1.PCSI DEC-AXPVMS-FORTRAN-Vnnnn-x-1.PCSI Total of 2 files. |
$ PRODUCT EXTRACT RELEASE_NOTES FORTRAN /SOURCE=disk:[dir] - $_/FILE=FORTRAN.RELNOTES |
$ TYPE/PAGE FORTRAN.RELNOTES |
$ PRODUCT INSTALL FORRTL /SOURCE=disk:[dir] |
The following product has been selected: DEC AXPVMS FORRTL V7.x-x 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. DEC AXPVMS FORRTL V7.x-x: Compaq Fortran Run-Time Library Copyright 2002 Compaq Information Technologies Group, L.P. This software is produced by Compaq Computer Corporation This software is licensed under the OpenVMS product license Do you want the defaults for all options? [YES] [Return] Copyright 2002 Compaq Information Technologies Group, L.P. Compaq, the Compaq logo, Alpha and OpenVMS are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Ignore PSCI-I-RETAIN messages During installation of this product, you may see messages of the form: %PCSI-I-RETAIN, 'object' 'object-name' was not replaced because 'object' from kit does not have higher generation number These messages indicate that the Run-Time Library components on this kit are older than those already installed on your OpenVMS system. This is a normal situation and the messages can be ignored. You may also see these messages when installing a new version of OpenVMS. In this case, it indicates that the OpenVMS versions of the Run-Time Library components are older than those already on the system. This will occur with installations of OpenVMS 7.3 or earlier. These messages can be ignored also. Do you want to continue? [YES] [Return] Do you want to review the options? [NO] [Return] Execution phase starting ... The following product will be installed to destination: DEC AXPVMS FORRTL V7.x-x DISK$diskname:[VMS$COMMON.] Portion done: 0%...20%...30%...40%...50%...60%...70%...80%...90%...100% The following product has been installed: DEC AXPVMS FORRTL V7.x-x Layered Product %PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS FORRTL V7.x-x ... %PCSI-I-IVPSUCCESS, test procedure completed successfully DEC AXPVMS FORRTL V7.x-x: Compaq Fortran Run-Time Library Release notes are in SYS$HELP:FORRTL.RELEASE_NOTES |
$ PRODUCT SHOW PRODUCT FORTRAN90 |
PRODUCT ------- DEC AXPVMS FORTRAN90 Vn.n 1 item found |
PRODUCT ------- 0 items found |
$ PRODUCT REMOVE FORTRAN90 |
The following product has been selected: DEC AXPVMS FORTRAN90 V2.0 %PCSI-E-CONREMUNR, optionally remove product DEC AXPVMS FORRTL V2.0 that is no longer required by another product Do you want to take this action? [NO][Return] Do you want to continue? [YES][Return] The following product will be removed: DEC AXPVMS FORTRAN90 V2.0 %PCSI-I-VOLINFO, estimated space information for volume DISK$vvvvvvvv -PCSI-I-VOLSPC, -nnnnn required; nnnnnnn available; nnnnnnn net Portion done: 0%...50%...60%...70%...80%...100% The following product has been removed: DEC AXPVMS FORTRAN90 V2.0 |
$ PRODUCT INSTALL FORTRAN /SOURCE=disk:[dir] |
The following product has been selected: DEC AXPVMS FORTRAN V7.x-x 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. DEC AXPVMS FORTRAN V7.x-x: Compaq Fortran for OpenVMS Alpha Systems Copyright 2002 Compaq Information Technologies Group, L.P. This software product is sold by Compaq Computer Corporation PAKs used: FORTRAN or FORTRAN-USER Do you want the defaults for all options? [YES] [Return] Copyright 2002 Compaq Information Technologies Group, L.P. Compaq, the Compaq logo, Alpha and OpenVMS are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Do you want to review the options? [NO] [Return] Execution phase starting ... The following product will be installed to destination: DEC AXPVMS FORTRAN V7.x-x DISK$diskname:[VMS$COMMON.] Portion done: 0%...40%...70%...80%...90%...100% The following product has been installed: DEC AXPVMS FORTRAN V7.x-x Layered Product %PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS FORTRAN V7.x-x ... %PCSI-I-IVPSUCCESS, test procedure completed successfully DEC AXPVMS FORTRAN V7.x-x: Compaq Fortran for OpenVMS Alpha Systems Execute SYS$STARTUP:FORT$STARTUP.COM on all other VMScluster nodes Type HELP FORTRAN Release_notes for release notes location Install Compaq Extended Math Library (CXML) if desired If you wish to install the Compaq Extended Math Library, which contains advanced mathematics routines such as BLAS, FFT and vector operations, install the CXML kit from the media CD-ROM. See the Compaq Fortran Installation Guide for more details. Install DEBUG64 (ADB073) to enable 64-bit addressing support If your applications will be allocating and accessing data in 64-bit address space, be sure to install the DEBUG64 kit (ADB073) from the media CD-ROM. This provides enhanced debug and linker support. See the Compaq Fortran Installation Guide for more details. Insert the following lines in SYS$MANAGER:SYSTARTUP_VMS.COM: @SYS$STARTUP:FORT$STARTUP |
$ PRODUCT SHOW OBJECT /PRODUCT=(FORTRAN, FORRTL) |
To use other features of the PCSI utility, see the POLYCENTER Software Installation Utility User's Guide.
2.2 Installing Compaq Extended Math Library
The Compaq Extended Math Library (CXML), an optional component, is a
set of scientific subroutines optimized for Alpha systems, organized
into the following libraries:
Further details about CXML can be found at the Compaq Math Library Web site at http://www.compaq.com/math or in the CXML online documentation.
Before you install the Compaq Extended Math Library (CXML), be aware that the account and privileges requirements are the same as for Compaq Fortran. Unless you are installing CXML from the same account immediately after installing Compaq Fortran, please review steps 1 through 6 in Section 2.1 to ensure you have the necessary privileges, can locate the CXML installation files (in the same directory as the Fortran files), and can print out the CXML release notes before installation.
To install the Compaq Extended Math Library, type the following PRODUCT INSTALL command:
$ PRODUCT INSTALL CXML /SOURCE=disk:[dir] |
Where disk:[dir] is the specification of the disk and directory containing the product installation files.
The following text appears:
The following product has been selected: DEC AXPVMS CXML V3.xx-x Layered Product [Installed] 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. DEC AXPVMS CXML V3.xx-x: Compaq Extended Math Library for OpenVMS Alpha Systems Copyright 2002 Compaq Information Technologies Group, L.P. This software product is sold by Compaq Computer Corporation * This product does not have any configuration options. Copyright 2002 Compaq Information Technologies Group, L.P. Compaq, the Compaq logo, Alpha and OpenVMS are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Execution phase starting ... The following product will be installed to destination: DEC AXPVMS CXML V3.xx-x DISK$diskname:[VMS$COMMON.] Portion done: 0%...40%...90%...100% The following product has been installed: DEC AXPVMS CXML V3.xx-x Layered Product %PCSI-I-IVPEXECUTE, executing test procedure for DEC AXPVMS CXML V3.xx-x ... %PCSI-I-IVPSUCCESS, test procedure completed successfully DEC AXPVMS CXML V3.xx-x: Compaq Extended Math Library for OpenVMS Alpha Systems Release notes at SYS$HELP:CXML-V3xxx-RELEASE-NOTES.TXT. Insert the following lines in SYS$MANAGER:SYSTARTUP_VMS.COM: @SYS$STARTUP:cxml$startup $ |
Installation takes about 2-5 minutes (depending on your system). When installation has been completed, the DCL $ prompt reappears.
To obtain a list of files installed, type the following command:
$ PRODUCT SHOW OBJECT /PRODUCT=CXML |
If you will be using 64-bit address space data in your applications, you should install the enhanced 64-bit OpenVMS tools on your system, which include the OpenVMS Debugger (DEBUG64) and OpenVMS Linker (LINKER64).
If your system has OpenVMS Version 7.2 installed, and you want to use the ability to allocate static data (local variables and COMMON) in 64-bit address space, you must install the DEBUG64 (ADB073) kit as it provides a new linker, LINKER64, which supports this new feature.
OpenVMS Version 7.2 supports 64-bit allocation of static data, but does not provide LINKER64. OpenVMS versions prior to Version 7.2 do not support 64-bit allocation of static data.
If you have a version of OpenVMS later than Version 7.2, please check its release notes to see if DEBUG64 and LINKER64 functionality is already included. If the DEBUG64 kit is installed, LINKER64 is made the system default linker. It can be used as a general replacement for the OpenVMS-supplied linker.
DEBUG64 may be installed on OpenVMS Versions 6.2 and later. (Note that Compaq Fortran supports OpenVMS Version 7.1 and later.) The DEBUG64 kit is provided on your media CD-ROM in the same directory where the Fortran compiler kit files are located.
For more details on the capabilities of DEBUG64, see the release notes file ADB073.RELEASE_NOTES. You can view the release notes before installation (see below). After installation, the release notes are installed on the system in SYS$HELP:ADB073.RELEASE_NOTES.
Follow these steps to install DEBUG64:
$ SET PROCESS/PRIVILEGE=(BYPASS,CMKRNL,SYSLCK,SYSPRV) |
$ SHOW PROCESS/PRIVILEGES |
$ SHOW DEVICE DKA400 |
DKA400 is the device name used in examples in this document to show where the appropriate media CD-ROM has been mounted. |
$ MOUNT DKA400 label |
$ DIRECTORY ADB*.* Directory DKA400:[dir.subdir] ADB073.A ADB073.B ADB073.C ADB073.D Total of 3 files. |
$ @SYS$UPDATE:VMSINSTAL ADB073 disk:[dir] OPTIONS N |
Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: [Return] |
$ @sys$update:vmsinstal adb073 disk:[dir] |
OpenVMS AXP Software Product Installation Procedure V7.3 It is 18-DEC-2001 at 15:05. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]?[Return] The following products will be processed: ADB V7.3 Beginning installation of ADB V7.3 at 15:05 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. *********************************************************************** OpenVMS Alpha Debug V7.3 Copyright 2002 Compaq Information Technologies Group, L.P. Compaq, the Compaq logo, Alpha and OpenVMS are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. *********************************************************************** This kit installs Debug version V7.3. It will install on Alpha OpenVMS V6.2 to V7.3 systems. This kit requires an installed DCE for its client/server configurations (see release notes). If DCE is not installed, the "server" portion of the debugger cannot be linked and a warning is printed during the installation, for example, "%ADX-W-LINKABORT, NO DEBUGSRVSHR linked, SYS$LIBRARY:DCE$LIB_SHR missing (install DCE)". You can safely ignore this message. The normal operation of the debugger is not affected, however, the client/server mode will NOT be operational. If DECWindows Motif V1.2 is installed a new Heap Analyzer will be also installed on V7.1 or later systems. If your system is later upgraded from V6 to V7 or if DCE or MOTIF are later installed, then this kit MUST be rerun, i.e. the V7.3 debuggers MUST be reinstalled. On V7.1-2 and later systems this kit will also optionally install new process dump and process dump analysis tools: new process dump analysis DEBUG kernel, new SDA, and new IMGDMP (image dump). Old style process dumps are NOT compatible with this new style. New process dumps can be analyzed through the new kept debugger ANALYZE/PROCESS_DUMP/IMAGE_PATH command (enter it at the DBG> prompt). The DCL ANALYZE/PROCESS_DUMP command can also be used to invoke the debugger process dump analysis. You can aslo view new process dumps with the new SDA through the DCL ANALYZE/CRASH command. If you chose to install the new process dump and process dump analysis tools, then new System Code and System Dump Debuggers (SCD and SDD) ARE also installed. The debuggers and (optionally) process dump tools installed by this kit coexist with your regular system supplied ones, that is, it does NOT replace them. Procedures are included that will allow you to set up to these new tools or the regular system ones. However, the kit will replace any previous V7.3 versions that may be installed AND it will request to remove any earlier network kit debuggers, e.g. V72X. "%INSTALL-I-NONSHRADR, image installed ignoring '/SHARE=ADDRESS'... SYSTEM-F-NOPRIV, insufficient privilege or object protection violation" errors for TRACE and IMGDMP may occur during setup for the IVP. These errors can be safely ignored for the IVP (which does not actually test TRACE or IMGDMP). However, to correct TRACE and IMGDMP installation SYS$STARTUP:DEBUG$STARTUP_V73 must be run from a privileged account after vmsinstal completes. * Do you want to install the new process dump tools [YES]?[Return] This installation should take 15 minutes or less. * Do you want to run the IVP after the installation [YES]?)[Return] * Do you want to run the interactive DECwindows Motif IVP? [NO]?)[Return] * Do you want to purge files replaced by this installation [YES]?)[Return] * Do you want to remove obsolete versions of network debuggers (recommended) [YES]?)[Return] %ADB-I-DONEASK, No further questions will be asked during this installation. %VMSINSTAL-I-RESTORE, Restoring product save set B ... %VMSINSTAL-I-RESTORE, Restoring product save set C ... %VMSINSTAL-I-RESTORE, Restoring product save set D ... %ADB-I-ENDRESTORE, All Debugger savesets have been restored. %ADB-I-LINKING, Linking V7 images. %ADB-I-LINKDONE, DEBUGSHR has been linked. %ADB-I-LINKDONE, DEBUG has been linked. %ADB-I-LINKDONE, DEBUGUISHR has been linked. %ADB-I-LINKDONE, DEBUGSRVSHR has been linked. %ADB-I-LINKDONE, HA_MAIN has been linked. %ADB-I-LINKDONE, HA_KERNEL has been linked. %ADB-I-LINKDONE, TRACE has been linked. %ANALYZE-I-ERRORS, VMI$ROOT:[SYS$LDR]SYS$BASE_IMAGE.EXE;1 0 errors %ADB-I-LINKDONE, SDA has been linked. %ADB-I-LINKDONE, IMGDMP, IMGDMP_RIGHTS, and PRGDEVMSG have been linked. %ADB-I-LINKDONE, Process dump DEBUG kernel has been linked. %ADB-I-LINKDONE, System dump DEBUG kernel has been linked. %ADB-I-LINKDONE, System code DEBUG kernel has been linked. %ADB-I-CLEANUP, Cleanup has been performed. %ADB-I-PROHELP, Providing Debugger Help files... %ADB-I-PROMSG, Providing Debugger message image... %ADB-I-PROMSG, Providing Debugger .CLD file... %ADB-I-PROEXE, Providing Debugger files... %ADB-I-PROEXE, Providing Heap Analyzer files... %ADB-I-PROEXE, Providing new process dump tools... %ADB-I-UNINSTALL, Uninstalling obsolete network kit debuggers OpenVMS Debugger Uninstall Procedure Copyright 2002 Compaq Information Technologies Group, L.P. OpenVMS Debugger Uninstall Procedure Copyright 2002 Compaq Information Technologies Group, L.P. OpenVMS Debugger Uninstall Procedure Copyright 2002 Compaq Information Technologies Group, L.P. OpenVMS Debugger Uninstall Procedure Copyright 2002 Compaq Information Technologies Group, L.P. %ADB-I-PROMSG, Providing startup files ... If you want the debuggers installed by this kit to be the default system debuggers: - Add the following line to the system startup procedure: $ @SYS$STARTUP:DEBUG$STARTUP_V73.COM V73 You should remove any other *DEBUG$STARTUP*.COM reference. - Enter the following DCL command from a privileged account on each and every Alpha node of your VMScluster that you wish to upgrade: @SYS$STARTUP:DEBUG$STARTUP_V73.COM V73 Note that this is a /SYSTEM table setup (also see SYS$STARTUP:DEBUGSETUP.COM) and modifies your DCL command tables. The DCL DEBUG /CLIENT and /SERVER switches on pre V7.2 systems may not be seen and the /KEPT invocation may not be redirected for active processes (until they are logged-off and restarted). If you want the regular system supplied debuggers (and process dump tools) to be the default, then do the same as above but use "VMS" as the input parameter, for example: @SYS$STARTUP:DEBUG$STARTUP_V73.COM VMS Users can also individually and dynamically switch debuggers (and process dump tools) by using SYS$STARTUP:DEBUGSETUP.COM. It's input options are VMS, V73, or UNSET. It also needs the logical table /JOB or /SYSTEM switch. For example: @SYS$STARTUP:DEBUGSETUP.COM V73 /JOB %ADB-I-PROIVP, Providing test files for IVP... The Debugger IVP has been moved to the SYS$TEST directory. To run the IVP after installation, first make sure you are setup to use the V73 debugger, e.g. execute the command "@SYS$STARTUP:DEBUGSETUP V73 /JOB" Then, run the character cell IVP by executing the command "@SYS$TEST:DBG$IVP.COM" or, if DECWindows Motif has been installed on your system, run the interactive DECWindows Motif IVP by executing the command "@SYS$TEST:DBG$DW$IVP.COM" %ADB-I-INSTALLDONE, OpenVMS Alpha Debug V7.3 installation done %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... OpenVMS Debugger Startup Procedure Copyright 2002 Compaq Information Technologies Group, L.P. OpenVMS Debugger Setup Procedure Copyright 2002 Compaq Information Technologies Group, L.P. OpenVMS Debugger Setup Procedure Copyright 2002 Compaq Information Technologies Group, L.P. Beginning the Debug V7.3 Verification Procedure Copyright 2002 Compaq Information Technologies Group, L.P. Compaq, the Compaq logo, Alpha and OpenVMS are trademarks of Compaq Information Technologies Group, L.P. in the U.S. and/or other countries. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. Debug verification procedure successful. Installation of ADB V7.3 completed at 15:08 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]ADB073.VMI_DATA VMSINSTAL procedure done at 15:08) |
Previous | Next | Contents |