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.
All sections should be in their own subpage. Example: ["MemberManual/GettingStarted"].
1. 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.
2. 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.
3. Copying files
- Using rsync.
- Using scp.
- Mounting AFS on your local system.
4. Email delivery
- Domtool part.
- Virtual mailboxes.
- Filtering spam.
5. 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",
6. Using cron
7. Running custom daemons
8. 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?