ftp-server/en_US ftp-server.xml,NONE,1.1

[Paul W. Frields (pfrields)]

Author: pfrields

Update of /cvs/docs/ftp-server/en_US
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv3536/ftp-server/en_US

Added Files:
	ftp-server.xml 
Log Message:
Fix structure for Andrea


--- NEW FILE ftp-server.xml ---
<!-- bl99: -->

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
]>

<article id="FtpServer">
<section id="Zero">
<title>Credits and License</title>
<para>Document Created and Maintained by Andrea Veri</para>
<para> Copyright :</para>
     		<itemizedlist>
			<listitem>
				<para>Holder: Andrea Veri</para>
			</listitem>
                        <listitem>
				<para>Year: 2006</para>
			</listitem>
       		</itemizedlist>
</section>
  <section id="One">
    <title>Ftp Server Settings</title>
    <indexterm>
      <primary>Index term</primary>
    </indexterm>
    <para>
     This Document will provide a lot of usefull informations regarding Ftp Servers, we will explain three different
     methods to run ftp servers, making examples that will make user's life easier. One of the three methods it's related
     to the MySql server, we will provide for it a paragraph that will explain how you can recover your server password if
     you have lost it.
     Methods List:</para>    
     		<itemizedlist>
			<listitem>
				<para>Anonymous FTP</para>
			</listitem>
                        <listitem>
				<para>FTP with both anonymous access and users with a passworded account</para>
			</listitem>
                        <listitem>
				<para>FTP with mysql support for virtual users authentication</para>
			</listitem>
                      
       		</itemizedlist>
</section>
  <section id="Two">
    <title>Methods Explanation</title>
  		<itemizedlist>
			<listitem>
				<para>First Method: People can enter inside the server only with the anonymous account that havent got any password ,of course the server administrator will put a limit for the uploads to prevent users to put inside the server illegal files like pirated music/films/games.</para>
			</listitem>
                        <listitem>
				<para>Second Method: This method let both anonymous and passworded account people to enter the server of course they will only access to a specified directory except for the user root that can view/modify/delete all files and/or folders.</para>
			</listitem>
                        <listitem>
				<para>Third Method: This method let access the server only for some users groups that havent got a virtual users authentication shell account into the system. It uses a external mysql server that stores users informations.</para>
			</listitem>
                </itemizedlist>
</section>
<section id="Three">
<title>First Option : Anonymous FTP</title>         
<para>
Before start the creation of an anonymous ftp server ,you have to add a user called ftp into your system ,with a home directory too.This step is really easy, just follow this commands :

useradd -d /home/ftp/ftp -s /bin/false ftp

mkdir -p /home/ftp/upload

Doing this only this account can be used to write in this folder. You can use more variables to specify what the ftp server will do here are some examples :</para>
  		<itemizedlist>
			<listitem>
				<para>-e let access the server only to anonymous users</para>
			</listitem>
                        <listitem>
				<para>-s ftp user files cannot be downloaded</para>
			</listitem>
                        <listitem>
				<para>-M let anonymous users to create folders</para>
			</listitem>
                        <listitem>
				<para>-B it start the server with background demon</para>
			</listitem>
                        <listitem>
				<para>-i anonymous users cant upload files</para>
			</listitem>
			
                </itemizedlist>
</section>
<section id="Four">
<title>Second Option : Both anonymous and passworded account users</title>         
<para>To make possible to have in the same server both anonymous and passworded account users ,follow this easy commands:</para>
  		<itemizedlist>
			<listitem>
				<para>-B ,-i ,M, -r, -s same as above</para>
			</listitem>
                        <listitem>
				<para>-u uid unable users with a specified uid to access the server</para>
			</listitem>
                        <listitem>
				<para>-V Ip address only specified IPs will be able to access the server in non-anonymous mode</para>
			</listitem>

                </itemizedlist>
</section>
<section id="Five">
<title>Third Option : Virtual Users with Mysql Server support</title>         
<para>To create a server with mysql support follow this steps :</para>

  		<itemizedlist>
			<listitem>
				<para> Download and install User Manager for PureFTPdyou can find it <ulink url="http://machiel.generaal.net/index.php?subject=user_manager_pureftpd">Here</ulink> </para>
			</listitem>
                        <listitem>
				<para> decompress it and upload all its contenute into your web server www directory and then point your browser to <ulink url="http://localhost/ftp/install.php">This Link</ulink></para>
			</listitem>
                        <listitem>
				<para>
Follow all the steps that the installer asks to you and copy and save pureftpd-mysql.conf into pureftpd user manager directory.
</para>
			</listitem>
                        <listitem>
                                <para>Done .Access to the administration panel using <ulink url="http://localhost/ftp">This Link</ulink></para>
                        </listitem>

                </itemizedlist>
</section>
<section id="Six">
<title>Mysql Password recovery (Usefull if you have lost your MySql root password)</title>         
<para>Follow this easy steps to reset your password:</para>
  		<itemizedlist>
			<listitem>
				<para> Stop the mysql demon process using this command : /etc/init.d/mysql stop</para>
			</listitem>
                        <listitem>
				<para> Start the mysqld demon process using the --skip-grant-tables option with this command(/usr/bin/mysqld --skip-grant-tables)</para>
			</listitem>
                        <listitem>
				<para>
start the mysql client process (mysql -u root)
</para>
			</listitem>
                        <listitem>
                                <para>Reset/Update your password [SET PASSWORD FOR root@'localhost' = PASSWORD('password') ]</para>
                        </listitem>

                </itemizedlist>
  		<itemizedlist>
			<listitem>
				<para>This will only change the root password for root at localhost. If you have a root that can connect from everywhere, you should also do: SET PASSWORD FOR root@'%' = PASSWORD('password')</para>
			</listitem>
                        
                        <listitem>
                                <para>Then stop the mysqld process and relaunch it with the classical way: /etc/init.d/mysql start</para>
                        </listitem>

                </itemizedlist>
<para>When you have completed all this steps ,you can easily access to your mysql server with the password you have set in the step before. An easy way to have a full control of your mysql server is (<ulink url="http://www.phpmyadmin.net">PhpMyAdmin</ulink>), software made in php that can give you a web interface that can be very usefull to people that havent got a lot of confidence with bash .To install phpmyadmin on you server you will need to have three things:</para>
                <itemizedlist>
			<listitem>
<para> web server apache with php_mysql support for apache</para>
                        </listitem>
                        <listitem>
                                <para>mysql server/mysql client installed</para>
                        </listitem>
                        <listitem>
<para>Php</para>
                        </listitem>
                </itemizedlist>
</section>
<para>More to be added</para>
</article>