summaryrefslogtreecommitdiff
path: root/docs/docbook/projdoc/ProfileMgmt.sgml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/docbook/projdoc/ProfileMgmt.sgml')
-rw-r--r--docs/docbook/projdoc/ProfileMgmt.sgml473
1 files changed, 243 insertions, 230 deletions
diff --git a/docs/docbook/projdoc/ProfileMgmt.sgml b/docs/docbook/projdoc/ProfileMgmt.sgml
index ffbc65f767..72eac8635a 100644
--- a/docs/docbook/projdoc/ProfileMgmt.sgml
+++ b/docs/docbook/projdoc/ProfileMgmt.sgml
@@ -12,54 +12,71 @@
<pubdate>April 3 2003</pubdate>
</chapterinfo>
-<title>Profile Management</title>
+<title>Desktop Profile Management</title>
<sect1>
<title>Roaming Profiles</title>
<warning>
<para>
-<emphasis>NOTE!</emphasis> Roaming profiles support is different for Win9X and WinNT.
+<emphasis>NOTE!</emphasis> Roaming profiles support is different for Win9x / Me
+and Windows NT4/200x.
</para>
</warning>
<para>
Before discussing how to configure roaming profiles, it is useful to see how
-Win9X and WinNT clients implement these features.
+Windows 9x / Me and Windows NT4/200x clients implement these features.
</para>
<para>
-Win9X clients send a NetUserGetInfo request to the server to get the user's
+Windows 9x / Me clients send a NetUserGetInfo request to the server to get the user's
profiles location. However, the response does not have room for a separate
-profiles location field, only the user's home share. This means that Win9X
-profiles are restricted to being in the user's home directory.
+profiles location field, only the user's home share. This means that Win9X/Me
+profiles are restricted to being stored in the user's home directory.
</para>
<para>
-WinNT clients send a NetSAMLogon RPC request, which contains many fields,
+Windows NT4/200x clients send a NetSAMLogon RPC request, which contains many fields,
including a separate field for the location of the user's profiles.
-This means that support for profiles is different for Win9X and WinNT.
</para>
<sect2>
-<title>Windows NT Configuration</title>
+<title>Samba Configuration for Profile Handling</title>
<para>
-To support WinNT clients, in the [global] section of smb.conf set the
+This section documents how to configure Samba for MS Windows client profile support.
+</para>
+
+<sect3>
+<title>NT4/200x User Profiles</title>
+
+<para>
+To support Windowns NT4/200x clients, in the [global] section of smb.conf set the
following (for example):
</para>
-<para><programlisting>
-logon path = \\profileserver\profileshare\profilepath\%U\moreprofilepath
-</programlisting></para>
+<para>
+<programlisting>
+ logon path = \\profileserver\profileshare\profilepath\%U\moreprofilepath
+
+ This is typically implemented like:
+
+ logon path = \\%L\Profiles\%u
+
+ where:
+ %L translates to the name of the Samba server
+ %u translates to the user name
+</programlisting>
+</para>
<para>
-The default for this option is \\%N\%U\profile, namely
-\\sambaserver\username\profile. The \\N%\%U service is created
-automatically by the [homes] service.
-If you are using a samba server for the profiles, you _must_ make the
-share specified in the logon path browseable.
+The default for this option is \\%N\%U\profile, namely \\sambaserver\username\profile.
+The \\N%\%U service is created automatically by the [homes] service. If you are using
+a samba server for the profiles, you _must_ make the share specified in the logon path
+browseable. Please refer to the man page for smb.conf in respect of the different
+symantics of %L and %N, as well as %U and %u.
</para>
<note>
@@ -69,45 +86,41 @@ between logons. It is recommended to NOT use the <emphasis>homes</emphasis>
meta-service name as part of the profile share path.
</para>
</note>
+</sect3>
-</sect2>
-
-<sect2>
-<title>Windows 9X Configuration</title>
+<sect3>
+<title>Windows 9x / Me User Profiles</title>
<para>
-To support Win9X clients, you must use the "logon home" parameter. Samba has
+To support Windows 9x / Me clients, you must use the "logon home" parameter. Samba has
now been fixed so that "net use /home" now works as well, and it, too, relies
on the "logon home" parameter.
</para>
<para>
-By using the logon home parameter, you are restricted to putting Win9X
+By using the logon home parameter, you are restricted to putting Win9x / Me
profiles in the user's home directory. But wait! There is a trick you
-can use. If you set the following in the [global] section of your
-smb.conf file:
+can use. If you set the following in the [global] section of your smb.conf file:
</para>
<para><programlisting>
-logon home = \\%L\%U\.profiles
+ logon home = \\%L\%U\.profiles
</programlisting></para>
<para>
-then your Win9X clients will dutifully put their clients in a subdirectory
+then your Windows 9x / Me clients will dutifully put their clients in a subdirectory
of your home directory called .profiles (thus making them hidden).
</para>
<para>
Not only that, but 'net use/home' will also work, because of a feature in
-Win9X. It removes any directory stuff off the end of the home directory area
+Windows 9x / Me. It removes any directory stuff off the end of the home directory area
and only uses the server and share portion. That is, it looks like you
specified \\%L\%U for "logon home".
</para>
+</sect3>
-
-</sect2>
-
-<sect2>
-<title>Win9X and WinNT Configuration</title>
+<sect3>
+<title>Mixed Windows 9x / Me and Windows NT4/200x User Profiles</title>
<para>
You can support profiles for both Win9X and WinNT clients by setting both the
@@ -115,20 +128,18 @@ You can support profiles for both Win9X and WinNT clients by setting both the
</para>
<para><programlisting>
-logon home = \\%L\%U\.profiles
-logon path = \\%L\profiles\%U
+ logon home = \\%L\%u\.profiles
+ logon path = \\%L\profiles\%u
</programlisting></para>
-<note>
-<para>
-I have not checked what 'net use /home' does on NT when "logon home" is
-set as above.
-</para>
-</note>
+</sect3>
</sect2>
<sect2>
-<title>Windows 9X Profile Setup</title>
+<title>Windows Client Profile Configuration Information</title>
+
+<sect3>
+<title>Windows 9x / Me Profile Setup</title>
<para>
When a user first logs in on Windows 9X, the file user.DAT is created,
@@ -150,7 +161,7 @@ and deny them write access to this file.
<orderedlist>
<listitem>
<para>
- On the Windows 95 machine, go to Control Panel | Passwords and
+ On the Windows 9x / Me machine, go to Control Panel -> Passwords and
select the User Profiles tab. Select the required level of
roaming preferences. Press OK, but do _not_ allow the computer
to reboot.
@@ -159,8 +170,8 @@ and deny them write access to this file.
<listitem>
<para>
- On the Windows 95 machine, go to Control Panel | Network |
- Client for Microsoft Networks | Preferences. Select 'Log on to
+ On the Windows 9x / Me machine, go to Control Panel -> Network ->
+ Client for Microsoft Networks -> Preferences. Select 'Log on to
NT Domain'. Then, ensure that the Primary Logon is 'Client for
Microsoft Networks'. Press OK, and this time allow the computer
to reboot.
@@ -170,12 +181,12 @@ and deny them write access to this file.
</orderedlist>
<para>
-Under Windows 95, Profiles are downloaded from the Primary Logon.
+Under Windows 9x / Me Profiles are downloaded from the Primary Logon.
If you have the Primary Logon as 'Client for Novell Networks', then
the profiles and logon script will be downloaded from your Novell
Server. If you have the Primary Logon as 'Windows Logon', then the
profiles will be loaded from the local machine - a bit against the
-concept of roaming profiles, if you ask me.
+concept of roaming profiles, it would seem!
</para>
<para>
@@ -188,13 +199,13 @@ supports it), user name and user's password.
</para>
<para>
-Once the user has been successfully validated, the Windows 95 machine
+Once the user has been successfully validated, the Windows 9x / Me machine
will inform you that 'The user has not logged on before' and asks you
if you wish to save the user's preferences? Select 'yes'.
</para>
<para>
-Once the Windows 95 client comes up with the desktop, you should be able
+Once the Windows 9x / Me client comes up with the desktop, you should be able
to examine the contents of the directory specified in the "logon path"
on the samba server and verify that the "Desktop", "Start Menu",
"Programs" and "Nethood" folders have been created.
@@ -202,7 +213,7 @@ on the samba server and verify that the "Desktop", "Start Menu",
<para>
These folders will be cached locally on the client, and updated when
-the user logs off (if you haven't made them read-only by then :-).
+the user logs off (if you haven't made them read-only by then).
You will find that if the user creates further folders or short-cuts,
that the client will merge the profile contents downloaded with the
contents of the profile directory already on the local client, taking
@@ -211,9 +222,9 @@ the newest folders and short-cuts from each set.
<para>
If you have made the folders / files read-only on the samba server,
-then you will get errors from the w95 machine on logon and logout, as
+then you will get errors from the Windows 9x / Me machine on logon and logout, as
it attempts to merge the local and the remote profile. Basically, if
-you have any errors reported by the w95 machine, check the Unix file
+you have any errors reported by the Windows 9x / Me machine, check the Unix file
permissions and ownership rights on the profile directory contents,
on the samba server.
</para>
@@ -244,71 +255,69 @@ they will be told that they are logging in "for the first time".
you will find an entry, for each user, of ProfilePath. Note the
contents of this key (likely to be c:\windows\profiles\username),
then delete the key ProfilePath for the required user.
- </para>
- <para>
[Exit the registry editor].
+
</para>
</listitem>
-<listitem>
+ <listitem>
<para>
<emphasis>WARNING</emphasis> - before deleting the contents of the
- directory listed in
- the ProfilePath (this is likely to be c:\windows\profiles\username),
- ask them if they have any important files stored on their desktop
- or in their start menu. delete the contents of the directory
- ProfilePath (making a backup if any of the files are needed).
+ directory listed in the ProfilePath (this is likely to be
+ <filename>c:\windows\profiles\username)</filename>, ask them if they
+ have any important files stored on their desktop or in their start menu.
+ Delete the contents of the directory ProfilePath (making a backup if any
+ of the files are needed).
</para>
<para>
- This will have the effect of removing the local (read-only hidden
- system file) user.DAT in their profile directory, as well as the
- local "desktop", "nethood", "start menu" and "programs" folders.
+ This will have the effect of removing the local (read-only hidden
+ system file) user.DAT in their profile directory, as well as the
+ local "desktop", "nethood", "start menu" and "programs" folders.
</para>
-</listitem>
+ </listitem>
-<listitem>
+ <listitem>
<para>
search for the user's .PWL password-caching file in the c:\windows
directory, and delete it.
</para>
-</listitem>
-
+ </listitem>
-<listitem>
+ <listitem>
<para>
- log off the windows 95 client.
+ log off the windows 9x / Me client.
</para>
-</listitem>
+ </listitem>
-<listitem>
+ <listitem>
<para>
check the contents of the profile path (see "logon path" described
above), and delete the user.DAT or user.MAN file for the user,
making a backup if required.
</para>
-</listitem>
+ </listitem>
</orderedlist>
<para>
If all else fails, increase samba's debug log levels to between 3 and 10,
-and / or run a packet trace program such as tcpdump or netmon.exe, and
-look for any error reports.
+and / or run a packet trace program such as ethereal or netmon.exe, and
+look for error messages.
</para>
<para>
-If you have access to an NT server, then first set up roaming profiles
-and / or netlogons on the NT server. Make a packet trace, or examine
-the example packet traces provided with NT server, and see what the
+If you have access to an Windows NT4/200x server, then first set up roaming profiles
+and / or netlogons on the Windows NT4/200x server. Make a packet trace, or examine
+the example packet traces provided with Windows NT4/200x server, and see what the
differences are with the equivalent samba trace.
</para>
-</sect2>
+</sect3>
-<sect2>
-<title>Windows NT Workstation 4.0</title>
+<sect3>
+<title>Windows NT4 Workstation</title>
<para>
When a user first logs in to a Windows NT Workstation, the profile
@@ -318,12 +327,12 @@ through the "logon path" parameter.
<para>
There is a parameter that is now available for use with NT Profiles:
-"logon drive". This should be set to "h:" or any other drive, and
+"logon drive". This should be set to <filename>H:</filename> or any other drive, and
should be used in conjunction with the new "logon home" parameter.
</para>
<para>
-The entry for the NT 4.0 profile is a _directory_ not a file. The NT
+The entry for the NT4 profile is a _directory_ not a file. The NT
help on profiles mentions that a directory is also created with a .PDS
extension. The user, while logging in, must have write permission to
create the full profile path (and the folder with the .PDS extension
@@ -331,8 +340,8 @@ for those situations where it might be created.)
</para>
<para>
-In the profile directory, NT creates more folders than 95. It creates
-"Application Data" and others, as well as "Desktop", "Nethood",
+In the profile directory, Windows NT4 creates more folders than Windows 9x / Me.
+It creates "Application Data" and others, as well as "Desktop", "Nethood",
"Start Menu" and "Programs". The profile itself is stored in a file
NTuser.DAT. Nothing appears to be stored in the .PDS directory, and
its purpose is currently unknown.
@@ -350,19 +359,131 @@ turns a profile into a mandatory one.
The case of the profile is significant. The file must be called
NTuser.DAT or, for a mandatory profile, NTuser.MAN.
</para>
+</sect3>
-</sect2>
+<sect3>
+<title>Windows 2000/XP Professional</title>
-<sect2>
-<title>Windows NT/200x Server</title>
+<para>
+You must first convert the profile from a local profile to a domain
+profile on the MS Windows workstation as follows:
+</para>
+
+<itemizedlist>
+<listitem><para>
+Log on as the LOCAL workstation administrator.
+</para></listitem>
+
+<listitem><para>
+Right click on the 'My Computer' Icon, select 'Properties'
+</para></listitem>
+
+<listitem><para>
+Click on the 'User Profiles' tab
+</para></listitem>
+
+<listitem><para>
+Select the profile you wish to convert (click on it once)
+</para></listitem>
+
+<listitem><para>
+Click on the button 'Copy To'
+</para></listitem>
+
+<listitem><para>
+In the "Permitted to use" box, click on the 'Change' button.
+</para></listitem>
+
+<listitem><para>
+Click on the 'Look in" area that lists the machine name, when you click
+here it will open up a selection box. Click on the domain to which the
+profile must be accessible.
+</para>
+
+<note><para>You will need to log on if a logon box opens up. Eg: In the connect
+as: MIDEARTH\root, password: mypassword.</para></note>
+</listitem>
+
+<listitem><para>
+To make the profile capable of being used by anyone select 'Everyone'
+</para></listitem>
+
+<listitem><para>
+Click OK. The Selection box will close.
+</para></listitem>
+
+<listitem><para>
+Now click on the 'Ok' button to create the profile in the path you
+nominated.
+</para></listitem>
+</itemizedlist>
<para>
-There is nothing to stop you specifying any path that you like for the
-location of users' profiles. Therefore, you could specify that the
-profile be stored on a samba server, or any other SMB server, as long as
-that SMB server supports encrypted passwords.
+Done. You now have a profile that can be editted using the samba-3.0.0
+profiles tool.
</para>
+<note>
+<para>
+Under NT/2K the use of mandotory profiles forces the use of MS Exchange
+storage of mail data. That keeps desktop profiles usable.
+</para>
+</note>
+
+<note>
+<itemizedlist>
+<listitem><para>
+This is a security check new to Windows XP (or maybe only
+Windows XP service pack 1). It can be disabled via a group policy in
+Active Directory. The policy is:</para>
+
+<para>"Computer Configuration\Administrative Templates\System\User
+Profiles\Do not check for user ownership of Roaming Profile Folders"</para>
+
+<para>...and it should be set to "Enabled".
+Does the new version of samba have an Active Directory analogue? If so,
+then you may be able to set the policy through this.
+</para>
+
+<para>
+If you cannot set group policies in samba, then you may be able to set
+the policy locally on each machine. If you want to try this, then do
+the following (N.B. I don't know for sure that this will work in the
+same way as a domain group policy):
+</para>
+
+</listitem>
+
+<listitem><para>
+On the XP workstation log in with an Administrator account.
+</para></listitem>
+
+<listitem><para>Click: "Start", "Run"</para></listitem>
+<listitem><para>Type: "mmc"</para></listitem>
+<listitem><para>Click: "OK"</para></listitem>
+
+<listitem><para>A Microsoft Management Console should appear.</para></listitem>
+<listitem><para>Click: File, "Add/Remove Snap-in...", "Add"</para></listitem>
+<listitem><para>Double-Click: "Group Policy"</para></listitem>
+<listitem><para>Click: "Finish", "Close"</para></listitem>
+<listitem><para>Click: "OK"</para></listitem>
+
+<listitem><para>In the "Console Root" window:</para></listitem>
+<listitem><para>Expand: "Local Computer Policy", "Computer Configuration",</para></listitem>
+<listitem><para>"Administrative Templates", "System", "User Profiles"</para></listitem>
+<listitem><para>Double-Click: "Do not check for user ownership of Roaming Profile</para></listitem>
+<listitem><para>Folders"</para></listitem>
+<listitem><para>Select: "Enabled"</para></listitem>
+<listitem><para>Click: OK"</para></listitem>
+
+<listitem><para>Close the whole console. You do not need to save the settings (this
+refers to the console settings rather than the policies you have
+changed).</para></listitem>
+
+<listitem><para>Reboot</para></listitem>
+</itemizedlist>
+</note>
+</sect3>
</sect2>
<sect2>
@@ -393,12 +514,22 @@ NTuser.DAT files in the same profile directory.
</sect2>
-
<sect2>
-<title>Windows NT 4</title>
+<title>Profile Migration from Windows NT4/200x Server to Samba</title>
+
+<para>
+There is nothing to stop you specifying any path that you like for the
+location of users' profiles. Therefore, you could specify that the
+profile be stored on a samba server, or any other SMB server, as long as
+that SMB server supports encrypted passwords.
+</para>
+
+<sect3>
+<title>Windows NT4 Profile Management Tools</title>
<para>
-Unfortunately, the Resource Kit info is Win NT4 or 200x specific.
+Unfortunately, the Resource Kit information is specific to the version of MS Windows
+NT4/200x. The correct resource kit is required for each platform.
</para>
<para>
@@ -422,17 +553,17 @@ profile you copy this to. That is what you need to do, since your samba
domain is not a member of a trust relationship with your NT4 PDC.</para></note>
</listitem>
-<listitem><para>Click the 'Copy To' button.</para></listitem>
+ <listitem><para>Click the 'Copy To' button.</para></listitem>
-<listitem><para>In the box labelled 'Copy Profile to' add your new path, eg:
-<filename>c:\temp\foobar</filename></para></listitem>
+ <listitem><para>In the box labelled 'Copy Profile to' add your new path, eg:
+ <filename>c:\temp\foobar</filename></para></listitem>
-<listitem><para>Click on the button labelled 'Change' in the "Permitted to use" box.</para></listitem>
+ <listitem><para>Click on the button labelled 'Change' in the "Permitted to use" box.</para></listitem>
-<listitem><para>Click on the group 'Everyone' and then click OK. This closes the
-'chose user' box.</para></listitem>
+ <listitem><para>Click on the group 'Everyone' and then click OK. This closes the
+ 'chose user' box.</para></listitem>
-<listitem><para>Now click OK.</para></listitem>
+ <listitem><para>Now click OK.</para></listitem>
</itemizedlist>
<para>
@@ -454,16 +585,6 @@ settings as well as all your users.
</sect3>
-<sect3>
-<title>Mandatory profiles</title>
-
-<para>
-The above method can be used to create mandatory profiles also. To convert
-a group profile into a mandatory profile simply locate the NTUser.DAT file
-in the copied profile and rename it to NTUser.MAN.
-</para>
-
-</sect3>
<sect3>
<title>moveuser.exe</title>
@@ -499,133 +620,25 @@ subkey, you will see a string value named ProfileImagePath.
</para>
</sect3>
-
</sect2>
+</sect1>
-<sect2>
-<title>Windows 2000/XP</title>
-
-<para>
-You must first convert the profile from a local profile to a domain
-profile on the MS Windows workstation as follows:
-</para>
-
-<itemizedlist>
-<listitem><para>
-Log on as the LOCAL workstation administrator.
-</para></listitem>
-
-<listitem><para>
-Right click on the 'My Computer' Icon, select 'Properties'
-</para></listitem>
-
-<listitem><para>
-Click on the 'User Profiles' tab
-</para></listitem>
-
-<listitem><para>
-Select the profile you wish to convert (click on it once)
-</para></listitem>
-
-<listitem><para>
-Click on the button 'Copy To'
-</para></listitem>
-
-<listitem><para>
-In the "Permitted to use" box, click on the 'Change' button.
-</para></listitem>
-
-<listitem><para>
-Click on the 'Look in" area that lists the machine name, when you click
-here it will open up a selection box. Click on the domain to which the
-profile must be accessible.
-</para>
-
-
-<note><para>You will need to log on if a logon box opens up. Eg: In the connect
-as: MIDEARTH\root, password: mypassword.</para></note>
-</listitem>
-
-<listitem><para>
-To make the profile capable of being used by anyone select 'Everyone'
-</para></listitem>
-
-<listitem><para>
-Click OK. The Selection box will close.
-</para></listitem>
-
-<listitem><para>
-Now click on the 'Ok' button to create the profile in the path you
-nominated.
-</para></listitem>
-</itemizedlist>
-
-<para>
-Done. You now have a profile that can be editted using the samba-3.0.0
-profiles tool.
-</para>
+<sect1>
+<title>Mandatory profiles</title>
-<note>
<para>
-Under NT/2K the use of mandotory profiles forces the use of MS Exchange
-storage of mail data. That keeps desktop profiles usable.
+The above method can be used to create mandatory profiles also. To convert
+a group profile into a mandatory profile simply locate the NTUser.DAT file
+in the copied profile and rename it to NTUser.MAN.
</para>
-</note>
-<note>
-<itemizedlist>
-<listitem><para>
-This is a security check new to Windows XP (or maybe only
-Windows XP service pack 1). It can be disabled via a group policy in
-Active Directory. The policy is:</para>
-
-<para>"Computer Configuration\Administrative Templates\System\User
-Profiles\Do not check for user ownership of Roaming Profile Folders"</para>
+</sect1>
-<para>...and it should be set to "Enabled".
-Does the new version of samba have an Active Directory analogue? If so,
-then you may be able to set the policy through this.
-</para>
+<sect1>
+<title>Creating/Managing Group Profiles</title>
<para>
-If you cannot set group policies in samba, then you may be able to set
-the policy locally on each machine. If you want to try this, then do
-the following (N.B. I don't know for sure that this will work in the
-same way as a domain group policy):
+Blah goes here.
</para>
-
-</listitem>
-
-<listitem><para>
-On the XP workstation log in with an Administrator account.
-</para></listitem>
-
-<listitem><para>Click: "Start", "Run"</para></listitem>
-<listitem><para>Type: "mmc"</para></listitem>
-<listitem><para>Click: "OK"</para></listitem>
-
-<listitem><para>A Microsoft Management Console should appear.</para></listitem>
-<listitem><para>Click: File, "Add/Remove Snap-in...", "Add"</para></listitem>
-<listitem><para>Double-Click: "Group Policy"</para></listitem>
-<listitem><para>Click: "Finish", "Close"</para></listitem>
-<listitem><para>Click: "OK"</para></listitem>
-
-<listitem><para>In the "Console Root" window:</para></listitem>
-<listitem><para>Expand: "Local Computer Policy", "Computer Configuration",</para></listitem>
-<listitem><para>"Administrative Templates", "System", "User Profiles"</para></listitem>
-<listitem><para>Double-Click: "Do not check for user ownership of Roaming Profile</para></listitem>
-<listitem><para>Folders"</para></listitem>
-<listitem><para>Select: "Enabled"</para></listitem>
-<listitem><para>Click: OK"</para></listitem>
-
-<listitem><para>Close the whole console. You do not need to save the settings (this
-refers to the console settings rather than the policies you have
-changed).</para></listitem>
-
-<listitem><para>Reboot</para></listitem>
-</itemizedlist>
-</note>
-
-</sect2>
</sect1>
</chapter>