OCIとオンプレミスのWindows

この項では、Oracle Management Agentを設定し、インストール・スクリプトを使用してOCIまたはオンプレミスのWindowsホストにJMSプラグインをデプロイするステップについて説明します。JMSフリートは、OCI Windows用のOracle Cloud Agentをサポートしていないため、スクリプトはすべてのWindowsプラットフォームにOMAをインストールします。

前提条件:

管理者権限でインストール・スクリプトを実行します。

ノート

デフォルトでは、インストール・スクリプトは次のようになります。

WebLogicやTomcatなどのアプリケーション・サーバーで実行されているアプリケーションをより適切に識別するためにuser.nameプロパティを収集する追加機能を使用して、使用状況トラッカを生成します。この機能を有効にしない場合は、インストール・スクリプトのパラメータ--enable-user-name=falseを更新します。将来、Java Usage Trackerプロパティ・ファイルを変更して、additionalPropertiesセクションにuser.nameを追加または削除できます。
JMSの低いテレメトリ頻度構成でエージェントをインストールします。
Windows 64ビット・システムでは、JMSの低いテレメトリ頻度ではなく、MACSのデフォルトのテレメトリ頻度を使用するオプションがあります。インストール・スクリプトで、パラメータlow-telemetry-intervalの値をfalseに変更します。デフォルト値はtrueです。
OVERRIDE_VERSION_CHECK環境変数が存在しない場合は作成し、Windows 10インスタンスでtrueに設定して、管理エージェント・サービスのバージョン・チェックをオーバーライドします。管理エージェント・サービスは、Windows 10プラットフォーム上のJava管理サービスのみをサポートします。

--helpコマンドを実行して、ユーザー名、プロキシ設定の有効化または無効化などのオプションの説明を表示します。

次に、説明とともにオプション・パラメータを示します。


-u, --uninstall              Uninstall plug-ins, delete configuration files or restore originals from backups and exit.
-r, --reinstall              Uninstall plug-ins, delete configuration files or restore originals from backups and continue installation.
-h, --help                   Print usage message end exit.
--diagnostic                 Determines if prerequisite conditions are met on the host machine to allow for successful agent installation or upgradation, and plug-in deployment. 
                             Installation attempt will be skipped.
--enable-user-name           Generate usage tracker with additional functionality to collect the 'user.name' property for better identification 
                             of applications running on Application Servers like WebLogic and Tomcat servers. 
                             Default value is 'true'. 
--force-32bit-installer      Force 32 bit Management Agent installation. Use this parameter to monitor a 32 bit Windows instance.
--ignore-unsupported         The setup will proceed on an unsupported platform. 
                             Installation might be successful, but not all functionality might work as intended.
--proxy-host                 Add proxy host to curl commands, add or replace line 'ProxyHost = VALUE' in install key before Management Agent setup.
                             Format is --proxy-host="VALUE" (for example, --proxy-host="100.0.0.10").
                             Default is no proxy.
--proxy-port                 Add proxy port to curl commands, add or replace line 'ProxyPort = VALUE' in install key before Management Agent setup.
                             Format is --proxy-port="VALUE" (for example, --proxy-port="8050"). 
--proxy-password             Add proxy password to curl commands, add or replace line 'ProxyPassword = VALUE' in install key before Management Agent setup.
                             Format is --proxy-password="VALUE" (for example, --proxy-password="example"). 
--proxy-realm                Add or replace line 'ProxyRealm = VALUE' in install key before Management  Agent setup.
                             Format is --proxy-realm="VALUE" (for example, --proxy-realm="OC1").
--proxy-user                 Add proxy user to curl commands, add or replace line 'ProxyUser = VALUE' in install key before Management Agent setup.
                             Format is --proxy-user="VALUE" (for example, --proxy-user="opc").
--use-agent-installer-path   Path to management agent installation file if it isn't in the same folder as the install script. 
                             Use the absolute path and not a relative path. For example, --use-agent-installer-path="C:\User\vmUser\Downloads"
--use-java-path              Specify the Oracle Java 8 installation path for agent installation; 
                             if the path is not specified, the script will attempt to find a suitable Oracle Java 8 installation path from the file system. 
                             Use the absolute path and not a relative path. Format is --use-java-path={CUSTOM_PATH}(for example, --use-java-path="C:\Program Files\Java\jdk1.8.0_451").  
--low-metrics-frequency      Installs the agent with low frequency telemetry configuration instead of MACS default frequency. 
                             Default value is 'true'. Applicable on Windows 64 bit instances only. 
--use-agent-display-name     Specify the name to be displayed on the MACS console of your Management Agent.
                             If the name is not specified, the script will generate the name automatically.

ステップ

管理者としてPowerShellを開きます。

ノート

インストーラまたはインストール・スクリプトを実行するには、PowerShellバージョン5.1または7未満のバージョンが必要です。
スクリプトを実行する適切な権限があることを確認するには、Set-ExecutionPolicy RemoteSignedと入力し、Aと答えます。

(オプションの診断チェック)インストールスクリプトおよび管理エージェントソフトウェアを保存したフォルダに移動します。次のコマンドを使用してスクリプトを実行します。

.\JMS_YourFleetName_windows.ps1 --diagnostic

オペレーティング・システムおよびエージェント・タイプに応じて、結果は次のようになります。

診断に失敗しました:

======================================================================================================
Diagnostic Summary
======================================================================================================
User has administrator privileges? : Yes
Powershell version meets requirements? : Yes
Certified OS? : Yes
Able to reach OCI endpoint? : No 
Check your internet connection and proxy setting.
Is clock sync with OCI platform? : Unknown 
The clock sync check was skipped. Can't read headers from provided OCI endpoint.
Certificate verification has been passed? : Unknown 
The certificate check was skipped. Can't read certificate from provided OCI endpoint.
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Available Java for agent installation ? : Yes
Management Agent installer available? : Yes
======================================================================================================
Diagnostics have failed. Please resolve all issues and run the deployMgmtAgent.ps1 script again.

診断は正常に完了:

======================================================================================================
Diagnostic Summary
======================================================================================================
User has administrator privileges? : Yes
Powershell version meets requirements? : Yes
Certified OS? : Yes
Able to reach OCI endpoint? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Available Java for agent installation ? : Yes
Management Agent installer available? : Yes
======================================================================================================
Diagnostics have finished running and no error occurred.

解決策または推奨事項を含む質問の完全なリストは、エージェント・インストール診断の実行を参照してください。

スクリプトおよび管理エージェント・ソフトウェアをダウンロードしたフォルダに移動します。次のコマンドを使用してスクリプトを実行します。
```
.\JMS_YourFleetName_windows.ps1
```
- インストールが成功すると、次のようなメッセージが表示されます。
```
...
Agent was successfully registered using key YourFleetName (ocid1.managementagentinstallkey.oc1.<ocid hash>) and assigned to fleet YourFleetName (ocid1.jmsfleet.oc1.<ocid hash>)
Management Agent with plugins installation has been completed.
```
- エージェントがすでにインストールされている場合、スクリプトはエージェント・ソフトウェアを最新バージョンに更新します(該当する場合)。JMSプラグインがまだデプロイされていない場合は、Java Usage TrackingおよびJava Management Serviceプラグインを「エージェント・ページを使用したサービス・プラグインのデプロイ」の説明に従って手動でデプロイします。または、JMSプラグイン・デプロイメントとともにエージェントを再インストールできます。--forceパラメータを指定してスクリプトを実行します。
(オプション)次のように入力して、インストールが成功したかどうかを確認します: Get-Service -name mgmt_agent。

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

Oracle Cloud Infrastructureドキュメント

OCIとオンプレミスのWindows