Workiva サポートセンター

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

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

1. Windowsのコマンドウィンドウで、

   c:˶Program Files (x86)˶wdatainstaller.exeインストール

   と入力し、すべてのデフォルトを受け入れます。
   • initシステムに "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 サービスマネージャで、GroundRunner サービスを開始します。
   • フォアグラウンドプロセスとして実行している場合は、コマンドダイアログで次のように入力します。

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

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

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

1. GroundRunnerのインストールファイルを専用のディレクトリ（
   など）にダウンロードします：/home/user_name/wdata/.

   注： "/home/user_name/wdata "は例として提供されている。サービス設置場所については、組織の方針に従ってください。

2. コマンドダイアログで、次のようにインストールファイルを解凍します。
   

   unzip 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サービスとして実行する方法については、各OSのドキュメントおよび組織ポリシーを参照してください。

基本的な構成では、自動アップデートが正しく動作するために、以下のsystemdユニットファイルが必要です：

• ExecStart 実行ファイルが、GroundRunnerMonitor バイナリを指しており、
  GroundRunner バイナリを指していないことを確認してください。
• SetRestart=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を公式にサポートしていない。これは、アップルが2022年にmacOSサーバーソフトウェアのサポートを打ち切ったためだ。アップルのノートパソコンやデスクトップパソコンは、GroundRunnersの実行には適していません。