Skip to content

Latest commit

 

History

History
96 lines (80 loc) · 5.64 KB

windows-ja.md

File metadata and controls

96 lines (80 loc) · 5.64 KB
Raw

Incredibuild (IB) Windows 質問集

Updated for Version 10

  • %IB_DIR% は Incredibuild インストールディレクトリ（デフォルトは "C:\Program Files (x86)\Incredibuild"）

開発者向け

詳細なログ付きビルドモニターの取得方法

  1. 右下のタスクトレイにある Incredibuild のアイコンを右クリック > Agent Settings > Agent > General > Logging > Logging level: Detailed に設定
  2. Incredibuild を使ってビルド
  3. 右下のタスクトレイにある Incredibuild のアイコンを右クリック > Build History > 該当の Build をダブルクリック > File > Save Monitor File As... → 名前をつけた *.ib_mon を送付

個々のタスクの詳細なログ取得方法

ビルドモニター自体にはタスクごとの詳細なログは保存されないため、下記が必要なケースがあります

  1. ビルドモニターを開く
  2. タスクを一つ選択し、右クリック > Save Detailed Log...
  3. _CPUX.{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}.ib_log を保存、送付

PML ファイルの取得方法

ビルドモニターやログなどで解析が難しい場合、さらに Process Monitor ファイルが必要なケースがあります

  1. マイクロソフトの専用ツール Process Monitor をダウンロードする
  2. ProcessMonitor.zip ファイルを解凍する
  3. タスクバーに表示されているすべてのアプリケーションを閉じ（可能であれば）、以下のステップで追加のアクションを取らないようにする
  4. Procmon.exe を実行する
  5. Edit > Clear Display
  6. File > "Capture Events" がチェックされていることを確認する
  7. 問題を再現する
  8. File > Save in Process Monitor を選択し、ネイティブ PML 形式でログファイルを保存する

Predictive Execution (PE) のオン・オフの仕方

オン

Agent Settings > Visual Studio Builds > Advanced > Predicrtive execution (Visual Studio 2010 and higher) > "Enhance throughput using out-of-order tasks spawning" をチェック

オフ

Agent Settings > Visual Studio Builds > Advanced > Predicrtive execution (Visual Studio 2010 and higher) > "Enhance throughput using out-of-order tasks spawning" をアンチェック

ビルドが Helper でのみ失敗する時（ビルドモニター上「白いバー」になる時）

  • アンチウイルスソフトのスキャン対象フォルダから IB を外す（System Requirements > Antivirus）
  • Agent Settings > Initiator > Advanced > Recovery: Distributed tasks should only fail on local machine をアンチェック、ビルドし原因を確認

管理者向け

ビルドが一部の Helper でしか実行されない時

Coordinator > Settings > Agents > Helper Participation Threshold の設定（特に "Available CPU" を見直す）

  • Available CPU は「Helper の CPU リソースが 30% 以上空いていない時、この Helper を利用しない」という意味
  • Available CPU のデフォルトは 30%、増やすと Helper が割り当てられる可能性が低くなっていく

インストール・アップグレード不具合時の送付ファイル

  • %IB_DIR%\Logs
  • %IB_DIR%\Manager\logs
  • %TEMP%\IB_Setup_Log*

ライセンスとビルドグループ設定のバックアップとリストア

バックアップ

  1. Coordinator を停止する（Services > Incredibuild CoordinatorService を右クリック > Stop）
  2. インストールフォルダ（デフォルト "C:\Program Files (x86)\Incredibuild"）直下の CoordService.sbd をバックアップ（このファイルにライセンスとビルドグループの情報が保存されている）
  3. Coordinator を開始する（Services > Incredibuild CoordinatorService を右クリック > Start）

リストア

  1. Coordinator を停止する（Services > Incredibuild CoordinatorService を右クリック > Stop）
  2. インストールフォルダ（デフォルト "C:\Program Files (x86)\Incredibuild"）直下に CoordService.sbd をリストア
  3. Coordinator を開始する（Services > Incredibuild CoordinatorService を右クリック > Start）

Coordinator の再起動時間の確認方法

  1. %IB_DIR%\Logs\CoordinatorService.log の下記ライン
grep -a "============= Incredibuild Version" CoordinatorService*.log
[2024-09-24 13:48:51.026] [info] [coordinator_service] [3252] [main.cpp:72] ============= Incredibuild Version 10.17.0 (Build 13843) =============
[....]
  1. %IB_DIR%\Logs\CoordinatorCore.log の下記ライン
$ grep -a "Coordinator ID" CoordinatorCore.log
24-09-2024 13:48:52.317 Coordinator ID: XXXXXXXXXX
[....]

VPN などで Agent の内部 IP と外部向け IP (Routing IP) が変わってしまう場合の対応

Coordinator のレジストリ Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Xoreax\Incredibuild\Coordinator 内にエントリ Key: UseRoutingIP, Value: 0 を設定する

  • Value: 1 (default) → Agent の IP として Routing IP を使う
  • Value: 0 → Agent の IP として内部 IP を使う

Incredibuild 関連のイベントログを抑止する方法（IB10.20 以降）

  1. 下記内容の coordinator_service_config.json ファイルを作成
{
  "logger": {
    "sink": {
      "logToEventViewer": false
    }
  }
}
  1. C:\ProgramData\Incredibuild\Coordinator フォルダを作成（存在しない場合）
  2. 1. のファイルを 2. のフォルダ以下にコピー (C:\ProgramData\Incredibuild\Coordinator\coordinator_service_config.json)
  3. Coordinator を再起動