LIESMICH

   1 LIESMICH für arla-0.35 ($Name$)
   2 $Id$
   3
   4 Für alle, die zuerst 'mal lieber auf Deutsch lesen. Die Lektüre von
   5 README wird aber trotzdem empfohlen.
   6
   7 1. Was ist Arla?
   8
   9 Arla ist eine freie Implementation des AFS Cacheverwalters.
  10
  11 2. Wo finde ich diese Datei?
  12
  13 Diese Datei ist enthalten in
  14 ftp://ftp.stacken.kth.se/pub/arla/arla-0.35.tar.gz
  15 (d.h. /afs/stacken.kth.se/ftp/pub/arla/arla-0.35.tar.gz).
  16
  17 3. Was ist AFS?
  18
  19 AFS ist ein weltweit verbreitetes Dateisystem. Lesen Sie
  20 <http://www.transarc.com/afs/transarc.com/public/www/Product/AFS/FAQ/faq.html>
  21 für mehr Informationen.
  22
  23 4. Was ist in Arla enthalten?
  24
  25 Kerneltreiber (mit verschieden guter Unterstützung)
  26 für folgende Operativsysteme:
  27
  28 - FreeBSD 3.x, 4.,x und 5.x
  29 - OpenBSD 2.2-2.7
  30 - NetBSD 1.2, 1.3, 1.4 und 1.5
  31 - Linux 2.0.x, 2.1.x, 2.2.x, 2.3.x, 2.4.x
  32 - SunOS 4
  33 - Solaris 2.5, 2.6, 7 und 8
  34 - AIX 4.x
  35 - IRIX 6.x
  36 - Digital Unix 4.0, 5.0 (OSF/1)
  37 - Darwin (MacOS DP3)
  38
  39 Nur auf Anwenderniveau:
  40 - Ultrix 4.4
  41
  42 Der Cacheverwalter (arlad) der sowohl im "user-level" als auch mit
  43 den Kerneltreibern angewendet werden kann. Im "user-level" Modus
  44 ist er sehr gut zu portieren und ist (mit den Cygwin32 Bibliotheken)
  45 sogar unter Windows NT gefahren.
  46
  47 Einige einfache Programme (amon, fs, klog, tokens, vos, udebug, und pts).
  48
  49 Einen experimentellen AFS server, Milko genannt.
  50
  51 5. Auf welchem Niveau befindet sich Arla?
  52
  53 Dies ist noch vor den berühmten griechischen Buchstaben.
  54
  55 Doch funktioniert das meiste. Dateien können gelesen und geschrieben
  56 werden, mit oder ohne Identitätskontrolle. Es ist noch nicht so stabil
  57 und schnell wie wir wünschen. Der Cache funktioniert nur für ganze
  58 Dateien, aber das reicht wohl fürs Erste.
  59
  60 6. Was brauche ich um Arla anzuwenden?
  61
  62 Mit einem der oben genannten Systeme sollte es Ihnen möglich sein das
  63 AFS Dateiensystem zu montieren (und vielleicht auch Ihrem Kernel einen
  64 Panic zu verpassen).
  65
  66 Die Anwenderprogramme dürften auf fast jedem Unixdialekt compilieren
  67 und funktionieren.
  68
  69 Wenn sie die Identitätskontrolle anwenden wollen brauchen Sie auch
  70 Kerberos V4. Wir empfehlen wärmstens die von
  71 <http://www.pdc.kth.se/kth-krb/>.
  72
  73 Ab OpenBSD 2.3 ist kth-krb schon dabei. Doch muß die Zeile 'AFS=yes'
  74 in /etc/mk.conf hinzugefügt und libkafs und afslog neu compiliert
  75 werden (sind unter /usr/src/kerberosIV/{kafs,afslog} zu finden).
  76
  77 Hier haben wir einen Abschnitt über MIT-Kerberos (eigentlich nur für
  78 unsere amerikanischen Anwender) ausgelassen (ist im README zu lesen).
  79
  80 Falls Sie kein Kerberos Anwender sind sollte es Ihnen möglich sein die
  81 Funktion zu testen, doch wo ist dann der Witz der Sache? Wir testen
  82 Arla auch nicht ohne Kerberos.
  83
  84 7. Wie installiere ich Arla?
  85
  86 Das steht in der Datei INSTALL (bis jetzt nur auf Englisch).
  87
  88 8. Was mache ich wenn ich einen Fehler finde?
  89
  90 Schreiben Sie einen so detaillierten Rapport wie möglich (auf Englisch)
  91 an <arla-drinkers@stacken.kth.se>. Patches sind auch willkommen.
  92
  93 Falls Sie einen "Bug" finden und keine Ahnung haben was da denn falsch
  94 gelaufen sein könnte, versuchen Sie es noch einmal mit
  95 `arlad -n -z --debug=almost-all' und legen sie den produzierten Text
  96 dem Email bei. Sie können auch das Debugniveau eines laufenden arlad
  97 (als root) mit `fs arladebug <debug-level>' ändern. Das gleiche gilt
  98 für den Kerneltreiber mit `fs nnpfsdebug <debug-level>'. Das Ergebnis
  99 landet in Ihrem syslog (/var/log/messages, /var/adm/messages oder so
 100 ähnlich).
 101
 102 Falls arlad abstürzt, wenden sie bitte gdb an um dem core mit `bt'
 103 einen Backtrace zu entziehen. Auch können Werte der Variabeln nützlich
 104 sein. Falls kein core produziert wird kann arlad unter gdb (mit -n -z)
 105 gestartet werden.
 106
 107 Im Falle eines Kernelabsturtzes, versuchen Sie mit den Mitteln Ihres
 108 Betriebssystems einen Dump zu erzeugen und den Debugger
 109 anzuwenden. Die Dokumentation Ihres Betriebssystems hilft Ihnen
 110 hoffentlich weiter.
 111
 112 Ohne diese Information können wir Ihnen nicht helfen.
 113
 114 9. Wie kann ich die Menge der Debuginformation steuern?
 115
 116 Sowohl arlad als auch nnpfs (der Kerneltreiber) haben Variabeln mit
 117 denen die Art der Debuginformation (und damit die Menge) kontrolliert
 118 werden kann.
 119
 120 Arlad anwendet `--debug' und nach dem Start `fs arladebug'. Für
 121 den Kerneltreiber wendet man `fs nnpfsdebug' an.
 122
 123 10. Wie schwierig ist es Arla auf ein neues Betriebssystem zu
 124     portieren?
 125
 126 Nicht sehr. Im user-level sind die Unterschiede gering zwischen
 127 verschiedenen Betriebssystemen. Für den Kernel kann man mit einem
 128 anderen ähnlichen System (in nnpfs/SYSTEM) anfangen. Falls Sie sich für
 129 so etwas interessieren oder sogar Arla auf einem oben nicht genannten
 130 Betriebssystem laufen haben, schicken Sie ein Email an
 131 <arla-drinkers@stacken.kth.se>.
 132
 133 11. Bekannte Probleme.
 134
 135 OpenBSD hat auf einigen Architekturen Probleme mit mmap. In diesen
 136 Fällen kann auf configure mit `--disable-mmap' ausgewichen werden. Wir
 137 haben das auf sun4m bemerkt.
 138
 139 Falls Sie Probleme mit dem Cache bemerken, entfernen sie den cache
 140 (normalerweise `/usr/arla/cache') und starten Sie dann arlad neu.
 141
 142 Mit Digitals cc Program brauchen Sie wahrscheinlich -std1 (d.h. CC als
 143 "cc -std1" definieren wenn sie configure anwenden).
 144
 145 Solaris hat keine Memcpy-funktion im Kernel, gcc generiert aber
 146 manchmal trotzdem solche Anrufe. Falls das passiert, verwenden sie
 147 entweder Suns Compilator oder schreiben Sie die memcpy Anrufe m.H. von
 148 bcopy um.
 149
 150 12. Wie kann ich behilflich sein?
 151
 152 Mit Quellkod. Bugreports und Patches sind immer willkommen.
 153
 154 13. Gibt es Emaillisten?
 155
 156 arla-drinkers@stacken.kth.se    Allgemeine Diskussion.
 157 arla-announce@stacken.kth.se    Nur Neuigkeiten.
 158
 159 Senden Sie eine Email an <LIST>-request@stacken.kth.se um Mitglied zu
 160 werden.
 161
 162 14. Gibt es eine Webpage?
 163
 164 Ja, http://www.stacken.kth.se/projekt/arla/
 165
 166 15. Wie ist die Lage mit Copyrights für Arla?
 167
 168 lwp und rx haben Copyright von IBM. Wir danken Derrick J Brashear
 169 <shadow@dementia.org> und Jim Doyle <jrd@bu.edu> die es möglich
 170 gemacht haben sie anzuwenden.
 171
 172 Die rxkad Implementation ist von Björn Grönvall <bg@sics.se> und ist auch
 173 in kth-krb enthalten.
 174
 175 Editline ist von Simmule Turner und Rich Salz.
 176
 177 Der Kod für den nicht angeschlossenen Modus ist von Wuwei Shen.
 178
 179 Der Kod um all das zusammenzuhalten ist von uns selbst.
 180
 181 <arla-drinkers@stacken.kth.se>
 182
 183 16. Was ist seit * passiert?
 184
 185 Steht in NEWS und ChangeLog.
 186
 187 17. Und was bedeutet `arla'?
 188
 189 - Arla ist ein schwedisches Wort für `früh'. Der größte Teil von
 190 Arla wurde am frühen Morgen verfaßt.
 191
 192 - Arla is auch der Name des grössten schwedischen Produzenten für
 193 Milchprodukte. Sie produzieren unter anderem `fil' (schwed. filmjölk
 194 ist eine Art Sauermilch). `Fil' ist auch das schwedische Wort für
 195 Datei.