Revision/Update Information: This is a revised guide.
Operating System & Version:
DIGITAL UNIX Version 4.0 or higher.
Future maintenance releases may require higher versions.
Software Version: DIGITAL C++ Version 6.0
DIGITAL Equipment Corporation
Maynard, Massachusetts
The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document.
The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license.
The following are trademarks of Digital Equipment Corporation: Bookreader, DEC, DEC FUSE, DECwindows, DIGITAL, Ladebug, ULTRIX, VAX DOCUMENT, the DIGITAL 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 V3.2-1a.
| Contents |
This installation procedure creates DIGITAL 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 DIGITAL C++ for any other reason.
This guide is intended for system managers who install DIGITAL C++.
In addition to this guide, the DIGITAL C++ documentation set includes the following:
The following related documents are not included in the DIGITAL C++ documentation set. Please refer to these documents if you need additional information about DIGITAL 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 DIGITAL 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 Read Before
Installing DIGITAL 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
DIGITAL 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 DIGITAL C++ are in subset CXXBASEnnn, where nnn is a number representing the latest release of DIGITAL 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 |
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
DIGITAL 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 DIGITAL 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 DIGITAL 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 DIGITAL C++, review the PAK status and install the PAKs for any prerequisite or optional software before you install DIGITAL 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 DIGITAL 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 DIGITAL representative.
1.4 Checking Installation Procedure Requirements
This section discusses various requirements for installing DIGITAL C++.
Installing DIGITAL 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 DIGITAL C++ software
and to register the license PAK.
1.4.2 Checking Hardware Requirements
To install DIGITAL C++, you need the following hardware:
For additional hardware requirements, see the DIGITAL C++ Software
Product Description (SPD) contained on the Media CD-ROM .
1.4.3 Checking Software Requirements
DIGITAL C++ Version 6.0 requires the DIGITAL UNIX operating system Version 4.0 or higher. Future DIGITAL 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.
DIGITAL C++ requires that the following DIGITAL UNIX software subsets be loaded on the system where you install DIGITAL C++ (nnn is the number representing the latest release):
To install the DIGITAL C++ reference pages (manual pages), the following DIGITAL UNIX software subset must be installed on the system where you install DIGITAL C++ :
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 DIGITAL C++ :
To check whether these subsets are loaded:
# setld -i | grep -E 'OSFBASE|OSFPGMR|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 DIGITAL C++. (For
information on how to load the operating system software, see the
Guide to Installing DIGITAL UNIX.)
The DIGITAL 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, open the following file using your web
browser:
1.5 Determining Which Documentation Subsets to Load
/usr/share/doclib/cplusplus/cxx.html
|
Someone from your site must perform at least one DIGITAL C++ installation from the distribution medium. Your site system manager can then decide whether or not to make a DIGITAL C++ distribution kit available on line so that subsequent installations of DIGITAL C++ can use the Remote Installation Service (RIS). For information on extracting DIGITAL C++ subsets to a RIS distribution area, see the Guide to Sharing Software on a Local Area Network.
If you expect to use DIGITAL 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 DIGITAL C++ subsets are available to you on a RIS server system, you must know the name of that system.
For more information on installing DIGITAL C++ from a RIS distribution
area, see Section 3.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.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 DIGITAL C++ installation, use the following command:
# /usr/sbin/setld -i subsetname |
In this command, subsetname is the name of the DIGITAL 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 DIGITAL 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 DIGITAL 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 DIGITAL 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 DIGITAL C++ for DIGITAL UNIX Systems.
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 DIGITAL 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 DIGITAL 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 DIGITAL 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 DIGITAL 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 DIGITAL C++:
| Next | Contents |