Dr. Bernd KalliesDr. Bernd KalliesKonrad-Zuse-Zentrum für Informationstechnik BerlinKonrad-Zuse-Zentrum für Informationstechnik BerlinTakustraße 7Takustraße 714195 Berlin14195 Berlinemail: [email protected]: [email protected]
HLRNDocHLRNDoc
ein offenes ein offenes
Dokumentationssystem für ein Dokumentationssystem für ein
virtuelles Kompetenznetzwerkvirtuelles Kompetenznetzwerk
Norddeutscher Verbund für Hoch- und HöchstleistungsrechnenNorddeutscher Verbund für Hoch- und Höchstleistungsrechnen
HPC in Norddeutschland - HLRNHPC in Norddeutschland - HLRN
• 24 Knoten IBM pSeries 69024 Knoten IBM pSeries 690• 768 Power4 CPU‘s768 Power4 CPU‘s• 2 TByte Memory total2 TByte Memory total• 52 TByte Plattenspeicher52 TByte Plattenspeicher• ca. 4 TFlop/s peakca. 4 TFlop/s peak
HardwareHardware KompetenzKompetenz
• HPC: ZIB, RRZNHPC: ZIB, RRZN• Klimaforschung: MV, HH, HBKlimaforschung: MV, HH, HB• Chemie: B, NS, SHChemie: B, NS, SH• Physik: B, HHPhysik: B, HH• Ingenieurswiss.: B, NSIngenieurswiss.: B, NS
Dokumentation - InhalteDokumentation - Inhalte
Dokumentation als ServicebestandteilDokumentation als Servicebestandteil
Hardware, KonfigurationHardware, Konfiguration SystemspezifikaSystemspezifika
BatchsystemBatchsystem
DatenhaltungDatenhaltung
Softwaredokumentation Softwaredokumentation Dokumentation des HerstellersDokumentation des Herstellers
Dokumentation unabhängiger SoftwareherstellerDokumentation unabhängiger Softwarehersteller
Architektur- und problembezogene eigene DokumentationenArchitektur- und problembezogene eigene Dokumentationen
Policies, AdministrativesPolicies, Administratives ZugangZugang
NutzungsregelnNutzungsregeln
Accounting, ProjektadministrationAccounting, Projektadministration
Welche Lösung?Welche Lösung?
Dokumentation in RechenzentrenDokumentation in Rechenzentren
HLRN - SpezifikHLRN - Spezifik
RandbedingungenRandbedingungen
InhalteInhalte vorwiegend Text (Handbuchcharakter)vorwiegend Text (Handbuchcharakter)
häufige Aktualisierung / Erweiterung (wöchentlich bis monatlich)häufige Aktualisierung / Erweiterung (wöchentlich bis monatlich)
keine feste Strukturierungkeine feste Strukturierung
AutorenAutoren viele Autoren, keine festgelegten Zuständigkeiten, Teilnahme viele Autoren, keine festgelegten Zuständigkeiten, Teilnahme
freiwilligfreiwillig
unterschiedliche Arbeitsstile, -umgebungenunterschiedliche Arbeitsstile, -umgebungen
UNIX-, Programmiererfahrung meist vorhandenUNIX-, Programmiererfahrung meist vorhanden
LeserLeser Naturwissenschaftler mit keinen bis exzellenten HPC-ErfahrungenNaturwissenschaftler mit keinen bis exzellenten HPC-Erfahrungen
unterschiedlichste Szenarien der Rechnernutzungunterschiedlichste Szenarien der Rechnernutzung
Content Management ohne CMS?Content Management ohne CMS?
HLRNDoc - KomponentenHLRNDoc - Komponenten
File ServerFile Server
HTTP ServerHTTP Server
AutorAutor
CVSCVS
XML + XSLXML + XSLLeserLeser
XML-EditorXML-Editor
XSLT-ProzessorXSLT-Prozessor
makemake
SSHSSH
HTML, PDFHTML, PDF
XML + XSL XML + XSL (XSLT-Prozessor) (XSLT-Prozessor) HTML HTML
Quelle und ResultatQuelle und Resultat
http://www.docbook.org/, http://www.oasis-open.org/http://www.docbook.org/, http://www.oasis-open.org/
XML, XSLXML, XSL
http://www.xslt.com/http://www.xslt.com/
XSLT-ProzessorXSLT-Prozessor
XMLSource
XSLStylesheets
XSLT-Prozessorxsltproc
HTMLFiles
HTMLFile
XMLFO
XSLT-Prozessor
(Xalan)
makemake
http://www.cvshome.org/http://www.cvshome.org/
Concurrent Versions System (CVS)Concurrent Versions System (CVS)
http://www.hlrn.de/doc/http://www.hlrn.de/doc/
Das ResultatDas Resultat
06.09.200206.09.2002
23.06.200323.06.2003
28.02.200328.02.2003
http://www.hlrn.de/doc/http://www.hlrn.de/doc/
FazitFazit
positivpositiv geringe Hemmschwelle zur Benutzunggeringe Hemmschwelle zur Benutzung
bewährtbewährt
äußerst flexibel, nahezu beliebig erweiterbaräußerst flexibel, nahezu beliebig erweiterbar
sicher (CVS, SSH)sicher (CVS, SSH)
negativnegativ jeder Autor darf allesjeder Autor darf alles
unhandlich bei ausgefallenem Layoutunhandlich bei ausgefallenem Layout