WebSphere Enterprise Service Bus バージョン 6.2.0 オペレーティング・システム: AIX、HP-UX、i5/OS、Linux、Solaris、Windows


バージョン間のマイグレーションのトラブルシューティング

WebSphere® ESB の古いバージョンからのマイグレーション時に問題が発生した場合は、このページのトラブルシューティングのヒントを参照してください。

以降のセクションでは、バージョン間のマイグレーションで発生する可能性のある特定のエラーおよび例外について説明し、これらの問題を理解して解決するために実行可能なステップを記載します。

アプリケーション・インストール・エラー

マイグレーション・プロセスで、バージョン 6.0.x または 6.1.x 構成に存在するエンタープライズ・アプリケーションを新しいバージョン 6.2 構成にインストールするオプションを選択する場合、マイグレーションのアプリケーション・インストール・フェーズでエラー・メッセージが表示される可能性があります。

バージョン 6.0.x または 6.1.x 構成内に存在するアプリケーションの デプロイメント情報が誤っている可能性があります。その場合、WebSphere ESB の 旧ランタイムで十分に検証されなかったために XML 文書が誤っているという場合がほとんどです。 ランタイムのアプリケーション・インストール検証プロセスが改善されているため、これらの誤った形式の EAR ファイルのインストールが失敗します。このため、WBIPostUpgrade のアプリケーション・インストール・フェーズで障害が発生し、「E:」エラー・メッセージが生成されます。

マイグレーション中に、アプリケーションのインストールがこのような方法で失敗する場合、以下のいずれかを実行してください。
  • バージョン 6.0.x または 6.1.x アプリケーションの問題を修正してから、再マイグレーションする。
  • マイグレーションを続行し、これらのエラーを無視する。

    この場合、マイグレーション・プロセスでは、障害が起こったアプリケーションはインストールされませんが、他のすべてのマイグレーション手順は完了します。

    後で、アプリケーションの問題を修正してから、管理コンソールまたはインストール・スクリプトを使用して新しい バージョン 6.2 構成に手動でインストールできます。

アプリケーション・サーバー・エラー

管理対象ノードをバージョン 6.2 にマイグレーションしても、アプリケーション・サーバーが始動しない場合があります。

アプリケーション・サーバーを始動しようとすると、以下の例のようなエラーが発生する場合があります。
[5/11/06 15:41:23:190 CDT] 0000000a SystemErr  R  
    com.ibm.ws.exception.RuntimeError:
com.ibm.ws.exception.RuntimeError:  org.omg.CORBA.INTERNAL: 
   CREATE_LISTENER_FAILED_4
vmcid: 0x49421000  minor code: 56  completed: No
[5/11/06 15:41:23:196 CDT] 0000000a SystemErr  R  at
com.ibm.ws.runtime.WsServerImpl.bootServerContainer(WsServerImpl.java:198)
[5/11/06 15:41:23:196 CDT] 0000000a SystemErr  R  at
com.ibm.ws.runtime.WsServerImpl.start(WsServerImpl.java:139)
[5/11/06 15:41:23:196 CDT] 0000000a SystemErr  R  at  
com.ibm.ws.runtime.WsServerImpl.main(WsServerImpl.java:460)
[5/11/06 15:41:23:196 CDT] 0000000a SystemErr  R  at  
com.ibm.ws.runtime.WsServer.main(WsServer.java:59)
[5/11/06 15:41:23:196 CDT] 0000000a SystemErr  R  at  
sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
[5/11/06 15:41:23:196 CDT] 0000000a SystemErr  R  at  
sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:64)
[5/11/06 15:41:23:197 CDT] 0000000a SystemErr  R  at  
sun.reflect.DelegatingMethodAccessorImpl.invoke
    (DelegatingMethodAccessorImpl.java:43)
管理対象ノードのサーバーが listen するポート番号を変更します。例えば、Deployment Manager がポート 9101 で ORB_LISTENER_ADDRESS を listen している場合、管理対象ノードのサーバーはポートで 9101 で ORB_LISTENER_ADDRESS を listen していてはなりません。この例のような問題を解決するには、以下の手順を実行します。
  1. 管理コンソールで、「アプリケーション・サーバー」 > server_name > 「ポート」 > 「ORB_LISTENER_ADDRESS」をクリックします。
  2. ORB_LISTENER_ADDRESS のポート番号を使用されていない番号に変更します。

例外: データベースの接続性、ロード、またはクラス欠落

プロファイル作成の一部として設定された WebSphere Application Server 変数は、変更しないでください。

古いプロファイルに設定されているこれらの変数を変更した場合、以下のように、データベース接続やロードなどのクラス欠落例外が発生す る可能性があります。

10/25/08 13:22:39:650 GMT+08:00] 0000002e J2CUtilityCla E J2CA0036E: An exception occurred while invoking method setDataSourceProperties on com.ibm.ws.rsadapter.spi.WSManagedConnectionFactoryImpl used by resource jdbc/com.ibm.ws.sib/ewps6101.Messaging-BPC.cwfpcCell01.Bus : com.ibm.ws.exception.WsException: DSRA0023E: The DataSource implementation class "com.ibm.db2.jcc.DB2XADataSource" could not be found.DB2,

Derby ドライバーと SQL Embedded JDBC ドライバーは、 WebSphere ESB の製品インス トールにバンドルされています。これらのドライバーを上位バージョンに変更する必要がある場合、 以下に示すとおり、製品インストールと同じ場所にドライバーをコピーする必要があります。
  • Derby: %was.install.root%¥derby¥lib
  • DB2: %was.install.root%/universalDriver_wbi/lib
  • SQL: %was.install.root%lib
新規の JDBC プロバイダーとデータ・ソースがアプリケーションに対して必要な場合、有効な jdbcclasspath を選択して WebSphere Application Server 変数を設定することにより、これらのリソースを作成することができます。例えば、前のインストールでは存在しなかった DB2 をセル・レベルで設定する必要がある場合、 以下の手順を実行します。
  1. 管理コンソールで、「リソース」 > 「JDBC」 > 「JDBC プロバイダー」 > 「DB2 Universal JDBC ドライバー・プロバイダー (XA)」にナビゲートします。
  2. 「クラスパス」ボックスで、以下のパスを 設定します。
    • DB2UNIVERSAL_JDBC_DRIVER_PATH =%was.install.root%/universalDriver_wbi/lib
    • DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH=""
    独自のドライバーが必要な場合は、パスとして DB2UNIVERSAL_JDBC_DRIVER_PATH=%myDriverLocation% を設定します。

メモリー不足エラー

メモリー不足の問題により、WBIPreUpgrade または WBIPostUpgrade のいずれかのコマンド行ユーティリティーが失敗する場合には、ヒープ・サイズを、マイグレーションする環境のサイズとスコープ、およびマシンが許容するサイズを考慮した値に増やすことができます。

ヒープ・サイズを増やす方法については、「Handling certain Out of Memory conditions when migrating an earlier version of WebSphere Application Server to V6.0.2, V6.1, or 7.0」という技術情報の『Solution 4』で説明する手順を参照してください。

プロファイルの作成エラー

構成をマイグレーションする場合、バージョン 6.2 マイグレーション・ウィザードを使用してプロファイルを作成している際に、以下のプロファイル作成エラー・メッセージが表示されることがあります。

profileName: profileName cannot be empty
profilePath: Insufficient disk space

これらのエラー・メッセージは、プロファイル名にスペースなどの正しくない文字が含まれている場合に表示される可能性があります。マイグレーション・ウィザードを再実行して、プロファイル名にスペース、引用符、他の特殊文字などの正しくない文字が含まれていないことを確認してください。

プロファイル・マイグレーション・エラー

マイグレーション・ウィザードを使用して、Solaris x64 プロセッサー・ベースのシステム上でプロファイルを WebSphere ESB バージョン 6.0.x または 6.1.x から バージョン 6.2 にマイグレーションする場合は、WBIPostUpgrade ステップ中にマイグレーションが失敗する可能性があります。

profile_root/logs/WASPostUpgrade.time_stamp.log内に、以下のようなメッセージが記録される場合があります。
MIGR0327E: stopNode で障害が発生しました。
MIGR0272E: マイグレーション機能がコマンドを完了できません。

WebSphere ESB バージョン 6.0.x または 6.1.x は、Java™ 仮想マシン (JVM) を 32 ビット・モードで使用します。WebSphere ESB バージョン 6.2 のマイグレーション・ウィザードは、WBIPostUpgrade.sh スクリプトを呼び出します。このスクリプトは、サーバーが バージョン 6.0.x または 6.1.x ノードを停止すると、バージョン 6.0.x または 6.1.x 用の JVM を 64 ビット・モードで実行しようとします。

以下のアクションを実行して、不完全なプロファイルを除去し、WebSphere ESBバージョン 6.0.x または 6.1.x プロファイルを正しくマイグレーションできるようにします。
  1. コマンド行で、install_root/bin ディレクトリーに変更します。
    例えば、以下のコマンドを入力します。
    cd /opt/IBM/WebSphere/ESB/bin
  2. install_root/bin ディレクトリー内で WBIPostUpgrade.sh スクリプトを見つけ、バックアップ・コピーを作成します。
  3. WBIPostUpgrade.sh またはWBIPostUpgrade.bat ファイルをエディターで開き、以下のアクションを実行します。
    1. 以下のコード行を見つけます。
      For UNIX operating systemFor Linux operating system
      "$binDir" /setupCmdLine.sh
      For Windows operating system
      call "%~dp0setupCmdLine.bat" %*
    2. 前のステップで識別されたコードの後ろに、以下のコード行を挿入します。
      JVM_EXTRA_CMD_ARGS=""
    3. 変更を保管します。
  4. WASPostUpgrade.sh または WASPostUpgrade.bat ファイルについて、ステップ 2 から 4 を繰り返します。
  5. マイグレーション・プロセス中に作成された不完全な バージョン 6.2 プロファイルを削除します。以下の手順を使用します。
    1. コマンド・プロンプトを開き、使用するオペレーティング・システムに基づいて以下のいずれかのコマンドを実行します。
      • For i5/OS operating system i5/OS® プラットフォーム: manageprofiles -delete -profileName profile_name
      • For Linux operating systemFor UNIX operating system Linux® および UNIX® プラットフォーム: manageprofiles.sh -delete -profileName profile_name
      • For Windows operating system Windows® プラットフォーム: manageprofiles.bat -delete -profileName profile_name

      変数 profile_name は削除するプロファイルの名前を示します。

    2. 以下のログ・ファイルを調べて、プロファイルの削除が完了したことを確認します。
      • For i5/OS operating system i5/OS プラットフォーム: user_data_root/profileRegistry/logs/manageprofiles/profile_name_delete.log
      • For Linux operating systemFor UNIX operating system Linux および UNIX プラットフォーム: install_root/logs/manageprofiles/profile_name_delete.log
      • For Windows operating system Windows プラットフォーム: install_root¥logs¥manageprofiles¥profile_name_delete.log
  6. 前のステップで除去した バージョン 6.2 プロファイルの profile_root ディレクトリーを削除します。
  7. マイグレーション・ウィザードを再実行します。

同期エラー

管理対象ノードをバージョン 6.2 にマイグレーションするときに同期化が失敗する場合は、サーバーが始動しない場合があります。

管理対象ノードをバージョン 6.2 にマイグレーションすると、以下のようなメッセージが記録される場合があります。
ADMU0016I: ノードとセルの間で構成を同期しています。
ADMU0111E: プログラムがエラーで終了します:
           com.ibm.websphere.management.exception.AdminException: ADMU0005E:
           リポジトリーを同期化しようとしてエラーが発生しました
ADMU0211I: エラーの詳細については次のファイルを参照してください:
           /opt/WebSphere/62AppServer/profiles/AppSrv02/logs/syncNode.log
MIGR0350W: SOAP プロトコルによるデプロイメント・マネージャーとの同期化に
失敗しました。
MIGR0307I: 前の WebSphere Application Server 環境のリストアが完了しました。
MIGR0271W: マイグレーションは、1 つ以上の警告を伴って、正常に完了しました。
これらのメッセージは、以下のことを示しています。
  • Deployment Manager の構成レベルがバージョン 6.2 になっている。
  • これからマイグレーションする管理対象ノードの構成レベルが (アプリケーションも含めて)、Deployment Manager のリポジトリーでバージョン 6.2 になっている。
  • syncNode 操作を完了しなかった場合は、管理対象ノードが全く完了していない。
以下のアクションを実行して、この問題を解決します。
  1. ノード上で syncNode コマンドを再実行し、ノードを Deployment Manager と同期化します。

    syncNode コマンド』を参照してください。

  2. GenPluginCfg コマンドを実行します。

    GenPluginCfg コマンド』を参照してください。


reference 参照トピック

ご利用条件 | フィードバック


タイムスタンプ・アイコン 最終更新: 2010/07/05


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic//com.ibm.websphere.wesb620.doc/doc/tmig_vtv_troublesht.html
Copyright IBM Corporation 2005, 2010. All Rights Reserved.
このインフォメーション・センターでは Eclipse テクノロジーが採用されています (http://www.eclipse.org)。