GroundRunnerマニュアル更新

ホストマシンのGroundRunnerとGroundRunnerMonitorのバイナリを新しいバージョンに置き換えるには、以下の手順に従ってください。

重要な計画上の注意事項

GroundRunnerサービスは、グレースフル・シャットダウンをサポートしていません。サービスが停止されると、飛行中の操作は即座に終了する。これらの操作の結果は失われ、コマンドを再実行する必要がある。
サービスを停止すると混乱が生じるため、アップデートを実行する前に関係者と展開ウィンドウを調整し、メンテナンス期間中に重要なジョブが実行中または実行予定になっていないことを確認することを強くお勧めします。

前提条件（すべてのプラットフォーム）

アップデートが必要かどうか確認してください。現在のバージョン（2026年6月1日現在）は9.21.1です。
お使いのGroundRunnerのバージョンについては、GroundRunnerのバージョンを確認するには？をご参照ください。
GroundRunnerが古い場合、以下のバナーが表示されます。
GroundRunner が古い場合は、バージョン フィールドに表示されているバージョン番号を記録してください。

Windowsプラットフォーム用

WindowsGroundRunner.zip 、Workivaから入手。
(詳細については、GroundRunnersのインストールと管理を参照)。
いずれも管理者権限：
- GroundRunnerがインストールされているマシン。
- バイナリがインストールされているディレクトリ。
GroundRunnerサービスの停止と開始の許可。

Linuxプラットフォームの場合

WindowsGroundRunner.zip 、Workivaから入手。
(詳細については、GroundRunnersのインストールと管理を参照)。
Linux ユーティリティunzip(1) 、tar(1) 、gzip(1) をインストールする必要がある（これらはほとんどのインストールに標準装備されている）。
ファイルの所有者権限（chown）。
いずれも管理者権限：
- GroundRunnerがインストールされているマシン。
- バイナリがインストールされているディレクトリ。
GroundRunnerサービスの停止と開始の許可。

Windowsインストール

GroundRunner.zip を一時ディレクトリに解凍します。
サービスコンソールを開く：Win + R を押し、services.msc と入力し、Enter を押す。
リストでGroundRunner を見つけて右クリックし、Stop を選択する。
ステータスがStopped と表示されるまで待つ。
既存のバイナリをバックアップする。
ファイルエクスプローラーで、GroundRunnerのインストールディレクトリに移動し、GroundRunner.exe 、GroundRunnerMonitor.exe 、任意の設定ファイルをバックアップ場所にコピーします（例えば、GroundRunner.exe.bak 、GroundRunnerMonitor.exe.bak ）。
GroundRunner.exe とGroundRunnerMonitor.exe を解凍したディレクトリからインストールディレクトリにコピーし、既存のファイルを上書きしてバイナリを置き換えます。
サービスコンソールに戻り、GroundRunner を右クリックし、Start を選択します。
ステータスがRunning と表示されていることを確認する。

Linux (systemd) のインストール

これらの命令は、セキュリティが強化されていない標準的なLinuxシステム用である。ホストがSELinux、AppArmor、またはその他のセキュリティ・ソフトウェアを実行している場合は、このセクションの最後にある必須アクセス制御（SELinux / AppArmor）を参照してください。

ZIPファイル内の成果物を解凍する。

注： zipファイルを/tmp/groundrunner-update に解凍するのは、例示のためです。
```
unzip GroundRunner.zip -d /tmp/groundrunner-update
```
実行中のプロセスを停止する。systemdを使う場合は、このコマンドを使う：
```
 sudo systemctl stop <service-name>
```
重要な注意: GroundRunner を systemd サービスとして設定していない場合 アップデートを実行する前に、systemd サービスとして設定してください。systemdサービスの設定方法に関するドキュメントは、Linuxディストリビューションのドキュメントで見つけることができる。systemd以外のLinuxディストリビューションを使用している場合は、ディストリビューションのドキュメントを参照してください。
GroundRunnerディレクトリのバイナリと設定をバックアップします：
```
cd /path_to_groundrunner_install_dir tar czvf groundrunner.bak.tar.gz GroundRunner* *config config* monitor.version
```
注意: インストールディレクトリ全体（つまりログや他のフォルダ/ファイルを含む）をバックアップすることは大歓迎ですが、非常に大きなバックアップファイルが作成される可能性があります。

バイナリを置き換える：

cd /path_to_groundrunner_install_dir cp /tmp/groundrunner-update/GroundRunner . cp /tmp/groundrunner-update/GroundRunnerMonitor .

実行ファイルのパーミッションを設定する：
```
chmod +x GroundRunner GroundRunnerMonitor
```
注： GroundRunnerが特定のシステム・ユーザーによって実行されている場合、chown 新しい実行可能ファイルが必要になることがあります。
サービスを開始する：
```
sudo systemctl start <サービス名>.
```
サービスのステータスをチェックし、健全であることを確認する：
```
sudo systemctl status <サービス名>.
```
後片付けをする：
```
rm -rf /tmp/groundrunner-update
```

強制アクセス制御（SELinux / AppArmor）

ホストが強制的なアクセス制御ポリシー（SELinux、AppArmorなど）を適用している場合、ディスク上のバイナリを置き換えるとサービスが失敗する可能性がある。

カスタム・サービスに関するセキュリティ・ポリシーの管理については、ディストリビューションのドキュメントを参照してください。

注： FAPOLICYD、IMA/EVM、カスタムファイル整合性監視などの他のセキュリティソフトウェアも、置き換えられたバイナリの実行をブロックする可能性があります。更新後にサービスが開始できず、SELinux/AppArmorが除外された場合、システム上の追加のセキュリティフレームワークが更新された信頼リストまたはファイル署名を必要とするかどうかを確認します。

検証

GroundRunner のステータスを確認するには?

GroundRunnerが正しくインストールされていることを確認するために、GroundRunner上でコマンドのテストセットを実行する「パイロットチェーン」を作成し、実行することをお勧めします。

また、GroundRunnerをアップデートして再起動した直後は、システムおよびGroundRunnerの動作を監視することをお勧めします。これにより、正しく作動していることを確信することができる。CLIコマンドを使えば、新しいログエントリーが発生すると、それをストリーミングして見ることができる。

Windowsの場合

PowerShellを使ってログファイルの最後を表示するには、次のように入力する：

Get-Content -Path "C:˶path_to_output.log" -Tail 10 -Wait

これはPowerShellウィンドウを開いたままにし、新しいログエントリーをリアルタイムでストリームする。-tail 10 直近の10行をロードします。

Linux用

ログファイルの最後を表示し、新しいエントリーをリアルタイムでストリーミングするには、次のように入力する：

tail -f /path_to/output.log

ロールバック

新しいバージョンが正しく動作しない場合は、以下の手順で以前のバージョンにロールバックすることができます：

上記のように GroundRunner サービスを停止します。
インストールされているGroundRunner.exe とGroundRunnerMonitor.exe のファイル名を変更してください。
GroundRunner.exe.bak とGroundRunnerMonitor.exe.bak をバックアップ場所からインストールディレクトリにコピーします。
これらのファイルの拡張子を「.bak」に変更してください。
上記の適切な手順に従って、GroundRunnerサービスを再起動します。

注：これらの手順はLinux GroundRunnersにも当てはまりますが、バックアップtarボールからバイナリを抽出する必要があります。

メモ

バイナリ名は変更しないでください。自動アップグレードの仕組みは、デフォルトの実行ファイル名（LinuxではGroundRunner とGroundRunnerMonitor 、WindowsではGroundRunner.exe とGroundRunnerMonitor.exe ）に依存し、将来のアップデートを検出して適用します。名前を変えると自動アップグレードができなくなる。
macOS は開発目的でのみサポートされています。本番用プラットフォームとしてはサポートされていない。
その他のサービスマネージャー： 上記の例では、systemd（Linux）とWindowsサービス・コントロール・マネージャーを使っている。環境で別のサービスマネージャまたはプロセススーパバイザを使用している場合は、構成に相当する停止、置換、および開始の手順を実行してください。
デフォルトでは、GroundRunnerは共有ドライブなどのリモートリソースにアクセスしないローカル管理者アカウントを使用します。Windowsの汎用命名規則（UNC）パスなどの共有リソースにアクセスするには、そのリソースに適切な権限を持つユーザーアカウントでGroundRunnerを起動してください。デフォルトのローカルシステム管理者以外のユーザーアカウントを使用する場合は、GroundRunnerのインストールディレクトリを管理する権限を付与し、自動アップデートを有効にしてください。

サポート

コミュニティ

Workiva サポートセンター