home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / ngm175.exe / NGM175.TXT next >
Text File  |  1993-12-03  |  17KB  |  401 lines
  1.  
  2.               NOVELL TECHNICAL INFORMATION DOCUMENT
  3.  
  4. TITLE:              SNADS 20-User Upgrade from v1.0 B to v1.0 C
  5. DOCUMENT ID:        TID200025
  6. DOCUMENT REVISION:  A
  7. DATE:               03DEC93
  8. ALERT STATUS:       Yellow
  9. INFORMATION TYPE:   Symptom Solution
  10. README FOR:         NGM175.EXE
  11.  
  12. NOVELL PRODUCT and VERSION:
  13. SNADS for NetWare Global MHS
  14.  
  15. ABSTRACT:
  16.  
  17. This patch program will upgrade your NGMSNADS 20-user version 1.0 revB to
  18. version 1.0 revC.  This patch program replaces the SNADSL2 and SNADSL3 patches
  19. and will upgrade these patched versions of NGMSNADS v1.0 revC to the latest
  20. revC level.
  21.  
  22. ──────────────────────────────────────────────────────────────────────────────
  23. DISCLAIMER
  24. THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL.  NOVELL
  25. MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.  HOWEVER, THE
  26. INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL
  27. MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
  28. ──────────────────────────────────────────────────────────────────────────────
  29.  
  30. ADDITIONAL CONFIGURATION
  31.  
  32.      Before installing this patch, you must be running NetWare Global MHS
  33.      v2.00b or a subsequent version.  If you have NetWare for Global Messaging
  34.      v1.0 or NetWare Global MHS v2.00, you can obtain the patch for v2.00b
  35.      from any of the following sources:
  36.           *    NetWire 
  37.           *    by sending a message to library@novell with subject: guide
  38.           *    Novell Technical Support
  39.  
  40.  
  41. SYMPTOM
  42.  
  43.      Update needed
  44.  
  45.  
  46. TROUBLESHOOTING
  47.  
  48.      Troubleshooting Hints
  49.      =====================
  50.  
  51.      For detailed troubleshooting instructions, refer to Chapter 8 of the
  52.      NetWare Global Messaging SNADS Protocol Module Administrator's Guide.
  53.      Following are suggestions for troubleshooting common problems.
  54.  
  55.  
  56.      Problem:
  57.      Messages from SNADS are remaining in the NGM queue, with the following
  58.      workgroup name:  -unauthorized-.workgroup
  59.  
  60.      Action:
  61.      This error occurs if you are using a limited-user version of the SNADS
  62.      protocol module. The NetWare Global MHS recipient is not defined as an
  63.      authorized user. Add the user to the list of authorized users, following
  64.      the instructions in Chapter 6 of the guide.
  65.  
  66.  
  67.      Problem:
  68.      The SNADS node is rejecting messages received from the SNADS protocol
  69.      module.
  70.  
  71.      Action:
  72.      Check the maximum number of recipients for which your SNADS node is
  73.      configured. If it is less than 256, add the following parameter to the
  74.      [NGMSNADS] section of your server's NGM.CFG file:
  75.  
  76.           Maximum-Recipients=<nnn>
  77.  
  78.      where <nnn> is the maximum number of recipients your SNADS node will
  79.      accept. For more information about NGM.CFG, refer to Appendix B of the
  80.      guide.
  81.  
  82.  
  83.      Problem:
  84.      Global MHS users are receiving non-delivery notifications that contain no
  85.      explanation of the reason for non-delivery.
  86.  
  87.      Action:
  88.           a.   If you are using a limited-user version of SNADS for Global
  89.                MHS,         make sure the sender has been authorized to send
  90.                messages to SNADS.  Refer to chapter 6 of the "NetWare Global
  91.                Messaging SNADS Protocol Module Administrator's Guide" for
  92.                detailed instructions.
  93.  
  94.           b.   Check for communication problems.  This error occurs if there
  95.                is an unrecoverable communication error while SNADS for Global
  96.                MHS is transmitting a message to the SNADS node.
  97.  
  98.  
  99.      Problem:
  100.      Messages from SNADS are arriving at their destination in binary format. 
  101.      The destination server does not connect to SNADS directly, but through an
  102.      intermediate server.
  103.  
  104.      Action:
  105.           a.   (Recommended solution) In the SNADS directory, do not define
  106.                servers that connect to SNADS indirectly.  Instead, define
  107.                their DGNs as belonging to the server that does connect
  108.                directly.  For example, Server1 connects to SNADS directly;
  109.                Server2 communicates with SNADS through Server1.  Server2 has
  110.                two workgroups, Personnel (SNADS alias=PERSONNE) and Finance
  111.                (SNADS alias=FINANCE).  In the SNADS directory, PERSONNE and
  112.                FINANCE are defined as DGNs at Server1.
  113.  
  114.           b.   If you prefer to define indirectly-connected servers in the
  115.                SNADS directory, ensure that the SNADS alias for the
  116.                directly-connecting server contains the aliases for all servers
  117.                to which it routes messages received from SNADS.  For example,
  118.                if  Server2 (RGN=ACME, REN=SERVER2) is defined in the SNADS
  119.                directory, you must define the following SNADS alias for
  120.                Server1 (RGN=ACME, REN=SERVER1):
  121.  
  122.                ACME.SERVER1,ACME.SERVER2
  123.  
  124.  
  125.      Problem:
  126.      Directory information received from DISOSS is not being integrated into
  127.      the Global MHS database.
  128.  
  129.      Action:
  130.      Ensure that your Global MHS server subscribes to the DISOSS workgroups.
  131.      For more information, refer to Chapter 7 of the guide.
  132.  
  133.  
  134.      General Information
  135.      ===================
  136.  
  137.      This section provides additional information about the SNADS protocol
  138.      module.
  139.  
  140.           *    If a session terminates while the SNADS protocol module is
  141.                delivering a message to SNADS, the SNADS protocol module will
  142.                resend the message during the next session. If the message was
  143.                delivered successfully before the termination occurred, two
  144.                copies of the message might be delivered to the SNADS
  145.                recipient.
  146.  
  147.           *    When a DISOSS user sends a message to a NetWare Global MHS
  148.                distribution list, DISOSS receives a DIA status (delivery
  149.                report) from each of the list members. Since the list member
  150.                names do not match the original recipient name (the
  151.                distribution list), the message status is not updated.
  152.  
  153.      For example, a DISOSS user sends a message to a NetWare Global MHS list
  154.      called "Managers." NetWare Global MHS distributes the message to John
  155.      Smith and Mary Adams, the  list members. DISOSS receives DIA statuses
  156.      from John and Mary, but it does not receive one from "Managers," the
  157.      original recipient. Therefore, it does not update the message status.
  158.  
  159.           *    SMF short names can only include letters, numbers, and the
  160.                following special characters: #, $, and -. To ensure
  161.                compatibility between SNADS and NetWare Global MHS, do not use
  162.                unsupported characters (such as spaces) in SNADS names.
  163.  
  164.           *    If you are using DISOSS Directory Synchronization, workgroups
  165.                in your organization must not include both DISOSS and NetWare
  166.                Global MHS users.
  167.  
  168.           *    SNADS for Global MHS cannot detect the Keyword document
  169.                translation program (DOCXLT) when it is auto-loaded by NGM.  If
  170.                document translations are not being invoked,  unload DOCXLT and
  171.                reload it manually.
  172.  
  173.           *    The Keyword document translation program (DOCXLT) has an
  174.                auto-detection feature that allows it to determine a document
  175.                type.  However, this feature might identify a binary file as
  176.                type TEXT, and attempt to convert it.  This results in
  177.                corruption of the file.
  178.  
  179.  
  180. SOLUTION
  181.  
  182.      Apply NGM175.EXE
  183.  
  184.  
  185.      Self-Extracting File Name:  NGM175.EXE     Revision:  A
  186.  
  187.      Files Included    Size      Date      Time
  188.  
  189.      \
  190.        NGM175.TXT            (This File)
  191.       RELNOTE.TXT      18628   10-18-93    9:52a
  192.         PATCH.EXE      45928   07-01-93    2:00a
  193.         PATCH.RTP     130667   10-18-93   10:41a
  194.  
  195.  
  196.      Installation Instructions:
  197.  
  198.      TO APPLY THIS PATCH:
  199.      ===================
  200.  
  201.      1)   Delete PATCH.* from the NGM\BIN directory if you have applied
  202.           previous NGM patches.
  203.      2)   Copy the files PATCH.EXE and PATCH.RTP to your NGM\BIN subdirectory.
  204.      3)   Change directories to your NGM\BIN directory.
  205.      4)   Make a backup copy of the following NGMSNADS 1.00b files:
  206.  
  207.           NGMSNADS.NLM   (dated 01-08-93 ;   2697 bytes in size)
  208.           SNADSCON.NLM   (dated 01-11-93 ; 139059 bytes in size)
  209.           SNADSRUN.NLM   (dated 02-09-93 ; 276448 bytes in size)
  210.           SNADUINS.NLM   (dated 01-07-93 ;   2539 bytes in size)
  211.           SNADSCON.HLP   (dated 01-11-93 ;   3943 bytes in size)
  212.  
  213.      If you have previously applied the SNADSL2 patch, your current NGMSNADS
  214.      files will have the following file statistics:
  215.  
  216.           NGMSNADS NLM      2722 08-11-93   4:06p
  217.           SNADSCON NLM    161456 08-11-93   4:01p
  218.           SNADSRUN NLM    289732 09-08-93   5:18p
  219.           SNADUINS NLM      3005 08-03-93   4:04p
  220.           SNADSCON HLP      6686 06-29-93  11:24a
  221.  
  222.      If you have previously applied the SNADSL3 patch, your current NGMSNADS
  223.      files will have the following file statistics:
  224.  
  225.           NGMSNADS NLM      2722 08-11-93   4:06p
  226.           SNADSCON NLM    161456 08-11-93   4:01p
  227.           SNADSRUN NLM    289865 09-22-93   5:56p
  228.           SNADUINS NLM      3005 08-03-93   4:04p
  229.           SNADSCON HLP      6686 06-29-93  11:24a
  230.  
  231.      5)   Run the program PATCH.EXE (with no parameters).
  232.      6)   If the patch succeeds, delete PATCH.EXE and PATCH.RTP.
  233.  
  234.      The resulting NGMSNADS files will have the following file statistics:
  235.  
  236.           NGMSNADS NLM      2722 08-11-93   4:06p
  237.           SNADSCON NLM    161456 08-11-93   4:01p
  238.           SNADSRUN NLM    289977 10-14-93  12:28p
  239.           SNADUINS NLM      3005 08-03-93   4:04p
  240.           SNADSCON HLP      6686 06-29-93  11:24a
  241.  
  242.      7)   If the patch fails, restore the files backed up in Step 4 and
  243.           contact Novell Technical Support for additional help.
  244.  
  245.  
  246.      Solution Specifics:
  247.  
  248.      Features
  249.      ========
  250.  
  251.      The SNADS protocol module provides the following features:
  252.  
  253.           *    Transfers messages between NetWare Global MHS and SNADS
  254.                endpoints using an existing SNA network.
  255.  
  256.           *    Provides support for the SNA communications protocols.
  257.  
  258.           *    Supports connections via direct token ring, ethernet, or SDLC
  259.                to an SNA wide area network.  (Note that the connection
  260.                parameters for ethernet are the same as the connection
  261.                parameters for token ring).
  262.  
  263.           *    Supports one or more LU6.2 sessions and up to two PU2.0 or 2.1
  264.                connections.
  265.  
  266.           *    Supports automatic directory synchronization between DISOSS and
  267.                NetWare Global MHS.
  268.  
  269.           *    Supports SMF extended addresses.
  270.  
  271.           *    Allows you to choose whether header information (such as To:,
  272.                From:, Subject:, cc:, and Date:)  will be included in messages
  273.                sent to SNADS.
  274.  
  275.           *    Allows you to choose whether original messages will be included
  276.                in messages replied to by       SNADS users.
  277.  
  278.  
  279.      Extended Address Support
  280.      ========================
  281.  
  282.      A new feature in SNADS for NetWare Global MHS allows SNADS users to
  283.      include SMF extended addresses in messages sent to NetWare Global MHS.
  284.      Because SNADS users can now include address extensions in their messages,
  285.      the Global MHS server administrator no longer needs to define users with
  286.      extended addresses in the SNADS Auto-Registration Table.
  287.  
  288.      Some environments, such as fax and X.400, require special address
  289.      information. To support these environments, the SMF protocol contains an
  290.      extended address field. For example, to send a message to Sharon
  291.      Carstairs through a fax gateway, a NetWare Global MHS user would address
  292.      the message to Sharon Carstairs@FaxGate {Fax:1-555-1234/Sharon
  293.      Carstairs}.
  294.  
  295.      However, SNADS does not support extended addresses. To enable SNADS users
  296.      to send to these environments, the SNADS protocol module allows SNADS
  297.      users to include extended addresses in their messages.
  298.  
  299.      SNADS users can enter extended addresses in one (and only one) of the
  300.      following three locations: at the beginning of the message; in the
  301.      subject; or at the beginning of the document. The SNADS protocol module
  302.      scans these three locations in the order in which they are listed. If it
  303.      finds an extended address in one of these locations, it will ignore any
  304.      extended addresses in the others.
  305.  
  306.      An extended address definition begins with two open angle brackets (<<)
  307.      and ends with two closed angle brackets (>>). Between the beginning and
  308.      ending markers are one or more address extensions, separated by one or
  309.      more spaces. Thus, the syntax of the extended address definition is as
  310.      follows:
  311.  
  312.           <<extension definition(s)>>
  313.  
  314.      Each extension definition has one of the following formats:
  315.  
  316.           dgn.den={extended address}
  317.  
  318.           dgn.den=(extended address)
  319.  
  320.           dgn.den="extended address"
  321.  
  322.      where dgn.den is a recipient specified in the address (TO and CC) fields.
  323.      The extended address can be enclosed in braces, parentheses, or double
  324.      quotation marks.
  325.  
  326.      If a message has only one recipient, the dgn.den= can be omitted from the
  327.      extended address definition.
  328.  
  329.      For example,  Pam Pratt is a SNADS user who wants to send a message to
  330.      Sharon Carstairs. Messages for Sharon are routed through NetWare Global
  331.      MHS to a fax gateway. Pam creates the following message:
  332.  
  333.           TO:       FAXGATE.SCARSTAI
  334.  
  335.           SUBJECT:  <<{Fax:1-555-1234/Sharon Carstairs}>>
  336.  
  337.      Because the message is addressed to only one user, Pam does not include
  338.      the dgn.den=.
  339.  
  340.      Consider a second example. Pam Pratt wants to send a message to Sharon
  341.      Carstairs, Jack Smith, a Global MHS user, and Donna White, an X.400 user.
  342.      Messages for Donna are routed through NetWare Global MHS to an X.400
  343.      Gateway.  Pam creates the following message:
  344.  
  345.           TO:  FAXGATE.SCARSTAI
  346.                NEWYORK.JSMITH
  347.                X400GATE.DWHITE
  348.  
  349.           SUBJECT:  Monthly Update
  350.  
  351.                <<
  352.  
  353.                FAXGATE.SCARSTAI={Fax:1-555-1234/Sharon Carstairs}
  354.  
  355.                X400GATE.DWHITE={X400:C=US;A=Publicmail;P=ABC;O=ABC;
  356.                G=Donna;S=White}
  357.  
  358.                >>
  359.  
  360.                Sharon and Donna:  The update will be delayed one day.  We will
  361.                be sending it tomorrow.
  362.  
  363.      Because the message is addressed to more than one user, Pam must include
  364.      the dgn.den=.
  365.  
  366.  
  367.      SNADS Protocol Module Training
  368.      ==============================
  369.  
  370.      Self-paced study course #1760, titled Administering SNADS for NetWare
  371.      Global MHS, is available. NetWare Global MHS training course #750
  372.      provides comprehensive instruction in installation, configuration, and
  373.      administration of the NetWare Global MHS software.
  374.  
  375.      For more information about either of these training courses, call (800)
  376.      233-3382 or (801) 429-5508, or contact your local Novell authorized
  377.      education center.
  378.  
  379.      Contacting Novell Messaging Technical Support
  380.  
  381.      Should you need technical support for NetWare Global MHS, contact your
  382.      Novell reseller, or Novell at (800) NETWARE or (801) 429-5588.
  383.  
  384.           ******************************************************
  385.  
  386.      Novell, Inc. makes no representations or warranties with respect to this
  387.      software patch, and specifically disclaims any express or implied
  388.      warranties of merchantability, title, or fitness for a particular
  389.      purpose.
  390.  
  391.      Distribution of this patch is forbidden without the express written
  392.      consent of Novell, Inc.  Novell reserves the right to discontinue
  393.      distribution of this software patch.
  394.  
  395.      Novell will not be responsible for any data loss that may result from
  396.      implementing this patch.  Novell strongly recommends a backup be made
  397.      before any patch is applied.   Technical support for this patch is
  398.      provided at the discretion of Novell.
  399.  
  400.           ******************************************************
  401.