OpenLM Reports Scheduler設定

OpenLM EasyAdmin ユーザーインターフェースには、ライセンス使用状況に関する情報を表示するさまざまなレポートが含まれています。EasyAdmin では、次の方法でレポートを共有できます:

1. 管理者以外のアカウントにレポート閲覧権限を付与する
2. カスタム生成されたレポート URL を共有する
3. レポートをメールで特定のユーザー/グループ/個別アドレスに共有する（.png、.csv などの形式）

既定では、これらのレポートはユーザーが該当機能を要求またはアクセスしたときに手動で生成されます。OpenLM Reports Scheduler 拡張により、管理者は事前に定義したスケジュールに従ってレポートを自動生成できます。

Overview

レポートをスケジュールするには、OpenLM 管理者は次を実施します:

1. EasyAdmin の "Email" モジュールで有効な SMTP サーバーを設定します。
2. EasyAdmin の認証が有効な場合、EasyAdmin に管理者アカウントがあることを確認し、Scheduler に設定します。
3. 特定の EasyAdmin レポートを開き、フィルターを設定します（例: License Usage レポート）。
4. Share → Schedule をクリックし、頻度とレポート受信者を定義して保存します。

これで、スケジュールされたレポートは指定した時刻に受信者へ送信されます。スケジュールされたレポートは通常のレポートと同じデータを表示しますが、自動生成される点が異なります。これは、直近期間を表示する日付範囲フィルター（例: "Last 7 days"）と併用するのに適しています。

EasyAdmin を設定してスケジュールレポートを作成する

Email の設定

OpenLM Reports Scheduler はメールでレポートを送信するため、EasyAdmin Start → Administration → Email/SMS モジュールで有効なメールサーバーを設定する必要があります。

エラー発生時の通知に使用されるため、Recipient Addresses は少なくとも 1 つ以上入力することを強く推奨します。

受信者ユーザーのメールアカウント設定

既定では、スケジュールレポートは特定のユーザーに紐づいています。多くの場合、このユーザーはスケジュールレポートを設定した管理者です。このユーザーは OpenLM データベースに存在し、有効なメールアカウントが関連付けられている必要があります。

ユーザーのメールアドレスを設定するには、EasyAdmin User Interface Start → Users & Groups → Users を開きます。対象ユーザーを見つけてダブルクリックし、以下の画像のようにユーザー詳細を編集します:

OpenLM でユーザー（および他のエンティティ）を作成する方法の詳細は、次のアプリケーションノートを参照してください: Introducing Entities in OpenLM - Users, Groups, IP and Hosts

OpenLM Reports Scheduler の構成

report_scheduler.properties ファイルの編集

report_scheduler.properties ファイルには、Reports Scheduler の設定がすべて保存されています。通常、運用に必要な設定のほとんどはインストール時に定義されるか、（アップグレード時に）以前のバージョンから引き継がれます。EasyAdmin を設定してスケジュールレポートを作成する の手順に従っている限り、手動編集は不要です。

ただし、次のような特別なケースでは編集が可能であり、必要になる場合があります:

• EasyAdmin に SMTP サーバーを設定していない場合。既定では、EasyAdmin の SMTP 設定が report_scheduler.properties の設定より優先されますが、何らかの理由で SMTP が設定されていない場合は mail 変数で SMTP を個別に設定できます。これにより、Reports Scheduler と Server の統合でエラーが発生した際に管理者へメール通知を送ることができます。
• OpenLM SLM のホスト名（Server とは別マシンにインストールされている場合）や既定の通信ポートが変更された場合。

管理者が主に設定する変数は次のとおりです:

Variable	Possible value	Description
mail.smtp.host*	ユーザー指定	SMTP サーバーのホスト名または IP。
mail.smtp.port*	ユーザー指定	SMTP サーバーのポート。
mail.smtp.auth*	true or false	SMTP サーバーが認証を必要とするかに応じて設定します。
mail.smtp.ssl*	true or false	SMTP サーバーが SSL 接続を使用するかに応じて設定します。
mail.smtp.username*	ユーザー指定	SMTP サーバーのユーザー。
mail.smtp.password*	ユーザー指定	SMTP サーバーのパスワード。
mail.smtp.sender*	ユーザー指定	"from:" フィールドに表示されるメールアドレス。
mail.recipients*	ユーザー指定	セミコロン区切りの受信者メールアドレス。
openlm.protocol	http (default) or https	OpenLM の API ポートで使用するプロトコル。
openlm.host	localhost (default) or FQDN	Reports Scheduler が同期する OpenLM SLM のホスト名。SSL 接続が必要な場合は localhost を FQDN に変更します。
openlm.soap.port	Default: 5015	OpenLM SLM API ポート。
openlm.ea.port	Default: 5015	OpenLM の EasyAdmin ポート。
openlm.ea.host	localhost (default) or FQDN	OpenLM の EasyAdmin ホスト名（OpenLM SLM のホスト名と同一）。SSL 接続が必要な場合は localhost を FQDN に変更します。
openlm.ea.protocol	http (default) or https	OpenLM の EasyAdmin 通信プロトコル。http または https を設定できます。
openlm.client.id	Identity Service の Web UI でユーザーが Identity Service と Reports Scheduler を接続すると自動設定（例: openlm.reportscheduler.client）	セキュア接続用の Reports Scheduler のクライアント ID。
openlm.client.secret	openlm.client.id と同様に自動設定	セキュア接続用の Reports Scheduler のクライアントシークレット。
openlm.client.scope	openlm.client.id と同様に自動設定（例: openlm.server.scope）	セキュア接続用の Reports Scheduler のクライアントスコープ。
scheduler.report.files.directory	ユーザー指定	レポートをローカルに保存する場合のディレクトリパス。
webdriver.impl.path	Default: chromedriver.exe	ChromeDriver を別パスで使う場合に変更します。

* 注: 設定されていない場合、Reports Scheduler は EasyAdmin で設定された SMTP サーバー設定を使用します。

params.js ファイルの設定（OpenLM SLM (EasyAdmin) と Report Scheduler の接続）

OpenLM SLM (EasyAdmin) と Report Scheduler を別のコンピュータ/サーバーにインストールしていて接続できない場合（例: 既定ホスト 127.0.0.1 への接続エラーが発生する場合）、OpenLM SLM の params.js ファイル内のホスト名とポート番号を変更して、Report Scheduler のホストとポートに接続できるようにします。手順は次のとおりです:

OpenLM SLM の params.js ファイルは、既定では次のパスにあります:

C:\Program Files\OpenLM\OpenLM Server\bin\wwwroot\params.js

Report Scheduler のスケジューリングタスク URL は params.js に記載されており、次の画像のとおりです:

hostname および/またはポート番号を、Report Scheduler がインストールされているコンピュータ/サーバーの値に変更します。

セキュア環境での Reports Scheduler 設定

ケース 1: Identity Service 経由の接続

Identity Service を介してセキュア環境で Report Scheduler を構成するには、次の手順に従います:

OpenLM SLM、Identity Service、Report Scheduler が同一マシンにインストールされている必要があります:

1. OpenLM SLM をインストールします。手順は OpenLM SLM インストールガイド を参照してください。
2. Identity Service をインストールします。手順は OpenLM Identity Service インストールガイド を参照してください。
3. Report Scheduler をインストールします。手順は OpenLM Reports Scheduler インストールガイド を参照してください。
4. これらのアプリケーションを Identity Service を介して接続するように設定します。OpenLM SLM と Report Scheduler は Identity Service で接続され、以下の画面のようになります。

Report Scheduler を Identity Service と連携するには、Identity Service → Settings → Security Configuration に移動し、トグルボタン をオンにして Report Scheduler の URL（ポート: 8888）を追加します。Save ボタンで情報を保存します。

5. 変更を反映するために Report Scheduler を再起動し、OpenLM SLM も再起動します。

Report Scheduler を再起動するには、Services > OpenLM Reports Scheduler を選択し、Restart をクリックしてサービスを再起動します。

同様に、OpenLM SLM を再起動するには、Services > OpenLM SLM を選択し、Restart をクリックしてサービスを再起動します。

Report Scheduler は Identity Service とセキュア環境で接続され、次の画面のようになります:

report_scheduler.properties ファイルは、次の画像のように client.id と client.secret で更新されます。

ケース 2: HTTPS 経由の接続

OpenLM SLM が HTTPS で接続されている場合、OpenLM Report Scheduler も HTTPS で接続する必要があります。

注意: OpenLM SLM と OpenLM Report Scheduler の両方が HTTPS で接続されていない場合、OpenLM SLM は OpenLM Report Scheduler に接続できません。

OpenLM Report Scheduler プロパティファイルで必要な変更

OpenLM Report Scheduler を HTTPS で接続するには、次の手順を実施します:

1. OpenLM Report Scheduler のプロパティファイルに移動します。

2. openlm.protocol と openlm.ea.protocol のプロトコルを HTTPS に変更します。

3. openlm host を Fully Qualified Domain Name に変更します。

4. サーバープロトコルを HTTPS に変更します。

5. Report Scheduler のプロパティファイルを保存して変更を反映します。

OpenLM SLM の params.js ファイルで必要な変更

1. OpenLM SLM の params.js ファイルに移動します。

2. var _schedulingTaskURL で http を https に変更します。

3. OpenLM SLM の params.js ファイルを保存して変更を反映します。

OpenLM Identity Service の appsettings.json ファイルで必要な変更

1. OpenLM Identity Service の appsettings.json ファイルに移動します。

2. scheduler URL を HTTPS に変更し、appsettings.json を保存します。

OR

OpenLM Identity Service UI で Security Configuration タブに移動し、Report Scheduler の URL を HTTPS に変更します。

"OpenLM Reports Scheduler" サービスを再起動します。

OpenLM SLM は HTTPS 経由で Report Scheduler に接続されます。

OpenLM Reports Scheduler の使用方法

レポートのスケジュール設定

1. レポートをスケジュールするには、EasyAdmin レポート（例: License Usage）を開きます。

2. 必要に応じてレポートの項目、フィルター、その他オプションを設定します。

3. レポートウィンドウ左下の Share をクリックし、Schedule をクリックします。

4. Schedule Report ウィンドウが表示されます:

ここで設定できる内容:

• レポートの頻度（例: 毎週日曜 01:00 AM）
• 受信者: 既存のユーザー/グループ、または複数の直接メールアドレスを指定できます。ユーザー/グループ受信者の場合は、ユーザーまたはグループ内ユーザーに有効なメールアドレスが関連付けられている必要があります。
• Job Description: ここで入力したテキストはメールレポートに含まれます。
• Receiving User Timezone: 受信者が OpenLM SLM と異なるタイムゾーンにいる場合、このオプションで送信タイミングを調整できます。

5. OK をクリックしてレポートを保存し、ウィンドウを Close します。

スケジュールレポートの管理

作成済みのスケジュールタスクを管理するには:

1. EasyAdmin Start → Scheduling Tasks をクリックします。

2. 表示されたウィンドウで、変更したいタスクを選択します。Edit、Delete、Disable/Enable、Show URL を実行できます（Share → Share Link と同じ機能です）。