home *** CD-ROM | disk | FTP | other *** search
/ BUG 11 / BUGCD1998_02.ISO / email / sime / simdemo.z / install.txt < prev    next >
Text File  |  1997-12-04  |  18KB  |  431 lines
  1. Simeon Mail Client Version 4.1.x
  2. Windows/WindowsNT/Windows95
  3.  
  4. INSTALLATION INSTRUCTIONS
  5.  
  6. Last Updated: December 04, 1997
  7.  
  8. Table of Contents
  9. -----------------
  10.  
  11. 1.0 System Requirements
  12. 2.0 Installing Simeon Mail
  13.     2.1 Preparation
  14.     2.2 Licensing
  15.     2.3 Where to Install
  16.     2.4 Running the Setup Program
  17.         2.4.1 Network Install
  18.         2.4.2 Local PC Install
  19.         2.4.3 Workstation Install
  20.     2.5 Information About DLL's
  21.         2.5.1 Manually Installing CTL3Dx, MSVCRT40, and MAPIx DLL's
  22. 3.0 Configuring Simeon Mail
  23.     3.1 How Users will Run Simeon Mail
  24.     3.2 Configuring the Windows Environment
  25.     3.3 Simeon Configuration Files
  26.     3.3.1 Site Defaults
  27.     3.3.2 New User Startup Script
  28. 4.0 Upgrading from Previous Versions
  29.  
  30. 1.0 System Requirements
  31. -----------------------
  32. Running Simeon Mail requires a 386 or better machine running one of the
  33. following:
  34.  
  35.     - Microsoft Windows 3.1,  
  36.     - Windows for Workgroups 3.11
  37.     - Windows NT 
  38.     - Windows95  
  39.     - OS/2 2.1 (with the DOS/Windows compatibility toolkit), 
  40.  
  41. Disk space required for a complete (Mail plus LDUA and Kerberos) installation 
  42. of Simeon Mail is approximately 7.5 Mb for Windows and 4 Mb for WindowsNT/95.
  43. Additional space will be required if users store mail or address books 
  44. locally. Memory requirements are a minimum 4 Mb, with 8 Mb or more 
  45. recommended.  Simeon also requires a TCP/IP network, and a TCP stack 
  46. supporting a Winsock 1.1 compliant DLL.  This stack must be properly 
  47. installed. 
  48.  
  49. IMPROPER INSTALLATION OF THE TCP STACK OR WINSOCK DLL IS THE LEADING 
  50. PROBLEM IN INSTALLING Simeon Mail.  
  51.  
  52. The following stacks are known to work with Simeon Mail:
  53.  
  54.     -  Beam & Whiteside - BWTCP 3.x
  55.     -  FTP Software - PC/TCP 2.2
  56.     -  Novell Lan Workplace 4.1 (BETA Winsock)
  57.     -  NetManage Chameleon
  58.     -  SuperTCP 1.1
  59.     -  Trumpet  Winsock
  60.     -  PC/NFS 5.0b through 5.0w
  61.         -  TCP/IP included with Windows NT/95
  62.  
  63. 2.0 Installing Simeon Mail
  64. --------------------------
  65.  
  66. 2.1 Preparation
  67. ---------------
  68.  
  69. If you obtained your distribution via the Internet:
  70.  
  71. If you obtain a version of Simeon Mail over the Internet, you will be 
  72. provided with a self-extracting archive executable.  Create a temporary
  73. directory on the machine where Simeon Mail will be installed, and copy
  74. the executable to that directory.  For example:
  75.  
  76.     C:\> mkdir tmp
  77.         C:\> copy 32full.exe tmp
  78.     1 file(s) copied
  79.     C:\> cd tmp
  80.     C:\TMP>
  81.  
  82. You will then need to run this file to extract the files from the archive, or
  83. you may extract them using an "un-zipping" tool of your choice.  The resulting
  84. files will include the "setup" program.
  85.  
  86. If you obtained your version via Diskette:
  87.  
  88. If you have obtained a version on diskette, the setup program is provided 
  89. directly, there are no intermediate steps to unpack the program.
  90.  
  91.  
  92. 2.2 Licensing
  93. -------------
  94. You require one license of Simeon Mail for every CPU, even if Simeon Mail is
  95. installed on a shared, networked volume.
  96.  
  97. 2.3 Where to Install
  98. --------------------
  99. You have the option of installing Simeon on each PC that will be running
  100. it, or placing it on a networked drive that is NFS mounted by the client PCs.
  101. We recommend installation on a shared network drive if this is possible,
  102. to make upgrades and user support simpler.  It is also possible to have some
  103. clients running from a network drive while others run from their local
  104. drives, as will certainly happen with notebook users. If Simeon is installed 
  105. on a networked drive, the Workstation setup will need to be run at each
  106. workstation accessing Simeon Mail.
  107.  
  108. * Note: *
  109. DO NOT install Simeon 4.1.x into your Simeon V3.x or v4.0.x program
  110. directory.  Select a new directory.  You may (and are encouraged to) use the
  111. same working directory as was used for Simeon 3.x or v4.1.x so that
  112. Simeon 4.1.x can access your previous configuration and local folder and
  113. address book files.
  114.  
  115.  
  116. 2.4 Running the Setup program
  117. -----------------------------
  118.  
  119. From within Program Manager in Windows, choose "File / Run" and select
  120. the setup.exe program you obtained, either on diskette or the Internet copy
  121. you unpacked onto your hard disk.  The program will prompt you for a choice
  122. of install type: Network or Local PC.
  123.  
  124. An Evaluation version of Simeon is also available, and has the same features
  125. a Local PC install, except many of the steps of configuration have been done.
  126. This version has a 30 day expiration date.
  127.  
  128. * Note 1: Workstation installation is only available when running setup.exe
  129.           from a network installation.
  130.  
  131. * Note 2: The setup program will not install the CTL3Dx, MSVCRT40, or MAPIx
  132.           dll's into the Window's System directory.  This must be done
  133.           MANUALLY, if required.  See section 2.5.1 for more details.
  134.  
  135.  
  136. 2.4.1 - Network Install
  137.  
  138. The setup program will prompt you for the directory where Simeon Mail and its
  139. supporting files (DLL's, system configuration files and so on) should be
  140. installed.  It will prompt you for the components to install:
  141.     
  142.     - Mail only
  143.         - Text reference files
  144.  
  145. Then after selecting and verifying your choices, Simeon setup will install
  146. the requested program files into the selected directory.
  147.  
  148. 2.4.2 - Local PC Install
  149.  
  150. The setup program will prompt you for the directory where Simeon Mail and its
  151. supporting files (DLL's, system configuration files and so on) should be
  152. installed.  It will prompt you for the components to install:
  153.     
  154.     - Mail only
  155.         - Text reference files
  156.         - [ LDUA ] - only if installed to network
  157.  
  158. Then after selecting your choices, you will be asked for a Working directory
  159. in which your local configuration files will reside.  Once you have
  160. verified your selections, Simeon setup will install the requested program
  161. files into the selected directory.
  162.  
  163. The setup program will create the requested directories if necessary, and
  164. then copy the needed files into that directory.
  165.  
  166. 2.4.3 Workstation Installation
  167.  
  168. If you have installed Simeon on a networked drive, each user who access it 
  169. should first run the network setup program and select the Workstation
  170. installation option.  This will install the Simeon configuration components,
  171. and create a program group and icon with the desired working directory.
  172. To run the Workstation installation after Simeon has been installed on the
  173. network, select File->Run from the Program Manager menu and enter the
  174. following:
  175.  
  176. p:\simeon41\setup.exe
  177.  
  178. replacing p:\simeon41 with the network file path where Simeon 4.1.x has been 
  179. installed. The setup will ask for the Simeon 4.1.x program directory on the 
  180. network and ask you to identify the Working (user) directory on the 
  181. workstation.  This can be your V3.x or v4.0.x working directory if you wish.
  182.  
  183. 2.5 Information About DLLs
  184. --------------------------
  185.  
  186. The first thing to know about DLLs in regards to Simeon is that the Simeon
  187. setup program will only install the necessary system DLLs to your system
  188. directories if you are doing a "Local PC" or a "Workstation" install.  If
  189. you are doing a "Network" install, the necessary DLL files will be placed
  190. into the Simeon 4.1.x program directory, but not into your system
  191. directories on the PC hard drive.
  192.  
  193. Simeon requires the presence of several system files in order to function
  194. properly.  The setup program will detect whether a necessary system DLL is
  195. missing, or not up-to-date, and will install replacements as necessary.  If
  196. the setup program is required to replace an already existing DLL file it
  197. will create a copy of the file in the directory where it originated, replacing
  198. the .DLL extension with .SIM, before installing the new version.
  199.  
  200. Any system files that have been replaced will be backed up into the same
  201. directory where they originated, with a .SIM extension.  If for any reason you
  202. wish to restore any of these files, you may do so by renaming them as follows:
  203.  
  204.         if you find:            rename it to:
  205.         ------------            -------------
  206. 16 bit -
  207.         D2HNAV16.SIM            D2HNAV16.EXE
  208.         D2HLNK16.SIM            D2HLNK16.DLL
  209.         MSOUTLIN.SIM            MSOUTLIN.VBX
  210.         D2HTOOLS.SIM            D2HTOOLS.DLL
  211. 32 bit -
  212.         D2HNAV32.SIM            D2HNAV32.EXE
  213.         D2HLNK32.SIM            D2HLNK32.DLL
  214.         MFC30.SIM               MFC30.DLL
  215.         MSVCRT20.SIM            MSVCRT20.DLL
  216.  
  217. Remember that you can run the Simeon setup again to restore the system
  218. DLL files to a state in which the Simeon program can use them.
  219.  
  220. 2.5.1 Manually Installing CTL3Dx, MSVCRT40, and MAPIx DLL's
  221.  
  222. Installation of the CTL3Dx, MSVCRT40, and MAPIx DLL files has become a
  223. complex issue, and one which has required us provide the best option
  224. without infringing on the smooth running of an individual's computer system.
  225. Simeon requires the Window's user to utilize a combination of the above DLL's
  226. (depending on platform).  However, many other programs utilize these DLL's
  227. as well, and it would be presumptuous of us to replace them without knowing
  228. the type of configuration you wished for your system.
  229.  
  230. For this reason, we have moved the installation of these DLL's out of the
  231. installer, and leave that for you to do manually, if you wish.  The
  232. following is a list of instructions on installing these DLL's, and some
  233. comments on why you may or may not wish to install them.
  234.  
  235. 1. In the PROGRAM DIRECTORY of your recently installed version of Simeon,
  236.    you will find the following files:
  237.  
  238.         MS System               Simeon MAPI
  239.         ---------               -----------
  240. 16 bit -
  241.         CTL3D._DL               MAPI.DLL
  242. 32 bit -
  243.         CTL3D32._DL             MAPI.DLL
  244.         MSVCRT40._DL            MAPI32.DLL
  245.  
  246.  
  247.    The MS System files are DEFINITELY required to run Simeon.  If you do
  248.    NOT have these files in your Window's system directory, then you need
  249.    to install them.  The latest version of these files are available on
  250.    with Microsoft Service Packs and often with the latest Microsoft software.
  251.    We provide them for your convenience.  Though they may not always be the
  252.    latest and greatest, they should work with your system.
  253.  
  254.    The Simeon MAPI files are necessary if you require MAPI capabilities.
  255.    Windows 95/NT provide MAPI support with the OS install.  Other
  256.    networking software either utilize the Microsoft MAPI, or provide their
  257.    own.  In any case, you will need to decide which MAPI to use based on
  258.    what software you will be using.  Simeon provides a Simple MAPI DLL with
  259.    Simeon extensions.  If this is not sufficient to run other software you
  260.    need, then you will not want to install the Simeon MAPI.
  261.  
  262. 2. To install the desired DLL file(s), 
  263.  
  264.         Copy from the           
  265.         Simeon Program          To the Window's
  266.         directory:              System Directory
  267.         --------------          ----------------
  268. 16 bit -
  269.         CTL3D._DL               CTL3D.DLL
  270.         MAPI.DLL                MAPI.DLL
  271. 32 bit -
  272.         CTL3D32._DL             CTL3D32.DLL
  273.         MSVCRT40._DL            MSVCRT40.DLL
  274.         MAPI.DLL                MAPI.DLL
  275.         MAPI32.DLL              MAPI32.DLL
  276.    
  277.  
  278. Remember, the question is not one of whether you should have these files
  279. in your Window's system directory, but one of whether you should use
  280. OUR DLL's or stick with the one's you have!
  281.  
  282.  
  283. 3.0 Configuring Simeon Mail
  284. ---------------------------
  285.  
  286. Simeon Mail is designed to support administration at the server and
  287. individual level.  Ideally, one copy of Simeon Mail is stored on a
  288. file server, and all users access the Simeon Mail installation
  289. directory from the network.  Simeon Mail will work equally well in a
  290. standalone installation, but the potential benefits of sharing
  291. configuration information will not be available.
  292.  
  293. Simeon Mail will potentially share many different kinds of configuration
  294. information including:
  295.  
  296. * communication and user preference configurations
  297. * address book information
  298. * multipart message file type Helper Applications
  299.  
  300. Configuration stored in the Simeon Mail installation directory is by
  301. default the "server configuration".  Any configuration
  302. information located in this directory is automatically inherited by
  303. all users.  Most (but not all) information stored in the server
  304. configuration can be overridden by user-specific configuration
  305. information.
  306.  
  307. Each Simeon Mail user is provided with a user configuration directory -
  308. or "Working" directory.  The Working directory contains all of the user's
  309. personal configuration information.  Users can modify any of their
  310. configuration information using the configuration editing facilities
  311. of the Simeon Mail user interface found under the Options/Edit menu.
  312.  
  313. Following is a description of the procedures that the "administrator" 
  314. would use to configure Simeon Mail for use in a TCP/IP workgroup environment. 
  315. Note that if the installation is going onto a single machine (standalone), 
  316. then the installer can be thought of as "the administrator of a workgroup 
  317. of one".
  318.  
  319. 3.1 How Users will Run Simeon
  320. -----------------------------
  321.  
  322. Simeon Mail makes a distinction between the Program directory and the 
  323. Working directory.  The Program directory is the directory containing the 
  324. application and its associated files, which may be either on the user's hard 
  325. disk or on a shared disk.  The Program directory is never written to.  The 
  326. Working directory on the other hand, should be on the user's hard disk. 
  327. It stores information particular to that user, which may include local 
  328. folders, address books, or configuration.  
  329.  
  330. A user will run the Simeon workstation installation program in order to 
  331. configure their PC for use with Simeon.  See the section 
  332. "WorkStation Installation" above.
  333.  
  334. 3.2 Configuring the Windows Environment
  335. ---------------------------------------
  336.  
  337. Simeon Mail is WinSock compliant application that *requires* a
  338. Winsock DLL from your TCP/IP stack. You must make the Winsock 
  339. DLL file from your TCP/IP stack available for Simeon Mail to use.
  340.  
  341. If the Winsock DLL has been installed correctly on your Windows
  342. workstation, this should not be a problem.   To verify that a
  343. "winsock.dll" file is available for use by Simeon Mail, check that
  344. the correct Winsock DLL file is available:
  345.         *1) In a directory specified in the DOS "PATH" variable,
  346.          2) OR in the Windows installation directory,
  347.          3) OR in the Simeon Mail installation directory (INSTDIR).
  348.  
  349. Option #1 is the recommended approach.   The winsock.dll file
  350. that is distributed with the TCP/IP stack should remain in the
  351. stack installation directory, and be included in the DOS PATH.
  352.  
  353. IT IS HIGHLY RECOMMENDED THAT YOU USE THE "OFFICIAL" WINSOCK DLL 
  354. THAT COMES WITH YOUR TCP/IP STACK.  If you don't have a Winsock DLL,
  355. then you should contact your vendor and request one.  If they don't 
  356. have one by this time, you should consider changing TCP/IP vendors.
  357.  
  358.  
  359. 3.3 Simeon Configuration Files
  360. -----------------------
  361.  
  362. 3.3.1  Site Defaults
  363. --------------------
  364.  
  365. When a user runs Simeon Mail, various pieces of information are read
  366. from the site default files in the Simeon program directory.  These files
  367. contain various system-wide defaults that specify such things as message
  368. services, host names and the default user interface settings.  This
  369. information, along with changes the user makes in the course of using
  370. Simeon Mail, are then stored in the user directory under the name
  371. "default.tcl", or optionally to an IMSP server. As a system administrator,
  372. you can customize the site default files for your environment before
  373. providing the application to individual users.  This will allow you to
  374. provide valuable configuration information to your users, simplifying
  375. their job in setting up and running Simeon and thereby your job as well.
  376.  
  377. The site default files are found in the Simeon program directory and are named
  378. sysdflt.tcl and sysdflt2.tcl.  If you are a site administrator it is STRONGLY
  379. recommended that you read both files in their entirety, however the sections
  380. named below are the ones which we feel would be the most likely candidates
  381. for modification prior to distribution.  The files  themselves contain the
  382. complete documentation on the options, their purpose and the possible value
  383. settings.  To modify these files, you may use any text editor.
  384.  
  385. STARTUP DEFAULTS (sysdflt.tcl)
  386. MESSAGE SERVICES (sysdflt.tcl)
  387. DEFAULT FOLDERS (sysdflt.tcl)
  388. AUTHENTICATION (sysdflt.tcl)
  389. HELPER APPLICATIONS (sysdflt2.tcl)
  390.  
  391. 3.3.2 New User Startup Script
  392. -----------------------------
  393.  
  394. When a user runs Simeon for the first time, Simeon executes the TCL script
  395. in the startup.tcl file located in the Simeon program directory. This file may
  396. be customized to add or remove questions which will be asked of the user the
  397. first time he or she runs Simeon.  Many sites typically customize the
  398. sysdflt.tcl file with the server information and remove all of the questions
  399. from the startup script with the exception of the User Name and email address.
  400. For more information on modifying this file, please see the startup.tcl file
  401. itself and the documentation for the corresponding option in the sysdflt.tcl
  402. file.
  403.  
  404. * NOTE: *
  405.  
  406. The sysdflt.tcl from 4.1.1 or earlier may be used with Simeon
  407. 4.1.4, however we do recommend upgrading to the new format for the
  408. following reasons:
  409.  
  410. - one sysdflt.tcl file for all platforms
  411. - customized folder prefix/location settings for Mac and Motif
  412. - additional helper applications for Windows and Motif
  413. - customized settings on a per platform basis
  414. - customized windows sizes and positions for display size
  415. - debug trace stmts. throughout which may be toggled on and off
  416.   easily
  417.  
  418.  
  419. 4.0 Upgrading from Previous Versions
  420. ------------------------------------
  421.  
  422. Please refer to the following documents included in this distribution.
  423.  
  424. See "ECStoV4.txt" for instructions on how to upgrade from ECSMail 2.x to 
  425. Simeon 4.x.x.
  426.  
  427. See "V3toV4.txt" for issues regarding upgrading from Simeon 3.x to 
  428. Simeon 4.x.x.
  429.  
  430. End Simeon 4.1.x Windows/WindowsNT/Windows95 Installation Instructions
  431.