DEC_C++_____________________________________________ Installation Guide for DIGITAL UNIX Systems Order Number: AA-PX2DE-TE June 1997 This guide describes how to install DEC C++ on an Alpha system running the DIGITAL UNIX operating system. Revision/Update Information: This is a revised guide. Operating System & Version: DIGITAL UNIX Version 3.2 or higher. Future maintenance releases may require higher versions. Software Version: DEC C++ Version 5.6 Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ First Printing, March 1993 Revised, August 1993 Revised, May 1994 Revised, May 1995 Revised, March 1996 Revised, June 1997 Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. © Digital Equipment Corporation 1993, 1994, 1995, 1996, 1997. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: Bookreader, DEC, DEC FUSE, DECwindows, DIGITAL, Ladebug, ULTRIX, VAX DOCUMENT, the DEC C++ logo, and the DIGITAL logo. The following are third-party trademarks: AT&T is a registered trademark of American Telephone and Telegraph Company. Motif and OSF/1 are registered trademarks of the Open Software Foundation, Incorporated. PostScript is a registered trademark of Adobe Systems, Incorporated. X Window System is a trademark of the Massachusetts Institute of Technology. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company, Ltd. ZK6400 This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. _______________________________________________________________ Contents ................................................... vii Preparing for DEC C++ Installation 1.1 Reading the Online Release Notes.............. 1-1 1.2 Registering Your Software License............. 1-1 1.3 Checking the Software Distribution Kit........ 1-2 1.4 Checking Installation Procedure Requirements.................................. 1-3 1.4.1 Checking Login Privileges................. 1-3 1.4.2 Checking Hardware Requirements............ 1-3 1.4.3 Checking Software Requirements............ 1-3 1.5 Determining Which Documentation Subsets to Load.......................................... 1-5 1.6 Installing from Media or Using the Remote Installation Service.......................... 1-6 1.7 Backing Up Your System Disk................... 1-6 1.8 Stopping the Installation..................... 1-7 1.9 Checking Current Disk Space................... 1-7 1.10 Increasing Disk Space by Using Alternative Disks ........................................ 1-8 Preparing for DEC C++ Installation on DIGITAL UNIX Version 3.n Systems 2.1 Important Compatibility Information........... 2-1 2.2 Deleting Old Subsets.......................... 2-1 2.3 Determining Which Subsets to Load............. 2-2 iii Preparing for DEC C++ Installation on DIGITAL UNIX Version 4.0 Systems 3.1 Deleting Old Subsets.......................... 3-1 3.2 Determining Which Subsets to Load............. 3-2 Installing DEC C++ 4.1 Using CD-ROM Software Product Library Media... 4-1 4.2 Using a Remote Installation Service Distribution Area............................. 4-2 4.3 Responding to Installation Procedure Prompts....................................... 4-2 4.3.1 Selecting Subsets......................... 4-2 4.3.2 Monitoring Displays During the Subset Loading Process........................... 4-3 After Installation 5.1 Running the Installation Verification Procedure .................................... 5-1 5.2 Deleting DEC C++ from Your System............. 5-1 5.3 Displaying Documentation from CD-ROM.......... 5-2 Sample Listings A.1 Sample DEC C++ Installation on a DIGITAL UNIX Version 3.n System............................ A-1 A.2 Sample Installation Verification Procedure on a DIGITAL UNIX Version 3.n System............. A-5 A.3 Sample DEC C++ Installation on a DIGITAL UNIX Version 4.0 System............................ A-6 A.4 Sample Installation Verification Procedure on a DIGITAL UNIX Version 4.0 System............. A-9 Recovering from Errors B.1 Failures During Product Installation ......... B-1 B.2 Failures During Product Use................... B-2 Tables 1 Conventions Used in This Guide............ ix v _________________________________________________________________ Preface This installation procedure creates DEC C++ file systems subordinate to the /usr/lib, /usr/bin, and /usr/man directories. Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall DEC C++ for any other reason. Intended Audience This guide is intended for system managers who install DEC C++. Associated Documentation In addition to this guide, the DEC C++ documentation set includes the following: o Using DEC C++ for DIGITAL UNIX Systems Describes the specifics of the DIGITAL C++ implementation for DIGITAL UNIX systems. o DEC C++ Class Library Reference Manual Describes the class library packages supplied by DIGITAL with DEC C++. o DEC C++ command reference pages for DIGITAL UNIX systems (cxx(1)) Provides reference information for DEC C++ commands and libraries. o Stroustrup, Bjarne, The C++ Programming Language, 2nd Edition. Reading, Massachusetts: Addison-Wesley, 1992. vii Provides an exhaustive introduction to the C++ programming language, including sophisticated language features. This book also includes the text but not the annotations of The Annotated C++ Reference Manual. o Musser, David R. and Atul Saini, STL Tutorial and Reference Guide. Reading, Massachusetts: Addison-Wesley, 1996. Describes how to use the Standard Templates Library (STL). The following related documents are not included in the DEC C++ documentation set. Please refer to these documents if you need additional information about DIGITAL UNIX installation or system management, or the Ladebug debugger. o Guide to the Ladebug Debugger Describes how to use the Ladebug debugger. o DIGITAL UNIX Guide to Installing DIGITAL UNIX Explains how to install the DIGITAL UNIX operating system. o DIGITAL UNIX User's Guide Explains how to perform basic system administration tasks on DIGITAL UNIX operating systems, including the instructions on how to do system backups. o DIGITAL UNIX Guide to Sharing Software on a Local Area Network Explains how to use the remote installation service (RIS) utility and environment. o Guide to Software License Management Explains how to use the license management facility (LMF) utility in registering your license for DEC C++. viii Conventions Table 1 describes the conventions used in this guide. Table_1_Conventions_Used_in_This_Guide_____________________ Convention_____Meaning_____________________________________ # A number sign (#) is the default superuser prompt. % A percent sign (%) is the default user prompt. In examples, a boxed symbol indicates that you must press the named key on the keyboard. Ctrl/C This symbol indicates that you must press the Ctrl key while you simultaneously press another key (in this case, C). user input In interactive examples, this typeface indicates input entered by the user. filesystem In text, this typeface indicates the exact name of a command, routine, partition, path name, directory, or file. This typeface is also used in interactive examples and other screen displays. UPPERCASE The DIGITAL UNIX operating system lowercase differentiates between lowercase and uppercase characters. Examples, syntax descriptions, function definitions, and literal strings that appear in text must be typed exactly as shown. (continued on next page) ix Table_1_(Cont.)_Conventions_Used_in_This_Guide_____________ Convention_____Meaning_____________________________________ setld(8) Cross-references to online reference pages include the appropriate section number in parentheses. For example, setld(8) indicates that you can find the material on the setld command in Section 8 of the reference pages. [y] In a prompt, square brackets indicate that the enclosed item is the default response. For example, [y] means the default response _______________is_Yes._____________________________________ x 1 _________________________________________________________________ Preparing for DEC C++ Installation Your distribution kit includes a letter titled Read Before Installing DEC C++ for DIGITAL UNIX Systems. This letter discusses important information that might not be included in this guide. You should read this letter now. 1.1 Reading the Online Release Notes DEC C++ provides both online and hardcopy release notes. DIGITAL strongly recommends that you read the release notes before using the product. The release notes may contain information about changes to the application. The release notes for DEC C++ are in subset CXXBASEnnn, where nnn is a number representing the latest release of DEC C++. For the number of latest subsets, see the Read Before Installing letter. This letter and the release notes are both included on the Media CD-ROM in the following directory: /cxxnnn/documentation Installing subset CXXBASEnnn moves the release notes to the following directory location: /usr/lib/cmplrs/cxx/DECCXXnnn.release-notes For information about installing these release notes before installing DEC C++, see Section 4.3.1. 1.2 Registering Your Software License DEC C++ includes support for the License Management Facility (LMF). You must register your License Product Authorization Key (License PAK) in the License Database (LDB) to use DEC C++ on a newly licensed node. The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order. Preparing for DEC C++ Installation 1-1 If you are installing DEC C++ as an update on a node already licensed for this software, you have already completed the License PAK registration requirements. If you are installing prerequisite or optional software along with DEC C++, review the PAK status and install the PAKs for any prerequisite or optional software before you install DEC C++. To register a license under the DIGITAL UNIX operating system, first log in as superuser. At the superuser prompt, edit an empty PAK template with the lmf register command as follows, and include all the information on your License PAK: # lmf register After you register your license, use the following lmf reset command to copy the license details from the LDB to the kernel cache: # lmf reset For complete information on using the LMF, see the Guide to Software License Management and the lmf(8) reference page. 1.3 Checking the Software Distribution Kit Use the Bill of Materials (BOM) to check the contents of your DEC C++ software distribution kit. In addition to this guide, the software distribution kit includes the following: o A CD-ROM optical disk for systems with optical disk drives o A CD-ROM booklet and CD-ROM read first letter If your software distribution kit is damaged or incomplete, contact your DIGITAL representative. 1-2 Preparing for DEC C++ Installation 1.4 Checking Installation Procedure Requirements This section discusses various requirements for installing DEC C++. Installing DEC C++, including running the Installation Verification Procedure (IVP), takes approximately 5 to 10 minutes, depending on your type of media and system configuration. 1.4.1 Checking Login Privileges You must have superuser privileges to install the DEC C++ software and to register the license PAK. 1.4.2 Checking Hardware Requirements To install DEC C++, you need the following hardware: o Software distribution device (if installing from media) Locate the CD-ROM drive for the CD-ROM software distribution media. The CD-ROM booklet or the documentation for the CD-ROM drive you are using explains how to load the CD-ROM media. o Terminal You can use either a hardcopy or video terminal to communicate with the operating system and respond to prompts from the installation procedure. For additional hardware requirements, see the DEC C++ Software Product Description (SPD) contained on the Media CD-ROM. 1.4.3 Checking Software Requirements DEC C++ Version 5.6 requires the DIGITAL UNIX operating system Version 3.2 or higher. Future DEC C++ releases may require higher versions. See the Read Before Installing letter (included on the CD-ROM) or the online release notes for information about the required minimum version of the operating system. DEC C++ requires that the following DIGITAL UNIX software subsets be loaded on the system where you install DEC C++ (nnn is the number representing the latest release): o OSFBASEnnn-the "Base System" subset Preparing for DEC C++ Installation 1-3 o OSFPGMRnnn-the "Software Development Environment" subset o OSFCMPLRSnnn-the "Compiler Back End" subset On DIGITAL UNIX Version 4.0 systems, the following subset is required to use DEC C++: o OSFINCLUDEnnn-the system include files subset On DIGITAL UNIX Version 4.0 systems, the following DEC C++ Class Library subset is optional: o CXLLIBAnnn-the archived class library subset To install the DEC C++ reference pages (manual pages), the following DIGITAL UNIX software subset must be installed on the system where you install DEC C++ : o OSFDCMTnnn-the "Documentation for Reference Pages" subset To install X Motif header files for DIGITAL UNIX software, the following DIGITAL UNIX software subset must be installed on the system where you install DEC C++ : o OSFXDEVnnn-the "X Window Software Development" subset To check whether these subsets are loaded: 1. Log in to the system where you will install DEC C++. 2. Enter the following command: # setld -i | grep -E 'OSFBASE|OSFPGMR|OSFCMPLRS|OSFDCMT|OSFXDEV' If you do not log in as superuser (login name root), you must enter the full path of the command. For example: # /usr/sbin/setld -i | grep -E 'OSFBASE|OSFPGMR|OSFCMPLRS|OSFDCMT|OSFXDEV' On DIGITAL UNIX Version 4.0 systems, you should also specify OSFINCLUDE to check that the system include files subset is loaded. Check the displayed rows for the name of the relevant subset and any related patches. The word "installed" appears in a row after the subset identifier when a subset is loaded. If the word "installed" does not appear (the second column in a row is blank), the subset or patch is not loaded. In this case, you must load the missing DIGITAL UNIX software before installing DEC C++. (For information 1-4 Preparing for DEC C++ Installation on how to load the operating system software, see the Guide to Installing DIGITAL UNIX.) 1.5 Determining Which Documentation Subsets to Load You can load the following documentation subset when you install DEC C++: o DEC C++ Reference Pages (CXXMANnnn) If users on the system where DEC C++ is being installed use reference pages that are nfs mounted from another system, load the DEC C++ reference pages onto the other system rather than the one where you are currently installing DEC C++. In this case, do not request the reference page subset during this installation of DEC C++. You can log in to the system where the DIGITAL UNIX reference pages are installed and load the DEC C++ reference pages there after the current installation is complete. The reference pages for the CXXOLDnnn subset are included in that subset. Preparing for DEC C++ Installation 1-5 o DEC C++ HTML documentation (CXXHTML560) HTML files are provided for the release notes and some of the product manuals for use with a web browser. These files are installed by selecting the following subset: DEC C++ HTML documentation To view this documentation, open the following file using your web browser: /usr/share/doclib/cplusplus/cxx.html 1.6 Installing from Media or Using the Remote Installation Service Someone from your site must perform at least one DEC C++ installation from the distribution medium. Your site system manager can then decide whether or not to make a DEC C++ distribution kit available on line so that subsequent installations of DEC C++ can use the Remote Installation Service (RIS). For information on extracting DEC C++ subsets to a RIS distribution area, see the Guide to Sharing Software on a Local Area Network. If you expect to use DEC C++ subsets from the RIS area of a remote system for installation on your local system, first check with your site system manager to ensure that: o A DEC C++ network kit is available for use. o Your system is registered as a RIS client. If DEC C++ subsets are available to you on a RIS server system, you must know the name of that system. For more information on installing DEC C++ from a RIS distribution area, see Section 4.2. 1.7 Backing Up Your System Disk DIGITAL recommends that you back up your system disk before installing any software. For information about backing up your system disk, see the DIGITAL UNIX system documentation. 1-6 Preparing for DEC C++ Installation 1.8 Stopping the Installation To stop the installation procedure at any time, press Ctrl /C. You must then delete files created up to this point interactively. To get a list of the directories and files created during the DEC C++ installation, use the following command: # /usr/sbin/setld -i subsetname In this command, subsetname is the name of the DEC C++ subset that you have chosen to install. 1.9 Checking Current Disk Space To check the current amount of free space for a directory path, log in to the system where you will install DEC C++. You can check which directories are mounted and where they are by viewing the /etc/fstab file. For example: # more /etc/fstab /dev/rd0a:/:rw:1:1:ufs:: /dev/rd0g:/usr:rw:1:2:ufs:: /usr/staff/r1/leslie@bigsys:/usr/staff/r1/leslie:rw:0:0:nfs:bg: /usr/man@bigsys:/usr/man:ro:0:0:nfs:bg: The display indicates that /usr (mounted to /dev/rd0g) is the only mount point that affects where DEC C++ files will reside; the system has only one local disk drive, and the /usr/lib and file system reside in the g partition of the disk on that drive. To check the total space and the free space for the directories where DEC C++ will reside, enter the df command. Given the previous display of the /etc/fstab file, which shows that only /usr is a mount point, you need to check free space only in the /usr file system. For example: # df /usr Filesystem Total kbytes kbytes % node kbytes used free used Mounted on /dev/rd0g 122598 54447 55892 49% /usr This display shows that there are 55,892 Kbytes free. For space requirements to install this product, see the Software Product Description for DEC C++ Version 5.6 for DIGITAL UNIX Systems. Preparing for DEC C++ Installation 1-7 On systems where /usr/lib and /usr/man are mounted to different devices from /usr, enter the following command: # df /usr/lib /usr/man In this case, you compare space required for DEC C++ files in /usr/lib to the free space displayed in the first line of the df output list, and compare the space required for DEC C++ files in /usr/man to the free space displayed in the second line of that list. 1.10 Increasing Disk Space by Using Alternative Disks The DEC C++ installation procedure creates the following directories and loads files into subordinate directories: /usr/include/cxx /usr/lib/cmplrs/cxx If the /usr/lib/cmplrs and /usr/include directory nodes in the previous paths do not exist, the installation procedure creates and uses them. If you find that there is insufficient disk space for the DEC C++ subsets and you know that you have additional space on alternative disks or disk partitions for your system, perform the following steps before installing DEC C++: 1. Log in as superuser. 2. Create the directory /usr/lib/cmplrs. 3. Specify in the /etc/fstab file that one or more of the newly created directories are mount points to new disk partitions where there is additional space. 4. Enter the mount -a command so that the new mount points take effect. 1-8 Preparing for DEC C++ Installation 2 _________________________________________________________________ Preparing for DEC C++ Installation on DIGITAL UNIX Version 3.n Systems This chapter describes the special requirements necessary to successfully install DEC C++ on DIGITAL UNIX Version 3.n Systems. For special requirements pertaining to DIGITAL UNIX Version 4.0 systems, see Chapter 3. 2.1 Important Compatibility Information If you compile with DEC C++ Version 5.6 and link on DIGITAL UNIX Version 3.n systems, you need to take special actions if you want to be able to execute C++ programs on other DIGITAL UNIX Version 3.n systems. Please read the section on Important Compatibility Information in the release notes for DEC C++ Version 5.6 before installing this release. The release notes are contained in the following directory on the Media CD-ROM: /cxx560/documentation 2.2 Deleting Old Subsets Before you can install any of the DEC C++ subsets, you should delete all old subsets, except as noted in this section. To delete subsets, take the following steps: 1. Log in as superuser (login name root). 2. Using the setld -i command, check for the presence of the debugger subsets, LDBBASEnnn and LDBGUInnn. For example: # /usr/sbin/setld -i | grep LDB | grep installed for DEC C++ Installation on DIGITAL UNIX Version 3.n Systems 2-1 If either Version 2.1 or Version 2.1A of DEC FUSE is installed on your system, be sure to read the Important Compatibility Information section in the release notes referenced in Section 2.1 before proceeding to delete or install LDBBASEnnn and LDBGUInnn. Delete debugger subsets only if nnn is not 439 or a higher number. For example: # /usr/sbin/setld -d LDBBASE320 LDBGUI320 3. Using the setld -i command, check for the presence of CXXnnn subsets installed on your system. For example: # /usr/sbin/setld -i | grep CXX | grep installed 4. To delete the old CXX subsets found, enter the setld -d command. For example: # /usr/sbin/setld -d CXXBASEA530 All old CXX subsets that exist on your system must be deleted, with the following possible exceptions: o If CXXSHRDAnnn is installed on your system, delete it and install it from the current kit only if nnn is not 307 or a higher number. If nnn is 307 or a higher number, do not delete this subset and do not install it. o If you want to continue to use ild and oldc89, keep CXXOLDAnnn. See the release notes for more information. 2.3 Determining Which Subsets to Load When you invoke the installation procedure, you will be given choices of which DEC C++ subsets to load. The following subsets are required to use DEC C++ (nnn is a number representing the latest release; see the Read Before Installing letter for details): CXXBASEnnn DEC C++ (cxx) for DIGITAL UNIX CXXV3HDRnnn DEC C++ header files for DIGITAL UNIX Version3.n 2-2 Preparing for DEC C++ Installation on DIGITAL UNIX Version 3.n Systems CXXLIBnnn DEC C++ static class libraries (required for users who link their programs nonshared) The following subsets are conditionally required to use DEC C++: CXXSHRDAnnn DEC C++ Class Library, Run-Time support LDBBASEV32nnn Ladebug debugger LDBDOCV32nnn Ladebug release notes LDBGUIV32nnn Ladebug debugger window interface If you deleted any of these conditionally required subsets (because they were old, see Section 2.2), you should install the latest versions from the current kit. The Ladebug debugger shipped with this kit is Version 4.0- 39. If a more recent version (for example, Version 4.0-40 or higher) is already installed on your system, do not install the debugger from this kit. See the release notes for more information on installing the Ladebug debugger. The following online documentation subsets are optional: CXXMANnnn DEC C++ and class library manual pages CXXHTMLnnn DEC C++ HTML documentation for DEC C++ Installation on DIGITAL UNIX Version 3.n Systems 2-3 3 _________________________________________________________________ Preparing for DEC C++ Installation on DIGITAL UNIX Version 4.0 Systems This chapter describes the special requirements necessary to successfully install DEC C++ on DIGITAL UNIX Version 4.0 and higher systems. For special requirements pertaining to DIGITAL UNIX Version 3.n systems, see Chapter 2. 3.1 Deleting Old Subsets Before you can install any of the DEC C++ subsets, you should delete all old subsets, except as noted in this section. To delete subsets, take the following steps: 1. Using the setld -i command, list the subsets installed on your system and check for the presence of any subset. For example: # /usr/sbin/setld -i | grep CXX | grep installed 2. Using the setld -i command, check for the presence of the debugger subsets, LDBBASEnnn and LDBGUInnn. For example: # /usr/sbin/setld -i | grep LDB | grep installed Delete debugger subsets only if nnn is not 439 or a higher number. For example: # /usr/sbin/setld -d LDBBASE415 LDBGUI415 3. Log in as superuser (login name root). 4. To delete all of the old CXX subsets found, enter the setld -d command. For example: # /usr/sbin/setld -d CXXBASEA530 for DEC C++ Installation on DIGITAL UNIX Version 4.0 Systems 3-1 All of the subsets that exist are old versions and, except for the CXXOLDAnnn subset, must be deleted. If you want to continue to use ild and oldc89, keep the CXXOLDAnnn subset. See the release notes for more information. 3.2 Determining Which Subsets to Load When you invoke the installation procedure you will be given choices of which DEC C++ subsets to load. The following subsets are required to use DEC C++ (nnn is a number representing the latest release; see the Read Before Installing letter for details): CXXBASEnnn DEC C++ (cxx) for DIGITAL UNIX CXXV4HDRnnn DEC C++ header files for DIGITAL UNIX Version 4.0 or higher Do not install the following subset on a DIGITAL UNIX Version 4.0 or higher system, even if the subset appears on the menu when you run setld: CXXSHRDAnnn DEC C++ Class Library, Run-Time support The following subsets are conditionally required to use DEC C++: LDBBASEV40nnn Ladebug debugger LDBDOCV40nnn Ladebug release notes LDBGUIV40nnn Ladebug debugger window interface If you deleted any of these conditionally required subsets (because they were old, see Section 3.1), you should install the latest versions from the current kit. The following online documentation subsets are optional: CXXMANnnn DEC C++ and class library manual pages CXXHTMLnnn DEC C++ HTML documentation 3-2 Preparing for DEC C++ Installation on DIGITAL UNIX Version 4.0 Systems 4 _________________________________________________________________ Installing DEC C++ This chapter describes how to install DEC C++. Before you start the installation, read Chapter 1. You can install DEC C++ locally (using CD-ROM media) or from a server area. You can usually complete an installation in about 5 minutes. If you encounter any failures during installation, see Appendix B. 4.1 Using CD-ROM Software Product Library Media This procedure loads DEC C++ files on to a disk belonging to the system where you perform the installation. When DEC C++ is run, its executable images are mapped into memory on your system. Follow these steps to install DEC C++ from CD-ROM media: 1. Mount the media on the appropriate disk drive. 2. Log in as superuser (login name root) to the system where you will install DEC C++. 3. Specify the /cdrom directory to be the mount point for the distribution file system on the drive. If your drive is ral, enter the following command: # mount -dr /dev/ralc /cdrom 4. Enter a setld command that requests the load function (-l) and identifies the directory in the mounted file system where DEC C++ subsets are located. For example, if the directory location for these subsets is /cdrom/cxxnnn/kit, enter the following command: # /usr/sbin/setld -l /cdrom/cxxnnn/kit Installing DEC C++ 4-1 The installation procedure now displays the names of DEC C++ subsets and asks you to specify the subsets you want to load. See Section 4.3 to continue the installation. 4.2 Using a Remote Installation Service Distribution Area If you are installing DEC C++ subsets that reside in a /etc /ris Remote Installation Service (RIS) distribution area on a remote system, follow these steps: 1. Log in as superuser (login name root) to the system where you will install DEC C++. 2. Enter a setld command that requests the load function (-l option) and identifies the system where the DEC C++ subsets are located. For example, if you are loading DEC C++ subsets from a RIS distribution area, enter the following: # setld -l node: Replace node: with the node name where the DEC C++ subsets are located. RIS now displays a menu that lists all the software subsets available to you and asks you to specify the subsets you want to load. See Section 4.3 to continue the installation. 4.3 Responding to Installation Procedure Prompts This section explains the installation procedure prompts and displays. 4.3.1 Selecting Subsets You must specify which DEC C++ subsets you want to load by choosing them from a menu or list of subset section options. The number and kinds of subset options you have will vary depending on the version of DIGITAL UNIX you are using. If you have a DIGITAL UNIX Version 3.n system, see Section 2.3 for more information. If your system is DIGITAL UNIX Version 4.0 or higher, see Section 3.2. 4-2 Installing DEC C++ ________________________ Note ________________________ If you are installing from a RIS distribution area, the number of subsets can vary depending on what products are available in the RIS area and how many subsets they have. ______________________________________________________ If you specify more than one number at the Choices prompt, separate each number with a space, not a comma. The installation script (see Appendix A) lets you verify your choice. If you enter a number or numbers in response to the Choices prompt, you will see a display of your choices, preceded by the following: You are installing the following optional subsets: You will then be prompted to verify your choice, as follows: Is this correct? (y/n): If the displayed subsets are not the ones you intended to choose, enter n. In this case, the subset selection menu is again displayed and you can correct your choice of optional subsets. If the displayed subsets are the ones you want to load, enter y. 4.3.2 Monitoring Displays During the Subset Loading Process The installation procedure loads and verifies the selected DEC C++ subsets. When you see the "Verifying" message during the subset installation, the installation procedure is checking to see that the files are copied correctly; it is not an Installation Verification Procedure (IVP) message. During the installation, if you get errors from the setld utility, see the DIAGNOSTICS section of the setld(8) reference page for an explanation of the errors and the appropriate actions to take. Chapter 5 explains how to run the Installation Verification Procedure (IVP) after installation, and how to delete old DEC C++ subsets before installing a new version of DEC C++. Installing DEC C++ 4-3 5 _________________________________________________________________ After Installation This chapter explains what you need to do after the installation to make DEC C++ ready for use. 5.1 Running the Installation Verification Procedure After installing DEC C++, you can run the Installation Verification Procedure (IVP) independently to verify that the software is available on your system. You might also want to run the IVP after a system failure to be sure that users can still access DEC C++. To run the IVP after an installation, enter the following command: # setld -v subsetname In this command, subsetname can be any DEC C++ subset. For a sample DEC C++ IVP, see Appendix A. If the verification process fails, look in the /var/adm /smlogs/fverify.log file for information to help diagnose the problem. 5.2 Deleting DEC C++ from Your System If you must remove a version of DEC C++ from your system, delete each subset that you previously installed. To delete subsets: 1. Log in as superuser (login name root). 2. Enter the following form of the setld command: # /usr/sbin/setld -i | grep -E 'CXX|C89' | grep installed 3. Look for the word "installed" in the listing produced, and then delete the installed subsets. For example: # setld -d subsetnamennn subsetnamennn After Installation 5-1 5.3 Displaying Documentation from CD-ROM The DEC C++ documentation is provided on the DIGITAL UNIX Online Documentation Library CD-ROM in Bookreader (.decw_book) file format. You can display the Bookreader files on your workstation using the DECwindows Bookreader application. For information on accessing and displaying these files, see the Online Documentation Library CD-ROM User's Guide. 5-2 After Installation A _________________________________________________________________ Sample Listings This appendix provides sample listings for the following procedures: o An installation of DEC C++ on DIGITAL UNIX Version 3.n using disk media o An Installation Verification Procedure (IVP) on DIGITAL UNIX Version 3.n o An installation of DEC C++ on DIGITAL UNIX Version 4.0 using disk media o An Installation Verification Procedure (IVP) on DIGITAL UNIX Version 4.0 A.1 Sample DEC C++ Installation on a DIGITAL UNIX Version 3.n System The following listing shows a basic installation of DEC C++ on a DIGITAL UNIX Version 3.2 system using CD-ROM media. For the directory variable, you must supply a disk path name or the directory location posted with the CD-ROM media. # setld -l directory The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. Sample Listings A-1 1) DEC C++ (cxx) for Digital UNIX 2) DEC C++ Class Library, Run-Time Support 3) DEC C++ HTML documentation 4) DEC C++ and class library manual pages 5) DEC C++ header files for Digital UNIX V3.x 6) DEC C++ static class libraries 7) Ladebug Debugger Version 4.0-39 Release Notes 8) Ladebug Debugger Version 4.0-39 9) Ladebug Debugger graphical user interface Or you may choose one of the following options: 10) ALL of the above 11) CANCEL selections and redisplay menus 12) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 10 You are installing the following optional subsets: DEC C++ (cxx) for Digital UNIX DEC C++ Class Library, Run-Time Support DEC C++ HTML documentation DEC C++ and class library manual pages DEC C++ header files for Digital UNIX V3.x DEC C++ static class libraries Ladebug Debugger Version 4.0-39 Release Notes Ladebug Debugger Version 4.0-39 Ladebug Debugger graphical user interface Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. Warning: This release of the Ladebug debugger requires the DEC C++ shared libraries to be installed on the system. Please be sure to install the subset CXXSHRDA305, or a higher version, after completing this installation. Ladebug Debugger Version 4.0-39 Copying from CXX560.kit (disk) Verifying A-2 Sample Listings Ladebug Debugger Version 4.0-39 Release Notes Copying from CXX560.kit (disk) Verifying Ladebug Debugger graphical user interface Copying from CXX560.kit (disk) Verifying DEC C++ Class Library, Run-Time Support Copying from CXX560.kit (disk) Verifying The C++ Shared RTL (subset CXXSHRDAnnn) is currently installed. DECladebug (subset LDBBASEnnn) is currently installed. Copyright Digital Equipment Corporation 1997. All rights reserved. Government notice: Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. Licensing notice: This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. DEC C++ for Systems includes support for the License Management Facility. A Product Authorization Key (PAK) is necessary for use of this product. Information on registering and activating the PAK is available in the DEC C++ Installation Guide or the 'Guide to Software Licensing,' which is part of the Digital UNIX Systems documentation set. DEC C++ (cxx) for Digital UNIX Copying from CXX560.kit (disk) Verifying DEC C++ HTML documentation Copying from CXX560.kit (disk) Verifying DEC C++ static class libraries Copying from CXX560.kit (disk) Verifying Sample Listings A-3 DEC C++ and class library manual pages Copying from CXX560.kit (disk) Verifying DEC C++ header files for Digital UNIX V3.x Copying from CXX560.kit (disk) Verifying LDBBASEV32439 software installed successfully. Configuring "Ladebug Debugger Version 4.0-39" (LDBBASEV32439) LDBDOCV32439 Release Notes installed successfully. See the files in the directory: /usr/doc/ladebug ... Configuring "Ladebug Debugger Version 4.0-39 Release Notes" (LDBDOCV32439) LDBGUIV32439 software installed successfully. Configuring "Ladebug Debugger graphical user interface" (LDBGUIV32439) CXXSHRDA307 software installed successfully. Configuring "DEC C++ Class Library, Run-Time Support" (CXXSHRDA307) CXXBASE560 software installed successfully. Configuring "DEC C++ (cxx) for Digital UNIX" (CXXBASE560) CXXHTML560 software installed successfully. Configuring "DEC C++ HTML documentation" (CXXHTML560) CXXLIB560 software installed successfully. Configuring "DEC C++ static class libraries" (CXXLIB560) CXXMAN560 software installed successfully. Configuring "DEC C++ and class library manual pages" (CXXMAN560) Moving header files from ./usr/include/cxx/CXXOLDOS to ./usr/include/cxx Moving ./usr/include/cxx/CXXOLDOS/libcxxstd.a to ./usr/lib/cmplrs/cxx CXXV3HDR560 software installed successfully. Configuring "DEC C++ header files for Digital UNIX V3.x" (CXXV3HDR560) A-4 Sample Listings A.2 Sample Installation Verification Procedure on a DIGITAL UNIX Version 3.n System The following listing shows a sample installation verification on DIGITAL UNIX Version 3.2 system. # setld -v CXXBASE560 CXXLIB560 CXXMAN560 CXXV3HDR560 DEC C++ (cxx) for Digital UNIX (CXXBASE560) Copyright Digital Equipment Corporation 1997. All rights reserved. DEC C++ V5.6: compiling an iostream program. /usr/lib/cmplrs/cxx/gemc_cxx -g0 -O2 -Xpreplatinum -nocompress -Xirf./cxx_repository /courtney.zko.dec.comaadfla -ptr./cxx_repository -ptsuf.cxx.CXX.C.cc.CC.cpp.c -Xsd./ -o cxxV5.6.o cxxV5.6.cxx 0.53u 0.17s 0:01.1 66% /usr/lib/cmplrs/cxx/cc -o cxxV5.6 -G 8 -call_shared -g0 /usr/lib/cmplrs/cxx/_mai n.o -L/usr/lib/cmplrs/cxx -Wl,-rpath, /usr/lib/cmplrs/cxx cxxV5.6.o -v -lcxxstd -lcxx -lexc -lots -cxxsyms -tl -h /usr/lib/cmplrs/cxx -Bcxx_syms/usr/lib/cmplrs/cxx/ldcxx_syms -o cxxV5.6 -L /usr/lib/cmplrs/cxx -rpath /usr/lib/cmplrs/cxx -cxxsyms -g0 -O1 -call_shared /usr/lib/cmplrs/cc/crt0.o /usr/lib/cmplrs/cxx/_main.o cxxV5.6.o -lcxxstd -lcxx -lexc -lots -lc /usr/lib/cmplrs/cxx/cc -o cxxV5.6 -G 8 -call_shared -g0 /usr/lib/cmplrs/cxx/_main.o -L/usr/lib/cmplrs/cxx -Wl,-rpath, /usr/lib/cmplrs/cxx cxxV5.6.o -v -lcxxstd -lcxx -lexc -lots |& /usr/lib/cmplrs/cxx/demangle/usr/lib/cmplrs/cc/ld -o cxxV5.6 -L /usr/lib/cmplrs/cxx -rpath /usr/lib/cmplrs/cxx -g0 -O1 -call_shared /usr/lib/cmplrs/cc/crt0.o /usr/lib/cmplrs/cxx/_main.o cxx V5.6.o -lcxxstd -lcxx -lexc -lots -lc 0.0u 0.0s 0:00 26% 0+6k 20+7io 0pf+0w 0.05u 0.07s 0:00.3 39% DEC C++ for Digital UNIX installation verified. DEC C++ HTML documentation (CXXHTML560) 0 verification errors encountered. 0 corrections performed. DEC C++ static class libraries (CXXLIB560) 0 verification errors encountered. 0 corrections performed. DEC C++ and class library manual pages (CXXMAN560) Sample Listings A-5 0 verification errors encountered. 0 corrections performed. DEC C++ header files for Digital UNIX V3.x (CXXV3HDR560) Creating directory ./usr/include/cxx/CXXOLDOS 0 verification errors encountered. 0 corrections performed. A.3 Sample DEC C++ Installation on a DIGITAL UNIX Version 4.0 System The following listing shows a basic installation of DEC C++ on a DIGITAL UNIX Version 4.0 system using CD-ROM media. For the directory variable, you must supply a disk path name or the directory location posted with the CD-ROM media. # setld -l directory The subsets listed below are optional: There may be more optional subsets than can be presented on a single screen. If this is the case, you can choose subsets screen by screen or all at once on the last screen. All of the choices you make will be collected for your confirmation before any subsets are installed. 1) DEC C++ (cxx) for Digital UNIX 2) DEC C++ HTML documentation 3) DEC C++ and class library manual pages 4) DEC C++ header files for Digital UNIX V4.0 or later 5) Ladebug Debugger Version 4.0-39 Release Notes 6) Ladebug Debugger Version 4.0-39 7) Ladebug Debugger graphical user interface Or you may choose one of the following options: 8) ALL of the above 9) CANCEL selections and redisplay menus 10) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 8 You are installing the following optional subsets: A-6 Sample Listings DEC C++ (cxx) for Digital UNIX DEC C++ HTML documentation DEC C++ and class library manual pages DEC C++ header files for Digital UNIX V4.0 or later Ladebug Debugger Version 4.0-39 Release Notes Ladebug Debugger Version 4.0-39 Ladebug Debugger graphical user interface Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. 7 subset(s) will be installed. Loading 1 of 7 subset(s).... Ladebug Debugger Version 4.0-39 Copying from CXX560.kit (disk) Verifying Loading 2 of 7 subset(s).... Ladebug Debugger Version 4.0-39 Release Notes Copying from CXX560.kit (disk) Verifying Loading 3 of 7 subset(s).... Ladebug Debugger graphical user interface Copying from CXX560.kit (disk) Verifying Loading 4 of 7 subset(s).... DECladebug (subset LDBBASEnnn) is currently installed. Copyright Digital Equipment Corporation 1997. All rights reserved. Government notice: Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III, as applicable. Licensing notice: Sample Listings A-7 This software is proprietary to and embodies the confidential technology of Digital Equipment Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. DEC C++ for Systems includes support for the License Management Facility. A Product Authorization Key (PAK) is necessary for use of this product. Information on registering and activating the PAK is available in the DEC C++ Installation Guide or the 'Guide to Software Licensing,' which is part of the Digital UNIX Systems documentation set. DEC C++ (cxx) for Digital UNIX Copying from CXX560.kit (disk) Verifying Loading 5 of 7 subset(s).... DEC C++ HTML documentation Copying from CXX560.kit (disk) Verifying Loading 6 of 7 subset(s).... DEC C++ and class library manual pages Copying from CXX560.kit (disk) Verifying Loading 7 of 7 subset(s).... DEC C++ header files for Digital UNIX V4.0 or later Copying from CXX560.kit (disk) Verifying 7 of 7 subset(s) installed successfully. LDBBASEV40439 software installed successfully. Configuring "Ladebug Debugger Version 4.0-39" (LDBBASEV40439) LDBDOCV40439 Release Notes installed successfully. See the files in the directory: /usr/doc/ladebug ... Configuring "Ladebug Debugger Version 4.0-39 Release Notes" (LDBDOCV40439) LDBGUIV40439 software installed successfully. Configuring "Ladebug Debugger graphical user interface" (LDBGUIV40439) CXXBASE560 software installed successfully. A-8 Sample Listings Configuring "DEC C++ (cxx) for Digital UNIX" (CXXBASE560) CXXHTML560 software installed successfully. Configuring "DEC C++ HTML documentation" (CXXHTML560) CXXMAN560 software installed successfully. Configuring "DEC C++ and class library manual pages" (CXXMAN560) Moving header files from ./usr/include/cxx/CXXNEWOS to ./usr/include/cxx Moving ./usr/include/cxx/CXXNEWOS/libcxxstd.a to ./usr/lib/cmplrs/cxx CXXV4HDR560 software installed successfully. Configuring "DEC C++ header files for Digital UNIX V4.0 or later" (CXXV4HDR560) A.4 Sample Installation Verification Procedure on a DIGITAL UNIX Version 4.0 System The following listing shows a sample installation verification on DIGITAL UNIX Version 4.0 system. # setld -v CXXBASE560 CXXHTML560 CXXMAN560 CXXV4HDR560 DEC C++ (cxx) for DIGITAL UNIX (CXXBASE560) Copyright Digital Equipment Corporation 1997. All rights reserved. DEC C++ V5.6: compiling an iostream program. /usr/lib/cmplrs/cxx/gemc_cxx -g0 -O1 -thread_safe -Xirf./cxx_repository /courtney.zko.dec.comaaelpa -ptr./cxx_repository -ptsuf.cxx.CXX.C.cc.CC.cpp.c -Xsd./ -o cxxV5.6.o cxxV5.6.cxx 0.83u 0.10s 0:01.5 64% 0.05u 0.07s 4294419615:-19.9 -0% /usr/lib/cmplrs/cc/ld -o cxxV5.6 -cxxsyms -g0 -O1 -call_shared /usr/lib/cmplrs/cc/crt0.o /usr/lib/cmplrs/cxx/_main.o cxxV5.6.o -lcxxstd -lcxx -lexc -lc /usr/lib/cmplrs/cxx/cc -o cxxV5.6 -G 8 -call_shared -g0 -O1 /usr/lib/cmplrs /cxx/_main.o cxxV5.6.o -v -lcxxstd -lcxx -lexc |& /usr/lib/cmplrs/cxx/demangle /usr/lib/cmplrs/cc/ld -o cxxV5.6 -g0 -O1 -call_shared /usr/lib/cmplrs/cc /crt0.o /usr/lib/cmplrs/cxx/_main.o cxxV5.6.o -lcxxstd -lcxx -lexc -lc /usr/lib/cmplrs/cc/ld: 0.06u 0.03s 0:00 36% 0+9k 1+9io 0pf+0w 9stk+1288mem 0.08u 0.05s 0:00.3 47% DEC C++ for DIGITAL UNIX installation verified. Sample Listings A-9 DEC C++ and class library manual pages (CXXMAN560) 0 verification errors encountered. 0 corrections performed. DEC C++ header files for DIGITAL UNIX V4.0 or later (CXXV4HDR560) 0 verification errors encountered. 0 corrections performed. A-10 Sample Listings B _________________________________________________________________ Recovering from Errors This appendix provides information to help you deal with failures or errors that might occur during product installation or product use. If you find an error in the documentation, report it to the following Internet address: cxx_docs@casdoc.enet.dec.com Include the title of the document, section and page number where the error occurred. B.1 Failures During Product Installation If errors occur during the installation, the system displays failure messages. For example, if the installation fails due to insufficient disk space, the following message appears: There is not enough space for subset ?$S? ?$DESC? (?$S?) will not be loaded. Errors can occur during the installation if any of the following conditions exist: o The operating system version is incorrect. o The prerequisite software version is incorrect. o There is insufficient disk space. o The system parameter values for successful installation are insufficient. For descriptions of error messages generated by these conditions, see the DIGITAL UNIX documentation on system messages, recovery procedures, and DIGITAL UNIX software installation. For information on system software requirements, see Section 1.4.3. Recovering from Errors B-1 B.2 Failures During Product Use If an error occurs while DEC C++ is in use and you believe the error is caused by a problem with the product, please report it to DIGITAL. If you have a Software Product Services Support Agreement, contact your Customer Support Center (CSC) by telephone or by using the electronic means provided with your support agreement (such as DSNlink). The CSC provides telephone support for high-level advisory and remedial assistance. When you initially contact the CSC, indicate the following: o The name and version number of the operating system you are using o The version number of DEC C++ you are using o The hardware system you are using (such as a model number) o A brief description of the problem (one sentence if possible) o How critical the problem is Whether you submit information electronically or contact the appropriate support specialist by telephone, please take the following steps: 1. Describe as accurately as possible the circumstances and state of the system when the problem occurred. Include the description and version number of the DEC C++ compiler being used. Demonstrate the problem with specific examples. 2. Reduce the problem to as small a size as possible. 3. Remember to include listings of any command files, INCLUDE files, or relevant data files, and so forth. 4. Provide a listing of the program. 5. If the program is longer than 50 lines, submit a copy of it on machine-readable media (diskette or magnetic tape). If necessary, also submit a copy of the program library used to build the application. For information about submitting media, see the tar(1) reference page. B-2 Recovering from Errors 6. Report only one problem per report. This will facilitate a faster response. 7. Mail the problem report to DIGITAL. If the problem is related to DEC C++ documentation, you can report the problem to the CSC (if you have a Software Product Services Support Agreement and the problem is severe); otherwise, send your comments about DEC C++ documentation to the following Internet address: cxx_docs@casdoc.enet.dec.com If you have access to a FAX machine, you can also send comments or suggestions to: DEC C++ Documentation, ZKO2-3/K35 603881-0120 Recovering from Errors B-3