WebSphere Enterprise Service Bus for z/OS バージョン 6.2.0 オペレーティング・システム: z/OS


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

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

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

同期エラー

管理対象ノードをバージョン 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 コマンド』を参照してください。

WBIPreUpgrate および WBIPostUpgrade エラー

WebSphere ESB の旧バージョンから バージョン 6.2 にマイグレーションしているときに問題が発生する場合は、ログ・ファイルや他の入手可能な情報を確認してください。

  • WBIPostUpgrade ステップの前にマイグレーション・ジョブが失敗する場合は、マイグレーション・ジョブを再実行してください。
  • WBIPostUpgrade ステップでマイグレーション・ジョブが失敗する場合は、新しい バージョン 6.2 サーバーの構成が一部しか更新されていないので、新しい バージョン 6.2 サーバーを再作成 (または バックアップから復元) してから、マイグレーション・ジョブを再実行します。
  • 管理対象 (統合) ノードのマイグレーションで問題が発生する。

    統合ノードは、マイグレーションの対象としては最も複雑なノードです。基本的に 2 つのマイグレーションが 1 つになっているためです。統合ノードでは、Deployment Manager のマスター・リポジトリーに含まれているノード構成情報と、統合ノードに含まれている構成情報をマイグレーションすることが必要です。統合ノードのマイグレーションには、Deployment Manager とのアクティブ接続が必要です。セキュリティーを有効にしてある場合は、マイグレーション・ジョブの作成時に生成された説明に従うことが必要です。マイグレーション・ジョブは、セキュア接続を取得するために正しく構成されている WebSphere 管理者ユーザー ID を使用して実行依頼する必要があります。

    バージョン 6.2 Deployment Manager へのマイグレーション中に混合セル内で Deployment Manager のノード名を変更すると、バージョン 6.x ノード・エージェントは同期化されていないと表示されるか、使用不可として表示される場合があります。バージョン 6.x のノード・エージェントは、再始動されるまで、バージョン 6.x の Deployment Manager へのリンクを維持します。したがって、新しい Deployment Manager との同期化に失敗する可能性があります。自動同期化を阻止するディスカバリーの問題は、マイグレーション中に Deployment Manager の名前が変更されたことをノード・エージェントが認識していないために発生します。この問題が発生する場合は、ノードで以下の手順を実行してください。
    1. ノードを停止します。
    2. syncNode コマンドを実行します。
    3. ノードを再始動します。
  • ジョブがマイグレーションのアプリケーション・インストール・フェーズ中に失敗する。

    マイグレーション・プロセスで、バージョン 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 アプリケーションの問題を修正してから、再マイグレーションする。
    • マイグレーションを続行し、これらのエラーを無視する。
      1. FINISHUP ステップでマイグレーション・ジョブを再開し、残りのマイグレーション機能が実行されるようにする。

        これを行うには、RESTART=FINISHUP パラメーターをジョブ・カードに追加して、ジョブを再実行依頼します。

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

    マイグレーション・ログは、temporary_directory_location/nnnnnにあります。ここで、temporary_directory_location はマイグレーション・ジョブを作成したときに指定した値 (デフォルトは /tmp/migrate) で、nnnnn はマイグレーション・ジョブの作成中に生成された固有の番号です。通常、マイグレーション・ログには、多くのスペースは必要ありません。ただし、トレースを有効にすると、ログ・ファイルが非常に大きくなる可能性があります。ベスト・プラクティスは、問題が検出された後でトレースを有効にすることです。トレースが必要な場合、デバッグ中のプロセスのステップに関連するトレースだけを有効にしてください。 これにより、スペース所要量を減らすことができます。

    トレースを有効にするには、マイグレーション・ジョブの作成時に有効にするか、マイグレーション JCL の変数を無効から有効に変更します。
    TraceState=enabled
    profileTrace=disabled
    preUpGradeTrace=disabled
    postUpGradeTrace=enabled   

    マイグレーション中に、バージョン 6.0.x または 6.1.x 構成のバックアップ・コピーが作成されます。このバックアップが、マイグレーションされる情報のソースになります。 デフォルトのバックアップ・ロケーションは、/tmp/migrate/nnnnn です。 このロケーションは、マイグレーション・ジョブの作成時に変更できます。マイグレーションするノードのサイズによって、このバックアップは非常に大きくなる可能性があります。一時スペースが十分でない場合は、このバックアップを移動する必要があります。

  • バッチ・ジョブの時間が超過する。

    各 z/OS® インストールは、ジョブ・クラスおよび時間制限の点で異なっています。ジョブ・カードに適切なジョブ・クラスおよびタイムアウト値を指定してあることを確認してください。

  • マイグレーション後のサーバー始動中に障害が発生する。

    マイグレーション・ジョブの作成時に生成された説明を確認してください。JCL 手順が PROCLIB に正しくコピーされていること、RACF® 定義が作成されていること、バージョン 6.2 ライブラリーが許可されていること、および必要であればバージョン 6.2 ライブラリーへの STEPLIB ステートメントが指定されていることを確認します。セルに関連付けられているデーモン・プロセスのレベルが適切であることを確認します。デーモン・プロセスのレベルは、セル内で管理されるすべてのサーバーの中の WebSphere ESB for z/OS の最も高いバージョンでなければなりません。

    バージョン 6.0.1.3 以降ではないバージョン 6.0.x または 6.1.x ノードを含んでいるか、これらのノードと相互運用するバージョン 6.2 セルにマイグレーションすると、クラスター機能に障害が発生する可能性があります。これらのバージョン 6.0.x または 6.1.x アプリケーション・サーバーを始動すると、以下の問題が発生する可能性があります。
    • First Failure Data Capture (FFDC) ログに ClassNotFoundException エラー・メッセージが記録される場合があります。この例外は RuleEtiquette.runRules メソッドから throw されますが、以下のような形式になっています。
      Exception = java.lang.ClassNotFoundException
      Source = com.ibm.ws.cluster.selection.SelectionAdvisor.<init>
      probeid = 133
      Stack Dump = java.lang.ClassNotFoundException: rule.local.server
      at java.net.URLClassLoader.findClass(URLClassLoader.java(Compiled Code))
      at com.ibm.ws.bootstrap.ExtClassLoader.findClass(ExtClassLoader.java:106)
      at java.lang.ClassLoader.loadClass(ClassLoader.java(Compiled Code))
      at java.lang.ClassLoader.loadClass(ClassLoader.java(Compiled Code))
      at java.lang.Class.forName1(Native Method)
      at java.lang.Class.forName(Class.java(Compiled Code))
      at com.ibm.ws.cluster.selection.rule.RuleEtiquette.runRules
      (RuleEtiquette.java:154)
      at com.ibm.ws.cluster.selection.SelectionAdvisor.handleNotification
      (SelectionAdvisor.java:153)
      at com.ibm.websphere.cluster.topography.DescriptionFactory$Notifier.run
      (DescriptionFactory.java:257)
      at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java:1462)
    • 以下のような形式の java.io.IOException が記録される場合があります。
      Exception = java.io.IOException
      Source = com.ibm.ws.cluster.topography.DescriptionManagerA. update probeid
       = 362
      Stack Dump = java.io.IOException
      at com.ibm.ws.cluster.topography.ClusterDescriptionImpl.importFromStream
      (ClusterDescriptionImpl.java:916)
      at com.ibm.ws.cluster.topography.DescriptionManagerA.update
      (DescriptionManagerA.java:360)
      Caused by: java.io.EOFException
      at java.io.DataInputStream.readFully(DataInputStream.java(Compiled Code))
      at java.io.DataInputStream.readUTF(DataInputStream.java(Compiled Code))
      at com.ibm.ws.cluster.topography.KeyRepositoryImpl.importFromStream
      (KeyRepositoryImpl.java:193)

    マイグレーション時には、バージョン 6.2 クラスター情報が セル全体に配布されます。バージョン 6.0.1.3 より古い バージョン 6.0.x または 6.1.x ノードは、この情報を読み取れません。この問題を回避するには、Deployment Manager をバージョン 6.2 にマイグレーションする前に、バージョン 6.2 セルに含まれるか、このセルと相互運用されるすべてのバージョン 6.0.x または 6.1.x ノードをバージョン 6.0.1.3 以降にアップグレードします。

マイグレーション後に、ジョブ出力およびログ・ファイルを注意深く調べて、エラーがないか確認します。

注: WebSphere ESB には、WebSphere ESB プロセスのダンプから情報をフォーマットするのに役立つ対話式問題管理システム (IPCS) verb 出口があります。 この verb 出口には、CBDATA という名前が付けられていました。バージョン 6.0.x または 6.1.x 以前では、これは実際のモジュール名の別名でした。バージョン 6.2 では、この別名は除去されました。したがって、バージョン 6.2以降では、別名ではなく、この verb 出口の実際の名前 (BBORDATA) を使用する必要があります。

ノードをバージョン 6.2 にマイグレーションしてから、バージョン 6.0.x または 6.1.x に戻す必要があることが明らかになった場合は、環境のロールバックを参照してください。

これらのステップのいずれでも問題を解決できない場合は、WebSphere Enterprise Service Bus のトラブルシューティングおよびサポートを参照し、他のトラブルシューティング・リソース (IBM® サポートとの連絡方法など) について確認してください。


reference 参照トピック

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


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


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