GroundRunnersのインストールと管理

現時点では、GroundRunnersは、外部ライブラリに依存することなく、以下のオペレーティングシステムファミリーにインストールすることができます：

• ウィンドウズとウィンドウズ・サーバー
• マックオス
• Linuxディストロと派生製品
• RedHat、CentOS、Fedora、AmazonLinux
• Debian/Ubuntu

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

注: 各オペレーティングシステムのサポートスケジュールは、各ベンダーによって設定されています。例えば、マイクロソフトのウィンドウズ7のサポートは2020年1月14日に終了し、Workivaのウィンドウズ7のサポートも同じ日に終了した。

ハードウェア要件

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

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

注： 必要なディスク容量を計算するために、それぞれ10MBのエフェメラル出力を生成する5つのコマンドを持つチェーンが完了するまでに50MB必要であることを知っておく。

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

• 2〜4個のプロセッサ
• 8GBのシステムメモリ
• ソリッドステートドライブ（SSD）ストレージデバイス

このサーバーは、GroundRunnerと通信するために24時間365日利用可能でなければならない。

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

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

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

その後、GroundRunner .NET をインストールします：

1. Windows CLIからコマンドc:˶Program Files (x86)˶wdatainstaller.exe install and accept all defaults.  
   • パスは、新しいディレクトリ内に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 と入力してください。
   • 会社トークン を入力してください。
2. GroundRunner実行可能ディレクトリ以外のすべてのファイルを削除します。
3. GroundRunnerをサービスとして実行するか、フォアグラウンドプロセスとして実行するかを選択します。
   • サービスとして実行する場合は、以下のいずれかを行う：
     • CLI で、コマンドsc start GroundRunner を入力する。
     • Windows サービスマネージャで、HostRunner サービスを開始します。
   • フォアグラウンドプロセスとして実行している場合は、CLIで以下のコマンドを入力します。

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

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

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

1. GroundRunner のインストールファイルを、/home/<username>/wdata/などの独自のディレクトリにダウンロードします。
2. CLIで、インストールファイルを解凍する：
   • Linuxの場合は、linux_amd64_ground_runner.zip を解凍してください。
   • macOSの場合は、GroundRunner.zipを解凍してください。
3. GroundRunnerの詳細を入力します。
   • Linux と Mac OS の両方で、コマンド<!--sudo -->./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 と入力してください。
   • 会社トークン を入力してください。
4. GroundRunner実行可能ディレクトリ以外のすべてのファイルをディレクトリから削除します。

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

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

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

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

/ホーム/[ユーザー名]/wdata/コンテンツ/GroundRunnerMonitor 

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

フォアグラウンド・プロセスとして実行し、ログをコンソールに書き出す：

cd home/[username]/wdata/Contents sudo ./GroundRunner 

フォアグラウンド・プロセスとして実行し、ログをログファイルに書き出す：

cd home/[username]/wdata/Contents sudo ./GroundRunnerMonitor 

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

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

   cd /home/<username>/wdata/Contents
   ./GroundRunner

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

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