ヘッダーをスキップ
Oracle® Fusion Middleware Oracle WebLogic Serverのアップグレード
12c (12.1.2)
E48023-03
  ドキュメント・ライブラリへ移動
ライブラリ		 製品リストへ移動
製品		 目次へ移動
目次
前
前 		  

A WebLogic Server 12.1.2の旧リリースとの互換性

この項では、WebLogic Server 10.3.xリリースからWebLogic Server 12.1.2にアップグレードする前に検討する必要がある、互換性に関する重要な情報について説明します。

このリリースおよび以前のリリースの、『Oracle WebLogic Serverの理解』のWebLogic Serverの互換性に関する項と、『Oracle WebLogic Serverの新機能』も参照してください。

互換性に関する検討事項は、次のように分類されます。ユーザーの状況に該当する項は、WebLogic Server 12.1.2にアップグレードする前のWebLogic Serverのバージョンによって異なります。WebLogic Serverの現在のバージョンに基づいて参照する各項の一覧については、表A-1を参照してください。

表A-1 各バージョンのWebLogic Serverからのアップグレードに適用される項

更新元のWebLogic Serverバージョン これらの項を参照

12.1.1

最大POSTサイズ

WLDFスキーマのアップグレード

jdbc-connection-timeout-secs要素

ローカル・トランザクションのコミット

10.3.5および10.3.6

上記のすべての項、および次の項:

JVMの設定

ノード・マネージャのstartScriptEnabledのデフォルト

Enterprise Java Beans (EJB)

WebLogic Server 8.1 Webサービス・スタックの削除

Universal Description and Discover (UDDI)レジストリの削除

Certicom SSLの実装

Coherenceのバージョン

非推奨および廃止済Webアプリケーションの機能

PointBaseからDerbyに変更された評価版データベース

データ・ソース・プロファイル・ロギング

ONSのデバッグ

DataDirectのOracleタイプ4 JDBCドライバの使用

デフォルトのメッセージング・モードの変更

10.3.3および10.3.4

上記のすべての項、および次の項:

SSLMBeanへの変更

10.3.2

上記のすべての項、および次の項:

新しいWebサービス機能

JSSEの導入

セキュリティ・ポリシー・デプロイメントのパフォーマンス向上

ActiveCache

クラス・キャッシュ

非推奨となったJDBCドライバ

weblogic.jms.extension APIの変更

永続ストアの更新

10.3.1

上記のすべての項、および次の項:

Oracle Internet Directory認証プロバイダとOracle Virtual Directory認証プロバイダ

10.3.0

上記のすべての項、および次の項:

capacityIncrement属性

Middlewareホーム・ディレクトリ

リソース登録名

サーブレット・パス・マッピング

最大POSTサイズ

新しいセッション記述子max-post-save-sizeがWebLogic Server 12.1.2に追加されました。これは既存のアプリケーションに影響を及ぼす可能性があります。この記述子は、FORM認証中にアプリケーション・コンテナによって保存またはバッファリングされるPOSTの最大サイズ(バイト単位)を設定します。デフォルト値は4096バイトです。

FORM認証中に、アプリケーションでサイズが4096バイトを超えるフォームをポストする場合は、max-post-save-sizeを適切な値に増やす必要があります。そうしない場合、ブラウザでMaxPostSizeExceededExceptionが発生します。

WLDFスキーマのアップグレード

WLDFイベントおよびハーベスタ・データにJDBCベースのストアを使用している場合は、データベースのWLDF表を更新または再作成する必要があります。wls_events表で、THREADNAME列をvarchar(128)からvarchar(250)に変更します。wls_hvst表で、WLDFMODULE varchar(250) default NULL列を追加します。詳細は、『Oracle WebLogic Server診断フレームワークの構成と使用』のJDBCベースのストアの構成に関する項を参照してください。

これはWLSスタンドアロン・インストールにのみ適用されます。Fusion Middleware製品を含むインストールの場合、スキーマ・アップグレード・プロセスはOracle Upgrade Assistantを介して行います。

jdbc-connection-timeout-secs Element

WebLogic Server 12.1.2から、weblogic.xmlデプロイメント記述子のjdbc-connection-timeout-secs要素は削除されました。アプリケーションでjdbc-connection-timeout-secs要素を構成する場合は、アプリケーションのデプロイメントが失敗しないように、weblogic.xmlデプロイメント記述子からそれを削除する必要があります。

ローカル・トランザクションのコミット

WebLogic Server 12.1.2以降、アプリーションによってコミットまたはロールバックされなかった非XA接続のローカル・トランザクションは、その接続がプールに戻されるときにデフォルトで明示的にコミットされるようになりました。また、接続プールを閉じるときに非XA接続とXA接続のローカル・トランザクションをコミットするかどうかを設定するために、次の2つのパラメータが追加されました。

JVMの設定

WebLogic Server 10.3.xドメインをWebLogic Server 12.1.2ドメインにアップグレードする際は、次の操作が必要な場合があります。

Java承認ディレクトリの場所の設定

次の状況では、Java承認ディレクトリの場所の手動設定は必要ありません。

  • JDK7を使用中の場合。

  • WebLogic Server 12.1.1でインストールされたJDKの1つを使用中の場合。

  • WebLogic Server 12c構成ウィザードによるドメイン作成で生成されたWLS 12cドメインおよび起動スクリプトを使用中の場合、またはWebLogic Serverインストーラでインストールされたように起動スクリプトがcommEnv.cmd/shを参照する場合、あるいはその両方の場合。

この状況がいずれも当てはまらないとき、次のいずれかの状況が当てはまる場合は、管理対象サーバーの起動に使用するコマンドでJava承認ディレクトリの場所を手動設定する必要があります。

  • 管理対象サーバーの起動にノード・マネージャを使用しているが、起動スクリプト(startScriptEnabled=false)を使用していない場合。WebLogic Server 12.1.1以降、startScriptEnabledのデフォルト値はtrueになりました。

  • カスタム起動スクリプト、つまりOracleで提供されていない起動スクリプトを使用中の場合。

  • java.weblogic.Serverを使用して空のドメインを作成しようとしている場合。

このいずれのケースでも、管理対象サーバーの起動コマンドにjava.endorsed.dirsパラメータを含めてください。

startWeblogic.sh -Djava.endorsed.dirs=WL_HOME/endorsed

複数のJava承認ディレクトリを指定する場合は、各ディレクトリ・パスをコロン(:)で区切ります。


注意:

この項に記述されているオプションではすべて、WL_HOMEを自分のWebLogic Serverインストールのフル・パスに置き換える必要があります。

次のように、startServerを呼び出すときに値をjvmArgsとして渡すか、nmstartを呼び出すときに値をプロパティとして渡すことで、この値を指定することもできます。

wls:/nm/mydomain> prps = makePropertiesObject("Arguments=-Djava.endorsed.dirs=/WL_HOME/endorsed")

wls:/nm/mydomain> nmStart("AdminServer",props=prps)

管理対象サーバーの起動にノード・マネージャを使用している場合は、WLSTまたは管理コンソールを使用して、-Djava.endorsed.dirs=/WL_HOME/endorsed")パラメータをServerStartMBeanのarguments属性に含めることができます。管理コンソールを使用中の場合、サーバーの「構成」→「サーバーの起動」タブでこのパラメータを「引数」フィールドに入力します。管理サーバーに接続されているWLSTクライアントからstart(server_name 'Server')を呼び出す際、または管理コンソールでサーバーの「起動」ボタンをクリックした際にこの属性は適用されます。

permgen領域の設定

管理対象サーバーの起動時にOutOfMemory: PermGen Spaceエラーが発生した場合は、permgen領域を128MB以上に手動設定し、最大permgen領域を256MB以上に拡張する必要があります。


注意:

ここで記述されているオプションではすべて、WL_HOMEを自分のWebLogic Serverインストールのフル・パスに置き換える必要があります。

これを実行するには、WLSTまたは管理コンソールを使用して、ServerStartMBeanのarguments属性に次のように指定します。管理コンソールを使用中の場合、サーバーの「構成」→「サーバーの起動」タブで「引数」フィールドに-XX:PermSize=128m -XX:MaxPermSize=256mを入力します。

「引数」フィールド
図permgen_setting.gifの説明


注意:

管理コンソールを介してサーバーを起動することを計画している場合は、管理コンソールからサーバーを起動する前にpermgen設定を適用する必要があります。そうしないと、サーバーがリカバリ不能な状態になる可能性があります。

管理サーバーに接続されているWLSTクライアントからstart(server_name 'Server')を呼び出す際、または管理コンソールでサーバーの「起動」ボタンをクリックした際にこの属性は適用されます。

使用可能な別の方法は、コマンド・ラインを介して管理対象サーバーを起動し、ここに示すように、正しい設定を指定する方法です。

(UNIX) startManagedWebLogic.sh server_name -XX:PermSize=128m -XX:MaxPermSize=256m

(Windows) startManagedWebLogic.cmd server_name -XX:PermSize=128m -XX:MaxPermSize=256m

次のように、startServerを呼び出すときに値をjvmArgsとして渡すか、nmstartを呼び出すときに値をプロパティとして渡すことで、この値を指定することもできます。

wls:/nm/mydomain> prps = makePropertiesObject("Arguments= -XX:PermSize=128m -XX:MaxPermSize=256m")

wls:/nm/mydomain> nmStart("AdminServer",props=prps)

ノード・マネージャのstartScriptEnabledのデフォルト

WebLogic Server 12.1.1以降、startScriptEnabledのデフォルト値はtrueに変更されました。これまでの旧リリースでは、デフォルトはfalseでした。ノード・マネージャで起動スクリプトを使用しない場合は、アップグレード後にこの値をfalseに変更します。

Enterprise Java Beans (EJB)

Oracle Kodoは、WebLogic Server 10.3.1から非推奨とされています。WebLogic Server 12.1.1から、Kodoにかわって、EclipseLinkがデフォルトのJPAプロバイダとなっています。WebLogic Server 12.1.2でKodoを永続プロバイダとして引き続き使用するアプリケーションは、更新する必要があります。詳細は、『Oracle WebLogic Server Enterprise JavaBeansの開発』の競合を解決するためのアプリケーションの更新に関する項を参照してください。

WebLogic Server 12.1.1から、JPA 2.0のサポートが組み込まれています。JPA 2.0では、ドメイン・モデリング、オブジェクト/リレーショナル・マッピング、EntityManagerインタフェース、問合せインタフェースおよびJava Persistence Query Language (JPQL)などの各機能が向上し、強化されています。詳細は、『Oracle WebLogic Server Enterprise JavaBeansの開発』のWebLogic ServerでのTopLinkとJPA 2.0の併用に関する項を参照してください。

WebLogic Server 8.1 Webサービス・スタックの削除

WebLogic Server 8.1 Webサービス・スタックはWebLogic Server 12.1.1リリースで削除されています。したがって、WebLogic Server 8.1 Webサービス・アプリケーションは今後機能しません。これらのアプリケーションは、「8.1のWebLogic Webサービスの12.1.xへのアップグレード」の指示に従って、WebLogic JAX-RPCまたはJAX-WSスタックにアップグレードすることをお薦めします。

Universal Description and Discover (UDDI)レジストリの削除

Universal Description and Discovery (UDDI)レジストリはWebLogic Server 12.1.1から削除されています。UDDIを引き続き使用中の場合にWebLogic Server 12.1.1にアップグレードする際は、UDDI 3.0に準拠したOracle Service Registry (OSR)に移行することをお薦めします。

Certicom SSLの実装

WebLogic Server 12.1.1から、Certicom SSLの実装は削除されています。この変更によって、『Oracle WebLogic Serverのセキュリティの管理』のSSLの構成に関する項に記述されているように、システム・プロパティの更新とスイッチのデバッグが必要になる場合があります。

Coherenceのバージョン

WebLogic Server 12.1.1インストーラにはCoherence 3.7.1が含まれています。クラスタ内のサーバーはすべて同じバージョンのCoherenceを使用する必要があります。したがって、クラスタ内のすべてのキャッシュ・サーバーをCoherence 3.7.1にアップグレードします。

非推奨および廃止済Webアプリケーションの機能

WebLogic Server 12.1.1から非推奨またはサポート対象外となったWebアプリケーション機能については、次を参照してください。

PointBaseからDerbyに変更された評価版データベース

WebLogic Server 10.3.3以降では、WebLogic Serverインストール・プログラムの評価版データベースがPointBaseからApache Derbyに変更されています。「製品とコンポーネントの選択」画面の評価版データベース・オプションを選択すると、DerbyデータベースがWL_HOME\common\derbyディレクトリにインストールされます。「標準」インストールを選択すると、Derbyがデフォルトでインストールされます。

PointBaseに基づくドメインがあり、ドメインをWebLogic Server 10.3.3以降にアップグレードした後も引き続きPointBaseを使用する場合は、PointBaseのライセンスをhttp://www.pointbase.comで入手する必要があります。フルWLSインストーラではPointBaseインストール・ディレクトリが保存されません。PointBaseを使用するかわりに、ドメイン・データベースをDerbyに移行できます。

詳細は、「評価版データベースを使用するドメインのアップグレード」を参照してください。

データ・ソース・プロファイル・ロギング

操作性とパフォーマンスを向上させるため、WebLogic Server 10.3.6以上ではデータ・ソース・プロファイル・ログを使用してイベントが格納されます。『Oracle WebLogic Server JDBCデータ・ソースの管理』のWebLogic JDBCリソースの監視に関する項を参照してください。

ONSのデバッグ

WebLogic Serverリリース10.3.6以上では、UCPおよびONSのパッケージ名が再パッケージされなくなりました。UPCとONSのデバッグの設定方法の詳細は、『Oracle WebLogic Server JDBCデータ・ソースの管理』のUCP/ONSのデバッグの設定に関する項を参照してください。

DataDirectのOracleタイプ4 JDBCドライバの使用

WebLogic Server 10.3.6から、DataDirectのOracleタイプ4 JDBCドライバは、WebLogicブランドのDataDirectドライバと呼ばれるようになりました。オラクル社は『Oracle WebLogic Serverタイプ4 JDBCドライバ』でのドキュメンテーションを停止しました。DataDirectドライバの詳細情報は今後提供しません。WebLogic Server環境でWebLogicブランドのドライバを構成および使用する方法の詳細は、『Oracle WebLogic Server JDBCアプリケーションの開発』のWebLogicブランドのDataDirectドライバの使用に関する項で引き続き提供します。ドライバの動作の詳細はDataDirectのドキュメントを確認することをお薦めします。『Progress DataDirect for JDBC User's Guide Release 5.1』および『Progress DataDirect for JDBC Reference Release 5.1』(http://www.datadirect.com/index.html)を参照してください。

デフォルトのメッセージング・モードの変更

WebLogic Server 12.1.1から、デフォルトのメッセージング・モードがマルチキャストからユニキャストに変更されました。

SSLMBeanへの変更

SSLMBeanはWebLogic Server 10.3.5から、JSSEアダプタを有効化または無効化する機能など追加のSSL構成機能をサポートするように変更されています。

詳細については、以下のマニュアルを参照してください。

新しいWebサービス機能

リリース10.3.3で、WebLogic Serverには次の機能が追加されました。

詳細は、『Oracle WebLogic Serverの新機能』のWebサービスに関する項を参照してください。

JSSEの導入

WebLogic Server 10.3.3から、Java Secure Socket Extension (JSSE)がSSL実装として導入されています。JSSEは、SSLおよびTLS用のJava標準フレームワークで、ブロッキングI/O API、ノンブロッキングI/O API、および複数の信頼性のあるCAを含む参照実装が含まれています。

セキュリティ・ポリシー・デプロイメントのパフォーマンス向上

リリース10.3.3では、WebLogic Serverにスレッド・セーフなデプロイ可能認可プロバイダおよびロール・マッピング・プロバイダのデプロイメント・パフォーマンス拡張が含まれます。WebLogic Serverはデフォルトで、アプリケーションおよびモジュールのデプロイメント中にセキュリティ・ポリシーおよびロールに対してスレッド・セーフな並列変更を実行できます。このため、セキュリティ・レルムに構成されているデプロイ可能な認可プロバイダおよびロール・マッピング・プロバイダでは、並列呼出しがサポートされている必要があります。WebLogicのデプロイ可能なXACML認可プロバイダおよびロール・マッピング・プロバイダは、この要件を満たしています。

ただし、カスタムのデプロイ可能な認可プロバイダまたはロール・マッピング・プロバイダで並列呼出しがサポートされていない場合は、セキュリティ・ポリシーとロールの並列変更を無効にし、かわりに同期メカニズムを強制的に使用する必要があります。この場合、各アプリケーションとモジュールはキューに入り、順番にデプロイされます。この同期強制メカニズムは、管理コンソールまたはRealmMBeanのDeployableProviderSynchronizationEnabled属性とDeployableProviderSynchronizationTimeout属性を使用することで有効にできます。

詳細は、『Oracle WebLogic Serverのセキュリティの管理』のデプロイメント時のセキュリティ・ポリシーとロール変更での同期の有効化に関する項を参照してください。

ActiveCache

WebLogic Server 10.3.3以降では、WebLogic ServerにデプロイされているアプリケーションでのCoherenceデータ・キャッシュの使用が容易になり、セッション管理用のCoherence*WebとTopLink Gridをobject-to-relational永続フレームワークとしてシームレスに取り込めるようになりました。これらの機能の総称がActiveCacheです。

ActiveCacheでは、レプリケートおよび分散されたデータ管理とキャッシングのサービスが提供されており、このサービスを使用することで、アプリケーションのオブジェクトとデータをCoherenceクラスタ内のすべてのサーバーに対して利用可能にすることができます。

詳細は、『Oracle WebLogic Server ActiveCacheによるアプリケーションのデプロイ』を参照してください。

クラス・キャッシュ

リリース10.3.3で、WebLogic Serverでクラス・キャッシュを有効にできるようになりました。クラス・キャッシュを使用する利点を次に示します。

クラス・キャッシュが開発モードでサポートされるのは、startWebLogicスクリプトを使用してサーバーを起動したときです。クラス・キャッシュはデフォルトでは無効になっており、本番モードではサポートされません。起動時間の短縮の程度は様々なJREベンダーによって異なります。詳細は、『Oracle WebLogic Serverアプリケーションの開発』のクラス・キャッシュの構成に関する項を参照してください。

非推奨となったJDBCドライバ

次のJDBCドライバは非推奨となりました。

weblogic.jms.extension APIの変更

WebLogic Server 10.3.3から、weblogic.jms.extensions.WLMessageインタフェースの次の内部メソッドが、Oracle WebLogic Server Java APIリファレンスから削除されました。

public void setSAFSequenceName(String safSequenceName);
public String getSAFSequenceName();
public void setSAFSeqNumber(long seqNumber);
public long getSAFSeqNumber();

アプリケーションでこれらの内部メソッドを使用しないでください。内部メソッドは、将来のリリースで予告なしに変更または削除される場合があります。

永続ストアの更新

WebLogic Server 10.3.3から、WebLogicファイル・ストアの動作とチューニング方法は、デフォルト・ファイル・ストアとカスタム・ファイル・ストアについて変更されています。

Oracle Internet Directory認証プロバイダとOracle Virtual Directory認証プロバイダ

Oracle Internet Directory認証プロバイダとOracle Virtual Directory認証プロバイダという2つの新しいLDAP認証プロバイダがWebLogic Server 10.3.2に追加されました。これらの認証プロバイダを使用すると、Oracle Internet Directory LDAPサーバーとOracle Virtual Directory LDAPサーバーにユーザーとグループを格納したり、両サーバーからユーザーとグループを読み取ったりできます。

これらの新しいセキュリティ・プロバイダの構成と使用の詳細は、『Oracle WebLogic Serverのセキュリティの管理』のLDAP認証プロバイダの構成に関する項を参照してください。

capacityIncrement属性

WebLogic Server 10.3.1以上のリリースでは、capacityIncrement属性は構成可能ではなく、1という値に設定されます。

Middlewareホーム・ディレクトリ

WebLogic Server 10.3.1では、BEAホーム・ディレクトリがMiddlewareホームに変更されました。このディレクトリのデフォルト・パスは<drive:>Oracle/Middlewareです。この変更がWebLogic Serverに及ぼす影響は次のとおりです。

この変更によって、コンピュータ上の既存のWebLogic Serverインストール、カスタム・ドメイン、アプリケーションまたはスクリプトが影響を受けることはありません。従来どおりBEA_HOME環境変数を使用し続けることができます。

リソース登録名

WebLogic Server 10.3.1以降では、XAデータ・ソース構成のリソース登録名の動作が変更されました。以前のリリースでは、JTAの登録名はデータ・ソースの名前のみでした。今後は、データ・ソース名とドメインの組合せになります。

詳細は、『Oracle WebLogic Server JTAアプリケーションの開発』のXAResourceのトランザクションへの参加の登録に関する項を参照してください。

サーブレット・パス・マッピング

Javaサーブレットの仕様バージョン2.3の時点で、次の構文がマッピングの定義に使用されています。

これらの変更により、次のHttpServletRequestメソッドの動作に変化が生じます。

動作の変更を説明するために、例として/abc/def.htmlというリクエストがServletAに解決される場合を考えます。

確実にnullでないパス情報が返されるようにするには、/(スラッシュ)のサーブレット・マッピング文字列が出現するすべての箇所を/*に置換します。

Javaサーブレット仕様は、次の場所からダウンロードできます。

http://www.oracle.com/technetwork/java/javaee/servlet/index.html
  前
前 
  ドキュメント・ライブラリへ移動
ライブラリ		 製品リストへ移動
製品		 目次へ移動
目次