welcome: please sign in

Diff for "MemberManual"

Differences between revisions 4 and 76 (spanning 72 versions)
Revision 4 as of 2007-10-24 23:08:54
Size: 2674
Editor: MichaelOlson
Comment: Turn section numbers off
Revision 76 as of 2014-04-21 22:24:09
Size: 2453
Editor: ClintonEbadi
Comment: a year is not really recent
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
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. 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.
Line 5: Line 5:
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?
||'''~+[[/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. ||
||'''~+[[/PayingDues|Paying Dues]]+~''' || || How to pay dues to HCoop, and the consequences of falling behind in payment. ||
||'''~+[[/GettingHelp|Getting Help]]+~''' || || Our full procedures for contacting HCoop volunteers and asking questions about HCoop. ||
|| || || ||
|| ~+[[/ShellAccess|Shell Access]]+~ || || How to log in to our machines, and a brief explanation of what our machines do. ||
|| ~+[[/GettingDomain|Getting a Domain]]+~ || || How to buy yourself a domain name from a registrar and manage it at HCoop. ||
|| ~+[[/UsingDomtool|Using Domtool]]+~ || || The bare minimum that you need to know concerning our use of DomTool. ||
|| ~+[[/ServingWebsites|Serving Websites]]+~ || || How to serve your website(s). ||
|| ~+[[/WebApplications|Serving Web Applications]]+~ || || How to serve common web applications ||
|| ~+[[/Databases|Databases]]+~ || || Using PostgreSQL and MySQL databases. ||
|| ~+[[/TransferringFiles|Transferring Files]]+~ || || How to transfer files to and from your home directory, which is kept in AFS. ||
|| ~+[[/Email|Email]]+~ || || How to receive and manage your email, deal with spam, and set up Mailman mailing lists. ||
|| ~+[[/UsingJabber|Jabber]]+~ || || How to use Jabber for instant messaging. ||
|| ~+[[/RunningUnattendedCommands|Running Unattended Commands]]+~ || || In general, how to run unattended commands (such as custom daemons or commands called from cron scripts) from your AFS home directory. ||
|| ~+[[/UsingCron|Using cron]]+~ || || How to use cron to run commands periodically. ||
|| ~+[[/Backups|Backups]]+~ || || How we back-up your data and how you can access the saved copies. ||
|| ~+[[/VersionControl|Version Control]]+~ || || How to use version control software to host code on HCoop servers. ||
|| || || ||
|| ~+[[/FAQ|Frequently-Asked Questions]]+~ || || Answers to questions often asked about DomTool and our setup. ||
|| ~+[[/DataRetentionPolicy|Data retention policies]]+~ || || Data retention policies upon membership termination. ||
----
CategoryMemberManual

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.

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.

Paying Dues

How to pay dues to HCoop, and the consequences of falling behind in payment.

Getting Help

Our full procedures for contacting HCoop volunteers and asking questions about HCoop.

Shell Access

How to log in to our machines, and a brief explanation of what our machines do.

Getting a Domain

How to buy yourself a domain name from a registrar and manage it at HCoop.

Using Domtool

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

Serving Websites

How to serve your website(s).

Serving Web Applications

How to serve common web applications

Databases

Using PostgreSQL and MySQL databases.

Transferring Files

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

Email

How to receive and manage your email, deal with spam, and set up Mailman mailing lists.

Jabber

How to use Jabber for instant messaging.

Running Unattended Commands

In general, how to run unattended commands (such as custom daemons or commands called from cron scripts) from your AFS home directory.

Using cron

How to use cron to run commands periodically.

Backups

How we back-up your data and how you can access the saved copies.

Version Control

How to use version control software to host code on HCoop servers.

Frequently-Asked Questions

Answers to questions often asked about DomTool and our setup.

Data retention policies

Data retention policies upon membership termination.


CategoryMemberManual

MemberManual (last edited 2014-04-21 22:24:09 by ClintonEbadi)