Oracle® Fusion Middleware Oracle WebLogic Serverアップグレード・ガイド 11gリリース1 (10.3.6) B61642-04 |
|
![]() 前 |
![]() 次 |
10.3.6 WebLogicアップグレード・ウィザードを使用すると、WebLogic Serverバージョン8.1で作成されたドメインをアップグレードできます。
また、このウィザードでは、WebLogic Server 9.xまたは10.0で作成されたWebLogicドメインを10.3.6にアップグレードすることもできますが、これは任意です。この種類のドメインは、変更せずにWebLogic Server 10.3.6で実行できます。付録A「WebLogic Server 9.xまたは10.xアプリケーション環境から10.3.6へのアップグレード」を参照してください。
次の節では、この目的のためのWebLogicアップグレード・ウィザードの使用方法について説明します:
WebLogicドメインのアップグレード時には、アップグレードするドメインを指定し、いくつかのプロンプトに回答します。WebLogicアップグレード・ウィザードは次のタスクを実行します。
必要に応じて、元のドメイン・ディレクトリのバックアップを行います。
バックアップがリクエストされた場合、ウィザードはドメイン・ディレクトリのみをバックアップするため、ファイル権限は維持されません。「ステップ3: アプリケーション環境のバックアップの作成」で説明されているように、ドメイン、外部アプリケーション、およびアプリケーション・データベース・リソースをそれぞれ独立したプロセスでバックアップすることをお薦めします。
注意: ウィザードにより作成されるバックアップ・ファイルには、機密情報が含まれる可能性があるため、ユーザーが保護する必要があります。 |
起動スクリプトは停止スクリプトなどのスクリプトを再作成し、元のスクリプトの名前をorig-scriptname
.bak
(orig-scriptname
は元のスクリプトの名前。.bakは拡張子)に変更します。
注意: 元の起動スクリプトに対して行われたカスタマイズの内容は新しいスクリプトにコピーされません。たとえば、元のスクリプトでJAVA_OPTIONS 環境変数にデフォルト以外の値が指定されている場合、指定されている値は新しいスクリプトでは保持されません。 |
元のドメインをリストラクチャして、新しいディレクトリ構造を作成し、ドメインのコンポーネントを新しい場所に移動します。
リストラクチャにおいて、必要なディレクトリがすでに存在する場合は、そのディレクトリとその中にあるファイルおよびサブディレクトリがそのまま維持されます。
既存のサーバー・ログ・ファイルがドメイン内のservers/
server_name
/logs/pre-9.0-logs
ディレクトリ(server_name
はサーバーの名前)にコピーされます。
ドメイン・ディレクトリ構造に対する変更を確認するには、付録C「WebLogicドメイン・ディレクトリ構造の強化」を参照してください。
構成ファイル(config.xml
)に保存されている永続化された構成に関する情報をconfigディレクトリにアップグレードします。
ウィザードで構成ファイル(config.xml
)のアップグレード中にリソースの重複が検出されたら、進行状況を表すウィンドウにメッセージが表示されます。この場合、最後に検出されたリソース定義が変換中に使用されます。
JMSファイル・ストア、JMS JDBCストア、トランザクション・ストアなどの永続データをアップグレードします。
JMS JDBCストアがアップグレードされたら、元のJMS JDBCストアは削除されます。キャパシティ・プランニングを行うときは、この点を考慮に入れてください。アップグレードが正常に完了したら、元のJMS JDBCストア表を削除できます。元のJMS JDBCストア表にはPrefixName
JMSSTORE
およびPrefixName
JMSSTATE
(PrefixName
はJMS JDBCストアのPrefix Name
属性の値)という名前が付けられます。
保持されているJMSメッセージをアップグレードしない場合は、アップグレードを実行する前にJMSファイル・ストアまたはJMS JDBCストア表を削除します。この場合、構成は変更されず、JMSメッセージのみが削除されます。JDBCストア表の管理の詳細は、『Oracle WebLogic Serverサーバー環境の構成』のJDBCストア表の管理に関する項を参照してください。
アップグレードが実行済みであることが検出されると、JMS JDBCまたはファイル・ストアはアップグレードされません。テスト・シナリオなど、同一の永続ストアを使用してドメインのアップグレードを複数回実行する必要がある場合は、次のようにアップグレード・プロセスを実行するたびにJMSデータを元に戻します。
JMS JDBCストアの場合、アップグレード・プロセスによりPrefixName
WLSTORE
(PrefixName
はJMS JDBCストアのPrefix Name
属性の値)という名前の新しい表が作成されます。JMS JDBCストアを使用するドメインのアップグレード・プロセスを再実行する前に、この表を削除します。
アップグレードを再実行する必要がある場合、必ず最初にバックアップ・バージョンのJMSファイル・ストアをリストアします。
構成を保存します。
注意: リモートの管理対象サーバーをアップグレードする場合、構成情報は保持されません。 |
さらなる検討を要するドメインのアップグレードに関する問題があれば、報告します。
アップグレード・プロセスには次の重要な注意事項があります。
WebLogic Serverアプリケーションをアンデプロイする必要はありません。ほとんどのWebLogic Serverアプリケーションは、修正を加えることなくWebLogic Server 10.3.6のアプリケーション環境で動作します。実際の環境においてアプリケーションが機能変更の影響を受けるかどうかについては、付録B「WebLogic Server 10.3.6の旧リリースとの互換性」で互換性情報を確認してください。アプリケーションで非推奨になったAPIまたは削除されたAPIが使用されている場合は、実行時に警告または例外が発生するおそれがあります。
少なくとも、ドメイン・ディレクトリに次のファイルが含まれている必要があります:
config.xml
セキュリティ関連のファイル(SerializedSystemIni.dat
、DefaultAuthenticatorInit.ldift
、DefaultAuthorizerInit.ldift
、DefaultRoleMapperInit.ldift
)
セキュリティ関連のファイルがないと、サーバーは起動されず、認証エラー・メッセージがログに記録されます。
ドメイン内にあるトランザクション・ログ・ファイル(..tlog
)。詳細は、『Oracle WebLogic Server JTAのプログラミング』のトランザクション・ログ・ファイルに関する項を参照してください。
ターゲットのコンピュータ上のドメイン・ディレクトリに含まれるすべての内容がこのプロセスにおいて更新されます。
アプリケーション環境内のすべてのコンピュータのドメインをアップグレードする必要があります。
WebLogicドメインのアップグレードにおいては、アプリケーションはアップグレードされません。
WebLogic Liquid Data、またはAquaLogic Data Services Platformのリソースを含むドメインは、WebLogic Server 10.3.6にアップグレードできません。
9.0からは、.wlnotdelete
ディレクトリはWebLogic Server環境では使用されなくなりました。
アップグレード・プロセスでは、ファイル権限は保持されません。デフォルト以外のファイル権限を確認し、リセットする必要があります。
UNIXシステムでは、アップグレード・プロセス中に作成される新しいファイルの所有権と権限は、アップグレードを実行するユーザーに割り当てられます。たとえば、アップグレードがrootにより実行される場合、新しいファイルの所有権はrootに割り当てられます。このため、後でドメイン内のこれらのファイルを更新するユーザーにはroot権限が必要となります。したがって、アップグレード・プロセス中に作成されたファイルに設定されている権限を確認または修正することをお薦めします。
WebLogic Server 10.3.6では、場合によっては、サーバーの起動時にユーザー名とパスワードを指定する必要があります。
リモートの管理対象サーバーのドメインをアップグレードするとき、参照されているアプリケーション・パスがシステムにないことを通知する次のようなメッセージが表示される場合があります。
<Apr 12, 2009 6:42:06 PM EDT> <INFO> <Upgrade> <BEA-800000> <An invalid path, 'C:\bea\wlserver_10.3\user_projects\mydomain\medrecEar.ear', was specified for application, 'medrecEar'.>
このメッセージは無視できます。
Solarisコンピュータ上(のみ)でAvitek Medical Recordアプリケーションを8.1から10.3.6にアップグレードした場合は、サーバーを起動する前に、setDomainEnv.shファイルの起動コマンドから-Xverify:none
を削除します。これを行うには、次の行の後でJAVA_OPTIONS=""
を設定します。
. ${WL_HOME}/common/bin/commEnv.sh
そうでない場合、JVMエラーのためサーバーの起動に失敗します。
ウィザードでは、次のアップグレード・モードをサポートします:
グラフィカル - グラフィカル・ユーザー・インタフェースを使用したドメイン・アップグレード・ウィザードにより、対話形式でドメインをアップグレードします。
サイレント - ファイルにアップグレード要件を指定することで、WebLogicドメインをバックグラウンドでアップグレードできます。
注意: 暗黙モードを使用して、管理サーバーの起動時に自動的にWebLogicドメインをアップグレードすることもできます。詳細は、付録F「管理サーバー起動時におけるドメインのアップグレード(暗黙モード)」を参照してください。 |
ドメイン内のすべてのコンピュータのドメインをアップグレードする必要があります。リモートの管理対象サーバーのドメイン・ディレクトリの準備については、「ステップ5: リモートの管理対象サーバーのドメイン・ディレクトリの準備」を参照してください。
注意: 先に進む前に、以下のことを確認してください。
|
次の節では、次のアップグレード方法について説明します。
次の節では、グラフィカル・モードでWebLogicアップグレード・ウィザードを使用してWebLogicドメインをアップグレードする方法について説明します。
注意: グラフィカル・モードでアップグレード・ウィザードを実行するために使用するコンソールでは、JavaベースのGUIがサポートされていなければなりません。グラフィカル表示をサポートしていないシステム上でアップグレード・ウィザードをグラフィカル・モードで起動しようとすると、エラー・メッセージが表示されます。 |
Windowsプラットフォーム上でWebLogicアップグレード・ウィザードをグラフィカル・モードで開始してWebLogicドメインをアップグレードするには、Windowsの「スタート」メニューのOracleプログラム・グループから、「ドメイン・アップグレード・ウィザード」オプションを選択します(「プログラム」→「Oracle WebLogic」→「WebLogic Server 11gR1」→「ツール」→「ドメイン・アップグレード・ウィザード」)。
Windowsコマンド・プロンプトから、またはUNIXプラットフォーム上でWebLogicアップグレード・ウィザードをグラフィカル・モードで開始してWebLogicドメインをアップグレードするには:
WebLogicドメインが稼働していないことを確認します。
必要に応じて、JMSストアをバックアップします。
コマンド・プロンプト・ウィンドウ(Windows)またはコマンド・シェル(UNIX)を開き、「ステップ6: 環境の設定」の説明に従って環境を設定します。
次のスクリプトを実行してドメインをアップグレードします。
Windowsの場合: WL_HOME
\common\bin\upgrade.cmd
UNIXの場合: WL_HOME
/common/bin/upgrade.sh
ログ・ファイルは、MW_HOME
/user_projects/upgrade_logs
ディレクトリに格納されます。
WebLogicドメインをアップグレードするために、次のコマンドを使用することもできます。
java weblogic.Upgrade [-type domain] [-out file]
-type
引数と-out
引数は省略可能です。これらの引数は、次の設定のデフォルト値をオーバーライドする場合に含めます。
実行するアップグレードのタイプ。-type
引数でタイプを指定しなければ、ドメインのアップグレードが実行されます。
すべての標準出力(stdout
)とエラー・メッセージが書き込まれる出力ファイル。-out
引数でファイルを指定しない場合、これらのメッセージはコマンド・ウィンドウに書き込まれ、アップグレード・プロセスの終了時にそのサマリーが表示されます。
-out
引数は省略可能です。これにより、すべての標準出力(stdout
)とエラー・メッセージが書き込まれるファイルを指定することができます。デフォルトでは、これらのメッセージはコマンド・ウィンドウに書き込まれ、アップグレード・プロセスの終了時にそのサマリーが表示されます。
このコマンドを実行すると、図5-1のようにWebLogicアップグレード・ウィザードが起動します。
JMS JDBCストアが使用されている場合は、対応するデータベースが実行中であることを確認します。
「次へ」をクリックして、次のウィンドウに進みます。
表5-1に、WebLogicアップグレード・ウィザードを使用してドメインをアップグレードする手順の概要を示します。
注意: この節で示す画面は、あくまでも表示の例です。実際の画面は、ドメインで使用されるリソースの組合せによって異なります。 |
表5-1 WebLogicドメインをアップグレードする手順
手順 | 実行する操作 |
---|---|
WebLogicバージョンの選択 |
アップグレードするドメインのWebLogicバージョンを選択します。 「次へ」をクリックして、次のウィンドウに進みます。 |
アップグレードするドメインの選択 |
ローカルのディレクトリ階層を移動して、アップグレードするWebLogicドメインが格納されているディレクトリを選択します。 「次へ」をクリックして、次のウィンドウに進みます。 |
ドメインの検査 |
ウィザードによるドメインの検査の進行状況を確認します。進行状況を通知するメッセージがウィンドウに表示されます。 カスタム・セキュリティ・プロバイダが使用されているドメインをアップグレードする場合、最初にカスタム・セキュリティ・プロバイダをアップグレードすることなくドメインをアップグレードしようとすると、エラー・メッセージが表示され、ウィザードが終了します。 このエラー・メッセージが表示された場合は、第3章「セキュリティ・プロバイダのアップグレード」の説明に従ってカスタム・セキュリティ・プロバイダをアップグレードしてから、ドメインのアップグレードをやり直します。 検査が完了したら(そしてエラーが検出されなければ)、次のウィンドウが自動的に表示されます。 |
管理サーバーの選択 |
新しいドメインで管理サーバーとして機能するサーバーを選択します。 注意 :ドメインで定義されているサーバーが1つしかない場合、このウィンドウは表示されません。このウィンドウは、アップグレードするドメインに複数のサーバーがある場合にのみ表示されます。 「次へ」をクリックして、次のウィンドウに進みます。 |
ノード・マネージャ資格証明の入力 |
ノード・マネージャの認可に使用するユーザー名とパスワード(および確認用パスワード)を入力します。 WebLogic Server 10.3.6の場合、ドメインごとにノード・マネージャのユーザー名とパスワードを指定する必要があります。デフォルトでは、ユーザー名とパスワードは 「次へ」をクリックして、次のウィンドウに進みます。 |
アップグレード・オプションの選択 |
|
ディレクトリ選択の解析と任意のタスク |
ウィザードによるドメイン情報とオプション設定の処理の進行状況を確認します。進行状況を通知するメッセージがウィンドウに表示されます。 処理が完了したら、次のウィンドウが自動的に表示されます。 |
ドメインのバックアップ |
ウィザードによるドメインのバックアップの準備状況を確認します。進行状況を通知するメッセージがウィンドウに表示されます。 処理が完了したら、次のウィンドウが自動的に表示されます。 |
ドメインのバックアップ・ディレクトリの選択 |
注意: 「アップグレード・オプションの選択」で説明したように現在のドメインをバックアップ・アップグレード・オプションを選択しなかった場合は、「ドメイン・ディレクトリのリストラクチャ」に進みます。 このウィンドウで、次の値を設定します。
「次へ」をクリックして、次のウィンドウに進みます。 |
ドメインのバックアップ |
ウィザードによるドメインのバックアップの進行状況を確認します。バックアップ・プロセスの進行状況をパーセント単位で表すバーと進行状況を通知するメッセージがウィンドウに表示されます。 注意: ウィザードによって作成されるバックアップ・ファイルには、機密情報が含まれる可能性があるため、ユーザーが保護する必要があります。 バックアップ・プロセスが完了したら、次のウィンドウが自動的に表示されます。 |
ドメイン・ディレクトリのリストラクチャ |
ウィザードによるドメイン・ディレクトリのリストラクチャの進行状況を確認します。進行状況を通知するメッセージがウィンドウに表示されます。 プロセスが完了したら、次のウィンドウが自動的に表示されます。 |
構成設定のアップグレード |
ウィザードによる構成設定のアップグレードの進行状況を確認します。進行状況を通知するメッセージがウィンドウに表示されます。 構成情報は、後で実行する手順まで保持されません。 構成のアップグレードが完了したら、次のウィンドウが自動的に表示されます。 |
保存されているメッセージおよびトランザクション・ログ・フォーマットのアップグレード |
ウィザードによるドメイン内の永続メッセージ(JMSファイルとJDBCストア)とトランザクション(JTA)ログのアップグレードの進行状況を確認します。進行状況をパーセント単位で表すバーと進行状況を通知するメッセージがウィンドウに表示されます。 永続メッセージとトランザクション・ログのアップグレード・プロセスが完了したら、次のウィンドウが自動的に表示されます。 |
RDBMS Authenticatorセキュリティ・プロバイダのアップグレード |
非推奨のRDBMSAuthenticatorをSQLAuthenticatorに置き換えるかどうかを指定します。 注意 :このウィンドウは、アップグレードするドメインにRDBMS Authenticatorセキュリティ・プロバイダがある場合にのみ表示されます。 「次へ」をクリックして、次のウィンドウに進みます。 |
アップグレードされた構成の保持 |
ウィザードの進行状況(アップグレードされた構成の保存やアップグレード・プロセス中に作成された一時ファイルの削除)を確認します。進行状況を通知するメッセージがウィンドウに表示されます。 注意 :リモートの管理対象サーバーをアップグレードする場合、構成情報は保持されません。 このプロセスが完了したら、「次へ」をクリックして、次のウィンドウに進みます。 |
アップグレード完了 |
アップグレードが完了したら表示されるアップグレード結果を確認します(さらなる検討を要する重要なメッセージなど)。 「完了」をクリックしてWebLogicアップグレード・ウィザードを閉じます。 |
注意: サイレント・モードでは、WebLogicドメインのみがアップグレードできます。 |
たとえば、ドメインがリモート・コンピュータにある場合などに、WebLogicアップグレード・ウィザードをグラフィカル・モードで使用するのは合理的ではありません。このような場合、ウィザードをサイレント・モードで使用して、WebLogicドメインをアップグレードすることができます。
サイレント・モードでWebLogicアップグレード・ウィザードを起動してWebLogicドメインをアップグレードするには:
WebLogicドメインが稼働していないことを確認します。
MS-DOSコマンド・プロンプト・ウィンドウ(Windows)またはコマンド・シェル(UNIX)を開き、「ステップ6: 環境の設定」の説明に従って環境を設定します。
(オプション)アップグレード要件を定義するXMLスクリプトを作成します。詳細については、付録E「サイレント・アップグレード用XMLスクリプト・リファレンス」を参照してください。
アップグレードするWebLogicドメインが格納されているディレクトリに移動します。例:
cd c:\bea\user_projects\domains\domain
domain
はドメインの名前です。
コマンド・プロンプトで、次のコマンドを入力します。
java weblogic.Upgrade -mode silent -type domain [-responses xmlfile] [-out file]
-responses
引数と-out
引数は省略可能です。これらの引数は、次の設定のデフォルト値をオーバーライドする場合に含めます。
アップグレード要件を定義するXMLファイルの場所。-responses
引数でファイルを指定しない場合、ウィザードはデフォルト値をアップグレード・プロセスで使用します。XMLファイルの形式とデフォルト値の詳細は、付録E「サイレント・アップグレード用XMLスクリプト・リファレンス」を参照してください。
すべての標準出力(stdout
)とエラー・メッセージが書き込まれる出力ファイル。-out
引数でファイルを指定しない場合、これらのメッセージはコマンド・ウィンドウに書き込まれます。
WebLogic 10.3.3以降、インストール・プログラムに含まれる評価版データベースが、PointBaseからApache Derbyに変更されています。評価版データベースは、サンプル・アプリケーションやコード例で使用されるため、またデモンストレーション・データベースとして使用するために提供されます。PointBaseを使用していたサンプルやデモのドメインをアップグレードする場合は、次の2つの方法から選択できます。
引続きPointBaseを使用するようにドメインをアップグレードします。
ドメインをアップグレードし、データベースをDerbyに移行します。
次の節では、これらの各選択肢を実行する方法について説明します。
WebLogic 10.3.6にアップグレードするドメインでデータベースとして引き続きPointBaseを使用するには、次の手順を実行します。
「アップグレードの準備」の説明に従ってWebLogic Server 10.3.6をインストールするとき、フル・インストーラではなくアップグレード・インストーラを使用します。アップグレード・インストーラを使用すると、前のWebLogic ServerインストールのPointBaseインストールが保存されます。
注意: アップグレード・インストーラをダウンロードするにはアクティブなMy Oracle Supportアカウントが必要です。詳細は、Oracle WebLogic Serverのインストレーション・ガイドのMy Oracle Supportからのアップグレード・インストーラのダウンロードに関する項を参照してください。 |
「アプリケーション環境のアップグレード」と「アップグレード後の手順の完了」で説明する手順を実行します。
PointBaseに関するドメインの構成設定が保存されます。
http://www.pointbase.com
でPointBaseのライセンスを取得します。
フル・インストーラを使用してWebLogic Server 10.3.6をインストールすると、PointBaseを使用するドメインがWebLogic Server 10.3.6にアップグレードされますが、PointBaseを起動できなくなります。これを防ぐために次のようにしてください。
PointBaseインストールをリストアします。
PointBaseデータベースのJARをCLASSPATH環境変数定義の最初に追加します。
サンプル・ドメインをWebLogic 10.3.6にアップグレードしてから、ドメイン・データベースをPointBaseからDerbyに移行する場合は、次の手順を実行します。
「アップグレードの準備」の説明に従い、アップグレード・インストーラまたはフル・インストーラを使用してWebLogic Server 10.3.6をアップグレードします。
「アプリケーション環境のアップグレード」と「アップグレード後の手順の完了」で説明する手順を実行します。
PointBaseデータベースのスキーマおよび表をDerbyにインポートします。Apache Derby Webサイト(http://db.apache.org/derby/integrate/index.html
)に、役立つヒントや情報があります。
次のDerbyデータベースのJARをCLASSPATH環境変数定義の最初に追加します。
WL_HOME
\common\derby\lib\derbynet.jar
WL_HOME
\common\derby\lib\derbyclient.jar