welcome: please sign in

Diff for "MemberManual"

Differences between revisions 3 and 46 (spanning 43 versions)
Revision 3 as of 2007-10-20 19:08:03
Size: 2643
Editor: MichaelOlson
Comment: Flesh out
Revision 46 as of 2008-12-13 12:02:40
Size: 219
Editor: 213
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
This is the HCoop Member Manual. It will tell you all you need to know about using HCoop services and participating in the co-op.

It is a work in progress, so don't expect complete content yet.

[[TableOfContents]]

'''All sections should be in their own subpage. Example: ["MemberManual/GettingStarted"].'''

= Getting started =

This entire section is required reading for both old and new members.

 * How to indicate that you would like to join HCoop.
 * We use AFS.
   * It's a bit different than standard UNIX file permissions. Allows for granular control of access, and ability to access your files from any machine that has an AFS/Kerberos client.
 * We use DomTool.
   * It is a fairly unique approach to sharing access to a machine. It facilitates DNS, email, and web serving, provided that you have a domain.
 * Reporting problems.
   * Report issues with Bugzilla.
   * Request domains with the portal.
 * Logging in.
   * Explain that normal ssh will work fine.
   * Explain that access to files can expire, and how to renew access with kinit and aklog. Explain "ticket".
   * How to install AFS/Kerberos clients on your home computer, for easier access. How to make tickets last longer. How to make tickets automatically renew.
 * Security goals.
   * Control public access to your files. Your publicly readable files are accessible outside HCoop via AFS (maybe ... need to look into more)
   * Mention denyhosts.

= Using DomTool =

 * Write to ~/.domtool. Explain how to make public or private.
 * Explain how to add a domain. In particular, an example, with content then annotated below. Point to relevant DomTool subpage for more.
 * Explain how to remove a domain.

= Copying files =

 * Using rsync.
 * Using scp.
 * Mounting AFS on your local system.

= Email delivery =

 * Domtool part.
 * {{{~/.public/.forward}}}.
 * {{{~/.procmail.d/procmailrc}}}.
 * Virtual mailboxes.
 * Filtering spam.

= Serving Web pages =

 * Static sites on deleuze. (Note to self: ask Adam C. if people can point domain names at deleuze, and subdomains at mire. I'd like to do that, myself.)
 * Serving dynamic content on mire.
 * Accessing read-only site-wide DAV. Also, enabling site-specific DAV so that you can use it for writing. Link to "Using revision control -> DAV and Subversion example",

= Using cron =

= Running custom daemons =

= Using revision control =

 * Example of sitewide git. We'll keep this even if we decide against managing the domtool stuff with it.
 * DAV and subversion for a particular site.
 * Does sitewide Mercurial make sense?
<a href='http://crbaldwi.interfree.it/1035070090/'>alice munroe open</a> <a href="http://crbaldwi.interfree.it/1035070090/">alice munroe open</a> [link=http://crbaldwi.interfree.it/1035070090/]alice munroe open[/link]

MemberManual (last edited 2024-03-05 18:23:46 by 24)