add link to quentin's kerberos ticket handling scripts
[wiki.git] / doc / WikiStart
index 5c83f02a313ce5198338dcc90ca5ac36cbb8e88f..7de2fd1d998787f08a395d7920a5a1a0008fafd6 100644 (file)
@@ -1,17 +1,30 @@
 = Welcome to the SIPB Documentation Project =
 
 = Welcome to the SIPB Documentation Project =
 
-The SIPB Documentation Project is a project to document in written form the collective knowledge that SIPB members take for granted or use in maintaining services and projects that are not otherwise written down anywhere. 
+The SIPB Documentation Project is a project to document in written
+form the collective knowledge that SIPB members take for granted or
+use in maintaining services and projects that are not otherwise
+written down anywhere.
 
 See ProjectIdeas for stuff to try doing to further the goals of the SIPB.
 
 
 See ProjectIdeas for stuff to try doing to further the goals of the SIPB.
 
-See '''LennyBugs''' for bugs to take on in the Lenny '''RC-bug-squashing hackathon''' of '''December 13, 2008'''.
+See '''LennyBugs''' for bugs to take on in the Lenny
+'''RC-bug-squashing hackathon''' of '''December 13, 2008'''.
 
 
-== Documentation Ideas ==
+== Documentation Topics ==
+
+ * UsingZephyr -- An attempt at a complete beginner's guide to getting
+   on Zephyr with BarnOwl and screen.
+  * BarnOwl has some more documentation on [http://barnowl.mit.edu/ its wiki]
+ * [wiki:XVM] (On XVM's trac)
+  * [https://xvm.mit.edu/trac/wiki/Remctl using `remctl`]
+  * [https://xvm.mit.edu/trac/wiki/SerialConsole getting the serial console]
+ * KerberizedServer explains keytabs and how to get one and how that lets you SSH somewhere with Kerberos.
+ * SummerReading -- Documents or books that various SIPB members recommend reading.
 
 
-This is a list of topics that need documentation in one form or another or that are good for explaining to prospectives.
+== Documentation Ideas ==
 
 
- * UsingZephyr -- [http://barnowl.mit.edu/wiki/GettingStarted] is a good start, but could use text on screen and tickets, among other things
- * AdvancedBarnOwl -- There are a lot of cool things you can do with BarnOwl. Almost none of them are documented (this may belong on the barnowl wiki, but since they're both trac, it's easy to move)
+This is a list of topics that need documentation in one form or
+another or that are good for explaining to prospectives.
 
  * PrintingAtMit
    * QuickPrint
 
  * PrintingAtMit
    * QuickPrint
@@ -19,8 +32,6 @@ This is a list of topics that need documentation in one form or another or that
    * printing from non-Athena: CupsOnMac
    * `-i printadm` (maybe)
 
    * printing from non-Athena: CupsOnMac
    * `-i printadm` (maybe)
 
- * [wiki:XVM] -- [https://xvm.mit.edu/trac/wiki/Remctl using `remctl`], [https://xvm.mit.edu/trac/wiki/SerialConsole getting the serial console]
-
  * UsingDebathena -- You've installed Debathena -- now what?  Automounter, `blanche`, cups; using stuff in the GUI.
  * AthenaDotFiles -- These are weird and nonstandard compared to traditional UNIX and should be documented, including things like `.environment`
    * There's some documentation at [http://web.mit.edu/olh/Dotfiles/]
  * UsingDebathena -- You've installed Debathena -- now what?  Automounter, `blanche`, cups; using stuff in the GUI.
  * AthenaDotFiles -- These are weird and nonstandard compared to traditional UNIX and should be documented, including things like `.environment`
    * There's some documentation at [http://web.mit.edu/olh/Dotfiles/]
@@ -29,6 +40,9 @@ This is a list of topics that need documentation in one form or another or that
 
  * [wiki:AFSAndYou] -- There should be a central documentation point to using your AFS space, granting access through AFS and through `web`, accessing files from various platforms, and so on.  Don't duplicate iAFS; perhaps latex2html and update it.
 
 
  * [wiki:AFSAndYou] -- There should be a central documentation point to using your AFS space, granting access through AFS and through `web`, accessing files from various platforms, and so on.  Don't duplicate iAFS; perhaps latex2html and update it.
 
+ Setting up servers:
+ * ClientCerts should explain, if for some perverse reason you don't want to use scripts.mit.edu :-), how to set up client cert authentication on your own machine (grab the CA out of the apache-ssl locker, submit a CSR to mitcert@, set up scripts' magic Apache modules to make your life easier)
+
  * Add your own here!
 
 == Useful Links ==
  * Add your own here!
 
 == Useful Links ==
@@ -45,4 +59,4 @@ Unless specified otherwise, all documentation on this wiki will be available und
  * the GNU Free Documentation License, with no Invariant Sections, no
    Front-Cover Texts, and no Back-Cover-Texts.
 
  * the GNU Free Documentation License, with no Invariant Sections, no
    Front-Cover Texts, and no Back-Cover-Texts.
 
-As recommended by the [http://stuff.mit.edu/afs/sipb/admin/text/policy/documentation_licensing.txt SIPB Documentation Licensing Recommendation]
\ No newline at end of file
+As recommended by the [http://stuff.mit.edu/afs/sipb/admin/text/policy/documentation_licensing.txt SIPB Documentation Licensing Recommendation]