~nhandler/ubuntu-docs/fix-lp507624

#, fuzzy

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2009-10-04 21:24+0100\n"

"X-Launchpad-Export-Date: 2009-10-16 07:28+0000\n"

"X-Generator: Launchpad (build Unknown)\n"

msgid ""

"Computer networks are often comprised of diverse systems, and while "

"operating a network made up entirely of Ubuntu desktop and server computers "

"would certainly be fun, some network environments must consist of both "

"Ubuntu and <trademark class=\"registered\">Microsoft</trademark><trademark "

"class=\"registered\">Windows</trademark> systems working together in "

"harmony. This section of the <phrase>Ubuntu</phrase> Server Guide introduces "

"principles and tools used in configuring your Ubuntu Server for sharing "

"network resources with Windows computers."

msgid ""

"Successfully networking your Ubuntu system with Windows clients involves "

"providing and integrating with services common to Windows environments. Such "

"services assist the sharing of data and information about the computers and "

"users involved in the network, and may be classified under three major "

"categories of functionality:"

msgid ""

"<emphasis role=\"bold\">File and Printer Sharing Services</emphasis>. Using "

"the Server Message Block (SMB) protocol to facilitate the sharing of files, "

"folders, volumes, and the sharing of printers throughout the network."

msgid ""

"<emphasis role=\"bold\">Directory Services</emphasis>. Sharing vital "

"information about the computers and users of the network with such "

"technologies as the Lightweight Directory Access Protocol (LDAP) and "

"Microsoft <trademark class=\"registered\">Active Directory</trademark>."

msgid ""

"<emphasis role=\"bold\">Authentication and Access</emphasis>. Establishing "

"the identity of a computer or user of the network and determining the "

"information the computer or user is authorized to access using such "

"principles and technologies as file permissions, group policies, and the "

"Kerberos authentication service."

msgid ""

"Fortunately, your Ubuntu system may provide all such facilities to Windows "

"clients and share network resources among them. One of the principal pieces "

"of software your Ubuntu system includes for Windows networking is the Samba "

"suite of SMB server applications and tools."

msgid ""

"This section of the <phrase>Ubuntu</phrase> Server Guide will introduce some "

"of the common Samba use cases, and how to install and configure the "

"necessary packages. Additional detailed documentation and information on "

"Samba can be found on the <ulink url=\"http://www.samba.org\">Samba "

"website</ulink>."

msgid ""

"One of the most common ways to network Ubuntu and Windows computers is to "

"configure Samba as a File Server. This section covers setting up a "

"<application>Samba</application> server to share files with Windows clients."

msgid ""

"The server will be configured to share files with any client on the network "

"without prompting for a password. If your environment requires stricter "

"Access Controls see <xref linkend=\"samba-fileprint-security\"/>"

#: serverguide/C/windows-networking.xml:83(title) serverguide/C/windows-networking.xml:282(title) serverguide/C/windows-networking.xml:1279(title) serverguide/C/web-servers.xml:41(title) serverguide/C/web-servers.xml:669(title) serverguide/C/web-servers.xml:804(title) serverguide/C/web-servers.xml:925(title) serverguide/C/vpn.xml:33(title) serverguide/C/virtualization.xml:62(title) serverguide/C/virtualization.xml:1341(title) serverguide/C/vcs.xml:28(title) serverguide/C/vcs.xml:86(title) serverguide/C/vcs.xml:402(title) serverguide/C/remote-administration.xml:52(title) serverguide/C/remote-administration.xml:220(title) serverguide/C/network-config.xml:603(title) serverguide/C/network-auth.xml:52(title) serverguide/C/network-auth.xml:1244(title) serverguide/C/network-auth.xml:1749(title) serverguide/C/network-auth.xml:2140(title) serverguide/C/monitoring.xml:42(title) serverguide/C/monitoring.xml:423(title) serverguide/C/mail.xml:40(title) serverguide/C/mail.xml:478(title) serverguide/C/mail.xml:651(title) serverguide/C/mail.xml:795(title) serverguide/C/mail.xml:1284(title) serverguide/C/lamp-applications.xml:108(title) serverguide/C/lamp-applications.xml:282(title) serverguide/C/lamp-applications.xml:398(title) serverguide/C/installation.xml:13(title) serverguide/C/installation.xml:908(title) serverguide/C/file-server.xml:342(title) serverguide/C/file-server.xml:454(title) serverguide/C/dns.xml:23(title) serverguide/C/databases.xml:40(title) serverguide/C/databases.xml:159(title) serverguide/C/chat.xml:37(title) serverguide/C/chat.xml:136(title) serverguide/C/backups.xml:593(title)

msgid ""

"The first step is to install the <application>samba</application> package. "

"From a terminal prompt enter:"

msgid ""

"That's all there is to it; you are now ready to configure Samba to share "

"files."

#: serverguide/C/windows-networking.xml:99(title) serverguide/C/windows-networking.xml:299(title) serverguide/C/web-servers.xml:61(title) serverguide/C/web-servers.xml:720(title) serverguide/C/web-servers.xml:815(title) serverguide/C/web-servers.xml:952(title) serverguide/C/web-servers.xml:1046(title) serverguide/C/vpn.xml:137(title) serverguide/C/virtualization.xml:1226(title) serverguide/C/virtualization.xml:1415(title) serverguide/C/vcs.xml:39(title) serverguide/C/vcs.xml:420(title) serverguide/C/remote-administration.xml:74(title) serverguide/C/remote-administration.xml:245(title) serverguide/C/package-management.xml:365(title) serverguide/C/network-config.xml:625(title) serverguide/C/network-auth.xml:88(title) serverguide/C/network-auth.xml:1788(title) serverguide/C/network-auth.xml:2161(title) serverguide/C/monitoring.xml:187(title) serverguide/C/monitoring.xml:449(title) serverguide/C/mail.xml:487(title) serverguide/C/mail.xml:661(title) serverguide/C/mail.xml:880(title) serverguide/C/mail.xml:1309(title) serverguide/C/lamp-applications.xml:128(title) serverguide/C/lamp-applications.xml:309(title) serverguide/C/lamp-applications.xml:428(title) serverguide/C/file-server.xml:355(title) serverguide/C/file-server.xml:480(title) serverguide/C/dns.xml:39(title) serverguide/C/databases.xml:84(title) serverguide/C/databases.xml:178(title) serverguide/C/clustering.xml:47(title) serverguide/C/chat.xml:57(title) serverguide/C/chat.xml:148(title) serverguide/C/backups.xml:616(title)

msgid ""

"The main Samba configuration file is located in "

"<filename>/etc/samba/smb.conf</filename>. The default configuration file has "

"a significant amount of comments in order to document various configuration "

"directives."

msgid ""

"Not all the available options are included in the default configuration "

"file. See the <filename>smb.conf</filename><application>man</application> "

"page or the <ulink url=\"http://samba.org/samba/docs/man/Samba-HOWTO-"

"Collection/\">Samba HOWTO Collection</ulink> for more details."

msgid ""

"First, edit the following key/value pairs in the "

"<emphasis>[global]</emphasis> section of "

"<filename>/etc/samba/smb.conf</filename>:"

msgid ""

"\n"

"   workgroup = EXAMPLE\n"

"   ...\n"

"   security = user\n"

msgid ""

"The <emphasis>security</emphasis> parameter is farther down in the [global] "

"section, and is commented by default. Also, change "

"<emphasis>EXAMPLE</emphasis> to better match your environment."

msgid ""

"Create a new section at the bottom of the file, or uncomment one of the "

"examples, for the directory to be shared:"

msgid ""

"\n"

"[share]\n"

"    comment = Ubuntu File Server Share\n"

"    path = /srv/samba/share\n"

"    browsable = yes\n"

"    guest ok = yes\n"

"    read only = no\n"

"    create mask = 0755\n"

msgid ""

"<emphasis>comment:</emphasis> a short description of the share. Adjust to "

"fit your needs."

msgid ""

"This example uses <filename>/srv/samba/sharename</filename> because, "

"according to the <emphasis>Filesystem Hierarchy Standard (FHS)</emphasis>, "

"<ulink url=\"http://www.pathname.com/fhs/pub/fhs-"

"2.3.html#SRVDATAFORSERVICESPROVIDEDBYSYSTEM\">/srv</ulink> is where site-"

"specific data should be served. Technically Samba shares can be placed "

"anywhere on the filesystem as long as the permissions are correct, but "

"adhering to standards is recommended."

msgid ""

"<emphasis>browsable:</emphasis> enables Windows clients to browse the shared "

"directory using <application>Windows Explorer</application>."

msgid ""

"<emphasis>guest ok:</emphasis> allows clients to connect to the share "

"without supplying a password."

msgid ""

"<emphasis>read only:</emphasis> determines if the share is read only or if "

"write privileges are granted. Write privileges are allowed only when the "

"value is <emphasis>no</emphasis>, as is seen in this example. If the value "

"is <emphasis>yes</emphasis>, then access to the share is read only."

msgid ""

"<emphasis>create mask:</emphasis> determines the permissions new files will "

"have when created."

msgid ""

"Now that <application>Samba</application> is configured, the directory needs "

"to be created and the permissions changed. From a terminal enter:"

msgid ""

"The <emphasis>-p</emphasis> switch tells mkdir to create the entire "

"directory tree if it doesn't exist. Change the share name to fit your "

"environment."

msgid ""

"Finally, restart the <application>samba</application> services to enable the "

"new configuration:"

#: serverguide/C/windows-networking.xml:218(command) serverguide/C/windows-networking.xml:326(command) serverguide/C/windows-networking.xml:458(command) serverguide/C/windows-networking.xml:557(command) serverguide/C/windows-networking.xml:922(command) serverguide/C/windows-networking.xml:1032(command) serverguide/C/windows-networking.xml:1142(command) serverguide/C/network-auth.xml:1523(command)

msgid ""

"Once again, the above configuration gives all access to any client on the "

"local network. For a more secure configuration see <xref linkend=\"samba-"

"fileprint-security\"/>."

msgid ""

"From a Windows client you should now be able to browse to the Ubuntu file "

"server and see the shared directory. To check that everything is working try "

"creating a directory from Windows."

msgid ""

"To create additional shares simply create new <emphasis>[dir]</emphasis> "

"sections in <filename>/etc/samba/smb.conf</filename>, and restart "

"<emphasis>Samba</emphasis>. Just make sure that the directory you want to "

"share actually exists and the permissions are correct."

#: serverguide/C/windows-networking.xml:243(title) serverguide/C/windows-networking.xml:336(title) serverguide/C/windows-networking.xml:686(title) serverguide/C/windows-networking.xml:1051(title) serverguide/C/windows-networking.xml:1253(title) serverguide/C/virtualization.xml:366(title) serverguide/C/virtualization.xml:1163(title) serverguide/C/remote-administration.xml:478(title) serverguide/C/network-config.xml:247(title) serverguide/C/network-config.xml:490(title) serverguide/C/network-auth.xml:1199(title) serverguide/C/network-auth.xml:1638(title) serverguide/C/network-auth.xml:2236(title) serverguide/C/network-auth.xml:2739(title) serverguide/C/installation.xml:848(title) serverguide/C/installation.xml:1124(title) serverguide/C/databases.xml:122(title) serverguide/C/databases.xml:268(title) serverguide/C/backups.xml:855(title)

msgid ""

"For in depth Samba configurations see the <ulink "

"url=\"http://samba.org/samba/docs/man/Samba-HOWTO-Collection/\">Samba HOWTO "

"Collection</ulink>"

msgid ""

"The guide is also available in <ulink "

"url=\"http://www.amazon.com/exec/obidos/tg/detail/-/0131882228\">printed "

"format</ulink>."

msgid ""

"O'Reilly's <ulink "

"url=\"http://www.oreilly.com/catalog/9780596007690/\">Using Samba</ulink> is "

"another good reference."

msgid ""

"Another common use of Samba is to configure it to share printers installed, "

"either locally or over the network, on an Ubuntu server. Similar to <xref "

"linkend=\"samba-fileserver\"/> this section will configure Samba to allow "

"any client on the local network to use the installed printers without "

"prompting for a username and password."

msgid ""

"For a more secure configuration see <xref linkend=\"samba-fileprint-"

"security\"/>."

msgid ""

"Before installing and configuring Samba it is best to already have a working "

"<application>CUPS</application> installation. See <xref linkend=\"cups\"/> "

"for details."

msgid ""

"To install the <application>samba</application> package, from a terminal "

"enter:"

msgid ""

"After installing samba edit <filename>/etc/samba/smb.conf</filename>. Change "

"the <emphasis>workgroup</emphasis> attribute to what is appropriate for your "

"network, and change <emphasis>security</emphasis> to <emphasis "

"role=\"italic\">share</emphasis>:"

msgid ""

"In the <emphasis>[printers]</emphasis> section change the <emphasis>guest "

"ok</emphasis> option to <emphasis role=\"italic\">yes</emphasis>:"

msgid ""

"\n"

"   browsable = yes\n"

"   guest ok = yes\n"

msgid ""

"The default Samba configuration will automatically share any printers "

"installed. Simply install the printer locally on your Windows clients."

msgid ""

"Also, see the <ulink url=\"http://www.cups.org/\">CUPS Website</ulink> for "

"more information on configuring CUPS."

msgid ""

"There are two security levels available to the Common Internet Filesystem "

"(CIFS) network protocol <emphasis>user-level</emphasis> and <emphasis>share-"

"level</emphasis>. Samba's <emphasis>security mode</emphasis> implementation "

"allows more flexibility, providing four ways of implementing user-level "

"security and one way to implement share-level:"

msgid ""

"<emphasis>security = user:</emphasis> requires clients to supply a username "

"and password to connect to shares. Samba user accounts are separate from "

"system accounts, but the <application>libpam-smbpass</application> package "

"will sync system users and passwords with the Samba user database."

msgid ""

"<emphasis>security = domain:</emphasis> this mode allows the Samba server to "

"appear to Windows clients as a Primary Domain Controller (PDC), Backup "

"Domain Controller (BDC), or a Domain Member Server (DMS). See <xref "

"linkend=\"samba-dc\"/> for further information."

msgid ""

"<emphasis>security = ADS:</emphasis> allows the Samba server to join an "

"Active Directory domain as a native member. See <xref linkend=\"samba-ad-"

"integration\"/> for details."

msgid ""

"<emphasis>security = server:</emphasis> this mode is left over from before "

"Samba could become a member server, and due to some security issues should "

"not be used. See the <ulink url=\"http://samba.org/samba/docs/man/Samba-"

"HOWTO-Collection/ServerType.html#id349531\">Server Security</ulink> section "

"of the Samba guide for more details."

msgid ""

"<emphasis>security = share:</emphasis> allows clients to connect to shares "

"without supplying a username and password."

msgid ""

"The security mode you choose will depend on your environment and what you "

"need the Samba server to accomplish."

msgid ""

"This section will reconfigure the Samba file and print server, from <xref "

"linkend=\"samba-fileserver\"/> and <xref linkend=\"samba-printserver\"/>, to "

"require authentication."

msgid ""

"First, install the <application>libpam-smbpass</application> package which "

"will sync the system users to the Samba user database:"

msgid ""

"If you chose the <emphasis>Samba Server</emphasis> task during installation "

"<application>libpam-smbpass</application> is already installed."

msgid ""

"Edit <filename>/etc/samba/smb.conf</filename>, and in the "

"<emphasis>[share]</emphasis> section change:"

msgid ""

"\n"

"    guest ok = no\n"

msgid ""

"Now when connecting to the shared directories or printers you should be "

"prompted for a username and password."

msgid ""

"If you choose to map a network drive to the share you can check the "

"<quote>Reconnect at Logon</quote> check box, which will require you to only "

"enter the username and password once, at least until the password changes."

msgid ""

"There are several options available to increase the security for each "

"individual shared directory. Using the <emphasis>[share]</emphasis> example, "

"this section will cover some common options."

msgid ""

"Groups define a collection of computers or users which have a common level "

"of access to particular network resources and offer a level of granularity "

"in controlling access to such resources. For example, if a group <emphasis "

"role=\"italic\">qa</emphasis> is defined and contains the users <emphasis "

"role=\"italic\">freda</emphasis>, <emphasis "

"role=\"italic\">danika</emphasis>, and <emphasis "

"role=\"italic\">rob</emphasis> and a second group <emphasis "

"role=\"italic\">support</emphasis> is defined and consists of users "

"<emphasis role=\"italic\">danika</emphasis>, <emphasis "

"role=\"italic\">jeremy</emphasis>, and <emphasis "

"role=\"italic\">vincent</emphasis> then certain network resources configured "

"to allow access by the <emphasis role=\"italic\">qa</emphasis> group will "

"subsequently enable access by freda, danika, and rob, but not jeremy or "

"vincent. Since the user <emphasis role=\"italic\">danika</emphasis> belongs "

"to both the <emphasis role=\"italic\">qa</emphasis> and <emphasis "

"role=\"italic\">support</emphasis> groups, she will be able to access "

"resources configured for access by both groups, whereas all other users will "

"have only access to resources explicitly allowing the group they are part of."

msgid ""

"By default Samba looks for the local system groups defined in "

"<filename>/etc/group</filename> to determine which users belong to which "

"groups. For more information on adding and removing users from groups see "

"<xref linkend=\"adding-deleting-users\"/>."

msgid ""

"When defining groups in the Samba configuration file, "

"<filename>/etc/samba/smb.conf</filename>, the recognized syntax is to "

"preface the group name with an \"@\" symbol. For example, if you wished to "

"define a group named <emphasis role=\"italic\">sysadmin</emphasis> in a "

"certain section of the <filename>/etc/samba/smb.conf</filename>, you would "

"do so by entering the group name as <emphasis "

"role=\"bold\">@sysadmin</emphasis>."

msgid ""

"File Permissions define the explicit rights a computer or user has to a "

"particular directory, file, or set of files. Such permissions may be defined "

"by editing the <filename>/etc/samba/smb.conf</filename> file and specifying "

"the explicit permissions of a defined file share."

msgid ""

"For example, if you have defined a Samba share called "

"<emphasis>share</emphasis> and wish to give <emphasis role=\"italic\">read-"

"only</emphasis> permissions to the group of users known as <emphasis "

"role=\"italic\">qa</emphasis>, but wanted to allow writing to the share by "

"the group called <emphasis role=\"italic\">sysadmin</emphasis> and the user "

"named <emphasis role=\"italic\">vincent</emphasis>, then you could edit the "

"<filename>/etc/samba/smb.conf</filename> file, and add the following entries "

"under the <emphasis>[share]</emphasis> entry:"

msgid ""

"\n"

"    read list = @qa\n"

"    write list = @sysadmin, vincent\n"

msgid ""

"Another possible Samba permission is to declare "

"<emphasis>administrative</emphasis> permissions to a particular shared "

"resource. Users having administrative permissions may read, write, or modify "

"any information contained in the resource the user has been given explicit "

"administrative permissions to."

msgid ""

"For example, if you wanted to give the user <emphasis "

"role=\"italic\">melissa</emphasis> administrative permissions to the "

"<emphasis role=\"italic\">share</emphasis> example, you would edit the "

"<filename>/etc/samba/smb.conf</filename> file, and add the following line "

"under the <emphasis>[share]</emphasis> entry:"

msgid ""

"\n"

"    admin users = melissa\n"

msgid ""

"After editing <filename>/etc/samba/smb.conf</filename>, restart Samba for "

"the changes to take effect:"

msgid ""

"For the <emphasis>read list</emphasis> and <emphasis>write list</emphasis> "

"to work the Samba security mode must <emphasis>not</emphasis> be set to "

"<emphasis role=\"italic\">security = share</emphasis>"

msgid ""

"Now that Samba has been configured to limit which groups have access to the "

"shared directory, the filesystem permissions need to be updated."

msgid ""

"Traditional Linux file permissions do not map well to Windows NT Access "

"Control Lists (ACLs). Fortunately POSIX ACLs are available on Ubuntu servers "

"providing more fine grained control. For example, to enable ACLs on "

"<filename>/srv</filename> an EXT3 filesystem, edit "

"<filename>/etc/fstab</filename> adding the <emphasis>acl</emphasis> option:"

msgid ""

"\n"

"UUID=66bcdd2e-8861-4fb0-b7e4-e61c569fe17d /srv  ext3    noatime,relatime,acl "

"0       1\n"

msgid ""

"The above example assumes <filename>/srv</filename> on a separate partition. "

"If <filename>/srv</filename>, or wherever you have configured your share "

"path, is part of the <filename>/</filename> partition a reboot may be "

"required."

msgid ""

"To match the Samba configuration above the <emphasis>sysadmin</emphasis> "

"group will be given read, write, and execute permissions to "

"<filename>/srv/samba/share</filename>, the <emphasis>qa</emphasis> group "

"will be given read and execute permissions, and the files will be owned by "

"the username <emphasis>melissa</emphasis>. Enter the following in a terminal:"

msgid ""

"The <application>setfacl</application> command above gives "

"<emphasis>execute</emphasis> permissions to all files in the "

"<filename>/srv/samba/share</filename> directory, which you may or may not "

"want."

msgid ""

"Now from a Windows client you should notice the new file permissions are "

"implemented. See the <application>acl</application> and "

"<application>setfacl</application> man pages for more information on POSIX "

"ACLs."

msgid ""

"Ubuntu comes with the <application>AppArmor</application> security module, "

"which provides mandatory access controls. The default AppArmor profile for "

"Samba will need to be adapted to your configuration. For more details on "

"using AppArmor see <xref linkend=\"apparmor\"/>."

msgid ""

"There are default AppArmor profiles for <filename>/usr/sbin/smbd</filename> "

"and <filename>/usr/sbin/nmbd</filename>, the Samba daemon binaries, as part "

"of the <application>apparmor-profiles</application> packages. To install the "

"package, from a terminal prompt enter:"

msgid ""

"By default the profiles for <application>smbd</application> and "

"<application>nmbd</application> are in <emphasis>complain</emphasis> mode "

"allowing Samba to work without modifying the profile, and only logging "

"errors. To place the <application>smbd</application> profile into "

"<emphasis>enforce</emphasis> mode, and have Samba work as expected, the "

"profile will need to be modified to reflect any directories that are shared."

msgid ""

"Edit <filename>/etc/apparmor.d/usr.sbin.smbd</filename> adding information "

"for <emphasis>[share]</emphasis> from the file server example:"

msgid ""

"\n"

"  /srv/samba/share/ r,\n"

"  /srv/samba/share/** rwkix,\n"

msgid ""

"Now place the profile into <emphasis>enforce</emphasis> and reload it:"

msgid ""

"You should now be able to read, write, and execute files in the shared "

"directory as normal, and the <application>smbd</application> binary will "

"have access to only the configured files and directories. Be sure to add "

"entries for each directory you configure Samba to share. Also, any errors "

"will be logged to <filename>/var/log/syslog</filename>."

msgid ""

"O'Reilly's <ulink "

"url=\"http://www.oreilly.com/catalog/9780596007690/\">Using Samba</ulink> is "

"also a good reference."

msgid ""

"<ulink url=\"http://samba.org/samba/docs/man/Samba-HOWTO-Collection/securing-"

"samba.html\">Chapter 18</ulink> of the Samba HOWTO Collection is devoted to "

"security."

msgid ""

"For more information on Samba and ACLs see the <ulink "

"url=\"http://samba.org/samba/docs/man/Samba-HOWTO-"

"Collection/AccessControls.html#id397568\">Samba ACLs page </ulink>."

msgid ""

"Although it cannot act as an Active Directory Primary Domain Controller "

"(PDC), a Samba server can be configured to appear as a Windows NT4-style "

"domain controller. A major advantage of this configuration is the ability to "

"centralize user and machine credentials. Samba can also use multiple "

"backends to store the user information."

msgid ""

"This section covers configuring Samba as a Primary Domain Controller (PDC) "

"using the default smbpasswd backend."

msgid ""

"First, install Samba, and <application>libpam-smbpass</application> to sync "

"the user accounts, by entering the following in a terminal prompt:"

msgid ""

"Next, configure Samba by editing <filename>/etc/samba/smb.conf</filename>. "

"The <emphasis>security</emphasis> mode should be set to <emphasis "

"role=\"italic\">user</emphasis>, and the <emphasis>workgroup</emphasis> "

"should relate to your organization:"

msgid ""

"In the commented <quote>Domains</quote> section add or uncomment the "

"following:"

msgid ""

"\n"

"   domain logons = yes\n"

"   logon path = \\\\%N\\%U\\profile\n"

"   logon drive = H:\n"

"   logon home = \\\\%N\\%U\n"

"   logon script = logon.cmd\n"

"   add machine script = sudo /usr/sbin/useradd -N -g machines -c Machine -d "

"/var/lib/samba -s /bin/false %u\n"

msgid ""

"<emphasis>domain logons:</emphasis> provides the netlogon service causing "

"Samba to act as a domain controller."

msgid ""

"<emphasis>logon path:</emphasis> places the user's Windows profile into "

"their home directory. It is also possible to configure a "

"<emphasis>[profiles]</emphasis> share placing all profiles under a single "

"directory."

msgid ""

"<emphasis>logon drive:</emphasis> specifies the home directory local path."

msgid ""

"<emphasis>logon home:</emphasis> specifies the home directory location."

msgid ""

"<emphasis>logon script:</emphasis> determines the script to be run locally "

"once a user has logged in. The script needs to be placed in the "

"<emphasis>[netlogon]</emphasis> share."

msgid ""

"<emphasis>add machine script:</emphasis> a script that will automatically "

"create the <emphasis>Machine Trust Account</emphasis> needed for a "

"workstation to join the domain."

msgid ""

"In this example the <emphasis>machines</emphasis> group will need to be "

"created using the <application>addgroup</application> utility see <xref "

"linkend=\"adding-deleting-users\"/> for details."

msgid ""

"If you wish to not use <emphasis>Roaming Profiles</emphasis> leave the "

"<emphasis>logon home</emphasis> and <emphasis>logon path</emphasis> options "

"commented."

msgid ""

"Uncomment the <emphasis>[homes]</emphasis> share to allow the <emphasis "

"role=\"italic\">logon home</emphasis> to be mapped:"

msgid ""

"\n"

"[homes]\n"

"   comment = Home Directories\n"

"   browseable = no\n"

"   read only = no\n"

"   create mask = 0700\n"

"   directory mask = 0700\n"

"   valid users = %S\n"

msgid ""

"When configured as a domain controller a <emphasis>[netlogon]</emphasis> "

"share needs to be configured. To enable the share, uncomment:"

msgid ""

"\n"

"[netlogon]\n"

"   comment = Network Logon Service\n"

"   path = /srv/samba/netlogon\n"

"   guest ok = yes\n"

"   read only = yes\n"

"   share modes = no\n"

msgid ""

"The original <emphasis>netlogon</emphasis> share path is "

"<filename>/home/samba/netlogon</filename>, but according to the Filesystem "

"Hierarchy Standard (FHS), <ulink url=\"http://www.pathname.com/fhs/pub/fhs-"

"2.3.html#SRVDATAFORSERVICESPROVIDEDBYSYSTEM\">/srv</ulink> is the correct "

"location for site-specific data provided by the system."

msgid ""

"Now create the <filename role=\"directory\">netlogon</filename> directory, "

"and an empty (for now) <filename>logon.cmd</filename> script file:"

msgid ""

"You can enter any normal Windows logon script commands in "

"<filename>logon.cmd</filename> to customize the client's environment."

msgid ""

"With <emphasis>root</emphasis> being disabled by default, in order to join a "

"workstation to the domain, a system group needs to be mapped to the Windows "

"<emphasis>Domain Admins</emphasis> group. Using the "

"<application>net</application> utility, from a terminal enter:"

msgid ""

"sudo net groupmap add ntgroup=\"Domain Admins\" unixgroup=sysadmin rid=512 "

"type=d"

msgid ""

"Change <emphasis role=\"italic\">sysadmin</emphasis> to whichever group you "

"prefer. Also, the user used to join the domain needs to be a member of the "

"<emphasis>sysadmin</emphasis> group, as well as a member of the system "

"<emphasis>admin</emphasis> group. The <emphasis>admin</emphasis> group "

"allows <application>sudo</application> use."

msgid ""

"You should now be able to join Windows clients to the Domain in the same "

"manner as joining them to an NT4 domain running on a Windows server."

msgid ""

"With a Primary Domain Controller (PDC) on the network it is best to have a "

"Backup Domain Controller (BDC) as well. This will allow clients to "

"authenticate in case the PDC becomes unavailable."

msgid ""

"When configuring Samba as a BDC you need a way to sync account information "

"with the PDC. There are multiple ways of accomplishing this "

"<application>scp</application>, <application>rsync</application>, or by "

"using <application>LDAP</application> as the <emphasis>passdb "

"backend</emphasis>."

msgid ""

"Using LDAP is the most robust way to sync account information, because both "

"domain controllers can use the same information in real time. However, "

"setting up a LDAP server may be overly complicated for a small number of "

"user and computer accounts. See <xref linkend=\"samba-ldap\"/> for details."

msgid ""

"First, install <application>samba</application> and <application>libpam-"

"smbpass</application>. From a terminal enter:"

msgid ""

"Now, edit <filename>/etc/samba/smb.conf</filename> and uncomment the "

"following in the <emphasis>[global]</emphasis>:"

msgid ""

"\n"

"   domain logons = yes\n"

"   domain master = no\n"

msgid ""

"Make sure a user has rights to read the files in "

"<filename>/var/lib/samba</filename>. For example, to allow users in the "

"<emphasis>admin</emphasis> group to <application>scp</application> the "

"files, enter:"

msgid ""

"Next, sync the user accounts, using <application>scp</application> to copy "

"the <filename>/var/lib/samba</filename> directory from the PDC:"

msgid ""

"Replace <emphasis>username</emphasis> with a valid username and "

"<emphasis>pdc</emphasis> with the hostname or IP Address of your actual PDC."

msgid ""

"You can test that your Backup Domain controller is working by stopping the "

"Samba daemon on the PDC, then trying to login to a Windows client joined to "

"the domain."

msgid ""

"Another thing to keep in mind is if you have configured the <emphasis>logon "

"home</emphasis> option as a directory on the PDC, and the PDC becomes "

"unavailable, access to the user's <emphasis>Home</emphasis> drive will also "

"be unavailable. For this reason it is best to configure the <emphasis>logon "

"home</emphasis> to reside on a separate file server from the PDC and BDC."

msgid ""

"<ulink url=\"http://samba.org/samba/docs/man/Samba-HOWTO-Collection/samba-"

"pdc.html\">Chapter 4</ulink> of the Samba HOWTO Collection explains setting "

"up a Primary Domain Controller."

msgid ""

"<ulink url=\"http://us3.samba.org/samba/docs/man/Samba-HOWTO-"

"Collection/samba-bdc.html\">Chapter 5</ulink> of the Samba HOWTO Collection "

"explains setting up a Backup Domain Controller."

msgid ""

"Another, use for Samba is to integrate into an existing Windows network. "

"Once part of an Active Directory domain, Samba can provide file and print "

"services to AD users."

msgid ""

"The simplest way to join an AD domain is to use <application>Likewise-"

"open</application>. For detailed instructions see <xref linkend=\"likewise-"

"open\"/>."

msgid "Once part of the domain, install the following packages:"

msgid ""

"Since the <application>likewise-open</application> and "

"<application>samba</application> packages use separate "

"<filename>secrets.tdb</filename> files, a symlink will need to be created in "

"<filename role=\"directory\">/var/lib/samba</filename>:"

msgid ""

"\n"

"   workgroup = EXAMPLE\n"

"   ...\n"

"   security = ads\n"

"   realm = EXAMPLE.COM\n"

"   ...\n"

"   idmap backend = lwopen\n"

"   idmap uid = 50-9999999999\n"

"   idmap gid = 50-9999999999\n"

msgid ""

"Restart <application>samba</application> for the new settings to take effect:"

msgid ""

"You should now be able to access any <application>Samba</application> shares "

"from a Windows client. However, be sure to give the appropriate AD users or "

"groups access to the share directory. See <xref linkend=\"samba-fileprint-"

"security\"/> for more details."

msgid ""

"Now that the Samba server is part of the Active Directory domain you can "

"access any Windows server shares:"

msgid ""

"To mount a Windows file share enter the following in a terminal prompt:"

msgid ""

"It is also possible to access shares on computers not part of an AD domain, "

"but a username and password will need to be provided."

msgid ""

"To mount the share during boot place an entry in "

"<filename>/etc/fstab</filename>, for example:"

msgid ""

"\n"

"//192.168.0.5/share /mnt/windows cifs auto,username=steve,password=secret,rw "

"0        0\n"

msgid ""

"Another way to copy files from a Windows server is to use the "

"<application>smbclient</application> utility. To list the files in a Windows "

"share:"

msgid ""

"This will copy the <filename>file.txt</filename> into the current directory."

msgid ""

"This will copy the <filename>/etc/hosts</filename> to "

"<filename>//fs01.example.com/share/hosts</filename>."

msgid ""

"The <emphasis>-c</emphasis> option used above allows you to execute the "

"<application>smbclient</application> command all at once. This is useful for "

"scripting and minor file operations. To enter the <emphasis>smb: \\"

"&gt;</emphasis> prompt, a FTP like prompt where you can execute normal file "

"and directory commands, simply execute:"

msgid ""

"Replace all instances of <emphasis>fs01.example.com/share</emphasis>, "

"<emphasis>//192.168.0.5/share</emphasis>, "

"<emphasis>username=steve,password=secret</emphasis>, and "

"<emphasis>file.txt</emphasis> with your server's IP, hostname, share name, "

"file name, and an actual username and password with rights to the share."

msgid ""

"For more <application>smbclient</application> options see the man page: "

"<command>man smbclient</command>, also available <ulink "

"url=\"http://manpages.ubuntu.com/manpages/jaunty/en/man1/smbclient.1.html\">o"

"nline</ulink>."

msgid ""

"The <application>mount.cifs</application><ulink "

"url=\"http://manpages.ubuntu.com/manpages/jaunty/en/man8/mount.cifs.8.html\">"

"man page</ulink> is also useful for more detailed information."

msgid ""

"<application>Likewise Open</application> simplifies the necessary "

"configuration needed to authenticate a Linux machine to an Active Directory "

"domain. Based on <application>winbind</application>, the "

"<application>likewise-open</application> package takes the pain out of "

"integrating Ubuntu authentication into an existing Windows network."

msgid ""

"There are two ways to use Likewise Open, <application>likewise-"

"open</application> the command line utility and <application>likewise-open-"

"gui</application>. This section focuses on the command line utility."

msgid ""

"To install the <application>likewise-open</application> package, open a "

"terminal prompt and enter:"

msgid ""

"With Ubuntu 9.04 <application>Likewise Open 5.0</application> is available "

"in the <emphasis>Universe</emphasis> repository. However, since upgrading "

"from <application>Likewise Open 4.1</application> currently requires the "

"system to leave the domain and re-join, a separate package for version five "

"was created."

msgid ""

"Installing likewise-open5 over an existing likewise-open (4.1) installation "

"will replace it. You will have to rejoin the domain after install."

msgid ""

"The main executable file of the <application>likewise-open</application> "

"package is <filename>/usr/bin/domainjoin-cli</filename>, which is used to "

"join your computer to the domain. Before you join a domain you will need to "

"make sure you have:"

msgid ""

"Access to an Active Directory user with appropriate rights to join the "

"domain."

msgid ""

"The <emphasis>Fully Qualified Domain Name</emphasis> (FQDN) of the domain "

"you want to join. If your AD domain does not match a valid domain such as "

"<emphasis role=\"italic\">example.com</emphasis>, it is likely that it has "

"the form of <emphasis>domainname.local</emphasis>."

msgid ""

"DNS for the domain setup properly. In a production AD environment this "

"should be the case. Proper Microsoft DNS is needed so that client "

"workstations can determine the Active Directory domain is available."

msgid ""

"If you don't have a Windows DNS server on your network, see <xref "

"linkend=\"likewise-open-ms-dns\"/> for details."

msgid ""

"Replace <emphasis>example.com</emphasis> with your domain name, and "

"<emphasis>Administrator</emphasis> with the appropriate user name."

msgid ""

"You will then be prompted for the user's password. If all goes well a "

"<emphasis>SUCCESS</emphasis> message should be printed to the console."

msgid ""

"After joining the domain, it is necessary to reboot before attempting to "

"authenticate against the domain."

msgid ""

"After successfully joining an Ubuntu machine to an Active Directory domain "

"you can authenticate using any valid AD user. To login you will need to "

"enter the user name as 'domain\\username'. For example to ssh to a server "

"joined to the domain enter:"

msgid ""

"If configuring a Desktop the user name will need to be prefixed with "

"<emphasis role=\"italic\">domain\\</emphasis> in the graphical logon as well."

msgid ""

"To make likewise-open use a default domain, you can add the following "

"statement to <filename>/etc/samba/lwiauthd.conf</filename>:"

msgid ""

"\n"

"winbind use default domain = yes\n"

msgid ""