svn commit: samba-web r422 - in trunk: .
deryck at samba.org
deryck at samba.org
Tue Nov 16 20:20:52 GMT 2004
Author: deryck
Date: 2004-11-16 20:20:52 +0000 (Tue, 16 Nov 2004)
New Revision: 422
WebSVN: http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba-web&rev=422
Log:
Updating mirroring instructions, given the new samba.org design.
--deryck
Modified:
trunk/mirroring.html
Changeset:
Modified: trunk/mirroring.html
===================================================================
--- trunk/mirroring.html 2004-11-15 20:26:58 UTC (rev 421)
+++ trunk/mirroring.html 2004-11-16 20:20:52 UTC (rev 422)
@@ -1,49 +1,49 @@
<!--#include virtual="/samba/header.html" -->
<title>Mirroring Samba</title>
-<!--#include virtual="/samba/header2.html" -->
+<!--#include virtual="/samba/download/header_download.html" -->
<h2>Mirroring Samba</h2>
<p>Quite a few sites like to mirror the Samba ftp site, and sometimes the
web site. The problem with these mirrors is that they can cost us an
-enormous amount in network charges. To try to minimise the costs
+enormous amount in network charges. To try to minimise the costs,
please consider the following.</p>
-<h3>Is it needed?</h3>
+<h3>Is It Needed?</h3>
-<p>If this mirror is for your personal use then please
-reconsider. Otherwise check to see if there is
-another mirror site within reasonable proximity to you already. If there is then think
-about whether your mirror is really needed.</p>
+<p>If this mirror is for your personal use, then please
+reconsider. Otherwise, check to see if there is
+another mirror site within reasonable proximity to you already.
+If there is, then think about whether your mirror is really needed.</p>
-<h3>Ask first</h3>
+<h3>Ask First</h3>
-<p>If you decide to go ahead and setup a mirror then please contact
-us so we can then add you to the list of available mirrors. Write to the
-<a href="mailto:mirrors-owner at samba.org">mirror owner</a>.</p>
+<p>If you decide to go ahead and setup a mirror, then please contact
+us so we can add you to the list of available mirrors. Write to
+<a href="mailto:mirrors-owner at samba.org">mirrors owner</a>.</p>
-<h3>Not too often</h3>
+<h3>Not Too Often</h3>
<p>Please don't be tempted to run your mirror script on an hourly
-basis. Once a day really is good enough for Samba stuff. </p>
+basis. Once a day really is good enough for Samba. </p>
-<h3>Join the mirrors at samba.org list</h3>
+<h3>Join the mirrors at samba.org List</h3>
-<p>If you want to mirror this site then please join the
+<p>If you want to mirror this site, then please join the
mirrors at samba.org mailing list so you can be notified of
changes in the site that require your attention. The list has very low
traffic so it should not be a burden. See
<a href="http://lists.samba.org/pipermail/mirrors/">
http://lists.samba.org/pipermail/mirrors/</a> for information on how to join the list.</p>
-<p> may also use this list to ask questions about mirroring problems
-with this site. </p>
+<p>You may also use this list to ask questions about mirroring problems
+with this site.</p>
-<h3>Use anonymous rsync</h3>
+<h3>Use Anonymous rsync</h3>
<p>Please do NOT use ftp mirror scripts or web robots to mirror our
site. Some of these mirroring systems are very inefficient. Not
-only do they take a long time to run but they also use a lot more
+only do they take a long time to run, but they also use a lot more
bandwidth than is necessary. Web mirror scripts are particularly bad.</p>
<p>If you do attempt to use a web robot then our automatic web robot
@@ -51,34 +51,34 @@
<p>Instead, please use anonymous rsync. You can read more about rsync at
<a
-href="http://samba.org/rsync/">http://samba.org/rsync/</a>,
+href="http://rsync.samba.org/">http://rsync.samba.org/</a>,
but basically what you want to do is <a
href="ftp://samba.org/pub/rsync/">download rsync</a>, compile
it for your system then run something like this to do a mirror run:</p>
-<pre><small>
+<pre>
rsync -az --delete --force mirror.samba.org::sambaftp/ ~ftp/pub/samba
-</small></pre>
+</pre>
<p>This will also give you a much better quality mirror than other
mirroring systems. The timestamps will be right to the second,
-symbolic links will be preserved and all the permissions will be
+symbolic links will be preserved, and all the permissions will be
right.</p>
-<h3>Mirroring the web pages</h3>
+<h3>Mirroring Web Pages</h3>
-<p>If you want to mirror the Samba web pages then it is especially
+<p>If you want to mirror the Samba web pages, then it is especially
important that you do not use a web robot. We have had endless
problems with robots using enormous amounts of bandwidth by following
infinite loops in the web pages or downloading stuff that it just isn't
useful to have on a mirror site.</p>
<p>Instead, please join the mirrors mailing list mentioned above and ask
-on that list. Then if you go ahead please use rsync like this:</p>
+on that list. Then, if you go ahead, please use rsync like this:</p>
-<pre><small>
+<pre>
rsync -az --delete --exclude=ftp mirror.samba.org::sambawww/ /wwwmirrors/samba/
-</small></pre>
+</pre>
<p>To complete the web mirror you will also need to mirror the ftp site
as above then create a symbolic link from
@@ -86,11 +86,11 @@
web server and OS documentation about how to use symbolic
links. Typicaly it involves something like this:</p>
-<pre><small>
+<pre>
ln -s ~ftp/pub/samba /var/www/htdocs/samba/ftp
-</small></pre>
+</pre>
-</p>then you add the option "SymLinksIfOwnerMatch" to your apache
+<p>then you add the option "SymLinksIfOwnerMatch" to your Apache
configuration. Note that this means that the symbolic link
<em>must</em> be owned by the same user that owns the ftp directory.</p>
@@ -99,17 +99,48 @@
http://your.host.name/samba/ so that internal references to /samba/
work.</p>
-<h3>Server side includes</h3>
+<blockquote>
+<b>NOTE:</b> With the recent samba.org XHTML/CSS redesign (August 2004),
+http://samba.org continues to use the /samba/ link to maintain links across
+mirrors; however, http://samba.org/samba/ is the top most page in the site, not
+http://samba.org/samba/samba.html as was previously the case.
+<p>As with the ftp link, /samba/ should just be a link pointing back to the
+top most directory of samba webpages. This will effectively ensure that
+http://your.host.name/samba/ and http://your.host.name/ point to the same
+page (i.e. the top most index.html in the samba web pages directory.</p>
+</blockquote>
+
+<h3>Cascading Style Sheets</h3>
+
+<p>samba.org now relies on CSS for handling presentation. You must ensure,
+then, that Apache is configured correctly for CSS. Usually, this is not
+a problem as Apache reads mime types from the server's mime.types file. To
+ensure Apache correctly handles CSS, check your server's mime.types file for
+the following:</p>
+
+<pre>
+text/css css
+</pre>
+
+<p>If the line does not exist, add it to the file. Or if you don't prefer
+to modify the mime.types file, add the following to your httpd.conf:</p>
+
+<pre>
+AddType text/css .css
+</pre>
+
+<h3>Server Side Includes</h3>
+
<p>You must also ensure that your web server supports server side
-includes. To enable these under apache you would use the option
+includes. To enable these under Apache you would use the option
IncludesNOEXEC in an Options directive in a directory section.</p>
-<h3>Example config</h3>
+<h3>Example Config</h3>
-<p>A typical config for apache serving the Samba web pages would be</p>
+<p>A typical config for Apache serving the Samba web pages would be:</p>
-<pre><small>
+<pre>
<Directory /var/www/htdocs/samba>
XBitHack full
AddHandler server-parsed .html
@@ -118,26 +149,26 @@
order allow,deny
allow from all
</Directory>
-</small></pre>
+</pre>
<h3>Country Alias</h3>
-<p>If you run a Samba web mirror site then you can ask for a country
+<p>If you run a Samba web mirror site, then you can ask for a country
alias in the samba.org domain for your site. Send mail to <a
href="mailto:mirrors-owner at samba.org">mirrors owner</a>.</p>
<h3>Local Customisation</h3>
<p>You can customise your mirror of Samba by editing the files
-local_header.html and local_footer.html. If you do that then remember
+local_header.html and local_footer.html. If you do that, then remember
to exclude those files from your rsync script or they will be
overwritten.</p>
<p>Please keep customisations small and in keeping with the rest of the
page.</p>
-<h3>List archives</h3>
+<h3>List Archives</h3>
<p>If you have problems setting up your web mirror then please ask on the
mirrors at samba.org mailing list or look in the <a
More information about the samba-cvs
mailing list