                                             '                     Disk File Optimizer H                     for_OpenVMS_________________________________________&                     Installation Guide  -                     Order Number: AA-QYZ2F-TE                       A                     This installation guide provides installation G                     information for the Disk File Optimizer for OpenVMS -                     layered software product.               >                     Software Version:             Version V2.7  /                     Compaq Computer Corporation "                     Houston, Texas                 N               ________________________________________________________________               October 2002  ?                Compaq Information Technologies Group, LP 2002.   A               Compaq, the Compaq logo, OpenVMS, VAX and Tru64 are G               trademarks of Compaq Information Technologies Group, L.P. E               in the U.S. and/or other countries. UNIX is a trademark G               of The Open Group in the U.S. and/or other countries. All G               other product names mentioned herein may be trademarks of )               their respective companies.   G               Confidential computer software. Valid license from Compaq F               required for possession, use or copying. Consistent withB               FAR 12.211 and 12.212, Commercial Computer Software,E               Computer Software Documentation, and Technical Data for H               Commercial Items are licensed to the U.S. government under3               vendor's standard commercial license.   C               Compaq shall not be liable for technical or editorial C               errors or omissions contained herein. The information C               in this document is provided "as is" without warranty F               of any kind and is subject to change without notice. TheI               warranties for Compaq products are set forth in the express E               limited warranty statements accompanying such products. C               Nothing herein should be construed as constituting an "               additional warranty.  @               Compaq service tool software, including associatedI               documentation, is the property of and contains confidential I               technology of Compaq Computer Corporation. Service customer H               is hereby licensed to use the software only for activitiesC               directly relating to the delivery of, and only during F               the term of, the applicable services delivered by CompaqB               or its authorized service provider. Customer may notA               modify or reverse engineer, remove, or transfer the I               software or make the software or any resultant diagnosis or G               system management data available to other parties without I               Compaq's or its authorized service provider's consent. Upon E               termination of the services, customer will, at Compaq's E               or its service provider's option, destroy or return the F               software and associated documentation in its possession.  #               Printed in the U.S.A.   H               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 Optimizer F                  Software......................................    1-1F            1.2.1     Upgrading From Disk File Optimizer V1.0...    1-3F            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-86            1.2.7     Definition of SCSNODE or SYS$NODEF                      Considerations............................    1-96            1.2.8     Stop the Scheduler on Defrag PlusF                      Installations ............................   1-10F            1.2.9     Execute SYS$SYSTEM:SETFILENOMOVE.COM......   1-108            1.2.10    Registering the Disk File OptimizerF                      Software License..........................   1-11F            1.2.10.1    License and Kit Names...................   1-11;            1.2.10.2    Registering Your Disk File Optimizer F                        License.................................   1-11F            1.3   Installing the Disk File Optimizer Software...   1-14F            1.3.1     Before You Begin-Questions and Answers....   1-14F            1.3.2     Installation Procedure....................   1-15F            1.3.3     Error Recovery............................   1-24F            1.4   After Installing the Disk File Optimizer......   1-25F            1.4.1     Running the IVP Separately................   1-25F            1.4.2     Editing the Systemwide Command Files......   1-26=            1.4.3     Making the Disk File Optimizer Work on a F                      VMScluster System.........................   1-26    F                                                                    iii                   ?               1.4.4     Deleting Old Copies of the RMS Database I                         Files.....................................   1-26 @               1.4.5     Loading The New Database After UpgradingI                         from Disk File Optimizer V1.0.............   1-27 I               1.4.6     Verifying Account Requirements............   1-27 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 FileI                     Optimizer ....................................    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  8               1-1       Differences Between InstallationI                         Variants..................................    1-4   I               1-2       Disk Space Requirements...................    1-5   I               1-3       Minimum System Parameter Values...........    1-6   A               1-4       Process Account Quotas for the Installing I                         Account...................................    1-7   @               1-5       How to Register Your Disk File OptimizerI                         License...................................   1-12   >               1-6       How to Install the Disk File OptimizerI                         Software..................................   1-15   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  OpenVMS License Management Utility Manual  /               o  OpenVMS Performance Management   '               o  OpenVMS DCL Dictionary   0               o  OpenVMS System Manager's Manual  E               o  OpenVMS System Management Utilities Reference Manual   3               o  Guide to OpenVMS File Applications   E               o  OpenVMS Record Management Utilities Reference Manual   @               o  VAX Performance Advisor (VPA) Documentation Kit  I               Order numbers for these documents can be obtained from your *               Compaq 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 Compaq Products   I               The following Compaq products are mentioned in this manual:   I               ___________________________________________________________ I               Product__________Formal_Product_Name_______________________   E               Disk File        Disk File Optimizer refers to the Disk C               Optimizer        File Optimizer for OpenVMS software.   
         vi                 I               ___________________________________________________________ I               Product__________Formal_Product_Name_______________________   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 BACKUP Utility in OpenVMS E                 System Management Utilities Reference Manual for more                  details.  F                 ______________________________________________________  D               The following process describes preparations needed to7               install the Disk File Optimizer software.   I               ___________________________________________________________ I               Stage_Action_______________________________Section_________   F               1     Save scheduling database contents    Section 1.2.1+                     if up grading from V1.0   I               ___________________________________________________________ F               2     Meet hardware and software           Section 1.2.3                      requirements  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_______________________________Section_________   G               3     Verify system parameters and         Section 1.2.4, F                     required quotas                      Section 1.2.5  I               ___________________________________________________________ F               4     Evaluate VMScluster system           Section 1.2.6"                     considerations  I               ___________________________________________________________ F               5     SCSNODE or SYS$NODE considerations   Section 1.2.7  I               ___________________________________________________________ F               6     Stop DFO Scheduler on all nodes      Section 1.2.8  I               ___________________________________________________________ F               7     Execute the                          Section 1.2.90                     SYS$SYSTEM:SETFILENOMOVE.COM1                     procedure against all OpenVMS 2                     operating system disks on your                     cluster   I               ___________________________________________________________ G               8     Register the Disk File Optimizer     Section 1.2.10 I               ______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 E               is damaged or if parts are missing, contact your Compaq                representative.   D               The installation procedure for the Disk File OptimizerG               provides online release notes. Compaq strongly recommends D               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.   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     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   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 Defrag                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 any H               single-node system where the additional features of Defrag               PLUS are desired.                       I                               Installing Disk File Optimizer Software 1-3            /         Installing Disk File Optimizer Software A         1.2 Preparing to Install the Disk File Optimizer Software     I         Table_1-1_Differences_Between_Installation_Variants______________   I         Difference_______Defrag_PLUS___________Defrag____________________   8         Additional       Optional:             Optional:I         Software         o  VAX Performance    o  VAX Performance Advisor   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  MONITOR   D                          o  DEFRAGMENT FILE    o  DEFRAGMENT OFFLINE  6                          o  HELP               o  SHOW  7                          o  MODIFY             o  SPAWN   C                          o  MONITOR            o  DEFRAGMENT VOLUME   &                          o  DEFRAGMENT#                             OFFLINE   "                          o  REMOVE                            o  SET                              o  SHOW  !                          o  SPAWN   !                          o  START   -                          o  DEFRAGMENT VOLUME   3         1-4iInstalling DiskqFiledOptimizer Software   (                          o  DFG$DATABASE  ,                          o  DFG$MAIL_ADDRESS  &                          Optional (for-                          callable interface):   '                          o  DFG$MESSAGE   I         _________________________________________________________________            I                                   Installing Disk File Optimizer Software I                 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 space @               requirements are different during installation andB               after installation. Table 1-2 summarizes the storage               requirements.   I               Table_1-2_Disk_Space_Requirements__________________________   -                               Blocks Required A                               During              Blocks Required I               Variant_________Installation________After_Installation_____   7               Defrag PLUS     26700               23700                /VAX  7               Defrag PLUS     31700               27800                /Alpha  7               Defrag/VAX      23900               22800   I               Defrag/Alpha____25500_______________23900__________________   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$SYSDEVICE   C               The minimum version of software necessary to run Disk G               File Optimizer is OpenVMS VAX V6.2 or OpenVMS Alpha V6.2. E               Besides Disk File Optimizer is supported on OpenVMS VAX G               7.1, 7.2, and 7.3 and OpenVMS Alpha 7.1-2, 7.2-1, 7.3 and                7.3-1.  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-5            /         Installing Disk File Optimizer Software A         1.2 Preparing to Install the Disk File Optimizer Software     -         1.2.4 Minimum System Parameter Values   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________________________   .         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.   I         _________________________________________________________________   H         RESHASHTBL    512         PLUS    Use SYSGEN to find this value.I         ______________entries____________________________________________                                 3         1-6 Installing Disk File Optimizer Software            I                                   Installing Disk File Optimizer Software I                 1.2 Preparing to Install the Disk File Optimizer Software     $         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 of 5               which installation variant you install.   I               Table_1-4_Process_Account_Quotas_for_the_Installing_Account   I               Account_Quota____Value_____________________________________   !               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 and E               change user account quotas. First set your directory to 1               SYS$SYSTEM, and then run AUTHORIZE:   '               $  SET DEFAULT SYS$SYSTEM                $  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=50                UAF>   EXIT   I                               Installing Disk File Optimizer Software 1-7            /         Installing Disk File Optimizer Software A         1.2 Preparing to Install the Disk File Optimizer Software     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 for ,               the new quotas to take effect.  G               For more information on modifying account quotas, see the H               description of the Authorize utility in the OpenVMS System4               Management Utilities Reference Manual.  .         1.2.6 VMScluster System Considerations  F               Use the following list of guidelines when installing the9               Disk File Optimizer on a VMScluster system:   C               o  For Defrag PLUS, the scheduling database should be :                  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 those 3                  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.   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 enter '                  the following command:   C                  $ INSTALL REPLACE SYS$COMMON:[SYSLIB]DCLTABLES.EXE   G               o  Be sure to install Disk File Optimizer on both the VAX F                  and Alpha system in your VMScluster if it is a mix of'                  VAX and Alpha systems.   F               o  During installation of DFO on a cluster with multipleF                  system disks, you must shut down the scheduler beforeD                  starting the installation on the next node. Use the#                  following command:   2                  $ @SYS$MANAGER:DFG$STOP_SCHEDULER  3         1-8 Installing Disk File Optimizer Software            I                                   Installing Disk File Optimizer Software I                 1.2 Preparing to Install the Disk File Optimizer Software     I                  During the Installation Verification Procedure (IVP) the G                  scheduler is started on the node that the installation H                  was just completed on. After completion of installationD                  on all nodes, restart the scheduler on all licensedA                  nodes in the cluster. Use the following command:   +                  $ @SYS$STARTUP:DFG$STARTUP   >         1.2.7 Definition of SCSNODE or SYS$NODE Considerations  D               Defrag PLUS requires either SCSNODE (SYSGEN parameter)F               or SYS$NODE (DECnet logical) be defined on the node thatF               Disk File Optimizer is installed on. If both SCSNODE andI               SYS$NODE are NOT defined, the Disk File Optimizer scheduler                will not start.   E               If the node is part of a cluster then SCSNODE has to be G               defined in SYSGEN. You can check if SCSNODE is defined by *               using the following command:  5               $ WRITE SYS$OUTPUT F$GETSYI("NODENAME")                SPIELN               $   H               In this example, SPIELN is the SCSNODE name. If the SYSGENC               parameter SCSNODE is not defined then no node name is                returned.   F               Another way of checking SCSNODE is to go into SYSGEN and,               execute the following command:                 $ MCR SYSGEN#               SYSGEN>  SHOW SCSNODE S               Parameter Name   Current    Default    Min.     Max.    Unit  Dynamic S               --------------   -------    -------   -------  -------  ----  ------- K               SCSNODE          "SPIELN  " "    "    "    "   "ZZZZ"   Ascii                SYSGEN> EXIT               $   :               In this example, SPIELN is the SCSNODE name.          I                               Installing Disk File Optimizer Software 1-9            /         Installing Disk File Optimizer Software A         1.2 Preparing to Install the Disk File Optimizer Software     H               If the node is a standalone node, it does not require thatI               SCSNODE be defined. However, if you wish to, you can define F               it in SYS$SYSTEM:MODPARAMS.DAT as follows and then do an               AUTOGEN:                 SCSNODE="SPIELN"               SCSSYSTEMID=9112  C               If the node is running DECnet, it will have a logical C               SYS$NODE defined. You can check to see if the logical >               SYS$NODE is defined using the following command:  !               $ SHOW LOG SYS$NODE ;                  "SYS$NODE" = "SPIELN::" (LNM$SYSTEM_TABLE)                $   ;               In this example, SPIELN is the SYS$NODE name.   =         1.2.8 Stop the Scheduler on Defrag Plus Installations   D               If you are running a previous version of the Disk FileE               Optimizer, then shut down the Scheduler software on all I               nodes before installing the new version of Defrag or Defrag                PLUS software.  G               Use SYSMAN to shut down the Scheduler software or execute 1               the following command on all nodes:   3               $ @SYS$MANAGER:DFG$STOP_SCHEDULER.COM   2         1.2.9 Execute SYS$SYSTEM:SETFILENOMOVE.COM  =               Before you run the Disk File Optimizer, execute H               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 the I               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               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.  4         1-10 Installing Disk File Optimizer Software           I                                   Installing Disk File Optimizer Software I                 1.2 Preparing to Install the Disk File Optimizer Software     D               While attempting to execute SETFILENOMOVE.COM, you may>               receive several errors similar to the following:  7               %SET-E-READERR, error reading <file name> 8               -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 attribute                was already set.  I               If the NOMOVE attribute is not set and you cannot boot from F               another system disk, you should be all right because theI               file is open when the system is booted. Disk File Optimizer 5               does not defragment or move open files.   G               To use this SETFILENOMOVE.COM procedure, you must specify C               the file name as P1 on the command line. For example:   4               $ @SYS$SYSTEM:SETFILENOMOVE $1$DKB100:  C         1.2.10 Registering the Disk File Optimizer Software License   F               When you are installing Disk File Optimizer software forG               the first time, you must register the Disk File Optimizer                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. TheF               license name is DFG or PFO and the kit names is: DFG027.  =         1.2.10.2 Registering Your Disk File Optimizer License   E               Follow the steps in Table 1-5 to register your new Disk %               File Optimizer license.   5               Where_to_find_registration_information:   I                              Installing Disk File Optimizer Software 1-11            /         Installing Disk File Optimizer Software A         1.2 Preparing to Install the Disk File Optimizer Software     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 a                     dash.                      Important:   *                    Enter a dash at the end+                    of each command in Steps                     1 through 9.   I               ___________________________________________________________ $               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 - )                    assigning it the value )                    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               ___________________________________________________________   I                                                  (continued on next page)     4         1-12 Installing Disk File Optimizer Software           I                                   Installing Disk File Optimizer Software I                 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:_________   #               5    Enter the /UNITS <                    qualifier information,     _$ /UNITS=nn -+                    assigning the value from ,                    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 DATE $                    entry of the PAK.  I               ___________________________________________________________ *               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               ___________________________________________________________ *               8    Enter the /AVAILABILITYB                    qualifier information,     _$ /AVAILABILITY=x -+                    assigning the value from )                    the AVAILABILITY TABLE )                    CODE entry of the PAK.   I               ___________________________________________________________ %               9    Enter the /OPTIONS B                    qualifier information,     _$ /OPTIONS=xxxxxx -+                    assigning the value from +                    the KEY OPTIONS entry of                     the PAK.   I               ___________________________________________________________   I                                                  (continued on next page)   I                              Installing Disk File Optimizer Software 1-13            /         Installing Disk File Optimizer Software A         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:_________   &               10   Enter the /CHECKSUMG                    qualifier information,     _$ /CHECKSUM=x-xxxx-xxxx- 7                    assigning the value from   xxxx-xxxx ,                    the CHECKSUM entry of the                    PAK.                       Important:   (                    Do NOT end this entry                    with a dash.   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 on D                  your OpenVMS operating system disks as described in                  Section 1.2.9.   ?               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.   $               Q: How can I get help?D               A: VMSINSTAL provides additional information about theB                  decisions required to respond to the installationE                  prompts. To get help at any installation press < ? >                   <Return> 	         .   4         1-14 Installing Disk File Optimizer Software           I                                   Installing Disk File Optimizer Software I                           1.3 Installing the Disk File Optimizer Software         @               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> 	         .   E               Q: Do I need to do anything special to upgrade from the 7                  existing Disk File Optimizer software? F               A: No, unless you are upgrading from Disk File Optimizer5                  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__   I               Step_Action________________________________________________   F               1    Load and mount the media that contains the software                    kit.   I               ___________________________________________________________   I                                                  (continued on next page)                         I                              Installing Disk File Optimizer Software 1-15            /         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________________________________________________   B               2    Invoke the VMSINSTAL procedure. By entering the%                    following command:   =                    @SYS$UPDATE:VMSINSTAL saveset-name device- !                    name OPTIONS N                       Where:   @                    saveset-name is the installation name for theB                    component. For the Disk File Optimizer, use the$                    following: DFG027  E                    device-name is the name of the device on which you B                    plan to mount the media, for example, MUA0:. ItE                    is not necessary to use the console drive for this G                    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, VMSINSTAL G                    does not ask you about the release notes. Review the H                    release notes before proceeding with the installation@                    as they could contain additional installation                    information.   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]?   ?                    Enter Y and press Return, else go to Step 4.   I               ___________________________________________________________ :               4    Confirm the state of the system backup.  Q                    * Are you satisfied with the backup of your system disk [Yes]?                        Press Return.  I               ___________________________________________________________   I                                                  (continued on next page)   4         1-16 Installing Disk File Optimizer Software           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_________________________________   I               Step_Action________________________________________________   7               5    Respond to the Release Notes option.   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]:   C                    Enter the number of the desired option and press                     Return.  I               ___________________________________________________________ -               6    Continue the installation.   C                    * Do you want to continue the installation [NO]?   ,                    Enter Y and press Return.  I               ___________________________________________________________ F               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               ___________________________________________________________ 0               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)   I                              Installing Disk File Optimizer Software 1-17            /         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________________________________________________   H               9    Select to run the Installation Verification Procedure                    (IVP).   M                    * Do you want to run the IVP after the installation [YES]?   "                    Recommendation:  <                    Running the IVP procedure is recommended.  F                    Press Return to run the IVP, else enter N and press                    Return.  I               ___________________________________________________________ I               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 at                     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 than F                    through the file system. Refer to Section 1.2.9 for$                    more information.  I               ___________________________________________________________   I                                                  (continued on next page)             4         1-18 Installing Disk File Optimizer Software           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_________________________________   I               Step_Action________________________________________________   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). @                    To install the Defrag software, enter Defrag.6                    See Table 1-1 for more information.  G                            ___________________ Note ___________________   D                            If you select Defrag, Steps 13 through 17(                            do not occur.  F                            ___________________________________________  I               ___________________________________________________________ >               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, press                     Return.?                    If you do not want to install the DECwindows 8                    interface, enter No and press Return.  I               ___________________________________________________________ @               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, enter F                    Y and press Return. The installation procedure will1                    install the appropriate files. I                    Otherwise, press Return and the installation procedure .                    continues to the next step.  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________________________________________________   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:   ,                    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.   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; :                    DISK$USER1:[DFG$DATABASE]DFG$QUEUE.DAT;;                    DISK$USER1:[DFG$DATABASE]DFG$SCRIPT.DAT; ;                    DISK$USER1:[DFG$DATABASE]DFG$VOLUME.DAT;   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)   4         1-20 Installing Disk File Optimizer Software           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_________________________________   I               Step_Action________________________________________________   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;   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 the *                    mail distribution file.  U                    By default, the mail distribution file contains only the user name   -                    of the installing account.   U                    * Do you want to override the default contents of {mail.DIS} [NO]?   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 mailing C                    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                                                  (continued on next page)         I                              Installing Disk File Optimizer Software 1-21            /         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________________________________________________   I                                                  (continued on next page)                                                                               4         1-22 Installing Disk File Optimizer Software           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_________________________________   I               Step_Action________________________________________________   /               18   Read informational messages.   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. If I                    you chose to have files purged, that work is done now. 6                    The following message is displayed:  V                    No more input is required to complete this installation.  From this  3                    point it proceeds automatically.   @                    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.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.   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:   I                    %RUN-S-   Installing Disk File Optimizer Software 1-23 I                    PROC_ID, identification of created 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.   G                            ___________________ Note ___________________   E                            The name of the node comes from either the C                            SYSGEN parameter, SCSNODE, or if SCSNODE @                            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.   F                            ___________________________________________  I                                                  (continued on next page)            /         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________________________________________________   I               ___________________________________________________________ #               19   Observe the IVP.   A                    If you chose to run the IVP, VMSINSTAL runs it E                    now. When the IVP begins, the following message is                     displayed:   F                    Beginning the V2.7 installation verification proced  E                    When the IVP completes successfully, the following (                    message is displayed:  I               _____Installation_verification_for_V2.7_has_successfully___            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                V2.7               has failed.   E               If the IVP fails, the following messages are displayed:   N               The DFG Version V2.7 Installation Verification Procedure failed.  ;               %VMSINSTAL-E-IVPFAIL, The IVP for DFG Version                V2.7 has failed.  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 loaded   4         1-24 Installing Disk File Optimizer Software           I                                   Installing Disk File Optimizer Software I                           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 these H               conditions exist, take the appropriate action as described               in the message.   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]?   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 entering                this command:   %               $ @SYS$TEST:DFG$IVP.COM                  Requirements:   E               The Disk File Optimizer software must be running on the /               system where the IVP is executed.   I                              Installing Disk File Optimizer Software 1-25            /         Installing Disk File Optimizer Software 4         1.4 After Installing the Disk File Optimizer    2         1.4.2 Editing the Systemwide Command Files                 System_startup:   B               You must edit the system startup procedure to ensureH               automatic startup of the Disk File Optimizer software each>               time the system boots. Add the following line to  (               SYS$MANAGER:SYSTARTUP.COM:,               $ @SYS$MANAGER:DFG$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 have D               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:   @               $ INSTALL REPLACE SYS$COMMON:[SYSLIB]DCLTABLES.EXE  ;         1.4.4 Deleting Old Copies of the RMS Database Files   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.   4         1-26 Installing Disk File Optimizer Software           I                                   Installing Disk File Optimizer Software I                              1.4 After Installing the Disk File Optimizer     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, B               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  BYPASS                  o  CMKRNL                  o  DETACH                  o  NETMBX                  o  SHARE                 o  SYSGBL                  o  SYSLCK                  o  SYSPRV                  o  TMPMBX                  o  WORLD            1.4.7 Reporting Problems  B               If you encounter a problem while using the Disk FileI               Optimizer, report it to Compaq Customer Services. Depending H               upon the nature of the problem and the type of support youH               have purchased, you can take one of the following actions:  H               o  Call Compaq Customer Services if your software contractI                  or warranty agreement entitles you to telephone support.   <               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 a G               problem during the warranty period, report the problem as G               indicated above or follow alternate instructions provided B               by Compaq for reporting SPD nonconformance problems.  I                              Installing Disk File Optimizer Software 1-27                          I                                                                         A I         _________________________________________________________________   I                                    Disk File Optimizer Logicals and Files     <         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 with E               an asterisk (*) are not added if you install the Defrag                variant:  3               o  DFG$DATABASE (directory, typically 7                  SYS$COMMON:[000000]DFG$DATABASE.DIR) *   *               o  DFG$DATABASE:DFG$DB.DAT *  ,               o  DFG$DATABASE:DFG$FILE.DAT *  /               o  DFG$DATABASE:DFG$GENERAL.DAT *   ,               o  DFG$DATABASE:DFG$MAIL.DIS *  ,               o  DFG$DATABASE:DFG$NODE.DAT *  -               o  DFG$DATABASE:DFG$QUEUE.DAT *   .               o  DFG$DATABASE:DFG$SCRIPT.DAT *  .               o  DFG$DATABASE:DFG$VOLUME.DAT *  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 *   /               o  SYS$COMMON:[SYSEXE]DFG$DCL.EXE   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 *   I                                Disk File Optimizer Logicals and Files A-1            .         Disk File Optimizer Logicals and Files<         A.1 Files Added to System by the Disk File Optimizer    9               o  SYS$COMMON:[SYSEXE]DFG$REFORMAT_DB.EXE *   2               o  SYS$COMMON:[SYSHLP]DEFRAGMENT.HLB  8               o  SYS$COMMON:[SYSHLP]DFGxxx.RELEASE_NOTES  4               o  SYS$COMMON:[SYSHLP]DFGxxx_OPR_GUIDE  8               o  SYS$COMMON:[SYSHLP]DFGxxx_INSTALL_GUIDE  .               o  SYS$COMMON:[SYSHLP]DFGxxx_SPD  7               o  SYS$COMMON:[SYSHLP]DFGxxx_COVER_LETTER   ;               o  SYS$COMMON:[SYSLIB]DFG$DEFRAGMENTSHR.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.FOR   -               o  SYS$COMMON:[SYSLIB]DFG$DEF.H   /               o  SYS$COMMON:[SYSLIB]DFG$DEF.MAR   /               o  SYS$COMMON:[SYSLIB]DFG$DEF.PAS   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.   I         Table_A-1_Logical_Names__________________________________________   (                             Installation         Logical I         Name________________Variant_____Purpose__________________________   C         DFG$DATABASE        Defrag      Equates to the device:[dir] H                             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 the =                                         scheduler is running.   D         DFG$DISK            All         Provided to the EPILOGUE andB                                         PROLOGUE command files. ItE                                         translates to the name of the C                                         disk on which DFO currently 1                                         operates.   I         DFG$MAIL_ADDRESS    Defrag      Equates to a file name containing I                             PLUS        a mail distribution list of those G                                         who should receive notification F                                         when defragmentation processes1                                         complete.   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            .         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 state H                                         of DFO to the command procedure,H                                         it translates to either of these/                                         strings   3                                            PROLOGUE 3                                            EPILOGUE   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, this E                                         status is the final status of 8                                         the DFO process.  A         DFG$ASTLM           All         These logicals affect the C         DFG$BIOLM                       associated process quota of F         DFG$BYTLM                       any DFO process running on the8         DFG$DIOLM                       associated 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$WSEXTENT         DFG$WSQUOTA   I                                                  (continued on next page)   2         A-4 Disk File Optimizer Logicals and Files           I                                    Disk File Optimizer Logicals and Files I                                                         A.2 Logical Names     I         Table_A-1_(Cont.)_Logical_Names__________________________________   (                             Installation         Logical I         Name________________Variant_____Purpose__________________________   F         DFG$TRANSFERSIZE    All         The logical, DFG$TRANSFERSIZE,D                                         helps you tune the Disk FileD                                         Optimizer. The definition ofB                                         this logical allows you toF                                         change the amount of data thatC                                         is transferred at one time. B                                         On a volume that has filesE                                         with large extents, you could C                                         wait up to 20 minutes while B                                         the system transfers theseF                                         large extents before you couldD                                         access the file. By definingF                                         this logical, you could accessH                                         this file in less than a minute.G                                         This logical changes the impact D                                         that the Disk File OptimizerD                                         has on applications that areI                                         simultaneously accessing the same .                                         files.  >                                         This logical is set toA                                         10,000 blocks by default. D                                         You can change it by editingC                                         SYS$STARTUP:DFG$STARTUP.COM F                                         and then executing the commandI         ________________________________procedure._______________________                           I                                Disk File Optimizer Logicals and Files A-5                          I                                                                         B I         _________________________________________________________________   I                                  Example Disk File Optimizer Installation               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 files B                  on the volume, the following lines do not appear:                                                I                              Example Disk File Optimizer Installation B-1            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; 7                  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; 9                  DISK$USER1:[DFG$DATABASE]DFG$VOLUME.DAT;   /                  * Do you wish to use it [YES]?   Y                          Attempting to convert your RMS database so there is no index key V                          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.DAT :                              DFG$DATABASE:DFG$NODE_OLD.DAT;                              DFG$DATABASE:DFG$QUEUE_OLD.DAT <                              DFG$DATABASE:DFG$SCRIPT_OLD.DAT<                              DFG$DATABASE:DFG$VOLUME_OLD.DAT  ^                          After you are satisfied with the installation, you may wish to delete%                          these files.   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 badly *                  the volume is fragmented.        8         Example B-1 Example Installation for Defrag PLUS    I                                                  (continued on next page)             4         B-2 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  <         xxx -> @sys$update:vmsinstal DFG V2.7 DISK$KIT:[DFO]  @         OpenVMS AXP Software Product Installation Procedure V7.0'         It is 11-OCTOBER-2002 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$MWM                 DECW$TE_0068                 _FTA5: 0         * 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.7;                 Beginning installation of DFG V2.7 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]?   !                 Product:      DFG !                 Producer:     DEC "                 Version:      V2.7-                 Release Date: 11-OCTOBER-2002 N         * 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 command Q             procedure and to later run the defragmentation software on the system ?             disk could result in corruption of the system disk.   I                                                  (continued on next page)   I                              Example Disk File Optimizer Installation B-3            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? y >         * 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 the >             defragmentation scheduling and parameter database:  )                 DISK$USER1:[DFG$DATABASE]   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; .         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: 6                 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         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 Installation I                                                  B.1 Example Installation     @         Example B-1 (Cont.) Example Installation for Defrag PLUS  U             +-----------------------------------------------------------------------+ U             |  No more input required.                                              | U             |                                                                       | U             |  Please perform the following after the installation completes:       | U             |                                                                       | U             |  1. Place @SYS$STARTUP:DFG$STARTUP in SYS$MANAGER:SYSTARTUP_VMS.COM   | U             |                                                                       | U             |  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 old 2                 database files will be renamed to:  /                     DFG$DATABASE:DFG$DB_OLD.DAT 1                     DFG$DATABASE:DFG$FILE_OLD.DAT 4                     DFG$DATABASE:DFG$GENERAL_OLD.DAT1                     DFG$DATABASE:DFG$NODE_OLD.DAT 2                     DFG$DATABASE:DFG$QUEUE_OLD.DAT3                     DFG$DATABASE:DFG$SCRIPT_OLD.DAT 3                     DFG$DATABASE:DFG$VOLUME_OLD.DAT   U                 After you are satisfied with the installation, you may wish to delete                  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 27E00386 ?         Defragmentation scheduler, DFG$SPIELN started on SPIELN 7         Scheduler log file: DFG$DATABASE:DFG$SPIELN.LOG >         Beginning the V2.7 installation verification procedure  5                  Testing SHOW of database parameters. 0         Disk File Optimizer for OpenVMS DFG V2.7W         Copyright  Compaq Information Technologies Group, LP 2002. All rights reserved @         CPU limit: 0    I/O limit: 0    process limit: 0  ILDUCE8         CPU limit: 0    I/O limit: 0    process limit: 0  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  6                  Testing SHOW of volume fragmentation.  0         Disk File Optimizer for OpenVMS DFG V2.7W         Copyright  Compaq Information Technologies Group, LP 2002. All rights reserved   0         F r a g m e n t a t i o n    R e p o r t  V         DISK$ALPHA070                                      11-OCTOBER-2002 14:57:24.05  '         The fragmentation index is 12.9 #               1 - 20.9 is excellent               21 - 40.9 is good              41 - 60.9 is fair              61 - 80.9 is poor7              81 - 100 indicates a badly fragmented disk M         Approximately 3.3 (out of 80.0 possible) is due to file fragmentation R         Approximately 9.6 (out of 20.0 possible) is due to freespace fragmentation           Freespace Summary:6                 Total free space:        226348 blocks9                 Percentage free:             11 (rounded) /                 Total free extents:          48 C                 Maximum free extent:     114276 blocks, LBN: 610892 C                 Minimum free extent:          4 blocks, LBN: 173508 6                 Average free extent:       4715 blocks6                 Median free extent:          80 blocks  #         File Fragmentation Summary: =                 Number of files (with some allocation):  5894 =                 Total file extents on the disk:          6039 A                 Average number of file extents per file: 1.024601 :                 Median number of file extents per file:  1           Most Fragmented File: P                 [VMS$COMMON.SYSEXE]SYS$QUEUE_MANAGER.QMAN$JOURNAL;1 (55 extents)@         Installation verification for V2.7 has successfully comp;                 Installation of DFG V2.7 completed at 14:57   F             Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY  D             Creating installation data file:VMI$ROOT:[SYSUPD]DFG027.  1                 VMSINSTAL procedure done at 14:57   I                                                  (continued on next page)   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                                                                                        I                              Example Disk File Optimizer Installation B-7                                  F      _________________________________________________________________  F                                                                  Index      -      D                                 How to :      _______________________________     register (cont'd)6      Defrag                                 PAK,  1-11F        available subcommands, 1-4        shut down Disk File Optimizer:        description of, 1-3                  software, 1-10        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-24<      Disk File Optimizer                 files created,  A-1<        installing on a VMScluster        logical names,  A-3D          system,  1-8                    operating privileges,  1-27E                                          postinstallation procedures, 0      E______________________________        1-259      Editing the systemwide command      privileges,  1-5 9         files, 1-26                      procedure,  1-15 C      Error notification,  A-3            required VMS version,  1-5 ;                                          requirements,  1-1 B                                          upgrading from V1.0,  1-37      F______________________________     variants,  1-3   <      Free disk blocks                    verification,  1-25:        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-26        install software, 1-15         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-11                  _______________________________ =          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-232          list of,  A-3                    Software  @                                             how to install, 1-15:         M______________________________     kit name, 1-11  >         Mail distribution file              license name, 1-11C          See also Logicals, DFG$MAIL_       shutting down Disk File G             ADDRESS                           Optimizer software,  1-10 9                                           SYS$NODE,  1-23 D         P                                 System shutdown procedure,1         _______________________________      1-26 I         PAK                               System startup procedure,  1-26   &          See Product Authorization KeyI         Postinstallation                  U______________________________ 3          editing systemwide command       Upgrading :             files,  1-26                    from V1.0, 1-3         Privileges+          required for operating,  1-27    V I          required to perform              _______________________________ .             installation,  1-5            V1.0:                                             upgrading, 1-3               Index-2                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         