GroundRunnerは、チェーンコマンドがオンプレミスのシステムや、インターネット経由で使用することができないリモートのデータソースと対話することを可能にします。
カスタム証明書を使用するには、IT専門家または組織のネットワーク設定に精通している人が、証明書をシステムの証明書ストアにインポートし、Workivaのデフォルト共有ライブラリを無効にする必要があります。
要件
- カスタム証明書を使用する場合は、IT専門家に依頼することを推奨する。Workivaサポートはこのインストールをサポートすることはできません。
- サポートされているオペレーティングシステムが必要です。
- GroundRunnerの初期インストール時には、Javaランタイム環境（JRE）はインストールされません。 セットアップが完了し、GroundRunnerが実行されると、Javaに依存するコマンドを実行するために必要なJREが自動的にダウンロードされます。インストールや管理者の介入は必要なく、取得したJREがホスト上に存在する場合、既存のJREインストールに影響を与えることはありません。 GroundRunnerの要件については、詳細はこちらをご覧ください。
- 一部のコネクターは、Workivaの共有ライブラリと互換性がないため、GroundRunnerのシステムJavaインストールを使用する必要があります。除外リストを参照。
カスタム証明書のインポート
自己署名証明書、または証明書認証機関が発行していない証明書を使用する場合、GroundRunnersはシステムの証明書ストアを使用する必要があります。
証明書をインポートする：
- IT管理者に連絡して、サイトのセキュリティに使用されている証明書のコピーを入手するか、ブラウザからエクスポートしてください。
- 証明書をシステムの証明書キーストアにインポートする。有効な場所は以下の通り。
有効なロケーション
以前のGroundRunnerのバージョンでは、カスタム証明書はJRE/JDKインストールディレクトリのcacertsファイルから読み込まれていました。この関数は変更され、カスタム証明書は以下の場所からのみ読み取れるようになった。
有効な場所
- ウィンドウズ・ルート
- Windows-ROOT-LOCALMACHINE
- Windows-ROOT-CURRENTUSER
- ウィンドウズ-MY
- Windows-MY-CURRENTUSER
- Windows-MY-LOCALMACHINE
Workiva共有ライブラリを無効にする
チェーン内で「共有ライブラリ」とは、コネクターの適切な機能に必要な外部ライブラリや従属ライブラリのことである。これらの共有ライブラリは、Workivaが直接保守、更新、配送を行っています（一部例外あり ）。現時点では、Java 21が唯一の共有ライブラリですが、必要に応じて依存先が追加される可能性があります。
共有ライブラリを無効にし、自分でインストールしたライブラリで代用するには、GroundRunner.config ファイルに新規構成オプションを追加します：
SHARED_LIBRARY_OVERRIDES=java-21=/path/to/java21/home,java-24=/path/to/java24/home。このオーバーライドで提供されるパス は有効でなければならず、関連する実行可能ファイルを含むbin という名称のフォルダを含んでいなければならない。ただし、パス自体にはbinディレクトリを含むべきではない。
例
サンプルJavaインストールのフォルダ構造を考えてみます：~/.asdf/installs/java/corretto-21.0.6.10.1 ❯ tree -L 1。
.├── ADDITIONAL_LICENSE_INFO ├── ASSEMBLY_EXCEPTION ├── LICENSE ├── README.md ├── bin ├── commitId.txt ├── conf ├── include ├── jmods ├── legal ├── lib ├── man ├── release └── version.txt.ファイル構造の中にbinフォルダがあることに気づくだろう。大切なこととしては、このサブディレクトリはプロバイダーのパスには含まれていません。
代わりに、GroundRunner.config ファイルのオーバーライドは次のようになります：
SHARED_LIBRARY_OVERRIDES=java-21=/ユーザー名/.asdf/インストール/java/corretto-21.0.6.10.1そして、ウィンドウズ・マシンでは次のようになる：
SHARED_LIBRARY_OVERRIDES=java-21=C: \Program FilesJavaJavajre-21メモ : Windowsのインストールで、提供されたパスにバックスラッシュが使用されていることを確認してください。
トラブルシューティング
以下の場合、GroundRunner は始動しません：
- 設定ファイルで提供されたパスが存在せず
- パスはbinサブディレクトリを含まない。
除外コネクター
これらのコネクターは、Workivaの共有ライブラリとは互換性がないため、GroundRunnerのシステムJavaインストールを使用する必要があります：
これらのコネクターは、cacerts ファイルから読み込んだカスタム証明書を依然として使用しています。