機械翻訳について

問題のトラブルシューティング

WebLogic Remote Consoleで問題を回避およびリカバリする方法について学習します。

基本的なトラブルシューティング・ステップ

  1. 「既知の問題」を確認して、回避策があるかどうかを確認します。
  2. ログ・ファイルでエラーを確認してください。 WebLogic Remote Consoleは、フロント・エンド・プロセスとバック・エンド・プロセスの両方のログ・ファイルを提供します。 これらのファイルにアクセスする方法を学習するには、「ログ・ファイルのチェック」を参照してください。
  3. WebLogic Remote ConsoleおよびWebLogic Remote Console拡張の最新バージョンに更新します。

問題: 接続の問題

WebLogic Remote Consoleから管理サーバーへの接続に問題がある場合は、問題を特定して修正するために実行できるいくつかのステップを次に示します。

  • curlを使用して管理サーバーへのアクセスをテストします:

    • HTTPの場合、実行: curl -v --user <username>:<password> http://<adminServerHost>:<adminServerPort>/management/weblogic/latest/domainConfig
    • HTTPSの場合は実行: 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構成エラー

管理サーバー・プロバイダを変更すると、このエラーが発生する可能性があります。 WebLogic Remote Consoleは、「保存」をクリックしたとき、またはショッピング・カートを使用して変更をコミットしたときに、バリデーション・エラーをチェックします。 エラー・メッセージが表示された場合は、変更をアクティブにする前に問題を特定して修正する必要があります。

コンソール拡張をインストールした場合は、ショッピング・カートのすべての待ち状態の変更を確認できます。

構成エラーの原因が明らかでない場合:

  • WebLogic Remote Consoleおよび管理サーバーからの出力を確認します。
  • WebLogic管理サーバー・ログを確認します。

エラーの原因を特定できない場合は、構成の変更を破棄してから一度に1つずつ実行して、エラーの原因となる変更を分離してみてください。


問題: WDTモデル・ファイルが無効です(そのためドメインをビルドできません)

WebLogic Remote Consoleは、WDTモデル・ファイルに挿入するデータをバリデート「しません」 その結果、WebLogic Remote Consoleは、無効な変更または値を受け入れ、モデル・ファイルを使用してドメインをビルドまたは更新するときに問題が発生する可能性があります。 たとえば、特定の設定で無効または範囲外である整数値を追加したり、サーバーまたはターゲットを削除しても、デプロイメントを更新して別のサーバーまたはターゲットを選択しないと、問題が発生する可能性があります。

許容される値の詳細は、WebLogic Deploy Toolingドキュメントを参照してください。


問題: 自動prefsエラーの読取りに失敗しました

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は次の場所にあります:

  • Linux: $HOME/.config/weblogic-remote-console/auto-prefs.json
  • macOS: /Users/<user>/Library/Application Support/weblogic-remote-console/auto-prefs.json
  • Windows: C:\Users\<user>\AppData\Roaming\weblogic-remote-console\auto-prefs.json

問題: 「編集ツリー / 開始ボタンと停止ボタン / 作成ボタン / …」がありません

管理サーバーにログインするために使用したユーザーのロールを確認します。 WebLogic Remote Consoleの全機能にアクセスできるのは管理者のみです。 デプロイヤ、オペレータ、モニターなどの他のロールを持つユーザーは、職責の範囲外の領域へのアクセスが制限されます。

各ロールのユーザーが表示または実行できる操作の概要は、「アクセスの相違の理解」を参照してください。


問題: ドメインでサーバー間でREST通信の問題が発生しています

管理サーバーは、RESTを使用して自身およびその管理対象サーバーと通信します。 REST通信がブロックされている場合、WebLogic Remote Consoleのモニタリング・パースペクティブは、管理対象サーバーのステータスまたは統計に関する正確な情報をレポートすることも、ほとんどの管理タスクを実行することもできません。 また、「編集」パースペクティブではデプロイメントを作成または削除できません。

REST接続をテストするには:

  1. 管理サーバーのランタイム統計を「すぐに」取得します。
  • 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

    コマンドが失敗すると、より一般的な接続の問題がドメインに影響します。 次のステップについては、「接続の問題」を参照してください。

  1. 管理サーバーのランタイム統計を「間接的に」取得します。
  • 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の問題は、多くの場合、ドメイン構成の欠陥が原因です。 可能性のある原因には、次のものが含まれますが、これらに限定されません:

  • デフォルトの資格証明マッピング・プロバイダの削除
  • デフォルト・アイデンティティ・アサーション・プロバイダの削除
  • デフォルトのアイデンティティ・アサーション・プロバイダのアクティブ・タイプからのweblogic-jwt-tokenの削除
  • WebLogic Server REST APIへの互換性のないREST起動ポリシーの適用。 たとえば、Oracle Web Services Manager (OWSM)を使用してドメインを保護すると、REST APIへのアクセスが誤って制限される場合があります。