home *** CD-ROM | disk | FTP | other *** search
/ Chip 1997 April / Chip_1997-04_cd.bin / ovladace / novell / 312pta / 312pta.exe / NATIVE / OTHER / AUTO / NLICLR.TXT < prev    next >
Text File  |  1996-04-23  |  7KB  |  187 lines
  1. NOVELL TECHNICAL INFORMATION DOCUMENT
  2.  
  3. TITLE:  Readme for New NLICLEAR.NLM
  4. README FOR:  NLICLR.EXE
  5.  
  6. NOVELL PRODUCTS and VERSIONS:
  7. NetWare 3.12
  8. NetWare 3.11
  9.  
  10. ABSTRACT:
  11.  
  12. NLICLEAR nlm (not-logged-in user skulker nlm) examines the user connection
  13. table at periodic intervals, deleting connections that correspond to
  14. unauthenticated users.  The primary reason for this is to limit the number of
  15. idle, unauthenticated, connections for server licenses allowing only a small
  16. number of users to be connected.  Terminating unauthenticated connections thus
  17. allows the connections to be reused.  This is a new version of NLICLEAR that
  18. fixes a problem with server GPPE or randomly entering the Debugger.
  19.  
  20.  
  21.  -----------------------------------------------------------------
  22.  DISCLAIMER
  23.  THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL.  NOVELL
  24. MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.  HOWEVER, THE
  25. INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL
  26. MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
  27.  -----------------------------------------------------------------
  28.  
  29.  
  30. SYMPTOM:
  31.  
  32. 1     The server would end up in the internal debugger, or Abend GPPE
  33.  
  34.  
  35. TROUBLESHOOTING
  36.  
  37. Unload NLICLEAR.NLM and down load the new NLICLEAR.
  38.  
  39.  
  40.  
  41. CAUSE
  42.  
  43. 1.1     The NLICLEAR nlm (not-logged-in user skulker nlm) examines the user
  44. connection table at periodic intervals, deleting connections that correspond to
  45. unauthenticated users. 
  46.  
  47.  The unauthenticated state occurs on a user connection when a user specifies a
  48. login name, but doesn't complete the login procedure (by entering a password),
  49. or logs out without logging in elsewhere.  In
  50.  this state, the connection is logged into the server, but no privileges
  51.  or authentication is granted, except to complete the login, or to login
  52.  elsewhere.
  53.  
  54.  NLICLEAR simply polls the user table on a periodic interval, looking at the
  55. connection status.  If the connection status changes to the not-logged-in
  56. state, the software sets a flag for that connection indicating so.  If, on the
  57. next poll interval, the connection is still in the not-logged-in state and the
  58. state flag is set (for the connection), then the corresponding station is
  59. deleted from the user table.  On each polling interval, if the connection in
  60. the user table goes to a non-not-logged-in state (connection cleared, or
  61. connection logged in), then the state flag for the connection is reset. 
  62. NLICLEAR only applies to ncp user connections, and does not apply to nlm
  63. connections.
  64.  
  65.  The Old NLICLEAR nlm was clearing not-loggin connections before the login
  66. procedure was finished. When the login procedure did run it checked the
  67. connection table for this user and found invalid pointer in memory and  either
  68. jump into the debugger or GPPE the server. 
  69.  
  70.  SOLUTION
  71.  
  72.  This New NLICLEAR nlm checks to see if the NOT-LOGIN connection has a IN
  73. process bit set before clearing the connection.
  74.  
  75.  IN F
  76.  
  77.  
  78.  
  79. SOLUTION: 
  80.  
  81. 1.1     This New NLICLEAR nlm checks to see if the NOT-LOGIN connection has a
  82. IN process bit set before clearing the connection.
  83.  
  84.  IN Field Test the file name will be NLICLRFT.EXE this is for Netware 3.11 and
  85. 3.12.
  86.  
  87.  
  88. Self-Extracting File Name: NLICLR.EXE
  89.  
  90. Files Included     Size     Date      Time
  91.  
  92. ..\
  93.       NLICLR.TXT     (This file)
  94.     NLICLEAR.NLM            4434          4-6-95      9:34:54 pm
  95.  
  96.  
  97. Installation Instructions:
  98.  
  99. Three parameters, the polling interval, the maximum number of user table
  100. connections, and the verbose option, are settable from the command line when
  101. loading the module.  The polling interval is the interval in seconds between
  102. "looks" at the user connection table.  The maximum number of table connections
  103. is the number of user connections, N (indexed 1..N) to examine on each polling
  104. interval (connection 0 in the
  105.  user table is reserved for the supervisor, and is not polled). Setting an
  106. additional parameter, the "verbose" option, causes a message to be printed to
  107. the server console screen each time a connection is terminated by NLICLEAR.
  108.  
  109.  When loading NLICLEAR from the server console command line, use the following
  110. syntax:
  111.  
  112.  load nliclear [v] [i poll_interval] [n number_of_connections]
  113.  
  114.  Option flags may be preceeded by a '-' or '/' character, if desired.
  115.  
  116.  Option flags may also be grouped together.  If so, the arguments that follow
  117. them must occur in corresponding order.  The "v" option causes a message to be
  118. written to the server console screen each time a connection is cleared.  The
  119. default is no connection-clear notification.  The "i" option must include an
  120. integer parameter, "poll_interval", and sets the time in seconds for NLICLEAR
  121. to wait between checks of the user connection table.  The default interval is
  122. 60 seconds. The "n" option must include an integer parameter,
  123. "number_of_connections", and sets the maximum number of connections in the user
  124. connection table that will be polled, indexed starting at connection station 1. 
  125. The default number of connections is the maximum
  126.  number of remote connections allowable for the stratified OS version (for
  127. example, a default of 10 connections will be polled on 10-user version of the
  128. OS).
  129.  
  130.  
  131.  Patch History:
  132.  
  133.  NLICLEAR.NLM: 4018 04-25-91   2:18p
  134.  
  135.  Version 1.01  NetWare 386 Not-Logged-In User Skulker
  136.  Copyright 1991 Novell, Inc.  All rights reserved.
  137.  Checksum is 2A74 FF52 E902 72DF C376 823F
  138.  
  139.  NLICLEAR.NLM      3357 03-08-91   2:56p
  140.  
  141.  Version 1.02  NetWare 386 Not-Logged-In User Skulker
  142.  Copyright 1991 Novell, Inc.  All rights reserved.
  143.  Checksum is 1585 64FB 6BD6 AC59 7E53 C5BF
  144.  
  145.  change in default number of connections to check.  Also, more elaborate alert
  146. mechanism.
  147.  
  148.  NLICLEAR NLM      4338 05-24-91  12:17p
  149.  
  150.  Version 1.04  NetWare 386 Not-Logged-In User Skulker
  151.  Copyright 1991 Novell, Inc.  All rights reserved.
  152.  Checksum is 4E53 FC37 C72E 5BBB 897D B77E
  153.  
  154.  This is the original NLICLEAR.nlm that ships on 3.12 CD.
  155.  
  156.  Changes: connections-monitored algorithm and delay algorithm; changed
  157. command-line params;added a status report on load
  158.  
  159.  NLICLEAR NLM      4434 05-27-93   2:47p
  160.  
  161.  Version 1.05  NetWare 386 Not-Logged-In User Skulker (930527)
  162.  Copyright 1993 Novell, Inc.  All rights reserved.
  163.  Checksum is 28A5 12F2 D9B1 D160 F114 D2C0
  164.  
  165.  changed NLIClear.NLM to have a maximum polling interval of 3 hours instead of
  166. 1. Changed the define in NLIClear.H NLI_CLEAR_MAX_POLL_INTERVAL from 3600 to
  167. 10800.
  168.  
  169.  
  170.  NLICLEAR NLM      4434 09-01-94   2:28p
  171.  
  172.  Version 1.05  NetWare 386 Not-Logged-In User Skulker (940901)
  173.  Copyright 1994 Novell, Inc.  All rights reserved.
  174.  Checksum is AFEB E681 AA55 0B28 05BE FCFB
  175.  
  176.  This NLM is included Fixes problems with clearing a not-login procedure before
  177. the login procedure is finished. This is fixes by looking for a in process bit
  178. before clearing the connection.
  179.  
  180.  
  181.  -----------------------------------------------------------------
  182.  Any trademarks referenced in this document are the property of their
  183. respective owners.  Consult your product manuals for complete trademark
  184. information.
  185.  -----------------------------------------------------------------
  186.  
  187.