OCIとオンプレミスのWindows

この項では、管理を設定し、Windowsプラットフォームで実行されているOCIまたはオンプレミス・ホストにプラグインをデプロイするステップについて説明します。JMSフリートは、OCI Windows用のOracle Cloud Agentをサポートしていません。したがって、すべてのWindowsプラットフォームにOracle Management Agentをインストールすることをお薦めします。

前提条件:

管理エージェント・ソフトウェアのダウンロードおよび手動インストールの項の説明に従って、エージェント・ソフトウェアおよびレスポンス・ファイルをダウンロードします。
Windows 10インスタンスの場合、環境変数OVERRIDE_VERSION_CHECKが存在し、trueに設定されて管理エージェント・サービスのバージョン・チェックがオーバーライドされます。管理エージェント・サービスは、Windows 10プラットフォーム上のJava管理サービスのみをサポートします。

ステップ

管理エージェント・ソフトウェアおよびレスポンス・ファイルを保存したフォルダに移動します。
ダウンロードしたレスポンス・ファイルに次の内容が含まれていることを確認します。
- 書式で定義されたタグ:
  [{"jms":{"fleet_ocid":"<fleet_ocid>"}}]
  
  ここで、<fleet_ocid>は、インスタンスを追加するフリートのOCID値です。
- JMSプラグイン・パラメータ:
```
Service.plugin.jm.download=true
Service.plugin.jms.download=true
```
また、レスポンス・ファイルにmgmt_agentユーザーの読取り権限があることも確認します。
管理エージェントのインストールの説明に従って、管理エージェントをインストールして起動します。
ノート
- エージェントがすでにインストールされている場合は、次のステップに進みます。JMSプラグインがまだデプロイされていない場合は、「エージェントを使用したサービス・プラグインのデプロイ」ページの説明に従って、Java使用状況トラッキングおよびJava Management Serviceプラグインを手動でデプロイします。
- エージェントは、JMSの低いテレメトリ頻度でインストールされます。
  Windows 64ビットシステムでは、パラメータを MACS default telemetry frequencyに変更できます。パラメータを変更するには、次のステップを実行します。
  
  コマンド・プロンプトで、NET STOP mgmt_agentと入力して、エージェントが実行中の場合は停止します。
  
  C:\Oracle\mgmt_agent\agent_inst\config\destinations\OCI\services\Agent\1\types\にあるagent.jsonファイルをC:\Oracle\mgmt_agent\$installedVersion\temp_interval\のagent_high_freq.jsonファイルに置き換えます。置換されたファイルの名前がagent.jsonであることを確認します。
  
  コマンド・プロンプトで、NET START mgmt_agentと入力してエージェントを再起動します。
ホストにログインし、管理者としてコマンド・プロンプトを開き、次のコマンドを実行します。

オプション1: 標準機能を使用して使用トラッカを生成します。
```
dir /b C:\Oracle\mgmt_agent\agent_inst\config\destinations\OCI\services\jms >%TEMP%\version.txt
set /p VERSION=<%TEMP%\version.txt
powershell -ep Bypass C:\Oracle\mgmt_agent\agent_inst\config\destinations\OCI\services\jms\%VERSION%\scripts\setup.ps1 --force
```
このスクリプトでは、次のものが作成されます。
- C:\Program Files\Java\confのusagetracker.properties
- C:\ProgramData\Oracle\Javaのusagetracker.log
デフォルトでは、ファイルusagetracker.propertiesには次の行が含まれています:
```
com.oracle.usagetracker.logToFile = C:\\ProgramData\\Oracle\\Java\\usagetracker.log
com.oracle.usagetracker.additionalProperties = java.runtime.name
```
オプション2: WebLogicやTomcatなどのアプリケーション・サーバーで実行されているアプリケーションをより適切に識別するためにuser.nameプロパティを収集する追加機能を使用して、使用状況トラッカを生成します。
管理者としてコマンド・プロンプトを開き、次のコマンドを実行します:
```
dir /b C:\Oracle\mgmt_agent\agent_inst\config\destinations\OCI\services\jms >%TEMP%\version.txt
set /p VERSION=<%TEMP%\version.txt
powershell -ep Bypass C:\Oracle\mgmt_agent\agent_inst\config\destinations\OCI\services\jms\%VERSION%\scripts\setup.ps1 --force --enable-user-name
```
このスクリプトでは、次のものが作成されます。
- C:\Program Files\Java\confのusagetracker.properties
- C:\ProgramData\Oracle\Javaのusagetracker.log
デフォルトでは、usagetracker.propertiesファイルに次の行が含まれています:
```
com.oracle.usagetracker.logToFile = C:\\ProgramData\\Oracle\\Java\\usagetracker.log
com.oracle.usagetracker.additionalProperties = java.runtime.name,user.name
```
詳細は、Java Usage Trackerの有効化と構成を参照してください。
管理エージェントのインストールの検証の説明に従って、インストールを確認します。
オプションです。管理エージェントがデータをJMSフリートにレポートする頻度と、Javaランタイム・インストールを検出するためにホストでスキャンするファイル・システム・パスを指定します。管理エージェントの設定の変更を参照してください。

ログ・ファイルは、C:\Oracle\mgmt_agent\plugins\jm\stateDir\logディレクトリにあります。

Oracle Cloud Infrastructureドキュメント