fragen stichworte

Was verwende ich für die Serverdokumentation?

Ich musste die Server dokumentieren, die ich verwende, und ich weiß nicht, wie ich die Daten halten soll. Könnten Sie den besten Weg empfehlen, die Serverdokumentation aufzubewahren? Erstelle ich eine Datenbank, die die Harware- und Softwaredokumentation enthält, oder verwende ich Wiki-Seiten oder SVN? Oder wenn es ein Werkzeug gibt, das die Dokumentation enthält, könnten Sie den Link angeben.

antworten

Ich persönlich benutze ein kleines Programm namens The Guide, das ich viel schneller finde als ein Wiki (das ich auch verwende). Sie können sogar Excel-Dateien sowie viele andere Dateitypen direkt in die Seiten einbetten.

Es gibt eine tragbare Version , sodass Sie sie überall hin mitnehmen können, wenn Sie sich auf einem USB-Flashlaufwerk befinden. Ich wünschte nur, es gäbe einen Linux-Client, der die gleichen Dateien lesen könnte.

Ein Wiki oder Google Docs eignet sich jedoch besser für die Zusammenarbeit.

The Guide

Es gibt keinen wirklich besten Weg, dies zu tun. Das hängt stark von der Umwelt, den Menschen, den Systemen, dem Budget und den individuellen Vorlieben ab.

Bevor Sie auswählen können, was die "beste" Option ist, müssen Sie Ihre Anforderungen verstehen. Spezifische Anforderungen, nicht nur "Wo lege ich meine Dokumentation an?". Welche Hardware/Software haben Sie jetzt zur Verfügung? Wie viele Leute werden das nutzen? Welches Budget habe ich für Hardware und/oder Software? Ist dies nur für die Serverdokumentation oder werden andere technische Dokumentationen mitgeliefert? Benötigen andere Gruppen Zugriff auf die Dokumentation? Wie sicher muss die Dokumentation sein? Nachdem Sie einige dieser Fragen beantwortet haben, können Sie Ihre Optionen überprüfen.

Wenn Sie ein Microsoft-Shop sind, werden Sie wahrscheinlich zu den Tools wechseln. Wenn Sie ein Open Source-Tools-Shop sind, tendieren Sie wahrscheinlich zu etwas Open Source. Wenn Sie die Möglichkeit haben, schnelle Änderungen vorzunehmen, ist ein Wiki eine gute Möglichkeit. Wenn Sie möchten, dass Ihre Dokumentation in Dateisätzen aufgeteilt ist, ist eine Dateifreigabe oder SharePoint möglicherweise die richtige Lösung. Wenn Sie viele Screenshots in Ihre Dokumentation aufnehmen möchten, ist OneNote möglicherweise die richtige Antwort. Wenn Sie etwas Wiki-ähnliches, aber in sich geschlossenes (Wiki-in-a-Datei) möchten, ist TiddlyWiki ein großartiges Werkzeug.

Unter Ihren vielen Optionen (keine umfassende Liste):

Das Wichtigste ist, dass Sie etwas verwenden. Dokumentation ist der Schlüssel. Stellen Sie außerdem sicher, dass Sie es relativ einfach und mit geringem Aufwand betreiben. Es ist genauso wichtig, die Dokumentation auf dem neuesten Stand zu halten, wie sie im Voraus zu schreiben. Wenn das Aktualisieren Ihrer Dokumentation nicht so einfach wie möglich ist (und in Richtlinien eingebettet ist, um sicherzustellen, dass sie aktualisiert werden), wird dies nicht getan. Sie möchten nicht, dass die Leute Dokumentationsaktualisierungen überspringen, weil das Aktualisieren eine schwierige Sache ist.

Nun, ich weiß nicht, was Ihre spezifischen Anforderungen im Detail sind, aber ich kann Ihnen sagen, was Sie vermeiden sollten (basierend auf meiner persönlichen Erfahrung).

Verwenden Sie keine Office-Anzüge für Dokumentationen wie OpenOffice oder Word, da sie ihre Daten in ihren eigenen Formaten wie .doc oder .odt speichern. Dies kann sehr schmerzhaft sein, wenn Sie später zu einem anderen Dokumentationssystem wechseln.

Ich kann Ihnen auch raten, Ihre Dokumentation nicht in .txt-Dateien zu speichern. Obwohl sie einfach zu handhaben sind (können ohne großen Aufwand bewegt werden, können durchsucht werden usw.), ist dies eine sehr ineffiziente Art, Ihre Sachen zu organisieren. Vor allem, wenn Sie Bilder oder Videos in Ihre Dokumente einbetten möchten.

SVN ist keine schlechte Möglichkeit, Ihre Daten zu speichern, hat aber Nachteile, wenn Sie anderen Benutzern den Zugriff auf Ihre Daten erlauben möchten. Desweiteren müssen Sie ständig Updates, Checkouts usw. durchführen. Das kann nervig sein (ich habe selbst SVN-Dokumentations-Repositories).

Der beste Weg, den ich bisher gesehen habe, ist entweder ein Wiki oder eine Kombination aus einem CRM (wir verwenden Sugar CRM) und dem Dateisystem. Ich bevorzuge Wiki-Systeme, wenn sie ein Versionsverwaltungs- und Benutzerverwaltungssystem haben. Dies ermöglicht eine einfache Zusammenarbeit, Sie können fast alles machen und Sie sind frei in der Art, wie Sie sich organisieren.

Wir haben Device42 für die Server- und Datencenter-Dokumentation verwendet. Tolles Werkzeug und diese Leute fügen ständig Funktionen hinzu. Nicht sehr teuer, etwa 250 Dollar für 100 Geräte.

Ich werde meine persönliche Empfehlung für OneNote geben. Seine Fähigkeit, schnell Screenshot Installationsprozesse und Änderungen (und dann tatsächlich in der Lage, den Text in den Bildern zu suchen) mit Win-S ist eine Killer-Funktion.

Was ich getan habe, ist:

Dokumentiert jeden Server in MS Word:

Die Dokumentation beinhaltet: a) Details zur Server-Hardware (Anzahl der NICs, Raid-Controller, Firmware-Versionen jeder Karte, BIOS-Version, Anzahl der physischen Festplatten und Firmware-Versionen.

b) Raid-Layout: Art der Raid-Level, Physical Disk-Mitgliedschaften in virtuellen Festplatten, Windows-Festplattennummern (Dies hilft mir zu identifizieren, welche Windows-Disk das ist, was auf meinem Server und Raid-Level ist).

c) Netzwerkkonfiguration: IP-Einstellungen, Firewall-Einstellungen, eingehende Ports sind erlaubt, Outbound erlaubt/nicht erlaubt.

d) Betriebssystem installiert: Version, Verwendeter Schlüssel, Installationsdatum, Speicherort der Seiten-Datei, alle anderen Treiber-Dumps oder Anwendungen, die ich darauf gespeichert habe, installierte Anwendungen und deren Websites (falls erforderlich).

e) Serverunterstützung/Herstellerunterstützung: Art des Supports, Kontaktnummer, Service-Tag.

Ich habe das AD-Topologiediagramm verwendet, um unsere AD-Infrastruktur zu visualisieren und als PDF zu speichern.

Ich habe dann ein Skript namens "Racktables" installiert, das opensource ist, eine mysql-Datenbank verwendet - sehr einfach einzurichten.

Was ich verwende, um meine Server Room RACKS und ihre Server zu plotten, wandle ich die MS Word-Dateien in PDF um und lege sie an diese Racks an.

Sie können auch das SYDI Documentation-Projektscript verwenden, um Ihre Server zu dokumentieren:  http://ogenstad.net/2006/10/18/how-to-document-servers-with-sydi-part-1-of-3/

Hoffe, dass hilft Rihatum

Auf der Open-Source-Seite von Dingen, die dafür bestimmt sind, Dokumentation über Computer, Software, Drucker (und wie hat sich das mit der Zeit geändert) zu halten, ist GLPI.

Für zusätzliche Funktionen gibt es auch eine Wissensbasis, ein System zum Nachverfolgen, welche Computer wo angeschlossen sind (auf der Netzwerkebene). Es beinhaltet ein Ticket-System für das Melden/Lösen von Problemen und den Helpdesk.

Wir benutzen Wiki hier. Ein großartiges Werkzeug, besonders wenn Sie Dokumente zur internen Bearbeitung freigeben

Ordner mit Tabellen mit Informationen zu jedem Server, Dokumente/PDFs von Benutzerhandbüchern, Kontaktinformationen für OEMs/VARs/Support usw.

Dann hol etwas wie Dropbox/Zuckersync/etc. und stellen Sie sicher, dass Sie alles mit dem Internet synchronisieren, damit alles, was Sie aktualisieren, repliziert wird. Sie werden dies in einer DR-Situation mögen.

NodeSystems ist so konzipiert, dass es die Server-Dokumentation enthält. Als Nebeneffekt erzeugt es auch ein interaktives Diagramm.

Sehen Sie sich die Online-Demo hier an:  http://www.nodesystems.org/demo/