エージェント・インストール診断の実行
診断コマンドは、インストール・プロセス中の問題のトラブルシューティングに役立ちます。エラー・メッセージ、警告メッセージおよびデバッグ情報が表示されます。このコマンドは、OMAソフトウェア・インストーラおよびインストール・スクリプトに含まれています。このスクリプトは、貴重なフィードバックを提供し、インストールの潜在的な問題を識別します。これは、エージェントのインストールおよびプラグインのデプロイメントを成功させるために、ホスト・マシンで前提条件が満たされているかどうかを判断するのに役立ちます。
インストーラの使用
インストーラで診断を有効にするには、JMS_agent_configuration.rspファイルのjms.diagnosticパラメータをコメント解除(または削除#)し、jms.diagnostic = trueを更新します。
インストール・スクリプトの使用
インストール・スクリプトで、インストール・プロセスを開始する前に次の診断コマンドを実行します。
LinuxおよびmacOSの場合:
$ sudo bash ./JMS_YourFleetName_<linux|macos>.sh --diagnosticWindows (PowerShellを使用)の場合:
.\JMS_YourFleetName_windows.ps1 --diagnostic診断は、可能性のあるすべての有用な情報を収集し、ログ・ファイルに出力を追加します。診断サマリーがすべての結果とともに表示されます。問題がある場合は、診断スクリプトによって、問題の修正方法に関する警告と推奨事項のリストが生成されます。
インストール環境(オペレーティング・システムとオペレーティング・システムのアーキテクチャ)およびエージェント・タイプ(OCAまたはOMA)に基づいて、基準がチェックされ、結果が「はい/いいえ」応答として表示される診断サマリーが提供されます。
診断実行中にチェックされる条件は、インストール環境によって異なる場合があります。次の表に、サポートされているすべてのプラットフォームでチェックされたすべての条件をまとめたリストを示します。
表A-2診断サマリー
| 条件 | ソリューション/推奨事項 |
|---|---|
| ユーザーにsudo/root権限がありますか。 | sudo、rootまたはadministratorアクセス権があることを確認します。
|
| シェルはサポートされていますか。 | 最新のシェル・バージョンを使用していることを確認してください。
詳細は、トラブルシューティングを参照してください。 |
| 認定OS? | オペレーティング・システムのバージョンがサポートされていることを確認します。サポートされているプラットフォームについては、JMSのシステム要件を参照してください。 |
| OCIエンドポイントに到達できますか? | インターネット接続とプロキシ設定を確認します。 |
| 最小ディスク要件を満たしていますか。 | すべてのプラットフォームで300MBの空きディスク領域が必要です。ディスクをクリーンアップして、スクリプトを再実行します。 |
| メモリーの最小要件を満たしていますか。 | JMSプラグインを使用する管理エージェントには、500Mbの空きメモリーが必要です。メモリーをクリーン・アップして、スクリプトを再実行します。 |
| UsersディレクトリにJavaが見つかりましたか。 | Javaは、すべてのユーザーがアクセスできる共通の場所に保管してください。 |
| エージェントのインストールにJavaを使用できますか。 | 最新のOracle JDK 8リリースを使用して管理エージェントを設定していることを確認します。エージェントの前提条件を参照してください。 |
| 管理エージェント・インストーラを使用できますか。 | 使用しているオペレーティング・システムに固有の正しいエージェント・ソフトウェア・インストーラ・ファイルをダウンロードしてください。インストールスクリプトと同じディレクトリにインストーラファイルを保存し、それがアクセス可能かどうかを確認します。
インストーラがスクリプトと同じディレクトリに存在しない場合は、 |
| 既存の管理エージェントが検出されましたか。 | 回答は「はい」または「いいえ」になります。ただし、どちらの回答もエラーにはなりません。 |
| 既存の管理エージェントを新しいバージョンにアップグレードできますか。 | 自動アップグレード機能を有効にしている場合は、新しいバージョンが使用可能になったときにエージェントが自動的にアップグレードされます。ただし、問題が発生した場合:
|
| フリート・チェックに合格しましたか? | フリートOCIDがチェック中に見つかった場合は、エージェントをアップグレードできます。フリートIDが見つからない場合は、--reinstallパラメータを使用してエージェントを再インストールします。
|
| Oracle Cloud Agentの前提条件がインストールされていますか。 | Oracle Cloudエージェントをインストールする前に、次の前提条件を満たしていることを確認します。
|
| Javaの要件を満たす | 実行する次のJavaバージョンがインストールされていることを確認します。
|
| 有効な管理エージェント・インストーラ? | OSに固有の管理エージェント・インストーラ・パッケージにアクセスできることを確認します。問題がある場合は、--use-agent-installer-pathパラメータを指定してスクリプトを再度実行します。
|
| 管理エージェントを解凍できますか。 | スクリプトが管理エージェントを解凍するためにjarおよびunzipユーティリティを使用できない場合、エラーが発生します。管理エージェントを再度ダウンロードし、インストール・スクリプトを実行します。
|
| 既存の管理エージェントにJMSプラグインはありますか。 | 既存の管理エージェントに欠落しているプラグインがある場合は、次のいずれかを実行できます。
|
| 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分以内にホスト・クロックを同期して、スクリプトを再度実行します。
詳細は、クライアント・クロック・スキューの最大数を参照してください。 |