F FrameworkFoldersへのFolders_gの移行

Oracle WebCenter Content ServerでWebCenter PortalコンテンツをFolders_gフォルダ・サービスからFrameworkFoldersフォルダ・サービスに移行します。

トピック:

• FrameworkFoldersへのFolders_gの移行の理解

• Folders_gおよびFrameworkFoldersのディレクトリ構造の理解

• WebCenter Portalデータの移行

• 移行に関する問題のトラブルシューティング

FrameworkFoldersへのFolders_gの移行の理解

Oracle WebCenter Contentでは、Folders_gおよびFrameworkFoldersという2つのフォルダ・ソリューションが提供されます。Folders_gコンポーネント(「コントリビューション・フォルダ」インタフェースとも呼ばれます)は、Content Serverのコンテンツに対して階層フォルダ・インタフェースを提供します。FrameworkFoldersコンポーネント(「フォルダ」インタフェースとも呼ばれます)は、従来のファイル・システムと同様に、リポジトリ内の一部またはすべてのコンテンツを編成および検索するための階層フォルダ・インタフェースを提供します。ただし、「フォルダ」はスケーラブルな企業ソリューションで、Content Server用のフォルダ・サービスとして「コントリビューション・フォルダ」を置き換えます。

Oracle WebCenter Portalは、コンテンツ・サーバー上のFrameworkFoldersコンポーネントをサポートしています。Folders_gフォルダ・サービスを使用していた以前のリリースからパッチを適用したOracle WebCenter Portalインスタンスの場合、FrameworkFoldersフォルダ・サービスに移行する必要があります。

注意:

FrameworkFoldersは、以前のFolders_gコンポーネントに置き換わるコンポーネントの名前です。以前のフォルダ・インタフェースはコントリビューション・フォルダと呼ばれるようになりました。FrameworkFoldersコンポーネントによりサポートされるインタフェースはFoldersと呼ばれます。

この章では、FrameworkFoldersとFolders_gという用語を使用して移行プロセスを説明します。UIの選択またはコマンドを指す場合を除き、FrameworkFoldersという用語はFoldersと同義で使用され、Folders_gという用語はコントリビューション・フォルダと同義で使用されます。

移行手順の詳細は、『Oracle WebCenter Contentの管理』のFolders_gからFoldersへの移行に関する項を参照してください。

Folders_gおよびFrameworkFoldersのディレクトリ構造の理解

Folders_gおよびFrameworkFoldersの両方において、階層フォルダ・インタフェースが提供されていますが、コンテンツを整理する方法はこれら2つの設定で異なります。この項では、Folders_gおよびFrameworkFoldersでコンテンツを整理するために使用されるディレクトリ構造について説明します。

WebCenter PortalでFolders_gを有効にしてContent Serverリポジトリを使用する場合、ポータルはWebCenter Portalルート・フォルダの下に格納されます。各ユーザーには、パス/PersonalSpacesの下に格納されている個人フォルダ(ホーム・ポータル)が割り当てられていますが、このフォルダにはユーザーに関連した名前が付けられます。WebCenter PortalがFrameworkFoldersを使用するように構成されている場合、ポータル・フォルダと個人フォルダはすべてエンタープライズ・ライブラリとして処理され、パス/Enterprise Librariesの下に格納されます。ポータル・フォルダにはポータルに関連した名前が付けられ、個人フォルダには通常ユーザーに関連した名前が付けられます。

たとえば、次のポータルとユーザーを持つ企業について考えてみます。

• HR Portal: HRポリシーとドキュメントが格納されています

• Partner Portal: パートナに関連するドキュメントが格納されています

• ユーザー: Karen、MontyおよびSam

図F-1は、Content ServerのFolders_gおよびFrameworkFolders設定で、WebCenter Portalフォルダが整理される方法を示しています。Folders_g設定の場合、ユーザーKaren、MontyおよびSamの個人フォルダは、PersonalSpacesの下に整理され、ポータルHR PortalとPartner Portalは、WebCenter Portalルート・フォルダWebCenter0202の下に整理されています。FrameworkFolders設定の場合、個人フォルダKaren、MontyおよびSamとポータル・フォルダHR PortalおよびPartner Portalは、Enterprise Librariesの下に整理されてます。

図F-1 Content ServerのFolders_gおよびFrameworkFoldersのフォルダ構造

「図F-1 Content ServerのFolders_gおよびFrameworkFoldersのフォルダ構造」の説明

たとえば、KarenがFolders_g設定でホーム・ポータルに新しいフォルダを作成した場合、この新しいフォルダは、図F-2に示すように、/PersonalSpaces/Karenの下に作成されます。

図F-2 Folders_gが有効な場合のフォルダ・パス

「図F-2 Folders_gが有効な場合のフォルダ・パス」の説明

KarenがFrameworkFolders設定でホーム・ポータルに新しいフォルダを作成した場合、この新しいフォルダは、図F-3に示すように、/Enterprise Libraries/Karenの下に作成されます。

図F-3 FrameworkFoldersが有効な場合のフォルダ・パス

「図F-3 FrameworkFoldersが有効な場合のフォルダ・パス」の説明

Folders_gおよびFrameworkFoldersのアイテム・レベルのセキュリティ

Folders_g設定では、ファイルおよびフォルダにアイテム・レベル・セキュリティ(ILS)を設定できます。ファイルに独自のILSが定義されている場合を除き、フォルダのILS設定はファイル内のすべてのファイルに継承されます。FrameworkFolders設定では、ILSはファイルにのみ設定できます。ILSはフォルダには設定できません。

Folders_gからFrameworkFoldersに移行後は、フォルダにILSを設定することはできませんが、そのフォルダに含まれる各ファイルのILS設定は保持されます。移行後、ファイルレベルのILS設定を更新または削除できます。

WebCenter Portalデータの移行

ここでは、WebCenter PortalコンテンツをFolders_gからFrameworkFoldersに移行する手順について説明します。

この項では、次の内容について説明します。

• 移行ロードマップ

• exportFoldersGDataの実行による移行前データの生成

• FrameworkFoldersへのWebCenter Portalメタデータの移行

• migrateFoldersGDataToFrameworkFoldersの実行による移行したデータの検証

移行ロードマップ

この項のフロー・チャート(図F-4)と表(表F-1)で、WebCenter PortalコンテンツのFolders_gからFrameworkFoldersへの移行に必要な手順について概説します。

注意:

クラスタ環境では、1つのWebCenter Portal管理対象サーバーと1つのWebCenter Content管理対象サーバー以外のすべての管理対象サーバーを停止する必要があります。移行WLSTコマンドは、必ずWebCenter Portalが実行されているマシンから実行するようにしてください。

非クラスタ環境では、WebCenter PortalおよびWebCenter Content管理対象サーバーが別々のマシンで実行されている場合、移行WLSTコマンドはWebCenter Portalが実行されているマシンから実行してください。

図F-4 WebCenter PortalデータのFolders_gからFrameworkFoldersへの移行

「図F-4 WebCenter PortalデータのFolders_gからFrameworkFoldersへの移行」の説明

表F-1 WebCenter PortalデータのFolders_gからFrameworkFoldersへの移行

タスク	説明	ドキュメント
WLSTコマンドexportFoldersGDataの実行	WLSTコマンドexportFoldersGDataをWebCenter Portal Oracleホーム・ディレクトリから実行して、移行前データを生成します。	exportFoldersGDataの実行による移行前データの生成。
WebCenter PortalのFolders_gメタデータのFrameworkFoldersへの移行	Content Serverで移行ユーティリティを実行して、WebCenter PortalデータをFolders_gからFrameworkFoldersに移行します。	FrameworkFoldersへのWebCenter Portalメタデータの移行。
WLSTコマンドmigrateFoldersGDataToFrameworkFoldersの実行	WLSTコマンドmigrateFoldersGDataToFrameworkFoldersをWebCenter Portal Oracleホーム・ディレクトリから実行して、移行したデータを検証します。	migrateFoldersGDataToFrameworkFoldersの実行による移行したデータの検証。
すべての管理対象サーバーの再起動	WebCenter PortalおよびContent Server管理対象サーバーを含むすべての管理対象サーバーを再起動します。	『Oracle Fusion Middlewareの管理』のOracle WebLogic Serverインスタンスの起動および停止に関する項を参照してください。

exportFoldersGDataの実行による移行前データの生成

WLSTコマンドexportFoldersGDataを使用して、Folders_gの移行前データを生成します。

exportFoldersGData(appName,server,[connectionName,directoryPath,applicationVersion])

次の例では、WC_Spaces管理対象サーバーにデプロイされたWebCenter PortalアプリケーションのFolders_gデータをエクスポートします。MyContentServerConnectionというContent Server接続が使用され、Folders_gデータが/scratch/myTemp_Dirディレクトリにエクスポートされます。

exportFoldersGData(appName='webcenter',server='WC_Spaces',connectionName='MyContentServerConnection',directoryPath='/scratch/myTemp_Dir/')

コマンドの構文と例は、『WebCenter WLSTコマンド・リファレンス』のexportFoldersGDataに関する項を参照してください。このコマンドは、WebCenter Portal Oracleホーム・ディレクトリから実行する必要があります。WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

WebCenter PortalデータをFrameworkFoldersに移行した後、exportFoldersGDataで生成された移行前データを使用してデータ整合性レポートを生成し、移行したファイルおよびフォルダのサニティを確認できます。

WLSTコマンドexportFoldersGDataにより、次のタスクが実行されます。

• WebCenter Portalルート・フォルダの下にあるすべてのポータル・フォルダの移行前メタデータを生成します

• ホーム・ポータル・ルート・フォルダの下にあるすべてのユーザー・フォルダの移行前メタデータを生成します

• 生成されたメタデータをPreMigrationData.csvファイルに書き込みます。

• すべてのMDSドキュメントがエクスポートされます

PreMigrationData.csvファイルには、Folders_gデータ構造に格納されているポータル・フォルダおよびユーザー・フォルダの次のメタデータが含まれます。

• WebCenter Portalルート・フォルダまたはホーム・ポータル・ルート・フォルダのフォルダ名

• dCollectionGUID。Content Server上の該当するフォルダへのポータルのマップのためにWebCenter Portalによって使用される識別子

• dCollectionID。フォルダを一意に識別するためにFolders_gで使用される識別子

• dCollectionName。フォルダ名

• dSecurityGroup。セキュリティ・グループ

• dDocAccount。アカウント名

デフォルトでは、PreMigrationData.csvは次のパスに格納されます: WCP_ORACLE_HOME/common/wlst/FG_FF_MIGRATION。WLSTコマンドexportFoldersGDataの実行中に、ファイルに別の場所を選択できます。

図F-5 に、PreMigrationData.csvファイルのサンプルを示します。各行には、ポータル・フォルダまたはユーザー・フォルダのメタデータが表示されます。

図F-5 PreMigrationData.csvファイルのサンプル

「図F-5 PreMigrationData.csvファイルのサンプル」の説明

FrameworkFoldersへのWebCenter Portalメタデータの移行

Content Serverにあるフォルダ移行ユーティリティを使用して、WebCenter Portalメタデータおよびフォルダ構造をFolders_gからFrameworkFoldersに移行します。

WebCenter PortalメタデータをFolders_gからFrameworkFoldersに移行するには:

1. 管理者としてContent Serverにログオンします。

2. FrameworkFoldersを有効にします。Folders_gも有効化されていることを確認します。詳細は、「必須コンポーネントの有効化」を参照してください。

   注意:

   Folders_gからFrameworkFolders設定に移行する際は、移行プロセスでFolders_gコンポーネントとFrameworkFoldersコンポーネントの両方を有効にする必要があります。

3. 必要な属性を追加します。

   1. コンテンツ・サーバーにログオンします。

   2. 「管理」→「管理サーバー」→「一般構成」に移動します。

   3. 「追加の構成変数」ボックスに、次のエントリを追加します。

      MigrationFormatForfApplicationGUID=dCollectionName:dCollectionGUID

      DisableQueryTimeoutSupport=true

   4. 「保存」をクリックします。

4. Content Serverを再起動して、管理者としてログオンします。

5. 「管理」、「フォルダ移行」の順に選択して、データ移行の実行を開始します。

6. PersonalSpacesルート・フォルダを移行します。

   1. 「フォルダ移行」ページの「移行の実行」セクションで、「除外されたフォルダの変更」をクリックします。

   2. 「フォルダ移行: 除外されたフォルダ」ダイアログで、移行から除外すべきフォルダを指定します。PersonalSpacesルート・フォルダ以外のすべてのフォルダが「移行から除外されるレガシー・フォルダ」ボックスに表示されていることを確認します。図F-6で、WebcenterSpaces-RootはWebCenter Portalルート・フォルダを指しています。

      図F-6 移行から除外されるフォルダの指定

      
      「図F-6 移行から除外されるフォルダの指定」の説明

   3. 「OK」をクリックします。

   4. 「Migrate Folder Data」をクリックしてデータを移行します。

7. WebCenter Portalルート・フォルダを移行します。

   1. 「移行の実行」セクションで「除外されたフォルダの変更」をクリックします。

   2. 「フォルダ移行: 除外されたフォルダ」ダイアログで、WebCenter Portalルート・フォルダ以外のすべてのフォルダが「移行から除外されるレガシー・フォルダ」ボックスに表示されていることを確認します。図F-7で、WebcenterSpaces-RootはWebCenter Portalルート・フォルダを指しています。

      図F-7 移行から除外されるフォルダの指定

      
      「図F-7 移行から除外されるフォルダの指定」の説明

   3. 「OK」をクリックします。

   4. 「Migrate Folder Data」をクリックしてデータを移行します。

8. 手順3で追加したMigrationFormatForfApplicationGUID属性を削除します。

9. Content Serverを再起動します。

10. コントリビューション・フォルダにWebCenter Portalで参照されるコンテンツが含まれている場合は、「コントリビューション・フォルダ」フォルダをエンタープライズ・ライブラリとして移行する必要があります。

    1. 「移行の実行」セクションで「除外されたフォルダの変更」をクリックします。

    2. 「フォルダ移行: 除外されたフォルダ」ダイアログで、「コントリビューション・フォルダ」以外のすべてのフォルダが「移行から除外されるレガシー・フォルダ」ボックスに表示されていることを確認します(図F-8)。

       図F-8 移行から除外されるフォルダの指定

       
       「図F-8 移行から除外されるフォルダの指定」の説明

    3. 「OK」をクリックします。

    4. 「フォルダ移行先」セクションで「参照」をクリックして、フォルダの移行先を指定します。

    5. 「参照」ダイアログで「Enterprise Libraries」を選択し、「OK」をクリックします。

    6. 「フォルダ・データの移行」をクリックします。

11. PersonalSpaces、WebCenter Portalルート・フォルダおよびコントリビューション・フォルダにWebCenter Portalで参照されているコンテンツがある場合、これら以外のフォルダを移行します。手順10で使用したのと同じ手順に従います。

    「フォルダ移行: 除外されたフォルダ」ダイアログで、移行する以外のすべてのフォルダが「移行から除外されるレガシー・フォルダ」ボックスに表示されていることを確認します。

12. Folders_gを無効にします。

    「拡張コンポーネント・マネージャ」ページの「有効コンポーネント」リスト・ボックスで、Folders_gを選択し、「無効化」をクリックします。

13. Content Serverを再起動します。

14. リポジトリ・マネージャ・ユーティリティを使用して、コレクションを再構築し、検索索引を更新します。コレクションを再構築する際は、「インデクサの再構築」ダイアログで「高速再構築の使用」チェック・ボックスが選択解除されていることを確認します(図F-9)。詳細は、『Oracle WebCenter Contentの管理』の検索索引の操作に関する項を参照してください。

    図F-9 索引の再構築

    
    「図F-9 索引の再構築」の説明

移行プロセス中に生成されるログは、WCC_DOMAIN/servers/UCM_server1/logsに保存されます(WCC_DOMAINはOracle WebCenter Contentドメインを示しています)。

migrateFoldersGDataToFrameworkFoldersの実行による移行したデータの検証

WLSTコマンドmigrateFoldersGDataToFrameworkFoldersを使用してFolders_gデータをFrameworkFoldersに移行し、移行したデータの整合性を確認します。

migrateFoldersGDataToFrameworkFolders(appName,server,contentDbConnectionUrl,contentDbUserName,[connectionName,directoryPath,reportMode,applicationVersion])

次の例では、Folders_gデータを/scratch/myTemp_DirディレクトリからFrameworkFoldersに移行し、WC_Portal管理対象サーバーにデプロイされたWebCenter Portalアプリケーションの移行済データを検証します。MyContentServerConnectionという名前のContent Server接続と指定したWebCenter Contentデータベース接続およびユーザー名を使用して、移行が実行されます。

migrateFoldersGDataToFrameworkFolders(appName='webcenter',server='WC_Portal',contentDbConnectionUrl='wccdbhost.example.com:wccdbport:wccdbsid', contentDbUserName='SCHEMA_PREFIX_OCS',connectionName='MyContentServerConnection',directoryPath='/scratch/myTemp_Dir/)

directoryPath属性で指定されるパスは、exportFoldersGData WLSTコマンドの実行中に指定したパスと同じである必要があります。

コマンドの構文と例は、『WebCenter WLSTコマンド・リファレンス』のexportFoldersGDataに関する項を参照してください。WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

migrateFoldersGDataToFrameworkFoldersコマンドにより、次のタスクが実行されます。

• 移行したWebCenter Portalコンテンツのメタデータが生成され、WLSTコマンドexportFoldersGDataで生成された移行前メタデータに対して検証されます。移行した各フォルダがエンタープライズ・ライブラリであること、およびアカウント名とセキュリティ・グループの値が移行前メタデータと同じであることが検証されます。

  データの不整合があった場合は、コマンド実行後に表示されるサマリー・テキストでレポートされ、次のデフォルトの場所にあるログ・ファイルにも保存されます: WCP_ORACLE_HOME/common/wlst/POST_MIGRATION/MigrationDiagnostic.log。

• Folders_g識別子dCollectionIDをFrameworkFolders識別子fFolderGUIDにマップするマッピング・ファイルMigrationMap.csvが作成されます。マッピング・ファイルはMigration_Directory/POST_MIgration/MigrationMap.csvに保存されます。

  フォルダ名が変更された場合のために、ファイルにはFolders_gパスとFrameworkFoldersパスのマッピングも含まれます。たとえば、Montyという名前のユーザー・フォルダがあり、同じ名前のポータル・フォルダもあるとします。Folders_g設定で、ユーザー・フォルダMontyはPersonalSpacesルート・フォルダの下に表示され、ポータル・フォルダMontyはWebCenter Portalルート・フォルダの下に表示されます(WebCenter0202など)。移行時、PersonalSpacesフォルダが最初に移行されます。フォルダ名の競合を解決するために、ポータル・フォルダの名前はMonty(WebCenter0202)に変更されます(図F-10を参照)。このフォルダ・パスの変更は、マッピング・ファイルに保存されます。

  図F-10 移行後のFrameworkFoldersのディレクトリ構造

  
  「図F-10 移行後のFrameworkFoldersのディレクトリ構造」の説明

• マッピング・ファイルを使用し、WLSTコマンドexportFoldersGDataで生成されたMDSドキュメントで、dCollectionID値をfFolderGUID値に置き換えます。また、WebCenter Portalルート・フォルダ名またはPersonalSpacesを含む古いパス参照が新しいパスに置き換えられます。たとえば、/PersonalSpaces/weblogicが/Enterprise Libraries/weblogicに置き換えられます。

  不整合があった場合は、MigrationDiagnostic.logでレポートされます。トラブルシューティング情報は、「移行に関する問題のトラブルシューティング」を参照してください。

• 更新されたすべてのMDSドキュメントをインポートします。

移行に関する問題のトラブルシューティング

この項では、Folders_g設定をFrameworkFolders設定に移行する際に発生する可能性のある問題のトラブルシューティングに役立つ情報を提供します。

問題

WLSTコマンドmigrateFoldersGToFrameworkFoldersに表示される移行サマリーに、いくつかのMDSドキュメントに既知のパターンに準拠しないFolders_gパス参照が含まれるという警告が示されます。

解決策

WCP_ORACLE_HOME/common/wlst/POST_MIGRATIONディレクトリにあるMigrationDiagnostic.logファイルを手動で確認して、警告メッセージを探します。指定したファイルについて、Content Serverパス参照が有効かどうかを確認します。必要に応じて、Folders_gパスをFrameworkFoldersパスに手動で更新して、ファイルをインポートします。

問題

WebCenter Portalのプライマリ以外のContent Server接続に対してWLSTコマンドexportFoldersGDataを実行すると、MigrationDiagnostic.logファイルで次の例外がレポートされます:

oracle.stellent.ridc.protocol.ServiceException: Unable to open folder. 

解決策

複数のContent Server接続が登録されている場合、プライマリ以外のContent Server接続を使用してWLSTコマンドexportFoldersGDataを実行するには、アクティブ接続として設定し、ルート・フォルダとアプリケーション名の値を指定します。exportFoldersGDataの実行後、アクティブ接続から以前のContent Server接続に設定しなおして、移行を続行します。

問題

WebCenter Portalアプリケーションに、Folders_gサービスベースの様々な問合せを使用するカスタム・コードが含まれます。FrameworkFoldersへの移行後、問合せを使用できません。

解決策

Folders_gサービスは、FrameworkFoldersに移行したWebCenter Portalでは使用できません。アプリケーションにFolders_gサービスが含まれる場合、移行後、それらを同等のFrameworkFoldersサービスに置き換える必要があります。表F-2に、Folders_gサービスと対応するFrameworkFoldersサービスのマッピングを示します。

FrameworkFoldersサービスの詳細は、『Oracle WebCenter Contentサービス・リファレンス』のフォルダ・サービスに関する項を参照してください。

表F-2 Folders_gサービスとFrameworkFoldersサービスのマッピング

Folders_gサービス	FrameworkFoldersサービス
COLLECTION_ADD	FLD_CREATE_FOLDER
COLLECTION_BROWSE	FLD_INFO
COLLECTION_COPY_COLLECTION	FLD_COPY (item1がフォルダとして指定された)
COLLECTION_COPY_ITEM	FLD_COPY (item1がファイルとして指定された)
COLLECTION_COPY_LOT	FLD_COPY (itemsが指定された)
COLLECTION_DELETE	FLD_DELETE
COLLECTION_DELETE_COLLECTION	FLD_DELETE (item1がフォルダとして指定された)
COLLECTION_DELETE_ITEM	FLD_DELETE (item1がファイルとして指定された)
COLLECTION_DELETE_LOT	FLD_DELETE (itemsが指定された)
COLLECTION_DISPLAY	FLD_BROWSE
COLLECTION_GET_COLLECTIONS	FLD_RETRIEVE_CHILD_FOLDERS
COLLECTION_GET_CONTENTS	FLD_RETRIEVE_CHILD_FILES
COLLECTION_GET_LINKS	FLD_INFO (item1がショートカットとして指定された)
COLLECTION_GET_REFERENCE	FLD_INFO (pathが指定された、またはitem1がパスとして指定された)
COLLECTION_INFO	FLD_INFO
COLLECTION_MOVE_ALL	FLD_MOVE (itemsが指定された)
COLLECTION_MOVE_COLLECTION	FLD_MOVE (item1がフォルダとして指定された)
COLLECTION_MOVE_ITEM	FLD_MOVE (item1がファイルとして指定された)
COLLECTION_MOVE_LOT	FLD_MOVE (itemsが指定された)
COLLECTION_SEARCH_RESULTS	FLD_FOLDER_SEARCH
COLLECTION_UPDATE	FLD_EDIT_FOLDER