home *** CD-ROM | disk | FTP | other *** search
/ New Horizons Shareware Collection / HORIZONS1.BIN / WMINSTAL.INF < prev    next >
Text File  |  1994-07-30  |  21KB  |  442 lines
  1. ---------------------------------------------------------------------------
  2.               WILDMAIL! v3.5/v4.0 Installation Information
  3.                           Date: 07/02/1994
  4. ---------------------------------------------------------------------------
  5.  
  6. Dear WILDCAT! SysOp:
  7.  
  8. We'd like to take this moment to thank you for choosing WILDMAIL! as your
  9. mail tosser for your FTSC mail needs.  We're extremely proud to release
  10. this new release because it incorporates what you as a SysOp has asked for
  11. and does so with a much needed speed increase along with a features list
  12. that easily establishes itself as the leader in FTSC mail processing.
  13.  
  14.  
  15. Installation
  16. ------------
  17.  
  18. WMINSTAL! will be the program that you execute either from the
  19. installation diskette or from a drive/directory of your choice.
  20.  
  21.   BBS Download
  22.   ------------
  23.  
  24.   If you've downloaded this new release from a BBS, you should create a
  25.   temporary directory and uncompress the contents of the distribution
  26.   archive using PKZIP into that directory.
  27.  
  28.   Similar to:      C:                              <Press Enter>
  29.                    MD \tempdir                     <Press Enter>
  30.                    COPY <archive> C:\tempdir       <Press Enter>
  31.                    CD \tempdir                     <Press Enter>
  32.                    PKUNZIP <archive>               <Press Enter>
  33.  
  34.   When choosing a temporary directory to install from, you should NOT use
  35.   one called \WM40, especially of it's on the drive you're attempting to
  36.   install to.  Instead, simply use a different name.  From there you would
  37.   simply execute WMINSTAL from the DOS prompt such as:
  38.  
  39.                    WMINSTAL                        <Press Enter>
  40.  
  41.   and follow the instructions on the screen.  If you're unsure about a
  42.   particular option, position the highlight bar on that field and
  43.   press [F1] for online help information.
  44.  
  45.  
  46.   Installation Diskette
  47.   ---------------------
  48.  
  49.   If you are installing from the installation diskette, you simply
  50.   need to change directories to that drive and type WMINSTAL.
  51.  
  52.   Similar to:      A:                              <Press Enter>
  53.                    WMINSTAL                        <Press Enter>
  54.  
  55.   From here, simply follow the instructions on the screen.  If you're
  56.   unsure about a particular option, position the highlight bar on
  57.   that field and press [F1] for online help information.
  58.  
  59.  
  60. Depending on your installation requirements, this program has up to two
  61. major steps to it.  The first step performs the creation of
  62. subdirectories, moving of files etc.  The second, if so chosen will
  63. convert your previous installation of WILDMAIL! v3 to the new data
  64. structures.
  65.  
  66. Listed below are the available installation types.
  67.  
  68.  
  69. Normal Install
  70. --------------
  71.  
  72. WMINSTAL! will require you to enter the destination drive along with your
  73. primary address as well as the location where you pick up your mail from.
  74. This is typically referred to as your "hub" or "uplink/feed" address.
  75.  
  76. You may begin the installation by pressing [F10] and then after some
  77. initial checking configuration checking, WMINSTAL! will create the
  78. necessary directories and then proceed to uncompress the contents of
  79. WM4FILES.DAT into the \WM40 directory. Once the uncompression process is
  80. complete and the files are moved to their respective directories, a screen
  81. will be displayed indicating the installation is complete and you will be
  82. returned to the previous menu.
  83.  
  84.  
  85. Install/Upgrade
  86. ---------------
  87.  
  88. This process is a combination of a "Normal Install" and an upgrade.  You
  89. would typically select this option if you already have a previous version
  90. of WILDMAIL! and would like to have the datafiles converted over to the
  91. new formats.
  92.  
  93. NOTE:  Only v3.00 thru v3.11 releases of WILDMAIL! can be upgraded with
  94.        WMINSTAL!.  Any of the earlier versions will require you to use the
  95.        upgrade program that came with v3 of WILDMAIL! before using this
  96.        program to perform a second upgrade.
  97.  
  98. From here you need to specify the drive letter where the new WILDMAIL! is
  99. to be installed.  Once that is complete, you will notice that you are no
  100. longer asked for your primary and hub addresses, but instead asked for the
  101. path to where your existing installation of WILDMAIL! is located.  From
  102. here you need to simply specify that path and once you're ready, you may
  103. begin the installation/upgrade process by pressing [F10].
  104.  
  105. Once the initial installation is complete, you will be so informed and
  106. will be presented with a new upgrade screen.  If you wish to abort the
  107. upgrade process, you may do so by pressing the [ESC] key, otherwise you
  108. may begin the upgrade process by pressing [F10].  Once the upgrade process
  109. is complete, you will be returned to the previous menu.
  110.  
  111.  
  112.                      Forward List Definitions
  113.                      ------------------------
  114.  
  115. Due to the new configuration of WILDMAIL!, in order for the upgrade process
  116. to be performed properly, conferences will need to be associated with a
  117. particular network before they may be added to the new configuration.  The
  118. only way to do this is to have whats called  "Forward List Definitions" in
  119. the older version of WILDMAIL!.
  120.  
  121. This option may be found from the Main Menu in WMCONFIG! under:
  122.  
  123.           AreaRequest Manager
  124.                  \         \
  125.                Forward List Definitions:
  126.  
  127. NOTE:  In order to simplify this process, WMINSTAL comes with three
  128.        "pre-configured" echo list definitions.  This also includes three
  129.        configured "network" definitions as well.  These definitions are as
  130.        follows:
  131.                     FIDONET_NA     (uses/includes FIDONET.NA)
  132.                     FIDONET_NO     (uses/includes FIDONET.NO)
  133.                     OCRNET_NA      (uses/includes OCRNET.NA)
  134.  
  135.        If you carry conferences for these particular networks, then you
  136.        won't have to be concerned about locating/defining these forward
  137.        list definitions.  However, you should read the Post Installation
  138.        Notes for additional information.  (see below)
  139.  
  140. Pressing [ENTER] on the Forward List Definitions option presents you with
  141. a list of all the previously defined lists similar to below.
  142.  
  143. ┌──────────────────────────────────────────────────────────────────────────┐
  144. │ WMCONFIG! v1.11        WILDMAIL! v3 Configuration       (Protected Mode) │
  145. └──────────────────────────────────────────────────────────────────────────┘
  146. ╒════════════════════ AreaRequest Manager Information ════════════════════╕░
  147. │                                                                         │░
  148. │ ╒═════════════════════ Forward List Definitions ═════════════════════╕  X░
  149. │ │                                                                    │  ░░
  150. │ │  Network Name               Echo List     Hub Node                 │  ░░
  151. │ │  ─────────────────────────  ────────────  ───────────────────────  │  ░░
  152. │ │  OCRNET                     OCRNET.NA     <Originating Node>       X  ░░
  153. │ │  FIDONET_NA                 FIDONET.NA    <Originating Node>       ▓  ░░
  154. │ │  FIDONET_NO                 FIDONET.NO    <Originating Node>       ░  ░░
  155. │ │                                                                    Y  ░░
  156. │ │                                                                    │  Y░
  157. │ ╘════════════════════════════════════════════════════════════════════╛  │░
  158. ╘═════════════════════════════════════════════════════ PgUp/PgDn for More ╛░
  159. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  160.  F1-Help Alt-V-View F8-Modify ESC-Exit Alt-D-Shell ENTER-Edit INS/DEL
  161.  
  162.  
  163. After selecting the appropriate list, pressing [ENTER] brings up the
  164. definition in edit mode similar to:
  165.  
  166.  
  167. ┌──────────────────────────────────────────────────────────────────────────┐
  168. │ WMCONFIG! v1.11        WILDMAIL! v3 Configuration       (Protected Mode) │
  169. └──────────────────────────────────────────────────────────────────────────┘
  170. ╒════════════════════ AreaRequest Manager Information ════════════════════╕░
  171. │ ╒═════════════════════ Forward List Definitions ═════════════════════╕  X░
  172. │ │  Ne╒══════════════ Edit Forward List Definition ═══════════════╕   │  ░░
  173. │ │  ──│                                                           │   │  ░░
  174. │ │  OC│      Network Name: OCRNET            <- Important field!  X   X  ░░
  175. │ │  FI│         Echo List: H:\WM\OCRNET.NA   <- Important field!  ▓   ▓  ░░
  176. │ │  FI│  Originating Node: Y                                      ░   ░  ░░
  177. │ │    │          Hub Node: 1:161/123.0                            ░   ░  ░░
  178. │ │    │  AreaRequest Name:                                        ░   ░  ▓░
  179. │ │    │          Password:                                        ░   ░  ░░
  180. │ │    │          From AKA: 1122:1/0.0                             ░   ░  ░░
  181. │ │    │ AreaRequest Flags:                                        ░   ░  ░░
  182. │ │    │         Add Nodes:                                        ░   ░  ░░
  183. │ │    │                                                           ░   ░  ░░
  184. │ │    │       Notify text:                                        Y   Y  ░░
  185. │ │    │                                                           │   │  Y░
  186. │ ╘════╘═══════════════════════════════════════════════════════════╛═══╛  │░
  187. ╘═════════════════════════════════════════════════════ PgUp/PgDn for More ╛░
  188. ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  189.   F1-Help F8-Modify F10-Save ESC-Exit Alt-D-Shell
  190.  
  191.  
  192.                 * IMPORTANT * IMPORTANT * IMPORTANT *
  193.                 -------------------------------------
  194.  
  195. These Forward List definitions are REQUIRED in order to perform a
  196. successful upgrade.  Again, it is absolutely IMPERATIVE that they be there
  197. otherwise WMINSTAL! will be unable to convert all of your previous
  198. installation.  If you don't have any defined, please read the following
  199. VERY CAREFULLY and refer to the WM v3.11 documentation as necessary when
  200. creating them.
  201.  
  202. Now having said that, lets explain why.  But first, you should make note of
  203. the two most important fields (annotated above).
  204.  
  205.                      Network Name: OCRNET
  206.                         Echo List: H:\WM\OCRNET.NA
  207.  
  208.  Network Name:
  209.  
  210.  This MUST be filled in with a name containing NO SPACES and must be
  211.  shorter than 20 characters long.  This name will be used as the network
  212.  definition in your new installation.  Typical names might be:
  213.  
  214.                FIDONET_NA       WILDNET_NA       OCRNET
  215.                FIDONET_NO       WILDNET_NO
  216.  
  217.  When defining these names, you should try to use names that are
  218.  representative of the echolist your defining.  In the above examples,
  219.  you'll notice a _NA and _NO protion of the names.  This is used to indicate
  220.  the different echo lists that are associated with FidoNet, WildNet etc.
  221.  
  222.  NOTE:  If you only carry one network (i.e. only a member of FidoNet etc),
  223.         then you will only have 1 Forward List definition, 2 networks - 2
  224.         definitions and so on.  In other words, one definition for each
  225.         networks conferences you carry.
  226.  
  227.  For example, a network name of FIDONET_NA would be used with the echo list
  228.  file called FIDONET.NA and FIDONET_NO used with the echolist called
  229.  FIDONET.NO and so on.
  230.  
  231.  
  232.  Echo List:
  233.  
  234.  This field should be the "echolist" ASCII text file (and complete DOS
  235.  path) which contains a list of all the conferences in this particular
  236.  network.  This file is in a format similar to:
  237.  
  238.         !CHINESE            General topic chatting in Chinese
  239.         12_STEPS            12 Steps Discussion
  240.         4DOS                4DOS ECHO
  241.         60S_70S_PROGROCK    60's/70's Progressive Rock Music Echo
  242.         80XXX               Assembly language programming
  243.         ABLED               disABLED Users Information Exchange.
  244.  
  245.  The above is a sample from the familiar FIDONET.NA file and is formatted
  246.  in 2 basic "columns".   The first being the area name (i.e. - !CHINESE,
  247.  12_STEPS etc) and the second column being the description.  If you don't
  248.  have this file, you should contact your hub for the networks that you
  249.  participate in.
  250.  
  251.  Hint:  WMINSTAL! comes with 3 lists already, FIDONET_NA, FIDONET_NO and
  252.         OCRNET.  Any other smaller networks, you'll definately need those
  253.         echolist files!
  254.  
  255. As mentioned above, the "Network Name:" field contains the network name
  256. WMINSTAL! will use when it reads the contents of the "Echo List:" defined
  257. file and adds all the individual area names to the Master List database in
  258. WMCONFIG!.
  259.  
  260. This database is a culmination of ALL the echo conferences for ALL of the
  261. networks you have defined on your system and will be used when adding new
  262. conferences to WMCONFIG!'s configuration.  You may not be carrying all the
  263. conferences, but they will be added to the Master List database anyway,
  264. remember, this is only a Master List, not your actual configuration.
  265.  
  266. But the key here is that you are associating a network name with a given
  267. conference (area name).  Then any future "adding of conferences" in
  268. WMCONFIG! will draw this area name from the Master List database and adds
  269. it to your configuration and thereby "knows" that this conference (area
  270. name) comes from that network.  While this might seem a little confusing,
  271. bear with us for a little bit longer as it will come a lot clearer once
  272. you see the final results.
  273.  
  274. Okay, now that we've come this far, here's how the actual conversion takes
  275. place:
  276.  
  277.    1)  Create network definitions by reading all the Forward List
  278.        definitions network names and add them to the WMNETS.DAT database
  279.        file.  (Networks database).
  280.  
  281.    2)  Create the Echolist database file using all the echolist file names
  282.        found in the Forward List definitions.  This is a database that
  283.        associates a echolist text file with a given network name.
  284.  
  285.    3)  On a network by network basis, read the contents the networks
  286.        associated echo list file (FIDONET.NA, WILDNET.NA etc) and import
  287.        all the area names along with their descriptions into the Master
  288.        List database file.
  289.  
  290.    4)  Read the old conferences database in WILDMAIL! v3 and if the area
  291.        name exists in the "new" Master List database, add that area name
  292.        to the new WMCONFIG! conferences database using the network name
  293.        from the Master List database as the conferences new network.  If
  294.        it's NOT found in the Master List database, then skip it.
  295.             ^^^^^^^^^
  296.  
  297.                      * IMPORTANT * IMPORTANT * IMPORTANT *
  298.                      -------------------------------------
  299.  
  300.        This is the single most important reason for WMINSTAL! NOT adding
  301.        conferences to your new configuration.  And the reason is that the
  302.        old area name was NOT found in the Master List database which got
  303.        its area names from the Forward List definitions (see step #3).
  304.        This is why the Forward List definitions in the old WMCONFIG! are so
  305.        crutial to a accurate conversion/upgrade.
  306.  
  307.  
  308.    5)  Read the old nodes database and add all the nodes to the new
  309.        WMCONFIG!'s nodes database.
  310.  
  311.    6)  Link all the nodes to their respective conferences and add
  312.        "memberships" to the networks that the node is picking up
  313.        conferences from.  In other words, if the node picks up area:
  314.        !CHINESE, then that node will be a member of FIDONET_NA etc.
  315.  
  316.        A node may be a member in multiple networks, so depending on how
  317.        you have your systems configured, a node my be a member of more than
  318.        one network.
  319.  
  320. Okay, there you have it. <g>   Now that you're probably totally lost, I
  321. think you're going to find that for the most part everything will go rather
  322. easily and shouldn't be too painful.
  323.  
  324. But just bear in mind, if the forward lists are not defined, nothing will
  325. be added to the master List database and consquently, nothing gets
  326. converted over.
  327.  
  328.  
  329. A Complex Upgrade
  330. -----------------
  331.  
  332. The information here is being presented in this high degree of detail
  333. because of the complexity of the conversion process.  What we're trying to
  334. accomplish here is to organize a completely disorganized collection of
  335. area names for various different networks you may be carrying.  This is
  336. certainly no small task by any stretch of the imagination and is equally
  337. difficult to program for.
  338.  
  339. However, the hardest part for you is just to make sure the Forward Lists
  340. are properly defined and WMINSTAL! will do the rest.  We've provided a log
  341. file that keeps track of everything that WMINSTAL! did, so this should
  342. hopefully help make sense out of everything.  If all else fails, you can
  343. always call for technical support.
  344.  
  345.  
  346. Install/Upgrade Logging
  347. -----------------------
  348.  
  349. WMINSTAL! keeps track of all the processes it goes through and maintains a
  350. ASCII text log file for your reference.  You may view the contents of this
  351. file by selecting the main menu option "Result from Install/Upgrade". From
  352. here you may use the normal PgUp/PgDn keys to view the file. Pressing the
  353. [ESC] key returns you to the main menu.
  354.  
  355.  
  356. Post Installation Steps
  357. -----------------------
  358.  
  359. As with any automated upgrade process, you should always go back and
  360. verify that the information was converted correctly and make the necessary
  361. changes as needed.
  362.  
  363. Due to the structure differences between the old and new versions, there
  364. has been a "casualty" that can't be reliably converted over. Specifically,
  365. you will have to go back and re-define all your "flags" for both
  366. conferences and nodes (used for AreaRequest).  By using the Global Modify
  367. options, you can easily add these back in, but you should know that you'll
  368. need to before being able to rely on them again.
  369.  
  370. You should also go back and adjust the addresses on ALL of your network
  371. definitions and verify they are correct.  The default ones of FIDONET_NA,
  372. FIDONET_NO and OCRNET will be set to a best guess value.  In order to have
  373. AreaRequest operate properly, you'll need to check these!
  374.  
  375.  
  376. Version Differences
  377. -------------------
  378.  
  379. Since the new database structures have changed with the new v4 of
  380. WILDCAT!, WILDMAIL! now comes in two distinctive flavors.
  381.  
  382.    v3.50    This version incorporates all the new features of WILDMAIL!
  383.             v4.00 but has been modified to work with the earlier releases
  384.             of WILDCAT! (circa v3.5-v3.91).  This will not work with the
  385.             WC4 series.
  386.  
  387.    v4.00.  This version incorporates all the new changes and fully supports
  388.            WILDCAT! v4.00.  This version not work with WC3 series.
  389.  
  390. Since both programs are nearly identical (the only difference being the
  391. database structures), you can very easily switch versions of WILDMAIL!
  392. (between v3.50 and v4.00) by simply using the appropriate WM.EXE/OVR,
  393. WMCONFIG.EXE/OVR and WMUTIL.EXE file.
  394.  
  395. If you do switch versions of WILDMAIL! (between v3.5 and v4.0) besides
  396. replacing the files, you will need to go back into WMCONFIG! and change
  397. the path to the WILDCAT! home directory as necessary.  Other than that,
  398. those are the only changes necessary.
  399.  
  400.  
  401. 30 Day Evaluation Keys
  402. ----------------------
  403.  
  404. If you are installing WILDMAIL! for the first time for evaluation (You
  405. haven't registered the program yet), before you can execute the actual
  406. WM.EXE file, you will need to download a 30 day evaluation key file from
  407. the support BBS.  The phone number is:
  408.  
  409.                      (707) 552-0602 - 28.8Kbps
  410.  
  411. You should log on and select the Main menu option #3, 30 Day Eval Keys and
  412. follow the instructions as they're presented.  Once you've downloaded the
  413. file, you should uncompress it and copy the WM.ID file into the new \WM40
  414. directory.
  415.  
  416. If you have already downloaded a evaluation key for an earlier release of
  417. WILDMAIL!, the entire evaluation keys database has been reset so you may
  418. come back and get another one.
  419.  
  420.  
  421. Upgrading/Registering WILDMAIL!
  422. -------------------------------
  423.  
  424. Since we are coming out with two releases at the same time to work with
  425. both the new and older versions of WILDCAT!, we have used a numbering
  426. scheme that some may find confusing.  Since you will only be able to order
  427. the upgrade to WILDMAIL! v4.00, you will not be able to purchase v3.50 as
  428. a separate version.
  429.  
  430. Instead, upon ordering WILDMAIL! v4.00 (either the upgrade or new), you
  431. will automatically receive both v3.50 and v4.00 to work with the
  432. appropriate version of WILDCAT! you are running.  So by ordering v4.00,
  433. you will actually receive 2 separate copies of WILDMAIL!.
  434.  
  435. You may register/upgrade WILDMAIL! by using our toll free order line by
  436. dialing:
  437.                    1-800-39-EMAIL   (1-800-393-6245)
  438.  
  439. You may also fill out the REGISTER.DOC file which is located in your \WM40
  440. directory and mail it off to the address listed.
  441.  
  442.