Previous | Contents |
This chapter describes the special requirements necessary to install
DIGITAL C++ on DIGITAL UNIX Version 4.0 and higher systems.
Before you can install any of the DIGITAL 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 DIGITAL C++ subsets to load.
The following subset is required to use DIGITAL 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 CXX | grep 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 LDBBASE439 LDBGUI439
2.2 Determining Which Subsets to Load
CXXBASE nnn | DIGITAL C++ ( cxx ) for DIGITAL UNIX |
The following subset generally is required on DIGITAL UNIX versions prior to Version 4.0D:
CXXLIB nnn | DIGITAL C++ Run-Time Library ( libcxx ) for DIGITAL UNIX 4.0C 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 | DIGITAL 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.0 compiler. Note that you must install the CXXBASEnnn subset if you want to install the CXXOLDnnn subset.
The following subsets are required if you want to debug C++ programs:
LDBBASEV40 nnn | Ladebug debugger |
LDBDOCV40 nnn | Ladebug release notes |
LDBGUIV40 nnn | Ladebug debugger window interface |
If you deleted any of these subsets (because they were old---see Section 2.1), you should install the latest versions from the current kit.
The following online documentation subset is optional:
CXXHTML nnn | DIGITAL C++ HTML documentation |
This chapter describes how to install DIGITAL C++. Before you start
the installation, read Chapter 1. You can install DIGITAL 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 DIGITAL C++ files on to a disk belonging to the system where you perform the installation. When DIGITAL C++ is run, its executable images are mapped into memory on your system.
Follow these steps to install DIGITAL C++ from CD-ROM media:
# mount -dr /dev/ralc /cdrom |
# /usr/sbin/setld -l /cdrom/cxxnnn/kit |
The installation procedure now displays the names of DIGITAL 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 DIGITAL 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 DIGITAL 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. 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 DIGITAL 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 DIGITAL C++ subsets before installing a new version of DIGITAL C++.
This chapter explains what you need to do after the installation to
make DIGITAL C++ ready for use.
4.1 Running the Installation Verification Procedure
After installing DIGITAL 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 DIGITAL C++.
To run the IVP after an installation, enter the following command:
# setld -v subsetname |
In this command, subsetname can be any DIGITAL C++ subset. For a sample DIGITAL 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 DIGITAL C++ from Your System
If you must remove a version of DIGITAL 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 DIGITAL 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) DIGITAL C++ HTML documentation 2) DIGITAL C++ Run-Time Library (libcxx) for DIGITAL UNIX V4.0C and earlier 3) DIGITAL C++ V5.7 (-oldcxx) compiler 4) DIGITAL C++ Version 6.0 for DIGITAL UNIX systems 5) Ladebug Debugger Version 4.0-44 Release Notes 6) Ladebug Debugger Version 4.0-44 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: DIGITAL C++ HTML documentation DIGITAL C++ Run-Time Library (libcxx) for DIGITAL UNIX V4.0C and earlier DIGITAL C++ V5.7 (-oldcxx) compiler DIGITAL C++ Version 6.0 for DIGITAL UNIX systems Ladebug Debugger Version 4.0-44 Release Notes Ladebug Debugger Version 4.0-44 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-44 Copying from CXX600.kit (disk) Verifying Loading 2 of 7 subset(s).... Ladebug Debugger Version 4.0-44 Release Notes Copying from CXX600.kit (disk) Verifying Loading 3 of 7 subset(s).... Ladebug Debugger graphical user interface Copying from CXX600.kit (disk) Verifying Loading 4 of 7 subset(s).... Ladebug (subset LDBBASEnnn) is currently installed. Copyright 1993, 1998 Digital 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 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. DIGITAL 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 DIGITAL C++ Installation Guide or the 'Guide to Software Licensing,' which is part of the Digital UNIX Systems documentation set. DIGITAL C++ Version 6.0 for DIGITAL UNIX systems Copying from CXX600.kit (disk) Working....Tue Dec 2 19:58:43 EST 1997 Verifying Loading 5 of 7 subset(s).... DIGITAL C++ HTML documentation Copying from CXX600.kit (disk) Verifying Loading 6 of 7 subset(s).... DIGITAL C++ Run-Time Library (libcxx) for DIGITAL UNIX V4.0C and earlier Copying from CXX600.kit (disk) Verifying Loading 7 of 7 subset(s).... DIGITAL C++ V5.7 (-oldcxx) compiler Copying from CXX600.kit (disk) Verifying 7 of 7 subset(s) installed successfully. LDBBASEV40444 software installed successfully. Configuring "Ladebug Debugger Version 4.0-44" (LDBBASEV40444) LDBDOCV40444 Release Notes installed successfully. See the files in the directory: /usr/doc/ladebug ... Configuring "Ladebug Debugger Version 4.0-44 Release Notes" (LDBDOCV40444) LDBGUIV40444 software installed successfully. Configuring "Ladebug Debugger graphical user interface" (LDBGUIV40444) CXXBASE600 software installed successfully. Configuring "DIGITAL C++ Version 6.0 for DIGITAL UNIX systems" (CXXBASE600) CXXHTML600 software installed successfully. Configuring "DIGITAL C++ HTML documentation" (CXXHTML600) CXXLIB600 software installed successfully. Configuring "DIGITAL C++ Run-Time Library (libcxx) for DIGITAL UNIX V4.0C and <earlier" (CXXLIB600) CXXOLD600 software installed successfully. Configuring "DIGITAL C++ V5.7 (-oldcxx) compiler" (CXXOLD600) |
The following listing shows a sample installation verification on DIGITAL UNIX Version 4.0 system.
# setld -v CXXBASE600 CXXHTML600 CXXMAN600 CXXV4HDR600 DIGITAL C++ for DIGITAL UNIX Systems (CXXBASE600) Copyright 1993, 1998 Digital Equipment Corporation. All rights reserved. DIGITAL C++ Version 6.0 for DIGITAL UNIX Systems: compiling an iostream program. DIGITAL C++ for DIGITAL UNIX installation verified. DIGITAL C++ for DIGITAL UNIX Systems has been installed. |
This appendix shows directory structures for DIGITAL C++ on
DIGITAL UNIX Version 3.n and Version 4.0 systems.
B.1 DIGITAL C++ Directory Structure on a DIGITAL UNIX System
The following listing shows the directory structure on a DIGITAL UNIX system.
/usr/ bin/ cxx demangle include/ cxx/ lib/ cmplrs/ cxx/ man/ man1/ man3/ share/doclib/cplusplus/ |
Table B-1 describes the contents of DIGITAL C++ directories on a DIGITAL UNIX system.
Directory | Subdirectories | Description |
---|---|---|
/usr/bin/ | Links for command names | |
/usr/include/cxx/ | DIGITAL C++ header files | |
/usr/lib/cmplrs/ | cxx/ | Commands and libraries |
/usr/lib/ | libcxxstd.a --- archived library | |
/usr/man/ |
man1/
man3/ |
DIGITAL C++ reference pages |
/usr/share/doclib/cplusplus/ | HTML files | |
Previous | Next | Contents |