MicroStrategy ONE

Collaboration Server の構成プロパティ

コラボレーションサーバーの設定は、config.jsonファイル。パラメーターはすべて大文字と小文字の区別があるので、正確に入力してください。

config.json以下の場所にあります:

ウィンドウズ : <INSTALL_PATH>\MicroStrategy\Collaboration Server

リナックス : <INSTALL_PATH>/CollaborationServer

このファイルには次のプロパティが含まれています。

プロパティ 指定

ポートと URL のプロパティ

port 通信ポートの番号
dataSource

dataSource オブジェクトには次のプロパティが含まれています。

  • username = Postgres に接続するためのユーザー名
  • password = Postgres に接続するための暗号化されたパスワード
  • host = このパラメーターは、リモートの Postgres サーバーの IP またはホスト名を指定します。デフォルトでは、Collaboration Server はローカル Postgres サーバーに接続しようとします。
  • port = このパラメーターは Postgres サーバーのポートを指定します。デフォルトでは、コラボレーションサーバーは5432 Postgres サーバーのポート
  • encryptionKeyFile = パスワードを暗号化または復号化するためのキーを含むファイル
  • コラボレーションサーバーでは、以下のパラメータのうち少なくとも1つを指定します。config.json PostgreSQL への SSL 接続を有効にします。
    • sslRootCertFile = このパラメータは、SSL 証明機関 (CA) を含むファイルのパスを指定します。ファイルが存在する場合、サーバーの証明書はこれらの機関のいずれかによって署名されているかどうか検証されます。
    • sslClientCertFile = このパラメータはクライアントSSL証明書のファイルの場所を指定します
    • sslClientKeyFile = このパラメータは、クライアント証明書に使用される秘密鍵のファイルの場所を指定します

authorizationServerUrl

MicroStrategy Library Server の URL エンドポイント。最後に/api

notificationBaseUrl

メール通知を生成する際の Library Server のアドレス。このプロパティは 2020 Update 2 から利用可能です。

このプロパティは、信頼できない認証などの特定の認証構成で使用し、認証サーバーのアドレスを格納します。このプロパティが設定されていない場合は、authorizationServerUrl のアドレスが使用されます。

TLS サポートのプロパティ
enableTls

TLS サポートが有効であるかどうか。

true である場合、TLS サポートは有効になっており、次のフィールドのペアのいずれかが指定される必要があります。

  • privateKeyFile と publicCertFile
  • keystoreFile と passphrase

keystoreFile と passphrase プロパティは、privateKeyFile と publicCertFile フィールドよりも優先されます。

省略された場合、または false である場合、TLS サポートは無効になります。

privateKeyFile 秘密キーへのパス。
publicCertFile パブリック証明書へのパス。
keystoreFile PKCS12 または PFX キーストア ファイルへのパス。
passphrase 証明書署名要求 (CSR) に使用されるパスフレーズ。
trustedCerts

信頼できる証明書ファイルのパス (現在のディレクトリに対して相対) の配列。

これが必要なのは、Library Server と HTTPS でやり取りするけれども、プライベート ルート認証機関証明書または自己署名証明書を使う場合に限ります。

中間証明書は必要ありません。ルート認証機関証明書だけで充分です。

ルート認証機関証明書は独立した PEM ファイルに格納されていなければなりません。

クラスター化に関するプロパティ
scaling クラスターを拡張する方式。「horizontal」、「vertical」、「none」のいずれかを指定します。デフォルト値は、cpus の値が 2 以上ならば「vertical」、そうでなければ「none」になります。
redisServerUrl Collaboration Cluster Cache の URL (Redis Server と組み合わせる場合のみ)。必要なのは拡張方式が「horizontal」の場合に限ります。
cpus このコンピューターで作成するワーカー プロセスの最大数。値を 0 より大きくすると、作成するワーカー プロセスの数を指定できます。値を -1 にすると、コンピューターのコアごとに 1 つのワーカー プロセスが作成されます。デフォルトは 1 です。
ユーザーおよびグループの Cache プロパティ
resetCacheInterval

ユーザーおよびグループ情報のキャッシュをリセットする間隔 (分単位) を指定する、負でない整数。値に 0 を指定すると、デフォルトの間隔である 1440 分 (24 時間) が適用されます。

全般的な構成プロパティ

logging

Collaboration Server の診断ログが有効かどうか。

socketlo

socket.io の設定を保持するオブジェクト。pingInterval および pingTimeout を設定できます。{ &quot;pingInterval&quot;: 25000、 &quot;pingTimeout&quot;: 30000 }

Library の管理サポート プロパティ

secretKey

Library Server と Collaboration Server の間で信頼できる通信を確立するため、Library Server 構成ファイルの identityToken.secretKey と同じ値を指定します。

この信頼できる通信は、Library Admin から Collaboration Server の設定をするために必要です。

MicroStrategy CollaborationサーバーがMicroStrategy Libraryとは別にインストールされている場合は、構成プロパティファイルを変更して接続情報を手動で構成する必要があります。config.json。適切なWindows サーバーでの Collaboration Server の手動構成またはLinux サーバーでの Collaboration Server の手動構成詳細についてはセクションをご覧ください。

デフォルトでは、Library は次の URL と通信ポートを使用してアクセスされます。

http://localhost:8080/MicroStrategyLibrary

デフォルトでは、Collaboration Server は次の URL と通信ポートを使用してアクセスされます。

http://localhost:3000

Collaboration Server のステータスを確認するには、次の URL にアクセスします。

http://localhost:3000/status

この方法は、MicroStrategy Collaboration Server がインストールされているコンピューターからのみ動作します。別のコンピューターからアクセスするには、「localhost」の箇所を、そのコンピューターの完全修飾ドメイン名 (FQDN) に置き換えます。

Collaboration Server を起動するには、通信ポートが使用可能になっている必要があります。

コンポーネント間の通信には、HTTPS ではなく、HTTP を使用します。この配置方法は、ラボ環境における初期テストを行う際には便利ですが、実稼働環境にはお勧めしません。実稼働環境ではセキュリティの確保が最重要項目であるため、安全な配置を実装することをお勧めします。