Systeembeheer documentatie

Als beheerders ergens een broertje aan dood hebben, is het wel aan het schrijven en bijhouden van documentatie. De ervaring leert dat documentatie na de (verplichte) oplevering zelden wordt bijgehouden.

Dit komt meestal door twee redenen:

  • De beheerders zien het nut van de documentatie niet in, want ze hebben er weinig profijt van;
  • De documentatie is lastig aan te passen en het is ondankbaar werk.

Het is daarom zaak aan beide aspecten aandacht te besteden. Documentatie is voor beheerders handig als ze snel de informatie kunnen vinden die ze zoeken.

Zoeken

Een mooi voorbeeld is Google. In Google kun je een antwoord op een technische vraag meestal binnen 30 seconden vinden, door het ingeven van goede steekwoorden. Het opzoeken van informatie in documentatie op een netwerkschijf, met een meestal moeilijk te doorgronden directory tree, duurt veel langer. Dit frustreert gebruikers, zodat men het wiel liever opnieuw uitvindt dan dat men de documentatie raadpleegt.

Het aanpassen van documentatie begint ook met het zoeken naar de documentatie. Zoals hierboven beschreven, is dit de eerste hinderpaal. Bovendien is na het aanpassen van documentatie niet duidelijk wat er nu precies is veranderd en wie dat heeft gedaan. Om deze redenen wordt documentatie meestal helemaal niet bijgewerkt.

Wiki's

Moderne technieken kunnen deze problemen voor een groot deel oplossen. Het gebruik van Wiki’s met een zoekfunctie bijvoorbeeld, lost bovenstaande problemen op. Het succes van wiki’s is het best af te lezen aan de vrije tijd die vele mensen steken aan het vrijwillig documenteren op http://www.wikipedia.org

Murdoc

Ook mijn open source project Murdoc is een handig systeem om documentatie bereikbaar te maken. Het is zelfs mogelijk om systemen zichzelf automatisch dagelijks te laten documenteren.

Murdoc bevat ook een standaard directory indeling waarmee systeembeheer documenten kunnen worden gerangschikt.


This entry was posted on Maandag 16 Oktober 2006

Earlier articles

My Book

DevOps for infrastructure

Infrastructure as a Service (IaaS)

(Hyper) Converged Infrastructure

Object storage

Software Defined Networking (SDN) and Network Function Virtualization (NFV)

Software Defined Storage (SDS)

What's the point of using Docker containers?

Identity and Access Management

Using user profiles to determine infrastructure load

Public wireless networks

Supercomputer architecture

Desktop virtualization

Stakeholder management

x86 platform architecture

Midrange systems architecture

Mainframe Architecture

Software Defined Data Center - SDDC

The Virtualization Model

What are concurrent users?

Performance and availability monitoring in levels

UX/UI has no business rules

Technical debt: a time related issue

Solution shaping workshops

Architecture life cycle

Project managers and architects

Using ArchiMate for describing infrastructures

Kruchten’s 4+1 views for solution architecture

The SEI stack of solution architecture frameworks

TOGAF and infrastructure architecture

The Zachman framework

An introduction to architecture frameworks

How to handle a Distributed Denial of Service (DDoS) attack

Architecture Principles

Views and viewpoints explained

Stakeholders and their concerns

Skills of a solution architect architect

Solution architects versus enterprise architects

Definition of IT Architecture

What is Big Data?

How to make your IT "Greener"

What is Cloud computing and IaaS?

Purchasing of IT infrastructure technologies and services

IDS/IPS systems

IP Protocol (IPv4) classes and subnets

Introduction to Bring Your Own Device (BYOD)

IT Infrastructure Architecture model

Fire prevention in the datacenter

Where to build your datacenter

Availability - Fall-back, hot site, warm site

Reliabilty of infrastructure components

Human factors in availability of systems

Business Continuity Management (BCM) and Disaster Recovery Plan (DRP)

Performance - Design for use

Performance concepts - Load balancing

Performance concepts - Scaling

Performance concept - Caching

Perceived performance

Ethical hacking

Computer crime

Introduction to Cryptography

Introduction to Risk management

The history of UNIX and Linux

The history of Microsoft Windows

Engelse woorden in het Nederlands

Infosecurity beurs 2010

The history of Storage

The history of Networking

The first computers

Cloud: waar staat mijn data?

Tips voor het behalen van uw ITAC / Open CA certificaat

Ervaringen met het bestuderen van TOGAF

De beveiliging van uw data in de cloud

Proof of concept

Een consistente back-up? Nergens voor nodig.

Measuring Enterprise Architecture Maturity

The Long Tail

Open group ITAC /Open CA Certification

Human factors in security

Google outage

SAS 70

De Mythe van de Man-Maand

TOGAF 9 - wat is veranderd?

DYA: Ontwikkelen Zonder architectuur

Landelijk Architectuur Congres LAC 2008

InfoSecurity beurs 2008

Spam is big business

Waarom IT projecten mislukken

Stroom en koeling

Laat beheerders meedraaien in projecten

De zeven eigenschappen van effectief leiderschap

Archimate

Een ontmoeting met John Zachman

Open CA (voorheen: ITAC) - IT Architect certification

Persoonlijk Informatie Eigendom

Webcast

Live computable webcast

Lezing Trends in IT Security

Hardeningscontrole en hacktesting

Kennismanagement

Information Lifecycle Management - Wat is ILM

LEAP: de trip naar Redmond

LEAP: De laatste Nederlandse masterclasses

Scada systemen

LEAP - Halverwege de Nederlandse masterclasses

Beveiliging van data - Het kasteel en de tank

Waarom je geen ICT architect moet worden

Non-functional requirements

Redenen om te backuppen

Log analyse - gebruik logging informatie

LEAP - Microsoft Lead Enterprise Architect Program

Archivering data - more than backup

Patterns in IT architectuur

Tot de dood ons scheidt

High Availability clusters

Hoe geef ik een goede presentatie

Lagen in ICT Beveiliging

Zachman architectuur model

High performance clusters en grids

Redenen om te kiezen voor Open Source software

Monitoring door systeembeheerders

Wat is VMS?

IT Architectuur certificeringen

Storage Area Network's (SAN's)

Systeembeheer documentatie

Wat zijn Rootkits

Virtualisatie van operating systems

Kenmerken van Open Source software

Linux certificering: RHCE en LPI

99,999% beschikbaarheid

Het infrastructuur model

Sjaak Laan


Recommended links

Genootschap voor Informatie Architecten
Ruth Malan
Informatiekundig bekeken
Gaudi site
Byelex
XR Magazine
Esther Barthel's site on virtualization


Feeds

 
XML: RSS Feed 
XML: Atom Feed 


Disclaimer

The postings on this site are my opinions and do not necessarily represent CGI’s strategies, views or opinions.

 

Copyright Sjaak Laan