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.

Kemudian, Anda harus melihat dokumentasi resmi perangkat lunak — lihat Bagian 7.1, “Sumber-Sumber Dokumentasi” untuk mengidentifikasi berbagai sumber dokumentasi yang ada. Perintah dpkg -L paket memberikan daftar berkas yang disertakan dalam paket; Anda dapat mengidentifikasi dokumentasi yang tersedia secara cepat (dan juga berkas-berkas konfigurasi, yang terletak di /etc/). dpkg -s paket menampilkan meta-data paket dan menampilkan beberapa rekomendasi atau saran paket yang memungkinkan; di sana, Anda dapat menemukan dokumentasi atau sebuah utilitas yang akan memudahkan konfigurasi perangkat lunak.

Akhirnya, berkas konfigurasi sering didokumentasikan-sendiri oleh banyak komentar yang menjelaskan secara rinci berbagai kemungkinan nilai untuk setiap pengaturan konfigurasi. Saking banyaknya terkadang ini cukup untuk sekedar memilih sebuah baris untuk diaktifkan di antara yang tersedia. Dalam beberapa kasus, contoh berkas konfigurasi tersedia di direktori /usr/share/doc/paket/examples/. Mereka disajikan sebagai dasar berkas konfigurasi Anda sendiri.

Memahami apa itu daemon terkadang lebih rumit, karena tidak berinteraksi langsung dengan administrator. Untuk memeriksa bahwa sebuah daemon benar-benar bekerja, Anda perlu mencobanya. Misalnya, untuk memeriksa daemon Apache (server web), tes dengan sebuah permintaan HTTP.

Untuk melakukan tes, setiap daemon biasanya merekam apapun yang dia lakukan, juga error yang terjadi, yang disebut “berkas log” atau “log sistem”. Log disimpan di /var/log/ atau salah satu subdirektorinya. Untuk mengetahui berkas log setiap daemon secara tepat, lihat dokumentasinya. Catat: satu percobaan tidak selalu cukup jika tidak mencakup semua kemungkinan kasus penggunaan; beberapa masalah hanya terjadi pada kondisi tertentu.

Sebagai sebuah operasi pencegahan, administrator seharusnya membaca log server yang sesuai secara berkala. Mereka dapat melaporkan masalah bahkan sebelum dilaporkan oleh pengguna yang terganggu. Sebenarnya pengguna kadang menunggu sebuah masalah terjadi berulang-ulang selama beberapa hari sebelum mereka melaporkannya. Dalam banyak kasus, ada peralatan spesifik untuk menganalisa konten berkas log yang lebih besar. Di antaranya, ada utilitas untuk server web (seperti analog, awstats, awffull untuk Apache), untuk server FTP, server proksi/singgahan, firewall, server surel, server DNS, dan bahkan server pencetak. Peralatan lain, seperti logcheck (sebuah perangkat lunak yang dibahas di Bab 14, Keamanan), memindai berkas-berkas ini untuk mencari peringatan yang akan ditangani.

Jika berbagai pencarian tidak membantu Anda ke akar permasalahan, masih memungkinkan untuk mendapatkan bantuan dari yang lainnya, mungkin orang yang lebih berpengalaman. Sesungguhnya ini merupakan tujuan dari milis debian-user@lists.debian.org dan saudaranya yang memakai bahasa tertentu debian-user-bahasa@lists.debian.org. Sebagai sebuah komunitas, dia memiliki peraturan yang harus dipatuhi. Sebelum mengirim pertanyaan, Anda harus memeriksa apakah masalah Anda belum dibahas oleh diskusi terkini pada milis atau dokumentasi resmi.

Ketika dua syarat tersebut telah dipenuhi, Anda dapat memikirkan untuk menjelaskan masalah Anda pada milis. Sertakan sebanyak mungkin informasi yang sesuai: berbagai percobaan yang dilakukan, dokumentasi yang dibaca, bagaimana Anda melakukan diagnosa masalah, paket yang diperhatikan atau yang mungkin terlibat, dll. Periksa Debian Bug Tracking System (BTS, dijelaskan di samping Bagian 1.3.2.1, “Melaporkan bug”) untuk masalah yang mirip, dan sebutkan hasil pencarian, menyediakan tautan bug yang ditemukan. BTS dimulai di:

Semakin Anda sopan dan jelas, semakin besar kesempatan Anda untuk mendapatkan jawaban, atau, setidaknya beberapa unsur tanggapan. Jika Anda menerima informasi yang sesuai oleh surel private, pikirkan untuk meringkaskan informasi ini secara publik agar orang lain mendapatkan manfaatnya. Hal ini juga menjadikan arsip milis, dicari melalu berbagai mesin pencari, untuk menampilkan jawaban untuk orang lain yang mungkin memiliki pertanyaan yang sama.

Jika semua usaha untuk menyelesaikan sebuah masalah gagal, mungkin jawaban bukan tanggung-jawab Anda, dan masalahnya karena kutu pada program. Dalam hal ini, prosedur yang tepat adalah melaporkan kutu ke Debian atau ke pengembang hulu secara langsung. Untuk melakukan ini, isolasi masalah sebisa mungkin dan buat keadaan percobaan minimal yang dapat menghasilkan permasalahan itu. Jika Anda tahu program mana yang diduga menimbulkan masalah, Anda dapat menemukan paket yang sesuai dengan perintah, dpkg -S berkas_yang_diminta. Periksa Bug Tracking System (https://bugs.debian.org/paket) untuk memastikan bahwa kutu belum dilaporkan. Anda kemudian dapat mengirim laporan kutu Anda sendiri, menggunakan perintah reportbug, termasuk sebanyak mungkin informasi, khususnya penjelasan lengkap tentang keadaan percobaan minimal yang akan memudahkan siapapun untuk membuat ulang kutu.

Unsur bab ini dimaksudkan untuk menyelesaikan masalah secara efektif yang akan dibawa pada bab-bab berikutnya. Gunakan sesering mungkin ketika diperlukan!