Server Guide Network-Apps patch
Bhuvaneswaran
bhuvan at ubuntu.com
Wed Nov 30 05:15:06 UTC 2005
Hello,
I've included Apache2 (to be continued..) & FTP sections. In addition,
i did the changes recommended by Brian Shumate. I've attached the
patch, please verify and apply.
--
Regards,
Bhuvaneswaran
www.symonds.net/~bhuvan/
GPG: 0x7A13E5B0
-------------- next part --------------
Index: installation.xml
===================================================================
--- installation.xml (revision 2166)
+++ installation.xml (working copy)
@@ -69,15 +69,7 @@
now on your system. If this is the first time a
non-native operating system has been installed on your
computer, it's quite likely you will need to re-partition
- your disk to make room for Ubuntu Server 6.04. Anytime you
- partition your disk, you should count on losing
- everything on the disk, no matter what program you use to
- do it. The programs used in installation are quite
- reliable and most have seen years of use; but they are
- also quite powerful and a false move can cost you. Even
- after backing up be careful and think about your
- answers and actions. Two minutes of thinking can save
- hours of unnecessary work.
+ your disk to make room for Ubuntu Server 6.04. Anytime you partition your disk, you should be prepared to lose everything on the disk should you make a mistake, or something goes wrong during partitioning such as unrecoverable power loss to the system. The programs used in installation are quite reliable, and most have seen years of use, but they also perform destructive actions, and one mistake in use can result in loss of your valuable data.
</para>
<para>
Index: introduction.xml
===================================================================
--- introduction.xml (revision 2166)
+++ introduction.xml (working copy)
@@ -32,7 +32,7 @@
<itemizedlist>
<listitem><para>Installation-Related Reference</para></listitem>
<listitem><para>Package Management</para></listitem>
- <listitem><para>System Related Reference </para></listitem>
+ <listitem><para>System-Related Reference </para></listitem>
<listitem><para>Network-Related Reference </para></listitem>
</itemizedlist>
Index: network-applications.xml
===================================================================
--- network-applications.xml (revision 2166)
+++ network-applications.xml (working copy)
@@ -136,22 +136,73 @@
</sect2>
</sect1>
<sect1 id="vsftpd-ftp-server" status="writing">
- <title>vsftpd - FTP Server</title>
- <para>
- vsftpd - FTP Server para ...
- </para>
- <sect2 id="ftp-introduction" status="writing">
<title>FTP Introduction</title>
- <para>
- FTP Introduction para ...
- </para>
- </sect2>
- <sect2 id="ftp-configuration" status="writing">
- <title>FTP Configuration</title>
- <para>
- FTP Configuration para ...
- </para>
- </sect2>
+ <para>FTP (File Transfer Protocol) is a TCP protocol for uploading and downloading large
+ files between computers. FTP works on a client/server model. The server component is
+ called a <emphasis>FTP daemon</emphasis>, it continuosly checks for FTP requests
+ from remote clients. When a request is received it manages the the login and sets up
+ the connection. For the duration of a session it executes any of commands sent by
+ the FTP client.</para>
+ <para>Access to an FTP server can be managed in two ways:</para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para>Anonymous</para>
+ </listitem>
+ <listitem>
+ <para>Authenticated</para>
+ </listitem>
+ </itemizedlist>
+ <para>In the Anonymous mode, remote clients can access the FTP server using the a
+ default user called 'anonymous" or "ftp" and
+ sending thier email address as the password. In the Authenticated mode a user must
+ have an account and password. User access to the FTP server directories and files is
+ dependant on the permissions defined for the account used at login. As a general
+ rule the FTP daemon will hide the root directory of the FTP server and change it to
+ the FTP Home directory. This hides the rest of the file system from remote
+ sessions.</para>
+ <sect2>
+ <title>vsftpd - FTP Server</title>
+ <procedure><step>
+ <para>vsftpd is a FTP daemon available in
+ Ubuntu Linux. It is easy to install, setup and
+ maintain.</para></step>
+ </procedure>
+ <variablelist>
+ <varlistentry>
+ <term>Installation:</term>
+ <listitem>
+ <para>At the prompt enter the following command to install
+ <application>vsftpd</application>:</para>
+ <para>
+ <command>sudo apt-get install vsftpd</command>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ <variablelist>
+ <varlistentry>
+ <term>Configuration:</term>
+ <listitem>
+ <para>
+ You may edit vsftpd configuration file to the
+ change default settings. More information about
+ each configuration parameter is available in
+ the configuration file.
+ </para>
+ <para>
+ <command>sudo vim /etc/vsftpd.conf</command>
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Manage Service:</term>
+ <listitem>
+ <para> <command>sudo /etc/init.d/vsftpd start</command></para>
+ <para><command>sudo /etc/init.d/vsftpd stop</command> </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </sect2>
</sect1>
<sect1 id="network-file-system" status="writing">
<title>Network File System (NFS)</title>
@@ -257,31 +308,221 @@
</sect1>
<sect1 id="http" status="writing">
<title>HTTP - Apache2 Web Server</title>
- <para>
- HTTP para ...
- </para>
- <sect2 id="http-installation" status="writing">
- <title>Installation</title>
- <para>
- Installation para ...
- </para>
+ <para>Apache is the most commonly used Web Server on Linux systems. Web Servers are used
+ to serve Web Pages requested by client computers. Clients typically request and view
+ Web Pages using Web Browser applications such as <application>Firefox</application>,
+ <application>Opera</application> or <application>Mozilla</application>.</para>
+ <para>Users enter a URL (Uniform Resource Locater) to point to a Web server by means of
+ its FQDN and a path to the required resource. For example, to view the home page of
+ the <ulink url="&ubuntu-web;">Ubuntu Web site</ulink> a user will enter only the FQDN. To request specific information about
+ <ulink url="&ubuntu-paidsupport;">paid
+ support</ulink> a user will enter the FQDN followed by a path.</para>
+ <para>The most common protocol used to transfer Web pages is HTTP (HyperText Transfer
+ Protocol). Protocols such as HTTPS, a secure, encrypted version of HTTP, and FTP
+ (File Transfer Protocol), a protocol for uploading and downloading files, are also
+ supported.</para>
+ <para>Apache Web Servers are often combined with the <application>MySQL</application>
+ database, <application>PHP</application>, popular scripting languages such as
+ <application>Python</application> and <application>Perl</application>. This
+ configuration is termed LAMP (Linux, Apache, MySQL and Perl/Python/PHP) and forms a
+ powerful and robust platform for the development and serving of Web-based
+ applications.</para>
+<sect2 id="http-installation" status="writing">
+ <title>Installation</title>
+ <procedure><step>
+ <para>Apache2 web server is available in Ubuntu
+ Linux. This section explains howto install
+ Apache2 in Ubuntu Linux.</para></step>
+ </procedure>
+ <variablelist>
+ <varlistentry>
+ <term>Packages:</term>
+ <listitem>
+ <para><application>apache2</application></para>
+ <para><application>apache2-common</application></para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>Installation:</term>
+ <listitem>
+ <para>At the prompt enter the following command to install
+ <application>apache2</application> and
+ <application>apache2-common</application>:</para>
+ <para>
+ <command>sudo apt-get install apache2 apache2-common</command>
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</sect2>
<sect2 id="http-configuration" status="writing">
<title>Configuration</title>
<para>
- Configuration para ...
+ Apache is configured by placing directives in plain text
+ configuration files. The main configuration file is usually
+ called apache2.conf. The location of this file is set at
+ compile-time, but may be overridden with the -f command line
+ flag. In addition, other configuration files may be added
+ using the Include directive, and wildcards can be used to
+ include many configuration files. Any directive may be placed
+ in any of these configuration files. Changes to the main
+ configuration files are only recognized by Apache2 when it is
+ started or restarted.</para>
+
+ <para>The server also reads a file containing mime document types;
+ the filename is set by the TypesConfig directive, and is
+ mime.types by default.</para>
+
+ <para>The default Apache2 configuration file is /etc/apache2/apache2.conf.
+ You must edit this file to configure the Apache2 server. You can
+ configure the port number, document root, modules, log files,
+ virutal hosts, etc.
</para>
+ <para>
+ <command>sudo vim /etc/apache2/apache2.conf</command>
+ </para>
<sect3 id="http-basic-settings" status="writing">
<title>Basic Settings</title>
<para>
- Basic Settings para ...
+ This section explains Apache2 server essential configuration
+ parameters. You must refer <ulink
+ url="http://httpd.apache.org/docs/2.0/">Apache2
+ Documentation</ulink> for more details.</para>
+
+ <itemizedlist>
+
+ <listitem><para>
+ Enter a fully qualified domain name that you have the
+ right to use in the Server Name text area. This option
+ corresponds to the ServerName directive in apache2.conf.
+ The ServerName directive sets the hostname of the Web
+ server.
+ </para></listitem>
+
+ <listitem><para>Enter the email address of the person who maintains the
+ Web server in the Webmaster email address text area. This
+ option corresponds to the ServerAdmin directive in
+ apache2.conf. If you configure the server's error pages to
+ contain an email address, this email address will be used
+ so that users can report a problem by sending email to the
+ server's administrator. The default value is
+ root at localhost.</para></listitem>
+
+ <listitem><para>Enter the port number of Apache2 server.
+ This option corresponds to the Listen directive in
+ apache2.conf. The default value is 80.
+ </para></listitem>
+ </itemizedlist>
+
+ <tip>
+ <para>
+ If you set the server to listen to a port under 1024, you
+ must be root to start it. For port 1024 and above,
+ <application>apache2</application> can be started as a
+ regular user.
</para>
+ </tip>
</sect3>
<sect3 id="default-settings" status="writing">
<title>Default Settings</title>
<para>
- Default Settings para ...
+ This section explains configuring the default settings of
+ the Apache2 server. For example, if you add a virtual host,
+ the settings you configure for the virtual host take
+ precedence for that virtual host. For a directive not
+ defined within the virtual host settings, the default
+ value is used.
</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ The DirectoryIndex is the default page served by the
+ server when a user requests an index of a directory by
+ specifying a forward slash (/) at the end of the directory
+ name.</para>
+
+ <para>For example, when a user requests the page
+ http://www.example.com/this_directory/, they are going to
+ get either the DirectoryIndex page if it exists, or a
+ server-generated directory list. The server will try to
+ find one of the files listed in the DirectoryIndex
+ directive and will return the first one it finds. If it
+ does not find any of these files and if Options Indexes is
+ set for that directory, the server will generate and
+ return a list, in HTML format, of the subdirectories and
+ files in the directory.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ Use the Error Code section to configure Apache2 Server
+ to redirect the client to a local or external URL in the
+ event of a problem or error. This option corresponds to
+ the ErrorDocument directive.
+ </para>
+ </listitem>
+
+
+ <listitem>
+ <para>
+ By default, the server writes the transfer log to the file
+ /var/log/apache2/access.log. You can configure a custom
+ log format. This option corresponds to LogFormat
+ directive. The server writes the error log to the
+ /var/log/apache2/error.log file. This option corresponds
+ to the ErrorLog directive. The log level can be set using
+ LogLevel directive.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ You can configure the Default Directory Options for all
+ directories. This option corresponds to Option directive
+ within <Directory> directive. You can configure the
+ following options:
+ </para>
+ <itemizedlist spacing="compact">
+ <listitem>
+ <para><emphasis role="bold">ExecCGI</emphasis> — Allow
+ execution of CGI scripts. CGI scripts are not
+ executed if this option is not chosen.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis role="bold">Includes</emphasis> — Allow server-side includes.</para>
+ </listitem>
+ <listitem>
+ <para><emphasis
+ role="bold">IncludesNOEXEC</emphasis> — Allow server-side includes,
+ but disable the #exec and #include commands in CGI
+ scripts.</para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">Indexes</emphasis> — Display a formatted list of the
+ directory's contents, if no DirectoryIndex (such as
+ index.html) exists in the requested directory.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">Multiview</emphasis> — Support content-negotiated multiviews;
+ this option is disabled by default.
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <emphasis role="bold">SymLinksIfOwnerMatch</emphasis> — Only follow symbolic links
+ if the target file or directory has the same owner
+ as the link.
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ </listitem>
+ </itemizedlist>
</sect3>
<sect3 id="virtual-hosts-settings" status="writing">
<title>Virtual Hosts Settings</title>
@@ -297,9 +538,41 @@
</sect3>
<sect3 id="apache-modules" status="writing">
<title>Apache Modules</title>
- <para>
- Apache Modules para ...
- </para>
+ <para>
+
+ Apache is a modular server. This implies that only the most
+ basic functionality is included in the core server. Extended
+ features are available through modules which can be loaded
+ into Apache. By default, a base set of modules is included in
+ the server at compile-time. If the server is compiled to use
+ dynamically loaded modules, then modules can be compiled
+ separately and added at any time using the LoadModule
+ directive. Otherwise, Apache must be recompiled to add or
+ remove modules. Configuration directives may be included
+ conditional on a presence of a particular module by enclosing
+ them in an <IfModule> block.
+
+ You can install the Apache2 module and use them
+ with your web server. You can install Apache2
+ module using <command>apt-get</command>
+ command. For example, to install Apache2 module
+ for MYSQL authentication, you can run the
+ following command:</para>
+
+ <para>
+ <command>sudo apt-get install apache2 apache2-common</command>
+ </para>
+ <para>
+ Once you install the module, the module would
+ be available under
+ /etc/apache2/mods-available directory. You can use
+ <command>a2enmod</command> command to
+ enable a module. You can use
+ <command>a2dismod</command> command to
+ disable a module. Once you enable the module,
+ the module would be available under
+ /etc/apache2/mods-enabled directory.
+ </para>
</sect3>
</sect2>
<sect2 id="https-configuration" status="writing">
@@ -353,7 +626,8 @@
<sect2 id="http-references" status="writing">
<title>References</title>
<para>
- References para ...
+ <ulink url="http://httpd.apache.org/docs/2.0/">Apache2
+ Documentation</ulink>
</para>
</sect2>
</sect1>
More information about the ubuntu-doc
mailing list