注意:
この章の内容は次のとおりです。
注意:
Oracle WebCenter Portal 12.2.1からリリース12.2.1.1にパッチ適用するには、「Oracle WebCenterのアップグレード・プロセス・フローの理解」で説明している一般的なアップグレード手順に従います。リリース12.2.1.1に移行するための、WebCenter Portalに固有のアップグレード前後のタスクはありません。
この章では、「Oracle WebCenterのアップグレード手順の理解」にリストされている、WebCenter Portal 11gに固有のアップグレード手順について説明します。手順は「Oracle WebCenterのアップグレード手順の理解」にリストされている順序に従って実行してください。また、この章にリストされているアップグレード・タスクを実行する前に、必須の一般的な手順を実行したことを確認してください。
既存のOracle WebCenter Portal環境をアップグレードする前に、次のタスクを実行します。
WebCenter Portal環境でOIDベースのポリシー・ストアを使用している場合は、Oracle Internet Directory (OID)が起動し実行中であることを確認します。
Oracle WebCenter Portal 11gには、OmniPortlet、Webクリッピング、WSRPパラメータ・フォーム・ポートレット、サンプルWSRPポートレット・プロデューサ、およびサンプルPDK-Javaポートレット・プロデューサなどの、様々な事前構成済ポートレット・プロデューサが用意されています。11gのポートレット・プロデューサ・アプリケーションのカスタマイズ内容またはメタデータを移行するには、Oracle WebCenter Portalをアップグレードする前に、11gのアプリケーションからデータをエクスポートする必要があります。その後、アップグレード後のインスタンスに、これらのカスタマイズ内容をインポートしてポートレット・プロデューサ・アプリケーションに戻します。
exportPortletClientMetadata
WLSTコマンドを使用して、プロデューサ・メタデータをEARファイルにエクスポートできます。詳細は、『WebCenter WLSTコマンド・リファレンス』のexportPortletClientMetadataに関する項を参照してください。
11gのOracle WebCenter PortalインスタンスにWebクリッピングとOmniPortletsポートレットが含まれている場合は、WebCenter Portalのインスタンスをアップグレードする前に、それらのHTTPプロキシ・エントリのコピーを保存します。
注意:
このアップグレード前のタスクは、11.1.1.6.0、11.1.1.7.0、11.1.1.8.x、または11.1.1.9.xのポートレット・フレームワーク・アプリケーションをWebCenter Portal 12cに移行する場合に適用されます。Oracle WebCenter Portal 11gは、ポータル・フレーム・アプリケーション(以前はカスタム・ポータル・アプリケーションと呼ばれていた)をJDeveloperで作成およびデプロイするための、ポータル・フレームワーク・テクノロジをサポートしています。WebCenter Portal 12cリリースでは、ポータル・フレームワーク・テクノロジを使用できません。オラクル社では、ポータル・フレームワーク・アプリケーションをWebCenter Portalに移行するためのサポートを提供しています。このサポートは、アプリケーションをリリース11.1.1.6.0、11.1.1.7.0、11.1.1.8.x、または11.1.1.9.xから移行する場合に利用できます。移行後のアプリケーションは、WebCenter Portal 12cではポートレットとして使用できます。
ポータル・フレームワーク・アプリケーションをWebCenter Portal 12cに移行するには、最初に既存の環境にパッチを適用(Oracle WebCenter Portal 11.1.1.9.0用の最新パッチまで)してから、アプリケーションをリリース11.1.1.9.xに移行する必要があります。詳細は、『Oracle WebCenter Portalの管理』のポータル・フレームワーク・アプリケーションのWebCenter Portalへの移行に関する項を参照してください。パッチをWebCenter Portalリリース11.1.1.9.xまで適用したら、「Oracle WebCenterのアップグレード手順の理解」の説明に従って、リリース12cにアップグレードできます。
次の表では、Oracle WebCenter Portal 11gを12cにアップグレードするために必要なタスクについて説明します。
注意:
Oracle WebCenter Portal 11g
では、管理対象サーバーのデフォルトの名前は、WC_Spaces
、WC_Portlet
、WC_Collaboration
、およびWC_Utilities
です。Oracle WebCenter Portal 12c
のフレッシュ・インストールでは、AnalyticsをホストしていたWC_Utilities
は非推奨になり、これはWC_Portal
によってWC_Spaces
に置き換わり、Analyticsをホストします。Oracle WebCenter Portal 11g
から12c
にアップグレードする際に、管理対象サーバーのデフォルトの名前は変更されません。また、AnalyticsはWC_Utilities
管理対象サーバー上にデプロイされたままになります。表5-1 Oracle WebCenter Portal 11g
からのアップグレード
手順 | 説明 | 詳細情報 |
---|---|---|
ノード・マネージャが設定されており、管理対象サーバーを管理コンソールから起動できる場合は、 |
|
|
ノード・マネージャが設定されていない場合:
|
WebCenter PortalをFolders_gからFrameworkFoldersに移行してから、 |
|
アップグレード・メトリックにアクセスします |
オプション。 Oracle WebCenter Portalのアップグレード・メトリックにアクセスして、アップグレードのパフォーマンスを分析します。これは、サーバーを再起動する前に実行する必要があります。 |
|
Content Serverで追加のコンポーネントを有効化し、サーバーを再起動します |
Content Serverで、AutoSuggestConfig、DynamicConverter、およびImagingなどの追加のコンポーネントを有効化します。Site Studioが構成されている場合は、PortalVCRHelperを有効化します。次に、Content Serverを再起動します。 |
コンポーネント・マネージャを使用したコンポーネントの有効化または無効化 |
管理サーバーとすべての管理対象サーバーを再起動します |
Oracle Fusion Middleware環境を開始します。これには、Oracle WebLogic Server、ノード・マネージャ、管理サーバー、管理対象サーバー、OPMN、およびすべてのシステム・コンポーネントの起動が含まれマシ。 |
|
|
|
upgradeWebCenterPortal
WLSTコマンドを実行して、メタデータをMDSからデータベースに移動し、アップグレード後のOracle WebCenter Portal 11gのセキュリティ権限をアップグレードします。
upgradeWebCenterPortal
WLSTコマンドを実行するには、次の手順を実行します。
upgradeWebCenterPortal
WLSTコマンドによって生成される出力upgradeWebCenterPortal
WLSTコマンドでは、次のレポートが生成されます。
UpgradeSummary.txt
: アップグレードが試行され成功および失敗したポータルまたはポータル・テンプレートの合計数がリストされます。
UpgradeDetails.txt
: 各ポータルのアップグレードの詳細情報が表示され、ページ数、リソース・カタログ、アップグレードされたナビゲーションなどの詳細がリストされます。ポータルに対してレポートされたアップグレード・エラーの詳細も表示されます。
UpgradeDiagnostic.log
: upgradeWebCenterPortal
WLSTコマンドの診断情報が表示されます。
upgradeWebCenterPortal
を実行するたびに、前回の実行以降の詳細が追加され、レポートが更新されます。いずれかの手順でレポートされたアップグレード・エラーがある場合は、エラーを修正し、upgradeWebCenterPortal
を再度実行します。upgradeWebCenterPortal
によってポータルまたはポータル・テンプレートに対するアップグレード試行の失敗がレポートされなくなると、アップグレード・プロセスは完了したと見なされ、最後の出力に「WebCenter Portalアプリケーションのアップグレードが完了しました。」
というメッセージが表示されます。
アップグレードに関する問題のトラブルシューティングの詳細は、「Oracle WebCenter Portalのアップグレードに関する問題のトラブルシューティング」を参照してください。
サンプル・コマンド1
upgradeWebCenterPortal
WLSTコマンドを実行する際に、要件に応じたパラメータを指定できます。
たとえば、次のコマンドは、メタデータをMDSからDBに移動してセキュリティ権限をアップグレードします。
upgradeWebCenterPortal(appName='webcenter', server='WC_Spaces', migrationDirectory='/scratch/upgrade_log')
このコマンドを実行したときに表示されるメッセージの例を次に示します。
Starting WebCenter Portal application upgrade. Already in Domain Runtime Tree To effect connection changes, you must restart the managed server on which the WebCenter application is deployed. If you have set adminPassword, keystorePassword, or privateKeyPassword in your content server connection, then set the values again in the underlying RIDC connection. Do this by running setContentServerConnection and specifying the values, if applicable. Starting data migration from MDS to database... [TRACE]: Upgrade may take some time to complete depending on the number of portals and pages in your Oracle WebCenter Portal installation. To monitor the upgrade progress, refer to the diagnostic log file WC_Portal-diagnostic.log at the location "/scratch/software/user_projects/domains/base_domain/servers/WC_Spaces/logs". ####################################################### Upgrade Run: 1 ####################################################### Upgrade of 44 Portals/Portal Templates attempted. Upgrade of 44 Portals/Portal Templates succeeded. Upgrade of 0 Portals/Portal Templates failed. Data migration from MDS to database is successfully completed. Policy URI For Authenticated Access: oracle/wss10_saml_token_service_policy Already in Domain Runtime Tree Command FAILED, Reason: JPS-04207: Matching Grantee not found: [GranteeEntry: codeSource=file:${common.components.home}/modules/oracle.wsm.agent.common_11.1.1/wsm-agent-core.jar principals=[]]. Already in Domain Runtime Tree Command FAILED, Reason: JPS-04201: Cannot grant permission(s). Grant already exists for grantee [GranteeEntry: codeSource=null principals=[[AppRole: appID=webcenter name=s5f9c65ed_c93c_4467_96cf_06a82f3dad22#-#Spaces-User displayName=null description=null category=null uniquename=cn=s5f9c65ed_c93c_4467_96cf_06a82f3dad22\#-\#Spaces-User,cn=Roles,cn=webcenter,cn=opssSecurityStore,cn=JPSContext,cn=opssRoot guid=108CDE506D8A11E5BFE5CF1BB12B2942 members=[] classname=oracle.security.jps.service.policystore.ApplicationRole type=JPS_APPLICATION_ROLE]]]. Starting upgrade for portal roles... Upgrade of the portal roles is complete. Permissions upgrade completed with warnings WebCenter Portal application upgrade is complete.
注意:
upgradeWebCenterPermissions
WLSTコマンドを実行すると、権限がすでに存在する特定のエラー・メッセージが表示されます。次に例を示します。
Already in Domain Runtime Tree Command FAILED, Reason: JPS-04201: Cannot grant permission(s). Grant already exists for grantee [GranteeEntry: codeSource=null principals=[[AppRole: appID=webcenter name=s5f9c65ed_c93c_4467_96cf_06a82f3dad22#-#Spaces-User displayName=null description=null category=null uniquename=cn=s5f9c65ed_c93c_4467_96cf_06a82f3dad22\#-\#Spaces-User,cn=Roles,cn=webcenter,cn=opssSecurityStore,cn=JPSContext,cn=opssRoot guid=108CDE506D8A11E5BFE5CF1BB12B2942 members=[] classname=oracle.security.jps.service.policystore.ApplicationRole type=JPS_APPLICATION_ROLE]]].
そのようなエラー・メッセージによる機能への影響はありません。エラー・メッセージを無視しても問題なく、WebCenter Portalインスタンスのアップグレードを続行できます。
サンプル・コマンド2
次のサンプル・コマンドは、Content Serverを使用するように構成されたWebCenter Portalをアップグレードします。
upgradeWebCenterPortal(appName='webcenter', server='WC_Spaces', migrationDirectory='/scratch/upgrade_log', contentServerName='UCM_server1', contentDbConnectionUrl='wccdbhost:wccdbport:wccdbsid',contentDbUserName='DEV_OCS')
このコマンドを実行したときに表示されるメッセージの例を次に示します。
Starting WebCenter Portal application upgrade. Restarting Content Server to verify whether the Node Manager is configured properly. Already in Domain Runtime Tree Shutting down the server UCM_server1 with force=true while connected to AdminServer ... . Starting server UCM_server1 ............................................................................. Server with name UCM_server1 started successfully Already in Domain Runtime Tree Enter the password for OCS Schema owner : XXXXX Starting migration to FrameworkFolders. Starting export of Folders_g data. Already in Domain Runtime Tree Export of Folders_g data is complete. Starting migration of WebCenter Content Server to FrameworkFolders. Enabling 'FrameworkFolders' server components. Already in Domain Runtime Tree Enabling 'FrameworkFolders' server components is complete. Starting update of Content Server general configuration. Already in Domain Runtime Tree Updating Content Server general configuration is complete. Restarting Content Server. Already in Domain Runtime Tree Shutting down the server UCM_server1 with force=true while connected to AdminServer ... .. Starting server UCM_server1 ............................................................................................. Server with name UCM_server1 started successfully Restarting Content Server is complete. Migration of 'PersonalSpaces' folder and content from Folders_g to the FrameworkFolders data structure started. Already in Domain Runtime Tree Migration of 'PersonalSpaces' folder and content from Folders_g to the FrameworkFolders data structure is complete. Already in Domain Runtime Tree Migration of 'WebCenterSpaces-Root' folder and content from Folders_g to the FrameworkFolders data structure started. Already in Domain Runtime Tree Migration of 'WebCenterSpaces-Root' folder and content from Folders_g to the FrameworkFolders data structure is complete. Starting update of Content Server general configuration. Already in Domain Runtime Tree Updating Content Server general configuration is complete. Restarting Content Server. Already in Domain Runtime Tree Shutting down the server UCM_server1 with force=true while connected to AdminServer ... .. Starting server UCM_server1 .................................................................. Server with name UCM_server1 started successfully WebCenter Content Server migration to FrameworkFolders is complete. Starting migration of WebCenter Portal data to FrameworkFolders. Already in Domain Runtime Tree Migration of WebCenter Portal data to FrameworkFolders is complete. Already in Domain Runtime Tree Shutting down the server UCM_server1 with force=true while connected to AdminServer ... ... Starting server UCM_server1 ........................................................................................ Server with name UCM_server1 started successfully Already in Domain Runtime Tree Shutting down the server WC_Portal with force=true while connected to AdminServer ... ..... Starting server WC_Spaces ......................................................................................................................................................................................................... Server with name WC_Spaces started successfully Migration to FrameworkFolders is complete. Starting WebCenter Portal application upgrade. Already in Domain Runtime Tree To effect connection changes, you must restart the managed server on which the WebCenter application is deployed. If you have set adminPassword, keystorePassword, or privateKeyPassword in your content server connection, then set the values again in the underlying RIDC connection. Do this by running setContentServerConnection and specifying the values, if applicable. Starting data migration from MDS to database... [TRACE]: Upgrade may take some time to complete depending on the number of portals and pages in your Oracle WebCenter Portal installation. To monitor the upgrade progress, refer to the diagnostic log file WC_Portal-diagnostic.log at the location "/scratch/software/user_projects/domains/base_domain/servers/WC_Spaces/logs". ####################################################### Upgrade Run: 1 ####################################################### Upgrade of 44 Portals/Portal Templates attempted. Upgrade of 44 Portals/Portal Templates succeeded. Upgrade of 0 Portals/Portal Templates failed. Data migration from MDS to database is successfully completed. Policy URI For Authenticated Access: oracle/wss10_saml_token_service_policy Already in Domain Runtime Tree Command FAILED, Reason: JPS-04207: Matching Grantee not found: [GranteeEntry: codeSource=file:${common.components.home}/modules/oracle.wsm.agent.common_11.1.1/wsm-agent-core.jar principals=[]]. Already in Domain Runtime Tree Command FAILED, Reason: JPS-04201: Cannot grant permission(s). Grant already exists for grantee [GranteeEntry: codeSource=null principals=[[AppRole: appID=webcenter name=s5f9c65ed_c93c_4467_96cf_06a82f3dad22#-#Spaces-User displayName=null description=null category=null uniquename=cn=s5f9c65ed_c93c_4467_96cf_06a82f3dad22\#-\#Spaces-User,cn=Roles,cn=webcenter,cn=opssSecurityStore,cn=JPSContext,cn=opssRoot guid=108CDE506D8A11E5BFE5CF1BB12B2942 members=[] classname=oracle.security.jps.service.policystore.ApplicationRole type=JPS_APPLICATION_ROLE]]]. Starting upgrade for portal roles... Upgrade of the portal roles is complete. Permissions upgrade completed with warnings WebCenter Portal application upgrade is complete.
Oracle WebCenter Portal 12cでは、投票およびドキュメント・タスク・フローなどの特定の機能が非推奨になりました。アップグレード後にアップグレード監査ツールを実行して、アップグレード後のWebCenter Portalインストールでのすべての非推奨機能の使用状況をリストできます。
listDeprecatedFeaturesUsage
WLSTコマンドを実行して、アップグレード後のOracle WebCenter Portalインストールでの非推奨機能の使用状況をリストします。
listDeprecatedFeaturesUsage(appName='webcenter', server='WC_Spaces', reportDirectory='/scratch/audit', portal='portal1, portal2')
それぞれの意味は次のとおりです。
appName
は、非推奨機能を監査する対象のWebCenter Portalアプリケーションです。
server
は、WebCenter Portalがデプロイされている管理対象サーバーです。
reportDirectory
は、監査レポートが生成される書込み可能なディレクトリのパスです。
portal
は、監査対象の特定のポータルのリストです。ポータル名のカンマ区切りリストを渡すことができます。これはオプション・パラメータです。このパラメータを指定しない場合、WebCenter Portalアプリケーション全体のレポートが生成されます。
たとえば、次のコマンドでは、WC_Spaces
という管理対象サーバーにデプロイされたWebCenter Portalアプリケーションの監査レポートを生成し、/scratch/audit
というフォルダにレポートを保存します。
listDeprecatedFeaturesUsage(appName='webcenter', server='WC_Spaces', reportDirectory='/scratch/audit')
WebCenter Portalアプリケーション全体のアップグレード監査レポートを生成する場合、WLSTコマンドのreportDirectory
パラメータで指定したディレクトリのauditReport
サブディレクトリに、次のファイルが生成されます。
summary.txt
: 図5-1に示すように、非推奨機能が含まれるポータルとポータル・テンプレートをリストし、非推奨機能が含まれるアーティファクトの数を示します。
connections.txt
: WebCenter Portalの非推奨接続をリストします。
注意:
機能上の問題が発生する可能性があるため、非推奨接続を削除する必要があります。
非推奨機能が含まれる、ポータルおよびポータル・テンプレートごとの.txt
ファイル: 非推奨機能が含まれるアーティファクト(ページ、ページ・テンプレート、リソース・カタログなど)をリストし、非推奨機能の名前を示します。図5-3に、特定のポータルの監査レポートを示します。
次の例では、MyPortal
という名前のポータルのみを対象とした監査レポートが生成されます。これによりMyPortal.txt
ファイルのみが生成されます。ポータルに対する接続ファイルとサマリー・ファイルは生成されません。
listDeprecatedFeaturesUsage(appName='webcenter', server='WC_Spaces', reportDirectory='/scratch/audit', portal='MyPortal')
アップグレード後のWebCenter Portalで、ポータル・ページに非推奨機能が含まれている場合、ページ・ビュー・モードではその機能が空白で表示されます。ページ編集モードでは、機能が非推奨であるというメッセージが表示され、必要なアクションがリストされます。たとえば、図5-4では、非推奨の投票タスク・フローがページ・エディタにリストされています。メッセージには、非推奨のタスク・フローを削除する必要があることが示されています。
図5-4 アップグレード後のWebCenter Portalインスタンスのページ・エディタに表示された非推奨タスク・フロー
Oracle WebCenter Portalをアップグレードした後に、アップグレード後のタスクを実行します。
アップグレード後のOracle WebCenter Portalインスタンスでは、11gのポートレットにアクセスできません。ポートレットを有効にするには、必要なポートレット・プロデューサ・アプリケーションをリリース12.2.1に移行する必要があります。また、ポートレット・プロデューサのカスタマイズ内容をインポートして、ポートレット・プロデューサ・アプリケーションを再デプロイする必要があります。
このトピックの内容は次のとおりです。
アップグレード済ポートレット・プロデューサ・アプリケーションは、Oracle WebLogic Serverの管理対象サーバーでOracle WebCenter Portalのポートレット・プロデューサをサポートする構成のサーバーであれば、どのサーバーにもデプロイできます。デプロイメントには、Oracle Enterprise Manager Fusion Middleware Control、Oracle WebLogic Server管理コンソールまたはOracle WebLogic Scripting Tool (WLST)を使用できます。詳細は、『Oracle WebCenter Portalの管理』のポートレット・プロデューサ・アプリケーションのデプロイに関する項を参照してください。
WebLogicサーバーへのアクセスに必要な資格証明がある場合は、JDeveloperを使用して、ポートレット・プロデューサ・アプリケーションを開発環境から直接Oracle WebLogic Serverインスタンスにデプロイすることも可能です。詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の事前構成済ポートレット・プロデューサのデプロイに関する項を参照してください。
ポートレット・プロデューサのアップグレード後に、カスタマイズ内容が共有されていない場合、またはアップグレード済ポートレット・プロデューサからカスタマイズ内容にアクセスできない場合は、そのカスタマイズ内容をインポートする必要があります。「Oracle WebCenter Portalのアップグレード前のタスクの実行」で説明しているようにエクスポートしたEARから、カスタマイズ内容をインポートします。
カスタマイズ内容をインポートするには、importPortletClientMetadata
WLSTコマンドを使用します。詳細は、『WebCenter WLSTコマンド・リファレンス』のimportPortletClientMetadataに関する項を参照してください。
OmniPortletおよびWebクリッピング構成を保存(「OmniPortletおよびWebクリッピング構成の保存」参照)した後、Oracle WebCenter Portalインスタンスが正常にアップグレードされたら、それらをリストアします。
リリース11.1.1.7.0では、ポータルのナビゲーション内のページ(以前はスペースと呼ばれた)は、ページ問合せによるものです。12cにアップグレードすると、これらの各ページはナビゲーションに追加されます。そのため、ポータルに重複したページが作成されることになります。『Oracle WebCenter Portalでのポータルの構築』のページの削除に関する項の説明に従って、重複したページを削除できます。
upgradeWebCenterPortal
コマンドを正常に実行できたら、listContentServerConnections
WLSTコマンドを実行して、Content Server接続がアップグレードされたことを確認します。詳細は、『WebCenter WLSTコマンド・リファレンス』.のlistContentServerConnectionsに関する項を参照してください。
listContentServerConnections
WLSTコマンドの出力に次のメッセージが表示された場合は、upgradeWebCenterPortal
を再度実行して、Content Server接続をアップグレードします。
基になるRIDC接続がありません。
このトピックでは、リリース12.2.1で非推奨になった11gの機能をアップグレードすることによる影響について説明します。
次のトピックが含まれています:
デバイス設定によって、デスクトップ・ブラウザ、スマートフォン、タブレットなどの様々な種類のデバイスにおけるポータルのレンダリング方法が制御されます。リリース12cでは、デバイス設定はWebCenter Portalアプリケーション・レベルでのみ構成でき、個別のポータルではできません。リリース12.2.1にアップグレードする際に、デバイス設定に対するポータル・レベルのカスタマイズは失われます。アップグレード後のWebCenter Portalインスタンスにはアプリケーション・レベルのデバイス設定のみが適用されます。
リリース11gでは、親ポータルとそのサブポータルで構成されるポータル階層をサポートしており、デフォルトでは、サブポータルは親ポータルで定義されたセキュリティを継承します。WebCenter Portalをリリース12cにアップグレードする際、サブポータルは最上位レベルのポータルに移動します。アップグレードの処理中に、そのようにアップグレードされた各ポータルには、次の2つの属性が追加されます。
11g.upgraded.portal.parent.guid
- 親ポータルのIDを指定します。
11g.upgraded.portal.parent.security.id
- セキュリティを継承した元のポータルを指定します(存在する場合)。値がnullである場合は、サブポータルが親ポータルからセキュリティを継承しておらず、サブポータルが独自のセキュリティを管理していることを示します。
12cでは、Webクリッピング・ポートレットとリッチ・テキスト・ポートレットは非推奨になりました。アップグレード後のポータル・ページに非推奨のポートレットが含まれている場合、ページにはリモート・ポートレット・エラーが表示されます。ページから非推奨のポートレットを削除するか、12cの同等のものに置き換える必要があります。
12cでは、以前のリリースのWebCenter Portalで利用されていたWebクリッピング・ポートレットの機能が、ページレット・プロデューサに置き換わりました。リッチ・テキスト・ポートレットの機能は、コンテンツ寄与と公開コンポーネントに置き換わりました。
このトピックでは、WebCenter Portalの最新リリースへのアップグレードで発生する可能性がある問題の解決策について説明します。
ACTIVITIES
スキーマの余分なエントリが表示される問題
アップグレード後のWebCenter Portal 12.2.1インスタンスで、ACTIVITIES
スキーマに余分なエントリが表示されます。
解決策
リリース12.2.1では、アクティビティ・グラフが非推奨になりました。11g
リリースからアップグレードする際に、既存のアクティビティ・グラフのエントリが削除されません。ただし、Oracle WebCenter Portal 12.2.1のフレッシュ・インスタンスをインストールした場合、これらのエントリはACTIVITIES
スキーマに表示されません。
アップグレード後のWebCenter Portalインスタンスにおいて、アップグレード後のポータルにコンテンツ寄与をサポートするページが含まれており、以前のリリースで作成されたカスタム・ページ・テンプレートを使用している場合は、フローティング・ツールバーを使用できません。フローティング・ツールバーを有効化するには、カスタム・ページ・テンプレートに追加します。詳細は、『Oracle JDeveloperによるWebCenter Portalアセットとカスタム・コンポーネントの開発』のページ・テンプレートへのフローティング・ツールバーの追加に関する項を参照してください。
WebCenter Portalには、必要な構成をポートレット・プロデューサ・アプリケーションのEARファイルに追加し、WSRP上でポートレットを公開する事前デプロイ・ツールがあります。11gバージョンからポートレットEARでプレデプロイメント・ツールを直接実行することはできません。Oracle JDeveloperでポートレット・プロデューサ・アプリケーションを移行し、EARを再生成してからプレデプロイメント・ツールを実行する必要があります。ポートレット・プロデューサの移行の詳細は、「11gのポートレット・プロデューサのアップグレード」を参照してください。プレデプロイメント・ツールの実行の詳細は、『Oracle WebCenter Portalの管理』のポートレット・プロデューサの管理に関する項を参照してください。
Oracle WebCenter Portalのアップグレード中に、エラー・メッセージが表示される場合があります。upgradeWebCenterPortal
WLSTコマンドの実行時に表示されるエラー・メッセージの一部を次に示します。
エラー・メッセージ1
アップグレードの終了時に次のいずれかのメッセージが表示されます。
- Migration of Content Server from Folders_g to FrameworkFolders failed, Check MigrationDiagnostic.log for further details. - An error occurred during migration, Check MigrationDiagnostic.log for further details.
エラー・メッセージ2
アップグレードの終了時に次のメッセージが表示されます。
- Export of Folders_g data failed. - Updating Content Server general configuration failed. - Migration of <folder name> folder and content from Folders_g to the FrameworkFolders data structure failed. - Migration of WebCenter Portal data to FrameworkFolders failed. - Enabling <component name> server components failed. - Disabling <component name> server components failed. - Migration to FrameworkFolders failed.
エラー・メッセージ3
アップグレードの終了時に次のメッセージが表示されます。
- WebCenter Content Server foldering service is not supported. Supported foldering service is FrameworkFolders version 2.1 and above.
解決策
問題を修正するには、次の手順を実行する必要があります。
WebCenter Content Serverをリストアします。
『Oracle WebCenter Portalの管理』のFrameworkFoldersへのFolders_gの移行に関する項の説明に従って、Folders_gからFrameworkFoldersに手動で移行します。
次のコマンドを実行します。
upgradeWebCenterPortal(appName='webcenter', server='WC_Spaces', migrationDirectory='/tmp/upgrade',contentServerName='UCM_server1')
コマンドの詳細は、『WebCenter WLSTコマンド・リファレンス』のupgradeWebCenterPortalに関する項を参照してください。
アップグレード後に、アップグレード後のポータルのドキュメント、ブログ、またはWikiページにアクセスしてエラーが発生する場合は、次の手順を実行して、アップグレードが正しく完了したかどうかをContent Serverで確認してください。
host:port/cs
のURL形式を使用して、Content Serverにログインします。
エンタープライズ・ライブラリにナビゲートして、ポータルのフォルダ名を識別します。
次のURL形式にアクセスします。
host:port
/cs/idcplg?IdcService=FLD_INFO&path=/Enterprise Libraries/
portal-folder-name
&IsSoap=1
結果の出力で、fApplicationGUID
を探します。大文字のGUIDが含まれている場合は、Oracleサポートに連絡してください。
Oracle WebCenter Portalのアップグレード中にポータルのアップグレードが失敗する場合は、ログを確認して問題を識別してください。UpgradeDetails.txt
で、NAMESPACE
またはDOCUMENT_DEF
のようなキーワードを検索し、関連する例外スタックを探して詳細を確認します。このトピックでは、ポータルのアップグレード失敗のトラブルシューティングのシナリオについて説明します。
エラー・メッセージ1
UpgradeDetails.txt
でアップグレードが失敗したポータルのDOCUMENT_REF
を検索すると、次のエントリが表示されます。
- java.sql.SQLException: ORA-12899: value too large for column "DEV_WEBCENTER"."WC_PORTAL_ENTITY"."DOCUMENT_REF"
解決策
ポータルのアップグレード失敗の原因の1つとして、space.xml
にロゴやアイコンの属性としてバイナリまたはコード化されたコンテンツが含まれており、これらの属性の値が文字数制限を超えていることが考えられます。両方の属性の値を変更して、バイナリ・コンテンツからロゴとアイコンのファイルのMDSパスに置き換えます。ポータルのアップグレードが成功した後で、必要に応じてポータル・ロゴとアイコンを再度変更できます。
この問題を修正するには:
importMetadata
WLSTコマンドを使用して、ターゲット・ポータルのMDSからspace.xml
をエクスポートします。
たとえば、次のコマンドではMyPortal
という名前のポータルのspaces.xml
が指定した場所にエクスポートされます。
exportMetadata(application='webcenter', server='WC_Spaces', toLocation='/scratch/export', docs='/oracle/webcenter/space/metadata/spaces/MyPortal/space.xml')
exportMetadata
WLSTコマンド構文の詳細は、『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』のexportMetadataに関する項を参照してください。
エクスポートされたspace.xml
ファイルで、Icon
属性とLogo
属性の値を確認します。これらの属性の値がdata:image
で始まっている場合は、属性を次の値に編集してファイルを保存します。
Icon: /oracle/webcenter/siteresources/scopedMD/shared/images/portalnew_icon.png
Logo: /oracle/webcenter/siteresources/scopedMD/shared/images/portalnew_logo.png
importMetadata
WLSTコマンドを使用して、変更済のspace.xml
ファイルをインポートします。
たとえば、次のコマンドではMyPortal
のspaces.xml
が指定した場所からエクスポートされます。
importMetadata(application='webcenter',server='WC_Spaces',fromLocation='/scrat ch/export',docs='/oracle/webcenter/space/metadata/spaces/MyPortal/space.xml')
importMetadata
WLSTコマンドの構文の詳細は、『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』のimportMetadataに関する項を参照してください。
ポータル・フレームワーク・アプリケーションを再度アップグレードします。
ポータルのアップグレードが成功したら、WebCenter Portalにログオンしてポータルにナビゲートし、必要に応じてポータルのロゴとアイコンを変更します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルのルック・アンド・フィール設定の管理に関する項を参照してください。
エラー・メッセージ2
UpgradeDetails.txt
でアップグレードが失敗したポータルのNAMESPACE
を検索すると、次のエントリが表示されます。
java.sql.SQLException: ORA-12899: value too large for column "DEV_WEBCENTER"."WC_PORTAL_ENTITY"."NAMESPACE"
解決策
この問題の原因の1つとして、ポータル・リソースのタイトル属性の値が200文字の制限を超えていることが考えられます。文字数制限を超えないように、値を変更します。
UpgradeDetails.txt
ファイルを確認して、問題の原因となるポータル・リソースを識別します。
たとえば、Page20PageDef.xml
という名前のページ定義ファイルのタイトルが200文字を超えているとします。
exportMetadata
WLSTコマンドを使用して、ポータル・リソースをエクスポートします。
次に示すコードでは、Page20PageDef.xml
ファイルが指定した場所にエクスポートされます。
exportMetadata(application='webcenter', server='WC_Spaces', toLocation='/scratch/export', docs='/pageDefs/oracle/webcenter/page/scopedMD/sfe492158_7b1a_421c_a242_37897a 2529e7/Page20PageDef.xml')
exportMetadata
WLSTコマンド構文の詳細は、『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』のexportMetadataに関する項を参照してください。
エクスポートされたリソースのpage_title
属性とpage_info
属性の値を編集して200文字未満にします。
importMetadata
WLSTコマンドを使用して、ポータル・リソースをインポートします。たとえば、次のコマンドでは更新後のPage20PageDef.xml
を指定した場所からインポートします。
importMetadata(application='webcenter',server='WC_Spaces',fromLocation='/scrat ch/export', docs='/pageDefs/oracle/webcenter/page/scopedMD/sfe492158_7b1a_421ca242_37897a 2529e7/Page20PageDef.xml')
importMetadata
WLSTコマンドの構文の詳細は、『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』のimportMetadataに関する項を参照してください。
ポータル・フレームワーク・アプリケーションを再度アップグレードします。