インストール失敗とサービスが起動しない原因|msiexecのログとイベントID 7000

インストール失敗と起動エラー。ソフトウェアの箱、歯車、ログを調べる虫眼鏡。

「インストールできません」と「起動しません」は、別の問題です。

ところが現場では、どちらも「動きません」という一言で報告されます。入れられなかったのか、入ったのに立ち上がらないのか。 ここを分けないまま、再インストール・再起動・管理者で実行を順番に試すことになり、直ったとしても何が原因だったのか誰も分からないまま終わります。

この記事は、わざと失敗させて、そのときどこに何が残るかを確かめる手順です。ログの出し方さえ知っていれば、たいていのインストール失敗は数分で理由が分かります。

対象レベル: 中級 / 区分: 必要に応じて読む

目次

この記事でわかること

  • インストールと起動を分ける——最初の分岐がここであること
  • インストーラが詳細なログを出せること、その読みどころ
  • 失敗の原因が5つに収まること
  • サービスが開始してすぐ止まるときに見る場所
  • 使ってはいけない調べ方があること

この記事でやること

  1. インストールと起動を切り分ける
  2. インストーラに詳細ログを出させる(山場①)
  3. 入っているものを、正しい方法で一覧する
  4. サービスをわざと起動できなくして、症状を作る(山場②)
  5. ポートの取り合いを、実際に起こして確かめる(山場③)

先に知る言葉

この記事で初めて出てくる言葉です。 詳しくは用語集にもまとめてあります。

言葉意味
msiexecWindows のインストーラを動かすプログラム。ログを出させられる
イベントログWindows が起きたことを記録している場所
サービス画面を持たず、裏で動き続けるプログラム
依存関係これが動くには、あれが要るという関係

最初の分岐 —— どちらの問題か

症状どちらか次に見る場所
途中でエラーになって終わるインストールインストーラのログ
「正常に完了」なのに何も無いインストールログの後半(巻き戻し)
入ったが、起動して即終了起動アプリケーションログ
サービスが開始してすぐ停止起動依存関係とアカウント
起動はするが繋がらない起動の後ポートとファイアウォール

「正常に完了しました」と出たのに何も入っていないは、実際に起こります。インストーラは途中で失敗すると、それまでの作業を巻き戻してから成功を返すことがあるためです。この場合、画面には何のヒントも出ません。ログにしか残りません。

① インストーラに詳細ログを出させる

Windows のインストーラは、頼めば全部書き出します。 これを知らないまま推測で直そうとするのが、いちばんの遠回りです。

PowerShell
PS> msiexec /i C:\work\app.msi /l*v C:\work\install.log
指定意味
/iインストールする
/l*vすべてを詳細に記録する
/xアンインストールする
/qn画面を出さない(無人インストール)

ログの読みどころは3つだけ

PowerShell
PS> Select-String -Path C:\work\install.log -Pattern "Return value 3" -Context 12,2
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 版でしか入らないという製品が実際にあります。入る前に読んでください。

ブロックの解除 —— 見落としやすい定番

PowerShell
PS> Get-Item C:\work\app.msi -Stream * | Select-Object Stream, Length
PS> Unblock-File C:\work\app.msi

インターネットや別のPCから持ち込んだファイルには、印が付きます。 Windows はこの印を見て実行を止めます。エラーの文面は「アクセスが拒否されました」になるので、権限の問題だと誤解されがちです。 上のコマンドで印の有無が分かります。

管理者で実行しているか

PowerShell
PS> ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole("Administrators")

True でなければ、そこから先は全部無駄になります。 「管理者として実行」で開いたつもりでも、別のウィンドウで打っていることがあります。推測せず、1行で確かめてください。

③ 入っているものを、正しい方法で一覧する

PowerShell
PS> $paths = @(
PS> "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*",
PS> "HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*"
PS> )
PS> Get-ItemProperty $paths -ErrorAction SilentlyContinue |
PS> Where-Object DisplayName |
PS> Select-Object DisplayName, DisplayVersion, Publisher |
PS> Sort-Object DisplayName

製品一覧を取る古い方法(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
PowerShell
PS> Start-Service : サービス 'TEST broken (TestBroken)' を開始できません。

理由を、順番に確かめます。

PowerShell
PS> sc.exe qc TestBroken                     # 実行ファイルとログオンアカウント
PS> Get-Service TestBroken -RequiredServices  # 依存している相手
PS> Get-WinEvent -FilterHashtable @{LogName='System'; Id=7000,7001,7009,7024} -MaxEvents 5 |
PS> Select-Object TimeCreated, Id, Message
ID意味疑うこと
7000サービスを開始できなかった実行ファイル・権限
7001依存するサービスが開始できない依存先を先に直す
7009接続待ちがタイムアウトした起動が遅い・止まっている
7024固有のエラーで終了したアプリ側のログを見る

7024 が出たら、Windows 側の話は終わりです。 サービスは起動し、アプリが自分で判断して終了した、という意味だからです。ここから先はアプリケーションログと、そのアプリ自身のログを見ます。ここを取り違えると、Windows の設定をいくら触っても直りません。

ログオンアカウントで落ちている場合

PowerShell
PS> sc.exe qc TestBroken | Select-String "SERVICE_START_NAME"

サービスは、指定されたアカウントの権限で動きます。 手で実行すると動くのにサービスだと動かない、という症状の多くはこれです。そのアカウントが対象のフォルダを読めるか、ネットワーク先へ届くかを確かめてください。パスワードを変更したあとに止まるのも、同じ理由です。

⑤ ポートの取り合いを起こす

# 何かが 8080 を掴んでいる状態を作る
PS> Start-Process powershell -ArgumentList '-NoExit','-Command',
PS>   '$l=[System.Net.Sockets.TcpListener]8080; $l.Start(); Write-Host 8080 held'

この状態で、同じポートを使うものを起動すると失敗します。誰が掴んでいるかを特定します。

PowerShell
PS> Get-NetTCPConnection -LocalPort 8080 -State Listen |
PS> Select-Object LocalAddress, LocalPort, OwningProcess
PS> Get-Process -Id (Get-NetTCPConnection -LocalPort 8080 -State Listen).OwningProcess

プロセス番号から名前まで、2行でたどれます。 「起動したのに繋がらない」の相当数が、これか、ファイアウォールです。起動できないのか、起動はしたが届かないのかを、ここで分けてください。

Linux の場合 —— 見る場所は同じ考え方

bash
$ systemctl status myapp            # 直近のログ数行がここに出る
$ journalctl -u myapp -n 50 --no-pager
$ systemd-analyze verify /etc/systemd/system/myapp.service
$ sudo ss -ltnp | grep 8080
症状まず疑う
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)を使っています。 一覧を出すだけのつもりが、全製品の検査を走らせています。この記事で使ったレジストリを読む方法に切り替えてください。読むだけで、副作用がありません。

後片づけ

PowerShell
PS> Stop-Service TestBroken -ErrorAction SilentlyContinue
PS> sc.exe delete TestBroken
PS> Get-Service TestBroken -ErrorAction SilentlyContinue

ポートを掴ませたウィンドウは閉じてください。練習で作ったサービスを消し忘れると、次に誰かが調べたときに偽の手がかりになります。

よくある質問

エラー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 本目です。

記事
← 前の記事ブルースクリーンの原因を調べる — メモリダンプの設定と読み方
→ 次の記事役割と機能は違う — Windows Serverに何を入れるか

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次