エージェント・インストール診断の実行

診断コマンドは、インストール・プロセス中の問題のトラブルシューティングに役立ちます。エラー・メッセージ、警告メッセージおよびデバッグ情報が表示されます。このコマンドは、OMAソフトウェア・インストーラおよびインストール・スクリプトに含まれています。このスクリプトは、貴重なフィードバックを提供し、インストールの潜在的な問題を識別します。これは、エージェントのインストールおよびプラグインのデプロイメントを成功させるために、ホスト・マシンで前提条件が満たされているかどうかを判断するのに役立ちます。

診断の有効化

インストーラおよびインストール・スクリプトで診断を有効にするには、インストール・プロセスを開始する前に次の診断コマンドを実行します:

LinuxおよびmacOSの場合:

$ sudo bash ./JMS_YourFleetName_<linux|macos>.sh --diagnostic

Windows (PowerShellを使用)の場合:

ノート

インストーラまたはインストール・スクリプトを実行するには、PowerShellバージョン5.1または7未満のバージョンが必要です。

.\JMS_YourFleetName_windows.ps1 --diagnostic

診断は、可能性のあるすべての有用な情報を収集し、ログ・ファイルに出力を追加します。診断サマリーがすべての結果とともに表示されます。問題がある場合は、診断スクリプトによって、問題の修正方法に関する警告と推奨事項のリストが生成されます。

ノート

ログ・ファイルは、次のパスに配置できます:

Linuxの場合: /var/log/oracle/JMSInstallScript/
macOSの場合: /Library/Oracle/JMSInstallScript/
Windowsの場合: C:\ProgramData\Oracle\JMSInstallScript

インストール環境(オペレーティング・システムとオペレーティング・システムのアーキテクチャ)およびエージェント・タイプ(OCAまたはOMA)に基づいて、基準がチェックされ、結果が「はい/いいえ」応答として表示される診断サマリーが提供されます。

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

診断に失敗しました:

======================================================================================================
Diagnostic Summary
======================================================================================================
Shell is supported? : Yes
User has sudo/root privileges? : Yes
Certified OS? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Able to reach OCI https://oracle.com endpoint? : Yes
Meets Java requirement? : Yes
Valid Management Agent installer? : No    
   Found 2 files with 'oracle.mgmt_agent*.rpm' pattern in /home/opc folder.    
   Please, run script test_linux.sh again with --use-agent-installer-path parameter.
Management Agent has been detected? : No
======================================================================================================
Diagnostics have failed. Please resolve all issues and run the jms setup installer again.

診断は正常に完了:

======================================================================================================
Diagnostic Summary
======================================================================================================
Shell is supported? : Yes
User has sudo/root privileges? : Yes
Certified OS? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Able to reach OCI https://oracle.com endpoint? : Yes
Meets Java requirement? : Yes
Valid Management Agent installer? : Yes
Existing Management Agent has been detected? : Yes
Existing Management Agent has JMS plugins? : Yes
Existing Management Agent can be upgraded? : Yes
======================================================================================================
Diagnostics have finished running and no error occurred.

診断実行中にチェックされる条件は、インストール環境によって異なる場合があります。次の表に、サポートされているすべてのプラットフォームでチェックされたすべての条件をまとめたリストを示します。

表A-2診断サマリー

条件	ソリューション/推奨事項
ユーザーにsudo/root権限がありますか。	`sudo`、`root`または`administrator`アクセス権があることを確認します。
シェルはサポートされていますか。	最新のシェル・バージョンを使用していることを確認してください。 Windows: PowerShellバージョン5.1以降を使用する必要があります。 Linux: サポートされていないシェルを使用している場合は、シェルを更新し、インストール・スクリプトを再度実行します。
認定OS?	オペレーティング・システムのバージョンがサポートされていることを確認します。サポートされているプラットフォームについては、JMSのシステム要件を参照してください。このチェックをスキップするには、`--ignore-unsupported`パラメータを指定してJMSインストーラ・スクリプトを再度実行します。
OCIエンドポイントに到達できますか?	インターネット接続とプロキシ設定を確認します。
最小ディスク要件を満たしていますか。	すべてのプラットフォームで300MBの空きディスク領域が必要です。ディスクをクリーンアップして、スクリプトを再実行します。
メモリーの最小要件を満たしていますか。	JMSプラグインを使用する管理エージェントには、500Mbの空きメモリーが必要です。メモリーをクリーン・アップして、スクリプトを再実行します。
UsersディレクトリにJavaが見つかりましたか。	Javaは、すべてのユーザーがアクセスできる共通の場所に保管してください。
エージェントのインストールにJavaを使用できますか。	最新のOracle JDK 8リリースを使用して管理エージェントを設定していることを確認します。エージェントの前提条件を参照してください。
管理エージェント・インストーラを使用できますか。	使用しているオペレーティング・システムに固有の正しいエージェント・ソフトウェア・インストーラ・ファイルをダウンロードしてください。インストールスクリプトと同じディレクトリにインストーラファイルを保存し、それがアクセス可能かどうかを確認します。インストーラがスクリプトと同じディレクトリに存在しない場合は、`--use-agent-installer-path`パラメータを使用してパスを指定します。
既存の管理エージェントが検出されましたか。	管理エージェントをすでにインストールしていて、再インストールを続行する場合は、--reinstallパラメータを使用できます。
既存の管理エージェントを新しいバージョンにアップグレードできますか。	自動アップグレード機能を有効にしている場合は、新しいバージョンが使用可能になったときにエージェントが自動的にアップグレードされます。ただし、問題が発生した場合: `--use-agent-installer-path`パラメータを使用してインストーラ・パスを指定して管理エージェントを更新します。または `--reinstall`パラメータを使用して管理エージェントを再インストールします。
フリート・チェックに合格しましたか?	フリートOCIDがチェック中に見つかった場合は、エージェントをアップグレードできます。フリートIDが見つからない場合は、`--reinstall`パラメータを使用してエージェントを再インストールします。
Oracle Cloud Agentの前提条件がインストールされていますか。	Oracle Cloudエージェントをインストールする前に、次の前提条件を満たしていることを確認します。インスタンスは、サポートされている`$OCI_REALM_KEY`レルムにあります。 OCIメタデータおよびインスタンス構成を使用できます。そうでない場合は、`oci-metadata`を手動でインストールするか、`--install-mgmt-agent`引数を使用して管理エージェントを強制的にインストールします。パッケージ`jq`がインストールされているか、手動でインストールしてください。`--install-mgmt-agent`引数を使用して、管理エージェントを強制的にインストールすることもできます。 OCI CLIがインストールされているか、手動でインストールしてスクリプトを再度実行します。`--install-mgmt-agent`引数を使用して、管理エージェントを強制的にインストールすることもできます。
Javaの要件を満たす	実行する次のJavaバージョンがインストールされていることを確認します。管理エージェント- Oracle JDK 1.8以上 OCA JMSプラグイン: Oracle JDK 11以上
有効な管理エージェント・インストーラ?	OSに固有の管理エージェント・インストーラ・パッケージにアクセスできることを確認します。問題がある場合は、`--use-agent-installer-path`パラメータを指定してスクリプトを再度実行します。
管理エージェントを解凍できますか。	スクリプトが管理エージェントを解凍するために`jar`および`unzip`ユーティリティを使用できない場合、エラーが発生します。管理エージェントを再度ダウンロードし、インストール・スクリプトを実行します。
既存の管理エージェントにJMSプラグインはありますか。	既存の管理エージェントに欠落しているプラグインがある場合は、次のいずれかを実行できます。 OCIの「管理エージェント」ページを使用してプラグインをデプロイします `--reinstall`パラメータを指定してスクリプトを実行して、Java Management Serviceで管理エージェントを再インストールします
JMSの高度な機能の要件を満たしていますか。	インスタンスでJMSの拡張機能を有効にするには、`sudo`実行可能ファイルにアクセスできることを確認します。
Oracle Cloud Agentの認定OSはテストされていますか。	Java Management Serviceは、Oracle LinuxでOracle Cloud Agentのみをサポートします。管理エージェントをインスタンスに強制的にインストールするには、`--install-management-agent`引数を使用します。
証明書検証に合格しましたか? ノート現在、このオプションはLinuxおよびmacOSプラットフォームでのみ使用できます。	ファイアウォールとプロキシ設定を確認して、サービスにアクセスできることを確認します。
クロックはOCIプラットフォームと同期していますか? ノート現在、このオプションはLinuxおよびmacOSプラットフォームでのみ使用できます。	ホストのクロックがOCIプラットフォームと同期していることを確認します。同期されていない場合は、OCIプラットフォームの5分以内にホスト・クロックを同期して、スクリプトを再度実行します。詳細は、クライアント・クロック・スキューの最大数を参照してください。

Oracle Cloud Infrastructureドキュメント

エージェント・インストール診断の実行