                                       C                      InfoServer_Monitor____________________________ 2                      Installation and User's Guide    D                      This manual explains how to install and use theC                      InfoServer Monitor, a sample system management ;                      application for the InfoServer system.   >                      InfoServer Monitor software is written inD                      VAX BASIC, utilizing system service and libraryH                      calls to obtain device information and mount disks.F                      Users are free to modify the supplied source code8                      to suit environment-specific needs.  A                      InfoServer Monitor software is not supported D                      by Digitial Equipment Corporation. However, theH                      software has been tested and performs the functions.                      described in this manual.        G                      Revision/Update Information: This is a new manual.   E                      Operating System and Version: VMS Version 5.4 or 7                                                   later   D                      Software Version:            InfoServer Monitor=                                                   Version 1.3                  H               __________________________________________________________               November 1992   C               The information in this document is subject to change H               without notice and should not be construed as a commitmentA               by Digital Equipment Corporation. Digital Equipment G               Corporation assumes no responsibility for any errors that *               may appear in this document.  H               The software described in this document is furnished underD               a license and may be used or copied only in accordance-               with the terms of such license.   3                Digital Equipment Corporation 1992.   ?               The following are trademarks of Digital Equipment >               Corporation: DEC, DIGITAL, OpenVMS, VAX, and the               DIGITAL logo.   D               This document was prepared using VAX DOCUMENT, Version               2.0.                               E      ________________________________________________________________   E                                                              Contents     E      Preface..................................................      v     &      1  InfoServer Monitor Description  E          1.1  Devices Selected and Actions Taken..............    1-2 E          1.2  Event Logging...................................    1-3 E          1.3  InfoServer Monitor Files........................    1-4   .      2  Installing InfoServer Monitor Software  E          2.1  Disk Space Requirements.........................    2-1 E          2.2  Disk Mounting Requirements......................    2-1 E          2.3  Installation Procedure..........................    2-1 E          2.3.1  Installation Questions .......................    2-2 E          2.3.2  Informational Messages .......................    2-3 E          2.3.3  Completing the Installation Procedure ........    2-4 E          2.3.4  Error Recovery ...............................    2-4   4      3  After Installing InfoServer Monitor Software  9          3.1  Starting InfoServer Monitor from the System E               Startup Procedure...............................    3-1 E          3.2  Service Names...................................    3-1         A  Sample Installation                 E                                                                   iii                  
         Index              Examples  H            1-1     InfoServer Monitor Log File ..................    1-3           Tables  H            1-1     InfoServer Monitor Files .....................    1-5                                                                      
         iv                           H         ________________________________________________________________  H                                                                  Preface               Purpose of This Guide   C               This guide explains how to install and use InfoServer A               Monitor software on processors that are running the '               OpenVMS operating system.   E               Keep this document with your distribution kit. You will D               need it to install maintenance updates or to reinstall6               InfoServer Monitor for any other reason.           Intended Audience   F               This guide addresses the system manager who installs and/               uses InfoServer Monitor software.            Document Structure  1               This guide is organized as follows:   B               o  Chapter 1 describes InfoServer Monitor functions.  D               o  Chapter 2 describes installation and error recovery                  procedures.  B               o  Chapter 3 describes post-installation procedures.  D               o  Appendix A shows an installation procedure listing.           Related Documents   C               The following documents provide information about the                 InfoServer system:  3               o  InfoServer System Operations Guide   >               o  InfoServer 100 Installation and Owner's Guide  H                                                                        v                 >               o  InfoServer 150 Installation and Owner's Guide  ?               o  InfoServer Client for OpenVMS Utilities Manual            Conventions   ?               The following conventions are used in this guide:   B               UPPERCASE TEXT   Uppercase letters indicate that youA                                must enter a command (for example, 6                                @SYS$UPDATE:VMSINSTAL).  G               system output    This typeface is used in interactive and G                                code examples to indicate system output.   H               boldface text    This bold typeface is used in interactiveE                                examples to indicate typed user input.   A               <Return>         In procedures, a key name is shown D                                enclosed to indicate that you press a3                                key on the keyboard.                                                 
         vi                       H                                                                        1H         ________________________________________________________________  H                                           InfoServer Monitor Description      F               InfoServer services can become inaccessible for a number               of reasons:   F               o  A compact disc is replaced with a new disc that has a(                  different volume label.  H                  When compact discs are routinely updated (for instance,E                  Online Documentation Library Discs, OpenVMS software F                  kits) the volume label changes with each new version.F                  The InfoServer Monitor regularly checks volume labels@                  and remounts disks using the new volume labels.  @               o  Connection is broken between OpenVMS client and"                  InfoServer system  G                  This condition can be caused by network failure, power C                  outage, or by rebooting the InfoServer system. The H                  InfoServer Monitor ensures that all InfoServer services1                  are remounted after such events.   A               o  Data has been written to an InfoServer hard disk   H                  When an InfoServer hard disk is accessed for write, allC                  read connections are terminated. These connections A                  must be manually reestablished using the OpenVMS G                  command MOUNT. The InfoServer Monitor regularly checks F                  InfoServer hard disks and remounts any disks that areE                  found to be inaccessible because of a previous write                   access.  H               The InfoServer Monitor ensures that all InfoServer devicesC               remain accessible to users when such events occur. As D               described in Section 1.1, the Monitor takes actions onH               specific devices and creates a log file like that shown in               Example 1-1.  H                                                                      1-1           &         InfoServer Monitor Description    D               The Monitor runs as a detached process on each OpenVMSB               node on which InfoServer disk access is desired. TheA               process is usually created during system startup by ?               running the InfoServer Monitor startup procedure.   H               InfoServer services must be bound (using the OpenVMS LADCPD               utility) but do not need to be mounted. The InfoServer7               Monitor can handle all mounting of disks.   .         1.1 Devices Selected and Actions Taken  G               A device is selected for InfoServer Monitor action if all -               the following criteria are met:   1               o  The device name begins with DAD.   D                  On OpenVMS systems, all InfoServer compact disc and7                  hard disk device names begin with DAD.   )               o  The device is read-only.   B                  A writable InfoServer device is one that has beenE                  created with the LADCP command BIND /WRITE. Mounting B                  such a device would disconnect all read access toB                  the service mounted under another device name, soD                  the device should never be mounted systemwide. ThisE                  condition would exist if someone had bound a service G                  for write and had not yet mounted it or had logged off -                  before unbinding the device.   -               o  The device is not allocated.   E                  The InfoServer Monitor ignores any InfoServer device 3                  that is allocated to another user.   E               If these criteria are met, the InfoServer Monitor takes $               the following actions:  F               o  If the device is mounted, InfoServer Monitor attempts@                  a read of the device to determine whether it is                  accessible.  F                  -  If the read fails, InfoServer Monitor remounts the7                     device with the known volume label.   D                  -  If the remount fails because the volume label isD                     different, the device is mounted to find the newE                     volume label and then mounted systemwide with the %                     new volume label.            1-2            H                                           InfoServer Monitor DescriptionH                                   1.1 Devices Selected and Actions Taken  E               o  If the device is not mounted, the disk is mounted to C                  find the volume label and then mounted systemwide.   E               By default, InfoServer Monitor checks devices every ten F               minutes. If you want to change this interval, define theC               system logical name INFO_INTERVAL to be the number of B               minutes between checks. For example, if you want theD               Monitor to check every two minutes, define the logical               name as follows:  -               $ DEFINE/SYSTEM INFO_INTERVAL 2   E               Note that because the Monitor checks the value of INFO_ D               INTERVAL after each cycle, you can change the interval=               without having to stop and restart the Monitor.            1.2 Event Logging   H               InfoServer Monitor records device mounting and dismounting>               activity in a log file like that in Example 1-1.  5               Example 1-1 InfoServer Monitor Log File   (               InfoServer Monitor V1.3  1  E               28-FEB-1992 13:52:37  CDDOC02JAN21 mounted on _DAD2:  2 B               28-FEB-1992 13:52:48  CDDOC02JAN22 mounted on _DAD3:A               28-FEB-1992 13:52:55  VMS_DOCS_HD mounted on _DAD4: B               28-FEB-1992 13:53:03  CDBIN02JAN21 mounted on _DAD5:B               28-FEB-1992 13:53:13  CDBIN02JAN22 mounted on _DAD6:B               28-FEB-1992 13:53:20  CDBIN02JAN23 mounted on _DAD7:B               28-FEB-1992 13:53:26  CDBIN02JAN24 mounted on _DAD8:B               28-FEB-1992 13:53:32  VMS_KITS_HD1 mounted on _DAD9:C               28-FEB-1992 13:53:38  VMS_KITS_HD2 mounted on _DAD10: C               28-FEB-1992 13:53:45  NETWORK_DATA mounted on _DAD11:   H                                                 (continued on next page)                H                                                                      1-3           &         InfoServer Monitor Description         1.2 Event Logging   =               Example 1-1 (Cont.) InfoServer Monitor Log File   I               29-FEB-1992 06:04:46  VMS_DOCS_HD dismounted from _DAD4:  3 A               29-FEB-1992 06:04:50  VMS_DOCS_HD mounted on _DAD4: I               11-MAR-1992 19:15:17  CDBIN02JAN21 dismounted from _DAD5: 4 B               11-MAR-1992 19:15:28  CDBIN04MAR21 mounted on _DAD5:G               11-MAR-1992 19:15:43  CDBIN02JAN22 dismounted from _DAD6: B               11-MAR-1992 19:16:12  CDBIN04MAR22 mounted on _DAD6:G               11-MAR-1992 19:16:27  CDBIN02JAN23 dismounted from _DAD7: B               11-MAR-1992 19:16:48  CDBIN04MAR23 mounted on _DAD7:G               11-MAR-1992 19:17:03  CDBIN02JAN24 dismounted from _DAD8: B               11-MAR-1992 19:17:23  CDBIN04MAR26 mounted on _DAD8:  C               1  InfoServer Monitor software version running on the                   system.  F               2  The next ten lines show ten InfoServer devices, boundA                  with LADCP during system startup, that are being 3                  mounted by the InfoServer Monitor.   E               3  These two lines show an InfoServer hard disk service E                  being dismounted and remounted after a write access.   B               4  The remaining lines show four compact discs beingF                  remounted with new volume labels after a new versionsG                  of OpenVMS Consolidated Distribution compact discs are -                  placed in InfoServer drives.   $         1.3 InfoServer Monitor Files  F               Table 1-1 lists files included in the InfoServer Monitor-               kit and created on your system.                                    1-4            H                                           InfoServer Monitor DescriptionH                                             1.3 InfoServer Monitor Files  H               Table_1-1_InfoServer_Monitor_Files________________________  H               File____________________________Description_______________  C               INFOSERVER_MONITOR.BAS+         VAX BASIC source code   F               INFOSERVER_MONITOR.COM+ ++      DCL command procedure to9                                               run Monitor   C               INFOSERVER_MONITOR.EXE++        Executable InfoServer 5                                               Monitor   G               INFOSERVER_MONITOR.LOG++        Log of Monitor activities   D               INFOSERVER_MONITOR.INCLUDE+     VAX BASIC include file  C               INFOSERVER_MONITOR.OBJ+         VAX BASIC object code   F               INFOSERVER_MONITOR_STARTUP.COM+ DCL command procedure toE               ++                              start Monitor at system 5                                               startup   D               KITINSTAL.COM+                  VMSINSTAL installation7                                               procedure H               +Included_in_kit__________________________________________  !               ++Created on system H               __________________________________________________________  F               If you want to modify source code files, you can extractE               the files from the savset supplied in the [INFOMON.KIT]                directory.                          H                                                                      1-5                       H                                                                        2H         ________________________________________________________________  G                                  Installing InfoServer Monitor Software       C               This chapter describes installation prerequisites and B               explains how to install InfoServer Monitor software.  #         2.1 Disk Space Requirements   G               Installing the Monitor requires 27 blocks of disk storage H               on the system disk. Additional minimal space is needed forF               the log file after the Monitor starts to run. Space usedF               by the log file depends on how much activity the MonitorC               performs but would typically be a few blocks per day.   &         2.2 Disk Mounting Requirements  A               If you mount InfoServer devices before starting the H               InfoServer Monitor, specifiy the /NOMOUNT_VERIFY qualifierB               to the OpenVMS command MOUNT. This qualifier enablesH               quick determination of which devices need to be remounted.E               The InfoServer Monitor always mounts devices with mount $               verification disabled.  "         2.3 Installation Procedure  @               The installation procedure consists of a series ofG               questions and informational messages and should take less                 than five minutes.  A               To start the installation, you invoke the VMSINSTAL F               command procedure from a privileged account, such as the               SYSTEM account.   D               To abort the installation procedure at any time, pressG               Ctrl/Y. When you press Ctrl/Y, the installation procedure C               deletes all files it has created up to that point and ?               exits. You can then start the installation again.   H                                                                      2-1           .         Installing InfoServer Monitor Software"         2.3 Installation Procedure  B               The following example displays the command to invokeE               VMSINSTAL to install InfoServer Monitor from tape drive ,               MUA0: and the system response.  %               $ @SYS$UPDATE:VMSINSTAL   J                     VAX/VMS Software Product Installation Procedure Vn.n-n  )               It is dd-mmm-yyyy at hh:mm. =               Enter a question mark (?) at any time for help.   $         2.3.1 Installation Questions  E               This section discusses the questions that appear during H               the installation. See Appendix A for a sample installation               procedure.  A               Each question in the installation is marked with an G               asterisk (*) at the beginning of the line. Some questions G               show the default response in brackets, for example [YES]. H               If you want to give the default response, press the RETURN               key.                 1  System backup  E                  VMSINSTAL asks if you are satisfied with your system E                  backup. If you are satisfied with the backup of your B                  system disk, press RETURN. Otherwise, enter NO toA                  discontinue the installation. Because only three A                  files are added to the system startup directory, C                  there is no need to perform a system backup before "                  the installation.  O                  * Are you satisfied with the backup of your system disk [YES]?                  2  Device name  H                  The device where the InfoServer Monitor kit is located.F                  Specify the tape name or disk and directory where theD                  kit is located. You may also specify a logical nameC                  pointing to that device or directory. For example, F                  if the InfoServer Monitor kit is on InfoServer device3                  DAD2, use DAD2 as the device-name.   G                  * Where will the distribution volumes be mounted: DAD2                  3  Product name   H                  Enter the name of the product you are installing. Enter                  INFOMON.            2-2            G                                  Installing InfoServer Monitor Software H                                               2.3 Installation Procedure  F                  VMSINSTAL displays the list of products that you have                  chosen.  [                  Enter the products to be processed from the first distribution volume set: $                  * Products: INFOMON                 4  Options  E                  For information on additional VMSINSTAL options, see D                  the OpenVMS documentation on Software Installation.  1                  o  Choosing installation options   Q                     * Enter installation options you wish to use (none): <Return>   D                     VMSINSTAL now begins the installation procedure.  =                     The following products will be processed: "                       INFOMON Vn.n  G                         Beginning installation of INFOMON Vn.n at hh:mm   H                     %VMSINSTAL-I-RESTORE, Restoring product saveset A...  (               o  Choosing to purge files  A                  You have the option to purge files from previous C                  versions of InfoServer Monitor that are superseded G                  by this installation. Purging is recommended; however, E                  if you need to keep files from the previous version, 6                  enter NO in response to the question.  [                  * Do you want to purge files replaced by this installation [YES]? <Return>   $         2.3.2 Informational Messages  B               At this point, the installation procedure displays aA               number of informational messages that report on the @               progress of the installation. There are no further?               questions. If the installation procedure has been E               successful up to this point, VMSINSTAL moves the new or E               modified files to their target directories and displays %               the following messages:   \               %VMSINSTAL-I-MOVEFILES, files will now be moved to their target directories...  H                                                                      2-3           .         Installing InfoServer Monitor Software"         2.3 Installation Procedure  3         2.3.3 Completing the Installation Procedure   G               The following messages indicate that the entire installa- )               tion procedure is complete:   @                  Installation of INFOMON Vn.n completed at hh:mm  2                  VMSINSTAL procedure done at hh:mm  <               You can now log out of the privileged account:                 $ LOGOUT>               SYSTEM     logged out at dd-mmm-yyyy hh:mm:ss.ss           2.3.4 Error Recovery  @               If errors occur during the installation, VMSINSTAL5               displays the following failure message:   P               %VMSINSTAL-E-INSFAIL, The installation of INFOMON Vn.n has failed.  D               Errors can occur during the installation if any of the)               following conditions exist:   ;               o  The operating system version is incorrect.   >               o  A prerequisite software version is incorrect.  A               o  Quotas necessary for successful installation are                   insufficient.  H               o  System parameter values for successful installation are                  insufficient.  G               For descriptions of the error messages generated by these A               conditions, see the OpenVMS documentation on system A               messages, recovery procedures, and OpenVMS software A               installation. If you are notified that any of these F               conditions exist, you should take the appropriate actionF               as described in the message. For example, you might needD               to change a system parameter or increase an authorized               quota value.               2-4                        H                                                                        3H         ________________________________________________________________  H                             After Installing InfoServer Monitor Software      A               This chapter describes operations you perform after 5               installing InfoServer Monitor software.   ?         3.1 Starting InfoServer Monitor from the System Startup              Procedure   F               The InfoServer Monitor installation procedure starts theG               Monitor but does not provide for automatic startup of the /               Monitor when your system reboots.   G               The InfoServer Monitor installation places the InfoServer H               Monitor system startup file INFOSERVER_MONITOR_STARTUP.COME               in the SYS$MANAGER directory. To start the Monitor with 5               each system reboot, proceed as follows:   E               o  If you start up your system with the SYSMAN utility, .                  enter the following commands:  (                  $ RUN SYS$SYSTEM:SYSMANT                  SYSMAN> STARTUP ADD FILE SYS$MANAGER:INFOSERVER_MONITOR_STARTUP.COM                  SYSMAN> EXIT   R               o  Otherwise, add the following line to SYS$MANAGER:SYSTARTUP_V5.COME                  or the appropriate startup command procedure at your                   site:  :                  $ @SYS$MANAGER:INFOSERVER_MONITOR_STARTUP           3.2 Service Names   E               By default, the InfoServer system creates service names D               for most volumes, using the volume label (for example,E               CDDOC04MAR21) as the service name. Specifying a generic F               service name for the volume (for example, VMSDOC) allowsD               the same service name to be used when the volume labelE               changes. See the InfoServer System Operations Guide for ;               information about the CREATE SERVICE command.   H                                                                      3-1           4         After Installing InfoServer Monitor Software         3.2 Service Names   B               When used in conjunction with generic service names,D               InfoServer Monitor frees you from the need to know the6               volume labels of any InfoServer devices.  H               To take advantage of this feature, remove from your systemB               startup procedure any commands that mount InfoServer@               devices. Because the Monitor mounts all InfoServerF               devices it finds, you need only enter LADCP BIND /SYSTEME               commands. This feature saves time during system startup H               and eliminates the need to hard-code volume labels in your(               system startup procedures.                                                                             3-2                        H                                                                        AH         ________________________________________________________________  H                                                      Sample Installation      %               $ @SYS$UPDATE:VMSINSTAL   J                       VAX/VMS Software Product Installation Procedure V5.5  (               It is 6-MAR-1992 at 12:35.  =               Enter a question mark (?) at any time for help.   L               %VMSINSTAL-W-ACTIVE, The following processes are still active:                       NIXON                        FORD                       CARTER                       REAGAN                       BUSH6               * Do you want to continue anyway [NO]? YU               * Are you satisfied with the backup of your system disk [YES]? <Return> Z               * Where will the distribution volumes be mounted: kits:[infomon013] <Return>  X               Enter the products to be processed from the first distribution volume set.!               * Products: infomon K               * Enter installation options you wish to use (none): <Return>   7               The following products will be processed:                    INFOMON V1.3  E                       Beginning installation of INFOMON V1.3 at 12:36   D               %VMSINSTAL-I-RESTORE, Restoring product save set A ...  X               * Do you want to purge files replaced by this installation [YES]? <Return>  B                       All questions necessary for the installation8                       of INFOMON V1.3 have been answered  B               %INFOMON-I-LINK, Linking InfoServer Monitor image...  H                                                                      A-1                    Sample Installation     T                       The following command should be inserted in the system startupW                       command procedure SYS$MANAGER:SYSTARTUP_V5.COM or the appropriate 6                       command procedure for your site:  E                               @SYS$MANAGER:INFOSERVER_MONITOR_STARTUP   M                       Or, you may use SYSMAN to start the InfoServer Monitor:   5                               $ RUN SYS$SYSTEM:SYSMAN U                               SYSMAN> STARTUP ADD FILE INFOSERVER_MONITOR_STARTUP.COM *                               SYSMAN> EXIT  %               %VMSINSTAL-I-MOVEFILES, L                       Files will now be moved to their target directories...  ,               Starting InfoServer Monitor...K               %RUN-S-PROC_ID, identification of created process is 00004EBB   E                       Installation of INFOMON V1.3 completed at 12:38   W               Enter the products to be processed from the next distribution volume set. "               * Products: <Return>  7                       VMSINSTAL procedure done at 12:38                                                    A-2                                E      ________________________________________________________________   E                                                                 Index     ?      C                                    Installation (cont'd) >      ___________________________           sample listing, A-18      Check interval                        starting, 2-1;        adjusting, 1-3                      time needed, 2-1   E      D__________________________          M__________________________   7      Device                               Messages, 2-3 <        actions taken, 1-2                 MOUNT command, 2-1B        mounting, 2-1                       mount verification, 2-1D        selection criteria, 1-2             /NOMOUNT_VERIFY qualifier3      Disk                                     , 2-1 ?        mounting, 2-1                      Mounting devices, 2-1       Disk space requirements, E         2-1                               S__________________________   ;      E                                    Service name, 3-1 E      ___________________________          Starting InfoServer Monitor 1      Error recovery, 2-4                    , 3-1       Event logging, 1-3   E      F                                    V__________________________ ;      ___________________________          Volume label, 3-1       Files included in kit, 1-4          I__________________________        Installation         aborting, 2-1        completing, 2-4        disk mounting          requirements, 2-1        disk space requirements,           2-1        questions, 2-2   E                                                               Index-1                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       