2643
Comment: Flesh out
|
2785
admonish users to migrate
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
#pragma section-numbers off |
|
Line 3: | Line 5: |
It is a work in progress, so don't expect complete content yet. | {{{#!wiki important We are currently transitioning to upgraded shell and web servers. The current server (`mire`) is deprecated and slated for removal in early 2013. See NavajosBogMigrationGuide for instructions on how to take advantage of the new servers. All members are '''highly encouraged''' to reconfigure their domains as soon as possible. }}} |
Line 5: | Line 9: |
[[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. || |
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.
We are currently transitioning to upgraded shell and web servers. The current server (mire) is deprecated and slated for removal in early 2013. See NavajosBogMigrationGuide for instructions on how to take advantage of the new servers. All members are highly encouraged to reconfigure their domains as soon as possible.
|
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. |
|
|
How to pay dues to HCoop, and the consequences of falling behind in payment. |
|
|
Our full procedures for contacting HCoop volunteers and asking questions about HCoop. |
|
|
|
|
|
How to log in to our machines, and a brief explanation of what our machines do. |
|
|
How to buy yourself a domain name from a registrar and manage it at HCoop. |
|
|
The bare minimum that you need to know concerning our use of DomTool. |
|
|
How to serve your website(s). |
|
|
How to serve common web applications |
|
|
Using PostgreSQL and MySQL databases. |
|
|
How to transfer files to and from your home directory, which is kept in AFS. |
|
|
How to receive and manage your email, deal with spam, and set up Mailman mailing lists. |
|
|
How to use Jabber for instant messaging. |
|
|
In general, how to run unattended commands (such as custom daemons or commands called from cron scripts) from your AFS home directory. |
|
|
How to use cron to run commands periodically. |
|
|
How we back-up your data and how you can access the saved copies. |
|
|
How to use version control software to host code on HCoop servers. |
|
|
|
|
|
Answers to questions often asked about DomTool and our setup. |
|
|
Data retention policies upon membership termination. |