index: better intro
[openafs-wiki.git] / index.mdwn
1
2 <img id="andy" src="images/andy_juggles.jpg">
3
4 Welcome to the [OpenAFS](http://www.openafs.org) wiki. This is a web-based
5 collaboration area for collecting, maintaining, and distributing information
6 about OpenAFS, an open-source implementation of the AFS distributed filesystem.
7
8 OpenAFS is a caching, distributed, network-based filesystem for securely and
9 efficiently sharing files over a private network or over the internet.  OpenAFS
10 stores files on file server machines. OpenAFS clients read and write data to
11 the file servers. Data is cached locally by clients, making subsequent reads
12 very fast.  File servers automatically notify clients when when data is
13 changed, keeping data in sync.  OpenAFS clients integrate with the client
14 operating system to create a seamless network file system.  Client side support
15 is provided for wide-range of operating systems, including Windows, MacOS,
16 Solaris, and Linux.
17
18 OpenAFS requires a Kerberos 5 realm for mutual authentication of users and
19 servers. Kerberos implementations include Active Directory, MIT Kerberos, and
20 Heimdal kerberos.
21
22 ### Features ###
23
24 * global namespace
25 * location transparency
26 * client-side caching
27 * read-only replication
28 * access control lists
29 * kerberos integration
30
31
32 ## Guides and information
33
34 * [[Getting started|GettingStarted]]
35 * [[Creating a new AFS cell|CreatingANewCell]]
36 * [[Windows quick start guide|WindowsEndUserQuickStartGuide]]
37 * [[How to setup OpenAFS with Windows 2008 R2 AD server|Win2008R2ADasKDC]]
38 * [[Windows kerberos 5 AFS service principal|WindowsK5AfsServicePrincipal]]
39 * [[OpenAFS use case at CGV|usecase_cgv]]
40 * [[Add-on tools and utilities|AddOnsToolsAndUtilities]]
41 * [[Where to get help|WhereToGetHelp]]
42 * [[Frequently asked questions|AFSFrequentlyAskedQuestions]]
43
44
45 ## For the Community
46
47 * [[A list of tiny and simple tasks|TinySimpleTasks]]
48 * [[Contributed scripts and tools|Contrib]]
49 * [[Maintaining documentation|MaintainingDocumentation]]
50
51
52 ## For Developers
53
54 * [[OpenAFS developer documentation|OpenAFSDevelopers]] - documentation for developers of [[OpenAFS]], including details of our revision control system, and lists of tasks that need doing.
55 * [[AFS3 protocol information|ProtocolInfo]]
56 * [[New projects|NewProjects]]
57 * [[Code architecture|CodeArchitecture]]
58 * [[Gatekeeping|GateKeeping]]
59 * [[How to build OpenAFS from source|HowToBuildOpenAFSFromSource]]
60 * [[How to build OpenAFS RPM packages|HowToBuildOpenAfsRpmPackages]]
61 * [[Demand attach file server|DemandAttach]]
62 * [[Pioctl interface documentation|OpenAFSPioctlInterfaceDoc]]
63 * [[Doxygen style guide|OpenAFSDoxygenStyleGuide]]
64 * [[Website project|OpenAFSWebsiteProjectPage]]
65 * [[Cache pinning|OpenAFSCachePinning]]
66 * [[Cache manager porting notes|CacheManagerPorting]]
67 * [[Buildbot]]
68 * [[Debugging]]
69 * [[Backup methods|BackupMethods]]
70
71 ## About this wiki
72
73 * [[How to use this wiki|ikiwiki]]
74 * [[How to use git to edit pages|GitWiki]]
75 * [[Try out the wiki sandbox|sandbox]]
76 * [[Site Map|WikiSiteMap]]
77 * [[Orphaned pages|WikiOrphanedPages]]
78 * [[Broken links|WikiBrokenLinks]]
79
80