一般的なトラブルシューティング - 版の履歴

Kusanaginoturugi: カテゴリの変更

2025-08-09T08:40:23Z

カテゴリの変更

← 古い版		2025年8月9日 (土) 17:40時点における版
1行目:		1行目:
	[[Category:シス~~テム管理~~]]		[[Category:Arch の入手とインストール]]
	[[Category:システムリカバリ]]		[[Category:システムリカバリ]]
	[[en:General troubleshooting]]		[[en:General troubleshooting]]

Kusanaginoturugi: 校正（でき・出来）

2024-07-10T12:09:31Z

校正（でき・出来）

← 古い版		2024年7月10日 (水) 21:09時点における版
27行目:		27行目:

	# 何が問題ですか?		# 何が問題ですか?
	#: 出来る限り正確に把握してください。特定の情報を確認するときに、混乱したり横道にそれるのを防ぐためです。		#: できる限り正確に把握してください。特定の情報を確認するときに、混乱したり横道にそれるのを防ぐためです。
	# エラーメッセージは存在しますか?		# エラーメッセージは存在しますか?
	#: 問題に関連するエラーメッセージを含んでいる出力を全て、{{ic\|$HOME/issue.log}} などのファイルにコピーアンドペーストしてください。例えば、[[mkinitcpio]] コマンドの出力を {{ic\|$HOME/issue.log}} に書き出すには以下のようにします:		#: 問題に関連するエラーメッセージを含んでいる出力を全て、{{ic\|$HOME/issue.log}} などのファイルにコピーアンドペーストしてください。例えば、[[mkinitcpio]] コマンドの出力を {{ic\|$HOME/issue.log}} に書き出すには以下のようにします:

AshMyzk: /* リグレッションしてデバッグする */ タイトルを修正。リグレッションというのは"デグレード"とほぼ同じ意味です

2024-03-13T15:43:28Z

リグレッションしてデバッグする: タイトルを修正。リグレッションというのは"デグレード"とほぼ同じ意味です

← 古い版		2024年3月14日 (木) 00:43時点における版
172行目:		172行目:
	ただし、caps lock の LED が点灯している場合は、[[カーネルパニック]]が起こっていることを示している可能性があります。環境によっては、カーネルパニックが発生したときに TTY が表示されない場合があります。これは混乱を招き、他の種類のフリーズと勘違いしてしまうかもしれません。		ただし、caps lock の LED が点灯している場合は、[[カーネルパニック]]が起こっていることを示している可能性があります。環境によっては、カーネルパニックが発生したときに TTY が表示されない場合があります。これは混乱を招き、他の種類のフリーズと勘違いしてしまうかもしれません。

	== リグレッションしてデバッグする ==		== リグレッションをデバッグする ==

	{{Warning\|これは [[インストールガイド#インストールメディアの準備\|部分アップグレード]] を引き起こす傾向があり、この特定のケースでは必要悪となります。このシナリオによって正常な起動ができなくなる場合に備えて、慎重に作業を進め、[[インストールガイド#インストールメディアの準備\|システムを回復する方法]] を用意してください}}		{{Warning\|これは [[インストールガイド#インストールメディアの準備\|部分アップグレード]] を引き起こす傾向があり、この特定のケースでは必要悪となります。このシナリオによって正常な起動ができなくなる場合に備えて、慎重に作業を進め、[[インストールガイド#インストールメディアの準備\|システムを回復する方法]] を用意してください}}
180行目:		180行目:
	それでも問題が解決しない場合、問題をデバッグするかアプリケーションを [https://wiki.archlinux.org/title/Bisecting_bugs_with_Git bisect] して、バグが修正されるようにアップストリームのバグトラッカーに報告してください。		それでも問題が解決しない場合、問題をデバッグするかアプリケーションを [https://wiki.archlinux.org/title/Bisecting_bugs_with_Git bisect] して、バグが修正されるようにアップストリームのバグトラッカーに報告してください。

	{{Note\|カーネルはリグレッションしてデバッグするときに [[カーネル#リグレッションしてデバッグ\|違うアプローチ]] を必要とします。}}		{{Note\|カーネルはリグレッションをデバッグするときに [[カーネル#リグレッションをデバッグする\|違うアプローチ]] を必要とします。}}

	== カーネルのアップグレード後に一部の周辺機器が使用できない ==		== カーネルのアップグレード後に一部の周辺機器が使用できない ==

Kgx: /* リグレッションをデバッグする */ 同期

2024-03-12T18:46:03Z

リグレッションをデバッグする: 同期

← 古い版		2024年3月13日 (水) 03:46時点における版
172行目:		172行目:
	ただし、caps lock の LED が点灯している場合は、[[カーネルパニック]]が起こっていることを示している可能性があります。環境によっては、カーネルパニックが発生したときに TTY が表示されない場合があります。これは混乱を招き、他の種類のフリーズと勘違いしてしまうかもしれません。		ただし、caps lock の LED が点灯している場合は、[[カーネルパニック]]が起こっていることを示している可能性があります。環境によっては、カーネルパニックが発生したときに TTY が表示されない場合があります。これは混乱を招き、他の種類のフリーズと勘違いしてしまうかもしれません。

	== リグレッションをデバッグする ==		== リグレッションしてデバッグする ==

	{{Warning\|これは [[インストールガイド#インストールメディアの準備\|部分アップグレード]] を引き起こす傾向があり、この特定のケースでは必要悪となります。このシナリオによって正常な起動ができなくなる場合に備えて、慎重に作業を進め、[[インストールガイド#インストールメディアの準備\|システムを回復する方法]] を用意してください}}		{{Warning\|これは [[インストールガイド#インストールメディアの準備\|部分アップグレード]] を引き起こす傾向があり、この特定のケースでは必要悪となります。このシナリオによって正常な起動ができなくなる場合に備えて、慎重に作業を進め、[[インストールガイド#インストールメディアの準備\|システムを回復する方法]] を用意してください}}
180行目:		180行目:
	それでも問題が解決しない場合、問題をデバッグするかアプリケーションを [https://wiki.archlinux.org/title/Bisecting_bugs_with_Git bisect] して、バグが修正されるようにアップストリームのバグトラッカーに報告してください。		それでも問題が解決しない場合、問題をデバッグするかアプリケーションを [https://wiki.archlinux.org/title/Bisecting_bugs_with_Git bisect] して、バグが修正されるようにアップストリームのバグトラッカーに報告してください。

	{{Note\|カーネルはリグレッションしてデバッグするときに [[カーネル#リグレッションデバッグ\|違うアプローチ]] を必要とします。}}		{{Note\|カーネルはリグレッションしてデバッグするときに [[カーネル#リグレッションしてデバッグ\|違うアプローチ]] を必要とします。}}

	== カーネルのアップグレード後に一部の周辺機器が使用できない ==		== カーネルのアップグレード後に一部の周辺機器が使用できない ==

Kgx: 他言語へのリンクを追加

2024-03-12T18:42:48Z

他言語へのリンクを追加

← 古い版		2024年3月13日 (水) 03:42時点における版
3行目:		3行目:
	[[en:General troubleshooting]]		[[en:General troubleshooting]]
	[[es:General troubleshooting]]		[[es:General troubleshooting]]
			[[fr:General troubleshooting]]
			[[pt:General troubleshooting]]
	[[ru:General troubleshooting]]		[[ru:General troubleshooting]]
	[[zh-hans:General troubleshooting]]		[[zh-hans:General troubleshooting]]
18行目:		20行目:
	=== 注意事項 ===		=== 注意事項 ===

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

	=== チェックリスト ===		=== チェックリスト ===
24行目:		26行目:
	システムが機能しないときは以下の質問を考えてみてください。各質問の下には、なぜ質問に答えなければならないのか、詳しいデータを入手したりログやジャーナルを確認するにはどのツールを使えばいいのかを載せています。		システムが機能しないときは以下の質問を考えてみてください。各質問の下には、なぜ質問に答えなければならないのか、詳しいデータを入手したりログやジャーナルを確認するにはどのツールを使えばいいのかを載せています。

	# 何が問題ですか？		# 何が問題ですか?
	#: 出来る限り正確に把握してください。特定の情報を確認するときに、混乱したり横道にそれるのを防ぐためです。		#: 出来る限り正確に把握してください。特定の情報を確認するときに、混乱したり横道にそれるのを防ぐためです。
	# エラーメッセージは存在しますか？		# エラーメッセージは存在しますか?
	#: 問題に関連するエラーメッセージを含んでいる出力を全て、{{ic\|$HOME/issue.log}} などのファイルにコピーアンドペーストしてください。例えば、[[mkinitcpio]] コマンドの出力を {{ic\|$HOME/issue.log}} に書き出すには以下のようにします:		#: 問題に関連するエラーメッセージを含んでいる出力を全て、{{ic\|$HOME/issue.log}} などのファイルにコピーアンドペーストしてください。例えば、[[mkinitcpio]] コマンドの出力を {{ic\|$HOME/issue.log}} に書き出すには以下のようにします:
	#: {{bc\|$ mkinitcpio -p linux >> $HOME/issue.log''}}		#: {{bc\|$ mkinitcpio -p linux >> $HOME/issue.log''}}
	# 問題を再現できますか？		# 問題を再現できますか?
	#: 正確に、かつ手順毎に、再現に必要な操作やコマンドを抽出してください。		#: 正確に、かつ手順毎に、再現に必要な操作やコマンドを抽出してください。
	# 問題が発生し始めたのはいつからで、問題がなかったときから何を変えましたか？		# 問題が発生し始めたのはいつからで、問題がなかったときから何を変えましたか?
	#:アップデートによって問題が発生したのであれば、アップデートしたパッケージを全て挙げてください。バージョン番号や、[[pacman]].log に出力されたテキスト ({{ic\|/var/log/pacman.log}}) も重要です。また、[[systemd]] の systemctl ツールを使って問題のアプリケーションを使うのに必要なサービスの状態を確認してください。例えば、以下の [[Systemd#systemctl の基本的な使い方\|systemd]] コマンドは {{ic\|$HOME/issue.log}} にサービスの状態を書き込みます:		#:アップデートによって問題が発生したのであれば、アップデートしたパッケージを全て挙げてください。バージョン番号や、[[pacman]].log に出力されたテキスト ({{ic\|/var/log/pacman.log}}) も重要です。また、[[systemd]] の systemctl ツールを使って問題のアプリケーションを使うのに必要なサービスの状態を確認してください。例えば、以下の [[Systemd#systemctl の基本的な使い方\|systemd]] コマンドは {{ic\|$HOME/issue.log}} にサービスの状態を書き込みます:
	#: {{bc\|$ systemctl status dhcpcd@eth0.service >> $HOME/issue.log}}		#: {{bc\|$ systemctl status dhcpcd@eth0.service >> $HOME/issue.log}}
119行目:		121行目:
	==== netconsole ====		==== netconsole ====

	[https://docs.kernel.org/networking/netconsole.html netconsole] は、カーネルモジュールで、すべてのカーネルログメッセージ（つまり、~~dmesg）~~をユーザースペース（例えば、~~syslogd）~~を介さずに別のコンピューターにネットワーク経由で送信します。"netconsole" という名前は誤称で、実際には "コンソール" ではなく、リモートログサービスのようなものです。		[https://docs.kernel.org/networking/netconsole.html netconsole] は、カーネルモジュールで、すべてのカーネルログメッセージ(つまり、dmesg)をユーザースペース(例えば、syslogd)を介さずに別のコンピューターにネットワーク経由で送信します。"netconsole" という名前は誤称で、実際には "コンソール" ではなく、リモートログサービスのようなものです。

	これは、組み込みまたはモジュールとして使用できます。組み込みの ''netconsole'' は、NICカードの直後に初期化し、指定したインターフェースをできるだけ早く起動します。このモジュールは主に、ヘッドレスマシンからのカーネルパニック出力をキャプチャするため、またはユーザースペースが機能しなくなった他の状況で使用されます。		これは、組み込みまたはモジュールとして使用できます。組み込みの ''netconsole'' は、NICカードの直後に初期化し、指定したインターフェースをできるだけ早く起動します。このモジュールは主に、ヘッドレスマシンからのカーネルパニック出力をキャプチャするため、またはユーザースペースが機能しなくなった他の状況で使用されます。

Kgx: /* パッケージ管理 */ 壊れたシステムを修復するを翻訳して追加

2024-03-12T18:39:19Z

パッケージ管理: 壊れたシステムを修復するを翻訳して追加

← 古い版		2024年3月13日 (水) 03:39時点における版
196行目:		196行目:

	一般的な問題については [[Pacman#トラブルシューティング]]を、PGP 鍵に関する問題は [[pacman-key#トラブルシューティング]]を見てください。		一般的な問題については [[Pacman#トラブルシューティング]]を、PGP 鍵に関する問題は [[pacman-key#トラブルシューティング]]を見てください。

			=== 壊れたシステムを修復する ===

			[[部分アップグレード]] が実行された場合は、システム全体をアップデートしてみてください。再起動が必要になる場合があります。

			# pacman -Syu

			GUI で起動していて、それが失敗する場合は、{{ic\|Ctrl+Alt+F1}} から {{ic\|Ctrl+Alt+F6}} を押して、動作中の tty にアクセスして ''pacman'' を実行できます。

			システムが壊れて ''pacman'' を実行できない場合は、[[インストールガイド#インストールの準備\|Arch ISO を USB フラッシュドライブ、光ディスク、または PXE を使用したネットワークから起動します。]] (インストールガイドの残りの部分には従わないでください。)

			root ファイルシステムをマウントします:

			[ISO] # mount /dev/''rootFileSystemDevice'' /mnt

			個別に作成した他のパーティションをマウントし、すべてのパーティションにプレフィックス {{ic\|/mnt}} を追加します。つまり、次のようになります:

			[ISO] # mount /dev/''bootDevice'' /mnt/boot

			システムの ''pacman'' を使用してみてください:

			[ISO] # arch-chroot /mnt
			[chroot] # pacman -Syu

			失敗した場合は、''chroot'' を終了して、次のことを試してください:

			[ISO] # pacman -Syu --sysroot /mnt

			失敗した場合は、次のことを試してください:

			[ISO] # pacman -Syu --root /mnt --cachedir /mnt/var/cache/pacman/pkg

	== fuser ==		== fuser ==

AshMyzk: /* 共有ライブラリのロード時にエラーが発生する */ セクション名を英語版と同じに

2023-08-10T05:21:01Z

共有ライブラリのロード時にエラーが発生する: セクション名を英語版と同じに

← 古い版		2023年8月10日 (木) 14:21時点における版
217行目:		217行目:
	基本的な [[polkit]] のアクションはそれ以上の設定を必要としませんが、ローカルセッションだけでなく他の認証を必要とする polkit アクションも存在します。認証するには polkit 認証エージェントを実行する必要があります。詳しくは [[polkit#認証エージェント]]を見て下さい。		基本的な [[polkit]] のアクションはそれ以上の設定を必要としませんが、ローカルセッションだけでなく他の認証を必要とする polkit アクションも存在します。認証するには polkit 認証エージェントを実行する必要があります。詳しくは [[polkit#認証エージェント]]を見て下さい。

			== "error while loading shared libraries" というメッセージ ==
	== 共有ライブラリのロード時にエラーが発生する ==

	プログラムを使用しようとすると、以下のようなエラーが出力される場合:		プログラムを使用しようとすると、以下のようなエラーが出力される場合:

AshMyzk: /* file: could not find any magic files! */ 削除

2023-08-10T05:19:40Z

file: could not find any magic files!: 削除

← 古い版		2023年8月10日 (木) 14:19時点における版
233行目:		233行目:

	インストールしたプログラムのパッケージの [[PKGBUILD]] に依存パッケージとしてライブラリが記載されていないという可能性もあります。公式パッケージの場合、[[バグ報告ガイドライン\|バグとして報告]]してください。[[AUR]] のパッケージの場合、AUR のウェブサイトからメンテナに報告してください。		インストールしたプログラムのパッケージの [[PKGBUILD]] に依存パッケージとしてライブラリが記載されていないという可能性もあります。公式パッケージの場合、[[バグ報告ガイドライン\|バグとして報告]]してください。[[AUR]] のパッケージの場合、AUR のウェブサイトからメンテナに報告してください。

	== file: could not find any magic files! ==

	''例:'' パッケージのアップデートやインストールを行った後に以下のエラーが表示される:
	# file: could not find any magic files!
	上記が表示されるときはシステムが破損しています。問題のあるパッケージを再コンパイル・再インストールしようとしても無駄です。また、[[initramfs]] を再生成しようとすると以下のように出力されます:
	# 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'

	大抵の場合、前にインストールしたアプリケーションによって {{ic\|/etc/ld.so.conf.d/}} に作成された設定ファイルや {{ic\|/etc/ld.so.conf}} に加えられた変更に問題があります。以下の手順で解決できます:
	#Arch Linux のライブ CD / インストールメディアを起動。
	#ルートパーティション ({{ic\|'''/'''}}) を {{ic\|/mnt}} にマウントして [[Change Root#arch-chroot を使う\|arch-chroot]] を使ってシステムに [[chroot]]。
	{{Note\|[[Change Root#arch-chroot を使う\|arch-chroot]] では {{ic\|/boot}} パーティションのマウントはユーザーが行う必要があります。}}
	#{{ic\|/etc/ld.so.conf}} を編集して問題のある行を削除する。
	#{{ic\|/etc/ld.so.conf.d/}} ディレクトリ内のファイルを確認して問題のあるファイルを削除する。
	#[[initramfs]] を再生成:
	# mkinitcpio -p linux
	#再起動する。
	#起動したら、問題のあるパッケージを再インストール:
	# pacman -S <package>

	== 参照 ==		== 参照 ==

AshMyzk: /* リグレッションデバッグ */ セクション名を修正

2023-08-10T05:16:24Z

リグレッションデバッグ: セクション名を修正

← 古い版		2023年8月10日 (木) 14:16時点における版
170行目:		170行目:
	ただし、caps lock の LED が点灯している場合は、[[カーネルパニック]]が起こっていることを示している可能性があります。環境によっては、カーネルパニックが発生したときに TTY が表示されない場合があります。これは混乱を招き、他の種類のフリーズと勘違いしてしまうかもしれません。		ただし、caps lock の LED が点灯している場合は、[[カーネルパニック]]が起こっていることを示している可能性があります。環境によっては、カーネルパニックが発生したときに TTY が表示されない場合があります。これは混乱を招き、他の種類のフリーズと勘違いしてしまうかもしれません。

	== リグレッションデバッグ ==		== リグレッションをデバッグする ==

	{{Warning\|これは [[インストールガイド#インストールメディアの準備\|部分アップグレード]] を引き起こす傾向があり、この特定のケースでは必要悪となります。このシナリオによって正常な起動ができなくなる場合に備えて、慎重に作業を進め、[[インストールガイド#インストールメディアの準備\|システムを回復する方法]] を用意してください}}		{{Warning\|これは [[インストールガイド#インストールメディアの準備\|部分アップグレード]] を引き起こす傾向があり、この特定のケースでは必要悪となります。このシナリオによって正常な起動ができなくなる場合に備えて、慎重に作業を進め、[[インストールガイド#インストールメディアの準備\|システムを回復する方法]] を用意してください}}

AshMyzk: /* カーネルのアップグレード後に一部の周辺機器が使用できない */ 修正

2023-07-10T02:58:08Z

カーネルのアップグレード後に一部の周辺機器が使用できない: 修正

← 古い版		2023年7月10日 (月) 11:58時点における版
191行目:		191行目:
	[[システムメンテナンス#アップグレード後に再起動]] で部分的に説明されている通り、カーネルのパッケージをアップデートしたとしても、再起動しない限り、カーネル自体はアップデートされません。一方、{{ic\|/usr/lib/modules/''kernelversion''/}} 内のカーネルモジュールは、新しいカーネルがインストールされた際に pacman によって削除されます。{{Bug\|16702}} で説明されている通り、この方法により、パッケージマネージャによって管理されないファイルをシステム上に残留させてしまうことを防ぐことができますが、先に挙げたような症状を引き起こしてしまいます。この問題を解決するには、カーネルのアップデート後に計画的に再起動してください。将来的には (まだ、実装されていませんが)、バージョン管理されたカーネルパッケージを使用することになるでしょう: 主な障害は、もはや必要とされなくなった以前のカーネルバージョンの削除をどう処理するかにあります。		[[システムメンテナンス#アップグレード後に再起動]] で部分的に説明されている通り、カーネルのパッケージをアップデートしたとしても、再起動しない限り、カーネル自体はアップデートされません。一方、{{ic\|/usr/lib/modules/''kernelversion''/}} 内のカーネルモジュールは、新しいカーネルがインストールされた際に pacman によって削除されます。{{Bug\|16702}} で説明されている通り、この方法により、パッケージマネージャによって管理されないファイルをシステム上に残留させてしまうことを防ぐことができますが、先に挙げたような症状を引き起こしてしまいます。この問題を解決するには、カーネルのアップデート後に計画的に再起動してください。将来的には (まだ、実装されていませんが)、バージョン管理されたカーネルパッケージを使用することになるでしょう: 主な障害は、もはや必要とされなくなった以前のカーネルバージョンの削除をどう処理するかにあります。

	もう一つの解決策は、{{Pkg\|kernel-modules-hook}} を使うことです。2の pacman フックが含まれており、rsync を使ってカーネルアップデート後にカーネルモジュールをファイルシステム上に保持し、[[有効化]]されてから4週間後に削除すべき古いモジュールをマークする {{ic\|linux-modules-cleanup.service}} を使用します。		もう一つの解決策は、{{Pkg\|kernel-modules-hook}} を使うことです。2つの pacman フックが含まれており、rsync を使ってカーネルアップデート後にカーネルモジュールをファイルシステム上に保持し、[[有効化]]されてから4週間後に削除すべき古いモジュールをマークする {{ic\|linux-modules-cleanup.service}} を使用します。

	== パッケージ管理 ==		== パッケージ管理 ==