ein offenes Dokumentationssystem für ein virtuelles Kompetenznetzwerk HLRNDoc ein offenes Dokumentationssystem für ein virtuelles Kompetenznetzwerk Dr. Bernd Kallies Konrad-Zuse-Zentrum für Informationstechnik Berlin Takustraße 7 14195 Berlin email: kallies@zib.de
HPC in Norddeutschland - HLRN Hardware Kompetenz 24 Knoten IBM pSeries 690 768 Power4 CPU‘s 2 TByte Memory total 52 TByte Plattenspeicher ca. 4 TFlop/s peak HPC: ZIB, RRZN Klimaforschung: MV, HH, HB Chemie: B, NS, SH Physik: B, HH Ingenieurswiss.: B, NS Norddeutscher Verbund für Hoch- und Höchstleistungsrechnen
Dokumentation als Servicebestandteil Hardware, Konfiguration Systemspezifika Batchsystem Datenhaltung Softwaredokumentation Dokumentation des Herstellers Dokumentation unabhängiger Softwarehersteller Architektur- und problembezogene eigene Dokumentationen Policies, Administratives Zugang Nutzungsregeln Accounting, Projektadministration Dokumentation - Inhalte
Dokumentation in Rechenzentren Welche Lösung?
Randbedingungen Inhalte Autoren Leser vorwiegend Text (Handbuchcharakter) häufige Aktualisierung / Erweiterung (wöchentlich bis monatlich) keine feste Strukturierung Autoren viele Autoren, keine festgelegten Zuständigkeiten, Teilnahme freiwillig unterschiedliche Arbeitsstile, -umgebungen UNIX-, Programmiererfahrung meist vorhanden Leser Naturwissenschaftler mit keinen bis exzellenten HPC-Erfahrungen unterschiedlichste Szenarien der Rechnernutzung HLRN - Spezifik
HLRNDoc - Komponenten CVS File Server SSH XML + XSL Leser XML-Editor Autor XSLT-Prozessor make HTTP Server HTML, PDF Content Management ohne CMS?
Quelle und Resultat XML + XSL (XSLT-Prozessor) HTML
XML, XSL http://www.docbook.org/, http://www.oasis-open.org/
XSLT-Prozessor http://www.xslt.com/ XML Source XSL Stylesheets XSLT- xsltproc HTML File HTML Files XMLFO XSLT- Prozessor (Xalan) PDF http://www.xslt.com/
make
Concurrent Versions System (CVS) http://www.cvshome.org/
Das Resultat 06.09.2002 23.06.2003 28.02.2003 http://www.hlrn.de/doc/
Fazit positiv negativ geringe Hemmschwelle zur Benutzung bewährt äußerst flexibel, nahezu beliebig erweiterbar sicher (CVS, SSH) negativ jeder Autor darf alles unhandlich bei ausgefallenem Layout http://www.hlrn.de/doc/