FRAGMENTATION COST ANALYSIS and FRAGMENTATION ANALYSIS UTILITY INSTALLATION This document describes the installation of Executive Software's Fragmentation Cost Analysis and the Fragmentation Analysis Utility. It does not, however, discuss the operation of these products. For operation instructions, refer to the following documents: o Fragmentation Analysis Utility User's Guide o Fragmentation Cost Analysis User's Guide These documents are available in PostScript[R] format on the CD ROM distribution medium. They can be printed on any PostScript printer. The documentation set is also supplied on the CD ROM distribution medium in Bookreader format. It is located in the [DECW$BOOK] directory. To receive the Fragmentation Analysis Utility and Fragmentation Cost Analysis documentation set in a printed format, contact your Executive Software sales or distributor office as described in the materials enclosed with the CD ROM. 1.1 OpenVMS[TM] Platforms and Versions Supported _____________________________________________ The user's guides provided for the Fragmentation Cost Analysis and the Fragmentation Analysis Utility describe running these products on both the VAX[TM] and the Alpha AXP[TM] platforms. This is in alignment with the documentation strategy currently used by Digital Equipment Corporation in their own product documentation. These utilities function the same on both platforms. The differences in OpenVMS between the two platforms are minor. Any differences will be clearly noted in the documentation. The Fragmentation Cost Analysis and the Fragmentation Analysis Utility for OpenVMS VAX are supported on versions 5.0 through 6.1 of the OpenVMS VAX operating system. They are not supported for versions prior to VMS[TM] 5.0. The Fragmentation Cost Analysis and the Fragmentation Analysis Utility for OpenVMS AXP[TM] is supported on versions 1.0 through 6.1 of the OpenVMS AXP operating system. The Fragmentation Cost Analysis and the Fragmentation Analysis Utility are supported on all VAX CPUs from Digital that run the OpenVMS VAX operating system. These utilities are fully supported on the VAXstation[TM] 3100, but not on the RISC-based DECstation[TM] 3100. The Fragmentation Cost Analysis and the Fragmentation Analysis Utility are supported on all Alpha AXP CPUs from Digital that run the OpenVMS AXP operating system. (c) Copyright 1994 Executive Software International, Inc. All rights reserved. These utilities are installed using the VMSINSTAL command procedure used to install your OpenVMS operating system and layered products. While VMSINSTAL can be used from any privileged account, Executive Software recommends that you log into the system manager account (SYSTEM, UIC [1,4]). Use VMSINSTAL in accordance with Digital's VMS Installation and Operations guides. 1.2 VAX Resource Requirements ______________________________ The VAX version of the Fragmentation Cost Analysis and Fragmentation Analysis Utility can be installed in any directory on any disk device on your system. During installation of these utilities, approximately 2000 free disk blocks are required for temporary files and directories on SYS$SYSDEVICE. After the installation, the Fragmentation Cost Analysis and Fragmentation Analysis Utility files take less than 250 blocks of disk space. Use the DCL command SHOW DEVICES /FULL to make sure you have sufficient space on SYS$SYSDEVICE for the installation before beginning. 1.3 AXP Resource Requirements ______________________________ The Alpha AXP version of the Fragmentation Cost Analysis and Fragmentation Analysis Utility can be installed in any directory on any disk device on your system. During installation of these utilities, approximately 2000 free disk blocks are required for temporary files and directories on SYS$SYSDEVICE. After the installation, the Fragmentation Cost Analysis and Fragmentation Analysis Utility files take less than 500 blocks of disk space. Use the DCL command SHOW DEVICES /FULL to make sure you have sufficient space on SYS$SYSDEVICE for the installation before beginning. 1.4 Privileges Required ________________________ The the executable image that makes up the Fragmentation Cost Analysis requires the privileges shown in Table 1-1: Table_1-1:__Required_Privileges___________________________________ Image_or_Procedure_Name____Privileges_____________________________ FRAG_ANALYSIS_xxx.EXE[1] CMKRNL, LOG_IO, (READALL or SYSPRV) __________________________________________________________________ [1]The xxx portion of the image name is either AXP or VAX, depend- ing upon your computer platform. __________________________________________________________________ _____________________ Installation - Page 2 1.5 Terminal Display Requirements __________________________________ The displays of the Fragmentation Cost Analysis and Fragmentation Analysis Utility are compatible with VT100 and later terminals and with terminal emulation windows under DECwindows[TM], DECwindows Motif, or VWS. VT52s and LA-series hardcopy terminals may be used for software installation, but are not supported for the menus. 1.6 Disks Supported ____________________ The Fragmentation Cost Analysis and Fragmentation Analysis Utility support the entire range of OpenVMS ODS-2 disk types: System disks, common system disks, quorum disks, user disks, volume sets, stripesets, and shadow sets. These utilities work in clusters whether the disk is on a local controller, an HSC, MSCP served, or LAVC-style MSCP served. The Fragmentation Cost Analysis and the Fragmentation Analysis Utility are designed for any Digital-supported configuration. 1.7 Installation Overview __________________________ The entire procedure for getting the Fragmentation Cost Analysis and Fragmentation Analysis Utility up and running on your system consists of the following: o Do a full BACKUP of the system disk. This is a standard precau- tion recommended by Digital whenever using VMSINSTAL. o Install the Fragmentation Cost Analysis and Fragmentation Analysis Utility using VMSINSTAL. See Section 1.8. o Define symbols to invoke the Fragmentation Analysis Utility and the Fragmentation Cost Analysis. See Sections 1.10 and 1.11. 1.8 Installation Procedure ___________________________ The Fragmentation Cost Analysis and the Fragmentation Analysis Utility are distributed together on the same media. Both utilities are intended to be installed in the same directory. During the installation procedure, you are allowed to specify the device and directory locations for the two utilities. By default, they are installed at SYS$SYSDEVICE:[ESI_FAU] Step 1: Log into the OpenVMS system manager's account (username SYSTEM, UIC [1,4]) and give your process the OPER and SETPRV privileges. This ensures that you will have access to the files and images needed for the installation and that files created during the installation will be created properly. The device name DUA0 is used as an example in this dialog. During installation, the physical name of SYS$SYSDEVICE for your system will appear in place of DUA0 shown in the dialog below. _____________________ Installation - Page 3 Step 2: Set the default disk directory to SYS$UPDATE: $ SET DEFAULT SYS$UPDATE Step 3: Execute the VMSINSTAL command procedure defining the product being installed, followed by the input device name (CD ROM drive DKB500: in this example). $ @VMSINSTAL FAU DKB500:[ESI.UTILITIES.FRAG_ANALYSIS.V11.KIT] VMSINSTAL will begin by displaying some information about the state of your system, such as whether DECnet[TM] is running, then ask whether you want to continue. Respond with YES only if the information displayed is as expected. Note: It is not necessary to shut down DECnet or log off users to install the Fragmentation Analysis Utility. * Do you want to continue anyway [NO]? YES Step 4: Next, VMSINSTAL will ask whether you are satisfied with the backup of your system disk. While every precaution has been taken to prevent adverse side-effects during installation of our product, Digital and Executive Software recommend having a current full backup of your system disk when installing any new software. * Are you satisfied with the backup of your system disk [YES]? YES Step 5: There will be a period of a few minutes of processing. Read all messages and answer any questions asked. Normally, the installation proceeds like this: %MOUNT-I-MOUNTED,FAU mounted on DKB500: The following products will be processed: FAU V1.1 Beginning installation of FAU V1.1 at 14:36 %VMSINSTAL-I-RESTORE, Restoring product save set A... * Do you want to purge files replaced by this installation [YES]? YES Step 6: A temporary directory is created; product saveset A is restored; and the copyright notice is displayed. Press when prompted to do so. _____________________ Installation - Page 4 Step 7: Next, you are given the opportunity to specify the device and directory where the Fragmentation Cost Analysis and the Fragmentation Analysis Utility will be installed. Press to accept the default, or answer NO at the following prompt: * OK to install FAU at SYS$SYSDEVICE:[ESI_FAU] [YES]? YES If you answer NO, you will be prompted to enter the device and directory where you want the Fragmentation Cost Analysis and Fragmentation Analysis Utility files to reside. Step 8: There will be another period of a few minutes of processing. Watch for errors or any other messages, such as: FAU will be installed at SYS$SYSDEVICE:[ESI_FAU] %VMSINSTAL-I-SYSDIR, This product creates system disk directory DUA0:[ESI_FAU]. Copying files, please wait... All files copied and secured %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... Installation of FAU completed at 14:37 VMSINSTAL procedure done at 14:37 Step 9: Since VMSINSTAL modifies your process environment, you should log out and back on to your system after this installation is complete. 1.9 Fragmentation Cost Analysis and Fragmentation Analysis Utility Kit Files _____________________________________________________________________________ After installation, the Fragmentation Cost Analysis and Fragmentation Analysis Utility files reside in SYS$SYSDEVICE:[ESI_FAU] if the default directory was accepted at installation time. This directory specification will differ if you specified an alternate directory location for the Fragmentation Cost Analysis and Fragmentation Analysis Utility files. The files installed are shown in Table 1-2. _____________________ Installation - Page 5 Table_1-2:__Files_Distributed_____________________________________ Kit_Files_________________________________________________________ FCA.COM FRAG_ANALYSIS_xxx.EXE[2] Total of 2 Files. __________________________________________________________________ [2]The xxx portion of the filename will be either AXP or VAX, depending upon your computer platform. __________________________________________________________________ 1.10 Defining a Symbol for the Fragmentation Analysis Utility ______________________________________________________________ For ease of use, define the following symbol in the system-wide login procedure or the individual login procedures of the users needing access to the Fragmentation Analysis Utility: $ FAU == "$ device:[directory]FRAG_ANALYSIS_xxx.EXE" where device:[directory] is the device and directory where the Fragmentation Analysis Utility executable image was installed during the installation procedure. Note that the "xxx" portion of the image name is either AXP or VAX, depending upon your computer platform. Once this has been done, run the Fragmentation Analysis Utility using a command of this form: $ FAU disk_name /qualifiers If the disk name is omitted, the Fragmentation Analysis Utility will prompt for the disk name. Only one disk can be specified at a time. The optional qualifiers represent Fragmentation Analysis Utility qualifiers, as shown in the Fragmentation Analysis Utility User's Guide. 1.11 Defining a Symbol for the Fragmentation Cost Analysis ___________________________________________________________ For ease of use, define the following symbol in the system-wide login procedure or the individual login procedures of the users needing access to the Fragmentation Cost Analysis: $ FCA == "@device:[directory]FCA.COM" where device:[directory] is the device and directory where the FCA.COM command procedure was installed during the installation procedure. Once the FCA symbol has been defined, run the Fragmentation Cost Analysis by entering this command at the DCL ($) prompt: $ FCA _____________________ Installation - Page 6 The following are trademarks of Digital Equipment Corporation: Alpha AXP AXP DECstation DECnet DECwindows OpenVMS VAX VAXstation VMS PostScript is a registered trademark of Adobe Systems, Inc. _____________________ Installation - Page 7