Source

xemacsweb / Download / how-to-mirror-ftp.content

Full commit
%title%
How to become a mirror of the XEmacs FTP site
%authors%
the Apache group
Andrew J Cosgriff
%main%
            
<h1>How to Become a Mirror of the XEmacs FTP Site</h1>

<p>If you are in a part of the world which seems poorly served by our
existing mirror sites, we would encourage you to set up a local mirror
of the ftp.xemacs.org FTP site for you and others in your part of the
world to use.  So that others may find it, we'll list it on our <a
href="index.html" shape="rect">mirrors</a> page.</p>

<h2>Requirements</h2>

<p>We have a few requirements for those wishing to run a mirror:</p>

<ul>
	    <li><p>You must carry the complete site, with no "local"
  changes.</p></li>

	    <li><p>You must do an update-check at least twice a week.</p></li>

	    <li><p>You must subscribe to the <a
	    href="http://lists.xemacs.org/lists/listinfo/xemacs-mirrors" shape="rect">mailing
  list</a> for mirror maintainers.</p></li>
	  </ul>

<p>More requirements may be placed at some point in the future, but
for now that's all there is.</p>

<p>Also note that :</p>

<ul>
	    <li><p>The FTP site is approximately 1.7 gigabytes at the time of
  writing (January 2001).</p></li>

	    <li><p>We highly recommend that you run your mirroring software
  between midnight and 4am US Eastern Standard Time (4am-8am GMT),
  when traffic to www.xemacs.org is at its lowest.</p></li>
	  </ul>

<h2>Mirroring Techniques</h2>

<p>There are a couple different ways to mirror the XEmacs web site.
Here is the list of ways we make available, in order of decreasing
preference:</p>

<ol>

	    <li><p>Use rsync.  You can find details on rsync at <a
	    href="http://rsync.samba.org/" shape="rect">http://rsync.samba.org/</a>.  To mirror
the XEmacs website, you could use something like :</p>

<pre xml:space="preserve">rsync -avz --delete rsync.xemacs.org::xemacsftp /local/path/to/mirror</pre>

<p>You can also just do a <code>rsync rsync.xemacs.org::</code> to get a
list of rsync modules available.</p>

<p>You may also wich to read the <a
href="http://sunsite.dk/SunSITE/guides/rsync/rsync-mirroring.html"
shape="rect">rsync
mirroring howto and FAQ</a>.</p></li>


	    <li><p>You can use the popular FTP <a
	    href="http://sunsite.org.uk/packages/mirror/" shape="rect">mirror</a> packge.  A
suggested configuration for this is :</p>

<pre xml:space="preserve">
package=xemacs
  site=ftp.xemacs.org
  remote_dir=/pub/xemacs
  local_dir=/path/to/your/mirror
  exclude_patt+|private/|incoming/
</pre>
</li>

	  </ol>

<h2>Inform us!</h2>

<p>Once the site is set up, send mail to <a
href="mailto:webmaster@xemacs.org" shape="rect">webmaster@xemacs.org</a> to let us
know it's been set up, and we'll add it to the list of mirrors.
Please be patient if it takes a little while to respond.</p>

<p>The mailing list for mirror maintainers can be joined by following
the <a href="http://lists.xemacs.org/lists/listinfo/xemacs-mirrors"
shape="rect">these
instructions</a>.</p>

<p>Good luck!</p>

<p><small>This document is a locally modified version of the one at
the <a href="http://www.apache.org/info/how-to-mirror.html"
shape="rect">Apache</a>
web site.  We appreciate their work in writing such a document in the
first place.</small></p>