この章では、再構成ウィザードを使用して、WebLogic Server 10.3.1以降またはWebLogic Server 12.1.1を使用して作成されたWebLogic Serverドメインを再構成する方法について説明します。
再構成ウィザードを実行して、WebLogic Serverドメインを再構成する場合は、ドメインのアプリケーションによって、次の項目が自動的に更新されます。
WLSコア・インフラストラクチャ
ドメイン・バージョン
注意: 再構成ウィザードでは、ドメインに含まれる独自のアプリケーションは更新されません。独自のアプリケーションのアップグレード方法の詳細は、付録A「WebLogic Server 12.1.2の旧リリースとの互換性」を参照してください。 |
この章の内容は次のとおりです。
アップグレード・プロセスを開始する前に、次の2つのセクションを参照してください。
ドメインがWebLogic Server 10.3.0より前に作成された場合は、最初にWebLogic Server 10.3.6にアップグレードする必要があります。WebLogic Server 10.3.6にアップグレードした後で、ドメイン・アップグレード・ウィザードを実行して、ドメインをアップグレードします。
WebLogic Server 10.3.6へのアップグレードおよびドメイン・アップグレード・ウィザードの実行の詳細は、次のURLにある『Oracle WebLogic Serverアップグレード・ガイド(10.3.6)』を参照してください。
再構成ウィザードを実行してUNIXまたはLinuxオペレーティング・システムのドメインを再構成する前に、オペレーティング・システムの乱数ジェネレータを使用するためにCONFIG_JVM_ARGS
環境変数を次の値に設定します(まだ設定していない場合)。
-Djava.security.egd=file:/dev/./urandom
これにより、再構成ウィザードでドメインを再構成するのにかかる時間が短縮されます。
再構成ウィザードを実行する前に、ドメイン・ディレクトリのバックアップ・コピーを作成します。たとえば、C:\domains\mydomainをC:\domains\mydomain_backupにコピーします。
各リモート管理対象サーバーのドメインを更新する前に、各リモート・マシンのドメイン・ディレクトリのバックアップ・コピーを作成します。
ドメインの再構成がなんらかの理由で失敗した場合は、再構成を実行する前に、すべてのファイルおよびディレクトリをバックアップ・ディレクトリから元のドメイン・ディレクトリにコピーしてドメインを完全に元の状態に戻す必要があります。
WebLogicドメインは次のように再構成できます。
グラフィック・モードで、Fusion Middleware再構成ウィザードを実行します。
コマンド・ラインから、WebLogic Scripting Toolを使用します。
ドメインを再構成する場合:
ドメインのconfig.xmlファイルのドメイン・バージョン番号は、管理サーバーのインストール済WebLogic Serverバージョンのメジャーおよびマイナー・バージョン番号(たとえば、12.1.2.0)に更新されます。
すべてのインストール済Oracle製品の再構成テンプレートは、自動的に選択されてドメインに適用されます。これらのテンプレートは、WebLogicドメインが現在のWebLogic Serverバージョンと互換性を持つために必要な再構成タスクを定義します。
起動スクリプトが更新されます。
ドメインの既存のノード・マネージャ構成を使用するには、ノード・マネージャ構成を手動で完了する必要があります。
注意: ドメインのノード・マネージャをホストベースではなく、ドメインごとのタイプにする場合、既存のドメインを再構成するのではなく、新しいドメインを作成するために、構成ウィザードまたはWLSTを使用することをお薦めします。ノード・マネージャ・タイプの詳細は、『Oracle WebLogic Serverノード・マネージャ管理』のJavaノード・マネージャの構成に関する項を参照してください。 |
ドメインを再構成する場合は次の項目に注意してください。
管理サーバーのドメインを再構成した後で、再構成されたドメインをドメイン内のすべてのリモート管理対象サーバーにポートする必要があります。詳細は、「リモート・マシンの管理対象サーバー・ドメインの更新」を参照してください。
WLSTまたは再構成ウィザードのいずれかを使用してドメインを再構成した後で、ノード・マネージャ構成を完了するための追加の手順を実行する必要があります。「ノード・マネージャ構成の完了」を参照してください。
グラフィカル・モードで再構成ウィザードを使用してWebLogicドメインを再構成するには、次のようにウィザードを起動します。DOSコマンド・プロンプト・ウィンドウまたはUNIXシェルからのみ再構成ウィザードを起動できます。
注意: ドメインの再構成プロセスを開始すると、元に戻すことはできません。再構成ウィザードを実行する前に、「ドメインのバックアップ」の説明に従ってドメインをバックアップしてあることを確認してください。再構成ウィザードの実行中にエラーまたはその他の中断が発生した場合は、ファイルおよびディレクトリをバックアップの場所から元のドメイン・ディレクトリにコピーしてドメインをリストアする必要があります。これは、再構成前にドメインを確実に元の状態に戻す唯一の方法です。 |
注意: GUIモードで再構成ウィザードを実行できない状況では、WLSTスクリプトを使用してドメインを再構成することをお薦めします。詳細は、「WebLogic Scripting Toolを使用したWebLogicドメインの再構成」を参照してください。 |
Windowsコマンド・プロンプトまたはUNIXシステムから、再構成ウィザードをグラフィカル・モードで起動する手順は次のとおりです。
ドメインが存在するシステムにログインします。
MS-DOSコマンド・プロンプト・ウィンドウ(Windows)またはコマンド・シェル(UNIX)を開きます。
次のディレクトリに移動します:
Windowsの場合: ORACLE_HOME\oracle_common\common\bin
UNIX:の場合: ORACLE_HOME/oracle_common/common/bin
ORACLE_HOMEはOracleホーム・ディレクトリです。
次のコマンドを実行します。
Windowsの場合: reconfig.cmd
UNIXの場合: sh reconfig.sh
注意:
コマンドに |
「ドメインの選択」画面が表示されます。
再構成ウィザードでは、表3-1にリストされる順序で一連の画面が表示されます。各画面の詳細は、第5章「再構成ウィザードの画面」の関連項目を参照するか、または「画面」列のリンクをクリックします。
注意: ドメインおよび他の要因により、アプリケーションによって、次の表に表示される画面のほかに、追加の構成画面が表示される場合もあります。これらの画面の詳細は、画面の「ヘルプ」ボタンをクリックするか、または第5章を参照してくだい。 再構成中に「拡張構成」画面が表示される場合は、オプションを選択しないで、すべての拡張構成をスキップしてくだい。必要に応じて、後でWLST、構成ウィザードまたは管理コンソールを使用して、サーバーおよびクラスタの追加やデプロイメント・ターゲット指定の変更などの拡張構成を実行できます。 |
表3-1 既存のWebLogicドメインの再構成
画面 | 画面がいつ表示されるか | 次のアクションを実行 |
---|---|---|
|
常時 |
ドメイン・ディレクトリへのフルパスを入力するか、「参照」をクリックして、ドメイン・ディレクトリに移動して選択します。 「次へ」をクリックして、続行します。 |
|
常時 |
再構成テンプレートのアプリケーションの進行状況を表示します。 処理が終了したら、「次へ」をクリックして、続行します。 |
|
常時 |
ドメイン・モードは変更できません。 ドメインで使用するJDKを選択するか、「参照」をクリックして使用するJDKに移動します。 「次へ」をクリックして、続行します。 |
この時点で追加のドメイン構成画面が表示される場合があります。 |
追加の画面はドメイン構成によって異なります。 |
画面の「ヘルプ」ボタンをクリックするか、または表示順に画面のすべてが説明されている第5章を参照してください。 |
|
常時 |
詳細構成タスクを実行する各カテゴリ(存在する場合)のチェック・ボックスを選択します。 使用可能なチェック・ボックスは、ドメイン構成によって異なります。 「次へ」をクリックして、続行します。 |
この時点で追加のドメイン構成画面が表示される場合があります。 |
追加の画面は、選択した「拡張構成」オプションによって異なります。 |
画面の「ヘルプ」ボタンをクリックするか、または表示順に画面のすべてが説明されている第5章を参照してください。 |
|
常時 |
構成を確認します。 構成を変更するには「戻る」ボタンをクリックし、ドメイン再構成プロセスを完了するには「再構成」ボタンをクリックします。 |
|
常時 |
再構成プロセスの最終ステータスを表示します。 構成ウィザードを終了するには、「終了」をクリックします。 |
この項では、readDomainForUpgrade
コマンドを使用し、オフライン・モードでWebLogic Scripting Tool (WLST)を使用してドメインを再構成する方法について説明します。
注意: ドメインの再構成プロセスを開始すると、元に戻すことはできません。WLSTを使用してドメインの再構成を実行する前に、「ドメインのバックアップ」の説明に従ってドメインをバックアップしてあることを確認してください。再構成の実行中にエラーまたはその他の中断が発生した場合は、ファイルおよびディレクトリをバックアップの場所から元のドメイン・ディレクトリにコピーしてドメインをリストアする必要があります。これは、再構成前にドメインを確実に元の状態に戻す唯一の方法です。 |
次の例のスクリプトは、オフラインでWLSTを使用してmy_domain
というドメインを再構成する方法を示しています。
ドメインを再構成した後で、次の手順を実行してノード・マネージャ構成を完了します。
注意: 次の手順は、1つのノード・マネージャを使用してドメインのすべてを制御するように、以前のインストール時と同様にノード・マネージャを実行するよう構成する方法について説明します。 |
新しいWebLogic Serverのインストールでは、ORACLE_HOME/oracle_common/commonにnodemanager
ディレクトリを作成します。
nodemanager.propertiesおよびnodemanager.domainsファイルを以前のWebLogic ServerインストールのWL_HOME/common/nodemanagerディレクトリから、手順1で作成したディレクトリにコピーします。
以前のインストールにnm_data.properties、SerializedSystemIni.dataまたはsecurity/SerializedSystemIni.datファイルが含まれている場合は、それを手順1で作成したディレクトリにコピーします。SerializedSystemIni.datをコピーする場合は、nodemanager
ディレクトリの下にsecurity
ディレクトリを作成して、そこにファイルを格納します。
nodemanager.propertiesファイルに次の編集を行います。ORACLE_HOMEは、WebLogic Server 12.1.2インストールのOracleホーム・ディレクトリです。
DomainsFile
をORACLE_HOME/oracle_common/common/nodemanager/nodemanager.domainsファイルを指すように更新します。
ファイルにjavaHome
プロパティ設定が含まれる場合は、必要でない場合は削除します。
JavaHome
をWebLogic Server 12.1.2に対して使用しているJDKのjre
ディレクトリを指すように更新します。
NodeManagerHome
をORACLE_HOME/oracle_common/common/nodemanagerを指すように更新します。
LogFile
をORACLE_HOME/oracle_common/common/nodemanager/nodemanager.logを指すように更新します。
独自のセキュリティ証明書を使用している場合は、これらの証明書の場所がnodemanager.propertiesで正しいことを確認します。証明書を別の場所に移動した場合はパスを更新する必要がある場合があります。
以前のインストールでWebLogic Serverデモ証明書を使用していた場合は、CertGen
を実行してこのインストールのデモ・キーストアを作成する必要があります。
setWLSEnv
を実行します。
cd
WL_HOME
/server/bin
. ./setWLSEnv.sh
(UNIX)
setWLSEnv.cmd
(Windows)
注意: UNIXオペレーティング・システムでは、 |
ORACLE_HOME/oracle_common/common/nodemanager/ディレクトリに変更し、存在しない場合はセキュリティ・ディレクトリを作成します。
セキュリティ・ディレクトリに変更し、次のコマンドを入力します。
java utils.CertGen -certfile democert -keyfile demokey -keyfilepass DemoIdentityPassPhrase
次のコマンドを入力して、DemoIdentity.jksファイルを生成します。
java utils.ImportPrivateKey -certfile democert.pem -keyfile demokey.pem -keyfilepass DemoIdentityPassPhrase -keystore DemoIdentity.jks -storepass DemoIdentityKeyStorePassPhrase -alias demoidentity
ORACLE_HOME/wlserver/server/bin directoryから、startNodeManager.cmd
(Windows)またはstartNodeManager.sh
(UNIX)を実行します。
ノード・マネージャを使用してサーバーを起動できることを確認します。詳細は、『Oracle WebLogic Serverノード・マネージャの管理』のノード・マネージャを使用したサーバーの制御に関する項を参照してください。permgen
設定がサーバーの起動に十分であることを確認するには、次の方法のいずれかを使用できます。
startManagedWebLogic
スクリプトを使用して管理対象サーバーを起動します。
nodemanager.properties
のStartScriptEnabled
値をtrue
に設定します。これにより、管理対象サーバーの起動時にStartManagedWebLogic
スクリプトを起動できます。
Setting permgen space.で説明されるようにpermgen
スペースを設定します。
サーバーを起動するためにsetUserOverrides
スクリプトを使用してpermgen
設定を指定します。詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』のドメイン全体のサーバー・パラメータのカスタマイズに関する項を参照してください。
WebLogicドメインに複数の管理対象サーバーが含まれ、各管理対象サーバー・ドメイン・ディレクトリが管理サーバーが存在しないリモート・マシン上にある場合、そのリモート・マシン上のドメインを更新するには次の方法のいずれかを使用できます。
pack -managed=true
コマンドを実行してドメイン・テンプレートJARを生成し、JARをリモート・マシンに移動して、リモート・マシン上のunpack
を使用して管理対象サーバー・ドメインを作成します。詳細は、『PackおよびUnpackコマンドによるテンプレートとドメインの作成』を参照してください。
オンライン・モードでWLST writeTemplate
コマンドを使用します。リモート・マシンから管理サーバーへの接続時にwriteTemplate
コマンドを実行する場合は、管理サーバー上のドメインをテンプレートJARファイルを動的にパックして、そのテンプレートJARを指定されたディレクトリに転送します。
次のサンプルのWLSTスクリプトは、writeTemplate
を使用してリモート・マシン上で管理対象サーバー・ドメインを作成または更新する方法を示しています。ドメインの各リモート・マシン上でスクリプトを実行します。このスクリプトでは次の操作を実行します。
管理サーバーへのログイン
管理サーバー・ドメインをJARファイルにパックして、それをリモート・マシン上の指定されたテンプレート・ディレクトリに書き込む
管理サーバーからの切断
テンプレートJARの読取り
リモート・マシン上でのドメインの作成
import os wlsHome = os.getenv('WL_HOME') mwHome = os.path.join(wlsHome, '..') #Substitute the administrator user name and password values below as needed connect('adminuser','adminpassword','admin_server_url') #Create the path on the local machine where the template will be stored, #The specified template JAR should not already exist. The timeout value #specifies the number of milliseconds to elapse before the connection between #the Administration Server and remote machine times out (default is 120000). templatePath = '/user_templates/myTemplate.jar' timeout = '180000' #get the packed template from the Administration Server writeTemplate(templatePath, timeout) #disconnect from online WLST connection to the Administration Server disconnect() #read the template that was downloaded from the Administration Server readTemplate(templatePath) #specify the domain directory where the domain needs to be created domainPath = 'domains/myDomain') #create the domain writeDomain(domainPath)
アップグレード・プロセスには次の重要な情報があります。
WebLogic Serverアプリケーションをアンデプロイする必要はありません。ほとんどのWebLogic Serverアプリケーションは、修正を加えることなくWebLogic Server 12.1.2のアプリケーション環境で動作します。実際の環境においてアプリケーションが機能変更の影響を受けるかどうかについては、付録A「WebLogic Server 12.1.2の旧リリースとの互換性」で互換性情報を確認してください。アプリケーションで非推奨になった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 12.1.2にアップグレードできません。
リモートの管理対象サーバーのドメインをアップグレードするとき、参照されているアプリケーション・パスがシステムにないことを通知する次のようなメッセージが表示される場合があります。
<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から12.1.2にアップグレードした場合は、サーバーを起動する前に、setDomainEnv.shファイルの起動コマンドから-Xverify:none
を削除します。これを行うには、次の行の後でJAVA_OPTIONS=""
を設定します。
. ${WL_HOME}/common/bin/commEnv.sh
そうでない場合、JVMエラーのためサーバーの起動に失敗します。
アプリケーション環境をアップグレードした後で、次のタスクを実行する必要がある場合があります。
必ずしもすべての手順を実行する必要があるわけではありません。以下の説明に基づいて、アプリケーション環境に必要な手順を決定してください。互換性の問題が環境に適用されるかどうかについては、付録A「WebLogic Server 12.1.1の旧リリースとの互換性」で互換性問題を確認してください。
アプリケーション環境の12.1.2へのアップグレードを完了するには、起動スクリプトへのカスタマイズの再適用が必要になる場合があります。次の節では、デフォルト起動スクリプトおよびカスタム起動スクリプトをカスタマイズする方法について説明します。
再構成ウィザードによるアップグレード・プロセスでは、デフォルト起動スクリプトに対して行われたカスタマイズの内容(JAVA_OPTIONS
環境変数の設定など)は保持されません。アップグレード・プロセスが完了した後に、デフォルト起動スクリプトを再びカスタマイズする必要があります。
ドメインを12.1.2にアップグレードすると同時にPointBaseを継続して使用する場合は、PointBaseのJARファイルをCLASSPATH環境変数定義の先頭に追加する必要があります。これを行うには、setDomainEnvファイル内のset CLASSPATH
文を変更します。
注意: WebLogic Server 12.1.2ではPointBase 5.7がサポートされますが、PointBaseの任意のバージョンをWebLogic Server 10.3.3以上で使用するには、 |
カスタム起動スクリプトを作成した場合は、次の手順に従って手動で更新する必要があります。
JDKバージョンをWebLogic Serverで使用しているJDKに設定します。
次のようにCLASSPATH変数を更新します。
WebLogic Server 12.1.2のクラスを変数の先頭に追加します。
使用されていない10.3より前のバージョンのWebLogicのクラスをすべて削除します。
PointBaseを継続して使用するには、PointBaseデータベースのJARをCLASSPATH環境変数定義の最初に追加します。
評価版データベースを使用するドメインのアップグレードの詳細は、「評価版データベースを使用するドメインのアップグレード」を参照してください。
次のようにファイル権限を確認します。
アップグレード・プロセスにおいてドメイン・ディレクトリのバックアップを行った場合、バックアップ・ファイルには機密情報が含まれている可能性があるため、バックアップ・ファイルを保護する必要があります。
アップグレード・プロセスでは、ファイル権限は保持されません。デフォルト以外のファイル権限がファイルに設定されている場合は、これらを確認し、リセットする必要があります。
UNIXシステムでは、アップグレード・プロセス中に作成される新しいファイルの所有権と権限は、アップグレードを実行するユーザーに割り当てられます。たとえば、アップグレードがrootにより実行される場合、新しいファイルの所有権はrootに割り当てられます。このため、後でドメイン内のこれらのファイルを更新するユーザーにはroot権限が必要となります。したがって、アップグレード・プロセス中に作成されたファイルに設定されている権限を確認または修正することをお薦めします。
管理サーバーを起動したら、JAVA_HOME
、BEA_HOME
、CLASSPATH
などのリモート・サーバー起動オプションが、対象の管理対象サーバーにインストールされているWebLogic Server 12.1.2を参照していることを確認します。これは管理コンソールを使用して行います。詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプの管理対象サーバーの起動引数の構成に関する項を参照してください。
注意: リモート・サーバー起動オプションが正しく設定されていないと、ノード・マネージャを使用して管理対象サーバーを起動するときに、次のようなメッセージがログ・ファイルに書き込まれることがあります。このメッセージは再帰的に送信されるため、最終的に使用可能なディスク容量がすべて消費されるおそれがあります。 |
No config.xml was found. Would you like the server to create a default configuration and boot? (y/n): java.io.IOException: The handle is invalid
アプリケーション環境を本番環境にプロモートする前に、標準的な品質保証およびパフォーマンス・チューニングを行います。テスト・アプリケーション環境でアプリケーション(外部クライアント・アプリケーションを含む)の動作をテストすることをお薦めします。非推奨となったAPIまたは削除されたAPIがアプリケーションで使用されている場合は、実行時に警告または例外が発生するおそれがあります。発生した場合は、アプリケーション環境を本番環境にプロモートする前に、必要な修正を行う必要があります。
すべてのテスト基準をクリアしていれば、「ステップ4: アップグレード計画の作成」で定義したアップグレード計画に従って、アプリケーション環境を本番環境にプロモートできます。
新しい12.1.2のアプリケーション環境が本番環境にデプロイされたら、既存の環境から新しい環境にリクエストをリダイレクトできるようになります。このようにして、最終的には、既存の環境を安全な停止状態にすることができます。これは、ロード・バランサなどを使用して行います。
WebLogic 10.3.3以降、インストール・プログラムに含まれる評価版データベースが、PointBaseからDerbyに変更されています。評価版データベースは、サンプル・アプリケーションやコード例で使用されるため、またデモンストレーション・データベースとして使用するために提供されます。PointBaseを使用していたサンプルやデモのドメインをアップグレードする場合は、ドメインのPointBaseを引き続き使用するオプションがあります。
WebLogic 12.1.2にアップグレードするドメインでデータベースとして引き続きPointBaseを使用するには、次の手順を実行します。
「アップグレードの準備」の説明に従ってWebLogic Server 12.1.2をインストールするとき、フル・インストーラを使用する必要があります。フル・インストーラを使用すると、前のWebLogic ServerインストールのPointBaseインストールが保存されません。
「アプリケーション環境のアップグレード」と「アップグレード後のタスクの実行」で説明されている手順を実行します。
PointBaseに関するドメインの構成設定が保存されます。
http://www.pointbase.com
でPointBaseのライセンスを取得します。
PointBaseインストールをリストアします。PointBaseは、WL_HOME/common/eval/pointbaseディレクトリにインストールされます。
PointBaseデータベースのJARをCLASSPATH環境変数定義の最初に追加します。