<!--#include virtual="/samba/header.html" -->
<title>Mirroring Samba</title>
-<!--#include virtual="/samba/header2.html" -->
+<!--#include virtual="/samba/header_columns.html" -->
-<h2 align=center>Mirroring Samba</h2>
+<h2>Mirroring Samba</h2>
-Quite a few sites like to mirror the Samba ftp site, and sometimes the
+<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
-please consider the following.
+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>
-If this mirror is for your personal use then please
-reconsider. Otherwise check to see if there is <A
-HREF="index.html">another mirror site</A> within reasonable proximity to you already. If there is then think
-about whether your mirror is really needed.
+<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>
-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@samba.org">mirror owner</A>.
+<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:webmaster@samba.org">webmaster@samba.org</a>.</p>
-<H3>Not too often</H3>
+<h3>Not Too Often</h3>
-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>Please don't be tempted to run your mirror script on an hourly
+basis. Once a day really is good enough for Samba. </p>
-<H3>Join the mirrors@samba.org list</H3>
+<h3>Join the mirrors@samba.org List</h3>
-If you want to mirror this site then please join the
+<p>If you want to mirror this site, then please join the
mirrors@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.
+http://lists.samba.org/pipermail/mirrors/</a> for information on how to join the list.</p>
-You may also use this list to ask questions about mirroring problems
-with this site.
+<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>
-Please do NOT use ftp mirror scripts or web robots to mirror our
+<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
-bandwidth than is necessary. Web mirror scripts are particularly bad.
-
-If you do attempt to use a web robot then our automatic web robot
-detector will probably catch you and ban your entire site.
-
-Instead, please use anonymous rsync. You can read more about rsync at
-<A
-HREF="http://samba.org/rsync/">http://samba.org/rsync/</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:
-
-<pre><small>
- rsync -az --delete --force mirror.samba.org::sambaftp/ ~ftp/pub/samba
-</small></pre>
-
-This will also give you a much better quality mirror than other
+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
+detector will probably catch you and ban your entire site.</p>
+
+<p>You can use anonymous rsync to obtain a copy of the [sambaftp]
+(minus the Binary_Packages download area) and [sambawww] repository.
+Please note that official mirror can make use of the [sambaftp-mirror]
+repository which includes the Binary_Packages/ directory. However, in
+order to do so, you must first obtain the current username and password
+for the share. To do this, please send email to <a
+href="mailto:webmaster@samba.org">webmaster@samba.org</a>.
+</p>
+
+<p>You can read more about rsync at <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>
+rsync -az --delete --force mirror.samba.org::sambaftp/ ~ftp/pub/samba
+</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
-right.
+symbolic links will be preserved, and all the permissions will be
+right.</p>
-<H3>Mirroring the web pages</H3>
+<h3>Mirroring Web Pages</h3>
-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>
+useful to have on a mirror site.</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>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>
-<pre><small>
- rsync -az --delete --exclude=ftp
- mirror.samba.org::sambawww/ /wwwmirrors/samba/
-</small></pre>
+<pre>
+rsync -az --delete --exclude=ftp mirror.samba.org::sambawww/ /wwwmirrors/samba/
+</pre>
-To complete the web mirror you will also need to mirror the ftp site
+<p>To complete the web mirror you will also need to mirror the ftp site
as above then create a symbolic link from
http://your.host.name/samba/ftp to the samba ftp area. Consult your
web server and OS documentation about how to use symbolic
-links. Typicaly it involves something like this:
+links. Typicaly it involves something like this:</p>
-<pre><small>
- ln -s ~ftp/pub/samba /var/www/htdocs/samba/ftp
-</small></pre>
+<pre>
+ln -s ~ftp/pub/samba /var/www/htdocs/samba/ftp
+</pre>
-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>
+<em>must</em> be owned by the same user that owns the ftp directory.</p>
-The hostname of your web site mirror doesn't matter (you don't need to
+<p>The hostname of your web site mirror doesn't matter (you don't need to
use virtual hosting) but please make the site available as
http://your.host.name/samba/ so that internal references to /samba/
-work.
+work.</p>
+
+<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>MIME Types</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>Web pages should also be served with a simple MIME type of "text/html"
+rather than anything like "text/html; iso-8859-1" or "text/html; utf-8".</p>
+
+<h3>Server Side Includes</h3>
-You must also ensure that your web server supports server side
-includes. To enable these under apache you would use the option
-IncludesNOEXEC in an Options directive in a directory section.
+<p>You must also ensure that your web server supports server side
+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>
-A typical config for apache serving the Samba web pages would be
+<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
order allow,deny
allow from all
</Directory>
-</small></pre>
+</pre>
<h3>Country Alias</h3>
-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@samba.org">mirrors owner</A>.
+<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:webmaster@samba.org">webmaster@samba.org</a>.</p>
<h3>Local Customisation</h3>
-You can customise your mirror of Samba by editing the files
-local_header.html and local_footer.html. If you do that then remember
+<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
to exclude those files from your rsync script or they will be
-overwritten.<p>
+overwritten.</p>
-Please keep customisations small and in keeping with the rest of the
-page.
+<p>Please keep customisations small and in keeping with the rest of the
+page.</p>
-<h3>List archives</h3>
+<h3>List Archives</h3>
-If you have problems setting up your web mirror then please ask on the
-mirrors@samba.org mailing list or look in the <A
-HREF="http://lists.samba.org/pipermail/mirrors/">list archives</A>.
+<p>If you have problems setting up your web mirror then please ask on the
+mirrors@samba.org mailing list or look in the <a
+href="http://lists.samba.org/pipermail/mirrors/">list archives</a>.</p>
<!--#include virtual="/samba/footer.html" -->