                                             H                     Disk_File_Optimizer_________________________________&                     Installation Guide    -                     Order Number: AA-QYZ2A-TE                         A                     This installation guide provides installation G                     information for the Disk File Optimizer for OpenVMS -                     layered software product.               >                     Software Version:             Version V2.2  1                     Digital Equipment Corporation *                     Maynard, Massachusetts                 N               ________________________________________________________________               October 1996  C               The information in this document is subject to change H               without notice and should not be construed as a commitmentA               by Digital Equipment Corporation. Digital Equipment G               Corporation assumes no responsibility for any errors that *               may appear in this document.  H               The software described in this document is furnished underI               a license and may be used or copied only in accordance with (               the terms of such license.  E               No responsibility is assumed for the use or reliability F               of software on equipment that is not supplied by Digital@               Equipment Corporation or its affiliated companies.  3                Digital Equipment Corporation 1996. "               All rights reserved.               Printed in U.S.A.   D               The Reader's Comment Card on the last page of the hardH               copy version of this document requests the user's criticalE               evaluation to assist in preparing future documentation.   B               Alpha, AXP, DEC, DECUS, DECnet, DECps, DECscheduler,D               DECwindows, OpenVMS, PDP, UNIBUS, VAX, VAX PerformanceE               Advisor, VAX SPM, VAX SQL, VAXcluster, VMS, VPA, VT100, F               and the DIGITAL logo are trademarks of Digital Equipment               Corporation.  D               All other trademarks and registered trademarks are the3               property of their respective holders.   I               This document was prepared using VAX DOCUMENT, Version 2.1.                                  F      _________________________________________________________________  F                                                               Contents      F      Preface...................................................      v  /      1  Installing Disk File Optimizer Software   F          1.1  Introduction.....................................    1-1:          1.2  Preparing to Install the Disk File OptimizerF               Software.........................................    1-1F          1.2.1  Upgrading From Disk File Optimizer V1.0 .......    1-2F          1.2.2  Installation Variants .........................    1-3F          1.2.3  Hardware and Software Requirements ............    1-5F          1.2.4  Minimum System Parameter Values ...............    1-6F          1.2.5  Process Account Quotas ........................    1-7F          1.2.6  VMScluster System Considerations ..............    1-8F          1.2.7  DEC C/C++ Run-Time Components Considerations ..    1-8?          1.2.8  Shutting Down the Previous Version of Disk File F                 Optimizer Software.............................    1-9F          1.2.9  Execute SYS$SYSTEM:SETFILENOMOVE.COM ..........    1-9<          1.2.10 Registering the Disk File Optimizer SoftwareF                 License........................................   1-10F          1.2.10.1  License and Kit Names.......................   1-107          1.2.10.2  Registering Your Disk File Optimizer F                    License.....................................   1-11F          1.3  Installing the Disk File Optimizer Software......   1-13F          1.3.1  Before You Begin-Questions and Answers ........   1-13F          1.3.2  Installation Procedure ........................   1-14F          1.3.3  Error Recovery ................................   1-23F          1.4  After Installing the Disk File Optimizer.........   1-24F          1.4.1  Running the IVP Separately ....................   1-24F          1.4.2  Editing the Systemwide Command Files ..........   1-258          1.4.3  Making the Disk File Optimizer Work on aF                 VMScluster System..............................   1-257          1.4.4  Deleting Old Copies of the RMS Database F                 Files..........................................   1-26  F                                                                    iii                   @            1.4.5   Loading The New Database After Upgrading fromI                    Disk File Optimizer V1.0.......................   1-26 I            1.4.6   Verifying Account Requirements ................   1-26 I            1.4.7   Reporting Problems ............................   1-27   1         A  Disk File Optimizer Logicals and Files   @            A.1  Files Added to System by the Disk File OptimizerI                 .................................................     A-1 I            A.2  Logical Names....................................     A-3   3         B  Example Disk File Optimizer Installation   I            B.1  Example Installation.............................     B-1   
         Index              Examples  I            B-1     Example Installation for Defrag PLUS ..........    B-2            Tables  I            1-1     Differences Between Installation Variants .....    1-4   I            1-2     Disk Space Requirements .......................    1-5   I            1-3     Minimum System Parameter Values ...............    1-6   <            1-4     Process Account Quotas for the InstallingI                    Account........................................    1-7   ;            1-5     How to Register Your Disk File Optimizer I                    License........................................   1-11   9            1-6     How to Install the Disk File Optimizer I                    Software.......................................   1-14   I            A-1     Logical Names .................................    A-3           
         iv                             I         _________________________________________________________________   I                                                                   Preface                    Purpose of This Guide   H               The installation guide contains the installation procedureA               for installing the Disk File Optimizer for OpenVMS.            Intended Audience   D               The intended audience is the system administrators who7               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  D               o  VMS Analyze/disk_structure Utility (part of the VMS4                  Version 5.0 Base Documentation Set)  #               o  VMS DCL Dictionary   *               o  VMS File System Internals  G               o  VMS License Management Utility Manual (part of the VMS 4                  Version 5.0 Base Documentation Set)  -               o  VMS System Management Subkit   I               Order numbers for these documents can be obtained from your +               Digital Sales Representative.   I                                                                         v                             Conventions   @               The following conventions are used in this manual:  I               ___________________________________________________________ I               Convention_______Meaning___________________________________   B               {parameter}      In command formats, braces indicateD                                required parameters. Do not enter theG                                braces when you enter the parameter in a '                                command.   B               [parameter]      In command formats, square bracketsI                                indicate optional parameters. Do not enter G                                the brackets when you enter the optional *                                parameters.  I               [ ]              In interactive procedures, square brackets 8                                denote default responses.  D               italic text      In examples and messages, italic textG                                represents input that is unique for each &                                system.  B               boldface text    Boldface text is used for emphasis.  B               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 G               .                represents the omission of data that the G               .                system displays in response to a command :                                or data that a user enters.  H               file-            In command formats, a horizontal ellipsisH               spec[, . . . ]   indicates that the preceding items can beI               _________________repeated_one_or_more_times._______________   &         References to Digital Products  B               The following Digital products are mentioned in this               manual:   
         vi                 I               ___________________________________________________________ I               Product__________Formal_Product_Name_______________________   E               Disk File        Disk File Optimizer refers to the Disk C               Optimizer        File Optimizer for OpenVMS software.   G               Defrag           Defrag refers to a variation of the Disk D                                File Optimizer software that providesD                                basic file and volume defragmentation,                                capabilities.  E               Defrag PLUS      Defrag PLUS refers to the variation of D                                the Disk File Optimizer software thatF                                supports all of the features of Defrag,B                                plus scheduling and command storing,                                capabilities.  H               VPA              VPA refers to the VAX Performance Advisor(                                software.  B               DECps            DECps refers to the DEC Performance1                                Solution software.   D               OpenVMS          OpenVMS refers to the OpenVMS VAX andI               _________________OpenVMS_Alpha_operating_systems.__________                                           I                                                                       vii                          I                                                                         1 I         _________________________________________________________________   I                                   Installing Disk File Optimizer Software              1.1 Introduction  A               This chapter describes how to install the Disk File E               Optimizer software. It includes the following sections:   +               o  Preinstallation activities   '               o  Installation procedure   ,               o  Postinstallation activities  A         1.2 Preparing to Install the Disk File Optimizer Software   F                 ___________________ Recommendation ___________________  =                 Performing a backup of your system disk prior =                 to installing Disk File Optimizer software is C                 recommended. Refer to the VMS Backup Utility Manual !                 for more details.   F                 ______________________________________________________  D               The following process describes preparations needed to7               install the Disk File Optimizer software.   I               ___________________________________________________________ I               Stage_Action_______________________________________________   H               1     Save scheduling database contents if up grading from                     V1.0  I               ___________________________________________________________ ;               2     Meet hardware and software requirements   I               ___________________________________________________________ @               3     Verify system parameters and required quotas  I               ___________________________________________________________   I                               Installing Disk File Optimizer Software 1-1            /         Installing Disk File Optimizer Software A         1.2 Preparing to Install the Disk File Optimizer Software   I               ___________________________________________________________ I               Stage_Action_______________________________________________   =               4     Evaluate VMScluster system considerations   I               ___________________________________________________________ I               5     Evaluate DEC C/C++ Run-Time Components considerations   I               ___________________________________________________________ F               6     Shut down previous versions of Disk File Optimizer)                     software on all nodes   I               ___________________________________________________________ F               7     Execute the SYS$SYSTEM:SETFILENOMOVE.COM procedureF                     against all OpenVMS operating system disks on your                     cluster   I               ___________________________________________________________ I               8_____Register_the_Disk_File_Optimizer_license_____________   F               Your bill of materials and indented bills report specify?               the contents of your media. Be sure to verify the E               contents of your kit with this information. If your kit F               is damaged or if parts are missing, contact your Digital               representative.   D               The installation procedure for the Disk File OptimizerH               provides online release notes. Digital strongly recommendsD               that you read the release notes before proceeding withG               the installation. For information on accessing the online +               release notes, see Table 1-6.   E               The Disk File Optimizer software installation procedure D               converts existing scheduling database files to the newD               version. If you have Disk File Optimizer V1.1 to V2.0,G               the installation will convert your Rdb database to an RMS I               database. If you are installing Disk File Optimizer Version 7               1.0, see Section 1.2.1 before installing.   5         1.2.1 Upgrading From Disk File Optimizer V1.0   I               If you are upgrading from Disk File Optimizer V1.0 and want G               to save the data in your database, you must save the data F               in a command procedure. Perform the following command to*               save in a command procedure:  9               $ DEFRAGMENT SHOW */COMMAND/OUT=LOAD_DB.COM   3         1-2 Installing Disk File Optimizer Software            I                                   Installing Disk File Optimizer Software I                 1.2 Preparing to Install the Disk File Optimizer Software     D               This command saves the data from your Rdb database andC               allows you restore it after installation of Disk File                Optimizer.  #         1.2.2 Installation Variants   E               The Disk File Optimizer kit allows for two installation                variants:   H               o  Defrag, which provides capabilities to defragment files                  and volumes  D               o  Defrag PLUS, which provides all the capabilities ofC                  Defrag plus scheduling and command storage options   G               Table 1-1 identifies the major differences between Defragi               and Defrag PLUS.  F               Defrag is recommended on any system where the additionalB               features are not desired or where disk space is very               limited.  I               Defrag PLUS is recommended on VMScluster systems and on anyiH               single-node system where the additional features of Defrag               PLUS are desired.a                                        I                               Installing Disk File Optimizer Software 1-3n ,  s      /         Installing Disk File Optimizer Software_A         1.2 Preparing to Install the Disk File Optimizer Software     I         Table_1-1_Differences_Between_Installation_Variants______________c  I         Difference_______Defrag_PLUS___________Defrag____________________e  8         Additional       Optional:             Optional:I         Software         o  VAX Performance    o  VAX Performance Advisoro  F                             Advisor (VPA)         (VPA) Version 2.1 or7                             Version 2.1 or        later 4                             later                 orA                             or                    DEC Performance B                             DEC Performance       Solution (DECps)F                             Solution (DECps)      Version 1.0 or later*                             Version 1.0 or!                             later            Available 7         Subcommands      o  ABORT              o  ABORT   8                          o  ATTACH             o  ATTACH  6                          o  CANCEL             o  EXIT  A                          o  DISABLE            o  DEFRAGMENT FILE   6                          o  ENABLE             o  HELP  9                          o  EXIT               o  MONITORC  D                          o  DEFRAGMENT FILE    o  DEFRAGMENT OFFLINE  6                          o  HELP               o  SHOW  7                          o  MODIFY             o  SPAWNa  C                          o  MONITOR            o  DEFRAGMENT VOLUME   &                          o  DEFRAGMENT#                             OFFLINEr  "                          o  REMOVE                            o  SETr                             o  SHOW  !                          o  SPAWN   !                          o  START_  -                          o  DEFRAGMENT VOLUME   3         1-4iInstalling DiskqFiledOptimizer Softwaret  (                          o  DFG$DATABASE  ,                          o  DFG$MAIL_ADDRESS  &                          Optional (for-                          callable interface):.  '                          o  DFG$MESSAGEr  I         _________________________________________________________________. .  .      I                                   Installing Disk File Optimizer SoftwareVI                 1.2 Preparing to Install the Disk File Optimizer Software.    0         1.2.3 Hardware and Software Requirements  =               The Disk File Optimizer free disk storage spaceP@               requirements are different during installation andB               after installation. Table 1-2 summarizes the storage               requirements..  I               Table_1-2_Disk_Space_Requirements__________________________o  -                               Blocks RequiredrA                               During              Blocks Required.I               Variant_________Installation________After_Installation_____E  6               Defrag PLUS     6700                3700               /VAX  6               Defrag PLUS     11700               7800               /Alpha  6               Defrag/VAX      3900                2800  I               Defrag/Alpha____5500________________3900___________________   H               To determine the number of free disk blocks on the currentI               system disk, enter the following command at the DCL prompt:   )               $ SHOW DEVICE SYS$SYSDEVICEs  G               The minimum version of software necessary to run the Disk.D               File Optimizer is OpenVMS for VAX V5.5 and OpenVMS for               Alpha V6.1.4  B               To install the software, you must be logged in to an1               account that has SETPRV privileges..  F                 ________________________ Note ________________________  D                 VMSINSTAL turns off BYPASS privilege at the start of!                 the installation..  F                 ______________________________________________________        I                               Installing Disk File Optimizer Software 1-56           /         Installing Disk File Optimizer Software A         1.2 Preparing to Install the Disk File Optimizer Softwarew    -         1.2.4 Minimum System Parameter ValuesD  F               This section lists those system parameters whose defaultD               values may be insufficient for proper operation of theI               defragmentation software. Table 1-3 lists these parameters, F               recommended minimum settings, and whether the parameters-               apply to Defrag or Defrag PLUS.   I         Table_1-3_Minimum_System_Parameter_Values________________________A  .         System        Minimum     InstallationI         Parameter_____Value_______Variant_Explanation____________________   A         GBLPAGES      2078        PLUS    Use the f$getsyi("free_ H                       (avail-             gblpages") lexical function toH                       able)               obtain the number of available7                                           global pages..  I         _________________________________________________________________.  I         GBLSECTIONS   80 (avail-  PLUS    Use the f$getsyi("gblsections").D                       able)               lexical function to obtainH                                           the number of available global3                                           sections.F  I         _________________________________________________________________.  H         RESHASHTBL    512         PLUS    Use SYSGEN to find this value.                       entries.  I         _________________________________________________________________s  H         SRPCOUNT[1]   1024        PLUS    Use SYSGEN to find this value.I                       packets             (Not applicable on OpenVMS Axp)_  I         _________________________________________________________________   H         SRPCOUNTV[1]  2048        PLUS    Use SYSGEN to find this value.I                       packets             (Not applicable on OpenVMS Axp) I         [1]This_parameter_only_exists_on_OpenVMS_prior_to_OpenVMS_V6.1.__A  I         _________________________________________________________________w      3         1-6 Installing Disk File Optimizer Software            I                                   Installing Disk File Optimizer Software I                 1.2 Preparing to Install the Disk File Optimizer Softwaret    $         1.2.5 Process Account Quotas  D               The account you use to install the Disk File OptimizerC               software must have sufficient quotas to enable you to H               perform the installation. Table 1-4 summarizes the processG               quotas required for the installing account, regardless ofM5               which installation variant you install.)  I               Table_1-4_Process_Account_Quotas_for_the_Installing_Accountb  I               Account_Quota____Value_____________________________________e  !               ASTLM            24   !               BIOLM            18   %               BYTLM            20,480   !               DIOLM            18   #               ENQLM            2048   !               FILLM            50_  !               PRCLM            10_  I               PGFLQUO__________20,000_____________________________________  D               User account quotas are stored in the SYSUAF.DAT file.E               Use the VMS Authorize utility (AUTHORIZE) to verify andeE               change user account quotas. First set your directory tom1               SYS$SYSTEM, and then run AUTHORIZE:   '               $  SET DEFAULT SYS$SYSTEMn               $  RUN AUTHORIZE               UAF>  H               At the UAF> prompt, enter the SHOW command with an account>               name to check a particular account, for example:                 UAF>  SHOW SMITH  H               To change a quota, enter the MODIFY command. The followingH               example changes the FILLM quota for the SMITH account, and*               then exits from the utility:  +               UAF>   MODIFY SMITH /FILLM=50e               UAF>   EXITr  B               After you exit from the utility, the system displaysH               messages indicating whether or not changes were made. OnceI               the changes have been made, you must log out and log in fory,               the new quotas to take effect.  I                               Installing Disk File Optimizer Software 1-7     o      /         Installing Disk File Optimizer Software A         1.2 Preparing to Install the Disk File Optimizer Software     G               For more information on modifying account quotas, see the D               description of the Authorize utility in the VMS System                Management Subkit.  .         1.2.6 VMScluster System Considerations  F               Use the following list of guidelines when installing the9               Disk File Optimizer on a VMScluster system:r  C               o  For Defrag PLUS, the scheduling database should bei:                  accessible from all nodes in the cluster.  I                  Make sure to place the scheduling database on a cluster- E                  accessible disk. Defragmentation can occur only from_4                  nodes that can access the database.  I               o  For Defrag PLUS, defragmentation can occur only on thosem3                  nodes running a scheduler process.   D                  The scheduler creates defragmentation processes andB                  runs them as detached processes. Because of this,F                  defragmentation can occur only from nodes that have a#                  running scheduler.n  B               o  After installation, install the latest version of;                  DCLTABLES.EXE on all nodes of your system.   G                  To make the Disk File Optimizer available on all nodes F                  of the cluster, you should ensure that all nodes haveC                  the latest version of DCLTABLES.EXE installed. Use G                  SYSMAN or log in to each node in the cluster and enterf'                  the following command:   C                  $ INSTALL REPLACE SYS$COMMON:[SYSLIB]DCLTABLES.EXEC  G               o  Be sure to install Disk File Optimizer on both the VAXoF                  and Alpha system in your VMScluster if it is a mix of'                  VAX and Alpha systems.O  :         1.2.7 DEC C/C++ Run-Time Components Considerations  E               Disk File Optimizer V2.2 has been compiled with the DEC F               C compiler and therefore requires the DEC C/C++ run-timeG               components. These components are not installed on OpenVMS_C               VAX V5.5-x and 6.0 systems unless you have previously G               installed them. This Disk File Optimizer kit includes the E               DEC C/C++ run-time components kit. During installation,nH               your version of SYS$LIBRARY:DECC$SHR.EXE is checked to seeF               if it is at V6.0 or greater. If the version is less, youE               are asked if you want to install the DEC C/C++ run-timet  3         1-8 Installing Disk File Optimizer SoftwareD    e      I                                   Installing Disk File Optimizer Software_I                 1.2 Preparing to Install the Disk File Optimizer Softwareo    F               components. You can get the release notes for the kit at               this time.  E               When the DEC C/C++ Run-Time Components kit is installed D               on an OpenVMS VAX Version 5.5, 5.5-1, or 5.5-2 system,E               some of the shareable image run-time components replaceoE               older versions of existing OpenVMS components. Prior to E               the installation you should read Chapter 1 of the DEC C D               /C++ Run-Time Components for OpenVMS VAX Reference and!               Installation Guide.n  G               You can extract the reference and installation guide from <               saveset DFG022.B using the following commands:  *               $ BACKUP/LOG DFG022.B/SAVE *5               %BACKUP-S-CREATED, created AACRT060.A;1_@               $ BACKUP/LOG/SELECT=(*.PS,*.TXT) AACRT060.A/SAVE *8               %BACKUP-S-CREATED, created CRT060_RBI.PS;19               %BACKUP-S-CREATED, created CRT060_RBI.TXT;1_=               %BACKUP-S-CREATED, created CRT060_REF_INST.PS;1z>               %BACKUP-S-CREATED, created CRT060_REF_INST.TXT;1B               %BACKUP-S-CREATED, created CRT060_RELEASE_NOTES.PS;1  G         1.2.8 Shutting Down the Previous Version of Disk File Optimizer_               Software  D               If you are running a previous version of the Disk FileH               Optimizer, then shut down the previous version of the DiskH               File Optimizer software on all nodes before installing the<               new version of Defrag or Defrag PLUS software.  I               Use SYSMAN to shut down the Disk File Optimizer software or_9               execute the following command on all nodes:f  -               $ @SYS$MANAGER:DFG$SHUTDOWN.COMe  2         1.2.9 Execute SYS$SYSTEM:SETFILENOMOVE.COM  =               Before you run the Disk File Optimizer, executetH               SYS$SYSTEM:SETFILENOMOVE.COM against all OpenVMS operatingH               system disks on your cluster. SETFILENOMOVE.COM identifiesF               all system files that must not be moved because they areI               accessed without the file system. When you run this command_E               file, it sets the NOMOVE bit in the file header for thesI               identified files. If you do not run this command procedure, E               system files could be moved that would be "lost" to the "               accessing processes.  I                               Installing Disk File Optimizer Software 1-9            /         Installing Disk File Optimizer Software A         1.2 Preparing to Install the Disk File Optimizer Softwares    I               This procedure marks certain critical system files with the I               NOMOVE attribute. This anchors these files to the disk; any F               attempt to relocate them using the XQP MOVEFILE function               fails.  D               While attempting to execute SETFILENOMOVE.COM, you may>               receive several errors similar to the following:  7               %SET-E-READERR, error reading <file name>v8               -SYSTEM-W-ACCONFLICT, file access conflict  F               To set the NOMOVE attribute on these files you must bootH               from another system, such as the distribution CD, and thenF               execute SETFILEMOVE.COM against the disk. However, theseF               files may already have the NOMOVE attribute set. Use theI               DIRECTORY/FULL command to determine if the NOMOVE attributeh               was already set.  I               If the NOMOVE attribute is not set and you cannot boot fromNF               another system disk, you should be all right because theI               file is open when the system is booted. Disk File Optimizert5               does not defragment or move open files.a  G               To use this SETFILENOMOVE.COM procedure, you must specifytC               the file name as P1 on the command line. For example:i  4               $ @SYS$SYSTEM:SETFILENOMOVE $1$DKB100:  C         1.2.10 Registering the Disk File Optimizer Software LicenseF  F               When you are installing Disk File Optimizer software forG               the first time, you must register the Disk File Optimizers               software license.   .               The following sections describe:  &               o  License and kit names  5               o  How to register the software license   &         1.2.10.1 License and Kit Names  B               The license and kit name for the Disk File OptimizerB               software is the same for Defrag and Defrag PLUS. TheD               license name is DFG or PFO and the kit name is DFG022.  4         1-10 Installing Disk File Optimizer Software    c      I                                   Installing Disk File Optimizer Software I                 1.2 Preparing to Install the Disk File Optimizer Software     =         1.2.10.2 Registering Your Disk File Optimizer Licensee  E               Follow the steps in Table 1-5 to register your new Diskm%               File Optimizer license.o  5               Where_to_find_registration_information:a  F               The license registration information is contained in theG               Product Authorization Key (PAK). The PAK is a certificate ;               shipped with the Disk File Optimizer package.   I               Table_1-5_How_to_Register_Your_Disk_File_Optimizer_License_   I               Step_Action_____________________Enter_the_command:_________   $               1    Enter the LICENSEF                    REGISTER command with      $ LICENSE REGISTER DFG -)                    the product name and ae                    dash.                      Important:   *                    Enter a dash at the end+                    of each command in Steps                     1 through 9.o  I               ___________________________________________________________u$               2    Enter the /ISSUER>                    qualifier information,     _$ /ISSUER=DEC -+                    assigning the value from *                    the ISSUER entry of the                    PAK.   I               ___________________________________________________________ +               3    Enter the /AUTHORIZATION I                    qualifier information,     _$ /AUTHORIZATION=xxxxxxx -T)                    assigning it the valueP)                    from the AUTHORIZATION +                    NUMBER entry of the PAK.   I               ___________________________________________________________ &               4    Enter the /PRODUCER@                    qualifier information,     _$ /PRODUCER=DEC -+                    assigning the value from ,                    the PRODUCER entry of the                    PAK.   I                                                  (continued on next page)   I                              Installing Disk File Optimizer Software 1-11     o      /         Installing Disk File Optimizer SoftwareAA         1.2 Preparing to Install the Disk File Optimizer Software     H               Table 1-5 (Cont.) How to Register Your Disk File OptimizerI               __________________License__________________________________.  I               Step_Action_____________________Enter_the_command:_________S  I               ___________________________________________________________f#               5    Enter the /UNITSd<                    qualifier information,     _$ /UNITS=nn -+                    assigning the value fromu,                    the NUMBER OF UNITS entry                    of the PAK.  I               ___________________________________________________________ *               6    Enter the /RELEASE_DATEF                    qualifiers information,    _$ /RELEASE_DATE=dd-mmm-4                    assigning the product's    yyyy -*                    release date value from+                    the PRODUCT RELEASE DATEE$                    entry of the PAK.  I               ___________________________________________________________0*               7    Enter the /TERMINATION_F                    DATE qualifiers            _$ /TERMINATION_DATE=dd-8                    information, assigning     mmm-yyyy -,                    the product's termination*                    date value from the KEY,                    TERMINATION DATE entry of                    the PAK.   I               ___________________________________________________________s*               8    Enter the /AVAILABILITYB                    qualifier information,     _$ /AVAILABILITY=x -+                    assigning the value froma)                    the AVAILABILITY TABLEn)                    CODE entry of the PAK.v  I               ____________________________________________________________%               9    Enter the /OPTIONS B                    qualifier information,     _$ /OPTIONS=xxxxxx -+                    assigning the value from_+                    the KEY OPTIONS entry of                     the PAK.t  I                                                  (continued on next page)s  4         1-12 Installing Disk File Optimizer Software l  e      I                                   Installing Disk File Optimizer SoftwareDI                 1.2 Preparing to Install the Disk File Optimizer Software     H               Table 1-5 (Cont.) How to Register Your Disk File OptimizerI               __________________License__________________________________   I               Step_Action_____________________Enter_the_command:_________   I               ___________________________________________________________r&               10   Enter the /CHECKSUMG                    qualifier information,     _$ /CHECKSUM=x-xxxx-xxxx-_7                    assigning the value from   xxxx-xxxxB,                    the CHECKSUM entry of the                    PAK.                       Important:g  (                    Do NOT end this entry                    with a dash.e  I               ___________________________________________________________.*               10   Invoke the LICENSE LOAD@                    command with the product   $ LICENSE LOAD DFGI               _____name._________________________________________________   7         1.3 Installing the Disk File Optimizer Software   4         1.3.1 Before You Begin-Questions and Answers  G               Before beginning the installation procedure, you may want_:               to read the following questions and answers:  G               Q: Is there anything special I should do before I install 8                  Disk File Optimizer for the first time?A               A: Yes. Make sure you have run SETFILENOMOVE.COM on1D                  your OpenVMS operating system disks as described in                  Section 1.2.9.a  ?               Q: How long does the installation procedure take?_H               A: The installation procedure takes from 15 to 45 minutes,D                  depending on your media type, system configuration,E                  software variant, and whether or not you execute the_                  IVP.p  $               Q: How can I get help?      I                              Installing Disk File Optimizer Software 1-13  t  i      /         Installing Disk File Optimizer Software 7         1.3 Installing the Disk File Optimizer SoftwareS      D               A: VMSINSTAL provides additional information about theB                  decisions required to respond to the installationG                  prompts. To get help at any installation prompt, presst                   < ? > <Return>.  @               Q: Where can I find an example of the installation                  procedure? B               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 <Ctrl/Y>.                    Note:  H                  You must restart the installation from the beginning if3                  you abort the VMSINSTAL procedure.   E               Q: Do I need to do anything special to upgrade from the 7                  existing Disk File Optimizer software? B               A: No, unless you upgrading from Disk File Optimizer6                  Version 1.0 . Refer to Section 1.2.1.  $         1.3.2 Installation Procedure  E               The Disk File Optimizer installation procedure consists F               of a series of questions and informational messages. SeeG               Appendix B for a sample installation. Follow the steps in @               Table 1-6 to install Disk File Optimizer software.  I               Table_1-6_How_to_Install_the_Disk_File_Optimizer_Software__m  I               Step_Action________________________________________________x  F               1    Load and mount the media that contains the software                    kit.n  I               ___________________________________________________________   I                                                  (continued on next page)>        4         1-14 Installing Disk File Optimizer Software           I                                   Installing Disk File Optimizer SoftwaredI                           1.3 Installing the Disk File Optimizer Softwarea    F               Table 1-6 (Cont.) How to Install the Disk File OptimizerI               __________________Software_________________________________m  I               Step_Action________________________________________________w  B               2    Invoke the VMSINSTAL procedure. By entering the%                    following command:i  =                    @SYS$UPDATE:VMSINSTAL saveset-name device-o!                    name OPTIONS NM                      Where:e  @                    saveset-name is the installation name for theB                    component. For the Disk File Optimizer, use the$                    following: DFG022  E                    device-name is the name of the device on which yougB                    plan to mount the media, for example, MUA0:. ItE                    is not necessary to use the console drive for thisbG                    installation. However, if you use the console drive, H                    replace any media you remove when the installation is                    complete.  B                    OPTIONS N indicates you want to see the releaseI                    notes. If you do not include this parameter, VMSINSTALaG                    does not ask you about the release notes. Review thesH                    release notes before proceeding with the installation@                    as they could contain additional installation                    information.a  I               ___________________________________________________________ 4               3    If you see the following message:                       %VMSINSTAL-W-C                    ACTIVE, The following processes are still active 9                    * Do you want to continue anyway [NO]?d  ?                    Enter Y and press Return, else go to Step 4.e  I               ___________________________________________________________I:               4    Confirm the state of the system backup.  Q                    * Are you satisfied with the backup of your system disk [Yes]?d                       Press Return.  I               ___________________________________________________________   I                                                  (continued on next page)   I                              Installing Disk File Optimizer Software 1-15r i         /         Installing Disk File Optimizer Software 7         1.3 Installing the Disk File Optimizer SoftwareA    F               Table 1-6 (Cont.) How to Install the Disk File OptimizerI               __________________Software_________________________________   I               Step_Action________________________________________________   7               5    Respond to the Release Notes option.f  V                    Release notes included with this kit are always copied to SYS$HELP.  4                    Additional Release Notes Options:  0                        1.  Display release notes.                        2.  Print release notes'                        3.  Both 1 and 2 ,                        4.  None of the above  '                    * Select option [2]:s  C                    Enter the number of the desired option and press.                    Return.  I               ___________________________________________________________A-               6    Continue the installation.   C                    * Do you want to continue the installation [NO]?   ,                    Enter Y and press Return.  I               ___________________________________________________________hF               7    Purge old Disk File Optimizer software files if you>                    want to recover storage space on your disk.  T                    * Do you want to purge files replaced by this installation [YES]?  D                    Press Return to purge old files, else enter N and                     press Return.  I               ___________________________________________________________T0               8    Confirm the PAK registration.  W                    * Does this product have an authorization key registered and loaded?   ,                    Enter Y and press Return.  I               ___________________________________________________________   I                                                  (continued on next page)h  4         1-16 Installing Disk File Optimizer Software           I                                   Installing Disk File Optimizer SoftwaresI                           1.3 Installing the Disk File Optimizer Software     F               Table 1-6 (Cont.) How to Install the Disk File OptimizerI               __________________Software_________________________________   I               Step_Action________________________________________________   H               9    Select to run the Installation Verification Procedure                    (IVP).   M                    * Do you want to run the IVP after the installation [YES]?t  "                    Recommendation:  <                    Running the IVP procedure is recommended.  F                    Press Return to run the IVP, else enter N and press                    Return.  I               ___________________________________________________________oI               10   Confirm OpenVMS operating system disk files are set to                      not be moved.  W                    * Has SETFILENOMOVE.COM been executed against all system disks [NO]?   E                    If you have run SETFILENOMOVE.COM against all your D                    OpenVMS operating system disks, enter Y and pressI                    Return. Otherwise, the installation procedure exits ati                    this point.  B                    If you do not run SETFILENOMOVE.COM against allD                    OpenVMS operating system disks before you installI                    the Disk File Optimizer software, files on your system I                    disks could be moved. This would cause access problems G                    for utilities that access files directly rather thanVF                    through the file system. Refer to Section 1.2.9 for$                    more information.  I               ___________________________________________________________   I                                                  (continued on next page)             I                              Installing Disk File Optimizer Software 1-17     x      /         Installing Disk File Optimizer Software 7         1.3 Installing the Disk File Optimizer Software     F               Table 1-6 (Cont.) How to Install the Disk File OptimizerI               __________________Software_________________________________   I               Step_Action________________________________________________d  2               11   Select an installation variant.  I                    * Do you want to install Defrag or Defrag PLUS [PLUS]?   F                    To install the Defrag PLUS software, enter PLUS (or!                    press Return).p@                    To install the Defrag software, enter Defrag.6                    See Table 1-1 for more information.  G                            ___________________ Note ___________________i  D                            If you select Defrag, Steps 13 through 17(                            do not occur.  F                            ___________________________________________  I               ___________________________________________________________e>               12   Choose to install the DECwindows interface.  R                    * Do you want to install the Defrag DECwindows interface [YES]?  I                    If you want to install the DECwindows interface, pressf                    Return.?                    If you do not want to install the DECwindows.8                    interface, enter No and press Return.  I               ___________________________________________________________r@               13   Choose whether or not to install the callable                    interface.   L                    * Do you wish to install the DFO callable interface [NO]?  G                    If you need to install the callable interface, entermF                    Y and press Return. The installation procedure will1                    install the appropriate files.iI                    Otherwise, press Return and the installation procedureP.                    continues to the next step.  I               ____________________________________________________________  I                                                  (continued on next page)_  4         1-18 Installing Disk File Optimizer Software t  t      I                                   Installing Disk File Optimizer Software-I                           1.3 Installing the Disk File Optimizer Software     F               Table 1-6 (Cont.) How to Install the Disk File OptimizerI               __________________Software_________________________________9  I               Step_Action_________________________________________________  B               14   Choose the location of the scheduling database.  R                    * Device and directory to contain the scheduling database files  /                    [SYS$COMMON:[DFG$DATABASE]]:   J                        You have chosen the following as a location for the  I                        defragmentation scheduling and parameter database:   4                            SYS$COMMON:[DFG$DATABASE]  @                    * Is this device and directory correct [YES]?  B                    If you want to use the default directory, pressH                    Return. Otherwise, enter the directory name and press                    Return.  I               ___________________________________________________________-C               15   Decide about using existing database if present.e  R                        The following scheduling/parameter database already exists:  7                    DISK$USER1:[DFG$DATABASE]DFG$DB.DAT; 9                    DISK$USER1:[DFG$DATABASE]DFG$FILE.DAT; <                    DISK$USER1:[DFG$DATABASE]DFG$GENERAL.DAT;9                    DISK$USER1:[DFG$DATABASE]DFG$NODE.DAT;S:                    DISK$USER1:[DFG$DATABASE]DFG$QUEUE.DAT;;                    DISK$USER1:[DFG$DATABASE]DFG$SCRIPT.DAT;i;                    DISK$USER1:[DFG$DATABASE]DFG$VOLUME.DAT;p  1                    * Do you wish to use it [YES]?_  I                    This message appears only if a database already exists_H                    in the chosen database directory. Press return to use)                    the existing database.   I               ___________________________________________________________   I                                                  (continued on next page)_  I                              Installing Disk File Optimizer Software 1-19            /         Installing Disk File Optimizer Software-7         1.3 Installing the Disk File Optimizer Software-    F               Table 1-6 (Cont.) How to Install the Disk File OptimizerI               __________________Software__________________________________  I               Step_Action________________________________________________t  A               16   Choose the name of the mail distribution file.$  Y                    * Mail distribution file name [SYS$COMMON:[DFG$DATABASE]DFG$MAIL.DIS]:   J                    The mail distribution file for notification messages is  A                            SYS$COMMON:[DFG$DATABASE]DFG$MAIL.DIS;P  B                    * Is this the correct file specification [YES]?  ?                    The mail distribution file is created during E                    installation. You may specify a list of user names H                    for this distribution list or take the default, which>                    is the user name of the installing account.  I               ___________________________________________________________ G               17   Specify whether or not to change the contents of theP*                    mail distribution file.  U                    By default, the mail distribution file contains only the user nameK  -                    of the installing account.   U                    * Do you want to override the default contents of {mail.DIS} [NO]?l  D                    Press Return if you wish the notification list toH                    contain only the user name of the installing account.E                    Enter Y if you want to specify a different mailingoC                    list. If you enter Y, the installation procedure_E                    prompts you for a list of user names. Separate the_E                    user names with commas, for example: USER1, USER2,_                    USER3[,...]._  I               ___________________________________________________________i  I                                                  (continued on next page)v        4         1-20 Installing Disk File Optimizer Software t         I                                   Installing Disk File Optimizer SoftwareDI                           1.3 Installing the Disk File Optimizer Software_    F               Table 1-6 (Cont.) How to Install the Disk File OptimizerI               __________________Software_________________________________I  I               Step_Action_________________________________________________  I                                                  (continued on next page)                                                                               I                              Installing Disk File Optimizer Software 1-21  l  n      /         Installing Disk File Optimizer Softwaren7         1.3 Installing the Disk File Optimizer Software     F               Table 1-6 (Cont.) How to Install the Disk File OptimizerI               __________________Software_________________________________n  I               Step_Action________________________________________________   /               18   Read informational messages.e  G                    At this point, the installation procedure displays a,F                    number of informational messages that report on theE                    progress of the installation. There are no further D                    questions. If the installation procedure has beenG                    successful up to this point, VMSINSTAL moves the new I                    or modified files to their target directories, updates.G                    Help files, and updates DCL tables, if necessary. IfSI                    you chose to have files purged, that work is done now.s6                    The following message is displayed:  V                    No more input is required to complete this installation.  From this  3                    point it proceeds automatically.h  @                    The following messages are displayed when theF                    installation procedure converts the RMS database to6                    do away with index key compression:  [                            Attempting to convert your RMS database so there is no index key   X                            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.DATi>                                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._  D                    After the files have been moved, the installation?                    procedure starts a scheduling process on the G                    installing node. The name, ID, and log file for this )                    process are displayed:_                      %RUN-S-I         1-22 InstalPROC_ID,kidentificationrofocreated process is 0000012B   F                    Defragmentation scheduler, DFG$XXXX started on XXXX@                    Scheduler log file: DFG$DATABASE:DFG$XXXX.LOG  B                    The name of the scheduler process is DFG$_XXXX,E                    where XXXX is the node name where the scheduler is-                    executing.s  G                            ___________________ Note ____________________  E                            The name of the node comes from either the_C                            SYSGEN parameter, SCSNODE, or if SCSNODEd@                            is undefined, from the system logical@                            name, SYS$NODE. At least one of theseA                            must indicate a valid node name or the A                            defragmentation software will not work %                            correctly.l  F                            ___________________________________________  I                                                  (continued on next page)  a  o      I                                   Installing Disk File Optimizer SoftwareuI                           1.3 Installing the Disk File Optimizer Softwaref    F               Table 1-6 (Cont.) How to Install the Disk File OptimizerI               __________________Software_________________________________   I               Step_Action________________________________________________   I               ___________________________________________________________ #               19   Observe the IVP.e  A                    If you chose to run the IVP, VMSINSTAL runs itnE                    now. When the IVP begins, the following message isa                    displayed:a  H                    Beginning the 2.2 installation verification procedure  E                    When the IVP completes successfully, the following (                    message is displayed:  O               _____Installation_verification_for_2.2_has_successfully_completeda           1.3.3 Error Recovery  E               If errors occur during the installation or when the IVP E               is running, VMSINSTAL displays failure messages. If the E               installation fails, the following message is displayed:   C               %VMSINSTAL-E-INSFAIL, The installation of DFG Version                2.2                has failed.   E               If the IVP fails, the following messages are displayed:   M               The DFG Version 2.2 Installation Verification Procedure failed.   ;               %VMSINSTAL-E-IVPFAIL, The IVP for DFG Versionr               2.2 has failed.i  D               Errors can occur during the installation if any of the)               following conditions exist:   3               o  Incorrect operating system version   8               o  Incorrect prerequisite software version  $               o  Insufficient quotas  5               o  Insufficient system parameter values   5               o  VMS Help library is currently in use   C               o  Product license has not been registered and loadedo  I                              Installing Disk File Optimizer Software 1-23            /         Installing Disk File Optimizer Software 7         1.3 Installing the Disk File Optimizer Software     A               For descriptions of the error messages generated by ?               these conditions, see the VMS documentation about D               system messages, recovery procedures, and VMS softwareA               installation. If you are notified that any of theseAH               conditions exist, take the appropriate action as described               in the message.a  4         1.4 After Installing the Disk File Optimizer  H               Perform the following tasks after installing the Disk File               Optimizer:  B               o  Run the IVP separately to verify the installation  ;               o  Edit the system startup and shutdown files   B               o  Make the Disk File Optimizer software usable on a"                  VMScluster system  (               o  Resolve database errors  8               o  Delete old copies of the database files  ,               o  Verify account requirements  $               o  Report any problems  (         1.4.1 Running the IVP Separately  E               You usually run the Installation Verification Procedure D               (IVP) during the installation by responding YES to the               question:_  K                  * Do you want to run the IVP after the installation [YES]?n  D               If you did not run the IVP during the installation, orB               if you want to run the IVP separately to confirm theG               integrity of installed files, execute the IVP by enteringO               this command:   %               $ @SYS$TEST:DFG$IVP.COMt                 Requirements:   E               The Disk File Optimizer software must be running on the /               system where the IVP is executed._  4         1-24 Installing Disk File Optimizer Software e  s      I                                   Installing Disk File Optimizer Software I                              1.4 After Installing the Disk File Optimizer     2         1.4.2 Editing the Systemwide Command Files                 System_startup:   ;               You must edit the system startup procedure todA               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 asTH               described in Section 1.2.7, you must start up the run-timeE               components. Add the following line to your startup file E               after the line that invokes the network startup command                procedure:  )               $ @SYS$MANAGER:STARTNET.COM                    .e                   .e                   . ,               $ @SYS$STARTUP:CRT$STARTUP.COM                 System_shutdown:  G               You can modify the system shutdown file to provide for an F               orderly shutdown of the Disk File Optimizer. To do this,B               add the following line to SYS$MANAGER:SYSHUTDWN.COM:  -               $ @SYS$MANAGER:DFG$SHUTDOWN.COM   H         1.4.3 Making the Disk File Optimizer Work on a VMScluster System  D               To make the Disk File Optimizer available on all nodesC               of the cluster, you should ensure that all nodes havetD               the latest version of DCLTABLES.EXE installed. You canF               do this by using SYSMAN or by logging in to each node in=               the cluster and entering the following command:z  @               $ INSTALL REPLACE SYS$COMMON:[SYSLIB]DCLTABLES.EXE        I                              Installing Disk File Optimizer Software 1-25_ d         /         Installing Disk File Optimizer Software 4         1.4 After Installing the Disk File Optimizer    ;         1.4.4 Deleting Old Copies of the RMS Database FilesU  B               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  1               o  DFG$DATABASE:DFG$GENERAL_OLD.DAT   .               o  DFG$DATABASE:DFG$NODE_OLD.DAT  /               o  DFG$DATABASE:DFG$QUEUE_OLD.DAT   0               o  DFG$DATABASE:DFG$SCRIPT_OLD.DAT  0               o  DFG$DATABASE:DFG$VOLUME_OLD.DAT  )               You can delete these files.   E         1.4.5 Loading The New Database After Upgrading from Disk File*               Optimizer V1.0  I               If you are upgrading from Disk File Optimizer V1.0 and have F               saved the data in your database, you must restore it. IfI               you saved your database data as described in Section 1.2.1,iB               you can load it into your new RMS database using the                following command:                 $ @LOAD_DB  ,         1.4.6 Verifying Account Requirements  H               The following privileges are required to run the Disk File!               Optimizer software:O                 o  BYPASS                  o  CMKRNLl                 o  DETACH                  o  NETMBXR                 o  SHARE                 o  SYSGBL                  o  SYSLCKe                 o  SYSPRV                  o  TMPMBXd  4         1-26 Installing Disk File Optimizer Software t  h      I                                   Installing Disk File Optimizer Software_I                              1.4 After Installing the Disk File Optimizern                   o  WORLD            1.4.7 Reporting Problems  B               If you encounter a problem while using the Disk File@               Optimizer, report it to Digital Customer Services.C               Depending upon the nature of the problem and the type D               of support you have purchased, you can take one of the                following actions:  I               o  Call Digital Customer Services if your software contract_I                  or warranty agreement entitles you to telephone support.b  <               o  Submit a Software Performance Report (SPR).  H               Review the Software Product Description (SPD) and WarrantyI               Addendum for an explanation of warranty. If you encounter arG               problem during the warranty period, report the problem asaG               indicated above or follow alternate instructions provided C               by Digital for reporting SPD nonconformance problems.                                                   I                              Installing Disk File Optimizer Software 1-27d e                       I                                                                         A_I         _________________________________________________________________t  I                                    Disk File Optimizer Logicals and Filesa    <         A.1 Files Added to System by the Disk File Optimizer  E               The following files are permanently added to the system I               when you install the Defrag PLUS variant. Files marked withSE               an asterisk (*) are not added if you install the DefragG               variant:  3               o  DFG$DATABASE (directory, typicallyT7                  SYS$COMMON:[000000]DFG$DATABASE.DIR) *O  *               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 *  8               o  SYS$COMMON:[SYS$STARTUP]DFG$STARTUP.COM  B               o  SYS$COMMON:[SYS$STARTUP]DFG$START_SCHEDULER.COM *  =               o  SYS$COMMON:[SYSEXE]DFG$CREATE_DATABASE.EXE *D  /               o  SYS$COMMON:[SYSEXE]DFG$DCL.EXEl  7               o  SYS$COMMON:[SYSEXE]DFG$ENGINE_MAIN.EXE   ;               o  SYS$COMMON:[SYSEXE]DFG$INIT_DATABASE.EXE *_  7               o  SYS$COMMON:[SYSEXE]DFG$SCHEDULER.EXE *_  <               o  SYS$COMMON:[SYSEXE]DFG$STOP_SCHEDULER.EXE *  =               o  SYS$COMMON:[SYSEXE]DFG$REFORMAT_DB_RMS.EXE *u  I                                Disk File Optimizer Logicals and Files A-1  e  i      .         Disk File Optimizer Logicals and Files<         A.1 Files Added to System by the Disk File Optimizer    9               o  SYS$COMMON:[SYSEXE]DFG$REFORMAT_DB.EXE *o  2               o  SYS$COMMON:[SYSHLP]DEFRAGMENT.HLB  8               o  SYS$COMMON:[SYSHLP]DFGxxx.RELEASE_NOTES  ;               o  SYS$COMMON:[SYSLIB]DFG$DEFRAGMENTSHR.EXE *   9               o  SYS$COMMON:[SYSLIB]DFG$RELATIONSHR.EXE *   4               o  SYS$COMMON:[SYSLIB]DFG$RMSSHR.EXE *  6               o  SYS$COMMON:[SYSLIB]DFG$UTILITYSHR.EXE  4               o  SYS$COMMON:[SYSMGR]DFG$DEINSTAL.COM  4               o  SYS$COMMON:[SYSMGR]DFG$SHUTDOWN.COM  <               o  SYS$COMMON:[SYSMGR]DFG$STOP_SCHEDULER.COM *  3               o  SYS$COMMON:[SYSMSG]DFG$MESSAGE.EXE   0               o  SYS$COMMON:[SYSTEST]DFG$IVP.COM  H               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  B               If you install the callable interface, the following+               additional files are created:   /               o  SYS$COMMON:[SYSLIB]DFG$DEF.FORE  -               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   2         A-2 Disk File Optimizer Logicals and Files           I                                    Disk File Optimizer Logicals and Files I                                                         A.2 Logical Names              A.2 Logical Names.  F               Logical names for the Disk File Optimizer begin with theA               prefix DFG$. Table A-1 describes each logical name.t  I         Table_A-1_Logical_Names__________________________________________   (                             Installation         Logical I         Name________________Variant_____Purpose__________________________   C         DFG$DATABASE        Defrag      Equates to the device:[dir]lH                             PLUS        specification where the databaseE                                         resides. Also located in this-C                                         directory are the scheduler_D                                         log files, which have a nameG                                         of DFG$_xxxx.LOG, where xxxx is I                                         the name of the node on which thet=                                         scheduler is running.m  D         DFG$DISK            All         Provided to the EPILOGUE andB                                         PROLOGUE command files. ItE                                         translates to the name of thesC                                         disk on which DFO currently 1                                         operates.p  I         DFG$MAIL_ADDRESS    Defrag      Equates to a file name containingII                             PLUS        a mail distribution list of thosewG                                         who should receive notification F                                         when defragmentation processes1                                         complete.c  2         DFG$MESSAGE         All         Equates toD                                         SYS$MESSAGE:DFG$MESSAGE.EXE,>                                         which is the shareable@                                         image containing all the@                                         defragmentation-specificF                                         messages. This logical is usedH                                         only if you install the callable2                                         interface.  I                                                  (continued on next page)       I                                Disk File Optimizer Logicals and Files A-3  G  T      .         Disk File Optimizer Logicals and Files         A.2 Logical Names.    I         Table_A-1_(Cont.)_Logical_Names__________________________________   (                             Installation         Logical I         Name________________Variant_____Purpose__________________________   D         DFG$SCRIPT          All         Provided to the EPILOGUE andB                                         PROLOGUE command files. ItE                                         translates to the name of the F                                         script associated with the DFO0                                         process.  D         DFG$STATE           All         Provided to the EPILOGUE andB                                         PROLOGUE command files. AsI                                         appropriate to indicate the stateFH                                         of DFO to the command procedure,H                                         it translates to either of these/                                         strings   3                                            PROLOGUE_3                                            EPILOGUEn  D         DFG$STATUS          All         Provided to the EPILOGUE andB                                         PROLOGUE command files. ItH                                         translates to the current statusC                                         of the DFO process. For the C                                         EPILOGUE command file, thislE                                         status is the final status of 8                                         the DFO process.  A         DFG$ASTLM           All         These logicals affect theeC         DFG$BIOLM                       associated process quota ofiF         DFG$BYTLM                       any DFO process running on the8         DFG$DIOLM                       assoicated node.H         DFG$ENQLM                       Refer to the guide to operations=         DFG$FILLM                       for more information.          DFG$JTQUOTA_         DFG$PGFLQUOTA_         DFG$PRCLM          DFG$TQELM_         DFG$WSDEFAULT_         DFG$WSEXTENTI         DFG$WSQUOTA______________________________________________________h    2         A-4 Disk File Optimizer Logicals and Files n                       I                                                                         B I         _________________________________________________________________   I                                  Example Disk File Optimizer Installationm              B.1 Example Installation  E               This appendix contains an example installations for the H               Disk File Optimizer software. Example B-1 shows an exampleF               installation log for installing Defrag PLUS. As you look>               through this example, note the following things:  H               o  The first line in the example shows the command used to+                  generate the installation..  G               o  If you do not have existing Defrag PLUS database fileswB                  on the volume, the following lines do not appear:                                                I                              Example Disk File Optimizer Installation B-1. a  a      0         Example Disk File Optimizer Installation          B.1 Example Installation    P                      The following scheduling/parameter database already exists:  5                  DISK$USER1:[DFG$DATABASE]DFG$DB.DAT;r7                  DISK$USER1:[DFG$DATABASE]DFG$FILE.DAT; :                  DISK$USER1:[DFG$DATABASE]DFG$GENERAL.DAT;7                  DISK$USER1:[DFG$DATABASE]DFG$NODE.DAT; 8                  DISK$USER1:[DFG$DATABASE]DFG$QUEUE.DAT;9                  DISK$USER1:[DFG$DATABASE]DFG$SCRIPT.DAT;e9                  DISK$USER1:[DFG$DATABASE]DFG$VOLUME.DAT;e  /                  * Do you wish to use it [YES]?s  Y                          Attempting to convert your RMS database so there is no index keydV                          compression.  This requires converting the database.  The old;                          database files will be renamed to:   8                              DFG$DATABASE:DFG$DB_OLD.DAT:                              DFG$DATABASE:DFG$FILE_OLD.DAT=                              DFG$DATABASE:DFG$GENERAL_OLD.DATe:                              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.   F               o  During the IVP, this installation runs the DEFRAGMENTF                  SHOW {volume_name} command for the volume on which itI                  is installing. The information shown indicates how badlye*                  the volume is fragmented.  8         Example B-1 Example Installation for Defrag PLUS  :         xxx -> @sys$update:vmsinstal DFG022 DISK$KIT:[DFO]  I                                                  (continued on next page)l                4         B-2 Example Disk File Optimizer Installation t  a      I                                  Example Disk File Optimizer Installation I                                                  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. 7         Enter a question mark (?) at any time for help.-L         %VMSINSTAL-W-NOTSYSTEM, You are not logged in to the SYSTEM account.F         %VMSINSTAL-W-ACTIVE, The following processes are still active:                DECW$SERVER_0                DECW$MWMe                DECW$TE_0068                 _FTA5:F0         * Do you want to continue anyway [NO]? yH         * Are you satisfied with the backup of your system disk [YES]? y  1         The following products will be processed:            DFG V2.24          Beginning installation of DFG V2.2 at 14:55  >         %VMSINSTAL-I-RESTORE, Restoring product save set A ...S         %VMSINSTAL-I-RELMOVED, Product's release notes have been moved to SYS$HELP. I         * Do you want to purge files replaced by this installation [YES]?i  !                 Product:      DFGu!                 Producer:     DECn"                 Version:      V2.2)                 Release Date: 13-MAY-1996eN         * Does this product have an authorization key registered and loaded? y  T             This kit contains an Installation Verification Procedure (IVP) to verifyP             the correct installation of the Defragmentation software.  It can beS             run prior to the conclusion of this procedure by answering "YES" to the N             IVP prompt or it can be invoked after the installation as follows:            @SYS$TEST:DFG$IVP.COM  B         * Do you want to run the IVP after the installation [YES]?  T             You must run the @SYS$SYSTEM:SETFILENOMOVE.COM command procedure againstR             ALL system disks in your cluster.  You must do this before running theS             defragmentation software on a system disk.  Failure to run this commandnQ             procedure and to later run the defragmentation software on the systemo?             disk could result in corruption of the system disk.t  I                                                  (continued on next page)D  I                              Example Disk File Optimizer Installation B-3i    t      0         Example Disk File Optimizer Installation          B.1 Example Installation    @         Example B-1 (Cont.) Example Installation for Defrag PLUS  I         * Has SETFILENOMOVE.COM been executed against all system disks? yg>         * Do you want to install Defrag or Defrag PLUS [PLUS]:D         * Do you want to install the Graphical User Interface [YES]?=         * Do you wish to install the callable interface [NO]? F         %DFGT1-I-LOGDEFINED, The logical name DFG$DATABASE was defined  A             You have selected the following as a location for theL>             defragmentation scheduling and parameter database:  )                 DISK$USER1:[DFG$DATABASE]T  5         * Is this device and directory correct [YES]?   G             The following scheduling/parameter database already exists:   ,         DISK$USER1:[DFG$DATABASE]DFG$DB.DAT;.         DISK$USER1:[DFG$DATABASE]DFG$FILE.DAT;1         DISK$USER1:[DFG$DATABASE]DFG$GENERAL.DAT;m.         DISK$USER1:[DFG$DATABASE]DFG$NODE.DAT;/         DISK$USER1:[DFG$DATABASE]DFG$QUEUE.DAT; 0         DISK$USER1:[DFG$DATABASE]DFG$SCRIPT.DAT;0         DISK$USER1:[DFG$DATABASE]DFG$VOLUME.DAT;  &         * Do you wish to use it [YES]?J         %DFGT1-I-LOGDEFINED, The logical name DFG$MAIL_ADDRESS was defined  ?             The DFG$MAIL_ADDRESS logical is defined as follows:O6                 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;  7         * Is this the correct file specification [YES]?i  I         By default, the mail distribution file contains only the username "         of the installing account.  <         * Do you want to override the default contents [NO]?  I                                                  (continued on next page)   4         B-4 Example Disk File Optimizer Installation           I                                  Example Disk File Optimizer InstallationnI                                                  B.1 Example Installationu    @         Example B-1 (Cont.) Example Installation for Defrag PLUS  U             +-----------------------------------------------------------------------+ U             |  No more input required.                                              | U             |                                                                       |cU             |  Please perform the following after the installation completes:       |.U             |                                                                       |lU             |  1. Place @SYS$STARTUP:DFG$STARTUP in SYS$MANAGER:SYSTARTUP_VMS.COM   | U             |     (VMS V6.* or V7.*) or in SYS$MANAGER:SYSTARTUP_V5.COM (VMS V5.*). | U             |                                                                       |oU             |  2. Place @SYS$MANAGER:DFG$SHUTDOWN in SYS$MANAGER:SYSHUTDWN.COM      | U             |                                                                       |_U             +-----------------------------------------------------------------------+   >         %VMSINSTAL-I-RESTORE, Restoring product save set F ...>         %VMSINSTAL-I-RESTORE, Restoring product save set G ...  P                 Attempting to convert your RMS database so there is no index keyM                 compression.  This requires converting the database.  The oldG2                 database files will be renamed to:  /                     DFG$DATABASE:DFG$DB_OLD.DATC1                     DFG$DATABASE:DFG$FILE_OLD.DAT 4                     DFG$DATABASE:DFG$GENERAL_OLD.DAT1                     DFG$DATABASE:DFG$NODE_OLD.DATB2                     DFG$DATABASE:DFG$QUEUE_OLD.DAT3                     DFG$DATABASE:DFG$SCRIPT_OLD.DATF3                     DFG$DATABASE:DFG$VOLUME_OLD.DATU  U                 After you are satisfied with the installation, you may wish to deleteS                 these files.B         %DFGT1-I-COPYING, Copying database to working directory...4         %DFGT1-I-COPYING, Renaming database files...V         %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...E         %RUN-S-PROC_ID, identification of created process is 27E00386N?         Defragmentation scheduler, DFG$SPIELN started on SPIELNT7         Scheduler log file: DFG$DATABASE:DFG$SPIELN.LOGC>         Beginning the V2.2 installation verification procedure  I                                                  (continued on next page)           I                              Example Disk File Optimizer Installation B-5            0         Example Disk File Optimizer Installation          B.1 Example Installation    @         Example B-1 (Cont.) Example Installation for Defrag PLUS  5                  Testing SHOW of database parameters.R0         Disk File Optimizer for OpenVMS DFG V2.24          1996, Digital Equipment Corporation SPIELN:         CPU limit: 0 I/O limit: 0 process limit: 0  ILDUCE2         CPU limit: 0 I/O limit: 0 process limit: 0  6                  Testing SHOW of volume fragmentation.  0         Disk File Optimizer for OpenVMS DFG V2.2-          1996, Digital Equipment Corporation   D                             F r a g m e n t a t i o n    R e p o r t  U         DISK$ALPHA070                                         10-MAY-1996 14:57:24.05G  '         The fragmentation index is 12.9E#               1 - 20.9 is excellentu              21 - 40.9 is good              41 - 60.9 is fair              61 - 80.9 is poor7              81 - 100 indicates a badly fragmented disk M         Approximately 3.3 (out of 80.0 possible) is due to file fragmentationSR         Approximately 9.6 (out of 20.0 possible) is due to freespace fragmentation           Freespace Summary:/          Total free space:        226348 blocksd2          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 blocksS/          Median free extent:          80 blocksi  #         File Fragmentation Summary: 6          Number of files (with some allocation):  58946          Total file extents on the disk:          6039:          Average number of file extents per file: 1.0246013          Median number of file extents per file:  1F  I                                                  (continued on next page)e      4         B-6 Example Disk File Optimizer Installation _  _      I                                  Example Disk File Optimizer Installation I                                                  B.1 Example Installation_    @         Example B-1 (Cont.) Example Installation for Defrag PLUS           Most Fragmented File: I          [VMS$COMMON.SYSEXE]SYS$QUEUE_MANAGER.QMAN$JOURNAL;1 (55 extents) E         Installation verification for V2.2 has successfully completed 4          Installation of DFG V2.2 completed at 14:57  F             Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY  L             Creating installation data file:VMI$ROOT:[SYSUPD]DFG022.VMI_DATA  *          VMSINSTAL procedure done at 14:57                                                                  I                              Example Disk File Optimizer Installation B-7E d                               F      _________________________________________________________________  F                                                                  Index      -      D                                 How to :      _______________________________     register (cont'd)6      Defrag                                 PAK,  1-11F        available subcommands, 1-4        shut down Disk File Optimizer9        description of, 1-3                  software, 1-9t        logicals, 1-4(      Defrag PLUS                       IF        available subcommands, 1-4      _______________________________3        description of, 1-3             Installation F        installation example, B-1         disk space requirements,  1-5>        logicals, 1-4                     error recovery,  1-23<      Disk File Optimizer                 files created,  A-1<        installing on a VMScluster        logical names,  A-3D          system,  1-8                    operating privileges,  1-26E                                          postinstallation procedures, 0      E______________________________        1-249      Editing the systemwide command      privileges,  1-5 9         files, 1-25                      procedure,  1-14 C      Error notification,  A-3            required VMS version,  1-5 ;                                          requirements,  1-1aB                                          upgrading from V1.0,  1-27      F______________________________     variants,  1-3l  <      Free disk blocks                    verification,  1-24:        how to determine, 1-5             VMScluster system?                                             considerations, 1-8 4      H______________________________   Installation,E      How to                              process account quotas,  1-7 F        edit systemwide command files     system parameter values,  1-6            ,  1-25        install software, 1-14         register            Disk File Optimizer              license,  1-11  F                                                                Index-1                   D                                           Product Authorization Key,1         L______________________________      1-11 >         Licensing                           registration, 1-11  +          how to register,  1-11           R I          software,  1-10                  _______________________________ =          where to find information,       Release notes,  1-2 C             1-11                          Reporting problems,  1-27 6         Log file                          Requirements=          See also Scheduler                 installation, 1-1            LogicalsI          DFG$DATABASE,  A-3               S______________________________   3          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-88          DFG$STATUS,  A-4                 SCSNODE,  1-222          list of,  A-3                    Software  @                                             how to install, 1-14:         M______________________________     kit name, 1-10  >         Mail distribution file              license name, 1-10C          See also Logicals, DFG$MAIL_       shutting down Disk FileLF             ADDRESS                           Optimizer software,  1-99                                           SYS$NODE,  1-22iD         P                                 System shutdown procedure,1         _______________________________      1-25 I         PAK                               System startup procedure,  1-25_  &          See Product Authorization KeyI         Postinstallation                  U______________________________a3          editing systemwide command       Upgradingl:             files,  1-25                    from V1.0, 1-2         Privileges+          required for operating,  1-26    VnI          required to perform              _______________________________a.             installation,  1-5            V1.0:                                             upgrading, 1-2               Index-2r                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    