GroundRunnersのインストールと管理

GroundRunner を使用すると、チェーンコマンドが、インターネット経由ではアクセスできないオンプレミスシステムやリモートデータソースと対話できるようになります。これらは通常、IT プロフェッショナルまたは組織のネットワーク設定に精通した担当者によって、接続されたデータソースをホストするサーバーなどの専用サーバーにインストールされます。

GroundRunner を設定する前に、 Chain Builder のセキュリティアーキテクチャを確認することをお勧めします。

要件

互換性のあるオペレーティングシステムが必要です。また、GroundRunner が Windows 汎用命名規則 (UNC) パスなどの共有リソースにアクセスする場合は、十分な権限を持つユーザーアカウントも必要です。

Java ランタイム環境 (JRE) は GPL v2 に基づいてライセンスされていますが、クラスパス例外の対象となります。

注意: Java インストールでカスタム証明書を使用する場合、または Workiva の共有ライブラリを使用しない場合は、GroundRunners でカスタム証明書を使用する [] の記事を参照してください。

現時点では、GroundRunners は外部ライブラリに依存せずに次のオペレーティングシステムファミリにインストールできます。

Windows および Windows Server
macOS
Linuxディストリビューションと派生
RedHat、Fedora、AmazonLinux
デビアン/ウブントゥ

Workiva は、上記の OS ファミリのすべての最新バージョンをサポートするよう努めています。ただし、ベンダーによって「サポート終了」と指定されたオペレーティングシステムについてはサポートできません。これらの古いオペレーティングシステムは潜在的なセキュリティリスクをもたらすため、できるだけ早く最新バージョンに更新する必要があります。当社のサポート終了ポリシーについて詳しくご覧ください。

注: 各オペレーティングシステムのサポートスケジュールは、各ベンダーによって設定されます。たとえば、Microsoft の Windows 7 のサポートは 2020 年 1 月 14 日に終了し、Workiva の Windows 7 のサポートも同じ日に終了しました。

ハードウェア要件

GroundRunnerは限られたサーバーリソースを必要としますが、少なくとも次の内容が推奨されます。

512MBのランダムアクセスメモリ（RAM）の空き容量
100GBの空きディスク容量

注: 必要なディスク容量を計算するには、それぞれ 10 MB の一時出力を生成する 5 つのコマンドのチェーンを完了するには 50 MB が必要であることに注意してください。

推奨されるホスト構成には、以下で構成されたバーチャルマシンが含まれます。

2～4 個のプロセッサ

注: ARM ベースのプロセッサは GroundRunners と互換性がありません。
8GBのシステムメモリ
ソリッドステートドライブ（SSD）ストレージデバイス

このサーバーは、GroundRunner と通信するために 24 時間 365 日利用可能である必要があります。

デフォルトでは、GroundRunners は共有ドライブなどのリモートリソースにアクセスできないローカル管理アカウントを使用します。

Windowsの汎用命名規則（UNC）パスなどの共有リソースにアクセスするには、そのリソースに適切な権限を持つユーザーアカウントでGroundRunnerを起動してください。デフォルトのローカルシステム管理者以外のユーザーアカウントを使用する場合は、自動更新を有効にするために、GroundRunner のインストールディレクトリを管理する権限を付与します。

GroundRunnerをダウンロード

インストールまたはマニュアル更新のためにGroundRunnerをダウンロードするには、次の手順に従います。

Chain Builder で、サイドバーから設定設定を選択します。
上部にあるダウンロードをクリックする。
お使いのオペレーティングシステムのGroundRunnerを検索して、右側のダウンロード をクリックします。

GroundRunnerをインストールする

Microsoft インストーラー (MSI) には .NET 3.5 以上が必要です。この要件を満たすことができない場合は、代わりにコマンドラインインターフェイス経由で GroundRunner をインストールしてください。

GroundRunner をインストールするには:

windows_amd64_ground_runner.zip ファイルを解凍します。
GroundRunner.msi を実行して、GroundRunner セットアップウィザードを開始します。
[次へ]をクリックします。
使用許諾契約の条項を確認して承認し、[次へ]をクリックします。
インストール先フォルダに、GroundRunner をインストールするパス ( C:\Program Files\GroundRunner\など) を入力し、次へをクリックします。
[プラットフォーム会社トークン]に会社トークンを入力します。
プラットフォーム認証ホストで、次の操作を行ないます。
- 北米の場合は、 h.app.wdesk.com/s/wdata/oc/appと入力してください。
- ヨーロッパの場合は、 h.eu.wdesk.com/s/wdata/oc/appと入力してください。
- APACの場合は、 h.apac.wdesk.com/s/wdata/oc/appと入力してください。
プロキシサーバーを使用する場合は、 プロキシホストにその URL とポートを入力します。(例: http://yourproxy:3000)
- プロキシサーバーをバイパスするには、 プロキシホストなしの下に、コンマで区切られたホストのリストを入力します。
次へ、インストール、終了をクリックする。
インストールが完了したら、Windows サービスマネージャーから GroundRunner を右クリックし、 [ 開始 ]を選択します。

GroundRunner がインストールされ、アクティベーションの準備が整いました。

コマンドラインインターフェイス経由でインストールするには、GroundRunner のインストールをプログラムファイル内の独自のディレクトリ ( c:\Program Files (x86)\wdataなど) にダウンロードする必要があります。その後、インストールファイルを解凍し、ディレクトリのルートに抽出できます。

次に、GroundRunner をインストールします。

Windows CLI から、コマンド c:\Program Files (x86)\wdata\installer.exe install を実行し、すべてのデフォルトを受け入れます。
- パスについては、新しいディレクトリ内に Files フォルダを作成します (例: C:\Program Files (x86)\Wdata\Files)。
- 認証ホスト名（AUTH_HOST）の場合：
  - 北米の場合は、 h.app.wdesk.com/s/wdata/oc/appと入力してください。
  - ヨーロッパの場合は、 h.eu.wdesk.com/s/wdata/oc/appと入力してください。
  - APACの場合は、 h.apac.wdesk.com/s/wdata/oc/appと入力してください。
- 会社トークンを入力してください。
GroundRunner 実行可能ディレクトリ以外のディレクトリからすべてのファイルを削除します。
GroundRunnerをサービスとして実行するか、フォアグラウンドプロセスとして実行するかを選択します。
- サービスとして実行している場合は、次のいずれかを実行します。
  - CLIでコマンド sc start GroundRunnerを入力します。
  - Windowsサービスマネージャーで、 HostRunner サービスを開始します。
- フォアグラウンドプロセスとして実行している場合は、CLIで次のコマンドを入力します:
```
cd c:\Program Files (x86)\wdata GroundRunner.exe
```

GroundRunner がインストールされ、アクティベーションの準備が整いました。

ステップ1：GroundRunnerをインストールする

GroundRunner のインストールファイルを、/home/<username>/wdata/などの独自のディレクトリにダウンロードします。
CLI で、インストールファイルを解凍します。
- Linuxの場合は、 unzip linux_amd64_ground_runner.zipコマンドを使用します。
- macOSの場合は、 unzip GroundRunner.zipコマンドを使用します。
GroundRunnerの詳細を入力します。
- LinuxとMac OSの両方で、コマンド ./installer installを使用します。
- 認証ホスト名（AUTH_HOST）の場合：
  - 北米の場合は、 h.app.wdesk.com/s/wdata/oc/appと入力してください。
  - ヨーロッパの場合は、 h.eu.wdesk.com/s/wdata/oc/appと入力してください。
  - APACの場合は、 h.apac.wdesk.com/s/wdata/oc/appと入力してください。
- 会社トークンを入力してください。
GroundRunner実行可能ディレクトリ以外のすべてのファイルをディレクトリから削除します。

ステップ2. サービスとして実行するかフォアグラウンドプロセスとして実行するかを選択します。

CLI で次のコマンドを入力して、GroundRunner をバックグラウンドサービスまたはフォアグラウンドプロセスとして実行します。

バックグラウンドサービス

デフォルトの OS init プログラムから実行すると、バックグラウンドサービスとして実行できます。

/home/[ユーザー名]/wdata/Contents/GroundRunnerMonitor

フォアグラウンドプロセス

ログをコンソールに書き込むフォアグラウンドプロセスとして実行するには:

cd home/[ユーザー名]/wdata/Contents sudo ./GroundRunner

ログをログファイルに書き込むフォアグラウンドプロセスとして実行するには:

cd home/[ユーザー名]/wdata/Contents sudo ./GroundRunnerMonitor

グラウンドランナーを起動する

GroundRunner をインストールした後、Chain Builder 内でアクティブ化する必要があります。

Chain Builder で、サイドバーから設定設定を選択します。
一番上のRunners をクリック。
登録保留中の下に、ランナーの短い説明的な名前を入力します（ <datasource> -グラウンドランナー）。
[有効化]をクリックします。

GroundRunnerを手動で更新する

ごく稀に、GroundRunnerを手動でアップグレードする必要が生じる場合があります。

最新のMSIをダウンロードしてインストールし、以前にダウンロードしたバージョンはアンインストールする。

オペレーティングシステムに対応する最新のGroundRunnerをダウンロードします。
Windowsサービスマネージャーで、GroundRunnerサービスを停止します。
ダウンロードしたGroundRunnerのインストールファイルを、専用のディレクトリ（c:\groundrunner_upgradeなど）にダウンロードし、ファイルを解凍します。
GroundRunner.exe と GroundRunnerMonitor.exe をコピーして、GroundRunner バイナリがインストールされているディレクトリに貼り付けます。
Windowsサービスマネージャーで、GroundRunnerサービスを再起動します。

オペレーティングシステムに対応する最新のGroundRunnerをダウンロードします。
GroundRunner をホストしているサーバー上で、サービスが実行されているディレクトリに移動します。
CLIで、GroundRunnerのサービスを停止します。
ダウンロードしたGroundRunnerのインストールファイルを、専用のディレクトリ（/home/<username>/groundrunner_upgrade/など）にダウンロードし、ファイルを解凍します。
GroundRunner.exe と GroundRunnerMonitor.exe をコピーして、GroundRunner バイナリがインストールされているディレクトリに貼り付けます。
GroundRunnerサービスを再起動するには、CLIで次のコマンドを入力します:
```
cd /home/<username> /wdata/Contents
./GroundRunner
```

GroundRunnerをアンインストールする

GroundRunnerが不要になった場合は、アンインストールする事ができます。

Windows の設定から アプリと機能に移動し、 GroundRunner (64 ビット)を選択して アンインストールをクリックします。

GroundRunner サービスを停止します。
- サービスとして実行している場合は、Windows サービスマネージャーを使用するか、CLI でコマンド sc stop GroundRunnerを入力します。
- フォアグラウンドプロセスとして実行している場合は、キーシーケンス <ctrl> <c> を押します。
CLIで、管理者として、コマンド installer.exe uninstall を入力します。
GroundRunnerの実行可能ディレクトリを削除します。

CLIでGroundRunnerサービスを停止し、その実行ディレクトリ（例： /home/<username> /wdata/Contents）。

GroundRunnerの構成設定と送信ドメイン

データソースとの通信を有効にするには、GroundRunnerがインストールされているサーバーのファイアウォールのポートを開く必要があります。一部の GroundRunner の構成設定を変更するには、バイナリがインストールされているディレクトリにある GroundRunner.config ファイルを編集します。

構成	設定
ポート	0から65535. デフォルトでは、GroundRunnerはポート8821 を使用して相互に通信します。ただし、異なるサーバー上のGroundRunnerがネットワーク内でコマンド出力を共有する場合にのみ、ポートが必要です。
COMPANY_TOKEN	GroundRunner が別のテナント用に構成されていない限り、デフォルトのままにします。
LOG_LEVEL	情報またはデバッグ
プロトコル	デフォルトのままにします。
HTTP_PROXY_URL	プロキシサーバーを使用する場合は、その URL とポート (必要な場合) を入力します。例えば、`http://yourproxy:3000` 注意: GroundRunners はプロキシサーバーを使用できますが、New Technology LAN Manager (NTLM) 経由で認証されたサーバーは使用できません。代わりに、サーバーの IP アドレスを許可します。
LONG_POLL	プロキシサーバーを使用する場合は、trueに設定すると、ロングポーリングを使用してコマンドを取得するようにランナーが指示されます。パフォーマンスを確保するため、ウェブソケットがプロキシサーバーやファイアウォールでサポートされていない場合にのみ、ロングポーリングを使用してください。
NO_PROXY	プロキシサーバーをバイパスするには、代わりに直接到達するホストのカンマ区切りリストを提供して下さい。共通のパターンに基づいて複数のホストを含めるには、[ * ]のワイルドカードを使用します。
GROUNDRUNNER_CERT	複数のGroundRunnerを使用し、暗号化された情報を2台目のGroundRunnerに送信したい場合に必要。 PORTと組み合わせて使用する必要があります。ランナーをアクティブ化するときに、 PROTOCOL フィールドを HTTPS として指定する必要もあります。
GROUNDRUNNER_CERT_KEY	複数のGroundRunnerを使用し、2台目のGroundRunnerから暗号化された情報を受信したい場合に必要。 PORTと組み合わせて使用する必要があります。
ウェブソケットを無効にする	変換を実行するには Websocket が必要です。無効にすると、変換を使用するコマンドはすべて完全にスキップされます。

注意: 自己署名証明書にはサブジェクト別名 (SAN) が必要です。これがない場合、GroundRunnerがファイルをダウンロードしようとすると欠落しているSANを参照するエラーメッセージが表示されます。

ネットワークで送信ドメインを許可する必要がある場合、以下がGroundRunnerに適用されます。

ドメイン	目的
`h.app.wdesk.com` `h.eu.wdesk.com` `h.apac.wdesk.com`	Wdata を含む一般的な Workiva サービスの主なサブドメイン。
`*.wdesk.com`	生産 Workiva プラットフォームのメインドメイン。
`..wdesk.com`	Workiva プラットフォーム内のコンポーネントをサポートするためのサブドメイン。

セキュリティ

GroundRunners はデータを収集したり集約したりすることはありません。データは送信中のみ保持されます。拡張検証（EV）証明書は、DigiCert®を介してGroundRunnerとそのデータソース間のトラフィックを常に暗号化し保護します。

注: オンプレミスのデータをセキュリティで保護するために、CloudRunners は出力を GroundRunners と共有できますが、GroundRunners はファイル出力を CloudRunner と共有できません。

GroundRunnerエラーのトラブルシューティング

チェーンの実行時にこれらのエラーが発生した場合は、コマンドの GroundRunners を確認してください。

ヒント：トラブルシューティングを容易にするために、GroundRunnerのログファイルを自動的にテーブルにダウンロードするチェーンを作成することができます。

エラーメッセージ	原因	着地点
エージェントとの通信に失敗しました。このコマンドは実行されませんでした	コマンドはGroundRunnerと通信できませんでした。このような場合は、GroundRunner が起動していないか、GroundRunner と Chain Builder の間でネットワークの中断が発生しています。	確認事項： GroundRunnerのサービスは機能している。 GroundRunnerのサーバーはインターネットに接続されている。
コマンドに関連するリソースをダウンロードできません。エラーが解決しない場合は、サポートにお問い合わせください。	これらのチェーンのコマンドに関連付けられたランナーは相互に通信できません。これは、コマンドが異なるランナーを使用し、CloudRunner が GroundRunner ベースのコマンドからのファイル出力を使用しようとしている場合によく発生します。	チェーン内のすべてのコマンドで同じランナーを使用します。チェーンのコマンドに複数のランナーが必要な場合は、GroundRunners を持つコマンドが CloudRunner を使用するコマンドにファイル出力を渡さないことを確認します。
コマンドの開始中にエラーが発生しました：exec: \"\\[connector].exe\": file does not exist" commandExecutorId=[ID]	マルウェアやウイルス対策アプリケーションがコネクターを誤って識別し、GroundRunnerとの通信を傍受した。	アプリケーションのスキャンからGroundRunnerのインストールディレクトリを除外します。
証明書のエラー	自己署名証明書の使用	多くの場合、自己署名証明書を使用してGroundRunner通信を暗号化すると便利です。自己署名証明書を使用している場合は、証明書の共通名がサーバーにアクセスできる URL と一致していることを確認してください。例えば、GroundRunnerがポート8821でリッスンしていて、ネットワークlocalhostからサーバーにアクセスできる場合、証明書のCommon Name は、localhost となる。
エラーによる断続的なチェーン障害: "Connection reset by peer"	複数のランナーが同じマシンにインストールされている場合、それぞれに固有のGUIDが必要である。同じGUIDが使われた場合、ランナーが重複して更新ループに入る可能性があり、場合によってはチェーンエラーが発生することがあります。	GroundRunnerの完全な再インストールをお勧めします。
GroundRunnerではコマンドがスキップされるが、CloudRunnerでは成功する	変換を実行するには Websocket が必要です。Websocket が無効になっている場合、すべての変換は完全にスキップされます。	設定ファイルを開き、 `DISABLE_WEBSOCKETS=false`を設定します。

その他のリソース

サポート

Workiva サポートセンター