home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / thcdasd.zip / RESTDASD.TXT < prev    next >
Text File  |  1996-10-29  |  10KB  |  294 lines
  1. RESTDASD UTILITY
  2. ----------------
  3.  
  4. Version 1.00
  5.  
  6. (c) Steve Sharrad, August 1996.
  7. (c) The HENLEY College, August 1996.
  8.  
  9. It is suggested that you make this window full-screen,
  10. if it is not already, by double-clicking on the above title bar.
  11.  
  12.  
  13. All rights reserved.
  14.  
  15. This software is supplied without any warranty whatsoever and is used
  16. entirely at the users own risk. No claims for damages as a result of using
  17. this product will be accepted.
  18.  
  19. This product may be freely copied on the understanding of the above and on the
  20. basis that it is not modified or sold for profit, and that it is supplied with
  21. the readme text files (such as this document).
  22.  
  23. 1.      Introduction and Aim
  24. 2.      Features
  25. 3.      Syntax
  26. 4.      Notes
  27. 5.      Problems
  28. 6.      Restoration
  29.  
  30.  
  31. 1.      Introduction and Aim
  32. ----------------------------
  33.  
  34.  
  35. 386 HPFS provides the capability to limit the amount of disk space DASD resources take up.
  36. This is especially useful where a large number of users share a limited amount of space.
  37. However, as particular users demands change, you may find that you alter the limits associated
  38. with these resources occassionally.
  39.  
  40. If, however, you needed to restore your system from tape (if, for example, you had suffered
  41. a harddisk failure) then you would get all your data back, and probably all of your access control
  42. lists (ACLs, if you were using an OS/2 backup program which restored directory information, such
  43. as OS/2 Warp Server's Personally Safe'n'Sound, or Sytron's Sytos).
  44.  
  45. However, none of these programs, as yet, backup or restore the directory limit information.
  46. In some cases this is not important, but if you have a large number of users or limited diskpace
  47. (which may soon disappear before you can get all the limits back on at the right size) then this
  48. could be a problem.
  49.  
  50. BACKDASD solves this problem by backing up directory limit information for DASD resources.
  51. It backs up limit size, threshold value and delta, all into an editable text file. This
  52. information can then be restored at a later time by the reverse process, RESTDASD.
  53.  
  54. Not only does this help you to get your system back up and running in an emergency (because
  55. you won't have to worry about details such as DASD limits) but it also gives you the flexibility
  56. to allow you to have different directories having different DASD limits without you having to
  57. continually make a note of any changes.
  58.  
  59. It is assumed that you have read the BACKDASD help file before proceeding any further.
  60.  
  61.  
  62. 2.      Features
  63. ----------------
  64.  
  65.  
  66. RESTDASD has the following features:
  67.  
  68. a)      Identify
  69.  
  70. You can ask RESTDASD to identify a backup file and report details about it (i.e. date/time of
  71. backup, original backup path and server etc). You can make RESTDASD identify a file and then quit.
  72. RESTDASD defaults to displaying details about a file and what it proposes to do before doing
  73. anything; this however can be turned off.
  74.  
  75. b)      Remote restore
  76.  
  77. RESTDASD can back up directories or disks on remote servers. You don't have to have an
  78. administrator logged on (or to be logged on at all) to perform a local restore but you have 
  79. to be logged on for a remote server restore.
  80.  
  81. c)      Error Log
  82.  
  83. RESTDASD maintains a comprehensive log. It defaults to using the same file as BACKDASD. RESTDASD
  84. and BACKDASD error codes are similar and the same error codes from either mean the same or similar
  85. problem.
  86.  
  87. RESTDASD performs many error checks and these errors are displayed to screen and copied to the
  88. log file. You can, if you want, turn off error reporting (not recommended).
  89.  
  90. c)      Speed Optimization
  91.  
  92. You can specify to bring bring the limits for an entire directory tree (default), or just the
  93. root (non-recursive) or just down to one level.
  94.  
  95. If a backup file only contains upto one level down then RESTDASD will default to this and will
  96. reject any switches stating /R:1.
  97.  
  98. BACKDASD contains three backup engines which are used by BACKDASD as and when appropiate.
  99. For example, imaging your directory strutcure starts something like this:
  100.  
  101.  
  102. d)      Flexibility
  103.  
  104. You can tell RESTDASD not to restore a limit if an existing limit is already larger.
  105. You can also tell RESTDASD not to restore a limit if the resource is already larger than the limit.
  106.  
  107.  
  108. 3.      Syntax
  109. --------------
  110.  
  111. Go into the directory containing the RESTDASD utility. This will be the place you asked for
  112. during INSTALL.
  113.  
  114. Typing RESTDASD /? provides the following information:
  115.  
  116.  
  117. RESTDASD Version 1.00beta   Release 04/08/96 (c) Steve Sharrad
  118. Internet e-mail: ssha@henleycol.ac.uk
  119.  
  120. Restores DASD directory limits on 386-HPFS DASD-enabled volumes
  121. from backup files created using BACKDASD.
  122.  
  123. The syntax of this command is:
  124. RESTDASD /F:[filename] /P:[pathname] [/R:[value]] [/L:[filename]] [/S:\\[servern
  125. ame]] [[/E]] [[/A]] [[/V]] [[/L]] [[F]] [[/T]] [[/I]]
  126.  
  127. Required Parameters: /F:[filename]      Specify a filename to restore from
  128.                     Default extension is .DSD
  129. Optional Parameters: /P:[pathname]      Specify the pathname/tree to restore
  130.                     to. Defaults to value in backup file
  131.              /R:[value]         Specify 0 to turn off recursive restore
  132.                     Defaults to value in backup file (which
  133.                     may be 0, 1 or 2 (see help). You may
  134.                     also specify 2 even if the file con-
  135.                     tains all sub-directories
  136.              /L:[filename]      Specify a different errorlog filename
  137.                     Defaults to \DASD.LOG
  138.              /S:\\[server]      Specify a valid server on domain. If
  139.                     used, then pathname must be on server
  140.              /E                 Turns-off the error logging to file
  141.              /A                 Bypasses any stop for confirmation
  142.                     and does not display information
  143.              /V                 Displays information during process
  144.              /L                 Do not restore a DASD limit if any
  145.                     existing limit is larger
  146.              /F                 Do not restore a DASD limit if the
  147.                     resource would already not fit in limit
  148.              /T                 Write the operation time and backup
  149.                     count to error log upon completion
  150.              /I                 Identify the named backup file and
  151.                     report details, then quit.
  152.  
  153.  
  154. /F:[filename]
  155. -------------
  156.  
  157. Use this parameter to specify a file to restore from. If you don't specify an extension, then
  158. .DSD is assumed.
  159.  
  160. You should put a fully qualified pathname in front of the filename.
  161.  
  162.  
  163. The following parameters are optional.
  164.  
  165.  
  166. /P:[pathname]
  167. -------------
  168.  
  169. This defaults to the pathname held in the backup file, but you can specify an alternative
  170. destination. This could be a different drive or sub-directory.
  171.  
  172. If you want to restore to a tree which has a space character in the filename, then encapsulate the
  173. pathname in quotes, e.g.
  174.  
  175.         /P:"C:\USERS RULE"
  176.  
  177.  
  178.  
  179.  
  180. /R:[value]
  181. ----------
  182.  
  183. Use this switch to change the recursive mode. The modes are as follows:
  184.  
  185. 0               Restores the root or parent directory.
  186. 1 (default)     Restores all sub-directories, if the backup file contains all directories.
  187. 2               Restores sub-directories but only down to one level. Saves time on large disks.
  188.  
  189.  
  190. /L:[filename]
  191. -------------
  192.  
  193. Use this switch to specify an alternative location and name for the log file.
  194.  
  195.  
  196. /S:\\[servername]
  197. -----------------
  198.  
  199. Defaults to local workstation.
  200.  
  201. Use this switch to specify the servername to restore to. This can be any running server on the same
  202. domain (specifying the local workstation name does not fool RESTDASD and makes no difference).
  203.  
  204. Note that if you use this switch then the pathname pointed to by /P: must be a real pathname
  205. on the specified server. You cannot restore re-directed resources directly; you must use the /S:\\
  206. switch.
  207.  
  208.  
  209. /E
  210. --
  211.  
  212. Stops any entries being written to the error log.
  213.  
  214. /A
  215. --
  216.  
  217. Stops RESTDASD displaying information on what it is about to do and asking for confirmation 
  218. before it actually does it.
  219.  
  220.  
  221. /V
  222. --
  223.  
  224. Make RESTDASD report verbosely during the restore.
  225.  
  226.  
  227. /L
  228. --
  229.  
  230. Won't restore a limit to a resource if any existing limit is already larger.
  231.  
  232.  
  233. /F
  234. --
  235.  
  236. Won't restore a limit to a resource if the resource is already too large for the limit.
  237.  
  238.  
  239. /T
  240. --
  241.  
  242. Make RESTDASD make entry into error log upon successfull completion of task.
  243.  
  244.  
  245. /I
  246. --
  247.  
  248. Identify the named backup file, report details and then quit.
  249.  
  250.  
  251.  
  252. 4.      Notes
  253. -------------
  254.  
  255. Drives must be enabled for DASD limits before any limits can be applied. 
  256.  
  257. This is dones by using NET DASD [drivename] /ENABLE.
  258.  
  259. You must enable a drive for DASD limits before attempting to restore limits otherwise RESTDASD
  260. will report an error.
  261.  
  262. You must be logged on as an administrator to restore to a remote server.
  263.  
  264.  
  265. 5.      Problems
  266. ----------------
  267.  
  268.  
  269. There are no known problems with the software. However, if you do come across a problem, please
  270. make a note of the following after trying again:
  271.  
  272. - The version of RESTDASD you are using
  273. - The version of BACKDASD you used to create the file
  274. - The command line options you gave to RESTDASD
  275. - The configuration of your computer
  276. - Any error numbers or exitcodes
  277. - RESTDASD contains an in-built freak error handler. This will provide a few lines of debug
  278.   information which you should also record
  279.  
  280.  
  281. Send details via e-mail to ssha@henleycol.ac.uk. If possible, send also a copy of the DASD
  282. error log and the backup file and a listing of your directory structure.
  283. No fixes garunteed!
  284.  
  285. 6.      Restoration
  286. -------------------
  287.  
  288.  
  289. If you regularly back up your system, make sure that it backs up the DASD backup files, and if
  290. possible, the BACKDASD/RESTDASD files (they are stored in the OS/2 sub-directory of your system)
  291. and also the file LSRXUT.DLL in the \IBMLAN\NETLIB directory. Otherwise, you will have to re-run
  292. INSTALL and LSRXINST and your backup DSD files will be lost.
  293.  
  294.