Disk_File_Optimizer_________________________________ Installation Guide Order Number: AA-QYZ2C-TE This installation guide provides installation information for the Disk File Optimizer for OpenVMS layered software product. Software Version: Version 2.4 Digital Equipment Corporation Maynard, Massachusetts ________________________________________________________________ October 1998 The information in this document is subject to change without notice and should not be construed as a commitment by Digital Equipment Corporation. Digital Equipment Corporation assumes no responsibility for any errors that may appear in this document. The software described in this document is furnished under a license and may be used or copied only in accordance with the terms of such license. No responsibility is assumed for the use or reliability of software on equipment that is not supplied by Digital Equipment Corporation or its affiliated companies. © Digital Equipment Corporation 1998. All rights reserved. Printed in U.S.A. The Reader's Comment Card on the last page of the hard copy version of this document requests the user's critical evaluation to assist in preparing future documentation. Alpha, AXP, DEC, DECUS, DECnet, DECps, DECscheduler, DECwindows, OpenVMS, PDP, UNIBUS, VAX, VAX Performance Advisor, VAX SPM, VAX SQL, VAXcluster, VMS, VPA, VT100, and the DIGITAL logo are trademarks of Digital Equipment Corporation. All other trademarks and registered trademarks are the property of their respective holders. This document was prepared using VAX DOCUMENT, Version 2.1. _________________________________________________________________ Contents Preface................................................... v 1 Installing Disk File Optimizer Software 1.1 Introduction..................................... 1-1 1.2 Preparing to Install the Disk File Optimizer Software......................................... 1-1 1.2.1 Upgrading From Disk File Optimizer V1.0 ....... 1-3 1.2.2 Installation Variants ......................... 1-3 1.2.3 Hardware and Software Requirements ............ 1-5 1.2.4 Minimum System Parameter Values ............... 1-6 1.2.5 Process Account Quotas ........................ 1-7 1.2.6 VMScluster System Considerations .............. 1-8 1.2.7 Definition of SCSNODE or SYS$NODE Considerations................................. 1-9 1.2.8 DEC C/C++ Run-Time Components Considerations .. 1-10 1.2.9 Patches that are Prerequisites ................ 1-11 1.2.10 Stop the Scheduler on Defrag Plus Installations ............................................... 1-13 1.2.11 Execute SYS$SYSTEM:SETFILENOMOVE.COM .......... 1-13 1.2.12 Registering the Disk File Optimizer Software License........................................ 1-14 1.2.12.1 License and Kit Names....................... 1-14 1.2.12.2 Registering Your Disk File Optimizer License..................................... 1-14 1.3 Installing the Disk File Optimizer Software...... 1-17 1.3.1 Before You Begin-Questions and Answers ........ 1-17 1.3.2 Installation Procedure ........................ 1-18 1.3.3 Error Recovery ................................ 1-27 1.4 After Installing the Disk File Optimizer......... 1-28 1.4.1 Running the IVP Separately .................... 1-28 1.4.2 Editing the Systemwide Command Files .......... 1-29 iii 1.4.3 Making the Disk File Optimizer Work on a VMScluster System.............................. 1-29 1.4.4 Deleting Old Copies of the RMS Database Files.......................................... 1-30 1.4.5 Loading The New Database After Upgrading from Disk File Optimizer V1.0....................... 1-30 1.4.6 Verifying Account Requirements ................ 1-30 1.4.7 Reporting Problems ............................ 1-31 A Disk File Optimizer Logicals and Files A.1 Files Added to System by the Disk File Optimizer ................................................. A-1 A.2 Logical Names.................................... A-3 B Example Disk File Optimizer Installation B.1 Example Installation............................. B-1 Index Examples B-1 Example Installation for Defrag PLUS .......... B-2 Tables 1-1 Differences Between Installation Variants ..... 1-4 1-2 Disk Space Requirements ....................... 1-5 1-3 Minimum System Parameter Values ............... 1-6 1-4 Process Account Quotas for the Installing Account........................................ 1-7 1-5 Image File Identification that Need XQP Patch.......................................... 1-12 1-6 How to Register Your Disk File Optimizer License........................................ 1-15 1-7 How to Install the Disk File Optimizer Software....................................... 1-18 A-1 Logical Names ................................. A-3 iv _________________________________________________________________ Preface Purpose of This Guide The installation guide contains the installation procedure for installing the Disk File Optimizer for OpenVMS. Intended Audience The intended audience is the system administrators who install the Disk File Optimizer software. Related Documents o A Practical Guide to Managing Software Licenses o VAX Performance Advisor (VPA) Documentation Kit o VAX SPM Documentation Kit o VMS Analyze/disk_structure Utility (part of the VMS Version 5.0 Base Documentation Set) o VMS DCL Dictionary o VMS File System Internals o VMS License Management Utility Manual (part of the VMS Version 5.0 Base Documentation Set) o VMS System Management Subkit Order numbers for these documents can be obtained from your Digital Sales Representative. v Conventions The following conventions are used in this manual: ___________________________________________________________ Convention_______Meaning___________________________________ {parameter} In command formats, braces indicate required parameters. Do not enter the braces when you enter the parameter in a command. [parameter] In command formats, square brackets indicate optional parameters. Do not enter the brackets when you enter the optional parameters. [ ] In interactive procedures, square brackets denote default responses. italic text In examples and messages, italic text represents input that is unique for each system. boldface text Boldface text is used for emphasis. Ctrl/x Control key sequence indicates that you hold down the Ctrl key while you press another character key (for example, Ctrl/W or Ctrl/C). . In examples, a vertical ellipsis . represents the omission of data that the . system displays in response to a command or data that a user enters. file- In command formats, a horizontal ellipsis spec[, . . . ] indicates that the preceding items can be _________________repeated_one_or_more_times._______________ References to Digital Products The following Digital products are mentioned in this manual: vi ___________________________________________________________ Product__________Formal_Product_Name_______________________ Disk File Disk File Optimizer refers to the Disk Optimizer File Optimizer for OpenVMS software. Defrag Defrag refers to a variation of the Disk File Optimizer software that provides basic file and volume defragmentation capabilities. Defrag PLUS Defrag PLUS refers to the variation of the Disk File Optimizer software that supports all of the features of Defrag, plus scheduling and command storing capabilities. VPA VPA refers to the VAX Performance Advisor software. DECps DECps refers to the DEC Performance Solution software. OpenVMS OpenVMS refers to the OpenVMS VAX and _________________OpenVMS_Alpha_operating_systems.__________ vii 1 _________________________________________________________________ Installing Disk File Optimizer Software 1.1 Introduction This chapter describes how to install the Disk File Optimizer software. It includes the following sections: o Preinstallation activities o Installation procedure o Postinstallation activities 1.2 Preparing to Install the Disk File Optimizer Software ___________________ Recommendation ___________________ Performing a backup of your system disk prior to installing Disk File Optimizer software is recommended. Refer to the VMS Backup Utility Manual for more details. ______________________________________________________ The following process describes preparations needed to install the Disk File Optimizer software. ___________________________________________________________ Stage_Action_______________________________Section_________ 1 Save scheduling database contents Section 1.2.1 if up grading from V1.0 ___________________________________________________________ 2 Meet hardware and software Section 1.2.3 requirements ___________________________________________________________ 3 Verify system parameters and Section 1.2.4, required quotas Section 1.2.5 Installing Disk File Optimizer Software 1-1 Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software ___________________________________________________________ Stage_Action_______________________________Section_________ ___________________________________________________________ 4 Evaluate VMScluster system Section 1.2.6 considerations ___________________________________________________________ 5 SCSNODE or SYS$NODE considerations Section 1.2.7 ___________________________________________________________ 6 Evaluate DEC C/C++ Run-Time Section 1.2.8 Components considerations ___________________________________________________________ 7 Patches that are Prerequisites Section 1.2.9 ___________________________________________________________ 8 Stop DFO Scheduler on all nodes Section 1.2.10 ___________________________________________________________ 9 Execute the Section 1.2.11 SYS$SYSTEM:SETFILENOMOVE.COM procedure against all OpenVMS operating system disks on your cluster ___________________________________________________________ 10 Register the Disk File Optimizer Section 1.2.12 ______license______________________________________________ Your bill of materials and indented bills report specify the contents of your media. Be sure to verify the contents of your kit with this information. If your kit is damaged or if parts are missing, contact your Digital representative. The installation procedure for the Disk File Optimizer provides online release notes. Digital strongly recommends that you read the release notes before proceeding with the installation. For information on accessing the online release notes, see Table 1-7. The Disk File Optimizer software installation procedure converts existing scheduling database files to the new version. If you have Disk File Optimizer V1.1 to V2.0, the installation will convert your Rdb database to an RMS 1-2 Installing Disk File Optimizer Software Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software database. If you are installing Disk File Optimizer Version 1.0, see Section 1.2.1 before installing. 1.2.1 Upgrading From Disk File Optimizer V1.0 If you are upgrading from Disk File Optimizer V1.0 and want to save the data in your database, you must save the data in a command procedure. Perform the following command to save in a command procedure: $ DEFRAGMENT SHOW */COMMAND/OUT=LOAD_DB.COM This command saves the data from your Rdb database and allows you restore it after installation of Disk File Optimizer. 1.2.2 Installation Variants The Disk File Optimizer kit allows for two installation variants: o Defrag, which provides capabilities to defragment files and volumes o Defrag PLUS, which provides all the capabilities of Defrag plus scheduling and command storage options Table 1-1 identifies the major differences between Defrag and Defrag PLUS. Defrag is recommended on any system where the additional features are not desired or where disk space is very limited. Defrag PLUS is recommended on VMScluster systems and on any single-node system where the additional features of Defrag PLUS are desired. Installing Disk File Optimizer Software 1-3 Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software Table_1-1_Differences_Between_Installation_Variants______________ Difference_______Defrag_PLUS___________Defrag____________________ Additional Optional: Optional: Software o VAX Performance o VAX Performance Advisor Advisor (VPA) (VPA) Version 2.1 or Version 2.1 or later later or or DEC Performance DEC Performance Solution (DECps) Solution (DECps) Version 1.0 or later Version 1.0 or later Available Subcommands o ABORT o ABORT o ATTACH o ATTACH o CANCEL o EXIT o DISABLE o DEFRAGMENT FILE o ENABLE o HELP o EXIT o MONITOR o DEFRAGMENT FILE o DEFRAGMENT OFFLINE o HELP o SHOW o MODIFY o SPAWN o MONITOR o DEFRAGMENT VOLUME o DEFRAGMENT OFFLINE o REMOVE o SET o SHOW o SPAWN o START o DEFRAGMENT VOLUME 1-4iInstalling DiskqFiledOptimizer Software o DFG$DATABASE o DFG$MAIL_ADDRESS Optional (for callable interface): o DFG$MESSAGE _________________________________________________________________ Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software 1.2.3 Hardware and Software Requirements The Disk File Optimizer free disk storage space requirements are different during installation and after installation. Table 1-2 summarizes the storage requirements. Table_1-2_Disk_Space_Requirements__________________________ Blocks Required During Blocks Required Variant_________Installation________After_Installation_____ Defrag PLUS 6700 3700 /VAX Defrag PLUS 11700 7800 /Alpha Defrag/VAX 3900 2800 Defrag/Alpha____5500________________3900___________________ To determine the number of free disk blocks on the current system disk, enter the following command at the DCL prompt: $ SHOW DEVICE SYS$SYSDEVICE The minimum version of software necessary to run the Disk File Optimizer is OpenVMS for VAX V5.5-2 and OpenVMS for Alpha V6.2. To install the software, you must be logged in to an account that has SETPRV privileges. ________________________ Note ________________________ VMSINSTAL turns off BYPASS privilege at the start of the installation. ______________________________________________________ Installing Disk File Optimizer Software 1-5 Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software 1.2.4 Minimum System Parameter Values This section lists those system parameters whose default values may be insufficient for proper operation of the defragmentation software. Table 1-3 lists these parameters, recommended minimum settings, and whether the parameters apply to Defrag or Defrag PLUS. Table_1-3_Minimum_System_Parameter_Values________________________ System Minimum Installation Parameter_____Value_______Variant_Explanation____________________ GBLPAGES 2078 PLUS Use the f$getsyi("free_ (avail- gblpages") lexical function to able) obtain the number of available global pages. _________________________________________________________________ GBLSECTIONS 80 (avail- PLUS Use the f$getsyi("gblsections") able) lexical function to obtain the number of available global sections. _________________________________________________________________ RESHASHTBL 512 PLUS Use SYSGEN to find this value. entries _________________________________________________________________ SRPCOUNT[1] 1024 PLUS Use SYSGEN to find this value. packets (Not applicable on OpenVMS Axp) _________________________________________________________________ SRPCOUNTV[1] 2048 PLUS Use SYSGEN to find this value. packets (Not applicable on OpenVMS Axp) [1]This_parameter_only_exists_on_OpenVMS_prior_to_OpenVMS_V6.1.__ _________________________________________________________________ 1-6 Installing Disk File Optimizer Software Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software 1.2.5 Process Account Quotas The account you use to install the Disk File Optimizer software must have sufficient quotas to enable you to perform the installation. Table 1-4 summarizes the process quotas required for the installing account, regardless of which installation variant you install. Table_1-4_Process_Account_Quotas_for_the_Installing_Account Account_Quota____Value_____________________________________ ASTLM 24 BIOLM 18 BYTLM 20,480 DIOLM 18 ENQLM 2048 FILLM 50 PRCLM 10 PGFLQUO__________20,000____________________________________ User account quotas are stored in the SYSUAF.DAT file. Use the VMS Authorize utility (AUTHORIZE) to verify and change user account quotas. First set your directory to SYS$SYSTEM, and then run AUTHORIZE: $ SET DEFAULT SYS$SYSTEM $ RUN AUTHORIZE UAF> At the UAF> prompt, enter the SHOW command with an account name to check a particular account, for example: UAF> SHOW SMITH To change a quota, enter the MODIFY command. The following example changes the FILLM quota for the SMITH account, and then exits from the utility: UAF> MODIFY SMITH /FILLM=50 UAF> EXIT After you exit from the utility, the system displays messages indicating whether or not changes were made. Once the changes have been made, you must log out and log in for the new quotas to take effect. Installing Disk File Optimizer Software 1-7 Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software For more information on modifying account quotas, see the description of the Authorize utility in the VMS System Management Subkit. 1.2.6 VMScluster System Considerations Use the following list of guidelines when installing the Disk File Optimizer on a VMScluster system: o For Defrag PLUS, the scheduling database should be accessible from all nodes in the cluster. Make sure to place the scheduling database on a cluster- accessible disk. Defragmentation can occur only from nodes that can access the database. o For Defrag PLUS, defragmentation can occur only on those nodes running a scheduler process. The scheduler creates defragmentation processes and runs them as detached processes. Because of this, defragmentation can occur only from nodes that have a running scheduler. o After installation, install the latest version of DCLTABLES.EXE on all nodes of your system. To make the Disk File Optimizer available on all nodes of the cluster, you should ensure that all nodes have the latest version of DCLTABLES.EXE installed. Use SYSMAN or log in to each node in the cluster and enter the following command: $ INSTALL REPLACE SYS$COMMON:[SYSLIB]DCLTABLES.EXE o Be sure to install Disk File Optimizer on both the VAX and Alpha system in your VMScluster if it is a mix of VAX and Alpha systems. o During installation of DFO on a cluster with multiple system disks, you must shut down the scheduler before starting the installation on the next node. Use the following command: $ @SYS$MANAGER:DFG$STOP_SCHEDULER 1-8 Installing Disk File Optimizer Software Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software During the Installation Verification Procedure (IVP) the scheduler is started on the node that the installation was just completed on. After completion of installation on all nodes, restart the scheduler on all licensed nodes in the cluster. Use the following command: $ @SYS$STARTUP:DFG$STARTUP 1.2.7 Definition of SCSNODE or SYS$NODE Considerations Defrag PLUS requires either SCSNODE (SYSGEN parameter) or SYS$NODE (DECnet logical) be defined on the node that Disk File Optimizer is installed on. If both SCSNODE and SYS$NODE are NOT defined, the Disk File Optimizer scheduler will not start. If the node is part of a cluster then SCSNODE has to be defined in SYSGEN. You can check if SCSNODE is defined by using the following command: $ WRITE SYS$OUTPUT F$GETSYI("NODENAME") SPIELN $ In this example, SPIELN is the SCSNODE name. If the SYSGEN parameter SCSNODE is not defined then no node name is returned. Another way of checking SCSNODE is to go into SYSGEN and execute the following command: $ MCR SYSGEN SYSGEN> SHOW SCSNODE Parameter Name Current Default Min. Max. Unit Dynamic -------------- ------- ------- ------- ------- ---- ------- SCSNODE "SPIELN " " " " " "ZZZZ" Ascii SYSGEN> EXIT $ In this example, SPIELN is the SCSNODE name. Installing Disk File Optimizer Software 1-9 Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software If the node is a standalone node, it does not require that SCSNODE be defined. However, if you wish to, you can define it in SYS$SYSTEM:MODPARAMS.DAT as follows and then do an AUTOGEN: SCSNODE="SPIELN" SCSSYSTEMID=9112 If the node is running DECnet, it will have a logical SYS$NODE defined. You can check to see if the logical SYS$NODE is defined using the following command: $ SHOW LOG SYS$NODE "SYS$NODE" = "SPIELN::" (LNM$SYSTEM_TABLE) $ In this example, SPIELN is the SYS$NODE name. 1.2.8 DEC C/C++ Run-Time Components Considerations Disk File Optimizer 2.4 has been compiled with the DEC C compiler and therefore requires the DEC C/C++ run-time components. These components are not installed on OpenVMS VAX V5.5-x and 6.0 systems unless you have previously installed them. This Disk File Optimizer kit includes the DEC C/C++ run-time components kit. During installation, your version of SYS$LIBRARY:DECC$SHR.EXE is checked to see if it is at V6.0 or greater. If the version is less, you are asked if you want to install the DEC C/C++ run-time components. You can get the release notes for the kit at this time. When the DEC C/C++ Run-Time Components kit is installed on an OpenVMS VAX Version 5.5, 5.5-1, or 5.5-2 system, some of the shareable image run-time components replace older versions of existing OpenVMS components. Prior to the installation you should read Chapter 1 of the DEC C /C++ Run-Time Components for OpenVMS VAX Reference and Installation Guide. You can extract the reference and installation guide from saveset DFG024.B using the following commands: 1-10 Installing Disk File Optimizer Software Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software $ BACKUP/LOG DFG024.B/SAVE * %BACKUP-S-CREATED, created AACRT060.A;1 $ BACKUP/LOG/SELECT=(*.PS,*.TXT) AACRT060.A/SAVE * %BACKUP-S-CREATED, created CRT060_RBI.PS;1 %BACKUP-S-CREATED, created CRT060_RBI.TXT;1 %BACKUP-S-CREATED, created CRT060_REF_INST.PS;1 %BACKUP-S-CREATED, created CRT060_REF_INST.TXT;1 %BACKUP-S-CREATED, created CRT060_RELEASE_NOTES.PS;1 1.2.9 Patches that are Prerequisites As of OpenVMS 6.0 for VAX and OpenVMS 6.1 for AXP, the XQP MOVEFILE primitive allows movement of directory files, so long as no node in the cluster has data from these files cached. The cluster-wide check for this condition did not work properly. This results in cache incoherency, and as a result, directory file corruption. Common symptoms are: o Out of order directory listings o Duplicate directory entries for the same file o Lost files o Inconsistent directory listing on different nodes o Files appearing in directory listing which are not accessible from the RMS level (for example: you cannot type them). This problem was fixed in OpenVMS V6.2 for VAX and AXP. Before running Disk File Optimizer you should check that you have installed the proper XQP patch to correct the above problem. To check if you have the proper patch installed, us the following command to check the image file identification: Installing Disk File Optimizer Software 1-11 Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software $ ! for AXP $ ANALYZE/IMAGE/INTERATIVE SYS$LOADABLE_IMAGES:F11BXQP.EXE . . . Press RETURN to continue, or enter a period (.) for next file: Image Identification Information image name: "F11BXQP" image file identification: "XQP A6.1R 007" image file build identification: "X5SC-SSB-B800" link date/time: 6-FEB-1996 11:08:35.88 linker identification: "T11-11" $ ! for VAX $ ANALYZE/IMAGE/INTERATIVE SYS$SYSTEM:F11BXQP.EXE . . . Press RETURN to continue, or enter a period (.) for next file: Image Identification Information image name: "F11BXQP" image file identification: "XQP V6.1 0003" link date/time: 9-MAR-1994 02:07:06.89 linker identification: "05-13" Table 1-5 indicates those image file identifications that need the latest XQP patch: Table_1-5_Image_File_Identification_that_Need_XQP_Patch____ VMS Version_____Image_File_Identifications_____________________ VAX V6.0 X-14 VAX V6.0 XQP V6.0R 0001 VAX V6.0 XQP V6.0R 0002 VAX V6.0 XQP V6.0R 0003 VAX V6.1 XQP V6.1 0003 VAX V6.1 XQP V6.1R 0001 AXP_V6.1____X-3____________________________________________ 1-12 Installing Disk File Optimizer Software Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software If your F11BXQP.EXE image is one of those listed in Table 1-5, you should contact your Digital service representative to obtain the latest patch. You can also obtain the patches from the following web site: http://www.service.digital.com/ 1.2.10 Stop the Scheduler on Defrag Plus Installations If you are running a previous version of the Disk File Optimizer, then shut down the Scheduler software on all nodes before installing the new version of Defrag or Defrag PLUS software. Use SYSMAN to shut down the Scheduler software or execute the following command on all nodes: $ @SYS$MANAGER:DFG$STOP_SCHEDULER.COM 1.2.11 Execute SYS$SYSTEM:SETFILENOMOVE.COM Before you run the Disk File Optimizer, execute SYS$SYSTEM:SETFILENOMOVE.COM against all OpenVMS operating system disks on your cluster. SETFILENOMOVE.COM identifies all system files that must not be moved because they are accessed without the file system. When you run this command file, it sets the NOMOVE bit in the file header for the identified files. If you do not run this command procedure, system files could be moved that would be "lost" to the accessing processes. This procedure marks certain critical system files with the NOMOVE attribute. This anchors these files to the disk; any attempt to relocate them using the XQP MOVEFILE function fails. While attempting to execute SETFILENOMOVE.COM, you may receive several errors similar to the following: %SET-E-READERR, error reading -SYSTEM-W-ACCONFLICT, file access conflict To set the NOMOVE attribute on these files you must boot from another system, such as the distribution CD, and then execute SETFILEMOVE.COM against the disk. However, these files may already have the NOMOVE attribute set. Use the DIRECTORY/FULL command to determine if the NOMOVE attribute was already set. Installing Disk File Optimizer Software 1-13 Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software If the NOMOVE attribute is not set and you cannot boot from another system disk, you should be all right because the file is open when the system is booted. Disk File Optimizer does not defragment or move open files. To use this SETFILENOMOVE.COM procedure, you must specify the file name as P1 on the command line. For example: $ @SYS$SYSTEM:SETFILENOMOVE $1$DKB100: 1.2.12 Registering the Disk File Optimizer Software License When you are installing Disk File Optimizer software for the first time, you must register the Disk File Optimizer software license. The following sections describe: o License and kit names o How to register the software license 1.2.12.1 License and Kit Names The license and kit name for the Disk File Optimizer software is the same for Defrag and Defrag PLUS. The license name is DFG or PFO and the kit name is DFG024. 1.2.12.2 Registering Your Disk File Optimizer License Follow the steps in Table 1-6 to register your new Disk File Optimizer license. Where_to_find_registration_information: The license registration information is contained in the Product Authorization Key (PAK). The PAK is a certificate shipped with the Disk File Optimizer package. 1-14 Installing Disk File Optimizer Software Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software Table_1-6_How_to_Register_Your_Disk_File_Optimizer_License_ Step_Action_____________________Enter_the_command:_________ 1 Enter the LICENSE REGISTER command with $ LICENSE REGISTER DFG - the product name and a dash. Important: Enter a dash at the end of each command in Steps 1 through 9. ___________________________________________________________ 2 Enter the /ISSUER qualifier information, _$ /ISSUER=DEC - assigning the value from the ISSUER entry of the PAK. ___________________________________________________________ 3 Enter the /AUTHORIZATION qualifier information, _$ /AUTHORIZATION=xxxxxxx - assigning it the value from the AUTHORIZATION NUMBER entry of the PAK. ___________________________________________________________ 4 Enter the /PRODUCER qualifier information, _$ /PRODUCER=DEC - assigning the value from the PRODUCER entry of the PAK. ___________________________________________________________ 5 Enter the /UNITS qualifier information, _$ /UNITS=nn - assigning the value from the NUMBER OF UNITS entry of the PAK. ___________________________________________________________ (continued on next page) Installing Disk File Optimizer Software 1-15 Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software Table 1-6 (Cont.) How to Register Your Disk File Optimizer __________________License__________________________________ Step_Action_____________________Enter_the_command:_________ 6 Enter the /RELEASE_DATE qualifiers information, _$ /RELEASE_DATE=dd-mmm- assigning the product's yyyy - release date value from the PRODUCT RELEASE DATE entry of the PAK. ___________________________________________________________ 7 Enter the /TERMINATION_ DATE qualifiers _$ /TERMINATION_DATE=dd- information, assigning mmm-yyyy - the product's termination date value from the KEY TERMINATION DATE entry of the PAK. ___________________________________________________________ 8 Enter the /AVAILABILITY qualifier information, _$ /AVAILABILITY=x - assigning the value from the AVAILABILITY TABLE CODE entry of the PAK. ___________________________________________________________ 9 Enter the /OPTIONS qualifier information, _$ /OPTIONS=xxxxxx - assigning the value from the KEY OPTIONS entry of the PAK. ___________________________________________________________ (continued on next page) 1-16 Installing Disk File Optimizer Software Installing Disk File Optimizer Software 1.2 Preparing to Install the Disk File Optimizer Software Table 1-6 (Cont.) How to Register Your Disk File Optimizer __________________License__________________________________ Step_Action_____________________Enter_the_command:_________ 10 Enter the /CHECKSUM qualifier information, _$ /CHECKSUM=x-xxxx-xxxx- assigning the value from xxxx-xxxx the CHECKSUM entry of the PAK. Important: Do NOT end this entry with a dash. ___________________________________________________________ 10 Invoke the LICENSE LOAD command with the product $ LICENSE LOAD DFG _____name._________________________________________________ 1.3 Installing the Disk File Optimizer Software 1.3.1 Before You Begin-Questions and Answers Before beginning the installation procedure, you may want to read the following questions and answers: Q: Is there anything special I should do before I install Disk File Optimizer for the first time? A: Yes. Make sure you have run SETFILENOMOVE.COM on your OpenVMS operating system disks as described in Section 1.2.11. Q: How long does the installation procedure take? A: The installation procedure takes from 15 to 45 minutes, depending on your media type, system configuration, software variant, and whether or not you execute the IVP. Q: How can I get help? A: VMSINSTAL provides additional information about the decisions required to respond to the installation prompts. To get help at any installation prompt, press < ? > . Installing Disk File Optimizer Software 1-17 Installing Disk File Optimizer Software 1.3 Installing the Disk File Optimizer Software Q: Where can I find an example of the installation procedure? A: Appendix B contains an example of an installation procedure for the Disk File Optimizer software. Q: How can I abort the installation procedure? A: Enter . Note: You must restart the installation from the beginning if you abort the VMSINSTAL procedure. Q: Do I need to do anything special to upgrade from the existing Disk File Optimizer software? A: No, unless you upgrading from Disk File Optimizer Version 1.0 . Refer to Section 1.2.1. 1.3.2 Installation Procedure The Disk File Optimizer installation procedure consists of a series of questions and informational messages. See Appendix B for a sample installation. Follow the steps in Table 1-7 to install Disk File Optimizer software. Table_1-7_How_to_Install_the_Disk_File_Optimizer_Software__ Step_Action________________________________________________ 1 Load and mount the media that contains the software kit. ___________________________________________________________ (continued on next page) 1-18 Installing Disk File Optimizer Software Installing Disk File Optimizer Software 1.3 Installing the Disk File Optimizer Software Table 1-7 (Cont.) How to Install the Disk File Optimizer __________________Software_________________________________ Step_Action________________________________________________ 2 Invoke the VMSINSTAL procedure. By entering the following command: @SYS$UPDATE:VMSINSTAL saveset-name device- name OPTIONS N Where: saveset-name is the installation name for the component. For the Disk File Optimizer, use the following: DFG024 device-name is the name of the device on which you plan to mount the media, for example, MUA0:. It is not necessary to use the console drive for this installation. However, if you use the console drive, replace any media you remove when the installation is complete. OPTIONS N indicates you want to see the release notes. If you do not include this parameter, VMSINSTAL does not ask you about the release notes. Review the release notes before proceeding with the installation as they could contain additional installation information. ___________________________________________________________ 3 If you see the following message: %VMSINSTAL-W- ACTIVE, The following processes are still active * Do you want to continue anyway [NO]? Enter Y and press Return, else go to Step 4. ___________________________________________________________ 4 Confirm the state of the system backup. * Are you satisfied with the backup of your system disk [Yes]? Press Return. ___________________________________________________________ (continued on next page) Installing Disk File Optimizer Software 1-19 Installing Disk File Optimizer Software 1.3 Installing the Disk File Optimizer Software Table 1-7 (Cont.) How to Install the Disk File Optimizer __________________Software_________________________________ Step_Action________________________________________________ 5 Respond to the Release Notes option. Release notes included with this kit are always copied to SYS$HELP. Additional Release Notes Options: 1. Display release notes 2. Print release notes 3. Both 1 and 2 4. None of the above * Select option [2]: Enter the number of the desired option and press Return. ___________________________________________________________ 6 Continue the installation. * Do you want to continue the installation [NO]? Enter Y and press Return. ___________________________________________________________ 7 Purge old Disk File Optimizer software files if you want to recover storage space on your disk. * Do you want to purge files replaced by this installation [YES]? Press Return to purge old files, else enter N and press Return. ___________________________________________________________ 8 Confirm the PAK registration. * Does this product have an authorization key registered and loaded? Enter Y and press Return. ___________________________________________________________ (continued on next page) 1-20 Installing Disk File Optimizer Software Installing Disk File Optimizer Software 1.3 Installing the Disk File Optimizer Software Table 1-7 (Cont.) How to Install the Disk File Optimizer __________________Software_________________________________ Step_Action________________________________________________ 9 Select to run the Installation Verification Procedure (IVP). * Do you want to run the IVP after the installation [YES]? Recommendation: Running the IVP procedure is recommended. Press Return to run the IVP, else enter N and press Return. ___________________________________________________________ 10 Confirm OpenVMS operating system disk files are set to not be moved. * Has SETFILENOMOVE.COM been executed against all system disks [NO]? If you have run SETFILENOMOVE.COM against all your OpenVMS operating system disks, enter Y and press Return. Otherwise, the installation procedure exits at this point. If you do not run SETFILENOMOVE.COM against all OpenVMS operating system disks before you install the Disk File Optimizer software, files on your system disks could be moved. This would cause access problems for utilities that access files directly rather than through the file system. Refer to Section 1.2.11 for more information. ___________________________________________________________ (continued on next page) Installing Disk File Optimizer Software 1-21 Installing Disk File Optimizer Software 1.3 Installing the Disk File Optimizer Software Table 1-7 (Cont.) How to Install the Disk File Optimizer __________________Software_________________________________ Step_Action________________________________________________ 11 Select an installation variant. * Do you want to install Defrag or Defrag PLUS [PLUS]? To install the Defrag PLUS software, enter PLUS (or press Return). To install the Defrag software, enter Defrag. See Table 1-1 for more information. ___________________ Note ___________________ If you select Defrag, Steps 13 through 17 do not occur. ___________________________________________ ___________________________________________________________ 12 Choose to install the DECwindows interface. * Do you want to install the Defrag DECwindows interface [YES]? If you want to install the DECwindows interface, press Return. If you do not want to install the DECwindows interface, enter No and press Return. ___________________________________________________________ 13 Choose whether or not to install the callable interface. * Do you wish to install the DFO callable interface [NO]? If you need to install the callable interface, enter Y and press Return. The installation procedure will install the appropriate files. Otherwise, press Return and the installation procedure continues to the next step. ___________________________________________________________ (continued on next page) 1-22 Installing Disk File Optimizer Software Installing Disk File Optimizer Software 1.3 Installing the Disk File Optimizer Software Table 1-7 (Cont.) How to Install the Disk File Optimizer __________________Software_________________________________ Step_Action________________________________________________ 14 Choose the location of the scheduling database. * Device and directory to contain the scheduling database files [SYS$COMMON:[DFG$DATABASE]]: You have chosen the following as a location for the defragmentation scheduling and parameter database: SYS$COMMON:[DFG$DATABASE] * Is this device and directory correct [YES]? If you want to use the default directory, press Return. Otherwise, enter the directory name and press Return. ___________________________________________________________ 15 Decide about using existing database if present. The following scheduling/parameter database already exists: DISK$USER1:[DFG$DATABASE]DFG$DB.DAT; DISK$USER1:[DFG$DATABASE]DFG$FILE.DAT; DISK$USER1:[DFG$DATABASE]DFG$GENERAL.DAT; DISK$USER1:[DFG$DATABASE]DFG$NODE.DAT; DISK$USER1:[DFG$DATABASE]DFG$QUEUE.DAT; DISK$USER1:[DFG$DATABASE]DFG$SCRIPT.DAT; DISK$USER1:[DFG$DATABASE]DFG$VOLUME.DAT; * Do you wish to use it [YES]? This message appears only if a database already exists in the chosen database directory. Press return to use the existing database. ___________________________________________________________ (continued on next page) Installing Disk File Optimizer Software 1-23 Installing Disk File Optimizer Software 1.3 Installing the Disk File Optimizer Software Table 1-7 (Cont.) How to Install the Disk File Optimizer __________________Software_________________________________ Step_Action________________________________________________ 16 Choose the name of the mail distribution file. * Mail distribution file name [SYS$COMMON:[DFG$DATABASE]DFG$MAIL.DIS]: The mail distribution file for notification messages is SYS$COMMON:[DFG$DATABASE]DFG$MAIL.DIS; * Is this the correct file specification [YES]? The mail distribution file is created during installation. You may specify a list of user names for this distribution list or take the default, which is the user name of the installing account. ___________________________________________________________ 17 Specify whether or not to change the contents of the mail distribution file. By default, the mail distribution file contains only the user name of the installing account. * Do you want to override the default contents of {mail.DIS} [NO]? Press Return if you wish the notification list to contain only the user name of the installing account. Enter Y if you want to specify a different mailing list. If you enter Y, the installation procedure prompts you for a list of user names. Separate the user names with commas, for example: USER1, USER2, USER3[,...]. ___________________________________________________________ (continued on next page) 1-24 Installing Disk File Optimizer Software Installing Disk File Optimizer Software 1.3 Installing the Disk File Optimizer Software Table 1-7 (Cont.) How to Install the Disk File Optimizer __________________Software_________________________________ Step_Action________________________________________________ (continued on next page) Installing Disk File Optimizer Software 1-25 Installing Disk File Optimizer Software 1.3 Installing the Disk File Optimizer Software Table 1-7 (Cont.) How to Install the Disk File Optimizer __________________Software_________________________________ Step_Action________________________________________________ 18 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. If you chose to have files purged, that work is done now. The following message is displayed: No more input is required to complete this installation. From this point it proceeds automatically. The following messages are displayed when the installation procedure converts the RMS database to do away with index key compression: Attempting to convert your RMS database so there is no index key compression. This requires converting the database. The old database files will be renamed to: DFG$DATABASE:DFG$DB_OLD.DAT DFG$DATABASE:DFG$FILE_OLD.DAT DFG$DATABASE:DFG$GENERAL_OLD.DAT DFG$DATABASE:DFG$NODE_OLD.DAT DFG$DATABASE:DFG$QUEUE_OLD.DAT DFG$DATABASE:DFG$SCRIPT_OLD.DAT DFG$DATABASE:DFG$VOLUME_OLD.DAT After you are satisfied with the installation, you may wish to delete these files. After the files have been moved, the installation procedure starts a scheduling process on the installing node. The name, ID, and log file for this process are displayed: %RUN-S- 1-26 InstalPROC_ID,kidentificationrofocreated process is 0000012B Defragmentation scheduler, DFG$XXXX started on XXXX Scheduler log file: DFG$DATABASE:DFG$XXXX.LOG The name of the scheduler process is DFG$_XXXX, where XXXX is the node name where the scheduler is executing. ___________________ Note ___________________ The name of the node comes from either the SYSGEN parameter, SCSNODE, or if SCSNODE is undefined, from the system logical name, SYS$NODE. At least one of these must indicate a valid node name or the defragmentation software will not work correctly. ___________________________________________ (continued on next page) Installing Disk File Optimizer Software 1.3 Installing the Disk File Optimizer Software Table 1-7 (Cont.) How to Install the Disk File Optimizer __________________Software_________________________________ Step_Action________________________________________________ ___________________________________________________________ 19 Observe the IVP. If you chose to run the IVP, VMSINSTAL runs it now. When the IVP begins, the following message is displayed: Beginning the 2.4 installation verification procedure When the IVP completes successfully, the following message is displayed: _____Installation_verification_for_2.4_has_successfully_completed 1.3.3 Error Recovery If errors occur during the installation or when the IVP is running, VMSINSTAL displays failure messages. If the installation fails, the following message is displayed: %VMSINSTAL-E-INSFAIL, The installation of DFG Version 2.4 has failed. If the IVP fails, the following messages are displayed: The DFG Version 2.4 Installation Verification Procedure failed. %VMSINSTAL-E-IVPFAIL, The IVP for DFG Version 2.4 has failed. Errors can occur during the installation if any of the following conditions exist: o Incorrect operating system version o Incorrect prerequisite software version o Insufficient quotas o Insufficient system parameter values o VMS Help library is currently in use o Product license has not been registered and loaded Installing Disk File Optimizer Software 1-27 Installing Disk File Optimizer Software 1.3 Installing the Disk File Optimizer Software For descriptions of the error messages generated by these conditions, see the VMS documentation about system messages, recovery procedures, and VMS software installation. If you are notified that any of these conditions exist, take the appropriate action as described in the message. 1.4 After Installing the Disk File Optimizer Perform the following tasks after installing the Disk File Optimizer: o Run the IVP separately to verify the installation o Edit the system startup and shutdown files o Make the Disk File Optimizer software usable on a VMScluster system o Resolve database errors o Delete old copies of the database files o Verify account requirements o Report any problems 1.4.1 Running the IVP Separately You usually run the Installation Verification Procedure (IVP) during the installation by responding YES to the question: * Do you want to run the IVP after the installation [YES]? If you did not run the IVP during the installation, or if you want to run the IVP separately to confirm the integrity of installed files, execute the IVP by entering this command: $ @SYS$TEST:DFG$IVP.COM Requirements: The Disk File Optimizer software must be running on the system where the IVP is executed. 1-28 Installing Disk File Optimizer Software Installing Disk File Optimizer Software 1.4 After Installing the Disk File Optimizer 1.4.2 Editing the Systemwide Command Files System_startup: You must edit the system startup procedure to ensure automatic startup of the Disk File Optimizer software each time the system boots. Add the following line to SYS$MANAGER:SYSTARTUP_V5.COM: or SYS$MANAGER:SYSTARTUP_VMS.COM: $ @SYS$STARTUP:DFG$STARTUP.COM If you installed DEC C/C++ run-time components as described in Section 1.2.8, you must start up the run-time components. Add the following line to your startup file after the line that invokes the network startup command procedure: $ @SYS$MANAGER:STARTNET.COM . . . $ @SYS$STARTUP:CRT$STARTUP.COM System_shutdown: You can modify the system shutdown file to provide for an orderly shutdown of the Disk File Optimizer. To do this, add the following line to SYS$MANAGER:SYSHUTDWN.COM: $ @SYS$MANAGER:DFG$SHUTDOWN.COM 1.4.3 Making the Disk File Optimizer Work on a VMScluster System To make the Disk File Optimizer available on all nodes of the cluster, you should ensure that all nodes have the latest version of DCLTABLES.EXE installed. You can do this by using SYSMAN or by logging in to each node in the cluster and entering the following command: $ INSTALL REPLACE SYS$COMMON:[SYSLIB]DCLTABLES.EXE Installing Disk File Optimizer Software 1-29 Installing Disk File Optimizer Software 1.4 After Installing the Disk File Optimizer 1.4.4 Deleting Old Copies of the RMS Database Files If you upgraded the Defrag PLUS variant of Disk File Optimizer, there are seven old files on your disk: o DFG$DATABASE:DFG$DB_OLD.DAT o DFG$DATABASE:DFG$FILE_OLD.DAT o DFG$DATABASE:DFG$GENERAL_OLD.DAT o DFG$DATABASE:DFG$NODE_OLD.DAT o DFG$DATABASE:DFG$QUEUE_OLD.DAT o DFG$DATABASE:DFG$SCRIPT_OLD.DAT o DFG$DATABASE:DFG$VOLUME_OLD.DAT You can delete these files. 1.4.5 Loading The New Database After Upgrading from Disk File Optimizer V1.0 If you are upgrading from Disk File Optimizer V1.0 and have saved the data in your database, you must restore it. If you saved your database data as described in Section 1.2.1, you can load it into your new RMS database using the following command: $ @LOAD_DB 1.4.6 Verifying Account Requirements The following privileges are required to run the Disk File Optimizer software: o BYPASS o CMKRNL o DETACH o NETMBX o SHARE o SYSGBL o SYSLCK o SYSPRV o TMPMBX 1-30 Installing Disk File Optimizer Software Installing Disk File Optimizer Software 1.4 After Installing the Disk File Optimizer o WORLD 1.4.7 Reporting Problems If you encounter a problem while using the Disk File Optimizer, report it to Digital Customer Services. Depending upon the nature of the problem and the type of support you have purchased, you can take one of the following actions: o Call Digital Customer Services if your software contract or warranty agreement entitles you to telephone support. o Submit a Software Performance Report (SPR). Review the Software Product Description (SPD) and Warranty Addendum for an explanation of warranty. If you encounter a problem during the warranty period, report the problem as indicated above or follow alternate instructions provided by Digital for reporting SPD nonconformance problems. Installing Disk File Optimizer Software 1-31 A _________________________________________________________________ Disk File Optimizer Logicals and Files A.1 Files Added to System by the Disk File Optimizer The following files are permanently added to the system when you install the Defrag PLUS variant. Files marked with an asterisk (*) are not added if you install the Defrag variant: o DFG$DATABASE (directory, typically SYS$COMMON:[000000]DFG$DATABASE.DIR) * o DFG$DATABASE:DFG$DB.DAT * o DFG$DATABASE:DFG$FILE.DAT * o DFG$DATABASE:DFG$GENERAL.DAT * o DFG$DATABASE:DFG$MAIL.DIS * o DFG$DATABASE:DFG$NODE.DAT * o DFG$DATABASE:DFG$QUEUE.DAT * o DFG$DATABASE:DFG$SCRIPT.DAT * o DFG$DATABASE:DFG$VOLUME.DAT * o SYS$COMMON:[SYS$STARTUP]DFG$STARTUP.COM o SYS$COMMON:[SYS$STARTUP]DFG$START_SCHEDULER.COM * o SYS$COMMON:[SYSEXE]DFG$CREATE_DATABASE.EXE * o SYS$COMMON:[SYSEXE]DFG$DCL.EXE o SYS$COMMON:[SYSEXE]DFG$ENGINE_MAIN.EXE o SYS$COMMON:[SYSEXE]DFG$INIT_DATABASE.EXE * o SYS$COMMON:[SYSEXE]DFG$SCHEDULER.EXE * o SYS$COMMON:[SYSEXE]DFG$STOP_SCHEDULER.EXE * o SYS$COMMON:[SYSEXE]DFG$REFORMAT_DB_RMS.EXE * Disk File Optimizer Logicals and Files A-1 Disk File Optimizer Logicals and Files A.1 Files Added to System by the Disk File Optimizer o SYS$COMMON:[SYSEXE]DFG$REFORMAT_DB.EXE * o SYS$COMMON:[SYSHLP]DEFRAGMENT.HLB o SYS$COMMON:[SYSHLP]DFGxxx.RELEASE_NOTES o SYS$COMMON:[SYSLIB]DFG$DEFRAGMENTSHR.EXE * o SYS$COMMON:[SYSLIB]DFG$RELATIONSHR.EXE * o SYS$COMMON:[SYSLIB]DFG$RMSSHR.EXE * o SYS$COMMON:[SYSLIB]DFG$UTILITYSHR.EXE o SYS$COMMON:[SYSMGR]DFG$DEINSTAL.COM o SYS$COMMON:[SYSMGR]DFG$SHUTDOWN.COM o SYS$COMMON:[SYSMGR]DFG$STOP_SCHEDULER.COM * o SYS$COMMON:[SYSMSG]DFG$MESSAGE.EXE o SYS$COMMON:[SYSTEST]DFG$IVP.COM If you install the GUI interface, the following additional files are created: o SYS$COMMON:[DECW$DEFAULTS.USER]DFG$DW.DAT o SYS$COMMON:[DECW$DEFAULTS.USER]DFG$DW.UID o SYS$COMMON:[SYSEXE]DFG$DW.EXE o SYS$COMMON:[SYSHLP]DFG$DW.HLB If you install the callable interface, the following additional files are created: o SYS$COMMON:[SYSLIB]DFG$DEF.FOR o SYS$COMMON:[SYSLIB]DFG$DEF.H o SYS$COMMON:[SYSLIB]DFG$DEF.MAR o SYS$COMMON:[SYSLIB]DFG$DEF.PAS o SYS$COMMON:[SYSLIB]DFG$DEF.R32 A-2 Disk File Optimizer Logicals and Files Disk File Optimizer Logicals and Files A.2 Logical Names A.2 Logical Names Logical names for the Disk File Optimizer begin with the prefix DFG$. Table A-1 describes each logical name. Table_A-1_Logical_Names__________________________________________ Installation Logical Name________________Variant_____Purpose__________________________ DFG$DATABASE Defrag Equates to the device:[dir] PLUS specification where the database resides. Also located in this directory are the scheduler log files, which have a name of DFG$_xxxx.LOG, where xxxx is the name of the node on which the scheduler is running. DFG$DISK All Provided to the EPILOGUE and PROLOGUE command files. It translates to the name of the disk on which DFO currently operates. DFG$MAIL_ADDRESS Defrag Equates to a file name containing PLUS a mail distribution list of those who should receive notification when defragmentation processes complete. DFG$MESSAGE All Equates to SYS$MESSAGE:DFG$MESSAGE.EXE, which is the shareable image containing all the defragmentation-specific messages. This logical is used only if you install the callable interface. (continued on next page) Disk File Optimizer Logicals and Files A-3 Disk File Optimizer Logicals and Files A.2 Logical Names Table_A-1_(Cont.)_Logical_Names__________________________________ Installation Logical Name________________Variant_____Purpose__________________________ DFG$SCRIPT All Provided to the EPILOGUE and PROLOGUE command files. It translates to the name of the script associated with the DFO process. DFG$STATE All Provided to the EPILOGUE and PROLOGUE command files. As appropriate to indicate the state of DFO to the command procedure, it translates to either of these strings PROLOGUE EPILOGUE DFG$STATUS All Provided to the EPILOGUE and PROLOGUE command files. It translates to the current status of the DFO process. For the EPILOGUE command file, this status is the final status of the DFO process. DFG$ASTLM All These logicals affect the DFG$BIOLM associated process quota of DFG$BYTLM any DFO process running on the DFG$DIOLM associated node. DFG$ENQLM Refer to the guide to operations DFG$FILLM for more information. DFG$JTQUOTA DFG$PGFLQUOTA DFG$PRCLM DFG$TQELM DFG$WSDEFAULT DFG$WSEXTENT DFG$WSQUOTA (continued on next page) A-4 Disk File Optimizer Logicals and Files Disk File Optimizer Logicals and Files A.2 Logical Names Table_A-1_(Cont.)_Logical_Names__________________________________ Installation Logical Name________________Variant_____Purpose__________________________ DFG$TRANSFERSIZE All The logical, DFG$TRANSFERSIZE, helps you tune the Disk File Optimizer. The definition of this logical allows you to change the amount of data that is transferred at one time. On a volume that has files with large extents, you could wait up to 20 minutes while the system transfers these large extents before you could access the file. By defining this logical, you could access this file in less than a minute. This logical changes the impact that the Disk File Optimizer has on applications that are simultaneously accessing the same files. This logical is set to 10,000 blocks by default. You can change it by editing SYS$STARTUP:DFG$STARTUP.COM and then executing the command ________________________________procedure._______________________ Disk File Optimizer Logicals and Files A-5 B _________________________________________________________________ Example Disk File Optimizer Installation B.1 Example Installation This appendix contains an example installations for the Disk File Optimizer software. Example B-1 shows an example installation log for installing Defrag PLUS. As you look through this example, note the following things: o The first line in the example shows the command used to generate the installation. o If you do not have existing Defrag PLUS database files on the volume, the following lines do not appear: Example Disk File Optimizer Installation B-1 Example Disk File Optimizer Installation B.1 Example Installation The following scheduling/parameter database already exists: DISK$USER1:[DFG$DATABASE]DFG$DB.DAT; DISK$USER1:[DFG$DATABASE]DFG$FILE.DAT; DISK$USER1:[DFG$DATABASE]DFG$GENERAL.DAT; DISK$USER1:[DFG$DATABASE]DFG$NODE.DAT; DISK$USER1:[DFG$DATABASE]DFG$QUEUE.DAT; DISK$USER1:[DFG$DATABASE]DFG$SCRIPT.DAT; DISK$USER1:[DFG$DATABASE]DFG$VOLUME.DAT; * Do you wish to use it [YES]? Attempting to convert your RMS database so there is no index key compression. This requires converting the database. The old database files will be renamed to: DFG$DATABASE:DFG$DB_OLD.DAT DFG$DATABASE:DFG$FILE_OLD.DAT DFG$DATABASE:DFG$GENERAL_OLD.DAT DFG$DATABASE:DFG$NODE_OLD.DAT DFG$DATABASE:DFG$QUEUE_OLD.DAT DFG$DATABASE:DFG$SCRIPT_OLD.DAT DFG$DATABASE:DFG$VOLUME_OLD.DAT After you are satisfied with the installation, you may wish to delete these files. o During the IVP, this installation runs the DEFRAGMENT SHOW {volume_name} command for the volume on which it is installing. The information shown indicates how badly the volume is fragmented. Example B-1 Example Installation for Defrag PLUS xxx -> @sys$update:vmsinstal DFG022 DISK$KIT:[DFO] (continued on next page) B-2 Example Disk File Optimizer Installation Example Disk File Optimizer Installation B.1 Example Installation Example B-1 (Cont.) Example Installation for Defrag PLUS OpenVMS AXP Software Product Installation Procedure V7.0 It is 10-MAY-1996 at 14:55. Enter a question mark (?) at any time for help. %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account. %VMSINSTAL-W-ACTIVE, The following processes are still active: DECW$SERVER_0 DECW$MWM DECW$TE_0068 _FTA5: * Do you want to continue anyway [NO]? y * Are you satisfied with the backup of your system disk [YES]? y The following products will be processed: DFG 2.4 Beginning installation of DFG 2.4 at 14:55 %VMSINSTAL-I-RESTORE, Restoring product save set A ... %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. * Do you want to purge files replaced by this installation [YES]? Product: DFG Producer: DEC Version: 2.4 Release Date: 13-MAY-1996 * Does this product have an authorization key registered and loaded? y This kit contains an Installation Verification Procedure (IVP) to verify the correct installation of the Defragmentation software. It can be run prior to the conclusion of this procedure by answering "YES" to the IVP prompt or it can be invoked after the installation as follows: @SYS$TEST:DFG$IVP.COM * Do you want to run the IVP after the installation [YES]? You must run the @SYS$SYSTEM:SETFILENOMOVE.COM command procedure against ALL system disks in your cluster. You must do this before running the defragmentation software on a system disk. Failure to run this command procedure and to later run the defragmentation software on the system disk could result in corruption of the system disk. (continued on next page) Example Disk File Optimizer Installation B-3 Example Disk File Optimizer Installation B.1 Example Installation Example B-1 (Cont.) Example Installation for Defrag PLUS * Has SETFILENOMOVE.COM been executed against all system disks? y * Do you want to install Defrag or Defrag PLUS [PLUS]: * Do you want to install the Graphical User Interface [YES]? * Do you wish to install the callable interface [NO]? %DFGT1-I-LOGDEFINED, The logical name DFG$DATABASE was defined You have selected the following as a location for the defragmentation scheduling and parameter database: DISK$USER1:[DFG$DATABASE] * Is this device and directory correct [YES]? The following scheduling/parameter database already exists: DISK$USER1:[DFG$DATABASE]DFG$DB.DAT; DISK$USER1:[DFG$DATABASE]DFG$FILE.DAT; DISK$USER1:[DFG$DATABASE]DFG$GENERAL.DAT; DISK$USER1:[DFG$DATABASE]DFG$NODE.DAT; DISK$USER1:[DFG$DATABASE]DFG$QUEUE.DAT; DISK$USER1:[DFG$DATABASE]DFG$SCRIPT.DAT; DISK$USER1:[DFG$DATABASE]DFG$VOLUME.DAT; * Do you wish to use it [YES]? %DFGT1-I-LOGDEFINED, The logical name DFG$MAIL_ADDRESS was defined The DFG$MAIL_ADDRESS logical is defined as follows: DISK$USER1:[DFG$DATABASE]DFG$MAIL.DIS; * Do you wish to use this file [YES]? The mail distribution file for notification messages is DISK$USER1:[DFG$DATABASE]DFG$MAIL.DIS; * Is this the correct file specification [YES]? By default, the mail distribution file contains only the username of the installing account. * Do you want to override the default contents [NO]? (continued on next page) B-4 Example Disk File Optimizer Installation Example Disk File Optimizer Installation B.1 Example Installation Example B-1 (Cont.) Example Installation for Defrag PLUS +-----------------------------------------------------------------------+ | No more input required. | | | | Please perform the following after the installation completes: | | | | 1. Place @SYS$STARTUP:DFG$STARTUP in SYS$MANAGER:SYSTARTUP_VMS.COM | | (VMS V6.* or V7.*) or in SYS$MANAGER:SYSTARTUP_V5.COM (VMS V5.*). | | | | 2. Place @SYS$MANAGER:DFG$SHUTDOWN in SYS$MANAGER:SYSHUTDWN.COM | | | +-----------------------------------------------------------------------+ %VMSINSTAL-I-RESTORE, Restoring product save set F ... %VMSINSTAL-I-RESTORE, Restoring product save set G ... Attempting to convert your RMS database so there is no index key compression. This requires converting the database. The old database files will be renamed to: DFG$DATABASE:DFG$DB_OLD.DAT DFG$DATABASE:DFG$FILE_OLD.DAT DFG$DATABASE:DFG$GENERAL_OLD.DAT DFG$DATABASE:DFG$NODE_OLD.DAT DFG$DATABASE:DFG$QUEUE_OLD.DAT DFG$DATABASE:DFG$SCRIPT_OLD.DAT DFG$DATABASE:DFG$VOLUME_OLD.DAT After you are satisfied with the installation, you may wish to delete these files. %DFGT1-I-COPYING, Copying database to working directory... %DFGT1-I-COPYING, Renaming database files... %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories... %RUN-S-PROC_ID, identification of created process is 27E00386 Defragmentation scheduler, DFG$SPIELN started on SPIELN Scheduler log file: DFG$DATABASE:DFG$SPIELN.LOG Beginning the 2.4 installation verification procedure (continued on next page) Example Disk File Optimizer Installation B-5 Example Disk File Optimizer Installation B.1 Example Installation Example B-1 (Cont.) Example Installation for Defrag PLUS Testing SHOW of database parameters. Disk File Optimizer for OpenVMS DFG 2.4 © 1998, Digital Equipment Corporation SPIELN CPU limit: 0 I/O limit: 0 process limit: 0 ILDUCE CPU limit: 0 I/O limit: 0 process limit: 0 Testing SHOW of volume fragmentation. Disk File Optimizer for OpenVMS DFG 2.4 © 1998, Digital Equipment Corporation F r a g m e n t a t i o n R e p o r t DISK$ALPHA070 10-MAY-1996 14:57:24.05 The fragmentation index is 12.9 1 - 20.9 is excellent 21 - 40.9 is good 41 - 60.9 is fair 61 - 80.9 is poor 81 - 100 indicates a badly fragmented disk Approximately 3.3 (out of 80.0 possible) is due to file fragmentation Approximately 9.6 (out of 20.0 possible) is due to freespace fragmentation Freespace Summary: Total free space: 226348 blocks Percentage free: 11 (rounded) Total free extents: 48 Maximum free extent: 114276 blocks, LBN: 610892 Minimum free extent: 4 blocks, LBN: 173508 Average free extent: 4715 blocks Median free extent: 80 blocks File Fragmentation Summary: Number of files (with some allocation): 5894 Total file extents on the disk: 6039 Average number of file extents per file: 1.024601 Median number of file extents per file: 1 (continued on next page) B-6 Example Disk File Optimizer Installation Example Disk File Optimizer Installation B.1 Example Installation Example B-1 (Cont.) Example Installation for Defrag PLUS Most Fragmented File: [VMS$COMMON.SYSEXE]SYS$QUEUE_MANAGER.QMAN$JOURNAL;1 (55 extents) Installation verification for 2.4 has successfully completed Installation of DFG 2.4 completed at 14:57 Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY Creating installation data file:VMI$ROOT:[SYSUPD]DFG024.VMI_DATA VMSINSTAL procedure done at 14:57 Example Disk File Optimizer Installation B-7 _________________________________________________________________ Index D How to _______________________________ register (cont'd) Defrag PAK, 1-14 available subcommands, 1-4 shut down Disk File Optimizer description of, 1-3 software, 1-13 logicals, 1-4 Defrag PLUS I available subcommands, 1-4 _______________________________ description of, 1-3 Installation installation example, B-1 disk space requirements, 1-5 logicals, 1-4 error recovery, 1-27 Disk File Optimizer files created, A-1 installing on a VMScluster logical names, A-3 system, 1-8 operating privileges, 1-30 postinstallation procedures, E______________________________ 1-28 Editing the systemwide command privileges, 1-5 files, 1-29 procedure, 1-18 Error notification, A-3 required VMS version, 1-5 requirements, 1-1 upgrading from V1.0, 1-3 F______________________________ variants, 1-3 Free disk blocks verification, 1-28 how to determine, 1-5 VMScluster system considerations, 1-8 H______________________________ Installation, How to process account quotas, 1-7 edit systemwide command files system parameter values, 1-6 , 1-29 install software, 1-18 register Disk File Optimizer license, 1-14 Index-1 Product Authorization Key, L______________________________ 1-14 Licensing registration, 1-14 how to register, 1-14 R software, 1-14 _______________________________ where to find information, Release notes, 1-2 1-14 Reporting problems, 1-31 Log file Requirements See also Scheduler installation, 1-1 Logicals DFG$DATABASE, A-3 S______________________________ DFG$DISK, A-3 Scheduler DFG$MAIL_ADDRESS, A-3 log files, A-3 DFG$MESSAGE, A-3 Scheduling database DFG$SCRIPT, A-4 VMScluster system DFG$STATE, A-4 requirements, 1-8 DFG$STATUS, A-4 SCSNODE, 1-26 list of, A-3 Software how to install, 1-18 M______________________________ kit name, 1-14 Mail distribution file license name, 1-14 See also Logicals, DFG$MAIL_ shutting down Disk File ADDRESS Optimizer software, 1-13 SYS$NODE, 1-26 P System shutdown procedure, _______________________________ 1-29 PAK System startup procedure, 1-29 See Product Authorization Key patches, 1-11 U______________________________ Postinstallation Upgrading editing systemwide command from V1.0, 1-3 files, 1-29 prerequisites V patches, 1-11 _______________________________ Privileges V1.0 required for operating, 1-30 upgrading, 1-3 required to perform installation, 1-5 Index-2