WebLogic Remote Consoleで問題を回避およびリカバリする方法について学習します。
WebLogic Remote Consoleから管理サーバーへの接続に問題がある場合は、問題を特定して修正するために実行できるいくつかのステップを次に示します。
curlを使用して管理サーバーへのアクセスをテストします:
curl -v --user <username>:<password> http://<adminServerHost>:<adminServerPort>/management/weblogic/latest/domainConfig
curl -v -k --user <username>:<password> https://<adminServerHost>:<adminServerPort>/management/weblogic/latest/domainConfig
HTTPS接続でcurlコマンドが成功した場合、WebLogic Remote Consoleが管理サーバーのSSL証明書を信頼しないことが原因で、接続の問題が発生する可能性があります。 これを修正するには、管理サーバーの証明書をクライアントのキーストアにインポートするか、デモ証明書を使用している場合は、管理サーバーへの接続時に「安全でない接続」オプションをオンにします。
curlコマンドの実行後に401エラーが表示された場合は、WebLogicユーザーに次のいずれかのロールが割り当てられていることを確認してください: 管理、デプロイヤ、オペレータまたはモニター。
WebLogic Serverドメインが別のネットワークにある場合、WebLogic Remote Consoleの「プロキシ・サーバーの構成」。
ドメインがロード・バランサまたはファイアウォールの背後にある場合、またはDockerコンテナ内にある場合は、管理サーバーの管理エンドポイント(management/*
)がクライアントからアクセスできることを確認してください。
管理サーバー・プロバイダを変更すると、このエラーが発生する可能性があります。 WebLogic Remote Consoleは、「保存」をクリックしたとき、またはショッピング・カートを使用して変更をコミットしたときに、バリデーション・エラーをチェックします。 エラー・メッセージが表示された場合は、変更をアクティブにする前に問題を特定して修正する必要があります。
コンソール拡張をインストールした場合は、ショッピング・カートのすべての待ち状態の変更を確認できます。
構成エラーの原因が明らかでない場合:
エラーの原因を特定できない場合は、構成の変更を破棄してから一度に1つずつ実行して、エラーの原因となる変更を分離してみてください。
WebLogic Remote Consoleは、WDTモデル・ファイルに挿入するデータをバリデート「しません」。 その結果、WebLogic Remote Consoleは、無効な変更または値を受け入れ、モデル・ファイルを使用してドメインをビルドまたは更新するときに問題が発生する可能性があります。 たとえば、特定の設定で無効または範囲外である整数値を追加したり、サーバーまたはターゲットを削除しても、デプロイメントを更新して別のサーバーまたはターゲットを選択しないと、問題が発生する可能性があります。
許容される値の詳細は、WebLogic Deploy Toolingドキュメントを参照してください。
WebLogic Remote Consoleアプリケーションが、このエラーで予期せず停止した場合: Failure reading auto prefs
: auto-prefs.json
ファイルが破損している可能性があります。auto-prefs.json
は、WebLogic Remote Consoleに関する状態情報を保存し、破損かぎりユーザーが変更しないでください。
ファイルが破損している場合はリセットできますが、プロジェクトに関するデータはすべて失われます。
ファイルをリセットするには、auto-prefs.json
ファイルを削除してから、WebLogic Remote Consoleを再起動します。
auto-prefs.json
は次の場所にあります:
$HOME/.config/weblogic-remote-console/auto-prefs.json
/Users/<user>/Library/Application Support/weblogic-remote-console/auto-prefs.json
C:\Users\<user>\AppData\Roaming\weblogic-remote-console\auto-prefs.json
管理サーバーにログインするために使用したユーザーのロールを確認します。 WebLogic Remote Consoleの全機能にアクセスできるのは管理者のみです。 デプロイヤ、オペレータ、モニターなどの他のロールを持つユーザーは、職責の範囲外の領域へのアクセスが制限されます。
各ロールのユーザーが表示または実行できる操作の概要は、「アクセスの相違の理解」を参照してください。
管理サーバーは、RESTを使用して自身およびその管理対象サーバーと通信します。 REST通信がブロックされている場合、WebLogic Remote Consoleのモニタリング・パースペクティブは、管理対象サーバーのステータスまたは統計に関する正確な情報をレポートすることも、ほとんどの管理タスクを実行することもできません。 また、「編集」パースペクティブではデプロイメントを作成または削除できません。
REST接続をテストするには:
HTTPの場合は、次を実行します:
curl -v --user <username>:<password> http://<adminServerHost>:<adminServerPort>/management/weblogic/latest/serverRuntime
HTTPSの場合は、次を実行します:
curl -v -k --user <username>:<password> https://<adminServerHost>:<adminServerPort>/management/weblogic/latest/serverRuntime
コマンドが失敗すると、より一般的な接続の問題がドメインに影響します。 次のステップについては、「接続の問題」を参照してください。
HTTPの場合は、次を実行します:
curl -v --user <username>:<password> http://<adminServerHost>:<adminServerPort>/management/weblogic/latest/domainRuntime/serverRuntimes/<adminServerName>
HTTPSの場合は、次を実行します:
curl -v -k --user <username>:<password> https://<adminServerHost>:<adminServerPort>/management/weblogic/latest/domainRuntime/serverRuntimes/<adminServerName>
このコマンドが失敗した場合、問題はサーバー間のREST通信障害です。
REST通信に影響する問題を特定して解決する必要があります。 RESTの問題は、多くの場合、ドメイン構成の欠陥が原因です。 可能性のある原因には、次のものが含まれますが、これらに限定されません: