| 1 | <samba:parameter name="logon path"
|
|---|
| 2 | context="G"
|
|---|
| 3 | type="string"
|
|---|
| 4 | advanced="1" developer="1"
|
|---|
| 5 | xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
|
|---|
| 6 | <description>
|
|---|
| 7 | <para>
|
|---|
| 8 | This parameter specifies the directory where roaming profiles (Desktop, NTuser.dat, etc) are
|
|---|
| 9 | stored. Contrary to previous versions of these manual pages, it has nothing to do with Win 9X roaming
|
|---|
| 10 | profiles. To find out how to handle roaming profiles for Win 9X system, see the
|
|---|
| 11 | <smbconfoption name="logon home"/> parameter.
|
|---|
| 12 | </para>
|
|---|
| 13 |
|
|---|
| 14 | <para>
|
|---|
| 15 | This option takes the standard substitutions, allowing you to have separate logon scripts for each user or
|
|---|
| 16 | machine. It also specifies the directory from which the "Application Data", <filename
|
|---|
| 17 | moreinfo="none">desktop</filename>, <filename moreinfo="none">start menu</filename>, <filename
|
|---|
| 18 | moreinfo="none">network neighborhood</filename>, <filename moreinfo="none">programs</filename> and other
|
|---|
| 19 | folders, and their contents, are loaded and displayed on your Windows NT client.
|
|---|
| 20 | </para>
|
|---|
| 21 |
|
|---|
| 22 | <para>
|
|---|
| 23 | The share and the path must be readable by the user for the preferences and directories to be loaded onto the
|
|---|
| 24 | Windows NT client. The share must be writeable when the user logs in for the first time, in order that the
|
|---|
| 25 | Windows NT client can create the NTuser.dat and other directories.
|
|---|
| 26 | Thereafter, the directories and any of the contents can, if required, be made read-only. It is not advisable
|
|---|
| 27 | that the NTuser.dat file be made read-only - rename it to NTuser.man to achieve the desired effect (a
|
|---|
| 28 | <emphasis>MAN</emphasis>datory profile).
|
|---|
| 29 | </para>
|
|---|
| 30 |
|
|---|
| 31 | <para>
|
|---|
| 32 | Windows clients can sometimes maintain a connection to the [homes] share, even though there is no user logged
|
|---|
| 33 | in. Therefore, it is vital that the logon path does not include a reference to the homes share (i.e. setting
|
|---|
| 34 | this parameter to \\%N\homes\profile_path will cause problems).
|
|---|
| 35 | </para>
|
|---|
| 36 |
|
|---|
| 37 | <para>
|
|---|
| 38 | This option takes the standard substitutions, allowing you to have separate logon scripts for each user or machine.
|
|---|
| 39 | </para>
|
|---|
| 40 |
|
|---|
| 41 | <warning><para>
|
|---|
| 42 | Do not quote the value. Setting this as <quote>\\%N\profile\%U</quote>
|
|---|
| 43 | will break profile handling. Where the tdbsam or ldapsam passdb backend
|
|---|
| 44 | is used, at the time the user account is created the value configured
|
|---|
| 45 | for this parameter is written to the passdb backend and that value will
|
|---|
| 46 | over-ride the parameter value present in the smb.conf file. Any error
|
|---|
| 47 | present in the passdb backend account record must be editted using the
|
|---|
| 48 | appropriate tool (pdbedit on the command-line, or any other locally
|
|---|
| 49 | provided system tool).
|
|---|
| 50 | </para></warning>
|
|---|
| 51 |
|
|---|
| 52 | <para>Note that this option is only useful if Samba is set up as a domain controller.</para>
|
|---|
| 53 |
|
|---|
| 54 | <para>
|
|---|
| 55 | Disable the use of roaming profiles by setting the value of this parameter to the empty string. For
|
|---|
| 56 | example, <smbconfoption name="logon path">""</smbconfoption>. Take note that even if the default setting
|
|---|
| 57 | in the smb.conf file is the empty string, any value specified in the user account settings in the passdb
|
|---|
| 58 | backend will over-ride the effect of setting this parameter to null. Disabling of all roaming profile use
|
|---|
| 59 | requires that the user account settings must also be blank.
|
|---|
| 60 | </para>
|
|---|
| 61 |
|
|---|
| 62 | <para>
|
|---|
| 63 | An example of use is:
|
|---|
| 64 | <programlisting>
|
|---|
| 65 | logon path = \\PROFILESERVER\PROFILE\%U
|
|---|
| 66 | </programlisting>
|
|---|
| 67 | </para>
|
|---|
| 68 | </description>
|
|---|
| 69 | <value type="default">\\%N\%U\profile</value>
|
|---|
| 70 | </samba:parameter>
|
|---|
