Troubleshooting/ko

이 페이지의 목적은 사용자에게, 약간의 새로운 기술과 도구로 자신 스스로게 젠투 설정 과정에서 문제를 찾고 해결할 수 있도록 하는 실마리 제공에 있습니다. 게다가 더 복잡한 문제에 있어서도, 이 게시글은 사용자로 하여금 문제를 해결하는 과정에서 자신 스스로에게 도움을 줄 정보를 수집하는 기법을 제공하려 내용을 살펴봅니다.

이 글에서는 젠투 핸드북을 이미 읽었고 젠투 사용법의 기본을 이미 알고 있다고 가정합니다.

도움을 받을 곳
젠투는 풍부한 정보를 가지고 있는 몇가지 위키 문서를 보유하고 있습니다. 일부 글이 오래되어 한물간 내용이 있음을 참고하셔야겠지만, 젠투를 사용할 때 위키 글을 쉽게 읽어내려가다보면 항상 어려운 단계에 부딪힙니다.


 * 공식 젠투 위키en
 * 비공식 젠투 위키en
 * Gentoo-Wiki.com 게시글 모음en
 * 일반 사례 및 문제를 다룬 지식 창고en

는 일반 문제를 다루는 추천 대화방입니다. 답변을 가장 빨리 얻을 수 있는 곳일지도 모릅니다.

IRC 대화방은 접속한 상태로 있어야 하기 때문에, 일부 사용자는 포럼en 또는 브라우저를 닫아도 계속 살펴볼 수 있는 메일링 리스트en 에 메시지를 남겨두는게 좋습니다.

모든 나머지 경우에 실패했고 젠투를 깨먹는 요소가 있는 것 같다면, 젠투 버그 추적 시스템은 어떤 버그를 이미 보고했는지 살펴보는 좋은 자료가 되거나, 필요한 경우 여기에 새로운 버그 보고서를 작성합니다. 이 방식은 젠투 개발자와 연락이 닿는 가장 효율적인 방법이며 문제 상황을 진전시키고 해결하는 과정에 주어진 실마리를 활용할 수 있습니다.

프로그램
다음은 매우 권장하는 도구 목록입니다:

첫 단계
문제 상황을 해결 생황으로 이끌어내려면 우선 문제를 잘 이해해야합니다. 해결책을 끌어올리는게 불가능한 일이 아닌 상황에서 문제를 제대로 이해하지 못하면 어려워집니다. 분명하게 말해서, 문제를 자세하게 설명하면, 문제에 정확하게 맞는 해결책을 이끌어낼 수도 있습니다.

문제 인식
이 부분은 무개념한 사용자들에게 도움을 주는 내용이겠지만, 이 부분이 없다면 문제 발견 과정에서 다음으로 넘어갈 수 없습니다.

몇가지를 참고해 두십시오:
 * 1) 하드웨어의 문제인가? 프로그램의 문제인가?
 * 2) 이 문제가 일어나기 전에 어떤 동작을 취해서 바뀐 것이 있는가?
 * 3) 문제에 대한 추가 정보를 모을 수 있는가?

자세한 내용, 기록, 다른 사람이 겪은 적이 있는지 여부 등의 정보를 제공한다면 문제를 살펴보기 편하게 해줍니다.

드라이버
하드웨어의 드라이버 이슈는 IRC에서 종종 회자되는 일반적인 문제 중 하나입니다.

무엇보다도 먼저, 어떤 하드웨어가 문제를 일으키는지 확인하십시오. 와 명령은 이 용도에 따른 멋진 도구입니다. 목적을 시연하기 위해 문제있는 이더넷 카드 장치를 찾아보겠습니다.

적당한 드라이버 찾기
First look with lspci and find the device information:

간편하게 줄인 표기 옵션 을 사용할 수 있습니다(인터넷에서 검색하는 것보다 쉽습니다).

The model name and vendor/model  can be used to look up the device on a place like WikiDevi or Debian HCL to find the right driver to use in Linux.

드라이버 불러오기 유무 확인
드라이버를 가져오는 일은 반절의 사투도 채 안됩니다. 대부분 드라이버와 얽히는 문제는 제대로 불러와서 동작하는지 확인하는 과정입니다.

에게 다시 기대보도록 하죠:

Note that here, an indicator is given that a driver is in use. If not, then no driver has claimed responsibility over this hardware. Assuming the driver was built as a module rather than built-in, try modprobe  to attempt loading the right module. If the driver was built-in, consider making it a module, because modules can be loaded with modprobe and unloaded with modprobe -r which saves on number reboots while debugging the issue.

드라이버 문제 해결
Compile the driver as a module, then capture the output it generates when the module is loaded. Make sure to first remove all modules that depend on the driver (see lsmod).

The following command will compare the dmesg</tt> output after removing the module (in this example, r8169</tt>) with the output after adding the module again, effectively showing the messages that were added (lines starting with +).

대부분의 일반적인 문제는 펌웨어가 빠져있는 상태입니다. 메시지에서 펌웨어가 빠져있다고 관리자에게 나타나면  또는 포티지에서 특정 펌웨어 꾸러미를 발견하고 설치하십시오. 펌웨어를 설치한 후에는 커널 모듈을 내렸다가 다시 불러와서 문제를 해결했는지 확인하십시오.

의존성 그래프 슬롯 중복
때로는 꾸러미를 이머지할 때 이런 메시지가 뜨는 경우가 있습니다:

보통 의존성 그래프에서 요청한 버전이 여러개가 있다는 의미입니다. 다행히도 대부분의 경우에는 이게 전부가 아니라면 요청한 버전 중 가장 최신 버전으로 직접 업그레이드 하여 해결할 수 있습니다. 따라서 다음 메시지를 받았다면:

최근 버전은 20120520 입니다. 따라서:

Often, it's advantageous to one-shot ( or  ) all of the conflicts at once because they sometimes depend on one another.

또 다른 블록 예제가 있습니다:

There should be no problem changing poppler versions. Note that luatex and cups-filters don't require a specific version of poppler, but they need to be rebuild with whatever version is used:

추가 정보 수집
도움을 요청할 때, 단 한번도 어떤 내용을 요구받지 않는다기보다는 어떤 추가 정보든 명령 출력 내용 같은 걸 여러번 요구받습니다. 이 문제는 수십줄 내지는 백여줄의 텍스트가 있습니다. 프리노드의 젠투 지원 채널 같은 IRC 대화방에 적당히 붙여넣기에는 너무 많습니다. 때문에 이 문제를 간편하게 해주는 를 도입했습니다. 사용자로 하여금 긴 출력 내용을 간단한 링크로 어딘가에 게시할 수 있게 해줍니다.

를 설치했는지 확인하십시오:

예를 들어 의 내용을 보여주려면 를 활용하여 다음과 같이 단순화할 수 있습니다:

또는 명령의 자세한 출력을 누군가가 필요하다고 한다면:

Sometimes it is necessary to redirect stderr to stdout so that error messages can be pasted as well. That can be done like this:

These return a link to a pastebin site page that can be easily shared with someone to get help.

붙여넣을때 고려해야 할 사항은:

하드웨어 문제 또는 커널 문제일 경우:


 * 포티지 문제일 경우:


 * 꾸러미 설치 문제일 경우:


 * Xorg 문제일 경우:


 * 시스템에 설치한 모든 꾸러미를 제공해야 할 경우:

Wrapping things together
Below is a shell function that can be used to have several commands executed and their output processed by a single wgetpaste</tt> command so that only one URL needs to be provided to the user or developer that wants to help out:

Please do not use pastebin services on the gentoo-user mailing list
Most pastebin services expire old pastes periodically (not to mention that pastebin services are hardly profitable, and close down all the time) whereas mailing list messages are archived in multiple places and are referenced for years. If the relevant output is short, or can be trimmed, then copy and paste it into the body of the email - longer output can be directed into a text file and added as a plain attachment.

해결책 정리
문제 설명문을 알기 쉽게 작성하고, 동작에 대한 모든 기록, 모든 종류의 디버깅 데이터(세부 문제, 하드웨어 / 소프트웨어 정보, 로그, 백트레이스 등) 를 포함한 쓸만한 데이터 모음을 바람직하게 모아두면 해결책을 찾아볼 수 있습니다:

해결책을 찾으려면 다음 과정을 반복합니다:


 * Get an idea where the problem might be, think about possible causes.
 * If there are no obvious areas to look into, become more acquainted with the related areas or ask an expert more about it.
 * Sometimes it is necessary to make assumptions to proceed. When assumptions are made, put it to the test: false assumptions should not make users and developers blind of other causes.
 * Obtain additional debugging information in the area of a problem, or perform tests.

Often this will lead to multiple possible causes. It is important to test them (to verify it is the actual cause or not) and therefore test them individually; this is also known as "divide and conquer".

Let's say a problem like "my browser sometimes displays white pages when I boot" comes up and a lot of details are already known about it, then there may be number of possible causes:


 * Is this because the browser was improperly closed when the system rebooted?
 * Verify this by killing the process and pulling the plug several times, each time checking if the pages are white after booting again. If this is a cause, is it the actual cause or are there other causes?


 * Is this the result of a specific browser version being broken?
 * Try older or newer versions for a few days or reboots and see if they are broken as well.

등등...

With the additional information, dare to think about more specific causes:


 * Does a certain pinned tab X that loads plugin Y break the system?
 * Unpin the tab so it doesn't open on launch anymore or disable the plugin, see if this keeps the problem away.


 * Graphical issues were reported as well, might this maybe mean this is caused by the video drivers?
 * Try a different version for those drivers, or alternative drivers if available.

As each possible cause is investigated, the actual cause of the problem might come closer and closer.

And in the end, if the cause is still not found, the Where to get help resources at the top of this article yield a multitude of places with people that are looking forward to help; make them happy with a careful problem description and mentioning what has already been tried so far, it'll help them help out.