1.2. Documentare ogni cosa

Se vi viene data la possibilità di installare un server nuovo o scrivere un documento sulle procedure su come eseguire i backup del sistema, l'amministratore di sistema medio sceglierà sempre di installare un server nuovo. È fortemente consigliato di documentare sempre quello che fate. Molti amministratori non documentano quello che fanno a causa di svariati motivi:

"Lo farò più tardi."

Sfortunatamente, questo non accade quasi mai. Infatti la natura dei compiti che un amministratore deve affrontare, è così caotica che in molti casi è impossibile "rinviare". Anccora peggio, più si aspetta, e più facilmente si dimentica, creando così una documentazione non molto dettagliata (e quindi quasi inutile).

"Perchè scrivere tutto? È più semplice ricordare."

A meno che non siate uno di quei pochissimi individui con una memoria fotografica, non sarete in grado di ricordare tutto. O peggio ancora, ne ricorderete solo la metà, senza sapere di aver perso l'intera storia. Ciò ne scaturisce una perdita di tempo nel cercare di ricordare quello che avete dimenticato o di correggere quello che avete scritto.

"Se lo terrò nella mia mente, non possono licenziarmi — sicurezza del posto di lavoro!"

Anche se questa tattica potrà essere valida per un pò di tempo — essa non risulta — essere molto sicura. Cercate di pensare per un momento cosa possa succedere durante una emergenza. Voi potreste non essere reperibili; la vostra documentazione potrebbe risultare importante permettendo ad un'altra persona di risolvere il problema durante la vostra assenza. In questi casi, è meglio avere la vostra documentazione in modo da risolvere il problema, che notare la vostra assenza e annoverarla come una delle cause del problema.

In aggiunta, se fate parte di una piccola organizzazione in continua crescita, sarà possibile che la stessa abbia bisogno di un nuovo amministratore. Come potete aspettarvi che questo nuovo amministratore possa sostituirvi se mantenete tutte le informazioni nella vostra testa? Ancora peggio, se non documentate niente, potrà essere richiesta sempre la vostra presenza, 'sareste indispensabili', in modo da intaccare la vostra carriera e quindi le vostre promozioni a compiti dirigenziali. Potreste trovarvi a svolgere il lavoro della persona assunta per assistervi nel vostro incarico.

Si spera che adesso abbiate capito l'importanza di una documentazione. Ciò ci porta a formulare un'altra domanda: Cosa documentare? Ecco un breve elenco:

Policy

Le policy vengono scritte per ufficializzare e chiarire la relazione che intercorre tra voi e la community dei vostri utenti. Esse chiariscono ai vostri utenti come le richieste sulle risorse vengano assistite e gestite. La natura, lo stile, ed il metodo di diffusione delle policy per la vostra community varia da organizzazione a organizzazione.

Procedure

Le procedure non sono altro che una sequenza di azioni passo dopo passo da intraprendere per poter completare un compito. Le procedure da documentare possono includere le procedure di backup, quelle di gestione dello user account, inerenti le problematiche nel riporto delle procedure, e così via. Come l'automazione, se una procedura viene seguita più di una volta, è consigliabile documentarla.

Modifiche

Gran parte della carriera di un amministratore di sistema ruota intorno alle modifiche — alla configurazione dei sistemi per massimizzarne le prestazioni, alle modifiche dei file di configurazione, agli script e così via. Tutte queste modifiche devono essere documentate in qualche modo. In caso contrario, potreste trovarvi spiazzati a causa di una modifica eseguita in passato.

Alcune organizzazioni utilizzano metodi più complessi per registrare le suddette modifiche, ma in molti casi potrebbe essere solo necessario una semplice nota all'inizio del file modificato. Come minimo, ogni entry presente nella cronologia dovrebbe contenere:

  • Il nome o le iniziali della persona che ha eseguito la modifica

  • La data nella quale è stata eseguita la modifica

  • La ragione per la quale è stata apportata la modifica

Il risultato, e le entry più utili:

ECB, 12-Giugno-2002 — Entry aggiornata per nuove stampanti di contabilità (per supportare l'abilità di stampa duplex della stampante)