「インストールできません」と「起動しません」は、別の問題です。
ところが現場では、どちらも「動きません」という一言で報告されます。入れられなかったのか、入ったのに立ち上がらないのか。 ここを分けないまま、再インストール・再起動・管理者で実行を順番に試すことになり、直ったとしても何が原因だったのか誰も分からないまま終わります。
この記事は、わざと失敗させて、そのときどこに何が残るかを確かめる手順です。ログの出し方さえ知っていれば、たいていのインストール失敗は数分で理由が分かります。
対象レベル: 中級 / 区分: 必要に応じて読む
この記事でわかること
- インストールと起動を分ける——最初の分岐がここであること
- インストーラが詳細なログを出せること、その読みどころ
- 失敗の原因が5つに収まること
- サービスが開始してすぐ止まるときに見る場所
- 使ってはいけない調べ方があること
この記事でやること
- インストールと起動を切り分ける
- インストーラに詳細ログを出させる(山場①)
- 入っているものを、正しい方法で一覧する
- サービスをわざと起動できなくして、症状を作る(山場②)
- ポートの取り合いを、実際に起こして確かめる(山場③)
先に知る言葉
この記事で初めて出てくる言葉です。 詳しくは用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| msiexec | Windows のインストーラを動かすプログラム。ログを出させられる |
| イベントログ | Windows が起きたことを記録している場所 |
| サービス | 画面を持たず、裏で動き続けるプログラム |
| 依存関係 | これが動くには、あれが要るという関係 |
最初の分岐 —— どちらの問題か
| 症状 | どちらか | 次に見る場所 |
|---|---|---|
| 途中でエラーになって終わる | インストール | インストーラのログ |
| 「正常に完了」なのに何も無い | インストール | ログの後半(巻き戻し) |
| 入ったが、起動して即終了 | 起動 | アプリケーションログ |
| サービスが開始してすぐ停止 | 起動 | 依存関係とアカウント |
| 起動はするが繋がらない | 起動の後 | ポートとファイアウォール |
「正常に完了しました」と出たのに何も入っていないは、実際に起こります。インストーラは途中で失敗すると、それまでの作業を巻き戻してから成功を返すことがあるためです。この場合、画面には何のヒントも出ません。ログにしか残りません。
① インストーラに詳細ログを出させる
Windows のインストーラは、頼めば全部書き出します。 これを知らないまま推測で直そうとするのが、いちばんの遠回りです。
| 指定 | 意味 |
|---|---|
/i | インストールする |
/l*v | すべてを詳細に記録する |
/x | アンインストールする |
/qn | 画面を出さない(無人インストール) |
ログの読みどころは3つだけ
Action ended 03:14:22: InstallFiles. Return value 3.
| 探す言葉 | 意味 |
|---|---|
Return value 3 | ここで失敗した。 直前の数行に理由がある |
Rollback | 巻き戻しが始まった位置 |
Error 1603 | 致命的なエラー。原因ではなく結果 |
1603を検索しても答えは出てきません。 これは「何かに失敗した」という総称で、原因は人それぞれです。探すのはReturn value 3のほうで、その直前の十数行に本当の理由——権限が無い、ファイルが使用中、前提が足りない——が書かれています。
② 失敗の原因は、だいたい5つに収まる
| # | 原因 | 確かめ方 |
|---|---|---|
| 1 | 管理者で実行していない | 昇格したウィンドウで打ち直す |
| 2 | 前提のランタイムが無い | 後述の一覧で確認する |
| 3 | ディスクの空きが足りない | 作業領域も要る点に注意 |
| 4 | ファイルがブロックされている | 別PCから持ち込んだファイル |
| 5 | 対象のOSやエディションが違う | 要件を読み直す |
容量とOSの2つは、失敗してから気づくと痛いものです。 インストールには、入れたい容量そのものより大きな作業領域が要ります。展開のために一時フォルダを使い、終わってから消すためです。空きが不足すると、途中まで書いてから巻き戻ります。またエディションの条件は要件表の隅に書かれていることが多く、Server 版でだけ入らない、逆に Server 版でしか入らないという製品が実際にあります。入る前に読んでください。
ブロックの解除 —— 見落としやすい定番
インターネットや別のPCから持ち込んだファイルには、印が付きます。 Windows はこの印を見て実行を止めます。エラーの文面は「アクセスが拒否されました」になるので、権限の問題だと誤解されがちです。 上のコマンドで印の有無が分かります。
管理者で実行しているか
True でなければ、そこから先は全部無駄になります。 「管理者として実行」で開いたつもりでも、別のウィンドウで打っていることがあります。推測せず、1行で確かめてください。
③ 入っているものを、正しい方法で一覧する
製品一覧を取る古い方法(
Win32_Product)は使わないでください。 一覧を出すだけのつもりでも、インストール済みの製品すべてに整合性の検査を走らせます。 数分固まるうえ、イベントログが「再構成しました」で埋まります。本番サーバーで打つと、それ自体が障害の引き金になります。
32ビットと64ビットで、置き場所が2つある
「一覧に出てこないので入っていない」と判断すると間違えます。 32ビット向けの製品は別の場所に登録されるためです。上のコマンドが2か所を見ているのは、この理由です。前提ランタイムを確認するときも、両方を見ないと「入っていない」と誤診します。
④ サービスをわざと起動できなくする
学習用の VM で実施してください。 「開始してすぐ停止する」という、最も分かりにくい症状を自分で作ります。
# 実在しない実行ファイルを指すサービスを登録する
PS> New-Service -Name TestBroken -BinaryPathName "C:\nowhere\missing.exe" -DisplayName "TEST broken"
PS> Start-Service TestBroken
理由を、順番に確かめます。
| ID | 意味 | 疑うこと |
|---|---|---|
| 7000 | サービスを開始できなかった | 実行ファイル・権限 |
| 7001 | 依存するサービスが開始できない | 依存先を先に直す |
| 7009 | 接続待ちがタイムアウトした | 起動が遅い・止まっている |
| 7024 | 固有のエラーで終了した | アプリ側のログを見る |
7024 が出たら、Windows 側の話は終わりです。 サービスは起動し、アプリが自分で判断して終了した、という意味だからです。ここから先はアプリケーションログと、そのアプリ自身のログを見ます。ここを取り違えると、Windows の設定をいくら触っても直りません。
ログオンアカウントで落ちている場合
サービスは、指定されたアカウントの権限で動きます。 手で実行すると動くのにサービスだと動かない、という症状の多くはこれです。そのアカウントが対象のフォルダを読めるか、ネットワーク先へ届くかを確かめてください。パスワードを変更したあとに止まるのも、同じ理由です。
⑤ ポートの取り合いを起こす
# 何かが 8080 を掴んでいる状態を作る
PS> Start-Process powershell -ArgumentList '-NoExit','-Command',
PS> '$l=[System.Net.Sockets.TcpListener]8080; $l.Start(); Write-Host 8080 held'
この状態で、同じポートを使うものを起動すると失敗します。誰が掴んでいるかを特定します。
プロセス番号から名前まで、2行でたどれます。 「起動したのに繋がらない」の相当数が、これか、ファイアウォールです。起動できないのか、起動はしたが届かないのかを、ここで分けてください。
Linux の場合 —— 見る場所は同じ考え方
| 症状 | まず疑う |
|---|---|
status=203/EXEC | 実行ファイルのパスが違う・実行権が無い |
status=200/CHDIR | 作業ディレクトリが無い |
すぐ inactive (dead) | Type の指定違い(常駐しない) |
| Address already in use | ポートの取り合い |
終了コードが原因を名前で教えてくれます。 Windows のイベント ID と同じ役割です。どちらの OS でも、「起動の枠組みで落ちたのか、アプリ自身が落ちたのか」を先に分けるのが要点です。
Linux では、失敗の理由が終了コードとして数字で残ります。 サービスの状態を見れば、実行ファイルが見つからなかったのか、作業ディレクトリが無かったのか、アプリ自身が終了したのかが、その場で分かれます。推測でユニットファイルを書き換える前に、まず状態を1行見てください。 Windows でイベント ID を見るのと、やっていることは同じです。
切り分けの順番(この表だけ覚える)
| # | 問い | 調べる手 |
|---|---|---|
| 1 | 入れられないのか、起動しないのか | 一覧に出るかを見る |
| 2 | (入れられない)どこで失敗したか | 詳細ログの Return value 3 |
| 3 | 権限・ブロック・前提・容量 | 5つの原因表を上から |
| 4 | (起動しない)誰が止めたか | イベント 7000/7001/7024 |
| 5 | アプリが自分で終了したか | アプリケーションログとアプリのログ |
| 6 | 起動はしたが届かないのか | ポートとファイアウォール |
完成の判定
| # | 確かめること | 合格の形 |
|---|---|---|
| 1 | 詳細ログを出せた | ログに失敗位置が残った |
| 2 | 一覧を安全な方法で取れた | 2か所を見た |
| 3 | 起動できない状態を作れた | イベント 7000 が出た |
| 4 | 依存とアカウントを読めた | 実行ファイルと実行者が分かる |
| 5 | ポートの持ち主を特定できた | プロセス名まで辿れた |
つまずいたところ
再インストールしたら直った
原因は分かっていません。 同じことが別の台でも起きたとき、また同じ時間を使います。せめて詳細ログだけは取ってから入れ直してください。ログさえ残っていれば、後から理由を確定できます。
手で実行すると動くのに、サービスにすると動かない
実行するアカウントが違います。 自分は管理者、サービスは別のアカウント、という状態です。そのアカウントでフォルダを読めるか、ネットワーク先へ届くかを確かめてください。権限まわりの問題は、ほぼこの形で現れます。
「正常に完了」なのに、プログラムが無い
途中で失敗して巻き戻したあと、成功を返しています。 ログで Rollback を探してください。その少し前に、本当の失敗が記録されています。画面の表示は当てになりません。
一覧を取ろうとしてサーバーが固まった
古い方法(Win32_Product)を使っています。 一覧を出すだけのつもりが、全製品の検査を走らせています。この記事で使ったレジストリを読む方法に切り替えてください。読むだけで、副作用がありません。
後片づけ
ポートを掴ませたウィンドウは閉じてください。練習で作ったサービスを消し忘れると、次に誰かが調べたときに偽の手がかりになります。
よくある質問
- エラー1603で検索しても、解決策が見つかりません
- 1603は「何かに失敗した」という総称で、原因を特定していないからです。検索する対象を変えてください。詳細ログを出して Return value 3 を探し、その直前の十数行を読むと、権限が足りない、ファイルが使用中、前提が入っていない、といった本当の理由が書かれています。検索するなら、そこに出た具体的な文言のほうです。
- インストールしたのに、プログラムの一覧に出てきません
- 登録先が2か所あるためです。32ビット向けの製品は64ビット版とは別の場所に登録されるので、片方だけを見ると「入っていない」と誤診します。この記事のコマンドは両方を見ています。それでも出ない場合は、インストールが巻き戻された可能性があるので、詳細ログでRollbackを探してください。
- サービスが開始してすぐ停止します。どこから見ますか
- まずシステムログのイベントIDを確認してください。7000なら実行ファイルや権限、7001なら依存するサービス、7024ならアプリ自身が終了したという意味です。7024が出ている場合、Windows側の設定をいくら触っても直りません。アプリケーションログと、そのアプリが独自に出力しているログへ移ってください。
- Win32_Productを使ってはいけないのは、なぜですか
- 一覧を取得するだけの操作に見えて、実際にはインストール済みの全製品に対して整合性の検査を走らせるためです。処理が数分止まるうえ、イベントログが再構成の記録で埋まります。本番サーバーでは、それ自体が障害の引き金になり得ます。レジストリのアンインストール情報を読む方法なら、読み取りだけで副作用がありません。
- 「アクセスが拒否されました」と出たら、権限の問題ですか
- とは限りません。別のPCやインターネットから持ち込んだファイルには印が付いており、Windowsがそれを見て実行を止めることがあります。この場合も同じ文面になります。管理者で実行しているかを1行で確認したうえで、ファイルの印の有無も確かめてください。印が原因なら、解除するだけで進みます。
まとめ — 理解できたこと
- まず「入らない」か「起動しない」かを分ける
- インストーラは頼めば全部書き出す。 探すのは
Return value 3 - 1603 は結果であって原因ではない
- 一覧は2か所ある。 片方だけ見ると誤診する
- イベント 7024 が出たら、Windows の話は終わり。 アプリ側を見る
- 手で動くのにサービスで動かないのは、実行するアカウントの違い
参考リンク
次に読む
この記事は 【番外編】roadmap.sh の外 の 8 / 35 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。

コメント