home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / nip318.exe / NIP318.TXT
Text File  |  1995-10-02  |  21KB  |  535 lines
  1. NOVELL TECHNICAL INFORMATION DOCUMENT
  2.  
  3. TITLE:  NIP318.EXE; NetWare/IP 1.1 Maintenance
  4. README FOR:  NIP318.EXE
  5.  
  6. NOVELL PRODUCTS and VERSIONS:
  7. NetWare/IP 1.1
  8.  
  9. ABSTRACT:
  10.  
  11. NIP318.EXE contains a patch for NetWare/IP 1.1 (for NetWare 3.12
  12. and 4.02 servers ONLY).  Includes both fixes and enhancements
  13. including support for new parameters. NIP318 is strongly
  14. recommended for all NetWare/IP 1.1 sites with NetWare 3.12 and
  15. NetWare 4.02, and supersedes all previous patches to NetWare/IP
  16. 1.1 for NetWare 3.12 and NetWare 4.02, including special compiled
  17. versions.
  18.  
  19.  
  20.  
  21. -----------------------------------------------------------------
  22.  DISCLAIMER
  23.  THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO
  24. NOVELL.  NOVELL MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY
  25. THIS INFORMATION.  HOWEVER, THE INFORMATION PROVIDED IN THIS
  26. DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL MAKES NO EXPLICIT
  27. OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
  28.  
  29. -----------------------------------------------------------------
  30.  
  31.  
  32. SYMPTOM:
  33.  
  34. 1. Server crash due to memory corruption.
  35.  
  36.  2. Badly formatted output for "stat", etc., when running on
  37. NetWare 3.12.
  38.  
  39.  3. Hanging with NetWare 3.12 on a NetFrame machine.
  40.  
  41.  4. Not showing all RIPs and SAPs.
  42.  
  43.  5. Client received network errors and was unable to login to
  44. servers.
  45.  
  46.  6. On a heavily loaded machine, NWIP/IPX gateway could not
  47. resolve SAP/RIP information for NWIP client. 
  48.  
  49.  7. Server abends resulting from truncated DNS packets.
  50.  
  51.  8. NWIP client unable to get a NWIP parameter over a slow link.
  52.  
  53.  9. Cache timeouts.
  54.  
  55.  10. Server hangs while unloading NAMED.NLM.
  56.  
  57.  11.  Failure to create an accurate replica database (a local
  58. copy of the zone database imported from the master/primary DNS
  59. server), an invalid response to Start of Authority (SOA) and Name
  60. Server (NS) queries.
  61.  
  62.  12. If SAPs were received at too fast a rate, some where
  63. dropped.
  64.  
  65.  13. When NetWare DNS was a DNS replica, unexpected responses
  66. from the master, resulted in repeated queries leading to a
  67. timeout.
  68.  
  69. SOLUTION: 
  70.  
  71. - Apply NIP318.EXE as described below.
  72.  
  73.  - In addition, for symptom number 11, update the Domain Name
  74. Server.
  75.  
  76.  To Update the Domain Name Server
  77.  --------------------------------
  78.  The NAMED.NLM included in NIP318.EXE contains a fix for servers
  79. that use the old NAMED.NLM that came with NFS Gateway 1.1/1.2 and
  80. NetWare/IP 1.1.  Therefore, Domain Name only requires updating on
  81. servers that use the NAMED.NLM replica function.
  82.  
  83.  1. After installing NIP318.EXE according to the directions
  84. below, do ONE of the following:
  85.  
  86.  -- A. Manually delete the zone database file on the DNS replica
  87. servers.  To locate the zone database file on the servers, search
  88. for the entry that begins with the keyword "secondary" in
  89. SYS:ETC/NAMED.CFG.  After you delete the zone database file, load
  90. the new NAMED.NLM.
  91.  
  92.  For example, in the entry:  SECONDARY FOO.COM
  93. 1.2.3.SYS:ETC/DNS/ZONE.DB
  94.  the zone database file is ZONE.DB.
  95.  Then go to the SYS:ETC/DNS/ directory and delete ZONE.DB.
  96.  
  97.  -- B. Manually edit the serial number field in the SOA record
  98. for the zone at the master name server to increment the number by
  99. one digit. To locate the file to edit, search for the entry that
  100. begins with the keyword "primary" in the SYS:ETC/NAMED.CFG file.
  101.  
  102. Self-Extracting File Name: nip318.exe
  103.  
  104. Files Included     Size     Date      Time
  105.  
  106. ..\
  107.       NIP318.TXT     (This file)
  108. ..\NWIP1\
  109.      PCONFIG.DAT             950         4-21-95     11:00:42 am
  110.      PCONFIG.HLP            2183         7-29-92      1:27:20 pm
  111.      PCONFIG.NLM           15934         9-17-93      6:03:06 pm
  112.       PFILES.DAT            2589         5-26-95      1:56:52 pm
  113.     PINSTALL.HLP            6798         6-21-93      2:53:24 pm
  114.     PINSTALL.NLM          132824         3-21-94     11:45:58 am
  115.     P_UNINST.HLP             892         7-27-92     12:02:08 pm
  116.     P_UNINST.NLM           72042         11-8-93      6:40:06 pm
  117.       README.TXT           31214         9-29-95      3:47:38 pm
  118.        SPACE.DAT              10          2-1-93      3:58:28 pm
  119. ..\NWIP1\PUBLIC\
  120.      NWIPMAP.E11          140433         9-28-93      2:30:42 pm
  121.      NWIPMAP.EXE          288277         3-21-95      8:07:18 pm
  122. ..\NWIP1\PUBLIC\NLS\
  123.     1252_UNI.001             727         5-31-94     11:39:46 am
  124.      437_UNI.001             727          4-4-94     11:22:20 am
  125.      850_UNI.001             727          4-4-94     11:22:24 am
  126.     UNI_1252.001            2264         5-31-94     11:39:48 am
  127.      UNI_437.001            2904          4-4-94     11:22:24 am
  128.      UNI_850.001            2776          4-4-94     11:22:28 am
  129.      UNI_COL.001            1752          4-4-94     11:22:18 am
  130.      UNI_MON.001            4312          4-4-94     11:22:18 am
  131. ..\NWIP1\PUBLIC\NLS\ENGLISH\
  132.      NWIPMAP.M11            3401         8-24-93      3:58:18 pm
  133.      NWIPMAP.MSG            7821         8-24-93      3:58:18 pm
  134. ..\NWIP1\PUBLIC\NLS\NWIP11\
  135.     1252_UNI.001             745         1-26-93      5:10:24 pm
  136.      437_UNI.001             818         1-26-93      4:57:46 pm
  137.      850_UNI.001             837         1-26-93      4:57:56 pm
  138.     UNI_1252.001             733         1-26-93      5:10:32 pm
  139.      UNI_437.001             977         1-26-93      4:57:56 pm
  140.      UNI_850.001             906         1-26-93      4:58:06 pm
  141.      UNI_COL.001            1063         1-23-93      2:24:24 pm
  142.      UNI_MON.001            1406         1-23-93      2:23:46 pm
  143. ..\NWIP1\SYSTEM\
  144.          DSS.NLM           92553         3-25-95     11:01:22 am
  145.        NAMED.NLM           52092         5-26-95      3:43:02 pm
  146.        NETDB.NLM           57940          3-8-94      2:25:02 pm
  147.         NWIP.NLM          124044         5-12-95      6:35:38 pm
  148.      NWIPADM.HLP           10796         4-19-95      4:12:48 pm
  149.      NWIPADM.NLM           53338         4-27-95     12:04:20 pm
  150.      NWIPAGT.NLM           10625         4-20-95      6:44:28 pm
  151.  
  152.  
  153. Installation Instructions:
  154.  
  155. CAUTION: Do not delete all of the original NWIP 1.1 software from
  156. the server.  NIP318 replaces only some of the NWIP1.1 files.
  157.  
  158.  1. Backup your current NetWare/IP files.
  159.  
  160.  2. At a the console of a server that already has NetWare/IP 1.1
  161. installed,
  162.  create a new directory named NIP318 on any valid NetWare volume.
  163.  MD NIP318
  164.  
  165.  3. Copy NIP318.EXE into the new directory.
  166.  
  167.  4. Type NIP318 <enter> to extract the files.
  168.  
  169.  5. From the server console, activate the installation program by
  170. typing:  LOAD INSTALL  <enter>
  171.  
  172.  6. Select PRODUCT OPTIONS.
  173.  The Currently Installed Products Menu appears and lists the
  174. following
  175.  products:
  176.      NWIP    1.1    NetWare/IP
  177.      NWUPD   1.1B   PTF-F191 NetWare/IP Patch
  178.  
  179.  The NWUPD entry will only appear in the list if you have
  180. previously applied the NIP191 patch.
  181.  
  182.  7. If the NWUPD entry appears, highlight it, and hit DELETE to
  183. remove it.
  184.  
  185.  8. Press <Insert>
  186.  
  187.  9. Press <F3> to install the files in NIP318.
  188.  The "SPECIFY DIRECTORY PATH" dialogue box will appear.
  189.  
  190.  10. Type in the path to the directory where the NIP318 files
  191. were extracted.  Example:   SYS:\NIP318\NWIP1 <Enter>
  192.  
  193.  11. If previous patches remain, the NIP318 install will prompt
  194. you to remove them before proceeding.
  195.  
  196.  After the installation program installs the files, the
  197. "Currently Installed
  198.  Products" menu will appear listing:
  199.     NWIP     1.1     NetWare/IP
  200.     NWUPD    1.1C    PTF-F318 NetWare/IP Patch
  201.  
  202.  12. Exit the Installation program or press <ALT>+<ESC>.
  203.  The system console prompt will appear.
  204.  
  205.  13. Although your current NetWare/IP client will continue to
  206. work after you apply NIP318, we strongly recommend that you also
  207. update your NetWare/IP client by downloading NIPW21.EXE (it will
  208. be in the same Library as NIP318.EXE).
  209.  The IP Client in NIPW21.EXE provides: 
  210.  --- better IPX compatibility.
  211.  --- support for the NMS NET Explorer Automatic Discovery
  212. function.
  213.  --- support for the NWIPMAP.EXE included in NIP318.
  214.  --- support for other new features included in NIP318.
  215.  
  216.  14. If a NWIP server is a non - forwarding gateway, it does not
  217. send information learned from the IPX side to the DSS.  We
  218. encourage you to designate one or two NWIP/IPX servers as
  219. forwarding gateways and avoid having other servers as gateways
  220. (forwarding or non-forwarding), with no gateways configured as
  221. non - forwarding. 
  222.  
  223.  A NetWare/IP client, connected to a non-forwarding gateway, may
  224. be able to see a server using "SLIST" and yet not be able to
  225. connect to that server.
  226.  
  227.  NIP318 gives you the ability to set up "Forwarding NWIP/IPX
  228. Gateways" but, the default is non-forwarding.
  229.  
  230.  To configure the "Forward IPX to DSS" parameter on a NetWare/IP
  231. server, use the UNICON utility.
  232.  
  233.  Start at the UNICON utility's Main Menu and select the
  234. following:
  235.  -> Manage Services
  236.  ----> NetWare/IP
  237.  -------> Configure NetWare/IP
  238.  
  239.  The NetWare/IP Server Configuration screen will appear:
  240.  EXAMPLE
  241.  |NetWare/IP Domain:               nwip.novell.com|
  242.  |Preferred DSSes:                 <see form>     |
  243.  |Initial DSS Contact Retries:     3              |
  244.  |Retry Interval:                  4 seconds      |
  245.  |Slow Link Customization:         <see form>     |
  246.  |Forward IPX Information to DSS?  No             |
  247.  
  248.  Select the "Forward IPX Information to DSS?" field, and specify
  249. your selection.
  250.  
  251.  If you changed a parameter, return to the console prompt and
  252. type: 
  253.  UNISTOP <Enter>  to unload the NetWare/IP modules from memory.
  254.  
  255.  Then Type:  UNISTART <Enter>  to start the modules again.
  256.  
  257.  NOTE:
  258.  a) Forwarding cannot be changed dynamically. 
  259.  The command-line option /forward=yes (or /forward=no) can be
  260. used only at load time (not at run-time).
  261.  
  262.  AND
  263.  
  264.  b) Forwarding specification on the command line always overrides
  265. the forwarding specification in the NWPARAMS file.
  266.  
  267.  c) When NWIP is loaded with the option "/forward=no" for the
  268. first time, it can be loaded again with the option "forward=yes",
  269. and it will dynamically change to a forwarding gateway, but not
  270. vise versa.  If you want to change the forwarding gateway to a
  271. non-forwarding gateway, you have to unload and reload the NWIP
  272. again.
  273.  
  274.  The forwarding feature can be enabled(disabled) either by
  275. specifying a command line switch at load time or through UNICON
  276. under the configure NetWare/IP server option.
  277.  
  278.  
  279.  15. NetWare/IP Server Configuration
  280.  -----------------------------------
  281.  If you download NIPW21.EXE for your clients, and wish to
  282. configure the server to utilize the new parameters which will be
  283. available if you do, start the UNICON utility.  AFTER you finish
  284. changing parameters, return to the console prompt and type: 
  285. UNISTOP <Enter> 
  286.  to unload the NetWare/IP modules from memory.
  287.  
  288.  Then Type:  UNISTART <Enter>  to start the modules again.
  289.  
  290.  15A. To Configure the "Initial DSS Contact Retries" Parameter
  291.  At the main UNICON screen select:
  292.  -> Manage Services
  293.  ----> NetWare/IP
  294.  -------> Configure NetWare/IP
  295.  
  296.  The NetWare/IP Server Configuration screen will appear:
  297.  EXAMPLE
  298.  |NetWare/IP Domain:               NWIP.NOVELL.COM|
  299.  |Preferred DSSes:                 <see form>     |
  300.  |Initial DSS Contact Retries:     3              |
  301.  |Retry Interval:                  4 seconds      |
  302.  |Slow Link Customization:         <see form>     |
  303.  |Forward IPX Information to DSS?  No             |
  304.  
  305.  Change the "Initial DSS Contact Retries" field to the desired
  306. number of retries. 
  307.  
  308.  
  309.  15B. To configure the "Retry Interval" parameter:
  310.  At the main UNICON screen select:
  311.  -> Manage Services
  312.  ----> NetWare/IP
  313.  -------> Configure NetWare/IP
  314.  
  315.  The NetWare/IP Server Configuration screen will appear:
  316.  EXAMPLE
  317.  |NetWare/IP Domain:               NWIP.NOVELL.COM|
  318.  |Preferred DSSes:                 <see form>     |
  319.  |Initial DSS Contact Retries:     3              |
  320.  |Retry Interval:                  4 seconds      |
  321.  |Slow Link Customization:         <see form>     |
  322.  |Forward IPX Information to DSS?  No             |
  323.  
  324.  
  325.  15C. To configure the "Preferred DSS" Parameter
  326.  At UNICON's Main Menu, select the following:
  327.  -> Manage Services
  328.  ----> NetWare/IP
  329.  -------> Configure NetWare/IP Server
  330.  ----------> Preferred DSSes:  
  331.  
  332.  The Preferred DSSes (Host/IP Address/Network) screen appears.
  333.  Hit ENTER and a form screen will appear for you to fill in.
  334.  EXAMPLE
  335.    Preferred DSS #1:   20.19.0.0
  336.    Preferred DSS #2:   120.5.1.1
  337.    Preferred DSS #3:   127.39.1.0
  338.    Preferred DSS #4:   128.0.0.0
  339.    Preferred DSS #5:   sanjose
  340.  
  341.  
  342.  15D. For a NetWare/IP domain configured to span WAN links, you
  343. can configure the "Tunable Parameters":
  344.  
  345.  --- For a NetWare IPX client that occasionally times out or
  346. disconnects while accessing remote servers
  347.  
  348.  --- To control the network traffic between DSS servers and
  349. NetWare/IP servers, and between the primary DSS server and
  350. secondary DSS servers
  351.  
  352.  --- To optimize an IPX client that occasionally times out or
  353. disconnects while accessing remote servers, you can configure the
  354. Ticks Between Nodes Tunable parameters. 
  355.  
  356.  These parameters specify the approximate one-way time for a
  357. packet to travel, in ticks, between two NetWare/IP nodes on the
  358. same IP subnetwork, same IP network, and different IP networks. 
  359.  A tick equals 1/18th second. 
  360.  
  361.  You can estimate the time for a packet to travel between nodes
  362. on the same subnetwork, same network, and different networks, by
  363. using the NetWare PING utility. 
  364.  To access the Ping utility, enter:   LOAD PING ip_address
  365.  at your system prompt.
  366.  
  367.  To change the "Tuneable Parameters", at UNICON's Main Menu,
  368. select:
  369.  -> Manage Services
  370.  ----> NetWare/IP
  371.  -------> Configure Primary DDS
  372.  ----------> Tunable Parameters
  373.  
  374.  The "Tunable Parameters" will screen.
  375.  EXAMPLE
  376.  |UDP Port Number for NetWare/IP Service:          43981 |
  377.  |DSS-NetWare/IP Server Synchronization Interval:  5     |
  378.  |Primary-Secondary DSS Synchronization Interval:  5     |
  379.  |Maximum UDP Retransmissions:                     3     |
  380.  |UDP Checksum?                                    No    |
  381.  |Ticks between Nodes on the Same IP Subnet:       2     |
  382.  |Ticks between Nodes on the Same IP Net:          4     |
  383.  |Ticks between Nodes on Different IP Nets:        6     |
  384.  
  385.  Configure the last three parameters on the list:
  386.    - Ticks between Nodes on the Same IP Subnet:
  387.    - Ticks between Nodes on the Same IP Net:
  388.    - Ticks between Nodes on Different IP Nets:
  389.  
  390.  The example shows the defaults, which in most cases are
  391. sufficient. 
  392.  
  393.  If modifying the Ticks Between Nodes Tunable parameters does not
  394. completely solve your timeout problems, you can configure the
  395. NetWare/IP servers for host/networks across slow WAN links from
  396. which they send and receive packets.  Specifically modify the
  397. tick values on the NetWare/IP servers that act as IPX/IP gateways
  398. and/or send and receive packets over slow WAN links.
  399.  
  400.  Specify a remote IP network/host address and the approximate
  401. one-way time (in ticks) to ping a remote host on the other side
  402. of the slow link using UNICON.
  403.  You can specify up to five network/host-tick pairs.
  404.  
  405.  Use the NetWare Ping utility to estimate the time for a packet
  406. to travel the slow links. 
  407.  To access the Ping utility, enter:   LOAD PING ip_address
  408.  at your system prompt.  Use the average the PING utility
  409. calculates.
  410.  
  411.  At UNICON's Main Menu, select the following:
  412.  -> Manage Services
  413.  --> NetWare/IP
  414.  -----> Configure Primary DDS
  415.  --------> Slow Link Customizations:
  416.  
  417.  A Remote Access Via Slow Links screen will appear.
  418.  EXAMPLE
  419.  |Network/Host IP Address        Tick Value     |
  420.  |atlanta                        2              |
  421.  |127.39.0.0                     20             |
  422.  |<none assigned>                <none assigned>|
  423.  |<none assigned>                <none assigned>|
  424.  |<none assigned>                <none assigned>|
  425.  
  426.  To optimize the network traffic between DSS servers and
  427. NetWare/IP servers, and between the primary DSS server and
  428. secondary DSS servers, you can modify the following Tunable
  429. parameters on the primary DSS server.
  430.  Using UNICON, access the "Tunable Parameters" screen, as
  431. previously
  432.  described, and modify the following:
  433.  
  434.  - "DSS-NetWare/IP Server Synchronization Interval", which
  435. specifies how often a NetWare/IP server queries a DSS server for
  436. updated information.  The default is five minutes.
  437.  
  438.  If you want the latency between the servers and their DSS
  439. servers to be small at the expense of extra local traffic,
  440. specify a smaller value for this parameter (particularly if your
  441. configuration gives each site its own DSS server).
  442.  
  443.  - "Primary-Secondary DSS Synchronization Interval", which
  444. specifies how often a secondary DSS server queries the primary
  445. DSS server for update information. 
  446.  The default is five minutes.
  447.  
  448.  If you reduce the traffic between the primary and the secondary
  449. DSS servers at the expense of higher DSS-DSS latency (if your
  450. configuration spreads DSS servers across WANs), specify a larger
  451. value for this parameter.
  452.  
  453.  16. Administrators will not ordinarily need to increase the
  454. maximum size of the packet queues maintained by DSS for storing
  455. SAP and RIP packets or, increase the maximum number of TCP
  456. connections. 
  457.  
  458.  However, the DSS.NLM in NIP318 allows you to configure those
  459. values by adding the following lines to the DSS section of the
  460. SYS:ETC\NWPARAMS file of any DSS server you wish to modify.
  461.  
  462.  - To increase the maximum size of UDP packets to be greater than
  463. the default of 64, add the line: 
  464.  MAX_UDP_PKTS <n1>
  465.  where <n1> is a decimal integer greater than 64.
  466.  
  467.  - To increase the maximum size of the packet queues to be
  468. greater than the default of 16, add the line:
  469.  MAX_TCP_CONNS <n2>
  470.  where <n2> is a decimal integer greater than 16.
  471.  
  472.  17. Registered/Unregistered DSS Servers
  473.  After you have applied both NIP318 and NIPW21 you have the
  474. option of either registering DSS servers (entering them in the
  475. DNS database) or not registering them.
  476.  
  477.  DSS Server Registered with DNS
  478.  A registered DSS server is visible to all NetWare/IP nodes
  479. through DNS.  Each registered DSS server has corresponding NS
  480. records in the DNS database, which identify it as a name server
  481. for the NetWare/IP domain.  When a NetWare/IP host queries DNS
  482. for the location of the nearest DSS server, DNS will only return
  483. a listing of registered DSS servers, because they are the only
  484. DSS servers it knows about.
  485.  
  486.  DSS Server Unregistered with DNS
  487.  A NetWare/IP node cannot locate an unregistered DSS server by
  488. issuing a DNS query.  Instead, the NetWare/IP node must be
  489. provided the name or address of the unregistered DSS server as
  490. part of its preferred DSS server listing. 
  491.  For example, you may want to designate a DSS server that is
  492. isolated from the rest of the NetWare/IP internetwork by a WAN
  493. link as an unregistered DSS server to prevent NetWare/IP servers
  494. from redirecting their queries to this DSS server when other
  495. closer DSS servers are busy or down.
  496.  
  497.  Using unregistered DSS servers can help in overcoming a
  498. deficiency of most DNS implementations -- a reply to a DNS query
  499. can not exceed 1.5K bytes.
  500.  
  501.  If there are more nameservers than a DNS packet can accommodate,
  502. all nameserver entries may not be returned in response to an NS
  503. query.  This deficiency of DNS implementations can be bypassed by
  504. using unregistered DSS servers.  An administrator can use an
  505. unregistered DSS to designate exactly which DSS server a
  506. NetWare/IP node should use.
  507.  This gives the administrator better control of DSS server
  508. utilization and load balancing.
  509.  
  510.  18. Using NetWare/IP with the NetWare Management System
  511.  --------------------------------------------------------
  512.  NIPW21 provides better IPX compatibility and support for the NMS
  513. NET Explorer Automatic Discovery function.
  514.  
  515.  The default value for NWIP1_1 COMPATIBILITY is set to "OFF" to
  516. enable the
  517.  automatic discovery function with NIP318 client installation.
  518.  
  519.    NWIP1_1 COMPATIBILITY OFF
  520.  
  521.  If you have a mixed NetWare/IP environment in which the servers
  522. have either NetWare/IP v1.1 or this update installed, set the
  523. value to ON and then
  524.  no automatic discovery.
  525.  
  526.  
  527.  
  528. -----------------------------------------------------------------
  529.  Any trademarks referenced in this document are the property of
  530. their respective owners.  Consult your product manuals for
  531. complete trademark information.
  532.  
  533. -----------------------------------------------------------------
  534.  
  535.