home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / hdutl / backmw.doc < prev    next >
Text File  |  1994-07-13  |  10KB  |  231 lines
  1. DOCUMENTATION FOR BACKMW.COM v2.50
  2.  
  3. BACKMW is (c) S. Kluger, 1984. The object code has been released into
  4. the Public Domain and may be distributed freely, except for profit.
  5.  
  6. 1. WHAT IS BACKMW
  7.  
  8. BACKMW is an incremental backup/recovery utility written for Morrow's
  9. M16 hard disk system (hence the MW in BACKMW). It can be used on any
  10. hard disk system provided that:
  11.     - the DPB of the highest logical drive includes all lower
  12.       logical drives as RESERVED TRACKS
  13.     - the hard disk does not have more than 1000 cylinders
  14.  
  15. BACKMW is used once to toally back up the complete hard disk onto
  16. floppies, then it can be used periodically to update the information
  17. backed up. It automatically keeps track of CRC values for all cylinders
  18. and will back up only those cylinders that have been written to since the
  19. last backup. While BACKMW can be used for partial recovery, writing back
  20. to the hard disk only those cylinders that have changed since the last backup,
  21. it is really intended for catastrophic failures, such as trashed logical
  22. drives or a complete reformat.
  23.  
  24.  
  25. 2. OPERATION
  26.  
  27. BACKMW has four options, which are displayed in the main menu when
  28. the program is started. Those options are:
  29.  
  30. T - total hard disk backup
  31. I - incremental hard disk backup or restore
  32. C - configuration parameter editor
  33. Q - quit to CP/M
  34.  
  35.  
  36. Simply select one of the above choices. Note that you must do a total
  37. backup of your hard disk before you can do any incremental backups or
  38. restores.
  39.  
  40. 3. THE CONFIGURATION EDITOR
  41.  
  42. The editor is presented first, because your system may be different from
  43. the default and you should first configure BACKMW for your environment.
  44.  
  45. Selecting the C command first displays the current configuration parameters
  46. which default to my system environment:
  47.  
  48.     High hard drive       : E:
  49.     Floppy backup drive   : F:
  50.     CRC file drive        : F:
  51.     Number of CYLINDERS   : 306       (306/432 is the data for the
  52.     Number of SECTORS/CYL : 432        Morrow M16 system)
  53.  
  54.     CHANGE? (H,F,C,T,S,Q,?)
  55.  
  56. Simply type the appropriate letter to change an option (a "?" explains
  57. the option letters) or use "Q" to exit the editor. After exiting, you may
  58. optionally save BACKMW to a new file (you get to specify drive and file name).
  59.  
  60.  
  61. 4. TOTAL BACKUP
  62.  
  63. After selecting "T", you will be asked to input the size of your floppy
  64. disks in k bytes. Be sure to enter an accurate value and that all floppy
  65. disks you will be using during the backup process have AT LEAST that
  66. much room left! You will receive a caution message if you select a floppy
  67. size of less than 256k, but may go ahead with the operation anyway. Next,
  68. BACKMW will tell you how many diskettes you need to back up the complete
  69. hard disk. You should make sure you have enough floppies. While you can
  70. abort BACKMW at any prompt (and, therefore, also while backing up), it is
  71. not advisable to abort BACKMW in the middle of a backup operation, since
  72. you cannot continue where you left off at a later date - you would HAVE TO
  73. restart backup from scratch.
  74.  
  75. Next, you will be asked for an 8-character DISK ID, which can be almost
  76. anything, but you might want to make it the current date. This 8-character
  77. string will be used by BACKMW to construct the filename for the cylinder
  78. files and the CRC file. The name MUST be 8 characters exactly.
  79.  
  80. You will now be prompted to insert the first floppy diskette and backup
  81. will commence. During backup, the following information will be displayed
  82. for each cylinder:
  83.     - cylinder number
  84.     - sector being read (updated continuously while reading)
  85.     - CRC value for the current cylinder
  86.  
  87. After BACKMW has determined that no more cylinders will fit on the current
  88. floppy, you will be prompted to insert the next floppy and the cycle will
  89. continue until all cylinders have been backed up. At 432 sectors per
  90. cylinder, each cylinder takes approximately 30 seconds, so an M16 hard
  91. disk can be backed up in about 2 1/2 hours.
  92.  
  93. When BACKMW has finished the backup operation, it will prompt you to insert
  94. the floppy on which the CRC file should be written. IF THERE IS SUFFICIENT
  95. ROOM, you should write this file to the very first disk backed up. Otherwise,
  96. send it to a disk not used in the backup process. The CRC file contains
  97. 8 bytes for each cylinder, so in the case of an M16, you must have at least
  98. 4k to store the file! Do not write the CRC file to the hard disk, for
  99. obvious reasons!
  100.  
  101.  
  102. 5. INCREMENTAL BACKUP / RECOVERY
  103.  
  104. If you select "I" at the main menu, you will be asked whether you want a
  105. BACKUP or RECOVERY operation. Backup means FROM HARD DISK TO FLOPPY,
  106. and recovery means FROM FLOPPY TO HARD DISK. Any response other than "B"
  107. or "R" will return you to the main menu.
  108.  
  109. BACKMW will immediately ask you to insert the floppy which contains the
  110. CRC file, and it will read the CRC file into memory. Next, you will be asked
  111. for the starting cylinder number. This allows you to do partial backup/restore
  112. or continue a previously aborted incremental B/R. The operation you selected
  113. (B/R) will begin immediately. BACKMW CRC-checks each cylinder on the hard
  114. disk, displaying status information as it goes. If the CRC calculated in not
  115. the same as the value in the CRC file, BACKMW will attempt to open the
  116. appropriate cylinder file on the floppy and transfer the information in that
  117. file back onto the hard disk if RESTORE was selected, or it will update the
  118. cylinder file on the floppy disk if BACKUP was selected. If BACKMW cannot
  119. find the cylinder file, it will prompt you to insert the appropriate disk
  120. (by number) until it finds the file.
  121.  
  122. After finishing an incremental BACKUP, BACKMW writes the CRC file back
  123. onto the disk it read it from. No CRC file is written after a RESTORE
  124. operation.
  125.  
  126. CONTROL-C can be used to abort the incremental B/R operation at any time.
  127. When aborting a BACKUP, be sure to allow BACKMW to write the CRC file!!!
  128. BACKMW will want to write the CRC file after an aborted RESTORE too, but
  129. you may abort this before writing.
  130.  
  131.  
  132. 6. EXIT
  133.  
  134. BACKMW performs a warmboot when executing the Q command.
  135.  
  136.  
  137. 7. ERRORS
  138.  
  139. BACKMW will abort to the main menu any time a READ, WRITE, or OPEN error
  140. is encounteded. The filename which caused the error will be displayed.
  141.  
  142. Should an error be encountered during hard disk write, a BIOS ERR R/W message
  143. will be displayed and BACKMW will execute a warm boot.
  144.  
  145.  
  146. 8. MISCELLANEOUS
  147.  
  148. I have tested BACKMW on an M16 system. While testing, I inadvertently
  149. clobbered my directory on A: and I was able to use BACKMW to restore it,
  150. which proved to me that it worked. Even though I have used the program
  151. many times and it appears to work fine, please use it with caution.
  152. Be sure to do a conventional backup before using it for the
  153. first time. Ideally, the following should be done to test the program, but
  154. since I run a RCPM I don't have the time to do it:
  155.  
  156.     1. do total backup
  157.     2. run a whole disk checksum (like the TEST command in POWER)
  158.     3. clobber about 50% of the data on the drive
  159.     4. do an incremental restore
  160.     5. verify that whole disk checksum produces the same
  161.        result as in (2) above.
  162.  
  163. If you setect any bugs, failures, strangenesses, please let me know with an
  164. exact description of the problem. Verify that the problem is not random.
  165.  
  166.  
  167. 9. CREDITS
  168.  
  169. Thanks to frank Wancho for suggesting the incremental backup method
  170. Thanks to Rick Conn for SYSLIB
  171. Thanks to whoever uses it and reports success/failure
  172.  
  173.  
  174.  
  175.                         Dallas, TX, 06-24-84
  176.  
  177. ADDITIONAL NOTES: (this used to be BACKMW.NOT)
  178.  
  179. For more info read BACKMW.DOC
  180.  
  181. (updated 6/24/84)
  182.  
  183.  
  184. TOTAL hard disk backup should ideally be done only once, unless more
  185. than 40% of the hard disk has been changed. Since total foolproofing
  186. of BACKMW would have added to the complexity and size of the program,
  187. I have decided not to incorporate any BDOS error trapping. This means
  188. that you MUST be absolutely sure that when you do a total backup,
  189.  
  190. 1. All floppy disks you are about to use are EMPTY, freshly formatted
  191. 2. All floppies have the same capacity and you specify that capacity
  192.    when BACKMW2 asks for it
  193. 3. You never make any silly mistakes such as leaving the drive door
  194.    open, reversing the disk etc,
  195.  
  196. for if you do you will be forced to restart from scratch! On an M16
  197. system that means you have to spend another 2 1/2 hours, PLUS the time
  198. it takes to ERA *.* all diskettes again!
  199.  
  200.  
  201. Now, now... don't let those little problems keep you away from a
  202. free program...
  203.  
  204. VER 2.2:
  205.  
  206. A number of bug fixes in the incremental routine, which caused the system
  207. to hang, access the floppy at the wrong time and mess up the CRC file.
  208. A ^C abort feature was added to the incremental routines, where the CRC
  209. check of the current cylinder can be aborted at any time. When aborted,
  210. you will be asked to insert the CRC file diskette and the CRC file will
  211. be updated in accordance with your actions.
  212.  
  213.  
  214. VER 2.3:
  215.  
  216. V2.3 now runs on banked CP/M plus systems. BIOS calls are made through
  217. BDOS call 50 IAW the CP/M plus calling conventions.
  218.  
  219.  
  220. VER 2.5:
  221.  
  222. BACKMW version 2.5 no longer supports the buggy "manual" restore mode
  223. introduced in v2.4. When doing an incremental backup or restore, you
  224. are now asked for a starting cylinder number. This way you can interrupt
  225. your work at any point and continue later without CRC checking hundreds
  226. of already-processed cylinders.
  227. This version will not insist on writing the CRC file if you run a
  228. RESTORE to completion. Aborting an incremental function with ^C will
  229. still result in the CRC file prompt. BE SURE to write the CRC file
  230. after aborting an incremental BACKUP!
  231.