一般的なトラブルシューティング

関連記事

• バグ報告ガイドライン
• ステップバイステップデバッグガイド
• デバッグ - トレースを取得
• ブートデバッグ
• IRC 共同デバッグ

この記事では一般的なトラブルシューティングの方法を説明しています。特定のアプリケーションの問題については、そのプログラムの wiki ページを参照してください。

注意事項

抱えている問題を解決するには、問題のシステムがどう機能しているのかを根本的に理解することが不可欠です。どうやって動いているのか、またエラーを起こさずに動作させるには何が必要なのか？質問に答えるのが用意ではないという場合、問題が発生している機能に関する Archwiki の記事を見ることを強く推奨します。問題のシステムを理解すれば、問題を突き止めるのが楽になるでしょう。

チェックリスト

The following gives a number of questions for you whenever dealing with a malfunctioning system. Under each question there are notes explaining how you should be answering each question, followed by some light examples on how to easily gather data output and what tools can be used to review logs and the journal.

1. 何が問題ですか？

   出来る限り正確に把握してください。特定の情報を確認するときに、混乱したり横道にそれるのを防ぐためです。

2. エラーメッセージは存在しますか？

   Copy and paste full outputs that contain error messages related to your issue into a separate file, such as $HOME/issue.log. For example, to forward the output of the following mkinitcpio command to $HOME/issue.log:

   $ mkinitcpio -p linux >> $HOME/issue.log

3. 問題を再現できますか？

   If so, give exact step-by-step instructions/commands needed to do so.

4. When did you first encounter these issues and what was changed between then and when the system was operating without error?

   If it occurred right after an update then, list all packages that were updated. Include version numbers, also, paste the entire update from pacman.log (/var/log/pacman.log). Also take note of the statuses of any service(s) needed to support the malfunctioning application(s) using systemd's systemctl tools. For example, to forward the output of the following systemd command to $HOME/issue.log:

   $ systemctl status dhcpcd@eth0.service >> $HOME/issue.log

   ノート: Using >> will ensure any previous text in $HOME/issue.log will not be overwritten.

問題の特定

問題を解決しようとするとき、以下のようなアプローチを取ってはいけません:

アプリケーション X が動作しない。

そうではなくて、正確に観察をしましょう:

A または B の状態のときにアプリケーション X を使って作業 Y を行うと Z というエラーが発生する。

他者のサポート

全ての情報はあなたの目の前にあります。あなたのシステムで何が起きてるのか一番良く知ってるのはあなたのはずです。適切な修正を試みて下さい。

他者のサポートが必要なときは、フォーラム や irc.freenode.net の IRC #archlinux で得ることができるでしょう。

セッションのパーミッション

ノート: ローカルセッションを動作させるには init システムとして systemd を使う必要があります。systemd は polkit のパーミッションや様々なデバイスの ACL を使うのに必須です (/usr/lib/udev/rules.d/70-uaccess.rules や [1] を参照)。

まず、X の中に有効なローカルセッションがあることを確認してください:

$ loginctl show-session $XDG_SESSION_ID

このコマンドの出力に Remote=no と Active=yes が含まれていなければなりません。含まれていない場合は、X がログインを行った tty と同一の tty で動作していることを確認してください。logind セッションを維持するために tty が同一である必要があります。このことはデフォルトの /etc/X11/xinit/xserverrc によって管理されています。

D-Bus セッションも X と一緒に起動する必要があります。詳しくは D-Bus#ユーザーセッションの起動 を見て下さい。

基本的な polkit のアクションはそれ以上の設定を必要としませんが、ローカルセッションだけでなく他の認証を必要とする polkit アクションも存在します。認証するには polkit 認証エージェントを実行する必要があります。詳しくは polkit#認証エージェント を見て下さい。

起動時の問題

ブートデバッグを見て下さい。

file: could not find any magic files!

Example: After an every-day routine update or following the installation of a package you are given the following error:

# file: could not find any magic files!

This will most likely leave your system crippled. And, any attempts made to recompile/reinstall the package(s) responsible for the breakage will fail. Also, any attempts made to try to rebuild the initramfs will result in the following:

# mkinitcpio -p linux
==> Building image from preset: 'default'
 -> -k /boot/vmlinuz-linux -c /etc/mkinitcpio.conf -g /boot/initramfs-linux.img
file: could not find any magic files!
==> ERROR: invalid kernel specifier: `/boot/vmlinuz-linux'
==> Building image from preset: 'fallback'
 -> -k /boot/vmlinuz-linux -c /etc/mkinitcpio.conf -g /boot/initramfs-linux-fallback.img -S autodetect
file: could not find any magic files!
@==> ERROR: invalid kernel specifier: `/boot/vmlinuz-linux'

Typically a previously installed application had placed a configuration file within /etc/ld.so.conf.d/ or it had made changes to /etc/ld.so.conf which are now invalid.

1. Boot into the Arch Linux Live CD / Installation Media.
2. Mount your root (/) partition to /mnt and using arch-chroot, chroot into your system.

ノート: arch-chroot leaves mounting the /boot partition up to the user.

1. Examine /etc/ld.so.conf and remove any invalid lines found.
2. Examine the files located inside the directory /etc/ld.so.conf.d/ and remove all invalid files.
3. Rebuild the initramfs.

# mkinitcpio -p linux

1. Reboot back to your installed system.
2. Once booted, reinstall the package that was responsible for leaving your system inoperable using:

# pacman -S <package>

fuser

fuser はファイルやファイルシステム、TCP/UDP ポートなどのリソースを使ってプロセスを確認するためのコマンドラインユーティリティです。

fuser は psmisc パッケージに入っており、このパッケージは base グループの一部として既にインストールされているはずです。

NTFS パーティションに書き込みできない

標準では、NTFS ファイルシステムの読み込みしか出来ないようになっています。書き込みを行いたい場合は、ntfs-3g パッケージをインストールしてください。

Spellcheck を実行するとテキストが全部ミス判定されてしまう

aspell 辞書はインストールされていますか? pacman -Ss aspell を実行して、入手可能な辞書を確認してください。

インストールされている辞書は aspell dicts で確認できます:

$ aspell dicts

 en
 en_GB
 ...etc

aspell および辞書がインストールされていても問題が解決しない場合、enchant が原因かもしれません。/usr/share/enchant/enchant.ordering を確認し、目的の言語が期待した設定になっているか確認してください。

参照

• Fix the Most Common Problems
• A how-to in troubleshooting for newcomers