welcome: please sign in

Diff for "MemberManual"

Differences between revisions 4 and 5
Revision 4 as of 2007-10-24 23:08:54
Size: 2674
Editor: MichaelOlson
Comment: Turn section numbers off
Revision 5 as of 2007-10-25 00:21:23
Size: 1560
Editor: MichaelOlson
Comment: Make fancy table of contents and begin making subpages
Deletions are marked like this. Additions are marked like this.
Line 7: Line 7:
[[TableOfContents]] == Contents ==
Line 9: Line 9:
'''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.
||<25%>'''~+[:/GettingStarted:Getting Started]+~''' ||<1%> ||<74%> Things that new and current members must know about HCoop's setup. It is considered '''required reading''' before contacting HCoop administrators or filing support requests. ||
|| ~+[:/UsingDomtool:Using Domtool]+~ || || The bare minimum that you need to know concerning our use of DomTool. ||
|| ~+[:/TransferringFiles:Transferring Files]+~ || || How to transfer files to your home directory, which is kept in AFS. ||
Line 55: Line 25:
 * 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",  * 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".

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.

Contents

[:/GettingStarted:Getting Started]

Things that new and current members must know about HCoop's setup. It is considered required reading before contacting HCoop administrators or filing support requests.

[:/UsingDomtool:Using Domtool]

The bare minimum that you need to know concerning our use of DomTool.

[:/TransferringFiles:Transferring Files]

How to transfer files to your home directory, which is kept in AFS.

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?

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