Onderwerp: Documentatie?

Documenteert de WHT'er eigenlijk? Zo ja.. wat documenteer je eigenlijk? en op welke diepte?

* Ik wou dus eigenlijk een poll maken, maar de optie zie ik niet staan ofzo :P

Misschien handig om even te vermelden wat voor soort documentatie je bedoelt?

Ja, server opzet.... (installatie) met IP nummers per server.

hardware -> configuratie
code -> voldoende comments in de code om het over een half jaar nog te begrijpen

Tuurlijk documenteer ik dat...

Wij gebruiken voor elke server een randompassword, deze staat op pc van elke werknemer en op de webserver en veranderd elke maand.

Voorbeeldje van wat we documenten, licenties noem maar op. Van alles eigenlijk.

Oorspronkelijk geplaatst door JayvD

Wij gebruiken voor elke server een randompassword, deze staat op pc van elke werknemer en op de webserver en veranderd elke maand.

Op het moment dat je passwords nodig hebt op je webserver zou ik toch eens naar keys e.d. gaan kijken, kan wat gezeik schelen

Wij documenteren onze zooi op dit moment in een Wiki. Hierin worden de gegevens van de servers bijgehouden (hardwareconfig, softwareconfig, mac adressen, garantie e.d.), de ip ranges, switch poorten verdeling, pdu poorten verdeling e.d. Ook houd ik er een logboek bij over welke softwareaanpassingen er gedaan zijn.
Het één en ander zal tzt in een aparte DB komen, maar vooralsnog voldoet dit.

Niet veel, als het aan mij ligt: veel.

ip adressen etc en vlan's staan allemaal in een control systeem wachtwoorden staan in een wachtwoorden database.

Alle dedicated servers zijn voor buitenaf afgesloten voor ssh wachtwoorden zijn 11 chars lang. Op deze servers staan ook ssh key's zodat ik en Randy in ieder geval niet iedere keer wachtwoorden moet intypen.

De masterkey wisselt iedere maand hiervoor hebben we gewoon een script.
Met gebruik van ssh keys kun je nog meer leuke dingen doen

Oorspronkelijk geplaatst door MikeN

Op het moment dat je passwords nodig hebt op je webserver zou ik toch eens naar keys e.d. gaan kijken, kan wat gezeik schelen

Gebruiken we ook maar noemde enkel een voorbeeld voor root wachtwoorden en dat soort gedoe.

Zeer zeker, dat is 1 van de dingen die eigenlijk bij geen enkel hoster mag ontbreken. Documentatie is vrijwel net zo belangrijk als backups voor mij. Als je documentatie bijhoudt weet je precies wat je bij de installatie / update hebt uitgevoerd voor commands en weet je ook precies wat je moet doen om het ongedaan te maken.
Als je nog zelf niet zo ervaren bent en je moet voor de tweede of derde keer pas een server installeren (of na een crash/format) en de server moet binnen enkele uren weer precies goed draaien dan is een dergelijke documentatie ook reuze handig. Geen problemen uitzoeken waar je eerder al tegenaan bent gelopen, de oplossing staat gewoon in je documentatie

Erg handig dus! Ip-adressen, config opties, commands. Als je daarnaast ook nog dagelijks een backup maakt van je /etc/ map met alle configs erin en van de dns, mysql en mail (/var/) kan er al bijna niets meer misgaan.

Wij documenteren, ongeveer alles.

Gesprekken met klanten
Procedures over het afhandelen van klachten / storingen
Procedures over het afhandelen van bestellingen / factureren, enz.

Ook alle wachtwoorden, ip adressen en de daarbij behorende loginnamen
Welke poorten er op onze switches in gebruik zijn.

Ik zeg zelf altijd maar hoe meer je documenteerd hoe meer je weet !

Ik zie dat MikeN een wiki gebruikt om de documentatie in op te slaan.
Ik heb zelf alles op ons intranet staan, met een pagina per server/router en gebruik de comments als logboek.

Wat gebruiken de anderen? Is er iemand die de serverdocumentatie (gedeeltelijk) automatisch verkrijgt?

Wij gebruiken een CRM

Wiki

in dit bedrijf hier (stage) documenteren ze alles wat gedocumenteerd kan worden. En ook nog allemaal volgens ISO normen etc.

Hier een hele kast over de servers/pc's etc.
en het zijn er in totaal maar 30.