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. 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.).
Halaman manual tidak hanya mendokumentasikan program yang dapat diakses dari baris perintah, namun juga berkas konfigurasi, system call, fungsi pustaka C, dan banyak lagi. Kadang terdapat nama yang mirip. Misal, perintah shell read mempunyai nama yang sama dengan fungsi system call yaitu read. Itu sebabnya halaman manual disusun dan diurutkan dalam bagian yang diberi nomor :
  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
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.
Perintah man bukan satu-satunya yang bisa menyediakan halaman manual, Program konqueror> (pada destop KDE) dan yelp (pada destop GNOME) juga menyediakan kebutuhan yang sama. Juga ada antar muka web, yang disediakan oleh paket man2html, yang mengizinkan anda menampilkan halaman manual di peramban web. Pada komputer yang telah terpasang paket man2html, gunakan URL berikut :
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.

7.1.2. info Dokumen

The GNU project has written manuals for most of its programs in the info format; this is why many manual pages refer to the corresponding info documentation. This format offers some advantages, but the default program to view these documents (it is called info) is also slightly more complex. You would be well advised to use pinfo instead (from the pinfo package).
The info documentation has a hierarchical structure, and if you invoke pinfo without parameters, it will display a list of the nodes available at the first level. Usually, nodes bear the name of the corresponding commands.
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 also provides a web interface.
Note that the info system is not suitable for translation, unlike the man page system. info documents are thus almost always in English. However, when you ask the pinfo program to display a non-existing info page, it will fall back on the man page by the same name (if it exists), which might be translated.

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.
Direktori /usr/share/doc/paket/ juga berisi beberapa berkas yang disediakan oleh Debian yang melengkapi dokumentasi dengan dengan menunjukkan kehasan paket atau perbaikan dibandingkan instalasi tradisional sebuah perangkat lunak. Berkas README.Debian juga menunjukkan seluruh adaptasi yang dibuat agar patuh terhadap Debian Policy. Berkas changelog.Debian.gz memungkinkan pengguna untuk mengikuti modifikasi yang dibuat untuk paket sepanjang waktu: sangat berguna untuk mencoba memahami apa yang berubah antara dua versi terinstall yang tidak memiliki perilaku yang sama. Akhirnya, terkadang ada pula sebuah berkas NEWS.Debian.gz yang mendokumentasikan perubahan besar pada program yang mungkin secara langsung diperhatikan administrator.

7.1.4. Website

In most cases, free software programs have websites that are used to distribute it and to bring together the community of its developers and users. These sites are frequently loaded with relevant information in various forms: official documentation, FAQ (Frequently Asked Questions), mailing list archives, etc. Problems that you may encounter have often already been the subject of many questions; the FAQ or mailing list archives may have a solution for it. A good mastery of search engines will prove immensely valuable to find relevant pages quickly (by restricting the search to the Internet domain or sub-domain dedicated to the program). If the search returns too many pages or if the results do not match what you seek, you can add the keyword debian to limit results and target relevant information.
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-cache 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.
Anda mungkin ingin melihat wiki Debian, sebuah website hasil kolaborasi dimana setiap orang, bahkan hanya seorang pengunjung, bisa memberikan masukan-masukan, langsung dari peramban web mereka, juga digunakan oleh para pengembang untuk merancang desain dan menetapkan proyek mereka, oleh para pengguna yang berbagi pengetahuan dan pengalaman mereka dengan menulis dokumentasi secara kolaborasi.

7.1.5. Tutorial (HOWTO)

howto adalah dokumen yang mendiskripsikan, secara konkret dan langkah demi langkah, bagaimana mencapai tujuan yang sudah ditetapkan. Capaian relatif bervariasi, namun lebih sering bersifat teknis: contohnya, mengatur IP Marquerading, mengkonfigurasi perangkat lunak RAID, memasang server Samba, dan lainnya. Dokumentasi seperti ini biasanya menyediakan penyelesaian atas masalah yang mungkin muncul saat implementasi teknologi terkait.
Many such tutorials are managed by the Linux Documentation Project (LDP), whose website hosts all of these documents:
Dokumen ini perlu diambil dengan sebutir garam. Mereka seringkali berusia beberapa tahun; konten informasi mereka terkadang usang. Fenomena ini bahkan sering terjadi pada terjemahan mereka, pembaharuannya pun tidak sistematis tidak pula instant setelah publikasi versi baru dokumen aslinya. Ini merupakan bagian dari lingkungan kerja pada sukarelawan dan tanpa kendala…