ログサーバーのインストールと構成
-
ログサーバーのDockerコンテナイメージを(https://www.citrix.com/downloads/citrix-tools/citrixtoolspage/CitrixAlwaysOnTracing-LogServer.html)からダウンロードします。
-
ダウンロードしたファイルを同じディレクトリに配置します。
-
ターミナル (Linux) またはコマンドプロンプト (Windows) を使用して、そのディレクトリでインストーラーを実行し、指示に従います。
注:
-
安全な展開のためには、クライアントとサーバー間の暗号化された通信を保証するHTTPSを強くお勧めします。HTTPの使用は、お客様の判断に委ねられます。
-
選択したポートが既に使用されていないことを確認してください。
-
管理者またはシステムレベルの権限が必要なため、特権ポート(0~1023)の使用は避けてください。
-
ファイアウォールルールが選択したポートでのトラフィックを許可していることを確認してください。
-
有効な範囲(0~65535)内のポート番号を使用しますが、競合を避けるため、システムサービスで一般的に使用されるポートは避けてください。
Linuxへのインストール
chmod +x ./InstallLogServer
# Install with https mode with port 8443 with default path
./InstallLogServer --https --cert </path/your_private_cert_key.pfx> --port 8443
# Install with http mode, with port 8080 with default path
./InstallLogServer --port 8080
# Command to change the config path and data path of your choice with https mode
./InstallLogServer --https --cert </path/your_private_cert_key.pfx> --port 8443 --config /Path/LogServer/Config --database /Path/LogServer/Data
# Command to change the config path and data path of your choice with http mode
./InstallLogServer --port 8080 --config /Path/LogServer/Config --database /Path/LogServer/Data
インストール後、いくつかの便利なスクリプトファイルが生成されます。
# In Linux, sh scripts will be generated
DownloadLogsByTime.sh
DownloadLogsByWords.sh
GetAuthKey.sh
ListMachines.sh
StartLogServer.sh
./StartLogServer.sh を使用してサーバーを起動します。 LogServer が正常に起動したことを確認するには、configpath/weblogs.txt を確認してください。
LogServerが正常に起動すると、weblogsファイルに以下のメッセージが表示されます。ポート5000は、選択されたHTTPまたはHTTPSプロトコルで、Dockerコンテナ内でLogServerによって内部的に使用されます。
Now listening on: https://[::]:5000
ログサーバーがHTTPモードでインストールされた場合、成功したログには以下が表示されます。
Now listening on: http://[::]:5000
注:
-
インストール手順で構成されたポート (8080または8443、あるいは指定された任意のポート) は、DDC、Storefront™、VDAなどでLogServerのURLを構成する際に使用する必要があります。
-
通常、Linuxでは起動に30秒から60秒かかります。
Windowsへのインストール
ステップ1: ログサーバーVMにWindows用Docker Desktop (サブスクリプションが必要な場合があります) をインストールします。
ステップ2: インストールを続行するには、以下のコマンドを実行します。
注:
Config および Database (Data) フォルダーのデフォルトの場所は、C:\Users\<username>\LogServer の下に作成されます。これらは以下のコマンドで変更できます。
#Install with https mode with port 8443 with default path
InstallLogServer.exe --https --cert <c:\path\cert.pfx> --port 8443
#Install with http mode, with port 8080 with default path
InstallLogServer.exe --port 8080
#Command to change the config path and data path of your choice with https mode
InstallLogServer.exe --https --cert <c:\path\cert.pfx> --port 8443 --config C:\LogServer\Config --database C:\LogServer\Datacmd
#Install with specific config path and data path
InstallLogServer.exe --port 8080 --config C:\LogServer\Config --database C:\LogServer\Datacmd
インストール後、インストーラーファイルを保存したのと同じディレクトリに、いくつかの便利なスクリプトファイルが生成されます。
注:
これらのファイルを別の場所に移動できます。ただし、Log Serverを構成する際に再度必要となるため、新しい場所を覚えておいてください。
#In Windows, bat scripts will be generated in the same directory where you saved the installer files.
DownloadLogsByTime.bat
DownloadLogsByWords.bat
GetAuthKey.bat
ListMachines.bat
StartLogServer.bat
ログサーバーを起動するには、
StartLogServer.batを使用します。
LogServerが正常に起動したことを確認するには、configpath\weblogs.txt を確認してください
ログに以下が表示された場合、Log Serverが正常に起動したことを意味します。
LogServerが正常に起動すると、weblogsファイルに以下のメッセージが表示されます。ポート5000は、選択されたHTTPまたはHTTPSプロトコルで、Dockerコンテナ内でLogServerによって内部的に使用されます。
Now listening on: https://[::]:5000
ログサーバーがHTTPモードでインストールされた場合、成功したログには以下が表示されます。
Now listening on: http://[::]:5000
注:
-
インストール手順で構成されたポート(8080または8443、あるいは指定された任意のポート)は、DDC、Storefront、VDAなどでLogServerのURLを構成する際に使用する必要があります。
-
通常、Windowsではハードウェアによって1~10分かかります。
ログサーバーの確認
Log ServerまたはVDAまたはDDCでブラウザを開き、http://YourLogServerFQDN:8080/Pingにアクセスします。 ブラウザに「Pong UTC:08/19/2025 01:03:29」という応答文字列が表示されます。
注:
デフォルトポートを使用していない場合はポート8080を設定済みのポートに変更し、HTTPSモードでインストールした場合はhttpをhttpsに変更してください。
ログサーバーの検証に失敗した場合は、以下のログを確認してください。 dockerログを確認するには
docker logs logserverを実行します。 Linuxの場合- $HOME/LogServer/Config/weblogs.txt (デフォルトを使用していない場合は、$HOME/LogServerを実際のインストールパスに変更してください)
Windowsの場合 -
C:\Users\YourUserName\LogServer\Config\weblogs.txt (YourUserNameを実際のユーザー名に変更してください。デフォルトを使用していない場合は、C:\Users\YourUserName\LogServerを実際のインストールパスに変更してください)
ログサーバーの詳細設定
docker stop logserver を実行してログサーバーを停止します
デフォルトでは、ログサーバーは以下の値で構成されています。変更を行うには、
StartLogServer.sh を編集するか、Windowsにインストールされている場合は StartLogServer.bat を編集します。
-e MAX_RESERVE_DAYS=7 -e MAX_DISK_USAGE_PERCENTAGE=90 -e LOCAL_DOWN_ONLY=true -e OPENSEARCH_JAVA_OPTS="-Xms2G -Xmx2G"
| LogServer構成オプション | デフォルト値 | 値の範囲 | 説明 |
|---|---|---|---|
| MAX_RESERVE_DAYS | 7 | 1~30 | ログサーバーは、タイムスタンプフィールドに基づいてログエントリを最大日数保存します。7日前に挿入されたログは削除されます。10分ごとに確認します。 |
| MAX_DISK_USAGE_PERCENTAGE | 90 | 10~90 | ログサーバーはデータストレージの使用率を監視します。使用率が90%を超えると、ログサーバーは使用率が90%未満になるまで古いログを毎日削除します。10分ごとに確認します。 |
| LOCAL_DOWN_ONLY | 真 | true/false | trueの場合、Log Serverがインストールされているマシンのみが/Download/* APIにアクセスできます。falseの場合、AuthKeyを持つ他のマシンが/Download/* APIにアクセスできます。 |
| OPENSEARCH_JAVA_OPTS | "-Xms2G -Xmx2G" | 2G ~ MaxMem/2 | Opensearchのメモリ構成。Log Serverにログを送信するマシンが多い場合は、より多くのメモリを割り当ててください。 |
| 例: 0~999台のマシン: 2G | |||
| 1000~1999台のマシン: 4G | |||
| 2000~2999台のマシン: 6G |
Linuxで
./StartLogServer.shを使用してログサーバーを起動します。 WindowsでStartLogServer.batを使用してログサーバーを起動します。
変更が適用されたかを確認するには