home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / gtwpsrcv.zip / README.TXT < prev   
Text File  |  1996-07-05  |  8KB  |  146 lines
  1.  
  2.                DESKTOP RECOVERY PROCEDURE FOR GAMMATECH SENTRY BACKUPS
  3.                *******************************************************
  4.  
  5. this procedure was developed by Frontline Technologies, Inc.  The user is
  6. granted usage and redistribution privileges of the contents in their original
  7. form only.  Frontline Technologies, Inc., provides no warranties, explicit or
  8. implied, and assumes no liabilities for usage.  Please direct any comments or
  9. questions to James W. Richards at frontlne@wwa.com.
  10.  
  11.                        BACKGROUND AND USAGE 
  12.                        ********************
  13.  
  14. The Gammatech Sentry Utility provides selection options for backing up the OS/2
  15. desktop.  Unfortunately, Softouch systems provides no means of recovering the
  16. desktop.  Thus, this command procedure was developed.
  17.  
  18. After installation, the procedure can be used to recovery the desktop using
  19. the following procedure.  Components that must be backed up for the recovery
  20. procedure to work are:  the desktop tree, os2.ini, os2sys.ini, and config.sys.
  21. Warning:  Do not use this procedure unless you have the Gammatech utilities 
  22. installed. 
  23.  
  24. To recover, boot OS2.  Hit ALT-F1 at boot time as soon as the OS2 logo first
  25. appears in the upper left hand corner.  When the maintenance screen appears,
  26. select the (C) option to boot with the command line only.  When the OS/2 command
  27. line prompt appears enter GTWPSRCV XX where XX represents which GAMMATECH 
  28. backup version you wish to restore.  Enter 00 for the most current version.  The
  29. procedure will recover the 2 ini files, config.sys, and the Desktop directory
  30. saved by SENTRY.  Then, reboot the system.
  31.  
  32.                         INSTALLATION AND SETUP
  33.                         **********************
  34.  
  35. The procedure works off the CONFIG.X file stored in your X:\OS2\BOOT Directory, 
  36. not from the standard config.sys used at normal boot time.  Make all changes
  37. to the CONFIG.X file.  Do not include any changes to CONFIG.SYS; the procedure
  38. will not work when running from the desktop, since it tries to remove the 
  39. current desktop.  
  40.  
  41. First copy the command procedure to a directory included on the path statement 
  42. in the CONFIG.X file.  The file may be marked as read only and thus, you may 
  43. have to remove the read-only attribute, either through Gammatech's file utility,
  44. the attribute command, or from some other utility that lets you reset file 
  45. attributes.
  46.  
  47. Next, add three environment variables to CONFIG.X.  Set BOOTDRV to your boot 
  48. drive, one character only please.  Usually, this will be C or D.  Next, Set 
  49. GTPATH to the path where your Gammatech utilities reside.  Mine are stored on
  50. the E drive in directory GTU30 and thus, the value I use for GTPATH is E:\GTU30. 
  51. Finally setup GTBCKUP to the backup path that the Sentry program will use.   I 
  52. specified E:\GTU30\BACKUP.
  53.  
  54. Next, Setup the SENTRY program to do the backups.  I recommend setting up a  
  55. shadow of the SENTRY program ICON in your startup folder.  Start the Sentry, if 
  56. needed, and open the settings notebook.  Check all three backup options.  The
  57. command procedure assumes that the backups are stored in a subdirectory
  58. of the Gammatech utilities directory called BACKUP.  The entry in my backup 
  59. directory, for example is E:\GTU30\BACKUP.  Make certain the path matches 
  60. with the value of environment variable GTBCKUP.  Next, setup of the frequency of
  61. your backups.  I've selected the time-of-day option and entered a specific time 
  62. so that my backups occur once a day at the first boot of the day.  Finally 
  63. setup the number of backups versions you wish to retain.  I selected 7 to get a
  64. backup for each day of the week.  Remember the first backup version is labeled
  65. as 00.  Now, as soon as the Sentry program does a backup, you should be in a
  66. position to restore your desktop.    
  67.  
  68.                           CAVEATS
  69.                           ********
  70.  
  71. A lot of time was spent trying to make this procedure "fail safe".  The 
  72. procedure checks that all the pieces are in place before starting the recovery.
  73. This portion is well tested and is functioning satisfactorily.  It shuts down 
  74. without harm if any required piece is missing.  On examining the procedure, 
  75. you will notice that the ini and config.sys files are copied to *.tmp versions 
  76. just in case a failure occurs.  The procedure does not do this for the Desktop
  77. under the assumption that if xcopy works for copying the desktop to a temporary
  78. tree structure, it will also work for restoring the desktop.  The only situation
  79. I can think of where this assumption is false is if you try to restore the 
  80. Desktop while the desktop is open.  It will fail under this case, but in the
  81. situation where DELTREE tries to remove it, I think.  The procedure checks the
  82. return code here, but I do not know if DELTREE sets a return code on a failure. 
  83. Nonetheless, this case will not happen if you run the procedure as suggested. 
  84. Thus, saved temporary versions of the ini and config.sys file are available for 
  85. a manual recovery if disaster strikes during a recovery.
  86.  
  87. Other considerations in the procedure's design are attempts to recover existing
  88. files when a failure occurs.  Checks are in place to do this for all components 
  89. save the desktop.  If for some reason, none of your desktop components exist, you
  90. should be able to recovery by simply doing a mkdir DESKTOP on your boot drive 
  91. and then running the recovery procedure.  The procedure will take care over 
  92. from here, assuming that the backups exist.  The caveat here is that these 
  93. components are not completely tested.  Be aware of this situation if the
  94. procedure fails while trying to recover the two ini and config.sys files.  
  95.  
  96. A note as a personal observation.  I would have preferred to write this 
  97. procedure in REXX, but have been unsuccessful in getting REXX to work 
  98. satisfactorily from the command line only.  I am not entirely pleased with the
  99. recovery logic in the procedure, and can better appreciate the signal handling
  100. features of REXX and, in turn, the limitations of the CMD language.  If anyone
  101. has suggestions for how to get REXX installed without the DESKTOP running, I
  102. would greatly appreciate the input. 
  103.  
  104. One final note to Softouch if they happen to get a hold of a copy of this 
  105. posting.  I am a great fan of Gammatech utilities; their products have bailed me 
  106. out of troublesome situations on a number of occasions.  I use almost all their
  107. products and I cannot say enough positive things about them.  It is unfortunate,
  108. in my opinion, that Softouch has not included recovery software.  Why have 
  109. backup facilities in your software, but none for recovery?  This simply does not
  110. make sense.  The ideal approach here is to write a recovery  program that is
  111. integrated with the backup features of Sentry.  Softouch, are you listening? 
  112. I'm making the procedure public for two reasons.  First, it has bailed my butt
  113. out of trouble on a number of occasions and this confirms, in part, the need
  114. for it. Secondly, I have seen a number of horror stories on the Internet
  115. concerning desktops getting garbled up with no apparent options to the concerned
  116. parties to recover.  This is further evidence of the procedure's need.  IBM does
  117. provide backup and recovery procedures for the desktop, but the backups are 
  118. taken each time you boot, ugh!  Softouch's Sentry program provides a much more 
  119. reasonable and manageable option of backing up once a day.  IBM, are you 
  120. listening too?
  121.  
  122.  
  123. James W. Richards
  124. Frontline Technologies, Inc.
  125. E-mail:  frontlne@wwa.com
  126. July 5, 1996 
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.