Ref: 06430014
Title: NETLOGON Service Common Errors
Date: 4/20/90

Copyright 3Com Corporation, 1991.  All rights reserved.

NETLOGON service is a logon validation (not logon security) service.

Most problems with the NETLOGON service are due to changes made to the
structure of the user directory file system.  Specifically, the most
common factors involved in the success or failure of the NETLOGON service
are

   *  the USERPATH= entry in Lanman.ini
   *  the corresponding USERDIRS sharename path entry
   *  the individual user directory locations
   *  the placement of script files under the USERPATH


By default the user directory file structure is as follows:

   USERPATH= C:\3OPEN\USERS
   USERDIRS sharename path points to C:\3OPEN\USERS
   Individual user directories are located under C:\3OPEN\USERS
   Script files are located under C:\3OPEN\USERS\SCRIPTS

If the system is kept in this default configuration, the NETLOGON service
can be configured as listed in the 3+Open LAN Manager Administrator Guide.
If, however, any ONE of these values changes, then ALL OTHER values must be
changed as well so that the relationship of these values is preserved; meaning
the USERPATH= entry and USERDIRS sharename point to the same path, and
all individual user directories and script files are located under that
path.  This structure MUST remain constant.  If an individual's user
directory is not located under this path, then the environment variable for
user directory (%3) will not be passed, and the default script files provided
(NETLOGON.BAT and NETLOGON.CMD) will exit early without executing any NET USE
commands.  This can easily be mistaken for a failure of the NETLOGON service.
If the script files are not located under the USERDIRS sharename (and the
USERPATH), the NETLOGON service will experience a true failure.

The individual script files (NETLOGON.BAT and NETLOGON.CMD by default) are
located by the NETLOGON service based on the USERPATH entry in Lanman.ini.
When a user account is added via NET ADMIN, the script file specified must
assume a path prefix of whatever is specified in the USERPATH= entry in
Lanman.ini.  Any subdirectories between the USERPATH= entry and the script
files themselves must be specified in the user account screen.  For example,
if the USERPATH= entry is C:\3OPEN\USERS and the script files are located in
the C:\3OPEN\USERS\SCRIPTS subdirectory, the script file entry in NET ADMIN
would be \SCRIPT\NETLOGON.BAT.

A sample server configuration for placing individual user directories on
the D: partition (in a subdirectory called USERS) follows:

   USERPATH = D:\USERS
   USERDIRS point to D:\USERS
   Script files are located in D:\USERS\SCRIPTS
   All user directories are located under the D:\USERS subdirectory

If the NETLOGON service is being used to provide logon validation for
DOS enhanced netstations, the LASTDRIVE= statement in the workstation
CONFIG.SYS file must read "LASTDRIVE= Z".  The NETLOGON service
automatically creates a USERS sharename pointing to the USERPATH, which it
will link to the logical Z: drive on each DOS Enhanced workstation that
attempts to log on.  If the Z: drive is not available, the message "Unable to
set redirector name" will appear on the workstation and it will be unable to
logon to the network.  Because the NETLOGON service creates this link, no
NET USE commands may be executed to the logical Z: drive from within script
files on a DOS Enhanced netstation.
