Workiva サポートセンター

コマンドラインインターフェースからインストールするには、GroundRunnerのインストールファイルを、プログラムファイル内の専用ディレクトリにダウンロードする必要があります（例：c:\Program Files (x86)\wdata ）。その後、インストールファイルを解凍し、そのディレクトリのルートに展開してください。

その後、GroundRunner をインストールできます：

1. Windows のコマンドプロンプトで、次のように入力します。

   c:\Program Files (x86)\wdata\installer.exe をインストール

   そして、すべてのデフォルト設定を受け入れます。

   • 初期化システムとして「Windows」を選択してください。
     

     自動更新に対応させるには、GroundRunner を Windows サービスとして動作させるよう指定する必要があります。GroundRunnersは、テスト目的の場合を除き、サービスとしてのみ実行してください。

   • パスについては、新しいディレクトリ「
     」内に、「Files 」フォルダを作成してください（例：C:\Program Files (x86)\Wdata\Files ）。
   • 認証ホスト名（AUTH_HOST）の場合：
     • APACの場合は、h.apac.wdesk.com/s/chains-reaper を入力してください。
     • カナダの場合は、h.ca.wdesk.com/s/chains-reaper を入力してください。
     • EMEAの場合は、h.eu.wdesk.com/s/chains-reaper を入力してください。
     • 米国、中米、南米の場合は、h.app.wdesk.com/s/chains-reaper を入力してください。
   • の会社トークン「 」を入力してください。
2. GroundRunner実行ディレクトリ以外のすべてのファイルを削除します。
3. GroundRunnerをサービスとして実行するか、フォアグラウンドプロセスとして実行するかを選択します。
   • サービスとして実行する場合は、以下のいずれかを行う：
     • コマンドダイアログで、「sc start GroundRunner 」と入力します。
     • Windows Service Manager で、「GroundRunner」サービスを開始します。

   • フォアグラウンドプロセスとして実行する場合は、コマンドダイアログに以下を入力してください：

     cd c:\Program Files (x86)\wdata GroundRunner.exe

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

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

1. GroundRunnerのインストールファイルを、
   のような専用のディレクトリにダウンロードしてください。例：/home/user_name/wdata/ 。

   注： "/home/user_name/wdata" は一例として挙げたものです。サービスの設置場所については、所属組織の方針に従ってください。

2. コマンドダイアログで、次のコマンドを使用してインストールファイルを解凍します：

   GroundRunner.zip を解凍する

3. GroundRunnerの詳細を入力してください。
   1. を入力し、./installer install を実行します。
   2. 認証ホスト名（AUTH_HOST）の場合：
      • APACの場合は、h.apac.wdesk.com/s/chains-reaper を入力してください。
      • カナダの場合は、h.ca.wdesk.com/s/chains-reaper を入力してください。
      • EMEAの場合は、h.eu.wdesk.com/s/chains-reaper を入力してください。
      • 米国、中米、南米の場合は、h.app.wdesk.com/s/chains-reaper を入力してください。
   3. の会社トークン「 」を入力してください。
4. インストール中に作成されたフォルダを除き、そのディレクトリ内のすべてのファイルを削除してください。

手順 2. GroundRunner を systemd サービスとして設定する（Linux）

GroundRunnerの自動更新を確実に機能させるため、またGroundRunnerを適切な状態に保つために、GroundRunnerは有効化され、再起動可能なsystemdサービスとしてインストールする必要があります。GroundRunner を systemd サービスとして実行する方法については、お使いのオペレーティングシステムのドキュメントおよび組織のポリシーをご参照ください。

基本的な設定において、自動更新が正常に機能するためには、以下の systemd ユニットファイルの要件を満たす必要があります：

• のExecStartに指定されている 実行ファイルが、のGroundRunnerMonitor バイナリを指していることを確認してください。
  のGroundRunner バイナリを指していないようにしてください。
• Restart=always を設定します。
• 、StartLimitBurst 、、StartLimitIntervalSec は設定しないでください。これらを設定すると、一時的なエラーが発生した際に GroundRunner が再起動できなくなる可能性があります。GroundRunnerが高速な再起動ループに陥らないようにしたい場合は、RestartSec を設定してください。
• を入力し、systemctl enable を実行して、systemd の GroundRunner サービスユニットを有効にし、再起動後も GroundRunner が動作し続けるようにします。

Workivaでは、GroundRunnerをフォアグラウンドプロセスとして実行することについて、公式にはサポートしていません。これは設定のテストには役立つかもしれませんが、GroundRunnerの設定が完了したら、長期稼働型のバックグラウンドプロセスとして設定すべきです。

macOS での GroundRunners の動作（テスト目的のみ）

Workivaは、テスト目的のみとして、macOS上のGroundRunnersをサポートしています。 。macOS版のGroundRunnersでは、Linux版やWindows版と同じコマンドを実行できますが、Workivaはlaunchdを有効なサービスマネージャーとして公式にはサポートしていません。これは、Appleが2022年にmacOSサーバーソフトウェアのサポートを終了したためです。Apple製のノートパソコンおよびデスクトップパソコンは、GroundRunnersの実行には適していません。