home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / ngm192.exe / README.UPG < prev    next >
Text File  |  1994-05-25  |  35KB  |  701 lines

  1.  
  2.            ┌───────────────────────────────────────────────────┐
  3.            │                                                   │
  4.            │                NetWare Global MHS                 │  
  5.            │              Upgrade 2.0C for NW4.01              │
  6.            │                   May 23, 1993                    │  
  7.            │                                                   │  
  8.            └───────────────────────────────────────────────────┘
  9.  
  10.  
  11.                    UPGRADING FROM NGM v2.0b to v2.0c
  12.                    _________________________________
  13.  
  14.  
  15. This file describes the steps required to upgrade NetWare Global
  16. MHS from version 2.0b to version 2.0c.
  17.  
  18. This upgrade provides the following changes:
  19.  
  20.     1. Illegal Memory Access:
  21.  
  22.        o   NGMINS and NGMDEINS were passing a memory block
  23.            without calling InitScratchMemory.
  24.        o   NGMEXTRC was trying to initialize an invalid handle
  25.            which is no longer used.
  26.        o   NGMUPGRADE was passing an absolute pointer to create 
  27.            screen. This pointer is not valid in the upgraded NUT.NLM.
  28.        o   NGMADMIN was allocating memory using malloc and was 
  29.            trying to deallocate it using FREE() instead of free().
  30.        o   NGMADMIN abended when deleting a gateway host. This problem
  31.            was resolved by checking the pointer to the gateway host name
  32.            before deleting it.
  33.        o   NGMSMF abended when adding a new application.
  34.            Problem resolved by passing the correct pointer to application
  35.            record.
  36.  
  37.    2. Unreleased Resources:
  38.        
  39.       o    When any module is loaded with -s option CreateScreen
  40.            allocates memory . This memory was not released when
  41.            the module was unloaded. Modified the modules DSYNC.NLM,
  42.            NGM.NLM, NGMEXTRC.NLM, NGMSMF.NLM to use DestroyScreen()
  43.            to release the memory.
  44.   
  45.    3. Misbehaviours:
  46.  
  47.       o   CMP now checks, during updates, that a deletion record's master
  48.           host and the original record's master host are the same.
  49.           This fixes the missing link problem.
  50.       o   Fixed PMR: Deleting a record did not generate opcode (Delete)
  51.           in an ASCII CMP message. Check is made against PL_DESTROY instead
  52.           of PL_DELETE.
  53.  
  54.  
  55.  
  56.    *NOTE*  This patch is designed to upgrade NetWare Global Messaging
  57.            v2.0b to v2.0c.  If you have a version other than an official
  58.            red box or patched version of NGM2.0b, this upgrade will not work.
  59.            To determine your current NGM version, type 'load MODULES' at the
  60.            server console prompt and verify that the version number for
  61.            'NGMADMIN.NLM' is v2.0b.  If you have any other version, contact
  62.            your local Novell representative to receive the appropriate upgrade
  63.            for your system.
  64.  
  65.  
  66.  
  67.                    WHAT DO YOU NEED TO DO FIRST?
  68.                    _____________________________
  69.  
  70. Use this upgrade to modify an existing NetWare Global MHS installation. 
  71. Before you install this upgrade, verify that you have an official release
  72. of NetWare Global MHS v2.0b installed on your system.  For information on
  73. installing NetWare Global MHS, refer to your "Installing NetWare Global
  74. Messaging" manual, part number 100-001200-001.
  75.  
  76.  
  77.  
  78.                      WHICH FILES ARE UPGRADED?
  79.                      -------------------------
  80.  
  81. This upgrade changes the following files.  
  82.  
  83.         1.  NGM.NLM
  84.         2.  NGMSMF.NLM
  85.         3.  NGMAMP.NLM
  86.         4.  NGMADMIN.NLM
  87.         5.  NGMINS.NLM
  88.         6.  NGMEXTRC.NLM
  89.         7.  NGMDEINS.NLM
  90.         8.  NGMUPGDE.NLM
  91.         9.  NGMDSYNC.NLM
  92.  
  93. This upgrade does not change the serial number and maximum number
  94. of licensed users for your NetWare Global MHS installation. 
  95.  
  96.  
  97.  
  98.              INSTRUCTIONS FOR INSTALLING GMHS ON NETWARE 4.01
  99.              ________________________________________________
  100.  
  101.  
  102. Please read this entire document before starting an installation of
  103. GMHS on your NetWare 4.01 server.
  104.  
  105. This GMHS patch for NW 4.01 works in Bindery Emulation mode ONLY.
  106.  
  107. The following installation procedures MUST be followed to successfully
  108. install and configure GMHS on a NW 4.01 server.
  109.  
  110. This patch version must be loaded ONLY on NW 4.01 (not 4.0) and you
  111. must use the CLIB and Btrieve specified in this document. 
  112.  
  113.  
  114. Installing and configuring GMHS on a NW 4.01 server requires the following:
  115.  
  116.    1. GMHS 2.0b software for NW 3.12        (Redbox or patch release)
  117.    2. GMHS 2.0c patch for NW 4.01           (Located on NetWire)
  118.    3. Proper versions of CLIB and BTRIEVE   (Located on NetWire)
  119.  
  120. *NOTE*     These files can be found on NetWire in the following locations:
  121.  
  122.               BTRIEVE  -  NOVLIB Library 7 BTR61.EXE
  123.                           BTRIEVE.NLM version 6.10C dated November 19, 1993.
  124.               (DO NOT use the CLIB version which is included in
  125.                            this self-extracting archive)
  126.  
  127.               CLIB     -  NOVLIB Library 4 LIBUP2.EXE
  128.                           CLIB.NLM version 4.01D dated February 24, 1994.
  129.  
  130.  
  131. Please make sure you have the installation media, the patch software,
  132. and proper CLIB and Btrieve software, prior to proceeding with the
  133. installation and configuration of GMHS on your NW 4.01 server.
  134.  
  135.  
  136.  
  137.                 USER ADMINISTRATION/ACCOUNT MANAGEMENT
  138.                 ______________________________________
  139.  
  140.  
  141. This section describes the guidelines for setting up and managing MHS mailbox
  142. accounts given the interaction between NDS and the Global MHS directory 
  143. through the bindery emulation.  This section assumes the reader is familiar
  144. with and understands bindery emulation and NDS.
  145.  
  146. For a successful installation, it is very important to take the time to
  147. understand this section and understand the operation of your MHS application.
  148.  
  149.  
  150.  
  151.                           APPLICATION ISSUES
  152.               __________________
  153.  
  154.  
  155. Most MHS applications have been developed with NetWare 3.x in mind.  This means
  156. the applications may make certain assumptions about bindery use, traditional
  157. NetWare 3.x directory structures etc..  In determining how you will administer
  158. and manage the system, you must take into account how the application is
  159. affected by your system configuration.  The following lists some of the known
  160. issues that you should understand before starting.  Please contact your MHS
  161. application provider's documentation and/or tech support group to confirm these
  162. items before you start.
  163.  
  164.    1.    Some applications make use of the SYS:\MAIL\<userid> directory structure
  165.         that was part of the NetWare 3.x system.  NetWare 4.01 does not behave
  166.         thevsame in this regard in that it does not provide users access to
  167.         their SYS:\MAIL\<userid> directory by default.  For example, Novell's
  168.         own FirstMail mail application uses the SYS:\MAIL\<userid> directory as
  169.         its default message store.  If you upgrade your system from NetWare 3.x
  170.         to NetWare 4.01, your rights are likely preserved.  If you have done a
  171.         fresh installation of NetWare 4.01, you must ensure that rights are
  172.         properly assigned.
  173.  
  174.    2.    MHS applications vary some in how they locate the \MHS directory tree.
  175.         Most applications use the MV environment variable (see Global MHS
  176.         documentation for details).  If your application uses the MV variable
  177.         you must ensure this variable is properly set in your user's login 
  178.         scripts.  If other methods are used, you must understand how the
  179.         application is affected by the administration interactions described
  180.         below.
  181.  
  182.    3.    Some MHS applications use environment variables to determine what their
  183.         MHS mail address is while others use techniques that involve bindery
  184.         calls.  If the applications use environment variables, then you only
  185.         need to make sure it is properly set as part of the login scripts.  If
  186.         bindery calls are used, then you MUST carefully follow the procedure
  187.         recommended below and MUST NOT use the 'Advanced Configuration' method
  188.         since applications will be unable to determine their mail addresses in
  189.         that case.
  190.  
  191.  
  192.  
  193.  
  194.                   OVERVIEW OF NDS/GLOBAL MHS INTERACTION
  195.                   --------------------------------------
  196.  
  197. Global MHS uses bindery emulation to associate user accounts with physical
  198. mailboxes.  A mailbox account is created by either importing users from the
  199. bindery or by adding users via NGMADMIN.  Whenusing NGMADMIN to add a user,
  200. the utility confirms the existance of the user's account in the bindery. If
  201. there is no bindery user for the account being created, a new bindery entry
  202. is added for the new mailbox account.
  203.  
  204. When using bindery emulation in NetWare 4.01, this Global MHS interaction with
  205. the bindery indirectly introduces some dynamics with NDS.  For instance, if
  206. NGMADMIN is used to create an account forwhich no BINDERY entry exists, a new
  207. bindery entry is created in the bindery context for that server. This causes  
  208. an NDS user object to be created at the same time in the container object
  209. associated with the bindery context.  Conversely, when NWADMIN is used to add
  210. an NDS user object, a bindery entry is created for that user on every server
  211. which uses that bindery context.
  212.  
  213. These two indirect interactions impose some constraints about managing Global
  214. MHS mailbox accounts. Understanding the interaction model is very important to
  215. ensure a successful deployment.  To avoid complex manual administrative 
  216. intervention, there are 5 recommended general guidelines which will help you.
  217. These are summarized in the following bullet points and will be explained in
  218. the following sub-sections.  By following these guidelines, the major features
  219. of Global MHS will work successfully (e.g. bindery import, sender validation,
  220. passive server, etc.).  A more complex manual process can be achieved but is
  221. not recommended since it adversely affects some of the Global MHS features.
  222.  
  223.    o    Each NetWare 4.01 server which acts as either an ACTIVE or PASSIVE
  224.         Global MHS server should use a bindery context which is unique for
  225.         the entire network.
  226.    o    All NDS user accounts which are to have mailbox accounts on a common
  227.         Global MHS server should be in the bindery context which is unique to
  228.         that server.
  229.    o    The Global MHS long-names in the Global MHS directory are independent
  230.         of the NDS names and a consistently applied naming scheme should be
  231.         employed for the Global MHS names.
  232.    o    Global MHS mailbox deletion and NDS user object deletion are
  233.         independent events.  If you delete a mailbox for a user, the NDS
  234.         account and bindery object remain intact.  If you delete an NDS user
  235.         object, the mailbox remains intact (if one was created).  You must
  236.         remember to delete accounts accordingly.
  237.    o    Use consistent methods for adding, deleting, and moving users to avoid
  238.         missing steps that might cause conflicts in name or account locations.
  239.         This is important because there are multiple ways to add users to the
  240.         system and depending upon the method used, other procedures must follow.
  241.  
  242. If you follow these guidelines, existing bindery dependent applications and all
  243. Global MHS features should work without any problem.  However, you must confirm
  244. application compatibility with your application provider.
  245.  
  246.  
  247.  
  248.                             UNIQUE BINDERY CONTEXTS
  249.                             -----------------------
  250.  
  251. If more than one server shares a common bindery context, the binderies for
  252. those servers will be identical.  That is, user accounts in that context will
  253. receive bindery accounts on each of the servers.  If bindery import is used to
  254. create Global MHS mailboxes and multiple Global MHS servers share the same
  255. context, then each user in that context will end up with multiple mailboxes 
  256. (one on each Global MHS server sharing the same context).  When Global MHS 
  257. synchronizes routes, conflicts can occur.  This conflict will also exist for
  258. a single Global MHS server which is the ACTIVE router for a PASSIVE Global MHS
  259. system.
  260.                
  261.  
  262.               
  263.                      MAILBOX USERS IN THE SAME BINDERY CONTEXT
  264.                      -----------------------------------------
  265.  
  266. When using bindery import in Global MHS, only NDS user objects in the bindery
  267. context for that server will have bindery accounts that can be imported.  NDS
  268. user objects in different bindery contexts will be invisible to Global MHS and
  269. therefore can not be imported.  Therefore, if you want a user's mailbox to 
  270. reside on a particular Global MHS server, that user's NDS account must exist
  271. in the bindery context for the target Global MHS server.
  272.  
  273. If you have an existing NDS structure where users from multiple contexts must
  274. have mailbox accounts on the same Global MHS server, you must alter the NDS
  275. structure.  One way to do this is to move all of the desired users into the
  276. same bindery context as the Global MHS server and then create NDS alias objects
  277. in the contexts where the user account originally was located.  This will allow
  278. the users to continue to log in under their old NDS name (now an alias) while
  279. meeting the requirements for Global MHS to operate.  
  280.  
  281. *WARNING*  If a user is in the wrong context and you create an alias in the
  282.            right context, the desired affect will NOT be achieved!  The actual
  283.            non-aliased NDS object must be in the Global MHS server's context
  284.            in order for a bindery account to be visible to Global MHS.
  285.  
  286. If you choose to create Global MHS accounts using NGMADMIN, bindery accounts
  287. will be created if the user does not exist in that context.  This will create
  288. an NDS account for that user in the bindery context of that Global MHS server.
  289. You will likely want to then use NWADMIN to complete user account.
  290.  
  291.  
  292.  
  293.                        NDS/GLOBAL MHS DIRECTORY STRATEGIES
  294.                -----------------------------------
  295.  
  296. Global MHS maintains a directory of mailbox names.  These logical names are
  297. hierarchical location independent names in the same way that NDS names are
  298. hierarchical and location independent.  Because Global MHS is running in
  299. bindery emulation mode, the Global MHS directory names are totally independent
  300. of the NDS names.  For example, the user Susan Jacobs might have an NDS name
  301. of Susan.Jacobs.Marketing.San Fransisco.Acme and a Global MHS name of Susan
  302. Jacobs @ Marketing.Acme.  When logging into the network, the NDS name is
  303. specified, but Global MHS knows Susan by the Global MHS name only.
  304.  
  305. To avoid confusion, a consistent naming strategy should be employed.  There are
  306. two recommended strategies.  One strategy is to intentionally make the Global
  307. MHS tree and the NDS tree naming conventions unique.  The second strategy is to
  308. make the Global MHS and NDS tree naming conventions identical.  There are pros
  309. and cons to each of these and each installation should decide which strategy is
  310. best.  Either strategy will be compatible with the upgrade for the forthcoming
  311. NetWare 4.x NDS integrated MHS solution.
  312.  
  313. Unique naming conventions can be advantageous when people have selected NDS 
  314. conventions that are excessively long or suggest physical locations or 
  315. administrative partitions.  For example, if you use naming conventions like 
  316. David Peterson.Segment 6.Building 3.Phoenix.Davis Corp, you will likely not
  317. want the user's NDS name to be the mail name.  Rather, you may find David
  318. Peterson@Davis Corp to be more appealing for mail purposes.  Taking advantage
  319. of the independence between Global MHS and NDS naming allows you to construct
  320. flat, concise mail directories while maintaining deeper more descriptive NDS
  321. naming (for network admin purposes).  The disadvantage of this scheme is that
  322. users will be known by two logical names and there is no directly apparent
  323. corelation between NDS name and the Global MHS name (visible via NDS or Global
  324. MHS tools).  This corelation can only be determined by finding the NDS and
  325. Global MHS names which are associated with the same bindery account.
  326.  
  327. Identical naming conventions can be advantageous if you want users to only be
  328. known by one logical name.  For instance, if you want the NDS account Karen 
  329. Woodward.Engineering.Software Guru's to be known as
  330.  
  331.         Karen Woodward @ Engineering.Software Guru's
  332.  
  333. in Global MHS, then identical naming strategies are appropriate.  However, if
  334. the NDS names you have are long complex names which are non-intuitive, then
  335. identical naming may not work well for you.
  336.  
  337. *REMEMBER*  The long name used in Global MHS is independent of the NDS name. 
  338.             If your Global MHS directory tree matches your NDS tree (by 
  339.             manually creating it this way), users will only be created in
  340.             the default bindery context even if the Global MHS name is a 
  341.             different bindery context!!  If you are using aliases to allow
  342.             people to log into different contexts but use a common server for
  343.             mail, you must manually create the NDS alias for the user object
  344.             created in the server's bindery context.
  345.  
  346. For example, you decide to create Jim Grubb @ Engineering.ABC by using NGMADMIN
  347. but the default context for the server is Operations.ABC.  NGMADMIN will create
  348. a bindery account for Jim Grubb which results in an NDS user object
  349. Jim Grubb.Operations.ABC.  To keep the naming consistent, you must remember to 
  350. then use NWADMIN to manually create the alias Jim Grubb.Engineering.ABC and 
  351. associate it with the Jim Grubb.Operations.ABC user object.
  352.  
  353. Conversely, if you want to create users through NWADMIN.  If you decide you
  354. want Jim Grubb to have a mailbox on the server in the Operations.ABC context
  355. and also be listed in the Engineering.ABC context, you must first create the
  356. Jim Grubb.Operations.ABC user object using NWADMIN.  You then create an alias
  357. for Jim Grubb.Engineering.ABC which points to Jim Grubb.Operations.ABC. 
  358. Finally, if you use NGMADMIN to add Jim Grubb you must remember to manually 
  359. set the long name to be Jim Grubb @ Engineering.ABC.
  360.  
  361.  
  362.                                 
  363.                                ACCOUNT DELETION
  364.                    ----------------
  365.  
  366. Global MHS will not delete bindery accounts if the mailbox is deleted through
  367. NGMADMIN.  Generally, this is a desired behavior.  Conversely, if you delete
  368. an NDS user object which has a corresponding Global MHS account, the mailbox
  369. is not deleted.  This may not be the desired behavior since there is no longer
  370. a user associated with the account.  You must remember to delete the Global MHS
  371. account separately from NDS user object deletion.
  372.  
  373.  
  374.  
  375.                            CONSISTENT ADMINISTRATION
  376.                -------------------------
  377.  
  378. The key to success is to employ a consistent administrative process for adding,
  379. moving or deleting users. This will ensure that you don't miss steps or
  380. introduce inconsistency in your naming strategies.  For example, you might 
  381. decide to always add users by first adding them via NWADMIN and    then adding
  382. them through Global MHS bindery import (or NGMADMIN).  Conversely, you might
  383. decide to first create the mailbox account via NGMADMIN and then use NWADMIN
  384. to complete account set-up.  The following are two sample procedures you could
  385. adopt.
  386.  
  387.    User Add Procedure from NDS:
  388.       1.  Add the NDS user object in the bindery context for the Global MHS
  389.           server where the mailbox should reside.
  390.       2.  Create any needed alias for the NDS user object in different
  391.           context(s) if desired.
  392.       3.  Use NGMADMIN to add the mailbox and set the MHS long name according
  393.           to convention used.
  394.  
  395.    Delete User Procedure from NDS:
  396.       1.  Note the MHS long name for the user to be deleted.
  397.       2.  Delete the NDS user alias (if exists).
  398.       3.  Delete the NDS user object.
  399.       4.  Use NGMADMIN to delete the MHS account (noted from step 1).
  400.  
  401.    User Add Procedure from Global MHS:
  402.       1.  Use NGMADMIN to add the MHS user and set the long name according to
  403.           desired convention.
  404.       2.  Use NWADMIN to edit the NDS user object in the context for the Global
  405.           MHS server.
  406.       3.  Use NWADMIN to create any alias for the NDS user object (if
  407.           necessary).
  408.  
  409.    User Delete Procedure from Global MHS:
  410.       1.  Note the NDS account associated with the mailbox to be deleted.
  411.       2.  Use NGMADMIN to delete the MHS account.
  412.       
  413.       *NOTE*  If you do not want to delete the user object, stop at this point.
  414.   
  415.       3.  Use NWADMIN to delete any alias associated with the NDS account noted
  416.           in step1.
  417.       4.  Use NWADMIN to delete the NDS user object noted in step 1.
  418.  
  419.  
  420.  
  421.                             ADVANCED CONFIGURATION
  422.                 ----------------------
  423.  
  424. If you are willing to give up bindery import from Global MHS and do not want
  425. to use sender validation, and if you are unwilling to have the restriction of
  426. all unique bindery contexts for each Global MHS server with all MHS users in 
  427. the same context for that Global MHS server, you can do so.  This is not
  428. recommended because you must understand mailbox access rights controls in
  429. addition to fully understanding the interaction issues of NDS (introducing 
  430. room for manual error).  For those requiring this capability, this section
  431. describes the procedure.
  432.  
  433.  
  434. APPLICATION INCOMPATIBILITY WARNING:
  435.     If you use the following procedure, bindery accounts will not be available 
  436.     will not be available for users in different contexts than the default
  437.     context of the Global MHS server. Applications that use bindery information
  438.     will not work for those users in other contexts.  Refer to the earlier
  439.     section on Application Issues before proceding with this configuration.
  440.  
  441. OPERATIONAL WARNING:
  442.     If you use this process, you must not use bindery import from Global 
  443.     MHS.  Doing so will cause a host of problems.  To reinstate bindery import
  444.     compatibility, you must completely restructure your NDS tree according to
  445.     the constraints listed under the recommended procedure.  Secondly, because
  446.     Global MHS uses bindery file ownership for sender validation, validation
  447.     will not work.  Third, any errors in setting up user rights in the MHS
  448.     directory structure may rendor your Global MHS system inoperable.  Again,
  449.     Novell strongly recommends that you use the procedures listed earlier. This
  450.     information is only being provided as a matter of convenience for highly
  451.     skilled, and advanced MHS users who are willing to accept responsibility
  452.     for proper and fully manual administration.
  453.  
  454.   User Add from NDS:
  455.       1.  Add the NDS user object from NWADMIN in any desired context.
  456.       2.  Use NGMADMIN to add a mailbox account and set the long name according
  457.           to your desired convention.
  458.       3.  Assuming the NDS user object is not in the bindery context for the
  459.           Global MHS server, use NWADMIN to delete the user object that was 
  460.           created when NGMADMIN added the bindery account for the new mailbox
  461.           account.
  462.       4.  User NWADMIN to grant the NDS user object (created in step 1) proper
  463.           rights to the MHS mailbox directory created by NGMADMIN.
  464.           (\MHS\MAIL\USERS\<gmhs short name>).
  465.       5.  Use NWADMIN to grand the NDS user object (created in step 2) proper
  466.           rights to the \MHS\MAIL\SND, \MHS\MAIL\PARCEL, and \MHS trees.
  467.  
  468.           *NOTE* Refer to Global MHS documentation to learn how rights are
  469.                  in the \MHS directory structure.
  470.  
  471.    User Add from Global MHS:
  472.       1.  Use NGMADMIN to add a mailbox account and set the long name according
  473.           to your desired convention.
  474.       2.  Add the NDS user object from NWADMIN in any desired context.
  475.       3.  Assuming the NDS user object is not in the bindery context for the
  476.           Global MHS server, use NWADMIN to delete the user object that was
  477.           created when NGMADMIN added the bindery account for the new mailbox
  478.           account.
  479.       4.  User NWADMIN to grant the NDS user object (created in step 1) proper
  480.           rights to the MHS mailbox directory created by NGMADMIN 
  481.           (\MHS\MAIL\USERS\<gmhs short name>).
  482.       5.  Use NWADMIN to grand the NDS user object (created in step 2) proper
  483.           rights to the \MHS\MAIL\SND, \MHS\MAIL\PARCEL, and \MHS trees.
  484.  
  485.       *NOTE* Refer to Global MHS documentation to learn how rights are assigned
  486.              in the \MHS directory structure.
  487.  
  488.  
  489.  
  490.                                UNRESOLVED ISSUES
  491.                                ------------------
  492.  
  493. This document will be updated pending verification of the following issues:
  494.  
  495.     1. Compatibility with the SNADS protocol module.
  496.     2. Compatibility with the SMTP protocol module.
  497.     3. Compatibility with the Retix X.400 protocol module.
  498.  
  499.  
  500.  
  501.               PROCEDURE FOR INSTALLING GMHS ON NETWARE 4.01
  502.               _____________________________________________
  503.  
  504.  
  505.   Step 1: Verify that the following NW 4.01 configuration parameters
  506.           are set as indicated. GMHS requires these parameters for
  507.       proper installation and operation.
  508.  
  509.               a.  Allow Invalid Pointers = ON
  510.               b.  Read Fault Emulation = ON
  511.               c.  Write Fault Emulation = ON
  512.  
  513.           You can verify this by:
  514.  
  515.               1. Loading SERVMAN.NLM on the system console
  516.               2. Selecting 'Console Set Commands'
  517.               3. Selecting 'Memory' option
  518.  
  519.           If the above three parameters are not set to ON, please
  520.           change them. All three parameters should be turned ON.
  521.  
  522.   Step 2: Establish the Bindery Emulation Context for all users on
  523.           that NW 4.01 server. This is done using NDS administration
  524.           utilities.
  525.  
  526.   Step 3: Add the group EVERYONE to the NDS Container associated with
  527.           the above Bindery Emulation Context.
  528.  
  529.   Step 4: If this context has a user called "Admin" then please rename
  530.           this user to avoid conflicts with GMHS's Admin user that is
  531.           normally associated with the "Supervisor" Bindery user.
  532.           Alternatively, make sure that the GMHS postmaster user is not
  533.           'ADMIN' (can be ADMIN1 for instance) in step 6.
  534.  
  535.   Step 5: Load the following versions of CLIB.NLM and BTRIEVE.NLM:
  536.     
  537.               CLIB.NLM version 4.01D dated February 24, 1994.
  538.               BTRIEVE.NLM version 6.10C dated November 19, 1993.
  539.  
  540.   Step 6: Install GMHS from the media in the GMHS red-box following
  541.           GMHS installation guidelines. If you need to change the name
  542.           of the postmaster user from ADMIN to something else do so at
  543.           this stage.
  544.   
  545.   Step 7: If you use the NGMStart.ncf file to run NGM you must edit
  546.           NGMStart.ncf to have it load the correct versions of CLIB
  547.           and Btrieve, specifying the directories where these new files
  548.           were copied to in step 5.  Do NOT use CLIB and Btrieve installed
  549.           in the NGM\BIN directory by the GMHS install program.
  550.  
  551.   Step 8: Execute the GMHS patch copied down from NetWire.
  552.       (See 'UPGRADING YOUR SERVER', below, for instructions on
  553.            the patch upgrade procedure)
  554.         
  555.   Step 9: Load NGM following the instructions on running NGM.
  556.  
  557.  
  558. *NOTE1* The following message may be displayed on the server console during
  559.         the installation of GMHS v2.0c on a NetWare 4.01 server: 
  560.  
  561.          "Read from a non-present page
  562.           Process:  Pinstall.nlm 0
  563.           Module:  NetWare Server Operating System
  564.           Code offset in module:  FD006A3FH
  565.           Access address:  0000008EH"
  566.  
  567.         This message should not be considered a problem and is to be expected
  568.         for an initial installation of GMHS v2.0c on NetWare 4.01.
  569.  
  570.  
  571. *NOTE2* When this patched NGM.NLM software is loaded, you will see
  572.         the following warning message. 
  573.  
  574.          "This module uses 4 outdated API calls
  575.           You should upgrade to a newer module when it becomes available"
  576.  
  577.         This message is for informational purposes only. This version
  578.         of NGM has been upgraded for NetWare 4. You should ignore this
  579.         warning message.
  580.  
  581.  
  582. *NOTE3* There can be a NetWare problem when several multi-NLM products are
  583.         loaded from AUTOEXEC.NCF.  The primary symptom is the server may
  584.         reboot itself while in the process of loading an NLM of a multi-NLM
  585.         product.  This reboot may repeat several times before the server
  586.         manages to successfully come up with all products loaded.  If you
  587.         experience this symptom and your AUTOEXEC.NCF is loading multi-NLM
  588.         products, remove the LOAD commands for those multi-NLM products from
  589.         AUTOEXEC.  Load those NLMs manually after your server has completed
  590.         its boot procedure.
  591.  
  592.  
  593.  
  594.                           UPGRADING YOUR SERVER
  595.                           ---------------------
  596.  
  597.   Step 1.  Login to your NGM server as supervisor.
  598.  
  599.   Step 2.  Verify that your server has at least 8.0 MB of free hard disk
  600.            space. This is the recommended minimum required to perform this
  601.            upgrade.
  602.  
  603.   Step 3.  The contents of the NetWare Global MHS 2.0C for NW 4.01 patch
  604.            is as follows:
  605.  
  606.               a.  README.UPG
  607.               b.  PATCH.EXE
  608.               c.  PATCHNGM.BAT
  609.               d.  UPGRD20C.RTP
  610.     
  611.   Step 4.  Copy the files 'PATCH.EXE', 'PATCHNGM.BAT', and 'UPGRD20C.RTP'
  612.            to the root NGM directory.  The default NetWare Global MHS
  613.            directory is <Server\Volume:\NGM\>. 
  614.  
  615.            Sample:  COPY PATCH.EXE       <drive>:\NGM\PATCH.EXE
  616.                     COPY PATCHNGM.BAT    <drive>:\NGM\PATCHNGM.BAT
  617.                     COPY UPGRD20C.RTP    <drive>:\NGM\UPGRD20C.RTP
  618.  
  619.            If you installed NetWare Global MHS in some other directory,
  620.            be sure to copy the upgrade files to that directory.
  621.            For example, if NetWare Global MHS is installed in the
  622.            directory <Server\Volume:\PUBLIC\MAIL\NGM\>, enter the following:
  623.  
  624.            Sample:  COPY PATCH.EXE     <drive>:\PUBLIC\MAIL\NGM\PATCH.EXE
  625.                     COPY PATCHNGM.BAT  <drive>:\PUBLIC\MAIL\NGM\PATCHNGM.BAT
  626.                     COPY UPGRD20C.RTP  <drive>:\PUBLIC\MAIL\NGM\UPGRD20C.RTP
  627.  
  628.            The patch program searches down through all subdirectories to find
  629.            the appropriate files to upgrade.  Therefore, it is very important
  630.            to start the upgrade procedure from the correct directory.
  631.  
  632.   Step 5.  Unload NGM at the server console and make a backup copy of your
  633.            NetWare Global MHS Directory structure.
  634.  
  635.            IMPORTANT:  Do not save backup files under the same directory 
  636.                        structure in which you installed NetWare Global 
  637.                        MHS.  The upgrade procedure will update the first 
  638.                        file within the directory structure.  If this 
  639.                        first file happens to be a backup file, then the 
  640.                        correct system file may not be upgraded.
  641.  
  642.   Step 6.  Change to the root NGM directory (where you copied the upgrade
  643.            files).  Enter:
  644.  
  645.                     PATCHNGM
  646.  
  647.            The patch program upgrades all appropriate files.  The patch 
  648.            program also retains a log of the results in a file called
  649.            'RESULTS.TXT'.  To verify your upgrade installation, view the
  650.            contents of 'RESULTS.TXT' after the upgrade is complete.
  651.  
  652.   Step 7.  During the patch process a BACKUP directory is created under
  653.            the directory from which you ran 'PATCHNGM'.  The BACKUP
  654.            directory contains all files that were changed and a file
  655.            called 'UNPATCH.BAK'.  After the patch process has completed
  656.            do NOT delete the BACKUP directory until you are satisfied
  657.            that the upgrade procedure was successful.  If you want to
  658.            undo your upgrade and return your installation to its previous
  659.            state, perform the following procedure.
  660.  
  661.            o To restore your system, change to the BACKUP directory,
  662.              copy 'UNPATCH.BAK' to 'UNPATCH.BAT', and type "UNPATCH".
  663.              This file will delete all new files in the appropriate
  664.              directories and replace them with the files which originally
  665.              existed.
  666.  
  667.            o Verify the original files have been correctly re-installed.
  668.  
  669.            o In order to re-run the patch process, or add additional patches,
  670.              you MUST delete or rename the BACKUP directory first. Otherwise,
  671.              the patch procedure will be unable to create an accurate BACKUP
  672.              of the changes being made during the subsequent upgrade.
  673.       
  674.  
  675.  
  676.   ┌────────────────────────────────────────────────────────────────────────┐
  677.   │                                                                        │ 
  678.   │                             DISCLAIMER                    │
  679.   │                                       │
  680.   │  Novell, Inc. makes no representations or warranties with respect        │
  681.   │  to this software patch, and specifically disclaims any express        │
  682.   │  or implied warranties of merchantability, title, or fitness for        │
  683.   │  a particular purpose.                           │
  684.   │                                       │
  685.   │  Novell's intentions for this software patch is to provide a temporary │
  686.   │  work-around to the anomalies described in this file.  Such        │
  687.   │  work-arounds are typically addressed in future releases of        │
  688.   │  NetWare Global MHS.                           │
  689.   │                                       │
  690.   │  Distribution of this patch is forbidden without the express written   │
  691.   │  consent of Novell, Inc.  Novell reserves the right to discontinue       │
  692.   │  distribution of this software patch.                   │
  693.   │                                       │
  694.   │  Novell will not be responsible for any data loss that may result from │
  695.   │  implementing this patch.  Novell strongly recommends a backup be made │
  696.   │  before any patch is applied.  Technical support for this patch is     │
  697.   │  provided at the discretion of Novell.                    │
  698.   │                                       │
  699.   └────────────────────────────────────────────────────────────────────────┘
  700.    
  701.