When you want to configure an unknown package, you must proceed in stages. First, you should read what the package maintainer has documented. Reading /usr/share/doc/package/README.Debian will allow you to learn of specific provisions made to simplify the use of the software. It is sometimes essential in order to understand the differences from the original behavior of the program, as described in the general documentation, such as howtos. Sometimes this file also details the most common errors in order for you to avoid wasting time on common problems.

Dan zou je moeten kijken naar de officiële documentatie van de software — raadpleeg Paragraaf 7.1, “Documentatie Bronnen” om de verschillende bestaande documentatiebronnen te vinden. Het dpkg -L pakket commando geeft een lijst van bestanden inbegrepen in het pakket; je zou daarom de beschikbare documentatie snel moeten kunnen identificeren (net zoals de configuratiebestanden, geplaatst in /etc/). dpkg -s pakket toont de meta-gegevens van het pakket en toont enige mogelijke aanbevolen of gesuggereerde pakketten, hierin kun je documentatie vinden of een gereedschap dat de configuratie van de software zal vergemakkelijken.

Tenslotte, de configuratiebestanden zijn vaak zelf-gedocumenteerd door vele verklarende commentaren die de mogelijke waarden voor iedere configuratie instelling verklaren. Zo veel dat het soms genoeg is om een regel te kiezen die geactiveerd moet worden tussen de beschikbare regels. In sommige gevallen, worden voorbeelden van configuratiebestanden aangeboden in de /usr/share/doc/pakketexamples/ directory. Deze kunnen dienst doen als een basis voor jouw eigen configuratie bestand.

Begrijpen wat een daemon doet is iets gecompliceerder, omdat het geen rechtstreekse interactie heeft met de beheerder. Om te controleren of een daemon echt werkt, moet je dit testen. Bijvoorbeeld, om de Apache (web server) daemon te testen, test je het met een HTTP aanvraag.

Om deze test mogelijk te maken, houdt ieder daemon normaal gezien alles wat hij doet bij, net zoals ieder fout die hij tegenkomt, in wat we “log bestanden” of “systeem logs” noemen. Logs worden opgeslagen in /var/log/ of in één van de sub-directory's. Om de precieze naam van een logbestand voor iedere daemon te weten, kijk je in zijn documentatie. Notitie: een enkele test is niet altijd voldoende als het niet al de mogelijke gebruiksmogelijkheden beslaat; sommige problemen komen enkel voor onder bepaalde omstandigheden.

As a preventive operation, the administrator should regularly read the most relevant server logs. They can thus diagnose problems before they are even reported by disgruntled users. Indeed users may sometimes wait for a problem to occur repeatedly over several days before reporting it. In many cases, there are specific tools to analyze the contents of the larger log files. In particular, such utilities exist for web servers (such as analog, awstats, awffull for Apache), FTP servers, proxy/cache servers, firewalls, e-mail servers, DNS servers, and even for print servers. Other tools, such as logcheck (a software discussed in Hoofdstuk 14, Beveiliging), scan these files in search of alerts to be dealt with.

If your various searches haven't helped you to get to the root of a problem, it is possible to get help from other, perhaps more experienced people. This is exactly the purpose of the debian-user@lists.debian.org mailing list and its language specific siblings debian-user-lang@lists.debian.org. As with any community, it has rules that need to be followed. Before asking any question, you should check that your problem isn't already covered by recent discussions on the list or by any official documentation.

Once those two conditions are met, you can think of describing your problem to the mailing list. Include as much relevant information as possible: various tests conducted, documentation consulted, how you attempted to diagnose the problem, the packages concerned or those that may be involved, etc. Check the Debian Bug Tracking System (BTS, described in sidebar Paragraaf 1.3.2.1, “Bugs rapporteren”) for similar problems, and mention the results of that search, providing links to bugs found. BTS starts on:

Hoe vriendelijker en nauwkeuriger je bent, des te meer kans dat je een antwoord krijgt, of tenminste, een gedeeltelijke reactie. Als je relevante informatie krijgt via e-mail, probeer dit dan publiek samen te vatten zodat ook andere hiervan kunnen genieten. Dit laat het archief van de e-mail lijst, door verschillende zoekmotoren doorzocht, toe om de oplossing te tonen aan anderen die misschien dezelfde vraag hebben.

Als je met al jouw moeite om een probleem op te lossen, hier niet in slaagt, is het mogelijk dat een oplossing niet jouw verantwoordelijkheid is. En dat het probleem te wijten is aan een fout in het programma. In dit geval is de correcte procedure het rechtstreeks rapporteren van de fout aan Debian of de upstream ontwikkelaar. Om dit te doen, isoleer je het probleem zo veel mogelijk en maak je een minimale test situatie waarin het gereproduceerd kan worden. Als je weet welk programma de waarschijnlijke oorzaak is van het probleem, kun zijn corresponderende pakketten vinden met het commando dpkg -S betrokken_bestand. Volg het Foutopvolgingssysteem (https://bugs.debian.org/paket) om er zeker van te zijn dat de fout niet eerder gerapporteerd is. Je kunt dan jouw fout rapport sturen met het reportbug commando, inclusief zo veel mogelijk informatie, vooral een volledige beschrijving van de minimale tests die het toelaten de fout te recreëren.

De elementen in dit hoofdstuk zijn methoden om efficiënt problemen die in de volgende hoofdstukken kunnen voorkomen op te lossen. Gebruik ze zo veel als nodig!