home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / backres.zip / README.PSS < prev    next >
Text File  |  1999-03-15  |  12KB  |  272 lines
  1. OS/2 Warp Server Backup/Restore V6.01.0  15 March 1999
  2. ------------------------------------------------------
  3.  
  4. This readme file contains the following information:
  5.  
  6. 1) Installation notes
  7.  
  8. 2) Code defects (APARs) fixed since the release of V6.00.
  9.  
  10. 3) Uninstallation instructions
  11.    
  12.    3.1) Uninstalling through the Graphical User Interface
  13.  
  14.    3.2) Performing an Unattended Uninstall
  15.  
  16. 4) A list of known restrictions and problems
  17.  
  18. 5) Performance recommendations
  19.  
  20. 6) Logging
  21.  
  22. 7) Use of the Command Line Interface
  23.  
  24. 8) Dynamic allocation of drive letters for partitioned 
  25. removable hard disk devices:  How this effects PSnS
  26. operation
  27.  
  28. **************************************************
  29.  
  30. 1) Installation notes:
  31. -------------------
  32. Whenever you install a new version of OS/2 Warp Server Backup/Restore
  33. you should recreate your disaster recovery diskettes.  If you do not you may
  34. find that you cannot perform a disaster recovery from backups that you have
  35. taken with the new release. The current version allows the program files to 
  36. span on to multiple diskettes if necessary.   This means that you may have to
  37. provide more than three diskettes when creating disaster recovery diskettes.       
  38.  
  39. Please refer to the Backup/Restore web site for up to date answers to common 
  40. questions and advice on how to implement your backup strategy.
  41.  
  42. http://www.software.ibm.com/os/warp/library/backfaq/index.html
  43.  
  44. 2) Code defects (APARs) fixed since release of V6.00
  45. ------------------------------------------
  46.  
  47. This is a chronological list with the most recently fixed problems at the bottom.
  48.  
  49. IC20835  Client C program occasionally quits when calling PSnS API Server
  50. IC20930  Files stored in ADSM lost if there is an identical path on a different drive
  51. IC20884  SYS3175 or panic 005 entering user exit after backup or restore
  52. IC21277  Apparent "out of memory" error  in API client program when running 
  53.             backup method with statistics call-back function.
  54. IC21594  GO disaster recovery program fails with a SYS2070 - failure to load 
  55.             the PSNSVM.DLL
  56. IC22044 Failure to decompress a particular file
  57. IC22556 Failure to return correct error code through the REXX API when no backup
  58.     volume present
  59.  
  60. 3) Uninstallation instructions
  61. ---------------------------
  62. Uninstalling device support will mean that you will not be able to restore data
  63. backed up to that device.
  64.  
  65. Uninstalling both the C API component and the Graphical user interface will 
  66. mean that you cannot run OS/2 Warp Server Backup/Restore.  It will also result 
  67. in all of your backup sets being deleted.
  68.  
  69.  
  70.    3.1 Uninstalling through the Graphical User Interface
  71.    ------------------------------------------------------
  72.  
  73.    Double click on the "Uninstall Backup/Restore" icon in the OS/2 Warp Server
  74.    Backup/Restore folder.  This will take you through the uninstallation 
  75.    program.  You may uninstall one or more components of the program.  If you 
  76.    uninstall all the components OS/2 Warp Server Backup/Restore will be
  77.    completely removed from your system.
  78.  
  79.  
  80.    3.2 Performing an Unattended Uninstall
  81.    --------------------------------------
  82.  
  83.    To uninstall OS/2 Warp Server Backup/Restore enter the following
  84.    single-line command at an OS/2 command prompt:
  85.  
  86.    clifi /a:u /f:"<WP_INSTALLED>" /o:INV_PSNS /set:Selection=ALL
  87.  
  88.    This will completely remove OS/2 Warp Server Backup/Restore from your 
  89.    system.
  90.  
  91.  
  92. 4) Known Restrictions and problems
  93. ----------------------------------
  94.  
  95. - The OS/2 Warp Server Backup/Restore 'disaster recovery guide' gives 
  96.   instructions for building disaster recovery diskettes which enable you to 
  97.   boot your system and restore data in the event of a hard disk crash.  The   
  98.   instructions advise you to use the OS/2 MAKEDISK utility to modify the system  
  99.   for use with HPFS386 partitions.   You may find that MAKEDISK fails because  
  100.   there is  insufficient space on the diskette for all the required files.  
  101.  
  102.   If this is the case you should ignore the instruction to run MAKEDISK.  You 
  103.   will still be able to disaster recover data to a 386HPFS partition provided 
  104.   you have reformatted the partition first.  (If you do not reformat the  
  105.   partition some files and directories may contain embedded access control 
  106.   permissions that cannot be overwritten during the restore.  The restore will  
  107.   fail.)
  108.    
  109.   Note: You will still be able to restore the access control permissions by   
  110.   restoring the NET.ACC file in the normal way once you have rebooted your 
  111.   machine.
  112.  
  113. - BACKACC, the utility invoked by Backup/Restore to backup the NET.ACC 
  114.   file, scans all attached drives.  If you have a removable media drives attached 
  115.   which does not have a cartridge inserted, BACKACC will issue a warning that  
  116.   the drive is not ready.  The backup will be halted until you have pressed 'Return
  117.   error to program'.  This can be avoided by leaving a cartridge in the drive when
  118.   the backup runs.
  119.  
  120. - If you may want to restore from a dual device backup set in disaster recovery 
  121.   mode (having booted from diskette) you are advised to work in the following way:
  122.   Do NOT transfer out the backup set to the base device.  During disaster recovery
  123.   you will typically want to restore from the base device only to restore a 
  124.   bootable system. If you have transferred out the backup set to the base device
  125.   PSnS will try to restore both the base image and the increments.  Although this
  126.   works fine it depends on you having BOTH the base and incremental devices
  127.   accessible and working while you are recovering.  It is less risky to assume 
  128.   that only one device (the base) will be operational in this situation.  Having
  129.   recovered your system from the base device and rebooted the machine you can 
  130.   restore the increments in the normal way through the graphical interface.
  131.   (Just transfer in the backup set from the incremental device and create a restore 
  132.   method that restored all the files from it. When you run the restore method opt
  133.   to restore only files from the incremental device since you will have already 
  134.   restored all the base files.)
  135.  
  136. - When transferring in a dual device backup set you will be asked to confirm the
  137.   names and settings for the two  storage devices that you want to use for 
  138.   the backup set. This is because you may be transferring in on a target machine
  139.   that does not have exactly the same set of devices attached as there were on 
  140.   the original machine.  For example, your ZIP drive may appear as a different
  141.   drive letter.  Backup/Restore will prompt you to choose from the list of
  142.   possible devices attached to your system.   
  143.  
  144. - C API backup methods do not function properly if the backup device on the 
  145.   target Backup/Restore server requires a new volume to be inserted.
  146.  
  147. - If you backup files from a FAT partition and view them using the 'View backed
  148.   up data' option, you will notice that the file creation date is set to zero.  This
  149.   is because the FAT file system does not store the creation date of a file.   
  150.  
  151. - The date format on the "Prompt for Version" panel during restore is the
  152.   traditional English Day/Month/Year.  The panel does not adapt to your
  153.   OS/2 date preferences.
  154.  
  155.  
  156. 5) Performance recommendations
  157. -------------------------------
  158.  
  159. 1) You are advised to install OS/2 Warp Server Backup/Restore on an HPFS or JFS 
  160. drive.
  161.  
  162. 2) You are advised not to create backup sets on FAT drives.   
  163.  
  164.  
  165. 6) Logging
  166. ----------
  167.  
  168. If you experience a problem when running this code, you can turn
  169. problem logging on. Here is how you do this...
  170.  
  171. 1) Open an OS/2 window, making sure that Backup/Restore is not running
  172.  
  173. 2) Change directory into the directory where Backup/Restore is installed, e.g.:
  174.  
  175.    cd PSNS
  176.  
  177.    ...if you installed Backup/Restore in a directory called 'PSNS'.
  178.  
  179. 3) Type the following command:
  180.  
  181.    SET PSNSDEBUG=4
  182.  
  183. 4) Then type:
  184.  
  185.    PSNS
  186.  
  187.    ...to run the program with problem-logging enabled.
  188.    This will produce a log file called 'psns.log', which is found in the
  189.    current directory. This file can be used by IBM to help
  190.    determine the cause of the problem.
  191.  
  192. Alternatively, include the statement 'PSNSDEBUG=4' in your config.sys file.
  193. After doing this and re-booting, a log will be produced whenever you run Backup/Restore.
  194. This means that you don't have to go through the steps detailed above.
  195.  
  196. This log file may become very large. 
  197.  
  198.  
  199. 7) Use of the command line Interface (CLI)
  200. ------------------------------------------
  201.  
  202. To view on-line help for the CLI type:
  203.  
  204. psnscl help 
  205.  
  206. This gives you a full list of the key words, such as 'backupmethod', that
  207. can be used in your native language. To get detailed help on a given 
  208. key word, type the following:
  209.  
  210. psnscl help KEYWORD
  211. (Replace KEYWORD with the key word for which you need help.  To get help
  212. on the backupmethod key word you would type: 'psnscl help backupmethod'.)
  213.  
  214. This will show you which verbs apply to the key word.  You can then 
  215. request more detail on these by typing the following type of command in your 
  216. native language:
  217.  
  218. psnscl help KEYWORD VERB
  219. (Replace VERB with the verb for which you need help.  To get help on 
  220. creating backup methods you would type 'psnscl help backupmethod create'.) 
  221.  
  222. Help for all keywords and verbs is available in this way.
  223.  
  224. Dynamic allocation of drive letters for Partitioned Removable Media (PRM):
  225. -------------------------------------------------------------------------
  226. How this effects PSnS operation
  227. -------------------------------
  228.  
  229. Warp Server for e-business does not allocate a drive letter to PRM until
  230. a cartridge is inserted.  This has some consequences for PSnS of which you
  231. should be aware.
  232.  
  233. a) How to create a new removable hard disk storage device:
  234.  
  235. PSnS normally creates default storage devices on each of the devices that you 
  236. have attached.  This may not happen for Partitioned Removable Media because 
  237. the operating system only detects these devices and assigns a drive letter to 
  238. them if the device contains a cartridge.  If PSnS has not created a storage 
  239. device on your removable hard disk you need to do the following:
  240.  
  241. 1) Insert a cartridge in the removable hard disk device  
  242. 2) Start PSnS and open the source drives container.  Use the 'refresh' context 
  243. option to refresh the set of available source drives. You should see a removable 
  244. hard disk icon appear in the container.
  245. 3) Open the PSnS storage devices container.  Use the 'refresh' context option to 
  246. refresh the set of available storage devices.  You should see a removable hard 
  247. disk icon appear in this container also.
  248.  
  249. You should now find that PSnS has also created a default backup set on the new 
  250. storage device and you are ready to run backups to this.
  251.  
  252. (These same actions can be taken using the API.) 
  253.  
  254. b) You should try to ensure that a removable hard disk device used by PSnS as 
  255. a backup device is always assigned the same drive letter whenever a cartridge
  256. is inserted.  You may use the Logical Volume Manager (LVM) to assign the same
  257. preferred drive letter for each of the cartridges that you want to use, but 
  258. this does not guarantee that the device will always be allocated this letter.  
  259. In particular your CD-ROM drive may take the chosen drive letter if you boot
  260. without a removable cartridge installed.  One way that you can control this
  261. situation is to include the following statement in your config.sys file:
  262.  
  263. ReserveDriveLetter=x
  264.  
  265. This will ensure that the CD-ROM drive will not take any drive letter lower or
  266. equal to x (for example, x could be the drive letter you want your removable
  267. media device to take.)
  268.  
  269. See the section 'Partitioned Removable Media Considerations' in the book 'Quick
  270. Beginnings' (a3aa1mst.inf) for more information about the Logical Volume Manager
  271. and Partitioned Removable Media.
  272.