home *** CD-ROM | disk | FTP | other *** search
/ S283 Planetary Science &… the Search for Life CD 3 / CD-ROM.iso / install / isisdraw / draw23.exe / data1.cab / All_OS_Help_Files / INSTALL.TXT < prev    next >
Encoding:
Text File  |  2000-04-12  |  21.9 KB  |  546 lines
  1. April, 2000
  2.  
  3.            Installation Notes for ISIS version 2.3 (Windows)
  4.    (c) Copyright 2000 by MDL Information Systems, Inc. All rights reserved.
  5.  
  6. NOTE: The file Appinst.txt provides the installation notes for the ISIS 
  7. Applications. It is located in the Documents folder on the ISIS 2.3 CD, and in 
  8. the ISIS 2.3 folder after installation.
  9.  
  10. This document provides information about the following topics:
  11.  
  12.     1. Recommended PC Hardware
  13.     2. Paperless Installation
  14.     3. Additional Readme Files Available
  15.     4. Installation Alternatives
  16.     5. Silent Install (For ISIS Administrators Only)
  17.     6. File and Directory Structure
  18.     7. Installing and Using ISIS 2.3 and ISIS 2.2/2.1.x on the Same Machine
  19.     8. Uninstalling ISIS
  20.     9. Distributing Preconfigured RAFs (For ISIS Administrators Only)
  21.  
  22. -------------------------------------------------------------------------
  23.  
  24. 1.  Recommended PC Hardware
  25.  
  26. The installation will not proceed if you are attempting to install ISIS 2.3 onto 
  27. a computer running other than Windows 95, 98 or NT 4.0.
  28.  
  29. Following is the minimum hardware configuration required to run ISIS and ISIS 
  30. applications:
  31.  
  32.   - A 486 microprocessor or higher
  33.   - Maximum of 48 Mb of free hard-disk space, depending on your license
  34.   - 16 Mb RAM for Windows 95 and 98, 24 Mb RAM for Windows NT 4.0
  35.   - PostScript printer
  36.  
  37. In addition, you must have administrator privileges to install onto a machine
  38. running Windows NT 4.0. This is necessary for updating system files.
  39.  
  40. -------------------------------------------------------------------------
  41.  
  42. 2.  Paperless Installation
  43.  
  44. There are no written instructions for installing ISIS 2.3 other than this
  45. document. The installer will provide you with all the information that you need,
  46. with the addition of a few notes in this document.
  47.  
  48. We highly recommend that you have no other applications running or minimized 
  49. during installation. The installer will be able to complete all installation 
  50. tasks if this is the case.
  51.  
  52. If you do have other applications running or minimized during the installation, 
  53. the Registration of ISIS/Object Library may fail. You must then complete the 
  54. registration manually by choosing "ISIS ADK Registration" from the Start menu. 
  55. To get the exact command for Object Library registration, examine the shortcut 
  56. property. This registration is required to successfully run any applications 
  57. written using the ISIS/Object Library.
  58.  
  59. Any system files with read-only protection MUST have that protection removed in 
  60. order to complete the ISIS 2.3 installation. This is only necessary if the 
  61. protected files have a version number less than the minimum version required by 
  62. ISIS 2.3.
  63.  
  64. See the "File and Directory Structure" section of this document to see exactly 
  65. which system files are installed and the criteria used for installation. Shared 
  66. system files require updating into the Windows/System32 (NT 4.0) or 
  67. Windows/Systems folder (Windows 95 or 98).
  68.  
  69. The files installed into the Windows/System (or System32) folder must be 
  70. installed into the appropriate directory used by EACH workstation. For network 
  71. installations, this may mean these files alone must be installed onto each 
  72. workstation. See the "Installation alternatives" section of this document for 
  73. more details.
  74.  
  75. The ISIS 2.3 installation also installs the ISIS Applications. The installer 
  76. installs ISIS and ISIS Application files based on the type of seat and databases 
  77. that you have licensed. You are given a key (or set of keys) for all of the ISIS 
  78. seats and databases that you have licensed. These keys are located on a card in 
  79. your package. You use these keys during the installation of each seat. If you 
  80. have many seats to install, see the instructions in section 4 of this document 
  81. for several installation alternatives to make installation easier.
  82.  
  83. This installer has been tested with Office 97 and Office 2000 on Windows 
  84. 95/98/NT 4.0. These products share some of the system files installed for ISIS 
  85. 2.3.
  86.  
  87. -------------------------------------------------------------------------
  88.  
  89. 3.  Additional Readme Files Available
  90.  
  91. The following Readme files are located in the ISIS 2.3 folder.
  92.  
  93.  * AIMREAD.TXT has information about the ISIS/Add-in Manager.
  94.  
  95.  * SARADDIN.TXT has information about ISIS SAR Table and ISIS/Add-ins.
  96.  
  97.  * APPINST.TXT has the installation notes for ISIS Applications.
  98.  
  99.  * With the Development seat, there is also an ISIS 2.3 Developer's Readme file, 
  100.    called ADK_READ.TXT. This file is located under the ISIS 2.3 directory (or 
  101.    whichever directory you specified during the installation).
  102.  
  103. These files contain late-breaking information about improvements and 
  104. limitations. We recommend that you read them PRIOR to using ISIS 2.3.
  105.  
  106. -------------------------------------------------------------------------
  107.  
  108. 4.  Installation Alternatives
  109.  
  110. There are several alternative methods for installing ISIS 2.3. This section 
  111. describes the options and the steps necessary to perform each option, as well as 
  112. the pros and cons of each option. Use the information in this section to 
  113. determine what method of installation will best serve the needs of your 
  114. organization. The options are listed in approximate order of complexity.
  115.  
  116.  A. Install from CD-ROM on each workstation.
  117.  B. Copy the installer files onto the your network disk server and allow each 
  118.     user to run the installer and load the files onto their workstation.
  119.  C. Install ISIS 2.3 onto your network.
  120.  D. Distribute ISIS 2.3 via your internal web.
  121.  E. Install some ISIS 2.3 files onto each workstation and some shared files onto 
  122.     your network.
  123.  
  124. Option A
  125. --------
  126.  
  127. Option A requires that CD-ROMs be distributed to all users, or that the ISIS 
  128. administrator installs ISIS and ISIS applications, using the applicable 
  129. installation key, on each workstation. This works well for small numbers of 
  130. workstations, but can be cumbersome for large numbers of workstations. This is 
  131. one of the simpler installation methods, as it only requires running the 
  132. installer and knowing the installation key for each workstation.
  133.  
  134. Option B
  135. --------
  136.  
  137. Option B involves copying the installation files onto your internal network disk 
  138. server and allowing each end-user to run the installer on their personal 
  139. workstation. Option B is relatively simple for both administrator and end-users, 
  140. so long as end-users are comfortable with accessing the network.
  141.  
  142. With this option, a log file (INSTALL.LOG) is created in the directory in which 
  143. you copy the ISIS 2.3 installer files. Each time a user runs the installer, the 
  144. user's name, the date, and the seat they install (Development, Chemistry, Life 
  145. Science, or Retrieval) is appended to this log file.
  146.  
  147. As each user will be automatically writing to this log file, the network 
  148. directory containing the ISIS installation files and the INSTALL.LOG file MUST 
  149. be writable. Otherwise, this log will not be updated and the installation will 
  150. stop.
  151.  
  152. This alternative requires that the ISIS administrator:
  153.  
  154.   1. Copy all of the installer files from the CD-ROM into a single directory.
  155.  
  156.   2. Create an empty file named INSTALL.LOG in this directory. This flags the 
  157.      installer that you want to keep a log of all users who install ISIS 2.3.
  158.  
  159.   3. Provide EACH end-user with the installation key for the seat and databases 
  160.      that they have licensed.
  161.  
  162. End-users then:
  163.  
  164.   1. Run setup.exe to install ISIS 2.3.
  165.  
  166.   2. Enter their installation key when prompted during the installation.
  167.  
  168. To automate installation key input, you can create an installation data file, 
  169. INSTALL.DAT, which contains the installation key for each seat and database that 
  170. you have licensed.  Note this MAY NOT be used in conjunction with silent install.
  171. (See Section 5 "Silent Install" for more information.)
  172.  
  173. INSTALL.DAT must have the following format:
  174.  
  175. MDLI.V2 version2.3
  176. # company
  177. # users
  178. # comments
  179. 4-digitInstallKeyHere
  180.  
  181. "MDLI.V2" is a reserved word, and must appear in the installation data file. 
  182. INSTALL.DAT must be located in the same folder as the ISIS 2.3 installer files.
  183.  
  184. If you have more than one installation key, you need to copy the same ISIS 2.3 
  185. installer files into different folders for each licensed key, and create a 
  186. specific installation data file for each license.
  187.  
  188. Option C
  189. --------
  190.  
  191. Option C allows the ISIS administrator to install the files on the network for 
  192. each type of seat the site has licensed, and then have users run ISIS from each 
  193. seat area. For speed reasons, we do NOT recommend installing the ISIS 2.3 
  194. Development seat onto the network - it should be installed on each developer's workstation.
  195.  
  196. This option requires some effort to set up. In addition, the performance speed 
  197. when running ISIS from the network can be a major concern.
  198.  
  199. This alternative requires that the ISIS administrator:
  200.  
  201. 1. Install all licensed ISIS seats (except the Development seat) into separate 
  202.    folders on a standalone workstation. You can name these directories anything 
  203.    - we suggest ISISCHEM, ISISLIFE, and ISISRETR.
  204.  
  205. 2. Copy the ISISCHEM, ISISLIFE, and ISISRETR folders and the ISIS common folder 
  206.    onto your network. (See Section 6 "File and Directory Structure" for ISIS 
  207.    file locations.)
  208.  
  209. 3. System files required by ISIS 2.3 MUST be copied into each user's system.
  210.  
  211. 4. If each user needs to have personal configuration files, isisdraw.cfg and
  212.    isisbase.cfg must be copied to each user's Windows folder.
  213.  
  214. 5. Object Library must be registered on the network manually using Olreg32.exe.
  215.  
  216. 6. A path pointing to the ISIS Common folder where ISISLib.dll and Mdlctl32.dll
  217.    are installed must be manually added to each user's environment.
  218.  
  219. 7. If you choose to install SAR table for Excel version 9 (Office 2000) or Excel 
  220.    version 8 (Office 97), the file SARTABLE.XLA must be in the XLSTART directory
  221.    in Microsft Office folder or in the directory specified as the Alternate Startup
  222.    File Location on the Options dialog (Tools > Options menu command, General tab).
  223.  
  224.  
  225. Option D
  226. --------
  227.  
  228. Option D applies if you have an internal web and are distributing other software 
  229. in this manner, or if you want to distribute ISIS in this manner.
  230.  
  231. This alternative requires that the ISIS administrator:
  232.  
  233.   1. Copy all of the installer files from the CD-ROM into a single directory.
  234.  
  235.   2. Create INSTALL.DAT which contains the installation key.(See Option B for 
  236.      the format of this file.)
  237.  
  238.   3. Combine all of the installer files and the installation data file into a 
  239.      single compressed file using PKZIP (available as shareware on the 
  240.      Internet).
  241.  
  242.   4. Create a self-extracting archive using Winzip (also from PKZIP).
  243.  
  244.   5. If you have more than one installation key, repeat these steps to create 
  245.      each self-extracting archive for each license.
  246.  
  247.   6. Publish the ISIS 2.3 self-extracting installer archive via an HTML download 
  248.      page.
  249.  
  250. End-users then:
  251.  
  252.   1. Download the single file from the internal web.
  253.  
  254.   2. From the Windows Explorer, double click the self-extracting archive file to 
  255.      expand the installer files.
  256.  
  257.   3. Run Setup.exe to install ISIS 2.3.
  258.  
  259. Option E
  260. --------
  261.  
  262. Option E involves installing some ISIS files on each user's workstation 
  263. (executables and configuration files), and installing the support files
  264. (template, forms, settings, help, and sample) files onto your network.
  265.  
  266. This is the most complicated of the installation options, though it does save 
  267. some disk space on each user's workstation. This option allows some files to be 
  268. installed and used on the network and other files to be installed on each user's 
  269. workstation. The files that you might want to keep on your network include the 
  270. template, forms, settings, and sample files. We do NOT recommend keeping the 
  271. help files on the network, as the access time will minimize the help file's 
  272. usefulness. Since the online help is the ONLY documentation available to most 
  273. end-users, ready and easy access to the help files is important.
  274.  
  275. Keeping the sample databases and settings on the network means that these files 
  276. cannot be modified without impacting ALL users.
  277.  
  278. If you are keeping any ISIS support files on the network, provide instructions 
  279. to your users as to the directories in which the support files reside. The first 
  280. time a user tries to access one of these files (template, forms, settings, help, 
  281. and sample), the ISIS program looks for the files in or below the ISIS 2.3 
  282. executable directory. If they are not found (which they would not be), a dialog 
  283. box prompts the user to navigate to the directory where the file resides. The 
  284. user must navigate to the directory on the network one time, and then ISIS saves 
  285. the location of the file on the user's local drive.
  286.  
  287. To set up this file configuration:
  288.  
  289. 1. Install program-only files from Chemistry, Life Science, or Retrieval seats
  290.    onto each workstation.
  291.  
  292. 2. Delete the Settings and Forms folders from these installations.
  293.  
  294. 3. Install the full Chemistry seat onto your network.
  295.  
  296. 4. Delete all files at the ISIS 2.3 level (not the subdirectories) except 
  297.    perhaps the readme files and ISISDESK.HLP (though again, we recommend that 
  298.    you install the help file on each workstation for performance reasons).
  299.  
  300. -------------------------------------------------------------------------
  301.  
  302. 5.  Silent Install (For ISIS administrator only)
  303.  
  304. Silent Install allows the end-user to run the ISIS 2.3 Installer without having 
  305. to provide any input. All user responses have already been provided by the 
  306. administrator.
  307.  
  308. Silent Install is available on the PC only, and is one of the features of 
  309. InstallShield. It is meant to be an additional option for deploying ISIS, and 
  310. does not change nor break your current deployment strategy.
  311.  
  312. How Silent Install Works
  313. ------------------------
  314.  
  315. 1. The Administrator runs the ISIS 2.3 Installer in record mode and answers all 
  316.    the user questions. This creates a response file (setup.iss) which contains 
  317.    all the responses to the dialogs.
  318.  
  319. 2. The Administrator creates a shortcut (using the appropriate command line 
  320.    switches) to the ISIS 2.3 Installer on the network, then gives this location 
  321.    to the end-user.
  322.  
  323. 3. The end-user double-clicks the shortcut to run the ISIS 2.3 Installer, but 
  324.    does not have to provide any input. This generates a log file.
  325.  
  326. 4. The Administrator checks the log file to make sure that the silent install 
  327.    was successful.
  328.  
  329. To Record an Installation
  330. -------------------------
  331.  
  332. c:\ISISDir\setup.exe -r
  333.  
  334. [-r] is to run the installer in "record" mode. This creates a response file 
  335. called setup.iss on your machine in the Windows folder. This file provides user 
  336. input for later playback. Setup.iss can be renamed and should be placed in the 
  337. same location as the ISIS Installer.
  338.  
  339. To Play Back an Installation
  340. ----------------------------
  341.  
  342. Create a shortcut for the end-user based on the following sample syntax:
  343.  
  344. setup.exe -s -f2C:\temp\ISISInstall.log
  345.  
  346. This example launches the installer silently, uses setup.iss from the same 
  347. folder as the installer, and generates the log file ISISInstall.log in the 
  348. C:\temp folder.
  349.  
  350. [-s] is to run the installer in "silent" mode.
  351.  
  352. [-f2] lets you specify an alternative location for the log file. By default, the 
  353. log file is created in the installer folder, but this is not desirable as the 
  354. installer is normally placed on a network server.
  355.  
  356. Checking the Log File
  357. ---------------------
  358.  
  359. The log file contains three sections. The first section, [InstallShield Silent], 
  360. identifies the version of InstallShield Silent used in the silent setup. It also 
  361. identifies the file as a log file.
  362.  
  363. The second section, [Application], identifies the name and version of the installed application, as well as the company name.
  364.  
  365. The third section, [ResponseResult], contains the result code that indicates
  366. whether or not the silent install succeeded. An integer value is assigned to the 
  367. ResultCode keyname in the [ResponseResult] section. InstallShield places one of 
  368. the following return values after the ResultCode keyname:
  369.  
  370.      0    success
  371.     -1    general error
  372.     -2    invalid mode
  373.     -3    required data not found in setup.iss file
  374.     -4    not enough memory available
  375.     -5    file does not exist
  376.     -6    cannot write to the response file
  377.     -7    unable to write to the log file
  378.     -8    invalid path to the silent install response file
  379.     -9     not a valid list type (string or number)
  380.     -10    data type is unknown
  381.     -11    unknown error during setup
  382.     -12    dialog boxes are out of order
  383.     -51    cannot create the specified folder
  384.     -52    cannot access the specified file or folder
  385.     -53    invalid option selected
  386.  
  387. Important Notes:
  388.  
  389. * If you press Back, Cancel or make a mistake when recording, you MUST exit the 
  390.   installer and re-record the installation. Any of these actions can corrupt the 
  391.   response file. If you get a warning such as invalid path, and so on, you must 
  392.   also re-record.
  393.  
  394. * Do not edit the setup.iss file. This might cause the silent install to fail.
  395.  
  396. * Do not use install.dat at the same time as silent install. The installation 
  397.   will fail if both install.dat and setup.iss exist.
  398.  
  399. * The directory path you choose to install ISIS in will not necessarily be the 
  400.   path in the silent installation. The default path of the silent install will 
  401.   always be [Windows drive]:\Program Files\ISIS 2.3.
  402.  
  403. * If you install Sartable while recording, the installer will automatically 
  404.   search for the Excel location during playback. The file sartable.xla will be 
  405.   placed in \xlstart folder in either Excel version 9 (Office 2000) or Excel 
  406.   version 8 (Office 97). If neither folder is found, the installer will create 
  407.   an \xlstart folder in the ISIS 2.3 folder and place sartable.xla in it.
  408.  
  409. ---------------------------------------------------------------------------
  410.  
  411. 6. File and Directory Structure
  412.  
  413. ISIS 2.3 files are installed into 4 areas(folders):
  414.  
  415. <bootdrive>:\Program Files\Common Files\MDL Shared\ISIS:
  416. ISISLIB.DLL
  417. MDLCTL32.DLL
  418.  
  419. ISIS 2.3 folder:
  420. All ISIS 2.3 and application files
  421.  
  422. Windows folder:
  423. isissar.ini
  424.  
  425. Windows System folder:
  426. PWSOCK32.DLL    1.00.119
  427. PWIOCB32.DLL    1.0.006
  428. MFC40.DLL    4.1.6130
  429. MFCO40.DLL    4.0.5136
  430. MFC42.DLL    6.00.8168.0
  431. MSVCIRT.DLL    6.00.8168.0
  432. MSVCRT.DLL    6.00.8168.0
  433. MSVCRT40.DLL    4.21.0000
  434. NMAPI32.DLL    1.0.009
  435. OLEAUT32.DLL    2.30.4261
  436. OLEPRO32.DLL    5.0.4261
  437. CTL3D32.DLL    2.31.00 (Windows 95/98)
  438. CTL3D32.DLL    2.31.00 (Windows NT 4.0)
  439. STDOLE2.TLB    2.30.4261
  440.  
  441. The system files are replaced ONLY if the currently installed versions (or 
  442. dates) are older than the version shipped with ISIS 2.3.
  443.  
  444. File added to the Windows System folder after running ISIS 2.3:
  445. TPL.CFG
  446.  
  447. NOTE: In order for ISIS to locate necessary files in several areas, it is
  448. necessary to modify the search path in your system.
  449.  
  450. Windows 95 or 98:
  451. The file autoexec.bat is modified to add the following path:
  452. <bootdrive>:\Program Files\Common Files\MDL Shared\ISIS.
  453. Short path names must be used, such as D:\PROGRA~1\COMMON~1\MDLSHA~1\ISIS.
  454.  
  455. Windows NT 4.0:
  456. The registry is modified to add this path.
  457.  
  458. -------------------------------------------------------------------------
  459.  
  460. 7.  Installing and Using ISIS 2.3 and ISIS 2.2/ISIS 2.1.x on the same machine
  461.  
  462. If you plan to use both versions on the same machine, you must move the 
  463. following 2 files to the ISIS 2.2/ISIS 2.1.x application folder BEFORE 
  464. installing ISIS 2.3. ISIS uses standard search paths to locate these files.
  465.  
  466. Do the following:
  467.  
  468. 1. Move the 2.2/2.1.X versions of ISISLib.dll and Mdlctl32.dll from 
  469.    <boot_drive>:Program Files\Common Files\MDL Shared\ISIS to the ISIS 2.2/2.1.x
  470.    application folder.
  471.  
  472. 2. Install ISIS 2.3.
  473.  
  474. Your ISIS 2.2/2.1.x will be using the ISISLib.dll and Mdlctl32.dll from it's 
  475. folder. Your ISIS 2.3 will be using the ISISLib.dll and Mdlctl32.dll from the 
  476. Common folder.
  477.  
  478. NOTE: If you run ISIS/Object Library, you must re-register each time you switch
  479. between versions.
  480.  
  481. To register from the ISIS 2.2/2.1.x folder:
  482.  
  483. Since the "ISIS ADK Registration" shortcut will no longer work after you move
  484. ISISLib.dll to the ISIS 2.2/2.1.x folder, you need to manually enter the 
  485. following command line at the DOS Prompt:
  486.  
  487. <change directory to your ISIS 2.2/2.1.x folder>
  488. i.e, cd c:\Program Files\ISIS 2.2\
  489. then enter
  490. olreg32.exe /System /Server=isislib.dll /mdldb=mdldb.ocx /mdlbox=mdlbox.ocx
  491.  
  492. To register from ISIS 2.3:
  493.  
  494. Choose "ISIS ADK Registration" from the Start menu.
  495.  
  496. -------------------------------------------------------------------------
  497.  
  498. 8.  Uninstalling ISIS
  499.  
  500. 1. Choose Settings > Control Panels from the Windows Start menu.
  501. 2. Double click Add/Remove programs.
  502. 3. Select ISIS 2.3.
  503. 4. Click Add/Remove.
  504.    Windows 95/NT 4.0 will uninstall ISIS 2.3, and will remove the ISIS 2.3 
  505.    shortcut from the Start menu and desktop icons.
  506.  
  507. -------------------------------------------------------------------------
  508.  
  509. 9.  Distributing Preconfigured RAFs (For ISIS Administrator Only)
  510.  
  511. The ISIS Installer can now copy preconfigured RAFs when the end-user installs
  512. ISIS from the network. This simplifies the task of setting up site-specific 
  513. connection information and Hview identification for multiple users.
  514.  
  515. How it Works
  516. ------------
  517.  
  518. The ISIS administrator:
  519.  
  520. 1. Installs ISIS/Desktop 2.3 on their local PC.
  521.  
  522. 2. Runs ISIS/Base 2.3 and configures the RAFs by specifying the connectivity and 
  523.    Hview information for their site.
  524.  
  525. 3. Copies these preconfigured RAFs to the same network folder that contains the 
  526.    ISIS Installer (setup.exe).
  527.  
  528. End-users then:
  529.  
  530. 1.  Run the ISIS Installer from the network. The installer copies the 
  531.     preconfigured RAFs to the correct location on the end-user's PC.
  532.  
  533.  
  534. Following is the set of RAFs that can be preconfigured:
  535. -------------------------------------------------------
  536.  
  537. ACD Finder         - Acdfind.db
  538. CMC-3D Finder        - cmc3d.db
  539. MDDR-3D Finder         - mddr3d.db
  540. MDDR Finder         - mddr.db
  541. Reaction Browser     - rxnbrows.db
  542. Metabolite Browser     - metab.db
  543. Metabolite Registrar     - xyzmol.db and xyzrxn.db
  544. Toxicity Finder     - toxfind.db
  545. Base samples         - flat.db, hier.db, localmx.db and localrx.db
  546.