DIGITAL Capacity Planner for_UNIX_Systems____________________________________ Installation Guide Order Number: AA-QJL5F-TE March 1997 This guide describes how to install the DIGITAL Capacity Planner on an Alpha processor running the Digital UNIX operating system. Revision Information: This guide supersedes the DIGITAL Capacity Planner Installation Guide for Version 4.0 (AA-QJL5E-TE). Operating System: Digital UNIX Version 2.0 to 4.0 Software Version: DIGITAL Capacity Planner Version 4.0A Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ March, 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: ALL-IN-1, BI, Bookreader, DEC, DECbridge, DECmcc, DECnet, DECNIS, DECrouter, DECstation, DECsupport, DECwindows, Digital, HSC, LAN Traffic Monitor, LAT, MSCP, OpenVMS, POLYCENTER, SPM, ULTRIX, VAX, VAX DOCUMENT, VAXcluster, VMS, VMScluster, and the DIGITAL logo. MIPS is a trademark of MIPS Computer Systems, Inc. Motif and OSF/1 are registered trademarks of the Open Software Foundation, Inc. NetView is a registered trademark of International Business Machines Corporation. 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 Ltd. SYSMON is trademark of Spire Technologies/Australian Software Innovations. All other trademarks and registered trademarks are the property of their respective holders. This document is available in printed and CD-ROM versions. This document was prepared using VAX DOCUMENT Version 2.1. _________________________________________________________________ Contents Preface................................................... v 1 Preparing for DIGITAL Capacity Planner Installation 1.1 Reading the Online Release Notes.............. 1-2 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-4 1.4.3 Checking Software Requirements............ 1-4 1.4.4 Determining Which Subsets to Load......... 1-5 1.4.5 Determining Disk Space Requirements....... 1-6 1.4.5.1 Checking Current Disk Space............. 1-7 1.4.5.2 Using Alternative Disks ................ 1-8 1.5 Installing from Media or Using RIS............ 1-8 1.6 Backing Up Your System Disk................... 1-9 1.7 Stopping the Installation..................... 1-9 2 Installing DIGITAL Capacity Planner 2.1 Using CD-ROM Consolidated Distribution Media......................................... 2-1 2.2 Using Tape Media.............................. 2-2 2.3 Using a RIS Distribution Area ................ 2-3 2.4 Responding to Installation Procedure Prompts....................................... 2-3 2.4.1 Selecting Subsets......................... 2-3 2.4.2 Monitoring Displays During the Subset Loading Process........................... 2-5 iii 3 After Installation 3.1 Running the Installation Verification Procedure..................................... 3-1 3.2 Deleting DIGITAL Capacity Planner from Your System........................................ 3-2 3.3 Displaying Documentation from CD-ROM.......... 3-2 A Sample Listings A.1 Sample DIGITAL Capacity Planner Installation .............................................. A-2 A.2 Sample Installation Verification Procedure ... A-3 B Files Installed on Your System C Recovering from Errors C.1 Failures During Product Installation ......... C-1 C.2 Failures During Product Use................... C-2 Index Examples A-1 Installation Log File..................... A-2 A-2 IVP....................................... A-3 Tables 1-1 DIGITAL Capacity Planner Subset Sizes (Kilobytes Required)...................... 1-6 B-1 Installed DIGITAL Capacity Planner Files..................................... B-1 iv _________________________________________________________________ Preface This guide describes how to install the DIGITAL Capacity Planner software on Alpha processors that are running the Digital UNIX operating system. The guide describes the installation of the following DIGITAL Capacity Planner components: o DIGITAL Capacity Planner Data Integrator for UNIX o DIGITAL Capacity Planner for UNIX The installation procedure creates DIGITAL Capacity Planner file systems subordinate to the following directories: o /usr/opt/ECP405 Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall DIGITAL Capacity Planner for any other reason. Intended Audience This guide is intended for system managers who install DIGITAL Capacity Planner. Associated Documentation In addition to this guide, the DIGITAL Capacity Planner documentation set includes the following: o DIGITAL Capacity Planner User's Guide o DIGITAL Capacity Planner Reference Guide v Conventions This guide uses the following conventions: ___________________________________________________________ Convention_____Meaning_____________________________________ # A pound sign (#) is the default superuser prompt. % A percent sign (%) is the default user prompt. 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, pathname, directory, or file. This typeface is also used in interactive examples and other screen displays. UPPERCASE The UNIX-based operating systems lowercase differentiate between lowercase and uppercase letters. Examples, syntax descriptions, function definitions, and literal strings must be typed exactly as shown in the text. 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. vi 1 _________________________________________________________________ Preparing for DIGITAL Capacity Planner Installation This chapter discusses the preparations and requirements needed to install the components of the DIGITAL Capacity Planner for Digital UNIX[1]. The DIGITAL Capacity Planner installation consists of two components, the Data Integrator and the Capacity Planner, which can be installed separately or together on the same node. o The Data Integrator component - Merges UNIX system data from the POLYCENTER Performance Data Collector for UNIX with data for each node represented in that particular data set. The data to be integrated represents the measured data from the running system. You can operate the Data Integrator from the command level or from the Motif interface. See Section 1.4.4 for additional details about the Data Integrator. o The Capacity Planner component - Contains the workload analysis, modeling, and reporting features. You use the files generated by the Data Integrator with the workload classification files to create a base model file. You can access the Workload Analyzer, Modeler, and Data Reporter from the Capacity Planner's Motif interface. Your distribution kit includes a letter titled Read Before Installing DIGITAL Capacity Planner. This letter discusses important information that might not be included in this guide. You should read this letter now. ____________________ [1] Registered Trademark Preparing for DIGITAL Capacity Planner Installation 1-1 1.1 Reading the Online Release Notes DIGITAL Capacity Planner 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 application. The release notes for DIGITAL Capacity Planner are in the following file: o /usr/opt/ECP405/ecp405.release_notes 1.2 Registering Your Software License DIGITAL Capacity Planner includes support for the License Management Facility (LMF). You must register your License Product Authorization Key (PAK) in the License Database (LDB) to use DIGITAL Capacity Planner 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. The valid license is: CAPACITY-PLANNER If you are installing DIGITAL Capacity Planner 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 Capacity Planner, review the PAK status and install the PAKs for any prerequisite or optional software before you install DIGITAL Capacity Planner. 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 1-2 Preparing for DIGITAL Capacity Planner Installation After you register your license, use the following lmf reset 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 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 Capacity Planner software distribution kit. In addition to this guide, the software distribution kit includes the following: o CD-ROM optical disc for systems with optical disc drives o CD-ROM booklet and CD-ROM read first letter o Media tape for systems with tape drives o Read Before Installing cover letter 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 Capacity Planner. Installing DIGITAL Capacity Planner, including running the Installation Verification Procedure (IVP), takes approximately 3 to 5 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 Capacity Planner software and to register the license PAK. Preparing for DIGITAL Capacity Planner Installation 1-3 1.4.2 Checking Hardware Requirements To install DIGITAL Capacity Planner, you need the following hardware: o Software distribution device (if installing from media) Locate the CD-ROM drive for the software distribution media. The CD-ROM booklet or the documentation for the drive you are using explains how to load the media. o Terminal 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 DIGITAL Capacity Planner Software Product Description (SPD) for additional hardware requirements. 1.4.3 Checking Software Requirements DIGITAL Capacity Planner Version 4.0A requires the Digital UNIX operating system Version 2.0 to 4.0. Future DIGITAL Capacity Planner 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 minimum version of the operating system required. DIGITAL Capacity Planner also requires that the following base software subsets be loaded on the system where you install DIGITAL Capacity Planner: o OSFBASE To install the DIGITAL Capacity Planner reference pages, the following software subsets must be installed on the system where you install DIGITAL Capacity Planner: o OSFDCMT 1-4 Preparing for DIGITAL Capacity Planner Installation To check whether these subsets are loaded, follow these steps: 1. Log in to the system where you will install DIGITAL Capacity Planner. 2. Enter the following command: # setld -i | egrep 'OSFBASE' 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 Check the displayed rows for the name of the relevant subset and any related patches. The word installed is displayed in a row after the subset identifier when a subset is loaded. If the word installed is not displayed (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 Capacity Planner. (For information on how to load the operating system software, see the Guide to Installing Digital UNIX.) 1.4.4 Determining Which Subsets to Load You must choose the DIGITAL Capacity Planner subsets you want to load. The DIGITAL Capacity Planner subsets have the following titles: o DIGITAL Capacity Planner Device Database ECPBASE405 The ECPBASE405 subset contains the online documentation, system message files, and device database files that are common to all subsets. This mandatory subset is automatically installed. o DIGITAL Capacity Planner Data Integrator ECPINTE405 The ECPINTE405 subset contains the files that are required to operate the Data Integrator from the command line and from the Motif interface. The Data Integrator can be installed on any system. You must install the Data Integrator on the same system as the Capacity Planner, otherwise you cannot access its Motif interface when you run the Capacity Planner. Preparing for DIGITAL Capacity Planner Installation 1-5 o DIGITAL Capacity Planner Data Collector ECPDC405 The ECPDC405 subset contains data collection files. o DIGITAL Capacity Planner ECPPLAN405 The ECPPLAN405 subset contains the files that are required to operate the Capacity Planner Motif interface. 1.4.5 Determining Disk Space Requirements Table 1-1 lists the disk space requirements for loading DIGITAL Capacity Planner software subsets. These requirements apply to the disks where you load the DIGITAL Capacity Planner 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 DIGITAL Capacity Planner Subset Sizes (Kilobytes __________Required)________________________________________ Subset_Title____Subset_Name___/var/opt/kits________________ Device ECPBASE405 2,304 Database Capacity ECPPLAN405 5,327 Planner Data ECPINTE405 4,608 Integrator Data Collector ECPDC405 639 ________________Total_Size____7,177________________________ 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 DIGITAL Capacity Planner files will reside. 1-6 Preparing for DIGITAL Capacity Planner Installation 1.4.5.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 DIGITAL Capacity Planner. 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 Capacity Planner 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 Capacity Planner 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 55,892K bytes are free. This free space must accommodate the subset requirements listed in Table 1-1. 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 Capacity Planner 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 Capacity Planner files in /usr/man to the free space displayed in the second line of that list. Preparing for DIGITAL Capacity Planner Installation 1-7 1.4.5.2 Using Alternative Disks The DIGITAL Capacity Planner installation procedure creates the following directories and loads files into subordinate directories: o /usr/opt/ECP405 If the directory in the previous paths does not exist, the installation procedure creates it. If the directory does exist, the installation procedure uses it. If enough disk space is not available for the DIGITAL Capacity Planner 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 Capacity Planner: 1. Log in as superuser. 2. Create the directory where the kit is to be placed: # mkdir /newdisk/ECP405 3. Create a softpath that directs the installation to the new kit area. Enter: # ln -s /newdisk/ECP405 /usr/opt/ECP405 Now when you install the kit, the files are copied to the new path as opposed to the one defined by the installation kit. 1.5 Installing from Media or Using RIS Someone from your site must perform at least one DIGITAL Capacity Planner installation from the distribution medium. Your site system manager can then decide whether to make a DIGITAL Capacity Planner distribution kit available online so that subsequent installations of DIGITAL Capacity Planner can use the Remote Installation Service (RIS). For information on extracting DIGITAL Capacity Planner subsets to a RIS distribution area, see the Guide to Sharing Software on a Local Area Network. 1-8 Preparing for DIGITAL Capacity Planner Installation If you expect to use DIGITAL Capacity Planner 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: o A DIGITAL Capacity Planner network kit is available for use. o Your system is registered as a RIS client. If DIGITAL Capacity Planner subsets are available to you on a RIS server system, you must know the name of that system. For more information on installing DIGITAL Capacity Planner from a RIS distribution area, see Section 2.3. 1.6 Backing Up Your System Disk Digital recommends that you back up your system disk before installing any software. 1.7 Stopping the Installation To stop the installation procedure at any time, press Ctrl /C. You must then delete files created up to this point. The directories and files created during the DIGITAL Capacity Planner installation are listed in Appendix B. Preparing for DIGITAL Capacity Planner Installation 1-9 2 _________________________________________________________________ Installing DIGITAL Capacity Planner This chapter describes how to install DIGITAL Capacity Planner. Before you start the installation, read Chapter 1. You can install DIGITAL Capacity Planner locally (using CD-ROM media) or from a server area. This installation procedure uses the setld command. You must use the setld command twice, once to install the Data Integrator and then to install the Capacity Planner. The installation example describes the process for installing the Capacity Planner. For complete listings of each installation, see Appendix A. If you encounter any failures during installation, see Appendix C. 2.1 Using CD-ROM Consolidated Distribution Media This procedure loads DIGITAL Capacity Planner files on to a disk belonging to the system where you perform the installation. When DIGITAL Capacity Planner is run, its executable images are mapped into memory on your system. Follow these steps to install DIGITAL Capacity Planner 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 Capacity Planner. 3. Make sure you are at the root (/) directory by entering the following command: # cd / Installing DIGITAL Capacity Planner 2-1 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 -dr /dev/ralc /cdrom 5. Enter a setld command that requests the load function (-l) and identifies the directory in the mounted file system where DIGITAL Capacity Planner subsets are located. For example, if the directory location for these subsets is /cdrom/AXP/ECP405/kit, enter the following command: # setld -l /cdrom/AXP/ECP405/kit The installation procedure now displays the names of DIGITAL Capacity Planner subsets and asks you to specify the subsets you want to load. See Section 2.4 to continue the installation. 2.2 Using Tape Media This procedure loads DIGITAL Capacity Planner files on to a disk belonging to the system where you perform the installation. When DIGITAL Capacity Planner is run, its executable images are mapped into memory on your system. Follow these steps to install DIGITAL Capacity Planner from tape media: 1. Determine the name of the tape drive by entering this command: # ls -l /dev/rmt* 2. Enter a setld command that requests the load function (-l) and identifies the tape containing the DIGITAL Capacity Planner subsets. For example, if the tape that contains the subsets is /dev/rmtNh, where N represents the device number, enter the following command: # setld -l /dev/rmtNh The installation procedure now displays the names of DIGITAL Capacity Planner subsets and asks you to specify the subsets you want to load. 2-2 Installing DIGITAL Capacity Planner See Section 2.4 to continue the installation. 2.3 Using a RIS Distribution Area If you are installing DIGITAL Capacity Planner subsets that reside in an /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 DIGITAL Capacity Planner. 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) and identifies the system where the DIGITAL Capacity Planner subsets are located. For example, if you are loading DIGITAL Capacity Planner 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 you want to load. See Section 2.4 to continue the installation. 2.4 Responding to Installation Procedure Prompts This section explains the installation procedure prompts and displays. 2.4.1 Selecting Subsets You must specify which DIGITAL Capacity Planner 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. ______________________________________________________ Installing DIGITAL Capacity Planner 2-3 # setld -l ./ECP405 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 CP Capacity Planner 2) DIGITAL CP Data Collector 3) DIGITAL CP Data Integrator 4) DIGITAL CP Device Database Enter your choices or press RETURN to display the next screen. Choices (for example, 1 2 4-6): 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): 5 If you specify more than one number at the prompt, separate each number with a space, not a comma. Next, the script lets you verify your choice. For example, if you enter 5 in response to the previous prompt, you will see the following display: You are installing the following optional subsets: DIGITAL CP Capacity Planner DIGITAL CP Data Collector DIGITAL CP Data Integrator DIGITAL CP Device Database Is this correct? (y/n): y 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-4 Installing DIGITAL Capacity Planner 2.4.2 Monitoring Displays During the Subset Loading Process The installation procedure loads and verifies the selected DIGITAL Capacity Planner subsets. The following example shows a display where the DIGITAL Capacity Planner subsets are being loaded: Checking file system space required to install selected subsets: DIGITAL CP Device Database Copying from ./ECP405 (disk) Verifying DIGITAL CP Capacity Planner Copying from ./ECP405 (disk) Verifying DIGITAL CP Data Integrator Copying from ./ECP405 (disk) Verifying DIGITAL CP Data Collector Copying from ./ECP405 (disk) Verifying # 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 3 explains how to run the IVP after installation, and how to delete old DIGITAL Capacity Planner subsets before installing a new version of DIGITAL Capacity Planner. Installing DIGITAL Capacity Planner 2-5 3 _________________________________________________________________ After Installation This chapter explains what you need to do after the installation to make DIGITAL Capacity Planner ready for use. 3.1 Running the Installation Verification Procedure After installing DIGITAL Capacity Planner, 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 DIGITAL Capacity Planner. The DIGITAL Capacity Planner IVP verifies the installation by checking the system for all required files for each subset. ________________________ Note ________________________ The IVP must be performed physically at the server. If performed remotely (telnet), the expected displays do not come up and the IVP fails. ______________________________________________________ To run the IVP after an installation, enter the following command: # setld -v ECPBASE405 ECPINTE405 ECPPLAN405 ECPDC405 In this command, you can use any DIGITAL Capacity Planner subset. For a sample DIGITAL Capacity Planner 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. After Installation 3-1 3.2 Deleting DIGITAL Capacity Planner from Your System If you must remove a version of DIGITAL Capacity Planner from your system, delete each subset that you previously installed. To delete subsets: 1. Log in as superuser (login name root). 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 | egrep 'ECP' 4. Look for the word installed in the listing displayed, and then delete the installed subsets. In this command, 405 is the version number. For example: # setld -d ECPPLAN405 ECPINTE405 ECPBASE405 ECPDC405 3.3 Displaying Documentation from CD-ROM The DIGITAL Capacity Planner documentation is provided on the 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. 3-2 After Installation A _________________________________________________________________ Sample Listings This appendix provides sample listings for the following procedures: o An installation of DIGITAL Capacity Planner (see Section A.1) o An Installation Verification Procedure (IVP) (see Section A.2) Sample Listings A-1 A.1 Sample DIGITAL Capacity Planner Installation Example A-1 contains a sample installation log file. Example A-1 Installation Log File # setld -l ./ECP405 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 CP Capacity Planner 2) DIGITAL CP Data Collector 3) DIGITAL CP Data Integrator 4) DIGITAL CP Device Database Enter your choices or press RETURN to display the next screen. Choices (for example, 1 2 4-6): 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 3 4-6): 5 You are installing the following optional subsets: DIGITAL CP Capacity Planner DIGITAL CP Data Collector DIGITAL CP Data Integrator DIGITAL CP Device Database Is this correct? (y/n): y Checking file system space required to install selected subsets: DIGITAL CP Device Database Copying from ./ECP405 (disk) Verifying (continued on next page) A-2 Sample Listings Example A-1 (Cont.) Installation Log File DIGITAL CP Capacity Planner Copying from ./ECP405 (disk) Verifying DIGITAL CP Data Integrator Copying from ./ECP405 (disk) Verifying DIGITAL CP Data Collector Copying from ./ECP405 (disk) Verifying # A.2 Sample Installation Verification Procedure Example A-2 contains a sample IVP. Example A-2 IVP # setld -v ECPBASE405 ECPINTE405 ECPPLAN405 ECPDC405 DIGITAL CP Device Database (ECPBASE405) Capacity Planner: Device Database IVP IVP completed successfully DIGITAL CP Data Integrator (ECPINTE405) Data Integrator IVP IVP completed successfully DIGITAL CP Data Collector (ECPDC405) Data Integrator IVP IVP completed successfully DIGITAL CP Capacity Planner (ECPPLAN405) Capacity Planner IVP IVP completed successfully # Sample Listings A-3 B _________________________________________________________________ Files Installed on Your System Table B-1 describes the contents of DIGITAL Capacity Planner directories. Table_B-1_Installed_DIGITAL_Capacity_Planner_Files_______________ Directory___________File______________Description________________ /usr/opt/ECP405 reduce Data Integrator /usr/opt/ECP405 ecp405.release_ Capacity Planner release notes notes /usr/opt/ECP405 ecp_axp_appl.dba Alpha migration database /usr/opt/ECP405 ecp_ Alpha OSF/1 CPU database axposfcpu.dba /usr/opt/ECP405 ecp_ Alpha VMS CPU database axpvmscpu.dba /usr/opt/ECP405 ecp_axpvmscpu_ Alpha VMS CPU mapping map.dba database /usr/opt/ECP405 ecp_ci.dba CI device database /usr/opt/ECP405 ecp_dc.uid DECwindows definition file for Data Collector /usr/opt/ECP405 ecp_di.uid DECwindows definition file for DI /usr/opt/ECP405 ecp_disk.dba Disk database file /usr/opt/ECP405 ecp_dssi.dba DSSI database file /usr/opt/ECP405 ecp_fddi.dba FDDI database file /usr/opt/ECP405 ecp_hsc.dba HSC database file /usr/opt/ECP405 ecp_ioview.uid DECwindows definition file /usr/opt/ECP405 ecp_labels.msg Help labels file (continued on next page) Files Installed on Your System B-1 Table_B-1_(Cont.)_Installed_DIGITAL_Capacity_Planner_Files_______ Directory___________File______________Description________________ /usr/opt/ECP405 ecp_main.uid DECwindows definition file /usr/opt/ECP405 ecp_messages.msg Error message file /usr/opt/ECP405 ecp_model.uid DECwindows definition file /usr/opt/ECP405 ecp_network.base Sample network data file /usr/opt/ECP405 ecp_ni.dba NI device database /usr/opt/ECP405 ecp_ Bookreader help profile.decw_ book /usr/opt/ECP405 ecp_ Bookreader help profile.decw_ bookshelf /usr/opt/ECP405 ecp_report.uid DECwindows definition file /usr/opt/ECP405 ecp_scsi.dba SCSI database file /usr/opt/ECP405 ecp_server.dba Disk server database file /usr/opt/ECP405 ecp_sys_ DECwindows definition file stats.uid /usr/opt/ECP405 ecp_ DECwindows definition file systemview.uid /usr/opt/ECP405 ecp_text.hlp Text help file /usr/opt/ECP405 ecp_topview.uid DECwindows definition file /usr/opt/ECP405 ecp_vaxcpu.dba VAX VMS CPU database /usr/opt/ECP405 ecp_wc.uid DECwindows definition file /usr/lib/X11/app- ECP DECwindows customization defaults file /usr/opt/ECP405 decapi.options Options file for use with Bsysmon command /usr/opt/ECP405 dict.digitalunix SYSMON data extraction dictionary /usr/opt/ECP405 dict.aix SYSMON data extraction dictionary (continued on next page) B-2 Files Installed on Your System Table_B-1_(Cont.)_Installed_DIGITAL_Capacity_Planner_Files_______ Directory___________File______________Description________________ /usr/opt/ECP405 dict.hpux SYSMON data extraction dictionary /usr/opt/ECP405 dict.solaris SYSMON data extraction dictionary /usr/opt/ECP405 plan Capacity Planner /usr/opt/ECP405 plan.1 Plan manpage /usr/opt/ECP405 reduce Data Integrator Motif Interface /usr/opt/ECP405 reduce.1 Reduce manpage /usr/man/man1 reduce.1 Link to reduce.1 manpage in kit directory /usr/man/man1 plan.1 Link to plan.1 manpage in kit directory /usr/bin plan Link to plan in kit directory /usr/bin reduce Link to di_fe in kit directory /usr/bin____________snapshot__________Data_collector_____________ Files Installed on Your System B-3 C _________________________________________________________________ Recovering from Errors 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, fill out and submit the Reader's Comments form at the back of the document that contains the error. Include the 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, the following message is displayed: There is not enough space for subset ECPPLAN405 DIGITAL Capacity Planner (ECPPLAN405) 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 There is insufficient disk space. For descriptions of error messages generated by these conditions, see the Digital UNIX documentation on system messages, recovery procedures, and Digital UNIX software installation. For information on system software requirements, see Section 1.4.3. Recovering from Errors C-1 C.2 Failures During Product Use If an error occurs while DIGITAL Capacity Planner is in use and you believe the error is caused by a problem with the product, take one of the following actions: o If you have a Software Product Services Support Agreement, contact your Customer Support Center (CSC) by telephone or by using the electronic means provided with your support agreement (such as DSNlink). The CSC provides telephone support for high-level advisory and remedial assistance. When you initially contact the CSC, indicate the following: - The name and version number of the operating system you are using - The version number of DIGITAL Capacity Planner you are using - The hardware system you are using (such as a model number) - A brief description of the problem (one sentence if possible) - How critical the problem is o If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR). o If you do not have any type of software services support agreement and you purchased DIGITAL Capacity Planner within the past year, you can submit an SPR if you think the problem is caused by a software error. When you submit an SPR, take the following steps: 1. Describe as accurately as possible the circumstances and state of the system when the problem occurred. Include the description and version number of the DIGITAL Capacity Planner 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, INCLUDE files, or relevant data files, and so forth. 4. Provide a listing of the program. C-2 Recovering from Errors 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 SPR. This will facilitate a faster response. 7. Mail the SPR package to Digital. If the problem is related to DIGITAL Capacity Planner documentation, you can do one of the following: o Report the problem to the CSC (if you have a Software Product Services Support Agreement and the problem is severe). o Fill out the Reader's Comments form (in the back of the document that contains the error) and send the form to Digital. Be sure to include the section and page number where the error occurred. Recovering from Errors C-3 _________________________________________________________________ Index A______________________________ H______________________________ Alternative disks, using, 1-8 Hardware required, 1-4 C______________________________ I______________________________ Capacity Planner license name, Installation 1-2 errors, C-1 CD-ROM media, installing from, from a RIS distribution area, 2-1 2-3 from CD-ROM, 2-1 D______________________________ from tape, 2-2 Deleting previous procedures, 2-1 to 2-5 installations, 3-2 requirements, 1-3 to 1-9 Disk space sample listing, A-2 checking availability, 1-6 specifying subsets, 2-3 required, 1-6 stopping, 1-9 using alternative disks for, subset loading, 2-5 1-8 Installation Verification Documentation, displaying, 3-2 Procedure (IVP) running, 3-1 F sample listing, A-3 _______________________________ Failures, responding to K______________________________ during installation, C-1 Kit contents, 1-3 during product use, C-2 Files documentation Bookreader, L______________________________ 3-2 License installed, B-1 name, 1-2 PAK requirements, 1-2 registration, 1-2 Index-1 License Management Facility requirements, 1-8 (LMF), 1-2 Loading subsets, 1-5 S______________________________ O Sample listing _______________________________ installation, A-2 Operating system version IVP, A-3 required, 1-4 Software required, 1-4 Software subsets P______________________________ deleting, 3-2 Prerequisites, 1-3 to 1-9 loading, 1-5, 2-5 Privileges required, 1-3 optional, 1-5 required, 1-4, 1-5 specifying, 2-3 R______________________________ Stopping installation, 1-9 Release notes, location of, System disk, 1-9 1-2 Remote Installation Service T______________________________ (RIS) Tape media, installing from, installing from a 2-2 distribution area, 2-3 Time required, 1-3 Index-2