DIGITAL C++
Installation Guide for DIGITAL UNIX Systems


Previous Contents


Chapter 2
Preparing for DIGITAL C++ Installation on DIGITAL UNIX Systems

This chapter describes the special requirements necessary to install DIGITAL C++ on DIGITAL UNIX Version 4.0 and higher systems.

2.1 Deleting Old Subsets

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:

  1. Log in as superuser (login name root).
  2. 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
    

  3. To delete all of the old CXX subsets found, enter the setld -d command. For example:


    # /usr/sbin/setld -d CXXBASEA570
    

  4. 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 444 or a higher number. For example:


    # /usr/sbin/setld -d LDBBASE439 LDBGUI439
    

2.2 Determining Which Subsets to Load

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):
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


Chapter 3
Installing DIGITAL C++

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:

  1. Mount the media on the appropriate disk drive.
  2. Log in as superuser (login name root) to the system where you will install DIGITAL 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 DIGITAL 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
    

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:

  1. Log in as superuser (login name root) to the system where you will install DIGITAL C++.
  2. Enter a setld command that requests the load function (-l option) and identifies the system where the DIGITAL C++ subsets are located. For example, if you are loading DIGITAL C++ subsets from a RIS distribution area, enter the following:


    # setld -l node:
    

    Replace node: with the node name where the DIGITAL 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 3.3 to continue the installation.

3.3 Responding to Installation Procedure Prompts

This section explains the installation procedure prompts and displays.

3.3.1 Selecting Subsets

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.

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.

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++.


Chapter 4
After Installation

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:

  1. Log in as superuser (login name root).
  2. Enter the following form of the setld command:


    # /usr/sbin/setld -i | grep -E CXX | grep installed
    

  3. Delete the installed subsets. For example:


    # setld -d subsetnamennn subsetnamennn
    


Appendix A
Sample Listings

This appendix provides sample listings for the following procedures:

A.1 Sample DIGITAL C++ Installation on a DIGITAL UNIX Version 4.0 System

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) 

A.2 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 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. 
 


Appendix B
Files Installed on Your System

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.

Table B-1 Files Installed on 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