Product SiteDocumentation Site

Bab 7. Memecahkan Masalah dan Menemukan Informasi yang Relevan

7.1. Sumber-Sumber Dokumentasi
7.1.1. Halaman Manual
7.1.2. info Dokumen
7.1.3. Dokumentasi Spesifik
7.1.4. Website
7.1.5. Tutorial (HOWTO)
7.2. Prosedur Umum
7.2.1. Mengkonfigurasi Program
7.2.2. Memonitor Apa yang Dilakukan Daemon
7.2.3. Meminta Bantuan pada Milis
7.2.4. Melaporkan Kutu Ketika Sebuah Masalah Terlalu Sulit untuk Diselesaikan
Untuk administrator, keterampilan yang paling penting adalah untuk dapat mengatasi setiap situasi, yang dikenal atau tidak dikenal. Bab ini memberikan sejumlah metode yang akan — mudah-mudahan — memungkinkan anda untuk mengisolasi penyebab masalah yang akan anda hadapi, sehingga anda dapat menyelesaikannya.

7.1. Sumber-Sumber Dokumentasi

Sebelum anda dapat memahami apa yang sebenarnya terjadi ketika menemui masalah, anda perlu mengerti tentang teori dan aturan yang berlaku pada setiap program yang berkaitan dengan masalah tersebut. Caranya yang terbaik adalah merujuk pada dokumentasi dari program-program tersebut, namun karena dokumentasi-dokuentasi itu sangatlah banyak dan tersebar luas, anda perlu mengetahui dimana bisa menemukan dokumentasi tersebut.

7.1.1. Halaman Manual

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 KEMBALI KE DASAR Shell, penafsir baris perintah).
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
Perintah-perintah yang dapat dieksekusi dari shell;
2
system calls (fungsi yang disediakan oleh kernel)
3
fungsi pustaka (yang disediakan oleh pustaka-pustaka sistem)
4
perangkat (di sistem Unix, ini adalah berkas-berkas khusus, yang biasanya terletak pada direktori /dev/;
5
berkas konfigurasi (bentuk dan kaidah);
6
permainan;
7
kumpulan makro dan standar
8
perintah administrasi sistem;
9
rutin kernel.
Anda bisa memilih bagian tertentu yang anda cari dari halaman manual : menampilkan dokumentasi untuk fungsi system call read, dengan mengetik perintah man 2 read. Jika tidak ada bagian yang dipilih, bagian pertama dari halaman manual yang diminta akan ditampilkan. Perintah man shadow menghasilkan shadow(5) karena tidak ada laman manual untuk shadow pada bab 1 ke 4.
Tentu saja, jika anda tidak mengetahui nama dari sebuah perintah, halaman manual tidak terlalu berguna untuk anda. Untuk kebutuhan ini, perintah apropos membantu anda mencari nama-nama perintah pada semua halaman manual atau lebih khususnya, deskripsi singkat dari perintah tersebut. Setiap halaman manual selalu diawali oleh deskripsi singkat. Perintah apropos menampilkan daftar halaman namual yang berisi kata kunci yang diminta. Jika anda memilih kata kunci dengan tepat, mungkin anda akan menemukan apa yang anda cari.

Contoh 7.1. Menemukan cp dengan 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:
Utilitas ini membutuhkan sebuah web server. Tidak ada ruginya anda memasang paket ini pada salah satu server anda: semua pengguna dari jaringan lokal dapat mengambil keuntungan dari layanan ini (termasuk dari perangkat-perangkat non-Linux), dan anda tidak perlu membuat server HTTP di setiap workstation. Jika server anda bisa diakses dari jaringan lain, mungkin anda ingin membatasi akses layanan ini hanya untuk pengguna lokal.
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 Dokumen

Proyek GNU telah membuat halaman manual untuk sebagian besar programnya dalam format info; itu sebabnya beberapa halaman manual merujuk ke dokumentasi berformat info. Format ini mempunyai beberapa kelebihan, namun program bawaan untuk menampilkan dokumen ini (bernama info) juga sedikit lebih kompleks. Anda disarankan untuk memakai pinfo sebagai pengganti (dari paket pinfo).
Dokumentasi info mempunyai struktur hirarkis, dan jika Anda menjalankan pinfo tanpa parameter, itu akan menampilkan daftar simpul yang tersedia di tingkat pertama. Biasanya, simpul mengambil nama perintah-perintah yang sesuai.
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.
Sebagai catatan, dokumentasi info tidak cocok untuk penerjemahan, tidak seperti halaman man. Maka dokumen-dokumen info hampir selalu dalam bahasa Inggris. Namun, jika Anda meminta program pinfo untuk menampilkan halaman info yang tidak ada, itu akan mengalihkan ke halaman man dengan nama yang sama (jika ada), yang mungkin sudah diterjemahkan.

7.1.3. Dokumentasi Spesifik

Setiap paket mempunyai dokumentasi masing-masing. Bahkan dokumentasi program yang paling sedikit pun mempunyai berkas README yang berisi informasi penting/menarik. Dokumentasi ini terpasang di direktori /usr/share/doc/nama-paket/ (nama-paket merujuk ke nama paket). Jika dokumentasi terlalu besar, mungkin saja dokumentasi tidak dimasukkan ke dalam paket utama program, tapi mungkin tersedia dalam paket khusus yang biasanya memiliki nama package-doc. Paket utama biasanya merekomendasikan paket dokumentasi sehingga anda mudah menemukannya.
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 Bagian 6.7.2, “Menangani Masalah setelah Pembaharuan”).

7.1.4. Website

Biasanya, perangkat lunak bebas mempunyai website yang digunakan untuk mendistribusikan perangkat lunak itu sendiri dan untuk menyatukan komunitas pengembang dan penggunanya. Situs-situs ini secara berkala menyediakan informasi yang relevan dalam berbagai bentuk: dokumentasi resmi, FAQ (Frequently Asked Question / Tanya Jawab), arsip milis, dan lainnya. Masalah yang mungkin Anda jumpai seringkali sudah pernah menjadi subjek banyak pertanyaan, Mungkin Anda akan menemukannya di FAQ dan arsip milis. Penguasaan dan penggunaan efektif dari mesin pencari akan terbukti sangat berharga untuk menemukan halaman yang relevan dengan cepat (dengan membatasi pencarian ke domain atau sub-domain yang berkaitan dengan program). Jika hasil pencarian menampilkan terlalu banyak halaman atau hasilnya tidak sesuai dengan yang Anda cari, Anda bisa menambahkan kata kunci debian untuk membatasi hasil pencarian dan menyasar informasi yang relevan.
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. Tutorial (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…