mrheisenberg
Goto Top

Interne IT-Dokumentation

Moin Leute,

kurze und knappe Frage, wie haltet Ihr es mit eurer Dokumentation?

Unser ist-Stand, da wir relativ wenige User haben, gibts auch kein Ticketsystem wo in der DB diese Dinge abgelegt werden, und mir kommt die Ablage am Fileserver etwas überholt vor, mein Gedanke wäre evtl. Richtung Sharepoint, aber im besten Fall kostenlos.
Wir haben bereits MediaWiki eingeführt, und befüllen dieses System brav für unsere User als Starthilfe, mir kommt es aber unpassend vor für interne IT-Dokumente, da die User darauf Zugreifen können, ist und bleibt ja ein "Wikipedia" würde ich behaupten.

Hat hier jemand ein System bei sich im Einsatz welches für sowas brauchbar ist?
Es sollten .pdf Dateien sowie Excel/Word usw. drauf kommen und entsprechend nur für die IT zugänglich sein, also sozusagen ein sicherer Speicher für Angebote, interne Dokus usw. !KEINE PASSWÖRTER! , die liegen auf einer eigenen Plattform.

Ich bin seit ca. einem Jahr im Unternehmen, und am Fileserver kannst nix finden, die Suche nach Schlagwörter funktioniert fast nicht, bis gar nicht, und wennst schnell was brauchst schaust in die Röhre.

Hosten würde ich dies gerne intern, über Linux oder Windows ist im Prinzip egal, weil ich denke interne IT-Dokumentationen sollten nicht in der Cloud landen, kann etwas altmodisch sein, sonnst bin ich kein Cloud Gegner, aber hier sagt meine persönliche Einstellung nein, klingt komisch, ist aber so.

Kurz und knapp, ich würde Input suchen für ein Dokumentationssystem, kostenlos im besten fall, mit Index/Suchfunktion, Verarbeitung von Word, Excel, .pdf, PowerPoint usw. , auf Linux oder Windows und keine Cloudlösung.

Freue mich über eure Vorschläge

Grüße

Content-ID: 8007585419

Url: https://administrator.de/contentid/8007585419

Ausgedruckt am: 21.11.2024 um 20:11 Uhr

Nils02
Nils02 31.07.2023 um 09:16:09 Uhr
Goto Top
Moin,

wir nutzen OneNote.
Ist aber natürlich auch nicht ideal, sollte aber über Sharepoint z. B. machbar sein.

Alternativ eins der zig Wiki-Systeme mit Berechtigungssystem einführen, wo man das trennen kann face-smile

LG
em-pie
em-pie 31.07.2023 um 09:25:00 Uhr
Goto Top
Moin,

Nimm das Mediawiki und hau da Berechtigungen drauf. bzw. leg da mal BlueSPice drüber.
Haben wir auch: IT ist nur für den elitären Kreis bestimmt, Rest ist frei zugänglich...

Was soll eure Doku denn eigentlich umfassen? Nur die Konfiguration der Systeme und deren Abhängigkeiten untereinander oder auch eine Art Inventarübersicht?
nachgefragt
nachgefragt 31.07.2023 um 09:49:24 Uhr
Goto Top
OneNote, wechseln aber zu Bookstack wegen MS-Cloud-Gedöns.
MrHeisenberg
MrHeisenberg 31.07.2023 um 09:57:46 Uhr
Goto Top
Zitat von @em-pie:

Moin,

Nimm das Mediawiki und hau da Berechtigungen drauf. bzw. leg da mal BlueSPice drüber.
Haben wir auch: IT ist nur für den elitären Kreis bestimmt, Rest ist frei zugänglich...

Was soll eure Doku denn eigentlich umfassen? Nur die Konfiguration der Systeme und deren Abhängigkeiten untereinander oder auch eine Art Inventarübersicht?

Inventarisierung bilden wir über SnipeIT ab, hier soll rein die Doku rein mit IP-Adressen, Angebote, Absprachen mit Lieferanten und wie du bereits erwähnt hast die Systeme mit deren Abhängigkeiten.

Grüße
it-frosch
it-frosch 31.07.2023 um 11:40:12 Uhr
Goto Top
Morgen,

Zim Desktop oder Worddokument mit Ablage auf Fileserver.

Grüße vom IT-Frosch
Dani
Dani 31.07.2023 um 12:42:45 Uhr
Goto Top
Moin,
kurze und knappe Frage, wie haltet Ihr es mit eurer Dokumentation?
höchstes Gut. Ohne Doku wird bei uns nichts installiert, konfiguriert und Schnittstellen angebunden. Das geht je nach Kritikalität soweit, dass man die VMs löschen kann und mit Hilfe der Doku dieses wieder vollständig aufbauen kann.

Hat hier jemand ein System bei sich im Einsatz welches für sowas brauchbar ist?
Microsoft Sharepoint und Atlassian Confluence. Wichtig ist unabhängig des Produkts, dass der Disaster Recovery Plan für das führende System als PDF noch auf einem USB Stick gespeichert wird, welcher in einem Tresor aufbewahrt wird. Denn dort müssen mehr oder weniger auch IP-Adressen, Passwörter, etc. enthalten sein. Sonst hat man ein Henne-Ei Problem.


Grüße,
Dani
kreuzberger
kreuzberger 31.07.2023 um 12:54:26 Uhr
Goto Top
Moin,

die Clients werden mit einem PowerShell Script erfasst/inventarisiert. Davon gibt es unzählige im WWW, davon hab ich mir das schönste genommen und so abgewandelt wie es mir passt.

Die Hardware mit Tools zu erfassen finde ich nicht so genial, weil es mich von diesen Tools auch im Notfall abhängig macht. Ist das Netz futsch, nützen mir diese Tools nicht.

Also liegen die Infos als Banale TXT Dateien auf verschiedenen Storages synchronisiert.

Das Netzwerk ist ausserdem in TXT Dateien erklärt, freie formulierter Text.

Es gibt eine Backup-Buch, wo alle Backups, vor allem die per Hand durchgeführten erfasst werden.
Einige superwichtige Clients werden als Image Backup gesondert gesichert.
Das steht da dann auch drin.

Ein Notfallbuch macht ggf auch sinn, um bei Totalausfall / Verschlüsselungstrojaner eine Vorgehensweise hat, wie mann am schnellsten wieder zum Arbeiten kommt.

Passwörter kann man für den Notfall in zugeklebten, beschrifteten Couverts im Safe beim Chef oder Personalvorstand ablegen. Schliesslich kann der Admin ja auch mal ausfallen.

Spezialsoftware für sowas alles macht eben abhängig von solcher Software und ist u.u. im Notfall nicht funktionabel. daher sind ganz einfache Lösungen eher die Pfiffigen. Zudem sammeln gerade Inventarprogramme eine Unmenge an Daten zusammen, die man normalerweise nicht braucht.

Kreuzberger
erikro
erikro 31.07.2023 um 13:07:11 Uhr
Goto Top
Moin,

Docusnap dokumentiert alles automatisch, was automatisch dokumentiert werden kann. Einiges wird dort händisch nachgetragen bzw. halbautomatisch importiert (z. B. mobile devices). Für Workflows, Troubleshooting etc. nutzen wir mediawiki. Das lässt sich sehr wohl mit einer Benutzerverwaltung, die an das AD angebunden werden kann, versehen werden.

Liebe Grüße

Erik
MrHeisenberg
MrHeisenberg 31.07.2023 um 13:31:52 Uhr
Goto Top
Zitat von @erikro:

Moin,

Docusnap dokumentiert alles automatisch, was automatisch dokumentiert werden kann. Einiges wird dort händisch nachgetragen bzw. halbautomatisch importiert (z. B. mobile devices).


Die Dokumentation der Geräte passiert händisch durch unser AssetMGM (SnipeIT), da so oder so alle Geräte durch unsere Hände gehen.


Für Workflows, Troubleshooting etc. nutzen wir mediawiki. Das lässt sich sehr wohl mit einer Benutzerverwaltung, die an das AD angebunden werden kann, versehen werden.


Hast du bei MediaWiki die LDAP-Erweiterung verwendet?

Liebe Grüße

Erik

Grüße
MrHeisenberg
MrHeisenberg 31.07.2023 um 13:33:04 Uhr
Goto Top
Zitat von @it-frosch:

Morgen,

Zim Desktop oder Worddokument mit Ablage auf Fileserver.

Grüße vom IT-Frosch

Hi,

ich möchte eigentlich weg vom "Fileserver"
Crusher79
Crusher79 31.07.2023 um 14:05:39 Uhr
Goto Top
Hallo,

würde immer auch Worst-Case im Auge behalten. Bzw. dann die Notfall-Doku gesonder gehandhabt wissen. Datenbanken, virutelle Maschinen etc. auf denen die Doku liegt sind schön - so lange sie funktionieren. TXT klingt alt, unstrukturiert und nach "Zettelwirtschaft". Hat aber den Vorteil, dass man es jederzeit einfach lesen kann. Mediawiki wäre somit auch +1, da hier alles in TXT gespeichert vorliegt. Die Formatierungen gehen nur verloren. xWiki finde ich als Wiki noch schöner, aber leider nicht so aufgeräumt wie Mediawiki.

Denke die Wahrheit liegt dazwischen! Keepaas kann auch als Notfallbeschreibung mit dienen und man erhält die Kennwörter. Im Notfall ohne AD etc. muss ja irgendwie an ESXi, vCenter und was weiß ich heran kommen.

Eine grobe Skizzierung, bzw. Anweisungen kann man auch in Keepass hinerlegen. Man hat dann alles beisammen.

Es gibt auch kleinere wiki Varianten für den Browser. Nur da muss ggf. nachinstallieren. Was wenn kein Internet da ist? Provider Daten stehen unter XYZ.

https://github.com/zadam/trilium

Trilium bietet auch einiges. Vor allem eine API. Man kann auch einfach aus Firefox mal zwischendurch Seiten oder Bilder speichern. Auch als portable Variante.

Überlegung wäre ggf. Anwendungen wie Trilium via JSON mit anderen Systemen zu syncen.

- Wiki
- Trilium
- Keepass

Und deren Abkömmlinge. Ggf. in Kombination. Portable Varianten als Notfall komplett Doku. Oder ausgwählte Artikel als PDF, o.ä. extrahieren und verwenden.

mfg Crusher
erikro
erikro 31.07.2023 um 14:30:11 Uhr
Goto Top
Moin,

Zitat von @MrHeisenberg:

Zitat von @erikro:

Moin,

Docusnap dokumentiert alles automatisch, was automatisch dokumentiert werden kann. Einiges wird dort händisch nachgetragen bzw. halbautomatisch importiert (z. B. mobile devices).


Die Dokumentation der Geräte passiert händisch durch unser AssetMGM (SnipeIT), da so oder so alle Geräte durch unsere Hände gehen.

Das ist der Teil "halbautomatisch". Wir nutzen für die mobile devices (Tablets, Smartphones) auch ein MDM. Aus dem exportieren wir die Informationen und importieren sie in Docusnap. Single Point of Information. Das hat unter anderem den Vorteil, dass ich so jederzeit sagen kann, wer welche Geräte hat, ohne auf verschiedene Quellen zugreifen zu müssen.

Hast du bei MediaWiki die LDAP-Erweiterung verwendet?

Ja. War ein wenig Gefrickel, bis das endlich lief, und ich brauchte auch Unterstützung hier aus dem Forum. Aber es ist auch nicht wirklich Hexenwerk. Wenn man einmal begriffen hat, wie man die AD-Gruppen mappen und dann die Wiki-Gruppen nutzen muss, funktioniert das gut.

Liebe Grüße

Erik
canlot
canlot 01.08.2023 um 09:52:37 Uhr
Goto Top
Moin,

es gibt durchaus gute Wiki Systeme mit viel Schickschnack, z.B.
Bookstack oder Wiki.js

Ehrenamtlich nutze ich Bookstack, das ist ganz gut, man kann auch mit opendiagrams Integration Diagramme zeichnen.

Auf der Arbeit haben wir Confluence das ist auch gut aber auch teuer.

Gruß