fill in servers section

git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@691 313b444b-1b9f-4f58-a734-7bb04f332e8d

diff --git a/developers-reference.sgml b/developers-reference.sgml
index 0c81cda08672f02d58f72b812b6c94b6b894b1b4..16732d2ee61ee3d9effdf6f5232b3de9eb51482e 100644 (file)
--- a/developers-reference.sgml
+++ b/developers-reference.sgml
@@ -8,6 +8,7 @@
  TODO:
   - bugs in upstream versions should be reported upstream!
   - fill in ftp and www server discussion
+  - how to mirror
   - porter instructions - - volunteers needed for this x86-centric maintainer!
   - talk about CVS access
  -->
@@ -275,18 +276,89 @@ Online archives of mailing lists are available at <url
 id="http://www.debian.org/Lists-Archives/">.
 
 
-      <sect>The master server
-       <p>
-The master server, <tt/master.debian.org/, holds the cannonical copy
-of the Debian archive (excluding the non-U.S. packages).  Generally,
-package uploads go to this server; cf. <ref id="upload">.  All Debian
-developers have accounts on this machine.
-
-      <sect>The FTP servers
-       <p>
-
-      <sect>The WWW servers
-       <p>
+      <sect id="servers-master">The master server
+       <p>
+The master server, <tt/master.debian.org/, holds the canonical copy
+of the Debian archive (excluding the non-U.S. packages). Generally,
+package uploads go to this server; cf. <ref id="upload">. 
+       <p>
+<tt/master.debian.org/ is the canonical location for the Bug Tracking
+System (BTS).  If you plan on doing some statistical analysis or
+processing of Debian bugs, this would be the place to do it.  Please
+describe your plans on <email/debian-devel@lists.debian.org/ before
+implementing anything, however, to reduce unnecessary duplication of
+effort or wasted processing time.
+       <p>
+All Debian developers have accounts on <tt/master.debian.org/.  Please
+take care to protect your password to this machine.  Try to avoid
+login or upload methods which send passwords over the Internet in the
+clear.
+       <p>
+If you find a problem with <tt/master.debian.org/ such as disk full,
+suspicious activity, or whatever, send an email to
+<email>debian-admin@debian.org</email>.
+
+      <sect id="servers-ftp">The FTP servers
+       <p>
+
+      <sect id="servers-www">The WWW servers
+       <p>
+The main web server, <tt/www.debian.org/, is also known as
+<tt/va.debian.org/.  All developers are given accounts on this
+machine.
+       <p>
+If you have some Debian-specific information which you want to serve
+up on the web, you can do do this by putting material in the
+<tt>public_html</tt> directory under your home directory.  You can do
+this on either <tt/va.debian.org/ or <tt/master.debian.org/.  Any
+material you put in those areas are accessible via the URLs
+<tt>http://www.debian.org/~<var>user-id</var>/</tt> and
+<tt>http://master.debian.org/~<var>user-id</var>/</tt>, respectively.
+Please do <em>not</em> put any materials on Debian servers which do
+not relate to Debian.
+       <p>
+If you find a problem with the Debian web server, you should generally
+submit a bug against the pseudo-package,
+<package>www.debian.org</package>.  First check whether or not someone
+else has already reported the problem on the <url
+id="http://www.debian.org/Bugs/db/pa/lwww.debian.org.html" name="Bug
+Tracking System">.
+
+      <sect id="servers-cvs">The CVS server
+       <p>
+<tt/cvs.debian.org/ is also known as <tt/va.debian.org/, discussed
+above.  If you need the use of a publically accessible CVS server, for
+instance, to help coordinate work on a package between many different
+developers, you can request a CVS area on the server.  Generally,
+<tt/cvs.debian.org/ offers a combination of local CVS access,
+anonymous client-server read-only access, and full client-server
+access through <prgn>ssh</prgn>.
+       <p>
+To request a CVS area, send a request via email to
+<email>debian-admin@debian.org</email>.
+
+
+      <sect id="servers-mirrors">Mirrors of Debian servers
+       <p>
+The web and FTP servers have several mirrors available.  Please do not
+put heavy load on the canonical FTP or web servers.  Ideally, the
+canonical servers only mirror out to a first tier of mirrors, and all
+user access is to the mirrors.  This allows Debian to better spread
+our bandwidth requirements over several servers and networks.  Note
+that newer push mirroring techniques ensure that mirrors are as
+up-to-date as they can be.
+       <p>
+The main web page listing the available public FTP (and, usually,
+HTTP) servers can be found at <url
+id="http://www.debian.org/distrib/ftplist">. More information
+concerning mirrors can be found at <url
+id="http://www.debian.org/mirror/">.  This useful page includes
+information and tools which can be helpful if you are interested in
+setting up your own mirror, either for internal or public access.
+       <p>
+Note that mirrors are generally run by third-parties who are
+interested in helping Debian.  As such, developers generally do not
+have accounts on these machines.
 
 
     <chapt id="archive">The Debian Archive