home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 27 Fixes20 / 27-Fixes20.zip / wfdesk.zip / install.doc next >
Text File  |  1994-07-27  |  10KB  |  210 lines
  1. ===============================================================================
  2.      IBM* WorkFrame/2* INSTALL.DOC file:
  3.      This file provides instructions on how to handle WorkFrame/2
  4.      installation errors.
  5.  
  6.      IBM WorkFrame/2 Version 2.x
  7.      (C) Copyright IBM Corp., 1991,1993,1994 All Rights Reserved
  8.      US Government Users Restricted Rights - Use, duplication or disclosure
  9.      restricted by GSA ADP Schedule Contract with IBM Corp.
  10. ===============================================================================
  11.  
  12.  
  13.  
  14. CONTENTS
  15. ________
  16.  
  17.         1. Installation Errors
  18.         2. Using WFDESK.CMD
  19.  
  20.  
  21.  
  22. 1. INSTALLATION ERRORS
  23. ______________________
  24.  
  25.           Just before phase 1 installation ends, or during phase 2, you may
  26.           get errors about initialization files that could not be modified,
  27.           objects that could not be created, or the install ceases and the
  28.           status window shows no activity for a very long period of time.
  29.  
  30.            NOTE: Before you reboot between phase 1 and phase 2 of the install,
  31.                  it is important to minimize the number of programs that are
  32.                  running after the machine is rebooted.  Phase 2 will have a
  33.                  better chance of succeeding if other programs (such as an
  34.                  anti-virus scanning program) are not running during the
  35.                  install.
  36.  
  37.    Phase 1 Errors
  38.    --------------
  39.           If you experience an error before the end of phase 1, indicating
  40.           that initialization files could not be updated or that the phase 2
  41.           startup object could not be created, use the WFDESK.CMD command
  42.           file to start phase 2.  Follow the instructions under the "Usage"
  43.           section in "2. Using WFDESK.CMD" below.  Skip steps 2-5 and start 
  44.           from step 6.
  45.  
  46.  
  47.   Phase 2 Errors
  48.   --------------
  49.           If you experience an error in phase 2, wait for all disk activity to
  50.           end and then select the Retry push button on the message box.
  51.  
  52.           If after selecting Retry twice, the installation continues to fail,
  53.           you may be encountering a known bug in the OS/2* WorkPlace Shell* 
  54.           (WPS).  Select the Cancel pushbutton to abort the installation, then
  55.           try the following to correct the problem:
  56.  
  57.           1. First, invoke WFSETUP.EXE from the OS/2 command line.
  58.           2. From the "Options" pulldown, select "Selective setup".
  59.           3. In the "Source path" entry field, enter the path where
  60.              the WorkFrame/2 files are installed.
  61.           4. Deselect the "Copy files" and "Update CONFIG.SYS" checkboxes.
  62.           5. Ensure that the "Update Desktop" checkbox is selected,
  63.              then press "OK".
  64.           6. Close down the WFSETUP program, then shutdown your system.  When
  65.              you reboot, phase 2 of the Setup program should start.
  66.  
  67.           If you still experience failures, try opening the WorkFrame/2 folders
  68.           as they are being created (for example, the WorkFrame/2 main folder
  69.           and the Actions Profiles folder), as this seems to help the
  70.           installation procedure somewhat.
  71.  
  72.           There is an alternate phase 2 install command file you can use if you
  73.           still have problems getting WorkFrame/2 installed.  For instructions
  74.           on how to run this command file, please read the following information
  75.           in "2. USING WFDESK.CMD".
  76.  
  77.  
  78.  
  79. 2. USING WFDESK.CMD
  80. ___________________
  81.  
  82.     The WFDESK.CMD command file was developed as a work-around to an OS/2
  83.     problem that occurs when creating Workplace Shell objects.  During
  84.     the WorkFrame/2 phase 2 installation, many WPS objects are created and
  85.     sometimes failures occur on very slow machines.
  86.  
  87.     Description of the problem:
  88.     --------------------------
  89.  
  90.     When WPS receives a request for a WPS object to be created, it immediately
  91.     indicates that the object has been created, but actually passes the request
  92.     onto another thread.  Using this object before it has been fully 
  93.     instantiated will cause errors during WorkFrame/2 phase 2 installation.  
  94.     To date, there is no known method to determine whether or not the object 
  95.     has been fully instantiated before updating it.  The problem is 
  96.     particularly noticeable on slow machines with lots of disk activity.  
  97.     To alleviate the problem, WFDESK.CMD adds an optional timing delay before 
  98.     each object is updated to make sure that it has been fully created.
  99.  
  100.     Usage:
  101.     -----
  102.  
  103.     Before using WFDESK.CMD, it is recommended that you completely remove all
  104.     WorkFrame/2 objects and reboot your system.  To remove WorkFrame/2 objects
  105.     (this procedure is also described in the READ.ME file shipped with the
  106.     product):
  107.  
  108.       1) Create a new Desktop folder - Open the Templates folder and create
  109.          a folder object on the Desktop (drag and drop); open the new folder.
  110.  
  111.       2) WorkFrame/2 templates - Move all WorkFrame/2 templates to the new
  112.          Desktop folder (Action Log, Actions Probile, WorkFrame/2 Composite
  113.          Project, WorkFrame/2 Project).
  114.  
  115.       3) WorkFrame/2 folder - Move the WorkFrame/2 folder to the new Desktop
  116.          folder.
  117.  
  118.       4) Delete the new Desktop folder.  (If this does not delete all the
  119.          objects, delete the actual object file from the command line.  The
  120.          file should be under the Desktop subdirectory on your boot drive and
  121.          the file name should be similar to the name of the Desktop object).
  122.          Refresh the Desktop. Ignore any warnings indicating that an object 
  123.          could not be deleted.)
  124.  
  125.       5) Reboot.
  126.  
  127.     Now you are ready to attempt WFDESK.CMD to complete WorkFrame/2 phase 2
  128.     installation:
  129.  
  130.       6) Copy both WFDESK.CMD and WFSETOPT.EXE to your WorkFrame/2 installation
  131.          directory created during phase 1 (e.g., C:\IBMWF).
  132.  
  133.       7) Stop all unnecessary programs - this is VERY important, particularly
  134.          on slow machines.
  135.  
  136.       8) Invoke WFDESK.CMD only from the directory where WorkFrame/2 is
  137.          installed, as follows (otherwise it will not work correctly):
  138.  
  139.           WFDESK.CMD boot_drive wf2_directory [pause_time]
  140.  
  141.              where:
  142.                 boot_drive    = drive where OS/2 is installed (e.g., C:).
  143.                 wf2_directory = full path name where WorkFrame/2 is
  144.                                 installed (e.g., C:\IBMWF).
  145.                 pause_time    = number of seconds to pause between system
  146.                                 commands (e.g., 5).
  147.  
  148.           For example, if OS/2 is installed on drive C: and WorkFrame/2 is
  149.           installed on D:\IBMWF and you want a pause time of 7 seconds:
  150.  
  151.                WFDESK.CMD C: D:\IBMWF 7
  152.  
  153.  
  154.     Important Notes:
  155.     ---------------
  156.  
  157.     - The pause time is the period of time that the command file will pause
  158.       between creating an object and setting its data.  A longer pause time
  159.       increases the chances of a successful installation.
  160.  
  161.       On very slow machines, a pause time of up to 15 seconds may be required
  162.       (5 to 10 seconds will usually work on most machines).  The default pause
  163.       time is zero seconds; this will usually work on most 486 machines.
  164.  
  165.     - There are two types of errors that could possibly come up: fatal and
  166.       non-fatal errors.
  167.  
  168.     - A fatal error will cause WFDESK.CMD to terminate.  In this instance,
  169.       you should delete any objects already created (as above) and rerun
  170.       WFDESK.CMD.  Ensure no unnecessary programs are running and increase
  171.       your pause time.
  172.  
  173.            If you receive a fatal error while WFDESK.CMD is attempting to write
  174.            to the IBMWFV2.INI file, you must reinstall WorkFrame/2 again 
  175.            starting from phase 1.  IBMWFV2.INI is created during phase 1 
  176.            installation, but is sometimes removed if a failure occurs during 
  177.            phase 2.  To rerun phase 1 so that phase 2 is not run automatically 
  178.            after a reboot, do the following:
  179.  
  180.              a) Remove any existing WorkFrame/2 objects as described above.
  181.              b) Install WorkFrame/2 using WFSETUP.EXE from your installation 
  182.                 medium (CD ROM, diskette, or LAN) and let phase 1 complete,
  183.                 but do NOT reboot.
  184.              c) Delete the "Invoke WF/2 Install Phase 2" object in the
  185.                 OS/2 System - Startup folder.
  186.              d) Reboot.
  187.              e) Invoke WFDESK.CMD as described above (WorkFrame/2 phase2
  188.                 installation).
  189.  
  190.      - A non-fatal error will NOT cause WFDESK.CMD to terminate; WFDESK.CMD
  191.        will continue to run, but report an error.  Two types of non-fatal
  192.        errors are reported:
  193.  
  194.           a) Deregistration of object classes - The classes may not have been
  195.              registered and thus do not need to be deregistered.  You may ignore
  196.              this error.
  197.  
  198.           b) Writing action option settings to the sample projects - The
  199.              invocation of WFSETOPT.EXE may fail while trying to write action
  200.              option settings to the sample base projects.  This error means
  201.              that the sample projects have been created, but their options
  202.              could not be set.  In this case, they will use the default options
  203.              settings for their actions.
  204.  
  205.  
  206.  
  207. * IBM, WorkFrame/2, WorkPlace Shell, and OS/2 are registered trademarks of the
  208.   IBM Corporation.
  209.  
  210.