                                 .              Image Analysis Installation Guide                      July 1989  N              This document contains instructions for installing Image Analysis              on VAX/VMS.        @              Operating System and Version: VAX/VMS V4.6 or later  >              Software Version:             Image Analysis V1.0                        *              Digital Equipment Corporation                              Contents    O                 PREFACE                                                       v   O           CHAPTER 1  IMAGE ANALYSIS INSTALLATION PROCEDURES                 1-1 O                 1.1   PREPARING TO INSTALL IMAGE ANALYSIS                   1-1   O                 1.2   PREREQUISITE SOFTWARE FOR IMAGE ANALYSIS              1-1 O                 1.3   INSTALLATION PROCEDURE REQUIREMENTS                   1-1 O                 1.3.1     User Account Quotas                               1-4 O                 1.3.2     Using VMSINSTAL                                   1-4   O                 1.4   INSTALLATION PROCEDURE                                1-6 @                 1.4.1     Step 1. Log in to the System Manager'sO                           Account                                           1-6 O                 1.4.2     Step 2. Invoke VMSINSTAL                          1-7 C                 1.4.3     Step 3. Insert the First Installation Kit O                           Volume                                            1-7 O                 1.4.4     Step 4. Select Installation Options               1-7 B                 1.4.5     Step 5. Create the Image Analysis sourceO                           directory                                         1-8 G                 1.4.6     Step 6a. Confirmation of the use of the Image O                           Analysis directories                              1-9 F                 1.4.7     Step 6b. Confirmation of the creation of theO                           Image Analysis directories                        1-9 H                 1.4.8     Step 7. Insert the Subsequent Installation KitO                           Volumes                                           1-9 O                 1.4.9     Step 8. Finishing the Installation               1-10 ?                 1.4.10    Step 9. The Installation Verification O                           Procedure                                        1-17 O                 1.4.11    Step 10. End of the Installation Procedure       1-18 O                 1.5   AFTER THE INSTALLATION                               1-18   >                 1.6   SPECIAL POST-INSTALLATION ACTIVITIES FORO                       VAXCLUSTER SYSTEMS                                   1-19 O                 1.7   ERROR CONDITIONS                                     1-19       O                                                                             iii                   Contents        O           CHAPTER 2  CREATING AN IMAGE ANALYSIS KIT                         2-1   O           APPENDIX A  SAMPLE INSTALLATION                                   A-1                TABLESO                 1-1   Installation Parameters and Quotas                    1-2 O                 1-2   Disk Space Requirements (blocks)                      1-2 O                 1-3   Disk Space Requirements (blocks)                      1-3 O                 1-4   Quotas required to run IVP                            1-3   O                 1-5   Quotas required to use Image Analysis                 1-4                                                                    iv               O           _____________________________________________________________________              Preface       I              This document describes how to install Image Analysis on the J              VAX/VMS operating system. It is intended for system managers.2              This document applies to Version 1.0.  J              Before continuing with this manual, please note the following              information:   P               o  Keep this document with your distribution kit. You will need toM                 refer to it again if you need to reinstall Image Analysis for                  any reason.   J               o  The installation procedure is described step by step. TheJ                 dialog, for the most part, is self-explanatory. The systemM                 prompts you to answer questions and change volumes, and waits /                 for you to tell it to continue.   P               o  For more information on installing products on VAX/VMS, see the,                 VMS System Manager's Manual.                                  O                                                                               v                                         Chapter 1   0           Image Analysis Installation Procedures          2           1.1  Preparing to Install Image Analysis  O              Distribution media must be mounted in numerical order. The instal- C              lation procedure will prompt you to mount the volumes. K              To mount the distribution medium, see the VMS System Manager's N              Manual. This manual also details several options to the installa-0              tion procedure; be sure to read it.  7           1.2  Prerequisite Software for Image Analysis   ;              Image Analysis requires VAX/VMS V4.6 or later.   N              If you are installing Image Analysis on a VAXstation with the VWSB              software, ensure the VWS software has been installed.  2           1.3  Installation Procedure Requirements  M              Before you can install Image Analysis, you must have the follow-               ing:   P               o  SETPRV privilege, or CMKRNL, WORLD, OPER, and SYSPRV privileges$                 for the installation        O                                     Image Analysis Installation Procedures  1-1                  /               o  2 megabytes of physical memory   P               o  The minimum sysgen parameters and quotas described in Table 1-1  H               o  The required free disk space described in Table 1-2 and                 Table 1-3   O              Table_1-1:_Installation_Parameters_and_Quotas_____________________   O              Quota_or_Parameter_________Minimum_Value__________________________ 0              VIRTUALPAGECNT             >= 10000  G              GBLPAGES                   11+(DCLTABLES_001 global pages)   )              GBLSECTIONS                5   0              Process PGFLQUOTA          >= 10000  /              Process BYTLM              >= 5000 O              __________________________________________________________________   9              Disk space requirements for the system disk:   O              Table_1-2:_Disk_Space_Requirements_(blocks)_______________________               Before O              InstallationNet_Used______________________________________________                 5000        1000 O              __________________________________________________________________ H              Disk space requirements for the Image Analysis source disk:                    5           1-2  Image Analysis Installation Procedures                  O              Table_1-3:_Disk_Space_Requirements_(blocks)_______________________               Before O              InstallationNet_Used______________________________________________                 3600        3600 O              __________________________________________________________________ N              If you select to run the IVP after the installation the following              are also required:   H               o  The minimum sysgen parameters and quotas from Table 1-4  F               o  SETPRV privilege, or all of the following privileges:                    o  CMKRNL                    o  SYSPRV    O              Table_1-4:_Quotas_required_to_run_IVP_____________________________               Quota or O              Parameter________Minimum_Value____________________________________   "              Process BYTLM    5000                 Process DIOLM    10                 Process ENQLM    20                 Process FILLM    10O              __________________________________________________________________ M              Refer to the Guide to Setting Up a VMS System for information on F              modifying system parameters or account quotas/privileges.  O              As long as the quotas listed at the beginning of this document are 9              met, you can continue with the installation.           O                                     Image Analysis Installation Procedures  1-3                  N              Approximate installation time after the saveset has been restoredM              from the distribution media: 10 to 20 minutes, depending on your "              system configuration.    $           1.3.1  User Account QuotasO              To use Image Analysis, each account must meet the following quotas 5              and minimum requirements from Table 1-5.     O              Table_1-5:_Quotas_required_to_use_Image_Analysis__________________ O              Quota____________Minimum_Value____________________________________   "              BYTLM            5000                 DIOLM            10                 ENQLM            25                 FILLM            10  "              PGFLQUOTA        5000  !              WSDEF            100 O              __________________________________________________________________               1.3.2  Using VMSINSTAL  O              To install Image Analysis, log in to the system manager's account. O              In Step 2 of the installation procedure you must invoke VMSINSTAL. A              The VMSINSTAL command line has the following format: B                $ @SYS$UPDATE:VMSINSTAL IMG010 ddn: OPTIONS N <RET>                 1. IMG010   L                 Where the Image Analysis product installed is Image AnalysisL                 V1.0. You can also enter an asterisk (*) in place of IMG010.      5           1-4  Image Analysis Installation Procedures                                 2. ddn:   K                 Where dd is the device code and n is the unit number. CSA1: K                 is the device name used in examples in this document. It is K                 not necessary to use the console drive for installing Image K                 Analysis. If you do use the console drive, when the instal- M                 lation is complete, be sure to replace any media you may have N                 found in the drive. Note that you cannot use the console driveK                 if you are installing Image Analysis on a VAX 8600 or 8650.   M                 ddn could also be the device and directory where the savesets                  reside.                  3. OPTIONS N  L                 Specify "N" with the OPTIONS keyword to specify that release.                 notes be displayed or printed.  L              VMSINSTAL prompts you for any parameter that is not supplied on              the command line.@              When you invoke VMSINSTAL, it checks the following:  J               o  Whether you are logged in to the system manager's accountM                 (SYSTEM). It is recommended that you install layered software 2                 from the system manager's account.  N               o  Whether you have adequate quotas for installing layered prod-                 ucts.   @                 VMSINSTAL checks for the following quota values:                    o  ASTLM = 24                    o  BIOLM = 18  !                  o  BYTLM = 18000                     o  DIOLM = 18    O                                     Image Analysis Installation Procedures  1-5                                    o  ENQLM = 30                    o  FILLM = 20N                 VMSINSTAL then checks to see if either of the following condi-M                 tions exist that should be discontinued prior to resuming the '                 installation procedure:   4                  1. Whether DECnet is up and running  B                  2. If there are any users logged in to the system  M                 If VMSINSTAL detects any of these conditions, VMSINSTAL gives I                 you the opportunity to stop the installation procedure by L                 prompting you before continuing. If you want to stop the in-8                 stallation, simply press the RETURN key.  %           1.4  Installation Procedure   O              This section contains excerpts from the installation dialog, along #              with explanatory text.   J              Note that enhancements to VMSINSTAL in future releases of VMSL              may result in additional prompts appearing during the course ofI              the installation. Such prompts may not be documented in this I              installation guide; however, the installation should proceed J              normally. Refer to the Read Before Installing or Using letterC              for any notes pertaining to installing Image Analysis.   ?           1.4.1  Step 1. Log in to the System Manager's Account              <RET>   %                Username: SYSTEM <RET> %                Password:        <RET>             5           1-6  Image Analysis Installation Procedures                  )           1.4.2  Step 2. Invoke VMSINSTAL   =              Type the following commands to invoke VMSINSTAL:   C                $ @SYS$UPDATE:VMSINSTAL IMG010 CSA1: OPTIONS N <RET> .              VMSINSTAL displays the following:  A                   VAX/VMS Software Product Installation Procedure   *                It is dd-mmm-yyyy at hh:mm.>                Enter a question mark (?) at any time for help.  U                * Are you satisfied with the backup of your system disk [YES]? Y <RET>     A           1.4.3  Step 3. Insert the First Installation Kit Volume H              Mount the media as requested and type Y when it is mounted.  A                Please mount the first volume of the set on CSA1:. '                * Are you ready? Y <RET> 8                The following products will be installed:                    IMG V1.0   :                Beginning installation of IMG V1.0 at hh:mmC                %VMSINSTAL-I-RESTORE, Restoring product saveset A...     4           1.4.4  Step 4. Select Installation Options  O                * Do you want to run the IVP after the installation [YES]? <RET> V                * Do you want to purge files replaced by this installation [YES]? <RET>N              The Installation Verification Procedure (IVP) runs tests to checkJ              that the installation procedure was successful. If you do notN              want to run the IVP, type "NO" in response to the question. Press:              RETURN to run the IVP after the installation.        O                                     Image Analysis Installation Procedures  1-7                  O              The installation procedure does not automatically purge files that O              are replaced during the installation. These are the files residing L              in SYS$SYSTEM, SYS$STARTUP, SYS$MANAGER, SYS$LIBRARY, SYS$HELP,M              SYS$MESSAGE, and SYS$TEST, that constitute each release of Image O              Analysis. Purging is recommended; you must press RETURN to request L              that files be purged. If you do not want the files purged, type.              "NO" in response to the question.  K              The system HELP files are updated in either case and the Image L              Analysis startup and shutdown command procedures in SYS$STARTUP.              and SYS$MANAGER are never purged.  C           1.4.5  Step 5. Create the Image Analysis source directory   g                * Enter the DEVICE where the Image Analysis directory will reside [SYS$SYSDEVICE]: <RET> `                * Enter the DIRECTORY where the Image Analysis sources will reside [IMAGE]: <RET>M              A directory where the Image Analysis sources will reside is cre- K              ated. The directory will contain the following subdirectories:                  o  BUILD                 o  DCL                 o  DOC                 o  EXAMPLES                  o  IMAGE_ANALYSIS                  o  IMG_LIBRARY                 o  INSTALL                 o  IVP                 o  SYSTEMPCl        5           1-8  Image Analysis Installation Proceduresi o  e            I              Each subdirectory contains the sources for the corresponding               component.S  0                                             NOTEJ                  It is strongly recommended that you use a disk other thanF                  SYS$SYSDEVICE as the location for your Image AnalysisH                  sources. SYS$SYSDEVICE is supplied as the default as it?                  is guaranteed to be available on every system.I    G           1.4.6  Step 6a. Confirmation of the use of the Image AnalysisN                  directories  I                * Would you like to use SYS$SYSDEVICE:[IMAGE] [YES]? <RET> K              If the directory SYS$SYSDEVICE:[IMAGE] exists then this promptIK              will appear. If you do not want to use the specified directory N              answer "NO" and you will be prompted again for the device and di-O              rectory specification. If you press the RETURN key the directoriesU5              will contain the Image Analysis sources.     L           1.4.7  Step 6b. Confirmation of the creation of the Image Analysis                  directories  L                * Would you like to create SYS$SYSDEVICE:[IMAGE] [YES]? <RET>J              If a mistake was made in entering the directory specificationN              answer "NO" and you will be prompted again for the device and di-O              rectory specification. If you press the RETURN key the directories               will be created.     G           1.4.8  Step 7. Insert the Subsequent Installation Kit Volumes   H                %BACKUP-I-READYREAD, mount volume 2 on _CSA1: for reading0                Enter "YES" when ready: YES <RET>          O                                     Image Analysis Installation Procedures  1-9                  O              The BACKUP utility prompts you to insert the next volume and waitsnO              for you to type YES after inserting it. If you type NO in response C              to the prompt, BACKUP will display the question again.u  K              If you need to abort the installation procedure, press CTRL/Y.tJ              When you press CTRL/Y, the installation procedure deletes allL              files it has created up to that point and exits. If you want toM              retry the installation procedure after pressing CTRL/Y, you must1$              start over from Step 3.  3           1.4.9  Step 8. Finishing the InstallationN  O              From this point in the installation, you may receive the followingTI              informational messages. These messages are normal and do not               indicate errors. G              %VMSINSTAL-I-SYSDIR, This product creates system directory +              VMI$ROOT:[SYSHLP.EXAMPLES.IMG]   G              %VMSINSTAL-I-SYSDIR, This product creates system directory #              VMI$ROOT:[SYSTEST.IMG]NO              If the installation procedure is successful, the executable imagesI3              are moved to their target directories.   ]                %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories...-  L              In addition, SYS$HELP:HELPLIB.HLB and SYS$LIBRARY:DCLTABLES.EXEN              are updated to include the new version of the Image Analysis helpF              text and the IMAGE command line definition, respectively.                        6           1-10  Image Analysis Installation Procedures                 ^                +-----------------------------------------------------------------------------+^                ! The Image Analysis software is now installed on your system.                !^                !                                                                             !^                ! If you have elected to run the Installation Verification Procedure as part  !^                ! of this installation it will be executed following this message.            !^                !                                                                             !^                ! Once the VMSINSTAL procedure is complete, you need to refer to the section  !^                ! titled, "After the Installation," in the Image Analysis Installation Guide  !^                ! and perform the activities described in that section before attempting to   !^                ! use the software.                                                           !^                +-----------------------------------------------------------------------------+  L              This message indicates the software installation portion of the-              VMSINSTAL procedure is complete. O              The following files have been created or modified by the installa-               tion procedure:  0               o  SYS$SYSTEM:IMG$DEFINE_IMAGE.EXE  0               o  SYS$SYSTEM:IMG$REPORT_IMAGE.EXE  4               o  SYS$SYSTEM:IMG$CONVERT_SYSTEMPC.EXE  T               o  SYS$STARTUP:IMG$STARTUP.COM (VMS V5) or SYS$MANAGER:IMG$STARTUP.COM                 (VMS V4)  %               o  SYS$HELP:HELPLIB.HLBV  '               o  SYS$HELP:IMGDEFIMA.HLBT  *               o  SYS$LIBRARY:DCLTABLES.EXE  5               o  SYS$SYSROOT:[SYSHLP.EXAMPLES]IMG.DIRi  ?               o  SYS$SYSROOT:[SYSHLP.EXAMPLES.IMG]IMG$IMAGE.COM   @               o  SYS$SYSROOT:[SYSHLP.EXAMPLES.IMG]IMG$SYSTEM.COM      O                                    Image Analysis Installation Procedures  1-11s w  ,            -               o  SYS$SYSROOT:[SYSTEST]IMG.DIR.  1               o  SYS$SYSROOT:[SYSTEST]IMG$IVP.COM   :               o  SYS$SYSROOT:[SYSTEST.IMG]IMG$CLOCKIVP.OBJ  :               o  SYS$SYSROOT:[SYSTEST.IMG]IMG$TRACEIVP.OBJ  ;               o  SYS$SYSROOT:[SYSTEST.IMG]IMGIVP_SYSTEM.PCS   /               o  SYS$UPDATE:IMG$PURGE_IMAGE.COM   M              The following files are the Image Analysis source files added by (              the installation procedure:  I               <> Build file and sources for DCL and HELP library support:n  ?                  o  IMG$DEVICE:[IMG$DIRECTORY.DCL]BUILD_DCL.COMe  F                  o  IMG$DEVICE:[IMG$DIRECTORY.DCL]CONVERT_SYSTEMPC.RNO  ?                  o  IMG$DEVICE:[IMG$DIRECTORY.DCL]DCLSYNTAX.RNO   B                  o  IMG$DEVICE:[IMG$DIRECTORY.DCL]DEFINE_IMAGE.RNO  ;                  o  IMG$DEVICE:[IMG$DIRECTORY.DCL]IMAGE.CLD   ;                  o  IMG$DEVICE:[IMG$DIRECTORY.DCL]IMAGE.RNO   =                  o  IMG$DEVICE:[IMG$DIRECTORY.DCL]IMGHELP.FORo  B                  o  IMG$DEVICE:[IMG$DIRECTORY.DCL]REPORT_IMAGE.RNO  =               <> Image Analysis Manual in text and LN03 form:_  @                  o  IMG$DEVICE:[IMG$DIRECTORY.DOC]IA_MANUAL.LN03  ?                  o  IMG$DEVICE:[IMG$DIRECTORY.DOC]IA_MANUAL.TXTi    6           1-12  Image Analysis Installation Procedures                 >                  o  IMG$DEVICE:[IMG$DIRECTORY.DOC]INSTALL.LN03  =                  o  IMG$DEVICE:[IMG$DIRECTORY.DOC]INSTALL.TXT_  9               <> Build file and sources for the examples:   F                  o  IMG$DEVICE:[IMG$DIRECTORY.EXAMPLES]IMG$STARTUP.TMP  D                  o  IMG$DEVICE:[IMG$DIRECTORY.EXAMPLES]IMG$IMAGE.COM  C                  o  IMG$DEVICE:[IMG$DIRECTORY.EXAMPLES]SHAREIMG.COM_  L               <> Build file and sources for DEFINE=IMAGE, REPORT=IMAGE, etc:  I                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]BUILD_IMAGE_0                    ANALYSIS.COM_  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]FILNAMCOM.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMAGEDEFS.MAR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMAGEINCR.MAR  I                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGBKTIO.MARe  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGCLKSMP.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGCOMDEF.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGCREPAT.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGDCLCOM.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGDEFCOM.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGDEFIMA.HLP  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGDEFINE.FOR    O                                    Image Analysis Installation Procedures  1-13e                 J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGDUMPER.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGENTBKT.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGENTGRP.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGGETEFI.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGGETEND.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGGETEXE.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGGETHEX.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGGETMAP.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGGETNAM.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGGETRAN.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGGETSTR.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGHLPLBR.MAR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGMAKFIL.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGREPORT.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGRPTCOM.FOR  J                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGSAMPLE.MAR  I                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGSHELL.MARd  G                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGSHR.OPTG  I                  o  IMG$DEVICE:[IMG$DIRECTORY.IMAGE_ANALYSIS]IMGTRACE.MAR       6           1-14  Image Analysis Installation Procedures                 8               <> Build file and sources for IMG$LIBRARY:  O                  o  IMG$DEVICE:[IMG$DIRECTORY.IMG_LIBRARY]BUILD_IMG_LIBRARY.COM   C                  o  IMG$DEVICE:[IMG$DIRECTORY.IMG_LIBRARY]IMAGE.OPTt  F                  o  IMG$DEVICE:[IMG$DIRECTORY.IMG_LIBRARY]IMGCOMPQ.MAR  D                  o  IMG$DEVICE:[IMG$DIRECTORY.IMG_LIBRARY]IMGLIB.OLB  H                  o  IMG$DEVICE:[IMG$DIRECTORY.IMG_LIBRARY]IMGMESSAGE.MSG  E                  o  IMG$DEVICE:[IMG$DIRECTORY.IMG_LIBRARY]IMGMULQ.MARe  G                  o  IMG$DEVICE:[IMG$DIRECTORY.IMG_LIBRARY]IMGSAMPLE.OPTe  F                  o  IMG$DEVICE:[IMG$DIRECTORY.IMG_LIBRARY]IMGSHELL.OBJ  G                  o  IMG$DEVICE:[IMG$DIRECTORY.IMG_LIBRARY]IMGSIGNAL.MARl  F                  o  IMG$DEVICE:[IMG$DIRECTORY.IMG_LIBRARY]IMGTRACE.OLB  F                  o  IMG$DEVICE:[IMG$DIRECTORY.IMG_LIBRARY]IMGTRACE.OPT  I                  o  IMG$DEVICE:[IMG$DIRECTORY.IMG_LIBRARY]IMGUSEROPEN.MARd  M               <> Build file and sources for the installation and verifications                 procedures:c  G                  o  IMG$DEVICE:[IMG$DIRECTORY.INSTALL]BUILD_INSTALL.COMn  C                  o  IMG$DEVICE:[IMG$DIRECTORY.INSTALL]CREATEKIT.COMs  I                  o  IMG$DEVICE:[IMG$DIRECTORY.INSTALL]IMG$PURGE_IMAGE.COMd  A                  o  IMG$DEVICE:[IMG$DIRECTORY.INSTALL]IMG_IVP.COM   >                  o  IMG$DEVICE:[IMG$DIRECTORY.INSTALL]KITA.DIR    O                                    Image Analysis Installation Procedures  1-15g o  v            >                  o  IMG$DEVICE:[IMG$DIRECTORY.INSTALL]KITB.DIR  >                  o  IMG$DEVICE:[IMG$DIRECTORY.INSTALL]KITC.DIR  C                  o  IMG$DEVICE:[IMG$DIRECTORY.INSTALL]KITINSTAL.COMo  K               <> Build file and sources for images used in the verification                  procedure:  ?                  o  IMG$DEVICE:[IMG$DIRECTORY.IVP]BUILD_IVP.COMn  B                  o  IMG$DEVICE:[IMG$DIRECTORY.IVP]IMG$CLOCKIVP.FOR  B                  o  IMG$DEVICE:[IMG$DIRECTORY.IVP]IMG$TRACEIVP.FOR  C                  o  IMG$DEVICE:[IMG$DIRECTORY.IVP]IMGIVP_SYSTEM.PCSf  M               <> Link file, objects and object library for CONVERT=SYSTEM_PC:c  O                  o  IMG$DEVICE:[IMG$DIRECTORY.SYSTEMPC]IMG$CONVERT_SYSTEMPC.OBJo  L                  o  IMG$DEVICE:[IMG$DIRECTORY.SYSTEMPC]IMG$GET_FILE_NAME.OBJ  H                  o  IMG$DEVICE:[IMG$DIRECTORY.SYSTEMPC]IMG$OPEN_FILE.OBJ  J                  o  IMG$DEVICE:[IMG$DIRECTORY.SYSTEMPC]IMG$PC_ROUTINES.OBJ  P                  o  IMG$DEVICE:[IMG$DIRECTORY.SYSTEMPC]LINK_CONVERT_SYSTEMPC.COM  C                  o  IMG$DEVICE:[IMG$DIRECTORY.SYSTEMPC]SYSTEMPC.OLBi  0                                             NOTEA                  IMG$DEVICE = device where IMG$DIRECTORY resides.e              6           1-16  Image Analysis Installation Procedures i  a            A           1.4.10  Step 9. The Installation Verification Procedure.  L              If this option was chosen, the installation procedure calls theK              Installation Verification Procedure (IVP) to verify that Image 1              Analysis was successfully installed.   X                +-----------------------------------------------------------------------+X                ! Beginning the Image Analysis V1.0 Installation Verification Procedure !X                +-----------------------------------------------------------------------+I              A variety of messages are displayed here as the InstallationRJ              Verification Procedure tests the software. When the procedure4              is complete the following is displayed:  0                +-------------------------------+0                ! Successful completion of IVP. !0                +-------------------------------+  L              The IVP can also be executed independent of the installation by              typing:(                $ @SYS$TEST:IMG$IVP <RET>  0                                             NOTE  K                  Before running the IVP independent of the installation theA9                  following command file must be executed:t  3                    $ @SYS$STARTUP:IMG$STARTUP <RET> :                  OR if your system is VMS V4 then execute:  3                    $ @SYS$MANAGER:IMG$STARTUP <RET>vK                  This loads image PC sampling image and defines IMG$LIBRARY "                  and IMG$EXAMPLES.                O                                    Image Analysis Installation Procedures  1-17h i  a            <           1.4.11  Step 10. End of the Installation Procedure  X                Enter the products to be installed from the next distribution volume set.'                * Products [EXIT]: <RET>I  8                        VMSINSTAL procedure done at hh:mm                  $ LOGOUT <RET>e?                SYSTEM     logged out at dd-mmm-yyyy hh:mm:ss.ss L              When the Image Analysis installation procedure is complete, youM              can choose to install more products or end the installation pro-eN              cedure. To end the installation procedure, type EXIT or press theO              RETURN key. If you removed any media from the console drive beforeM'              beginning, replace it now.h  J              Note that VMSINSTAL deletes or changes entries in the processO              symbol tables during the installation. Therefore, if you are going O              to continue using the system manager's account, you should log out <              and log back in again to restore those symbols.  %           1.5  After the Installationt  N              Image Analysis is now installed and can be invoked with the IMAGE              command.   N              The installation procedure modifies the DCL command table so thatL              the IMAGE command is recognized and processed. However, the oldO              command table is still in effect for those users who are currentlydM              logged in. All logged-in users who want to use the IMAGE commandl5              must log off the system and log back on. L              To complete the Image Analysis installation procedure, you must=              now edit your site-specific system startup file.   L               o  Edit the system startup file, SYS$MANAGER:SYSTARTUP.COM, to!                 include the line:   6                   $ @SYS$STARTUP:IMG$STARTUP.COM <RET>      6           1-18  Image Analysis Installation Procedures                 7                 OR if your system is VMS V4 then enter:   2                   $ @SYS$MANAGER:IMG$STARTUP <RET>L                 When processed at system startup time, the command procedureK                 loads the image PC sampling shareable image and defines them;                 IMG$EXAMPLES and IMG$LIBRARY logical names.l  L              If you answered NO to the IVP question during the installation,M              then you must load the image PC sampling shareable image at thisA0              time. To do this, type the command:  3                $ @SYS$STARTUP:IMG$STARTUP.COM <RET>E  3              OR if your system is VMS V4 then type::/                $ @SYS$MANAGER:IMG$STARTUP <RET>l    J           1.6  Special Post-Installation Activities for VAXcluster Systems  M              If you have just completed the installation of Image Analysis onyL              a VAXcluster system which utilizes a node specific system disk,O              you must perform the Image Analysis installation on each common orn:              private system root in the VAXcluster system.             1.7  Error Conditionsy  N              If the installation procedure or IVP fails for any reason, one of1              the following messages is displayed:   7                Image Analysis V1.0 Installation failed. \                Please consult the Image Analysis Installation Guide for further information.  N                Image Analysis V1.0 Installation Verification Procedure failed.\                Please consult the Image Analysis Installation Guide for further information.            O                                    Image Analysis Installation Procedures  1-19                  M              An error during the installation can be caused by one or more ofB&              the following conditions:  E               o  Insufficient disk space to complete the installationi  K               o  Insufficient value specified for system virtual page count                  parameter   '               o  Insufficient AST quotai  5               o  Insufficient buffered I/O byte count   .               o  Insufficient subprocess quota  -               o  Insufficient open file quotaa  7               o  Insufficient process paging file quotao  7               o  Insufficient process working set quotas  M               o  Incorrect version of VAX/VMS (Image Analysis will install on <                 VAX/VMS V4.6 through VAX/VMS V5.9 inclusive)  K              For descriptions of the error messages generated by these con-mI              ditions, see the VMS System Messages and Recovery ProceduresYB              Reference Manual and the VMS System Manager's Manual.O              If you are notified that any of these conditions exist, you shouldsN              take the appropriate action, as described in the message. You mayK              need to change a system parameter or increase a process quota.vI              If the installation fails, you must restart the installationf#              procedure from step 3.t  0                                             NOTE  J                  Because Image Analysis contains references to global sym-L                  bols defined by VMS, reinstall Image Analysis each time you0                  update to a new version of VMS.      6           1-20  Image Analysis Installation Procedures d  s                                   Chapter 2-  (           Creating an Image Analysis Kit        L              After Image Analysis is installed on your system, a new kit canN              be created from the sources. The command file to create this kit,J              CREATEKIT.COM, resides in the installation subdirectory (i.e.2              DISK1$:[IMAGE.INSTALL]CREATEKIT.COM).  L              CREATEKIT.COM needs two parameters-the device where the sourcesO              directory resides and the sources directory. To use CREATEKIT.COM,               type:@                $ SUBMIT/PARAMETER=("DISK1$","[IMAGE]") CREATEKIT  L              After the kit subdirectories are built, the kit savesets can beJ              built using the VMS kit build procedure, SYS$UPDATE:SPKITBLD.N              The kit can then be reinstalled (with any modifications you make)H              using the VMS installation procedure, SYS$UPDATE:VMSINSTAL.                          O                                             Creating an Image Analysis Kit  2-1- -  -                                   Appendix A             Sample Installationt        L              This appendix contains a sample installation of Image Analysis.M              The Installation Verification Procedure (IVP) runs at the end ofo              the installation.    !           $ @sys$update:vmsinstal   A            VAX/VMS Software Product Installation Procedure V5.1-1S  %           It is 13-JUN-1989 at 09:11. 9           Enter a question mark (?) at any time for help.RH           * Are you satisfied with the backup of your system disk [YES]?C           * Where will the distribution volumes be mounted: DEVICE: T           Enter the products to be processed from the first distribution volume set.           * Products: IMG010           * Options:  3           The following products will be processed:H             IMG V1.0  6            Beginning installation of IMG V1.0 at 09:12            O                                                        Sample Installation  A-1T ]  .            ?           %VMSINSTAL-I-RESTORE, Restoring product saveset A ... D           * Do you want to run the IVP after the installation [YES]?K           * Do you want to purge files replaced by this installation [YES]?Mc           * Enter the DEVICE where the Image Analysis directory will reside [SYS$SYSDEVICE]: DUA1$:gU           * Enter the DIRECTORY where the Image Analysis sources will reside [IMAGE]:c-           %IMG-W-NOSUCHDIR, No such directorye9           * Would you like to create DUA1$:[IMAGE] [YES]? 9           %IMG-I-CREDIR, Creating DUA1$:[IMAGE] directory =           %IMG-I-CREDIR, Creating DUA1$:[IMAGE.DCL] directory =           %IMG-I-CREDIR, Creating DUA1$:[IMAGE.DOC] directory B           %IMG-I-CREDIR, Creating DUA1$:[IMAGE.EXAMPLES] directoryH           %IMG-I-CREDIR, Creating DUA1$:[IMAGE.IMAGE_ANALYSIS] directoryE           %IMG-I-CREDIR, Creating DUA1$:[IMAGE.IMG_LIBRARY] directory A           %IMG-I-CREDIR, Creating DUA1$:[IMAGE.INSTALL] directory F           %IMG-I-CREDIR, Creating DUA1$:[IMAGE.INSTALL.KITA] directoryF           %IMG-I-CREDIR, Creating DUA1$:[IMAGE.INSTALL.KITB] directoryF           %IMG-I-CREDIR, Creating DUA1$:[IMAGE.INSTALL.KITC] directory=           %IMG-I-CREDIR, Creating DUA1$:[IMAGE.IVP] directory B           %IMG-I-CREDIR, Creating DUA1$:[IMAGE.SYSTEMPC] directory  K           +---------------------------------------------------------------+IK           ! All questions regarding the installation of Image Analysis    ! K           ! have now been asked.  The installation will continue for      !IK           ! approximately 10-20 minutes.                                  !IK           +---------------------------------------------------------------+O?           %VMSINSTAL-I-RESTORE, Restoring product saveset B ...Ed           %IMG-I-CONTINUE, Restore of saveset B complete, now linking the Image Analysis components.j           %VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[SYSHLP.EXAMPLES.IMG].I           %CREATE-I-EXISTS, VMI$ROOT:[SYSHLP.EXAMPLES.IMG] already exists b           %VMSINSTAL-I-SYSDIR, This product creates system disk directory  VMI$ROOT:[SYSTEST.IMG].A           %CREATE-I-EXISTS, VMI$ROOT:[SYSTEST.IMG] already exists ?           %VMSINSTAL-I-RESTORE, Restoring product saveset C ... ]           %IMG-I-CONTINUE, Restore of saveset C complete, now dumping Image Analysis sources.               "           A-2  Sample Installation T  R            Y           +-----------------------------------------------------------------------------+MY           ! The Image Analysis software is now installed on your system.                !$Y           !                                                                             !GY           ! If you have elected to run the Installation Verification Procedure as part  !nY           ! of this installation it will be executed following this message.            !_Y           !                                                                             !NY           ! Once the VMSINSTAL procedure is complete, you need to refer to the section  ! Y           ! titled "After the Installation" in the Image Analysis Installation Guide    ! Y           ! and perform the activities described in that section before attempting to   !EY           ! use the software.                                                           !RY           +-----------------------------------------------------------------------------+S  X           %VMSINSTAL-I-MOVEFILES, Files will now be moved to their target directories...T           +------------------------------------------------------------------------+T           ! Beginning the Image Analysis V1.0 Installation Verification Procedure. !T           +------------------------------------------------------------------------+  8           +--------------------------------------------+8           ! Test the IMAGE CONVERT=SYSTEM_PC command.  !8           +--------------------------------------------+  B           %IMG-I-PIDSMP,        709 samples found for PID -SYSTEM-M           +-----------------------------------------------------------------+[M           ! Test the collection of IMAGE PC data using the sampling method. !MM           +-----------------------------------------------------------------+IM           ! The message %INSTALL-W-NOPREV may appear. This is normal and    !aM           ! does not indicate an error.                                     ! M           +-----------------------------------------------------------------+U  K           +---------------------------------------------------------------+RK           ! Test the IMAGE DEFINE=IMAGE command for the sampling method.  !CK           +---------------------------------------------------------------+O                O                                                        Sample Installation  A-3     $            !           Enter DEFINE statement: !           Enter DEFINE statement:M6           Enter program unit spec, next DEFINE or END:6           Enter program unit spec, next DEFINE or END:1           Enter address spec, next DEFINE or END:M1           Enter address spec, next DEFINE or END:$1           Enter address spec, next DEFINE or END: 2           Enter sampling spec, next DEFINE or END:2           Enter sampling spec, next DEFINE or END:>           %IMG-I-BKTFILCRE, bucket file of    6 blocks created  K           +---------------------------------------------------------------+rK           ! Test the IMAGE REPORT=IMAGE command for the sampling method.  !TK           !                                                               !OK           !           Please ignore the "Enter command:"  message.        !OK           +---------------------------------------------------------------+ ;           %IMG-I-HISTOGRAM, NL:[]FOR010.DAT; file generated <           ------Start of histogram display on terminal------#           Enter H if you need help.              Enter command:J           +--------------------------------------------------------------+J           ! Test the collection of IMAGE PC data using the trace method. !J           +--------------------------------------------------------------+  H           +------------------------------------------------------------+H           ! Test the IMAGE DEFINE=IMAGE command for the trace method.  !H           +------------------------------------------------------------+                        "           A-4  Sample Installation o  M            !           Enter DEFINE statement: !           Enter DEFINE statement:t6           Enter program unit spec, next DEFINE or END:6           Enter program unit spec, next DEFINE or END:1           Enter address spec, next DEFINE or END:[1           Enter address spec, next DEFINE or END: 1           Enter address spec, next DEFINE or END:I2           Enter sampling spec, next DEFINE or END:2           Enter sampling spec, next DEFINE or END:>           %IMG-I-BKTFILCRE, bucket file of    6 blocks created  H           +------------------------------------------------------------+H           ! Test the IMAGE REPORT=IMAGE command for the trace method.  !H           !                                                            !H           !         Please ignore the "Enter command:" message.        !H           +------------------------------------------------------------+;           %IMG-I-HISTOGRAM, NL:[]FOR010.DAT; file generatedl<           ------Start of histogram display on terminal------#           Enter H if you need help.A             Enter command:+           +-------------------------------+-+           ! Successful completion of IVP. !-+           +-------------------------------+e  6            Installation of IMG V1.0 completed at 09:31S           Enter the products to be processed from the next distribution volume set.            * Products: EXIT  ,            VMSINSTAL procedure done at 09:32                    O                                                        Sample Installation  A-5t