POLYCENTER Capacity Planner for_OpenVMS_Systems_________________________________ Installation Guide Order Number: AA-PH6MH-TE November 1996 This guide describes how to install POLYCENTER Capacity Planner on an Alpha processor running OpenVMS Alpha and on a VAX system running OpenVMS VAX. Revision Information: This guide supersedes the POLYCENTER Capacity Planner Installation Guide for Version 3.2 (AA- PH6MG-TE). Operating System: OpenVMS VAX Version 5.0 to 5.5-2, and 6.0 to 6.2 OpenVMS Alpha Version 6.0 to 6.2 Software Version: POLYCENTER Capacity Planner Version 4.0 Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ November, 1996 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 1996. 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 trademkark of UNIX System Laboratories, Inc., a wholly owned subsidiary of Novell, Inc. 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 POLYCENTER Capacity Planner Installation 1.1 Registering Your Software License............. 1-2 1.2 Required Operating System Components and Software...................................... 1-3 1.3 VMScluster Considerations..................... 1-6 1.4 Installation Procedure Requirements........... 1-6 1.4.1 Privileges................................ 1-7 1.4.2 System Parameters......................... 1-7 1.4.3 Disk Space................................ 1-8 1.4.4 Backing Up Your System Disk............... 1-9 1.5 Standard System Maintenance Procedures........ 1-10 1.5.1 Checking System Parameter Values.......... 1-10 1.5.2 Calculating the Values for Global Pagelets and Global Sections....................... 1-10 1.5.3 Changing System Parameter Values with AUTOGEN................................... 1-13 2 Installing POLYCENTER Capacity Planner 2.1 Online Release Notes.......................... 2-1 2.2 Installation Procedure........................ 2-1 iii 3 After Installation 3.1 Startup Procedure............................. 3-1 3.2 Starting the Software......................... 3-2 3.3 Disk Space Required after Installation........ 3-2 3.4 Privileges Required after Installation........ 3-3 3.5 File Access................................... 3-3 3.6 Maintenance Updates........................... 3-5 3.7 Installation Verification..................... 3-5 4 Error Recovery and Problem Reporting 4.1 Error Recovery................................ 4-1 4.2 Problem Evaluation and Reporting.............. 4-5 A Sample Installation Dialogues A.1 Dialogue for OpenVMS VAX...................... A-2 A.2 Dialogue for OpenVMS Alpha.................... A-7 B Created and Modified Files Index Examples A-1 OpenVMS VAX System Installation Log....... A-2 A-2 OpenVMS Alpha System Installation Log..... A-7 Tables 1-1 POLYCENTER Capacity Planner Licenses...... 1-2 1-2 Required Operating System Components ..... 1-3 1-3 Required and Optional Software............ 1-5 1-4 Minimum Required System Parameter Values.................................... 1-7 1-5 Required Disk Space During Installation (Alpha)................................... 1-9 1-6 Required Disk Space During Installation (VAX)..................................... 1-9 iv 3-1 Required Disk Space after Installation (Alpha)................................... 3-2 3-2 Required Disk Space after Installation (VAX)..................................... 3-2 3-3 Privileges Required after Installation.... 3-3 3-4 File Access............................... 3-3 4-1 Error Recovery for ECP Messages........... 4-1 4-2 Error Recovery for PSCP Messages.......... 4-3 B-1 Event Monitor Files....................... B-1 B-2 Data Integrator Files..................... B-2 B-3 Capacity Planner Files.................... B-3 B-4 Common Files.............................. B-6 v _________________________________________________________________ Preface This guide describes how to install the POLYCENTER Capacity Planner software on Alpha and VAX processors that are running the OpenVMS operating system. The guide describes the installation of the following POLYCENTER Capacity Planner components: o POLYCENTER Capacity Planner Event Monitor Data Collector for OpenVMS Alpha o POLYCENTER Capacity Planner Data Integrator for OpenVMS Alpha and VAX o POLYCENTER Capacity Planner for OpenVMS Alpha and VAX To install the POLYCENTER Capacity Planner Event Monitor Data Collector for OpenVMS VAX, use the POLYCENTER Performance Data Collector Installation software for Version 2.2. Keep this guide with your distribution kit. You will need it to install maintenance updates or to reinstall POLYCENTER Capacity Planner for any other reason. Intended Audience This guide is intended for system managers who install POLYCENTER Capacity Planner. Associated Documentation In addition to this guide, the POLYCENTER Capacity Planner information set includes these documents: o POLYCENTER Capacity Planner User's Guide o POLYCENTER Capacity Planner Reference Guide v The Read Before Installing POLYCENTER Capacity Planner cover letter is provided with this installation guide on the Compact Disc or in hardcopy form, depending on your kit's distribution method. Other related documents are: o POLYCENTER Performance Data Collector Installation Guide o POLYCENTER Performance Data Collector and Utilities User's Guide o POLYCENTER Performance Data Collector and Utilities Quick Reference Guide o POLYCENTER Performance Advisor User's Guide o POLYCENTER Performance Advisor Quick Reference Guide o VMS System Generation Utility Manual o OpenVMS System Manager's Manual: Part 1 and Part 2 o VMS License Management Utility Manual Conventions This guide uses the following conventions: ___________________________________________________________ Convention___Meaning_______________________________________ UPPERCASE Uppercase letters indicate the name of a command, file, parameter, procedure, or utility. user input In interactive examples, this typeface indicates input entered by the user. system This typeface indicates a prompt or displayed text. $ The dollar sign indicates the DCL prompt. This prompt may be different on your system. Ctrl/X In procedures, a sequence such as Ctrl/X indicates that you must press the key labeled Ctrl while you press another key or a pointing device button. Indicates that you press the Return key. vi ___________________________________________________________ Convention___Meaning_______________________________________ VAX The VAX margin note denotes the beginning of a section specific to OpenVMS VAX. Alpha The Alpha margin note denotes the beginning of _____________a_section_specific_to_OpenVMS_Alpha.__________ vii 1 _________________________________________________________________ Preparing for POLYCENTER Capacity Planner Installation This chapter discusses the preparations and requirements needed to install the components of the POLYCENTER Capacity Planner. The POLYCENTER Capacity Planner installation consists of three components: o Event Monitor for OpenVMS Alpha o Data Integrator for OpenVMS Alpha and VAX o Capacity Planner for OpenVMS Alpha and VAX You may install these components separately or together on the same node. The Event Monitor Data Collector gathers nonaveraged, per- process, per-transaction event data that may be combined with averaged daily data collected by the Performance Data Collector. The Event Monitor Data Collector can be operated either from the DCL or from the DECwindows Motif interface. The Data Integrator component merges OpenVMS system data from the POLYCENTER Performance Data Collector with data from the POLYCENTER Capacity Planner Event Monitor Data Collector to create a single file that represents the measured data from the running system. The Data Integrator can be operated either from the DCL or from the DECwindows Motif interface. The Capacity Planner component contains the workload analysis, performance modeling, and reporting features. You use the data files generated by the Data Integrator component 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 DECwindows Motif interface. Preparing for POLYCENTER Capacity Planner Installation 1-1 Your distribution kit includes a letter titled Read Before Installing POLYCENTER Capacity Planner. This letter discusses important information that might not be included in this guide. You should read this letter now. 1.1 Registering Your Software License To use the POLYCENTER Capacity Planner software, you must have a registered license on the system or cluster node. Table 1-1 contains valid licenses for this product. Table_1-1_POLYCENTER_Capacity_Planner_Licenses_____________ Module________System___License_____________________________ Event Alpha, DECPS-DC Monitor VAX Data Alpha, CAPACITY-PLANNER Integrator VAX Capacity Alpha, CAPACITY-PLANNER Planner_______VAX__________________________________________ On a newly licensed node or cluster, you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). 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 POLYCENTER Capacity Planner as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements. If you are installing prerequisite or optional software along with POLYCENTER Capacity Planner, review the PAK status and install the PAKs for any prerequisite or optional software before you install POLYCENTER Capacity Planner. Digital recommends that you register the license before you start the installation. Registering before installation allows you to use the Installation Verification Procedure (IVP) during installation. The installation can complete without the license, and you have the option to use the 1-2 Preparing for POLYCENTER Capacity Planner Installation IVP after installation. However, the POLYCENTER Capacity Planner software will not operate without a registered license. To register a license, first log in to the system manager's account, under SYSTEM. You then have a choice of two ways to perform the registration: o Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When it prompts you for information, respond with data from your License PAK. o At the DCL prompt, enter the LICENSE REGISTER command with the appropriate qualifiers that correspond to License PAK information. For each VMScluster node on which you want to use the POLYCENTER Capacity Planner, you will need to register a license on that node. For complete information on how to use LMF, see the OpenVMS License Management Utility Manual. 1.2 Required Operating System Components and Software Alpha The OpenVMS operating system comes with a variety of support options, or classes. Classes include such features as networking and RMS journaling. POLYCENTER Capacity Planner Version 4.0 requires OpenVMS Version 6.0 to 6.2, including the classes listed in Table 1-2. Table_1-2_Required_Operating_System_Components_____________ Class__________Purpose_____________________________________ Network To allow remote processing of data files support Programming To link system object libraries support System To link operating system version dependent programming symbols support Secure user's To support batch queue command procedures environment Utilities______For_online_help_and_various_terminal_support Preparing for POLYCENTER Capacity Planner Installation 1-3 VAX Versions 5.0 to 5.5-2 and 6.0 to 6.2 of the OpenVMS operating system must be running before this software kit is installed. To display the operating system version, enter the following command: $ SHOW SYSTEM 1-4 Preparing for POLYCENTER Capacity Planner Installation Table 1-3 provides information on the software you must have installed on your system before installing POLYCENTER Capacity Planner. The table also includes information about optional software that you can use with POLYCENTER Capacity Planner. The SSA contains a complete list of prerequisite and optional software and their required version. Table_1-3_Required_and_Optional_Software___________________ Required_Products___Purpose________________________________ DECwindows Motif Required to display the user interface V1.1.3 for OpenVMS VAX or V1.2-3 or later DECwindows Motif Required to display the user interface V1.2-3 for OpenVMS Alpha or later ___________________________________________________________ Optional_Products___Purpose________________________________ POLYCENTER Source for .CPD data files Performance Advisor Data Collector V2.1 or V2.2 POLYCENTER Performance management analysis tool Performance Advisor V2.1 or V2.2_______________________________________________________ The POLYCENTER Performance Data Collector also installs the POLYCENTER Capacity Planner Event Monitor Data Collector for OpenVMS VAX. The Data Integrator component (for OpenVMS platforms) combines the data gathered from the Performance Data Collector and the Event Monitor to produce a single data file that comprises part of the data set required for building models. If the DECwindows Motif software is not running on the system, you cannot display the windows version of the Event Monitor or the Data Integrator. You can, however, use the DCL commands to perform the functions available from the windowing interface. Preparing for POLYCENTER Capacity Planner Installation 1-5 The DCL interface is always installed, but the DECwindows Motif interface is installed only if the DECwindows Motif software is present. 1.3 VMScluster Considerations For systems that have been running an earlier version of DECps software (now POLYCENTER Performance Solution), remove any DECperformance Solution (DECps) executable image files from node-specific root directories of VAXcluster systems. The system manager may have placed executable files into the root directories of individual nodes, a practice sometimes done during software modification or patching operations. Unless deleted, these files will interfere with the operation of the Performance Solution software being installed. During installation, executable files are placed in the common root directory, SYS$COMMON. POLYCENTER Capacity Planner executable files are named using the following format: ECP$DI_MAIN.EXE (DECwindows version of Data Integrator) ECP$PLAN.EXE (DECwindows version of Capacity Planner) Performance Solution executable files required (and optional) to use the POLYCENTER Capacity Planner are named using the following format: PSDC$file_name.EXE PSPA$file_name.EXE For each node in the VAXcluster system, these files should be removed from: SYS$SPECIFIC:[SYSEXE] SYS$SPECIFIC:[SYSMSG] SYS$SPECIFIC:[SYS$LDR] 1.4 Installation Procedure Requirements This section describes the requirements for installing POLYCENTER Capacity Planner. 1-6 Preparing for POLYCENTER Capacity Planner Installation 1.4.1 Privileges This installation requires the standard privileges to run the VMSINSTAL Utility. To install the software, you need access to one of the following accounts: o The SYSTEM account o An account with the SETPRV privilege ________________________ Note ________________________ VMSINSTAL turns off BYPASS privilege at the start of the installation. ______________________________________________________ 1.4.2 System Parameters Table 1-4 lists the minimum required system parameter values for the installation. Depending on the kinds of programs and applications running at your site, you might need higher values for some settings. Table_1-4_Minimum_Required_System_Parameter_Values_________ System Parameter________Minimum_Value_____________________________ VIRTUALPAGECNT 25K WSMAX____________2048______________________________________ ________________________ Note ________________________ If you do not ensure that your system has the necessary global pagelets and global section SYSGEN parameters for the installation, the DCL tables can become corrupted in some situations. ______________________________________________________ Preparing for POLYCENTER Capacity Planner Installation 1-7 1.4.3 Disk Space The POLYCENTER Capacity Planner installs the utilities normally installed by the Performance Data Collector unless it already resides on the system. Block sizes in the following tables refer to the space required on the system disk. The sizes are approximate; actual sizes may vary depending on your system environment, configuration, and software options. The installation software checks for the peak disk space requirement regardless of which options you choose to install. The term peak refers to the space required during the installation. If your disk does not have enough space to support the peak requirement, you cannot install the software. The term net refers to the space required to run the software after the installation. 1-8 Preparing for POLYCENTER Capacity Planner Installation Alpha Table 1-5 contains the blocks required during installation to install the Capacity Planner components. Table_1-5_Required_Disk_Space_During_Installation_(Alpha)__ Components_______Peak_Use__Net_Use_________________________ Event Monitor 3,000 Data Integrator 3,700 Capacity 7,000 Planner All_components___33,000____13,000__________________________ VAX Table 1-6 contains the blocks required during installation to install the Capacity Planner components. Table_1-6_Required_Disk_Space_During_Installation_(VAX)____ Component________Peak_Use__Net_Use_________________________ Data Integrator 3,500 Capacity 6,500 Planner V4.0 All_components___27,000____10,000__________________________ To check for available disk space on your system disk, enter the command: $ SHOW DEVICE SYS$SYSDEVICE 1.4.4 Backing Up Your System Disk At the beginning of the installation, VMSINSTAL asks if you have backed up your system disk. Digital recommends that you do a system disk backup before installing any software. Use the backup procedures that are established at your site. For details on performing a system disk backup, see the section on the Backup Utility in the OpenVMS System Management Subkit. Preparing for POLYCENTER Capacity Planner Installation 1-9 1.5 Standard System Maintenance Procedures This section explains how to do some standard procedures: o Check system parameter values (see Section 1.5.1) o Calculate values for global pagelets and global sections (see Section 1.5.2) o Change parameter values with the OpenVMS AUTOGEN command procedure (see Section 1.5.3) 1.5.1 Checking System Parameter Values To check the values of your system parameters, enter the following command at the DCL prompt to invoke the System Generation Utility (SYSGEN): $ RUN SYS$SYSTEM:SYSGEN SYSGEN> At the SYSGEN> prompt, enter the SHOW command to display the value of a system parameter. The following example displays the value for the WSMAX system parameter: SYSGEN> SHOW WSMAX After checking the parameters with the SHOW command, enter the EXIT command at the SYSGEN> prompt to return to DCL level. 1.5.2 Calculating the Values for Global Pagelets and Global Sections Alpha To install and run POLYCENTER Capacity Planner, you must have sufficient free global pagelets and global sections. You must first find out how many free global pagelets and sections you have on your system. Then use AUTOGEN if you need to increase the global pagelets and global sections system parameters. Enter the following DCL command to determine the number of global pagelets required by SYS$LIBRARY:DCLTABLES.EXE: $ DIR/SIZE SYS$LIBRARY:DCLTABLES.EXE This command returns the size (in blocks) of SYS$LIBRARY:DCLTABLES.EXE. As an approximation, use this figure as the number of global pagelets for the file. 1-10 Preparing for POLYCENTER Capacity Planner Installation You can use the WRITE command with the F$GETSYI lexical function to find the number of free global pagelets and global sections. The following example shows how to get this information at your terminal (the default for SYS$OUTPUT): $ WRITE SYS$OUTPUT F$GETSYI("CONTIG_GBLPAGES") 15848 $ WRITE SYS$OUTPUT F$GETSYI("FREE_GBLSECTS") 24 If the values displayed by the system are greater than the values in Table 4-1, you do not need to increase the values for these parameters. If the value of free global pagelets or global sections is less than the value in Table 4-1, you must increase the system parameter setting. Section 1.5.3 describes the procedures for increasing these values using AUTOGEN. VAX During the POLYCENTER Capacity Planner installation, VMSINSTAL creates a new copy of the DCL command tables that includes the ADVISE command. For VMSINSTAL to complete this process successfully, your system must have available enough unused global sections and global pages. To determine the number of global pages and global sections that the DCL tables use at your site require, enter the following commands: $ INSTALL INSTALL> LIST SYS$LIBRARY:DCLTABLES.EXE/GLOBAL The output generated is similar to the following: DCLTABLES;219 Open Hdr Shar Lnkbl System Global Sections DCLTABLES_001 (06000000) PRM SYS Pagcnt/Refcnt=484/21296 In this example, the DCL command table uses 1 global section, as indicated by the single entry DCLTABLES_001. It also uses 484 global pages, indicated by the Pagcnt. Therefore, to replace your DCL command table to include the Performance Solution ADVISE command, this system needs a minimum of 1 unused global section and 484 unused global pages. Preparing for POLYCENTER Capacity Planner Installation 1-11 To calculate the number of unused global sections, enter the following command: INSTALL> LIST/GLOBAL/SUMMARY Summary of Local Memory Global Sections 299 Global Sections Used, 32316/12684 Global Pages Used/Unused In this example, there are 299 used global sections and 12684 unused global pages. Because this system requires 484 global pages to replace its DCL command table and 12684 are available, the GBLPAGES parameter does not need to be increased. To check the current value of GBLSECTIONS, enter the following sequence of commands: $ RUN SYS$SYSTEM:SYSGEN SYSGEN> USE CURRENT SYSGEN> SHOW GBLSECTIONS These commands produce output similar to the following: Parameter Name Current Default Minimum Maximum Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- GBLSECTIONS 500 128 20 4095 Sections To make the calculation for this system, subtract the number of used GBLSECTIONS from the number of current GBLSECTIONS. For example: 500 - 299 = 201 unused sections Because this system required only 1 global section to replace its DCL command tables and there are 201 unused global sections, the value of the SYSGEN parameter GBLSECTIONS would not need to be altered. If you need to change the number of global pages or sections, invoke AUTOGEN after entering the new parameter values in SYS$SYSTEM:MODPARAMS.DAT. 1-12 Preparing for POLYCENTER Capacity Planner Installation 1.5.3 Changing System Parameter Values with AUTOGEN Use the AUTOGEN command procedure to change system parameters. AUTOGEN automatically adjusts values for parameters that are associated with the values you reset manually. To change system parameters with AUTOGEN, edit the following file: SYS$SYSTEM:MODPARAMS.DAT To change a parameter value listed in this file, delete the current value associated with that parameter and enter the new value. To add a new parameter, add a line to the file that includes the name of the parameter and its value. For example: WSMAX = 8096 To modify incremental parameters such as free global pagelets and global sections, use the ADD_ prefix. The following example increases the global page setting by 2000: ADD_GBLPAGES = 2000 ________________________ Note ________________________ When you set the page file quota, do not use a value that exceeds the amount of page file space available on the system. ______________________________________________________ After you make all your changes, exit from the editor and execute the AUTOGEN procedure to recalculate your system parameters. The following command recalculates your system parameters and reboots the system: $ @SYS$UPDATE:AUTOGEN GETDATA REBOOT When you specify REBOOT, AUTOGEN performs an automatic system shutdown and then reboots the system. Any users logged on to the system are immediately disconnected during the shutdown. The automatic reboot puts the new parameter values into effect. Preparing for POLYCENTER Capacity Planner Installation 1-13 The Autogen Utility automatically adjusts some of the SYSGEN parameters based on the consumption of resources since the last reboot. If you do not want to take advantage of this automatic adjustment, include the NOFEEDBACK qualifier on the AUTOGEN command line. For more information about using AUTOGEN, see the OpenVMS System Management Subkit. 1-14 Preparing for POLYCENTER Capacity Planner Installation 2 _________________________________________________________________ Installing POLYCENTER Capacity Planner After you register and load the license PAK, the installation takes between five and fifteen minutes depending on the system and options selected. This chapter describes the installation of the Event Monitor, Data Integrator, and Capacity Planner components. If you encounter any failures during installation, see Chapter 4. 2.1 Online Release Notes The POLYCENTER Capacity Planner software provides online release notes. To display or print the release notes during the installation, choose the OPTIONS N parameter when you invoke VMSINSTAL. (See Appendix A for a sample installation dialogue.) To obtain the release notes after the installation, display or print this file: o SYS$HELP:ECP040.RELEASE_NOTES 2.2 Installation Procedure If it is not already inserted, place the Compact Disc (CD) media into the CD-ROM drive, or mount the media you received with the software kit onto the appropriate device. To abort the installation procedure at any time, press Ctrl/Y. When you press Ctrl/Y, the installation procedure deletes all the files it has created up to that point and exits. You can then start the installation again. When the system prompts you with a question during the installation procedure, the default answer is often listed in brackets ([]). Installing POLYCENTER Capacity Planner 2-1 This installation procedure decscribes the process for installing the Event Monitor, Data Integrator, and Capacity Planner components. To install POLYCENTER Capacity Planner, perform the following steps: 1. Log in to a privileged account and set your default device and directory to SYS$UPDATE: Username: SYSTEM Password: $ SET DEFAULT SYS$UPDATE 2. Invoke VMSINSTAL: @VMSINSTAL saveset-name device-name option-list VMSINSTAL is in the SYS$UPDATE directory. The elements that you specify when you invoke the VMSINSTAL command procedure are as follows: saveset-name The installation name for the component. For POLYCENTER Capacity Planner, enter the following installation name: ECP040 To obtain the directory location of the POLYCENTER Capacity Planner save set on the CD-ROM, see the OpenVMS Alpha Layered Products Compact Disc User's Guide booklet that accompanies the CD-ROM distribution kit. Another method is to complete these steps before starting installation: a. Enter the following command to determine whether the CD-ROM drive is already mounted: $ SHOW DEVICE DKA400: b. If the drive is not mounted, enter the appropriate MOUNT command to mount the CD-ROM (omit the /FOREIGN qualifier). 2-2 Installing POLYCENTER Capacity Planner c. To obtain the save-set name, use a DIRECTORY command specifying the directory file from the previous command: $ DIRECTORY DKA400:[ECPn]*.A The n represents the minor (point) release number for POLYCENTER Capacity Planner. device-name The name of the device on which you plan to mount the media and the directory containing the POLYCENTER Capacity Planner save set. On some systems this device may be prefaced by nodename$. For example, ddcu is the device name used in examples in this guide. The directory is [ECPn], where n is the release number. To specify the device name on the @VMSINSTAL command line, enter: ddcu:[ECPn] option-list The word OPTIONS followed by one or more of the following option designators-A, G, L, N, R: o Autoanswer option (A) Initially creates a file that contains your answers to VMSINSTAL questions and prompts. You can then use the option (and the answer file) to save time during a reinstallation (typically after upgrading your system). o Get saveset option (G) Lets you store product save sets temporarily on a magnetic tape or in a disk directory. o File log option (L) Logs all activity to the terminal during installation. o Display or print the release notes (N) Indicates that you want to see the installation question on release notes. If you do not include the N option, VMSINSTAL does not ask you about the release notes. You should review the release Installing POLYCENTER Capacity Planner 2-3 notes before proceeding with the installation in case they contain additional information about the installation. If you are restarting the installation and have already reviewed the release notes, you do not need to specify the N option. (Even if you omit the N option when you invoke VMSINSTAL, the POLYCENTER Capacity Planner release notes are copied automatically to the SYS$HELP directory.) o Alternate root option (R) Lets you install the product to a system root other than that of the running system. For detailed information on these software installation options, see the OpenVMS operating system documentation. If you specify more than one option, separate the options with commas, such as: OPTIONS A,N The following example invokes VMSINSTAL to install POLYCENTER Capacity Planner and shows the system response. This example uses the OPTIONS N release notes option. $ @VMSINSTAL ECP040 ddcu:[ECPn] OPTIONS N OpenVMS Alpha Software Product Installation Procedure V1.5 It is dd-mmm-yyyy at hh:mm. Enter a question mark (?) at any time for help. If you do not supply either the product name or the device name, VMSINSTAL prompts you for this information later in the installation procedure. VMSINSTAL does not prompt you for any options, so be sure to include OPTIONS N on the VMSINSTAL command line to access the release notes during the installation. When you invoke VMSINSTAL, it checks the following: o Whether you are logged in to a privileged account. Digital recommends that you install software from the system manager's account with your default device and directory set to SYS$UPDATE. 2-4 Installing POLYCENTER Capacity Planner o Whether you have adequate quotas for installation. VMSINSTAL then checks to determine whether any users are logged in to the system. If users are logged in, VMSINSTAL asks whether you want to continue the installation: * Do you want to continue anyway [NO]? If you want to continue, enter YES. If you want to stop the installation, press Return. 3. Confirm system backup: * Are you satisfied with the backup of your system disk [YES]? If you are satisfied with the backup of your system disk, press Return. Otherwise, enter NO to discontinue the installation. After you back up your system disk, you can restart the installation. Installing POLYCENTER Capacity Planner 2-5 4. Mount the software media: If you omitted the device name on the VMSINSTAL command line, the following prompt is displayed: * Where will the distribution volumes be mounted: ddcu:[ECPn] If this prompt is displayed, enter the name of the distribution (media) device and directory that contains the POLYCENTER Capacity Planner kit (save set). For example, if the media is contained on a CD-ROM located on unit ddcu, enter ddcu:[ECPn] in reply to this question (where n is the minor version number). Depending on the type of device and whether the device is already mounted, the following prompt may or may not be displayed: Please mount the first volume of the set on ddcu. * Are you ready? YES %MOUNT-I-MOUNTED, ddcu mounted If you have not already done so, you should now insert the distribution volume on the device you specified when you invoked VMSINSTAL. The device name is displayed in the line preceding the question. VMSINSTAL then asks if you are ready to continue with the installation. If you respond YES to indicate that you are ready, VMSINSTAL displays a message that the media containing POLYCENTER Capacity Planner has been mounted on the specified device and that the installation has begun. If you entered the wrong device name when you invoked VMSINSTAL and need to restart the installation, enter NO in response to the "Are you ready?" question. To abort the installation for other reasons, press Ctrl/Y. 5. Verify the product being installed: The following products will be processed: ECP Vn.n Beginning installation of ECP Vn.n at hh:mm %VMSINSTAL-I-RESTORE, Restoring product saveset A... 2-6 Installing POLYCENTER Capacity Planner The product name and version are displayed. The product name is determined by the save set you choose to install. The first save set (A) is restored to a subdirectory of SYS$UPDATE:. 6. Select a release notes option: Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. Copy release notes to SYS$HELP * Select option : If you specified OPTIONS N when you invoked VMSINSTAL, you are now asked to choose one of the options for reviewing the release notes. All options copy the release notes to SYS$HELP. If you select option 1, VMSINSTAL displays the release notes immediately on the console terminal. You can terminate the display at any time by pressing Ctrl/C. If you select option 2, VMSINSTAL prompts you for the name of the print queue that you want to use. Either supply the name of the print queue that you want to use or press Return to send the file to the default output print device. For example: * Queue name [SYS$PRINT]: CLUSTER_PRINT If you select option 3, VMSINSTAL displays the release notes immediately on the console terminal and then prompts you for a queue name for the printed version. If you select option 4, the installation procedure will only copy the release notes to the SYS$HELP directory. Next, VMSINSTAL displays the following message: %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. Copyright (c) Digital Equipment Corporation, 1994. All rights reserved. Installing POLYCENTER Capacity Planner 2-7 The release notes are copied to the following file in the SYS$HELP directory: SYS$HELP:ECP040.RELEASE_NOTES ________________________ Note ________________________ The name of the release notes file (installed by VMSINSTAL) consists of the current product name and version number. ______________________________________________________ 7. Purge files: * Do you want to purge files replaced by this installation [YES]? The directories SYS$HELP, SYS$LIBRARY, SYS$MESSAGE, SYS$SYSTEM, and SYS$TEST may contain previous versions of POLYCENTER Capacity Planner files. These files are replaced during the installation with new files, but the old files are not automatically purged. Purging is recommended. In response to the purging prompt, press Return or enter YES to purge the files, or enter NO to keep them. 8. Choose the Installation Verification Procedure (IVP) option: The installation procedure now asks if you want to run the IVP. The IVP for POLYCENTER Capacity Planner checks to be sure that the installation is successful. It is recommended that you run the IVP. * Do you want to run the IVP after the installation [YES]? ________________________ Note ________________________ After POLYCENTER Capacity Planner is installed, you can run the IVP independently to verify that the software is available on your system. You might also need to run the IVP after a system failure to make sure that users can access POLYCENTER Capacity Planner. ______________________________________________________ 9. Respond to license registration queries: 2-8 Installing POLYCENTER Capacity Planner POLYCENTER Capacity Planner supports the OpenVMS License Management Facility (LMF). The installation procedure displays license information about POLYCENTER Capacity Planner. It asks whether you have registered and loaded your Product Authorization Key (PAK) for each product. The following is an example of the information and the queries presented by the installation procedure: +------------------------------------------------------------+ ! ! ! This product supports the VMS License Management Facility. ! ! If you have not previously registered and loaded the ! ! POLYCENTER Capacity Planner license you must do so before ! ! running the IVP. ! ! ! ! To register the POLYCENTER Capacity Planner license, use ! ! the information on your Product Authorization Key (PAK) ! ! provided with your kit to answer the prompts to: ! ! ! ! $ @SYS$UPDATE:VMSLICENSE ! ! ! ! If you have not yet registered the POLYCENTER Capacity ! ! Planner license, answer NO to the question below. After ! ! the installation completes, register the PAK and execute ! ! the IVP as described in the installation guide. ! ! ! +------------------------------------------------------------+ Product: CAPACITY-PLANNER Producer: DEC Version: 3.0 Release Date: 31-JAN-1995 * Does this product have an authorization key registered and loaded?: If you have not registered and loaded your PAK, you must answer NO to this question. You have to register and load your PAKs to successfully complete the installation (see Section 1.1). If you have not done so, you should stop the installation, register and load your PAKs, and then restart the installation. 10.Define the library. Installing POLYCENTER Capacity Planner 2-9 The installation procedure displays the name of the default file specification for the Capacity Planner library files. %ECP-I-LIBRARY, ECP_LIBRARY is currently defined to be SYS$SYSDEVICE:[ECP] * Is this the correct directory for the Capacity Planner Library files [Y]: Enter YES to accept the default library specification, unless you are installing in a mixed-cluster environment (VAX and Alpha systems). ________________________ Note ________________________ In a mixed cluster environment, use a different directory specification for VAX systems and Alpha systems. ______________________________________________________ %VMSINSTAL-I-SYSDIR, This product creates system disk directory SYS$SYSDEVICE:[ECP]. %VMSINSTAL-I-RESTORE, Restoring product save set B ... 11.Select the components to be installed: VMSINSTAL asks you to choose the components you want to install. The selections vary between platforms. Alpha The software presents three options: +---------------------------------------------------------------+ ! ! ! You can choose to install one or more of the following ! ! POLYCENTER Capacity Planner components: ! ! ! ! Data Integrator ! ! Capacity Planner DECwindows ! ! Event Monitor Data Collector ! ! ! +---------------------------------------------------------------+ 2-10 Installing POLYCENTER Capacity Planner Press Return to install the component. Type NO and press Return to bypass the option. * Do you want to install Data Integrator [Y]? * Do you want to install Capacity Planner DECwindows [Y]? * Do you want to install Event Monitor Data Collector [Y]? The following options will be provided: Data Integrator Capacity Planner DECwindows Event Monitor Data Collector Press Return to confirm your selections. If you type NO and press Return, the software presents the options over again. * Is this correct [Y]? VAX The software presents three options: +-------------------------------------------------------------+ ! ! ! You can choose to install one or more of the following ! ! POLYCENTER Capacity Planner components: ! ! ! ! Data Integrator ! ! Capacity Planner DECwindows ! ! ! +-------------------------------------------------------------+ * Do you want to install Data Integrator [Y]? * Do you want to install Capacity Planner DECwindows [Y]? The following options will be provided: Data Integrator Capacity Planner DECwindows The software asks you to confirm your selections. Press Return to accept the components. Type NO to see the options again. * Is this correct [Y]? 12.Terminate data collector processes: Installing POLYCENTER Capacity Planner 2-11 VMSINSTAL checks your system for running data collectors and provides the following message if it detects an active data collector process. Shut down the process before you continue the installation. Be sure to restart the data collector after the installation. %ECP-E-DCRUNNING, A data collector process is active It must be terminated before proceeding with this installation. * Do you want the data collector to be stopped at this time [YES]? %ECP-I-DCSHUTTING, Shutting down the data collector process... %ECP-I-DCSTOPPED, The data collector process has been stopped 13.Enter the device and directory name for the Data Collector database: VMSINSTAL asks you to enter the name of the device and directory to which the data collection process will write the database files. If you have a previous definition for PSDC$DATABASE, you will be asked if you want to preserve the old definition. PSDC$DATABASE is already defined system-wide as DECPS$DB:[DECPS.DATABASE] If you want to use the default of DECPS$DB:[DECPS.DATABASE], press Return. Otherwise, enter a device name and an optional directory name, then press Return. * Should this be used for the DECps database files [YES]? 14.Select the scheduling file: VMSINSTAL asks you to select the schedule file for data collection. If the Performance Data Collector is already installed on this system, you receive the following message: In the current database directory, there exists the scheduling file DISK:[PSDC-DATABASE]PSDC$SCHEDULE.DAT;133 If you have modified the default schedule file and want to save the changes, press Return. Otherwise, enter NO. * Do you want to retain the existing scheduling file [YES]? 15.Select the parameters file: 2-12 Installing POLYCENTER Capacity Planner If a parameters file already exists on the system, you will receive the following message: In the current database directory, there exists the parameter file DISK:[PSDC-DATABASE]PSDC$PARAMS.DAT;134 If you want to retain the parameters file, press Return. * Do you want to retain the existing DECps parameters file [YES]? 16.Read informational messages: At this point, the installation procedure displays a number of informational messages that report on the progress of the installation. There are no further questions. If the installation procedure has been successful up to this point, VMSINSTAL moves the new or modified files to their target directories, updates help files, and updates DCL tables, if necessary. The SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXE files are updated to include the new versions of the POLYCENTER Capacity Planner help text and the INTEGRATE and PLAN command-line definitions. Also, if you answered YES in response to the prompt that requests a file purge, previous versions of the POLYCENTER Capacity Planner files are now purged. The end of the installation is indicated by the following message: %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories... Refer to the log files in Appendix A for complete listings of each installation procedure. 17.Observe the IVP: If you chose to run the IVP, VMSINSTAL now invokes the IVP to verify that POLYCENTER Capacity Planner was installed successfully. If POLYCENTER Capacity Planner was installed successfully, the IVP displays the following: The Installation Verification Procedure for POLYCENTER Capacity Planner Version 4.0 has completed successfully. Installing POLYCENTER Capacity Planner 2-13 18.End the installation procedure: Installation of POLYCENTER Capacity Planner Version 4.0 completed at hh:mm VMSINSTAL procedure done at hh:mm 2-14 Installing POLYCENTER Capacity Planner 3 _________________________________________________________________ After Installation This chapter explains what you need to do after the installation to make POLYCENTER Capacity Planner ready for use. 3.1 Startup Procedure The Capacity Planner software contains startup procedures that allow your system to invoke the Capacity Planner software automatically when the system is booted. The startup procedures are named: o ECP$STARTUP.COM - Defines ECP_LIBRARY, which points to the hardware database files with the .DBA extensions. See Section 2.2 for defining ECP_LIBRARY in a mixed cluster environment. o PSDC$STARTUP.COM - Contains the Data Collector logical definitions. The startup command procedures are placed in the SYS$STARTUP directory. Make sure you edit the SYSTARTUP_V5.COM or SYSTARTUP_VMS.COM files in SYS$MANAGER to run SYS$STARTUP:ECP$STARTUP.COM and SYS$STARTUP:PSCP$STARTUP.COM. On a cluster system, replace the DCL tables on all nodes booting from a common system disk. You can use the SYSMAN utility, or do the following on each node: $ install install> replace sys$library:dcltables Then log out and log in again. Alternatively, you can give the following command: $ set command/table=sys$library:dcltables After Installation 3-1 3.2 Starting the Software The DECwindows Motif interface can be invoked by all users with this command: $ PLAN 3.3 Disk Space Required after Installation This section describes the disk space required to operate the Capacity Planner components after the installation. Alpha Table 3-1 contains the blocks required after installation. Table_3-1_Required_Disk_Space_after_Installation_(Alpha)___ Component________Disk_Space________________________________ Event Monitor 3,000 Data Integrator 3,700 Capacity 7,000 Planner All_components___13,000____________________________________ VAX Table 3-2 contains the blocks required after installation. Table_3-2_Required_Disk_Space_after_Installation_(VAX)_____ Component________Disk_Space________________________________ Data Integrator 3,500 Capacity 6,500 Planner V4.0 All_components___10,000____________________________________ 3-2 After Installation 3.4 Privileges Required after Installation The privileges needed for the Capacity Planner are the same as those needed by the Performance Data Collector because the Capacity Planner accesses the Data Collector files. Table 3-3 shows the privileges. Table_3-3_Privileges_Required_after_Installation___________ Command/Utility_______Privileges___________________________ ADVISE ARCHIVE Write access to the database area; /CONVERT read access to the parameters and schedule files. ADVISE COLLECT SYSLCK MODIFY You can modify the schedule file without privileges, but part of the command also shows the status, which requires SYSLCK. You must also have access to the schedule file. ADVISE COLLECT SYSPRV REPORT ADVISE COLLECT SHOW SYSLCK You can display the schedule file without privileges, but the status will indicate that you have no privileges because SYSLCK is needed ______________________to_show_status.______________________ 3.5 File Access Table 3-4 shows the required access to the files that the Capacity Planner uses. Table_3-4_File_Access______________________________________ File__________________Access_______________________________ Schedule file Read, write, delete Parameters file Read (continued on next page) After Installation 3-3 Table_3-4_(Cont.)_File_Access______________________________ File__________________Access_______________________________ PSDC$DATABASE Read, write directory *.CPD files Read, write, delete *.EVM_files___________Read,_write,_delete__________________ 3-4 After Installation 3.6 Maintenance Updates Maintenance updates of the Capacity Planner software may be issued periodically. Each update consists of an installation kit. Install this kit as described in this guide or any documentation that accompanies the maintenance update (which would supersede this guide). Maintenance updates include new release notes. The new release notes describe changes that have been made to the Capacity Planner software since the previous release. The release notes are provided on line. Read the release notes when you first install any version of the Capacity Planner software, as described in Section 2.1. 3.7 Installation Verification The Capacity Planner software contains command procedures that verify the correct operation of the software when it is invoked. The files are located in the SYS$TEST directory: o ECPCC$IVP.COM o ECPDECW$IVP.COM o ECPDI$IVP.COM If you registered the Product Authorization Key (PAK) before installing the Capacity Planner software and responded YES when the installation software asked whether you would like the IVP run at the end of the installation, the IVP is run at that time. If you did not register the PAK before installing the software, do so immediately after the installation and run the IVP by entering: $ @SYS$TEST:ECPDI$IVP If at any point you want to verify that the Capacity Planner software was installed correctly, run the IVP again. After Installation 3-5 4 _________________________________________________________________ Error Recovery and Problem Reporting This chapter explains the messages you may receive during installation and the procedure for reporting problems to Digital Equipment Corporation. 4.1 Error Recovery If the installation procedure fails for any reason, a message with the following format is displayed: %VMSINSTAL_E_INSFAIL, The installation of ECP Vn.n has failed. An error during the installation occurs if one or more of the conditions that are listed in Tables 4-1 and 4-2 exist. These errors can often be identified and resolved as indicated in each table. Table_4-1_Error_Recovery_for_ECP_Messages__________________ Error______________________Solution________________________ ECP-E-UNSUPVMSVER, The operating system version is "Installation of this kit incorrect and will not support on this version of VMS is the Capacity Planner software. unsupported" ECP-E-MSSGDWLIB, The Capacity Planner components "DEC Windows Motif is not requires DECwindows Motif. If installed on this system" you want to run the Capacity Planner component, install DECwindows Motif and reinstall the Capacity Planner software. See Table 1-2 for details about the Capacity Planner software. (continued on next page) Error Recovery and Problem Reporting 4-1 Table_4-1_(Cont.)_Error_Recovery_for_ECP_Messages__________ Error______________________Solution________________________ ECP-E-BADKIT, Check the contents of your save "Bad Distribution Kit" - set. "File nnn is missing" ECP-E-NOSPACE, Create extra space on the system "System disk does not disk. contain enough free blocks to install ECP" ECP-E-NEEDS, Your system does not have the "This kit requires peak disk space capacity to ''ECP$PEAK_UTIL blocks to complete the installation. install" Section 1.4.3 lists the peak disk space requirements for the Capacity Planner installation. ECP-E-INSFGBLPAGES, This software requires 17 "Insufficient contiguous contiguous global pages during global pages (GBLPAGES) installation. to install ECP" ECP-E-INSFGBLPAGES, This software requires 4 global "Insufficient sections during installation. global sections (GBLSECTIONS) to install ECP" ECP-E-DCRUNNING, The installation procedure asks "A DECps or VPA data if you want to stop the Data collector process is Collector process and then stops active" it for the user. ECP-E-INVALDEV, The device name you entered is "That device is invalid" not a valid device. The software will prompt you for another device name. ECP-E-NODATADEV, The device name you entered does "Device ''PSDC_DEV' does not exist. The software will not exist" prompt you for another device name. (continued on next page) 4-2 Error Recovery and Problem Reporting Table_4-1_(Cont.)_Error_Recovery_for_ECP_Messages__________ Error______________________Solution________________________ ECP-E-DEVNOTDISK, The device name that you entered "Device ''PSDC_DEV' is is not recognized as a disk. not a disk" The software will prompt you for another device name. ECP-E-DEVNOTAVAIL, The device name you entered is "Device ''PSDC_DEV' is not available. The software will not available" prompt you for another device name. ECP-E-DEVNOTSHR, The device name you entered is "Device ''PSDC_DEV' is owned by a private account. The not sharable" software will prompt you for another device name. ECP-E-INVALNODE, The node name you entered not "''PSDC$TYPED_LOCAL_NODE' valid. The software will prompt is_an_invalid_node_name"___you_for_another_node_name.______ Table_4-2_Error_Recovery_for_PSCP_Messages_________________ Error_______________________Solution_______________________ %PSCP-E-DCRUNNING, The installation procedure A DECps or VPA data asks if you want to stop the collector is active. Data Collector process and then stops it for the user. %PSCP-E-DEVNOTAVAIL, The device name you entered Device x is not available. is not available. The software will prompt you for another device name. %PSCP-E-DEVNOTDSK, The device name that you Device x is not a disk. entered is not recognized as a disk. The software will prompt you for another device name. (continued on next page) Error Recovery and Problem Reporting 4-3 Table_4-2_(Cont.)_Error_Recovery_for_PSCP_Messages_________ Error_______________________Solution_______________________ %PSCP-E-DEVNOTSHR, The device name you entered is Device x is not a owned by a private account. The shareable device. software will prompt you for another device name. %PSCP-E-INVALDEV, The device name you entered That device is invalid. is not a valid device. The software will prompt you for another device name. %PSCP-E-INVALNODE, The node name you entered is x is an invalid node name. not valid. The software will prompt you for another. %PSCP-E-NODATADEV, The device name you entered Device x does not exist. does not exist. The software will prompt you for another device name. %LIB-F-OPEN, Another user is using the VMS Error opening Help Utility. When the Capacity SYS$HELP:HELPLIB.HLB Planner software attempts to insert its help modules, %RMS-E-FLK, it must have sole access to file currently locked by the VMS Help library. Ensure another user. that no one is using the Help Utility. %RMS-F-PRV, You are attempting to install No privilege for attempted the Capacity Planner software operation. without the proper privileges. If you install from the SYSTEM account, adequate privileges will be available. %PSCP-E-VERSION, The operating system version is Capacity Planning software incorrect and will not support requires VMS Vn.n. the Capacity Planner software. Enter the SHOW SYSTEM command at the DCL prompt ($) to find your version number. (continued on next page) 4-4 Error Recovery and Problem Reporting Table_4-2_(Cont.)_Error_Recovery_for_PSCP_Messages_________ Error_______________________Solution_______________________ %PSCP-W-LICENSE, The Product Authorization A valid license for the Key for the Capacity Planner Capacity Planner Vn.n has software was registered not been registered. incorrectly, not registered, or unloaded. The installation %PSCP-W-NOIVP, will be complete, but the The IVP will not be run. IVP will not be run because it requires the PAK be registered correctly. When the installation is complete, register the PAK, then manually run the IVP to verify the ____________________________installation.__________________ For more information about errors related to the installation or other errors that may be relevant to the Capacity Planner software, see the POLYCENTER Capacity Planner User's Guide. If the installation fails, repeat the installation procedure from step 2. 4.2 Problem Evaluation and Reporting If you have a problem installing or running the Capacity Planner software and you have a basic or DECsupport Software Agreement, call your Customer Support Center. With these services, telephone support is available to provide advisory and remedial assistance. For more information, contact your local Digital representative. If you find an error in the Capacity Planner documentation, fill out and submit the Reader's Comments form at the back of the document in which the error was found. Include the section and page number of the error, and clearly specify the error in your response. If an error occurs while the Capacity Planner software is being executed and you have reason to believe that the error is due to a problem with the software, submit a Software Performance Report (SPR). Error Recovery and Problem Reporting 4-5 When you prepare to submit an SPR, do the following: o Provide as complete a description of the problem as possible. Include the software version number. To determine the correct version of the DECwindows interface, refer to the version number at the top of the Session Messages window. The Session Messages window is displayed when you invoke the DECwindows Motif interface. o Include any pertinent output or error message that you found just before the problem occurred. Include as much detail as possible about the events that led to the problem. o Save all data necessary to reproduce the error, such as the .CPD data files and .EVM data files. o Follow the SPR instructions carefully. 4-6 Error Recovery and Problem Reporting A _________________________________________________________________ Sample Installation Dialogues This appendix provides sample dialogues for a complete POLYCENTER Capacity Planner installation on the following platforms: o OpenVMS VAX (see Section A.1) o OpenVMS Alpha (see Section A.2) Sample Installation Dialogues A-1 A.1 Dialogue for OpenVMS VAX Example A-1 contains a sample log of an installation on an OpenVMS VAX system. Example A-1 OpenVMS VAX System Installation Log $ @VMSINSTAL ECP040 disk:[dir] OPTIONS N VAX/VMS Software Product Installation Procedure V5.5-2 It is 18-OCT-1996 at 17:39. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? The following products will be processed: ECP V4.0 Beginning installation of ECP V4.0 at 17:40 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. Copyright (c) Digital Equipment Corporation. 1994,1995. All rights reserved. * Do you want to purge files replaced by this installation [YES]? Y * Do you want to run the IVP after the installation [YES]? (continued on next page) A-2 Sample Installation Dialogues Example A-1 (Cont.) OpenVMS VAX System Installation Log +--------------------------------------------------------------+ ! ! ! This product supports the VMS License Management Facility. ! ! If you have not previously registered and loaded the ! ! POLYCENTER Capacity Server license you must do so before ! ! running the IVP. ! ! ! ! To register the POLYCENTER Capacity Server license, use the ! ! information on your Product Authorization Key (PAK) provided ! ! with your kit to answer the prompts to: ! ! ! ! $ @SYS$UPDATE:VMSLICENSE ! ! ! ! If you have not yet registered the POLYCENTER Capacity ! ! Server license answer NO to the question below. After the ! ! installation completes, register the PAK and execute the IVP ! ! as described in the installation guide. ! ! ! +--------------------------------------------------------------+ Product: CAPACITY-PLANNER Producer: DEC Version: 3.0 Release Date: 31-JAN-1995 * Does this product have an authorization key registered and loaded? Y %EDI-I-LIBRARY, ECP_LIBRARY is currently defined to be SYS$SYSDEVICE:[ECP] * Is this the correct directory for the Capacity Planner Library files [Y]: %VMSINSTAL-I-SYSDIR, This product creates system disk directory SYS$SYSDEVICE:[ECP]. %CREATE-I-EXISTS, SYS$SYSDEVICE:[ECP] already exists (continued on next page) Sample Installation Dialogues A-3 Example A-1 (Cont.) OpenVMS VAX System Installation Log +---------------------------------------------------------------+ ! ! ! You can choose to install one or more of the following ! ! POLYCENTER Capacity Planner components: ! ! ! ! Data Integrator ! ! Capacity Planner DECwindows ! ! ! +---------------------------------------------------------------+ * Do you want to install Data Integrator [Y]? * Do you want to install Capacity Planner DECwindows [Y]? The following options will be provided: Data Integrator Capacity Planner DECwindows * Is this correct [Y]? No more input is required to complete this installation. From this point the installation will proceed automatically. The installation should complete in approximately 5 to 15 minutes. %VMSINSTAL-I-RESTORE, Restoring product save set D ... %VMSINSTAL-I-RESTORE, Restoring product save set F ... %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Copyright (c) Digital Equipment Corporation. 1994. 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. (continued on next page) A-4 Sample Installation Dialogues Example A-1 (Cont.) OpenVMS VAX System Installation Log *-----------------------------------------------------------* * Installation Verification Procedure * * for * * POLYCENTER Capacity Planner: Data Integrator Component * *-----------------------------------------------------------* $ REDUCE CPDEV /begin=26-aug-1994:10:00/end=26-aug-1994:11:00 POLYCENTER Data Integrator V4.0-03 (c) Digital Equipment Corporation. 1994, 199 5, All Rights Reserved. ECP-INFO, Driver for CPD ... ECP-INFO, Writing MERG data to CPDEV_1994AUG26_1000.merg ... ECP-INFO, Writing report to CPDEV_1994AUG26_1000.proc ... ECP-INFO, Done. *-----------------------------------------------------------* * Installation Verification Procedure * * for * * POLYCENTER Capacity Planner: Data Integrator Component * * * * IVP COMPLETED SUCCESSFULLY * *-----------------------------------------------------------* Copyright (c) Digital Equipment Corporation. 1994. 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. *-----------------------------------------------------------* * Installation Verification Procedure * * for * * POLYCENTER Capacity Planner: DECwindows Component * *-----------------------------------------------------------* The POLYCENTER Capacity Planner IVP requires that a display device be defined (using the SET DISPLAY command). Please enter the node name of the workstation on which to display the IVP. (continued on next page) Sample Installation Dialogues A-5 Example A-1 (Cont.) OpenVMS VAX System Installation Log Enter node name (or Return to exit): QNUT The IVP brings up the POLYCENTER Capacity Planner. If the Capacity Planner comes up, THEN the installation has been successful. After the POLYCENTER Capacity planner appears, click the mouse in the window to assign input focus, and type CTRL/Z to exit and complete the DECwindows MOTIF portion of the IVP. Starting POLYCENTER Capacity Planner... *-----------------------------------------------------------* * Installation Verification Procedure * * for * * POLYCENTER Capacity Planner: DECwindows Component * * * * IVP COMPLETED SUCCESSFULLY * *-----------------------------------------------------------* Copyright (c) Digital Equipment Corporation. 1994. All rights reserved. Beginning the POLYCENTER Capacity Planner Installation Verification Procedure. Installation of ECP V4.0 completed at 17:52 VMSINSTAL procedure done at 17:52 $ LO USER logged out at 18-OCT-1996 17:53:20.40 A-6 Sample Installation Dialogues A.2 Dialogue for OpenVMS Alpha Example A-2 contains a sample log of an installation on an OpenVMS Alpha system. Example A-2 OpenVMS Alpha System Installation Log $ @VMSINSTAL ECP040 disk:[dir] OPTIONS N OpenVMS AXP Software Product Installation Procedure V6.1 It is 18-OCT-1996 at 15:56. Enter a question mark (?) at any time for help. * Are you satisfied with the backup of your system disk [YES]? * Where will the distribution volumes be mounted: public:[ECP040_SSB] Enter the products to be processed from the first distribution volume set. * Products: ECP040 Enter installation options you wish to use (none): The following products will be processed: ECP V4.0 Beginning installation of ECP V4.0 at 15:56 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. POLYCENTER Capacity Planner (AXP) Installation Copyright (c) Digital Equipment Corporation. 1995. All rights reserved. * Do you want to purge files replaced by this installation [YES]? * Do you want to run the IVP after the installation [YES]? %ECP-I-LIBRARY, ECP_LIBRARY is currently defined to be SYS$SYSDEVICE:[ECP] * Is this the correct directory for the Capacity Planner Library files [Y]: %VMSINSTAL-I-SYSDIR, This product creates system disk directory SYS$SYSDEVICE:[ECP]. %CREATE-I-EXISTS, SYS$SYSDEVICE:[ECP] already exists (continued on next page) Sample Installation Dialogues A-7 Example A-2 (Cont.) OpenVMS Alpha System Installation Log +---------------------------------------------------------------+ ! ! ! You can choose to install one or more of the following ! ! POLYCENTER Capacity Planner components: ! ! ! ! Capacity Planner DECwindows ! ! Data Integrator ! ! Event Monitor Data Collector ! ! ! +---------------------------------------------------------------+ * Do you want to install Data Integrator [Y]? * Do you want to install Capacity Planner DECwindows [Y]? * Do you want to install Event Monitor Data Collector [Y]? The following options will be provided: Data Integrator Capacity Planner DECwindows Event Monitor Data Collector * Is this correct [Y]? (continued on next page) A-8 Sample Installation Dialogues Example A-2 (Cont.) OpenVMS Alpha System Installation Log +--------------------------------------------------------------+ ! ! ! This product supports the VMS License Management Facility. ! ! If you have not previously registered and loaded the ! ! POLYCENTER Capacity Planner license you must do so before ! ! running the IVP. ! ! ! ! To register the POLYCENTER Capacity Planner license, use the ! ! information on your Product Authorization Key (PAK) provided ! ! with your kit to answer the prompts to: ! ! ! ! $ @SYS$UPDATE:VMSLICENSE ! ! ! ! If you have not yet registered the POLYCENTER Capacity ! ! Planner license answer NO to the question below. After the ! ! installation completes, register the PAK and execute the IVP ! ! as described in the installation guide. ! ! ! ! If you have selected the Event Monitor, you must have also ! ! installed and registered the POLYCENTER Data Collector. ! ! ! +--------------------------------------------------------------+ Product: CAPACITY-PLANNER Producer: DEC Version: 3.0 Release Date: 31-JAN-1995 * Does this product have an authorization key registered and loaded? YES Product: DECPS-DC Producer: DEC Version: 2.1 Release Date: 31-OCT-1993 * Does this product have an authorization key registered and loaded? YES No more input is required to complete this installation. From this point the installation will proceed automatically. (continued on next page) Sample Installation Dialogues A-9 Example A-2 (Cont.) OpenVMS Alpha System Installation Log The installation should complete in approximately 5 to 15 minutes. %VMSINSTAL-I-RESTORE, Restoring product save set D ... %VMSINSTAL-I-RESTORE, Restoring product save set E ... %ECP-I-BUILDING, Linking Data Integrator... %ECP-I-BUILDING, Linking Capacity Planner... %ECP-I-BUILDING, Linking EVM Components... Please ignore the following Link warnings. +------------------------------------------------------------------------+ %LINK-W-WRNERS, compilation warnings in module PSDC$ETFSHR file CPDEV$DKA300:[SYS0.SYSUPD.ECP040]EVM.OL B;1 %LINK-W-SHRWRNERS, compilation warnings in shareable image file CPDEV$DKA300:[SYS0.SYSUPD.ECP040]PSDC$EVEN T_PRVSHR.EXE;1 %LINK-W-WRNERS, compilation warnings in module COLLECT_EVENT file CPDEV$DKA300:[SYS0.SYSUPD.ECP040]EVM. OLB;1 %LINK-W-WRNERS, compilation warnings in module EVM_TRACE file CPDEV$DKA300:[SYS0.SYSUPD.ECP040]EVM.OLB; +------------------------------------------------------------------------+ %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Copyright (c) Digital Equipment Corporation. 1995. 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. (continued on next page) A-10 Sample Installation Dialogues Example A-2 (Cont.) OpenVMS Alpha System Installation Log *-----------------------------------------------------------* * Installation Verification Procedure * * for * * POLYCENTER Capacity Planner: Data Integrator Component * *-----------------------------------------------------------* $ REDUCE CPDEV /begin=26-aug-1994:10:00/end=26-aug-1994:11:00 POLYCENTER Data Integrator V4.0-03 (c) Digital Equipment Corporation. 1994, 199 5, All Rights Reserved. ECP-INFO, Driver for CPD ... ECP-INFO, Writing MERG data to CPDEV_1994AUG26_1000.merg ... ECP-INFO, Writing report to CPDEV_1994AUG26_1000.proc ... ECP-INFO, Done. *-----------------------------------------------------------* * Installation Verification Procedure * * for * * POLYCENTER Capacity Planner: Data Integrator Component * * * * IVP COMPLETED SUCCESSFULLY * *-----------------------------------------------------------* *-----------------------------------------------------------* * Installation Verification Procedure * * for * * POLYCENTER Capacity Planner: DECwindows Component * *-----------------------------------------------------------* The POLYCENTER Capacity Planner IVP requires that a display device be defined (using the SET DISPLAY command). Please enter the node name of the workstation on which to display the IVP. Enter node name (or Return to exit): qnut The IVP brings up the POLYCENTER Capacity Planner. If the Capacity Planner comes up, THEN the installation has been successful. After the POLYCENTER Capacity planner appears, click the mouse in the window to assign input focus, and type CTRL/Z to exit and complete the DECwindows MOTIF portion of the IVP. (continued on next page) Sample Installation Dialogues A-11 Example A-2 (Cont.) OpenVMS Alpha System Installation Log *-----------------------------------------------------------* * Installation Verification Procedure * * for * * POLYCENTER Capacity Planner: DECwindows Component * * * * IVP COMPLETED SUCCESSFULLY * *-----------------------------------------------------------* Installation of ECP V4.0 completed at 15:59 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file: VMI$ROOT:[SYSUPD]ECP040.VMI_DATA VMSINSTAL procedure done at 16:00 $ $ LO USER logged out at 18-OCT-1996 16:00:43.41 A-12 Sample Installation Dialogues B _________________________________________________________________ Created and Modified Files This appendix describes the files that are created and modified during installation, and where they reside. o Table B-1 lists the files for the Event Monitor Data Collector. o Table B-2 lists the files for the Data Integrator. o Table B-3 lists the files for the Capacity Planner. o Table B-4 lists the common files. These files allow you to operate the utilities and are created during the Capacity Planner installation unless they have already been created during a prior installation of the Performance Data Collector. Table_B-1_Event_Monitor_Files____________________________________ File_Name____________________________Directory_Area______________ PSDC$EVENT_PRVSHR.EXE [SYSLIB] Event Monitor executable image. This is a privileged image. PSDC$EVENT.UID [DECW$DEFAULTS.USER] DECwindows Motif interface file PSDC$MOTIF.UID [DECW$DEFAULTS.USER] DECwindows Motif interface file PSDC$EVENT.COM [SYSEXE] (continued on next page) Created and Modified Files B-1 Table_B-1_(Cont.)_Event_Monitor_Files____________________________ File_Name____________________________Directory_Area______________ Command procedure to execute batch jobs PSDC$EVENT.EXE [SYSEXE] Batch executable image PSDC$EVENT_MONITOR.EXE [SYSEXE] Event Monitor executable image PSDC$EVENT_MONITOR_STOP.EXE [SYSEXE] Event Monitor executable image PSDC$FILES.EXE [SYSEXE] Help files executable image PSPA$READ.EXE [SYSLIB] Executable image used by Event Monitor PSDC$LABELS.MSG [SYSMSG] Event Monitor message label file PSDC$MESSAGE.EXE [SYSMSG] Event Monitor message file executable image PSDC$MESSAGES.MSG [SYSMSG] _____Event_Monitor_message_file__________________________________ Table_B-2_Data_Integrator_Files__________________________________ File_Name____________________________Directory_Area______________ ECP$INTEGRATE.EXE [SYSEXE] Data Integrator DCL executable image ECPDI$IVP.COM [SYSTEST] Data Integrator installation verification procedure (continued on next page) B-2 Created and Modified Files Table_B-2_(Cont.)_Data_Integrator_Files__________________________ File_Name____________________________Directory_Area______________ ECP$DI_MAIN.EXE [SYSEXE] Data Integrator DECwindows Motif executable image EDI_MAIN.UID [DECW$DEFAULTS.USER] DECwindows Motif interface _____file________________________________________________________ Table_B-3_Capacity_Planner_Files_________________________________ File_Name____________________________Directory_Area______________ ECP$DEINSTAL.COM ECP_LIBRARY Capacity Planner deinstallation file ECP040.RELEASE_NOTES ECP_LIBRARY Product release notes ECP_AXPOSFCPU.DBA ECP_LIBRARY AXP OSF CPU database file ECP_AXPVMSCPU.DBA ECP_LIBRARY AXP VMS CPU database file ECP_AXPVMSCPU_MAP.DBA ECP_LIBRARY AXP migration application database file ECP_AXP_APPL.DBA ECP_LIBRARY AXP application database file ECP_CI.DBA ECP_LIBRARY Cluster interconnect database file ECP_DISK.DBA ECP_LIBRARY Disk database file ECP_DSSI.DBA ECP_LIBRARY (continued on next page) Created and Modified Files B-3 Table_B-3_(Cont.)_Capacity_Planner_Files_________________________ File_Name____________________________Directory_Area______________ DSSI database file ECP_FDDI.DBA ECP_LIBRARY FDDI network device database file ECP_HSC.DBA ECP_LIBRARY Storage controller database file ECP_NI.DBA ECP_LIBRARY Ethernet database file ECP_SCSI.DBA ECP_LIBRARY SCSI database file ECP_SERVER.DBA ECP_LIBRARY Server database file ECP_VAXCPU.DBA ECP_LIBRARY VAX CPU database file ECP_IOVIEW.UID ECP_LIBRARY DECwindows Motif interface file ECP_MAIN.UID ECP_LIBRARY DECwindows Motif interface file ECP_MODEL.UID ECP_LIBRARY DECwindows Motif interface file ECP_REPORT.UID ECP_LIBRARY DECwindows Motif interface file ECP_SYSTEMVIEW.UID ECP_LIBRARY DECwindows Motif interface file ECP_SYS_STATS.UID ECP_LIBRARY (continued on next page) B-4 Created and Modified Files Table_B-3_(Cont.)_Capacity_Planner_Files_________________________ File_Name____________________________Directory_Area______________ DECwindows Motif interface file ECP_TOPVIEW.UID ECP_LIBRARY DECwindows Motif interface file ECP_NETWORK.BASE ECP_LIBRARY Contains sample network data ECP_LABELS.MSG ECP_LIBRARY Capacity Planner message label file ECP_MESSAGES.MSG ECP_LIBRARY Capacity Planner message file ECP_PROFILE.DECW$BOOK ECP_LIBRARY Capacity Planner Bookreader help file ECP_PROFILE.DECW$BOOKSHELF ECP_LIBRARY Capacity Planner bookshelf file ECP_TEXT.HLP ECP_LIBRARY Capacity Planner text help file ECP.HLB [SYSHLP] Capacity Planner DCL help ECP.DAT DECW$SYSTEM_DEFAULTS Capacity Planner spreadsheet color scheme definitions ECP$STARTUP.COM SYS$STARTUP Capacity Planner startup file ECPDECW$IVP.COM [SYSTEST] Capacity Planner installation verification procedure (continued on next page) Created and Modified Files B-5 Table_B-3_(Cont.)_Capacity_Planner_Files_________________________ File_Name____________________________Directory_Area______________ ECP$PLAN.EXE [SYSEXE] Capacity Planner executable _____image_______________________________________________________ Table_B-4_Common_Files___________________________________________ File_Name____________________________Directory_Area______________ DECPS$RESOURCES.DAT SYS$EXAMPLES This text file contains sample DECwindows Motif interface resource settings. PSDC$DCOMM.EXE SYS$SYSTEM This image file updates the schedule file. PSDC$DECWINDOWS.EXE SYS$SYSTEM This file is the DECwindows interface image. PSDC$DEINSTALL_VPA.COM SYS$UPDATE This command procedure removes VPA from the system. PSDC$EDIT.EXE SYS$SYSTEM This image file is the Parameter Editor Utility for DECps. PSDC$EDITHELP.HLB SYS$HELP This is the help file for the Parameter Editor Utility. PSDC$FUNCTIONS.EXE SYS$SYSTEM This image file does archiving and dump reporting functions. PSDC$MAIN.UID DECW$SYSTEM_DEFAULTS (continued on next page) B-6 Created and Modified Files Table_B-4_(Cont.)_Common_Files___________________________________ File_Name____________________________Directory_Area______________ This file contains the widget definitions used by the DECps Data Collector DECwindows interface. PSDC$MESSAGE.EXE SYS$MESSAGE This image file provides the Data Collector and utilities messages. PSDC$MESSAGE.TXT SYS$SYSTEM This system file defines report formats. PSDC$MOTIF.EXE SYS$SYSTEM This file executes the DECwindows Motif interface. PSDC$MOTIF.UID DECW$SYSTEM_DEFAULTS This file contains the Motif widget definitions used by the DECps Data Collector DECwindows interface. PSDC$PARAMS.DAT PSDC$DATABASE (continued on next page) Created and Modified Files B-7 Table_B-4_(Cont.)_Common_Files___________________________________ File_Name____________________________Directory_Area______________ The parameters file is a repository for Data Collector parameters. The main parameters include: o Workload definitions o Workload family definitions o History file descriptors for archiving o A switch to signal the use of user auxiliary rules o Version limit indicator for parameters and history file generations PSDC$SCHEDULE.DAT PSDC$DATABASE The data collection schedule file designates when the Data Collector will collect data. It is created and modified with the ADVISE COLLECT command. PSDC$STARTUP.COM SYS$STARTUP This command procedure defines the Data Collector system logical names PSDC$DATABASE and PSDC$EXAMPLES. The site- specific system startup procedure should be modified to execute PSDC$STARTUP.COM. It is created during Data Collector installation. PSDC$WINDOW.EXE SYS$SYSTEM (continued on next page) B-8 Created and Modified Files Table_B-4_(Cont.)_Common_Files___________________________________ File_Name____________________________Directory_Area______________ This file is a dispatch image _____for_the_DECwindows_interface._______________________________ Created and Modified Files B-9 _________________________________________________________________ Index C______________________________ F______________________________ Capacity Planner Files components, 1-1 Capacity Planner, B-3 license names, 1-2 common, B-6 startup command, 3-2 created and modified, B-1 to startup command procedures, B-9 3-1 Data Integrator, B-2 Command procedures deleting early version of for installation verification DECps, 1-6 , 3-5 deletion of, when stopping for software startup, 3-1 installation, 2-1 D Event Monitor, B-1 _______________________________ location of, B-1 to B-9 Deleting files required access to, 3-3 early DECps executable images , 1-6 G______________________________ when stopping installation, Global pages 2-1 parameter Disk space calculating value for, checking availability, 1-9 1-10 required after installation, changing, 1-13 3-2 required required for installation, determining, 1-11 1-8 for installation, 4-2 Displaying release notes, 2-1 Global sections parameter E______________________________ calculating value for, Error messages 1-10 ECP, 4-1 changing, 1-13 PSCP, 4-3 required determining, 1-11 for installation, 4-2 Index-1 Product Authorization Key I______________________________ (PAK) requirements, 1-2 Installation disk space required for, 1-8 R______________________________ global pages required for, Registering a license, 1-3 4-2 Release notes global sections required for, displaying online, 2-1 4-2 for updates, 3-5 on new nodes, 1-2 location of, 2-1 privileges required for, 1-7 printing, 2-1 procedure, 2-2 to 2-14 sample logs, A-1 S______________________________ stopping, 2-1 Sample installation dialogues, system parameters required A-1 for, 1-7 Software troubleshooting, 4-1 optional, 1-5 updates, 1-2, 3-5 required, 1-5 verification, 3-5 Software licenses, 1-2 VMScluster considerations, Software Problem Report, 4-5 1-6 Startup command, 3-2 L Startup command procedures, _______________________________ 3-1 License Stopping the installation, 2-1 names, 1-2 System disk, 1-9 PAK requirements, 1-2 System parameters registration, 1-2 changing, 1-13 License Management Facility checking, 1-10 (LMF), 1-2 required for installation, 1-7 O______________________________ Operating system T______________________________ components required, 1-3 Troubleshooting the version required, 1-3 installation, 4-1 P______________________________ V______________________________ Printing release notes, 2-1 VIRTUALPAGECNT parameter Privileges required minimum value, 1-7 after installation, 3-3 VMScluster systems, for installation, 1-7 requirements for Problem reporting, 4-5 installation, 1-3 Index-2 W______________________________ WSMAX parameter changing, 1-13 checking, 1-10 minimum value, 1-7 Index-3