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