#pragma section-numbers off

= Admin Area =

Links to detailed policies, procedures and information specific to HCoop. The resources here should allow HCoop admin team members to share information about every part of the complete system, and to allow easier training of future team members.


<<TableOfContents>>


== To be an admin ==

Sections you should read if you are interested in being an admin.

{{{#!wiki tip
Admins: it is recommended that you watch the changes [[http://wiki.hcoop.net/RecentChanges?action=rss_rc&diffs=1&ddiffs=1|RSS feed]] to keep informed of what everyone is up to.  Then, please document all of your work on here somewhere - that way we will not only have a record, but everyone gets notified about what is going on.  Alternatively, you can create a wiki account and subscribe to the page regex `.*` (all pages).
}}}

=== Admins and Admin Responsibilities ===

 * TaskDistribution: What each sysadmin is responsible for.
 * VolunteerResponsePolicy: Guidelines for responding to requests and email.
 * AdminArea/ListOfVolunteers who can help us do stuff...
 * AdminGroup: Listing of people who can delete pages and despam pages on the wiki.

=== Introductory material ===

Refer to documentation of each of the listed components. The information in our Wiki pages covers only the most basic principles, and quickly focuses on HCoop-specific setup, assuming skillset with the technology.

 * DaemonDocumentation: manuals for core services with which you should be familiar
 * SystemArchitecture
 * DomTool
 * MitKerberos
 * AndrewFileSystem
 * EtcKeeper
 * [[Code]]: Details of HCoop-specific code kept in git.hcoop.net
 * [[OpenLDAP]]

== Planning and Records ==

 * ToDo: Both short term and longer term meta-planning.
 * IpAddresses: Listing of IPs that we use.
 * [[Hardware]]: Information on HCoop hardware.
 * HcoopAddresses: Physical addresses relevant to us.
 * OnSiteVisits: Records of visits by HCoop volunteers to our colocation facilities

== Hardware / On-Site Infrastructure ==

 * [[Hardware]]: information on the colocation facility and the physical/virtual machines we are using. Tips on using service processors etc. are here.
 * InstallationProcedure: how to install a machine that adheres to our policies
   * KernelVirtualMachine: how we are using libvirt
   * SetupNewMachines: The ''old'' guide to installing a machine that adheres to our policies
 * KvmAccess: How to use the remove KVM and avoid going on site

== Software ==

This documents all software things that are not specific to the on-site infrastructure.

=== General Sysadmin ===

Documentation useful for the daily care and feeding of our systems.

 * AuthenticationScheme
 * BackupInfo: Information on how to recover deleted files from our off-site backups.
 * DebianPackaging: How to make custom HCoop Debian packages, and details on our debian archive
 * ConfigurationManagement: How we manage system wide configuration
 * SystemAuthentication lists authentication
 * UserManagement
   * MemberFreezing: How to freeze and unfreeze members who get behind on dues
   * AdminUserSetup, AddingNewAdmins, ChangingAdminPassword: lists steps to create (blank), delete, and change passwords of admin users.

=== Specific Services ===

Documentation of interest to people maintaining particular services.

<<Include(DaemonAdmin, ,to="^----$")>>

 * DomTool
 * Web
   * CertificateAuthority: How to sign user SSL certificates and the like.
   * WebServicesAdmin: How to administer hcoop provided web services
 * VersionControlAdmin
 * [[BugZilla]]

== Historical ==

Pages no longer considered relevant, but may be of historical interest or otherwise useful as source material for updated documentation.

 * AFS / Kerberos
   * SetupNewAfsServer: How to set up a new AFS server.
   * PrincipalsForNonHumans talks about kerberos for automated tasks.
 * Mail
   * MailMan contains no information...
   * SpamAssassinAdmin
 * UsingResourceLimits
 * DaemonFileSecurity
 * ResourceLimits
 * TipsAndTricks
 * SoftwareArchitecturePlans: Plans for software installation.
 * SystemArchitecturePlans: Plans regarding our hardware.
 * InstallationLog contains ancient (~2005) records of installation of software and hardware
 * KrunkInfoz (Krunk is out of service)
 * [[Migration2009]] (never happened, staying at Peer1 was a better choice after all)
   * [[Migration2009/SoftwareSetup]]
 * InstalledSoftware

----
CategorySystemAdministration