Dokumentacija IT okolja: kaj mora biti zapisano in zakaj

Dokumentacija IT okolja je prva stvar, ki manjka, ko se zgodi incident ali ko odide ključni sodelavec. Ni si treba zamišljati obsežnih priročnikov — pomembnejše je, da je kratka, točna in dostopna tudi takrat, ko sistemi ne delujejo.

TL;DR — Ključni poudarki

• Minimum: shema omrežja, seznam sistemov, dostopi, backup in kontakti.
• Dokumentacija mora biti dostopna tudi brez delujočega omrežja.
• Vsak sistem potrebuje kratek runbook, ne priročnika.
• Posodobitev je del vsake spremembe, ne ločen projekt.

Kaj mora vsebovati

Osnovni sklop je popis: kateri strežniki in storitve obstajajo, kje tečejo, kdo je lastnik in kaj se zgodi, če odpovejo. Sledijo omrežna shema z naslovnim načrtom, seznam dostopov in pravic ter opis varnostnih kopij z roki hrambe in postopkom obnove.

Nato pridejo runbooki za ponavljajoča se opravila: dodajanje novega zaposlenega, odhod zaposlenega, obnova datoteke, ponastavitev MFA, ravnanje ob izpadu internetne povezave. Vsak naj bo dolg eno stran.

Zakaj se dokumentacija izplača

Njena vrednost se pokaže v najslabšem možnem trenutku.

• Ob incidentu se čas do rešitve skrajša z ur na minute.
• Ob menjavi IT partnerja prevzem poteka brez ugibanja.
• Ob bolniški odsotnosti ključne osebe delo ne obstane.
• Revizije in zavarovalnice dokumentacijo izrecno zahtevajo.

Kako se lotiti — priporočen postopek

1. Začnite s popisom sistemov in lastnikov — brez tehničnih podrobnosti.
2. Dodajte omrežno shemo in naslovni načrt.
3. Zapišite postopek backupa in obnove ter datum zadnjega testa.
4. Pripravite pet najpogostejših runbookov.
5. Shranite kopijo izven omrežja (natisnjeno ali v ločenem trezorju).
6. Ob vsaki spremembi posodobite zapis; enkrat letno naredite pregled.

Minimalni obseg dokumentacije

Najpogostejše napake

Najpogostejša napaka je dokumentacija, shranjena izključno v sistemu, ki ob incidentu ni dosegljiv. Kopija mora obstajati tudi izven okolja, ki ga opisuje.

Druga napaka je preobsežnost. Dokument, ki ga nihče ne posodablja, je slabši od kratkega, ki je točen.

Kako pri VitalIT pomagamo

V VitalIT dokumentacijo pripravimo in vzdržujemo kot del IT podpore in vzdrževanja. Poglejte tudi IT svetovanje.

Sorodno: Letni IT audit in Kako izbrati IT partnerja.

Pogosta vprašanja (FAQ)

Kdo naj vzdržuje dokumentacijo?

Tisti, ki izvaja spremembe — z obveznostjo, zapisano v postopku sprememb.

Kje jo hraniti?

V sistemu z nadzorom dostopa in različicami ter s kopijo izven okolja.

Ali naj vsebuje gesla?

Ne. Gesla sodijo v upravitelja gesel; dokumentacija naj vsebuje le sklic nanj.

Koliko časa vzame priprava?

Za tipično MSP okolje od enega do dveh tednov za osnovni obseg.

Ali jo dobimo ob prekinitvi sodelovanja?

Pri nas da — celotna dokumentacija je vaša in jo prejmete ob zaključku.