United States |
![]() |
![]() |
|
Order Number: AA-PX2DJ-TE
This guide describes how to install Compaq C++ (formerly DIGITAL C++) on an Alpha system running the Compaq Tru64 UNIX operating system.
Revision/Update Information: This is a revised guide, replacing AA-PX2DH-TE
Operating System & Version:
Compaq Tru64 UNIX Version 4.0D or higher.
Future maintenance releases may require higher versions.
Software Version: Compaq C++ Version 6.3
Compaq Computer Corporation
Houston, Texas
© 2000 Compaq Computer Corporation.
COMPAQ, the Compaq logo, and Alpha, DEC, Ladebug, OpenVMS, and VMS are registered in the U.S. Patent and Trademark Office. Tru64 is a trademark of Compaq Information Technologies Group, L.P. in the United States and other countries. UNIX is a trademark of The Open Group in the United States and other countries. All other product names mentioned herein may be trademarks of their respective companies.
Portions of the ANSI C++ Standard Library have been implemented using source licensed from and copyrighted by Rogue Wave Software, Inc.
Information pertaining to the C++ Standard Library has been edited and reprinted with permission of Rogue Wave Software, Inc. All rights reserved.
Portions copyright 1994-2001 Rogue Wave Software, Inc.
Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided as is without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.
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 document is available on CD-ROM. This document was prepared using DECdocument, Version 3.3-1e.
Contents |
This installation procedure creates Compaq 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 Compaq C++ for any other reason.
This guide is intended for system managers who install Compaq C++.
In addition to this guide, the Compaq C++ documentation set includes the following:
The following related documents are not included in the Compaq C++ documentation set. Please refer to these documents if you need additional information about Compaq Tru64 UNIX installation or system management, or the Ladebug debugger.
Table 1 describes the conventions used in this guide.
Convention | Meaning |
---|---|
# | A number sign (#) is the default superuser prompt. |
% | A percent sign (%) is the default user prompt. |
[Return] | 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
lowercase |
The Compaq Tru64 UNIX operating system differentiates between lowercase and uppercase characters. Examples, syntax descriptions, function definitions, and literal strings that appear in text must be typed exactly as shown. |
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. |
Your distribution kit includes a letter titled Compaq C++ for
Compaq Tru64 UNIX. 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
Compaq C++ provides both online and hardcopy release notes. Compaq 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 Compaq C++ are in subset CXXBASEnnn, where nnn is a number representing the latest release of Compaq 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/version/DECCXXnnn.release-notes |
HTML files are also provided for the release notes and some of the
product manuals for use with a web browser. See Section 1.5.
1.2 Registering Your Software License
Compaq 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 Compaq 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.
If you are installing Compaq 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 Compaq C++, review the PAK status and install the PAKs for any prerequisite or optional software before you install Compaq C++.
To register a license under the Compaq Tru64 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 Compaq C++ software distribution kit.
In addition to this guide, the software distribution kit includes the following:
If your software distribution kit is damaged or incomplete, contact
your Compaq representative.
1.4 Checking Installation Procedure Requirements
This section discusses various requirements for installing Compaq C++.
Installing Compaq 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 Compaq C++ software
and to register the license PAK.
1.4.2 Checking Hardware Requirements
To install Compaq C++, you need the following hardware:
For additional hardware requirements, see the Compaq C++ Software
Product Description (SPD) contained on the Media CD-ROM.
1.4.3 Checking Software Requirements
Compaq C++ Version 6.3 requires the Compaq Tru64 UNIX operating system Version 4.0D or higher. Future Compaq 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.
Compaq C++ requires that the following software subsets be loaded on the system where you install Compaq C++ (nnn is the number representing the latest release).
To install the Compaq C++ reference pages (manual pages), the following software subset must be installed on the system where you install Compaq C++:
To install X Motif header files for Compaq Tru64 UNIX software, the following software subset must be installed on the system where you install Compaq C++:
To check whether these subsets are loaded:
# setld -i | grep -E 'OSFBASE|OSFPGMR|OSFCMPLRS|OSFINCLUDE|CXLLIBA|OSFDCMT|OSFXDEV' |
If you do not log in as superuser (login name root ), you must enter the full path of the command.
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 Compaq Tru64 UNIX software before installing Compaq C++. (For
information on how to load the operating system software, see the
Guide to Installing Compaq Tru64 UNIX .)
The Compaq C++ reference pages are automatically loaded when you
install the base subset. In addition, you can load the following
documentation subset:
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:
To view this documentation after installation, point your web browser to
/usr/share/doclib/cplusplus/index.htm
.
Someone from your site must perform at least one Compaq C++
installation from the distribution medium. Your site system manager can
then decide whether or not to make a Compaq C++ distribution kit
available on line so that subsequent installations of Compaq C++ can
use the Remote Installation Service (RIS). For information on
extracting Compaq C++ subsets to a RIS distribution area, see the
Guide to Sharing Software on a Local Area Network.
If you expect to use Compaq 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:
If Compaq C++ subsets are available to you on a RIS server system,
you must know the name of that system.
For more information on installing Compaq C++ from a RIS distribution
area, see Section 3.2.
Compaq recommends that you back up your system disk before installing
any software. For information about backing up your system disk, see
the Compaq Tru64 UNIX system documentation.
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 Compaq C++
installation, use the following command:
1.5 Determining Which Documentation Subsets to Load
Compaq C++ HTML documentation (
CXXHTML630
)
Compaq C++ HTML documentation
1.6 Installing from Media or Using the Remote Installation Service
1.7 Backing Up Your System Disk
1.8 Stopping the Installation
# /usr/sbin/setld -i subsetname |
In this command, subsetname is the name of the Compaq 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 Compaq 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 Compaq 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 Compaq 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 Compaq C++ for Compaq Tru64 UNIX.
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 Compaq 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 Compaq 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 Compaq 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 Compaq 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 Compaq C++:
This chapter describes the special requirements necessary to install
Compaq C++ on Version 4.0D and higher systems.
Before you can install any of the Compaq C++ subsets, you should
delete all old subsets, except as noted in this section. To delete
subsets, take the following steps:
When you invoke the installation procedure you will be given choices of
which Compaq C++ subsets to load.
The following subset is required to use Compaq C++ (nnn is a
number representing the latest release; see the Read Before
Installing letter for details):
2.1 Deleting Old Subsets
# /usr/sbin/setld -i | grep NAME | grep installed | grep -v "not installed"
# /usr/sbin/setld -d CXXBASEA570
# /usr/sbin/setld -i | grep LDB | grep installed
Delete debugger subsets only if nnn is not 444 or a higher
number. For example:
# /usr/sbin/setld -d LDDBASE439 OSFLDBGUI439
2.2 Determining Which Subsets to Load
CXXBASE nnn | Compaq C++ ( cxx ) for Compaq Tru64 UNIX |
The following subset generally is required on operating system versions 5.1 and earlier:
CXXLIB nnn | Compaq C++ Run-Time Library ( libcxx ) for Version 5.1 and earlier |
See "Important Compatibility Information" in the release notes concerning the Run-Time Library subset.
Optionally, you can also install an updated version of the Version 5.7 compiler by selecting the following subset:
CXXOLD nnn | Compaq C++ Version 5.7 ( -oldcxx ) compiler |
If you install this subset, you can invoke the Version 5.7 compiler and enter the cxx -oldcxx command. By default, the (cxx) command runs the Version 6.3 compiler. Note that you must install the CXXBASEnnn subset if you want to install the CXXOLDnnn subset.
The following online documentation subset is optional:
CXXHTML nnn | Compaq C++ HTML documentation |
This chapter describes how to install Compaq C++. Before you start
the installation, read Chapter 1. You can install Compaq 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 C.
3.1 Using CD-ROM Software Product Library Media
This procedure loads Compaq C++ files on to a disk belonging to the system where you perform the installation. When Compaq C++ is run, its executable images are mapped into memory on your system.
Follow these steps to install Compaq C++ from CD-ROM media:
# mount -dr /dev/ralc /cdrom |
# mount -dr dev/disk/cdrom0c /cdrom |
# /usr/sbin/setld -l /cdrom/cxxnnn/kit |
The installation procedure now displays the names of Compaq C++ subsets and asks you to specify the subsets you want to load.
See Section 3.3 to continue the installation.
3.2 Using a Remote Installation Service Distribution Area
If you are installing Compaq C++ subsets that reside in a /etc/ris Remote Installation Service (RIS) distribution area on a remote system, follow these steps:
# setld -l node: |
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 3.3 to continue the installation.
This section explains the installation procedure prompts and displays.
You must specify which Compaq 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 Compaq Tru64 UNIX you are using. See Section 2.2.
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:
3.3 Responding to Installation Procedure Prompts
3.3.1 Selecting Subsets
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.
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
.
3.3.2 Monitoring Displays During the Subset Loading Process
The installation procedure loads and verifies the selected Compaq 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 4 explains how to run the Installation Verification Procedure (IVP) after installation, and how to delete old Compaq C++ subsets before installing a new version of Compaq C++.
This chapter explains what you need to do after the installation to
make Compaq C++ ready for use.
4.1 Running the Installation Verification Procedure
After installing Compaq 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 Compaq C++.
To run the IVP after an installation, enter the following command:
# setld -v subsetname |
In this command, subsetname can be any Compaq C++ subset. For a sample Compaq 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.
4.2 Deleting Compaq C++ from Your System
If you must remove a version of Compaq C++ from your system, delete each subset that you previously installed. To delete subsets:
# /usr/sbin/setld -i | grep -E CXX | grep installed |
# setld -d subsetnamennn subsetnamennn |
This appendix provides sample listings for the following procedures:
The following listing shows a basic installation of Compaq C++ on a Version 4.0F 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 CXX630/kit |
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) Compaq C++ HTML documentation 2) Compaq C++ Version 6.3 for Compaq Tru64 UNIX Systems 3) Compaq C++ Run-Time Library (libcxx) 4) Compaq C++ V5.7 (-oldcxx) compiler --- MORE TO FOLLOW --- Enter your choices or press RETURN to display the next screen. Choices (for example, 1 2 4-6): 1-4 Or you may choose one of the following options: 5) ALL of the above 6) CANCEL selections and redisplay menus 7) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): You are installing the following optional subsets: COMPAQ C++ HTML documentation COMPAQ C++ Version 6.3 for COMPAQ UNIX Systems Compaq C++ Run-Time Library (libcxx) Compaq C++ V5.7 (-oldcxx) compiler Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. 4 subset(s) will be installed. Loading 1 of 4 subset(s).... Copyright 1993, 1998 Compaq Equipment Corporation. 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 Compaq Computer Corporation. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor. Compaq C++ for TRU64 UNIX 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 Compaq C++ Installation Guide or the 'Guide to Software Licensing', which is part of the Tru64 UNIX Systems documentation set. Installation of this subset proceeds automatically, and should complete in approximately 1 minute. COMPAQ C++ Version 6.3 for COMPAQ UNIX Systems Copying from CXX630/kit (disk) Working....Mon Nov 13 19:02:19 EST 2000 Verifying Loading 2 of 4 subset(s).... Installation of this subset proceeds automatically, and should complete in less than 1 minute. Compaq C++ HTML documentation Copying from CXX630/kit (disk) Verifying Loading 3 of 4 subset(s).... Installation of this subset proceeds automatically, and should complete in less than 1 minute. Compaq C++ Run-Time Library (libcxx) for UNIX V4.0F and earlier Copying from CXX630/kit (disk) Verifying Loading 4 of 4 subset(s).... Installation of this subset proceeds automatically, and should complete in less than 1 minute. Compaq C++ V5.7 (-oldcxx) compiler Copying from CXX630/kit (disk) Verifying 4 of 4 subset(s) installed successfully. CXXBASE630 software installed successfully. Configuring "Compaq C++ Version 6.3 for Tru64 UNIX Systems" (CXXBASE630) CXXHTML630 software installed successfully. Configuring "Compaq C++ HTML documentation" (CXXHTML630) CXXLIB630 software installed successfully. Configuring "Compaq C++ Run-Time Library (libcxx) for UNIX V4.0F and earlier" (CXXLIB630) CXXOLD630 software installed successfully. Configuring "Compaq C++ V5.7 (-oldcxx) compiler" (CXXOLD630) |
The following listing shows a sample installation verification on Version 4.0 system.
# setld -v CXXBASE630 CXXHTML630 CXXMAN630 CXXV4HDR630 Compaq C++ for Tru64 UNIX Systems (CXXBASE630) Copyright 2000 Compaq Computer Corporation. All rights reserved. Compaq C++ Version 6.3 for Tru64 UNIX Systems: compiling an iostream program. Compaq C++ for Tru64 UNIX Systems installation verified. Compaq C++ for Tru64 UNIX Systems has been installed. |
The following listing shows the directory structure on a Compaq Tru64 UNIX system.
/usr/ bin/ cxx demangle include/ cxx/ cxx_cname/ lib/ cmplrs/ cxx/ man/ man1/ man3/ share/doclib/cplusplus/ |
Directory | Subdirectories | Description |
---|---|---|
/usr/bin/ | Links for command names | |
/usr/include/cxx/ | Compaq C++ header files | |
/usr/include/cxx_cname | cname header files | |
/usr/lib/cmplrs/ | cxx/ | Commands and libraries |
/usr/lib/ | libcxxstd.a --- archived library | |
/usr/man/ |
man1/
man3/ |
Compaq C++ reference pages |
/usr/share/doclib/cplusplus/ | HTML files | |
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:
Include the title of the document, section and page number where the
error occurred.
C.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, a message like the following appears:
There is not enough space for subset subset-name subset-name (subset-description) will not be loaded. |
Errors can occur during the installation if any of the following conditions exist:
For descriptions of error messages generated by these conditions, see the Compaq Tru64 UNIX documentation on system messages, recovery procedures, and Compaq Tru64 UNIX software installation. For information on system software requirements, see Section 1.4.3.
Following are error messages you might encounter during installation, along with explanations and suggested corrective steps.
Messages for CXXBASE630
Subset will not be installed on this version of the operating system. This subset must be installed only on Compaq Tru64 UNIX Version n.n or later. |
For Subset to be installed you must install the Standard Programmer Commands subset for Compaq Tru64 UNIX n.n or higher (OSFPGMRnnn) |
For Subset to be installed you must install the Compiler Back End subset for Compaq Tru64 UNIX n.n or higher (OSFCMPLRSnnn) |
You must remove currently installed CXXBASEnnn before installing Subset |
For Subset to be installed you must first de-install older CXX subsets. Try: setld -i | grep CXX | grep installed |
The installation verification procedure has failed. Please verify that CXXSHRDAnnn, CXXBASEnnn, and CXXHRDAnnn are correctly installed. |
Messages for CXXLIB630
Subset will not be installed on this version of the operating system This subset must be installed only on Compaq Tru64 UNIX n.n or later |
Messages for CXXHTML630
Subset will not be installed on this version of the operating system This subset must be installed only on Compaq Tru64 UNIX n.n or later |
Subset will not be installed if CXXREDISTnnn subset is installed. Please de-install any previously installed CXXREDISTnnn subsets. |
Messages for CXXOLD630
Subset will not be installed on this version of the operating system This subset must be installed only on Compaq Tru64 UNIX n.n or later. |
Subset will not be installed without the Compaq Tru64 UNIX VERSION Base subset. |
If an error occurs while Compaq C++ is in use and you believe the error is caused by a problem with the product, please report it to Compaq.
To submit problem reports, please use the problem report template cxx_bugreport . You generate the template, which contains important system information, by running the script /usr/lib/cmplrs/cxx/Vn.n-nnn/bug_report.sh . If the script is unavailable, please provide as much detail as possible (problem description, compiler version, OS version, hardware, and so on).
Customers with support contracts should seek support for problems through local customer support centers.
Customers who do not have support contracts are encouraged to mail problem reports to compaq_cxx.bugs@compaq.com . Although these reports will certainly be used as a source of input for fixing problems for new releases, we cannot give the reports individual attention. We can take remedial action only on a best-effort basis.
If the problem is related to Compaq 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 Compaq C++ documentation to the following Internet address:
Contents |
![]() |
![]() |