LIBCTDB: add support for traverse
[sahlberg/ctdb.git] / web / ftp.html
index e9f11d5b2f478053fe59fcf38175f7a9b7e924fa..82acd1d9094516db1db70ad0f24e6ea529dbcbf1 100644 (file)
@@ -1,8 +1,4 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
-<HTML>
-<HEAD>
-<TITLE>Setting up clustered FTP</TITLE>
-</HEAD>
+<!--#set var="TITLE" value="CTDB and ftp" -->
 <!--#include virtual="header.html" -->
 
 <h1>Setting up clustered FTP</h1>
@@ -17,9 +13,9 @@ Setting up a vsftpd cluster is really easy.<br>
 Configure vsftpd on each node on the cluster.<br><br>
 Set up vsftpd to export directories from the shared cluster filesystem.
 
-<h2>/etc/sysconfig/vsftpd</h2>
+<h2>/etc/sysconfig/ctdb</h2>
 
-Create the file /etc/sysconfig/vsftpd with the content :
+Add the following line to the /etc/sysconfig/ctdb configuration file.
 <pre>
   CTDB_MANAGES_VSFTPD=yes
 </pre>
@@ -29,6 +25,45 @@ Disable vsftpd in chkconfig so that it does not start by default. Instead CTDB w
   chkconfig vsftpd off
 </pre>
 
+<h2>PAM configuration</h2>
+PAM must be configured to allow authentication of CIFS users so that the ftp 
+daemon can authenticate the users logging in.
+
+Make sure the following line is present in /etc/pam.d/system-auth
+<pre>
+auth        sufficient    pam_winbind.so use_first_pass
+
+</pre>
+If this line is missing you must enable winbind authentication by running 
+<pre>
+authconfig  --enablewinbindauth --update
+authconfig  --enablewinbind --update
+</pre>
+
+<h2>Default shell</h2>
+To log in to the ftp server, the user must have a shell configured in smb.conf.
+
+Add the following line to the globals section of /etc/samba/smb.conf 
+<pre>
+       template shell = /bin/bash
+</pre>
+
+<h2>Home directory</h2>
+FTP users must have a home directory configured so they can log in.
+Configure samba to provide home directories for domain users. These home 
+directories should be stored on shared storage so they are available from
+all nodes in the cluster.<br>
+
+
+A simple way to create homedirectories are to add
+<pre>
+       template homedir = /&lt;shared storage&gt;/homedir/%D/%U
+</pre>
+to /etc/samba/smb.conf .<br>
+
+The homedirectory must exist or the user will not be able to log in with FTP.
+
+
 <h2>Events script</h2>
 
 The CTDB distribution already comes with an events script for vsftp in the file /etc/ctdb/events.d/40.vsftpd<br><br>