Richtige Dokumentation

[-roX-]

Hallo zusammen,

jeder ITler weiß wie wichtig es ist jede noch so kleine Veränderung wo auch immer zu Dokumentieren. Ich versuche dies immer Gewissenhaft zu tun, doch kommen mir manchmal Zweifel ob ich diese auch richtig Dokumentiert habe oder ob ich dies hätte besser machen können. 

Habt ihr i-welche Vorlagen die ihr benutzt die empfehlenswert wären oder erstellt ihr eure eigene Doku lieber selbst. Evtl könntet ihr mir ja einige Seiten oder Bücher empfehlen.

Dankeschön im Voraus

 

[Systemlord]

Von was für einer Dokumentation sprichst Du genau? Changemanagement für Hardware/Infrastruktur?

[-roX-]

Für Server, da ich an mehreren Servern für mehrere Standorten gleichzeitig arbeite und jede ach so kleine Veränderung (z.B in der Registry) eintragen möchte.  

[allesweg]

Trägst du diese Änderungen händisch ein oder werden diese per Tool eingespielt?

[-roX-]

Es gibt kein Tool, ich trage alles entweder in Word oder Excel händisch ein.

[Gast Arvi]

Letztendlich ist es fast egal welches Dokumentationswerkzeug man benutzt, es muss nur einen Konsens im Team geben und Änderungen müssen halt strickt dokumentiert werden. Wir dokumentieren meistens in OneNote, weil man da auch schön Screenshots, Tabellen und Konfigurationsdateien rein pasten kann.

Erfahrungsgemäß ist das ein Kampf gegen Windmühlen, deshalb benutze ich inzwischen für die meisten Systeme ein Konfigurationsmanagement Werkzeug wie Puppet. Darüber Rolle ich jegliche Software und Konfiguration aus, egal ob Datenbankserver Konfiguration, Registy, irgendwelche Windows Einstellungen, Benutzer, Dienste ...

Hat den Vorteil das so ein Werkzeug nicht nur einmalig etwas ausrollt, sondern euch ständig prüft, ob die Einstellungen auch gesetzt sind alle 30 mins und falls nicht, ändert er sie wieder so wie es definiert wurde. Das ganze kriegt man dann schön via Reports in einem Dashboard aufbereitet wo man auch alle Konfigurationen einsehen kann.

Ich Hab die Erfahrung gemacht, dass sich das bereits ab einer handvoll Server lohnt und bei einer 3 und 4 stelligen Anzahl an Servern geht es eigentlich gar nicht mehr richtig ohne (bzw. Ich will es nicht =D )