Differences between version 3 and predecessor to the previous major change of HowToOnlineTroubleshootingHOWTO.
Other diffs: Previous Revision, Previous Author, or view the Annotated Edit History
Newer page: | version 3 | Last edited on Monday, November 1, 2004 11:41:32 pm | by AristotlePagaltzis | Revert |
Older page: | version 2 | Last edited on Friday, June 7, 2002 1:07:13 am | by perry | Revert |
@@ -1,662 +1 @@
-Online Troubleshooting Resources : HOWTO
-!!!Online Troubleshooting Resources : HOWTO
-!Howard Mann
-!Jean-Philippe Guérardv 1.4 March 4, 2002
-
-
-
-
-
-This document will direct Linux users to resources available on the Internet
-that provide access to a vast amount of Linux-related information useful in
-troubleshooting problems
-
-
-
-
-
-----; __Table of Contents__; 1. Introduction; 2. Document Updates: ; 2.1. Copyright and License; 2.2. Feedback and Corrections; 3. HOWTOs and mini-HOWTOs; 4. Frequently-Asked-Questions (FAQs); 5. Online Support Sections; 6. Usenet Newsgroup Archives; 7. Internet Search Engines: ; 7.1. Google.com; 8. Mailing List Archives; 9. Online User's Manuals; 10. Online Unix References and Tutorials; 11. Miscellaneous Resources: ; 11.1. Release Notes and Available Documentation related to the XFree86
-X Window Server; 11.2. GNU Texinfo pages; 11.3. GNU Software and Manuals; 11.4. Glossary of Linux-related terms; 11.5. An online dictionary of computer and technology terms; 11.6. A detailed Guide to Personal Computers; 12. Concluding Comments
-!!!1. Introduction
-
-The traditional means of troubleshooting computer-related problems
-involves consulting user's manuals, books, friends - probably enticed with
-goodies - and, when all the former do not yield a solution, calling the
-technical support service of the vendor of the product in question. And, we all
-know pleasant and reliably efficacious the latter stratagem is. Unfortunately,
-this is the norm in the sphere of commercial proprietary products.
-
-
-
-In contradistinction, Linux, and related distributions, utilities and
-applications software, has largely been developed according to the Open Source model, wherein developers
-have used electronic communication over the Internet - typically in the form of
-publically-accessible Mailing Lists - to collaborate with their peers in
-the refinement of the associated source code. Such collaboration has
-also traditionally involved the online publication of user's manuals,
-lists of Frequently-Asked-Questions (FAQ's), knowledge bases, release
-notes, formal guides such as this document (HOWTO's) and tutorials. In
-addition, users often assist others through the forum of Usenet and
-other newsgroups and the posted messages are readily accessible in the
-form of searchable archives. These linux-related newsgroups are renowned
-for their high level of user participation. In significant measure,
-Linux may be considered a product of the Internet.
-
-
-
-Considered together, these resources enable access to a large,
-ever-expanding factual database, and my intent is to encourage and direct the
-reader to utilize these repositories when faced with an issue not addressed in
-the documentation that is included with each distribution of Linux. Linux
-veterans who assist newcomers through the forum of Usenet soon become aware of
-the frequency with which certain technical questions are repeatedly posted -
-questions the answers to which are readily available in one or more of the
-existent online repositories. So, to diminish the likelihood of being "flamed"
-in response to your posted question on Usenet or irc , read further!
-
-
-
-Armed with a browser, Linux users may rapidly become adept at
-troubleshooting their systems. The key is knowing how and where to look. My
-objective is to guide the user - particularly the Linux newbie - in this
-quest.
-
-----
-!!!2. Document Updates
-
-The latest version of this document will always be available via the
-''HOWTO index'' at the Linux Documentation Project
-The document will also be available in SGML, PS, PDF, and other
-formats at that website.
-
-----
-!!2.1. Copyright and License
-
-Copyright (c) 1999-2000 , by Howard Mann.
-
-
-
-
-Copyright (c) 2002 , by Jean-Philippe Guérard.
-
-
-
-
-Publication and distribution of this document is governed by the terms of the
-Open Publication
-License , Draft version .4, June 8, 1999, or later.
-
-----
-!!2.2. Feedback and Corrections
-
-I always welcome feedback and constructive criticism. You can
-reach me at jean-philippe.guerard@laposte.net. In particular, I wish to be
-notified about any errors in this document and resources you believe
-deserving of inclusion, but not presently covered herein. Because the
-assessment of the value of a particular resource is inherently
-subjective, I do not guarantee that I will include it, but I will
-certainly give any suggestion thoughtful consideration. In anticipation,
-Thanks.
-
-----
-!!!3. HOWTOs and mini-HOWTOs
-
-HOWTOs are detailed reference documents on a specific subject,
-usually following a step-by-step approach. A HOWTO is a good document to
-help you discover a task or a topic you don't know. It will provide you
-with the basic steps and the major references.
-
-
-
-These documents are particularly useful when you decide to provide or
-access a new service with your Linux system, or when you embark on a technically
-complex project. For example, you may have the option of accessing the 'net with
-a DSL or Cable Modem service - excellent guides are available in the form of
-HOWTOs.
-
-
-
-Authors of these documents often include references and links to
-sites that they have found useful. You may find the information you need
-at one of these hyperlinked sites rather than in the HOWTO itself. For
-example, I found Linux
-Network Drivers, an interesting site for information about
-Network
-Interface Card drivers, in the Ethernet HOWTO.
-
-
-
-To find HOWTOs, the first place to go is the Linux Documentation Project (LDP).
-The LDP includes a HOWTO
-Index Page that I suggest you bookmark in your browser.
-
-
-
-These HOWTOs are written by Linux users and are periodically
-updated by the authors. Many authors provide the latest version at a
-personal website and a hyperlink to the latter is typically provided in
-the document. This version may be newer than the one available at the
-LDP website.
-
-
-
-Note also that other HOWTOs are available, the authors of which
-have not submitted them to the LDP. It is definitely worthwhile trying
-to find these using an Internet search engine as I describe in a
-subsequent section.
-
-----
-!!!4. Frequently-Asked-Questions (FAQs)
-
-Users of Internet Newsgroups and Mailing lists soon discovered
-that some basic questions were being asked over and over again.
-To provide an answer to these questions, and to avoid them
-being repeated continually, FAQs were developed, listing the most
-classical questions and their agreed answers.
-
-
-
-A list of FAQs is also a traditional accompaniment to
-Linux-related software. The FAQ is the first document to peruse when
-troubleshooting a particular application. It provides answers to typical
-questions, and is a good place to start troubleshooting a specific
-problem. In addition, FAQs exist for Linux distributions, window
-managers, and the so-called desktop environments (KDE and
-Gnome).
-
-
-
-A FAQ is typically provided online by the developers of the
-product in question, and enterprising users sometimes host an
-"unofficial" FAQ as well. Search for the latter with an
-Internet search engine.
-
-
-
-For Linux newbies, I provide links to two FAQs that collectively
-address ''many'' of the questions posted to the Usenet
-newsgroups :
-
-
-
-
-
-
-*
-
-The
-Linux FAQ
-
-
-*
-*
-
-The Linux Kernel mailing
-list FAQ
-
-
-*----
-!!!5. Online Support Sections
-
-These sections are typically found at the websites of Linux
-distributions, and often contain a variety of helpful documents with information
-not easily encompassed within a FAQ. Look for sections with one or more of the
-following titles:
-
-
-
-
-
-
-*
-
-Installation Support
-
-
-*
-*
-
-Knowledge or Solutions Databases
-
-
-*
-*
-
-Tips and Tricks
-
-
-*
-*
-
-Errata, Fixes and Updates
-
-
-*
-*
-
-White Papers
-
-
-*
-*
-
-Technical Guides
-
-
-*
-*
-
-Hardware Guide or Compatibility List
-
-
-*
-*
-
-Security Information
-
-
-*
-*
-
-Bug Tracking System
-
-
-*
-*
-
-Bug Database
-
-
-*
-
-Some websites provide a site search engine that will facilitate your quest
-for a solution.
-
-
-
-If you have a problem with a newly installed distribution, look here first
-as bugs and their fixes are typically posted here. You may find a detailed guide
-that will help you accomplish a task such as upgrading your kernel or the
-version of the X Window System you are using.
-
-
-
-I recommend you spend some time at the website of the distribution you are
-using, familiarizing yourself with what is available.
-
-----
-!!!6. Usenet Newsgroup Archives
-
-The ability to search for and retrieve information from archived posts
-to the linux-related (Usenet) newsgroups represents a powerful means of
-troubleshooting in Linux.
-
-
-
-Search engines permit one to search the archives by stipulating the forum,
-keywords, authors, dates, language and combinations thereof. Because the number
-of linux-related newsgroups is large, the likelihood of finding useful
-information is high.
-
-
-
-The main web site that currently provides access to Usenet
-archives using a search engine is groups.google.com. The most
-effective way to do a search is to use its Advanced
-Groups Search page.
-
-
-
-I would like to relate a brief anecdote to demonstrate the efficacy of
-this approach. The first time I attempted to build a kernel, I was presented
-with this error message when I invoked a "make" command:
-
-
-make
[[1
]: as86: Command not found make[[1]: *** [[bootsect.o] Error 127
-make[[1]: Leaving directory `/usr/src/linux/arch/i386/boot' make: *** [[zImage]
-Error 2
-
-I had no idea what ''as86'' was, but I entered
-it as the keyword in the ''Subject'' field of the
-Advanced Groups Search page at groups.google.com, and was presented
-with a large number of posts from folks who had encountered the same
-problem. Respondents had provided the reason and solution: I did not
-have an assembler/linker necessary to create machine code, and the
-''bin86'' package provided it. I downloaded and
-installed a RPM package of the latter and was on my way. This entire
-process took about 10 minutes (I do have an ADSL connection to the 'net
-!).
-
-----
-!!!7. Internet Search Engines
-
-I frequently use a Search Engine to retrieve helpful or necessary
-information from the 'net. These engines catalogue pages from commercial,
-personal and academic websites, as well as Mailing Lists and the like.
-
-
-
-Of course, there are a large number of available Search Engines, and I
-suggest you try several before giving up on a particular quest. Research has
-shown that any one of them catalogues but a small portion of existent web pages.
-It is worthwhile becoming very familiar with the operational details of at
-least one non-directory engine to maximize the efficiency and efficacy of your
-search efforts. You probably already have a favorite - I like
-''Google.com'', and will discuss it in a little more
-detail.
-
-----
-!!7.1. Google.com
-
-This engine has several novel features that are described in its
-Why use Google.com
-page. In particular, the engine often returns the most useful
-pages first; in fact, I have often found that the first listed page
-contains the information I need. Because it caches web pages, it is
-relatively fast at displaying requested items. It has a so-called
-''!GoogleScout (TM)'' feature, activated by clicking on
-the "similar pages" links, that provides additional relevant links with
-each item returned.
-
-
-
-In addition, it has a specialized Linux Search Engine that I use as my
-primary Internet search tool. It searches the database of linux-related pages at
-Google.com further promoting search efficiency. Try it - I am confident
-you will bookmark it immediately.
-
-----
-!!!8. Mailing List Archives
-
-As you might expect, there are a very large number of linux-related
-Mailing Lists that enable developers and users to communicate and collaborate on
-projects. These Lists cover every conceivable aspect of Linux, from the
-technical arcana of kernel development to the relatively unfocused discussion of
-issues at the newbie level. Subscribers to a particular Mailing List are
-generally very knowledgeable in the List's topic, and detailed and useful
-information is often retrievable. The communications are publically accessible
-through Internet search engines and in the form of online Mailing List Archives.
-You will typically see archived pages when you conduct a search using an
-Internet search engine.
-
-
-
-Not all Mailing Lists are associated with an online archive, but this is
-increasingly the case. Similarly, not all archives have an associated search
-engine.
-
-
-
-Initially, try locate the Mailing List Archive you are interested in by
-typing a keyword/s and "mailing list archive" in an Internet search
-engine.
-
-
-
-For a listing of linux-related Mailing Lists, peruse websites such as the
-Linux Resource
-Exchange and the Linux
-Online Mailing Lists
-
-
-
-A relatively new, excellent Mailing List resource is Geocrawler (The Knowledge Archive). This
-is a continuously updated, searchable archive of a large number of Lists that
-also allows one to register and subsequently post to any particular Mailing
-List. Its user interface is simple and its search function delivers messages
-very quickly. I highly recommend this site.
-
-
-
-You may also find Mailing List archives at the following locations
-:
-
-
-
-
-
-
-*
-
-The website of the distribution of Linux you use.
-
-
-*
-*
-
-The website of the Window Manager or Desktop
-Environment you use.
-
-
-*
-*
-
-The website dedicated to the application or project in
-question.
-
-
-*
-*
-
-The Mail
-Archive
-
-
-*
-*
-
-Mailing List
-Archives
-
-
-*
-*
-
-Tux Mailing List
-Archives
-
-
-*
-
-This is not a complete listing of archives and you may find additional
-sites with an Internet search engine. But, this should certainly get you
-going.
-
-----
-!!!9. Online User's Manuals
-
-Some of the major Linux distributions, Window Managers and Desktop
-Environments publish their user's manual online. If the entire manual is not
-online, installation and configuration guides are typically found at the
-relevant website. This also applies to major applications like the
-''Gimp'' (GNU Image Manipulation Program).
-
-
-
-So, for those users who do not have the printed manual, a wealth of
-installation and configuration guidance is generally available online.
-
-----
-!!!10. Online Unix References and Tutorials
-
-As Linux is a Unix-like operating system, a general familiarity with
-fundamental Unix concepts such as the Unix directory hierarchy and file
-permissions is essential. Fortunately, there are many Unix tutorials online that
-collectively cover everything a user might need to know to use Linux. I suggest
-you bookmark the following as an online reference library:
-
-
-
-
-
-
-*
-
-The Command and Shell User's guide from Digital Equipment
-Corporation is an excellent guide to the Unix Operating System. Bookmark
-the ''Index Page'' linked there as an online
-reference.
-
-
-*
-*
-
-UNIXhelp is
-mirrored on many servers around the world. It is a useful resource for
-newbies.
-
-
-*
-*
-
-Introduction to
-Unix also contains a useful Unix
-Command Summary page with brief, but useful, explanations of commonly
-used Unix commands.
-
-
-*
-*
-
-Unix is a Four Letter
-Word... is another resource suitable for newbies.
-
-
-*----
-!!!11. Miscellaneous Resources
-
-In this section, I provide a number of links to websites that I have
-found useful while learning to use Linux. This is an eclectic collection, but
-keep these handy.
-
-----
-!!11.1. Release Notes and Available Documentation related to the XFree86
-X Window Server
-
-This documentation accompanies each version of XFree86, and is
-available at the XFree86 website.
-Whenever you have trouble with your X environment, peruse the notes applicable
-to your videocard and chipset. These typically provide details about the
-configuration of the X Window System relative to your card, and will
-enumerate any "options" you have to include in theXF86Config file that governs X.
-
-----
-!!11.2. GNU Texinfo pages
-
-A great collection of pages is available at the Geek Girl.com website.
-Included are links to pages on the following:
-
-
-
-
-
-
-*
-
-''Bash'' - The Bourne-again
-shell
-
-
-*
-*
-
-''Configure'' - used when compiling
-programs from source code
-
-
-*
-*
-
-''G++ '' - the GNU C++
-compiler
-
-
-*
-*
-
-''Gcc'' - the C compiler
-
-
-*
-*
-
-''Libc'' - the GNU C library
-
-
-*
-*
-
-''Make'' - a program for directing
-recompilation
-
-
-*
-
-Note that some of these are included in the "docs" that come
-with Linux distributions. In general, these are detailed technical documents of
-particular interest to developers. However, if like me, you are not a
-programmer, you may peruse the introductory sections of these documents to get
-insight, for example, into those configureand
-make commands you use when installing applications
-from source code.
-
-----
-!!11.3. GNU Software and Manuals
-
-Many important programs that are frequently utilized by the Linux user are
-GNU utilities - for example, the tar (archive) and
-gzip (compression) programs. Descriptions of these
-programs are located at the GNU.org
-website where many Online Manuals may also be
-found.
-
-
-
-These manuals typically provide a lot more information than is found in
-the corresponding man page on your system. For
-example , compare the man page and online manual for
-the tar utility.
-
-----
-!!11.4. Glossary of Linux-related terms
-
-The First Linux
-online guide has a nice collection of terms and definitions, sorted
-alphabetically. Go
here if you encounter a term that you have not seen before or
-do not understand.
-
-----
-!!11.5. An online dictionary of computer and technology terms
-
-The PC Webopedia consists
-of a large online dictionary of computer-related terms and a search engine that
-provides links to documents that discuss each item in more detail. For example,
-I used this site to learn the differences between ''ISA'' and
-''PCI'' buses.
-
-----
-!!11.6. A detailed Guide to Personal Computers
-
-The Topic Index to the voluminous hardware guide at PC guide.com will give you a
-great idea of the contents of this website. I used it quite frequently when
-first installing Linux and configuring the X Window System. I learnt a lot about
-videocards and monitors, including the concepts of screen resolution, color
-depth etc., useful when troubleshooting X display problems.
-
-----
-!!!12. Concluding Comments
-
-If you are a Linux newbie, you may want to create a
-''Troubleshooting'' folder in your browser's bookmark list,
-into which you put the hyperlinks I have included in this document, as well as
-those pertinent to the distribution of Linux and the Window Manager
-or Desktop Environment you use.
-
-
-
-As you use these links, you will quickly become adept at troubleshooting
-online
.
-
-
-
-Cheers and happy searching !
+Describe
[HowToOnlineTroubleshootingHOWTO
] here.