[Savannah-cvs] [107] alphabetize vcs, stubs for other hosts

[karl]

Revision: 107
          
http://svn.sv.gnu.org/viewvc/?view=rev&root=administration&revision=107
Author:   karl
Date:     2014-11-10 18:23:48 +0000 (Mon, 10 Nov 2014)
Log Message:
-----------
alphabetize vcs, stubs for other hosts

Modified Paths:
--------------
    trunk/sviki/SavannahServices.mdwn

Modified: trunk/sviki/SavannahServices.mdwn
===================================================================
--- trunk/sviki/SavannahServices.mdwn   2014-11-09 02:16:05 UTC (rev 106)
+++ trunk/sviki/SavannahServices.mdwn   2014-11-10 18:23:48 UTC (rev 107)
@@ -1,6 +1,7 @@
-# Services Hosted On Savannah Servers
+# Services hosted on Savannah servers
 
-The following is the list of public servers, organized by the VM they run on.
+The following is the list of Savannah's public servers, organized by the
+VM they run on.
 
 When restarting/reload/reboot a service or a VM, please check the following
 services are working as expected.
@@ -10,93 +11,145 @@
 - [[SavannahArchitecture]]
 - [[GnuArchitecture]]
 
+
 ## Frontend
 
 The `frontend.sv.gnu.org` VM runs the Savannah website (the PHP code).
 
 - Main page: <http://savannah.gnu.org> and <http://savannah.nongnu.org>
-- SSL Access: <https://savannah.gnu.org> and <https://savannah.nongnu.org>
+
+- SSL access: <https://savannah.gnu.org> and <https://savannah.nongnu.org>
   using the SSL certificate in `frontend:/etc/ssl/private/2014/`.
+
 - PHP code runs defined in `frontend:/etc/apache2/sites-available/sv.inc`,
-  stored in `frontend:/var/www/savane/frontend/php/` .
-- PHP source code available in 
<http://savannah.gnu.org/projects/administration> .
+  stored in `frontend:/var/www/savane/frontend/php/`.
 
+- PHP source code available in
+  <http://savannah.gnu.org/projects/administration>.
 
+
 ## VCS
 
-The `vcs` VM holds the source code and web-pages repositories
-(cvs,svn,arch,br,hg,git) providing various access methods.
+The `vcs.sv.gnu.org` VM holds the source code (bzr,cvs,hg,git,svn) and
+webpages (cvs only) repositories, providing various access methods.
 
-- Web Access:
-    - csv (the CVS **Source Code** repositories, not the web repositories)
-        - Apache config file: `vcs:/etc/apache2/sites-available/cvs`
-        - static welcome page: <http://cvs.savannah.gnu.org/>
-        - ViewVC CGI: <http://cvs.savannah.gnu.org/viewvc/>
-    - svn
-        - Apache config file: `vcs:/etc/apache2/sites-available/svn`
-        - static welcome page: <http://svn.savannah.gnu.org/>
-        - ViewVC CGI: <http://svn.savannah.gnu.org/viewvc/>
-    - bzr
-        - Apache config file: `vcs:/etc/apache2/sites-available/bzr`
-        - static welcome page: <http://bzr.savannah.gnu.org/>
-        - BZR CGI Viewer: <http://bzr.savannah.gnu.org/lh/>
-    - hg
-        - Apache config file: `vcs:/etc/apache2/sites-available/hg`
-        - static welcome page: <http://hg.savannah.gnu.org/>
-        - HGWEB Viewer: <http://hg.savannah.gnu.org/hgweb/>
-    - git
-        - Apache config file: `vcs:/etc/apache2/sites-available/git`
-        - static welcome page: <http://git.savannah.gnu.org/>
-        - CGIT viewer: <http://git.savannah.gnu.org/cgit/>
-        - WebGit viwer: <http://git.savannah.gnu.org/gitweb/>
-    - webcvs (the CVS web-pages repositories, propagated to `www.gnu.org` and
-      `www.nongnu.org`)
-        - Apache config file: same as `cvs` (above)
-        - static welcome page: <http://web.cvs.savannah.gnu.org/>
-        - ViewVC: <http://web.cvs.savannah.gnu.org/viewvc/>
-    - WebGit (experimental):
-        - Apache config file: `vcs:/etc/apache2/sites-available/webgit`
-        - static welcome page: <http://web.git.savannah.gnu.org/>
-        - CGIT viewer: <http://web.git.savannah.gnu.org/cgit/>
-        - WebGit viwer: <http://web.git.savannah.gnu.org/gitweb/>
+(The old GNU arch version control program is still present on the
+server, but perhaps no one is still using it.  In any case, we very
+strongly not recommend using it for any new development, and we won't
+mention it further on this page.  We hope to remove it completely in due
+course.)
 
-- SSH: SSH is used for read/write access to the repositories.  
-    Logging-in with SSH and the Savannah user requires setting-up a public SSH
-    key through the Savannah web interface. Upon login, the is user's key is
-    checked against the Savannah MySQL database, using the `AuthorizedKeysExec`
-    command defined in `vcs:/etc/ssh/sshd_config`.
 
-    The repositories access methods are:
-    - cvs: `cvs -z3 -d:ext:<USER>@cvs.savannah.nongnu.org:/sources/<PROJECT> 
co <modulename>`
-    - svn: `svn co 
svn+ssh://<USER>@svn.savannah.gnu.org/<PROJECT>/<modulename>`
+### VCS - project member access (commits)
+
+- SSH: used for read/write access to the repositories by members
+    of a project.  Before using SSH, the Savannah user must upload a
+    public SSH key through the Savannah web interface. Upon attempted
+    login, this user key is checked against the Savannah MySQL database,
+    using the `AuthorizedKeysExec` command defined in
+    `vcs:/etc/ssh/sshd_config`.  The user must also be a member of the
+    given project.
+
+    The repositories' access methods are:
     - bzr: `bzr branch 
bzr+ssh://<USER>@bzr.savannah.nongnu.org/<PROJECT>/branch`
+    - cvs: `cvs -d:ext:<USER>@cvs.savannah.nongnu.org:/sources/<PROJECT> co 
<modulename>`
+    - git: `git clone <USER>@git.sv.gnu.org:/srv/git/<PROJECT>.git`
     - hg:  `hg clone ssh://<USER>@hg.sv.gnu.org/<PROJECT>`
-    - webcvs: `cvs -z3 -d:ext:<USER>@cvs.savannah.nongnu.org:/web/<PROJECT> co 
<PROJECT>`
-    - git: `git clone <USER>@git.sv.gnu.org:/srv/git/<PROJECT>.git`
+    - svn: `svn co 
svn+ssh://<USER>@svn.savannah.gnu.org/<PROJECT>/<modulename>`
+    - webcvs: `cvs -d:ext:<USER>@cvs.savannah.nongnu.org:/web/<PROJECT> co 
<PROJECT>`
 
-- RSYNC - provides read-only anonymous access to the raw repository files.
+### VCS - public anonymous access (read-only)
+
+- RSYNC - read-only anonymous access to the raw repository files.
     configuration in `vcs:/etc/rsync.conf`, started with `xinetd` in
     `vcs:/etc/xinetd.d/rsync`.
+    - bzr: `rsync://svn.savannah.gnu.org/bzr/<PROJECT>`
     - cvs: `rsync://svn.savannah.gnu.org/sources/<PROJECT>`
+    - git: `rsync://svn.savannah.gnu.org/git/<PROJECT>`
+    - hg:  not defined.
     - svn: `rsync://svn.savannah.gnu.org/svn/<PROJECT>`
-    - git: `rsync://svn.savannah.gnu.org/git/<PROJECT>`
-    - bzr: `rsync://svn.savannah.gnu.org/bzr/<PROJECT>`
     - webcvs: `rsync://svn.savannah.gnu.org/web/<PROJECT>`
-    - hg: not defined.
 
-- Git-Daemon - provides read-only anonymous access to git repositories.
-    configured with `xinetd` in `vcs:/etc/xinetd.d/git`.
-    - usage: `git clone git://git.savannah.gnu.org/<PROJECT>.git`
+- BZR-daemon - read-only anonymous access to BZR repositories.
+    configured with `xinetd` in `vcs:/etc/xinetd.d/bzr-hpss`.
+    - bzr: `bzr branch bzr://bzr.savannah.nongnu.org/gnewsense/branch`
 
-- CVS Pserver - provides read-only anonymous access to CVS repositories.
+- CVS-pserver - read-only anonymous access to CVS repositories.
     configured with `xinetd` in `vcs:/etc/xinetd.d/cvs`.
-    - cvs: `cvs -z3 -d:pserver:address@hidden:/sources/<PROJECT> co 
<modulename>`
-    - webcvs: `cvs -z3 -d:pserver:address@hidden:/web/<PROJECT> co 
<modulename>`
+    - cvs: `cvs -d:pserver:address@hidden:/sources/<PROJECT> co <modulename>`
+    - webcvs: `cvs -d:pserver:address@hidden:/web/<PROJECT> co <modulename>`
 
-- SVN Daemon - provides read-only anonymous access to SVN repositories.
+- GIT-daemon - read-only anonymous access to GIT repositories.
+    configured with `xinetd` in `vcs:/etc/xinetd.d/git`.
+    - git: `git clone git://git.savannah.gnu.org/<PROJECT>.git`
+
+- HG - not defined.
+
+- SVN-daemon - read-only anonymous access to SVN repositories.
     configured with `xinetd` in `vcs:/etc/xinetd.d/svn`.
     - svn: `svn co svn://svn.savannah.gnu.org/texinfo/modulename`
 
-- BZR-Daemon - provides read-only anonumous access to BZR repositories.
-    configured with `xinetd` in `vcs:/etc/xinetd.d/bzr-hpss`.
-    - bzr: `bzr branch bzr://bzr.savannah.nongnu.org/gnewsense/branch`
+### VCS - web browsing
+
+Source code repositories:
+
+- bzr
+    - Apache config file: `vcs:/etc/apache2/sites-available/bzr`
+    - static welcome page: <http://bzr.savannah.gnu.org/>
+    - BZR CGI Viewer: <http://bzr.savannah.gnu.org/lh/>
+- cvs (the CVS **source code** repositories, not webpages)
+    - Apache config file: `vcs:/etc/apache2/sites-available/cvs`
+    - static welcome page: <http://cvs.savannah.gnu.org/>
+    - ViewVC CGI: <http://cvs.savannah.gnu.org/viewvc/>
+- git
+    - Apache config file: `vcs:/etc/apache2/sites-available/git`
+    - static welcome page: <http://git.savannah.gnu.org/>
+    - CGIT viewer: <http://git.savannah.gnu.org/cgit/>
+    - WebGit viwer: <http://git.savannah.gnu.org/gitweb/>
+- hg
+    - Apache config file: `vcs:/etc/apache2/sites-available/hg`
+    - static welcome page: <http://hg.savannah.gnu.org/>
+    - HGWEB Viewer: <http://hg.savannah.gnu.org/hgweb/>
+- svn
+    - Apache config file: `vcs:/etc/apache2/sites-available/svn`
+    - static welcome page: <http://svn.savannah.gnu.org/>
+    - ViewVC CGI: <http://svn.savannah.gnu.org/viewvc/>
+
+Webpages repositories:
+
+- webcvs (the CVS webpages repositories, propagated to `www.gnu.org`
+  and `www.nongnu.org`; not source code)
+    - Apache config file: same as `cvs` (above)
+    - static welcome page: <http://web.cvs.savannah.gnu.org/>
+    - ViewVC: <http://web.cvs.savannah.gnu.org/viewvc/>
+
+- WebGit (experimental):
+    - Apache config file: `vcs:/etc/apache2/sites-available/webgit`
+    - static welcome page: <http://web.git.savannah.gnu.org/>
+    - CGIT viewer: <http://web.git.savannah.gnu.org/cgit/>
+    - WebGit viwer: <http://web.git.savannah.gnu.org/gitweb/>
+
+
+## DL - download
+
+--moretowrite--
+The `dl.sv.gnu.org` VM provides downloading via ftp/http/rsync.  Uploads
+through rsync+ssh/sftp.
+
+Downloads are multiplexed across mirrors through [[Mirmon]].
+
+
+## Internal
+
+--moretowrite--
+The `internal.sv.gnu.org` VM runs the database (mysql), and what else?.
+Only available to other savannah hosts (per iptables).
+
+
+## MGT - management
+
+--moretowrite--
+The `mgt.sv.gnu.org` VM runs munin, and what else?  Provides access
+point to get to all other sv hosts (in old days, hosts had unroutable
+10.x addresses).
+