HLRNDoc ein offenes Dokumentationssystem fr 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 p. Series 690 768 Power 4 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 > 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 HTTP Server Content Management ohne CMS? make HTML, PDF

Quelle und Resultat XML + XSL (XSLT-Prozessor) HTML

XML, XSL http: //www. docbook. org/, http: //www. oasis-open. org/

XSLT-Prozessor XML Source XSL Stylesheets XSLTProzessor xsltproc HTML Files XMLFO XSLTProzessor (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 > 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/