Product SiteDocumentation Site

Kapittel 7. Problemløsning og oppsporing av relevant informasjon

7.1. Dokumentasjonskilder
7.1.1. Manualsider
7.1.2. info-dokumenter
7.1.3. Spesifikk dokumentasjon
7.1.4. Websider
7.1.5. Veiledninger (HOWTO)
7.2. Vanlige prosedyrer
7.2.1. Oppsett av et program
7.2.2. Å følge med i hva bakgrunnsprosessne gjør
7.2.3. Be om hjelp på en e-postliste
7.2.4. Rapportere en feil når problemet er for vanskelig
For en administrator er den viktigste ferdigheten å kunne takle enhver situasjon, kjent eller ukjent. Dette kapitlet gir en rekke metoder som — forhåpentligvis — vil gjøre det mulig å isolere årsaken til eventuelle problemer du møter på, slik at du kan være i stand til å løse dem.

7.1. Dokumentasjonskilder

Før du kan forstå hva som egentlig skjer når det er et problem, må du vite den teoretiske rolle for hvert program som er involvert i problemet. For å gjøre dette er den beste refleksen å konsultere programmenes dokumentasjon; men siden det er mye dokumentasjon som kan være spredt vidt og bredt, bør du vite alle stedene der den kan finnes.

7.1.1. Manualsider

Manual pages, while relatively terse in style, contain a great deal of essential information. We will quickly go over the command for viewing them, provided by the man-db package. Simply type man manual-page — the manual page usually goes by the same name as the command whose documentation is sought. For example, to learn about the possible options for the cp command, you would type the man cp command at the shell prompt (see sidebar DET GRUNNLEGGENDE Skallet, en kommandolinjetolk).
Man pages not only document commands and programs accessible from the command line, but also configuration files, system calls, library functions, and so forth. Sometimes names can collide. For example, the shell's read command has the same name as the read system call. This is why manual pages are organized in numbered sections:
1
kommandoer som kan utføres fra kommandolinjen;
2
systemkall (funksjoner som tilbys av kjernen);
3
biblioteksfunksjoner (tilbys av systemets biblioteker);
4
enheter (på Unix-lignende systemer, disse er spesialfiler, vanligvis plassert i /dev/-katalogen);
5
oppsettsfiler (formater og konvensjoner);
6
spill;
7
sett med makroer og standarder;
8
kommandoer for systemadministrasjon;
9
kjernerutiner.
Det er mulig å spesifisere hvilken seksjon manualsiden du er ute etter befinner seg i: For å vise dokumentasjonen for read-systemkallet må du skrive man 2 read. Når ingen seksjon er uttrykkelig angitt, vil den første seksjonen som har en manualside med det riktige navnet bli vist. Dermed viser man shadow frem shadow(5) fordi det ikke er noen manualside for shadow i seksjonene 1 til og med 4.
Hvis du ikke vet navnene på kommandoene, kommer selvfølgelig ikke manualen til å være til stor nytte for deg. Dette er hensikten med apropos-kommandoen, som hjelper deg å utføre et søk i manualsidene, eller mer spesifikt i de korte beskrivelsene. Hver manualside begynner egentlig med en linjes sammendrag.apropos returnerer en liste med manualsider der oppsummeringen har med de forespurte søkeord(ene). Med gode valg av søkeord, vil du finne navnet på kommandoen du trenger.

Eksempel 7.1. Finne cp med apropos

$ apropos "copy file"
cp (1)               - copy files and directories
cpio (1)             - copy files to and from archives
hpcopy (1)           - copy files from an HFS+ volume
install (1)          - copy files and set attributes
ntfscp (8)           - copy file to an NTFS volume.
The man command is not the only means of consulting the manual pages, since khelpcenter and konqueror (by KDE) and yelp (under GNOME) programs also offer this possibility. There is also a web interface, provided by the man2html package, which allows you to view manual pages in a web browser. On a computer where this package is installed, use this URL after following the instructions in /usr/share/doc/man2html/README.Debian:
Dette verktøyet krever en vevtjener. Dette er årsaken til at du bør velge å installere denne pakken på en av tjenermaskinene dine: Alle brukere av det lokale nettverket kan ha nytte av denne tjenesten (inkludert ikke-Linux-maskiner), og dette vil tillate deg å unngå å sette opp en HTTP-tjener på hver arbeidsstasjon. Hvis tjenermaskinen også er tilgjengelig fra andre nettverk, kan det være ønskelig å begrense tilgangen til denne tjenesten til brukere i det lokale nettverket.
Last but not least, you can view all manual pages available in Debian (even those that are not installed on your machine) on the manpages.debian.org service. It offers each manual page in multiple versions, one for each Debian release.

7.1.2. info-dokumenter

GNU-prosjektet har skrevet håndbøker for de fleste av sine programmer i info-format: Det er grunnen til at mange manualsider refererer til tilsvarende info-dokumentasjon. Dette formatet gir noen fordeler, men standardprogrammet for å vise disse dokumentene (det kalles info) er også litt mer komplisert. Du gjør lurt i å bruke pinfo i stedet (fra pinfo-pakken).
info-dokumentasjonen har en hierarkisk struktur, og hvis du vil benytte pinfo uten parametre, vil den vise en liste over nodene som er tilgjengelig på første nivå. Vanligvis bærer noder navnet på de tilsvarende kommandoer.
With pinfo navigating between these nodes is easy to achieve with the arrow keys. Alternatively, you could also use a graphical browser, which is a lot more user-friendly. Again, konqueror and yelp work; the info2www package also provides a web interface.
Merk at info-systemet ikke er egnet for oversetting, til forskjell fra man-sidesystemet. info-dokumenter er dermed nesten alltid på engelsk. Men når du spør pinfo-programmet om å vise en ikke-eksisterende info-side, vil den falle tilbake på man-siden med samme navn (hvis den eksisterer), som kan være oversatt.

7.1.3. Spesifikk dokumentasjon

Hver pakke inneholder sin egen dokumentasjon. Selv de minst godt dokumenterte programmene har vanligvis en README-fil som inneholder noe interessant og/eller viktig informasjon. Denne dokumentasjonen er installert i /usr/share/doc/pakke/-mappen (der pakke representerer navnet på pakken). Hvis dokumentasjonen er særlig stor, bør den ikke legges inn programmets hovedpakke, men bør heller legges i en egen pakke som vanligvis har navnet pakke-doc. Hovedpakken anbefaler generelt denne dokumentasjonspakken, slik at den er enkel å finne.
The /usr/share/doc/package/ directory also contains some files provided by Debian which complete the documentation by specifying the package's particularities or improvements compared to a traditional installation of the software. The README.Debian file also indicates all of the adaptations that were made to comply with the Debian Policy. The changelog.Debian.gz file allows the user to follow the modifications made to the package over time: it is very useful to try to understand what has changed between two installed versions that do not have the same behavior. Finally, there is sometimes a NEWS.Debian.gz file which documents the major changes in the program that may directly concern the administrator (see Seksjon 6.7.2, «Å håndtere problemer etter en oppgradering»).

7.1.4. Websider

I de fleste tilfellene har fri programvare nettsteder som brukes til å distribuere dem, og bringe sammen fellesskapet av utviklere og brukere. Disse nettstedene er ofte fylt med relevant informasjon i ulike former: Offisiell dokumentasjon, FAQ (Frequently Asked Questions), e-postlister, etc. Problemer du kan møte har gjerne vært gjenstand for mange spørsmål allerede, og FAQ, eller listearkivet, kan ha en løsning for det. Et godt grep på søkemotorer vil vise seg svært verdifullt når en trenger relevante sider raskt (ved å begrense søket til et Internett-domene, eller underdomene øremerket for programmet). Hvis søket returnerer for mange sider, eller hvis resultatene ikke samsvarer med hva du søker, kan du legge til søkeordet debian for å begrense resultatene, og fokusere på relevant informasjon.
If you do not know the address for the software's website, there are various means of getting it. First, check if there is a Homepage field in the package's meta-information (apt show package). Alternately, the package description may contain a link to the program's official website. If no URL is indicated, look at /usr/share/doc/package/copyright. The Debian maintainer generally indicates in this file where they got the program's source code, and this is likely to be the website that you need to find. If at this stage your search is still unfruitful, consult a free software directory, such as FSF's Free Software Directory, or search directly with a search engine, such as Google, DuckDuckGo, Yahoo, etc.
You might also want to check the Debian wiki, a collaborative website where anybody, even simple visitors, can make suggestions directly from their browsers. It is used equally by developers who design and specify their projects, and by users who share their knowledge by writing documents collaboratively.

7.1.5. Veiledninger (HOWTO)

A HOWTO is a document that describes, in concrete terms and step by step, “how to” reach a predefined goal. The covered goals are relatively varied, but often technical in nature: for example, setting up IP Masquerading, configuring software RAID, installing a Samba server, etc. These documents often attempt to cover all of the potential problems likely to occur during the implementation of a given technology.
Many such tutorials are managed by the Linux Documentation Project (LDP), whose website hosts all of these documents:
Debian also provides tutorials for its users:
All these documents should be taken with a grain of salt. They are often several years old; the information they contain is sometimes obsolete. This phenomenon is even more frequent for their translations, since updates are neither systematic nor instant after the publication of a new version of the original documents. Further many tutorials nowadays are provided by bloggers, sharing their individual solution with the interested reader. They often lack important information, i.e. the reason why some configuration has been chosen over another, or why some option has been enabled or disabled. Because blogging and creating own websites made it so easy to share, many of these often short tutorials exist, but only a few are actively maintained and well-kept. This can make it hard, to find the "right" one for you. This is all part of the joys of working in a volunteer environment and without constraints…