Watch V6
Overview

Step
Description
Completed
1
Check you distribution kit to make sure it’s complete.
2
Gather the information you need and complete the installation checklist. Be sure to determine if you will be doing an automatic or customer isntall.
3
Make sure that WATCH is not running anywhere. This includes deleting any batch jobs that might be automatically monitoring your system using watch.
4
Perform a backup of the WATCH directory structure as well as any special WATCH files.
5
Install the product following the instructions in this manual. You might want to print out the sample installation and keep it handy during the install.
6
Install your license key.
7
Copy your disknames.dat file from the WATCH_EXE directory to the WATCH_DAT directory OR recreate it using the create_disk_file procedure.
8
Make sure your system startup file includes the commands necessary to setup WATCH when your system reboots.



Check your distribution kit
You should have all the the necessary items before beginning. Refer to the section on distribution kit contents on page  for a complete list.

Gathering Information                    
For Watch you should complete the following table.

Check
Description
Okay
Disk space
Watch installation requires at least 2200 blocks on a VAX or 2800 blocks on an AXP system. You can install Watch on a disk other than your system disk but you will still need at least this many free blocks on your system disk for temporary files.
OS
Watch requires VMS V5.4 or higher to install
Current Version
If you are upgrading from a prior version you should make a note of the version here _______________________.
Logical names
Do a show logical watch*. If you have any logical names other than watch_cdu, watch_com, watch_dat, watch_doc and watch_exe add definitions for them to the file sys$manager:watch_site_logicals.com. For example if watch$active is defined to be “YES” you would add the following line to the site_logicals command procedure, if it isn’t already included:
$ define/system watch$active YES

If these extra logical names are defined anywhere other than the sys$manager:watch_site_logicals.com procedure their definitions maybe lost during the upgrade and need to be added to watchs startup procedure afterward.
Autoinstall?
Complete the installation check list on page . Are you doing an autoinstall or custom install? _________________


Stop any jobs running Watch
Some sites run Watch in a regularily submitted batch job. Any jobs like this should be stopped before upgrading.

Backup Watch
It is not normally necessary to backup the entire Watch directory structure. We recommand the following backup be performed:

To disk        $ backup disk1:[product...]*.*:*, sys$manager:*product*.* -
            disk1:[savesets]watch_v#.sav/save_set

To tape        $ initialize tape_drive product
$ mount tape_drive /foreign
$ backup disk1:[product...]*.*;*, sys$manager:*product*.* -
tape_drive:product_v#.sav /label=product
$ dismount tape_drive

Install the product
Throughout this procedure text generated by the installation procedure is shown in small, bold type. The entries you make are italicized.

There are two basic types of product installations:

    Automatic
    Custom

The automatic method requires fewer responses but makes the following assumptions:

Help will be installed in a user help library not the system library.
Watch will be installed in SYS$SYSDEVICE:[Watch].
The installation procedure will not purge existing files.
The command definition will be installed in the DCLTABLES.

These defaults are acceptable to most customers and offer a simple, easy way to install on your system. Before installing Watch be sure you’ve completed the installation check list so you can tell if the default installation is the best choice for your site. If these defaults are acceptable, type "YES" in step 8. Otherwise, type "NO" and reply to the additional questions.

1. Load the distribution media on the appropriate load device and put the device on-line
    OR
  Download the installation files from the Saiga Systems Web page or ftp site and copy them to
     a temporary directory; be sure to unzip the downloaded files on the VAX or AXP, unzipping
     them on a PC will corrupt them
    OR
  Extract the installation files from the CD following the instructions in the CD leaflet.

2.  Log into the system manager's account, SYSTEM.

3.  Make sure the distribution device is on-line; the installation will fail if it isn't.

4.  Set your default to SYS$UPDATE.

$ SET DEFAULT SYS$UPDATE
5.  Invoke the VMSINSTAL command procedure.
(You do not have to type ":" after the load device.)
    a)   For a tape distribution
$ @VMSINSTAL Watch060 <load_device>
for example: $ @VMSINSTAL Watch090 MKA500:
    b)   For files copied from a CD or downloaded from the net
    $ @VMSINSTAL Watch090

6.  VMSINSTAL was developed by Digital for installing products which could cause problems if they are installed incorrectly. As a result, it displays informational messages and asks some ominous-sounding questions. Saiga Systems products are designed to not cause these types of problems on your system. It is safe to answer YES to both of the following questions.

Alpha AXP/VAX/OpenVMS Software Product Installation Procedure V6.0

It is 3-MAY-1994 at 13:50.

%VMSINSTAL-W-ACTIVE, The following processes are still active:
* Do you want to continue anyway [NO]? YES
* Are you satisfied with the backup of your system disk [YES]?  YES

7. Confirm that the distribution media is loaded and on-line and proceed.

    a) Using a tape

Please mount the first volume of the set on <load_device>:.
* Are you ready?  YES
%MOUNT_I_MOUNTED, SAIGA mounted on <load_device>:
The following products will be processed:

    b) Using files copied from a distribution CD or downloaded from the net

* Where will the distribution volumes be mounted: disk:[directory]
* Enter installation options you wish to use (none):
The following products will be processed:

8.  Enter YES if the default installation is acceptable and go to step 10. Otherwise, enter NO and go to step 9.

You can have this installation automatically performed if the following defaults are acceptable:

1. Help will be installed in a user help library rather than in the system help library.
2. The product will be installed on the system disk SYS$SYSDEVICE:.
3. The installation will not purge existing files.
4. The product-name command will be installed in the DCLTABLES.
* Are the above defaults acceptable [YES]? YES
%product-name-I-AUTOINSTALL, This installation will continue with the listed defaults.

9. Do this step if you typed "NO" in response to the question in step 8. In this step, the installation procedure will ask for your response to each option. Please review the sections on these steps referred to on the installation check list before proceeding with this option. In the following example, the user has elected to purge files, install the product in a sub-directory on DUA0 and install the HELP text and command definition in the system tables.

%product-name-I-NOAUTOINSTALL, This installation will ask questions relating to specific options

* Do you want to purge files replaced by this installation[NO]? YES
* Name of disk [SYS$SYSDEVICE:]: DUA0:[SAIGA_SYSTEMS.]
You may choose one of the following options when installing Watch's
help files:
    1) Add the help as an additional user help library.
    2) Add the help in the system help library.
    3) Do not install help files.
* Enter the help option number [1]: 2
* Add product-name command to DCLTABLES [YES]? <Return>

10. The rest of the installation will now proceed automatically; when completed you will see:

    VMSINSTAL procedure done at 13:56


After the installation

Move the Watch disknames.dat file from Watch_exe to Watch_dat:
$ set def watch_exe:
$ rename disknames.dat watch_dat:*.*

OR recreate the file:
$ set def watch_com:
$ @create_disk_file

Install your Watch V6 license
A detailed description of the license load procedure is included on page . Be sure to enter each item exactly the way it is printed on the license. You may be installing a Cohort V3 license instead of a Watch license; in this case you will need to install the license only for the first Cohort V3 product you install.                

Update your system startup file, if necessary
Make sure that the command:
$ @sys$manager:watch_startup
is included in your system startup file. It should always be included as close to the bottom of the startup procedure as possible.

Run Watch
We recommend you restart Watch by logging out and logging back in to the system account. Then reconfigure it using the same command that should be present in your system startup file to guarantee that Watch gets configured anytime the system is rebooted:

$ @sys$manager:watch_startup

Now trying running watch with the wide screen to show that it is installed correctly:
$ set terminal/width=132
$ watch /wide /disk=all

If Watch doesn’t start normally consult the Watch user manual for information on troubleshooting.



Watch V6 Sample Installation

In this sample installation the user is upgrading from Watch V5.0 to V6.0. Watch is currently installed under a saiga_systems directory.

Username: SYSTEM
Password:
  Welcome to OpenVMS AXP (TM) Operating System, Version V1.5 on node ROC
   Last interactive login on Wednesday, 24_NOV_1999 12:32
   Last non_interactive login on Wednesday, 24_NOV_1999 12:31
        You have 7 new Mail messages.
$ show logical watch*
 "WATCH_CDU" = "ROC$DKA200:[SAIGA_SW.WATCH.CDU]"
 "WATCH_COM" = "ROC$DKA200:[SAIGA_SW.WATCH.COM]"
 "WATCH_DAT" = "ROC$DKA200:[SAIGA_SW.WATCH.DAT]"
 "WATCH_DOC" = "ROC$DKA200:[SAIGA_SW.WATCH.DOC]"
 "WATCH_EXE" = "ROC$DKA200:[SAIGA_SW.WATCH.EXE.AXP]"

$ show dev roc$dka200:

Device                  Device           Error    Volume         Free  Trans Mnt
Name                   Status           Count     Label        Blocks Count Cnt
$2$DKA200:       (ROC)  Mounted              1  ALPHA_PUB1       57498     4   3
$ show queue roc$batch
Batch queue ROC$BATCH, busy, on ROC::

 Entry  Jobname         Username             Status
 _____  _______         ________             ______
   646  WATCH_1         SYSTEM               Executing
$ dele/entry=646
$ set def sys$update
$ @vmsinstal watch060
    OpenVMS ALPHA Software Product Installation Procedure V1.5
It is 24_NOV_1999 at 12:33.Enter a question mark (?) at any time for help.

* Are you satisfied with the backup of your system disk [YES]?
* Where will the distribution volumes be mounted: eagle$dkb300:[kit_build.cohort30.nosource_kits]

* Enter installation options you wish to use (none):
The following products will be processed:
 WATCH V6.0
    Beginning installation of WATCH V6.0 at 12:37

%VMSINSTAL_I_RESTORE, Restoring product save set A ...

   You can have this installation automatically performed if the following
   defaults are acceptable:

       1. Help will be installed in a user help library rather than in
          the system help library.
       2. WATCH will be installed on the system disk SYS$SYSDEVICE:[WATCH].
       3. The installation will not purge existing files.
       4. The WATCH command will be installed in the DCLTABLES.

* Are the above defaults acceptable [YES]? NO
%WATCH_I_NOAUTOINSTALL, This installation will ask questions relating to site specific options.

   Note:  If you answer YES to the following question, the DCLTABLES will be
          purged if you have the installation add the WATCH command to the
          DCLTABLES.  To avoid purging this file, enter NO.  See the
          Installation Manual for more information.

* Do you want to purge files replaced by this installation [NO]? yes

   To install this product in the root directory, enter the device name of
   the disk where you want the product installed (e.g. DUA0:). Please
   include the colon.

   To install this product in a subdirectory, enter the full device and
   directory specification (e.g. DUA0:[LARRY.]). The "." after LARRY is
   required.

* Name of disk [SYS$SYSDEVICE:]: roc$dka200:[saiga_sw.]

   You may choose one of the following options when installing WATCH's
   help files:

       1) Add the help as an additional user help library.
       2) Add the help in the system help library
       3) Do not install help files.

       Note:  Exclusive access is required to install the help text into
              the system help library.  Otherwise, if someone accesses
              help during the installation, it will fail.

* Enter help option number [1]: 1

   To permanently add the WATCH command verb to the DCLTABLES, answer YES
   to the following question. If you answer NO, you must add the command to
   your process command table. See the Installation Manual for more
   information.

   Note:  If you add the WATCH command to the DCLTABLES a check will be
          to ensure you have sufficient global pages. The installation will
          fail if the system does not have the required global pages. Refer
          to the Installation Manual for more information.

* Add WATCH command to DCLTABLES [YES]? NO
%WATCH_I_ASKDONE, This installation will not ask any more questions.
%VMSINSTAL_I_RESTORE, Restoring product save set C ...
%WATCH_I_RELINK, Relinking images
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.CDU] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.COM] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.DAT] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.DEF] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.DOC] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.EXE] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.EXE.AXP] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.EXE.VAX] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.LIS] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.MAP] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.MSG] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.OBJ] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.OBJ.AXP] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.OBJ.VAX] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.SRC] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.SRC.AXP] already exists
%CREATE_I_EXISTS, ROC$DKA200:[SAIGA_SW.][WATCH.SRC.VAX] already exists
%WATCH_I_CREATEFILE, Creating WATCH systartup command file
    A command file containing the logical names needed to use WATCH
    has been created. It is called WATCH_STARTUP.COM. A copy of this
    file has been placed in SYS$MANAGER: and a backup copy has been
    placed in the [WATCH.COM] directory.

    To ensure the required logicals are defined after a system re_boot,
    the file SYS$SYSMANAGER:SYSTARTUP_VMS.COM should be modified to contain
    the following text:

        $ @SYS$MANAGER:WATCH_STARTUP.COM



   Please refer to the "After Running VMSINSTAL" section of the installation
   guide for detailed instructions on how to finish upgrading / installing
   WATCH. To install a new license use:

    $ @SYS$MANAGER:SAIGA_LICENSE.COM

   If you have any questions or problems please contact us at:

                 Saiga Systems
                 #215 801 _ 6th Street S.W.
                 Calgary, Alberta, Canada
                 T2P 3V8

                 Phone _ 1 800 561 8876
                         1 403 263 1151
                 FAX   _ 1 403 263 0744
                 Email _ support@saiga.com or
                         sales@saiga.com
                 WWW   _ http://www.saiga.com/

* Press return to continue:

 To be automatically notified of patches and new releases and to receive
 helpful tips on how to better use Watch please join the Watch list_server.
 Send an e_mail message to Watch@saiga.com with the body of the message:
 join watch your_e_mail_address

 the list server will respond with an introductory e_mail advising you how
 to post questions to the list and how to make changes to, or delete,
 your subscription.
%VMSINSTAL_I_MOVEFILES, Files will now be moved to their target directories...
    Installation of WATCH V6.0 completed at 12:44

   Adding history entry in VMI$ROOT:[SYSUPD]VMSINSTAL.HISTORY

   Creating installation data file: VMI$ROOT:[SYSUPD]WATCH060.VMI_DATA

    VMSINSTAL procedure done at 12:45
$ set def watch_exe:
$ dir disk*

Directory ROC$DKA200:[SAIGA_SW.WATCH.EXE.AXP]

DISKNAMES.DAT;4     

Total of 1 file.
$ type disknames.dat
$1$DKA100:
$1$DKA300:
$1$DKB300:
$2$DKA200:
$2$DKA300:
$ rename disknames.dat watch_dat:*.* /log
%RENAME_I_RENAMED, ROC$DKA200:[SAIGA_SW.WATCH.EXE.AXP]DISKNAMES.DAT;4 renamed to ROC$DKA200:[SAIGA_SW.WATCH.DAT]DISKNAMES.DAT;2
$ watch/version
%PKMS_E_LOGNF, No Authorization Key has been installed.
$! Load the license key
$ @sys$manager:saiga_license

           PKMS LICENSE KEY LOAD PROCEDURE

    Distributor Name: SAIGA
    Authorization Code: VMS
    Product Name: WATCH6AXP
    Company Name: SAIGA SYSTEMS SOFTWARE INC.
    Node Name: ROC
    Checksum A:
    ...
    Is the License Key correct[Y]:

    Load License Key PKMS$WATCH6AXP [Y]:

    Create license key startup file: WATCH6AXP_PKMS_START.COM [Y]:
    %PKMSLOAD_I_CREATE, Startup file created: WATCH6AXP_PKMS_START.COM

Please include the above startup file in your system startup file
so that the license key is loaded every time the system is restarted.
If you need to reload this license key in the future then you should
execute the following line:  @SYS$MANAGER:WATCH6AXP_PKMS_START.COM

          PKMS LICENSE KEY LOAD PROCEDURE COMPLETED


$ watch/version
WATCH 6.0
Copyright Saiga Systems Inc. 1989_1999, All Rights Reserved
Phone  1 (800) 561 8876
      1 (403) 263 1151
Fax    1 (403) 263 0744

WWW    www.saiga.com
FTP    ftp.saiga.com
E_mail sales@.saiga.com
      support@saiga.com

Licensed to:     TESTING                         
License name:    WATCH6AXP
License node:    _SITE_
License expiry:  12/31/2099

Current date:    24_NOV_1999 12:47:25.77
Node name:       ROC
VMS version:     V1.5    
HW type:         DEC 3000 Model 300L
Cluster member:  Y
Number of nodes: 3
$ submit/queue=roc$batch/keep/noprint/param=(16:30) watch_com:watch_1.com
Job WATCH_1 (queue ROC$BATCH, entry 654) started on ROC$BATCH
$ lo