ログサーバーのインストールと構成

1. ログサーバーのDockerコンテナイメージをCitrixダウンロードからダウンロードします。
2. ダウンロードしたファイルを同じディレクトリに配置します。
3. ターミナル (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
<!--NeedCopy-->

インストール後、いくつかの便利なスクリプトファイルが生成されます。

# In Linux, sh scripts will be generated

DownloadLogsByTime.sh
DownloadLogsByWords.sh
GetAuthKey.sh
ListMachines.sh
StartLogServer.sh
<!--NeedCopy-->

./StartLogServer.sh を使用してサーバーを起動します。 LogServer が正常に起動したことを確認するには、configpath/weblogs.txt を確認してください。

LogServerが正常に起動すると、weblogsファイルに以下のメッセージが表示されます。ポート5000は、選択されたHTTPまたはHTTPSプロトコルでDockerコンテナ内のLogServerによって内部的に使用されます。

Now listening on: https://[::]:5000
<!--NeedCopy-->

ログサーバーがHTTPモードでインストールされた場合、成功したログには以下が表示されます。

Now listening on: http://[::]:5000
<!--NeedCopy-->

注：

• インストール手順で構成されたポート (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
<!--NeedCopy-->

インストール後、インストーラーファイルを保存したのと同じディレクトリに、いくつかの便利なスクリプトファイルが生成されます。

注：

これらのファイルを別の場所に移動しても構いません。ただし、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
<!--NeedCopy-->

StartLogServer.batを使用してログサーバーを起動します。

configpath\weblogs.txtを確認して、LogServerが正常に起動したことを確認します。

ログに以下が表示された場合、Log Serverが正常に起動したことを意味します。

LogServerが正常に起動した場合、weblogsファイルに以下のメッセージが表示されます。ポート5000は、選択されたhttpまたはhttpsプロトコルで、LogServerによってDockerコンテナ内で内部的に使用されます。

Now listening on: https://[::]:5000
<!--NeedCopy-->

ログサーバーがHTTPモードでインストールされている場合、成功したログには以下が表示されます。

Now listening on: http://[::]:5000
<!--NeedCopy-->

注:

• インストール手順で設定されたポート（8080、8443、または指定された任意のポート）は、DDC、Storefront、VDAなどでLogServerのURLを設定する際に使用する必要があります。
• 通常、Windowsではハードウェアに応じて1～10分かかります。

ログサーバーの確認

ログサーバー、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を実行します

デフォルトでは、ログサーバーは以下の値で構成されています。変更を行うには、Windowsにインストールされている場合はStartLogServer.shまたはStartLogServer.batを編集してください。

-e MAX_RESERVE_DAYS=7 -e MAX_DISK_USAGE_PERCENTAGE=90 -e LOCAL_DOWN_ONLY=true -e OPENSEARCH_JAVA_OPTS=”-Xms2G -Xmx2G”

Linuxで./StartLogServer.shを使用してログサーバーを起動します。 WindowsでStartLogServer.batを使用してログサーバーを起動します。

変更が適用されたかを確認するには