WebLogic Portal 8.1 へのアップグレード
![]() |
![]() |
![]() |
![]() |
この節では、Service Pack 5 (SP5) のインストール後、ポータル アプリケーションに Service Pack の変更を適用する手順について説明します。Service Pack をインストールする手順については、次の URL にある「Service Pack とローリング パッチのインストール」を参照してください。
http://edocs.beasys.co.jp/e-docs/platform/docs81/install/update.html
手動でのタスクの実行またはコンフィグレーションの変更が必要な機能の変更の詳細については、以下の節を参照してください。
アップグレード元のリリースが 8.1 であるか 8.1 (以前の Service Pack) であるかにかかわらず、次の基本的なプロセスを実行します。
注意 : Service Pack 5 用にデータベース スキーマを変更する必要はありません。ただし、提供のスクリプトを使用して、SP5 に準拠するようにデータベースのデフォルト マークアップを更新する必要があります。
以下のいずれかのアップグレード方法を選択する必要があります。
通常、ドメイン コンフィグレーションの再作成に慣れていて、ドメインが必ず最新のドメイン テンプレートに基づくようにする必要がある場合に、この方法を使用します。この方法を使用する場合は、「新規 SP5 ドメインの作成」に進んでください。
新しい SP5 ライブラリを使用するために、既存の SP3 ドメインまたは SP4 ドメインをアップグレードする方法を選択した場合、アップグレードする手順は、SP5 をインストールした方法によって異なります。以降の節では、アップグレード オプションと手動で行う必要がある更新処理について説明します。
インストールされている既存の SP3 または SP4 を、WebLogic Portal SP5 アップグレード インストーラを使用して更新した場合は、SP3 ドメインまたは SP4 ドメインを変更する必要はありません。すべてのスクリプトで、SP5 環境に対応する適切な新ライブラリを指定する必要があります。
「手順 2 : 既存のポータル フレームワーク データのアップグレード」に進みます。
JDK は固有の場所に存在することがあるため、アップグレード インストーラでは JDK へのパスを更新できません。SP5 の新しい JDK を指すようにパスを更新するには、表 7-7 に示すスクリプト内の変数を編集します。
ポータル Web プロジェクトに自動的に作成される url-template-config.xml
ファイルには、WSRP ポートレットの URL テンプレートと変数が含まれます。このファイルで WSRP URL テンプレートごとに次の 2 箇所を変更し、BEA 提供のコンシューマが BEA 以外のプロデューサからのモード変更と状態変更を受け付けられるようにします。
また、BEA 以外のコンシューマが BEA 提供のプロデューサから返される URL を識別できるように、プロデューサは、標準モードとウィンドウ状態に関して URL で wsrp:
プレフィックスを使用する必要があります。
完全なインストーラを使用して SP5 を別のディレクトリにインストールした場合は、SP3 ドメインまたは SP4 ドメインのスクリプトを手動で更新する必要があります。
setDomainEnv
スクリプトで、以下の変数を必要に応じて更新します。
注意 : setDomainEnv
ファイルには DOMAIN_NAME
変数が含まれています。既存のドメインを SP5 にアップグレードするときに、この変数の値を変更しないでください。
SP5 対応の新しい JDK を指すようにパスを更新する必要があります。変数とそれに対応するスクリプトを表 7-8 に示します。
次の表に示すその他の変数とファイルは、各環境でどのスクリプトを使用しているかによって、更新が必要な場合と必要でない場合があります。既存のドメイン ディレクトリのファイルを見直し、必要なすべての変更を行ったことを確認するようにお勧めします。
既存の SP3 ドメインまたは SP4 ドメインを反映した新しい SP5 ドメインを作成するには、次の手順に従います。
http://edocs.beasys.co.jp/e-docs/platform/docs81/confgwiz/newdom.html の「新規 WebLogic ドメインの作成」を参照してください。
警告 : SP3 から SP5 にアップグレードする場合は、「Service Pack 4 へのアップグレード」の説明に従って、まずデータベースを SP3 から SP4 にアップグレードする必要があります。その後で、この章の手順に従ってデータベース データを SP5 にアップグレードできます。
この手順で実行するスクリプトは、データベースのデフォルト マークアップを更新します。デフォルト マークアップは、WebLogic Portal Administration Portal でブック、ページ、およびデスクトップを作成するときに使用されます。スクリプトには、データベースの $(markupname)
トークンが含まれます。このトークンが追加されていない場合、Administration Portal または訪問者ツールを使用して作成されたデスクトップ、ページ、またはブックをインポートすると SAXParseException が送出されます。
SP4 データベースを SP5 にアップグレードするためのスクリプトは、SP5_WL_HOME
¥portal¥upgrade¥SP5
にあります。SP5_WL_HOME
は、SP5 の WL_HOME
ディレクトリです。
PointBase 以外のデータベースの場合、提供されている WebLogic Portal のアップグレード スクリプトを使用するためには、アップグレード スクリプトを実行するコンピュータにデータベース クライアント ソフトウェアがインストールされ、コンフィグレーションされている必要があります。
以下の手順で、WebLogic Platform 8.1 SP4 のデータベース データを SP5 に対応させます。これらの手順は、データベースの種類に関係なく適用されます。
これで、データベースがアップグレードされました。既存のアプリケーションをアップグレードする前に、アップグレードしたデータベースをバックアップします。
SP4 から SP5 にアップグレードする場合は、アプリケーションについて以下のコンフィグレーションの変更を行う必要があります。
サードパーティ製コンテンツ管理システムを使用する場合、デプロイする前にリポジトリを再コンフィグレーションする必要があります。これによって、パスワードが新しいドメイン用に再暗号化されます。アップグレードでドメインを切り替えない場合は、このタスクをスキップできます。
まず、Portal Administration Tools を使用して既存のリポジトリ接続を削除します。
アップグレードで新しいドメインに移行する場合は、WSRP ポートレットにアクセスするときに使用するすべてのパスワードを再暗号化する必要があります。暗号化は、ドメイン固有のものです。そのため、ドメインを切り替えるときに更新する必要があります。
アプリケーションを EAR ファイルとしてデプロイする場合は、手動で EncryptDomainString
コマンドライン ユーティリティを使用して暗号パスワードを生成し、そのパスワードを application-config.xml
ファイルに記述してから、アプリケーションをデプロイする必要があります。アプリケーションは新しいドメインにすでに存在する必要があります。
注意 : アプリケーションを (EAR ではなく) 展開された状態でデプロイする場合は、Portal Administration Portal のサービス管理ツールを使用してパスワードを再設定できます。サービス管理ツールでパスワードを再入力すると、パスワードは自動的に暗号化されます。ただし、アプリケーションをすでに EAR ファイルに圧縮している場合は、Portal Administration Tool を使用できません。
ポータル アプリケーションの META-INF
ディレクトリに該当の application-config.xml
ファイルがあり、このファイルに自動的に WSRP パスワードが格納されます。たとえば、コード リスト 7-1 は、EAR ファイルとしてデプロイする前の開発段階 (展開された状態) での application-config.xml
の WSRP 要素を示します。
コード リスト 7-1 application-config.xml
の開発段階のクリア テキスト パスワード
<ConsumerSecurityAdminPassword="weblogic" AdminUserName="weblogic"
CertAlias="wsrpConsumer" CertPrivateKeyPassword="wsrppassword"
ConsumerName="wsrpConsumer"
IdentityAssertionProviderClass="com.bea.wsrp.security.
DefaultIdentityAssertionProvider"
Keystore="wsrpKeystore.jks" KeystorePassword="password"
Name="ConsumerSecurity"/>
サービス管理ツールを使用して属性を編集し、ファイルを保存すると、コード リスト 7-2 のようにパスワードが自動的に暗号化されます。
コード リスト 7-2 application-config.xml
の暗号化されたパスワード
<ConsumerSecurityAdminPassword="{3DES}3QrrUeIwN/DxlDI++1ixPw=="
AdminUserName="weblogicc" CertAlias="wsrpConsumer"
CertPrivateKeyPassword="{3DES}g7h+VOSAsO9pSlvYSSB2iw=="
ConsumerName="wsrpConsumer"
IdentityAssertionProviderClass="com.bea.wsrp.security.
DefaultIdentityAssertionProvider"
Keystore="wsrpKeystore.jks" KeystorePassword=
"{3DES}1OLYVirMWOo+3sEU80cMqw==
"
Name="ConsumerSecurity" />
EAR ファイルに格納されたアプリケーションをアップグレードする場合は、暗号化を手動で更新する必要があります。
domain
/portal/
(domain
はアプリケーションのドメイン ディレクトリ) にナビゲートし、setDomainEnv.cmd
を実行します。
java com.bea.p13n.util.EncryptDomainString -targetDomainDird
-inputStrings
java com.bea.p13n.util.EncryptDomainString -targetDomainDir ¥bea¥weblogic81b¥samples¥domain¥portal -inputString weblogic
この例では、入力文字列 weblogic
は管理者のパスワードを表します (adminpassword=weblogic
、コード リスト 7-3 を参照)。コマンドライン ユーティリティによって、ドメイン固有の暗号化された文字列が出力されます。
図 7-1 WebLogic Workshop でファイルを開く
コード リスト 7-3 application-config.xml のクリア テキスト パスワード
<ConsumerSecurityAdminPassword="weblogic"
AdminUserName="weblogic"
CertAlias="wsrpConsumer"CertPrivateKeyPassword="wsrppassword"
ConsumerName="wsrpConsumer"
IdentityAssertionProviderClass="com.bea.wsrp.security.
DefaultIdentityAssertionProvider"
Keystore="wsrpKeystore.jks"KeystorePassword="password"
Name="ConsumerSecurity"/>
<ConsumerSecurity>(
コード リスト 7-3)
要素の各パスワードについて EncryptDomainString を実行する必要があります。コード リスト 7-4 EncryptDomainString ユーティリティで生成された暗号パスワード
<ConsumerSecurityAdminPassword="{3DES}3QrrUeIwN/DxlDI++1ixPw=="
AdminUserName="weblogicc" CertAlias="wsrpConsumer"
CertPrivateKeyPassword="{3DES}g7h+VOSAsO9pSlvYSSB2iw=="
ConsumerName="wsrpConsumer"
IdentityAssertionProviderClass="com.bea.wsrp.security.
DefaultIdentityAssertionProvider"
Keystore="wsrpKeystore.jks"KeystorePassword=
"{3DES}1OLYVirMWOo+3sEU80cMqw==
"
Name="ConsumerSecurity" />
理由にかかわらず、管理者のパスワードを変更する必要がある場合、単にパスワードを変更するだけでは、EAR の再ビルドと再デプロイが必要になります。これには時間がかかり効率が低下します。この問題を回避するために、次の手順に従います。
application-config.xml
ファイルに記述します。ポータル ライブラリの更新を含む新しい Service Pack をインストールした後、開発したアプリケーションのライブラリを更新する必要があります。更新すると、既存のライブラリは上書きされます。
外部ユーザ ストアに格納されているユーザ プロファイルのプロパティにアクセスするために、独自の統合ユーザ プロファイル (UUP) を開発している場合、アプリケーション ルート ディレクトリにある p13n_ejb.jar
ファイルを変更および再作成しているのが一般的です。p13n_ejb.jar
は、次の手順で上書きされるため、既存のファイルをバックアップしておく必要があります。アップグレードの手順を実行した後、更新された p13n_ejb.jar
を、開発した UUP を実装して作成しなおす必要があります。詳細については、http://edocs.beasys.co.jp/e-docs/wlp/docs81/users/uup.html#999527 で『ユーザ管理ガイド』の「統合ユーザ プロファイルの設定」を参照してください。
アプリケーションのライブラリを更新するには、以下の手順に従います。
Web プロジェクトを選択するたびに、次の警告ウィンドウが表示されます。
表示されたウィンドウを使用して Web プロジェクトのライブラリを更新しなかった場合は、後で更新できます。その場合は、[アプリケーション] ウィンドウで Web プロジェクト ディレクトリを右クリックし、[インストール
すでにプロダクション環境にデプロイされたポータル アプリケーションに Service Pack のライブラリの更新を適用するには、WebLogic Workshop でポータル アプリケーションを更新した後で、それらのアプリケーションを再デプロイします。デプロイメントの手順については、「手順 4 : アップグレードしたアプリケーションの再デプロイ」を参照してください。
p13n_ejb.jar
を変更して独自の統合ユーザ プロファイル (UUP) を開発した場合は、新しい p13n_ejb.jar
ファイルに UUP を再実装します。「始める前に - UUP について」を参照してください。
最後のアップグレード手順は、サーバ上にアプリケーションを再デプロイします。
デプロイメントの手順については、次の URL にある WebLogic Portal の『プロダクション業務ガイド』を参照してください。
http://edocs.beasys.co.jp/e-docs/wlp/docs81/prodOps/index.html
「WebLogic Portal 環境に影響する機能の変更」で説明している機能の変更を確認してください。ご使用の環境で手動アップグレード タスクが必要な場合は、手順に従ってタスクを実行します。
![]() ![]() |
![]() |
![]() |