DEC Ada ______________________________________________ Installation Guide for Digital UNIX Systems Order Number: AA-PYZDB-TE January 1997 This guide describes how to install DEC Ada on an Alpha processor running the Digital UNIX operating system. Revision/Update Information: This manual su- percedes all previous versions of the DEC Ada Installation Guide for DEC OSF/1 Systems. Operating System: Digital UNIX Version 3.2G, 4.0, or 4.0B Software Version: DEC Ada Version 3.3 for Digital UNIX Systems Digital Equipment Corporation Maynard, Massachusetts __________________________________________________________ January 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 1997. All Rights Reserved. The following are trademarks of Digital Equipment Corporation: Bookreader, DEC, DEC Ada, DECdocument, DEC Fortran, DEC FUSE, DECterm, DECthreads, DECwindows, Digital, OpenVMS, VAX DOCUMENT, and the DIGITAL logo. The following are third-party trademarks: Motif, OSF, OSF/Motif, and OSF/1 are registered trademarks of the Open Software Foundation, Inc. POSTSCRIPT is a registered trademark of Adobe Systems, Inc. UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Limited. X/Open is a trademark of X/Open Company Limited. X Window System is a trademark of the Massachusetts Institute of Technology. All other trademarks and registered trademarks are the property of their respective holders. ZK5580 This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. ________________________________________________________________ Contents Preface.................................................. v 1 Preparing for DEC Ada Installation 1.1 Reading the Online Release Notes ............ 1-1 1.2 Registering Your Software License ........... 1-2 1.3 Checking the Software Distribution Kit....... 1-3 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-4 1.4.4 Deleting Previous Versions .............. 1-5 1.4.5 Determining Which DEC Ada Subsets to Load ......................................... 1-5 1.4.6 Determining Disk Space Requirements...... 1-7 1.4.6.1 Checking Current Disk Space............ 1-8 1.4.6.2 Increasing Disk Space by Using Alternative Disks ..................... 1-9 1.5 Installing from Media or Using RIS........... 1-10 1.6 Backing Up Your System Disk ................. 1-10 1.7 Stopping the Installation ................... 1-10 2 Installing DEC Ada 2.1 Using CD-ROM Consolidated Distribution Media........................................ 2-1 2.2 Using a RIS Distribution Area ............... 2-2 2.3 Responding to Installation Procedure Prompts...................................... 2-2 2.3.1 Selecting DEC Ada Subsets................ 2-3 iii 2.3.2 Monitoring Displays During the Subset Loading Process ......................... 2-4 3 After Installation 3.1 Running the Installation Verification Procedure (IVP) ............................. 3-1 3.2 Deleting DEC Ada from Your System............ 3-1 3.3 Displaying Documentation from CD-ROM ........ 3-2 A Sample Listings A.1 Sample Listing of a DEC Ada Installation .... A-1 A.2 Sample Listing of a DEC Ada Installation Verification Procedure (IVP)................. A-4 B Files Installed on Your System C Recovering from Installation Errors C.1 Failures During Product Installation ........ C-1 C.2 Failures During Product Use ................. C-2 C.3 Documentation Comments and Errors ........... C-4 Figures 1 Documentation Reading Path for Related Documents................................ v 2 Documentation Reading Path for DEC Ada Documentation............................ vi Tables 1 Conventions Used in This Guide........... ix 1-1 DEC Ada Subset Sizes (Kilobytes Required)................................ 1-7 B-1 DEC Ada Directories...................... B-1 iv ________________________________________________________________ Preface This guide explains how to install DEC Ada Version 3.3 on the Digital UNIX operating system. The installation procedure creates DEC Ada file systems subordinate to the /usr/lib/cmplrs and /usr/man directo- ries and loads DEC Ada software subsets. Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall DEC Ada for any other reason. Intended Audience This guide is intended to help the installation of DEC Ada software for system managers who install DEC Ada. Documentation Reading Path Figures 1 and 2 show the relationship of the Ada documentation set to other documentation that may be helpful. Figure 1 Documentation Reading Path for Related Documents v Figure 2 Documentation Reading Path for DEC Ada Documentation vi Associated Documents In addition to this manual, the following documents are sources of information on DEC Ada and related products: o Read Before Installing or Using DEC Ada Version 3.3 for Digital UNIX Systems o Read Before Installing or Using DEC Ada Version 3.3 Professional Development Option for Digital UNIX Systems o Ladebug Debugger Manual: Window and Command-Line Interface o DEC FUSE Handbook o DEC FUSE Reference Manual See also the following Digital UNIX manuals: o Command and Shell User's Guide o Software License Management o Installation Guide o Sharing Software on a Local Area Network The Software Product Library CD-ROM User's Guide and the Online Documentation Library CD-ROM User's Guide had been included as printed documents in previous releases and are now available on line only. They are located on disc 1 of the CD-ROM in the /readme directory. To locate the DEC Ada product directory, consult these online documents. Document Structure This guide has the following chapters and appendixes: o Chapter 1 describes the operating system and hardware requirements for DEC Ada installation and related procedures that you complete before installing DEC Ada. o Chapter 2 describes the installation procedures for local, server, and client installations. vii o Chapter 3 describes the Installation Verification Procedure (IVP) and any postinstallation procedures that you must complete in order to use DEC Ada. o Appendix A contains sample listings for DEC Ada installation and the IVP. o Appendix B lists files installed on your system. o Appendix C describes recovering from installation errors. Sending Digital Your Comments on This Manual We welcome your comments on this or any other DEC Ada manual. You can send comments in the following ways: o Internet electronic mail: ada_docs@zko.mts.dec.com o FAX: 603-881-0120 Attn: Languages Documentation, ZKO2-3 /K35 o A letter addressed to: Digital Equipment Corporation Languages Documentation, ZK02-3/K35 110 Spit Brook Road Nashua, NH 03062-2698 USA If you have suggestions for improving a particular section or find any errors, please indicate the title, order number, and section (if available). Digital also welcomes general comments. Getting Help from Digital If you have a customer support contract and have comments or questions about DEC Ada software, you can contact Digital's Customer Support Center (CSC), preferably using electronic means such as DSNlink. In the United States, customers can call the CSC at 1-800-354-9000 (see Appendix C). viii In addition, Digital now provides access to Web Information and Support (WIS), a new electronic delivery application that allows you to submit electronic service requests, access databases, download patch kits, transfer files from Digital, and connect to global notes conferences via the World Wide Web. If you are an entitled service customer with access to the Web, you can now use your favorite browser to connect to electronic services through an easy-to-use, graphical interface. If you are already a DIA user, you can gain access to WIS by opening http://www.service.digital.com/wis, clicking on the words "United States," and entering your DIA Access ID and password. WIS and DIA use the same underlying account and directory on the Digital Customer Support Center host system. If you are not already registered for DIA, you can register for a WIS account by contacting your Customer Support Center or local Digital representative. Conventions The name of the DEC OSF/1 operating system has been changed to the Digital UNIX operating system. Any references to DEC OSF/1 are synonymous with Digital UNIX unless specified otherwise. Table 1 shows the conventions used in this guide. Table_1_Conventions_Used_in_This_Guide____________________ Convention__________Description___________________________ DEC OSF/1 Refers to the DEC OSF/1 operating system, unless otherwise specified. Digital UNIX Refers to the Digital UNIX operating system, unless otherwise specified. # A pound sign (#) represents the default superuser prompt. (continued on next page) ix Table_1_(Cont.)_Conventions_Used_in_This_Guide____________ Convention__________Description___________________________ % A percent sign (%) represents the system prompt. In interactive examples, a label enclosed in a box indicates that you press a key on the terminal, for example, . Ctrl/x The phrase Ctrl/x indicates that you must press the key labeled Ctrl while you simultaneously press another key, for example, Ctrl/C, Ctrl/D, Ctrl/L, Ctrl/O, or Ctrl/Z. boldface monospace In interactive examples, boldface text monospace text represents user input. monospaced text This typeface is used in text to indicate 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. variable This typeface is used in syntax to indicate variable values. UPPERCASE The Digital UNIX system differentiates lowercase between lowercase and uppercase characters. Literal strings that appear in text, examples, syntax descriptions, and function definitions must be typed exactly as shown. cat(1) Cross-references to the online ref- erence pages include the appropriate section number in parentheses. For example, a reference to cat(1) indicates that you can find the material on the cat command in Section 1 of the reference pages. (continued on next page) x Table_1_(Cont.)_Conventions_Used_in_This_Guide____________ Convention__________Description___________________________ . . . A horizontal ellipsis in an example or figure indicates that not all of the statements are shown. . A vertical ellipsis in an interactive . figure or example indicates that not . all of the commands and responses are shown. n A lowercase italic n indicates the generic use of a number. pathname . . . A horizontal ellipsis following an argument, option, or value in syntax descriptions indicates that additional arguments, options, or values can be entered. (continued on next page) xi Table_1_(Cont.)_Conventions_Used_in_This_Guide____________ Convention__________Description___________________________ boldface text Boldface text indicates Ada reserved words. type_name Italicized words in syntax descrip- tions indicate descriptive prefixes that are intended to give additional semantic information rather than to define a separate syntactic category. [expression] Square brackets indicate that the enclosed item is optional. Square brackets also enclose default choices during installation. {, mechanism_name Braces in Ada syntax indicate that the } enclosed item can be repeated zero or more times. italic text Italic text emphasizes important information, indicates variables, and indicates complete titles of manuals. Italic text also represents information that can vary in system messages (for example, Internal error number.) | A vertical bar in Ada syntax separates alternative items unless it occurs immediately after an opening brace, in ____________________which_case_it_stands_for_itself.______ xii 1 ________________________________________________________________ Preparing for DEC Ada Installation Before starting the installation procedures in Chapter 2, you should complete the preparation requirements explained in this chapter. Your Bill of Materials (BOM) and Indented Bills Report (BIL) specify the number and contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged or if you find that parts of it are missing, contact your Digital representative. Your distribution kit includes a letter titled Read Before Installing or Using DEC Ada Version 3.3 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 Ada provides online 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 installation and to the use of DEC Ada. The release notes for DEC Ada are located online in both ASCII (*.TXT) and POSTSCRIPT (*.PS). in the following file: /usr/lib/cmplrs/ada_nnn/release_notes.* In this manual (as in the previous example), the version number is given as nnn. When you use the product, substitute the actual version numbers in place of the nnn. Therefore, you access the release notes for DEC Ada Version 3.3 at location /usr/lib/cmplrs/ada_330/release_ notes.txt or /usr/lib/cmplrs/ada_330/release_notes.ps. Preparing for DEC Ada Installation 1-1 For information about installing these release notes before installing DEC Ada, see Section 2.3.1. To read the release notes after DEC Ada is installed, enter the following command: # more /usr/lib/cmplrs/ada_330/release_notes.txt 1.2 Registering Your Software License DEC Ada includes support for the License Management Facility (LMF). You must register your License Product Authorization Key (License PAK) in the License Database (LDB) in order to use DEC Ada 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 DEC Ada 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 Ada, review the PAK status and install the PAKs for any prerequisite or optional software before you install DEC Ada. To register a license under the Digital UNIX system, perform the following steps: 1. Log in as superuser (login name root). 2. At the superuser prompt, edit an empty PAK template with the following command: # lmf register 3. Enter all the information on your license PAK form. After you register your license, use the following command to copy the license details from the License Database (LDB) to the kernel cache: # lmf reset For complete information on using the License Management Facility, see the Digital UNIX guide Software License Management and the lmf(8) reference page. 1-2 Preparing for DEC Ada Installation 1.3 Checking the Software Distribution Kit Use the Bill of Materials (BOM) to check the contents of your DEC Ada 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 user's guide and CD-ROM read first letter If your software distribution kit is damaged or incom- plete, contact your Digital representative. 1.4 Checking Installation Procedure Requirements This section discusses various requirements for installing DEC Ada. Installing DEC Ada, including running the Installation Verification Procedure (IVP), takes approximately 10 to 15 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 Ada software and to register the license PAK. 1.4.2 Checking Hardware Requirements To install DEC Ada, 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 following two online guides explain how to load and use the CD-ROM media: - Software Product Library CD-ROM User's Guide - Online Documentation Library CD-ROM User's Guide These two guides had been included as printed documents in previous releases and are now available on line only. They are located on disc 1 of the CD-ROM in the /readme directory. o Terminal Preparing for DEC Ada Installation 1-3 You can use either a hardcopy or video terminal to communicate with the operating system and respond to prompts from the installation procedure. See the DEC Ada Software Product Description (SPD) for additional hardware requirements. 1.4.3 Checking Software Requirements DEC Ada Version 3.3 requires Digital UNIX Version 3.2G, 4.0, or 4.0B. Future DEC Ada releases may require higher versions. DEC Ada also requires that the following Digital UNIX subsets be loaded on the system where you install DEC Ada: o OSFBASE-the "Base System" subset o OSFCMPLRS-the "Compiler Back End" subset o OSFPGMR-the "Software Development Environment" subset o OTABASE-the "DEC Compiled-Code Support Library" (libots.a) To install the DEC Ada reference pages, the following Digital UNIX software subsets must be installed on the system where you install DEC Ada: o OSFMANOS, the "Admin/User" online reference pages o OSFMANOP, the "Programming" online reference pages o OSFDCMT, the document preparation software To check whether these subsets are loaded, follow these steps: 1. Log in to the system where you will install DEC Ada. 2. Enter the following command: # setld -i | egrep 'OSFBASE|OSFCMPLRS|OSFPGMR|OSFMANOS|OSFMANOP|OSFDCMT' 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 OSFBASE 1-4 Preparing for DEC Ada Installation 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 Ada. (For information on how to load operating system software, refer to the Installation Guide for Digital UNIX.) 1.4.4 Deleting Previous Versions Before installing or reinstalling DEC Ada, you must delete any previous installations of the DEC Ada compiler. For example: # setld -i | grep ADA # setld -d ADABASEnnn ADADOCnnn ADAEXAnnn ADALIBnnn ADAMANnnn ADAPALnnn 1.4.5 Determining Which DEC Ada Subsets to Load You must choose the DEC Ada subsets you want to load. Some subsets are optional whereas some subsets are mandatory. In the subset identifiers starting with "ADA", the nnn represents the version number of DEC Ada, except in the case of ADALIB. With ADALIB, the nnn matches (as closely as possible) the version number of the operating system. The DEC Ada subsets have the following titles: o ADABASEnnn-Title: DEC Ada Vn.n Primary Subset This subset contains the compiler and the program library manager. This subset must be installed to compile, link, and run DEC Ada programs. Files are installed in the directory /usr/lib/cmplrs/ada_nnn/bin. o ADADOCnnn-Title: DEC Ada Vn.n Release Notes This subset contains the online release notes for DEC Ada. It installs the file /usr/lib/cmplrs/ada_ nnn/release_notes.*. Release notes are provided in two formats: POSTSCRIPT (.PS) and ASCII (.TXT). o ADAEXAnnn-Title: DEC Ada Vn.n Examples Preparing for DEC Ada Installation 1-5 This subset contains several examples of Ada programs and directions on how to build them. It also contains some optional bindings. Files are installed in the directory /usr/lib/cmplrs/ada_nnn/examples. o ADALIBnnn-Title: DEC Ada Run-Time Library for Digital UNIX Vn.n This subset contains a run-time library of code to support the generated code from the compiler and must be installed to run DEC Ada programs. Files for use with Version 3.2G of the Digital UNIX operating system are installed in the directory /usr /lib/cmplrs/ada_322 under the subset name ADALIB322. Files for use with Version 4.0 and Version 4.0B of the Digital UNIX operating system are installed in the directory /usr/lib/cmplrs/ada_401 under the subset name ADALIB401. o ADAMANnnn-Title: DEC Ada Vn.n Reference Pages This subset contains all reference pages for the DEC Ada compiler and its libraries. Files are installed in the directory /usr/man/man1. You can load the DEC Ada reference page subset only if the Digital UNIX reference page subset is already loaded on your system. If users on the system where DEC Ada is being installed use reference pages that are nfs mounted from another system, load the DEC Ada reference pages on the other system rather than the one where you are currently installing DEC Ada. In this case, do not request the reference page subset during this installation of DEC Ada. After the installation is complete, you can log in to the system where the Digital UNIX reference pages are installed and load only the DEC Ada reference page subset on that system. See the setld(8) reference page for information about loading specific subsets. o ADAPALnnn-Title: DEC Ada Vn.n Predefined Library 1-6 Preparing for DEC Ada Installation This subset contains a library of DEC Ada predefined units and must be installed to compile DEC Ada programs. Files are installed in the directory /usr/lib/cmplrs/ada_nnn/lib. ________________________Note ________________________ Digital requires that you install at least the following subsets: ADABASEnnn-Title: DEC Ada V3.3 Primary Subset ADALIBnnn-Title: DEC Ada Run-Time Library for Digital UNIX (V3.2G or V4.0) ADAPALnnn-Title: DEC Ada V3.3 Predefined Library _____________________________________________________ 1.4.6 Determining Disk Space Requirements Table 1-1 lists the disk space requirements for loading DEC Ada software subsets. These requirements apply to the disks where you load the DEC Ada subsets. The requirements are listed by directory for convenience if you are doing installations on systems where these directories are mount points for different disk partitions. Table_1-1_DEC_Ada_Subset_Sizes_(Kilobytes_Required)_______ Subset Name________Directory_____________________Kbytes_Required_ ADABASEnnn[1/usr/lib/cmplrs/ada_nnn[1] 12000 /bin ADADOCnnn[1]/usr/lib/cmplrs/ada_nnn[1] 100 /release_notes ADAEXAnnn[1]/usr/lib/cmplrs/ada_nnn[1] 4500 /examples ADALIBnnn[1]/usr/cmplrs/ada_nnn[1]/lib 15000 ADAMANnnn[1]/usr/man/man1 100 ADAPALnnn[1]/usr/lib/cmplrs/ada_nnn[1] 13000 /lib Total: 33800 [1]nnn_is_the_version_number_of_DEC_Ada___________________ __________________________________________________________ Preparing for DEC Ada Installation 1-7 Using these disk space requirements, total the values for the subsets you will load in each directory. Compare the space required for subsets with the free space currently on the disks where DEC Ada files will reside. 1.4.6.1 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 Ada. You can check which directories are mounted and where they are by viewing the /etc/fstab file. For example: # more /etc/fstab /dev/rz0a / ufs rw 1 1 /dev/rz0g /usr ufs rw 1 2 /dev/rz0b swap1 ufs sw 0 2 /@mybet /mybet nfs rw,bg,soft 0 0 /usr@mybet /mybet/usr nfs rw,bg,soft 0 0 The display indicates that /usr (mounted to /dev/rz0g) is the only mount point that affects where DEC Ada files will reside. The system has only one local disk drive. The /usr/lib/cmplrs and /usr/man file systems reside in the g partition of the disk on that drive. To check total space and free space for the directories where DEC Ada 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 512-blks used avail capacity Mounted on /dev/rz0g 126462 82572 31242 73% /usr The previous display indicates that there are 31,242 available free blocks. This free space must accommodate subset requirements listed in Table 1-1. On systems where /usr/lib/cmplrs and /usr/man are mounted to different devices from /usr, enter the following command: # df /usr/lib/cmplrs /usr/man 1-8 Preparing for DEC Ada Installation In this case, compare space required for DEC Ada files in /usr/lib/cmplrs to the free space displayed in the first line of the df output list. Also, compare the space required for DEC Ada files in /usr/man to the free space displayed in the second line of that list. 1.4.6.2 Increasing Disk Space by Using Alternative Disks The DEC Ada installation procedure creates the following directories and loads files into subordinate directories: /usr/lib /usr/lib/cmplrs /usr/lib/cmplrs/ada_nnn /usr/man/man1 If the /usr/lib/cmplrs directory node in the previous paths does not exist, the installation procedure creates it. If the /usr/lib/cmplrs node does exist, the installation procedure uses it. If you find that there is insufficient disk space for the DEC Ada 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 Ada: 1. Log in as superuser (login name root) to the system where you will install DEC Ada. 2. Create the directory /usr/lib/cmplrs, /usr/lib/cmplrs /ada_nnn, or both. 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. Preparing for DEC Ada Installation 1-9 1.5 Installing from Media or Using RIS Someone from your site must perform at least one DEC Ada installation from the distribution medium. Your site system manager can then decide whether or not to make a DEC Ada distribution kit available on line so that subsequent installations of DEC Ada can use the Remote Installation Service (RIS). For information on extracting DEC Ada subsets to a RIS distribution area, see the Digital UNIX guide, Sharing Software on a Local Area Network. If you expect to use DEC Ada subsets from a RIS area of a remote system for installation on your local system, first check with your site system manager to ensure the following: o A DEC Ada network kit is available for use. o Your system is registered as a RIS client. If DEC Ada subsets are available to you on a RIS server system, you must know the name of that system. For more information on installing DEC Ada from a RIS distribution area, see Section 2.2. 1.6 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.7 Stopping the Installation To stop the installation procedure at any time, enter Ctrl /C. You must then delete files created up to this point interactively. The directories and files created during the DEC Ada installation are listed in the following file: /usr/lib/cmplrs/ada_nnn/filelist 1-10 Preparing for DEC Ada Installation 2 ________________________________________________________________ Installing DEC Ada This chapter describes how to install DEC Ada. Before you start the installation, read Chapter 1. If you encounter any failures during installation, see Appendix C. DEC Ada can be installed locally (using CD-ROM media) or remotely from a server area (using a RIS distribution area). 2.1 Using CD-ROM Consolidated Distribution Media This procedure loads DEC Ada files on to a disk belonging to the system where you perform the installation. When DEC Ada is run, its executable images are mapped into memory on your system. Follow these steps to install DEC Ada 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 Ada. 3. Make sure you are at the root (/) directory by entering the following command: # cd / 4. 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 -d /dev/ral /cdrom 5. Enter a setld command that requests the load function (-l) and identifies the directory in the mounted file system where DEC Ada subsets are located. Installing DEC Ada 2-1 For example, if the directory location for these subsets is /cdrom/AXP/ADA, enter the following command: # setld -l /cdrom/AXP/ADA The installation procedure now displays the names of DEC Ada subsets and asks you to specify the subsets that you want to load. See Section 2.3 to continue the installation. 2.2 Using a RIS Distribution Area If you are installing DEC Ada subsets that reside in a /etc/ris (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 Ada. 2. Make sure you are at the root directory (/) by entering the following command: # cd / 3. Enter a setld command that requests the load function (-l option) and identifies the system where the DEC Ada subsets are located. For example, if you are loading DEC Ada subsets from a RIS distribution area on node orion, enter the following command: # setld -l orion: Remote Installation Services now displays a menu that lists all the software subsets available to you and asks you to specify the subsets that you want to load. See Section 2.3 to continue the installation. 2.3 Responding to Installation Procedure Prompts This section explains the installation procedure prompts and displays. 2-2 Installing DEC Ada 2.3.1 Selecting DEC Ada Subsets You must specify which DEC Ada subsets you want to load. ________________________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. _____________________________________________________ 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 Ada V3.3 Examples 2) DEC Ada V3.3 Predefined Library 3) DEC Ada V3.3 Primary Subset 4) DEC Ada V3.3 Reference Pages 5) DEC Ada V3.3 Release Notes Or you may choose one of the following options: 6) ALL of the above 7) CANCEL selections and redisplay menus 8) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): If you specify more than one number at the prompt, separate each number with a space, not a comma. ________________________Note ________________________ Digital requires that you install at least the following subsets: ADABASEnnn-Title: DEC Ada V3.3 Primary Subset ADALIBnnn-Title: DEC Ada Run-Time Library (V3.2G or V4.0) Installing DEC Ada 2-3 ADAPALnnn-Title: DEC Ada V3.3 Predefined Library _____________________________________________________ Next, the procedure lets you verify your choice. For example, if you enter 8 in response to the previous prompt, you will see the following display: You are installing the following optional subsets: DEC Ada V3.3 Examples DEC Ada V3.3 Predefined Library DEC Ada V3.3 Primary Subset DEC Ada V3.3 Reference Pages DEC Ada V3.3 Release Notes 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. 2.3.2 Monitoring Displays During the Subset Loading Process The installation procedure loads and verifies the selected DEC Ada subsets. The following example shows a display where all DEC Ada subsets are being loaded from CD-ROM: DEC Ada V3.3 Primary Subset Copying from /cdrom/AXP/ADA (disk) Verifying DEC Ada V3.3 Predefined Library Copying from /cdrom/AXP/ADA (disk) Verifying DEC Ada V3.3 Examples Copying from /cdrom/AXP/ADA (disk) Verifying DEC Ada V3.3 Reference Pages Copying from /cdrom/AXP/ADA (disk) Verifying 2-4 Installing DEC Ada DEC Ada V3.3 Release Notes Copying from /cdrom/AXP/ADA (disk) Verifying ________________________Note ________________________ To work properly, the DEC Ada reference page subset requires that both the Digital UNIX reference page and Digital UNIX DCMT subsets be loaded. If they have not been loaded, the installation procedure displays a message to tell you that the DEC Ada reference page subset is not being loaded and why. The message is informational only and does not interfere with the loading of other 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 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. Installing DEC Ada 2-5 3 ________________________________________________________________ After Installation This chapter explains what you need to do after the installation to make DEC Ada ready for use. 3.1 Running the Installation Verification Procedure (IVP) After installing DEC Ada, 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 access DEC Ada. The IVP verifies the installation by using the fverify command with the -y option (see the fverify(8) reference page). To run the IVP after an installation at the default root path ("/"), enter the setld -v command with any DEC Ada subset. For example: # setld -v ADABASE330 For a sample listing of the DEC Ada 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. 3.2 Deleting DEC Ada from Your System If you must remove a version of DEC Ada from your system, delete each subset that you previously installed. To delete subsets, follow these steps: 1. Log in as superuser (login name root). After Installation 3-1 2. Make sure you are at the root directory (/) by entering the following command: # cd / 3. Enter the following form of the setld command: # setld -i | grep 'subsetname.*nnn|subsetname.*nnn' 4. Look for the word "installed" in the listing produced. Then delete the installed subsets. For example: # setld -d subsetnamennn subsetnamennn 3.3 Displaying Documentation from CD-ROM The DEC Ada documentation is provided on the Digital UNIX Layered Products Online Documentation 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 the online files, see the Online Documentation Library CD-ROM User's Guide. 3-2 After Installation A ________________________________________________________________ Sample Listings This appendix provides sample listings for the following procedures: o A DEC Ada installation using disk media (CD-ROM) o An Installation Verification Procedure (IVP) run after the installation A.1 Sample Listing of a DEC Ada Installation The following is a sample listing of a DEC Ada installa- tion: # setld -l /kit/v33/output 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 Ada V3.3 Examples 2) DEC Ada V3.3 Predefined Library 3) DEC Ada V3.3 Primary Subset 4) DEC Ada V3.3 Reference Pages 5) DEC Ada V3.3 Release Notes Or you may choose one of the following options: 6) ALL of the above 7) CANCEL selections and redisplay menus 8) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 6 You are installing the following optional subsets: Sample Listings A-1 DEC Ada V3.3 Examples DEC Ada V3.3 Predefined Library DEC Ada V3.3 Primary Subset DEC Ada V3.3 Reference Pages DEC Ada V3.3 Release Notes Is this correct? (y/n): y Checking file system space required to install selected subsets: File system space checked OK. DEC Compiled Code Support Library Copying from /cdrom/AXP/ADA (disk) Verifying Beginning installation of DEC Ada Version 3.3 for Digital UNIX Systems, primary subset [ADABASE330]. Copyright (c) Digital Equipment Corporation 1996. All rights reserved. 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. 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. To check that the installed Primary Subset (compilation tools), Runtime Library, and Predefined Library operate correctly, run the Installation Verification Procedure (IVP) with the command: setld -v ADABASE330 Installing DEC Ada and running the IVP requires approximately 10 to 15 minutes depending on your system configuration and the distribution media you are using. DEC Ada V3.3 Primary Subset Copying from /kit/v33/output (disk) Working....Mon Oct 7 11:12:04 EDT 1996 Verifying A-2 Sample Listings DEC Ada V3.3 Predefined Library Copying from /kit/v33/output (disk) Working....Mon Oct 7 11:12:43 EDT 1996 Verifying DEC Ada V3.3 Examples Copying from /kit/v33/output (disk) Verifying DEC Ada V3.3 Reference Pages Copying from /kit/v33/output (disk) Verifying DEC Ada V3.3 Release Notes Copying from /kit/v33/output (disk) Verifying DEC Ada includes support for the License Management Facility. A Product Authorization Key is necessary for use of the product. For information on registering and activating the PAK, refer to the Installation Guide or to the Digital UNIX guide "Software License Management," which is part of the Operating System documentation. Completed installation of DEC Ada Version 3.3 for Digital UNIX Systems, primary subset [ADABASE330]. Configuring "DEC Ada V3.3 Primary Subset" (ADABASE330) Configuring "DEC Ada V3.3 Predefined Library" (ADAPAL330) Configuring "DEC Ada V3.3 Examples" (ADAEXA330) Configuring "DEC Ada V3.3 Reference Pages" (ADAMAN330) Configuring "DEC Ada V3.3 Release Notes" (ADADOC330) Sample Listings A-3 A.2 Sample Listing of a DEC Ada Installation Verification Procedure (IVP) The following is a sample listing of a DEC Ada IVP: # setld -v ADABASE330 DEC Ada V3.3 Primary Subset (ADABASE330) Starting Installation Verification Procedure (IVP) of DEC Ada Version 3.3 for Digital UNIX Systems [ADABASE330]. If this fails, see the release notes for information about submitting a report. Copyright (c) Digital Equipment Corporation 1996. All Rights Reserved. 0 verification errors encountered. 0 corrections performed. IVP, information: Created scratch directory. IVP, information: Testing DEC Ada commands in /usr/bin. IVP, information: Compiling and linking. IVP, information: Running. DEC Ada V3.3 installation verification test Testing, testing, 1, 2, 3, 4 Testing, testing DEC Ada V3.3 installation verification PASSED IVP, information: Cleaning up. IVP, information: Execution successful. End of Installation Verification Procedure of DEC Ada Version 3.3 for Digital UNIX Systems [ADABASE330]. A-4 Sample Listings B ________________________________________________________________ Files Installed on Your System Table B-1 describes the contents of DEC Ada directories. Table_B-1_DEC_Ada_Directories_____________________________ Directory_______________________Contents_of_the_Directory_ /usr/bin Symbolic links to DEC Ada commands /usr/include File for manual ini- tialization of an Ada component /usr/lib Symbolic links to the predefined Ada and run- time libraries /usr/shlib Symbolic link to the DEC Ada Run-Time Library /usr/lib/cmplrs/ada_nnn[1]/bin DEC Ada primary subset /usr/lib/cmplrs/ada_nnn[1] Release notes, DEC Ada Technical Overview and comparison on Digital Platforms, SPD /usr/lib/cmplrs/ada_nnn[1] X Window System and Motif /examples Examples /usr/lib/cmplrs/ada_nnn[1]/lib DEC Ada Run-Time Library /usr/lib/cmplrs/ada_nnn[1]/lib Predefined Ada library /adalib /usr/lib/cmplrs/ada_nnn[1]/lib Sources for the predefined /adalibsrc Ada library [1]The_version_number_of_DEC_Ada__________________________ (continued on next page) Files Installed on Your System B-1 Table_B-1_(Cont.)_DEC_Ada_Directories_____________________ Directory_______________________Contents_of_the_Directory_ /usr/man/man1 Online reference pages for ________________________________DEC_Ada_commands__________ B-2 Files Installed on Your System C ________________________________________________________________ Recovering from Installation Errors This appendix provides information to help you deal with failures or errors that might occur during product installation or product use. C.1 Failures During Product Installation If errors occur during the installation, the system displays failure messages. For example, if the instal- lation fails due to insufficient disk space, the following message appears: There is not enough space for subset ADABASEnnn DEC Ada (ADABASEnnn) 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 The disk space is insufficient. 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 software installation. For information on system software requirements, see Section 1.4.3. Recovering from Installation Errors C-1 C.2 Failures During Product Use If an error occurs while DEC Ada is in use and you believe the error is caused by a problem with the product, report it to Digital. Depending on the nature of the problem and the type of support you have, you can call Digital if your software contract or warranty agreement entitles you to telephone support. Review the Software Product Description (SPD) and Warranty Addendum for an explanation of warranty. If you encounter a problem during the warranty period, report the problem as indicated previously or follow alternate instructions provided by Digital for reporting SPD nonconformance problems. When you prepare to report a problem, please take the following steps: 1. Describe as accurately as possible the circumstances and state of the system when the problem occurred. Include in the description the version number of DEC Ada 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, source files, or relevant data files, and so on. 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 (floppy 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. 6. Report only one problem per report. This will facilitate a faster response. 7. Mail the problem report to Digital. C-2 Recovering from Installation Errors Experience shows that problem reports sometimes do not contain enough information to duplicate or identify the problem. Concise, complete information helps Digital give accurate and timely service to software problems. To obtain information about purchasing Digital support services, please contact your local Digital sales representative. Recovering from Installation Errors C-3 C.3 Documentation Comments and Errors Digital welcomes your comments on this or any other DEC Ada manual. You can send comments in the following ways: o Internet electronic mail: ada_docs@zko.mts.dec.com o FAX: 603-881-0120 Attn: Languages Documentation, ZKO2-3 /K35 o A letter addressed to: Digital Equipment Corporation Languages Documentation, ZK02-3/K35 110 Spit Brook Road Nashua, NH 03062-2698 USA If you have suggestions for improving a particular section or find any errors, please indicate the title, order number, and section (if available). Digital also welcomes general comments. C-4 Recovering from Installation Errors