home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / sysutils / wpsback / readme.doc next >
Encoding:
Text File  |  1994-01-06  |  8.0 KB  |  259 lines
  1.  
  2.  
  3.                 DOCUMENTATION FOR WPS BACKUP
  4.                 ----------------------------
  5.  
  6.    INTRODUCTION
  7.    ------------
  8.    Although OS/2 is a wonderful operating system, it is far from
  9.    perfect, and it is not as crash-proof as some would have us
  10.    believe. In addition, many activities (for example, installing
  11.    drivers for new devices or even simply changing screen drivers)
  12.    are fraught. Many users, including myself have had to go through
  13.    the process of reinstalling OS/2, as a result of something going
  14.    wrong when changing screen drivers. Re-installation itself is
  15.    relatively painless (if you are doing it from a supported CD-ROM).
  16.    However the pain of losing all your weeks and months of
  17.    customisation of the OS/2 Desktop and Work Place Shell (WPS) is
  18.    much more significant.
  19.  
  20.  
  21.    What this package does is to provide a very simple way of backing
  22.    up and restoring your OS/2 Desktop and WPS settings. The executables
  23.    can be run either with command line parameters (each of them only
  24.    takes 2 parameters) or in an interactive mode. Both of the
  25.    executables are run from an OS/2 command prompt.
  26.  
  27.  
  28.    NOTE: This program will only work with OS/2 v2.1 and later versions.
  29.    It will NOT work with OS/2 2.0.
  30.  
  31.  
  32.    INSTALLATION
  33.    ------------
  34.    The package consists of the following files;
  35.  
  36.       1. WPS-BACK.EXE   - executable to back up the WPS and Desktop
  37.       2. WPS-REST.EXE   - executable to restore the back up
  38.       3. README.DOC     - this file
  39.  
  40.    There is no special produre for installation. Just copy the files
  41.    WPS-BACK.EXE and WPS-REST.EXE into a directory which is in your
  42.    OS/2 program path.
  43.  
  44.  
  45.    --------------
  46.    | BACKING UP |
  47.    --------------
  48.  
  49.    The back up is processed by running WPS-BACK.EXE.
  50.  
  51.    The best method of performing the back up is to run WPS-BACK.EXE
  52.    when the WPS is not active. There are 2 ways of achieving this.
  53.  
  54.    Either;
  55.  
  56.    1. Booting from an OS/2 boot floppy (this is tedious and time
  57.       consuming),
  58.  
  59.    or
  60.  
  61.    2. Adding the line "CALL=C:\OS2\CMD.EXE" as the LAST line in your
  62.       CONFIG.SYS file. This opens up a full screen OS/2 session upon
  63.       boot up. From there you can run WPS-BACK.EXE and also perform
  64.       any other maintainance duties before typing "EXIT", which will
  65.       then cause the boot up into the WPS to be completed.
  66.  
  67.       This is the easiest method, and is advisable, even if you are not
  68.       using this package at all.
  69.  
  70.     However, you can still run WPS-BACK.EXE (but not WPS-REST.EXE) from
  71.     your OS/2 Desktop, by creating a WPS program object for it.
  72.  
  73.     WPS-BACK.EXE takes 2 parameters;
  74.  
  75.     1. Your OS/2 boot drive
  76.     2. The floppy disk drive that you want to back up to.
  77.  
  78.  
  79.     Thus the syntax is;
  80.  
  81.            WPS-BACK <os2 drive> <destination drive>
  82.  
  83.  
  84.     Examples;
  85.  
  86.            WPS-BACK D: A:        (backs up from drive D: to drive A:)
  87.            WPS-BACK C: A:        (backs up from drive C: to drive A:)
  88.  
  89.  
  90.     That is it!
  91.  
  92.     If you run WPS-BACK without any parameter (or with less than 2
  93.     parameters) the program goes into an interactive mode, and asks
  94.     you for your OS/2 boot drive, and the target drive. You can stop
  95.     at these stages, by just pressing ENTER.
  96.  
  97.  
  98.     For safety's sake, you are given 1 chance to stop the back up
  99.     process, by pressing CTRL-Break. WPS-BACK then does some checking,
  100.     and finally starts the backing up.
  101.  
  102.     When the back up has started (if you run it from the Desktop) you
  103.     can start to do other things, and it will run in the background.
  104.  
  105.     WHAT IS BACKED UP?
  106.     ------------------
  107.     The following are backed up;
  108.  
  109.       1. The \Desktop directory on the OS/2 boot drive
  110.       2. OS2.INI
  111.       3. OS2SYS.INI
  112.       4. CONFIG.SYS
  113.       5. AUTOEXEC.BAT   (if it exists)
  114.       6. STARTUP.CMD    (if it exists)
  115.  
  116.  
  117.      If you have Win-OS/2 installed, you will have to back up your
  118.      Win-OS/2 INI files manually.
  119.  
  120.  
  121.    -------------
  122.    | RESTORING |
  123.    -------------
  124.  
  125.    The restoration of a backup that has been carried out with
  126.    WPS-BACK is processed by running WPS-REST.EXE.
  127.  
  128.  
  129.    NOTES:
  130.    -----
  131.    1. WPS-REST.EXE must be run after booting from an OS/2 boot floppy.
  132.       Please note this point. Do NOT attempt to run WPS-REST.EXE when
  133.       the WPS is active. I cannot guarantee what will happen if anyone
  134.       tried this.
  135.  
  136.    2. It is advised that you run CHKDSK on your OS/2 boot drive before
  137.       running WPS-REST.EXE. This will give CHKDSK the opportunity to
  138.       correct any disk errors, and will increase the chance of a
  139.       successful restore.
  140.  
  141.    3. You should make copies of your current CONFIG.SYS, OS2.INI and
  142.       OS2SYS.INI files, before running WPS-REST.EXE.
  143.       This will allow you to restore your old setup in case you wish
  144.       to do so.
  145.  
  146.  
  147.    Like WPS-BACK.EXE, WPS-REST.EXE is run with 2 parameters;
  148.  
  149.     1. Your OS/2 boot drive
  150.     2. The floppy disk drive that you want to back up to.
  151.  
  152.  
  153.     Thus the syntax is;
  154.  
  155.            WPS-REST <backup drive> <os2 boot drive>
  156.  
  157.  
  158.     Examples;
  159.  
  160.            WPS-REST A: D:        (restores from drive A: to drive D:)
  161.            WPS-REST A: C:        (restores from drive A: to drive C:)
  162.  
  163.    That is it! (hopefully).
  164.  
  165.  
  166.    If WPS-REST.EXE is run without any parameters, it goes into an
  167.    interactive mode.
  168.  
  169.  
  170.    When the restore process begins, it first of all renames your
  171.    \DESKTOP directory to \OLDDESK1. If \OLDDESK1 already exists on
  172.    your OS/2 boot drive, the the \DESKTOP directory will be renamed
  173.    to \OLDDESK2. This is just a precaution in case you wish to go back
  174.    to what you had before.
  175.  
  176.    If both \OLDDESK1 and \OLDDESK2 exist on your OS/2 boot drive, then
  177.    WPS-REST.EXE will stop. You will then have to remove one of them
  178.    yourself.
  179.  
  180.  
  181.    After the \DESKTOP directory has been renamed, the restore process
  182.    begins in earnest.
  183.  
  184.  
  185.     WHAT IS RESTORED?
  186.     ------------------
  187.     The following are restored;
  188.  
  189.       1. The \Desktop directory on the OS/2 boot drive
  190.       2. OS2.INI
  191.       3. OS2SYS.INI
  192.       4. CONFIG.SYS
  193.       5. AUTOEXEC.BAT   (if it exists)
  194.       6. STARTUP.CMD    (if it exists)
  195.  
  196.  
  197.    After all this, your old WPS and Desktop settings will hopefully
  198.    have been restored. You can then reboot, and watch.
  199.  
  200.    That's all folks!
  201.  
  202.  
  203.    LICENSE
  204.    -------
  205.  
  206.    This package is supplied as FREEWARE. You can do with it as you
  207.    please, as long as nothing in it is modified, and this documentation
  208.    is supplied with it.
  209.  
  210.  
  211.    FEEDBACK
  212.    --------
  213.    I am interested to know how well this package works for you. If it
  214.    saves your life, you can buy me some palm wine :-)  If it kills you,
  215.    then I have gone to Timbuktu, and will not be back for a while.
  216.  
  217.  
  218.    COMPILER
  219.    --------
  220.    For all who are interested, the programs in this package are 16-bit
  221.    character mode OS/2 executables, and were developed with Borland
  222.    Pascal 7.0, and the OS/2 patch for it produced by c't magazine.
  223.  
  224.  
  225.  
  226.    DISCLAIMER
  227.    ----------
  228.    These programs were written for my own use, and they work well for
  229.    me. They have been thoroughly tested in simulated conditions, and
  230.    have been used to restore my Desktop and WPS in real situations
  231.    twice. However, your mileage may vary and I cannot guarantee
  232.    anything. Hence, the following disclaimer.
  233.  
  234.    THE PROGRAMS WPS-BACK.EXE AND WPS-REST.EXE ARE SUPPLIED "AS IS", AND
  235.    WITHOUT ANY GUARANTEES WHATSOEVER. I ACCEPT NO RESPONSIBILITY FOR
  236.    ANY LOSS OR DAMAGE, WHETHER DIRECT OR INDIRECT, PHYSICAL, FINANCIAL,
  237.    EMOTIONAL, MARITAL, MENTAL, SOCIAL, OR OTHERWISE, THAT MAY RESULT
  238.    FROM THE USE, OR THE PURPORTED USE OF ANY PROGRAM IN THIS PACKAGE
  239.    FOR ANY REASON WHATSOEVER.
  240.  
  241.    IF THESE TERMS ARE NOT ACCEPTABLE TO YOU, THEN YOU HAVE NO LICENSE
  242.    TO USE THIS PACKAGE AT ALL, AND YOU SHOULD DELETE THE PROGRAMS FROM
  243.    YOUR DISKS IMMEDIATELY.
  244.  
  245.  
  246. -------------------------------------------
  247.   (c)1993,
  248.   Dr. A. Olowofoyeku,
  249.   Keele University
  250.   England.
  251.  
  252.   e-mail:   laa12@seq1.keele.ac.uk
  253. --------------------------------------------
  254.  
  255.  
  256.  
  257.  
  258.  
  259.