Voor een Beheerder, is de belangrijkste bekwaamheid het kunnen omgaan met iedere situatie, bekend of onbekend. Dit hoofdstuk geeft een aantal methoden die je — hopelijk — in staat stellen om de oorzaak van ieder probleem dat je tegenkomt te isoleren, zodat je de mogelijkheid hebt om het op te lossen.
7.1. Documentatie Bronnen
Voor je kunt begrijpen wat er echt gebeurt wanneer er een probleem is, moet je de theoretische rol gespeeld door ieder programma betrokken bij het probleem begrijpen. Om dit te doen, de beste reflex is het raadplegen van hun documentatie; maar omdat er veel van deze documentaties zijn en ver verspreid, zou je al de plaatsen waar ze gevonden kunnen worden kennen.
7.1.1. Handleiding Pagina's
Handleiding pagina's, hoewel ze relatief kort zijn, bevatten een groot aantal essentiële informatie. We zullen snel over het commando om ze te lezen gaan. Simpelweg
man handleiding-pagina
— de handleiding pagina heeft dezelfde naam als het commando wiens documentatie je zoekt. Bij voorbeeld, om meer te weten over de mogelijke opties voor het
cp
commando, zal je het
man cp
commando in de shell prompt weergeven (zie marge
TERUG NAAR DE BASIS De shell, een commando regel vertolker).
Handleiding pagina's beschrijven niet enkel programma's beschikbaar via de commando-regel, maar ook configuratiebestanden, systeem aanroepen, C bibliotheek functies enz. Soms kunnen namen conflicteren. Bij voorbeeld het read
commando van de shell heeft dezelfde naam als de read
systeem aanroep. Dit is waarom handleiding pagina's zijn georganiseerd is genummerde secties:
commando's die uitgevoerd kunnen worden vanaf de commando-regel;
systeem aanroepen (functies aangeboden door de kernel);
bibliotheek functies (aangeboden door systeem bibliotheken);
apparaten (op Unix-achtige systemen, zijn dit speciale bestanden, meestal geplaatst in de /dev/
directory);
Configuratie bestanden (opmaak en conventies);
spelletjes;
sets van macro's en standaarden;
systeembeheer commando's;
kernel routines.
Het is mogelijk om de sectie van de handleiding pagina's waar je naar zoekt te specificeren: om de documentatie voor de read
systeem aanroep te zien, zou je man 2 read
typen. Wanneer er geen sectie expliciet wordt aangegeven, zal de eerste sectie van de gekozen handleiding pagina weergegeven worden. Dus man shadow
geeft shadow(5) weer want er zijn geen handleiding pagina's voor shadow in secties 1 t.e.m. 4.
Natuurlijk, als je de namen van de commando's niet weet, zal de handleiding niet veel nut hebben voor je. Dit is het doel van het apropos
commando, welke helpt zoeken in de handleiding pagina's, of meer specifiek in hun korte beschrijving. Ieder handleiding pagina begint essentieel met een enkele regel samenvatting. apropos
geeft een lijst van handleiding pagina's waarvan de samenvatting een gevraagd sleutelwoord(en) bevat weer. Als je ze goed kiest, zul je het naam van het commando dat je zoekt vinden.
Voorbeeld 7.1. cp
vinden met apropos
$
apropos "copy file"
cp (1) - copy files and directories
cpio (1) - copy files to and from archives
gvfs-copy (1) - Copy files
gvfs-move (1) - Copy files
hcopy (1) - copy files from or to an HFS volume
install (1) - copy files and set attributes
ntfscp (8) - copy file to an NTFS volume.
Het
man
commando is niet de enige manier om de handleiding pagina's te consulteren, omdat
konqueror
in (KDE) en
yelp
(onder GNOME) ook deze mogelijkheid bieden. Er is ook een web interface, geleverd door het
man2html
pakket, welke je toelaat om de handleiding pagina's te tonen in een internet browser. Op een computer waarop dit pakket geïnstalleerd is gebruik je dit URL:
Deze toepassing vereist een web server. Dit is waarom je ervoor zou moeten kiezen om dit pakket op een van jouw servers te installeren: alle gebruikers op het lokale netwerk kunnen genieten van deze service (inclusief niet-Linux machines), en dit zal zorgen dat je geen HTTP server moet installeren op ieder werkstation.
Het GNU project heeft voor de meeste van zijn programma's handleidingen geschreven in het info formaat; dit is waarom veen handleiding pagina's verwijzen naar de corresponderende info documentatie. Dit formaat biedt enkele voordelen, maar het standaard programma om deze documenten te bekijken (is heet info
) is ook iets complexer. Je wordt geadviseerd om pinfo
(van het pinfo pakket) in de plaats te gebruiken.
De info documentatie heeft een hiërarchische structuur, en als je pinfo
aanroept zonder parameters, zal het een lijst van al de knooppunten in het eerste niveau weergeven. Meestal hebben de knooppunten de naam van het corresponderende commando.
Met
pinfo
is het navigeren tussen deze knooppunten gemakkelijk met de pijl toetsen. Alternatief kun je ook een grafische browser, welke veen gebruiksvriendelijker is, gebruiken. Opnieuw,
konqueror
en
yelp
werken; het
info2www
biedt ook een web interface.
Merk op dat het info systeem niet geschikt is voor vertaling, in tegenstelling tot het man
pagina systeem. info zijn dus bijna altijd in het Engels. Hoewel, als je het pinfo
programma vraagt om een niet bestaande info pagine weer te geven, zal het terugvallen op de man pagina met dezelfde naam (indien het bestaat), wat vertaald kan zijn.
7.1.3. Specifieke Documentatie
Ieder pakket bevat zijn eigen documentatie. Zelf het minst gedocumenteerde programma heeft in het algemeen een README
bestand dat wat interessante en/of belangrijke informatie bevat. Deze documentatie wordt geïnstalleerd in de /usr/share/docpakket/
directory (waar pakket de naam van het pakket vertegenwoordigd). Als de documentatie groot is, zit het mogelijk niet bij de hoofd pakket van het programma, maar het kan afgeladen zijn naar een toegewijd pakket, wat meestal pakket-doc
genoemd wordt. Het hoofd pakket beveelt in het algemeen het documentatie pakket aan zodat je het gemakkelijk kunt vinden.
De /usr/share/doc/pakket/
directory bevat ook enkele bestanden aangeboden door Debian welke de documentatie vervolledigen door de eigenaardigheden of verbeteringen in pakketten vergeleken met een traditionele installatie van de software te specificeren. Het README.Debian
bestand geeft ook al de aanpassingen aan die gemaakt zijn om te voldoen aan het Debian Beleid. Het changelog.Debian.gz
bestand laat de gebruiker toe om de gemaakte aanpassingen aan het programma gedurende de tijd te volgen: het is zeer handig bij het proberen begrijpen wat er veranderd is tussen twee geïnstalleerde versies die niet hetzelfde gedrag hebben. Tenslotte, is er soms een NEWS.Debian.gz
bestand, welke documentatie over de grote aanpassingen in het programma bevat die de beheerders rechtstreeks aangaan.
In de meeste gevallen, hebben vrije software programma's websites die gebruikt worden om het te verdelen en om de gemeenschap van gebruikers en ontwikkelaars samen te brengen. Deze sites zijn vaak voorzien van relevante informatie in verschillende formaten: officiële documentatie, FAQ (Vaak Gestelde Vragen), e-mail lijst archieven, enz. Problemen die je kunt tegenkomen kunnen vaak al het onderwerk van vele vragen geweest zijn; de FAQ of e-mail lijst archieven kunnen er een oplossing voor hebben. Een goede beheersing van zoekmachines zal zeer handig blijken om relevante pagina's snel te vinden (door het zoeken te beperken tot het Internet domein of sub-domein toegewijd aan het programma). Indien het zoeken te veel pagina's weergeeft of de resultaten niet overeen komen met wat je zoekt, kun je het sleutelwoord debian
toevoegen om de resultaten te beperken en te richten op relevante informatie.
Als je het adres van de website van de software niet kent, zijn er verschillende manieren om er aan te komen. Ten eerste, controleer of er een
Homepage
veld is in de meta-informatie van het pakket (
apt-cache show pakket
). Alternatief, kan de pakket beschrijving een link naar de officiële website van het pakket bevatten. Als er geen URL is weergegeven, kijk naar
/usr/share/doc/pakket/copyright
. De Debian onderhouder geeft in het algemeen in dit bestand aan waar ze de bron-code van de software hebben gevonden, en het is waarschijnlijk dat dit de website is die je zoekt. Als jouw zoektocht op dit punt nog steeds geen vruchten heeft afgeworpen, consulteer een vrije software adresboek, zoals de FSF's Free Software Directory of een rechtstreekse zoekopdracht met een zoekmachine, zoals Google, DuckDuckGo, Yahoo, enz.
Je wilt misschien ook kijken in de Debian wiki, een collaboratieve website waar iedereen, zelf simpele bezoekers, suggesties kunnen doen rechtstreeks vanuit hun browser. Het wordt zowel gebruikt door ontwikkelaars die hun projecten verduidelijken en door gebruikers die hun kennis delen door collaboratief documenten te schrijven.
Een howto is een document dat concreet een stap voor stap uitleggen hoe (“how to”) je een bepaald doel kunt bereiken. De doelen zijn redelijk gevarieerd, maar vaak technisch van aard: bijvoorbeeld, IP Masquerading opzetten, software RAID configureren, een Samba server installeren, enz. Deze documenten proberen vaak al de mogelijke problemen te omvatten die waarschijnlijk voorkomen tijdens de implementatie van een gegeven technologie.
Veel van deze tutorials worden beheerd door het Linux Documentatie Project (LDP), wiens website al deze documenten herbergt:
Deze documenten zouden met een korreltje zout genomen moeten worden. Ze zijn vaak enkele jaren oud; de informatie die ze bevatten is soms verouderd. Dit fenomeen is zelfs frequenter voor hun vertalingen, omdat updates systematisch noch onmiddellijk na de publicatie van een nieuwe versie van het originele document zijn. Dit is onderdeel van de vreugden van het werken in een vrijwilliger omgeving zonder beperkingen…