Merge lp:~nacc/serverguide/samba into lp:serverguide

[Nish Aravamudan]

Note that I am unable to test much of the configuration, due to not having a Windows environment, but I verified at least the package naming/availability in 16.04.

[Doug Smythies (dsmythies)]

Nish, thanks very much for this.

I see that when the entire serverguide was updated for "sudo systemctl restart/start/stop/..." two were missed in the Samba chapter. ( I see 4 also were missed in file-server.xml )

However, the entire serverguide uses the "sudo systemctl restart bla.service" method not the shortened version, "sudo systemctl restart bla". It would be preferable to be consistent over the whole document.

So, evidently all my troubles in January and February were because I didn't know to load the "libpam-winbind" package. I'll try that as soon as I can, however I am running low on time before I will be away from internet for a week.

[lp:~nacc/serverguide/samba]

290. By Nish Aravamudan on 2016-04-29

  Update for Samba4
   - Use libpam-winbind instead of libpam-smbpass
   - Use cifs-utils instead of smbfs
   - Be consistent in use of `systemctl restart smbd.service nmbd.service`

[Nish Aravamudan (nacc)]

Hi Doug,

Thanks for the quick response!

I've updated the systemctl references in the branch.

I would expect your troubles with Xenial are primarily with the lack of smbpass, but I really don't know :) It would be great for you to test and see if it does fix it for you -- I also noticed in this process that we weren't seeding libpam-winbind as part of the 'samba-server' seed, so that's a bugfix I've sent in for Xenial (won't help until .1 probably) and Yak.

[Doug Smythies (dsmythies)]

Nish, thanks for your update.

Back in February, I did manage to get Samba working again, but could only do so by adding the samba users and samba password file, which I had never had to do before. I'll try again with this new information. However, I am really running short of time, so If I can't get to it tonight, it might have to wait for a week.

[Doug Smythies (dsmythies)]

O.K. Thanks very much.

review: Approve

=== modified file 'serverguide/C/network-auth.xml'
--- serverguide/C/network-auth.xml	2016-03-19 02:00:31 +0000
+++ serverguide/C/network-auth.xml	2016-04-29 23:07:33 +0000
@@ -2218,8 +2218,8 @@
   <title>Software Installation</title>
   
 	<para>
-	There are three packages needed when integrating Samba with LDAP: <application>samba</application>, <application>samba-doc</application>,
-	and <application>smbldap-tools</application> packages.
+	There are two packages needed when integrating Samba with LDAP: <application>samba</application>
+	and <application>smbldap-tools</application>.
 	</para>
 
 	<para>
@@ -2232,7 +2232,7 @@
 	</para>
 
 <screen>
-<command>sudo apt install samba samba-doc smbldap-tools</command>
+<command>sudo apt install samba smbldap-tools</command>
 </screen>
 
   </sect2>
@@ -2278,12 +2278,12 @@
 
 	<step>
 		<para>
-		The schema is found in the now-installed <application>samba-doc</application> package. It needs to be unzipped and copied to 
+		The schema is found in the now-installed <application>samba</application> package. It needs to be unzipped and copied to 
 		the <filename>/etc/ldap/schema</filename> directory:
 		</para>
         
 <screen>
-<command>sudo cp /usr/share/doc/samba-doc/examples/LDAP/samba.schema.gz /etc/ldap/schema</command>
+<command>sudo cp /usr/share/doc/samba/examples/LDAP/samba.schema.gz /etc/ldap/schema</command>
 <command>sudo gzip -d /etc/ldap/schema/samba.schema.gz</command>
 </screen>
 
@@ -2529,8 +2529,7 @@
 	</para>
 
 <screen>
-<command>sudo restart smbd</command>
-<command>sudo restart nmbd</command>
+<command>sudo systemctl restart smbd.service nmbd.service</command>
 </screen>
 
 	<para>

=== modified file 'serverguide/C/samba.xml'
--- serverguide/C/samba.xml	2016-03-19 02:00:31 +0000
+++ serverguide/C/samba.xml	2016-04-29 23:07:33 +0000
@@ -74,7 +74,7 @@
 
     <para>
     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"/>
+    your environment requires stricter Access Controls see <xref linkend="samba-fileprint-security"/>.
     </para>
 
     <sect2 id="samba-fileserver-installation" status="review">
@@ -394,7 +394,7 @@
         <listitem>
           <para>
           <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> 
+          Samba user accounts are separate from system accounts, but the <application>libpam-winbind</application> 
           package will sync system users and passwords with the Samba user database.
           </para>
         </listitem>
@@ -441,17 +441,17 @@
       </para>
 
       <para>
-      First, install the <application>libpam-smbpass</application> package which will sync the system users to the Samba
+      First, install the <application>libpam-winbind</application> package which will sync the system users to the Samba
       user database:
       </para>
 
 <screen>
-<command>sudo apt install libpam-smbpass</command>
+<command>sudo apt install libpam-winbind</command>
 </screen>
 
       <note>
         <para>
-        If you chose the <emphasis>Samba Server</emphasis> task during installation <application>libpam-smbpass</application>
+        If you chose the <emphasis>Samba Server</emphasis> task during installation <application>libpam-winbind</application>
         is already installed.
         </para>
       </note>
@@ -760,12 +760,12 @@
         <step>
 
           <para>
-          First, install Samba, and <application>libpam-smbpass</application> to sync the user accounts,
+          First, install Samba, and <application>libpam-winbind</application> to sync the user accounts,
           by entering the following in a terminal prompt:
           </para>
 
 <screen>
-<command>sudo apt install samba libpam-smbpass</command>
+<command>sudo apt install samba libpam-winbind</command>
 </screen>
         
         </step>
@@ -1001,11 +1001,11 @@
         <step>
    
           <para>
-          First, install <application>samba</application> and <application>libpam-smbpass</application>.  From a terminal enter:
+          First, install <application>samba</application> and <application>libpam-winbind</application>.  From a terminal enter:
           </para>
 
 <screen>
-<command>sudo apt install samba libpam-smbpass</command>
+<command>sudo apt install samba libpam-winbind</command>
 </screen>
 
         </step>
@@ -1155,7 +1155,7 @@
       </para>
 
 <screen>
-<command>sudo apt install samba smbfs smbclient</command>
+<command>sudo apt install samba cifs-utils smbclient</command>
 </screen>
 
       <para>