home *** CD-ROM | disk | FTP | other *** search
/ Delphi Anthology / aDELPHI.iso / Workshop / disk1install.txt
Text File  |  1999-01-12  |  11KB  |  292 lines
  1.  
  2.                            INSTALL.TXT
  3.                            ===========
  4.  
  5. SEARCH INSTRUCTIONS:  To go directly to a specific section,
  6. search for "SECTION -#-" replacing the # with the appropriate
  7. section number.
  8.  
  9.  
  10.                         TABLE OF CONTENTS
  11.  
  12. SECTION 0       System Requirements
  13.  
  14. SECTION 1       Booting Clean
  15.                 A)  Making a Boot Disk
  16.                 B)  Contents of CONFIG.SYS
  17.                 C)  Contents of AUTOEXEC.BAT
  18.                 D)  Changes to WIN.INI and SYSTEM.INI
  19.  
  20. SECTION 2       Installation Notes
  21.                 A)  Boot Clean
  22.                 B)  Network Installation
  23.                 C)  Installing Under Windows NT or OS/2
  24.                 D)  Installing Under OS/2
  25.                 E)  Installing Under Windows NT
  26.                 F)  Avoid Extended Characters in Path Names
  27.  
  28. SECTION 3       Trouble Shooting Installation Problems
  29.                 A)  Internal Error, Unable to Start Install
  30.                 B)  Install Program Terminates Prematurely
  31.                 C)  General Protection Fault/Unhandled Exception
  32.                 D)  Problems With Installing Win32s
  33.  
  34. SECTION 4       Locating Technical Information
  35.  
  36.  
  37.  
  38. SECTION -0- SYSTEM REQUIREMENTS
  39. ===============================
  40.  
  41. Before installing Resource Workshop (RW) please
  42. review the system requirements listed below:
  43.  
  44.         4 MB system memory
  45.         Intel 386 or higher
  46.         PC-DOS (MS-DOS) 4.01 or later
  47.         Microsoft Windows 3.1 or later
  48.         3.5" High Density Disk Drive 
  49.         6 MB of hard disk space
  50.  
  51.    The Install program requires Windows enhanced mode.  It
  52.    does not run under standard mode.
  53.         
  54.    The installation program requires about 5MB of
  55.    additional hard disk space to run.
  56.  
  57.    More space is required on hard drives with large cluster
  58.    sizes (typically drives with a capacity of 1GB or more.)
  59.  
  60.  
  61. SECTION -1- BOOTING CLEAN
  62. =========================
  63.  
  64. It is highly recommended that you boot clean before installing
  65. RW.  Booting your system with a clean configuration will
  66. eliminate many potential software conflicts that might cause the
  67. installation to fail.  You will need one blank floppy diskette.
  68. After making the disk bootable, use a text editor (EDIT, for
  69. example) to create and/or modify the files mentioned below.  
  70.  
  71. Note that the instructions below assume that DOS is installed
  72. into the directory C:\DOS, and that Windows in installed into the
  73. directory C:\WINDOWS.
  74.  
  75. Twice below there is a statement "<insert required drivers
  76. here>".  For the purposes of the clean boot, a "required
  77. driver" is one that must be loaded so that you can access
  78. the devices necessary to complete the installation.  For
  79. example, if you are installing onto a network drive, your
  80. network drivers are required.  Examples of things that are
  81. not "required drivers" include EMM386.EXE, QDPMI.SYS, and
  82. SMARTDRV.EXE.  If you are unsure whether a driver is
  83. required, assume it is not.
  84.  
  85. A) Making a Boot Disk
  86.  
  87. It is suggested that you create the clean boot configuration on a
  88. floppy disk, in order to minimize the number of changes made to
  89. your normal system configuration.
  90.  
  91. In most cases, inserting a blank diskette in drive A: and typing
  92. the command
  93.  
  94.     format a: /s
  95.  
  96. will work.  See your DOS documentation for more details
  97. on creating a bootable floppy.
  98.  
  99.  
  100. B) Contents of CONFIG.SYS (on boot floppy)
  101.  
  102.     DEVICE=C:\DOS\HIMEM.SYS
  103.     FILES=40
  104.     <insert REQUIRED drivers here>
  105.  
  106. C) Contents of AUTOEXEC.BAT (on boot floppy)
  107.  
  108.     REM the path statement should be copied verbatim
  109.     REM from your current AUTOEXEC.BAT.  The line included
  110.     REM below is an example only.
  111.  
  112.     PATH=C:\WINDOWS;C:\DOS
  113.  
  114. D) Changes to C:\WINDOWS\WIN.INI and C:\WINDOWS\SYSTEM.INI
  115.  
  116. Before modifying these files, be sure to back them up: Windows
  117. will not properly start if they are corrupted (i.e., copy WIN.INI
  118. WIN.BAK).
  119.  
  120.     1)  Edit WIN.INI
  121.  
  122.     2)  Find all lines that begin with either "load=" or "run="
  123.     and place a single ";" at the start of each line.
  124.  
  125.     3)  Edit SYSTEM.INI
  126.  
  127.     4)  If the line that starts with "shell=" is set to
  128.     something besides "progman.exe", place a ";" at the start of
  129.     the line, and replace it with "shell=program.exe" (no
  130.     quotes).  
  131.  
  132.  
  133.  
  134. SECTION -2- BEFORE YOU BEGIN
  135. ============================
  136.  
  137. A)  Boot Clean
  138.  
  139.     It is highly recommended that you boot clean before
  140.     installing Resource Workshop. Booting your system with a
  141.     clean configuration will eliminate any potential software 
  142.     conflicts that might arise during installation. Refer to
  143.     Section 1 for instructions on how to boot clean.
  144.  
  145. B)  Network Installation
  146.  
  147.     The Install program needs to update Windows system
  148.     files.  If you do not have write privileges for the LAN
  149.     Windows system directory, a system administrator will have
  150.     to perform the installation for you.  
  151.  
  152.     If you launch SETUP.EXE from a network directory, Setup 
  153.     will not be able to display INSTALL.TXT for you.  You 
  154.     can find INSTALL.TXT on floppy disk #1, and Setup will
  155.     still copy it to your installed directory.
  156.     
  157. C)  Installing Under Windows NT or OS/2
  158.  
  159.     The install will fail if you enter any paths that use long
  160.     file names (more than 8 letters in the name, more than 3
  161.     letters in the extension, or exceeding a total path length
  162.     of 128 characters).
  163.  
  164. D) Installing Under OS/2
  165.  
  166.     When installing under OS/2, WinOS/2 should be run in either
  167.     a full screen WinOS/2 session, or from Program Manager.
  168.     Also, the session must be in Enhanced Mode rather than 
  169.     Standard.  To check this, see the WinOS/2 settings for
  170.     the appropriate icon.  Note that if run from a full screen
  171.     session (preferred), near the end of the installation,
  172.     focus will switch to the OS/2 desktop as a DOS program is
  173.     run; when this program exits, OS/2 will not return the
  174.     focus back to the WinOS/2 session, you will need to do
  175.     this manually.
  176.  
  177. E) Installing Under Windows NT
  178.     
  179.     If you install RW from a shared read-only network 
  180.     drive under Windows NT, the Install program will not open
  181.     the INSTALL.TXT and README.TXT files.  Look for them in
  182.     your WORKSHOP directory after Install finishes.
  183.  
  184. F) Avoid Extended Characters in Path Names
  185.  
  186.     If you use extended ASCII characters (with numbers over
  187.     127) in the path names for installing RW, the Install
  188.     program will not correctly update your INI files.
  189.  
  190.  
  191. SECTION -3- TROUBLESHOOTING INSTALLATION PROBLEMS
  192. =================================================
  193.  
  194. This section explains common errors encountered during
  195. installation. System configuration and software conflicts
  196. might cause the installation process to fail. If the
  197. installation fails, follow the instructions in Section 1
  198. on how to boot clean.  This will eliminate many possible
  199. software conflicts.  Also, check the integrity of the file
  200. systems on your hard drive using a utility like CHKDSK or
  201. SCANDISK; proceeding with an installation while file system
  202. errors are present increases the risk of a failure resulting in
  203. data loss.  If these two steps do not solve the
  204. problem, or you encounter a problem not mentioned here, 
  205. contact Borland Technical Support.
  206.  
  207. A)  Internal Error, Unable to Start Install
  208.  
  209.     1) Error -2:  The install program was unable to create a
  210.     temporary directory needed for the installation.  Check that
  211.     if you have either TMP or TEMP set as environment variables
  212.     that they point to a valid directory on a drive with at least
  213.     two megabytes of free space (four megabytes if you are using
  214.     disk compression).  If you do not have a TMP or a TEMP
  215.     environment variable set, the install will place its
  216.     temporary files in the directory WINDOWS\TEMP.  
  217.  
  218.     You will also see Error -2 if the Install program
  219.     cannot create this directory--if, for example, there
  220.     is already a file called TEMP in your WINDOWS
  221.     directory, or if your Windows drive does not have two
  222.     megabytes of free space.
  223.     
  224.     2) Error -3:  There was an error while copying and decompressing
  225.     the file INSTRUN.EXE, which is used to launch phase two of
  226.     the installation.  Check that there is sufficient free space
  227.     in your temporary directory (see above) and boot the machine
  228.     clean.  Also, a hard drive installation is often helpful.
  229.  
  230.     3) Error -69:  The execution of INSTRUN.EXE (phase two of
  231.     the installation process) failed.  Probable causes:  file
  232.     corruption (see above), memory corruption (see the section on
  233.     booting clean).
  234.  
  235. B) Install Program Terminates Prematurely 
  236.  
  237.    If the install program stops for no apparent reason without 
  238.    error messages, it is possible that certain support files
  239.    are write protected. To check this, do the following:
  240.  
  241.           1) Go to your WINDOWS directory
  242.           2) Type  attrib *.*
  243.           3) Check for the "r" attribute. If any file has this
  244.              flag set, then you must clear it by typing:
  245.                      attrib -r <filename>
  246.           4) Repeat steps 2-3 for the WINDOWS\SYSTEM directory.
  247.  
  248. C)  General Protection Fault/Unhandled Exception 
  249.  
  250.     If you encounter a General Protection Fault or Unhandled
  251.     Exception during installation, try the following steps:
  252.  
  253.     - Make sure your system meets the minimum requirements.
  254.       Refer to Section 0 for a list of the minimum
  255.       installation requirements.
  256.  
  257.     - Boot your system with a clean configuration. Refer to
  258.       Section 1 for instructions on how to boot clean.
  259.  
  260.     - Perform an integrity check on your hard drive, using
  261.       a utility such as "SCANDISK" or "CHKDSK".
  262.  
  263.     - Turn off Disk Caching and Video/Shadow RAM in CMOS.
  264.       Refer to the documentation for your computer.
  265.  
  266.  
  267. SECTION -4- Locating Technical Information
  268. =======================================================
  269.  
  270. Below are Borland supplied sources for technical information.
  271.  
  272.   -The Inprise Developer Support page
  273.       http://www.inprise.com/devsupport/
  274.  
  275.   -The Inprise FTP site on the Internet
  276.       ftp://ftp.inprise.com 
  277.     
  278.   -Inprise forums
  279.       forums.inprise.com
  280.  
  281. Additional technical information resources:
  282.  
  283. From within the US, fax the document from Borland's TechFax 
  284. Service.
  285.  
  286. Call (800) 822-4269 from a touch-tone phone. When prompted, enter
  287. your FAX number, then enter the document number you want to
  288. receive. The document will be faxed to you shortly.
  289.  
  290.  
  291.                    *** END OF FILE INSTALL.TXT ***
  292.