Oracle® Fusion Middleware

Oracle WebCenter Portalの管理

11gリリース1(11.1.1.9.0)

E51441-06(原本部品番号:E27738-10)

2016年7月

Oracle WebCenter Portalの管理方法を説明します。システム管理者は、ポータルのデプロイ方法、バックエンド・サービスの構成方法、パフォーマンスのモニター方法、バックアップとリカバリの戦略の実装方法について学べます。

Oracle Fusion Middleware Oracle WebCenter Portalの管理, 11gリリース1 (11.1.1.9.0)

E51441-06

Copyright © 2007, 2016, Oracle and/or its affiliates. All rights reserved.

原本協力者: Savita Thakur、Ingrid Snedecor

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracleおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXはThe Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

新機能

- システム要件と仕様

- 11g リリース1 (11.1.1.9.0)の新機能と変更機能

- 11gリリース1 (11.1.1.8.3)の新機能と変更された機能

- 11gリリース1 (11.1.1.8.0)の新機能と変更された機能

登場人物リスト

- ナレッジ・ワーカー

- アプリケーション・スペシャリスト

- Web開発者

- 開発者

- システム管理者

第I部 Oracle WebCenter Portalの概要

1 Oracle WebCenter Portalの管理の概要

- 1.1 Oracle WebCenter Portalの概要

- 1.2 Oracle WebCenter Portalのアーキテクチャ

- 1.2.1 WebCenter Portal Framework

- 1.2.2 Application Development Framework

- 1.2.3 コンポーザ

- 1.2.4 WebCenter Portal

- 1.2.5 ツールとサービス

- 1.2.6 ディスカッション・サーバー

- 1.2.7 分析

- 1.2.8 アクティビティ・グラフ

- 1.2.9 パーソナライズ・サーバー

- 1.2.10 ポータル

- 1.2.11 コンポジット・アプリケーション

- 1.3 Oracle WebCenter Portalのトポロジ

- 1.3.1 初期設定のOracle WebCenter Portalトポロジ

- 1.3.2 Oracle WebCenter Portal管理対象サーバー

- 1.3.3 Oracle WebCenter Portalの起動順序

- 1.3.4 Oracle WebCenter Portalの依存性

- 1.3.5 Oracle WebCenter Portalの構成に関する考慮事項

- 1.3.6 Oracle WebCenter Portalの状態および構成の永続性

- 1.3.7 Oracle WebCenter Portalのログ・ファイルの場所

- 1.4 WebCenter Portal

- 1.5 Portal Frameworkアプリケーション

- 1.6 Oracle WebCenter Portalのインストールの計画

- 1.7 Oracle WebCenter Portal 11gのインストールの理解

- 1.8 管理操作、ロールおよびツールの理解

- 1.9 パフォーマンスのモニタリングおよび診断

- 1.10 セキュリティの理解

- 1.11 WebCenter Portalアプリケーションのデプロイ

- 1.12 データの移行、バックアップおよびリカバリ

- 1.13 Oracle WebCenter Portalの管理ツール

- 1.13.1 Oracle Enterprise Manager Fusion Middleware Controlコンソール

- 1.13.2 Oracle WebLogic Server管理コンソール

- 1.13.3 Oracle WebLogic Scripting Tool(WLST)

- 1.13.4 システムMBeanブラウザ

- 1.13.5 WebCenter Portal: ポータル・ビルダーの管理ページ

- 1.13.6 Portal Frameworkアプリケーション: 管理コンソール

第II部 WebCenter Portalの管理のスタート・ガイド

2 WebCenter Portalの起動および実行

- 2.1 システム管理者のロール

- 2.2 WebCenter Portalのインストール

- 2.3 WebCenter Portalの初回の設定(ロードマップ)

- 2.4 WebCenter Portalの初回のカスタマイズ(ロードマップ)

3 WebCenter Portalのメンテナンス

- 3.1 システム管理者のロール

- 3.2 WebCenter Portalのためのシステム管理(ロードマップ)

- 3.3 ポータル・ビルダーのためのシステム管理(ロードマップ)

第III部 Portal Frameworkアプリケーションの管理のスタート・ガイド

4 Portal Frameworkアプリケーションの起動および実行

- 4.1 Oracle WebCenter PortalおよびWebCenter Portal Frameworkライブラリのインストール

- 4.2 Portal Frameworkアプリケーションの初回のデプロイ(ロードマップ)

5 Portal Frameworkアプリケーションのメンテナンス

- 5.1 Portal Frameworkアプリケーションのためのシステム管理(ロードマップ)

第IV部 基本的なシステム管理

6 Enterprise Manager Fusion Middleware Controlの起動

- 6.1 Fusion Middleware Controlコンソールの表示

- 6.2 WebCenter Portalのホームページへの移動

- 6.3 Portal Frameworkアプリケーションのホームページへの移動

- 6.4 依存コンポーネントへの移動

7 Oracle WebCenter Portalの管理対象サーバーとアプリケーションの起動および停止

- 7.1 ノード・マネージャの起動

- 7.2 WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止

- 7.3 WebCenter Portalアプリケーションの起動および停止

- 7.3.1 Fusion Middleware Controlを使用したWebCenter Portalの起動

- 7.3.2 WLSTを使用したWebCenter Portalの起動

- 7.3.3 Fusion Middleware Controlを使用したWebCenter Portalの停止

- 7.3.4 WLSTを使用したWebCenter Portalの停止

- 7.4 Portal Frameworkアプリケーションの起動および停止

- 7.4.1 Fusion Middleware Controlを使用したPortal Frameworkアプリケーションの起動

- 7.4.2 WLSTを使用したPortal Frameworkアプリケーションの起動

- 7.4.3 Fusion Middleware Controlを使用したPortal Frameworkアプリケーションの停止

- 7.4.4 WLSTを使用したPortal Frameworkアプリケーションの停止

第V部 ツール、ポートレット・プロデューサおよび外部アプリケーションの管理

8 ツールおよびサービスの管理

- 8.1 ツールおよびサービスの管理の概要

- 8.2 ツールおよびサービスのバックエンド・データ・リポジトリの構成

- 8.2.1 MDSリポジトリの設定

- 8.2.2 データベース接続の設定

- 8.2.3 バックエンド・サーバー接続の設定

- 8.2.4 プロキシ・サーバーの設定

- 8.2.5 外部アプリケーション接続の設定

- 8.2.6 コンポーザ固有の構成の設定

- 8.3 WebCenter Portalのツールおよびサービスについて

- 8.3.1 WebCenter Portalでのツールおよびサービスの有効化と無効化

- 8.3.2 WebCenter Portalのツールおよびサービスの構成

- 8.4 Portal Frameworkアプリケーションのツールおよびサービスについて

9 コンテンツ・リポジトリの管理

- 9.1 コンテンツ・リポジトリについて

- 9.2 Oracle WebCenter Content Serverリポジトリの構成

- 9.2.1 Content Serverを構成するための前提条件

- 9.2.2 Content Serverの構成ロードマップ

- 9.2.3 Content Serverの構成

- 9.3 Microsoft SharePointリポジトリの構成

- 9.3.1 Microsoft SharePoint: インストール

- 9.3.2 Microsoft SharePoint: 構成

- 9.3.3 Microsoft SharePoint: セキュリティに関する考慮事項

- 9.3.4 Microsoft SharePoint: WebCenter Portalでの制限事項

- 9.3.5 WLSTを使用したMicrosoft SharePoint接続の管理

- 9.4 Oracle Portalリポジトリの構成

- 9.4.1 Oracle Portal: インストール

- 9.4.2 Oracle Portal: 構成

- 9.4.3 Oracle Portal: セキュリティに関する考慮事項

- 9.4.4 Oracle Portal: Oracle WebCenter Portalでの制限事項

- 9.5 ファイル・システム・リポジトリの構成

- 9.5.1 ファイル・システム: セキュリティに関する考慮事項

- 9.5.2 ファイル・システム: 制限事項

- 9.6 WebCenter PortalまたはPortal Frameworkアプリケーション用のコンテンツ・リポジトリの登録

- 9.6.1 WebCenter Portal用のコンテンツ・リポジトリの登録について

- 9.6.2 Fusion Middleware Controlを使用したコンテンツ・リポジトリの登録

- 9.6.3 WLSTを使用したコンテンツ・リポジトリの登録

- 9.7 アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更

- 9.7.1 Fusion Middleware Controlを使用したアクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更

- 9.7.2 WLSTを使用したアクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更

- 9.8 コンテンツ・リポジトリ接続の詳細の変更

- 9.8.1 Fusion Middleware Controlを使用したコンテンツ・リポジトリ接続の詳細の変更

- 9.8.2 WLSTを使用したコンテンツ・リポジトリ接続の詳細の変更

- 9.8.3 コンテンツ・プレゼンタのキャッシュ設定の変更

- 9.8.4 外部Content Serverの変更を確認するためのキャッシュの構成

- 9.9 コンテンツ・リポジトリ接続の削除

- 9.9.1 Fusion Middleware Controlを使用したコンテンツ・リポジトリ接続の削除

- 9.9.2 WLSTを使用したコンテンツ・リポジトリ接続の削除

- 9.10 WebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定

- 9.10.1 Fusion Middleware Controlを使用したWebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定

- 9.10.2 WLSTを使用したWebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定

- 9.11 コンテンツ・リポジトリ接続のテスト

- 9.11.1 Content Server接続のテスト

- 9.11.2 Oracle Portal接続のテスト

- 9.12 最大ファイル・アップロード・サイズの変更

- 9.13 コンテンツ・リポジトリに関する問題のトラブルシューティング

- 9.13.1 WebCenter Portalで使用できないドキュメント・サービス

10 アクティビティ・グラフの管理

- 10.1 アクティビティ・グラフについて

- 10.2 アクティビティ・グラフの構成ロードマップ

- 10.3 アクティビティ・グラフの前提条件

- 10.4 アクティビティ・グラフのデータの準備

- 10.4.1 アクティビティ・グラフ・エンジンのスケジュール実行

- 10.4.2 アクティビティ・グラフ・エンジンのオンデマンド実行

- 10.5 類似度計算の理由文字列のカスタマイズ

- 10.6 アクティビティ・グラフ・スキーマのカスタマイズの管理

- 10.6.1 アクティビティ・グラフ・メタデータのエクスポート

- 10.6.2 プロバイダ構成のエクスポート

- 10.6.3 アクティビティ・グラフ・メタデータのインポート

- 10.6.4 アクティビティ・グラフ・メタデータの削除

- 10.6.5 アクション名およびノード・クラス名の変更

- 10.7 Oracle Secure Enterprise Searchのアクティビティ・ランクの設定

- 10.8 推奨に関する問題のトラブルシューティング

- 10.8.1 アクティビティ・グラフ・エンジンの「スケジュールとステータス」ページのトラブルシューティング

11 分析の管理

- 11.1 WebCenter Portalの分析について

- 11.1.1 分析のコンポーネント

- 11.1.2 分析タスク・フロー

- 11.2 分析の構成ロードマップ

- 11.3 分析の前提条件

- 11.3.1 分析: インストール

- 11.3.2 分析: 構成

- 11.3.3 分析: セキュリティに関する考慮事項

- 11.3.4 分析: 制限事項

- 11.4 分析コレクタ設定の構成

- 11.4.1 WLSTを使用した分析コレクタ・プロパティの設定

- 11.4.2 Fusion Middleware Controlを使用した分析コレクタ・プロパティの設定

- 11.5 アプリケーション用の分析コレクタの登録

- 11.5.1 Fusion Middleware Controlを使用した分析コレクタの登録

- 11.5.2 WLSTを使用した分析コレクタの登録

- 11.5.3 WebCenter Portalイベント収集の無効化

- 11.6 ユーザー・プロファイル・イベントのタイミングの構成

- 11.7 分析イベント収集の検証

- 11.8 現在のWebCenter Portalの分析イベント・リストの表示

- 11.9 分析データのパージ

- 11.10 分析データのパーティション化

- 11.11 分析に関する問題のトラブルシューティング

12 お知らせおよびディスカッションの管理

- 12.1 ディスカッション・サーバー接続について

- 12.2 ディスカッション・サーバーの前提条件

- 12.2.1 ディスカッション・サーバー: インストール

- 12.2.2 ディスカッション・サーバー: 構成

- 12.2.3 ディスカッション・サーバー: セキュリティに関する考慮事項

- 12.2.4 ディスカッション・サーバー: 制限事項

- 12.3 ディスカッション・サーバーの登録

- 12.3.1 Fusion Middleware Controlを使用したディスカッション・サーバーの登録

- 12.3.2 WLSTを使用したディスカッション・サーバーの登録

- 12.4 ディスカッションおよびお知らせ用のアクティブな接続の選択

- 12.4.1 Fusion Middleware Controlを使用したディスカッションおよびお知らせ用のアクティブな接続の選択

- 12.4.2 WLSTを使用したディスカッションおよびお知らせ用のアクティブなディスカッションの選択

- 12.5 ディスカッション・サーバー接続の詳細の変更

- 12.5.1 Fusion Middleware Controlを使用したディスカッション・サーバー接続の詳細の変更

- 12.5.2 WLSTを使用したディスカッション・サーバー接続の詳細の変更

- 12.6 ディスカッション・サーバー接続の削除

- 12.6.1 Fusion Middleware Controlを使用したディスカッション・サーバー接続の削除

- 12.6.2 WLSTを使用したディスカッション・サーバー接続の削除

- 12.7 ディスカッションのデフォルトの設定

- 12.8 お知らせのデフォルトの設定

- 12.9 ディスカッション・サーバーの管理者権限の付与

- 12.10 ディスカッション・サーバーの管理者ロールの付与

- 12.10.1 WLSTを使用したディスカッション・サーバー管理者ロールの付与

- 12.10.2 管理コンソールを使用したディスカッション・サーバー管理者ロールの付与

- 12.10.3 ディスカッション・サーバー管理者ロールの取消し

- 12.11 WebCenter Portalのディスカッション・フォーラム・オプションの構成

- 12.11.1 ディスカッション・サーバー管理コンソールへのアクセス

- 12.11.2 ディスカッションおよびお知らせを格納するディスカッション・サーバー上の場所の指定

- 12.11.3 ポータル・テンプレートに保存するディスカッション・トピック数の選択

- 12.12 お知らせおよびディスカッションに関する問題のトラブルシューティング

- 12.12.1 認証に失敗した

- 12.12.2 WebCenter Portalでディスカッションを有効化できない

- 12.12.3 ログインに失敗した

- 12.12.4 Oracle Access Managerの構成後にログインが正しく機能しない

- 12.12.5 カテゴリが見つからないという例外

- 12.12.6 監視対象トピックおよび最近のトピックに複数のディスカッション・フォーラムからのトピックが表示されない

- 12.12.7 ディスカッションおよびお知らせの更新内容が表示されない

13 カレンダ・イベントの管理

- 13.1 イベント接続について

- 13.2 個人イベントの構成ロードマップ

- 13.3 イベントの個人イベントに関する前提条件

- 13.3.1 Microsoft Exchange Server 2013に関する前提条件

- 13.3.2 Microsoft Exchange Server 2010に関する前提条件

- 13.3.3 Microsoft Exchange Server 2007に関する前提条件

- 13.3.4 Microsoft Exchange Server 2003に関する前提条件

- 13.4 イベント・サーバーの登録

- 13.4.1 Fusion Middleware Controlを使用したイベント・サーバーの登録

- 13.4.2 WLSTを使用したイベント・サーバーの登録

- 13.5 アクティブなイベント・サーバー接続の選択

- 13.5.1 Fusion Middleware Controlを使用したアクティブなイベント・サーバーの選択

- 13.5.2 WLSTを使用したアクティブなイベント・サーバー接続の選択

- 13.6 イベント・サーバー接続の詳細の変更

- 13.6.1 Fusion Middleware Controlを使用したイベント・サーバー接続の詳細の変更

- 13.6.2 WLSTを使用したイベント・サーバー接続の詳細の変更

- 13.7 イベント・サーバー接続の削除

- 13.7.1 Fusion Middleware Controlを使用したイベント・サーバー接続の削除

- 13.7.2 WLSTを使用したイベント・サーバー接続の削除

- 13.8 イベント・サーバー接続のテスト

- 13.9 イベントに関する問題のトラブルシューティング

14 インスタント・メッセージおよびプレゼンスの管理

- 14.1 インスタント・メッセージおよびプレゼンス接続について

- 14.2 インスタント・メッセージおよびプレゼンス・サーバーの前提条件

- 14.2.1 Microsoft Live Communications Server (LCS)の前提条件

- 14.2.2 Microsoft Office Communications Server (OCS)の前提条件

- 14.2.3 Microsoft Lyncの前提条件

- 14.3 インスタント・メッセージおよびプレゼンス・サーバーの登録

- 14.3.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録

- 14.3.2 WLSTを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録

- 14.4 インスタント・メッセージおよびプレゼンス用のアクティブな接続の選択

- 14.4.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択

- 14.4.2 WLSTを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択

- 14.5 インスタント・メッセージおよびプレゼンス接続の詳細の変更

- 14.5.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス接続の詳細の変更

- 14.5.2 WLSTを使用したインスタント・メッセージおよびプレゼンス接続の詳細の変更

- 14.6 インスタント・メッセージおよびプレゼンス接続の削除

- 14.6.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス接続の削除

- 14.6.2 WLSTを使用したインスタント・メッセージおよびプレゼンス接続の削除

- 14.7 インスタント・メッセージおよびプレゼンスのデフォルトの設定

- 14.8 インスタント・メッセージおよびプレゼンス接続のテスト

15 メールの管理

- 15.1 メール・サーバー接続について

- 15.2 メールの構成ロードマップ

- 15.3 メール・サーバーの前提条件

- 15.3.1 メール・サーバー: インストール

- 15.3.2 メール・サーバー: 構成

- 15.3.3 メール・サーバー: セキュリティに関する考慮事項

- 15.3.4 メール・サーバー: 制限事項

- 15.4 メール・サーバーの登録

- 15.4.1 Fusion Middleware Controlを使用したメール・サーバーの登録

- 15.4.2 WLSTを使用したメール・サーバーの登録

- 15.5 アクティブな(またはデフォルトの)メール・サーバー接続の選択

- 15.5.1 Fusion Middleware Controlを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択

- 15.5.2 WLSTを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択

- 15.6 メール・サーバー接続の詳細の変更

- 15.6.1 Fusion Middleware Controlを使用したメール・サーバー接続の詳細の変更

- 15.6.2 WLSTを使用したメール・サーバー接続の詳細の変更

- 15.7 メール・サーバー接続の削除

- 15.7.1 Fusion Middleware Controlを使用したメール接続の削除

- 15.7.2 WLSTを使用したメール接続の削除

- 15.8 メールのデフォルトの設定

- 15.9 メール・サーバー接続のテスト

- 15.10 WebCenter Portalのメール通知の送信の構成

- 15.10.1 メール通知の送信の共有メール接続の有効化

- 15.11 メールに関する問題のトラブルシューティング

- 15.11.1 セキュア・モードでメールにアクセスできない

- 15.11.2 非セキュア・モードでメールにアクセスできない

- 15.11.3 非セキュア・モードで配信リストを作成できない

- 15.11.4 セキュア・モードで配信リストを作成できない

- 15.11.5 ポータルでメールのプロビジョニングに失敗する(デフォルトの配信リストが作成されない)

- 15.11.6 ダウンロードしたメール・メッセージの件数を構成できない

- 15.11.7 WebCenter Portalメールを公開およびアーカイブできない

- 15.11.8 Microsoft Exchangeでのパスワードの変更

- 15.11.9 メールの内容が添付ファイルとして送信される

16 ピープル・コネクションの管理

- 16.1 ピープル・コネクション・サービスについて

- 16.2 ピープル・コネクションの前提条件

- 16.3 WebCenter Portalのピープル・コネクションの構成

- 16.3.1 ピープル・コネクションの管理設定へのアクセス

- 16.3.2 アクティビティ・ストリームの構成

- 16.3.3 コネクションの構成

- 16.3.4 プロファイルの構成

- 16.3.5 メッセージ・ボードの構成

- 16.3.6 フィードバックの構成

- 16.4 アクティビティ・ストリームのプロキシ・サーバーの設定

- 16.5 アクティビティ・ストリーム・スキーマのアーカイブ

- 16.6 組織ビューの管理チェーンの指定

- 16.7 プロファイルの構成プロパティの設定

- 16.8 プロファイルとアイデンティティ・ストアの同期

- 16.9 プロファイル・サービスのキャッシュ・オプションの構成

- 16.10 ピープル・コネクションに関する問題のトラブルシューティング

17 RSSの管理

- 17.1 RSSについて

- 17.2 RSSの前提条件

- 17.3 外部RSSニュース・フィードのためのプロキシ・サーバーの設定

- 17.4 外部RSSニュース・フィード接続のテスト

18 WebCenter PortalでのOracle Secure Enterprise Searchの管理

- 18.1 Oracle SESを使用した検索について

- 18.2 WebCenter PortalでのOracle SESの構成ロードマップ

- 18.3 Oracle SESを使用するための前提条件

- 18.3.1 Oracle SES: インストール

- 18.3.2 Oracle SES: 構成

- 18.3.3 Oracle SES: セキュリティ

- 18.4 Oracle SES接続の設定

- 18.4.1 Oracle SES接続のテスト

- 18.4.2 Oracle Secure Enterprise Searchサーバーの登録

- 18.4.3 アクティブなOracle SES接続の選択

- 18.4.4 Oracle SES接続の詳細の変更

- 18.4.5 Oracle SES接続の削除

- 18.5 WebCenter Portalアプリケーションを検索するためのOracle SESの構成

- 18.5.1 Oracle SESのためのWebCenter Portalの設定

- 18.5.2 Oracle SESのためのOracle WebCenter Content Serverの設定

- 18.5.3 Oracle SESのためのOracle WebCenter Portalディスカッション・サーバーの設定

- 18.5.4 WebCenter Portalを検索するためのOracle SESの設定

- 18.5.5 WLSTを使用したOracle SESのバージョンの構成

- 18.5.6 WLSTを使用した検索クローラの構成

- 18.5.7 ページ・メタデータのクロールのヒント

- 18.6 Portal Frameworkアプリケーションを検索するためのOracle SESの構成

- 18.6.1 Oracle SESのためのOracle WebCenter Content Serverの設定

- 18.6.2 Oracle SESのためのOracle WebCenter Portalのディスカッション・サーバーの設定

- 18.6.3 WebCenter Portal Frameworkを検索するためのOracle SESの設定

- 18.6.4 Oracle SESのためのWebCenter Portal Frameworkアプリケーションの設定

- 18.7 Oracle SESに関する問題のトラブルシューティング

- 18.7.1 検索結果が見つからない

- 18.7.2 検索失敗のエラー

- 18.7.3 WebCenter Portalにview権限を付与できない

- 18.7.4 ソース・グループまたはソース・タイプによるOracle SESの結果の制限

- 18.7.5 検索結果に保護されたリソースが含まれない

- 18.7.6 検索結果にドキュメントが含まれない

- 18.7.7 検索結果にディスカッションとお知らせが含まれない

- 18.7.8 検索結果に最近追加されたリソースが含まれない

- 18.7.9 検索結果に認可の変更が反映されない

- 18.7.10 検索結果に幅広いユーザーに利用可能なリソースが含まれない

19 サブスクリプションおよび通知の管理

- 19.1 サブスクリプションおよび通知について

- 19.2 デフォルトのサブスクリプション・プリファレンスの設定

- 19.2.1 サブスクリプションのデフォルトについて

- 19.2.2 サブスクリプションのデフォルトの設定

- 19.2.3 WebCenter Portalでのサブスクリプション・プリファレンスの設定

- 19.3 通知の設定

- 19.3.1 接続チャネルについて

- 19.3.2 通知の前提条件

- 19.3.3 通知の構成ロードマップ

- 19.3.4 Fusion Middleware Controlを使用した通知チャネルの指定

- 19.3.5 WLSTを使用した通知チャネルの指定

- 19.3.6 例: WLSTを使用したWebCenter Portalのメール通知の設定

- 19.4 カスタム通知テンプレートの作成および適用

- 19.4.1 デフォルト通知テンプレートの上書きについて

- 19.4.2 デフォルト通知テンプレートの上書き

- 19.5 通知接続のテスト

- 19.6 通知に関する問題のトラブルシューティング

20 ワークリストの管理

- 20.1 ワークリストの構成ロードマップ

- 20.1.1 ロードマップ: WebCenter Portal用のワークリストの構成

- 20.1.2 ロードマップ: Portal Frameworkアプリケーション用のワークリストの構成

- 20.2 BPEL接続について

- 20.3 BPELサーバーの前提条件

- 20.3.1 BPELサーバー: インストールと構成

- 20.3.2 BPELサーバー: セキュリティに関する考慮事項

- 20.3.3 BPELサーバー: WebCenter Portalでの制限事項

- 20.4 ワークリスト接続の設定

- 20.4.1 ワークリスト接続について

- 20.4.2 ワークリスト接続の登録

- 20.4.3 ワークリスト接続のアクティブ化

- 20.4.4 ワークリスト接続の詳細の変更

- 20.4.5 ワークリスト接続の削除

- 20.5 WebCenter PortalワークフローをホスティングするBPELサーバーの指定

- 20.6 電子メールで送信するWebCenter Portalワークフロー通知の構成

- 20.7 ワークリストに関する問題のトラブルシューティング

- 20.7.1 アプリケーションの構成の問題が原因でワークリストが使用できない

- 20.7.2 サーバーの障害が原因でワークリストが使用できない

- 20.7.3 電子メール通知が動作しない

21 ポートレット・プロデューサの管理

- 21.1 ポートレット・プロデューサについて

- 21.2 WSRPプロデューサの登録

- 21.2.1 Fusion Middleware Controlを使用したWSRPプロデューサの登録

- 21.2.2 WLSTを使用したWSRPプロデューサの登録

- 21.2.3 マップされたユーザーIDのための権限のポリシー・ストアへの追加

- 21.2.4 WebCenter PortalでのWSRPポートレット・プロデューサの登録

- 21.2.5 WebCenter Portal FrameworkアプリケーションでのWSRPポートレット・プロデューサの登録

- 21.3 WSRPプロデューサの接続テスト

- 21.4 Oracle PDK-Javaプロデューサの登録

- 21.4.1 Fusion Middleware Controlを使用したOracle PDK-Javaプロデューサの登録

- 21.4.2 WLSTを使用したOracle PDK-Javaプロデューサの登録

- 21.4.3 WebCenter PortalでのOracle PDK-Javaポートレット・プロデューサの登録

- 21.4.4 WebCenter Portal FrameworkアプリケーションでのOracle PDK-Javaポートレット・プロデューサの登録

- 21.5 Oracle PDK-Javaプロデューサの接続テスト

- 21.6 プロデューサ登録情報の編集

- 21.6.1 Fusion Middleware Controlを使用したプロデューサ登録情報の編集

- 21.6.2 WLSTを使用したプロデューサ登録情報の編集

- 21.6.3 WebCenter Portalでのプロデューサの登録情報の編集

- 21.6.4 WebCenter Portal Frameworkアプリケーションでのプロデューサの登録情報の編集

- 21.6.5 WSRPプロデューサ・メタデータの新しいWSDL URLへの移行

- 21.7 ポートレット・クライアント構成の編集

- 21.8 プロデューサの登録解除

- 21.8.1 Fusion Middleware Controlを使用したプロデューサの登録解除

- 21.8.2 WLSTを使用したプロデューサの登録解除

- 21.8.3 WebCenter Portalでのプロデューサの登録解除

- 21.8.4 WebCenter Portal Frameworkアプリケーションでのプロデューサの登録解除

- 21.9 管理コンソールを使用したポートレット・プロデューサの管理

- 21.9.1 管理コンソールを使用したポートレット・プロデューサの登録

- 21.9.2 管理コンソールを使用したポートレット・プロデューサの登録情報の編集

- 21.9.3 管理コンソールを使用したポートレット・プロデューサの登録解除

- 21.10 プロデューサの登録タスク・フローでの作業

- 21.10.1 プロデューサの登録タスク・フローのページへの追加

- 21.10.2 プロデューサの登録タスク・フローを使用したポートレット・プロデューサの登録

- 21.10.3 プロデューサの登録タスク・フローのプロパティの設定

- 21.11 ポートレット・プロデューサ・アプリケーションのデプロイ

- 21.11.1 ポートレット・プロデューサ・アプリケーションのデプロイの理解

- 21.11.2 ポートレット・プロデューサ・アプリケーションのデプロイの準備

- 21.11.3 Fusion Middleware Controlを使用したポートレット・プロデューサ・アプリケーションのデプロイ

- 21.11.4 Oracle WebLogic Server管理コンソールを使用したポートレット・プロデューサ・アプリケーションのデプロイ

- 21.11.5 WLSTを使用したポートレット・プロデューサ・アプリケーションのデプロイ

- 21.11.6 Oracle JDeveloperを使用したポートレット・プロデューサ・アプリケーションのデプロイ

- 21.12 WebCenterサービス・ポートレットの構成

- 21.12.1 バックエンド接続の構成

- 21.12.2 WebCenterサービス・ポートレットのセキュリティの構成

- 21.12.3 WebCenterサービス・ポートレットのトラブルシューティング

- 21.13 ポートレット・プロデューサ問題のトラブルシューティング

- 21.13.1 WebCenter Portal Frameworkアプリケーションにプロデューサを登録できない

- 21.13.2 ポートレットを使用できない: 例外WSM-00101

22 ページレット・プロデューサの管理

- 22.1 ページレット・プロデューサについて

- 22.1.1 概要

- 22.1.2 ページレット・プロデューサ・コンソールの使用

- 22.1.3 WSRPおよびOracle JPDKポートレットの公開

- 22.1.4 OpenSocialガジェットの公開

- 22.1.5 Oracle WebCenter Interactionポートレットの公開

- 22.2 ページレット・プロデューサの登録

- 22.2.1 Fusion Middleware Controlを使用したページレット・プロデューサの登録

- 22.2.2 WLSTを使用したページレット・プロデューサの登録

- 22.2.3 WebCenter Portal用のページレット・プロデューサ・サービスの構成

- 22.2.4 WebCenter Portalを使用したページレット・プロデューサの登録

- 22.2.5 ページレット・プロデューサの別のコンテキストへの再デプロイ

- 22.3 WSRPおよびOracle JPDKポートレット・プロデューサのページレット・プロデューサへの登録

- 22.3.1 WSRPおよびOracle JPDKポートレットの使用

- 22.4 トラスト・サービス・アイデンティティ・アサータの構成

- 22.4.1 トラスト・サービス・アイデンティティ・アサータについて

- 22.4.2 トラスト・サービス・アイデンティティ・アサータの構成の準備

- 22.4.3 トラスト・サービス・アイデンティティ・アサータの構成の実行

- 22.5 ページレット・プロデューサ・コンポーネントのインポート、エクスポート、バックアップおよびリカバリの管理

- 22.5.1 ページレット・プロデューサ・リソースのエクスポートおよびインポート

- 22.5.2 WLSTを使用したページレット・プロデューサ・メタデータのエクスポートおよびインポート

- 22.5.3 ページレット・プロデューサのバックアップおよび復元

23 外部アプリケーションの管理

- 23.1 外部アプリケーションについて

- 23.2 外部アプリケーションの登録

- 23.2.1 Fusion Middleware Controlを使用した外部アプリケーションの登録

- 23.2.2 WLSTを使用した外部アプリケーションの登録

- 23.2.3 WebCenter Portalでの外部アプリケーションの登録

- 23.2.4 Portal Frameworkアプリケーションでの外部アプリケーションの登録

- 23.3 外部アプリケーション接続の詳細の変更

- 23.3.1 Fusion Middleware Controlを使用した外部アプリケーション接続の変更

- 23.3.2 WLSTを使用した外部アプリケーション接続の変更

- 23.4 WebCenter Portal管理コンソールを使用した外部アプリケーションの管理

- 23.4.1 外部アプリケーションの登録

- 23.4.2 外部アプリケーションの編集と削除

- 23.5 外部アプリケーション接続のテスト

- 23.6 外部アプリケーション接続の削除

- 23.6.1 Fusion Middleware Controlを使用した外部アプリケーション接続の削除

- 23.6.2 WLSTを使用した外部アプリケーション接続の削除

- 23.7 外部アプリケーションの問題のトラブルシューティング

- 23.7.1 ユーザーのパスワードがロックアウトされる

24 RESTサービスの管理

- 24.1 RESTサービスについて

- 24.2 RESTの有効化に必要な手動構成の実行

- 24.2.1 アイデンティティ・アサータの構成

- 24.2.2 WebLogic Server資格証明ストアの構成

- 24.3 セキュリティ・トークンの理解

- 24.4 RESTのルート名の変更

- 24.5 圧縮の使用

- 24.6 認証の処理

25 パーソナライズの管理

- 25.1 Oracle WebCenter Portalのパーソナライズについて

- 25.2 パーソナライズの前提条件と制限事項

- 25.2.1 パーソナライズのインストール要件

- 25.2.2 パーソナライズREST APIの構成要件

- 25.2.3 パーソナライズの構成要件

- 25.2.4 パーソナライズのセキュリティ

- 25.2.5 パーソナライズの制限事項

- 25.2.6 パーソナライズの構成オプション

- 25.3 WebCenter OPSSトラスト・サービスの構成

- 25.3.1 Oracle WebCenter Portalドメインでのトラスト・サービスの構成

- 25.3.2 統合WLSドメインでのトラスト・サービスの構成

- 25.3.3 ドメイン間トラストの構成

- 25.4 プロバイダの構成

- 25.4.1 プロバイダ接続設定の作成または変更

- 25.4.2 CMISプロバイダの構成

- 25.4.3 アクティビティ・グラフ・プロバイダの構成

- 25.4.4 Oracle People Connectionsロケータの構成

- 25.4.5 カスタム・プロバイダの構成

- 25.5 Coherenceの構成

- 25.6 コンテンツ・プレゼンタの構成

- 25.6.1 WebCenter PortalアプリケーションのContent Server接続の構成

- 25.6.2 コンテンツ・プレゼンタ・タスク・フローのパラメータの構成

- 25.6.3 コンダクタのシナリオ・タグの構成

- 25.7 シングル・サインオンの構成

- 25.8 デフォルトのセキュリティ設定のオーバーライド

- 25.8.1 シナリオの匿名実行の許可

- 25.8.2 匿名ユーザーによるシナリオの作成の禁止

- 25.8.3 認証されたユーザーによるシナリオの作成の禁止

26 Microsoft Office統合の管理

- 26.1 Microsoft Office統合について

- 26.2 Microsoft Office統合の構成

- 26.3 非SSL統合の構成

- 26.4 トラブルシューティング

- 26.4.1 Officeで「編集」をクリックしてもWordが起動しない

- 26.4.2 ドキュメント・ライブラリからのドキュメント編集に関する問題(Windows 7)

- 26.4.3 SSLの使用でドキュメントのチェックアウトが不可能になる

- 26.4.4 Microsoft Officeの作業ウィンドウにタブが1つしか表示されない

- 26.4.5 Firefoxを使用してMicrosoft Officeに接続できない

- 26.4.6 Microsoft Officeドキュメントを開くときに認証を求められる

第VI部 モニタリング

27 Oracle WebCenter Portalのパフォーマンスのモニタリング

- 27.1 Oracle WebCenter Portalのパフォーマンス・メトリックの理解

- 27.1.1 Oracle WebCenter Portalのメトリック収集の理解

- 27.1.2 主要なパフォーマンス・メトリックの理解

- 27.1.3 主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断

- 27.1.4 共通のパフォーマンスの問題およびアクションの理解

- 27.1.5 ページ・リクエスト・メトリックの理解

- 27.1.6 ドキュメント・メトリックの理解

- 27.1.7 ポートレット・プロデューサのメトリックの理解

- 27.1.8 WebLogic Serverメトリックの理解

- 27.1.9 セキュリティ・メトリックの理解

- 27.1.10 ページ・レスポンス・メトリックおよび負荷メトリックの理解

- 27.1.11 ポータル・メトリックの理解

- 27.1.12 ツール・メトリックおよびサービス・メトリックの理解

- 27.2 Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示

- 27.2.1 WebCenter Portalのモニタリング

- 27.2.2 Portal Frameworkアプリケーションのモニタリング

- 27.3 主要なパフォーマンス・メトリックのしきい値および収集のカスタマイズ

- 27.3.1 主要なパフォーマンス・メトリックのカスタマイズ・オプションの理解

- 27.3.2 デフォルトのメトリック収集およびしきい値設定の理解

- 27.3.3 主要なメトリックのしきい値の構成

- 27.3.4 ドキュメント・アップロード/ダウンロード・メトリックのしきい値の構成

- 27.3.5 WebLogic Serverヘルス・チェックの頻度の構成

- 27.3.6 主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成

- 27.3.7 WebCenter PortalおよびPortal Frameworkアプリケーションのしきい値および収集オプションの編集(metric_properties.xml)

- 27.4 Oracle WebCenter Portalに関するパフォーマンス問題の診断および解決

- 27.5 Oracle WebCenter Portalのパフォーマンスのチューニング

28 Oracle WebCenter Portalログの管理

- 28.1 診断ロギングの概要

- 28.2 ログ情報の表示および構成

- 28.2.1 WebCenter Portalログの表示および構成

- 28.2.2 Portal Frameworkアプリケーション・ログの表示および構成

29 Oracle WebCenter Portal監査ログの管理

- 29.1 監査ログの管理の概要

- 29.2 監査ログの構成

- 29.2.1 ロギング・レベルの設定

- 29.2.2 監査ストア・データベースの構成

- 29.3 WebCenter Portal監査イベントの表示

- 29.3.1 WebCenter Portal監査ログの使用

- 29.3.2 監査スキーマへの問合せ

第VII部 セキュリティ

30 Oracle WebCenter Portalセキュリティの管理

- 30.1 アプリケーション・セキュリティの概要

- 30.2 デフォルトのセキュリティ構成

- 30.2.1 管理者アカウント

- 30.2.2 アプリケーション・ロールとエンタープライズ・ロール

- 30.2.3 デフォルトのアイデンティティ・ストアおよびポリシー・ストア

- 30.2.4 デフォルトのポリシー・ストアの権限および付与

- 30.2.5 デプロイ後のセキュリティ構成タスク

- 30.3 セキュリティ構成に関する問題のトラブルシューティング

- 30.3.1 WebCenter PortalアプリケーションでLDAPプロバイダのユーザーが見つからない

- 30.3.2 OIDユーザーとしてログインしている場合にポータルを作成するとエラーが発生する

- 30.3.3 Active Directoryを使用してWebCenter Portalを構成するとユーザーが自己登録できない

- 30.3.4 管理者に設定されたユーザーが管理者権限を使用できない

- 30.3.5 SSO環境のOmniPortletプロデューサで認可例外が発生する

- 30.3.6 SAML SSO固有のディスカッションEARファイルをデプロイすると例外が発生する

- 30.3.7 SAMLシングル・サインオンを構成すると403エラーが発生する

- 30.3.8 偽装セッションによりOAM 11.1.2.2.0でエラーが生成される

31 アイデンティティ・ストアの構成

- 31.1 外部LDAPサーバーへのアイデンティティ・ストアの再関連付け

- 31.2 外部LDAPアイデンティティ・ストア用のGUID属性の構成

- 31.3 組込みLDAPアイデンティティ・ストアへのユーザーの追加

- 31.3.1 WLS管理コンソールを使用したアイデンティティ・ストアへのユーザーの追加

- 31.3.2 LDIFファイルを使用したアイデンティティ・ストアへのユーザーの追加

- 31.4 外部LDAPサーバーへの管理者アカウントの移行

- 31.4.1 ディスカッション・サーバーの新規管理者アカウントの特定

- 31.4.2 管理者グループ名の変更

- 31.5 Content ServerとWebCenter Portalでアイデンティティ・ストアLDAPサーバーを共有するための構成

- 31.6 libOVDを使用した複数のアイデンティティ・ストアLDAPサーバーの集約

- 31.6.1 アイデンティティ・ストアに完全なユーザー・プロファイルが存在する場合のlibOVDの構成

- 31.6.2 アイデンティティ・ストアに部分的なユーザー・プロファイルが存在する場合のlibOVDの構成

- 31.6.3 単一オーセンティケータの復元

- 31.7 WebCenter Portalの動的ロールの構成

- 31.7.1 動的ロールの構成の概要

- 31.7.2 動的ロールの構成の前提条件

- 31.7.3 OVDプラグインのインストール

- 31.7.4 動的ロールの構成

- 31.8 WebCenter Portalの動的グループの構成

- 31.8.1 LDIFファイルを使用した動的グループの作成

- 31.8.2 Oracle Directory Services Managerを使用した動的グループの作成

- 31.9 RESTサービス・アイデンティティ・アサータの構成

- 31.9.1 RESTサービス・インスタンスおよびアイデンティティ・アサータの理解

- 31.9.2 クライアント・アプリケーションの設定

- 31.9.3 WLSトラスト・サービス・アサータの構成

32 ポリシーおよび資格証明ストアの構成

- 32.1 ルート・ノードの作成

- 32.2 Fusion Middleware Controlを使用した資格証明およびポリシー・ストアの再関連付け

- 32.3 WLSTを使用した資格証明およびポリシー・ストアの再関連付け

- 32.4 資格証明の管理

- 32.5 ユーザーおよびアプリケーション・ロールの管理

- 32.5.1 WebCenter Portal管理者ロールの付与

- 32.5.2 アプリケーション・ロールの付与

- 32.5.3 実行時管理ページの使用

- 32.6 WebCenter Portalにおける招待による自己登録の構成

- 32.7 ポリシー・ストアのリフレッシュ間隔および他のキャッシュ設定の設定

- 32.7.1 ポリシー・ストアのリフレッシュ間隔の設定

- 32.7.2 接続プール・キャッシュの設定

- 32.7.3 ユーザー・キャッシュ設定の設定

- 32.7.4 グループ・キャッシュ設定の設定

33 シングル・サインオンの構成

- 33.1 シングル・サインオンの概要

- 33.2 Oracle Access Manager (OAM)の構成

- 33.2.1 OAMのコンポーネントとトポロジ

- 33.2.2 OAM構成のロードマップ

- 33.2.3 OAMのインストールと構成

- 33.2.4 OAM用のWebLogicドメインの構成

- 33.2.5 Oracle HTTP Serverのインストールと構成

- 33.2.6 追加のシングル・サインオン構成

- 33.2.7 OAMインストールのテスト

- 33.3 Oracle Single Sign-On (OSSO)の構成

- 33.3.1 OSSO構成のロードマップ

- 33.3.2 OSSOのコンポーネントとトポロジ

- 33.3.3 Oracle HTTP Serverと関連モジュールの構成

- 33.3.4 OSSOIdentityAsserterの構成

- 33.3.5 Oracle SSOへのOHSの登録

- 33.3.6 追加構成

- 33.4 SAMLベースのシングル・サインオンの構成

- 33.4.1 SAMLのコンポーネントとトポロジ

- 33.4.2 SAMLベースのシングル・サインオンの構成

- 33.5 Microsoftクライアント用のSSOの構成

- 33.5.1 MicrosoftクライアントSSOの概念

- 33.5.2 システム要件

- 33.5.3 Microsoftクライアントの構成

- 33.6 仮想ホストを使用したSSOの構成

- 33.6.1 仮想ホストの必要性の理解

- 33.6.2 OSSO用の仮想ホストの構成

- 33.6.3 OAM 10g用の仮想ホストの構成

- 33.6.4 OAM 11g用の仮想ホストの構成

- 33.6.5 仮想ホスト用のWebCenter Portalの構成

- 33.6.6 構成のテスト

34 シングル・サインオン向けのPortal Frameworkアプリケーションの構成

- 34.1 構成の概要

- 34.2 シングル・サインオンの前提条件

- 34.2.1 web.xmlへのCLIENT-CERTの追加

- 34.2.2 JSESSIONIDのCookieパスの設定

- 34.2.3 アプリケーションの公開URIおよび保護対象URIの指定

- 34.2.4 埋込みログインの意味

- 34.2.5 ログアウトの処理

- 34.3 Web層の構成

- 34.4 OAMに対するPortal Frameworkアプリケーションおよびポートレット・プロデューサ・アプリケーションの構成

- 34.4.1 OAM 10gに対するPortal Frameworkアプリケーションの構成

- 34.4.2 OAM 10gに対するポートレット・プロデューサ・アプリケーションの構成

- 34.4.3 OAM 11gに対するPortal Frameworkアプリケーションの構成

- 34.4.4 OAM 11gに対するポートレット・プロデューサ・アプリケーションの構成

- 34.5 OSSOに対するPortal Frameworkアプリケーションの構成

- 34.6 SAML SSOに対するPortal Frameworkアプリケーションの構成

- 34.6.1 宛先のPortal FrameworkアプリケーションへのSAML SSOの構成

- 34.6.2 ソースのPortal FrameworkアプリケーションへのSAML SSOの構成

35 SSLの構成

- 35.1 SSLを使用したブラウザからWebCenter Portalへの接続の保護

- 35.1.1 カスタム・キーストアの作成

- 35.1.2 カスタムIDキーストアおよびJava信頼キーストアの構成

- 35.1.3 SSL接続の構成

- 35.2 SSLを使用したブラウザからPortal Frameworkアプリケーションへの接続の保護

- 35.3 SSLを使用したOracle HTTP ServerからWebCenter Portalへの接続の保護

- 35.3.1 IDキーストアおよび信頼キーストアの構成

- 35.3.2 SSL接続の構成

- 35.3.3 Oracle HTTP Serverのインストール

- 35.3.4 WebCenter PortalポートからHTTP Serverへのワイヤリング

- 35.3.5 SSL証明書の構成

- 35.4 SSLを使用したブラウザからディスカッションへの接続の保護

- 35.4.1 カスタム・キーストアの作成

- 35.4.2 IDキーストアおよび信頼キーストアの構成

- 35.4.3 SSL接続の構成

- 35.5 SSLを使用したWebCenter Portalからポートレット・プロデューサへの接続の保護

- 35.5.1 カスタム・キーストアの作成

- 35.5.2 IDキーストアおよび信頼キーストアの構成

- 35.5.3 SSL接続の構成

- 35.5.4 SSL対応WSRPプロデューサの登録およびポートレットの実行

- 35.5.5 SSL対応PDK-Javaプロデューサの登録およびポートレットの実行

- 35.5.6 JDeveloperでのSSL対応WSRPポートレットの消費

- 35.6 WebCenter PortalからLDAPアイデンティティ・ストアへの接続の保護

- 35.6.1 OID認証局(CA)のエクスポート

- 35.6.2 WebLogicサーバーの設定

- 35.7 SSLを使用したWebCenter PortalからContent Serverへの接続の保護

- 35.7.1 クライアント・サイドでのキーストアおよびキーの構成

- 35.7.2 サーバー・サイドでのキーストアおよびキーの構成

- 35.7.3 信頼できるクライアントのシグネチャの検証

- 35.7.4 アイデンティティ伝播の保護

- 35.8 SSLを使用したWebCenter PortalからIMAPおよびSMTPへの接続の保護

- 35.9 SSLを使用したPortal FrameworkアプリケーションからIMAPおよびSMTPへの接続の保護

- 35.10 SSLを使用したOracle SESへの接続の保護

- 35.10.1 SSLを使用したOracle SESの保護

- 35.10.2 SSLを使用したOracle SESへの接続の保護

- 35.11 SSLを使用したWebCenter PortalからMicrosoft Live Communication ServerおよびOffice Communication Serverへの接続の保護

- 35.12 SSLを使用したWebCenter Portalから外部BPELサーバーへの接続の保護

- 35.13 SSLを使用したMicrosoft Exchange Serverへの接続の保護

36 WS-Securityの構成

- 36.1 単純トポロジの場合のWS-Securityの構成

- 36.1.1 単純トポロジの場合のWS-Securityの構成のロードマップ

- 36.1.2 WebCenter Portalドメイン・キーストアの設定

- 36.1.3 単純トポロジの場合のディスカッション・サーバーの構成

- 36.1.4 単純トポロジの場合のコマンド・サマリー

- 36.2 標準トポロジの場合のWS-Securityの構成

- 36.2.1 標準トポロジの場合のWS-Securityの構成のロードマップ

- 36.2.2 WebCenter Portalドメイン・キーストアの設定

- 36.2.3 標準トポロジの場合のディスカッション・サーバーの構成

- 36.2.4 SOAドメインの設定

- 36.2.5 標準トポロジの場合のコマンド・サマリー

- 36.3 複合トポロジの場合のWS-Securityの構成

- 36.3.1 複合トポロジの場合のWS-Securityの構成のロードマップ

- 36.3.2 WebCenter Portalドメイン・キーストアの設定

- 36.3.3 複合トポロジの場合のディスカッション・サーバーの構成

- 36.3.4 1つ目のSOAドメインの設定

- 36.3.5 2つ目のSOAドメインの設定

- 36.3.6 外部ポートレット・ドメイン・キーストアの設定

- 36.3.7 外部WebCenterドメイン・キーストアの設定

- 36.3.8 複合トポロジの場合のコマンド・サマリー

- 36.4 WebCenter Portal Client APIを使用するアプリケーションに対するWS-Securityを使用したWebCenter Portalの保護

- 36.4.1 WebCenter PortalクライアントAPIを使用するアプリケーションの単純トポロジの構成

- 36.4.2 WebCenter PortalクライアントAPIを使用するアプリケーションの標準トポロジの構成

- 36.4.3 WebCenter PortalクライアントAPIを使用するアプリケーションの複合トポロジの構成

37 ポートレット・プロデューサのセキュリティの構成

- 37.1 WSRPプロデューサの保護

- 37.1.1 プロデューサのデプロイ

- 37.1.2 プロデューサ・エンドポイントへのポリシーの添付

- 37.1.3 キーストアの設定

- 37.2 PDK-Javaプロデューサの保護

- 37.2.1 パスワード資格証明としての共有鍵の定義

38 偽装の管理

- 38.1 WebCenter Portal偽装の概要

- 38.1.1 WebCenter Portal偽装について

- 38.1.2 WebCenter Portal偽装の使用のベスト・プラクティス

- 38.2 WebCenter Portalの偽装の準備

- 38.2.1 WebCenter Portal偽装の要件

- 38.2.2 OAMでの偽装の有効化

- 38.2.3 アイデンティティ・ストアへの偽装属性の追加

- 38.3 WebCenter Portalの偽装の構成

- 38.4 偽装者の構成

- 38.5 偽装の無効化

- 38.6 セッション・インジケータをオフにする

- 38.7 偽装ホットキーのオーバーライド

- 38.8 WebCenter Portal偽装の監査ログの管理

第VIII部 ライフサイクル: WebCenter Portal

39 WebCenter Portalのライフ・サイクルの理解

- 39.1 WebCenter Portalのライフ・サイクルとは

- 39.2 主要なWebCenter Portalのライフ・サイクル・タスクとは

- 39.2.1 1回かぎりの設定タスク

- 39.2.2 開発環境のタスク

- 39.2.3 ステージ環境のタスク

- 39.2.4 本番環境のタスク

- 39.3 WebCenter Portalのライフ・サイクルへの参加者

- 39.4 WebCenter Portalのステージング環境および本番環境の理解

- 39.4.1 WebCenter Portalのステージング環境の設定

- 39.4.2 WebCenter Portalステージング環境へのコンテンツの追加

- 39.4.3 ステージングから本番へのポータルの移動

- 39.5 WebCenter Portalのライフ・サイクルを管理するツール

- 39.6 WebCenter Portalのライフ・サイクル操作の実行に必要な権限

- 39.7 WebCenter Portalのステージング環境または本番環境の初回の設定

- 39.8 開発環境からのWebCenter Portalデプロイメントの管理

- 39.9 ステージングから本番へのポータル変更の管理

- 39.10 本番からステージングへの変更の管理

- 39.11 WebCenter Portalのライフ・サイクルを通したセキュリティの管理

- 39.12 WebCenter Portalのライフ・サイクルを通したバックアップの管理

40 ポータル、テンプレート、アセットおよび拡張機能のデプロイ

- 40.1 ポータルのデプロイ

- 40.1.1 ポータルのデプロイメントについて

- 40.1.2 ポータル・アーカイブのデプロイ

- 40.1.3 ポータル階層のデプロイ

- 40.2 ポータル・テンプレートのデプロイ

- 40.2.1 ポータル・テンプレートのエクスポート

- 40.2.2 ポータル・テンプレートのインポート

- 40.3 アセットのデプロイ

- 40.3.1 アーカイブへのアセットのエクスポート

- 40.3.2 アーカイブからのアセットのインポート

- 40.4 デバイスおよびデバイス・グループのデプロイ

- 40.4.1 アーカイブへのデバイスおよびデバイス・グループのエクスポート

- 40.4.2 アーカイブからのデバイスおよびデバイス・グループのインポート

- 40.5 カスタム共有ライブラリの拡張機能のデプロイ

- 40.6 ステージングから本番への接続の詳細の移動

- 40.6.1 ファイルへのWebCenter Portal接続の詳細のエクスポート

- 40.6.2 ファイルからの新しいWebCenter Portal接続のインポート

- 40.7 ステージングから本番へのポータルの移動

- 40.8 ステージングから本番への外部ポータル・データの移動

- 40.8.1 個々のポータルのバックエンド・コンポーネントの移行

- 40.8.2 ポータル・サーバー全体のバックエンド・コンポーネントの移行

- 40.9 本番でのポータルの管理

- 40.9.1 ポータル伝播の理解

- 40.9.2 ステージングから本番へのポータルの直接デプロイ

- 40.9.3 ステージングから本番へのポータル変更の伝播

- 40.10 制限事項

41 WebCenter Portalのバックアップ、リカバリおよびクローニングの管理

- 41.1 WebCenter Portalのバックアップおよびリカバリの理解

- 41.2 WebCenter Portalのバックアップ、リカバリおよび移行のツールの比較

- 41.3 個々のポータルのバックアップ

- 41.3.1 WLSTを使用したポータルのバックアップ

- 41.3.2 ポータルのディスカッション・データのバックアップ

- 41.3.3 ポータルの他の外部データおよびコンテンツのバックアップ

- 41.4 バックアップからのポータルのリストア

- 41.4.1 WLSTを使用したポータルのアーカイブからのリストア

- 41.4.2 ポータルのディスカッション・データのリストア

- 41.4.3 ポータルの他の外部データおよびコンテンツのリストア

- 41.5 別のターゲットへのWebCenter Portal全体の移行

- 41.5.1 WebCenter Portalのインポートおよびエクスポートの理解

- 41.5.2 WebCenter Portalのエクスポートおよびインポートの前提条件

- 41.5.3 アーカイブへのWebCenter Portalのエクスポート

- 41.5.4 WebCenter Portalアーカイブのインポート

- 41.6 WebCenter Portalインストール全体のバックアップ

- 41.6.1 WebCenter Portalのすべてのスキーマ・データのバックアップおよびリストア

- 41.6.2 すべてのMDSスキーマ・データのバックアップおよびリストア

- 41.6.3 すべてのWebCenter Contentデータのバックアップおよびリストア

- 41.6.4 ディスカッション・スキーマ・データのバックアップおよびリストア

- 41.6.5 他のスキーマ・データ(ACTIVITIESとPORTLET)のバックアップおよびリストア

- 41.6.6 LDAPアイデンティティ・ストアのバックアップおよびリストア

- 41.6.7 ポリシー・ストアのバックアップおよびリストア(LDAPとデータベース)

- 41.6.8 資格証明ストアのバックアップおよびリストア(LDAPとデータベース)

- 41.6.9 WebCenter Portalドメインのバックアップおよびリストア

- 41.6.10 ポートレット・プロデューサのメタデータのバックアップおよびリストア

- 41.6.11 ページレット・プロデューサのメタデータのバックアップおよびリストア

- 41.6.12 アクティビティ・グラフと分析のメタデータのバックアップおよびリストア

- 41.6.13 パーソナライズ・メタデータのバックアップおよびリストア

- 41.6.14 監査リポジトリ構成のバックアップおよびリストア

- 41.7 WebCenter Portalインストール全体のリストア

- 41.8 スクリプトを使用したWebCenter Portalのバックアップおよびリストア

- 41.8.1 バックアップおよびリストアのスクリプト・ファイルの理解

- 41.8.2 スクリプトを使用したWebCenter Portalのバックアップ

- 41.8.3 スクリプトを使用したWebCenter Portalのバックアップからのリストア

- 41.9 WebCenter Portal環境のクローニング

第IX部 ライフ・サイクル: Portal Frameworkアプリケーション

42 Portal Frameworkアプリケーションのデプロイ

- 42.1 Portal Frameworkアプリケーションのデプロイ

- 42.1.1 デプロイメント・ロードマップ

- 42.1.2 デプロイメントの前提条件

- 42.1.3 アプリケーションEARファイルの準備

- 42.1.4 管理対象サーバーの作成

- 42.1.5 メタデータ・サービス・リポジトリの作成および登録

- 42.1.6 WebLogic管理対象サーバーへのアプリケーションのデプロイ

- 42.1.7 カスタマイズおよびデータの環境間の移行

- 42.1.8 分散環境で実行するためのアプリケーションの構成

- 42.2 Portal Frameworkアプリケーションのアンデプロイ

- 42.2.1 Fusion Middleware Controlを使用したPortal Frameworkアプリケーションのアンデプロイ

- 42.2.2 WLSTを使用したPortal Frameworkアプリケーションのアンデプロイ

- 42.2.3 アプリケーションの資格証明マップの削除

- 42.3 Portal Frameworkアプリケーションの再デプロイ

- 42.3.1 再デプロイに関する考慮事項

- 42.3.2 Fusion Middleware Controlを使用したPortal Frameworkアプリケーションの再デプロイ

- 42.3.3 WLSTを使用したPortal Frameworkアプリケーションの再デプロイ

- 42.4 デプロイ後の構成

- 42.4.1 デプロイ後のセキュリティ構成の確認

- 42.4.2 デプロイ後のアプリケーション接続の確認

- 42.4.3 データ・ソース接続の確認

- 42.4.4 アプリケーションのチューニング

43 管理コンソールを使用したPortal Frameworkアプリケーションの管理

- 43.1 Portal Frameworkアプリケーションの管理コンソールの概要

- 43.2 Portal Frameworkアプリケーションの管理コンソールへのアクセス

- 43.3 Portal Frameworkアプリケーションのデフォルト設定の構成

- 43.3.1 デフォルト・ページ・テンプレートの選択

- 43.3.2 デフォルト・リソース・カタログの選択

- 43.3.3 デフォルト・ナビゲーションの選択

- 43.3.4 デフォルト・スキンの選択

- 43.3.5 デフォルト・ベース・リソースURLの選択

- 43.4 Portal Frameworkアプリケーションのメンバーとロールの管理

- 43.4.1 ユーザーの理解

- 43.4.2 アプリケーション・ロールおよび権限の理解

- 43.4.3 ユーザーの管理

- 43.4.4 アプリケーション・ロールおよび権限の管理

- 43.5 Portal Frameworkアプリケーションのアセットの管理

- 43.5.1 ページの使用

- 43.5.2 アセットの作成

- 43.5.3 アセットのコピー

- 43.5.4 アセットの編集

- 43.5.5 アセットのプロパティの設定

- 43.5.6 アセットの表示と非表示

- 43.5.7 アセット・セキュリティの設定

- 43.5.8 アセットのアップロードとダウンロード

- 43.5.9 アセットのプレビュー

- 43.5.10 アセットの削除

- 43.6 Portal Frameworkアプリケーションのサービス、ポートレット・プロデューサおよび外部アプリケーションの構成

- 43.6.1 コンテンツの管理

- 43.6.2 ポートレット・プロデューサの管理

- 43.6.3 外部アプリケーションの管理

- 43.6.4 投票の作成と構成

- 43.7 Portal Frameworkアプリケーションの変更のステージングから本番への伝播

44 Portal Frameworkアプリケーションのエクスポート、インポート、バックアップおよびリカバリの管理

- 44.1 データ移行のためのPortal Frameworkアプリケーションのエクスポートおよびインポート

- 44.1.1 Portal Frameworkアプリケーションのエクスポートおよびインポートの理解

- 44.1.2 Portal Frameworkアプリケーションのエクスポートおよびインポートの前提条件

- 44.1.3 Portal Frameworkアプリケーションのポートレット・クライアント・メタデータのエクスポート

- 44.1.4 Portal Frameworkアプリケーションのポートレット・クライアント・メタデータのインポート

- 44.1.5 Portal Frameworkアプリケーションのポータル・リソースのエクスポート

- 44.1.6 Portal Frameworkアプリケーションのポータル・リソースのインポート

- 44.1.7 Portal Frameworkアプリケーションのメタデータのエクスポート

- 44.1.8 Portal Frameworkアプリケーションのメタデータのインポート

- 44.1.9 Portal Frameworkアプリケーションのセキュリティの移行

- 44.1.10 Portal Frameworkアプリケーションのスキーマ・データの移行

- 44.2 Portal Frameworkアプリケーションのバックアップおよびリカバリ

第X部 複数言語ポータル

45 複数言語ポータルの管理

- 45.1 WebCenter Portalの言語について

- 45.1.1 WebCenter Portalによってデフォルトでサポートされる言語

- 45.2 アプリケーション・レベルでの文字列の変更と翻訳

- 45.3 ポータルの文字列の翻訳

- 45.4 ポータルの特定文字列に対する翻訳の変更と追加

- 45.5 WebCenter Portalへの新規言語のサポートの追加

第XI部 ポータル・ビルダー管理におけるポータルの管理

46 ポータル・ビルダー内の「ポータル」ページの検索

- 46.1 ポータル・ビルダー内の「ポータル」ページについて

- 46.2 ポータル・ビルダー内の「ポータル」ページへのアクセス

- 46.3 ポータル・リストのソート

- 46.4 ポータルの作成

- 46.5 ポータルのエクスポートおよびインポート

- 46.6 任意のポータルに関する情報の表示

- 46.7 類似のポータルの表示

- 46.8 ポータルへのリンクの共有

- 46.9 任意のポータルのクローズ

- 46.10 任意のポータルの再アクティブ化

- 46.11 任意のポータルのオフライン化

- 46.12 任意のポータルの再オンライン化

- 46.13 サブポータルの作成

- 46.14 ポータルまたはサブポータルの移動(親の変更)

- 46.15 ポータルの削除

47 ポータル・ビルダー管理内の「管理」ページの検索

- 47.1 ポータル・ビルダー管理について

- 47.2 「ポータル・ビルダー管理」ページへのアクセス

- 47.3 ポータル・ビルダー管理タスクの実行

48 ポータル間のグローバルなデフォルト設定の構成

- 48.1 名前とロゴのカスタマイズ

- 48.2 デフォルト・ページ・テンプレートの選択

- 48.3 デフォルト・スキンの選択

- 48.3.1 WebCenter Portalのスキンの適用

- 48.4 デフォルト・ナビゲーションの選択

- 48.5 デフォルト・リソース・カタログの選択

- 48.6 コピーライトとプライバシ宣言文のカスタマイズ

- 48.7 オンライン・ヘルプ・リンクのカスタマイズ

- 48.8 デフォルト表示言語の選択

- 48.8.1 言語リストのカスタマイズ

- 48.9 デフォルト開始ページ(またはランディング・ページ)の選択

- 48.9.1 グループに対するデフォルト開始ページの選択

- 48.9.2 認証済ユーザーに対するデフォルト開始ページの選択

- 48.9.3 パブリック・ユーザーに対するデフォルト開始ページの選択

- 48.10 セッション・タイムアウト設定の指定

- 48.11 自己登録の有効化

- 48.11.1 自己登録について

- 48.11.2 すべてのユーザーの自己登録の有効化

- 48.11.3 招待者限定の自己登録の有効化

- 48.12 新しいページのデフォルトのルック・アンド・フィールの選択

- 48.13 ホーム・ポータルへのアクセスの有効化と無効化

- 48.14 WebCenter Portalツールとサービスのデフォルトの設定

49 ポータル間のセキュリティの管理

- 49.1 ポータルのセキュリティについて

- 49.2 ユーザーについて

- 49.3 アプリケーション・ロールおよび権限について

- 49.3.1 アプリケーション・ロールについて

- 49.3.2 アプリケーションの権限について

- 49.4 ポータル内のロールおよび権限について

- 49.5 ユーザーの管理

- 49.5.1 ユーザー(およびグループ)へのロールの割当て

- 49.5.2 ユーザーへの異なるロールの割当て

- 49.5.3 ユーザーへの管理権限の付与

- 49.5.4 アプリケーション・ロールの取消し

- 49.5.5 ユーザーの追加または削除

- 49.6 アプリケーション・ロールおよび権限の管理

- 49.6.1 アプリケーション・ロールの定義

- 49.6.2 アプリケーション・ロールの権限の変更

- 49.6.3 パブリック・ユーザーへの権限の付与

- 49.6.4 認証されたユーザーへの権限の付与

- 49.6.5 アプリケーション・ロールの削除

- 49.7 ユーザーおよびロールに関する問題のトラブルシューティング

50 システム・ページのカスタマイズ

- 50.1 システム・ページについて

- 50.2 すべてのポータルのシステム・ページのカスタマイズ

- 50.2.1 アプリケーションレベルのシステム・ページのカスタマイズ

- 50.2.2 デバイス・グループ用システム・ページのページ・バリアントの作成

- 50.2.3 デバイス・グループ用システム・ページのページ・バリアントの管理

- 50.3 システム・ページのプロパティの設定

- 50.4 システム・ページからのすべてのページ・カスタマイズの削除

51 ビジネス・ロール・ページの管理

- 51.1 ビジネス・ロール・ページについて

- 51.2 ビジネス・ロール・ページのためのページ作成のデフォルトの設定

- 51.3 ビジネス・ロール・ページの作成

- 51.4 ビジネス・ロール・ページのターゲット・ユーザーの指定

- 51.4.1 カスタム・ビジネス・ロール・ページのアクセス権限の設定

- 51.4.2 カスタム・ビジネス・ロール・ページへのパブリック・アクセス権限の付与

- 51.4.3 シードされたビジネス・ロール・ページのアクセス権限の設定

- 51.5 カスタム・ビジネス・ロール・ページへのアクセス権限の取消し

- 51.6 ビジネス・ロール・ページへのナビゲーションの提供

- 51.6.1 ビジネス・ロール・ページの表示および非表示

- 51.6.2 ビジネス・ロール・ページへのナビゲーションの作成

- 51.7 ビジネス・ロール・ページのデフォルトの表示順の設定

- 51.8 ビジネス・ロール・ページの編集

- 51.9 ビジネス・ロール・ページのソースの編集

- 51.10 ビジネス・ロール・ページのコピー

- 51.11 ビジネス・ロール・ページからのすべてのユーザー・カスタマイズの削除

- 51.12 カスタム・ビジネス・ロール・ページの削除

52 個人用ページの管理

- 52.1 個人用ページの管理について

- 52.2 個人用ページのためのアプリケーションレベルのページ作成のデフォルトの設定

- 52.3 個人用ページのアクセス権限の変更

- 52.4 ユーザーによる個人用ページの作成の防止

- 52.5 個人用ページへのナビゲーションの提供

- 52.6 管理権限を使用した個人用ページの編集

- 52.7 個人用ページのソースの編集

- 52.8 個人用ページのコピー

- 52.9 個人用ページからのすべてのユーザー・カスタマイズの削除

- 52.10 ポータル管理ページを使用した個人用ページの削除

53 デバイス設定の管理

- 53.1 デバイス設定について

- 53.1.1 デバイス設定の概要

- 53.1.2 デバイスとは何か

- 53.1.3 デバイス・グループとは何か

- 53.1.4 その他の関連概念

- 53.1.5 基本的なユースケース: 新しいデバイスのサポートの追加

- 53.1.6 デバイス設定を適用する方法の理解

- 53.2 デバイスの作成および管理

- 53.2.1 新しいデバイスの作成

- 53.2.2 デバイスの編集

- 53.2.3 デバイスのコピー

- 53.2.4 デバイスのリストのフィルタリング

- 53.2.5 デバイスの削除

- 53.3 デバイス・グループの作成および管理

- 53.3.1 デバイス・グループの作成

- 53.3.2 デバイス・グループの編集

- 53.3.3 デバイス・グループのコピー

- 53.3.4 デバイス・グループの表示および非表示

- 53.3.5 デフォルトのデバイス・グループの設定

- 53.3.6 デバイス・グループの順序付け

- 53.3.7 デバイス・グループのフィルタリング

- 53.3.8 デバイス・グループの削除

- 53.4 デバイスおよびデバイス・グループのライフ・サイクルの管理

- 53.4.1 デバイス・グループまたはデバイスのダウンロード

- 53.4.2 デバイス・グループまたはデバイスのアップロード

- 53.5 デバイスのプレビュー

- 53.6 デバイス設定のガイドラインおよびベスト・プラクティス

- 53.7 デバイス属性の検出: サンプル・タスク・フロー

54 ポータル間のタスク・フローのカスタマイズ

- 54.1 アプリケーション・レベルでのタスク・フローのカスタマイズについて

- 54.2 アプリケーション・レベルでのタスク・フローのカスタマイズ

- 54.3 タスク・フローのカスタマイズの削除

55 ポータル間のグローバル属性での作業

- 55.1 グローバル属性について

- 55.2 グローバル属性の追加

- 55.3 グローバル属性の編集

- 55.4 グローバル属性の削除

56 ポータルの使用状況の分析

- 56.1 分析タスク・フローおよびサービスについて

- 56.2 分析管理ページについて

- 56.3 分析タスク・フローでの作業

- 56.3.1 分析タスク・フローの理解

- 56.3.2 分析タスク・フローのページへの追加

- 56.3.3 分析レポートのカスタマイズ

- 56.3.4 分析レポートのパーソナライズ

- 56.3.5 分析タスク・フローのプロパティの設定

第XII部 付録

A Oracle WebCenter Portalの構成

- A.1 構成ファイル

- A.1.1 adf-config.xmlおよびconnections.xml

- A.1.2 web.xml

- A.1.3 webcenter-config.xml

- A.2 クラスタ構成

- A.3 構成ツール

B WebCenter PortalのOracle HTTP Server構成

C サード・パーティ製品のサポート

D Oracle Secure Enterprise Searchの評価のための構成

- D.1 構成スクリプトの理解

- D.2 Oracle SESのアイデンティティ管理システムの構成

- D.3 Oracle SESのためのOracle WebCenter Content Serverの設定

- D.4 Oracle SESのためのOracle WebCenter Portalディスカッション・サーバーの設定

- D.5 WebCenter Portalを検索するためのOracle SESの設定

- D.5.1 Oracle SES管理ツールへのログオン

- D.5.2 ドキュメントを検索するためのOracle SESの設定

- D.5.3 ディスカッションおよびお知らせを検索するためのOracle SESの設定

- D.5.4 WebCenter Portalクローラからのコンポーネントの除外

- D.5.5 Oracle SESファセットおよびソート属性の構成

- D.5.6 追加のOracle SES構成

- D.6 構成スクリプトの実行

E WebCenter Portalのライフサイクル中のラベル付け

F WebCenter PortalへのWikiコンテンツの移行

- F.1 WikiドキュメントおよびWikiページの理解

- F.1.1 Wikiドキュメントの理解

- F.1.2 Wikiページの理解

- F.2 ドキュメント移行ユーティリティの理解

- F.2.1 ドキュメント移行ユーティリティのエクスポート機能の理解

- F.2.2 ドキュメント移行ユーティリティのインポート機能の理解

- F.3 ソースWikiアプリケーションからWebCenter Portalへのデータの移行

- F.3.1 WikiコンテンツのインポートのためのWebCenter Portalの準備

- F.3.2 Wikiアプリケーションからコンテンツを抽出するためのカスタムWiki抽出ツールの記述と実行

- F.3.3 ドキュメント移行ユーティリティを使用したターゲット・ポータルへのアーカイブのインポート

- F.3.4 Content Serverのコンテンツに対するWebCenter PortalのWikiページの作成

G Oracle WebCenter Portalのトラブルシューティング

- G.1 トラブルシューティングのロードマップ

- G.2 Oracle WebCenter Portalの構成に関する問題のトラブルシューティング

- G.2.1 インストールされているOracle WebCenter Portalのバージョンを調べる方法

- G.2.2 WebCenter PortalのメニューがFusion Middleware Controlに表示されない

- G.2.3 使用不可の構成オプション

- G.2.4 1つ以上のツールまたはサービスに関する構成問題

- G.2.5 あるアプリケーションの構成が別のアプリケーションに反映される

- G.2.6 ログはオープン・ファイルが多すぎることを示している

- G.3 Oracle WebCenter Portal WLSTコマンドの問題のトラブルシューティング

- G.3.1 Oracle WebCenter Portal WLSTのどのコマンドも機能しない

- G.3.2 WLSTコマンドが特定のツールまたはサービスに対して機能しない

- G.3.3 指定された接続名がすでに存在している

- G.3.4 WLSTシェルがWebLogic Serverに接続されない

- G.3.5 同じ名前の複数のアプリケーションがドメインにすでに存在している

- G.3.6 同じ名前の複数のアプリケーションが管理対象サーバーにすでに存在している

- G.3.7 ドメイン・ランタイム・ツリーにすでにメッセージが表示される

- G.4 Oracle WebCenter Portalのパフォーマンスに関する問題のトラブルシューティング

- G.4.1 パフォーマンスのモニタリングとトラブルシューティング・ツールについて

- G.4.2 システム全体の遅さをトラブルシューティングする方法

- G.4.3 表示の遅いページを特定する方法

- G.4.4 表示の遅いページのコンポーネントを特定する方法

- G.4.5 表示の遅いページ・リクエストをトラブルシューティングする方法

- G.4.6 JRockitフライト記録を使用してリクエストをトラブルシューティングする方法

- G.5 My Oracle Supportを使用してその他のトラブルシューティング情報を得る

- G.6 WebCenter Portalワークフローのトラブルシューティング

- G.6.1 WebCenter Portalワークフローの構成の検証

- G.6.2 WebCenter Portalワークフローの問題のトラブルシューティング

- G.7 WebCenter Portalのインポートおよびエクスポートのトラブルシューティング

- G.7.1 ResourceLimitExceptionの問題

- G.7.2 LockRefreshTaskの問題

- G.7.3 ポータルおよびポータル・テンプレートがインポート後に使用できない

- G.7.4 ソース・アプリケーションとターゲット・アプリケーションが同じContent Serverを共有している場合は、ポータルまたはドキュメントを移行できない

- G.8 個別のポータルとポータル・テンプレートのインポートおよびエクスポートのトラブルシューティング

- G.8.1 エクスポートまたはインポートの失敗後にポータルがブロックされる

- G.8.2 インポート後にページまたはポータルが見つからないというメッセージが表示される

- G.8.3 ポータル・インポート・アーカイブが最大ファイル・アップロード・サイズを超えている

- G.8.4 エクスポート時にポータルの最大数を超える

- G.8.5 リストが適切にインポートされない

- G.8.6 ツールとサービスが構成されているポータルのエクスポートおよびインポート

- G.8.7 インポート後にツールとサービスが無効化される

- G.8.8 サブポータル・ページからのインポート

- G.8.9 ソース・アプリケーションとターゲット・アプリケーションが同じContent Serverを共有している場合は、ポータルをインポートできない

- G.8.10 マルチバイト言語でのポータルのエクスポートおよびインポート

H FrameworkFoldersへのFolders_gの移行

- H.1 FrameworkFoldersへのFolders_gの移行の理解

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

- H.3 別個のContent Serverに接続されているWebCenter PortalおよびPortal Frameworkアプリケーションの移行

- H.3.1 FrameworkFoldersへのWebCenter Portalメタデータの移行

- H.3.2 FrameworkFoldersへのPortal Frameworkアプリケーションの移行

- H.4 同じContent Serverに接続されているWebCenter PortalおよびPortal Frameworkアプリケーションの移行

- H.4.1 WebCenter PortalおよびPortal Frameworkアプリケーションのメタデータの移行

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

I WebCenter PortalへのPortal Frameworkアプリケーションの移行

- I.1 WebCenter PortalへのPortal Frameworkアプリケーションの移行について

- I.2 移行ロードマップ

- I.2.1 デフォルト以外の場所からMDSへのページのインポート

- I.2.2接続を移行するためのmigrateFrameworkApplicationConnectionsの実行

- I.2.3 migrateFrameworkApplicationToWebCenterを実行したPortal Frameworkアプリケーションの移行

- I.2.4 カスタム・タスク・フローの移行

- I.2.5 静的リソースの移行

- I.2.6 SQLデータ・コントロールの移行

- I.2.7 ドキュメントの移行

- I.2.8 お知らせおよびディスカッションの移行

- I.3 Portal Frameworkアプリケーション移行の詳細

- I.3.1 ページ

- I.3.2 アセット

- I.3.3 リスト

- I.3.4 ピープル・コネクション

- I.3.5 ポートレット

- I.3.6 リンクおよびタグ

- I.3.7 アクティビティ・ストリーム

- I.3.8 セキュリティ

- I.4 Portal Frameworkアプリケーション移行の問題のトラブルシューティング

- I.4.1 ページ定義ファイルがないために移行されなかったページ

- I.4.2 移行後にレンダリングしないページ・テンプレート

- I.4.3 接続エラーのためにタスク・フローにアクセスできない

- I.4.4 移行されなかったページ

- I.4.5 指定した移行ディレクトリにアクセスできない

はじめに

Oracle WebCenter Portalの管理へようこそ。

対象読者

このドキュメントは、Oracle WebCenter Portalのインストールを担当するシステム管理者を対象としています。

このガイドでは、読者が管理者ガイドに記述された概念および内容について理解していることを前提としています。

ドキュメントのアクセシビリティについて

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

サポートをご購入のOracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs(聴覚障害者向け)を参照してください。

関連ドキュメント

詳細は、Oracle Fusion Middleware 11gリリース1 (11.1.1.9.0)のドキュメント・セットに含まれる次のドキュメントを参照してください。

- 管理者ガイド

- Oracle WebCenter Portalインストレーション・ガイド

- Oracle WebCenter Portalの使用

- Oracle WebCenter Portalによるポータルの作成

- Oracle WebCenter PortalおよびOracle JDeveloperによるポータルの開発

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

新機能

次のトピックでは、Oracle WebCenter Portal 11gリリース1の新機能や変更された機能について紹介し、詳細情報へのリンクを提供します。

- システム要件と仕様

- 11g リリース1 (11.1.1.9.0)の新機能と変更機能

- 11g リリース1 (11.1.1.8.3)の新機能と変更機能

- 11gリリース1 (11.1.1.8.0)の新機能と変更された機能

システム要件と仕様

11gリリース1のOracle Fusion Middleware製品のシステムおよびプラットフォーム固有の情報は、Oracle Fusion Middlewareシステム要件と仕様を参照してください。ガイドでは、動作保証の内容を確認する方法と動作保証の要件を確認する方法について説明します。システム管理者として、Oracle WebCenter Portalをインストールする前に、これらのタスクを実行します。

11g リリース1 (11.1.1.9.0)の新機能と変更機能

多くのバグ修正に加えて、WebCenter Portal 11gリリース1 (11.1.1.9.0)には、次の新機能および変更された機能が含まれています。

- ローカル環境およびクラウド環境の両方でWebCenter Portalを実行するためのサポート:

- オンプレミス・ポータル: 顧客データ・センターのWebCenter Portalデプロイメント。

- Oracle Private Cloud: Oracle MWaaSでのWebCenter Portalのプロビジョニングおよび実行(つまり、Oracle EM Cloud Controlの使用)。

- Oracle Public Cloud: Oracle Java Cloud Service (JCS)でのWebCenter Portalのプロビジョニングおよび実行。

- Folders_g folderサービスからFrameworkFoldersフォルダ・サービスにWebCenter PortalおよびPortal Frameworkアプリケーション・コンテンツを移行するためのサポート。付録H「FrameworkFoldersへのFolders_gの移行」を参照してください。

- Portal FrameworkアプリケーションをポータルとしてWebCenter Portalに移行するためのサポート。付録I「WebCenter PortalへのPortal Frameworkアプリケーションの移行」を参照してください。

- 11.1.1.8.0以前のポータルを現在のリリースにアップグレードするためのサポート。『Oracle WebCenter Portalでのポータルの構築』の11.1.1.8.0以前のポータルのアップグレードに関する項を参照してください。

- Show Detail Frameコンポーネントの子(コンテンツ)を作成する場合に指定するShow Detail FrameコンポーネントのchildCreationプロパティの追加により、処理時間が削減されます。『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』のShow Detail Frameコンポーネントの属性の表の「childCreation」を参照してください。

- コンテンツ・プレゼンタ表示テンプレートのイメージ・レンディションのサポート。『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』のコンテンツ・プレゼンタ表示テンプレートのイメージ・レンディションの使用に関する項を参照してください。

11g リリース1 (11.1.1.8.3)の新機能と変更機能

WebCenter Portal 11gリリース1 (11.1.1.8.3)の新機能と変更された機能は次のとおりです。

- 既存のページ・テンプレートと比較して効率とパフォーマンスの向上を実現した、4つの新しいページ・テンプレートのサポート。「新しいページ・テンプレート」を参照してください。

- Folders_gのかわりとして、Oracle WebCenter Contentからスケーラブルで高パフォーマンスのフォルダ・サービスを提供する、FrameworkFoldersコンポーネントのサポート。「FrameworkFoldersのサポート」を参照してください。

新しいページ・テンプレート

4つの新しいページ・テンプレートでは、既存のページ・テンプレートと比較して効率とパフォーマンスの向上を実現します。ファイルの内容は次のとおりです。

- 4つのページ・テンプレート: Skyrosサイド・ナビゲーションv2、Skyrosサイド・ナビゲーション(ストレッチ) v2、Skyrosトップ・ナビゲーションv2およびSkyrosトップ・ナビゲーション(ストレッチ) v2

- 1つのスキン: Skyros v2
これは、新しいページ・テンプレートの優先スキンです。既存のページ・テンプレートで、新しいSkyros v2スキンを使用しないでください。同様に、新しいページ・テンプレートで、既存のスキンを使用しないでください。

- 2つのタスク・フロー: ポータル・サイド・ナビゲーションおよびポータル・トップ・ナビゲーション
これらのタスク・フローは、ポータルの横側のペインまたは上部タブのいずれかとしてページ・テンプレートでナビゲーションを実装します。これらのタスク・フローのナビゲーションのスタイルは、このパッチで使用できるスキン・ファイルのCSSに依存します。別のスキンを使用しているページ・テンプレートでこれらのタスク・フローを使用する場合は、スキンでのCSSの不一致により、ナビゲーションが予期したとおりに表示されないことがあります。ただし、ナビゲーション・セクションを、新しいSkyros v2スキン・ソース・コードから現在のスキン・コード・ソースにコピーして貼り付けた場合は、予期した結果が得られます。

WebCenter Portal 11gリリース1 (11.1.1.9.0)では、これらのファイルが事前にインストールされ、AdministratorまたはApplication Specialistロールの権限を持つ場合に使用できる「共有アセット」ページに表示されます。

アセット・タイプ

ファイル名

ページ・テンプレート

pageTemplate_Skyros_Side_Navigation_Stretch_v2.ear
pageTemplate_Skyros_Side_Navigation_v2.ear

pageTemplate_Skyros_Top_Navigation_Stretch_v2.ear

pageTemplate_Skyros_Top_Navigation_v2.ear

スキン

skin_Skyros_v2_Skin.ear

タスク・フロー

taskFlow_Portal_Side_Navigation.ear
taskFlow_Portal_Top_Navigation.ear

次の手順を実行して、新しいページ・テンプレートを使用します。

1. ホーム・ポータルおよびすべての新しいポータルのページで、新しいデフォルト・ページ・テンプレートを設定するには(ポータルのテンプレートで、特定のページ・テンプレートを使用するように指定していない場合)、第43.3.1項「デフォルト・ページ・テンプレートの選択」を参照してください。

2. 個々のポータルで使用するページ・テンプレートを変更するには、『Oracle WebCenter Portalでのポータルの構築』のポータルのページ・テンプレートの変更に関する項を参照してください。

3. ページ・テンプレートで使用する優先スキンを変更するには、『Oracle WebCenter Portalでのポータルの構築』のページ・テンプレートの優先スキンの設定に関する項を参照してください。

詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・テンプレートでの作業に関する章および『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』のページ・テンプレートの開発に関する章を参照してください。

FrameworkFoldersのサポート

以前のOracle WebCenter Portalでは、Folders_gのみがサポートされていました。WebCenter Portal 11gリリース1 (11.1.1.8.3)では、Oracle WebCenter Portalの新しいインストールをFrameworkFoldersと統合できます。11gリリース1 (11.1.1.8.3)にパッチを適用したOracle WebCenter Portalの既存のインストールでは、引き続きFolders_gを使用する必要があります。

FrameworkFoldersコンポーネントは、リポジトリ・コンテンツにアクセスして整理するためのスケーラブルな階層フォルダ・インタフェースを提供する、Content Serverの推奨されるエンタープライズ・フォルダ・サービスです。

11gリリース1 (11.1.1.8.0)の新機能と変更された機能

WebCenter Portal 11g リリース1 (11.1.1.8.0)の新機能と変更された機能は次のとおりです。

- 用語の変更:

以前のリリース

11g リリース1 (11.1.1.8.0)

WebCenter Portal: Spaces

WebCenter Portal

スペース

ポータル

スペース・テンプレート

ポータル・テンプレート

リソース

アセット

- エンドユーザーのエクスペリエンス

- プロファイル情報の編成機能、クリックによる編集機能およびプロファイル写真の削除機能の向上を含む、プロファイルのユーザー・インタフェースの更新。『Oracle WebCenter Portalの使用』の「プロファイルの管理」を参照してください。多機能なユーザー・プロファイルに関する追加のドキュメントについては、「ポータル・ビルダー」、「管理」および「開発環境」を参照してください。

- ファセット検索とドキュメントのサムネイルを含む検索エクスペリエンスの向上(Oracle SES 11.2.2.2によりサポート)。『Oracle WebCenter Portalの使用』の「情報の検索」を参照してください。

- ポータル・ビルダー

- インプレースのページ作成を含むポータル作成の簡易化。『Oracle WebCenter Portalでのポータルの構築』の「新規ポータルの作成と構築」を参照してください。

- 再設計されたポータル編集および管理のユーザー・インタフェース(ポータル・ビルダー)。複数のタスクを少数の手順に統合しています。『Oracle WebCenter Portalでのポータルの構築』の「ポータルの編集」および「ポータルの管理」を参照してください。

- ページ作成および編集の簡易化。Webビュー(編集用)とデータ・ビュー(管理用)、インライン・リソース・カタログ(コンポーネントのページへのドラッグ・アンド・ドロップをサポート)、および選択ビュー。『Oracle WebCenter Portalでのポータルの構築』のポータル・ページの操作に関する部分を参照してください。

- 新しいページが作成されたときのポータル・ナビゲーションの自動更新。『Oracle WebCenter Portalでのポータルの構築』の既存のポータルでのページまたはサブページの作成に関する項を参照してください。

- ツールの遅延プロビジョニング。WebCenter Portalは、ポータルの作成時ではなく、ツールの初回使用時にバックエンド・サーバーを構成して、新しいポータルの正常な作成を短期化します。『Oracle WebCenter Portalでのポータルの構築』の新規ポータルの作成の概要に関する項を参照してください。

- 階層ページのサポート(サブページ)。『Oracle WebCenter Portalでのポータルの構築』のポータルでのページまたはサブページの作成に関する項を参照してください。

- 複数のプロファイル(OSN、HCM、LDAPなど)からの情報を統合するリッチ・ユーザー・プロファイルを使用できるようになりました。『Oracle WebCenter Portalでのポータルの構築』の「ポータルへのプロファイルの追加」の章を参照してください。多機能なユーザー・プロファイルに関する追加のドキュメントについては、「エンドユーザー・エクスペリエンス」、「管理」および「開発環境」を参照してください。

- デバイス設定。各種デバイス(スマート・フォン、タブレット、デスクトップのブラウザ)でのポータル・ページのレンダリング方法を制御します。ページ・バリアントは、特定のデバイスのグループ(iOSフォン、iOSタブレットなど)を対象にして、ポータルが最適にレンダリングされるように作成できます。『Oracle WebCenter Portalでのポータルの構築』のポータルでのデバイス設定の管理に関する項、「ポータルのデバイス・グループの管理」およびデバイス・グループごとのページ・バリアントの作成に関する項を参照してください。モバイル・サポートに関する追加のドキュメントについては、「管理」および「開発環境」を参照してください。

- レスポンシブなコンテンツ・プレゼンタのテンプレート。コンテンツ・プレゼンタとCSS3メディア問合せを使用して、ブラウザ(スマート・フォン、タブレット、デスクトップのブラウザなど)の幅に合せてレスポンシブ・レイアウトを作成する例を示します。『Oracle WebCenter Portalでのポータルの構築』のレスポンシブ・テンプレートの使用に関する項を参照してください。モバイル・サポートに関する追加のドキュメントについては、「開発環境」を参照してください。

- 管理

- WebCenter Portal管理の簡易化。従来のWebCenter Portalの顧客にとってなじみのある概念を取り入れた、パワー・ユーザー指向のエクスペリエンスが含まれます。第I部「ポータル・ビルダー管理におけるポータルの管理」を参照してください。

- 複数のプロファイル(OSN、HCM、LDAPなど)からの情報を統合するリッチ・ユーザー・プロファイルを使用できるようになりました。詳細は、第16章「ピープル・コネクションの管理」を参照してください。リッチ・ユーザー・プロファイルの追加のドキュメントについては、「エンドユーザーのエクスペリエンス」、「ポータル・ビルダー」および「開発環境」に参照先が示されています。

- デバイス設定。各種デバイス(スマート・フォン、タブレット、デスクトップのブラウザ)でのポータル・ページのレンダリング方法を制御します。ページ・バリアントは、特定のデバイスのグループ(iOSフォン、iOSタブレットなど)を対象にして、ポータルが最適にレンダリングされるように作成できます。詳細は、第40.4項「デバイスおよびデバイス・グループのデプロイ」、第50.2.2「デバイス・グループのシステム・ページのページ・バリアントの作成」および第53章「デバイス設定の管理」を参照してください。モバイル・サポートの追加のドキュメントについては、「ポータル・ビルダー」および「開発環境」に参照先が示されています。

- 偽装。権限付与されたユーザーは、WebCenter Portalでの他のユーザーのエクスペリエンスを確認したり、予期しない結果のトラブルシューティングのために別のユーザーを偽装できます。第38章「偽装の管理」を参照してください。

- ポータルのライフサイクル・ツールの向上。最小のダウンタイムで1つ以上のポータルをエクスポート/インポートおよびバックアップ/リカバリできます。第40章「ポータル、テンプレート、アセットおよび拡張機能のデプロイ」および第41章「WebCenter Portalのバックアップ、リカバリおよびクローニングの管理」を参照してください。

- WebCenter Portalの管理ユーザー・インタフェース内に統合されたOracle WebCenter Portalのページレット・プロデューサ・ユーザー・インタフェース。これにより、システム管理者はページレット・プロデューサのページレットの存在を認識するようになり、それらのページレットをエンド・ユーザーが使用できるようにすることが可能になります。また、これらのUIの統合により、ページレット・プロデューサの開発者は、ページレットを表示するWebCenter Portalから、ページレット・プロデューサの管理UIに簡単に移動して、新しいページレットの作成や既存のページレットの編集ができます。第22章「ページレット・プロデューサの管理」を参照してください。

- 新しいPage Performance Analyzer。ポータル・ページに個々のコンポーネントを表示するのにかかった時間、および1つのページを表示するのにかかった全体時間を示します。この新しいツールは、第1レベルのパフォーマンス分析を実行する開発者、独自のページを構築する顧客、およびWebCenter Portalでページをカスタマイズするユーザーにとって有用な機能です。第G.4.4項「表示の遅いページのコンポーネントを特定する方法」を参照してください。

- 開発環境

- 複数のプロファイル(OSN、HCM、LDAPなど)からの情報を統合するリッチ・ユーザー・プロファイルを使用できるようになりました。『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』の「ピープル・コネクションの使用」の部を参照してください。多機能なユーザー・プロファイルに関する追加のドキュメントについては、「エンドユーザー・エクスペリエンス」、「ポータル・ビルダー」および「管理」を参照してください。

- 開発者は、式言語(EL)を使用してデバイス設定に関する情報を取得できます。デバイス設定では、各種デバイス(スマート・フォン、タブレット、デスクトップのブラウザ)でのポータル・ページのレンダリング方法を正確に制御します。『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』のデバイス設定に関連するEL式に関する項を参照してください。モバイル・サポートに関する追加のドキュメントについては、「ポータル・ビルダー」および「管理」を参照してください。

- レスポンシブなコンテンツ・プレゼンタのテンプレート。コンテンツ・プレゼンタとCSS3メディア問合せを使用して、ブラウザ(フォン、タブレット、パーソナル・コンピュータなど)の幅に合せてレスポンシブ・レイアウトを作成する例を示します。『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のレスポンシブ・テンプレートの使用に関する項およびレスポンシブ・テンプレートの拡張に関する項を参照してください。モバイル・サポートに関する追加のドキュメントについては、「ポータル・ビルダー」を参照してください。

- カスタム共有ライブラリの開発とデプロイメントの簡易化。WebCenter Portalに用意された新しいJDeveloperテンプレートを使用すると、タスク・フロー、データ・コントロール、マネージドBeanなどのカスタム・コンポーネントを作成して、共有ライブラリとしてWebCenter Portalサーバーに直接デプロイできます。『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「JDeveloperを使用したWebCenter Portalのコンポーネントの開発」を参照してください。

- 各担当者と、WebCenter Portalでの各担当者の役割に応じて再構築されたドキュメント・ライブラリ。

- 『Oracle WebCenter Portalの管理』(このガイド)は、システム管理者が必要とする情報を提供しますが、システム管理者は、IT担当者やビジネス・ユーザーからの要求に応じて新しいマシンを設定し、既存のアプリケーションのシステムとデータベースをクローニングまたはバックアップし、さらには、パッチ、パッケージおよびアプリケーションをインストールして、その他の管理に関連する作業を実行します。

- 『Oracle WebCenter Portalの使用』は、一般的にWebCenter Portalを使用して、コンテンツの提供およびレビューを行ったり、社会的な交流に参加したり、ホーム・ポータルを利用して独自のドキュメントやプロファイルを管理するナレッジ・ワーカーが必要とする情報を提供します。

- 『Oracle WebCenter Portalでのポータルの構築』には、アプリケーション・スペシャリストが必要とする情報が記載されています。アプリケーション・スペシャリストは、ポータル・ビルダーを使用して、ポータル、その構造(ページの階層、ナビゲーション、セキュリティ)、およびそのコンテンツ(ページ上のコンポーネント、レイアウト、動作など)を作成および管理します。

- 『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』には、開発者が必要とする情報が記載されています。開発者は、主にJDeveloperを使用して、ポータルとWebCenter Portal Frameworkアプリケションの両方に対するサポートを提供します。

詳細は、「登場人物リスト」を参照してください。

登場人物リスト

WebCenter Portalドキュメントは、特定のガイドのタスクが特定の仮想の人物に対応するように整理されています。各人物は、WebCenter Portalで作業をするのに必要なスキルのセット(基礎的なスキルから高度なスキルまで)に関連付けられています。たとえば、このガイドは、システム管理者という人物を対象としています。

この「はじめに」では、WebCenter Portalに登場する仮想の人物を紹介し、その人物がWebCenter Portalを操作する方法について説明します。各人物には、WebCenter Portalで提供されるすぐに使用できるデフォルトのロールが割り当てられています。デフォルトのロールには、各人物が通常実行する業務に適した一意の権限セットが付与されています。これらのデフォルトのロールを変更したり、組織独自のニーズに合うように新しいロールを構成することができることに注意してください。

通常、WebCenter Portalを操作する人々は、次の人物で構成されたチームとして共同で作業します。

- ナレッジ・ワーカー

- アプリケーション・スペシャリスト

- Web開発者

- 開発者

- システム管理者

ナレッジ・ワーカー

Karenは、ナレッジ・ワーカーです。一般に、ナレッジ・ワーカーはWebCenter Portalを使用してコンテンツを提供および確認し、ソーシャルの対話に参加します。また、ホーム・ポータルを利用して、自分のドキュメントとプロファイルを管理します。

アプリケーション・レベルでのKarenの権限は、デフォルトのAuthenticated-Userロールに付与されるような権限になります。このロールは、組織に固有のニーズに応じてカスタマイズされることがあります。ポータル・レベルでは、Karenには、ポータルのModeratorがViewerまたはParticipantロールを割り当てるか、同様の権限のセットを提供するカスタム・ロールを割り当てると考えられます。

ロールと権限の詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルのロールと権限の概要に関する項を参照してください。

WebCenter Portalでのナレッジ・ワーカーのタスク

次に、Karenのようなナレッジ・ワーカーの一般的なタスクを示します。

- 情報、ファイル、リンクを共有し、インスタント・メッセージ、メール、メッセージ・ボード、ディスカッション、Wikiおよびブログを通じて対話することで、他のWebCenter Portalユーザーとのコネクションを持ってコラボレーションします。

- コンテンツ・サーバーに格納されるドキュメントをアップロード、共有および管理します。

- チームまたはプロジェクトのポータルに参加します。

- コンテンツが更新された際の通知の受信、他のユーザーからの推奨の調査、所属するポータルのアクティビティとコネクションのあるユーザーのアクティビティの確認、お知らせの確認、投票の実施、およびWebCenter PortalのRSSフィードのモニタリングによりWebCenter Portalの変更に対応します。

- お気に入り、ノート、カレンダー、リスト、ポータルのオブジェクトへのリンク、およびタグを使用して編成状態を維持します。

- ワークリスト・アイテムを表示して対応します。

Karenは、WebCenter Portalの使用可能な機能に精通するにつれ、ポータル作成のような高度なタスクを実行できるようになります。より高度なナレッジ・ワーカーとして、彼女の役割はアプリケーション・スペシャリストのタスクと重複するようになります。

Karenのようなナレッジ・ワーカーを対象にした情報は、『Oracle WebCenter Portalの使用』に記載されています。アプリケーション・スペシャリストのタスクと重複する高度なタスクの説明は、『Oracle WebCenter Portalでのポータルの構築』に記載されています。

アプリケーション・スペシャリスト

Ariは、アプリケーション・スペシャリストです。アプリケーション・スペシャリストは、ポータル・ビルダーを使用して、ポータル、その構造(ページの階層、ナビゲーション、セキュリティ)、およびそのコンテンツ(ページ上のコンポーネント、レイアウト、動作など)を作成および管理します。一般的なプロジェクトでは、Ariは、Karen (ナレッジ・ワーカー)、Wendy (Web開発者)、およびDave (開発者)の成果物を統合します。

アプリケーション・レベルでのAriの権限は、デフォルトのApplication Specialistロールに付与されるような権限になります。このロールは、組織に固有のニーズに応じてカスタマイズされていることがあります。Ariが作成するポータルでは、Ariは、Moderatorロールが使用できるアクションを実行してポータルを管理します。

ロールと権限の詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルのロールと権限の概要に関する項を参照してください。

WebCenter Portalでのアプリケーション・スペシャリストのタスク

次に、Ariのようなアプリケーション・スペシャリストの一般的なタスクを示します。

- 新しいポータルを計画して作成します。

- 自分の所有するポータルを編集および管理します。

- ページ・エディタ(コンポーザ)を使用してポータルのページを作成および構築し、リソース・カタログを使用してページのコンポーネントを追加および構成します。

- ポータルのアセット、ツールおよびサービスを作成して管理します。

- すべてのポータル間で共有されるアセットとポータル・テンプレートを管理します。

Ariのようなアプリケーション・スペシャリストを対象にした情報は、『Oracle WebCenter Portalでのポータルの構築』に記載されています。ホーム・ポータルの個人用ビューを使用するために、Ariは『Oracle WebCenter Portalの使用』も参照することになります。

Web開発者

Wendyは、Web開発者です。Web開発者は、一貫性のあるブランド付けされたルック・アンド・フィールをすべてのポータルで実現します。Wendyは、グラフィック・デザインとHTMLマークアップを用意します。Ari (ポータル・ビルダーのアプリケーション・スペシャリスト)またはDave (JDeveloperの開発者)は、これらを基にしてコンテンツやページ・スタイルのテンプレート、スキンなどを作成します。これらのアセットが作成されると、Ariは、これらを活用してポータルのページを作成します。一般に、Wendyが直接WebCenter Portalを操作することはありません。

WebCenter PortalでのWeb開発者のタスク

次に、WendyのようなWeb開発者の一般的なタスクを示します。

- 企業ポータルのルック・アンド・フィールを開発します。

- 新しいポータル・ページのテンプレートをデザインします。

WendyのようなWeb開発者を対象にした情報は、『Oracle WebCenter Portalでのポータルの構築』の「ポータルのルック・アンド・フィールの作成」に記載されています。

開発者

Daveは、開発者です。開発者は、ポータルとWebCenter Portal Frameworkアプリケーションの両方にサポートを提供します。

- ポータル(ポータル・ビルダー)
Daveは、主にコンポーネント(タスク・フロー、ページ・テンプレート、コンテンツ・テンプレートなど)の開発を担当します。これらは、Ari (アプリケーション・スペシャリスト)によって公開および利用されます。デイブは主にJDeveloperで作業し、WebCenter Portal拡張/WebCenter Portalサービス拡張プロジェクトを利用します。

- Frameworkアプリケーション
Daveは、主にJDeveloperで作業して、WebCenter Portal Frameworkアプリケーションを開発します。アプリケーションの開発が完了すると、そのアプリケーションを、EARファイルとしてパッケージ化して、アプリケーション・サーバーにデプロイできます。一般的な環境では、DaveはSCMシステムが構成されたJDeveloperを使用し、自動化されたビルドおよびデプロイのプロセスを使用するチーム内で作業します。

開発者のタスク

次に、Daveのような開発者の一般的なタスクを示します。

- WebCenter Portal Frameworkアプリケーションを構築およびメンテナンスします。

- カスタム・アセット(WebCenter Portal内のポータル用のページ・テンプレートやナビゲーション・コンポーネントなど)を開発します。

- Javaポートレットを開発します。

- タスク・フロー、マネージドBean、およびその他のコンポーネントを開発してデプロイします。

- カスタムのパーソナライズ・コンポーネントを開発します。

- ソース・コントロール システムをメンテナンスします。

- ビルド・システムをメンテナンスします。

Daveのような開発者を対象にした情報は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』に記載されています。

システム管理者

Syedは、システム管理者です。システム管理者は、IT担当者やビジネス・ユーザーからの要求に応じて新しいマシンを設定し、既存のアプリケーションのシステムとデータベースをクローニングまたはバックアップします。また、パッチ、パッケージおよびアプリケーションをインストールし、その他の管理に関連する作業を実行します。Syedはシステム管理者として、別のツール(Fusion Middleware Controlやコマンド行ツールなど)を使用します。Enterprise Managerを利用して、ポータルの設定を構成します。また、WebCenter Contentやその他のFusion Middleware製品、およびOracleアプリケーションの統合も構成します。

WebCenter Portalのポータル・ビルダーでは、デフォルトのAdministratorロールに付与されるような権限を持ちます。これは、すべてのポータル(ホーム・ポータルを含む)のグローバル・オプションを管理および設定するための排他的アクセスを提供します。

アプリケーション・レベルのロールと権限の詳細は、『Oracle WebCenter Portalの管理』の「アプリケーション・ロールおよび権限について」を参照してください。

システム管理者のタスク

次に、Syedのようなシステム管理者の一般的なタスクを示します。

- ポータル・ビルダー管理を使用して、すべてのポータル(ポータルのインポートとエクスポートを含む)とサイト全体のセキュリティを管理します。

- ポータル・ビルダー管理を使用して、サイト全体のシステムのページ、ビジネス・ロールのページ、および個人用のページを管理します。

- Portal Frameworkアプリケーションの管理コンソールを使用して、アプリケーション全体のプリファレンスの管理、ユーザーとロールの管理、アセットの管理、コンテンツ・リポジトリの構成、投票の作成、およびプロデューサと外部アプリケーションの登録を実行します。

- セキュリティ、分類、メタデータ、ワークフロー、ガバナンスを主導します。

- 管理機能の管理コンソールを使用します。

- 管理機能のコマンド行ユーティリティを実行します。

- 開発者の成果物の本番バージョンをインストールおよび構成します。

- 本番バージョンおよびオペレーティング・システムにパッチを適用します。

- 本番バージョンのクローンおよびバックアップを作成します。

- 本番バージョンのリストアを実行します。

- 本番バージョンに関する問題についてオペレーティング・システムをモニターします。

- アプリケーションをデプロイおよび再デプロイします。

Syedのようなシステム管理者を対象にした情報は、『Oracle WebCenter Portalの管理』および『WebLogic Scripting Toolコマンド・リファレンス』に記載されています。

第I部

Oracle WebCenter Portalの概要

『Oracle WebCenter Portalの管理』のこの部では、Oracle WebCenter Portalとその管理ツールの概要について説明します。

第I部の内容は次のとおりです。

- 第1章「Oracle WebCenter Portalの管理の概要」

1 Oracle WebCenter Portalの管理の概要

この章では、Oracle WebCenter Portalおよび管理ツールの概要を示します。

この章には次のトピックが含まれます:

- 第1.1項「Oracle WebCenter Portalの概要」

- 第1.2項「Oracle WebCenter Portalのアーキテクチャ」

- 第1.3項「Oracle WebCenter Portalのトポロジ」

- 第1.4項「WebCenter Portal」

- 第1.5項「Portal Frameworkアプリケーション」

- 第1.6項「Oracle WebCenter Portalのインストールの計画」

- 第1.7項「Oracle WebCenter Portal 11gのインストールの理解」

- 第1.8項「管理操作、ロールおよびツールの理解」

- 第1.9項「パフォーマンスのモニタリングおよび診断」

- 第1.10項「セキュリティの理解」

- 第1.11項「WebCenter Portalアプリケーションのデプロイ」

- 第1.12項「データの移行、バックアップおよびリカバリ」

- 第1.13項「Oracle WebCenter Portalの管理ツール」

『Oracle WebCenter Portalの管理』は、特にOracle WebLogic Server (Oracle WebCenter PortalなどのOracle Fusion Middlewareソフトウェア・コンポーネントのためのプライマリ・プラットフォーム)向けに記述されています。IBMのWebSphereなどのオラクル社以外のベンダーが提供するサード・パーティ製のアプリケーション・サーバーを使用している場合は、サード・パーティ・アプリケーション・サーバー・ガイドを参照してください。

1.1 Oracle WebCenter Portalの概要

Oracle WebCenter Portalへようこそ。

Oracle WebCenter Portalは、標準ベースの、サービス指向アーキテクチャの上に構築された、統合された一連のコンポーネントであり、ソーシャル・アプリケーション、エンタープライズ・ポータル、コラボレイティブ・コミュニティおよびコンポジット・アプリケーションを作成できます。Oracle WebCenter Portalは、機能豊富なインターネット・アプリケーション、統合されたマルチチャネルのポータル・フレームワークの柔軟性と力、およびコンテンツ、コラボレーション、プレゼンスおよびソーシャル・ネットワーキング機能を実現する一連のツールとサービスを開発するために、動的なユーザー・インタフェース・テクノロジを結合します。これらのコンポーネントを基に、Oracle WebCenter Portalは、個人およびグループがより効果的に作業およびコラボレーションできる構成可能な作業環境とともに、WebCenter Portalと呼ばれる、すぐに利用できる、エンタープライズ対応のカスタマイズ可能なアプリケーションも提供します。

Oracle WebCenter Portalは、ポータルまたはアプリケーションのコンテキスト内から、インスタント・メッセージ、ドキュメント、コンテンツ管理、ディスカッション・フォーラム、Wiki、ブログ、およびタグ付けなどのツールとユーザーが直接対話できる、オープンで拡張可能なソリューションを提供します。これらのツールおよびサービスは、エンド・ユーザーおよびITに、次世代のコラボレイティブなアプリケーションおよびポータルの構築およびデプロイを可能にします。

この項では、Oracle WebCenter Portalのコンポーネントおよびアーキテクチャについて説明します。この項の内容は次のとおりです。

- 第1.2項「Oracle WebCenter Portalのアーキテクチャ」

- 第1.3項「Oracle WebCenter Portalのトポロジ」

- 第1.4項「WebCenter Portal」

- 第1.5項「Portal Frameworkアプリケーション」

1.2 Oracle WebCenter Portalのアーキテクチャ

Oracle WebCenter Portalは、次のコンポーネントで構成されています(図1-1)。

- WebCenter Portal Framework

- Application Development Framework

- WebCenter Portal

- ツールとサービス

- コンポーザ

- ディスカッション・サーバー

- 分析

- アクティビティ・グラフ

- パーソナライズ・サーバー

- ポータル

- コンポジット・アプリケーション

図1-1 Oracle WebCenter Portalのアーキテクチャ

1.2.1 WebCenter Portal Framework

次のものを含むポータル機能をADFに挿入します。

- ランタイム・アプリケーションのカスタマイズ(アプリケーションを再デプロイすることなく、コンポーザを使用してWebCenter PortalおよびPortal Frameworkアプリケーションにインプレース変更を行うことができます)

- JSR-168およびJSR-286標準ベースのWSRPポートレット、およびPDK-Javaポートレットのサポート

- Oracle WebCenter Content ServerおよびOracle Portalなどのコンテンツ・リポジトリへの、JCR (JSR170)を介したコンテンツ統合

- JSFページおよびOracle ADFタスク・フローを標準ベースのポートレットとして公開できる、Oracle JSF Portlet Bridge

1.2.2 Application Development Framework

Oracle Application Development Framework (ADF)は、JSFの上に存在する生産性レイヤーであり、次のものを提供します。

- データベース、Webサービス、XML、CSV、BPELなどのバックエンドへの統合されたアクセス

- バックエンドのデータ制御によりユーザー・インタフェースに接続する、データ・バインディング(JSR 227)

- 100個を超えるデータ認識JSFビュー・コンポーネント

- タスク・フローを含むネイティブ・コンポーネント・モデル

- ファイングレインJAASセキュリティ・モデル

1.2.3 コンポーザ

コンポーザは、次のものを提供します。

- ブラウザでランタイム・アプリケーションおよびインプレースのユーザー・カスタマイズを実行する能力

- 次のことが行える、機能豊富で直観的なユーザー・エクスペリエンス

- タスク・フローおよびポートレットなど、リソースの参照およびページへの追加

- ページ・レイアウトの再配置

- ページおよびコンポーネント・プロパティの設定

- 前後関係によるコンポーネントの関連付け

1.2.4 WebCenter Portal

JSF、Oracle ADF、WebCenter Portal Framework、WebCenter Portalのツールとサービス、およびコンポーザを使用して構築された、即時利用可能なアプリケーション。

WebCenter Portalは、次のものを提供します。

- エンタープライズ・ポータル、複数のサイト、およびコミュニティを作成するためのブラウザ・ベースのプラットフォーム

- ユーザーごとのホーム・ポータル(個人コンテンツを格納するためのプライベートな作業領域の提供、ビジネス・プロセスの割当ての表示および応答、電子メールの送受信など)

- スレッドで構成されるディスカッション、ブログ、Wiki、ワークリスト、お知らせ、RSS、最近のアクティビティ、検索など

1.2.5 ツールとサービス

表1-1に、WebCenter PortalおよびPortal Frameworkアプリケーションで使用可能なサービスとツールの一覧を示します。

表1-1 WebCenter Portalのツールとサービス

AからNまでのサービス

PからWまでのサービス

アクティビティ・グラフ

ノート脚注 1

分析

ピープル・コネクション

お知らせ

パーソナライズ

ディスカッション

投票

ドキュメント(Wikiおよびブログを含む)

RSS脚注 2

イベント脚注参照 1

最近のアクティビティ

インスタント・メッセージおよびプレゼンス(IMP)

検索

リンク

タグ

リスト脚注参照 1

ワークリスト

メール

脚注 1 WebCenter Portalのみ。

脚注 2 RSSニュース フィードは、WebCenter Portalでのみ利用できます。RSSビューア・タスク フローは、WebCenter Portalと、その他のPortal Frameworkアプリケーションで利用できます。

WebCenter Portalのツールとサービスは、次のものを提供します。

- エンタープライズレベルのサービスとのシームレスな統合

- バックエンド・サービスを抽象化するシン・アダプタ・レイヤー。例:

- コンテンツ・アダプタ: Content ServerおよびOracle Portal

- プレゼンス・アダプタ: Microsoft Live Communications Server、Microsoft Office Communications ServerおよびMicrosoft Lync

- 統合された接続アーキテクチャによって表されるバックエンド・システム

- 機能豊富なタスク・フロー・コンポーネントによって提示されるサービスへのユーザー・インタフェース

1.2.6 ディスカッション・サーバー

ディスカッション・サーバーは、Oracle WebCenter Portalとともに提供されるため、アプリケーションにディスカッション・フォーラムおよびお知らせを統合できます。

1.2.7 分析

WebCenter Portalの分析機能により、ユーザーは、次のような様々なユーザー・アクティビティを表示できます。

- ログイン・データ

- ページ・ビュー

- ポートレット・ビュー

- ドキュメント・ビュー

- 検索メトリック

- ページ・レスポンス・データ

- ポータルの使用状況

1.2.8 アクティビティ・グラフ

アクティビティ・グラフにより、ユーザーは、WebCenter Portal分析で収集した各種の統計を分析できます。オブジェクトおよびユーザーのための様々な類似度スコアが収集され、推奨を提示するために使用されます。スコアは、アクティビティ・グラフ・データベースに格納されます。

1.2.9 パーソナライズ・サーバー

WebCenter Portalのパーソナライズ・サーバーにより、選択した条件に基づいて、対象とするユーザーにアプリケーションのコンテンツを提供できます。

1.2.10 ポータル

ポータルは、パーソナライズされた、Webベース・アプリケーションと対話できる単一の場所、および個々のユーザーまたはユーザーのクラスに関連する情報への、共通のインタフェース(Webページ)を提供します。WebCenter Portal Frameworkアプリケーション・テンプレートを使用して、JDeveloperでポータルを作成する方法の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』を参照してください。

または、初期設定のアプリケーションであるWebCenter Portalを使用して、ポータルを作成します。詳細は、『Oracle WebCenter Portalでのポータルの構築』を参照してください。

1.2.11 コンポジット・アプリケーション

コンポジット・アプリケーションは、単一のアプリケーションとして設計されデプロイされた、サービス、サービス・コンポーネント、ワイヤおよび参照の集合体です。コンポジット・アプリケーションの詳細は、『Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』を参照してください。

1.3 Oracle WebCenter Portalのトポロジ

この項では、Oracle WebCenter Portalのトポロジおよび構成について説明します。この項の内容は次のとおりです。

- 第1.3.1項「初期設定のOracle WebCenter Portalトポロジ」

- 第1.3.2項「Oracle WebCenter Portal管理対象サーバー」

- 第1.3.3項「Oracle WebCenter Portalの起動順序」

- 第1.3.4項「Oracle WebCenter Portalの依存性」

- 第1.3.5項「Oracle WebCenter Portalの構成に関する考慮事項」

- 第1.3.6項「Oracle WebCenter Portalの状態および構成の永続性」

- 第1.3.7項「Oracle WebCenter Portalのログ・ファイルの場所」

1.3.1 初期設定のOracle WebCenter Portalトポロジ

Oracle WebCenter Portalのインストールにより、Oracle Middlewareホーム・ディレクトリの下にWebCenter Portal Oracleホーム(WCP_ORACLE_HOME)が作成されます。また、WebCenter Portalのバイナリとサポート・ファイルが含まれるOracle共通ホーム・ディレクトリ(ORACLE_COMMON_HOME)が作成されます(図1-2)。

図1-2 Oracle WebCenter Portalのインストールのディレクトリ構造

また、インストールによって、様々なWebCenter Portalコンポーネントをホストする管理サーバーおよび複数の管理対象サーバーを含むWebCenter Portalドメイン(base_domain)も作成されます。図1-3では、アプリケーションは黄色で表示され、それらが実行される管理対象サーバーは茶色で表示されます。

図1-3 初期設定のWebCenter Portalトポロジ

初期設定の管理対象サーバーは、次のOracle WebCenter Portalコンポーネントをホストします。

- WC_Spaces: WebCenter Portal (Oracleの初期設定のポータル・アプリケーション)をホストします

- WC_Portlet: 初期設定のポートレット、ページレット・プロデューサ、およびWebCenter Portalサービス・プロデューサをホストします

- WC_Collaboration: ディスカッション・サーバーおよび統合のために選択した追加のサービスをホストします

- WC_Utilities: アクティビティ・グラフ、分析およびパーソナライズ・サービスをホストします

オプションの5台目の管理対象サーバー(アプリケーション・サーバー)は、WebCenter Portal Frameworkアプリケーション・テンプレートを使用して開発者がJDeveloperで構築したアプリケーションを実行するために使用できます。このようなアプリケーションは、Portal Frameworkアプリケーションと呼ばれます。追加の管理対象サーバーを作成するときに、それらのサーバーは、WebCenter Portalと同じ外部リソースを利用できるよう、適切なライブラリでプロビジョニングされます。管理対象サーバーの詳細は、管理者ガイドのOracle Fusion Middlewareの概念の理解に関する項を参照してください。

1.3.2 Oracle WebCenter Portal管理対象サーバー

Oracle WebCenter Portalのインストール時に、管理対象サーバーは、システム・ライブラリおよびOracle ADFライブラリでプロビジョニングされます。表1-2に、管理対象サーバー、およびそれらで実行するアプリケーションをリストします。

表1-2 Oracle WebCenter Portal管理対象サーバーおよびアプリケーション

管理対象サーバー

インストールされるアプリケーション

アプリケーション名

WC_Spaces

WebCenter Portal

WebCenter Portalオンライン ヘルプ

webcenter

webcenter-help

WC_Portlet

OmniPortletおよびWebクリッピング

WSRPツール

ページレット・プロデューサ

サービス・プロデューサ

portalTools

wsrp-tools

pagelet-producer

services-producer

WC_Collaboration

ディスカッション・サーバー

owc_discussions

WC_Utilities

分析コレクタ

アクティビティ・グラフ・エンジン

パーソナライズ・サービス

analytics-collector

activitygraph-engines

wcps-services

1.3.3 Oracle WebCenter Portalの起動順序

管理対象サーバーの起動時には、アプリケーションおよびライブラリは次の順序で起動されます。

1. JRFライブラリとして知られるOracleシステム・ライブラリ。

2. Oracle ADFライブラリ。

3. Oracle DMSおよびOracle Web Services Manager (wsm-pm)アプリケーションなどのインストゥルメンテーション・アプリケーション。

4. 表1-2に示したOracle WebCenter Portalアプリケーション。

起動順序は、依存の順序でもあります。依存するコンポーネントが正常にデプロイされない場合は、後のコンポーネントが正しく機能しない可能性があります。

アプリケーションの起動は、ディスカッション・サーバーまたは他のバックエンド・サーバーなどの外部サービスが使用可能かどうかには依存しません。詳細は、第1.3.4項「Oracle WebCenter Portalの依存性」を参照してください。

1.3.4 Oracle WebCenter Portalの依存性

WebCenter PortalおよびPortal Frameworkアプリケーションは、複数の外部サーバー、ツールおよびサービスを使用します(表1-3)。「構成」列に、接続を構成または初期化するためにWebCenter Portalに提供される情報のタイプをリストします。「アクセス」列には、サービスの実行時アクセスで使用されるプロトコルの一覧を示します。

表1-3 依存するリソース - アクセス・タイプ

外部サーバー、ツールまたはサービス

構成

アクセス

分析

分析コレクタへのUDPアクセス

UDP

アクティビティ・グラフ

アクティビティ・グラフ管理へのHTTPアクセス

HTTP

ディスカッション・サーバー

ディスカッション・サーバー管理へのHTTPアクセス

SOAP/HTTP

Content Server(ドキュメント)

管理サーバーへのソケット接続。WebCenter Portalの外側にあるContent Serverへのアクセスが必要な場合にのみ、HTTPアクセスが必要になります。

ソケットまたはHTTPでのJCR 1.0

インスタント・メッセージおよびプレゼンス・サーバー

インスタント・メッセージおよびプレゼンス・サーバー管理へのHTTPアクセス

SOAP/HTTP

メール・サーバー

IMAP/SMTPサーバー

IMAP/SMTP

個人イベント・サーバー

カレンダ・サービスへのHTTPアクセス

SOAP/HTTP

パーソナライズ・サーバー

パーソナライズ・サーバーへのJDBCアクセス

JDBC REST

ポートレット

プロバイダWSDLのHTTPロケーション

SOAP/HTTP

検索サーバー

検索サーバーへのHTTPアクセス

HTTP

ワークリスト

BPELサーバーへのHTTPアクセス

SOAP/HTTP

MDSおよびスキーマ

JDBC

JDBC

サーバーまたはサービスが利用できないときでも、WebCenter PortalまたはPortal Frameworkアプリケーションの起動は可能ですが、アプリケーションの実行時にエラーが表示される場合があります。唯一の例外は、Oracle Metadata Services Repository (MDS)です。MDSがない場合は、WebCenter PortalおよびPortal Frameworkアプリケーションが機能しなくなります。

WebCenter Portalは、リポジトリなしでも部分的に機能しますが、そのリポジトリがMDSリポジトリと異なる物理データベースの場合に限定されます。WebCenter Portalリポジトリには、イベント、リンク、リスト、ピープル・コネクション、投票およびタグを含む、複数のサービスのための情報が格納されます。これらのサービスは、このリポジトリが利用できない場合には機能しません。

1.3.5 Oracle WebCenter Portalの構成に関する考慮事項

WebCenter PortalおよびPortal Frameworkアプリケーションの主な構成ファイルの一覧と説明を、表1-4に示します。これらのファイルは、アプリケーションのデプロイメントの.EARファイル内で供給されます。

表1-4 WebCenter Portalの構成ファイル

アーティファクト

用途

adf-config.xml

Application Development Framework (ADF)およびアプリケーションの設定(ディスカッション・サーバーまたはメール・サーバーのWebCenter PortalまたはPortal Frameworkアプリケーションが現在使用しているもの)のための基本構成を格納します。

connections.xml

外部サービスへの接続のための基本構成を格納します。

WebCenter PortalおよびPortal Frameworkアプリケーションは、それぞれの構成データを格納するためにOracle Metadata Services (MDS)リポジトリを使用します。これらは、Oracle WebLogicフレームワーク内のJDBCデータ・ソースとしてMDSリポジトリにアクセスします。

MDSリポジトリは、アプリケーションのカスタマイズとして、WebCenter PortalおよびPortal Frameworkアプリケーションへのデプロイ後の構成変更を格納します。MDSは、デプロイされた元バージョンのadf-config.xmlおよびconnections.xmlをベース・ドキュメントとして使用し、単一のカスタマイズ・レイヤーを使用して後続のすべてのアプリケーション・カスタマイズを別個にMDSに格納します。

WebCenter PortalまたはPortal Frameworkアプリケーションの起動時に、MDSに格納されたアプリケーション・カスタマイズが該当するベース・ドキュメントに適用され、アプリケーションは、マージされたドキュメント(カスタマイズされているベース・ドキュメント)を構成プロパティの最終セットとして使用します。

サーバー・クラスタにデプロイされるアプリケーションの場合、クラスタのすべてのメンバーは、MDSリポジトリ内の同じ場所から読み取ります。

Oracleはデプロイ後構成のための複数の管理ツールを提供するため、一般には、管理者は、adf-config.xmlおよびconnections.xmlなどのファイルのためにベース・ドキュメントのコンテンツ(またはMDSカスタマイズ・データ)を調べたり手動で変更したりする必要はありません。ベース・ドキュメントの場所を特定する必要がある場合や、MDS内の情報を確認する必要がある場合は、付録A「Oracle WebCenter Portalの構成」を参照してください。

利用可能な構成ツールの詳細は、第1.13項「Oracle WebCenter Portalの管理ツール」を参照してください。

注意:
構成ミスをもたらす可能性があるため、adf-config.xmlまたはconnections.xmlを手動で編集することはお薦めしません。

WebCenter PortalおよびPortal Frameworkアプリケーションは、デプロイ後の構成情報をMDSに格納しますが、ポートレット・プロデューサおよびディスカッション・サーバーのための構成情報は、ファイル・システムまたはデータベースに格納されます(表1-5)。

表1-5 WebCenter Portalの構成の場所

アプリケーション

構成はMDSに
格納されている

構成はファイル・システムに
格納されている

構成はデータベースに
格納されている

WebCenter Portal

はい

いいえ

いいえ

Portal Frameworkアプリケーション

はい

いいえ

いいえ

ポートレット・プロデューサ

いいえ

はい

いいえ

ディスカッション・サーバー

いいえ

はい

はい

ディスカッション・サーバー

Oracle WebCenter Portalのディスカッション・サーバーは、構成情報をそのデータベースに格納します。また、起動構成情報をDOMAIN_HOME/config/fmwconfig/servers/WC_COLLABORATION/owc_discussionsに格納します。このディレクトリには、jive_startup.xml、jive.licenseファイル、およびディスカッション・サーバー・インスタンスのためのログ・ファイルを含むlogsディレクトリが含まれます。

1.3.6 Oracle WebCenter Portalの状態および構成の永続性

WebCenter PortalおよびPortal Frameworkアプリケーションは、MDSリポジトリにアプリケーションの状態および構成が永続化されるJ2EEアプリケーションとして動作します。アプリケーション内のユーザー・セッション情報は、ローカルでメモリーに保持されます。クラスタ環境では、この状態は、クラスタの他のメンバーにレプリケートされます。

ポートレットまたはサービス環境内のアプリケーション・カスタマイズは、そのサービスによって存続します。初期設定では、Oracleポートレット、構築した任意のカスタム・ポートレット、およびディスカッション・サーバーには、すべて、それら固有のデータベース永続性メカニズムがあります。

分析

WebCenter Portalの分析機能には、状態はありません。分析コレクタによって受け取られた要求は、すぐに実行されます。WebCenter Portalによって開始される要求、または分析コレクタによって処理される要求など、転送中の状態は保証されません。

アクティビティ・グラフ

WebCenter Portalのアクティビティ・グラフは、次の2つのコンポーネントで構成されています。

- アクティビティ・グラフ: インメモリー状態は維持しません。アクティビティ・グラフ・タスク・フローは、アクティビティ・グラフ・データベースを照会し、推奨のリストとして結果を表示します。状態は、次のものによって更新されます。

- タスク・フロー構成パラメータ

- パーソナライズ設定

- "関心のない"機能

最初の2つは、状態を管理する、標準のOracle コンポーザ/Oracle ADF/MDSフレームワーク上に構築されます。最後は、ユーザーが、特定の推奨に関心がないと示すことができる機能です。この入力は、データベースで同期的に存続します。

- アクティビティ・グラフ・エンジン: データベース内の表をトランザクションで更新する、バッチ・データ分析プロセスを実行します。エンジンはクラスタ化またはフェイルオーバーをサポートしていませんが、障害からリカバリできます。

管理者は、アクティビティ・グラフ・スケジューラを使用して、夜間のスケジュールを設定およびモニターします。分析の結果(推奨)は、アクティビティ・グラフ・タスク・フローによって提示されます。

アクティビティ・グラフ・エンジンは、数時間存続する、夜間のジョブの実行時間かどうかをチェックするために定期的に起動するバックグラウンド・スレッドがあるシングルトン・アプリケーションです。スケジュールはデータベースで存続します。管理対象サーバーに障害が発生した場合、ジョブは、管理対象サーバーの次回起動時に続きます。

パーソナライズ・サーバー

WebCenter Portalのパーソナライズ・サーバーは、ステートレスRESTfulアプリケーションです。すべての状態は、クライアントの要求において管理されます。

1.3.7 Oracle WebCenter Portalのログ・ファイルの場所

WebCenter Portal、Portal Frameworkアプリケーション、ポートレット・プロデューサ、ディスカッション・サーバーなどで実行される操作は、アプリケーションを実行しているWebLogic管理対象サーバーに直接ログ記録されます。

base_domain/servers/Server_Name/logs/Server_Name-diagnostic.log

たとえば、WebCenter Portalの診断は、/base_domain/servers/WC_Spaces/logs/WC_Spaces-diagnostic.logにログ記録されます。

各WebLogic管理対象サーバーのログ・ファイルは、Oracle WebLogic Server管理コンソールから表示できます。ログを表示するには、Oracle WebLogic Server管理コンソールhttp://<admin_server_host>:<port>/consoleにアクセスし、診断ログ・ファイルをクリックします。

Fusion Middleware Controlから診断ログを表示および構成することもできます。第28.2項「ログ情報の表示および構成」を参照してください。

1.4 WebCenter Portal

WebCenter Portalは、ソーシャル・ネットワーキング、コミュニケーション、コラボレーションおよび個人の生産性のための最新テクノロジを提供する、Webベースのアプリケーションです。WebCenter Portalは、堅牢な一連のサービスとアプリケーションにより、他のユーザーとの意見交換、個人的な作業と仕事関連の作業の経過記録、重要なアプリケーションとの対話、および独自のプロジェクトと関心事に専念するために必要なあらゆるものを単一の統合環境にまとめます。

サービスとツールの自動構成

一部のツールとサービスは、WebCenter Portal用にインストール・プロセス中に自動的に構成されます。詳細は、『Oracle WebCenter Portalインストレーション・ガイド』を参照してください。

デフォルトの接続名を表1-6に示します。

表1-6 WebCenter Portal用に自動的に構成される接続

ツール/サービス

デフォルト接続名

ディスカッションおよびお知らせ

WebCenterSpaces-Discussions

ドキュメント

WebCenterSpaces-ucm

ページレット・プロデューサ

WebCenterSpaces-PageletProducer

パーソナライズ

Conductor-WCPSSpacesおよびProperties-WCPSSpaces

事前構成済ポートレット・プロデューサ

wc-OmniPortlet

wc-WebClipping

wc-WSRPTools

ワークリスト

Portalワークフロー

WebCenterSpaces-Worklist

WebCenter Portalのインストール後の構成

作業の開始前に、第2章「WebCenter Portalの起動および実行」を参照してください。

WebCenter Portalの管理の詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

1.5 Portal Frameworkアプリケーション

JDeveloperのWebCenter Portal Frameworkアプリケーション・テンプレートを使用して独自のポータル・アプリケーションを開発し、そのアプリケーションをカスタムWebLogic管理対象サーバーにデプロイできます。JDeveloperを使用して構築されたポータル・アプリケーションは、Portal Frameworkアプリケーションと呼ばれます。

独自のポータル・アプリケーションの開発の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』を参照してください。

作業の際は次を参照してください。

- 第4章「Portal Frameworkアプリケーションの起動および実行」

- 第5章「Portal Frameworkアプリケーションのメンテナンス」

- 第42章「Portal Frameworkアプリケーションのデプロイ」

1.6 Oracle WebCenter Portalのインストールの計画

WebCenter PortalまたはPortal Frameworkアプリケーションのインストールには、多少の計画が必要です。考慮する質問の一部には、次のものがあります。

- どのOracle WebCenter Portalコンポーネントを使用しますか。

- 何人のユーザーがこのデプロイメントにアクセスしますか。

- エンタープライズ・デプロイメントのためにどのように高可用性を提供できますか。

- WebCenter Portalをどのように保護できますか。

Oracle WebCenter Portalのインストールの計画の詳細は、『Oracle WebCenter Portalインストレーション・ガイド』、『Oracle WebCenter Portalエンタープライズ・デプロイメント・ガイド』および高可用性ガイドを参照してください。

1.7 Oracle WebCenter Portal 11gのインストールの理解

初期設定のトポロジは、第1.3項「Oracle WebCenter Portalのトポロジ」で簡単に説明しています。 特定の分野のトポロジについては、それに対応する章で説明しています。たとえば、セキュリティ関連の側面は、第30章「Oracle WebCenter Portalセキュリティの管理」で説明しています。

Oracle WebCenter Portalのインストールおよびインストール後の管理作業の詳細は、『Oracle WebCenter Portalインストレーション・ガイド』を参照してください。

注意:
インストールしているOracle WebCenter Portalのバージョンを確認する場合は、付録G「インストールされているWebCenter Portalのバージョンを調べる方法」を参照してください。

インストール後のエンタープライズ構成は、『Oracle WebCenter Portalエンタープライズ・デプロイメント・ガイド』を参照してください。

インストール後の高可用性構成は、高可用性ガイドを参照してください。

インストール後のセキュリティ構成は、第30章「デプロイ後のセキュリティ構成タスク」を参照してください。

1.8 管理操作、ロールおよびツールの理解

Oracle WebCenter Portalは、WebCenter PortalおよびPortal Frameworkアプリケーションのデプロイ、構成、起動と停止、および維持のための複数の異なるツールを提供します。これらすべてのツールは、第1.13項「Oracle WebCenter Portalの管理ツール」で説明しています。

管理作業を実行する能力は、割り当てられているOracle WebLogic Serverロール(Admin、OperatorまたはMonitor)によって異なります。表1-7に、一般的な操作のために必要なOracle WebLogic Serverロールをリストします。これらのロールは、操作がFusion Middleware Control、WLSTコマンドまたはWebLogic Server管理コンソールを介して実行されるかどうかに該当します。

表1-7 WebCenterポータルの操作およびOracle WebLogic Serverロール

操作

Admin
ロール

Operator
ロール

Monitor
ロール

WebCenter PortalおよびPortal Frameworkアプリケーション

起動および停止

はい

はい

いいえ

パフォーマンス・メトリックの表示

はい

はい

はい

ログ情報の表示

はい

はい

はい

ログ・ファイルの構成

はい

はい

はい

構成の表示

はい

はい

はい

新しい接続の構成

はい

はい

いいえ

接続の編集

はい

はい

いいえ

接続の削除

はい

はい

いいえ

アプリケーションのデプロイ

はい

いいえ

いいえ

セキュリティの構成

はい

いいえ

いいえ

セキュリティの表示(アプリケーション・ロール/ポリシー)

はい

はい

はい

WebCenter Portalのみ

アプリケーション全体のエクスポート

はい

いいえ

いいえ

アプリケーション全体のインポート

はい

いいえ

いいえ

表1-8に、WebCenter PortalおよびPortal Frameworkアプリケーションに関連する様々な管理操作を実行するために使用できるツールをまとめています。

表1-8 WebCenter Portalの操作および管理ツール

操作

Fusion Middleware Control

WLSTコマンド

WebLogic Server管理コンソール

WebCenter Portal管理/
Portal Frameworkアプリケーション管理

WebCenter PortalおよびPortal Frameworkアプリケーション

起動および停止

はい

はい

はい

いいえ

パフォーマンス・メトリックの表示

はい

いいえ

いいえ

いいえ

ログ情報の表示

はい

いいえ

いいえ

いいえ

ログ・ファイルの構成

はい

いいえ

いいえ

いいえ

構成の表示

はい

はい

いいえ

いいえ

新しい接続の構成

はい

はい

いいえ

いいえ

接続の編集

はい

はい

いいえ

いいえ

接続の削除

はい

はい

いいえ

いいえ

ポートレット・プロデューサの管理

はい

はい

いいえ

はい

外部アプリケーションの管理

はい

はい

いいえ

はい

アプリケーションのデプロイ

はい

はい

はい

いいえ

セキュリティの構成

はい

はい

はい

いいえ

WebCenter Portalのみ

ワークフローの構成

はい

はい

いいえ

いいえ

アプリケーション全体のエクスポート

はい

はい

いいえ

いいえ

アプリケーション全体のインポート

はい

はい

いいえ

いいえ

WebCenter Portalのカスタマイズ

いいえ

いいえ

いいえ

はい

アプリケーション・ユーザーおよびロールの管理

いいえ

いいえ

いいえ

はい

ページの管理

いいえ

いいえ

いいえ

はい

ポータルの管理

いいえ

いいえ

いいえ

はい

ポータルのエクスポート

いいえ

いいえ

いいえ

はい

ポータルのインポート

いいえ

いいえ

いいえ

はい

1.9 パフォーマンスのモニタリングおよび診断

パフォーマンスのモニタリングにより、管理者は、環境内の問題およびパフォーマンスのボトルネックを識別できます。第27章「Oracle WebCenter Portalのパフォーマンスのモニタリング」では、WebCenter PortalおよびPortal Frameworkアプリケーションで使用できるパフォーマンス・メトリックの範囲、およびFusion Middleware Controlを使用したパフォーマンス・メトリックのモニター方法について説明します。また、診断ログ・ファイルに記録された情報を分析することにより、問題をトラブルシューティングする方法についても説明します。

1.10 セキュリティの理解

Oracle WebCenter Portalの推奨セキュリティ・モデルは、Java Authentication and Authorization Service (JAAS)モデルを実装するOracle ADF Securityに基づいています。次の章では、WebCenter Portalアプリケーションのセキュリティ構成について説明します。

- 第30章「Oracle WebCenter Portalセキュリティの管理」

- 第31章「アイデンティティ・ストアの構成」

- 第32章「ポリシーおよび資格証明ストアの構成」

- 第33章「シングル・サインオンの構成」

- 第34章「シングル・サインオン向けのPortal Frameworkアプリケーションの構成」

- 第35章「SSLの構成」

- 第36章「WS-Securityの構成」

- 第37章「ポートレット・プロデューサのセキュリティの構成」

1.11 WebCenter Portalアプリケーションのデプロイ

第42章「Portal Frameworkアプリケーションのデプロイ」では、Oracle JDeveloperで作成した.EARファイルからのPortal Frameworkアプリケーションのデプロイ、再デプロイおよびアンデプロイについて説明します。

第21.11項「ポートレット・プロデューサ・アプリケーションのデプロイ」では、WSRPおよびPDK-Javaポートレット・プロデューサ・アプリケーションのデプロイについて説明します。

注意:
WebCenter Portalは、インストール時にデプロイされます。(EARファイルとしてデプロイすることはできません)。詳細は、『Oracle WebCenter Portalインストレーション・ガイド』のOracle WebCenter Portalのインストールに関する項を参照してください。

1.12 データの移行、バックアップおよびリカバリ

Oracle WebCenter Portalでは、様々な機能領域についての構成および内容に関連するデータが複数の場所に格納されています。Oracle WebCenter Portalには、障害回復や、開発からステージングおよび本番までの本番ライフサイクル全体を容易にするための一連のユーティリティが用意されており、それによりこのデータをバックアップし、ステージング環境と本番環境間でデータを移動できます。

第41章「WebCenter Portalのバックアップ、リカバリおよびクローニングの管理」では、これらの作業に利用可能なバックアップ、インポートおよびエクスポートの機能とツールについて説明します。

1.13 Oracle WebCenter Portalの管理ツール

Oracle WebCenter Portalには、次の管理ツールがあります。

- Oracle Enterprise Manager Fusion Middleware Controlコンソール

- Oracle WebLogic Server管理コンソール

- Oracle WebLogic Scripting Tool(WLST)

- システムMBeanブラウザ

これらの管理ツールは、WebCenter Portalを含む、すべてのアプリケーションに適用します。また、管理者は、管理作業を実行するために、構成ファイルを編集するのではなく、これらのツールを使用する必要があります。最適なツールを決定するためのヘルプは、付録A「構成ツール」を参照してください。

システム管理ツールのほかに、個々のアプリケーションは、次の実行時管理ページも提供します。

- WebCenter Portal: ポータル・ビルダーの管理ページ

- Portal Frameworkアプリケーション: 管理コンソール

1.13.1 Oracle Enterprise Manager Fusion Middleware Controlコンソール

Oracle Enterprise Manager Fusion Middleware Controlコンソールは、Oracle WebCenter Portalをインストールする際にデプロイされるブラウザ・ベースの管理アプリケーションです。Fusion Middleware Controlコンソールから、ファーム(Oracle WebCenter Portal、WebCenter Portal、およびPortal Frameworkアプリケーションを含むものなど)をモニターおよび管理できます。

Fusion Middleware Controlでは、多種多様なパフォーマンス・データおよび管理機能を整理し、個別のWebベースのホームページで提供しています。これらのホームページでは、Webブラウザから、WebCenter Portalコンポーネントの最も重要なモニタリング・データおよび最も一般的な管理機能をすぐに見つけることができます。Fusion Middleware Controlコンソールの一般情報は、管理者ガイドのOracle Enterprise Manager Fusion Middleware Controlの使用のスタート・ガイドに関する項を参照してください。

Fusion Middleware Controlは、Oracle WebCenter Portalの主要管理ツールです。このツールを使用して、次のことができます。

- Portal Frameworkアプリケーションのデプロイ、アンデプロイおよび再デプロイ

- バックエンドのサービスとツールの構成

- セキュリティ管理の構成

- プロセス・ライフサイクルの制御

- ログ・ファイルへのアクセスおよびログ構成の管理

- データ移行の管理

- パフォーマンスのモニター

- 実行時の問題の診断

- 関連コンポーネントの管理(親管理対象サーバー、MDS、ポートレット・プロデューサなど)

1.13.1.1 Fusion Middleware Controlコンソールの表示

Fusion Middleware Controlの起動の詳細は、第6.1項「Fusion Middleware Controlコンソールの表示」を参照してください。

1.13.2 Oracle WebLogic Server管理コンソール

Oracle WebLogic Server管理コンソールは、WebLogic Serverドメインの管理に使用されるブラウザ・ベースのグラフィカル・ユーザー・インタフェースです。

管理サーバーは、管理コンソール(管理サーバー管理対象サーバーのホスト・アプリケーションへネットワーク・アクセスできる、サポートされている任意のWebブラウザからアクセス可能なWebアプリケーション)をホストします。

管理コンソールは、次のことのために使用します。

- WebLogic Serverインスタンスの構成、起動および停止

- WebLogic Serverクラスタの構成

- データベース接続性(JDBC)およびメッセージング(JMS)などのWebLogic Serverサービスの構成

- ユーザー、グループおよびロールの作成および管理を含むセキュリティ・パラメータの構成

- アプリケーションの構成およびデプロイ

- サーバーおよびアプリケーションのパフォーマンスのモニター

- サーバーおよびドメイン・ログ・ファイルの表示

- アプリケーションのデプロイメント記述子の表示

- 選択したランタイム・アプリケーションのデプロイメント記述子エレメントの編集

Oracle WebLogic Server管理コンソールの詳細は、管理者ガイドのOracle WebLogic Server管理コンソールの表示に関する項を参照してください。

ドメイン構成のロック

構成を変更する前に、ドメインの構成設定をロックする必要があります。管理コンソールのチェンジ・センター(図1-4)に移動し、「ロックして編集」をクリックします。

構成の更新が完了したら、「構成の解放」をクリックして変更を解放します。

図1-4 Oracle WebLogic Server管理コンソール内のチェンジ・センター

1.13.3 Oracle WebLogic Scripting Tool(WLST)

WebLogic Scripting Tool (WLST)により、コマンド行から、Oracle WebCenter PortalなどのOracle Fusion Middlewareコンポーネントを管理できます。

WLSTは、Javaスクリプト・インタプリタであるJythonに基づいた、Oracle WebLogic Serverドメインを管理するための完全なコマンド行スクリプト環境です。WLSTは、ローカル変数、条件変数およびフロー制御文などのJythonの標準機能に対するサポートに加えて、Oracle WebLogic Serverに固有の一連のスクリプト機能(コマンド)も提供します。Jython言語構文に従って、要件に合せてWebLogicスクリプト言語を拡張できます。

(コンテンツ・リポジトリ、ポートレット・プロデューサ、外部アプリケーションおよび他のバックエンド・サービスへの)接続、およびアプリケーション移行を管理するためのWLSTコマンドも用意されています。Oracle WebCenter PortalのすべてのWLSTコマンドは、『WebLogic Scripting Toolコマンド・リファレンス』の「WebCenter PortalのカスタムWLSTコマンド」で説明されています。

注意:
オラクル社以外のベンダーが提供するサード・パーティ製のアプリケーション・サーバーを使用している場合は、サード・パーティ製コマンド行ツール(IBM WebSphereのWSADMなど)の情報について、サード・パーティ・アプリケーション・サーバー・ガイドを参照してください。

1.13.3.1 Oracle WebLogic Scripting Tool (WLST)コマンドの実行

Oracle WebCenter PortalのすべてのWLSTコマンドは、WebCenter Portal Oracleホーム・ディレクトリ(WCP_ORACLE_HOME)から実行する必要があります。

注意:
間違ったディレクトリからOracle WebCenter PortalのWLSTコマンドを起動しようとすると、NameErrorが表示されます。このエラーを回避するには、次に説明するように、常にWLSTコマンドをWebCenter PortalのOracleホーム(WCP_ORACLE_HOME/common/bin)から実行してください。
付録G「Oracle WebCenter Portalのトラブルシューティング」も参照してください。

コマンド行からWLSTを実行するには:

1. 次のように、WebCenter Portal Oracleホーム・ディレクトリに移動してWLSTスクリプトを起動します。
(UNIX) WCP_ORACLE_HOME/common/bin/wlst.sh

(Windows) WCP_ORACLE_HOME\common\bin\wlst.cmd

2. WLSTコマンド・プロンプトで、次のコマンドを入力してOracle WebCenter Portalの管理サーバーに接続します。

wls:/offline>connect('user_name','password', 'host_name:port_number')

ここで

- user_nameは、管理サーバーに接続しているオペレータのユーザー名です。

- passwordは、管理サーバーに接続しているオペレータのパスワードです。

- host_nameは、管理サーバーのホスト名です。

- port_numberは、管理サーバーのポート番号です。

例:

connect(username='weblogic', password='mypassword', url='myhost.example.com:7001')

次のように、対話モードでパラメータなしで管理サーバーに接続することもできます。

wls:/offline> connect()
Please enter your username :weblogic
Please enter your password :
Please enter your server URL [t3://localhost:7001]:t3://myhost.example.com:7001
Connecting to t3://myhost.example.com:7001 with userid weblogic ...
Successfully connected to Admin Server 'AdminServer' that belongs to domain 'wc_domain'.

このコマンドのヘルプについては、WLSTコマンド・プロンプトでhelp('connect')と入力してください。

注意:
SSLが有効な場合は、wlst.shまたはwlst.cmdファイルを編集して、次の行をJVM_ARGSに追加する必要があります。

-Dweblogic.security.SSL.ignoreHostnameVerification=true
-Dweblogic.security.TrustKeyStore=DemoTrust

またはsetenv CONFIG_JVM_ARGS

-Dweblogic.security.SSL.ignoreHostnameVerification=true
-Dweblogic.security.TrustKeyStore=DemoTrust

3. 管理サーバーに接続すると、Oracle WebCenter PortalのWLSTコマンドや、その他の汎用WLSTコマンドを実行できます。

Oracle WebCenter Portal WLSTコマンドの実行のヒント

- Oracle WebCenter PortalのWLSTコマンドをリストするには、WLSTコマンド・プロンプトで、help('webcenter')と入力します。
メッセージNo help for webcenter found...が表示される場合は、WLSTスクリプトを誤ったディレクトリから実行している可能性があります。たとえば、wlst.shまたはwlst.cmdを、WCP_ORACLE_HOME/common/binではなくoracle_commonディレクトリから実行している可能性があります。

- 特定のコマンドのヘルプについては、WLSTコマンド・プロンプトで、help('WLST_command_name')と入力します。

- コマンドの実行時と、特にWLSTスクリプトの記述時に、引数名を含めます。たとえば、次のように入力することをお薦めします。
createExtAppConnection(appName='webcenter', name='myXApp'...

次のように入力することはお薦めしません。

createExtAppConnection('webcenter', 'myXApp'...

どちらの構文も有効ですが、引数名を含める場合に、エラーまたは構成ミスの可能性が少なくなります。また、将来、引数を追加する場合も、コマンドが失敗することや誤ったプロパティを構成することがありません。

- クラスタ化環境では、コマンドを実行するときに、必ず「server」引数を指定してください。Oracle WebCenter PortalのすべてのWLSTコマンドには、server引数が含まれています。この引数は、WebCenter PortalまたはPortal Frameworkアプリケーションがクラスタにデプロイされている場合には必須になります。『WebLogic Scripting Toolコマンド・リファレンス』の「WebCenter PortalのカスタムWLSTコマンド」も参照してください。

- Oracle WebCenter PortalのWLSTコマンドのオンライン・ドキュメントは、『WebLogic Scripting Toolコマンド・リファレンス』の「WebCenter PortalのカスタムWLSTコマンド」から入手可能です。

1.13.4 システムMBeanブラウザ

Fusion Middleware Controlは、Oracle WebLogic Serverまたは選択されたアプリケーションのMBeanを参照できる、一連のMBeanブラウザを提供します。

注意:
システムMBeanブラウザから、WebCenter PortalおよびPortal FrameworkアプリケーションのMBeanをモニターおよび構成できますが、構成のためのツールとしてはお薦めしません。WLSTコマンドを使用するか、Fusion Middleware ControlのWebCenter Portalの設定メニュー・オプション(アプリケーションのホームページから使用可能)を介してアプリケーションを構成することをお薦めします。

アプリケーションのMBeanにアクセスするには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「システムMBeanブラウザ」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「システムMBeanブラウザ」を選択します。

3. 「アプリケーション定義のMBean」を開きます。

4. 表示または構成するMBeanに移動します。
たとえば、Portal Frameworkアプリケーションの場合は、次のようにして、adf-config.xmlおよびconnections.xmlのMBeanに移動できます(図1-5)。

- adf-config - 「oracle.adf.share.config」→「サーバー: (サーバー名)」→「アプリケーション: (アプリケーション名)」→「ADFConfig」→「ADFConfig」→「ADFConfig」をクリックします。

- connections - 「oracle.adf.share.connections」→「サーバー: (サーバー名)」→「アプリケーション: (アプリケーション名)」→「ADFConnnections」→「ADFConnnections」をクリックします。

5. MBeanの属性を表示するには、「属性」タブを選択します。一部の属性は、値を変更できます。これを行うには、「値」列に値を入力します。

図1-5 システムMBeanブラウザ

6. 「適用」をクリックして属性値を更新します。

7. 親MBean (たとえば、ADFConfigまたはADFConnections)に移動して「操作」タブを選択し、「保存」をクリックして変更を保存します。

8. WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動します。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

1.13.5 WebCenter Portal: ポータル・ビルダーの管理ページ

WebCenter Portalには、複数の独自の管理ページがあります。ポータル・ビルダーの管理ページは、管理者のユーザー名とパスワードを使用してアプリケーションにログインしたユーザーのみに表示されます。

ポータル・ビルダーの管理ページでは、次のことができます。

- WebCenter Portalのカスタマイズ

- ユーザーおよびロールの管理

- ツールとサービスの設定の管理

- ポートレット・プロデューサおよび外部アプリケーションの管理

- 個々のポータルおよびポータル・テンプレートの管理

- ビジネス・ロール・ページの作成および管理

- 個人用ページの管理

- 個々のポータルおよびポータル・テンプレートのエクスポートとインポート

詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

1.13.6 Portal Frameworkアプリケーション: 管理コンソール

WebCenter Portal Frameworkアプリケーションを使用してJDeveloperで構築されたポータル・アプリケーションには、管理者が実行時に一般的な管理作業を実行できる、管理ページを含めることもできます。詳細は、第1章「Oracle WebCenter Portalの管理の概要」を参照してください。

第II部

WebCenter Portalの管理のスタート・ガイド

『Oracle WebCenter Portalの管理』のこの部では、WebCenter Portalの管理を始める際に役立つチェックリストを示します。

第II部の内容は次のとおりです。

- 第2章「WebCenter Portalの起動および実行」

- 第3章「WebCenter Portalのメンテナンス」

2 WebCenter Portalの起動および実行

この章では、WebCenter Portalを起動および実行するシステム管理者のロールと職責について説明します。

この章には次のトピックが含まれます:

- 第2.1項「システム管理者のロール」

- 第2.2項「WebCenter Portalのインストール」

- 第2.3項「WebCenter Portalの初回の設定(ロードマップ)」

- 第2.4項「WebCenter Portalの初回のカスタマイズ(ロードマップ)」

Portal Frameworkアプリケーションを扱うシステム管理者は、第4章「Portal Frameworkアプリケーションの起動および実行」を参照してください。

権限:
この章のタスクを実行するには、次のロールが付与されている必要があります。

- WebLogic Server: Adminロール。Oracle WebLogic Server管理コンソールから付与します。
このロールが付与されたユーザーは、Fusion Middleware管理者とも呼ばれます。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。
このロールが付与されたユーザーは、WebCenter Portal管理者とも呼ばれます。

第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

2.1 システム管理者のロール

Oracle Fusion Middlewareでは、すべての管理能力を有する単一の管理ロール(Adminロール)を提供します。このロールを有するシステム管理者は、セキュリティの影響を受ける管理作業の全範囲、およびすべてのインストール、構成および監査作業を実行できます。この管理者は、インストールの直後にWebCenter Portalを設定および構成し、WebCenter Portalおよびその他のOracle WebCenter Portalコンポーネントの継続的な管理タスクを実行する必要があります。この管理者は、Fusion Middleware管理者と呼ばれることもあります。

インストール中に、weblogicという名前の1つのシステム管理者アカウントが作成されます。このパスワードは、インストール中に提供されます。

この管理者アカウントを使用して、Fusion Middleware ControlコンソールとWebCenter Portalにログインし、管理権限を他のユーザーに割り当てます。

- Fusion Middleware Control: Oracle WebLogic管理コンソールまたはOracle WebLogic Scripting Tool (WLST)を使用して、Administratorグループにユーザーを1人または複数追加します。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の管理ユーザーおよびロールに関する項を参照してください。
Oracle WebLogic Serverは、Adminロールに加えて、OperatorおよびMonitorという他の2つのロールを提供します。これらのロールの詳細は、第1.8項「管理操作、ロールおよびツールの理解」の表1-7「WebCenterポータルの操作およびOracle WebLogic Serverロール」を参照してください。

- WebCenter Portal: ポータル・ビルダー管理から、1人または複数のユーザーにAdministratorロールを割り当てます。詳細は、第49.5.3項「ユーザーへの管理権限の付与」を参照してください。
WebCenter Portal管理者は、WebCenter Portalアプリケーションの中で最高の権限を持っています。この管理者は、WebCenter Portalのすべての側面の表示およびカスタマイズ、ユーザーとロールの管理、および別のユーザーへの職責の委任を行うことができます。

WebCenter Portalを起動および実行するために、システム管理者が実行する必要のあるその他の作業を知るには、表2-1「ロードマップ: WebCenter Portalの初回の設定」の下にリストされる手順に従ってください。

初期設定のWebCenter Portalをカスタマイズするためにシステム管理者が実行できることを知るには、表2-2「ロードマップ: WebCenter Portalの初回のカスタマイズ」に従ってください。

注意:
システム管理者は、すべての継続的な管理タスクも担当します。詳細は、第3.2項「WebCenter Portalのためのシステム管理(ロードマップ)」を参照してください。

2.2 WebCenter Portalのインストール

WebCenter Portalのインストールは、『Oracle WebCenter Portalインストレーション・ガイド』で説明しています。

2.3 WebCenter Portalの初回の設定(ロードマップ)

この項の図2-1および表2-1に示したフローチャートでは、WebCenter Portalを起動および実行するために必要な作業の概要について説明しています。

図2-1 WebCenter Portalの初回の設定

表2-1 ロードマップ: WebCenter Portalの初回の設定

担当者

タスク

サブタスク

ノート

Fusion Middleware管理者

1. WebCenter Portalのインストールの検証

1.a WebCenter Portalのインストール

1.b ノード・マネージャの起動

1.c 管理対象サーバーの起動

1.d デフォルトの管理者としてWebCenter Portalにログイン

1.e ユーザーへの管理権限の付与

Fusion Middleware

管理者

2. 次のツールのどちらかを使用してバックエンド・コンポーネントへの接続を追加または変更

- Fusion Middleware Control

- WLST

バックエンド・コンポーネントには次のものが含まれる可能性があります。

- コンテンツ・リポジトリ脚注 1

- BPELサーバー脚注参照 1

- 分析コレクタ

- アクティビティ・グラフ・エンジン

- ディスカッション・サーバー脚注参照 1

- イベント・サーバー

- メール・サーバー

- プレゼンス・サーバー

- Oracle Secure Enterprise Search

- パーソナライズ・サーバー脚注参照 1

- WebCenter Portalリポジトリ脚注参照 1

- MDS脚注参照 1

Fusion Middleware管理者

3. 次のツールのどちらかを使用して、外部アプリケーションおよびポートレット・プロデューサに接続

- Fusion Middleware Control

- WLST

ポートレット・プロデューサには、次のものが含まれる可能性があります。

- WSRPプロデューサ脚注参照 1

- Oracle PDK-Javaプロデューサ脚注参照 1

- ページレット・プロデューサ脚注参照 1

Fusion Middleware管理者

4. バックエンド・サーバーをWebCenter Portalと同じアイデンティティ・ストアへ接続

バックエンド・サーバーには次のものが含まれる可能性があります。

- Oracle WebCenter Contentサーバー

- Oracle Secure Enterprise Search

- BPELサーバー

- ディスカッション・サーバー

- プレゼンス・サーバー

Fusion Middleware管理者

5. WebCenter Portalとの通信の保護

5.a シングル・サインオンの構成

5.b SSLの構成

5.c WS-Securityの構成

Fusion Middleware管理者

6. (オプション) WebCenter Portalのシステム・オプションの構成:

- Portalワークフロー脚注参照 1

- 通知メッセージ・チャネル

- 検索クローラ

- 検索設定

- RSSニュース・フィード

- Microsoft Office統合

Fusion Middleware管理者

7. WC_Spaces (WebCenter Portalがデプロイされる管理対象サーバー)の再起動

WebCenter Portal管理者

8. WebCenter Portalにログイン

WebCenter Portal管理者

9. グローバル・オプションの設定およびWebCenter Portalのカスタマイズ

WebCenter Portal管理者

10. ユーザー(およびグループ)へのロールの割当て

脚注 1 初期設定で自動構成済

2.4 WebCenter Portalの初回のカスタマイズ(ロードマップ)

表2-2のロードマップは、WebCenter Portal管理者が新しいターゲット・ユーザーにあわせてWebCenter Portalをカスタマイズするために実行できる作業の概要を示しています。

表2-2 ロードマップ: WebCenter Portalの初回のカスタマイズ

タスク

ドキュメント

担当者

1. WebCenter Portalにログイン

WebCenter Portalに管理権限でログインし、管理ページにアクセスします。

- 「ポータル・ビルダー管理」ページへのアクセス

ヒント:

WebCenter PortalのURLは、http://<host>:<port>/webcenterです。

ポータル・ビルダー管理のURLは、http://host:port/webcenter/portal/builder/administrationです。

WebCenter Portal管理者

2. WebCenter Portalのカスタマイズ

WebCenter Portalをターゲット・ユーザーにあわせてカスタマイズします。アプリケーションの名前およびロゴの選択、企業ブランドの適用、言語オプションの設定、デフォルト・ポータルやデフォルト・アセットの選択などがあります。詳細は、次を参照してください。

- ポータル・ビルダー管理タスクの実行

- ポータル間のグローバルなデフォルト設定の構成

- システム・ページのカスタマイズ

- ビジネス・ロール・ページの管理

- 個人用ページの管理

WebCenter Portal管理者

3. 自己登録ポリシーの決定

新規ユーザー登録に関するポリシーを設定します。WebCenter Portalコミュニティの外部ユーザーによる自己登録を招待者にのみ許可するか、自己登録を広く一般に許可します。

- 招待者限定の自己登録の有効化

- すべてのユーザーの自己登録の有効化

WebCenter Portal管理者

4. パブリック・ユーザー・エクスペリエンスの計画

第一印象は、非常に重要です。ようこそページに表示されるコンテンツ、およびユーザーがログインする前のWebCenter Portalの外観を決定します。

- ようこそページのカスタマイズ

- ログイン・ページのカスタマイズ

- 自己登録ページのカスタマイズ

- デフォルトの表示言語の選択

- パブリック・ユーザーへの権限の付与

WebCenter Portal管理者

5. ロールの作成および他のユーザーへの責任の委任

ユーザーのグループを特徴付けるロールを作成して、そのロールがWebCenter Portalで表示できる内容と実行できる内容を決定します。アイデンティティ・ストアでユーザー・ロールの管理および割当てを行います。

- Portalセキュリティについて

- ユーザー(およびグループ)へのロールの割当て

- アプリケーション・ロールの定義

- ユーザーへの管理権限の付与

- アプリケーション・ロールの権限の変更

WebCenter Portal管理者

6. ホーム・ポータルのカスタマイズ

WebCenter Portalユーザーのデフォルトのホーム・ポータルを設計します。各ユーザーのロールに関連のある重要な情報およびアプリケーションに即時にアクセスできるようにします。

- ビジネス・ロール・ページのためのページ作成のデフォルトの設定

- ビジネス・ロール・ページの作成

デフォルトのページ・スキームおよびページ・テンプレートにより、一貫性のあるルック・アンド・フィールを奨励または強制します。

- 新しいページのデフォルトのルック・アンド・フィールの選択

WebCenter Portal管理者

7. ディスカッション・フォーラムおよびお知らせの設定

ディスカッション・フォーラムおよびお知らせのデフォルト・オプションを構成します。

- WebCenter Portalのディスカッション・フォーラム・オプションの構成

WebCenter Portal管理者

8. ピープル・コネクション・コンポーネントの設定

アクティビティ・ストリーム、個人プロファイル、接続、メッセージ・ボードおよびフィードバックのデフォルトを構成します。

- WebCenter Portalのピープル・コネクションの構成

WebCenter Portal管理者

9. メール通知の設定

すべてのユーザーのメールのためのデフォルト・オプションを構成します。

- メール通知の送信の構成

WebCenter Portal管理者

10. 既製のポータルおよびポータル・テンプレートの提供

ユーザーは集中管理なしで独自のポータルを作成して管理できます。作成する可能性があるタイプのワークスペースおよびコミュニティのテンプレートを事前に作成しておき、ユーザーに提供します。

- 新規ポータルの作成と構築

- 新規ポータル・テンプレートの作成

WebCenter Portal管理者

3 WebCenter Portalのメンテナンス

この章では、WebCenter Portalの稼働を維持するシステム管理者のロールと職責について説明します。

この章には次のトピックが含まれます:

- 第3.1項「システム管理者のロール」

- 第3.2項「WebCenter Portalのためのシステム管理(ロードマップ)」

- 第3.3項「ポータル・ビルダーのためのシステム管理(ロードマップ)」

Portal Frameworkアプリケーションのメンテナンスを行うシステム管理者は、第5章「Portal Frameworkアプリケーションのメンテナンス」を参照してください。

権限:
この章のタスクを実行するには、次のロールが付与されている必要があります。

- WebLogic Server: Adminロール。Oracle WebLogic Server管理コンソールから付与します。
このロールが付与されたユーザーは、Fusion Middleware管理者とも呼ばれます。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。
このロールが付与されたユーザーは、WebCenter Portal管理者とも呼ばれます。

第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

3.1 システム管理者のロール

Oracle Fusion Middlewareでは、すべての管理能力を有する単一の管理ロール(Adminロール)を提供します。このロールを有するシステム管理者は、セキュリティの影響を受ける管理作業の全範囲、およびすべてのインストール、構成および監査作業を実行できます。この管理者は、インストールの直後にWebCenter Portalを設定および構成し、WebCenter Portalおよびその他のOracle WebCenter Portalコンポーネントの継続的な管理タスクを実行する必要があります。この管理者は、Fusion Middleware管理者と呼ばれることもあります。

Fusion Middlewareのインストール時に、1つのシステム管理者アカウント(デフォルトではweblogic)が設定されます。パスワードは、インストールの際に入力したパスワードです。

このデフォルトのシステム管理者のみが、WebCenter PortalのAdministratorロールに割り当てられたユーザーです。WebCenter Portal管理者は、WebCenter Portalアプリケーション自体の中で最も高いアプリケーション権限を持っています。この管理者は、WebCenter Portalのすべての側面の表示およびカスタマイズ、ユーザーとロールの管理、および別のユーザーへの職責の委任を行うことができます。

システム管理者に求められるWebCenter Portalに対する継続的な管理タスクの内容を理解するには、表3-1「ロードマップ: WebCenter Portalの管理およびモニタリング」および「ロードマップ: WebCenter Portalの稼働の維持」のロードマップに従ってください。

注意:
システム管理者は、デフォルトでのWebCenter Portalの起動と実行や、デフォルトでのWebCenter Portalのカスタマイズも担当します。詳細は、次を参照してください。

- 第2.3項「WebCenter Portalの初回の設定(ロードマップ)」

- 第2.4項「WebCenter Portalの初回のカスタマイズ(ロードマップ)」

3.2 WebCenter Portalのためのシステム管理(ロードマップ)

表3-1のロードマップに、WebCenter Portalの稼働を維持するためにシステム管理者が実行する一般的な作業の概要を示します。

表3-1 ロードマップ - WebCenter Portalの管理およびモニタリング

タスク

ドキュメント

ロール

管理対象サーバーの起動および停止

構成の変更を有効にするため、または所定のメンテナンスのために、WebCenter Portalアプリケーションがデプロイされる管理対象サーバーを再起動します。

- WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止

ヒント: WebCenter Portalの管理対象サーバーの名前はWC_Spacesです。

Fusion Middleware管理者

ログ・ファイルの表示および管理

ログ・ファイルからの問題の識別および診断。WebCenter Portalのログには、起動と停止の情報、エラー、警告およびその他の情報を含む、すべてのイベント・タイプが記録されます。

- WebCenter Portalログの表示および構成

Fusion Middleware管理者

パフォーマンスのモニター

Fusion Middleware ControlコンソールでWebCenter Portalアプリケーションのパフォーマンスを分析し、現在の状態をモニターします。

- Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示

- WebCenter Portalのモニタリング

- 主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断

WebLogic ServerのロールAdmin、Operator、Monitorのいずれかを付与されたシステム管理者は、パフォーマンス・メトリックを表示できます。詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

WebCenter Portal管理者は、WebCenter Portalの分析機能を使用して、アプリケーションのパフォーマンスおよび使用状況をモニターできます。

- WebCenter Portalの分析管理ページの理解

Fusion Middleware管理者

WebCenter Portal管理者

アプリケーションのプロパティの調整

WebCenter Portal環境、WebCenter PortalアプリケーションおよびWebCenter Portalコンポーネントのためのパフォーマンス関連のパラメータを再構成します。

- Oracle WebCenter Portalのパフォーマンスのチューニング

Fusion Middleware管理者

WebCenter Portalの停止および起動

システム管理者は、メンテナンスの目的でWebCenter Portalを停止し、その後アプリケーションを再起動する場合があります。

- Fusion Middleware Controlを使用したWebCenter Portalの起動

- Fusion Middleware Controlを使用したWebCenter Portalの停止

Fusion Middleware管理者

バックエンド・サービスの変更

Fusion Middleware Controlコンソールで接続を追加、変更および削除します。次を参照してください。

Fusion Middleware管理者

- コンテンツ・リポジトリ

- コンテンツ・リポジトリの管理

- メール・サーバー

- メールの管理

- BPELサーバー

- ワークリストの管理

- コラボレーション

- お知らせおよびディスカッションの管理

- インスタント・メッセージおよびプレゼンスの管理

- カレンダ

- カレンダ・イベントの管理

- Secure Enterprise Search

- WebCenter PortalでのOracle Secure Enterprise Searchの管理

- 分析

- 分析の管理

- アクティビティ・グラフ

- アクティビティ・グラフの管理

- パーソナライズ

- パーソナライズの管理

- イベント、リンク、リスト、ノート、タグおよびピープル・コネクション

- データベース接続の設定

- MDSリポジトリの設定

外部アプリケーションおよびポートレット・プロデューサの変更

Fusion Middleware Controlコンソールで接続を追加、変更および削除します。次を参照してください。

Fusion Middleware管理者

- 外部アプリケーション

- 外部アプリケーションの管理

- ポートレット・プロデューサ

- WSRPプロデューサの登録

- Oracle PDK-Javaプロデューサの登録

- ページレット・プロデューサの登録

SSL通信の構成

セキュアな通信を構成します。

- SSLの構成

- WS-Securityの構成

- シングル・サインオンの構成

『Oracle Platform Security Servicesによるアプリケーションの保護』も参照してください。

Fusion Middleware管理者

アイデンティティ、ポリシーおよび資格証明ストアの再関連付け

アイデンティティまたはポリシー・ストアの再関連付け

- アイデンティティ・ストアの構成

- ポリシーおよび資格証明ストアの構成

『Oracle Platform Security Servicesによるアプリケーションの保護』も参照してください。

Fusion Middleware管理者

WebCenterのリポジトリの再構成

WebCenter Portalリポジトリを再構成します。

- データベース接続の設定

Fusion Middleware管理者

MDSリポジトリの再構成

アプリケーションのMDSリポジトリを再構成します。

- MDSリポジトリの設定

管理者ガイドも参照してください。

- MDSリポジトリの管理

- 異なるMDSリポジトリまたはパーティションを使用するためのアプリケーションの構成

- ソース・システムからターゲット・システムへのメタデータの移動

Fusion Middleware管理者

WebCenter Portalワークフローの再構成

異なるBPELサーバーへWebCenter Portalワークフローをインストールし、接続を再構成します。

- WebCenter Portalワークフローのインストール

- WebCenter PortalワークフローをホスティングするBPELサーバーの指定

Fusion Middleware管理者

ポータル、ポータル・テンプレート、アセットまたはポータル・サーバー全体の移行またはエクスポート

様々なエクスポート機能を使用して、リモート・インスタンスへのコンテンツの移動、またはステージング環境と本番環境の間でのコンテンツの移動を行います。

- アーカイブへのWebCenter Portalのエクスポート

- ポータルのデプロイ

- ポータル・テンプレートのデプロイ

- アセットのデプロイ

- デバイスおよびデバイス・グループのデプロイ

Fusion Middleware管理者

WebCenter Portalアプリケーションのインポート

様々なインポート機能を使用して、バックアップからのWebCenter Portalのリストア、リモート・インスタンスへのコンテンツの移動、またはステージング環境と本番環境の間でのコンテンツの移動を行います。

- WebCenter Portalアーカイブのインポート

- ポータルのデプロイ

- ポータル・テンプレートのデプロイ

- アセットのデプロイ

- デバイスおよびデバイス・グループのデプロイ

Fusion Middleware管理者

3.3 ポータル・ビルダーのためのシステム管理(ロードマップ)

表3-2のロードマップに、ポータル・ビルダーの稼働時にシステム管理者が実行する一般的な作業の概要を示します。

メンテナンスのためにポータル・ビルダーをオフラインにする必要がある場合は、オフライン中にアプリケーションへのアクセスを試みるユーザーに対して適切なメッセージが表示されることを確認してください。

表3-2 ロードマップ - WebCenter Portalの稼働の維持

タスク

ドキュメント

ロール

アプリケーション設定の変更

アプリケーション全体の設定を必要に応じて変更します。

- ポータル・ビルダー管理タスクの実行

- ポータル間のグローバルなデフォルト設定の構成

- ツールおよびサービスの管理

- システム・ページのカスタマイズ

- ビジネス・ロール・ページの管理

- 個人用ページの管理

WebCenter Portal管理者

ホーム・ポータルの管理

個人用ページおよびビジネス・ロール・ページを管理します。コンテンツをホーム・ポータルにプッシュします。

- ビジネス・ロール・ページの管理

- 個人用ページの管理

- システム・ページのカスタマイズ

WebCenter Portal管理者

ポータルの管理

任意のポータルを一時的にオフラインにし、非アクティブなポータルを終了します。任意のポータルを編集および削除します。

- 任意のポータルに関する情報の表示

- 任意のポータルのクローズ

- 任意のポータルのオフライン化

- 任意のポータルの再オンライン化

- ポータルの削除

WebCenter Portal管理者

ポータル・テンプレートの管理

ポータル・テンプレートを管理します。任意のテンプレートを確認および削除します。

- 新規ポータル・テンプレートの作成

WebCenter Portal管理者

ユーザーおよびロールのメンテナンス

セキュリティをメンテナンスします。ユーザー・ロールの権限の変更、新しいロールの割当てを行います。

- アプリケーション・ロールの権限の変更

- ユーザーへの異なるロールの割当て

WebCenter Portal管理者

外部アプリケーションの管理

外部アプリケーションをメンテナンスします。エントリを追加、変更および削除します。

- 外部アプリケーションの登録

WebCenter Portal管理者

AppConnectionManager

ポートレット・プロデューサの管理

ポートレット・プロデューサをメンテナンスします。エントリを追加、変更および削除します。

- ポートレット・プロデューサの登録

WebCenter Portal管理者

AppConnectionManager

第III部

Portal Frameworkアプリケーションの管理のスタート・ガイド

『Oracle WebCenter Portalの管理』のこの部では、Portal Frameworkアプリケーションの管理を始める際に役立つチェックリストを示します。

第III部の内容は次のとおりです。

- 第4章「Portal Frameworkアプリケーションの起動および実行」

- 第5章「Portal Frameworkアプリケーションのメンテナンス」

4 Portal Frameworkアプリケーションの起動および実行

この章では、インストール後に、システム管理者がPortal Frameworkアプリケーションを起動して実行するために必要な作業について説明します。Portal Frameworkアプリケーションは、WebCenter Portal Frameworkアプリケーション・テンプレートを使用して、Oracle JDeveloperで構築されるポータル・アプリケーションです。

注意:
Portal Frameworkではなくポータル・ビルダーを使用して、新しいポータルを作成することをお薦めします。ポータル・ソリューションを開発する場合にカスタムPortal Frameworkアプリケーションが大きな柔軟性を提供する可能性がありますが、通常そのような柔軟性によって製品のサポート可能性および新しいWebCenter Portalリリースにアップグレードする機能が失われます。ポータル・ビルダーを使用すると、複雑さまたはスケーラビリティを損わずにこれらの制約が回避されます。ポータル・ビルダーを使用したポータルの構築は、「Oracle WebCenter Portalによるポータルの作成」を参照してください。

この章の内容は次のとおりです。

- 第4.1項「Oracle WebCenter PortalおよびWebCenter Portal Frameworkライブラリのインストール」

- 第4.2項「Portal Frameworkアプリケーションの初回のデプロイ(ロードマップ)」

権限:
この章のタスクを実行するには、次のロールが付与されている必要があります。

- WebLogic Server: Adminロール。Oracle WebLogic Server管理コンソールから付与します。
このロールが付与されたユーザーは、Fusion Middleware管理者とも呼ばれます。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。
このロールが付与されたユーザーは、Portal Framework管理者とも呼ばれます。

第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

Oracle WebCenter Portalの初期設定のポータル・アプリケーションであるWebCenter Portalでは、Portal Frameworkアプリケーションでは行わない特別な管理作業が必要です。これらの作業を網羅したリストは、第2章「WebCenter Portalの起動および実行」を参照してください。

4.1 Oracle WebCenter PortalおよびWebCenter Portal Frameworkライブラリのインストール

Oracle WebCenter Portalのインストールは、『Oracle WebCenter Portalインストレーション・ガイド』で説明しています。

Portal Frameworkアプリケーションの構築に必要なOracle JDeveloperのインストールは、『Oracle JDeveloperインストレーション・ガイド』で説明しています。

Portal Frameworkアプリケーションは、WebCenter PortalのFramework共有ライブラリ・ファイルでプロビジョニングされている任意のWebLogic Serverインスタンスにデプロイできます。詳細は、第42.1.4項「管理対象サーバーの作成」を参照してください。

4.2 Portal Frameworkアプリケーションの初回のデプロイ(ロードマップ)

表4-1のロードマップに、Portal Frameworkアプリケーションをデプロイし、それを起動して実行するためにシステム管理者が実行する必要のある作業の概要を示します。

注意:
Oracle WebCenter Portalの初期設定のポータル・アプリケーションであるWebCenter Portalでは、他のPortal Frameworkアプリケーションでは行わない追加の管理作業が必要です。これらの作業を網羅したリストは、第2章「WebCenter Portalの起動および実行」を参照してください。

表4-1 ロードマップ - Portal Frameworkアプリケーションの初回の起動および実行

手順

ドキュメント

ロール

手順1: Oracle WebCenter Portalのインストールの検証

Oracle WebCenter Portalのインストールおよび設定を検証します。次を参照してください。

- Oracle WebCenter PortalおよびWebCenter Portal Frameworkライブラリのインストール

- ノード・マネージャの起動

Fusion Middleware管理者

手順2: Fusion Middleware Controlの起動

Fusion Middleware Controlコンソール(WebCenter Portalアプリケーション用のWebベースの管理ツール)を起動します。次を参照してください。

- Fusion Middleware Controlコンソールの表示

- Portal Frameworkアプリケーションのホームページへの移動

コマンド行管理ツールWLSTについて理解します。第1.13.3項「Oracle WebLogic Scripting Tool (WLST)」を参照してください。

Fusion Middleware管理者

手順3: Portal Frameworkアプリケーションのデプロイ

Portal Frameworkアプリケーション・アーカイブのデプロイに適切なコンテナを作成します。

- 管理対象サーバーの作成

- メタデータ・サービス・リポジトリの作成および登録

- WebLogic管理対象サーバーへのアプリケーションのデプロイ

第42項「Portal Frameworkアプリケーションのデプロイ」も参照してください。

Fusion Middleware管理者

手順4: バックエンド・サーバーの再構成

必要な場合は、Fusion Middleware Controlから、バックエンド・サーバー接続を再構成します。

Fusion Middleware管理者

- コンテンツ・リポジトリ

- コンテンツ・リポジトリの管理

- メール・サーバー

- メールの管理

- BPELサーバー

- ワークリストの管理

- コラボレーション

- お知らせおよびディスカッションの管理

- インスタント・メッセージおよびプレゼンスの管理

- サブスクリプションおよび通知の管理

- Secure Enterprise Search

- WebCenter PortalでのOracle Secure Enterprise Searchの管理

- 分析

- 分析の管理

- アクティビティ・グラフ

- アクティビティ・グラフの管理

- 外部アプリケーション

- 外部アプリケーションの管理

- ポートレット・プロデューサ

- WSRPプロデューサの登録

- Oracle PDK-Javaプロデューサの登録

- ページレット・プロデューサの登録

- ピープル・コネクション、グループ・イベント、リンク、リスト、ノートおよびタグ

- データベース接続の設定

- MDSリポジトリの設定

手順5: アイデンティティ・ストアへの接続

アイデンティティ・ストアがインストールおよび構成され、必要なすべてのユーザー・データが含まれていることを確認します。次を参照してください。

- アイデンティティ・ストアの構成

『Oracle Platform Security Servicesによるアプリケーションの保護』も参照してください。

Fusion Middleware管理者

手順6: 管理対象サーバーの再起動

アプリケーションがデプロイされる管理対象サーバーを再起動します。次を参照してください。

- WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止

Fusion Middleware管理者

手順7: Portal Frameworkアプリケーションの構成の検証

アプリケーションにログインして、アイデンティティ・ストア、ツール/サービス、アプリケーションなどの構成を検証します。

- 管理コンソールを使用したPortal Frameworkアプリケーションの管理

Portal Frameworkアプリケーション管理者

手順8: アプリケーションの管理コンソールを使用した管理作業の実行

管理作業を実行します。

- アプリケーションレベルのプリファレンスの設定

- ユーザーの管理およびアプリケーション・ロールの付与

- アプリケーション・アセットの管理および構成

- コンテンツの管理および構成

- ポートレット・プロデューサの管理および構成

- 外部アプリケーションの管理および構成

- 投票の作成および管理

「管理コンソールを使用したPortal Frameworkアプリケーションの管理」を参照してください。

Portal Frameworkアプリケーション管理者

5 Portal Frameworkアプリケーションのメンテナンス

この章では、システム管理者がPortal Frameworkアプリケーションの稼働を維持するために実行できる作業について説明します。

この章には次のトピックが含まれます:

- 第5.1項「Portal Frameworkアプリケーションのためのシステム管理(ロードマップ)」

権限:
この章のタスクを実行するには、次のロールが付与されている必要があります。

- WebLogic Server: Adminロール。Oracle WebLogic Server管理コンソールから付与します。
このロールが付与されたユーザーは、Fusion Middleware管理者とも呼ばれます。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。
このロールが付与されたユーザーは、Portal Framework管理者とも呼ばれます。

第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

Oracle WebCenter Portalの初期設定のポータル・アプリケーションであるWebCenter Portalでは、Portal Frameworkアプリケーションでは行わない特別なメンテナンス作業が必要です。これらの作業を網羅したリストは、第3章「WebCenter Portalのメンテナンス」を参照してください。

5.1 Portal Frameworkアプリケーションのためのシステム管理(ロードマップ)

表5-1のロードマップに、Portal Frameworkアプリケーションの稼働を維持するためにシステム管理者が実行する一般的な作業の概要を示します。

メンテナンスのためにPortal Frameworkアプリケーションを一時的に停止する必要がある場合は、オフライン中にアプリケーションへのアクセスを試みるユーザーに対して適切なメッセージが表示されることを確認してください。

表5-1 ロードマップ - Portal Frameworkアプリケーションのメンテナンス

タスク

ドキュメント

ロール

管理対象サーバーの起動および停止

構成の変更を有効にするため、または所定のメンテナンスのために、Portal Frameworkアプリケーションがデプロイされる管理対象サーバーを再起動します。

- WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止

Fusion Middleware管理者

Portal Frameworkアプリケーションの停止および起動

メンテナンスのためにアプリケーションを停止してから再起動します。

- Portal Frameworkアプリケーションの起動および停止

Fusion Middleware管理者

バックエンド・サービスのメンテナンス

Fusion Middleware Controlコンソールで接続を追加、変更および削除します。

Fusion Middleware管理者

- コンテンツ・リポジトリ

- コンテンツ・リポジトリの管理

- メール・サーバー

- メールの管理

- BPELサーバー

- ワークリストの管理

- コラボレーション

- お知らせおよびディスカッションの管理

- インスタント・メッセージおよびプレゼンスの管理

- Secure Enterprise Search

- WebCenter PortalでのOracle Secure Enterprise Searchの管理

- 分析

- 分析の管理

- アクティビティ・グラフ

- アクティビティ・グラフの管理

外部アプリケーションおよびポートレット・プロデューサのメンテナンス

Oracle Enterprise Manager Fusion Middleware Controlコンソールで接続を追加、変更および削除します。次を参照してください。

Fusion Middleware管理者

- 外部アプリケーション

- 外部アプリケーションの管理

- ポートレット・プロデューサ

- WSRPプロデューサの登録

- Oracle PDK-Javaプロデューサの登録

- ページレット・プロデューサの登録

アイデンティティ、ポリシーおよび資格証明ストアの再関連付け

アイデンティティまたはポリシー・ストアの再関連付け

- アイデンティティ・ストアの構成

- ポリシーおよび資格証明ストアの構成

『Oracle Platform Security Servicesによるアプリケーションの保護』も参照してください。

Fusion Middleware管理者

MDSリポジトリの再構成

- MDSリポジトリの設定

Fusion Middleware管理者

WebCenterのリポジトリの再構成

- データベース接続の設定

Portal Frameworkアプリケーションのデータのエクスポート

リモート・インスタンスにデータを移行したり、ステージング環境と本番環境の間でデータを移行します。

- Portal Frameworkアプリケーションのメタデータのエクスポート

- Portal Frameworkアプリケーションのポートレット・クライアント・メタデータのエクスポート

- Portal Frameworkアプリケーションのセキュリティの移行

- Portal Frameworkアプリケーションのスキーマ・データの移行

「Portal Frameworkアプリケーションのエクスポート、インポート、バックアップおよびリカバリの管理」も参照してください。

Fusion Middleware管理者

Portal Frameworkアプリケーションのデータのインポート

インポート機能を使用して、リモート・インスタンスへのコンテンツの移動、またはステージング環境と本番環境の間でのコンテンツの移動を行います。

- Portal Frameworkアプリケーションのメタデータのインポート

- Portal Frameworkアプリケーションのポートレット・クライアント・メタデータのインポート

- Portal Frameworkアプリケーションのセキュリティの移行

- Portal Frameworkアプリケーションのスキーマ・データの移行

Fusion Middleware管理者

ログ・ファイルの表示および管理

ログ・ファイルからの問題の識別および診断。Portal Frameworkアプリケーションのログには、起動と停止の情報、エラー、警告およびその他の情報を含む、すべてのイベント・タイプが記録されます。

- Portal Frameworkアプリケーション・ログの表示および構成

Fusion Middleware管理者

パフォーマンスのモニター

Fusion Middleware ControlコンソールでPortal Frameworkアプリケーションのパフォーマンスを分析し、現在の状態をモニターします。

- Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示

- Portal Frameworkアプリケーションのモニタリング

Fusion Middleware管理者

アプリケーションのプロパティの調整

WebCenter Portal環境、アプリケーションおよびツール/サービスのためのパフォーマンス関連のパラメータを再構成します。

- Oracle WebCenter Portalのパフォーマンスのチューニング

Fusion Middleware管理者

アプリケーションの管理コンソールを使用したアプリケーション管理作業の実行

アプリケーションの管理作業を実行します。

- アプリケーションレベルのプリファレンスの設定

- ユーザーの管理およびアプリケーション・ロールの付与

- アプリケーション・アセットの管理および構成

- コンテンツの管理および構成

- ポートレット・プロデューサの管理および構成

- 外部アプリケーションの管理および構成

- 投票の作成および管理

「管理コンソールを使用したPortal Frameworkアプリケーションの管理」を参照してください。

Portal Frameworkアプリケーション管理者

第IV部

基本的なシステム管理

『Oracle WebCenter Portalの管理』のこの部では、WebCenter PortalおよびWebCenter Portal Frameworkアプリケーションの基本的なシステム管理タスクについて説明します。

第IV部の内容は次のとおりです。

- 第6章「Enterprise Manager Fusion Middleware Controlの起動」

- 第7章「Oracle WebCenter Portalの管理対象サーバーとアプリケーションの起動および停止」

6 Enterprise Manager Fusion Middleware Controlの起動

この章では、Oracle Enterprise Manager Fusion Middleware Controlコンソールにアクセスする方法と、必要なすべての構成、モニタリングおよび管理作業を実行できるOracle WebCenter Portal関連ページを表示する方法について説明します。

この章には次のトピックが含まれます:

- 第6.1項「Fusion Middleware Controlコンソールの表示」

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

- 第6.4項「依存コンポーネントへの移動」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdmin、OperatorまたはMonitorロールが付与されている必要があります。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

6.1 Fusion Middleware Controlコンソールの表示

システム管理者は、Fusion Middleware Controlコンソールにログインして、Oracle WebCenter Portalを管理するページにアクセスできます。この場合、ロールにより、ログイン後に表示できる内容および実行できる操作が決定されます。詳細は、第1.8項「WebCenterポータルの操作およびOracle WebLogic Serverロール」を参照してください。

Fusion Middleware Controlコンソールにアクセスする手順は、次のとおりです。

1. Fusion Middleware Controlを起動します。
Fusion Middleware Controlはドメインに対して構成されており、Oracle WebLogic Server管理サーバーの起動時に自動的に起動されます。管理者ガイドのFusion Middleware Controlの起動および停止に関する項を参照してください。

2. ブラウザに次のURLを入力します: http://hostname.domain:port/em
例: http://myhost.mycompany.com:7001/em

ポート番号は管理サーバーのポート番号です。デフォルトのポート番号は7001です。ポート番号はconfig.xmlのリストにあります

- Windows上: DOMAIN_HOME\config\config.xml

- UNIX上: DOMAIN_HOME/config/config.xml

管理者ガイドのポートの管理の概要に関する項も参照してください。

3. ファームの管理者「ユーザー名」および「パスワード」の有効な詳細を入力します。
管理者ユーザーのためのデフォルトのユーザー名は、weblogicです。これは、最初にFusion Middleware Controlにログインするために使用できるアカウントです。

4. 「ログイン」をクリックします。
最初に表示されるページは、「ファーム」ホームページです。このページは、ナビゲーション・ペイン(図6-1)でファーム名を選択すると、いつでも表示できます。

ヒント:
ログインできない場合は、WebLogic管理コンソールにログインし、ホスト、ポートおよび資格証明の確認を試みてください。Weblogic管理コンソールはFusion Middleware Controlと同じホストおよびポートでアクセスできます(http://host.domain:port/console)。

図6-1 ファーム・ホームページ

ナビゲーション・ペインからドリルダウンして、WebCenter Portalおよびデプロイした可能性のある任意のPortal Frameworkアプリケーションを含む、ファーム内のすべてのコンポーネントを表示および管理できます。詳細な手順は、次の項を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

6.2 WebCenter Portalのホームページへの移動

Oracle WebCenter Portalの初期設定のアプリケーションであるWebCenter Portalを管理するための最初のページは、WebCenter Portalのホームページ(図6-2)です。このページには、WebCenter Portalアプリケーションを構成する、すべてのコンポーネントとツール/サービスのステータス、パフォーマンスおよび可用性が表示されます。

注意:
Fusion Middleware ControlでWebCenter Portal製品およびコンポーネント名とともに表示されるバージョンは、インストールされている製品の実際のバージョン番号と一致していません。インストールされているWebCenter Portalのバージョンを確認するには、付録G「インストールされているOracle WebCenter Portalのバージョンを調べる方法」を参照してください。

図6-2 WebCenter Portalのホームページ

WebCenter Portalのホームページに表示されるメトリックを使用すると次のことができます。

- WebCenter Portalアプリケーションのステータスの確認と主要なパフォーマンス・データの表示。

- 即時報告するグラフによって、想定通りにアプリケーションが実行されているかどうかを迅速に確認:

- ページ、ドキュメントおよびポートレットの可用性およびパフォーマンスの問題

- WebLogicサーバーとバックエンドLDAPサーバーの一般的なヘルス

「WebCenter Portalメトリック」と「WebLogicサーバー・メトリック」セクションのリンクにマウスを移動すると表示情報の簡単な説明が表示され、リンクをクリックすると詳細がドリルダウンされます。

- CPUとヒープ・メモリー使用率のグラフをモニターし、システム・リソースが低下した状態で実行されているかどうかを検出。

- アプリケーションが様々な負荷の下でどのように実行されるかを確認するためとシステム・リソースの問題を診断するための、ユーザー・アクセス率と比較した全体的なレスポンス時間の追跡。

- 最も使用されるポータル、最も遅い実行者の迅速な確認、および最も多くのエラーを記録しているポータルの判別とドリルダウン。

- アプリケーションで使用されるWebCenter Portalツール/サービスのステータスおよび主要なパフォーマンス・メトリックの表示。

- 個々のポータル、ツール/サービス、外部アプリケーション、ポートレットおよびプロデューサの詳細なパフォーマンス情報へのドリルダウン。

- WebCenter Portalアプリケーションが実行されているWebLogic Server管理対象サーバーおよびMDSリポジトリを含む、他の主要なコンポーネントへの移動。

注意:
ホームページに表示されるパフォーマンス・メトリックの詳細、注意点およびインストールに関する問題の診断方法は、第27.1.3項「主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断」を参照してください。

WebCenter Portalのホームページには、「WebCenterポータル」メニュー(図6-3)も表示されます。

図6-3 WebCenter Portalアプリケーションのメニュー

WebCenter Portalのメイン・ホームページに移動するには:

1. Fusion Middleware Controlにログインします。
第6.1項「Fusion Middleware Controlコンソールの表示」を参照してください。

2. ナビゲータ(図6-4)で、「WebCenter」→「ポータル」→「Spaces」を開きます。

3. 「WebCenter Portal」を選択して、WebCenter Portalのインストールのホームページに移動します(図6-4)。

図6-4 WebCenter Portalのホームページへの移動

ナビゲータ・メニューがどのように「WebCenterポータル」に変わるかに注意してください(図6-5)。

図6-5 WebCenter Portalのホームページおよびメニューの表示

特定のコンポーネントのためのコンテキスト・メニューにアクセスする別の方法は、ナビゲーション・ツリーでノードを右クリックすることです。たとえば、WebCenter Portal (11.1.1)ノード(図6-5の左のSpacesノードの下)を右クリックすると、同じWebCenter Portalメニューが表示されます。

「WebCenterポータル」メニューから、次のことが行えます。

- すべてのコンポーネントの詳細なパフォーマンス・メトリックのドリルダウン

- ライブ・メトリックの選択および図表化

- WebCenter Portalアプリケーションの起動および停止

- 診断情報の分析およびログの構成

- WebCenter Portalアプリケーションのエクスポートおよびインポート

- ポートレット・プロデューサの登録および管理

- アプリケーション設定の構成

- バックエンド・サービスの管理

- 外部アプリケーションの管理

- セキュリティ・ポリシーおよびロールの構成

- ADFおよびMDSオプションの構成

- Webサービス関連の情報の表示

- WebCenter Portalのホームページから実行するほとんどのタスクは、このガイドで説明されています。該当する章または項は、第2章「WebCenter Portalの起動および実行」を参照してください。

6.3 Portal Frameworkアプリケーションのホームページへの移動

WebCenter Portal Frameworkアプリケーション・テンプレートを使用して、Oracle JDeveloperで開発および構築されたポータル・アプリケーション・デプロイメントを管理するための最初のページは、J2EEの「アプリケーション・デプロイメント」ホームページ(図6-6)です。このページには、Portal Frameworkアプリケーションを構成するすべてのコンポーネントとツール/サービスのステータス、パフォーマンスおよび可用性が表示されます。

注意:
Oracle WebCenter Portalの初期設定のポータル・アプリケーションであるWebCenter Portalには、別のホームページがあります。第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

図6-6 Portal Frameworkアプリケーションのホームページ

このページからは、次の操作を実行できます。

- Portal Frameworkアプリケーションのステータスの確認

- Oracle WebLogic Server管理コンソールへの移動

- 様々な標準「アプリケーション・デプロイメント」メニュー・オプションへのアクセス

- アプリケーションの起動、再起動および停止

- ログ・ファイルの表示および構成

- アプリケーションのアンデプロイおよび再デプロイ

- セキュリティ・ポリシーおよびロールの構成

- ADFおよびMDSオプションの構成

- パフォーマンス・サマリーの表示、アプリケーションのエントリ・ポイントの表示、アプリケーションに関連付けられたWebサービスとモジュールの表示、および秒当たりのリクエスト数とリクエスト処理時間を示すレスポンス・データとロード・データの表示。

- Portal Frameworkアプリケーションの主要コンポーネントへの移動。

- 個々のモジュールおよびツール/サービスの詳細なパフォーマンス情報へのドリルダウン。

注意:
ホームページに表示されるパフォーマンス・メトリックの詳細、注意点およびインストールに関する問題の診断方法は、第27.1.3項「主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断」を参照してください。

Portal Frameworkアプリケーションのメイン・ホームページに移動するには:

1. Fusion Middleware Controlにログインします。
第6.1項「Fusion Middleware Controlコンソールの表示」を参照してください。

2. ナビゲータ(図6-7)で、「アプリケーション・デプロイメント」を開きます。

図6-7 Frameworkアプリケーションのホームページへの移動

3. Frameworkアプリケーションの名前を選択して、アプリケーションのホームページを表示します。
「アプリケーション・デプロイメント」メニューに追加で「WebCenterポータル」メニュー・オプションが表示されます(図6-8)。

図6-8 Portal Frameworkアプリケーションのホームページおよびメニューの表示

「WebCenterポータル」メニューからは、次のようなWebCenter Portal固有の作業を実行できます。

- 詳細なWebCenter Portalパフォーマンス・メトリックのモニター:

- 最近のページ、ドキュメント、ポートレット・プロデューサおよびWebLogicサーバー・メトリック。

- 全体的なページおよびツール/サービス・メトリック。

(第27章「Oracle WebCenter Portalのパフォーマンスのモニタリング」を参照してください。)

- ポートレット・プロデューサの登録と管理(第21章「ポートレット・プロデューサの管理」を参照)。

- アプリケーション設定の構成(どの検索クローラを使用するかなど)、様々な検索設定の微調整、通知用チャネルの設定、およびプロキシ・サーバーの構成。

- バックエンド・サービスへの接続の管理(第8章「ツールおよびサービスの管理」を参照)。

- 外部アプリケーションの管理(第23章「外部アプリケーションの管理」を参照)。

6.4 依存コンポーネントへの移動

WebCenter Portalのページから、WebLogic Serverドメイン、サーバー、Javaコンポーネント、MDSリポジトリなどの関連するコンポーネントに属するページに移動することは簡単です。

- WebCenter Portal: ホームページから「関連コンポーネント」内のリンクをクリックして、WebCenter Portalアプリケーション自体、WebLogic Serverインストール・ページ、およびFusion Middleware Control内のMDSリポジトリ・ページへ移動します。第6.2項「WebCenter Portalのホームページへの移動」も参照してください。

- Portal Frameworkアプリケーション: J2EEアプリケーションのホームページ上の「アプリケーション・デプロイメント」メニューから、Oracle WebLogic Server管理コンソール、およびWebCenter Portal、ADF、MDSリポジトリおよびセキュリティの構成と管理に関連するページへ直接移動できます。第6.3項「Portal Frameworkアプリケーションのホームページへの移動」も参照してください。

7 Oracle WebCenter Portalの管理対象サーバーとアプリケーションの起動および停止

この章では、アプリケーションがデプロイされている管理対象サーバーを再起動する方法について説明します。Fusion Middleware ControlまたはWLSTを使用して行った、WebCenter PortalおよびPortal Frameworkアプリケーション構成のほとんどの変更は、動的ではありません。変更を有効にするには、管理対象サーバーを再起動する必要があります。たとえば、バックエンド・サーバーの接続詳細を変更する場合は、アプリケーションの管理対象サーバーを再起動する必要があります。例外もあります。ポートレット・プロデューサおよび外部アプリケーションの登録は動的です。登録した新規ポートレット・プロデューサや外部アプリケーションは、アプリケーションで即座に使用可能になります。既存の接続に対して行った変更も即座に有効になります。

この章には次のトピックが含まれます:

- 第7.1項「ノード・マネージャの起動」

- 第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」

- 第7.3項「WebCenter Portalアプリケーションの起動および停止」

- 第7.4項「Portal Frameworkアプリケーションの起動および停止」

すべての起動および停止操作は、Oracle WebLogic Server管理コンソールからも実行できます。『Oracle WebLogic Serverサーバーの起動と停止の管理』のサーバーの起動および停止に関する項も参照してください。

注意:
Fusion Middleware ControlまたはOracle WebLogic Server管理コンソールを使用して、管理サーバー、管理対象サーバー、WebCenter PortalおよびPortal Frameworkアプリケーションを起動および停止する前に、ノード・マネージャを実行している必要があります。

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminまたはOperatorロールが付与されている必要があります。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

7.1 ノード・マネージャの起動

Fusion Middleware ControlまたはOracle WebLogic Server管理コンソールを使用して、管理サーバー、管理対象サーバー、WebCenter PortalおよびPortal Frameworkアプリケーションを起動および停止する前に、ノード・マネージャを実行している必要があります。ノード・マネージャはインストールの後に起動されるため、ノード・マネージャを再起動する必要があるのは意図的に停止された場合のみです。

startNodeManager.shを使用してノード・マネージャを起動する方法の詳細は、『Oracle WebLogic Serverノード・マネージャ管理者ガイド』のノード・マネージャの使用に関する項を参照してください。

7.2 WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止

Fusion Middleware ControlまたはWLSTを使用して行った、WebCenter Portal構成のほとんどの変更は、動的ではありません。変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

管理対象サーバーを起動または再起動すると、その管理対象サーバーにデプロイされているすべてのアプリケーションは自動的に起動します。詳細は、表7-1も参照してください。

表7-1 Oracle WebCenter Portal管理対象サーバーおよびアプリケーション

管理対象サーバー

アプリケーション

WC_Spaces

webcenter (WebCenter Portalアプリケーション)

webcenter-help (WebCenter Portalオンライン・ヘルプ)

WC_Portlet

portalTools (OmniPortlet)

wsrp-tools (WSRPツール)

pagelet-producer (ページレット・プロデューサ)

services-producer (WebCenterサービス・プロデューサ)

WC_Collaboration

owc_discussions (ディスカッション・サーバー)

WC_Utilities

analytics-collector (分析)

activitygraph-engines (アクティビティ・グラフ)

wcps-services (パーソナライズ・サービス)

WC_CustomPortal

<your_portal_framework_application_name>

注意:
この項の説明は、表7-1に示すWebCenter Portal管理対象サーバーの起動および停止手順です。他のコンポーネントの管理対象サーバーを起動および停止するには、次を参照してください。

- Oracle WebCenter Content管理対象サーバーは、『Oracle WebCenter Contentのインストールと構成』を参照してください。

- Oracle SOA Server管理対象サーバーは、『Oracle SOA SuiteおよびOracle Business Process Management Suiteインストレーション・ガイド』を参照してください。

管理対象サーバーに特定の起動順序はありませんが、複数の管理対象サーバーを起動する必要がある場合、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理解消サーバーを最後に起動することをお薦めします。

Fusion Middleware Controlを使用してWebCenter Portal管理対象サーバーを起動、停止または再起動する手順は、次のとおりです。

1. Fusion Middleware Controlにログインします。

2. 「ターゲット・ナビゲーション・ペイン」で、「WebLogicドメイン」を開きます。

3. 「wc_domain」を開き、起動または停止する管理対象サーバーを選択します。
管理対象サーバーのホームページが表示されます(図7-2)。

図7-1 管理対象サーバーのホームページ

4. 「WebLogic Server」メニュー:

- 管理対象サーバーを起動するには、「制御」→「起動」を選択します。

- 管理対象サーバーを停止するには、「制御」→「停止」を選択します。

図7-2 管理対象サーバーの起動または停止

あるいは、「ターゲット・ナビゲーション・ペイン」で管理対象サーバーの名前を右クリックして、管理対象サーバーのメニュー・オプションにアクセスします。

コマンド行ツールを使用してWebCenter Portal管理対象サーバーを起動または停止するには、管理者ガイドのOracle WebLogic Serverインスタンスの起動および停止に関する項を参照してください。

7.3 WebCenter Portalアプリケーションの起動および停止

Fusion Middleware ControlからWebCenter Portalを起動、再起動および停止する操作は簡単です。

- Fusion Middleware Controlを使用したWebCenter Portalの起動

- Fusion Middleware Controlを使用したWebCenter Portalの停止

あるいは、WLSTを使用することもできます。

- WLSTを使用したWebCenter Portalの起動

- WLSTを使用したWebCenter Portalの停止

Oracle WebLogic Server管理コンソールを使用してWebCenter Portalを起動することもできます。詳細は、管理者ガイドのOracle WebLogic Server管理コンソールの表示に関する項を参照してください。

注意:
アプリケーション構成を変更したら、WebCenter PortalがデプロイされているWC_Spaces管理対象サーバーを再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

7.3.1 Fusion Middleware Controlを使用したWebCenter Portalの起動

WebCenter Portalを起動すると、ユーザーがアプリケーションを使用できるようになり、停止すると使用できなくなります。

Fusion Middleware Controlを使用してWebCenter Portalを起動するには:

1. Fusion Middleware Controlで、WebCenter Portalアプリケーションのホームページに移動します。
第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. WebCenter Portalのメイン・メニューから、「WebCenter」→「ポータル」→「制御」→「起動」を選択します。
あるいは、「WC_Spaces」を「ターゲット・ナビゲーション・ペイン」で右クリックして、このメニュー・オプションにアクセスします。

進行状況メッセージが表示されます。

3. 「閉じる」をクリックします。

アプリケーションのステータスが「稼働中」(緑色の矢印)に変化する様子に注意してください。

7.3.2 WLSTを使用したWebCenter Portalの起動

WLSTコマンドのstartApplicationを使用して、WebCenter Portalを起動します。コマンドの構文と詳細な例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のstartApplicationに関する項を参照してください。

WebCenter Portalアプリケーションの場合、appName引数は必ずwebcenterになります。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

7.3.3 Fusion Middleware Controlを使用したWebCenter Portalの停止

WebCenter Portalアプリケーションを停止すると、誰もそのアプリケーションを使用できなくなります。アプリケーションを停止してもそのソース・ファイルはサーバーから削除されません。停止したアプリケーションを後で再起動すると、再び利用できます。

WebCenter Portalを停止しても、WebCenter Portalアプリケーションがデプロイされている管理対象サーバー(WC_Spaces)は引き続き使用できます。

Fusion Middleware Controlを使用してWebCenter Portalアプリケーションを停止するには:

1. Fusion Middleware Controlで、WebCenter Portalのホームページに移動します。
第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. メイン・メニューから、「WebCenter」→「ポータル」→「制御」→「停止」を選択します。
あるいは、「WC_Spaces」を「ターゲット・ナビゲーション・ペイン」で右クリックして、このメニュー・オプションにアクセスします。

3. 「OK」をクリックして続行します。
進行状況メッセージが表示されます。

4. 「閉じる」をクリックします。

ステータスが「停止中」(赤色の矢印)に変化する様子に注意してください。

7.3.4 WLSTを使用したWebCenter Portalの停止

WLSTコマンドのstopApplicationを使用して、WebCenter Portalアプリケーションを停止します。コマンドの構文と詳細な例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のstopApplicationに関する項を参照してください。

WebCenter Portalアプリケーションの場合、appName引数は必ずwebcenterになります。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

7.4 Portal Frameworkアプリケーションの起動および停止

Fusion Middleware ControlからPortal Frameworkアプリケーションを起動および停止する操作は簡単です。

- Fusion Middleware Controlを使用したPortal Frameworkアプリケーションの起動

- Fusion Middleware Controlを使用したPortal Frameworkアプリケーションの停止

あるいは、WLSTを使用することもできます。

- WLSTを使用したPortal Frameworkアプリケーションの起動

- WLSTを使用したPortal Frameworkアプリケーションの停止

Oracle WebLogic Server管理コンソールを使用してPortal Frameworkアプリケーションを起動することもできます。詳細は、管理者ガイドのOracle WebLogic Server管理コンソールの表示に関する項を参照してください。

注意:
アプリケーション構成を変更したら、Portal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

7.4.1 Fusion Middleware Controlを使用したPortal Frameworkアプリケーションの起動

Portal Frameworkアプリケーションを起動すると、ユーザーがアプリケーションを使用できるようになり、停止すると使用できなくなります。

Portal Frameworkアプリケーションを停止しても、アプリケーションがデプロイされている管理対象サーバーは引き続き使用できます。

Fusion Middleware Controlを使用してPortal Frameworkアプリケーションを起動するには:

1. Fusion Middleware Controlで、Portal Frameworkアプリケーションのホームページに移動します。
第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「アプリケーション・デプロイメント」メニューから、「アプリケーション・デプロイメント」→「制御」→「起動」を選択します。
あるいは、Portal Frameworkアプリケーションの名前を「ターゲット・ナビゲーション・ペイン」で右クリックして、このメニュー・オプションにアクセスします。

進行状況メッセージが表示されます。

3. 「閉じる」をクリックします。

アプリケーションのステータスが「稼働中」(緑色の矢印)に変化する様子に注意してください。

7.4.2 WLSTを使用したPortal Frameworkアプリケーションの起動

WLSTコマンドのstartApplicationを使用して、Portal Frameworkアプリケーションを起動します。コマンドの構文と詳細な例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のstartApplicationに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

7.4.3 Fusion Middleware Controlを使用したPortal Frameworkアプリケーションの停止

Portal Frameworkアプリケーションを停止すると、誰もそのアプリケーションを使用できなくなります。アプリケーションを停止してもそのソース・ファイルはサーバーから削除されません。停止したアプリケーションを後で再起動すると、再び利用できます。

注意:
Oracle WebLogic Server管理コンソールを使用してWebCenter Portalを停止することもできます。詳細は、管理者ガイドのOracle WebLogic Server管理コンソールの表示に関する項を参照してください。

Portal Frameworkアプリケーションを停止するには:

1. Fusion Middleware Controlで、Portal Frameworkアプリケーションのホームページに移動します。
第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

2. メイン・メニューから、「アプリケーション・デプロイメント」→「制御」→「停止」を選択します。
あるいは、Portal Frameworkアプリケーションの名前を「ターゲット・ナビゲーション・ペイン」で右クリックして、このメニュー・オプションにアクセスします。

3. 「OK」をクリックして続行します。
進行状況メッセージが表示されます。

4. 「閉じる」をクリックします。

ステータスが「停止中」(赤色の矢印)に変化する様子に注意してください。

7.4.4 WLSTを使用したPortal Frameworkアプリケーションの停止

WLSTコマンドのstopApplicationを使用して、Portal Frameworkアプリケーションを停止します。コマンドの構文と詳細な例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のstopApplicationに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

第V部

ツール、ポートレット・プロデューサおよび外部アプリケーションの管理

『Oracle WebCenter Portalの管理』のこの部では、WebCenter PortalおよびPortal Frameworkアプリケーションで使用するツール、サービス、ポートレット・プロデューサおよび外部アプリケーションの管理タスクについて説明します。

第V部の内容は次のとおりです。

- 第8章「ツールおよびサービスの管理」

- 第9章「コンテンツ・リポジトリの管理」

- 第10章「アクティビティ・グラフの管理」

- 第11章「分析の管理」

- 第12章「お知らせおよびディスカッションの管理」

- 第13章「カレンダ・イベントの管理」

- 第14章「インスタント・メッセージおよびプレゼンスの管理」

- 第15章「メールの管理」

- 第16章「ピープル・コネクションの管理」

- 第17章「RSSの管理」

- 第18章「WebCenter PortalでのOracle Secure Enterprise Searchの管理」

- 第19章「サブスクリプションおよび通知の管理」

- 第20章「ワークリストの管理」

- 第21章「ポートレット・プロデューサの管理」

- 第22章「ページレット・プロデューサの管理」

- 第23章「外部アプリケーションの管理」

- 第24章「RESTサービスの管理」

- 第25章「パーソナライズの管理」

- 第26章「Microsoft Office統合の管理」

8 ツールおよびサービスの管理

この章では、WebCenter PortalおよびPortal Frameworkアプリケーションにおけるツールとサービスの管理の概要について説明します。また、必要なバックエンド・サーバーについて説明し、ポータルでツールとサービスを有効化する際の情報も提供します。これらのタスクは、システム管理者がアプリケーション・レベルで実行します。『Oracle WebCenter Portalでのポータルの構築』のポータル・ツールおよびサービスの概要に関する項で説明されているように、ポータル・レベルでツールとサービスを使用することは、アプリケーション・スペシャリストまたはポータル・モデレータのタスクです。

この章には次のトピックが含まれます:

- 第8.1項「ツールおよびサービスの管理の概要」

- 第8.2項「ツールおよびサービスのバックエンド・データ・リポジトリの構成」

- 第8.3項「WebCenter Portalのツールおよびサービスについて」

- 第8.4項「Portal Frameworkアプリケーションのツールおよびサービスについて」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

8.1 ツールおよびサービスの管理の概要

WebCenter PortalおよびPortal Frameworkアプリケーションは、ツールとサービス使用して、コラボレーション、ソーシャル・ネットワーキングおよび個人生産性の機能を公開し、またツールとサービスはタスク・フローを使用して、それらの機能のサブセットを公開します。タスク・フローには、特定のツールまたはサービスから利用できるすべての機能または一部の機能を公開できる、再利用可能な機能が用意されています。

一部のツール(タグなど)は初期状態で使用しても正しく動作しますが、その他のツールは追加の構成(外部バックエンド・サーバーへの接続など)が必要になります。次のツールとサービスでは、関連情報が格納されている外部データ・リポジトリやサーバー(コンテンツ・サーバー、プレゼンス・サーバー、ディスカッション・サーバー、メール・サーバーなど)との接続が必要です。

- 分析

- お知らせ

- ディスカッション

- ドキュメント(Wikiおよびブログを含む)

- イベント

- インスタント・メッセージおよびプレゼンス(IMP)

- メール

- RSS

- 検索(Oracle SESアダプタ用)

- ワークリスト

また、次のツールとサービスでは、関連情報(リレーションシップ・マッピングなど)が格納されているデータベース・スキーマとの接続が必要です。

- アクティビティ・グラフ

- 分析

- ドキュメント(コメントおよびアクティビティ・ストリームを含めるドキュメント、Wikiおよびブログ用)

- リンク

- リスト

- ピープル・コネクション

- 投票

- タグ

表8-1に、各種のツールとサービスに関連するデータが格納される場所(MDS、データベース、または外部のリポジトリやサーバー)を示します。これらのリポジトリのいずれか1つが使用できないときに影響を受けるツールやサービスを知っておくと便利です。

- MDS: ツールやサービスによっては、接続メタデータをメタデータ・サービス・リポジトリ(MDS)に格納します。デプロイした後にアプリケーションに加えた変更は、MDSにカスタマイズとして格納されます。詳細は、第1.3.5項「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。
WebCenter Portalでは、第8.2.1項「MDSリポジトリの設定」で説明されているように、MDSはデフォルトでインストールおよび構成されます。 Portal Frameworkアプリケーションについては、第42.1.5項「メタデータ・サービス・リポジトリの作成および登録」を参照してください。

- データベース: ツールやサービスによっては、関連情報(リレーションシップ・マッピングなど)が格納されているデータベース・スキーマとの接続が必要です。
詳細は、第8.2.2項「データベース接続の設定」を参照してください。

- 外部リポジトリまたはサーバー: ツールやサービスによっては、関連情報が格納されている外部データ・リポジトリ(コンテンツ・サーバー、プレゼンス・サーバーまたはメール・サーバーなど)との接続が必要です。
これらの接続の設定の詳細は、このガイドの関連する章を参照してください(表8-1を参照)。たとえば、外部ディスカッション・サーバーへの接続の設定方法の詳細は、第12章「お知らせおよびディスカッションの管理」を参照してください(表8-1の関連情報の列を参照)。

関連項目:
WebCenter Portalに固有の情報は、第8.3項「WebCenter Portalのツールおよびサービスについて」を参照してください。

表8-1 ツールとサービスのデータ・リポジトリ

ツールとサービス

説明

MDS

データベース・スキーマ

外部アプリケーション

関連情報

アクティビティ・グラフ

コネクションの対象としてユーザーが関心を持つ可能性がある人々、ポータルおよびコンテンツを、既存のコネクションと、ポータル内のオブジェクトとの共有された対話に基づいて推奨します。

ACTIVITIESスキーマ

第8.2.2項「データベース接続の設定」

第10章「アクティビティ・グラフの管理」

アクティビティ・ストリーム

コネクションのアクティビティ、ポータル内で実行したアクション、およびビジネス・アクティビティについてのストリーミング表示を提供します。

ACTIVITIESスキーマ

第8.2.2項「データベース接続の設定」

第16章「ピープル・コネクションの管理」

分析

ポータル・アプリケーションの使用状況とパフォーマンスのメトリックを表示できます。

ACTIVITIESスキーマ

X

第8.2.2項「データベース接続の設定」

第11章「分析の管理」

お知らせ

重要なアクティビティおよびイベントに関するお知らせを投稿できる機能を、認証されたすべてのユーザーに提供します。

X

DISCUSSIONSスキーマ

X

第8.2.1項「MDSリポジトリの設定」

第12章「お知らせおよびディスカッションの管理」

ディスカッション

スレッドで構成されるディスカッションの作成、質問の投稿と返信、および回答の検索が可能な機能を提供します。

X

DISCUSSIONSスキーマ

X

第8.2.1項「MDSリポジトリの設定」

第12章「お知らせおよびディスカッションの管理」

ドキュメント

ファイルのアップロード、ファイルやフォルダの作成と管理、ファイルのチェックアウト、バージョニングなどを含む、コンテンツの管理およびストレージの機能を提供します。これらの機能は、ドキュメント・ツール・コンソールまたはタスク・フロー(ドキュメント・エクスプローラ、ドキュメント・リスト・ビューア、ドキュメント・マネージャなど)で公開します。リンクされたドキュメント、インライン・プレビュー、またはイメージとして個別のファイルをページに表示するコンポーネントを提供します。ドキュメント・ツールは、Wikiとブログの機能もサポートします。

X

WEBCENTERスキーマ: コメントおよびアクティビティ・ストリームを含めるドキュメント用(Wikiとブログを含む)

X

第8.2.1項「MDSリポジトリの設定」

第8.2.2項「データベース接続の設定」

第9章「コンテンツ・リポジトリの管理」

イベント脚注 1

認証されたユーザーの広範囲なグループに関連するイベントのスケジュールの作成およびメンテナンスの機能を提供します。また、Exchangeサーバーが構成されている場合は、Outlookカレンダーから個人用イベントへのアクセスも提供します。

X

WEBCENTERスキーマ(Portalイベント)脚注 2

X (個人イベント)

第8.2.1項「MDSリポジトリの設定」

第13章「カレンダ・イベントの管理」

インスタント・メッセージおよびプレゼンス(IMP)

認証された他のユーザーのステータス(オンライン、オフライン、ビジーまたは退席中)を確認したり、ユーザーに即時に連絡できる機能を提供します。

X

第14章「インスタント・メッセージおよびプレゼンスの管理」

『Oracle WebCenter Portalの使用』の「インスタント・メッセージおよびプレゼンス・ビューアの使用」

リンク

関連情報の表示、アクセスおよび関連付けの機能を提供します。たとえば、ディスカッションからドキュメントにリンクできます。

WEBCENTERスキーマ

第8.2.2項「データベース接続の設定」

Oracle WebCenter Portalの使用のWebCenter Portalの情報のリンク

リスト

リストを作成、公開および管理できる機能を提供します。

X

WEBCENTERスキーマ

第8.2.1項「MDSリポジトリの設定」

第8.2.2項「データベース接続の設定」

『Oracle WebCenter Portalでのポータルの構築』の「情報のリストをポータルに追加する方法」

メール

IMAPおよびSMTPのメール・サーバーとの容易な統合を提供します。これにより、メッセージの表示、添付ファイルを含むメールの作成、メッセージの返信と転送、およびメッセージの削除などのメール機能を実行できます。

X

X

第8.2.1項「MDSリポジトリの設定」

第15章「メールの管理」

メッセージおよびフィードバック

コネクションおよびアクティビティ・ストリームに向けてメッセージ、添付ファイル、フィードバックを投稿する機能を提供します。

X

ACTIVITIESスキーマ

X

第8.2.1項「MDSリポジトリの設定」

第16章「ピープル・コネクションの管理」

ノート脚注 3

素早く書き留める機能、および様々な個人関連情報を保持する機能を提供します。

X

第8.2.1項「MDSリポジトリの設定」

通知

サービスおよびアプリケーション・オブジェクトをサブスクライブして、それらのオブジェクトが変更されると1つ以上のメッセージング・チャネルから通知を受信するための手段を提供します。

第19章「サブスクリプションおよび通知の管理」

ピープル・コネクション

個人プロファイルの作成、現在のステータスの表示、および他のユーザーの最新アクティビティの表示などのソーシャル・ネットワーキング機能を提供します。

WEBCENTERスキーマ

X

第8.2.2項「データベース接続の設定」

第16章「ピープル・コネクションの管理」

投票

関係者の調査(意見および経験レベルなど)、重要な情報を思い出すことができるかどうかの確認、およびフィードバックの収集ができます。

WEBCENTERスキーマ

第8.2.2項「データベース接続の設定」

プロファイル

ユーザーの連絡先情報(電子メール・アドレス、勤務先住所、電話番号など)、部門、上司、写真、ポータルのアクティビティ、パブリック・ドキュメント、およびコネクションについてのビューを提供します。

第16章「ピープル・コネクションの管理」

最近のアクティビティ

ドキュメント、ディスカッションおよびお知らせに対する最新の変更のサマリー・ビューを提供します。

X

第8.2.1項「MDSリポジトリの設定」

第16章「ピープル・コネクションの管理」

RSS

単一の場所(ニュース・リーダー)から多数の異なるWebサイトのコンテンツにアクセスできる機能を提供します。

X

第8.2.1項「MDSリポジトリの設定」

第8.2.4項「プロキシ・サーバーの設定」

第17章「RSSの管理」

検索

サービス、アプリケーション、またはサイト全体を検索する機能を提供します(これには、Oracle Secure Enterprise Searchの統合も含まれます)。

X

X

第8.2.1項「MDSリポジトリの設定」

第18項「WebCenter PortalでのOracle Secure Enterprise Searchの管理」

タグ

1つ以上の個人関連キーワードを特定のページまたはドキュメントに割り当てる機能を提供します。

X

WebCenterスキーマ

第8.2.1項「MDSリポジトリの設定」

第8.2.2項「データベース接続の設定」

ワークリスト

注目する必要のあるビジネス・プロセスの個人ビューを提供します。

X

X

第8.2.1項「MDSリポジトリの設定」

第20章「ワークリストの管理」

脚注 1 個人イベントとポータル・イベントは、WebCenter Portalで利用できます。個人イベントは、Portal Frameworkアプリケーションで利用できます。

脚注 2 ポータル・イベントは、WebCenter Portalでのみ利用できます。

脚注 3 ノートは、WebCenter Portalでのみ利用できます。このサービスは、Portal Frameworkアプリケーションでは利用できません。

8.2 ツールおよびサービスのバックエンド・データ・リポジトリの構成

WebCenter PortalおよびPortal Frameworkアプリケーションで特定のツールとサービスを動作させるには、各種のバックエンド・データ・リポジトリを構成する必要があります。

この項の内容は次のとおりです。

- 第8.2.1項「MDSリポジトリの設定」

- 第8.2.2項「データベース接続の設定」

- 第8.2.3項「バックエンド・サーバー接続の設定」

- 第8.2.4項「プロキシ・サーバーの設定」

- 第8.2.5項「外部アプリケーション接続の設定」

- 第8.2.6項「コンポーザ固有の構成の設定」

8.2.1 MDSリポジトリの設定

ツールやサービスによっては、メタデータ・サービス・リポジトリ(MDS)に情報を格納します。WebCenter PortalまたはPortal Frameworkアプリケーションでこれらのツールやサービスを有効化するには、MDSリポジトリを構成する必要があります。

WebCenter Portalでは、MDSはデフォルトでインストールおよび構成されます。

Portal Frameworkアプリケーションについては、第42.1.5項「メタデータ・サービス・リポジトリの作成および登録」を参照してください。

関連項目:
管理者ガイドのメタデータ・リポジトリの管理に関する項およびOracle WebCenter Portalデータのパージに関する項を参照してください。

8.2.2 データベース接続の設定

多くのツールやサービスは、WebCenter Portalリポジトリに情報を格納します。このリポジトリは、WebCenter Portalスキーマ(WEBCENTER)がインストールされているデータベースです。これらのツールとサービスの完全なリストについては、表8-1を参照してください。たとえば、リンク・サービスでは、どのオブジェクトがどのオブジェクトにリンクされているかといった、関連マッピング情報をこのデータベースに格納します。その他のツール(分析やアクティビティ・グラフなど)では、ACTIVITIESスキーマが必要になります。

WebCenter Portalには、WEBCENTERおよびACTIVITIESスキーマがデフォルトで構成されます。そのため、さらに構成を行う必要がありません。

Portal Frameworkアプリケーションには、必要に応じてデータベース接続を設定する必要があります。このデータベース接続は、JDBCデータ・ソースまたはJDBC URLのどちらかのタイプにできます。

関連項目:

- 接続の作成およびスキーマのインストールの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のデータベース接続の設定に関する項を参照してください。

- アプリケーションを本番環境にデプロイするときのデータ・ソースの注意点は、第42.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」を参照してください。

- この情報のバックアップおよび移行の詳細は、第44章「Portal Frameworkアプリケーションのエクスポート、インポート、バックアップおよびリカバリの管理」を参照してください。

アプリケーションで使用される接続タイプに応じて、次のいずれかを実行します。

- 間接パスワードを使用するアプリケーションレベルのデータ・ソースがアプリケーションに含まれていない場合、グローバル・データ・ソースを作成します。グローバル・データ・ソースの作成の詳細は、管理者ガイドのJDBCデータ・ソースの作成と管理に関する項を参照してください。

- 間接パスワードを使用するアプリケーションレベルのデータ・ソースをアプリケーションが使用している場合、接続資格証明をマップします。パスワードの設定は、Oracle WebLogic管理コンソールを使用して、「セキュリティ」の「資格証明マッピング」タブで行います。「構成」の「接続プール」タブで間接データ・ソースのパスワードを変更しても、影響はありません。資格証明マッピングの詳細は、『Oracle WebLogic Server JDBCデータ・ソースの構成と管理』のJDBCデータ・ソースの作成に関する項で、JDBCデータ・ソースのセキュリティの資格証明マッピングに関する記載を参照してください。

- アプリケーションがJDBC URL接続を使用する場合、グローバル・アプリケーション・ストアの情報とアプリケーション資格証明ストアに格納されている情報をマージします。資格証明の移行動作の詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の資格証明ストアの構成に関する項を参照してください。

典型的なビジネスのシナリオでは、アプリケーションは別々の管理対象サーバーにデプロイされて、それらのアプリケーションのために複数のデータベースがリポジトリとして使用されます。開発環境で使用するリポジトリは、本番環境で使用するリポジトリとは異なります。そのため、Portal Frameworkアプリケーションを開発環境から本番環境に移行するときは、データベース接続を再構成する必要があります。

リポジトリ接続を再構成すると、WARファイルのWEB-INFディレクトリにあるローカルのdatasourceファイルおよび*-jdbc.xmlファイルは、新しい接続詳細で更新されます。ただし、JNDI Nameおよびdata source名は変更されません。なんらかの理由でJNDI Nameを変更したら、adf-config.xmlファイルも更新する必要があります。JNDI名は、jdbc/connection-nameDSの形式で指定する必要があります。たとえば、connection1という接続名がアプリケーションで使用されている場合、JNDI名はjdbc/connection1DSとなります。

8.2.3 バックエンド・サーバー接続の設定

ツールやサービスによっては、関連情報が格納されている外部データ・リポジトリ(コンテンツ・サーバー、プレゼンス・サーバーまたはメール・サーバーなど)との接続が必要です。これらのツールとサービスの完全なリスト、およびこのガイド内の関連する章へのリンクについては、表8-1を参照してください。リンク先には、接続構成についての説明があります。

管理者は、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用して、WebCenter PortalおよびPortal Frameworkアプリケーションがデプロイされるバックエンド・サーバーの接続を確認および構成してください。

注意:
Fusion Middleware ControlまたはWLSTを使用してサービス構成に対して加えた変更のほとんどは、動的ではありません。変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

8.2.4 プロキシ・サーバーの設定

WebCenter PortalまたはPortal Frameworkアプリケーションのアクティビティ・ストリームのタスク・フローで外部RSSニュース・フィードおよび外部リンクを有効化するには、プロキシ・サーバーが必要になります。RSSサービスおよびアクティビティ・ストリーム・サービスは、同じプロキシ・サーバー設定を共有します。

プロキシ・サーバーは、Fusion Middleware ControlまたはWLSTを使用して設定できます。

この項には次のサブセクションが含まれます:

- 第8.2.4.1項「Fusion Middleware Controlを使用したプロキシ・サーバーの設定」

- 第8.2.4.2項「WLSTを使用したプロキシ・サーバーの設定」

8.2.4.1 Fusion Middleware Controlを使用したプロキシ・サーバーの設定

Fusion Middleware Controlを使用してプロキシ・サーバーを設定するには:

1. Fusion Middleware Controlにログインし、アプリケーションのホームページに移動します。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「アプリケーション構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「アプリケーション構成」を選択します。

3. 「プロキシ・サーバー」セクションに、プロキシ・サーバーのホスト名とポート番号を入力します。詳細は、表8-2を参照してください。

表8-2 RSSプロキシ・サーバーの詳細

フィールド

説明

プロキシ・ホスト

プロキシ・サーバーのホスト名を入力します。

プロキシ・ポート

プロキシ・サーバーが実行されているポート番号を入力します。

4. 「適用」をクリックして、この接続を保存します。

5. アプリケーションがデプロイされている管理対象サーバーを再起動します。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

8.2.4.2 WLSTを使用したプロキシ・サーバーの設定

WLSTコマンドsetWebCenterProxyConfigを使用して、RSSニュース・フィードおよびアクティビティ・ストリーム・タスク・フローによって使用される、プロキシ・ホストおよびポート番号を指定します。例:

setWebCenterProxyConfig(appName='webcenter', proxyHost='www-proxy.example.com', proxyPort='80')

コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetWebCenterProxyConfigに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
新しいプロキシ詳細を使用して起動するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

getWebCenterProxyConfigコマンドを使用して、RSSおよびアクティビティ・ストリーム・タスク・フローによって使用されている現在のプロキシ・ホストおよびポートを検出します。例:

getWebCenterProxyConfig(appName='webcenter')

プロキシ・ホストおよびポートの現在の設定を削除する場合、unsetWebCenterProxyConfigコマンドを使用します。例:

unsetWebCenterProxyConfig(appName='webcenter')

詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のプロキシ・サーバーに関する項を参照してください。

8.2.5 外部アプリケーション接続の設定

自身の認証を行うアプリケーションと、ツールまたはサービスが対話する場合、資格証明プロビジョニングをできるように、そのアプリケーションと外部アプリケーション定義を関連付けることができます。外部アプリケーションでの作業の詳細は、第23章「外部アプリケーションの管理」を参照してください。

ヒント:
これらのツールとサービスのいくつか(たとえば、IMP、イベント、メール)に同一のLDAPサーバーと資格証明を使用する予定がある場合は、それらのために単一の接続を作成して、共有される接続全体で使用するプロパティを指定することを検討してください。
頻繁なパスワード変更が必要になる追加の制約が要求されるアイデンティティ・ストアでは、単一の共有接続を作成すると特に便利です。外部アプリケーション接続を1つのみ作成することで、パスワード変更後の無効なログインの試行が最小限に抑えられるようになり、パスワード・ロックアウトの発生を回避できます。

次のツールとサービスでは、接続や認証の定義に外部アプリケーションを使用できます。

- ドキュメント

- イベント

- インスタント・メッセージおよびプレゼンス

- メール

- RSSビューア(保護されているRSSフィード使用時)

8.2.6 コンポーザ固有の構成の設定

コンポーザでは、ブラウザでランタイム・アプリケーションおよびインプレースのユーザー・カスタマイズを実行できます。デフォルトでは、コンポーザは、アドオンのパネル登録およびサンドボックス構成などの様々なページ・エディタ設定にあわせて構成されています。デフォルト値が要件に合わない場合は、デプロイされたアプリケーションにあわせて修正できます。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のadf-config.xmlに関する項を参照してください。

コンポーザ構成を表示または修正するには、Fusion Middleware ControlのシステムMBeanブラウザを使用します。

デフォルトのコンポーザ設定を修正する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. システムMBeanブラウザを開きます。

- WebCenter Portalアプリケーションの場合: 「WebCenterポータル」メニューから、「システムMBeanブラウザ」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「システムMBeanブラウザ」を選択します。

3. WebCenter Portalアプリケーションで次の順に移動します。
「アプリケーション定義のMBean」→「oracle.adf.share.config」→「サーバー: WC_Spaces」→「アプリケーション: webcenter」→「ADFConfig」→「ADFConfig」(bean)→「ADFConfig」→「PageEditorConfiguration」
図8-1に示すように、「アプリケーション定義のMBean」ページが表示されます。

Portal Frameworkアプリケーションの場合は、Server: WC_Spacesをアプリケーションがデプロイされている管理対象サーバー名に置き換え、Application: webcenterをアプリケーション名に置き換えます。

ヒント:
あるいは、次のようにPageEditorConfiguration MBeanに移動できます。

- WebCenter Portalの場合: 「WebCenterポータル」メニュー→「ADF」→「ADFの構成(adf-config)」

- Portal Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニュー→「ADF」→「ADFの構成(adf-config)」
次に、「ADFConfig (bean)」→「ADFConfig」→「PageEditorConfiguration」に移動します。

図8-1 システムMBeanブラウザ: コンポーザ・プロパティ

4. 「属性と操作」タブの各種コンポーザ設定の説明と値を表示できます。
設定が読取り専用ではない場合は、必要に応じて値を変更できます。たとえば、ソース・ビューを無効にする場合は、EnableSourceView属性でfalseを設定できます。さらに、アドオン・パネルを追加または更新する場合は、「操作」タブでaddOrUpdateAddonPanelを使用できます。

詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のadf-config.xmlに関する項を参照してください。

5. 「適用」をクリックします。

6. 親ADFConfig MBeanに移動して、選択します。

7. 「操作」タブで、「保存」をクリックします。

8. 「起動」をクリックします。

9. 新しい設定の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動します。
たとえば、WebCenter Portalの場合は、WC_Spaces管理対象サーバーを再起動します。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

8.3 WebCenter Portalのツールおよびサービスについて

システム管理者は、外部サーバーへの接続の管理を担当します。また、データベース・スキーマと、WebCenter Portalに固有のアプリケーション・データを格納するMetadata Service (MDS)リポジトリのメンテナンスも担当します。詳細は、第3章「WebCenter Portalのメンテナンス」を参照してください。

バックエンド・サーバーが意図的またはその他の理由で構成されていない場合、WebCenter Portalは、そのツールに関連する機能を提供できなくなります。

- 関連するタスク・フローは、リソース・カタログで利用できなくなります。

- 既存のタスク・フローは、ツールまたはサービスが利用できないことを示すメッセージを表示します。

- ツールまたはサービスは、ポータルの管理設定からモデレータが利用できるものとしてリストされなくなります。

有効な接続が存在する場合は、関連するツールまたはサービスがWebCenter Portalで利用できます。詳細は、第8.3.1項「WebCenter Portalでのツールおよびサービスの有効化と無効化」を参照してください。

WebCenter Portalの「管理」の「ツールとサービス」ページでは、いくつかのオプション構成を必要に応じて実行できます。詳細は、第8.3.2項「WebCenter Portalのツールおよびサービスの構成」を参照してください。

ツールおよびサービスの一時的な問題のレポート

ツールまたはサービスが一時的に利用できない場合、システム管理者は、Fusion Middleware Controlを使用してサービスに関連する問題を調査、診断および解決できます。第6.2項「WebCenter Portalのホームページへの移動」も参照してください。

ツールおよびサービスが利用できないときのタスク・フローの非表示

ほとんどのツールとサービスはオプションです。特定のツールやサービスを一時的または永続的にアプリケーションで提供しないことにする場合は、デフォルトの初期設定で表示される、関連するタスク・フローの削除を検討してください。

特定のポータルに対するツールおよびサービスの有効化と無効化

モデレータは、ポータル内で使用可能なツールを有効化または無効化できます。『Oracle WebCenter Portalでのポータルの構築』のポータルで利用可能なツールおよびサービスの有効化と無効化に関する項を参照してください。

8.3.1 WebCenter Portalでのツールおよびサービスの有効化と無効化

WebCenter Portalが提供するツールとサービスにより、ポータルのメンバーは、それらのツールとサービスに関連付けられた各種のタスク・フローを使用してコラボレーションとコミュニケーションが可能になります。リストなど、一部のツールはデフォルトで使用できるため、さらに構成を行う必要はありません。その他のツール(ディスカッションなど)や、その他のサービス(メールなど)では、バックエンド・サーバーへの接続と追加の構成が必要です。第8.1項「ツールおよびサービスの管理の概要」を参照してください。

有効な接続が存在する場合は、関連するツールまたはサービスがWebCenter Portalで利用できます。メール・サービスを除き、ツールまたはサービスがテンプレートに組み込まれていない場合は、ポータル・モデレータまたはアプリケーション・スペシャリストがポータル内でツールやサービスを有効にする必要があります。メール・サービスは、ポータルの作成時に有効化されます。また、メール・サービスは、システム管理者によって構成されていると、個別のポータルでは無効化できなくなります。ポータル・テンプレートにツールが組み込まれていると、そのツールは最初に使用されるときに有効になります。モデレータは、ポータル内のツールを手動で無効化できます。ただし、メール・サービスは除きます。システム管理者によってメールが構成されると、個別のポータルではメールを無効化できなくなります。

モデレータがポータルでツールを手動で有効にした場合は、WebCenter Portalがバックエンド・サーバーで必要な構成を処理します。たとえば、ポータル・モデレータがポータルでディスカッションを有効にした場合、WebCenter Portalはディスカッション・サーバー上でそのポータル用にディスカッション記憶域を構成し、ロールマッピング・ベースの認可を実行しますが、これはつまり、ポータル内でユーザーがディスカッションと連携できるWebCenter Portalのロールを、ディスカッション・サーバー上の対応するロールにマップするということです。第43.4.2.2.2項「ディスカッション・サーバーのロール・マッピング」も参照してください。ロールマッピングが失敗した場合は、ポータル・モデレータにメールで通知されますが、ユーザーはディスカッションにはアクセスできません。

新しいポータルの作成に使用したテンプレートでツールが有効化されている場合は、そのツールに初めてユーザーがアクセスしたときに、WebCenter Portalにより、バックエンド・サーバーの構成が処理されます。たとえば、/webcenter/portal/PortalName/Discussionsにあるポータルの「ディスカッション」ページにユーザーが初めて移動すると、WebCenter Portalは、ディスカッション・サーバーにそのポータル用のディスカッション記憶域を構成し、ロール・マッピング・ベースの認可を実行して、ディスカッション・ページを表示します。

次のツールとサービスは、ポータル・テンプレートに組み込まれていると、初回使用時に自動的に有効化できます。

- お知らせ

- ディスカッション

- イベント

- リスト

- ドキュメント(Wikiおよびブログを含む)

注意:
以前のリリースでは、これらのツールとサービスは、初回使用時ではなく、ポータルの作成時に有効化されていました。『Oracle WebCenter Portalでのポータルの構築』のポータルで利用可能なツールおよびサービスの有効化と無効化に関する項を参照してください。

ほとんどの場合、ポータル・モデレータは独自のポータルのツールとサービスを管理しますが、WebCenter Portalのシステム管理者は、この作業を必要に応じて実行することもできます。ポータルでのツールおよびサービスの有効化と無効化の詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルで利用可能なツールおよびサービスの有効化と無効化に関する項を参照してください。

8.3.2 WebCenter Portalのツールおよびサービスの構成

ツールとサービスは、この章で前述したように、システム管理者が該当するバックエンド・アプリケーションに対する設定と接続を行うことで構成されます。

この接続が存在していると、ポータルでツールやサービスが利用できます。ポータル・モデレータは、各自のポータルでツールとサービスの管理を担当します。ただし、システム管理者の場合は、WebCenter Portalの「管理」の「ツールとサービス」ページを使用して、WebCenter Portalの追加構成の一部を設定できます。

WebCenter Portalの「管理」の「ツールとサービス」ページにあるオプションを構成するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「ツールとサービス」をクリックします。
ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/tools

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

図8-2 WebCenter Portalの「ツールとサービス」ページ

2. 使用可能なタブをクリックして、デフォルトの構成を表示します。
タブの詳細は、オンライン・ヘルプ・アイコンをクリックしてください。

3. ツールとサービスの一部には、オプションで追加の構成を実行できます。

- ディスカッション - ディスカッションを格納するルート・カテゴリを変更します。詳細は、第12.11項「WebCenter Portalのディスカッション・フォーラム・オプションの構成」を参照してください。

- 検索 - Oracle SES 11.2.2.2 が構成される場合は、表示する検索結果のタイプを選択したり、その他のカスタマイズを行うこともできます。詳細は、第18章「WebCenter PortalでのOracle Secure Enterprise Searchの管理」を参照してください。

- 外部アプリケーション - 新しい外部アプリケーションを登録します。または、既存の外部アプリケーションを編集および登録解除します。詳細は、第23章「外部アプリケーションの管理」を参照してください。

- メール - WebCenter Portalのデフォルトのメール・クライアントに、ローカル・メール・クライアントかWebCenter Portalのメール・サービスのいずれかを指定します。詳細は、第15.10項「WebCenter Portalのメール通知の送信の構成」を参照してください。

- ピープル・コネクション - ピープル・コネクション機能のオプションを設定します。詳細は、第16.3項「WebCenter Portalのピープル・コネクションの構成」を参照してください。

- ポートレット・プロデューサ - 新しいポートレット・プロデューサを登録します。または、既存のポートレット・プロデューサを編集および登録解除します。詳細は、第21章「ポートレット・プロデューサの管理」を参照してください。

8.4 Portal Frameworkアプリケーションのツールおよびサービスについて

バックエンド・サーバーが意図的またはその他の理由で構成されていない場合、アプリケーションは、そのツールに関連する機能を提供できなくなります。

- 関連するタスク・フローは、リソース・カタログで利用できなくなります。

- 既存のタスク・フローは、ツールが利用できないことを示すメッセージを表示します。

有効な接続が存在する場合は、関連するツールまたはサービスが利用できるようになります。

ツールおよびサービスの一時的な問題のレポート

ツールまたはサービスが一時的に利用できない場合、システム管理者は、Fusion Middleware Controlを使用してツールとサービスに関連する問題を調査、診断および解決できます。

ツールおよびサービスが利用できないときのタスク・フローの非表示

ほとんどのツールとサービスはオプションです。開発者が特定のツールやサービスを削除する場合や、一時的または永続的にPortal Frameworkアプリケーションで提供しないことにする場合は、それに関連するタスク・フローをアプリケーションから削除することを検討してください。

9 コンテンツ・リポジトリの管理

この章では、WebCenter PortalおよびPortal Frameworkアプリケーションで使用されるコンテンツ・リポジトリを構成および管理する方法について説明します。

この章の内容は次のとおりです。

- 第9.1項「コンテンツ・リポジトリについて」

- 第9.2項「Oracle WebCenter Content Serverリポジトリの構成」

- 第9.3項「Microsoft SharePointリポジトリの構成」

- 第9.4項「Oracle Portalリポジトリの構成」

- 第9.5項「ファイル・システム・リポジトリの構成」

- 第9.6項「WebCenter PortalまたはPortal Frameworkアプリケーション用のコンテンツ・リポジトリの登録」

- 第9.7項「アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」

- 第9.8項「コンテンツ・リポジトリ接続の詳細の変更」

- 第9.9項「コンテンツ・リポジトリ接続の削除」

- 第9.10項「WebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定」

- 第9.11項「コンテンツ・リポジトリ接続のテスト」

- 第9.12項「最大ファイル・アップロード・サイズの変更」

- 第9.13項「コンテンツ・リポジトリに関する問題のトラブルシューティング」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

9.1 コンテンツ・リポジトリについて

Oracle WebCenter PortalはJCR 1.0のオープン・ドキュメント標準をサポートしているため、複数のバックエンド・コンテンツ・ストアとの統合が可能です。Oracle WebCenter Portalは、コンテンツ・リポジトリとして、Oracle WebCenter Content Server (Content Server)、Microsoft SharePoint、Oracle Portalおよびファイル・システムをサポートしています。

Oracle WebCenter Portalでは、次のものを使用したコンテンツ統合が可能です。

- コンテンツ・リポジトリ・データ・コントロール: コンテンツ・リポジトリへの読取り専用アクセスを可能にし、WebCenter PortalおよびPortal Frameworkアプリケーションへのコンテンツの表示方法の厳格な制御を維持します。

- ドキュメント・ツール: 組織のコンテンツ・リポジトリに含まれているドキュメントおよび他のタイプのコンテンツをユーザーが表示および管理できるようにします。

- コンテンツ・プレゼンタ: エンド・ユーザーが様々な方法でコンテンツを選択し、利用可能な表示テンプレートを使用してコンテンツ・アイテムを表示できるようにします。コンテンツ・プレゼンタ・タスク・フローは、ポータルの開発中に追加するか、実行時にWebCenter PortalおよびPortal Frameworkアプリケーションで編集可能なページに追加できます。

これらのコンテンツ統合機能を使用するには、WebCenter PortalまたはPortal Frameworkアプリケーション用にコンテンツ・リポジトリに対して接続を1つ以上構成する必要があります。

コンテンツ・リポジトリ接続について

ポータル・ユーザーはファイルを格納、公開および共有する必要があります。ドキュメント・ツールは、コンテンツのアップロード、ファイルとフォルダの作成および管理、ファイルのチェックアウト、バージョニングなどを含む、コンテンツの管理と格納の機能をWebCenter PortalおよびPortal Frameworkアプリケーションに提供します。ドキュメント・ツールを使用するには、コンテンツ・リポジトリ接続を1つ以上構成し、それをアクティブ(デフォルトのコンテンツ・リポジトリとも呼ばれる)としてマークする必要があります。

注意:
WebCenter PortalおよびPortal Frameworkアプリケーションでは複数のコンテンツ・リポジトリ接続がサポートされています。
ただし、iFrameは、デフォルトのコンテンツ・サーバー接続でのみサポートされます。そのため、ポータル・マネージャが「ドキュメント」タスク・フローまたはコンテンツ・プレゼンタのプロパティを設定するとき、それらのタスク・フローがiFrameを使用してPDFファイルなどのファイル・コンテンツを表示する場合、デフォルト以外のコンテンツ・サーバー接続を指定できません。

- WebCenter Portal: ドキュメント・ツールが独自のドキュメント・フォルダをWebCenter PortalのデフォルトのContent Server上に作成できる任意のポータル(ホーム・ポータルを含む)。WebCenter PortalではContent Serverをデフォルトのコンテンツ・リポジトリにする必要がありますが、サポートされている他のいずれかのリポジトリにWebCenter Portalを接続することも可能です。
デフォルトのコンテンツ・リポジトリの設定の詳細は、第9.7項「アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」を参照してください。WebCenter Portalのデフォルトのコンテンツ・リポジトリに対する追加プロパティの設定の詳細は、第9.10項「WebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定」を参照してください。

- Portal Frameworkアプリケーション: コンテンツ・リポジトリをアクティブに設定すると(第9.7項「アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」を参照)、特定の接続詳細が指定されていないインスタンスでは、そのコンテンツ・リポジトリがドキュメント・タスク・フローで使用されます。使用するデフォルトのコンテンツ・リポジトリについては、特定の要件はありません。

Content Serverがデフォルトのコンテンツ・リポジトリである場合(WebCenter Portalでは必須)、WebCenter PortalまたはPortal Frameworkアプリケーションで使用されるものと同じアイデンティティ・ストアにContent Serverを接続する必要があります。

他のサービス接続と同様に、デプロイ後のコンテンツ・リポジトリ接続は、Fusion Middleware ControlまたはWLSTコマンド行ツールを使用して登録および管理されます。接続情報は構成ファイルおよびMDSリポジトリに格納されます。詳細は、第1.3.5項「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

WebCenter PortalおよびPortal Frameworkアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後に行ったすべての変更は、Oracle Metadata Service (MDS)リポジトリにカスタマイズとして格納されます。

注意:
Fusion Middleware ControlまたはWLSTを使用して行ったコンテンツ・リポジトリ構成の変更は動的ではないため、変更を有効にするには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

接続の詳細が定義されると、ユーザーは、<af:image、<af:inlineFrame、<af:goLinkなどの複数のADF Facesコンポーネント、および組込みのドキュメント・タスク・フロー(ドキュメント・マネージャ、フォルダ・ビューアおよび最近のドキュメント)を使用して、接続されたコンテンツ・リポジトリのコンテンツを公開できます。詳細は、『Oracle WebCenter Portalの使用』の「ページ上のWeb開発コンポーネントでの作業」およびドキュメントでの作業に関する項を参照してください。

コンテンツ・リポジトリの構成要件について

次の各項では、WebCenter PortalおよびPortal Frameworkアプリケーションでサポートされているコンテンツ・リポジトリを構成する際の前提条件について説明します。リポジトリに接続する前に、ここで説明しているコンテンツ・リポジトリ構成を完了していることを確認してください。

- 第9.2項「Oracle WebCenter Content Serverリポジトリの構成」

- 第9.3項「Microsoft SharePointリポジトリの構成」

- 第9.4項「Oracle Portalリポジトリの構成」

- 第9.5項「ファイル・システム・リポジトリの構成」

他のガイドの関連情報

WebCenter PortalおよびPortal Frameworkアプリケーションのコンテンツの管理と組込みの詳細は、次の関連項目も参照してください。

- WebCenter PortalおよびPortal Frameworkアプリケーションでの実行時のドキュメントおよびドキュメント・タスク・フローの使用については、『Oracle WebCenter Portalの使用』のドキュメントでの作業に関する項を参照してください。

Oracle JDeveloperを使用したPortal FrameworkアプリケーションおよびWebCenter Portalへのドキュメント・サービスの追加の詳細は、次の関連項目も参照してください。

- 分散コンテンツへのアクセスを提供するコンテンツ・リポジトリ接続の構成については、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のコンテンツ・リポジトリ接続の構成に関する項を参照してください。

- "コンテンツ・プレゼンタを使用してWebCenter PortalまたはPortal Frameworkアプリケーション内で分散コンテンツを統合および公開するためのカスタム表示テンプレートの作成については、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のコンテンツ・プレゼンタ表示テンプレートの作成に関する項を参照してください。

- "実行時のドキュメントの管理、表示および検索用のユーザー・フレンドリなインタフェースをエンド・ユーザーに提供するための、Portal Frameworkアプリケーションでのドキュメントの統合については、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のドキュメントの統合に関する項を参照してください。

9.2 Oracle WebCenter Content Serverリポジトリの構成

この項では、Oracle WebCenter Content Server 11g (Content Server)コンテンツ・リポジトリをWebCenter PortalおよびPortal Frameworkアプリケーション用に構成するための手順を説明します。特に明記しないかぎり、次の手順はWebCenter PortalおよびPortal Frameworkアプリケーションの両方に共通です。

この項には次のサブセクションが含まれます:

- 第9.2.1項「Content Serverを構成するための前提条件」

- 第9.2.2項「Content Serverの構成ロードマップ」

- 第9.2.3項「Content Serverの構成」

9.2.1 Content Serverを構成するための前提条件

この項では、第9.2.3項「Content Serverの構成」に進む前に理解しておく必要のある前提条件と他の考慮事項について説明します。

この項には次のサブセクションが含まれます:

- 第9.2.1.1項「インストールに関する前提条件」

- 第9.2.1.2項「構成に関する前提条件」

- 第9.2.1.3項「セキュリティに関する前提条件」

9.2.1.1 インストールに関する前提条件

Content Server

Content Server 11gを構成するには、Content Serverがすでにインストールされている必要があります。Content Serverは、Oracle Fusion MiddlewareのコンポーネントであるOracle WebCenter Contentの一部としてインストールされます。Oracle WebCenter Contentについては、Oracle WebCenter Contentのインストールと構成で説明しています。

すでに以前のバージョンのContent Serverがインストールされている場合は、Content Serverを構成する前に、そのインストールをOracle WebCenter Content Server 11gにアップグレードしてください。Oracle WebCenter Content Server 11gへのアップグレードの詳細は、Oracle WebCenter Contentアップグレード・ガイドの「Oracle WebCenter Content環境のアップグレード」を参照してください。

Inbound Refinery

インストールの一環として、Oracle WebCenter Content: Inbound Refinery (Inbound Refinery)もインストールすることをお薦めします。Inbound Refineryは、ドキュメント、デジタル・イメージ、動画などの電子アセット用のファイル変換を管理する変換サーバーです。また、ドキュメントと画像のサムネイル機能、およびビデオのストーリボードも提供します。Inbound Refineryを使用して、コンテンツ・サーバーに格納されているコンテンツ・アイテムを変換できます。Inbound Refineryのインストールについては、Oracle WebCenter Contentのインストールと構成でも説明されています。

注意:
Content ServerとInbound Refineryは、同じドメインにインストールする必要があります。Content ServerとInbound Refineryは、WebCenter PortalまたはPortal Frameworkアプリケーションと同じドメインにインストールすることをお薦めします。これらを同じドメインにインストールすると、外部LDAP認証プロバイダを使用するための追加構成は必要なくなります。

9.2.1.2 構成に関する前提条件

Content ServerとInbound Refineryをインストールした後は、インストール後の初期設定の構成も完了しておく必要があります。この構成については、Oracle WebCenter Contentのインストールと構成のContent Serverインスタンスの構成に関する項で説明しています。次の表に示すWebCenter Portal固有の追加指示も含めて、Content ServerとInbound Refineryの両方の設定を構成します。設定を更新した後は、必ずサーバーを再起動してください。

Content Server

設定

説明

サーバーのソケット・ポート

これは、RIDCを使用して接続するintradocポートです(デフォルトは4444)。この値は、IntradocServerPortとしてContent Serverの管理対象サーバーの構成ファイル(../config/config.cfg)に格納されます。

受信ソケット接続アドレス・セキュリティ・フィルタ

どのマシンがソケット接続によってContent Serverにアクセスできるかを指定するサーバー・フィルタ。この値は、SocketHostAddressSecurityFilterとして管理対象サーバーの構成ファイルに格納されます。

フルテキスト検索
(オプションですが、強くお薦めします)

フルテキスト検索エンジンを指定します。推奨値は「内部」です。

Inbound Refinery

設定

説明

サーバーのソケット・ポート

このポートは、Content ServerとInbound Refineryとの通信に使用されます。この値はインストール後の構成ページで入力されており、Inbound Refineryの構成情報ページにある「サーバー・ポート」で確認できます。また、MW_HOME/user_projects/domains/ucm_domain/ucm/ibr/config/config.cfgファイル内のIntradocServerPortでも確認できます。

受信ソケット接続アドレス・セキュリティ・フィルタ

どのマシンがRIDCによってInbound Refineryにアクセスできるかを指定するサーバー・フィルタ。この値は、SocketHostAddressSecurityFilterとして管理対象サーバーの構成ファイルに格納されます。

フルテキスト検索
(オプションですが、強くお薦めします)

フルテキスト検索エンジンを指定します。推奨値は「内部」です。

9.2.1.3 セキュリティに関する前提条件

WebCenter PortalまたはPortal Frameworkアプリケーションと同じアイデンティティ・ストアLDAPサーバーを使用するように、Content Serverを構成する必要があります。アイデンティティ・ストアを外部のLDAPサーバーに再度関連付ける方法の詳細は、第31.1項「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」を参照してください。

Content ServerとInbound Refineryは、同じドメインにインストールする必要があります。Content ServerとInbound Refineryは、WebCenter PortalまたはPortal Frameworkアプリケーションと同じドメインにインストールすることをお薦めします。これらを同じドメインにインストールすると、外部LDAP認証プロバイダを使用するための追加構成は必要なくなります。

9.2.2 Content Serverの構成ロードマップ

図9-1のフロー・チャートは、WebCenter PortalおよびPortal FrameworkアプリケーションでContent Serverを機能させるために必要な前提条件とタスクの概要を示しています。フロー・チャートに示した手順については、表9-1と、第9.2.3項「Content Serverの構成」内の各項で説明します。

図9-1 WebCenter PortalおよびPortal Frameworkアプリケーション用のContent Serverの構成

表9-1 Content Serverに対するWebCenter Portalの構成タスク

タスク

説明

ドキュメント

必須コンポーネントの有効化

必須

WebCenter PortalおよびPortal Frameworkアプリケーション用にContent Serverのインスタンスを構成する、WebCenterConfigureコンポーネントを有効にする必要があります。

Content Server内でコンテンツへの階層フォルダ・インタフェースを提供する、Folders_gまたはFrameworkFoldersコンポーネントも有効にする必要があります。

第9.2.3.1項「必須コンポーネントの有効化」を参照してください。

Dynamic Converterコンポーネントの構成

オプションですが、強くお薦めします

このコンポーネントによってHTMLレンディションが可能になります。DynamicConverterコンポーネントとWebCenterConfigureコンポーネントの両方がインストールされている場合、WebCenter Portalでスライド・プレビューアを使用できます。

第9.2.3.2項「Dynamic Converterコンポーネントの構成」を参照してください。

Inbound Refineryの構成

オプションですが、強くお薦めします

ドキュメント、デジタル・イメージ、動画などの電子アセット用のファイル変換を管理する変換サーバーです。また、ドキュメントと画像のサムネイル機能、およびビデオのストーリボードも提供します。Inbound Refineryを使用して、Content Serverに格納されているコンテンツ・アイテムを変換できます。

第9.2.3.3項「Inbound Refineryの構成」を参照してください。

Content Server用のSecure Sockets Layer (SSL)の構成

オプションですが、強くお薦めします

セキュアなアイデンティティ伝播を保証するには、Content Serverに対してSSLを設定します。

第35.7項「SSLを使用したWebCenter PortalからContent Serverへの接続の保護」を参照してください。

また、第9.2.3.4項「Content Serverに対するSSLの設定」も参照してください。

iFrame化UIの有効化

オプションですが、強くお薦めします

iFrame化が構成されていない場合、ドキュメント・マネージャのドキュメント・レンディション・サポート、拡張メタデータ編集、IFRAME機能などの一部の機能が使用できなくなります。

第9.2.3.5項「iFrame化UIの有効化」を参照してください。

詳細は、付録B「WebCenter PortalのOracle HTTP Server構成」を参照してください。

SESクローラの構成

オプション

デフォルトの検索アダプタをオーバーライドして、ドキュメント、ページ、人などのWebCenter Portalリソースの統合ランキング結果の取得にOracle SESを使用できます。

第18.5.2項「Oracle SESのためのOracle WebCenter Content Serverの設定」を参照してください。

また、第9.2.3.6項「SESクローラの構成」も参照してください。

Site Studioの構成

オプションですが、強くお薦めします

Site Studioを構成すると、Site Studioを使用してSite Studioアセット(リージョン定義および表示テンプレート)を作成し、そのアセットをコンテンツ・プレゼンタで使用できるようになります。Site Studioが不要であることが確実ではない場合、後でやり直すことがないように、インストールおよび構成することを強くお薦めします。

第9.2.3.7項「Site Studioの設定」を参照してください。

詳細は、Oracle WebCenter Contentの管理のコンポーネント・マネージャを使用したコンポーネントの有効化または無効化に関する項およびOracle WebCenter Portalでのポータルの構築のコンテンツ・プレゼンタを使用したコンテンツの公開に関する項も参照してください。Site Studio管理者およびマネージャ・ガイドも参照してください。

コンテンツ・プロファイルの作成

オプション

WebCenter PortalでiFrame化が有効化されている場合、ユーザーは必要に応じて、Content Serverプロファイルに基づいてコンテンツをアップロードできます。

第9.2.3.8項「Content Serverでのコンテンツ・プロファイルの作成」を参照してください。

コンテンツ・プロファイルの作成の詳細は、Oracle WebCenter Contentのマネージングの「コンテンツ・プロファイルの管理」を参照してください。

アイテム・レベル・セキュリティの構成

オプション

ドキュメント・ツールでは、アイテム・レベル・セキュリティ(ILS)を使用して、デフォルトのWebCenter Portalドキュメント・セキュリティ・モデルをオーバーライドしたり、Portal FrameworkアプリケーションでContent Serverドキュメント・セキュリティを公開したりできます。ILSにより、Content Serverフォルダ(およびその子)または個々のドキュメントが一意のセキュリティ権限を保有できます。

第9.2.3.9項「アイテム・レベル・セキュリティの構成」を参照してください。

『Oracle WebCenter Portalの使用』のフォルダまたはファイルでのセキュリティ・オプションの設定に関する項も参照してください。

Digital Asset Managerの有効化

オプション

コンテンツ・プレゼンタを使用してポータルで異なるイメージ・レンディションを使用する場合、Content ServerでDigital Asset Manager (DAM)を有効化できます。

第9.2.3.10項「Digital Asset Managerの有効化」を参照してください。

Oracle WebCenter Contentのマネージングのイメージ変換およびビデオ変換の使用も参照してください。

追加オプション構成

オプション

残りの構成が完了したら、必要に応じてFileStore Providerコンポーネントの構成およびノード・マネージャの設定が可能です。

第9.2.3.12項「追加のオプション構成」を参照してください。

Content ServerとPortal Frameworkアプリケーション間のセキュリティの構成

Portal Frameworkアプリケーションでは必須(WebCenter Portalには適用されません)

Portal Frameworkアプリケーションと連携するようにContent Serverを構成するには、まず開発環境でコンテンツ・セキュリティとユーザーを設定してから、これらを本番環境に移行する必要があります。

第9.2.3.13項「Content ServerとWebCenter Portal Frameworkアプリケーション間のセキュリティの構成」を参照してください。

Content Serverリポジトリの登録

必須

WebCenter Portalについては、ほとんどの場合、WebCenter Portalの最初の起動時に接続が構成されますが、少なくとも接続のテストを行って、接続が使用している環境用に正しく構成されていること、およびデータが正しくシードされていることを確認してください。

Portal Frameworkアプリケーションについては、アプリケーションからContent Serverへの接続を構成する必要があります。

WebCenter Portalについては、第9.2.3.14.2項「WebCenter Portal用のContent Server接続の構成」を参照してください。 WebCenter Portalについては、第9.2.3.14.3項「Content ServerにシードされたWebCenter Portalデータの確認」の説明に従って、シードされたデータを確認する必要もあります。

Portal Frameworkアプリケーションについては、第9.2.3.14.1項「Portal Frameworkアプリケーション用のContent Server接続の構成」を参照してください。

9.2.3 Content Serverの構成

Content Server 11gのインストールまたはこのバージョンへのアップグレードが完了したら、表9-1に示す構成タスクを実行します。特に明記しないかぎり、次のタスクはWebCenter PortalおよびPortal Frameworkアプリケーションの両方に共通です。

注意:
構成を開始する前に、この項の構成手順の開始点を定義した第9.2.1項「Content Serverを構成するための前提条件」で説明しているインストール手順と構成手順を完了しておく必要があります。

注意:
競合を回避し、複数のContent Serverインスタンス間のドキュメントの移行を保証するために、Content Serverインスタンスで一意の自動採番接頭辞を入力したことを確認してください。自動採番接頭辞がすべてのContent Serverインスタンス間で一意であることを確認するには、Content Serverにログインして、「管理」→「管理サーバー」→「一般構成」の順に移動します。

この項には次のサブセクションが含まれます:

- 第9.2.3.1項「必須コンポーネントの有効化」

- 第9.2.3.2項「Dynamic Converterコンポーネントの構成」

- 第9.2.3.3項「Inbound Refineryの構成」

- 第9.2.3.4項「Content Serverに対するSSLの設定」

- 第9.2.3.5項「iFrame化UIの有効化」

- 第9.2.3.6項「SESクローラの構成」

- 第9.2.3.7項「Site Studioの設定」

- 第9.2.3.8項「Content Serverでのコンテンツ・プロファイルの作成」

- 第9.2.3.9項「アイテム・レベル・セキュリティの構成」

- 第9.2.3.10項「Digital Asset Managerの有効化」

- 第9.2.3.11項「リッチ・テキスト・エディタのWikiマークアップ・タブの表示および非表示」

- 第9.2.3.12項「追加のオプション構成」

- 第9.2.3.13項「Content ServerとWebCenter Portal Frameworkアプリケーション間のセキュリティの構成」

- 第9.2.3.14項「Content Serverリポジトリの登録」

9.2.3.1 必須コンポーネントの有効化

コンポーネントとは、追加の機能を提供したり既存の機能を変更するために、コンテンツ・サーバーにプラグインできる機能単位です。WebCenter PortalまたはPortal Frameworkアプリケーション用のContent Serverを準備するには、Folders_gまたはFrameworkFoldersおよびWebCenterConfigureを有効化する必要があります。

9.2.3.1.1 FrameworkFoldersまたはFolders_gの有効化のための考慮事項

Oracle WebCenter Contentでは、Folders_gおよびFrameworkFoldersという2つのフォルダ・ソリューションが提供されます。以前は、Oracle WebCenter PortalはFolders_gのみをサポートしていましたが、このリリースではOracle WebCenter PortalはFrameworkFoldersもサポートしています。

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

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

Oracle WebCenter Portalの新規インストールの場合、Content ServerでFrameworkFoldersコンポーネントを有効にすることをお薦めします。Folders_gコンポーネントを使用する以前のリリースからパッチを適用されたOracle WebCenter Portalインスタンスの場合は、引き続きFolders_gを使用するか、FrameworkFolderインタフェースに移行できます。パフォーマンスを向上させてContent Serverの任意の新機能を使用できるようにするために、FrameworkFoldersインタフェースに移行することをお薦めします。FrameworkFoldersインタフェースへの移行については、付録H「FrameworkFoldersへのFolders_gの移行」を参照してください。

FrameworkFoldersを有効化する際、Oracle WebCenter PortalとOracle WebCenter Contentの両方が11gリリース11.1.1.9.0であることを確認してください。Folders_gからFrameworkFolders設定に移行する場合を除き、FrameworkFoldersとFolders_gを同時に有効化することはできません。

9.2.3.1.2 Folders_gコンポーネントの有効化

最新のリリースにパッチを適用した既存のOracle WebCenter Portalインストールの場合は、Content Serverのフォルダ・サービスとして引き続きFolders_gを使用できます。Folders_gは、FrameworkFoldersとは互換性がありません。このため、Folders_gからFrameworkFolders設定に移行する場合を除き、必ずFrameworkFoldersを無効化してください。

注意:
よりよいパフォーマンスを得るために、Folders_gではなくFrameworkFoldersを有効化することをお薦めします。

Folders_gコンポーネントを有効化するには:

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

2. 「管理」をクリックして「管理サーバー」を展開し、メイン・メニューで「コンポーネント・マネージャ」をクリックします。

3. 「コンポーネント・マネージャ」ページで、「FrameworkFolders」チェック・ボックスが選択されていないことを確認します。

4. 「拡張コンポーネント・マネージャ」をクリックします。

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

6. Content Serverインスタンスを再起動します。

9.2.3.1.3 FrameworkFoldersコンポーネントの有効化

このリリースでは、Folders_gではなくFrameworkFoldersを有効化することをお薦めします。

注意:
最新リリースへのパッチが適用された既存のOracle WebCenter Portalインスタンスの場合、Folders_gからFrameworkFoldersに移行できます。移行手順については、付録H「FrameworkFoldersへのFolders_gの移行」を参照してください。

FrameworkFoldersコンポーネントを有効化するには:

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

2. 「管理」をクリックして「管理サーバー」を展開し、メイン・メニューで「コンポーネント・マネージャ」をクリックします。

3. 「コンポーネント・マネージャ」ページで、「FrameworkFolders」チェック・ボックスを選択します。

4. 「更新」をクリックします。

5. 「拡張コンポーネント・マネージャ」をクリックします。

6. 「拡張コンポーネント・マネージャ」ページで、「Folders_g」チェック・ボックスが選択されていないことを確認します。

7. Content Serverインスタンスを再起動します。

9.2.3.1.4 WebCenterConfigureコンポーネントの有効化

WebCenter PortalおよびPortal Frameworkアプリケーション用にContent Serverを構成するために、WebCenterConfigureコンポーネントを有効化する必要があります。図9-2は、このコンポーネントを有効化する際にContent Serverで実行されるタスクを示しています。

WebCenterConfigureコンポーネントを有効にするには:

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

2. 「メイン」メニューから、「管理」→「管理サーバー」→「コンポーネント・マネージャ」を選択します。

3. 「コンポーネント・マネージャ」ページで、「WebCenterConfigure」チェック・ボックスを選択します。

ヒント:
「コンポーネント・マネージャ」ページで、「Dynamic Converter」などの他のコンポーネントを選択できます(これらのコンポーネントを使用する予定だが、使用しないときは後で有効化する必要がある場合)。

4. 「更新」をクリックします。

5. Content Serverインスタンスを再起動します。

WebCenterConfigureコンポーネントを有効化すると、Content Serverで特定のタスクが実行されます。表9-2で、これらのタスクについて説明します。

表9-2 WebCenterConfigureコンポーネントに関連付けられたタスク

タスク

タスクの完了を検証するポインタ

アカウントの有効化

「Content Server」→「管理」→「管理サーバー」→「一般構成」→「アカウントの有効化」チェック・ボックス

または

MW_HOME/user_projects/domains/ucm_domain/ucm/cs/config/config.cfgファイル。このファイル内の設定がUseAccounts=1となります。

リリース前のドキュメントに対する更新の許可

「Content Server」→「管理」→「管理サーバー」→「一般構成」→「追加の構成変数」

または

MW_HOME/user_projects/domains/ucm_domain/ucm/cs/config/config.cfg

設定がAllowUpdateForGenwww=1となります。

フォルダのキャッシュの無効化

Folders_gコンポーネントが有効化されると、サーバーが起動されるたびに、WebCenterConfigureコンポーネントによってCollectionUseCacheがfalseに設定されます。この設定は、「管理」→「システム監査情報」→「構成エントリ情報」→「すべての環境キー」をクリックしてすべての環境設定を表示することによって確認できます。

または

MW_HOME/user_projects/domains/ucm_domain/ucm/cs/config/config.cfgファイルを参照してください。

設定がCollectionUseCache=1となります。

次のメタデータ・フィールドの追加

- xWCTags

- xWCPageId

- xWCWorkflowAssignment

- xWCWorkflowApproverUserList

メタデータ・フィールドの表示、編集および追加は、「Content Server」→「管理」→「管理アプレット」→「構成マネージャ」→「情報フィールド」タブで行えます。

次のフォルダ設定の設定(Folders_gコンポーネントが有効化されている場合)

- システムのデフォルト情報のフィールド構成: 「ドキュメント・タイプ」=「ドキュメント」

- フィールド情報の継承構成
xWCWorkflowAssignment
xWCWorkflowApproverUserList

「Content Server」→「管理」→「フォルダ構成」→「システムのデフォルト情報のフィールド構成」

「Content Server」→「管理」→「フォルダ構成」→「フィールド情報の継承構成」

WCWorkflowApproverUserTokenワークフロー・トークンの追加

「Content Server」→「管理」→「管理アプレット」→「ワークフロー管理」→「オプション」→「トークン」メニュー

3つのDynamicConverterテンプレートの追加

DynamicConverterコンポーネントが有効化されると、DynamicConverterサービスがコールされ、次の3つのDynamicConverterテンプレートが作成されます。

- SLIDE-PREVIEW

- SLIDE-PREVIEW-TEXT

- SLIDE-PREVIEW-LARGE

Site StudioをWebCenter PortalおよびPortal Frameworkアプリケーションで動作させるための、Site Studioコンテンツの切替えウィザードの特定の動作のオーバーライド

これにより、コンテンツ・プレゼンタ内からSite Studioコンテンツの切替えウィザードとSite Studioコントリビュータ・エディタにアクセスして、WebCenter PortalまたはPortal FrameworkアプリケーションからSite Studioドキュメントの追加および編集を行えるようになります。

- contentwizard.hcspファイルとcontentwizard.jsファイルが/WebCenterConfigure.zip/component/WebCenterConfigure/publish/contentwizard/ディレクトリからOCS_HOME/cs/weblayout/resources/wcm/custom/sitestudio/contentwizard/webcenter/ディレクトリにコピーされます。

- wcm.sitestudio.form.jsファイルが/WebCenterConfigure.zip/component/WebCenterConfigure/publish/contentwizard/ディレクトリからOCS_HOME/cs/weblayout/resources/wcm/custom/sitestudio/ディレクトリにコピーされます。

現在の形式へのPersonalSpaceロールとデフォルト属性のアップグレード

Content Serverに旧バージョン(11.1.1.5.0およびこれより前)のPersonalSpaceロール形式が含まれている場合、WebCenterConfigureを有効化すると、PersonalSpaceロールとデフォルト属性が現在の形式にアップグレードされます。

11.1.1.5.0およびこれより前の形式:

ロール:

- PersonalSpacesセキュリティ・グループに対するRWD権限を持つPersonalSpaceRole

デフォルトの属性:

- すべてのユーザー(パブリックおよび認証済)がPersonalSpaceRoleを取得します

現在の形式:

ロール:

- PersonalSpacesセキュリティ・グループに対するR権限を持つPersonalSpaceRole

- PersonalSpacesセキュリティ・グループに対するRWDを持つPersonalSpaceAuthenRole

デフォルトの属性:

- すべてのパブリック・ユーザーがPersonalSpaceRoleを取得します

- すべての認証済ユーザーがPersonalSpaceAuthenRoleを取得します

9.2.3.1.5 フルテキスト検索の有効化

名目上はオプションですが、OracleTextSearchオプションを使用してフルテキスト検索を実装することをお薦めします。デフォルトでは、Content Serverが使用するデータベースは、メタデータのみの検索および索引付けの機能を提供するように設定されます。しかし、フルテキストの検索および索引付け機能も追加でサポートするように、データベースのデフォルト構成を変更できます。

このオプションはOracle Databaseとの組合せでのみ使用可能なことに注意してください。メイン・スキーマに対して使用するデータベース・タイプにかかわらず、Oracle DatabaseにOracleTextSearchの索引が常に含まれている必要があります。詳細は、Oracle WebCenter Contentのインストールと構成のContent Server用のOracleTextSearchの構成に関する項およびOracle WebCenter ContentのマネージングのSite Studioの統合に関する項を参照してください。

9.2.3.2 Dynamic Converterコンポーネントの構成

オプションですが、強くお薦めします

この構成はWebCenter PortalおよびPortal Frameworkアプリケーションのスライド・プレビューア機能に必要であり、これによって、Dynamic Converterでオンザフライで生成されるHTMLレンディションが使用されるようになります。

注意:
Inbound Refineryも構成する必要があります。これを構成していないと、すべてのプレビューが失敗します。Inbound Refineryの構成手順は、第9.2.3.3項「Inbound Refineryの構成」を参照してください。

Dynamic Converterの構成には、Dynamic Converterの有効化と、Dynamic Converterの利用が可能なファイル・タイプの定義の2つの手順が含まれます。必須コンポーネントを有効化したときにすでにDynamic Converterを有効化してある場合は、有効化の手順はスキップして、ファイル・タイプの定義の手順に直接進むことができます。

Dynamic Converterの有効化

Dynamic Converterを有効化する手順は次のとおりです。

1. 管理サーバーにログオンし、「管理サーバー」ページを開きます。
「管理サーバー」ページには、Content Serverで「管理」→「管理サーバー」と移動することによりアクセスできます。

2. 「コンポーネント・マネージャ」ページで「DynamicConverter」チェック・ボックスを選択します。

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

4. Content Serverインスタンスを再起動します。

Dynamic Converterに送信するファイル・タイプの設定

Dynamic Converterの利用が可能なファイル・タイプを定義する手順は次のとおりです。

1. Content Serverにログインして、「管理」→「Dynamic Converterの管理」→「構成設定」→「変換フォーマット」を選択します。
「Dynamic Converterの管理」メニュー・オプションは、Dynamic Converterコンポーネントを有効化した後にContent Serverインスタンスを再起動しないと、表示されません。

2. Dynamic Converterを有効化するファイル形式をドロップダウン・リストから選択します。HTMLレンディションを必要とするすべてのドキュメント・フォーマット(Word、Excel、PowerPoint、PDFなど)を選択します。

9.2.3.3 Inbound Refineryの構成

オプションですが、強くお薦めします

Inbound Refineryは、ドキュメント、デジタル・イメージ、動画などの電子アセット用のファイル変換を管理する変換サーバーです。また、ドキュメントと画像のサムネイル機能、およびビデオのストーリボードも提供します。Inbound Refineryを使用して、コンテンツ・サーバーに格納されているコンテンツ・アイテムを変換できます。「Dynamic Converter」コンポーネントを有効化した場合(スライド・プレビューを生成するために使用)は、IBRも構成する必要があります。

Inbound Refineryを構成するには、Content ServerからInbound Refineryへの送信プロバイダを設定し、変換するファイル・タイプを指定する必要があります。また、Inbound RefineryでPDFExportConverterを有効化し、他の変換設定を設定する必要もあります。必要に応じて、wikiおよびブログのPDFへの変換も有効化します。

Inbound Refineryの構成前に、次のことを完了しておきます。

- Inbound Refineryのインストール(第9.2.1.1項「インストールに関する前提条件」を参照)

- インストール後の初期構成(第9.2.1.2項「構成に関する前提条件」を参照)

この項には次のサブセクションが含まれます:

- 第9.2.3.3.1項「アウトバウンド・プロバイダの作成」

- 第9.2.3.3.2項「Inbound RefineryでのPDFExportConverterの有効化」

- 第9.2.3.3.3項「変換するファイル形式の選択」

- 第9.2.3.3.4項「WikiおよびブログのPDFへの変換の有効化」

9.2.3.3.1 アウトバウンド・プロバイダの作成

変換するファイルをContent ServerからInbound Refineryに送信できるようにするには、「Inbound Refinery変換ジョブの処理」オプションを選択して、Content ServerからInbound Refineryへの送信プロバイダを設定する必要があります。

アウトバウンド・プロバイダを作成するには:

1. 「Content Serverの管理」メニューから「プロバイダ」を選択します。

2. 「プロバイダ」ページの「新規プロバイダの作成」セクションで、「送信」行にある「追加」をクリックします。

3. 次のフィールドに値を入力します。

- プロバイダ名: 送信プロバイダが必要とするInbound Refineryインスタンスを記述する、スペースを含まない短い名前。Inbound Refineryの「インスタンス名」と同じ名前を使用するのが適切です。

- プロバイダの説明: 送信プロバイダの説明。

- サーバー・ホスト名: Inbound Refineryインスタンスを実行するホスト・マシン名(例: myhost.example.com)。

- HTTPサーバー・アドレス: Inbound Refineryインスタンスのアドレス(http://myhost.example.com:16250など。16250はWebポートです)。

- サーバー・ポート: Inbound RefineryインスタンスのIntradocServerPort値。この値はインストール後の構成ページで入力されており、Inbound Refineryの構成情報ページにある「サーバー・ポート」で確認できます。また、MW_HOME/user_projects/domains/ucm_domain/ucm/ibr/config/config.cfgファイル内のIntradocServerPortでも確認できます。
Inbound Refinery構成情報ページを表示するには:

- Content Serverにログインして、「管理」→「<インスタンス名>の構成」を選択します。

- 「サーバーの構成」をクリックしてサーバーの構成を表示します。

または、「管理」→「管理サーバー」→「一般構成」でIBRにログインします。

- インスタンス名: Inbound Refineryのインスタンス名(config.cfgファイルのIDC_Name値)。この値は、「コンテンツ・サーバーのインスタンス名」のインストール後の構成ページに入力されたものです。インスタンス名を検索するには、Inbound Refineryにログインして、「管理」→「<instanceName>の構成」に移動します。

- 相対Webルート: Inbound RefineryインスタンスのWebルート(例: /ibr/)。

4. 「変換オプション」で、「Inbound Refinery変換ジョブの処理」を選択します。「Inbound Refineryの読取り専用モード」は選択しないでください。

5. 「追加」をクリックします。

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

7. 「プロバイダ」ページに戻り、プロバイダの「接続状態」の値がgoodになっていることを確認します。
値がgoodでない場合は、これまでのすべての入力値に誤りがないことを再確認するとともに、Content ServerインスタンスとInbound Refineryインスタンスが互いにping可能なことを確認します。

9.2.3.3.2 Inbound RefineryでのPDFExportConverterの有効化

PDFExportConverterはOutsideInを使用してドキュメントをPDFファイルに直接変換します。この変換はプラットフォームをまたがって実行でき、サード・パーティ製品は何も必要としません。Inbound Refineryに対してPDFExportConverterをサーバー機能として有効化できます。

Inbound RefineryでPDFExportConverterを有効化する手順は次のとおりです。

1. 「Inbound Refinery管理」メニューから「管理サーバー」を選択し、「コンポーネント・マネージャ」を選択します。

2. 「PDFExportConverter」を選択して「更新」をクリックします。

3. 「OK」をクリックして、この機能を有効化します。

4. Inbound Refineryを再起動します。

PDFコンバータ設定を設定する手順は次のとおりです。

1. Inbound Refineryに再びログインします。

2. 「変換設定」を選択し、「プライマリWebレンディション」を選択します。

3. 「PDFエクスポートによるPDFへの変換」を選択します。

4. 「変換設定」を選択し、「追加レンディション」を選択します。

5. 「Outside Inを使用するサムネイル・イメージの作成」を選択します。

6. 「変換設定」→「サードパーティ・アプリケーションの設定」→「標準のOutsideInフィルタ・オプション」→「オプション」を選択します。

7. フォントへのパスをInbound Refineryシステム上のフォントに設定します。

8. 「UNIXレンダリング・オプション」で、「内部グラフィック・レンダリングの使用」を選択します。

9. 「更新」をクリックします。

詳細は、Oracle WebCenter ContentのマネージングのプライマリWeb表示可能レンディションとしてのPDFファイルの設定に関する項を参照してください。

9.2.3.3.3 変換するファイル形式の選択

どのファイルを変換対象としてInbound Refineryに送信するかをContent Serverに示すために、ファイル形式を選択する必要があります。

変換するファイル形式を選択するには:

1. 「Content Serverの管理」メニューから、「リファイナリ管理」を選択し、ファイル形式ウィザードを選択します。

注意:
Inbound Refineryインスタンスへの有効な送信プロバイダがない場合、Refinery Administrationはリストに表示されません。

Content Serverによって「ファイル形式ウィザード」ページが表示されます。このページでは、Content Serverへのチェックイン時に変換対象としてInbound Refineryに送信するファイル形式を構成します。

2. 変換対象のフォーマットを選択します。
変換対象としてInbound Refineryに送信するすべてのファイル・タイプを確実に選択してください。HTMLは選択しません。また、wikiとブログについても、WebCenterConversionsコンポーネントを介してこれらの変換を有効化していない場合は選択しないでください。この有効化については、第9.2.3.3.4項「WikiおよびブログのPDFへの変換の有効化」で説明します。

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

9.2.3.3.4 WikiおよびブログのPDFへの変換の有効化

オプション

WebCenter PortalおよびPortal FrameworkアプリケーションでWikiおよびブログのPDFへの変換を有効化するには、まず次のことを実行する必要があります。

- Inbound RefineryとのOpenOffice統合の設定。詳細は、Oracle WebCenter ContentのマネージングのOpenOfficeを使用するInbound Refineryの構成に関する項を参照してください。

- Oracle WebCenter ContentのマネージングのOpenOfficeクラス・ファイルのクラスパスの設定に関する項で説明している手順を実行します(ホストにログインしないでOpenOfficeを使用する方法に関する項も参照してください)。

WikiおよびブログのPDFへの変換を有効化するには、まず、Inbound RefineryサーバーとContent Serverのそれぞれで、WebCenterConversionsコンポーネントをインストールし、HTMLからPDFへの変換を実行するOpenOfficeを構成する必要があります。WebCenterConversionsコンポーネントによってHtmToPDFOpenOffice変換オプションが追加されます。このオプションでは、Inbound RefineryでOpenOffice変換が活用されます(したがって、そのInbound Refineryに対してOpenOfficeが構成されていることが必要です)。

次に示す手順は順序どおり実行する必要がある点に注意してください。Inbound Refineryをインストールおよび有効化せずに、ファイル形式ウィザードでWikiおよびブログを選択して有効化すると、Inbound Refineryの変換キューでWikiおよびブログ・ドキュメントがスタックします。

注意:
リッチ・テキスト・エディタ(RTE)から「イメージの埋込み」機能を使用して追加したイメージのみが、生成されたPDFに表示されます。外部URLで参照されるイメージは、PDFに表示されません。RTEの詳細は、『Oracle WebCenter Portalの使用』のリッチ・テキスト・エディタ(RTE)の使用に関する項を参照してください。
PDF変換は、変換を有効化した後に作成された新しいブログとWikiに対してのみ動作します。変換が有効化される前に作成されたブログとWikiは、PDFには変換できません。

ヒント:
Oracle WebCenter ContentのマネージングのOpen OfficeによってPDFに変換されるファイル形式に関する項も参照してください。

WebCenterConversionコンポーネントをインストールする手順は次のとおりです。

1. Inbound Refineryサーバーにログインします。

2. 「管理」をクリックし、「管理サーバー」を選択します。
Inbound Refineryの「管理サーバー」ページが表示されます。

3. 「コンポーネント・マネージャ」で、「拡張コンポーネント・マネージャ」リンクをクリックします。
「コンポーネント・マネージャ」ページが表示されます。

4. 「新規コンポーネントのインストール」セクションで、Oracle WebCenterコンパニオンCDから「WebCenterConversions.zip」を選択して「インストール」をクリックします。
WebCenterConversionコンポーネントが「無効なコンポーネント」ボックスに表示されます。

5. 「WebCenterConversion」を選択して「有効化」を選択します。

6. Inbound Refineryサーバーを再起動します。

WebCenterConversionコンポーネントを有効化する手順は次のとおりです。

1. Inbound Refineryサーバーで、「変換設定」の下にある「変換リスト」リンクをクリックします。
これにより、「変換リスト」ページが表示されます。

2. 「変換」表で、HtmToPDFOpenOfficeに対して「承認」チェック・ボックスを選択して、「更新」をクリックします。

関連付けられたContent Serverインスタンスの、Content Serverのファイル形式ウィザードで、Wikiとブログのオプションが表示されるようになります。

Content ServerでWikiおよびブログのPDFへの変換を有効化する手順は次のとおりです。

1. Content Serverにログインします。

2. 「管理」ノードを開き、「リファイナリ管理」を開いて、ファイル形式ウィザードをクリックします。

3. 「ファイル・タイプの選択」で、「Wiki」および「ブログ」チェック・ボックスを選択して「更新」をクリックします。

Inbound RefineryでPDF変換を有効にするには:

1. Inbound Refineryサーバーに再度ログインします。

2. 「変換設定」を選択し、「プライマリWebレンディション」を選択します。

3. 「OpenOfficeを使用してPDFに変換」を選択します。

4. 「更新」をクリックします。

9.2.3.4 Content Serverに対するSSLの設定

リポジトリ接続を作成するWebCenter Portal (またはPortal Frameworkアプリケーション)とContent Serverが、同じシステム上または信頼できる同じプライベート・ネットワーク上にない場合、アイデンティティ伝播はセキュアではありません。セキュアなアイデンティティ伝播を保証するには、さらにContent Serverに対してSSLを設定する必要があります。Content Serverに対するSSLの設定手順の詳細は、第35.7項「SSLを使用したWebCenter PortalからContent Serverへの接続の保護」を参照してください。

9.2.3.5 iFrame化UIの有効化

オプションですが、強くお薦めします

WebCenter PortalおよびPortal Frameworkアプリケーションでは、ドキュメント・マネージャのドキュメント・レンディションや拡張メタデータ編集などの特定の機能に対して、iFrameに表示されたContent Serverユーザー・インタフェースが使用されます。iFrameはドメイン間の通信をサポートしていないため、WebCenter Portal (またはPortal Frameworkアプリケーション)とContent Serverが(Webアドレスにおいて)同じドメインにない場合は、後述の説明に従ってOracle HTTP Server (OHS)を構成しないとiFrame化機能を使用できません。

注意:

- iFrame化のサポートを有効化する前に、第33.2.5項「Oracle HTTP Serverのインストールと構成」の説明に従って、Oracle HTTP Server (OHS)のインストールと構成を完了しておく必要があります。

- 「ドキュメント」タスク・フローが様々なコンテンツ・サーバー接続を指定できるのに対し、iFrame化はデフォルトのコンテンツ・サーバー接続のみでサポートされます。そのため、ポータルに追加された「ドキュメント」タスク・フローがiFrameを使用してPDFファイルなどのファイル・コンテンツを表示する場合、デフォルト以外のコンテンツ・サーバー接続を指定できません。

WebCenter PortalおよびPortal FrameworkアプリケーションでiFrame化UIを有効化するには:

1. mod_wl_ohs.confファイルを開いて、このファイルが適切なContent Serverインスタンスを指していることを確認します。
このファイルのデフォルトの場所は、OHS_HOME/Oracle_WT1/instances/instance1/config/OHS/ohs1/mod_wl_ohs.confです。

2. Content Serverの接続プロパティを次のように更新します。
webContextRoot='/cs'

この設定は、OHSが設定されていない場合や、正しく動作していない場合には、設定しないでください。

3. Content ServerおよびadfAuthentication保護URI情報でmod_wl_ohs.confファイルを更新することによって、OHSを構成します。例:

<Location /cs>
SetHandler weblogic-handler
WeblogicHost example.com
WeblogicPort 9400
</Location>

<Location /adfAuthentication>
SetHandler weblogic-handler
WeblogicHost example.com
WeblogicPort 9400
</Location>

Content ServerがOracle AutoVue VueLinkサーブレットで構成されている場合は、次の追加エントリを含めます。

<Location /vuelink>
SetHandler weblogic-handler
WeblogicHost example.com  # Same as /cs entry
WeblogicPort 9400    # Same as /cs entry
</Location>

mod_wl_ohs.confファイルによるOHSの構成の詳細は、付録B「WebCenter PortalのOracle HTTP Server構成」を参照してください。

4. WebCenter PortalまたはPortal Frameworkアプリケーションにログインして、iFrame化機能が使用可能であることを確認します。
これでWebCenter Portal (またはPortal Frameworkアプリケーション)のフロントエンドがOHSになったため、WebCenter PortalまたはPortal FrameworkアプリケーションにはOHSを介してアクセスする必要がある点に注意してください。したがって、次のURLを指定してアプリケーションにアクセスします。

http://host:OHSPort/appname

例:

http://example.com:7777/webcenter

9.2.3.6 SESクローラの構成

オプション

SESクローラの構成は、第18.5.2項「Oracle SESのためのOracle WebCenter Content Serverの設定」の手順に従ってください。

9.2.3.7 Site Studioの設定

オプションですが、強くお薦めします

Site Studioの構成はオプションですが、この構成を行わないと、コンテンツ・プレゼンタでのSite Studio関連のアセットの作成および使用はできません。Site Studioが不要であることが確実ではない場合、後でやりなおすことがないように、インストールおよび構成することを強くお薦めします。

Site Studioを有効化する手順は次のとおりです。

1. Content Serverにログインして、「管理サーバー」ページを開きます。
「コンポーネント・マネージャ」ページが表示されます。

2. 「すべての機能」をクリックします。
ドキュメント管理、フォルダ、Inbound Refinery、統合およびWebコンテンツ管理カテゴリのすべてのコンポーネントが表示されます。

3. 有効化する各コンポーネントのチェック・ボックスを選択します。次のコンポーネントを有効化する必要があります。

- LinkManager

- SiteStudio

- SiteStudioExternalApplications

- DBSearchContainsOpSupport (フルテキスト検索に必要)

4. 「更新」をクリックします。

5. Content Serverインスタンスを再起動します。

6. Content Serverに再度ログインして、「管理」ページを開きます。

7. 「Site Studioの管理」を選択し、「デフォルトのプロジェクト・ドキュメント情報の設定」を選択します。

8. デフォルトを受け入れて「更新」をクリックします。

9. 「Site Studioの管理」を選択し、「デフォルトのWebアセット・ドキュメント情報の設定」を選択します。

10. デフォルトを受け入れて「更新」をクリックします。

11. (Portal Frameworkアプリケーションの場合のみ)アプリケーションのコンテキスト・ルートへのCookieパスを構成して、Site Studioコンテンツの編集時に、iFrameを閉じるたびにセッションが失われることを防止します。これを行うには、次に示すようにセッション ディスクリプタをweblogic.xmlファイル(WEB-INFフォルダ内)に追加して、Cookieパス(アプリケーションのコンテキスト・ルート)を指定します。

<session-descriptor>
<cookie-path>/app_name</cookie-path>
</session-descriptor>

12. Site Studio Designerを使用するには、Content Serverコンソールにログインし、マイContent Server>マイ・ダウンロードに移動して、Site Studio Designerのダウンロードとインストールを実行します。

9.2.3.8 Content Serverでのコンテンツ・プロファイルの作成

オプション

WebCenter PortalまたはPortal FrameworkアプリケーションでiFrame化が有効化されている場合、ユーザーは必要に応じて、Content Serverプロファイルを使用してコンテンツをアップロードできます。Content Serverプロファイルの詳細は、Oracle WebCenter Contentのマネージングのコンテンツ・プロファイルの管理に関する項を参照してください。

Content Serverプロファイルには、Content Serverにファイルをアップロードするために必要となる必須フィールドに加えて、ドキュメント・ライブラリおよびWebCenter Portalでアップロード・プロファイルを正しく動作させるための次のフィールドも含める必要があります。

- xCollectionID: フォルダ名の永続化用

- xIdcProfile: プロファイル値の永続化用

- dRevLabel: 新しいバージョンのチェックインを可能にするために、CHECKIN_SEL_FORM APIで必要

これらのフィールドを非表示フィールドとしてプロファイルに追加できます。

9.2.3.9 アイテム・レベル・セキュリティの構成

オプション

ドキュメント・ツールでは、アイテム・レベル・セキュリティ(ILS)を使用して、デフォルトのWebCenter Portalドキュメント・セキュリティ・モデルをオーバーライドしたり、Portal FrameworkアプリケーションでContent Serverドキュメント・セキュリティを公開したりできます。ILSにより、Content Serverフォルダ(およびその子)または個々のドキュメントが一意のセキュリティ権限を保有できます。

この項の内容は次のとおりです。

- 第9.2.3.9.1項「アイテム・レベル・セキュリティについて」

- 第9.2.3.9.2項「アイテム・レベル・セキュリティの構成」

- 第9.2.3.9.3項「WebCenter Portal Frameworkアプリケーション用の追加設定の構成」

9.2.3.9.1 アイテム・レベル・セキュリティについて

WebCenter PortalおよびPortal Frameworkアプリケーションでは、ファイルまたはフォルダにカスタムの権限を設定できます。この機能は、アイテム・レベル・セキュリティ(ILS)と呼ばれます。構成された時点で、たとえばポータルのドキュメント・ページからアクセスできます。

注意:
WebCenter Portalでは、ユーザー数が増大すると、ポータルのプライマリ・セキュリティ・メカニズムとしてILSを使用する際の管理が困難になる場合があります。また、ILSはWebCenter Portalセキュリティ・モデルほど効果的でないことがあります。そのためILSの使用は、WebCenter Portalセキュリティ・モデルに収まらないドキュメントまたはフォルダに対してセキュリティを定義する場合に限定することをお薦めします(たとえば、限定されたユーザー・セットのみがアクセス可能なドキュメントおよびフォルダなどです)。セキュリティの詳細は、第49章「ポータル間のセキュリティの管理」を参照してください。

ILSを使用して、既存のファイルまたはフォルダのセキュリティをカスタムの権限セットに置換できます。

- カスタム権限は、ファイルに適用された場合は、そのファイルにのみ影響します。

- フォルダに適用された場合は、更新後のセキュリティがすべての子のファイルとフォルダに再帰的に伝播され、固有のカスタム権限が設定されたフォルダが検出されると、そこで伝播が停止されます。ファイルに固有のカスタム権限がすでに設定されている場合、そのファイルには伝播は影響しません。

注意:
WebCenter Portalでは、ILSはポータルのルート・フォルダには適用できません。これは、ポータルのファイルまたはフォルダのアイテム・レベル・セキュリティが削除されたときに、そのファイルまたはフォルダに対して、そのポータルのセキュリティを適切にリストアするためです。
Folders_g設定では、ILSはファイルとフォルダに設定できます。FrameworkFolders設定では、ILSはファイルにのみ設定でき、フォルダには設定できません。

Content Server内で、ILSはACL、アカウントおよび他のメタデータ・フィールド設定の組合せとして実装されます。ILSを有効化するには、Content Serverが適切に構成されていることが必要です。第9.2.3.9項「アイテム・レベル・セキュリティの構成」および第9.2.3.13項「Content ServerとWebCenter Portal Frameworkアプリケーション間のセキュリティの構成」を参照してください。

カスタム権限を設定したときにContent Serverで行われる処理

「アイテム・レベルのセキュリティ」ダイアログでファイルまたはフォルダに対してカスタム権限を設定すると、Content Serverで次の処理が実行されます。

- アカウントがアカウントWCILS/original_accountに変更されます。
デフォルトですべてのAUTHENTICATEDユーザーにアカウントWCILSに対するRWDAが付与され、すべてのPUBLICユーザーにWCILSに対するRが付与されます。アカウントがWCILS/original_accountに変更されることで、確実にカスタム権限のみによってコンテンツのセキュリティが決定されるようになります。

- ACLコンテンツ・メタデータ・フィールドxClbraUserListおよびxClbraRoleListがカスタム権限によって更新されます(xClbraUserListにはドキュメントまたはフォルダに対するユーザーの権限が含まれ、xClbraRoleListにはドキュメントまたはフォルダに対するグループの権限が含まれます。)

- コンテンツ・メタデータ・フィールドxInhibitUpdateがtrueに設定され、ILSがアイテム自体のカスタム・セキュリティを親フォルダのカスタム権限で上書きしないようにします。

カスタム権限を削除したときにContent Serverで行われる処理

フォルダまたはファイルからカスタム権限を削除すると、そのアイテムのセキュリティをそのアイテムの親フォルダに設定されたセキュリティに戻す処理が試みられます。カスタム権限を削除すると、Content Server内で次の変更が行われます。

- そのアイテムのアカウントが親フォルダのアカウントに変更されます。

- そのアイテムのACLコンテンツ・メタデータ・フィールドxClbraUserListおよびxClbraRoleListがクリアされます。

- コンテンツ・メタデータ・フィールドxInhibitUpdateがfalseに設定されます。

これらの変更は、アイテム・レベル・セキュリティの設定時と同じように伝播されます。

WebCenter PortalおよびWebCenter Portal Frameworkアプリケーションでアイテム・レベル・セキュリティを使用するときの前提条件

WebCenter PortalまたはPortal Frameworkアプリケーションの場合、アイテム・レベル・セキュリティ(ILS)機能は、そのアプリケーションのContent Serverセキュリティ構成が特定の前提条件を満たしている場合にのみサポートされます。ほとんどのシナリオではILSは必要ではないため、明示的に必要な場合以外はILSを有効化しないでください。一般に、ILSは、アプリケーションでセキュリティ・ポリシーの例外ケースを処理するために、ドキュメントごとに個別ユーザーまたはユーザー・グループに対してContent Serverセキュリティ・モデルをオーバーライドまたは補足する必要がある場合に使用されます。ILSの使用時にはパフォーマンスへの影響と追加の管理オーバーヘッドが発生する点に注意してください。

注意:
Content Serverセキュリティは、アイテム・レベル・セキュリティよりも効果的で、また多数のユーザーおよびコンテンツ・オブジェクトに対して適応しやすいため、Content Serverセキュリティを使用することをお薦めします。管理面では、Content Serverのセキュリティはメンテナンスもより容易です。セキュリティの構成の詳細は、第9.2.3.13項「Content ServerとWebCenter Portal Frameworkアプリケーション間のセキュリティの構成」を参照してください。

WebCenter PortalまたはPortal FrameworkアプリケーションでのContent ServerのセキュリティにおけるILSの前提条件は次のとおりです。

- セキュリティがContent Serverのアカウントのみに基づいていること。
すべてのコンテンツにセキュリティ・グループが設定されていることも必要であるため、これは、アプリケーションのすべてのユーザーに、そのアプリケーションのセキュリティ・グループに対するRWD権限が付与されている必要があることを意味します。この要件は、カスタム権限を設定すると、そのアカウントは自動的に、すべてのユーザーにRWDAが付与されるアカウントWCILS/original_accountに変更されるというILSの動作によるものです。この変更によって、ドキュメントまたはフォルダのセキュリティがカスタム権限のみによって決定されるようになります。

- アプリケーション・コンテンツ全体に対して、コンテンツ・メタデータ・フィールドxForceFolderSecurityがtrueに設定されていること。それによって、Folderのセキュリティ設定がその子のフォルダとドキュメントに強制されます。これは、カスタム権限の伝播をサポートするために必要です。

9.2.3.9.2 アイテム・レベル・セキュリティの構成

アイテム・レベル・セキュリティ(ILS)を構成するには:

1. Content Serverインスタンスにログオンします。

2. 「管理」メニューから「管理サーバー」を選択して「コンポーネント・マネージャ」を開きます。

3. 「コンポーネント・マネージャ」セクションで、「拡張コンポーネント・マネージャ」リンクをクリックします。

4. 「拡張コンポーネント・マネージャ」ページで、下へスクロールして「無効なコンポーネント」リストに移動し、「RoleEntityACL」(図9-2を参照)を選択して「有効化」をクリックします。

関連項目:
『Oracle WebCenter Portalの使用』のファイルのセキュリティ・オプションの設定に関する項。

図9-2 拡張コンポーネント・マネージャ: RoleEntityACLコンポーネント

5. 左側の「オプション」ペインで「一般構成」を選択します。

6. 「一般構成」ページの「追加の構成変数」ボックスに次のパラメータを追加します。

UseEntitySecurity=1
SpecialAuthGroups=PersonalSpaces,securityGroup

ここで:

SpecialAuthGroupsは、セキュリティ・グループのカンマ区切りリストです(値間に空白は入れないでください)。ILSオプションはこれらのセキュリティ・グループのコンテンツに対してのみ有効化されます。

- Portal Frameworkアプリケーションの場合、securityGroupはコンテンツの作成場所のセキュリティ・グループ名です。

- WebCenter Portalの場合、WebCenter Portalデータを格納するセキュリティ・グループの名前は、Content ServerでWebCenter Portalを識別するために構成したアプリケーション名と同じになります。このアプリケーション名はFusion Middleware ControlまたはWLSTを使用して確認できます。
Fusion Middleware Controlの場合は、「アプリケーション名」プロパティが、WebCenter Portalに対するデフォルトのContent Server接続の「コンテンツ・リポジトリ接続の追加」または「コンテンツ・リポジトリ接続の編集」ページに表示されます。

WLSTを使用する場合は、listDocumentsSpacesPropertiesコマンドを使用することでアプリケーション名を表示できます。例:

listDocumentsSpacesProperties(appName='webcenter')

The Documents Spaces container is "/myspacesroot"
The Documents repository administrator is "weblogic"
The Documents application name is "myWebCenterPortalApp" <- applicationName
The Documents primary connection is "myContentServer"

7. Content Serverと、WebCenter PortalまたはPortal Frameworkアプリケーションを実行している管理対象サーバーを再起動します。

9.2.3.9.3 WebCenter Portal Frameworkアプリケーション用の追加設定の構成

Portal Frameworkアプリケーションの場合は、第9.2.3.9.2項「アイテム・レベル・セキュリティの構成」で説明している手順に加えて、デフォルトですべてのユーザーにWCILSアカウントに対するRWDAが確実に付与されるようにする必要もあります。そのためには、SET_DEFAULT_ATTRIBUTESサービスを使用します。SET_DEFAULT_ATTRIBUTESサービスの詳細は、Oracle WebCenter Contentサービス・リファレンスのSET_DEFAULT_ATTRIBUTESに関する項を参照してください。

ブラウザを使用してSET_DEFAULT_ATTRIBUTESサービスを実行するには:

1. ブラウザから、管理ユーザーとしてContent Serverにログインします。

2. ページのソースを表示し、var idcToken =を含む行を検索することによって、idcTokenの値(例: var idcToken = 1316188662243:6FE5F809A3B122277B7A1D19912FBB5)を見つけます。

3. また、同じブラウザ・ウィンドウで次の形式のURLを入力します。

http://host:port/cs/idcplg?IdcService=SET_DEFAULT_ATTRIBUTES&dECPropSubKey=<Security Group>&dDefAttribs=account,WCILS,15&idcToken=<idcToken>&IsSoap=1

例:

http://myhost.com:4444/cs/idcplg?IdcService=SET_DEFAULT_ATTRIBUTES&dECPropSubKey=Custom&dDefAttribs=account,WCILS,15&idcToken=1291297336399:6E324367FC9D2F8BE525F4CEBF4463FC&IsSoap=1

9.2.3.10 Digital Asset Managerの有効化

オプション

フル・イメージ・レンディションをサポートするには、イメージがチェックインされているContent ServerでDigital Asset Manager (DAM)が有効化されている必要があります。DAMが有効化されていない場合、Inbound Refineryを使用した別個のWebレンディションおよびサムネイル・レンディションのみにサポートが制限されます。

たとえば、イメージを含むページを、デスクトップ・ブラウザで表示する場合は高解像度の大きなイメージを使用し、携帯電話で表示する場合は低解像度の小さいイメージを使用し、タブレットで表示する場合はサイズは中型であるが低解像度のイメージを使用できます。

DAMが有効化されている場合、イメージがチェックインされるときに、チェックイン中に指定されたレンディション・セットで決定された様々なレンディションが自動的に作成されます。DAMには組込みのレンディション・セットがいくつか用意されていますが、Content Server管理者は新しいレンディション・セットを作成することもできます。適切なEL式を使用することで、コンテンツ・プレゼンタ表示テンプレートで個々のレンディションを名前で参照できます。

DAMの有効化およびレンディション・セットの作成の詳細は、Oracle WebCenter Contentのマネージングの「イメージおよびビデオの変換の使用」を参照してください。

注意:
WebCenter Portalでは、(ビデオではなく)イメージに対してのみ複数のレンディションがサポートされています。

9.2.3.11 リッチ・テキスト・エディタのWikiマークアップ・タブの表示および非表示

オプション

リッチ・テキスト・エディタ(RTE)でWikiドキュメントを作成または編集するときに、デフォルトでは、「Wikiマークアップ」タブが非表示にされています。「Wikiマークアップ」タブを表示または非表示にするには、構成ファイルblog-wiki-config.xml.xmlを編集します。

警告:

RTEの「Wikiマークアップ」タブと、その他のタブの間で切り替えると、データが失われる場合があります。このため、デフォルトでは「Wikiマークアップ」タブが無効化されています。「Wikiマークアップ」タブを有効化する前に、有効化することにより発生する可能性のある問題について考慮してください。

WebCenter Portalアプリケーションの場合

ポータルの「Wikiマークアップ」タブを表示および非表示にするには:

1. 最新の構成ファイルblog-wiki-config.xml.xmlをMDSからエクスポートします。

exportMetadata(application='webcenter', server='WC_Spaces', toLocation='/scratch/aime1', docs='/oracle/webcenter/doclib/config/mdssys/cust/site/webcenter/blog-wiki-config.xml.xml')

2. この構成ファイルが見つからない場合は、手順1で指定したパスで構成ファイルを作成してから、次のコードを追加するためにファイルを編集します。

<?xml version='1.0' encoding='UTF-8'?>
<mds:customization version="11.1.1.64.86" xmlns:mds="http://xmlns.oracle.com/mds" motype_local_name="adf-blogwiki-config" motype_nsuri="http://xmlns.oracle.com/webcenter/blogwiki/config">
<mds:modify element="(xmlns(mds_ns1=http://xmlns.oracle.com/webcenter/blogwiki/config))/mds_ns1:adf-blogwiki-config/mds_ns1:properties/mds_ns1:property[@name='wiki.markup.enabled']">
<mds:attribute name="value" value="false"/>
</mds:modify>
</mds:customization>

3. 構成ファイルを編集して、次に示すように要素wiki.markup.enabledの値を変更します。

<mds:modify element="(xmlns(mds_ns1=http://xmlns.oracle.com/webcenter/blogwiki/config))/mds_ns1:adf-blogwiki-config/mds_ns1:properties/mds_ns1:property[@name='wiki.markup.enabled']"><mds:attribute name="value" value="true"/></mds:modify>

ここで:

- true: 「Wikiマークアップ」タブの表示

- false (デフォルト): 「Wikiマークアップ」タブの非表示

4. 更新したファイルをMDSにインポートします。

importMetadata(application='webcenter', server='WC_Spaces', fromLocation='/scratch/aime1', docs='/oracle/webcenter/doclib/config/mdssys/cust/site/webcenter/blog-wiki-config.xml.xml')

Portal Frameworkアプリケーションの場合

Portal Frameworkアプリケーションの「Wikiマークアップ」タブを表示および非表示にするには:

1. 最新の構成ファイルblog-wiki-config.xml.xmlをMDSからエクスポートします。

exportMetadata(application='webcenter', server='WC_Spaces', toLocation='/scratch/aime1', docs='/oracle/webcenter/doclib/config/mdssys/cust/site/webcenter/blog-wiki-config.xml.xml')

2. この構成ファイルが見つからない場合は、手順1で指定したパスで構成ファイルを作成してから、次のコードを追加するためにファイルを編集します。

<?xml version='1.0' encoding='UTF-8'?>
<mds:customization version="11.1.1.64.86" xmlns:mds="http://xmlns.oracle.com/mds" motype_local_name="adf-blogwiki-config" motype_nsuri="http://xmlns.oracle.com/webcenter/blogwiki/config">
<mds:modify element="(xmlns(mds_ns1=http://xmlns.oracle.com/webcenter/blogwiki/config))/mds_ns1:adf-blogwiki-config/mds_ns1:properties/mds_ns1:property[@name='wiki.markup.enabled']">
<mds:attribute name="value" value="false"/>
</mds:modify>
</mds:customization>

3. 構成ファイルを編集して、次に示すように要素wiki.markup.enabledの値を変更します。

<mds:modify element="(xmlns(mds_ns1=http://xmlns.oracle.com/webcenter/blogwiki/config))/mds_ns1:adf-blogwiki-config/mds_ns1:properties/mds_ns1:property[@name='wiki.markup.enabled']">
<mds:attribute name="value" value="true"/>
</mds:modify>

ここで:

- true: 「Wikiマークアップ」タブの表示

- false (デフォルト): 「Wikiマークアップ」タブの非表示

4. 更新したファイルをMDSにインポートします。

importMetadata(application='myPortalFrameworkApp', server='WC_CustomPortal', fromLocation='/scratch/aime1', docs='/oracle/webcenter/doclib/config/mdssys/cust/site/site/blog-wiki-config.xml.xml')

9.2.3.12 追加のオプション構成

この項では、追加のオプション構成について説明します。これらの構成はContent Serverを適切に機能させるために必須ではありませんが、これらに構成によって価値が得られ、Content Serverのエンタープライズ・インストールのベスト・プラクティスが確立されます。

この項には次のサブセクションが含まれます:

- 第9.2.3.12.1項「ファイル・ストア・プロバイダの構成」

- 第9.2.3.12.2項「ノード・マネージャの設定」

9.2.3.12.1 ファイル・ストア・プロバイダの構成

Content Serverシステムでは、コンテンツの格納および整理のための従来のファイル・システムのかわりに、データ管理用のファイル・ストアが使用されます。File Store Providerコンポーネントは、(ドキュメントが格納されていない)新しいContent Serverインスタンスに対して、デフォルトでインストール、有効化およびアップグレードされます。File Store Providerコンポーネントは、このコンポーネントによって公開される機能(Web、ボールトおよびWeb URLパス表現の変更など)を活用するために、デフォルトのファイル・ストア(DefaultFileStore)を自動的にアップグレードします。

File Store ProviderコンポーネントはContent Serverインタフェースでファイル・ストア機能を公開し、追加の構成オプションを使用可能にします。たとえば、バイナリ・ラージ・オブジェクト(BLOB)データ型を使用して、ファイル・システムのかわりにデータベースにコンテンツを格納するように、Content Serverインスタンスを構成できます。

File Store Providerでは、チェックインされたコンテンツおよび関連付けられたメタデータが、システム管理者が設定した基準に基づいて調べられ、これらにストレージ・ルールが割り当てられます。基準には、メタデータ、プロファイルまたはその他の考慮事項を含めることができます。ストレージ・ルールによって、Content ServerシステムによるボールトおよびWebファイルの格納方法と、これらへのWebサーバーからのアクセス方法が決まります。

File Store Providerコンポーネントを使用することによって、Content Serverシステムの管理対象のコンテンツの格納とコンテンツへのアクセスのためのデータドリブン・ルールを定義できます。次に示す構成手順では、ファイル・システム上ではなくデータベースにコンテンツが確実に格納されるようにするためのストレージ・ルールが作成されます。

ストレージ・ルールを作成するには:

1. システム管理者としてContent Serverインスタンスにログインします。

2. 「管理」を選択し、「プロバイダ」を選択します。
「プロバイダ」ページが表示されます。

3. DefaultFileStoreプロバイダの隣にある「アクション」列で「情報」をクリックします。
「ファイル・ストア・プロバイダ情報」ページが表示されます。

4. ルール名(例: DBStorage)を指定し、JDBCストレージを選択します。

5. 「OK」をクリックします。
「ファイル・ストア・プロバイダの編集」ページが表示されます。

6. 「更新」をクリックします。

7. Content Serverインスタンスを再起動します。

9.2.3.12.2 ノード・マネージャの設定

Content Serverおよびこのサーバーが配置されているドメイン内の他のサーバーの構成および管理の追加手順として、Oracle WebLogic Serverノード・マネージャの使用も考えられます。ノード・マネージャを使用すると、WebLogic Serverインスタンスのリモートからの起動および停止、これらのモニター、および予期しない障害発生後の自動再起動が可能になります。Content Server、管理サーバーおよびノード・マネージャが同じWebLogic Serverドメイン内でともに動作するように、これらを構成できます。ノード・マネージャは、いずれかのサーバー・インスタンスをホストするすべてのマシンにインストールされます。ノード・マネージャの使用の詳細は、Oracle WebCenter Contentのインストールと構成のOracle WebCenter Contentでのノード・マネージャの使用に関する項を参照してください。

9.2.3.13 Content ServerとWebCenter Portal Frameworkアプリケーション間のセキュリティの構成

Portal Frameworkアプリケーションでは必須

Portal Frameworkアプリケーションと連携するようにContent Serverを構成するには、まず開発環境でコンテンツ・セキュリティとユーザーを設定してから、これらを本番環境に移行する必要があります。セキュリティの詳細は、Oracle WebCenter Contentの管理の高度な管理: セキュリティに関する項も参照してください。

この項では、次の必須手順について説明します。

- セキュリティ・グループの作成: フォルダかドキュメントかを問わず、コンテンツ・アイテムはすべて、セキュリティ・グループ内に配置されている必要があります。フォルダ・コンテンツの表示、編集または管理を誰が行うかに基づいて、フォルダ・コンテンツを制限したり、コンテンツへのアクセスをカスタマイズしたりできるようにするために、フォルダにはセキュリティ・グループが必要です。セキュリティ・グループを作成するには、第9.2.3.13.1項「Content Serverコンソールを使用したセキュリティ・グループの作成」の手順に従ってください。

- ロールの作成: ロールは、読取り、書込み、削除、管理などの様々な権限付きで作成され、セキュリティ・グループに対する権限の定義に使用されます。まず、第9.2.3.13.2項「Content Serverコンソールを使用したロールの作成」の説明に従ってContent Serverでロールを作成してから、第9.2.3.13.3項「Portal Frameworkアプリケーションのロール(グループ)の作成」の説明に従ってPortal Frameworkアプリケーションのロールを作成します。

- フォルダの作成: フォルダ内には、ファイル、サブフォルダ、イメージなどのコンテンツが含まれます。フォルダを作成するには、第9.2.3.13.4項「Content Serverコンソールを使用したフォルダの作成」の手順に従ってください。

- ユーザーの作成: 各ユーザーには、組織内におけるそれぞれのロールと職責に基づいて異なるロールが割り当てられます。第9.2.3.13.5項「外部LDAPのユーザーの作成」または第9.2.3.13.6項「組込みLDAPのユーザーの作成」の説明に従ってユーザーを作成してから、第9.2.3.13.7項「外部LDAPユーザーへのロールの付与」または第9.2.3.13.8項「組込みLDAPユーザーへのロールの付与」の説明に従って、それらのユーザーにロールを付与します。

- セキュリティの移行: これらのセキュリティ・グループ、フォルダ、ユーザーおよびロールを本番環境に移行します。詳細は、第9.2.3.13.9項「本番環境へのセキュリティの移行」を参照してください。

- 構成の確認: セキュリティ・グループとロールが正しく作成されていることを、第9.2.3.13.10項「セキュリティ・グループおよびロール構成の確認」の説明に従って確認します。

この項で説明する手順は、ドキュメント・サービス(wikiおよびブログを含む)とコンテンツ・プレゼンタに適用されます。

9.2.3.13.1 Content Serverコンソールを使用したセキュリティ・グループの作成

セキュリティ・グループを作成するには:

1. 管理者としてContent Serverコンソールにログインします。

2. 「管理」メニューから「管理アプレット」を選択します。

3. 「管理アプレット」ページで「ユーザー管理」をクリックし、「ユーザー管理」ダイアログを表示します。

4. 「セキュリティ」メニューから「グループの権限」を選択します。

5. 「グループの権限」ダイアログで、「グループの追加」をクリックします。

6. 「新しいグループの追加」ダイアログで、WikiBlogなどのグループ名を入力します。

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

セキュリティ・グループが作成されます。このセキュリティ・グループは、第9.2.3.13.4項「Content Serverコンソールを使用したフォルダの作成」でフォルダを作成するときに使用します。

9.2.3.13.2 Content Serverコンソールを使用したロールの作成

この項では、Portal Frameworkアプリケーションで設定するロールを模倣した2つのロール(セキュリティ・グループに対する読取り権限のみを付与するロールと、セキュリティ・グループに対するすべての権限を付与するロール)をContent Serverで設定する方法を説明します。

ロールを作成するには:

1. 管理者としてContent Serverコンソールにログインします。

2. 「管理」メニューから「管理アプレット」を選択します。

3. 「管理アプレット」ページで「ユーザー管理」をクリックし、「ユーザー管理」ダイアログを表示します。

4. 完全なアクセス権を持つ新しいロールを作成します。

1. 「セキュリティ」メニューから「ロールの権限」を選択します。

2. 「グループの権限」ダイアログで、「新しいロールの追加」をクリックします。

3. 「新しいロールの追加」ダイアログで、WikiBlogなどの名前を入力します。

4. 「OK」をクリックします。これにより、「ロールの権限」ダイアログが表示されます。

5. 「グループ/権限」列で、第9.2.3.13.1項「Content Serverコンソールを使用したセキュリティ・グループの作成」の説明に従って事前に作成したセキュリティ・グループ(例: WikiBlog)を選択します。

6. 「アクセス権の編集」をクリックします。

7. 「アクセス権の編集」ダイアログで、「読取り」、「書込み」、「削除」および「管理者」のすべてのチェック・ボックスを選択して「OK」をクリックします。
RWDAアクセス権が有効化されます(図9-3)。

図9-3 RWDA権限

5. 読取りアクセス権のみを持つ別のロール(例: WikiBlogRO)を作成します。4aから4fまでの手順に従い、手順4gの「アクセス権の編集」ダイアログで「読取り」チェック・ボックスを選択します。

9.2.3.13.3 Portal Frameworkアプリケーションのロール(グループ)の作成

この項では、Portal Frameworkアプリケーションで2つのロール(読取りアクセス権を持つロールと、読取り、書込み、削除および管理の完全なアクセス権を持つロール)を作成する手順について説明します。

ロール(グループ)を作成するには:

1. 管理者としてFusion Middleware Controlにログインします。

2. 「ドメイン構造」で「セキュリティ・レルム」をクリックします。

3. 「セキュリティ・レルムのサマリー」セクションの表で、「myrealm」などをクリックします。
重要: myrealmでは、Oracle WebCenter Portalに付属している組込みLDAPが使用されます。インストール環境で別のLDAP (OIDなど)を使用している場合は、組込みLDAPではなく、使用しているLDAPを選択する必要があります。

4. 「ユーザーとグループ」タブを選択し、「グループ」サブタブを選択します。

5. 「グループ」セクションで「新規」をクリックして、「新しいグループの作成」セクションを表示します。

6. 「名前」フィールドに、Content Serverで、第9.2.3.13.2項「Content Serverコンソールを使用したロールの作成」の説明に従って完全アクセス権を付与したロールの名前(例: WikiBlog)を入力して、「OK」をクリックします。

7. 手順5と6を実行して、読取り権限を持つロールまたはグループを作成します(たとえば、WikiBlogRO)。このロールの名前は、第9.2.3.13.2項「Content Serverコンソールを使用したロールの作成」で説明されているように、Content Serverで指定した名前に一致している必要があります。

9.2.3.13.4 Content Serverコンソールを使用したフォルダの作成

フォルダを作成するには:

1. 管理者としてContent Serverコンソールにログインします。

2. 「コンテンツの参照」メニューから「コントリビューション・フォルダ」を選択して、フォルダの作成先のルート・ディレクトリを表示します。

3. 「コントリビューション・フォルダ」ページで、「新規アイテム」メニューから「新規フォルダ」を選択して、「階層フォルダ構成」ページを表示します。

4. 「仮想フォルダ名」フィールドに、わかりやすい名前(例: WikiBlog)を入力します。

5. 「フォルダ情報」セクションの「タイトル」フィールドに、わかりやすいタイトル(例: WikiBlog)を入力します。

6. 「セキュリティ・グループ」ドロップダウンから、第9.2.3.13.1項「Content Serverコンソールを使用したセキュリティ・グループの作成」の説明に従って作成したセキュリティ・グループを選択します。
このフォルダ内のすべてのアイテムが、このセキュリティ・グループからセキュリティを継承します。

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

9.2.3.13.5 外部LDAPのユーザーの作成

この項では、LDIFファイルを使用してユーザーを作成する手順について説明します。このユーザーは、Oracle Internet Directory (OID)などの外部LDAPに追加できます。OIDユーザーは、より一般的にはODSMを使用して管理される点に注意してください(Oracle Internet Directory管理者ガイドのディレクトリ・エントリの管理に関する項を参照してください)。

ユーザーを作成するには:

1. 次に示す例を基にして、LDIFファイルを作成します。

dn: uid=john.doe,ou=people,ou=oidrealm,dc=wc_domain
description: John Doe
cn: john.doe
uid: john.doe
sn: Doe
objectclass: wlsUser
objectclass: organizationalperson
objectclass: inetOrgPerson
objectclass: person
objectclass: top
userpassword: MyPassword
displayName: John Doe
employeeNumber: 12345
employeeType: Regular
givenName: John
homePhone: 650-555-1212
mail: john.doe@example.com
title: Manager
manager: uid=mary.jones,ou=people,ou=myrealm,dc=wc_domain
preferredLanguage: en
departmentNumber: tools
facsimiletelephonenumber: 650-555-1200
mobile: 650-500-1200
pager: 650-400-1200
telephoneNumber: 650-506-1212
postaladdress: 200 Oracle Parkway
l: Redwood Shores
homepostaladdress: 123 Main St., Anytown 12345

2. 次に示すldapaddコマンドを実行して、ユーザーをOIDに追加します。

ldapadd -D <user_dn> -w <password> -h <myhost.mycompany.com> -p <port> -vf
<file_name.ldif>

例:

ldapadd -D cn=john.doe -w MyPassword -h abcd123.example.com -p 1234 -vf
newusers.ldif

9.2.3.13.6 組込みLDAPのユーザーの作成

この項では、2人の組込みLDAPユーザー(読取りロールのユーザーと、読取り、書込み、削除および管理の完全なアクセス・ロールのユーザー)を作成する手順について説明します。

ユーザーを作成するには:

1. 管理者としてFusion Middleware Controlにログインします。

2. 「ドメイン構造」で「セキュリティ・レルム」をクリックします。

3. 「セキュリティ・レルムのサマリー」セクションの表で「myrealm」(組込みLDAPと連携する組込みレルム)をクリックします。

4. 「ユーザーとグループ」タブを選択し、「ユーザー」サブタブを選択します。

5. 「ユーザー」セクションで「新規」をクリックして、「新しいユーザーの作成」セクションを表示します。

6. 「名前」フィールドに名前(例: Joe)を入力します。

7. 「パスワード」フィールドにパスワードを指定します。

8. 「パスワードの確認」フィールドにパスワードを再入力して、「OK」をクリックします。

9. 手順4から8を実行して、もう1人のユーザーを作成します。

9.2.3.13.7 外部LDAPユーザーへのロールの付与

ユーザーにロールを割り当てる手順は次のとおりです。

1. 次に示す例を基にして、グループと各グループに割り当てるユーザーを含んでいるLDIFファイルを作成します。

dn: cn=WikiBlog,cn=Groups,dc=us,dc=example,dc=com
objectclass: wlsUser
objectclass: organizationalperson
objectclass: inetOrgPerson
objectclass: person
objectclass: top
cn: WikiBlog
description: Group of WikiBlog
displayname:WikiBlog group
uniquemember: cn=john.doe,cn=users,dc=example,dc=com

2. 次に示すldapaddコマンドを実行して、ユーザーをOIDに追加します。

ldapadd -D <user_dn> -w <password> -h <myhost.mycompany.com> -p <port> -vf
<file_name.ldif>

例:

ldapadd -D cn=john.doe -w MyPassword -h abc123.example.com -p 1234 -vf
addnewusers.ldif

管理対象サーバーの再起動は必要ありません。

9.2.3.13.8 組込みLDAPユーザーへのロールの付与

この項では、第9.2.3.13.3項「Portal Frameworkアプリケーションのロール(グループ)の作成」で作成したロールを、第9.2.3.13.6項「組込みLDAPのユーザーの作成」で作成したユーザーに割り当てる手順について説明します。

ユーザーにロールを割り当てる手順は次のとおりです。

1. 管理者としてFusion Middleware Controlにログインします。

2. 「ドメイン構造」で「セキュリティ・レルム」をクリックします。

3. 「セキュリティ・レルムのサマリー」セクションの表で「myrealm」(組込みLDAPと連携する組込みレルム)をクリックします。

4. 「ユーザーとグループ」タブを選択し、「ユーザー」サブタブを選択します。

5. 「ユーザー」セクションの表で、第9.2.3.13.6項「組込みLDAPのユーザーの作成」で作成したユーザーの名前をクリックして、設定セクションを表示します。

6. 「グループ」タブを選択します。

7. 「親グループ」の「使用可能」列で、第9.2.3.13.3項「Portal Frameworkアプリケーションのロール(グループ)の作成」で作成した読取り権限を持つロール(例: WikiBlogRO)を選択します。

8. このロールを「選択済み」列に移動して「保存」をクリックします。

9. 手順5から8を繰り返して、作成したもう1人のユーザーに完全なアクセス権限を持つロールを付与します。

9.2.3.13.9 本番環境へのセキュリティの移行

開発環境から本番環境へのセキュリティの移行の詳細は、第30.2.5項「デプロイ後のセキュリティ構成タスク」を参照してください。

9.2.3.13.10 セキュリティ・グループおよびロール構成の確認

構成が完了したら、次の手順に従って、セキュリティ・グループおよびロールが正しく作成されていることと、ルート・フォルダが作成されていることを確認します。

セキュリティ・グループおよびロールが作成されていることを確認する手順は次のとおりです。

1. 管理者としてContent Serverコンソールにログインします。

2. 「管理」メニューから「管理アプレット」を選択します。

3. 「管理アプレット」ページで「ユーザー管理」をクリックし、「ユーザー管理」ダイアログを表示します。

4. 「セキュリティ」メニューから「グループの権限」を選択します。

5. 「グループの権限」ダイアログで、セキュリティ・グループが「グループ」リストに表示されていることを確認します。セキュリティ・グループIDの名前は、ドキュメント・プロパティにあるアプリケーション名と同じである必要があります。

6. 「グループ」リストでセキュリティ・グループを選択します。

7. 「ロール」リストに、アプリケーションに対するR権限を持つ<applicationName>Userロールと、RWD権限を持つ<applicationName>AuthenUserロールの2つが含まれていることを確認します。

ルート・フォルダが作成されていることを確認する手順は次のとおりです。

1. 管理者としてContent Serverコンソールにログインします。

2. 「コンテンツの参照」メニューで、ルート・フォルダが表示されていることを確認して、そのフォルダを選択します。

3. 子のフォルダspacetemplateが表示されていることを確認します。

4. 「情報」をクリックして、「階層フォルダ情報」画面を表示します。

5. セキュリティ・グループが正しいことを確認します。

9.2.3.14 Content Serverリポジトリの登録

Portal Frameworkアプリケーションでは必須/WebCenter Portalではオプションですが強くお薦めします

Portal Frameworkアプリケーションの場合、構成したContent Serverを使用するには、アプリケーションとContent Server間の接続を構成する必要があります。WebCenter Portalの場合、アプリケーションの最初の起動時に接続が自動的に構成されますが、少なくとも接続のテストを行って、期待されるデータが正しくシードされていることを確認してください。

この項には次のサブセクションが含まれます:

- 第9.2.3.14.1項「Portal Frameworkアプリケーション用のContent Server接続の構成」

- 第9.2.3.14.2項「WebCenter Portal用のContent Server接続の構成」

- 第9.2.3.14.3項「Content ServerにシードされたWebCenter Portalデータの確認」

9.2.3.14.1 Portal Frameworkアプリケーション用のContent Server接続の構成

Content Serverのインストールと構成が完了したら、次に、Portal FrameworkアプリケーションとContent Server間の接続を構成します。接続の構成の詳細は、第9.6.2項「Fusion Middleware Controlを使用したコンテンツ・リポジトリの登録」または第9.6.3項「WLSTを使用したコンテンツ・リポジトリの登録」を参照してください。

9.2.3.14.2 WebCenter Portal用のContent Server接続の構成

WebCenter PortalとContent Server間のデフォルトの接続は、アプリケーションの最初の起動時に自動的に構成されますが、接続のテストを行って、使用している環境用に正しく構成されていることを確認してください。高可用性環境やシングル・サインオン環境では、WebCenter Portalのホストおよびポート設定を変更する必要がある場合があります。

Content Serverのインストールおよび構成が完了し、WebCenter Portalを再起動したら、第9.11.1項「Content Server接続のテスト」の説明に従って、WebCenter PortalとContent Server間の接続が正しく構成されていることを確認します。 接続が正しく構成されていなかった場合は、第9.10項「WebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定」の説明に従って接続を構成します。

ドキュメント・ツールなどの一部のWebCenter Portalコンポーネントは、WebCenter Portalの最初の起動時にContent Serverにシードされるデータを使用します。WebCenter Portalで他のコンポーネントを構成する前に、期待されるデータが正しくシードされていることを、第9.2.3.14.3項「Content ServerにシードされたWebCenter Portalデータの確認」の説明に従って確認してください。

9.2.3.14.3 Content ServerにシードされたWebCenter Portalデータの確認

WebCenter Portalの最初の起動時には、デフォルトのデータ・セットがContent Serverにシードされます。WebCenter Portalインスタンスに対してContent Serverにシードされるデータは、アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続で設定されるプロパティに基づきます。例:

Root folder = /WebCenter1
Application Name= WC1

データが正しくない場合や、部分的にしかシードされていない場合は、WebCenter PortalのログとContent Serverの構成を確認して、それらのプロパティに必要な修正を行います。その後、WebCenter Portalインスタンスを再起動してデータを再シードしてください。デフォルトのコンテンツ・リポジトリの設定、およびWebCenter Portalのコンテンツ・リポジトリに必要な追加のプロパティの設定の詳細は、第9.10項「WebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定」を参照してください。

表9-3は、シードされるWebCenter Portalデータ(「シードされるデータ」)、シードされるデータのネーミング(「ネーミング」)、およびContent Serverにデータが作成されていることの確認方法(「検証」)を示しています。

表9-3 WebCenter Portalでシードされるデータ

シードされるデータ

ネーミング

検証

セキュリティ・グループ

1つのセキュリティ・グループがシードされます。

ApplicationName

例: WC1

Content Serverで、「管理」→「管理アプレット」→「ユーザー管理」→「セキュリティ」→「グループの権限」に移動します。

ロール

2つのロールがシードされます。

- ApplicationName
User (セキュリティ・グループに対するR権限を持つ)

- ApplicationName
AuthenUser (セキュリティ・グループに対するRWD権限を持つ)

例: WC1UserおよびWC1AuthenUser

Content Serverで、「管理」→「管理アプレット」→「ユーザー管理」→「セキュリティ」→「ロールの権限」に移動します。

ルート・フォルダ名

RootFolder
(Security Group =<ApplicationName>)

例: /WebCenter1

コンテンツを参照します(フォルダはトップレベルのフォルダとしてリストされます)。

デフォルト属性 - パブリック・ユーザー

すべてのパブリック・ユーザーには次の権限があります。

- アカウント接頭辞PUBLICに対する読取り権限

- アカウント接頭辞WCILSに対する読取り権限

- ApplicationNameUserロール

ExtendedConfigProperties表に対する問合せを実行します。または、Content Serverにログインした後にユーザー名をクリックして、ロールとアカウントをリストするユーザーのプロファイル・ページを表示し、アカウントPUBLICおよびWCILSと、ロール<ApplicationName>Userが含まれていることを確認します。

デフォルト属性 - 認証されたユーザー

認証されたすべてのユーザーには次の権限があります。

- アカウント接頭辞AUTHENに対する読取り権限

- アカウント接頭辞WCILSに対する読取り、書込み、削除、管理権限

- ApplicationNameAuthenUserロール

ExtendedConfigProperties表に対する問合せを実行します。または、Content Serverにログインした後にユーザー名をクリックして、ロールとアカウントをリストするユーザーのプロファイル・ページを表示し、アカウントAUTHENおよびWCILSと、ロールApplicationNameAuthenUserが含まれていることを確認します。

ワークフロー

次の3つのワークフローがシードされます。

- ApplicationNameAllApprover

- ApplicationNameAllReviewer

- ApplicationNameSingleApprover

例: WC1AllApprover、WC1AllReviewerおよびWC1SingleApprover

Content Serverで、「管理」→「ユーザー管理」→「ワークフロー管理」→「条件」タブに移動します。

表9-4は、ホーム・ポータルに対してシードされるデータ(「シードされるデータ」)、シードされるデータのネーミング(「ネーミング」)、およびContent Serverにデータが作成されていることの確認方法(「検証」)を示しています。同じContent Serverを使用しているWebCenter Portalインスタンスの数にかかわらず、ホーム・ポータルのデータはContent Serverに1回のみシードされます。したがって、複数のWebCenter Portalインスタンスで同じContent Serverを使用している場合、これらのインスタンスは同じホーム・ポータル・データを共有することになります。

表9-4 ホーム・ポータルに対してシードされるデータ

シードされるデータ

ネーミング

検証

セキュリティ・グループ

1つのセキュリティ・グループがシードされます。

PersonalSpaces

Content Serverで、「管理」→「管理アプレット」→「ユーザー管理」→「セキュリティ」→「グループの権限」に移動します。

ロール

2つのロールがシードされます。

- PersonalSpacesRole (セキュリティ・グループPersonalSpacesに対するR権限を持つ)

- PersonalSpacesAuthenRole
(セキュリティ・グループPersonalSpacesに対するRWD権限を持つ)

Content Serverで、「管理」→「管理アプレット」→「ユーザー管理」→「セキュリティ」→「ロールの権限」に移動します。

ルート・フォルダ名

PersonalSpaces
(Security Group=PersonalSpaces)

コンテンツを参照します(フォルダはトップレベルのフォルダとしてリストされます)。

デフォルト属性 - パブリック・ユーザー

すべてのパブリック・ユーザーには次の権限があります。

- ルート・フォルダのアカウントに対する読取り権限

- PersonalSpacesロール

ExtendedConfigProperties表に対する問合せを実行します。または、Content Serverにログインした後にユーザー名をクリックして、ロールとアカウントをリストするユーザーのプロファイル・ページを表示し、アカウントPEWebCenter/PUと、ロールPersonalSpacesRoleが含まれていることを確認します。

デフォルト属性 - 認証されたユーザー

認証されたすべてのユーザーには次の権限があります。

- PersonalSpacesAuthenRoleロール

ExtendedConfigProperties表に対する問合せを実行します。または、Content Serverにログインした後にユーザー名をクリックして、ロールとアカウントをリストするユーザーのプロファイル・ページを表示し、ロールPersonalSpacesAuthenRoleが含まれていることを確認します。

9.3 Microsoft SharePointリポジトリの構成

WebCenter PortalまたはPortal FrameworkアプリケーションからMicrosoft SharePointコンテンツ・リポジトリにアクセスするには、Microsoft SharePoint用Oracle WebCenterアダプタをインストールする必要があります。Microsoft SharePoint用Oracle WebCenterアダプタは次の機能をサポートしています。

- Microsoft SharePointリポジトリのコンテンツおよびメタデータの読取り

- SharePointドキュメント・ライブラリへのファイルおよびフォルダの書込み

- Microsoft SharePointシステムに対する問合せの実行

- Microsoft SharePointのネイティブ認証および認可の活用による、アクセス対象コンテンツに対するSharePointセキュリティ設定の有効化

すべての機能は、Microsoft SharePointコンテンツおよびサービスへのインタフェースとしてMicrosoft SharePointのネイティブWebサービスを使用して実装されます。

この項では、WebCenter PortalまたはPortal FrameworkアプリケーションをMicrosoft SharePointに接続するための前提条件について説明します。

- 第9.3.1項「Microsoft SharePoint: インストール」

- 第9.3.2項「Microsoft SharePoint: 構成」

- 第9.3.3項「Microsoft SharePoint: セキュリティに関する考慮事項」

- 第9.3.4項「Microsoft SharePoint: WebCenter Portalでの制限事項」

- 第9.3.5項「WLSTを使用したMicrosoft SharePoint接続の管理」

注意:
WebCenter PortalでMicrosoft SharePoint接続を有効にするには、Oracle Technology Network (http://www.oracle.com/technetwork/middleware/webcenter/owcs-ps3-sharepoint-wcs-wp-335282.pdf)で提供されているホワイトペーパー、SharePoint 2007アダプタのWebCenter Spacesとの統合を参照してください。

9.3.1 Microsoft SharePoint: インストール

この項の内容は次のとおりです。

- 第9.3.1.1項「Microsoft SharePointのインストールについて」

- 第9.3.1.2項「Microsoft SharePoint用Oracle WebCenterアダプタのインストール」

- 第9.3.1.3項「Microsoft SharePoint接続を管理するためのWLSTコマンド・スクリプトのインストール」

9.3.1.1 Microsoft SharePointのインストールについて

Oracle WebCenter Portalは次のMicrosoft SharePointバージョンをサポートしています。

- Microsoft Office SharePoint Server (MOSS) 2007 SP2

- Microsoft Windows SharePoint Services (WSS)バージョン3 SP2

注意:
anonymousアクセス用に構成されたMicrosoft SharePointサイトについては、アダプタによるサポートの対象外です。

インストールの詳細は、該当するMicrosoft SharePointドキュメントを参照してください。

Oracle WebCenter Portalは、Microsoft SharePoint 2007ドキュメント・ライブラリの次のバージョン設定をサポートしています。

- チェックアウトを必須にする: いいえ

- コンテンツの承認: いいえ

- ドキュメントの改訂履歴: バージョンを管理しない

他のバージョン設定が構成されている場合、Microsoft SharePoint用Oracle WebCenterアダプタは正しく機能しません。たとえば、Require CheckOutがyesに設定されていると、アップロード操作が失敗します。同様に、ドキュメントの改訂履歴またはコンテンツの承認が有効化されていると、新しいバージョンまたはドキュメントの表示が制限されます。

9.3.1.2 Microsoft SharePoint用Oracle WebCenterアダプタのインストール

Microsoft SharePoint用Oracle WebCenterアダプタのファイルは、Oracle WebCenter Companion DVD内のofm_wc_generic_jcr_sharepoint_adapter_11.1.1.4.0.zipファイルに含まれています。このZIPファイルを一時的な場所に抽出すると、TEMP_LOCATION/WebCenter/services/content/adaptersディレクトリにアダプタ・ファイルが見つかります。

始める前に:

Microsoft SharePoint用アダプタは、WebCenter PortalまたはPortal Frameworkアプリケーションと同じ管理対象サーバーにインストールする必要があります。まだ実行していない場合は、WebCenter PortalまたはPortal Frameworkアプリケーションのデプロイメントに適した管理対象サーバーを作成します。

WebCenter Portalアプリケーション用にMicrosoft SharePoint用WebCenterアダプタをインストールする手順は次のとおりです。

1. WLS管理コンソールにログインします。
WLS管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. WLS管理コンソールのホーム・ページに移動します。

3. 「ドメイン構造」ペインで「デプロイメント」をクリックします。

4. 「デプロイメントのサマリー」セクションの「制御」で「インストール」をクリックします。

5. 「アプリケーション・インストール・アシスタント」の注意で、テキストの本文内の「ファイルをアップロード」リンクをクリックします。

6. 「デプロイメント・アーカイブ」の隣にある「参照」をクリックして、TEMP_LOCATION/WebCenter/services/content/adaptersディレクトリからoracle.webcenter.content.jcr.sharepoint.earファイルを選択します。これは、Oracle WebCenter Companion DVDからofm_wc_generic_jcr_sharepoint_adapter_11.1.1.4.0.zipのコンテンツを抽出した一時ディレクトリです。「次へ」をクリックします。

7. EARファイルが正常にアップロードされたことを通知するメッセージ(図9-4)が表示されたら、「次へ」をクリックします。

図9-4 アプリケーション・インストール・アシスタント

8. 「このデプロイメントをライブラリとしてインストールする」を選択して、「次へ」をクリックします。

9. 「デプロイ・ターゲットの選択」で、WebCenter PortalまたはPortal Frameworkアプリケーションをデプロイする管理対象サーバーを選択します。
Portal Frameworkアプリケーションの場合、これはWebCenter Portalの初期設定の管理対象サーバーの1つではなく、(カスタム・ポータル・テンプレートに基づく)カスタムの管理対象サーバーである必要があります。詳細は、『Oracle WebCenter Portalインストレーション・ガイド』のカスタム管理対象サーバーを作成するためのドメインの拡張に関する項を参照してください。

10. 「次へ」をクリックします。

11. 「オプション設定」で、デフォルトを受け入れて「終了」をクリックします。

9.3.1.3 Microsoft SharePoint接続を管理するためのWLSTコマンド・スクリプトのインストール

1. Oracle WebCenter Companion DVDに含まれているofm_wc_generic_jcr_sharepoint_adapter_11.1.1.4.0.zipファイルから、DocLibSharePointWLST.pyファイルとDocLibGenericWLST.pyファイルを抽出します。これらのファイルは/WebCenter/services/content/adaptersディレクトリにあります。

2. 抽出したDocLibSharePointWLST.pyファイルとDocLibGenericWLST.pyファイルをコピーして、ORACLE_COMMON_HOME/common/wlstディレクトリに貼り付けます。

3. WLSTコマンドを実行するには、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

WLSTを使用した接続の管理の詳細は、第9.3.5項「WLSTを使用したMicrosoft SharePoint接続の管理」を参照してください。

9.3.2 Microsoft SharePoint: 構成

WebCenter PortalまたはPortal FrameworkアプリケーションでMicrosoft SharePoint接続を有効化するには、次のタスクを実行する必要があります。

1. WebCenter PortalまたはPortal Frameworkアプリケーションのデプロイ先の管理対象サーバーに、Microsoft SharePoint用Oracle WebCenterアダプタをインストールします。

2. Portal Frameworkアプリケーションの場合:

1. JDeveloperで、Microsoft SharePointリポジトリへの接続を構成します。これは、アプリケーション・ナビゲータの「アプリケーション・リソース」に作成されたアプリケーション接続である必要があります。

2. (オプション) JDeveloperで、Microsoft SharePointリポジトリ接続を使用するドキュメント・タスク・フローを追加します。

3. Portal Frameworkアプリケーションをデプロイします。
デプロイ後、JDeveloperで構成したMicrosoft SharePointリポジトリにPortal Frameworkアプリケーションからアクセスできます。

3. デプロイ後、Portal FrameworkアプリケーションのMicrosoft SharePoint接続の詳細を再構成するかWebCenter Portalの接続を構成するには、次の手順を実行します。

1. デプロイ後にMicrosoft SharePoint接続を管理するためのWLSTコマンド・スクリプトをインストールします。詳細は、第9.3.1.3項「Microsoft SharePoint接続を管理するためのWLSTコマンド・スクリプトのインストール」を参照してください。

2. 必要に応じて、新しいMicrosoft SharePointリポジトリ接続を作成するか(createJCRSharePointConnection)、既存の接続の詳細を修正します(setJCRSharePointConnection)。
第9.3.5項「WLSTを使用したMicrosoft SharePoint接続の管理」を参照してください。

注意:
WebCenter PortalでMicrosoft SharePoint接続を有効にするには、Oracle Technology Network (http://www.oracle.com/technetwork/middleware/webcenter/owcs-ps3-sharepoint-wcs-wp-335282.pdf)で提供されているホワイトペーパー、SharePoint 2007アダプタのWebCenter Spacesとの統合を参照してください。

9.3.3 Microsoft SharePoint: セキュリティに関する考慮事項

Microsoft SharePoint接続では、アイデンティティ伝播による認証はサポートされていません。ただし、外部アプリケーションを使用して、Microsoft SharePointリポジトリに対してユーザーを認証できます。WLST引数extAppIdを指定して、使用する外部アプリケーションを指定します。詳細は、第9.3.5.1項「createJCRSharePointConnection」を参照してください。extAppIdが、パブリック資格証明および共有資格証明のいずれも定義されていない外部アプリケーション接続を参照している場合は、ドキュメント・タスク・フローにおいて資格証明を要求するプロンプトが出されます。これにより、アイデンティティ伝播のかわりとして、資格証明のユーザーごとのマッピングが使用できるようになります。

9.3.4 Microsoft SharePoint: WebCenter Portalでの制限事項

WebCenter Portalでは、Microsoft SharePointはポータルのデフォルトのコンテンツ・リポジトリとしてサポートされないため、かわりにOracle WebCenter Contentを使用する必要があります。

9.3.5 WLSTを使用したMicrosoft SharePoint接続の管理

デプロイ後にSharePointコンテンツ・リポジトリへの接続を管理するには、表9-5に示すコマンドを使用します。

これらのWLSTコマンドを使用して行った構成変更は、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動しないと有効になりません。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

表9-5 SharePointコンテンツ・リポジトリWLSTコマンド

コマンド

目的

WLSTの状態

createJCRSharePointConnection

Microsoft SharePoint 2007リポジトリ接続の作成。

オンライン

setJCRSharePointConnection

Microsoft SharePoint 2007リポジトリ接続の編集。

オンライン

listJCRSharePointConnections

WebCenter PortalまたはPortal Frameworkアプリケーション用に構成されているすべてのMicrosoft SharePoint 2007接続のリスト。

オンライン

Microsoft SharePoint用WLSTスクリプトのインストール方法の詳細は、第9.3.1.3項「Microsoft SharePoint接続を管理するためのWLSTコマンド・スクリプトのインストール」を参照してください。

9.3.5.1 createJCRSharePointConnection

createJCRSharePointConnection WLSTコマンドは、Microsoft SharePoint 2007リポジトリへの接続を作成します。このWLSTコマンドの構文およびその他の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のcreateJCRSharePointConnectionに関する項を参照してください。

注意:
Portal Frameworkアプリケーションの場合、createJCRSharePointConnectionコマンドは、アプリケーションがMicrosoft SharePoint接続を最初からサポートするように開発されている場合にのみ機能します。元のPortal Frameworkアプリケーション・デプロイメントにMicrosoft SharePoint接続が含まれていない場合は、このコマンドを使用して作成する新しいMicrosoft SharePoint接続のサポートに必要なコードがアプリケーションに組み込まれなくなります。第9.3.2項「Microsoft SharePoint: 構成」も参照してください。

9.3.5.2 setJCRSharePointConnection

このWLSTコマンドは、既存のMicrosoft SharePoint 2007リポジトリ接続を編集します。このWLSTコマンドの構文およびその他の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のsetJCRSharePointConnectionに関する項を参照してください。

9.3.5.3 listJCRSharePointConnections

このWLSTコマンドは、指定されたアプリケーション用に構成されているすべてのSharePoint接続をリストします。このWLSTコマンドの構文およびその他の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のlistJCRSharePointConnectionsに関する項を参照してください。

9.4 Oracle Portalリポジトリの構成

次の各項では、Oracle Portalコンテンツ・リポジトリの前提条件について説明します。

- 第9.4.1項「Oracle Portal: インストール」

- 第9.4.2項「Oracle Portal: 構成」

- 第9.4.3項「Oracle Portal: セキュリティに関する考慮事項」

- 第9.4.4項「Oracle Portal: Oracle WebCenter Portalでの制限事項」

9.4.1 Oracle Portal: インストール

Oracle Portalのインストールの詳細は、Oracle Portal、Forms、ReportsおよびDiscovererインストレーション・ガイドを参照してください。

9.4.2 Oracle Portal: 構成

最新のパッチの適用によりOracle Portalが最新の状態になっていることが必要です。パッチの詳細は、製品のリリース・ノートを参照してください。Oracle Portal管理者ガイドも参照してください。

9.4.3 Oracle Portal: セキュリティに関する考慮事項

なし。

9.4.4 Oracle Portal: Oracle WebCenter Portalでの制限事項

Oracle WebCenter PortalとのOracle Portal統合は読取り専用です。WebCenter PortalまたはPortal Frameworkアプリケーションを使用して、コンテンツを作成することはできません。

Oracle PortalでポートレットとしてOracle Portalページを公開することによって、フェデレーテッド・ポータル・アダプタを使用してWebCenter PortalまたはPortal FrameworkアプリケーションでOracle Portalページを公開できます。次のものはフェデレーテッド・ポータル・アダプタによって返されないため、Oracle WebCenter Portalでは表示されません。

- シードされたページ・グループ:

- Oracle Portalリポジトリ

- Oracle Portalデザインタイム・ページ

- 次のタイプのページ:

- モバイル

- URL

- ナビゲーション・ページ

- 次のタイプのアイテム:

- ナビゲーション・アイテム

- PLSQLアイテム

- ポートレット

- ポートレット・インスタンス

- URLアイテム

- モバイル・アイテム

- ページ・リンク

- アイテム・リンク

- 次のように定義されているアイテム:

- 期限切れ

- 非表示

9.5 ファイル・システム・リポジトリの構成

次の各項では、ファイル・システム・コンテンツ・リポジトリへの接続の前提条件について説明します。

- 第9.5.1項「ファイル・システム: セキュリティに関する考慮事項」

- 第9.5.2項「ファイル・システム: 制限事項」

注意:
ファイル・システム接続は、Portal Frameworkアプリケーションの開発時のみ使用してください。ファイル・システム接続は、本番またはエンタープライズ・アプリケーションのデプロイには使用しないでください。この機能は、開発用としてのみ提供されます。
WebCenter Portalでは、ファイル・システム接続はサポートされていません。

9.5.1 ファイル・システム: セキュリティに関する考慮事項

すべての操作が、JVMの実行元であるシステム・ユーザーとして実行され、その権限を継承します。

9.5.2 ファイル・システム: 制限事項

ファイル・システム接続は、本番またはエンタープライズ・アプリケーションのデプロイには使用しないでください。また、索引がないため、検索機能が制限され、低速です。この機能は、開発用としてのみ提供されます。

9.6 WebCenter PortalまたはPortal Frameworkアプリケーション用のコンテンツ・リポジトリの登録

この項には次のサブセクションが含まれます:

- 第9.6.1項「WebCenter Portal用のコンテンツ・リポジトリの登録について」
第9.6.2項「Fusion Middleware Controlを使用したコンテンツ・リポジトリの登録」

- 第9.6.3項「WLSTを使用したコンテンツ・リポジトリの登録」

9.6.1 WebCenter Portal用のコンテンツ・リポジトリの登録について

WebCenter Portal用のコンテンツ・サーバー・リポジトリを登録する際には、次の点を考慮してください。

- WebCenter Portalは起動時に、WebCenter Portalのプライマリ/アクティブ/デフォルト・リポジトリにシード・データを作成します(このデータがまだ存在しない場合)。

- WebCenter Portalでは、Microsoft SharePointなどの別のリポジトリが使用可能になっている場合でも、Content Serverリポジトリ接続をプライマリ接続として常に提供する必要があります。

- Content Serverインスタンスに対する管理権限を持つユーザー名が必要です(Content Administrator)。ポータル・コンテンツ、セキュリティ・グループおよびロール用のフォルダの作成と保守、およびコンテンツへのアクセス権の管理には、このユーザーが使用されます。デフォルトのコンテンツ管理者はsysadminです。
WebCenter Portalユーザーにかわって操作を実行できるようにするために、この接続には管理権限が必要です。

- Root FolderとApplication Nameの値:

- WebCenter Portalでのアクティブな接続用に、Root FolderとApplication Nameの値を使用してWebCenter Portalリポジトリにシード・データが作成され、それによってポータル関連データの格納が可能になります。

警告:

Root FolderとApplication Nameの値は個別に変更しないでください。これらは常に両方変更する必要があります。つまり、WebCenter Portalを構成し、実行した後にRoot Folder値を変更する場合は、Application Nameも変更する必要があります(逆の場合も同様です)。つまり、WebCenter Portalにすでにシード・データが格納されている場合は、両方(Root FolderおよびApplication Name)の値を一意の値に変更する必要があります。

これらの値を変更しても、Content Serverリポジトリ内の既存のシード・データの名前は変更されません。かわりに、アプリケーションを起動したときに、新しい値を使用して新しいシード・データが作成されます。アプリケーションが起動すると、新しいRoot Folderの下に新しいWebCenter Portalデータが作成され、以前のRoot Folderの下の既存のデータは使用できなくなります。つまり、以前、Root Folderの変更前にドキュメント・ツールが有効であったWebCenter Portalで、ドキュメント・ツールが無効化されます。

注意:
Root FolderとApplication Nameの値が変わっても、以前のルート・コンテンツ・リポジトリ・フォルダは、Content Serverの他のあらゆるルート・フォルダと同様に、引き続き検索結果に表示されます。

- Root Folder値は、すべてのWebCenter Portalコンテンツの格納場所である、コンテンツ・リポジトリ内のルート・フォルダの名前として使用されます。Root Folder値には、まだ存在していないコンテンツ・リポジトリ・フォルダを指定する必要があります。形式は/foldernameを使用します。例: /MyWebCenterSpaces。Root Folderを/ (ルート自体)にすることはできません。また、様々なポータル間で一意にする必要があります。WebCenter Portalの起動時に、指定したフォルダが作成されます。無効なエントリの例: /、/foldername/、/foldername/subfolder。

- Application Nameはこのコンテンツ・リポジトリ内でWebCenter Portalインスタンスを識別し、これには一意の値(例: MyWCPApp)を指定する必要があります。この名前は14文字以内とし、英字を先頭に、英数字またはアンダースコア文字の任意の組合せで構成する必要があります。ここで指定した名前は、<applicationName><WorkflowName>および<applicationName><WorkflowStepName>として、ドキュメント関連のワークフローのネーミングにも使用されます。ワークフローのネーミング時には、Application Nameの先頭の14文字のみが使用されます。
Application Name値の用途は次のとおりです。

- 複数のWebCenter Portalインスタンスが同じコンテンツ・リポジトリを共有しており、アプリケーション間で一意にする必要があるときにデータを分離するために使用する。

- シードされるワークフローおよびワークフロー手順の接頭辞として使用する。

- WebCenter Portalインスタンスで作成されたすべてのデータを格納するセキュリティ・グループの名前として使用する。

- ロールの接頭辞として使用する(名前の書式はapplicationNameUserおよびapplicationNameAuthenUser)。

- 特定のWebCenter Portalインスタンス用にアカウントに対するユーザー権限をストライプ化するために使用する。

- 特定のWebCenter Portalインスタンス用にデフォルトの属性をストライプ化するために使用する。

セキュリティ・グループとロールの詳細は、Oracle WebCenter Contentの管理の高度な管理: セキュリティに関する項を参照してください。フォルダの詳細は、Oracle WebCenter Contentのマネージングの「コンテンツの整理」を参照してください。

9.6.2 Fusion Middleware Controlを使用したコンテンツ・リポジトリの登録

Fusion Middleware Controlを使用して、Content Server、Oracle Portalまたはファイル・システムのコンテンツ・リポジトリを登録するには、後述の手順に従ってください。SharePointリポジトリを登録するには、第9.6.3「WLSTを使用したコンテンツ・リポジトリの登録」の説明に従って、WLSTを使用する必要があります。WLSTを使用したContent Serverリポジトリの登録方法の詳細は、第9.10.2項「WLSTを使用したWebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定」を参照してください。

Content Server、Oracle Portalまたはファイル・システムのコンテンツ・リポジトリを登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- WebCenter Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenterサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 新規のコンテンツ・リポジトリに接続するには、「追加」をクリックします(図9-5)。

図9-5 コンテンツ・リポジトリ接続の構成

5. この接続の一意の名前を入力し、コンテンツ・リポジトリ・タイプを指定して、この接続をアプリケーションのアクティブな(またはデフォルトの)接続にするかどうかを指定します。表9-6を参照してください。

表9-6 コンテンツ・リポジトリ接続の管理

フィールド

説明

接続名

このコンテンツ・リポジトリ接続の一意の名前を入力します。名前は、WebCenter PortalまたはPortal Frameworkアプリケーションのすべての接続タイプにおいて一意である必要があります。

リポジトリ・タイプ

接続先のリポジトリのタイプを選択します。次のうちから選択します。

- Content Server: Oracle Universal Content Managementリポジトリ。第9.2項「Oracle WebCenter Content Serverリポジトリの構成」を参照してください。

- Oracle Portal: Oracle Portalコンテンツ・リポジトリ。第9.4項「Oracle Portalリポジトリの構成」を参照してください。

- ファイル・システム: コンピュータ・ファイル・システム。第9.5項「ファイル・システム・リポジトリの構成」を参照してください。
注意: ファイル・システム接続は、本番またはエンタープライズ・アプリケーションのデプロイには使用しないでください。この機能は、開発用としてのみ提供されます。

(WebCenter Portal) WebCenter Portal用のバックエンド・コンテンツ・リポジトリ、つまりポータル関連のドキュメントを格納するために使用するリポジトリを設定する場合は、「Content Server」を選択する必要があります。

アクティブな接続

このフィールドを選択した場合、これがWebCenter PortalまたはPortal Frameworkアプリケーションのデフォルトまたはプライマリのコンテンツ・リポジトリとなります。

WebCenter PortalまたはPortal Frameworkアプリケーションを複数のコンテンツ・リポジトリに接続できます(すべての接続が使用されます)。1つの接続をデフォルトの(またはアクティブな)接続として指定する必要があります。次のいずれかを実行します。

- WebCenter Portalの場合:
このフィールドを選択した場合、これがアクティブな接続、つまりポータル関連のドキュメントを格納するためにWebCenter Portalで使用されるバックエンド・リポジトリとなります。アクティブな接続は、接続先がContent Serverリポジトリである必要があります。

これがWebCenter Portalのデフォルトのコンテンツ・リポジトリである場合、いくつかの追加構成が必要になります(第9.10.1項「Fusion Middleware Controlを使用したWebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定」を参照)。

- Portal Frameworkアプリケーションの場合:
このフィールドを選択した場合、これがアクティブな接続となります。つまり、コンテンツ・プレゼンタ、ドキュメント・マネージャ、ドキュメント・リスト・ビューアおよび最近のドキュメント・タスク・フローのデフォルトの接続となります。これらのタスク・フローに特定の接続の詳細が指定されていない場合は、このデフォルトの(プライマリ、アクティブとも呼ばれます)接続が使用されます。

このオプションの選択を解除しても、コンテンツ・リポジトリ接続は無効化されません。コンテンツ・リポジトリが不要になった場合は、その接続を削除する必要があります。

6. (WebCenter Portalのアクティブな接続に対してのみ。)WebCenter Portalリポジトリの追加の詳細を入力します。詳細は、第9.6.1項「WebCenter Portal用のコンテンツ・リポジトリの登録について」を参照してください。

7. コンテンツ・リポジトリの接続の詳細を入力します。パラメータの詳細は、次の表を参照してください。

- 表9-7「Content Serverの接続パラメータ」

- 表9-8「接続: Content Server: キャッシュ詳細」

- 表9-9「Oracle Portalの接続パラメータ」

- 表9-10「ファイル・システムの接続パラメータ」

表9-7 Content Serverの接続パラメータ

フィールド

説明

RIDCソケット・タイプ

Content Serverをコンテンツ・サーバー・リスナー・ポートとWebサーバー・フィルタのどちらで接続するか、およびリスナー・ポートがSSL対応かどうかを指定します。次のうちから選択します。

- ソケット: intradocソケット接続を使用してContent Serverに接続します。クライアントIPアドレスをContent Serverの認証済アドレスのリストに追加する必要があります。この場合、クライアントはOracle WebCenter Portalを実行しているマシンです。

- ソケットSSL: SSLプロトコルを使用して保護されているContent Serverに、intradocソケット接続を使用して接続します。接続を可能にするには、クライアントの証明書をサーバーのトラスト・ストアにインポートする必要があります。これは最もセキュアなオプションであり、WebCenter Portalなどでアイデンティティ伝播が必要な場合の推奨オプションです。

- Web: HTTP(S)接続を使用してContent Serverに接続します。WebCenter Portalの場合、「Web」オプションではアイデンティティ伝播ができないため、このオプションはアクティブな接続、つまりポータル関連のドキュメントの格納に使用するバックエンドのContent Serverリポジトリには適しません。

サーバー・ホスト

Content Serverを実行しているマシンのホスト名を入力します。

例: mycontentserver.mycompany.com

「RIDCソケット・タイプ」を「ソケット」または「ソケットSSL」に設定した場合は、「サーバー・ホスト」の指定が必須です。

サーバー・ポート

Content Serverがリスニングするポートを入力します。

- ソケット: サーバーでincomingプロバイダに対して指定されているポート。

- ソケットSSL: サーバーでsslincomingプロバイダに対して指定されているポート。

このプロパティは、Content Server構成ファイルのIntradocServerPort設定に対応するものであり、デフォルトはポート4444です。Content Serverにログインし、「管理」→「管理サーバー」→「一般構成」→「追加の構成変数」→「IntradocServerPort」に移動し、現在の値を検索できます。

「RIDCソケット・タイプ」を「ソケット」または「ソケットSSL」に設定した場合は、「サーバー・ポート」の指定が必須です。

Web URL

Content ServerのWebサーバーURLを入力します。

http://hostname:portnumber/web_root/plugin_rootという形式を使用します。

例: http://mycontentserver/cms/idcplg

「Web URL」は、「RIDCソケット・タイプ」を「Web」に設定した場合に適用されます。

接続タイムアウト(ミリ秒)

接続タイムアウト・メッセージを発行する前にWebCenter Content Serverにログインできる時間(ミリ秒)を指定し、すべてのサービス・リクエストの基本のRIDC接続のソケット・タイムアウトを設定します。

注意: RIDCソケット・タイムアウトは、ソケット、ソケットSSLおよびWeb接続タイプにのみ適用されます。

「接続タイムアウト」プロパティが設定されていない場合は、次の値が使用されます。

- ログイン・タイムアウト: デフォルトの同時タイムアウトは、oracle.webcenter.contentリソースに対して構成されます(30秒または30000ミリ秒)。詳細は、パフォーマンス・チューニング・ガイドの同時実行性管理の構成に関する項を参照してください。

- RIDCソケット・タイムアウト: デフォルトのRIDCソケット・タイムアウト(60秒または60000ミリ秒)は、ソケット、ソケットSSLおよびWeb接続タイプのすべてのサービス・リクエストで使用されます。

「接続タイムアウト」プロパティが設定され、接続タイプがソケット、ソケットSSL、Webのいずれかの場合は、60000ミリ秒未満の値を指定しないことをお薦めします。RIDCソケット・タイムアウトが短くなり、長時間実行されるリクエストがタイムアウトする可能性が高くなるためです。たとえば、長時間実行される検索、長時間のファイル・アップロード、長時間のコピー操作中にタイムアウトする可能性があります。

認証方式

次のうちから選択します。

- アイデンティティ伝播: Content ServerとWebCenter Portal (またはPortal Frameworkアプリケーション)で、ユーザーの認証に同じアイデンティティ・ストアを使用します。
(WebCenter Portal) WebCenter Portal用のアクティブな接続、つまり、ポータル関連のドキュメントの格納に使用するコンテンツ・リポジトリでは、「アイデンティティ伝播」を選択する必要があります。

- 外部アプリケーション: 外部アプリケーションによって、Content Serverに対するユーザーの認証を行います。パブリック資格証明、共有資格証明またはマップされた資格証明を使用する場合は、このオプションを選択します。『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のドキュメント・ツールのセキュリティの設定に関する項も参照してください。

認証に外部アプリケーションを使用する場合は、「関連付けられている外部アプリケーション」ドロップダウン・リストを使用して、アプリケーションを指定します。目的のアプリケーションがリストに表示されない場合は、「新規作成」を選択して、ここで外部アプリケーションを定義します。

Webサーバー・コンテキスト・ルート

Content ServerのWebサーバー・コンテキスト・ルートを入力します。/<context_root>の形式を使用します。たとえば、/csとなります。

指定した場合、WebCenter PortalまたはPortal Frameworkアプリケーションで、iFrameに基づく複数のContent Server機能が使用可能になります。これには次が含まれます。

- Content Serverへの新しいファイルや更新されたファイルのアップロード時における、ファイルへのコンテンツ・プロファイルの関連付け。
詳細は、Oracle WebCenter Portalの使用のファイルのアップロードおよび既存のファイルの新規バージョンのアップロードを参照してください。

- Oracle AutoVueで利用できるドキュメント確認機能の使用。
詳細は、『Oracle WebCenter Portalの使用』のOracle AutoVueによるドキュメントのコラボレーションに関する項を参照してください。

- 拡張ドキュメント・プロパティの編集。
詳細は、『Oracle WebCenter Portalの使用』のワークフローのファイルの表示に関する項を参照してください。

- フォルダおよびファイルのワークフローの詳細の表示。
詳細は、Oracle WebCenter Portalでのポータルの構築のワークフローのファイルの表示に関する項を参照してください。

- スライド・ビューアでのファイルのプレビュー。
詳細は、『Oracle WebCenter Portalの使用』のファイルのオープンに関する項を参照してください。

- Site Studioの統合
OHS (およびWebContextRoot構成)がなくても、コンテンツ・プレゼンタ内からSite Studioコンテンツの作成や編集を行えますが、作成および編集アクションは、コンテンツ・プレゼンタ・タスク・フロー内で開かれるのではなく、新しいブラウザ・ウィンドウ(またはタブ)が起動されます。詳細は、Oracle WebCenter Portalでのポータルの構築の「コンテンツ・プレゼンタ構成」ダイアログでのSite Studioコンテンツの作成および編集に関する項を参照してください。

「Webサーバー・コンテキスト・ルート」プロパティは、「認証方式」を「アイデンティティ伝播」に設定した場合にのみ適用されます。

注意: Webサーバー・コンテキスト・ルートを指定した場合、WebCenter PortalまたはPortal FrameworkアプリケーションのフロントエンドがOHSになることを表します。Webサーバー・コンテキスト・ルートを指定したにもかかわらず、OHSを介して接続しないと、ドキュメント・ビューアでの拡張メタデータの編集、プロファイルを使用したアップロード、またはポータルでのワークフロー内のコンテンツ・アイテムに対する「詳細」のクリック時に404エラーが発生します。WebCenter PortalまたはPortal FrameworkアプリケーションのフロントエンドになるOHSの設定の詳細は、付録B「WebCenter PortalのOracle HTTP Server構成」を参照してください。

WebCenter PortalまたはPortal Frameworkアプリケーションが複数のContent Serverサーバーに接続されている場合は、OHSリダイレクションが正しく動作するように、各Content Serverサーバーに一意のWeb Serverコンテキスト・ルートを設定することをお薦めします。

関連付けられている外部アプリケーション

Content Serverに対するユーザーの認証に使用する外部アプリケーションを選択します。

「関連付けられている外部アプリケーション」は、「RIDCソケット・タイプ」を「Web」に設定した場合、および「RIDCソケット・タイプ」が「ソケット」または「ソケットSSL」(「認証方式」を「外部アプリケーション」に設定)である場合に適用されます。

管理者ユーザー名

このContent Serverインスタンスに対する管理権限を持つユーザー名を入力します。このユーザーは、プロファイルに基づくコンテンツ・タイプ情報のフェッチと、キャッシュ無効化のためのドキュメントの変更の追跡に使用されます。

デフォルトはsysadminです。

管理者のパスワード

Content Server管理者のパスワードを入力します。

キー・ストアの場所

セキュリティ・アサーションの署名に使用する秘密鍵が含まれるキーストアの場所を指定します。キー・ストアの場所は絶対パスで指定する必要があります。

例: D:\keys\keystore.xyz

「RIDCソケット・タイプ」を「ソケットSSL」に設定した場合は、「キー・ストアの場所」の指定が必須です。

キー・ストア・パスワード

キーストアへのアクセスに必要なパスワードを入力します。

例: T0PS3CR3T

「RIDCソケット・タイプ」を「ソケットSSL」に設定した場合は、「キー・ストア・パスワード」の指定が必須です。

秘密鍵の別名

キーストアの中のクライアント秘密鍵の別名を入力します。この秘密鍵は、サーバーに対してメッセージを署名するために使用されます。この秘密鍵に対応する公開鍵をサーバー・キーストアにインポートする必要があります。

特殊文字および空白を含まない別名を指定する必要があります。例: enigma

「RIDCソケット・タイプ」を「ソケットSSL」に設定した場合は、「秘密鍵の別名」の指定が必須です。

秘密鍵のパスワード

キー・ストアの秘密鍵の別名とともに使用するパスワードを入力します。

例: c0d3bR3ak3R

「RIDCソケット・タイプ」を「ソケットSSL」に設定した場合は、「秘密鍵のパスワード」の指定が必須です。

表9-8 接続: Content Server: キャッシュ詳細

要素

説明

キャッシュ無効化間隔(分)

外部Content Serverコンテンツの変更を確認する時間を指定します(分単位)。変更されたアイテムは、WebCenter Portalによって自動的にキャッシュからクリアされます。最小間隔は2分です。

デフォルトではキャッシュ無効化は無効になっているため、コンテンツ変更の定期的な確認は行われません(0が表示されます)。

キャッシュされたドキュメントの最大サイズ(バイト)

Content Serverバイナリ・ドキュメントのキャッシュ可能な最大サイズを入力します(バイト単位)。このサイズより大きいドキュメントは、WebCenter Portalによってキャッシュされません。

デフォルトは102400バイト(100K)です。

使用マシンのメモリー構成と、キャッシュされることが期待されるバイナリ・ドキュメントのタイプに基づいて、この値を調整してください。Coherenceが有効化されている場合を除き、キャッシュの最大合計サイズはありません。

Coherenceを使用している場合、バイナリ・キャッシュに使用するメモリー量合計を追加で指定できます。この理由により、どのタイプの本番環境にもCoherenceを使用することを強くお薦めします。これは、高可用性(HA)環境の要件です。詳細は、第9.8.3項「コンテンツ・プレゼンタのキャッシュ設定の変更」を参照してください。

注意: Content Serverに格納されているほとんどのドキュメントは、イメージ、プレーン・テキスト、Word文書などのバイナリ・コンテンツです。唯一の例外はCDFデータ・ファイルに格納されるSite Studioコンテンツで、これは仮想コンテンツ・リポジトリ(VCR)キャッシュ(またはノード・キャッシュ)に個別にキャッシュされます。

表9-9 Oracle Portalの接続パラメータ

フィールド

説明

データ・ソース名

Oracle Portalへの接続に使用するJNDIデータソースの場所を入力します。

例: jdbc/MyPortalDS

データ・ソースは、WebCenter PortalまたはPortal Frameworkアプリケーションのデプロイ先のサーバーに配置されている必要があります。

接続タイムアウト(ミリ秒)

Oracle Portalへのログイン時に許容される、接続タイムアウト・メッセージを発行するまでの時間(ミリ秒)を指定します。

タイムアウトが設定されていない場合は、oracle.webcenter.contentリソースのデフォルトの同時タイムアウトが使用されます(30秒または30000ミリ秒)。詳細は、パフォーマンス・チューニング・ガイドの同時実行性管理の構成に関する項を参照してください。

認証方式

Oracle Portalに対するユーザーの認証方法を指定します。次のうちから選択します。

- アイデンティティ伝播: WebCenter Portal(またはPortal Frameworkアプリケーション)とOracle Portalで同じユーザー・アイデンティティ・ストアを使用する場合は、このオプションを選択します。

- 外部アプリケーション: Oracle Portalに対するユーザーの認証に外部アプリケーションを使用します。パブリック資格証明、共有資格証明またはマップされた資格証明を使用する場合は、このオプションを選択します。

認証に外部アプリケーションを使用する場合は、「関連付けられている外部アプリケーション」ドロップダウン・リストを使用して、アプリケーションを指定します。

関連付けられている外部アプリケーション

Oracle Portalを外部アプリケーションに関連付けます。外部アプリケーションの資格証明情報を使用してOracle Portalユーザーが認証されます。ドロップダウン・リストから既存の外部アプリケーションを選択するか、または「新規作成」をクリックして、新しい外部アプリケーションを構成できます。

表9-10 ファイル・システムの接続パラメータ

フィールド

説明

ベース・パス

コンテンツを格納するローカル・ファイル・システム上のフォルダへのフルパスを入力します。例: C:\MyContent

注意: ファイル・システム・コンテンツは、本番またはエンタープライズ・アプリケーションのデプロイには使用しないでください。この機能は、開発用としてのみ提供されます。

8. 「OK」をクリックして、この接続を保存します。

9. 「テスト」をクリックして、作成した接続が機能するかどうかを検証します。正常な接続の場合、新しい(アクティブな)接続の使用を開始するにはWebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があることを通知するアドバイスが「テストのステータス」メッセージに表示されます。

登録された接続がドキュメント・タスク・フローおよびコンテンツ・プレゼンタ・タスク・フローで使用可能になり、WebCenter PortalまたはPortal Frameworkアプリケーションでページに追加できるようになります。Oracle WebCenter Portalでのポータルの構築のドキュメント・タスク・フローおよびドキュメント・コンポーネントでの作業に関する項も参照してください。

9.6.3 WLSTを使用したコンテンツ・リポジトリの登録

Portal Frameworkアプリケーションの新しいコンテンツ・リポジトリ接続の登録には、次のWLSTコマンドを使用します。

- Content Server: createJCRContentServerConnection

- ファイル・システム: createJCRFileSystemConnection

- Oracle Portal: createJCRPortalConnection

- Microsoft SharePoint: createJCRSharePointConnection

コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

特定の接続をデフォルト接続として構成するには、isPrimary='1'を設定します。第9.7項「アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」を参照してください。

注意:
WebCenter PortalのデフォルトのContent Serverリポジトリに対して追加の接続プロパティを設定する必要があります(詳細は、第9.10.2項「WLSTを使用したWebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定」を参照)。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
新しい(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。ドキュメント・ツールを使用する場合は、初期プロビジョニングを行うために、最初にContent Serverを起動する必要があります。

9.7 アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更

WebCenter PortalおよびPortal Frameworkアプリケーションでは複数のコンテンツ・リポジトリ接続がサポートされていますが、アクティブな(またはデフォルトの)接続として指定できるコンテンツ・リポジトリ接続は1つのみです。

WebCenter Portalでは、アクティブな接続はポータル・ドキュメント(ホーム・ポータルを含む)のデフォルトのバックエンド・リポジトリになり、このリポジトリはContent Serverである必要があります。アクティブな接続は、ドキュメント・タスク・フローおよびコンテンツ・プレゼンタ・タスク・フローのデフォルトの接続としても使用されます。

Portal Frameworkアプリケーションの場合は、アクティブな接続は、コンテンツ・プレゼンタ、ドキュメント・マネージャ、ドキュメント・リスト・ビューア、最近のドキュメントなどのデフォルトの接続になります。これらのタスク・フローに特定の接続の詳細が指定されていない場合は、デフォルトの(アクティブな)接続が使用されます。

この項には次のサブセクションが含まれます:

- 第9.7.1項「Fusion Middleware Controlを使用したアクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」

- 第9.7.2項「WLSTを使用したアクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」

9.7.1 Fusion Middleware Controlを使用したアクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更

アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続を変更するには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。
「コンテンツ・リポジトリ接続の管理」表に、現在のアクティブな接続(ある場合)が示されます。

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」をクリックします。

5. 「アクティブな接続」チェック・ボックスを選択します。
変更を保存する前に、「コンテンツ管理者」、「ルート・フォルダ」、「アプリケーション名」フィールドの値を必ず入力します。

6. 「OK」をクリックして、接続を更新します。

7. 「テスト」をクリックして、アクティブ化した接続が機能するかどうかを検証します。接続が正常にアクティブ化されると、更新した接続の使用を開始するにはWebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があることを通知するアドバイスが「テストのステータス」メッセージに表示されます。

9.7.2 WLSTを使用したアクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更

既存のコンテンツ・リポジトリ接続をデフォルトの接続として指定するには、次のWLSTコマンドを使用し、isPrimary='1'と指定します。

- Content Server: setJCRContentServerConnection

- ファイル・システム: setJCRFileSystemConnection

- Oracle Portal: setJCRPortalConnection

- Microsoft SharePoint: setJCRSharePointConnection
「listJCRSharePointConnections」も参照してください。

コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

後からデフォルトのコンテンツ・リポジトリ接続を無効化するには、isPrimary='false'と指定して同じWLSTコマンドを実行します。接続の詳細は保持されますが、この接続はadf-config.xml内に主要な接続として示されなくなります。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
新しい(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

9.8 コンテンツ・リポジトリ接続の詳細の変更

この項には次のサブセクションが含まれます:

- 第9.8.1項「Fusion Middleware Controlを使用したコンテンツ・リポジトリ接続の詳細の変更」

- 第9.8.2項「WLSTを使用したコンテンツ・リポジトリ接続の詳細の変更」

- 第9.8.3項「コンテンツ・プレゼンタのキャッシュ設定の変更」

- 第9.8.4項「外部Content Serverの変更を確認するためのキャッシュの構成」

9.8.1 Fusion Middleware Controlを使用したコンテンツ・リポジトリ接続の詳細の変更

コンテンツ・リポジトリ接続の詳細を更新する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータの詳細は、次の表を参照してください。

- 表9-7「Content Serverの接続パラメータ」

- 表9-9「Oracle Portalの接続パラメータ」

- 表9-10「ファイル・システムの接続パラメータ」

6. 「OK」をクリックして、変更を保存します。

7. 「テスト」をクリックして、更新した接続が機能するかどうかを検証します。接続が正常に更新されると、更新した接続の使用を開始するにはWebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があることを通知するアドバイスが「テストのステータス」メッセージに表示されます。

9.8.2 WLSTを使用したコンテンツ・リポジトリ接続の詳細の変更

次のWLSTコマンドを使用して、コンテンツ・リポジトリ接続を編集します。

- Oracle WebCenter Content Server: setJCRContentServerConnection

- ファイル・システム: setJCRFileSystemConnection

- Oracle Portal: setJCRPortalConnection

コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

特定の接続をアクティブな(またはデフォルトの)接続として構成するには、isPrimary='1'を設定します。第9.7項「アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
更新された(アクティブな)接続の詳細の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

9.8.3 コンテンツ・プレゼンタのキャッシュ設定の変更

コンテンツ・プレゼンタはデフォルトでは、ローカル(インメモリー)キャッシュを使用するように構成されています。ただし、どのタイプの本番環境にもCoherenceを使用することを強くお薦めします。これは、高可用性(HA)環境の要件です。ここでは、Coherenceを使用してコンテンツのキャッシュを有効化し、テストする方法について説明します。

注意:
ご使用のCoherenceのライセンスは、購入したライセンス・オプションによっては複数ノードの環境をサポートしない可能性があります。ライセンス契約の内容を確認するには、ライセンス情報のOracle Coherenceに関する項を確認してください。

この項には次のサブセクションが含まれます:

- 第9.8.3.1項「Coherenceの構成ファイルの変更」

- 第9.8.3.2項「Coherence構成のテスト」

注意:
また、Portal Frameworkアプリケーションの場合は、Coherence構成ファイルをアプリケーション(EAR)のクラスパスまたはサーバーのシステム・クラスパスに追加する必要があります。Frameworkアプリケーション用にCoherenceを構成する手順については、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のキャッシュ・メカニズムとしてのCoherenceの構成に関する項を参照してください。

9.8.3.1 Coherenceの構成ファイルの変更

Coherence構成ファイルを変更するには:

1. ORACLE_HOME/webcenter/modules/oracle.webcenter.content.integration_11.1.1/content-app-lib.earファイルを開き、sample-content-coherence-cache-config.xmlファイルをORACLE_HOME/webcenter/modules/oracle.webcenter.content.integration_11.1.1/content-app-lib.earからコピーします。sample-content-coherence-cache-config.xmlファイルが/content-app-lib.ear/APP-INF/classes/sample-content-coherence-cache-config.xmlの下にあります。

2. sample-content-coherence-cache-config.xmlファイルをMW_HOME/user_projects/applications/<Domain_Name>/custom.webcenter.spaces.fwk/APP-INF/classes/にコピーして、content-coherence-cache-config.xmlに名前を変更します。

3. サンプル・ファイル(例9-1)およびエントリの説明(表9-11)に基づいて、Coherence構成ファイルをローカル環境にあわせて変更します。

4. Coherenceがキャッシュに使用されていることをテストする場合は、第9.8.3.2項「Coherence構成のテスト」に示すように、次をsetDomainEnv.shファイルに追加します。

JAVA_OPTIONS="${JAVA_OPTIONS} -Dtangosol.coherence.management=all"
export JAVA_OPTIONS

5. WC_Spacesサーバーを再起動します。

例9-1 Coherence構成ファイルのサンプル

<!DOCTYPE cache-config SYSTEM "cache-config.dtd">
<cache-config>
<caching-scheme-mapping>
<cache-mapping>
<cache-name>repo.ucm.nodeUidCache.*</cache-name>
<scheme-name>ContentNodeCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>repo.ucm.nodePathToUidCache.*</cache-name>
<scheme-name>ContentNodeCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>repo.ucm.securityInfoCache.*</cache-name>
<scheme-name>ContentNodeCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>repo.ucm.typeNameCache.*</cache-name>
<scheme-name>ContentTypeCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>repo.ucm.typeNamesCache.*</cache-name>
<scheme-name>ContentTypeCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>binaryCache.*</cache-name>
<scheme-name>ContentBinaryCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>repo.ucm.searchCriteriaCache.*</cache-name>
<scheme-name>ContentSearchCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name> repo.ucm.indexedFieldsCache.*</cache-name>
<scheme-name>ContentSearchCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>repo.ucm.securityUserCache.*</cache-name>
<scheme-name>ContentSecurityCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>repo.ucm.profileTriggerValueCache.*</cache-name>
<scheme-name>ContentProfileCaches</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>binaryContentTypeCache.*</cache-name>
<scheme-name>ContentBinaryCaches</scheme-name>
</cache-mapping>
</caching-scheme-mapping>
<caching-schemes>
<!--    The following schemes are all local.  For a clustered deployment,
a distributed, replcated, or other clustered scheme is recommended.
See Coherence documentation for more information.
-->
<local-scheme>
<scheme-name>ContentNodeCaches</scheme-name>
<expiry-delay>1m</expiry-delay>
<high-units>100</high-units>
</local-scheme>
<local-scheme>
<scheme-name>ContentTypeCaches</scheme-name>
<expiry-delay>30m</expiry-delay>
<high-units>50</high-units>
</local-scheme>
<local-scheme>
<scheme-name>ContentBinaryCaches</scheme-name>
<expiry-delay>1m</expiry-delay>
<high-units>100000</high-units>
<unit-calculator>
<class-scheme>
<class-name>com.tangosol.net.cache.SimpleMemoryCalculator</class-name>
</class-scheme>
</unit-calculator>
</local-scheme>
<local-scheme>
<scheme-name>ContentSearchCaches</scheme-name>
<expiry-delay>5m</expiry-delay>
<high-units>50</high-units>
</local-scheme>
<local-scheme>
<scheme-name>ContentSecurityCaches</scheme-name>
<expiry-delay>10m</expiry-delay>
<high-units>50</high-units>
</local-scheme>
<local-scheme>
<scheme-name>ContentProfileCaches</scheme-name>
<expiry-delay>1h</expiry-delay>
<high-units>100</high-units>
</local-scheme>
<!--
<class-scheme>
<scheme-name>ContentDisabledCaches</scheme-name>
<class-name>com.tangosol.util.NullImplementation$NullMap</class-name>
</class-scheme>
-->
</caching-schemes>
</cache-config>

表9-11 content-coherence-cache-config.xml内のキャッシュ・エントリ

キャッシュ・エントリ名

説明

repo.ucm.nodeUidCache.*

IDに基づいてリポジトリのノードのリストを格納します。このキャッシュ・エントリのサイズはアクティブなリポジトリ内のノードの数に依存します。このキャッシュは、ノード・データのリフレッシュ時期およびデータが他のアプリケーションから変更された回数に応じて有効期限が切れます。キー - ノードUID - 文字列

値 - コンテンツ・サーバー・ノード・オブジェクト

repo.ucm.nodePathToUidCache.*

パスに基づいてリポジトリのノードのリストを格納します。このキャッシュのサイズは、アクティブなリポジトリ内のノードの数に依存します。このキャッシュ・エントリは、ノード・データのリフレッシュ時期およびデータが他のアプリケーションから変更された回数に応じて有効期限が切れます。サイズおよび有効期限は、nodeUidCacheのものと同じである必要があります。

キー - ノード・パス - 文字列

値 - ノードUID - 文字列

repo.ucm.securityInfoCache.*

ノードのキャッシュ済セキュリティ情報を格納します。このキャッシュのサイズは、リポジトリ内のノードの数に依存します。このキャッシュは、ノード・セキュリティ・データの更新頻度に基づいて有効期限が切れます。

キー - ノードUID - 文字列

値 - ノードのセキュリティ情報

repo.ucm.typeNameCache.*

コンテンツ・タイプ情報をキャッシュします。このキャッシュのサイズは、リポジトリ内のタイプの数に依存します。このキャッシュは、タイプ情報のリフレッシュ時期およびタイプが他のアプリケーションから変更された回数に基づいて有効期限が切れます。

キー - コンテンツ・タイプUID - 文字列

値 - ContentTypeオブジェクト

repo.ucm.typeNamesCache.*

コンテンツ・サーバーが認識しているすべてのタイプ名をキャッシュします。すべてのタイプ名は同時に(単一キー)キャッシュされるため、同時に有効期限が切れます。

このキャッシュは、新しいタイプの作成または削除の頻度に基づいて有効期限が切れます。

キー - このキャッシュには1つのキーtypeNamesしかありません

値 - タイプ名のArrayList<String>

binaryCache.*

バイナリ・プロパティ・データをキャッシュします。リポジトリ構成プロパティbinaryCacheMaxEntrySizeより小さいバイナリのみキャッシュされます。

このキャッシュのサイズは、binaryCacheMaxEntrySize設定より小さいバイナリ・プロパティの使用回数と使用頻度に基づくか、またはバイナリ・キャッシュで使用されるメモリー容量の合計に基づきます。

このキャッシュは、バイナリ・データのリフレッシュ時期およびこのデータが他のアプリケーションから変更された回数に基づいて有効期限が切れます。

キー - ノードUIDおよびバイナリ・プロパティUID (nodeUid.propUid) - 文字列

値 - バイナリ・ストリーム・データ - byte[]

注意: Content Serverに格納されているほとんどのドキュメントは、イメージ、プレーン・テキスト、Word文書などのバイナリ・コンテンツです。唯一の例外はCDFデータ・ファイルに格納されるSite Studioコンテンツで、これは仮想コンテンツ・リポジトリ(VCR)キャッシュ(またはノード・キャッシュ)に個別にキャッシュされます。

repo.ucm.searchCriteriaCache.*

コンテンツ・サーバーの検索文法に基づいて、パラメータへの検索問合せセットをキャッシュします。このキャッシュのサイズは、繰り返し実行されることが予想される一意の検索の数に依存します。

最終的に未使用の検索の有効期限が切れて、キャッシュ・メモリーを抑えるように、有効期限を設定する必要があります。

キー - 検索問合せパラメータのセット。

値 - コンテンツ・サーバー用語での検索問合せパラメータのセット。

repo.ucm.indexedFieldsCache.*

リポジトリの索引付き(検索可能)システム・プロパティを保持します。このキャッシュには、次の3つのキーがあります。

- indexedFieldsは、コンテンツ・サーバーのすべての索引付きフィールドを保持します。

- indexedFolderPropsは、フォルダの索引付きシステム・プロパティを保持します。

- indexedDocPropsは、ドキュメントの索引付きシステム・プロパティを保持します。

このキャッシュは、索引付きフィールドの変更頻度に基づいて有効期限が切れます。

キー - 文字列

値 - Map<String,Boolean>は、各索引付きプロパティ名のキー、およびそのプロパティも順序付けが可能かを示すブール値を保持します。

repo.ucm.securityUserCache.*

ローカル・ユーザー名(現在のアプリケーション)とコンテンツ・サーバー内の同じユーザーの名前との間のマッピングをキャッシュします。このキャッシュのサイズは、同時ユーザーまたはよくアクセスするユーザー、あるいはその両方の数に依存します。

このキャッシュは、ユーザー・アイデンティティ・マッピングの更新頻度に基づいて有効期限が切れます。

キー - ローカル・ユーザーID - 文字列

値 - コンテンツ・サーバーのユーザーID - 文字列

repo.ucm.profileTriggerValueCache.*

ドキュメントが作成されたときに使用可能になるように、特定のプロファイルのプロファイル・トリガー値をキャッシュします。このキャッシュ内の最大エントリ数は、暗黙的にコンテンツ・サーバー・サーバー上のプロファイルの最大数に制限されます。キャッシュ・エントリは小さいサイズです。プライマリ・エントリで異なるのは有効期限です。これは、プロファイル・トリガー・フィールドの値がコンテンツ・サーバー内で変更される頻度に依存します。これらの値は、プロファイルがコンテンツ・サーバー・システム上で一旦構成されると変更されることはほとんどありません。そのため、有効期限を適切に設定する必要があります。

キー - コンテンツ・サーバー・プロファイル名 - 文字列

値 - コンテンツ・サーバーのプロファイル・トリガー値 - 文字列

9.8.3.2 Coherence構成のテスト

アプリケーションがデプロイされた管理対象サーバーを再起動した後、コマンドラインからjconsoleと入力し、WC_Spacesに対応するプロセスを選択してJConsoleを開き、サーバーに接続します。JConsoleの「MBean」タブでCoherenceを確認します。また、WC_Spaces-diagnostic.logファイルには次のような出力があります。

2013-06-26 14:45:47.321/1278.178 Oracle Coherence GE 3.6.0.4 &lt;Info&gt;
(thread=[ACTIVE] ExecuteThread: '1' for queue: 'weblogic.kernel.Default
(self-tuning)', member=n/a): Loaded cache configuration from
"zip:/oracle/app/admin/domains/webcenter/servers/WC_CustomPortal/tmp/_WL_
user/WebCenterPortalCoherence_application1_
V2.0/i092wg/APP-INF/lib/portal-coherence.jar!/content-coherence-cache-config.xml"

9.8.4 外部Content Serverの変更を確認するためのキャッシュの構成

ここでは、変更が取得されようにContent Serverのキャッシュ無効化間隔を変更する方法について説明します。

この項の内容は次のとおりです。

- 第9.8.4.1項「Content Serverのコントリビュータ・データ・ファイルの変更」

- 第9.8.4.2項「Content Serverのキャッシュ無効化間隔の変更」

9.8.4.1 Content Serverのコントリビュータ・データ・ファイルの変更

コンテンツ・プレゼンタ・タスク・フローにより、Page-Edit権限を持つWebCenter Portalユーザーはコンテンツの選択および表示をカスタマイズできます。コンテンツ・プレゼンタでは、コンテンツの単一アイテム、フォルダの下にあるコンテンツ、アイテムのリスト、またはコンテンツの問合せを選択した後、WebCenter Portalのページでそのコンテンツをレンダリングするコンテンツ・プレゼンタ・テンプレートを選択できます。

コンテンツ・プレゼンタではContent Serverのフォルダとファイルが表示されるほか、Oracle Site Studioとの統合により、Site Studioのコントリビュータ・データ・ファイル(Content Serverドキュメント)をSite Studioリージョン・テンプレートまたはカスタム・コンテンツ・プレゼンタ表示テンプレートで作成、アクセス、編集および表示できます。コンテンツ・プレゼンタ表示テンプレートの作成の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のコンテンツ・プレゼンタ表示テンプレートの作成に関する項を参照してください。

Content Serverのコントリビュータ・データ・ファイルをContent Serverを介して直接変更したいことがあります。この操作は完全にサポートされています。ただし、コントリビュータ・データ・ファイルがバックドアで変更される場合、同じデータ・ファイルを使用する実行中のWebCenter Portalページに、それらは即時には表示されません。これは、WebCenter Portalページではコンテンツ・プレゼンタを使用してデータ・ファイルのコンテンツを表示するが、WebCenter Portalはキャッシュされたバージョンのデータ・ファイルを使用しているためです。幸い、このようなバックドアでの変更が即時に自動的に取得されるように、キャッシュを構成する方法があります。

9.8.4.2 Content Serverのキャッシュ無効化間隔の変更

Content Serverのキャッシュ無効化間隔を変更することで、キャッシュ・スイーパ・ユーティリティでのキャッシュの監視を有効化できます。キャッシュ・スイーパはContent Serverの変更を問い合せて、変更があった場合、キャッシュに「ダーティ」というフラグを付けます。これにより、アプリケーションはContent Serverからドキュメントの新規コピーを取得し、キャッシュされたバージョンをこれと置き換えます。

デフォルトでは、キャッシュ無効化間隔の初期値は0 (分)に設定されています。すなわち、スイーパはオフになっています。スイーパをオンにするには、値を(分単位で)設定する必要があります。設定できる最小値は2 (分)です。これは次に説明されているように、Fusion Middleware Controlの「キャッシュ詳細」ページで、またはWLSTコマンドを使用して行うことができます。

- 第9.8.4.2.1項「Fusion Middleware Controlを使用したキャッシュ無効化間隔の変更」

- 第9.8.4.2.2項「WLSTコマンドを使用したキャッシュ無効化間隔の変更」

9.8.4.2.1 Fusion Middleware Controlを使用したキャッシュ無効化間隔の変更

Fusion Middleware Controlを使用してキャッシュ無効化間隔を変更するには:

1. Fusion Middleware Controlで、編集のためにコンテンツ・リポジトリ接続ページを開きます。

図9-6 「コンテンツ・リポジトリ接続の編集」ページ

2. 「キャッシュ詳細」セクションで、キャッシュ無効化間隔を2 (最小許容時間)または同様の低い値に設定します。

注意:
一部のインスタンスでは、Fusion Middleware Controlでキャッシュ無効化間隔の値を一度設定(および保存)すると、値は固定化され、WLSTコマンドを使用して間隔の値を0に設定しなおすことしかできません。

9.8.4.2.2 WLSTコマンドを使用したキャッシュ無効化間隔の変更

次のWLSTコマンドを使用して、キャッシュ無効化間隔の値を更新することもできます。

setJCRContentServerConnection(appName, name, [socketType, url, serverHost, serverPort, keystoreLocation, keystorePassword, privateKeyAlias, privateKeyPassword, webContextRoot, clientSecurityPolicy, cacheInvalidationInterval, binaryCacheMaxEntrySize, adminUsername, adminPassword, extAppId, timeout, isPrimary, server, applicationVersion])

コマンドを実行するための必須パラメータ値を取得するために、listJCRContentServerConnections('webcenter',verbose=true)コマンドを使用できます。次に、コマンドの出力例を示します。

UCM
——————
Connection Name: UCM
Connection Type: JCR
External Appliction ID:
Timeout: (not set)
CIS Socket Type: socket
CIS Server Hostname: webcenter.oracle.local
CIS Server Port: 4444
CIS Keystore Location:
CIS Private Key Alias:
CIS Web URL:
Web Server Context Root: /cs
Client Security Policy:
Admin User Name: sysadmin
Cache Invalidation Interval: 2
Binary Cache Maximum Entry Size: 1024
The Documents primary connection is "UCM"

上述の例に基づく、対応するsetJCRContentServerConnectionコマンドは次のとおりです。

setJCRContentServerConnection(appName='webcenter',name='UCM', socketType='socket', serverHost='webcenter.oracle.local', serverPort='4444?, webContextRoot='/cs', cacheInvalidationInterval='0?, binaryCacheMaxEntrySize='1024?,adminUsername='sysadmin',isPrimary=1)

注意:
変更内容を反映させるには、WebCenter Portal管理対象サーバー(WC_Spaces)を再起動する必要があります。

9.8.4.3 キャッシュ設定のテスト

スイーパをONにすると、変更されたキャッシュ・オブジェクトのみが無効化されます。これをテストするには、イベントを監視および報告するようにContent Serverを構成します。

イベントを監視および報告するようにContent Serverを構成するには:

1. Content Serverコンソール・アプリケーションにログインし、「管理」メニュー項目でシステム監査情報を選択します。コンソールで左のメニュー表示オプションが使用されている場合、そこに「管理」リンクがあります。

図9-7 Content Serverコンソール - システム監査情報ページ

2. セクション情報のトレースで、アクティブ・セクションに「system」と「requestaudit」のみを追加します。完全冗長トレースと「保存」を選択し、「更新」ボタンをクリックします。その後、「サーバー出力を表示」メニュー・オプションを選択します。ブラウザ・ビューが変更され、ログが表示されます。これで、Content Serverの構成に必要な作業はすべて終了しました。

図9-8 システム監査情報ページ - サーバー出力を表示

たとえば、キャッシュ無効化間隔が2 (分)に設定されたサーバー出力を表示を次に示します。タイムスタンプに注意してください。

requestaudit/6 08.30 09:52:26.001  IdcServer-68    GET_FOLDER_HISTORY_REPORT [dUser=sysadmin][IsJava=1] 0.016933999955654144(secs)
requestaudit/6 08.30 09:52:26.010  IdcServer-69    GET_FOLDER_HISTORY_REPORT [dUser=sysadmin][IsJava=1] 0.006134999915957451(secs)
requestaudit/6 08.30 09:52:26.014  IdcServer-70    GET_DOCUMENT_HISTORY_REPORT [dUser=sysadmin][IsJava=1] 0.004271999932825565(secs)

… 他のトレース情報は次のとおりです …

requestaudit/6 08.30 09:54:26.002  IdcServer-71    GET_FOLDER_HISTORY_REPORT [dUser=sysadmin][IsJava=1] 0.020323999226093292(secs)
requestaudit/6 08.30 09:54:26.011  IdcServer-72    GET_FOLDER_HISTORY_REPORT [dUser=sysadmin][IsJava=1] 0.017928000539541245(secs)
requestaudit/6 08.30 09:54:26.017  IdcServer-73    GET_DOCUMENT_HISTORY_REPORT [dUser=sysadmin][IsJava=1] 0.010185999795794487(secs)

3. トレース・ログが適切にレポートされたら、次のステップではスイーパをテストするようにWebCenter Portalを設定します。これを行うには、コンテンツ・プレゼンタ・タスク・フローで最大2つのページを設定します。各タスク・フローでは、別個のカスタム・コンテンツ・プレゼンタ表示テンプレートを使用して、各ページに別個のコントリビュータ・データ・ファイル(キャッシュ内のドキュメント)を割り当てます。
コンテンツを含むWebCenter Portalページが初めてブラウザにロードされると、Content Server出力ビューアにトレース情報が表示されます。例:

requestaudit/6 08.30 11:51:12.030 IdcServer-129 CLEAR_SERVER_OUTPUT [dUser=weblogic] 0.029171999543905258(secs)
requestaudit/6 08.30 11:51:12.101 IdcServer-130 GET_SERVER_OUTPUT [dUser=weblogic] 0.025721000507473946(secs)
requestaudit/6 08.30 11:51:26.592 IdcServer-131 VCR_GET_DOCUMENT_BY_NAME [dID=919][dDocName=DF_UCMCACHETESTER][dDocTitle=DF_UCMCacheTester][dUser=weblogic][RevisionSelectionMethod=LatestReleased][IsJava=1] 0.21525299549102783(secs)
requestaudit/6 08.30 11:51:27.117 IdcServer-132 VCR_GET_CONTENT_TYPES [dUser=sysadmin][IsJava=1] 0.5059549808502197(secs)
requestaudit/6 08.30 11:51:27.146 IdcServer-133 VCR_GET_CONTENT_TYPE [dUser=sysadmin][IsJava=1] 0.03360399976372719(secs)
requestaudit/6 08.30 11:51:27.169 IdcServer-134 VCR_GET_CONTENT_TYPE [dUser=sysadmin][IsJava=1] 0.008806000463664532(secs)
requestaudit/6 08.30 11:51:27.204 IdcServer-135 VCR_GET_CONTENT_TYPE [dUser=sysadmin][IsJava=1] 0.013265999965369701(secs)
requestaudit/6 08.30 11:51:27.384 IdcServer-136 VCR_GET_CONTENT_TYPE [dUser=sysadmin][IsJava=1] 0.18119299411773682(secs)
requestaudit/6 08.30 11:51:27.533 IdcServer-137 VCR_GET_CONTENT_TYPE [dUser=sysadmin][IsJava=1] 0.1519480049610138(secs)
requestaudit/6 08.30 11:51:27.634 IdcServer-138 VCR_GET_CONTENT_TYPE [dUser=sysadmin][IsJava=1] 0.10827399790287018(secs)
requestaudit/6 08.30 11:51:27.687 IdcServer-139 VCR_GET_CONTENT_TYPE [dUser=sysadmin][IsJava=1] 0.059702999889850616(secs)
requestaudit/6 08.30 11:51:28.271 IdcServer-140 GET_USER_PERMISSIONS [dUser=weblogic][IsJava=1] 0.006703000050038099(secs)
requestaudit/6 08.30 11:51:28.285 IdcServer-141 GET_ENVIRONMENT [dUser=sysadmin][IsJava=1] 0.010893999598920345(secs)
requestaudit/6 08.30 11:51:30.433 IdcServer-142 GET_SERVER_OUTPUT [dUser=weblogic] 0.017318999394774437(secs)
requestaudit/6 08.30 11:51:41.837 IdcServer-143 VCR_GET_DOCUMENT_BY_NAME [dID=508][dDocName=113_ES][dDocTitle=Landing Home][dUser=weblogic][RevisionSelectionMethod=LatestReleased][IsJava=1] 0.15937699377536774(secs)
requestaudit/6 08.30 11:51:42.781 IdcServer-144 GET_FILE [dID=326][dDocName=WEBCENTERORACL000315][dDocTitle=Duke][dUser=anonymous][RevisionSelectionMethod=LatestReleased][dSecurityGroup=Public][xCollectionID=0] 0.16288499534130096(secs)

強調表示されたセクションは、2つのサンプル・データ・ファイルのDF_UCMCACHETESTERと113_ESがContent ServerへのWebCenter Portal VCR接続によって呼び出されたことを示しています。VCR_GET_DOCUMENT_BY_NAME呼出しに注目してください。

これら2つのページの以降のリフレッシュでは、(Content Serverの「サーバー出力を表示」をリフレッシュした後)同じVCR_GET_DOCUMENT_BY_NAME呼出しのトレースはないことがわかります。これは、ページはキャッシュからドキュメントを取得しているためです。

4. 次の手順では、Content Serverコンソールを使用して、バックドアでいずれかのドキュメントを変更します。これを行うには、データ・ファイル・ドキュメントを見つけて、コンテンツ情報ページでデータ・ファイルの編集を選択します。

図9-9 Content Serverコンソール - コンテンツ情報ページ

Site Studioコントリビュータが起動され、いくつかの変更を行うことができます。

図9-10 Site Studioコントリビュータ

Content Serverの「サーバー出力を表示」をリフレッシュすると、トレースでドキュメントに対して実行された操作が表示されます。

requestaudit/6 08.30 11:56:59.972 IdcServer-255 SS_CHECKOUT_BY_NAME [dID=922][dDocName=DF_UCMCACHETESTER][dUser=weblogic][dSecurityGroup=Public] 0.05558200180530548(secs)
requestaudit/6 08.30 11:57:00.065 IdcServer-256 SS_GET_CONTRIBUTOR_CONFIG [dID=922][dDocName=DF_UCMCACHETESTER][dDocTitle=DF_UCMCacheTester][dUser=weblogic][dSecurityGroup=Public][xCollectionID=0] 0.08632399886846542(secs)
requestaudit/6 08.30 11:57:00.470 IdcServer-259 DOC_INFO_BY_NAME [dID=922][dDocName=DF_UCMCACHETESTER][dDocTitle=DF_UCMCacheTester][dUser=weblogic][dSecurityGroup=Public][xCollectionID=0] 0.02268899977207184(secs)
requestaudit/6 08.30 11:57:10.177 IdcServer-264 GET_FOLDER_HISTORY_REPORT [dUser=sysadmin][IsJava=1] 0.007652000058442354(secs)
requestaudit/6 08.30 11:57:10.181 IdcServer-263 GET_FOLDER_HISTORY_REPORT [dUser=sysadmin][IsJava=1] 0.01868399977684021(secs)
requestaudit/6 08.30 11:57:10.187 IdcServer-265 GET_DOCUMENT_HISTORY_REPORT [dUser=sysadmin][IsJava=1] 0.009367000311613083(secs)
(internal)/6 08.30 11:57:26.118 IdcServer-266 File to be removed: /oracle/app/admin/domains/webcenter/ucm/cs/vault/~temp/703253295.xml
(internal)/6 08.30 11:57:26.121 IdcServer-266 File to be removed: /oracle/app/admin/domains/webcenter/ucm/cs/vault/~temp/703253295.xml
requestaudit/6 08.30 11:57:26.122 IdcServer-266 SS_SET_ELEMENT_DATA [dID=923][dDocName=DF_UCMCACHETESTER][dDocTitle=DF_UCMCacheTester][dUser=weblogic][dSecurityGroup=Public][xCollectionID=0][StatusCode=0][StatusMessage=Successfully checked in content item 'DF_UCMCACHETESTER'.] 0.3765290081501007(secs)
requestaudit/6 08.30 11:57:30.710 IdcServer-267 DOC_INFO_BY_NAME [dID=923][dDocName=DF_UCMCACHETESTER][dDocTitle=DF_UCMCacheTester][dUser=weblogic][dSecurityGroup=Public][xCollectionID=0] 0.07942699640989304(secs)
requestaudit/6 08.30 11:57:30.733 IdcServer-268 SS_GET_CONTRIBUTOR_STRINGS [dUser=weblogic] 0.0044570001773536205(secs)

最初のページがリフレッシュされると、更新が適用されたことがわかります。キャッシュ無効化間隔(2分に設定された)はいつ変更が発生したかによって決定されるわけではないため、リフレッシュ時間は変化することがあります。スイーパは2分ごとに実行されます。

Content Serverの「サーバー出力を表示」をリフレッシュすると、この例の場合、トレースで次の情報が表示されます。

requestaudit/6 08.30 11:59:10.171 IdcServer-270 GET_FOLDER_HISTORY_REPORT [dUser=sysadmin][IsJava=1] 0.00952600035816431(secs)
requestaudit/6 08.30 11:59:10.179 IdcServer-271 GET_FOLDER_HISTORY_REPORT [dUser=sysadmin][IsJava=1] 0.011118999682366848(secs)
requestaudit/6 08.30 11:59:10.182 IdcServer-272 GET_DOCUMENT_HISTORY_REPORT [dUser=sysadmin][IsJava=1] 0.007447000127285719(secs)
requestaudit/6 08.30 11:59:16.885 IdcServer-273 VCR_GET_DOCUMENT_BY_NAME [dID=923][dDocName=DF_UCMCACHETESTER][dDocTitle=DF_UCMCacheTester][dUser=weblogic][RevisionSelectionMethod=LatestReleased][IsJava=1] 0.0786449983716011(secs)

指定したキャッシュ無効化間隔時間の後、スイーパが起動されます(GET_コールによって追跡された)。変更内容はメモに記録されているため、次のコールは、変更された新規バージョンのデータ・ファイルを取得するためにVCR_GET_DOCUMENT_BY_NAMEに対して行われます。

2番目のページに戻り、サーバー出力を表示すると、データ・ファイルを取得するVCR_GET_DOCUMENT_BY_NAMEはもう存在しません。これは、単にデータ・ファイルがキャッシュから取得されたばかりであることを示します。サンプルのサーバー出力を見ると、VCR_GET_DOCUMENT_BY_NAMEに対するリクエストは1つだけであることがわかります。

requestaudit/6 08.30 12:08:00.021 Audit Request Monitor Request Audit Report over the last 120 Seconds for server webcenteroraclelocal16200****
requestaudit/6 08.30 12:08:00.021 Audit Request Monitor -Num Requests 8 Errors 0 Reqs/sec. 0.06666944175958633 Avg. Latency (secs) 0.02762500010430813 Max Thread Count 2
requestaudit/6 08.30 12:08:00.021 Audit Request Monitor 1 Service VCR_GET_DOCUMENT_BY_NAME Total Elapsed Time (secs) 0.09200000017881393 Num requests 1 Num errors 0 Avg. Latency (secs) 0.09200000017881393
requestaudit/6 08.30 12:08:00.021 Audit Request Monitor 2 Service GET_PERSONALIZED_JAVASCRIPT Total Elapsed Time (secs) 0.054999999701976776 Num requests 1 Num errors 0 Avg. Latency (secs) 0.054999999701976776
requestaudit/6 08.30 12:08:00.021 Audit Request Monitor 3 Service GET_FOLDER_HISTORY_REPORT Total Elapsed Time (secs) 0.028999999165534973 Num requests 2 Num errors 0 Avg. Latency (secs) 0.014499999582767487
requestaudit/6 08.30 12:08:00.021 Audit Request Monitor 4 Service GET_SERVER_OUTPUT Total Elapsed Time (secs) 0.017999999225139618 Num requests 1 Num errors 0 Avg. Latency (secs) 0.017999999225139618
requestaudit/6 08.30 12:08:00.021 Audit Request Monitor 5 Service GET_FILE Total Elapsed Time (secs) 0.013000000268220901 Num requests 1 Num errors 0 Avg. Latency (secs) 0.013000000268220901
requestaudit/6 08.30 12:08:00.021 Audit Request Monitor ****End Audit Report*****

9.9 コンテンツ・リポジトリ接続の削除

この項には次のサブセクションが含まれます:

- 第9.9.1項「Fusion Middleware Controlを使用したコンテンツ・リポジトリ接続の削除」

- 第9.9.2項「WLSTを使用したコンテンツ・リポジトリ接続の削除」

注意:
コンテンツ・リポジトリ接続の削除は、その接続を使用していない場合にのみ行ってください。接続がアクティブとしてマークされている場合は、アクティブ・リストからその接続を除外してから削除します。

9.9.1 Fusion Middleware Controlを使用したコンテンツ・リポジトリ接続の削除

コンテンツ・リポジトリ接続を削除するには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはWebCenter Portal Frameworkアプリケーションのホームページに移動します。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 接続名を選択し、「削除」をクリックします。

5. この変更を有効にするには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

9.9.2 WLSTを使用したコンテンツ・リポジトリ接続の削除

WLSTコマンドのdeleteConnectionを使用して、コンテンツ・リポジトリ接続を削除します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
この変更を有効にするには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

9.10 WebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定

ポータル・ドキュメント(ホーム・ポータル・ドキュメントを含む)を格納するためにWebCenter Portalで使用されているバックエンドContent Serverリポジトリの接続プロパティを表示、変更および削除できます。具体的には、ポータル・コンテンツの格納先のルート・フォルダ、コンテンツ・リポジトリ管理者の名前、およびContent Server上でアプリケーション・データを分離するための一意のアプリケーション識別子を定義できます。

この項には次のサブセクションが含まれます:

- 第9.10.1項「Fusion Middleware Controlを使用したWebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定」

- 第9.10.2項「WLSTを使用したWebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定」

9.10.1 Fusion Middleware Controlを使用したWebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定

WebCenter Portal用のコンテンツ・リポジトリの接続プロパティを設定するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. (WebCenter Portalのアクティブな接続に対してのみ。)WebCenter Portalリポジトリの接続プロパティを設定します。詳細は、第9.6.1項「WebCenter Portal用のコンテンツ・リポジトリの登録について」を参照してください。

6. 「OK」をクリックして、変更を保存します。

7. 更新した(アクティブな)接続プロパティの使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります(デフォルトはWC_Spaces)。

9.10.2 WLSTを使用したWebCenter Portalのデフォルトのコンテンツ・リポジトリに対する接続プロパティの設定

次のコマンドは、ポータル・ドキュメントを格納するためにWebCenter Portalで使用されているContent Serverリポジトリのプロパティを、WebCenter Portalアプリケーションで表示、設定および削除する目的でのみ有効です。

- listDocumentsSpacesProperties

- setDocumentsSpacesProperties

- deleteDocumentsSpacesProperties

コマンドの構文と詳細な例については、『WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

9.11 コンテンツ・リポジトリ接続のテスト

コンテンツ・リポジトリ接続の設定が完了したら、次の各項の説明に従って接続のテストを行い、コンテンツ・リポジトリにアクセスできることを確認できます。

- 第9.11.1項「Content Server接続のテスト」

- 第9.11.2項「Oracle Portal接続のテスト」

9.11.1 Content Server接続のテスト

ソケット・タイプがwebの接続を検証するには、Content ServerのWebインタフェースにadministratorとしてログインします。ソケット・タイプ接続のURLは、Fusion Middleware Controlから次の手順で取得できます。

1. Fusion Middleware Controlで、「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します(図9-11)。

図9-11 Fusion Middleware Controlの「WebCenterポータル」メニュー

2. 「コンテンツ・リポジトリ接続の管理」ページで、接続を選択して「編集」をクリックします(図9-12)。

図9-12 「コンテンツ・リポジトリ接続の管理」ページ

3. 「コンテンツ・リポジトリ接続の編集」ページでWeb URLをコピーします(図9-13)。

注意:
使用前に、URLから/idcplg/接尾辞を削除してください。

URLの形式: http://host_name/web_root/

例: http://mycontentserver/cms/

図9-13 「コンテンツ・リポジトリ接続の編集」ページ

9.11.2 Oracle Portal接続のテスト

Oracle Portal接続の完全な状態を検証する手順は次のとおりです。

1. Oracle WebLogic管理コンソールの「ドメイン構造」で、「サービス」→「JDBC」を開いて、「データ・ソース」をダブルクリックします(図9-14)。

図9-14 Oracle WebLogic管理コンソール

2. 「JDBCデータ・ソースのサマリー」ページで、テストするデータ・ソースを選択します(図9-15)。

図9-15 「JDBCデータ・ソースのサマリー」ページ

3. 「datasource_nameの設定」セクションで、タブ「モニタリング」→「テスト」を選択します。データ・ソースのターゲット・サーバーを選択してから、「データ・ソースのテスト」をクリックし、接続をテストします(図9-16)。

図9-16 データ・ソース設定セクション

9.12 最大ファイル・アップロード・サイズの変更

デフォルトでは、ファイルの最大アップロード・サイズは次のとおりです。

- Portal Frameworkアプリケーションでは2MB。このデフォルトは、ブラウザからアプリケーション・サーバーへのファイルのアップロードを処理するApache MyFaces Trinidadによって設定されます。
Portal Frameworkアプリケーション開発者は、web.xmlファイルでorg.apache.myfaces.trinidad.UPLOAD_MAX_DISK_SPACEパラメータを設定することによって、最大ファイル・アップロード・サイズを設計時にカスタマイズできます。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のコンテンツ・リポジトリにファイルをアップロードするためのパラメータの設定に関する項を参照してください。第A.1.2項「web.xml」も参照してください。

- WebCenter Portalでは2GB。
システム管理者は、webcenter-config.xmlファイルでuploadedFileMaxDiskSpaceパラメータを編集することによって、最大ファイル・アップロード・サイズをカスタマイズできます。詳細は、第A.1.3項「webcenter-config.xml」を参照してください。

9.13 コンテンツ・リポジトリに関する問題のトラブルシューティング

この項には次のサブセクションが含まれます:

- 第9.13.1項「WebCenter Portalで使用できないドキュメント・サービス」

9.13.1 WebCenter Portalで使用できないドキュメント・サービス

WebCenter Portalでドキュメント・ツールが使用できない場合、つまり、ホーム・ポータルまたはその他のポータルで「ドキュメント」タブが使用できない場合は、バックエンドContent Serverへの接続に問題があるか、必要なWebCenter Portalデータの一部がContent Serverに含まれていません。

問題を診断するには、次の手順を実行します。

1. Content Serverが起動して実行中であることを確認します。サーバーの「サーバー・ポート」(intradoc)が構成され、「サーバーIPフィルタ」でWebCenter Portalの接続を許可していることを確認します。

1. Content Serverにログインします。

2. 「管理」をクリックします。

3. 「<インスタンス名>の構成」をクリックします。

4. 「システム構成」で「サーバーの構成」リンクをクリックします。

5. 「サーバー・ポート」がリストにあり、「サーバーIPフィルタ」でWebCenter Portalの接続を許可していることを確認します。

2. WebCenter Portalと、バックエンド・ドキュメント・ストアとして使用されているWebCenter Content Server間の接続を確認します。

1. Fusion Middleware Controlにログインし、「コンテンツ・リポジトリ接続設定」に移動します。詳細は、第9.6.2項「Fusion Middleware Controlを使用したコンテンツ・リポジトリの登録」を参照してください。

2. 必要な接続を選択して編集します。

3. 「アクティブな接続」チェック・ボックスを選択していることを確認します。

4. 「コンテンツ管理者」、「ルート・フォルダ」、「アプリケーション名」が正しく指定されていることを確認します。

- コンテンツ管理者: コンテンツ管理者はContent Server上で管理者権限が必要です。ポータル・コンテンツ、セキュリティ・グループおよびロール用のフォルダの作成と保守、およびコンテンツへのアクセス権の管理には、このユーザーが使用されます。

- 「ルート・フォルダ」および「アプリケーション名」: いずれも一意で、同じContent Serverを使用する他のWebCenter Portalインスタンスで使用されないようにする必要があります。これらの値を変更する場合は、片方のみではなく、両方の値が変更されていることを確認してください。

- アプリケーション名: 項目名の長さに制限があるワークフローなどのContent Serverで作成される項目の接頭辞として使用されるため、14文字以下にする必要があります。

5. 変更する場合は、「OK」をクリックして接続を保存します。

6. 「テスト」をクリックして、接続が機能するかどうかを検証します。

7. 変更する場合は、WebCenter Portalがデプロイされている管理対象サーバーのWC_Spacesを再起動する必要があります。

8. WebCenter Portalにログインし、接続の更新後にドキュメント・ツールが使用可能かどうかを確認します。

3. ドキュメント・サービスが使用できない場合は、WebCenter Portal起動に関するログ・メッセージで、Content Serverへの接続エラーまたはContent Serverでのデータ保存エラーがないかどうかを確認します。
詳細は、第28.2.1項「WebCenter Portalログの表示および構成」を参照してください。

4. ログに有用なログ情報がない場合は、Content Serverのロギング・レベルを上げ、WebCenter Portalを再起動して、メッセージを詳細に調べます。

1. Fusion Middleware Controlを使用(またはlogging.xmlファイルを編集)して、oracle.webcenter.doclib.internal.modelおよびoracle.webcenter.doclib.internal.spacesのロギングを上げます。
第28.2.1項「WebCenter Portalログの表示および構成」も参照してください。

2. WebCenter Portalを再起動します。

3. 再度ログを確認します。
WebCenter PortalデータがContent Serverに存在する場合は、次のメッセージがTRACEレベルで出力されます。

Content Server already contains the Space container, therefore no need to seed any data

WebCenter Portalデータがシードされていない場合は、次のメッセージがTRACEレベルで出力されます。

Creating WebCenter Seeded Data

10 アクティビティ・グラフの管理

この章では、WebCenter PortalおよびPortal Frameworkアプリケーションのアクティビティ・グラフを構成および管理する方法について説明します。

注意:
アクティビティ・グラフを確認および構成する際には、アクティビティ・グラフ管理、Fusion Middleware ControlまたはWLSTコマンド行ツールを必ず使用してください。失敗した構成をもたらす可能性があるため、ファイルを手動で編集することはお薦めしません(特にそれを実行する具体的な指示を受けていないかぎり)。

この章には次のトピックが含まれます:

- 第10.1項「アクティビティ・グラフについて」

- 第10.2項「アクティビティ・グラフの構成ロードマップ」

- 第10.3項「アクティビティ・グラフの前提条件」

- 第10.4項「アクティビティ・グラフのデータの準備」

- 第10.5項「類似度計算の理由文字列のカスタマイズ」

- 第10.6項「アクティビティ・グラフ・スキーマのカスタマイズの管理」

- 第10.7項「Oracle Secure Enterprise Searchのアクティビティ・ランクの設定」

- 第10.8項「推奨に関する問題のトラブルシューティング」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

10.1 アクティビティ・グラフについて

アクティビティ・グラフでは、既存のコネクションやアプリケーション内のオブジェクトへの共通のやり取りに基づいて、ユーザーが関心を寄せている可能性のある人を提案します。また、ユーザーが現在表示しているポータルやアイテムでの類似する操作または最もアクティブなアイテムに基づいて、ユーザーが興味を持つ可能性があるポータルやコンテンツも示されます。

アクティビティ・グラフが表示するこれらの提案は、アクティビティ・グラフ・エンジンによって収集および分析されたデータに基づいています。アクティビティ・グラフ・エンジンは、エンタープライズ・アプリケーションによって収集されたアクションのセントラル・リポジトリとして機能します。数学的なグラフの観点から考えた場合、アプリケーション・ユーザー、およびユーザーが対話を行うエンタープライズ・コンテンツはそれぞれがノードであり、ユーザー間およびユーザーとコンテンツ間で実行されるアクションは有向エッジです(図10-1)。

図10-1 アクティビティ・グラフ

アクティビティ・グラフでは、次の3つの主要コンポーネントが使用されます。

- Oracle Analytics Event Collector: OpenUsage APIを使用してイベント・データを収集し、アクティビティ・データベースに保存します。

- アクティビティ・グラフ・エンジン: データの収集、類似度スコアの計算および検索ランキングの計算を実行する各エンジンが含まれています。

- アクティビティ・グラフ問合せAPI: アクションの生データと処理済の推奨データを公開するとともに、アクセス権がないために結果を表示したり最新のメタデータによって結果を装飾することができない人々からの結果をフィルタ処理するためのメカニズム(QRPP)を公開します。

図10-2は、これらの異なるコンポーネントがどのように連動するかを示しています。このプロセスについて次に説明します。

図10-2 アクティビティ・グラフのアーキテクチャ

たとえば、Montyが自分のドキュメントを表示している、などのアクションがWebCenter Portalで発生すると、分析イベント・コレクタによってそのアクションがピックアップされ、アクティビティ・データベース内のイベント表に記録されます。

アクティビティ・データ収集プロセスが開始されると、分析アクティビティ・プロバイダが分析イベント表からアクションを読み取り、登録されているマッピング・セットを使用してアクティビティを生成します。アクティビティはアクションの1回の発生を表します。アクティビティを使用して、アクションの複数の発生が集計されたリレーションが決定され、リレーション表に格納されます。たとえば、Montyが特定のドキュメントを5回表示したという事実は、1つのリレーションを表します。リレーション表内の情報は、推奨と検索ランクの決定に使用されます。

アクティビティ・グラフ問合せAPIは、アクティビティ・グラフのタスク・フローで使用され、レシピを使用して推奨用の問合せをリレーション表に対して実行するJava APIです。レシピはランクまたは類似度計算の重み付けリストです。類似度計算では、特定の基準に基づく2つのオブジェクトの類似度を示す類似度スコア(0から1の範囲の数値)が生成されます。それぞれの計算の重み付けによって、推奨の総合スコアに与える影響が変化します。推奨は、推奨スコアの合計によって順序付けされます。WebCenter Portalはデフォルトの計算群を備えており、これらの計算がアクティビティ・グラフのタスク・フローで使用されます。これらの計算を編集したり、カスタムの計算を作成することができます。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のカスタムの類似度計算の定義に関する項を参照してください。

特定のオブジェクトに関する推奨の初期リストが生成された後は、より適切で有用な結果をユーザーに示すために結果をフィルタ処理できます。これには、問合せ結果ポスト・プロセッサ(QRPP)が使用されます。QRPPは推奨結果の現在のリストを取り込み、変更済リストを出力として返します。QRPPでは、現在のユーザーが表示を許可されていないオブジェクトに関する推奨の削除など、推奨のフィルタ処理を実行したり、結果メタデータの追加や変更を行ったりすることができます。

その後、アクティビティ・グラフのタスク・フローを通じて、ユーザーに推奨が示されます。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の設計時におけるアクティビティ・グラフの追加に関する項を参照してください。

10.2 アクティビティ・グラフの構成ロードマップ

この項では、ロードマップを構成プロセスにおける管理者のガイドとして使用します。

- ロードマップ: WebCenter Portal用のアクティビティ・グラフの構成
この項のフロー・チャート(図10-3)と表(表10-1)は、WebCenter Portalでアクティビティ・グラフを動作させるための前提条件と必要なタスクの概要を示しています。

図10-3 WebCenter Portal用のアクティビティ・グラフの構成

表10-1 WebCenter Portal用のアクティビティ・グラフの構成

担当者

タスク

サブタスク

管理者

1. WebCenter Portalと、分析およびアクティビティ・グラフのバックエンド・コンポーネントをインストールします

2. 次のツールのいずれかを使用して、WebCenter Portalと分析コレクタ間の接続を構成します

- Fusion Middleware Control

- WLST

3. (オプション)アクティビティ・グラフ・エンジンのスケジュールを設定する

エンド・ユーザー/

管理者

4. アクティビティ・グラフ・データがアプリケーションで使用可能なことをテストします

4.a WebCenter Portalにログインし、コンテンツの追加などによりこれと対話します(エンド・ユーザー)

4.b アクティビティ・グラフ・エンジンを実行する(管理者)

4.c アクティビティ・グラフのタスク・フロー(プロファイル・ページでの推奨接続タスク・フローなど)で推奨を表示します(エンド・ユーザー)

- ロードマップ: Portal Frameworkアプリケーション用のアクティビティ・グラフの構成
この項のフロー・チャート(図10-4)と表(表10-2)は、Portal Frameworkアプリケーションでアクティビティ・グラフを動作させるための前提条件と必要なタスクの概要を示しています。

図10-4 Portal Frameworkアプリケーション用のアクティビティ・グラフの構成

表10-2 Portal Frameworkアプリケーション用のアクティビティ・グラフの構成

担当者

タスク

サブタスク

管理者

1. WebCenter Portalと、分析およびアクティビティ・グラフのバックエンド・コンポーネントをインストールします

開発者

2. アクティビティ・グラフをアプリケーションに統合します

2.a JDeveloperで、WebCenter Portalスキーマへの接続を構成します

2.b JDeveloperで、アクティビティ・データベースへの接続を構成します

2.c JDeveloperで、分析コレクタへの接続を構成します

2.d JDeveloperでページにアクティビティ・グラフ・タスク・フローを追加する

管理者

3. (オプション)アクティビティ・グラフ・エンジンのスケジュールを設定する

開発者/

管理者

4. 次のツールのいずれかを使用してアプリケーションをデプロイします

- JDeveloper (開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

- WebLogic管理コンソール(管理者)

開発者/

管理者

5. (オプション)次のいずれかのツールを使用して接続パラメータを追加または変更します。

- JDeveloper。その後アプリケーションを再デプロイします(開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

エンド・ユーザー/

管理者

6. アクティビティ・グラフ・データがアプリケーションで使用可能なことをテストします

6.a アプリケーションにログインし、コンテンツの追加などによりこれと対話します(エンド・ユーザー)

6.b アクティビティ・グラフ・エンジンを実行する(管理者)

6.c アクティビティ・グラフ・タスク・フローで、推奨(たとえば、「プロファイル」ページの推奨コネクション・タスク・フロー)を表示する(エンド・ユーザー)

10.3 アクティビティ・グラフの前提条件

アクティビティ・グラフを使用するには、アクティビティ・グラフ・エンジン・アプリケーションがインストールおよび構成されている必要があります。詳細は、『Oracle WebCenter Portalインストレーション・ガイド』を参照してください。

また、アプリケーションで、WebCenter Portalスキーマおよびアクティビティ・データベースへの接続を作成する必要があります。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のデータベース接続の設定に関する項を参照してください。

分析イベント・コレクタに使用状況イベントを送信するように、アプリケーションを構成する必要があります。詳細は、第11.5項「アプリケーション用の分析コレクタの登録」を参照してください。

アクティビティ・グラフが推奨を行う前に、アクティビティ・グラフ・エンジンが少なくとも1回実行され、データが収集されて、類似度スコアが計算されている必要があります。詳細は、第10.4項「アクティビティ・グラフのデータの準備」を参照してください。

また、類似アイテム・タスク・フローで提案されるアイテム、トップ・アイテム・タスク・フローおよび推奨データ制御は、アプリケーションで使用できるツールとサービスによって異なります。たとえばドキュメントは、ドキュメント・ツールが有効な場合にのみ推奨されます。また、アイテムを所有するツール/サービスのリソース認可者が、そのアイテムを推奨からフィルタで除外することも可能です。

- ドキュメント、Wikiおよびブログを表示するには、コンテンツ・リポジトリへの接続が必要です。

- ディスカッションを表示するには、ディスカッション・サーバーへの接続が必要です。

クラスタ環境では、アクティビティ・グラフ・エンジン・アプリケーションのインスタンスは1つを除いてすべて無効化する必要があります。詳細は、高可用性ガイドのWebCenter Portal用のアクティビティ・グラフの構成に関する項を参照してください。

10.4 アクティビティ・グラフのデータの準備

アクティビティ・グラフ・エンジンは、データの収集、類似度スコアの計算および検索ランキングの計算を実行する3つの個別エンジンで構成されています。3つのエンジンは次のとおりです。

- 収集エンジン - 登録されているアクティビティ・プロバイダ・セットを介して、分析表および他のリポジトリからアクティビティを収集します。

- 共同フィルタ・エンジン(CFE) - オブジェクトのペアに関する類似度スコアを計算し、後で類似度推奨を生成する場合に備えて、そのスコアをアクティビティ・グラフに格納します。これを行うには、一連の類似度計算を実行します。類似度計算は、指定したセットのドメインとバックグラウンド・ノード・クラスに関する類似度スコアの計算方法を共同フィルタ・エンジンに対して指示するオブジェクトです。計算された各類似度スコアは、特定の基準下で2つのオブジェクトがどの程度類似しているかを指定する0から1までの数値です。類似度計算は、ドメインとバックグラウンド・クラス、距離関数およびリレーションの組合せというプロパティによって指定されます。

- ランク・エンジン - アクティビティ・グラフの各ノードの重要度のメジャーを計算します。このアクティビティ・ランクを検索索引に格納し、問合せ時に問合せ依存スコアと組み合せて使用して検索結果を順序付けることができます。詳細は、第10.7項「Oracle Secure Enterprise Searchのアクティビティ・ランクの設定」を参照してください。このスコアはコンテキストに依存しない推奨の順序付けにも役立ちます。そのため、リレーション・ストアにも格納されます。

アクティビティ・グラフがオブジェクトの推奨を開始するには、これらのエンジンが少なくとも1回実行され、データが収集されて、類似度スコアが計算されていることが必要です。この初期実行後は、必要に応じて、またはスケジュールに基づいてエンジンを実行することによって、新しいアクティビティが確実に取得され、分析されるようにすることができます。

この項には次のトピックが含まれます:

- 第10.4.1項「アクティビティ・グラフ・エンジンのスケジュール実行」

- 第10.4.2項「アクティビティ・グラフ・エンジンのオンデマンド実行」

10.4.1 アクティビティ・グラフ・エンジンのスケジュール実行

アクティビティ・グラフ・エンジンをスケジュールに基づいて実行することによって、新しいアクティビティが定期的に確実に取得され、分析されるようにすることができます。これは、トラフィック量が多く、コンテンツが頻繁に更新されるアプリケーションで役立ちます。

アクティビティ・グラフ・エンジンをスケジュールに基づいて実行するには:

1. Fusion Middleware Controlにログインし、アクティビティ・グラフ・アプリケーション(activitygraph-engines)のホームページに移動します。
ナビゲータを使用してページにアクセスし、次のいずれかを選択します。

- 「アプリケーション・デプロイメント」→「activitygraph-engines」

- 「WebLogicドメイン」→「wc_domain」→「WC_Utilities」→「activitygraph-engines」

2. 「Webモジュール」の下で、「アクティビティ・グラフのスケジュールとステータス」ページのURLをクリックし、ログインします。

注意:
このページにアクセスするには、Administratorsグループのメンバーである必要があります。
「アクティビティ・グラフのスケジュールとステータス」ページでは、マルチバイトのユーザー名およびパスワードをサポートしていないため、ASCIIのみのユーザー名およびパスワードを使用してログインする必要があります。

ヒント:
「アクティビティ・グラフのスケジュールとステータス」ページには、次のURLに直接進んでアクセスすることもできます。

http://host:port/activitygraph-engines

ここで、http://host:portはWC_Utilities管理対象サーバーのURLです。

3. 「アクティビティ・グラフのスケジュールとステータス」ページで、「スケジュールで実行」を選択します。

4. 「開始日」フィールドに、スケジュールの開始日を入力します。

5. 「実行」フィールドに、プロセスの定期的な実行間隔を示す値を入力します。たとえば、プロセスを毎日実行する場合は、このフィールドに1と入力します。プロセスを1日おきに実行する場合は、このフィールドに2と入力します。

6. 「日時」リストから、プロセスを開始する時刻を選択します。

7. 「開始」をクリックします。
指定した日付の選択した時刻にプロセスが実行され、その後、スケジュールしたとおりに継続して実行されます。

10.4.2 アクティビティ・グラフ・エンジンのオンデマンド実行

アプリケーションのデータがそれほど頻繁には変わらない可能性がある場合は、必要なときにアクティビティ・グラフ・エンジンをオンデマンド実行できます。このオプションは、定期的なスケジュール実行間隔中に、アクティビティ・グラフ・エンジンをオンデマンドで実行する目的でも使用できます。

アクティビティ・グラフ・エンジンをオンデマンドで実行するには:

1. Fusion Middleware Controlにログインし、アクティビティ・グラフ・アプリケーション(activitygraph-engines)のホームページに移動します。
ナビゲータを使用してページにアクセスし、次のいずれかを選択します。

- 「アプリケーション・デプロイメント」→「activitygraph-engines」

- 「WebLogicドメイン」→「wc_domain」→「WC_Utilities」→「activitygraph-engines」

2. 「Webモジュール」の下で、「アクティビティ・グラフのスケジュールとステータス」ページのURLをクリックし、ログインします。

注意:
このページにアクセスするには、Administratorsグループのメンバーである必要があります。
「アクティビティ・グラフのスケジュールとステータス」ページでは、マルチバイトのユーザー名およびパスワードをサポートしていないため、ASCIIのみのユーザー名およびパスワードを使用してログインする必要があります。

ヒント:
「アクティビティ・グラフのスケジュールとステータス」ページには、次のURLに直接進んでアクセスすることもできます。

http://host:port/activitygraph-engines

ここで、http://host:portはWC_Utilities管理対象サーバーのURLです。

3. 「今すぐ1回実行」を選択します。

4. アクティビティ・グラフ・エンジンの前回の実行以後に発生したアクティビティによって表を更新する場合は、「増分更新」を選択します。
既存のすべてのデータを削除し、すべてのアクティビティを表に再移入する場合は、「完全再ビルド」を選択します。この場合、時間がかかることがあります。

5. 「開始」をクリックします。
ダイアログの「ステータス」セクションで、プロセスの進行状況をモニターできます。

6. 必要に応じて「停止」をクリックすることによって、随時プロセスを停止できます。

7. プロセスのオンデマンド実行後に定期的なスケジュールに戻す場合は、「スケジュールで実行」を必ず選択し、詳細に誤りがないことを確認して、「開始」をクリックします。それにより、スケジュールが再開されます。

10.5 類似度計算の理由文字列のカスタマイズ

類似度計算には、特定の推奨がなぜ行われたかをユーザーが理解するのに役立つ理由文字列を関連付けることができます。人またはオブジェクトが推奨されたときに、最も高いスコアリングに関連する類似度計算に理由文字列が関連付けられている場合、その文字列がタスク・フローに表示されます。類似度計算で表示される理由文字列は編集可能であり、また、追加の文字列を作成することもできます。

各類似度計算では、個々の理由ごとに単数形と複数形の2つのフレーズを定義できます。

理由文字列は次のトークンを使用してカスタマイズできます。

- {RECOMMENDED_ITEM} - 現在の推奨アイテムの名前。

- {NUMBER_OF_ITEMS} - 共通するオブジェクト数。これはコンポーネント・スコアの分子に対応します。

- {TOTAL_ITEMS} - 共通するアイテムの合計数。これはコンポーネント・スコアの分母に対応します。意味は上位類似度URNに関連付けられた類似度関数に依存します。

- {SIMILARITY_CALCULATION} - 上位類似度計算の名前。

たとえば、user-connect類似度計算では、次の2つの理由文字列が定義されています。

reason-user-connect=You share {NUMBER_OF_ITEMS} connections with {RECOMMENDED_ITEM}.

reason-user-connect=You share {NUMBER_OF_ITEMS} connection with {RECOMMENDED_ITEM}.

類似度計算の理由文字列をカスタマイズする手順は次のとおりです。

1. UIBundle.propertiesファイルを開きます。

2. カスタマイズする理由文字列を見つけて、必要に応じて編集します。

3. 新しい理由文字列を作成する場合は、次の形式を使用します。

reason-similarity-calculation=string

4. UIBundle.propertiesファイルを保存します。

10.6 アクティビティ・グラフ・スキーマのカスタマイズの管理

WebCenter Portalは、アクティビティ・グラフとの即時利用可能な統合を提供します。これには、分析からのWebCenter Portalイベント・データをマッピングするためのメタデータ定義が含まれます。このメタデータは、アクティビティ・グラフ・エンジン・アプリケーションの最初の起動時に自動的にロードされます。

XMLファイルを操作することによって、アクティビティ・グラフ・メタデータを拡張し、分析からのアクションの収集方法を変更できます。メタデータを使用するためには、まずデータをXMLファイルにエクスポートする必要があります。XMLファイルの編集後、メタデータをアクティビティ・グラフに再びインポートできます。

この項には次のトピックが含まれます:

- 第10.6.1項「アクティビティ・グラフ・メタデータのエクスポート」

- 第10.6.2項「プロバイダ構成のエクスポート」

- 第10.6.3項「アクティビティ・グラフ・メタデータのインポート」

- 第10.6.4項「アクティビティ・グラフ・メタデータの削除」

- 第10.6.5項「アクション名およびノード・クラス名の変更」

アクティビティ・グラフ・メタデータを拡張する方法の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のアクティビティ・グラフの拡張に関する項を参照してください。

10.6.1 アクティビティ・グラフ・メタデータのエクスポート

WLSTコマンドのexportAGMetadataを使用して、アクティビティ・グラフ・メタデータ定義をXMLファイルにエクスポートします。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のexportAGMetadataに関する項を参照してください。

例:

exportAGMetadata(appName='activitygraph-engines',
directoryPath='/scratch/monty', definitionFileName='activityGraphMetaData.xml',
includeProviderConfigurations=1)

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

10.6.2 プロバイダ構成のエクスポート

WLSTコマンドのexportAGProviderConfigurationを使用して、特定のプロバイダに関するプロバイダ構成メタデータをアクティビティ・グラフ・メタデータ定義ファイルにエクスポートします。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のexportAGProviderConfigurationに関する項を参照してください。

例:

exportAGProviderConfiguration(appName='activitygraph-engines',
directoryPath='/scratch/monty',
definitionFileName='activityGraph-analytics-mappings.xml',
urn='oracle.webcenter.activitygraph.providers.analytics')

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

10.6.3 アクティビティ・グラフ・メタデータのインポート

WLSTコマンドのimportAGMetadataを使用して、アクティビティ・グラフ・メタデータ定義をXMLファイルからインポートします。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のimportAGMetadataに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

10.6.4 アクティビティ・グラフ・メタデータの削除

WLSTコマンドのdeleteAllAGMetadataを使用して、WebCenter Portalアプリケーションで定義されているすべてのアクティビティ・グラフ・メタデータを削除します。アクティビティ・グラフ・メタデータを完全に再インストールするには、このコマンドをWLSTコマンドimportAGMetadataと組み合せて使用します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のdeleteAllAGMetadataに関する項を参照してください。

注意:
このコマンドは、新しいメタデータ・セットをインポートすることを予定している場合にのみ使用してください。

アクティビティ・グラフの個別オブジェクトのメタデータは、次のWLSTコマンドを使用して削除できます。

- ノード・クラス(deleteAGNodeClass)

- アクション(deleteAGAction)

- 類似度計算(deleteAGSimilarityCalculation)

- ランク計算(deleteAGRankCalculation)

- プロバイダ割当て(deleteAGProviderAssignment)

- QRPP (deleteAGQRPPRegistration)

注意:
これらのdeleteメソッドでは、メタデータがスキーマから削除されます。その結果、アクティビティ・グラフ・エンジンの次回の実行時に、アクティビティ・データベース内のあらゆる関連データが削除されます。

詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のアクティビティ・グラフに関する項を参照してください。

10.6.5 アクション名およびノード・クラス名の変更

WLSTコマンドのrenameAGNodeClassを使用して、アクティビティ・グラフに現在登録されているノード・クラスのURNを変更します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のrenameAGNodeClassに関する項を参照してください。

WLSTコマンドのrenameAGActionを使用して、アクティビティ・グラフに現在登録されているアクションのURNを変更します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のrenameAGActionに関する項を参照してください。

注意:
これらのコマンドでは、影響を受けるノード・クラスまたはアクションに関連付けられたメタデータについては削除されません。

10.7 Oracle Secure Enterprise Searchのアクティビティ・ランクの設定

WebCenter PortalアプリケーションとFusionアプリケーションを介して提供されるエンタープライズ・コンテンツは充実した構造をしています。この構造はマルコフ連鎖分析という数学的技法の使用に役立ちます。この技法がランク・エンジンで使用され、より関連性の強い結果セットが生成されることで、エンド・ユーザーの検索を改善するアクティビティ・ランクが各ノードに生成されます。これは、Oracle Secure Enterprise Search (Oracle SES)検索索引に様々なオブジェクトの重要度のメジャーを導入することによって実現されます。その後、他の標準の検索基準(条件頻度など)と組み合せて、この重要度が結果の順序付けで考慮されます。オブジェクトの重要度の決定は、そのオブジェクトとのユーザーの対話の履歴に基づいて予測されます。

アクティビティ・ランクでは、人の重要度は、その人物が作成および編集するアイテムの数、それらのアイテムの重要度、その人物とコネクションがある人の数、およびそれらの人々の重要度に依存します。アイテムの重要度は、その作成者の重要度、そのアイテムを表示、タグ付けおよび編集する人々の数、およびそれらの人々の重要度に依存します。

ランク・エンジン・プロセスは次の4つのフェーズに分けることができます。

- 収集 - ランク・エンジンが分析ストアに対して、ユーザーとドキュメント間のコネクションに関するデータの問合せを実行します。

- 変形 - データがマトリックスに変換されます。

- 乗算 - マトリックスを使用してアクティビティ・ランクが計算されます。

- 結果の格納 - 検索時に使用できるように、アクティビティ・ランクがOracle SES検索サーバーに格納されます。

アクティビティ・ランク候補は、WebCenter Portalオブジェクトのうち、Oracle SESクローラ実装を持つオブジェクト、WebCenter Portal分析インストゥルメンテーションを持つオブジェクト、およびアクティビティ・グラフ・ランク計算への登録があるオブジェクトの共通部分に制限されます。

検索の動作に影響するアクティビティ・ランクをオブジェクトが受信するためには、イベント・データが分析から収集されること、ランク計算がアクティビティ・グラフによって生成されること、およびアクティビティ・グラフに登録されているいずれかのクラスに一致する値をwc_serviceId属性値として持つ索引付きエントリが検索に含まれることの条件をオブジェクトが満たすことが必要です。現在サポートされているオブジェクトは次のとおりです。

- ユーザー

- ドキュメント

- ブログ・エントリ

- Wikiページ

注意:
オブジェクトのクラス自体が検索可能でない場合でも、ランクは計算され、使用されます。

アクティビティ・ランクの計算で考慮されるアクションの範囲は、activityGraphMetaData.xmlファイルに指定されたrankCalculationによって定義されます。初期状態の宣言には次のユーザー・アクションが含まれています。

<component actionURN="connect" weight="10.0"/>
<component actionURN="edit" weight="20.0" inverse="true"/>
<component actionURN="view-count" weight="1.0"/>
<component actionURN="create" weight="100.0" inverse="true"/>
<component actionURN="create" weight="100.0"/>
<component actionURN="edit-count" weight="20.0"/>
<component actionURN="download" weight="5.0"/>
<component actionURN="tag" weight="10.0"/>
<component actionURN="comment" weight="10.0"/>

ここから、ドキュメントの表示という単一アクションの場合、そのドキュメントに対する重要度(weight="1.0")は、ドキュメントの作成アクション(weight="100.0")やタグ付けアクション(weight="10.0")に比べてきわめて低いことがわかります。

また、inverse属性がtrueに設定されている場合、オブジェクトとユーザー間のリレーションシップが示されます。このリレーションシップの効果は、ランクの高いオブジェクトによってユーザーが信頼性を高められることです。たとえば、他のユーザーがドキュメントに対して実行したアクション(タグ付け、表示、ダウンロード)によってそのランクが上昇するにつれ、そのドキュメントの作成者(createリレーションシップ)がそのドキュメントのランクを収集し、そのユーザーの将来のアクションの重みが増幅されます。

アクティビティ・グラフ・ランク・エンジンは、影響を受けるすべてのオブジェクトに関するランク計算を完了すると、1から10の範囲の正規化されたランクを持つ識別子の結果セットをプラグイン・クラスSesRankResultAcceptorに送信します。このクラスは、Oracle SES SOAP APIを使用して、検索索引にランクをそのままプッシュします。このランクは(Oracle SESではdocscoreと呼ばれています)、SOAP APIに受け入れられるとすぐに検索ランキングで考慮されます(DocScore機能が完全に有効化されている場合)。

したがって、結果セットの同じ階層内の複数のアイテムでは、docscoreがより高いアイテムが、より低いアイテムより高い検索スコアを取得するため、より高いアイテムはその階層内でより上位のランクに押し上げられる可能性があります。

始める前に

アクティビティ・ランクはOracle SESと連携して動作します。そのため、Oracle SESが適切にインストールおよび構成されていることを確認する必要があります。また、アクティビティ・ランクは検索可能アイテムにのみ作用するため、ランク・エンジンはSESクローラの実行後に実行してください。詳細は、第18章「WebCenter PortalでのOracle Secure Enterprise Searchの管理」を参照してください。

Oracle SESのアクティビティ・ランクを構成するには:

1. ランク・エンジンでは、ACTIVITY-RANKに対して外部名DOC_SCORE_1を持つdocscore属性、およびLIKE-RANKに対して外部名DOC_SCORE_2を持つdocscore属性をそれぞれ使用することを期待しています。そのため、ストアド・プロシージャeq_sdata.create_sdata_attributeをコールすることによって、これらのフィールドを設定するための1回限りのマッピング・コールを実行する必要があります。

exec eq_sdata.create_sdata_attribute('ACTIVITY-RANK');
exec eq_sdata.create_sdata_attribute('LIKE-RANK');

注意:
これらのストアド・プロシージャは、Oracle SESインスタンスをホストするサーバーから呼び出す必要があります。

2. また、これらの属性の重みを決定するエントリをOracle SES ranking.xmlファイルに追加する必要があります。
Oracle SES 11.1.2.2の場合のみ、次のように追加します。

<ranking>
<docscore-factor>
<attribute-name>ACTIVITY-RANK</attribute-name>
<column-name>DOC_SCORE_1</column-name>
<weight>1.0</weight>
</docscore-factor>
<docscore-factor>
<attribute-name>LIKE-RANK</attribute-name>
<column-name>DOC_SCORE_2</column-name>
<weight>1.0</weight>
</docscore-factor>
</ranking>

他のすべてのバージョンのOracle SESでは、次のように追加します。

<ranking>
<docscore-factor>
<attribute-name>ACTIVITY-RANK</attribute-name>
<column-name>DOC_SCORE_1</column-name>
<weight>1.0</weight>
</docscore-factor>
<docscore-factor>
<attribute-name>LIKE-RANK</attribute-name>
<column-name>DOC_SCORE_2</column-name>
<weight>1.0</weight>
</docscore-factor>
<docscore-factor>
<attribute-name>Doc_Score</attribute-name>
<weight>1.0</weight>
</docscore-factor>
</ranking>

ヒント:
ranking.xmlファイルは次のディレクトリにあります。

$SES_HOME/search/webapp/config

3. Oracle SES中間層を再起動して、変更を有効にします。

4. WLSTコマンドのsetAGPropertyを使用して、次のアクティビティ・グラフ・プロパティを設定します。

oracle.webcenter.activitygraph.providers.datasources.ses.soap.admin.url
oracle.webcenter.activitygraph.providers.datasources.ses.soap.query.url

例:

setAGProperty(appName='activitygraph-engines',
propertyName='oracle.webcenter.activitygraph.providers.datasources.ses.soap.admin.url',
propertyValue='http://seshostname:7777/search/api/admin/AdminService',
propertyType='String')

setAGProperty(appName='activitygraph-engines',
propertyName='oracle.webcenter.activitygraph.providers.datasources.ses.soap.query.url',
propertyValue='http://seshostname:7777/search/query/OracleSearch',
propertyType='String')

これらのプロパティを設定すると、Oracle SESサーバーに接続して索引にランクを記録するSESRankResultAcceptorが有効化されます。

5. WLSTコマンドのsetAGPasswordCredentialを使用して、2つのプロパティによって定義されたURLにアクセスするときに使用するユーザー名とパスワードを設定します。

注意:
検索可能なすべてのアイテムへのアクセス権を持つユーザーと一致する資格証明を指定してください。

例:

setAGPasswordCredential(appName='activitygraph-engines',
propertyName='oracle.webcenter.activitygraph.providers.datasources.ses.soap.admin.credential',
userName='eqsys',
password='MyPassword1')

setAGPasswordCredential(appName='activitygraph-engines',
propertyName='oracle.webcenter.activitygraph.providers.datasources.ses.soap.query.credential',
userName='orcladmin',
password='MyPassword1')

6. アクティビティ・グラフ・エンジン・アプリケーションがデプロイされている管理対象サーバー(つまり、WC_Utilities管理対象サーバー)を再起動します。

10.8 推奨に関する問題のトラブルシューティング

この項では、アクティビティ・グラフの使用中に発生する可能性がある問題のトラブルシューティングに役立つ情報を提供します。

注意:
次に示すトラブルシューティングの解決法では、アクティビティ・グラフ・エンジンが正しくデプロイされていること、WC_Utilities管理対象サーバーが稼働していること、およびopenusage enabledプロパティがtrueに設定されていることを前提としています。
また、第10.3項「アクティビティ・グラフの前提条件」も必ず読んでおいてください。

10.8.1 アクティビティ・グラフ・エンジンの「スケジュールとステータス」ページのトラブルシューティング

問題

アクティビティ・グラフ・エンジンの実行中に、「アクティビティ・グラフのスケジュールとステータス」ページでエラーがスローされる

解決策

この場合の基本的な検証内容は、WebLogicコンソールからアクティビティ・グラフ・エンジンのデプロイ・ステータスを検証することです。

問題

「スケジュールとステータス」ページからアクティビティ・グラフ・エンジンを起動したときに、エンジンのステータスがUIに反映されない。

解決策

アクティビティ・グラフのログで、エンジンが実際に実行されているかどうか確認します。エンジンが実行されていることがログに示されている場合は、問題はUIのみに関連します。この場合、タスク・フローに表示される推奨には影響しません。収集/CFEエンジンのエントリがログに何も示されていない場合は、イベント・マッピング・ファイルに問題がある可能性があります。

ヒント:
アクティビティ・グラフ・エンジンのログは次の場所にあります。

domain/log/WC_Utilities.out
domain/servers/WC_Utilities/logs/WC_Utilities-diagnotics.log

問題

「アクティビティ・グラフのスケジュールとステータス」ページにログインできない。

解決策

「アクティビティ・グラフのスケジュールとステータス」ページでは、マルチバイトのユーザー名およびパスワードはサポートされていません。ASCII文字のみのユーザー名とパスワードを持つ管理者としてログインしてください。

11 分析の管理

この章では、WebCenter PortalおよびPortal Frameworkアプリケーションの分析を構成および管理する方法について説明します。分析を使用することで、これらのアプリケーションの使用状況とパフォーマンスのメトリックを表示できるようになります。

WebCenter PortalおよびPortal Frameworkアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後に行ったすべての構成変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。第1.3.5項「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。分析コレクタ構成に行ったすべての変更は、分析データベースに格納されます。

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

注意:
Fusion Middleware ControlまたはWLSTを使用して分析の構成に対して加えた変更は動的ではないため、変更を有効にするには、分析コレクタまたはポータル・アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章には次の項が含まれます:

- 第11.1項「WebCenter Portalの分析について」

- 第11.2項「分析の構成ロードマップ」

- 第11.3項「分析の前提条件」

- 第11.4項「分析コレクタ設定の構成」

- 第11.5項「アプリケーション用の分析コレクタの登録」

- 第11.6項「ユーザー・プロファイル・イベントのタイミングの構成」

- 第11.7項「分析イベント収集の検証」

- 第11.8項「現在のWebCenter Portalの分析イベント・リストの表示」

- 第11.9項「分析データのパージ」

- 第11.10項「分析データのパーティション化」

- 第11.11項「分析に関する問題のトラブルシューティング」

11.1 WebCenter Portalの分析について

WebCenter Portal管理者およびビジネス・ユーザーは、分析を使用することによって、ポータルの使用状況を追跡および分析できます。分析では、次の基本機能が提供されます。

- 使用状況トラッキング・メトリック: 分析によって、コミュニティ、ページ、ポートレットおよびドキュメントへのアクセスなどの、ポータルの一般的な機能に関するメトリックが収集および報告されます。

- 動作トラッキング: ユーザーはポータル・メトリックを分析して、ポータル訪問期間や、一定期間の使用状況などの使用パターンを特定できます。

- ユーザー・プロファイルの相関: ユーザーは、メトリック情報をユーザー・プロファイル情報と関係付けることができます。国、会社、都道府県などのユーザー・プロファイル・データを基準に、使用状況トラッキング・レポートを表示およびフィルタ処理できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』の問合せオプションに関する項を参照してください。

次の各項では、分析のコンポーネントと、すぐに使用可能なタスク・フローの概要を説明します。

- 第11.1.1項「分析のコンポーネント」

- 第11.1.2項「分析タスク・フロー」

11.1.1 分析のコンポーネント

図11-1は、WebCenter Portalにおける分析のコンポーネントを示しています。

- WC_Spaces: WebCenter Portalがデプロイされている管理対象サーバー。
(Portal Frameworkアプリケーションは異なる管理対象サーバーにデプロイされます。)

- WC_Utilities: 分析コレクタがデプロイされている管理対象サーバー。

- イベント・データ: 定義されたイベント・セットが分析によって追跡および収集されます。すぐに使用可能な最多発イベントの包括的なセットが付属しています。

- Open Usage API: OpenUsage APIによって、UDP (ユーザー・データグラム・プロトコル)を使用して分析コレクタにメトリックが送信されます。

- 分析コレクタ: 分析コレクタ・コンポーネントによって、イベント・データが収集されます。
分析コレクタをクラスタ化して、スケーラビリティと信頼性を高めることができます。

- 分析データベース: 分析データベース(ACTIVITIES)には、ポータル・イベントおよび非ポータル・イベントから収集されたメトリックが格納されます。

- 分析タスク・フロー: 分析によって、一般的なポータル機能のメトリックを報告する一連のタスク・フローが提供されます。

- MDS: タスク・フローのカスタマイズを格納するOracle Metadata Services (MDS)リポジトリ。

図11-1 分析のコンポーネント

11.1.2 分析タスク・フロー

表11-1は、WebCenter Portalで使用できる分析タスク・フローを示しています。各タスク・フローは、Portal FrameworkアプリケーションでもWebCenter Portalでも同様に動作します。これらのタスク・フローの詳細および使用方法は、『Oracle WebCenter Portalでのポータルの構築』の分析の概要に関する項を参照してください。

表11-1 WebCenter Portalでの分析タスク・フロー

分析タスク・フロー

説明

WebCenterポータル・トラフィック

ポータル内の一般的なイベントのサマリー・ビュー。

ページ・トラフィック

ポータル内のページへのアクセス数と、いずれかのページにアクセスした一意のユーザー数が表示されます。

ログイン・メトリック

ポータルへのログインについて報告されます。

ポートレット・トラフィック

ポートレットの使用状況データが表示されます。

ポートレット・レスポンス時間

ポートレットのパフォーマンス・データが表示されます。

ポートレット・インスタンス・トラフィック

ポートレット・インスタンスの使用状況データが表示されます。

同じポートレットが複数のページに表示される場合は、各配置がポートレット・インスタンスとして考慮されます。

ポートレット・インスタンス・レスポンス時間

ポートレット・インスタンスのパフォーマンス・データが表示されます。

検索メトリック

ポータルの検索が追跡されます。

ドキュメント・メトリック

ドキュメント・ビューが追跡されます。

Wikiメトリック

最も人気が高い/低いwikiが追跡されます。

ブログ・メトリック

最も人気が高い/低いブログが追跡されます。

ディスカッション・メトリック

最も人気が高い/低いディスカッションが追跡されます。

ポータル・トラフィック*

(WebCenter Portalのみ)ポータルの使用状況データが表示されます。

ポータル・レスポンス時間*

(WebCenter Portalのみ)ポータルのページ・パフォーマンス・データが表示されます。

*これらのタスク・フローはWebCenter Portalに固有のものです。これらのタスク・フローは、Portal Frameworkアプリケーションには使用できません。

11.2 分析の構成ロードマップ

図11-2のフロー・チャートと表11-2のタスクは、WebCenter Portalで分析を動作させるための前提条件と必要なタスクの概要を示しています。

図11-2 WebCenter Portalで分析を使用するための構成

表11-2 WebCenter Portalで分析を使用するための構成

担当者

タスク

サブタスク

管理者

1. Oracle WebCenter Portalと、分析のバックエンド・コンポーネントをインストールします

管理者

2. (オプション)次のツールのいずれかを使用して、分析コレクタ設定を構成します

- システムMBeanブラウザ

- WLST

管理者

3. 次のツールのいずれかを使用して、WebCenter Portalと分析コレクタ間の接続を構成します

- Fusion Middleware Control

- WLST

WebCenter Portal管理者

4. 分析データがWebCenter Portalで使用可能なことをテストします

4.a 管理者権限でWebCenter Portalにログインします

4.b 分析ビジネス・ロールのメイン・ページを開いてライブ・データを表示します

http://host:port/webcenter/portal/system/Analytics

11.3 分析の前提条件

この項には次のサブセクションが含まれます:

- 第11.3.1項「分析: インストール」

- 第11.3.2項「分析: 構成」

- 第11.3.3項「分析: セキュリティに関する考慮事項」

- 第11.3.4項「分析: 制限事項」

11.3.1 分析: インストール

分析コレクタはOracle WebCenter Portalのオプションのインストール・オプションです。この製品をインストールするには、Fusion Middleware構成ウィザードで「Oracle WebCenter Portal Analytics Collector」を選択します。インストール手順の詳細は、『Oracle WebCenter Portalインストレーション・ガイド』を参照してください。

分析スキーマ(ACTIVITIES)とWebCenter Portalスキーマ(WEBCENTER)は、同じデータベースにインストールすることも、別々のデータベースにインストールすることもできます。

11.3.2 分析: 構成

分析コレクタは、インストールのデフォルトを使用して、初期設定でイベントを受信するように構成されています。デフォルト値がインストール環境に適さない場合や、クラスタを使用している場合は、WLSTまたはMBeanブラウザを使用して別の値を構成できます。詳細は、第11.4項「分析コレクタ設定の構成」を参照してください。

ただし、初期設定では、WebCenter Portalは、分析コレクタにイベントを送信するようには構成されていません。WebCenter Portal (または任意のPortal Frameworkアプリケーション)の使用状況とパフォーマンス・メトリックを収集する場合は、Analyticsコレクタを登録してイベント収集を有効にする必要があります。詳細は、第11.5項「アプリケーション用の分析コレクタの登録」を参照してください。接続されると、分析データが収集され、詳細な構成なしに(分析タスク・フローを介して)アプリケーションに表示されます。

11.3.3 分析: セキュリティに関する考慮事項

WebCenter Portalのリソース・カタログでは、適切な権限を持つユーザーにのみ分析タスク・フローが表示されます。

- 管理者: Administratorロールを持つユーザーはすべての分析タスク・フローにアクセスできます。

- モデレータ: 特定のポータル内でModeratorロールを持つメンバーは、そのポータルの使用状況データを表示する分析タスク・フローにアクセスできます。

分析の使用状況データは、ポータル分析には有益ですが、ポータル・ユーザーの個人データまたは機密データとみなされる場合があります。WebCenter Portalの管理者および個別ポータルのモデレータは、使用状況メトリックに関連するセキュリティとプライバシの権利を保護するために、ページのセキュリティを管理し、分析データを公開するページにアクセスできるユーザーを、指定された適切なユーザーのみに制限する必要があります。『Oracle WebCenter Portalでのポータルの構築』のページ・セキュリティの設定に関する項を参照してください。

同様に、Portal Frameworkアプリケーションを構築する開発者は、分析タスク・フローおよびデータ公開のための適切なセキュリティ・モデルを設定する必要があります。詳細は、『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』の分析タスク・フローおよび使用状況データのセキュリティの設定に関する項を参照してください。

11.3.4 分析: 制限事項

分析タスク・フローにはカスタム・イベント情報は表示されません。

11.4 分析コレクタ設定の構成

分析コレクタは、インストール時に、次のデフォルト値を使用してイベントを受信するように構成されます。

- コレクタ・ホスト名: localhost

- デフォルト・ポート: 31314

- 最大ポート番号: 31314

- ブロードキャスト・タイプ: マルチキャスト

- クラスタリング: クラスタリング設定は適用されません。クラスタリングはこのバージョンではサポートされません。

これらのデフォルト値がインストール環境に適さない場合や、クラスタを使用している場合は、WLSTを使用するか、またはFusion Middleware ControlでMBeanブラウザを使用して、適切な値を構成できます。

- WLSTを使用した分析コレクタ・プロパティの設定

- Fusion Middleware Controlを使用した分析コレクタ・プロパティの設定

これらの分析コレクタ構成設定は分析データベース(ACTIVITIES)に格納されます。

11.4.1 WLSTを使用した分析コレクタ・プロパティの設定

WLSTコマンドのsetAnalyticsCollectorConfigを使用して、分析コレクタのイベント収集プロパティを設定します。コマンド構文および例については、『WebLogic Scripting Toolコマンド・リファレンス』のsetAnalyticsCollectorConfigに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
プロパティ値の使用を開始するには、分析コレクタ・アプリケーションがデプロイされている管理対象サーバー(WC_Utilities)を再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

11.4.2 Fusion Middleware Controlを使用した分析コレクタ・プロパティの設定

分析コレクタのイベント収集プロパティを設定するには、Fusion Middleware ControlでシステムMBeanブラウザを使用します。

分析コレクタ(デプロイ場所: 管理対象サーバーWC_Utilities)を構成するには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. システムMBeanブラウザを開きます。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「システムMBeanブラウザ」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「システムMBeanブラウザ」を選択します。

3. 次の場所に移動します。
「アプリケーション定義のMBean」→「oracle.webcenter.analytics」→「サーバー: WC_Utilities」→「アプリケーション: analytics-collector」→「CollectorConfiguration」→「構成」
または、CollectorConfigurationを検索するか、MBeanパターンoracle.webcenter.analytics:*を使用してシステムMBeanブラウザ・ツリーをフィルタ処理します。

図11-3 システムMBeanブラウザ: 分析コレクタ・プロパティ

4. 分析コレクタの構成プロパティを変更します。詳細は、表11-3を参照してください。

表11-3 分析コレクタ: 構成プロパティ

フィールド

説明

BroadcastType

分析コレクタがハートビートをブロードキャストして、その位置をイベント・プロデューサに通知するネットワーク・チャネルを指定します。有効な値はBroadcastおよびMulticastです。

Broadcast: 標準のネットワーク・ブロードキャスト・チャネルを使用します。

Multicast: 指定された固定マルチキャスト・アドレスを使用します。

CollectorHostName

分析コレクタを実行しているホスト名を入力します。

デフォルト設定はlocalhostです。

CollectorDefaultPort

分析コレクタがリスニングするデフォルト・ポート番号を入力します。デフォルト値は31314です。

CollectorMaximumPort

分析コレクタがリスナーの割当て時に使用できる最大ポート番号を入力します。

このプロパティは、ほとんどの場合、同じボックスで複数のコレクタが稼働するクラスタ化環境で使用されます。各コレクタは指定されたポート範囲内の空きポートで受信UDPメッセージをリスニングします。この範囲はデフォルト・ポート番号から最大ポート番号までです。

ClusterEnabled

クラスタリング設定は適用されません。クラスタリングはこのバージョンではサポートされません。

ClusterName

クラスタリング設定は適用されません。クラスタリングはこのバージョンではサポートされません。

HeartbeatFrequency

クラスタリング設定は適用されません。クラスタリングはこのバージョンではサポートされません。

5. 新しい設定の使用を開始するには、分析コレクタ・アプリケーションがデプロイされている管理対象サーバー(WC_Utilities)を再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

11.5 アプリケーション用の分析コレクタの登録

OpenUsage APIによってWebCenter PortalまたはPortalアプリケーションで生成されたイベントは、分析、推奨およびアクティビティ・グラフ・エンジンで使用できるように、分析コレクタに送信できます。これらのツールが提供するいずれかの機能またはタスク・フローを使用する場合は、WebCenter PortalまたはPortal Frameworkアプリケーションを分析コレクタに接続する必要があります。

WebCenter PortalまたはPortal Frameworkアプリケーション用に複数の分析コレクタ接続を登録できますが、使用される分析コレクタは、デフォルトの(またはアクティブな)接続1つのみです。

新しい構成の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

この項には次のサブセクションが含まれます:

- 第11.5.1項「Fusion Middleware Controlを使用した分析コレクタの登録」

- 第11.5.2項「WLSTを使用した分析コレクタの登録」

- 第11.5.3項「WebCenter Portalイベント収集の無効化」

11.5.1 Fusion Middleware Controlを使用した分析コレクタの登録

WebCenter PortalまたはPortal Frameworkアプリケーション用に分析コレクタを登録するには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 「サービス構成」ページを開きます。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「Analyticsおよびアクティビティ・グラフ」を選択します。

4. 分析コレクタに接続するには、「追加」をクリックします(図11-4)。

図11-4 分析コレクタ接続の構成

5. この接続の一意の名前を入力します。
名前は、WebCenter PortalまたはPortal Frameworkアプリケーションのすべての接続タイプにおいて一意である必要があります。

6. この接続を分析およびアクティビティ・グラフに使用する場合は、「アクティブな接続」を選択します。
WebCenter PortalまたはPortal Frameworkアプリケーション用に複数の分析コレクタ接続を登録できますが、使用される接続は、デフォルトの(またはアクティブな)接続1つのみです。

7. OpenUsage APIによって生成された分析イベントを分析コレクタに送信するには、「WebCenterポータル・イベント収集の有効化」を選択します。
分析データを収集しない場合は、このオプションの選択を解除します。

8. 分析コレクタの接続の詳細を入力します。詳細は、表11-4を参照してください。

表11-4 分析コレクタ接続: 接続の詳細

フィールド

説明

メッセージング・モード

このプロパティでは、イベントをクラスタ化された分析コレクタにマルチキャスト・モードで送信するか、または単一の分析コレクタにユニキャスト通信を使用して送信するかを指定します。現在のリリースでは分析コレクタのクラスタリングはサポートされていないため、このリリースの有効な値はUnicastのみです。

コレクタ・ホスト名

メッセージング・モードをUnicastに設定した場合は、分析コレクタを実行しているホスト名を入力します。

デフォルト設定はlocalhostです。

コレクタ・ポート

分析コレクタがイベントをリスニングするポートを入力します。デフォルト値は31314です。

クラスタ名

メッセージング・モードをMulticastに設定した場合は、クラスタ化された分析コレクタを実行しているクラスタ名を入力します。

タイムアウト(秒)

メッセージング・モードをMulticastに設定した場合は、分析コレクタからのレスポンスを待機する時間(秒)を入力します。

デフォルト値は30秒です。

9. 「OK」をクリックして保存します。

10. 新しい(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

11.5.2 WLSTを使用した分析コレクタの登録

WLSTコマンドのcreateAnalyticsCollectorConnectionを使用して、WebCenter PortalまたはPortal Frameworkアプリケーション用に分析コレクタ接続を作成します。既存の接続を更新するには、setAnalyticsCollectorConnectionを使用します。コマンド構文および例については、『WebLogic Scripting Toolコマンド・リファレンス』のcreateAnalyticsCollectorConnectionおよびsetAnalyticsCollectorConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
新しい接続の使用を開始するには、isEnabled=1およびdefault=1であることを確認してから、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動します。詳細は、『管理者ガイド』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

11.5.3 WebCenter Portalイベント収集の無効化

OpenUsage APIによって生成されるイベントを収集しない場合は、イベント送信を一時的または永続的に停止できます。

この項には次のサブセクションが含まれます:

- 第11.5.3.1項「Fusion Middleware Controlを使用したWebCenter Portalイベント収集の無効化」

- 第11.5.3.2項「WLSTを使用したWebCenter Portalイベント収集の無効化」

11.5.3.1 Fusion Middleware Controlを使用したWebCenter Portalイベント収集の無効化

WebCenter PortalまたはPortal Frameworkアプリケーションのイベント収集を無効化するには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 「サービス構成」ページを開きます。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「Analyticsおよびアクティビティ・グラフ」を選択します。

4. 表で接続を選択して「編集」をクリックします。

5. 「WebCenterポータル・イベント収集の有効化」の選択を解除します(図11-5)。

図11-5 分析イベント収集の無効化

6. この変更を有効にするには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

11.5.3.2 WLSTを使用したWebCenter Portalイベント収集の無効化

WLSTを使用してイベントの収集を無効化するには、isEnabled引数を0 (false)に設定したsetAnalyticsCollectorConnectionコマンドを実行します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のsetAnalyticsCollectorConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

11.6 ユーザー・プロファイル・イベントのタイミングの構成

ユーザー・プロファイル情報はキャッシュされます。つまり、ユーザー・プロファイルの変更は、キャッシュが更新されるまでレポートに表示されません。このキャッシュは、デフォルトでは1000オブジェクトに制限され、各オブジェクトは、デフォルトでは60分間キャッシュ内に残ります。これらの値は、WLSTを使用して変更できます。キャッシュの最大オブジェクト数を変更するには、setProfileCacheNumberOfObjectsコマンドを実行します。キャッシュ内でオブジェクトがアイドル状態を維持する時間を変更するには、setProfileCacheTimeToLiveコマンドを実行します。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

11.7 分析イベント収集の検証

次の場所にあるトレース・ログを調べることによって、イベントが分析コレクタに到達するかどうかを確認できます。

<base_domain_name>/servers/WC_Utilities/logs/analytics-collector/collector.trc

イベント・メッセージは次のようなものです。

[2014-09-16T07:13:56.906-07:00] [WC_Utilities] [TRACE] []
[SRC_METHOD: OnMessageReceived] Event = [[
EVENT_TYPE: {http://www.myorg.com/videoapp}VIDEOVIEWS
VERSION: 3.0.XXXX
AS_DIMENSION_USER.USERID: testuser01
VIDEO.RESOURCEID: video8736
VIDEO.TITLE: Project Kick Off
VIDEO.LOOP: false
QUALITY: 720
PROPERTY_VERSION: 3.0.XXXX

分析コレクタの構成情報を表示するには、次のURLを入力します。

http://hostname:WC_Utilities_port/collector

このページに表示される内容は次のとおりです。

- コレクタのデフォルト・ポート

- コレクタの最大ポート

- コレクタのサーバー名

- ブロードキャスト・タイプ

- クラスタ有効

- クラスタ名

- パーティショニング有効

- 今年の時間ディメンション

- スペース・ディメンションが存在(WebCenter Portalの場合)

11.8 現在のWebCenter Portalの分析イベント・リストの表示

分析コレクタが収集を行うよう構成されているイベントを表示するには、Fusion Middleware ControlでシステムMBeanブラウザを使用します。

分析イベントの現在のリストを表示するには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. システムMBeanブラウザを開きます。

- WebCenter Portalアプリケーションの場合: 「WebCenterポータル」メニューから、「システムMBeanブラウザ」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「システムMBeanブラウザ」を選択します。

3. 次の場所に移動します。
「アプリケーション定義のMBean」→「oracle.webcenter.analytics」→「サーバー: WC_Utilities」→「アプリケーション: analytics-collector」→「CollectorServices」→「サービス」
または、CollectorServicesを検索するか、MBeanパターンoracle.webcenter.analytics:*を使用してシステムMBeanブラウザ・ツリーをフィルタ処理します。

4. 「操作」タブを選択します。

図11-6 システムMBeanブラウザ: 分析イベントの登録

5. 「listRegisteredEventTypes」をクリックします。

6. 「起動」をクリックします。

または、WLSTコマンドlistAnalyticsEventTypesを使用します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のlistAnalyticsEventTypesに関する項を参照してください。

11.9 分析データのパージ

分析データのパージの詳細は、『管理者ガイド』のOracle WebCenter Portal分析データのパージに関する項を参照してください。

11.10 分析データのパーティション化

分析データのパーティション化の詳細は、『管理者ガイド』のOracle WebCenter Portal分析データのパーティション化に関する項を参照してください。

11.11 分析に関する問題のトラブルシューティング

WebCenter PortalまたはPortal Frameworkアプリケーションに分析が表示されない場合は、次のことを確認します。

- 分析コレクタの構成に誤りがないこと、特に「WebCenterイベント収集の有効化」と「アクティブな接続」の両方が設定されていることを確認します(図11-7)。「アプリケーション用の分析コレクタの登録」を参照してください。

図11-7 接続と分析収集の有効化

接続を変更する場合は、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

- WebCenter PortalまたはPortal Frameworkアプリケーションが最近アップグレードされた場合は、ドメイン起動スクリプトにレガシーの分析コレクタ設定が含まれていないことを確認してください。レガシー設定が含まれていると、その値によって、Fusion Middleware ControlまたはWLSTを使用して指定したあらゆる接続詳細がオーバーライドされてしまいます。

1. WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを停止します。

2. 次にある、ドメイン起動スクリプトsetDomainEnvを編集します。
UNIX: DOMAIN_HOME/bin/setDomainEnv.sh

Windows: DOMAIN_HOME\bin\setDomainEnv.cmd

3. 分析コレクタ設定を削除します。

4. 管理対象サーバーを再起動します。

12 お知らせおよびディスカッションの管理

この章では、WebCenter Portalのお知らせおよびディスカッションを構成および管理する方法について説明します。お知らせおよびディスカッションは両方とも、WebCenter Portalのディスカッション・サーバーへの同一の接続を使用します。

特に明記しないかぎり、WebCenter Portalのディスカッション・サーバー内では構成変更を行わないでください。WebCenter PortalおよびPortal Frameworkアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。WebCenter Portalのディスカッション・サーバーに関するトラブルシューティングのヒントは、第12.12項「お知らせおよびディスカッションに関する問題のトラブルシューティング」を参照してください。

デプロイ後に加えた構成変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。第1.3.5項「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:
Fusion Middleware ControlまたはWLSTを使用して行ったディスカッションとお知らせの構成の変更は動的ではありません。変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章には次のトピックが含まれます:

- 第12.1項「ディスカッション・サーバー接続について」

- 第12.2項「ディスカッション・サーバーの前提条件」

- 第12.3項「ディスカッション・サーバーの登録」

- 第12.4項「ディスカッションおよびお知らせ用のアクティブな接続の選択」

- 第12.5項「ディスカッション・サーバー接続の詳細の変更」

- 第12.6項「ディスカッション・サーバー接続の削除」

- 第12.7項「ディスカッションのデフォルトの設定」

- 第12.8項「お知らせのデフォルトの設定」

- 第12.9項「ディスカッション・サーバーの管理者権限の付与」

- 第12.10項「ディスカッション・サーバーの管理者ロールの付与」

- 第12.11項「WebCenter Portalのディスカッション・フォーラム・オプションの構成」

- 第12.12項「お知らせおよびディスカッションに関する問題のトラブルシューティング」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

12.1 ディスカッション・サーバー接続について

お知らせおよびディスカッションにより、ユーザーは、WebCenter Portalでのディスカッションを開始、公開および保管できるようになります。ユーザーは、お知らせおよびディスカッションをポータル・ページに作成して公開できます。

ディスカッションおよびお知らせには、WebCenter Portalのディスカッション・サーバーへの単一の接続が必要です。WebCenter Portalのディスカッション・サーバーは、Oracle Fusion Middlewareを使用してインストールできます。

Fusion Middleware ControlコンソールまたはWLSTを使用して追加のディスカッション・サーバー接続を登録できますが、同時にアクティブにできる接続は1つのみです。次を参照してください。

- 第12.3.1項「Fusion Middleware Controlを使用したディスカッション・サーバーの登録」

- 第12.3.2項「WLSTを使用したディスカッション・サーバーの登録」

WebCenter Portal

WebCenter Portalでディスカッションおよびお知らせを使用するには、いくつかの追加構成が必要になります。これには、WebCenter Portalのすべてのディスカッションとお知らせを格納する(ディスカッション・サーバー上の)カテゴリの選択などが含まれます。この構成はWebCenter Portal内で行います。詳細は、第12.11項「WebCenter Portalのディスカッション・フォーラム・オプションの構成」を参照してください。

12.2 ディスカッション・サーバーの前提条件

この項には次のサブセクションが含まれます:

- 第12.2.1項「ディスカッション・サーバー: インストール」

- 第12.2.2項「ディスカッション・サーバー: 構成」

- 第12.2.3項「ディスカッション・サーバー: セキュリティに関する考慮事項」

- 第12.2.4項「ディスカッション・サーバー: 制限事項」

12.2.1 ディスカッション・サーバー: インストール

WebCenter Portalのインストール時に、WebCenter Portalのディスカッション・サーバーのインストールを選択します。リポジトリ作成ユーティリティ(RCU)を使用してDISCUSSIONSスキーマを作成します。

Oracle Fusion Middleware構成ウィザードによって、選択したWebCenter Portalコンポーネントをホストする管理対象サーバーがドメインに自動的に作成されます。

関連項目:
Oracle WebCenter Portalインストレーション・ガイド

12.2.1.1 ディスカッション・サーバー: 高可用性インストール

注意:
クラスタ化キャッシュを有効にしていると、ディスカッション・コンテンツへの更新がすぐにはリフレッシュされなくなります。ユーザーは、「リフレッシュ」アイコンをクリックして、いつでも手動リフレッシュを強制実行できます。

WebCenter Portalのディスカッション・サーバーを高可用性に対応するように設定するには:

1. クラスタ化された環境にWC_Collaborationドメインをインストールします。

2. 次のURL書式を使用して管理者としてディスカッション・サーバー管理コンソールにログオンします。http://host:port/owc_discussions/admin

3. 「キャッシュ設定」ページのキャッシュ機能セクションに移動し、クラスタリングを有効化します(図12-1)。

注意:
詳細は、『Oracle WebCenter Portalエンタープライズ・デプロイメント・ガイド』のマルチキャストからユニキャストへのディスカッションの変換およびディスカッション・サーバーでのクラスタリングの構成に関する項を参照してください。高可用性ガイドのディスカッション・サーバーのクラスタリングの構成に関する項も参照してください。

図12-1 キャッシュ機能: クラスタリング

12.2.2 ディスカッション・サーバー: 構成

注意:
新規またはパッチ適用済のWebCenter Portalインスタンスでは、割り当てられたセキュリティ/ポリシーの構成は、セキュリティ・ポリシーなしに設定されます。Oracle Web Services Manager (OWSM)のセキュリティ・ポリシーを、WebCenter PortalのWebサービス・エンドポイントおよびディスカッションの認証Webサービス・エンドポイントに添付する必要があります。
詳細は、第36.1.3.1項「WebCenter PortalおよびディスカッションWebサービス・エンドポイントに対するセキュリティ・ポリシーの添付」を参照してください。

ディスカッション・サーバーを構成するための多数のWLSTコマンドがあります。

表12-1で説明されているように、次のWLSTコマンドを使用して、WebCenter Portalのディスカッション・サーバーのシステム・プロパティを表示、設定および削除できます。

注意:
syncDiscussionServerPermissionsなどの、ディスカッション・サーバーのWLSTコマンドを実行するには、管理サーバーに接続するユーザーは、ディスカッション・サーバーの管理権限も同時に所持している必要があります。
WLSTコマンドの詳細は、『WebLogic Scripting Toolコマンド・リファレンス』の「WebCenter PortalのカスタムWLSTコマンド」のディスカッションおよびお知らせに関する項を参照してください。

表12-1 ディスカッション・サーバーのWLSTコマンド

WLSTコマンド

用途

詳細

getDiscussionsServerProperty

ディスカッション・サーバーのプロパティ値を返します

『WebLogic Scripting Toolコマンド・リファレンス』のgetDiscussionsServerPropertyに関する項を参照してください。

setDiscussionsServerProperty

ディスカッション・サーバーのプロパティを設定します

『WebLogic Scripting Toolコマンド・リファレンス』のsetDiscussionsServerPropertyに関する項を参照してください。

removeDiscussionsServerProperty

現在設定されているディスカッション・サーバーのプロパティ値を削除します

『WebLogic Scripting Toolコマンド・リファレンス』のremoveDiscussionsServerPropertyに関する項を参照してください。

addDiscussionsServerAdmin

ディスカッション・サーバーのシステム管理者権限をユーザーまたはグループに付与します

このコマンドは、現在の管理者を含まない新規のアイデンティティ・ストアにディスカッション・サーバーを接続するときに便利です。

『WebLogic Scripting Toolコマンド・リファレンス』のaddDiscussionsServerAdminに関する項を参照してください。

syncDiscussionServerPermissions

(WebCenter Portalのみ)

サブポータルに対して、親に適用したディスカッション・サーバーの権限の変更を継承するようにします

ポータル階層のディスカッションまたはお知らせの権限を更新した場合、ディスカッション・サーバーの対応する権限変更はサブポータルに自動的に継承されません。

『WebLogic Scripting Toolコマンド・リファレンス』のsyncDiscussionServerPermissionsに関する項を参照してください。

12.2.3 ディスカッション・サーバー: セキュリティに関する考慮事項

- WS-Securityによって、WebCenter PortalとWebCenter Portalのディスカッション・サーバーとの間に信頼関係を確立すると、WebCenter Portalは、ユーザーの資格証明がなくてもディスカッション・サーバーにユーザー・アイデンティティ情報を渡せるようになります。
WebCenter Portalのディスカッション・サーバーのOWSM WS-Securityを構成するために、次のいずれかの手順をトポロジに応じて実行してください。

- 第36.1.3項「単純トポロジの場合のディスカッション・サーバーの構成」

- 第36.2.3項「標準トポロジの場合のディスカッション・サーバーの構成」

- 第36.3.3項「複合トポロジの場合のディスカッション・サーバーの構成」

- WebCenter Portalからディスカッション・サーバーに送信される、WebCenter Portalのディスカッション・サーバー固有のWebサービス・メッセージは暗号化されません。メッセージの機密保護のために、Secure Socket Layer (SSL)を介してディスカッション・サーバーのURLにアクセスするか、OWSMポリシーでWebサービスのエンド・ポイントを保護してください。詳細は、第35章「SSLの構成」および第36章「WS-Securityの構成」を参照してください。

- WebCenter Portalのディスカッション・サーバーはフォルトで、組込みLDAPアイデンティティ・ストアを使用するように構成されています。組込みLDAPストア内のすべてのユーザーがディスカッション・サーバーにログオンできます。また、Administratorsグループ内のすべてのユーザーがディスカッション・サーバーの管理権限を所持します。
本番環境では、第31.1項「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」の説明に従って、アイデンティティ・ストアを外部LDAPサーバーに再度関連付ける必要があります。 さらに、システム管理者アカウントを外部LDAPに移行するか(第31.4項「外部LDAPサーバーへの管理者アカウントの移行」を参照)、管理者アカウントを移行しない場合は、ディスカッション・サーバーの新しい管理者アカウントを指定するために追加の手順が必要になります(第31.4.1項「ディスカッション・サーバーの新規管理者アカウントの特定」を参照)。

- Oracle Access Manager、Oracle Single Sign-OnまたはSAMLベースのシングル・サインオンを使用したシングル・サインオン・セキュリティを利用するように、WebCenter Portalのディスカッション・サーバーを構成できます。

注意:
SSOの構成後は、ディスカッション・サーバーへの直接のログインはサポートされません。Oracle HTTP Server URLからログインします。

詳細は、第33章「シングル・サインオンの構成」を参照してください。 Oracle Access Manager (OAM)に関する、ディスカッション固有の追加構成の手順については、第33章の「SSO用のディスカッション・サーバーの構成」を参照してください。

注意:
WebCenter Portalをソース・アプリケーションとし、WebCenter Portalのディスカッション・サーバーをターゲット・アプリケーションとして、SAMLシングル・サインオンを設定した場合は、WebCenter PortalからWebCenter Portalのディスカッション・サーバーの管理ページに次のようにアクセスできます。

- 「管理」→「ツールとサービス」
第12.11.1項「ディスカッション・サーバー管理コンソールへのアクセス」を参照してください。

- ポータル名→「設定」→「ツールとサービス」

ただし、WebCenter Portalのディスカッション・サーバーの管理ページはシングル・サインオンに参加しないため、管理ページに直接アクセスすると、ディスカッション・サーバーへの再ログインが求められます。

- ユーザー・アイデンティティ: ユーザー・アイデンティティ管理は、Oracle WebLogic ServerでカスタムのJPS認証ファクトリを使用して指定された認証プロバイダ設定によって処理されます。適切な認証ファクトリが実行されていることを調べるには、WebCenter Portalのディスカッション・サーバー管理コンソールの「システム・プロパティ」ページに移動し、次のプロパティ値を確認します。

- owc_discussions.setup.complete_11.1.1.2.0=true

- AuthFactory.className=oracle.jive.security.JpsAuthFactory
AuthFactory.classNameがこの値に設定されている場合は、owc_discussions.setup.complete_11.1.1.2.0プロパティをfalseに設定して、WebCenter Portalのディスカッション・サーバーを再起動します。それによって、適切な初期化がアプリケーションに対して実行されるようになります。

12.2.4 ディスカッション・サーバー: 制限事項

WebCenter Portalのディスカッション・サーバーURLでは、ラベルの表示に英語とスペイン語のみをサポートしていますが、UTF-8形式でのデータの入力が可能です。ディスカッション・サーバーでのユーザーの操作には、WebCenter Portal (すべてのサポート対象言語を含む)を使用することをお薦めします。ディスカッション・トピックやお知らせなどのデータで、WebCenter Portalでサポートされているすべての言語がサポートされ、ディスカッション・サーバーでも表示されます。

WebCenter PortalインスタンスがMicrosoft Windows上でネイティブ・エンコーディングで実行されている場合、ディスカッションとお知らせでは、ASCII以外のユーザー名がサポートされません。Linux環境の場合、ディスカッションとお知らせでASCII以外のユーザー名をサポートするには、WebCenter Portalがデプロイされているサーバーの環境変数LC_ALLをutf-8に設定しておく必要があります。

WebCenter Portal

ディスカッション・サーバーでユーザー権限を変更すると、予期しない動作を引き起こす可能性があるため、この変更は行わないでください。ディスカッションとお知らせのユーザー権限は常にWebCenter Portalで管理してください。詳細は、第43.4.2.2.2項「ディスカッション・サーバーのロール・マッピング」を参照してください。

12.3 ディスカッション・サーバーの登録

WebCenter Portalには複数のディスカッション・サーバー接続を登録できますが、同時にアクティブにできる接続は1つのみです。

新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

この項には次のサブセクションが含まれます:

- 第12.3.1項「Fusion Middleware Controlを使用したディスカッション・サーバーの登録」

- 第12.3.2項「WLSTを使用したディスカッション・サーバーの登録」

12.3.1 Fusion Middleware Controlを使用したディスカッション・サーバーの登録

ディスカッション・サーバーを登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、アプリケーションのホームページに移動します。
詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「ディスカッションおよびお知らせ」を選択します。

4. 新規のディスカッション・サーバーに接続するには、「追加」をクリックします(図12-2)。

図12-2 ディスカッションおよびお知らせ接続の構成

5. この接続の一意の名前を入力し、この接続をWebCenter Portalのアクティブな(またはデフォルトの)接続にするかどうかを指定します(表12-2)。

表12-2 ディスカッションおよびお知らせ接続: 名前

フィールド

説明

接続名

接続の一意の名前を入力します。

この名前は、WebCenter Portalのすべての接続タイプにおいて一意である必要があります。

アクティブな接続

これを選択すると、この接続がWebCenter Portalでディスカッションとお知らせに使用されます。

1つのアプリケーションに対して複数のディスカッション・サーバー接続を登録できますが、ディスカッションとお知らせに使用される接続はデフォルトの(またはアクティブな)接続1つのみです。

6. ディスカッション・サーバーの接続の詳細を入力します。詳細は、表12-3を参照してください。

表12-3 ディスカッションおよびお知らせ接続: 接続の詳細

フィールド

説明

サーバーURL

ディスカッション・フォーラムおよびお知らせをホストするディスカッション・サーバーのURLを入力します。

例: http://discuss-server.com:8890/owc_discussions

管理者ユーザー名

ディスカッション・サーバー管理者のユーザー名を入力します。

このアカウントは、WebCenter Portalユーザーのかわりにディスカッションおよびお知らせツールで管理操作を実行するために使用されます。

WebCenter Portalアプリケーションでは、このアカウントは、主にポータル関連のディスカッションおよびお知らせの管理を行う場合に使用されます。このユーザーは必ずしもsuper adminである必要はありません。ただし、ユーザーは、WebCenter Portalの現行のルート・カテゴリ(すべてのポータル関連ディスカッションおよびお知らせが格納されている、ディスカッション・サーバー上のカテゴリ)に対する管理権限を持っている必要があります。

注意: アプリケーションにポータル関連の機能が含まれていない場合は、管理者のユーザー名は不要です。

認証されたユーザーのWebサービス・ポリシーURI

ディスカッション・サーバーWebサービスへの認証アクセス用に、この接続で使用するポリシーを選択します。

SAML (Security Assertion Markup Language)は、認証および認可の権限を定義するセキュリティ・トークンを渡すためのXMLベースの標準です。(レシーバとの信頼関係をすでに持っている)証明エンティティは、送信者保証と呼ばれる方式によってサブジェクトの検証を保証します。

指定するクライアント・ポリシーは、ディスカッション・サーバーでOWCDiscussionsServiceAuthenticatedエンドポイントに対して構成されているサービス・ポリシーと互換性があることが必要です。初期状態では、デフォルトのサービス・ポリシーは、WSS 1.0 SAMLトークン・サービス・ポリシー(oracle/wss10_saml_token_service_policy)です。

使用可能なオプションは次のとおりです。

- WSS 1.0 SAMLトークン・クライアント・ポリシー(oracle/wss10_saml_token_client_policy)

- WSS 1.1メッセージ保護付きSAMLトークン・クライアント・ポリシー(oracle/wss11_saml_token_with_message_protection_client_policy)

- グローバル・ポリシー・アタッチメント

使用している環境でグローバル・ポリシー・アタッチメントをサポートしている場合は、WLSTコマンドdetachWebServicePolicyまたはEnterprise Managerを使用して、ディスカッション・サーバーでOWCDiscussionsServiceAuthenticatedエンドポイントにアタッチするデフォルト・ポリシーをoracle/no_authentication_client_policyに設定する必要があります。

パブリック・ユーザーのWebサービス・ポリシーURI

ディスカッション・サーバーWebサービスへのパブリック・アクセスにメッセージのセキュリティおよび整合性を強制するために、この接続で使用するクライアント・ポリシーを選択します。

指定するクライアント・ポリシーは、ディスカッション・サーバーでOWCDiscussionsServicePublicエンドポイントに対して構成されているサービス・ポリシーと互換性があることが必要です。初期状態では、パブリック・アクセスに対するサービス・ポリシーは構成されていません(「なし」)。

使用可能なオプションは次のとおりです。

- なし: これはデフォルト設定です。

- WSS 1.1メッセージ保護クライアント・ポリシー(oracle/wss11_with_message_protection_client_policy)

- グローバル・ポリシー・アタッチメント

使用している環境でグローバル・ポリシー・アタッチメントをサポートしている場合は、WLSTコマンドdetachWebServicePolicyまたはEnterprise Managerを使用して、ディスカッション・サーバーでOWCDiscussionsServicePublicエンドポイントにアタッチするデフォルト・ポリシーをoracle/no_authentication_client_policyに設定する必要があります。

受信者キーの別名

メッセージ保護付きポリシーに使用する受信者キー別名(OWCDiscussionsServicePublicエンドポイントとOWCDiscussionsServiceAuthenticatedエンドポイントに適用)を入力します。これは、構成されているキーストア内のディスカッション・サーバーの公開鍵を含む証明書の別名です。

第36章「WS-Securityの構成」も参照してください。

7. ディスカッションおよびお知らせ接続の詳細オプションを構成します(表12-4)。

表12-4 ディスカッションおよびお知らせ接続: 詳細構成

フィールド

説明

接続タイムアウト(秒)

接続の適切なタイムアウトを指定します。

これは、WebCenter Portalが接続タイムアウト・メッセージを発行するまでにディスカッション・サーバーからのレスポンスを待機する時間(秒)です。

デフォルトは、-1です。これは、サービスのデフォルトが使用されることを示します。サービスのデフォルトは10秒です。

8. ディスカッション・サーバーへの接続には、追加のパラメータ(表12-5に示すものなど)が必要になる場合があります。

表12-5 追加のディスカッション接続プロパティ

追加の
接続プロパティ

説明

application.root.category.id

(WebCenter Portalのみ)すべてのディスカッション・フォーラムを格納する、ディスカッション・サーバー上のアプリケーション・ルート・カテゴリID。たとえば、3に設定すると、すべてのフォーラムがID 3のカテゴリに格納されます。

linkURL

ディスカッション・サーバーの管理コンソールにユーザーをリンクするために使用するURL。「サーバーURL」プロパティと異なる場合にのみ、指定する必要があります(たとえば、SSOまたはHTTPSが構成されている場合)。

次の形式で代わりのパブリック外部URLを指定します: protocol://host:port

例: http://example.com:7777

ディスカッション・サーバーへの接続に追加のパラメータが必要な場合は、「追加プロパティ」を開き、必要な詳細を入力します(表12-6)。

表12-6 ディスカッションおよびお知らせ接続: 追加プロパティ

フィールド

説明

追加

「追加」をクリックして、追加の接続パラメータを指定します。

- プロパティ名: 接続プロパティの名前を入力します。

- プロパティ値: プロパティのデフォルト値を入力します。

- プロパティはセキュアか: 暗号化が必要かどうかを指定します。選択した場合、プロパティの値は、暗号化を使用してセキュアに格納されます。
たとえば、この値が実際のパスワードである場合、admin.passwordプロパティを保護するためにこのオプションを選択します。

削除

「削除」をクリックして、選択したプロパティを削除します。

「削除」をクリックする前に、正しい行を選択します。

注意: 「OK」をクリックするまで、削除された行は無効として表示されます。

9. 「OK」をクリックして、この接続を保存します。

10. 新しい(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。
詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

WebCenter Portalの場合、ディスカッションに対していくつかの追加構成を行うことをお薦めします。詳細は、第12.11項「WebCenter Portalのディスカッション・フォーラム・オプションの構成」を参照してください。

12.3.2 WLSTを使用したディスカッション・サーバーの登録

WLSTコマンドのcreateDiscussionForumConnectionを使用して、ディスカッション・サーバー接続を作成します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のcreateDiscussionForumConnectionに関する項を参照してください。

新規の接続をアクティブに使用するようにディスカッションおよびお知らせを構成するには、default=trueを設定します。

WS-Security用の追加プロパティを必ず設定します。第12.5.2項「WLSTを使用したディスカッション・サーバー接続の詳細の変更」を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
新しい(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

12.4 ディスカッションおよびお知らせ用のアクティブな接続の選択

WebCenter Portalには複数のディスカッション・サーバー接続を登録できますが、同時にアクティブにできる接続は1つのみです。アクティブな接続は、次のもののバックエンド・ディスカッション・サーバーになります。

- ディスカッション・タスク・フロー(ディスカッション・フォーラム・マネージャ、ディスカッション、ポピュラー・トピック、最近のトピック、監視フォーラム、監視トピック)

- お知らせタスク・フロー(お知らせマネージャ、お知らせ)

この項には次のサブセクションが含まれます:

- 第12.4.1項「Fusion Middleware Controlを使用したディスカッションおよびお知らせ用のアクティブな接続の選択」

- 第12.4.2項「WLSTを使用したディスカッションおよびお知らせ用のアクティブなディスカッションの選択」

12.4.1 Fusion Middleware Controlを使用したディスカッションおよびお知らせ用のアクティブな接続の選択

アクティブな接続を変更するには:

1. Fusion Middleware Controlにログインし、アプリケーションのホームページに移動します。
詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「ディスカッションおよびお知らせ」を選択します。
「ディスカッションおよびお知らせ接続の管理」表に、現在のアクティブな接続(ある場合)が示されます。

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」をクリックします。

5. 「アクティブな接続」チェック・ボックスを選択します。

6. 「OK」をクリックして、接続を更新します。

7. 新しい(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。
第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

12.4.2 WLSTを使用したディスカッションおよびお知らせ用のアクティブなディスカッションの選択

WLSTコマンドのsetDiscussionForumConnectionをdefault=trueで使用して、既存の接続をアクティブ化します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のsetDiscussionForumConnectionに関する項を参照してください。

ディスカッションおよびお知らせの接続を無効にするには、その接続を削除するか、別の接続を「アクティブな接続」にするか、またはremoveDiscussionForumServicePropertyコマンドを使用します。

removeDiscussionForumServiceProperty('appName='webcenter', property='selected.connection')

このコマンドを使用すると、接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のremoveDiscussionForumServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
新しい(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

12.5 ディスカッション・サーバー接続の詳細の変更

ディスカッション・サーバー接続の詳細はいつでも変更できます。

変更後の(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

この項には次のサブセクションが含まれます:

- 第12.5.1項「Fusion Middleware Controlを使用したディスカッション・サーバー接続の詳細の変更」

- 第12.5.2項「WLSTを使用したディスカッション・サーバー接続の詳細の変更」

12.5.1 Fusion Middleware Controlを使用したディスカッション・サーバー接続の詳細の変更

ディスカッション・サーバー接続の詳細を更新する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、アプリケーションのホームページに移動します。
詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「ディスカッションおよびお知らせ」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータの詳細は、表12-3と表12-5を参照してください。

6. 「OK」をクリックして、変更を保存します。

7. 更新された(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

12.5.2 WLSTを使用したディスカッション・サーバー接続の詳細の変更

WLSTコマンドのsetDiscussionForumConnectionを使用して、接続の詳細を編集します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のsetDiscussionForumConnectionに関する項を参照してください。

追加パラメータを設定するには、setDiscussionForumConnectionPropertyコマンドを使用します。詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のsetDiscussionForumConnectionPropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
更新された(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

12.6 ディスカッション・サーバー接続の削除

ディスカッション・サーバー接続はいつでも削除できますが、アクティブな接続を削除する際には注意が必要です。ディスカッション・タスク・フローとお知らせタスク・フローはいずれもバックエンド・ディスカッション・サーバーを必要とするため、アクティブな接続を削除すると機能しなくなります。

この項には次のサブセクションが含まれます:

- 第12.6.1項「Fusion Middleware Controlを使用したディスカッション・サーバー接続の削除」

- 第12.6.2項「WLSTを使用したディスカッション・サーバー接続の削除」

12.6.1 Fusion Middleware Controlを使用したディスカッション・サーバー接続の削除

ディスカッション・サーバー接続を削除するには:

1. Fusion Middleware Controlにログインし、アプリケーションのホームページに移動します。
詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「ディスカッションおよびお知らせ」を選択します。

4. 接続名を選択し、「削除」をクリックします。

注意:
管理対象サーバーを再起動する前に、他の接続をアクティブとして選択してください。そうしないとディスカッションおよびお知らせの機能が無効になります。

5. この変更を行うには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。
詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

12.6.2 WLSTを使用したディスカッション・サーバー接続の削除

WLSTコマンドのdeleteConnectionを使用して、接続を削除します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

別の接続がアクティブとしてマークされていることを確認します。アクティブな接続がないと、ツールが無効化されます。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
この変更を有効にするには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

12.7 ディスカッションのデフォルトの設定

WLSTコマンドのsetDiscussionForumServicePropertyを使用して、アプリケーション内のディスカッションに対するデフォルトを設定します。

- topics.fetch.size: ディスカッションによってフェッチされ、トピックのビューに表示される最大トピック数。

- forums.fetch.size: ディスカッションによってフェッチされ、フォーラムのビューに表示される最大フォーラム数。

- recentTopics.fetch.size: ディスカッションによってフェッチされ、最近のトピックのビューに表示される最大トピック数。

- watchedTopics.fetch.size: ディスカッションによってフェッチされ、監視トピックのビューに表示される最大トピック数。

- watchedForums.fetch.size: ディスカッションによってフェッチされ、監視フォーラムのビューに表示される最大フォーラム数。

- application.root.category.id: すべてのディスカッション・フォーラムを格納する、ディスカッション・サーバー上のアプリケーション・ルート・カテゴリID。たとえば、3に設定すると、すべてのフォーラムがID 3のカテゴリに格納されます。

- ForumGatewayManager.AUTO_START: Oracle WebCenter Portalでのポータルの構築のディスカッション・フォーラムでのポータル・メールの公開に関する項で説明しているように、メール配信リストによる通信をディスカッション・フォーラム投稿としてディスカッション・サーバー上で公開できます。このパラメータはこの通信のゲートウェイを起動または停止します。
WebCenter Portalの場合、デフォルト値は1 (true)です。これは、管理からメール・サーバー設定を構成するとすぐにゲートウェイが起動することを意味します。ゲートウェイを停止し、この機能を無効化するには、この値を0 (false)に設定し、管理対象サーバーを再起動します。

Portal Frameworkアプリケーションの場合、デフォルト値は0です。ゲートウェイを起動し、この機能を有効化するには、この値を1に設定し、管理対象サーバーを再起動します。

コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のsetDiscussionForumServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

12.8 お知らせのデフォルトの設定

WLSTコマンドのsetAnnouncementServicePropertyを使用して、お知らせのデフォルトを設定します。

- miniview.page_size: お知らせのクイック・ビューに表示する最大お知らせ数。

- mainview.page_size: お知らせのメイン・ビューに表示する最大お知らせ数。

- linksview.page_size: お知らせのリンク・ビューに表示する最大お知らせ数。

- announcements.expiration.days: お知らせを表示し、編集可能にする日数。

コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のsetAnnouncementServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

12.9 ディスカッション・サーバーの管理者権限の付与

WLSTコマンドaddDiscussionsServerAdminは、ディスカッション・サーバーのシステム管理者権限をユーザーまたはグループに付与します。WLSTコマンドaddDiscussionsCategoryAdminは、ディスカッション・サーバーのカテゴリ管理者権限を特定のカテゴリIDのユーザーまたはグループに付与します。

これらのコマンドは、現在の管理者を含まない新規のアイデンティティ・ストアにディスカッション・サーバーを接続するときに便利です。

コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のaddDiscussionsServerAdminに関する項およびaddDiscussionsCategoryAdminに関する項を参照してください。

12.10 ディスカッション・サーバーの管理者ロールの付与

WebCenter Portalに対して作成されるデフォルト・ドメイン管理者は、WebCenter Portalのディスカッション・サーバーの管理者でもあります。デフォルト以外のユーザーをディスカッション・サーバーの管理者にすることも可能です。

ドメインの作成時に、他の任意のユーザーをドメイン管理者として指定すると、ドメインのすべての管理権限がそのユーザーに付与されます。ただし、ドメイン作成後に、WebCenter Portalとディスカッション・サーバーの両方で、そのデフォルト以外のユーザーに管理者ロールを手動で付与する必要があります。WebCenter Portalのデフォルト以外のユーザーに管理者権限を付与する方法の詳細は、第32.5.1項「WebCenter Portal管理者ロールの付与」を参照してください。

WebCenter Portalのディスカッション・サーバーの場合、デフォルト・ユーザーはスーパー管理者です。この項では、デフォルト以外のユーザーに管理者権限を付与する方法について説明します。

12.10.1 WLSTを使用したディスカッション・サーバー管理者ロールの付与

WLSTコマンドのaddDiscussionsServerAdminでは、ディスカッション・サーバーのシステム管理者権限をユーザーまたはグループに付与できます。これは、ディスカッション・サーバーを新しいアイデンティティ・ストアに接続するときに役立ちます。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のaddDiscussionsServerAdminに関する項を参照してください。

12.10.2 管理コンソールを使用したディスカッション・サーバー管理者ロールの付与

WebCenter Portalのディスカッション・サーバーの管理者ロールをデフォルト以外のユーザーに付与するには:

1. 次のURL書式を使用して管理者としてディスカッション・サーバー管理コンソールにログオンします。http://host:port/owc_discussions/admin

2. ページの一番上にあるリンクのリストで「設定」リンクをクリックします。

3. 左側のナビゲーション・パネルで、「管理者/モデレータ」リンクが選択されていない場合は、これをクリックします。

4. 「管理者およびモデレータ」ページで、「新規権限の付与」タブをクリックします。

5. 「システム管理」チェック・ボックスを選択します。

6. 「特定のユーザー」チェック・ボックスを選択して、WebCenter Portalのディスカッション・サーバーの管理権限を付与するユーザーを指定します。

7. 「新規権限の付与」をクリックします。
これで、管理権限を割り当てたユーザーとして、WebCenter Portalのディスカッション・サーバーにログオンできるようになりました。

図12-3 WebCenter Portalのディスカッション・サーバーの管理者ロールの付与

12.10.3 ディスカッション・サーバー管理者ロールの取消し

デフォルト以外の必要なユーザーにディスカッション・サーバー管理者ロールを割り当てた後に、デフォルト・ユーザーの管理者ロールを取り消すことができます。

管理者ロールを取り消す手順は次のとおりです。

1. 管理者ロールが割り当てられたデフォルト以外のユーザーとして、ディスカッション・サーバー管理コンソールにログインします。
第12.11.1項「ディスカッション・サーバー管理コンソールへのアクセス」も参照してください。

2. ページの一番上にあるリンクのリストで「設定」リンクをクリックします。

3. 左側のナビゲーション・パネルで、「管理者/モデレータ」リンクが選択されていない場合は、これをクリックします。

4. 管理者およびモデレータ・ページの権限のサマリータブで、必要なユーザー(例: weblogic)の「システム管理」チェック・ボックスの選択を解除します(図12-4)。

図12-4 管理者ロールの取消し

5. 「変更の保存」をクリックします。
これで、WebCenter Portalのディスカッション・サーバーの管理権限がデフォルトのユーザーから取り消されました。

12.11 WebCenter Portalのディスカッション・フォーラム・オプションの構成

ディスカッション・フォーラムでは、メンバーはプロジェクトやコミュニティの目標に関連するコンテンツを取得、共有および保存できます。

注意:
この項で説明するタスクを実行するには、WebCenter PortalのAdministrator (Manage All)権限が必要です。

管理者は、WebCenter Portalの「管理」ページ(図12-5)から、アプリケーション全体に対するディスカッション・フォーラム・オプションの設定を行います。

図12-5 ディスカッション・フォーラム・オプションの設定

「ディスカッション」ページから、ディスカッション関連の設定の構成と、ディスカッション・サーバー管理ページへのアクセスを行えます。

- 第12.11.1項「ディスカッション・サーバー管理コンソールへのアクセス」

- 第12.11.2項「ディスカッションおよびお知らせを格納するディスカッション・サーバー上の場所の指定」

- 第12.11.3項「ポータル・テンプレートに保存するディスカッション・トピック数の選択」

注意:
システム管理者は、WebCenter Portalとディスカッション・サーバーとの間の接続をメンテナンスします。この接続に問題がある場合は、その問題について、システム管理者に報告してください。第12.3項「ディスカッション・サーバーの登録」も参照してください。

12.11.1 ディスカッション・サーバー管理コンソールへのアクセス

便宜性のために、ディスカッション・サーバーの管理コンソール(ディスカッション・フォーラムの構成と管理のためのWebベースのツール)には、WebCenter Portalの「管理」ページからアクセスできます。ディスカッション・サーバーの管理コンソールでは、すべてのカテゴリおよびフォーラムに移動して、それらのプロパティを編集したり、新しいカテゴリおよびフォーラムを作成することができます。また、ディスカッション・サーバーのキャッシュ、セキュリティ、およびその他の各種プロパティを設定できます。

1. WebCenter Portalの「管理」ページを開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ディスカッション」を選択します。

3. 「フォーラムの管理」をクリックします(図12-6)。

図12-6 「ディスカッション・フォーラム設定」の「フォーラムの管理」リンク

4. ログイン・ページが表示されたら、ディスカッション・サーバーの管理者ログイン資格証明を入力します。

注意:
「フォーラム管理」リンクが動作しない場合は、シングル・サインオンまたはHTTPSが構成されている可能性があります。システム管理者は、パブリックの外部URLを指定(linkURLプロパティを使用)する必要があります。

12.11.2 ディスカッションおよびお知らせを格納するディスカッション・サーバー上の場所の指定

WebCenter Portalの管理者は、WebCenter Portalのすべてのディスカッションとお知らせが格納されるディスカッション・サーバー上のルート・カテゴリを変更できます。

デフォルトのシステム・ルート・カテゴリは、ほとんどの場合で適切ですが、別の場所を選択することもできます。これは、WebCenter Portalが、複数のアプリケーションのディスカッション・フォーラムをホストしているディスカッション・サーバーに接続しているときに役立つことがあります。

推奨事項:

- WebCenter Portalに専用のカテゴリを選択してください。複数のWebCenter Portalが同一のルート・カテゴリを共有すると、競合が発生する可能性があります。

- WebCenter Portalの稼働後に、ルート・カテゴリを切り替えないでください。ルート・カテゴリを変更すると、古いルートに含まれるすべてのディスカッション・フォーラムは引き続き動作しますが、古いカテゴリに格納されたディスカッションまたはお知らせへのリンクは作成できなくなります。

既存のディスカッションは、データ・コピー・オプションで保存したポータル・テンプレートに維持できます。たとえば、WebCenter Portalの「管理」の「ツールとサービス」→「ディスカッション」ページで、テンプレートにコピーする最近のトピックと返信の数(1から25まで)を入力します。

ポータルのテンプレートは、指定したルート・カテゴリで1つまたは複数のフォーラムをサポートします。いくつかのテンプレートでは、そのテンプレートに基づいた新しいポータルごとに、ルート・カテゴリに1つのフォーラムが自動的に作成されます。

ディスカッション・フォーラムの格納場所を指定するには:

1. WebCenter Portal管理を開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ディスカッション」を選択します(図12-7)。

図12-7 ディスカッションとお知らせが格納される場所の指定

3. ディスカッションの格納に適した「ルート・カテゴリ」を指定します。
「検索」アイコンをクリックし、選択可能なカテゴリを見つけて、最適な場所を選択します。

新しいカテゴリを作成する場合は、「カテゴリの作成」をクリックします。新しいカテゴリを作成するには、ディスカッション・サーバーのシステム管理者権限が必要になります。

4. 「適用」をクリックして、設定を保存します。

12.11.3 ポータル・テンプレートに保存するディスカッション・トピック数の選択

WebCenter Portalの管理者は、ポータル・テンプレートにコピーする最近のトピックと返信の数を制限できます。大量のデータをコピーすることはパフォーマンスに影響するため、トピックまたは返信には25件までの上限があります。ポータル・テンプレートに最近のトピックまたは返信を含めないようにするには、ゼロを指定します。

1. WebCenter Portal管理を開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ディスカッション」を選択します(図12-8)。

図12-8 ポータル内のトピック数および返信数の指定

3. ポータル・テンプレートに保存する適切な「トピック」数と「返信」数を指定します。

4. 「適用」をクリックして、設定を保存します。

12.12 お知らせおよびディスカッションに関する問題のトラブルシューティング

このトラブルシューティングの項の内容は次のとおりです。

- 第12.12.1項「認証に失敗した」

- 第12.12.2項「WebCenter Portalでディスカッションを有効化できない」

- 第12.12.3項「ログインに失敗した」

- 第12.12.4項「Oracle Access Managerの構成後にログインが正しく機能しない」

- 第12.12.5項「カテゴリが見つからないという例外」

- 第12.12.6項「監視対象トピックおよび最近のトピックに複数のディスカッション・フォーラムからのトピックが表示されない」

12.12.1 認証に失敗した

問題

WebCenter Portalとバックエンド・ディスカッション・サーバー間の接続に対してWS-Securityが正しく設定されていないようです。次のエラーが表示されることがあります。

failure to authenticate the user WebLogic, due to: Authentication Failed

解決策

このエラーは様々な理由で発生する可能性があります。次のことを確認します。

- ディスカッション接続とディスカッション・サーバー間でOWSM SAMLポリシー設定が正しく定義されていることを確認します。

- WebCenter Portalのディスカッション・サービスに関連するエラーと例外について、WC_Spaces-diagnostic.logを確認します。エラーの修正に必要な十分な情報をログから得られない場合は、oracle.webcenter.collab.shareおよびoracle.webcenter.collab.forumパッケージに対してデバッグを有効にします。

- ディスカッション・サーバーについては、ドメイン内のDOMAIN_HOME/config/fmwconfig/servers/SERVER_NAME/owc_discussions/logsディレクトリにあるWC_Collaboration-diagnostics.logおよびjive.error.logを確認します。エラーを修正するための十分な情報がログから得られない場合は、ディスカッション・サーバーのデバッグを有効にします。デバッグ・ログを有効にするには、ディスカッション・サーバー管理コンソールにログオンし、ページのログに移動して「デバッグ」タブを選択し、デバッグを有効化します。WC_Collaboration管理対象サーバーを再起動すると、ロギング設定が変更されます。

- WebCenter Portalとバックエンド・ディスカッション・サーバーで時間設定が同期されていることを確認します。OWSM WS-Securityでは、これが重要です。

12.12.2 WebCenter Portalでディスカッションを有効化できない

問題

WebCenter Portalのインストール環境のどのポータルでもディスカッションを有効化できません。

解決策

このエラーは様々な理由で発生する可能性があります。次のことを確認します。

- バックエンド・ディスカッション・サーバーが稼働しており、このサーバーにアクセス可能なこと。第12.4項「ディスカッションおよびお知らせ用のアクティブな接続の選択」を参照してください。

- アクティブな接続の管理者ユーザー名(adminUser)プロパティが正しく構成され、このプロパティがアプリケーション・ルート・カテゴリ(WebCenter Portal用に構成されたカテゴリ)に対する管理権限を所持していること。第12.3項「ディスカッション・サーバーの登録」を参照してください。
このユーザーは必ずしもsuper adminである必要はありません。ただし、このユーザーは、WebCenter Portal用に構成されたアプリケーション・ルート・カテゴリ、つまりWebCenter Portalのすべてのディスカッションとお知らせを格納する(ディスカッション・サーバー上の)カテゴリの管理権限を所持している必要があります。

- WebCenter Portalのすべてのディスカッションとお知らせを格納するアプリケーション・ルート・カテゴリがバックエンド・ディスカッション・サーバー上に存在すること。
WebCenter Portal用に構成されたアプリケーション・ルート・カテゴリIDは、WebCenter Portalの「管理」に移動して、「ツールとサービス」→「ディスカッション」を選択することによって確認できます。第12.11.2項「ディスカッションおよびお知らせを格納するディスカッション・サーバー上の場所の指定」を参照してください。

12.12.3 ログインに失敗した

問題

次のログイン例外が表示されることがあります。

caught exception running task oracle.webcenter.collab.share.LoginFailedException: failure to authenticate the user monty, due to: Failed to read user monty from database.
at oracle.webcenter.collab.forum.internal.jive.JiveAuthenticator.login(JiveAuthenticator.java:213)

これは、正しくない管理ユーザー名が指定されたときに発生します。

解決策

次の手順に従ってください。

1. ディスカッション・フォーラム接続の作成時に指定された管理ユーザーがディスカッション管理コンソール(http://host:port/owc_discussions/admin)にアクセスできることを確認します。
このユーザーが管理権限を保有していない場合は、WLSTコマンドaddDiscussionsServerAdminを使用してユーザーのプロビジョニングを行います。詳細は、第12.10.1項「WLSTを使用したディスカッション・サーバー管理者ロールの付与」を参照してください。

2. 適切なDISCUSSIONSスキーマとともにディスカッション・サーバーが構成されていることを確認します。このように構成されていない場合は、config.shまたはwas_config.shを使用してドメインを作成または拡張します。

12.12.4 Oracle Access Managerの構成後にログインが正しく機能しない

問題

Oracle Access Managerシングル・サインオンを構成した後に、WebCenter Portalのディスカッション・サーバーにログインすると、500 - Internal Server Errorが発生します。

解決策

1. スーパー管理者が存在しない場合は、WLSTコマンドaddDiscussionsServerAdminを使用して、WebCenter Portalのディスカッション・サーバーでユーザーをスーパー管理者として追加します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のaddDiscussionsServerAdminに関する項を参照してください。

2. スーパー管理者アカウントを使用してディスカッション管理コンソールにログオンし、「システム」→「システム・プロパティ」に移動します。
第12.11.1項「ディスカッション・サーバー管理コンソールへのアクセス」を参照してください。

3. owc_discussions.sso.modeプロパティを作成または編集して、値をtrueに設定します。
詳細は、第33.2.6.2項「SSO用のディスカッション・サーバーの構成」を参照してください。

4. WebCenter Portalのディスカッション・サーバーを再起動します。

12.12.5 カテゴリが見つからないという例外

問題

別のディスカッション・サーバーを使用するために接続を変更した場合や、「管理」→「ツールとサービス」→「ディスカッション」からWebCenter Portalのルート・カテゴリIDを変更した場合に、「カテゴリが見つかりません。」のような例外が表示されることがあります。

解決策

WebCenter Portalがデプロイされている管理対象サーバーを再起動します。

12.12.6 監視対象トピックおよび最近のトピックに複数のディスカッション・フォーラムからのトピックが表示されない

問題

ディスカッション・サイト・テンプレートから作成されたポータルのホームページには、最近のトピックと監視トピックのワークフローが組み込まれています。デフォルトでは、これらのタスクは、どちらも1つのフォーラムの情報を表示するように構成されています。複数のフォーラムをサポートするようにポータルが構成されている場合、他のフォーラムからのトピックは、これらのタスク・フローに表示されません。

解決策

監視トピックと最近のトピックのタスク・フローを編集して、「フォーラムID」フィールドからタスク・フローのパラメータを削除します。この場合、「フォーラムID」が${sessionContext['oracle.webcenter.collab.forum'].groupInfo[portalContext.currentPortalName].forumId}に設定されています。この値を削除して、ページを保存します。

12.12.7 ディスカッションおよびお知らせの更新内容が表示されない

問題

クラスタ化キャッシュが有効化されている環境では、ディスカッションとお知らせに対するコンテンツの更新内容が、すぐにはリフレッシュされないことがあります。

解決策

「リフレッシュ」アイコンをクリックすると、いつでも手動でリフレッシュを強制実行できます。

13 カレンダ・イベントの管理

この章では、WebCenter PortalでMicrosoft Exchangeの個人の予定表を公開するためのイベントの構成および管理方法について説明します。

WebCenter PortalおよびPortal Frameworkアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後に加えた構成変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。第1.3.5項「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:
Fusion Middleware ControlまたはWLSTを使用して行ったイベントの構成変更は動的ではないため、変更を有効にするには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章には次のトピックが含まれます:

- 第13.1項「イベント接続について」

- 第13.2項「個人イベントの構成ロードマップ」

- 第13.3項「イベントの個人イベントに関する前提条件」

- 第13.4項「イベント・サーバーの登録」

- 第13.5項「アクティブなイベント・サーバー接続の選択」

- 第13.6項「イベント・サーバー接続の詳細の変更」

- 第13.7項「イベント・サーバー接続の削除」

- 第13.8項「イベント・サーバー接続のテスト」

- 第13.9項「イベントに関する問題のトラブルシューティング」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

13.1 イベント接続について

WebCenter Portalにおいて、イベントは、ミーティング、約束、およびその他のタイプのチーム、プロジェクトまたはグループの出来事をスケジュールするために使用できるポータル・カレンダを提供します。またイベントを通じて、Microsoft Exchangeの個人の予定表にアクセスし、特定のポータルに関連付けられていないイベントをここでスケジュールすることもできます。

Portal Frameworkアプリケーションでは、イベントはMicrosoft Exchangeの個人の予定表へのアクセスのみ提供します。

個人の予定表はMicrosoft Exchange Serverから提供されるため、このサーバーへの接続が必要です。Fusion Middleware ControlコンソールまたはWLSTを使用して、Microsoft Exchange Server接続を登録できます。

イベントを機能させるには、接続をアクティブとしてマークする必要があります。追加のMicrosoft Exchange Server接続を登録できますが、一度にアクティブにできる接続は1つのみです。

ユーザーがWebCenter Portalで個人イベントを表示するには、Microsoft Exchange Server上にアカウントを保有している必要があります。

13.2 個人イベントの構成ロードマップ

個人イベントへのアクセスを提供するための、構成プロセスの手順を示すガイドとして、この項のロードマップを使用してください。

- ロードマップ: WebCenter Portal用の個人イベントの構成
この項のフロー・チャート(図13-1)と表(表13-1)は、WebCenter Portalで個人イベントを動作させるために必要な前提条件とタスクの概要を示しています。

図13-1 WebCenter Portal用の個人イベントの構成

表13-1 WebCenter Portal用の個人イベントの構成

担当者

タスク

サブタスク

ノート

管理者

1. WebCenter PortalとMicrosoft Exchange Serverをインストールします

MS Exchange Serverは個人の予定表のバックエンド・コンポーネントです

- Microsoft Exchange Server 2013をインストールします(「Microsoft Exchange Server 2013: インストール」を参照)

1.a MS Exchange Server 2013を構成します(「Microsoft Exchange Server 2013: 構成」を参照)

1.b セキュリティの設定を編集します(「Microsoft Exchange Server 2013: セキュリティに関する考慮事項」を参照)

1.c SSLが有効化されていることを確認します(「Microsoft Exchange Server 2013 - セキュリティに関する考慮事項」を参照)

- Microsoft Exchange Server 2010をインストールします(「Microsoft Exchange Server 2010: インストール」を参照)

1.a MS Exchange Server 2010を構成します(「Microsoft Exchange Server 2010: 構成」を参照)

1.b セキュリティの設定を編集します(「Microsoft Exchange Server 2010: セキュリティに関する考慮事項」を参照)

1.c SSLが有効化されていることを確認します(「Microsoft Exchange Server 2010 - セキュリティに関する考慮事項」を参照)

- Microsoft Exchange Server 2007をインストールします(「Microsoft Exchange Server 2007: インストール」を参照)

1.a MS Exchange Server 2007を構成します(「Microsoft Exchange Server 2007: 構成」を参照)

1.b セキュリティの設定を編集します(「Microsoft Exchange Server 2007: セキュリティに関する考慮事項」を参照)

1.c (オプション) SSLを有効にします(「Microsoft Exchange Server 2007: セキュリティに関する考慮事項」を参照)

- Microsoft Exchange Server 2003をインストールします(「Microsoft Exchange Server 2003: インストール」を参照)

1.a WebCenter Portalの個人イベントWebサービス・プラグインをダウンロードして、インストールします(「Microsoft Exchange Server 2003: 構成」を参照)

1.b MS Exchange Server 2003を構成します(「Microsoft Exchange Server 2003: 構成」を参照)

1.c (オプション) SSLを有効にします(「Microsoft Exchange Server 2003: セキュリティに関する考慮事項」を参照)

2. 次のツールのいずれかを使用して、アプリケーションとイベント・サーバー間の接続を構成します

- Fusion Middleware Control (「Fusion Middleware Controlを使用したイベント・サーバーの登録」を参照)

- WLST (「WLSTを使用したイベント・サーバーの登録」を参照)

エンド・ユーザー

3. WebCenter Portalで個人の予定表が動作していることをテストします

3.a WebCenter Portalにログインして、ホーム・ポータル内のページにイベント・タスク・フローを追加します

3.b イベント・タスク・フローで「個人カレンダにログイン」をクリックし、MS Exchange Serverのログイン資格証明を入力します

- ロードマップ: Portal Frameworkアプリケーション用の個人イベントの構成
この項のフロー・チャート(図13-2)と表(表13-2)は、Portal Frameworkアプリケーションで個人イベントを動作させるための前提条件と必要なタスクの概要を示しています。

図13-2 Portal Frameworkアプリケーション用の個人イベントの構成

表13-2 Portal Frameworkアプリケーション用の個人イベントの構成

担当者

タスク

サブタスク

ノート

管理者

1. WebCenter PortalとMicrosoft Exchange Serverをインストールします

MS Exchange Serverは個人の予定表のバックエンド・コンポーネントです

Microsoft Exchange Server 2013をインストールします(「Microsoft Exchange Server 2013: インストール」を参照)

1.a MS Exchange Server 2013を構成します(「Microsoft Exchange Server 2013: 構成」を参照)

1.b セキュリティの設定を編集します(「Microsoft Exchange Server 2013: セキュリティに関する考慮事項」を参照)

1.c SSLが有効化されていることを確認します(「Microsoft Exchange Server 2013 - セキュリティに関する考慮事項」を参照)

Microsoft Exchange Server 2010をインストールします(「Microsoft Exchange Server 2010: インストール」を参照)

1.a MS Exchange Server 2010を構成します(「Microsoft Exchange Server 2010: 構成」を参照)

1.b セキュリティの設定を編集します(「Microsoft Exchange Server 2010: セキュリティに関する考慮事項」を参照)

1.c SSLが有効化されていることを確認します(「Microsoft Exchange Server 2010 - セキュリティに関する考慮事項」を参照)

Microsoft Exchange Server 2007をインストールします(「Microsoft Exchange Server 2007: インストール」を参照)

1.a MS Exchange Server 2007を構成します(「Microsoft Exchange Server 2007: 構成」を参照)

1.b セキュリティの設定を編集します(「Microsoft Exchange Server 2007: セキュリティに関する考慮事項」を参照)

1.c (オプション) SSLを有効にします(「Microsoft Exchange Server 2007: セキュリティに関する考慮事項」を参照)

MS Exchange Server 2003をインストールします(「Microsoft Exchange Server 2003: インストール」を参照)

1.a WebCenter Portalの個人イベントWebサービス・プラグインをダウンロードして、インストールします(「Microsoft Exchange Server 2003: 構成」を参照)

1.b MS Exchange Server 2003を構成します(「Microsoft Exchange Server 2003: 構成」を参照)

1.c (オプション) SSLを有効にします(「Microsoft Exchange Server 2003: セキュリティに関する考慮事項」を参照)

開発者

2. イベントをアプリケーションに統合します

2.a JDeveloperで、イベント・サーバーへの接続を構成します

2.b JDeveloperで、イベント・タスク・フローをページに追加します

開発者/

管理者

3. 次のツールのいずれかを使用してアプリケーションをデプロイします

- JDeveloper (開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

- WLS管理コンソール(管理者)

開発者/

管理者

4. 次のいずれかのツールを使用して接続パラメータを追加または変更します

- JDeveloper。その後アプリケーションを再デプロイします(開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

エンド・ユーザー

5. イベント・タスク・フローで「個人カレンダにログイン」をクリックし、MS Exchange Serverのログイン資格証明を入力します

13.3 イベントの個人イベントに関する前提条件

この項には次のサブセクションが含まれます:

- 第13.3.1項「Microsoft Exchange Server 2013に関する前提条件」

- 第13.3.2項「Microsoft Exchange Server 2010に関する前提条件」

- 第13.3.3項「Microsoft Exchange Server 2007に関する前提条件」

- 第13.3.4項「Microsoft Exchange Server 2003に関する前提条件」

13.3.1 Microsoft Exchange Server 2013に関する前提条件

この項では、個人イベント用のサーバーとしてMicrosoft Exchange Server 2013を使用する場合の前提条件について説明します。

この項には次のサブセクションが含まれます:

- 第13.3.1.1項「Microsoft Exchange Server 2013: インストール」

- 第13.3.1.2項「Microsoft Exchange Server 2013: 構成」

- 第13.3.1.3項「Microsoft Exchange Server 2013: セキュリティに関する考慮事項」

- 第13.3.1.4項「Microsoft Exchange Server 2013: 制限事項」

13.3.1.1 Microsoft Exchange Server 2013: インストール

インストールの詳細は、Microsoft Exchange Server 2013のドキュメントを参照してください。

13.3.1.2 Microsoft Exchange Server 2013: 構成

Microsoft Exchange Server 2013を個人イベント用のサーバーとして使用するには、Microsoft Exchange Server 2013 WebサービスのWSDLを編集してこのWebサービスの場所を指定する必要があります。

Microsoft Exchange Server 2013 Webサービスの場所を指定する手順は次のとおりです。

1. Microsoft Exchange Server WebサービスのWSDLファイルを開きます。
例:

C:\Program Files\Microsoft\Exchange Server\ClientAccess\exchweb\ews\Services.wsdl

2. Microsoft Exchange Server Webサービスを指すserviceセクションを追加します。
例:

<wsdl:definitions>
...
<wsdl:service name="ExchangeServices">
<wsdl:port name="ExchangeServicePort" binding="tns:ExchangeServiceBinding">
<soap:address location="https://server.example.com/EWS/Exchange.asmx"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

13.3.1.3 Microsoft Exchange Server 2013: セキュリティに関する考慮事項

イベントには、JAX-WSプロキシを介してMicrosoft Exchange Server 2013汎用Webサービスと通信するMicrosoft Exchange Server 2013アダプタが含まれています。アダプタとWebサービス間の通信を設定するには、Microsoft Exchange Serverのセキュリティ設定を編集する必要があります。Basic認証を有効にする必要があります。さらに、Services.wsdl、Messages.xsdおよびTypes.xsdへの匿名アクセスを有効にして、JAX-WSがWebサービス・コールのコミット前にこれらにアクセスしてサービス・ポートを作成できるようにする必要があります。この処理では、仮想ディレクトリの作成および匿名認証の有効化およびWindows認証の無効化を行います。

Microsoft Exchange Serverのセキュリティ設定を編集するには:

1. Microsoft Exchange Serverで「インターネット インフォメーション サービス (IIS) マネージャ」を開きます。

2. 「computer_name」ノード>「サイト」>「デフォルトWebサイト」>「EWS」のIISで、「認証」をダブルクリックします。

3. 「Basic認証」を右クリックして「有効」を選択し、EWSアプリケーションに対してBasic認証を有効化します。

4. 「サイト」で「デフォルトWebサイト」を右クリックして「仮想ディレクトリの追加」を選択し、Services.wsdl、Messages.xsdおよびTypes.xsdに匿名アクセスを提供するのに使用する仮想ディレクトリを作成します。

5. 「仮想ディレクトリの追加」ダイアログの「別名」フィールドで、仮想ディレクトリの名前を指定します(ExchWSなど)。

6. 「物理パス」フィールドで、仮想ディレクトリへのパスを指定します。たとえば、次のようになります(図13-5)。
C:\Program Files\Microsoft\Exchange Server\V14\ClientAccess\exchweb\ews

図13-3 仮想ディレクトリの作成

7. 「接続モード」をクリックします。

8. 「接続モード」ダイアログで、「アプリケーション・ユーザー」(パススルー認証)が選択されていることを確認します。

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

10. 「デフォルトWebサイト」>「ExchWS」のIISで「認証」をダブルクリックします。

11. 「匿名認証」を右クリックして「有効」(図13-6)を選択します。

図13-4 匿名認証の有効化

「図13-4 匿名認証の有効化」の説明

12. 「匿名認証」を右クリックして「編集」を選択します。

13. 匿名認証の資格照明の編集ダイアログで、アプリケーション・プール・アイデンティティが選択されていることを確認します。

14. 「Windows認証」を右クリックして「無効」を選択します。

イベントは、Basic認証を使用してMicrosoft Exchange Serverと通信します。通信を保護するには、SSLを有効にしてください。詳細は、次を参照してください。

http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/56bdf977-14f8-4867-9c51-34c346d48b04.mspx?mfr=true

また、IISでSSLAlwaysNegoClientCertプロパティがtrueに設定されていることを確認します。SSLAlwaysNegoClientCertプロパティは、SSLクライアント接続ネゴシエーションを制御します。

たとえば、次のコマンドを使用してSSLAlwaysNegoClientCertプロパティを設定します。

CScript.exe adsutil.vbs SET w3svc/1/SSLAlwaysNegoClientCert true

SSLAlwaysNegoClientCertプロパティの詳細は、次を参照してください。

http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/bce0fb87-79ea-40cd-963f-239545b61a12.mspx?mfr=true

SSLAlwaysNegoClientCertプロパティの設定の詳細は、次を参照してください。

https://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/d3df4bc9-0954-459a-b5e6-7a8bc462960c.mspx?mfr=true to understand how to use adsutil.vbs

13.3.1.4 Microsoft Exchange Server 2013: 制限事項

現在、既知の制限事項はありません。

13.3.2 Microsoft Exchange Server 2010に関する前提条件

この項では、個人イベント用のサーバーとしてMicrosoft Exchange Server 2010を使用する場合の前提条件について説明します。

この項には次のサブセクションが含まれます:

- 第13.3.2.1項「Microsoft Exchange Server 2010: インストール」

- 第13.3.2.2項「Microsoft Exchange Server 2010: 構成」

- 第13.3.2.3項「Microsoft Exchange Server 2010: セキュリティに関する考慮事項」

- 第13.3.2.4項「Microsoft Exchange Server 2010: 制限事項」

13.3.2.1 Microsoft Exchange Server 2010: インストール

インストールの詳細は、Microsoft Exchange Server 2010のドキュメントを参照してください。

13.3.2.2 Microsoft Exchange Server 2010: 構成

Microsoft Exchange Server 2010を個人イベント用のサーバーとして使用するには、Microsoft Exchange Server 2010 WebサービスのWSDLを編集してこのWebサービスの場所を指定する必要があります。

Microsoft Exchange Server 2010 Webサービスの場所を指定する手順は次のとおりです。

1. Microsoft Exchange Server WebサービスのWSDLファイルを開きます。
例:

C:\Program Files\Microsoft\Exchange Server\ClientAccess\exchweb\ews\Services.wsdl

2. Microsoft Exchange Server Webサービスを指すserviceセクションを追加します。
例:

<wsdl:definitions>
...
<wsdl:service name="ExchangeServices">
<wsdl:port name="ExchangeServicePort" binding="tns:ExchangeServiceBinding">
<soap:address location="https://server.example.com/EWS/Exchange.asmx"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

13.3.2.3 Microsoft Exchange Server 2010: セキュリティに関する考慮事項

イベントには、JAX-WSプロキシを介してMicrosoft Exchange Server 2010汎用Webサービスと通信するMicrosoft Exchange Server 2010アダプタが含まれています。アダプタとWebサービス間の通信を設定するには、Microsoft Exchange Serverのセキュリティ設定を編集する必要があります。Basic認証を有効にする必要があります。さらに、Services.wsdl、Messages.xsdおよびTypes.xsdへの匿名アクセスを有効にして、JAX-WSがWebサービス・コールのコミット前にこれらにアクセスしてサービス・ポートを作成できるようにする必要があります。この処理では、仮想ディレクトリの作成および匿名認証の有効化およびWindows認証の無効化を行います。

Microsoft Exchange Serverのセキュリティ設定を編集するには:

1. Microsoft Exchange Serverで「インターネット インフォメーション サービス (IIS) マネージャ」を開きます。

2. 「computer_name」ノード>「サイト」>「デフォルトWebサイト」>「EWS」のIISで、「認証」をダブルクリックします。

3. 「Basic認証」を右クリックして「有効」を選択し、EWSアプリケーションに対してBasic認証を有効化します。

4. 「サイト」で「デフォルトWebサイト」を右クリックして「仮想ディレクトリの追加」を選択し、Services.wsdl、Messages.xsdおよびTypes.xsdに匿名アクセスを提供するのに使用する仮想ディレクトリを作成します。

5. 「仮想ディレクトリの追加」ダイアログの「別名」フィールドで、仮想ディレクトリの名前を指定します(ExchWSなど)。

6. 「物理パス」フィールドで、仮想ディレクトリへのパスを指定します。たとえば、次のようになります(図13-5)。
C:\Program Files\Microsoft\Exchange Server\V14\ClientAccess\exchweb\ews

図13-5 仮想ディレクトリの作成

7. 「接続モード」をクリックします。

8. 「接続モード」ダイアログで、「アプリケーション・ユーザー」(パススルー認証)が選択されていることを確認します。

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

10. 「デフォルトWebサイト」>「ExchWS」のIISで「認証」をダブルクリックします。

11. 「匿名認証」を右クリックして「有効」(図13-6)を選択します。

図13-6 匿名認証の有効化

「図13-6 匿名認証の有効化」の説明

12. 「匿名認証」を右クリックして「編集」を選択します。

13. 匿名認証の資格照明の編集ダイアログで、アプリケーション・プール・アイデンティティが選択されていることを確認します。

14. 「Windows認証」を右クリックして「無効」を選択します。

イベントは、Basic認証を使用してMicrosoft Exchange Serverと通信します。通信を保護するには、SSLを有効にする必要があります。詳細は、次を参照してください。

http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/56bdf977-14f8-4867-9c51-34c346d48b04.mspx?mfr=true

また、IISでSSLAlwaysNegoClientCertプロパティがtrueに設定されていることを確認します。SSLAlwaysNegoClientCertプロパティは、SSLクライアント接続ネゴシエーションを制御します。

たとえば、次のコマンドを使用してSSLAlwaysNegoClientCertプロパティを設定します。

CScript.exe adsutil.vbs SET w3svc/1/SSLAlwaysNegoClientCert true

SSLAlwaysNegoClientCertプロパティの詳細は、次を参照してください。

http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/bce0fb87-79ea-40cd-963f-239545b61a12.mspx?mfr=true

SSLAlwaysNegoClientCertプロパティの設定の詳細は、次を参照してください。

https://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/d3df4bc9-0954-459a-b5e6-7a8bc462960c.mspx?mfr=true to understand how to use adsutil.vbs

13.3.2.4 Microsoft Exchange Server 2010: 制限事項

現在、既知の制限事項はありません。

13.3.3 Microsoft Exchange Server 2007に関する前提条件

この項では、個人イベント用のサーバーとしてMicrosoft Exchange Server 2007を使用する場合の前提条件について説明します。

この項には次のサブセクションが含まれます:

- 第13.3.3.1項「Microsoft Exchange Server 2007: インストール」

- 第13.3.3.2項「Microsoft Exchange Server 2007: 構成」

- 第13.3.3.3項「Microsoft Exchange Server 2007: セキュリティに関する考慮事項」

- 第13.3.3.4項「Microsoft Exchange Server 2007: 制限事項」

13.3.3.1 Microsoft Exchange Server 2007: インストール

インストールの詳細は、Microsoft Exchange Server 2007のドキュメントを参照してください。

13.3.3.2 Microsoft Exchange Server 2007: 構成

Microsoft Exchange Server 2007を個人イベント用のサーバーとして使用するには、Microsoft Exchange Server 2007 WebサービスのWSDLを編集してこのWebサービスの場所を指定する必要があります。

Microsoft Exchange Server 2007 Webサービスの場所を指定する手順は次のとおりです。

1. Microsoft Exchange Server WebサービスのWSDLファイルを開きます。
例:

C:\Program Files\Microsoft\Exchange Server\ClientAccess\exchweb\ews\Services.wsdl

2. Microsoft Exchange Server Webサービスを指すserviceセクションを追加します。
例:

<wsdl:definitions>
...
<wsdl:service name="ExchangeServices">
<wsdl:port name="ExchangeServicePort" binding="tns:ExchangeServiceBinding">
<soap:address location="https://server.example.com/EWS/Exchange.asmx"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

13.3.3.3 Microsoft Exchange Server 2007: セキュリティに関する考慮事項

イベントには、JAX-WSプロキシを介してMicrosoft Exchange Server 2007汎用Webサービスと通信するMicrosoft Exchange Server 2007アダプタが含まれています。アダプタとWebサービス間の通信を設定するには、Microsoft Exchange Serverのセキュリティ設定を編集する必要があります。

セキュリティ設定を編集するには:

1. Microsoft Exchange Serverで「インターネット インフォメーション サービス (IIS) マネージャ」を開きます。

2. 「computer_name」ノード→「Webサイト」→「既定のWebサイト」→「EWS」で、「プロパティ」をクリックします。

3. 「ディレクトリ セキュリティ」タブの「認証とアクセス制御」で「編集」をクリックします。

4. 「基本認証」を選択します。

5. 「OK」をクリックします。
Services.wsdl、Messages.vsdおよびTypes.vsdへの匿名アクセスを有効にして、JAX-WSがWebサービス・コールのコミット前にこれらにアクセスしてサービス・ポートを作成できるようにする必要があります。

6. Services.wsdlを右クリックして「編集」を選択します。

7. 「ファイル セキュリティ」タブの「認証とアクセス制御」で「編集」をクリックします。

8. 「匿名アクセスを有効にする」を選択します。

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

10. Messages.xsdとTypes.xsdに対して手順6から9を繰り返します。

イベントは、Basic認証を使用してMicrosoft Exchange Serverと通信します。通信を保護するには、SSLを有効にしてください。詳細は、次を参照してください。

http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/56bdf977-14f8-4867-9c51-34c346d48b04.mspx?mfr=true

また、IISでSSLAlwaysNegoClientCertプロパティがtrueに設定されていることを確認します。SSLAlwaysNegoClientCertプロパティは、SSLクライアント接続ネゴシエーションを制御します。

たとえば、次のコマンドを使用してSSLAlwaysNegoClientCertプロパティを設定します。

CScript.exe adsutil.vbs SET w3svc/1/SSLAlwaysNegoClientCert true

SSLAlwaysNegoClientCertプロパティの詳細は、次を参照してください。

http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/bce0fb87-79ea-40cd-963f-239545b61a12.mspx?mfr=true

SSLAlwaysNegoClientCertプロパティの設定の詳細は、次を参照してください。

https://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/d3df4bc9-0954-459a-b5e6-7a8bc462960c.mspx?mfr=true to understand how to use adsutil.vbs

13.3.3.4 Microsoft Exchange Server 2007: 制限事項

現在、既知の制限事項はありません。

13.3.4 Microsoft Exchange Server 2003に関する前提条件

この項では、個人イベント用のサーバーとしてMicrosoft Exchange Server 2003を使用する場合の前提条件について説明します。

この項には次のサブセクションが含まれます:

- 第13.3.4.1項「Microsoft Exchange Server 2003: インストール」

- 第13.3.4.2項「Microsoft Exchange Server 2003: 構成」

- 第13.3.4.3項「Microsoft Exchange Server 2003: セキュリティに関する考慮事項」

- 第13.3.4.4項「Microsoft Exchange Server 2003: 制限事項」

13.3.4.1 Microsoft Exchange Server 2003: インストール

インストールの詳細は、Microsoft Exchange Server 2003のドキュメントを参照してください。

13.3.4.2 Microsoft Exchange Server 2003: 構成

Microsoft Exchange Server 2003はWebサービスを備えていないため、Microsoft Exchange Server 2003をイベント用のサーバーとして使用するためには、IISコンピュータにWebCenter Portalの個人イベントWebサービス・プラグインをインストールする必要があります。このプラグインはOracle Fusion MiddlewareコンパニオンCDに収録されています。

個人イベントWebサービス・プラグインをインストールする手順は次のとおりです。

1. ExchangeWebService.zipの内容をインターネット・インフォメーション・サービス(IIS)サーバー内のフォルダに展開します。
このZIPファイルは、Oracle Fusion MiddlewareコンパニオンCDの次のディレクトリにあります。

/Disk1/WebCenter/services/cal/NT/ExchangeWebService.zip

注意:
ファイルを抽出するフォルダに適切な読取り権限を必ず設定してください。必要に応じて、追加の変更権限および書込み権限を持つサーバー・オペレータと認証されたユーザーを追加します。

2. 「IIS マネージャー」を開きます。

3. 「server_name」→「Webサイト」→「既定のWebサイト」で、ExchangeWSという名前の新しい仮想ディレクトリを作成します(「エイリアス」にこの名前を指定)。

4. 新しい仮想ディレクトリがZIPファイルの抽出先フォルダを指すようにします。

5. このフォルダに読取り権限とスクリプトの実行権限を必ず設定します。

6. 新しい仮想ディレクトリを右クリックして、「プロパティ」を選択します。

7. 「仮想ディレクトリ」タブの「アプリケーションの設定」で、「実行アクセス許可」ドロップダウン・リストから「スクリプトおよび実行可能ファイル」を選択します。

8. 「適用」をクリックします。

9. 「ASP.NET」タブで、「ASP.NET バージョン」が「2.0.XXXXX」になっていることを確認します。

注意:
ASP.NETがデフォルトで使用可能でない場合は、Microsoftから.NET 2.0 Frameworkをインストールしてください。

10. 「構成の編集」をクリックします。

11. 「ASP .NET構成の設定」ダイアログで、「ExchangeServerURL」の値が正しいことを確認します。
例:

http://localhost:port/Exchange/User/calendar

ヒント:
「ExchangeServerURL」では、大/小文字が区別されます。

必要に応じて、IISポート番号を反映するようにポートを変更します。デフォルトでは、これは80です。

12. 変更を適用して、ダイアログを閉じます。

13. C:\WSErrorLogsというフォルダを作成します。

14. ブラウザで次のURLにアクセスすることによって、IISサーバーとWebCenter PortalサーバーからWebサービスをテストします。

http://host:port/ExchangeWS/PersonalEventsWebService.asmx

13.3.4.3 Microsoft Exchange Server 2003: セキュリティに関する考慮事項

イベントは、Basic認証を使用してMicrosoft Exchange Serverと通信します。通信を保護するには、SSLを有効にする必要があります。詳細は、次を参照してください。

http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/56bdf977-14f8-4867-9c51-34c346d48b04.mspx?mfr=true

13.3.4.4 Microsoft Exchange Server 2003: 制限事項

現在、既知の制限事項はありません。

13.4 イベント・サーバーの登録

WebCenter Portalには複数のイベント・サーバーを登録できますが、一度にアクティブにできるサーバーは1つのみです。

新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

この項には次のサブセクションが含まれます:

- 第13.4.1項「Fusion Middleware Controlを使用したイベント・サーバーの登録」

- 第13.4.2項「WLSTを使用したイベント・サーバーの登録」

13.4.1 Fusion Middleware Controlを使用したイベント・サーバーの登録

イベント・サーバーを登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。
詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「個人イベント」を選択します。

4. 新しいイベント・サーバー・インスタンスに接続するには、「追加」をクリックします。
「個人イベント接続の追加」ページが表示されます(図13-7)。

図13-7 イベント接続の構成

5. この接続の一意の名前を入力し、Microsoft Exchange Serverのバージョンを指定して、この接続をWebCenter Portalのアクティブな(またはデフォルトの)接続にするかどうかを指定します(表13-2)。

表13-3 個人イベント接続: 名前

フィールド

説明

接続名

接続の一意の名前を入力します。この名前は、WebCenter Portalのすべての接続タイプにおいて一意である必要があります。

接続タイプ

接続先のMicrosoft Exchange Serverを選択します。

- Microsoft Exchange Server 2003

- Microsoft Exchange Server 2007

- Microsoft Exchange Server 2010

- Microsoft Exchange Server 2013

アクティブな接続

これを選択すると、この接続がWebCenter Portalでイベントに使用されます。

複数のイベント・サーバー接続を登録できますが、イベントで使用される接続はデフォルトの(またはアクティブな)接続1つのみです。

6. イベント・サーバーの接続の詳細を入力します(表13-4)。

表13-4 個人イベント: 接続の詳細

フィールド

説明

WebサービスURL

イベント・アプリケーションを公開するWebサービスのURLを入力します。

次の形式を使用します。

protocol://host:port/appWebServiceInterface/WSName

次に例を示します。

http://myexchange.com:80/ExchangeWS/PersonalEventsWebService.asmx
http://myexchange.com:80/EWS/Services.wsdl

関連付けられている外部アプリケーション

イベントを外部アプリケーションに関連付けます。外部アプリケーションの資格証明情報が、イベントをホストしているMicrosoft Exchange Serverに対してユーザーを認証するために使用されます。

7. 「OK」をクリックして、この接続を保存します。

8. 新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。
詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

13.4.2 WLSTを使用したイベント・サーバーの登録

WLSTコマンドのcreatePersonalEventConnectionを使用して、イベント・サーバー接続を作成します。既存の接続を変更するには、setPersonalEventConnectionを使用します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のcreatePersonalEventConnectionに関する項およびsetPersonalEventConnectionに関する項を参照してください。

イベント・サーバー接続では、外部アプリケーションを使用して接続します。イベント・サーバー接続を作成する前に、WLSTコマンドcreateExtAppConnectionを使用して外部アプリケーションを作成する必要があります。詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のcreateExtAppConnectionに関する項を参照してください。

たとえば、次のコマンドでは、外部アプリケーションと外部アプリケーションに接続される個人イベント接続が作成されます。Microsoft Exchange Server 2010 WebサービスWSDLは、ExchWSという仮想ディレクトリを介してアクセスされます。

createExtAppConnection(appName='webcenter', name='xApp_PE', url='https://server.example.com/owa', authMethod='BASIC')
createPersonalEventConnection(appName='webcenter', 'name=MSExchange-2010', webServiceUrl='http://server.example.com/ExchWS/Services.wsdl', adapterName='MSEx2010', appId='xApp_PE')

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

13.5 アクティブなイベント・サーバー接続の選択

WebCenter Portalには複数のイベント・サーバー接続を登録できますが、一度にアクティブにできる接続は1つのみです。

この項には次のサブセクションが含まれます:

- 第13.5.1項「Fusion Middleware Controlを使用したアクティブなイベント・サーバーの選択」

- 第13.5.2項「WLSTを使用したアクティブなイベント・サーバー接続の選択」

13.5.1 Fusion Middleware Controlを使用したアクティブなイベント・サーバーの選択

アクティブな接続を変更するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。
詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「個人イベント」を選択します。
「個人イベント接続の管理」表に、現在のアクティブな接続(ある場合)が示されます(図13-8)。

図13-8 個人イベント用のアクティブな接続

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」をクリックします。

5. 「アクティブな接続」チェック・ボックスを選択します。

6. 「OK」をクリックして、接続を更新します。

7. 新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。
詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

13.5.2 WLSTを使用したアクティブなイベント・サーバー接続の選択

WLSTコマンドのsetPersonalEventConnectionをdefault=trueで使用して、既存のイベント・サーバー接続をアクティブ化します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のsetPersonalEventConnectionに関する項を参照してください。

その後、イベント接続を無効化するには、default=falseと指定して同じWLSTコマンドを実行します。接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
アクティブな接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

13.6 イベント・サーバー接続の詳細の変更

イベント・サーバー接続の詳細はいつでも変更できます。

更新された(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

この項には次のサブセクションが含まれます:

- 第13.6.1項「Fusion Middleware Controlを使用したイベント・サーバー接続の詳細の変更」

- 第13.6.2項「WLSTを使用したイベント・サーバー接続の詳細の変更」

13.6.1 Fusion Middleware Controlを使用したイベント・サーバー接続の詳細の変更

イベント・サーバー接続の詳細を更新する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「個人イベント」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。
パラメータ情報の詳細は、表13-4を参照してください。

6. 「OK」をクリックして、変更を保存します。

7. 更新された(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。
詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

13.6.2 WLSTを使用したイベント・サーバー接続の詳細の変更

WLSTコマンドのsetPersonalEventConnectionを使用して、既存のイベント・サーバー接続を編集します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のsetPersonalEventConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
更新された(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

13.7 イベント・サーバー接続の削除

イベント・サーバー接続はいつでも削除できますが、アクティブな接続を削除する際は注意が必要です。アクティブな接続を削除すると、ユーザーが個人の予定表にイベントを作成できなくなります。

この項には次のサブセクションが含まれます:

- 第13.7.1項「Fusion Middleware Controlを使用したイベント・サーバー接続の削除」

- 第13.7.2項「WLSTを使用したイベント・サーバー接続の削除」

13.7.1 Fusion Middleware Controlを使用したイベント・サーバー接続の削除

イベント・サーバー接続を削除するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。
詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのリストから、「個人イベント」を選択します。

4. 接続名を選択し、「削除」をクリックします。

注意:
管理対象サーバーを再起動する前に、他の接続をアクティブとして選択してください。そうしないとサービスが無効になります。

5. この変更を行うには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。
詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

13.7.2 WLSTを使用したイベント・サーバー接続の削除

WLSTコマンドのdeleteConnectionを使用して、イベント・サーバーの接続を削除します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
この変更を有効にするには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

13.8 イベント・サーバー接続のテスト

イベント・サーバーへの接続を確認するには:

1. WebCenter Portalのページにイベント・タスク・フローを追加します。

ヒント:
WebCenter Portalでは、ホーム・ポータルのページにタスク・フローを追加します。Oracle WebCenter Portalでのポータルの構築のページへのイベント・タスク・フローの追加に関する項を参照してください。

2. 「個人イベント」をクリックして、「個人カレンダにログイン」をクリックします。

3. Microsoft Exchange Serverのログイン資格証明を入力します。
Microsoft Exchange Serverからの個人イベントがタスク・フローに表示されます。

13.9 イベントに関する問題のトラブルシューティング

ユーザーが個人イベントを表示できない場合は、次の点を確認します。

- WebCenter Portalがデプロイされている管理対象サーバーからMicrosoft Exchange Server/IISサーバーにアクセスできますか。これらは互いにping可能ですか。

- Microsoft Exchange Server上の構成に誤りはありませんか。詳細は、第13.3.3.2項「Microsoft Exchange Server 2007: 構成」または第13.3.4.2項「Microsoft Exchange Server 2003: 構成」を参照してください。

- 管理対象サーバーでのイベント・サーバー接続に誤りはありませんか。詳細は、第13.4項「イベント・サーバーの登録」を参照してください。

- ユーザーはMicrosoft Exchange Server上のアカウントのユーザー名とパスワードを正しく入力しましたか。ユーザー名は通常、電子メール・アドレスです。

- Microsoft Exchange Serveに対してSSLが有効化されている場合、SSLAlwaysNegoClientCerプロパティはtrueに設定されていますか。詳細は、この章で指定されている、お使いのExchange Serverバージョンのセキュリティに関する考慮事項を参照してください。

14 インスタント・メッセージおよびプレゼンスの管理

この章では、WebCenter PortalおよびPortal Frameworkアプリケーションのインスタント・メッセージおよびプレゼンスを構成および管理する方法について説明します。

WebCenter PortalおよびPortal Frameworkアプリケーションのバックエンドのツールとサービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後にアプリケーションに加えた変更はすべて、MDSメタデータ・ストアにカスタマイズとして格納されます。第1.3.5項「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:
Fusion Middleware ControlまたはWLSTを使用して行ったインスタント・メッセージおよびプレゼンスの構成変更は動的ではないため、変更を有効にするには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章には次のトピックが含まれます:

- 第14.1項「インスタント・メッセージおよびプレゼンス接続について」

- 第14.2項「インスタント・メッセージおよびプレゼンス・サーバーの前提条件」

- 第14.3項「インスタント・メッセージおよびプレゼンス・サーバーの登録」

- 第14.4項「インスタント・メッセージおよびプレゼンス用のアクティブな接続の選択」

- 第14.5項「インスタント・メッセージおよびプレゼンス接続の詳細の変更」

- 第14.6項「インスタント・メッセージおよびプレゼンス接続の削除」

- 第14.7項「インスタント・メッセージおよびプレゼンスのデフォルトの設定」

- 第14.8項「インスタント・メッセージおよびプレゼンス接続のテスト」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

14.1 インスタント・メッセージおよびプレゼンス接続について

インスタント・メッセージおよびプレゼンス(IMP)を使用すると、認証された他のアプリケーション・ユーザーのプレゼンス・ステータス(オンライン、オフライン、ビジーまたは退席中)を確認して、インスタント・メッセージ(IM)やメールなどの対話オプションに簡単にアクセスできます。

バックエンド・プレゼンス・サーバーへの単一の接続が必要です。WebCenter Portalは、Microsoft Office Live Communications Server (LCS) 2005、Microsoft Office Communications Server (OCS) 2007およびMicrosoft Lync 2010での動作が保証されています。

注意:
Oracle Beehive Server接続は、このリリースではサポートされていません。

アプリケーションのプレゼンス・サーバー接続は、Fusion Middleware ControlまたはWLSTを使用して登録できます。IMPを機能させるには、接続をアクティブとしてマークする必要があります。追加のプレゼンス・サーバー接続を登録できますが、一度にアクティブにできる接続は1つのみです。

14.2 インスタント・メッセージおよびプレゼンス・サーバーの前提条件

この項には次のサブセクションが含まれます:

- 第14.2.1項「Microsoft Live Communications Server (LCS)の前提条件」

- 第14.2.2項「Microsoft Office Communications Server (OCS)の前提条件」

- 第14.2.3項「Microsoft Lyncの前提条件」

14.2.1 Microsoft Live Communications Server (LCS)の前提条件

この項では、Microsoft Live Communications Server 2005 (LCS)をインスタント・メッセージおよびプレゼンスのプレゼンス・サーバーとして使用するための前提条件を示します。

この項には次のサブセクションが含まれます:

- 第14.2.1.1項「Microsoft LCS: インストール」

- 第14.2.1.2項「Microsoft LCS: 構成」

- 第14.2.1.3項「Microsoft LCS: セキュリティに関する考慮事項」

14.2.1.1 Microsoft LCS: インストール

インストールの詳細は、Microsoft Live Communications Server 2005のドキュメントを参照してください。

14.2.1.2 Microsoft LCS: 構成

Microsoft Live Communications Server 2005をインスタント・メッセージおよびプレゼンスのプレゼンス・サーバーとして使用するには、Microsoft RTC API v1.3をインストールして構成し、Microsoft LCS 2005用のOracle RTC Webサービスをインストールする必要があります。

1. Microsoft RTC API v1.3をインストールするには、Microsoft RTC Client API SDK 1.3からRTC SDKをダウンロードして、インストーラを実行します。インストーラにより必要なインストール・コンポーネントが用意されます。デフォルトのオプションを選択した場合、次の2つのインストーラがC:\Program Files\RTC Client API v1.3 SDK\INSTALLATIONに保存されています。

- RtcApiSetup.msi

- RtcSxSPolicies.msi

RtcApiSetup.msiインストーラ、並列ポリシー・スイッチャのインストーラ(RtcSxSPolicies.msi)の順に実行したら、システムを再起動します。

2. Microsoft Live Communications Server 2005用のOracle RTC Webサービスをインストールするには、Oracle Fusion MiddlewareコンパニオンCDからowc_lcs.zipファイルを解凍します。このファイルは、ディレクトリ/Disk1/WebCenter/services/imp/NTにあります。圧縮ファイルには、次のファイルが含まれています。
/Bin

/images

ApplicationConfigurationService.asmx

BlafPlus.css

ExtAppLogin.aspx

ExtAppLogin.aspx.cs

Global.asax

Log4Net.config

RTCService.asmx

Web.Config

WebcenterTemplate.master

3. インターネット インフォメーション サービス(IIS)マネージャを開きます。

4. 「IIS マネージャー」ウィンドウでサーバー・ノードを開き、「Webサイト」を開きます。

5. 「既定のWebサイト」を右クリックして「新規」→「仮想ディレクトリ」を選択し、Oracle RTC Webサービス用のサイトを作成します(図14-1)。

図14-1 仮想ディレクトリの作成

仮想ディレクトリの作成ウィザードが表示されます。

6. 「次へ」をクリックします。

7. 「エイリアス」フィールドに仮想ディレクトリの別名(たとえば、RTC)を入力します。

8. owc_lcs.zipファイルを抽出したディレクトリのパスを入力します。あるいは、「参照」ボタンを使用して、そのディレクトリにナビゲートします。

9. 「次へ」をクリックします。

10. 仮想ディレクトリで、「読取り」、「実行」、「参照」権限があることを確認します。(図14-2)

図14-2 仮想ディレクトリのプロパティ

11. 「次へ」をクリックします。

12. 「完了」をクリックします。
「IISマネージャー」ウィンドウの「既定のWebサイト」の下に、新しく作成した仮想ディレクトリが表示されます(図14-3)。

図14-3 仮想ディレクトリの追加

13. Oracle RTC Webサービス用に新しく作成した仮想ディレクトリを右クリックし、「プロパティ」を選択して「プロパティ」ダイアログを開きます。

14. 「仮想ディレクトリ」タブの「アプリケーションの設定」で、「作成」をクリックします。
ボタンのラベルが「削除」に変わり、新しく作成した仮想ディレクトリが「アプリケーション名」フィールドに表示されています。

15. 「実行アクセス許可」ドロップダウン・リストから「スクリプトおよび実行可能ファイル」を選択します(図14-4)。

図14-4 仮想ディレクトリのプロパティ

16. 「ASP.NET」タブで、「ASP.NETバージョン」ドロップダウン・リストから2.0以上のASP.NETバージョンを選択します。
ASP.NET 2.0アプリケーションを利用するようにIISを構成します。

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

18. LCS接続内のLSCプール名が設定されていることを確認します。

19. 次のURL書式を使用してWebサイトにアクセスすることで、Webサービスをテストします。

http://localhost/default_website/ApplicationConfigurationService.asmx

default_websiteは、Oracle RTC Webサービス用に作成した仮想ディレクトリです。

例:

http://localhost/RTC/ApplicationConfigurationService.asmx

14.2.1.3 Microsoft LCS: セキュリティに関する考慮事項

ユーザーが資格証明を提供してLCSサーバーに対して自分を認証できるように、Microsoft Live Communications Server接続用の外部アプリケーションを構成する必要があります。

保護されたアプリケーションでは、ユーザーがプレゼンス・ステータスを取得できます。LCSでは、セキュリティが必要な場合、信頼できるプライベート・ネットワーク上にLCSが存在する必要があります。

LCSには、外部資格情報を変更するためのオプションが用意されています。これは、外部アプリケーションを使用するかわりになります。ログインしたユーザーは、「プレゼンス」タグをクリックし、メニューから「資格情報の変更」を選択できます。

詳細は、第14.3.1項「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録」を参照してください。

14.2.2 Microsoft Office Communications Server (OCS)の前提条件

この項では、Microsoft Office Communications Server 2007 (OCS)をインスタント・メッセージおよびプレゼンスのプレゼンス・サーバーとして使用するための前提条件を示します。

この項には次のサブセクションが含まれます:

- 第14.2.2.1項「Microsoft OCS: インストール」

- 第14.2.2.2項「Microsoft OCS: 構成」

- 第14.2.2.3項「Microsoft OCS: セキュリティに関する考慮事項」

14.2.2.1 Microsoft OCS: インストール

インストールの詳細は、Microsoft Office Communications Server 2007のドキュメントを参照してください。

14.2.2.2 Microsoft OCS: 構成

この項には次のサブセクションが含まれます:

- 第14.2.2.2.1項「シンプル・デプロイ」

- 第14.2.2.2.2項「リモート・デプロイ」

- 第14.2.2.2.3項「Application Provisionerの構築」

- 第14.2.2.2.4項「OCSサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニング」

- 第14.2.2.2.5項「IISサーバーの構成」

- 第14.2.2.2.6項「UCMA v2.0のインストール」

- 第14.2.2.2.7項「WebCenter PortalのProxyアプリケーションのインストール」

Microsoft OCS 2007をIMPのプレゼンス・サーバーとして使用するには、Microsoft OCS 2007用のWebCenter PortalのProxyアプリケーションを、次のいずれかのトポロジでデプロイする必要があります。

- シンプル・デプロイ: すべてのコンポーネントが同じボックスに存在します。

- リモート・デプロイ: プロキシ・アプリケーションとMicrosoft OCSが別々のボックスに存在します。

14.2.2.2.1 シンプル・デプロイ

このトポロジでは、OCSボックス上にホストされているInternet Information Services (IIS)サーバーにWebCenter PortalのProxyアプリケーションをデプロイします。

1. Microsoft Unified Communications Managed API (UCMA) 2.0をOCSボックスにインストールします。
詳細は、第14.2.2.2.6項「UCMA v2.0のインストール」を参照してください。

2. WebCenter PortalのProxyアプリケーションのIISサーバー上でのデプロイ
このプロキシ・アプリケーションは、OCSサーバーとのやり取り、および情報の送受信のためのWebサービスを提供します。WebCenter PortalはこれらのWebサービスと通信し、データを表示します。

詳細は、第14.2.2.2.7項「WebCenter PortalのProxyアプリケーションのインストール」を参照してください。

14.2.2.2.2 リモート・デプロイ

このトポロジでは、OCSボックスに対してリモートであるIISサーバーにWebCenter PortalのProxyアプリケーションをデプロイします。つまり、IISサーバーとOCSサーバーが別々のマシン上にホストされます。

このプロキシ・アプリケーションはリモート・ボックス上にホストされるため、アプリケーションとOCSサーバーの間に信頼関係を設定する必要があります。これは、アプリケーションのプロビジョニングと呼ばれます。プロビジョニングは、Microsoft UCMA v2.0に付属のApplication Provisionerユーティリティを使用して行います。詳細は、http://msdn.microsoft.com/en-us/library/dd253360%28office.13%29.aspxを参照してください。

図14-5に、様々なデプロイ・エンティティで実行される手順(UCMA v2.0のインストールを含む)の概要を示します。

図14-5 Microsoft OCSの構成: リモート・デプロイ

これらの手順の詳細は、次の項で説明します。

14.2.2.2.3 Application Provisionerの構築

この項では、OCSにアクセスする他のIISサーバーをプロビジョニングするための、Microsoft社による手順を示します。

1. Visual Studio 2008を任意の開発者ボックスにインストールします(必ずしもIIS/OCSである必要はありません)。

2. 第14.2.2.2.6項「UCMA v2.0のインストール」の手順に従って、UCMAバージョン2.0を同じボックスにインストールします。
Application Provisionerアプリケーションは、UCMA SDKに付属しています。

3. UCMA Coreをインストールした場所(たとえば、C:\Program Files\Microsoft Office Communications Server 2007 R2\UCMA SDK 2.0\UCMACore\Sample Applications\Collaboration\ApplicationProvisionerなど)の下にあるディレクトリSample Applications\Collaboration\ApplicationProvisionerへ移動します。
このディレクトリにはApplication Provisionerアプリケーションが格納されています。

4. Visual Studio 2008を使用してアプリケーションを構築します。
これにより、ApplicationProvisioner.exeファイルが生成されます。

5. この実行可能ファイルをOCSボックスにコピーします。

14.2.2.2.4 OCSサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニング

1. UCMA v2.0のコア・ライブラリをOCSボックスにインストールします。
第14.2.2.2.6項「UCMA v2.0のインストール」の手順に従ってください。ただし、Visual C++ 2008の再頒布可能ファイルのインストール後にOCSCore.msiを実行してください。

これにより、アプリケーションのプロビジョニングに必要なWMIクラスがインストールされます。

2. 前の項で生成されたApplicationProvisioner.exeファイルを実行します。
「Application Provisioner」ダイアログが表示されます。

3. 「Application Provisioner」ダイアログで、「アプリケーション名」にアプリケーション名としてWebCenterProxyApplicationと入力し、「検索または作成」をクリックします。

4. 「アプリケーション プールを作成します。」ダイアログの「OCS Pool Fqdn」の一覧で、使用するアプリケーションのOffice Communications Serverプールを選択します。

- 「リッスンするポート」にアプリケーションのリスニング・ポートを入力します(例: 6001)。

- 「アプリケーション サーバーFqdn」に、アプリケーションをデプロイするコンピュータの完全修飾ドメイン名(FQDN)を入力します。(これはIISボックスです。)

- アプリケーションを複数のコンピュータにデプロイする場合、「負荷分散アプリケーション」チェック・ボックスを選択し、「ロード バランサーFqdn」にロード・バランサのFQDNを入力します。

アプリケーション・プールは、「Application Provisioner」ダイアログに表示されます。

5. サーバーのエントリをダブルクリックします。
「サーバーの表示」ダイアログが表示されます。そこに表示される情報は、サーバーのFQDN、ポート、GRUUです。

6. OCSサーバーでOffice Communications Server Certificateウィザードを使用して、前の手順で書き留めておいたサーバーFQDNをサブジェクト名として証明書を作成します。
この証明書は、IISサーバーからの要求の認可に使用されます。

7. 証明書が作成されたら、証明書を表示します。

8. 「詳細」タブで、「ファイルにコピー」をクリックします。
証明書のエクスポート・ウィザードが表示されます。

9. 秘密鍵を使用して、証明書をファイルにエクスポートします。
証明書の名前が付いた.pfx (Personal Information Exchange)ファイルが生成されます。

14.2.2.2.5 IISサーバーの構成

リモート・デプロイのシナリオでは、IISサーバーはWebCenter PortalのProxyアプリケーションをホストするため、前の項の情報を使用して、IISを信頼された認証局にしてください。

1. 秘密鍵を使用してOCSサーバーによって発行された証明書をインストールします。OCSサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニングの手順7で生成した.pfxファイルをIISボックスにコピーし、それをダブルクリックします。
証明書のインポート・ウィザードが表示されます。

2. LOCAL_MACHINEの下の個人用フォルダに証明書をインポートします。

3. 証明書を読み取るための権限をIIS_WPGユーザーに付与します。
これは、証明書に対する適切な読取りアクセス権をIISサーバーに与えるために必要な作業です。これを行うために、Microsoft社が提供するWindows HTTP Services Certificate Configuration Tool (http://www.microsoft.com/downloads/details.aspx?familyid=c42e27ac-3409-40e9-8667-c748e422833f&displaylang=en)というユーティリティを使用できます。このユーティリティをダウンロードしてインストールしてください。インストールすると、winhttpcertcfg.exeという実行可能ファイルが作成されます。インストールした場所に移動し、次のコマンドを実行して権限を付与します。

winhttpcertcfg.exe -g -c LOCAL_MACHINE\MY -s "<certificate-name>" -a "IIS_WPG"

4. C:/WINDOWS/system32/drivers/etc/hostsにOCSサーバーのプール名のエントリを次の形式で作成します。

<ip-address-of-ocs-box> <poolname-of-ocs-box>

例:

10.177.252.146 pool01.example.com

5. IISサーバーはWebCenter PortalのProxyアプリケーションをホストするため、IISサーバーにMicrosoft UCMA v2.0をインストールします。
詳細は、第14.2.2.2.6項「UCMA v2.0のインストール」を参照してください。

6. UCMAをインストールしたら、プロキシ・アプリケーションをIISサーバー上にデプロイします。
WebCenter PortalのProxyアプリケーションは、OCSサーバーとのやり取り、および情報の送受信のためのWebサービスを提供します。WebCenter PortalはこれらのWebサービスと通信し、データを表示します。

詳細は、第14.2.2.2.7項「WebCenter PortalのProxyアプリケーションのインストール」を参照してください。

7. WebCenter PortalのProxyアプリケーションが抽出された場所に移動して、Web.configを開き、appSettings XMLノードを編集して、前の項の手順7で書き留めておいた値を追加します。
RemoteDeploymentの値がtrueに設定されていることを確認してください。

たとえば、appsettings XMLノードは次のように表示されます。

<appSettings>
<add key="ApplicationName" value="WebCenterProxyApplication"/>
<add key="RemoteDeployment" value="true"/>
<add key="ApplicationFQDN" value="iis.server.com"/>
<add key="ApplicationGRUU" value="sip:iis.server.com@EXAMPLE.COM;gruu;opaque=srvr:WebCenterProxyApplication:7mhSo94PlUK-5Q2bKPLyMAAA"/>
<add key="ApplicationPort" value="6001"/>
</appSettings>

信頼関係が確立され、WebCenter PortalのProxyアプリケーションがOCSと対話できるようになりました。

14.2.2.2.6 UCMA v2.0のインストール

Microsoft Unified Communications Managed API v2.0 (UCMA)は、OCS環境と対話可能なサーバー・アプリケーションを上級開発者が構築できるエンドポイントAPIです。

シンプル・デプロイでは、UCMAがOCSと同じボックスにインストールされます。リモート・デプロイでは、OCSコア・ライブラリはOCSボックスにインストールされ、UCMAはIIS(プロキシ)ボックスにインストールされます。

1. UCMA v2.0を次の場所からダウンロードします。

- OCS2007 R2インストール用(64ビット): http://www.microsoft.com/downloads/details.aspx?FamilyID=b20967b1-6cf5-4a4b-b7ae-622653ac929f&displaylang=en
UcmaSDKWebDownload.msiファイルをダウンロードして実行します。これにより、フォルダC:\Microsoft Unified Communications Managed API 2.0 SDK Installer package\amd64にファイルが抽出されます。

2. (前の手順でファイルが抽出された)ディレクトリに移動しvcredist_x86.exeを実行します。
この手順により、UCMA APIに必要なVisual C++ライブラリのランタイム・コンポーネントがインストールされます。

3. ディレクトリSetupに移動し、UcmaRedist.msiを実行します。
この手順により、GACのUCMA 2.0アセンブリがインストールされます。

14.2.2.2.7 WebCenter PortalのProxyアプリケーションのインストール

1. コンパニオンCDからowc_ocs2007.zipを抽出します。
OCSWebServicesという名前のディレクトリが作成されます。

2. インターネット インフォメーション サービス(IIS)マネージャを開きます。

3. インターネット インフォメーション サービス (IIS) マネージャでサーバー・ノードを開き、「Webサイト」を開きます。

4. 「既定のWebサイト」を右クリックして「新規」→「仮想ディレクトリ」を選択し、Oracle RTC Webサービス用のサイトを作成します。
仮想ディレクトリの作成ウィザードが表示されます。

5. 「次へ」をクリックします。

6. 「エイリアス」フィールドに仮想ディレクトリの別名(たとえば、RTC)を入力します。

7. owc_ocs2007.zipファイルから抽出されたディレクトリのパスを入力します。
このzipファイルを「C:\」に抽出した場合、パスには「C:\OCSWebServices」を指定します。または、「参照」ボタンをクリックして、当該ディレクトリに移動します。

8. 「次へ」をクリックします。

9. 仮想ディレクトリで、「読取り」、「実行」、「参照」権限があることを確認します。

10. 「次へ」をクリックします。

11. 「完了」をクリックします。
「IIS マネージャー」ウィンドウの「既定のWebサイト」の下に、新しく作成した仮想ディレクトリが表示されます。

12. Oracle RTC Webサービス用に新しく作成した仮想ディレクトリを右クリックし、「プロパティ」を選択して「プロパティ」ダイアログを開きます。

13. 「仮想ディレクトリ」タブの「アプリケーションの設定」で、「作成」をクリックします。
ボタンのラベルが「削除」に変わり、新しく作成した仮想ディレクトリの名前が「アプリケーション名」フィールドに表示されています。

14. 「実行アクセス許可」ドロップダウン・リストから「スクリプトおよび実行可能ファイル」を選択します。

15. 「ASP.NET」タブで、「ASP.NETバージョン」ドロップダウン・リストから2.0以上のASP.NETバージョンを選択します。
IISはASP.NET 2.0アプリケーションを消費するように構成されます。

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

17. 次のURL書式を使用してWebサイトにアクセスすることで、Webサービスをテストします。http://localhost/default_website/OCSWebService.asmx
default_websiteは、Oracle RTC Webサービス用に作成した仮想ディレクトリです。

例:

http://localhost/RTC/OCSWebService.asmx

14.2.2.3 Microsoft OCS: セキュリティに関する考慮事項

ユーザーが資格証明を提供してOCSサーバーに対して自分を認証できるように、Microsoft Office Communications Server接続用の外部アプリケーションを構成する必要があります。

保護されたアプリケーションでは、ユーザーがプレゼンス・ステータスを取得できます。OCSでは、セキュリティが必要な場合、信頼できるプライベート・ネットワーク上にOCSが存在する必要があります。

OCSには、外部資格情報を変更するためのオプションが用意されています。これは、外部アプリケーションを使用するかわりになります。ログインしたユーザーは、「プレゼンス」タグをクリックし、メニューから「資格情報の変更」を選択できます。

詳細は、第14.3.1項「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録」を参照してください。

14.2.3 Microsoft Lyncの前提条件

この項では、Microsoft Lync 2010をインスタント・メッセージおよびプレゼンスのプレゼンス・サーバーとして使用するための前提条件を示します。

この項には次のサブセクションが含まれます:

- 第14.2.3.1項「Microsoft Lync: インストール」

- 第14.2.3.2項「Microsoft Lync: 構成」

- 第14.2.3.3項「Microsoft Lync: セキュリティに関する考慮事項」

14.2.3.1 Microsoft Lync: インストール

インストールの詳細は、Microsoft Lync 2010のドキュメントを参照してください。

14.2.3.2 Microsoft Lync: 構成

この項には次のサブセクションが含まれます:

- 第14.2.3.2.1項「シンプル・デプロイ」

- 第14.2.3.2.2項「リモート・デプロイ」

- 第14.2.3.2.3項「Application Provisionerの構築」

- 第14.2.3.2.4項「LyncサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニング」

- 第14.2.3.2.5項「WBemTestを使用したAllowedDomainsの追加」

- 第14.2.3.2.6項「Topology BuilderまたはPowerShellコマンドレットを使用した信頼済サービス・エントリの移行」

- 第14.2.3.2.7項「IISサーバーの構成」

- 第14.2.3.2.8項「UCMA v2.0のインストール」

- 第14.2.3.2.9項「WebCenter PortalのProxyアプリケーションのインストール」

Microsoft Lyncの構成はMicrosoft OCSの構成に似ています。

Microsoft Lync 2010をIMPのプレゼンス・サーバーとして使用するには、Microsoft Lync 2010用のWebCenter PortalのProxyアプリケーションを、次のいずれかのトポロジでデプロイする必要があります。

- シンプル・デプロイ: すべてのコンポーネントが同じボックスに存在します。

- リモート・デプロイ: プロキシ・アプリケーションとMicrosoft Lyncが別々のボックスに存在します。

14.2.3.2.1 シンプル・デプロイ

このトポロジでは、Lyncボックス上にホストされているInternet Information Services (IIS)サーバーにWebCenter PortalのProxyアプリケーションをデプロイします。

1. Microsoft Unified Communications Managed API (UCMA) 2.0をLyncボックスにインストールします。
詳細は、第14.2.3.2.8項「UCMA v2.0のインストール」を参照してください。

2. WebCenter PortalのProxyアプリケーションのIISサーバー上でのデプロイ
このプロキシ・アプリケーションは、Lyncサーバーとのやり取り、および情報の送受信のためのWebサービスを提供します。WebCenter PortalはこれらのWebサービスと通信し、データを表示します。詳細は、第14.2.3.2.9項「WebCenter PortalのProxyアプリケーションのインストール」を参照してください。

14.2.3.2.2 リモート・デプロイ

このトポロジでは、Lyncボックスに対してリモートであるIISサーバーにWebCenter PortalのProxyアプリケーションをデプロイします。つまり、IISサーバーとLyncサーバーが別々のマシン上にホストされます。

このプロキシ・アプリケーションはリモート・ボックス上にホストされるため、アプリケーションとLyncの間に信頼関係を設定する必要があります。これは、アプリケーションのプロビジョニングと呼ばれます。プロビジョニングは、Microsoft UCMA v2.0に付属のApplication Provisionerユーティリティを使用して行います。

関連項目:
http://msdn.microsoft.com/en-us/library/dd253360%28office.13%29.aspx

図14-6に、様々なデプロイ・エンティティで実行される手順(UCMA v2.0のインストールを含む)の概要を示します。

図14-6 Microsoft Lyncの構成: リモート・デプロイ

これらの手順の詳細は、次の項で説明します。

14.2.3.2.3 Application Provisionerの構築

この項では、Lyncにアクセスする他のIISサーバーをプロビジョニングするための、Microsoft社による手順を示します。

1. Visual Studio 2008を任意の開発者ボックスにインストールします(必ずしもIIS/Lyncである必要はありません)。

2. 第14.2.3.2.8項「UCMA v2.0のインストール」の手順に従って、UCMAバージョン2.0を同じボックスにインストールします。
Application Provisionerアプリケーションは、UCMA SDKに付属しています。

3. UCMA Coreをインストールした場所(たとえば、C:\Program Files\Microsoft Lync 2010 R2\UCMA SDK 2.0\UCMACore\Sample Applications\Collaboration\ApplicationProvisionerなど)の下にあるディレクトリSample Applications\Collaboration\ApplicationProvisionerへ移動します。

4. Visual Studio 2008でアプリケーションを開き、http://msdn.microsoft.com/en-us/library/gg448038.aspxに従ってApplication.csファイルを編集します。

5. Visual Studio 2008を使用してアプリケーションを構築します。
これにより、ApplicationProvisioner.exeファイルが生成されます。

6. この実行可能ファイルをLyncボックスにコピーします。

14.2.3.2.4 LyncサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニング

1. Lyncセットアップ・パッケージに付属のOCSWMIBC.msiファイルを実行します。
UCMA 2.0アプリケーションをLync Server 2010に対して直接デプロイする場合は、Lync Server 2010環境で使用されているSIPドメインを、Office Communications Server 2007 R2 SIPドメイン・リストに追加してから、Merge-CsLegacyTopologyコマンドレットを実行する必要があります。アプリケーションは、OCS 2007 R2に対してデプロイされている場合と同様にデプロイされ、Lync Server 2010に対して実行されるように移行されます。ドメインを追加するには、第14.2.3.2.5項「WBemTestを使用したAllowedDomainsの追加」を参照してください。

2. 前の項で生成されたApplicationProvisioner.exeファイルを実行します。
「Application Provisioner」ダイアログが表示されます。

3. 「Application Provisioner」ダイアログで、「アプリケーション名」にアプリケーション名としてWebCenterProxyApplicationと入力し、「検索または作成」をクリックします。

4. 「アプリケーション プールを作成します。」ダイアログの「Lync Pool Fqdn」の一覧で、使用するアプリケーションのプールを選択します。

- 「リッスンするポート」にアプリケーションのリスニング・ポートを入力します(例: 6001)。

- 「アプリケーション サーバーFqdn」に、アプリケーションをデプロイするコンピュータの完全修飾ドメイン名(FQDN)を入力します。(これはIISボックスです。)

- アプリケーションを複数のコンピュータにデプロイする場合、「負荷分散アプリケーション」チェック・ボックスを選択し、「ロード バランサーFqdn」にロード・バランサのFQDNを入力します。

アプリケーション・プールは、「Application Provisioner」ダイアログに表示されます。

5. サーバーのエントリをダブルクリックします。
「サーバーの表示」ダイアログが表示されます。そこに表示される情報は、サーバーのFQDN、ポート、GRUUです。

6. 新しく作成した信頼済みエントリをLync Server 2010に移行します。
第14.2.3.2.6項「Topology BuilderまたはPowerShellコマンドレットを使用した信頼済サービス・エントリの移行」を参照してください。

7. LyncサーバーでLync Certificateウィザードを使用して、前の手順で書き留めておいたサーバーFQDNをサブジェクト名として証明書を作成します。
この証明書は、IISサーバーからの要求の認可に使用されます。

8. 証明書が作成されたら、証明書を表示します。

9. 「詳細」タブで、「ファイルにコピー」をクリックします。
証明書のエクスポート・ウィザードが表示されます。

10. 秘密鍵を使用して、証明書をファイルにエクスポートします。
証明書の名前が付いた.pfx (Personal Information Exchange)ファイルが生成されます。

14.2.3.2.5 WBemTestを使用したAllowedDomainsの追加

1. WBemTest.exeを起動するには、コマンド・プロンプト・ウィンドウで、WBemTestと入力して[Enter]を押します。

2. 「Windows Management Instrumentationテスト」ダイアログで、「接続」をクリックします。

3. 「接続」ダイアログで、「接続」をクリックします。

4. 「Windows Management Instrumentationテスト」ダイアログで、「クラスの列挙」をクリックします。

5. 「スーパークラス情報」ダイアログで、「OK」をクリックします。

6. 「クエリ結果」ダイアログで、「MSFT_SIPDomainData()」までスクロール・ダウンして、このエントリをダブルクリックします。

7. 「MSFT_SIPDomainDataのオブジェクト エディタ」ダイアログで、「インスタンス」をクリックします。
「クエリ結果」ダイアログが表示され、MSFT_SIPDomainData WMIクラスの各インスタンスのInstanceIDが表示されます。これらのエントリはAllowedDomainエントリです。

8. AllowedDomainエントリを追加するために、「追加」をクリックします。

9. 「MSFT_SIPDomainDataのインスタンス」ダイアログの「プロパティ」リストボックスで、「アドレス」をダブルクリックします。

10. 「プロパティ エディタ」ダイアログで、「NULLでない」ラジオ・ボタンを選択します。

11. 「値」テキスト入力ペインに、Lyncサーバーのドメイン(例: contoso.com)を入力して、「プロパティの保存」をクリックします。

12. 「MSFT_SIPDomainDataのインスタンス」ダイアログの「プロパティ」リストボックスで、「権限あり」をダブルクリックして、「権限あり」プロパティをNullではなくFalseに設定してから、「プロパティの保存」をクリックします。

13. 「MSFT_SIPDomainDataのインスタンス」ダイアログの「プロパティ」リストボックスで、「既定のドメイン」をダブルクリックして、「既定のドメイン」プロパティをNullではなくTrueに設定してから、「プロパティの保存」をクリックします。

14. 「MSFT_SIPDomainDataのインスタンス」ダイアログで、「オブジェクトの保存」をクリックします。

14.2.3.2.6 Topology BuilderまたはPowerShellコマンドレットを使用した信頼済サービス・エントリの移行

Microsoft Lync Server 2010 Topology Builderを使用して信頼済サービス エントリを移行する手順は次のとおりです。

1. Microsoft Lync Server 2010のトポロジ ビルダーを起動します。

2. 既存のトポロジが読み込まれたら、「アクション」で「2007 トポロジのマージ」または「2007 R2 トポロジのマージ」を選択します。

3. その結果として起動されるウィザードで、デフォルトのオプションをそのまま使用して最後まで進みます。

4. 「トポロジの公開」を選択し、前の手順と同じようにウィザードを完了します。

5. ウィザードが終了したら、正常に実行が完了したことを確認します。
ユーザー・インタフェースにエラーが表示されていないことを確認してください。

Microsoft Lync Server 2010 PowerShellコマンドレットを使用して信頼済サービス エントリを移行する手順は次のとおりです。

1. 「スタート」メニューから「Microsoft Lync Server 2010」プログラム・グループにある「Lync Server管理シェル」を実行します。

2. 次のPowerShellコマンドレットを実行します。

Merge-CsLegacyTopology -TopologyXmlFileName D:\output.xml

3. 次のPowerShellコマンドレットを実行します。

Publish-CsTopology -FileName D:\output.xml

14.2.3.2.7 IISサーバーの構成

リモート・デプロイのシナリオでは、IISサーバーはWebCenter PortalのProxyアプリケーションをホストするため、前の項の情報を使用して、IISを信頼された認証局にしてください。

1. 秘密鍵を使用してLyncサーバーによって発行された証明書をインストールします。LyncサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニングの手順7で生成した.pfxファイルをIISボックスにコピーし、それをダブルクリックします。
証明書のインポート・ウィザードが表示されます。

2. LOCAL_MACHINEの下の個人用フォルダに証明書をインポートします。

3. C:/WINDOWS/system32/drivers/etc/hostsにLyncサーバーのプール名のエントリを次の形式で作成します。

<ip-address-of-lync-box> <poolname-of-lync-box>

例:

10.177.252.146 pool01.example.com

4. IISサーバーはWebCenter PortalのProxyアプリケーションをホストするため、IISサーバーにMicrosoft UCMA v2.0をインストールします。
詳細は、第14.2.3.2.8項「UCMA v2.0のインストール」を参照してください。

5. UCMAをインストールしたら、このプロキシ・アプリケーションをIISサーバー上にデプロイします。
WebCenter PortalのProxyアプリケーションは、Lyncとのやり取り、および情報の送受信のためのWebサービスを提供します。WebCenter PortalはこれらのWebサービスと通信し、データを表示します。詳細は、第14.2.3.2.9項「WebCenter PortalのProxyアプリケーションのインストール」を参照してください。

6. WebCenter PortalのProxyアプリケーションが抽出された場所に移動して、Web.configを開き、appSettings XMLノードを編集して、前の項(第14.2.2.2.5項「IISサーバーの構成」)の手順7で書き留めておいた値を追加します。
RemoteDeploymentの値は、必ずtrueに設定します。たとえば、appsettings XMLノードは次のように表示されます。

<appSettings>
<add key="ApplicationName" value="WebCenterProxyApplication"/>
<add key="RemoteDeployment" value="true"/>
<add key="ApplicationFQDN" value="iis.server.com"/>
<add key="ApplicationGRUU" value="sip:iis.server.com@EXAMPLE.COM;gruu;opaque=srvr:WebCenterProxyApplication:7mhSo94PlUK-5Q2bKPLyMAAA"/>
<add key="ApplicationPort" value="6001"/>
</appSettings>

注意:
ログ・ファイルに次のような例外が記録されている場合は、

ErrorCode = -2146893039
FailureReason = NoAuthenticatingAuthority
e.Message = "Unable to perform authentication of credentials."
base {Microsoft.Rtc.Signaling.FailureResponseException} = {"Unable to perform authentication of credentials."}
InnerException = {"NegotiateSecurityAssociation failed, error: \-2146893039"}

Web.configに次のエントリを追加してください。

<identity impersonate="true" userName="Administrator" password="MyPassword*"/>

usernameは管理者のユーザー名、passwordは管理者のパスワードです。

信頼関係が確立され、WebCenter PortalのProxyアプリケーションがLyncと対話できるようになりました。

14.2.3.2.8 UCMA v2.0のインストール

Microsoft Unified Communications Managed API v2.0 (UCMA)は、Lync環境と対話可能なサーバー・アプリケーションを上級開発者が構築できるエンドポイントAPIです。

シンプル・デプロイでは、UCMAがLyncと同じボックスにインストールされます。リモート・デプロイでは、Lyncコア・ライブラリはLyncボックスにインストールされ、UCMAはIIS(プロキシ)ボックスにインストールされます。

1. UCMA v2.0インストールを次の場所からダウンロードします。http://www.microsoft.com/downloads/details.aspx?FamilyID=b20967b1-6cf5-4a4b-b7ae-622653ac929f&displaylang=en

2. UcmaSDKWebDownload.msiファイルをダウンロードして実行します。
フォルダC:\Microsoft Unified Communications Managed API 2.0 SDK Installer package\amd64にファイルが抽出されます。

3. (前の手順でファイルが抽出された)ディレクトリに移動しvcredist_x86.exeを実行します。
UCMA APIに必要な、Visual C++ライブラリのランタイム・コンポーネントがインストールされます。

4. ディレクトリSetupに移動し、UcmaRedist.msiを実行します。
GACのUCMA 2.0アセンブリがインストールされます。

14.2.3.2.9 WebCenter PortalのProxyアプリケーションのインストール

1. コンパニオンCDからowc_ocs2007.zipを抽出します。
OCSWebServicesという名前のディレクトリが作成されます。

2. インターネット インフォメーション サービス(IIS)マネージャを開きます。

3. IISマネージャでサーバー・ノードを開き、「サイト」を開きます。

4. 「Lync内部Webサイト」を右クリックして、「アプリケーションの追加」を選択します。

5. アプリケーションの追加ウィザードで、「エイリアス」フィールドに仮想ディレクトリの別名(たとえば、RTC)を入力します。

6. owc_ocs2007.zipファイルから抽出されたディレクトリのパスを入力し、「OK」をクリックします。
たとえば、このzipファイルを「C:\」に抽出した場合は、C:\OCSWebServicesを入力します。あるいは、「参照」ボタンを使用して、そのディレクトリにナビゲートします。「OK」をクリックします。

7. 新しく作成したアプリケーションを右クリックし、「アクセス許可の編集」を選択して「プロパティ」ダイアログを表示します。

8. 「セキュリティ」タブで、アクセス許可を編集してユーザー「すべてのユーザー」に読取りアクセス許可を付与します。

9. 次のURL書式を使用してWebサイトにアクセスすることで、Webサービスをテストします。http://localhost/lync_internal_web_site/OCSWebService.asmx
lync_internal_web_siteは、Oracle RTC Webサービス用に作成した仮想ディレクトリです。

例:

http://localhost/RTC/OCSWebService.asmx

14.2.3.3 Microsoft Lync: セキュリティに関する考慮事項

ユーザーが資格証明を提供してLyncサーバーに対して自分を認証できるように、Microsoft Lync接続用の外部アプリケーションを構成する必要があります。

保護されたアプリケーションでは、ユーザーがプレゼンス・ステータスを取得できます。Lyncでは、セキュリティが必要な場合、信頼できるプライベート・ネットワーク上にLyncが存在する必要があります。

Lyncには、外部資格情報を変更するためのオプションが用意されています。これは、外部アプリケーションを使用するかわりになります。ログインしたユーザーは、「プレゼンス」タグをクリックし、メニューから「資格情報の変更」を選択できます。

詳細は、第14.3.1項「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録」を参照してください。

14.3 インスタント・メッセージおよびプレゼンス・サーバーの登録

WebCenter Portalには複数のプレゼンス・サーバー接続を登録できますが、同時にアクティブにできる接続はそのうち1つのみです。

新しい(アクティブな)プレゼンス・サーバーの使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

この項には次のサブセクションが含まれます:

- 第14.3.1項「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録」

- 第14.3.2項「WLSTを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録」

14.3.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録

プレゼンス・サーバー接続を登録するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「インスタント・メッセージおよびプレゼンス」を選択します。

4. 新しいプレゼンス・サーバーに接続するには、「追加」をクリックします(図14-7)。

図14-7 インスタント・メッセージおよびプレゼンスの構成

5. この接続の一意の名前を入力し、プレゼンス・サーバー・タイプを指定して、この接続をアプリケーションのアクティブな(またはデフォルトの)接続にするかどうかを指定します(表14-1)。

表14-1 インスタント・メッセージおよびプレゼンス接続: 名前

フィールド

説明

接続名

接続の一意の名前を入力します。この名前は、WebCenter Portalのすべての接続タイプにおいて一意である必要があります。

接続タイプ

プレゼンス・サーバーのタイプを指定します。

- Microsoft Live Communications Server (LCS)

- Microsoft Office Communications Server 2007 (OCS)

初期設定のWebCenter Portalは、Microsoft LCS、OCSおよびLyncをサポートしています。

注意: Microsoft Lync接続は、Microsoft Office Communications Server 2010接続タイプを使用します。(Oracle Beehive Server接続は、このリリースではサポートされていません。)

アクティブな接続

これを選択すると、この接続がWebCenter Portalでインスタント・メッセージおよびプレゼンスに使用されます。

1つのアプリケーションに対して複数のプレゼンス・サーバー接続を登録できますが、IMPで使用される接続はデフォルトの(またはアクティブな)接続1つのみです。

6. インスタント・メッセージおよびプレゼンスをホストするサーバーの接続の詳細を入力します(表14-2)。

表14-2 インスタント・メッセージおよびプレゼンス接続: 接続の詳細

フィールド

説明

サーバーURL

インスタント・メッセージおよびプレゼンスをホストするサーバーのURLを入力します。

例: http://myocshost.com:8888

ユーザー・ドメイン

(OCS/Lyncのみ)この接続に関連付けられている(Microsoft Office Communications Server上の)Active Directoryドメインの名前を入力します。OCS/Lync接続の場合はユーザー・ドメインが必須です。

ユーザー・ドメインの詳細は、Microsoft社のドキュメントを参照してください。

プール名

この接続に関連付けられているプールの名前を入力します。このプール名は必須です。

プール名の詳細は、Microsoft社のドキュメントを参照してください。

関連付けられている外部アプリケーション

インスタント・メッセージおよびプレゼンス・サーバーを外部アプリケーションと関連付けます。外部アプリケーションの資格証明情報が、ユーザーをインスタント・メッセージおよびプレゼンス・サーバーに対して認証するために使用されます。

外部アプリケーションは必須です。

リストから既存の外部アプリケーションを選択することも、「新規作成」をクリックして新規の外部アプリケーションを構成することもできます。

インスタント・メッセージおよびプレゼンス用に構成する外部アプリケーションでは、POST認証方式を使用する必要があります。また、Display to Userに構成(選択)されたAccountという追加のフィールド(名前プロパティ)も指定する必要があります。詳細は、第23章「外部アプリケーションの管理」を参照してください。

7. 「拡張構成」フィールドにタイムアウトを入力します(表14-4)。

表14-3 インスタント・メッセージおよびプレゼンス接続: 拡張構成

フィールド

説明

接続タイムアウト(秒)

接続の適切なタイムアウトを指定します。

これは、WebCenter Portalが接続タイムアウト・メッセージを発行するまでにプレゼンス・サーバーからのレスポンスを待機する時間(秒)です。

デフォルトは-1です。これは、デフォルトが使用されることを示します。デフォルトは10秒です。

8. プレゼンス・サーバーに接続するためには追加のパラメータが必要になる場合があります。
プレゼンス・サーバーへの接続に追加のパラメータが必要な場合は、「追加プロパティ」を開き、必要な詳細を入力します(表14-4)。

表14-4 インスタント・メッセージおよびプレゼンス接続: 追加プロパティ

フィールド

説明

追加

「追加」をクリックして、追加の接続パラメータを指定します。

- プロパティ名: 接続プロパティの名前を入力します。

- プロパティ値: プロパティのデフォルト値を入力します。

- プロパティはセキュアか: 暗号化が必要かどうかを指定します。選択した場合、プロパティの値は、暗号化を使用してセキュアに格納されます。
たとえば、この値が実際のパスワードである場合、admin.passwordプロパティを保護するためにこのオプションを選択します。

削除

「削除」をクリックして、選択したプロパティを削除します。

「削除」をクリックする前に、正しい行を選択します。

注意: 「OK」をクリックするまで、削除された行は無効として表示されます。

9. 「OK」をクリックして、この接続を保存します。

10. 新しい(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。
詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

14.3.2 WLSTを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録

WLSTコマンドのcreateIMPConnectionを使用して、プレゼンス・サーバーの接続を作成します。コマンドの構文と例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のcreateIMPConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

新規のIMP接続をアクティブに使用するようにインスタント・メッセージおよびプレゼンスを構成するには、default=trueを設定します。詳細は、第14.4.2項「WLSTを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択」を参照してください。

注意:
新しい(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのコマンド行を使用した管理対象サーバーの起動および停止に関する項を参照してください。

14.4 インスタント・メッセージおよびプレゼンス用のアクティブな接続の選択

WebCenter Portalには複数のインスタント・メッセージおよびプレゼンス・サーバー接続を登録できますが、一度にアクティブにできる接続は1つのみです。アクティブな接続がWebCenter Portalのバックエンド・プレゼンス・サーバーになります。

この項には次のサブセクションが含まれます:

- 第14.4.1項「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択」

- 第14.4.2項「WLSTを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択」

14.4.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択

アクティブな接続を変更するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「インスタント・メッセージおよびプレゼンス」を選択します。
「インスタント・メッセージおよびプレゼンス接続の管理」表に、現在のアクティブな接続(ある場合)が示されます。

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」をクリックします。

5. 「アクティブな接続」チェック・ボックスを選択します。

6. 「OK」をクリックして、接続を更新します。

7. 新しい(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。
第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

14.4.2 WLSTを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択

WLSTコマンドのsetIMPConnectionをdefault=trueで使用して、既存のプレゼンス・サーバー接続をアクティブ化します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetIMPConnectionに関する項を参照してください。

プレゼンス・サーバー接続を無効化するには、その接続を削除するか、別の接続を「アクティブな接続」にするか、removeIMPServicePropertyコマンドを使用します。

removeIMPServiceProperty('appName='webcenter', property='selected.connection')

このコマンドを使用すると、接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のremoveIMPServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
このアクティブな接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのコマンド行を使用した管理対象サーバーの起動および停止に関する項を参照してください。

14.5 インスタント・メッセージおよびプレゼンス接続の詳細の変更

インスタント・メッセージおよびプレゼンス・サーバー接続の詳細はいつでも変更できます。

更新された(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

この項には次のサブセクションが含まれます:

- 第14.5.1項「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス接続の詳細の変更」

- 第14.5.2項「WLSTを使用したインスタント・メッセージおよびプレゼンス接続の詳細の変更」

14.5.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス接続の詳細の変更

インスタント・メッセージおよびプレゼンス・サーバーの接続の詳細を更新する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「インスタント・メッセージおよびプレゼンス」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。
パラメータの詳細は、表14-2「インスタント・メッセージおよびプレゼンス接続: 接続の詳細」を参照してください。

6. 「OK」をクリックして、変更を保存します。

7. 更新された(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。
詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

14.5.2 WLSTを使用したインスタント・メッセージおよびプレゼンス接続の詳細の変更

WLSTコマンドのsetIMPConnectionを使用して、プレゼンス・サーバー接続の詳細を編集します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetIMPConnectionに関する項を参照してください。

プレゼンス・サーバーへの接続に追加のパラメータが必要な場合は、setIMPConnectionPropertyコマンドを使用します。詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のsetIMPConnectionPropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
更新された(アクティブな)接続の使用を開始するには、WebCenter PortalおよびPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのコマンド行を使用した管理対象サーバーの起動および停止に関する項を参照してください。

14.6 インスタント・メッセージおよびプレゼンス接続の削除

インスタント・メッセージおよびプレゼンス接続はいつでも削除できますが、アクティブな接続を削除する際には注意が必要です。ユーザー・プレゼンス・オプションはバックエンド・インスタント・メッセージおよびプレゼンス・サーバーを必要とするため、アクティブな接続を削除すると、ユーザー・プレゼンス・オプションは使用できなくなります。

接続を削除するとき、インスタント・メッセージおよびプレゼンスに関連付けられている外部アプリケーションの目的がこの接続をサポートすることのみであれば、その外部アプリケーションを削除することを考慮してください。詳細は、第23.6項「外部アプリケーション接続の削除」を参照してください。

この項には次のサブセクションが含まれます:

- 第14.6.1項「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス接続の削除」

- 第14.6.2項「WLSTを使用したインスタント・メッセージおよびプレゼンス接続の削除」

14.6.1 Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス接続の削除

インスタント・メッセージおよびプレゼンス・サーバー接続を削除するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「インスタント・メッセージおよびプレゼンス」を選択します。

4. 接続名を選択し、「削除」をクリックします。

5. この変更を行うには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。
詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

注意:
管理対象サーバーを再起動する前に、別の接続をアクティブとしてマークしてください。そうしないと、インスタント・メッセージおよびプレゼンスが無効になります。

14.6.2 WLSTを使用したインスタント・メッセージおよびプレゼンス接続の削除

WLSTコマンドのdeleteConnectionを使用して、プレゼンス・サーバーの接続を削除します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

14.7 インスタント・メッセージおよびプレゼンスのデフォルトの設定

WLSTコマンドのsetIMPServicePropertyを使用して、IMPのデフォルトを設定します。

- selected.connection: インスタント・メッセージおよびプレゼンスで使用する接続。

- rtc.cache.time: インスタント・メッセージおよびプレゼンス・データのキャッシュ・タイムアウト。

- resolve.display.name.from.user.profile: ユーザー表示名がない場合に表示する内容を設定します。0に設定すると、表示名の情報がない場合には、ユーザー名のみがアプリケーションに表示されます。1に設定すると、表示名の情報がない場合に、表示名がユーザー・プロファイル・データから読み込まれます。このオプションを1に設定すると、パフォーマンスに影響します。デフォルト設定は0です。
表示名は、プレゼンス・データでは必須でありません。アプリケーションが表示名をデフォルトで提供しないことがあり、この情報が重要と思われる場合は、resolve.display.name.from.user.profileを1に設定することで、表示名を常に表示できます。

- im.address.resolver.class: ユーザー名からIMアドレスおよびIMアドレスからユーザー名へのマッピングに使用するリゾルバ実装。デフォルト設定はoracle.webcenter.collab.rtc.IMPAddressResolverImplです。この実装は、次の場所と順序でIMアドレスを検索します。

- ユーザー・プリファレンス

- ユーザー資格証明

- ユーザー・プロファイル

- im.address.profile.attribute: ユーザーのIMアドレスを特定するために使用するユーザー・プロファイル属性。デフォルト設定はBUSINESS_EMAILです。im.address.profile.attributeでこのデフォルトを変更できます。

コマンドの構文と詳細な例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetIMPServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

14.8 インスタント・メッセージおよびプレゼンス接続のテスト

Oracle RTC Webサービスでは、呼び出して妥当性をテストできる一連のWebメソッドを公開しています。接続を検証するには、Webサービスのエンドポイントにアクセスしてみます。次の例は、アプリケーション・コンテキスト・パスを/RTCと仮定しています。

- protocol://host/RTC/ApplicationConfigurationService.asmx

- protocol://host/RTC/RTCService.asmx

- protocol://host/RTC/OCSWebService.asmx

15 メールの管理

この章では、WebCenter Portalのメールを構成および管理する方法について説明します。また、「メールの送信」機能の構成方法についても説明しますが、この機能を使用すると、アプリケーション・アセットはそれ自身から直接メールを送信できます。「メールの送信」機能には、メールは必要ありません。つまり、「メール」コンポーネントがWebCenter Portalで構成されていない場合でも、ユーザーはメール通知を送信できます。「メールの送信」通知の使用の詳細は、『Oracle WebCenter Portalの使用』の「メールの送信」機能についての項を参照してください。

WebCenter PortalおよびPortal Frameworkアプリケーションのバックエンド・サーバーを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後にアプリケーションに加えた変更はすべて、MDSメタデータ・ストアにカスタマイズとして格納されます。第1.3.5項「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:
Fusion Middleware ControlまたはWLSTを使用して行ったメールの構成変更は動的ではないため、変更を有効にするには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章には次のトピックが含まれます:

- 第15.1項「メール・サーバー接続について」

- 第15.2項「メールの構成ロードマップ」

- 第15.3項「メール・サーバーの前提条件」

- 第15.4項「メール・サーバーの登録」

- 第15.5項「アクティブな(またはデフォルトの)メール・サーバー接続の選択」

- 第15.6項「メール・サーバー接続の詳細の変更」

- 第15.7項「メール・サーバー接続の削除」

- 第15.8項「メールのデフォルトの設定」

- 第15.9項「メール・サーバー接続のテスト」

- 第15.10項「WebCenter Portalのメール通知の送信の構成」

- 第15.11項「メールに関する問題のトラブルシューティング」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

15.1 メール・サーバー接続について

Oracle WebCenter Portalでは、Microsoft Exchange Serverや、IMAP4およびSMTPをサポートするすべてのメール・サーバーをサポートしています。ユーザーがWebCenter Portal内または独自のPortal Frameworkアプリケーション内でメールにアクセスし、読取り、返信、転送といった基本的な操作を実行できるようにするには、まず、適切なメール・サーバーを登録する必要があります。メールは事前には構成されていません。

複数のメール・サーバー接続に登録できます。

- WebCenter Portalは複数のメール接続をサポートしています。アクティブとしてマークされたメール接続が、WebCenter Portalでのメールのデフォルトの接続です。すべての追加の接続は代替として提供され、ユーザーは、使用する接続をユーザー・プリファレンスで選択できます。

- Portal Frameworkアプリケーションは、アクティブとしてマークされたメール接続1つのみを使用します。追加の接続は無視されます。

15.2 メールの構成ロードマップ

この項では、ロードマップを構成プロセスにおける管理者のガイドとして使用します。

- ロードマップ: WebCenter Portal用のメールの構成
図15-1と表15-0に、WebCenter Portalでメールを動作させるための前提条件と必要な作業の概要を示します。

図15-1 メールの構成

表15-1 WebCenter Portal用のメールの構成

担当者

タスク

サブタスク

管理者

1. WebCenter Portalと、メール・サーバーのバックエンド・コンポーネントをインストールします(「メール・サーバー: インストール」を参照)

1.a Microsoft Exchange 2007、2010または2013の場合のみ、追加の構成手順を実行します(「WebCenter PortalのためのMicrosoft Exchange Server 2007、2010または2013の構成」を参照)

2. 次のいずれかのツールを使用して、WebCenter Portalとメール・サーバー間の接続を構成します(メール・サーバーを外部アプリケーションに関連付けます)

- Fusion Middleware Control (「Fusion Middleware Controlを使用したメール・サーバーの登録」を参照)

- WLST (「WLSTを使用したメール・サーバーの登録」を参照)

エンド・ユーザー

3. ページにメール・タスク・フローを追加します。

4. 次のいずれかの方法でメールにアクセスします

- メール・タスク・フローで「メールにログイン」をクリックし、メール・サーバーのログイン資格証明を入力します

- 「プリファレンス」→「メール」ページに移動してメール資格証明を指定します。

- ロードマップ: Portal Frameworkアプリケーション用のメールの構成
図15-2と表15-2に、Portal Frameworkアプリケーションでメールを動作させるための前提条件と必要な作業の概要を示します。

図15-2 Portal Frameworkアプリケーション用のメールの構成

表15-2 Frameworkアプリケーション用のメールの構成

担当者

タスク

サブタスク

管理者

1. WebCenter Portalと、メール・サーバーのバックエンド・コンポーネントをインストールします(「メール・サーバー: インストール」を参照)

1.a Microsoft Exchange 2007、Exchange 2010およびExchange 2013の場合のみ、追加の構成手順を実行します(「WebCenter PortalのためのMicrosoft Exchange Server 2007、2010または2013の構成」を参照)

開発者

2. メールをFrameworkアプリケーションに統合します。

2.a JDeveloperでメール・サーバーとの接続を構成します(メール・サーバーを外部アプリケーションに関連付けます)

2.b JDeveloperでメール・タスク・フローをページに追加します

開発者または管理者

3. 次のいずれかのツールを使用して、Frameworkアプリケーションをデプロイします:

- JDeveloper (開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

- WLS管理コンソール(管理者)

開発者または管理者

4. (オプション)次のいずれかのツールを使用して接続パラメータを追加または変更します。

- JDeveloper。その後、アプリケーションを再デプロイします(開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

エンド・ユーザー

5. メール・タスク・フローで「メールにログイン」をクリックし、メール・サーバーのログイン資格証明を入力してメールにアクセスします

15.3 メール・サーバーの前提条件

この項には次のサブセクションが含まれます:

- 第15.3.1項「メール・サーバー: インストール」

- 第15.3.2項「メール・サーバー: 構成」

- 第15.3.3項「メール・サーバー: セキュリティに関する考慮事項」

- 第15.3.4項「メール・サーバー: 制限事項」

15.3.1 メール・サーバー: インストール

インストールの詳細は、ご使用のメール・サーバーのドキュメントを参照してください。

15.3.2 メール・サーバー: 構成

WebCenter Portalでは、ポータル配信リストを作成および管理できます。この機能は、Microsoft Exchangeでのみサポートされます。

有効な場合、ポータル配信リストはポータルが作成されるたびに自動的に作成されます。LDAPベースDN (サポートされるLDAPベースDNは1つのみ)が変化せず、Microsoft Exchange Active Directory上に作成されたユーザーがWebCenter Portalで使用されるアイデンティティ・ストアに作成されたユーザーに対応している場合、ポータルに追加されたユーザーは対応するポータル配信リストに自動的に追加され、ポータルから削除されたユーザーは対応するポータル配信リストから自動的に削除されます。この機能を無効化するには、LDAP (Active Directory)サーバーの詳細をメール接続に入力しないでください。

詳細は、第15.4.1項「Fusion Middleware Controlを使用したメール・サーバーの登録」の手順7を参照してください。

メール・サーバーでのユーザーの追加の詳細は、メール・サーバーの製品ドキュメントを参照してください。WebCenter Portalのアイデンティティ・ストアへのユーザーの追加の詳細は、第31.3項「組込みLDAPアイデンティティ・ストアへのユーザーの追加」を参照してください。

Microsoft Exchange 2007、Microsoft Exchange 2010およびMicrosoft Exchange 2013は、構成の前提条件がある唯一のメール・サーバーです。他のメール・サーバー(Microsoft Exchange 2003を含む)を使用している場合は、この項の以降の部分を省略してかまいません。

15.3.2.1 WebCenter PortalのためのMicrosoft Exchange Server 2007、2010または2013の構成

Microsoft Exchange Server 2007、2010または2013の証明書をWebCenter Portalキーストアに追加する必要があります。これには、次の手順が必要になります。

1. 第15.3.2.1.1項「Microsoft Exchange Serverからの証明書の取得」

2. 第15.3.2.1.2項「WebCenter Portalキーストアへの証明書の追加」

3. 証明書をインポートしたら、サーバーを再起動します。

15.3.2.1.1 Microsoft Exchange Serverからの証明書の取得

ご使用のメール・サーバーのインストール管理者から証明書を取得します。この項では、Microsoft Exchange Serverから証明書を取得する方法の1つを説明します。

Microsoft Exchange 2007、2010または2013から証明書を取得するには:

1. ブラウザを開き、次のコマンドを使用してIMAPサーバーに接続します。

https://host_name/owa

host_nameはMicrosoft Exchange Serverのホスト名です。

2. ページにカーソルを置いて、右クリックし、「プロパティ」を選択します。次に、「証明書」をクリックします。

3. ポップアップ・ウィンドウで「詳細」タブをクリックし、「ファイルにコピー...」をクリックします。
必ずDER encoded binary (X.509)形式を使用して、ファイルにコピーしてください。

4. .DER形式の証明書を.PEM形式に変換します。

注意:
WebLogicは.PEM形式のみを認識します。

Firefox 3.0以降を使用すると、証明書を.PEM形式で直接ダウンロードできます。それ以外のブラウザの場合、WebLogic Serverのder2pemツールを使用して.PEM形式に変換してください。der2pemの詳細は、『Oracle WebLogic Serverコマンド・リファレンス』を参照してください。

15.3.2.1.2 WebCenter Portalキーストアへの証明書の追加

1. ダウンロードした証明書をキーストアにインポートします。通常、キーストアはJAVA_HOMEにあるcacertsという名前のファイルです。例:

keytool -import -alias imap_cer -file cert_file.cer -keystore cacerts -storepass changeit

cert_fileは、ダウンロードした証明書ファイルの名前です。標準インストールでは、JAVA_HOMEは次の場所にあります。

/scratch/wcinstall/ps2/1225/wlshome/jrockit_160_17_R28.0.0-616

キーストアへの証明書の追加の詳細は、第33.4.2.1.3項「証明書の構成とエクスポート」を参照してください。

2. サーバーを再起動します。

15.3.2.1.3 Microsoft Exchange Serverに関する考慮事項

- IMAPポートは993で、secured=trueです。SMTPポートは587で、secured=trueです。
(Microsoft Exchange Server 2005では465を使用していました。)

- 次のエラーが表示される場合は、ドメイン起動ファイルsetDomainEnv.sh内のトラスト・ストアのエントリを変更する必要があります。

Caused by: java.io.IOException: Keystore was tampered with, or password was incorrect
at sun.security.provider.JavaKeyStore.engineLoad(JavaKeyStore.java:771)
at sun.security.provider.JavaKeyStore$JKS.engineLoad(JavaKeyStore.java:38)
at java.security.KeyStore.load(KeyStore.java:1185)
at com.sun.net.ssl.internal.ssl.TrustManagerFactoryImpl.getCacertsKeyStore (TrustManagerFactoryImpl.java:202)
at com.sun.net.ssl.internal.ssl.DefaultSSLContextImpl.getDefaultTrustManager (DefaultSSLContextImpl.java:70)

このエントリを変更するには:

1. WebCenter Portalがデプロイされている管理対象サーバーをシャットダウンします。

2. 次にある、ドメイン起動スクリプトsetDomainEnvを編集します。
UNIX: DOMAIN_HOME/bin/setDomainEnv.sh

Windows: DOMAIN_HOME\bin\setDomainEnv.cmd

3. 次のように、Javaプロパティを追加します。

-Djavax.net.ssl.trustStore=<path to truststore> -Djavax.net.ssl.trustStorePassword=<truststore password>

例:

set JAVA_PROPERTIES=
-Dplatform.home=%WL_HOME% -Dwls.home=%WLS_HOME% -Dweblogic.home=%WLS_HOME%
-Djavax.net.ssl.trustStore=C:\jive\mailtool\jssecacerts
-Djavax.net.ssl.trustStorePassword=changeit

4. 管理対象サーバーを再起動します。

15.3.3 メール・サーバー: セキュリティに関する考慮事項

詳細は、第35.8項「SSLを使用したWebCenter PortalからIMAPおよびSMTPへの接続の保護」を参照してください。

注意:
LDAPがセキュア・モードで実行するように構成されている場合は、LDAP保護プロパティを追加(true/falseに設定)して、配信リストの作成時にLDAPを使用するようにしてください。詳細は、表15-5を参照してください。

15.3.4 メール・サーバー: 制限事項

WebCenter Portalでは、メールでWebCenter Portal配信リストの自動管理を可能にするために、Microsoft Exchangeメール・サーバー接続が必要です。

15.4 メール・サーバーの登録

複数のメール・サーバー接続に登録できます。新しいメール接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

この項には次のサブセクションが含まれます:

- 第15.4.1項「Fusion Middleware Controlを使用したメール・サーバーの登録」

- 第15.4.2項「WLSTを使用したメール・サーバーの登録」

15.4.1 Fusion Middleware Controlを使用したメール・サーバーの登録

メール・サーバーをWebCenter Portalに登録するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「メール・サーバー」を選択します。

4. 新規のメール・サーバーに接続するには、「追加」をクリックします(図15-3)。

図15-3 メール・サーバーの構成

5. この接続の一意の名前を入力し、この接続をアプリケーションのアクティブな(またはデフォルトの)接続にするかどうかを指定します(表15-3)。

表15-3 メール・サーバー接続: 名前

フィールド

説明

接続名

接続の一意の名前を入力します。この名前は、WebCenter Portalのすべての接続タイプにおいて一意である必要があります。

アクティブな接続

この接続をメールのデフォルトの(またはアクティブな)接続にするかどうかを指定します。

複数のメール・サーバー接続に登録できます。

- WebCenter Portalは複数のメール接続をサポートしています。アクティブとしてマークされたメール接続が、メールのデフォルトの接続です。すべての追加の接続は代替として提供され、ユーザーは、使用する接続をユーザー・プリファレンスで選択できます。

- Portal Frameworkアプリケーションは、アクティブとしてマークされたメール接続1つのみを使用します。追加の接続は無視されます。

6. メール・サーバーの接続の詳細を入力します(表15-4)。

表15-4 メール・サーバー接続の詳細

フィールド

説明

IMAPホスト

IMAP (Internet Message Access Protocol)が実行されているコンピュータのホスト名を入力します。

IMAPポート

IMAPがリスニングするポートを入力します。

IMAP保護

IMAPを介する受信メールに保護された接続(SSL)が必要かどうかを指定します。

SMTPホスト

SMTP (Simple Mail Transfer Protocol)が実行されているコンピュータのホスト名を入力します。

SMTPポート

SMTPがリスニングするポートを入力します。

SMTP保護

SMTPを介する送信メールに保護された接続(SSL)が必要かどうかを指定します。

関連付けられている外部アプリケーション

メール・サーバーを外部アプリケーションに関連付けます。ユーザーをIMAPおよびSMTPサーバーに対して認証するために、外部アプリケーションの資格証明情報が使用されます。メールは、IMAPとSMTPの両方に対するユーザーの認証に同じ資格証明を使用します。

リストから既存の外部アプリケーションを選択することも、「新規作成」をクリックして新規の外部アプリケーションを構成することもできます。詳細は、第23章「外部アプリケーションの管理」を参照してください。

メールの外部アプリケーションでは、Authentication Method=POSTを使用する必要があります。また、一部のメール・ヘッダー・フィールドをカスタマイズできます(「ユーザーに表示」が有効の場合)。

- プロパティ: mail.user.emailAddress (メールの送信者)
プロパティ: mail.user.displayName (メールの表示名)

プロパティ: mail.user.replyToAddress (メールの返信先アドレス)

これらのプロパティは、特定のメール・アドレスが外部アプリケーションとメール・サーバーで同じであることを保証します。これらのプロパティはメール接続に追加され、メールで「送信元」、「表示名」および「返信先」の各フィールドに使用されます(図15-4)。追加プロパティの構成については、表15-8を参照してください。

アプリケーションで、要求時にユーザーID情報をメール送信する機能を備えた自己登録ページを用意している場合、ここで選択した外部アプリケーションに対してパブリック資格証明が構成されていることを確認してください。パブリック資格証明が定義されていない場合、要求時にユーザーにメールが送信されません。たとえば、WebCenter Portalでは、デフォルトの自己登録ページでこの機能を提供しています。

7. WebCenter Portal配信リストを管理するActive DirectoryサーバーのLDAP接続の詳細を指定します(表15-5)。

WebCenter Portalは、配信リストをActive Directoryサーバーで管理するMicrosoft Exchangeをサポートしています。

注意:
配信リストをWebCenter Portalで動作させるには、Active Directoryサーバーの詳細をメール接続の一部として指定する必要があります。

表15-5 LDAPディレクトリ・サーバーの構成パラメータ

フィールド

説明

LDAPホスト

LDAP (Lightweight Directory Access Protocol)ディレクトリ・サーバーが実行されているコンピュータのホスト名を入力します。

LDAPポート

LDAPディレクトリ・サーバーがリスニングするポートを入力します。

LDAPベースDN

LDAPスキーマのベース識別名を入力します。例: CN=Users,DC=oracle,DC=com。

LDAPドメイン

配信リスト名の後ろに追加するドメインを入力します。

たとえば、このドメイン値をexample.comに設定した場合、Finance ProjectというポータルはFinanceProject@example.comという配信リストを保持します。

LDAP管理者ユーザー名

LDAPディレクトリ・サーバー管理者のユーザー名を入力します。

LDAPスキーマにエントリを作成する権限のある有効なユーザーを指定してください。

LDAP管理者のパスワード

LDAPディレクトリ・サーバー管理者のパスワードを入力します。

このパスワードは保護されたストアに格納されます。

LDAPデフォルト・ユーザー

モデレーション機能を付与するユーザー名のカンマ区切りリストを入力します。これらのユーザーは、作成されるすべてのポータル配信リストのメンバーになります。ここで指定するユーザーは、(「LDAPベースDN」フィールドで指定した)ベースLDAPスキーマに存在する必要があります。

LDAP保護

WebCenter PortalとLDAPディレクトリ・サーバー間に保護された接続(SSL)が必要かどうかを指定します。

8. メール・サーバー接続の拡張オプションを構成します(表15-6)。

表15-6 メール・サーバー接続: 拡張構成

フィールド

説明

接続タイムアウト(秒)

接続の適切なタイムアウトを指定します。

これは、WebCenter Portalが接続タイムアウト・メッセージを発行するまでにメール・サーバーからのレスポンスを待機する時間(秒)です。

デフォルトは-1です。これは、デフォルトが使用されることを示します。デフォルトは10秒です。

9. オプションとして、メール・サーバー接続にパラメータを追加できます(表15-7)。

表15-7 追加のメール接続プロパティ

追加の
接続プロパティ

説明

charset

接続で使用するキャラクタ・セット。

デフォルトのcharsetは、UTF-8です。ISO-8859-1などの他のキャラクタセットを使用する場合は、charset接続プロパティを設定します。

各種のIMAPプロパティ

任意の有効なIMAP接続プロパティ。たとえば、mail.imap.connectionpoolsizeです。

有効なプロトコル・プロパティのリストは、メール・サーバーのドキュメントを参照してください。標準IMAPプロパティのリストは、Java Mail APIを参照してください。

http://javamail.java.net/nonav/docs/api/com/sun/mail/imap/package-summary.html

各種のSMTPプロパティ

任意の有効なSMTP接続プロパティ。たとえば、mail.smtp.timeoutです。

有効なプロトコル・プロパティのリストは、メール・サーバーのドキュメントを参照してください。標準SMTPプロパティのリストは、Java Mail APIを参照してください。

http://javamail.java.net/nonav/docs/api/com/sun/mail/smtp/package-summary.html

メール・サーバーへの接続に追加のパラメータが必要な場合は、「追加プロパティ」を開き、必要な詳細を入力します(表15-8を参照)。

表15-8 メール接続: 追加プロパティ

フィールド

説明

追加

「追加」をクリックして、追加の接続パラメータを指定します。

- プロパティ名: 接続プロパティの名前を入力します。

- プロパティ値: プロパティのデフォルト値を入力します。

- プロパティはセキュアか: 暗号化が必要かどうかを指定します。選択した場合、プロパティの値は、暗号化を使用してセキュアに格納されます。
たとえば、この値が実際のパスワードである場合、admin.passwordプロパティを保護するためにこのオプションを選択します。

削除

「削除」をクリックして、選択したプロパティを削除します。

「削除」をクリックする前に、正しい行を選択します。

注意: 「OK」をクリックするまで、削除された行は無効として表示されます。

図15-4 メール接続の追加プロパティ

10. 「OK」をクリックして、この接続を保存します。

11. 新しい(アクティブな)接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。
詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

15.4.2 WLSTを使用したメール・サーバーの登録

WLSTコマンドのcreateMailConnectionを使用して、メール・サーバーの接続を作成します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のcreateMailConnectionに関する項を参照してください。

WLSTコマンドのsetMailConnectionPropertyを使用して、外部アプリケーションを介して必要な追加プロパティを追加します。メールの外部アプリケーションでは、Authentication Method=POSTを使用する必要があります。また、一部のメール・ヘッダー・フィールドをカスタマイズできます(「ユーザーに表示」が有効の場合)。例:

setMailConnectionProperty(appName='webcenter', name='NotificationSharedConn', key='mail.user.emailAddress', value='john.doe@example.com')

setMailConnectionProperty(appName='webcenter', name='NotificationSharedConn', key='mail.user.displayName', value='John Doe')

setMailConnectionProperty(appName='webcenter', name='NotificationSharedConn', key='mail.user.replyToAddress', value='feedback@example.com')

ここで:

- mail.user.emailAddress = 電子メール・アドレス(メールの送信元)

- mail.user.displayName = 自分の名前(メールの表示名)

- mail.user.replyToAddress = 返信先アドレス(メールに返信するときのアドレス)

これらのプロパティは、特定のメール・アドレスが外部アプリケーションとメール・サーバーで同じであることを保証します。これらのプロパティはメール接続に追加され、メールで「送信元」、「表示名」および「返信先」の各フィールドに使用されます。

Exchange 2007の場合のみ: デフォルトのプロパティ値2を8に更新して、汎用配信リストを作成します。次に示すように、メール・プロパティのmail.exchange.dl.group.typeの値に8を指定します。

setMailServiceProperty(appName='webcenter', property='mail.exchange.dl.group.type', value='8')

アプリケーションで、要求時にユーザーID情報をメール送信する機能を備えた自己登録ページを用意している場合、ここで選択した外部アプリケーションに対してパブリック資格証明が構成されていることを確認してください。パブリック資格証明が定義されていない場合、要求時にユーザーにメールが送信されません。たとえば、WebCenter Portalでは、デフォルトの自己登録ページでこの機能を提供しています。

コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetMailConnectionPropertyに関する項を参照してください。

新規のメール・サーバー接続をデフォルトの接続として使用するようにメールを構成するには、default=trueを設定します。詳細は、第15.5.2項「WLSTを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択」を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
新しい接続の使用を開始するには、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのコマンド行を使用した管理対象サーバーの起動および停止に関する項を参照してください。

15.5 アクティブな(またはデフォルトの)メール・サーバー接続の選択

WebCenter Portalには複数のメール・サーバー接続を登録できますが、デフォルトの接続として指定できる接続は1つのみです。デフォルトの接続は、次の項目のバックエンド・メール・サーバーとなります。

- メール・タスク・フロー

- WebCenter Portal配信リスト

- 「メールの送信」アイコンがあるすべての場所

この項には次のサブセクションが含まれます:

- 第15.5.1項「Fusion Middleware Controlを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択」

- 第15.5.2項「WLSTを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択」

15.5.1 Fusion Middleware Controlを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択

デフォルトの接続を変更するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「メール・サーバー」を選択します。
「メール・サーバー接続の管理」表に、現在のアクティブな接続(ある場合)が示されます(図15-5)。

図15-5 メール・サーバー: アクティブな接続

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」をクリックします。

5. 「アクティブな接続」チェック・ボックスを選択します。

6. 「OK」をクリックして、接続を更新します。

7. 新しいデフォルト接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

15.5.2 WLSTを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択

WLSTコマンドのsetMailConnectionをdefault=trueで使用して、既存のメール・サーバー接続をメール用のデフォルトの接続にします。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetMailConnectionに関する項を参照してください。

デフォルト引数をtrueからfalseに変更しても、その接続がメール用のデフォルトの接続でなくなることはありません。

メール・サーバー接続を無効にするには、その接続を削除するか、別の接続を「アクティブな接続」にするか、またはremoveMailServicePropertyコマンドを使用します。

removeMailServiceProperty(appName='webcenter', property='selected.connection')

このコマンドを使用すると、接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のremoveMailServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
アクティブな接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのコマンド行を使用した管理対象サーバーの起動および停止に関する項を参照してください。

15.6 メール・サーバー接続の詳細の変更

メール・サーバー接続の詳細はいつでも変更できます。

更新されたメール接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

この項には次のサブセクションが含まれます:

- 第15.6.1項「Fusion Middleware Controlを使用したメール・サーバー接続の詳細の変更」

- 第15.6.2項「WLSTを使用したメール・サーバー接続の詳細の変更」

15.6.1 Fusion Middleware Controlを使用したメール・サーバー接続の詳細の変更

メール・サーバー接続の詳細を更新する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「メール・サーバー」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。
パラメータの詳細は、表15-4「メール・サーバー接続の詳細」を参照してください。

6. 「OK」をクリックして、変更を保存します。

7. 更新された接続の詳細の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

15.6.2 WLSTを使用したメール・サーバー接続の詳細の変更

WLSTコマンドのsetMailConnectionを使用して、既存のメール・サーバー接続の詳細を編集します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetMailConnectionに関する項を参照してください。

メール・サーバーとの接続に追加のパラメータが必要な場合は、setMailConnectionPropertyコマンドを使用します。詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のsetMailConnectionPropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
更新された接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのコマンド行を使用した管理対象サーバーの起動および停止に関する項を参照してください。

15.7 メール・サーバー接続の削除

メール・サーバー接続はいつでも削除できますが、アクティブな(またはデフォルトの)接続を削除する際には注意が必要です。メール・タスク・フローはバックエンド・メール・サーバーを必要とするため、アクティブな接続を削除すると機能しなくなります。

接続を削除するとき、メール・サーバー接続に関連付けられている外部アプリケーションの目的がこの接続をサポートすることのみであれば、その外部アプリケーションを削除することを考慮してください。詳細は、第23.6項「外部アプリケーション接続の削除」を参照してください。

この項には次のサブセクションが含まれます:

- 第15.7.1項「Fusion Middleware Controlを使用したメール接続の削除」

- 第15.7.2項「WLSTを使用したメール接続の削除」

15.7.1 Fusion Middleware Controlを使用したメール接続の削除

メール・サーバー接続を削除するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「メール・サーバー」を選択します。

4. 接続名を選択し、「削除」をクリックします。

5. この変更を行うには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

注意:
管理対象サーバーを再起動する前に、別の接続をアクティブとしてマークしてください。そうしないとメールが無効になります。

15.7.2 WLSTを使用したメール接続の削除

WLSTコマンドのdeleteConnectionを使用して、メール・サーバーの接続を削除します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

15.8 メールのデフォルトの設定

WLSTコマンドのsetMailServicePropertyを使用して、メールのデフォルトを設定します。

- address.delimiter: 複数のメール・アドレスの区切りに使用するデリミタを定義します。デフォルトではカンマが使用されます。
メール・サーバーによっては、lastname, firstnameという形式のメール・アドレスを必要とするものがあります。その場合はセミコロンが必要です。

- mail.emailgateway.polling.frequency: 新着のメール・メッセージがないかどうかポータル配信リストが確認される間隔(秒)。デフォルトは1800秒(30分)です。
WebCenter Portal配信リストによるメール通信は、ディスカッション・フォーラム投稿としてディスカッション・サーバー上で公開できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のディスカッション・フォーラムでのポータル・メールの公開に関する項を参照してください。

- mail.messages.fetch.size: メール受信箱に表示する最大のメッセージ数。

- resolve.email.address.to.name: LDAPが構成されている場合に、ユーザー・メール・アドレスをWebCenter Portalのユーザー名に解決するかどうかを指定します。有効な値は、1 (true)および0 (false)です。デフォルト値は0です。
1に設定すると、電子メール・アドレスのかわりにWebCenter Portalのユーザー名がメール・タスク・フローに表示されます。

メールが電子メール・アドレスを提供したときにプレゼンス情報を取得できないために、インスタント・メッセージとプレゼンスがユーザー名を使用してプレゼンス・ステータスを取得する必要がある場合は、このプロパティを1に設定します。この値を1に設定すると、アプリケーションのパフォーマンスに影響します。したがって、このプロパティを設定するときには、この点を考慮してください。

- mail.recipient.limit: 受信者数をメッセージに制限します。たとえば、この値を「500」に設定すると、受信者数が500に制限されます。

コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetMailServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

15.9 メール・サーバー接続のテスト

Thunderbird、Outlookなどの任意のクライアントを使用してメール・サーバーに接続することによって、メール・サーバーが稼働していることを確認します。

Microsoft Exchangeの場合、「Administrative Tools」→「Services」に移動して、次のコンポーネントが実行中(「Status」が「Started」)であることを確認します。

- Microsoft Exchange IMAP4

- 簡易メール転送プロトコル(SMTP)

15.10 WebCenter Portalのメール通知の送信の構成

システム管理者は、WebCenter Portalの管理設定を使用したメール・オプションの設定を担当します(図15-6)。

図15-6 メール・オプションの設定

このページから、メール送信機能のメール・クライアントを割り当てることができます。この機能により、アプリケーション・アセットは、メール送信アイコンを使用して、タスク・フローから直接メールを送信できます(図15-7)。

図15-7 メール送信アイコン

たとえば、ユーザーはお知らせのメール送信アイコンをクリックして、お知らせテキスト、作成者、作成日および場所などの情報があらかじめ入力されたメール・ウィンドウを開くことができます。これらは必要に応じて、編集したりメールに追加したりできます。メール・ウィンドウの事前入力方法は、送信側のリソースによって異なります。たとえば、Wikiからでは、メール送信によって、Wiki名、サイズ、作成者、作成日、修正者、修正日およびWikiへのURLリンクがあらかじめ入力されたメール・ウィンドウが開きます。

ポータル内では、ポータルのすべてのメンバーにメールを送信できます。これが、ポータル作成時のデフォルトの配信リストになります。モデレータ(および、ポータルでManage Configuration権限を付与されたすべてのユーザー)が、ポータルの管理者設定の「ツールとサービス」ページでこれを設定します。『Oracle WebCenter Portalでのポータルの構築』のポータルのメール配信リストの構成に関する項を参照してください。

WebCenter Portalのすべてのメール送信通知において、Microsoft Outlook、Mozilla Thunderbirdなどのローカル・メール・クライアント、またはWebCenter Portalポータル独自のメール・サービスを使用できます。ローカル・メール・クライアントがデフォルトです。メール送信機能には、メール・サービスは必要ありません。つまり、メール・サービスが未構成の場合でも、WebCenter Portalのメール・サービスでメール送信機能を使用できます。アプリケーション・スペシャリストまたはポータル・モデレータは、ポータル参加者がデフォルトのメール・クライアント設定をオーバーライドできるかどうかを指定できます。

注意:
一部のブラウザでは、英語以外のほとんどの言語でメール送信通知が文字化けします。マルチバイト文字をエンコードするとき(「mailto:」プロトコルで必要)には、URLの長さがブラウザの上限を超えます。回避策として、ローカル・メール・クライアントではなく、WebCenter Portalのメール・サービスを使用するようにメール送信機能を構成します。

システム管理者として、ユーザーがデフォルトのメール・クライアント設定をオーバーライドできるかどうかを指定することもできます。

関連項目:
第15.4項「メール・サーバーの登録」

15.10.1 メール通知の送信の共有メール接続の有効化

メール・サーバー接続に関連付けられた外部アプリケーションに対して、共有資格証明が構成されている場合、ユーザーはWebCenter Portalのメール・サービスを使用してメールを送信するときに資格証明を指定する必要がなくなります。

共有メール接続を有効にするには:

1. ポータルがメールの送信にWebCenter Portalのメール・サービスを使用していることを確認します。

1. 「管理」タブを開きます。

2. 「ツールとサービス」をクリックして、「メール」を選択します。

3. 「メールの送信のデフォルト・メール・クライアント」が「WebCenter Portalのメール・サービス」に設定されていることを確認します。

第15.10項「WebCenter Portalのメール通知の送信の構成」も参照してください。

2. 共有資格証明で構成された外部アプリケーションを使用するメール接続を設定し、このメール接続の名前を記録します。

3. 共有メール資格証明が必要になるポータルを開き、共有メール接続の名前を指定します。
詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルの共有メール接続の構成に関する項を参照してください。

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

この項には次のサブセクションが含まれます:

- 第15.11.1項「セキュア・モードでメールにアクセスできない」

- 第15.11.2項「非セキュア・モードでメールにアクセスできない」

- 第15.11.3項「非セキュア・モードで配信リストを作成できない」

- 第15.11.4項「セキュア・モードで配信リストを作成できない」

- 第15.11.5項「ポータルでメールのプロビジョニングに失敗する(デフォルトの配信リストが作成されない)」

- 第15.11.6項「ダウンロードしたメール・メッセージの件数を構成できない」

- 第15.11.7項「WebCenter Portalメールを公開およびアーカイブできない」

- 第15.11.8項「Microsoft Exchangeでのパスワードの変更」

- 第15.11.9項「メールの内容が添付ファイルとして送信される」

15.11.1 セキュア・モードでメールにアクセスできない

問題

セキュア・モードで動作するようにメールを構成しましたが、メールにアクセスできません。

解決策

次のことを確認します。

- IMAPおよびSMTPポートが正しく指定されている。第15.4項「メール・サーバーの登録」を参照してください。

- メール・サーバーで次のプロパティがtrueに設定されている。

- mail.imap.secured = true

- mail.smtp.secured = true

15.11.2 非セキュア・モードでメールにアクセスできない

問題

非セキュア・モードで動作するようにメールを構成しましたが、メールにアクセスできません。

解決策

次のことを確認します。

- IMAPおよびSMTPポートが正しく指定されている。第15.4項「メール・サーバーの登録」を参照してください。

- メール・サーバーで次のプロパティがfalseに設定されている。

- mail.imap.secured = false

- mail.smtp.secured = false

15.11.3 非セキュア・モードで配信リストを作成できない

問題

非セキュア・モード、つまりLDAPサーバーでSSLが構成されていない状態で、ポータル配信リストを作成できません。

解決策

メール・サーバーが再インストールされていないか、またはユーザーが削除されていないか確認します。また、LDAPサーバーで、次のパラメータが非セキュア・モードで正しく構成されていることを確認してください。

- ldapHost

- defaultUser

- ldapAdminPassword

- ldapBaseDN

- ldapPort

第15.4項「メール・サーバーの登録」を参照してください。

15.11.4 セキュア・モードで配信リストを作成できない

問題

セキュア・モード、つまりLDAPサーバーでSSLが構成された状態で、WebCenter Portal配信リストを作成できません。

解決策

メール・サーバーが再インストールされていないか、またはユーザーが削除されていないか確認します。また、LDAPサーバーで、次のパラメータがセキュア・モードで正しく構成されていることを確認してください。

- ldapHost

- defaultUser

- ldapAdminPassword

- ldapBaseDN

- ldapPort

- ldap.connection.secure, 'true'

関連項目:
第15.4項「メール・サーバーの登録」

15.11.5 ポータルでメールのプロビジョニングに失敗する(デフォルトの配信リストが作成されない)

問題

WebCenter Portalでポータルの「ツールとサービス」の「メール」ページにアクセスすると、「このポータルのメール・サービスのプロビジョニングに失敗しました」というエラー メッセージが表示され、「配信リスト」フィールドが空白になります。

解決策

ポータルの名前が一意であることを確認します。ポータルの名前が一意でない場合は、配信リストがすでに存在しています。既存の配信リストか、別の配信リストを選択できます。

15.11.6 ダウンロードしたメール・メッセージの件数を構成できない

問題

各ユーザーの受信箱にダウンロードするメール・メッセージの件数を構成できません。

解決策

WLSTコマンドのsetMailServicePropertyを使用します。たとえば、メール・クライアントから100件のメール・メッセージをダウンロードする場合は、次の例のように、mail.messages.fetch.sizeパラメータに100を指定します。

setMailServiceProperty(appName='webcenter',  property='mail.messages.fetch.size', value='100')

コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetMailServicePropertyに関する項を参照してください。

15.11.7 WebCenter Portalメールを公開およびアーカイブできない

問題

WebCenter Portalメールをアーカイブできません。

解決策

アーカイブできない場合、次のことを確認してください。

- WebCenter Portalで、「管理」→「ツールとサービス」→「ディスカッション」に移動します。必要な構成が正しいかどうかを確認します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のディスカッション・フォーラムでのポータル・メールの公開に関する項を参照してください。

- ここで構成されているユーザー・アカウントが配信リストのメンバーであるかどうかを確認します。

- 特定のポータルについて、構成されているフォーラムがディスカッション・サーバーで使用できるかどうかを確認します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のディスカッション・フォーラムでのポータル・メールの公開に関する項を参照してください。

- 配信リストにメールを送信するユーザーがディスカッション・サーバーで使用できるかどうか、またそのユーザーのメール・アドレスが同じかどうかを確認します。

15.11.8 Microsoft Exchangeでのパスワードの変更

問題

複数のユーザーがMicrosoft Exchangeに同じユーザー名とパスワードでログオンし、1人のユーザーがパスワードを変更した場合、すべてのユーザーがログオフするまで元のパスワードは引き続き有効です。

たとえば、ユーザーmontyの現在のパスワードがmypasswordとします。AとBの2人のユーザーが別々のクライアントからWebCenter PortalまたはMicrosoft Exchangeを使用してログオンします。2人ともmonty/mypasswordでログオンし、2人ともメール・メッセージを閲覧できます。ここで、ユーザーAがMicrosoft Exchangeのパスワードをoracle1に変更します。この時点では、パスワードoracle1を使用するユーザーとパスワードmypasswordを使用するユーザーが存在するため、どちらのパスワードも有効です。したがって、新しいユーザーがmonty/mypasswordでログオンしても引き続きメール・メッセージを閲覧できます。

解決策

元のパスワードを使用する既存のユーザー全員がログオフすると、新しいパスワードが有効になります。それまでは、両方のパスワードを使用してログオンできます。

15.11.9 メールの内容が添付ファイルとして送信される

問題

Frameworkアプリケーションでメールを受信したとき、メッセージの内容がメッセージ本文内ではなく、添付ファイル(content.html)として表示される。この現象が発生する可能性があるのは、メール・サーバーでMicrosoft Exchange Server 2003が実行されており、「Microsoft Exchange Server 2007の更新のロールアップ3」がまだインストールされていない場合です。

解決策

「Microsoft Exchange Server 2007の更新のロールアップ3」をダウンロードしてインストールすると、この問題を解消できます。詳細は、http://support.microsoft.com/kb/930468を参照してください。

16 ピープル・コネクションの管理

この章では、ピープル・コネクション・サービスに必要なバックエンド構成の要件について説明します。

この章には次の項が含まれます:

- 第16.1項「ピープル・コネクション・サービスについて」

- 第16.2項「ピープル・コネクションの前提条件」

- 第16.3項「WebCenter Portalのピープル・コネクションの構成」

- 第16.4項「アクティビティ・ストリームのプロキシ・サーバーの設定」

- 第16.5項「アクティビティ・ストリーム・スキーマのアーカイブ」

- 第16.6項「組織ビューの管理チェーンの指定」

- 第16.7項「プロファイルの構成プロパティの設定」

- 第16.8項「プロファイルとアイデンティティ・ストアの同期」

- 第16.9項「プロファイル・サービスのキャッシュ・オプションの構成」

- 第16.10項「ピープル・コネクションに関する問題のトラブルシューティング」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

16.1 ピープル・コネクション・サービスについて

ピープル・コネクション・サービスは、ユーザーのコネクションのアクティビティを作成、連携および追跡するためのソーシャル・ネットワーキング・ツールです。このサービスの各機能により、ユーザーは自分の個人プロファイルの管理、他のユーザーのプロファイルへのアクセス、非定型のフィードバックの提供、メッセージの投稿、アクティビティの追跡ができるほか、他のユーザーとつながることができます。

これは、次のものを含む一連の機能により実現されます。

- アクティビティ・ストリーム: アプリケーションまたはソーシャル・ネットワーキング・アクションによって生成されたユーザー・アクティビティを表示します。

- コネクション: 他のアプリケーション・ユーザーとつながって、情報の共有、パフォーマンスに対するコメント、メッセージの交換およびアクティビティの追跡ができます。

- フィードバック: 非定型のパフォーマンス・フィードバックを他のユーザーに提供できます。

- メッセージ・ボード: 他のユーザーにメッセージを投稿できます。

- プロファイル: 自分の連絡先情報を入力したり、他のユーザーの連絡先情報を表示したりできます。

- パブリッシャ: ステータス・メッセージの公開やファイルおよびリンクの投稿ができます。

ピープル・コネクション・サービスの機能は、前述の5つのカテゴリに分類されます。それぞれのカテゴリには一連のタスク・フローが含まれており、それらのタスク・フローを通じてピープル・コネクションの各機能がエンド・ユーザーに提供されます。

関連項目:
ポータルにピープル・コネクション機能を追加する方法については、『Oracle WebCenter Portalでのポータルの構築』の「ポータルへの接続の追加」を参照してください。

WebCenter PortalおよびPortal Frameworkアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後にWebCenter PortalまたはPortal Frameworkアプリケーションに加えた変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。第1.3.5項「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:
Fusion Middleware ControlまたはWLSTを使用して行った、WebCenter Portalツールおよびサービス構成のほとんどの変更は、動的ではありません。変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

ピープル・コネクションの構成の詳細は、第16.3項「WebCenter Portalのピープル・コネクションの構成」を参照してください。

16.2 ピープル・コネクションの前提条件

ピープル・コネクション・サービスを使用するには、WEBCENTERスキーマがデータベースにインストールされている必要があります。

本番環境では、ピープル・コネクションにコネクション候補の母集団を提供する手段として、エンタープライズはバックエンド・アイデンティティ・ストアを利用できます。開発環境では、開発者がテスト・ユーザーをjazn-data.xmlファイルに追加できます。

たとえば、プロファイルでは、WebCenter PortalまたはPortal Frameworkアプリケーションからそのユーザーに提供される大量の情報をバックエンド・アイデンティティ・ストアから取得します。また、プロファイルでは、この情報の一部を変更したり、アイデンティティ・ストアに格納されていない追加データを提供することも可能です。

本番バージョンのアプリケーションのバックエンド(LDAP)アイデンティティ・ストアへの接続の詳細は、第31章「アイデンティティ・ストアの構成」を参照してください。

16.3 WebCenter Portalのピープル・コネクションの構成

この項では、ピープル・コネクション機能に対するアプリケーション全体の値を設定する手順について説明します。次のサブセクションが含まれます:

- 第16.3.1項「ピープル・コネクションの管理設定へのアクセス」

- 第16.3.2項「アクティビティ・ストリームの構成」

- 第16.3.3項「コネクションの構成」

- 第16.3.4項「プロファイルの構成」

- 第16.3.5項「メッセージ・ボードの構成」

- 第16.3.6項「フィードバックの構成」

16.3.1 ピープル・コネクションの管理設定へのアクセス

ピープル・コネクションの管理設定にアクセスするには:

1. WebCenter Portal管理を開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ピープル・コネクション」を選択します。
または、次のURLを使用して、「ピープル・コネクション」を選択します。

http://host:port/webcenter/portal/admin/tools

ピープル・コネクションの機能名を示すタブが右側に表示されます。

16.3.2 アクティビティ・ストリームの構成

アクティビティ・ストリームは、ユーザーのアプリケーション・アクティビティを公開および追跡する手段を提供します。アクティビティ・ストリームの構成設定では、ストリーミングの対象にするユーザーおよびアクティビティ、ストリーミングしたユーザーのアクティビティを表示できるユーザー、およびストリーミングしたアクティビティごとにお気に入り登録とコメントの機能を有効にするかどうかを指定します(図16-1)。

図16-1 ピープル・コネクションの管理設定

どのユーザーにユーザーのアクティビティを表示して、どのタイプのアクティビティを追跡するかは、アクティビティ・ストリームの構成で決定します。表16-1に、アクティビティ・ストリームで追跡できるアクティビティのタイプを示します。

表16-1 アクティビティ・ストリームで追跡するアクティビティ

機能領域

追跡されるアクティビティ

スコープ

アクティビティの共有または非公開

お知らせ

- お知らせの作成

- お知らせの編集

ポータル

他のポータル・メンバーと共有

ブログ

- ブログの作成

- ブログの更新

- ポータル

- ホーム・ポータル

- ポータルのブログに対するアクティビティは、他のポータル・メンバーと共有されます。

- ホーム・ポータルのブログに対するアクティビティは、ブロガーのコネクションと共有されます。

コネクション

- コネクションへの招待

- コネクションへの参加

ホーム・ポータル

招待側と招待者のコネクションの共有

ディスカッション

- フォーラムの作成

- トピックの作成

- トピックへの返信

ポータル

他のポータル・メンバーと共有

ドキュメント

- ドキュメントの作成

- ドキュメントの編集

- タグの追加

- タグの削除

- ポータル

- ホーム・ポータル

- ポータルのドキュメントに対するアクティビティは、他のポータル・メンバーと共有されます。

- ホーム・ポータルのドキュメントに対するアクティビティはユーザーに非公開になります。

イベント

- イベントの作成

- イベントの編集

ポータル

他のポータル・メンバーと共有

フィードバック

- フィードバックの投稿

- フィードバックの受信

ホーム・ポータル

該当するアクティビティの表示を許可されたユーザーとの共有。(詳細は、『Oracle WebCenter Portalの使用』のフィードバック・プリファレンスの設定に関する項を参照してください。)

リスト

- リストの作成

- リストへの行の追加

- リスト行の編集

ポータル

他のポータル・メンバーと共有

メッセージ・ボード

- メッセージの投稿

- メッセージの受信

ホーム・ポータル

該当するアクティビティの表示を許可されたユーザーとの共有。(詳細は、『Oracle WebCenter Portalの使用』のメッセージ・プリファレンスの設定に関する項を参照してください。)

ページ

- ページの作成

- ページの編集

- タグの追加

- タグの削除

- ポータル

- ホーム・ポータル

- ポータルのページに対するアクティビティは、他のポータル・メンバーと共有されます。

- ホーム・ポータルのページに対するアクティビティはユーザーに非公開になります。

プロファイル

- 写真の更新

- プロファイルの更新

- 個人ステータス・ノートの更新

ホーム・ポータル

該当するアクティビティの表示を許可されたユーザーとの共有。(詳細は、『Oracle WebCenter Portalの使用』のプロファイル・プリファレンスの設定に関する項を参照してください。)

WebCenter Portal管理

- ポータルの作成

- ポータルへの参加

ポータル

他のポータル・メンバーと共有

タグ付け

- タグの追加

- タグの削除

- ポータル

- ホーム・ポータル

- ポータル内でのアクティビティは、すべてのポータル・メンバーと共有されます。

- ホーム・ポータル内でのアクティビティは、該当するアクティビティの表示を許可されたすべてのユーザーと共有されます。(詳細は、第16.3.2項「アクティビティ・ストリームの構成」および『Oracle WebCenter Portalの使用』のアクティビティ・ストリーム・プリファレンスの設定に関する項を参照してください。)

アクティビティ・ストリームの構成は、次のカテゴリに分類されます。

- 人 - どのユーザーのアクティビティを表示するかを決定する場合(現在のユーザーまたは現在のユーザーとユーザーのコネクションの両方)。

- WebCenter Portal - 使用可能なすべてのポータルのアクティビティまたはホーム・ポータルのみのアクティビティを表示するかどうかを決定する場合。

- サービス・カテゴリ - アクティビティを報告するサービスを選択して、それらのデフォルトの選択内容をユーザーが個人プリファレンスでオーバーライドできるようにする場合、またはオーバーライドを禁止する場合。

- プライバシ - 現在のユーザーのアクティビティを表示できるユーザーを選択する場合。

- コメントとお気に入り登録 - 投稿されたアクティビティにユーザーがコメントできるようにする場合、および投稿されたアクティビティを気に入っていることを示せるようにする場合。

すべてのユーザーに対するアクティビティ・ストリームを構成するには:

1. WebCenter Portal管理を開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ピープル・コネクション」を選択します。
または、次のURLを使用して、「ピープル・コネクション」を選択します。

http://host:port/webcenter/portal/admin/tools

ピープル・コネクションの機能名を示すタブが右側に表示されます。

3. 「アクティビティ・ストリーム」タブをクリックして、そのタブを手前に表示します。

4. 「人」の下で、どのユーザーのアクティビティを表示するかを選択します。

- 自分のみ - 現在のユーザーのアクティビティのみを、そのユーザーのアクティビティ・ストリームのビューに表示します。

- 自分とマイ・コネクション - 現在のユーザーのアクティビティと、そのユーザーのコネクションのアクティビティを、そのユーザーのアクティビティ・ストリームのビューに表示します。

- 個人用以外 - 現在のユーザーのアクティビティ・ストリームのビューから、ホーム・ポータルからストリーミングされるアクティビティをすべて省略します。

5. 「ポータル」の下で、次の項目から表示するアクティビティを選択します。

- すべてのポータル - ユーザーがアクセスできるすべてのポータル

- マイ・ポータル - ユーザーがモデレータになっているすべてのポータル

- ポータルなし - ホーム・ポータルのみ

6. 「サービス・カテゴリ」の下で、アクティビティを公開するサービスを選択します。

注意:
サービスのアクティビティは、選択されていないものも追跡されますが、アクティビティ・ストリームには表示されません。このアクティビティを後から表示するように選択すると、選択されていなかったときに発生したすべてのアクティビティが表示されます。

表16-1に、アクティビティ・ストリームで追跡されるアクティビティを示します。

7. 必要に応じて、「所有者オーバーライドの許可」を選択して、ユーザーが個人プリファレンスから特定のサービスの設定をオーバーライドできるようにします。
このチェック・ボックスの選択を解除すると、ユーザーは、ここで設定したアプリケーション・デフォルトをオーバーライドできなくなります。

8. 「プライバシ」の下で、現在のユーザーのアクティビティを表示できるユーザーを指定した後、それらのユーザーがこの設定を個人プリファレンスでオーバーライドできるかどうかを指定します。
表16-2に、各オプションのリストと説明を示します。

表16-2 アクティビティ・ストリームの「プライバシ」のオプション

オプション

説明

すべてのアクティビティを表示できるユーザー

他のユーザーのアクティビティを表示できるユーザーを指定します。

- 全員 - すべてのユーザー(ログインしていないユーザーも含む)が、他のユーザーのアクティビティを表示できます。

- 認証済ユーザー - ログインしているユーザーが、他のユーザーのアクティビティを表示できます。

- マイ・コネクション - ユーザーBがユーザーAをコネクションとして承諾している場合、ユーザーAはユーザーBのアクティビティを表示できます。ユーザーAは、ユーザーAのアクティビティも表示できます。

- 自分 - ユーザーAのみがユーザーAのアクティビティを表示できます。

所有者オーバーライドの許可

ユーザーが自分の「ピープル・コネクション」の「プリファレンス」からアプリケーションのデフォルト設定をオーバーライドできるようにします(詳細は、『Oracle WebCenter Portalの使用』のアクティビティ・ストリームのプリファレンスの設定に関する項を参照してください)。

9. 「コメントとお気に入り登録」ノードを開いて、お気に入り登録とコメントの書込みを許可するかどうかを指定します。

- 「アクティビティ・ストリームのオブジェクトに対するコメントを有効にします」を選択すると、ユーザーは指定した「アクティビティ・ストリーム」アイテムにコメントできるようになります。このチェック・ボックスの選択を解除すると、ユーザーはコメントできなくなります。

- 「アクティビティ・ストリームのオブジェクトを他のユーザーがお気に入り登録できるようにします」を選択すると、ユーザーはアクティビティ・ストリームのアイテムを気に入っていることを示せるようになります。このチェック・ボックスの選択を解除すると、ユーザーはコメントできなくなります。

ヒント:
ユーザーは、オブジェクトを含むストリーミング・アイテムに対してお気に入り登録とコメントの書込みができます。たとえば、ユーザーは「Jackがdoc.xmlを更新しました」に対してお気に入り登録またはコメントの書込みを行えますが、「JackとJillのコネクションが確立されました」に対してお気に入り登録またはコメントの書込みを行うことはできません。
詳細は、『Oracle WebCenter Portalの使用』の「WebCenter Portalのアイテムに対するお気に入り登録、コメントおよび共有」を参照してください。

10. 「適用」をクリックして、構成設定を保存します。

16.3.3 コネクションの構成

コネクションの構成では、別のユーザーのコネクションを表示できるユーザーを指定した後、それらのユーザーがコネクションへの参加の招待を自動的に承諾するかどうかを指定します(図16-2)。

図16-2 コネクションの構成設定

コネクションを構成するには:

1. WebCenter Portal管理を開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ピープル・コネクション」を選択します。
または、次のURLを使用して、「ピープル・コネクション」を選択します。

http://host:port/webcenter/portal/admin/tools

ピープル・コネクションの機能名を示すタブが右側に表示されます。

3. 「コネクション」タブをクリックして、このタブを手前に表示します。
表16-3に、各オプションのリストと説明を示します。

表16-3 コネクションの構成オプション

オプション

説明

表示アクセス権の付与先

ユーザーのコネクションへの表示アクセス権を自動的に付与するユーザーのクラス

選択したユーザーは、別のユーザーのコネクションの表示と対話が可能になります。

- 全員 - すべてのユーザー(ログインしていないユーザーを含む)が、他のユーザーのコネクションを表示できます。

- 認証済ユーザー - ログインしているユーザーのみが、他のユーザーのコネクションを表示できます。

- ユーザーのコネクション - ユーザーとユーザーのコネクションのみが、ユーザーのコネクションを表示できます。

- ユーザーのみ - 自分のコネクションのみ表示できます。

所有者オーバーライドの許可

管理者による表示アクセス設定を、ユーザーがオーバーライドすることを許可または禁止するオプション。

- 選択すると、ここで指定した管理表示アクセス設定をユーザーが各自の個人プリファレンスでオーバーライドできるようになります(詳細は、『Oracle WebCenter Portalの使用』のコネクション・プリファレンスの設定に関する項を参照してください)。

- 選択解除すると、ユーザーは管理表示アクセス設定をオーバーライドできなくなります。

招待の自動承認

- 選択すると、デフォルトでは、コネクションへの参加の招待がすべて自動的に承諾されます。

- 選択解除すると、デフォルトでは、コネクションへの参加の招待にユーザーが明示的に承諾または拒否する必要があります。

4. 「適用」をクリックして、構成設定を保存します。

16.3.4 プロファイルの構成

認証されたすべてのユーザーには、個人情報(電子メール・アドレス、電話番号、勤務場所、部門、上司、直属の部下など)を表示するプロファイルがあります。すべての属性は、WebCenter Portal用に構成されたLDAPアイデンティティ・ストアに格納され、このストアから読み取られます。ただし、3つの属性を除きます。この3つの例外は、プロファイルの写真と専門分野、およびパブリッシャのステータス・メッセージです。

プロファイルの管理構成設定を使用して、ユーザーに各自のアプリケーション・パスワードの変更を許可するかどうか、どのプロファイル・セクションを表示するか、ユーザーに各自のプロファイルの詳細の更新を許可するかどうかを指定します。また、ユーザーが更新可能なプロファイルの属性を指定します(図16-3)。

図16-3 プロファイルの構成設定

個人プロファイルは、「サマリー」、「従業員」、「勤務先連絡先」、「個人情報」という4つのセクションで示されます。各セクションには、セクション見出しに関連する情報が提示されます。たとえば、「サマリー」には、ユーザーの名前、電子メール・アドレス、事業所所在地などの基本的な詳細の集合が含まれています。

構成設定では、「サマリー」セクションのアクセス設定により、ユーザーを検索できるユーザーを制御します(たとえば、グローバル検索、人ピッカー、他のユーザーを検索してコネクションへの参加を招待する検索など)。たとえば、「サマリー」の表示を「全員」に許可していると、ユーザーは認証されていない(パブリック)ユーザーの検索対象になります。「認証済ユーザー」にのみ他のユーザーの「サマリー」セクションの表示を許可していると、ログインしているユーザーのみがユーザーを検索できるようになります。「このセクションを表示できるユーザー」の値に「なし」を選択すると、そのユーザーは検索結果に表示されなくなります。

「サマリー」セクションは、エンドユーザーが「プリファレンス」から変更できないプライバシ設定の唯一の「プロファイル」セクションです(詳細は、『Oracle WebCenter Portalの使用』のプロファイル・プリファレンスの設定に関する項を参照してください)。これは、この項で説明する設定により、すべてのユーザーに対してグローバル・レベルで制御されますI。

管理者は、各セクションに表示する情報を指定し、ユーザーが各自のプロファイル・データと各自のアプリケーション・パスワードをWebCenter Portalで編集できるようにするかどうかを決定します。

プロファイルを構成するには:

1. WebCenter Portal管理を開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ピープル・コネクション」を選択します。
または、次のURLを使用して、「ピープル・コネクション」を選択します。

http://host:port/webcenter/portal/admin/tools

ピープル・コネクションの機能名を示すタブが右側に表示されます。

3. 「プロファイル」タブをクリックして、このタブを手前に表示します。
表16-4に、各オプションのリストと説明を示します。

表16-4 プロファイルの構成オプション

オプション

説明

パスワード変更の許可

ユーザーが各自のアプリケーション・パスワードを変更できるようにするかどうかを指定します

- 選択すると、ユーザーは自分のアプリケーション・パスワードを変更できるようになります。

- 選択解除すると、ユーザーは自分のアプリケーション・パスワードを変更できなくなります。このオプションは、組織がユーザーの資格証明の管理に単一の個別アプリケーション用意しているため、各アプリケーションからパスワード管理を提供する必要がない場合に役立ちます。

プロファイルのアクセス

どのプロファイル・セクションを表示して、ユーザーが各自のプロファイルの詳細を更新できるようにするかどうかを指定します。

次に示す表の列で、アプリケーションのデフォルトを設定します。

プロファイル・セクション - ユーザー・プロファイルに表示する情報のグループを特定します。

ビューの設定 - 特定のプロファイル・セクションを表示できるユーザーを指定し、それらのデフォルトをユーザーが個人プリファレンスで変更できるかどうかを示します。

「サマリー」セクションの「ビューの設定」では、どのユーザーがサマリーの詳細を表示できるかのみでなく、そのユーザーが人の検索で誰の検索対象になるかについても制御します。

次の項目に値を設定します。

- このセクションを表示できるユーザー - 関連するプロファイル・セクションをデフォルトで表示できるユーザーのグループを指定します。
全員 - すべてのユーザー(ログインしていないユーザーを含む)が、他のユーザーのプロファイルの関連プロファイル・セクションを表示できます。

認証済ユーザー - ログインしているユーザーのみが、他のユーザーのプロファイルの関連プロファイル・セクションを表示できます。

ユーザーのコネクション - 現在のユーザーとのコネクションがあるユーザーが、他のユーザーのプロファイルの関連プロファイル・セクションを表示できます。このオプションは、「サマリー」を除くすべてのセクションで選択できます。

ユーザーのみ - ユーザーのみが各自の関連プロファイル・セクションの詳細を表示できます。

なし - このセクションは、すべてのユーザーに対して非表示になります。

- 所有者オーバーライドの許可 - ここで指定したデフォルトのアプリケーション設定について、ユーザーによるオーバーライドを有効または無効にします。選択すると有効になり、選択解除すると無効になります。

編集可能 - 選択すると、ユーザーは自分の個人プロファイルの関連プロファイル・セクションを編集できるようになります。選択解除すると、関連プロファイル・セクションを編集できなくなります。

この設定では、プロファイル・タスク・フローに「編集」リンクを表示するかどうかも制御します。ただし、デフォルト・バージョンの「プロファイル」ページの「編集」ボタンまたはリンクの表示には影響しません。他のプロファイル管理設定を使用すると、ユーザーによるプロファイルの詳細の変更をすべて禁止できます。

プロファイル属性: 設定の編集

セクションの属性の編集をデフォルトでユーザーに許可することを示します。

「更新の許可」で次のように設定します。

- 属性を選択して、ユーザーが自分のプロファイルでその値を編集できるようにします。

- 属性の選択を解除して、ユーザーが自分のプロファイルで編集できないようにします。

プロファイル・キャッシュ設定

プロファイル詳細のキャッシュを有効化および構成する手段

次の項目に値を指定します。

- キャッシュに保持するプロファイル・オブジェクトの数 - キャッシュ・サイズの値を入力または選択します。デフォルトは1000です。

- プロファイル・オブジェクトをキャッシュに保持するアイドル時間 - キャッシュをリフレッシュするまでオブジェクトを保持しておく時間(分)を入力または選択します。デフォルトは60分です。

- プロファイル同期のLDAP読取りバッチ・サイズ - プロファイルの同期時のバッチごとのLDAPプロファイル数に対する値を入力または選択します。デフォルトは1000です。

- キャッシュの有効期限が切れた時にユーザー・プロファイルの写真をLDAPと同期 - 選択すると、ユーザー・プロファイルの写真を定期的に(WebCenter Portalのプロファイル・キャッシュの有効期限後)LDAPと同期します。選択解除すると、ユーザーは自分のプロファイル・ページから手動で新しい写真をアップロードする必要があります。

キャッシュ設定は、WebCenter Portalの再起動後に有効になります。

4. 「適用」をクリックして、構成設定を保存します。

16.3.5 メッセージ・ボードの構成

メッセージ・ボードは、ユーザーに自分のコネクションに向けたメッセージの表示および投稿の手段を提供します。メッセージ・ボードの構成設定により、メッセージの表示と投稿、ユーザーが残したメッセージの編集と削除、受信したメッセージの削除と表示の変更を誰が行えるかを指定したり、各メッセージに対するコメント書込みとお気に入り登録を有効にするかどうかを制御することができます(図16-4)。

図16-4 メッセージ・ボードの構成設定

関連項目:
お気に入り登録とコメントの詳細は、『Oracle WebCenter Portalの使用』の「WebCenter Portalのアイテムに対するお気に入り登録、コメントおよび共有」を参照してください。

メッセージ・ボードを構成するには:

1. WebCenter Portal管理を開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ピープル・コネクション」を選択します。
または、次のURLを使用して、「ピープル・コネクション」を選択します。

http://host:port/webcenter/portal/admin/tools

ピープル・コネクションの機能名を示すタブが右側に表示されます。

3. 「メッセージ・ボード」タブをクリックして、そのタブを手前に表示します。
表16-5に、各オプションのリストと説明を示します。

表16-5 メッセージ・ボードの構成オプション

オプション

説明

表示アクセス権の付与先

メッセージ・ボードのメッセージを表示できるユーザーを指定します。

- 全員 - すべてのユーザー(ログインしていないユーザーも含む)が、ユーザーのメッセージ・ボードのメッセージを表示できます。

- 認証済ユーザー - ログインしているユーザーのみが、ユーザーのメッセージ・ボードのメッセージを表示できます。

- ユーザーのコネクション - ユーザーおよびユーザーのコネクションのみが、ユーザーのメッセージ・ボードを表示できます。

- ユーザーのみ - ユーザーのみが、自分のメッセージ・ボードでメッセージを表示できます。

投稿アクセス権の付与先

メッセージ・ボードにメッセージを投稿できるユーザーを指定します。

- 全員 - すべてのユーザー(ログインしていないユーザーを含む)が、メッセージ・ボードにメッセージを投稿できます。

- 認証済ユーザー - ログインしているユーザーのみが、メッセージ・ボードにメッセージを投稿できます。

- ユーザーのコネクション - ユーザーおよびユーザーのコネクションのみが、ユーザーのメッセージ・ボードにメッセージを投稿できます。

- ユーザーのみ - ユーザーのみが、自分のメッセージ・ボードにメッセージを投稿できます。

所有者オーバーライドの許可

これらの管理デフォルトをユーザーがオーバーライドできるかどうかを指定します。

- 選択すると、ユーザーが「プリファレンス」からデフォルト設定を編集できるようになります(詳細は、『Oracle WebCenter Portalの使用』のピープル・コネクション・プリファレンスの設定に関する項を参照してください)。

- 選択解除すると、管理者によるデフォルトのアプリケーション設定が強制されます。

ユーザーが他のメッセージ・ボードに投稿するメッセージで処理できるようにします

ユーザーが投稿したメッセージで処理できるかどうかを指定します。

- メッセージの編集 - 選択すると、ユーザーはメッセージ・ボードへの自分の投稿を編集できるようになります。選択解除すると、ユーザーは自分の投稿したメッセージを編集できなくなります。

- メッセージの削除 - 選択すると、ユーザーはメッセージ・ボードへの自分の投稿を削除できるようになります。選択解除すると、ユーザーは自分の投稿したメッセージを削除できなくなります。

ユーザーが他のユーザーから受信したメッセージを処理できるようにします

ユーザーが、他のユーザーから受信したメッセージを処理できるかどうかを指定します

- メッセージの削除 - 選択すると、ユーザーは他のユーザーから受信したメッセージを削除できるようになります。選択解除すると、ユーザーは受信したメッセージを削除できなくなります。

- メッセージの可視性の変更 - 選択すると、ユーザーは特定のユーザーからのメッセージを非表示または表示にできるようになります。選択解除すると、ユーザーはメッセージの非表示または表示ができなくなります。

メッセージ・ボードからのメッセージへのコメントを有効にします

ユーザーがメッセージ・ボードに投稿されたメッセージにコメントできるかどうかを指定します。

- 選択すると、ユーザーはメッセージにコメントできるようになります。「コメント」リンクが、各メッセージの下に表示されます。ユーザーは、これをクリックしてコメントを入力します。詳細は、『Oracle WebCenter Portalの使用』の「WebCenter Portalのアイテムに対するお気に入り登録、コメントおよび共有」を参照してください。

- 選択解除すると、コメントが禁止されます。

メッセージ・ボードからのメッセージのお気に入り登録を有効にします

ユーザーがメッセージを気に入っていることを示せるかどうかを指定します。

- 選択すると、ユーザーはメッセージをお気に入り登録できます。「お気に入り登録」リンクが、各メッセージの下に表示されます。詳細は、『Oracle WebCenter Portalの使用』の「WebCenter Portalのアイテムに対するお気に入り登録、コメントおよび共有」を参照してください。

- 選択解除すると、お気に入り登録できなくなります。

4. 「適用」をクリックして、構成設定を保存します。

16.3.6 フィードバックの構成

フィードバックは、他のアプリケーション・ユーザーへのユーザー・フィードバックを表示および投稿する手段を提供します。フィードバックの構成設定(図16-5)。

図16-5 フィードバックの構成設定

フィードバックの構成設定では、フィードバックの表示、投稿、および削除が可能なユーザーを特定するための制御が提供されます。

フィードバックを構成するには:

1. WebCenter Portal管理を開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ピープル・コネクション」を選択します。
または、次のURLを使用して、「ピープル・コネクション」を選択します。

http://host:port/webcenter/portal/admin/tools

ピープル・コネクションの機能名を示すタブが右側に表示されます。

3. 「フィードバック」タブをクリックして、このタブを手前に表示します。
表16-6に、各オプションのリストと説明を示します。

表16-6 フィードバックの構成オプション

オプション

説明

表示アクセス権の付与先

現在のユーザーのフィードバックを表示できるユーザーを指定します。

- 全員 - すべてのユーザー(ログインしていないユーザーも含む)が、特定のユーザーのフィードバックを表示できます。

- 認証済ユーザー - ログインしているユーザーのみが、特定のユーザーのフィードバックを表示できます。

- ユーザーのコネクション - ユーザーとユーザーのコネクションのみが、特定のユーザーのフィードバックを表示できます。

- ユーザーのみ - 他のユーザーが特定のユーザーのフィードバックを表示できないようにします。

投稿アクセス権の付与先

ユーザー・フィードバックを投稿できるユーザーを指定します。

- 全員 - すべてのユーザー(ログインしていないユーザーも含む)が、特定のユーザーにフィードバックを投稿できます。

- 認証済ユーザー - ログインしているユーザーのみが、特定のユーザーにフィードバックを投稿できます。

- ユーザーのコネクション - ユーザーとユーザーのコネクションのみが、特定のユーザーにフィードバックを投稿できます。

- ユーザーのみ - ユーザーは、自分にのみフィードバックを投稿できます。事実上、フィードバックが無効になります。

投稿されたフィードバックの表示アクセス権の付与先

「表示」メニューを表示して、フィードバック・タスク・フローの投稿したフィードバックと受信したフィードバックの間を切り替えることができるユーザーを指定します。

- 全員 - すべてのユーザー(ログインしていないユーザーも含む)に、「表示」メニューのオプションが表示されます。

- 認証済ユーザー - ログインしているユーザーにのみ、「表示」メニューのオプションが表示されます。

- ユーザーのコネクション - ユーザーとユーザーのコネクションにのみ、「表示」メニューが表示されます。

- ユーザーのみ - 現在のユーザー以外のすべてのユーザーの「表示」メニューが無効になります。各ユーザーが現在のユーザーのフィードバック・タスク・フローにアクセスすると、現在のユーザーが受信したフィードバックのみが表示されます。

所有者オーバーライドの許可

これらの管理デフォルトをユーザーがオーバーライドできるかどうかを指定します。

- 選択すると、ユーザーはユーザー・プリファレンスからアプリケーションのデフォルト設定を変更できるようになります。(詳細は、『Oracle WebCenter Portalの使用』のフィードバック・プリファレンスの設定に関する項を参照してください。)

- 選択解除すると、ユーザーはフィードバックについての管理者設定を変更できなくなります。

ユーザーが他のユーザーへのフィードバックで処理できるようにします

ユーザーが投稿したフィードバックを削除できるかどうかを示します。

- 「フィードバックの削除」を選択すると、ユーザーは自分が投稿したフィードバックを削除できるようになります。

- 「フィードバックの削除」を選択解除すると、ユーザーは自分が投稿したフィードバックを削除できなくなります。

フィードバックの所有者が他のユーザーによって投稿されたフィードバックを処理できるようにします

他のユーザーからのフィードバックをユーザーが非表示または表示にできるかどうかを示します。

- 「フィードバックの可視性の変更」を選択すると、ユーザーは他のユーザーからのフィードバックを非表示または表示にできるようになります。

- 「フィードバックの可視性の変更」を選択解除すると、他のユーザーが投稿したフィードバックを非表示または表示にできなくなります。

4. 「適用」をクリックして、構成設定を保存します。

16.4 アクティビティ・ストリームのプロキシ・サーバーの設定

外部のピープル・コネクションがWebCenter PortalまたはPortal Frameworkアプリケーションでフィードできるようにするには、プロキシ・サーバーを設定する必要があります。

アクティビティ・ストリーム・タスク・フローで外部リンクを表示する場合は、プロキシ・サーバーも必要です。ピープル・コネクション・サービスとアクティビティ・ストリーム・サービスは、同じプロキシ・サーバー設定を共有します。

Fusion Middleware ControlまたはWLSTのいずれかを使用して、プロキシ・サーバーを構成できます。詳細は、第8.2.4項「プロキシ・サーバーの設定」を参照してください。

16.5 アクティビティ・ストリーム・スキーマのアーカイブ

管理者は、WLSTコマンドを使用してアクティビティ・ストリーム・スキーマ内のデータをアーカイブおよびリストアできます。次のコマンドが使用できます。

- archiveASByDate - 指定した日付よりも古いアクティビティ・ストリーム・データをアーカイブします。

- archiveASByDeletedObjects - 削除されたオブジェクトに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- archiveASByClosedSpaces - 現在クローズ中のポータルに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- archiveASByInactiveSpaces - 指定した日付から非アクティブになっているポータルに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- restoreASByDate - 指定した日付以降のアーカイブされたアクティビティ・ストリーム・データを本番の表にリストアします。

- truncateASArchive - アクティビティ・ストリーム・アーカイブ・データを切り捨てます。

- archiveASBySpace - ポータルに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- archiveASAllSpaces - すべてのポータルに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- archiveASByUser - ユーザーに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- archiveASAllUsers - すべてのユーザーに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- archiveASByDeletedActors - 削除されたアクターに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- showASStatistics - アクティビティ・ストリーム統計をレポートします。

詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のアクティビティ・ストリームに関する項を参照してください。

16.6 組織ビューの管理チェーンの指定

組織ビュー・タスク・フローと「プロファイル」ページの「組織」タブでは、管理チェーンの視覚化が提供されます。つまり、上司と直属の部下についてのビューがレンダリングされます(図16-6)。

図16-6 上司と直属の部下についての組織ビュー

デフォルトでは、このような組織ビューの管理チェーンを定義する値は指定されていません。つまり、ユーザーの詳細を提供するバックエンド・アイデンティティ・ストアのユーザーによって、上司が自動的に指定されることはないということです。

ヒント:
「プロファイル」ページの「情報」タブにある「マネージャ」の値も、この項で説明する方法で定義されます。

組織ビューに管理チェーンがレンダリングされるようにするには、「直属の部下」のユーザーにmanager属性が指定されるように、WebCenter Portalの認証に使用するバックエンド・アイデンティティ・ストアを設定する必要があります。また、manager属性は、マネージャ・ユーザーの識別名(DN)として定義する必要があります(「組込みLDAPの構成例」を参照)。

ヒント:
LDAP環境では、1人のユーザーは1人のユーザーによってのみ管理されますが、その同じ環境で、1人のユーザーは複数のユーザーを管理できます。

組込みLDAPの構成例

管理チェーンは、Oracle WebLogic Server (WLS)の組込みLDAPまたはOracle Internet Directory (OID)などの外部LDAPで指定できます。ただし、組込みLDAPで定義する管理チェーンは、テストや概念実証を目的としたもので、本番用ではありません。本番用には、WebCenter Portal認証用アイデンティティ・ストアに、外部LDAP (OIDなど)を使用する必要があります。

関連項目:
詳細は、第31章「アイデンティティ・ストアの構成」を参照するか、使用しているLDAPの実装に付属しているドキュメントを参照してください。

この例では、WebLogic Serverの組込みLDAPでテスト用または概念実証用に管理チェーンを定義する方法について説明します。

注意:
この例で説明する手順は、外部LDAPに対する手順と同様です。つまり、属性(manager)を作成して、ユーザーごとにこの属性の値を設定することになります。この値には、選択したユーザーの上司のDNを入力します。

この例に示すユーザーは次の3人です。

- user1

- user2

- manager_user

これらのユーザーに管理チェーンを定義するには:

1. 外部ビューア(Apache Directory Studioなど)を使用して、組込みLDAPを参照できるようにします。

1. WLS管理コンソールに移動して、管理者ユーザーとしてログインします。

2. ドメイン(例: wc_domain)をクリックして「セキュリティ」タブを開き、「組込みLDAP」サブタブを開きます(図16-7)。

図16-7 Oracle WebLogic Server管理コンソール

3. 「資格証明」フィールドに値を入力し、「資格証明の確認」フィールドに同じ値を再度入力します。

ヒント:
デフォルトの資格証明は、ランダム生成されたパスワードです。覚えやすいものに設定してください。

4. 管理サーバーと管理対象サーバーを再起動します。

2. 手順1で選択したLDAPビューアを起動して、次の詳細を使用して接続を作成します。

- hostname (例: example.com)

- port (WLS管理ポート。例: 7001)

- Bind DN (cn=Admin)

- Password (手順1cで設定した資格証明)

3. DITツリー内でユーザーを探して、user1に移動します(図16-8)。
たとえば、次に示す順でクリックします。

- dc=wc_domain

- ou=myrealm

- ou=people

- uid=user1

図16-8 LDAPブラウザのDITツリーでのユーザーの選択

4. 「属性の説明」列で、managerタイプの新しい属性を追加します。

ヒント:
[Ctrl]、[Shift]、[+]を同時に押すと、「新規属性」ダイアログが開きます。

5. 属性値には、manager_userのDNを選択します(図16-9)。
たとえば、ルートの下で次の順に選択します。

- dc=wc_domain

- ou=myrealm

- ou=people

- uid=manager_user

図16-9 「DNの選択」ダイアログ

6. user2に対して手順3から5を繰り返します。

この時点で、user1とuser2は、manager_userの部下になります。これを確認するには、user1としてWebCenter Portalにログインして、「プロファイル」ページの「情報」タブに移動します。ユーザーmanager_userが、上司として表示されます(図16-10)。

図16-10 「プロファイル」ページの「情報」タブ

ヒント:
「マネージャ」の値(この例では、manager_user)をクリックすると、上司のプロファイルが表示されます。「組織」タブにアクセスすると、現在表示しているプロファイルに関連付けられた組織ビューが表示されます。

16.7 プロファイルの構成プロパティの設定

管理者は、WLSTコマンドを使用してプロファイルの構成プロパティを設定できます(ユーザー・インタフェースに表示されるプロファイルのバージョンの設定など)。管理者は次の操作を実行できます。

- プロファイルの構成プロパティを設定するには、setProfileConfigを実行します。
構文:

setProfileConfigProperties(appName,[ProfilePageVersion], [ProfileCacheNumberOfObjects], [ProfileCacheTimeToLive],[ProfileSyncLDAPReadBatchSize], [ProfileSyncHourOfDay], [ProfileSyncFrequencyInDays], [server],[applicationVersion])

このコマンドは、次のパラメータを受け取ります。

- appName: この操作を実行するWebCenter Portalアプリケーションの名前。(例: webcenter)。

- ProfilePageVersion: (オプション)使用するプロファイル・ページのバージョン。ProfilePageVersionの有効な値は、次のとおりです。

- v1: 旧形式のプロファイル・ページを使用します(11.1.1.7.0以前)

- v2: (デフォルト)新しいプロファイル・ページ(11.1.1.8.0で導入)のフォーマットを使用します

注意:
プロファイル・ページのバージョン変更は、WebCenter Portalアプリケーションがデプロイされているサーバーを再起動するまで有効になりません。

- ProfileCacheNumberOfObjects: (オプション)プロファイル・キャッシュに保持するプロファイル・オブジェクトの数。1から10000までの任意の値。デフォルト値は1000です。

- ProfileCacheTimeToLive: (オプション)プロファイル・オブジェクトをキャッシュに保持しておく時間(分単位)。1から1440までの任意の値。デフォルト値は60です。

- ProfileSyncLDAPReadBatchSize: (オプション)プロファイルの同期時に使用するLDAP読取りバッチ・サイズ。1から1000までの任意の値。デフォルト値は1000です。

- ProfileSyncHourOfDay: (オプション)プロファイル同期を開始する時間(時)。0から23までの任意の値。デフォルト値は23で、午後11時に相当します。

- ProfileSyncFrequencyInDays: (オプション)プロファイルの同期を実行する頻度(日単位)。0より大きい任意の値。デフォルト値は7です。

注意:
パラメータを省略すると、それに対応する構成は変更されずに維持されます。

- 現在のプロファイルの構成設定をリストするには、listProfileConfigを実行します。
構文:

listProfileConfig(appName)

このコマンドは、次のパラメータを受け取ります。

- appName: この操作を実行するWebCenter Portalアプリケーションの名前。(例: webcenter)。

- プロファイル・プロパティの現在の値を取得するには、getProfileConfigを実行します。
構文:

getProfileConfig(appName, key, [server], [applicationVersion])

このコマンドは、次のパラメータを受け取ります。

- appName: この操作を実行するWebCenter Portalアプリケーションの名前。(例: webcenter)。

- key: 取得するプロファイルの構成プロパティの名前。有効な値は次のとおりです。

- ProfilePageVersion

- ProfileCacheNumberofObjects

- ProfileCacheTimeToLive

- ProfileSyncLDAPReadBatchSize

- ProfileSyncHourOfDay

- ProfileSyncFrequencyInDays

- server: (オプション)アプリケーションがデプロイされているターゲット・サーバーの名前。

- applicationVersion: (オプション)アプリケーションのバージョン番号。

16.8 プロファイルとアイデンティティ・ストアの同期

管理者はWLSTコマンドを使用して、LDAPアイデンティティ・ストアのプロファイル情報をWebCenter Portalと同期できます。管理者は次の操作を実行できます。

- startSyncProfilesまたはstopSyncProfilesを実行して、すべてのユーザーまたは1つのユーザーのプロファイル同期を開始または停止します。

- isSyncProfilesRunningを実行して、プロファイル同期が現在実行中かどうかを確認します。

- 様々なプロファイル同期オプションを設定します。

- setProfilePhotoSyncEnabledを実行して、LDAPのユーザー・プロファイル写真を同期するかどうかを指定します。

- syncProfileを実行して、特定のユーザーのプロファイル情報を同期します。

詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のWebCenter Portalアイデンティティ・ストアに関する項を参照してください。

管理者はWebCenter Portalユーザー・インタフェースを使用して、LDAPバッチ・サイズを制御し、写真の同期を有効または無効にすることもできます。

1. WebCenter Portal管理を開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ピープル・コネクション」を選択します。
または、次のURLを使用して、「ピープル・コネクション」を選択します。

http://host:port/webcenter/portal/admin/tools

ピープル・コネクションの機能名を示すタブが右側に表示されます。

3. 右側で、「プロファイル」タブをクリックします。

4. LDAPバッチ・サイズ設定を変更するには、プロファイル・キャッシュ設定で、必要に応じて「プロファイル同期タスクのLDAP読取りバッチ・サイズ」を設定します。

5. 写真の同期を有効または無効にするには、「キャッシュの有効期限が切れたときにユーザー・プロファイルの写真をLDAPと同期」の隣のボックスを選択または選択解除します。

16.9 プロファイル・サービスのキャッシュ・オプションの構成

プロファイル・サービスはオブジェクトをキャッシュに保存して処理帯域幅を節約し、より迅速にユーザーに情報を提供します。次に、プロファイル・サービスのデフォルト・キャッシュ・オプションを示します。

- キャッシュの最大オブジェクト数: 1000
キャッシュの最大オブジェクト数に達すると、新しいオブジェクトが追加されるときに、古いオブジェクトまたは未使用のオブジェクトがキャッシュから削除されます。

- キャッシュの最大アイドル時間: 60秒
キャッシュのオブジェクトが最大アイドル時間の間アクセスされない場合は、キャッシュから削除されます。

プロファイル・サービスの速度が想定するよりも遅い場合は、キャッシュ設定のしきい値を上げることができます。プロファイル・サービスで提供されるデータが十分な頻度で更新されない場合は、キャッシュのしきい値を下げることができます。

管理者は、WebCenter Portalユーザー・インタフェースまたはWLSTコマンドを使用して、プロファイル・サービスのキャッシュ・オプションを構成できます。

- WebCenter Portalユーザー・インタフェースからキャッシュ・オプションを設定するには:

1. WebCenter Portal管理を開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ピープル・コネクション」を選択します。
または、次のURLを使用して、「ピープル・コネクション」を選択します。

http://host:port/webcenter/portal/admin/tools

ピープル・コネクションの機能名を示すタブが右側に表示されます。

3. 右側で、「プロファイル」タブをクリックします。

4. プロファイル・キャッシュ設定で、必要に応じて、「キャッシュに保持するプロファイル・オブジェクトの数」と「プロファイル・オブジェクトをキャッシュに保持する時間」を設定します。

- WLSTを使用してキャッシュ・オプションを設定するには、第16.7項「プロファイルの構成プロパティの設定」の説明に従ってsetProfileConfigコマンドを使用します。
コマンド構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のWebCenter Portalアイデンティティ・ストアに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

16.10 ピープル・コネクションに関する問題のトラブルシューティング

この項では、ピープル・コネクションの使用中に発生する可能性がある問題のトラブルシューティングに役立つ情報を提供します。

問題

JDeveloperワークスペースSampleWebCenterSpacesExtensions.jwsを使用してWebCenter Portalに追加したプロファイル写真が表示されません。

解決策

WebCenter PortalのSampleWebCenterSpacesExtensions.jwsワークスペースを使用してプロファイルの写真を追加したときに、元のプロファイルの写真が表示され続ける場合は、次の手順を実行して、データベースから現在の写真データを削除します。

1. 次のEL式をポータルで使用して、ユーザーに関連付けられたGUIDを特定します。

#{webCenterProfile[securityContext.userName].guid}

2. SQLPlusを使用して、WebCenter PortalデータベースにDBAとして(または、別の管理ユーザーとして)ログインし、次のコマンドを実行します。

DELETE FROM WcPeopleConnProfilePhoto photo WHERE photo.userGuid =USER_GUID;

USER_GUIDは、手順1で記録したユーザーのGUIDに置き換えてください。

17 RSSの管理

この章では、WebCenter PortalおよびPortal Frameworkアプリケーションで使用されるRSS機能を構成および管理する方法について説明します。

この章には次のトピックが含まれます:

- 第17.1項「RSSについて」

- 第17.2項「RSSの前提条件」

- 第17.3項「外部RSSニュース・フィードのためのプロキシ・サーバーの設定」

- 第17.4項「外部RSSニュース・フィード接続のテスト」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

17.1 RSSについて

RSS機能には、RSSビューアと、様々なWebCenter Portalツールおよびサービスからのニュース・フィードを表示するRSSサービスが含まれます。RSSビューアを使用すれば、複数の異なるWebサイトからの外部ニュース・フィードをWebCenter PortalおよびPortal Frameworkアプリケーション内で表示できます。RSSは、最近のアクティビティ、ディスカッション、リストおよびお知らせを含む様々なポータル・リソースからコンテンツ更新情報を配信します。

17.2 RSSの前提条件

RSS機能はバックエンド・サーバーを必要としません。これを使用するために接続を設定する必要はありません。ただし、ネットワーク構成によっては、WebCenter PortalまたはPortal Frameworkアプリケーションが外部RSSニュース・フィードのコンテンツを表示できるように、プロキシ・サーバーの設定が必要になる場合があります。

17.3 外部RSSニュース・フィードのためのプロキシ・サーバーの設定

WebCenter PortalまたはPortal Frameworkアプリケーションで外部RSSニュース・フィードを使用できるようにするには、プロキシ・サーバーを設定する必要があります。

アクティビティ・ストリーム・タスク・フローで外部リンクを表示する場合は、プロキシ・サーバーも必要です。RSSとアクティビティ・ストリームは、同じプロキシ・サーバー設定を共有します。

Fusion Middleware ControlまたはWLSTのいずれかを使用して、プロキシ・サーバーを構成できます。詳細は、第8.2.4項「プロキシ・サーバーの設定」を参照してください。

17.4 外部RSSニュース・フィード接続のテスト

プロキシ・サーバーをRSSビューア用に設定したら、接続をテストして、外部RSSフィードにアクセスできることを確認します。

プロキシ・サーバーがRSSビューア用に適切に設定されていることを確認する手順は次のとおりです。

1. WebCenter PortalまたはPortal Frameworkアプリケーションで、RSSタスク・フローをページに追加します。
RSSタスク・フローの追加およびURLの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』の「RSSニュース・フィードのポータルへの追加」を参照してください。

2. RSSタスク・フローを編集して、外部RSSフィードのURLを設定します。
例:

http://www.oracle.com/ocom/groups/public/@ocom/documents/webcontent/196280.xml

RSSフィードが正しく表示されれば、プロキシの構成は適切に設定されています。

18 WebCenter PortalでのOracle Secure Enterprise Searchの管理

この章では、WebCenter PortalおよびPortal Frameworkアプリケーションのほとんどのオブジェクトを索引付けおよび検索するようにOracle Secure Enterprise Search (SES)リリース11.2.2.2を構成する方法について説明します。

この章には次のトピックが含まれます:

- 第18.1項「Oracle SESを使用した検索について」

- 第18.2項「WebCenter PortalでのOracle SESの構成ロードマップ」

- 第18.3項「Oracle SESを使用するための前提条件」

- 第18.4項「Oracle SES接続の設定」

- 第18.5項「WebCenter Portalアプリケーションを検索するためのOracle SESの構成」

- 第18.6項「Portal Frameworkアプリケーションを検索するためのOracle SESの構成」

- 第18.7項「Oracle SESに関する問題のトラブルシューティング」

ヒント:
Oracle WebCenter Portalには、評価目的でOracle SESを構成できるスクリプトが用意されています。この章で説明されている構成を読んで検討した後、別の構成オプションについて付録D「Oracle Secure Enterprise Searchの評価のための構成」を参照してください。

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

18.1 Oracle SESを使用した検索について

本番環境の最適な検索パフォーマンスおよびスケーラビリティには、Oracle SESをお薦めします。本番環境にWebCenter Portalの固有のライブ(委任)検索を使用することはお薦めしません。Oracle SESは、次の理由により有用です。

- Oracle SESでは、最も関連性の高いアイテムが最初に表示される、統合ランキング結果が提供されます。

- Oracle SESはより徹底的な検索を実行します。たとえば、リストを検索するときには、WebCenter Portalのライブ検索ではリストの名前と説明のみを検索しますが、Oracle SESではリストの列名と列の内容も検索します。

- Oracle SESでは、WebCenter PortalまたはPortal Frameworkアプリケーションの外部にある他のリポジトリを検索できます。

- Oracle SESでは、検索インタフェースをカスタマイズするための検索REST APIとデータ・コントロールがサポートされます。

注意:
Oracle WebCenter Portalのライブ検索アダプタを使用するよう選択した場合は、この章の手順は必要ありません。

検索の環境変数は、構成したOracle SESのバージョンに応じて異なります。例:

- Oracle SES 11.2.2.2を使用したシステムを構成している場合は、アプリケーションの管理設定で検索をカスタマイズできます。Oracle SES 11.2.2.2は、ファセット検索、検索ボックスでのフィルタ検索、およびドキュメントのサムネイルをサポートしています。これらは、以前のバージョンのOracle SESとライブ(委任)検索ではサポートされません。Oracle SES 11.2.2.2を使用したカスタマイズは、タスク・フローのパラメータが表示されたとしても、すべて、「ツールとサービス」→「検索」管理ページで行います。
「検索」管理ページにアクセスするには、「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「ツールとサービス」→「検索」を選択します。

注意:
この作業は管理者が実行します。ポータル・レベルの検索の使用は、アプリケーション・スペシャリストまたはポータル・モデレータの作業になります(詳細は、『Oracle WebCenter Portalでのポータルの構築』の「ポータルへの検索の追加」を参照してください)。

- Oracle SES 11.1.2.*を使用したシステムを構成している場合は、検索(「検索 - 非ファセット検索」)タスク・フロー・パラメータを使用して検索をカスタマイズできます。Oracle SES 11.1.2.*は、検索の保存と、検索によるユーザー・プリファレンスの設定をサポートしています。これらは、11.2.2.2アダプタとライブ(委任)検索による実装ではサポートされません。

注意:
この章では、Oracle SESリリース11.2.2.2を使用したWebCenter Portalの構成方法について説明しています。Oracle SESの以前のリリースを使用するよう選択した場合は、次を参照してください。
http://docs.oracle.com/cd/E28280_01/webcenter.1111/e10148/jpsdg_search.htm#BABBDFDC

WebCenter Portalアプリケーションで、ライブ(委任)検索はデフォルトの検索プラットフォームとして設定されています。ただし、大規模な実装ではOracle SESを使用するよう構成する必要があります。(構成手順の詳細は、第18.5項「WebCenter Portalアプリケーションを検索するためのOracle SESの構成」を参照してください。)

Portal Frameworkアプリケーションで、Oracle SESはデフォルトおよび優先される検索プラットフォームとして設定されています。(構成手順の詳細は、第18.6項「Portal Frameworkアプリケーションを検索するためのOracle SESの構成」を参照してください。)

Oracle SESは、次のリソースを検索するように構成できます。

- ドキュメント(Wikiおよびブログを含む)

- お知らせおよびディスカッション

- ポータル、リスト、ページ・メタデータおよびユーザー

注意:
ポータル、リスト、ページ・メタデータおよび人を索引付けするクローラはPortal Frameworkアプリケーションではサポートされていないため、Portal FrameworkアプリケーションではOracle SESを使用してこれらのリソースを検索できません。
Oracle SESがWebCenter PortalまたはPortal Frameworkアプリケーションを検索するよう構成されている場合、その他のクロールされていないリソース(ノート、イベントなど)は検索結果に返されません。

すべてのソースの結果が合せてリストされ、最も関連性の高いアイテムが最初に表示されます。たとえば、ユーザー名の検索を実行する場合、そのユーザーが作成したドキュメントではなく、そのユーザーの連絡先情報(つまり、ピープル・コネクション内の正確なユーザー名)を探している可能性が高いと考えられます。

WebCenter Portalリソースを索引付けするOracle SESクローラには、次の3つのタイプがあります。

- ドキュメント・クローラ: Oracle SES Content Serverソース・タイプを使用して、Wikiおよびブログを含むドキュメントをクロールします。

- ディスカッション・クローラ: Oracle SES Databaseソース・タイプを使用して、ディスカッションおよびお知らせをクロールします。

- スペース・クローラ: (Portal Frameworkアプリケーションでは使用できません。)Oracle SES Oracle WebCenterソース・タイプを使用して、リスト、ページ・メタデータ、ポータルおよびプロファイルなどの特定のオブジェクトをクロールします。

注意:
Oracle SESクローラはバックエンド・リポジトリへのコネクタ経由でデータを収集します。Oracle SESでは、各コネクタは「クロール・ソース」として構成されます。各クロール・ソースには、リレーショナル・データベースやOracle WebCenter Content Serverリポジトリなどのデータを保持するリポジトリのタイプを識別するためのタイプがあります。

Oracle SESを構成する際には、使用可能なOracle SESクローラをすべて有効化する必要があります。あるOracle SESクローラを有効化して、他のクローラは有効化しないということはお薦めしません。たとえば、Portal Frameworkアプリケーションを検索するようにOracle SESを構成する場合、ドキュメントをクロールして、ディスカッションはクロールしないという構成は指定できません。

ユースケース1: すべてのクロール可能なバック・エンドが設定され、SESを最初に有効化/構成する必要があります

18.2 WebCenter PortalでのOracle SESの構成ロードマップ

この項では、ロードマップを構成プロセスにおける管理者のガイドとして使用します。

- ロードマップ: Oracle SESの構成
図18-1と表18-1に、Oracle SESを動作させるための前提条件と必要な作業の概要を示します。

図18-1 Oracle SESの構成

表18-1 Oracle SESの構成

担当者

タスク

管理者

1. WebCenter PortalとOracle SESをインストールします

2. アイデンティティ管理システムとともにOracle SESを構成します

3. Oracle SESにドキュメント・マネージャを設定します

4. 次のいずれかのツールを使用して、フェデレーション・トラステッド・エンティティを作成します

- Oracle SES管理ツール

- WLST

5. クロール・ユーザーを作成します

6. 次のツールのいずれかを使用して、ドキュメント・クローラ、ディスカッション・クローラおよびスペース・クローラの3つのクロール・ソースを作成します

- Oracle SES管理ツール

- WLST

7. 次のツールのいずれかを使用してクロール・ソースのソース・グループを作成します

- Oracle SES管理ツール

- WLST

8. ファセットおよびソート属性を作成します

9. 次のツールのいずれかを使用して、WebCenter PortalとOracle SES間の接続を構成します

- Oracle SES管理ツール

- WLST

注意: この手順では、WLSTコマンドのsetSESVersionの実行も必要になります。このコマンドにより、「ツールとサービス」→「検索」管理ページを有効にします。

10. (オプション)Oracle SESへの接続をSSLで保護します

11. 次のツールのいずれかを使用して追加の検索パラメータを構成します

- Fusion Middleware Control

- Oracle SES管理ツール

- WLST

アプリケーション・スペシャリスト

12. (オプション)ポータルに検索タスク・フローを追加します

- ロードマップ: Portal FrameworkアプリケーションのためのOracle SESの構成
図18-2と表18-2に、Portal FrameworkアプリケーションでOracle SESを動作させるための前提条件と必要な作業の概要を示します。

図18-2 Portal FrameworkアプリケーションのためのOracle SESの構成

表18-2 Portal FrameworkアプリケーションのためのOracle SESの構成

担当者

タスク

サブタスク

管理者

1. WebCenter PortalとOracle SESをインストールします

2. アイデンティティ管理システムとともにOracle SESを構成します

3. Oracle SESにドキュメント・サービス・マネージャを設定します

4. 次のいずれかのツールを使用して、フェデレーション・トラステッド・エンティティを作成します

- Oracle SES管理ツール

- WLST

5. 次のツールのいずれかを使用して、ドキュメント・クローラおよびディスカッション・クローラの2つのクロール・ソースを作成します

- Oracle SES管理ツール

- WLST

6. 次のツールのいずれかを使用してクロール・ソースのソース・グループを作成します

- Oracle SES管理ツール

- WLST

7. ファセットおよびソート属性を作成します

開発者

8. 検索をPortal Frameworkアプリケーションに統合します

8.a JDeveloperでOracle SESへの接続を構成します

注意: この手順では、WLSTコマンドのsetSESVersionの実行も必要になります。このコマンドにより、「ツールとサービス」→「検索」管理ページを有効にします。

8.b JDeveloperで検索タスク・フローをページに追加します

開発者または管理者

9. 次のいずれかのツールを使用して、Portal Frameworkアプリケーションをデプロイします

- JDeveloper (開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

- WLS管理コンソール(管理者)

管理者

10. (オプション)Oracle SESへの接続をSSLで保護します

管理者

11. 次のツールのいずれかを使用して追加の検索パラメータを構成します

- Fusion Middleware Control

- WLST

- WLS管理コンソール

18.3 Oracle SESを使用するための前提条件

この項には次のトピックが含まれます:

- 第18.3.1項「Oracle SES: インストール」

- 第18.3.2項「Oracle SES: 構成」

- 第18.3.3項「Oracle SES: セキュリティ」

18.3.1 Oracle SES: インストール

この章では、サポートされている最新の製品であるOracle SES 11.2.2.2およびOracle WebCenter Content Server 11.1.1.8.0を実行していることを前提としています。

サポートされるOracle SESのバージョンは、11.2.2.2、11.1.2および11.1.2.2です。最高のパフォーマンスと最新の検索機能を実現するために、Oracle SESリリース11.2.2.2を使用することを強くお薦めします。

注意:
この章では、Oracle SESリリース11.2.2.2を使用したWebCenter Portalの構成方法について説明しています。Oracle SESの以前のリリースを使用するよう選択した場合は、次を参照してください。
http://docs.oracle.com/cd/E28280_01/webcenter.1111/e10148/jpsdg_search.htm#BABBDFDC

WebCenter Portalでは、Oracle SESのインストールの他に、いくつかのインストール後の手順の実行が必要になります。完全な手順については、『Oracle WebCenter Portalインストレーション・ガイド』の検索のバックエンド要件に関する項を参照してください。

関連項目:
Oracle SESに必要なすべてのパッチをインストール済であることを確認することは重要です。必要なパッチの最新情報は、リリース・ノートを確認してください。

18.3.2 Oracle SES: 構成

1. Oracle SESは、ユーザーを検証および認証するためにアイデンティティ管理システムとともに構成する必要があります。これはセキュアな検索のために必要です。そうすることで、検索時に、アクセス権限に基づいてユーザーが表示することを許可される結果のみが返されるようになります。
WebCenter PortalはOracle SESとの通信時にアイデンティティ伝播を使用するため、WebCenter Portalのユーザー・ベースはOracle SESのユーザー・ベースと一致している必要があります。そうするための1つの方法は、WebCenter PortalとOracle SESを、Oracle Internet DirectoryやOracle Unified Directoryなどの同じアイデンティティ管理システムに対して構成することです。

注意:
サポートされているすべてのアイデンティティ管理システムについては、第30.2.3項「デフォルトのアイデンティティ・ストアおよびポリシー・ストア」を参照してください。
各Oracle SESインスタンスに対して、1つのアイデンティティ・プラグインのみを設定できます。すべてのリポジトリ(Oracle WebCenter Content Server、Oracle WebCenter Portal Discussions Server、およびOracle WebCenter Portal)は、Oracle SESと同じユーザー・ベースを共有する必要があります。

Oracle SESには、Oracle Internet Directory (OID)、Oracle Unified Directory (OUD)、Oracle WebCenter Content ServerおよびMicrosoft Active Directoryを含む、アイデンティティ管理システム用の様々なアイデンティティ・プラグインが含まれます。詳細は、Oracle Secure Enterprise Search管理者ガイドのOracle WebCenterソースの設定に関する項を参照してください。

次の例では、Oracle Internet Directory用のアイデンティティ・プラグインを設定します。

1. Oracle SES管理ツールで、「グローバル設定」→「アイデンティティ管理設定」ページに移動し、利用可能なアイデンティティ・プラグインから「Oracle Internet Directory」を選択し、「アクティブ化」をクリックします。

2. 次の値を入力します。
ホスト名: Oracle Internet Directoryが実行されているコンピュータのホスト名

ポート: Oracle Internet Directoryのポート番号

SSLの使用: trueまたはfalse

レルム: Oracle Internet Directoryレルム(dc=us,dc=oracle,dc=comなど)

ユーザー名: Oracle Internet Directory管理ユーザー名(cn=orcladminなど)

パスワード: 管理ユーザーのパスワード

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

次の例では、Oracle Unified Directory (OUD)用のアイデンティティ・プラグインを設定します。

1. Oracle SES管理ツールで、「グローバル設定」→「アイデンティティ管理設定」ページに移動し、利用可能なアイデンティティ・プラグインから「Sun Java System Directory Server」を選択し、「アクティブ化」をクリックします。

2. 次の値を入力します。
ディレクトリURL: OUDインスタンスへのURL (ldap://example.com:1234など)

ディレクトリ・アカウント名: 認証に使用するアカウント名 (cn=Directory Managerなど)

「ディレクトリ・アカウントのパスワード」: アカウント名に対応するパスワード

ディレクトリ・サブスクライバ: (dc=example,dc=comなど)

Directoryセキュリティ・プロトコル: なし

ユーザー・キャッシュの使用: false

3. 「完了」をクリックします。
WebCenter Portalは、IPlanetAuthenticatorプロバイダを使用するように構成する必要があります。

2. WebCenter Portalエンド・ユーザーが検索時にセキュアに伝播されるようにするため、各Oracle SESインスタンスには1つの信頼できるエンティティが必要です。(信頼できるエンティティにより、Oracle SES上で問合せを実行する際にWebCenter Portalが自身をOracle SESに対して認証し、ユーザーをアサートできるようになります。)この信頼できるエンティティは、Oracle SESの背後のアイデンティティ管理サーバーに存在するユーザーにすることも、Oracle SESで内部的に作成されるユーザーにすることもできます。
これはWLSTまたはOracle SESのどちらでも実行できます。

注意:
この信頼できるエンティティ名とパスワードは、後でWLSTコマンドcreateSESConnectionにおけるappUserおよびappPasswordプロパティとして必要になります。

これをWLSTで実行するには、createFederationTrustedEntityコマンド(例18-1)を使用します。

例18-1 createFederationTrustedEntityコマンド

createFederationTrustedEntity(
appName='webcenter',
sesUrl='http://mySEShost.com:7777/search/api/admin/AdminService',
sesPassword='mySESAdminPassword', entityName='myTrustedEntityUser',
entityPassword='myTrustedEntityUserPassword', desc='Trusted entity for WebCenter
Portal', sesSchema='eqsys')

コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のcreateFederationTrustedEntityに関する項を参照してください。

これをOracle SESで実行するには、次の手順に従ってください。

1. Oracle SES管理ツールで、「グローバル設定」→「フェデレーション・トラステッド・エンティティ」ページに移動します。

2. 信頼できるエンティティの名前を入力します。これは、WebCenter Portalが検索時に(エンド・ユーザー・アイデンティティをOracle SESに伝播する前に)自身をOracle SESに対して認証するために使用する名前です。
エンティティがアクティブなアイデンティティ・プラグインによって認証されるようにするには:

- エンティティ名がアイデンティティ管理システム内に存在するユーザーの名前であることを確認します。

- パスワード・フィールドを空白のままにします。

- 「アイデンティティ・プラグインを認証に使用」チェック・ボックスを選択します。

- アクティブなアイデンティティ・プラグインの「認証属性」に対応する認証の属性値を入力します。

エンティティがOracle SESによって認証されるようにするには:

- 任意のユーザー名(例: wcsearch)とパスワード(例: myPassword1)を入力します。

- 「アイデンティティ・プラグインを認証に使用」チェック・ボックスは選択しないでください。

詳細は、Oracle SESの「フェデレーション・トラステッド・エンティティ」ページのオンライン・ヘルプを参照してください。

注意:
参考までに、この章では次のサンプル・ユーザー名が使用されています。

- wcsearch: Oracle SESフェデレーション・トラステッド・エンティティのユーザー

- mycrawladmin: リスト、ページ・メタデータ、ポータル、プロファイルなどの特定のオブジェクトをクロールするための、WebCenter Portalおよびアイデンティティ管理システム内のクロール管理ユーザー

- sescrawer (または管理ユーザー): sescrawlerrole (またはadmin)ロールを持つOracle WebCenter Content Serverのクロール管理ユーザー

18.3.3 Oracle SES: セキュリティ

ほとんどのエンタープライズ・デプロイメントでは、セキュアなHTTP接続が必要です。Secure Socket Layer (SSL)は、インターネット上で機密のコンテンツを安全に送信するための暗号化プロトコルです。パスワードやその他のセキュアなデータをネットワーク上で送信する際には、SSLで保護されたチャネルを使用することを強くお薦めします。

手順の詳細は、第35.10項「SSLを使用したOracle SESへの接続の保護」を参照してください。

18.4 Oracle SES接続の設定

この項には次のトピックが含まれます:

- 第18.4.1項「Oracle SES接続のテスト」

- 第18.4.2項「Oracle Secure Enterprise Searchサーバーの登録」

- 第18.4.3項「アクティブなOracle SES接続の選択」

- 第18.4.4項「Oracle SES接続の詳細の変更」

- 第18.4.5項「Oracle SES接続の削除」

18.4.1 Oracle SES接続のテスト

ブラウザに次のOracle SES Webサービス操作のURLを入力して、Oracle SES接続を確認します。

http://host:port/search/query/

このURLアドレスがブラウザで表示されない場合、Oracle SESサーバーのホストまたはポートのどちらかが間違っているか、またはOracle SESが起動されていません。

注意:
Oracle SES 11.2.2.2では、WLSTコマンドのsetSESVersionの実行が必要になります。このコマンドにより、「ツールとサービス」→「検索」管理ページを有効にします。詳細は、第18.5.5項「WLSTを使用したOracle SESのバージョンの構成」を参照してください。

18.4.2 Oracle Secure Enterprise Searchサーバーの登録

WebCenter Portalアプリケーション(またはPortal Frameworkアプリケーション)には複数のOracle SES接続を登録できますが、一度にアクティブにできる接続はそのうち1つのみです。

Fusion Middleware ControlまたはWLSTを使用してOracle SES接続を登録できます。この項には次のトピックが含まれます:

- 第18.4.2.1項「Fusion Middleware Controlを使用したOracle SES接続の登録」

- 第18.4.2.2項「WLSTを使用したOracle SES接続の登録」

18.4.2.1 Fusion Middleware Controlを使用したOracle SES接続の登録

Oracle SESインスタンスを登録するには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「検索」を選択します。

4. 新規のOracle SESインスタンスに接続するには、「追加」をクリックします(図18-3)。

図18-3 Oracle Secure Searchの構成

5. 「Secure Enterprise Search接続の追加」ページで、この接続の一意の名前を入力し、この接続をアプリケーションのアクティブな(またはデフォルトの)接続にするかどうかを指定します(図18-4)。

図18-4 Secure Enterprise Search接続の追加

表18-3に、接続パラメータを示します。

表18-3 Oracle SES接続: 名前

フィールド

説明

接続名

接続の一意の名前を入力します。名前は、WebCenter Portalアプリケーション(またはPortal Frameworkアプリケーション)のすべての接続タイプにおいて一意である必要があります。

アクティブな接続

これを選択すると、この接続にWebCenter PortalまたはPortal Frameworkアプリケーションの検索プラットフォームとして定義されているOracle SESインスタンスが使用されます。

1つのアプリケーションに対して複数のOracle SES接続を登録できますが、使用される接続はデフォルトの(またはアクティブな)接続1つのみです。

6. Oracle SESインスタンスの接続の詳細を入力します(表18-4)。

表18-4 Oracle Secure Enterprise Search: 接続の詳細

フィールド

説明

SOAP URL

Oracle SESが検索リクエストを有効化するために公開するWebサービスURLを入力します。

次の形式を使用します。

http://host:port/search/query/OracleSearch

例:

http://myHost:7777/search/query/OracleSearch

フェデレーション・トラステッド・エンティティ名

第18.3.2項「Oracle SES: 構成」で作成したOracle SESフェデレーション・トラステッド・エンティティのユーザー名を入力します。

ヒント: このユーザーは、Oracle SES管理ツールの「グローバル設定」→「フェデレーション・トラステッド・エンティティ」ページで構成されます。

WebCenter Portalアプリケーション(またはPortal Frameworkアプリケーション)は、WebCenter Portalユーザーにかわって検索を実行できるように、Oracle SESに対して信頼できるアプリケーションとして自身を認証する必要があります。

この章の例では、この値にwcsearchを使用しています。

フェデレーション・トラステッド・エンティティ・パスワード

フェデレーション・トラステッド・エンティティのパスワードを入力します。

7. 「OK」をクリックして、この接続を保存します。

注意:
新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

18.4.2.2 WLSTを使用したOracle SES接続の登録

1. WLSTコマンドのcreateSESConnectionを使用して、Oracle SESへの接続を作成します。例:

createSESConnection(appName='webcenter',
name='mySesConnection',
url='http://myhost.com:7777/search/query/OracleSearch',
appUser='wcsearch',
appPassword='myPassword1',
default=true)

ここで、appUserは第18.3.2項「Oracle SES: 構成」で作成したOracle SESフェデレーション・トラステッド・エンティティのユーザー名です。

コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のcreateSESConnectionに関する項を参照してください。

新規のOracle SES接続をアクティブに使用するように検索を構成するには、default=trueを設定します。詳細は、第18.4.3.2項「WLSTを使用したアクティブなOracle SES接続の選択」を参照してください。

関連項目:
第18.4.4.2項「WLSTを使用したOracle SES接続の詳細の変更」

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
新しい(アクティブな)接続または設定の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、『管理者ガイド』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

18.4.3 アクティブなOracle SES接続の選択

WebCenter Portalアプリケーション(またはPortal Frameworkアプリケーション)には複数のOracle SES接続を登録できますが、一度にアクティブにできる接続は1つのみです。

注意:
第18.4.2項「Oracle Secure Enterprise Searchサーバーの登録」でアクティブな接続を選択している場合は、この項でそのための手順を実行する必要はありません。

この項には次のトピックが含まれます:

- 第18.4.3.1項「Fusion Middleware Controlを使用したアクティブなOracle SES接続の選択」

- 第18.4.3.2項「WLSTを使用したアクティブなOracle SES接続の選択」

18.4.3.1 Fusion Middleware Controlを使用したアクティブなOracle SES接続の選択

アクティブな接続を変更するには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「検索」を選択します。
「セキュアなEnterprise Search接続の管理」表に、現在のアクティブな接続(ある場合)が示されます。

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」(図18-5)をクリックします。

図18-5 「編集」アイコン

5. 「アクティブな接続」チェック・ボックス(図18-6)を選択します。

図18-6 「アクティブな接続」チェック・ボックス

6. 「OK」をクリックして、接続を更新します。

注意:
新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

18.4.3.2 WLSTを使用したアクティブなOracle SES接続の選択

WLSTコマンドのsetSESConnectionをdefault=trueで使用して、既存のOracle SES接続をアクティブ化します。例:

setSESConnection(appName='app1',
name='SESConn1',
url='http://myhost.com:7777/search/query/OracleSearch',
appUser='wpadmin',
appPassword='password',
default=1)

完全なコマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetSESConnectionに関する項を参照してください。

後からOracle SES接続を無効化するには、同じWLSTコマンドをdefault=falseとともに実行します。接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
アクティブな接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

18.4.4 Oracle SES接続の詳細の変更

Oracle SES接続の詳細はいつでも変更できます。

更新した(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーション(またはPortal Frameworkアプリケーション)がデプロイされている管理対象サーバーを再起動する必要があります。

注意:
この項の手順は、第18.4.2項「Oracle Secure Enterprise Searchサーバーの登録」で構成された詳細を変更する場合にのみ必要になります。

この項には次のトピックが含まれます:

- 第18.4.4.1項「Fusion Middleware Controlを使用したOracle SES接続の詳細の変更」

- 第18.4.4.2項「WLSTを使用したOracle SES接続の詳細の変更」

18.4.4.1 Fusion Middleware Controlを使用したOracle SES接続の詳細の変更

Oracle SESインスタンスの接続の詳細を更新する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「検索」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータ情報の詳細は、表18-4を参照してください。

6. 「OK」をクリックして、変更を保存します。

注意:
更新された(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

18.4.4.2 WLSTを使用したOracle SES接続の詳細の変更

WLSTコマンドのsetSESConnectionを使用して、既存のOracle SES接続を変更します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetSESConnectionに関する項を参照してください。

注意:
更新された(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

18.4.5 Oracle SES接続の削除

Oracle SES接続はいつでも削除できますが、アクティブな接続を削除する際は注意が必要です。アクティブな接続を削除すると、ユーザーは外部リポジトリのコンテンツを検索できなくなります。

この項には次のトピックが含まれます:

- 第18.4.5.1項「Fusion Middleware Controlを使用したOracle SES接続の削除」

- 第18.4.5.2項「WLSTを使用したOracle SES接続の削除」

18.4.5.1 Fusion Middleware Controlを使用したOracle SES接続の削除

Oracle SESサーバー接続を削除するには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「サービス接続」ドロップダウンから、「検索」を選択します。

4. 接続名を選択し、「削除」をクリックします。

図18-7 接続削除アイコン

注意:
この変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

18.4.5.2 WLSTを使用したOracle SES接続の削除

WLSTコマンドのdeleteConnectionを使用して、Oracle SES接続を削除します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
この変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

18.5 WebCenter Portalアプリケーションを検索するためのOracle SESの構成

この項では、WebCenter Portalアプリケーション用にOracle SESを設定するために必要な手順について説明します。次のトピックが含まれています。

- 第18.5.1項「Oracle SESのためのWebCenter Portalの設定」

- 第18.5.2項「Oracle SESのためのOracle WebCenter Content Serverの設定」

- 第18.5.3項「Oracle SESのためのOracle WebCenter Portalディスカッション・サーバーの設定」

- 第18.5.4項「WebCenter Portalを検索するためのOracle SESの設定」

- 第18.5.5項「WLSTを使用したOracle SESのバージョンの構成」

- 第18.5.6項「WLSTを使用した検索クローラの構成」

- 第18.5.7項「ページ・メタデータのクロールのヒント」

注意:
Oracle SESを検索エンジンとして有効化するために実行する必要のあるタスクの概要は、第18.2項「WebCenter PortalでのOracle SESの構成ロードマップ」を参照してください。 必要なタスクを実行するためにふさわしい方法や順序が多数ある場合もあります。

関連項目:
第18.1項「Oracle SESを使用した検索について」

18.5.1 Oracle SESのためのWebCenter Portalの設定

この項では、Oracle SESと連動するようWebCenter Portalを構成する方法について説明します。

1. WebCenter PortalとOracle SES間の接続を作成および構成し、オプションとしてソース・グループを指定します。

関連項目:
第18.4.2.2項「WLSTを使用したOracle SES接続の登録」および第18.4.4.2項「WLSTを使用したOracle SES接続の詳細の変更」

2. Oracle SESを使用してポータル、リストまたはページ・メタデータを検索するには、まずWebCenter Portalおよびバックエンドのアイデンティティ管理サーバー(mycrawladminなど)で、クロール管理ユーザーを作成する必要があります。クロール管理ユーザーは一度だけ作成する必要があります。

注意:
ユーザーの作成方法の詳細は、ご使用のアイデンティティ管理システムのドキュメントを参照してください。

次の例では、Oracle Directory Services Managerを使用してmycrawladminユーザーを作成します。

1. 「データ・ブラウザ」タブで、ターゲットcnに移動し、「作成」をクリックします。この例では、「dc=com,dc=oracle,dc=us,cn=Users」に移動します。「オブジェクト・クラスの追加」ダイアログで、該当するオブジェクト・クラスを選択し、「OK」をクリックします。(図18-8)。

図18-8 Oracle Directory Services Manager - 「オブジェクト・クラスの追加」

2. 識別名(DN)パスを見つけて、「選択」(図18-9)をクリックします。この例では、「dc=com,dc=oracle,dc=us,cn=Users」を選択します。

図18-9 Oracle Directory Services Manager - DNパスの選択

3. 「新規エントリの作成」ダイアログで、プロパティを入力し、「次へ」をクリックします(図18-10)。

図18-10 Oracle Directory Services Manager - 「新規エントリの作成」

4. 新規エントリが正常に作成されたことを確認したら、「終了」をクリックします。(図18-11)

図18-11 Oracle Directory Services Manager - 「ステータス」

3. 第18.3.2項「Oracle SES: 構成」で作成したクロール管理ユーザーにクロール・アプリケーション・ロールを付与します。例:

grantAppRole(appStripe="webcenter",
appRoleName="webcenter#-#defaultcrawl",
principalClass="weblogic.security.principal.WLSUserImpl",
principalName="mycrawladmin");

コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のgrantAppRoleに関する項を参照してください。

注意:
WLSTの変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

4. WebCenter PortalでOracle SESクローラを有効にします。
同じWLSTコマンドを使用して、クローラ・プロパティを設定して(つまり、クローラを有効/無効にして)、スペース・クローラのフル・クロールの間隔を指定できます。デフォルトでは、スペース・クローラのフル・クロールは7日ごとに発生しますが、別の頻度を指定することもできます。(増分クロールはOracle SESで設定されたスケジュールによって開始されます。)

例:

setSpacesCrawlProperties(appName='webcenter',
fullCrawlIntervalInHours=168,
spacesCrawlEnabled = true,
documentCrawlEnabled=true,
discussionsCrawlEnabled=true)

注意:
Oracle SESを有効にするには、spacesCrawlEnabled、documentCrawlEnabledおよびdiscussionsCrawlEnabledパラメータは、すべてtrueに設定する必要があります。
クラスタ化されたインスタンスでは、serverパラメータが追加で必要です。たとえば、server="WC_Spaces1"のようになります。

次の例は、WebCenter Portalが8日ごとにスペース・クローラによりフル・クロールを実行するように指定します。

setSpacesCrawlProperties(appName='webcenter',
fullCrawlIntervalInHours=192)

またWLSTを使用して、フル・クロールの間隔(スペース・クローラ)など、WebCenter Portalの現在のクロール設定を返すようにすることもできます。たとえば、次のコマンドは現在のクロール設定を返します。

getSpacesCrawlProperties(appName='webcenter')

WebCenter Crawl Properties:
-----------------
fullCrawlIntervalInHours: 124
spacesCrawlEnabled:       true
documentCrawlEnabled:     true
discussionsCrawlEnabled:  true

5. Fusion Middleware ControlまたはlistDocumentsSpacesPropertiesコマンドを使用して、バックエンドContent ServerがこのWebCenter Portalアプリケーションを識別するために使用する一意の名前と、WebCenter Portalがドキュメントを保存するために使用するプライマリContent Serverの接続名を特定します。
例:

listDocumentsSpacesProperties(appName='webcenter')

レスポンスは次のようになります。

The Documents Spaces container is "/WebCenter1109"
The Documents repository administrator is "sysadmin"
The Documents application name is "WC1109"
The Documents primary connection is "stxxl18-ucm11g"

注意:
返されるアプリケーション名とプライマリ接続を記録してください。これらの値は、後で(第18.5.4.2項「ドキュメントを検索するためのOracle SESの設定」で)Oracle SESでドキュメントをクロールするよう設定する際に必要になります。

注意:
WLSTの変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

18.5.1.1 WLSTを使用した検索パラメータの構成

WLSTコマンドのsetSearchConfigを使用して、検索パラメータを変更します。

例18-2は、Oracle SESを検索するデータ・グループ(ソース・グループとも呼ばれる)を指定する方法を示しています。

例18-2 ソース・グループの設定

setSearchSESConfig(appName='webcenter',
dataGroup='mySources')

ここで、dataGroupは、第18.5.4.6項「追加のOracle SES構成」で作成したソース・グループです。

例18-3は、表示される検索結果数を増加させる方法を示しています。Oracle SESの結果で表示される検索結果数のデフォルトの設定は5ですが、一般的に設定される結果数は5より大きくなります。

例18-3 表示される検索結果数の増加

setSearchConfig(appName='webcenter',
numResultsMain=10)

例18-4は、サービスが検索を実行するために許可される最大時間(ミリ秒)を構成する方法を示しています。サービスがいつタイムアウトするかは、主にシステムの負荷に依存します。常にタイムアウト・エラーが生じる場合は、このパラメータを調整してください。

例18-4 WebCenter Portalで検索結果を待機する最大時間の構成

setSearchConfig(appName='webcenter',
executionTimeout=10000)

コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetSearchConfigに関する項を参照してください。

18.5.1.2 Fusion Middleware Controlを使用した検索パラメータとクローラの構成

Fusion Middleware Controlを使用して、Oracle SESを有効化または無効化したり、検索設定を構成できます。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「設定」→「アプリケーション構成」を選択します。

3. 「検索クローラ」セクションで、Oracle SESの使用を選択します。
オプションで、WebCenter Portalコンテンツがクロールされる頻度を指定できます。デフォルトでは、スペース・クローラのフル・クロールは7日ごとに発生しますが、別の頻度を指定することもできます。(3つのクローラすべてにおいて、増分クロールはOracle SESで設定されたスケジュールによって開始されます。)

「適用」をクリックします(図18-12)。

- 図18-12 WebCenter Portal検索のアプリケーション設定

4. 同じページで、必要に応じて「検索設定」パラメータを構成し、「適用」をクリックします。

- Oracle Secure Enterprise Searchデータ・グループ: 検索するOracle SESソース・グループを指定します。値を指定しない場合、Oracle SESインスタンス内のすべてが検索されます。

- 実行タイムアウト: サービスが検索を実行できる最大時間(ミリ秒単位)を入力します。

- 実行者の準備タイムアウト: サービスが検索を初期化できる最大時間(ミリ秒単位)を入力します。

- サービス当たりの結果数 - 保存済検索タスク・フロー: 保存済検索タスク・フローに表示される、サービス当たりの検索結果数を入力します。

- サービス当たりの結果数 - 検索ページ: メインの検索ページから送信された検索に対して、サービスごとに表示する検索結果の数を入力します。すべての結果を表示する場合、ユーザーは「すべて表示」をクリックできます。

- 検索ページの保存済の検索の数: 「保存済検索」リスト(メインの検索ページ上)に表示する保存済検索の数を入力します。

WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要はありません。

18.5.2 Oracle SESのためのOracle WebCenter Content Serverの設定

この項では、Oracle SESによりクロール可能となるようにOracle WebCenter Content Server(特に、WebCenter Portalがドキュメントの格納に使用するContent Server)を構成する方法について説明します。

次の手順はContent Server内で実行する必要があります。

関連項目:
Content Serverのロールおよびユーザーの管理方法を示すContent Serverオンライン・ヘルプ

1. クロール・ユーザーを作成します。
adminロールを持つユーザーでクロールする場合、クロール・ユーザーとして管理ユーザー・アカウントを使用します。

非管理ユーザーでクロールする場合、次の手順に従います。

1. sescrawlerroleロールを作成します。

2. ユーザーsescrawlerを作成し、これにsescrawlerroleロールを割り当てます。このユーザーがOracle SES内にContent Serverを作成します。

3. sceCrawlerRole=sescrawlerroleをconfig.cfg (MW_HOME/user_projects/domains/yourdomain/ucm/cs/config内)に追加します。
または、sceCrawlerRole=sescrawlerrole行をContent Serverのユーザー・インタフェース(「管理」→「一般構成」→「追加の構成変数」)に追加できます。

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

3. Content Serverコンソールで、SESCrawlerExportコンポーネントをコンテンツ・サーバーにインストールします(まだインストールされていない場合)。

1. システム管理者としてContent Serverにログオンします。例: http://host:port/cs。

2. 「管理」ドロップダウン・メニューから、「管理サーバー」(図18-13)を選択します。

図18-13 Content Serverの管理

3. インスタンス名のボタンをクリックします。

4. 左側のペインのメニュー・リストから「コンポーネント・マネージャ」をクリックします(図18-14)。

図18-14 Content Serverの「コンポーネント・マネージャ」

5. 「統合」の下の「SESCrawlerExport」を選択し、「更新」をクリックします。

6. 構成パラメータを入力します。(構成パラメータは、インストール後に変更することもできます。)
SESCrawlerExportにより提供される認証および認可APIのセキュリティを無効にします。つまり、「Secure APIの無効化」をfalseに設定します。これにより、SESCrawlerExportによって提供されるセキュリティが、Content Serverによってではなく内部的に実行されるようになります。

さらに、クラスタ化環境の場合のみ、feedLocパラメータで、Content Serverのノードによりアクセスされる共有ディスク上の場所を指定する必要があります。また、これらの各ノードは同じようにこの場所を参照する必要があります(例: sharedDrive/dir1/dir2)。これは指定されたデフォルトの場所(相対パス)ではないことに注意してください。

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

4. Content Serverリポジトリのスナップショットを撮ります。

1. システム管理者としてContent Serverにログオンします。例: http://host:port/cs。

2. 「管理」ドロップダウン・メニューから、「SESCrawlerExport」を選択します。

3. 「すべてのソース」を選択し、「スナップショットの取得」(図18-15)をクリックします。

図18-15 Content Serverのスナップショット

ソースの最初のクロールまたはその後のフル・クロールの前にスナップショットを撮ることは重要です。

スナップショットにより、コンポーネントのインストール時に指定された場所にconfigFile.xmlが生成され、feedLocの下のソース名のサブディレクトリにフィードが作成されます。

5. Content ServerがWebレンディション用に構成されている場合、Content Server内のアイテムはPDF形式でレンダリングされます。コンテンツ・アイテムのネイティブMIMEタイプのレンディションは上書きされます。たとえば、Microsoft Office WordドキュメントのMIMEタイプはapplication/mswordですが、Content ServerでWebレンディションを使用すると、MIMEタイプはapplication/pdfになります。Mimetypeパラメータをapplication/mswordに設定して検索問合せを実行しても、Wordドキュメントは返されません。
Content ServerがWebレンディションを使用するように構成されている場合、Content Serverメタデータ・リストにdFormat値が含まれるように構成し、必要なMIMEタイプがOracle SESにエクスポートされるようにする必要があります。これは、MIMEタイプで検索を絞り込めるようにするために必要です。

1. 「SESCrawlerExport管理」ページに戻り、「SESCrawlerExportの構成」(図18-31)をクリックします。

図18-16 Content Serverのスナップショット

2. デフォルトでは、「メタデータ・リスト」フィールドは空白です(図18-17)。オプションで、必要な任意のカスタム・メタデータ値(xで始まる)をこのフィールドに追加します。たとえば、「メタデータ・リスト」の次のエントリには、カスタム属性が含まれています。

xCollectionID,xWCTags, xRegionDefinition

図18-17 Content Serverの「メタデータ・リスト」

3. 11.1.1.8より前のバージョンのContent Serverを使用している場合、dFormat値をこの「メタデータ・リスト」フィールドに追加する必要があります。空白の場合のデフォルト値を変更すると、そのデフォルト値は削除されるため、これらを再度追加する必要があります。(Content Server 11.1.1.8には、検索に必要なほとんどの値(dFormatを含む)が含まれています。)
したがって、11.1.1.8より前のバージョンのContent Serverを使用している場合、次のように「メタデータ・リスト」(および「x」で始まるカスタム・メタデータ・フィールド)にデフォルト値を手動で入力する必要があります。

dFormat,dID,dDocName,dRevLabel,dDocType,dDocAccount,dSecurityGroup,
dOriginalName,dReleaseDate,dOutDate,dDocCreator,dDocLastModifier,dDocCreate
dDate,dDocFunction

6. ファセット検索用の「サムネイル・オプション」を構成します。

注意:
Oracle SES 11.2.2.2はドキュメント・サムネイルをサポートしますが、以前のリリースのOracle SESはこれをサポートしません。

「管理」タブで、「サムネイル・オプションの構成」を選択し、検索結果でのドキュメント・サムネイルを有効にします。デフォルト設定のままにし、「更新」をクリックします(図18-18)。

図18-18 サムネイル・オプションの構成

関連項目:
Content Serverの構成の詳細は、製品に同梱のDeployment Guide.pdfを参照してください。

18.5.3 Oracle SESのためのOracle WebCenter Portalディスカッション・サーバーの設定

この項では、Oracle SESによりクロール可能となるようにOracle WebCenter Portalのディスカッション・サーバー(特に、WebCenter Portalがディスカッションおよびお知らせの格納に使用するディスカッション・サーバー)を構成する方法について説明します。

注意:
WebCenter Portal (Oracleデータベースを含む)およびOracle WebCenter Portalのディスカッション・サーバーの新しいインストールがある場合は、この手順は必要ありません。これは、アップグレードされた(パッチが適用された)インスタンスを使用している場合にのみ必要になります。
該当するデータ・ソースのデータベース・スキーマの詳細は、Oracle WebLogic Serverコンソールから検索できます。

1. リポジトリ作成ユーティリティ(RCU)を実行して、ディスカッション・クローラのWebCenter Portalコンポーネントがシステムにインストールされていることを確認します。

- OracleデータベースおよびMicrosoft SQL Serverデータベース:
MyPrefix_DISCUSSIONSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

MyPrefix_DISCUSSIONS_CRAWLERユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に構成されていることを検証します。

- IBM DB2データベース:
MyPrefix_DSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

MyPrefix_DCユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に構成されていることを検証します。

注意:
IBM DB2データベースの場合、MyPrefixは5文字に制限されます。IBM DB2では、認証にオペレーティング・システム・ユーザーが使用されます(つまり、データベース・ユーザーは実質的にはオペレーティング・システム・ユーザーです)。オペレーティング・システムによっては、ユーザー名に8文字の制限があるため、これは8文字のユーザー名にする必要があります。

ディスカッション・クローラ・コンポーネントがインストールされていない場合、RCUを使用してこれをインストールする必要がありますが、このとき、接頭辞は、Oracle WebCenter Portalのディスカッション・サーバー・コンポーネントと同じものを選択します。また、RCUでの表領域の指定手順で、デフォルトの表領域としてPrefix_IAS_DISCUSSIONSを選択します。これにより、Oracle SESのユーザーがインストールされます。

詳細は、第42章「Portal Frameworkアプリケーションのデプロイ」を参照してください。

2. インスタンスがWebCenter 11.1.1.1.0のみからアップグレードされる場合、次のツールを実行して(まだ実行していない場合)、Oracle WebCenter Portalのディスカッション・サーバー・データベース・スキーマ内のデータをアップグレードします。

注意:
この手順は、インスタンスをWebCenter 11.1.1.1.0からアップグレードした場合にのみ必要になります。WebCenter 11.1.1.1.0より後にインストールされたインスタンスでは、必要ありません。

java -jar \
$MW_HOME/discussionserver/discussionserver-upgradeforses.jar \
<command_line_parameters>

ここでcommand_line_parametersは、次のMDSスキーマの詳細とディスカッション・データベース・スキーマの詳細です。

-mds_jdbc_user user_id \
-mds_jdbc_password password \
-mds_jdbc_url url \
-discussions_jdbc_user user_id \
-discussions_jdbc_password password \
-discussions_jdbc_url url

ここでmds_jdbc_user、mds_jdbc_passwordおよびmds_jdbc_urlは、MDSスキーマにログインするための値で、discussions_jdbc_user、discussions_jdbc_passwordおよびdiscussions_jdbc_urlは、ディスカッション・データベース・スキーマにログインするための値です。

例:

java -jar $MW_HOME/as11r1wc/discussionserver/discussionserver-upgradeforses.jar\
-mds_jdbc_user foo \
-mds_jdbc_password myPassword1 \
-mds_jdbc_url jdbc:oracle:thin:@host:port:SID \
-discussions_jdbc_user foo \
-discussions_jdbc_password myPassword1 \
-discussions_jdbc_url jdbc:oracle:thin:@host:port:SID

18.5.4 WebCenter Portalを検索するためのOracle SESの設定

この項の手順は、Oracle SES管理ツールで実行する必要があります。

次の手順が必要です。

1. 第18.5.4.1項「Oracle SES管理ツールへのログオン」

2. 第18.5.4.2項「ドキュメントを検索するためのOracle SESの設定」

3. 第18.5.4.3項「ディスカッションおよびお知らせを検索するためのOracle SESの設定」

4. 第18.5.4.4項「ポータル、リスト、人およびページ・メタデータを検索するためのOracle SESの設定」

5. 第18.5.4.7項「Oracle SESファセットおよびソート属性の構成」

6. 第18.5.4.6項「追加のOracle SES構成」

関連項目:
Oracle SESに必要なすべてのパッチがインストールされていることを確認します。必要なパッチの最新情報は、『Oracle WebCenter Portalインストレーション・ガイド』の検索のバックエンド要件に関する項およびリリース・ノートを参照してください。
Oracle SES構成の詳細は、製品に付属のOracle SESドキュメントを参照してください。(これらは、Oracle Fusion Middlewareドキュメント・ライブラリのWebCenter Portal製品の領域にリストされています。)

18.5.4.1 Oracle SES管理ツールへのログオン

Oracle SES管理ツールを開きます。

1. ブラウザを開き、Oracle SESインストール後に指定されたURLを入力します。(これは、http://host:port/search/admin/index.jspの形式となります。)

2. Oracle SES管理ユーザー名とインストール時に指定されたパスワードでログオンします。

- Oracle SES 11.2.2.2では、デフォルトの管理ユーザー名はsearchsysですが、インストール中に別の名前を指定できます。

- Oracle SES 11.1.*では、管理ユーザー名はeqsysです。

18.5.4.2 ドキュメントを検索するためのOracle SESの設定

Oracle SESを使用してWebCenter Portalドキュメントを検索するには、まずドキュメント・サービス・マネージャを(ドキュメント・サービス・インスタンスおよびドキュメント・サービス・パイプラインとともに)設定してから、Content Serverソースを作成する必要があります。

1. ドキュメント・サービス・マネージャを構成します(Oracle SESインスタンスごとに1回)。

注意:
ドキュメント・サービスは、ドキュメントがクロールされる際のドキュメントの処理に関与するプラグインです。ドキュメント・サービスにより、WebCenter Portalアプリケーションで使用されるドキュメントに索引付け可能な属性をWebCenter Portalで追加できるようになります。
検索属性名は一意である必要があります。2つの属性に同じ名前を使用することはできません。たとえば、属性が文字列のデータ型で存在する場合に、名前が同じで異なるデータ型の別の属性がクローラにより検出されると、そのクローラは2番目の属性を無視します。新しい属性を作成する前に、Oracle SESドキュメント内のOracle SES属性名とタイプのリストを必ず確認してください。

1. 「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。「新規マネージャの作成」を選択し、「次へ」をクリックして次のパラメータを入力します。
マネージャ・クラス名: oracle.webcenter.search.crawl.ucm.ses.WcUcmDsManager

マネージャJARファイル名: search-crawl-ucm.jar

注意:
webcenter_doc_pipeline_plugin.zipファイルによりOracle_Home/search/lib/plugins/doc/search-crawl-ucm.jarがインストールされます。

「次へ」をクリックして、「終了」をクリックします(図18-19)。

図18-19 Oracle SESでのドキュメント・サービス・マネージャの作成

2. ドキュメント・サービス・インスタンスを作成します。
再度、「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。今回は、「利用可能なマネージャから選択」で「Secure Enterprise Search WebCenter UCMプラグイン」を選択し、「次へ」をクリックします(図18-20)。

図18-20 ドキュメント・サービスの作成

次のパラメータを入力します。

インスタンス名: ドキュメント・パイプラインを作成するときに使用する名前をここに入力します。

WebCenterアプリケーション名: バックエンドContent ServerでこのWebCenter Portalアプリケーションを識別するために使用される一意の名前。

接続名: WebCenter Portalがドキュメントの保存に使用するプライマリContent Server接続の名前です。

WebCenter URL接頭辞: WebCenter Portalアプリケーションがデプロイされるホストおよびポート。例: http://myhost:8888。

注意:
Fusion Middleware ControlまたはlistDocumentsSpacesPropertiesコマンドを使用して、第18.5.1項「Oracle SESのためのWebCenter Portalの設定」の説明に従って、アプリケーション名と接続名を特定してください。

3. ドキュメント・サービス・パイプラインを作成します。これによりドキュメント・サービス・インスタンスが呼び出されます。再度、「グローバル設定」→「ドキュメント・サービス」ページで、「ドキュメント・サービス・パイプライン」セクションの下の「作成」をクリックします(図18-21)。

図18-21 ドキュメント・サービス・パイプラインの作成

4. 「ドキュメント・サービス・パイプラインの作成」ページで、このパイプラインのカスタム名を入力します。前の手順で作成したドキュメント・サービス・インスタンスが「使用可能なサービス」の下にリストされるはずです。このドキュメント・サービス・インスタンスを選択し、矢印ボタンを使用してこれを「パイプラインで使用済」の下に移動します。

2. ドキュメントのContent Serverソースを作成します。

関連項目:
Content Serverソースを作成する別の方法は、第18.5.6項「WLSTを使用した検索クローラの構成」を参照してください。

1. 「ホーム」→「ソース」に移動します。

2. 「ソース・タイプ」ドロップダウン・リストで、「Content Server」を選択し、「作成」(図18-22)をクリックします。

図18-22 Content Serverソースの作成

3. 次のパラメータを入力します。
ソース名: unique_name

構成URL: Content_Server_SES_Crawler_Export_endpoint (例: http://host:port/cs/idcplg?IdcService=SES_CRAWLER_DOWNLOAD_CONFIG&source=default)

注意:
source=defaultパラメータは、SESクローラ・エクスポートの構成で作成されたソースの名前を示します。デフォルトのソースが作成され、自動的にdefaultと名付けられます。

認証タイプ:

SSOで保護されない場合、NATIVEと入力します。

Content ServerがOracle SSOで保護される場合、ORASSOと入力します。

ユーザーID: Content Serverをクロールするユーザーには、sceCrawlerRoleロールが定義される必要があります。sceCrawlerRoleは、SESCrawlerExport内の構成パラメータです。一般には、管理者が特別のロールを作成し、これにはコンテンツを表示する権限を割り当てず、このロールを持つユーザー・アカウントを作成します。

特定のsceCrawlerRoleを設定しない場合、クロールには管理資格証明が必要です。sysadminユーザーIDはデフォルトで機能します。

認証タイプがORASSOの場合、Oracle SSOが前面に来るアイデンティティ管理サーバー内のユーザーのID (およびパスワード)を入力します。このユーザーには、sysadminと同じ権限が付与される必要があります。これらの権限を付与できない場合は、このユーザーに対応するContent Server内のリモート・ユーザーを削除し、Content Server内で(同じ名前の)ローカル・バージョンのユーザーを作成します。

パスワード: このContent Serverユーザーのパスワード。

レルム:

認証タイプがNATIVEの場合、Idc Security /cs/idcplgと入力しますが、ここで/cs/は、Content Serverのインストール時に指定したコンテキスト・ルートです。

認証タイプがORASSOの場合、このパラメータは空白のままにします。

スクラッチ・ディレクトリ: オプション。Oracle SESインスタンスが配置されるシステム上のディレクトリを指定します。

Oracle SSOログインURL:

認証タイプがORASSOの場合、Oracle SSOの値を指定します。例: https://login.oracle.com/mysso/signon.jsp?site2pstoretoken=

認証タイプがNATIVEの場合、このフィールドは空白のままにします。

Oracle SSOアクションURL:

認証タイプがORASSOの場合、Oracle SSOの値を指定します。例: https://login.oracle.com/sso/auth

認証タイプがNATIVEの場合、このフィールドは空白のままにします。

「次へ」をクリックします(図18-23)。

図18-23 Content Serverソースのパラメータ

4. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページの「認可マネージャ」セクションで次のパラメータを入力します(デフォルトで入力されていない場合)。
プラグイン・クラス名: oracle.search.plugin.security.auth.stellent.StellentAuthManager

Jarファイル名: oracleapplications/StellentCrawler.jar

認可用HTTPエンドポイント: 例: http://host:port/cs/idcplg

表示URL接頭辞: 例: http://host:port/cs

認証タイプ: NATIVEまたはORASSO

管理者ユーザー: Content Serverをクロールするユーザーには、sceCrawlerRoleロールが定義される必要があります。sceCrawlerRoleは、SESCrawlerExport内の構成パラメータです。一般には、管理者が特別のロールを作成し、これにはコンテンツを表示する権限を割り当てず、このロールを持つユーザー・アカウントを作成します。特定のsceCrawlerRoleを設定しない場合、クロールには管理資格証明が必要です。sysadminユーザーIDはデフォルトで機能します。

認証タイプがORASSOの場合、Oracle SSOが前面に来るアイデンティティ管理サーバー内のユーザーのID (およびパスワード)を入力します。このユーザーには、sysadminと同じ権限が付与される必要があります。これらの権限を付与できない場合は、このユーザーに対応するContent Server内のリモート・ユーザーを削除し、Content Server内で(同じ名前の)ローカル・バージョンのユーザーを作成します。

管理者のパスワード: クロール管理ユーザーのパスワード

認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を見つけるには、Oracle SESで、「グローバル設定 - アイデンティティ管理設定」ページに移動します。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(たとえば、nickname、usernameなど)。Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

レルム:

認証タイプがNATIVEの場合、Idc Security /cs/idcplgと入力しますが、ここで/cs/は、Content Serverのインストール時に指定したコンテキスト・ルートです。

認証タイプがORASSOの場合、このフィールドは空白のままにします。

5. 「作成およびカスタマイズ」をクリックして(または作成したソースを編集して)、その他のソース・パラメータを参照します。「クロール・パラメータ」タブで、Document Service Pipelineと入力します。

6. 「有効化」をクリックして作成したパイプラインを選択します。

18.5.4.3 ディスカッションおよびお知らせを検索するためのOracle SESの設定

Oracle SESを使用してWebCenter Portalのディスカッションとお知らせを検索するには、まず、ディスカッション用に3つとお知らせ用に1つのOracle SESデータベース・ソースを設定する必要があります。3つのディスカッション・リソースは、フォーラム用、フォーラム内のトピック用およびフォーラム内の応答用です。これら個別のソースを使用すると、ユーザーは、フォーラム内のすべてのメッセージおよび応答の結果を表示せずにフォーラムの検索結果を表示できます。

たとえば、ディスカッション・ソースに次のものがあるとします。

- ソース名GS_ForumsおよびビューFORUMCRAWLER_VW

- ソース名GS_TopicsおよびビューTHREADCRAWLER_VW

- ソース名GS_RepliesおよびビューMESSAGECRAWLER_VW

お知らせのソースのソース名をGS_Announcements、ビューをANNOUNCEMENTS_VWにできます。

注意:
Oracle、Microsoft SQL ServerおよびIBM DB2データベースでは、手順が多少異なります。

1. JDBCドライバを構成します。

1. Microsoft SQL ServerまたはIBM DB2データベースをクロールするには、適切なJDBCドライバjarファイルをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。

注意:

- Microsoft SQL Serverの場合: Microsoft JDBCドライバ・ファイル、sqljdbc.jarおよびsqljdbc4.jarをコピーします。

- DB2: IBMドライバ・ファイルdb2jcc.jarおよびdb2jcc_license_cu.jarをコピーします(IBM DB2 UDBクライアントから取得可能)。

JDBCドライバがJRE 1.5用とJRE 1.6用で異なる場合(たとえば、JRE 1.5ではsqljdbc.jar、JRE 1.6ではsqljdbc4.jarなど)、次の手順を実行します。

- 両方のドライバJarをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。

- JRE 1.6バージョンのドライバJar (SQLServerの場合sqljdbc4.jar)のエントリを、ORACLE_HOME/search/config/searchctl.confのCLASSPATH要素に追加します。

- 中間層を再起動します。

2. drivers.propertiesファイルをDatabaseName:DriverClassNameの情報を使用して更新します。

3. JRE 1.5 JDBCドライバJarファイル名を、appsjdbc.jarおよびDBCrawler.jarのMETA-INF/MANIFEST.MF内のクラスパスに追加します。
例: 変更前

Class-Path:  sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar

変更後

Class-Path:  db2jcc.jar sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar

変更前

Class-Path: appsjdbc.jar

変更後

Class-Path: db2jcc.jar appsjdbc.jar

KEYという名前が付けられていないkey属性の場合、drivers.propertiesファイル内のJDBCドライバ情報を変更して、database_name: driver_class_name, key_attribute_nameのようにキー属性名を指定します。

たとえば、IDという名前のキー属性の場合、次のようになります。

oracle : oracle.jdbc.driver.OracleDriver, ID

クロール問合せでは、キー値列名の別名としてkey_attribute_nameを使用します。この例で、IDはKEYVALの別名です。

SELECT keyval id, content, url, lastmodifieddate, lang FROM sales_only

OracleおよびSQL Serverデータベース: drivers.propertiesになにも指定されていない場合、次のデフォルト・ドライバが使用されます。

- Oracle: oracle.jdbc.driver.OracleDriver

- SQL Server: com.microsoft.sqlserver.jdbc.SQLServerDriver

2. IBM DB2データベースの場合のみ、次の手順が必要となります。

1. データベース・クローラ・ソースを使用するクローラが実行されていないことを確認します。Oracle SES管理ツールの「ホーム」→「スケジュール」ページで、クローラの進捗状況とステータスを確認します。(「ステータスのリフレッシュ」をクリックします。)

2. appsjdbc.jarファイルとDBCrawler.jarファイルを再作成します。クローラが失敗してログ・ファイルに次のエラーが記録されないよう、META-INF/MANIFEST.MFが正しく更新されていることを確認してください。

EQP-80406: Loading JDBC driver failed

3. ORACLE_HOME/search/lib/plugins/oracleapplications/drivers.propertiesファイルを変更して次の行を追加します。

db2: com.ibm.db2.jcc.DB2Driver

4. ORACLE_HOME/search/config/searchctl.confのCLASSPATH要素にドライバJar (db2jcc.jar)を追加します。例:

#CLASS PATH
CLASSPATH=ORACLE_HOME/search/webapp/config:ORACLE_HOME/search/webapp/
SESAuthenticator.jar:ORACLE_HOME/search/lib/plugins/commons-plugins-
stubs.jar :ORACLE_HOME /search/lib/plugins/oracleapplications/db2jcc.jar

5. $ORACLE_HOME/search/config/searchctl.confファイルのJVM_OPTIONSを編集して、システム・プロパティ"-Doracle.home=ORACLE_HOME/search"を追加します。例:

JVM_OPTIONS= -Djava.awt.headless=true
-Dweblogic.RootDirectory=ORACLE_HOME/search/base_domain
-Doracle.home=ORACLE_HOME/search

6. $ORACLE_HOME/search/lib/plugins/oracleapplications/pluginmessages.jarファイルを$ORACLE_HOME/search/libディレクトリにコピーします。

7. データベース・ソースを作成します。正しい認可問合せを入力し、「セキュリティ属性の付与」で使用した属性名が認可問合せで使用する属性名と一致していることを確認します。一致していない場合、ドキュメントの検索の際、ユーザーは結果を得ることができません。

3. ディスカッション・ソースまたはお知らせソースを作成します。

関連項目:
これらのソースを作成する別の方法は、第18.5.6項「WLSTを使用した検索クローラの構成」を参照してください。

1. Oracle SESで、「ホーム」→「ソース」に進みます。

2. 「ソース・タイプ」ドロップダウン・リストで、「データベース」を選択し、「作成」(図18-24)をクリックします。

図18-24 データベース・ソースの作成

3. 次のパラメータを入力します。
ソース名: unique_name。たとえば、ディスカッション・フォーラムをクロールする場合、GS_Forums (お知らせをクロールする場合は、GS_Announcements)。

データベース接続文字列: 次のいずれかを入力します。

- Oracleデータベース: 次のいずれかを入力します。

jdbc:oracle:thin:@host:port:sid

jdbc:oracle:thin@host:port/serviceId

- IBM DB2データベース: jdbc:db2://host:port/database_nameと入力します。

- Microsoft SQL Serverデータベース: jdbc:sqlserver://host_or_IP_address:port;database_nameと入力します。

ユーザーID: 次のいずれかを入力します。

- Oracleデータベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DISCUSSIONS_CRAWLER

- Microsoft SQL Serverデータベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DISCUSSIONS_CRAWLER

- IBM DB2データベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DC(MyPrefixは5文字)

パスワード: このユーザーのパスワード。

問合せ: 次のいずれかの問合せを入力します。

SELECT * FROM FORUMCRAWLER_VW
SELECT * FROM THREADCRAWLER_VW
SELECT * FROM MESSAGECRAWLER_VW
SELECT * FROM ANNOUNCECRAWLER_VW

ソース・クロール・ディスカッション・フォーラムには、FORUMCRAWLER_VWを使用します。

ディスカッション・フォーラムのソース・クロール・トピックには、THREADCRAWLER_VWを使用します。

ディスカッション・フォーラムのソース・クロール応答には、MESSAGECRAWLER_VWを使用します。

ソース・クロールお知らせには、ANNOUNCECRAWLER_VWを使用します。

URL接頭辞: ホスト、ポートおよびアプリケーション名を含むWebCenter PortalアプリケーションのURL接頭辞。たとえば、http://host:port/webcenterのようになります。

セキュリティ属性の付与: WCSECATTR

注意:
以前のリリースのContent Serverでは、「セキュリティ属性の付与」にFORUMIDが使用されていました。

4. 「次へ」をクリックします。

5. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページの「認可マネージャ」セクションで次のパラメータを入力します(事前に移入されていない場合)。
プラグイン・クラス名: oracle.search.plugin.security.auth.db.DBAuthManager

Jarファイル名: oracleapplications/DBCrawler.jar

認可データベース接続文字列: 次のいずれかを入力します。

- Oracleデータベース: 次のいずれかを入力します。

jdbc:oracle:thin:@host:port:sid

jdbc:oracle:thin@host:port/serviceId

- IBM DB2データベース: jdbc:db2://host:port/database_nameと入力します。

- Microsoft SQL Serverデータベース: jdbc:sqlserver://host_or_IP_address:port;database_nameと入力します。

ユーザーID: 次のいずれかを入力します。

- Oracleデータベース: ユーザーMyPrefix_DISCUSSIONS_CRAWLERを入力します。

- Microsoft SQL Serverデータベース: ユーザーMyPrefix_DISCUSSIONS_CRAWLERを入力します。

- IBM DB2データベース: ユーザーMyPrefix_DC (MyPrefixは5文字)を入力します。

パスワード: このユーザーのパスワード

単一レコード問合せ: false

認可問合せ: (1行で)次を入力します。

SELECT DISTINCT forumID as WCSECATTR
FROM AUTHCRAWLER_FORUM_VW
WHERE username = LOWER(?) UNION SELECT DISTINCT -1 as WCSECATTR
FROM AUTHCRAWLER_FORUM_VW

注意:
以前のリリースのContent Serverでは、次の認可問合せが使用されていました。

SELECT forumID
FROM AUTHCRAWLER_FORUM_VW
WHERE (username = ? or userID=-1)
UNION SELECT f.forumID
FROM jiveForum f, AUTHCRAWLER_CATEGORY_VW c
WHERE f.categoryID = c.categoryID AND (c.username =  ? or userID=-1)

認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を見つけるには、Oracle SESで、「グローバル設定 - アイデンティティ管理設定」ページに移動します。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(たとえば、nickname、usernameなど)。

Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

6. 「作成」をクリックしてソースの作成を完了します。

18.5.4.4 ポータル、リスト、人およびページ・メタデータを検索するためのOracle SESの設定

この項では、Oracle WebCenterソースを作成する方法について説明します。

関連項目:
Oracle WebCenterソースを作成する別の方法は、第18.5.6項「WLSTを使用した検索クローラの構成」を参照してください。

1. 「ホーム」→「ソース」ページに移動します。

2. 「ソース・タイプ」ドロップダウン・リストで、「Oracle WebCenter」を選択し、「作成」(図18-25)をクリックします。

図18-25 Oracle WebCenterソースの作成

3. 次のソース・パラメータを入力します。

注意:
WebCenter Portalの前にOracle HTTP Serverが配置されている場合は、この手順で使用される構成URLでmod_wl_ohs.confファイルに次が必要となります。
非クラスタ化環境の場合:

<Location /rsscrawl>
SetHandler weblogic-handler
WebLogicHost host_name
WeblogicPort port
</Location>

<Location /sesUserAuth>
SetHandler weblogic-handler
WebLogicHost host_name
WeblogicPort port
</Location>

クラスタ化環境の場合:

<Location /rsscrawl>
WebLogicCluster host_name1:port,host_name2:port
SetHandler weblogic-handler
</Location>

<Location /sesUserAuth>
WebLogicCluster host_name1:port,host_name2:port
SetHandler weblogic-handler
</Location>

ここで、host_name1およびhost_name2はクラスタ・ノードで、portはWebCenter Portalアプリケーションがデプロイされている管理対象サーバーのリスニング・ポート番号です。

関連項目:
WebCenter PortalをOracle Access Managerとともに使用する方法の詳細は、第33.2.3.1項「OAM 11gのインストールと構成」を参照してください。

ソース名: unique_name

構成URL: host:port_of_WebCenterPortal/rsscrawl。例: http://myhost:8888/rsscrawl

認証タイプ: BASIC

ユーザーID: 第18.3.2項「Oracle SES: 構成」で登録したクロール管理ユーザー。例: mycrawladmin

パスワード: クロール管理ユーザーのパスワード

レルム: jazn.com

Oracle SSOログインURL: このフィールドは空白のままにします。

Oracle SSOアクションURL: このフィールドは空白のままにします。

スクラッチ・ディレクトリ: オプション。Oracle SESインスタンスが配置されるシステム上のディレクトリを指定します。

接続の試行数: データ・フィードにアクセスするためまたはステータス・フィードをアップロードするための接続試行の最大数。

「次へ」をクリックします(図18-26)。

図18-26 Oracle WebCenterソースのパラメータ

4. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページでは、「プラグイン・クラス名」および「認可エンドポイント」が事前に移入されています。「プラグイン・クラス名」は、oracle.webcenter.search.auth.plugin.WebCenterAuthManagerである必要があります。
次のプラグイン・パラメータを入力します。

Jarファイル名: webcenter/WebCenterCrawler.jar

レルム: jazn.com

ユーザーID: 第18.3.2項「Oracle SES: 構成」で登録したクロール管理ユーザー。例: mycrawladmin

パスワード: クロール管理ユーザーのパスワード

認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を見つけるには、Oracle SESで、「グローバル設定 - アイデンティティ管理設定」ページに移動します。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(たとえば、nickname、usernameなど)。Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

5. 「作成」をクリックしてソースの作成を完了します。

18.5.4.5 スペース・クローラからのコンポーネントの除外

スペース・クローラは次のコンポーネントを検索するためにデータを収集します。

- oracle.webcenter.peopleconnections.profile (ユーザー)

- oracle.webcenter.community (ポータル)

- oracle.webcenter.page (ページ・メタデータ)

- oracle.webcenter.list (リスト)

これらのコンポーネントのいずれかの検索を無効にするには、URLパラメータ?excludedServiceIdsを使用します。つまり、Oracle SES管理ツールのOracle WebCenterソースの「ホーム」→「ソース」ページで、パラメータConfiguration URLの?excludedServiceIdsを、除外するサービスIDのカンマ区切りリストと同一に設定します。

例18-5 ピープル・コネクション・プロファイルのクロールの無効化

http://host:port/rsscrawl?excludedServiceIds=oracle.webcenter.peopleconnections.profile

例18-6 ページ・メタデータのクロールの無効化

http://host:port/rsscrawl?excludedServiceIds=oracle.webcenter.page

例18-7 プロファイルおよびページ・メタデータのクロールの無効化

http://host:port/rsscrawl?excludedServiceIds=oracle.webcenter.peopleconnections.profile,oracle.webcenter.page

18.5.4.6 追加のOracle SES構成

この項では、Oracle SES管理ツールで必要な手順について説明します。

1. Content Server、ディスカッション、お知らせおよび作成したWebCenter Portalのソースの名前を含む、ソース・グループを作成します。

1. 「検索」→「ソース・グループ」に進み、「作成」をクリックします。

2. 第18.5.1項「Oracle SESのためのWebCenter Portalの設定」で入力したソース・グループ名と同じ名前を入力します。

3. 「ソース・タイプの選択」ドロップダウン・リストから、各ソース・タイプ(Database、Content Server、Oracle WebCenter)を選択し、各ソース・タイプに対してリストされた「使用可能なソース」から、そのソース・タイプに対して作成したソースを「割り当てられたソース」リストに移動します。

4. 「完了」をクリックします。

2. 必要に応じて、セキュリティ・フィルタの有効期間を構成します。これにより、システム内のユーザーの認可ポリシーがリフレッシュされます。ユーザー・ポリシーが頻繁に変更される場合は、有効期間を短くするのが最適です。(この章では、例としてOracle Internet Directoryアイデンティティ・プラグインを使用しています。)
たとえば、「グローバル設定」→「問合せ構成」ページの「セキュア検索の構成」の下で、「セキュリティ・フィルタ有効期間(分)」に0を入力します。

セキュリティ・フィルタ有効期間の有効な値は、0分(キャッシュなし)から526500分(1年間のキャッシュ)です。

3. すべてを索引付けするには、各ソースに対してフル・クロールを強制する必要があります。つまり、各ソースの既存の増分クロール・スケジュールを、まずすべてのドキュメントを処理するように変更する必要があります。
この手順は非常に重要で、これで、コンテンツが最初に完全に索引付けされるまで、検索が機能しなくなります。

注意:
WLSTでfullCrawlIntervalInHoursパラメータを使用して、またはFusion Middleware ControlでFull Crawl Intervalパラメータを使用してスペース・クローラのスケジュールを設定できます。

「ホーム」→「スケジュール」ページに進み、ソース・スケジュールを選択して「編集」をクリックし、フル・クロールを強制します。

各ソースのクロールが完了したら、同じページに戻り、クロール・ポリシーを増分(前回のクロール以降に変更されたドキュメントを索引付けする)に戻します。また、このページの「頻度」セクションで、増分クロールの実行に手動以外のタイプ(毎週、毎日など)を選択します。

注意:
Content Serverの最初のクロールの前に、Content Serverの「管理」ページに進み、「SESクローラ・エクスポート」を選択してスナップショットを撮ることを忘れないでください。詳細は、第18.5.2項「Oracle SESのためのOracle WebCenter Content Serverの設定」を参照してください。

18.5.4.7 Oracle SESファセットおよびソート属性の構成

ファセットは、新しい検索を実行せずにインデックス化されたデータを移動することによってユーザーが検索を詳細設定できるOracle SESオブジェクトです。まず、Oracle SESで(提供されるファイルを使用して)ファセットを定義する必要があります。Oracle SESで定義されたファセットは、「ツールとサービス」→「検索」管理ページを使用してWebCenter Portalで適用されます。

注意:
Oracle SES 11.2.2.2は、WebCenter Portalによるファセット検索をサポートしていますが、以前のリリースのOracle SESの検索はこれをサポートしていません。

WebCenter Portalには、Oracle SES Admin APIコマンド行インタフェース用の次の入力ファイルが用意されています。

- facet.xml: Oracle SESでファセットを構成します。

- searchAttrSortable.xml: 絶対ソートの属性を定義します。

これらのファイルをoracle.webcenter.framework/ses/webcenter_portal_ses_admin.zipで見つけます。このファイルを解凍し、readme.txtファイルの指示に従います。

これら2つのファイルをOracle SESから実行すると、次のファセットが作成されます。

- Author

- Last Modified Date

- Mimetype

- Tags

- Scope GUID (これは「ポータル」ファセットとして表示されます。この値は、検索結果ページでポータル表示名に変換されます。)

- Service ID (このファセットはユーザー・インタフェースには表示されません。有効なすべてのツールおよびサービスは検索結果ページに表示されます。)

注意:
facet.xmlスクリプトおよびsearchAttrSortable.xmlスクリプトは必須です。WebCenter Portalで検索するには、Oracle SESでのファセット作成のみでは不十分です。
また、Scope GUIDおよびService IDファセットは必須です。ファセット名では、大/小文字が区別されます。これらのファセット名を正確に指定する必要があります。

これらのファイルを実行した後、Oracle SES管理ツールの「グローバル設定」→「ファセット」ページにファセットを表示できます(図18-27)。

図18-27 Oracle SESファセット

新しいファセットを作成するには、「グローバル設定」→「ファセット」ページで「作成」をクリックします。ファセット値の生成元であるファセットの名前および検索属性を入力します。「文字列」ファセット・タイプには、パス・デリミタも入力する必要があります。これは、選択したファセット・ツリー・ノードのファセット・ツリー階層を問合せページに表示するための境界用に使用する1文字で、たとえば、"tools/power tool/drills"の"/"がパス・デリミタです。ファセット・ツリーが1レベルの深さの場合(つまりこのノードに子ノードがない場合)、これを空白に設定できます。

「作成してカスタマイズ」をクリックしてファセットを作成し、「ファセットの編集」ページでこのノードを構成します。日付タイプまたは数値タイプのファセットのファセット・ノードを構成できます。たとえば、「最終変更日」ファセットの場合、「昨年」、「先月」、「今日」、特定の2つの日付の間などのノードを作成できます。

「ノード構成」タブには、ファセット階層がツリー形式およびXML形式で表示され、ここで選択したファセット・ノードの子ノードを追加、編集および削除できます。ファセット・ノードを編集した後、「適用」をクリックして変更内容を保存します。

注意:
Scope GUIDファセットまたはService IDファセットは変更または削除しないでください。

Oracle SESで行われた変更は、アプリケーション・スペシャリストが「ツールとサービス」→「検索」管理ページに移動するとWebCenter Portalで適用されます。WebCenter Portalでは、この「検索」管理ページが開くまでファセットの変更が検出されません。WebCenter Portalでは、使用するために選択したファセットがポータルごとに記憶されます。

18.5.5 WLSTを使用したOracle SESのバージョンの構成

WLSTコマンドのsetSESVersionを実行して、デフォルトの接続に関連付けられたOracle SESインスタンスのバージョン情報を取得して、格納する必要があります。このコマンドにより、ファセット検索と、「ツールとサービス」→「検索」管理ページが有効になります。このページは、Oracle SES 11.2.2.2を使用した検索の設定をカスタマイズするために必要になります。Oracle SESのバージョンが正しく設定されていることを確認するには、WLSTコマンドのlistSESVersionを実行します。

例18-8に、これらのコマンドを示します。完全なコマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetSESVersionに関する項およびlistSESVersionに関する項を参照してください。

例18-8 ファセット問合せと「ツールとサービス」の「検索」管理ページの有効化

setSESVersion(appName='webcenter',
sesUrl='http://myhost.com:5720/search/api/admin/AdminService',
sesSchema='searchsys', sesPassword='password'
listSESVersion(appName='webcenter',
sesUrl='http://myhost.com:5720/search/api/admin/AdminService')

18.5.6 WLSTを使用した検索クローラの構成

WLSTコマンドを使用して、クローラを作成したり、クローラのスケジュールを開始、停止および削除できます。これらのコマンドでは、Oracle SES内の新しいデータをクロールしたり、構成データが変更されると古いクローラを削除できます。

次の例に、これらのコマンドの一部を示します。詳細は、『WebLogic Scripting Toolコマンド・リファレンス』の検索 - Oracle SES検索に関する項を参照してください。

例18-9 WLSTでのスペース・クローラの作成

createSpacesCrawler(
appName='webcenter', host='myWebcenterHost', port='myWebcenterPort',
sesUrl='http://mySEShost.com:7777/search/api/admin/AdminService',
sesPassword='mySESAdminPassword', crawlUser='webcenter-crawl-user',
crawlPassword='webcenter-crawl-user-pw', scratchDir='/tmp',
authUserIdFormat='authentication-id-format', crawlingMode='ACCEPT_ALL',
recrawlPolicy='PROCESS_ALL', freqType='MANUAL', startHour=1,
hoursBetweenLaunches=1, startDayOfWeek='MONDAY', startDayOfMonth=1,
daysBetweenLaunches=1, weeksBetweenLaunches=1, monthsBetweenLaunches=1,
sesSchema='eqsys')

例18-10 WLSTでのドキュメント・クローラの作成

createDocumentsCrawler(
appName='webcenter', host='myWebcenterHost', port='myWebcenterPort',
sesUrl='http://mySEShost.com:7777/search/api/admin/AdminService',
sesPassword='mySESAdminPassword',
configUrl='http://myContentServerHost:myContentServerPort/cs/idcplg?IdcService=SES_CRAWLER_DOWNLOAD_CONFIG&source=default',
user='ContentServer_crawl_user', password='ContentServerCrawlPassword',
scratchDir='/tmp', httpEndpoint='http://myContentServerHost:myContentServerPort/cs/idcplg',
displayUrl='http://myContentServerHost:myContentServerPort/cs', realm='Idc Security /cs/idcplg',
authUserIdFormat='authentication-id-format', pipelineName='Document-pipeline',
crawlingMode='ACCEPT_ALL', recrawlPolicy='PROCESS_CHANGED', freqType='MANUAL',
startHour=1, hoursBetweenLaunches=1, startDayOfWeek='MONDAY', startDayOfMonth=1,
daysBetweenLaunches=1, weeksBetweenLaunches=1, monthsBetweenLaunches=1,
sesSchema='eqsys')

例18-11 WLSTでのディスカッション・クローラの作成

createDiscussionsCrawler(
appName='webcenter', host='myWebcenterHost', port='myWebcenterPort',
sesUrl='http://mySEShost.com:7777/search/api/admin/AdminService',
sesPassword='mySESAdminPassword',
dbConnString='jdbc:oracle:thin:@database-host:database-port:database-sid',
user='Jive-crawler-schema', password='Jive-crawler-schema-pw',
authUserIdFormat='authentication-id-format', crawlingMode='ACCEPT_ALL',
recrawlPolicy='PROCESS_ALL', freqType='MANUAL', startHour=1,
hoursBetweenLaunches=1, startDayOfWeek='MONDAY', startDayOfMonth=1,
daysBetweenLaunches=1, weeksBetweenLaunches=1, monthsBetweenLaunches=1,
sesSchema='eqsys')

注意:

- authentication-id-formatでは、Oracle SES上のアイデンティティ管理プラグインがOracle Internet Directoryに設定されている場合はニックネームを使用します。それ以外の場合は、Oracle SES上のアイデンティティ管理プラグインの「認証属性」パラメータの値を使用します。

- database-hostでは、Oracle WebCenter Portalのディスカッション・サーバー・データベースのホスト名を使用します。

- Jive-crawler-schemaでは、ディスカッション・サーバー・クローラのスキーマ名を使用します。RCUから接頭辞を決定し、rcu-prefix_DISCUSSION_CRAWLERを使用します。

- sesSchemaでは、デフォルト値はsearchsys(Oracle SES 11.2.2.2のデフォルトの管理ユーザー名)ですが、インストール中に別の名前も指定できます。Oracle SES 11.1.*を使用している場合は、このパラメータをeqsysに設定してください。

- WLSTの変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

18.5.7 ページ・メタデータのクロールのヒント

Portal Frameworkアプリケーションでページ・メタデータをクロールするには、次のガイドラインに従ってください。

- ページ・テンプレートで、コマンド・リンク(af:commandLink)のかわりに実行リンク(af:goLink)を使用してページをリンクとしてレンダリングします。

- クロール中はJDeveloperで反復開発を無効にします。反復開発を使用すると、アプリケーションの実行中に変更を加えて、ブラウザでページを更新することによりそれらの変更の結果をすぐに表示することが可能になります。反復開発機能は、特定の最適化機能を無効にすることにより動作します。
反復開発はデフォルトで有効にされています。この機能を無効にするには:

1. JDeveloperで、「アプリケーション」メニューから、「アプリケーション・プロパティ」を選択します。

2. 「アプリケーション・プロパティ」ダイアログの左側で、「実行」ノードを開きます。

3. 「WebCenter Portal」を選択します。

4. 「反復開発の有効化」の選択を解除します。

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

18.6 Portal Frameworkアプリケーションを検索するためのOracle SESの構成

WebCenter Portal Frameworkアプリケーションで、Oracle SESはデフォルトおよび優先される検索プラットフォームとして設定されています。Portal Frameworkアプリケーションを検索するようOracle SESを構成するには、同様の手順が必要になりますが、Portal Frameworkアプリケーションではスペース・クローラがサポートされません。

この項では、Portal Frameworkアプリケーションを検索するようOracle SESを設定する手順について説明します。

- 第18.6.1項「Oracle SESのためのOracle WebCenter Content Serverの設定」

- 第18.6.2項「Oracle SESのためのOracle WebCenter Portalのディスカッション・サーバーの設定」

- 第18.6.3項「WebCenter Portal Frameworkを検索するためのOracle SESの設定」

- 第18.6.4項「Oracle SESのためのWebCenter Portal Frameworkアプリケーションの設定」

関連項目:
第18.1項「Oracle SESを使用した検索について」

注意:
Oracle SESをPortal Frameworkアプリケーションの検索エンジンとして有効化するために実行する必要のあるタスクの概要は、第18.2項「WebCenter PortalでのOracle SESの構成ロードマップ」を参照してください。 必要なタスクを実行するためにふさわしい方法や順序が多数ある場合もあります。

18.6.1 Oracle SESのためのOracle WebCenter Content Serverの設定

この項では、Oracle SESによりクロール可能となるようにOracle WebCenter Content Server(特に、Portal Frameworkアプリケーションがドキュメントの格納に使用するContent Server)を構成する方法について説明します。

次の手順はContent Server内で実行する必要があります。

関連項目:
Content Serverのロールおよびユーザーの管理方法を示すContent Serverオンライン・ヘルプ

1. クロール・ユーザーを作成します。
adminロールを持つユーザーでクロールする場合、クロール・ユーザーとして管理ユーザー・アカウントを使用します。

非管理ユーザーでクロールする場合、次の手順に従います。

1. sescrawlerroleロールを作成します。

2. ユーザーsescrawlerを作成し、これにsescrawlerroleロールを割り当てます。このユーザーがOracle SES内にContent Serverを作成します。

3. sceCrawlerRole=sescrawlerroleをconfig.cfg (MW_HOME/user_projects/domains/yourdomain/ucm/cs/config内)に追加します。
または、sceCrawlerRole=sescrawlerrole行をWebCenter Content Serverのユーザー・インタフェース(「管理」→「一般構成」→「追加の構成変数」)に追加できます。

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

3. Content Serverコンソールで、SESCrawlerExportコンポーネントをコンテンツ・サーバーにインストールします(まだインストールされていない場合)。

1. システム管理者としてContent Serverにログオンします。例: http://host:port/cs。

2. 「管理」ドロップダウン・メニューから、「管理サーバー」(図18-28)を選択します。

図18-28 Content Serverの管理

3. インスタンス名のボタンをクリックします。

4. 左側のペインのメニュー・リストから「コンポーネント・マネージャ」をクリックします(図18-29)。

図18-29 WebCenter Content Serverの「コンポーネント・マネージャ」

5. 「統合」の下の「SESCrawlerExport」を選択し、「更新」をクリックします。

6. 構成パラメータを入力します。(構成パラメータは、インストール後に変更することもできます。)
SESCrawlerExportにより提供される認証および認可APIのセキュリティを無効にします。つまり、「Secure APIの無効化」をfalseに設定します。これにより、SESCrawlerExportによって提供されるセキュリティが、Content Serverによってではなく内部的に実行されるようになります。

さらに、クラスタ化環境の場合のみ、feedLocパラメータで、Content Serverのノードによりアクセスされる共有ディスク上の場所を指定する必要があります。また、これらの各ノードは同じようにこの場所を参照する必要があります(例: sharedDrive/dir1/dir2)。これは指定されたデフォルトの場所(相対パス)ではないことに注意してください。

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

4. Content Serverリポジトリのスナップショットを撮ります。

1. システム管理者としてContent Serverにログオンします。例: http://host:port/cs。

2. 「管理」ドロップダウン・メニューから、「SESCrawlerExport」を選択します。

3. 「すべてのソース」を選択し、「スナップショットの取得」(図18-30)をクリックします。

図18-30 Content Serverのスナップショット

ソースの最初のクロールまたはその後のフル・クロールの前にスナップショットを撮ることは重要です。

スナップショットにより、コンポーネントのインストール時に指定された場所にconfigFile.xmlが生成され、feedLocの下のソース名のサブディレクトリにフィードが作成されます。

5. Content ServerがWebレンディション用に構成されている場合、Content Server内のアイテムはPDF形式でレンダリングされます。コンテンツ・アイテムのネイティブMIMEタイプのレンディションは上書きされます。たとえば、Microsoft Office WordドキュメントのMIMEタイプはapplication/mswordですが、Content ServerでWebレンディションを使用すると、MIMEタイプはapplication/pdfになります。Mimetypeパラメータをapplication/mswordに設定して検索問合せを実行しても、Wordドキュメントは返されません。
Content ServerがWebレンディションを使用するように構成されている場合、Content Serverメタデータ・リストにdFormat値が含まれるように構成し、必要なMIMEタイプがOracle SESにエクスポートされるようにする必要があります。これは、MIMEタイプで検索を絞り込めるようにするために必要です。

1. 「SESCrawlerExport管理」ページに戻り、「SESCrawlerExportの構成」(図18-31)をクリックします。

図18-31 Content Serverのスナップショット

2. デフォルトでは、「メタデータ・リスト」フィールドは空白です(図18-32)。オプションで、必要な任意のカスタム・メタデータ値(xで始まる)をこのフィールドに追加します。たとえば、「メタデータ・リスト」の次のエントリには、カスタム属性が含まれています。

xCollectionID,xWCTags,xRegionDefinition

図18-32 Content Serverの「メタデータ・リスト」

3. 11.1.1.8より前のバージョンのContent Serverを使用している場合、dFormat値をこの「メタデータ・リスト」フィールドに追加する必要があります。空白の場合のデフォルト値を変更すると、そのデフォルト値は削除されるため、これらを再度追加する必要があります。(Content Server 11.1.1.8には、検索に必要なほとんどの値(dFormatを含む)が含まれています。)
したがって、11.1.1.8より前のバージョンのContent Serverを使用している場合、次のように「メタデータ・リスト」(および「x」で始まるカスタム・メタデータ・フィールド)にデフォルト値を手動で入力する必要があります。

dFormat,dID,dDocName,dRevLabel,dDocType,dDocAccount,dSecurityGroup,
dOriginalName,dReleaseDate,dOutDate,dDocCreator,dDocLastModifier,dDocCreate
dDate,dDocFunction

6. ファセット検索用の「サムネイル・オプション」を構成します。

注意:
Oracle SES 11.2.2.2はドキュメント・サムネイルをサポートしますが、以前のリリースのOracle SESはこれをサポートしません。

「管理」タブで、「サムネイル・オプションの構成」を選択し、検索結果でのドキュメント・サムネイルを有効にします。デフォルト設定のままにし、「更新」をクリックします(図18-33)。

図18-33 サムネイル・オプションの構成

関連項目:
Content Serverの構成の詳細は、製品に同梱のDeployment Guide.pdfを参照してください。

18.6.2 Oracle SESのためのOracle WebCenter Portalのディスカッション・サーバーの設定

この項では、Oracle SESによりクロール可能となるようにOracle WebCenter Portalのディスカッション・サーバー(特に、Portal Frameworkアプリケーションがディスカッションおよびお知らせの格納に使用するディスカッション・サーバー)を構成する方法について説明します。

注意:
WebCenter Portal (Oracleデータベースを含む)およびOracle WebCenter Portalのディスカッション・サーバーの新しいインストールがある場合は、この手順は必要ありません。これらはアップグレードされた(パッチが適用された)インスタンスを使用している場合にのみ必要となります。
該当するデータ・ソースのデータベース・スキーマの詳細は、Oracle WebLogic Serverコンソールから検索できます。

1. リポジトリ作成ユーティリティ(RCU)を実行して、ディスカッション・クローラのWebCenter Portalコンポーネントがシステムにインストールされていることを確認します。

- Oracleデータベース:
MyPrefix_DISCUSSIONSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

MyPrefix_DISCUSSIONS_CRAWLERユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に構成されていることを検証します。

- Microsoft SQL Serverデータベース:
MyPrefix_DISCUSSIONSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

MyPrefix_DISCUSSIONS_CRAWLERユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に構成されていることを検証します。

- IBM DB2データベース:
MyPrefix_DSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

MyPrefix_DCユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に構成されていることを検証します。

注意:
IBM DB2データベースの場合、MyPrefixは5文字に制限されます。IBM DB2では、認証にオペレーティング・システム・ユーザーが使用されます(つまり、データベース・ユーザーは実質的にはオペレーティング・システム・ユーザーです)。オペレーティング・システムによっては、ユーザー名に8文字の制限があるため、これは8文字のユーザー名にする必要があります。

ディスカッション・クローラ・コンポーネントがインストールされていない場合、RCUを使用してこれをインストールする必要がありますが、このとき、接頭辞は、Oracle WebCenter Portalのディスカッション・サーバー・コンポーネントと同じものを選択します。また、RCUでの表領域の指定手順で、デフォルトの表領域としてPrefix_IAS_DISCUSSIONSを選択します。これにより、Oracle SESのユーザーがインストールされます。

詳細は、第42章「Portal Frameworkアプリケーションのデプロイ」を参照してください。

2. たとえば、WebCenter 11.1.1.1.0からのアップグレードの場合、次のツールを実行して(まだ実行していない場合)、Oracle WebCenter Portalのディスカッション・サーバー・データベース・スキーマ内のデータをアップグレードします。

注意:
この手順は、インスタンスをWebCenter Portal 11.1.1.1.0からアップグレードした場合にのみ必要になります。WebCenter Portal 11.1.1.1.0より後にインストールされたインスタンスでは、必要ありません。

java -jar \
$MW_HOME/discussionserver/discussionserver-upgradeforses.jar \
<command_line_parameters>

ここでcommand_line_parametersは、次のMDSスキーマの詳細とディスカッション・データベース・スキーマの詳細です。

-mds_jdbc_user user_id \
-mds_jdbc_password password \
-mds_jdbc_url url \
-discussions_jdbc_user user_id \
-discussions_jdbc_password password \
-discussions_jdbc_url url

ここでmds_jdbc_user、mds_jdbc_passwordおよびmds_jdbc_urlは、MDSスキーマにログインするための値で、discussions_jdbc_user、discussions_jdbc_passwordおよびdiscussions_jdbc_urlは、ディスカッション・データベース・スキーマにログインするための値です。

例:

java -jar $MW_HOME/as11r1wc/discussionserver/discussionserver-upgradeforses.jar\
-mds_jdbc_user foo \
-mds_jdbc_password myPassword1 \
-mds_jdbc_url jdbc:oracle:thin:@host:port:SID \
-discussions_jdbc_user foo \
-discussions_jdbc_password myPassword1 \
-discussions_jdbc_url jdbc:oracle:thin:@host:port:SID

18.6.3 WebCenter Portal Frameworkを検索するためのOracle SESの設定

この項の手順は、Oracle SES管理ツールで実行する必要があります。

次の手順が必要です。

1. 第18.6.3.1項「Oracle SES管理ツールへのログオン」

2. 第18.6.3.2項「ドキュメントを検索するためのOracle SESの設定」

3. 第18.6.3.3項「ディスカッションおよびお知らせを検索するためのOracle SESの設定」

4. 第18.6.3.4項「Oracle SESファセットおよびソート属性の構成」

5. 第18.6.3.5項「追加のOracle SES構成」

関連項目:
Oracle SESに必要なすべてのパッチがインストールされていることを確認します。必要なパッチの最新情報は、『Oracle WebCenter Portalインストレーション・ガイド』の検索のバックエンド要件に関する項およびリリース・ノートを参照してください。
Oracle SES構成の詳細は、製品に付属のOracle SESドキュメントを参照してください。(これらは、Oracle Fusion Middlewareドキュメント・ライブラリのWebCenter Portal製品の領域にリストされています。)

18.6.3.1 Oracle SES管理ツールへのログオン

Oracle SES管理ツールを開きます。

1. ブラウザを開き、Oracle SESインストール後に指定されたURLを入力します。(これは、http://host:port/search/admin/index.jspの形式となります。)

2. Oracle SES管理ユーザー名eqsysとインストール時に指定されたパスワードでログオンします。

- Oracle SES 11.2.2.2では、デフォルトの管理ユーザー名はsearchsysですが、インストール中に別の名前を指定できます。

- Oracle SES 11.1.*では、管理ユーザー名はeqsysです。

18.6.3.2 ドキュメントを検索するためのOracle SESの設定

Oracle SESを使用してドキュメントを検索するには、まずドキュメント・サービス・マネージャを(ドキュメント・サービス・インスタンスおよびドキュメント・サービス・パイプラインとともに)設定してから、Content Serverソースを作成する必要があります。

1. ドキュメント・サービス・マネージャを構成します(Oracle SESインスタンスごとに1回)。

注意:
ドキュメント・サービスは、ドキュメントがクロールされる際のドキュメントの処理に関与するプラグインです。ドキュメント・サービスにより、アプリケーションで使用されるドキュメントに索引付け可能な属性をPortal Frameworkアプリケーションで追加できるようになります。

1. 「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。「新規マネージャの作成」を選択し、「次へ」をクリックして次のパラメータを入力します。
マネージャ・クラス名: oracle.webcenter.search.crawl.ucm.ses.WcUcmDsManager

マネージャJARファイル名: search-crawl-ucm.jar

注意:
webcenter_doc_pipeline_plugin.zipファイルによりOracle_Home/search/lib/plugins/doc/search-crawl-ucm.jarがインストールされます。

「次へ」をクリックして、「終了」をクリックします(図18-34)。

図18-34 Oracle SESでのドキュメント・サービス・マネージャの作成

2. ドキュメント・サービス・インスタンスを作成します。
再度、「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。今回は、「利用可能なマネージャから選択」で「Secure Enterprise Search WebCenter UCMプラグイン」を選択し、「次へ」をクリックします(図18-35)。

図18-35 ドキュメント・サービスの作成

次のパラメータを入力します。

インスタンス名: ドキュメント・パイプラインを作成するときに使用する名前をここに入力します。

WebCenterアプリケーション名: これは空白のままにする必要があります。

接続名: Portal FrameworkアプリケーションのContent Server接続名です。

WebCenter URL接頭辞: アプリケーションがデプロイされるホストとポート、およびコンテキスト・ルート。例: http://myhost:8888/myPortalApp。ここで、myPortalAppはアプリケーションのコンテキスト・ルートです。

注意:
Fusion Middleware ControlまたはlistDocumentsSpacesPropertiesコマンドを使用して、第18.5.1項「Oracle SESのためのWebCenter Portalの設定」の説明に従って、アプリケーション名と接続名を特定してください。

3. ドキュメント・サービス・パイプラインを作成します。これによりドキュメント・サービス・インスタンスが呼び出されます。
再度、「グローバル設定」→「ドキュメント・サービス」ページで、「ドキュメント・サービス・パイプライン」セクションの下の「作成」をクリックします(図18-36)。

図18-36 ドキュメント・サービス・パイプラインの作成

4. 「ドキュメント・サービス・パイプラインの作成」ページで、このパイプラインのカスタム名を入力します。前の手順で作成したドキュメント・サービス・インスタンスが「使用可能なサービス」の下にリストされるはずです。このドキュメント・サービス・インスタンスを選択し、矢印ボタンを使用してこれを「パイプラインで使用済」の下に移動します。

2. ドキュメントのContent Serverソースを作成します。

1. 「ホーム」→「ソース」に移動します。

2. 「ソース・タイプ」ドロップダウン・リストで、「Content Server」を選択し、「作成」(図18-37)をクリックします。

図18-37 Content Serverソースの作成

3. 次のパラメータを入力します。
ソース名: unique_name

構成URL: Content_Server_SES_Crawler_Export_endpoint (例: http://host:port/cs/idcplg?IdcService=SES_CRAWLER_DOWNLOAD_CONFIG&source=default)

注意:
source=defaultパラメータは、SESクローラ・エクスポートの構成で作成されたソースの名前を示します。デフォルトのソースが作成され、自動的にdefaultと名付けられます。

認証タイプ:

Content ServerがSSOで保護されない場合、NATIVEと入力します。

Content ServerがOracle SSOで保護される場合、ORASSOと入力します。

ユーザーID: Content Serverをクロールするユーザーには、sceCrawlerRoleロールが定義される必要があります。sceCrawlerRoleは、SESCrawlerExport内の構成パラメータです。一般には、管理者が特別のロールを作成し、これにはコンテンツを表示する権限を割り当てず、このロールを持つユーザー・アカウントを作成します。

特定のsceCrawlerRoleを設定しない場合、クロールには管理資格証明が必要です。sysadminユーザーIDはデフォルトで機能します。

認証タイプがORASSOの場合、Oracle SSOが前面に来るアイデンティティ管理サーバー内のユーザーのID (およびパスワード)を入力します。このユーザーには、sysadminと同じ権限が付与される必要があります。これらの権限を付与できない場合は、このユーザーに対応するContent Server内のリモート・ユーザーを削除し、Content Server内で(同じ名前の)ローカル・バージョンのユーザーを作成します。

パスワード: このContent Serverユーザーのパスワード。

レルム:

認証タイプがNATIVEの場合、Idc Security /cs/idcplgと入力しますが、ここで/cs/は、Content Serverのインストール時に指定したコンテキスト・ルートです。

認証タイプがORASSOの場合、このパラメータは空白のままにします。

スクラッチ・ディレクトリ: オプション。Oracle SESインスタンスが配置されるシステム上のディレクトリを指定します。

Oracle SSOログインURL:

認証タイプがORASSOの場合、Oracle SSOの値を指定します。例: https://login.oracle.com/mysso/signon.jsp?site2pstoretoken=

認証タイプがNATIVEの場合、このフィールドは空白のままにします。

Oracle SSOアクションURL:

認証タイプがORASSOの場合、Oracle SSOの値を指定します。例: https://login.oracle.com/sso/auth

認証タイプがNATIVEの場合、このフィールドは空白のままにします。

「次へ」をクリックします(図18-38)。

図18-38 Content Serverソースのパラメータ

4. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページの「認可マネージャ」セクションで次のパラメータを入力します(デフォルトで入力されていない場合)。
プラグイン・クラス名: oracle.search.plugin.security.auth.stellent.StellentAuthManager

Jarファイル名: oracleapplications/StellentCrawler.jar

認可用HTTPエンドポイント: 例: http://host:port/cs/idcplg

表示URL接頭辞: 例: http://host:port/cs

認証タイプ: NATIVEまたはORASSO

管理者ユーザー: Content Serverをクロールするユーザーには、sceCrawlerRoleロールが定義される必要があります。sceCrawlerRoleは、SESCrawlerExport内の構成パラメータです。一般には、管理者が特別のロールを作成し、これにはコンテンツを表示する権限を割り当てず、このロールを持つユーザー・アカウントを作成します。特定のsceCrawlerRoleを設定しない場合、クロールには管理資格証明が必要です。sysadminユーザーIDはデフォルトで機能します。

認証タイプがORASSOの場合、Oracle SSOが前面に来るアイデンティティ管理サーバー内のユーザーのID (およびパスワード)を入力します。このユーザーには、sysadminと同じ権限が付与される必要があります。これらの権限を付与できない場合は、このユーザーに対応するContent Server内のリモート・ユーザーを削除し、Content Server内で(同じ名前の)ローカル・バージョンのユーザーを作成します。

管理者のパスワード: クロール管理ユーザーのパスワード

認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を見つけるには、Oracle SESで、「グローバル設定 - アイデンティティ管理設定」ページに移動します。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(たとえば、nickname、usernameなど)。Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

レルム:

認証タイプがNATIVEの場合、Idc Security /cs/idcplgと入力しますが、ここで/cs/は、Content Serverのインストール時に指定したコンテキスト・ルートです。

認証タイプがORASSOの場合、このフィールドは空白のままにします。

5. 「作成およびカスタマイズ」をクリックして(または作成したソースを編集して)、その他のソース・パラメータを参照します。「クロール・パラメータ」タブで、Document Service Pipelineと入力します。

6. 「有効化」をクリックして作成したパイプラインを選択します。

18.6.3.3 ディスカッションおよびお知らせを検索するためのOracle SESの設定

Oracle SESを使用してディスカッションとお知らせを検索するには、まず、ディスカッション用に3つとお知らせ用に1つのOracle SESデータベース・ソースを設定する必要があります。3つのディスカッション・リソースは、フォーラム用、フォーラム内のトピック用およびフォーラム内の応答用です。これら個別のソースを使用すると、ユーザーは、フォーラム内のすべてのメッセージおよび応答の結果を表示せずにフォーラムの検索結果を表示できます。

たとえば、ディスカッション・ソースに次のものがあるとします。

- ソース名GS_ForumsおよびビューFORUMCRAWLER_VW

- ソース名GS_TopicsおよびビューTHREADCRAWLER_VW

- ソース名GS_RepliesおよびビューMESSAGECRAWLER_VW

お知らせのソースのソース名をGS_Announcements、ビューをANNOUNCEMENTS_VWにできます。

注意:
Oracle、Microsoft SQL ServerおよびIBM DB2データベースでは、手順が多少異なります。

1. JDBCドライバを構成します。

1. Microsoft SQL ServerまたはIBM DB2データベースをクロールするには、適切なJDBCドライバjarファイルをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。

注意:

- Microsoft SQL Serverの場合: Microsoft JDBCドライバ・ファイル、sqljdbc.jarおよびsqljdbc4.jarをコピーします。

- IMB DB2の場合: IBMドライバ・ファイル、db2jcc.jarおよびdb2jcc_license_cu.jarをコピーします(IBM DB2 UDBクライアントから取得可能)。

JDBCドライバがJRE 1.5用とJRE 1.6用で異なる場合(たとえば、JRE 1.5ではsqljdbc.jar、JRE 1.6ではsqljdbc4.jarなど)、次の手順を実行します。

- 両方のドライバJarをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。

- JRE 1.6バージョンのドライバJar (SQLServerの場合sqljdbc4.jar)のエントリを、ORACLE_HOME/search/config/searchctl.confのCLASSPATH要素に追加します。

- 中間層を再起動します。

2. drivers.propertiesファイルをDatabaseName:DriverClassNameの情報を使用して更新します。

3. JRE 1.5 JDBCドライバJarファイル名を、appsjdbc.jarおよびDBCrawler.jarのMETA-INF/MANIFEST.MF内のクラスパスに追加します。
例: 変更前

Class-Path:  sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar

変更後

Class-Path:  db2jcc.jar sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar

変更前

Class-Path: appsjdbc.jar

変更後

Class-Path: db2jcc.jar appsjdbc.jar

KEYという名前が付けられていないkey属性の場合、drivers.propertiesファイル内のJDBCドライバ情報を変更して、database_name: driver_class_name, key_attribute_nameのようにキー属性名を指定します。

たとえば、IDという名前のキー属性の場合、次のようになります。

oracle : oracle.jdbc.driver.OracleDriver, ID

クロール問合せでは、キー値列名の別名としてkey_attribute_nameを使用します。この例で、IDはKEYVALの別名です。

SELECT keyval id, content, url, lastmodifieddate, lang FROM sales_only

OracleおよびSQL Serverデータベース: drivers.propertiesになにも指定されていない場合、次のデフォルト・ドライバが使用されます。

- Oracle: oracle.jdbc.driver.OracleDriver

- SQL Server: com.microsoft.sqlserver.jdbc.SQLServerDriver

2. IBM DB2データベースの場合のみ、次の手順が必要となります。

1. データベース・クローラ・ソースを使用するクローラが実行されていないことを確認します。Oracle SES管理ツールの「ホーム」→「スケジュール」ページで、クローラの進捗状況とステータスを確認します。(「ステータスのリフレッシュ」をクリックします。)

2. appsjdbc.jarファイルとDBCrawler.jarファイルを再作成します。クローラが失敗してログ・ファイルに次のエラーが記録されないよう、META-INF/MANIFEST.MFが正しく更新されていることを確認してください。

EQP-80406: Loading JDBC driver failed

3. ORACLE_HOME/search/lib/plugins/oracleapplications/drivers.propertiesファイルを変更して次の行を追加します。

db2: com.ibm.db2.jcc.DB2Driver

4. ORACLE_HOME/search/config/searchctl.confのCLASSPATH要素にドライバJar (db2jcc.jar)を追加します。例:

#CLASS PATH
CLASSPATH=ORACLE_HOME/search/webapp/config:ORACLE_HOME/search/webapp/
SESAuthenticator.jar:ORACLE_HOME/search/lib/plugins/commons-plugins-
stubs.jar :ORACLE_HOME /search/lib/plugins/oracleapplications/db2jcc.jar

5. $ORACLE_HOME/search/config/searchctl.confファイルのJVM_OPTIONSを編集して、システム・プロパティ"-Doracle.home=ORACLE_HOME/search"を追加します。例:

JVM_OPTIONS= -Djava.awt.headless=true
-Dweblogic.RootDirectory=ORACLE_HOME/search/base_domain
-Doracle.home=ORACLE_HOME/search

6. $ORACLE_HOME/search/lib/plugins/oracleapplications/pluginmessages.jarファイルを$ORACLE_HOME/search/libディレクトリにコピーします。

7. データベース・ソースを作成します。正しい認可問合せを入力し、「セキュリティ属性の付与」で使用した属性名が認可問合せで使用する属性名と一致していることを確認します。一致していない場合、ドキュメントの検索の際、ユーザーは結果を得ることができません。

3. ディスカッション・ソースまたはお知らせソースを作成します。

1. Oracle SESで、「ホーム」→「ソース」に進みます。

2. 「ソース・タイプ」ドロップダウン・リストで、「データベース」を選択し、「作成」(図18-39)をクリックします。

図18-39 データベース・ソースの作成

3. 次のパラメータを入力します。
ソース名: unique_name。たとえば、ディスカッション・フォーラムをクロールする場合、GS_Forums (お知らせをクロールする場合は、GS_Announcements)。

データベース接続文字列: 次のいずれかを入力します。

- Oracleデータベース: 次のいずれかを入力します。

jdbc:oracle:thin:@host:port:sid

jdbc:oracle:thin@host:port/serviceId

- IBM DB2データベース: jdbc:db2://host:port/database_nameと入力します。

- Microsoft SQL Serverデータベース: jdbc:sqlserver://host_or_IP_address:port;database_nameと入力します。

ユーザーID: 次のいずれかを入力します。

- Oracleデータベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DISCUSSIONS_CRAWLER

- Microsoft SQL Serverデータベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DISCUSSIONS_CRAWLER

- IBM DB2データベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DC(MyPrefixは5文字)

パスワード: このユーザーのパスワード。

問合せ: 次のいずれかの問合せを入力します。

SELECT * FROM FORUMCRAWLER_VW
SELECT * FROM THREADCRAWLER_VW
SELECT * FROM MESSAGECRAWLER_VW
SELECT * FROM ANNOUNCECRAWLER_VW

ソース・クロール・ディスカッション・フォーラムには、FORUMCRAWLER_VWを使用します。

ディスカッション・フォーラムのソース・クロール・トピックには、THREADCRAWLER_VWを使用します。

ディスカッション・フォーラムのソース・クロール応答には、MESSAGECRAWLER_VWを使用します。

ソース・クロールお知らせには、ANNOUNCECRAWLER_VWを使用します。

URL接頭辞: ホスト、ポートおよびアプリケーション名を含むPortal FrameworkアプリケーションのURL接頭辞。たとえば、http://host:port/myPortalAppのようになります。

セキュリティ属性の付与: WCSECATTR

注意:
以前のリリースのContent Serverでは、「セキュリティ属性の付与」にFORUMIDが使用されていました。

4. 「次へ」をクリックします。

5. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページの「認可マネージャ」セクションで次のパラメータを入力します(事前に移入されていない場合)。
プラグイン・クラス名: oracle.search.plugin.security.auth.db.DBAuthManager

Jarファイル名: oracleapplications/DBCrawler.jar

認可データベース接続文字列: 次のいずれかを入力します。

- Oracleデータベース: 次のいずれかを入力します。

jdbc:oracle:thin:@host:port:sid

jdbc:oracle:thin@host:port/serviceId

- IBM DB2データベース: jdbc:db2://host:port/database_nameと入力します。

- Microsoft SQL Serverデータベース: jdbc:sqlserver://host_or_IP_address:port;database_nameと入力します。

ユーザーID: 次のいずれかを入力します。

- Oracleデータベース: ユーザーMyPrefix_DISCUSSIONS_CRAWLERを入力します。

- Microsoft SQL Serverデータベース: ユーザーMyPrefix_DISCUSSIONS_CRAWLERを入力します。

- IBM DB2データベース: ユーザーMyPrefix_DC (MyPrefixは5文字)を入力します。

パスワード: このユーザーのパスワード

単一レコード問合せ: false

認可問合せ: (1行で)次を入力します。

SELECT DISTINCT forumID as WCSECATTR
FROM AUTHCRAWLER_FORUM_VW
WHERE username = LOWER(?) UNION SELECT DISTINCT -1 as WCSECATTR
FROM AUTHCRAWLER_FORUM_VW

注意:
以前のリリースのContent Serverでは、次の認可問合せが使用されていました。

SELECT forumID
FROM AUTHCRAWLER_FORUM_VW
WHERE (username = ? or userID=-1)
UNION SELECT f.forumID
FROM jiveForum f, AUTHCRAWLER_CATEGORY_VW c
WHERE f.categoryID = c.categoryID AND (c.username =  ? or userID=-1)

認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を見つけるには、Oracle SESで、「グローバル設定 - アイデンティティ管理設定」ページに移動します。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(たとえば、nickname、usernameなど)。

Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

6. 「作成」をクリックしてソースの作成を完了します。

18.6.3.4 Oracle SESファセットおよびソート属性の構成

ファセットは、新しい検索を実行せずにインデックス化されたデータを移動することによってユーザーが検索を詳細設定できるOracle SESオブジェクトです。まず、Oracle SESで(提供されるファイルを使用して)ファセットを定義する必要があります。Oracle SESで定義されたファセットは、「ツールとサービス」→「検索」管理ページを使用してPortal Frameworkで適用されます。

注意:
Oracle SES 11.2.2.2は、このリリースのWebCenter Portalによるファセット検索をサポートしています。以前のリリースはサポートしていません。

WebCenter Portalには、Oracle SES Admin APIコマンド行インタフェース用の次の入力ファイルが用意されています。

- facet.xml: Oracle SESでファセットを構成します。

- searchAttrSortable.xml: 絶対ソートの属性を定義します。

これらのファイルをoracle.webcenter.framework/ses/webcenter_portal_ses_admin.zipで見つけます。このファイルを解凍し、readme.txtファイルの指示に従います。

これら2つのファイルをOracle SESから実行すると、次のファセットが作成されます。

- Author

- Last Modified Date

- Mimetype

- Tags

- Scope GUID (これは「ポータル」ファセットとして表示されます。この値は、検索結果ページでポータル表示名に変換されます。)

- Service ID (このファセットはユーザー・インタフェースには表示されません。有効なすべてのツールおよびサービスは検索結果ページに表示されます。)

注意:
facet.xmlスクリプトおよびsearchAttrSortable.xmlスクリプトは必須です。Portal Frameworkアプリケーションで検索するには、Oracle SESでのファセット作成のみでは不十分です。
また、Scope GUIDおよびService IDファセットは必須です。ファセット名では、大/小文字が区別されます。これらのファセット名を正確に指定する必要があります。

これらのファイルを実行した後、Oracle SES管理ツールの「グローバル設定」→「ファセット」ページにファセットが表示されます(図18-40)。

図18-40 Oracle SESファセット

新しいファセットを作成するには、「グローバル設定」→「ファセット」ページで「作成」をクリックします。ファセット値の生成元であるファセットの名前および検索属性を入力します。「文字列」ファセット・タイプには、パス・デリミタも入力する必要があります。これは、選択したファセット・ツリー・ノードのファセット・ツリー階層を問合せページに表示するための境界用に使用する1文字で、たとえば、"tools/power tool/drills"の"/"がパス・デリミタです。ファセット・ツリーが1レベルの深さの場合(つまりこのノードに子ノードがない場合)、これを空白に設定できます。

「作成してカスタマイズ」をクリックしてファセットを作成し、「ファセットの編集」ページでこのノードを構成します。日付タイプまたは数値タイプのファセットのファセット・ノードを構成できます。たとえば、「最終変更日」ファセットの場合、「昨年」、「先月」、「今日」、特定の2つの日付の間などのノードを作成できます。

「ノード構成」タブには、ファセット階層がツリー形式およびXML形式で表示され、ここで選択したファセット・ノードの子ノードを追加、編集および削除できます。ファセット・ノードを編集した後、「適用」をクリックして変更内容を保存します。

注意:
Scope GUIDファセットまたはService IDファセットは変更または削除しないでください。

Oracle SESで行われた変更は、アプリケーションのスペシャリストが「ツールとサービス」→「検索」管理ページに移動するとPortal Frameworkアプリケーションで適用されます。Portal Frameworkアプリケーションは、この「検索」管理ページが開くまでファセットの変更を検出しません。WebCenter Portalでは、使用するために選択したファセットがポータルごとに記憶されます。

18.6.3.5 追加のOracle SES構成

この項では、Oracle SES管理ツールで必要な手順について説明します。

1. Content Server、ディスカッション、お知らせおよび作成したWebCenterのソースの名前を含む、ソース・グループを作成します。

1. 「検索」→「ソース・グループ」に進み、「作成」をクリックします。

2. 第18.6.4項「Oracle SESのためのWebCenter Portal Frameworkアプリケーションの設定」で入力したソース・グループ名と同じ名前を入力します。

3. 「ソース・タイプの選択」ドロップダウン・リストから、各ソース・タイプ(Database、Content Server、Oracle WebCenter)を選択し、各ソース・タイプに対してリストされた「使用可能なソース」から、そのソース・タイプに対して作成したソースを「割り当てられたソース」リストに移動します。

4. 「完了」をクリックします。

2. 必要に応じて、セキュリティ・フィルタの有効期間を構成します。これにより、システム内のユーザーの認可ポリシーがリフレッシュされます。ユーザー・ポリシーが頻繁に変更される場合は、有効期間を短くするのが最適です。(この章では、例としてOracle Internet Directoryアイデンティティ・プラグインを使用しています。)
たとえば、「グローバル設定」→「問合せ構成」ページの「セキュア検索の構成」の下で、「セキュリティ・フィルタ有効期間(分)」に0を入力します。

セキュリティ・フィルタ有効期間の有効な値は、0分(キャッシュなし)から526500分(1年間のキャッシュ)です。

3. すべてを索引付けするには、各ソースに対してフル・クロールを強制する必要があります。つまり、各ソースの既存の増分クロール・スケジュールを、まずすべてのドキュメントを処理するように変更する必要があります。
この手順は非常に重要で、これで、コンテンツが最初に完全に索引付けされるまで、検索が機能しなくなります。

「ホーム」→「スケジュール」ページに進み、ソース・スケジュールを選択して「編集」をクリックし、フル・クロールを強制します。

各ソースのクロールが完了したら、同じページに戻り、クロール・ポリシーを増分(前回のクロール以降に変更されたドキュメントを索引付けする)に戻します。また、このページの「頻度」セクションで、増分クロールの実行に手動以外のタイプ(毎週、毎日など)を選択します。

注意:
Content Serverの最初のクロールの前に、Content Serverの「管理」ページに進み、「SESクローラ・エクスポート」を選択してスナップショットを撮ることを忘れないでください。詳細は、第18.6.1項「Oracle SESのためのOracle WebCenter Content Serverの設定」を参照してください。

18.6.4 Oracle SESのためのWebCenter Portal Frameworkアプリケーションの設定

この項では、Oracle SESと連動するようWebCenter Portal Frameworkアプリケーションを構成する方法について説明します。

フェデレーション・トラステッド・エンティティを指定し、オプションとしてソース・グループを指定して、Portal FrameworkアプリケーションとOracle SES間の接続を作成および構成済であることを確認してください。

Oracle SESクローラは、Portal Frameworkアプリケーションでデフォルトで有効にされています。

関連項目:
『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の検索の接続の設定に関する項

18.6.4.1 デプロイ後のPortal Frameworkアプリケーションの構成

Portal Frameworkアプリケーションが管理対象サーバーにデプロイされたら、WLSTまたはFusion Middleware Controlを使用してそれを構成できます。この項には次のトピックが含まれます:

- 第18.6.4.1.1項「WLSTを使用した検索パラメータの変更」

- 第18.6.4.1.2項「WLSTを使用したOracle SESのバージョンの構成」

- 第18.6.4.1.3項「WLSTを使用した検索クローラの構成」

- 第18.6.4.1.4項「Fusion Middleware Controlを使用した検索パラメータとクローラの構成」

18.6.4.1.1 WLSTを使用した検索パラメータの変更

WLSTコマンドのsetSearchConfigを使用して、デプロイ後に検索パラメータを変更します。

例18-12は、Oracle SESを検索するデータ・グループ(ソース・グループとも呼ばれる)を指定する方法を示しています。

例18-12 ソース・グループの設定

setSearchSESConfig(appName='myPortalApp',
dataGroup='mySources')

ここで、dataGroupは、第18.6.3.5項「追加のOracle SES構成」で作成したソース・グループです。

例18-13は、表示される検索結果数を増加させる方法を示しています。Oracle SESの結果で表示される検索結果数のデフォルトの設定は5ですが、一般的に設定される結果数は5より大きくなります。

例18-13 表示される検索結果数の増加

setSearchConfig(appName='myPortalApp',
numResultsMain=10)

例18-14は、ツール/サービスが検索を実行するために許可される最大時間(ミリ秒)を構成する方法を示しています。サービスがいつタイムアウトするかは、主にシステムの負荷に依存します。常にタイムアウト・エラーが生じる場合は、このパラメータを調整できます。

例18-14 WebCenterで検索結果を待機する最大時間の構成

setSearchConfig(appName='myPortalApp',
executionTimeout=10000)

コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetSearchConfigに関する項を参照してください。

18.6.4.1.2 WLSTを使用したOracle SESのバージョンの構成

WLSTコマンドのsetSESVersionを実行して、デフォルトの接続に関連付けられたOracle SESインスタンスのバージョン情報を取得して、格納する必要があります。このコマンドにより、ファセット検索と、「ツールとサービス」→「検索」管理ページが有効になります。このページは、Oracle SES 11.2.2.2を使用した検索の設定をカスタマイズするために必要になります。

Portal FrameworkアプリケーションがJDeveloperの統合サーバーにデプロイされている場合は、アプリケーションの起動後に、WLSTコマンドのsetSESVersionを実行する必要があります。バージョン・データは、統合サーバーの各インスタンス間で永続化されません。また、Portal Frameworkアプリケーションのサイトにアクセスする前にも、setSESVersionコマンドを実行する必要があります。例:

1. 統合されたサーバーとPortal Frameworkアプリケーションを起動します。

2. setSESVersionコマンドを実行します。

3. サイトにアクセスします。

Oracle SESのバージョンが正しく設定されていることを確認するには、WLSTコマンドのlistSESVersionを実行します。

例18-15に、これらのコマンドを示します。完全なコマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetSESVersionに関する項およびlistSESVersionに関する項を参照してください。

例18-15 ファセット問合せと「ツールとサービス」の「検索」管理ページの有効化

setSESVersion(appName='myPortalApp',
sesUrl='http://myhost.com:5720/search/api/admin/AdminService',
sesSchema='searchsys', sesPassword='password'
listSESVersion(appName='myPortalApp',
sesUrl='http://myhost.com:5720/search/api/admin/AdminService')

18.6.4.1.3 WLSTを使用した検索クローラの構成

WLSTコマンドを使用して、デプロイ後にクローラを作成したり、クローラのスケジュールを開始、停止および削除できます。これらのコマンドでは、Oracle SES内の新しいデータをクロールしたり、構成データが変更されると古いクローラを削除できます。

例18-16と例18-17は、これらのコマンドの一部を示しています。詳細は、『WebLogic Scripting Toolコマンド・リファレンス』の検索 - Oracle SES検索クローラに関する項を参照してください。

例18-16 WLSTでのドキュメント・クローラの作成

createDocumentsCrawler(
appName='myPortalApp', host='myWebcenterHost', port='myWebcenterPort',
sesUrl='http://mySEShost.com:7777/search/api/admin/AdminService',
sesPassword='mySESAdminPassword',
configUrl='http://myContentServerHost:myContentServerPort/cs/idcplg?IdcService=SES_CRAWLER_DOWNLOAD_CONFIG&source=default',
user='ContentServer_crawl_user', password='ContentServerCrawlPassword',
scratchDir='/tmp', httpEndpoint='http://myContentServerHost:myContentServerPort/cs/idcplg',
displayUrl='http://myContentServerHost:myContentServerPort/cs', realm='Idc Security /cs/idcplg',
authUserIdFormat='authentication-id-format', pipelineName='Document-pipeline',
crawlingMode='ACCEPT_ALL', recrawlPolicy='PROCESS_CHANGED', freqType='MANUAL',
startHour=1, hoursBetweenLaunches=1, startDayOfWeek='MONDAY', startDayOfMonth=1,
daysBetweenLaunches=1, weeksBetweenLaunches=1, monthsBetweenLaunches=1,
sesSchema='eqsys')

例18-17 WLSTでのディスカッション・クローラの作成

createDiscussionsCrawler(
appName='myPortalApp', host='myWebcenterHost', port='myWebcenterPort',
sesUrl='http://mySEShost.com:7777/search/api/admin/AdminService',
sesPassword='mySESAdminPassword',
dbConnString='jdbc:oracle:thin:@database-host:database-port:database-sid',
user='Jive-crawler-schema', password='Jive-crawler-schema-pw',
authUserIdFormat='authentication-id-format', crawlingMode='ACCEPT_ALL',
recrawlPolicy='PROCESS_ALL', freqType='MANUAL', startHour=1,
hoursBetweenLaunches=1, startDayOfWeek='MONDAY', startDayOfMonth=1,
daysBetweenLaunches=1, weeksBetweenLaunches=1, monthsBetweenLaunches=1,
sesSchema='eqsys')

注意:

- authentication-id-formatでは、Oracle SES上のアイデンティティ管理プラグインがOracle Internet Directoryに設定されている場合はニックネームを使用します。それ以外の場合は、Oracle SES上のアイデンティティ管理プラグインの「認証属性」パラメータの値を使用します。

- database-hostでは、Oracle WebCenter Portalのディスカッション・サーバー・データベースのホスト名を使用します。

- Jive-crawler-schemaでは、ディスカッション・サーバー・クローラのスキーマ名を使用します。RCUから接頭辞を決定し、rcu-prefix_DISCUSSION_CRAWLERを使用します。

- sesSchemaでは、デフォルト値はsearchsys(Oracle SES 11.2.2.2のデフォルトの管理ユーザー名)ですが、インストール中に別の名前も指定できます。Oracle SES 11.1.*を使用している場合は、このパラメータをeqsysに設定してください。

- WLSTの変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

18.6.4.1.4 Fusion Middleware Controlを使用した検索パラメータとクローラの構成

Fusion Middleware Controlを使用して、Oracle SESを有効化または無効化したり、検索設定を構成できます。

1. Fusion Middleware Controlにログインし、Portal Frameworkアプリケーションのホームページに移動します。詳細は、第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「設定」→「アプリケーション構成」を選択します。

3. 「検索クローラ」セクションで、Oracle SESの使用を選択して、「適用」をクリックします(図18-41)。

4. 必要に応じて「検索設定」を構成し、「適用」をクリックします(図18-41)。

図18-41 Oracle検索のアプリケーション設定

- Oracle Secure Enterprise Searchデータ・グループ: 検索するOracle SESソース・グループを指定します。値を指定しない場合、Oracle SESインスタンス内のすべてが検索されます。

- 実行タイムアウト: ツール/サービスが検索を実行できる最大時間(ミリ秒単位)を入力します。

- 実行者の準備タイムアウト: ツール/サービスが検索を初期化できる最大時間(ミリ秒単位)を入力します。

- サービス当たりの結果数 - 保存済検索タスク・フロー: 保存済検索タスク・フローに表示される、ツール/サービス当たりの検索結果数を入力します。

- サービス当たりの結果数 - 検索ページ: メインの検索ページから送信された検索に対して、ツール/サービスごとに表示する検索結果の数を入力します。すべての結果を表示する場合、ユーザーは「すべて表示」をクリックできます。

- 検索ページの保存済の検索の数: 「保存済検索」リスト(メインの検索ページ上)に表示する保存済検索の数を入力します。

Portal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要はありません。

18.7 Oracle SESに関する問題のトラブルシューティング

この項では、Oracle SESの管理に関するトラブルシューティングのヒントについて説明します。次のトピックが含まれています。

- 第18.7.1項「検索結果が見つからない」

- 第18.7.2項「検索失敗のエラー」

- 第18.7.3項「WebCenter Portalにview権限を付与できない」

- 第18.7.4項「ソース・グループまたはソース・タイプによるOracle SESの結果の制限」

- 第18.7.5項「検索結果に保護されたリソースが含まれない」

- 第18.7.6項「検索結果にドキュメントが含まれない」

- 第18.7.7項「検索結果にディスカッションとお知らせが含まれない」

- 第18.7.8項「検索結果に最近追加されたリソースが含まれない」

- 第18.7.9項「検索結果に認可の変更が反映されない」

- 第18.7.10項「検索結果に幅広いユーザーに利用可能なリソースが含まれない」

18.7.1 検索結果が見つからない

問題

検索結果が見つかりません。

解決策

次のことを確認します。

- Oracle SES接続

- ドキュメントとディスカッションの接続

- WebCenter Portalのクロール構成

- Oracle SES構成

- ユーザー認証

- Oracle SESのクロール

- Oracle SESの認可

18.7.1.1 Oracle SES接続

Oracle SES SOAP URLにアクセスできること、およびOracle SESへの接続のプロパティが正しいことを確認してください。

詳細は、第18.4.1項「Oracle SES接続のテスト」を参照してください。

18.7.1.2 ドキュメントとディスカッションの接続

WebCenter PortalにContent Serverとディスカッション・サーバーへの接続が存在することを確認してください。

Oracle SESログには、WebCenter Portalコンポーネントが検索から除外されているかどうかが示されます。Oracle SESインスタンスで検索ログ・ファイルを探し、ログ・ファイルでtotalSearchTimeを確認してください。

サービスが除外されていない(つまり、Oracle SESがすべてのWebCenter Portalコンポーネントに対して有効にされている)場合は、次のような行になります。

req=Search userName=vicki totalSearchTime=1150ms userQuery=0712>

Oracle SESがドキュメント、ディスカッションおよびお知らせに対して有効にされていない場合は、次のような行になります。

req=Search userName=vicki totalSearchTime=1133ms userQuery=0712
-wc_serviceId:oracle.webcenter.doclib
-wc_serviceId:oracle.webcenter.collab.forum
-wc_serviceId:oracle.webcenter.collab.announcement>

18.7.1.3 WebCenter Portalのクロール構成

第18.5.1項「Oracle SESのためのWebCenter Portalの設定」の説明に従って、Fusion Middleware ControlまたはWLSTを使用して、Oracle SESがWebCenter Portalで有効にされていることを確認します。

18.7.1.4 Oracle SES構成

1. Oracle SESに必要なすべてのパッチがインストールされていることを確認します。必要なパッチの最新情報は、『Oracle WebCenter Portalインストレーション・ガイド』の検索のバックエンド要件に関する項およびリリース・ノートを参照してください。

2. Oracle SESが、ユーザーを検証および認証するためにアイデンティティ管理システムとともに構成されていることを確認します。また、WebCenter PortalとOracle SESが同じアイデンティティ管理システム(Oracle Internet Directoryなど)を使用していることを確認します。使用するすべてのリポジトリ(WebCenter Portal、WebCenter Content ServerおよびOracle WebCenter Portalのディスカッション・サーバーなど)は、Oracle SESと同じユーザー・ベースを共有している必要があります。
さらに、WebCenter Portalエンド・ユーザーが検索時にセキュアに伝播されるようにするため、各Oracle SESインスタンスには1つの信頼できるエンティティが必要です。詳細は、第18.3.2項「Oracle SES: 構成」を参照してください。

Oracle SESがフェデレーション・トラステッド・エンティティ・ユーザーと接続されていることをテストするには、第18.4.1項「Oracle SES接続のテスト」を参照してください。

18.7.1.5 ユーザー認証

WebCenter Portalアイデンティティ・プラグイン、Oracle SESおよび構成されているすべてのデータ・リポジトリ(Content Serverやディスカッション・サーバーなど)にユーザーが存在すること(つまりそのユーザーがログオンできること)を確認します。

WebCenter Portal診断ログのOracle SESプロキシ・ログイン・エラーは、次のように表示されます。

Received status "failed" during proxy login with application entity "weblogic" to
Oracle SES at [http://host:port/search/query/OracleSearch], as search user
"vicki". Defaulting to public.

18.7.1.6 Oracle SESのクロール

Oracle SESがすべてのソースで正常にクロールを実行したことを確認します。

1. Oracle SES管理ツールで、「ホーム」→「スケジュール」タブに移動します。「ログ・ファイル」アイコンをクリックし、ソースのログ・ファイルを表示します。完全なログの場所を取得するには、「ステータス」リンクをクリックします。「クローラの進捗状況のサマリーおよびソース別ログ・ファイル」セクションに、ログ・ファイルのフル・パスが表示されます。

2. Oracle SESが認証エラーによりContent Serverのクロール・エンドポイントにログインできない場合、次のエラーがログに記録されます。

EQP-60303: Exiting saxthread due to errors

EQP-80330: Unrecognized QName <http://schemas.xmlsoap.org/soap/envelope/>:Envelope oracle.search.sdk.crawler.PluginException

3. Oracle WebCenterソースの場合、rsscrawlサーブレットが使用できないかどうかを確認します。例:

FATAL      main            EQP-80309: Exception while opening a stream to the URI: https://example.com:port/rsscrawl?command=GetControl

4. Content Serverソースの場合、パスワードが無効であるかどうかを確認します。例:

-1 Admin credentials passed in were not valid - Rejecting request.

5. 次の組合せを使用して、Oracle SES管理ツール内のクロール・プロセスをモニターします。

1. 「ホーム」→「スケジュール」ページでクローラの進捗状況とステータスを確認します。(「ステータスのリフレッシュ」をクリックします。)「ステータス」ページで、クロールの統計を表示できます。

2. 「ホーム」→「スケジュール」→「クローラの進行状況のサマリー」ページおよび「ホーム」→「統計」ページでクローラの統計をモニターします。

3. 「ホーム」→「一般」ページおよび「ホーム」→「統計」ページで検索の統計をモニターします。

クロールのパフォーマンスを調整するためのヒントは、Oracle Secure Enterprise Search管理者ガイドを参照してください。

6. さらに、Content Serverインスタンス上のスナップショットとデータフィード、およびOracle WebCenter Portalのディスカッション・サーバー・データベースを調べてください。

18.7.1.7 Oracle SESの認可

1. Oracle SES管理ツールで、「ホーム」→「ソース」タブに移動します。

2. ソースの「編集」アイコンをクリックし、ソース構成のタブを確認します。

3. 「認可」タブをクリックして、認可接続文字列、ユーザー名、パスワードおよび認可ユーザーID形式を確認します。

4. Oracle SESログ・ファイル(前の手順で説明)を調べます。URL値を含むフレーズを探してください。たとえば、URIに初期化されたURIHandlerなどです。

http://host:8888/sesUserAuth?userId=someone

Oracle SES管理ツールの詳細は、製品に付属のOracle SESドキュメントを参照してください。(これらは、Oracle Fusion Middlewareドキュメント・ライブラリのWebCenter Portal製品の領域にリストされています。)

関連項目:

- 第18.5.4.2項「ドキュメントを検索するためのOracle SESの設定」

- 第18.5.4.3項「ディスカッションおよびお知らせを検索するためのOracle SESの設定」

- 第18.5.4.4項「ポータル、リスト、人およびページ・メタデータを検索するためのOracle SESの設定」

Portal Frameworkアプリケーションの場合:

- 第18.6.3.2項「ドキュメントを検索するためのOracle SESの設定」

- 第18.6.3.3項「ディスカッションおよびお知らせを検索するためのOracle SESの設定」

18.7.2 検索失敗のエラー

問題

検索後に検索失敗のメッセージが断続的に表示される場合があります。たとえば、データベースjdbc:oracle:thin:@host:1521/sidに接続するときに、ユーザーがPREFIX_DISCUSSIONS_CRAWLERの場合、次が表示されます。

Search failure: time out error
Search failure: problem preparing search executor
Search failure: problem with execution

解決策

しばらく待ってから、検索を再試行してください。これらのメッセージはサービスがタイムアウトした場合に表示され、このタイムアウトは多くの場合システムの負荷に依存します。タイムアウト・エラーが続く場合は、setSearchConfigコマンドのexecutionTimeoutパラメータを調整してください。

コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetSearchConfigに関する項を参照してください。

18.7.3 WebCenter Portalにview権限を付与できない

問題

第18.5.1項「Oracle SESのためのWebCenter Portalの設定」の手順に従ってview権限を付与しようとすると、次のエラーが表示されます。

Command FAILED, Reason: javax.naming.directory.AttributeInUseException: [LDAP: e
rror code 20 - uniquemember attribute has duplicate value.]; remaining name 'orc
lguid=F0CC506017B711DFBFFED9EA6A94EAEC,cn=Permissions,cn=JAAS Policy,cn=webcente
r,cn=wc_domain,cn=JPSContext,cn=jpsroot_webcenter_dadvmc0057'

解決策

このエラーは権限の付与時に表示されます。エラーを無視してください。

18.7.4 ソース・グループまたはソース・タイプによるOracle SESの結果の制限

問題

検索結果をソース・グループまたはソース・タイプで制限する必要があります。

解決策

Oracle SES管理ツールで、「ホーム」→「ソース」→「フェデレーテッド・ソースのカスタマイズ」→「検索制限」ページに移動し、検索の制限を設定します。またはフィルタを使用します(各フィルタは検索結果の制限として機能します)。

Oracle SESの使用方法の詳細は、Oracle Fusion Middlewareドキュメント・ライブラリ(WebCenter Portal製品領域内)でOracle SESドキュメントを参照してください。

18.7.5 検索結果に保護されたリソースが含まれない

問題

検索結果に保護されたリソースが含まれません。1つの原因は、WebCenter Portalユーザーのプロキシ・ログインがOracle SESで失敗したことです。WebCenter Portal診断ログのOracle SESプロキシ・ログイン・エラーは、次のように表示されます。

Received status "failed" during proxy login with application entity "weblogic" to
Oracle SES at http://host:port/search/query/OracleSearch, as search user "vicki".
Defaulting to public.

解決策

Oracle SESが、ユーザーを検証および認証するためにアイデンティティ管理システムとともに構成されていることを確認します。

また、WebCenter PortalとOracle SESが同じアイデンティティ管理システム(Oracle Internet Directoryなど)を使用していることを確認します。すべてのリポジトリ(WebCenter Portal、WebCenter Content ServerおよびOracle WebCenter Portalのディスカッション・サーバーなど)は、Oracle SESと同じユーザー・ベースを共有している必要があります。

さらに、WebCenter Portalエンド・ユーザーが検索時にセキュアに伝播されるようにするため、各Oracle SESインスタンスには1つの信頼できるエンティティが必要です。

問題

検索結果に保護されたリソースが含まれません。もう一つの原因は、認可エンドポイントが正しく構成されていないことです。Oracle SESインスタンスで検索ログ・ファイルを探します。URL値を含むフレーズを探してください。例:

EQP-80309: Exception while opening a stream to the URI:
http://<host>:<port>/sesUserAuth?userId=<end-user-name>

QueryFilterPlugin returned null or empty array value for security attribute
"WCSECATTR". Values required for all security attributes.

解決策

1. Oracle SES管理ツールで、「ホーム」→「ソース」タブに移動します。

2. ソースの「編集」アイコンをクリックし、ソース構成のタブを確認します。

3. 「認可」タブをクリックして、認可接続文字列、ユーザー名、パスワードおよび認可ユーザーID形式を確認します。

問題

検索結果に保護されたリソースが含まれません。さらにもう1つの原因は、認可エンドポイントが認可データを返していないことです。

Oracle SESインスタンスで検索ログ・ファイルを探します。URL値を含むフレーズを探してください。たとえば、URIに初期化されたURIHandlerなどです。

http://host:8888/sesUserAuth?userId=someone

解決策

クロール・ソースの数を減らします。

18.7.6 検索結果にドキュメントが含まれない

問題

検索結果にドキュメントが含まれません。Content Serverドキュメントのクロールが失敗します。

解決策

1. Oracle SES管理ツールで、「ホーム」→「スケジュール」タブに移動します。

2. 「ログ・ファイル」アイコンをクリックし、ソースのログ・ファイルを表示します。完全なログの場所を取得するには、「ステータス」リンクをクリックします。

3. 「クローラの進捗状況のサマリーおよびソース別ログ・ファイル」セクションに、ログ・ファイルのフル・パスが表示されます。Oracle SESが認証エラーによりContent Serverのクロール・エンドポイントにログインできない場合、次のエラーがログに記録されます。

EQP-60303: Exiting saxthread due to errors,
EQP-80330: Unrecognized QName
<http://schemas.xmlsoap.org/soap/envelope/>:Envelope
oracle.search.sdk.crawler.PluginException

4. Content Serverクロール・ソースの構成パラメータを更新します。

18.7.7 検索結果にディスカッションとお知らせが含まれない

問題

クロール・ソースで、「認可」タブで「単一レコード問合せ」パラメータがtrueに設定されています。

解決策

「単一レコード問合せ」パラメータをfalseに設定します。

問題

アイデンティティ管理システムでは大文字と小文字が混在したユーザー名を使用しますが、Oracle WebCenter Portalのディスカッション・サーバー(Jive)データベースでは、すべて小文字のユーザー名を使用します。クロール・ソースの認可問合せでは、ユーザー名のパラメータにLOWER()関数を適用する必要があります。

解決策

認可問合せが次の文のようであることを確認します。

SELECT forumID as WCSECATTR FROM AUTHCRAWLER_FORUM_VW WHERE (username) = LOWER(?)
UNION SELECT DISTINCT -1 as WCSECATTR FROM AUTHCRAWLER_FORUM_VW

注意:
問合せで実際のユーザー名列を小文字に変換することはお薦めしません(たとえば、WHERE LOWER(username) = LOWER(?))。インデックス付きの可能性がある列に関数を追加すると、パフォーマンスに影響する場合があります。

18.7.8 検索結果に最近追加されたリソースが含まれない

問題

新規リソースが最近作成されましたが、検索結果にその新規リソースが含まれません。

解決策

新規リソースが検索結果で返されるようにするには、まずそのリソースをクロールおよび索引付けする必要があります。新しいコンテンツを索引付けするために、クロール・スケジュールが定期的に実行されます。新規リソースが頻繁に作成される場合は、クロール・スケジュールの頻度を増やしてください。新規リソースをすぐにクロールする必要がある場合は、クロール・スケジュールを手動で開始してください。

18.7.9 検索結果に認可の変更が反映されない

問題

一部のリソースには、WebCenter Portalでの認可の変更により、より多くのユーザーがアクセス可能になります。たとえば、ポータル内のリソースには、現在すべての認証ユーザーがアクセスできます。影響を受けるユーザーはこれらのリソースを検索できません。

解決策

認可データはOracle SESにキャッシュされます。キャッシュは、Oracle SESの「セキュリティ・フィルタ有効期間(分)」グローバル設定により無効にされます。デフォルト値は1日(1440分)です。認可データへの変更の標準的な頻度に応じて、値を調整してください。

18.7.10 検索結果に幅広いユーザーに利用可能なリソースが含まれない

問題

ポータルはパブリックにアクセス可能ですが、認証されていないユーザーは、検索結果でポータルのリソースを表示できません。

解決策

デフォルトでは、ポータルがパブリックに対してアクセス可能であるとしても、リソースへの「表示」アクセス権はポータルのメンバーにのみ付与されます。リソースの「表示」アクセス権を非メンバーに明示的に付与する必要があります。ポータルの設定ページに移動し、「ロール」タブで対象のロールを選択し、リソースへの「表示」アクセス権を付与するよう選択します。

19 サブスクリプションおよび通知の管理

この章では、サブスクリプションおよび通知の管理方法について説明します。管理者は、アプリケーションレベルのサブスクリプションに対するアプリケーション全体のデフォルトを作成し、そのデフォルトを強制適用することもできます。また、通知配信の処理用サーバーを特定する接続タイプを指定し、WLSTコマンドを使用して通知メッセージング構成の詳細を設定および取得できます。

この章には次のトピックが含まれます:

- 第19.1項「サブスクリプションおよび通知について」

- 第19.2項「デフォルトのサブスクリプション・プリファレンスの設定」

- 第19.3項「通知の設定」

- 第19.4項「カスタム通知テンプレートの作成および適用」

- 第19.5項「通知接続のテスト」

- 第19.6項「通知に関する問題のトラブルシューティング」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

19.1 サブスクリプションおよび通知について

WebCenter Portalでは、サブスクリプションおよび通知を使用することで、特に興味のあるサービスやアプリケーション・オブジェクトのタイプをサブスクライブできます。したがってユーザーは、サブスクライブしたサービスやオブジェクトに影響する変更について、選択したメッセージング・チャネルから適時に通知を受信します。

関連項目:
ポータルに通知機能を追加する方法については、『Oracle WebCenter Portalでのポータルの構築』の「ポータルへの通知の追加」を参照してください。

WebCenter PortalおよびPortal Frameworkアプリケーションのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後にWebCenter PortalまたはPortal Frameworkアプリケーションに加えた変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。第1.3.5項「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:
Fusion Middleware ControlまたはWLSTを使用して行った、WebCenter Portalツールおよびサービス構成のほとんどの変更は、動的ではありません。変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

19.2 デフォルトのサブスクリプション・プリファレンスの設定

WebCenter Portalユーザーは、WebCenter Portalの「プリファレンス」ダイアログで各自のサブスクリプション・プリファレンスを設定します。その前に、WebCenter Portal管理者がデフォルト値を設定し、すべてのユーザーが使用できるアプリケーションレベルのサブスクリプション・オプションを指定して、それらが変更可能かどうかを決定できます。

この項では、サブスクリプションのデフォルトの概要を示し、そのデフォルト値の設定手順について説明します。

この項には次のサブセクションが含まれます:

- 第19.2.1項「サブスクリプションのデフォルトについて」

- 第19.2.2項「サブスクリプションのデフォルトの設定」

- 第19.2.3項「WebCenter Portalでのサブスクリプション・プリファレンスの設定」

19.2.1 サブスクリプションのデフォルトについて

管理者レベルのサブスクリプション・プリファレンスは、カスタムXMLファイルで設定します。このファイルを作成して、あらかじめ用意されているファイル(notification-service-settings.xml)のかわりに使用します。カスタムXMLファイル内の設定は、ユーザーがWebCenter Portalのサブスクリプション・プリファレンスで行うアプリケーションレベルのサブスクリプション設定と類似しています(詳細は、『Oracle WebCenter Portalの使用』の「アプリケーション、ポータルおよびオブジェクトへのサブスクライブ」の章を参照してください。)

各設定には次の3つの属性があります。

- id - サービスIDを指定します:

- oracle.webcenter.peopleconnections.connections: ピープル・コネクション・サービスのコネクション機能

- oracle.webcenter.peopleconnections.wall: ピープル・コネクション・サービスのメッセージ・ボード機能

- oracle.webcenter.peopleconnections.kudos: ピープル・コネクション・サービスのフィードバック機能

- oracle.connections. community: ポータル・メンバーシップ管理

- subscription-enabled - プリファレンス・オプションのデフォルト値を指定します: trueまたはfalse

ヒント:
subscription-enabled属性は、サブスクリプション機能全体を有効化または無効化するのではなく、単にプリファレンス・オプションの初期状態を設定します。たとえば、subscription-enabled="true"の場合は、WebCenter Portalの「プリファレンス」ダイアログの関連付けられたサブスクリプション・オプションがデフォルトで選択されます。subscription-enabled="false"の場合、ダイアログの関連付けられたサブスクリプション・オプションはデフォルトで選択されません。

- end-user-configurable - 設定されているデフォルトをユーザーが変更することを可能にするか不可能にするかを指定します: trueまたはfalse

これらの属性が連動して、WebCenter Portalの「プリファレンス」ダイアログにある「サブスクリプション」パネルの「一般サブスクリプション」タブの初期状態が決まります(図19-1)。

図19-1 「サブスクリプション」ページの「一般サブスクリプション」タブ

表19-1に、管理者レベルのカスタム・サブスクリプション設定が「一般サブスクリプション」タブの表示に及ぼす効果を示します。

表19-1 管理者のデフォルトがサブスクリプション・プリファレンスに及ぼす効果

subscription-enabled脚注1 1

end-user-configurable

プリファレンス内のオプション

True

True

通常のレンダリング、チェック・ボックスが選択された状態

True

False

灰色表示、チェック・ボックスが選択された状態

False

True

通常のレンダリング、チェック・ボックスが選択されていない状態

False

False

非表示、チェック・ボックスが非表示の状態。

脚注1 subscription-enabled属性は、サブスクリプション機能全体を有効化または無効化するのではなく、単にプリファレンス・オプションの初期状態を設定します。たとえば、subscription-enabled="true"の場合は、WebCenter Portalの「プリファレンス」の関連付けられたサブスクリプション・オプションがデフォルトで選択されます。subscription-enabled="false"の場合、関連付けられたサブスクリプション・オプションはデフォルトで選択されません。

ヒント:
表19-1で、ほとんどの通知に最も一般的なシナリオは3行目です。

表19-2に、アプリケーションレベルの通知をトリガーできるアクションのタイプと、対応するサービスIDを示します。

表19-2 通知をトリガーできるアプリケーションレベルのアクティビティ

アクティビティ

対応するサービスID

他のユーザーがあなたにコネクションへの招待を送信した

oracle.webcenter.peopleconnections.connections

ポータルのロールが変更された(例: 参加者→モデレータ)

oracle.webcenter.community

ポータルのメンバーとして追加された

oracle.webcenter.community

ポータル・メンバーシップが削除された

oracle.webcenter.community

他のユーザーがあなたのメッセージ・ボードにメッセージを投稿した

oracle.webcenter.peopleconnections.wall

他のユーザーのメッセージ・ボード上にあるあなたの投稿を、別のユーザーがお気に入り登録した

oracle.webcenter.peopleconnections.wall

他のユーザーのメッセージ・ボード上にあるあなたの投稿に対して、別のユーザーがコメントした

oracle.webcenter.peopleconnections.wall

他のユーザーがあなたにフィードバックを投稿した

oracle.webcenter.peopleconnections.kudos

19.2.2 サブスクリプションのデフォルトの設定

アプリケーションレベルのサブスクリプション・プリファレンスのデフォルトを設定する手順は次のとおりです。

1. /oracle/webcenter/notificationというパスを含むディレクトリに移動し、フォルダcustomを作成します。

ヒント:
このディレクトリ構造は、パスに/oracle/webcenter/notification/customが含まれてさえいれば、任意のディレクトリで開始または終了できます。

2. customフォルダ、つまり/oracle/webcenter/notification/custom/の下の任意のサブディレクトリにファイルnotification-service-settings.xmlを作成します。

3. このXMLファイルに、アプリケーションレベルのすべてのサブスクリプション・オプションの値を入力します。
例19-1に、アプリケーション全体のサブスクリプション・プリファレンス設定ファイルの内容のサンプルと、必要な各オプションの例を示します。

例19-1 サブスクリプション設定XMLファイルの例

<notification-service_settings xmlns="http://xmlns.oracle.com/webcenter/notification">
<subscription-settings>
<service id="oracle.webcenter.peopleconnections.connections" subscription-enabled="true"
end-user-configurable="false"/>
<service id="oracle.webcenter.peopleconnections.wall" subscription-enabled="false"
end-user-configurable="true"/>
<service id="oracle.webcenter.peopleconnections.kudos" subscription-enabled="false"
end-user-configurable="true"/>
<service id="oracle.webcenter.community" subscription-enabled="true"
end-user-configurable="true"/>
</subscription-settings>
</notification-service_settings>

注意:
オプションを指定しないと、デフォルト値のfalse/falseがサービスに割り当てられます。

4. WLSTコマンドのimportMetadata()を実行して、ディレクトリの中身をメタデータ・ストアにインポートします。

関連項目:
WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。 importMetadata()コマンド(および他のWLSTコマンド)の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のimportMetadataに関する項を参照してください。

例:

wls: /wc_domain/serverConfig> importMetadata(application='webcenter',
server='serverName', fromLocation='directoryPath', docs='/**')

ここで:

- applicationは、WebCenter Portalのデプロイメントを識別する名前です。

- serverName: WebCenter Portalが実行されているサーバーの名前です。

- directoryPathは、oracle/webcenter/notification/custom/<この後ろに任意のサブディレクトリ>/notification-service-settings.xmlの上位にあるディレクトリ・パスです。
たとえば、notification-service-settings.xmlへのディレクトリ・パスが/scratch/mydir/oracle/webcenter/notification/customの場合、/scratch/mydirをdirectoryPathに入力します。

- docsは、インポートする対象を指定します。この例では、directoryPath以下のすべてのパスとファイルを指定しています。

表19-3に、サービスID oracle.webcenter.peopleconnections.connectionsに対する様々な設定の組合せの効果を示します。

表19-3 コネクションのサブスクリプション構成の効果

subscription-enabled

end-user-configurable

効果

true

true

- サブスクライブしているユーザーに他のユーザーがコネクションへの招待を送信した場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できます。

true

false

- サブスクライブしているユーザーに他のユーザーがコネクションへの招待を送信した場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルトを変更できません。脚注1 1

false

true

- サブスクライブしているユーザーに他のユーザーがコネクションへの招待を送信した場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- ユーザーはこのデフォルト設定を変更できます。

false

false

- サブスクライブしているユーザーに他のユーザーがコネクションへの招待を送信した場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- このデフォルト設定を変更するオプションは非表示になっています。

脚注1 これは出荷時のデフォルトです。

表19-4に、サービスID oracle.webcenter.peopleconnections.wallに対する様々な設定の組合せの効果を示します。

表19-4 メッセージ・ボードのサブスクリプション構成の効果

subscription-enabled

end-user-configurable

効果

true

true

- 他のユーザーがサブスクライブしているユーザーのメッセージ・ボードにメッセージを投稿、メッセージ・ボード上の投稿をお気に入り登録、またはメッセージ・ボード上の投稿にコメントした場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できます。

true

false

- 他のユーザーがサブスクライブしているユーザーのメッセージ・ボードにメッセージを投稿、メッセージ・ボード上の投稿をお気に入り登録、またはメッセージ・ボード上の投稿にコメントした場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できません。

false

true

- 他のユーザーがサブスクライブしているユーザーのメッセージ・ボードにメッセージを投稿、メッセージ・ボード上の投稿をお気に入り登録、またはメッセージ・ボード上の投稿にコメントした場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- ユーザーはこのデフォルト設定を変更できます。

false

false

- 他のユーザーがサブスクライブしているユーザーのメッセージ・ボードにメッセージを投稿、メッセージ・ボード上の投稿をお気に入り登録、またはメッセージ・ボード上の投稿にコメントした場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- このデフォルト設定を変更するオプションは非表示になっています。

表19-5に、サービスID oracle.webcenter.peopleconnections.kudosに対する様々な設定の組合せの効果を示します。

表19-5 フィードバックのサブスクリプション構成の効果

subscription-enabled

end-user-configurable

効果

true

true

- 他のユーザーがサブスクライブしているユーザーに対するフィードバックを残した場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できます。

true

false

- 他のユーザーがサブスクライブしているユーザーに対するフィードバックを残した場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できません。

false

true

- 他のユーザーがサブスクライブしているユーザーに対するフィードバックを残した場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- ユーザーはこのデフォルト設定を変更できます。

false

false

- 他のユーザーがサブスクライブしているユーザーに対するフィードバックを残した場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- このデフォルト設定を変更するオプションは非表示になっています。

表19-6に、サービスID oracle.webcenter.communityに対する様々な設定の組合せの効果を示します。

表19-6 ポータル管理のサブスクリプション構成の効果

subscription-enabled

end-user-configurable

効果

true

true

- ユーザーのポータル・メンバーシップ・ロールが変更された場合、ユーザーがポータルのメンバーとして追加された場合、またはユーザーがポータルのメンバーから削除された場合にサブスクライブしているユーザーは、通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できます。

true

false

- ユーザーのポータル・メンバーシップ・ロールが変更された場合、ユーザーがポータルのメンバーとして追加された場合、またはユーザーがポータルのメンバーから削除された場合にサブスクライブしているユーザーは、通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できません。

false

true

- ユーザーのポータル・メンバーシップ・ロールが変更された場合、ユーザーがポータルのメンバーとして追加された場合、またはユーザーがポータルのメンバーから削除された場合にサブスクライブしているユーザーは、通知メッセージを受信しません。

- ユーザーはこのデフォルト設定を変更できます。

false

false

- ユーザーのポータル・メンバーシップ・ロールが変更された場合、ユーザーがポータルのメンバーとして追加された場合、またはユーザーがポータルのメンバーから削除された場合にサブスクライブしているユーザーは、通知メッセージを受信しません。

- このデフォルト設定を変更するオプションは非表示になっています。

19.2.3 WebCenter Portalでのサブスクリプション・プリファレンスの設定

各ユーザーは、WebCenter Portalの「プリファレンス」で、各自のサブスクリプション・プリファレンスを設定します。この目的のために、次の2つの「プリファレンス」ページが用意されています。

- サブスクリプション: 自分のポータル・メンバーシップやピープル・コネクション・サービス(コネクション、メッセージ・ボードおよびフィードバック)で発生するアクションについて通知を受けるためにサブスクライブしたり、アプリケーションレベルやオブジェクトレベルの自分のサブスクリプションを表示および削除できます。
詳細は、『Oracle WebCenter Portalの使用』の「アプリケーション、ポータルおよびオブジェクトへのサブスクライブ」の章を参照してください。

- メッセージング: 優先するメッセージング・チャネルおよびフィルタを構成するための各コントロールにアクセスできます(BPEL接続タイプのみ)。
詳細は、『Oracle WebCenter Portalの使用』のメッセージング・チャネルおよびフィルタの設定と管理に関する項を参照してください。

19.3 通知の設定

この項では、メッセージング接続タイプの概要を示すとともに、通知チャネルを定義する前に満たしておく必要がある前提条件、および通知で使用する通知チャネルを設定する手順について説明します。次のサブセクションが含まれます:

- 第19.3.1項「接続チャネルについて」

- 第19.3.2項「通知の前提条件」

- 第19.3.3項「通知の構成ロードマップ」

- 第19.3.4項「Fusion Middleware Controlを使用した通知チャネルの指定」

- 第19.3.5項「WLSTを使用した通知チャネルの指定」

- 第19.3.6項「例: WLSTを使用したWebCenter Portalのメール通知の設定」

19.3.1 接続チャネルについて

通知の接続タイプによって、ユーザーがWebCenter Portalで各自の通知用のメッセージング・プリファレンスを構成するときに使用できるメッセージング・チャネルが決まります。

次の2つの接続タイプ候補のうち、いずれかを使用します。

- BPELサーバー: メール、ショート・メッセージ・サービス(SMS)およびワークリストの3つのメッセージング・チャネルを提供します。

- メール・サーバー: WebCenter Portal用に構成されたメール・サーバーのみを経由して通知メッセージを配信します。

BPELサーバー

BPELサーバーを選択する場合、ユーザー・メッセージング・サービス(UMS)が利用可能なBPELサーバーとの接続が確立されていることが前提となります。BPELサーバーとの接続の詳細は、第20章「ワークリストの管理」を参照してください。

WebCenter PortalでsetSpacesWorkFlowConnectionNameが設定されている場合、WebCenter Portalの「プリファレンス」の「メッセージング」パネルで、「構成の管理」ボタンが使用可能になります。

ヒント:
通知にBPELサーバーを使用する場合は、setSpacesWorkFlowConnectionNameで使用する接続と同じものを、通知でも使用してください。

メール・サーバー

メール・サーバーを選択する場合、メール・サーバーとの接続が確立されていることが前提となります。さらに、メール・サーバー接続と関連付けられている外部アプリケーションが共有資格証明を含んでいる必要があります。メール・サーバーとの接続の詳細は、第15章「メールの管理」を参照してください。

選択した接続タイプがメール・サーバーの場合、WebCenter Portalの「プリファレンス」の「メッセージング」パネルで「構成の管理」ボタンが灰色表示される場合とされない場合があります。これは、spacesWorkFlowConnectionを設定したかどうかによります。これとは関係なく、選択した接続タイプがメール・サーバーで、メッセージング・プリファレンスの「構成の管理」ボタンをクリックしてユーザー・メッセージング・プリファレンスを開いた場合、そこれ加えた変更はすべて無視されます。

関連項目:
『Oracle WebCenter Portalの使用』のメッセージング・チャネルおよびフィルタの設定と管理に関する項

19.3.2 通知の前提条件

通知の接続タイプを定義する前に、次の各項で説明する点を考慮し、指定の手順を実行する必要があります。

- 第19.3.2.1項「インストール」

- 第19.3.2.2項「構成」

- 第19.3.2.3項「セキュリティ」

- 第19.3.2.4項「制限事項」

19.3.2.1 インストール

通知に関連するインストールの要件は、通知メッセージングに選択する接続タイプによって異なります。

通知メッセージングにBPEL接続経由でユーザー・メッセージング・サービス(UMS)を使用する場合、デフォルトではメール・ドライバのみがインストールされていることに注意ください。SMSおよびワークリスト・メッセージング・チャネルを使用するには、これらに対応するドライバもインストールする必要があります。UMS用のSMSドライバおよびワークリスト・ドライバのインストールの詳細は、『Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』の「Oracle User Messaging Serviceの構成」の章を参照してください。

通知メッセージングにメール・サービスを使用する場合、通知に固有のインストールは必要ありませんが、第15章「メールの管理」の説明に従ってメール・サービスを構成する必要があります。

19.3.2.2 構成

通知の構成に関連する前提条件も、通知メッセージングに選択する接続タイプによって異なります。

BPELサーバー

ユーザーにメッセージング・チャネルのオプション(メール、SMSおよびワークリスト)を用意する場合は、BPELサーバーとの接続が確立されている必要があります。通知では、ユーザー・メッセージング・サービス(UMS)によるマルチチャネル通知をサポートするためにSOAインストールが使用されます。UMSは、SOAドメインの一部としてインストールされます。初期設定では、メール・ドライバのみが構成されています。SMSドライバも使用可能ですが、デプロイする必要があります。ワークリスト・チャネルを使用するには、SOAドメインをワークリスト・ドライバ拡張テンプレートによって拡張する必要があります。

詳細は、第20章「ワークリストの管理」および『Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』の「Oracle User Messaging Serviceの構成」の章を参照してください。

メール・サーバー

ユーザーが常にメールでのみ通知を受けるようにする場合、メール・サーバーとの接続が確立されている必要があります。さらに、メール・サーバー接続と関連付けられている外部アプリケーションが共有資格証明を含んでいる必要があります。詳細は、第15章「メールの管理」を参照してください。

メール通知は、各ユーザーのプロファイルで指定された優先言語で送信されます。ユーザーの優先言語が指定されていない場合は、サーバーのロケール設定がメール通知に使用されます。たとえば、サーバーが韓国ロケールで実行されており、ユーザーの優先言語が設定されていない場合、通知メールの言語は韓国語になります。

優先言語の設定の詳細は、『Oracle WebCenter Portalの使用』の優先表示言語の設定に関する項を参照してください。

19.3.2.3 セキュリティ

特に通知に関連するセキュリティの考慮事項はありません。

19.3.2.4 制限事項

アクティビティによっては、将来送信される通知タスクを作成するものがあります。たとえば、ユーザーが将来の有効日を指定したお知らせを作成すると、このお知らせが有効になったときに通知が送信されるように、WebCenter Portalアプリケーション・サーバーで通知タスクが作成されます。ただし、通知にメール・サービスを使用する場合、WebCenter Portalアプリケーション・サーバーが再起動されたときに、将来の通知タスクは削除されてしまいます。

UMSは、音声やインスタント・メッセージなど、通知ではサポートされていない複数のメッセージング・チャネルをサポートしています。通知では、UMSからメール、SMSおよびワークリストのみを使用します。

19.3.3 通知の構成ロードマップ

図19-2と表19-7に、WebCenter Portalアプリケーションで通知サービスを動作させるための前提条件と必要な作業の概要を示します。

図19-2 通知サービスの構成

表19-7 通知の構成

担当者

タスク

サブタスク

ノート

管理者

1. 通知のバックエンド・コンポーネントを設定します。

- BPELサーバーの設定

- メール・サーバーの設定

管理者

2. (メール・サーバーの場合のみ)外部アプリケーションを構成します。

- メール・サーバーへの外部アプリケーションの接続を作成します

- メール・サーバーの外部アプリケーションの共有資格証明を構成します

管理者

3. WebCenter Portalアプリケーションと選択したバックエンド・コンポーネント間の接続を作成または変更します。

- BPELサーバーとの接続を作成します

- メール・サーバーとの接続を作成します

管理者

4. 次のいずれかのツールを使用して、通知に使用する接続のタイプ(BPELまたはメール)を選択します。

- Fusion Middleware Control

- WLST

管理者

5. アプリケーションがデプロイされている管理対象サーバーを再起動します。

WebCenter Portalの場合は、WC_Spacesを再起動します。Portal Frameworkアプリケーションの場合は、アプリケーションがデプロイされているカスタム管理対象サーバーを再起動します。

管理者

6. すべてのユーザーに対するデフォルトのサブスクリプション・プリファレンスを設定します。

アプリケーション・スペシャリスト/エンド・ユーザー(WebCenter Portal)または開発者(Frameworkアプリケーション)

7. アプリケーション内で通知を構成してテストします。

- WebCenter Portal (アプリケーション・スペシャリスト)/(エンド・ユーザー)

- Frameworkアプリケーション

19.3.4 Fusion Middleware Controlを使用した通知チャネルの指定

Fusion Middleware Controlで通知メッセージの接続タイプを指定するには:

1. Oracle Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。
詳細は、第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「設定」→「アプリケーション構成」を選択します。

3. 「アプリケーション構成」ページで、下へスクロールしてページ下部の「通知」に移動し、アウトバウンド通知に使用する接続タイプとして「BPELサーバー」または「メール・サーバー」のいずれかを選択します。

4. 次の手順は、選択した接続タイプによって異なります。
「BPELサーバー」を選択した場合:

1. 「接続名」のリストから、その接続を設定するときに指定したBPELサーバーの名前を選択します。

2. 「送信者のメール・アドレス」フィールドに、すべての通知メッセージの送信元とするメール・アドレスを入力します。送信者のメール・アドレスは、対応するドメインからメッセージを送信するように構成されているドライバの少なくとも1つに一致する必要があります。

3. 「送信者のSMSアドレス」フィールドに、ユーザー・メッセージング・サービス(UMS)ですべての通信メッセージの送信元のドライバとして使用される4桁から6桁の数値を入力します。送信者のSMSアドレスは、対応するドメインからメッセージを送信するように構成されているドライバの少なくとも1つに一致する必要があります。

「メール・サーバー」を選択した場合は、「接続名」のリストからメール接続を選択します。

5. 変更を保存します。

6. 構成の変更を有効にするために、WebCenter Portalがデプロイされている管理対象サーバーを再起動します。

19.3.5 WLSTを使用した通知チャネルの指定

WLSTコマンドのsetNotificationsConfigを使用して、通知で使用する接続タイプを構成します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetNotificationsConfigに関する項を参照してください。同ガイドのgetNotificationsConfigに関する項も参照してください。

関連項目:
WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
この構成の更新は、MDSリポジトリに格納されます。構成の変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

19.3.6 例: WLSTを使用したWebCenter Portalのメール通知の設定

この項では、WLSTコマンドを使用したWebCenter Portalのメール通知を、WLSTを使用して設定する例を示します。

この例では、まず、共有資格証明で構成される外部アプリケーションの作成方法と、外部アプリケーションを使用するメール・サーバー接続の作成方法を示します。次に、そのメール接続で通知を送信するようにWebCenter Portalを構成する方法を示し、最後にユーザー・プリファレンスを使用してサブスクリプション・オプションを設定する方法を示します。

1. WLSTコマンド・プロンプトで、WebCenter Portalの管理サーバーに接続します。

connect('admin_user','mypassword','<servername>:7001')

2. 外部アプリケーション接続を作成します。

createExtAppConnection(appName='webcenter', name='NotificationSharedApp', displayName= 'NotificationSharedApp')

このコマンドにより、NotificationSharedAppという名前の接続が作成されます。

詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のcreateExtAppConnectionに関する項を参照してください。

3. 外部アプリケーションNotificationSharedAppの共有資格証明を構成します。

addExtAppCredential(appName='webcenter', name='NotificationSharedApp',
type='SHARED', username='john.doe@example.com', password='sharedpassword')

usernameは、電子メール通知の送信元とする電子メール・アカウントです。これは、<user>@<domain of the mail server>という形式で指定する必要があります。

オプションとして、メール通知の送信時に使用される次のフィールドを追加できます。

addExtAppField(appName='webcenter',name='NotificationSharedApp',fieldName='Email Address',fieldValue='sender's_email_address',displayToUser=false)
addExtAppField(appName='webcenter',name='NotificationSharedApp',fieldName='Your Name',fieldValue='sender's_display_name',displayToUser=false)

詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のaddExtAppCredentialに関する項を参照してください。

4. メール接続を作成します。

createMailConnection(appName='webcenter',name='NotificationSharedConn',
imapHost='<mailserver>',imapPort=143,
smtpHost='<mailserver>',smtpPort=25,
imapSecured=false,smtpSecured=false,
appId='NotificationSharedApp',default=1)

このコマンドにより、NotificationSharedConnという名前のメール接続が作成されます。

詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のcreateMailConnectionに関する項を参照してください。

5. メールを通知チャネルとして設定します。

setNotificationsConfig(appName='webcenter', type='MAIL',
name='NotificationSharedConn')

これにより、NotificationSharedConnが通知の送信に使用されるメール接続として設定されます。

詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のsetNotificationsConfigに関する項を参照してください。

6. 変更を有効にするために、WebCenter Portalがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動します。

7. WebCenter Portalにログインし、「プロファイル」ページの「情報」タブに移動して、自分の電子メール・アドレスが「電子メール」フィールドに設定されていることを確認します。これは、通知が目的の電子メール・アドレスに送信されるようにするためです。
電子メール・アドレスが設定されていない場合は、「編集」をクリックし、「電子メール」フィールドに自分の電子メール・アドレスを指定したら、「保存」をクリックします。

8. 通知を受けるアクティビティをサブスクライブします。たとえば、「プリファレンス」ページに移動し、「サブスクリプション」をクリックして、「ポータル管理」を選択すると、メンバーシップやロールの変更に関する通知を受信できます。

9. サブスクライブしたアクティビティを実行して構成をテストします。たとえば、自分のロールをモデレータから参加者に変更して通知をトリガーします。

19.4 カスタム通知テンプレートの作成および適用

ユーザーがワークリストまたはメールで受け取る通知には、コンテンツおよびコンテンツ表示用のデフォルトの書式があります。アプリケーション管理者は、デフォルトのかわりにカスタム・テンプレートを作成して適用することで、通知メッセージに独自の書式を設定できます。

この項では、通知メッセージ用のカスタム・テンプレートの作成に関する詳細について説明します。次のサブセクションが含まれます:

- 第19.4.1項「デフォルト通知テンプレートの上書きについて」

- 第19.4.2項「デフォルト通知テンプレートの上書き」

19.4.1 デフォルト通知テンプレートの上書きについて

WLSTコマンドを使用してMDSにアクセスし、defaultTemplate.xmlファイル(および右から左に記述する言語の場合はdefaultTemplate_rtl.xmlファイル)を上書きすることで、サブスクリプション・ベースの通知メッセージのレイアウトとコンテンツをカスタマイズできます。

関連項目:
WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

表のCSSスタイル(label、value、background)やフッターのCSSスタイル(note)を編集して、これらのxmlファイルの独自のバージョンを作成できます。また、<payload>や<group-space-footer>などのタグを移動してレイアウトを変更できます。これらのタグの内容を変更するには、<html-format>内のCDATAセクションを編集します。

<text-format/>タグは必須で、常に空であることが必要です。<custom>タグを使用すると、コンテンツを追加できます。<html-format>で囲まれたCDATA内に新しいHTMLコンテンツを追加し、<text-format/>は空のままにします。

例19-2と例19-3に、通知メッセージ・テンプレート・ファイルのデフォルトの内容を示します。これらを使用してカスタム・ファイルを作成できます。

注意:
これらのファイルのデフォルトの内容はよく似ています。違いは<style>タグ内にあり、そこで右揃えか左揃えかが指定されています。

例19-2 デフォルト・ファイルdefaultTemplate.xml

<?xml version="1.0"?>
<notification-template xmlns="http://xmlns.oracle.com/webcenter/notification">
<!-- The CSS Style of the Notification -->
<style>
<text-format/>
<html-format>
<![CDATA[
<style type="text/css">
.title  {font-size:1.2em; font-weight:bold;
white-space:nowrap;}
.label  {text-align:right; margin-left:30px;
padding-right:10px; white-space:nowrap;}
.value  {text-align:left; margin-right:20px;
padding-left:10px; white-space:nowrap;
width:100%;}
.note   {font-size:0.8em; color:#999999}
.background {background-color:#fcfcfc}
</style>
]]>
</html-format>
</style>

<!-- The Subject line of the Notification -->
<subject>
<message-key>NOTIFICATION_SUBJECT</message-key>
</subject>
<group-space-subject>
<message-key>GROUP_SPACE_SUBJECT_SUFFIX</message-key>
</group-space-subject>
<!-- Actual srvc-specific data. Provided/Overridden by srvc template -->
<payload>
<text-format/>
<html-format/>
</payload>

<!-- Any generic/common footer to appear after service-specific payload -->
<!-- Group Space footer - if applicable -->
<group-space-footer>
<text-format/>
<html-format>
<![CDATA[
<p>
<a href="<token>groupSpaceUrl</token>" target="_blank">
<message-key>GO_TO_SPACE</message-key>&nbsp;<token>
groupSpaceName</token>
</a>
</p>
]]>
</html-format>
</group-space-footer>

<!-- Unsubscribe footers -->
<unsubscribe-footer>
<text-format/>
<html-format>
<![CDATA[
<hr/>
<p class="note">
<token>unsubscribeMessage</token>
</p>
]]>
</html-format>
</unsubscribe-footer>
</notification-template>

例19-3 デフォルト・ファイルdefaultTemplate_rtl.xml

<?xml version="1.0"?>
<notification-template xmlns="http://xmlns.oracle.com/webcenter/notification">
<!-- The CSS Style of the Notification -->
<style>
<text-format/>
<html-format>
<![CDATA[
<style type="text/css">
.title  {font-size:1.2em; font-weight:bold;
white-space:nowrap;}
.label  {text-align:left; margin-right:30px;
padding-left:10px; white-space:nowrap;}
.value  {text-align:right; margin-left:20px;
padding-right:10px; white-space:nowrap;
width:100%;}
.note   {font-size:0.8em; color:#999999}
.background {background-color:#fcfcfc}
</style>
]]>
</html-format>
</style>

<!-- The Subject line of the Notification -->
<subject>
<message-key>NOTIFICATION_SUBJECT</message-key>
</subject>
<group-space-subject>
<message-key>GROUP_SPACE_SUBJECT_SUFFIX</message-key>
</group-space-subject>
<!-- Actual srvc-specific data. Provided/Overridden by srvc template -->
<payload>
<text-format/>
<html-format/>
</payload>

<!-- Any generic/common footer to appear after service-specific payload -->
<!-- Group Space footer - if applicable -->
<group-space-footer>
<text-format/>
<html-format>
<![CDATA[
<p>
<a href="<token>groupSpaceUrl</token>" target="_blank">
<message-key>GO_TO_SPACE</message-key>&nbsp;<token>
groupSpaceName</token>
</a>
</p>
]]>
</html-format>
</group-space-footer>

<!-- Unsubscribe footers -->
<unsubscribe-footer>
<text-format/>
<html-format>
<![CDATA[
<hr/>
<p class="note">
<token>unsubscribeMessage</token>
</p>
]]>
</html-format>
</unsubscribe-footer>
</notification-template>

19.4.2 デフォルト通知テンプレートの上書き

既存のXMLファイルを上書きして通知メッセージの書式をカスタマイズするには:

1. defaultTemplate.xml (または右から左へ記述する言語の場合はdefaultTemplate_rtl.xml)という名前のカスタムXMLファイルを作成します。

2. これらのデフォルト・ファイルの1つを編集したバージョンをカスタム・ファイルにコピーします。

関連項目:
例19-2と例19-3にデフォルト・ファイルの内容が示されています。

3. ネームスペースoracle/webcenter/notification/customを含む絶対パスにカスタム・ファイルを置いて元のファイルを上書きします。
例:

/tmp/repository/oracle/webcenter/notification/custom/template/defaultTemplate.xml

4. WLSTコマンドのimportMetadata()を実行して、カスタム・ファイルをWebCenter PortalのMDSリポジトリにアップロードします。
例:

importMetadata(application='webcenter', server='WC_Spaces',
fromLocation='template-file-location',
docs='/oracle/webcenter/notification/custom/template/defaultTemplate.xml')

template-file-locationは、完全修飾カスタム・ファイルが置かれているディレクトリを示します。完全修飾カスタム・ファイルは、通常、そのネームスペースに対応するディレクトリ構造に置かれています。たとえば、ファイルが次のネームスペースに作成されているとします。

/tmp/repository/oracle/webcenter/notification/custom/template/defaultTemplate.xml

この場合、fromLocationは/tmp/repositoryになります。残りのサブディレクトリは、XMLファイルのネームスペースで構成されています。ネームスペースには、/oracle/webcenter/notification/customというパスが少なくとも必要です。

関連項目:
importMetadata()コマンド(および他のWLSTコマンド)の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のimportMetadataに関する項を参照してください。

5. WebCenter Portalを再起動します。

19.5 通知接続のテスト

一般に、管理者が設定した時点で通知が有効かどうかは、基礎となるメール接続またはBPEL接続に依存します。これらの接続をテストして有効であれば、その延長として通知接続の要件も満たされます。

ヒント:
メール接続のテストの詳細は、第15.9項「メール・サーバー接続のテスト」を参照してください。

19.6 通知に関する問題のトラブルシューティング

問題

通知がまったく受信されません。

解決策

- 通知の送信者が構成されていないことをログが示している場合、使用する接続をサービスが検出できないことを意味します。

- 有効なBPEL接続またはメール接続を使用するように通知が構成されていることを確認してください。これは、WLSTコマンドのgetNotificationsConfig() (第19.3.5項「WLSTを使用した通知チャネルの指定」を参照)またはFusion Middleware Controlのユーザー・インタフェース(第19.3.4項「Fusion Middleware Controlを使用した通知チャネルの指定」を参照)を使用して検証できます。

問題

通知は正しく構成されていますが(BPELまたはメール)、それでも通知が受信されません。

解決策

通知は、有効なBPEL接続またはメール接続に依存しています。第15章「メールの管理」または第20章「ワークリストの管理」の説明に従って、それぞれの接続の検証とトラブルシューティング・シナリオを実行してください。

問題

メール接続またはBPEL接続は適切に設定されていますが、それでも通知が受信されません。

解決策

通知は、ユーザーのサブスクリプションに基づいて生成されます。あらかじめ構成されている、コネクションへの招待の通知を除き、それ以外の通知はユーザーが明示的にサブスクライブした場合にのみ生成されます。ユーザーが個人のプリファレンスか、アプリケーションレベルまたはオブジェクトレベルのサブスクリプションを使用して、サブスクリプションを作成していることを確認してください。詳細は、『Oracle WebCenter Portalの使用』の「アプリケーション、ポータルおよびオブジェクトへのサブスクライブ」の章を参照してください。

問題

ユーザーはサブスクリプションを設定していますが、それでも通知が受信されません。

解決策

- 通知では、構成に基づいて、通知の配信がBPEL/UMSまたはメール・サービスに委任されます。メール・サービスの場合は、ユーザーの電子メール・アドレスが構成されていることを確認してください。UMSの場合は、Fusion Middleware Controlで「ユーザー・メッセージング・サービス」の「メッセージ・ステータス」セクションを参照してください。ここには、UMSからの各発信メッセージのステータスが表示されます。詳細は、『Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』の「Oracle User Messaging Serviceのモニタリング」を参照してください。

- UMSの場合、この問題は、WebCenter Portal側の送信者の設定がUMS側の対応するドライバと一致しないか、対応するドライバを検出できないことを意味する可能性もあります。送信者のアドレス(ドメイン)をUMSがアウトバウンド・メッセージのドライバの少なくとも1つと照合できるようにしてください。

- メール・サービスの場合は、第19.3.1項「接続チャネルについて」の説明に従って、メール接続が共有接続をポイントしていることを確認してください。

問題

(UMS構成の場合)ユーザーが一部のチャネルからは通知を受信しますが、他のチャネルからは受信しません。

解決策

これは、ユーザーのメッセージング・チャネルおよびフィルタの構成に起因する可能性が高いと考えられます。詳細は、『Oracle WebCenter Portalの使用』のメッセージング・チャネルおよびフィルタの設定と管理に関する項を参照してください。

問題

(UMS構成の場合)メール・チャネルの通知のみが配信され、ワークリスト・チャネルは機能しません。

解決策

『Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』の「Oracle User Messaging Serviceの構成」の章の説明に従って、SOAドメインがワークリスト・ドライバ・テンプレートによって拡張されていることを確認してください。

20 ワークリストの管理

この章では、WebCenter PortalおよびPortal Frameworkアプリケーションで使用されるワークリストを構成および管理する方法について説明します。

WebCenter PortalおよびPortal Frameworkアプリケーションのバックエンド・サーバーを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後にWebCenter PortalおよびPortal Frameworkアプリケーションに加えた変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。第1.3.5項「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:
Fusion Middleware ControlまたはWLSTを使用して行ったワークリストの構成の変更は動的ではありません。変更を有効にするには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章には次のトピックが含まれます:

- 第20.1項「ワークリストの構成ロードマップ」

- 第20.2項「BPEL接続について」

- 第20.3項「BPELサーバーの前提条件」

- 第20.4項「ワークリスト接続の設定」

- 第20.5項「WebCenter PortalワークフローをホスティングするBPELサーバーの指定」

- 第20.6項「電子メールで送信するWebCenter Portalワークフロー通知の構成」

- 第20.7項「ワークリストに関する問題のトラブルシューティング」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

20.1 ワークリストの構成ロードマップ

この項では、ロードマップを構成プロセスにおけるシステム管理者のガイドとして使用します。

- 第20.1.1項「ロードマップ: WebCenter Portal用のワークリストの構成」

- 第20.1.2項「ロードマップ: Portal Frameworkアプリケーション用のワークリストの構成」

20.1.1 ロードマップ: WebCenter Portal用のワークリストの構成

この項の図20-1と表20-1は、WebCenter Portalでワークリストを使用するための前提条件と必要なタスクの概要を示しています。

図20-1 WebCenter Portal用のワークリストの構成

表20-1 WebCenter Portal用のワークリストの構成

担当者

タスク

サブタスク

管理者

1. WebCenter PortalとOracle SOA Suiteをインストールします

WebCenter PortalとBPELサーバーの間の接続を確認するには、次の手順を実行します。

1. Oracle SOA Suiteをインストールします

2. SOAサーバー・ドメインをoracle.wc_composite_template_11.1.1.jarテンプレートで拡張します

詳細は、WebCenter Portalワークフローのバックエンド要件に関する項を参照してください。

管理者

2. 次のいずれかのツールを使用してワークリスト接続を構成します脚注 1

- Fusion Middleware Control (「Fusion Middleware Controlを使用したワークリスト接続の登録」を参照)

- WLST (「WLSTを使用したワークリスト接続の登録」を参照)

Fusion Middleware Controlを使用する場合

- 2.a ワークリスト接続を作成します

- 2.b ワークリスト接続をアクティブにします

WLSTを使用する場合

- 2.a createBPELconnectionを実行します

- 2.b addWorklistConnectionを実行します

管理者

3. WebCenter Portalワークフローを構成します脚注 1

3.a 次のいずれかのツールを使用して、WebCenter Portalワークフロー用のBPELサーバー接続を指定します

- Fusion Middleware Control

- WLST (setSpacesWorkflowConnectionName)

3.b WS-securityのキーストアを構成します

- ポータルに参加するためのグループ招待を送信するのにWebCenter Portalワークフローを使用していない場合、非保護のSAML環境におけるワークリスト用のセキュリティ構成はオプションです。

- グループ・メンバーシップ招待では、ポータルに参加するためのグループ招待をユーザーが受け入れる際に、WebCenter Server上でセキュアなWebCenter Webサービスを起動するためにSOAサーバーが必要になります。

詳細は、第36章「WS-Securityの構成」を参照してください。

管理者

4. (オプション)追加のBPELワークフローをデプロイします

管理者

5. (オプション) WebCenter Portalと同じアイデンティティ・ストアを使用するようにBPELサーバーを構成します脚注参照 1

管理者

6. (オプション)BPELサーバーへの接続を保護します

6.a シングル・サインオンを構成します

6.b WS-Securityを構成します

6.c SSLを構成します

エンド・ユーザー

7. WebCenter Portalでワークリストが動作していることをテストします

7.a WebCenter Portalにログインします

7.b ワークリスト・タスク・フローをページに追加します(『Oracle WebCenter Portalでのポータルの構築』のページへのワークリスト・タスク・フローの追加に関する項を参照してください)。

7.c ワークリスト・イベントを生成します(『Oracle WebCenter Portalでのポータルの構築』のワークリストの概要に関する項を参照してください)。

7.d タスク・フローにイベント情報が表示されることを確認します

脚注 1 初期設定で自動構成済

関連項目:
ワークフローの電子メール通知の構成手順については、第20.6項「電子メールで送信するWebCenter Portalワークフロー通知の構成」を参照してください。

20.1.2 ロードマップ: Portal Frameworkアプリケーション用のワークリストの構成

この項の図20-2と表20-2は、Portal Frameworkアプリケーションでワークリストを使用するための前提条件と必要なタスクの概要を示しています。

図20-2 Portal Frameworkアプリケーション用のワークリストの構成

図20-2 Portal Frameworkアプリケーション用のワークリストの構成

担当者

タスク

サブタスク

管理者

1. WebCenter PortalとOracle SOA Suiteをインストールします

開発者

2. ワークリストをPortal Frameworkアプリケーションに統合します

2.a ワークリスト接続を作成します

2.b JDeveloperでワークリスト・タスク・フローをページに追加します

開発者/管理者

3. 次のいずれかのツールを使用してPortal Frameworkアプリケーションをデプロイします

- JDeveloper (開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

- WLS管理コンソール(管理者)

管理者

4. 追加のBPELワークフローをデプロイします

管理者

5. (オプション): アプリケーションと同じアイデンティティ・ストアを使用するようにBPELサーバーを構成します

管理者

6. (オプション): BPELサーバーへの接続を保護します

6.a シングル・サインオンを構成します

6.b WS-Securityを構成します

6.c SSLを構成します

開発者/管理者

7. (オプション): 次のいずれかのツールを使用して接続パラメータを追加または変更します

- JDeveloper。その後、アプリケーションを再デプロイします(開発者)

- Fusion Middleware Control (管理者)

- WLST (管理者)

エンド・ユーザー

8. ワークリストが動作していることをテストします

8.a Portal Frameworkアプリケーションにログインします

8.b ワークリスト・イベントを生成します

8.c タスク・フローにイベント情報が表示されることを確認します

20.2 BPEL接続について

BPEL接続に関する操作を行うときには、次の点に留意してください。

- ワークリストでは、WebCenter Portalユーザーが様々なBPELサーバーからの割当てや通知をモニターおよび管理できるように、複数の接続を使用できます。詳細は、第20.4項「ワークリスト接続の設定」を参照してください。

- WebCenter Portalワークフローでは、Oracle SOA Suiteが含まれるBPELサーバーへの単一接続が必要になります。詳細は、第20.5項「WebCenter PortalワークフローをホスティングするBPELサーバーの指定」を参照してください。

- ワークリストとWebCenter Portalのワークフローは、同じBPELサーバー接続を共有することも、それぞれに個別のBPELサーバーに接続することもできます。現在のWebCenter Portalのワークリストに、ワークフローで作成されたワークリスト・アイテムを表示できるようにするために、WebCenter Portalワークフローとワークリストで接続を共有することをお薦めします。

- ワークリストは、複数のBPELサーバーからのワークリスト・アイテムを集約できるように、複数のBPEL接続にワイヤリングできます。たとえば、人事サーバーや総勘定元帳サーバーなど、様々なタイプのワークフローを実行する複数のBPELサーバーがトポロジに含まれている場合などです。

- BPEL接続は一意のURLである必要があります。そうでない場合は、同じサーバーに対して重複する問合せが作成されます。

20.3 BPELサーバーの前提条件

ワークリストのスムーズな動作を確実にするために、次の点に留意してください。

- ワークリスト・タスク・フローを含むページは、ADFセキュリティを使用して保護する必要があります。

- ワークリストは、BPELワークリスト・アプリケーションを介してアクセスできるOracle SOA SuiteのBPELサーバーを使用するように構成する必要があります。そのURLの形式は次のとおりです。

http://host:port/integration/worklistapp

ワークリストがOracle SOA SuiteのBPELサーバーと同じドメインで実行されていない場合は、アイデンティティ・ストア(LDAP)を共有するか(推奨)、同じユーザー名をアイデンティティ・ストアに含める必要があります。

- ワークリストの管理対象サーバーのクロックと、Oracle SOA Suite BPELの管理対象サーバーのクロックは、アサーションの新しさをチェックするSAML認証条件NotBeforeに違反しないように同期する必要があります。

- 構成に関連する例外の存在は許されません。WLSTコマンドlistWorklistConnectionsを使用して、構成した接続を表示して接続の詳細を検証してください。接続のリストを表示した後、/integration/worklistappで追加されたURLプロパティを使用してそれらの接続を検証します。http://host:port/integration/worklistappでBPELワークリスト・アプリケーションにアクセスできることを確認してください。

- Oracle SOA Suite BPELの管理対象サーバーがアイデンティティ・ストアを使用するように構成されていて、そのアイデンティティ・ストアにBPMWorkflowAdmin(デフォルトではweblogic)が含まれていない場合、第20.7.2.2項「共有ユーザー・ディレクトリにweblogicユーザーが含まれていない」の説明に従って、BPMWorkflowAdminユーザーを構成する必要があります。

- ワークリストの管理対象サーバーとOracle SOA SuiteのBPELサーバーの管理対象サーバーの両方で、wsm-pmアプリケーションが問題なく実行されている必要があります。これは、次のURLを使用して検証できます。

http://host:port/wsm-pm/validator

BPELサーバーの問題を解決する方法の詳細は、第20.7項「ワークリストに関する問題のトラブルシューティング」を参照してください。

この項には次のサブセクションが含まれます:

- 第20.3.1項「BPELサーバー: インストールと構成」

- 第20.3.2項「BPELサーバー: セキュリティに関する考慮事項」

- 第20.3.3項「BPELサーバー: WebCenter Portalでの制限事項」

20.3.1 BPELサーバー: インストールと構成

ワークリストは、Oracle SOA Suiteに含まれるOracle BPEL Process Manager (BPEL)サーバーに依存しています。

ワークリストを使用するには、Oracle SOA Suiteをインストールする必要があります。Oracle SOA Suiteをインストールする方法の詳細は、『Oracle SOA SuiteおよびOracle Business Process Management Suiteインストレーション・ガイド』を参照してください。

Oracle SOA Suiteのインストール後に、BPELサーバーへの接続を設定することで、WebCenter Portalにワークリストを統合できます。

20.3.2 BPELサーバー: セキュリティに関する考慮事項

ワークリストは、現在認証されているユーザーのタスクを表示するものです。ポータル・ユーザーがOracle SOA SuiteのBPELサーバー上でタスクを格納および取得するには、そのユーザーの名前が共有ユーザー・ディレクトリ(LDAP)に存在しているか、BPELサーバーとポータル・アプリケーション(WebCenter Portalまたは独自のPortal Frameworkアプリケーション)の両方で同様に設定されている必要があります。

たとえば、ユーザーrsmithがワークリストを使用してBPELサーバー上でタスクを格納および取得する場合、BPELサーバーとWebCenter Portalの両方にユーザーrsmithが存在している必要があります。

追加のログイン・プロンプトが表示されないようにWebCenter Portalのワークリスト・コンポーネントからBPELタスクの詳細にアクセスするには、WebCenter PortalサーバーとOracle SOA SuiteサーバーでOracle Single Sign-Onサーバーを共有するように構成する必要があります。詳細は、第33.2項「Oracle Access Manager (OAM)の構成」および第33.3項「Oracle Single Sign-On (OSSO)の構成」を参照してください。

セキュアな接続の場合は、オプションでSOAとWebCenter Portalの間のWS-Securityを構成できます。詳細は、第36章「WS-Securityの構成」を参照してください。

20.3.3 BPELサーバー: WebCenter Portalでの制限事項

ワークリスト・タスク・フローは、認証されたページ内でのみ機能します。ワークリスト・タスク・フローが非保護ページ(ユーザーがログインしたアプリケーションからの移動先ではないパブリック・ページ)にある場合、「ワークリスト・コンテンツを表示するにはログインする必要があります。」という警告メッセージが表示されます。これは、現在のユーザーのセッションで、どのユーザーのタスクが問合せの対象になるかを判断できるようにするためです。

20.4 ワークリスト接続の設定

この項には次のサブセクションが含まれます:

- 第20.4.1項「ワークリスト接続について」

- 第20.4.2項「ワークリスト接続の登録」

- 第20.4.3項「ワークリスト接続のアクティブ化」

- 第20.4.4項「ワークリスト接続の詳細の変更」

- 第20.4.5項「ワークリスト接続の削除」

20.4.1 ワークリスト接続について

ワークリストを使用すると、WebCenter Portalまたは独自のPortal Frameworkアプリケーションで、認証済ユーザーに対して、それらのユーザーに現在割り当てられているBPELワークリスト・アイテムのリストを表示できます。BPELワークリスト・アイテムは、1つ以上のBPELワークリスト・リポジトリからのオープンなBPELタスクです。

ワークリスト・アイテムを配信するBPELサーバーごとに1つずつ接続が必要です。WebCenter Portalユーザーが様々なBPELサーバーからの割当てや通知をモニターおよび管理できるように、複数のワークリスト接続を使用できます。

BPELサーバーに接続できない場合、その接続が使用不可能であることがワークリスト・タスク・フローによって示され、そのエラーの原因がサーバーの診断ログに記録されます。このログは、ワークリスト・コンポーネントのログ・ディレクトリをホストするサーバーにあります。例:

./user_projects/domains/base_domain/servers/WC_CustomPortal/logs/WC_CustomPortal-diagnostic.log。

Portal Frameworkアプリケーションの場合: ./user_projects/domains/base_domain/servers/WC_CustomPortal/logs/WC_CustomPortal-diagnostic.log。

これらは、ドメイン名がbase_domain (デフォルト)の場合の例ですが、ドメイン作成時に別の名前を定義できます。

WebCenter Portalで内部ワークフロー(メンバーシップ通知およびポータル・サブスクリプション・リクエスト)をサポートするには、BPELサーバー接続が必要です。詳細は、第20.5項「WebCenter PortalワークフローをホスティングするBPELサーバーの指定」を参照してください。

ワークリストは、SOAインスタンス接続を共有できます。そうすることで、各ユーザーのワークリスト・タスク・フローに、ポータル・アクティビティに関連するワークリスト・アイテムを表示できます。

20.4.2 ワークリスト接続の登録

この項には次のサブセクションが含まれます:

- 第20.4.2.1項「Fusion Middleware Controlを使用したワークリスト接続の登録」

- 第20.4.2.2項「WLSTを使用したワークリスト接続の登録」

20.4.2.1 Fusion Middleware Controlを使用したワークリスト接続の登録

ワークリスト接続を登録する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「ワークリスト」を選択します。

4. 新規の接続を登録するには、「追加」をクリックします(図20-3)。

図20-3 ワークリスト接続の構成

5. ワークリスト接続の一意の名前を入力し、アクティブな接続として設定します(表20-3)。この接続は、管理対象サーバーの再起動後に適用されます。

表20-3 ワークリスト接続: 名前

フィールド

説明

接続名

接続の一意の名前を入力します。この名前は、WebCenter Portalのすべての接続タイプにおいて一意である必要があります。

この名前は、WebCenter Portalでワークリスト機能を使用するユーザーに対して表示できます。ユーザーは、ソートおよびグループ化の様々なオプションを使用して、ワークリストの割当てを編成できます。「ワークリスト・サーバー別にグループ化」オプションを使用すると、ここで指定した名前が表示されます。このため、他のユーザーにわかりやすい意味のある名前(たとえばHuman Resources)を入力することが重要です。

アクティブな接続

選択すると、WebCenter Portalでこのワークリスト接続がアクティブになります。アクティブになった後は、関連付けられたBPELサーバーからのワークリスト・アイテムがユーザーのワークリストに表示されます。

WebCenter Portalユーザーが様々なBPELサーバーからの割当てや通知をモニターおよび管理できるように、複数のワークリスト接続を一度にアクティブにできます。なんらかの理由で接続を無効化する必要がある場合は、このオプションの選択を解除します。

(「編集」モードのみ。)チェック・ボックスは、他のコンポーネントがこの接続を共有するかどうかを示します。

- ワークリスト
この接続に関連付けられたアイテムをワークリストで表示するかどうかを指定します。

- Spacesアプリケーション
WebCenter Portalが内部ワークフロー(メンバーシップ通知やサブスクリプション・リクエストなど)に同じBPELサーバー接続を使用するかどうかを指定します。この機能を提供するBPELサーバーは、Oracle SOA Suiteに含まれるBPELサーバーです。詳細は、第20.5項「WebCenter PortalワークフローをホスティングするBPELサーバーの指定」を参照してください。

ここには示されていませんが、通知でBPELサーバー接続を使用するように設定することもできます。第19.3項「通知の設定」を参照してください。

接続プロパティを変更する前に、この接続を共有する他のコンポーネントへの影響を考慮してください。

6. BPELサーバーの接続の詳細を入力します(表20-4)。

表20-4 ワークリスト接続: 接続の詳細

フィールド

説明

BPEL SOAP URL

BPELサーバーへのアクセスに必要なURLを入力します。次の形式を使用します。

protocol://host:port

例: http://mybpelserver.com:8001

注意: WebCenter Portalは、Oracle SOA Suiteに含まれているBPELサーバーを使用して、WebCenter Portalワークフローを実装します。ワークフロー接続を設定する場合、SOA SuiteのBPELサーバーのURLをここに入力してください。詳細は、第20.5項「WebCenter PortalワークフローをホスティングするBPELサーバーの指定」を参照してください。

SAMLトークン・ポリシーURI

この接続で認証に使用するSAML (Security Assertion Markup Language)トークン・ポリシーを選択します。

SAMLは、認証および認可の権限を定義するセキュリティ・トークンを渡すためのXMLベース標準です。(レシーバとの信頼関係を持っている)証明エンティティは、送信者保証と呼ばれる方式によってサブジェクトの検証を保証します。選択可能なオプションは次のとおりです。

- SAMLトークン・クライアント・ポリシー(oracle/wss10_saml_token_client_policy): これを選択した場合、追加のセキュリティなしの基本構成が検証されます。これはデフォルト設定です。

- メッセージ保護付きSAMLトークン・クライアント・ポリシー(oracle/wss10_saml_token_with_message_protection_client_policy): これを選択すると、SAMLベースのBPEL Webサービスを使用してセキュリティが強化されます。選択した場合、WebCenter PortalとBPELアプリケーションの両方でキーストアを構成する必要があります。詳細は、第36章「WS-Securityの構成」を参照してください。

- グローバル・ポリシー・アタッチメント: このオプションは、使用する環境でグローバル・ポリシー・アタッチメントがサポートされている場合に選択します。

受信者キーの別名

メッセージ保護付きSAMLポリシーの認証に使用される受信者キーの別名です。これが必要なのは、BPELサーバー接続で認証のためにSAMLトークン・ポリシーが使用されていて、WebCenter Portalのワークリストで複数のBPELサーバー接続が使用されている場合のみです。

たとえば、myKeyなどになります。

複合トポロジの受信者キーの別名を調べるには、第36.3項「複合トポロジの場合のWS-Securityの構成」を参照してください。

リンクURL

BPELサーバーへのリンクに使用されるURLを指定します。指定する必要があるのは、たとえばSSOまたはHTTPSが構成されるときなど、BPEL SOAP URLと異なる場合のみです。

protocol://host:portという形式を使用します。

例: http://mySSO.host.com:7777

パフォーマンス上の理由で、HTTPSまたはSSO環境においては、「リンクURL」ではHTTPSまたはSSO Webサーバーを介したBPELワークリスト・アイテムへのユーザー・アクセスを指定します。一方、「BPEL SOAP URL」では、HTTPSまたはSSO Webサーバーを介したリダイレクトを伴わないBPEL Webサービスへの直接アクセスを指定します。

7. 「OK」をクリックして、この接続を保存します。

8. 「テスト」をクリックして、作成した接続が機能するかどうかを検証します。
正常な接続の場合、新しい(アクティブな)接続の使用を開始するにはWebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があることを通知するアドバイスが「テストのステータス」メッセージに表示されます。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

テストが失敗した場合、第20.7項「ワークリストに関する問題のトラブルシューティング」を参照してください。

ヒント:
新規に登録した接続をアクティブ化するには、第20.4.3項「ワークリスト接続のアクティブ化」に記載された手順を実行します。

20.4.2.2 WLSTを使用したワークリスト接続の登録

WLSTコマンドのcreateBPELConnectionを使用して、BPELサーバー接続を作成します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のcreateBPELConnectionに関する項を参照してください。

新しいBPELサーバー接続をアクティブに使用するようにワークリストを構成するには、いくつかの追加構成が必要です。詳細は、第20.4.3.2項「WLSTを使用したワークリスト接続のアクティブ化」を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
新規に登録した接続をアクティブ化するには、第20.4.3項「ワークリスト接続のアクティブ化」に記載された手順を実行します。
新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのコマンド行を使用した管理対象サーバーの起動および停止に関する項を参照してください。

20.4.3 ワークリスト接続のアクティブ化

WebCenter PortalおよびPortal Frameworkアプリケーションでは、一度に複数のワークリスト接続をアクティブにできます。複数の接続により、WebCenter Portalユーザーは複数のBPELサーバーからの割当てや通知をモニターおよび管理できます。ワークリストの問合せ先のSOAサーバーが現在メンテナンス中である場合、アクティブな接続を一時的に無効化して、エラーや警告がログに記録されたりユーザー・インタフェースに表示されないようにできます。

この項には次のサブセクションが含まれます:

- 第20.4.3.1項「Fusion Middleware Controlを使用したワークリスト接続のアクティブ化」

- 第20.4.3.2項「WLSTを使用したワークリスト接続のアクティブ化」

20.4.3.1 Fusion Middleware Controlを使用したワークリスト接続のアクティブ化

ワークリスト接続をアクティブ化または無効化するには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「ワークリスト」を選択します。
「ワークリスト接続の管理」表に、現在のアクティブな接続(ある場合)が示されます。

4. アクティブ化(または無効化)するワークリスト接続を選択し、「編集」をクリックします。

5. 「ワークリスト」チェック・ボックスを選択して、WebCenter Portalでこのワークリスト接続をアクティブ化します。
アクティブになった後は、関連付けられたBPELサーバーからのワークリスト・アイテムがワークリスト・タスク・フロー内に表示されます。なんらかの理由で接続を無効化する必要がある場合は、このオプションの選択を解除します。

6. 「OK」をクリックして、接続を更新します。

7. 「テスト」をクリックして、アクティブ化した接続が機能するかどうかを検証します。
接続が正常にアクティブ化されると、更新した接続の使用を開始するにはWebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があることを通知するアドバイスが「テストのステータス」メッセージに表示されます。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

20.4.3.2 WLSTを使用したワークリスト接続のアクティブ化

WLSTコマンドのaddWorklistConnectionを使用して、ワークリストの既存のBPEL接続をアクティブ化します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のaddWorklistConnectionに関する項を参照してください。

ワークリストにより使用されているBPEL接続を後から無効化するには、WLSTコマンドのremoveWorklistConnectionを実行します。接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。構文の詳細と例は、『WebLogic Scripting Toolコマンド・リファレンス』のremoveWorklistConnectionに関する項を参照してください。

現在どの接続がアクティブになっているかを調べるには、listWorklistConnectionsを使用します。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
アクティブな接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのコマンド行を使用した管理対象サーバーの起動および停止に関する項を参照してください。

20.4.4 ワークリスト接続の詳細の変更

この項には次のサブセクションが含まれます:

- 第20.4.4.1項「Fusion Middleware Controlを使用したワークリスト接続の詳細の変更」

- 第20.4.4.2項「WLSTを使用したワークリスト接続の詳細の変更」

20.4.4.1 Fusion Middleware Controlを使用したワークリスト接続の詳細の変更

ワークリスト接続の詳細を更新する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「ワークリスト」を選択します。

4. アクティブ化するワークリスト接続を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。
パラメータの詳細は、表20-4「ワークリスト接続: 接続の詳細」を参照してください。

6. 「OK」をクリックして、接続を更新します。

7. 「テスト」をクリックして、更新した接続が機能するかどうかを検証します。
接続が正常に更新されると、更新した接続の使用を開始するにはWebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があることを通知するアドバイスが「テストのステータス」メッセージに表示されます。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

20.4.4.2 WLSTを使用したワークリスト接続の詳細の変更

WLSTコマンドのsetBPELConnectionを使用して、既存のBPELサーバー接続の詳細を編集します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetBPELConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
更新された(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、管理者ガイドのコマンド行を使用した管理対象サーバーの起動および停止に関する項を参照してください。

20.4.5 ワークリスト接続の削除

複数のWebCenter Portalコンポーネント(ワークリスト、通知、およびワークフロー)が同じワークリスト接続を共有している場合があります。ワークリスト接続を削除する前に、Fusion Middleware Controlの「アプリケーション構成」ページ(「WebCenterポータル」→「設定」→「アプリケーション構成」)に移動して、その接続がワークフローや通知で使用されているかどうか確認してください。

この項には次のサブセクションが含まれます:

- 第20.4.5.1項「Fusion Middleware Controlを使用したワークリスト接続の削除」

- 第20.4.5.2項「WLSTを使用したワークリスト接続の削除」

20.4.5.1 Fusion Middleware Controlを使用したワークリスト接続の削除

ワークリスト接続を削除するには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「ワークリスト」を選択します。

4. 削除するワークリスト接続を選択し、「削除」をクリックします。

5. 確認のため、「はい」をクリックします。

6. この変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

20.4.5.2 WLSTを使用したワークリスト接続の削除

WLSTコマンドのdeleteConnectionを使用して、以前にワークリストに対して登録したBPEL接続を削除します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

WLSTコマンドのremoveWorklistConnectionを使用して、adf-config.xmlで構成されているBPELサーバーを削除します。ワークリストは指定された接続を使用しなくなりますが、BPELサーバー接続の詳細は将来利用できるようにconnections.xmlに保持されます。

connections.xmlからBPELサーバー接続を削除するには、WLSTコマンドのdeleteConnectionを使用します。

コマンドの構文と詳細な例は、『WebLogic Scripting Toolコマンド・リファレンス』のremoveWorklistConnectionに関する項およびdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

変更を適用するために、管理対象サーバーを再起動します。

20.5 WebCenter PortalワークフローをホスティングするBPELサーバーの指定

WebCenter Portalでは、内部ワークフロー(ポータル・メンバーシップの通知、ポータル・サブスクリプションの要求など)をホストするためにOracle SOAスイートに含まれているBPELサーバーが使用されます。WebCenter Portalアプリケーション内のワークフロー機能を有効化するには、BPELサーバーとの接続が必要です。

注意:
WebCenter Portalワークフローは、WebCenter Portalを使用するように構成されたSOA管理対象サーバーにデプロイする必要があります。『Oracle WebCenter Portalインストレーション・ガイド』の「WebCenter Portalワークフローのバックエンド要件」の章も参照してください。

WebCenter Portalワークフローとの接続を構成するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。
第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「設定」→「アプリケーション構成」を選択します。

図20-4 WebCenter PortalワークフローをデプロイするBPELサーバーの選択

3. 「接続名」ドロップダウン・リストから、必要な接続名を選択します。
選択可能な接続は、WebCenter Portalでワークリスト・サービスに対して現在構成されている接続です。

WebCenter PortalワークフローがデプロイされているSOAインスタンスを指す接続を選択していることを確認してください。その接続がリストにない場合は、作成する必要があります。接続を定義するには、第20.4項「ワークリスト接続の設定」を参照してください。

4. 「適用」をクリックします。

5. この変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。
第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

20.6 電子メールで送信するWebCenter Portalワークフロー通知の構成

WebCenter Portalには、SOAワークフローと統合されるヒューマン・ワークフロー(人間による操作が必要)があります。SOAサーバーは電子メールを構成し、通知をユーザーの受信箱に配信できます。ユーザーは通知を承認または却下できます。

この項では、電子メール通知を有効にし、メール・サーバー情報を構成することで、WebCenter Portalワークフロー通知を電子メールでユーザーに送信する方法について説明します。

1. Fusion Middleware Controlを使用して、SOAを更新し、電子メール通知を有効にします。図20-5に示すように、SOAサーバーの下で、「SOA管理」→「ワークフロー構成」を選択します。

図20-5 SOA管理: ワークフロー構成

2. 「通知モード」として「電子メール」を選択し、使用する電子メールの有効なアカウントを指定します(図20-6)。

図20-6 「電子メール」通知モードのプロパティ

3. 「「メッセージング・ドライバ」ページに移動」をクリックします(図20-6)。

4. ユーザー・メッセージング電子メール・ドライバの「ドライバの構成」アイコンを選択します(図20-7)。

図20-7 関連ドライバ

5. 電子メール・ドライバの構成ページで次の操作を行います。

- 「共通構成」の下で、「デフォルトの送信者アドレス」を入力します。「サポートされているプロトコル」と「MailAccessProtocol」にはIMAPと入力します(図20-8)。

図20-8 電子メール・ドライバの構成ページ

- 図20-9および図20-10のように、「ドライバ固有の構成」の下で、ホスト、ポート、SSL、受信ユーザー/パスワードなどの電子メール接続の詳細を入力します。

図20-9 ドライバ固有の構成

図20-10 ドライバ固有の構成(続き)

関連項目:
ドライバのプロパティとUMS構成の詳細は、『Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』の「Oracle User Messaging Serviceの構成」の章を参照してください。

6. 構成の更新を保存し、管理対象のSOAサーバーを再起動します。(WebCenter Portalの場合、構成または再起動は不要です。)
ユーザーがポータルに参加するように招待されると、「承認」または「却下」リンクを含む電子メールが送信されます。

(オプション) Fusion Middleware Controlからサンプルの電子メールを送信すると、構成が正しいことを確認できます。

7. コミュニティ・ワークフローから、「ヒューマン・ワークフロー」を選択します(図20-11)。

図20-11 ヒューマン・ワークフロー

「ヒューマン・ワークフロー・エンジン・ホーム」ページが表示されます(図20-12)。

8. 「通知管理」タブで、電子メール・アドレスを確認します。
「通知管理」タブには、正しくない電子メール・アドレスを表示し、通知を再送信するオプションがあります。

図20-12 ヒューマン・ワークフロー・エンジン・ホーム

9. 「テスト通知の送信」をクリックして、構成を検証します。

10. 「送信」をクリックします(図20-13)。

図20-13 テスト通知

テスト通知を送信した後、電子メールが受信されることを確認します。

注意:
ユーザーが電子メール経由の通知に対応できる電子メールを生成する4つのワークフローがあります。ポータル管理設定の「メンバー」ページでは、ユーザーを追加し、電子メール通知メッセージを編集できます。詳細は、『Oracle WebCenter Portalの管理』の「メンバーの管理とロールの割当て」の項を参照してください。

20.7 ワークリストに関する問題のトラブルシューティング

ワークリストは、いくつかのミドルウェア・コンポーネントに依存して、ログインしているユーザーに対してワークリスト・アイテムを表示するため、ワークリストの障害の原因として、いくつかの要因が考えられます。この項で説明する問題と解決法は、発生する可能性がある一般的な問題の一部に関するものです。

関連項目:
付録G「Oracle WebCenter Portalのトラブルシューティング」

この項には次のサブセクションが含まれます:

- 第20.7.1項「アプリケーションの構成の問題が原因でワークリストが使用できない」

- 第20.7.2項「サーバーの障害が原因でワークリストが使用できない」

- 第20.7.3項「電子メール通知が動作しない」

注意:
障害の原因を特定するには、構成したSOA BPELサーバーの管理対象サーバーとワークリスト・プロセスをホストしている管理対象サーバーのログ・ファイルを調べます。

20.7.1 アプリケーションの構成の問題が原因でワークリストが使用できない

この項で説明する問題は、ワークリストが使用できないことに関連しています。ワークリスト・タスク・フローによる「ワークリスト・サービスは使用できません」というメッセージに続けて、次の警告が表示されます。

BPELワークリスト接続が設定されていないか、既存の接続構成に問題があるかのいずれかです。このアプリケーションに対してBPELワークリスト接続が少なくとも1つ設定されていることと、未解決の'ConfigurationExceptions'例外がログに記録されていないことを確認してください。

この項には次のサブセクションが含まれます:

- 第20.7.1.1項「adf-config.xmlが存在しないBPEL接続を参照している」

- 第20.7.1.2項「adf-config.xmlにBPEL接続への参照が含まれていない」

- 第20.7.1.3項「「行がまだありません」というメッセージが表示される」

20.7.1.1 adf-config.xmlが存在しないBPEL接続を参照している

問題

adf-config.xmlファイルにリストされている接続が、アプリケーションのconnections.xmlファイルに存在していません。アプリケーションが実行されている管理対象サーバーの診断ログに次のようなエントリが存在します。

[2009-03-22T13:33:54.140+00:00] [DefaultServer] [WARNING] [WCS-32008] [oracle.webcenter.worklist.config][tid: [ACTIVE].ExecuteThread: '12' for queue: 'weblogic.kernel.Default (self-tuning)'] userId: user][ ecid: 0000I0iOmdTFk3FLN2o2ye19kTB0000V,0][APP: Worklist#V2.0 arg: Human Resources ''connection_name''という名前のBPEL接続がconnections.xmlファイルに存在しませんでした。このため、ワークリスト・サービスは必須のBPEL接続と対話できません。

解決策

ログに示されている名前のBPEL接続を作成するか、その接続を削除します。デプロイ後にワークリスト構成を更新する方法の詳細は、第20.4項「ワークリスト接続の設定」を参照してください。

開発中の場合は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のワークリストの統合に関する項を参照してください。

どの接続名が参照されているかを調べたり、ワークリストの構成を検証するには、WLSTコマンドのlistWorklistConnections(appName='myApp', verbose=true)を実行します。詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のlistWorklistConnectionsに関する項を参照してください。

20.7.1.2 adf-config.xmlにBPEL接続への参照が含まれていない

アプリケーションのadf-config.xmlにはワークリスト接続への参照がありませんが、connections.xmlファイルにはその接続があります。

問題

アプリケーションが実行されている管理対象サーバーの診断ログに、たとえば次のようなエントリが記録されています。

[2009-03-23T10:23:56.943+00:00] [DefaultServer] [WARNING] [WCS-32009] [oracle.webcenter.worklist.config] [tid: [ACTIVE].ExecuteThread: '21' for queue: 'weblogic.kernel.Default (self-tuning)'] [userId: user] [ecid: 0000I0mqx8Fk3FLN2o2ye19lqBV000008,0] [APP: Worklist#V2.0] ワークリスト・サービスには、connections.xml内のBPELConnectionにマップされるadf-config.xml内のConnectionName構成エントリがないため、ワークリスト・サービスはこのアプリケーション用には設定されませんでした。

解決策

ワークリストがワークリスト・アイテムの問合せを実行できるように、少なくとも1つのBPELサーバーへの接続を構成します。

デプロイ後に、WLSTまたはFusion Middleware Controlを使用したワークリスト接続を作成します。詳細は、第20.4.2項「ワークリスト接続の登録」を参照してください。デプロイ時に、Oracle JDeveloperを使用したワークリスト接続を作成します。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のワークリストの統合に関する項を参照してください。adf-config.xmlおよびconnections.xmlファイルを手動で変更しないでください。

20.7.1.3 「行がまだありません」というメッセージが表示される

問題

ワークリスト・タスク・フローで、「行がまだありません」というメッセージが表示され続けます。

解決策

この問題に対処するには、次のような解決法があります。

- ログインしているユーザーに対する「割当て済」のワークリスト・アイテムが存在しない場合
ログインしているユーザーにワークリスト・アイテムが割り当てられていて、それらのアイテムの状態が「割当て済」の場合、常にワークリスト・タスク・フローに表示されます。「行がまだありません」というメッセージは、ログインしているユーザーに対する割当て済ワークリスト・アイテムが存在しないことを示しています。これは問題ではなく、想定内の動作です。

このメッセージの情報が正しいことを確認するには、Oracle SOA SuiteのBPELワークリスト・アプリケーションを開いて、ワークリスト・アイテムが存在するかどうか調べます。BPELワークリスト・アプリケーションのURLは、http://host:port/integration/worklistappです。hostとportは、ワークリスト接続で使用されるものと同じです。

- ワークリスト・タスク・フローが存在しているADFページがADFで保護されていない場合
認証されたユーザーがOracle SOA SuiteのBPELサーバーへのアクセスをアプリケーション・セッションに関連付けられていないため、ワークリスト・タスク・フローがワークリスト・リポジトリに対する問合せを実行できません。そのページにADFセキュリティを適用してください。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のワークリストのセキュリティの設定に関する項を参照してください。

20.7.2 サーバーの障害が原因でワークリストが使用できない

ワークリスト接続が存在しているのにワークリスト・タスク・フローで「ワークリスト・サービスは使用できません」という警告が表示される場合、サーバーの障害が問題の原因になっている可能性があります。複数の接続がある場合、「これ以上のアイテムは現在はありません。」というメッセージが表示されます。これらの汎用警告メッセージは、ワークリストとOracle SOA Suite BPELリポジトリとのやり取りに問題がある場合に表示されます。

問題の根本原因を特定するには、障害が発生した時点の管理対象サーバーの診断ログを調べます。場合によっては、Oracle SOA SuiteのBPELプロセスが実行されている管理対象サーバーのログ・ファイルも調べる必要があります。通常は、ワークリスト・アプリケーションの管理対象サーバーの診断ログに、次のようなエントリが記録されています。

[2009-03-23T11:35:21.735+00:00] [DefaultServer] [ERROR] [WCS-32100] [oracle.webcenter.worklist.model] [tid: [ACTIVE].ExecuteThread: '0' for queue: 'weblogic.kernel.Default (self-tuning)'] [userId: user] [ecid: 0000I0n7GBZFk3FLN2o2ye19lrBX00000L,0] [APP: Worklist#V2.0] [arg: WebCenter Worklist] WebCenterワークリストは''WebCenter Worklist''という名前のBPELワークリスト接続を問合せましたが、WebCenterエグゼキュータ・エラーが発生しました。詳細は関連する例外を参照してください。WebCenterワークリストがアプリケーション・サーバーで稼働している場合は、wsm-pmアプリケーションが稼働しているかどうかを確認してください。

これは、WSセキュリティで使用されているwsm-pmアプリケーションに問題があることを示しています。例外に関連する他の原因が存在する可能性もあります。これらの問題が発生した場合は、WebCenter管理対象サーバーと構成済Oracle SOA Suite管理対象サーバーの両方で、ログに記録された例外を調べることをお薦めします。

この項には次のサブセクションが含まれます:

- 第20.7.2.1項「アイデンティティ・ストア内のユーザーが一致しない」

- 第20.7.2.2項「共有ユーザー・ディレクトリにweblogicユーザーが含まれていない」

- 第20.7.2.3項「wsm-pmアプリケーションの問題」

- 第20.7.2.4項「クロックの同期のずれが5分を超えている」

- 第20.7.2.5項「ワークリストがタイムアウトしたか無効になっている」

20.7.2.1 アイデンティティ・ストア内のユーザーが一致しない

ワークリスト・タスク・フローが実行されている管理対象サーバーで使用されているアイデンティティ・ストアとOracle SOA Suite BPELサーバーで使用されているアイデンティティ・ストアに不一致があります。

問題

ワークリストの管理対象サーバーのアイデンティティ・ストアに存在するユーザーがOracle SOA Suiteのアイデンティティ・ストアに存在しない場合、次のメッセージが表示されます。

ワークリストの管理対象サーバーの診断ログの内容

[2009-03-23T11:35:21.407+00:00] [DefaultServer] [ERROR] []
[oracle.webcenter.worklist.config] [tid: pool-1-daemon-thread-12] [userId: Luke]
[ecid: 0000I0n7GBZFk3FLN2o2ye19lrBX00000L,0:1:3] [APP: Worklist#V2.0] Error in
workflow service Web service operation invocation.[[
Error in workflow service Web service operation invocation. The error is .
Verify that the SOAP connection information for the server is correct.
ORABPEL-30044
Error in workflow service Web service operation invocation.
Error in workflow service Web service operation invocation. The error is .
Verify that the SOAP connection information for the server is correct.
at
oracle.bpel.services.workflow.query.client.TaskQueryServiceSOAPClient.convertSOAPF
aultException(TaskQueryServiceSOAPClient.java:242)
at
oracle.bpel.services.workflow.query.client.TaskQueryServiceSOAPClient.invoke(TaskQ
ueryServiceSOAPClient.java:203)
at
oracle.bpel.services.workflow.query.client.TaskQueryServiceSOAPClient.authenticate
(TaskQueryServiceSOAPClient.java:253)
at
oracle.bpel.services.workflow.query.client.AbstractDOMTaskQueryServiceClient.authe
nticate(AbstractDOMTaskQueryServiceClient.java:164)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at
sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
at
sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:597)
at oracle.webcenter.concurrent.MethodTask.call(MethodTask.java:34)
at oracle.webcenter.concurrent.Submission$2.run(Submission.java:492)
at java.security.AccessController.doPrivileged(Native Method)
at oracle.security.jps.util.JpsSubject.doAsPrivileged(JpsSubject.java:313)
at oracle.webcenter.concurrent.Submission.runAsPrivileged(Submission.java:499)
at oracle.webcenter.concurrent.Submission.run(Submission.java:433)
at
oracle.webcenter.concurrent.Submission$SubmissionFutureTask.run(Submission.java:779)
at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:441)
at java.util.concurrent.FutureTask$Sync.innerRun(FutureTask.java:303)
at java.util.concurrent.FutureTask.run(FutureTask.java:138)
at
oracle.webcenter.concurrent.ModifiedThreadPoolExecutor$Worker.runTask(ModifiedThre
adPoolExecutor.java:657)
at
oracle.webcenter.concurrent.ModifiedThreadPoolExecutor$Worker.run(ModifiedThreadPo
olExecutor.java:682)
at java.lang.Thread.run(Thread.java:619)
]]
[2009-03-23T11:35:21.735+00:00] [DefaultServer] [NOTIFICATION] []
[oracle.webcenter.worklist.config] [tid: pool-1-daemon-thread-15] [userId: Luke]
[ecid: 0000I0n7GBZFk3FLN2o2ye19lrBX00000L,0:1:6] [APP: Worklist#V2.0]
TaskServiceSOAPClient: soapFault:[[
<env:Fault
xmlns:ns0="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-sece
xt-1.0.xsd"xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<faultcode>ns0:FailedAuthentication</faultcode>
<faultstring>FailedAuthentication : The security token cannot be authenticated
or authorized.</faultstring>
<faultactor/>
</env:Fault>
]]

Oracle SOA Suiteの管理対象サーバーの診断ログの内容

[2009-03-23T04:52:07.909-07:00] [soa_server1] [ERROR] [WSM-00008] [oracle.wsm.resources.security] [tid: [ACTIVE].ExecuteThread: '2' for queue: 'weblogic.kernel.Default (self-tuning)'] [userId: <anonymous>] [ecid: 0000I0nB64fFk3FLN2o2ye19lrBX00000O,0:1:3:1] [WEBSERVICE_PORT.name: TaskQueryServicePortSAML] [APP: soa-infra] [J2EE_MODULE.name: /integration/services/TaskQueryService] [WEBSERVICE.name: TaskQueryService] [J2EE_APP.name: soa-infra] Webサービス認証に失敗しました。

解決策

両方の管理対象サーバーのアイデンティティ・ストアに同じユーザーが存在している必要があります。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のワークリストのセキュリティの設定に関する項を参照してください。

これは、共通のLDAPアイデンティティ・ストアによって簡単に実現できます。ワークリストを利用できないユーザーIDを使用してOracle SOA SuiteのBPELワークリスト・アプリケーションにログインできるかどうかを調べると、問題を確認できます。つまり、http://host:port/integration/worklistappにある統合ワークリスト・アプリケーションへのアクセスを試みてください。hostとportは、タスク・フロー・アプリケーションのワークリスト接続で使用されるものと同じです。

20.7.2.2 共有ユーザー・ディレクトリにweblogicユーザーが含まれていない

問題

共有ユーザー・ディレクトリにweblogicユーザーが含まれていないため、ワークリストから受信したリクエストをBPEL Webサービスが処理できません。

解決策

「アイデンティティ・ストア内のユーザーが一致しない」に記載されている解決法をまず試してください。それでも問題が解決しない場合、この項で説明する解決法を試してください。

Oracle SOA Suiteが共有ユーザー・ディレクトリ(LDAP)に接続されていて、ユーザーweblogicがアイデンティティ・ストアに存在しない場合、次の手順でアイデンティティ・ストアの有効なユーザーにBPMWorkflowAdminロールを割り当てます。WLSTを使用してSOAAdminからアプリケーション・ロールを呼び出し、それを外部アイデンティティ・ストアのメンバーに付与します。それには、SOA_ORACLE_HOMEから次のWLSTコマンドを実行します。例:

cd SOA_ORACLE_HOME/common/bin/
wlst.sh
connect('weblogic','weblogic', '## soa host ##:## soa administration port ##')
revokeAppRole(appStripe="soa-infra", appRoleName="BPMWorkflowAdmin",
principalClass="oracle.security.jps.service.policystore.ApplicationRole", principalName="SOAAdmin")
grantAppRole(appStripe="soa-infra", appRoleName="BPMWorkflowAdmin",
principalClass="weblogic.security.principal.WLSUserImpl", principalName="user")

この例では、LDAPアイデンティティ・ストアにuserという名前のユーザーが存在します。BPMWorkflowAdminロールを付与する対象ユーザーがLDAPアイデンティティ・ストアに存在しない場合、この変更を有効にするためにOracle SOA Suiteの管理対象サーバーを再起動する必要があります。

20.7.2.3 wsm-pmアプリケーションの問題

問題

ワークリストの管理対象サーバーまたはOracle SOA Suiteの管理対象サーバー(あるいはその両方)で、wsm-pmアプリケーションに問題があります。

解決策

wsm-pmアプリケーションは、ワークリストでのSAML認証を制御するWebサービス・セキュリティ・ポリシーを管理します。wsm-pmアプリケーションを検証するには、管理権限を持つユーザーとしてwsm-pmアプリケーションの検証ページにログインします。検証に使用する書式は、http://host:port/wsm-pm/validatorです。このアプリケーションに問題がない場合、アクセス可能なポリシーが表示されます。ポリシーが表示されない場合、wsm-pmアプリケーションに障害が起きるサーバーでログに記録された関連情報を調べてください。

20.7.2.4 クロックの同期のずれが5分を超えている

セキュリティ上の理由により、ワークリストの管理対象サーバーとOracle SOA Suite BPELの管理対象サーバーとの間でのWebサービス・セキュリティ相互作用は、5分未満の時間差で実行される必要があります。つまり、両方のホスト・マシンのクロックの時間差は5分未満である必要があり、時間差がそれ以上になると認証が失敗します。SAMLアサーションでは、これを検証するためにNotBefore条件が使用されます。

問題

ワークリストの管理対象サーバーとOracle SOA Suite BPELの管理対象サーバーのクロック同期のずれが5分を超えています。

解決策

現在の時刻がSAMLアサーションのclockskew (デフォルトでは300秒)より早く設定されていないことを確認します。

マシンの時刻を一致させるか、policy-accessor-config.xmlファイルでagent.clock.skewプロパティ(秒単位)を構成します。このファイルは、DOMAIN_HOME/config/fmwconfigディレクトリにあります。

20.7.2.5 ワークリストがタイムアウトしたか無効になっている

問題

定義された期間内にワークリストがOracle SOA SuiteのBPELサーバーからの問合せ結果を取得できません。

ワークリストは、同時スレッドを使用してOracle SOA SuiteのBPELサーバーに対して問合せを発行します。これらのスレッドには、応答期限として特定の時間が割り当てられています。これらのスレッドが割当て時間(たとえば15秒)内に応答しないと、ワークリストではそのコールはタイムアウトとなり、タスク・フローに使用不能メッセージが表示されます。この場合、次のような関連する例外がログ・ファイルに記録されます。

[2009-03-03T12:09:34.769-08:00] [WLS_Spaces] [ERROR] [WCS-32103]
[oracle.webcenter.worklist.model] [tid: [ACTIVE].ExecuteThread: '3' for queue:
'weblogic.kernel.Default (self-tuning)'] [userId: user] [ecid:
0000HzDx68KC0zT6uBbAEH19fOWs00002q,0] [APP: webcenter] Unable to query BPEL repository.[[
oracle.webcenter.concurrent.TimeoutException: Execution timedout
queued :     1 ms
suspended :     0 ms
running : 15389 ms
timeout : 15000 ms
service : Worklist
resource : ir
source : oracle.webcenter.concurrent.CallableTask@bf3952
(oracle.webcenter.concurrent.CallableTask)
submission : 150
at
oracle.webcenter.concurrent.Submission.transitionTo(Submission.java:595)
at oracle.webcenter.concurrent.Submission.timeout(Submission.java:634)
at
oracle.webcenter.concurrent.InternalExecutorService.checkForTimeouts(InternalExecutorService.java:566)
at
oracle.webcenter.concurrent.InternalExecutorService.access$300(InternalExecutorService.java:18)
at
oracle.webcenter.concurrent.InternalExecutorService$1.run(InternalExecutorService.java:352)
at java.util.TimerThread.mainLoop(Timer.java:512)
at java.util.TimerThread.run(Timer.java:462)]]

解決策

このようなエラーが絶えず発生する場合、ワークリストが実行されている管理対象サーバーとOracle SOA SuiteのBPELサーバーが使用できるリソースに基本的な問題がある可能性があります。

ユーザーの人数と提供されているリソースの量が、提供されているインフラストラクチャでのこれらのサーバーの実行に適切であるかどうかを検証してください。

SOAサーバーのパフォーマンスを改善できない場合は、Enterprise ManagerシステムMBeanブラウザを使用して、タイムアウトしきい値を上げてください(ワークリストに新しいタイムアウトを追加)。

詳細は、パフォーマンス・チューニング・ガイドの同時実行性管理の構成に関する項を参照してください。

注意:
TimeoutExceptionsが連続的に発生すると、ワークリストが無効化される可能性もあります。そのため、ワークリストはすばやく応答できないBPELインスタンスに接続できなくなります。その場合は、ログにoracle.webcenter.concurrent.DisabledException例外が記録されます。これらの例外は、ワークリストの障害に関連しています。

20.7.3 電子メール通知が動作しない

問題

第20.6項「電子メールで送信するWebCenter Portalワークフロー通知の構成」で説明されているようには、ワークフローの通知が電子メールで送信されません。

解決策

招待プロセスが実行されたときのエラーについては、WebCenterおよびSOAサーバーのエラー・ログを確認してください。電子メール構成に問題があると考えられる場合は、まったく同じLDAP設定とユーザー・アカウントを使用して、別の電子メール・クライアントから電子メールの送受信ができるかどうかを確認してください。

21 ポートレット・プロデューサの管理

この章では、WSRPおよびOracle PDK-Javaポートレット・プロデューサへの接続の作成方法やそれらのポートレット・プロデューサの登録方法、およびその接続を編集および削除する方法について説明します。さらに、この章では、WSRPおよびOracle PDK-Javaポートレット・プロデューサのデプロイ方法についても説明します。

この章には次のトピックが含まれます:

- 第21.1項「ポートレット・プロデューサについて」

- 第21.2項「WSRPプロデューサの登録」

- 第21.3項「WSRPプロデューサの接続テスト」

- 第21.4項「Oracle PDK-Javaプロデューサの登録」

- 第21.5項「Oracle PDK-Javaプロデューサの接続テスト」

- 第21.6項「プロデューサ登録情報の編集」

- 第21.7項「ポートレット・クライアント構成の編集」

- 第21.8項「プロデューサの登録解除」

- 第21.9項「管理コンソールを使用したポートレット・プロデューサの管理」

- 第21.10項「プロデューサの登録タスク・フローでの作業」

- 第21.11項「ポートレット・プロデューサ・アプリケーションのデプロイ」

- 第21.12項「WebCenterサービス・ポートレットの構成」

- 第21.13項「ポートレット・プロデューサ問題のトラブルシューティング」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

注意:
ページレット・プロデューサの登録については、別の章で説明します。詳細は、第22.2項「ページレット・プロデューサの登録」を参照してください。

21.1 ポートレット・プロデューサについて

WebCenter Portalを使用すると、開発者はポータルのポートレットを使用して他のアプリケーションの機能を公開できます。ポータルでは、WebCenter Portalまたは他のOracle製品を使用して構築されるポートレットおよびパッケージ・アプリケーション・ベンダーなどのサード・パーティから受け取るポートレットを使用できます。表21-1に、WebCenter Portal内でポートレット・プロデューサとしてサポートされる一部の製品を示します。

表21-1 サポートされるポートレット・プロデューサ

ポートレット・プロデューサ

サポートの有無

ノート

Oracle WebLogic Portal

はい

詳細は、Oracle Fusion Middleware Oracle WebLogic Portalポートレット開発ガイドの他のシステムで使用するJavaポートレットのエクスポートに関する項を参照してください。

Oracle WebCenter Interaction

N/A

Oracle Portal

はい

詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のポートレットの再利用に関する項を参照してください。

E-Business Suiteアプリケーション

はい

詳細は、『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』のE-Business Suiteアプリケーションの統合に関する項を参照してください。

PeopleSoftアプリケーション

はい

詳細は、『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』のPeopleSoftアプリケーションの統合に関する項を参照してください。

JD Edwardsアプリケーション

はい

詳細は、『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』のJD Edwardsアプリケーションの統合に関する項を参照してください。

注意:
サード・パーティによって構築されてWebCenter Portalによって使用されるWSRPプロデューサは、用意されているとおりに正しく機能する必要があります。

- プロデューサは、WSRPに対するベンダー固有の拡張機能に依存しません。

- ポートレットは、ページに存在する特定のJavaScriptメソッドの予測など、使用されているアプリケーションについて推測を行いません。

システム管理者はWebCenter Portalアプリケーションをデプロイするために、Fusion Middleware ControlまたはWLSTコマンド行ツールを使用してWSRPおよびOracle PDK-Javaポートレット・プロデューサを登録および管理できます。

アプリケーション管理者は、提供されている管理ページを使用するかポートレット・プロデューサのタスク・フローを使用して、実行時にポートレット・プロデューサを登録および管理することも可能です。

ポートレット・プロデューサを使用する際には、次の点に留意してください。

- いくつかの組込みプロデューサが、WebCenter Portalに付属しています(OmniPortletおよびWSRPツール)。次のEARファイルはWebCenter Portalに同梱されています。

- portalTools.ear: OmniPortlet

- wsrp-tools.ear - WSRPツール

portalTools.earファイルおよびwsrp-tools.earファイルは、registerOOTBProducers WLSTコマンドを使用してインストールできます。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のregisterOOTBProducersに関する項を参照してください。

- JSR 286またはOracle PDK-Javaポートレットをページに追加する前に、所有されているWSRPおよびOracle PDK-Javaプロデューサを登録しておく必要があります。『WebLogic Scripting Toolコマンド・リファレンス』のregisterSampleProducersに関する項を参照してください。

- Oracle Portlet Producer製品(サーバー)が本番環境にインストールされ、wsrp-toolsおよびportalToolsのURLにアクセスできる必要があります。Oracle Portlet Producerがインストールされていない場合、『Oracle WebCenter Portalインストレーション・ガイド』の既存ドメインの拡張に関する項を参照して、本番環境にインストールしてください。

- ポートレット・プロデューサへの接続を作成するとき、プロデューサはWebCenter Portalアプリケーションにより登録され、接続はconnections.xmlファイルに追加されます。WRSPプロデューサでは、命名規則connectionname-wsconnに従いWebサービス接続も作成されます。Oracle PDK-Javaプロデューサでは、命名規則connectionname-urlconnに従い、基礎となるURL接続が作成されます。登録中に、接続メタデータがOracle Metadata Services (MDS)リポジトリおよび登録中のプロデューサに作成されます。プロデューサのポートレットが利用されると、ユーザー・カスタマイズがプロデューサに保存されます。登録解除中に、プロデューサの接続とカスタマイズは削除されます。

- デプロイ後のすべての接続構成はMDSに格納されます。詳細は、第1.3.5項「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。MDSの詳細は、管理者ガイドのメタデータ・リポジトリの管理に関する章を参照してください。

- ポートレット・プロデューサの登録は動的です。新規のポートレット・プロデューサや既存のプロデューサに対する更新は、WebCenter Portalアプリケーションで即座に使用可能になります。WebCenter Portalアプリケーションや管理サーバーを再起動する必要はありません。

- インスタンス間でプロデューサを移行するには、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のWSRPプロデューサ永続性ストアの移行に関する項またはPDK-Javaプロデューサ永続性ストアの移行に関する項で説明している移行ユーティリティを使用してください。

- ポートレット・プロデューサの保護の詳細は、第37.1項「WSRPプロデューサの保護」および第37.2項「PDK-Javaプロデューサの保護」を参照してください。

21.2 WSRPプロデューサの登録

WSRPポートレット・プロデューサを登録するときには、プロデューサの運用パラメータを表す基本情報を指定する必要があります。この情報は、アプリケーションがプロデューサと通信し、プロデューサを通じてポートレットと通信するために使用されます。

Oracle WebCenter Portalは、WSPR 1.0とWSRP 2.0のプロデューサをどちらもサポートします。WSRP 2.0標準では、特にポートレット間通信と、ポートレット・カスタマイズのエクスポートおよびインポートをサポートしています。標準ベースのJSR 286ポートレットの作成時には、WSRP 2.0の利点を活用できます。

Oracle WebCenter Portalには、デプロイ済のアプリケーションにWSRPプロデューサを登録する複数のツールが用意されています。

この項には次のトピックが含まれます:

- 第21.2.1項「Fusion Middleware Controlを使用したWSRPプロデューサの登録」

- 第21.2.2項「WLSTを使用したWSRPプロデューサの登録」

- 第21.2.3項「マップされたユーザーIDのための権限のポリシー・ストアへの追加」

- 第21.2.4項「WebCenter PortalでのWSRPポートレット・プロデューサの登録」

- 第21.2.5項「WebCenter Portal FrameworkアプリケーションでのWSRPポートレット・プロデューサの登録」

21.2.1 Fusion Middleware Controlを使用したWSRPプロデューサの登録

WSRPポートレット・プロデューサを登録するには:

1. Fusion Middleware Controlにログインし、Oracle WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「ポートレット・プロデューサ接続の追加」セクションで、WSRPプロデューサの接続情報を入力します。
パラメータの詳細は、表21-2を参照してください。

表21-2 WSRPプロデューサの接続パラメータ

フィールド

説明

接続名

WebCenter Portalアプリケーション内でこのポートレット・プロデューサ登録を識別するための一意の名前を入力します。名前は、すべてのWebCenter Portal接続タイプにおいて一意である必要があります。

ここで指定した名前は、コンポーザ (「ポートレット」フォルダの下)に表示されます。

プロデューサ・タイプ

このプロデューサのタイプを指定します。「WSRPプロデューサ」を選択します。

WSDL URL

WSRPプロデューサの登録URL。

構文はWSRP実装によって異なります。たとえば、Oracle WSRPコンテナにデプロイされたポートレットのURL形式は次のとおりです。

http://host_name:port_number/context_root/portlets/wsrp2?WSDL

http://host_name:port_number/context_root/portlets/wsrp1?WSDL

http://host_name:port_number/context_root/portlets/?WSDL(WSRP 1.0: 後方互換性のため)

ここで:

- host_nameは、プロデューサがデプロイされているサーバーです。

- port_numberは、HTTPリスナーのポート番号です。

- context_rootは、Webアプリケーションのコンテキスト・ルートです。

- portlets wsrp(1|2)?WSDLは静的テキストです。Oracle WSRPコンテナにデプロイされたすべての製品は、WSRPバージョン1およびバージョン2のプロデューサとして公開されます。
WebCenter Portalでは、Oracle WebLogic Portalプロデューサに対してバージョン2のWSDLのみがサポートされます。

例:

http://myhost.com:7778/MyPortletApp/portlets/wsrp2?WSDL

WSRPプロデューサでは、次のプロデューサ・テスト・ページにアクセスすることによって、この登録URLを取得できます。

http://host_name:port_number/context_root/info

プロキシを使用しますか。

WebCenter Portalアプリケーションでこのプロデューサとの接続にHTTPプロキシを使用する場合、これを選択します。これを選択した場合は、「プロキシ・ホスト」および「プロキシ・ポート」の値を入力してください。

WebCenter Portalアプリケーションとリモートのポートレット・プロデューサがファイアウォールで分断されていて、プロデューサとの通信にHTTPプロキシが必要な場合、プロキシが必要となります。

プロキシ・ホスト

プロキシ・サーバーのホスト名またはIPアドレスを入力します。

プロキシ・サーバー名の先頭にhttp://を付けないでください。

プロキシ・ポート

プロキシ・サーバーがリスニングするポート番号を入力します。デフォルト・ポートは80です。

デフォルトの実行タイムアウト(秒)

プロデューサとの通信で適切なタイムアウト時間(秒単位)を入力します。たとえば、プロデューサがWebCenter Portalアプリケーションのページでポートレットを登録、登録解除または表示するのに許される最長所要時間を入力します。デフォルトは30秒です。

個々のポートレットに固有のタイムアウト時間を定義できますが、その場合ここで指定した値よりも優先されます。

4. 「セキュリティ」セクションを使用して、アイデンティティ伝播またはアサーションに使用するセキュリティ・トークンのタイプを指定します。
伝播またはアサートされたユーザー情報が含まれるセキュリティ・トークンは、SOAPヘッダー内のXML要素として表されます。セキュリティ・トークンおよびSOAPメッセージ本文はデジタル署名されて、WebCenter PortalアプリケーションからのSOAPメッセージ送信元の真正性が証明されます。WebCenter Portalアプリケーションがサポートするセキュリティ・トークンは、WSS 1.0ユーザー名トークン(パスワードなし)、WSS 1.0ユーザー名トークン(パスワードあり)、WSS 1.0 SAMLトークン、メッセージ整合性付きWSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.0 SAMLトークンおよびメッセージ保護付きWSS 1.1 SAMLトークンの6種類です。

SAMLは、Security Assertion Markup Languageの省略形です。

注意:
PeopleSoft WSRPプロデューサは、ユーザー名トークン(パスワードあり)およびメッセージ整合性付きSAMLトークンの2種類のプロファイルをサポートします。Oracle Portal (コンシューマとして)は、ユーザー名トークン(パスワードなし)、ユーザー名トークン(パスワードあり)、メッセージ整合性付きSAMLトークンの3種類のプロファイルをサポートします。その他のOracle WSRPプロデューサでは、6種類のプロファイルすべてがサポートされています。その他のWSRPコンテナについては、サポートされているトークン形式を各ベンダーに確認してください。

パラメータの詳細は、表21-3を参照してください。

表21-3 WSRPプロデューサのセキュリティの接続パラメータ

フィールド

説明

トークン・プロファイル

このWSRPプロデューサでの認証に使用するトークン・プロファイルのタイプを選択します。次から選択します。

- メッセージ整合性付きWSS 1.0 SAMLトークン

- メッセージ保護付きWSS 1.0 SAMLトークン

- WSS 1.0ユーザー名トークン(パスワードなし)

- WSS 1.0ユーザー名トークン(パスワードあり)

- WSS 1.0 SAMLトークン

- メッセージ保護付きWSS 1.1 SAMLトークン

- なし

これらの各オプションの説明は、表21-4を参照してください。

構成

次を選択します。

- デフォルト: デフォルトのトークン・プロファイル構成が使用されます。

- カスタム: カスタムのOracle Webサービス・マネージャの構成が使用されます。
「カスタム」を選択すると追加のセキュリティ・オプション(すべてのキーストア・プロパティを含む)が表示されます。

発行者名

SAMLトークンの発行者の名前を入力します。

たとえば、www.example.comなどになります。

発行者名は、サブジェクトの検証を保証する証明エンティティです。これはプロデューサ側で信頼されたSAML発行者である必要があります。

有効なトークン: メッセージ整合性付きWSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.0 SAMLトークン。WSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.1 SAMLトークン

デフォルト・ユーザー

ユーザーがWebCenter Portalアプリケーションで認証されていない場合、リモート・プロデューサに対してアサートするユーザー名を入力します。

認証されていない場合は、anonymousというアイデンティティがアプリケーション・ユーザーに関連付けられます。anonymousの値がリモート・プロデューサに適していない場合、ここに別のアイデンティティを指定する必要がある場合があります。ただし、この場合、WebCenter Portalアプリケーションがユーザーを認証していないため、指定したデフォルト・ユーザーはリモート・プロデューサで権限の低いユーザーになることに注意してください。ユーザーがアプリケーションで認証されている場合、デフォルト・ユーザーではなくそのユーザーのアイデンティティがアサートされます。

WSRPリモート・プロデューサはこの情報を受け入れるように設定する必要があります。第21.2.3項「マップされたユーザーIDのための権限のポリシー・ストアへの追加」の説明に従ってポリシー・ストアに権限を追加する必要もあります。

有効なトークン: メッセージ整合性付きWSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.0 SAMLトークン、WSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.1 SAMLトークン、WSS 1.0ユーザー名トークン(パスワードなし)。

関連付けられている外部アプリケーション

(ユーザー名(パスワードあり))

このプロデューサが認証に外部アプリケーションを使用する場合、「関連付けられている外部アプリケーション」ドロップダウン・リストを使用してアプリケーションを指定します。目的のアプリケーションがリストに表示されない場合は、「新規作成」を選択して、ここで外部アプリケーションを定義します。

「WSS 1.0ユーザー名(パスワードあり)」セキュリティ・オプションを使用してプロデューサをサポートするには、外部アプリケーションが必要です。外部アプリケーションが、ユーザー資格証明を格納および提供します。第23.2項「外部アプリケーションの登録」も参照してください。

有効なオプション: 「WSS 1.0ユーザー名(パスワードあり)」のみ。

表21-4に、WebCenter Portalアプリケーションでサポートされるセキュリティ・トークンのタイプを示します。

表21-4 トークン・プロファイルのオプション

トークン・プロファイル

説明

メッセージ整合性付きWSS 1.0 SAMLトークン

wss10_saml_token_with_message_integrity_client_policy

このポリシーでは、WS-Security 1.0標準に従って、メッセージレベルの整合性保護およびアウトバウンドSOAPリクエストのSAMLベースの認証が実施されます。SAMLトークンはSOAPメッセージに含まれ、送信者保証確認によるSAMLベース認証で使用されます。このポリシーは、WS-Securityの非対称鍵テクノロジBasic 128スイートおよびSHA-1ハッシュ・アルゴリズムを使用してメッセージの整合性を保護します。

メッセージ保護付きWSS 1.0 SAMLトークン

oracle/wss10_saml_token_with_message_protection_client_policy

このポリシーでは、WS-Security 1.0標準に従って、メッセージレベルの保護(整合性と機密性)およびアウトバウンドSOAPリクエストのSAMLベースの認証が実施されます。Webサービス・コンシューマは、SOAPヘッダーにSAMLトークンを含み、確認タイプは送信者保証です。このポリシーでは、WS-Securityの非対称鍵テクノロジのBasic 128スイートを使用します。特に、メッセージ機密性用のRSA鍵メカニズム、メッセージ整合性用のSHA-1ハッシュ・アルゴリズムおよびAES-128ビット暗号化が使用されます。

WSS 1.0ユーザー名トークン(パスワードなし)

oracle/wss10_username_id_propagation_with_msg_protection_client_policy

このポリシーでは、WS-Security 1.0標準に従って、アウトバウンドSOAPリクエストに対して、証明書ベースのメッセージ保護を使用したパスワード付きのユーザー名トークン・プロファイル・ベースのアイデンティティ伝播が実施されます。資格証明(ユーザー名のみ)は、WS-Security UsernameTokenヘッダーによりアウトバウンドSOAPリクエスト・メッセージに含められます。パスワードは含められません。メッセージの保護は、WS-Security 1.0の非対称鍵テクノロジのBasic 128スイートを使用して提供されます。特に、メッセージ機密性用のRSA鍵メカニズム、メッセージ整合性用のSHA-1ハッシュ・アルゴリズムおよびAES-128ビット暗号化が使用されます。

WSS 1.0ユーザー名トークン(パスワードあり)

oracle/wss10_username_token_with_message_protection_client_policy

このポリシーでは、WS-Security v1.0標準に従って、アウトバウンドSOAPリクエストに対して、証明書ベースのメッセージ保護を使用したパスワード付きのユーザー名トークン・プロファイル・ベースのアイデンティティ伝播が実施されます。プレーン・テキストとダイジェストの両方のメカニズムがサポートされています。このポリシーでは、WS-Securityの非対称鍵テクノロジのBasic 128スイートを使用します。特に、メッセージの機密性のためのRSA鍵メカニズム、メッセージ整合性のためのSHA-1ハッシュ・アルゴリズムおよびAES-128ビット暗号化が使用されます。

WSRPプロデューサが別のアイデンティティ・ストアを持つ場合は、このトークン・プロファイルを使用してください。プロデューサに関連する外部アプリケーションを定義し、外部アプリケーションをこのプロデューサに関連付ける必要があります。

WSS 1.0 SAMLトークン

oracle/wss10_saml_token_client_policy

このポリシーでは、WS-Security 1.0標準に従って、アウトバウンドSOAPリクエスト・メッセージのSAMLベースの認証が実施されます。このポリシーはユーザーIDを伝播するため、通常はメッセージ保護および整合性チェックを必要としない部署内デプロイに使用されます。

このポリシーではキーストアの構成は必要ありません。

メッセージ保護付きWSS 1.1 SAMLトークン

oracle/wss11_saml_token_with_message_protection_client_policy

このポリシーでは、WS-Security 1.1標準に従って、メッセージレベルの保護(整合性と機密性)およびアウトバウンドSOAPリクエストへのSAMLトークンの移入が実施されます。SAMLトークンはSOAPメッセージに含まれ、送信者保証確認によるSAMLベース認証で使用されます。このポリシーでは、署名および暗号化に対称鍵テクノロジ、署名の承認にWS-Securityの非対称鍵テクノロジのBasic 128スイートが使用されます。

なし

トークンなし。「なし」を選択した場合、WS-SecurityヘッダーはSOAPメッセージに添付されません。

5. 「キー・ストア」セクションを使用して、SOAPメッセージの一部分(セキュリティ・トークンとSOAPメッセージ本文)の署名に使用する証明書および秘密鍵が含まれるキーストアの場所を指定します。
これらのプロパティは、ドメインに指定された構成を無効にする場合にのみ構成してください。

パラメータの詳細は、表21-5を参照してください。

表21-5 WSRPプロデューサのキーストアの接続パラメータ

フィールド

説明

受信者の別名

プロデューサの証明書に関連付けられたキーストア別名を指定します。

この証明書は、プロデューサに対してメッセージを暗号化するために使用されます。

ストア・パス

SOAPメッセージ(セキュリティ・トークンとメッセージ本文)の署名または暗号化に使用する証明書および秘密鍵が含まれるキーストアの絶対パスを入力します。この表に示されている署名、暗号化および受信者キーはこのキーストアで使用できる必要があります。

指定されたキーストア・ファイルは、JDKのキーツール・ユーティリティを使用して作成されている必要があります。

パスワード

キーストアの作成時に設定されたキーストアへのパスワードを指定します。パスワードが使用できない場合や正しくない場合、プロデューサを使用できません。

署名キーの別名

署名キーの別名を入力します。

「署名キーの別名」は、署名に使用される秘密鍵に関連付けられた証明書の識別子です。

署名キーのパスワード

「署名鍵の別名」に指定された別名によって識別されるキーにアクセスするためのパスワードを指定します。

暗号化キーの別名

返されるメッセージを暗号化するには、プロデューサによって使用されるキーの別名を入力します。有効な値は、指定されたキーストアにあるキーの別名の1つです。

このプロパティはオプションです。指定しないと、プロデューサは返されるメッセージを暗号化するための署名キーを使用します。

暗号化キーのパスワード

暗号化キーにアクセスするためのパスワードを入力します。

6. 「OK」をクリックします。
新しいプロデューサが接続表に表示されます。

21.2.2 WLSTを使用したWSRPプロデューサの登録

WLSTコマンドのregisterWSRPProducerを使用して、WSRPポートレット・プロデューサとの接続を作成し、WebCenter Portalアプリケーションにプロデューサを登録します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のregisterWSRPProducerに関する項を参照してください。

関連項目:
deregisterWSRPProducer、listWSRPProducers、refreshProducer、registerOOTBProducers、registerSampleProducers

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

21.2.3 マップされたユーザーIDのための権限のポリシー・ストアへの追加

Default Userフィールドを使用して別のユーザーIDにマップする場合、次のいずれかを実行してポリシー・ストアに権限を追加する必要もあります。

- 次の権限を直接ポリシー・ストアに追加します。

<grant>
<grantee>
<codesource>

<url>file:${common.components.home}/modules/oracle.wsm.agent.common_11.1.1/wsm-agent.jar</url>
</codesource>
</grantee>
<permissions>
<permission>
<class>oracle.wsm.security.WSIdentityPermission</class>
<name>resource=MyAppID</name>
<actions>assert</actions>
</permission>
<permissions>
<grant>

前述の行でバージョン番号(ある場合)を含むクライアント・アプリケーション名にMyAppIDを置き換えます。

- 次のWLSTコマンドを実行して権限を付与します。

grantPermission(codeBaseURL='file:${common.components.home}/modules/oracle.wsm.agent.common_11.1.1/wsm-agent.jar',
permClass='oracle.wsm.security.WSIdentityPermission',
permTarget='resource=MyAppID', permActions='assert')

バージョン番号(ある場合)を含むクライアント・アプリケーション名にMyAppIDを置き換えます。

21.2.4 WebCenter PortalでのWSRPポートレット・プロデューサの登録

WebCenter Portalでポートレット・プロデューサを登録するには、次に示すロールと権限が必要になります。

- AppConnectionManagerロール - ポートレット・プロデューサを管理できます。
デフォルトでは、WebCenter PortalのAdministratorロールを持つユーザーには、このロールが割り当てられているため、管理者はポートレット・プロデューサを構成できます。Fusion Middleware ControlまたはWLSTコマンドgrantAppRoleを使用すると、この権限を別のユーザーに付与できます。たとえば、次に示すWLSTコマンドgrantAppRoleは、AppConnectionManagerロールをユーザーmontyに付与します。

grantAppRole(appStripe='webcenter', appRoleName='AppConnectionManager',  principalClass='weblogic.security.principal.WLSUserImpl', principalName='monty')

第32.5.2.1項「Fusion Middleware Controlを使用したアプリケーション・ロールの付与」を参照してください。

- Application - Manage Configuration権限 - WebCenter Portalの管理ページにアクセスできます。第49章「ポータル間のセキュリティの管理」を参照してください。

WebCenter PortalでWSRPプロデューサを登録するには:

1. WebCenter Portal管理を開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ポートレット・プロデューサ」を選択します。
または、次のURLを使用して、「ポートレット・プロデューサ」を選択します。

http://host:port/webcenter/portal/admin/tools

3. メニュー・バーの「登録」をクリックします。

4. 「ポートレット・プロデューサの登録」ページで、WSRPポートレット・プロデューサの接続の詳細を入力します。詳細は、表21-2を参照してください。

5. 「セキュリティ」セクションを使用して、アイデンティティ伝播またはアサーションに使用するセキュリティ・トークンのタイプを指定します。
伝播またはアサートされたユーザー情報が含まれるセキュリティ・トークンは、SOAPヘッダー内のXML要素として表されます。セキュリティ・トークンおよびSOAPメッセージ本文はデジタル署名されて、WebCenter PortalアプリケーションからのSOAPメッセージ送信元の真正性が証明されます。

詳細は、表21-6を参照してください。

表21-6 WSRPポートレット・プロデューサの登録: セキュリティ

フィールド

説明

トークン・プロファイル

アイデンティティ伝播またはアサーションに使用する、セキュリティ・トークンのタイプを選択します。

WebCenter Portalでは、次に示す6つのタイプのセキュリティ・トークンをサポートします。

- WSS 1.0 SAMLトークン

- メッセージ整合性付きWSS 1.0 SAMLトークン

- メッセージ保護付きWSS 1.0 SAMLトークン

- WSS 1.0ユーザー名トークン(パスワードあり)

- WSS 1.0ユーザー名トークン(パスワードなし)

- メッセージ保護付きWSS 1.1 SAMLトークン

- なし

これらの各セキュリティ・トークンの詳細は、表21-4を参照してください。

受信者の別名

プロデューサの証明書に関連付けられたキーストア別名を指定します。

この証明書は、プロデューサに対してメッセージを暗号化するために使用されます。

有効なトークン: メッセージ保護付きWSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.1 SAMLトークンおよびWSS 1.0ユーザー名トークン(パスワードなし)。

デフォルト・ユーザー

ユーザーがWebCenter Portalで認証されていない場合、リモート・プロデューサに対してアサートするユーザー名を入力します。

認証されていない場合は、anonymousというアイデンティティがアプリケーション・ユーザーに関連付けられます。現時点では、OWSMはanonymousアイデンティティの伝播をサポートしていないため、ここには別のアイデンティティを指定する必要があります。この場合、WebCenter Portalではユーザーを認証していないため、指定したデフォルト・ユーザーはリモート・プロデューサでの権限の低いユーザー(パブリック・コンテンツの表示に適したアイデンティティ)になることに注意してください。たとえば、この目的のために、アイデンティティ・ストアにゲスト・アカウントを作成できます。ユーザーがアプリケーションで認証されている場合は、そのユーザーのアイデンティティが、デフォルト・ユーザーのかわりにアサートされます。

WSRPリモート・プロデューサはこの情報を受け入れるように設定する必要があります。第21.2.3項「マップされたユーザーIDのための権限のポリシー・ストアへの追加」の説明に従ってポリシー・ストアに権限を追加する必要もあります。

有効なトークン: メッセージ整合性付きWSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.0 SAMLトークン、WSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.1 SAMLトークン、WSS 1.0ユーザー名トークン(パスワードなし)。

関連付けられている外部アプリケーション

このプロデューサが認証に外部アプリケーションを使用する場合は、「関連付けられている外部アプリケーション」ドロップダウン・リストを使用してアプリケーションを指定します。

「WSS 1.0ユーザー名トークン(パスワードあり)」セキュリティ・オプションを使用してプロデューサをサポートするには、外部アプリケーションが必要です。外部アプリケーションが、ユーザー資格証明を格納および提供します。第23.2項「外部アプリケーションの登録」も参照してください。

有効なオプション: 「WSS 1.0ユーザー名(パスワードあり)」のみ。

6. 「テスト」をクリックして、指定したサーバーの詳細が正しいことを確認します。
サーバーに接続できると、成功メッセージが表示されます。サーバーがダウンしている、またはホスト情報が正しくないか有効でない場合、接続の失敗メッセージが表示されます。

注意:
テストでは、サーバー(ホスト/ポート)の単純なPINGテストが実行されます。プロデューサがアクセス可能かどうかを確認するには、ブラウザでプロデューサのテスト・ページにアクセスします。詳細は、第21.3項「WSRPプロデューサの接続テスト」を参照してください。

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

21.2.5 WebCenter Portal FrameworkアプリケーションでのWSRPポートレット・プロデューサの登録

設計時に、Portal FrameworkアプリケーションでWSRPポートレット・プロデューサを登録する方法の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のWSRPポートレット・プロデューサの登録方法に関する項を参照してください。

実行時に、Portal FrameworkアプリケーションでWSRPポートレット・プロデューサを登録する方法の詳細は、第21.9.1項「管理コンソールを使用したポートレット・プロデューサの登録」を参照してください。

21.3 WSRPプロデューサの接続テスト

WSRPプロデューサ接続を検証するには、最初にプロデューサのURLを取得します。

http://host_name:port_number/context_root/info

次に、ブラウザ・ウィンドウでプロデューサのURLを実行します。

WSRP v1プロデューサ接続の場合、URL形式は次のとおりです。

http://host_name:port_number/context_root/portlets/wsrp1?WSDL

例:

http://myhost.com:7778/MyPortletApp/portlets/wsrp1?WSDL

WSRP v2プロデューサ接続の場合、URL形式は次のとおりです。

http://host_name:port_number/context_root/portlets/wsrp2?WSDL

例:

http://myhost.com:7778/MyPortletApp/portlets/wsrp2?WSDL

21.4 Oracle PDK-Javaプロデューサの登録

PDK-Javaポートレット・プロデューサを登録するときには、プロデューサの運用パラメータを表す基本情報を指定する必要があります。この情報は、WebCenter Portalがプロデューサと通信し、プロデューサを通じてポートレットと通信するために使用されます。

WebCenter Portalには、デプロイ済のアプリケーションにOracle PDK-Javaプロデューサを登録する複数のツールが用意されています。

この項には次のトピックが含まれます:

- 第21.4.1項「Fusion Middleware Controlを使用したOracle PDK-Javaプロデューサの登録」

- 第21.4.2項「WLSTを使用したOracle PDK-Javaプロデューサの登録」

- 第21.4.3項「WebCenter PortalでのOracle PDK-Javaポートレット・プロデューサの登録」

- 第21.4.4項「WebCenter Portal FrameworkアプリケーションでのOracle PDK-Javaポートレット・プロデューサの登録」

21.4.1 Fusion Middleware Controlを使用したOracle PDK-Javaプロデューサの登録

Oracle PDK-Javaポートレット・プロデューサを登録するには:

1. Fusion Middleware Controlにログインし、Oracle WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「ポートレット・プロデューサ接続の追加」セクションで、Oracle PDK-Javaプロデューサの接続情報を入力します。
パラメータの詳細は、表21-7を参照してください。

表21-7 Oracle PDK-Javaプロデューサの接続パラメータ

フィールド

説明

接続名

WebCenter Portalアプリケーション内でこのポートレット・プロデューサ登録を識別する一意の名前を入力します。名前は、すべてのWebCenter Portal接続タイプにおいて一意である必要があります。

ここで指定した名前は、コンポーザ (「ポートレット」フォルダの下)に表示されます。

プロデューサ・タイプ

このプロデューサのタイプを指定します。「Oracle PDK-Javaプロデューサ」を選択します。

URLエンドポイント

次の構文を使用して、Oracle PDK-JavaプロデューサのURLを入力します。

http://host_name:port_number/context_root/providers

ここで:

- host_nameは、プロデューサがデプロイされているサーバーです。

- port_numberは、HTTPリスナーのポート番号です。

- context_rootは、Webアプリケーションのコンテキスト・ルートです。

- providersは、静的テキストです。

例:

http://myHost.com:7778/myEnterprisePortlets/providers

サービスID

このプロデューサの一意の識別子を入力します。

PDK-Javaを使用すると、単一のアダプタ・サーブレットの下に複数のプロデューサをデプロイできます。プロデューサは、それぞれ一意のサービスIDによって識別されます。サービスIDが必要なのは、URLエンドポイントにサービスIDが追加されていない場合のみです。

たとえば、次のURLエンドポイントには、サービスIDとしてsampleが必要です。

http://domain.example.com:7778/axyz/providers

しかし、次のURLエンドポイントにはサービスIDは不要です。

http://domain.example.com:7778/axyz/providers/sample

サービスIDは<service_id>.propertiesと呼ばれるファイルを検索するために使用します。このファイルではテスト・ページを表示するかどうかなど、プロデューサの特性を定義します。任意の値を使用してサービスIDを作成します。サービスIDが指定されていない場合は、_default.propertiesが使用されます。

プロキシを使用しますか。

WebCenter Portalアプリケーションでこのプロデューサとの接続にHTTPプロキシを使用する場合、このチェック・ボックスを選択します。これを選択した場合は、「プロキシ・ホスト」および「プロキシ・ポート」の値を入力してください。

WebCenter Portalアプリケーションとリモートのポートレット・プロデューサがファイアウォールで分断されていて、プロデューサとの通信にHTTPプロキシが必要な場合、プロキシが必要となります。

プロキシ・ホスト

プロキシ・サーバーのホスト名またはIPアドレスを入力します。

プロキシ・サーバー名の先頭にhttp://を付けないでください。

プロキシ・ポート

プロキシ・サーバーがリスニングするポート番号を入力します。デフォルト・ポートは80です。

関連付けられている外部アプリケーション

このプロデューサのポートレットの1つが認証を必要とする場合は、「関連付けられている外部アプリケーション」ドロップダウンを使用して、正しい外部アプリケーションを指定します。

目的のアプリケーションがリストに表示されない場合は、「新規作成」を選択して、ここで外部アプリケーションを定義します。

第23.2項「外部アプリケーションの登録」も参照してください。

セッションを確立しますか。

これを選択した場合、このプロデューサからポートレットを実行するときにユーザー・セッションが有効化されます。セッションが有効な場合、それらはプロデューサのサーバーに保持されます。これによりポートレット・コードはセッションに情報を保持できます。

メッセージ認証はセッションを使用します。このため、共有鍵を指定するには、このオプションを選択する必要があります。

プロデューサとサーバーの間でセッションレス通信を行う場合は、このオプションを選択しないでください。

デフォルトの実行タイムアウト(秒)

プロデューサとの通信で適切なタイムアウト時間(秒単位)を入力します。たとえば、プロデューサがWebCenter Portalアプリケーションのページでポートレットを登録、登録解除または表示するのに許される最長所要時間を入力します。これはデフォルトで30秒に設定されます。

個々のポートレットに固有のタイムアウト時間を定義できますが、その場合ここで指定した値よりも優先されます。

サブスクライバID

登録するプロデューサのコンシューマを識別する文字列を入力します。

プロデューサがアプリケーションに登録されると、プロデューサのコールが送信されます。コール中、コンシューマ(このインスタンスのWebCenter Portalアプリケーション)は、「サブスクライバID」の値をプロデューサに渡します。「サブスクライバID」がプロデューサの予測した値でない場合、プロデューサは登録コールを拒否することがあります。

共有鍵

暗号化を処理するように設定されているプロデューサに使用する共有鍵を入力します。

共有鍵は、メッセージ認証用のメッセージ署名を生成するための暗号化アルゴリズムで使用されます。共有鍵を使用してプロデューサが設定されている場合、ここに間違った共有鍵を入力すると、プロデューサ登録は失敗するので注意してください。共有鍵には、英数字10から20文字を含めることができます。

このキーは、フェデレーテッド・ポータル・アダプタ(FPA)を使用してプロデューサを登録するときにも使用されます。共有鍵はHMACキーとも呼ばれます。

4. 「OK」をクリックします。
新しいプロデューサが接続表に表示されます。

21.4.2 WLSTを使用したOracle PDK-Javaプロデューサの登録

WLSTコマンドのregisterPDKJavaProducerを使用して、PDK-Javaポートレット・プロデューサとの接続を作成し、WebCenter Portalアプリケーションにプロデューサを登録します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のregisterPDKJavaProducerに関する項を参照してください。

関連項目:
deregisterPDKJavaProducer、listPDKJavaProducers、refreshProducer

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

21.4.3 WebCenter PortalでのOracle PDK-Javaポートレット・プロデューサの登録

WebCenter Portalでポートレット・プロデューサを登録するには、次に示すロールと権限が必要になります。

- AppConnectionManagerロール - ポートレット・プロデューサを管理できます。
デフォルトでは、ポータル・ビルダーのAdministratorロールを持つユーザーには、このロールが割り当てられているため、管理者はポートレット・プロデューサを構成できます。Fusion Middleware ControlまたはWLSTコマンドgrantAppRoleを使用すると、この権限を別のユーザーに付与できます。たとえば、次に示すWLSTコマンドgrantAppRoleは、AppConnectionManagerロールをユーザーmontyに付与します。

grantAppRole(appStripe='webcenter', appRoleName='AppConnectionManager',  principalClass='weblogic.security.principal.WLSUserImpl', principalName='monty')

第32.5.2.1項「Fusion Middleware Controlを使用したアプリケーション・ロールの付与」を参照してください。

- Application - Manage Configuration権限 - 「ポータル・ビルダー管理」ページにアクセスできます。第49章「ポータル間のセキュリティの管理」を参照してください。

WebCenter PortalでOracle PDK-Javaポートレット・プロデューサを登録するには:

1. WebCenter Portal管理を開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ポートレット・プロデューサ」を選択します。
または、次のURLを使用して、「ポートレット・プロデューサ」を選択します。

http://host:port/webcenter/portal/admin/tools

3. メニュー・バーの「登録」をクリックします。

4. 「ポートレット・プロデューサの登録」ページで、Oracle PDK-Javaプロデューサの接続の詳細を入力します。詳細は、表21-7を参照してください。

5. 「テスト」をクリックして、指定したサーバーの詳細が正しいことを確認します。
サーバーに接続できると、成功メッセージが表示されます。サーバーがダウンしている、またはホスト情報が正しくないか有効でない場合、接続の失敗メッセージが表示されます。

注意:
テストでは、サーバー(ホスト/ポート)の単純なPINGテストが実行されます。プロデューサがアクセス可能かどうかを確認するには、ブラウザでプロデューサのテスト・ページにアクセスします。詳細は、第21.5項「Oracle PDK-Javaプロデューサの接続テスト」を参照してください。

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

21.4.4 WebCenter Portal FrameworkアプリケーションでのOracle PDK-Javaポートレット・プロデューサの登録

設計時に、Portal FrameworkアプリケーションでOracle PDK-Javaポートレット・プロデューサを登録する方法の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のWebCenter Portal FrameworkアプリケーションでのOracle PDK-Javaポートレット・プロデューサの登録に関する項を参照してください。

実行時に、Portal FrameworkアプリケーションでOracle PDK-Javaポートレット・プロデューサを登録する方法の詳細は、第21.9.1項「管理コンソールを使用したポートレット・プロデューサの登録」を参照してください。

21.5 Oracle PDK-Javaプロデューサの接続テスト

Oracle PDK-Javaプロデューサ接続を検証するには、次の形式のプロデューサURLをブラウザ・ウィンドウで実行します。

http://host_name:port_number/context-root/providers/producer_name

例:

http://domain.example.com:7778/axyz/providers/sample

21.6 プロデューサ登録情報の編集

プロデューサ登録情報はいつでも更新できます。

プロデューサが別の場所に移動する場合、そのプロデューサに定義した接続を再構成する必要があります。Fusion Middleware ControlまたはWLSTを使用してURLプロパティを編集できます。

- WSRPプロデューサのWDSL URL

- Oracle PDK-JavaプロデューサのURLエンド・ポイント

ユーザーがWebCenter Portalアプリケーションで作業している間に行ったポートレットのカスタマイズとパーソナライズをすべて保持するには、プロデューサのカスタマイズとパーソナライズもプロデューサの新しい場所に移行する必要があります。ポートレット・クライアントのメタデータを別の場所に移行するには、WLSTコマンドexportPortletClientMetadataおよびimportPortletClientMetadataを使用します。

Portal Frameworkアプリケーションを移行する場合は、第44.1.3項「Portal Frameworkアプリケーションのポートレット・クライアント・メタデータのエクスポート」および第44.1.4項「Portal Frameworkアプリケーションのポートレット・クライアント・メタデータのインポート」を参照してください。

WebCenter Portalの場合は、第41.6.10.1項「ポートレット・クライアント・メタデータのバックアップ(エクスポート)」および第41.6.10.1項「ポートレット・クライアント・メタデータのバックアップ(エクスポート)」を参照してください。

この項には次のトピックが含まれます:

- 第21.6.1項「Fusion Middleware Controlを使用したプロデューサ登録情報の編集」

- 第21.6.2項「WLSTを使用したプロデューサ登録情報の編集」

- 第21.6.3項「WebCenter Portalでのプロデューサの登録情報の編集」

- 第21.6.4項「WebCenter Portal Frameworkアプリケーションでのプロデューサの登録情報の編集」

- 第21.6.5項「WSRPプロデューサ・メタデータの新しいWSDL URLへの移行」

21.6.1 Fusion Middleware Controlを使用したプロデューサ登録情報の編集

ポートレット・プロデューサの接続情報を更新するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ポートレット・プロデューサ」を選択します。

4. 「ポートレット・プロデューサ接続の管理」セクションで、変更するプロデューサを選択して「編集」をクリックします。

5. 「ポートレット・プロデューサ接続の編集」セクションで、必要に応じて接続情報を変更します。詳細は、次を参照してください。

- 表21-2「WSRPプロデューサの接続パラメータ」

- 表21-7「Oracle PDK-Javaプロデューサの接続パラメータ」

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

21.6.2 WLSTを使用したプロデューサ登録情報の編集

次のWLSTコマンドを使用して、ポートレット・プロデューサの接続を編集します。

- WSRPプロデューサ - setWSRPProducer

- PDK-Javaプロデューサ - setPDKJavaProducer

コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

21.6.3 WebCenter Portalでのプロデューサの登録情報の編集

WebCenter Portalでは、ポートレット・プロデューサに指定された多くの登録情報にアクセスして変更できます。

WebCenter Portalでポートレット・プロデューサの登録情報を編集するには:

1. WebCenter Portal管理を開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ポートレット・プロデューサ」を選択します。
または、次のURLを使用して、「ポートレット・プロデューサ」を選択します。

http://host:port/webcenter/portal/admin/tools

3. 編集するポートレット・プロデューサを選択します。

4. メニュー・バーの「編集」をクリックします。

5. プロデューサ登録のプロパティを必要に応じて編集します。

- WSRPプロデューサ

- 表21-2「WSRPプロデューサの接続パラメータ」

- 表21-6「WSRPポートレット・プロデューサの登録: セキュリティ」

- Oracle PDK-Javaプロデューサ

- 表21-7「Oracle PDK-Javaプロデューサの接続パラメータ」

「プロデューサ名」または「プロデューサ・タイプ」は編集できません。

注意:
「WSDL URL」または「URLエンドポイント」の値は編集可能ですが、たとえば、プロデューサのポートが変更されたときに別のプロデューサをポイントするには、新しいプロデューサが元のプロデューサの永続性ストアにアクセスできるか、または元のプロデューサの永続性ストアが新しいプロデューサの永続性ストアに移行されていることが必要です。詳細は、第41.6.5項「他のスキーマ・データ(ACTIVITIESとPORTLET)のバックアップおよびリストア」を参照してください。

6. 必要な設定をすべて変更したら、「テスト」をクリックして、指定したサーバーの詳細が正しいことを確認します。
サーバーに接続できると、成功メッセージが表示されます。サーバーがダウンしている、またはホスト情報が正しくないか有効でない場合、接続の失敗メッセージが表示されます。

注意:
テストでは、サーバー(ホスト/ポート)の単純なPINGテストが実行されます。

7. 完了したら、「OK」をクリックします。

21.6.4 WebCenter Portal Frameworkアプリケーションでのプロデューサの登録情報の編集

設計時に、Portal Frameworkアプリケーションでポートレット・プロデューサの登録情報を編集する方法の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のポートレット・プロデューサの登録設定の編集方法に関する項を参照してください。

実行時に、Portal Frameworkアプリケーションでポートレット・プロデューサの登録情報を編集する方法の詳細は、第21.9.2項「管理コンソールを使用したポートレット・プロデューサの登録情報の編集」を参照してください。

21.6.5 WSRPプロデューサ・メタデータの新しいWSDL URLへの移行

WSRPプロデューサを新しいWSDL URLに移動する場合、WLSTコマンドのexportPortletClientMetadata、setWSRPProducerおよびimportPortletClientMetadataを使用して、既存のプロデューサのメタデータを新しい場所に移行できます。

WSRPプロデューサのメタデータを新しいURLエンドポイントに移行する手順は、次のとおりです。

1. WLSTコマンドのexportPortletClientMetadataを使用して、プロデューサのメタデータをエクスポートします。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のexportPortletClientMetadataに関する項を参照してください。

2. WLSTコマンドsetWSRPProducerを使用して、プロデューサのWSDL URLを変更します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetWSRPProducerに関する項を参照してください。

3. WLSTコマンドのimportPortletClientMetadataを使用して、プロデューサのメタデータをインポートします。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のimportPortletClientMetadataに関する項を参照してください。

21.7 ポートレット・クライアント構成の編集

adf-config.xmlファイルには、WebCenter Portalサービスの構成情報が含まれています。ポートレット・クライアント構成の詳細は、このファイルのadf-portlet-configセクションで指定されています。

例21-1に、adf-config.xmlファイルのadf-portlet-config要素を示します。

例21-1 adf-config.xmlのadf-portlet-configセクション

<adf-portlet-config xmlns="http://xmlns.oracle.com/adf/portlet/config">
<supportedLocales>
<value>en</value>
<value>fr</value>
<value>de</value>
<value>es</value>
</supportedLocales>
<portletTechnologies>
<value>oracle.portlet.client.containerimpl.web.WebPortletTechnologyConfig</value>
<value>oracle.portlet.client.containerimpl.wsrp.WSRPPortletTechnologyConfig</value>
</portletTechnologies>
<defaultTimeout>20</defaultTimeout>
<minimumTimeout>1</minimumTimeout>
<maximumTimeout>300</maximumTimeout>
<resourceProxyPath>/portletresource</resourceProxyPath>
<cacheSettings>
<maxSize>10000000</maxSize>
<subscriber default="true">
<systemLevel>
<maxSize>5000000</maxSize>
</systemLevel>
<userLevel>
<maxSize>8000000</maxSize>
</userLevel>
</subscriber>
</cacheSettings>
</adf-portlet-config>

アプリケーション開発者は、アプリケーションのadf-config.xmlファイルを編集して、ポートレット・クライアント構成を編集できます。ただし、この場合は、変更後にアプリケーションの再デプロイが必要になります。アプリケーションを再デプロイせずに、実行時にポートレット・クライアントの構成を編集するには、WLSTコマンドを使用します。

WLSTコマンドのsetPortletClientConfigを使用して、ポートレット・クライアントの構成情報を編集します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のsetPortletClientConfigに関する項を参照してください。

このWLSTコマンドの使用後は、WebCenterアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

関連項目:
listPortletClientConfig、getPortletClientConfig

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

21.8 プロデューサの登録解除

プロデューサの登録はいつでも解除できますが、登録解除されたプロデューサと関連付けられたポートレットは機能しなくなるため、WebCenter Portalアプリケーションへの影響を考慮してください。ポートレット・プロデューサ呼出しのメトリックをチェックして、プロデューサの使用頻度を確認します。詳細は、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

プロデューサの登録を解除すると、登録データはWebCenter Portalアプリケーションとリモート・プロデューサの両方から削除されます。

- WebCenter Portalアプリケーション: プロデューサ接続は削除され、プロデューサのメタデータも削除されます。

- リモート・プロデューサ: (ポートレット自体ではなく)ポートレット・インスタンスが削除されます。

ポートレット・インスタンスはWebCenter Portalアプリケーション・ページから削除されません。ユーザーには、ポートレットのかわりに「ポートレットがありません」というメッセージが表示されます。

注意:
このポートレット・プロデューサに関連付けられている外部アプリケーションの目的がこのプロデューサをサポートすることのみであれば、その外部アプリケーションを削除することも考慮してください。第23.6項「外部アプリケーション接続の削除」を参照してください。

この項には次のトピックが含まれます:

- 第21.8.1項「Fusion Middleware Controlを使用したプロデューサの登録解除」

- 第21.8.2項「WLSTを使用したプロデューサの登録解除」

- 第21.8.3項「WebCenter Portalでのプロデューサの登録解除」

- 第21.8.4項「WebCenter Portal Frameworkアプリケーションでのプロデューサの登録解除」

21.8.1 Fusion Middleware Controlを使用したプロデューサの登録解除

ポートレット・プロデューサを登録解除するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalアプリケーションの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ポートレット・プロデューサ」を選択します。

4. 削除するプロデューサの名前を選択し、「削除」をクリックします。

接続の詳細が削除されます。このプロデューサに関連付けられたポートレットに、WebCenter Portalアプリケーションからアクセスできなくなります。

21.8.2 WLSTを使用したプロデューサの登録解除

次のWLSTコマンドを使用して、ポートレット・プロデューサ接続を登録解除します。

- WSRPプロデューサ - deregisterWSRPProducer

- PDK-Javaプロデューサ - deregisterPDKJavaProducer

次のWLSTコマンドを使用して、Oracle WebCenter Portalに用意されている組込みプロデューサまたはサンプルのプロデューサの登録を解除します。

- 組込みプロデューサ: deregisterOOTBProducers

- サンプルのプロデューサ: deregisterSampleProducers

コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

21.8.3 WebCenter Portalでのプロデューサの登録解除

WebCenter Portalの特定のプロデューサを使用する必要がなくなった場合には、そのプロデューサを登録解除できます。プロデューサの登録を解除すると、WebCenter Portalとリモート・プロデューサの両方から登録データが削除されます。

- WebCenter Portal - プロデューサ接続は削除され、プロデューサのメタデータも削除されます。

- リモート・プロデューサ - ポートレットのインスタンスが削除されます(ポートレット自体ではありません)。

ポートレット・プロデューサを登録解除するには:

1. WebCenter Portal管理を開きます。
詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ポートレット・プロデューサ」を選択します。
または、次のURLを使用して、「ポートレット・プロデューサ」を選択します。

http://host:port/webcenter/portal/admin/tools

3. 削除するポートレット・プロデューサを選択します。

4. メニュー・バーの「登録解除」をクリックします。

5. 「削除の確認」ダイアログで、「登録解除」をクリックして登録解除のプロセスを完了します。

21.8.4 WebCenter Portal Frameworkアプリケーションでのプロデューサの登録解除

設計時に、Portal Frameworkアプリケーションでポートレット・プロデューサを登録解除する方法の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のポートレット・プロデューサの削除方法に関する項を参照してください。

実行時に、Portal Frameworkアプリケーションでポートレット・プロデューサを登録解除する方法の詳細は、第21.9.3項「管理コンソールを使用したポートレット・プロデューサの登録解除」を参照してください。

21.9 管理コンソールを使用したポートレット・プロデューサの管理

Portal Frameworkアプリケーション内でポートレット・プロデューサを登録して管理するには、ユーザーにAppConnectionManagerロールが割り当てられている必要があります。デフォルトでは、Administratorロールを持つユーザーにAppConnectionManagerロールが割り当てられているため、アプリケーション管理者は、管理コンソールを通じてポートレット・プロデューサを構成できます。第43.4.4項「アプリケーション・ロールおよび権限の管理」も参照してください。

ポートレット・プロデューサを登録すると、そのプロデューサが所有するすべてのポートレットは、アプリケーションのリソース・カタログを通じて自動的に使用可能になります。一度登録されると、編集ページの適切な権限を持つユーザーは、そのプロデューサのポートレットを自分のページに追加できるようになります。アクセスする必要がある特定のポートレットがリソース・カタログ内に見つからない場合は、それに関連付けられたプロデューサの登録を管理者に依頼します。

この項の内容は次のとおりです。

- 第21.9.1項「管理コンソールを使用したポートレット・プロデューサの登録」

- 第21.9.2項「管理コンソールを使用したポートレット・プロデューサの登録情報の編集」

- 第21.9.3項「管理コンソールを使用したポートレット・プロデューサの登録解除」

注意:
システム管理者は、Fusion Middleware ControlとWLSTコマンドを使用して、Portal Frameworkアプリケーションのポートレット・プロデューサを登録することもできます。詳細は、第21.2項「WSRPプロデューサの登録」を参照してください。

21.9.1 管理コンソールを使用したポートレット・プロデューサの登録

実行時に、Portal Frameworkアプリケーションのポートレット・プロデューサを登録するには:

1. 管理コンソールの「サービス」タブを開きます。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」も参照してください。

2. 左側にあるナビゲーション・パネルで、「ポートレット・プロデューサ」をクリックします(図21-1)。

図21-1 管理コンソール: ポートレット・プロデューサ

3. メニュー・バーの「登録」をクリックします。

4. ポートレット・プロデューサの接続の詳細を入力します。
1つ以上のフィールドの詳細は、次の表を参照してください。

WSRPプロデューサ

- 表21-2「WSRPプロデューサの接続パラメータ」

- 表21-6「WSRPポートレット・プロデューサの登録: セキュリティ」

Oracle PDK Javaプロデューサ

- 表21-7「Oracle PDK-Javaプロデューサの接続パラメータ」

5. 「テスト」をクリックして、接続の詳細を検証します。

6. 「OK」をクリックして、ポートレット・プロデューサを登録します。

21.9.2 管理コンソールを使用したポートレット・プロデューサの登録情報の編集

実行時に、Portal Frameworkアプリケーションのポートレット・プロデューサを変更するには:

1. 管理コンソールの「サービス」タブを開きます。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」も参照してください。

2. 左側にあるナビゲーション・パネルで、「ポートレット・プロデューサ」をクリックします(図21-1)。

3. 必要なポートレット・プロデューサを選択してから、メニュー・バーの「編集」をクリックして、その接続の詳細を更新します。

4. プロデューサ登録のプロパティを必要に応じて編集します。

- WSRPプロデューサ

- 表21-2「WSRPプロデューサの接続パラメータ」

- 表21-6「WSRPポートレット・プロデューサの登録: セキュリティ」

- Oracle PDK-Javaプロデューサ

- 表21-7「Oracle PDK-Javaプロデューサの接続パラメータ」

「プロデューサ名」または「プロデューサ・タイプ」は編集できません。

5. 「テスト」をクリックして、修正した接続の詳細を検証します。

6. 「OK」をクリックして、変更を保存します。

21.9.3 管理コンソールを使用したポートレット・プロデューサの登録解除

実行時に、Portal Frameworkアプリケーションのポートレット・プロデューサを削除するには:

1. 管理コンソールの「サービス」タブを開きます。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」も参照してください。

2. 左側にあるナビゲーション・パネルで、「ポートレット・プロデューサ」をクリックします(図21-1)。

3. 必要なポートレット・プロデューサを選択してから、メニュー・バーの「登録解除」をクリックして、プロデューサを登録解除します。
これにより、登録データがPortal Frameworkアプリケーションとリモート・プロデューサの両方から削除されます。

登録を解除しても、Portal Frameworkアプリケーション・ページからポートレットのインスタンスは削除されません。ユーザーには、ポートレットのかわりに「ポートレットがありません」というメッセージが表示されます。

このポートレット・プロデューサに関連付けられている外部アプリケーションの目的がこのプロデューサをサポートすることのみであれば、その外部アプリケーションを削除することも考慮してください。第23.4.2項「外部アプリケーションの編集と削除」を参照してください。

4. 「削除の確認」ダイアログで、「登録解除」をクリックして登録解除のプロセスを完了します。

21.10 プロデューサの登録タスク・フローでの作業

プロデューサの登録タスク・フローでポートレット・プロデューサを管理するには、次に示すロールと権限が必要になります。

- AppConnectionManagerロール - ポートレット・プロデューサを管理できます。

- View Page権限 - タスク・フローを含んでいるページにアクセスできます。

この項には次のトピックが含まれます:

- 第21.10.1項「プロデューサの登録タスク・フローのページへの追加」

- 第21.10.2項「プロデューサの登録タスク・フローを使用したポートレット・プロデューサの登録」

- 第21.10.3項「プロデューサの登録タスク・フローのプロパティの設定」

21.10.1 プロデューサの登録タスク・フローのページへの追加

プロデューサの登録タスク・フローを追加するには:

1. タスク・フローを追加するページに移動して、そのページをコンポーザで開きます。
詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・エディタ(コンポーザ)でページを開く方法に関する項を参照してください。

2. コンポーザで、「コンテンツの追加」ボタンをクリックします。

3. 「コンテンツの追加」ダイアログで、「UIコンポーネント」→「ポートレット」を開きます。

4. 「ポートレット」フォルダで、「ポートレット管理」を開きます。

5. 「ポートレット管理」フォルダで、「プロデューサの登録」タスク・フローの横にある「追加」リンクをクリックします。これにより、ページにタスク・フローが追加されます。

6. 「閉じる」をクリックして、「コンテンツの追加」ダイアログを終了します。

21.10.2 プロデューサの登録タスク・フローを使用したポートレット・プロデューサの登録

ページにプロデューサの登録タスク・フローを追加しておくと、次の表で説明するように、任意のポートレット・プロデューサを追加できるようになります。

- WSRPプロデューサ

- 表21-2「WSRPプロデューサの接続パラメータ」

- 表21-6「WSRPポートレット・プロデューサの登録: セキュリティ」

- Oracle PDK-Javaプロデューサ

- 表21-7「Oracle PDK-Javaプロデューサの接続パラメータ」

第21.6.3項「WebCenter Portalでのプロデューサの登録情報の編集」および第21.8.3項「WebCenter Portalでのプロデューサの登録解除」も参照してください。

21.10.3 プロデューサの登録タスク・フローのプロパティの設定

プロデューサの登録タスク・フローには関連するプロパティがあり、十分な権限を持つユーザーは、コンポーザの「コンポーネント・プロパティ」ダイアログから、これらのプロパティにアクセスできます(図21-2)。

タスク・フローのプロパティと、それらのプロパティへのアクセス方法の詳細は、『Oracle WebCenter Portalでのポータルの構築』のコンポーネントの変更に関する項を参照してください。

図21-2 プロデューサの登録タスク・フローの「コンポーネント・プロパティ」

21.11 ポートレット・プロデューサ・アプリケーションのデプロイ

Oracle WebLogic管理対象サーバー・インスタンスにポートレット・プロデューサをデプロイするために、Fusion Middleware Control、Oracle WebLogic Server管理コンソールまたはWLSTを使用できます。

この項には次のトピックが含まれます:

- 第21.11.1項「ポートレット・プロデューサ・アプリケーションのデプロイの理解」

- 第21.11.2項「ポートレット・プロデューサ・アプリケーションのデプロイの準備」

- 第21.11.3項「Fusion Middleware Controlを使用したポートレット・プロデューサ・アプリケーションのデプロイ」

- 第21.11.4項「Oracle WebLogic Server管理コンソールを使用したポートレット・プロデューサ・アプリケーションのデプロイ」

- 第21.11.5項「WLSTを使用したポートレット・プロデューサ・アプリケーションのデプロイ」

- 第21.11.6項「Oracle JDeveloperを使用したポートレット・プロデューサ・アプリケーションのデプロイ」

アプリケーションのデプロイの詳細は、管理者ガイドの「アプリケーションのデプロイ」を参照してください。

21.11.1 ポートレット・プロデューサ・アプリケーションのデプロイの理解

ポートレット・プロデューサ・アプリケーションは、WebCenter Portalポートレット・プロデューサをサポートするように構成されたOracle WebLogic管理対象サーバーにデプロイできます。アプリケーションを管理対象サーバーにデプロイするには、Oracle Enterprise Manager Fusion Middleware Control、Oracle WebLogic管理コンソールまたはWLSTを使用できます。これらの管理ツールの詳細は、第1.13項「Oracle WebCenter Portalの管理ツール」を参照してください。

21.11.2 ポートレット・プロデューサ・アプリケーションのデプロイの準備

WebCenter Portalには、必要な構成をポートレット・プロデューサ・アプリケーションのEARファイルに追加し、WSRP上でポートレットを公開する事前デプロイ・ツールがあります。事前デプロイ・ツールは、次の状況で実行する必要があります。

- JDeveloper外でアプリケーションのWARファイルを作成した。

- JDeveloperでアプリケーションのWARファイルを作成したが、WSRPアプリケーションとしてアプリケーションを公開しないことを選択した。つまり、「デプロイメント・タイプの選択」ダイアログで「いいえ」を選択した。

必要な構成をポートレット・プロデューサ・アプリケーションのEARファイルに追加し、WSRP上でポートレットを公開するには、次のようにMiddlewareディレクトリWCP_ORACLE_HOME/webcenter/modules/oracle.portlet.server_11.1.1にあるWSRPプロデューサ事前デプロイ・ツールを実行します。

java -jar wsrp-predeploy.jar source EAR  target EAR

サーブレットv2.3でデプロイされたJSR 286ポートレットの場合、次のコマンドを使用してWebプロキシを指定する必要があります。

java -Dhttp.proxyHost=proxy host -Dhttp.proxyPort=proxy port -jar
wsrp-predeploy.jar source EAR target EAR

ここで:

- proxy hostは、プロデューサがデプロイされているサーバーです。

- proxy portは、HTTPリスナーのポートです。

- wsrp-predeploy.jarは、WCP_ORACLE_HOME/webcenter/modules/oracle.portlet.server_11.1.1ディレクトリにあります。

- source EARは、JSR 286 EARファイルの名前です。

- target EARファイルは、新規に作成されるEARファイルの名前です。ターゲットのEARファイルに名前が指定されていない場合、WSRP-source EARという名前の新しいEARファイルが作成されます。

次の例ではWebプロキシが指定されます。

java -Dhttp.proxyHost=myhttpproxy.com -Dhttp.proxyPort=80 -jar wsrp-predeploy.jar wsrp-samples.ear

この例ではWSRP-wsrp-samples.earが作成されます。

wsrp-predeploy.jar事前デプロイ・ツールは、Oracleポートレット・コンテナへのデプロイを可能にするために必要なすべての変更をJSR 286ポートレットに実施し、それをWSRPプロデューサとして公開します。事前デプロイ・ツールが実行する処理の例を次に示します。

- java.io.tmpdirフォルダにwsdldeployディレクトリを作成します。

- UNIXでは、このプロパティのデフォルト値は/tmpまたは/var/tmpです。

- Microsoft Windowsでは、このプロパティのデフォルト値はc:\tempです。

- EARファイルをwsdldeploy/EARに解凍します。

- WARファイルをwsdldeploy/[warfilename.war]/に解凍します。

- 解凍したアプリケーションにWEB-INF/WSDLsを挿入します。

- 解凍したWARファイルのWEB-INF/web.xmlを修正します。

- WARファイルにWEB-INF/webservices.xmlを挿入するか修正します。

- WARファイルにWEB-INF/oracle-webservices.xmlを挿入するか修正します。

- WARファイルを再度パッケージ化し、新しいEARファイルを作成します。

21.11.3 Fusion Middleware Controlを使用したポートレット・プロデューサ・アプリケーションのデプロイ

Fusion Middleware Controlを使用したポートレット・プロデューサ・アプリケーションのデプロイの詳細は、第42.1.6.4項「Fusion Middleware Controlを使用したアプリケーションのデプロイ」を参照してください。

21.11.4 Oracle WebLogic Server管理コンソールを使用したポートレット・プロデューサ・アプリケーションのデプロイ

Oracle WebLogic Server管理コンソールを使用したポートレット・プロデューサ・アプリケーションのデプロイの詳細は、第42.1.6.6項「WLS管理コンソールを使用したアプリケーションのデプロイ」を参照してください。

21.11.5 WLSTを使用したポートレット・プロデューサ・アプリケーションのデプロイ

WLSTコマンドを使用したポートレット・アプリケーションのデプロイの詳細は、第42.1.6.5項「WLSTを使用したアプリケーションのデプロイ」を参照してください。

21.11.6 Oracle JDeveloperを使用したポートレット・プロデューサ・アプリケーションのデプロイ

WebLogicサーバーへのアクセスに必要な資格証明がある場合は、Oracle JDeveloperを使用してポートレット・アプリケーションを開発環境からOracle WebLogic管理対象サーバー・インスタンスに直接デプロイできます。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のポートレット・プロデューサのデプロイに関する項を参照してください。

21.12 WebCenterサービス・ポートレットの構成

WebCenter Portalは、ツールとサービスを使用して、ソーシャル・ネットワーキングおよび個人生産性の機能を提供します。これらはタスク・フローを使用して、それらの機能のサブセットを公開します。これらのタスク フローは、WebCenter Portalと、その他のPortal Frameworkアプリケーションで利用できます。ただし、その他の製品(たとえば、Oracle Portal、Oracle WebLogic PortalおよびOracle WebCenter Interaction)を使用するアプリケーション開発者は、これらの同じ機能をアプリケーション内で公開することもあります。

WebCenterサービス・ポートレットは、製品に付属する事前構成済プロデューサです。これにより、WebCenter Portalのツールとサービスのタスク・フローをWSRPポートレットまたはページレットとして他のアプリケーションに公開できます。

次のタスク・フローは、WebCenterサービス・ポートレットによりポートレットとして提供されます。

- ドキュメント・マネージャ - WebCenterコンテンツ・リポジトリからフォルダ、ファイルおよびWikiを表示します。

- ブログ - WebCenterコンテンツ・リポジトリで選択位置からブログ・ポストを表示します。

- ディスカッション・フォーラム - すべてのディスカッションとそれぞれの応答を表示し、ユーザーにそれぞれの権限に応じた多様な操作を可能にします。

- お知らせ - 現在のすべてのお知らせを表示し、ユーザーにそれぞれの権限に応じた多様な操作を可能にします。

- リスト - ユーザーによって作成されたリストを表示し、リストの作成やリスト・データの追加のためのコントロールを提供します。

- 投票マネージャ - ユーザーは投票に関する管理操作を実行できます。

- 投票の実施 - 最近公開された投票、または投票されたパラメータによって識別された特定の投票を表示します。

- メール - メール受信箱を表示します。

- アクティビティ・ストリーム - ユーザーの接続によって実行された最近のアクティビティの概要を示します。

- タグ・クラウド - ページで使用されるすべてのタグの視覚表現であるタグ・クラウドを表示します。

WebCenterサービス・ポートレットは、Portal Frameworkアプリケーションとして開始されます。このアプリケーションは複数のページで構成され、それぞれのページが公開されたタスク・フローに対応しています。次にアプリケーションは、Oracle JSF Portlet Bridgeを使用してポートレット化され、WC_Portlet管理対象サーバーにデプロイされます。

WebCenter Portalのインストール後、WebCenterサービス・ポートレットが自動的に使用可能になります。ただし、ポートレットやページレットが正しく動作するには、実行が必要な構成手順があります。

この項には次のトピックが含まれます:

- 第21.12.1項「バックエンド接続の構成」

- 第21.12.2項「WebCenterサービス・ポートレットのセキュリティの構成」

- 第21.12.3項「WebCenterサービス・ポートレットのトラブルシューティング」

21.12.1 バックエンド接続の構成

WebCenterサービス・ポートレットに含まれるほとんどのツールとサービスでは、完全に機能するためにバックエンド・サーバーとの接続が必要です。たとえば、ドキュメントではOracle WebCenter Contentリポジトリとの接続、ディスカッションおよびお知らせではOracle WebCenter Portalのディスカッション・サーバーとの接続が必要です。アプリケーション開発者がプロデューサによって提供されるポートレットやページレットの利用を開始する前に、これらの接続を構成する必要があります。

この項には次のトピックが含まれます:

- 第21.12.1.1項「ドキュメントのコンテンツ・リポジトリ接続の構成」

- 第21.12.1.2項「ディスカッションおよびお知らせ接続の構成」

- 第21.12.1.3項「メール接続の構成」

21.12.1.1 ドキュメントのコンテンツ・リポジトリ接続の構成

WebCenterサービス・ポートレットには、ドキュメント、ブログおよびWikiによって提供されるタスク・フローのポートレットが含まれます。これらのポートレットには、バックエンドのWebCenterコンテンツ・リポジトリとの接続が必要です。

WebCenter Contentの構成の詳細は、第9章「コンテンツ・リポジトリの管理」を参照してください。

WebCenterコンテンツ・リポジトリとの接続を作成する方法は2つあります。

- Fusion Middleware Controlを使用します。詳細は、第9.6.2項「Fusion Middleware Controlを使用したコンテンツ・リポジトリの登録」を参照してください。

- WLSTコマンド行ツールを使用します。詳細は、第9.6.3項「WLSTを使用したコンテンツ・リポジトリの登録」を参照してください。

注意:
WebCenterサービス・ポートレットは、アクティブまたはデフォルトの接続として識別されたWebCenterコンテンツ・リポジトリを使用します。このため、デフォルトとして適切な接続が設定されている必要があります。詳細は、第9.7項「アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」を参照してください。

21.12.1.2 ディスカッションおよびお知らせ接続の構成

WebCenterサービス・ポートレットには、ディスカッションおよびお知らせによって提供されるタスク・フローのポートレットが含まれます。これらのタスク・フローでは、Oracle WebCenter Portalのバックエンド・ディスカッション・サーバーとの接続が必要です。ディスカッションとお知らせは、同一の接続を使用します。Oracle WebCenter Portalのディスカッション・サーバーは、Oracle Fusion Middlewareとともに自動的にインストールされますが、サーバーとの接続は作成する必要があります。

ディスカッションとお知らせの構成の詳細は、第12章「お知らせおよびディスカッションの管理」を参照してください。

Oracle WebCenter Portalディスカッション・サーバーとの接続を作成する方法は2つあります。

- Fusion Middleware Controlを使用します。詳細は、第12.3.1項「Fusion Middleware Controlを使用したディスカッション・サーバーの登録」を参照してください。

- WLSTコマンド行ツールを使用します。詳細は、第12.3.2項「WLSTを使用したディスカッション・サーバーの登録」を参照してください。

注意:
WebCenterサービス・ポートレットは、アクティブまたはデフォルトの接続として識別されたディスカッション・サーバーを使用します。このため、デフォルトとして適切な接続が設定されている必要があります。詳細は、第12.4項「ディスカッションおよびお知らせ用のアクティブな接続の選択」を参照してください。

21.12.1.3 メール接続の構成

WebCenterサービス・ポートレットには、メール・タスク・フローのポートレットが含まれます。メールでは、バックエンド・メール・サーバーとの接続が必要です。このサーバーでは、Microsoft Exchange Serverや、IMAP4およびSMTPをサポートするメール・サーバーをサポートしています。

メールの構成の詳細は、第15章「メールの管理」を参照してください。

メール・サーバーとの接続を作成する方法は2つあります。

- Fusion Middleware Controlを使用します。詳細は、第15.4.1項「Fusion Middleware Controlを使用したメール・サーバーの登録」を参照してください。

- WLSTコマンド行ツールを使用します。詳細は、第15.4.2項「WLSTを使用したメール・サーバーの登録」を参照してください。

注意:
WebCenterサービス・ポートレットは、アクティブまたはデフォルトの接続として識別されたメール・サーバーを使用します。このため、デフォルトとして適切な接続が設定されている必要があります。詳細は、第15.5項「アクティブな(またはデフォルトの)メール・サーバー接続の選択」を参照してください。

21.12.2 WebCenterサービス・ポートレットのセキュリティの構成

WebCenterサービス・ポートレットは、アクセス権限を持たない情報にユーザーがアクセスできないようにして保護する必要があります。WSRPプロデューサとして、WebCenterサービス・ポートレットはWS-Securityを使用してアイデンティティ伝播を保証します。

WSRPポートレット・プロデューサにWS-Securityを構成する方法の詳細は、第37.1項「WSRPプロデューサの保護」を参照してください。

注意:
必要なセキュリティ・ポリシーを添付した後で、WC_Portlet管理対象サーバーを再起動する必要があります。

21.12.3 WebCenterサービス・ポートレットのトラブルシューティング

この項には次のトピックが含まれます:

- 第21.12.3.1項「ドキュメント・マネージャおよびブログ・ポートレットでリッチ・テキスト・エディタが機能しない」

- 第21.12.3.2項「リスト・ポートレットのリストを管理できない」

- 第21.12.3.3項「ポートレットのタイム・ゾーンまたは日付および時間形式が正しくない」

- 第21.12.3.4項「ポートレットにリモート・ポートレット通信エラーが表示される」

21.12.3.1 ドキュメント・マネージャおよびブログ・ポートレットでリッチ・テキスト・エディタが機能しない

ブログとWikiは、実行時に、多様なリソースにアクセスする必要があるリッチ・テキスト・エディタ(CKEditor)を使用します。

WebCenterサービス・ポートレット・プロデューサがファイアウォールの背後にあり、エンドユーザーがそれを超えることができないと、CKEditorが必要とするリソースのURLにアクセスできないため、エディタはWikiを表示するドキュメント・マネージャ・ポートレットやブログ・ポートレットで表示できません。

この問題を解決する手順は次のとおりです。

1. CKEditorリソースを含むアプリケーションを作成します(たとえば、WebCenter Portal Frameworkアプリケーション・テンプレートを使用します)。

2. WebCenterサービス・ポートレットを利用するアプリケーションによって使用される同じサーバーにアプリケーションをデプロイします。

3. WebCenterサービス・ポートレット・プロデューサ・アプリケーションを実行します。

4. 管理コンソールで、「ベース・リソースURL」を編集し、新しいアプリケーションをポイントするようにします。
この方法の詳細は、第43.3.5項「デフォルト・ベース・リソースURLの選択」を参照してください。

5. コンシューマ・アプリケーションを表示するブラウザをリフレッシュします。CKEditorリソースがコンシューマ・アプリケーションと同じ側のファイアウォールで利用できるため、リッチ・テキスト・エディタが正しく表示されます。

21.12.3.2 リスト・ポートレットのリストを管理できない

初期状態では、Administratorロールのメンバーであるユーザーのみが、リストの作成、編集および削除と、リスト・データの編集を行えます。Administratorロールのメンバー以外のユーザーは、リストの表示のみが可能です。

Administratorロールのメンバー以外のユーザーにリストの管理を可能にするには、Fusion Middleware Controlを使用してユーザーにListPermissionロールに対するmanage権限を割り当てます。

<permission>
<class>oracle.webcenter.list.model.security.ListPermission</class>
<name>/oracle/webcenter/list/templates/lists/.*</name>
<actions>manage</actions>
</permission>

1. Fusion Middleware Controlの「アプリケーション・デプロイメント」の下で、「services-producer」アプリケーションを右クリックして、コンテキスト・メニューから「セキュリティ」→「アプリケーション・ポリシー」を選択します。

2. 「作成」をクリックします。

3. 「権限受領者」セクションで「追加」をクリックします。

4. 「プリンシパルの追加」ダイアログでリスト権限を付与するユーザーまたはロールを見つけます。

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

6. 「権限」セクションで「追加」をクリックします。

7. 「権限の追加」ダイアログの「権限クラス」ドロップダウン・リストから、「oracle.webcenter.list.model.security.ListPermission」を選択します。

8. 「システム・セキュリティ権限の検索」アイコンをクリックします。

9. 「検索結果」セクションでmanage権限アクションを持つ「リソース名」を選択します。

10. 「続行」をクリックします。

11. 確認ダイアログで、「選択」をクリックして、ターゲット・ユーザーまたはロールの権限を確認します。

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

21.12.3.3 ポートレットのタイム・ゾーンまたは日付および時間形式が正しくない

現時点では、ユーザー・プリファレンスはポートレット・コンシューマからWebCenterサービス・ポートレット・プロデューサに伝播されません。つまり、コンシューマ・アプリケーションでのユーザー設定に関する指定とは無関係に、WebCenterサービス・ポートレットは常に、プロデューサがデプロイされているサーバーで設定されたタイム・ゾーンおよび日付時間形式を使用します。

21.12.3.4 ポートレットにリモート・ポートレット通信エラーが表示される

WebCenterサービス・ポートレットによって提供されるポートレットにリモート・ポートレット通信エラーが表示される場合は、一般に、WS-Securityがプロデューサに構成されていないことが原因と考えられます。

この問題を解決する方法の詳細は、第21.12.2項「WebCenterサービス・ポートレットのセキュリティの構成」を参照してください。

21.13 ポートレット・プロデューサ問題のトラブルシューティング

この項には次のサブセクションが含まれます:

- 第21.13.1項「WebCenter Portal Frameworkアプリケーションにプロデューサを登録できない」

- 第21.13.2項「ポートレットを使用できない: 例外WSM-00101」

21.13.1 WebCenter Portal Frameworkアプリケーションにプロデューサを登録できない

この項では、プロデューサの登録とポートレットが使用できない問題について説明します。

問題

WSRPプロデューサを登録できません。

解決策

次のことを確認します。

- バックエンド・プロデューサが起動され実行されている。プロデューサをテストするには、ブラウザ・ウィンドウでプロデューサのWSDL URLにアクセスします。第21.3項「WSRPプロデューサの接続テスト」を参照してください。

- プロデューサ・アプリケーションが正しくパッケージ化されている。そうでない場合、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のWebCenter Portal Frameworkアプリケーションでのポートレット・プロデューサの登録に関する項の説明に従って、JDeveloperで設計時にプロデューサを登録してから、第42.1項「Portal Frameworkアプリケーションのデプロイ」の説明に従って、アプリケーションを再度デプロイしてください。再度デプロイした後、パッケージ・アプリケーションにMBean ProducerManagerが含まれていることを確認します。

1. Fusion Middleware Controlで、「アプリケーション・デプロイメント」メニューから、「システムMBeanブラウザ」を選択します。

2. ナビゲータで「アプリケーション定義のMBean」→「oracle.webcenter.portlet」→「アプリケーション: application_name」→「プロデューサ・マネージャ」→「プロデューサ・マネージャ」の順に開きます。

- PortletServletContextListenerがweb.xmlファイルに追加されます。
デプロイ後登録のプロデューサをサポートするアプリケーションに対して、プロデューサを設計時に1回以上登録する必要があります。これによりPortletServletContextListenerがweb.xmlファイルに追加され、適切なランタイムMBeansを登録し、デプロイ後登録のプロデューサが可能になります。たとえば、次のweb.xmlスニペットで太字になっているテキストを参照してください。

<listener>
<description>
WebCenter Portlet Context Listener
</description>
<display-name>
WebCenterPortletContextListener
</display-name>
<listener-class>
oracle.webcenter.portlet.listener.PortletServletContextListener
</listener-class>
</listener>

21.13.2 ポートレットを使用できない: 例外WSM-00101

WSRPポートレット・プロデューサのユーザー名(パスワードあり)トークン・プロファイルを設定すると、例外WSM-00101が発生します。

問題

Fusion Middleware Control (またはWLST)を使用してWSRPプロデューサのユーザー名(パスワード・トークンあり)プロファイルを設定するとき、そのプロデューサと関連付けられたポートレットが使用中の場合、WebCenter Portalアプリケーションに次の例外が表示されます。

oracle.wsm.common.sdk.WSMException: WSM-00101:
The specified Keystore file
/keys/user_projects/domains/pv_0309/config/fmwconfig/default-keystore.jks
cannot be found; it either does not exist or its path is not included in the application classpath.

解決策

ポートレット・プロデューサにデフォルトのキーストアが構成されていることを確認します。詳細は、第37.1.3項「キーストアの設定」を参照してください。

22 ページレット・プロデューサの管理

Oracle WebCenter Portalのページレット・プロデューサは(以前はOracle WebCenter Ensembleと呼ばれていました)、ページレットの動的な開発とデプロイに役立つ有用なツールのセットを提供します。ページレット・プロデューサのプロキシは、内部のアプリケーションや保護されたコンテンツを含む内部リソースへの外部アクセスをユーザーに提供します。ページレット・プロデューサを使用すれば、WSRPおよびOracle JPDKポートレットとOpenSocialガジェットを、Webページまたはアプリケーションで使用できるようにページレットとして公開できます。

この章では、ページレット・プロデューサの管理コンソールを使用してページレットを登録、編集およびデプロイする方法について説明します。

この章には次の項が含まれます:

- 第22.1項「ページレット・プロデューサについて」

- 第22.2項「ページレット・プロデューサの登録」

- 第22.3項「WSRPおよびOracle JPDKポートレット・プロデューサのページレット・プロデューサへの登録」

- 第22.4項「トラスト・サービス・アイデンティティ・アサータの構成」

- 第22.5項「ページレット・プロデューサ・コンポーネントのインポート、エクスポート、バックアップおよびリカバリの管理」

ページレットの開発とデプロイの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のページレット・プロデューサを使用したページレットの作成に関する項を参照してください。

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

22.1 ページレット・プロデューサについて

この項では、ページレット・プロデューサの概念と機能について概説します。この項の内容は次のとおりです。

- 第22.1.1項「概要」

- 第22.1.2項「ページレット・プロデューサ・コンソールの使用」

- 第22.1.3項「WSRPおよびOracle JPDKポートレットの公開」

- 第22.1.4項「OpenSocialガジェットの公開」

- 第22.1.5項「Oracle WebCenter Interactionポートレットの公開」

22.1.1 概要

Oracle WebCenter Portalのページレット・プロデューサ(旧称: Oracle WebCenter Ensemble)では、ページレットを作成して、WebCenter PortalおよびFrameworkアプリケーションなどの他のWeb環境で、プラットフォーム固有のポートレットを公開するために使用できます。ページレット・プロデューサは、動的ページレットの開発を容易にする有用なツールと機能の集まりを提供します。ページレット・プロデューサのアーキテクチャ、コンポーネントの説明およびページレット・プロデューサの要件の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のページレット・プロデューサの概要に関する項を参照してください。

ページレット・プロデューサの登録は動的です。既存のプロデューサに対する追加と更新はすぐに使用可能になります。ほとんどの場合、アプリケーション(WebCenter Portalまたは自分のPortal Frameworkアプリケーション)や管理対象サーバーを再起動する必要はありません。

注意:
現在のリリースでは、ページレット・プロデューサの管理設定を変更できるのは一度に1人の管理者のみです。同時に複数の編集が行われた場合、1つの編集のみが成功します。ただし、データの整合性は常に保持されます。

22.1.2 ページレット・プロデューサ・コンソールの使用

ページレット・プロデューサ・コンソールは、ページレット・プロデューサのデプロイで様々なオブジェクトの作成と管理に使用されるブラウザ・ベース管理ツールです。このコンソールから、Webアプリケーションをリソースとして登録する、ページレットを作成する、プロキシと変換の設定を管理するなどの操作を実行できます。

- ページレット・プロデューサ・コンソールには、WebCenter Portalの「共有アセット」タブからアクセスできます。

注意:
ページレット・プロデューサ・コンソールでは、標準の管理言語とオランダ語のみがサポートされています。これらの言語以外をブラウザの言語に構成すると、現在のサーバーに定義された言語に戻ります。

- ページレット・プロデューサ・コンソールには、Webブラウザで次のURLを指定してアクセスすることもできます:
http://<host>:<port>/pagelets/admin

ページレット・プロデューサ・コンソールは、次の場所からアクセシビリティ・モードで起動することもできます:

http://<host>:<port>/pagelets/admin/accessible

ページレット・プロデューサ・コンソールを使用したページレット・プロデューサの構成の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のページレット・プロデューサの設定の構成に関する項を参照してください。

22.1.3 WSRPおよびOracle JPDKポートレットの公開

ページレット・プロデューサを使用すれば、WSRPおよびOracle JPDKポートレットを、Webページまたはアプリケーションで使用できるようにページレットとして公開できます。

第22.2項「ページレット・プロデューサの登録」の説明に従ってページレット・プロデューサを設定した後、次の手順に従ってWSRPまたはOracle JPDKポートレットをインポートします。

1. 第22.3項「WSRPおよびOracle JPDKポートレット・プロデューサのページレット・プロデューサへの登録」の説明に従って、ポートレット・プロデューサをページレット・プロデューサに登録します。

2. これにより、プロデューサのポートレット定義に基づいて、ページレット・プロデューサ・コンソールにリソースとページレットが自動的に作成されます。リソースの設定の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のページレット・プロデューサを使用したページレットの作成に関する項を参照してください。

3. インポートしたリソースや関連付けられたページレットを変更するには、インポートしたリソースをコピーする必要があります。詳細は、第22.3.1項「WSRPおよびOracle JPDKポートレットの使用」を参照してください。

22.1.4 OpenSocialガジェットの公開

ページレット・プロデューサを使用すれば、OpenSocialガジェットをWebページまたはアプリケーションで使用できるようにページレットとして公開できます。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のOpenSocialガジェットの使用に関する項を参照してください。

22.1.5 Oracle WebCenter Interactionポートレットの公開

ページレット・プロデューサを、Oracle WebCenter Interaction用のポートレット・プロバイダとして使用できます。いくつかの構成ページで、Oracle WebCenter Interactionと連携するためのCSP設定を定義できます。これらの設定およびオブジェクトの構成の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のページレット・プロデューサを使用したページレットの作成に関する項を参照してください。

1. ページレット・プロデューサ・コンソールの「CSP設定」ページでページレット・プロデューサの設定を構成して、Oracle WebCenter Interactionの資格証明マッパー、SOAP APIサービスおよびイメージ・サービスとともに使用できるようにします。

2. CSPリソースを作成して、ポートレット・コードをホストするサーバーへのページレット・プロデューサ接続を設定します。

3. Oracle WebCenter Interactionポートレット用のページレットを作成します。

22.2 ページレット・プロデューサの登録

この項では、Fusion Middleware ControlとWLSTコマンドを使用してページレット・プロデューサを登録および構成する方法について説明します。この項には次のサブセクションが含まれます:

- 第22.2.1項「Fusion Middleware Controlを使用したページレット・プロデューサの登録」

- 第22.2.2項「WLSTを使用したページレット・プロデューサの登録」

- 第22.2.3項「WebCenter Portal用のページレット・プロデューサ・サービスの構成」

- 第22.2.4項「WebCenter Portalを使用したページレット・プロデューサの登録」

- 第22.2.5項「ページレット・プロデューサの別のコンテキストへの再デプロイ」

ページレットの開発とデプロイの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のページレット・プロデューサを使用したページレットの作成に関する項を参照してください。

22.2.1 Fusion Middleware Controlを使用したページレット・プロデューサの登録

Fusion Middleware Controlを使用してページレット・プロデューサを登録するには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「プロデューサの登録」を選択します。

- Frameworkアプリケーションの場合: 「アプリケーション・デプロイメント」メニューから、「WebCenterポータル」→「プロデューサの登録」を選択します。

3. ページレット・プロデューサの接続の詳細を入力します(表22-1)。

表22-1 ページレット・プロデューサの接続パラメータ

フィールド

説明

接続名

このページレット・プロデューサのインスタンスをアプリケーション内で識別するための一意の名前。名前は、すべてのWebCenter Portal接続タイプにおいて一意である必要があります。ここで指定した名前は、「マッシュアップ」→「ページレット・プロデューサ」フォルダにあるコンポーザに表示されます(デフォルト)。

プロデューサ・タイプ

「ページレット・プロデューサ」を選択します。

サーバーURL

ページレット・プロデューサへのURL。このURLは完全修飾ドメイン名を含んでいる必要があります。次の構文を使用します。

<protocol>://<host_name>:<port_number>/pagelets/

例:

http://myhost.com:7778/pagelets/

ページレットにセキュアなデータが含まれている場合、登録するURLでhttpsプロトコルを使用する必要があります。例:

https://myhost.com:7779/pagelets/

コンテキスト・ルートは、必要に応じて/pagelets/から変更できます。詳細は、第22.2.5項「ページレット・プロデューサの別のコンテキストへの再デプロイ」を参照してください。

注意: WebCenter Portalでは、ページレット・プロデューサのURLがOAMによって保護されている場合、ページレット・カタログへのURLを除外する(アクセス制御なしで直接マップする)必要があります。そうしないと、RESTを使用した場合にカタログが空白になります。ページレット・カタログのURLは、http://<host_name>:<port_number>/ pagelets/api/v2/ensemble/pageletsです。

4. 「OK」をクリックします。新しいプロデューサが接続表に表示されます。

22.2.2 WLSTを使用したページレット・プロデューサの登録

registerPageletProducerコマンドを使用して、ページレット・プロデューサをポータルまたはFrameworkアプリケーション用に登録します。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のregisterPageletProducerに関する項を参照してください。

WLSTを使用して、現在の接続詳細を表示または編集することもできます。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

22.2.3 WebCenter Portal用のページレット・プロデューサ・サービスの構成

この項では、Oracle構成ウィザードを使用して、ページレット・プロデューサをOracle WebCenter Portalでサービスとして使用できるように設定する方法について説明します。

ページレット・プロデューサをWebCenter Portalのサービスとして設定する手順は、次のとおりです。

1. 「Oracle Fusion Middleware」→「Oracle WebLogic Server」→「ツール」→「構成ウィザード」を選択して、構成ウィザードを起動します。

2. 「新しいWebLogicドメインの作成」を選択して、「次へ」をクリックします。

3. 「既存のテンプレートを、このドメインのベースにする」を選択し、ページレット・プロデューサ・ドメイン・テンプレートを選択します。そのテンプレートの場所が正しいことを確認し、「次へ」をクリックします。

4. ドメイン構成ウィザードを完了します。詳細は、オンライン・ヘルプを参照してください。

すべてのデプロイメント後の接続構成は、Oracle Metadata Services (MDS)リポジトリに格納されます。詳細は、第1.3.5項「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。MDSの詳細は、『管理者ガイド』の「MDSリポジトリの管理」の章を参照してください。

ページレット・プロデューサでは、すべての構成データがRCUのMDSスキーマの個別パーティションに保存されます。通常、このスキーマはOracle WebCenter Portalインストールの一環としてインストールされます。この構成データは、他のサービスに属するデータとは競合しません。ページレット・プロデューサ・ドメイン・テンプレートがデプロイされると、そのスキーマが作成されたデータベースへの接続に関する情報をウィザードで入力するよう求められます。ページレット・プロデューサで想定されている名前は次のとおりです。

- データ・ソース名: mds-PageletProducerDS

- JNDI名: jdbc/mds/PageletProducerDS

- MDSパーティション名: pageletproducer

OpenSocialガジェットをWebCenter Portalのプロファイルおよびアクティビティ機能とともに使用するには、WC_PortletサーバーをターゲットにするようにWebCenterDSデータ・ソースを手動で構成する必要があります。

1. Oracle WebLogic Serverコンソールで、「サービス」→「データ・ソース」へ移動します。

2. 「WebCenterDS」データ・ソースをクリックします。

3. 「ターゲット」タブへ移動します。

4. 「WC_Portlet」サーバーを選択して「保存」をクリックします。

22.2.4 WebCenter Portalを使用したページレット・プロデューサの登録

この項では、WebCenter Portalでページレット・プロデューサを登録する方法について説明します。

1. WebCenter Portalにログインして「管理」をクリックします。

2. 「構成」タブに移動して「サービス」をクリックします。

3. 「サービスとプロバイダ」ページで、「ポートレット・プロデューサ」をクリックします。

4. 「登録」をクリックし、「ページレット・プロデューサ」を選択します。

5. ページレット・プロデューサの接続の詳細を入力します(表22-2)。

表22-2 ページレット・プロデューサの接続パラメータ

フィールド

説明

プロデューサ名

このページレット・プロデューサのインスタンスをWebCenter Portal内で識別するための一意の名前。

サーバーURL

ページレット・プロデューサへのURL。このURLは完全修飾ドメイン名を含んでいる必要があります。次の構文を使用します。

<protocol>://<host_name>:<port_number>/pagelets/では、ホストとポートはページレット・プロデューサが構成されているWC_Portlet管理対象サーバーに対応しています。

例:

http://myhost.com:7778/pagelets/

ページレットにセキュアなデータが含まれている場合、登録するURLでHTTPSプロトコルを使用する必要があります。例:

https://myhost.com:7779/pagelets/

コンテキスト・ルートは、必要に応じて/pagelets/から変更できます。詳細は、第22.2.5項「ページレット・プロデューサの別のコンテキストへの再デプロイ」を参照してください。

注意: WebCenter Portalでは、ページレット・プロデューサのURLがOAMによって保護されている場合、ページレット・カタログへのURLを除外する(アクセス制御なしで直接マップする)必要があります。そうしないと、RESTを使用した場合にカタログが空白になります。ページレット・カタログのURLは、http://<host_name>:<port_number>/ pagelets/api/v2/ensemble/pageletsです。

22.2.5 ページレット・プロデューサの別のコンテキストへの再デプロイ

場合によっては、ページレット・プロデューサに対して定義したデフォルトのWebコンテキストを変更する必要が生じることがあります。この項では、ページレット・プロデューサを別のコンテキストに再デプロイする方法について説明します。

最初の手順は、管理サーバーに対するページレット・プロデューサのデータ・ソースをターゲットにして、ページレット・プロデューサEARファイルを見つけます。Oracle WebLogic Serverで次の操作を実行します。

1. Oracle WebLogic Serverコンソールで、「サービス」→「データ・ソース」へ移動します。

2. mds-PageletProducerDSデータ・ソースをクリックします。

3. 「ターゲット」タブへ移動します。

4. 「AdminServer」の横にあるチェック・ボックスを選択して「保存」をクリックします。

5. 「Deployments/pagelet-producer」に移動します。

6. Fusion Middleware Controlがページレット・プロデューサと同じホスト上で稼働している場合は、EARファイルへのパスを記録します。Fusion Middleware Controlがページレット・プロデューサとは異なるホスト上にある場合は、EARファイルをページレット・プロデューサのホスト・マシンからブラウザのホスト・マシンにコピーします。

次に、Fusion Middleware Controlを使用してコンテキストを次のように再定義します。

1. (アプリケーションの)「Deployments/pagelet-producer」に移動します。

2. 「アプリケーションのデプロイ」メニューから、「アプリケーションのデプロイ」→「アンデプロイ」を選択して、表示されるプロンプトに従います。「アンデプロイ」をクリックします。

3. 「WebLogicドメイン」メニューから、「アプリケーション・デプロイメント」→「デプロイ」を選択します。

4. アーカイブの場所をページレット・プロデューサのEARファイルに設定します(前述の最初の手順で検出してコピーしたファイル)。

- Fusion Middleware Controlがページレット・プロデューサと同じホスト上で稼働している場合は、2つ目のオプションを選択してEARファイルの場所にブラウズします。

- Fusion Middleware Controlがページレット・プロデューサのホストと異なるホスト上にある場合、最初のオプションを選択して「ファイルの選択」をクリックし、ブラウザのホスト・マシン上でコピーした場所からEARファイルを選択します。

5. WC_Portletを選択します。

6. Webモジュールの「コンテキスト・ルート」を次のように変更します。この場合、"new_context"は使用する必要があるWebコンテキストです(ルートに再デプロイするには、"new_context"を省略します)。

- ensemblestatic.war: new_context/ensemblestatic

- pageletadmin.war: new_context/admin

- opensocial.war: new_context/os

- loginserver.war: new_context/loginserver

- ensembleproxy.war: new_context/

注意:
ページレット・プロデューサがルート・コンテキストにデプロイされている場合、OpenSocialページレットは適切に機能しません。

7. 「デプロイ」をクリックします。

実装でOpenSocialが使用されている場合、ページレット・プロデューサ・コンソールのコンテキスト設定を更新します。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のページレット・プロデューサを使用したページレットの作成に関する項を参照してください。

22.3 WSRPおよびOracle JPDKポートレット・プロデューサのページレット・プロデューサへの登録

ページレット・プロデューサではWSRPおよびOracle JPDKポートレットを、Portal Frameworkアプリケーション、WebCenter Portalおよびサード・パーティのポータルで使用できるように、ページレットとして公開できます。

Fusion Middleware Control、WLSTまたはページレット・プロデューサ・コンソールを使用して、WSRPまたはOracle JPDKエンドポイントをポートレット・プロデューサとして登録できます。登録すると、新しいページレット・プロデューサ・リソースが作成され、WSRPエンドポイントに関連付けられたポートレットを表示するページレットが自動的にそのリソースに移入されます。

詳細な手順は、第21章「ポートレット・プロデューサの管理」を参照してください。 ページレット・プロデューサ・コンソールからポートレット・プロデューサの設定にアクセスするには、「ナビゲータ」ツールバーのメニューから「プロデューサ」を選択して、「登録」をクリックします。

22.3.1 WSRPおよびOracle JPDKポートレットの使用

自動生成されたWSRPおよびOracle JPDKリソースとページレットは変更できません。プロデューサに変更を加えて永続的な参照を作成するには、自動生成されたリソースを最初にコピーする必要があります。「共有アセット」ページでリソースを選択し、「アクション」メニューの「コピー」を選択します。コピーされたバージョンのリソースは編集可能であり、インジェクタなどの様々な要素を追加してページレットの機能をカスタマイズできます。レプリケートされたリソースはメタデータのエクスポートに含められます。

既存のポートレット・プロデューサに基づいて新規リソースを作成してから個々のページレットを作成する方法で、ポートレット・ベースのページレットを白紙の状態から定義することもできます。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のページレット・プロデューサを使用したページレットの作成に関する項を参照してください。

22.4 トラスト・サービス・アイデンティティ・アサータの構成

この項では、トラスト・サービス・アイデンティティ・アサータの構成方法について説明します。この項の内容は次のとおりです。

- 第22.4.1項「トラスト・サービス・アイデンティティ・アサータについて」

- 第22.4.2項「トラスト・サービス・アイデンティティ・アサータの構成の準備」

- 第22.4.3項「トラスト・サービス・アイデンティティ・アサータの構成の実行」

22.4.1 トラスト・サービス・アイデンティティ・アサータについて

WebCenter Portalは、サーバー間のRESTコールを使用してページレット・プロデューサと通信します。管理ユーザーのアイデンティティをページレット・プロデューサに渡すには、WLSのトラスト・サービス・アイデンティティ・アサータをページレット・プロデューサ(サーバー)で設定し、OPSSキーストア・サービスの資格証明をページレット・プロデューサ(サーバー)とWebCenter Portal (クライアント)の両方で設定する必要があります。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のOracle Platform Security Servicesによるアプリケーションの保護に関する項を参照してください。

22.4.2 トラスト・サービス・アイデンティティ・アサータの構成の準備

WebCenter Portalのインストール(WebCenter Portalとページレット・プロデューサに同一のインストーラを使用)では、WCP_HOME/webcenter/scriptsディレクトリ(例: /home/user/Oracle/Middleware/Oracle_WC1/webcenter/scripts)に、次の2つのファイルを配置します。

- configureTrustServiceIdentityAsserter.py

- configureTrustServiceIdentityAsserter.properties

WLSTスクリプトのconfigureTrustServiceIdentityAsserter.pyは、configureTrustServiceIdentityAsserter.propertiesファイルに設定された値を使用して、クライアント(WebCenter Portal)とサーバー(ページレット・プロデューサ)の両方にトラスト・アイデンティティを構成します。

入力するプロパティ

次のプロパティは、configureTrustServiceIdentityAsserter.pyの実行前に入力しておく必要があります。

表22-3 configureTrustServiceIdentityAsserter.pyで使用されるプロパティ

プロパティ

説明

例の値

admin.user

WLS管理ユーザー

weblogic

admin.password

WLS管理ユーザーのパスワード

welcome1

admin.url

WLS管理サーバーのホストURL

t3://localhost:7001

trust.alias

RESTコールで使用されるトークンの署名に使用する秘密鍵ペアを格納する、キーストアの別名。英数字を使用してください。

wckey

trust.issuer

これは、トークンの発行者を示すためにトークン内に設定される値です。

mycompany

keystore.exported.cert

これは、trust.aliasに含まれるキー・ペアの公開鍵のエクスポート先とエクスポート元になるファイル・パスです。この証明書の作成の詳細は、Oracle Fusion Middleware Oracle WebLogic Portalフェデレーテッド・ポータル・ガイドのWebCenter Portal: Frameworkアプリケーション・コンシューマとWebLogicポータル・プロデューサとの間のSAMLセキュリティに関する項を参照してください。

/home/user/Oracle/Middleware/user_projects/domains/my_domain/config/fmwconfig/wckey.cer

前述のプロパティに加え、複数のオプションのプロパティがconfigureTrustServiceIdentityAsserter.propertiesで定義されています。これらのプロパティがファイルで定義されていない場合は、次の「デフォルト値」列の下にリストされた値が使用されます。

表22-4 configureTrustServiceIdentityAsserter.pyで使用されるプロパティ

元のプロパティ

説明

デフォルト値

keystore.distinguished.name

キーストアのキー・ペア生成に使用されるDN

CN=<property value of trust.issuer>,O=Oracle,C=US

trust.identity.asserter.name

WLSトラスト・サービス・アサータに付ける名前

TrustServiceIA

詳細は、configureTrustServiceIdentityAsserter.propertiesファイルを開いてください。各プロパティの完全な説明と、トラスト・アイデンティティ・アサーションの全体的な構成プロセスは、インライン・コメントに記載されています。

22.4.3 トラスト・サービス・アイデンティティ・アサータの構成の実行

同一WLSドメイン上のWebCenter Portalとページレット・プロデューサ

ほとんどのデプロイ・シナリオでは、ページレット・プロデューサとWebCenter Portalは、同じWebLogicドメイン上の個別のWebLogic管理対象サーバーで実行されます。このシナリオでは、次の例に示すように、OPSSキーストア構成を1度実行し、クライアント(WebCenter Portal)とサーバー(ページレット・プロデューサ)の両方の設定を処理します。

cd WCP_ORACLE_HOME/webcenter/scripts
WCP_ORACLE_HOME/common/bin/wlst.sh ./configureTrustServiceIdentityAsserter.py ./configureTrustServiceIdentityAsserter.properties

Windows環境の場合、.shは必要ありません。

22.5 ページレット・プロデューサ・コンポーネントのインポート、エクスポート、バックアップおよびリカバリの管理

ページレット・プロデューサは、その構成とコンテンツに関連したデータをOracleメタデータ・ストア(MDS)に格納し、障害回復や、開発からステージングおよび本番までの本番ライフサイクル全体を容易にします。この項では、使用できるインポート、エクスポートおよびバックアップの各機能について説明します。

- 第22.5.1項「ページレット・プロデューサ・リソースのエクスポートおよびインポート」

- 第22.5.2項「WLSTを使用したページレット・プロデューサ・メタデータのエクスポートおよびインポート」

- 第22.5.3項「ページレット・プロデューサのバックアップおよび復元」

MDSの詳細は、管理者ガイドの「Oracle Metadata Repositoryの管理」を参照してください。

22.5.1 ページレット・プロデューサ・リソースのエクスポートおよびインポート

ページレット・プロデューサ・アセットは、ページレット・プロデューサ・コンソールを使用してエクスポートおよびインポートできます。ページレットは、WebCenter Portalの「共有アセット」ページから直接エクスポートまたはインポートできない点に注意してください。ページレット・プロデューサ共有アセットをエクスポートまたはインポートするには、この項で説明するようにページレット・プロデューサ・コンソールを使用するか、第22.5.2項「WLSTを使用したページレット・プロデューサ・メタデータのエクスポートおよびインポート」で説明するようにWLSTを使用する必要があります。

注意:
WAS環境の場合のみ、orcladminユーザーをAnonymousロール、EnsembleAdminロールおよびAdminロールのすべてにマップする必要があります。これらのロールのいずれかに、orcladminユーザーがマップされていないと、ユーザー・インタフェースが正しくレンダリングされないことがあります。

ページレット・プロデューサ・コンソールを使用して、ページレット・プロデューサ・アセットをインポートまたはエクスポートするには:

1. ページレット・プロデューサ・コンソールを開きます。
これは、次のいずれかの方法で実行できます。

- WebCenter Portalで、「管理」→「共有アセット」→「ページレット」に移動して、「作成」をクリックします。これにより、ページレット・プロデューサ・コンソールが開きます。WebCenter Portalに戻る準備が整ったら、「取消」をクリックします。

- 次のURLに移動します。
http://<host_name>:<port_number>/pagelets/admin.

2. 「移動先:」ドロップダウン・リストから「エクスポート/インポート」を選択します。

3. 「エクスポート」、「インポート」、「変数」のいずれかをクリックして、実行するアクティビティを選択します。

- アセットのリストから選択したものを新しいMDSパッケージにエクスポートする場合は、「エクスポート」ペインを使用します。

- 既存のMDSパッケージを参照して、そのパッケージをページレット・プロデューサにインポートする場合は、「インポート」ペインを使用します。

- ルートURLの変数を定義し、内部URLを保護してインポートを簡易化する場合は、「変数」ペインを使用します。

4. リソースをエクスポートするには、「エクスポート」をクリックします。
「エクスポート」ペインが表示されます(図22-1を参照)。

図22-1 ページレット・プロデューサ・コンソール: 「エクスポート」ペイン

1. エクスポートに含めるアイテムを確認します。

2. 「次へ」をクリックします。
ホストURLが表示されます(図22-2)。

図22-2 ホストURL

3. 「ホスト」にURLを入力し(このURLが定義されている場合は、「変数」フィールドをクリックして変数を使用する)、「エクスポート」をクリックします。

5. リソースをインポートするには、「インポート」をクリックします。
「インポート」ペインが表示されます(図22-1を参照)。

図22-3 ページレット・プロデューサ・コンソール: インポート・オプション

1. 「参照」をクリックして、インポートするファイルを選択します。

2. 「送信」をクリックして、インポートを開始します。

3. プロンプトが表示された場合は、「スキップ」または「上書き」(インポートのターゲット側に既存のリソースがある場合)を選択します。

6. 変数を定義するには、「変数」をクリックします。
「変数」ペインが表示されます(図22-4を参照)。

図22-4 ページレット・プロデューサ・コンソール: 「変数」ペイン

1. 「変数の追加」をクリックします。

2. 「ホスト」フィールドにホスト名を入力します。

3. ホストURLに関連付ける変数名を「変数」フィールドに入力します。

4. 変数の追加を続けるには、「変数の追加」をクリックします。
追加が完了すると、「エクスポート」ペインでホストURLの一部として変数が使用できるようになります。

22.5.2 WLSTを使用したページレット・プロデューサ・メタデータのエクスポートおよびインポート

ページレット・プロデューサで作成したメタデータはMDSに格納され、WLSTを使用してアクセスできます。WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

現在はWLSTを使用したグローバル移行のみがサポートされており、ソース環境のすべてのデータはエクスポート済のMDSパッケージに格納され、ターゲット環境内のすべてのデータはそのパッケージがインポートされる時点で上書きされます。

注意:
WebCenter Portal実装をステージングから本番に移行する場合、ページレット・プロデューサのデータのエクスポートとインポートは、移行ツールによって処理されます。ただし、ステージング環境でページレット・プロデューサのオブジェクトに変更が加えられている場合、これらの変更は、この項で説明されているWLSTコマンドを使用して、個別に移行する必要があります。移行後にページレット・プロデューサが動作しない場合は、WebCenter Portalアプリケーションでページレット・プロデューサ用に定義したサーバーURLを確認してください。このURLの設定の詳細は、第22.2項「ページレット・プロデューサの登録」を参照してください。WebCenter Portal移行の詳細は、第39章「WebCenter Portalのライフ・サイクルの理解」を参照してください。

22.5.2.1 WLSTを使用したページレット・プロデューサ・メタデータのエクスポート

リソース、ページレット、カスタム構成の設定などページレット・プロデューサへの基本ドキュメントをエクスポートするには、WLSTコマンドexportMetadataを使用します。

例:

exportMetadata(application='pagelet-producer', server='WC_Portlet_Staging', toLocation='c:\work\myexport', docs='/**')

ここで:

- application: メタデータをエクスポートするページレット・プロデューサのアプリケーション名(例: pagelet-producer)。

- server: ページレット・プロデューサのアプリケーションをデプロイするサーバー(例: WC_PortletStaging)。

- toLocation: ソース・パーティションから選択したドキュメントをエクスポートする先のターゲット・ディレクトリ。toLocationパラメータは、異なるサーバー間でメタデータを移行するための一時ファイル・システムとして使用できます。

- docs: ドキュメントの完全修飾名とドキュメント名パターン(*および**のパターン)のカンマ区切りのリスト。

構文の詳細と例は、『WebLogic Scripting Toolコマンド・リファレンス』のexportMetadataに関する項を参照してください。

22.5.2.2 WLSTを使用したページレット・プロデューサ・メタデータのインポート

ページレット・プロデューサ・メタデータとカスタマイズをインポートするには、WLSTコマンドimportMetadataを使用します。

例:

importMetadata(application='pagelet-producer', server='WC_Portlet_Production', fromLocation='c:\work\myexport', docs='/**')

ここで:

- application: メタデータをインポートするページレット・プロデューサのアプリケーション名(例: pagelet-producer)。

- server: ページレット・プロデューサがデプロイされるターゲット・サーバーの名前(例: WC_Portlet_Production)。

- fromLocation: ドキュメントがインポートされる元のソース・ディレクトリ。fromLocationパラメータは、異なるサーバー間でメタデータを移行するための一時ファイル・システムの場所とすることができます。

- docs: ドキュメントの完全修飾名とドキュメント名パターン(*および**のパターン)のカンマ区切りリスト。

構文の詳細と例は、『WebLogic Scripting Toolコマンド・リファレンス』のimportMetadataに関する項を参照してください。

注意:
オブジェクトの構成で使用した環境固有のURLは、インポート後は手動で更新する必要があります。

22.5.3 ページレット・プロデューサのバックアップおよび復元

ページレット・プロデューサのバックアップとリカバリの操作は、標準MDSバックアップの一部であり、データベースのエクスポート・ユーティリティおよびインポート・ユーティリティやその他の様々なツールを使用して管理できます。詳細は、管理者ガイドの第VII部を参照してください。

デフォルトでは、ページレット・プロデューサのMDS構成は次のとおりです(adf-config.xmlより)。

<metadata-store name="PageletProducerMetadataRepos" class-name="oracle.mds.persistence.stores.db.DBMetadataStore">
<property name="partition-name" value="pageletproducer"/>  <property name="jndi-datasource" value="jdbc/mds/PageletProducerDS"/>
<property name="repository-name" value="mds-PageletProducerDS"/> </metadata-store>

23 外部アプリケーションの管理

外部アプリケーションとは、自身の認証プロセスを実装するアプリケーションです。つまり、ポータル・アプリケーション(WebCenter Portalまたは独自のPortal Frameworkアプリケーション)のシングル・サインオン・プロセスに参加しないアプリケーションのことです。

システム管理者は、Fusion Middleware ControlまたはWLSTコマンド行ツールを使用して、WebCenter PortalおよびPortal Frameworkアプリケーションのデプロイメント用の外部アプリケーションを登録および管理できます。

また、アプリケーション管理者は、初期設定の管理ページまたは外部アプリケーション・タスク・フローを使用して、外部プリケーションを実行時に登録および管理できます。

デプロイ後にWebCenter PortalまたはPortal Frameworkアプリケーションに対して行った外部アプリケーションの変更はすべて、MDSリポジトリにカスタマイズとして格納されます。

注意:
外部アプリケーションの構成は動的です。WebCenter PortalおよびPortal Frameworkアプリケーションの構成変更は即時反映されます。アプリケーションや管理対象サーバーを再起動する必要はありません。

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

この章には次の項が含まれます:

- 第23.1項「外部アプリケーションについて」

- 第23.2項「外部アプリケーションの登録」

- 第23.3項「外部アプリケーション接続の詳細の変更」

- 第23.4項「WebCenter Portal管理コンソールを使用した外部アプリケーションの管理」

- 第23.5項「外部アプリケーション接続のテスト」

- 第23.6項「外部アプリケーション接続の削除」

- 第23.7項「外部アプリケーションの問題のトラブルシューティング」

23.1 外部アプリケーションについて

WebCenter Portalまたは独自のPortal Frameworkアプリケーションと、独自認証を使用するアプリケーションを連携する場合、資格証明プロビジョニングをできるように、そのアプリケーションと外部アプリケーション定義を関連付けることができます。そのためには、外部アプリケーション定義を使用して、それらの個別に認証されたアプリケーションからコンテンツにアクセスする手段を指定します。

外部アプリケーション・サービスは、エンド・ユーザー側からのシングル・サインオン操作を再現するために、ユーザー名とパスワードおよび外部アプリケーション用のその他の資格証明をすべて取得し、これらの情報を資格証明が必要なWebCenter Portalツールやアプリケーションに渡します。WebCenter Portalツールや他のアプリケーションは、この情報をエンド・ユーザーのかわりに使用してログインします。このユーザー名とパスワードの組合せは、アプリケーションがデプロイされているWebLogicドメイン用に構成された資格証明ストアにセキュアに格納されます。

注意:
外部アプリケーションへのログイン時に、「ログイン情報を保存する」チェック・ボックスを選択しない場合、高可用性(HA)環境でフェイルオーバーが発生すると、そのユーザー・セッションのプロビジョニング済の資格証明は失われます。同一ユーザー・セッション内で外部アプリケーション・コンテンツにアクセスしようとすると、資格証明を再度指定するように要求されます。

Portal Frameworkアプリケーションで使用する外部アプリケーションを指定するには、デプロイ前であればOracle JDeveloperのウィザード、デプロイ後であればFusion Middleware Controlコンソール(図23-1)かWLSTコマンドを使用します。設計時にJDeveloperで指定した外部アプリケーションは、デプロイ後、自動的に表示されます。ただし、デプロイ後にFusion Middleware ControlまたはWLSTコマンドを使用して、設計時の共有資格証明およびパブリック資格証明を再プロビジョニングする必要があります。詳細は、第31章「アイデンティティ・ストアの構成」および第32章「ポリシーおよび資格証明ストアの構成」を参照してください。

図23-1 外部アプリケーションの編集

23.2 外部アプリケーションの登録

WebCenter PortalおよびPortal Frameworkアプリケーションの外部アプリケーションは、Fusion Middleware ControlまたはWLSTコマンドを使用して登録できます。

外部アプリケーションを登録する前に、アプリケーションのログイン・ページにアクセスし、アプリケーションのログイン・フォームのHTMLソースを調べます。必要な登録詳細はすべて、<form tag>の中にあります。

たとえば、Yahoo! Mailのログイン・フォームの基礎となるコードは、次のようになっています。

<form method=post action="https://login.yahoo.com/config/login?" autocomplete="off" name="login_form">
...
<td><input name="login" size="17"</td>
...
<td><input name="passwd" size="17"</td>
...

この例の場合、WebCenter PortalユーザーにYahoo! Mailアプリケーションへの直接リンクを提供するには、次のサンプルの登録情報が必要です。

登録情報

サンプル値

HTMLソース

ログインURL

https://login.yahoo.com/config/login?

action

「ユーザー名」/「ユーザーID」フィールド

login

name="login"

パスワード・フィールド名:

passwd

name="passwd"

認証方式

post

method

注意:
外部アプリケーションの構成は動的です。新規の外部アプリケーションおよび既存アプリケーションの更新はすぐに使用可能になります。WebCenter PortalまたはPortal Frameworkアプリケーションを再起動する必要はありません。

外部アプリケーションを使用するツールの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のセキュアなサービス接続に関する項を参照してください。

この項では、次の手順を説明します。

- 第23.2.1項「Fusion Middleware Controlを使用した外部アプリケーションの登録」

- 第23.2.2項「WLSTを使用した外部アプリケーションの登録」

- 第23.2.3項「WebCenter Portalでの外部アプリケーションの登録」

- 第23.2.4項「Portal Frameworkアプリケーションでの外部アプリケーションの登録」

23.2.1 Fusion Middleware Controlを使用した外部アプリケーションの登録

外部アプリケーションを登録するには:

1. Fusion Middleware Controlにログインして、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

- 第6.2項「WebCenter Portalのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「外部アプリケーション」を選択します。

4. 新規の外部アプリケーションを登録するには、「追加」をクリックします(図23-2)。

図23-2 外部アプリケーション接続の構成

5. 外部アプリケーションの一意の名前と、この外部アプリケーションを操作するアプリケーション・ユーザーに表示される表示名を入力します。
表23-1も参照してください。

表23-1 外部アプリケーション接続: 名前

フィールド

説明

アプリケーション名

アプリケーションの名前を入力します。名前は、アプリケーションのすべての接続タイプにおいて一意である必要があります。

例: yahoo

注意: 登録後に「アプリケーション名」を編集することはできません。

表示名

WebCenter Portalユーザーにわかりやすいアプリケーション名を入力します。ここで指定した表示名が、この外部アプリケーションを操作する、アプリケーションのエンド・ユーザーに表示されます。

例: My Yahoo

このフィールドを空白のままにした場合、「アプリケーション名」が使用されます。

6. 外部アプリケーションのログインの詳細を入力します。
詳細は、表23-2を参照してください。

表23-2 外部アプリケーション接続: ログインの詳細

フィールド

説明

自動ログインの有効化

これを選択した場合、ユーザーはこのアプリケーションに自動的にログインできます。このオプションを選択した場合、Login URL、HTML User ID Field NameおよびHTML User Password Field Nameフィールドへの入力が必要になります。

自動シングル・サインオンが設定されている場合は、ユーザーの資格証明が資格証明ストアから取得されるため、ユーザーはアプリケーションに直接リンクされて自動的に認証されます。このオプションを選択すると、エンド・ユーザーはシームレスなシングル・サインオンを行うことができます。

注意: 次の場合には、自動ログインはサポートされません。

- 基本認証を使用した外部アプリケーション。

- SSO用に構成された外部アプリケーション。

- (ADF Facesを使用して構築された)カスタマイズ済ログイン・フォームを含む外部アプリケーション。このログイン・フォームでは、認証用のJ2EEセキュリティ・コンテナ・ログイン・メソッドj_security_checkを実装できません。

- UTF8エンコーディングをサポートしていない外部サイト。

- ログイン成功時に、ランダムに生成される非表示フィールド値またはCookieを受け入れる外部アプリケーション。

ログインURL

外部アプリケーションのログインURLを入力します。

URLを調べるには、アプリケーションのログイン・ページにナビゲートし、URLを書き留めます。

例: http://login.yahoo.com/config/login

注意: この外部アプリケーションの目的が他のサービスのかわりにユーザー資格証明を格納および提供することのみの場合、「ログインURL」は必要ありません。

HTMLユーザーIDのフィールド名

ログイン・フォームのユーザー名フィールドまたはユーザーIDフィールドを識別する名前を入力します。

ヒント: この名前を調べるには、ログイン・ページのHTMLソースを参照してください。

このプロパティに指定するのはユーザー資格証明ではありません。

「認証方式」がGETまたはPOSTである場合は必須です。アプリケーションでBASIC認証を使用する場合(「認証方式」を参照)は、このフィールドを空白のままにしておきます。

HTMLユーザー・パスワードのフィールド名

ログイン・フォームのパスワード・フィールドを識別する名前を入力します。

ヒント: この名前を調べるには、ログイン・ページのHTMLソースを参照してください。

「認証方式」がGETまたはPOSTである場合は必須です。アプリケーションでBASIC認証を使用する場合(「認証方式」を参照)は、このフィールドを空白のままにしておきます。

7. 外部アプリケーションで使用される認証方式を選択します。
詳細は、表23-3を参照してください。

表23-3 外部アプリケーション接続: 認証の詳細

フィールド

説明

認証方式

外部アプリケーションで使用されるフォーム送信方式を選択します。次のいずれかを選択します。

- GET: ページ・リクエストをサーバーに送信し、ログイン資格証明をログインURLの一部として送信します。この認証方式を使用すると、ユーザー名とパスワードがURL内に公開されるため、セキュリティ・リスクが発生する可能性があります。

- POST: ログイン資格証明をフォームの本文内で送信します。これはデフォルト値です。

- 基本: ログイン資格証明をリクエスト内の認証ヘッダーとしてサーバーに送信します。この認証方式を使用すると、資格証明が傍受されやすいうえ、このスキームではサーバーから返される情報が保護されないため、セキュリティ・リスクが発生する可能性があります。クライアントとサーバーのコンピュータの間の接続が安全であり、信頼できることが前提となります。

「認証方式」は、ブラウザからメッセージが送信される方法を指定します。この値は、外部アプリケーションのログイン・フォームのHTMLソース(たとえば、<form method="POST" action="https://login.yahoo.com/config/login?" AutoComplete="off">)を表示すると調べることができます。

8. 必要な場合、追加のログイン・フィールドおよび詳細を指定します。
詳細は、表23-4「外部アプリケーション接続: 追加ログイン・フィールド」を参照してください。

表23-4 外部アプリケーション接続: 追加ログイン・フィールド

フィールド

説明

追加ログイン・フィールド

アプリケーションに追加のログイン基準が必要な場合は、「追加ログイン・フィールド」を開きます。

たとえば、Lotus Notesアプリケーションでは、user nameとpasswordの他に2つのフィールド(HostとMailFilename)が必要です。

「追加」をクリックして、ログイン・フォームの追加フィールドを指定します。それぞれの新しいフィールドで次を実行します。

- 名前: ユーザーがログインするために入力する必要のあるHTMLログイン・フォームのフィールドを識別する名前を入力します。アプリケーションで基本認証が使用される場合、このフィールドは適用されません。

- 値: フィールドのデフォルト値を入力するか、ユーザーが指定できるように空白のままにしておきます。アプリケーションで基本認証が使用される場合、このフィールドは適用されません。

- ユーザーに表示: これを選択した場合、外部アプリケーションのログイン画面にこのフィールドが表示されます。このフィールドを表示しない(チェック・ボックスを選択しない)場合は、デフォルトの「値」を指定する必要があります。

ログイン・フィールドを削除するには、「削除」をクリックします。

9. 必要な場合、共有ユーザー資格証明およびパブリック・ユーザー資格証明を指定します。
詳細は、表23-5を参照してください。

表23-5 外部アプリケーション接続: 共有ユーザー資格証明とパブリック・ユーザー資格証明

フィールド

説明

共有資格証明の有効化

この外部アプリケーションで共有ユーザー資格証明を有効にするかどうかを指定します。有効にする場合は資格証明を指定します。「共有資格証明の有効化」を選択してから、共有ユーザーの「ユーザー名」および「パスワード」資格証明を入力します。

共有資格証明を指定した場合、WebCenter PortalまたはPortal Frameworkアプリケーションのいずれかを介してこの外部アプリケーションにアクセスするユーザーはいずれも、ここで定義したユーザー名とパスワードを使用して認証されます。WebCenter Portalユーザーにログイン・フォームは表示されません。

WebCenter Portalユーザーが自分自身の資格証明を定義する必要はないため、共有資格証明を持つ外部アプリケーションは外部アプリケーションのパスワード変更タスク・フロー(「マイ・アカウント」など)では表示されません。

『Oracle WebCenter Portalの使用』の外部アプリケーション用のログイン情報の指定に関する項も参照してください。

パブリック資格証明の有効化

認証されていないユーザー(パブリック・ユーザー)がこの外部アプリケーションにアクセスできるかどうかを指定します。「パブリック資格証明の有効化」を選択してから、パブリック・ユーザーの「ユーザー名」および「パスワード」資格証明を入力します。

パブリック資格証明を指定した場合、WebCenter PortalまたはPortal Frameworkアプリケーションのパブリック・ページのいずれかを介してこの外部アプリケーションにアクセスするパブリック・ユーザーは、ここで定義したユーザー名とパスワードを使用してログインします。パブリック資格証明を指定しない場合、パブリック・ユーザーには、この外部アプリケーションにパブリック・ユーザーがアクセスできないことを示す認可エラーが表示されます。

10. 「OK」をクリックして、アプリケーションを登録します。

23.2.2 WLSTを使用した外部アプリケーションの登録

WLSTコマンドのcreateExtAppConnectionを使用して、外部アプリケーション接続を作成します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のcreateExtAppConnectionに関する項を参照してください。

WLSTコマンドのaddExtAppCredentialを使用して、外部アプリケーション接続の共有資格証明またはパブリック資格証明を追加します。詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のaddExtAppCredentialに関する項を参照してください。

WLSTコマンドのaddExtAppFieldを使用して、既存の外部アプリケーション接続に追加のログイン基準を定義します。詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のaddExtAppFieldに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

23.2.3 WebCenter Portalでの外部アプリケーションの登録

ポータル・ビルダー管理を使用した外部アプリケーションの登録の詳細は、第8.3.2項「WebCenter Portalのツールおよびサービスの構成」を参照してください。

23.2.4 Portal Frameworkアプリケーションでの外部アプリケーションの登録

Portal Frameworkアプリケーションでの外部アプリケーションの登録の詳細は、第23.4項「WebCenter Portal管理コンソールを使用した外部アプリケーションの管理」を参照してください。

23.3 外部アプリケーション接続の詳細の変更

この項では、外部アプリケーション接続の詳細を変更する方法を説明します。この項の内容は次のとおりです。

- 第23.3.1項「Fusion Middleware Controlを使用した外部アプリケーション接続の変更」

- 第23.3.2項「WLSTを使用した外部アプリケーション接続の変更」

23.3.1 Fusion Middleware Controlを使用した外部アプリケーション接続の変更

外部アプリケーション接続の詳細を更新するには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

- 第6.2項「WebCenter Portalのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「外部アプリケーション」を選択します。

4. 変更する外部アプリケーションの名前を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータの詳細は、表23-2を参照してください。
外部アプリケーションの名前は編集できないので注意してください。

6. 「OK」をクリックして、変更を保存します。

23.3.2 WLSTを使用した外部アプリケーション接続の変更

WLSTコマンドのsetExtAppConnectionを使用して、既存の外部アプリケーション接続の詳細を編集します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のsetExtAppConnectionに関する項を参照してください。

注意:
追加のログイン・フィールドに関連する詳細を編集するには、setExtAppFieldを使用します。既存の共有資格証明またはパブリック資格証明を編集するには、setExtAppCredentialを使用します。
追加のログイン・フィールドを削除するには、removeExtAppFieldを使用します。共有資格証明またはパブリック資格証明を削除するには、removeExtAppCredentialを使用します。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

WebCenter Portalでの外部アプリケーションの変更の詳細は、『Oracle WebCenter Portalの使用』の外部アプリケーション接続の詳細の編集に関する項を参照してください。

23.4 WebCenter Portal管理コンソールを使用した外部アプリケーションの管理

Portal Frameworkアプリケーションで外部アプリケーションの登録と管理を行うには、ユーザーにAppConnectionManagerロールが割り当てられている必要があります。デフォルトでは、Administratorロールを持つユーザーにAppConnectionManagerロールが割り当てられるため、アプリケーション管理者は、WebCenter Portal管理コンソールを通じて外部アプリケーションを構成できます。

外部アプリケーションとは、自身の認証プロセスを実装するアプリケーションです。つまり、Portal Frameworkアプリケーションのシングル・サインオン・プロセスに参加しないアプリケーションのことです。Portal Frameworkアプリケーションが、自身の認証を行うアプリケーションと対話する場合、資格証明プロビジョニングを可能にする外部アプリケーションを登録できます。

アプリケーション管理者は、WebCenter Portal管理コンソールを通じて、実行時にPortal Frameworkアプリケーションの外部アプリケーションを登録、編集および削除できます。

この項には次のサブセクションが含まれます:

- 第23.4.1項「外部アプリケーションの登録」

- 第23.4.2項「外部アプリケーションの編集と削除」

注意:
システム管理者は、Fusion Middleware ControlとWLSTコマンドを使用して、Portal Frameworkアプリケーションの外部アプリケーションを登録することもできます。詳細は、第21章「ポートレット・プロデューサの管理」を参照してください。

23.4.1 外部アプリケーションの登録

Portal Frameworkアプリケーションの外部アプリケーションを実行時に登録するには:

1. 「サービス」管理タブに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」も参照してください。

2. 「外部アプリケーション」を選択します(図23-3)。

図23-3 WebCenter Portal管理コンソール: 外部アプリケーション

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

4. 外部アプリケーションの接続の詳細を入力します。
1つ以上のフィールドの詳細は、次の表を参照してください。

- 表23-1「外部アプリケーション接続: 名前」

- 表23-2「外部アプリケーション接続: ログインの詳細」

- 表23-3「外部アプリケーション接続: 認証の詳細」

- 表23-4「外部アプリケーション接続: 追加ログイン・フィールド」

- 表23-5「外部アプリケーション接続: 共有ユーザー資格証明とパブリック・ユーザー資格証明」

5. 「テスト」をクリックして、接続の詳細を検証します。

6. 「OK」をクリックして、アプリケーションを登録します。

23.4.2 外部アプリケーションの編集と削除

Portal Frameworkアプリケーションの外部アプリケーションを実行時に変更または削除するには:

1. 「サービス」管理タブに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」も参照してください。

2. 「外部アプリケーション」を選択します(図23-3)。

3. 必要な外部アプリケーションを選択し、次のいずれかをクリックします。

- 外部アプリケーションの接続の詳細を更新するには、「編集」をクリックします。

- 外部アプリケーションを削除するには、「登録解除」をクリックします。
外部アプリケーション接続を削除すると、Portal Frameworkアプリケーション・ユーザーはそのアプリケーションにアクセスできなくなり、外部アプリケーションに依存するサービスが正常に機能しなくなる可能性があるため、削除する際は注意してください。

23.5 外部アプリケーション接続のテスト

ログインURLを使用して外部アプリケーションを作成する場合は、そのログインURLにアクセス可能であることを確認します。ダイレクトURLの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の自動シングル・サインオンに関する項を参照してください。

23.6 外部アプリケーション接続の削除

外部アプリケーション接続を削除すると、WebCenter PortalまたはPortal Frameworkアプリケーション・ユーザーはその外部アプリケーションにアクセスできなくなり、外部アプリケーションに依存するツールまたはサービスが正常に機能しなくなる可能性があるため、削除する際は注意してください。

この項には次のサブセクションが含まれます:

- 第23.6.1項「Fusion Middleware Controlを使用した外部アプリケーション接続の削除」

- 第23.6.2項「WLSTを使用した外部アプリケーション接続の削除」

23.6.1 Fusion Middleware Controlを使用した外部アプリケーション接続の削除

外部アプリケーション接続を削除するには:

1. Fusion Middleware Controlにログインして、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

- 第6.2項「WebCenter Portalのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「設定」→「サービス構成」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「外部アプリケーション」を選択します。

4. 削除する外部アプリケーションの名前を選択し、「削除」をクリックします。

23.6.2 WLSTを使用した外部アプリケーション接続の削除

WLSTコマンドのdeleteConnectionを使用して、外部アプリケーション接続を削除します。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のdeleteConnectionに関する項を参照してください。

注意:
追加のログイン・フィールドを削除するには、removeExtAppFieldを使用します。共有資格証明またはパブリック資格証明を削除するには、removeExtAppCredentialを使用します。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

23.7 外部アプリケーションの問題のトラブルシューティング

この項では、外部アプリケーションに関連する一般的な問題と回避策について説明します。

この項には次のサブセクションが含まれます:

- 第23.7.1項「ユーザーのパスワードがロックアウトされる」

23.7.1 ユーザーのパスワードがロックアウトされる

問題

アイデンティティ・ストアに使用しているパスワード変更ポリシーが、アイデンティティ・ストアでパスワードを直接変更する場合、コラボレーション接続のために資格証明を格納または取得する外部アプリケーションを使用すると、ユーザーのパスワードがロックアウトされることがあります。

解決策

外部アプリケーションは、アイデンティティ・ストアでパスワードが直接変更されたことを認識できないため、このようなパスワード変更には対応できません。部分的な解決策は、1つの外部アプリケーションをすべてのコラボレーション接続に対して定義することです。PS6より前のリリースについては、サポートに連絡して、Bug 9327220、12965480、14174484、14309006のパッチをご使用の環境で適用してください。

24 RESTサービスの管理

この章では、WebCenter PortalまたはPortal FrameworkアプリケーションにおけるOracle WebCenter PortalのRESTサービス管理の概要について説明します。

この章には次の項が含まれます:

- 第24.1項「RESTサービスについて」

- 第24.2項「RESTの有効化に必要な手動構成の実行」

- 第24.3項「セキュリティ・トークンの理解」

- 第24.4項「RESTのルート名の変更」

- 第24.5項「圧縮の使用」

- 第24.6項「認証の処理」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

24.1 RESTサービスについて

REST (REpresentational State Transfer)は、分散されたリソースを共通のインタフェースを介して利用できるようにするためのアーキテクチャ・スタイルです。この共通のインタフェースには、Uniform Resource Identifier (URI)、明確に定義された操作、ハイパーメディア・リンクおよび一連の制約付きメディア・タイプなどがあります。通常、これらの操作には、読取り、書込み、編集、削除が含まれます。メディア・タイプには、JSONおよびXML/ATOMなどがあります。

REST APIは一般的に、クライアント側のスクリプト言語で記述されたリッチ・インターネット・アプリケーションで使用されます。たとえば、Javascriptで記述されたブラウザ・ベースのアプリケーションでは、サーバーとのアプリケーション・データの送受信にAjaxの手法とREST APIを併用することにより、クライアント・ビューを更新できます。

Oracle WebCenter Portalには、ディスカッション、リスト、ピープル・コネクションおよび検索など、Oracle WebCenter Portalの様々なツールおよびサービスに対するRESTfulインタフェースが用意されています。RESTをサポートするサービスの全リストは、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「Oracle WebCenter Portal REST APIの使用」を参照してください。

RESTおよびOracle WebCenter Portal REST APIの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のOracle WebCenter REST APIの使用に関する項を参照してください。

24.2 RESTの有効化に必要な手動構成の実行

Oracle WebCenter Portal REST APIはデフォルトでは有効化されていません。REST APIの動作を有効化するには、2つの異なる構成をサーバー側で行う必要があります。アイデンティティ・アサータを構成し、必要なエントリを資格証明ストアにシードする必要があります。これにより、RESTセキュリティ・トークンが適切に機能するようになります。セキュリティ・トークンの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のWebCenter Portal REST APIのセキュリティに関する考慮事項に関する項を参照してください。

Oracle WebCenter Portalの初回インストール後に、次の構成作業を行います。構成作業が実行済でないことに気づいた場合も実行してください。

- 第24.2.1項「アイデンティティ・アサータの構成」

- 第24.2.2項「WebLogic Server資格証明ストアの構成」

24.2.1 アイデンティティ・アサータの構成

REST APIを使用する前に、アイデンティティ・アサータを構成する必要があります。手順の詳細は、第31.9項「RESTサービス・アイデンティティ・アサータの構成」を参照してください。

24.2.2 WebLogic Server資格証明ストアの構成

アイデンティティ・アサータを構成したら、次の手順はWLS資格証明ストアの構成です。資格証明ストアを構成するには、サーバーの実行中に次のWLSTコマンドを実行します。再起動は必要ありません。

createCred(map="o.webcenter.jf.csf.map", key="keygen.algorithm",
user="keygen.algorithm", password="AES")
createCred(map="o.webcenter.jf.csf.map", key="cipher.transformation",
user="cipher.transformation", password="AES/CBC/PKCS5Padding")

24.3 セキュリティ・トークンの理解

ユーザーが範囲指定したセキュリティ・トークンは、各RESTサービスURIのhref属性とtemplate属性に埋め込まれます。トークンの生成および検証はいずれもサーバーで行われ、第24.2.2項「WebLogic Server資格証明ストアの構成」で説明されている、keygen.algorithmとcipher.transformationの構成手順によって有効化されます。セキュリティ・トークンの目的は、クロスサイト・リクエスト・フォージェリ(CSRF)攻撃を防止することです。

例:

<link
template="opaque-template-uri/@me?startIndex={startIndex}
&itemsPerPage={itemsPerPage}&utoken=generated-token"
resourceType="urn:oracle:webcenter:messageBoard"
href="opaque-uri/@me?token=generated-token"
capabilities="urn:oracle:webcenter:read"/>

注意:
セキュリティ・トークンは認証にもアイデンティティ伝播にも使用されません。

セキュリティ・トークンは認証済ユーザーの名前に基づきます。セキュリティ・トークンは期限切れにならないため、URIのキャッシュやブックマークが可能になります。

セキュリティ・トークンにはソルト処理も行われます。ソルト処理は、文字列を暗号化する前にその文字列に文字を追加する暗号化手法です。セキュリティ・トークンが漏えいした場合でも、ソルト処理がされているので、問題を解決するためにそのユーザーのユーザー名をシステム全体で変更する必要はありません。

この手法を使用すると、ユーザー名が漏えいした際に、問題解決のためにシステム規模でユーザー名を変更する必要がなくなります。ソルトの再生成が必要な場合は、次のWLSTコマンドを使用してソルトを削除するだけで再生成できます。

deleteCred(map="o.webcenter.jf.csf.map", key="user.token.salt", user=" user.token.salt", password="AES")

セキュリティ・トークンの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のWebCenter Portal REST APIのセキュリティに関する考慮事項に関する項を参照してください。

24.4 RESTのルート名の変更

REST APIのルート名の変更は必須ではありませんが、場合によっては必要になることがあります。RESTのルート名を変更する場合は、第8.2.4項「プロキシ・サーバーの設定」の説明に従って、プロキシ・サーバーを構成する方法をお薦めします。たとえば、次の2つのURIは、プロキシ・サーバー構成によって同じサーバーを参照しています。

http://myhost:8888/rest/api/resourceIndex

http://myhost:8888/pathname/rest/api/resourceIndex

24.5 圧縮の使用

この項では、Oracle WebCenter Portal REST APIによってクライアントに戻されるXMLレスポンスまたはJSONレスポンスで圧縮を有効化する手法について説明します。

Apacheを使用している場合は、mod_deflateまたはmod_gzipサーバー・モジュールをサーバー構成に追加できます。詳細は、Apacheのドキュメントを参照してください。

Oracle HTTP Server (OHS)を使用している場合は、Oracle Web Cacheを使用してこれを行うことをお薦めします。詳細は、『Oracle Fusion Middleware Oracle Web Cache管理者ガイド』を参照してください。

OHSを使用している場合は、mod_deflateまたはmod_gzipサーバー・モジュールを追加して圧縮を有効化することもできます。この手法の詳細は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』のOracle HTTP Serverモジュールの理解に関する項を参照してください。

Oracle Web Cacheの詳細は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』の圧縮に関する項と、同ガイドの「コンテンツのキャッシュと圧縮」を参照してください。

24.6 認証の処理

デフォルトでは、RESTサービスは、アイデンティティ・アサーション・プロバイダからの認証を受け入れるように構成されています。アイデンティティ・アサーション・プロバイダが構成されていない場合は、基本認証が使用されます。

アイデンティティ・アサーション・プロバイダの詳細は、第31.9項「RESTサービス・アイデンティティ・アサータの構成」を参照してください。

詳細は、『Oracle WebLogic Serverの保護』の認証プロバイダの構成に関する項を参照してください。

注意:
ユーザーはCMISのルートに匿名でアクセスできます。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のCMIS REST APIのセキュリティに関する考慮事項に関する項を参照してください。

25 パーソナライズの管理

この章では、Oracle WebCenter Portalのパーソナライズを構成および管理する方法について説明します。

この章には次の項が含まれます:

- 第25.1項「Oracle WebCenter Portalのパーソナライズについて」

- 第25.2項「パーソナライズの前提条件と制限事項」

- 第25.3項「WebCenter OPSSトラスト・サービスの構成」

- 第25.4項「プロバイダの構成」

- 第25.5項「Coherenceの構成」

- 第25.6項「コンテンツ・プレゼンタの構成」

- 第25.7項「シングル・サインオンの構成」

- 第25.8項「デフォルトのセキュリティ設定のオーバーライド」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

- Portal Frameworkアプリケーション: Administratorロール。管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

25.1 Oracle WebCenter Portalのパーソナライズについて

Oracle WebCenter Portalのパーソナライズを使用すると、ポータル・アプリケーションのユーザー・エクスペリエンスを動的に導出できます。パーソナライズは、定義された入力データ・ソースを評価し、その評価に基づいてデシジョンを生成し、この情報を宣言的に定義されたパーソナライズ・シナリオに適用します。パーソナライズでは、たとえば、人事管理データベース内のユーザーに関する情報に基づいてコンテンツを返したりアプリケーション・フローを変更することで、その特定のユーザー向けのアプリケーション・エクスペリエンスを提供できます。

パーソナライズは、WC_Utilitiesサーバーのwc_domainにアプリケーションとしてインストールされます。クライアント・アプリケーションは、リモートからHTTP経由でRESTfulサービスを使用してパーソナライズにアクセスします。設計時のJDeveloperツールを使用して、RESTコールを使用してリモートに実行するプロパティ・サービスおよびコンダクタ・アーティファクトを作成します。パーソナライズは、最初にアプリケーションを作成する場合にパーソナライズ・テクノロジ・ライブラリを含むプロジェクト用のJDeveloper統合ドメインでも使用できます。評価目的および反復開発において、このドメインはパーソナライズを最もすばやく簡単に探索できる手段です。パーソナライズのアーキテクチャとサービスの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「Oracle WebCenter Portalアプリケーションのパーソナライズ」を参照してください。

25.2 パーソナライズの前提条件と制限事項

この項では、パーソナライズのシステム要件と依存性について説明します。

- 第25.2.1項「パーソナライズのインストール要件」

- 第25.2.3項「パーソナライズの構成要件」

- 第25.2.4項「パーソナライズのセキュリティ」

- 第25.2.5項「パーソナライズの制限事項」

- 第25.2.6項「パーソナライズの構成オプション」

25.2.1 パーソナライズのインストール要件

パーソナライズ・コンダクタ・シナリオでCMIS (Content Management Interoperability Services)データ・プロバイダ、アクティビティ・グラフ・データ・プロバイダまたはピープル・コネクション・ロケータを使用している場合は、Oracle WebCenter Portalをインストールする必要があります。高可用性環境にかぎり、Coherenceも必要です。

25.2.2 パーソナライズREST APIの構成要件

パーソナライズREST APIは、第24.2項「RESTの有効化に必要な手動構成の実行」で説明するサーバー側の2つの構成を実行した後で使用できるようになります。 セキュリティ・トークンの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のWebCenter Portal REST APIのセキュリティに関する考慮事項に関する項も参照してください。

25.2.3 パーソナライズの構成要件

CMISプロバイダ、アクティビティ・グラフ・プロバイダ、ピープル・コネクション・ロケータまたはカスタム・プロバイダを使用する場合は、これらを第25.4項「プロバイダの構成」の説明に従って構成する必要があります。

ポータルまたはPortal Frameworkアプリケーションでコンテンツ・プレゼンタを使用してコンテンツを表示する場合は、第25.6項「コンテンツ・プレゼンタの構成」の説明に従ってコンテンツ・プレゼンタを構成して、シナリオの結果が表示されるようにする必要もあります。

パーソナライズでは、WebCenter Portalドメイン内の様々な管理対象サーバー間のシングル・サインオン(SSO)を実現するためにトラスト・サービスが使用されます。user_projects/applications/wc_domainディレクトリにあるWLSTスクリプトのconfigureTrustWCPS.pyとconfigureConnectionsWCPS.pyを使用して、トラスト・サービスを構成する必要があります。JDeveloperの統合ドメインの場合は、DefaultDomain/scrpts-wcpsディレクトリにある単一のスクリプト(configureWCPS.py)のみを使用します。このスクリプトによるトラスト・サービスおよびシングル・サインオンの構成の詳細は、第25.7項「シングル・サインオンの構成」を参照してください。

25.2.4 パーソナライズのセキュリティ

パーソナライズは、WLSセキュリティ・レルム内で構成されているどのユーザー認証サービスのソースとも互換性があります。したがって、ドメインのデフォルトのアイデンティティ・ストアおよびポリシー・ストアと資格証明ストアを使用できます。

ピープル・コネクション・ロケータまたはアクティビティ・グラフ・データ・プロバイダを使用している場合、各ユーザーがWebCenter Portalユーザーとしても構成されている必要があります。

パーソナライズRESTサービスには、事前構成されたパーソナライズWebアプリケーションを介してアクセスしますが、このアプリケーションはresourceIndexを除くすべてのリソース(すべてのURI)に対して認証アクセスを要求します。これらの制約を変更して、匿名アクセスが必要なシナリオを実行する際のセキュリティを下げたり、新しいシナリオを作成できないようにセキュリティを強化したりできます。デフォルトのセキュリティ設定の変更については、第25.8項「デフォルトのセキュリティ設定のオーバーライド」を参照してください。

WebCenter Portalでは、トラスト・サービスがパーソナライズRESTコールにシングル・サインオンを提供します。このため、WLS TrustServicesIdentityAsserterを構成する必要があります(事前構成されていません)。これは、WLSコンソールを使用するか、user_projects/applications/wc_domainディレクトリにあるWLSTスクリプトのconfigureTrustWCPS.pyとconfigureConnectionsWCPS.pyを使用して手動で実行できます。JDeveloperの統合ドメインの場合は、DefaultDomain/scrpts-wcpsディレクトリにある単一のスクリプト(configureWCPS.py)を使用します。

必要に応じて、WebCenter Portalアプリケーションからパーソナライズ・サーバーおよびシングル・サインオンを指定したパーソナライズ・プロバイダへの接続を保護することもできます。シングル・サインオンの構成の詳細は、第25.7項「シングル・サインオンの構成」を参照してください。アプリケーションによってプロパティ・サービス・データへのアクセスも制限するには、フィルタ(IPropertyPermission)を使用して、プロパティ・データへのアクセスを事前に認可します。

各シナリオでは、基本ロール評価およびテストをサポートするデフォルトの関数ライブラリを使用して、シナリオへのアクセスを認証できます。

25.2.5 パーソナライズの制限事項

デフォルトでは、パーソナライズは管理対象サーバーに有効範囲が設定されたキャッシュを使用します。つまり、管理対象サーバー外にキャッシュされたデータに変更が加えられた場合、その変更はパーソナライズの追加インストールでは認識されません。パーソナライズのクラスタ化された(複数の)デプロイでは、キャッシュがクラスタに対応するようにCoherenceを構成できます。

25.2.6 パーソナライズの構成オプション

この項では、WebCenter Portalのパーソナライズのデフォルトのプロバイダとその他のオプションの拡張について、およびそれらをパーソナライズ・プロジェクトに統合するために必要な構成について説明します。

デフォルトのパーソナライズ・データ・プロバイダを使用すると、既存のWebCenter Portalツールに基づいてシナリオを記述したり、プロファイル・データにアクセスしたりできます。これらのWebCenter Portalツールは、RESTful Webサービスを介してデータを公開します。パーソナライズ・データ・プロバイダは、これらのWebサービスのRESTクライアントとして機能するので、こうした外部データ・リソースに基づくシナリオをJDeveloper内で簡単に作成できます。独自のデータ・プロバイダおよびプロパティ・ロケータの実装を用意して、独自の外部データ・ソースを統合することもできます。

CMISプロバイダ

CMISプロバイダは、パーソナライズ・プロジェクトでオプションのデータ・ソースとして使用できるデフォルトのプロバイダです。WebCenter Portalコンテンツ・サービスは、CMIS (Content Management Interoperability Services)標準を使用して公開されます。CMIS RESTサービスはWC_Spacesサーバー上で稼働し、(別途の構成の選択に基づいて)Oracle WebCenter Content Serverへのアクセスを提供します。

パーソナライズ・ユーザーがポータル・ユーザーでもある場合は、ポータルを通して格納されているユーザー・コンテンツにシナリオからアクセスできます。Content Serverの詳細は、第9章「コンテンツ・リポジトリの管理」を参照してください。CMISプロバイダの構成の詳細は、第25.4.2項「CMISプロバイダの構成」を参照してください。

アクティビティ・グラフ・データ・プロバイダ

アクティビティ・グラフ・データ・プロバイダは、パーソナライズ・プロジェクトでオプションのデータ・ソースとして使用できるデフォルトのプロバイダです。ポータルまたはPortal Frameworkアプリケーションからのアクティビティ・ストリーム情報は、アクティビティ・グラフを通じて公開されます。アクティビティ・グラフRESTサービスはWC_Spacesサーバー上で稼働し、アクティビティ・グラフによって作成された、アクティビティ・ストリームに基づく推奨へのアクセスを提供します。

パーソナライズ・ユーザーがポータル・ユーザーでもある場合、アクティビティ関連の推奨(ポータルのContent-type用)にシナリオからアクセスできます。アクティビティ・グラフ・サービスの詳細は、第10章「アクティビティ・グラフの管理」を参照してください。アクティビティ・グラフ・プロバイダの構成の詳細は、第25.4.3項「アクティビティ・グラフ・プロバイダの構成」を参照してください。

Oracle People Connectionsロケータ

ピープル・コネクション・ロケータは、パーソナライズ・プロジェクトでオプションのデータ・ソースとして使用できるロケータです。ピープル・コネクションの情報は、ピープルWebサービスを通じて公開されます。ピープル・コネクションRESTサービスはWC_Spacesサーバー上で稼働し、ポータルのコンテキストに作成されたソーシャル・プロファイル・データへのアクセスを提供します。パーソナライズ・ユーザーがポータル・ユーザーでもある場合、ピープル・プロファイル・データにシナリオからアクセスできます。ピープル・コネクションの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「ピープル・コネクションの統合」の章を参照してください。他のデフォルトのデータ・プロバイダとは異なり、ピープル・コネクションWebサービスには、汎用のプロパティ・サービス・データ・プロバイダを介したIPropertyLocator拡張インタフェースを使用してアクセスします。ピープル・コネクション・プロバイダの構成の詳細は、第25.4.4項「Oracle People Connectionsロケータの構成」を参照してください。

25.3 WebCenter OPSSトラスト・サービスの構成

パーソナライズでは、OPSS (Oracle Platform Security Services)の新機能をシングル・サインオンに利用します。パーソナライズの最も単純なユースケースを除くすべてのユースケースで、この機能をここで説明する構成手順に従って有効化する必要があります。

次の場合は、OPSSトラスト・サービスを構成する必要がありません。

- RESTクライアントからコンダクタおよびプロパティ・サービスと直接対話する場合

- コンダクタおよびプロパティ・サービスをパーソナライズ・クライアント・ライブラリが、パーソナライズと同じドメインにデプロイされているカスタムJEE Webアプリケーションから使用している場合で、JSessionIdが両方のWebアプリケーションに対して構成されているとき(多数の例外がログに記録されるのでデバッグが困難になります)

次の場合は、OPSSトラスト・サービスを構成する必要があります。

- パーソナライズが本番デプロイメントの一部である場合

- デフォルトのデータ・プロバイダ(アクティビティ・グラフ、CMISおよびピープル・コネクション・ロケータ)を必要とするパーソナライズ・シナリオがある場合

- コンダクタおよびプロパティ・サービスをパーソナライズ・クライアント・ライブラリが、パーソナライズと同じドメインにデプロイされているカスタムJEE Webアプリケーションから使用している場合

- ドメイン間のトラスト(つまり、WC_domainのCMISプロバイダを使用するように構成された統合ドメイン接続)が必要な場合

この項には次のサブセクションが含まれます:

- 第25.3.1項「Oracle WebCenter Portalドメインでのトラスト・サービスの構成」

- 第25.3.2項「統合WLSドメインでのトラスト・サービスの構成」

- 第25.3.3項「ドメイン間トラストの構成」

25.3.1 Oracle WebCenter Portalドメインでのトラスト・サービスの構成

デフォルトのOracle WebCenter Portalインストールにはパーソナライズ・ドメイン拡張テンプレートが含まれており、このテンプレートは2つのWLST Pythonスクリプト(configureTrustWCPS.pyとconfigureConnectionsWCPS.py)を次のドメイン・ホームにインストールします。

oracle/user_projects/applications/wc_domain/scripts

これらのスクリプトおよび関連するconfigureWCPS.propertiesファイルには、使用方法の説明が記載されています。これらはサンプル・スクリプトであり、実行する前にプロパティ・ファイルを編集して、少なくともocs.server名(通常はContent Server)、spaces.server.host名およびfmwconfig.locationを指定する必要があります。これらの値はOracle WebCenter Portalインストールごとに一意のものなので、編集する必要があります。それ以外の値もローカル環境に応じて変更が必要な場合があります(たとえば、マシン・ポート番号はそれぞれ異なる可能性があります)。

configureConnectionsWCPS.pyスクリプトは、デフォルトのパーソナライズ接続情報(つまり、アクティビティ・グラフ、CMISおよびピープル・コネクションの接続情報)を設定します。このスクリプトはWCPS.pyライブラリを使用しますが、このライブラリはOracle WebCenter Portalドメインにのみインストールされています(統合WLSドメインにはインストールされていません)。ただし、Oracle WebCenter PortalドメインでconfigureConnectionsWCPS.pyを実行して、(t3 URLを使用して)統合WLSドメインを指すようにさせることができます。

注意:
configureTrustWCPS.pyによって設定されるトラスト・サービスの構成は、リモートから適用しないでください。このスクリプトは、WebCenter Portalドメイン(wc_domain)からのみ実行してください。

WCP_ORACLE_HOME/common/bin/wlst.shコマンド・ファイル($WCP_ORACLE_HOME/common/bin/wlst.sh configureconnectionsWCPS.pyなど)を使用して、これらのスクリプトの環境変数を正しく設定する必要があります。

各スクリプトを実行したら、管理サーバーを含むドメイン内の全サーバーを再起動します。

構成のテスト

トラスト・サービスのシングル・サインオンの動作を確認するには、カスタムJEE Webアプリケーションから(パーソナライズ・クライアント・ライブラリを使用して)コンダクタまたはプロパティ・サービスを呼び出すか、パーソナライズ接続(アクティビティ・グラフまたはCMISデータ・プロバイダなど)を使用するシナリオを実行するか、ピープル・コネクション・ロケータを使用してピープル・コネクションのプロパティにアクセスする必要があります。

前述のいずれかを実行すると、次のようなデフォルトのログ・エントリがWC_Utilities-diagnostic.logに記録されます。

[2010-11-10T07:30:40.362-08:00] [WC_Utilities] [NOTIFICATION] [] [oracle.jps.trust] [tid: [ACTIVE].ExecuteThread: '3' for queue: 'weblogic.kernel.Default (self-tuning)']
[ecid: 0000IkqQG4NBh49LJeCCyf1CqfXw000008,0] [APP: wcps-services#11.1.1.4.0] Token issue operation

また、WC_Spaces-diagnostic.logにも次のようなデフォルトのログ・エントリが記録されます(そこでサービスにアクセスしている場合)。

[2010-11-10T07:30:40.236-08:00] [WC_Spaces] [NOTIFICATION] [] [oracle.jps.trust] [tid: [ACTIVE].ExecuteThread: '1' for queue: 'weblogic.kernel.Default (self-tuning)']
[ecid: d461d36d4a552b90:-1fe62a5d:12c365bb19b:-8000-000000000000002c,0] [APP: webcenter#11.1.1.4.0] Token validate operation.

25.3.2 統合WLSドメインでのトラスト・サービスの構成

JDeveloperインストーラには、次のディレクトリにある統合WLSドメインを構成するための別のPythonスクリプトも付属しています。

DefaultDomain\scrpts-wcps\

このスクリプトは、手動でもJDeveloperの「外部ツール」機能を使用しても実行できます。

デフォルト以外のユーザーまたはパスワードを使用している場合は、プロパティ・ファイルを編集してください。統合WLSドメインを作成して起動したら、scrpts-wcpsディレクトリからスクリプトを実行します。

Oracle\MiddlewareRC8\oracle_common\common\bin\wlst.cmd configureWCPS.py configureWCPS.properties

注意:
configureTrustWCPS.pyスクリプトは、「ツール」メニューから「WCPSトラスト・サービスの構成」を選択すると呼び出されます。デフォルトでは、このスクリプトは統合WebLogic Serverのポート7101を参照します。なんらかの理由で、デフォルトの統合WebLogic Serverのポート番号が変更されている場合は、configureWCPS.propertiesファイルを正しいポート番号で更新する必要があります。このスクリプトとプロパティのファイルは、次のドメイン内に配置されています。
\system*\DefaultDomain\scrpt-wcps\configureWCPS.properties

\system*\DefaultDomain\scrpt-wcps\configureWCPS.py

configureWCPS.propertiesファイルで、次の行を変更する必要があります。

admin.url=t3://localhost:7101

統合WLSドメインを再起動します。

構成のテスト

トークン発行操作およびトークン検証操作を確認するには、デフォルトのロギング・レベルでは不十分です。次に示すように、JDeveloperの「Oracle Diagnostic Loggingの構成」機能を使用して、oracle.jps.trustロガーに移動し、レベルをFinestに設定します。

1. 「表示」メニューの「アプリケーション・サーバー・ナビゲータ」を選択します。

2. 「アプリケーション・サーバー」を開きます。

3. 「IntegratedWeblogicServer」を右クリックして、「Oracle Diagnostic Loggingの構成」を選択します。

4. ロギング・レベルをFinestに設定します。

コンダクタまたはプロパティ・サービスを呼び出すカスタムJEE Webアプリケーションを含むシナリオを実行します。

25.3.3 ドメイン間トラストの構成

トラスト・サービスはドメイン間トラストをサポートしています。つまり、複数の異なるWLSドメインにキーストアが作成されている場合、クライアントはドメイン「A」でトークンを割り当て、そのトークンを使用したHTTPリクエストをドメイン「B」に対して発行し、シングル・サインオンによるドメイン「B」でのユーザー/リクエストの検証および認証をアイデンティティ・アサータに実行させることができます。ただし、重要な前提として、ドメイン「A」内のユーザーと同じユーザーがドメイン「B」に存在する必要があります。

デフォルトでは、統合WLSドメインでconfigureWCPS.pyスクリプトを実行すると、extDomain.cerという名前の証明書が生成されます。統合WLSドメインとOracle WebCenter Portalドメインの間のドメイン間トラストを有効にする手順は次のとおりです。

extDomain.cerをOracle WebCenter Portalドメイン(wc_domain)インストールにコピーして、そこでインポートします。extDomain.cerファイルをscriptsディレクトリにコピーします。

oracle/user_projects/applications/wc_domain/scripts

次のコマンドを入力して証明書をインポートします。

keytool -importcert -alias orakey1 -file extDomain.cer -keystore ../../../../wlserver_10.3/wc_domain/config/fmwconfig/default-keystore.jks -storepass weblogic

Oracle WebCenter Portalドメイン内の各サーバーを再起動します。

構成のテスト

ドメイン間トラストを検証する最も簡単な方法は、まず、WebCenter PortalドメインのWC_Spacesサーバーを指すピープル・コネクション・パーソナライズ接続を統合WLSドメインに作成します。次に、ピープル・コネクションのプロパティ値を取得する簡単なシナリオを作成して、統合WLSドメインにデプロイします。最後に、前述の「トークン検証操作」というメッセージがWC_Spacesサーバーのログに記録されていることを確認します。

25.4 プロバイダの構成

WebCenter Portalのパーソナライズには、アクティビティ・グラフ用およびContent Server用のデフォルトのプロバイダと、ピープル・コネクション用のロケータが用意されています。これらのプロバイダのいずれかを使用するシナリオでは、次の各項の説明に従って、WLSTスクリプトのconfigureWCPS.pyを使用してプロバイダを構成する必要があります。カスタムのプロバイダまたはロケータを使用している場合は、カスタム・プロバイダの構成に関する項の説明に従って、それらも構成する必要があります。シナリオでプロバイダやロケータを使用していない場合は、プロバイダやロケータを構成する必要はありません。

デフォルトのプロバイダを使用しないシナリオや、カスタムのプロバイダまたはOracle Technology Network (OTN)からダウンロードしたプロバイダのみを使用するシナリオも開発できます。また、JDeveloper統合ドメイン内のみで開発する場合は、通常、これらのWC_Spacesベースのサービスにはアクセスできません(WebCenter Portalは統合ドメイン内では稼働しないため)。拡張構成(configureWCPS.pyでもサポートされています)を使用すれば、WC_Spacesドメイン内のWebCenter Portalサービスに統合ドメインのパーソナライズ・サーバーからアクセスできます。これにはドメイン間トラストを使用するので、プロバイダ接続を構成する必要があります。WC_Spacesドメイン内にあるconfigureTrustWCPS.pyスクリプトとconfigureConnectionsWCPS.pyスクリプトを使用するか、DefaultDomain/scrpts-wcpsドメイン・ディレクトリにあるJDeveloperの統合WLSドメイン用のconfigureWCPS.pyスクリプトを使用して、適切なWLS管理サーバーをポイントすることにより、対応するドメインを構成します。

- 第25.4.1項「プロバイダ接続設定の作成または変更」

- 第25.4.2項「CMISプロバイダの構成」

- 第25.4.3項「アクティビティ・グラフ・プロバイダの構成」

- 第25.4.4項「Oracle People Connectionsロケータの構成」

- 第25.4.5項「カスタム・プロバイダの構成」

25.4.1 プロバイダ接続設定の作成または変更

この項では、WLSTおよびFusion Middleware Controlを使用して、接続情報を作成または変更する方法について説明します(wcps-connections.xmlに格納)。また、カスタム・プロバイダを構成するためのカスタム構成クラスを記述する方法についても説明します。

この項には次のサブセクションが含まれます:

- 第25.4.1.1項「パーソナライズ接続情報の理解」

- 第25.4.1.2項「接続構成の属性」

- 第25.4.1.3項「WLSTを使用した接続の構成」

- 第25.4.1.4項「Fusion Middleware Controlを使用した接続の構成」

- 第25.4.1.5項「カスタム構成クラスの記述」

25.4.1.1 パーソナライズ接続情報の理解

パーソナライズ接続情報は、ドメイン・ディレクトリ内の次の場所にあるwcps-connections.xmlに保持されています。

<domain directory>/config/fmwconfig/wcps-connections.xml

このファイルを直接編集することはお薦めできませんが、接続情報を変更するには、次のように複数の方法があります。

- WLST: WLSTコマンドを使用してスクリプトを作成することにより、接続構成を表すシステムMBeansにアクセスできます。WLSTコマンドを使用して接続設定を構成する方法の詳細は、第25.4.1.3項「WLSTを使用した接続の構成」を参照してください。

- Fusion Middleware Control: Fusion Middleware Controlを使用して、パーソナライズとともにデプロイされたJMX MBeansを表示または編集できます。Fusion Middleware Controlを使用して接続設定を構成する方法の詳細は、第25.4.1.4項「Fusion Middleware Controlを使用した接続の構成」を参照してください。

25.4.1.2 接続構成の属性

接続プロパティは、次の形式でwcps-connections.xmlに保持されています。

<properties>
<property>
<name>{property name}</name>
<value>{property val}</value>
</property>

WLSTまたはFusion Middleware Controlを使用して変更できる接続プロパティと属性を次に示します。各接続プロパティは、接続に使用されるプロバイダまたはロケータに固有のものです。たとえば、CMISプロバイダでは、アクティビティ・グラフ・プロバイダとは異なる接続プロパティが使用されます。

- <connection-name>: この接続の一意の名前。接続は名前によって取得できます。

- <connection-type>: この接続の一意のタイプ。接続はタイプによって取得できます。connection-typeを指定する必要があるのは、カスタム接続の場合のみです。デフォルトのデータ・プロバイダの場合、このフィールドは内部的に設定されています。

- <namespace>: 一般的に、アクセスするシナリオがデプロイされるネームスペースに一致する必要があります。ネームスペースでは、特定のシナリオに対する適切な<connection>を検索する方法をコンダクタが決定します。ワイルドカードの「*」を使用すると、この接続要素をすべてのネームスペースで使用可能にできます。WLSTスクリプト内で指定されない場合、namespaceのデフォルトは「*」になります。

- <name>isDefault</name>: この接続をデフォルトの接続としてマークします(複数が定義されている場合)。これは接続プロパティなので、次の形式になっている必要があります。

<properties>
<property>
<name>isDefault</name>
<value>true</value>
</property>
</properties>

複数の接続の「isDefault」フラグをtrueに設定できます。この場合、どのデフォルト接続を返すかは個々のプロバイダ次第です。

25.4.1.3 WLSTを使用した接続の構成

プロバイダ接続を簡単に構成できるように、一連のパーソナライズWLSTコマンドが用意されています。これらのコマンドを組み合せてスクリプトを作成できます。スクリプトの例が用意されており、これをカスタマイズしたり、直接使用することができます。このサンプル・スクリプトは、プロバイダ接続を設定し、さらにトラスト・サービスを初期化します。

パーソナライズWLSTコマンドはWCP_ORACLE_HOME/common/wlst/WCPS.pyにインストールされており、WCP_ORACLE_HOME/common/bin/wlst.sh (cmd)スクリプトを使用して呼び出します。

初期状態の各データ・プロバイダは、次の各項で説明する特定のWLSTコマンドでサポートされています。カスタムのデータ・プロバイダについては、汎用のWLSTコマンドを使用して接続を構成します。例:

createWCPSCustomConnection('customConnectionName', 'connectionType', properties={ 'name1': 'value1', 'name2': 'value2' })

パーソナライズWLST接続およびその他のコマンドの全リストは、『WebLogic Scripting Toolコマンド・リファレンス』のパーソナライズに関する項を参照してください。

25.4.1.4 Fusion Middleware Controlを使用した接続の構成

Fusion Middleware Controlを使用して、パーソナライズとともにデプロイされたJMX MBeans (アクティビティ・グラフ、Content Serverおよびピープル・コネクションの接続構成MBeans)を表示または編集できます。

接続構成MBeansを表示または編集する手順は次のとおりです。

1. Fusion Middleware Controlを開き、「パーソナライズ・サービス(Personalization Services)」に移動します。

2. 「WCPS-Services」をクリックします。

3. 「アプリケーション開発」ドロップダウン・メニューから、「システムMBeanブラウザ」を選択します。

4. 「アプリケーション定義のMBean」の下の「MBeanブラウザ」でoracle.wcps.connectionsを選択し、変更する接続情報までドリルダウンします。

5. 「属性」タブで、「プロパティ」を選択して接続属性の現在の値を表示します。

6. 「操作」タブで、「setProperty」を選択し、「起動」をクリックして名前/値ペアを変更します。

25.4.1.5 カスタム構成クラスの記述

カスタム構成クラス(@ConnectionConfigurationという注釈付きのクラス)を実装するには、独自のデータ・プロバイダを記述します。これにより、カスタム・データ・プロバイダがパーソナライズ接続フレームワークを使用して、パーソナライズWLSTスクリプトによって構成された接続情報を取得できるようになります。

データ・プロバイダのカスタム構成クラスについては、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「カスタム・データ・プロバイダの実装: 概要」で詳細に説明されています。

25.4.2 CMISプロバイダの構成

統合WLSドメイン以外(つまり、WC_Spacesドメイン内)で作業している場合、CMISプロバイダをシナリオで使用するには、まずその接続設定を構成する必要があります。

CMISプロバイダの接続設定は、wc_domainコンダクタ拡張ディレクトリにあるwcps-connections.xmlに保持されています(ドメインが有効範囲)。このファイルを直接編集することはお薦めできませんが、接続設定を変更するには、次のように複数の方法があります。第25.4.1項「プロバイダ接続設定の作成または変更」で説明している方法のいずれかを使用して、CMISプロバイダの接続設定を構成してください。

接続要素およびプロパティの説明

<connection-name>: この接続の一意の名前。接続は名前によって取得できます。

<connection-type>cmis.provider.connection</connection-type>: CMISプロバイダの接続タイプを定義します。

<namespace>: 一般的に、アクセスするシナリオがデプロイされるネームスペースに一致する必要があります。ネームスペースでは、特定のシナリオに対する適切な<connection>を検索する方法をコンダクタが決定します。ワイルドカードの「*」を使用すると、この接続要素をすべてのネームスペースで使用可能にできます。

<name>isDefault</name>: この接続をデフォルトの接続としてマークします(複数の接続が定義されている場合)。

<name>repositoryId</name>: 使用環境内のコンテンツ・リポジトリと一致するように、このプロパティを変更する必要があります。

<name>path</name>: 使用環境内のコンテンツ・リポジトリと一致するように、このプロパティを変更する必要があります。指定しない場合のデフォルトは/api/cmis/repository/repositoryIdです。

<name>scheme</name>: CMIS RESTサービスにアクセスするプロトコル(HTTPまたはSSL用のHTTPS)。明示的に指定しない場合、デフォルトはHTTPに設定されています。

<name>host</name>: CMIS RESTサービスをホストするマシンの名前。これは、WC_Spaces管理対象サーバーのマシン名です。

<name>port</name>: CMIS RESTサービスをホストするマシンのポート番号。これは、WC_Spaces管理対象サーバーのマシンのポート番号です。

<name>pathTrim</name>: 明示的に指定しない場合のデフォルトは切捨てなしです。

<name>rewriteUrls</name>: 「なし」、「コンシューマ」または「プロデューサ」に設定できます。詳細は、RESTプロキシのページを参照してください。ドキュメント・リンクのCMISサーバーからのダイレクトURLが必要な場合、これを「なし」に設定します。デフォルトはリライトなし(「なし」)です。

<name>username</name>: (オプション) CMIS RESTサービスとの接続時に使用するユーザー名。固定のユーザー名への接続を強制するために使用できます。

<name>password</name>: (オプション) CMIS RESTサービスとの接続時に使用するパスワード。usernameと組み合せて、固定のユーザー名/パスワードへの接続を強制するために使用できます。パスワード・アクセスが保護されていないため、開発環境外で使用することはお薦めしません。

<name>timeoutInMillisecs</name>: CMIS問合せ読取りレスポンスがタイムアウトになるまでの時間(ミリ秒)。

<name>propagateTimeoutExceptions</name>: trueの場合、タイムアウト例外を伝播します。それ以外の場合は、例外をログに記録し、CMIS問合せレスポンスに対してNULLを返します。

<name>restResourceURL</name>: restResourceURLは、CMIS RESTサービスのAPIリソースを定義する、REST URLのエンドポイントです。

<property>
<name>restResourceURL</name>
<value><a target="_blank" href="http://my.webcenter.host:8888/rest/api/resourceIndex">http://my.webcenter.host:8888/rest/api/resourceIndex</a></value>
</property>

25.4.3 アクティビティ・グラフ・プロバイダの構成

統合WLSドメイン以外(つまり、WC_Spacesドメイン内)で作業している場合、アクティビティ・グラフ・プロバイダに基づくシナリオを使用するには、ローカル環境に応じた接続情報を構成する必要があります。

アクティビティ・グラフの接続設定は、wc_domainコンダクタ拡張ディレクトリにあるwcps-connections.xmlに保持されています(ドメインが有効範囲)。このファイルを直接編集することはお薦めできませんが、接続設定を変更するには、次のように複数の方法があります。第25.4.1項「プロバイダ接続設定の作成または変更」で説明している方法のいずれかを使用して、アクティビティ・グラフ・プロバイダの接続設定を構成してください。

接続要素およびプロパティの説明

<connection-name>: この接続の一意の名前。接続は名前によって取得できます。

<connection-type>activity.provider.connection</connection-type>: アクティビティ・グラフ・プロバイダの接続タイプを定義します。

<namespace>: 一般的に、アクセスするシナリオがデプロイされるネームスペースに一致する必要があります。ネームスペースでは、特定のシナリオに対する適切な<connection>を検索する方法をコンダクタが決定します。ワイルドカードの「*」を使用すると、この接続要素をすべてのネームスペースで使用可能にできます。

<name>isDefault</name>: この接続をデフォルトの接続としてマークします(複数の接続が定義されている場合)。

<name>scheme</name>: アクティビティ・グラフRESTサービスにアクセスするプロトコル(HTTPまたはSSL用のHTTPS)。明示的に指定しない場合、デフォルトはHTTPに設定されています。

<name>host</name>: アクティビティ・グラフRESTサービスをホストするマシンの名前。これは、WC_Spaces管理対象サーバーのマシン名です。

<name>port</name>: アクティビティ・グラフRESTサービスをホストするマシンのポート番号。これは、WC_Spaces管理対象サーバーのマシンのポート番号です。

<name>rewriteUrls</name>: 「なし」、「コンシューマ」または「プロデューサ」に設定できます。詳細は、RESTプロキシのページを参照してください。ドキュメント・リンクのCMISサーバーからのダイレクトURLが必要な場合、これを「なし」に設定します。デフォルトはリライトなし(「なし」)です。

<name>user</name>: (オプション)アクティビティ・グラフRESTサービスとの接続時に使用するユーザー名。

<name>password</name>: (オプション)アクティビティ・グラフRESTサービスとの接続時に使用するパスワード。usernameと組み合せて、固定のユーザー名/パスワードへの接続を強制するために使用できます。パスワード・アクセスが保護されていないため、開発環境外で使用することはお薦めしません。

<name>restResourceIndex</name>: RESTリソース索引のhost/portの後ろに追加するURI接尾辞(例: '/rest/api/resourceIndex')

<name>restResourceURL</name>: restResourceURLは、アクティビティ・グラフRESTサービスのAPIリソースを定義する、REST URLのエンドポイントです。

<property>
<name>restResourceURL</name>
<value><a target="_blank" href="http://my.webcenter.host:8888/rest/api/resourceIndex">http://my.webcenter.host:8888/rest/api/resourceIndex</a></value>
</property>

25.4.4 Oracle People Connectionsロケータの構成

統合WLSドメイン以外(つまり、WC_Spacesドメイン内)で作業している場合、ピープル・コネクション・ロケータに基づくシナリオを使用するには、ローカル環境に応じた接続情報を構成する必要があります。

プロパティ・サービスでは、ピープル・コネクション・サービスとの接続にIPropertyLocator (ピープル・コネクションIPropertyLocator)が使用されます。ピープル・コネクション・サービスと接続するプロパティ・プロバイダは、このIPropertyLocatorを使用して特定のユーザー(または自身)に対するピープル・コネクションRESTコールを行い、そのRESTサービス・コールが表すPersonオブジェクトを返します。Personの各属性は、そのWebCenter Portalプロファイルの各値を表します。

ピープル・コネクションIPropertyLocatorの接続設定は、wc_domainコンダクタ拡張ディレクトリにあるwcps-connections.xmlに保持されています(ドメインが有効範囲)。このファイルを直接編集することはお薦めできませんが、接続設定を変更するには、次のように複数の方法があります。第25.4.1項「プロバイダ接続設定の作成または変更」で説明している方法のいずれかを使用して、ピープル・コネクションIPropertyLocatorの接続設定を構成してください。

接続要素およびプロパティの説明

<connection-name>: この接続の一意の名前。接続は名前によって取得できます。

<namespace>: 一般的に、アクセスするシナリオがデプロイされるネームスペースに一致する必要があります。ネームスペースでは、特定のシナリオに対する適切な<connection>を検索する方法をコンダクタが決定します。ワイルドカードの「*」を使用すると、この接続要素をすべてのネームスペースで使用可能にできます。

<name>isDefault</name>: この接続をデフォルトの接続としてマークします(複数が定義されている場合)。

<name>scheme</name>: ピープル・コネクションRESTサービスにアクセスするプロトコル(HTTPまたはSSL用のHTTPS)。明示的に指定しない場合、デフォルトはHTTPに設定されています。

<name>host</name>: ピープル・コネクションRESTサービスをホストするマシンの名前。これは、WC_Spaces管理対象サーバーのマシン名です。

<name>port</name>: ピープル・コネクションRESTサービスをホストするマシンのポート番号。これは、WC_Spaces管理対象サーバーのマシンのポート番号です。

<name>user</name>: (オプション)ピープル・コネクションRESTサービスとの接続時に使用するユーザー名。固定のユーザー名への接続を強制するために使用できます。

<name>password</name>: (オプション)ピープル・コネクションRESTサービスとの接続時に使用するパスワード。usernameと組み合せて、固定のユーザー名/パスワードへの接続を強制するために使用できます。パスワード・アクセスが保護されていないため、開発環境外で使用することはお薦めしません。

<name>restResourceIndex</name>: ピープル・コネクションRESTサービスのhost/portの後ろに追加され、resourceIndex (使用可能なRESTサービス)ページの位置を指します(例: '/rest/api/resourceIndex')。

プロパティ・プロバイダへのPersonクラスのブートストラップ

プロパティ・サービスがピープル・コネクションRESTコールの結果を認識して使用するためには、「Person」を認識する必要があります。つまり、「Person」をインスタンス化してそのプロパティを設定する前に、「Person」プロパティ・セット定義を作成するとともに、その個々の属性をプロパティ定義として設定する必要があります。

ピープル・コネクションIPropertyLocatorのコードでは、このプロセスを、次の例のようにweb.xmlファイルで構成されているサーブレット・リスナーでブートストラップして実行してします。

<?xml version="1.0" encoding="UTF-8" ?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
version="2.4">

<!-- Allows connection config classes to be loaded from the connections.xml file -->
<listener>
<listener-class>oracle.wcps.connection.lifecycle.VersatileModuleLifecycleCallback</listener-class>
</listener>

<listener>
<listener-class>oracle.wcps.people.util.BootstrapPropertiesListener</listener-class>
</listener>

</web-app>

ピープル・コネクションREST接続の構成情報へのアクセス

ピープル・コネクションIPropertyLocatorは実際の「プロバイダ」ではないため、アクティビティ・グラフなどのように、プロバイダ・コード内のその接続情報にはアクセスできません。そのかわりに、内部コードではVersatileModuleLifecycleCallbackを使用して、その構成情報を使用できるようにしています。したがって、これはweb.xmlで必ず構成する必要があるリスナーとなります。このリスナーがアクティブ化されたら、コードで接続情報にアクセスするコールを行い、IPropertyLocatorコードをパラメータ化してピープル・コネクションRESTサーバーを指すことができます。

PC IPropertyLocatorとプロパティ・サービス・プロバイダの接続

プロパティ・サービス・プロバイダ(PSP)は、ピープル・コネクションIPropertyLocatorをネームスペースによって認識します。前述のブートストラップ・プロセスでは、PropertySetDefinition (とその定義)に「people.connections.person」およびロケータ・クラス「oracle.wcps.people.property.PeoplePropertyLocator」というネームスペースが指定されています。PSPの使用時に、namespaceとPropertySetDefinitionがPSPに渡されます。PSPは、PropertySetDefinitionで定義されているロケータ・クラスを使用してインスタンス化し、プロパティ値(ピープル・コネクションRESTサービスからのPersonの値)に委譲します。

このプロセスではロケータとネームスペースが非常に重要です。これらは、内部クラスPropertyDefConstantsで定数として定義されています。これらを構成する必要はありません。

25.4.5 カスタム・プロバイダの構成

アクティビティ・グラフの接続設定は、wc_domainコンダクタ拡張ディレクトリにあるwcps-connections.xmlに保持されています(ドメインが有効範囲)。このファイルを直接編集することはお薦めできませんが、接続設定を変更するには、次のように複数の方法があります。第25.4.1項「プロバイダ接続設定の作成または変更」で説明している方法のいずれかを使用して、カスタム・プロバイダの接続設定を構成してください。構成ファイルの要素とプロパティの詳細は、第25.4.1.2項「接続構成の属性」を参照してください。

25.5 Coherenceの構成

インストールでCoherenceを使用してキャッシュしている場合(「高可用性」環境の要件)、ネームスペース、プロパティ定義、プロパティ・セット定義およびプロパティ・セットに対して1つずつ、計4つのキャッシュを個別に設定する必要があります。

次のサンプルwcps-cache-config.xml構成ファイルは、単純なCoherenceローカル・キャッシュの構成方法を示しています。より高度なキャッシュ・タイプについては、Coherenceのドキュメントを参照してください。Coherenceの各クラスは、パーソナライズと同じクラス・ローダーによってアクセスできる必要があります。Coherenceのwcps-cache-config.xmlファイルも同じクラス・ローダーによってアクセスできる必要があります。詳細は、Oracle WebCenter Portal Java APIリファレンスで、WebCenter PortalのJavaDocのoracle.wcps.cache.CacheFactoryクラスを参照してください。『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のキャッシュ・メカニズムとしてのCoherenceの構成に関する項も参照してください。

<?xml version="1.0" encoding="UTF-8" ?>
<cache-config>
<caching-scheme-mapping>
<cache-mapping>
<cache-name>com.oracle.p13n.service.property.namespaces</cache-name>
<scheme-name>ns-local-side</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>com.oracle.p13n.service.property.propertydefinitions_*</cache-name>
<scheme-name>pd-local-side</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>com.oracle.p13n.service.property.propertysetdefinitions_*</cache-name>
<scheme-name>psd-local-side</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>com.oracle.p13n.service.property.propertysets_*</cache-name>
<scheme-name>ps-local-side</scheme-name>
</cache-mapping>
<cache-mapping>
<cache-name>*</cache-name>
<scheme-name>properties-default-local</scheme-name>
</cache-mapping>
</caching-scheme-mapping>

<caching-schemes>
<!--
The following schemes are all local.  For a clustered deployment,
a distributed, replcated, or other clustered scheme is recommended.
See Coherence documentation for more information.
-->

<local-scheme>
<scheme-name>ns-local-side</scheme-name>
<service-name>NamespaceCache</service-name>

<eviction-policy>HYBRID</eviction-policy>
<high-units>{back-size-limit 0}</high-units>
<unit-calculator>FIXED</unit-calculator>
<expiry-delay>{back-expiry 1h}</expiry-delay>
<flush-delay>1m</flush-delay>

<cachestore-scheme/>
</local-scheme>

<local-scheme>
<scheme-name>pd-local-side</scheme-name>
<service-name>PropertyDefinitionCache</service-name>

<eviction-policy>HYBRID</eviction-policy>
<high-units>{back-size-limit 0}</high-units>
<unit-calculator>FIXED</unit-calculator>
<expiry-delay>{back-expiry 1h}</expiry-delay>
<flush-delay>1m</flush-delay>

<cachestore-scheme/>
</local-scheme>

<local-scheme>
<scheme-name>psd-local-side</scheme-name>
<service-name>PropertySetDefinitionCache</service-name>

<eviction-policy>HYBRID</eviction-policy>
<high-units>{back-size-limit 0}</high-units>
<unit-calculator>FIXED</unit-calculator>
<expiry-delay>{back-expiry 1h}</expiry-delay>
<flush-delay>1m</flush-delay>

<cachestore-scheme/>
</local-scheme>

<local-scheme>
<scheme-name>ps-local-side</scheme-name>
<service-name>PropertySetCache</service-name>

<eviction-policy>HYBRID</eviction-policy>
<high-units>{back-size-limit 0}</high-units>
<unit-calculator>FIXED</unit-calculator>
<expiry-delay>{back-expiry 1h}</expiry-delay>
<flush-delay>1m</flush-delay>

<cachestore-scheme/>
</local-scheme>

<local-scheme>
<scheme-name>properties-default-local</scheme-name>
<service-name>DefaultCache</service-name>

<eviction-policy>HYBRID</eviction-policy>
<high-units>{back-size-limit 0}</high-units>
<unit-calculator>FIXED</unit-calculator>
<expiry-delay>{back-expiry 1h}</expiry-delay>
<flush-delay>1m</flush-delay>

<cachestore-scheme/>
</local-scheme>

</caching-schemes>

</cache-config>

25.6 コンテンツ・プレゼンタの構成

コンテンツ・プレゼンタを使用してパーソナライズのシナリオを実行するには、まず接続ファイル(connections.xml)を構成して、コンテンツ・プレゼンタがコンダクタ・サーバーおよびタグ付きシナリオを認識できるようにする必要があります。コンテンツ・プレゼンタの詳細は、『Oracle WebCenter Portalでのポータルの構築』の「コンテンツ・プレゼンタを使用したコンテンツの公開」を参照してください。

connections.xmlには、WebCenter Portal側で使用するアプリケーションの接続情報が格納されています。コンテンツ・プレゼンタは、このファイルに登録されているURL接続の全リストを取得し、「Conductor」で始まるURL接続を、コンダクタ・サーバーを指すURLとみなします。connections.xmlの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の付録A「WebCenter Portalファイル」を参照してください。

コンテンツ・プレゼンタはWC_Spacesサーバー上で実行しますが、パーソナライズのシナリオはWC_Utilitiesサーバーで実行されるため、ドメイン間トラスト・サービスも構成する必要があります。詳細は、第25.3項「WebCenter OPSSトラスト・サービスの構成」を参照してください。

コンテンツ・プレゼンタ・タスク・フローの構成は、実行時に行うか、コンテンツ・プレゼンタ・タスク・フローをページに追加するときにJDeveloperから行うことができます。コンテンツ・プレゼンタのこの2種類の構成方法と、コンダクタ側の構成要件について、次の各項で説明します。

- 第25.6.1項「WebCenter PortalアプリケーションのContent Server接続の構成」

- 第25.6.2項「コンテンツ・プレゼンタ・タスク・フローのパラメータの構成」

- 第25.6.3項「コンダクタのシナリオ・タグの構成」

25.6.1 WebCenter PortalアプリケーションのContent Server接続の構成

Portal Frameworkアプリケーションでは、JDeveloperを使用してURL接続を設定するか、第25.6.2項「コンテンツ・プレゼンタ・タスク・フローのパラメータの構成」の説明に従ってコンテンツ・プレゼンタ・タスク・フローのパラメータを設定します。 WebCenter Portalでは、WLSTコマンドまたはFusion Middleware Controlのいずれかを使用して接続を構成できます。

この項には次のサブセクションが含まれます:

- 第25.6.1.1項「WLSTを使用したWebCenter Portalの接続の構成」

- 第25.6.1.2項「Fusion Middleware Controlを使用したWebCenter Portalの接続の構成」

25.6.1.1 WLSTを使用したWebCenter Portalの接続の構成

WebCenter Portalでは、WLSTコマンドのadf_createHttpUrlConnectionを使用してURL接続を管理できます。次に例を示します。

adf_createHttpUrlConnection('webcenter','Conductor','http://example.com:8891/wcps/api/conductor?namespace=CP_namespace&

adf_createHttpUrlConnectionコマンドの詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のadf_createHttpUrlConnectionに関する項を参照してください。

25.6.1.2 Fusion Middleware Controlを使用したWebCenter Portalの接続の構成

WebCenter Portalでは、Fusion Middleware Controlを使用して接続を構成できます。

Fusion Middleware Controlを使用して接続を構成するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。
第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「ADF」→「ADF接続の構成」を選択します。
「ADF接続構成」ページが表示されます(図25-1を参照)。

図25-1 「ADF接続構成」ページ

3. 「接続タイプ」を「URL」に設定し、「接続名」に「Conductor」と入力して、「接続の作成」をクリックします。
「URL接続」セクションが表示されます(図25-2を参照)。

図25-2 「ADF接続構成」ページ(URL接続)

4. 「編集」(鉛筆)アイコンをクリックします。
「URL接続」ダイアログが表示されます(図25-3を参照)。

図25-3 「URL接続」ダイアログ

5. URLを編集して、WebCenter Portalアプリケーションが使用するContent ServerインスタンスをURLが指すようにします。例:

http://example.com:8891/wcps/api/conductor?namespace=CP_namespace&repoId=myhost-ucm11g

6. 必要に応じて、その他のフィールドをローカル接続に合せて更新し、「OK」をクリックします。

25.6.2 コンテンツ・プレゼンタ・タスク・フローのパラメータの構成

コンテンツ・プレゼンタのインスタンスは、そのタスク・フロー・パラメータによって構成できます。これらのパラメータは、実行時に「コンテンツ・プレゼンタ構成」ダイアログで設定するか、コンテンツ・プレゼンタ・タスク・フローの追加時にJDeveloperから設定できます。これを手動で行うには、2つのパラメータを設定する必要があります。Data Source TypeパラメータをdsTypeScenarioResultsに設定し、Data Sourceパラメータを次のように設定してください。

conductor-connection-name=ConductorConnectionName,namespace=
ScenarioNamespace,scenario-name=ScenarioName,inputparam1=value1,inputparam2=value2

conductor-connection-nameの値は、有効なコンダクタ・サーバーを指すURL接続と一致する必要があります。また、使用するネームスペースには、指定のシナリオが属しているネームスペースの名前を指定してください。最後に、シナリオで要求される任意の入力パラメータを追加できます。それには、前述のように名前/値ペアをカンマで区切って指定します。

パーソナライズ用のコンテンツ・プレゼンタの構成の詳細は、次を参照してください。

- 実行時: 『Oracle WebCenter Portalでのポータルの構築』のコンテンツ・プレゼンタ・タスク・フローのプロパティ設定に関する項。

- JDeveloper: 『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のコンテンツ・プレゼンタ・タスク・フロー・パラメータおよび初期設定の表示テンプレートに関する項。

25.6.3 コンダクタのシナリオ・タグの構成

コンダクタ側では、シナリオをコンテンツ・プレゼンタに認識させるための適切なタグがシナリオに必要です。コンテンツ・プレゼンタでは、ContentPresenterScenarioというタグを使用します。したがって、コンテンツ・プレゼンタに認識させる必要があるシナリオはすべて、このタグの関連付けが必要です。

コンダクタ側とWebCenter Portalアプリケーション側の両方ですべての設定が完了したら、後は簡単です。「コンテンツ・プレゼンタ構成」ダイアログを開くと、「コンテンツ・ソース」選択リストに「シナリオ結果」が表示されます。これを選択すると、コンテンツ・プレゼンタを使用するようにタグ付けされているすべてのシナリオが表に表示されます。最初のシナリオが必ず選択されており、そのシナリオに入力パラメータが定義されている場合は、入力パラメータが表の下に入力フィールドとともに表示されます。

表で別のシナリオを選択すると、下の入力パラメータが更新されます。シナリオを選択して入力パラメータを指定したら、コンテンツ・プレゼンタをプレビューまたは保存して結果を取得できます。結果は、他の複数値コンテンツ・ソースと同様に表示されます。最終的には、表示用に選択したテンプレートに基づいて表示されます。

注意:
シナリオから返され、コンテンツ・プレゼンタ内で使用される結果は、有効なCMIS問合せであることが必要です。コンテンツ・プレゼンタは戻り値を取得し、それを(CMIS問合せとして)コンダクタURL内で指定されているリポジトリに対して実行するからです。

25.7 シングル・サインオンの構成

シングル・サインオンの構成は、configureTrustWCPS.pyスクリプトとconfigureConnectionsWCPS.pyスクリプトを実行してOracle WebCenter Portalドメインを構成する一環として行われるか、またはconfigureWCPS.pyスクリプトを実行してJDeveloperの統合WLSドメインを構成する一環として行われます。これらのスクリプトを実行すると、トラスト・サービス・シングル・サインオンも設定されます。これにより、クライアントJEE Webアプリケーション、パーソナライズWebアプリケーション、およびデフォルトのデータ・プロバイダで使用されるWC_Spaces WebアプリケーションRESTサービスの間でREST HTTPリクエストのシングル・サインオンが可能になります。これらのアプリケーションはすべて、OAM/OSSOが提供するシングル・サインオン・トークンもサポートするように構成されます。追加のパーソナライズ固有の構成は必要ありません。詳細は、第25.3.3項「ドメイン間トラストの構成」を参照してください。

25.8 デフォルトのセキュリティ設定のオーバーライド

デフォルトでは、パーソナライズRESTリソース(resourceIndexを除く)へのすべてのアクセスには認証が要求されます。ほとんどの場合、開発用にはこれで十分です。ただし、本番環境では、このデフォルトのセキュリティ制約を変更する場合があります。次の各項では、匿名アクセスが必要なシナリオを実行する際のセキュリティを下げる方法や、新しいシナリオを作成できないようにセキュリティを強化する方法について説明します。

この項には次のサブセクションが含まれます:

- 第25.8.1項「シナリオの匿名実行の許可」

- 第25.8.2項「匿名ユーザーによるシナリオの作成の禁止」

- 第25.8.3項「認証されたユーザーによるシナリオの作成の禁止」

25.8.1 シナリオの匿名実行の許可

次のセキュリティ制約をドメインのconductor-extensions-library\WEB-INF\web.xmlファイルに追加すると、デフォルトの記述子の(認証を要求する)セキュリティを遵守しながら、匿名のアプリケーションまたはネームスペースから作成またはデプロイされたシナリオに対する匿名GET/POSTが許可されます。

<security-constraint>
<web-resource-collection>
<web-resource-name>ConductorJerseyWebApplication</web-resource-name>
<url-pattern>/api/conductor/namespaces/anonymous/scenarios/*</url-pattern>
<http-method>GET</http-method>
<http-method>POST</http-method>
</web-resource-collection>
<!-- Allow anonymous user access&nbsp; in this namespace -->
<!--auth-constraint>
<role-name>Users</role-name>
</auth-constraint-->
</security-constraint>

25.8.2 匿名ユーザーによるシナリオの作成の禁止

簡単なフィルタをドメインのconductor-extensions-library\WEB-INF\web.xmlに追加することで、匿名ユーザーに対してシナリオの作成を禁止できます。フィルタの例(AnonymousScenarioFilter)を次に示します。

<filter>
<filter-name>AnonymousScenarioFilter</filter-name>
<filter-class>oracle.wcps.samples.AnonymousScenarioFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>AnonymousScenarioFilter</filter-name>
<url-pattern>/api/conductor/namespaces/PublicPersonalization/scenarios</url-pattern>
</filter-mapping>
<security-constraint>
<web-resource-collection>
<web-resource-name>ConductorJerseyWebApplication</web-resource-name>
<url-pattern>/api/conductor/namespaces/PublicPersonalization/scenarios/*</url-pattern>
<http-method>GET</http-method>
<http-method>POST</http-method>
</web-resource-collection>
<!--
Commented out to allow anonymous user access  in this namespace
<auth-constraint>
<role-name>Users</role-name>
</auth-constraint>
-->
</security-constraint>

このフィルタは、匿名ユーザーでないかどうか(httpRequest.getUserPrincipal() == null)、およびシナリオを作成するRESTリソースのURL (/api/conductor/namespaces/PublicPersonalization/scenarios)に対するHTTP POST操作でないかどうかを明示的にチェックします。

public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException
{
if (request instanceof HttpServletRequest)
{
HttpServletRequest httpRequest = (HttpServletRequest)request;
String method = httpRequest.getMethod();
if ("POST".equalsIgnoreCase(method) && httpRequest.getUserPrincipal() == null)
{
throw new ServletException("Anonymous users cannot create scenarios.");
}
}
chain.doFilter(request, response);
}

25.8.3 認証されたユーザーによるシナリオの作成の禁止

第25.8.2項「匿名ユーザーによるシナリオの作成の禁止」で説明したフィルタに簡単な変更を加えると(httpRequest.getUserPrincipal() checkのチェックを削除)、すべてのユーザーに対してシナリオの作成を禁止できます。HTTP POST操作はシナリオの実行のリクエストにも使用されますが、その場合のURIは異なります(また、フィルタ<url-pattern>ではなく、<security-constraint>内で保護されています)。

26 Microsoft Office統合の管理

この章では、Microsoft OfficeとWebCenter Portal 11g (11.1.1.1.0)以降との統合の構成に必要なシステム管理作業の概要について説明します。

この章には次のトピックが含まれます:

- 第26.1項「Microsoft Office統合について」

- 第26.2項「Microsoft Office統合の構成」

- 第26.3項「非SSL統合の構成」

- 第26.4項「トラブルシューティング」

Microsoft OfficeをWebCenter Portalとともに使用する方法は、『Oracle WebCenter Portalの使用』の「Microsoft OfficeおよびExplorerの統合での作業」を参照してください。

権限:
この章のタスクを実行するには、次のロールが付与されている必要があります。

- WebLogic Server: Adminロール。Oracle WebLogic Server管理コンソールから付与します。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

26.1 Microsoft Office統合について

図26-1は、標準のMicrosoft Office統合トポロジを、トポロジ内における各コンポーネント固有の構成関連のメモとともに示しています。Microsoft Office統合の構成方法の詳細は、第26.2項「Microsoft Office統合の構成」を参照してください。

Microsoft Office統合を構成すると、WebCenter Portal環境内からMicrosoft OfficeアプリケーションおよびMicrosoft Office Enterprise Editionアプリケーションと対話できるようになります。Windowsの各バージョンに対応したアクティビティは、『Oracle WebCenter Portalの使用』の「Microsoft OfficeおよびExplorerの統合での作業」に記載されているマトリックスを参照してください。

図26-1 Microsoft Office統合のトポロジ

1. Oracle HTTP Serverおよびロード・バランサ
OHS (または、ロード・バランサ)は、リクエストがSharepointサーブレットにルーティングされるように、適切に構成する必要があります。シングル・サインオンを使用している場合は、第33.6項「仮想ホストを使用したSSOの構成」の説明に従って、SSOによって保護されていない仮想ホストを作成する必要があります。これは、トポロジのエッジ・サーバーで行います(つまり、ロード・バランサまたはOHSのいずれか)。-Dnon_sso* javaパラメータは、第33.6.5項「仮想ホスト用のWebCenter Portalの構成」の説明に従って、非SSO保護仮想ホストをポイントするように設定する必要があります。

2. SSL有効化エントリ・ポイント
SSLをロード・バランサまたはOHSのいずれかに構成する必要があり、Microsoft Office 2010およびMicrosoft Office 2013を使用する場合にいずれかがトポロジのエッジ・サーバーです。強くお薦めしますが、MS Office 2007に必須ではありません。非SSL統合の詳細は、第26.3項「非SSL統合の構成」を参照してください。

3. Microsoft Officeクライアント
SSLを使用しないとセキュリティ・リスクが発生するため(ユーザーの資格証明が暗号化されずに渡される)お薦めしませんが、各クライアント・マシンのレジストリを構成してMicrosoft OfficeをHTTPで認証するようにできます。詳細は、第26.3項「非SSL統合の構成」を参照してください。

4. WC_Spaces管理対象サーバー
適用できるJVM引数を示し、特にどの引数がどのような条件で必要なのかについて確認します。詳細は、第26.2項「Microsoft Office統合の構成」の手順2を参照してください。

SSLがエッジ・サーバー(OHSまたはロード・バランサのいずれか)で有効になっている場合、エッジ・サーバーのSSL資格証明の「信頼できる証明書」をWC_Spacesサーバーのキーストアにインポートする必要があります(第26.4.3項「SSLの使用でドキュメントのチェックアウトが不可能になる」を参照)。

5. Internet Explorerまたはサポートされているブラウザ
Internet Explorerでは、ActiveXを有効にする必要があります。FirefoxやGoogle ChromeなどのInternet Explorer以外のブラウザでは、Javaプラグインをインストールする必要があります。詳細は、第26.4.1項「Officeで「編集」をクリックしてもWordが起動しない」を参照してください。

6. Windows/WebCenter Portalユーザー・アカウント
Windowsユーザー・アカウントとWebCenter Portalログイン・アカウントは同等の関係である必要があります。Microsoft Officeとの統合を稼働する方法によっては、WebCenter Portalユーザー・アカウントをWindowsユーザー・アカウントに独自に関連付ける必要があります。特にWindows 7では、Windows 7 WebClientによりユーザー資格証明書がWindows 7ユーザー・コンテキストにキャッシュされ、その結果、Windows 7のユーザーごとに1つのWebCenter Portalユーザーしかサポートできなくなります。詳細は、第26.4.2項「ドキュメント・ライブラリからのドキュメント編集に関する問題(Windows 7)」を参照してください。

26.2 Microsoft Office統合の構成

この項では、Microsoft Officeをデスクトップ統合に対して構成する方法を説明します。その構成手順に従うには、次の要件を満たしている必要があります。

- Oracle WebCenterのフロントにWeb層(Oracle HTTP Server)がインストールされている。Oracle HTTP Serverインストールの詳細は、『Oracle Web Tierインストレーション・ガイド』のOracle Web層のインストールと構成に関する項を参照してください。

- Oracle HTTP Server (1つが使用されている場合にはロード・バランシング・ルーター)でSSLが構成され有効化されている。Microsoft Office 2010およびMicrosoft Office 2013を使用する場合にMicrosoft Office統合にはSSLが必要である点に注意してください。詳細は、第35.3項「SSLを使用したOracle HTTP ServerからWebCenter Portalへの接続の保護」を参照してください。
強くお薦めしますが、MS Office 2007に必須ではありません。非SSL統合の詳細は、第26.3項「非SSL統合の構成」を参照してください。

- 証明書がcacertsまたはWebLogicデフォルトのトラスト・ストアでシード済の既知の認証局で発行されたものではない場合、使用しているSSL証明書の公開証明書がWebLogicトラスト・ストアにインポートされている。詳細は、第35.1項「SSLを使用したブラウザからWebCenter Portalへの接続の保護」を参照してください。

- WebCenter PortalがOAMで構成されている場合、OAMの管理者はリソースURLを、保護レベルをExcludedに設定して追加する必要があります。

/wcsdocs*
/wcsdocs/.../*
/_vti_*

リソースURLの設定の詳細は、Oracle Fusion Middleware Oracle Access ManagerおよびOracle Security Token Service管理者ガイドのポリシーで使用するリソース定義の追加と管理に関する項を参照してください。

OHS構成で呼び出されるOAM保護は、メイン接続ポートに限定的に適用する必要があり、後述の手順で構成するセカンダリの保護されていないSharePointポート(この例では、4444)に適用しないでください。webgate.conf (場合によっては、httpd.conf)からOblixの値を削除し、メインのWebCenter接続(ポート80または7777)に対する有効な仮想ホスト・コンテナで、それらの値を置換する必要があります。その後で、後述の手順1および2で新しい仮想ホストを作成すると、ポート(この例では、4444)が作成されます。SharePointのプロトコルは、このポートを使用してOAM SSOなしで通信できます。詳細は、第33.6.4項「OAM 11g用の仮想ホストの構成」を参照してください。

注意:
WebCenter PortalのMicrosoft Officeとの統合は、Microsoftによって確立されたSharePointサーバーとやり取りするMicrosoftデスクトップ・アプリケーション用のモデルに従います。WebCenter Portal統合では、WC_SpacesサーバーがそのモデルのSharePointサーバーのロールをエミュレートします。
クライアント側では、WindowsにログインしたユーザーがWebCenter Portalにログインする際に使用するユーザー・アカウントに関連付けられる可能性があるため、同一のWindowsユーザー・アカウントを使用した複数のWebCenter Portalアカウントへのログインを避けることが重要です。特にWindows 7 WebClientサービスでは、エミュレートされたSharePointサービスのエンドポイントにログインするために使用した資格証明書がキャッシュされるため、同一のWindowsユーザー・アカウントからWebCenter Portalへの様々なログイン・アカウントをサポートすると予期しない結果を生じます。詳細は、第26.4.2項「ドキュメント・ライブラリからのドキュメント編集に関する問題(Windows 7)」のトラブルシューティングの説明を参照してください。

1. 次のいずれかの操作を実行して、Oracle HTTP Server (OHS)に<location />を追加します。

- OHS_INSTANCE_HOME/config/OHS/ohs1/に格納されたOHS ssl.conf (またはOHSを非SSL環境のフロントエンドWebCenter Portalに構成する場合(お薦めしません)場合には、mod_wl_ohs.conf)ファイルに次の行を追加します。

# WebCenter Portal (previously named Spaces Application)
<location />
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</location>

サンプルのOHSmod_wl_ohs.confファイルは、付録B「WebCenter PortalのOracle HTTP Server構成」を参照してください。

- または下のサンプルに示すように、Microsoft Officeアプリケーションによるアクセス用OHSに仮想ホストを作成し、"/"および"/wcsdocs"の両方をこの仮想ホスト内のWC_Spacesサーバー(OAMシングル・サインオンが使用されるときに必要)にルーティングします。

# Virtual Hosts - Sharepoint
<VirtualHost *:4444>
ServerName webtier-spaces.example.com
<Location />
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
</Location>
<Location /webcenter>
Deny from all
</Location>
<Location /webcenterhelp>
Deny from all
</Location>
<Location /rest>
Deny from all
</Location>
...
</VirtualHost>

詳細は、第33.6項「仮想ホストを使用したSSOの構成」を参照してください。

2. 必要なパラメータをsetDomainEnv.shファイルに追加して、下のサンプルに示すとおり確実にnon_sso_hostをエイリアスに設定します。setDomainEnv.shファイルは、次の場所に格納されています。

- UNIX: DOMAIN_HOME/bin/setDomainEnv.sh

- Windows: DOMAIN_HOME\bin\setDomainEnv.cmd

EXTRA_JAVA_PROPERTIES=
"${EXTRA_JAVA_PROPERTIES}
-Dnon_sso_protocol=https
-Dnon_sso_host=<hostname_of_OHS_frontend>.oracle.com
-Dnon_sso_port=4444
-Dsso_base_url=http://<hostname_of_OHS_frontend>.oracle.com:4443"
export EXTRA_JAVA_PROPERTIES

ここで:

- non_sso_protocolは、Microsoft OfficeアプリケーションからWC_Spacesにアクセスする際に使用するURLのプロトコルです。

- non_sso_hostは、WC_Spacesサーバーを指すホストで、OAM SSOによって保護されていません。

- non_sso_portは、WC_Spacesサーバーを指すホストで、OAM SSOによって保護されていません。

- sso_base_urlは、SSOにアクセスするためのURLです(通常、WebCenter Portalで使用されるものと同じ)。

詳細は、第33.5.3項「Microsoftクライアントの構成」を参照してください。

注意:
Microsoft Officeにアクセスする際に外部で使用されるプロトコルがSSLで、資格証明書が無効の場合、次のパラメータをsetDomainEnv.shに追加します。

JAVA_OPTIONS="${JAVA_OPTIONS}
-Dweblogic.security.SSL.enforceConstraints=off
-Dweblogic.security.SSL.ignoreHostnameVerification=true"

ignoreHostnameVerfication=true設定は、サイトがワイルドカードの資格証明書を使用している場合にのみ必要です。この場合には、ワイルドカードの証明書が指定のサーバー名と一致しないため、ホスト名の検証は無効にする必要があります。

26.3 非SSL統合の構成

なんらかの理由でSSLをOHSまたはロード・バランサで構成しないインストールについては、各クライアントに対してクライアント・レジストリ情報を構成してMicrosoft Office製品に組み込まれた制限をオーバーライドする必要があります。次のMicrosoftのサポート・サイトを参照して、下の手順に従ってください。手順は、Windowsのバージョン間で多少違うことに注意してください。

http://support.microsoft.com/kb/2123563

26.4 トラブルシューティング

この項には次のサブセクションが含まれます:

- 第26.4.1項「Officeで「編集」をクリックしてもWordが起動しない」

- 第26.4.2項「ドキュメント・ライブラリからのドキュメント編集に関する問題(Windows 7)」

- 第26.4.3項「SSLの使用でドキュメントのチェックアウトが不可能になる」

- 第26.4.4項「Microsoft Officeの作業ウィンドウにタブが1つしか表示されない」

- 第26.4.5項「Firefoxを使用してMicrosoft Officeに接続できない」

- 第26.4.6項「Microsoft Officeドキュメントを開く場合に認証を求められる」

26.4.1 Officeで「編集」をクリックしてもWordが起動しない

問題

Microsoft Officeの「編集」機能で、Internet Explorer以外のブラウザを使用した場合、Wordまたは関連のOfficeアプリケーションが起動されません。

解決策

Microsoft Office統合をIE以外のブラウザで作業するには、Javaプラグインが必要です。ブラウザでJavaプラグインを有効化してあることを確認してください。Javaプラグインのインストールの手順は、ブラウザのドキュメントを参照してください。

26.4.2 ドキュメント・ライブラリからのドキュメント編集に関する問題(Windows 7)

問題

Windows 7への最初のユーザーのログインでは、Microsoft Office統合機能を問題なく使用できます。ところが、それ以降にユーザーが同じWindows 7ログインで同じデスクトップのWebCenter Portalにログインすると、特にドキュメントのチェックインとチェックアウトの際に、問題が発生することがあります。これらの問題は、すべてのブラウザとMicrosoft Officeを停止しても解決されません。

この問題はWebClientサービスによるものです。Windowsネイティブ・サービスによりオペレーティング・システムでHTTPリクエストとWebDAVリクエストが送信され、それにより最初の資格証明書がキャッシュされます。WebClientサービスでは、他のWindows機能による使用(ユーザーがネットワークの場所を追加するなど)が対象であるため、このサービスにアクセスするたびに資格証明書が要求されるのではなくキャッシュされます。しかし、資格証明はWindows 7のログイン・ユーザーとの関連でキャッシュされ、WebCenter Portalログインとは連携していません。

したがって、WebClientサービスでは最初のユーザーの資格証明を使用して、リクエストがWebCenter Portalドキュメント・サービスに送信されます。2番目のユーザーの場合、WebCenterセキュリティ・モデルにより2番目のユーザーがアクセスしているフォルダ上のドキュメントに最初のユーザーの資格証明がアクセスできない(必要な権限がない)ため、この問題が発生します。正常にアクセスできても、最初のユーザーがチェックアウトしたように表示されます。

解決策

この問題を解決する手順は次のとおりです。

- 2番目のユーザーがこの機能を使用する前にマシンを再起動します。

- Windowsからログアウトして、異なるWindows 7ユーザーを使用してログインします。

- WebClientサービスを再起動します。

これらの解決策による問題は、システム管理者の権限が必要であり、WebClientサービスがその他のWindows 7機能によって使用されるため、サービスを停止するとそのWindows 7機能が影響を受けることがあります。この問題を回避する最も簡単な方法は、同じデスクトップとWindows 7ログインを複数のWebCenter Portalのユーザー・アカウントやFusionアプリケーションのユーザー・アカウントで共有しないようにすることです。

26.4.3 SSLの使用でドキュメントのチェックアウトが不可能になる

問題

Officeで「編集」をクリックすると、ドキュメントをチェックアウトできなかったことを示すダイアログが表示されます。数回ログインを試行すると、Microsoft Officeは開きますが、ドキュメントは読取り専用モードでチェックアウトされていません。

解決策

この問題は、特に次の環境に関連しています。

- ブラウザがInternet Explorerである

- OHSまたはロード・バランサがWC_Spacesサーバーのフロントに設定されていない

- SSLがOHS上で有効であり、OHSで終了する(OHSからWC_Spacesサーバーへの接続が非SSLであるなど)

この症状が発生するのは、バックエンド(WC_Spacesサーバー)からOHS (またはロード・バランサ)へ2つ目のHTTPSリクエストがあるためで、WC_Spacesサーバーが信頼されていないことが原因でSSLキーの例外がスローされます。このリクエストにより、ドキュメントのチェックアウトが実行されます。

この問題を解決する手順は次のとおりです。

1. 信頼できる証明書をOHSまたはロード・バランサからWC_Spacesサーバーへインポートします。

2. 次の手順に従って、信頼できる証明書をOHSウォレットからエクスポートします。

1. OHSを管理するFusion Middleware Controlインスタンスにログインします。

2. 「Web層」→「OHS1」を選択します。

3. 「OHS」ドロップダウン・リストから、「セキュリティ」→「ウォレット」を選択します。

4. 「デフォルト」をクリックします。

5. CN="\"Self-Signed Certificate for ohs1 \"", OU=OAS, O=ORACLE, L=REDWOODSHORES, ST=CA, C=USを選択します。

6. 「エクスポート」をクリックします。

7. ファイルを保存します("ohsTrustedCertificate"などとして)。

8. ファイルをWC_Spacesサーバーのローカル・ディスクにコピーします。

3. 次のkeytoolコマンドを使用して、OHSの信頼できる証明書をWLS DemoTrust.jksにインポートします。

JAVA_HOME/bin/keytool -importcert -v -alias ohscert -file /mycert/ohsTrustedCertificate -keystore /my_mw_home/wlserver_10.3/server/lib/DemoTrust.jks -storepass DemoTrustKeyStorePassPhrase

DemoTrustKeyStorePassPhraseはDemoTrust.jksのデフォルトのパスワードです。

キーストアのパスを検出する手順は、次のとおりです。

1. WLSコンソールにログインします。

2. 「環境」→「サーバー」→「WC_Spaces」を選択します。

3. 「構成」タブを開き、「キーストア」を選択します。

26.4.4 Microsoft Officeの作業ウィンドウにタブが1つしか表示されない

問題

Internet Explorerでドキュメントの「Officeで編集」をクリックすると、Microsoft Officeが作業ウィンドウにタブを1つのみ表示して起動します。

解決策

この問題が発生するのは、ドキュメントを開いたときに「マイ・ローカル・ドラフト・フォルダを使用する」オプションがInternet Explorerで選択されたためで、その結果、ファイルはサーバーに接続されずにユーザーのローカル・フォルダにコピーされます。それ以降そのファイルにチェックインしないと、他のユーザーがFirefoxやChromeなど他のブラウザでそのドキュメントを編集する際にも同じ症状が発生します。この問題を回避するには、Internet Explorerで「マイ・ローカル・ドラフト・フォルダを使用する」オプションのプロンプトが表示されたら、どのユーザーも必ず選択を解除してください。その他のすべてのブラウザでは、「オプション」→「保存」を各MS Officeアプリケーションで必ず使用してください。

26.4.5 Firefoxを使用してMicrosoft Officeに接続できない

問題

Firefox使用時にWebCenter PortalからMicrosoft Officeアプリケーションに接続できません。

解決策

Java 7でのセキュリティ問題のため、Firefoxではプラグイン・リストで有効化と表示されている場合でも現在Javaプラットフォーム・プラグインがブロックされています。そのため、Microsoft Office統合が無効になります。

JavaおよびMicrosoft Officeの統合をFirefoxで使用するには、さらにプラグインのアイコンをクリックする必要があります(図26-2参照)。

図26-2 「プラグイン」アイコン

ブラウザの左上のURLバーの近くに表示され、必要なサイトで明示的にJavaを有効にします。

26.4.6 Microsoft Officeドキュメントを開く場合に認証を求められる

問題

Microsoft Officeドキュメントを開く場合に認証が求められます。この問題の完全な説明は、次のMicrosoftサポート・サイトで取得できます。

http://support.microsoft.com/kb/2019105

Microsoft Knowledge Base記事のタイトルはMS Office 2003 (MicrosoftはOffice 2003のサポートを2014年4月8日に終了しました)を示していますが、基礎となる問題と解決策はすべての後続のリリースと関連しています。

解決策

KB記事によると、ほとんどのイントラネットの例の場合、この問題は、サーバーを構成して統合されたWindows認証を使用してからクライアントを構成して自動ログオンを有効化すると、最も簡単に示されます。推奨方法は、記事を参照してください

第VI部

モニタリング

『Oracle WebCenter Portalの管理』のこの部では、Oracle Enterprise Manager Fusion Middlewareコンソールを使用したWebCenter PortalおよびPortal Frameworkアプリケーションのモニタリング方法について説明します。

第VI部の内容は次のとおりです。

- 第27章「Oracle WebCenter Portalのパフォーマンスのモニタリング」

- 第28章「Oracle WebCenter Portalログの管理」

- 第29章「Oracle WebCenter Portalログの管理」

27 Oracle WebCenter Portalのパフォーマンスのモニタリング

この章では、WebCenter PortalおよびPortal Frameworkアプリケーションで使用できるパフォーマンス・メトリックの範囲、およびFusion Middleware Controlを使用したパフォーマンス・メトリックのモニター方法について説明します。また、診断ログ・ファイルに記録された情報を分析することにより、問題をトラブルシューティングする方法についても説明します。WebCenter PortalまたはPortal Frameworkアプリケーションを定期的に監視している管理者は、開発の傾向を認識し、今後のパフォーマンス問題を防ぐことを習得します。

この章には次のトピックが含まれます:

- 第27.1項「Oracle WebCenter Portalのパフォーマンス・メトリックの理解」

- 第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」

- 第27.3項「主要なパフォーマンス・メトリックのしきい値および収集のカスタマイズ」

- 第27.4項「Oracle WebCenter Portalに関するパフォーマンス問題の診断および解決」

- 第27.5項「Oracle WebCenter Portalのパフォーマンスのチューニング」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdmin、OperatorまたはMonitorロールが付与されている必要があります。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

27.1 Oracle WebCenter Portalのパフォーマンス・メトリックの理解

管理者は、Fusion Middleware Controlを使用して、WebCenter PortalおよびPortal Frameworkアプリケーションを構成するすべてのコンポーネント、ツールおよびサービスと、WebCenter PortalおよびPortal Frameworkアプリケーション全体のパフォーマンスと可用性をモニターできます。Fusion Middleware Controlを使用してOracle WebCenter Portalメトリックにアクセスするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表示される情報を最大限に活用するには、パフォーマンス・メトリックの計算方法とその意味を理解することが重要です。ここでは、参照用にOracle WebCenter Portalのすべてのパフォーマンス・メトリックを一覧表示して説明します。示されているソーシャル・ネットワーキング、個人の生産性およびコラボレーションに関するメトリックをすべて使用できるアプリケーション(WebCenter Portalなど)もあれば、ここに示されている機能のうち1つまたは数個しか使用できないアプリケーションもあります。

この項には次のトピックが含まれます:

- 第27.1.1項「Oracle WebCenter Portalのメトリック収集の理解」

- 第27.1.2項「主要なパフォーマンス・メトリックの理解」

- 第27.1.3項「主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断」

- 第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」

- 第27.1.5項「ページ・リクエスト・メトリックの理解」

- 第27.1.6項「ドキュメント・メトリックの理解」

- 第27.1.7項「ポートレット・プロデューサのメトリックの理解」

- 第27.1.8項「WebLogic Serverメトリックの理解」

- 第27.1.9項「セキュリティ・メトリックの理解」

- 第27.1.10項「ページ・レスポンス・メトリックおよびロード・メトリックの理解」

- 第27.1.11項「ポータル・メトリックの理解」

- 第27.1.12項「ツール・メトリックおよびサービス・メトリックの理解」

27.1.1 Oracle WebCenter Portalのメトリック収集の理解

パフォーマンス・メトリックは、Oracle WebCenter Portalで自動的に有効になり、Fusion Middleware Controlに表示されます。WebCenter PortalまたはPortal Frameworkアプリケーションのパフォーマンス・メトリックを収集するために、オプションの設定や追加構成の実行は必要ありません。アプリケーションの実行が遅い場合やハングアップした場合など、問題が発生したときは、Fusion Middleware Controlでリアルタイムにパフォーマンス・メトリックを調査して、問題の詳細を調べることができます。

この項では、Oracle WebCenter Portalでメトリック・データを収集し、表示する様々な方法について説明します。

- メトリック収集: 起動時以降

- メトリック収集: 最近の履歴

- メトリック収集: 最新のN回のサンプル

27.1.1.1 メトリック収集: 起動時以降

WebCenter PortalまたはPortal FrameworkアプリケーションをホスティングするWebLogic Serverが稼働中である場合に常に、リアルタイム・メトリックは使用可能です。コンテナの起動以後に収集または集計されるリアルタイム・メトリックは、Oracle WebCenter Portalメトリック・ページで「起動時以降」の見出しの下に表示されます。こうしたメトリックは、WebLogic Serverの存続期間にわたり集計されたデータを提供します。ここで集計されるデータによって、システム全体のパフォーマンスを把握し、「最近の履歴」に示された最近のリクエストのパフォーマンスと比較できます。

たとえば、4時間前に起動された管理対象サーバーにデプロイされているWebCenter Portalについて考えてみます。その期間、WebCenter Portalは10,000個のポートレット・リクエストを処理し、それにかかった合計レスポンス時間は500,000ミリ秒でした。このシナリオの場合、ポートレットの「起動時以降」メトリックが表示されます。

- 起動時以降: 呼出し(カウント): 10000

- 起動時以降: 平均時間(ミリ秒): 50

注意:
メトリック収集は、コンテナの再起動後にあらためて開始します。再起動前に収集されたデータは使用できなくなります。

27.1.1.2 メトリック収集: 最近の履歴

Oracle WebCenter Portalでは、「起動時以降」のメトリック以外に、過去10分から15分の間に処理されたリクエストに対するメトリックが「最近の履歴」のメトリックとしてレポートされます。そのために、Oracle WebCenter Portalでは、内部的な周期で定期的にリアルタイム・メトリックのスナップショットを取得しています。これらのメトリック・スナップショットから過去10分から15分の間にサービス・リクエストの実行にかかったデルタ時間が計算され、「最近の履歴」のメトリックとして表示されます。「最近の履歴」のメトリックには過去10-15分のデータのみが集計されているので、発生中のパフォーマンス/可用性の問題を調査する場合に役立ちます。

最近のメトリックと起動時以降のメトリックを比較すると、システム全体の可用性/パフォーマンスとの比較でシステム特性の変化を測定できます。

たとえば、起動して2日間実行されているシステムについて考えてみます。その期間、Oracle WebCenter Portalには、100,000個のポートレット・リクエストの処理にかかった合計時間が5,000,000ミリ秒であると記録されています。システムにはパフォーマンスの問題が発生しかけており、つまり、最後の10分から15分の間に、100個のポートレット・リクエストに対して3,000,000ミリ秒もの合計時間がかかっています。このシナリオでは、「平均レスポンス時間」には、「起動時以降」はきわめて低いと報告され、パフォーマンスの問題は示されません(5,000,000ミリ秒/100,000 = 50ミリ秒)。ただし、「最近の履歴」メトリックは相当高くなっており(3000000ミリ秒/100 = 30秒)、最近パフォーマンスが低下していることを管理者にすぐに示します。「最近の履歴」を対応する「起動時以降」メトリックと即座に比較することにより、最近のメトリック・データが正常であるかどうかが、この場合は現在システムに問題が発生していることが明確に示されます。

「最近の履歴」のメトリックは、パフォーマンスの問題が発生したときに、どの領域を調査し、どの領域を無視するのか、優先度を付けるために役立ちます。たとえば、パフォーマンスの問題が発生中であることがレポートされ、特定のコンポーネントの「最近の履歴」のメトリックの値が0である場合、これはそのコンポーネントが過去10-15分間に使用されていなかったことを示します。同様に、「平均レスポンス時間」の値が小さく、「起動」のカウントが少ない場合、そのコンポーネントはパフォーマンスの問題に関係ない可能性があります。その場合、管理者は他の領域の調査を始めることができます。

通常、「最近の履歴」では最も新しい10-15分のデータが表示されます。ただし、過去10-15分のデータが反映されない場合があります。

- WebLogic Serverが起動してすぐの場合で、実行期間が10-15分未満のときは、「最近の履歴」にはサーバーが稼働中の期間のデータが表示されます。

- 1つ以上のツールまたはサービスに長期間アクセスがない場合、古いメトリック・スナップショットが徐々に無効になります。そのような場合、過去10-15分のメトリック・データは存在しないので、「最近の履歴」のメトリックで過去10-15分に発生したサービス・リクエストの実行にかかるデルタ時間を計算できません。この状況が発生した場合、「最近の履歴」のデータは「起動時以降」のメトリックと同じ値を示します。ツールまたはサービスが再び使用されると、このツールまたはサービスのメトリック・スナップショットが再開されます。十分な量の最近のデータが収集されると、再び「最近の履歴」のメトリックに過去10-15分のメトリックが表示されるようになります。
ほとんどのライブ環境は、長時間にわたってアイドル状態になることはないので、最近のメトリックが非アクティブであることが理由で一時停止することはめったにありません。ただし、断続的に使用するテスト環境やしばらくの間使用しないテスト環境では、ここで説明したように、最近のメトリックの収集が一時的に停止する可能性があります。

27.1.1.3 メトリック収集: 最新のN回のサンプル

「起動時以降」と「最近の履歴」のメトリックは、特定の期間におけるパフォーマンスを計算し、その期間で集約したメトリックを表示します。Oracle WebCenter Portalではそれ以外にも、一連の主要なWebCenter Portalメトリックのリクエスト当たりのパフォーマンス情報を収集し、レポートします。そのようなメトリックを使用すると、それまでのリクエストを考慮することなく、個々のリクエストごとの成功およびレスポンス時間を参照できます。初期状態では、最新の100回のサンプルを使用して主要なメトリックのパフォーマンス/可用性を計算しますが、インストールに合わせてサンプル・セットを増減できます。

たとえば、最新の100回のページ・リクエストのうち10回が失敗した場合、ページ可用性は90%と計算されます。サンプル・セットを50回に減らして、そのうち10ページで失敗した場合、ページ可用性は80%とレポートされます。

この例は、サンプル・セットのサイズがパフォーマンス・レポートに及ぼす影響を示しています。任意の値を選択できますが、最新のN回のメトリック・サンプルはメモリー上で保持されるので、サンプル数を増やす場合はメモリー要件が増えることも考慮してください。最大でも数百回のサンプルにとどめることをお薦めします。

インストールで主要なパフォーマンス・メトリックをレポートするために使用するサンプル数を変更するには、第27.3.6項「主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成」を参照してください。

Oracle WebCenter Portalの主なパフォーマンス・メトリックとしきい値の詳細は、第27.1.2項「主要なパフォーマンス・メトリックの理解」を参照してください。

27.1.2 主要なパフォーマンス・メトリックの理解

WebCenter PortalまたはPortal Frameworkアプリケーションの可用性とパフォーマンスを診断するには通常、WebCenter PortalまたはPortal FrameworkアプリケーションからJVMやWebLogic Serverなどの複数のコンポーネントまで、全般的に様々な重要メトリックを参照する必要があります。

WebCenter PortalまたはPortal Frameworkアプリケーションのパフォーマンスに影響を及ぼす可能性がある問題を速やかに特定し、診断できるように、Oracle WebCenter Portalは一連の主要なパフォーマンス・メトリックの最新のN回のサンプルを収集し、Fusion Middleware Controlで公開します。アプリケーションの主要なパフォーマンス・メトリック情報にアクセスするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

しきい値によって、パフォーマンスのアラートまたは警告をトリガーするタイミングが決まります。Oracle WebCenter Portalシステムにとって適切な境界を表すしきい値を設定できるので、Enterprise Manager Fusion Middleware Controlで関連性のあるパフォーマンス・アラートを取得できます。主要なパフォーマンス・メトリックが、構成されているしきい値から外れた値である場合、Fusion Middleware Controlでは色分けされて表示されるので、簡単に見つけることができます。しきい値の詳細は、第27.3項「主要なパフォーマンス・メトリックのしきい値および収集のカスタマイズ」を参照してください。

可用性のように、成功または失敗がレポートされるメトリックの場合、特にしきい値を設定する必要はありません。たとえば、ドキュメントのダウンロードが失敗した場合は自動的に赤で表示され、ダウンロードが成功した場合は緑で表示されることが決まっています。

Oracle WebCenter Portalでは、表27-1に示す主要なパフォーマンス・メトリックの警告しきい値を管理できます。

表27-1 主要なパフォーマンス・メトリックの収集

コンポーネント

主要なパフォーマンス・メトリック

メトリックのサンプリング

WebCenter PortalまたはPortal Frameworkアプリケーション

アクティブ・セッション

X分当たり1サンプル

WebCenter PortalまたはPortal Frameworkアプリケーション: ページ

ページ・レスポンス時間

リクエスト別

WebCenter PortalまたはPortal Frameworkアプリケーション: ドキュメント

ダウンロード・スループット

許容ダウンロード時間

リクエスト別

WebCenter PortalまたはPortal Frameworkアプリケーション: ドキュメント

アップロード・スループット

許容アップロード時間

リクエスト別

WebCenter PortalまたはPortal Frameworkアプリケーション: ポートレット

ポートレット・レスポンス時間

リクエスト別

JVM

CPU使用率

X分当たり1サンプル

JVM

ヒープ使用量

X分当たり1サンプル

JVM

ガベージ・コレクション率

X分当たり1サンプル

JVM

ガベージ・コレクション平均時間

X分当たり1サンプル

WebLogic Server

アクティブな実行スレッド

X分当たり1サンプル

WebLogic Server

アイドル中の実行スレッド数

X分当たり1サンプル

WebLogic Server

占有実行スレッド

X分当たり1サンプル

WebLogic Server

オープンJDBCセッション

X分当たり1サンプル

Oracle WebCenter Portalは、エンドユーザーのページ、ポートレットおよびドキュメントに対するリクエストを取得し、各リクエストに応じてメトリック・サンプルが収集されます。たとえば、ユーザーAがページXにアクセスすると、Oracle WebCenter Portalは、ページXの可用性(成功/失敗メトリック)とリクエストのレスポンス時間の両方を取得します。構成されているメトリック・アラートのしきい値を超える時間がかかったか、または失敗したメトリック・サンプルは、Fusion Middleware Controlで赤で表示され、問題が発生したときにすぐに管理者に警告します。

JVMやWebLogic Serverのメトリックなど、他のメトリックは、事前定義済の頻度で収集されます。初期状態では、5分当たりに1サンプルの頻度ですが、この値は必要に応じてカスタマイズできます。詳細は、第27.3.5項「WebLogic Serverヘルス・チェックの頻度の構成」を参照してください。

第27.3.6項「主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成」で説明されているように、Oracle WebCenter Portalが収集するサンプルの合計数も構成可能です。デフォルトのサンプル・セット数は100個です。メトリック・サンプルを維持するとメモリーを消費するため、過度のサンプル数を指定しないでください(多くても数百にすることをお薦めします)。

Oracle WebCenter Portalの主要なパフォーマンス・メトリックは、WebCenter PortalまたはPortal Frameworkアプリケーションのパフォーマンスに影響を及ぼす可能性がある共通の問題を、管理者が速やかに特定し、診断できるように、特に選択されています。すべての主要なパフォーマンス・メトリック・データは、Fusion Middleware Controlのアプリケーションのホームページで表示できます。

27.1.3 主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断

WebCenter PortalまたはPortal Frameworkアプリケーションを定期的にモニターする場合、開発段階で傾向を把握し、将来のパフォーマンス問題を回避することができます。その手始めとして最適な場所は、Enterprise Manager Fusion Middleware Controlのアプリケーションのホーム・ページです。ホームページには、アプリケーションを構成する様々なコンポーネント、ツールおよびサービスと、アプリケーションがデプロイされているWebLogic Serverについて、ステータス、パフォーマンス、可用性および他の主要なメトリックが表示されます。

この項では、Oracle WebCenter Portalを扱い慣れていないユーザーが、Fusion Middleware Controlで表示される情報を使用して問題を特定および診断する方法について理解を深めるために役立つ情報について説明します。

図27-1は、初期設定のアプリケーションWebCenter Portalをモニタリングする手順の概要を示しています。

図27-1 WebCenter Portalのシステム・ヘルスの分析: 主な手順

注意:

- 手順4と手順5は、アプリケーションでポートレットまたはドキュメントの機能が使用されている場合にのみ適用されます。

- 使用されていない機能の棒グラフは灰色表示されます。

- 折れ線グラフでデータ表示を開始するには、少なくとも3つのデータ・ポイントが必要です。

図27-2 WebCenter Portalホーム・ページでのシステム・ヘルスの分析

表27-2 システム・ヘルスの分析: 各手順の説明

手順

説明

WebCenter PortalまたはPortal Frameworkアプリケーションのホームページへの移動

Enterprise Manager Fusion Middleware Controlを使用してポータル・アプリケーションのパフォーマンスをモニターします。その手始めとして最適な場所は、アプリケーションのホームページです。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

1 CPUとヒープ・メモリーの使用率のチェック

CPUとメモリーの使用率が高すぎると全体的なパフォーマンスが低下するので、他のOracle WebCenter Portal固有のメトリックを確認する前に、常にCPUとメモリーに関するメトリックを確認することが重要です。

「最近のCPUおよびメモリー使用状況」のチャートをチェックして、使用率の現在の傾向を確認します。

- CPU使用率が高いかどうか。CPU使用率で不定期にスパイクが発生するのは正常ですが、CPU使用率が長期間にわたって高い(85から90%)場合は、通常、CPU問題が発生していることを示しています。CPUの問題をトラブルシューティングするには、次の各項を参照してください。
第27.1.8項「WebLogic Serverメトリックの理解」

第G.4.2.3項「Java Virtual Machine (JVM)の使用状況のモニタリング」

- メモリー使用率が高いかどうか。メモリーが最大ヒープ・サイズに近づいており、傾向が下に向かっていないことをチャートが示している場合は、原因を分析するためにメモリー・ダンプをいくつか取得してください。最大ヒープ・サイズ情報にアクセスするには:
1. WebLogic Server管理コンソールにログインします。

2. 「環境」→「サーバー」→<managed_server name>に移動します。

3. 「モニタリング」→「パフォーマンス」タブをクリックします。

4. 「最大ヒープ・サイズ」を確認します。

第G.4.5.3項「JFR記録を使用した遅いリクエストのトラブルシューティング」を参照してください。

第G.4.2.1項「システム・リソースの確認(CPUとメモリー)」を参照してください。

注意: Portal Frameworkアプリケーションの場合、「アプリケーションのデプロイ」→「WebCenterポータル」→「最近のWebLogic Serverメトリック」を選択し、「最近のCPUおよびメモリー使用状況」チャートを表示します。

次の手順: チャートでCPU使用率とメモリー使用率が正常であることが示されている場合、WebLogic Serverのヘルスを確認します。

2 WebLogic Serverのヘルスの確認

「WebLogic Serverメトリック」リージョンで次を調べます。

- ヘルス: この棒グラフには、Oracle WebLogic Server自己ヘルス・モニタリング機能によりレポートされた最近のWebLogic Serverヘルスがまとめられています。たとえば、最新の100回のWebLogic Serverヘルス・チェックのうち10回失敗した(OKがレポートされない)場合、WebLogic Serverヘルスは90%と表示されます。「ヘルス」リンクをクリックして「最近のWebLogic Serverメトリック」ページに移動し、詳細を表示します。

- インシデント: CPU使用率、メモリー使用率、スレッド数、JDBC接続の数、セッション・メトリックなどのWebLogic Serverメトリックがしきい値の設定値を超えた回数。「インシデント」リンクをクリックすると、インシデントを詳細に診断します。

次に実行するアクションは、メトリック・データに応じて異なります。たとえば、占有スレッドが存在する場合、スレッド・ダンプを採取します。JDBC接続の数が制限値を超えている場合、接続リークを詳細に分析できます。ガベージ・コレクション・レートが制限値を超えている場合、ヒープ・ダンプの採取を採取できます。

詳細は、第27.1.8項「WebLogic Serverメトリックの理解」および第G.4項「Oracle WebCenter Portalのパフォーマンスに関する問題のトラブルシューティング」を参照してください。

範囲外のメトリックは、チャートでは赤で、「ヘルス・メトリック」表ではオレンジで、それぞれ表示されます。診断ログをスキャンして、そのような状況が発生している記録をすべて調査します。インメモリー情報はN回分のメトリック・サンプルしかありませんが、ログには問題の発生回数に関する大量の履歴情報や、問題が発生したときのユーザーのようなコンテキストに関する情報が格納されています。

次にサンプル・メッセージを示します。

[WC_Spaces] [WARNING] [WCS-69252]
[oracle.webcenter.system-management] [tid:
oracle.webcenter.DefaultTimer] [ecid:
0000JhEX92mEgKG_Ix8Dyf1Ghz32000002,0] [APP:
webcenter#11.1.1.4.0] wlsCpuUsage: 21.92100394175851 % of
WebLogicServer is out-of-bounds

ヒント: Fusion Middleware Controlでは、メッセージ・タイプ、メッセージ・コードおよび他の文字列パターンに関する詳細を検索することによって、このタイプのすべてのメッセージを検索できます。第28.2項「ログ情報の表示および構成」を参照してください。

デフォルトでは警告のしきい値が設定されているのは「CPU使用率」のみですが、「ヒープ・メモリー使用率」などの他の主要なWebLogic Serverメトリックにもしきい値を構成できます。第27.3.3項「主要なメトリックのしきい値の構成」を参照してください。

診断ログで、エラー、障害、および構成またはネットワークの問題をチェックします。

問題がWebCenter ContentやSOAなど、別のバックエンド・サーバーに関連している場合、それらの管理対象サーバーでもJVM/WebLogic Serverのヘルス(CPU、ヒープ、スレッドなど)を確認します。

同様に、WebCenter Portalインストール内のWC_Portlet、WC_UtilitiesおよびWC_Collaborationなどの他の管理対象サーバーのWebLogic Serverヘルスを調査します。

注意: Portal Frameworkアプリケーションの場合、「アプリケーションのデプロイ」→「WebCenterポータル」→「最近のWebLogic Serverメトリック」を選択し、ヘルス・メトリックを表示します。

次の手順: WebLogic Serverがしきい値の範囲内で動作していることがチャートに示されている場合、WebCenter Portalアプリケーションのヘルスを確認します。

3 ページ・パフォーマンスのモニター

ホームページの上部にある「WebCenter Portalメトリック」セクションを参照します。

ページ可用性/パフォーマンスのチャートで、ページ・リクエストが予期したとおりに現在応答しているかどうかを確認します。最近のページ・リクエストに関する問題を調査するには、詳細をドリルダウンします。

「時間」列と「ページ名」列で「昇順ソート」/「降順ソート」の矢印を使用して、特定のページまたは一連のページで急増するパターンが存在するかどうか、またはパフォーマンスのスパイクがよりランダムに発生するようになっていないかを確認します。

範囲外のメトリックは、チャートでは赤で、「ページ・メトリック」表ではオレンジで、それぞれ表示されます。詳細は、第27.1.5項「ページ・リクエスト・メトリックの理解」を参照してください。診断ログをスキャンして、そのような状況が発生している記録をすべて調査します。インメモリー情報はN回分のメトリック・サンプルしかありませんが、ログには問題の発生回数に関する大量の履歴情報や、問題が発生したときのユーザーのようなコンテキストに関する情報が格納されています。

次にサンプル・メッセージを示します。

[WC_Spaces] [WARNING] [WCS-69251]
[oracle.webcenter.system-management] [tid:
[ACTIVE].ExecuteThread: '4' for queue:
'weblogic.kernel.Default (self-tuning)'] [userId: weblogic]
[ecid:
6356ef0164cbad47:3fe105c5:13b4e847973:-8000-0000000000000031,0
] [APP: webcenter#11.1.1.4.0] [DSID:
0000JhEYRT^EgKG_Ix8Dyf1Ghz32000005] pageResponseTime: 22223
ms of PersonalSpace/Activities is out-of-bounds

ヒント: Fusion Middleware Controlでは、メッセージ・タイプ、メッセージ・コードおよび他の文字列パターンに関する詳細を検索することによって、このタイプのすべてのメッセージを検索できます。第28.2項「ログ情報の表示および構成」を参照してください。

パフォーマンスが低下している個々のページを特定します。詳細は、第G.4.3項「表示の遅いページを特定する方法」を参照してください。

「全ページ・メトリック」ページに移動し、このページの実行履歴を参照します(起動時以降および過去10-15分)。このページは常に動作に時間がかかるのかどうかを確認します。

ページで異常が発生している場合は、第G.4.5項「遅いページ・リクエストをトラブルシューティングする方法」を参照してください。

注意: Portal Frameworkアプリケーションの場合、「アプリケーションのデプロイ」→「WebCenterポータル」→「最近のページ・メトリック」を選択し、ページ・メトリックを表示します。

次の手順: ページ・リクエストがしきい値の範囲内で動作していることがチャートに示されている場合、ドキュメントのアップロード/ダウンロードのパフォーマンスを確認します。

4. ドキュメントのアップロードとダウンロードのモニター

ホームページの上部にある「WebCenter Portalメトリック」セクションを参照します。

ドキュメント可用性/パフォーマンスのチャートで、ドキュメント・ダウンロードが予期したとおりに現在動作しているかどうかを確認します。最近のドキュメント・リクエストに関する問題を調査するには、詳細をドリルダウンします。

範囲外のメトリックは、チャートでは赤で、「ドキュメント・メトリック」表ではオレンジで、それぞれ表示されます。詳細は、第27.1.6項「ドキュメント・メトリックの理解」を参照してください。診断ログをスキャンして、そのような状況が発生している記録をすべて調査します。インメモリー情報はN回分のメトリック・サンプルしかありませんが、ログには問題の発生回数に関する大量の履歴情報や、問題が発生したときのユーザーのようなコンテキストに関する情報が格納されています。

次にサンプル・メッセージを示します。

[WC_Spaces] [WARNING] [WCS-69255]
[oracle.webcenter.system-management] [tid:
[ACTIVE].ExecuteThread: '0' for queue:
'weblogic.kernel.Default (self-tuning)'] [userId: weblogic]
[ecid:
6356ef0164cbad47:3fe105c5:13b4e847973:-8000-0000000000000060,0
] [APP: webcenter#11.1.1.4.0] [DSID:
0000JhEYRT^EgKG_Ix8Dyf1Ghz32000005] downloadThroughput:
11.63793103448276 KB/sec of 3209 is out-of-bounds

[WC_Spaces] [WARNING] [WCS-69254]
[oracle.webcenter.system-management] [tid:
[ACTIVE].ExecuteThread: '0' for queue:
'weblogic.kernel.Default (self-tuning)'] [userId: weblogic]
[ecid:
6356ef0164cbad47:3fe105c5:13b4e847973:-8000-0000000000000249,0
] [APP: wcportal] [DSID: 0000JhEbmszEgKG_Ix8Dyf1Ghz32000009]
uploadThroughput: 95.90502106741573 KB/sec of
OWCSVR01USORAC011587 is out-of-bounds

ヒント: Fusion Middleware Controlでは、メッセージ・タイプ、メッセージ・コードおよび他の文字列パターンに関する詳細を検索することによって、このタイプのすべてのメッセージを検索できます。第28.2項「ログ情報の表示および構成」を参照してください。

「全サービス・メトリック」ページに移動して「コンテンツ・リポジトリ」を選択し、ドキュメントの実行履歴を参照します(起動時以降および過去10-15分)。ドキュメントのパフォーマンスが最近低下したのか、常に動作に時間がかかるのかを確認します。

ドキュメントのパフォーマンスがしきい値の範囲内で正常な場合、次の手順を実行します。

1. WebCenter ContentをホストしているサーバーのJVM/WebLogic Serverのヘルス(CPU、ヒープ、スレッドなど)を確認します。

2. Content Serverのメトリックおよびドキュメントが格納されているデータベースのメトリックをモニターします。

3. Content Serverに直接アクセスしてアップロード/ダウンロード操作を実行し、可用性/パフォーマンスを評価します。

4. Oracle WebCenter Content Serverへのコンテンツ・リポジトリ接続を確認し、Content Serverの構成と比較します。

5. WebCenter PortalとContent Serverの間のネットワーク接続の問題をチェックします。

6. WebCenter Portalでドキュメント操作をシミュレートします。すなわち、ドキュメントのアップロード/ダウンロードを実行して、問題が常態化しているのか、間欠的なのかを確認します。

注意: Portal Frameworkアプリケーションの場合、「アプリケーションのデプロイ」→「WebCenterポータル」→「最近のドキュメント・メトリック」を選択し、ドキュメント・メトリックを表示します。

次の手順: ドキュメント・リクエストがしきい値の範囲内で動作していることがチャートに示されている場合、ポートレットのパフォーマンスを確認します。

5. ポートレットのパフォーマンスのモニター

ホームページの上部にある「WebCenter Portalメトリック」セクションを参照します。

ポートレット可用性/パフォーマンスのチャートで、ポートレットが予期したとおりに現在動作しているかどうかを確認します。最近のポートレット・リクエストに関する問題を調査するには、詳細をドリルダウンします。範囲外のメトリックは、チャートでは赤で、「ポートレット・メトリック」表ではオレンジで、それぞれ表示されます。詳細は、第27.1.7項「ポートレット・プロデューサのメトリックの理解」を参照してください。

範囲外の条件は管理対象サーバーの診断ログにも記録されるので、すべての履歴イベント、すなわちメモリー内に保持されている最新のサンプル・セットより多い量の履歴イベントを調査できます。例:

[WC_Spaces] [WARNING] [WCS-69253]
[oracle.webcenter.system-management] [tid:
pool-3-daemon-thread-1] [userId: weblogic] [ecid:
6356ef0164cbad47:3fe105c5:13b4e847973:-8000-0000000000000088,0
:16] [APP: webcenter#11.1.1.4.0] portletResponseTime: 20523 ms
of Portlet: slowRenderingPortlet from Web Producer Myjpdk is
out-of-bounds.

予期したとおりのパフォーマンスを示していない個々のポートレットまたはポートレット・プロデューサを特定します。

「全サービス・メトリック」ページに移動して「プロデューサ」または「ポートレット」を選択し、ポートレット/ポートレット・プロデューサの実行履歴を参照します(起動時以降および過去10-15分)。パフォーマンスが最近低下したのか、常に動作に時間がかかるのかを確認します。

ポートレットのパフォーマンスがしきい値の範囲内で正常な場合、次の手順を実行します。

1. ポートレット(たとえばWC_Portlet)をホストしている管理対象サーバーのJVM/WebLogic Serverのヘルスを確認(すなわち、CPU、ヒープ、スレッドなどを調査)します。

2. ブラウザでポートレット・プロデューサのURLを入力し、プロデューサが使用可能かどうかを確認します。

3. ポートレット・プロデューサの接続構成を確認します。

4. WebCenter Portalアプリケーションとポートレット・プロデューサの間のネットワーク接続の問題をチェックします。

5. WebCenter Portalでポートレット操作をシミュレートします。すなわち、ポートレットで表示、パーソナライズまたは操作を実行して、問題が常態化しているのか、間欠的なのかを確認します。

ポートレットで異常が発生している場合は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のポートレットのトラブルシューティングに関する項を参照してください。

注意: Portal Frameworkアプリケーションの場合、「アプリケーションのデプロイ」→「WebCenterポータル」→「最近のポートレット・メトリック」を選択し、ポートレット・メトリックを表示します。

次の手順: ポートレット・リクエストがしきい値の範囲内で動作していることがチャートに示されている場合、LDAPサーバーのパフォーマンスを確認します。

6. LDAPサーバーのパフォーマンスのモニター

ホームページの上部にある「セキュリティ」セクションで、LDAPメトリックを参照します。

キャッシュ・ヒット率は、サーバー起動時は0ですが、通常はウォーム・アップするにつれて増加し、90%を超えます。詳細は、第27.1.9項「セキュリティ・メトリックの理解」および第16.9項「プロファイル・サービスのキャッシュ・オプションの構成」を参照してください。

通常は、平均LDAP参照時間はほんの数ミリ秒です。参照に長い時間がかかる場合は、LDAPサーバーまたはネットワークに関する問題が発生している可能性があります。

- 単純なバインド操作に対するLDAPサーバーのレスポンス時間を測定する場合、コマンドldapbind -D "UserDN" -h ldaphost.example.com -p <port> -w <password>を実行します。

ネットワークの問題を詳細に調査するには、第G.4.2.6項「tcpdumpを使用したネットワーク関連問題の診断」または第G.4.2.7項「pingを使用したネットワーク待機時間の測定」を参照してください。

Oracle Internet Directoryを使用している場合は、パフォーマンスを改善し、ボトルネックを回避する方法について、パフォーマンス・チューニング・ガイドのOracle Internet Directoryパフォーマンス・チューニングに関する項を参照してください。他のLDAPサーバーについては、該当の製品ドキュメントを参照してください。

次の手順: LDAPサーバーがしきい値の範囲内で動作している場合、他の領域を調査します。

7. 個々のツールまたはサービスのモニター

ホームページの下部にある「WebCenter Portalサービス」セクションを参照します。詳細は、第27.1.12項「ツール・メトリックおよびサービス・メトリックの理解」を参照してください。

特定のツールまたはサービスが「停止中」または「不明」であるかどうかがすぐにわかります。考えられる原因とアクションについて、第27.1.12.3項「ツールとサービスに関する一般的な問題のトラブルシューティング」を参照してください。

「平均時間」または「呼出し」で表をソートすると、優先的に取り組むツールまたはサービスがわかります。

名前をクリックして「全サービス・メトリック」ページに移動します。「起動時以降」と「最近の履歴」のメトリックを比較して、パフォーマンスが最近低下したのか、常に動作に時間がかかるのかを確認します。

注意: Portal Frameworkアプリケーションの場合、「アプリケーションのデプロイ」→「WebCenterポータル」→「全サービス・メトリック」を選択し、メトリックを表示します。

27.1.4 共通のパフォーマンスの問題およびアクションの理解

Oracle WebCenter Portalメトリックが範囲外である場合は、次のことを行います。

- メモリー、CPU、ネットワーク、外部プロセスなどの要素を含めて、システム・リソースをチェックします。付録G「Oracle WebCenter Portalのトラブルシューティング」を参照してください。

- 問題がシステム全体のものか、特定のツールまたはサービスに関するものかを判断するために他のメトリックをチェックします。

- 問題が特定のツールまたはコンポーネントに関連する場合は、バックエンド・サーバーが停止していないかどうか、また過負荷ではないかどうかをチェックします。

- WebLogic Serverを長期間実行している場合は、起動時以降のメトリックと最近の履歴のメトリックを比較し、最近になってパフォーマンスが低下していないかどうか、低下している場合はその程度を判断します。

- ツールまたはサービスのステータスが「停止中」であるか、機能しない操作がある場合、ダイレクトURLによりバックエンド・サーバーの検証、テストおよびpingを行います。詳細は、該当する章の接続のテストに関する項を参照してください。各章のリストについては、第VI部「ツール、ポートレット・プロデューサおよび外部アプリケーションの管理」を参照してください。
ツールまたはサービスへの接続を再構成する場合、変更を反映するために、WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。サーバーのホスト/ポートの詳細など、主要な接続属性を変更した場合、接続を再構成して管理対象サーバーを再起動するまでは、サーバーへの接続が切断されてサービスが使用不可になる可能性があります。

注意:
一部の主要なパフォーマンス・メトリックが範囲外条件をトリガーするしきい値は、カスタマイズ可能です。第27.3項「主要なパフォーマンス・メトリックのしきい値および収集のカスタマイズ」を参照してください。

27.1.5 ページ・リクエスト・メトリックの理解

Fusion Middleware Controlでは、WebCenter PortalまたはPortal Frameworkアプリケーションのページ・リクエストの可用性とパフォーマンスをモニターできます。最近のページ・データおよび履歴(全)ページ・データをモニターできます。

この項には次の情報が含まれます:

- 第27.1.5.1項「フル・ページ・メトリックと部分ページ・メトリックの理解」

- 第27.1.5.2項「最近のページ・メトリック」

- 第27.1.5.3項「全ページ・メトリック」

注意:
この項で説明するページ・リクエスト・メトリックは、第27.1.12.2.12項「ページ操作のメトリック」で説明されているページ操作のメトリックとは異なります。ページ操作のメトリックでは、ページの作成など、ページ関連の操作がモニターされます。これに対して、この項で説明するページ・リクエスト・メトリックでは、個々のページ・ビュー/表示リクエストがモニターされます(ページ編集操作は含まれません)。

27.1.5.1 フル・ページ・メトリックと部分ページ・メトリックの理解

パフォーマンス・データは、フル・ページ・リクエストと部分ページ・リクエストについて収集されます。フル・ページのメトリックには部分ページのメトリックは含まれません。

部分ページ・リクエストでは、ページの部分のみが表示されます。したがって、ページ内のページのパフォーマンスをモニターできます。部分ページのリフレッシュ動作は、部分ページ・レンダリング(PPR: partial page rendering)と呼ばれています。PPRにより、ページ全体をリフレッシュする必要なく、ページ上の特定のコンポーネントのみを再レンダリングできます。一般的なシナリオでは、入力コンポーネントでユーザーが選択または入力したものが出力コンポーネントに表示されます。同様に、コマンド・リンクまたはボタンにより、ページ全体がリフレッシュされることなく、ページ上の別のコンポーネントが再レンダリングされる場合があります。

ページ上の個々のコンポーネントの部分的なページ・レンダリングでは、部分ページのメトリックのみが増加し、フル・ページのメトリックは変化しません。たとえば、ページ上のカレンダのリフレッシュでは、部分ページの呼出しが1増加しますが、フル・ページの呼出しは変化しません。

PPRの詳細は、『Oracle Application Development Framework Webユーザー・インタフェース開発者ガイド』の「部分ページ・コンテンツの再レンダリング」を参照してください。

27.1.5.2 最近のページ・メトリック

WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに、最近のページ可用性メトリックとページ・パフォーマンス・メトリックのサマリーが表示されます(図27-3および表27-3)。ページ可用性/パフォーマンス・チャートでは、ページ・リクエストが予想以上に時間がかかっているか、または失敗しているかどうかが一目でわかります。

注意:
ホームページにアクセスするには、第6.2項「WebCenter Portalのホームページへの移動」または第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

「ページ可用性」チャートと「ページ・パフォーマンス」チャートでは、最新のN回のページ・リクエスト(デフォルトではNは100)における可用性とパフォーマンスがレポートされます。時間範囲は、最も早いページ/ドキュメント/ポートレットのリクエスト時刻から現在時刻までです。第27.3.6項「主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成」を参照してください。

右側の%値は、特定の時間制限内に応答したページ・リクエストの割合を示します。この割合は、最新のN回のページ・リクエストの情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のページ・リクエストのうち3回がページ・レスポンスのしきい値を超えた場合、ページ・パフォーマンスは97%と表示されます。

棒グラフ・ステータス(緑/赤)は、ステータスが変更されるまでは、時間が経過しても変更されません。したがって、%パフォーマンス値と見た目の緑/赤の比率は必ずしも一致しません。たとえば、最初の5回のページ・リクエストが範囲外であり、システムは9時間アイドル(ページ・リクエストがない)状態であり、1時間当たり95回の正常なページ・リクエストが存在するシナリオを考えます。この場合、棒グラフは90%が赤(9時間)、10%が緑(1時間)で表示されますが、%パフォーマンス値は95%と表示されます(Nが100で、サンプル100個のうち95個が正常)。不一致が発生するのは、棒グラフが期間全体で均一に描画されるのに対して、ページ・リクエストは通常は期間全体に均一に分散しないからです。

図27-3 WebCenter Portalホームページ上の最近のページのサマリー

チャートが問題やインシデントを示している場合は、「ページ可用性」リンクまたは「ページ・パフォーマンス」リンクをクリックしてより詳細な情報に移動し、さらに問題を診断できます(図27-4および表27-3を参照)。

最近のページ・メトリックのページ(図27-4)の情報を使用して、最近のページ・パフォーマンスの問題をトラブルシューティングします。ページ・リクエストが予想以上に時間がかかっているか、または失敗している場合、ページ上部のページ可用性/パフォーマンス・チャートが赤で表示されます。

注意:
初期状態では、ページ・レスポンスしきい値は10,000ミリ秒なので、レスポンス時間が10,000ミリ秒を超えるページのチャートは赤で表示されます。このしきい値がインストールに適さない場合、その値を変更できます。第27.3項「主要なパフォーマンス・メトリックのしきい値および収集のカスタマイズ」を参照してください。

図27-4 最近のページ・メトリック

このチャートは、最新のN回のページ・リクエストの可用性/パフォーマンスをレポートします。時間範囲は、最も早いページ・リクエスト時刻から最後のページ・リクエスト時刻までです。

表の情報を使用して、遅いページの名前およびそのページが属するポータルを特定します。

ページ・レスポンスの問題を診断するには、次にある手順3のアドバイスを参照してください: 「ページ・パフォーマンスのモニター」 - 表27-2「システム・ヘルスの分析 - 各手順の説明」内。

表27-3 最近のページ・リクエスト・メトリック

メトリック

説明

可用性

最新のN回のページ・リクエストのページ可用性を示します。

- 緑: ページ・リクエストの成功を表します。

- 赤: ページ・リクエストで失敗が発生したことを表します。
下部の表の「ステータス」列を参照し、失敗したページ・リクエストを特定します。

- %: 成功したページ・リクエストの割合。割合は、最新のN回のページ・リクエストのステータス情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のページ・リクエストのうち5回が失敗した場合、ページ可用性は95%と表示されます。

パフォーマンス

最新のN回のページ・リクエストのページ・パフォーマンスを示します。

- 緑: 許容されるページ・レスポンス時間であること、すなわちレスポンス時間が事前定義済しきい値より短いことを表します。

- 赤: ページ・レスポンス時間が設定されている制限値より長いことを表します。たとえば、インストールでページ・レスポンスしきい値を3,000ミリ秒と指定している場合、レスポンス時間が3,000ミリ秒を超えるたびに警告メッセージがトリガーされ、範囲外の状態が記録されます。
初期状態では、ページ・レスポンスしきい値は10,000ミリ秒です。

下部の表の時間の列を参照します。しきい値を超えるレスポンスはオレンジで表示されます。「降順ソート」矢印をクリックし、最も遅いページを特定します。遅いページを開いて調査し、ページの再設計またはページ・コンテンツの変更/削除によりページ・パフォーマンスを向上できる余地があるかどうかを評価します。

- %: 指定されている時間制限内に応答したページ・リクエストの割合。この割合は、最新のN回のページ・リクエストの情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のページ・リクエストのうち10回がページ・レスポンスのしきい値を超えた場合、ページ・パフォーマンスは90%と表示されます。

日時

ページがリクエストされた日時。

ページ名

リクエストされたページの名前。

ポータル名

(WebCenter Portalのみ)

ページが格納されるポータルの名前(以前はスペースと呼ばれていました)。

部分ページ・リフレッシュ

フル・ページ・リフレッシュ(false)または部分ページ・リフレッシュ(true)のどちらのページ・リクエストなのかを示します。

ステータス

ページ・リクエストが成功(「成功」)したのか、失敗(「失敗」)したのかを示します。「失敗」はオレンジのテキストで表示されます。

時間(ミリ秒)

ページ(フル・ページまたは部分ページ)のリフレッシュにかかった時間(ミリ秒)。時間が事前定義済ページ・レスポンスしきい値を超えた場合、値はオレンジで表示されます。

27.1.5.3 全ページ・メトリック

図27-5に示すように、ページ・アクティビティに関連する履歴パフォーマンス・メトリックも表示されます。表27-4に、これらのメトリックを示します。このページには、フル・ページ・リクエストと部分ページ・リクエストの両方のメトリックが表示され、必要に応じて表示するデータをフィルタ処理できます。

注意:
Fusion Middleware Controlを使用してこれらのメトリックにアクセスするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

図27-5 全ページ・リクエスト・メトリック

このページの上部の表には、個々のページのステータスとパフォーマンスがまとめて表示されます。この表を使用すると、使用可能なページがすぐにわかり、個々のパフォーマンスと相対的なパフォーマンスを確認できます。

統計は、ページが作成されると使用可能になり、ページがアクセスされたり使用されたりするたびに更新されます。

注意:
(WebCenter Portalのみ)ホーム・ポータルのページのメトリックは含まれません。

表27-4 ページ・リクエスト・メトリック: フル・ページおよび部分ページ

フィールド

説明

表示オプション

表に表示するデータをフィルタ処理します。

- ページ名フィルタ: 検索語の全部または一部を入力し、「リフレッシュ」アイコンをクリックすると、ページ名が一致するすべてのページでリストが更新されます。すべてのページを表示するには、検索語をクリアし、「リフレッシュ」を再度クリックします。

- ポータル名フィルタ: (WebCenter Portalのみ)検索語の全部または一部を入力し、「リフレッシュ」アイコンをクリックすると、ポータルの表示名が一致するすべてのページでリストが更新されます。すべてのポータル(以前はスペースと呼ばれていました)のページ・メトリックを表示するには、検索語をクリアし、「リフレッシュ」を再度クリックします。

- 最大行数: 表に表示するページの総数を制限します。

- 表示: 最も人気があるページ、最も遅いページまたは最もエラーが多いページのメトリックを表示します。選択に応じて、表のページは次の順序で並べられます。
- 呼出し数(最もアクセスされたページ)

- 平均ページ処理時間(最も遅いページ)

- エラー数(最もエラーが多いページ)

- 期間: 起動時以降または直前の15分間(最近の履歴)に収集されたメトリック情報を表示します。

上位5つのページがチャートに表示されます。

ページ名

フィルタ基準(指定されている場合)に一致するページの名前。

フィルタ基準が指定されない場合は、すべてのページがリストされます。

ポータル名

(WebCenter Portalのみ)

フィルタ基準(指定されている場合)に一致するポータル(以前はスペースと呼ばれていました)の名前。

フィルタ基準が指定されない場合は、すべてのポータルのページがリストされます。

呼出し

1分当たりのページ(フル・ページまたは部分ページ)の呼出し総数:

- 起動時以降

- 最近の履歴

平均時間(ミリ秒)

ページ(フル・ページまたは部分ページ)を表示するための平均時間(ミリ秒)。

- 起動時以降

- 最近の履歴

最大時間(ミリ秒)

ページ(フル・ページまたは部分ページ)の表示にかかった最大時間。

エラー(フル・ページのみ)

ページで発生した1分当たりのエラー数。

成功した呼出し(フル・ページのみ)

成功したページ呼出しの割合。

- 起動時以降

- 最近の履歴

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、ページ・リクエストの失敗の原因を特定してください。第28.2項「ログ情報の表示および構成」を参照してください。

ページ数/分

ページの1分当たりのアクセス回数。ページ・スループットとも呼ばれます。

- 起動時以降

- 最近の履歴

デフォルトでは、フル・ページのメトリックの「ページ数/分」は非表示です。このメトリックを表示するには、「表示」メニュー→「列」→「起動時以降」/「最近の履歴」→「フル・ページ」→「ページ数/分」を選択します(図27-6)。同様に、必要でない列を非表示にするには、列名を選択解除します。

図27-6 「表示」メニューの「ページ数/分」オプション

全ページ・リクエスト・メトリック: グラフ

表の下のグラフを使用すると、次の内容が一目でわかります。

- 呼出し: 最も使用回数の多いページまたは最も使用回数の少ないページ(つまり、最も多い呼出しまたは最も少ない呼出しが記録されているページ)を示すグラフ。

- ページ・スループット: 1分間にアクセスされた平均ページ数を示すグラフ。このグラフを使用すると、ヒット率が高い(または低い)ページを特定できます。

- エラー: (WebCenter Portalのみ)エラー数を示すグラフ。このグラフを使用すると、エラー率を比較できます。

- 平均処理時間: (WebCenter Portalのみ)平均ページ・レスポンス時間(ミリ秒)を示すグラフ。このグラフを使用すると、パフォーマンスが最高(または最低)のページを特定できます。

- フル・ページの平均処理時間: (Portal Frameworkアプリケーションのみ)フル・ページの平均レスポンス時間(ミリ秒)を示すグラフ。このグラフを使用すると、パフォーマンスが最高(または最低)のページを特定できます。

- 部分ページの平均処理時間: (Portal Frameworkアプリケーションのみ)部分ページの平均レスポンス時間(ミリ秒)を示すグラフ。このグラフを使用すると、ページ・パフォーマンスが最高(または最低)のページを特定できます。

様々なページを比較するには:

- 「ページ名フィルタ」で適切なフィルタリング基準を指定します。

- 表で1つ以上のページを選択し、「チャートで表示」をクリックします。

27.1.6 ドキュメント・メトリックの理解

WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに、最近のドキュメント・ダウンロードの可用性メトリックとパフォーマンス・メトリックのサマリーが表示されます(図27-7および表27-5)。ドキュメント可用性/パフォーマンス・チャートでは、ドキュメント・ダウンロード・リクエストが予想以上に時間がかかっているか、または失敗しているかどうかが一目でわかります。

注意:
ホームページにアクセスするには、第6.2項「WebCenter Portalのホームページへの移動」または第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

「ドキュメント・ダウンロード可用性」チャートと「ドキュメント・ダウンロード・パフォーマンス」チャートでは、最新のN回のドキュメント・ダウンロード・リクエスト(デフォルトではNは100)における可用性とパフォーマンスがレポートされます。時間範囲は、最も早いページ/ドキュメント/ポートレットのリクエスト時刻から現在時刻までです。第27.3.6項「主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成」を参照してください。

右側の%値は、設定されているしきい値の範囲内に実行されたドキュメント・ダウンロードの割合を示します。この割合は、最新のN回のドキュメント・ダウンロード・リクエストの情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のドキュメント・ダウンロード・リクエストのうち3回が範囲外だった場合、ドキュメント・ダウンロード・パフォーマンスは97%と表示されます。詳細は、表27-5を参照してください。

棒グラフ・ステータス(緑/赤)は、ステータスが変更されるまでは、時間が経過しても変更されません。したがって、%パフォーマンス値と見た目の緑/赤の比率は必ずしも一致しません。第27.1.5.2項「最近のページ・メトリック」の説明は、ドキュメント・チャートにも当てはまります。

図27-7 WebCenter Portalホームページ上の最近のドキュメント・メトリックのサマリー

チャートが問題やインシデントを示している場合は、「ドキュメント可用性」リンクまたは「ドキュメント・パフォーマンス」リンクをクリックしてより詳細な情報に移動し、さらに問題を診断できます(図27-8および表27-5)。

図27-8 最近のドキュメント・メトリックのページ

このページの情報を使用して、最近のドキュメント関連のパフォーマンスの問題をトラブルシューティングします。ドキュメントのアップロードまたはダウンロードのリクエストが予想以上に時間がかかっているか、または失敗している場合、ページ上部のドキュメント可用性/パフォーマンス・チャートが赤で表示されます。

注意:
初期状態では、ダウンロードしきい値は500ミリ秒、アップロードしきい値は3,000ミリ秒です。ダウンロード/アップロードにこれより長い時間がかかるドキュメントは、それぞれのスループットが1024KB/秒または180KB/秒を下回る場合、チャートで赤で表示されます。これらのしきい値がインストールに適さない場合、しきい値を変更できます。第27.3.4項「ドキュメント・アップロード/ダウンロード・メトリックのしきい値の構成」を参照してください。

このチャートは、最新のN回のドキュメント・ダウンロード/アップロード・リクエストの可用性/パフォーマンスのチェック結果をレポートします。時間範囲は、最も早いドキュメント・リクエスト時刻から最後のドキュメント・リクエスト時刻までです。

ドキュメント・ダウンロード/アップロードの問題を診断するには、次にある手順4のアドバイスを参照してください: 「ドキュメントのアップロードとダウンロードのモニター」 - 表27-2「システム・ヘルスの分析 - 各手順の説明」内。

表27-5 最近のドキュメント・メトリック

メトリック

説明

可用性

最新のN回のドキュメント・ダウンロード/アップロード・リクエストのドキュメント可用性を示します。

- 緑: ドキュメントのダウンロード/アップロードの成功を表します。

- 赤: ドキュメントのダウンロード/アップロードで失敗が発生したことを表します。
下部の表の「ステータス」列を参照し、失敗したダウンロード/アップロードを分析します。

- %: 成功したドキュメント・ダウンロードの割合。割合は、最新のN回のダウンロードのステータス情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のダウンロードのうち2回が失敗した場合、可用性は98%と表示されます。

パフォーマンス

最新のN回のドキュメント・ダウンロード/アップロード・リクエストのドキュメント・パフォーマンスを示します。

- 緑: ドキュメントのパフォーマンスが次に示す許容範囲内であることを表します。
- ドキュメントのダウンロード/アップロードにかかる時間が指定されているしきい値より短い。

- ドキュメントのダウンロード/アップロードのスループットがしきい値を超えている(全体のダウンロード時間は関係ありません)。

- 赤: ドキュメント・パフォーマンスが設定されている制限値を満たしていないことを表します。たとえば、インストールで許容できるドキュメント・ダウンロード速度を3KB/秒、許容できるダウンロード時間を500ミリ秒と指定している場合、ダウンロードの速度が3KB/秒未満で時間が500ミリ秒を超えると、警告メッセージがトリガーされ、範囲外の状態が記録されます。
ドキュメントのダウンロード/アップロード時間(ミリ秒)とスループット(KB/秒)のデフォルトのアラートしきい値は、標準で設定されています。どちらのしきい値も、インストールに合わせて細かく調整できます。詳細は、第27.3.4項「ドキュメント・アップロード/ダウンロード・メトリックのしきい値の構成」を参照してください。

下部の表のスループットの列を参照します。しきい値を下回るドキュメントのダウンロード/アップロード速度はオレンジで表示されます。しきい値より長いダウンロード/アップロード時間もオレンジで表示されます。最も遅い速度を特定するにはスループットの列で「昇順ソート」をクリックします。最も長い時間を特定するには時間の列で「降順ソート」をクリックします。

- %: 許容できる速度でダウンロード/アップロードしたドキュメントの割合。この割合は、最新のN回のダウンロード/アップロードの情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のダウンロードのうち10回がダウンロードしきい値を満たさなかった場合、ドキュメント・ダウンロード・パフォーマンスは90%と表示されます。

日時

ドキュメントをアップロード/ダウンロードした日時。

ステータス

ドキュメントのアップロード/ダウンロードが成功(「成功」)したのか、失敗(「失敗」)したのかを示します。「失敗」はオレンジのテキストで表示されます。

ダウンロード・スループット(KB/秒)/アップロード・スループット(KB/秒)

1秒当たりにダウンロード/アップロードされたドキュメント・データの量。スループットが事前定義済レスポンスを満たさなかった場合、値はオレンジで表示されます。

ダウンロード時間(ミリ秒)/アップロード時間(ミリ秒)

ドキュメントのダウンロード/アップロードにかかった時間。

ドキュメント・サイズ(バイト)

ドキュメントのサイズ(バイト)。

「昇順ソート」/「降順ソート」アイコンを使用して、ドキュメント・サイズ別にパフォーマンスを分析します。

27.1.7 ポートレット・プロデューサのメトリックの理解

Fusion Middleware Controlでは、WebCenter PortalまたはPortal Frameworkアプリケーションで使用されているすべてのポートレットおよびポートレット・プロデューサの可用性とパフォーマンスをモニターできます。最近のポートレット・データおよび履歴(全)ポートレット・データをモニターできます。次の各項では、監視可能なメトリックについて説明します。

- 第27.1.7.1項「最近のポートレット・メトリック」

- 第27.1.7.2項「全ポートレット・プロデューサ・メトリック」

- 第27.1.7.3項「全ポートレット・メトリック」

27.1.7.1 最近のポートレット・メトリック

WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに、最近のポートレット可用性メトリックとポートレット・パフォーマンス・メトリックのサマリーが表示されます(図27-9および表27-6)。ポートレット可用性/パフォーマンス・チャートでは、ポートレット・リクエストが予想以上に時間がかかっているか、または失敗しているかどうかが一目でわかります。

注意:
ホームページにアクセスするには、第6.2項「WebCenter Portalのホームページへの移動」または第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

「ポートレット可用性」チャートと「ポートレット・パフォーマンス」チャートでは、最新のN回のポートレット・リクエスト(デフォルトではNは100)における可用性とパフォーマンスがレポートされます。時間範囲は、最も早いページ/ドキュメント/ポートレットのリクエスト時刻から現在時刻までです。第27.3.6項「主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成」を参照してください。

右側の%値は、特定の時間制限内に応答したポートレット・リクエストの割合を示します。この割合は、最新のN回のポートレット・リクエストの情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のポートレット・リクエストのうち25回がポートレット・レスポンスのしきい値を超えた場合、ポートレット・パフォーマンスは75%と表示されます。詳細は、表27-6を参照してください。

棒グラフ・ステータス(緑/赤)は、ステータスが変更されるまでは、時間が経過しても変更されません。したがって、%パフォーマンス値と見た目の緑/赤の比率は必ずしも一致しません。第27.1.5.2項「最近のページ・メトリック」の説明は、ポートレット・チャートにも当てはまります。

図27-9 WebCenter Portalホームページ上の最近のポートレット・メトリックのサマリー

チャートが問題やインシデントを示している場合は、「ポートレット可用性」リンクまたは「ポートレット・パフォーマンス」リンクをクリックしてより詳細な情報に移動し、さらに問題を診断できます(図27-10および表27-6)。

図27-10 最近のポートレット・メトリック

このページの情報を使用して、最近のポートレットのパフォーマンスの問題をトラブルシューティングします。ポートレット・リクエストが予想以上に時間がかかっているか、または失敗している場合、ページ上部のポートレット可用性/パフォーマンス・チャートが赤で表示されます。

注意:
初期状態では、ポートレット・レスポンスしきい値は10,000ミリ秒なので、レスポンス時間が10,000ミリ秒を超えるポートレットのチャートは赤で表示されます。このしきい値がインストールに適さない場合、その値を変更できます。詳細は、第27.3項「主要なパフォーマンス・メトリックのしきい値および収集のカスタマイズ」を参照してください。

このチャートは、最新のN回のポートレット・リクエストの可用性/パフォーマンスをレポートします。時間範囲は、最も早いポートレット・リクエスト時刻から最後のポートレット・リクエスト時刻までです。

この表の情報を使用して、遅いポートレットを特定します。ポートレットの名前およびそのポートレットが属するプロデューサを特定できます。

ポートレットの問題を診断するには、次にある手順5のアドバイスを参照してください: 「ポートレット・パフォーマンスのモニター」 - 表27-2「システム・ヘルスの分析 - 各手順の説明」内。

表27-6 最近のポートレット・メトリック

ポートレット可用性

最新のN回のポートレット・リクエストのポートレット可用性を示します。

- 緑: ポートレット・リクエストの成功を表します。

- 赤: ポートレット・リクエストで失敗が発生したことを表します。
下部の表の「ステータス」列を参照し、失敗したポートレット・リクエストを特定します。

- %: 成功したポートレット・リクエストの割合。割合は、最新のN回のポートレット・リクエストのステータス情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のポートレット・リクエストのうち5回が失敗した場合、ポートレット可用性は95%と表示されます。

ポートレット・パフォーマンス

最新のN回のポートレット・リクエストのポートレット・パフォーマンスを示します。

- 緑: 許容されるポートレット・レスポンス時間であること、すなわちレスポンス時間が事前定義済しきい値より短いことを表します。

- 赤: ポートレット・レスポンス時間が設定されている制限値より長いことを表します。たとえば、インストールでポートレット・レスポンスしきい値を60ミリ秒と指定している場合、レスポンス時間が60ミリ秒を超えるたびに警告メッセージがトリガーされ、範囲外の状態が記録されます。
初期状態では、ポートレット・レスポンスしきい値は10,000ミリ秒です。

下部の表の時間の列を参照します。しきい値を超えるレスポンスはオレンジで表示されます。「降順ソート」矢印をクリックし、最も遅いポートレットを特定します。ポートレット名を特定したら、そのポートレットを調査して、効率を高める変更方法を評価できます。

- %: 指定されている時間制限内に応答したポートレット・リクエストの割合。この割合は、最新のN回のポートレット・リクエストの情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のポートレット・リクエストのうち10回がポートレット・レスポンスのしきい値を超えた場合、ポートレット・パフォーマンスは90%と表示されます。

日時

ポートレット・リクエストの日時。

ポートレット名

リクエストされたポートレットの名前。

27.1.7.2 全ポートレット・プロデューサ・メトリック

図27-11に示すように、WebCenter PortalまたはPortal Frameworkアプリケーションで使用されているポートレット・プロデューサの履歴パフォーマンス・メトリックも監視できます。このページに表示される情報については、次の表で説明します。

- 表27-7「ポートレット・プロデューサ: サマリー」

- 表27-8「ポートレット・プロデューサ: 詳細」

注意:
Fusion Middleware Controlを使用してこれらのメトリックにアクセスするには、次のいずれかを参照してください:
第27.2.1.4項「WebCenter Portalの全サービス・メトリックおよびポートレット・プロデューサ・メトリックのモニタリング」

第27.2.2.2項「Portal Frameworkアプリケーションの全サービス・メトリックおよびポートレット・プロデューサ・メトリックのモニタリング」

図27-11 ポートレット・プロデューサのメトリック

表27-7 ポートレット・プロデューサ: サマリー

メトリック

説明

ステータス

アプリケーションで使用されているポートレット・プロデューサの現在のステータス

- 稼働中(緑色の上矢印): すべてのポートレット・プロデューサが稼働中であることを示します。

- 停止中(赤色の下矢印): 1つ以上のポートレット・プロデューサが現在使用できないことを示します。プロデューサ・インスタンスが停止しているか、ネットワーク接続の問題がある可能性があります。

- 不明(時計): なんらかの理由でポートレット・プロデューサのステータスを問い合せることができません。管理対象サーバーが停止しているか、ネットワークの問題が原因でノードにアクセスできない可能性があります。さらに診断するには、管理サーバーのログおよび管理対象サーバーのログを確認します。

成功した呼出し(%)

成功したポートレット・プロデューサ起動の割合:

- 起動時以降

- 最近の履歴

リクエストが失敗すると、可用性に影響します。これには、アプリケーションに関連する失敗(タイムアウトや内部エラーなど)やクライアント/サーバーの失敗(レスポンス・コードHTTP4xxまたはHTTP5xxで返されたリクエスト、不正なコンテンツ・タイプが含まれるレスポンス、SOAP障害(該当する場合)など)があります。

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。第28.2項「ログ情報の表示および構成」を参照してください。

呼出し

1分当たりのポートレット・プロデューサの呼出し数:

- 起動時以降

- 最近の履歴

このメトリックでは、アプリケーションに関連する各ポートレット・リクエストが測定されます。このため、アプリケーションのキャッシュ・ヒット、エラーまたはタイムアウトにより、この合計はプロデューサ・サーバーに対して送信された実際のHTTPリクエスト数よりも多くなることがあります。

平均時間(ミリ秒)

ポートレット・リクエストにかかった平均時間(結果には関係ありません):

- 起動時以降

- 最近の履歴

表27-8 ポートレット・プロデューサ: 詳細

メトリック

説明

最もポピュラーなプロデューサ

各プロデューサの起動回数(チャートで表示)。

チャートの最大値は、最も多く使用されているポートレット・プロデューサを示します。

最小値は、最も使用されていないポートレット・プロデューサを示します。

レスポンス時間

WebCenter PortalまたはPortal Frameworkアプリケーションが起動されてから、各ポートレット・プロデューサでプロデューサ・リクエストの処理にかかった平均時間(チャートで表示)。

チャートの最大値は、パフォーマンスが最も低いポートレット・プロデューサを示します。

最小値は、パフォーマンスが最も高いポートレット・プロデューサを示します。

プロデューサ名

モニター対象のポートレット・プロデューサの名前。

ポートレット・プロデューサの名前をクリックすると、アプリケーションで使用される各ポートレットの詳細情報が表示されます。表27-10「ポートレット: 詳細」を参照してください。

ステータス

各ポートレット・プロデューサの現在のステータス:

- 稼働中(緑色の上矢印): ポートレット・プロデューサが稼働中であることを示します。

- 停止中(赤色の下矢印): ポートレット・プロデューサが現在使用できないことを示します。プロデューサ・インスタンスが停止しているか、ネットワーク接続の問題がある可能性があります。

- 不明(時計): なんらかの理由でポートレット・プロデューサのステータスを問い合せることができません。

プロデューサ・タイプ

ポートレット・プロデューサ・タイプ: 「Web」または「WSRP」

- Webポートレット・プロデューサ: J2EEアプリケーション・サーバーにデプロイされるOracle PDK-Javaプロデューサ。これは多くの場合リモートであり、HTTP上でSimple Object Access Protocol (SOAP)を使用して通信します。

- WSRPポートレット・プロデューサ: Web Services for Remote Portlets (WSRP)は、標準対応のコンテナと任意のWSRPアプリケーションの間の相互運用を可能にするWebサービス標準です。

成功した呼出し(%)

成功したプロデューサ起動の割合:

- 起動時以降

- 最近の履歴

呼出し

各プロデューサの起動回数:

- 起動時以降

- 最近の履歴

この列に基づいて表をソートすると、WebCenter PortalまたはPortal Frameworkアプリケーションで最も頻繁にアクセスされているポートレット・プロデューサがわかります。

平均時間(ミリ秒)

ポートレット・リクエストにかかった平均時間(結果には関係ありません):

- 起動時以降

- 最近の履歴

このメトリックは、機能していないポートレット・プロデューサを検出する場合に使用します。このメトリックを「呼出し」メトリックと組み合せて使用すると、優先的に取り組む必要のあるプロデューサがわかります。

最大時間(ミリ秒)

プロデューサ・リクエストの処理にかかった最大時間。

- 成功 - HTTP200xxレスポンス・コード

- リダイレクト - HTTP300xxレスポンス・コード

- クライアント・エラー数 - HTTP400xxレスポンス・コード

- サーバー・エラー - HTTP500xxレスポンス・コード

27.1.7.3 全ポートレット・メトリック

図27-12に示すように、WebCenter PortalまたはPortal Frameworkアプリケーションで使用されている個々のポートレットの履歴パフォーマンス・メトリックを監視できます。このページに表示される情報については、次の表で説明します。

- 表27-9「ポートレット: サマリー」

- 表27-10「ポートレット: 詳細」

- 表27-11「ポートレット: HTTPレスポンス・コードの統計」

- 表27-12「HTTPレスポンス・コード」

注意:
Fusion Middleware Controlを使用してこれらのメトリックにアクセスするには、次のいずれかを参照してください:
第27.2.1.4項「WebCenter Portalの全サービス・メトリックおよびポートレット・プロデューサ・メトリックのモニタリング」

第27.2.2.3項「Portal Frameworkアプリケーションの全ページ・メトリックのモニタリング」

図27-12 ポートレット・メトリック

表27-9 ポートレット: サマリー

メトリック

説明

ステータス

WebCenter PortalまたはPortal Frameworkアプリケーションで使用されているポートレットの現在のステータス

- 稼働中(緑色の上矢印): すべてのポートレットが稼働中であることを示します。

- 停止中(赤色の下矢印): 1つ以上のポートレットが現在使用できないことを示します。プロデューサ・インスタンスが停止しているか、ネットワーク接続の問題がある可能性があります。他の原因については、第27.1.12.3.13項「ポートレットおよびプロデューサ: 問題およびアクション」を参照してください。

- 不明(時計): なんらかの理由でポートレットのステータスを問い合せることができません。管理対象サーバーが停止しているか、ネットワークの問題が原因でノードにアクセスできない可能性があります。さらに診断するには、管理サーバーのログおよび管理対象サーバーのログを確認します。

成功した呼出し(%)

成功したポートレット起動の割合:

- 起動時以降

- 最近の履歴

リクエストが失敗すると、可用性に影響します。これには、タイムアウトや内部エラーなどのアプリケーションに関連する失敗、そしてクライアント/サーバー・エラーが含まれます。

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。第28.2項「ログ情報の表示および構成」を参照してください。

呼出し

1分当たりのポートレットの呼出し数:

- 起動時以降

- 最近の履歴

このメトリックでは、アプリケーションに関連する各ポートレット・リクエストが測定されます。このため、アプリケーションのキャッシュ・ヒット、エラーまたはタイムアウトにより、この合計はポートレット・プロデューサに対して送信された実際のHTTPリクエスト数よりも多くなることがあります。

平均時間(ミリ秒)

ポートレットに関連付けられた操作の処理にかかった平均時間(結果には関係ありません):

- 起動時以降

- 最近の履歴

表27-10 ポートレット: 詳細

メトリック

説明

最もポピュラーなポートレット

各ポートレットの起動回数(チャートで表示)。

チャートの最大値は、最も多く使用されているポートレットを示します。

最小値は、最も使用されていないポートレットを示します。

レスポンス時間

WebCenter PortalまたはPortal Frameworkアプリケーションが起動されてから、各ポートレットでリクエストの処理にかかった平均時間(チャートで表示)。

チャートの最大値は、パフォーマンスが最も低いポートレットを示します。

最小値は、パフォーマンスが最も高いポートレットを示します。

ポートレット名

モニター対象のポートレットの名前。

ステータス

各ポートレットの現在のステータス:

- 稼働中(緑色の上矢印): ポートレットが稼働中であることを示します。

- 停止中(赤色の下矢印): ポートレットが現在使用できないことを示します。プロデューサ・インスタンスが停止しているか、ネットワーク接続の問題がある可能性があります。

プロデューサ名

ポートレットのアクセスに使用されるポートレット・プロデューサの名前。

プロデューサ・タイプ

ポートレット・プロデューサ・タイプ: 「Web」または「WSRP」

- Webポートレット・プロデューサ: J2EEアプリケーション・サーバーにデプロイされるOracle PDK-Javaプロデューサ。これは多くの場合リモートであり、HTTP上でSimple Object Access Protocol (SOAP)を使用して通信します。

- WSRPポートレット・プロデューサ: Web Services for Remote Portlets (WSRP)は、標準対応のコンテナと任意のWSRPアプリケーションの間の相互運用を可能にするWebサービス標準です。

成功した呼出し(%)

成功したポートレット起動の割合:

- 起動時以降

- 最近の履歴

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。第28.2項「ログ情報の表示および構成」を参照してください。

呼出し

各ポートレットの起動回数:

- 起動時以降

- 最近の履歴

この列に基づいて表をソートすると、WebCenter PortalまたはPortal Frameworkアプリケーションで最も頻繁にアクセスされているポートレットがわかります。

平均時間(ミリ秒)

各ポートレットでリクエストの処理にかかった平均時間(結果には関係ありません):

- 起動時以降

- 最近の履歴

このメトリックは、パフォーマンスの低いポートレットを検出する場合に使用します。このメトリックを「呼出し」メトリックと組み合せて使用すると、優先的に取り組む必要のあるポートレットがわかります。

最大時間(ミリ秒)

ポートレット・リクエストの処理にかかった最大時間。

- 成功 - HTTP200xx

- リダイレクト - HTTP300xx

- クライアント・エラー数- HTTP400xx

- サーバー・エラー- HTTP500xx

パフォーマンス統計のHTTPレスポンス・コード別の内訳を調べると、全体の平均レスポンス時間を増加させている要因を特定できます。たとえば、ポートレット・プロデューサ・タイムアウトによる失敗が、全体の平均レスポンス時間を増加させている場合などがあります。

表27-11 ポートレット: HTTPレスポンス・コードの統計

メトリック

説明

ポートレット名

モニター対象のポートレットの名前。

呼出し数

- 成功

- リダイレクト

- クライアント・エラー数

- サーバー・エラー

タイプ(HTTPレスポンス・コード)別の呼出し回数:

- 起動時以降

- 最近の履歴

表27-12「HTTPレスポンス・コード」を参照してください。

平均時間(ミリ秒)

- 成功

- リダイレクト

- クライアント・エラー数

- サーバー・エラー

各ポートレットでリクエストの処理にかかった平均時間:

- 起動時以降

- 最近の履歴

このメトリックは、機能していないポートレットを検出する場合に使用します。このメトリックを「呼出し」メトリックと組み合せて使用すると、優先的に取り組む必要のあるポートレットがわかります。

表27-12 HTTPレスポンス・コード

HTTPレスポンスおよびエラー・コード

説明

200 - リクエスト成功

HTTP2xxレスポンス・コードを返すポートレット・リクエスト、またはリモート・プロデューサにHTTPリクエストを送信しなくても成功したポートレット・リクエスト(たとえば、キャッシュ・ヒットなど)。

300 - 解決できなかったリダイレクト

HTTP3xxレスポンス・コードを返すポートレット・リクエスト。

400 - リクエストを完了できずに失敗

HTTP4xxレスポンス・コードを返すポートレット・リクエスト。

500 - サーバー・エラーのために失敗

なんらかの原因で失敗したポートレット・リクエスト(HTTP5xxレスポンス・コードを返すリクエストや、アプリケーションに関連するエラー、タイムアウト、不正なコンテンツ・タイプ・レスポンス、またはSOAP障害が原因で失敗したリクエストを含む)。

27.1.8 WebLogic Serverメトリックの理解

WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに、最近のWebLogic Serverパフォーマンスのサマリーが表示されます(図27-13および表27-13)。チャートが問題やインシデントを示している場合は、より詳細な情報に移動して、さらに問題を診断できます。

注意:
ホームページにアクセスするには、第6.2項「WebCenter Portalのホームページへの移動」または第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

図27-13 ホームページ上の最近のWebLogic Serverメトリックのサマリー

チャート・レポートは、WebLogic Serverの直前の100回のヘルス・チェックに基づいています。デフォルトでは、メトリックは5分ごとに記録されるため、直前の8時間にわたって収集されたデータをここに表示できます。サーバーが最近起動した場合は、サーバーが起動してから現在時刻にいたるまでのデータがチャートに表示されます。

注意:
必要に応じて、自分のインストールに合うようにメトリックの収集頻度をカスタマイズできます。詳細は、第27.3項「主要なパフォーマンス・メトリックのしきい値および収集のカスタマイズ」を参照してください。

表27-13 ホームページ上の最近のWebLogic Serverメトリック

メトリック

説明

ヘルス

Oracle WebLogic Server自己ヘルス・モニタリング機能によりレポートされた最近のWebLogic Serverヘルスのサマリー。このメトリックは、サーバー・ヘルス、スレッド・ヘルスおよびJDBCヘルスが対象です。

- 緑: WebLogic Serverヘルス・チェックの成功を表します。

- 赤: WebLogic Serverヘルス・チェック時にインシデントが発生したことを表します。
(OKとレポートされない)失敗したヘルス・チェックを特定するには、「ヘルス」をクリックします。図27-14を参照してください。

- %: 成功したWebLogic Serverヘルス・チェックの割合。デフォルトでは、割合は直前の100回のヘルス・チェックからのステータス情報を使用して計算されます。たとえば、直前の100回のヘルス・チェックのうち5回失敗した場合(OKとレポートされない場合)、ヘルスは95%と表示されます。

インシデント

WebLogic Serverメトリックがしきい値の設定(CPU使用率、メモリー使用率、スレッド数、JDBC接続の数、セッション・メトリックなどのメトリック)を超えた回数。

たとえば、メトリック・データ・セットで、スレッド数が事前に定義されたしきい値を2回超え、JDBC接続の数がしきい値制限を3回超えた場合、表示されるインシデント数は5です。

インシデント数が0を超える場合、赤い十字形のアイコンが表示されます。「インシデント」リンクをクリックして「最近のWebLogic Serverメトリック」ページ(図27-13)にドリルダウンし、「ヘルス・メトリック」表を調べて、さらにインシデントを診断します。

「ヘルス」または「インシデント」をクリックすると、「最近のWebLogic Serverメトリック」ページ(図27-13)にドリルダウンできます。このページに表示されるメトリックについては、次の項で説明します。

- 「WebLogic Serverメトリック」セクション

- 「最近のCPUおよびメモリー使用状況」セクション

- 「最近のセッションおよびスレッド使用状況」セクション

- 「最近のJDBC使用状況」セクション

- 「ヘルス・メトリック」セクション

図27-14 「最近のWebLogic Serverメトリック」ページ

「WebLogic Serverメトリック」セクション

メトリック

説明

一般

稼働開始

サーバーが最後に起動した日時。

状態

このサーバーの現在のライフサイクル状態。たとえば、リクエストを受信して処理できるRUNNING状態や、管理リクエストのみを受信できるADMIN状態などです。
詳細は、『Oracle WebLogic Serverサーバーの起動と停止の管理』のサーバーのライフ・サイクルの理解に関する項を参照してください。

ヘルス

Oracle WebLogic Server自己ヘルス・モニタリング機能によりレポートされたサーバーのヘルス・ステータス。
たとえば、サーバーは、リクエストが多すぎて過負荷状態であること、より多くのメモリー・リソースが必要であること、または他の理由でまもなく失敗することをレポートできます。

詳細は、Oracle WebLogic Server管理コンソールのオンライン・ヘルプのヘルス・モニタリングの構成に関する項を参照してください。

CPU使用率(%)

Java Virtual Machine (JVM)で現在使用されているCPUの比率。これには、JVMがホスト・コンピュータ内のすべてのプロセッサに与えている負荷が含まれます。
たとえば、ホストが複数のプロセッサを使用している場合、この値はすべてのプロセッサにおける平均負荷のスナップショットを表します。

ヒープ使用量(MB)

Java Virtual Machine (JVM)で現在使用されているメモリー・ヒープのサイズ(MB)。

Javaベンダー

サーバーが実行されている現在のJava Development Kit (JDK)を提供した会社名。

Javaバージョン

現在のサーバーが実行されているJDKのバージョン。

パフォーマンス

ガベージ・コレクション・レート(/分)

Java Virtual Machine (JVM)がガベージ・コレクション・ルーチンを呼び出している比率(/分)。
デフォルトでは、このメトリックは、直前の5分間に記録された比率を示します。第27.3.5項「WebLogic Serverヘルス・チェックの頻度の構成」を参照してください。

ガベージ・コレクション平均時間(ミリ秒)

ガベージ・コレクションの各実行でJava Virtual Machineが費やした時間の長さの平均(ミリ秒)。表示される平均は直前の5分間のものです。
デフォルトでは、このメトリックは、直前の5分間の平均を示します。第27.3.5項「WebLogic Serverヘルス・チェックの頻度の構成」を参照してください。

アクティブな実行スレッド

プール内のアクティブな実行スレッドの数。

アイドル中の実行スレッド数

プール内のアイドル・スレッドの数。この数には、スタンバイ・スレッドおよびスタック・スレッドは含まれません。この数は、新しい処理が届いたときに対応することができるスレッドの数を示します。

占有実行スレッド

リクエストによって現在保持されているスレッドの数。これらのスレッドは、構成されているタイムアウトの経過後にスタックとして宣言されるか、プールに戻されます。必要な場合は、自己チューニング・メカニズムによって戻されます。

アクティブ・セッション

アプリケーションのアクティブ・セッションの数。

オープンJDBCセッション

現在オープンしているJDBC接続の数。

インシデント

WebLogic Serverメトリックがしきい値の設定(CPU使用率、メモリー使用率、スレッド数、JDBC接続の数、セッション・メトリックなどのメトリック)を超えた回数。
たとえば、メトリック・データ・セットで、スレッド数が事前に定義されたしきい値を2回超え、JDBC接続の数がしきい値制限を3回超えた場合、表示されるインシデント数は5です。

インシデント数が0を超える場合、赤い十字形のアイコンが表示されます。

ヘルス

Oracle WebLogic Server自己ヘルス・モニタリング機能によりレポートされた最近のヘルス・ステータスのサマリー。
ヘルス・チャート・レポートは、直前の100回のヘルス・チェックに基づいています。デフォルトでは、メトリックは5分ごとに記録されるため、直前の500分にわたって収集されたデータが表示されます。サーバーが最近起動した場合は、サーバーが起動してから現在時刻にいたるまでのデータがチャートに表示されます。

- 緑: ヘルス・チェックの成功、つまりOKを返すチェックを表します。

- 赤: ヘルス・チェックがOK以外のステータスを返したことを表します。たとえば、デフォルト・キュー内のすべてのスレッドがスタックすると、サーバーのヘルス状態は「クリティカル」に変わります。同様に、weblogic.admin.HTTP、weblogic.admin.RMIまたはユーザー定義の実行キュー内のすべてのスレッドがスタックすると、サーバーのヘルス状態は「警告」に変わります。
失敗したヘルス・チェックを特定するには、ページ下部の「ヘルス・メトリック」セクションを確認します。

- %: 成功(OK)したヘルス・チェックの割合。割合は、直前の100回のヘルス・チェックからのステータス情報を使用して計算されます。たとえば、直前の100回のスレッド・ヘルス・チェックのうち5回失敗した場合、スレッド・ヘルスは95%と表示されます。

WebLogic Server

最近のWebLogic Serverヘルス・チェックのレポート。
たとえば、直前の100回のWebLogic Serverヘルス・チェックのうち10回失敗した場合(OKでない場合)、WebLogic Serverヘルスは90%と表示されます。

スレッド

最近のスレッド・ヘルス・チェックのレポート。
たとえば、直前の100回のWebLogic Serverヘルス・チェックのうち10回でOK以外のスレッド・ヘルス・ステータスがレポートされた場合、WebLogic Serverスレッド・ヘルスは90%と表示されます。

スレッド・ヘルスの障害の例を、次に示します。

- デフォルト・キュー内のすべてのスレッドがスタックすると、サーバーのヘルス状態は「クリティカル」に変わります。

- weblogic.admin.HTTP、weblogic.admin.RMIまたはユーザー定義の実行キュー内のすべてのスレッドがスタックすると、サーバーのヘルス状態は「警告」に変わります。

JDBC

最近のJDBCヘルス・チェックのレポート。たとえば、サーバーは、JDBC接続リクエストが多すぎることをレポートできます。
直前の100回のWebLogic Serverヘルス・チェックのうち10回でOK以外のJDBCヘルス・ステータスがレポートされた場合、WebLogic Server JDBCヘルスは90%と表示されます。

「最近のCPUおよびメモリー使用状況」セクション

このグラフは、直前の100回のヘルス・チェックのJava Virtual MachineのCPU使用率およびメモリー使用量を示します。時間範囲は最も早いヘルス・チェックで開始し、最後のヘルス・チェックの時間で終了します。

このパフォーマンス・グラフから、仮想マシン用に構成されているメモリー/CPUの実際の使用量と、増加傾向にあるかどうかを判断できます。これにより、その仮想マシン内で実行しているアプリケーションが、仮想マシンに割り当てられている以上のメモリーを必要としており、仮想マシンにメモリーを追加することで(ホスト・レベルで十分なメモリーがある場合)、パフォーマンスが改善される可能性があることが明らかになります。同様に、追加のCPUリソースが必要かどうかを評価できます。

メトリック

説明

CPU使用率(%)

Java Virtual Machine (JVM)で現在使用されているCPUの比率。これには、JVMがホスト・コンピュータ内のすべてのプロセッサに与えている負荷が含まれます。
たとえば、ホストが複数のプロセッサを使用している場合、この値はすべてのプロセッサにおける平均負荷のスナップショットを表します。

ヒープ使用量(MB)

Java Virtual Machine (JVM)で現在使用されているメモリー・ヒープのサイズ(MB)。

「最近のセッションおよびスレッド使用状況」セクション

このグラフは、直前の100回のヘルス・チェックで記録されたアクティブ・セッションおよびアクティブ・スレッドの数を示します。時間範囲は最も早いヘルス・チェックで開始し、最後のヘルス・チェックの時間で終了します。

アクティブ・セッションおよびアクティブ・スレッドの数は、システムの負荷とともに増減します。グラフが突然の増加を示したり、セッションまたはスレッドの数が増え続ける場合は、問題を詳しく調査して、動作の変化を引き起こした原因を把握します。

メトリック

説明

アクティブ・セッション

アプリケーションのアクティブ・セッションの数。

アクティブ・スレッド

アプリケーションのアクティブ・スレッドの数。

「最近のJDBC使用状況」セクション

このグラフは、直前の100回のヘルス・チェックで記録されたオープンJDBCセッションの数を示します。時間範囲は最も早いヘルス・チェックで開始し、最後のヘルス・チェックの時間で終了します。

ここに表示される全体のオープンJDBCセッション数は、サーバーに属するすべてのデータ・ソースにおける現在アクティブな接続数メトリックを使用して計算されます。

このチャートを使用して、使用されているJDBCセッションの数と、システムがJDBCリソースをリークしているかどうかを判断します。このチャートの情報を使用すると、JDBC構成または接続プール・サイズを調整する必要があるかどうかを評価できます。

第G.4.2.4項「接続プール設定の確認」を参照してください。

「ヘルス・メトリック」セクション

この表には、Oracle WebLogic Server自己ヘルス・モニタリング機能によりレポートされる、収集された直前の100回のWebLogic Serverヘルス・メトリックのデータが表示されます。

メトリック

説明

日時

WebLogic Serverヘルス・チェックの日時。

サーバー・ヘルス

Oracle WebLogic Server自己ヘルス・モニタリング機能によりレポートされたサーバー・ヘルス・ステータス。
ヘルス・チェックが成功すると、「OK」が返されます。ヘルス・チェックが失敗した場合は、様々な障害がレポートされます。たとえば、サーバーは、リクエストが多すぎて過負荷状態であること、より多くのメモリー・リソースが必要であること、または他の理由でまもなく失敗することをレポートできます。

詳細は、Oracle WebLogic Server管理コンソールのオンライン・ヘルプのヘルス・モニタリングの構成に関する項を参照してください。

スレッド・ヘルス

Oracle WebLogic Server自己ヘルス・モニタリング機能によりレポートされたスレッド・ヘルス・ステータス。
ヘルス・チェックが成功すると、「OK」が返されます。スレッド・チェックが失敗した場合は、様々な障害がレポートされます。たとえば、デフォルト・キュー内のすべてのスレッドがスタックすると、サーバーのヘルス状態は「クリティカル」に変わります。weblogic.admin.HTTP、weblogic.admin.RMIまたはユーザー定義の実行キュー内のすべてのスレッドがスタックすると、サーバーのヘルス状態は「警告」に変わります。

詳細は、Oracle WebLogic Server管理コンソールのオンライン・ヘルプのヘルス・モニタリングの構成に関する項を参照してください。

JDBCヘルス

Oracle WebLogic Server自己ヘルス・モニタリング機能によりレポートされたJDBCヘルス・ステータス。
ヘルス・チェックが成功すると、「OK」が返されます。JDBCチェックが失敗した場合は、様々な障害がレポートされます。たとえば、サーバーが、JDBC接続リクエストが多すぎるまたはより多くのメモリー・リソースが必要であることをレポートすると、サーバーのヘルス状態は「警告」に変わります。

詳細は、Oracle WebLogic Server管理コンソールのオンライン・ヘルプのヘルス・モニタリングの構成に関する項を参照してください。

サーバーCPU (%)

Oracle JRocket JDKを使用している場合、このメトリックは、Java仮想マシン(JVM)で現在使用されているCPUの比率を表します。これには、JVMがホスト・コンピュータ内のすべてのプロセッサに与えている負荷が含まれます。
たとえば、ホストが複数のプロセッサを使用している場合、この値はすべてのプロセッサにおける平均負荷のスナップショットを表します。

ヒープ使用量(MB)

JVMで現在使用されているメモリー・ヒープの総量(MB)。

ガベージ・コレクション平均時間(ミリ秒)

ガベージ・コレクションの各実行でJava Virtual Machineが費やした時間の長さの平均(ミリ秒)。表示される平均は直前の5分間のものです。
デフォルトでは、このメトリックは、直前の5分間の平均を示します。第27.3.5項「WebLogic Serverヘルス・チェックの頻度の構成」を参照してください。

ガベージ・コレクション・レート(/分)

Java Virtual Machine (JVM)がガベージ・コレクション・ルーチンを呼び出している比率(/分)。
デフォルトでは、このメトリックは、直前の5分間に記録された比率を示します。第27.3.5項「WebLogic Serverヘルス・チェックの頻度の構成」を参照してください。

アクティブ・セッション

アプリケーションのアクティブ・セッションの数。

アクティブな実行スレッド

プール内のアクティブな実行スレッドの数。

アイドル中の実行スレッド数

プール内のアイドル・スレッドの数。この数には、スタンバイ・スレッドおよびスタック・スレッドは含まれません。この数は、新しい処理が届いたときに対応することができるスレッドの数を示します。

占有スレッド数

リクエストによって現在保持されているスレッドの数。これらのスレッドは、構成されているタイムアウトの経過後にスタックとして宣言されるか、プールに戻されます。必要な場合は、自己チューニング・メカニズムによって戻されます。

オープンJDBC接続

現在オープンしているJDBC接続の数。

27.1.9 セキュリティ・メトリックの理解

WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに、主要ないくつかのセキュリティ関連パフォーマンス・メトリックが表示されます(図27-15および表27-14)。

注意:
ホームページにアクセスするには、第6.2項「WebCenter Portalのホームページへの移動」または第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

図27-15 ホームページ上のセキュリティ・メトリック

「起動時以降」のメトリックと「最近の履歴」のメトリックを比較すると、最近になってパフォーマンスが低下していないかどうか、低下している場合はその程度を判断できます。

表27-14 セキュリティ・メトリック

メトリック

説明

LDAPキャッシュ・ヒット率(%)

キャッシュ・ヒットとなるLDAP検索の割合。

WebCenter Portalは、パフォーマンスを向上するためにユーザー・プロファイルをキャッシュします。デフォルトでは、1000プロファイルがキャッシュされ、キャッシュを適切な状態に維持するために、60秒間アクセスされないキャッシュ・プロファイルはキャッシュから出されます。

システムがウォームアップされ、キャッシュが移入されると、このメトリックは100%近くになります。一般的な状況では、キャッシュ・ヒット率は90%を超えます。キャッシュ・ヒット率が90%を下回る場合は、プロファイル情報がキャッシュに格納される時間を長くするか、キャッシュ内で有効なプロファイル・オブジェクトの数を増やします。これには、WLSTコマンドのsetProfileCacheTimeToLiveおよびsetProfileCacheNumberOfObjectsをそれぞれ使用します。

詳細は、第16.9項「プロファイル・サービスのキャッシュ・オプションの構成」を参照してください。

注意: ヒット率は常に、システムの再起動後は低く、ユーザーがWebCenter Portalアプリケーションにアクセスするとともに徐々に増加します。

平均LDAP参照時間(ミリ秒)

LDAP検索リクエスト完了の平均時間。

- 起動時以降

- 最近の履歴脚注 1

LDAP検索に時間がかかる場合は、LDAPサーバーに問題があり、それが原因で低速なレスポンス時間を引き起こしている可能性があります。Oracle Internet Directoryを使用している場合は、パフォーマンスを改善し、ボトルネックを回避する方法について、パフォーマンス・チューニング・ガイドのOracle Internet Directoryパフォーマンス・チューニングに関する項を参照してください。他のLDAPサーバーについては、該当の製品ドキュメントを参照してください。

脚注 1 最近のパフォーマンス・メトリックを計算するには、直前の10-15分のデータが使用されます。詳細は、「WebCenter Portalのメトリック収集: 最近の履歴および起動時以降」を参照してください。

27.1.10 ページ・レスポンス・メトリックおよび負荷メトリックの理解

アプリケーションのホームページ上の「ページ・レスポンス」チャート(図27-15)は、ページ・リクエストに対するWebLogic Serverのレスポンス時間と、処理されているリクエスト数(負荷)を示します。

すべてのポータルでの平均ページ処理時間(ミリ秒)は、15分間にわたって計算されます。1分当たりの呼出し数も表示され、平均ページ処理時間が増加しているのか減少しているのかを判断する上で役立ちます。ページ処理時間の低下が、多数のユーザーがシステムにアクセスしていることが原因の場合は、1分当たりの呼出しの増加がグラフに表示されます。ユーザー数が増加していない場合(1分当たりの呼出しグラフが増加したり変化していない場合)、ページ処理速度の低下は、マシン・リソースの問題や、JVMリソースの不足(メモリー不足、データベース接続の競合など)の可能性が高いと考えられます。

「表ビュー」をクリックして、5分間隔で記録された詳細なレスポンス値および負荷値を参照します。

注意:
ホームページにアクセスするには、第6.2項「WebCenter Portalのホームページへの移動」または第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

図27-16 ホームページ上のページ・レスポンス・メトリック

「起動時以降」のメトリックと「最近の履歴」のメトリック(直前の15分)を比較すると、最近になってパフォーマンスが低下していないかどうか、低下している場合はその程度を判断できます。

27.1.11 ポータル・メトリックの理解

(WebCenter Portalのみ) 図27-17に示すように、Fusion Middleware Controlを使用して、個々のポータルの現在のパフォーマンス・メトリックを表示できます。このページに表示されるメトリックについては、表27-15および第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

注意:
ホーム・ポータルのメトリックは含まれません。

図27-17 ポータル・メトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

このページの上部の表には、個々のポータルのステータスとパフォーマンスがまとめて表示されます。この表を使用すると、どのポータルが稼働中かがすぐにわかり、個別的および相対的なパフォーマンスを確認できます。

統計は、ポータルが作成されると使用可能になり、メンバーがポータルにアクセスしたり使用するたびに更新されます。

表示されているデータは、次の方法でフィルタ処理できます。

- ポータル名フィルタ: 検索語の全部または一部を入力し、「リフレッシュ」アイコンをクリックすると、表示名に一致が見つかったすべてのポータル(以前はスペースと呼ばれていました)のリストに更新されます。すべてのポータルのメトリックを表示するには、検索語をクリアし、「リフレッシュ」を再度クリックします。

- 最大行数: 表に表示するポータルの総数を制限します。

- 表示: 最も人気があるポータル、最も遅いポータルまたは最もエラーが多いポータルのメトリックを表示します。選択に応じて、表のポータルは次の順序で並べられます。
- 呼出し数(最もアクセスされたポータル)

- 平均ページ処理時間(最も遅いポータル)

- エラー数(最もエラーが多いポータル)

- 期間: 起動時以降または直前の15分間(最近の履歴)に収集されたメトリック情報を表示します。

上位5つのポータルがチャートに表示されます。

表27-15 ポータル・メトリック

メトリック

説明

名前

フィルタ基準(指定されている場合)に一致するポータルの名前。

フィルタ基準が指定されない場合は、すべてのポータルがリストされます。

ステータス

各ポータルの現在のステータス。

- 稼働中(緑色の上矢印): 最後のポータル操作が成功したことを示します。ポータルは稼働中です。

- 停止中(赤色の下矢印): ポータルが現在使用できないか、予期しないエラーまたは例外のために最後のポータル操作が失敗したことを示します。認証の失敗などのユーザー・エラーによってステータスが「停止中」に変わることはありません。

- 使用不可(時計): ステータス情報は現在使用できません。

呼出し

ポータル呼出しの合計数。

- 起動時以降

- 最近の履歴

エラー

記録されたエラーの数。

成功した呼出し(%)

成功したポータル呼出しの割合。

- 起動時以降

- 最近の履歴

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、ポータル・リクエストの失敗の原因を特定してください。第28.2項「ログ情報の表示および構成」を参照してください。

ページ・スループット

各ポータルについて1分間に処理された平均ページ数:

- 起動時以降

- 最近の履歴

平均時間(ミリ秒)

ポータルにページを表示するための平均時間(ミリ秒)。

- 起動時以降

- 最近の履歴

最大時間(ミリ秒)

ポータルでページの表示にかかった最大時間。

最小時間(ミリ秒)

ポータルでページの表示にかかった最小時間。

ポータル・メトリック - グラフ

表の下のグラフを使用すると、ポータル(以前はスペースと呼ばれていました)に関する情報を確認できます。

- 呼出し: 最もアクティブ/人気のポータル(つまり、最も多くの呼出しが記録されているポータル)を示すグラフ。

- ページ・スループット: 各ポータルについて1分間にアクセスされた平均ページ数を示すグラフ。このグラフを使用すると、ページ・ヒット率が高い(または低い)ポータルを特定できます。

- 平均処理時間: 平均ページ・レスポンス時間(ミリ秒)を示すグラフ。このグラフを使用すると、ページ・パフォーマンスが最高(または最低)のポータルを特定できます。

- エラー: エラーを最も多くレポートしているポータルを示すグラフ。このグラフを使用すると、エラー率を比較できます。

異なるポータルのセットを比較する手順は次のとおりです。

- 適切なフィルタリング基準を指定します。

- 表で1つ以上のポータルを選択し、「チャートで表示」をクリックします。

27.1.12 ツール・メトリックおよびサービス・メトリックの理解

この項には次のトピックが含まれます:

- 第27.1.12.1項「すべてのツールとサービスに共通するメトリック」

- 第27.1.12.2項「特定のツールまたはサービス固有のメトリック」

- 第27.1.12.3項「ツールとサービスに関する一般的な問題のトラブルシューティング」

27.1.12.1 すべてのツールとサービスに共通するメトリック

Fusion Middleware Controlでは、WebCenter PortalおよびPortal Frameworkアプリケーションで使用されるツールとサービスのパフォーマンスを次の方法でモニターする機能が用意されています。

- サービス・サマリー: WebCenter PortalまたはPortal Frameworkアプリケーションで使用されている各ツールまたはサービスのパフォーマンス・メトリックのサマリーです。表27-16に、共通のパフォーマンス・メトリックを使用するツールとサービスを示します。表27-17で、共通メトリックについて説明します。

- 最もポピュラーな操作および個別の操作のレスポンス時間。表27-18で、これらのメトリックについて説明します。

- 操作別メトリック: 個別の操作のパフォーマンス・メトリック。表27-16に、個別の操作のパフォーマンスをモニターするために使用される共通のパフォーマンス・メトリックを示します。表27-18で、これらのメトリックについて説明します。

表27-16 ツールとサービスの共通メトリック

ツールまたはサービス

サービス・サマリー(起動時以降および最近の履歴)

操作別メトリック(起動時以降および最近の履歴)

お知らせ

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

BPELワークリスト

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

該当なし

ディスカッション・フォーラム

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

外部アプリケーション

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

イベント

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

インポート/エクスポート

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

インスタント・メッセージおよびプレゼンス(IMP)

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

リスト

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

メール

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

ノート

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

ページ

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

ピープル・コネクション

パフォーマンス・メトリックには、次のものが含まれます。

- 平均処理時間(ミリ秒)

- 呼出し

- 成功した呼出し(%)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

投票

パフォーマンス・メトリックには、次のものが含まれます。

- 平均処理時間(ミリ秒)

- 呼出し

- 成功した呼出し(%)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

最近のアクティビティ

パフォーマンス・メトリックには、次のものが含まれます。

- 平均時間(ミリ秒)

- 成功した呼出し(%)

- 呼出し

なし

RSS

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

なし

検索

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

表27-17では、すべての操作のパフォーマンスをモニタリングするために使用されるメトリックについて説明します。

表27-17 共通メトリックの説明: サマリー(すべての操作)

メトリック

説明

ステータス

ツールまたはサービスの現在のステータス:

- 稼働中(緑色の上矢印): ツールまたはサービスが稼働中であり、最後の操作が成功したことを示します。

- 停止中(赤色の下矢印): ツールまたはサービスが現在使用できないことを示します。最後の操作が予期しないエラーまたは例外により失敗しました。認証の失敗などのユーザー・エラーによってステータスが「停止中」に変わることはありません。

- 不明(時計): ツールまたはサービスがなんらかの理由でWebCenter PortalまたはPortal Frameworkアプリケーションのステータスを問い合せることができないことを示します。管理対象サーバーが停止しているか、ネットワークの問題が原因でノードにアクセスできない可能性があります。

特定のサービスが停止中または不明の場合は、考えられる原因とアクションについて、第27.1.12.3項「ツールとサービスに関する一般的な問題のトラブルシューティング」を参照してください。

成功した呼出し(%)

成功したサービス呼出しの割合。成功した呼出し(%)は、成功した呼出し数を呼出し数で除算した値に一致します。

- 起動時以降

- 最近の履歴

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。第28.2項「ログ情報の表示および構成」を参照してください。

呼出し

1分当たりのサービス呼出し数:

- 起動時以降

- 最近の履歴

このメトリックは、操作の処理で特定のツールまたはサービスが呼び出される頻度に関するデータを提供します。サービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたツールおよびサービスを特定できます。

平均時間(ミリ秒)

ツールまたはサービスに関連付けられた操作の処理にかかった平均時間。このメトリックは、操作の処理に費やされた総時間を評価するために呼出し数のメトリックとともに使用できます。

- 起動時以降

- 最近の履歴

このメトリックを使用すると、ツールおよびサービス全体のパフォーマンスを判断できます。このメトリックが範囲外の場合は(操作の平均時間が増加しているか予想より高い場合)、個々の名前をクリックして、詳細なメトリック・データを表示します。

表27-18では、ツール、サービスまたはコンポーネントによって実行される各操作のパフォーマンスをモニターするために使用されるメトリックについて説明します。

表27-18 共通メトリックの説明: 操作別

メトリック

説明

最もポピュラーな操作

各操作の起動回数(チャートで表示)。

チャートの最大値は、最も多く使用されている操作を示します。

最小値は、最も使用されていない操作を示します。

レスポンス時間

WebCenter PortalまたはPortal Frameworkアプリケーションが起動されてから、サービスに関連付けられた操作の処理にかかった平均時間(チャートで表示)。

チャートの最大値は、パフォーマンスが最も低い操作を示します。

最小値は、パフォーマンスが最も高い操作を示します。

操作

モニター対象の操作。第27.1.12.2項「特定のツールまたはサービス固有のメトリック」を参照してください。

呼出し

各操作の起動回数:

- 起動時以降

- 最近の履歴

このメトリックは、操作の処理で特定のツールまたはサービスが呼び出される頻度に関するデータを提供します。サービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたサービスを特定できます。

平均時間(ミリ秒)

各操作の処理にかかった平均時間:

- 起動時以降*

- 最近の履歴

*この情報は、「レスポンス時間」チャートにも表示されます。

最大時間(ミリ秒)

各操作の処理にかかった最大時間。

27.1.12.2 特定のツールまたはサービス固有のメトリック

この項では、すべてのツール、サービスおよびコンポーネントの操作別メトリックについて説明します。この項には次のトピックが含まれます:

- 第27.1.12.2.1項「お知らせのメトリック」

- 第27.1.12.2.2項「BPELワークリストのメトリック」

- 第27.1.12.2.3項「コンテンツ・リポジトリのメトリック」

- 第27.1.12.2.4項「ディスカッションのメトリック」

- 第27.1.12.2.6項「外部アプリケーションのメトリック」

- 第27.1.12.2.5項「イベントのメトリック」

- 第27.1.12.2.7項「インスタント・メッセージおよびプレゼンスのメトリック」

- 第27.1.12.2.8項「インポートおよびエクスポートのメトリック」

- 第27.1.12.2.9項「リストのメトリック」

- 第27.1.12.2.10項「メールのメトリック」

- 第27.1.12.2.11項「ノートのメトリック」

- 第27.1.12.2.12項「ページ操作のメトリック」

- 第27.1.12.2.13項「ピープル・コネクションのメトリック」

- 第27.1.12.2.14項「投票のメトリック」

- 第27.1.12.2.15項「RSSニュース・フィードのメトリック」

- 第27.1.12.2.16項「最近のアクティビティのメトリック」

- 第27.1.12.2.17項「検索のメトリック」

WebCenter PortalまたはPortal Frameworkアプリケーションの現在のパフォーマンス・メトリックにアクセスするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

27.1.12.2.1 お知らせのメトリック

お知らせに関連するパフォーマンス・メトリック(図27-18)については、表27-19および第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

図27-18 お知らせのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表27-19 お知らせ: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

ログイン

(お知らせにアクセスしている)WebCenter Portalユーザーが、お知らせをホストしているディスカッション・サーバーにログインします。

特定の原因については、第27.1.12.3.1項「お知らせ: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

ログアウト

WebCenter Portalユーザーが、お知らせをホストしているディスカッション・サーバーからログアウトします。

特定の原因については、第27.1.12.3.1項「お知らせ: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

検索

お知らせテキスト内の文字列を検索します。

お知らせの検索に失敗する場合は、お知らせのテキストに検索語が含まれていることを確認します。

その他の原因については、第27.1.12.3.1項「お知らせ: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

作成

お知らせを作成します。

特定の原因については、第27.1.12.3.1項「お知らせ: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

リスト

お知らせのリストを取得します。

特定の原因については、第27.1.12.3.1項「お知らせ: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

27.1.12.2.2 BPELワークリストのメトリック

ワークリストに関連するパフォーマンス・メトリック(図27-19)については、第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

図27-19 BPELワークリストのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

27.1.12.2.3 コンテンツ・リポジトリのメトリック

次の表では、ドキュメントおよびコンテンツ・プレゼンタに関連するパフォーマンス・メトリック(図27-20および図27-21)について説明します。

- 表27-20「コンテンツ・リポジトリ: モニター対象の操作」

- 表27-21「コンテンツ・リポジトリのメトリック: サマリー(すべてのリポジトリ)」

- 表27-22「コンテンツ・リポジトリのメトリック: 各リポジトリの操作サマリー」

- 表27-23「コンテンツ・リポジトリのメトリック: 各リポジトリの操作詳細」

図27-20 コンテンツ・リポジトリのメトリック

図27-21 コンテンツ・リポジトリのメトリック: 操作別

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表27-20 コンテンツ・リポジトリ: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

ダウンロード

1つ以上のドキュメントをコンテンツ・リポジトリからダウンロードします。

特定の原因については、第27.1.12.3.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

アップロード

1つ以上のドキュメントをコンテンツ・リポジトリにアップロードします。

特定の原因については、第27.1.12.3.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

検索

コンテンツ・リポジトリに格納されているドキュメントを検索します。

特定の原因については、第27.1.12.3.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

ログイン

コンテンツ・リポジトリへの接続を確立し、ユーザーを認証します。

特定の原因については、第27.1.12.3.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

削除

コンテンツ・リポジトリに格納されている1つ以上のドキュメントを削除します。

特定の原因については、第27.1.12.3.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

フォルダのリスト

コンテンツ・リポジトリに格納されているフォルダのリストを表示します。この操作は、コンテンツ・プレゼンタに固有のものです。

特定の原因については、第27.1.12.3.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

項目の取得

コンテンツ・リポジトリに保存されたドキュメントやイメージなどの項目を表示します。この操作は、コンテンツ・プレゼンタに固有のものです。

特定の原因については、第27.1.12.3.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

表27-21 コンテンツ・リポジトリのメトリック: サマリー(すべてのリポジトリ)

メトリック

説明

ステータス

ドキュメント・ツールの現在のステータス:

- 稼働中(緑色の上矢印): ドキュメント・ツールが稼働中であり、最後の操作が成功したことを示します。

- 停止中(赤色の下矢印): ドキュメント・ツールが現在使用できないか、サービス・リクエストが失敗していることを示します。これはまた、最後の操作が予期しないエラーまたは例外により失敗したことを示します。認証の失敗などのユーザー・エラーによってステータスが「停止中」に変わることはありません。
ドキュメントに問題がある場合は、診断ログを調べて、このツールが停止した原因を特定してください。第28.2項「ログ情報の表示および構成」を参照してください。

よくある失敗原因は次のとおりです。

- コンテンツ・リポジトリが停止しているか、応答していません。

- アプリケーションと1つ以上のコンテンツ・リポジトリの間にネットワーク接続の問題があります。

- 1つ以上のコンテンツ・リポジトリに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

- 不明(時計): なんらかの理由でツールのステータスを問い合せることができません。管理対象サーバーが停止しているか、ネットワークの問題が原因でノードにアクセスできない可能性があります。さらに診断するには、管理サーバーのログおよび管理対象サーバーのログを確認します。

成功した呼出し(%)

成功したドキュメントの呼出し(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の割合:

- 起動時以降

- 最近の履歴

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。第28.2項「ログ情報の表示および構成」を参照してください。

呼出し

1分当たりのドキュメントの呼出し数(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」):

- 起動時以降

- 最近の履歴

このメトリックは、操作の処理で特定のツールまたはサービスが呼び出される頻度に関するデータを提供します。サービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたツールまたはサービスを特定できます。

平均時間(ミリ秒)

ドキュメントに関連付けられた操作(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の処理にかかった平均時間:

- 起動時以降

- 最近の履歴

最もポピュラーな操作

各操作の起動回数(チャートで表示)。

チャートの最大値は、最も多く使用されている操作を示します。

最小値は、最も使用されていない操作を示します。

レスポンス時間

WebCenter PortalまたはPortal Frameworkアプリケーションが起動されてから、ドキュメントに関連付けられた操作の処理にかかった平均時間(チャートで表示)。

チャートの最大値は、パフォーマンスが最も低い操作を示します。

最小値は、パフォーマンスが最も高い操作を示します。

ダウンロード・スループット(バイト数/秒)

ドキュメントがダウンロードされる速度。

アップロード・スループット(バイト数/秒)

ドキュメントがアップロードされる速度。

表27-22 コンテンツ・リポジトリのメトリック: 各リポジトリの操作サマリー

メトリック

説明

ステータス

コンテンツ・リポジトリの現在のステータス:

- 稼働中(緑色の上矢印): コンテンツ・リポジトリが稼働中であり、最後の操作が成功したことを示します。

- 停止中(赤色の下矢印): コンテンツ・リポジトリが現在使用できないか、サービス・リクエストが失敗していることを示します。これはまた、最後の操作が予期しないエラーまたは例外により失敗したことを示します。認証の失敗などのユーザー・エラーによってステータスが「停止中」に変わることはありません。
コンテンツ・リポジトリに問題がある場合は、診断ログを調べて、このサービスが停止した原因を特定してください。第28.2項「ログ情報の表示および構成」を参照してください。

よくある失敗原因は次のとおりです。

- コンテンツ・リポジトリが停止しているか、応答していません。

- アプリケーションと1つ以上のコンテンツ・リポジトリの間にネットワーク接続の問題があります。

- 1つ以上のコンテンツ・リポジトリに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

- 不明(時計): なんらかの理由でツールまたはサービスのステータスを問い合せることができません。管理対象サーバーが停止しているか、ネットワークの問題が原因でノードにアクセスできない可能性があります。さらに診断するには、管理サーバーのログおよび管理対象サーバーのログを確認します。

成功した呼出し(%)

このコンテンツ・リポジトリに対して成功したドキュメントの呼出し(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の割合:

- 起動時以降

- 最近の履歴

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。第28.2項「ログ情報の表示および構成」を参照してください。

呼出し

このコンテンツ・リポジトリに対する1分当たりのドキュメントの呼出し数(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」):

- 起動時以降

- 最近の履歴

このメトリックは、操作の処理で特定のツールまたはサービスが呼び出される頻度に関するデータを提供します。ツールおよびサービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたツールおよびサービスを特定できます。

平均時間(ミリ秒)

このコンテンツ・リポジトリに対してドキュメントに関連付けられた操作(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の処理にかかった平均時間:

- 起動時以降

- 最近の履歴

ダウンロードされたバイト数

このコンテンツ・リポジトリからダウンロードされたデータ量。

ダウンロード・スループット(バイト数/秒)

このコンテンツ・リポジトリからドキュメントがダウンロードされる速度。

アップロードされたバイト数

このコンテンツ・リポジトリにアップロードされたデータ量。

アップロード・スループット(バイト数/秒)

このコンテンツ・リポジトリにドキュメントがアップロードされる速度。

最大時間(ミリ秒)

このコンテンツ・リポジトリに対してドキュメントに関連付けられた操作(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の処理にかかった最大時間。

表27-23 コンテンツ・リポジトリのメトリック: 各リポジトリの操作詳細

メトリック

説明

呼出し

ドキュメント操作別の呼出し数(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」):

- 起動時以降

- 最近の履歴

このメトリックは、操作の処理で特定のサービスが呼び出される頻度に関するデータを提供します。サービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたサービスを特定できます。

平均処理時間(ミリ秒)

ドキュメントに関連付けられた各操作(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の処理にかかった平均時間:

- 起動時以降

- 最近の履歴

27.1.12.2.4 ディスカッションのメトリック

ディスカッションに関連するパフォーマンス・メトリック(図27-22)については、表27-24および第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

図27-22 ディスカッションのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表27-24 ディスカッション: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

ログイン

(ディスカッションにアクセスしている)WebCenter Portalユーザーが、ディスカッション・フォーラムをホストしているディスカッション・サーバーにログインします。

特定の原因については、第27.1.12.3.4項「ディスカッション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

ログアウト

WebCenter Portalユーザーが、ディスカッション・フォーラムをホストしているディスカッション・サーバーからログアウトします。

特定の原因については、第27.1.12.3.4項「ディスカッション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

フォーラムの作成

ディスカッション・サーバー内に、特定のカテゴリに含まれるディスカッション・フォーラムを作成します。

フォーラムの作成に関する問題がある場合は、次の原因が考えられます。

- ディスカッション・フォーラムを作成する必要があるカテゴリが削除されました。

- ユーザーにディスカッション・フォーラムを作成する権限がありません。

その他の特定の原因については、第27.1.12.3.4項「ディスカッション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

トピックの作成

ディスカッション・サーバー内に、特定のフォーラムに含まれるトピックを作成します。

トピックの作成に関する問題がある場合は、次の原因が考えられます。

- トピックを作成する必要があるディスカッション・フォーラムが削除されました。

- ユーザーにトピックを作成する権限がありません。

その他の特定の原因については、第27.1.12.3.4項「ディスカッション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

フォーラムのリスト

ディスカッション・サーバーから、特定のカテゴリ内のフォーラムのリストを取得します。

ディスカッション・フォーラムの表示に関する問題がある場合は、次の原因が考えられます。

- ユーザーにカテゴリのフォーラムを表示する権限がありません。

- フォーラムをフェッチするカテゴリが削除されました。

その他の特定の原因については、第27.1.12.3.4項「ディスカッション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

トピックのリスト

ディスカッション・サーバーから、特定のフォーラム内のトピックのリストを取得します。

トピックの表示に関する問題がある場合は、次の原因が考えられます。

- ユーザーにフォーラムのトピックを表示する権限がありません。

- トピックをフェッチするフォーラムが削除されました。

その他の特定の原因については、第27.1.12.3.4項「ディスカッション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

検索

ディスカッション・サーバーでディスカッション・フォーラム内の文字列を検索します。

フォーラムの検索に関する問題がある場合は、次の原因が考えられます。

- 指定の検索語を含むトピック/メッセージが存在しません。

- 検索語オブジェクトが存在するカテゴリまたはフォーラムが削除されました。

その他の特定の原因については、第27.1.12.3.4項「ディスカッション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

27.1.12.2.5 イベントのメトリック

イベントに関連するパフォーマンス・メトリックについては、表27-25および第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

図27-23 イベントのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表27-25 イベント: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

イベントの作成

WebCenter Portalのリポジトリでポータル・イベントまたは個人カレンダ・イベントを作成します。

特定の原因については、第27.1.12.3.6項「イベント: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

イベントの更新

WebCenter Portalのリポジトリに格納されているポータル・イベントまたは個人カレンダ・イベントを更新します。

特定の原因については、第27.1.12.3.6項「イベント: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

イベントの削除

WebCenter Portalのリポジトリからポータル・イベントまたは個人カレンダ・イベントを削除します。

特定の原因については、第27.1.12.3.6項「イベント: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

イベントのリスト

WebCenter Portalのリポジトリからイベントのリストを取得します。

特定の原因については、第27.1.12.3.6項「イベント: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

イベントの検索

イベント・テキスト内の文字列を検索します。

特定の原因については、第27.1.12.3.6項「イベント: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

27.1.12.2.6 外部アプリケーションのメトリック

外部アプリケーションに関連するパフォーマンス・メトリックについては、表27-26および第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

図27-24 外部アプリケーションのメトリック

図27-25 外部アプリケーションのメトリック: 操作別

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表27-26 外部アプリケーション: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

資格証明のフェッチ

外部アプリケーションの資格証明を取得します。

特定の原因については、第27.1.12.3.5項「外部アプリケーション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

資格証明の格納

外部アプリケーションのユーザー資格証明を格納します。

特定の原因については、第27.1.12.3.5項「外部アプリケーション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

外部アプリケーションのフェッチ

外部アプリケーションを取得します。

特定の原因については、第27.1.12.3.5項「外部アプリケーション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

自動ログイン

WebCenter Portalユーザーが(自動ログイン機能を使用して)外部アプリケーションにログインします。

特定の原因については、第27.1.12.3.5項「外部アプリケーション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

27.1.12.2.7 インスタント・メッセージおよびプレゼンスのメトリック

インスタント・メッセージおよびプレゼンスに関連するパフォーマンス・メトリック(図27-26)については、表27-27および第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

図27-26 インスタント・メッセージおよびプレゼンスのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表27-27 インスタント・メッセージおよびプレゼンス: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

プレゼンスの取得

インスタント・メッセージおよびプレゼンス・サーバーからユーザー・プレゼンス情報を取得します。

特定の原因については、第27.1.12.3.7項「インスタント・メッセージおよびプレゼンス: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

ログイン

(インスタント・メッセージおよびプレゼンスにアクセスしている)WebCenter Portalユーザーがインスタント・メッセージおよびプレゼンス・サーバーにログインします。

特定の原因については、第27.1.12.3.7項「インスタント・メッセージおよびプレゼンス: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

ログアウト

(インスタント・メッセージおよびプレゼンスにアクセスしている)WebCenter Portalユーザーがインスタント・メッセージおよびプレゼンス・サーバーからログアウトします。

特定の原因については、第27.1.12.3.7項「インスタント・メッセージおよびプレゼンス: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

27.1.12.2.8 インポートおよびエクスポートのメトリック

インポートおよびエクスポートに関連するパフォーマンス・メトリック(図27-27)については、表27-28および第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。 これらのメトリックは、WebCenter Portalにのみ適用されます。

図27-27 インポート/エクスポートのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表27-28 インポート/エクスポート: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

エクスポート

WebCenter Portalアプリケーション全体をエクスポートします。

特定の原因については、第27.1.12.3.8項「インポートおよびエクスポート: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

インポート

WebCenter Portalアプリケーション全体をインポートします。

特定の原因については、第27.1.12.3.8項「インポートおよびエクスポート: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

27.1.12.2.9 リストのメトリック

(WebCenter Portalのみ)リストに関連するパフォーマンス・メトリック(図27-28)については、表27-29および第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

図27-28 リストのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表27-29 リスト: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

リストの作成

ユーザー・セッション内でリストを作成します。

「データの保存」操作を実行すると、新しいリストがMDSリポジトリに対してコミットされます。

特定の原因については、第27.1.12.3.9項「リスト: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

リストのコピー

ユーザー・セッション内でリストおよびそのデータをコピーします。

「データの保存」操作を実行すると、コピーしたリストおよびリスト・データがMDSリポジトリとWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

特定の原因については、第27.1.12.3.9項「リスト: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

リストの削除

ユーザー・セッション内でリストおよびそのデータを削除します。

「データの保存」操作を実行すると、リストの変更がMDSリポジトリとWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

特定の原因については、第27.1.12.3.9項「リスト: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

行の作成

ユーザー・セッション内でリスト・データの行を作成します。

「データの保存」操作を実行すると、リスト・データの変更がWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

特定の原因については、第27.1.12.3.9項「リスト: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

行の更新

ユーザー・セッション内でリスト・データの行を更新します。

「データの保存」操作を実行すると、リスト・データの変更がWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

特定の原因については、第27.1.12.3.9項「リスト: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

行の削除

ユーザー・セッション内でリスト・データの行を削除します。

「データの保存」操作を実行すると、リスト・データの変更がWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

特定の原因については、第27.1.12.3.9項「リスト: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

検索

メタデータ・リポジトリからIDによりリストを取得します。

特定の原因については、第27.1.12.3.9項「リスト: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

データの保存

(ユーザー・セッション内の)リストおよびリスト・データのすべての変更をメタデータ・サービス・リポジトリとWebCenter Portalのリポジトリ(リスト情報の格納先のデータベース)に保存します。

特定の原因については、第27.1.12.3.9項「リスト: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

27.1.12.2.10 メールのメトリック

メールに関連するパフォーマンス・メトリック(図27-29)については、表27-30および第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

図27-29 メールのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表27-30 メール: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

ログイン

WebCenter Portalユーザーが、メール・サービスをホストしているメール・サーバーにログインします。

特定の原因については、第27.1.12.3.10項「メール: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

ログアウト

WebCenter Portalユーザーが、メール・サービスをホストしているメール・サーバーからログアウトします。

特定の原因については、第27.1.12.3.10項「メール: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

受信

メールを受信します。

特定の原因については、第27.1.12.3.10項「メール: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

送信

メールを送信します。

特定の原因については、第27.1.12.3.10項「メール: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

検索

特定の文字列を含むメールを検索します。

特定の原因については、第27.1.12.3.10項「メール: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

27.1.12.2.11 ノートのメトリック

ノートに関連するパフォーマンス・メトリック(図27-30)については、表27-31および第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

図27-30 ノートのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表27-31 ノート: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

作成

個人用ノートを作成します。

「変更の保存」操作を実行すると、新しいノートがMDSリポジトリに対してコミットされます。

特定の原因については、第27.1.12.3.11項「ノート: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

更新

個人用ノートを更新します。

「変更の保存」操作を実行すると、ノートの更新がMDSリポジトリに対してコミットされます。

特定の原因については、第27.1.12.3.11項「ノート: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

検索

MDSリポジトリからノートを取得します。

特定の原因については、第27.1.12.3.11項「ノート: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

削除

MDSリポジトリからノートを削除します。

特定の原因については、第27.1.12.3.11項「ノート: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

27.1.12.2.12 ページ操作のメトリック

ページ操作に関連するパフォーマンス・メトリック(図27-31)については、表27-32および第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

注意:
この項で説明するページ操作のメトリックは、第27.1.5項「ページ・リクエスト・メトリックの理解」で説明されているページ・リクエスト・メトリックとは異なります。ページ操作のメトリックでは、ページの作成など、ページ関連の操作がモニターされます。これに対して、ページ・リクエスト・メトリックでは、個々のページ・ビュー/表示リクエストがモニターされます(ページ編集操作は含まれません)。

図27-31 ページ操作のメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表27-32 ページ・サービス: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

作成

WebCenter PortalまたはPortal Frameworkアプリケーション内にページを作成します。

特定の原因については、第27.1.12.3.12項「ページ・サービス: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

コピー

ページをコピーします。

特定の原因については、第27.1.12.3.12項「ページ・サービス: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

削除

ページを削除します。

特定の原因については、第27.1.12.3.12項「ページ・サービス: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

検索

特定の文字列を含むページを検索します。

特定の原因については、第27.1.12.3.12項「ページ・サービス: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

27.1.12.2.13 ピープル・コネクションのメトリック

ピープル・コネクションに関連するパフォーマンス・メトリックについては、表27-33および第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

図27-32 ピープル・コネクションのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表27-33 ピープル・コネクション: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

プロファイルの取得

ユーザーのプロファイルを取得します。

特定の原因については、第27.1.12.3.14項「ピープル・コネクション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

アクティビティの取得

ユーザーのフィルタ・オプションに基づいてアクティビティを取得します。

特定の原因については、第27.1.12.3.14項「ピープル・コネクション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

アクティビティの公開

ユーザー・セッションのアクティビティを公開し、それをWebCenter PortalまたはPortal Frameworkアプリケーションに保存します。

特定の原因については、第27.1.12.3.14項「ピープル・コネクション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

メッセージの取得

ユーザーのメッセージを取得します。

特定の原因については、第27.1.12.3.14項「ピープル・コネクション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

フィードバックの取得

ユーザーのフィードバックを取得します。

特定の原因については、第27.1.12.3.14項「ピープル・コネクション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

コネクションの取得

ユーザーの接続を取得します。

特定の原因については、第27.1.12.3.14項「ピープル・コネクション: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

27.1.12.2.14 投票のメトリック

投票に関連するパフォーマンス・メトリック(図27-33)については、表27-34および第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

図27-33 投票のメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表27-34 投票: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

投票の作成

WebCenter PortalまたはPortal Frameworkアプリケーション内に投票を作成します。

特定の原因については、第27.1.12.3.15項「投票: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

投票の編集

WebCenter PortalまたはPortal Frameworkアプリケーション内の投票を編集します。

特定の原因については、第27.1.12.3.15項「投票: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

投票の削除

進行中の投票を削除します。

特定の原因については、第27.1.12.3.15項「投票: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

ID別投票の取得

進行中の投票を表示します。

特定の原因については、第27.1.12.3.15項「投票: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

投票の送信

進行中の投票を送信します。

特定の原因については、第27.1.12.3.15項「投票: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

結果の分析

投票の結果を分析します。

特定の原因については、第27.1.12.3.15項「投票: 問題およびアクション」を参照してください。

一般的な原因については、第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

27.1.12.2.15 RSSニュース・フィードのメトリック

RSSニュース・フィードに関連するパフォーマンス・メトリック(図27-34)については、第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

図27-34 RSSニュース・フィードのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

27.1.12.2.16 最近のアクティビティのメトリック

最近のアクティビティに関連するパフォーマンス・メトリック(図27-35)については、第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

図27-35 最近のアクティビティのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

27.1.12.2.17 検索のメトリック

検索に関連するパフォーマンス・メトリック(図27-36)については、表27-35および第27.1.12.1項「すべてのツールとサービスに共通するメトリック」で説明しています。

図27-36 検索のメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表27-35 検索: 検索ソース

操作

説明

お知らせ

お知らせのテキストが検索されます。

ドキュメント

ファイルおよびフォルダ内のコンテンツが検索されます。

ディスカッション・フォーラム

フォーラムおよびトピックが検索されます。

WebCenter Portal

リンク、リスト、ノート、タグ、イベントなど、ポータルに保存されたコンテンツが検索されます。

スペース・イベント

ポータル・イベント(以前はスペース・イベントと呼ばれていました)が検索されます。

リンク

リンクが作成された対象のオブジェクトが検索されます(たとえば、お知らせ、ディスカッション・フォーラムのトピック、ドキュメント、イベントなど)。

リスト

リストで保存された情報が検索されます。

ノート

アラームなどのノート・テキストが検索されます。

Oracle Secure Enterprise Search

ドキュメント・ライブラリ・タスク・フロー、ディスカッション、タグ・クラウド、ノート、その他のツールおよびサービスのコンテンツが検索されます。

ページ

アプリケーション・ページ、個人ページ、パブリック・ページ、wikiページおよびブログ・ページに追加されたコンテンツが検索されます。

27.1.12.3 ツールとサービスに関する一般的な問題のトラブルシューティング

この項では、個々のツールおよびサービスで発生する可能性がある問題と、それらの問題に対処するためのアクションについて説明します。

関連項目:
第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」

この項には次のトピックが含まれます:

- 第27.1.12.3.1項「お知らせ: 問題およびアクション」

- 第27.1.12.3.2項「BPELワークリスト: 問題およびアクション」

- 第27.1.12.3.3項「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」

- 第27.1.12.3.4項「ディスカッション: 問題およびアクション」

- 第27.1.12.3.5項「外部アプリケーション: 問題およびアクション」

- 第27.1.12.3.6項「イベント: 問題およびアクション」

- 第27.1.12.3.7項「インスタント・メッセージおよびプレゼンス: 問題およびアクション」

- 第27.1.12.3.8項「インポートおよびエクスポート: 問題およびアクション」

- 第27.1.12.3.9項「リスト: 問題およびアクション」

- 第27.1.12.3.10項「メール: 問題およびアクション」

- 第27.1.12.3.11項「ノート: 問題およびアクション」

- 第27.1.12.3.12項「ページ・サービス: 問題およびアクション」

- 第27.1.12.3.13項「ポートレットおよびプロデューサ: 問題およびアクション」

- 第27.1.12.3.14項「ピープル・コネクション: 問題およびアクション」

- 第27.1.12.3.15項「投票: 問題およびアクション」

- 第27.1.12.3.16項「RSSニュース・フィード: 問題およびアクション」

- 第27.1.12.3.17項「最近のアクティビティ: 問題およびアクション」

- 第27.1.12.3.18項「検索: 問題およびアクション」

27.1.12.3.1 お知らせ: 問題およびアクション

お知らせに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- ディスカッション・サーバーが停止しているか、応答していません。

- アプリケーションとディスカッション・サーバーの間にネットワーク接続の問題があります。

- お知らせに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

27.1.12.3.2 BPELワークリスト: 問題およびアクション

ワークリストに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- 問合せ対象のBPELサーバーが使用可能ではありません。

- アプリケーションとBPELサーバーの間にネットワーク接続の問題があります。

- ワークリストに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

27.1.12.3.3 コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション

ドキュメント・サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。また、次のいずれかを実行します。

- Content Server (Oracle WebCenter Content)およびOracle Portalの場合は、バックエンド・サーバーが稼働していることを確認します。

- Content Serverの場合は、サービスが適切に機能していないクライアントのソケット接続が開いていることを確認します。Intradocサーバー・ポート経由でContent Serverとの通信を許可されたIPアドレスのリストを確認します(IPアドレス・フィルタ)。詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentの管理』のFusion Middleware Controlを使用したインターネット構成の変更に関する項を参照してください。

- Oracle Portalの場合は、Oracle WebLogic管理コンソールを使用してJDBC接続のステータスを確認します。

- (機能チェック)バックエンド・サーバーのログをチェックします。Content Serverの場合、「Content Server」→「管理」→「ログ・ファイル」→「Content Serverログ」に移動します。Oracle Portalの場合、Fusion Middleware Controlを使用します。

- (機能チェック)モジュール名の先頭がoracle.vcr、oracle.webcenter.content、oracle.webcenter.doclibおよびoracle.stellentである診断ログ内のエントリを検索します。具体的には、WebCenter Portalがデプロイされる管理対象サーバーの診断ログは、次の場所にあります。

DOMAIN_HOME/servers/managed_server_name/logs/<managed_server>-diagnostic.logs

たとえば、WebCenter Portalの診断ログには、WC_Spaces-diagnostic.logという名前が付けられます。 第28.2項「ログ情報の表示および構成」を参照してください。

27.1.12.3.4 ディスカッション: 問題およびアクション

ディスカッションに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- ディスカッション・サーバーが停止しているか、応答していません。

- アプリケーションとディスカッション・サーバーの間にネットワーク接続の問題があります。

- ディスカッションに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

27.1.12.3.5 外部アプリケーション: 問題およびアクション

外部アプリケーション・サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- アプリケーションに対して資格証明ストアが構成されていません。

- 構成されている資格証明ストア(たとえばOracle Internet Directoryなど)が停止しているか、応答していません。

27.1.12.3.6 イベント: 問題およびアクション

イベント(ポータル・イベントまたは個人イベント)に関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- WebCenter Portalのリポジトリ(イベント情報が保存されるデータベース)が使用可能ではありません。

- アプリケーションとWebCenter Portalのリポジトリの間にネットワーク接続の問題があります。

- イベントに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

27.1.12.3.7 インスタント・メッセージおよびプレゼンス: 問題およびアクション

インスタント・メッセージおよびプレゼンスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- インスタント・メッセージおよびプレゼンス・サーバーが使用可能ではありません。

- アプリケーションと、インスタント・メッセージおよびプレゼンス・サーバーの間にネットワーク接続の問題があります。

- インスタント・メッセージおよびプレゼンス・サーバーに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

27.1.12.3.8 インポートおよびエクスポート: 問題およびアクション

インポートおよびエクスポートに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。

27.1.12.3.9 リスト: 問題およびアクション

リストに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- リストに関連付けられているデータが格納されているMDSリポジトリまたはWebCenter Portalのリポジトリが使用可能ではありません。

- アプリケーションとリポジトリの間にネットワーク接続の問題があります。

27.1.12.3.10 メール: 問題およびアクション

メールに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- メール・サーバーが使用可能ではありません。

- アプリケーションとメール・サーバーの間にネットワーク接続の問題があります。

- メール・サーバーに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

27.1.12.3.11 ノート: 問題およびアクション

ノートで問題が発生した場合は、MDSリポジトリ(ノート情報が保存されるリポジトリ)が使用不可ではないか、または応答が低速になっていないかをチェックします。

27.1.12.3.12 ページ・サービス: 問題およびアクション

ページ編集サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- WebCenter Portalのリポジトリ(ページ情報の格納先のデータベース)が使用できません。

- アプリケーションとWebCenter Portalのリポジトリの間にネットワーク接続の問題があります。

27.1.12.3.13 ポートレットおよびプロデューサ: 問題およびアクション

ポートレット・プロデューサに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- ポートレット・プロデューサ・サーバーが停止しているか、応答していません。

- ポートレット・プロデューサに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

- プロデューサ・リクエストがタイムアウトしました。

- 特定のプロデューサに関する問題またはそのプロデューサの特定のポートレットに起因するパフォーマンスの問題が存在します。

27.1.12.3.14 ピープル・コネクション: 問題およびアクション

ピープル・コネクションに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- サービスが停止しているか、応答していません。

- WebCenter Portalのリポジトリ(ピープル・コネクション情報の格納先のデータベース)が使用できません。

- アプリケーションとWebCenter Portalのリポジトリの間にネットワーク接続の問題があります。

27.1.12.3.15 投票: 問題およびアクション

投票に関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- サービスが停止しているか、応答していません。

- WebCenter Portalのリポジトリ(投票情報の格納先のデータベース)が使用できません。

- アプリケーションとWebCenter Portalのリポジトリの間にネットワーク接続の問題があります。

27.1.12.3.16 RSSニュース・フィード: 問題およびアクション

RSSニュース・フィードに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- RSSサービスが使用可能ではありません。

- アクティビティ・データを検索中のサービスが失敗しました。例:

- ディスカッション・データまたはお知らせデータを取得できない場合: ディスカッションおよびお知らせのパフォーマンスをチェックします。

- リスト・データを取得できない場合: リストのパフォーマンスをチェックします。

- 最近のアクティビティ・データを取得できない場合: 最近のアクティビティのパフォーマンスをチェックします。

27.1.12.3.17 最近のアクティビティ: 問題およびアクション

最近のアクティビティに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- 最近のアクティビティ・サービスが使用可能ではありません。

- 最近のアクティビティを検索中のサービスが失敗しました。

27.1.12.3.18 検索: 問題およびアクション

検索(サービス実行元)に関する問題が発生した場合で、ステータスが「停止中」であるときは、この実行元が使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- 実行元のリポジトリが使用可能ではありません。

- アプリケーションと実行元のリポジトリの間にネットワーク接続の問題があります。

- 実行元に関連付けられた接続構成情報が間違っているか、有効でなくなりました。

- 検索中のコンテンツ・リポジトリが現在使用できません。

27.2 Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示

Fusion Middleware Controlでは、WebCenter PortalまたはPortal Frameworkアプリケーションの様々なパフォーマンス・メトリックをモニターできます。

この項には次のトピックが含まれます:

- 第27.2.1項「WebCenter Portalのモニタリング」

- 第27.2.2項「Portal Frameworkアプリケーションのモニタリング」

27.2.1 WebCenter Portalのモニタリング

管理者は、WebCenter Portal全体およびそれを構成するすべてのコンポーネントとサービスのパフォーマンスおよび可用性をモニターできます。これらの詳細なメトリックは、パフォーマンス問題の診断に役立ちます。また、定期的にモニターすれば、開発段階で傾向を把握し、将来のパフォーマンス問題を回避することができます。

WebCenter Portalのホームページには、いくつかの主要なパフォーマンス・メトリックが表示されます(図27-37)。

図27-37 WebCenter Portalのホームページ

ページ上部のチャートにより、WebCenter Portalアプリケーションが予期したとおりに稼働しているか、実行速度が遅いかが一目でわかります。より詳細なメトリックにドリルダウンして問題領域のトラブルシューティングを行い、適切な処理を行うことができます。着目する項目の詳細は、第27.1.3項「主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断」を参照してください。

この項では、WebCenter Portalメトリック・ページの移動方法について説明します。この項の内容は次のとおりです。

- 第27.2.1.1項「WebCenter Portalの最近のパフォーマンス・メトリックのモニタリング」

- 第27.2.1.2項「全ポータル・メトリックのモニタリング」

- 第27.2.1.4項「WebCenter Portalの全サービス・メトリックおよびポートレット・プロデューサ・メトリックのモニタリング」

- 第27.2.1.3項「WebCenter Portalの全ページ・メトリックのモニタリング」

- 第27.2.1.5項「メトリック・パレットを通じたすべてのメトリックのモニタリング」

27.2.1.1 WebCenter Portalの最近のパフォーマンス・メトリックのモニタリング

WebCenter Portalまたは特定のポータルが現在適切に稼働していることを確認する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、WebCenter Portalのホームページに移動します。
第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. ホームページで、WebCenter Portalが予期したとおりに稼働しているかどうかを確認します。
着目する項目の詳細は、第27.1.3項「主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断」を参照してください。

3. 「ページ・パフォーマンス」、「ポートレット可用性」、「ヘルス」など、ホームページ上のリンクをクリックして、より詳細なメトリックにドリルダウンします。
または、次のメニュー・オプションを使用して詳細な最近のメトリックにアクセスします。

- 「WebCenterポータル」→「モニタリング」→「最近のページ・メトリック」

- 「WebCenterポータル」→「モニタリング」→「最近のドキュメント・メトリック」

- 「WebCenterポータル」→「モニタリング」→「最近のポートレット・メトリック」

- 「WebCenterポータル」→「モニタリング」→「最近のWebLogic Serverメトリック」

これらのページのメトリックの詳細は、「ページ・リクエスト・メトリックの理解」、「ドキュメント・メトリックの理解」、「ポートレット・プロデューサのメトリックの理解」および「WebLogic Serverメトリックの理解」を参照してください。

27.2.1.2 全ポータル・メトリックのモニタリング

WebCenter Portal内で作成されたポータルのパフォーマンス・メトリックを参照する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、WebCenter Portalのホームページに移動します。
第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「モニタリング」→「全ポータル・メトリック」を選択します。
表示されるメトリックの詳細は、「ポータル・メトリックの理解」を参照してください。第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

3. 特定のポータルの詳細なページ・メトリックにドリルダウンするか、特定のポータルのセットを比較します。

- 特定のポータル(以前はスペースと呼ばれていました)の詳細なパフォーマンス情報を表示する手順は次のとおりです。
「ポータル名フィルタ」フィールドで、ポータルの名前を入力し、[Enter]キーを押します。ポータル・フィルタリング・オプションの詳細は、第27.1.11項「ポータル・メトリックの理解」を参照してください。

または

「名前」列で、パフォーマンス・メトリックを表示するポータルの名前(リンク)をクリックします。

どちらの場合も、選択したポータルのページ・メトリックが表示されます。

- 1つ以上のポータルのパフォーマンスを比較するには、表の1つ以上の行を選択し、「チャートで表示」をクリックします。

27.2.1.3 WebCenter Portalの全ページ・メトリックのモニタリング

ページ・メトリックを参照する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、WebCenter Portalのホームページに移動します。
第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. ホームページのページ可用性/パフォーマンスのチャートで、ページ・リクエストが予期したとおりに現在応答しているかどうかを確認します。
より詳細な情報にドリルダウンするには、「ページ可用性」、「ページ・パフォーマンス」をクリックするか、「モニタリング」→「最近のページ・メトリック」を選択します。表示されるメトリックの詳細は、第27.1.5.2項「最近のページ・メトリック」を参照してください。

3. 起動時以降のページ・パフォーマンスをモニターするには、「モニタリング」→「全ページ・メトリック」を選択します。
特定のページ、すべてのページまたは特定のページ・セットのメトリックを表示できます。表示されるメトリックおよびページ・フィルタリング・オプションの詳細は、第27.1.5.3項「全ページ・メトリック」を参照してください。

4. ページ編集操作のパフォーマンスをモニターするには、「モニタリング」→「全サービス・メトリック」を選択し、表内の「ページ」をクリックします。
表示されるメトリックの詳細は、第27.1.12.2.12項「ページ操作のメトリック」を参照してください。

27.2.1.4 WebCenter Portalの全サービス・メトリックおよびポートレット・プロデューサ・メトリックのモニタリング

WebCenter Portalアプリケーションのサービスおよびポートレット・プロデューサのすべてのメトリックにアクセスするには:

1. Fusion Middleware Controlコンソールで、WebCenter Portalのホームページに移動します。
第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「モニタリング」→「全サービス・メトリック」を選択します。
「WebCenterポータル・サービス・メトリック」ページの一番上にある「サービス・サマリー」を使用すると、どのサービス、ポートレット・プロデューサおよびポートレットが稼働中かがすぐにわかり、WebCenter Portalにより使用されているこれらのサービスの個別的および相対的なパフォーマンスを確認できます。

メトリックは、ツール、サービス、アプリケーションまたはポートレットが初めてアクセスされたときに使用可能になります。構成されていないサービスまたはポートレットや、一度も使用されていないサービスまたはポートレットは、「サマリー」表に表示されません。

3. サービス、ポートレット・プロデューサまたはポートレットの名前をクリックして、より詳細なメトリックにドリルダウンします。
個々のメトリックの詳細は、第27.1.12.2項「特定のツールまたはサービス固有のメトリック」を参照してください。 第27.1.12.3項「ツールとサービスに関する一般的な問題のトラブルシューティング」も参照してください。

27.2.1.5 メトリック・パレットを通じたすべてのメトリックのモニタリング

WebCenter Portalに関して収集されたパフォーマンス・メトリックを参照し、チャート化する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、WebCenter Portalのホームページに移動します。
第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「モニタリング」→「パフォーマンス・サマリー」を選択します。
「パフォーマンス・サマリー」ページの上部にある「メトリック・パレットの表示」ボタンを使用して、「メトリック・パレット」を表示します。このパレットでは、個々のメトリックを選択およびモニターできます。

3. 「メトリック・パレット」で、「WebCenterポータル」の下のフォルダを開き、メトリックのチェック・ボックスを選択して、グラフ形式または表形式でメトリックをモニターします。
図27-38に、「パフォーマンス・サマリー」ページとメトリック・パレットを示します。「メトリック・パレット」には、WebCenter Portalのパフォーマンス・メトリックに加えて、任意のJ2EEアプリケーションに関連付けられている一般的なパフォーマンス・メトリック(ADFアプリケーション・モジュール・プールのメトリックなど)も表示されます。

メトリックのオンライン・ヘルプを表示するには、目的のディレクトリ、またはディレクトリ内のメトリックを右クリックし、「ヘルプ」を選択します。

図27-38 WebCenter Portal: パフォーマンス・サマリーおよびメトリック・パレット

27.2.2 Portal Frameworkアプリケーションのモニタリング

管理者は、JDeveloperを使用して構築するPortal Frameworkアプリケーション全体およびそれを構成するすべてのコンポーネントとサービスのパフォーマンスおよび可用性をモニターできます。これらの詳細なメトリックは、パフォーマンス問題の診断に役立ちます。また、定期的にモニターすれば、開発段階で傾向を把握し、将来のパフォーマンス問題を回避することができます。

この項には次のトピックが含まれます:

- 第27.2.2.1項「Portal Frameworkアプリケーションの最近のパフォーマンス・メトリックのモニタリング」

- 第27.2.2.2項「Portal Frameworkアプリケーションの全サービス・メトリックおよびポートレット・プロデューサ・メトリックのモニタリング」

- 第27.2.2.3項「Portal Frameworkアプリケーションの全ページ・メトリックのモニタリング」

- 第27.2.2.4項「メトリック・パレットを通じたすべてのメトリックのモニタリング」

27.2.2.1 Portal Frameworkアプリケーションの最近のパフォーマンス・メトリックのモニタリング

Portal Frameworkアプリケーションが現在適切に稼働していることを確認する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Portal Frameworkアプリケーションのホームページに移動します。
第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「レスポンスと負荷」チャートで、最新のページ・パフォーマンスを調べて、アプリケーションを現在使用しているユーザー数がパフォーマンスに影響を及ぼしているかどうかを確認します。第27.1.10項「ページ・レスポンス・メトリックおよびロード・メトリックの理解」を参照してください。

3. 次のメニュー・オプションを使用して、より詳細なメトリックにドリルダウンします。

- 「アプリケーションのデプロイ」→「WebCenterポータル」→「最近のページ・メトリック」

- 「アプリケーションのデプロイ」→「WebCenterポータル」→「最近のドキュメント・メトリック」

- 「アプリケーションのデプロイ」→「WebCenterポータル」→「最近のポートレット・メトリック」

- 「アプリケーションのデプロイ」→「WebCenterポータル」→「最近のWebLogic Serverメトリック」

着目する項目の詳細は、第27.1.3項「主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断」を参照してください。

これらのページのメトリックの詳細は、「ページ・リクエスト・メトリックの理解」、「ドキュメント・メトリックの理解」、「ポートレット・プロデューサのメトリックの理解」および「WebLogic Serverメトリックの理解」を参照してください。

27.2.2.2 Portal Frameworkアプリケーションの全サービス・メトリックおよびポートレット・プロデューサ・メトリックのモニタリング

Portal Frameworkアプリケーションで使用されるサービスのパフォーマンス・メトリックを参照する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Portal Frameworkアプリケーションのホームページに移動します。
第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「全サービス・メトリック」を選択します。
「WebCenterサービス・メトリック」ページの一番上にある「サービス・サマリー」を使用すると、どのサービス、ポートレット・プロデューサおよびポートレットが稼働中かがすぐにわかり、Portal Frameworkアプリケーションにより使用されているすべてのサービスの個別的および相対的なパフォーマンスを確認できます。

統計は、サービス、アプリケーションまたはポートレットが初めてアクセスされたときに使用可能になります。構成されていないサービスまたはポートレットや、一度も使用されていないサービスまたはポートレットは、「サービス・サマリー」表に表示されません。

3. サービス、ポートレット・プロデューサまたはポートレットの名前をクリックして、より詳細なメトリックにドリルダウンします。
個々のメトリックの詳細は、第27.1.12.2項「特定のツールまたはサービス固有のメトリック」を参照してください。 第27.1.12.3項「ツールとサービスに関する一般的な問題のトラブルシューティング」も参照してください。

27.2.2.3 Portal Frameworkアプリケーションの全ページ・メトリックのモニタリング

Portal Frameworkアプリケーションに表示されるページのパフォーマンス・メトリックを参照する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Portal Frameworkアプリケーションのホームページに移動します。
第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

2. ページ・リクエストが予期したとおりに現在応答しているかどうかを確認するには、「アプリケーションのデプロイ」→「WebCenterポータル」→「最近のページ・メトリック」を選択します。
最近のページ可用性およびページ・パフォーマンスのチャートを確認します。表示されるメトリックの詳細は、第27.1.5.2項「最近のページ・メトリック」を参照してください。

3. 起動時以降のページ・パフォーマンスをモニターするには、「アプリケーションのデプロイ」→「WebCenterポータル」→「全ページ・メトリック」を選択します。
特定のページ、すべてのページまたは特定のページ・セットのメトリックを表示できます。表示されるメトリックおよびページ・フィルタリング・オプションの詳細は、第27.1.5.3項「全ページ・メトリック」を参照してください。

4. ページ編集操作のパフォーマンスをモニターするには、「アプリケーションのデプロイ」→「WebCenterポータル」→「全サービス・メトリック」を選択し、表内の「ページ」をクリックします。
表示されるメトリックの詳細は、第27.1.12.2.12項「ページ操作のメトリック」を参照してください。

27.2.2.4 メトリック・パレットを通じたすべてのメトリックのモニタリング

Portal Frameworkアプリケーションに関して収集されたパフォーマンス・メトリックを参照し、チャート化する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Portal Frameworkアプリケーションのホームページに移動します。
第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「アプリケーションのデプロイ」メニューから、「パフォーマンス・サマリー」を選択します。
「パフォーマンス・サマリー」ページの上部にある「メトリック・パレットの表示」ボタンを使用して、「メトリック・パレット」を表示します。このパレットでは、個々のメトリックを選択およびモニターできます。

3. 「メトリック・パレット」で、「WebCenterポータル」の下のフォルダを開き、メトリックのチェック・ボックスを選択して、グラフ形式または表形式でメトリックをモニターします。
図27-39に、「パフォーマンス・サマリー」ページとメトリック・パレットを示します。「メトリック・パレット」には、WebCenter Portalのパフォーマンス・メトリックに加えて、任意のJ2EEアプリケーションに関連付けられている一般的なパフォーマンス・メトリック(ADFアプリケーション・モジュール・プールのメトリックなど)も表示されます。

メトリックのオンライン・ヘルプを表示するには、目的のディレクトリ、またはディレクトリ内のメトリックを右クリックし、「ヘルプ」を選択します。

図27-39 Portal Frameworkアプリケーション: パフォーマンス・サマリーおよびメトリック・パレット

27.3 主要なパフォーマンス・メトリックのしきい値および収集のカスタマイズ

この項には次のトピックが含まれます:

- 第27.3.1項「主要なパフォーマンス・メトリックのカスタマイズ・オプションの理解」

- 第27.3.2項「デフォルトのメトリック収集およびしきい値設定の理解」

- 第27.3.3項「主要なメトリックのしきい値の構成」

- 第27.3.4項「ドキュメント・アップロード/ダウンロード・メトリックのしきい値の構成」

- 第27.3.5項「WebLogic Serverヘルス・チェックの頻度の構成」

- 第27.3.6項「主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成」

- 第27.3.7項「WebCenter PortalおよびPortal Frameworkアプリケーションのしきい値および収集オプションの編集(metric_properties.xml)」

27.3.1 主要なパフォーマンス・メトリックのカスタマイズ・オプションの理解

Oracle WebCenter Portalが主要なパフォーマンス・メトリックを収集およびレポートする方法は、各自のインストールに合うように、様々な方法で微調整できます。

- 主要なパフォーマンス・メトリックの警告しきい値のカスタマイズ
たとえば、インストール内で、ページ・レスポンス時間が15秒を超える場合は警告メッセージをトリガーし、DMSで範囲外の状態をレポートすることを指定できます。範囲外の状態はパフォーマンス・チャート内でも赤色で表示され、問題があることが通知されます。

詳細は、次を参照してください。

- 第27.3.3項「主要なメトリックのしきい値の構成」

- 第27.3.4項「ドキュメント・アップロード/ダウンロード・メトリックのしきい値の構成」

- 主要なパフォーマンス・メトリック用に収集するサンプル数のカスタマイズ
デフォルトのサンプル・サイズ(100)が自分のインストールにとって多すぎたり少なすぎたりする場合は、より適切な値を構成できます。

詳細は、第27.3.6項「主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成」を参照してください。

- ヘルス・チェックの頻度のカスタマイズ
より積極的なスケジュールがインストールで要求される場合は、システム・ヘルスをより頻繁にチェックできます。デフォルトのヘルス・チェック頻度は5分です。

詳細は、第27.3.5項「WebLogic Serverヘルス・チェックの頻度の構成」を参照してください。

第27.3.7項「WebCenter PortalおよびPortal Frameworkアプリケーションのしきい値および収集オプションの編集(metric_properties.xml)」も参照してください。

27.3.2 デフォルトのメトリック収集およびしきい値設定の理解

WebCenter PortalまたはPortal Frameworkアプリケーションのメトリック収集オプションおよびメトリックしきい値設定は、metric_properties.xmlファイルで構成できます。デフォルト設定は、例27-1の中で太字で示されています。

注意:
すべての時間しきい値は、ミリ秒単位で指定されます。メモリー・サイズはバイト単位で指定され、CPU使用率はパーセンテージで指定されます。

例27-1 デフォルトのメトリック収集およびしきい値設定(metric_properties.xml)

<registry>
<global_setting>
<thread_config>
<thread component_type="oracle_webcenter" interval="5"/>
</thread_config>
<health_check_config>
<health_check name="wlsHealthCheck" enabled="true" collect="1"/>
</health_check_config>
<metric_config>
<metric name="pageResponseTime" type="time" threshold="10000" comparator="gt"/>
<metric name="portletResponseTime" type="time" threshold="10000" comparator="gt"/>
<metric name="wlsCpuUsage" type="number" threshold="80" comparator="gt"/>
<metric name="wlsGcTime" type="number" threshold="undef" comparator="gt"/>
<metric name="wlsGcInvPerMin" type="number" threshold="undef" comparator="gt"/>
<metric name="wlsActiveSessions" type="number" threshold="undef" comparator="gt"/>
<metric name="wlsExecuteIdleThreadCount" type="number" threshold="undef" comparator="gt"/>
<metric name="wlsActiveExecuteThreads" type="number" threshold="undef" comparator="gt"/>
<metric name="wlsHoggingThreadCount" type="number" threshold="0" comparator="gt"/>
<metric name="wlsOpenJdbcConn" type="number" threshold="undef" comparator="gt"/>
<metric name="wlsHeapSizeCurrent" type="number" threshold="undef" comparator="gt"/>
/metric_config>
<custom_param_config>
<custom_param name="downloadTimeThreshold" value="500"/>
<custom_param name="downloadThroughputThreshold" value="1024"/>
<custom_param name="uploadTimeThreshold" value="3000"/>
<custom_param name="uploadThroughputThreshold" value="180"/>
</custom_param_config>
/global_setting>
</registry>

このファイル内のすべての設定の詳細は、次の表を参照してください。

- 表27-37「主要なパフォーマンス・メトリックのしきい値の構成」

- 表27-39「ドキュメント・アップロード/ダウンロードのしきい値の構成」

- 表27-40「ヘルス・チェックの頻度の構成」

デフォルト設定の変更方法については、第27.3項「主要なパフォーマンス・メトリックのしきい値および収集のカスタマイズ」を参照してください。

27.3.3 主要なメトリックのしきい値の構成

いくつかの主要なパフォーマンス・メトリックのデフォルトの警告しきい値は、各自のOracle WebCenter Portalインストールに合うようにカスタマイズできます。表27-36「構成可能なメトリックしきい値」は、構成できる主要なパフォーマンス・メトリックとそのデフォルトのしきい値(ある場合)を示しています。

初期状態では、しきい値は、ページ・レスポンス(10秒を超える)、ポートレット・レスポンス(10秒を超える)およびCPU使用率(80%を超える)についてのみ事前に構成されています。

注意:
値undefは、しきい値が定義されていないことを意味します。

表27-36にリストされているメトリックはすべて、そのしきい値を変更できます。たとえば、デフォルトでは、表示にかかる時間が10秒を超えるページは警告メッセージをトリガーし、DMSで範囲外の状態をレポートし、パフォーマンス・チャートで赤色を表示して、ページ・レスポンスが非常に低速であることを即時に通知します。ポータル・アプリケーションによっては、許容できるレスポンス時間が5秒の場合もあります。この場合はしきい値を5,000 (ミリ秒)に変更して、実際に問題がある場合にパフォーマンス・チャートで赤色のみ表示するようにできます。

注意:
ドキュメント・アップロードおよびダウンロードのパフォーマンスのしきい値も設定できます。詳細は、第27.3.4項「ドキュメント・アップロード/ダウンロード・メトリックのしきい値の構成」を参照してください。

表27-36 構成可能なメトリックしきい値

メトリック名

説明

デフォルトのしきい値

comparator

pageResponseTime

ページのレンダリングにかかるミリ秒数。

10,000ミリ秒

gt

portletResponseTime

ポートレットのレンダリングにかかるミリ秒数。

10,000ミリ秒

gt

wlsCpuUsage

WebLogic ServerのJVMのCPU使用率。

80%

gt

wlsGcTime

ガベージ・コレクションの各実行でJVMが費やした時間の長さの平均(ミリ秒)。表示される平均は直前の5分間のものです。

undef

gt

wlsGcInvPerMin

JVMがガベージ・コレクション・ルーチンを呼び出している比率(/分)。表示される比率は直前の5分間のものです。

undef

gt

wlsActiveSessions

WebLogic Serverにおけるアクティブ・セッションの数。

undef

gt

wlsExecuteIdleThreadCount

WebLogic Serverにおけるアイドル中の実行スレッドの数。

undef

gt

wlsActiveExecuteThreads

WebLogic Serverにおけるアクティブな実行スレッドの数。

undef

gt

wlsHoggingThreadCount

WebLogic Serverにおける占有スレッドの数。

undef

gt

wlsOpenJdbcConn

WebLogic ServerにおけるオープンJDBC接続の数。

undef

gt

wlsHeapSizeCurrent

WebLogic ServerにおけるJVMの現在のヒープ・サイズ。

undef

gt

メトリックのしきい値は、metrics_properties.xml内で次の形式を使用して構成されます。

<metric_config>
<metric name="<metric_name>" type="<number/time/string>" threshold="<value>" comparator="gt/lt/eq>"/>
...
</metric_config>

表27-36で、各パラメータについて説明します。

表27-37 主要なパフォーマンス・メトリックのしきい値の構成

<metric>パラメータ

構成可能

説明

name

いいえ

メトリックの名前。

メトリック名は、表27-36にリストされているDMSセンサー名に正確に一致している必要があります。

type

はい

メトリックがnumber、timeまたはstringであることを指定します。

threshold

はい

(typeがnumberまたはtimeに設定されている場合のみ適用されます)。

数値のしきい値を指定します。指定する場合は、comparatorも指定する必要があります。

たとえば、ポートレットのレスポンス時間が5秒を超えると範囲外と見なされる場合は、次のように指定します。

metric name="portletResponseTime" type="time" threshold="5000" comparator="gt"

注意: 時間はミリ秒単位で指定する必要があります。

comparator

はい

gt、lt、eqのいずれかを指定します。ここで:

gt: 大きい

lt: 未満

eq: 等しい

1つ以上のメトリックのしきい値を編集するには、第27.3.7項「WebCenter PortalおよびPortal Frameworkアプリケーションのしきい値および収集オプションの編集(metric_properties.xml)」の手順に従います。

27.3.4 ドキュメント・アップロード/ダウンロード・メトリックのしきい値の構成

Oracle WebCenter Portalには、WebCenter PortalまたはPortal Frameworkアプリケーションにおけるドキュメントのアップロードおよびダウンロードのパフォーマンスに関する警告しきい値を構成できる、様々なメトリック・パラメータが用意されています(表27-38を参照)。

表27-38 構成可能なドキュメント・アップロード/ダウンロード・メトリックのしきい値

メトリック名

説明

デフォルト値

downloadTimeThreshold

ドキュメントの許容ダウンロード時間(ミリ秒)。

- ダウンロード時間がdownloadTimeThresholdで指定される時間以下のドキュメントは、許容と見なされます(パフォーマンス・チャートで常に緑色の表示)。

- その時間より長くかかるドキュメント・ダウンロードは、ダウンロード速度がdownloadThroughputThresholdより優れている場合のみ、許容(緑)と見なされます。
ダウンロード時間のしきい値を超え、スループットのしきい値を満たさないドキュメント・ダウンロードは、求められるパフォーマンス基準を下回っており、範囲外の状態を生成します(パフォーマンス・チャートで赤色の表示)。

デフォルトのダウンロード時間のしきい値は500ミリ秒(0.5秒)です。

500ミリ秒

downloadThroughputThreshold

ドキュメントの許容ダウンロード速度(KB/秒)。

このしきい値は、downloadTimeTresholdを超えるドキュメント・ダウンロードにのみ適用されます。

1024 KB/秒

uploadTimeThreshold

ドキュメントの許容アップロード時間(ミリ秒)。

デフォルトのアップロード時間しきい値は3000ミリ秒(3秒)で、これはデフォルトのダウンロード時間の6倍の長さです。

3000ミリ秒

uploadThroughputThreshold

ドキュメントの許容アップロード速度(KB/秒)。

このしきい値は、uploadTimeThresholdを超えるドキュメント・アップロードにのみ適用されます。

180 KB/秒

ユーザーが高速のアップロード/ダウンロード速度を要求する場合は、デフォルトの時間しきい値を短くするか、指定されているスループットしきい値を増やす必要がある可能性があります。ドキュメント・アップロードおよびダウンロードのしきい値は、metrics_properties.xmlの中で次の形式を使用して構成されます。

<custom_param_config>
<custom_param name="<document_threshold_name>" value="<value>"/>
...
</custom_param_config>

表27-39で、各パラメータについて説明します。

表27-39 ドキュメント・アップロード/ダウンロードのしきい値の構成

custom_paramパラメータ

構成可能

説明

document_threshold_name

いいえ

カスタマイズ可能なメトリック・パラメータの名前。

名前は、表27-38にリストされているDMSセンサー名に正確に一致している必要があります。

value

はい

カスタマイズ可能なメトリック・パラメータの値。

たとえば、ドキュメントのダウンロード時間しきい値を300ミリ秒に設定するには、次のように指定します。

<custom_param name="downloadTimeThreshold" value="300"/>

1つ以上のメトリックのしきい値を編集するには、第27.3.7項「WebCenter PortalおよびPortal Frameworkアプリケーションのしきい値および収集オプションの編集(metric_properties.xml)」の手順に従います。

27.3.5 WebLogic Serverヘルス・チェックの頻度の構成

初期状態では、WebCenter PortalまたはPortal FrameworkアプリケーションがデプロイされるWebLogic Serverの一般的なヘルスは5分ごとにチェックされ、その結果は「WebLogic Serverメトリックの理解」のページでレポートされます。

より積極的なスケジュールがインストールで要求される場合は、システム・ヘルスをより頻繁にチェックできます。

ヘルス・チェックの頻度は、metrics_properties.xml内で次の形式を使用して構成されます。

<thread_config>
<thread component_type="oracle_webcenter" interval="<value>"/>
</thread_config>

表27-40で、各パラメータについて説明します。

表27-40 ヘルス・チェックの頻度の構成

<thread>パラメータ

デフォルト値

構成可能

説明

component_type

oracle_webcenter

いいえ

Oracle WebCenter Portalの場合、component_typeは常にoracle_webcenterです。

interval

5分

はい

ヘルス・チェックの間隔(分単位)を指定します。

例:

<thread component_type="oracle_webcenter" interval="10"/>

頻度を変更するには、第27.3.7項「WebCenter PortalおよびPortal Frameworkアプリケーションのしきい値および収集オプションの編集(metric_properties.xml)」の手順に従います。

27.3.6 主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成

Oracle WebCenter Portalでは、一定の数のデータ・サンプルに基づいて、いくつかの主要なパフォーマンス・メトリック(ページ、ポートレット、ドキュメントおよびWebLogic Server)の最近のパフォーマンスが収集され、レポートされます。初期状態では、各メトリック・タイプの最新の100サンプルを使用して(100サンプルのページ・メトリック、100サンプルのポートレット・メトリックなど)、これらの主要なパフォーマンス・メトリックが計算されます。

サンプル・セットは、インストールに合わせて増減できます。主要なパフォーマンス・メトリックのすべてのサンプルはメモリーに保持されるため、サンプル数を増やす場合は、メモリーの消費が増えることを考慮する必要があります。最大でも数百のサンプルにとどめることをお薦めします。第27.1.1項「Oracle WebCenter Portalのメトリック収集の理解」を参照してください。

注意:
範囲外のすべてのメトリックは管理対象サーバーの診断ログに記録されるため、後でログをスキャンして、過去に起きたことをいつでも確認できます。つまり、メモリーに一時的に格納されるN回分のメトリック・サンプルを超える分を確認できます。

サーバーの起動プロパティWC_HEALTH_MAX_COLLECTIONSにより、Oracle WebCenter Portalによって収集されるメトリック・サンプルの数が決まります。プロパティが指定されない場合は、100サンプルが収集されます。

主要なパフォーマンス・メトリックに関して収集するサンプル数をカスタマイズする手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。

2. アプリケーションがデプロイされている管理対象サーバーに移動します。
WebCenter Portalの場合は、「環境」→「サーバー」→「WC_Spaces」に移動します。

Portal Frameworkアプリケーションの場合は、「環境」→「サーバー」→「<カスタム管理対象サーバーの名前>」(WC_CustomPortalなど)に移動します。

3. 「サーバーの起動」タブをクリックします。

4. 「引数」テキスト領域に、サーバーの起動引数WC_HEALTH_MAX_COLLECTIONSを入力し、収集するサンプル数を指定します。
例:

-DWC_HEALTH_MAX_COLLECTIONS=200

複数の引数は空白で区切ります。例:

-DWC_HEALTH_MAX_COLLECTIONS=200
-DWEBCENTER_METRIC_PROPERTIES=/scratch/mythresholds/metric_properties.xml

5. 管理対象サーバーを再起動します。

27.3.7 WebCenter PortalおよびPortal Frameworkアプリケーションのしきい値および収集オプションの編集(metric_properties.xml)

WebCenter PortalまたはPortal Frameworkアプリケーションのメトリックのしきい値および収集基準を変更するには:

1. 例27-1「デフォルトのメトリック収集およびしきい値設定(metric_properties.xml)」のXMLスニペットをコピーし、metric_properties.xmlという名前のテキスト・ファイルに保存します。

2. 必要に応じて、metric_properties.xml内のメトリック収集パラメータおよびメトリックしきい値を編集します。

注意:
Oracle WebCenter Portalインストールに適したしきい値を選択する際は、マシン・リソースと、システムのトポロジおよび構成を考慮する必要があります。インストールはそれぞれ異なるため、大部分のメトリックにはデフォルトまたは推奨されるしきい値設定はありません。

次の各表では、すべての設定およびそのデフォルト(ある場合)について説明します。

- 表27-37「主要なパフォーマンス・メトリックのしきい値の構成」

- 表27-40「ヘルス・チェックの頻度の構成」

- 表27-39「ドキュメント・アップロード/ダウンロードのしきい値の構成」

3. 更新したmetric_properties.xmlファイルを次の場所にコピーします。

- DOMAIN_HOME。

- 別の適切なディレクトリ。

4. プロパティ・ファイルのフル・パスを指すように、サーバーの起動引数WEBCENTER_METRIC_PROPERTIESを構成します。

1. WebLogic Server管理コンソールにログインします。

2. アプリケーションがデプロイされている管理対象サーバーに移動します。
WebCenter Portalの場合は、「環境」→「サーバー」→「WC_Spaces」に移動します。

Portal Frameworkアプリケーションの場合は、「環境」→「サーバー」→「<カスタム管理対象サーバーの名前>」(WC_CustomPortalなど)に移動します。

3. 「サーバーの起動」タブをクリックします。

4. 「引数」テキスト領域に、WEBCENTER_METRIC_PROPERTIES引数を入力し、プロパティ・ファイルのフル・パスを指定します。
例:

-DWEBCENTER_METRIC_PROPERTIES=/scratch/mythresholds/metric_properties.xml

注意:
ファイル名のみを指定すると、Oracle WebCenter PortalはDOMAIN_HOME内でこのファイルを検索します。
複数の引数は空白で区切ります。例:

-DWC_HEALTH_MAX_COLLECTIONS=200 -DWEBCENTER_METRIC_PROPERTIES=/scratch/mythresholds/metric_properties.xml

5. 管理対象サーバーを再起動します。

27.4 Oracle WebCenter Portalに関するパフォーマンス問題の診断および解決

この章で説明するパフォーマンス・メトリックを使用すると、WebCenter PortalまたはPortal Frameworkアプリケーションの現在のステータスとパフォーマンスを、Fusion Middleware Controlからすばやく評価できます。パフォーマンスが低速な場合は、問題を完全に診断および修正するために、さらに調査する必要がある可能性があります。詳細は、第27.1.3項「主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断」を参照してください。

この章では、一般的なパフォーマンスの問題およびアクションについて説明しています。

- 第27.1.4項「共通のパフォーマンスの問題およびアクションの理解」

- 第27.1.12.3項「ツールとサービスに関する一般的な問題のトラブルシューティング」

パフォーマンスに関連するトラブルシューティングの詳細は、付録G「Oracle WebCenter Portalのトラブルシューティング」を参照してください。

27.5 Oracle WebCenter Portalのパフォーマンスのチューニング

WebCenter PortalおよびPortal Frameworkアプリケーションのチューニングの詳細は、パフォーマンス・チューニング・ガイドのOracle WebCenter Portalのパフォーマンスのチューニングに関する項を参照してください。システム制限(open-files-limit)、JDBCデータ・ソース、JVM引数、セッション・タイムアウト、ページ・タイムアウト、接続タイムアウト、同時タイムアウト、キャッシュなどのチューニング方法を確認できます。

28 Oracle WebCenter Portalログの管理

この章では、WebCenter Portalの診断ロギングについて説明します。

この章には次のトピックが含まれます:

- 第28.1項「診断ロギングの概要」

- 第28.2項「ログ情報の表示および構成」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdmin、OperatorまたはMonitorロールが付与されている必要があります。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

28.1 診断ロギングの概要

起動と停止に関連するすべての診断情報、エラー、警告メッセージ、HTTPリクエストに関するアクセス情報、その他の情報がログ・ファイルに保存されます。

Fusion Middleware ControlとWLSTを使用したログの管理および分析の概要は、管理者ガイドの「ログ・ファイルと診断データの管理に」を参照してください。

管理者ガイドの診断フレームワークの理解に関する項も参照してください。

WebCenter Portal診断ログ

WebCenter Portalの診断ログ・ファイルはWC_Spaces-diagnostic.logです。

このログは、DOMAIN_HOME/servers/WC_Spaces/logsディレクトリで参照可能です。

Portal Frameworkアプリケーションの診断ログ

Portal Frameworkアプリケーションの診断ログ・ファイルは、DOMAIN_HOME/servers/ServerName/logsディレクトリで参照可能です。

ログ・ファイルは、ServerName-diagnostic.logの命名規則に従います。

たとえば、Portal FrameworkアプリケーションをWC_CustomPortalという名前の管理対象サーバーにデプロイした場合、診断ログ情報はDOMAIN_HOME/servers/WC_CustomPortal/logsディレクトリに格納され、ログ・ファイル名はWC_CustomPortal-diagnostic.logになります。

Oracle WebCenter PortalのメッセージID

Oracle WebCenter Portalのログ・メッセージは、次のカテゴリに分類されます。

表28-1 Oracle WebCenter Portalのメッセージ・カテゴリ

メッセージIDの範囲

メッセージ・カテゴリ

BI統合

WCS-01001からWCS-02000

ブログ

WCS-02001からWCS-03000

カレンダ・タスク

WCS-03001からWCS-04000

コラボレーション統合

WCS-04001からWCS-05000

ポータル・ビルダー

WCS-05001からWCS-06000

VCR

WCS-06001からWCS-07000

ドキュメント・ライブラリ

WCS-07001からWCS-08000

ディスカッション

WCS-08001からWCS-09000

メール

WCS-09001からWCS-10000

エクスプローラ・ツールバー

WCS-10001からWCS-11000

デスクトップ統合

WCS-11001からWCS-12000

ライフサイクル

WCS-12001からWCS-13000

リンク

WCS-13001からWCS-14000

リスト

WCS-14001からWCS-15000

ナビゲーション

WCS-15001からWCS-16000

ページ・エディタ

WCS-16001からWCS-17000

ページ・テンプレート

WCS-17001からWCS-18000

ピープル

WCS-18001からWCS-19000

個人用WebCenter

WCS-19001からWCS-20000

プロビジョニング済アプリケーション

WCS-20001からWCS-21000

評価/コメント

WCS-21001からWCS-22000

リージョン

WCS-22001からWCS-23000

リソース・カタログ

WCS-23001からWCS-24000

リッチ・テキスト・エディタ

WCS-24001からWCS-25000

ロール

WCS-25001からWCS-26000

検索

WCS-26001からWCS-27000

スキン

WCS-27001からWCS-28000

スマート・タグ

WCS-28001からWCS-29000

サブスクリプション

WCS-29001からWCS-30000

Wiki

WCS-30001からWCS-31000

WebCenter Portalエディタ

WCS-31001からWCS-32000

ワークリスト

WCS-32001からWCS-33000

最近のアクティビティ

WCS-33001からWCS-34000

コンテンツ・アダプタ

WCS-34001からWCS-35000

VCR ADF統合

WCS-35001からWCS-36000

ページ

WCS-36001からWCS-37000

ノート

WCS-37001からWCS-38000

RSS

WCS-38001からWCS-39000

ポートレット・バインディング

WCS-39001からWCS-40000

ポートレット・ランタイム

WCS-40001からWCS-41000

DesignTime@Runtime

WCS-41001からWCS-42000

外部アプリケーション

WCS-42001からWCS-43000

サービス・フレームワーク

WCS-43001からWCS-44000

セキュリティ・フレームワーク

WCS-44001からWCS-45000

ポートレット・デザインタイム

WCS-45001からWCS-46000

リソース・カタログ・ビューア

WCS-46001からWCS-47000

ピープル・コネクション

WCS-47001からWCS-48000

プリファレンス

WCS-48001からWCS-49000

REST

WCS-49001からWCS-50000

通知

WCS-50001からWCS-51000

Office統合

WCS-51001からWCS-52000

ブログ

WCS-52001からWCS-53000

アクティビティ・グラフ

WCS-53001からWCS-54000

VCR (WLPから)

WCS-54001からWCS-55000

WebCenter Content SPI

WCS-55001からWCS-56000

パーソナライズ(wcps-util)

WCS-56001からWCS-57000

パーソナライズ(wcps-cmis-provider)

WCS-57001からWCS-58000

デシジョン・コンポーネント統合(wcps-decision)

WCS-58001からWCS-59000

コンダクタ(wcps-conductor)

WCS-59001からWCS-60000

プロパティ・プロバイダ

WCS-60001からWCS-61000

RESTクライアント

WCS-61001からWCS-62000

翻訳

WCS-62001からWCS-63000

分析

WCS-63001からWCS-64000

JAX-RSフレームワーク

WCS-64001からWCS-65000

データ・プレゼンタ

WCS-65001からWCS-66000

ナレッジ・ディレクトリ

WCS-66001からWCS-67000

同時実行性パッケージ

WCS-67001からWCS-68000

ポータル・アプリケーション統合

WCS-68001からWCS-69000

システム管理

WCS-69001からWCS-70000

範囲外のパフォーマンス

WCS-69201からWCS-70000

Nitrous

WCS-70001からWCS-71000

Oracle WebCenter Portalパフォーマンス・メトリックの範囲外状態

範囲外の状態は管理対象サーバーの診断ログにも記録されるので、いつでも履歴イベントを調べることができます。パフォーマンス関連のメッセージは、メッセージID接頭辞WCS-692<nn>を使用して記録され、メトリック名、値、および範囲外であるメトリックを記述するメッセージが含まれます。

WebCenter Portalの診断ログに記録されるメッセージの例を次に示します。

[WC_Spaces] [WARNING] [WCS-69251] [oracle.webcenter.system-management] [tid:
[ACTIVE].ExecuteThread: '4' for queue: 'weblogic.kernel.Default (self-tuning)']
[userId: weblogic] [ecid:
6356ef0164cbad47:3fe105c5:13b4e847973:-8000-0000000000000031,0] [APP:
webcenter#11.1.1.4.0] [DSID: 0000JhEYRT^EgKG_Ix8Dyf1Ghz32000005]
pageResponseTime: 22223 ms of PersonalSpace/Activities is out-of-bounds

[WC_Spaces] [WARNING] [WCS-69252] [oracle.webcenter.system-management] [tid:
oracle.webcenter.DefaultTimer] [ecid: 0000JhEX92mEgKG_Ix8Dyf1Ghz32000002,0] [APP: webcenter#11.1.1.4.0]
wlsCpuUsage: 21.92100394175851 % of WebLogicServer is out-of-bounds

[WC_Spaces] [WARNING] [WCS-69255] [oracle.webcenter.system-management] [tid:
[ACTIVE].ExecuteThread: '0' for queue: 'weblogic.kernel.Default (self-tuning)']
[userId: weblogic] [ecid:
6356ef0164cbad47:3fe105c5:13b4e847973:-8000-0000000000000060,0] [APP:
webcenter#11.1.1.4.0] [DSID: 0000JhEYRT^EgKG_Ix8Dyf1Ghz32000005]
downloadThroughput: 11.63793103448276 KB/sec of 3209 is out-of-bound

[WC_Spaces] [WARNING] [WCS-69253] [oracle.webcenter.system-management] [tid:
pool-3-daemon-thread-1] [userId: weblogic] [ecid:
6356ef0164cbad47:3fe105c5:13b4e847973:-8000-0000000000000088,0:16] [APP:
webcenter#11.1.1.4.0] portletResponseTime: 20523 ms of Portlet: slowRenderingPortlet from Web Producer pkjpdk is out-of-bounds

28.2 ログ情報の表示および構成

この項には次のトピックが含まれます:

- 第28.2.1項「WebCenter Portalログの表示および構成」

- 第28.2.2項「Portal Frameworkアプリケーション・ログの表示および構成」

28.2.1 WebCenter Portalログの表示および構成

WebCenter Portalアプリケーションのログ・メッセージを表示する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、WebCenter Portalのホームページに移動します。
第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「ログ」→「ログ・メッセージの表示」を選択します。

3. 「ログ・メッセージ」ページで、警告、エラー、通知などを検索します。

WebCenter Portalのログ・ファイルを構成するには:

1. Fusion Middleware Controlコンソールで、WebCenter Portalのホームページに移動します。
第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「ログ」→「ログ構成」を選択します。

3. 「ログ構成」ページの「ログ・ファイル」タブで、ログ設定を構成します。

詳細は、管理者ガイドのログ・ファイルの表示と検索に関する項を参照してください。

28.2.2 Portal Frameworkアプリケーション・ログの表示および構成

Portal Frameworkアプリケーションのログ・メッセージを表示する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、Portal Frameworkアプリケーションのホームページに移動します。
第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「アプリケーションのデプロイ」メニューから、「ログ」→「ログ・メッセージの表示」を選択します。

3. 「ログ・メッセージ」ページで、警告、エラー、通知などを検索します。

Portal Frameworkアプリケーションのログ・ファイルを構成するには:

1. Fusion Middleware Controlコンソールで、Portal Frameworkアプリケーションのホームページに移動します。
第6.3項「Portal Frameworkアプリケーションのホームページへの移動」を参照してください。

2. 「アプリケーションのデプロイ」メニューから、「ログ」→「ログ構成」を選択します。

3. 「ログ構成」ページの「ログ・ファイル」タブで、ログ設定を構成します。

詳細は、管理者ガイドのログ・ファイルの表示と検索に関する項を参照してください。

29 Oracle WebCenter Portal監査ログの管理

この章では、WebCenter Portal監査ログの管理の概要について説明します。

この章には次の項が含まれます:

- 第29.1項「監査ログの管理の概要」

- 第29.2項「監査ログの構成」

- 第29.3項「WebCenter Portal監査イベントの表示」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

29.1 監査ログの管理の概要

監査ログを有効にすると、Fusion Middleware監査サービスの一環として、ポータル関連のイベントが追跡されます。デフォルトでは、監査ログ・イベントはファイル(監査バスストップ)に格納されますが、データベースにアップロードして永続化することもできます(詳細は、第29.2.2項「監査ストア・データベースの構成」を参照)。監査バスストップ・ファイルの容量にはかぎりがあるため、ログ情報をデータベースに格納することをお薦めします。そうすることで、イベントの発生から長時間経過した後でも、そのイベントを問い合せできるようになります。

注意:
WebCenter Portal偽装を有効にする場合は、監査ログも有効にすることを強くお薦めします。偽装を有効にすると、監査ログによって、偽装者、被偽装者およびイベントのコンテキストが追跡されます。

監査ログの主な利点は次のとおりです。

- ポータル、ポータル・サーバーおよびポータル・サーバーの主要アーティファクトのセキュリティ設定を変更するイベントを追跡できます。

- ロギング・レベルを定義できます。

- ログに記録されたイベントをデータベースにアップロードすると、それらは永続的に参照可能になります。

- 監査サービスを通じて、監査イベントに関するレポートを参照できます。

監査サービスとその構成の詳細は、Oracle Platform Security Servicesによるアプリケーションの保護の「Oracle Fusion Middleware監査フレームワークの概要」を参照してください。監査サービスを構成してデータベースを使用する方法の詳細は、Oracle Platform Security Servicesによるアプリケーションの保護の監査の構成および管理に関する項を参照してください。初期設定の監査サービス・レポートの詳細は、Oracle Platform Security Servicesによるアプリケーションの保護の事前作成監査レポートに関する項を参照してください。

29.2 監査ログの構成

この項では、WebCenter Portalのログを有効および無効にする方法、ログ・レベルを設定する方法および監査ストア・データベースを設定する方法について説明します。

この項には次のサブセクションが含まれます:

- 第29.2.1項「ロギング・レベルの設定」

- 第29.2.2項「監査ストア・データベースの構成」

29.2.1 ロギング・レベルの設定

デフォルトでは、WebCenter Portalの監査ログは無効になっています(つまりNoneに設定されています)。これを有効にするには、次の例のように、ロギング・レベルをNone以外の値(Lowなど)に設定します。各ロギング・レベルに含まれるロギング・カテゴリの詳細は、第29.3.1項「WebCenter Portal監査ログの使用」を参照してください。

WebCenter Portal監査イベントの監査ロギング・レベルを変更するには、次のWLSTコマンドを使用します。

ロギング・レベルをLowに設定する場合:

setAuditPolicy(componentType="webcenter#11.1.1.9.0",filterPreset="Low")

次のようにロギング・レベルをMediumに設定します。

setAuditPolicy(componentType="webcenter#11.1.1.9.0",filterPreset="Medium")

WebCenter Portalのログを無効にする場合:

setAuditPolicy(componentType="webcenter#11.1.1.9.0",filterPreset="None")

正常に実行された場合、エラーはスローされず、警告なしで完了します。WC_Spacesサーバーを再起動して、ロギング・レベルの変更を完了します。

監査ロギングの管理および構成に使用できるその他のWLSTコマンドの詳細は、Oracle Platform Security Servicesによるアプリケーションの保護の監査のためのWLSTコマンドに関する項を参照してください。

29.2.2 監査ストア・データベースの構成

監査ストアは、リポジトリ作成ユーティリティ(RCU)によって作成される、事前定義済のOracle Fusion Middleware監査フレームワーク・スキーマを含むデータベースです。デフォルトでは、監査ログは次の例のように、auditlogsディレクトリ内のファイルとして格納されます。

DOMAIN_HOME/servers/WC_Spaces/logs/auditlogs/webcenter#11.1.1.9.0/audit_1_0.log

データベース永続性が構成されると、監査ローダーはこのファイルからデータを取得し、それを監査フレームワーク・スキーマ内に配置します。監査サービスを構成してデータベースを使用する方法の詳細は、Oracle Platform Security Servicesによるアプリケーションの保護の監査の構成および管理に関する項を参照してください。

監査スキーマの名前を確認する必要があります(接尾辞は常にIAUです)。また、次のように監査リポジトリをデータベースに設定する必要があります。

setAuditRepository(switchToDB='true',dataSourceName='jdbc/AuditDB',interval='15')

注意:
ストア内の監査データは累積されることが予想され、時間の経過に伴って増加します。データベースは、他のアプリケーションによって使用される運用データベースではなく、監査専用のスタンドアロンRDBMSであるのが理想的です。

29.3 WebCenter Portal監査イベントの表示

この項では、監査ログに記録されるWebCenter Portal偽装イベントについて説明し、監査スキーマへの偽装イベントの問合せに使用できる単純なSQL文を紹介します。

この項には次のサブセクションが含まれます:

- 第29.3.1項「WebCenter Portal監査ログの使用」

- 第29.3.2項「監査スキーマへの問合せ」

29.3.1 WebCenter Portal監査ログの使用

表29-1は、設定したログ・レベルに応じて監査ログに記録されるWebCenter Portal監査イベントを示しています。各WebCenter Portalツール(お知らせ、ディスカッション、フォーラム、フォーラム・メッセージ、フォーラム・トピック、フォーラム・カテゴリなど)は、ログ内の対応するToolArtifactIDとToolTypeによって識別されます。

ログ・レベルをLowに設定した場合、次のカテゴリのイベントがログに記録されます。

- PortalLifeCycle

- PortalRoleManagement

- PortalRoleMemberManagement

- PortalToolAccessManagement

- ImpersonationSessionMgmt

ログ・レベルをMediumに設定した場合、さらに次のカテゴリのイベントがログに記録されます。

- PortalToolsManagement

- PortalPagesManagement

表29-1 WebCenter Portal監査イベント

イベント・カテゴリ

イベント名

イベント・ペイロード

PortalLifeCycle

LoginPortalServer、
CreatePortal、DeletePortal、
ImportPortal、ExportPortal、DeployPortal、PropagatePortal

InitiatorUID、InitiatorMail、InitiatorDisplayName、ImpersonatorUID、PortalID、PortalName、PotalDisplayName、PortalURL、PortalTemplate、PortalOldState、PortalNewState、TargetPortalConnection

PortalRoleManagement

CreateRole
DeleteRole
PermissionUpdate

InitiatorUID、InitiatorMail、InitiatorDisplayName、ImpersonatorUID、PortalID、PortalName、RoleName、RoleTemplate、PermissionClass、PermissionName、PermissionActionsGranted、PermissionActionsRevoked

PortalRoleMemberManagement

AddMemberToRole
RemoveMemberFromRole

InitiatorUID、InitiatorMail、InitiatorDisplayName、ImpersonatorUID、PortalID、PortalName、RoleName、MemberType、MemberUID、ServiceID

ImpersonationSessionMgmt

GrantImpersonationAccess
RevokeImpersonationAccess
BeginImpersonation
EndImpersonation

InitiatorUID、InitiatorMail、InitiatorDisplayName、ImpersonatorUID、ImpersonateeUID、PortalID、PortalName、ImpersonationStartTime、ImpersonationEndTime、ImpersonationGrantStartTime、ImpersonationEndTime、ImpersonationRightRevokeTime

PortalToolsManagement

CreateTool、DeleteTool
ModifyTool

InitiatorUID、InitiatorMail、InitiatorDisplayName、ImpersonatorUID、PortalID、PortalName、ToolArtifactID、ToolName、ToolType

PortalToolAccessManagement

ToolAccessPermissionUpdate
GrantToolAccess
RevokeToolAccess

InitiatorUID、InitiatorMail、InitiatorDisplayName、ImpersonatorUID、PortalID、PortalName、ToolName、ToolType、ToolArtifactID、MemberUID、MemberType、PermissionActionsGranted、PermissionActionsRevoked、PermissionClass、PermissionName

PortalPagesManagement

CreatePage
DeletePage

InitiatorUID、InitiatorMail、InitiatorDisplayName、ImpersonatorUID、PortalID、PortalName、PageID、PageName

29.3.2 監査スキーマへの問合せ

監査スキーマを構成し、監査リポジトリをデータベースに設定したら、この生成された監査データに基づいてレポートを生成できます。レポートを作成するには、次の手順を実行します。

1. 次のコマンドを実行してSQLファイルを生成することによって、監査表に基づくビューを生成します。その後、このファイルを使用して、WebCenter Portalコンポーネント固有のデータに関するビューを、監査DB表から作成できます。

createAuditDBView(fileName="/tmp/WCPortalAuditView.sql", componentType="webcenter#11.1.1.9.0")

IAUスキーマの所有者(TEST_IAUなど)は、ビューの作成権限を持っている必要があります。ビューを作成するには、システムDBAとして、WCPortalAuditView.sqlファイルを実行するか、次のSQLコマンドを実行します。

grant create view to TEST_IAU

作成されるビューの名前は、webcenter#11_1_1_9_0_AUDITVIEWのようになります。

2. ビューを使用して、監査データベースへの問合せを実行します。次の例のように、WebCenter Portalツールの監査属性名を、表の列名として使用します。WCPortalAuditView.sqlファイルを開くと、表の列名とWebCenter Portal属性のマッピングを確認できます。

- 次のSQL文は、イベント・タイプBeginImpersonationおよびEndImpersonationとしてログに記録された、WebCenter Portalツールのすべての属性を返します。

select * from webcenter#11_1_1_9_0_AUDITVIEW where EventType like '%Impersonation';

- 次のSQL文は、いずれかのポータルを削除したすべてのユーザーと、削除されたポータルの情報をリストします。

select InitiatorUID,InitiatorMail,PortalID,PortalName,PortalURL from webcenter#11_1_1_9_0_AUDITVIEW where EventType = 'DeletePortal';

- 次のSQL文は、WebCenter Portalのすべての監査データを返します。

select * from webcenter#11_1_1_9_0_AUDITVIEW;

WebCenter Portalのアクティビティを定期的にモニターする場合は、SQL問合せを使用するSQLデータ・コントロールを作成し、そのデータ・コントロールを、表やその他の視覚化としてポータル・ページ上にドロップできます。SQLデータ・コントロールの詳細は、Oracle WebCenter Portalでのポータルの構築のデータ・プレゼンタでの作業に関する項を参照してください。

第VII部

セキュリティ

『Oracle WebCenter Portalの管理』のこの部では、Oracle WebCenter Portalのセキュリティ管理について説明します。

第7部の章の内容は次のとおりです。

- 第30章「Oracle WebCenter Portalセキュリティの管理」

- 第31章「アイデンティティ・ストアの構成」

- 第32章「ポリシーおよび資格証明ストアの構成」

- 第33章「シングル・サインオンの構成」

- 第34章「シングル・サインオン向けのPortal Frameworkアプリケーションの構成」

- 第35章「SSLの構成」

- 第36章「WS-Securityの構成」

- 第37章「ポートレット・プロデューサのセキュリティの構成」

- 第38章「偽装の管理」

30 Oracle WebCenter Portalセキュリティの管理

この章では、WebCenter PortalおよびPortal Frameworkアプリケーションの保護の概要を説明し、さらにアプリケーションの初期デプロイ時に設定されているセキュリティ構成について説明します。また、トラブルシューティングの項では、セキュリティ関連の構成でよく見られる問題の解決策を示します。

この章には次の項が含まれます:

- 第30.1項「アプリケーション・セキュリティの概要」

- 第30.2項「デフォルトのセキュリティ構成」

- 第30.3項「セキュリティ構成に関する問題のトラブルシューティング」

WebCenter PortalおよびPortal Frameworkアプリケーションのセキュリティ構成の特定の局面に関する詳細は、次を参照してください。

- 第31章「アイデンティティ・ストアの構成」

- 第32章「ポリシーおよび資格証明ストアの構成」

- 第33章「シングル・サインオンの構成」

- 第34章「シングル・サインオン向けのPortal Frameworkアプリケーションの構成」

- 第35章「SSLの構成」

- 第36章「WS-Securityの構成」

- 第37章「ポートレット・プロデューサのセキュリティの構成」

- 第43章「管理コンソールを使用したPortal Frameworkアプリケーションの管理」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

30.1 アプリケーション・セキュリティの概要

WebCenter PortalおよびPortal Frameworkアプリケーションの推奨セキュリティ・モデルは、Java Authentication and Authorization Service (JAAS)モデルを実装するOracle ADF Securityに基づいています。Oracle ADF Securityの詳細は、『Oracle Application Development Framework Fusion開発者ガイド』を参照してください。

図30-1は、WebCenter PortalまたはPortal Frameworkアプリケーション・デプロイメントとそのサービス、サーバー、ポートレット、ポートレット・プロデューサ、アイデンティティ・ストア、資格証明ストア、ポリシー・ストア、およびOracle Enterprise Managerの関係を示しています。

図30-1 WebCenter Portalアプリケーションの基本的なアーキテクチャ

図30-2は、バックエンド・サーバーが接続された、デプロイ後の基本的なWebCenter PortalまたはPortal Frameworkアプリケーションを示しています。

図30-2 バックエンド・サーバーが接続されたWebCenter Portalアプリケーションのアーキテクチャ

図30-3は、WebCenter PortalおよびPortal Frameworkアプリケーションのセキュリティ・レイヤーを示しています。

図30-3 WebCenter Portalのセキュリティ・レイヤー

WebCenter PortalおよびPortal Frameworkアプリケーションは4つの同一下部セキュリティ・レイヤー(WebCenterセキュリティ・フレームワーク、ADFセキュリティ、OPSSおよびWebLogicサーバー・セキュリティ)を共有します。当然ながら、アプリケーション・レイヤーは実装に依存します。

WebCenter Portalアプリケーション・セキュリティ

WebCenter Portalでは、次のものがサポートされています。

- アプリケーション・ロール管理および権限マッピング

- 自己登録

- ポータルレベルのセキュリティ管理

- 外部アプリケーションの資格証明管理

WebCenter Portalセキュリティ・フレームワーク

WebCenter Portalセキュリティ・フレームワークでは、次のものがサポートされています。

- サービス・セキュリティ拡張フレームワーク(サービスのセキュリティ・モデルを指定する際に一般的に使用される、権限ベースおよびロール・マッピングベースのモデル)

- 権限ベースの認可

- ロール・マッピングベースの認可

- 外部アプリケーションと資格証明とのマッピング

ADFセキュリティ

ADFセキュリティでは、次のものがサポートされています。

- ページ認可

- タスク・フロー認可

- セキュアな接続管理

- 資格証明マッピングAPI

- ログアウトの呼出し(Oracle Access ManagerおよびOracle SSOを使用したSSO対応構成からのログアウトなど)

- ADFセキュリティベースのアプリケーション(adfAuthenticationサーブレット)用に保護されたログインURL

Oracle Platform Security Services(OPSS)

OPSSでは、次のものがサポートされています。

- Anonymous-role

- Authenticated-role

- アイデンティティ・ストア、ポリシー・ストアおよび資格証明ストア

- アイデンティティ管理サービス

- Oracle Web Service Managerセキュリティ

- 認可

- ポリシーおよび資格証明ライフサイクル

WebLogic Serverセキュリティ

WebLogic Serverセキュリティでは、次のものがサポートされています。

- WebLogicオーセンティケータ

- アイデンティティ・アサータ

- J2EEコンテナ・セキュリティ

- SSL

30.2 デフォルトのセキュリティ構成

この項では、WebCenter PortalおよびPortal Frameworkアプリケーションのデプロイ時に設定されているセキュリティ構成と、デプロイ後に実行する必要のある構成タスクについて説明します。

- 第30.2.1項「管理者アカウント」

- 第30.2.2項「アプリケーション・ロールとエンタープライズ・ロール」

- 第30.2.3項「デフォルトのアイデンティティ・ストアおよびポリシー・ストア」

- 第30.2.4項「デフォルトのポリシー・ストアの権限および付与」

- 第30.2.5項「デプロイ後のセキュリティ構成タスク」

30.2.1 管理者アカウント

Portal Frameworkアプリケーションでは、事前に用意されているアカウントがないため、Oracle Fusion Middlewareのインストール時に設定されるシステム管理者アカウント(デフォルトではweblogic)が使用されます。この管理者アカウントを使用して、Fusion Middleware Controlにログインし、新規アカウントを設定します。

WebCenter Portalアプリケーションでは、事前に用意されているアカウントはありませんが、WebCenter Portalアプリケーションのデフォルトのシステム管理者アカウント(weblogic)には特定の権限が事前に付与されています。インストール環境でシステム管理者ロールのアカウント名にweblogicを使用しない場合は、第32.5項「ユーザーおよびアプリケーション・ロールの管理」の手順に従って、このロールにその他のユーザーを1つ以上構成する必要があります。

注意:
weblogicアカウントはシステム管理者アカウントです。そのため、ユーザーレベルのアーティファクトを作成する際には使用しないでください。weblogicアカウントは、Fusion Middleware Controlで新規ユーザー・アカウントを作成する場合にのみ使用してください。

30.2.2 アプリケーション・ロールとエンタープライズ・ロール

アプリケーション・ロールは、組込みLDAPサーバーのアイデンティティ・ストア部分に存在するロールや、エンタープライズLDAPプロバイダにより定義されたロールとは異なります。アプリケーション・ロールはアプリケーションに固有であり、ポリシー・ストアのアプリケーション固有のストライプで定義されます。

エンタープライズ・アイデンティティ・ストアに格納されているエンタープライズ・ロールは、エンタープライズ・レベルでのみ適用されます。つまり、ユーザーやシステム管理者がエンタープライズ・アイデンティティ・ストア内部に定義したロールおよび権限は、アプリケーション内の権限とは異なります。

WebCenter PortalまたはPortal Frameworkアプリケーション内では、アプリケーション・ロールおよび権限を企業アイデンティティ・ストア内のユーザーに割り当てることができます。また、エンタープライズ・アイデンティティ・ストア内に定義されたエンタープライズ・ロールに対してアプリケーション・ロールおよび権限を割り当てることもできます。

30.2.3 デフォルトのアイデンティティ・ストアおよびポリシー・ストア

WebCenter PortalおよびPortal Frameworkアプリケーションはデフォルトで、ファイルベースの組込みLDAPアイデンティティ・ストアを使用してアプリケーションレベルのユーザーIDを格納し、データベース・ポリシー・ストアを使用してポリシー権限を格納するように構成されています。

組込みLDAPアイデンティティ・ストアはセキュアではありますが、本番クラスのストアではないため、エンタープライズ本番環境向けの外部LDAPベース・アイデンティティ・ストア(Oracle Internet Directoryなど)と置き換える必要があります。サポートされているアイデンティティ・ストアLDAPサーバーのリストは、『Oracle Platform Security Servicesによるアプリケーションの保護』のサポートされているLDAPアイデンティティ・ストアのタイプに関する項を参照してください。

注意:
デフォルトのファイルベースのポリシー・ストアは、開発用および単一ノードのWebCenter Portal構成用にのみ使用してください。エンタープライズ・デプロイメントでは、第32章「ポリシーおよび資格証明ストアの構成」の説明に従って、ポリシー・ストアおよび資格証明ストアをデータベースまたは外部LDAPベースのストアに再度関連付ける必要があります。

ポリシー・ストアおよび資格証明ストアでは、Oracle Internet Directory 11gR1または10.1.4.3、またはOracle RDBMS (リリース10.2.0.4以降、リリース11.1.0.7以降およびリリース11.2.0.1以降)のいずれかを使用できます。外部LDAPベースのストアを使用する場合は、ポリシー・ストアと資格証明ストアで同じLDAPサーバーを使用するように構成する必要がある点に注意してください。同様に、データベースを使用する場合は、ポリシー・ストアと資格証明ストアで同じデータベースを使用する必要があります。

アイデンティティ・ストア、ポリシー・ストアおよび資格証明ストアの再構成の詳細は、第31章「アイデンティティ・ストアの構成」および第32章「ポリシーおよび資格証明ストアの構成」を参照してください。

注意:
ディスカッションはデフォルトで、組込みLDAPアイデンティティ・ストアを使用するように構成されています。組込みLDAPストア内のすべてのユーザーがディスカッション・サーバーにログオンできます。また、Administratorsグループ内のすべてのユーザーがディスカッション・サーバーの管理権限を保有します。
アイデンティティ・ストアを外部LDAPサーバーに再度関連付けた場合、システム管理者アカウントを外部LDAPに移行するか(第31.4項「ディスカッション・サーバーの新しい管理者アカウントの識別」を参照)、管理者アカウントを移行しない場合には、ディスカッション・サーバーの新しい管理者アカウントを識別するために追加の手順が必要になります(第31.4.1項「外部LDAPを使用するためのディスカッション・サーバーの移行」を参照)。

WebCenter Portalに関しては、WebCenter PortalアプリケーションおよびContent Serverは同じLDAPサーバーを共有する必要があります。詳細は、第31.5項「Content ServerとWebCenter Portalでアイデンティティ・ストアLDAPサーバーを共有するための構成」を参照してください。

30.2.4 デフォルトのポリシー・ストアの権限および付与

ADFセキュリティの権限モデルでは、権限ベースの認可およびロールベースの認可の両方がサポートされています。次の項では、この2つの認可タイプ、デフォルトのポリシー・ストア権限およびコードベース権限について説明します。

- 第30.2.4.1項「権限ベースの認可」

- 第30.2.4.2項「ロール・マッピングベースの認可」

- 第30.2.4.3項「WebCenter Portalのデフォルトのポリシー・ストア権限」

- 第30.2.4.4項「デフォルトのコードベース権限」

30.2.4.1 権限ベースの認可

権限ベースの認可は、リストなど、Oracle Platform Security Services (OPSS)を使用してWebCenter PortalまたはPortal Frameworkアプリケーション内にアクセス制御が実装されているツールで使用されます。WebCenter Portalには、ユーザーおよびロール管理ツールが豊富に用意されています。これらのツールによってアプリケーション・ロールを作成し、そのロールに付与する必要がある権限を定義できます。WebCenter Portalでのユーザーおよびロールの管理の詳細は、『Oracle WebCenter Portalの使用』のアプリケーション・ロールおよび権限の管理に関する項を参照してください。

30.2.4.2 ロール・マッピングベースの認可

リモート(バックエンド)リソースへのアクセスが必要なツールおよびサービスでは、ロール・マッピングベースの認可が必須になります。たとえば、ディスカッションで、WebCenter PortalまたはPortal Frameworkアプリケーションの(1つ以上のアプリケーション・ロールにマップされている)ユーザーをディスカッション・サーバーの別のロール・セットにマップする必要がある場合は、ロール・マッピングが必須です。

たとえば、WebCenter Portalアプリケーションでは次のようになります。

- WebCenter Portalのロールは、バックエンドのディスカッション・サーバーの対応するロールにマップされます。

- ユーザーに新しいWebCenter Portalロールが付与されると、バックエンドのディスカッション・サーバーで同様の権限が付与されます。たとえば、ユーザーPatがWebCenter PortalでDiscussions-Create/Edit/Delete権限を付与された場合、バックエンドのディスカッション・サーバーで、対応する権限がPatに付与されます。

『Oracle WebCenter Portalの使用』のディスカッション・サーバーのロールおよび権限マッピングの理解に関する項も参照してください。

30.2.4.3 WebCenter Portalのデフォルトのポリシー・ストア権限

WebCenter Portalには、初期設定で次のデフォルト・ロールが用意されています。

デフォルトのアプリケーション・ロール:

- 管理者

- アプリケーション・スペシャリスト

- 認証されたユーザー

- パブリック・ユーザー

デフォルトのアプリケーション・ロールの詳細は、次を参照してください。

ポータル内のデフォルトのロール

- モデレータ

- 参加者

- ビューア

ポータル内のデフォルトのロールの詳細は、第43.4.2.1項「アプリケーション・ロールの理解」を参照してください。

30.2.4.4 デフォルトのコードベース権限

WebCenter PortalおよびPortal Frameworkアプリケーションは、権限チェックを使用して保護されたセキュリティ・プラットフォームでAPIを内部的にコールします。したがって、OPSSのAPIを呼び出すには、アプリケーションに適切な権限を付与する必要があります(たとえば、ポリシー・ストアにアクセスして権限を付与または取り消す(PolicyStoreAccessPermission)ための権限や、アプリケーション・ロールに基本的な権限を付与するための権限など)。WebCenter Portalでは、アプリケーション・ロールの基本的な権限はデフォルトで付与されています(第43.4.2項「アプリケーション・ロールおよび権限の理解」を参照)。

同様に、WebCenter PortalおよびPortal Frameworkアプリケーションでは、WebCenter Portalの権限を使用して公開する各種操作に対して事前にアクセスを認可しておき、OPSS APIを権限付きアクションとして呼び出す必要があります。

30.2.5 デプロイ後のセキュリティ構成タスク

WebCenter PortalまたはPortal Frameworkアプリケーションをデプロイした後で、次のセキュリティ関連の構成タスクをサイトに対して実行することを考慮する必要があります。

- 外部LDAPを使用するためのアイデンティティ・ストアの再関連付け
WebCenter PortalおよびPortal Frameworkアプリケーションではデフォルトで、アイデンティティ・ストアに組込みLDAPが使用されます。事前に構成されている組込みLDAPは、セキュアではありますが、大規模なエンタープライズ本番環境には適さない場合があります。Oracle Internet Directory (OID)などの外部LDAPを使用するようにアイデンティティ・ストアを構成する方法の詳細は、第31章「アイデンティティ・ストアの構成」を参照してください。

注意:
WebCenter Portalのディスカッション・サーバーはデフォルトで、組込みLDAPアイデンティティ・ストアを使用するように構成されています。組込みLDAPストア内のすべてのユーザーがディスカッション・サーバーにログオンできます。また、Administratorsグループ内のすべてのユーザーがディスカッション・サーバーの管理権限を保有します。
アイデンティティ・ストアを外部LDAPサーバーに再度関連付けた場合、システム管理者アカウントを外部LDAPに移行するか(第31.4項「ディスカッション・サーバーの新しい管理者アカウントの識別」を参照)、管理者アカウントを移行しない場合には、ディスカッション・サーバーの新しい管理者アカウントを識別するために追加の手順が必要になります(第31.4.1項「外部LDAPを使用するためのディスカッション・サーバーの移行」を参照)。

WebCenter Portalに関しては、WebCenter PortalアプリケーションおよびContent Serverは同じLDAPサーバーを共有する必要があります。詳細は、第31.5項「Content ServerとWebCenter Portalでアイデンティティ・ストアLDAPサーバーを共有するための構成」を参照してください。

- 外部LDAPを使用するためのポリシー・ストアの再関連付け
デフォルトで、Portal Frameworkアプリケーションはデータベースを使用してポリシー付与を格納します。LDAPベースのポリシー・ストアの使用を考慮できます。LDAPサーバーを使用するようにポリシー・ストアを構成する方法の詳細は、第32章「ポリシーおよび資格証明ストアの構成」を参照してください。

- WS-Securityの構成
WS-Securityを使用すると、Portal Frameworkアプリケーションおよびそれが使用する一連のプロデューサの構成や管理が複雑になりますが、Portal Frameworkアプリケーションで公開される情報のセキュリティを確保する上で役立ちます。WS-Securityを追加すると、コンシューマの認証およびメッセージレベルのセキュリティを使用できるようになります。

Portal Frameworkアプリケーションおよびコンポーネントに対してWS-Securityを構成する方法の詳細は、第36章「WS-Securityの構成」を参照してください。

- SSOの構成
シングル・サインオン(SSO)を使用すると、ユーザーはサブアプリケーションごとにログインするのではなく(WebCenter Portal内のwikiページにアクセスする場合など)、WebCenter PortalおよびPortal Frameworkアプリケーションおよびコンポーネント全体で1回ログインするだけで済みます。ユーザーは、アクセスするアプリケーションまたはコンポーネントごとに別個のユーザーIDおよびパスワードを保持する必要がありません。ただし、より厳密な方式を使用して機密性の高いアプリケーションを保護できるように、多様な認証方式を構成することもできます。WebCenter PortalおよびPortal Frameworkアプリケーションでは、4つのシングル・サインオン・ソリューション(Oracle Access Manager (OAM)、Oracle Single Sign-on (OSSO)、Oracle WebCenter Portalアプリケーション専用のSAMLベースのシングル・サインオン・ソリューション、およびSimple and Protected Negotiate (SPNEGO)メカニズムとKerberosプロトコルに基づいたWindows認証による、Microsoftクライアント用SSOソリューション)がサポートされています。これらのソリューションの説明およびシングル・サインオンの概要については、第33章「シングル・サインオンの構成」を参照してください。

- SSLの構成
Secure Sockets Layer (SSL)は、WebCenter PortalおよびPortal Frameworkアプリケーションまたはコンポーネントの間の接続に対して追加の認証レイヤーを提供し、交換されるデータを暗号化することにより、接続セキュリティを強化するものです。データ交換が機密的なアプリケーションまたはコンポーネント間の接続では、SSLを使用して接続を保護することを考慮してください。本番環境でSSLを使用して保護できる、または保護する必要のある接続のリストは、第35章「SSLの構成」を参照してください。

注意:
SSLを使用すると、計算が集中的に行われ、接続のオーバーヘッドが増加します。このため、SSLは必要でないかぎりは使用しないでください。SSLは本番環境まで保留しておくことをお薦めします。

30.3 セキュリティ構成に関する問題のトラブルシューティング

この項には次のサブセクションが含まれます:

- 第30.3.1項「WebCenter PortalアプリケーションでLDAPプロバイダのユーザーが見つからない」

- 第30.3.2項「OIDユーザーとしてログインしている場合にポータルを作成するとエラーが発生する」

- 第30.3.3項「Active Directoryを使用してWebCenter Portalを構成するとユーザーが自己登録できない」

- 第30.3.4項「管理者に設定されたユーザーが管理者権限を使用できない」

- 第30.3.5項「SSO環境のOmniPortletプロデューサで認可例外が発生する」

- 第30.3.6項「SAML SSO固有のディスカッションEARファイルをデプロイすると例外が発生する」

- 第30.3.7項「SAMLシングル・サインオンを構成すると403エラーが発生する」

- 第30.3.8項「偽装セッションがOAM 11.1.2.2.0でエラーを生成する」

30.3.1 WebCenter PortalアプリケーションでLDAPプロバイダのユーザーが見つからない

問題

外部LDAPプロバイダを使用してWeblogic Serverを構成しました。外部LDAPのユーザーはWebCenter Portalにログインできますが、WebCenter Portalで外部LDAPのユーザーに管理者ロールを割り当てようとすると、ユーザーが一人も見つかりません。

解決策

第31章「アイデンティティ・ストアの構成」の手順に従って、DefaultAuthenticator認証プロバイダの制御フラグをSufficientに変更します。 ドメインの管理サーバーと管理対象サーバーを再起動します。

30.3.2 OIDユーザーとしてログインしている場合にポータルを作成するとエラーが発生する

問題

OIDユーザー(orcladminなど)としてWebCenter Portalにログインしている場合にポータルを作成しようとすると、ポータルは作成されますがエラーが発生します。エラー・メッセージには「No matching users were found with search string <login user>」のように表示されます。

解決策

jps-config.xmlファイルに次のプロパティが設定されていません。

<property name="jps.user.principal.class.name" value="weblogic.security.principal.WLSUserImpl"/>

この問題を解決する手順は次のとおりです。

1. DOMAIN_HOME/config/fmwconfig/jps-config.xmlを編集します。

2. 一般プロパティに次の行を追加します。
<property name="jps.user.principal.class.name" value="weblogic.security.principal.WLSUserImpl"/>

3. WC_Spacesサーバーを再起動します。

30.3.3 Active Directoryを使用してWebCenter Portalを構成するとユーザーが自己登録できない

問題

WebCenter PortalでADオーセンティケータを使用するように構成すると、ユーザーがActive Directoryに自己登録できません。ユーザーが自己登録しようとすると、次のエラー・メッセージが表示されます。

"User not created. Either the user name or the password does not adhere to the registration policy or the identity store is unavailable. Specify the required user credentials or contact your administrator for assistance"

解決策

この問題を解決する手順は次のとおりです。

1. WebLogic管理コンソールでActive Directoryを構成する際に、ユーザー名属性をsAMAccountNameに設定します。

2. WebLogic管理コンソールでActive Directoryを構成する際に、LDAPのHTTPSポートを使用し、SSLのチェック・ボックスを選択します。

30.3.4 管理者に設定されたユーザーが管理者権限を使用できない

問題

orcladminとしてログインし、ユーザーを管理者に設定した後でログアウトし、そのユーザーで再度ログインしても、管理者リンクが使用可能になりません。

解決策

この問題は、アイデンティティ・ストア内でcnエントリが重複しているために起こります。cnはユーザー名属性にマップされており、一意である必要があります。アイデンティティ・ストアから重複を削除し、そのユーザーに適切なprivileges.cnを設定してください。

30.3.5 SSO環境のOmniPortletプロデューサで認可例外が発生する

問題

SSOを使用してWebCenter Portalが構成されている場合に、OmniPortletプロデューサでCredential Store Framework (CSF)ウォレットに接続情報を格納しようとすると認可例外が発生します。

解決策

WLST(詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照)を使用してOracle WebCenter Portal Administration Serverに接続し、次の付与コマンドを実行して、ssofilter.jarに必要な権限を付与します。

grantPermission(codeBaseURL="file:${oracle.home}/modules/oracle.ssofilter_11.1.1/ssofilter.jar",
permClass="oracle.security.jps.service.credstore.CredentialAccessPermission",
permTarget="context=SYSTEM,mapName=omniportlet_user,keyName=*",
permActions="*")

grantPermission(codeBaseURL="file:${oracle.home}/modules/oracle.ssofilter_11.1.1/ssofilter.jar",
permClass="oracle.security.jps.service.credstore.CredentialAccessPermission",
permTarget="context=SYSTEM,mapName=omniportlet_default,keyName=*",
permActions="*")
grantPermission(codeBaseURL="file:${oracle.home}/modules/oracle.ssofilter_11.1
.1/ssofilter.jar",
permClass="oracle.security.jps.service.credstore.CredentialAccessPermission",
permTarget="context=SYSTEM,mapName=omniportlet_user,keyName=*",
permActions="*")

30.3.6 SAML SSO固有のディスカッションEARファイルをデプロイすると例外が発生する

問題

ディスカッションEARファイルをアンデプロイしてから、SAML SSO固有のディスカッションEARファイルをデプロイし、WLS管理コンソールでアプリケーションを起動すると、管理コンソールで次の例外が発生します。

java.lang.ClassCastException:
org.apache.xerces.parsers.XIncludeAwareParserConfiguration

解決策

WC_Collaborationサーバーを再起動します。これにより問題が解決され、ディスカッション・アプリケーションがアクティブな状態になるはずです。

30.3.7 SAMLシングル・サインオンを構成すると403エラーが発生する

問題

SAML SSO構成のテスト中に403エラーが発生したため、デバッグ・ロギングを有効化(第33.4.2.4項「構成のチェック」を参照)したところ、宛先サーバーで次のようなエラー・ログが表示されました。

####<Oct 11, 2010 10:20:31 PM PDT> <Debug> <SecuritySAMLLib> <adc2170966>
<soa_server1> <[ACTIVE] ExecuteThread: '1' for queue:
'weblogic.kernel.Default (self-tuning)'> <<WLS Kernel>> <>
<efaf471a17d5a745:-5ba0524a:12b9b0b7849:-8000-0000000000015385>
<1286860831335> <BEA-000000> <SAMLSignedObject.verify(): validating
signature>
####<Oct 11, 2010 10:20:31 PM PDT> <Debug> <SecuritySAMLService> <adc2170966>
<soa_server1> <[ACTIVE] ExecuteThread: '1' for queue:
'weblogic.kernel.Default (self-tuning)'> <<WLS Kernel>> <>
<efaf471a17d5a745:-5ba0524a:12b9b0b7849:-8000-0000000000015385>
<1286860831336> <BEA-000000> <SAMLDestinationSiteHelper: Signature
verification failed with exception: org.opensaml.InvalidCryptoException:
SAMLSignedObject.verify() failed to validate signature value>
####<Oct 11, 2010 10:20:31 PM PDT> <Debug> <SecuritySAMLService> <adc2170966>
<soa_server1> <[ACTIVE] ExecuteThread: '1' for queue:
'weblogic.kernel.Default (self-tuning)'> <<WLS Kernel>> <>
<efaf471a17d5a745:-5ba0524a:12b9b0b7849:-8000-0000000000015385>
<1286860831336> <BEA-000000> <SAMLDestinationSiteHelper: Unable to validate
response -- returning SC_FORBIDDEN>
####<Oct 11, 2010 10:20:31 PM PDT> <Debug> <SecuritySAMLService> <adc2170966>
<soa_server1> <[ACTIVE] ExecuteThread: '1' for queue:
'weblogic.kernel.Default (self-tuning)'> <<WLS Kernel>> <>
<efaf471a17d5a745:-5ba0524a:12b9b0b7849:-8000-0000000000015385>
<1286860831336> <BEA-000000> <SAMLSingleSignOnService.doACSGet: Failed to get
SAML credentials -- returning>

解決策

SAMLアサーションが検証されていないため、証明書の設定が正しく行われていないことが考えられます。この場合、SAMLアイデンティティ・アサータに適切な証明書が登録されていない可能性があります。WebCenter PortalドメインにSAML SSOを設定したときにcertAliasおよびcertPasswordで指定した証明書をエクスポートして、宛先ドメインでアクセス可能な場所にコピーします。

1. WebCenter Portalドメインのwcsamlsso.propertiesファイルで関連する構成セクションを更新します(たとえば、SOA構成で証明書が無効の場合は、soa_configセクションのcertPathを更新します)。

2. WebLogic Server管理コンソールを開いて、WC_Spacesドメインから「セキュリティ・レルム」→「プロバイダ」→「資格証明マッピング」→「wcsamlcm」→「管理」→「リライイング・パーティ」に移動し、ドメインに関連するリライイング・パーティ(たとえば、SOAの場合は、ワークリスト統合、ワークリスト詳細およびワークリストSDPになります)を削除します。

3. 「宛先ドメイン」→「セキュリティ・レルム」→「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」に移動し、対応するアサーティング・パーティを削除します。

4. 「証明書」タブを開き、証明書も削除します。

5. WebCenter Portalドメインに戻り、アサーティング・パーティとリライイング・パーティの組合せを作成するためスクリプトを再実行します。たとえば、SOAの場合は、次のように再実行する必要があります。

WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureWorklistIntegration.py
WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureWorklistDetail.py
WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureWorklistSDP.py

6. 構成を再度テストします。すべて問題なく機能すれば、SAMLロギングを無効化できます。

30.3.8 偽装セッションがOAM 11.1.2.2.0でエラーを生成する

問題

OAM 11.1.2.2.0での偽装セッションでユーザーを切り替える場合に内部エラーが生成されます。

解決策

次のことを確認してください。

- oam-config.xmlのEnableImpersonationフラグがtrueに設定されています

- OAM 11.1.2.2コンソールで作成した新しいOIDアイデンティティ・ストアにスペースが含まれていません(OracleIdentityStoreではなくOracle Identity Storeなど)

- 新しいアイデンティティ・ストアのUserPassword属性がuserPasswordです

31 アイデンティティ・ストアの構成

この章では、アイデンティティ・ストアを、デフォルトの組込みLDAPアイデンティティ・ストアではなく外部のLDAPと再度関連付ける方法について説明します。また、Oracle WebCenter Content Server用のLDAPサーバーを構成する方法についても説明しますが、内容は次のとおりです。

- 第31.1項「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」

- 第31.2項「外部LDAPアイデンティティ・ストア用のGUID属性の構成」

- 第31.3項「組込みLDAPアイデンティティ・ストアへのユーザーの追加」

- 第31.4項「外部LDAPサーバーへの管理者アカウントの移行」

- 第31.5項「Content ServerとWebCenter Portalでアイデンティティ・ストアLDAPサーバーを共有するための構成」

- 第31.6項「libOVDを使用した複数のアイデンティティ・ストアLDAPサーバーの集約」

- 第31.7項「WebCenter Portalの動的ロールの構成」

- 第31.8項「WebCenter Portalの動的グループの構成」

- 第31.9項「RESTサービス・アイデンティティ・アサータの構成」

注意:
アイデンティティ・ストアを再度関連付ける前に、次の関連する構成ファイルを必ずバックアップしてください。

- config.xml

- jps-config.xml

念のため、ドメインの管理サーバーのboot.propertiesファイルもバックアップしてください。

Portal Frameworkアプリケーションでは「ディスカッション・サーバーの新しい管理者アカウントの識別」の手順が必要でないことに注意してください。アイデンティティ・ストアの詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』を参照してください。

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

31.1 外部LDAPサーバーへのアイデンティティ・ストアの再関連付け

ほとんどの場合、アイデンティティ・ストアは、デフォルトの組込みLDAPは使用せずに、外部LDAPサーバーに再度関連付ける必要があります。多くの様々なタイプのLDAPサーバー(サポートされているLDAPのリストは、『Oracle Platform Security Servicesによるアプリケーションの保護』のサポートされているLDAPアイデンティティ・ストアのタイプに関する項を参照)を使用できますが、この項ではアイデンティティ・ストアを構成してOracle Internet Directory (OID)を使用する方法に重点を置きます。

注意:
外部LDAPサーバーへのアイデンティティ・ストアの再関連付けは、ドキュメントまたはディスカッション・ツールを使用している場合にのみ必須で、その場合はWC_Spacesサーバー、Content Serverおよびコラボレーション・サーバーをすべて同じ外部LDAPサーバーを使用するように構成する必要があります。

サポートされている他のLDAP用のGUID属性は、第31.2項「外部LDAPアイデンティティ・ストア用のGUID属性の構成」を参照してください。サポートされているLDAPサーバー用の他のユーザー属性マッピングは、『Oracle Platform Security Servicesによるアプリケーションの保護』のユーザーとロールAPIリファレンスの付録を参照してください。表「LDAPディレクトリへのユーザー属性のマッピング」に示されているように、すべての属性がWLSに付属する組込みLDAPサーバーを含むすべてのLDAPサーバーで使用できるわけではありません。WebCenter PortalによってサポートされているLDAPのチューニングとパフォーマンスの詳細は、パフォーマンス・チューニング・ガイドのアイデンティティ・ストア構成のチューニングに関する項を参照してください。

注意:
アイデンティティ・ストアの既存のデータベース(つまり、WebCenterをデフォルト構成でインストールする場合に作成されるデフォルトのデータベース・ストアではない)を使用するには、OVDを使用するか、ユーザーおよびロールAPIに基づいてカスタム・プロバイダを書き込む必要があります(『Oracle Platform Security Servicesによるアプリケーションの保護』のカスタム・ユーザーおよびロール・プロバイダの開発に関する項を参照)。LibOVDをデータベース・アイデンティティ・ストアとともに使用しないでください。

注意:
本番環境の外部LDAPアイデンティティ・ストア(OIDなど)を別の外部LDAPストアに再度関連付けすることはサポートされていません。ビジネス要件によりそのような再関連付けを行う場合は、プロセス中にユーザー情報やアーティファクトが失われる可能性があるため、実施前にOracleサポートにご連絡ください。

アイデンティティ・ストアをOIDに再度関連付ける手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます。

3. 「名前」列で、アイデンティティ・ストアを再度関連付けるレルムをクリックします。
「レルムの設定」ペインが表示されます。

4. 「プロバイダ」タブを開きます。
プロバイダの設定ペインが表示されます。

5. 「新規」をクリックして、新しいプロバイダを追加します。
「新しい認証プロバイダの作成」ペインが表示されます。

6. プロバイダの名前を入力します(OIDAuthenticatorなど、Oracle Internet Directoryに対してユーザーを認証するプロバイダの名前)を入力します。

7. LDAPディレクトリに適したオーセンティケータをオーセンティケータのリストから選択します。
一般的なDefaultAuthenticatorを選択するのではなく、構成するLDAPに関連付けられたオーセンティケータを選択してください。たとえば、OIDの場合はOracleInternetDirectoryAuthenticator、iPlanetの場合はIPlanetAuthenticatorを選択します。

8. 「OK」をクリックして、設定を保存します。
設定ペインに新規の認証プロバイダが表示されます。

9. 「認証プロバイダ」のリストで、新しく作成したプロバイダをクリックします。
新規の認証プロバイダの設定ペインが表示されます。

10. 「制御フラグ」をSUFFICIENTに設定します。
「制御フラグ」をSUFFICIENTに設定すると、このオーセンティケータがユーザーを正常に認証できる場合はその認証を受け入れ、それ以上のオーセンティケータを起動しません。

注意:
認証に失敗した場合、その認証は連鎖内の次のオーセンティケータに渡されます。そのため、後続のすべてのオーセンティケータについても、制御フラグがSUFFICIENTに設定されていることを確認します。

11. 「保存」をクリックして、設定を保存します。

12. 「プロバイダ固有」タブを選択して、LDAPサーバーの詳細を入力します。
「プロバイダ固有」ペインが表示されます。

13. 使用するLDAPサーバーに固有の詳細を入力します。

注意:
OIDの場合の適切な値を次の表に示します。Active Directoryなど、他のLDAPの許容値については、『Oracle Platform Security Servicesによるアプリケーションの保護』の付録「OPSSのシステム・プロパティおよび構成プロパティ」を参照してください。

パラメータ

値

説明

ホスト:

LDAPサーバーのサーバーID(例: <ldap_host>example.com)

ポート:

LDAPサーバーのポート番号(例: 3060)

プリンシパル:

LDAPサーバーへの接続に使用されるLDAPユーザーDN(例: cn=orcladmin)

資格証明:

LDAPサーバーへの接続に使用されるパスワード

ユーザー・ベースDN:

ユーザーの基点となるDNを指定します(例: cn=users,dc=example,dc=com)

グループ・ベースDN:

グループ・ノードを示すDNを指定します(例: cn=groups,dc=example,dc=com)

取得したユーザー名をプリンシパルとして使用する

選択

有効にしておく必要があります。

すべてのユーザーのフィルタ:

(&(uid=*)(objectclass=person))

「ユーザー・ベースDN」内のすべてのユーザーを検索するための検索フィルタ

名前指定によるユーザー・フィルタ:

(&(uid=%u)(objectclass=person))

ユーザー名属性:

uid

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

15. 「プロバイダ」タブに戻り、リストの先頭に新しい認証プロバイダ、その次に他のオーセンティケータ、最後にDefaultAuthenticatorが表示されるようにプロバイダを並べ替えます。
すべてのオーセンティケータの制御フラグをSUFFICIENTに設定し、新しいプロバイダからDefaultAuthenticator(デフォルトのファイルベースの組込みLDAPのみで使用)に至るまで、後続のオーセンティケータで渡されたアイデンティティを認証できるようにする必要があります。たとえば、デフォルトの管理者アカウントなどのログインは通常、LDAPディレクトリ内に作成されませんが、サーバーを起動するためには認証が必要です。DefaultAuthenticatorにアイデンティティが渡されない場合、デフォルトの管理者アカウントは認証されません。DefaultAuthenticatorおよびデフォルトの管理者アカウントの詳細は、第31.4項「外部LDAPサーバーへの管理者アカウントの移行」を参照してください。

注意:
複数のオーセンティケータを使用する場合は、REQUIRED制御フラグを使用しないでください。オーセンティケータのリストでREQUIRED制御フラグが見つかった場合、その位置に関係なく、後続のオーセンティケータは調査されません。

16. 変更が有効になるように、管理サーバーと管理対象サーバーを再起動します。

31.2 外部LDAPアイデンティティ・ストア用のGUID属性の構成

この項では、Oracle LDAP以外の実装で使用される様々なGUID属性について説明します。サポートされている他のLDAPサーバーの他のユーザー属性マッピングについては、『Oracle Platform Security Servicesによるアプリケーションの保護』のLDAPディレクトリへのユーザー属性のマッピングに関する項を参照してください。『Oracle Platform Security Servicesによるアプリケーションの保護』のユーザー属性をLDAPディレクトリにマップする方法に関する項も参照してください。

注意:
orclGuid属性を使用しないLDAPアイデンティティ・ストア(IBM Tivoliなど)を使用する場合は、WLSオーセンティケータのGUID属性をマップして、WLSオーセンティケータが自動的に使用されるようにできます。

IBM Tivoli® Directory Server:

ibm-entryUUID

Microsoft® Active Directory:

objectGUID

Active Directoryを使用する場合、samAccountName属性は20文字に制限されます。また、Lotus Connectionsで使用される他のIDは256文字に制限されます。

Microsoft Active Directory Application Mode (ADAM):

objectGUID

objectSIDをADAMのデフォルトとして使用するには、次の行をwimconfig.xmlファイルの<config:attributeConfiguration>セクションに追加します。

<config:externalIdAttributes name="objectSID" syntax="octetString"/>

IBM Domino® Enterprise Server:

dominoUNID

Domino LDAPのバインドIDがDominoディレクトリに対して十分なマネージャ・アクセスができない場合、Virtual Member Manager (VMM)は、Dominoスキーマ問合せに対して正しい属性タイプを返さず、VMM IDとしてDNが返されます。VMMのデフォルトのID設定をオーバーライドするには、wimconfig.xmlファイルの<config:attributeConfiguration>セクションに次の行を追加します。

<config:externalIdAttributes name="dominoUNID"/>

Sun Java™ System Directory Server:

nsuniqueid

eNovell Directory Server:

GUID

31.3 組込みLDAPアイデンティティ・ストアへのユーザーの追加

開発またはテストを目的として、ユーザーを組込みLDAPに追加するには、WebLogic Server管理コンソールを使用するか、またはLDIFファイルとLDAPコマンドを使用します。LDIFファイルを使用すると、WebLogic Server管理コンソールからでは使用できない属性を追加できます。

注意:
組込みLDAPサーバーは、テストや概念実証の目的のみに使用してください。本番用には、Oracle Internet DirectoryやMicrosoft Active Directoryなど、OPSSユーザーおよびロールAPIでサポートされている外部アイデンティティ・ストアを使用することをお薦めします。ユーザーおよびロール属性の詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のLDAPディレクトリへのユーザー属性のマッピングに関する項を参照してください。

Oracle Internet Directoryでは通常、ユーザーはODSMを使用して管理されます(『Oracle Internet Directory管理者ガイド』のディレクトリ・エントリの管理に関する項を参照してください)。

注意:
アイデンティティ・ストアを外部LDAPに再度関連付けする予定がある場合は、再関連付けの手順(第31.1項「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」を参照)を先に実行してください。組込みLDAPをOIDや他の外部LDAP実装に再度関連付けする場合、ユーザーやユーザーのアーティファクトが移行できないことがあるからです。したがって、本番環境にユーザーを移行する場合を除き、組込みLDAPにはユーザーを追加しないでください。組込みLDAPは、テスト環境のみで使用することを目的としており、本番環境への移行が可能なステージング環境で使用することは意図していません。

WebCenter Portalでは自己登録がサポートされます。WebCenter Portalに自己登録した新規ユーザーは、アイデンティティ・ストアに直接追加されます。自己登録の詳細は、第48.11項「自己登録の有効化」を参照してください。

注意:
アイデンティティ・ストアへのユーザーの追加は、一般にシステム管理者のタスクであり、アプリケーションレベルの管理者は必要な権限を持っていてもこのタスクを実行できない場合があります。

この項には次のサブセクションが含まれます:

- 第31.3.1項「WLS管理コンソールを使用したアイデンティティ・ストアへのユーザーの追加」

- 第31.3.2項「LDIFファイルを使用したアイデンティティ・ストアへのユーザーの追加」

31.3.1 WLS管理コンソールを使用したアイデンティティ・ストアへのユーザーの追加

WebLogic Server管理コンソールから組込みLDAPアイデンティティ・ストアにユーザーを追加するには:

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます。

3. 「名前」列で、ユーザーを追加するレルムをクリックします。
「レルムの設定」ペインが表示されます。

4. 「ユーザーとグループ」タブをクリックし、現行ユーザーのリストを表示します。

5. 「新規」をクリックして、新しいユーザーを追加します。

6. 「新しいユーザーの作成」ページで、「名前」フィールドに新しいユーザーのログイン名を入力します。
ユーザー名では大/小文字が区別されます。また、ユーザー名は一意である必要があります。カンマ、タブ、および次のカンマ区切りリスト内のその他の文字は使用しないでください。

< >、#、|、&、?、( )、{ }

7. 「説明」フィールドに、ユーザーの説明(たとえば、ユーザーのフル・ネーム)を入力します。

8. 「プロバイダ」ドロップダウン・メニューからDefaultAuthenticatorを選択します。

9. 「パスワード」フィールドに、ユーザーのパスワードを入力します。
WebLogic認証プロバイダで定義されたユーザーのパスワードの最低限の長さは8文字です(他のLDAPプロバイダではパスワード長の要件が異なる場合があります)。本番環境では、weblogic/weblogicのようなユーザー名とパスワードの組合せは使用しないでください。

10. 「パスワードの確認」フィールドにパスワードを再入力します。

11. 「OK」をクリックして変更を保存し、ユーザーを追加します。
追加したユーザーがユーザー・リストに表示されます。

31.3.2 LDIFファイルを使用したアイデンティティ・ストアへのユーザーの追加

LDIFファイルを使用して組込みLDAPアイデンティティ・ストアにユーザーを直接追加する手順は次のとおりです。LDIFファイルを使用すると、WebLogic Server管理コンソールからは使用できない追加のユーザー属性を指定できます。組込みLDAPサーバーはLDAPに準拠したサーバーであるため、LDAPコマンドを使用してユーザーの追加や変更ができます。また、ディレクトリを検索することもできます。これは、ユーザー・アカウントをエクスポートおよびインポートする場合に役立ちます。

LDIFファイルを使用して組込みLDAPにユーザーを追加するには、次のタスクを実行する必要があります。

- 外部LDAPアクセスの有効化

- LDIFファイルの作成

- ユーザーの追加

外部LDAPアクセスの有効化

LDAPアクセス資格証明は、WebLogic Serverのインストール時にランダム値として設定され、config.xmlファイルに暗号化されます。外部LDAPアクセスを有効にするには、組込みLDAPのアクセス資格証明をリセットする必要があります。

組込みLDAPのアクセス資格証明をリセットする手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、wc_domainをクリックします。

3. wc_domainの「設定」ペインで「セキュリティ」タブをクリックし、「組込みLDAP」タブをクリックします。
wc_domainの「設定」ペインに組込みLDAP設定が表示されます。

4. 「資格証明」フィールドに新しいパスワードを入力し、「資格証明の確認」フィールドに再度入力します。

5. 「保存」をクリックして、設定を保存します。

6. WebLogicサーバーを再起動します。
これを行った後は、次の値を使用してLDAPサーバーにアクセスできるようになります。

- 管理アクセスのDN値は"cn=Admin"です。

- パスワードは「資格証明」フィールドに入力した値です。

- ポートは管理ポートと同じポート(デフォルトは7001)です。

LDIFファイルの作成

LDIFファイルは任意のテキスト・エディタで作成できます。また、LDIFファイルには、組込みLDAPディレクトリに該当する任意の属性を含めることができます。WebLogic Serverの組込みLDAPサーバーのデフォルトでサポートされているobjectclassesは次のとおりです。

- person

- inetOrgPerson

- organizationalPerson

- wlsUser

組込みLDAPサーバーと正常に対話するには、ディレクトリ情報ツリー(DIT)のデフォルト・レイアウトを理解しておく必要があります。組込みLDAPディレクトリのデフォルト・レイアウトを図31-1に示します。

図31-1 組込みLDAPのディレクトリ情報ツリー

注意:
組込みLDAPのディレクトリ・ツリーでは、ユーザー・エントリのネーミング属性は「uid」です。これは、Oracle Internet Directory (OID)のデフォルトの構成(ネーミング属性は「cn」)とは異なります。また、このツリーにおけるユーザーの場所は「ou=people,ou=myrealm,dc=wc_domain」です。

次の例は、WebCenter Portalユーザー・プロファイルの画面に表示される属性が指定されたLDIFファイルを示しています。

dn: uid=john.doe,ou=people,ou=myrealm,dc=wc_domain
description: John Doe
cn: john.doe
uid: john.doe
sn: Doe
objectclass: wlsUser
objectclass: organizationalperson
objectclass: inetOrgPerson
objectclass: person
objectclass: top
userpassword: MyPassword
displayName: John Doe
employeeNumber: 12345
employeeType: Regular
givenName: John
homePhone: 650-555-1212
mail: john.doe@example.com
title: Manager
manager: uid=mary.jones,ou=people,ou=myrealm,dc=wc_domain
preferredLanguage: en
departmentNumber: tools
facsimiletelephonenumber: 650-555-1200
mobile: 650-500-1200
pager: 650-400-1200
telephoneNumber: 650-506-1212
postaladdress: 200 Oracle Parkway
l: Redwood Shores
homepostaladdress: 123 Main St., Anytown 12345

複数のユーザー・エントリを含むファイルを作成するには、前述の行を必要な回数だけレプリケートし、エントリ間に空白行を入れます。

注意:
WebCenter Portalのユーザー・プロファイルには、Oracle Internet Directoryのみで使用可能な属性が含まれます。これには、orclUserV2オブジェクト・クラスの次の属性があります。

- orclTimeZone

- orclDateOfBirth

- maidenName

これらの属性は、組込みLDAPアイデンティティ・ストアには追加できません。

ユーザーの追加

次の例では、ldappaddコマンドを使用しています。このコマンドは、Oracle Internet Directoryサーバーに付属のLDAPコマンド行ユーティリティに含まれます。ldappaddコマンドの使用の詳細は、『Oracle Identity Managementリファレンス』のOracle Internet Directoryデータ管理ツールに関する項を参照してください。WebCenter PortalおよびPortal FrameworkアプリケーションでサポートされるLDAPサーバーのユーザー属性マッピングの全リストは、『Oracle Platform Security Servicesによるアプリケーションの保護』のLDAPディレクトリへのユーザー属性のマッピングに関する項を参照してください。

ldapadd -h weblogichost.example.com -p 7001 -D cn=Admin -w password -v -f newuser.ldif

add description:
John Doe
add cn:
john.doe
add uid:
john.doe
add sn:
Doe
add objectclass:
wlsUser
organizationalperson
inetOrgPerson
person
top
add userpassword:
password
add displayname:
John Doe
add employeenumber:
12345
add employeetype:
Regular
add givenname:
John
add homephone:
650-555-1212
add mail:
john.doe@example.com
add title:
Manager
add manager:
uid=mary.jones,ou=people,ou=myrealm,dc=wc_domain
add preferredlanguage:
en
add departmentnumber:
tools
add facsimiletelephonenumber:
650-555-1200
add mobile:
650-500-1200
add pager:
650-400-1200
add telephonenumber:
650-506-1212
add postaladdress:
200 Oracle Parkway
add l:
Redwood Shores
add homepostaladdress:
123 Main St., Anytown 12345
adding new entry uid=john.doe,ou=people,ou=myrealm,dc=wc_domain
modify complete

31.4 外部LDAPサーバーへの管理者アカウントの移行

外部LDAPサーバーを使用するようにドメインを構成する場合、必要に応じてシステム管理者アカウント(デフォルトではweblogic)をLDAPサーバーに移行することもできます。

システム管理者アカウントまたはLDAP内の他の適切なユーザーが「管理者」というLDAPグループに属する場合、このアカウントは、サーバーを管理するための権限を満たしています。また、DefaultAuthenticatorプロバイダを認証プロバイダのリストから削除できます。この場合、すべてのユーザー(管理者アカウントを含む)は外部LDAPに対して認証されます。

注意:
WebCenter Portalは、最初のオーセンティケータによってマップされたアイデンティティ・ストア内のユーザーのみを認識します。WebCenter Portal管理者アカウントは当初は組込みのLDAPサーバーにのみ作成されるため、Oracle Internet Directoryなどの外部LDAPをWebCenter Portalのプライマリ・オーセンティケータとして構成する場合は、そのLDAP内にユーザーを作成し、そのユーザーにWebCenter Portal管理者ロールを付与する必要もあります。WebCenter Portal管理者ロールのユーザーへの付与の詳細は、第32.5.1項「WebCenter Portal管理者ロールの付与」を参照してください。

weblogic(デフォルト)ユーザーを外部LDAPディレクトリに作成できない場合は、2つのオプションがあります。次を実行できます。

- DefaultAuthenticatorプロバイダを維持したまま、weblogicアカウントとローカルの組込みLDAPサーバーをWebLogic Serverで使用し、WebLogic Server管理コンソールからサーバーの起動と停止および他の管理者用操作を行います。DefaultAuthenticatorを維持する場合は、DefaultAuthenticationプロバイダの制御フラグがSUFFICIENTに設定されていることを確認してください。このオプションを選択する場合、第31.4.1項「ディスカッション・サーバーの新しい管理者アカウントの識別」に示されている追加の手順を実行する必要もあります。

注意:
DefaultAuthenticatorからweblogicユーザー・アカウントを使用する場合は、WebCenter Portalにアクセスする際にこのアカウントを使用しないでください。アプリケーション・コードから外部LDAPストアのユーザーを検索できなくなります。

- DefaultAuthenticatorを削除し、管理者用操作(サーバーの起動や停止など)で使用する有効なユーザー・アカウントを「管理者」グループに含めます。その他の名前のグループに含める場合は、そのグループにOIDまたは他の外部LDAPでドメインの管理を許可されたユーザーのリストが含まれている必要があります。「管理者」以外の名前を使用する場合は、WebLogic Serverグローバル管理者ロールの定義でグループ名を更新する必要があります。デフォルトでは、これは「管理者」というエンタープライズ・グループのメンバーシップとして定義されています。管理者グループ名の変更の詳細は、第31.4.2項「管理者グループ名の変更」を参照してください。

この項には次のサブセクションが含まれます:

- 第31.4.1項「ディスカッション・サーバーの新しい管理者アカウントの識別」

- 第31.4.2項「管理者グループ名の変更」

31.4.1 ディスカッション・サーバーの新しい管理者アカウントの識別

ディスカッション・サーバーをインストールしており、管理者アカウントを外部LDAPに移行しない場合(第31.4項「外部LDAPサーバーへの管理者アカウントの移行」を参照)、WebLogic Serverでオーセンティケータの順序を変更する前に、ディスカッション・サーバーで新しい管理者アカウントを識別するために追加の手順を実行する必要があります。

1. ディスカッション・サーバーの管理者にするユーザー・アカウントを外部LDAPから選択します。

2. 外部LDAPから選択したユーザー・アカウントに一致する管理者アカウントをDefaultAuthenticator(組込みLDAP)に作成します。組込みLDAPと外部LDAPサーバーのアカウント名は一致する必要があります。
組込みLDAPへのユーザーの追加の詳細は、第31.3項「組込みLDAPアイデンティティ・ストアへのユーザーの追加」を参照してください。

3. ディスカッション・サーバー管理コンソールに起動アイデンティティ・アカウント(weblogic)でログインし、次にアクセスします。

http://host:port/owc_discussions/admin

hostとportはWLS_Services管理対象サーバーのホストIDとポート番号です。

4. 「設定」→「管理者/モデレータ」をクリックします。
「管理者およびモデレータ」ページが表示されます(図31-2を参照)。

図31-2 「管理者およびモデレータ」ページ

5. 「新規権限の付与」をクリックします。
「新規権限の付与」ペインが表示されます(図31-3を参照)。

図31-3 「新規権限の付与」ペイン

6. 作成したユーザーにシステム管理者権限を付与します(図31-4を参照)。

図31-4 「新規権限の付与」ペインでの新規ユーザーの入力

7. 「システム」→「システム・プロパティ」をクリックします。
「Jiveプロパティ」ページが表示されます(図31-5を参照)。

図31-5 「Jiveプロパティ」ページ

8. 赤でマークされたプロパティが追加され、図31-5のように設定されていることを確認します。

9. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

10. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます。

11. 「名前」列で、管理者グループ名を変更するレルムをクリックします。
「レルムの設定」ペインが表示されます。

12. 「プロバイダ」タブを選択し、「認証」サブタブを選択したら、外部LDAPのオーセンティケータがリストの先頭に表示されるように認証プロバイダの順序を変更します(図31-6の例を参照)。

図31-6 認証プロバイダの順序変更後の「プロバイダ」タブ

13. ドメインの管理サーバーとディスカッション・サーバーを再起動します。

14. まだ実行していない場合は、外部LDAP内にユーザーを作成し、そのユーザーにWebCenter Portal管理者ロールを付与する必要があります(第32.5.1項「WebCenter Portal管理者ロールの付与」を参照)。

31.4.2 管理者グループ名の変更

LDAPサーバーにドメインの管理権限を持つユーザーが含まれる場合、そのサーバーで有効な他のエンタープライズ・ロールにグループ名を変更できます。これにより、エンタープライズ内で特定のドメインの管理を委任できます。様々な管理グループをディレクトリに作成し、対応するドメインで管理者を定義する際に適切なグループが使用されるよう構成できます。

次の例のLDIFファイルでは、Oracle Internet Directoryに管理グループを作成します。

dn: cn=wc_domain_Admin,cn=groups,dc=example,dc=com
cn: wc_domain_Admin
uniquemember: cn=joe.admin,cn=users,dc=example,dc=com
owner: cn=orcladmin
displayname: WebLogic Administrators Group
description: WebLogic Administrators Group
objectclass: orclgroup
objectclass: groupofuniquenames

このグループの作成後に、WebLogic Server管理コンソールを使用してWebLogic Serverグローバル管理ロールのロール定義を更新する必要があります。

WebLogic Serverグローバル管理ロールのロール定義を更新する手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます。

3. 「名前」列で、管理者グループ名を変更するレルムをクリックします。
「レルムの設定」ペインが表示されます。

4. 「ロールとポリシー」タブを開き、「レルム・ロール」サブタブを開きます。
「レルム・ロール」設定ペインが表示されます。

5. 「グローバル・ロール」ノードを開き、「ロール」ノードを開きます。

6. Adminロールの「ロール条件の表示」をクリックします。
「グローバル・ロールの編集」ページが表示されます。

デフォルトでは、Oracle Internet Directory(または他の構成済アイデンティティ・ストア)のAdministratorsグループにはWebLogic Serverで管理者ロールを持つユーザーが定義されています。

7. 「条件の追加」をクリックして、別のグループ名を追加します。
「グローバル・ロールの編集」ページに「述部リスト」が表示されます。

8. 「述部リスト」からGroupを選択し、「次へ」をクリックします。
「グローバル・ロールの編集」ページに「引数」が表示されます。

9. 新規管理者グループの名前を入力して、「追加」をクリックします。

10. 選択した新規管理者グループを残したまま既存の管理者グループを削除するには、そのグループを選択して「削除」をクリックします。

11. 「終了」をクリックして、変更を保存します。
この変更を行うと、指定した新規グループのすべてのメンバーにWebLogic Serverの管理権限が付与されます。

31.5 Content ServerとWebCenter Portalでアイデンティティ・ストアLDAPサーバーを共有するための構成

Oracle WebCenter Content Serverは、WebCenter Portalと同じアイデンティティ・ストアLDAPサーバーを使用するように構成する必要があります。Content Serverの構成の詳細は、第9章「コンテンツ・リポジトリの管理」を参照し、『Oracle Platform Security Servicesによるアプリケーションの保護』のLDAPアイデンティティ・ストア・サービスの構成に関する項も参照してください。

31.6 libOVDを使用した複数のアイデンティティ・ストアLDAPサーバーの集約

複数のアイデンティティ・ストアを使用するサイトでは、libOVDを使用することによりユーザー・プロファイル情報を集約できます。次の2つのシナリオの構成手順を説明します。

- それぞれに完全なユーザー・プロファイル情報が存在する個別のアイデンティティ・ストアでユーザーを有効にする場合。

- それぞれに部分的な属性が存在する2つのアイデンティティ・ストアで同一ユーザーを有効にする場合。

注意:
Active Directoryによる自己登録をサポートする場合は、第30.3.3項「Active Directoryを使用してWebCenter Portalを構成するとユーザーが自己登録できない」に記載されているトラブルシューティングを必ず参照してください。

この項には次のサブセクションが含まれます:

- 第31.6.1項「アイデンティティ・ストアに完全なユーザー・プロファイルが存在する場合のlibOVDの構成」

- 第31.6.2項「アイデンティティ・ストアに部分的なユーザー・プロファイルが存在する場合のlibOVDの構成」

- 第31.6.3項「単一オーセンティケータの復元」

31.6.1 アイデンティティ・ストアに完全なユーザー・プロファイルが存在する場合のlibOVDの構成

各アイデンティティ・ストアに完全なユーザー・プロファイルが存在する場合にlibOVDを構成する手順は次のとおりです。

1. 構成するアイデンティティ・ストアのWLS管理コンソールで必要なオーセンティケータを作成し、ドメインのWeblogic管理サーバーおよび管理対象サーバーを再起動します。または、jps-config.xmlでアイデンティティ・ストア情報を手動で構成することもできます。

2. アイデンティティ・ストア・サービス・インスタンスをjps-config.xmlで更新し、値がtrueであるvirtualizeプロパティおよびOPTIMIZE_SEARCHプロパティを追加します。これは手動でjps-config.xmlファイルを編集するか、Fusion Middleware Controlを使用して実行できます。

注意:
検索パフォーマンスを最適化するには、WLS認証済プロバイダのデフォルト・タイムアウト設定を増やすこともできます。OIDの例の設定を次に示します。

OID Authenticator->Provider Specific:
Connection Pool Size: 50
Connection Timeout: 30
Results time Limit: 10000            (=10 secs)
Cache Size: 5120                     (=5Mb or 10Mb)
Cache TTL = 7200                     (=2h)
OID Authenticator->Performance:
Max Group Hierarchies In Cache: 1000
Group Hierarchy Cache TTL: 7200      (=2h)

3. WebCenter Portalを使用すると、ユーザーは自己登録が可能です。これにより、新しいユーザーまたはグループがアイデンティティ・ストアに作成されます。複数のアイデンティティ・ストアが使用されるため、ユーザー作成ベースおよびグループ作成ベースをjps-config.xmlで明示的に指定する必要があります。この手順は、jps-config.xmlを直接編集して行う必要があります。
構成後のjps-config.xmlファイルは、次の例のようになります。

<serviceInstance provider="idstore.ldap.provider" name="idstore.ldap">
<property value="oracle.security.jps.wls.internal.idstore.WlsLdapIdStoreConfigProvider"
name="idstore.config.provider"/>
<property value="oracle.security.idm.providers.stdldap.JNDIPool"
name="CONNECTION_POOL_CLASS"/>
<property value="true" name="virtualize"/>
<property value="true" name="OPTIMIZE_SEARCH"/>

<extendedProperty>
<name>user.create.bases</name>
<values>
<value>ou=people,ou=myrealm,dc=wc_domain</value>
</values>
</extendedProperty>
<extendedProperty>
<name>group.create.bases</name>
<values>
<value>ou=groups,ou=myrealm,dc=wc_domain</value>
</values>
</extendedProperty>
</serviceInstance>

ユーザー作成ベース「ou=people,ou=myrealm,dc=wc_domain」およびグループ作成ベース「ou=groups,ou=myrealm,dc=wc_domain」は実際の値に置き換えてください。

31.6.2 アイデンティティ・ストアに部分的なユーザー・プロファイルが存在する場合のlibOVDの構成

各アイデンティティ・ストアに部分的なユーザー・プロファイルのみが存在する場合にlibOVDを構成するには:

1. 構成するアイデンティティ・ストアのWLS管理コンソールで必要なオーセンティケータを作成し、ドメインのWeblogic管理サーバーおよび管理対象サーバーを再起動します。または、jps-config.xmlでアイデンティティ・ストア情報を手動で構成することもできます。

2. アイデンティティ・ストア・サービス・インスタンスをjps-config.xmlで更新し、値がtrueであるvirtualizeプロパティおよびOPTIMIZE_SEARCHプロパティを追加します。これは手動でjps-config.xmlファイルを編集するか、Fusion Middleware Controlを使用して実行できます。

注意:
検索パフォーマンスを最適化するには、WLS認証済プロバイダのデフォルト・タイムアウト設定を増やすこともできます。OIDの例の設定を次に示します。

OID Authenticator->Provider Specific:
Connection Pool Size: 50
Connection Timeout: 30
Results time Limit: 10000            (=10 secs)
Cache Size: 5120                     (=5Mb or 10Mb)
Cache TTL = 7200                     (=2h)
OID Authenticator->Performance:
Max Group Hierarchies In Cache: 1000
Group Hierarchy Cache TTL: 7200      (=2h)

3. WebCenter Portalを使用すると、ユーザーは自己登録が可能です。これにより、新しいユーザーまたはグループがアイデンティティ・ストアに作成されます。複数のアイデンティティ・ストアが使用されるため、ユーザー作成ベースおよびグループ作成ベースをjps-config.xmlで明示的に指定する必要があります。この手順は、jps-config.xmlを直接編集して行う必要があります。
構成後のjps-config.xmlファイルは、次の例のようになります。

<serviceInstance provider="idstore.ldap.provider" name="idstore.ldap">
<property value="oracle.security.jps.wls.internal.idstore.WlsLdapIdStoreConfigProvider"
name="idstore.config.provider"/>
<property value="oracle.security.idm.providers.stdldap.JNDIPool"
name="CONNECTION_POOL_CLASS"/>
<property value="true" name="virtualize"/>
<property value="true" name="OPTIMIZE_SEARCH"/>

<extendedProperty>
<name>user.create.bases</name>
<values>
<value>ou=people,ou=myrealm,dc=wc_domain</value>
</values>
</extendedProperty>
<extendedProperty>
<name>group.create.bases</name>
<values>
<value>ou=groups,ou=myrealm,dc=wc_domain</value>
</values>
</extendedProperty>
</serviceInstance>

前述の例の「ou=people,ou=myrealm,dc=wc_domain」および「ou=groups,ou=myrealm,dc=wc_domain」はそれぞれ、ユーザー作成ベースとグループ作成ベースです。構成時には実際の値に置き換えてください。

4. 次のOVD WLSTコマンドを実行して、アイデンティティ・ストアの結合アダプタを構成します。MW_HOME/oracle_common/common/binに移動してwlst.sh(Windowsの場合はwlst.cmd)を起動すると、WLSTプロンプトが表示されます。Weblogic管理サーバーに接続して、次のWLSTコマンドを実行します。

createJoinAdapter(adapterName="<Join Adapter Name>",  root="<Namespace>", primaryAdapter="<Primary adapter Name>")

addJoinRule(adapterName="<Join Adapter Name>", secondary="<Secondary Adapter Name>", condition="<Join Condition>")

他にもセカンダリ・アイデンティティ・ストアがある場合は、それぞれのセカンダリ・アイデンティティ・ストアに対してaddJoinRuleコマンドを実行します。

modifyLDAPAdapter(adapterName="<AuthenticatorName>", attribute="Visible", value="Internal")

構成した各アイデンティティ・ストアに対して前述のmodifyLDAPAdapterコマンドを実行します。

例

オーセンティケータ1:

この例では、それぞれに部分的な属性が存在する2つのアイデンティティ・ストアで、同じユーザーが有効になります。たとえば、ADがプライマリ・ストアで、OIDがセカンダリ・ストアです。

オーセンティケータ名: AD

ユーザー・ベース: cn=users,dc=acme,dc=com

オーセンティケータ2:

オーセンティケータ名: OID

ユーザー・ベース: cn=users,dc=oid,dc=com

プライマリ・アダプタのネームスペースに対応するuser.create.basesとgroup.create.basesを指定して、前述の手順1から3を実行します。

次のWLSTコマンドを実行します。

createJoinAdapter(adapterName="JoinAdapter1", root="dc=acme,dc=com", primaryAdapter="AD")
addJoinRule(adapterName="JoinAdapter1", secondary="OID", condition="uid=cn")

"「uid=cn」は前述の例の結合条件です。これは、セカンダリ・アイデンティティ・ストア(OID)のユーザーのuid値とプライマリ・アイデンティティ・ストア(AD)のユーザーのcn値が一致した場合に、属性が結合されることを示します。

modifyLDAPAdapter(adapterName="OID", attribute="Visible", value="Internal")
modifyLDAPAdapter(adapterName="AD", attribute="Visible", value="Internal")

WebLogic管理サーバーと管理対象サーバーを再起動します。

31.6.3 単一オーセンティケータの復元

単一オーセンティケータを復元するには結合アダプタ・ルールを削除します。これにより、第31.6.2項「アイデンティティ・ストアに部分的なユーザー・プロファイルが含まれる場合のlibOVDの構成」で実行した構成が取り消されます。

結合アダプタ・ルールを削除するには、Weblogic管理サーバーに接続して、次のWLSTコマンドを実行します。

deleteAdapter(adapterName="JoinAdapter1")
modifyLDAPAdapter(adapterName="oid auth", attribute="Visible", value="Yes")
modifyLDAPAdapter(adapterName="AD", attribute="Visible", value="Yes")

WebLogic管理サーバーと管理対象サーバーを再起動し、両方のアイデンティティ・ストアのユーザーがログインできることを確認します。

31.7 WebCenter Portalの動的ロールの構成

この項では、動的ロールをWebCenter Portal向けに構成する方法を説明します。

この項には次のサブセクションが含まれます:

- 第31.7.1項「動的ロールの構成の概要」

- 第31.7.2項「動的ロールの構成の前提条件」

- 第31.7.3項「OVDプラグインのインストール」

- 第31.7.4項「動的ロールの構成」

31.7.1 動的ロールの構成の概要

静的ロールの場合、メンバーシップ・リレーションシップに対するロールは静的です。このリレーションシップはプロビジョニング時に確立され、確立後にユーザーがログインすると、そのユーザーが直接的なメンバーであるロール、またはエンタープライズ・グループに基づいた間接的なメンバーであるロールがすべてサブジェクトに移入されます。

動的ロールはルールベースのロール・メンバーシップを提供します。アプリケーション・ロールへのメンバーシップは動的グループを介して提供されます。動的グループの定義にはユーザー・プロファイル属性の制約と日時を含めることができます。これによりアプリケーションへの柔軟なアクセスが可能になります。たとえば、移行時やメンテナンス期間中のみに、アプリケーションに対してユーザーがアクセスできるようにすることができます。その際、ユーザーに対して明示的にアクセス権を付与する必要はありません。セッション属性またはリクエスト属性に基づくルールは、このリリースではサポートされていません。

Oracle Entitlement Server (OES) 10gでは、制約付きのロールとして動的ロールを定義できます。OESで定義されたロールは、OVDプラグインを通してユーザーのエンタープライズ・グループ・プリンシパルに追加されます。ユーザーがポリシー・ルールにログインする際には、ユーザーのサブジェクトが動的グループ・プリンシパルを取得するかどうかを決定するためにポリシー・ルールが評価されます。図31-7に、OESとOVDプラグインで構成されたトポロジのログイン・プロセスを示します。

図31-7 ログイン・プロセス

図31-8に、OESとOVDプラグインで構成されたトポロジの動的グループ問合せで行われる処理を示します。

図31-8 グループ問合せ

31.7.2 動的ロールの構成の前提条件

OVDプラグインをインストールして構成する前に、Oracle Internet Directory(OID)、Oracle Virtual Directory(OVD) 11gおよびOracle Entitlement Server (OES) 10gをインストールして構成しておく必要があります。現時点で、OVDプラグインはOES 11gでは動作保証されていません。

OIDおよびOVDはOracle Identity Management 11gスイートの一部です。まだインストールしていない場合、『Oracle Identity Managementインストレーション・ガイド』のOracle Identity Management (11.1.1.9.0)のインストールおよび構成に関する項の説明に従ってインストールします。『Oracle Identity Managementインストレーション・ガイド』のOracle Virtual Directoryの構成に関する項の説明に従って、config.shを実行してOVDを構成します。

RMI-SSMと最新の累積パッチを使用してOES 10gをインストールします(SSMのインストールおよび構成ガイドのリモートSSMとプロキシの構成に関する項を参照)。

また、WebCenter Portalのパーソナライズに基づいて制約を組み込む予定がある場合は、第25項「パーソナライズの管理」の説明に従って、パーソナライズ・サーバーのインストールと構成も行う必要があります。

31.7.3 OVDプラグインのインストール

Oracle Virtual Directory(OVD)はOracle Identity Management製品スイートの一部です。OVDを使用すると、複数の異機種間データ・ソースは、WebCenter PortalまたはPortal FrameworkアプリケーションのLDAPクライアントから使用可能な1つの統合ビューとして提供されるため、これらのデータ・ソースの統合に関する問題を簡単に解決できます。OVDを経由することにより、WebCenter PortalまたはPortal Frameworkアプリケーションが使用できる方法でOVDカスタム・アダプタを使用して、OESのデータを公開できます。このアダプタは、LDAP以外のデータをLDAPのようなツリー構造で表現できます。カスタム・アダプタの機能は、アダプタにアタッチ可能なプラグインに含まれています。

OVDプラグインをインストールする手順は次のとおりです。

1. 次のフォルダでoes-ovd-plugin.zipファイルを探します。
WCP_HOME/modules/oracle.webcenter.framework_11.1.1/oes-ovd-plugin.zip

2. oes-ovd-plugin.zipファイルのコピーを作成します。

3. OVDをインストールしたplugins/libディレクトリ(例: asinst_1/OVD/ovd1/plugins/lib)に移動します。

4. oes-ovd-plugin.zipファイルを解凍します。

5. webcenterNames.xmlをインスタンス・ホーム(例: ORACLE_HOME/asinst_1)にコピーします。

6. 次のディレクトリを作成します。

mkdir pdpproxy
mkdir keys

7. OESの次のjarをOES/rmi-ssmインストール・ディレクトリからlibディレクトリにコピーします。

EccpressoCore.jar
antlr.jar
api.jar
asi_classes.jar
asitools.jar
commons-pool-1.3.jar
connector.jar
framework.jar
jsafeFIPS.jar
jsafeJCEFIPS.jar
kodo-runtime.jar
log4j.jar
managementapi.jar
orawsdl14.jar
rmi-ssm.jar
rmi-stubs.jar
rmi-types.jar
ssladapter.jar
sslplus.jar
webservice.jar
webserviceclient.jar
webservices.jar
xbean.jar

8. 作成したkeysディレクトリに移動し、このディレクトリにOESインストール(ales32-shared/keysディレクトリ)のすべてのキーをコピーします。

9. 作成したpdpproxyディレクトリに移動し、PDP構成プロパティ・ファイルをOES (rmi-ssm/pdpproxy/PDPProxyConfiguration.properties)からコピーします。

10. 次のコマンドを使用してOVDプロセスを再起動します。

./opmnctl stopall startall

11. 制約を定義する際にパーソナライズを使用する場合は、次のようにp13nattributeRetrieverをインストールします。

1. <WebCenter Home>/webcenter/modules/oracle.webcenter.framework_11.1.1/attribute-retriever.jarファイルを見つけます。

2. OESインストールのrmi-ssm/lib/providersディレクトリを見つけて、そのディレクトリにattribute-retriever.jarファイルをコピーします。

3. rmi-ssmを再起動します。

31.7.4 動的ロールの構成

この項では、OESおよびOVDプラグインを使用して動的ロールをサポートするように、WebCenter Portal環境を構成する方法について説明します。この項の構成手順を実行する前に、前提条件のアプリケーション(第31.7.2項「動的ロールの構成の前提条件」を参照)とOVDプラグイン(第31.7.3項「OVDプラグインのインストール」を参照)をインストールしておく必要があります。

この項には次のサブセクションが含まれます:

- 第31.7.4.1項「OESの構成」

- 第31.7.4.2項「OVDプラグインの構成」

- 第31.7.4.3項「パーソナライズ属性の構成」

- 第31.7.4.4項「WebCenter Portalで動的ロールを使用するための構成」

31.7.4.1 OESの構成

WebCenter Portalで使用する動的ロールはすべて、単一のアンブレラ・リソースとアクションに定義する必要があります。次の手順では、WebCenterApp/WebCenterResourceをアンブレラ・リソース、browseをアクションとして使用します。動的ロールを作成すると、そのロールにはロール・マッピング・ポリシーによってリソースへの参照権限が付与されます。ロール・マッピング・ポリシーには、アイデンティティ・ストアまたはパーソナライズ属性に基づいて制約を追加することもできます。

動的グループにOESを構成するには:

1. ブラウザを開いて、管理者としてOESコンソールにログオンします。

https://<host>:<port>/asi

2. 「Administration Console」ノードで「Resources」をクリックすると、現在定義されているリソースのリストが「Resources」ページに表示されます(図31-9を参照)。

図31-9 「Resources」ページ

3. リソース・ルートを作成するには、javaapi_appノードを右クリックして「Add Resource」を選択し、「Create Resource」ダイアログを表示します。リソースの名前にWebCenterAppと入力し、「Type」でBindingを選択します(図31-10を参照)。

図31-10 ルート・リソースの作成

4. WebCenterAppを右クリックして、その下にWebCenterResourceという名前の新しいリソースを作成し、「Type」でResourceを選択します(図31-11を参照)。

図31-11 リソースの作成

5. 「Resources」ノードの下で「Privileges」をクリックし、「Privileges」ページを表示します。

6. 「New」をクリックしてbrowseという名前のアクションを作成します(図31-12を参照)。

図31-12 アクションの作成

7. 「Identity」ノードを開き、「Roles」をクリックして「Roles」ページを表示します。

8. 「New」をクリックし、「Create Role」ダイアログを使用して動的ロールを作成します(図31-13を参照)。

図31-13 動的ロールの作成

9. 「Resources」ノードを開き、「Attributes」をクリックして「Resource Attributes」ページを表示します。

10. 「New」をクリックし、「Create Resource Attribute」ダイアログで、制約で使用されるアイデンティティ・ストア属性と同じ名前のリソース属性(例: business_email、timezone)を作成します(図31-14を参照)。制約でパーソナライズ属性を使用する場合は、それらの属性も作成する必要があります。ロール・マッピング・ポリシーで制約として使用する属性を、アイデンティティ・ストア内で空にはできません。

図31-14 リソース属性の作成

11. 「Policy」ノードを開き、「Role Mapping Policies」をクリックして「Role Mapping Policies」ページを表示します。

12. 「New」をクリックして「Create Role Mapping Policy」ダイアログを表示し、アイデンティティ・ストア属性または組込みシステム属性(hour、dayなど)を使用してロール・マッピング・ポリシーと制約を作成します(図31-15を参照)。

図31-15 ロール・マッピング・ポリシーの作成

13. 「Policy」ノードの下で、「Authorization Policies」をクリックして「Authorization Policies」ページを表示します。

14. 「New」をクリックし、「Create Authorization Policies」ダイアログを使用して新しい認可ポリシーを作成するか、認可ポリシーのサマリーからポリシーを選択して「Edit」をクリックし、ポリシーのリソースやポリシー・サブジェクトなどの詳細を編集および入力します(図31-16を参照)。

図31-16 認可ポリシーの作成

15. 「Service Control Managers」の下で「Authorization」ノードを開き、「ASIAuthorizationProvider」をクリックしてから「Attribute Retrievers」タブを開きます(図31-17を参照)。

図31-17 「Attribute Retrievers」タブ

16. 「Configure a new Custom Attribute Retriever」をクリックし、WebCenterP13nAttributeRetriever (oracle.webcenter.security.internal.plugins.oes.attributeretriever.WebCenterP13nAttributeRetriever)という名前のカスタム属性リトリーバを作成して、図31-18のようにクラスの詳細を追加します。

図31-18 カスタム属性リトリーバの作成

17. 「Service Control Managers」の下で「Role Mapping」ノードを開き、「ASIRoleMapperProvider」をクリックして「Bindings」タブを開きます。WebCenterAppリソースを認可プロバイダにバインドします(図31-19を参照)。

図31-19 認可プロバイダへのリソースのバインド

18. 「Deployment」をクリックし、「Configuration」タブを開いて構成の変更を配布します(図31-20を参照)。

図31-20 構成の変更の配布

19. 「Policy」タブを開いて、ポリシーの変更を配布します(図31-21を参照)。

図31-21 ポリシーの変更の配布

31.7.4.2 OVDプラグインの構成

この項では、OVDプラグインの構成方法について説明します。

OVDプラグインを構成するには:

1. plugins/lib/pdpproxyディレクトリに移動し、ファイルPDPProxyConfiguration.propertiesを編集して、SSM構成ID、OESホスト名、RMISポートおよびトラスト・ストアの場所を指定します。値の例を次に示します。

SSMConfigID=JK_SM1
PDPTransport=RMI
PDPAddress=rmis://example.com:9300 (the use of SSL port is always recommended)
TrustStore=<OID_HOME>/asinst_1/OVD/ovd1/plugins/lib/keys/DemoTrust.jks

2. ファイル./config/OPMN/opmn/opmn.xmlを開いて、次のサンプルに示すように、正しいOVDホームパスを指定してOVDプロセスのjava-optionsとjava-classpathを変更します。

<data id="java-options" value="-server -Xms256m -Xmx256m
-Dvde.soTimeoutBackend=0 -Didm.oracle.home=$ORACLE_HOME
-Dcommon.components.home=$ORACLE_HOME/../oracle_common
-Doracle.security.jps.config=$ORACLE_INSTANCE/config/JPS/jps-config-jse.xml
-Djavax.net.ssl.trustStore=$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/keys/DemoTrust.jks
-Dpdp.configuration.properties.location=$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/
pdpproxy/PDPProxyConfiguration.properties -Dwles.ssl.identityKeyAlias=wles-admin
-Dwles.ssl.identityKeyPasswordAlias=wles-admin
-Dwles.ssl.identityKeyStore=$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/keys/identity.jceks
-Dwles.ssl.trustedCAKeyStore=$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/keys/trust.jks
-Dwles.ssl.passwordFile=$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/keys/password.xml
-Dwles.ssl.passwordKeyFile=$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/keys/password.key"/>

<data id="java-classpath" value="$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/jsafeFIPS.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/jsafeJCEFIPS.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/scmapi.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/sslplus.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/ssladapter.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/asitools.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/webserviceclient.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/EccpressoCore.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/webservice.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/kodo-runtime.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/kodo-runtime.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/commons-pool-1.3.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/oes-ovd-plugin.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/xbean.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/antlr.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/log4j.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/api.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/asi_classes.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/framework.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/rmi-types.jar:
$ORACLE_INSTANCE/OVD/ovd1/plugins/lib/rmi-ssm.jar:
$ORACLE_HOME/ovd/jlib/vde.jar$:$ORACLE_HOME/jdbc/lib/ojdbc6.jar"/>

3. ブラウザでOracle Directory Service Manager (ODSM)を開きます。

http://host:port/odsm

ODSMポートを確認するには、OIDインストールのopmnctl statusコマンドを使用します。デフォルト・ポートは7005です。

4. LDAP Adapterタイプのアダプタを作成して、LDAPホストおよびポートの詳細を指定します(図31-22のサンプルを参照)。

図31-22 LDAPアダプタの例

5. DNを選択し、DNのマッピング名を指定します。

6. デフォルト以外の属性にマップする必要がある場合は、アダプタの「Plug-ins」タブを開いてUserManagementアダプタを追加します。たとえば、Active DirectoryをOVDのバック・エンド・ディレクトリ・サーバーとして使用する場合は、UserManagementアダプタを追加して、次のパラメータ・マッピングを指定します。

<param name="directoryType" value="ActiveDirectory"/>
<param name="mapAttribute" value="orclguid=objectguid"/>
<param name="mapAttribute" value="cn=sAMAccountName"/>
<param name="mapAttribute" value="uniquemember=member"/>
<param name="mapAttribute" value="OESRole=OESRole"/>
<param name="mapObjectclass" value="orclGroup=group"/>
<param name="mapObjectclass" value="groupofurls=group"/>
<param name="mapObjectclass" value="groupofuniquenames=group"/>
<param name="mapObjectclass" value="person=user"/>
<param name="mapRDNAttribute" value="uniquemember=member"/>

UserManagementアダプタの構成の詳細は、『Oracle Virtual Directory管理者ガイド』のUserManagementプラグインに関する項を参照してください。

7. OES10gUserEntitlementsPluginを追加し、次の例に示すように、すべてのプラグイン・パラメータを追加して、ホストおよびポートの詳細をローカル環境のBLMおよびパーソナライズ(p13n)用に置き換えます。

<param name="ldap_group_basedn" value="cn=Groups,dc=us,dc=oracle,dc=com"/>
<param name="ldap_user_basedn" value="cn=Users,dc=us,dc=oracle,dc=com"/>
<param name="ldap_admin_user" value="cn=Administrator"/>
<param name="oes_admin_user" value="admin"/>
<param name="OrclOVDEncrypted_oes_admin_pass" value="<password>"/>
<param name="oes_config_name" value="JK_SM1"/>
<param name="oes_policy_domain" value="JK_SM1"/>
<param name="oes_resource_action" value="browse"/>
<param name="oes_resource_prefix" value="//app/policy/"/>
<param name="oes_resource_name" value="javaapi_app/WebCenterApp/WebCenterResource"/>
<param name="oes_resource_namespace" value="webcenterResource"/>
<param name="oes_roles_cache_interval" value="180000"/>
<param name="oes_action_namespace" value="webcenterAction"/>
<param name="p13n_admin_user" value="weblogic"/>
<param name="oes_p13n_debug" value="true"/>
<param name="OrclOVDEncrypted_p13n_admin_pass" value="<password>"/>
<param name="oes_blm_host" value="example.com"/>
<param name="oes_blm_port" value="7011"/>
<param name="oes_p13n_index_url" value="example.com/>
<param name="oes_p13n_prop_url" value="example.com"/>
<param name="ldap_eqmatch" value="equalityMatch"/>
<param name="ldap_loginattr" value="sAMAccountName"/>
<param name="ldap_loginattr" value="mail"/>
<param name="ldap_loginattr" value="cn"/>

プラグイン・パラメータとして入力されたパスワードは、暗号化されてサーバーに格納されます。

8. 次のコマンドを使用してOVDプロセスを再起動します。

./opmnctl stopall startall

処理を続ける前に、OVDプロセスの再起動時にエラーが発生していないことを確認します。エラーが発生している場合は、次のエントリを追加すると、プラグインでロギングをオンにできます。

ORACLE_INSTANCE_HOME/config/OVD/ovd1/ovd-logging.xmlovd-logging.xml

<logger name='oracle.webcenter.security.internal.plugins.ovd' level='TRACE:1' useParentHandlers='false'>
<handler name='OVDHandler'/>
</logger>

9. SSL対応のパーソナライズ属性が必要な場合は、パーソナライズ・サーバーの公開鍵を含む証明書をOVDのトラスト・ストアにインポートします。通常、この証明書はJDKのcacertsファイルです。

31.7.4.3 パーソナライズ属性の構成

パーソナライズ属性を制約の一部として使用する場合は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のプロパティ・セットおよびプロパティ定義の作成に関する項を参照してください。パーソナライズの詳細は、第25項「パーソナライズの管理」を参照してください。

31.7.4.4 WebCenter Portalで動的ロールを使用するための構成

この項では、OES 10gで定義されている動的ロールをWebCenter Portalで使用できるようにするための方法を説明します。

デフォルトでは、アイデンティティ・ストアで定義されている静的エンタープライズ・ロールのみがWebCenter Portalに適用されます。OES (Oracle Entitlements Server)内で定義されている動的ロールを使用するには、OVDプラグインをオーセンティケータとして追加する必要があります。その後OVDプラグインによって、アイデンティティ・ストアの静的ロールとOESの動的ロールが統合されます。

動的ロールを使用するようにWebCenter Portalを構成するには:

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「タイプ」がOracle Virtual Directoryのオーセンティケータを追加して、OVD接続の詳細およびグループ・ベースdnとユーザー・ベースdnを指定します。
残りの設定については、デフォルト値のままにします。ディレクトリ固有のマッピングは、UserManagementプラグインを使用してアダプタ内でのみ実行する必要があります。UserManagementアダプタの構成の詳細は、『Oracle Virtual Directory管理者ガイド』のUserManagementプラグインに関する項を参照してください。

3. すべてのサーバーを再起動します。

4. OIDのユーザーとしてWebCenter Portalにログオンし、ポータルを作成します。

5. 「メンバーの追加」→「グループ」→「検索」に移動し、メンバーとして使用するエンタープライズ・ロールをポータルに追加します(図31-23を参照)。
OVDをオーセンティケータとして使用する場合は、動的グループ(OES)と静的グループの両方が表示されるはずです。図31-23では、ESTUsers、DayUsersおよびISTUsersが動的グループで、その他はOIDの静的グループです。

図31-23 ポータルへの静的グループおよび動的グループの追加

31.8 WebCenter Portalの動的グループの構成

動的グループとは、動的に移入される静的グループです。動的グループは、ロールに割り当てて、WebCenter Portal内で静的グループと同様に使用できます。

WebCenter Portalアプリケーション内では、静的グループと動的グループは区別されません。動的グループはすべて、アイデンティティ・ストアに構成され(構成内容は使用するLDAP実装に固有のものになります)、静的グループと同様に公開されます(事実上、動的グループは、静的なメンバー・リストと、動的に決定されるメンバーシップで構成されています)。

グループの動的メンバーシップを定義するには、グループのlabeledURI属性に適切なLDAP問合せフィルタを設定します。問合せフィルタには、グループのメンバーシップを定義するユーザー・セットが定義されています。

Oracle Internet Directoryで動的グループを作成するには、LDIFファイルとldapaddコマンドを使用するか、またはOracle Directory Services Manager (ODSM)を使用します。これら2つのオプションについて、次の各項で説明します。

- 第31.8.1項「LDIFファイルを使用した動的グループの作成」

- 第31.8.2項「Oracle Directory Services Managerを使用した動的グループの作成」

31.8.1 LDIFファイルを使用した動的グループの作成

LDIFファイルを使用して動的グループを作成するには:

1. テキスト・エディタでLDIFファイルを作成します。次の例では、デフォルトのユーザー検索ベース内で役職が「Manager」のユーザーをすべて表す動的グループを定義する方法を示します。

例31-1 LDIFファイルを使用した動的グループの定義

dn: cn=managers,cn=portal.070720.104824.056918000,cn=groups,dc=us,dc=oracle,dc=com
labeleduri: ldap://myserver.example.com:12061/cn=users,dc=us,dc=mybiz,dc=com
??sub?(title=Manager)
description: Dynamic Group of Managers
cn: Managers
orclisvisible: true
objectclass: orclDynamicGroup
objectclass: orclGroup
objectclass: top
objectclass: groupOfUniqueNames
displayname: Managers
owner: cn=fmwadmin,cn=users,dc=us,dc=mybiz,dc=com

注意:
LDAP URLのlabledURI構文はRFC 2255 (http://www.faqs.org/rfcs/rfc2255.html)に定義されています。前述の例は、DN cn=users,dc=us,dc=mybiz,dc=com内で属性title=Managerが設定されているすべてのエントリの検索を表しています。これは、サーバーmyserver.example.comのLDAPポート12061でサブツリー("sub")検索を使用して実行されます。
動的グループは、属性または条件に対して定義できますが、LDAP URLとして表現可能かつlabeledURI属性で定義可能なものに限られます。また、動的グループは、ConnectByアサーションを使用して定義することもできます。このアサーションは、orclDynamicGroupオブジェクト・クラスに含まれます。この代替手段の詳細は、『Oracle Internet Directory管理者ガイド』を参照してください。

2. ファイルを保存してから、ldapaddコマンドを発行してOIDサーバーを更新します。例:

例31-2 ldapaddコマンドを使用したOIDの更新

ldapadd -h myserver -p 12061 -D cn=fmwadmin -w mybiz1 –f managers.ldif –v
add labeleduri: ldap://myserver.example.com:12061/cn=users,dc=us,dc=mybiz,dc=com??sub?(title=Manager)
add description:
Dynamic Group of Managers
add cn:
Managers
add orclisvisible:
true
add objectclass:
orclDynamicGroup
orclGroup
top
groupOfUniqueNames
add displayname:
Managers
add owner:
cn=fmwadmin,cn=users,dc=us,dc=mybiz,dc=com
adding new entry cn=managers,cn=portal.070720.104824.056918000,cn=groups,dc=us,dc=mybiz,dc=com
modify complete

31.8.2 Oracle Directory Services Managerを使用した動的グループの作成

ODSMを使用して動的グループを作成するには:

1. Oracle Directory Services Manager (ODSM)を起動してOracle Internet Directoryサーバーに接続します。
Oracle Directory Services Managerの起動および使用の詳細は、『Oracle Internet Directory管理者ガイド』の「Oracle Directory Services Managerの使用」の章を参照してください。

2. 「移動先」リストで「データ・ブラウザ」を選択します。

3. データ・ブラウザで「新規エントリ」アイコンをクリックします。

4. DNを指定して、オブジェクト・クラスorclDynamicGroupおよびgroupOfUniqueNamesを追加します。

5. 「必須プロパティ」タブで、CN属性を指定します。

6. 「オプション・プロパティ」タブで、labeleduriの属性を指定します。

7. 「OK」をクリックして、動的グループの定義を完了します。

ツリー・ビューをリフレッシュすると、作成した新しいグループが表示されるはずです。ODSMにはグループ・メンバーは表示されません。

31.9 RESTサービス・アイデンティティ・アサータの構成

この項では、RESTサービス用のアイデンティティ・アサータを構成する方法について説明します。WebCenter PortalまたはPortal FrameworkアプリケーションでRESTサービス(RESTサービスAPIを含む)を使用する場合は、WebCenterドメインのアイデンティティ・ストアにRESTサービス用のアイデンティティ・アサータを構成する必要があります。次の項では、Oracle WebLogic ServerでOPSSトラスト・サービス・インスタンスとアイデンティティ・アサータを構成する方法について説明します。

この項には次のサブセクションが含まれます:

- 第31.9.1項「RESTサービス・インスタンスおよびアイデンティティ・アサータの理解」

- 第31.9.2項「クライアント・アプリケーションの設定」

- 第31.9.3項「WLSトラスト・サービス・アサータの構成」

31.9.1 RESTサービス・インスタンスおよびアイデンティティ・アサータの理解

WebCenter PortalおよびPortal Frameworkアプリケーションや他のOracle WebLogicアプリケーションでは、それらのアプリケーションで必要な方法でREST APIを使用して情報を表示できますが、そのようなコールは中間層から発信されるため、ユーザーはログイン資格証明を再度入力するよう求められます。これに対処するには、ユーザー・アイデンティティがHTTPヘッダーに伝播され、OPSSトラスト・サービス・アサータによってアサートされるときに境界認証を使用します。

ユーザー・アイデンティティをアプリケーション間で正常に伝幡するには、それらのアプリケーションでトラスト・サービス・インスタンスを正しく構成して使用する必要があります。図31-24に、アイデンティティ伝幡とアサーションに関連する各種コンポーネントを示します。

図31-24 RESTのアイデンティティ伝幡とアサーション

次に、RESTのアイデンティティ伝幡とアサーションに関連した一連のイベントを示します。

1. エンド・クライアント(ブラウザ、スマートフォン・アプリケーション)は、WebCenter PortalまたはPortal Frameworkアプリケーションに接続します。

2. アプリケーション・ページは、REST APIからデータを問い合せ、それをもとに独自のUIを構築するため、RESTエンド・ポイントをコールする必要があります。

3. アプリケーションは、WebCenter Security API (WCSecurityUtility.issueTrustServiceSecurityToken)をコールして、ユーザー・アイデンティティを安全に伝幡するために使用するトークンを発行します。このトークンはトラスト・サービスの組込みプロバイダを使用して生成されます。生成されたトークンは、トークン・サイズを最適化するために圧縮され、トークンが安全に転送されるようにHTTPヘッダーを使用してBASE64にエンコードされます。

4. アプリケーションは、発行されたトークンを受け取り、「Authorization」セキュリティ・ヘッダーに追加します。クライアントは、そのトークンをREST URIに対するコールの一部としてディスパッチします。

5. WebLogic Serverは、特定のトークン・タイプのアイデンティティ・アサータが存在するかどうかを確認します。

6. アイデンティティ・アサータは、トークンを解析して、OPSSトラスト・サービスAPIが使用されていることを確認します。

7. アサータがユーザー名をWLSユーザー名にマップすると、ユーザーのサブジェクトが確立され、RESTアプリケーションにコールが到達します。

8. RESTアプリケーションは、そのユーザーがすでに認証済のユーザーであることを認識し、レスポンスを送信します。WebCenter PortalまたはPortal Frameworkアプリケーションはレスポンスを使用して、エンド・ユーザーにページを表示します。

31.9.2 クライアント・アプリケーションの設定

この項では、RESTサービス・アイデンティティ・アサータ用にクライアントを構成する方法について説明します。

RESTサービス・アイデンティティ・アサータ用にクライアントを構成するには:

1. JDeveloperを使用して、クライアント・アプリケーションを作成します。
クライアント・アプリケーションとしてJSEまたはサーブレット・アプリケーションを作成できます。次の例では、サンプル・クライアント・アプリケーションのスケルトンを示します。

// The authenticated username
// String user = "weblogic";
// URL of the target application
URL url = "http://host:port/destinationApp";
//-----------------------------------------

String b64EncodedToken = WCSecurityUtility.issueTrustServiceSecurityToken()

HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("GET");
connection.setDoOutput(true);
connection.setReadTimeout(10000);
connection.setRequestProperty("Authorization", AUTH_TYPE_NAME + " " + b64EncodedToken);
connection.connect();
BufferedReader rd = new BufferedReader(new InputStreamReader(
connection.getInputStream()));
StringBuilder sb = new StringBuilder();

String line = null;
while ((line = rd.readLine()) != null) {
sb.append(line);
}
connection.disconnect();
System.out.println(sb.toString());

2. キーストアを作成して構成します。
ドメインのキーストアを作成して、アイデンティティ・アサータ用にWebLogic Serverを構成します。クライアント証明書および秘密鍵用のキーストアがまずプロビジョニングされます。このクライアント証明書はエクスポートされ、トラスト・キーストアにインポートされます。

1. キーストアを作成します(第36.1.2.1項「WebCenter Portalドメイン・キーストアの作成」を参照)。

2. キーストアを構成します(第36.1.2.2項「WLSTを使用したキーストアの構成」または第36.1.2.3項「Fusion Middleware Controlを使用したキーストアの構成」を参照)。

3. jps-config.xml構成ファイルを編集します。

1. DOMAIN_HOME/config/fmwconfigディレクトリに移動し、テキスト・エディタでjps-config.xmlファイルを開きます。

2. jps-config.xmlファイルに次のものが含まれていることを確認します。

<serviceInstance name="keystore" provider="keystore.provider" location="./default-keystore.jks">

3. trust.provider.embedded propertySetノードを次のように変更します。

<propertySets>
<propertySet name="trust.provider.embedded">
... existing entries
<property value="orakey" name="trust.aliasName"/>
<property value="orakey" name="trust.issuerName"/>
</propertySet>
</propertySets>

ここで:

trust.aliasNameは、アイデンティティ・アサータが構成済キーストアで検索する証明書の別名です。アサータはこの証明書を使用して、発行されたトラスト・トークンを検証します。

trust.issuerNameは、トラスト・トークンの発行および署名に使用した秘密鍵をトークン発行者が検索する際に検索される別名です。

4. クライアントとRESTアプリケーションのドメインが異なる場合は、両方のドメインで前述の手順を実行します。

5. すべてのサーバーを再起動します。

31.9.3 WLSトラスト・サービス・アサータの構成

この項では、WebLogic Serverトラスト・サービス・アサータを構成する方法について説明します。

WebLogic Serverトラスト・サービス・アサータを構成するには:

1. WebLogic管理コンソールに管理者としてログインします。

2. 「セキュリティ・レルム」→「myrealm」に移動します。

3. 「プロバイダ」タブを開き、「認証」サブタブを開きます。
「新しい認証プロバイダの作成」ページが表示されます。

4. 新しいアサータの「名前」を入力します(例: TrustServiceIdAsserter)。

5. アサータの「タイプ」にTrustServiceIdentityAsserterを選択します。
このアサータは、受信リクエストのトークンをデコードおよび検証するためにトラスト・サービスAPIをコールし、アサートされたサブジェクトを確立する際にユーザー名をWebLogicに渡します。

6. 「OK」をクリックして、変更を保存します。

7. すべての管理対象サーバーを再起動します。

32 ポリシーおよび資格証明ストアの構成

この章では、ポリシーおよび資格証明ストアを構成してデフォルトのファイルベースのLDAPのかわりにOracleデータベースまたは外部LDAPサーバーを使用する方法について説明します。

注意:

WebCenter Portalを最初にインストールすると、XMLファイルベースのLDAPを使用するためにポリシーおよび資格証明ストアが構成されます。単一ノードの開発環境、本番環境および高可用性環境にファイルベースのストアを使用できますが、ポリシーおよび資格証明ストアを構成してOracleデータベース(推奨)または外部LDAPを使用する必要があります。

WebCenter Portalドメインのポリシーおよび資格証明ストアをOracle RDBMS (リリース10.2.0.4以降、リリース11.1.0.7以降およびリリース11.2.0.1以降)またはOracle Internet Directory 11gR1あるいは10.1.4.3に再度関連付けることができます。ポリシーおよび資格証明ストアとしてOracleデータベースを構成する手順は、『Oracle Platform Security Servicesによるアプリケーションの保護』のDBベースのOPSSセキュリティ・ストアの使用に関する項を参照してください。再関連付けが失敗した場合は、『Oracle Platform Security Servicesによるアプリケーションの保護』の再関連付けの失敗に関する項を参照してください。

注意:
ポリシーおよび資格証明ストアを再度関連付けて外部LDAPベースのストアを使用する際は、同じLDAPサーバーを使用するように資格証明ストアとポリシー・ストアを構成する必要があります。Oracleデータベースの使用と同様に、資格証明ストアおよびポリシー・ストアを構成して同じデータベースを使用する必要があります。ただし、アイデンティティ・ストアは、サポートされている他の任意のLDAPサーバーを使用することができ、ポリシー・ストアや資格証明ストアと同じLDAPサーバーを使用する必要はありません。

注意:
ポリシー・ストアを再度関連付ける前に、次の関連する構成ファイルを必ずバックアップしてください。

- jps-config.xml

- system-jazn-data.xml

念のため、ドメインの管理サーバーのboot.propertiesファイルもバックアップしてください。

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

この章には次の項が含まれます:

- 第32.1項「ルート・ノードの作成」

- 第32.2項「Fusion Middleware Controlを使用した資格証明およびポリシー・ストアの再関連付け」

- 第32.3項「WLSTを使用した資格証明およびポリシー・ストアの再関連付け」

- 第32.4項「資格証明の管理」

- 第32.5項「ユーザーおよびアプリケーション・ロールの管理」

- 第32.6項「WebCenter Portalにおける招待による自己登録の構成」

- 第32.7項「ポリシー・ストアのリフレッシュ間隔および他のキャッシュ設定の設定」

32.1 ルート・ノードの作成

ポリシーおよび資格証明ストアをOIDと再度関連付ける際の最初のステップでは、LDAPディレクトリでLDIFファイルを作成し、すべてのデータを追加するルート・ノードを追加します。ルート・ノードを作成するには、『Oracle Platform Security Servicesによるアプリケーションの保護』のLDAPベースのセキュリティ・ストアを使用する場合の前提条件に関する項の手順に従います。ファイルを作成してノードを追加したら、Fusion Middleware ControlまたはWLSTを使用してストアを再度関連付けます。

32.2 Fusion Middleware Controlを使用した資格証明およびポリシー・ストアの再関連付け

ポリシーおよび資格証明ストアをOracle Internet Directoryに再度関連付ける前に、『Oracle Platform Security Servicesによるアプリケーションの保護』のLDAPベースのセキュリティ・ストアを使用する場合の前提条件に関する項の説明に従って、まずルート・ノードを作成する必要があります。ルート・ノードを作成したら、『Oracle Platform Security Servicesによるアプリケーションの保護』のFusion Middleware Controlを使用した再関連付けに関する項の手順に従います。再関連付けが失敗した場合は、『Oracle Platform Security Servicesによるアプリケーションの保護』の再関連付けの失敗に関する項を参照してください。

32.3 WLSTを使用した資格証明およびポリシー・ストアの再関連付け

ポリシーおよび資格証明ストアをOracle Internet Directoryに再度関連付ける前に、『Oracle Platform Security Servicesによるアプリケーションの保護』のLDAPベースのセキュリティ・ストアを使用する場合の前提条件に関する項の説明に従って、まずルート・ノードを作成する必要があります。再関連付けが失敗した場合は、『Oracle Platform Security Servicesによるアプリケーションの保護』の再関連付けの失敗に関する項を参照してください。

WLSTを使用して資格証明およびポリシー・ストアを再度関連付ける手順は次のとおりです。

1. 第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」の説明に従って、WLSTを起動します。

2. 次のコマンドを使用して、ターゲット・ドメインの管理サーバーに接続します。

connect('username>,'password', 'host_id:port')

ここで:

- usernameは、管理サーバーへのアクセスに使用される管理者のアカウント名です(例: weblogic)。

- passwordは、管理サーバーへのアクセスに使用される管理者のパスワードです(例: weblogic)。

- host_idは、管理サーバーのサーバーIDです(例: example.com)。

- portは、管理サーバーのポート番号です(例: 7001)。

3. reassociateSecurityStoreコマンドを使用して、ポリシーおよび資格証明ストアを再度関連付けます。

reassociateSecurityStore(domain="domain_name", admin="admin_name", password="password",
ldapurl="ldap_uri", servertype="ldap_srvr_type", jpsroot="root_webcenter_xxxx")

ここで:

- domain_nameには、再関連付けを行うドメイン名を指定します。

- admin_nameには、LDAPサーバー上の管理者のユーザー名を指定します。書式はcn=usrNameです。

- passwordには、引数adminに指定されたユーザーに関連付けられたパスワードを指定します。

- ldap_uriには、LDAPサーバーのURIを指定します。書式は、デフォルト・ポートを使用する場合はldap://host:port、セキュアLDAPポートを使用する場合はldaps://host:portになります。セキュア・ポートは、匿名SSL接続を処理するように構成されていることが必要で、デフォルトの(非セキュアな)ポートとは異なります。

- ldap_srvr_typeには、ターゲットLDAPサーバーの種類を指定します。Oracle Internet DirectoryのOIDを指定します。

- root_webcenter_xxxxには、全データを移行するターゲットLDAPリポジトリのルート・ノードを指定します。必ず、cn=を含めてください。書式はcn=nodeNameです。

すべての引数が必要です。例:

reassociateSecurityStore(domain="myDomain", admin="cn=adminName", password="myPass", ldapurl="ldaps://myhost.example.com:3060", servertype="OID", jpsroot="cn=testNode")

32.4 資格証明の管理

管理者は、Fusion Middleware Controlを使用して、WebCenter Portalドメイン資格証明ストアの資格証明を管理できます。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のFusion Middleware Controlでの資格証明の管理に関する項を参照してください。

32.5 ユーザーおよびアプリケーション・ロールの管理

この項では、Fusion Middleware Control、WLST、およびWebCenter PortalとPortal Frameworkアプリケーションの実行時管理ページを使用して、ユーザー・ロールとアプリケーション・ロールを管理する方法を説明します。

この項には次のサブセクションが含まれます:

- 第32.5.1項「WebCenter Portal管理者ロールの付与」

- 第32.5.2項「アプリケーション・ロールの付与」

- 第32.5.3項「実行時管理ページの使用」

32.5.1 WebCenter Portal管理者ロールの付与

WebCenter Portalは、最初のオーセンティケータによってマップされたアイデンティティ・ストア内のユーザーのみを認識します。WebCenter Portal管理者アカウントは当初は組込みのLDAPサーバーにのみ作成されるため、Oracle Internet Directoryなどの外部LDAPをWebCenter Portalのプライマリ・オーセンティケータとして構成する場合は、そのLDAP内にユーザーを作成し、そのユーザーにWebCenter Portal管理者ロールを付与する必要もあります。

次の項の説明に従って、Fusion Middleware ControlまたはWLSTを使用してWebCenter Portal管理者ロールをユーザーに付与できます。

- 第32.5.1.1項「Fusion Middleware Controlを使用したWebCenter Portal管理者ロールの付与」

- 第32.5.1.2項「WLSTを使用したWebCenter Portal管理者ロールの付与」

詳細は、『Oracle WebCenter Portalインストレーション・ガイド』の非デフォルト・ユーザーへの管理者権限の付与に関する項を参照してください。

32.5.1.1 Fusion Middleware Controlを使用したWebCenter Portal管理者ロールの付与

この項では、WebCenter Portal管理者ロールをデフォルトのweblogicアカウント以外のユーザー・アカウントに付与する方法について説明します。

Fusion Middleware Controlを使用してWebCenter Portal管理者ロールを付与する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalホームページに移動します。
第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. WebCenter Portalメニューから、「セキュリティ」→「アプリケーション・ロール」を選択します。
「アプリケーション・ロール」ページが表示されます(図32-1を参照)。

図32-1 「アプリケーション・ロール」ページ

3. WebCenter Portal管理者ロールを検索します。

1. 「検索するアプリケーション・ストライプの選択」を選択します。

2. webcenterを選択します。

3. 「ロール名」フィールドに、管理者ロールの次の内部識別子を入力して、「検索」(矢印)アイコンをクリックします。

s8bba98ff_4cbb_40b8_beee_296c916a23ed#-#Administrator

検索の結果として、管理者ロールの識別子であるs8bba98ff_4cbb_40b8_beee_296c916a23ed#-#Administratorが返されます。

4. 「ロール名」列で管理者ロールの識別子をクリックします。
「アプリケーション・ロールの編集」ページが表示されます(図32-2を参照)。

図32-2 「アプリケーション・ロールの編集」ページ

5. 「ユーザーの追加」をクリックします。
「ユーザーの追加」ポップアップが表示されます(図32-3を参照)。

図32-3 「ユーザーの追加」ポップアップ

6. 検索機能を使用して、管理者ロールを割り当てるユーザーを検索します。

7. 矢印キーを使用して「使用可能なユーザー」列から「選択したユーザー」列にユーザーを移動し、「OK」をクリックします。

8. 「アプリケーション・ロールの編集」ページで、「OK」をクリックします。

9. weblogicロールを削除するには、「アプリケーション・ロールの編集」ページで、「ユーザー」のweblogicをクリックし、「削除」をクリックします。

10. WC_Spaces管理対象サーバーを再起動します。
WebCenter Portalにログインすると、「管理」リンクが表示され、管理者の操作をすべて実行できます。

32.5.1.2 WLSTを使用したWebCenter Portal管理者ロールの付与

WLSTを使用して別のユーザーにWebCenter Portal管理者ロールを付与する手順は次のとおりです。

1. 第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」の説明に従って、WLSTを起動します。

2. 次のコマンドを使用して、ターゲット・ドメインのWebCenter Portal管理サーバーに接続します。

connect('user_name','password, 'host_id:port')

ここで:

- user_nameは、管理サーバーにアクセスするユーザー・アカウントの名前です(例: weblogic)。

- passwordは、管理サーバーにアクセスするためのパスワードです。

- host_idは、管理サーバーのホストIDです。

- portは、管理サーバーのポート番号です(例: 7001)。

3. 次に示されているように、grantAppRoleコマンドを使用して、Oracle Internet DirectoryのユーザーにWebCenter Portal管理者アプリケーション・ロールを付与します。

grantAppRole(appStripe="webcenter", appRoleName="s8bba98ff_4cbb_40b8_beee_296c916a23ed#-#Administrator",
principalClass="weblogic.security.principal.WLSUserImpl", principalName="wc_admin")

wc_adminは、作成する管理者アカウントの名前です。

4. 新しいアカウントをテストするには、新しいアカウント名を使用してWebCenter Portalにログインします。
「管理」リンクが表示され、管理者の操作をすべて実行できます。

5. 新しいアカウントにWebCenter Portal管理者ロールを付与したら、WLST revokeAppRoleコマンドを使用して、このロールが不要になったアカウントからこれを削除します。たとえば、weblogic以外の管理者ユーザー名を使用してWebCenter Portalがインストールされている場合は、管理者ロールはそのユーザーに付与し、デフォルトのweblogicからは削除する必要があります。

revokeAppRole(appStripe="webcenter", appRoleName="s8bba98ff_4cbb_40b8_beee_296c916a23ed#-#Administrator",
principalClass="weblogic.security.principal.WLSUserImpl", principalName="weblogic")

32.5.2 アプリケーション・ロールの付与

この項では、Fusion Middleware ControlおよびWLSTコマンドを使用してアプリケーション・ロールにユーザーを追加する方法について説明します。

この項には次のサブセクションが含まれます:

- 第32.5.2.1項「Fusion Middleware Controlを使用したアプリケーション・ロールの付与」

- 第32.5.2.2項「WLSTを使用したアプリケーション・ロールの付与」

32.5.2.1 Fusion Middleware Controlを使用したアプリケーション・ロールの付与

この項では、Fusion Middleware Controlを使用してユーザーにアプリケーション・ロールを付与する方法を説明します。

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. WebCenter Portalメニューから、「セキュリティ」→「アプリケーション・ロール」を選択します。
「アプリケーション・ロール」ページが表示されます(図32-4を参照)。

図32-4 「アプリケーション・ロール」ページ

3. WebCenter PortalまたはPortal Frameworkアプリケーション・ロールを検索します。

1. 「検索するアプリケーション・ストライプの選択」を選択します。

2. アプリケーション・ストライプ(WebCenter Portalの場合はwebcenter)を選択します。

3. 「ロール名」フィールドに、検索するロールの名前を入力し(例: appConnectionManager)、「検索」(矢印)アイコンをクリックします。
名前がはっきりわからない場合は、部分検索語を入力するか、フィールドを空白のままにして、すべてのアプリケーション・ロールを表示します。

4. 「ロール名」列でロール識別子をクリックします。
「アプリケーション・ロールの編集」ページが表示されます(図32-5を参照)。

図32-5 「アプリケーション・ロールの編集」ページ

5. 「ユーザーの追加」をクリックします。
「ユーザーの追加」ポップアップが表示されます(図32-6を参照)。

図32-6 「ユーザーの追加」ポップアップ

6. 検索機能を使用して、アプリケーション・ロールを割り当てるユーザーを検索します。

7. 矢印キーを使用して「使用可能なユーザー」列から「選択したユーザー」列にユーザーを移動し、「OK」をクリックします。

8. 「アプリケーション・ロールの編集」ページで、「OK」をクリックします。

9. WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動します(WebCenter Portalの場合、これは常にWC_Spacesになります)。

32.5.2.2 WLSTを使用したアプリケーション・ロールの付与

grantAppRoleコマンドを使用して、ユーザーにアプリケーション・ロールを付与します。構文および使用状況の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のgrantAppRoleに関する項を参照してください。

32.5.3 実行時管理ページの使用

管理者はWebCenter Portalの「セキュリティ」タブを使用して、アプリケーション・ロールを定義し、アイデンティティ・ストアで定義されたユーザーにアプリケーション・ロールを付与できます。WebCenter Portalでのユーザーおよびアプリケーション・ロールの管理の詳細は、『Oracle WebCenter Portalの使用』のWebCenter Portalユーザーおよびロールの管理に関する項を参照してください。

注意:
「パスワード変更の許可」プロパティは、ユーザーがWebCenter Portal内で各自のパスワードを変更できるかどうかを指定しますが、これは企業のアイデンティティ・ストアで慎重に管理する必要があります。WebCenter Portal管理者はWebCenter Portalのプロファイル管理設定のページからこのプロパティを設定できます。詳細は、『Oracle WebCenter Portalの使用』のプロファイルの構成に関する項を参照してください。

Portal Frameworkアプリケーションも、アプリケーション管理者のための同様の「セキュリティ」タブを提供します。詳細は、第43.4項「Portal Frameworkアプリケーションのメンバーとロールの管理」を参照してください。ADFセキュリティベースのPortal Frameworkアプリケーションのロールマッピングの詳細は、『Oracle Application Development Framework Fusion開発者ガイド』のエンタープライズ・ロールおよびアプリケーション・ロールに関する必知事項を参照してください。

32.6 WebCenter Portalにおける招待による自己登録の構成

『Oracle WebCenter Portalの使用』の招待のみによる自己登録の有効化に関する項に説明されているように、WebCenter Portalは招待による自己登録をサポートします。招待による自己登録機能では、WebCenter Portalドメイン資格証明ストアに次のパスワード資格証明が含まれていることが必要です。

- map name = o.webcenter.security.selfreg

- key= o.webcenter.security.selfreg.hmackey

- user name = o.webcenter.security.selfreg.hmackey

WebCenter Portalで招待による自己登録を有効にするには、Fusion Middleware ControlまたはWLSTコマンドcreateCredを使用して、前述のパスワード資格証明を作成します。例:

createCred(map="o.webcenter.security.selfreg", key="o.webcenter.security.selfreg.hmackey", type="PC",
user="o.webcenter.security.selfreg.hmackey", password="<password>", url="<url>", port="<port>", [desc="<description>"])

詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のWLSTコマンドでの資格証明の管理に関する項を参照してください。

32.7 ポリシー・ストアのリフレッシュ間隔および他のキャッシュ設定の設定

この項では、インストール後に構成する必要がある推奨キャッシュ設定を示します。キャッシュ・サイズと最大グループ階層の設定は特定の環境に基づく必要がありますが、次の項では開始点として使用できる推奨事項を示します。WebCenter Portalのチューニング・パラメータと推奨値の全リストは、パフォーマンス・チューニング・ガイドのOracle WebCenter Portalパフォーマンスのチューニングに関する項を参照してください。

この項には次のサブセクションが含まれます:

- 第32.7.1項「ポリシー・ストアのリフレッシュ間隔の設定」

- 第32.7.2項「接続プール・キャッシュの設定」

- 第32.7.3項「ユーザー・キャッシュ設定の設定」

- 第32.7.4項「グループ・キャッシュ設定の設定」

32.7.1 ポリシー・ストアのリフレッシュ間隔の設定

WebCenter Portalが使用する認可ポリシーでは、デフォルトのポリシー・リフレッシュ時間が10分間のインメモリー・キャッシュを使用します。マルチノードの高可用性環境でポータルを作成する場合、ノード障害の際にポリシー・データをより迅速にレプリケートする必要があるときは、ドメインレベルのjps-config.xmlファイルを変更して次のエントリを追加することでポリシー・ストアのリフレッシュ間隔を短くすることができます。

oracle.security.jps.ldap.policystore.refresh.interval=<time_in_milli_seconds>

これはPDPサービス・ノードに追加する必要があります。

<serviceInstance provider="pdp.service.provider" name="pdp.service">

サーバーのキャッシュされたポリシーのリフレッシュ頻度はパフォーマンスに影響を与える可能性があるため、ポリシーのリフレッシュ間隔は過度に短く設定しないでください。

jps-config.xmlファイルを変更したら、ドメイン内の全サーバーを再起動します。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のキャッシュ設定およびキャッシュのリフレッシュに関する項を参照してください。

32.7.2 接続プール・キャッシュの設定

この項では、接続プール・キャッシュの推奨設定を説明します。

接続プール・キャッシュを設定する手順は次のとおりです。

1. WLS管理コンソールにログインします。

2. 「セキュリティ・レルム」→[realm]→「プロバイダ」→[provider]→「構成」→「プロバイダ固有」を選択します。

3. 接続プール・キャッシュのパラメータを次の推奨値に設定します。

- 接続プール・サイズ = 最大接続ユーザー数

- 接続タイムアウト = 30

- 接続再試行制限 = 1

- 結果タイム・リミット = 1000

- キープアライブの有効化 = true

4. 変更を保存し、ドメイン内のすべてのサーバーを再起動します。

32.7.3 ユーザー・キャッシュ設定の設定

この項では、ユーザー・キャッシュ設定の推奨設定を説明します。

ユーザー・キャッシュ設定を設定する手順は次のとおりです。

1. WLS管理コンソールにログインします。

2. 「セキュリティ・レルム」→[realm]→「プロバイダ」→[provider]→「構成」→「プロバイダ固有」を選択します。

3. ユーザー・キャッシュのパラメータを次の推奨値に設定します。

- キャッシュの有効化 = true

- キャッシュ・サイズ = 3200

- キャッシュTTL = session timeout

- 結果タイム・リミット = 1000

- キープアライブの有効化 = true

4. 変更を保存し、ドメイン内のすべてのサーバーを再起動します。

32.7.4 グループ・キャッシュ設定の設定

この項では、グループ・キャッシュ設定の推奨設定を説明します。

グループ・キャッシュ設定を設定する手順は次のとおりです。

1. WLS管理コンソールにログインします。

2. 「セキュリティ・レルム」→[realm]→「プロバイダ」→[provider]→「パフォーマンス」を選択します。

3. グループ・キャッシュのパラメータを次の推奨値に設定します。

- グループ・メンバーシップ・ルックアップの階層キャッシュを有効化 = true

- キャッシュ・サイズ = 3200

- キャッシュ内の最大グループ階層数 = 1024

- グループ階層キャッシュTTL = session timeout

- キープアライブの有効化 = true

4. 変更を保存し、ドメイン内のすべてのサーバーを再起動します。

33 シングル・サインオンの構成

この章では、WebCenter PortalまたはPortal Frameworkアプリケーションで利用できるシングル・サインオン(SSO)ソリューションと各ソリューションの構成方法について説明します。

この章には次の項が含まれます:

- 第33.1項「シングル・サインオンの概要」

- 第33.2項「Oracle Access Manager (OAM)の構成」

- 第33.3項「Oracle Single Sign-On (OSSO)の構成」

- 第33.4項「SAMLベースのシングル・サインオンの構成」

- 第33.5項「Microsoftクライアント用のSSOの構成」

- 第33.6項「仮想ホストを使用したSSOの構成」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

33.1 シングル・サインオンの概要

いくつかのソリューションを使用して、WebCenter PortalおよびPortal Frameworkアプリケーション向けにシングル・サインオンを実装できます。この項では、その利点と推奨アプリケーションを説明します。

オラクル社のエンタープライズ・クラスのアイデンティティ管理およびセキュリティ製品スイートの一部であるOracle Access Manager (OAM)は、WebCenter PortalおよびPortal Frameworkアプリケーション用のいくつかのシングル・サインオン・オプションを含む広範なアイデンティティ管理およびセキュリティ機能を提供します。OAM(特にOAM 11g)は、Oracle WebCenter Portal 11gのインストールに推奨されるシングル・サインオン・ソリューションです。

Oracle 10gインフラストラクチャに投資済のデプロイメント環境で、Oracle Application Server Single Sign-On (OSSO)サーバーがプライマリSSOソリューションとして使用されている場合は、OSSOを使用してシングル・サインオンを提供するようにWebCenter Portal 11gおよびPortal Frameworkアプリケーションを構成することもできます。

Oracle Access ManagerやOracle SSOのようなエンタープライズ・クラスのシングル・サインオン・インフラストラクチャが用意されていない本番以外の開発環境で、WebCenter PortalまたはPortal Frameworkアプリケーション、および関連するWebツール(ディスカッション、ワークリストなど)内でのみシングル・サインオン機能を提供する必要がある場合は、SAMLベースのSSOソリューションを構成できます。他のエンタープライズ・アプリケーションにもシングル・サインオンを提供する必要がある場合は、このソリューションはお薦めできません。

Active Directoryのユーザー・アカウントによってMicrosoftドメイン・コントローラを使用して認証を行うMicrosoftデスクトップ・ログインを使用している場合は、Microsoftのクライアントに対するSSOの構成も検討できます。

33.2 Oracle Access Manager (OAM)の構成

Oracle Access Manager (OAM)は、柔軟で拡張可能な認証と認可のほか、監査サービスを提供します。この項では、WebLogicサーバー側およびSSOに参加するパートナ・アプリケーションとしてのWebCenter PortalまたはPortal Frameworkアプリケーションの構成方法を含め、OAMシングル・サインオン認証のためにWebCenter PortalおよびPortal Frameworkアプリケーションを構成する方法を説明します。第34.4項「OAMに対するPortal Frameworkアプリケーションおよびポートレット・プロデューサ・アプリケーションの構成」で説明されているように、Portal Frameworkアプリケーションの場合は、追加の構成がいくつか必要になることに注意してください。

次の項で、OAM 11gおよび10gのインストールおよび構成手順を示します。

- 第33.2.1項「OAMのコンポーネントとトポロジ」

- 第33.2.2項「OAM構成のロードマップ」

- 第33.2.3項「OAMのインストールと構成」

- 第33.2.4項「OAM用のWebLogicドメインの構成」

- 第33.2.5項「Oracle HTTP Serverのインストールと構成」

- 第33.2.6項「追加のシングル・サインオン構成」

- 第33.2.7項「OAMインストールのテスト」

33.2.1 OAMのコンポーネントとトポロジ

図33-1は、WebCenter PortalまたはPortal Frameworkアプリケーション用にOracle Access Managerを使用してシングル・サインオンをセットアップするために必要なコンポーネントとトポロジを示しています。

図33-1 OAMシングル・サインオンのコンポーネントとトポロジ

OAMは次のコンポーネントから構成されます。

- アクセス・サーバー: 認証、認可およびアクセス・ゲートの監査サービスを提供するスタンドアロン・サーバー。OAMには1台のアクセス・サーバーがセットアップされます。これはOAMのインストール自体の一環として行われます。

- WebGate: Webリソース(HTTP)リクエストをインターセプトして認証と認可のためにアクセス・サーバーに転送する、すぐに利用可能なプラグイン。

- IDアサーション・プロバイダ(IAP): 境界認証によって設定されるヘッダー情報に基づいてユーザーのアイデンティティをアサートするセキュリティ・プロバイダの種類。OAMの統合により、OAM IAPとして構成できるOAM IDアサータが提供されます。OAM IDアサータは、認証またはアイデンティティ・アサーションに使用できます。OAM SSOの統合では、プロバイダの「共通」設定の「アクティブなタイプ」でobSSOCookieを選択して、アイデンティティ・アサーション・プロバイダ(IAP)としてOAM IDアサータを構成することが必要です。

OAMシングル・サインオン・プロセスのフロー

図33-2は、OAMのシングル・サインオン・プロセスのフローを示しています。

図33-2 OAMシングル・サインオン・プロセスのフロー

OAMエージェントによるSSOログイン処理

1. ユーザーがリソースをリクエストします。

2. ポリシー評価のためにWebGateがOAMにリクエストを転送します。

3. OAMが次を行います。

- SSO Cookieの有無をチェックします。

- ポリシーをチェックして、リソースが保護されているかどうか、保護されている場合はどのような方法で保護されているかを判断します。

4. OAMサーバーが判定をログして返します。

5. WebGateは、次のように応答します。

- 無保護リソース: リソースはユーザーに提供されます。

- 保護リソース:

- リクエストは資格証明コレクタにリダイレクトされます。

- 認証ポリシーに基づいてログイン・フォームが提供されます。

- 認証処理が開始します。

6. ユーザーが資格証明を送信します。

7. OAMが資格証明を検証します。

8. OAMがセッションを開始して、次のホストベースのCookieを作成します。

- パートナ当たり1つ: 認証に成功した後でOAMサーバーから受信される認証トークンを使用して、11g WebGateがOAMAuthnCookieを設定します(10g WebGateの場合はObSSOCookie)。
注意: セッションには有効なCookieが必要です。

- OAMサーバーに1つ: OAM_ID

9. OAMが成功または失敗をログします。

10. OAM資格証明コレクタがWebGateにリダイレクトし、認可処理が開始します。

11. ポリシーをルックアップして、それらをユーザーのアイデンティティと比較し、ユーザーの認可レベルを判定するようにWebGateがOAMに指示します。

12. OAMがポリシーに関する判定をログして、セッションCookieをチェックします。

13. OAMサーバーが認可ポリシーを評価して、結果をキャッシュします。

14. OAMサーバーが判定をログして返します。

15. WebGateは、次のように応答します。

- 認可ポリシーでアクセスが許可されている場合は、次に示すように、リクエストはmod_wlにリダイレクトされ、さらにWebCenter PortalまたはPortal Frameworkアプリケーションを実行中のWLSサーバーにリダイレクトされて、そこから目的のコンテンツやアプリケーションがユーザーに提供されます。
WebGate→mod_wl→WebCenter PortalまたはPortal Frameworkアプリケーション(ディスカッションなど)→コンテンツが認証されたユーザーに提供されます

- 認可ポリシーでアクセスが拒否されている場合は、管理者が決定した別のURLにユーザーはリダイレクトされます。

33.2.2 OAM構成のロードマップ

この項のフロー・チャート(図33-3)と表(表33-1)は、OAMを使用してWebCenter PortalまたはPortal Frameworkアプリケーションのシングル・サインオンを構成する際の前提条件と必要なタスクの概要を示しています。

図33-3 OAMを使用したWebCenter Portalのシングル・サインオンの構成

表33-1は、OAMを使用してWebCenter Portalのシングル・サインオンを構成するためのタスクとサブタスクを示しています。

表33-1 OAMを使用したWebCenter Portalのシングル・サインオンの構成

担当者

タスク

サブタスク

ノート

管理者

1. OAMのインストールと構成

OAM 10gまたは11gのインストールと構成。

2. OAM用のWebLogicドメインの構成

2.a OIDオーセンティケータの構成

2.b OAMアイデンティティ・アサータの構成

2.c デフォルト・オーセンティケータとプロバイダの順序の構成

2.d OAM SSOプロバイダの追加

3. OHSのインストールと構成

4. 必要に応じた追加構成の実行

4.a SSO用のWebCenter Portalの構成

4.b SSO用のディスカッション・サーバーの構成

4.c SSO用のワークリストの構成

4.d 外部リーダーを使用したRSSフィード用のOAMの構成

4.e WLS管理コンソールとEnterprise Managerの構成(OAM 11gまたはOAM 10g用)

4.f OAM用のContent Serverの構成

4.g 接続フィルタを使用したアクセスの制限

5. OAMインストールのテスト

33.2.3 OAMのインストールと構成

この項では、OAM 11gまたはOAM 10gのインストールおよび構成方法と、WebCenter PortalおよびPortal Frameworkアプリケーションに推奨されるシングル・サインオン・ソリューションを説明します。

注意:
OAMのインストールは、Oracle WebCenter Portalのインストール後(『Oracle WebCenter Portalインストレーション・ガイド』を参照)および環境に必要な他のすべてのコンポーネントのインストール後に実行してください。また、必要な接続も、すべて事前に構成およびテストしてください。

この項には次のサブセクションが含まれます:

- 第33.2.3.1項「OAM 11gのインストールと構成」

- 第33.2.3.2項「OAM 10gのインストールと構成」

33.2.3.1 OAM 11gのインストールと構成

この項ではOAM 11gのインストールおよび構成方法について説明し、次の内容を含みます。

- 第33.2.3.1.1項「OAM 11gのインストールと構成」

- 第33.2.3.1.2項「Oracle HTTP Serverのインストールと構成」

- 第33.2.3.1.3項「Web層でのWebGateのインストール」

- 第33.2.3.1.4項「WebGateエージェントの登録」

33.2.3.1.1 OAM 11gのインストールと構成

『Oracle Identity Managementインストレーション・ガイド』のOracle Identity Management (11.1.1.9.0)のインストールと構成に関する項の説明に従って、Oracle Access Manager (OAM)をインストールします。理想的なシナリオは、OAMとシングル・サインオンに参加するすべてのアプリケーションが同じアイデンティティ・ストアを共有することです。デフォルトでは、OAMは組込みのLDAPアイデンティティ・ストアを使用します。

OIDのような外部アイデンティティ・ストアを使用するようにOAMを構成するには、Oracle Fusion Middleware Oracle Access ManagerおよびOracle Security Token Service管理者ガイドの新規ユーザー・アイデンティティ・ストアの登録に関する項を参照してください。この項には、デフォルトまたはシステム・ストアとして構成された外部アイデンティティ・ストアを設定し、このストアをポイントするように1つ以上の認証モジュールを構成するためのポインタが示されています。デフォルトでは、OAMに構成されたWebCenterポリシーは、OAMに指定されたデフォルト認証スキーム(通常はフォームベースの認証スキームLDAPScheme)を使用します。デフォルト・スキームを使用する場合は、スキームが使用する認証モジュールは、WebCenterのインストールと同じアイデンティティ・ストアをポイントする必要があります。オプションとして、デフォルト以外の認証スキームを構成することができます。この場合も、WebCenterが使用するアイデンティティ・ストアをこれが確実にポイントするようにしてください。それから、『Oracle Identity Managementインストレーション・ガイド』のOracle Identity Management (11.1.1.9.0)のインストールと構成に関する項の説明に従って、WebLogic管理ドメインでOracle Access Managerを構成します。

33.2.3.1.2 Oracle HTTP Serverのインストールと構成

Oracle HTTP Server (OHS)がインストールされていない場合、第33.2.5項「Oracle HTTP Serverのインストールと構成」の説明に従ってOHS (11.1.1.4.0)をインストールします。

既存のインストールがある場合は、パッチ適用ガイドの最新のOracle Fusion Middlewareパッチ・セットの適用に関する項の説明に従ってパッチを適用して、OHS (11.1.1.4.0)にする必要があります。

OHSのインストールまたはパッチ適用が終了したら、第33.2.3.1.3項「Web層でのWebGateのインストール」の説明に従ってWebGateをインストールします。

33.2.3.1.3 Web層でのWebGateのインストール

この項では、OHS WebGateのインストールおよび構成方法について説明します。

注意:
OHS WebGateのインストール中は必ずOracle HTTP Serverを停止し、第33.2.3.1.4項「WebGateエージェントの登録」の説明に従ってWebGateエージェントを登録した後でのみ再起動してください。

1. 『Oracle Identity Managementインストレーション・ガイド』のOAM用のOracle HTTP Server 11g WebGateのインストールと構成の説明に従って、WebGateをインストールします。OHSのインストール時に指定したものと同じミドルウェア・ホームを使用します。

2. Oracle Access Manager用のOracle HTTP Server 11g WebGateをインストールしたら、WebGate用のOracleホームの下にある次のディレクトリに移動します。
UNIXオペレーティング・システムの場合:

<Webgate_Home>/webgate/ohs/tools/deployWebGate

Windowsオペレーティング・システムの場合:

<Webgate_Home>\webgate\ohs\tools\deployWebGate

3. コマンド行で次のコマンドを実行して、必要なエージェントの部分をWebgate_HomeディレクトリからWebGateインスタンスの場所にコピーします。
UNIXオペレーティング・システムの場合:

./deployWebGateInstance.sh -w <Webgate_Instance_Directory> -oh <Webgate_Oracle_Home>

Windowsオペレーティング・システムの場合:

deployWebGateInstance.bat -w <Webgate_Instance_Directory> -oh <Webgate_Oracle_Home>

<Webgate_Oracle_Home>には、次の例のように、Oracle HTTP Server WebGateがインストールされており、かつWebGateのOracleホームとして定義されているディレクトリを指定します。

<MW_HOME>/Oracle_OAMWebGate1

<Webgate_Instance_Directory>には、次の例のように、WebGateインスタンス・ホームの場所を指定します(これはOracle HTTP Serverのインスタンス・ホームと同じであることが必要です)。

<MW_HOME>/Oracle_WT1/instances/instance1/config/OHS/ohs1

Oracle HTTP Serverのインスタンス・ホームは、Oracle HTTP Serverの構成後に作成されることに注意してください。この構成は、Oracle HTTP Server 11.1.1.4.0のインストールまたはパッチ適用後に実行する必要があります。

4. 次のコマンドを実行して、LD_LIBRARY_PATH変数に<Oracle_Home_for_Oracle_HTTP_Server>/libが含まれていることを確認します。
UNIXオペレーティング・システムの場合(シェルにより異なる):

export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<Oracle_Home_for_Oracle_HTTP_Server>/lib

Windowsオペレーティング・システムの場合:

<Webgate_Installation_Directory>\webgate\ohs\libおよび<Oracle_Home_for_Oracle_HTTP_Server>\binの場所をPATH環境変数に追加します。PATH環境変数のエントリの末尾に、セミコロン(;)に続けてこのパスを追加します。

5. 現在の作業ディレクトリから、1つ上のレベルに移動します。
UNIXオペレーティング・システムの場合、次に移動します。

<Webgate_Home>/webgate/ohs/tools/setup/InstallTools

Windowsオペレーティング・システムの場合、次に移動します。

<Webgate_Home>\webgate\ohs\tools\EditHttpConf

6. コマンド行で次のコマンドを実行して、apache_webgate.templateをWebgate_HomeディレクトリからWebGateインスタンスの場所にコピーします(webgate.confにその名前を変更します)。さらに、httpd.confファイルを更新し、1行を追加してwebgate.confファイルの名前を含めます。
UNIXオペレーティング・システムの場合:

./EditHttpConf -w <Webgate_Instance_Directory> [-oh <Webgate_Oracle_Home>] [-o <output_file>]

Windowsオペレーティング・システムの場合:

EditHttpConf.exe -w <Webgate_Instance_Directory> [-oh <Webgate_Oracle_Home>] [-o <output_file>]

注意:
-oh <WebGate_Oracle_Home>および-o <output_file>パラメータはオプションです。

<Webgate_Oracle_Home>には、次の例のように、Oracle HTTP Server WebGateがインストールされており、かつWebGateのOracleホームとして定義されているディレクトリを指定します。

<MW_HOME>/Oracle_OAMWebGate1

<Webgate_Instance_Directory>には、次の例のように、WebGateインスタンス・ホームの場所を指定します(これはOHSのインスタンス・ホームと同じであることが必要です)。

<MW_HOME>/Oracle_WT1/instances/instance1/config/OHS/ohs1

33.2.3.1.4 WebGateエージェントの登録

Web層にWebGateをインストールしたら、WebGateエージェントの登録も行う必要があります。次の手順では、OAMのインストールで構成されたデフォルト認証スキーム(通常はフォームベースの認証スキームLDAPScheme)を使用する保護されたポリシーを自動的に作成します。シングル・サインオンのログイン・ページをカスタマイズしたい場合、または他の認証スキームでリソースを保護したい場合は、OAMコンソールを使用してそれを変更してください(詳細は、Oracle Fusion Middleware Oracle Access ManagerおよびOracle Security Token Service管理者ガイドの「認証スキームの管理」の章を参照)。

注意:
環境でWebCenter Portalとともに他のアプリケーションを使用しており、これらのアプリケーションにシングル・サインオンが必要な場合は、これらのアプリケーションで使用される認証スキームが同じであるか、少なくとも同じレベルで、同じアイデンティティ・ストアをポイントしていることが必要です。

WebGateエージェントの登録の詳細は、『WebGate for Oracle Access Managerのインストール』の新しいOracle HTTP Server 11g WebGateのスタート・ガイドに関する項も参照してください。

次の手順に従って、インバンド・モードでoamregツールを使用して、OAMがインストールされているマシン上でWebGateエージェントを登録します。

1. ディレクトリを<RREG_Home>/inputに変更します(ここで<RREG_Home>はRREG.tar.gz/rregのコンテンツを抽出したディレクトリです)。

2. このOracle WebCenter Portalのインストールから$WEBCENTER_HOME/webcenter/scripts/webcenter.oam.confをコピーします。
WEBCENTER_HOMEのデフォルトの場所は$ORACLE_HOME/Oracle_WC1です。

3. SOAとContent Serverのインストールから、$SOA_HOME/soa/prov/soa.oam.confおよび$WC_CONTENT_ORACLE_HOME/common/security/oam.confをそれぞれコピーします。
SOA_HOMEのデフォルトの場所は$ORACLE_HOME/Oracle_SOA1であり、WC_CONTENT_ORACLE_HOMEのデフォルトの場所は$ORACLE_HOME/Oracle_ECM1です。soa.oam.confに含まれるSOA関連のロケーション・マッピングは、WebCenter Portalで提供されるワークフローをSOAサーバーにデプロイして使用する場合にのみ有効になりますが、SOAが使用されている場合は、webcenter.oam.conf内で保護されているSOA関連のURLも有効になります。

4. oamregツールのパラメータ・ファイルとして機能するWebCenterOAM11gRequest.xmlという名前の新しいファイルを作成します。
次の例で、$$webtier..$$内の内容は該当するWeb層ホストとポートIDで置き換え、$$oam...$$はOAMホストと管理サーバー・ポートで置き換えます。

<?xml version="1.0" encoding="UTF-8"?>

<!--
Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved.

NAME: OAM11GRequest_short.xml - Template for OAM 11G Agent Registration Request file
(Shorter version - Only mandatory values - Default values will be used for all other fields)
DESCRIPTION: Modify with specific values and pass file as input to the tool.
-->
<OAM11GRegRequest>
<serverAddress>http://$$oamhost$$:$$oamadminserverport$$</serverAddress>
<hostIdentifier>$$webtierhost$$_webcenter</hostIdentifier>
<agentName>$$webtierhost$$_webcenter</agentName>
<logOutUrls>
<url>/oamsso/logout.html</url>
</logOutUrls>
</OAM11GRegRequest>

5. ディレクトリを<RREG_Home>に変更します。

6. 次のコマンドを実行します。

<RREG_Home>/bin/oamreg.sh inband input/WebCenterOAM11gRequest.xml

- エージェントの資格証明を入力するように求められたら、OAM管理者の資格証明を入力します。

- WebGateのパスワードを入力します。

- URIファイルをインポートするかどうか尋ねられたら、yesと入力します。以前コピーした<RREG_HOME>/input/webcenter.oam.confファイルのフルパスを指定します。
登録が成功したことを示す次のような出力が表示されます。

----------------------------------------
Request summary:
OAM11G Agent Name:example_webcenter
URL String:example_webcenter
Registering in Mode:inband
Your registration request is being been sent to the Admin server at: http://example.com:7001
----------------------------------------
Inband registration process completed successfully! Output artifacts are created in the output folder.

7. 生成されたファイルとアーティファクト(ObAccessClient.xmlとcwallet.sso)を<RREG_Home>/output/$$webtierhost$$_webcenterからWebGateインスタンスの構成ディレクトリ(<Webgate_Instance_Directory>/webgate/config)にコピーします。次の例のように、<Webgate_Instance_Directory>は、OHSのインスタンス・ホームと一致する必要があることに注意してください。

<MW_HOME>/Oracle_WT1/instances/instance1/config/OHS/ohs1/webgate/config

8. ディレクトリを<RREG_Home>/inputに変更します。

9. SOAまたはWebCenter Content Serverがインストールされている場合は、次の手順に従います。

1. 次の例に示されているように、WebCenterOAM11gPolicyUpdate.xmlというポリシー更新ファイルを作成します。以前に行ったように、$$webtier..$$内の内容はWeb層ホストとポートIDに、$$oam...$$はOAMホストと管理サーバー・ポートに置き換えます。

<?xml version="1.0" encoding="UTF-8"?>

<!--
Copyright (c) 2009, 2011, Oracle and/or its affiliates. All rights reserved.

NAME: UpdatePolicyRequest.xml - Template for updating application domain and/or policies without changes to any agent profile
DESCRIPTION: Modify with specific values and pass file as input to the tool
-->
<PolicyRegRequest>

<serverAddress>http://$$oamhost$$:$$oamadminserverport$$</serverAddress>
<hostIdentifier>$$webtierhost$$_webcenter</hostIdentifier>
<applicationDomainName>$$webtierhost$$_webcenter</applicationDomainName>

</PolicyRegRequest>

2. 次のコマンドを実行します。

<RREG_Home>/bin/oamreg.sh policyUpdate input/WebCenterOAM11gPolicyUpdate.xml

入力を要求されたら、OAMの資格証明を入力します。URIファイルをインポートするかどうか尋ねられたら、yesと入力して、<RREG_HOME>/input/soa.oam.confを指定します。

ポリシーはSOAリソースを使用して更新されます。

3. 再度policyUpdateコマンドを実行します。今回は<RREG_HOME>/input/oam.confを指定して、Content Serverのリソースを使用してポリシーを更新します。これでポリシーに、Oracle WebCenter Portal、SOAおよびContent Serverのアーティファクトが含まれます。

10. OAMコンソールから、次のアーティファクトを表示できるはずです。

- $$webtierhost$$_webcenterという名前の11g WebGateエージェント

- 同じ名前の11gホスト識別子

- 認証ポリシーと認可ポリシー(保護されたポリシーとパブリック・ポリシーを含む)を含む同じ名前のアプリケーション・ドメイン

11. 「アプリケーション・ドメイン」→$$webtierhost$$_webcenter→「認証ポリシー」に移動します。次のポリシーを表示できるはずです。

- 除外スキーム

- 保護されたリソース・ポリシー

- パブリック・リソース・ポリシー

- WebCenter RESTポリシー

12. WebCenter RESTポリシーを開いて、認証スキームがBasicSessionlessSchemeまたはBasicSchemeに設定されていることを確認します。

13. 「リソース」タブを開いて、認証ポリシーがExclusion Schemeに設定されているリソースを検索します。次のリソースが表示されるはずです。

- /rsscrawl*

- /rsscrawl/.../*

- /sesUserAuth*

- /sesUserAuth/.../*

- /services-producer/portlets*

- /services-producer/portlets/.../*

- /wsrp-tools/portlets

- /wsrp-tools/portlets/.../*

14. 検索結果の/rsscrawl*リソースを選択して、「編集」をクリックします。

15. 保護レベルをProtectedからExcludedに変更して、「適用」をクリックします。リソースの認証ポリシーと認可ポリシーが削除されることに注意してください。

16. 「リソース」タブを閉じて、残りのExclusion Schemeリソースについてこの手順を繰り返します。
この時点で認証ポリシーがExclusion Schemeに設定されているリソースを検索すると、結果はゼロになります。

17. OHSを再起動します。

18. Web層と関連するコンポーネントをインストールおよび構成したら、第33.2.4項「OAM用のWebLogicドメインの構成」の説明に従ってポリシー・マネージャを構成し、第33.2.6項「追加のシングル・サインオン構成」の説明に従って適用される追加のサービスとコンポーネントの構成を実行します。

33.2.3.2 OAM 10gのインストールと構成

この項では、OAM 10gのインストールおよび構成方法について説明し、次の内容を含みます。

- 第33.2.3.2.1項「OAM 10gのインストールと構成」

- 第33.2.3.2.2項「Oracle HTTP Serverのインストールと構成」

- 第33.2.3.2.3項「WebCenter Portalポリシー・ドメインの構成」

- 第33.2.3.2.4項「Web層でのWebGate 10gのインストール」

33.2.3.2.1 OAM 10gのインストールと構成

まだOracle Access Manager (OAM) 10gをインストールしていない場合は、Oracle Access Managerインストレーション・ガイドの説明に従ってOAM 10gをインストールします。

33.2.3.2.2 Oracle HTTP Serverのインストールと構成

Oracle HTTP Server (OHS)がインストールされていない場合、第33.2.5項「Oracle HTTP Serverのインストールと構成」の説明に従ってOHS (11.1.1.4.0)をインストールします。

既存のインストールがある場合は、パッチ適用ガイドの最新のOracle Fusion Middlewareパッチ・セットの適用に関する項の説明に従ってパッチを適用して、OHS (11.1.1.4.0)にする必要があります。

OHSのインストールまたはパッチ適用を行ったら、第33.2.3.2.3項「WebCenter Portalポリシー・ドメインの構成」の説明に従ってWebGateをインストールします。

33.2.3.2.3 WebCenter Portalポリシー・ドメインの構成

この手順では、Oracle WebCenter Portalをインストール済であることを前提としています。デフォルトでは、Oracle WebCenter Portalのインストールによって、1台の管理サーバーと4台の管理対象サーバー(WC_Spaces、WC_Collaboration、WC_UtilitiesおよびWC_Portlet)を含むWebLogic Serverドメインが作成されます。

1. 使用するアクセス・サーバーを決定します。

1. Access Managerにログオンします。

2. 「アクセス・システム・コンソール」をクリックします。

3. 「アクセス・システム構成」タブを開きます。

4. 「アクセス・サーバー構成」をクリックして、すべてのアクセス・サーバーのリストを表示します。

5. リスト内のアクセス・サーバーをクリックして、サーバーの詳細を表示します。
ホストの名前とポートは、それぞれ、スクリプトのoam_aaa_hostおよびoam_aaa_portパラメータに必要な値です。

2. OAM 10gのインストールにOraDefaultExclusionAuthNSchemeがあることをチェックします。ない場合は、次のようにOraDefaultExclusionAuthNSchemeを作成します。

1. OAMアクセス・システム・コンソールを開きます。

2. 「認証管理」をクリックします。

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

4. 「名前」フィールドにOraDefaultExclusionAuthNSchemeと指定します。

5. 「説明」フィールドにTo exclude resources from being protected by OAMと入力します。

6. 「レベル」フィールドに0と入力します。

7. 「チャレンジ・メソッド」フィールドにNoneと指定します。

8. 「チャレンジ・パラメータ」フィールドにunprotected:trueを追加します。

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

10. この認証スキームの「プラグイン」タブを開いて「変更」をクリックします。

11. ドロップダウン・リストからcredential_mappingを選択します。

12. 次のように値を指定します。
obMappingBase="dc=us,dc=oracle,dc=com",obMappingFilter="(uid=OblixAnonymous)"

この値がOraDefaultAnonAuthNSchemeの対応するフィールドと一致することを確認してください。

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

14. 再度「一般」タブを開いて、「変更」をクリックします。

15. 「有効」についてYesをチェックします。

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

3. 次のコマンドを実行します。
oamcfgtool.jarは、WebCenter PortalインストールのORACLE_HOME/modules/oracle.oamprovider_11.1.1/oamcfgtool.jarにあります。太字の値は、WebCenter PortalおよびOAMインスタンスの設定に基づいて指定する必要があります。

java -jar ORACLE_HOME/modules/oracle.oamprovider_11.1.1/oamcfgtool.jar
mode=CREATE app_domain=<your_domain_name>
uris_file=WEBCENTER_HOME/webcenter/scripts/webcenter.oam.conf"
app_agent_password=<Password to be provisioned for App Agent>
ldap_host=<Hostname of LDAP server> ldap_port=<Port of LDAP server>
ldap_userdn=<DN of LDAP Admin User, usually "cn=orcladmin">
ldap_userpassword=<Password of LDAP Admin User>
oam_aaa_host=<HOST of OAM server> oam_aaa_port=<Port of OAM server>

ドメイン(<your_domain_name>)はwebtier.example.comのように登録することをお薦めします。OAM内の各種ポリシーを容易に区別できるように、webtier.example.comにはWeb層を指定します。

コマンドが正常に実行されると、使用した値に応じて次のような出力が表示されます。

Processed input parameters
Initialized Global Configuration
Successfully completed the Create operation.
Operation Summary:
Policy Domain : webtier.example.com
Host Identifier: webtier.example.com
Access Gate ID : webtier.example.com_AG

また、Validateコマンドを実行して、構成を検証できます。

java -jar WCP_ORACLE_HOME/modules/oracle.oamprovider_11.1.1/oamcfgtool.jar mode=VALIDATE app_domain=<your_domain_name>
ldap_host=<Hostname of LDAP server> ldap_port=<Port of LDAP server>
*ldap_userdn=<DN of LDAP Admin User, usually "cn=orcladmin">*
ldap_userpassword=<Password of LDAP Admin User>
oam_aaa_host=<HOST of OAM server>
oam_aaa_port=<Port of OAM server>
test_username=<Username to be used for policy validation> test_userpassword=<Userpassword to be used for policy validation>

コマンドが正常に実行されると、前述と同じ出力が表示されます。

4. インスタンスにSOAインストールも含まれている場合は、再度oamcfgtoolを実行して、前の手順で作成したポリシー・ドメインのSOA URIを保護します。既存のポリシー・ドメインがsoa.oam.confファイルのURIで更新されるように、前の手順で使用したものと同じパラメータを使用してください。

java -jar ORACLE_HOME/modules/oracle.oamprovider_11.1.1/oamcfgtool.jar
mode=CREATE app_domain=<your_domain_name>
uris_file="SOA_HOME/soa/prov/soa.oam.conf"
app_agent_password=<Password to be provisioned for App Agent>
ldap_host=<Hostname of LDAP server>
ldap_port=<Port of LDAP server>
ldap_userdn=<DN of LDAP Admin User, usually "cn=orcladmin">
ldap_userpassword=<Password of LDAP Admin User>
oam_aaa_host=<HOST of OAM server>
oam_aaa_port=<Port of OAM server>

5. インストールにContent Serverが含まれている場合は、これらのURIも保護する必要があります。既存のポリシー・ドメインがContent Serverのoam.confファイルのURIで更新されるように、前の手順で使用したものと同じパラメータを使用してください。

java -jar ORACLE_HOME/modules/oracle.oamprovider_11.1.1/oamcfgtool.jar
mode=CREATE app_domain=<your_domain_name>
uris_file="WC_CONTENT_ORACLE_HOME/common/security/oam.conf"
app_agent_password=<Password to be provisioned for App Agent>
ldap_host=<Hostname of LDAP server>
ldap_port=<Port of LDAP server>
ldap_userdn=<DN of LDAP Admin User, usually "cn=orcladmin">
ldap_userpassword=<Password of LDAP Admin User>
oam_aaa_host=<HOST of OAM server>
oam_aaa_port=<Port of OAM server>

6. ポリシー・ドメインの設定をチェックします。

1. Oracle Access Managerにログオンします。

2. 「ポリシー・マネージャ」をクリックします。

3. 「ポリシー・ドメイン」をクリックします。
ポリシー・ドメインのリストに、今作成したドメインが表示されているはずです。また、URL接頭辞列に、webcenter.oam.confスクリプト・ファイルの一部として指定されたURIも表示されます。SOAおよびContent Serverドメインからoamcfgtoolを実行すると、SOAおよびContent Server OAM構成ファイルからURIを表示できます。

4. 今作成したドメインをクリックして、「リソース」タブを開きます。
指定したURIが表示されます。また、他のタブを開いて他の設定を表示および確認したり、後で必要に応じて他のリソースを手動で追加したりすることもできます。

7. アクセス・ゲートの構成をチェックします。

1. 「アクセス・システム・コンソール」をクリックします。

2. 「アクセス・システム構成」タブを開きます。

3. 「アクセス・ゲート構成」をクリックします。

4. 検索条件を入力して「実行」をクリックします。

5. 作成したドメインのアクセス・ゲートが表示されたら(これは_AGという接尾辞を持ちます)、これをクリックして設定の詳細を表示します。

8. 前の手順で作成および確認したポリシー・ドメインを見つけて、「ポリシー」タブを開きます。
作成済の4つのポリシーが表示されます。

- WebCenter REST Policy

- Exclusion Scheme

- Protected_JSessionId_Policy

- Default Public Policy

9. WebCenter REST Policyを選択し、「認証ルール」を選択して「変更」をクリックします。

10. AuthenticationSchemeを(OraDefaultFormAuthNSchemeから)OraDefaultBasicAuthNSchemeに変更します。

11. 「除外スキーム・ポリシー」→「認証ルール」に移動して、それがAuthenticationSchemeとしてOraDefaultExclusionAuthNScheme(前の手順で作成)を使用していることを確認します。

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

13. 「ポリシー」タブを開き、ポリシーが次の順序になっていることを確認します。

Protected_JSessionId_Policy
WebCenter REST Policy
Exclusion Scheme
Default Public Policy

14. 第33.2.3.2.4項「Web層でのWebGate 10gのインストール」の説明に従って、WebGateのインストール手順を続行します。

33.2.3.2.4 Web層でのWebGate 10gのインストール

この項では、WebGateのインストール方法を説明します。

WebGateをインストールする手順は次のとおりです。

1. インストールに必要な2つのgccライブラリ(libgcc_s.so.1とlibstdc++.so.5)を含むZIPファイル(Oracle_Access_Manager10_1_4_3_0_linux_GCClib.zip)を/tmpディレクトリにコピーします。詳細は、Oracle Access Managerインストレーション・ガイドのWebGateのインストールに関する項を参照してください。

2. rootとしてインストールを実行します。たとえば、/tmpディレクトリから次を実行します。

sudo -u root ./Oracle_Access_Manager10_1_4_3_0_linux_OHS11g_WebGate

3. インストール実行時の指示に従って、インストール・ディレクトリ、以前に作成したアクセス・ゲートの情報およびWebサーバーのhttpd.confファイルの絶対パスを指定します。例:

WT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/httpd.conf

アクセス・ゲートの情報は、アクセス・システム・コンソールにあります。

4. インストール後、httpd.confファイルの次のエントリの間に新しいセクションが挿入されます。

#** BEGIN WEBGATE SPECIFIC ***
#** END Oblix NetPoint Specific ***

この内容が環境と一致していることをチェックしてください。

5. WebGate 10gをインストールおよび構成したら、第33.2.4項「OAM用のWebLogicドメインの構成」の説明に従ってWeblogicドメインを構成し、第33.2.6項「追加のシングル・サインオン構成」の説明に従って適用される追加のサービスとコンポーネントの構成を実行します。

33.2.4 OAM用のWebLogicドメインの構成

環境が複数のドメインにまたがっている場合(例: WebCenter Portalのドメイン、別個のSOAのドメインおよび別個のContent Serverのドメイン)、それぞれのドメインについてこの項の手順を繰り返してください。

この項には次のサブセクションが含まれます:

- 第33.2.4.1項「Oracle Internet Directoryオーセンティケータの構成」

- 第33.2.4.2項「OAMアイデンティティ・アサータの構成」

- 第33.2.4.3項「デフォルト・オーセンティケータとプロバイダの順序の構成」

- 第33.2.4.4項「OAMシングル・サインオン・プロバイダの追加」

33.2.4.1 Oracle Internet Directoryオーセンティケータの構成

Oracle Internet DirectoryがOAMアイデンティティ・ストアをバッキングしている場合、Oracle Internet Directoryオーセンティケータ(OracleInternetDirectoryAuthenticator)はOAMのアイデンティティ・ストアとして使用されているLDAPサーバー用に構成し、プロバイダはSUFFICIENTに設定する必要があります。

Oracle Internet Directoryオーセンティケータを構成するには:

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます。

3. OIDオーセンティケータを構成するレルム・エントリをクリックします。
レルムの「設定」ペインが表示されます。

4. 「プロバイダ」タブを開きます。
「プロバイダ設定」が表示されます。

5. 「新規」をクリックして、プロバイダを作成します。
「新しい認証プロバイダの作成」ペインが表示されます。

6. 新しいプロバイダの名前(例: OID Authenticator)を入力し、そのタイプとしてOracleInternetDirectoryAuthenticatorを選択して、「OK」をクリックします。

7. 「プロバイダ」タブで、新しく追加したプロバイダをクリックします。
オーセンティケータの「共通設定」ペインが表示されます。

8. 制御フラグをSUFFICIENTに設定し、「保存」をクリックします。

9. 「プロバイダ固有」タブを開きます。
オーセンティケータのプロバイダ固有の設定ペインが表示されます。

10. 次の表に示されているように、各フィールドに値を入力します。これら以外のフィールドは、デフォルト値のままにします。

フィールド

値

コメント

ホスト:

LDAPサーバーのホストID

ポート:

LDAPサーバーのポート番号

プリンシパル:

LDAP管理者プリンシパル(例: cn=orcladmin)

資格証明:

<password>

管理者プリンシパルのパスワード

資格証明の確認:

<password>

ユーザー・ベースDN:

ユーザー検索ベース - この値はOAM Access Managerのセットアップの値と同じであることが必要

すべてのユーザーのフィルタ:

"(&(uid=*)(objectclass=person))"

指定したユーザー名属性は、「すべてのユーザーのフィルタ」、「ユーザー名属性」および「名前指定によるユーザー・フィルタ」の3つのフィルタに一致する必要があります。

ユーザー名属性:

"uid"

名前指定によるユーザー・フィルタ:

"(&(uid=%u)(objectclass=person))"

グループ・ベースDN:

グループ検索ベース - ユーザー・ベースDNと同じ

取得したユーザー名をプリンシパルとして使用する

選択

通常はユーザー・ログインIDでは大/小文字は区別されません。このフラグは、設定されたサブジェクトに、OIDに格納されたユーザー名が含まれるようにするために必要とされます。

注意:
「ユーザー名属性」、「すべてのユーザーのフィルタ」および「名前指定によるユーザー・フィルタ」のすべてのフィールドが、同じOID属性(この場合はuid)をポイントし、OAMのアイデンティティ・ストア構成に一致する必要があります。また、これらの3つのフィールドは、OAMおよびWebCenter Portalと同様にシングル・サインオンに参加するすべてのサービスでも一致する必要があります。

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

33.2.4.2 OAMアイデンティティ・アサータの構成

OAMアイデンティティ・アサータは、プロバイダの制御フラグをREQUIREDに設定して構成する必要があります。

OAMアイデンティティ・アサータを構成するには:

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます。

3. OAMアイデンティティ・アサータを構成するレルム・エントリをクリックします。
レルムの「設定」ペインが表示されます。

4. 「プロバイダ」タブを開きます。
「プロバイダ設定」が表示されます。

5. 「新規」をクリックして、プロバイダを作成します。
「新しい認証プロバイダの作成」ペインが表示されます。

6. 新しいプロバイダの名前(例: OAM ID Asserter)を入力し、そのタイプとしてOAMIdentityAsserterを選択して、「OK」をクリックします。

7. 「プロバイダ」タブで、新しく追加したプロバイダをクリックします。
オーセンティケータの「共通設定」ペインが表示されます。

8. 制御フラグをREQUIREDに設定し、OAM_REMOTE_USERとObSSOCookieが「アクティブなタイプ」に設定されていることをチェックします。

9. 「保存」をクリックして、設定を保存します。

33.2.4.3 デフォルト・オーセンティケータとプロバイダの順序の構成

OAMアイデンティティ・アサータを構成したら、デフォルト・オーセンティケータの制御フラグがSUFFICIENTに設定されていることを確認して、次のようにプロバイダを並べ替えます。

1. プロバイダの設定ペインに移動します。

2. デフォルト・オーセンティケータを開き、制御フラグがSUFFICIENTに設定されていることを確認します。

3. 先ほど作成した2つのプロバイダ以外の全プロバイダについて、同じことを行います。

4. 設定ペインで、プロバイダの順序を次のようにリセットします:

- OAMIdentityAsserter (REQUIRED)

- OracleInternetDirectoryAuthenticator (SUFFICIENT)

- DefaultAuthenticator (SUFFICIENT)

- DefaultIdentityAsserter

5. 第33.2.6.1項「SSO用のWebCenter Portalの構成」の説明に従って、シングル・サインオン・モード用にWebCenter Portalを構成します。 また、第33.2.6項「追加のシングル・サインオン構成」の説明に従って、環境に適用される他のサービスおよびコンポーネントの構成を行ってください。

33.2.4.4 OAMシングル・サインオン・プロバイダの追加

デフォルト・オーセンティケータの制御フラグが適切に設定されていることとプロバイダの順序が正しいことをチェックしたら、次で説明されているように、OAM SSOプロバイダを追加して、すべてのサーバーを再起動します。

注意:
これはOAM 11gの場合は必要ですが、OAM 10gの場合はログアウトURIが明示的に構成されている場合のみ必要です。

1. WLSTを使用してWebLogicドメインに接続し、次のコマンドを実行します。

addOAMSSOProvider(loginuri="/${app.context}/adfAuthentication", logouturi="/oamsso/logout.html")

2. すべてのサーバーを再起動します。

33.2.5 Oracle HTTP Serverのインストールと構成

この手順はOAM 10gとOAM 11gの両方に共通で、OAMのインストールおよび構成後、WebLogicドメインの構成前に実行する必要があります。

Oracle HTTP Server(OHS)をインストールおよび構成する手順は次のとおりです。

1. 使用するOHSのインストールがまだない場合は、『Oracle Web Tierインストレーション・ガイド』のOracle Web層のインストールと構成に関する項の指示に従ってOracle HTTP Server (11.1.1.4.0)をインストールします。既存のインストールがある場合は、パッチ適用ガイドの最新のOracle Fusion Middlewareパッチ・セットの適用に関する項の説明に従ってパッチを適用して、OHS (11.1.1.4.0)にする必要があります。

2. mod_wl_ohs.confの次の例を使用して、WebCenter Portal用のOracle WebLogic Serverにリクエストを転送するようにWeb層OHSを構成します。WebLogicポート番号が構成と一致するようにしてください。詳細は、Oracle Fusion Middleware Oracle Access Manager WebGateのインストールの「OAM用のOracle HTTP Server 11g WebGateのインストールと構成」を参照してください。

注意:
この例では、WebCenter Portalが非クラスタベースのインストールであることを前提としています。クラスタ化環境の場合は、WebLogicHostとWebLogicPortを環境の必要に応じてWeblogicClusterに変更してください。詳細は、Oracle Fusion Middleware Oracle Access Manager WebGateのインストールのOAM用のOracle HTTP Server 11g WebGateのインストールと構成に関する項を参照してください。

# NOTE : This is a template to configure mod_weblogic.

LoadModule weblogic_module   "${ORACLE_HOME}/ohs/modules/mod_wl_ohs.so"

# This empty block is needed to save mod_wl related configuration from EM to this file when changes are made at the Base Virtual Host Level
<IfModule weblogic_module>
#      WebLogicHost <WEBLOGIC_HOST>
#      WebLogicPort <WEBLOGIC_PORT>
#      Debug ON
#      WLLogFile /tmp/weblogic.log
#      MatchExpression *.jsp

<Location /webcenter>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /webcenterhelp>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /rss>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /rest>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /rsscrawl>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /sesUserAuth>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /owc_discussions/admin>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8890
</Location>

<Location /owc_discussions/OWCDiscussionsServicePublic>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8890
</Location>

<Location /owc_discussions/OWCDiscussionsServiceAuthenticated>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8890
</Location>

<Location /activitygraph-engines>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8891
</Location>

<Location /wcps>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8891
</Location>

<Location /workflow>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /integration/worklistapp>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /integration/services>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /soa-infra>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /sdpmessaging/userprefs-ui>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /DefaultToDoTaskFlow>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /cs>
SetHandler weblogic-handler
WebLogicHost ucm.example.com
WebLogicPort 16200
</Location>

<Location /adfAuthentication>
SetHandler weblogic-handler
WebLogicHost ucm.example.com
WebLogicPort 16200
</Location>

<Location /pagelets>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8889
</Location>

<Location /services-producer>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8889
</Location>

<Location /wsrp-tools>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8889
</Location>

<Location /wcsdocs>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
</Location>

<Location /_vti_bin>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
</Location

</IfModule>

# <Location /weblogic>
#      SetHandler weblogic-handler
#      PathTrim /weblogic
#      ErrorPage  http:/WEBLOGIC_HOME:WEBLOGIC_PORT/
#  </Location>

注意:
前述のLocationリストのエントリは、着信パスを、対応するアプリケーションが常駐する適切なWebLogic Server管理対象サーバーにマップします。SOA関連のロケーション・マッピングは、WebCenter Portalで提供されるワークフローをSOAサーバーにデプロイして使用する場合にのみ有効になります。

33.2.6 追加のシングル・サインオン構成

次の項で説明する構成は、サイトのセキュリティを強化するために必要であるか、または役に立ちます。これらの構成が完了したら、第33.2.7項「OAMインストールのテスト」の説明に従ってOAMインストールのテストを行ってください。

- 第33.2.6.1項「SSO用のWebCenter Portalの構成」

- 第33.2.6.2項「SSO用のディスカッション・サーバーの構成」

- 第33.2.6.3項「SSO用のワークリストの構成」

- 第33.2.6.4項「外部リーダーを使用したRSSフィード用のOAMの構成」

- 第33.2.6.5項「OAM 10g用のWebLogic Server管理コンソールとEnterprise Managerの構成」

- 第33.2.6.6項「OAM 11g用のWebLogic Server管理コンソールとEnterprise Managerの構成」

- 第33.2.6.7項「SSO用のSecure Enterprise Searchの構成」

- 第33.2.6.8項「SSO用のContent Serverの構成」

- 第33.2.6.9項「接続フィルタを使用したアクセスの制限」

- 第33.2.6.10項「ポートレット・プロデューサと追加コンポーネントの構成」

33.2.6.1 SSO用のWebCenter Portalの構成

WebCenter PortalアプリケーションをSSO用に構成するには、EXTRA_JAVA_PROPERTIESに設定を追加します。

アプリケーションがSSOモードに構成されており、特別な処理が必要であることをWebCenter PortalとADFに伝えるシステム・プロパティがあります。このモードでは、次のシステム・プロパティが必要とされます。

フィールド

値

コメント

oracle.webcenter.spaces.osso

true

このフラグはSSOが使用されていることをWebCenter Portalに告げるため、デフォルトのランディング・ページにログイン・フォームは表示されなくなります。そのかわりにログイン・リンクが表示され、ユーザーはこれをクリックしてSSO認証を呼び出すことができます。

このプロパティを設定するには、<domain>/binディレクトリにあるsetDomainEnv.shスクリプトを編集し、次のようなエントリを追加します。

EXTRA_JAVA_PROPERTIES="-Doracle.webcenter.spaces.osso=true ${EXTRA_JAVA_PROPERTIES}"
export EXTRA_JAVA_PROPERTIES

この変更を行ったら、WC_Spacesサーバーを再起動します。

33.2.6.2 SSO用のディスカッション・サーバーの構成

この項では、シングル・サインオン用のディスカッション・サーバーを構成する方法を説明します。SSO用のディスカッション・サーバーを構成する前に、第31.1項「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」の説明に従って、WebCenter Portalと同じアイデンティティ・ストアLDAPを使用するようにこれが構成されていることを確認してください。デフォルトの管理者アカウントを外部LDAPに移動しない場合は、第31.4.1項「ディスカッション・サーバーの新しい管理者アカウントの識別」の手順にも従ってください。

注意:
SSOの構成後は、ディスカッション・サーバーへの直接のログインはサポートされません。ログインはOracle HTTP Server URLを通して行う必要があります。

SSO用のディスカッション・サーバーを設定する手順は次のとおりです。

1. ディスカッション・サーバー管理コンソールにログインします。

http://host:port/owc_discussions/admin

hostおよびportは、WC_Collaboration管理対象サーバーのホストIDとポート番号です。

2. 「システム・プロパティ」ページを開き、owc_discussions.sso.modeプロパティを編集(存在している場合)または追加します(値をtrueに設定します)。

3. Web層のベースURLをポイントするようにjiveURLプロパティを編集または追加します。例:

jiveURL = webtier.example.com:7777/owc_discussions

jiveURLプロパティは、電子メールのフォーラムへのリンクを構築する際に使用されます。

注意:

WebCenter Portalでディスカッションおよびフォーラム用に登録したWebCenter接続は、OHS URLをポイントしている必要があります。

33.2.6.2.1 WebCenter Portal用のディスカッション・サーバー接続の作成

この項では、Web層のホストおよびポートの値を使用するようにWebCenter Portal用のディスカッション・サーバー接続を更新する方法を説明します。次の手順では、ディスカッション・コンポーネントがWebCenter Portalドメインにすでにインストールおよび構成されていることを前提としています。

1. Fusion Middleware ControlまたはWLSTを使用して、ディスカッション・サーバーのURLホストおよびポート設定をWC_Spaces管理対象サーバーの設定からWeb層のホストおよびポート設定に変更します。これらの設定の変更方法については、第12.5項「ディスカッション・サーバー接続の詳細の変更」を参照してください。

2. WC_Spaces管理対象サーバーを再起動します。
WebCenter Portalにログインすると、ディスカッション・サーバーにも自動的にサインオンします。

33.2.6.3 SSO用のワークリストの構成

すでにワークリスト接続をセットアップしてある場合は、SOAサーバーのホストとポートのかわりにWeb層のホストとポートを使用するようにURLを変更します。これは第20.4項「ワークリスト接続の設定」の説明に従って、Fusion Middleware ControlまたはWLSTコマンドを使用して行うことができます。

URLを変更してOAM SSOに必要な設定を完了したら、WebCenter Portal管理サーバー上で次のコマンドを実行してワークリストの変更を有効にします。

setBPELConnection('webcenter','WebCenter-Worklist', 'http://webtier.example.com:7777')

33.2.6.4 外部リーダーを使用したRSSフィード用のOAMの構成

デフォルトでは、WebCenter Portal RSSフィードはSSOによって保護されています。ただし、保護されたままの状態では、それらは外部リーダーでうまく機能しません。外部リーダーを使用したアクセスが重要な場合は、その外部リーダーが処理できるWebLogic ServerのBASIC認証によってRSSサーブレットの認証が処理されるように、WebCenter Portal RSSリソースをOAMポリシーから除外することをお薦めします。

この項には次のサブセクションが含まれます:

- 第33.2.6.4.1項「OAM 11gのRSSフィードの非保護」

- 第33.2.6.4.2項「OAM 10gのRSSフィードの非保護」

33.2.6.4.1 OAM 11gのRSSフィードの非保護

OAM 11gのRSSフィードを非保護にする手順は次のとおりです。

1. OAM管理コンソールを開きます。

2. 「ポリシー構成」タブを開いて、「アプリケーション・ドメイン」→<該当するアプリケーション・ドメイン>を選択します。

3. 「リソース」タブを開いて、/rss*を検索します。
結果の中に、次のような項目が表示されるはずです。

/rss*

/rss/.../*

/rss/rssservlet*

/rss/rssservlet/.../*

4. それぞれのリソースについて、そのリソースを選択して「編集」をクリックします。

5. 各リソースの保護レベルをProtectedからExcludedに変更して、「適用」をクリックします。
リソースの認証ポリシーと認可ポリシーが削除されることに注意してください。

6. タブを閉じてOHSを再起動します。

33.2.6.4.2 OAM 10gのRSSフィードの非保護

OAM 10gのRSSフィードを非保護にする手順は次のとおりです。

1. OAM管理コンソールを開きます。

2. 「アクセス・システム・コンソール」→「ポリシー・マネージャ」を選択し、適切なポリシー・ドメインを開きます。

3. 「ポリシー」タブを開き、Exclusion Schemeポリシーを選択して、「変更」をクリックします。

4. 除外するために次のリソースを選択します。
/rss

/rss/rssservlet

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

6. Default Public Policyを選択して、「変更」をクリックします。

7. /rss resourceを選択解除して、「保存」をクリックします。

8. OHSを再起動します。

33.2.6.5 OAM 10g用のWebLogic Server管理コンソールとEnterprise Managerの構成

この項では、WebLogic Server管理コンソールとEnterprise ManagerのためにオプションでOAMシングル・サインオンをセットアップする方法を説明します。

注意:
Enterprise ManagerとWebLogic Server管理コンソールに対してOAM SSOをセットアップすると、OAM SSOアクセスが構成されている同じユーザー・セットでシングル・サインオン・アクセスが可能になります。OAMを通じて外部ユーザーがWeb層にアクセスできるようにし、一方、管理者はEnterprise ManagerとWebLogic Server管理コンソールに直接ログインするようにしたいときは、この追加の構成手順を実行する必要がない場合もあります。

WebLogic Server管理コンソールとEnterprise ManagerのOAM SSOをセットアップする手順は次のとおりです。

1. ブラウザを使用してOAMコンソールにログインし、次の場所に移動します。

http://host:port/access/oblix

hostはAccess ManagerをホストするサーバーのホストID(例: oam.example.com)、portはHTTPポート番号(例: 8888)になります。

2. 「ポリシー・マネージャ」をクリックします。
「ポリシー・マネージャ」ペインが表示されます(図33-4を参照)。

図33-4 「ポリシー・マネージャ」ペイン

3. WebCenter Portalリソースを保護するために作成したポリシー・ドメインを見つけます。

4. 「リソース」タブを開き、「追加」をクリックします。
「リソース」ページが表示されます(図33-5を参照)。

図33-5 ポリシー・ドメインの「リソース」ページ

5. 保護する必要のあるリソースを追加します。各リソースに対して、次の手順を実行します。

1. 「リソース・タイプ」としてhttpを選択します。

2. WebCenter Portal Web層のホストIDを選択します。

3. 「URL接頭辞」に、WebLogic Server管理コンソールのURL接頭辞(/console)またはEnterprise ManagerのURL接頭辞(/em)を入力します。

4. リソースの説明を入力します。

5. 「キャッシュの更新」が選択されていることを確認して、「保存」をクリックします。

6. Web層で、mod_wl_ohs.confファイル(WT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/にあります)を、WebLogic Server管理コンソールとEnterprise Managerが含まれるように変更します。それには、WebLogicHostに、WebCenter Portal管理サーバーの実際のホストIDを使用して、場所のエントリを2つ追加します。

<Location /console>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 7001
</Location>

<Location /em>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 7001
</Location>

7. 変更を有効にするために、Oracle HTTP Serverを再起動します。
これで、次のリンクでWebLogic Server管理コンソールとEnterprise Managerにアクセスできるようになります。

http://host:OHS port/console
http://host:OHS port/em

OAM SSOログイン・フォームが表示されます。

33.2.6.6 OAM 11g用のWebLogic Server管理コンソールとEnterprise Managerの構成

この項では、WebLogic Server管理コンソールとEnterprise ManagerのためにオプションでOAM 11gシングル・サインオンをセットアップする方法を説明します。

注意:
Enterprise ManagerとWebLogic Server管理コンソールに対してOAM SSOをセットアップすると、OAM SSOアクセスが構成されている同じユーザー・セットでシングル・サインオン・アクセスが可能になります。OAMを通じて外部ユーザーがWeb層にアクセスできるようにし、一方、管理者はEnterprise ManagerとWebLogic Server管理コンソールに直接ログインするようにしたいときは、この追加の構成手順を実行する必要がない場合もあります。

WebLogic Server管理コンソールとEnterprise Managerに対してOAM 11g SSOをセットアップする手順は次のとおりです。

1. ブラウザを使用してOAMコンソールにログインします。

http://host:port/oamconsole

2. 「ポリシー構成」→「アプリケーション・ドメイン」に移動します。
「ポリシー・マネージャ」ペインが表示されます。

3. WebGateエージェントの登録時の名前を使用して、作成したアプリケーション・ドメインを見つけます。

4. リソース・ノードを展開して「作成」をクリックします。
「リソース」ページが表示されます。

5. 保護する必要のあるリソースを追加します。各リソースに対して、次の手順を実行します。

1. 「リソース・タイプ」としてhttpを選択します。

2. WebGateエージェントの登録時に作成されたホストIDを選択します。

3. 「リソースURL」に、WebLogic Server管理コンソールのリソースURL(/console)またはEnterprise ManagerのリソースURL(/em)を入力します。

4. リソースの「説明」を入力して、「適用」をクリックします。

6. 「認証ポリシー」→「保護されたリソース・ポリシー」に移動して、新しく作成されたリソースを追加します。

7. 「認可ポリシー」→「保護されたリソース・ポリシー」についても同じことを行います。

8. Web層で、mod_wl_ohs.confファイル(WT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/にあります)を、WebLogic Server管理コンソールとEnterprise Managerが含まれるように変更します。それには、WebLogicHostに、WebCenter Portal管理サーバーの実際のホストIDを使用して、場所のエントリを2つ追加します。

<Location /console>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 7001
</Location>

<Location /em>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 7001
</Location>

9. 変更を有効にするために、Oracle HTTP Serverを再起動します。
これで、次のリンクでWebLogic Server管理コンソールとEnterprise Managerにアクセスできるようになります。

http://host:OHS port/console
http://host:OHS port/em

OAM SSOログイン・フォームが表示されます。

33.2.6.7 SSO用のSecure Enterprise Searchの構成

WebCenter PortalとSESに定義された対応する認証エンド・ポイントが使用するWebCenter Portalデータとリポジトリをクロールするために定義されるクロール・ソースは、適切に認証されるようにWeb層OHSポートを通してルーティングする必要があります(認証方式は引き続きBASICおよびレルムjazn.comになります)。SES接続の構成の詳細は、第18.4項「Oracle SES接続の設定」を参照してください。

33.2.6.8 SSO用のContent Serverの構成

SSOのセットアップが完了し、Content Serverの接続をセットアップしたら、Fusion Middleware Controlを使用して、または次のWLSTの例のように、JCRContentServerConnectionにWebコンテキスト・ルートを指定します。

setJCRContentServerConnection(appName, name, webContextRoot='/cs')

Webコンテキスト・ルートを設定することで、SSOがセットアップされていることをドキュメント・ライブラリのコードに伝えます。この設定は、SSOを完全にセットアップするまでは設定しないでください。

33.2.6.9 接続フィルタを使用したアクセスの制限

ユーザーが適切に認証されるように、Web層OHSポートを通してのみWebCenter PortalまたはPortal Frameworkアプリケーションと関連するコンポーネントへのアクセスを許可するには、次の手順に従います。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. ドメイン構造ペインで、構成するドメインを選択します(例: webcenter)。

3. 「セキュリティ」タブを開き、「フィルタ」サブタブを開きます。
セキュリティ・フィルタの設定ペインが表示されます。

4. 「接続ロガーの有効化」を選択して、受け入れられたメッセージのログを有効にします。
接続ロガーは、成功した接続と接続データをサーバーにログします。この情報を使用して、サーバー接続に関する問題をデバッグできます。

5. 「接続フィルタ」フィールドに、ドメインで使用する接続フィルタ・クラスを指定します。

- デフォルトの接続フィルタを構成するには、weblogic.security.net.ConnectionFilterImplと指定します。

- カスタム接続フィルタを構成するには、ネットワーク接続フィルタを実装するクラスを指定します。このクラスはWebLogic ServerのCLASSPATHにも指定されていることが必要です。

6. 「接続フィルタ・ルール」フィールドに、接続フィルタ・ルールの構文を入力します。
例:

<webtier IP>/0 * * allow
0.0.0.0/0  *  *  deny

これは、ローカル・ホストからの全トラフィックを許可し、他のIPアドレスからの全トラフィックを拒否するように指定しています。もちろん、環境に適切なネットワーク・フィルタを作成する必要があります。接続フィルタの作成の詳細は、『Oracle WebLogic Serverセキュリティのプログラミング』のカスタム接続フィルタの開発に関する項を参照してください。

7. 「保存」をクリックして、変更を有効にします。

8. すべての管理対象サーバーと管理サーバーを再起動します。

9. WebLogic Serverへのすべての直接トラフィックが、次へのナビゲートを試行することでブロックされることを検証します。

http://host:WLS_port/webcenter

これによって次のエラーが生成されます。

「サーバーがこのリクエストを処理できません:[ソケット:000445]接続が拒否され、フィルタがソケットをブロックしました、weblogic.security.net.FilterException: [セキュリティ:090220]rule 3」

ただし、OHSポートを通してWebCenter Portalにアクセスすることは今でも可能です。

http://host:OHS_port/webcenter

33.2.6.10 ポートレット・プロデューサと追加コンポーネントの構成

OHSを通してルーティングされるようにポートレット・プロデューサ・アプリケーションをセットアップした場合は、登録用のプロデューサURLを指定する際に必ずOHSホストおよびポートを使用してください。これは、wsrp-toolsのようなデフォルトのプロデューサ、サービス・プロデューサ、ページレット・プロデューサおよび明示的に構成した他のプロデューサに適用されます。

33.2.7 OAMインストールのテスト

OAM 10gまたは11gをインストールおよび構成したら、構成された次のすべての(環境に適用される)アプリケーションにアクセスできることと、グローバル・ログインおよびログアウトによって再度サインインを要求されることなく構成されたすべてのアプリケーションにアクセスできることをチェックします。また、利用できる状況でグローバル・ログアウトもテストして、関連する他のすべてのアプリケーションからログアウトすることを確認してください。

- WebCenter Portal: 保護されたすべてのWebCenter Portal URL (例: 保護されたポータル)にアクセスして、SSOログイン・チャレンジが表示されることを確認します。同じSSOを使用する別の関連アプリケーションにすでにログインしている場合は、コンテンツが自動的に表示されます。

- REST: http://ohshost:ohsport/rest/api/resourceIndexにアクセスします。BASIC認証チャレンジが表示されるはずです。同じSSOを使用する別の関連アプリケーションにすでにログインしている場合は、コンテンツが自動的に表示されます。

- REST: http://ohshost:ohsport/rest/api/cmis/....にアクセスします (これは前の手順のresourceIndexアクセス出力から取得します)。ログイン・チャレンジは表示されず、パブリック・コンテンツを表示できるはずです。ログイン後にこれにアクセスすると、アクセス権を持つすべてのコンテンツが表示されるはずです。

- アクティビティ・グラフ・エンジン: http://host:port/activitygraph-enginesにアクセスします。SSOログイン・チャレンジが表示されるはずです。ログインすると、コンテンツを表示できるはずです。

- Content Server: プロファイルUIに移動し、ログインをチャレンジされずに、iFrames内に埋め込まれているContent Server画面が表示できることを確認します。すでにWebCenter Portalにログインしている際には、ログインせずにコンテンツ・プレゼンタ・テンプレートのSite Studioコンテンツにもアクセスできます。

- SOA: ワークフロー・タスク・フローのリンクにアクセスして、ログインをチャレンジされないことを確認します。

- ディスカッション・フォーラム: http://host:port/owc_discussions/adminでディスカッション・アプリケーションの管理者ログインにアクセスして、ログインします。ログインがSSOログイン・チャレンジであることを確認します。

33.3 Oracle Single Sign-On (OSSO)の構成

デフォルトのインストールでは、WebCenter PortalおよびPortal Frameworkアプリケーションは、それらのために作成された管理対象サーバーのHTTPポートを使用します。Oracle Single Sign-Onを使用してWebCenter PortalおよびPortal Frameworkアプリケーションを構成するためには、アプリケーションはOracle Single Sign-On (OSSO)と統合するために、Oracle HTTP Serverおよび関連付けられたモジュールmod_ossoを必要とします。第34.5項「OSSOに対するPortal Frameworkアプリケーションの構成」で説明されているように、Portal Frameworkアプリケーションの場合は、追加の構成がいくつか必要になることに注意してください。

注意:
BPELコンソールはSSOの統合をサポートしません。WebCenter PortalまたはPortal FrameworkアプリケーションがSSO用に構成されている場合も、BPELへのログインはBPELコンソール上で標準ログイン・ページを通して行う必要があります。

この項には次のサブセクションが含まれます

- 第33.3.1項「OSSO構成のロードマップ」

- 第33.3.2項「OSSOのコンポーネントとトポロジ」

- 第33.3.3項「Oracle HTTP Serverと関連モジュールの構成」

- 第33.3.4項「OSSOIdentityAsserterの構成」

- 第33.3.5項「Oracle SSOへのOHSの登録」

- 第33.3.6項「追加構成」

33.3.1 OSSO構成のロードマップ

この項のフロー・チャート(図33-6)と表(表33-2)は、OSSOを使用してWebCenter PortalおよびPortal Frameworkアプリケーションのシングル・サインオンを構成する際の前提条件と必要なタスクの概要を示しています。

図33-6 OSSOを使用したシングル・サインオンの構成

表33-2は、OSSOを使用してWebCenter Portalのシングル・サインオンを構成するためのタスクとサブタスクを示しています。

表33-2 OSSOを使用したWebCenter Portalのシングル・サインオンの構成

担当者

タスク

サブタスク

ノート

管理者

1. Oracle HTTP Serverと関連モジュールの構成

1.a Web層のインストール

1.b Web層OHS内のmod_wlモジュールの構成

2. OSSOIdentityAsserterの構成

3. Oracle SSOへのOHSの登録

4. 必要に応じた追加構成の実行

4.a SSO用のWebCenter Portalの構成

4.b Web層OHSポートを通したWebCenterとコンポーネントおよびサービスへのアクセスの制限

4.c SSO用のディスカッション・サーバーの構成

33.3.2 OSSOのコンポーネントとトポロジ

デフォルトのインストールでは、WebCenter PortalおよびPortal Frameworkアプリケーションは、それらのために作成された管理対象サーバーのHTTPポートを使用します。Oracle Single Sign-Onを使用してWebCenter PortalまたはPortal Frameworkアプリケーションを構成するためには、アプリケーションはOracle SSOと統合するために、Oracle HTTP Serverおよび関連付けられたモジュールmod_ossoを必要とします。次の図(図33-7)は、この統合の全体的なアーキテクチャを示しています。

図33-7 OSSOのコンポーネントとトポロジ

33.3.3 Oracle HTTP Serverと関連モジュールの構成

この項では、Oracle HTTP Serverと関連付けられたモジュールのロードおよび構成方法を説明します。

Oracle HTTP Serverおよび関連付けられたモジュールをロードおよび構成する手順は次のとおりです。

1. Oracle HTTP Server(OHS)および関連付けられたモジュール(mod_ossoおよびmod_wl)を含むOracle Web層ソフトウェアをインストールします。

2. WebCenter PortalまたはPortal Frameworkアプリケーション用のOracle WebLogic Serverにリクエストを転送するようにWeb層OHS内のmod_wlモジュールを構成します。ホストとポートの値には、ローカル環境の値を指定してください。
${ORACLE_HOME}/ohs/modules/mod_wl_ohs.soの行を非コメント化します。このファイルは次のような内容で、httpd.confファイルによりインクルードされます。

# NOTE : This is a template to configure mod_weblogic.

LoadModule weblogic_module   "${ORACLE_HOME}/ohs/modules/mod_wl_ohs.so"

# This empty block is needed to save mod_wl related configuration from EM to this file when changes are made at the Base Virtual Host Level
<IfModule weblogic_module>
#      WebLogicHost <WEBLOGIC_HOST>
#      WebLogicPort <WEBLOGIC_PORT>
#      Debug ON
#      WLLogFile /tmp/weblogic.log
#      MatchExpression *.jsp

<Location /webcenter>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /webcenterhelp>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /rss>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /rest>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /rsscrawl>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /sesUserAuth>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

<Location /services-producer>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8889
</Location>

<Location /wsrp-tools>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8889
</Location>

<Location /owc_discussions/admin>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8890
</Location>

<Location /owc_discussions/OWCDiscussionsServicePublic>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8890
</Location>

<Location /owc_discussions/OWCDiscussionsServiceAuthenticated>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8890
</Location>

<Location /activitygraph-engines>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8891
</Location>

<Location /wcps>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8891
</Location>

<Location /workflow>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /integration/worklistapp>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /integration/services>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /soa-infra>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /sdpmessaging/userprefs-ui>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /DefaultToDoTaskFlow>
SetHandler weblogic-handler
WebLogicHost soa.example.com
WebLogicPort 8001
</Location>

<Location /cs>
SetHandler weblogic-handler
WebLogicHost ucm.example.com
WebLogicPort 16200
</Location>

<Location /adfAuthentication>
SetHandler weblogic-handler
WebLogicHost ucm.example.com
WebLogicPort 16200
</Location>

</IfModule>

# <Location /weblogic>
#      SetHandler weblogic-handler
#      PathTrim /weblogic
#      ErrorPage  http:/WEBLOGIC_HOME:WEBLOGIC_PORT/
#  </Location>

33.3.4 OSSOIdentityAsserterの構成

WebCenter PortalまたはPortal Frameworkアプリケーション用のOracle WebLogicドメインにOSSO Identity Assertion Provider (IAP)プロバイダを追加します。次の手順に従って、WebLogic Server管理コンソールを使用してOSSO IAPをドメインに追加します。環境が複数のドメインにまたがっている場合(例: WebCenter Portalのドメイン、別個のSOAのドメインおよび別個のContent Serverのドメイン)、それぞれのドメインについてこの項の手順を繰り返してください。

OSSOIdentityAsserterを構成するには:

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます。

3. プロバイダを追加するレルム・エントリをクリックします。
レルムの「設定」ペインが表示されます。

4. 「プロバイダ」タブをクリックします。
「プロバイダ設定」が表示されます。

5. 「新規」をクリックして、プロバイダを作成します。
「新しい認証プロバイダの作成」ペインが表示されます。

6. 新規のプロバイダの名前を入力し、タイプとして「OSSOIdentityAsserter」を選択して「OK」をクリックします。

7. 「プロバイダ」タブで、新しく追加したプロバイダをクリックします。

8. 制御フラグをOPTIONALに設定します。

9. 関連付けられたOracle Internet Directoryサーバーからユーザー・プロファイルを取得できるように、OracleInternetDirectoryAuthenticator(または外部LDAPを使用するようにアイデンティティ・ストアを構成した際に選択したプライマリ・オーセンティケータ)がドメインのプライマリ・オーセンティケータとして設定されていることを確認します。外部LDAPを使用するようにアイデンティティ・ストアを構成する方法については、第31章「アイデンティティ・ストアの構成」を参照してください。
OIDについて、次のようにプロバイダ・リストが表示されます。

- OSSOIdentityAsserter (OPTIONAL)

- OracleInternetDirectoryAuthenticator (SUFFICIENT)

- DefaultAuthenticator (SUFFICIENT)

- DefaultIdentityAsserter (OPTIONAL)

33.3.5 Oracle SSOへのOHSの登録

次の手順に従って、Web層OHS内のモジュールmod_ossoをパートナ・アプリケーションとしてSSOサーバーに登録します。

Oracle SSOにOHSを登録する手順は次のとおりです。

1. SSOサーバーからssoregを実行してosso.confファイルを生成し、バイナリ・モードでFTPを使用してWeb層ホスト(WT_ORACLE_HOME)にこれを転送します。
次の例に、SSOサーバーでリモート・パートナ・アプリケーションを登録する方法を示します。ssoreg.shを実行する前に、ORACLE_HOME環境変数が設定されていることをチェックします(ここでのORACLE_HOMEは、SSOサーバー上のOSSOインストールのORACLE_HOMEです)。

bash-3.00$ ORACLE_HOME/sso/bin/ssoreg.sh -site_name
webtier.example.com:80 -config_mod_osso TRUE -mod_osso_url
http://webtier.example.com:80 -remote_midtier  -config_file
webtier.example.com.osso.conf

このコマンドを実行すると、webtier.example.com.osso.confファイルが作成されます。

2. WT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/disabled/mod_osso.confファイルをWT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/moduleconfにコピーします。moduleconfディレクトリ内のすべてのファイルがhttpd.confファイルにインクルードされます。

3. 手順1でssoregによって生成されたwebtier.example.com.osso.confファイルを、Web層のmoduleconfディレクトリ以外のアクセス可能な場所(例: WT_ORACLE_HOME)にコピーします。

注意:
FTPを使用する場合は、必ずバイナリ・モードを使用してファイルを転送してください。

4. /webcenterと関連するアプリケーション・リソースのURLをOracle SSOを使用して保護するためのルールをmod_osso.confファイルに追加します。
mod_osso.confファイルは次のようになります。

LoadModule osso_module "${ORACLE_HOME}/ohs/modules/mod_osso.so"

<IfModule osso_module>
OssoIpCheck off
OssoIdleTimeout off
OssoSecureCookies Off

#Point to proper osso.conf file.
OssoConfigFile /example.com.osso.conf
#
# Insert Protected Resources: (see Notes below for
# how to protect resources)
#
#______-
#
# Notes
#
#______-
#
# 1. Here's what you need to add to protect a resource,
#    e.g. <ApacheServerRoot>/htdocs/private:
#
#      <Location /private>
#      require valid-user
#      AuthType Osso
#      </Location>

<Location /webcenter/adfAuthentication*>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /services-producer/adfAuthentication*>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rss/rssservlet>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /owc_discussions/login!withRedirect.jspa>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /owc_discussions/login!default.jspa>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /owc_discussions/login.jspa>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /owc_discussions/admin>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /integration/worklistapp>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /sdpmessaging/userprefs-ui>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /workflow/WebCenterWorklistDetail>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /workflow/sdpmessagingsca-ui-worklist>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/resourceIndex>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/spaces>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/discussions>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/tags>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/taggeditems>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/activities>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/activitygraph>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/feedback>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/people>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/messageBoards>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /rest/api/searchresults>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /pagelets/admin>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /pagelets/authenticateWithApplicationServer*>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /activitygraph-engines>
OssoSendCacheHeaders off
require activity-graph-admins
AuthType Osso
</Location>
<Location /wcps/api>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /cs/groups>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /cs/idcplg>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
<Location /adfAuthentication>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>
</IfModule>

#
# To have short hostnames redirected to fully qualified
# hostnames for clients that need authentication via
# mod_osso to be able to enter short hostnames into their
# browsers use a mod_rewrite configuration such as the following.
#
# e.g
#RewriteEngine On
#RewriteCond %{HTTP_HOST} !www.example.com
#RewriteRule ^.*$
http://%{SERVER_NAME}%{REQUEST_URI}
[R]
#where www.example.com is the fully qualified domain name.

OssoConfigFileパラメータは、前の手順でosso.confファイルをコピーした場所(および変更した場合はファイル名)をポイントするように必ず変更してください。環境が非SSLの場合は、OSSOセキュアCookie(デフォルトでオン)を必ずオフにしてください

(OssoSecureCookies Off)。

5. mod_ossoおよびmod_wlの構成変更が有効になるように、Web層を再起動します。

33.3.6 追加構成

次の項で説明する構成は、サイトのセキュリティを強化するために必要であるか、または役に立ちます。Portal Frameworkアプリケーションの場合は、第34.5項「OSSOに対するPortal Frameworkアプリケーションの構成」で説明されている追加の構成も必要になります。

- 第33.3.6.1項「SSO用のWebCenter Portalの構成」

- 第33.3.6.2項「Web層OHSポートを使用したアクセスの制限」

- 第33.3.6.3項「SSO用のディスカッション・サーバーの構成」

- 第33.3.6.4項「SSO用のワークリスト・コンポーネントの構成」

- 第33.3.6.5項「SSO用のContent Serverの構成」

- 第33.3.6.6項「外部リーダーを使用したRSSフィード用のOSSOの構成」

- 第33.3.6.7項「SSO用のSESクロールの構成」

33.3.6.1 SSO用のWebCenter Portalの構成

第33.2.6.1項「SSO用のWebCenter Portalの構成」の説明に従ってEXTRA_JAVA_PROPERTIESに設定を追加してリブートすることで、WebCenter Portal用のOracle Single Sign-on (OSSO)の構成を行ってください。

33.3.6.2 Web層OHSポートを使用したアクセスの制限

ユーザーが適切に認証されるように、Web層OHSポートを通してのみWebCenter PortalまたはPortal Frameworkアプリケーション、および関連するコンポーネントとサービスへのアクセスを許可するには、第33.2.6.9項「接続フィルタを使用したアクセスの制限」の手順に従います。

33.3.6.3 SSO用のディスカッション・サーバーの構成

この項では、シングル・サインオン用のディスカッション・サーバーを構成する方法を説明します。SSO用のディスカッション・サーバーを構成する前に、第31.4.1項「ディスカッション・サーバーの新しい管理者アカウントの識別」の説明に従って、WebCenter Portalと同じアイデンティティ・ストアLDAPを使用するようにこれが構成されていることを確認してください。

SSO用のディスカッション・サーバーを設定する手順は次のとおりです。

1. ディスカッション・サーバー管理コンソールにログインします。

http://host:port/owc_discussions/admin

hostおよびportは、WC_Collaboration管理対象サーバーのホストIDとポート番号です。

2. 「システム・プロパティ」ページを開き、owc_discussions.sso.modeプロパティを編集(存在している場合)または追加します(値をtrueに設定します)。

3. Web層のベースURLをポイントするようにjiveURLプロパティを更新します。

33.3.6.4 SSO用のワークリスト・コンポーネントの構成

第33.3.5項「Oracle SSOへのOHSの登録」の説明に従ってOracle SSOにOHSを登録したら、WebCenter Portal管理サーバーを使用して次のコマンドを実行し、ワークリストの変更を有効にします。

setBPELConnection('webcenter','WebCenter-Worklist', 'http://webtier.example.com:7777')

33.3.6.5 SSO用のContent Serverの構成

Content ServerリポジトリにはWebCenter Portalから直接アクセスできるので、これもシングル・サインオン構成に含めることが可能です。Content Serverの接続をセットアップしたら、Fusion Middleware Controlを使用して、または次の例のようにWLSTを使用して、JCRContentServerConnectionにWebコンテキスト・ルートを指定します。

setJCRContentServerConnection(appName, name, webContextRoot='/cs')

Content Serverの構成方法の詳細は、『Oracle WebCenter Contentの管理』のシングル・サインオンのためのWebCenter Contentの構成に関する項を参照してください。

33.3.6.6 外部リーダーを使用したRSSフィード用のOSSOの構成

デフォルトでは、WebCenter Portal RSSフィードはSSOによって保護されています。ただし、保護されたままの状態では、それらは外部リーダーでうまく機能しません。外部リーダーを使用したアクセスが重要な場合は、その外部リーダーが処理できるWebLogic ServerのBASIC認証によってRSSサーブレットの認証が処理されるように、WebCenter Portal RSSリソースを非保護にすることをお薦めします。

次の手順に従って、RSSフィードを非保護にします。

1. mod_osso.confから次のエントリを削除します。

<Location /rss/rssservlet>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>

2. OHSを再起動します。

33.3.6.7 SSO用のSESクロールの構成

インスタンスにSESを構成してある場合は、オプションとしてWeb層URLを使用するようにWebCenter Portalのクロールおよび認証エンド・ポイントを更新できます。詳細は、第18章「WebCenter PortalでのOracle Secure Enterprise Searchの管理」を参照してください。

33.4 SAMLベースのシングル・サインオンの構成

Security Assertion Markup Language (SAML)によって、WebLogic ServerドメインおよびWebブラウザまたは他のHTTPクライアントで実行されているWebアプリケーションやWebサービス間でクロスプラットフォームの認証が可能になります。WebLogic Serverは、WebCenter PortalおよびPortal Frameworkアプリケーションに対して、SAMLに基づくシングル・サインオン(SSO)をサポートします(ページレット・プロデューサ・アプリケーションはサポートされません)。シングル・サインオン(SSO)構成に参加する1つのサイトでユーザーが認証されると、SSO構成の他のサイトでも自動的に認証され、別途ログインする必要はありません。ページレット・プロデューサ・アプリケーションはSAML SSOに参加しないので、ページレット・プロデューサ・アプリケーションにアクセスするユーザーは明示的にログインする必要があることに注意してください。また、第34.6項「SAML SSOに対するPortal Frameworkアプリケーションの構成」で説明されているように、Portal Frameworkアプリケーションの場合は、追加の構成がいくつか必要になることにも注意してください。

注意:
SAMLベースのシングル・サインオンは、初回サインオン後の後続のアプリケーションへのユーザーのログオンはサポートしますが、グローバル・ログアウトはサポートしません。このため、ユーザーは、開いた各アプリケーションを個々にログアウトする必要があります。
また、WebCenter Portalをソース・アプリケーション、ディスカッションを宛先アプリケーションとして使用して、SAMLベースのシングル・サインオンをセットアップすると、管理者はWebCenter Portal管理(「構成」→「サービス」)とポータル設定(「サービス」ページ)からディスカッション管理ページにアクセスできることにも注意してください。ただし、ディスカッション管理ページはSSOに参加しないので、管理ページに直接アクセスすると、ディスカッション・サーバーへの再ログインが必要になります。

さらに、SAMLベースのシングル・サインオンは、sdpmessaging userprefs-uiアプリケーションでは使用できません。アプリケーション管理者がWebCenter Portalの「プリファレンス」→「メッセージング」ダイアログで「構成の管理」をクリックすると、再ログインが必要になります。

このSSOメカニズムは、Oracle SSOまたはOracle Access Managerシングル・サインオン・インフラストラクチャがまだ存在しておらず、WebCenter Portalとそのコンポーネントまたはサービス間のみのシングル・サインオンが必要とされる部門別のインストールに使用できます。大規模エンタープライズの高可用性展開では、Oracle Access Manager SSOをお薦めします。

この項では、同じドメイン内の異なる管理対象サーバー上で実行されるWebCenter PortalまたはPortal Frameworkアプリケーションおよびワークリストに対してSAML 1.1ベースのシングル・サインオンをセットアップする方法を説明します。

この項には次のサブセクションが含まれます:

- 第33.4.1項「SAMLのコンポーネントとトポロジ」

- 第33.4.2項「SAMLベースのシングル・サインオンの構成」

33.4.1 SAMLのコンポーネントとトポロジ

図33-9は、WebCenter Portalとディスカッションを含むSAMLベースのシングル・サインオン構成のコンポーネントとその対話を示しています。

SAMLベースのシングル・サインオン・ソリューションは、次のコンポーネントから構成されます。

- SAML資格証明マッパー - SAML資格証明マッピング・プロバイダは、SAMLセキュリティ・アサーションのプロデューサとして動作して、シングル・サインオンにSAMLを使用するためのソース・サイトとしてWebLogic Serverが動作することを可能にします。SAML資格証明マッピング・プロバイダは、ターゲット・サイトまたはリソースの構成に基づいて、認証されたサブジェクトのために有効なSAML 1.1アサーションを生成します。

- サイト間転送サービス(ITS) - アイデンティティ・アサーションを生成してユーザーを宛先サイトに転送するアドレス可能なコンポーネント。

- アサーション取得サービス(ARS) - アーティファクトに対応するSAMLアサーションを返すアドレス可能なコンポーネント。アサーションIDは、アサーションの生成時に割り当てられたものです。

- SAMLアイデンティティ・アサータ - SAMLアイデンティティ・アサーション・プロバイダは、SAMLセキュリティ・アサーションのコンシューマとして動作して、シングル・サインオンにSAMLを使用するための宛先サイトとしてWebLogic Serverが動作することを可能にします。SAMLアイデンティティ・アサーション・プロバイダは、ソース・サイトまたはリソースから取得された認証済サブジェクトのために、有効なSAML 1.1アサーションを処理します。

- アサーション・コンシューマ・サービス(ACS) - ITSが生成したアサーションまたはアーティファクト(あるいはその両方)を受信して、宛先サイトでユーザーを認証するためにそれらを使用するアドレス可能なコンポーネント。

- SAMLリライイング・パーティ - SAMLリライイング・パーティは、SAMLソース・サイトが生成したSAMLアサーションの情報に依存するエンティティです。WebLogic Serverが各リライイング・パーティ用にSAMLアサーションを別個に生成する方法を構成することも、アサーションの生成用にフェデレーション・サービスのソース・サイト構成で設定されたデフォルトを使用することもできます。

- SAMLアサーティング・パーティ - SAMLアサーティング・パーティは、信頼できるSAML認証局(SAMLアサーションの形式でセキュリティ情報をアサートする権限を持つエンティティ)です。

図33-8は、WebCenter PortalとSOAドメインの両方を含む、POSTが構成されたSAML SSO構成のコンポーネントとフローを示しています。このフローは、ワークリスト・アプリケーションやディスカッションのようなシングル・サインオンに参加する他の宛先アプリケーションの場合と似ています。

図33-8 詳細なSAMLシングル・サインオンのコンポーネントとトポロジ(POSTプロファイルを構成)

図33-9は、WebCenter Portalとディスカッション・アプリケーションの間のSAML SSOフローを含む、POSTが構成されたSAML SSO構成の簡略化されたバージョンのコンポーネントとフローを示しています。

図33-9 SAMLシングル・サインオンのコンポーネントとトポロジ(POSTプロファイルを構成)

フローの手順は次のとおりです。

1. ユーザーのブラウザが、ユーザーの資格証明を入力して、WebCenter Portalドメイン(wc_domain)のWebLogic管理対象サーバー(WC_Spaces)上にホストされているWebCenter Portal(ソース・サイト)にアクセスします。

2. WebCenter Portalが、認証サービス・プロバイダにユーザーの資格証明を渡します。

3. 認証に成功すると、認証されたセッションが確立されて、WebCenter Portalのようこそページが表示されます。

4. ユーザーがようこそページで、同じドメインの異なるWebLogic Server(WC_Collaboration)上にホストされているディスカッション宛先サイトのセキュアなWebページにアクセスするためのリンクをクリックします。これによって、構成されているサイト間転送サービス(ITS)サーブレットへのコールがトリガーされます。この場合は、ITSサーブレットが、WebCenter Portalと同じJSESSIONID Cookieを共有するソース・サイト内(つまり、WC_Spaces管理対象サーバー上のWebCenter Portalアプリケーション上)にホストされます。

5. ITSサーブレットは、WebCenter Portalドメイン(wc_domain)で構成されているSAML資格証明マッパーをコールして、コール元アサーションをリクエストします。SAML資格証明マッパーはアサーションを返します。また、宛先サイト・アプリケーションWebページ(ディスカッション用のセキュアなWebページ)のURLと適切なPOSTフォームのパス(ソース・サイトがPOSTプロファイルを使用するように構成されている場合)も返します。

6. SAML ITSサーブレットが、生成されたアサーションを含むSAMLレスポンスを生成し、それに署名して、BASE64にエンコードし、HTMLフォームに埋め込んで、そのフォームをユーザーのブラウザに返します。

7. ユーザーのブラウザがそのフォームを宛先サイトのアサーション・コンシューマ・サービス(ACS)にPOSTします。この場合は、ACSサーブレットが宛先サイト(ディスカッション)にホストされ、そのログインCookieを共有します。

8. アサーションが検証されます。

9. アサーションに成功すると、ユーザーがターゲット(ディスカッションのセキュアなWebページ)にリダイレクトされます。

10. ユーザーは再認証の必要なしで宛先サイト(ディスカッション)にログインします。

33.4.2 SAMLベースのシングル・サインオンの構成

この項では、一連の自動化されたスクリプトを使用して、SAMLベースのシングル・サインオンのためにWebCenter Portalと関連するサービスおよびコンポーネントを構成する方法を説明します。

この項には次のサブセクションが含まれます:

- 第33.4.2.1項「SAMLシングル・サインオンの前提条件」

- 第33.4.2.2項「SAMLベースのSSOの構成」

- 第33.4.2.3項「外部リーダーを使用したRSS用のSAML SSOの構成」

- 第33.4.2.4項「構成のチェック」

- 第33.4.2.5項「SAML SSO構成の無効化」

- 第33.4.2.6項「SAML SSO構成の削除」

33.4.2.1 SAMLシングル・サインオンの前提条件

この項では、SAMLベースのシングル・サインオンを構成する前に実行する必要がある一連の手順を説明します。これらの手順では、WebCenter Portalと関連付けられたコンポーネントがインストール済で、関連する接続が構成およびテスト済であることを前提としています。

SAMLベースのSSOの前提条件について、次の項で説明します。

- 第33.4.2.1.1項「SAML SSO用のContent Serverの構成」

- 第33.4.2.1.2項「SAML SSO用のディスカッション・サーバーの構成」

- 第33.4.2.1.3項「証明書の構成とエクスポート」

- 第33.4.2.1.4項「SSLのセットアップ」

33.4.2.1.1 SAML SSO用のContent Serverの構成

WebCenter PortalでContent Serverユーザー・インタフェースを表示するためにOHSを使用する必要があるドキュメント接続をインスタンスが使用する場合は、WebCenter Portalと関連アプリケーションをWeb層を使用して構成する必要があります。

Content Serverを含む構成用にSAML SSOを構成する際は、すべてのHTTP URLはWeb層ホストおよびポートをポイントすることが必要です。さらに、Content ServerのフロントエンドとしてOHSを使用する場合は、WebCenter Portalの通常の構成とは別に、次のエントリをmod_wl_ohs.confに指定する必要があります。

<Location /cs>
SetHandler weblogic-handler
WebLogicHost ucm.example.com
WebLogicPort 16200
</Location>

<Location /adfAuthentication>
SetHandler weblogic-handler
WebLogicHost ucm.example.com
WebLogicPort 16200
</Location>

<Location /samlacs/acs>
SetHandler weblogic-handler
WebLogicHost ucm.example.com
WebLogicPort 16200
</Location>

OHSのインストールとmod_wl_ohs.confの編集の詳細は、第33.2.5項「Oracle HTTP Serverのインストールと構成」を参照してください。

さらに、WebCenter Portalにカスタム・ログイン・ページを使用する場合、Site Studio Designerを動作させるためには、Content Server用に生成されるHTMLページのheadセクションに次のHTMLコメントを追加する必要があります。

<!--IdcClientLoginForm=1-->

このHTMLコメントは、WebCenter Portalのデフォルト・ログイン・ページに表示されますが、SAML SSOのセットアップでログイン・ページとして新しいページを構成する場合は、手作業でコメントを追加することが必要になります。つまり、JSFページの次の例に示されているように、生成されたHTMLに追加します。

<af:document id="d1">
<f:facet name="metaContainer">
<f:verbatim>
${cb.commentText}
</f:verbatim>
</f:facet>
.........

cbは、次のメソッドを含むマネージドBeanです。

public String getCommentText(){
return "<!--IdcClientLoginForm=1-->";
}

af:documentのmetaContainer facetのverbatimにcomment textが追加されたことをチェックしたら、View Sourceを使用して生成されたHTMLページをチェックして、<!--IdcClientLoginForm=1-->がHTMLページの<head>セクションにあることを確認します。

33.4.2.1.2 SAML SSO用のディスカッション・サーバーの構成

デフォルトでは、Oracle WebCenter Portalのディスカッション・サーバー用にデプロイされる.EARファイルは、フォームベースのOracle SSOまたはOracle Access Manager SSOをサポートします。したがって、Oracle WebCenter Portalのディスカッション・サーバーをSAMLベースのシングル・サインオン用に構成する前に、SAML SSOバージョンのディスカッション・サーバーの.EARファイルをデプロイすることが必要になります。

注意:
SSO用のディスカッション・サーバーを構成する前に、第31.1項「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」の説明に従って、WebCenter Portalと同じアイデンティティ・ストアLDAPを使用するようにこれが構成されていることを確認してください。 デフォルトの管理者アカウントを外部LDAPに移動しない場合は、第31.4.1項「ディスカッション・サーバーの新しい管理者アカウントの識別」の手順にも従ってください。

SAML SSOバージョンのOracle WebCenter Portalのディスカッション・サーバーをデプロイおよび構成する手順は次のとおりです。

1. WebLogic Server管理コンソールに管理者としてログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「デプロイメント」をクリックします。
デプロイメントのサマリー・ペインが表示されます。

3. デプロイメントのサマリー・ページで、owc_discussions stop and deleteを選択して「インストール」をクリックします。

4. アプリケーション・インストール・アシスタントの「パス」フィールドを使用して、SSO対応のowc_discussions .EARファイル(owc_discussions_samlsso.ear、通常はWCP_ORACLE_HOME /discussionserverにあります)を見つけます。

5. owc_discussions_samlsso.earファイルを選択して「次へ」をクリックします。

6. 「このデプロイメントをアプリケーションとしてインストールする」を選択して「次へ」をクリックします。

7. 「名前」をowc_discussionsに設定します。

8. .EARファイルをデプロイします。

9. ディスカッション・サーバー管理コンソールに管理者としてログインします(ディスカッション・サーバー管理コンソールへのログインの詳細は、第33.2.6.2項「SSO用のディスカッション・サーバーの構成」を参照してください)。

10. 「システム・プロパティ」ページを開き、owc_discussions.sso.modeプロパティを追加または編集(すでに存在している場合)して、その値をtrueに設定します。

11. (ディスカッション・サーバーがデプロイされた)WC_Collaboration管理対象サーバーを再起動します。

33.4.2.1.3 証明書の構成とエクスポート

SAMLのソース・サイトと宛先サイト間の通信を保護するために、通信を暗号化する必要があります。さらに、証明書を使用して、SAMLの対話時に他のパーティのアイデンティティを検証することが必要です。次の手順に従ってkeytoolユーティリティ(JDK 6.0の一部として利用可能)を使用してキーを生成し、WebLogic Server管理コンソールを使用してそれを登録してください。

keytoolを使用して証明書を作成するには:

1. WebCenter PortalドメインのWC_Spacesと管理サーバーのための必要なキーストアを構成します。このキーストアには、SAMLアサーションを保護するために使用する証明書が含まれることが必要です。
構成のテストのみを行いたい場合は、デフォルトで構成されるDemoIdentityキーストアにパッケージされるdemoidentity証明書を作成するか、keytoolを使用してDemoIdentityキーストアに新しい証明書を生成することができます。カスタムIDキーストアの構成の詳細は、第35.1.2項「カスタムIDキーストアおよびJava信頼キーストアの構成」を参照してください。

2. keytoolを使用して、SAMLアサーションの暗号化に使用するために選択した証明書をエクスポートします。必ずWebCenter Portalドメインの管理サーバーとWC_Spacesに対して構成されたキーストア上でexportコマンドを実行するようにしてください。

keytool -export -keystore <keystore_name> -storepass <keystore_password> -alias <certificate_alias> -keypass <certificate_password> -file <certificate.der>

ここで:

- keystore_nameは、WebCenter Portalドメインの管理サーバーとWC_Spacesに対して構成されたキーストアの名前

- keystore_passwordは、WebCenter Portalドメインの管理サーバーとWC_Spacesに対して構成されたキーストアのパスワード

- certificate_aliasは別名(例: demoidentity)

- certificate_passwordは証明書のパスワード

- certificate.derは証明書ファイルの名前

keytool -exportコマンドはWebCenter Portalマシンから実行する必要があることと、WebCenter Portalサーバーに構成されたキーストアに常駐するSAML SSOのセットアップで使用されている証明書をエクスポートする必要があることに注意してください。

3. (SOA、Content Serverおよびコラボレーションなどの)宛先ドメインにファイルをコピーまたは転送し、第33.4.2.2.1項「シングル・サインオンのスクリプト」で説明されているSAML SSOスクリプトを実行する準備が整ったら、wcsamlsso.propertiesファイルのcertPath値を構成します。

33.4.2.1.4 SSLのセットアップ

トランスポートレベルのセキュリティを提供するためにWebCenter PortalのインストールでSSLを必要とする場合は、第35章「SSLの構成」で説明されているようにシングル・サインオンを構成する前にSSLを構成する必要があります。 SSLのセットアップはSSOの有効化とは無関係であることに注意してください。

33.4.2.2 SAMLベースのSSOの構成

WebCenter Portalと環境に必要なサービスおよびコンポーネントをインストールしたら、この項で説明されているスクリプトを使用してSAMLベースのシングル・サインオンを構成します。

このスクリプトでは、次を構成することで、WebLogic環境にSAMLベースのシングル・サインオンをセットアップします。

- SAML資格証明マッピング・プロバイダ

- 必要なリライイング・パーティ

- ソース・サイトのフェデレーション・サービス

- SAMLアイデンティティ・アサータ

- 必要なアサーティング・パーティ

- 宛先サイトのフェデレーション・サービス

この項には次のサブセクションが含まれます:

- 第33.4.2.2.1項「シングル・サインオンのスクリプト」

- 第33.4.2.2.2項「スクリプトの使用」

33.4.2.2.1 シングル・サインオンのスクリプト

WebCenter Portalおよび関連するアプリケーション用にSAML 1.1 SSOを構成するためのシングル・サインオン・スクリプトは、WCP_ORACLE_HOME /webcenter/scripts/samlssoフォルダに格納されています。SAMLの構成に関係するのは、次のファイルです。

- wcsamlsso.properties

- wcsamlsso.py

- configureSpaces.py

- configureCollab.py

- configureUtilities.py

- configureSOA.py

- configureUCM.py

- configureREST.py

- configureForum.py

- configureActivityGraphEngine.py

- configureWorklistIntegration.py

- configureWorklistDetail.py

- configureWorklistSDP.py

- configureCS.py

wcsamlsso.properties

このプロパティ・ファイル(WCP_ORACLE_HOME/common/bin/wcsamlsso.properties)は、SAML SSOのセットアップに必要な構成情報をカプセル化します。プロパティ・ファイルには次のセクションがあります。

spaces_config

このセクションでは、資格証明マッパーおよびソース・サイト・フェデレーション・サービスの構成に必要なWebCenter Portalドメインのログイン情報、WebLogic管理URL、WebCenter PortalサーバーおよびURLなどをキャプチャします。このセクションのすべてのプロパティを指定する必要があります。

- configFile - WebCenter Portalドメイン用のweblogicユーザー・アカウントとパスワードを含む構成ファイル

- keyFile - WebCenter Portalドメイン用のweblogicユーザー・アカウントとパスワードを復号化するためのキー・ファイル

- adminURL - WLSTに接続するためのWebLogic管理URL

- usesSSL - SSLを使用するようにWebCenter Portalが構成されているかどうかを示します。

- url - WebCenter Portal URL。usesSSLがtrueの場合は、httpをhttpsに変更してください。WebCenter PortalのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

- serverName - WebCenter Portalがデプロイされているサーバー(通常はWC_Collaboration)

- certAlias - SAMLアサーションに署名する証明書の別名

- certPassword - SAMLアサーションに署名する証明書の暗号化されたパスワード

collab_config

このセクションでは、アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスの構成に必要なコラボレーション・ドメインのログイン情報、管理URL、証明書ファイル・パスなどをキャプチャします。セットアップでディスカッションが構成されている場合のみ、このセクションを指定してください。

- configFile - サービス・ドメイン用のweblogicユーザー・アカウントとパスワードを含む構成ファイル

- keyFile - サービス・ドメイン用のweblogicユーザー・アカウントとパスワードを復号化するためのキー・ファイル

- adminURL - WLSTに接続するためのWebLogic管理URL

- usesSSL - SSLを使用するようにディスカッションが構成されているかどうかを示します。

- serverName - ディスカッションがデプロイされているサーバー(通常はWC_Collaboration管理対象サーバー)

- certAlias - SAMLアサーションを確認するための証明書の別名

- certPath - SAMLアサーションを確認するためのエクスポート済証明書のパス。証明書のパスは、ドメインをホストしているマシン上の有効なパス(つまり、adminURLで指定されているパス)である必要があります。

utilities_config

このセクションでは、アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスの構成に必要なユーティリティ・ドメインのログイン情報、管理URLおよび証明書ファイル・パスをキャプチャします。このセクションは、セットアップでアクティビティ・グラフ・アプリケーションが構成されている場合のみ指定してください。

- configFile - ユーティリティ・ドメイン用のweblogicユーザー・アカウントとパスワードを含む構成ファイル

- keyFile - ユーティリティ・ドメイン用のweblogicユーザー・アカウントとパスワードを復号化するためのキー・ファイル

- adminURL - WLSTに接続するためのWebLogic管理URL

- usesSSL - SSLを使用するようにユーティリティ・アプリケーションが構成されているかどうかを示します。

- serverName - ユーティリティ・アプリケーションがデプロイされているサーバー(通常はWC_Utilities管理対象サーバー)

- certAlias - SAMLアサーションを確認するための証明書の別名

- certPath - SAMLアサーションを確認するためのエクスポート済証明書のパス。証明書のパスは、ドメインをホストしているマシン上の有効なパス(つまり、adminURLで指定されているパス)である必要があります。

soa_config

このセクションでは、アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスの構成に必要なSOAドメインのログイン情報、管理URL、証明書ファイル・パスなどをキャプチャします。セットアップでSOAが構成されている場合のみ、このセクションを指定してください。

- configFile - SOAドメイン用のweblogicユーザー・アカウントとパスワードを含む構成ファイル

- keyFile - SOAドメイン用のweblogicユーザー・アカウントとパスワードを復号化するためのキー・ファイル

- adminURL - WLSTに接続するためのWebLogic管理URL

- usesSSL - SSLを使用するようにSOAアプリケーションが構成されているかどうかを示します。

- serverName - SOAアプリケーションがデプロイされているサーバー(通常はsoa_server1)

- certAlias - SAMLアサーションを確認するための証明書の別名

- certPath - SAMLアサーションを確認するためのエクスポート済証明書のパス。証明書のパスは、ドメインをホストしているマシン上の有効なパス(つまり、adminURLで指定されているパス)である必要があります。

ucm_config

このセクションでは、アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスの構成に必要なContent Serverドメインのログイン情報、管理URL、証明書ファイル・パスなどをキャプチャします。インストールでドキュメント・サービスが構成されている場合のみ、このセクションを指定してください。

- configFile - Content Server(UCM)ドメイン用のweblogicユーザー名とパスワードを含む構成ファイル

- usesSSL - SSLを使用するようにContent Serverアプリケーションが構成されているかどうかを示します。

- keyFile - Content Server(UCM)ドメイン用のweblogicユーザー・アカウントとパスワードを復号化するためのキー・ファイル

- adminURL - WLSTに接続するためのWebLogic管理URL

- serverName - Content Serverアプリケーションがデプロイされているサーバー(通常はUCM_server1)

- certPath - SAMLアサーションを確認するためのエクスポート済証明書のパス。証明書のパスは、ドメインをホストしているマシン上の有効なパス(つまり、adminURLで指定されているパス)である必要があります。

rss_config

これは必須です。

- url - RSS URL。spaces_config内のusesSSLがtrueである場合は、httpをhttpsに変更します。RSSのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

rest_config

このセクションは指定する必要があります。

- url - REST URL。spaces_config内のusesSSLがtrueである場合は、httpをhttpsに変更します。RESTのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

forum_config

構成にディスカッションがインストールされている場合は、このセクションを指定してください。

- url - OWCディスカッションURL。collab_configのusesSSLがtrueの場合は、httpをhttpsに変更してください。ディスカッションのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

worklist_config

WebCenter Portal用にSOAがインストールされ、ワークリストが構成されている場合は、このセクションを指定してください。

- worklist_detail - ワークリスト詳細アプリケーションURL。soa_config内のusesSSLがtrueである場合は、httpをhttpsに変更します。ワークリスト詳細アプリケーションのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

- worklist_sdp - ワークリストSDPアプリケーションURL。soa_config内のusesSSLがtrueである場合は、httpをhttpsに変更します。ワークリスト詳細アプリケーションのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

- worklist_integration - ワークリスト統合アプリケーションURL。soa_config内のusesSSLがtrueである場合は、httpをhttpsに変更します。ワークリスト詳細アプリケーションのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

activitygraph_config

構成にユーティリティ・サーバーがインストールされている場合は、このセクションを指定してください。

- url - ActivityGraphEngines URL。spaces_config内のusesSSLがtrueである場合は、httpをhttpsに変更します。アクティビティ・グラフ・アプリケーションのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。

cs_config

構成にContent Serverがインストールされており、WebCenter Portalアプリケーション用にドキュメント接続が構成されている場合は、このセクションを指定してください。

- url - Content Server URL。spaces_config内のusesSSLがtrueである場合は、httpをhttpsに変更します。Content ServerのフロントエンドがWeb層の場合は、Web層のホストとポートをここに指定します。環境にWebCenter PortalとContent Serverの両方が構成されている場合は、同じWeb層を使用して両方にアクセスする必要があります。

wcsamlsso.py

残りの構成スクリプトによって呼び出されるユーティリティ関数を含むスクリプト・ファイル(WCP_ORACLE_HOME/common/wlst/wcsamlsso.py)

configureSpaces.py

SAML 1.1資格証明マッパー、SAML 1.1アイデンティティ・アサータおよびソースならびに宛先サイト・フェデレーション・サービスをWebCenter Portalドメインに構成するための実行可能スクリプト(WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureSpaces.py)

configureCollab.py

SAML 1.1アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスをコラボレーション・ドメインに構成するための実行可能スクリプト(WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureCollab.py)

configureUtilities.py

SAML 1.1アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスをユーティリティ・ドメインに構成するための実行可能スクリプト(WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureUtilities.py)

configureSOA.py

SAML 1.1アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスをSOAドメインに構成するための実行可能スクリプト(WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureSOA.py)

configureUCM.py

SAML 1.1アイデンティティ・アサータおよび宛先サイト・フェデレーション・サービスをContent Serverドメインに構成するための実行可能スクリプト(WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureUCM.py)

configureREST.py

RESTアプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト(WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureREST.py)

configureRSS.py

RSSアプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト(WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureRSS.py)

configureForum.py

ディスカッションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト(WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureForum.py)

configureActivityGraphEngine.py

アクティビティ・グラフ・エンジン・アプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト(WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureActivityGraphEngine.py)

configureWorklistIntegration.py

ワークリスト統合アプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト(WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureWorklistIntegration.py)

configureWorklistDetail.py

ワークリスト・コミュニティ詳細アプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト(WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureWorklistDetail.py)

configureWorklistSDP.py

ワークリストSDPアプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト(WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureWorklistSDP.py)

configureCS.py

Content Serverアプリケーションのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト(WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureCS.py)

33.4.2.2.2 スクリプトの使用

SAMLベースのシングル・サインオンを構成するスクリプトを使用する手順は次のとおりです。

注意:
スクリプトの実行中に構成ミスによるエラーが発生した場合、SAML SSO構成は未完了の状態で終了する可能性があります。提供された構成スクリプトを再実行できない場合は、第33.4.2.6項「SAML SSO構成の削除」の説明に従って、構成を再試行する前にSAML SSOアーティファクトをクリーンアップする必要があります。

1. この構成で使用されるすべてのドメインの管理サーバーが稼働中であることを確認してください。

2. プロパティ・ファイルを適用するため、WCP_ORACLE_HOME/common/binからstoreUserConfig WLSTコマンドを使用して、様々なドメインの接続情報を含む構成およびキー・ファイルを生成します。使用方法と構文の詳細は、コマンド行のヘルプ(help('storeUserConfig'))を使用してください。

1. WLSTを使用し、管理ユーザー名とパスワードを使用してWebCenter Portalドメインに接続し、次のコマンドを実行します。
storeUserConfig('spacesconfig.secure', 'spaceskey.secure')

これによってユーザー構成ファイルと関連するキー・ファイルが作成されます。ユーザー構成ファイルには、暗号化されたユーザー名とパスワードが含まれます。キー・ファイルには、ユーザー名とパスワードの暗号化と復号化に使用される秘密鍵が含まれます。前述のコマンドは、WLSTを呼び出したディレクトリに構成およびキー・ファイルを格納します。または、より安全なパスをオプションで指定できます。

2. 管理ユーザー名とパスワードを使用してコラボレーション・ドメインに接続した後で、手順2aを繰り返します。ユーティリティ・サーバーがWebCenter Portalと同じドメイン(wc_domain)内にある場合でも、WebCenter Portalドメインに接続し、このコマンドを実行する必要があります。
storeUserConfig('collabconfig.secure', 'collabkeykey.secure')

3. 管理ユーザー名とパスワードを使用してユーティリティ・ドメインに接続した後で、手順2aを繰り返します。ユーティリティ・サーバーがWebCenter Portalと同じドメイン(wc_domain)内にある場合でも、WebCenter Portalドメインに接続し、このコマンドを実行する必要があります。
storeUserConfig('utilitiesconfig.secure', 'utilitieskey.secure')

4. 管理ユーザー名とパスワードを使用してSOAドメインに接続した後で、手順2aを繰り返します。WebCenter Portalと同じドメインにSOAがインストールされていても、WebCenter Portalドメインに接続してこのコマンドを実行する必要があります。
storeUserConfig('soaconfig.secure', 'soakey.secure')

5. 管理ユーザー名とパスワードを使用してContent Serverドメインに接続した後で、手順2aを繰り返します。
storeUserConfig('ucmconfig.secure', 'ucmkey.secure')

3. WLSTを起動してWLST encryptコマンドを実行し、証明書パスワードを暗号化します。使用方法と構文の詳細は、コマンド行のヘルプ(help('encrypt'))を使用してください。
print encrypt(obj='<certificatePassword>', domainDir='<full path to the WebCenter Portal domain directory>')

これによって、暗号化された証明書パスワードが表示されます。暗号化コマンドは、指定されたWebLogic Serverドメイン・ルート・ディレクトリに暗号化を使用します。暗号化された出力は、次の手順に出てくるwcsamlsso.propertiesでcertPassword値として設定する必要があります。このパスワードはWebCenter Portalドメインの資格証明マッパーとソース・サイト・フェデレーション・サービスに設定され、確実にWebCenter Portalドメインから暗号化ユーティリティが実行されるようになります。

4. WCP_ORACLE_HOME/common/bin/wcsamlsso.propertiesを編集して、セットアップに適用されるセクションを指定します。プロパティ・ファイルのセクションの詳細な説明は、第33.4.2.2.1項「シングル・サインオンのスクリプト」を参照してください。

5. WCP_ORACLE_HOME/common/binからWLSTを起動して、次に示された順番でスクリプトを実行します。

注意:
スクリプトには明示的な接続コマンドが含まれているので、スクリプトはWLSTオフライン・モードで実行してください。

1. execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureSpaces.py')
WebCenter Portalドメインの管理サーバーを含むすべてのサーバーを再起動します。

2. ディスカッション・サーバーをセットアップしてある場合は、configureCollab.pyスクリプトを実行します。
execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureCollab.py')

ディスカッションがWebCenter Portalと同じドメインに属している場合は、WC_Collaboration管理対象サーバーのみを再起動します。そうでない場合は、コラボレーション・ドメインの管理サーバーを含むすべてのサーバーを再起動します。

3. ユーティリティ・サーバーをセットアップしてある場合は、configureUtilities.pyスクリプトを実行します。
execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureUtilities.py')

ユーティリティ・サーバーがWebCenter Portalと同じドメインに属している場合は、WC_Utilitiesサーバーのみを再起動します。そうでない場合は、ユーティリティ・ドメインの管理サーバーを含むすべてのサーバーを再起動します。

4. WebCenter Portalのワークリストを構成してある場合は、configureSOA.pyスクリプトを実行します。
execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureSOA.py')

SOAドメインの管理サーバーを含むすべてのサーバーを再起動します。

5. WebCenter Portalにドキュメントを構成してある場合は、次のようにconfigureUCM.pyスクリプトを実行します。

execfile('WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureUCM.py')

Content Serverドメインの管理サーバーを含むすべてのサーバーを再起動します。

6. 環境の必要に応じて次の個々のコマンドを実行します。
execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureREST.py') - 再起動は必要ありません。

execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureRSS.py') - 再起動は必要ありません。

execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureForum.py') - セットアップにディスカッションがインストールされている場合はこれを行ってください。再起動は必要ありません。

execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureActivityGraphEngine.py') - セットアップにユーティリティがインストールされている場合はこれを行ってください。再起動は必要ありません。

execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureWorklistIntegration.py') - セットアップにワークリストがインストールされている場合はこれを行ってください。再起動は必要ありません。

execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureWorklistDetail.py') - セットアップにワークリストがインストールされている場合はこれを行ってください。再起動は必要ありません。

execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureWorklistSDP.py') - セットアップにワークリストがインストールされている場合はこれを行ってください。再起動は必要ありません。

execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureCS.py') - セットアップにContent Serverがインストールされている場合はこれを行ってください。再起動は必要ありません。

7. 第33.4.2.4項「構成のチェック」の手順を使用して、インストールをチェックします。

重要:
プロパティ・ファイルには機密情報が含まれているので、SAML SSOセットアップの構成および検証後に<WCP_ORACLE_HOME>/common/binからこれを削除してください。前述の手順2で生成した構成およびキー・ファイルも削除します。

注意:
スクリプトの実行中にエラーが発生した場合は、スクリプトを再実行する前に、第33.4.2.6項「SAML SSO構成の削除」の説明に従って、スクリプトによってセットアップされたアサーティングおよびリライイング・パーティを削除する必要があります。
古いSAML SSO構成を削除したら、スクリプトを再実行してください。

33.4.2.3 外部リーダーを使用したRSS用のSAML SSOの構成

デフォルトでは、WebCenter Portal RSSフィードはSSOによって保護されています。ただし、保護されたままの状態では、それらは外部リーダーでうまく機能しません。外部リーダーを使用したアクセスが重要な場合は、その外部リーダーが処理できるWebLogic ServerのBASIC認証によってRSSサーブレットの認証が処理されるように、WebCenter Portal RSSリソースを非保護にすることをお薦めします。

次の手順に従って、RSSフィードを非保護にします。

1. WebCenter PortalドメインのWLS管理コンソールにログオンします。

2. セキュリティ・レルムを開き、「プロバイダ」→「資格証明マッピング」→「wcsamlcm」→「管理」→「リライイング・パーティ」を選択します。

3. RSSのリライイング・パーティを無効化または削除します。

4. セキュリティ・レルムを開き、「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」を選択します。

5. RSSのアサーティング・パーティを無効化または削除します。

33.4.2.4 構成のチェック

次の手順に従って、シングル・サインオン構成が正しく動作することをチェックします。

シングル・サインオン構成をテストする手順は次のとおりです。

1. 新しいブラウザを使用して、WebCenter Portalにログインし、「管理」→「ツールとサービス」→「ディスカッション」の「フォーラムの管理」をクリックしても、資格証明についてチャレンジされないことをチェックします(このサービスがポータル用にプロビジョニングされていると仮定します)。

2. ディスカッションまたはワークリスト・タスク・フローからRSSリンクにアクセスして、ログインのためにチャレンジされないことをチェックします。

3. Content Serverの場合は、プロファイル・ユーザー・インタフェースに移動し、ログインをチャレンジされずに、iFrames内に埋め込まれているContent Server画面が表示されることを確認します。すでにWebCenter Portalにログインしている際には、ログインをチャレンジされずにコンテンツ・プレゼンタ・テンプレートのSite Studioコンテンツにもアクセスできます。

4. http://host:port/rest/api/resourceIndexにアクセスし、BASIC認証チャレンジが表示されることを確認します。同じSSOを使用する別の関連アプリケーションにすでにログインしている場合は、ログインへのチャレンジなしでコンテンツを表示できるはずです。

5. SOAをテストするには、ワークフロー・タスク・フローのリンクにアクセスして、ログインをチャレンジされないことを確認します。

SAML SSOのテスト中にエラー404または403が発生した場合は、SAML構成を確認して、AdminServerでのSAMLのデバッグ・ロギングも有効化します。また、WC_Spacesサーバーおよび宛先サイトをホストしているサーバーのロギングも有効化します。ログは$domain.home/servers/<server>/logs/<server>.logで使用可能です。WC_Spacesおよび他のアプリケーション・サーバーのロギングを有効化する方法の詳細は、第28.2.1項「WebCenter Portalログの表示および構成」を参照してください。スクリプトを再実行する前に、第33.4.2.6「SAML SSO構成の削除」の説明に従って、SAML SSO構成を削除します。

33.4.2.5 SAML SSO構成の無効化

この項では、テストなどのためにSAML SSO構成を一時的に無効にする方法を説明します。

SAML SSO構成を無効にする手順は次のとおりです。

1. WebCenter PortalドメインのWLS管理コンソールにログオンします。

2. セキュリティ・レルムを開き、「プロバイダ」→「資格証明マッピング」→「wcsamlcm」→「管理」→「リライイング・パーティ」を選択し、そこに示されたリライイング・パーティをすべて無効にします。

3. セキュリティ・レルムを開き、「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」を選択して、表示されたアサーティング・パーティをすべて無効にします。

4. SOAやContent Serverなど、SAML SSOで構成されている他のWLSドメインがある場合は、それらのドメインからもSAML SSO構成を削除します。

1. WLSドメインのWLS管理コンソールにログインします。

2. セキュリティ・レルムを開き、「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」を選択して、表示されたアサーティング・パーティをすべて無効にします。

5. アプリケーションを開き、サインインを要求されないことをチェックして、SAML SSO構成が無効になっていることを確認します。

33.4.2.6 SAML SSO構成の削除

SAML SSO構成スクリプトにはクリーンアップ機能は含まれていないので、wcsamlsso.propertiesファイルの更新中やスクリプトの実行中にミスをすると、構成は無効な状態になる可能性があります。この場合は、ここですべてのSAML SSO構成をクリーンアップして、もう一度やりなおすことをお薦めします。この項では、SAML SSO構成を削除する手順を説明します。

SAML SSOを完全にセットアップした場合(つまり、スクリプトが完全に実行された場合)は、次のすべての指示が有効になることに注意してください。ただし、スクリプトの実行中にエラーが発生すると、構成は不完全なものになる可能性があります。その場合は次のアーティファクトの一部のみが存在し、削除することが必要になります。

SAML SSO構成を削除するには:

1. WebCenter PortalドメインのWLS管理コンソールにログオンします。

2. セキュリティ・レルムを開き、「プロバイダ」→「資格証明マッピング」→「wcsamlcm」→「管理」→「リライイング・パーティ」を選択し、そこに示されたリライイング・パーティをすべて削除します。

3. セキュリティ・レルムを開き、「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」を選択して、表示されたアサーティング・パーティをすべて削除します。

4. 「プロバイダ」→「認証」→「wcsamlia」→「管理」→「証明書」に移動し、そこで証明書をすべて削除します。

5. 「プロバイダ」→「資格証明マッピング」→「wcsamlcm」に移動して、SAML資格証明マッパーを削除します。

6. 「プロバイダ」→「認証」→「wcsamlia」に移動し、SAMLアイデンティティ・アサータを削除します。

7. WebCenter Portal WLSドメイン全体を再起動します。

8. SOAやContent Serverなど、SAML SSOで構成されている他のWLSドメインがある場合は、それらのドメインからもSAML SSO構成を削除します。

1. WLSドメインのWLS管理コンソールにログインします。

2. セキュリティ・レルムを開き、「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」を選択して、表示されたアサーティング・パーティをすべて削除します。

3. 「プロバイダ」→「認証」→「wcsamlia」→「管理」→「証明書」に移動し、そこで証明書をすべて削除します。

4. 「プロバイダ」→「認証」→「wcsamlia」に移動し、SAMLアイデンティティ・アサータを削除します。

5. WLSドメイン全体を再起動します。

9. アプリケーションを開き、サインインを要求されないことをチェックして、SAML SSO構成が削除されていることを確認します。これで、スクリプトを再度安全に使用して、SAML SSOを再構成できるようになります。

33.5 Microsoftクライアント用のSSOの構成

この項では、SPNEGO (Simple and Protected Negotiate)メカニズムとKerberosプロトコルに基づくWindows認証とWebCenter Portal用のWebLogicネゴシエート・アイデンティティ・アサーション・プロバイダを使用して、Microsoftクライアントでのシングル・サインオン(SSO)をセットアップする方法について説明します。このSSOアプローチによって、Kerberosを使用してWindowsドメイン内で認証されたMicrosoftクライアント(ブラウザなど)は、パスワードを再入力する必要なしで、同じ資格証明に基づいて、WebLogicドメイン内のWebアプリケーション(WebCenter Portalなど)に対して透過的に認証されることが可能になります。WebCenter PortalでのMicrosoft Officeクライアントの使用の詳細は、第26章「Microsoft Office統合の管理」を参照してください。

クロスプラットフォーム認証は、Kerberosプロトコルを使用したネイティブのWindows間認証サービスのネゴシエート動作をエミュレートすることで達成されます。クロスプラットフォーム認証を有効にするためには、非Windowsサーバー(この場合はWebLogic Server)は、認証に使用されるKerberosトークンを抽出するためにSPNEGOトークンを解析する必要があります。

この項には次のサブセクションが含まれます:

- 第33.5.1項「MicrosoftクライアントSSOの概念」

- 第33.5.2項「システム要件」

- 第33.5.3項「Microsoftクライアントの構成」

33.5.1 MicrosoftクライアントSSOの概念

Kerberosの理解

Kerberosは、ネットワークのサービスに対するリクエストを認証するためのセキュアな方法です。Kerberosプロトコルは、クライアント、サーバーおよびそれらを仲介するKDC(Key Distribution Center)という信頼できるサード・パーティの3つのパーティから構成されます。Kerberosでは、ユーザーがそのアイデンティティを証明するKerberosチケットをサーバーに提供できる場合は、サーバーはユーザーがそのサービスにアクセスすることを許可します。ユーザーとサービスの両方が、KDCに登録された鍵を持つ必要があります。

次の図は、クライアントがサーバーに接続する前に行われる必要がある基本的なやり取りを示しています。

図33-10 Key Distribution Centerを通したサーバーへの接続

SPNEGOの理解

SPNEGO(Simple and Protected GSSAPI Negotiation Mechanism)は、いくつかの可能な現実のメカニズムの1つをネゴシエートするために使用されるGSSAPI疑似メカニズムです。SPNEGOは、クライアント・アプリケーションがリモート・サーバーに対して認証したい場合に、どちらのエンドも他方がサポートする認証プロトコルがわからない場合に使用されます。この疑似メカニズムでは、あるプロトコルを使用して利用可能な共通のGSSAPIメカニズムを判断して選択し、強化されたセキュリティ操作をすべてそれにディスパッチします。このため、組織は新しいセキュリティ・メカニズムを段階的にデプロイできます。

SPNEGOは、MicrosoftのHTTP Negotiate認証拡張での使用が最も目立っています。ネゴシエート可能なサブメカニズムにはNTLMとKerberosがあり、両方ともActive Directoryで使用されています。

この機能によってクライアント・ブラウザは、WebLogic Server上の保護されたリソースにアクセスし、SPNEGOチケットを使用してKerberosデータベースの認証情報をWebLogic Serverに透過的に提供することができます。WebLogic Serverはチケットを認識して、そこから情報を抽出できます。そしてWebLogic Serverは、その情報を使用して認証を行い、認証されたユーザーがリソースへのアクセスを認可されている場合はリソースへのアクセスを付与します。(Kerberosは認証のみを担当し、認可はWebLogic Serverが処理します。)

図33-11 SPNEGOベースの認証

33.5.2 システム要件

MicrosoftクライアントでSSOを使用するには、次が必要です。

次を装備したホスト・コンピュータ:

- Windows 2000以降がインストールされていること

- 完全に構成されたActive Directory認証サービス。具体的なActive Directory要件は次のとおりです。

- Kerberosサービスをマッピングするためのユーザー・アカウント

- これらのアカウントのサービス・プリンシパル名(SPN)

- 作成されてWebLogic Serverドメインの起動ディレクトリにコピーされたキー・タブ・ファイル

- この項で説明されているように、Kerberosを通して認証するように適切にインストールおよび構成されたWebLogic Server

次を装備したクライアント・システム:

- Windows 2000 Professional SP2以降がインストールされていること

- 次のいずれかのタイプのクライアント:

- 適切に構成されたInternet Explorerブラウザ。Internet Explorer 6.01以降がサポートされます。

- .NET Framework 1.1および適切に構成されたWebサービス・クライアント。

注意:
クライアントはWindows 2000ドメインにログオンする必要があり、そのドメインのActive Directoryサーバーから取得されたKerberos資格証明を持つ必要があります。ローカル・ログオンは機能しません。

33.5.3 Microsoftクライアントの構成

MicrosoftクライアントでSSOを構成するには、図33-12に示されているMicrosoft Active Directory、MicrosoftクライアントおよびWebLogic Serverドメインを構成する必要があります。詳細な構成手順とトラブルシューティングについては、『Oracle WebLogic Serverの保護』のMicrosoftクライアントでのシングル・サインオンの構成に関する項を参照してください。

図33-12 MicrosoftクライアントでのSSOの構成

SSO用にMicrosoftクライアントを構成するには:

1. Kerberosを使用するようにネットワーク・ドメインを構成します。

2. WebLogic Server用のKerberos識別情報を作成します。

1. WebLogic Serverを実行中のホストのActive Directoryにユーザー・アカウントを作成します。

2. このアカウントのサービス・プリンシパル名を作成します。

3. このアカウントのユーザー・マッピングとキータブ・ファイルを作成します(『Oracle WebLogic Serverの保護』のMicrosoftクライアントでのシングル・サインオンの構成に関する項を参照)。

3. ブラウザ・クライアント(Internet ExplorerまたはMozilla Firefox)を選択し、Kerberosトークンを使用するようにそれを構成します(Oracle Fusion Middleware Oracle Access Manager統合ガイドのKerberosトークンを返すためのブラウザの構成に関する項を参照)。

4. Kerberos認証を使用するようにWebLogic Serverドメイン(この場合はwc_domain)をセットアップします。

1. MicrosoftドメインのActive Directoryサーバーと手順2で作成したキータブ・ファイルをポイントするJAASログイン・ファイルを作成します(『Oracle WebLogic Serverの保護』のJAASログイン・ファイルの作成に関する項を参照)。

2. WebLogic Serverセキュリティ・レルムでネゴシエート・アイデンティティ・アサーション・プロバイダを構成します(第33.5.3.1項「ネゴシエート・アイデンティティ・アサーション・プロバイダの構成」を参照)。

3. Active Directoryオーセンティケータを使用するようにWebLogic Serverドメインを構成して、WebLogicドメインがアイデンティティ・ストアと同じActive Directoryドメインを使用するようにします。または、別のアイデンティティ・ストアを使用して、このストアのユーザーをドメインのActive Directoryユーザーと照合することもできますが、2つの異なるアイデンティティ・ストアを使用すると同期が失われる危険性があるため、Active Directoryオーセンティケータを使用することをお薦めします(第33.5.3.2項「Active Directory認証プロバイダの構成」を参照)。

注意:
アイデンティティ・ストアのみをActive Directory用に構成してください。ポリシーおよび資格証明ストアはActive Directoryに対して認証されません。

5. 次のシステム・プロパティを各WebCenter PortalマシンのsetDomainEnv.shのJAVA_OPTIONSに追加します。それぞれの値は、特定のホストの値に変更してください(1行に指定)。

-Dnon_sso_protocol=http (the protocol to access WebCenter Portal directly through the WC_Spaces server without going through OHS)
-Dnon_sso_host=example.com (the host for the WLS WC_Spaces server)
-Dnon_sso_port=8888 (the port for the WLS WC_Spaces server)
-Dsso_base_url=http://example.com:7777 (the URL for accessing the WC_Spaces server through OHS)

non_sso値は、プロトコル、ホストおよびポートについてのマシン上の値です。sso値は、OHSを通してルーティングされた際にユーザーに表示される値です。

6. WebCenter Portalに対しては、第33.6項「仮想ホストを使用したSSOの構成」の説明に従って、WebCenter Portal用のOracle WebLogic Serverにリクエストを転送するようにWeb層OHSを構成します。

7. 手順5で指定した起動引数を使用して、WebLogic Server (管理サーバーおよび管理対象サーバー)を再起動します。SOAドメインに対して手順4、5および6を繰り返し、SOAアプリケーションでのシングル・サインオンを有効化します。

8. OHSを再起動して変更を有効にします。

9. ディスカッション・サーバーを構成します(第33.5.3.4項「SSO用のディスカッション・サーバーの構成」を参照)。

33.5.3.1 ネゴシエート・アイデンティティ・アサーション・プロバイダの構成

この項では、ネゴシエート・アイデンティティ・アサーション・プロバイダの作成および構成手順を説明します。ネゴシエート・アイデンティティ・アサーション・プロバイダによって、Microsoftクライアントのシングル・サインオン(SSO)が可能になります。アイデンティティ・アサーション・プロバイダは、SPNEGO(Simple and Protected Negotiate)トークンをデコードして、Kerberosトークンを取得し、それらのKerberosトークンを検証して、それらをWebLogicユーザーにマップします。ネゴシエート・アイデンティティ・アサーション・プロバイダはJava GSS(Generic Security Service) API(Application Programming Interface)を使用して、Kerberosを通してGSSセキュリティ・コンテキストを受け付けます。

ネゴシエート・アイデンティティ・アサーション・プロバイダを構成するには:

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます。

3. セキュリティ・レルムをクリックします。
セキュリティ・レルムの「設定」ページが表示されます。

4. 「プロバイダ」タブを開き、「認証」サブタブを選択します。
「認証設定」ペインが表示されます。

5. 「新規」をクリックします。
「新しい認証プロバイダの作成」ペインが表示されます。

6. アイデンティティ・アサータの「名前」を入力し、「タイプ」としてNegotiateIdentityAsserterを選択します。

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

33.5.3.2 Active Directory認証プロバイダの構成

次の手順に従って、WebLogic管理コンソールを使用してActive Directory認証プロバイダを構成します。

Active Directory認証プロバイダを構成するには:

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます。

3. セキュリティ・レルムをクリックします。
セキュリティ・レルムの「設定」ページが表示されます。

4. 「プロバイダ」タブを開き、「認証」サブタブを選択します。
「認証設定」ペインが表示されます。

5. 「新規」をクリックします。
「新しい認証プロバイダの作成」ペインが表示されます。

6. 認証プロバイダの「名前」を入力し、「タイプ」としてActiveDirectoryAuthenticatorを選択します。

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

8. プロバイダのリストで、今作成した認証プロバイダをクリックします。
プロバイダの設定ページが表示されます。

9. 「構成」タブを開き、「共通」サブタブを開きます。

10. 制御フラグをSUFFICIENTに設定し、「保存」をクリックします。

注意:
他のすべてのオーセンティケータの制御フラグの設定も、SUFFICIENTに変更する必要があります。制御フラグがREQUIREDに設定された既存のデフォルト・オーセンティケータがある場合は、これをSUFFICIENTに変更する必要があります。

11. 「プロバイダ固有」サブタブを開きます。
プロバイダ固有の設定ペインが表示されます。

12. 次の表に示されているように、各フィールドに値を入力します。これら以外のフィールドは、デフォルト値のままにします。

表33-3 Active Directoryオーセンティケータの設定

パラメータ

値

説明

ホスト:

LDAPサーバーのホストID

ポート:

LDAPサーバーのポート番号

プリンシパル:

LDAP管理者プリンシパル

資格証明:

ユーザー・ベースDN:

ユーザー検索ベース(例: OU=spnego unit,DC=admin,DC=oracle,DC=com)

名前指定によるユーザー・フィルタ:

(&(cn=%u)(objectclass=user))

ユーザー検索スコープ:

subtree

ユーザー名属性:

cn

ユーザー検索スコープ:

user

グループ・ベースDN:

グループ検索ベース(ユーザー・ベースDNと同じ)

名前指定によるグループ・フィルタ:

(&(cn=%g)(objectclass=group))

グループ検索スコープ:

subtree

静的グループ名属性:

cn

静的グループ・オブジェクト・クラス:

group

静的メンバーDN属性:

member

メンバーDN指定による静的グループDNフィルタ:

(&(member=%M)(objectclass=group))

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

14. プロバイダのサマリー・ページで、次の順序にプロバイダを並べ替え、それらの制御フラグが適宜SUFFICIENTに設定されていることを確認します。

1. ネゴシエート・アイデンティティ・アサータ

2. ActiveDirectoryAuthenticator (SUFFICIENT)

3. DefaultAuthenticator (SUFFICIENT)

4. 他のオーセンティケータ

33.5.3.3 WebCenter Portalの構成

ネゴシエート・アイデンティティ・アサーション・プロバイダとActive Directoryオーセンティケータの構成手順を完了し、WebLogicドメインの全アプリケーションと必要なドメインのMicrosoftクライアントをシングル・サインオン用に構成したら、ユーザーがWebCenter Portalにアクセスしたときにシームレスなシングル・サインオン・エクスペリエンスを提供するための最終ステップを実行する必要があります。これは次の2通りの方法で実行できます。

- 管理者としてWebCenter Portalにログインし、Public-UserロールからViewアクセスを削除することで、パブリック・アクセスをオフにします。パブリック・アクセスをオフにすると、URL http://host:port/webcenterにアクセスしたユーザーには、ログイン・セクションを持つデフォルト・パブリック・ページではなく、認証されたビューが直接表示されます。これは、ユーザーがInternet Explorerのみを使用してWebCenter Portalにアクセスし、WNAがセットアップされたドメインに限定されている場合にお薦めします。

- WebCenter Portalへのパブリック・アクセスを維持する必要がある場合は、WC_Spacesサーバーの起動時にoracle.webcenter.spaces.osso=trueフラグを使用することをお薦めします。このフラグはSSOが使用されていることをWebCenter Portalに告げるため、デフォルトのランディング・ページにログイン・フォームは表示されなくなります。かわりに、ユーザーが自動的にログインしてSSO認証を起動するためのログイン・リンクが表示されます。WNA用に構成されたWindowsネットワーク内でFirefoxを使用してWebCenter Portalにアクセスする場合、またはWindowsネットワーク・ドメインの外側からいずれかのブラウザを使用してWebCenter Portalにアクセスする場合は、ユーザーがこのログイン・リンクをクリックするとログイン・ページが表示されます。

33.5.3.4 SSO用のディスカッション・サーバーの構成

この項では、シングル・サインオン用のディスカッション・サーバーを構成する方法を説明します。SSO用のディスカッション・サーバーを構成する前に、第31.4.1項「ディスカッション・サーバーの新しい管理者アカウントの識別」の説明に従って、WebCenter Portalと同じアイデンティティ・ストアLDAPを使用するようにこれが構成されていることを確認してください。

SSO用のディスカッション・サーバーを設定する手順は次のとおりです。

1. Oracle WebCenter Portalのディスカッション・サーバー管理コンソールにログインします。

http://host:port/owc_discussions/admin

hostおよびportは、WC_Collaboration管理対象サーバーのホストIDとポート番号です。

2. 「システム・プロパティ」ページを開き、owc_discussions.sso.modeプロパティを編集(存在している場合)または追加します(値をtrueに設定します)。

33.6 仮想ホストを使用したSSOの構成

この項では、コンテキスト・ルートとして/を使用するアプリケーションを含む環境に必要なOHS構成と、シングル・サインオンが呼び出される際にOHSで必要な追加構成について説明します。

この項には次のサブセクションが含まれます:

- 第33.6.1項「仮想ホストの必要性の理解」

- 第33.6.2項「OSSO用の仮想ホストの構成」

- 第33.6.3項「OAM 10g用の仮想ホストの構成」

- 第33.6.4項「OAM 11g用の仮想ホストの構成」

- 第33.6.5項「仮想ホスト用のWebCenter Portalの構成」

- 第33.6.6項「構成のテスト」

33.6.1 仮想ホストの必要性の理解

WebCenter Portal Suiteには、コンテキスト・ルートとして/を使用するデスクトップ統合アプリケーションが含まれています。シングル・サインオン環境でこのアプリケーションを使用する場合は、OHSを通してこれをルーティングする必要があります。仮想ホストを使用しないでこれを行うために、次のエントリをmod_wl_ohs.confに追加することもできます。

<Location  />
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

ただし、これを行うと、明示的に定義されていないすべてのコンテキスト・ルートが影響を受けます。そのため、仮想ホストが必要になります。

仮想ホストという用語は、1台のマシン上で複数のWebサイト(www.company1.comとwww.company2.comなど)を実行することを示します。仮想ホストはIPベース(それぞれのWebホストごとに異なるIPアドレスを持つこと)にすることも、名前ベース(各IPアドレスに複数の名前を持つこと)にすることもできます。それらが同じ物理サーバー上で動作しているという事実は、エンド・ユーザーにはわかりません。仮想ホストの詳細は、Apacheのドキュメントを参照してください。

33.6.2 OSSO用の仮想ホストの構成

この項では、シングル・サインオン・ソリューションとしてOSSOが構成されている場合に仮想ホストを構成する手順を説明します。これらの手順を行う前に、第33.3項「Oracle Single Sign-On(OSSO)の構成」の手順を完了している必要があります。

OSSOで仮想ホストを使用するには、パートナ・アプリケーションを仮想ホスト・オプションに登録する必要があります。また、webtier-spaces.example.comではシングル・サインオンをバイパスする必要があります。この理由は、BASIC認証のみをサポートするアプリケーションや、シングル・サインオンを必要としないアプリケーションがあるからです。これらの構成について、次の手順で説明します。

1. mod_osso.confファイルをmoduleconfからhttpd.confと同じ場所に移動します。(moduleconf内のすべてのファイルはデフォルトで自動的にロードされますが、仮想ホストに対してOSSOを無効にする必要があります。)

2. 次の例に示されているように、httpd.confの仮想ホストのセットアップを更新します。

NameVirtualHost *:7777

<VirtualHost *:7777>
ServerName webtier.example.com
include mod_osso.conf
</VirtualHost>

<VirtualHost *:7777>
ServerName webtier-spaces.example.com
<Location  />
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>
<Location /webcenter>
Deny from all
</Location>
<Location /webcenterhelp>
Deny from all
</Location>
<Location /rest>
Deny from all
</Location>
</VirtualHost>

mod_osso.confをデフォルト仮想ホストにインクルードすることで、デフォルト仮想ホスト(webtier.example.com)にシングル・サインオン・エクスペリエンスを提供します。ただし、一部のアプリケーションはこれをサポートしないため、WebCenter Portal仮想ホスト(webtier-spaces.example.com)にはシングル・サインオン・エクスペリエンスを提供しません。

3. OHSを再起動します。また、必ずwebtier-spaces.example.comのエントリを使用してDNSを更新してください。

注意:
シングル・サインオンをバイパスするwebtier-spaces.example.com仮想ホストでは、シングル・サインオンをバイパスする必要があるのは、一部のアプリケーションのみです。WebCenter Portalなどの他のアプリケーションでは、シングル・サインオンが必要なため、この仮想ホストからそれらのアプリケーションへのアクセスは拒否されます。

33.6.3 OAM 10g用の仮想ホストの構成

仮想ホストにOAM 10gを構成するには、BASIC認証のみをサポートするアプリケーションやシングル・サインオンを必要としないアプリケーションについてシングル・サインオンをバイパスする必要があります。詳細は、10g用のOracle Fusion Middleware Oracle Access ManagerおよびOracle Security Token Service管理者ガイドのWebGateと特定仮想ホスト、ディレクトリまたはファイルの関連付けに関する項を参照してください。

これらの手順を完了する前に、第33.2項「Oracle Access Manager (OAM)の構成」に示されているOAM 10gの構成手順を完了している必要があります。

1. httpd.confの次の構成を見つけてコメント・アウトします。

#Comment out this and move to VirtualHost configuration
#<LocationMatch "/*">
#AuthType Oblix
#require valid-user
#</LocationMatch>

このエントリがあると、WebGateはすべてのリクエストをインターセプトして処理します。

2. 次の例に示されているように、シングル・サインオンが必要とされる仮想ホスト構成にこのエントリを移動します。

NameVirtualHost *:7777

<VirtualHost *:7777>
ServerName webtier.example.com
<LocationMatch "/*">
AuthType Oblix
require valid-user
</LocationMatch>
</VirtualHost>

<VirtualHost *:7777>
ServerName webtier-spaces.example.com
<Location  />
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>
<Location /webcenter>
Deny from all
</Location>
<Location /webcenterhelp>
Deny from all
</Location>
<Location /rest>
Deny from all
</Location>
</VirtualHost>

デフォルト仮想ホスト(webtier.example.com)にはシングル・サインオン・エクスペリエンスを提供しますが、一部のアプリケーションはこれをサポートしないため、WebCenter Portal仮想ホスト(webtier-spaces.example.com)にはシングル・サインオン・エクスペリエンスを提供しないという考え方です。

3. OHSを再起動します。さらに、webtier-spaces.example.comのエントリによるDNSの更新も行ってください。

注意:
シングル・サインオンをバイパスするwebtier-spaces.example.com仮想ホストでは、シングル・サインオンをバイパスする必要があるのは、一部のアプリケーションのみです。WebCenter Portalなどの他のアプリケーションでは、シングル・サインオンが必要なため、この仮想ホストからそれらのアプリケーションへのアクセスは拒否されます。

33.6.4 OAM 11g用の仮想ホストの構成

仮想ホストにOAM 11gを構成するには、BASIC認証のみをサポートするアプリケーションやシングル・サインオンを必要としないアプリケーションについてシングル・サインオンをバイパスする必要があります。

これらの手順を完了する前に、第33.2項「Oracle Access Manager (OAM)の構成」に示されているOAM 11gの構成手順を完了している必要があります。

OAM 11gの仮想ホストを構成する手順は次のとおりです。

1. webgate.confの次の構成を見つけてコメント・アウトします。

#Comment out this and move to VirtualHost configuration
#<LocationMatch "/*">
#AuthType Oblix
#require valid-user
#</LocationMatch>

このエントリがあると、WebGateはすべてのリクエストをインターセプトして処理します。

2. 次の例に示されているように、シングル・サインオンが必要とされるhttpd.confの仮想ホスト構成にこのエントリを移動します。

NameVirtualHost *:7777

<VirtualHost *:7777>
ServerName webtier.example.com
<LocationMatch "/*">
AuthType Oblix
require valid-user
</LocationMatch>
</VirtualHost>

<VirtualHost *:7777>
ServerName webtier-spaces.example.com
<Location  />
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>
<Location /webcenter>
Deny from all
</Location>
<Location /webcenterhelp>
Deny from all
</Location>
<Location /rest>
Deny from all
</Location>
</VirtualHost>

デフォルト仮想ホスト(webtier.example.com)にはシングル・サインオン・エクスペリエンスを提供しますが、一部のアプリケーションはこれをサポートしないため、WebCenter Portal仮想ホスト(webtier-spaces.example.com)にはシングル・サインオン・エクスペリエンスを提供しないという考え方です。

3. OHSを再起動します。さらに、webtier-spaces.example.comのエントリによるDNSの更新も行ってください。

注意:
シングル・サインオンをバイパスするwebtier-spaces.example.com仮想ホストでは、シングル・サインオンをバイパスする必要があるのは、一部のアプリケーションのみです。WebCenter Portalなどの他のアプリケーションでは、シングル・サインオンが必要なため、この仮想ホストからそれらのアプリケーションへのアクセスは拒否されます。

33.6.5 仮想ホスト用のWebCenter Portalの構成

この項では、仮想ホストを通してルーティングされるアプリケーションに必要な追加構成について説明します。

Sharepoint

MS Office製品の「単語の編集」機能または類似機能を使用すると、通常はWebCenter Portal Sharepointアプリケーションが現在のリクエストからホスト名とポート名を取得します。ただし、この場合、Sharepointアプリケーションは仮想ホストを通してルーティングする必要があり、この仮想ホストでは一部のシステム・プロパティをWebLogicドメインのsetDomainEnvに設定することが必要とされます。クラスタ・セットアップの場合は、マシンごとに必ずこれらのプロパティを変更してください。

-Dnon_sso_host=webtier-spaces.example.com
-Dsso_base_url=http://webtier.example.com:7777

33.6.6 構成のテスト

この項では、仮想ホストおよびシングル・サインオン構成のテスト方法を説明します。

Sharepoint

1. http://webtier.example.com:7777/webcenterにアクセスして、SSOによってチャレンジされることをチェックします。

2. ログインしてMS Wordドキュメントを選択し、「単語の編集」をクリックします。確認のダイアログが表示されたら、「OK」をクリックします。WordによってBASIC認証のチャレンジが実行されます。資格証明を入力すると、ドキュメントを表示できます。

3. Officeアイコン→「サーバー」→「ドキュメント管理情報」に移動して、「サイトをブラウザーで開く」をクリックします。これによって、デフォルト・ブラウザで、ドキュメントが属するポータルが開きます。
MS Officeの統合には、ドキュメントのURLと同じURLに移動する必要があるという制限があるため、BASIC認証チャレンジによって入力が要求されることに注意してください。webtier.example.comを通してポータルにリダイレクトされて、まだログインしていない場合はログインするように要求されます。

34 シングル・サインオン向けのPortal Frameworkアプリケーションの構成

この章では、Portal Frameworkアプリケーションまたはポートレット・プロデューサ・アプリケーションをシングル・サインオン(SSO)向けに構成する方法を説明します。この章で説明する構成ではすべて、第33項「シングル・サインオンの構成」の説明に従ってSSOがすでに構成されていることが前提となっています。

この章には次の項が含まれます:

- 第34.1項「構成の概要」

- 第34.2項「シングル・サインオンの前提条件」

- 第34.3項「Web層の構成」

- 第34.4項「OAMに対するPortal Frameworkアプリケーションおよびポートレット・プロデューサ・アプリケーションの構成」

- 第34.5項「OSSOに対するPortal Frameworkアプリケーションの構成」

- 第34.6項「SAML SSOに対するPortal Frameworkアプリケーションの構成」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

34.1 構成の概要

Oracle WebCenter Portalでは、Portal Frameworkアプリケーションに対して、次のSSOソリューションのシングル・サインオン(SSO)がサポートされます。

- OAM 10g

- OAM 11g

- OSSO

- SAML SSO (宛先アプリケーションとしてのPortal Frameworkアプリケーション)

- SAML SSO (ソース・アプリケーションとしてのPortal Frameworkアプリケーション)

Portal Frameworkアプリケーションをシングル・サインオンに含めることができるようにするには、第33章「シングル・サインオンの構成」で説明しているSSOの構成に加えて、選択したSSOソリューションに対してPortal Frameworkアプリケーション自体を構成することも必要です。これを実行するには、第34章「シングル・サインオンの前提条件」に示された手順を実行した後、特定のソリューションの手順を続行してください。この場合、唯一の例外がSAML SSOで、Portal Frameworkアプリケーションがソース・アプリケーションとして機能します。すべての手順については、前提条件を含めて、第34.6.2項「ソースとしてのPortal Frameworkアプリケーションに対するSAML SSOの構成」で説明しています。

34.2 シングル・サインオンの前提条件

SSOに含めるすべてのPortal Frameworkアプリケーションでは、そのアプリケーションの保護に使用されるシングル・サインオン・ソリューションに関係なく、一定の構成を適切に行うことが必要です。この場合、唯一の例外がSAML SSOで、Portal Frameworkアプリケーションがソース・アプリケーションとして機能します(詳細は、第34.6.2項「ソースとしてのPortal Frameworkアプリケーションに対するSAML SSOの構成」を参照してください)。

シングル・サインオンの一般的な前提条件は、次の各項で説明しています。

- 第34.2.1項「web.xmlへのCLIENT-CERTの追加」

- 第34.2.2項「JSESSIONIDのCookieパスの設定」

- 第34.2.3項「アプリケーションの公開URIおよび保護対象URIの指定」

- 第34.2.4項「埋込みログインの意味」

- 第34.2.5項「ログアウトの処理」

34.2.1 web.xmlへのCLIENT-CERTの追加

すべてのSSOソリューションで、WLSドメインに構成されたアイデンティティ・アサータが使用されます。これは、SSO構成で提供されるアサーション・タイプをアサートします。たとえば、OAMの場合、アイデンティティ・アサータは、ObSSOCookieまたはOAM_REMOTE_USERヘッダーに基づいてアサートし、SAML SSOの場合はSAMLアサーションをアサートします。

アサータでアイデンティティをアサートするには、アプリケーションのログイン構成に認証方式としてCLIENT-CERTを指定する必要があります。つまり、次の例で示しているように、アプリケーションのweb.xmlファイルに、auth-methodとしてCLIENT-CERTを指定する必要があります。

<login-config>
<auth-method>CLIENT-CERT,FORM</auth-method>

WebLogicでは、カンマ区切りの認証方式を指定できます。この例では、SSOアサーション(CLIENT-CERT)を使用できない場合、アプリケーションではFORMベースの認証が使用されます。

34.2.2 JSESSIONIDのCookieパスの設定

SSOの設定では、アプリケーションのCookieパスを設定するようお薦めします。WLSでこれを行うには、weblogic.xmlファイルを編集し、次のエントリを追加します。

<session-descriptor>
<cookie-path>/customportal</cookie-path>
</session-descriptor>

customportalは、アプリケーションのコンテキスト・ルートです。

34.2.3 アプリケーションの公開URIおよび保護対象URIの指定

SSO構成では、アプリケーションの公開URIおよび保護対象URIを指定します。SSOソリューションによっては、OSSOやSAML SSOのように、保護対象URIの指定のみが必要です。次のリストは、Portal Frameworkアプリケーションに使用される一般的な保護対象URIおよび公開URIを示しています。

公開URI

/<app-context-root>

保護対象URI

/<app-context-root>/adfAuthentication

使用しているアプリケーションの保護対象URIは、次の例に示しているように、web.xmlファイルのsecurity-constraintノードを確認することによって決定できます。

<security-constraint>
<web-resource-collection>
<web-resource-name>adfAuthentication</web-resource-name>
<url-pattern>/adfAuthentication</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>valid-users</role-name>
</auth-constraint>
</security-constraint>

security-constraintノード内のエントリは常に、アプリケーションのコンテキスト・ルートに相対的です。この例では、このセキュリティ制約は/app-context-root/adfAuthenticationであると解釈できます。別のセキュリティ制約が指定されている場合、たとえば/adminが指定されているとすると、/app-context-root/adminであると解釈できます。

34.2.4 埋込みログインの意味

Portal Frameworkアプリケーションでは通常、ログイン・ページがweb.xml構成ファイルのlogin-configセクションで構成されるformベースのログイン・メカニズムが使用されます(個別のログイン構成ファイルはありません)。アプリケーションで、ページ・テンプレートにログイン領域を埋め込むことや、ランディング・ページを作成することもできます。この場合は通常、ユーザーの資格証明が、認証のためにj_security_checkに送信されます。ただし、SSOの場合、認証はSSOログイン・チャレンジを通して実行する必要があります。

34.2.5 ログアウトの処理

すべてのSSOソリューションに対して、ログアウトを処理するためのADF認証サーブレットが用意されています。使用しているアプリケーションのログアウトで、ADF認証サーブレットがログアウト用に呼び出されるようにする必要があります。これを実行するには、次の例で示しているように、使用しているアプリケーションのfaces-config.xmlファイルで、正常なログアウトのナビゲーション・ルールを変更する必要があります。

<navigation-case>
<from-outcome>logout_success</from-outcome>
<to-view-id>/adfAuthentication?logout=true&amp;end_url=/</to-view-id>
<redirect/>
</navigation-case>

/adfAuthenticationのend_urlパラメータは、正常なログアウト後にユーザーをダイレクトする宛先の任意のURLに指定できます。たとえば、/を指定すると、ユーザーはアプリケーションのデフォルトのページにダイレクトされます。

34.3 Web層の構成

エンタープライズ・アプリケーションのフロントエンド処理を行うWeb層が環境に含まれる場合、SSO向けにそのWeb層を構成する必要があります。Web層は、OAMソリューションおよびOSSOソリューションに必要で、Content Serverが関連する場合にはSAML SSOソリューションで使用されます。

1. 次の例で示しているように、mod_wl_ohs.confにアプリケーションのマッピングを追加します。

<Location /customportal>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8888
</Location>

customportalは、アプリケーションのコンテキスト・ルートです。または、次の例のように、

<IfModule mod_weblogic.c>
MatchExpression /webcenter
WebLogicHost=<Host_Name>|WebLogicPort=<Port>
</IfModule>

<Host_Name>と<Port>は、ホスト・サーバーのホストIDとポート番号です。例:

<IfModule mod_weblogic.c>
MatchExpression /webcenter WebLogicHost=example.com|WebLogicPort=12345
</IfModule>

2. Oracle HTTP Serverを再起動します。

34.4 OAMに対するPortal Frameworkアプリケーションおよびポートレット・プロデューサ・アプリケーションの構成

この項では、OAM 10gおよび11gに対して、Frameworkアプリケーションまたはポートレット・プロデューサ・アプリケーションを構成する方法を説明します。この項の手順を実行する前に、第33.2項「Oracle Access Manager (OAM)の構成」の手順をすでに実行して、WebCenter Portalおよび関連アプリケーションに対してSSOを設定しておく必要があります。また、第34.2項「シングル・サインオンの前提条件」の構成も完了しておく必要があります。

注意:
開始する前に、Portal Frameworkアプリケーションのデプロイ先のドメイン内でOAMによって使用されているアイデンティティ・ストアのLDAPをポイントするように、必須のOAMアサータおよびオーセンティケータを構成しておく必要があります。これをまだ実行していない場合は、開始する前に、第33.2項「Oracle Access Manager (OAM)の構成」の手順を実行してください。

この項には次のサブセクションが含まれます:

- 第34.4.1項「OAM 10gに対するPortal Frameworkアプリケーションの構成」

- 第34.4.2項「OAM 10gに対するポートレット・プロデューサ・アプリケーションの構成」

- 第34.4.3項「OAM 11gに対するPortal Frameworkアプリケーションの構成」

- 第34.4.3項「OAM 11gに対するPortal Frameworkアプリケーションの構成」

34.4.1 OAM 10gに対するPortal Frameworkアプリケーションの構成

この項では、OAM 10gを使用したシングル・サインオン向けにPortal Frameworkアプリケーションを構成する方法を説明します。アプリケーションを構成する前に、第33.2項「Oracle Access Manager (OAM)の構成」の説明に従って、OAMのインストールと構成を完了しておく必要があります。

OAM 10gに対してPortal Frameworkアプリケーションを構成するには:

1. ブラウザを使用してOAMコンソールにログインし、次の場所に移動します。
http://host:port/access/oblix

2. 「ポリシー・マネージャ」をクリックします。

3. WebCenter Portalリソースを保護するために作成したポリシー・ドメインを見つけます。

4. 「リソース」タブを開き、「追加」をクリックします。

5. リソースを追加します。各リソースに対して、次の手順を実行します。

1. 「リソース・タイプ」としてHTTPを選択します。

2. WebCenter Portal Web層のホストIDを選択します。

3. アプリケーションのURL接頭辞(/<app-context-root>)を入力します。

4. リソースの説明を入力します。

5. 「キャッシュの更新」が選択されていることを確認して、「保存」をクリックします。

6. 手順5を繰り返して、リソースとして/<app-context-root>/adfAuthenticationを追加します。

7. 「ポリシー」タブに移動して、パブリック・ポリシーを見つけます。

8. パブリック・ポリシーを開いて、手順5で作成したリソース(/<app-context-root>)を選択します。

9. 変更を保存します。

10. Web層を再起動し、変更をテストします。

34.4.2 OAM 10gに対するポートレット・プロデューサ・アプリケーションの構成

この項では、OAM 10gを使用したシングル・サインオン向けにポートレット・プロデューサ・アプリケーションを構成する方法を説明します。ポートレット・プロデューサ・アプリケーションを構成する前に、第34.4.1項「OAM 10gに対するPortal Frameworkアプリケーションの構成」の手順を実行してから、次の手順を実行してください。

OAM 10gに対してポートレット・プロデューサ・アプリケーションを構成するには:

1. ブラウザを使用してOAMコンソールにログインし、次の場所に移動します。
http://host:port/access/oblix

2. 「ポリシー・マネージャ」をクリックします。

3. WebCenter Portalリソースを保護するために作成したポリシー・ドメインを見つけます。

4. 「リソース」タブを開き、「追加」をクリックします。

5. 「リソース・タイプ」としてHTTPを選択します。

6. WebCenter Portal Web層のホストIDを選択します。

7. アプリケーションのURL接頭辞(/<app-context-root/portlets>)を入力します。

8. リソースの説明を入力します。

9. 「キャッシュの更新」が選択されていることを確認して、「保存」をクリックします。

10. 「ポリシー」タブに移動して、除外スキーム・ポリシーを見つけ、このポリシーに対して、新規作成したポートレット・プロデューサ・リソースを選択します。

11. このポリシーを開いて、手順5で作成したリソース(/<app-context-root>/portlets)を選択します。

12. 変更を保存します。

13. 「リソース」タブを開き、「追加」をクリックします。

14. 「リソース・タイプ」としてHTTPを選択します。

15. WebCenter Portal Web層のホストIDを選択します。

16. アプリケーションのURL接頭辞(/<app-context-root/monitor>)を入力します。

17. リソースの説明を入力します。

18. 「キャッシュの更新」が選択されていることを確認して、「保存」をクリックします。

19. 変更を保存します。デフォルトでは保護されたポリシーに含まれます。

20. Web層を再起動し、変更をテストします。

34.4.3 OAM 11gに対するPortal Frameworkアプリケーションの構成

この項では、OAM 11gを使用したシングル・サインオン向けにPortal Frameworkアプリケーションを構成する方法を説明します。アプリケーションを構成する前に、第33.2項「Oracle Access Manager (OAM)の構成」の説明に従って、OAMのインストールと構成を完了しておく必要があります。

OAM 11gに対してPortal Frameworkアプリケーションを構成するには:

1. ブラウザを使用してOAMコンソールにログインし、次の場所に移動します。
http://host:port/oamconsole

2. 「ポリシー構成」→「アプリケーション・ドメイン」に移動します。
「ポリシー・マネージャ」ペインが表示されます。

3. WebGateエージェントの登録で使用した名前を使用して作成したアプリケーション・ドメインを見つけます。

4. 「リソース」タブを開き、「新規リソース」をクリックします。

5. Portal Frameworkアプリケーションのリソースを追加します。各リソースに対して、次の手順を実行します。

1. 「リソース・タイプ」としてHTTPを選択します。

2. WebGateエージェントの登録時に作成されたホストIDを選択します。

3. アプリケーションのリソースURL(/<app-context-root>*)を入力します。

4. リソースの説明を入力します。

5. 「保護レベル」をUnprotectedに設定します。

6. 「認証ポリシー」をPublic Resource Policyに設定します。

7. 「認可ポリシー」をProtected Resource Policyに設定します。

8. 「適用」をクリックします。

6. 手順5を繰り返して、リソースとして/<app-context-root>/.../*を追加します。

7. リソースとして/<app-context-root>/adfAuthentication*を追加します。

1. 「リソース・タイプ」としてHTTPを選択します。

2. WebGateエージェントの登録時に作成されたホストIDを選択します。

3. アプリケーションのリソースURL(/<app-context-root>/adfAuthentication*)を入力します。

4. リソースの説明を入力します。

5. 「保護レベル」をProtectedに設定します。

6. 「認証ポリシー」をProtected Resource Policyに設定します。

7. 「認可ポリシー」をProtected Resource Policyに設定します。

8. 「適用」をクリックします。

8. リソースとして/<app-contextroot>/monitor*を追加します。

1. 「リソース・タイプ」としてHTTPを選択します。

2. WebGateエージェントの登録時に作成されたホストIDを選択します。

3. アプリケーションのリソースURL (/<app-contextroot>/monitor*)を入力します。

4. リソースの説明を入力します。

5. 「保護レベル」をProtectedに設定します。

6. 「認証ポリシー」をProtected Resource Policyに設定します。

7. 「認可ポリシー」をProtected Resource Policyに設定します。

8. 「適用」をクリックします。

9. リソースとして/<app-contextroot>/monitor/.../*を追加します。

1. 「リソース・タイプ」としてHTTPを選択します。

2. WebGateエージェントの登録時に作成されたホストIDを選択します。

3. アプリケーションのリソースURL (/<app-contextroot>/monitor/.../*)を入力します。

4. リソースの説明を入力します。

5. 「保護レベル」をProtectedに設定します。

6. 「認証ポリシー」をProtected Resource Policyに設定します。

7. 「認可ポリシー」をProtected Resource Policyに設定します。

8. 「適用」をクリックします。

10. Web層を再起動し、変更をテストします。

34.4.4 OAM 11gに対するポートレット・プロデューサ・アプリケーションの構成

この項では、OAM 11gを使用したシングル・サインオン向けにポートレット・プロデューサ・アプリケーションを構成する方法を説明します。ポートレット・プロデューサ・アプリケーションを構成する前に、第34.4.3項「OAM 11gに対するPortal Frameworkアプリケーションの構成」の手順を実行してから、次の手順を実行してください。

OAM 11gに対してポートレット・プロデューサ・アプリケーションを構成するには:

1. ブラウザを使用してOAMコンソールにログインし、次の場所に移動します。
http://host:port/access/oblix

2. 「ポリシー・マネージャ」をクリックします。

3. WebCenter Portalリソースを保護するために作成したポリシー・ドメインを見つけます。

4. 「リソース」タブを開き、「追加」をクリックします。

5. 「リソース・タイプ」としてHTTPを選択します。

6. WebGateエージェントの登録時に作成されたホストIDを選択します。

7. アプリケーションのURL接頭辞(/<app-contextroot>/portlets/.../*)を入力します。

8. リソースの説明を入力します。

9. 「保護レベル」をExcludedに設定して、「保存」をクリックします。

10. Web層を再起動し、変更をテストします。

34.5 OSSOに対するPortal Frameworkアプリケーションの構成

この項では、Portal FrameworkアプリケーションをOSSO向けに構成する方法を説明します。この項の手順を実行する前に、第33.3項「Oracle Single Sign-On (OSSO)の構成」の手順をすでに実行して、WebCenter Portalおよび関連アプリケーションに対してSSOを設定しておく必要があります。また、第34.2項「シングル・サインオンの前提条件」の構成も完了しておく必要があります。

注意:
開始する前に、Portal Frameworkアプリケーションのデプロイ先のドメイン内でOSSOによって使用されているアイデンティティ・ストア(OID)をポイントするように、必須のOSSOアサータおよびオーセンティケータを構成しておく必要があります。これをまだ実行していない場合は、開始する前に、第33.3項「Oracle Single Sign-On (OSSO)の構成」の手順を実行してください。

OSSOに対してPortal Frameworkアプリケーションを構成するには:

1. OHS内でmod_osso.confファイルを見つけ、これを開きます。

2. Portal Frameworkアプリケーションの次のエントリを他の同様のエントリに追加します。

<Location /<app-context-root>/adfAuthentication>
OssoSendCacheHeaders off
require valid-user
AuthType Osso
</Location>

3. OHSを再起動します。

34.6 SAML SSOに対するPortal Frameworkアプリケーションの構成

この項では、Portal FrameworkアプリケーションにSAML SSOを設定する方法を説明します。SAMLシングル・サインオンは、エンタープライズSSOソリューションを使用できない小規模の環境(たとえば、部門)に対してのみ推奨されます。

手順は次の2つのシナリオに分かれます。

- シナリオ1: 宛先アプリケーションとしてのPortal Frameworkアプリケーション
これは、WebCenter Portal SAML SSOスクリプトで指定されるデフォルトのSAML SSO動作で、ここではWebCenter Portalがソース・アプリケーションで、その他すべてのアプリケーションが宛先アプリケーションです(つまり、シングル・サインオンで他の宛先アプリケーションを動作させるには、WebCenter Portalにログインする必要があります)。

- シナリオ2: ソース・アプリケーションとしてのPortal Frameworkアプリケーション
この動作は、WebCenter Portal SAML SSOスクリプトではサポートされていないため、手動の構成が必要です。このシナリオでは、Portal FrameworkアプリケーションをSAMLソースとして動作させ、その他のアプリケーション(WebCenter Portalを含む)を宛先アプリケーションとして動作させます(つまり、Portal Frameworkアプリケーションが最初のアクセス・ポイントであり、シングル・サインオンでその他の宛先アプリケーションを動作させるためにそのPortal Frameworkアプリケーションにログインする必要があります)。

SAMLをPortal Frameworkアプリケーションに構成するこれら2つの方法については、次の各項で説明しています。

- 第34.6.1項「宛先のPortal FrameworkアプリケーションへのSAML SSOの構成」

- 第34.6.2項「ソースのPortal FrameworkアプリケーションへのSAML SSOの構成」

34.6.1 宛先のPortal FrameworkアプリケーションへのSAML SSOの構成

この項の手順を実行する前に、WebCenter Portalおよび関連アプリケーションに対してSSOを設定する方法を説明している第33.4項「SAMLベースのシングル・サインオンの構成」の前提条件と手順をすでに完了しておく必要があります。この項で示す手順によって、その設定にPortal Frameworkアプリケーションの構成手順が追加されます。

このシナリオでは、WebCenter Portalはソース・アプリケーションとして動作を続け、シングル・サインオンに宛先アプリケーションとして含まれる新規Portal Frameworkアプリケーションと連動します(つまり、WebCenter Portalにログインした場合にPortal Frameworkアプリケーションのいずれかの保護対象URIにアクセスすると、自動的にログインされます)。WebCenter Portalにまだログインしていないときに保護対象URIにアクセスすると、WebCenter Portalのログイン・ページにダイレクトされた後に、アプリケーションのセキュアなページにリダイレクトされて戻ります。

次の手順では、次のことが前提となっています。

- Portal Frameworkアプリケーションが、configureSpaces.pyスクリプトが実行されたWebCenter Portalドメインにデプロイされている。Portal Frameworkアプリケーションがこれとは別のドメインにある場合は、WLS管理コンソール(「セキュリティ・レルム」→「プロバイダ」→「オーセンティケータ」)でSAMLIdentityAsserterV2 IDアサータを作成し、WLSを再起動します。その上で、SAML SSOの設定で使用した証明書をエクスポートし、作成したSAMLアイデンティティ・アサータの下にその証明書を登録する必要があります。

- 後述の手順および例のパラメータ値では、demoidentity証明書を使用していることが前提となっている。これとは別の証明書を使用している場合は、必要に応じて証明書の名前を変更します。

- Web層が構成に含まれる場合は、ホストIDおよびポートIDは、Web層のホストIDとポートIDである。

この項には次のサブセクションが含まれます:

- 第34.6.1.1項「宛先サイトの有効化」

- 第34.6.1.2項「リライイング・パーティの構成」

- 第34.6.1.3項「アサーティング・パーティの構成」

34.6.1.1 宛先サイトの有効化

Portal Frameworkアプリケーションの宛先サイトを有効にする手順は次のとおりです。

1. WebCenter PortalドメインのWLS管理コンソールにログオンします。

2. 「サーバー」→[ポータル・アプリケーションをホストしているサーバー]→「構成」→「フェデレーション・サービス」→「SAML 1.1宛先サイト」を選択します。

3. 表34-1に示すように、宛先サイトのパラメータを入力します。

表34-1 宛先サイトのパラメータ

パラメータ

値

説明

宛先サイトの有効化

選択

宛先サイトを有効にするかどうかを指定します。

ACSでSSLが必要

選択解除

アサーション・コンシューマ・サービスでSSLを必要とするかどうかを指定します。選択した場合は、資格証明マッパーのリライイング・パーティに指定されたACS URLで、HTTPSおよびターゲット・サーバーのSSLポートが必ず使用されるようにします。

アサーション・コンシューマのURI

/<app-context-root>/samlacs/acs

(新しく追加し、他の部分はそのまま)

アサーション・コンシューマのURI。ここでは、同じログインCookieが使用されるように、ターゲット・アプリケーション内に存在するACSを選択しています。

POST受信者チェックの有効化

選択

POST受信者のチェックが有効化されるかどうかを指定します。trueに設定されている場合、SAMLレスポンスの受信者は、HTTPリクエストのURLと一致している必要があります。

POST使用済みチェックの有効化

選択

POSTの使用を1回にするチェックが有効化されるかどうかを指定します。

4. 変更を保存し、他の部分はデフォルト値のままにします。

5. Portal Frameworkアプリケーションをホストしているサーバーを再起動します。

34.6.1.2 リライイング・パーティの構成

Portal Frameworkアプリケーションにリライイング・パーティを構成するには:

1. WebCenter PortalドメインのWLS管理コンソールにログオンします。

2. 「セキュリティ・レルム」→「プロバイダ」→「資格証明マッピング」→「wcsamlcm」→「管理」→「リライイング・パーティ」を選択します。

3. 表34-2のパラメータを使用して、新規リライイング・パーティを作成します。

表34-2 リライイング・パーティのパラメータ

パラメータ

値

説明

プロファイル

Browser/POST

このSAMLリライイング・パーティが使用するSAMLプロファイル。

有効

選択

このSAMLリライイング・パーティの状態。

説明

Portal Frameworkアプリケーション

このリライイング・パーティの簡単な説明。

ターゲットURL

http://host:port/<app-context-root>

認証がリクエストされた宛先サイトのURL。

アサーション・コンシューマのURL

http://host:port/<app-context-root>/samlacs/acs

このSAMLリライイング・パーティのアサーション・コンシューマ・サービスに接続するURL。アサーションまたはアーティファクトのPOST実行先またはリダイレクト先のURLを示します。

注意: 宛先サイトのフェデレーション・サービスの構成時にACSにSSLが必要であることを選択した場合は、HTTPSプロトコルおよび管理対象サーバーのSSLポートを使用します。

アサーション・コンシューマのプロパティ

APID=ap_0000X

Xは、次の手順で作成するアサーティング・パーティのIDを示します。

アサーションの署名

選択

このSAMLリライイング・パーティで生成されるアサーションに署名するかどうかを指定します。

Keyinfoを含める

選択

アサーションの署名時に、署名用証明書を含む<ds:keyinfo>要素を含めるかどうかを示します。デフォルト値はtrueです。「アサーションの署名」がfalseの場合、この値は無視されます。

4. 変更を保存し、他の部分はデフォルト値のままにします。

34.6.1.3 アサーティング・パーティの構成

Portal Frameworkアプリケーションにアサーティング・パーティを構成するには:

1. WebCenter PortalドメインのWLS管理コンソールにログオンします。

2. 「セキュリティ・レルム」→「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」を選択します。

3. 表34-3のパラメータを使用して、新規アサーティング・パーティを作成します。

表34-3 アサーティング・パーティのパラメータ

パラメータ

値

説明

プロファイル

Browser/POST

このパートナとともに使用されるSAMLプロファイル。

有効

選択

SAMLアサーションの取得にこのアサーティング・パーティを使用できるかどうかを指定します。

説明

WebCenter Portal

このアサーティング・パーティの簡単な説明。

ターゲットURL

http://host:port/webcenter

このSAMLアサーティング・パーティのターゲットURL。

POST署名用証明書別名

demoidentity

このアサーティング・パーティからのSAMLプロトコル要素の署名を検証する、信頼性のある証明書の別名。Browser/POSTプロファイルに設定する必要があります。

ソース・サイトのリダイレクトURI

/<app-context-root>/adfAuthentication

未認証ユーザーを構成済のITS URLにリダイレクトするためのオプションのURIセット。これを設定した場合、サイト間転送URLも設定する必要があります。

注意: この設定により、宛先サイトに先にアクセスすると、構成されているITS URL(この場合はソース・アプリケーション内)にリダイレクトされ、セッションがソース・アプリケーションに対して確立されてから、宛先サイトにリダイレクトされます。

ソース・サイトITS URL

http://host:port/webcenter/samlits/its

このアサーティング・パーティのSAMLソース・サイトのサイト間転送サービス(ITS)URL。宛先サイトが最初のアクセス・ポイントになるシナリオをサポートするために、このURLはSSOプロファイルとともにのみ使用するようにしてください。そうすることで、認証前に宛先サイトのURLにアクセスしようとするユーザーは、認証を受けてSAMLアサーションを取得するためにソース・サイトにリダイレクトされます。ソースサイトのリダイレクトが機能するためには、「リダイレクトURI」属性も構成する必要があります。

注意: ソース・サイト・フェデレーション・サービスで「ITSでSSLが必要」を選択した場合、ソース・サイトITS URLを、HTTPSとサーバーのSSLポートを使用するように変更する必要があります。

ソース・サイトのITSパラメータ

RPID=rp_0000X

Xを、前もって作成したリライイング・パーティのIDに置き換えます。

発行者URI

http://www.oracle.com/webcenter

このSAMLアサーティング・パーティのアサーションを発行するSAMLオーソリティの発行者URI。

署名が必要

選択

trueの場合、アサーションは署名される必要があります。falseの場合、署名要素は必須ではありません。ただし、署名要素を指定した場合は検証されます。

アサーション署名用証明書別名

demoidentity

4. 変更を保存し、他の部分はデフォルト値のままにします。

5. シングル・サインオンが予期したとおりに動作することをテストして続行します。

34.6.2 ソースのPortal FrameworkアプリケーションへのSAML SSOの構成

このシナリオでは、Portal Frameworkアプリケーションは、ソース・アプリケーションとして機能して、その他のアプリケーション(WebCenter Portalなど)は宛先として機能します。Content Serverを組み込む構成を行うには、この項で説明する構成を実行する前に、第33.4.2.1.1項「SAML SSO用のContent Serverの構成」の関連手順を実行しておく必要があります。

次の手順では、次の前提が基になっています。

- WebCenter Portal SAML SSOスクリプトは実行されていない。このスクリプトによって、WebCenter Portalがソース・アプリケーションとして機能するよう構成されるため、次の手順を手動で実行する必要があります。

- デフォルトのdemoidentity証明書を使用しており、Portal Frameworkアプリケーションをホストしているドメインからこの証明書をすでにdemoidentity.derにエクスポートした。

- Portal Frameworkアプリケーションは、/customportalである。

- Content Serverを組み込む構成であり、Web層が構成に含まれる場合は、ホストIDおよびポートIDは、Web層のホストIDとポートIDである。

この項には次のサブセクションが含まれます:

- 第34.6.2.1項「SAML ITSの保護」

- 第34.6.2.2項「JSESSIONIDのCookieパスの設定」

- 第34.6.2.3項「SSOプロパティのTrueとしての設定」

- 第34.6.2.4項「SAML資格証明マッピング・プロバイダの構成」

- 第34.6.2.5項「リライイング・パーティの構成」

- 第34.6.2.6項「ソース・サイトのフェデレーション・サービスの構成」

- 第34.6.2.7項「SAMLアイデンティティ・アサーション・プロバイダの構成」

- 第34.6.2.8項「宛先サイトのフェデレーション・サービスの構成」

- 第34.6.2.9項「その他の宛先アプリケーションの構成」

34.6.2.1 SAML ITSの保護

Portal Frameworkアプリケーションのweb.xmlファイルで、/adfAuthenticationを保護するためのエントリの後に次のエントリを追加します。

<security-constraint>
<web-resource-collection>
<web-resource-name>samlits</web-resource-name>
<url-pattern>/samlits/its</url-pattern>
</web-resource-collection>
<auth-constraint>
<role-name>valid-users</role-name>
</auth-constraint>
</security-constraint>

34.6.2.2 JSESSIONIDのCookieパスの設定

SSOの設定では、アプリケーションのコンテキスト・ルートへのCookieパスを設定するようお薦めします。WLSでこれを行うには、weblogic.xmlファイルを編集し、次のエントリを追加します。

<session-descriptor>
<cookie-path>/customportal</cookie-path>
</session-descriptor>

customportalは、アプリケーションのコンテキスト・ルートです。

34.6.2.3 SSOプロパティのTrueとしての設定

ここではWebCenter Portalアプリケーションは宛先アプリケーションとして機能するため、WebCenter Portalのランディング・ページ上のログイン領域を非表示にする必要があります。これを実行するには、setDomainEnvファイルに次のプロパティを設定し、変更が適用されるようにWC_Spacesサーバーを再起動します。

EXTRA_JAVA_PROPERTIES="-Doracle.webcenter.spaces.osso=true ${EXTRA_JAVA_PROPERTIES}"
export EXTRA_JAVA_PROPERTIES

34.6.2.4 SAML資格証明マッピング・プロバイダの構成

Portal Frameworkアプリケーションをホストしているドメインのセキュリティ・レルムで、SAML資格証明プロバイダV2 (SAMLCredentialMapperV2)インスタンスを作成します。SAML資格証明マッピング・プロバイダは、デフォルトのセキュリティ・レルムには含まれません。表34-4で示している「発行者URI」、「名前修飾子」およびその他の属性を使用して、SAML資格証明マッピング・プロバイダをSAML認証局として構成します。

表34-4 SAML資格証明マッピング・プロバイダのパラメータ

パラメータ

値

説明

発行者URI

http://www.oracle.com/webcenter

対象のSAML認証局の発行者URI(名前)。この一意のURIは、宛先サイト(owc_wiki)にSAMLメッセージの発信元を示し、キーと照合できるようにします。通常、一意性を保証するためにURLが使用されます。

名前修飾子

oracle.com

名前マッパーで使用される名前修飾子の値。名前修飾子の値は、サブジェクトの名前を修飾するセキュリティ・ドメインまたは管理ドメインです。これによって、サブジェクト名の衝突を回避しながら、異種のユーザー・ストアから名前のフェデレーションを実行できるようになります。

署名鍵別名

demoidentity

キーストアから、アサーションの署名に使用するキーを取得するときに使用される別名。

署名鍵パスフレーズ

DemoIdentityPassPhrase

キーストアから、アサーションの署名に使用するキーを取得するときに使用される資格証明(パスワード)。

変更を保存し、その他のパラメータについてはデフォルト値を受け入れて、WLSのすべてを再起動します。

34.6.2.5 リライイング・パーティの構成

宛先アプリケーションごとにリライイング・パーティの構成が必要になります。次の手順は、WebCenter Portalを例として使用して、この構成を行う方法を示しています。その他のアプリケーションについては、第34.6.2.9項「その他の宛先アプリケーションの構成」の表34-10を参照し、次の手順を参照として使用して、強調表示されている値を適宜変更してください。

WebCenter Portalにリライイング・パーティを構成するには:

1. WebCenter PortalドメインのWLS管理コンソールにログオンします。

2. 「セキュリティ・レルム」→レルム名→「プロバイダ」→「資格証明マッピング」→SAML資格証明マッパー名→「管理」→「リライイング・パーティ」を選択します。

3. 表34-5のパラメータを使用して、新規リライイング・パーティを作成します。

表34-5 WebCenter Portalの場合のリライイング・パーティのパラメータ

パラメータ

値

説明

プロファイル

Browser/POST

このSAMLリライイング・パーティが使用するSAMLプロファイル。

有効

選択

このSAMLリライイング・パーティの状態。

説明

WebCenter Portal

このリライイング・パーティの簡単な説明。

ターゲットURL

http://host:port/webcenter

認証がリクエストされた宛先サイトのURL。

アサーション・コンシューマのURL

http://host:port/webcenter/samlacs/acs

このSAMLリライイング・パーティのアサーション・コンシューマ・サービスに接続するURL。アサーションまたはアーティファクトのPOST実行先またはリダイレクト先のURLを示します。

注意: 宛先サイトのフェデレーション・サービスの構成時にACSにSSLが必要であることを選択した場合は、HTTPSプロトコルおよび管理対象サーバーのSSLポートを使用します。

アサーション・コンシューマのプロパティ

APID=ap_00001

1つ以上のオプションの問合せパラメータ(name=valueの形式)であり、宛先サイトへのリダイレクト時にACS URLに追加されます。

POSTプロファイルの場合、これらのパラメータはデフォルトのPOSTフォームの使用時にフォーム変数として追加されます。ここで、ap_00001はPortal Frameworkアプリケーション(customportal)のアサーティング・パーティのIDを示しています。これは後で、Portal FrameworkアプリケーションをホストしているドメインのSAMLアイデンティティ・アサータで構成します。これによってソース・サイトおよびITS詳細が指定されます。

アサーションの署名

選択

このSAMLリライイング・パーティで生成されるアサーションに署名するかどうかを指定します。

Keyinfoを含める

選択

アサーションの署名時に、署名用証明書を含む<ds:keyinfo>要素を含めるかどうかを示します。デフォルト値はtrueです。「アサーションの署名」がfalseの場合、この値は無視されます。

4. 変更を保存し、他の部分はデフォルト値のままにします。

34.6.2.6 ソース・サイトのフェデレーション・サービスの構成

ソース・サイトのフェデレーションを構成するには:

1. WebCenter PortalドメインのWLS管理コンソールにログオンします。

2. 「環境」→「サーバー」→カスタム・ポータルをホストしているサーバー→「構成」→「フェデレーション・サービス」→「SAML 1.1ソースサイト」を選択します。

3. 表34-6に示すように、SAMLソース・サイトの属性を構成します。

表34-6 ソース・サイトのフェデレーション・サービスのパラメータ

パラメータ

値

説明

ソース・サイトの有効化

選択

「ソース・サイトの有効化」をtrueに設定すると、WebLogicサーバー・インスタンスがSAMLソース・サイトとして機能できるようになります。

ソース・サイトURL

http://host:port/customportal

SAMLソース・サイトのURLを設定します。これは、サイト間転送サービスおよびアサーション取得サービスをホストするURLです。ソース・サイトのURLは、ソースIDとして16進数およびBase64でエンコードされます。

署名鍵別名

demoidentity

SAMLソース・サイトは、アサーションに署名する信頼できる証明書を要求します。この証明書をキーストアに追加し、証明書へのアクセスに使用する資格証明(別名とパスフレーズ)を入力します。署名別名およびパスフレーズが指定されない場合、サーバーのSSL IDキー/証明書がデフォルトで使用されます。

署名鍵パスフレーズ

DemoIdentityPassPhrase

SAMLソース・サイトは、アサーションに署名する信頼できる証明書を要求します。この証明書をキーストアに追加し、証明書へのアクセスに使用する資格証明(別名とパスフレーズ)を入力します。署名別名およびパスフレーズが指定されない場合、サーバーのSSL IDキー/証明書がデフォルトで使用されます。

サイト間転送URI

/customportal/samlits/its

(新しく追加し、他の部分はそのまま。)

サイト間転送サービスおよび(Browser/Artifactプロファイルをサポートするための)アサーション取得サービスのURIを指定します。これらのURIは、アサーティング・パーティの構成でも指定されます。

アサーション取得用URI

/customportal/samars/ars

(新しく追加し、他の部分はそのまま。)

ArtifactプロファイルがRESTに使用されている場合にのみ適用されます。

ITSでSSLが必要

選択解除

これを選択すると、SAMLアイデンティティ・プロバイダのSAMLアサーティング・パーティの構成でHTTPSおよびサーバーのSSLポートとして指定されているソース・サイトのITS URLの変更が必要になります。

ARSでSSLが必要

選択解除

Artifactプロファイルが使用されている場合にのみ適用されます。

4. 変更を保存し、他の部分はデフォルト値のままにします。

5. Portal Frameworkアプリケーションをホストしているサーバーを再起動します。

34.6.2.7 SAMLアイデンティティ・アサーション・プロバイダの構成

SAMLアイデンティティ・アサーション・プロバイダを構成するには:

1. WebCenter PortalドメインのWLS管理コンソールにログオンします。

2. 第34.6.1.3項「アサーティング・パーティの構成」で説明されているとおりに、SAMLアイデンティティ・アサーション・プロバイダV2インスタンスを作成します。このとき、変更の保存後にWLSのすべてを再起動します。

3. WLS管理コンソールにログインして戻り、「セキュリティ・レルム」→レルム名→「プロバイダ」→「認証」→SAMLIdentityAsserterName→「管理」→「証明書」に移動します。

4. SAMLアイデンティティ・アサータに証明書を構成します。

5. 表34-7に示した値を使用して、SAMLアイデンティティ・アサータに証明書を構成します。

表34-7 アイデンティティ・アサータの証明書のパラメータ

パラメータ

値

説明

別名

demoidentity

新規証明書に割り当てる名前。

パス

WEBLOGIC_HOME/server/lib/demoidentity.der

インポートするX509証明書が含まれる.pemファイルまたは.derファイルのパス名を指定します。

6. 「セキュリティ・レルム」→レルム名→「プロバイダ」→「認証」→SAMLIdentityAsserterName→「管理」→「アサーティング・パーティ」に移動します。

7. 表34-8のパラメータを使用して、新規アサーティング・パーティを作成します。第34.6.2.5項「リライイング・パーティの構成」で、対応するリライイング・パーティに選択したものと同じプロファイルを使用します。

表34-8 アサーティング・パーティのパラメータ

パラメータ

値

説明

プロファイル

Browser/POST

このパートナとともに使用されるSAMLプロファイル。

有効

選択

SAMLアサーションの取得にこのアサーティング・パーティを使用できるかどうかを指定します。

説明

WebCenter Portal用のPortal Frameworkアプリケーション

このアサーティング・パーティの簡単な説明。

ターゲットURL

http://host:port/customportal

このSAMLアサーティング・パーティのターゲットURL。

POST署名用証明書別名

demoidentity

このアサーティング・パーティからのSAMLプロトコル要素の署名を検証する、信頼性のある証明書の別名。Browser/POSTプロファイルに設定する必要があります。

ソース・サイトのリダイレクトURI

/webcenter/adfAuthentication

未認証ユーザーを構成済のITS URLにリダイレクトするためのオプションのURIセット。これを設定した場合、サイト間転送URLも設定する必要があります。

注意: この設定により、宛先サイトに先にアクセスすると、構成されているITS URL(この場合はソース・アプリケーション内)にリダイレクトされ、セッションがソース・アプリケーションに対して確立されてから、宛先サイトにリダイレクトされます。

ソース・サイトITS URL

http://host:port/customportal/samlits/its T

このアサーティング・パーティのSAMLソース・サイトのサイト間転送サービス(ITS)URL。宛先サイトが最初のアクセス・ポイントになるシナリオをサポートするために、このURLはSSOプロファイルとともにのみ使用するようにしてください。そうすることで、認証前に宛先サイトのURLにアクセスしようとするユーザーは、認証を受けてSAMLアサーションを取得するためにソース・サイトにリダイレクトされます。ソースサイトのリダイレクトが機能するためには、「リダイレクトURI」属性も構成する必要があります。

注意: ソース・サイト・フェデレーション・サービスで「ITSでSSLが必要」を選択した場合、ソース・サイトITS URLを、HTTPSとサーバーのSSLポートを使用するように変更する必要があります。

ソース・サイトのITSパラメータ

RPID=rp_00001

オプションの、0個以上の問合せパラメータ(name=valueの形式)であり、ソース・サイトへのリダイレクト時にITS URLに追加されます。ここでは、rp_00001は、宛先サイトの詳細を指定する、Portal FrameworkアプリケーションのWLSドメインのSAML資格証明マッピング・プロバイダに指定されている、WebCenter Portalのリライイング・パーティIDです。

発行者URI

http://www.oracle.com/webcenter

このSAMLアサーティング・パーティのアサーションを発行するSAMLオーソリティの発行者URI。

署名が必要

選択

trueの場合、アサーションは署名される必要があります。falseの場合、署名要素は必須ではありません。ただし、署名要素を指定した場合は検証されます。

アサーション署名用証明書別名

demoidentity

対象のアサーティング・パーティからのアサーションの署名を確認するための信頼できる証明書の別名です。これは、「署名が必要」がtrueの場合に設定する必要があります。この証明書を、SAMLアイデンティティ・アサータの証明書レジストリに登録することも必要です。

8. 変更を保存し、他の部分はデフォルト値のままにします。

34.6.2.8 宛先サイトのフェデレーション・サービスの構成

宛先サイトのフェデレーション・サービスを構成するには:

1. WLS管理コンソールから、「WCドメイン」→「WC_Spaces」→「構成」→「フェデレーション・サービス」→「SAML 1.1宛先サイト」に移動します。[Spaces]

2. 表34-9の値を使用して、SAML宛先サイトの属性を構成します。

表34-9 宛先サイトのパラメータ

パラメータ

値

説明

宛先サイトの有効化

選択

宛先サイトを有効にするかどうかを指定します。

ACSでSSLが必要

選択解除

アサーション・コンシューマ・サービスでSSLを必要とするかどうかを指定します。選択した場合は、資格証明マッパーのリライイング・パーティに指定されたACS URLで、HTTPSおよびターゲット・サーバーのSSLポートが必ず使用されるようにします。

アサーション・コンシューマのURI

/webcenter/samlacs/acs

/rss/samlacs/acs

/rest/samlacs/acs

(新しく追加し、他の部分はそのまま)

アサーション・コンシューマのURI。ここでは、同じログインCookieが使用されるように、ターゲット・アプリケーション内に存在するACSを選択しています。

POST受信者チェックの有効化

選択

POST受信者のチェックが有効化されるかどうかを指定します。trueに設定されている場合、SAMLレスポンスの受信者は、HTTPリクエストのURLと一致している必要があります。

POST使用済みチェックの有効化

選択

POSTの使用を1回にするチェックが有効化されるかどうかを指定します。

3. 変更を保存し、他の部分はデフォルト値のままにします。

4. WebCenter Portalサーバーを再起動します。

34.6.2.9 その他の宛先アプリケーションの構成

WebCenter Portal以外のアプリケーションをPortal Frameworkアプリケーションの宛先アプリケーションとして機能させる場合は、次の手順を実行します。

1. 宛先アプリケーションをホストする各ドメインに、SAML IDアサータおよび証明書を登録しておきます(第34.6.2.7項「SAMLアイデンティティ・アサーション・プロバイダの構成」の手順1から5を参照してください)。

2. 第34.6.2.5項「リライイング・パーティの構成」でWebCenter Portalに対して実行したように、Portal FrameworkアプリケーションをホストしているWLSドメインで宛先アプリケーションのリライイング・パーティを作成します。 各アプリケーションで該当する値については、表34-10を参照してください。

3. 宛先アプリケーションのWLSドメインで、WebCenter Portalの場合と同様の対応するアサーティング・パーティを作成します。第34.6.2.7項「SAMLアイデンティティ・アサーション・プロバイダの構成」のアサーティング・パーティを作成する手順を使用します。ソース・リダイレクトURIを、宛先アプリケーションのセキュアURIに適切に設定してください。アプリケーションごとの適切な値は、表34-10を参照してください。

4. アサーティング・パーティおよびリライイング・パーティが有効になっており、互いを適切にポイントしていることを確認します。つまり、アサーティング・パーティの「ソース・サイトのITSパラメータ」およびリライイング・パーティの「アサーション・コンシューマのプロパティ」が、互いに適切にポイントしている必要があります。

5. 宛先アプリケーションをホストしているサーバーの宛先サイト・フェデレーション・サービスを有効にして、第34.6.2.8項「宛先サイトのフェデレーション・サービスの構成」でWC_Spacesサーバーに対して実行したことと同じように、/yourdestinationapp/samlacs/acsのエントリを追加しておきます。 各アプリケーションで該当する値については、表34-10を参照してください。

表34-10 WebCenter Portal以外の宛先アプリケーションの設定

宛先アプリケーション

ターゲットURL(リライイング・パーティ)

ACS URL(リライイング・パーティ)

ACS URI(宛先サイトのフェデレーション・サービス)

ソース・リダイレクトURI(アサーティング・パーティ)

RSS

http://host:port/rss

http://host:port/rss/samlacs/acs

/rss/samlacs/acs

/rss/rssservlet

REST

http://host:port/rest

http://host:port/rest/samlacs/acs

/rest/samlacs/acs

/rest/api/resourceIndex

ディスカッション

http://host:port/owc_discussions

http://host:port/owc_discussions/samlacs/acs

/owc_discussions/samlacs/acs

/owc_discussions/admin/forum-main.jsp

/owc_discussions/admin/content-main.jsp

/owc_discussions/login!withRedirect.jspa

/owc_discussions/login!default.jspa

/owc_discussions/login.jspa

アクティビティ・グラフ・エンジン

http://host:port/activitygraph-engines

http://host:port/activitygraph-engines/samlacs/acs

/activitygraph-engines/samlacs/acs

/activitygraph-engines/index.jsp

Content Server

http://host:port

http://host:port/samlacs/acs

/samlacs/acs

/adfAuthentication

ワークリストの詳細

http://host:port/workflow/WebCenterWorklistDetail

http://host:port/workflow/WebCenterWorklistDetail/samlacs/acs

/WebCenterWorklistDetail/samlacs/acs

/workflow/WebCenterWorklistDetail/faces/adf.task-flow

ワークリストのSDP

http://host:port/workflow/sdpmessagingsca-ui-worklist

http://host:port/workflow/sdpmessagingsca-ui-worklist/samlacs/acs

/sdpmessagingsca-ui-worklist/samlacs/acs

/workflow/sdpmessagingsca-ui-worklist/faces/adf.task-flow

ワークリストの統合

http://host:port/integration/worklistapp

http://host:port/integration/worklistapp/samlacs/acs

/worklistapp/samlacs/acs

/integration/worklistapp/ssologin

/integration/worklistapp/faces/home.jspx

35 SSLの構成

この章では、WebCenter PortalおよびPortal FrameworkアプリケーションおよびコンポーネントをSSLで保護する方法を説明します。

この章には次の項が含まれます:

- 第35.1項「SSLを使用したブラウザからWebCenter Portalへの接続の保護」

- 第35.2項「SSLを使用したブラウザからPortal Frameworkアプリケーションへの接続の保護」

- 第35.3項「SSLを使用したOracle HTTP ServerからWebCenter Portalへの接続の保護」

- 第35.4項「SSLを使用したブラウザからディスカッションへの接続の保護」

- 第35.5項「SSLを使用したWebCenter Portalからポートレット・プロデューサへの接続の保護」

- 第35.6項「WebCenter PortalからLDAPアイデンティティ・ストアへの接続の保護」

- 第35.7項「SSLを使用したWebCenter PortalからContent Serverへの接続の保護」

- 第35.8項「SSLを使用したWebCenter PortalからIMAPおよびSMTPへの接続の保護」

- 第35.9項「SSLを使用したPortal FrameworkアプリケーションからIMAPおよびSMTPへの接続の保護」

- 第35.10項「SSLを使用したOracle SESへの接続の保護」

- 第35.11項「SSLを使用したWebCenter PortalからMicrosoft Live Communication ServerおよびOffice Communication Serverへの接続の保護」

- 第35.12項「SSLを使用したWebCenter Portalから外部BPELサーバーへの接続の保護」

- 第35.13項「SSLを使用したMicrosoft Exchange Serverへの接続の保護」

注意:
次のサービスやアプリケーションでは、メッセージ保護付きのWS-Securityを使用できるため、SSLのためのハード要件はありません。

- BPELサーバー: ワークリスト

- WSRPプロデューサ

- Microsoft Live Communication Server (LCS): インスタント・メッセージおよびプレゼンス

- ディスカッションおよびお知らせ

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

35.1 SSLを使用したブラウザからWebCenter Portalへの接続の保護

SSLを使用したブラウザからWebCenter Portalへの接続の保護は、次の手順で構成されます。

- 第35.1.1項「カスタム・キーストアの作成」

- 第35.1.2項「カスタムIDキーストアおよびJava信頼キーストアの構成」

- 第35.1.3項「SSL接続の構成」

35.1.1 カスタム・キーストアの作成

最初の手順では、WebCenter Portalにカスタム・キーストアを生成します。

カスタム・キーストアを作成するには:

1. JDK_HOME/bin/に移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、キー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "dname" -alias alias -keypass key_password -keystore keystore -storepass keystore_password -validity days_valid

ここで:

- dnameは、使用するDN(識別名)です(例: cn=customidentity,dc=example,dc=com)。

- aliasは、使用する別名です(例: webcenter_wls)。

- key_passwordは、新規公開鍵のパスワードです(例: MyPassword1)。

- keystoreは、キーストア名です(例: webcenter_wls.jks)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword1)。

- days_validは、キーのパスワードが有効な日数です(例: 360)。

注意:
キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle WebServices Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

3. 公開鍵が含まれる証明書をエクスポートして、WebCenter Portalクライアントが各自のトラスト・ストアに証明書をインポートできるようにします。

keytool -exportcert -v -alias alias -keystore keystore
-storepass keystore_password -rfc -file certificate_file

ここで:

- aliasは、WebCenter Portalの別名です(例: webcenter_wls)。

- keystoreは、キーストア名です(例: webcenter_wls.jks)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword1)。

- certificate_fileは、キーのエクスポート先の証明書のファイル名です(例: webcenter_wls.cer)。

4. 使用するトラスト・ストアを決定します。
自己署名証明書を使用しているため、それをサーバーのトラスト・ストア内の信頼できる証明書として更新する必要があります。これを実行するには、サーバーに移動してトラスト・ストアを決定する必要があります。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「環境」を開き、「サーバー」をクリックします。

3. サーバーのリストで、WC_Spacesをクリックします。

4. 「構成」タブ→「キーストア」サブタブを開きます。
「キーストアの設定」ペインが表示されます。

5. 「Java標準信頼キーストア」フィールド内のサーバーの場所を書き留めます。
cacertsファイルは読取り専用である場合があります。その場合は、書込み可能になるようにその権限を変更する必要があります。

5. このトラスト・ストアに、前述の手順で生成された自己署名証明書をインポートします。

keytool -importcert -trustcacerts -alias alias -file certificate_file
-keystore cacerts -storepass changeit

ここで:

- aliasは、WebCenter Portalの別名です(例: webcenter_wls)。

- certificate_fileは、キーのエクスポート先の証明書のファイル名です(例: webcenter_wls.cer)。

自己署名証明書を信頼するかどうかを尋ねられたら、yesと答えます。

35.1.2 カスタムIDキーストアおよびJava信頼キーストアの構成

次の手順では、WebCenter Portalサーバーに、カスタムIDキーストアとJava信頼キーストアを構成します。

IDキーストアおよび信頼キーストアを構成するには:

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. IDキーストアおよび信頼キーストアを構成するWebCenter Portalサーバー(WC_Spaces)をクリックします。
対象のWebCenter Portalサーバーの「設定」ペインが表示されます。

3. 「構成」タブ→「キーストア」サブタブを開きます。
「キーストア」ペインが表示されます。

4. 「変更」をクリックします。

5. 「キーストア」として、Custom Identity and Java Standard Trustを選択し、「保存」をクリックします。

6. 「アイデンティティ」の下で、第35.1.1項「カスタム・キーストアの作成」で作成したカスタムIDキーストアのパスとファイル名を入力します。

7. 「カスタムIDキーストアのタイプ」として、JKSと入力します。

8. カスタムIDキーストアのパスワードを入力し、確認のためにもう一度入力します。

9. 「信頼」の下で、Java標準信頼キーストアのパスワード(通常はchangeitに設定)を入力し、確認のためにもう一度入力します。

10. 「保存」をクリックして、エントリを保存します。

11. 「SSL」タブを開きます。

12. 「秘密鍵の別名」に値を入力します(例: webcenter_wls)。

13. 「秘密鍵のパスフレーズ」に値を入力します(例: MyPassword1)。

14. 「保存」をクリックして、エントリを保存します。

35.1.3 SSL接続の構成

SSL接続を構成するには:

1. WebCenter Portalサーバー(WC_Spaces)の「設定」ペインで、「構成」タブを開き、「全般」サブタブを開きます。
「一般構成」ペインが表示されます。

2. 「SSLリスニング・ポートの有効化」を選択します。

3. SSLリスニング・ポート番号を入力し、「保存」をクリックします。

4. 「SSL」サブタブを開き、ページの下部にある「詳細」オプションを開きます。

5. 「相互クライアント証明書の動作」オプションが、「クライアント証明書をリクエストしない」に設定されていることを確認し、「保存」をクリックします。

6. 「制御」タブを開きます。
「制御設定」ペインが表示されます。

7. 「SSLの再起動」をクリックします。

8. WebLogic Serverを再起動し、SSL Portal URLを開きます。
開発環境またはテスト環境の場合のみ(つまり、本番環境ではない場合)、証明書内のホスト名が実際のホスト名に一致しないときは、サーバーを次のコマンドで起動する必要があります。

-Dweblogic.security.SSL.ignoreHostnameVerification=true

9. セッションの証明書を受け入れ、ログインします。

35.2 SSLを使用したブラウザからPortal Frameworkアプリケーションへの接続の保護

ブラウザからPortal Frameworkアプリケーションへの接続の保護では、ブラウザからWebCenter Portalへの接続の保護と同じ構成手順を使用します。唯一異なる点は、構成が、WC_Spacesサーバーではなく、Portal Frameworkアプリケーションのデプロイをホストしている管理対象サーバーに対して実行されることです。詳細は、第35.1項「SSLを使用したブラウザからWebCenter Portalへの接続の保護」を参照してください。

35.3 SSLを使用したOracle HTTP ServerからWebCenter Portalへの接続の保護

Oracle HTTP Server (OHS)とWebCenter Portalとの間の接続の保護については、次の各項で説明しています。

- 第35.3.1項「IDキーストアおよび信頼キーストアの構成」

- 第35.3.2項「SSL接続の構成」

- 第35.3.3項「Oracle HTTP Serverのインストール」

- 第35.3.4項「WebCenter PortalポートからHTTP Serverへのワイヤリング」

- 第35.3.5項「SSL証明書の構成」

35.3.1 IDキーストアおよび信頼キーストアの構成

IDキーストアおよび信頼キーストアを構成する手順は、第35.1項「SSLを使用したブラウザからWebCenter Portalへの接続の保護」を参照してください。

35.3.2 SSL接続の構成

SSL接続を構成するには:

1. WebCenter Portalサーバーの「設定」ペインで、「構成」タブ→「全般」サブタブを開きます。
「一般構成」ペインが表示されます。

2. 「SSLリスニング・ポートの有効化」を選択します。

3. SSLリスニング・ポート番号を入力し、「保存」をクリックします。

4. 「構成」タブで、「SSL」サブタブを開き、ページの下部にある「詳細」オプションを開きます。
SSLの詳細オプションが表示されます。

5. 「相互クライアント証明書の動作」オプションを「クライアント証明書をリクエストしない」に設定し、「保存」をクリックします。

6. 「設定」ペインの「制御」タブを開き、「起動と停止」サブタブを選択します。

7. 「SSLの再起動」をクリックします。

8. SSL WebCenter Portal URLを開きます。

9. セッションの証明書を受け入れ、ログインします。

10. WLS管理コンソールで、「チェンジ・センター」ペインの「変更と再起動の表示」をクリックして、影響を受けたサーバーまたはコンポーネントをすべて再起動します。

35.3.3 Oracle HTTP Serverのインストール

Oracle HTTP Serverをインストールする手順は次のとおりです。

1. Web層をインストールします(第33.2.3項「OAMのインストールと構成」を参照)。

- Webキャッシュは選択しないでください。HTTP Serverのみを選択します。

- インストール時にWebLogicサーバーを関連付けるチェック・ボックスを選択解除します。

2. WT_ORACLE_HOME/instances/<your_instance>/binディレクトリにナビゲートし、次のコマンドを使用してOHSを起動します。

./opmnctl startall

3. 次のコマンドを使用して、OHSのステータスを確認します。

./opmnctl status -l

35.3.4 WebCenter PortalポートからHTTP Serverへのワイヤリング

WebCenter PortalポートからHTTP Serverにワイヤリングする手順は次のとおりです。

1. ファイルWT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/mod_wl_ohs.confを開きます。

2. 次のエントリをmod_wl_ohs.confに追加して、WebCenter PortalがOHSと連動するようにします。

<IfModule mod_weblogic.c>
WebLogicHost host_id
WebLogicPort port
Debug OFF
WLLogFile /tmp/ohs.log
MatchExpression *.jsp
</IfModule>

<Location />
SetHandler weblogic-handler
</Location>

host_idおよびportをWebCenter PortalサーバーIDおよびポート番号に置換します。

3. ファイルWT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/ssl.confを開きます。

4. 次のエントリをssl.confに追加して、WebCenter PortalがOHS SSLポートで実行されるようにします。

<Location />
WebLogicHost host_id
WebLogicPort port
SetHandler weblogic-handler
SecureProxy ON
WLLogFile /tmp/ohs_ssl.log
Debug ALL
WlSSLWallet SSL_wallet
</Location>

<Location /webcenter>
SetHandler weblogic-handler
WebLogicHost host_id
WebLogicPort port
SecureProxy ON
WLLogFile /tmp/ohs_ssl.log
Debug ALL
WlSSLWallet SSL_wallet
</Location>

<Location /webcenterhelp>
SetHandler weblogic-handler
WebLogicHost host_id
WebLogicPort port
SecureProxy ON
WLLogFile /tmp/ohs_ssl.log
Debug ALL
WlSSLWallet SSL_wallet
</Location>

<Location /rsscrawl>
SetHandler weblogic-handler
WebLogicHost host_id
WebLogicPort port
SecureProxy ON
WLLogFile /tmp/ohs_ssl.log
Debug ALL
WlSSLWallet SSL_wallet
</Location>

<Location /sesUserAuth>
SetHandler weblogic-handler
WebLogicHost host_id
WebLogicPort port
SecureProxy ON
WLLogFile /tmp/ohs_ssl.log
Debug ALL
WlSSLWallet SSL_wallet
</Location>

<Location /rss>
SetHandler weblogic-handler
WebLogicHost host_id
WebLogicPort port
SecureProxy ON
WLLogFile /tmp/ohs_ssl.log
Debug ALL
WlSSLWallet SSL_wallet
</Location>

host_idおよびportをWebCenter Portal SSLサーバーIDおよびポート番号(通常は8788)に置換し、SSL_walletをWebLogic SSLウォレット(たとえば、WT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/keystores/default)に置換します。

注意:
SSLは、Location/ディレクトリ・セクション内ではなく、サーバー・レベルで構成する必要があります。このため、たとえば、次のように構成するのではなく、

<Location /mylocation>
WLSSLWallet <walletfile>
SecureProxy ON
</Location>

次のように構成します。

SecureProxy ON
WlSSLWallet <walletfile>

つまり、サーバー・レベル(Location/ディレクトリ・セクション外)での構成です。

5. WT_ORACLE_HOME/instances/<your_instance>/binに移動し、次のコマンドを使用してOHSを起動し、そのステータスを確認します。

./opmnctl stopall

./opmnctl startall
./opmnctl status -l

35.3.5 SSL証明書の構成

SSL証明書を構成するには:

1. WebCenter Portalの証明書を信頼するようにOHSを構成するには、WC_Spaces証明書をOHSトラスト・ストアにインポートする必要があります。WC_SpacesIDキーストアからこの証明書をエクスポートします。

keytool -exportcert -v -alias webcenter_wls -keystore webcenter_wls.jks
-storepass <password> -rfc -file webcenter_wls.cer

2. WT_ORACLE_HOME/instances/<your_instance>/config/OHS/ohs1/keystores/defaultに移動し、次のorapkiコマンド(通常はIDM_HOMEにあります)を実行してOHSサイドのウォレットに証明書をインポートします。

orapki wallet add -wallet . -trusted_cert -cert webcenter_wls.cer -auto_login_only

orapkiコマンドの実行前にJAVA_HOMEを設定する必要があることに注意してください。

3. 次のコマンドの実行により、証明書DNを決定します。

orapki wallet display -wallet wallet_location

4. OHS証明書を信頼するようにWebCenter Portalを構成するには、OHSウォレットからユーザー証明書をエクスポートして、それをWebLogicトラスト・ストアに信頼できる証明書としてインポートします。

orapki wallet export -wallet . -cert cert.txt  -dn 'CN=\"Self-signed Certificate for ohs1 \",OU=EXAMPLEORGUNIT,O=EXAMPLEORG,L=EXAMPLELOCATION,ST=CA,C=US'

5. 前述の証明書をWC_Spaces管理対象サーバーのトラスト・ストアにインポートします。このトラスト・ストアは、/scratch/wcwlsinstall/0408/wlshome/jrockit_160_05_R27.6.2-20/jre/lib/security/cacertsにあります。

keytool -file cert.txt -importcert -trustcacerts -alias ohs_cert
-keystore cacerts -storepass changeit

6. OHSおよびWC_Spacesサーバーを再起動します。
これで、SSL OHSおよび非SSL OHSにアクセスできるようになりました。

35.4 SSLを使用したブラウザからディスカッションへの接続の保護

SSLを使用したブラウザからディスカッションへの接続の保護については、次の各項で説明しています。

- 第35.4.1項「カスタム・キーストアの作成」

- 第35.4.2項「IDキーストアおよび信頼キーストアの構成」

- 第35.4.3項「SSL接続の構成」

35.4.1 カスタム・キーストアの作成

次に示しているように、最初の手順ではカスタム・キーストアを生成します。

1. JDK_HOME/bin/に移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、キー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "dname" -alias owc_discussions
-keypass key_password -keystore owc_discussions.jks -storepass keystore_password -validity days_valid

ここで:

- dnameは、使用するDN(識別名)です(例: cn=customidentity,dc=owc_discussions,dc=example,dc=com)。

- key_passwordは、新規公開鍵のパスワードです(例: MyPassword1)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword1)。

- days_validは、キーのパスワードが有効な日数です(例: 360)。

注意:
キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle WebServices Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

3. 公開鍵が含まれる証明書をエクスポートします。

keytool -exportcert -v -alias owc_discussions -keystore owc_discussions.jks
-storepass keystore_password -rfc -file owc_discussions.cer

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword1)。

4. 使用するトラスト・ストアを決定します。
自己署名証明書を使用しているため、それをサーバーのトラスト・ストア内の信頼できる証明書として更新する必要があります。これを実行するには、サーバーに移動してトラスト・ストアを決定する必要があります。

1. WebLogic Server管理コンソールにログインします。

2. 「ドメイン構造」ペインで、「環境」を開き、「サーバー」をクリックします。

3. サーバーのリストで、WC_Collaborationをクリックします。

4. 「構成」タブ→「キーストア」サブタブを開きます。
「キーストアの設定」ペインが表示されます。

5. 「Java標準信頼キーストア」フィールド内のサーバーの場所を書き留めます。
cacertsファイルは読取り専用である場合があります。その場合は、書込み可能になるようにその権限を変更する必要があります。

5. このトラスト・ストアに、前述の手順で生成された自己署名証明書をインポートします。

keytool -importcert -trustcacerts -alias owc_discussions
-file owc_discussions.cer -keystore cacerts -storepass changeit

cacertsファイルへのパスは絶対パスである必要があることに注意してください。そうでない場合、新しいcacertsファイルは、keytoolが実行されるディレクトリ(SSLポートがリスニングできない可能性のある場所)に作成されます。

自己署名証明書を信頼するかを尋ねられたら、yesと答えます。

35.4.2 IDキーストアおよび信頼キーストアの構成

IDキーストアおよび信頼キーストアを構成するには:

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「環境」を開き、「サーバー」をクリックします。
「サーバーのサマリー」ペインが表示されます。

3. IDキーストアおよび信頼キーストアを構成するコラボレーション・サーバー(WC_Collaboration)をクリックします。
コラボレーション・サーバーの「設定」ペインが表示されます。

4. 「構成」タブ→「キーストア」サブタブを開きます。
「キーストア」ペインが表示されます。

5. 「キーストア」として、「カスタム・アイデンティティとJava標準信頼」を選択します。

6. 「アイデンティティ」の下で、キーストアをowc_discussions.jksとして指定します。

7. キーストア・タイプをJKSに設定します。

8. キーストアのパスフレーズ(例: MyPassword1)を入力し、確認のためにもう一度入力します。

9. 「信頼」の下で、「Java標準信頼キーストアのパスフレーズ」をchangeit(これは固定値)に設定し、「保存」をクリックします。

10. WLS管理コンソールで、「サーバー」→「WC_Collaboration」に移動し、「構成」タブを開き、「全般」サブタブを開きます。

11. 「SSLポートの有効化」を選択して、目的のポートを指定し、設定を保存します。

12. WLS管理コンソールで、「サーバー」→「WC_Collaboration」に移動し、「構成」タブを開き、「SSL」サブタブを開きます。

13. 秘密鍵の別名をowc_discussionsに指定し、パスワードをMyPassword1に設定します。

14. 「制御」タブを開きます。
「制御設定」ペインが表示されます。

15. 「SSLの再起動」をクリックします。

35.4.3 SSL接続の構成

SSL接続を構成するには:

1. コラボレーション・サーバーの「設定」ペインで、「構成」タブを開き、「全般」サブタブを開きます。
「一般構成」ペインが表示されます。

2. 「SSLリスニング・ポートの有効化」を選択します。

3. SSLリスニング・ポート番号を入力し、「保存」をクリックします。

4. 「構成」タブで、「SSL」サブタブを開き、ページの下部にある「詳細」オプションを開きます。

5. 「相互クライアント証明書の動作」オプションを「クライアント証明書をリクエストしない」に設定し、「保存」をクリックします。

6. WC_Collaborationサーバーを再起動して、SSLディスカッションURLをhttps://host:port/owc_discussionsで開きます。

7. セッションの証明書を受け入れ、ログインします。

35.5 SSLを使用したWebCenter Portalからポートレット・プロデューサへの接続の保護

SSLを使用したWSRPおよびPDK-Javaポートレット・プロデューサへの接続の保護については、次の各項で説明しています。

- 第35.5.1項「カスタム・キーストアの作成」

- 第35.5.2項「IDキーストアおよび信頼キーストアの構成」

- 第35.5.3項「SSL接続の構成」

- 第35.5.4項「SSL対応WSRPプロデューサの登録およびポートレットの実行」

- 第35.5.5項「SSL対応PDK-Javaプロデューサの登録およびポートレットの実行」

- 第35.5.6項「JDeveloperでのSSL対応WSRPポートレットの消費」

35.5.1 カスタム・キーストアの作成

カスタム・キーストアを作成する手順は、第35.1.1項「カスタム・キーストアの作成」を参照してください。 キーペアの生成や証明書のエクスポートおよびインポートのコマンド例は次のとおりです。

./keytool -genkeypair -keyalg RSA -dname "cn=customidentity,dc=portlet,dc=example,dc=com"
-alias portlet -keypass MyPassword1 -keystore portlet.jks -storepass MyPassword1 -validity 360

./keytool -exportcert -v -alias portlet -keystore portlet.jks -storepass
MyPassword1 -rfc -file portlet.cer

./keytool -importcert -trustcacerts -alias portlet -file portlet.cer
-keystore cacerts -storepass changeit

35.5.2 IDキーストアおよび信頼キーストアの構成

IDキーストアおよび信頼キーストアを構成するには:

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「環境」を開き、「サーバー」をクリックします。
「サーバーのサマリー」ペインが表示されます。

3. IDキーストアおよび信頼キーストアを構成するポートレット・サーバー(たとえば、WC_Portlet)をクリックします。
ポートレット・サーバーの「設定」ペインが表示されます。

4. 「構成」タブ→「キーストア」サブタブを開きます。
「キーストア」ペインが表示されます。

5. 「キーストア」として、Custom Identity and Java Standard Trustを選択し、「保存」をクリックします。

6. 「制御」タブを開きます。
「制御設定」ペインが表示されます。

7. 「SSLの再起動」をクリックします。

35.5.3 SSL接続の構成

SSL接続を構成するには:

1. 「ドメイン構造」ペインで「環境」を開き、「サーバー」を選択します。

2. SSLを構成するポートレット・サーバー(たとえば、WC_Portlet)をクリックします。

3. 「構成」を選択します。

4. 「SSLリスニング・ポートの有効化」を選択します。

5. リスニング・ポート番号を入力します。

6. 「構成」→「SSL」を選択し、ページの一番下にある「拡張オプション」を開きます。

7. 「相互クライアント証明書の動作」属性を選択し、「クライアント証明書をリクエストしない」オプションを選択します。

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

9. WebLogic Serverを再起動し、SSL URLを開きます。

10. セッションの証明書を受け入れ、ログインします。

35.5.4 SSL対応WSRPプロデューサの登録およびポートレットの実行

SSL対応WSRPプロデューサを登録し、ポートレットを実行する手順は次のとおりです。

1. カスタム・アイデンティティおよびJava標準トラスト・ストアを使用するようにWC_Spaces管理対象サーバーを構成します。これは、JDK_HOME/jre/lib/security/cacerts内の証明書も使用します。

2. HTTPSプロデューサURLの証明書をダウンロードし、.PEM形式で保存します。
Firefox 3.0以降を使用して、証明書を直接.PEM形式にダウンロードします。他のブラウザの場合は、WebLogic Server der2pemツールを使用してPEM形式に変換します。der2pemツールの使用の詳細は、『Oracle WebLogic Serverコマンド・リファレンス』のder2pemに関する項を参照してください。WebLogicでは、.PEM以外の形式は認識されません。

3. 次のkeytoolコマンドを使用して、JDK_HOME/jre/lib/security内のcacertsファイルに証明書をインポートします。

keytool -importcert -alias portlet_cert -file HOME/portlet_pem -keystore ./cacerts -storepass password

ここで:

- portlet_certは、ポートレット証明書の別名です。

- portlet_pemは、ポートレット証明書ファイルです(例: portlet_cert.pem)。

- passwordは、キーストアのパスワードです。

4. WC_Spacesを再起動します。

5. 第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」の説明に従って、WLSTを起動します。

6. 次のコマンドを使用して、ターゲット・ドメインの管理サーバーに接続します。

connect('user_name','password, 'host_id:port')

ここで:

- user_nameは、WC_Spacesサーバーにアクセスするユーザー・アカウントの名前です(例: weblogic)。

- passwordは、WC_Spacesサーバーにアクセスするためのパスワードです。

- host_idは、管理サーバーのホストIDです。

- portは、管理サーバーのポート番号です(例: 7001)。

7. registerWSRPProducer WLSTコマンドを実行して、プロデューサを登録します。

registerWSRPProducer('webcenter', 'sslwsrpprod','producer_wsdl')

ここで:

- sslwsrpprodは、SSL対応WSRPプロデューサの名前です。

- producer_wsdlは、SSL対応WSRPプロデューサのWSDL URLです。

例:

registerWSRPProducer('webcenter', 'sslwsrpprod','https://example.com:7004/richtextportlet/portlets/wsrp2?WSDL')

8. HTTPまたはHTTPSのWebCenter Portal URLにナビゲートします。

9. ページを作成し、「ポートレット」リンクに移動します。

10. 登録済のWSRPプロデューサに移動します。

11. ポートレットをページに追加します。

12. ページの表示モードに変更して、WSRPポートレットが適切にレンダリングすることを確認します。

35.5.5 SSL対応PDK-Javaプロデューサの登録およびポートレットの実行

SSL対応PDK-Javaプロデューサを登録し、ポートレットを実行する手順は次のとおりです。

1. デモのアイデンティティおよびトラスト・ストアを使用するようにWebCenter Portal管理対象サーバーを構成します。これは、JDK_HOME/jre/lib/security/cacerts内の証明書も使用します。

2. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

3. 「ドメイン構造」ペインで「環境」を開き、「サーバー」をクリックします。
「サーバーのサマリー」ペインが表示されます。

4. サーバーのリストで、WC_Spacesをクリックします。
「設定」ペインが表示されます。

5. 「構成」タブを開き、「キーストア」タブを選択します。

6. 「デモIDとデモ信頼」の値がjksまたは空白のままになっていることを確認します。

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

8. HTTPSプロデューサURLの証明書をダウンロードし、.PEM形式で保存します。
Firefox 3.0以降を使用して、証明書を直接.PEM形式にダウンロードします。他のブラウザの場合は、WebLogic Server der2pemツールを使用してPEM形式に変換します。der2pemツールの使用の詳細は、『Oracle WebLogic Serverコマンド・リファレンス』のder2pemに関する項を参照してください。WebLogicでは、.PEM以外の形式は認識されません。

9. 次のkeytoolコマンドを使用して、JDK_HOME/jre/lib/security内のcacertsファイルに証明書をインポートします。

keytool -importcert HOME/portlet_cert.pem -keystore ./cacerts -storepass changeit

10. WC_Spacesを再起動します。

11. 第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」の説明に従って、WLSTを起動します。

12. 次のコマンドを使用して、ターゲット・ドメインの管理サーバーに接続します。

connect('user_name','password, 'host_id:port')

ここで:

- user_nameは、WC_Spacesサーバーにアクセスするユーザー・アカウントの名前です(例: weblogic)。

- passwordは、WC_Spacesサーバーにアクセスするためのパスワードです。

- host_idは、管理サーバーのホストIDです。

- portは、管理サーバーのポート番号です(例: 7001)。

13. registerPDKJavaProducerコマンドを実行します。

registerPDKJavaProducer('webcenter', 'ssljpdkprod', 'producer_wsdl')

ここで:

- ssljpdkprodは、SSL対応PDK-Javaプロデューサの名前です。

- producer_wsdlは、SSL対応PDK-JavaプロデューサのWSDL URLです。

これによって、Webプロデューサに対して一方向SSLが有効になります。つまり、サーバー・サイド(Webプロデューサ)でのみ証明書が使用されるようになります。Webプロデューサ・コードでは、クライアント認証に共有鍵機能(後述します)も使用されます。

14. HTTPまたはHTTPSのWebCenter Portal URLに移動します。

15. ページを作成し、「ポートレット」リンクに移動します。

16. 登録済のPDK-Javaプロデューサに移動します。

17. ポートレットをページに追加します。

18. ページの表示モードに変更して、PDK-Javaポートレットが適切にレンダリングすることを確認します。

35.5.6 JDeveloperでのSSL対応WSRPポートレットの消費

SSL対応ポートレットをJDeveloperで消費している場合、プロデューサの管理対象サーバー上でSSLを有効化します(第35.5.3項「SSL接続の構成」を参照)。

1. 登録には、証明書(自己署名証明書であるため)が、JDeveloperランタイム・トラスト・ストアによって信頼される必要があります。つまり、JDeveloperインスタンスによって使用されているJDKを探し、(JDeveloperインスタンスによって使用されるトラスト・ストアである)cacertsファイルを更新し、続いて次のサンプル・コマンドを使用してcacertsファイルを更新する必要があります。

<JDK_BIN>/keytool -importcert -trustcacerts -alias portlet_producer_cert -file producer.cert -keystore ./cacerts -storepass changeit

2. 統合WebLogicサーバーは通常、JDeveloper以外のトラスト・ストアを使用します。このトラスト・ストアを確認するには、統合WebLogicサーバーのコンソールにアクセスします。

1. WebLogicコンソールにアクセスします。

2. 「環境」ノードを開き、「サーバー」をクリックします。

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

4. 「構成」タブを開き、「キーストア」タブを開きます。
Demo Trust Keystore属性の値が、統合WebLogicサーバーによって使用されるトラスト・ストアです。

トラスト・ストアの場所は、統合WebLogicサーバーのログを参照して確認することもできます。統合WebLogicサーバーを起動し、ログ内で「-Djavax.net.ssl.trustStore」を検索することによって、トラスト・ストアの場所を確認します。

このプロセス・パラメータがある場合、統合WebLogicサーバーはJVMパラメータを使用して指定されるトラスト・ストアを使用します。次の例のように、コマンドを使用してこのトラスト・ストアに証明書をインポートする必要があります。

<JDK6>/bin/keytool -importcert -trustcacerts -alias portlet_producer_cert
-file producer_cert.cert -keystore
<JDEV_MW_HOME>/wlserver_10.3/server/lib/DemoTrust.jks -storepass
DemoTrustKeyStorePassPhrase

35.6 WebCenter PortalからLDAPアイデンティティ・ストアへの接続の保護

SSL用にLDAPサーバー・ポートを構成するには、LDAPサーバーの適切な管理ドキュメントを参照してください。Oracle Internet Directory (OID)ではデフォルトで、SSLポートがインストールされます。WebCenter PortalからLDAP通信にこのポートを使用するには、適切なオーセンティケータにより認証できるようにアイデンティティ・ストアを構成する必要があります。アイデンティティ・ストアに対してこの作業を行うための手順は、第31章「アイデンティティ・ストアの構成」を参照してください。

注意:
プロバイダ固有の情報を入力する場合は、SSLポートを指定して、「SSLの有効化」チェック・ボックスを選択してください。

Oracle WebLogicサーバーにとってCAが不明である場合は、次の各項で説明している2つの追加手順を完了します。

- 第35.6.1項「OID認証局(CA)のエクスポート」

- 第35.6.2項「WebLogicサーバーの設定」

35.6.1 OID認証局(CA)のエクスポート

Oracle WebLogicサーバーにとってCAが不明である場合は(コマンドはユーザーに対してキーストア・パスワードの入力を求めます)、orapki (通常はIDM_HOMEにあります)を使用して証明書を作成する必要があります。次の例は、このコマンドを使用して、証明書serverTrust.certを作成する方法を示しています。

orapki wallet export -wallet CA -dn "CN=myCA" -cert oid_server_trust.cert

35.6.2 WebLogicサーバーの設定

Oracle WebLogicサーバーにとってCAが不明である場合、ユーティリティkeytoolを使用して、Oracle Internet DirectoryのCAをWebLogicトラスト・ストアにインポートする必要があります。次の例は、keytoolを使用して、ファイルoid_server_trust.certをサーバーのトラスト・ストアcacertsにインポートする方法を示しています。

keytool -importcert -v -trustcacerts -alias oid_server_trust -file
oid_server_trust.cer -keystore cacerts -storepass changeit

35.7 SSLを使用したWebCenter PortalからContent Serverへの接続の保護

リポジトリへの接続を作成するContent ServerおよびWebCenter Portalアプリケーションが、同じシステム上または信頼できる同じプライベート・ネットワーク上にない場合、アイデンティティ伝播はセキュアではありません。アイデンティティ伝播のセキュリティを確保するには、Content ServerにSSLを構成する必要もあります。

SSLを使用したContent Serverの保護には、次のタスクが含まれます。

- 第35.7.1項「クライアント・サイドでのキーストアおよびキーの構成」

- 第35.7.2項「サーバー・サイドでのキーストアおよびキーの構成」

- 第35.7.3項「信頼できるクライアントのシグネチャの検証」

- 第35.7.4項「アイデンティティ伝播の保護」

本番環境では、実際の証明書のみを使用することをお薦めします。実際の証明書を使用するときにキーストアを構成する方法の詳細は、『Oracle WebCenter Contentの管理』の「Content Serverセキュリティ・プロバイダの理解」の章を参照してください。

35.7.1 クライアント・サイドでのキーストアおよびキーの構成

WebCenter Portalアプリケーション(クライアント)サイドでキーストアを構成するには:

1. keytoolの場所(例: jdk/bin)に移動し、コマンド・プロンプトを開きます。

2. 次のkeytoolコマンドを実行して、クライアント・キーストアを生成します。

keytool -genkey -keyalg RSA -validity 5000 -alias Client private key alias -keystore client-keystore.jks
-dname "cn=client" -keypass Private key password -storepass KeyStore password

3. キーが正常に作成されたことを確認するために、オプションで次のkeytoolコマンドを実行できます。

keytool -list -keystore client-keystore.jks -storepass KeyStore password

4. キーを使用するには、次のkeytoolコマンドを実行してキーに署名します。

keytool -selfcert -validity 5000 -alias Client private key alias -keystore client-keystore.jks
-keypass Private key password -storepass KeyStore password

5. 次のkeytoolコマンドを実行して、クライアントの公開鍵をエクスポートします。

keytool -export -alias Client private key alias -keystore client-keystore.jks
-file client.pubkey -keypass Private key password -storepass KeyStore password

35.7.2 サーバー・サイドでのキーストアおよびキーの構成

Content Serverサイドでキーストアを構成するには:

1. keytoolの場所(例: jdk/bin)に移動し、コマンド・プロンプトを開きます。

2. 次のkeytoolコマンドを実行して、サーバー・キーストアを生成します。

keytool -genkey -keyalg RSA -validity 5000 -alias Server public key alias
-keystore server-keystore.jks -dname "cn=server" -keypass Private server key password -storepass KeyStore password

3. キーが正常に作成されたことを確認するには、次のkeytoolコマンドを実行します。

keytool -list -keystore server-keystore.jks -keypass Server private key password -storepass KeyStore password

4. キーを使用するには、次のkeytoolコマンドを実行してキーに署名します。

keytool -selfcert -validity 5000 -alias Server public key alias -keystore server-keystore.jks
-keypass Private server key password -storepass KeyStore password

5. 次のkeytoolコマンドを実行して、サーバーの公開鍵をサーバー・キーストアにエクスポートします。

keytool -export -alias Server public key alias -keystore server-keystore.jks
-file server.pubkey -keypass Server private key password -storepass KeyStore password

35.7.3 信頼できるクライアントのシグネチャの検証

信頼できるクライアントのシグネチャを検証するには、クライアントの公開鍵をサーバー・キーストアにインポートします。

1. keytoolの場所(例: jdk/bin)に移動し、コマンド・プロンプトを開きます。

2. 信頼できるクライアントのシグネチャを検証するには、次のkeytoolコマンドを実行して、クライアントの公開鍵をサーバー・キーストアにインポートします。

keytool -import -alias Client public key alias -file client.pubkey -keystore
server-keystore.jks -keypass Private server key password -storepass KeyStore password

3. 次のkeytoolコマンドを実行して、サーバーの公開鍵をクライアント・キーストアにインポートします。

keytool -import -alias Server public key alias -file server.pubkey -keystore
client-keystore.jks -keypass Private key password -storepass KeyStore password

キーを自己認証するかどうかを尋ねられたら、Yesと入力します。例35-1に、この手順が正常に完了すると生成されるサンプル出力を示します。

例35-1 keytoolにより生成されるサンプル出力

[user@server]$ keytool -import -alias client -file client.pubkey
-keystore server-keystore.jks -keypass Server private key password -storepass Keystore password
Owner: CN=client
Issuer: CN=client
Serial number: serial number, for example, 123a19cb
Valid from: Date, Year, and Time until: Date, Year, and Time
Certificate fingerprints:
...
Trust this certificate? [no]:  yes
Certificate was added to keystore.

35.7.4 アイデンティティ伝播の保護

アイデンティティ伝播を保護するには、Content ServerにSSLを構成する必要があります。

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

2. 「管理」から、「プロバイダ」を選択します。

3. 「新規プロバイダの作成」ページで、sslincomingの「追加」をクリックします。

4. 「受信プロバイダの追加」ページの「プロバイダ名」に、プロバイダの名前(たとえば、sslincomingprovider)を入力します。
新規プロバイダが設定されたら、そのプロバイダ名を持つディレクトリが、CONTENT_SERVER_HOME/data/providersディレクトリのサブディレクトリとして作成されます。

5. 「プロバイダの説明」に、プロバイダの短い説明(たとえば、SSL Incoming Provider for securing the Content Server)を入力します。

6. 「プロバイダ・クラス」に、sslincomingプロバイダのクラス(たとえば、idc.provider.ssl.SSLSocketIncomingProvider)を入力します。

注意:
新規のSSLキープアライブ受信ソケット・プロバイダまたは新規のSSL受信ソケット・プロバイダを追加できます。キープアライブ・ソケットを使用すると、セッションのパフォーマンスが向上するため、ほとんどの実装で推奨されます。

7. 「接続クラス」に、接続のクラス(たとえば、idc.provider.KeepaliveSocketIncomingConnection)を入力します。

8. 「サーバー・スレッド・クラス」に、サーバー・スレッドのクラス(たとえば、idc.server.KeepaliveIdcServerThread)を入力します。

9. 「サーバー・ポート」に、オープン・サーバー・ポート(たとえば、5555)を入力します。

10. 「クライアントの認証が必要」チェック・ボックスを選択します。

11. 「キーストア・パスワード」に、キーストアにアクセスするためのパスワードを入力します。

12. 「別名」に、キーストアの別名を入力します。

13. 「別名パスワード」に、別名のパスワードを入力します。

14. 「トラスト・ストア・パスワード」に、トラスト・ストアのパスワードを入力します。

15. 「追加」をクリックします。
新規の受信プロバイダが追加されました。

16. 手順4で作成した新規のプロバイダ・ディレクトリに移動します。

17. トラスト・ストアおよびキーストアを指定するには、sslconfig.hdaという名前のファイルを作成します。

18. サーバー・キーストアをサーバーにコピーします。

19. sslconfig.hdaファイルを構成します。例35-2は、トラスト・ストアおよびキーストアの情報が指定された.hdaファイルの内容を示しています。

例35-2 サンプルのsslconfig.hdaファイル

@Properties LocalData
TruststoreFile=/tmp/ssl/server_keystore
KeystoreFile=/tmp/ssl/server_keystore
@end

35.8 SSLを使用したWebCenter PortalからIMAPおよびSMTPへの接続の保護

メール・サーバーへの接続を再構成する前に、まず証明書をトラスト・ストアにインポートする必要があります。次の手順に従って、トラスト・ストアに証明書を格納し、トラスト・ストアを使用するようにWebCenter Portalを構成します。

SSLを使用して、WebCenter PortalからIMAPおよびSMTPへの接続を保護する手順は次のとおりです。

1. ブラウザを開き、次のコマンドを使用してIMAPサーバーに接続します。

https://imapserver:ssl_port

例:

https:mailserver.example:993

2. ページにカーソルを置いて右クリックし、「プロパティ」を選択します。

3. 「証明書」をクリックします。

4. ポップアップ・ウィンドウで、「詳細」タブをクリックし、「ファイルにコピー...」をクリックします。
必ずDER encoded binary(X.509)形式を使用してファイルにコピーします。

5. .DER形式の証明書を.PEM形式に変換します。
Firefox 3.0以降を使用して、証明書を直接.PEM形式にダウンロードします。他のブラウザの場合は、WebLogic Server der2pemツールを使用してPEM形式に変換します。der2pemツールの使用の詳細は、『Oracle WebLogic Serverコマンド・リファレンス』のder2pemに関する項を参照してください。WebLogicでは、.PEM以外の形式は認識されません。

6. 次のコマンドを使用して、JDK_HOME内のcacertsに証明書をインポートします。

keytool -import -alias imap_cer -file cert_file.cer -keystore cacerts -storepass changeit

cert_fileは、ダウンロードした証明書ファイルの名前です。

7. 第15.4項「メール・サーバーの登録」で説明しているとおりに、メール・サーバーへの接続を登録します。

8. WebCenter Portalを再起動します。

9. WebCenter Portalにログインし、メール資格証明を提供します。

35.9 SSLを使用したPortal FrameworkアプリケーションからIMAPおよびSMTPへの接続の保護

SSLを使用して、Portal FrameworkアプリケーションからIMAPおよびSMTPへの接続を保護する手順は次のとおりです。

1. 第35.8項「SSLを使用したWebCenter PortalからIMAPおよびSMTPへの接続の保護」の手順7までを実行します。

2. 次のプロパティをトラスト・ストアに追加します。

-Djavax.net.ssl.trustStore=C:\jive\mailtool\jssecacerts
-Djavax.net.ssl.trustStorePassword=changeit

例:

set JAVA_PROPERTIES=-Dplatform.home=%WL_HOME% -Dwls.home=%WLS_HOME%
-Dweblogic.home=%WLS_HOME%
-Djavax.net.ssl.trustStore=C:\jive\mailtool\jssecacerts
-Djavax.net.ssl.trustStorePassword=changeit

3. Portal Frameworkアプリケーションを再起動します。

4. アプリケーションにログインし、メール資格証明を提供します。

35.10 SSLを使用したOracle SESへの接続の保護

SES用にSSLを構成するシナリオは2つあります。1つ目のシナリオは、WebCenter PortalまたはPortal FrameworkアプリケーションがすでにSSLを使用して保護されているが、SESは保護されていない場合です。2つ目のシナリオは、SESがすでにSSLを使用して保護されているが、WebCenter PortalまたはPortal Frameworkアプリケーションは保護されていない場合です。これら2つのシナリオについて、次の各項で説明します。

- 第35.10.1項「SSLを使用したOracle SESの保護」

- 第35.10.2項「SSLを使用したOracle SESへの接続の保護」

35.10.1 SSLを使用したOracle SESの保護

このシナリオでは、WebCenter PortalまたはPortal FrameworkアプリケーションはすでにSSLを使用して保護されていますが、SESは保護されていません。SSLを使用してSESを保護する手順は次のとおりです。

SESへの接続を登録する前に、まず、証明書をトラスト・ストアにインポートする必要があります。次の手順に従って、トラスト・ストアに証明書を格納し、Oracle Secure Enterprise Search (SES)への接続を登録します。

HTTPS URLの証明書をダウンロードして保存する手順は次のとおりです。

1. 次の証明書名を使用して、WebCenter側でSSLを構成します。

cn=<myhost>

<myhost>は、WebCenterがインストールされているホストの完全修飾名です。

WebCenter PortalでのSSLの構成の詳細は、第35.1項「SSLを使用したブラウザからWebCenter Portalへの接続の保護」を参照してください。 Portal Frameworkアプリケーションに対するSSLの構成の詳細は、第35.2項「SSLを使用したブラウザからPortal Frameworkアプリケーションへの接続の保護」を参照してください。

2. WebCenter証明書をPEM形式で(つまり<myhost>.crtとして)エクスポートします。
Firefox 3.0以降を使用すると、証明書を.PEM形式で直接ダウンロードできます。それ以外のブラウザの場合は、次の手順を実行した後、WebLogic Serverのder2pemツールを使用してPEM形式に変換してください。

1. 「証明書」をクリックします。

2. ポップアップ・ウィンドウで、「詳細」タブを開き、「ファイルにコピー...」をクリックします。
DER encoded binary(X.509)形式を使用して、証明書をファイルにコピーします。

3. .DER形式の証明書を.PEM形式に変換します。
der2pemツールの使用の詳細は、『Oracle WebLogic Serverコマンド・リファレンス』のder2pemに関する項を参照してください。WebLogicでは、.PEM以外の形式は認識されません。

3. SESで、次のキーストアに証明書をインポートします。

- <SES Installation Directory>/jdk6/jre/lib/security/cacerts

- <SES Installation Directory>/seshome/jdk/jre/lib/security/cacerts

次のコマンドを使用します。

keytool -importcert -trustcacerts -alias webcenter_wls -file <myhost>.crt -keystore cacerts -storepass changeit

4. SESで、クロールおよび認可エンドポイントがWebCenter PortalまたはPortal FrameworkアプリケーションのHTTPSポートを指す、Oracle WebCenterのソースを作成します。

5. クロールのスケジュールおよびソース・グループを作成します(第18.5.1.2項「Fusion Middleware Controlを使用した検索パラメータとクローラの構成」を参照)。

6. SESのWebCenter側の構成を完了し、SESとWebCenter PortalまたはPortal Frameworkアプリケーションを再起動します。

7. WebCenter PortalまたはPortal Frameworkアプリケーション内にいくつかのオブジェクトを作成し、クロールを開始します。

8. クロールが完了したら、キーワード検索を実行します。WebCenter内に結果が表示されるはずです。

35.10.2 SSLを使用したOracle SESへの接続の保護

このシナリオでは、WebCenter PortalまたはPortal FrameworkアプリケーションはSSLを使用して保護されていませんが、SESは保護されています。

HTTPS URLの証明書をダウンロードして保存する手順は次のとおりです。

1. ブラウザを使用して、Oracle Secure Enterprise Searchが検索リクエストを有効化するために公開するWebサービスURLにナビゲートします。

http://host:port/search/query/OracleSearch

例:

https://example.com:7777/search/query/OracleSearch

2. ページにカーソルを置いて、マウスで右クリックし、「プロパティ」を選択します。

3. 「証明書」をクリックします。

4. ポップアップ・ウィンドウで、「詳細」タブを開き、「ファイルにコピー...」をクリックします。
DER encoded binary(X.509)形式を使用して、証明書をファイルにコピーします。

5. .DER形式の証明書を.PEM形式に変換します。
Firefox 3.0以降を使用して、証明書を直接.PEM形式にダウンロードします。他のブラウザの場合は、WebLogic Server der2pemツールを使用してPEM形式に変換します。der2pemツールの使用の詳細は、『Oracle WebLogic Serverコマンド・リファレンス』のder2pemに関する項を参照してください。WebLogicでは、.PEM以外の形式は認識されません。

6. 次のコマンドを使用して、DemoTrustKeyStore.jksまたはJDK_HOME内のcacertsに証明書をインポートします。

keytool -import -alias ses_cer -file cert_file.cer -keystore cacerts -storepass changeit

cert_fileは、ダウンロードした証明書ファイルの名前です。

7. 第18.4.2項「Oracle Secure Enterprise Search Serverの登録」で説明しているとおりに、SESへの接続を登録します。

8. WebCenter PortalまたはPortal Frameworkアプリケーションを再起動します。

35.11 SSLを使用したWebCenter PortalからMicrosoft Live Communication ServerおよびOffice Communication Serverへの接続の保護

SSLを使用して、WebCenter PortalからMicrosoft Live Communication Server (LCS)またはOffice Communication Server 2007 (OCS)への接続を保護するには、次の手順に従って証明書をトラスト・ストアにインポートし、そのトラスト・ストアを使用するようにWebCenter Portalを指定します。SSLを使用したWebCenter PortalからMicrosoft Live Communication ServerまたはOffice Communication Serverへの接続の保護は、WS-Securityを使用して機密保護で構成できるため、オプションとなっています。

LCSまたはOCSへの接続を登録する前に、まず、証明書をトラスト・ストアにインポートする必要があります。次の手順に従って、証明書をトラスト・ストアに格納します。

1. ブラウザを開き、通信サーバー(たとえば、https://example.com/RTC)に移動します。

2. ページにカーソルを置いて右クリックし、「プロパティ」を選択します。

3. 「証明書」をクリックします。

4. ポップアップ・ウィンドウで、「詳細」タブを開き、「ファイルにコピー...」をクリックします。
Firefox 3.0以降を使用して、証明書を直接.PEM形式にダウンロードします。他のブラウザの場合は、WebLogic Server der2pemツールを使用してPEM形式に変換します。der2pemツールの使用の詳細は、『Oracle WebLogic Serverコマンド・リファレンス』のder2pemに関する項を参照してください。WebLogicでは、.PEM以外の形式は認識されません。

5. 次のkeytoolコマンドを使用して、証明書をcacertsにインポートします。

keytool -import -alias lcs_cer -file cert_file.cer -keystore cacerts -storepass changeit

cert_fileは、ダウンロードした証明書ファイルの名前です。

6. インストール環境で通信サーバーが使用しているcacertsファイルを見つけ、通信サーバーが参照するこのcacertsファイルをこの証明書で更新します。

keytool -import -alias lcs_cer -file cert_file.cer -keystore cacerts -storepass changeit

7. 第14.3項「インスタント・メッセージおよびプレゼンス・サーバーの登録」で説明しているとおりに、通信サーバーへの接続を登録します。

8. WebCenter Portalサーバーを再起動します。

35.12 SSLを使用したWebCenter Portalから外部BPELサーバーへの接続の保護

この項では、BPELサーバーが外部SOAドメインにある場合に、WebCenter PortalからBPELサーバーへの接続を保護する方法を説明します。

注意:
SOAが外部ドメインにインストールされているときは、アイデンティティ・アサータおよびオーセンティケータをWebCenter Portalの場合とまったく同じように構成する必要があります。外部LDAPアイデンティティ・ストアにアイデンティティ・アサータおよびオーセンティケータを構成する手順の詳細は、第31.1項「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」を参照してください。

SSLを使用して、WebCenter Portalから外部BPELサーバーへの接続を保護する手順は次のとおりです。

1. WebCenter PortalからSOAドメインに公開証明書(webcenter_wls.cer)をコピーします。

2. JDK_HOME/bin/に移動し、コマンド・プロンプトを開きます。

3. 次のkeytoolコマンドを使用して、SOAドメインにカスタム・キーストアを生成し、そのキーストアに名前soa_server1.jksと別名soa_server1を付けます。

keytool -genkeypair -keyalg RSA -dname dname -alias soa_soa_server1 -keypass
key_pass -keystore soa_server1.jks -storepass keystore_password -validity days_valid

ここで:

- dnameは、使用するDN(識別名)です(例: cn=customidentity,dc=example,dc=com)。

- key_passは、新規公開鍵のパスワードです(例: MyPassword1)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword1)。

- days_validは、キーのパスワードが有効な日数です(例: 360)。

4. 次のコマンドを使用して、soa_wls.jksから証明書をエクスポートします。

keytool -exportcert -v -alias soa_server1 -keystore soa_server1.jks
-storepass keystore_password -rfc -file soa_server1.cer

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword1)。

5. SOAドメインでWebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

6. ナビゲーション・ペインで、「環境」を開き、「サーバー」をクリックします。
「サーバーのサマリー」ペインが表示されます。

7. 「構成」タブで、サーバーのリストからsoa_server1をクリックします。
soa_server1の「設定」ページが表示されます。

8. 「キーストア」タブを開きます。
soa_server1のキーストアの設定が表示されます。

9. 「キーストア」として、Custom Identity and Java Standard Trustを選択します。

10. 前述の手順で作成したキーストア(soa_server1.jks)のパスとファイル名を指定します。

11. 「Java標準信頼キーストア」フィールドに指定したJava標準信頼(cacertsファイル)が含まれるディレクトリに移動して、SOAおよびWebCenter Portal公開証明書をこのファイルにインポートし、サーバーによってこれらの証明書が信頼されるようにします。

keytool -importcert -trustcacerts -alias webcenter_wls -file webcenter_wls.cer
-keystore cacerts -storepass keystore_password

keytool -importcert -trustcacerts -alias soa_server1 -file soa_server1.cer
-keystore cacerts -storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword1)。

証明書を信頼するかを尋ねられたら、yesと答えます。

12. SOAドメインでWLS管理コンソールから「SSL」タブを開きます。
soa_server1のSSLの設定が表示されます。

13. 「秘密鍵の別名」としてsoa_server1を指定します。

14. 秘密鍵のパスワード(例: MyPassword1)を入力し、確認のためにもう一度入力して、「保存」をクリックします。

15. 「全般」タブを開きます。
soa_server1の全般設定が表示されます。

16. 「リスニング・ポートの有効化」が選択されていないことを確認します。

17. 「SSLリスニング・ポートの有効化」を選択し、「SSLリスニング・ポート」を指定して、「保存」をクリックします。

18. 「制御」タブ→「起動と停止」サブタブを開きます。
soa_server1の開始/停止の設定が表示されます。

19. サーバーのリストからsoa_server1を選択し、「SSLの再起動」をクリックします。

20. SOAドメインでsoa_server1管理対象サーバーを再起動します。

21. 次のkeytoolコマンドを使用して、WebCenter Portalドメインからsoa_server1.cer証明書を信頼できる証明書としてサーバーのトラスト・ストア(cacerts)にインポートします。

keytool -importcert -trustcacerts -alias soa_server1 -file soa_server1.cer
-keystore cacerts -storepass changeit

証明書を信頼するかを尋ねられたら、yesと答えます。

22. BPEL URLを定義するときに、soa_server1にhost:ssl_port設定を指定して、第20.4.2項「ワークリスト接続の登録」で説明しているとおりにWebCenter Portalドメインにワークリスト接続を追加します。

23. WC_Spacesサーバーを再起動します。

35.13 SSLを使用したMicrosoft Exchange Serverへの接続の保護

この項では、SSLを使用したMicrosoft Exchange Serverの個人用イベントおよびメール接続を保護する方法について説明します。

SSLでMicrosoft Exchange Serverが有効になっている場合、サーバー証明書をWebCenter PortalドメインのWC_Spaces管理対象サーバーに構成されたキーストアに追加する必要があります。デフォルトで、DemoTrustがWC_Spacesのトラスト・ストアとして構成されます。

証明書をトラスト・ストアに追加するには:

1. Microsoft Exchange管理者からPEM形式で証明書を取得するか、ダウンロードします。詳細は、第15.3.2.1.1項「Microsoft Exchange Serverからの証明書の取得」を参照してください。

2. サーバー証明書をキーストアにインポートします。たとえば、Microsoft Exchange Server 2010の証明書をデフォルト・キーストアDemoTrustKeyStore.jksにインポートするには、次のkeytoolコマンドを実行します。

keytool -import -alias exchange2010_cert -file cert_file.crt -keystore DemoTrust.jks -storepass DemoTrustKeyStorePassPhrase

キーストアへの証明書の追加の詳細は、第33.4.2.1.3項「証明書の構成とエクスポート」を参照してください。

注意:
デフォルトのDemoTrustキーストアのかわりにWebCenter Portalのカスタム・キーストアを構成している場合、サーバー証明書をカスタム・キーストアにインポートする必要があります。

3. WC_Spacesを再起動します。

36 WS-Securityの構成

この章では、WebCenter PortalおよびPortal Frameworkアプリケーション、および関連するサービスとコンポーネントに、使用するトポロジに基づいてWS-Securityを設定する方法を説明します。

この章では、次の構成について説明します。

- 単純トポロジ。WebCenter PortalまたはPortal Frameworkアプリケーションとすべてのコンポーネントが同一ドメインを共有しています。

- 標準トポロジ。WebCenter PortalまたはPortal Frameworkアプリケーションとコンポーネントが2つのドメインに分かれています。

- 複合トポロジ。WebCenter PortalまたはPortal Frameworkアプリケーションとコンポーネントが複数のドメインに分かれています。

これら3つのトポロジにおける、WebCenter PortalまたはPortal Frameworkアプリケーション、ディスカッション、ワークリストおよびWSRPプロデューサに対する構成について説明します。これらの構成およびWebCenter Portal APIを使用するアプリケーションの保護手順は、次の各項で説明しています。

- 第36.1項「単純トポロジの場合のWS-Securityの構成」

- 第36.2項「標準トポロジの場合のWS-Securityの構成」

- 第36.3項「複合トポロジの場合のWS-Securityの構成」

- 第36.4項「WebCenter Portal Client APIを使用するアプリケーションに対するWS-Securityを使用したWebCenter Portalの保護」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

36.1 単純トポロジの場合のWS-Securityの構成

この項では、WebCenter PortalおよびPortal Frameworkアプリケーション、BPELサーバーおよびWSRPプロデューサが同一ドメインを共有するトポロジの場合にWS-Securityを構成する方法を説明します(図36-1)。

図36-1 単純構成の場合のWS-Security

単一ドメインの単純トポロジの場合にWS-Securityを構成する手順は、次の各項で説明しています。

- 第36.1.1項「単純トポロジの場合のWS-Securityの構成のロードマップ」

- 第36.1.2項「WebCenter Portalドメイン・キーストアの設定」

- 第36.1.3項「単純トポロジの場合のディスカッション・サーバーの構成」

- 第36.1.4項「単純トポロジの場合のコマンド・サマリー」

36.1.1 単純トポロジの場合のWS-Securityの構成のロードマップ

この項のフロー・チャート(図36-1)と表(表36-1)は、単一ドメインの単純トポロジでWS-Securityを構成するために必要な前提条件とタスクの概要を示しています。

図36-2 単純トポロジの場合のWS-Securityの構成

表36-1は、単純トポロジの場合にWS-Securityを構成するためのタスクとサブタスクを示しています。

表36-1 単純トポロジの場合のWS-Securityの構成

担当者

タスク

サブタスク

ノート

管理者

1. WebCenter Portalドメイン・キーストアの設定

1.a WebCenter Portalドメイン・キーストアの作成

1.b キーストアの構成

2. ディスカッション・サーバーの構成

2.a ディスカッション・エンドポイントの保護

2.b ディスカッション・サーバーの接続設定の構成

36.1.2 WebCenter Portalドメイン・キーストアの設定

Javaキーストア(JKS)を使用して、WebCenter Portalアプリケーション、ディスカッション・サーバー、BPELサーバーおよびWSRPプロデューサのセキュリティ資格証明を取得および管理できます。キーストアとは、使用可能な公開鍵および秘密鍵の情報を提供するファイルです。キーは、認証やデータ整合性など、様々な目的に使用されます。また、ユーザー証明書や、ピア証明書の検証に必要なトラスト・ポイントも、ウォレットまたはキーストアにセキュアに格納されます。JKSの詳細は、『Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。

この項には次のサブセクションが含まれます:

- 第36.1.2.1項「WebCenter Portalドメイン・キーストアの作成」

- 第36.1.2.2項「WLSTを使用したキーストアの構成」

- 第36.1.2.3項「Fusion Middleware Controlを使用したキーストアの構成」

36.1.2.1 WebCenter Portalドメイン・キーストアの作成

この項では、Javaキーストア(JKS)を使用してキーストアおよびキーを作成する方法について説明します。JKSは、Sun Microsystemsにより定義された独自仕様のキーストア形式です。JKSでキーおよび証明書を作成して管理するには、Java JDK 6とともに配布されるkeytoolユーティリティを使用します。

WebCenter Portalドメイン・キーストアを作成するには:

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、キー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias orakey
-keypass key_password -keystore keystore -storepass keystore_password -validity days_valid

ここで:

- consumer_dnameは、コンシューマの名前です。これには適切な形式であるかぎり、任意の文字列を指定できます(例: cn=spaces,dc=example,dc=com)。

- key_passwordは、新規公開鍵のパスワードです(例: MyPassword)。

- keystoreは、キーストア名です(例: default-keystore.jks)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例36-1 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=spaces,dc=example,dc=com" -alias orakey
-keypass MyPassword -keystore default-keystore.jks -storepass MyPassword -validity 1064

注意:
キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle Web Services Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

3. 公開鍵が含まれる証明書をエクスポートします。

keytool -exportcert -v -alias orakey -keystore keystore -storepass
keystore_password -rfc -file orakey.cer

ここで:

- keystoreは、キーストア名です(例: default-keystore.jks)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-2 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias orakey -keystore default-keystore.jks -storepass MyPassword -rfc -file orakey.cer

4. 証明書を別名webcenter_spaces_wsでインポートします(別名がorakeyの既存の証明書を上書きするかどうかを尋ねられたら「Yes」を選択します)。

keytool -importcert -alias webcenter_spaces_ws -file orakey.cer
-keystore default-keystore.jks -storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです。

例36-3 証明書のインポート

keytool -importcert -alias webcenter_spaces_ws -file orakey.cer -keystore
default-keystore.jks -storepass MyPassword

5. 第36.1.2.2項「WLSTを使用したキーストアの構成」で説明しているようにWLSTを使用して、または第36.1.2.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明しているようにFusion Middleware Controlを使用して、キーストアを構成し、続行します。
表36-2は、キーストアの作成および構成後に確認する必要のあるキーストアのコンテンツを示しています。

表36-2 単純トポロジの場合のPortalドメイン・キーストアのコンテンツ

キーの別名

説明

orakey

WebCenter Portalからのアウトバウンド・メッセージの署名と暗号化に使用されるキー・ペアです。このキーは、OWSM (ポートレットおよびワークリスト)とディスカッションの両方で使用されます。

webcenter_spaces_ws

WebCenter Portalドメインで使用されるorakey秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、WebCenter Portalドメイン内のBPEL Server1にあるワークフロー・アプリケーションから、WebCenter PortalドメインのWebサービスAPIへのアウトバウンドWebサービス・メッセージの暗号化に使用されます。

36.1.2.2 WLSTを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第36.1.2.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明されているとおりにFusion Middleware Controlを使用して、または次の説明のとおりにWLSTを使用して実行できます。

資格証明ストアを構成するには:

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

<serviceInstance name="keystore" provider="keystore.provider" location="./default-keystore.jks">
<description>Default JPS Keystore Service</description>

3. default-keystore.jksキーストア・ファイルが、<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされており、locationとして./default-keystore.jksが指定されていることを確認します。

<serviceInstance name="keystore" provider="keystore.provider" location="./default-keystore.jks">
<description>Default JPS Keystore Service</description>

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password=keystore_password, desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="orakey", password=private_key_password, desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="orakey", password=private_key_password, desc="Signing key")

ここで:

- keystore_passwordは、第36.1.2.1項「WebCenter Portalドメイン・キーストアの作成」の手順2で指定したキーストア・パスワードです(例: MyPassword)。

- private_key_passwordは、第36.1.2.1項「WebCenter Portalドメイン・キーストアの作成」の手順2で指定した秘密鍵パスワードです(例: MyPassword)。

例36-4 資格証明ストアの更新

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="orakey", password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="orakey", password="MyPassword", desc="Signing key")

5. すべてのサーバーを再起動します。

36.1.2.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第36.1.2.2項「WLSTを使用したキーストアの構成」で説明されているとおりにWLSTを使用して、または次の説明のとおりにFusion Middleware Controlを使用して実行できます。

キーストア・プロバイダを構成するには:

1. default-keystore.jksキーストア・ファイルが、<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認して、locationとして./default-keystore.jksを指定します。

2. Fusion Middleware Controlを開き、WebCenter Portalドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

3. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、WebCenter Portalドメイン(デフォルトではwc_domain)をクリックします。

4. 「WebLogicドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。
「セキュリティ・プロバイダ構成」ページが表示されます。

5. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

6. 「構成」をクリックします。
「キー・ストアの構成」ページが表示されます。

7. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./default-keystore.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: orakey

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: orakey

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

8. 「OK」をクリックして、設定を保存します。

9. ドメインの管理サーバーを再起動します。

36.1.3 単純トポロジの場合のディスカッション・サーバーの構成

単純トポロジでは、ディスカッション・サーバーはWC_Spacesサーバーと同じドメインにあるため、追加のキーストア構成は必要ありません。これは、WebCenter Portalドメインに構成されているキーストアがディスカッションでも使用されるからです。ただし、本番環境では、ディスカッションのWebサービス・エンドポイントをOWSMポリシーで保護し、ディスカッション・サーバー接続設定を構成する必要があります。それらの設定手順は、次の各項で説明します。

- 第36.1.3.1項「WebCenter PortalおよびディスカッションWebサービス・エンドポイントに対するセキュリティ・ポリシーの添付」

- 第36.1.3.2項「ディスカッション・エンドポイントの保護」

- 第36.1.3.3項「ディスカッション・サーバーの接続設定の構成」

注意:
WebCenter PortalおよびPortal Frameworkアプリケーションからディスカッション・サーバーに送信されるディスカッション固有のWebサービス・メッセージは暗号化されません。メッセージの機密保護のため、Secure Socket Layer (SSL)を介してディスカッション・サーバーのURLにアクセスする必要があります。詳細は、第35章「SSLの構成」を参照してください。

36.1.3.1 WebCenter PortalおよびディスカッションWebサービス・エンドポイントに対するセキュリティ・ポリシーの添付

新規またはパッチ適用済のWebCenter Portalインスタンスでは、割り当てられたセキュリティ/ポリシーの構成は、セキュリティ・ポリシーなしに設定されます。Oracle Web Services Manager (OWSM)のセキュリティ・ポリシーを、WebCenter PortalのWebサービス・エンドポイントおよびディスカッションの認証Webサービス・エンドポイントに添付する必要があります。本番環境では、第36.1.3.2項「ディスカッション・エンドポイントの保護」の手順に従って、セキュリティを強化することで続行します。

注意:
パッチが適用されるWebCenter Portalインスタンスでは、パッチを適用する前にポリシー名を決定し、パッチを適用した後にポリシーを添付する必要があります。必要な手順は、パッチ適用ガイドのOracle WebCenter Portalへのパッチ適用に関する項を参照してください。

Webサービス・セキュリティ・ポリシー構成を新しいインスタンスに添付する手順は次のとおりです。

注意:
クラスタ化環境では、WebCenter Portalおよびディスカッションがデプロイされている管理対象サーバーごとにこれらの手順を繰り返します。

1. WC_SpacesおよびWC_Collaboration管理対象サーバーが実行中であることを確認します。

2. 次のWLSTコマンドを実行して、OWSMポリシーをWebCenter Portal Webサービス・エンドポイントに添付します。

attachWebServicePolicy(application='webcenter', moduleName='webcenter',
moduleType='web', serviceName='SpacesWebService',
subjectName='SpacesWebServiceSoapHttpPort',
policyURI='oracle/wss11_saml_token_with_message_protection_service_policy')

3. 次のWLSTコマンドを実行して、OWSMポリシーをディスカッションWebサービス・エンドポイントに添付します。

attachWebServicePolicy(application='owc_discussions',
moduleName='owc_discussions', moduleType='web',
serviceName='OWCDiscussionsServiceAuthenticated',
subjectName='OWCDiscussionsServiceAuthenticated',
policyURI='oracle/wss10_saml_token_service_policy')

4. WC_SpacesおよびWC_Collaboration管理対象サーバーを再起動します。

36.1.3.2 ディスカッション・エンドポイントの保護

ディスカッションのWebサービス・エンドポイントでは、WebCenter Portalから発信されるコールに対してユーザー・アイデンティティを伝播する必要があります。本番環境では、転送中に他者がメッセージを改ざんしたり、表示したりできないように、Webサービス・エンドポイントをOWSMポリシーで保護する必要があります。これを実行するには、パブリック・アクセス用のWebサービス・エンドポイントと認証済ユーザー・アクセス用のエンドポイントの両方を、Fusion Middleware ControlまたはWLSTを使用して適切なOWSMポリシーで保護する必要があります。

この項には次のサブセクションが含まれます:

- 第36.1.3.2.1項「Fusion Middleware Controlを使用したディスカッション・サーバー・エンドポイントの保護」

- 第36.1.3.2.2項「WLSTを使用したディスカッション・サーバー・エンドポイントの保護」

36.1.3.2.1 Fusion Middleware Controlを使用したディスカッション・サーバー・エンドポイントの保護

Fusion Middleware Controlを使用してディスカッション・エンドポイントを保護する手順は次のとおりです。

1. Fusion Middleware Controlにログインして、ナビゲーション・ペインから、「WebCenter」→「ポータル」→「ディスカッション」を開いて、Discussions(WC_Collaboration)をクリックします。
「ディスカッション」ホームページが表示されます(図36-3を参照)。

図36-3 「ディスカッション」ホームページ

2. owc_discussionsターゲットをクリックします。
owc_discussionsアプリケーションのホームページが表示されます(図36-4を参照)。

図36-4 owc_discussionsのホームページ

3. 「アプリケーションのデプロイ」メニューから、「Webサービス」を選択します。
owc_discussionsアプリケーションの「Webサービス」ページが表示されます(図36-5を参照)。

図36-5 owc_discussionsの「Webサービス」ページ

4. 「Webサービス」タブを開き、OWCDiscussionsServiceAuthenticated Webサービス・エンドポイントをクリックします。
owc_discussionsの「Webサービス・エンドポイント」ページが表示されます(図36-6を参照)。

図36-6 「Webサービス・エンドポイント」ページ

5. 「アタッチ/デタッチ」をクリックします。
「ポリシーの添付」ページが表示されます(図36-7を参照)。

図36-7 「ポリシーの添付」ページ

6. 「アタッチ」ボタンと「デタッチ」ボタンを使用して、oracle/wss11_saml_token_with_message_protection_service_policyを添付し、oracle/wss10_saml_token_service_policyを削除します。

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

36.1.3.2.2 WLSTを使用したディスカッション・サーバー・エンドポイントの保護

WLSTを使用してディスカッション・サーバー・エンドポイントを保護するには、次のWLSTコマンドを使用して、wss10_saml_token_service_policyを削除し、wss11_saml_token_with_message_protection_service_policyを添付します。

detachWebServicePolicy(application='owc_discussions', moduleName='owc_discussions', moduleType='web',
serviceName='OWCDiscussionsServiceAuthenticated', subjectName='OWCDiscussionsServiceAuthenticated',
policyURI='oracle/wss10_saml_token_service_policy')

attachWebServicePolicy(application='owc_discussions', moduleName='owc_discussions', moduleType='web',
serviceName='OWCDiscussionsServiceAuthenticated', subjectName='OWCDiscussionsServiceAuthenticated',
policyURI='oracle/wss11_saml_token_with_message_protection_service_policy')

36.1.3.3 ディスカッション・サーバーの接続設定の構成

第12.3項「ディスカッション・サーバーの登録」で説明しているように、使用しているWebCenter PortalまたはPortal Frameworkアプリケーションに構成されているディスカッション・サーバーの接続にWS-Securityクライアント証明書情報を指定する必要があります。 図36-8は、「ディスカッションおよびお知らせ接続の編集」ページの接続詳細設定の例を示しています。

図36-8 「ディスカッションおよびお知らせ接続の編集」ページ

36.1.4 単純トポロジの場合のコマンド・サマリー

単純トポロジの場合にキーストアを迅速に構成するには、次のコマンド・サマリーを使用します。

キーストアの生成

次のkeytoolコマンドを使用して、キーストアを生成し、太字で示した値をローカル環境の値に置き換えます。

keytool -genkeypair -keyalg RSA -dname "cn=spaces,dc=example,dc=com" -alias orakey
-keypass MyPassword -keystore default-keystore.jks -storepass MyPassword -validity 1064

keytool -exportcert -v -alias orakey -keystore default-keystore.jks -storepass MyPassword -rfc -file orakey.cer

keytool -importcert -alias webcenter_spaces_ws -file orakey.cer
-keystore default-keystore.jks -storepass MyPassword

証明書がすでに存在することを伝えるプロンプトが表示されたら、yesと答えます。

keytool -importcert -alias df_orakey_public -file orakey.cer
-keystore owc_discussions.jks -storepass MyPassword

default-keystore.jksファイルをdomain_home/config/fmwconfigディレクトリにコピーします。

キーストアの構成

WLSTを使用して、管理者としてWebCenter Portalドメインに接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="orakey", password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="orakey", password="MyPassword", desc="Signing key")

36.2 標準トポロジの場合のWS-Securityの構成

この項では、WebCenter PortalアプリケーションとWSRPプロデューサは同一ドメインを共有しているが、BPELサーバーは外部ドメイン(SOAドメイン)に配置されているトポロジの場合にWS-Securityを構成する方法を説明します(図36-9を参照)。

図36-9 標準構成の場合のWS-Security

標準の2つのドメイン・トポロジの場合にWS-Securityを構成する手順は、次の各項で説明しています。

- 第36.2.1項「標準トポロジの場合のWS-Securityの構成のロードマップ」

- 第36.2.2項「WebCenter Portalドメイン・キーストアの設定」

- 第36.2.3項「標準トポロジの場合のディスカッション・サーバーの構成」

- 第36.2.4項「SOAドメインの設定」

- 第36.2.5項「標準トポロジの場合のコマンド・サマリー」

36.2.1 標準トポロジの場合のWS-Securityの構成のロードマップ

この項のフロー・チャート(図36-10)と表(表36-3)は、標準の2つのドメイン・トポロジでWS-Securityを構成するために必要な前提条件とタスクの概要を示しています。

図36-10 標準トポロジの場合のWS-Securityの構成

表36-3は、標準の2つのドメイン・トポロジの場合にWS-Securityを構成するためのタスクとサブタスクを示しています。

表36-3 標準トポロジの場合のWS-Securityの構成

担当者

タスク

サブタスク

ノート

管理者

1. WebCenter Portalドメイン・キーストアの設定

1.a WebCenter Portalドメイン・キーストアの作成

1.b キーストアの構成

2. ディスカッション・サーバーの構成

2.a ディスカッション・エンドポイントの保護

2.b ディスカッション・サーバーの接続設定の構成

36.2.2 WebCenter Portalドメイン・キーストアの設定

Javaキーストア(JKS)を使用して、WebCenter Portalアプリケーション、ディスカッション・サーバー、BPELサーバー(別のドメイン内)およびWSRPプロデューサのセキュリティ資格証明を取得および管理できます。キーストアとは、使用可能な公開鍵および秘密鍵の情報を提供するファイルです。キーは、認証やデータ整合性など、様々な目的に使用されます。また、ユーザー証明書や、ピア証明書の検証に必要なトラスト・ポイントも、ウォレットまたはキーストアにセキュアに格納されます。JKSの詳細は、『Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。

この項には次のサブセクションが含まれます:

- 第36.2.2.1項「WebCenter Portalドメイン・キーストアの作成」

- 第36.2.2.2項「WLSTを使用したキーストアの構成」

- 第36.2.2.3項「Fusion Middleware Controlを使用したキーストアの構成」

36.2.2.1 WebCenter Portalドメイン・キーストアの作成

この項では、Javaキーストア(JKS)を使用してキーストアおよびキーを作成する方法について説明します。JKSは、Sun Microsystemsにより定義された独自仕様のキーストア形式です。JKSでキーおよび証明書を作成して管理するには、Java JDK 6とともに配布されるkeytoolユーティリティを使用します。

WebCenter Portalドメイン・キーストアを作成するには:

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、キー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias webcenter -keypass key_password -keystore keystore -storepass keystore_password -validity days_valid

ここで:

- consumer_dnameは、コンシューマの名前です(例: cn=spaces,dc=example,dc=com)。

- key_passwordは、新規公開鍵のパスワードです(例: MyPassword)。

- keystoreは、キーストア名です(例: webcenter.jks)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例36-5 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=spaces,dc=example,dc=com" -alias
webcenter -keypass MyPassword -keystore webcenter.jks -storepass MyPassword
-validity 1064

注意:
キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle Web Services Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

3. 公開鍵が含まれる証明書をエクスポートします。

keytool -exportcert -v -alias webcenter -keystore keystore
-storepass keystore_password -rfc -file webcenter_public.cer

ここで:

- keystoreは、キーストア名です(例: webcenter.jks)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-6 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias webcenter -keystore webcenter.jks
-storepass MyPassword -rfc -file webcenter_public.cer

4. 第36.2.2.2項「WLSTを使用したキーストアの構成」で説明しているようにWLSTを使用して、または第36.2.2.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明しているようにFusion Middleware Controlを使用して、キーストアを構成し、続行します。
表36-4は、キーストアの作成および構成後に確認する必要のあるキーストアのコンテンツを示しています。

表36-4 標準トポロジの場合のWebCenter Portalドメイン・キーストアのコンテンツ

キーの別名

説明

webcenter

WebCenter Portalからのアウトバウンド・メッセージの署名と暗号化に使用されるキー・ペアです。このキーは、OWSM (ポートレットおよびワークリスト)とディスカッションの両方で使用されます。

orakey

SOAドメインで使用されるBPEL秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、WebCenter Portalドメイン内のBPEL Server1にあるワークフロー・アプリケーションから、SOAドメインのSOAサーバーに対するワークリスト・コンポーネントへのアウトバウンドWebサービス・メッセージの暗号化に使用されます。

36.2.2.2 WLSTを使用したキーストアの構成

WebCenter Portalドメイン・キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第36.2.2.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明されているとおりにFusion Middleware Controlを使用して、または次の説明のとおりにWLSTを使用して実行できます。

キーストア・サービスを構成するには:

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

3. webcenter.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認し、locationとして./webcenter.jksを指定します。

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password=keystore_password, desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="webcenter", password=private_key_password, desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="webcenter", password=private_key_password, desc="Signing key")

ここで:

- keystore_passwordは、第36.2.2.1項「WebCenter Portalドメイン・キーストアの作成」の手順2で指定したキーストア・パスワードです(例: MyPassword)。

- private_key_passwordは、第36.2.2.1項「WebCenter Portalドメイン・キーストアの作成」の手順2で指定した秘密鍵パスワードです(例: MyPassword)。

例36-7 資格証明ストアの更新

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="webcenter", password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="webcenter", password="MyPassword", desc="Signing key")

5. すべてのサーバーを再起動します。

36.2.2.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第36.2.2.2項「WLSTを使用したキーストアの構成」で説明されているとおりにWLSTを使用して、または次の説明のとおりにFusion Middleware Controlを使用して実行できます。

キーストア・プロバイダを構成するには:

1. Fusion Middleware Controlを開き、WebCenter Portalドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、WebCenter Portalドメイン(デフォルトではwc_domain)をクリックします。

3. 「WebLogicドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。
「セキュリティ・プロバイダ構成」ページが表示されます。

4. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

5. 「構成」をクリックします。
「キー・ストアの構成」ページが表示されます。

6. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./webcenter.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: webcenter

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: webcenter

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

7. 「OK」をクリックして、設定を保存します。

8. ドメインの管理サーバーを再起動します。

36.2.3 標準トポロジの場合のディスカッション・サーバーの構成

標準トポロジの場合のディスカッション・サーバーの構成は、単純トポロジの場合とまったく同じです。詳細は、第36.1.3項「単純トポロジの場合のディスカッション・サーバーの構成」を参照してください。

36.2.4 SOAドメインの設定

この項では、SOAドメイン・キーストアの設定方法について説明します。この項の内容は次のとおりです。

- 第36.2.4.1項「SOAドメイン・キーストアの作成」

- 第36.2.4.2項「WLSTを使用したキーストアの構成」

- 第36.2.4.3項「Fusion Middleware Controlを使用したキーストアの構成」

36.2.4.1 SOAドメイン・キーストアの作成

この項では、Javaキーストア(JKS)を使用してSOAドメイン・キーストアおよびキーを作成する方法について説明します。

SOAドメイン・キーストアを作成するには:

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. WebCenter Portalドメインから公開証明書(webcenter_public.cer)をインポートして、キーストアを作成します。

keytool -importcert -alias webcenter_spaces_ws -file webcenter_public.cer
-keystore bpel.jks -storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

- 例36-8 公開証明書のインポート

keytool -importcert -alias webcenter_spaces_ws -file webcenter_public.cer
-keystore bpel.jks -storepass MyPassword

3. keytoolを使用して、メッセージの署名と暗号化のためにSOAドメインで使用するキーペアを作成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias bpel
-keypass key_password -keystore keystore -storepass keystore_password
-validity days_valid

ここで:

- consumer_dnameは、コンシューマの名前です(例: cn=bpel,dc=example,dc=com)。

- key_passwordは、新規公開鍵のパスワードです(例: MyPassword)。

- keystoreは、キーストアの名前です(例: bpel.jks)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例36-9 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=bpel,dc=example,dc=com" -alias bpel
-keypass MyPassword -keystore bpel.jks -storepass MyPassword -validity 1064

注意:
キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle Web Services Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

4. 別名orakeyを使用してWebCenter Portalドメインにインポートできるように証明書をエクスポートします。

keytool -exportcert -v -alias bpel -keystore keystore -storepass keystore_password -rfc -file orakey.cer

ここで:

- keystoreは、キーストア名です(例: webcenter.jks)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-10 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias bpel -keystore bpel.jks -storepass MyPassword -rfc -file orakay.cer

5. 異なる別名で証明書をインポートします(別名がorakeyの既存の証明書を上書きするかどうかを尋ねられたら「Yes」を選択します)。

keytool -importcert -alias orakey -file orakey.cer -keystore webcenter.jks
-storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです。

例36-11 証明書のインポート

keytool -importcert -alias orakey -file orakay.cer -keystore webcenter.jks -storepass MyPassword

36.2.4.2 WLSTを使用したキーストアの構成

SOAドメイン・キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第36.2.4.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明されているとおりにFusion Middleware Controlを使用して、または次の説明のとおりにWLSTを使用して実行できます。

キーストア・サービスを構成するには:

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

3. bpel.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認し、locationとして./bpel.jksを指定します。

4. 次のWLSTコマンドを使用して、資格証明ストアを構成します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="bpel", password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="bpel", password="MyPassword", desc="Signing key")

5. すべてのサーバーを再起動します。

36.2.4.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第36.2.4.2項「WLSTを使用したキーストアの構成」で説明されているとおりにWLSTを使用して、または次の説明のとおりにFusion Middleware Controlを使用して実行できます。

キーストア・プロバイダを構成するには:

1. Fusion Middleware Controlを開き、SOAドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、SOAドメインをクリックします。

3. 「WebLogicドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。

4. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

5. 「構成」をクリックします。
「キー・ストアの構成」ページが表示されます。

6. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./bpel.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: bpel

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: bpel

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

7. 「OK」をクリックして、設定を保存します。

8. ドメインの管理サーバーを再起動します。

36.2.5 標準トポロジの場合のコマンド・サマリー

標準トポロジの場合にキーストアを迅速に構成するには、次のコマンド・サマリーを使用します。

キーストアの生成

次のkeytoolコマンドを使用して、キーストアを生成し、太字で示した値をローカル環境の値に置き換えます。

keytool -genkeypair -keyalg RSA -dname "cn=spaces,dc=example,dc=com" -alias
webcenter -keypass MyPassword -keystore webcenter.jks -storepass MyPassword -validity 1064

keytool -exportcert -v -alias webcenter -keystore webcenter.jks
-storepass MyPassword -rfc -file webcenter_public.cer

keytool -importcert -alias webcenter_spaces_ws -file webcenter_public.cer
-keystore bpel.jks -storepass MyPassword

証明書がすでに存在することを伝えるプロンプトが表示されたら、yesと答えます。

keytool -genkeypair -keyalg RSA -dname "cn=bpel,dc=example,dc=com" -alias bpel
-keypass MyPassword -keystore bpel.jks -storepass MyPassword -validity 1024

keytool -exportcert -v -alias bpel -keystore bpel.jks -storepass MyPassword
-rfc -file orakay.cer

keytool -importcert -alias orakey -file orakay.cer -keystore webcenter.jks
-storepass MyPassword

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -importcert -alias df_webcenter_public -file webcenter_public.cer
-keystore owc_discussions.jks -storepass MyPassword

証明書を信頼するかを尋ねられたら、yesと答えます。

webcenter.jksファイルをdomain_home/config/fmwconfigディレクトリにコピーし、bpel.jksファイルをsoa_domain_home/config/fmwconfigディレクトリにコピーします。

WebCenter Portalドメイン・キーストアの構成

次の手順に従って、WebCenter Portalドメインのサービス・インスタンス参照を構成します。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動します。

2. まだ実行していない場合は、webcenter.jksを<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

3. エディタでjps-config.xmlを開きます。

4. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

5. locationとして./webcenter.jksを指定します。

6. WLSTを使用して、WebCenter Portalドメインに管理ユーザーとして接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="webcenter", password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="webcenter", password="MyPassword", desc="Signing key")

SOAドメイン・キーストアの構成

次の手順に従って、SOAドメインのサービス・インスタンス参照を構成します。

1. <SOA_DOMAIN_HOME>/config/fmwconfigディレクトリにナビゲートします。

2. まだ実行していない場合は、bpel.jksを<SOA_DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

3. エディタでjps-config.xmlを開きます。

4. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

5. locationとして./bpel.jksを指定します。

6. WLSTを使用して、SOAドメインに管理ユーザーとして接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="bpel", password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="bpel", password="MyPassword", desc="Signing key")

36.3 複合トポロジの場合のWS-Securityの構成

この項では、WebCenter Portalアプリケーション、ディスカッション・サーバーおよびWSRPプロデューサが同一ドメインにあり、2つのBPELサーバーが別々のSOAドメインにあり、1つのWSRPプロデューサが外部ポートレット・ドメインにある複合トポロジの場合にWS-Securityを構成する方法を説明します(図36-11を参照)。

図36-11 複合構成の場合のWS-Security

複数のドメインが含まれる複合トポロジの場合にWS-Securityを構成する手順は、次の各項で説明しています。

- 第36.3.1項「複合トポロジの場合のWS-Securityの構成のロードマップ」

- 第36.3.2項「WebCenter Portalドメイン・キーストアの設定」

- 第36.3.3項「複合トポロジの場合のディスカッション・サーバーの構成」

- 第36.3.4項「1つ目のSOAドメインの設定」

- 第36.3.5項「2つ目のSOAドメインの設定」

- 第36.3.6項「外部ポートレット・ドメイン・キーストアの設定」

- 第36.3.7項「外部WebCenterドメイン・キーストアの設定」

- 第36.3.8項「複合トポロジの場合のコマンド・サマリー」

36.3.1 複合トポロジの場合のWS-Securityの構成のロードマップ

この項のフロー・チャート(図36-12)と表(表36-5)は、複数ドメインの複合トポロジでWS-Securityを構成するために必要な前提条件とタスクの概要を示しています。

図36-12 複合トポロジの場合のWS-Securityの構成

表36-5は、複合トポロジの場合にWS-Securityを構成するためのタスクとサブタスクを示しています。

表36-5 複合トポロジの場合のWS-Securityの構成

担当者

タスク

サブタスク

ノート

管理者

1. WebCenter Portalドメイン・キーストアの設定

1.a WebCenter Portalドメイン・キーストアの作成

1.b キーストアの構成

.

2. ディスカッション・サーバーの構成

2.a ディスカッション・エンドポイントの保護

2.b ディスカッション・サーバー・キーストアの作成

2.c 資格証明ストアの更新

2.d ディスカッション・サーバー接続の構成

.

3. 1つ目のSOAドメインの設定

3.a 1つ目のSOAドメイン・キーストアの作成

3.b 1つ目のSOAドメイン・キーストアの構成

4. 2つ目のSOAドメインの設定

4.a 2つ目のSOAドメイン・キーストアの作成

4.b 2つ目のSOAドメイン・キーストアの構成

4.c ワークリスト接続の構成

5. 外部ポートレット・ドメイン・キーストアの設定

5.a 外部ポートレット・ドメイン・キーストアの作成

5.b 外部ポートレット・ドメイン・キーストアの構成

6. 外部WebCenterドメイン・キーストアの設定

6.a 外部WebCenterドメイン・キーストアの作成

6.b Portal Frameworkアプリケーションの外部ドメイン・キーストアの構成

36.3.2 WebCenter Portalドメイン・キーストアの設定

Javaキーストア(JKS)を使用して、WebCenter Portal、ディスカッション・サーバー、BPELサーバー(別のドメイン内)およびWSRPプロデューサ(これも別のドメイン内)のセキュリティ資格証明を取得および管理できます。キーストアとは、使用可能な公開鍵および秘密鍵の情報を提供するファイルです。キーは、認証やデータ整合性など、様々な目的に使用されます。また、ユーザー証明書や、ピア証明書の検証に必要なトラスト・ポイントも、ウォレットまたはキーストアにセキュアに格納されます。JKSの詳細は、『Webサービスのためのセキュリティおよび管理者ガイド』を参照してください。

この項には次のサブセクションが含まれます:

- 第36.3.2.1項「WebCenter PortalドメインおよびFrameworkキーストアの作成」

- 第36.3.2.2項「WLSTを使用したキーストアの構成」

- 第36.3.2.3項「Fusion Middleware Controlを使用したキーストアの構成」

36.3.2.1 WebCenter PortalドメインおよびFrameworkキーストアの作成

この項では、Javaキーストア(JKS)を使用してキーストアおよびキーを作成する方法について説明します。JKSは、Sun Microsystemsにより定義された独自仕様のキーストア形式です。JKSでキーおよび証明書を作成して管理するには、Java JDK 6とともに配布されるkeytoolユーティリティを使用します。

WebCenter PortalドメインおよびFrameworkキーストアを作成するには:

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、webcenterキーストアにキー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias webcenter
-keypass key_password -keystore keystore -storepass keystore_password -validity days_valid

ここで:

- consumer_dnameは、コンシューマの名前です(例: cn=spaces,dc=example,dc=com)。

- key_passwordは、新規公開鍵のパスワードです(例: MyPassword)。

- keystoreは、キーストア名です(例: webcenter.jks)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例36-12 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=spaces,dc=example,dc=com" -alias webcenter -keypass MyPassword -keystore webcenter.jks -storepass MyPassword -validity 1064

注意:
キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle Web Services Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

3. 公開鍵が含まれる証明書をエクスポートします。

keytool -exportcert -v -alias webcenter -keystore wecenter.jks
-storepass keystore_password -rfc -file webcenter_public.cer

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-13 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias webcenter -keystore webcenter.jks
-storepass MyPassword -rfc -file webcenter_public.cer

4. orakey証明書をインポートします。

keytool -importcert -alias orakey -file orakey.cer -keystore webcenter.jks
-storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-14 orakey証明書のインポート

keytool -importcert -alias orakey -file orakey.cer -keystore webcenter.jks -storepass MyPassword

5. 第36.3.2.2項「WLSTを使用したキーストアの構成」で説明しているようにWLSTを使用して、または第36.3.2.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明しているようにFusion Middleware Controlを使用して、キーストアを構成し、続行します。
表36-6は、キーストアの作成および構成後に確認する必要のあるキーストアのコンテンツを示しています。

表36-6 複合トポロジの場合のWebCenter Portalドメイン・キーストアのコンテンツ

キーの別名

説明

webcenter

WebCenter Portalからのアウトバウンド・メッセージの署名と暗号化に使用されるキー・ペアです。このキーは、OWSM (ポートレットおよびワークリスト)とディスカッションの両方で使用されます。

orakey

SOA 1ドメインで使用されるBPEL秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、ワークリスト・コンポーネントからSOA 1ドメイン内のSOA_Server3へのアウトバウンド・メッセージの暗号化に使用されます。

soa_server3_public_key

SOA 2ドメインで使用されるsoa_server3秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、ワークリスト・コンポーネントからSOA 2ドメイン内のBPEL Server2へのアウトバウンド・メッセージの暗号化に使用されます。

producer_public_key

WSRPプロデューサ1アプリケーションをホストする外部ポートレット・ドメインで使用されるプロデューサ秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、WebCenter PortalからWebCenter Portalアプリケーションに登録されているWSRPプロデューサ1へのアウトバウンド・メッセージの暗号化に使用されます。

external_webcenter_custom_public_key

WebCenter Portal Webサービスに対してWebサービス・コールを行うPortal Frameworkアプリケーションをホストする外部WebCenterドメインで使用されるexternal_webcenter_custom秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、WebCenter Portalから外部WebCenterドメイン内のPortal Frameworkアプリケーションへのアウトバウンド・メッセージの暗号化に使用されます。

owc_discussions_public

ディスカッションをホストする外部ディスカッション・ドメインで使用される外部owc_discussions秘密鍵に対応する公開鍵が含まれる証明書です。この証明書はディスカッションWebサービスに対してWebサービス・コールを行うWebCenter PortalおよびPortal Frameworkアプリケーションによって使用されます。

36.3.2.2 WLSTを使用したキーストアの構成

WebCenter Portalドメイン・キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。

キーストア・サービスを構成するには:

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

3. webcenter.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認し、locationとして./webcenter.jksを指定します。

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="webcenter", password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="webcenter", password="MyPassword", desc="Signing key")

5. すべてのサーバーを再起動します。

36.3.2.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。

キーストア・プロバイダを構成するには:

1. Fusion Middleware Controlを開き、WebCenter Portalドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、WebCenter Portalドメイン(デフォルトではwc_domain)をクリックします。

3. 「WebLogicドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。
「セキュリティ・プロバイダ構成」ページが表示されます(図36-13を参照)。

図36-13 「セキュリティ・プロバイダ構成」ページ

4. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

5. 「構成」をクリックします。
「キーストアの構成」ページが表示されます(図36-14を参照)。

図36-14 「キーストアの構成」ページ

6. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./webcenter.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: webcenter

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: webcenter

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

7. 「OK」をクリックして、設定を保存します。

8. ドメインの管理サーバーを再起動します。

36.3.3 複合トポロジの場合のディスカッション・サーバーの構成

複合トポロジでは、ディスカッション・サーバーはWebCenter Portalとは異なるドメインにあるため、ディスカッション・サーバーにキーストアを作成して構成し、公開鍵が含まれる証明書をエクスポートして、それをWebCenter Portalドメインにインポートする必要があります。本番環境では、ディスカッションのWebサービス・エンドポイントをOWSMポリシーで保護し、ディスカッション・サーバー接続設定を構成する必要もあります。それらの設定手順は、次の各項で説明します。

- 第36.3.3.1項「ディスカッション・サービス・エンドポイントの保護」

- 第36.3.3.2項「ディスカッション・サーバー・キーストアの作成」

- 第36.3.3.3項「資格証明ストアの更新」

- 第36.3.3.4項「ディスカッション・サーバーの接続設定の構成」

注意:
Portal Frameworkアプリケーションからディスカッション・サーバーに送信されるディスカッション固有のWebサービス・メッセージは暗号化されません。メッセージの機密保護のため、Secure Socket Layer (SSL)を介してディスカッション・サーバーのURLにアクセスする必要があります。詳細は、第35章「SSLの構成」を参照してください。

36.3.3.1 ディスカッション・サービス・エンドポイントの保護

ディスカッションのWebサービス・エンドポイントでは、WebCenter Portalから発信されるコールに対してユーザー・アイデンティティを伝播する必要があります。第36.1.3.2項「ディスカッション・エンドポイントの保護」の手順に従い、Fusion Middleware ControlまたはWLSTを使用してこれらのエンドポイントを保護します。

36.3.3.2 ディスカッション・サーバー・キーストアの作成

この項では、OWSMで使用されるキー・ペアが含まれるキーストアをディスカッション・サーバーに作成し、公開鍵が含まれる証明書をエクスポートして、それをWebCenter Portalドメインにインポートできるようにする方法を説明します。

owc_discussionsキーストアを作成するには:

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、owc_discussionsキーストアにキー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias owc_discussions
-keypass key_password -keystore keystore -storepass keystore_password -validity
days_valid

ここで:

- consumer_dnameは、コンシューマの名前です(例: cn=owc_discussions,dc=example,dc=com)。

- key_passwordは、新規公開鍵のパスワードです(例: MyPassword)。

- keystoreは、キーストア名です(例: owc_discussions.jks)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例36-15 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=owc_discussions,dc=example,dc=com"
-alias owc_discussions -keypass MyPassword -keystore owc_discussions.jks
-storepass MyPassword -validity 1064

注意:
キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle Web Services Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

3. 公開鍵が含まれる証明書をエクスポートします。

keytool -exportcert -v -alias owc_discussions -keystore owc_discussions.jks
-storepass keystore_password -rfc -file owc_discussions_public.cer

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-16 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias owc_discussions -keystore owc_discussions.jks
-storepass MyPassword -rfc -file owc_discussions_public.cer

4. webcenter_public証明書をインポートします。

keytool -importcert -alias webcenter_public -file webcenter_public.cer
-keystore owc_discussions.jks -storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-17 webcenter_public証明書のインポート

keytool -importcert -alias webcenter_public -file webcenter_public.cer -keystore
owc_discussions.jks -storepass MyPassword

5. owc_discussions_public証明書をインポートします。

keytool -importcert -alias owc_discussions_public -file
owc_discussions_public.cer -keystore webcenter.jks -storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-18 owc_discussions_public証明書のインポート

keytool -importcert -alias owc_discussions_public -file owc_discussions_public.cer
-keystore webcenter.jks -storepass MyPassword

6. 第36.3.3.3項「資格証明ストアの更新」で説明しているように、WLSTを使用して資格証明ストアを更新し、続行します。

36.3.3.3 資格証明ストアの更新

WebCenter Portalドメイン・キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。

キーストア・サービスを構成するには:

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

<!-- KeyStore Service Instance -->
<serviceInstance name="keystore" provider="keystore.provider" location="./default-keystore.jks">
<description>Default JPS Keystore Service</description>

3. webcenter.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認して、locationとして./webcenter.jksを指定します。

<serviceInstance name="keystore" provider="keystore.provider" location="./webcenter.jks">
<description>Default JPS Keystore Service</description>

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="owc_discussions", password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="owc_discussions", password="MyPassword", desc="Signing key")

5. すべてのサーバーを再起動します。

36.3.3.4 ディスカッション・サーバーの接続設定の構成

第12.3項「ディスカッション・サーバーの登録」で説明しているように、WebCenter Portalまたは使用しているPortal Frameworkアプリケーションに構成されているディスカッション・サーバーの接続にWS-Securityクライアント証明書情報を指定する必要があります。 図36-15は、「ディスカッションおよびお知らせ接続の編集」ページの接続詳細設定の例を示しています。

図36-15 「ディスカッションおよびお知らせ接続の編集」ページ

36.3.4 1つ目のSOAドメインの設定

この項では、SOAドメイン・キーストアの設定方法について説明します。この項の内容は次のとおりです。

- 第36.3.4.1項「SOAドメイン・キーストアの作成」

- 第36.3.4.2項「WLSTを使用したキーストアの構成」

- 第36.3.4.3項「Fusion Middleware Controlを使用したキーストアの構成」

36.3.4.1 SOAドメイン・キーストアの作成

この項では、Javaキーストア(JKS)を使用してSOAドメイン・キーストアおよびキーを作成する方法について説明します。

SOAドメイン・キーストアを作成するには:

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. WebCenter Portalドメインから公開証明書(webcenter_public.cer)をインポートして、キーストアを作成します。

keytool -importcert -alias webcenter_spaces_ws -file webcenter_public.cer
-keystore bpel.jks -storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

- 例36-19 公開証明書のインポート

keytool -importcert -alias webcenter_spaces_ws -file webcenter_public.cer -keystore bpel.jks -storepass MyPassword

3. keytoolを使用して、メッセージの署名と暗号化のためにSOAドメインで使用するキーペアを作成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias bpel -keypass
key_password -keystore bpel.jks -storepass keystore_password -validity days_valid

ここで:

- consumer_dnameは、コンシューマの名前です(例: cn=bpel,dc=example,dc=com)。

- key_passwordは、新規公開鍵のパスワードです(例: MyPassword)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例36-20 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=bpel,dc=example,dc=com" -alias bpel
-keypass MyPassword -keystore bpel.jks -storepass MyPassword -validity 1064

注意:
キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle Web Services Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

4. 別名orakeyを使用してWebCenter Portalドメインにインポートできるように証明書をエクスポートします。

keytool -exportcert -v -alias bpel -keystore bpel.jks -storepass keystore_password -rfc -file orakey.cer

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-21 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias bpel -keystore bpel.jks -storepass MyPassword -rfc -file orakay.cer

5. 再度WebCenter Portalドメインに、異なる別名で証明書をインポートします(別名がorakeyの既存の証明書を上書きするかどうかを尋ねられたら「Yes」を選択します)。

keytool -importcert -alias orakey -file orakey.cer -keystore webcenter.jks -storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-22 証明書のインポート

keytool -importcert -alias orakey -file orakay.cer -keystore webcenter.jks -storepass MyPassword

6. 証明書をSOAドメインにインポートします。

keytool -importcert -alias soa_server3_public_key -file soa_server3_public_key.cer
-keystore webcenter.jks -storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-23 証明書のインポート

keytool -importcert -alias soa_server3_public_key -file soa_server3_public_key.cer
-keystore webcenter.jks -storepass MyPassword

7. 第36.3.4.2項「WLSTを使用したキーストアの構成」で説明しているようにWLSTを使用して、または第36.3.4.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明しているようにFusion Middleware Controlを使用して、キーストアを構成し、続行します。
表36-7は、SOA 1ドメイン・キーストアの作成および構成後に確認する必要のあるキーストアのコンテンツを示しています。

表36-7 複合トポロジの場合のSOA 1ドメイン・キーストアのコンテンツ

キーの別名

説明

bpel

SOA 1ドメインのサーバーからのアウトバウンド・メッセージの署名に使用される秘密鍵です。この鍵は、SOA 1ドメインのSOAサーバーにデプロイされているワークリスト・アプリケーションによって使用されます。

webcenter_spaces_ws

WebCenter Portalドメインで使用されるwebcenter秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、SOA 1ドメイン内のBPEL Server1からWebCenter PortalドメインのWebサービスAPIへのアウトバウンド・ワークフロー・メッセージの暗号化に使用されます。

36.3.4.2 WLSTを使用したキーストアの構成

SOAドメイン・キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第36.3.4.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明されているとおりにFusion Middleware Controlを使用して、または次の説明のとおりにWLSTを使用して実行できます。

キーストア・サービスを構成するには:

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

3. bpel.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認し、locationとして./bpel.jksを指定します。

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="bpel", password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="bpel", password="MyPassword", desc="Signing key")

5. すべてのサーバーを再起動します。

36.3.4.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第36.3.4.2項「WLSTを使用したキーストアの構成」で説明されているとおりにWLSTを使用して、または次の説明のとおりにFusion Middleware Controlを使用して実行できます。

キーストア・プロバイダを構成するには:

1. Fusion Middleware Controlを開き、WebCenter Portalドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、SOAドメインをクリックします。

3. 「SOAドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。

4. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

5. 「構成」をクリックします。
「キーストアの構成」ページが表示されます(図36-16を参照)。

図36-16 「キーストアの構成」ページ

6. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./bpel.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: bpel

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: bpel

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

7. 「OK」をクリックして、設定を保存します。

8. ドメインの管理サーバーを再起動します。

36.3.5 2つ目のSOAドメインの設定

この項では、2つ目のSOAドメイン・キーストアを設定する方法について説明します。内容は次のとおりです。

- 第36.3.5.1項「SOAドメイン・キーストアの作成」

- 第36.3.5.2項「WLSTを使用したキーストアの構成」

- 第36.3.5.3項「Fusion Middleware Controlを使用したキーストアの構成」

- 第36.3.5.4項「2つ目のSOAサーバーのワークリスト接続の構成」

36.3.5.1 SOAドメイン・キーストアの作成

この項では、Javaキーストア(JKS)を使用してSOAドメイン・キーストアおよびキーを作成する方法について説明します。

SOAドメイン・キーストアを作成するには:

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、メッセージの署名と暗号化のためにSOAドメインで使用するキーペアを作成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias soa_server3
-keypass key_password -keystore soa_server3.jks -storepass keystore_password
-validity days_valid

ここで:

- consumer_dnameは、コンシューマの名前です(例: cn=soa_server3,dc=example,dc=com)。

- key_passwordは、新規公開鍵のパスワードです(例: MyPassword)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例36-24 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=soa_server3,dc=example,dc=com" -alias
soa_server3 -keypass MyPassword -keystore soa_server3.jks -storepass MyPassword
-validity 1064

注意:
キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle Web Services Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

3. 別名orakeyを使用してWebCenter Portalドメインにインポートできるように証明書をエクスポートします。

keytool -exportcert -v -alias soa_server3 -keystore soa_server3.jks
-storepass keystore_password -rfc -file soa_server3_public_key.cer

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-25 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias soa_server3 -keystore soa_server3.jks
-storepass MyPassword -rfc -file soa_server3_public_key.cer

4. WebCenter Portalドメインに、異なる別名で証明書をインポートします(別名がsoa_server3_public_keyの既存の証明書を上書きするかどうかを尋ねられたら「Yes」を選択します)。

keytool -importcert -alias soa_server3_public_key -file soa_server3_public_
key.cer  -keystore webcenter.jks -storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-26 証明書のインポート

keytool -importcert -alias soa_server3_public_key -file soa_server3_public_key.cer
-keystore webcenter.jks -storepass MyPassword

5. soa_server3_public_key証明書をインポートします。

keytool -importcert -alias soa_server3_public_key -file
soa_server3_public_key.cer -keystore webcenter.jks -storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-27 soa_server3_public_key証明書のインポート

keytool -importcert -alias soa_server3_public_key -file soa_server3_public_key.cer -keystore webcenter.jks -storepass MyPassword

6. producer_public_key証明書をインポートします。

keytool -importcert -alias producer_public_key -file producer_public_key.cer
-keystore webcenter.jks -storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-28 producer_public_key証明書のインポート

keytool -importcert -alias producer_public_key -file producer_public_key.cer
-keystore webcenter.jks -storepass MyPassword

7. external_webcenter_custom_public_key証明書をインポートします。

keytool -importcert -alias external_webcenter_custom_public_key -file
external_webcenter_custom_public_key.cer -keystore webcenter.jks -storepass
keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-29 external_webcenter_custom_public_key証明書のインポート

keytool -importcert -alias external_webcenter_custom_public_key -file
external_webcenter_custom_public_key.cer -keystore webcenter.jks -storepass MyPassword

8. 第36.3.5.2項「WLSTを使用したキーストアの構成」で説明しているようにWLSTを使用して、または第36.3.5.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明しているようにFusion Middleware Controlを使用して、キーストアを構成し、続行します。
表36-8は、SOA 2ドメイン・キーストアの作成および構成後に確認する必要のあるキーストアのコンテンツを示しています。

表36-8 複合トポロジの場合のSOA 2ドメイン・キーストアのコンテンツ

キーの別名

説明

webcenter

WebCenter Portalからのアウトバウンド・メッセージの署名と暗号化に使用されるキー・ペアです。このキーは、OWSM (ポートレットおよびワークリスト)とディスカッションの両方で使用されます。

orakey

SOA 1ドメインで使用されるBPEL秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、ワークリスト・コンポーネントからSOA 1ドメイン内のSOA_Server3へのアウトバウンド・メッセージの暗号化に使用されます。

soa_server3_public_key

SOA 2ドメインで使用されるsoa_server3秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、ワークリスト・コンポーネントからSOA 2ドメイン内のBPEL Server2へのアウトバウンド・メッセージの暗号化に使用されます。

producer_public_key

WSRPプロデューサ1アプリケーションをホストする外部ポートレット・ドメインで使用されるプロデューサ秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、WebCenter PortalからWebCenter Portalアプリケーションに登録されているWSRPプロデューサ1へのアウトバウンド・メッセージの暗号化に使用されます。

external_webcenter_custom_public_key

WebCenter Portal Webサービスに対してWebサービス・コールを行うPortal Frameworkアプリケーションをホストする外部WebCenterドメインで使用されるexternal_webcenter_custom秘密鍵に対応する公開鍵が含まれる証明書です。この証明書は、WebCenter Portalから外部WebCenterドメイン内のPortal Frameworkアプリケーションへのアウトバウンド・メッセージの暗号化に使用されます。

36.3.5.2 WLSTを使用したキーストアの構成

2つ目のSOAドメイン・キーストアの作成後に、キーストア・サービスを構成して、資格証明ストアを更新し、OWSMでキーストアおよびキーを正常に読み取れるようにします。これは、第36.3.5.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明されているとおりにFusion Middleware Controlを使用して、または次の説明のとおりにWLSTを使用して実行できます。

キーストア・サービスを構成するには:

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

3. soa_server3.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認して、locationとして./soa_server3.jksを指定します。

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="soa_server3", password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="soa_server3", password="MyPassword", desc="Signing key")

5. すべてのサーバーを再起動します。

36.3.5.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第36.3.5.2項「WLSTを使用したキーストアの構成」で説明されているとおりにWLSTを使用して、または次の説明のとおりにFusion Middleware Controlを使用して実行できます。

キーストア・プロバイダを構成するには:

1. Fusion Middleware Controlを開き、WebCenter Portalドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、SOAドメインをクリックします。

3. 「SOAドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。

4. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

5. 「構成」をクリックします。
「キーストアの構成」ページが表示されます(図36-17を参照)。

図36-17 「キーストアの構成」ページ

6. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./soa_server3.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: soa_server3

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: soa_server3

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

7. 「OK」をクリックして、設定を保存します。

8. ドメインの管理サーバーを再起動します。

36.3.5.4 2つ目のSOAサーバーのワークリスト接続の構成

通常、ワークリスト接続では、oracle/wss10_saml_token_with_message_protection_client_policyポリシーを使用して、SOAサーバーへのアウトバウンドSOAPメッセージが保護されます。ただし、WebCenter Portalドメインで複数のワークリスト接続が同時に使用される複合デプロイメントの場合は、追加のOWSMポリシーを作成して、受信者キーの別名が、WebCenter Portal側の目的のSOAサーバーの証明書の別名と一致するように、そのポリシーを構成する必要があります。

複数のワークリスト接続を同時に使用するには、次の手順を実行します。

1. 外部SOAドメインから証明書をエクスポートし、それを新規別名(次の例ではsoa_server3_key)でWebCenter Portalドメインにインポートします。

2. Fusion Middleware Controlを使用して新規OWSMポリシーを作成し、前の手順と同じ別名を使用するように受信者キーの別名をオーバーライドします。

1. Fusion Middleware Controlで、「WebLogicドメイン」メニューから、「Webサービス」→「ポリシー」を選択します。
「Webサービス・ポリシー」ページが表示されます(図36-18を参照)。

図36-18 「Webサービス・ポリシー」ページ

2. 新規ポリシー作成のベースとして使用するクライアント・ポリシーを選択して、「類似作成」をクリックします。
「ポリシーの作成」ページが表示されます(図36-19を参照)。

図36-19 「ポリシーの作成」ページ

3. 新規ポリシーの名前(たとえば、oracle_wss10_saml_token_with_message_protection_client_policy_soa_server3)を入力して、「保存」をクリックします。
「Webサービス・ポリシー」ページに、新規ポリシーが表示されます。

4. 「Webサービス・ポリシー」ページで、新規ポリシーを選択して、「編集」をクリックします。

5. 「ポリシーの編集」ページで、「構成」タブを開き、「編集」をクリックします。

6. 受信者キーの別名を値soa_server3_keyでオーバーライドして、「保存」をクリックします。

3. BPEL接続を作成し、次のWLSTコマンドを使用して、前の手順で作成したポリシーにセキュリティ・ポリシーを設定します。

setBPELConnection(appName='webcenter',
name='WebCenter-Worklist-SOAServer3',url='<your_url>',
policy='oracle/wss10_saml_token_with_message_protection_client_policy_soa_server3')

36.3.6 外部ポートレット・ドメイン・キーストアの設定

この項では、この複合トポロジのWSRPプロデューサの1つで使用されている外部ポートレット・ドメインにキーストアを設定する方法を説明します。

この項には次のサブセクションが含まれます:

- 第36.3.6.1項「外部ポートレット・ドメイン・キーストアの作成」

- 第36.3.6.2項「WLSTを使用したキーストアの構成」

- 第36.3.6.3項「Fusion Middleware Controlを使用したキーストアの構成」

36.3.6.1 外部ポートレット・ドメイン・キーストアの作成

外部ポートレット・ドメイン・キーストアを作成するには:

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、WebCenter Portalドメインの公開証明書をインポートすることでキーストアを生成します。

keytool -importcert -alias webcenter_public -file webcenter_public.cer
-keystore producer.jks -storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです。

例36-30 証明書のインポート

keytool -importcert -alias webcenter_public -file webcenter_public.cer -keystore
producer.jks -storepass MyPassword

3. keytoolを使用して、キー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias producer
-keypass key_password -keystore producer.jks -storepass keystore_password
-validity days_valid

ここで:

- consumer_dnameは、コンシューマの名前です(例: cn=producer,dc=example,dc=com)。

- key_passwordは、新規公開鍵のパスワードです(例: MyPassword)。

- keystoreは、キーストア名です(例: webcenter.jks)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例36-31 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=producer,dc=example,dc=com" -alias
producer -keypass MyPassword -keystore producer.jks -storepass MyPassword
-validity 1064

注意:
キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle Web Services Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

4. WebCenter Portalドメインのキーストアにインポートできるように、公開鍵が含まれる証明書をエクスポートします。

keytool -exportcert -v -alias producer -keystore producer.jks -storepass
keystore_password -rfc -file producer_public_key.cer

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-32 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias producer -keystore producer.jks -storepass MyPassword
-rfc -file producer_public_key.cer

5. WebCenter Portalドメインに、異なる別名で証明書をインポートします(別名がproducer_public_keyの既存の証明書を上書きするかどうかを尋ねられたら「Yes」を選択します)。

keytool -importcert -alias producer_public_key -file producer_public_key.cer
-keystore webcenter.jks -storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-33 証明書のインポート

keytool -importcert -alias producer_public_key -file producer_public_key.cer
-keystore webcenter.jks -storepass MyPassword

6. 第36.3.6.2項「WLSTを使用したキーストアの構成」で説明しているようにWLSTを使用して、または第36.3.6.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明しているようにFusion Middleware Controlを使用して、キーストアを構成し、続行します。

36.3.6.2 WLSTを使用したキーストアの構成

外部ポートレット・ドメイン・キーストアの作成後に、キーストア・サービスを構成して、資格証明ストアを更新し、OWSMでキーストアおよびキーを正常に読み取れるようにします。これは、第36.3.6.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明されているとおりにFusion Middleware Controlを使用して、または次の説明のとおりにWLSTを使用して実行できます。

キーストア・サービスを構成するには:

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

3. producer.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認して、locationとして./producer.jksを指定します。

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm", password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="producer", password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="producer", password="MyPassword", desc="Signing key")

5. すべてのサーバーを再起動します。

36.3.6.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第36.3.6.2項「WLSTを使用したキーストアの構成」で説明されているとおりにWLSTを使用して、または次の説明のとおりにFusion Middleware Controlを使用して実行できます。

キーストア・プロバイダを構成するには:

1. Fusion Middleware Controlを開き、WebCenter Portalドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、WebCenter Portalドメイン(デフォルトではwc_domain)をクリックします。

3. 「WebLogicドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。

4. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

5. 「構成」をクリックします。
「キーストアの構成」ページが表示されます(図36-20を参照)。

図36-20 「キーストアの構成」ページ

6. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./producer.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: producer

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: producer

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

7. 「OK」をクリックして、設定を保存します。

8. ドメインの管理サーバーを再起動します。

36.3.7 外部WebCenterドメイン・キーストアの設定

この項では、WebCenter Portal Webサービス・コールを行うPortal Frameworkアプリケーションで使用される外部WebCenterドメインを設定する方法を説明します。

この項には次のサブセクションが含まれます:

- 第36.3.7.1項「外部WebCenterドメイン・キーストアの作成」

- 第36.3.7.2項「WLSTを使用したキーストアの構成」

- 第36.3.7.3項「Fusion Middleware Controlを使用したキーストアの構成」

36.3.7.1 外部WebCenterドメイン・キーストアの作成

外部WebCenterドメイン・キーストアを作成するには:

1. JDK_HOME/jdk/binに移動し、コマンド・プロンプトを開きます。

2. keytoolを使用して、WebCenterドメインの公開証明書をインポートすることでキーストアを生成します。

keytool -importcert -alias webcenter_public -file webcenter_public.cer
-keystore external_webcenter_custom.jks -storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです。

例36-34 証明書のインポート

keytool -importcert -alias webcenter_public -file webcenter_public.cer -keystore
external_webcenter_custom.jks -storepass MyPassword

3. keytoolを使用して、キー・ペアを生成します。

keytool -genkeypair -keyalg RSA -dname "consumer_dname" -alias
external_webcenter_custom -keypass key_password -keystore
external_webcenter_custom.jks -storepass keystore_password -validity days_valid

ここで:

- consumer_dnameは、コンシューマの名前です(例: cn=external_webcenter_custom,dc=example,dc=com)。

- key_passwordは、新規公開鍵のパスワードです(例: MyPassword)。

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

- days_validは、キーのパスワードが有効な日数です(例: 1064)。

例36-35 キーペアの生成

keytool -genkeypair -keyalg RSA -dname "cn=external_webcenter_custom,
dc=example,dc=com" -alias external_webcenter_custom -keypass MyPassword
-keystore external_webcenter_custom.jks -storepass MyPassword -validity 1064

注意:
キーを生成するためにkeytoolによって使用されるデフォルト・アルゴリズム(DSA)は、Oracle Web Services Security Managerの要件に適合しないため、上に示すように、-keyalgパラメータを使用し、その値としてRSAを指定する必要があります。

4. WebCenter Portalドメインのキーストアにインポートできるように、公開鍵が含まれる証明書をエクスポートします。

keytool -exportcert -v -alias external_webcenter_custom -keystore external_
webcenter_custom.jks -storepass keystore_password -rfc -file external_
webcenter_custom_public_key.cer

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-36 公開鍵が含まれる証明書のエクスポート

keytool -exportcert -v -alias external_webcenter_custom -keystore external_
webcenter_custom.jks -storepass MyPassword -rfc -file external_webcenter_custom_
public_key.cer

5. WebCenter Portalドメインに、異なる別名で証明書をインポートします(別名がexternal_webcenter_custom_public_keyの既存の証明書を上書きするかどうかを尋ねられたら「Yes」を選択します)。

keytool -importcert -alias external_webcenter_custom_public_key -file
external_webcenter_custom_public_key.cer -keystore webcenter.jks
-storepass keystore_password

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例36-37 証明書のインポート

keytool -importcert -alias external_webcenter_custom_public_key -file external_
webcenter_custom_public_key.cer -keystore webcenter.jks -storepass MyPassword

6. 第36.3.7.2項「WLSTを使用したキーストアの構成」で説明しているようにWLSTを使用して、または第36.3.7.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明しているようにFusion Middleware Controlを使用して、キーストアを構成し、続行します。

36.3.7.2 WLSTを使用したキーストアの構成

外部WebCenterドメイン・キーストアの作成後に、キーストア・サービスを構成して、資格証明ストアを更新し、OWSMでキーストアおよびキーを正常に読み取れるようにします。これは、第36.3.7.3項「Fusion Middleware Controlを使用したキーストアの構成」で説明されているとおりにFusion Middleware Controlを使用して、または次の説明のとおりにWLSTを使用して実行できます。

キーストア・サービスを構成するには:

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動し、エディタでjps-config.xmlファイルを開きます。

2. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

3. webcenter.jksキーストア・ファイルが<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーされていることを確認し、locationとして./webcenter.jksを指定します。

4. 次のWLSTコマンドを使用して、資格証明ストアを更新します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm",
password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="external_webcenter_custom",
password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key",
user="external_webcenter_custom", password="MyPassword", desc="Signing key")

5. すべてのサーバーを再起動します。

36.3.7.3 Fusion Middleware Controlを使用したキーストアの構成

キーストアの作成後、OWSMがキーストアとキーを正しく読み取れるように、キーストア・サービスを構成し、資格証明ストアを更新します。これは、第36.3.7.2項「WLSTを使用したキーストアの構成」で説明されているとおりにWLSTを使用して、または次の説明のとおりにFusion Middleware Controlを使用して実行できます。

キーストア・プロバイダを構成するには:

1. Fusion Middleware Controlを開き、WebCenter Portalドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6章「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、WebCenter Portalドメイン(デフォルトではwc_domain)をクリックします。

3. 「WebLogicドメイン」メニューから、「セキュリティ」→「セキュリティ・プロバイダ構成」を選択します。

4. 「セキュリティ・プロバイダ構成」ページで「キー・ストア」セクションを開きます。

5. 「構成」をクリックします。
「キーストアの構成」ページが表示されます(図36-21を参照)。

図36-21 「キーストアの構成」ページ

6. 次の設定を使用して、証明書と秘密鍵を含むキーストアの場所、および署名鍵と暗号化鍵の別名を指定します。

- キーストア・パス: ./external_webcenter_custom.jks

- パスワード: キーストアのパスワードを入力し、確認のためにもう一度入力します。

- キーの別名: external_webcenter_custom

- 署名のパスワード: 署名鍵のパスワードを入力し、確認のためにもう一度入力します。

- 暗号化の別名: external_webcenter_custom

- 暗号化のパスワード: 暗号化鍵のパスワードを入力し、確認のためにもう一度入力します。

7. 「OK」をクリックして、設定を保存します。

8. ドメインの管理サーバーを再起動します。

36.3.8 複合トポロジの場合のコマンド・サマリー

複合トポロジの場合にキーストアおよびDFプロパティを迅速に構成するには、次のコマンド・サマリーを使用します。

キーストアの生成

次のkeytoolコマンドを使用して、キーストアを生成し、太字で示した値をローカル環境の値に置き換えます。

keytool -genkeypair -keyalg RSA -dname "cn=spaces,dc=example,dc=com" -alias
webcenter  -keypass MyPassword -keystore webcenter.jks -storepass MyPassword -validity 1064

keytool -exportcert -v -alias webcenter -keystore webcenter.jks -storepass
MyPassword -rfc -file webcenter_public.cer

keytool -importcert -alias df_webcenter_public -file webcenter_public.cer
-keystore owc_discussions.jks -storepass MyPassword

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -importcert -alias webcenter_spaces_ws -file webcenter_public.cer
-keystore bpel.jks -storepass MyPassword

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -genkeypair -keyalg RSA -dname "cn=bpel,dc=example,dc=com" -alias bpel
-keypass MyPassword -keystore bpel.jks

keytool -exportcert -v -alias bpel -keystore bpel.jks -storepass MyPassword -rfc -file orakay.cer

keytool -importcert -alias orakey -file orakay.cer -keystore webcenter.jks -storepass MyPassword

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -genkeypair -keyalg RSA -dname "cn=soa_server3,dc=example,dc=com" -alias
soa_server3 -keypass MyPassword -keystore soa_server3.jks -storepass MyPassword
-validity 1024

keytool -exportcert -v -alias soa_server3 -keystore soa_server3.jks -storepass
MyPassword -rfc -file soa_server3_public_key.cer

keytool -importcert -alias soa_server3_public_key -file soa_server3_public_key.cer
-keystore webcenter.jks -storepass MyPassword

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -importcert -alias webcenter_public -file webcenter_public.cer -keystore
producer.jks -storepass MyPassword

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -genkeypair -keyalg RSA -dname "cn=producer,dc=example,dc=com" -alias
producer -keypass MyPassword -keystore producer.jks -storepass MyPassword -validity 1024

keytool -exportcert -v -alias producer -keystore producer.jks
-storepass MyPassword -rfc -file producer_public_key.cer

keytool -importcert -alias webcenter_public -file webcenter_public.cer
-keystore external_webcenter_custom.jks -storepass MyPassword

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -genkeypair -keyalg RSA -dname "cn=external_webcenter_custom,dc=example,dc=com"
-alias external_webcenter_custom -keypass MyPassword -keystore external_webcenter_custom.jks
-storepass MyPassword -validity 1024

keytool -exportcert -v -alias external_webcenter_custom -keystore
external_webcenter_custom.jks -storepass MyPassword -rfc -file
external_webcenter_custom_public_key.cer

keytool -importcert -alias producer_public_key -file producer_public_key.cer
-keystore webcenter.jks -storepass MyPassword

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -importcert -alias external_webcenter_custom_public_key -file
external_webcenter_custom_public_key.cer -keystore webcenter.jks -storepass MyPassword

証明書を信頼するかを尋ねられたら、yesと答えます。

webcenter.jksをdomain_home/config/fmwconfigディレクトリに、bpel.jksをSOA1_domain_home/config/fmwconfigディレクトリに、soa_server3.jksをSOA_2_domain_home/config/fmwconfigディレクトリに、producer.jksをExternal_Portlet_domain_home/config/fmwconfigディレクトリに、およびexternal_webcenter_custom.jksをExternal_WebCenter_domain_home/config/fmwconfigディレクトリにコピーします。

WebCenter Portalドメイン・キーストアの構成

次の手順に従って、WebCenter Portalドメインのサービス・インスタンス参照を構成します。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動します。

2. まだ実行していない場合は、webcenter.jksを<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

3. エディタでjps-config.xmlを開きます。

4. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

5. locationとして./webcenter.jksを指定します。

6. WLSTを使用して、管理者としてWebCenter Portalドメインに接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm",
password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="webcenter",
password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="webcenter",
password="MyPassword", desc="Signing key")

外部ディスカッション・サーバー・ドメイン・キーストアの構成

次の手順に従って、ディスカッション・サーバーのサービス・インスタンス参照を構成します。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動します。

2. まだ実行していない場合は、webcenter.jksを<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

3. エディタでjps-config.xmlを開きます。

4. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

5. locationとして./owc_discussions.jksを指定します。

6. WLSTを使用して、管理者としてWebCenter Portalドメインに接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm",
password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key",
user="owc_discussions", password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key",
user="owc_discussions", password="MyPassword", desc="Signing key")

SOA1ドメイン・キーストアの構成

次の手順に従って、SOA1ドメインのサービス・インスタンス参照を構成します。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動します。

2. まだ実行していない場合は、bpel.jksを<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

3. エディタでjps-config.xmlを開きます。

4. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

5. locationとして./bpel.jksを指定します。

6. WLSTを使用して、SOA1ドメインに管理ユーザーとして接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm",
password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="bpel",
password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="bpel",
password="MyPassword", desc="Signing key")

SOA2ドメイン・キーストアの構成

次の手順に従って、SOA2ドメインのサービス・インスタンス参照を構成します。

1. <DOMAIN_HOME>/config/fmwconfigディレクトリに移動します。

2. まだ実行していない場合は、soa_server3.jksを<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

3. エディタでjps-config.xmlを開きます。

4. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

5. locationとして./soa_server3.jksを指定します。

6. WLSTを使用して、SOA2ドメインに管理ユーザーとして接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm",
password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="soa_server3",
password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="soa_server3",
password="MyPassword", desc="Signing key")

外部ポートレット・プロデューサ・ドメイン・キーストアの構成

次の手順に従って、外部ポートレット・プロデューサ・ドメイン・キーストアおよび外部WebCenterドメイン・キーストアのサービス・インスタンス参照を構成します。

1. 外部ポートレット・プロデューサ・ドメインの<DOMAIN_HOME>/config/fmwconfigディレクトリにナビゲートします。

2. まだ実行していない場合は、producer.jksを<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

3. エディタでjps-config.xmlを開きます。

4. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

5. locationとして./producer.jksを指定します。

6. WLSTを使用して、管理者として外部ポートレット・プロデューサ・ドメインに接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm",
password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key", user="producer",
password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key", user="producer",
password="MyPassword", desc="Signing key")

7. 外部WebCenterドメインの<DOMAIN_HOME>/config/fmwconfigディレクトリにナビゲートします。

8. まだ実行していない場合は、producer.jksを<DOMAIN_HOME>/config/fmwconfigディレクトリにコピーします。

9. エディタでjps-config.xmlを開きます。

10. keystore.providerプロバイダの<serviceInstanceノードを見つけます。

11. locationとして./external_webcenter_custom.jksを指定します。

12. WLSTを使用して、管理者として外部ポートレット・プロデューサ・ドメインに接続し、次のコマンドを実行します。

updateCred(map="oracle.wsm.security", key="keystore-csf-key", user="owsm",
password="MyPassword", desc="Keystore key")
updateCred(map="oracle.wsm.security", key="enc-csf-key",
user="external_webcenter_custom", password="MyPassword", desc="Encryption key")
updateCred(map="oracle.wsm.security", key="sign-csf-key",
user="external_webcenter_custom", password="MyPassword", desc="Signing key")

ディスカッション・サーバー接続の構成

第12.3項「ディスカッション・サーバーの登録」で説明しているように、WebCenter Portalまたは使用しているPortal Frameworkアプリケーションに構成されているディスカッション・サーバーの接続にWS-Securityクライアント証明書情報を指定します。 また、第36.3.3.4項「ディスカッション・サーバーの接続設定の構成」で、「ディスカッションおよびお知らせ接続の編集」ページの接続詳細設定の例を参照してください。

36.4 WebCenter Portal Client APIを使用するアプリケーションに対するWS-Securityを使用したWebCenter Portalの保護

この項では、WebCenter Portal APIを公開するアプリケーション(コンシューマ)とWebCenter Portal (プロデューサ)の間の通信のセキュリティが確保され、それらのAPIを呼び出すユーザーのアイデンティティが保護されるように、WebCenter PortalにWS-Securityを構成する場合に必要な管理者タスクについて説明します。

WebCenter PortalクライアントAPIを使用するアプリケーション開発のための開発者タスクの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のWebCenter Portal APIを使用するようにFrameworkアプリケーションを設定する方法に関する項を参照してください。

この項には次のサブセクションが含まれます:

- 第36.4.1項「WebCenter PortalクライアントAPIを使用するアプリケーションの単純トポロジの構成」

- 第36.4.2項「WebCenter PortalクライアントAPIを使用するアプリケーションの標準トポロジの構成」

- 第36.4.3項「WebCenter PortalクライアントAPIを使用するアプリケーションの複合トポロジの構成」

36.4.1 WebCenter PortalクライアントAPIを使用するアプリケーションの単純トポロジの構成

クライアント・アプリケーションがWebCenter Portalと同じドメインの一部である場合は、GroupSpaceWSContext()に対して次のコマンドを設定するだけで済みます。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("orakey");

クライアント・アプリケーションがJDeveloperであり、WebCenter Portalサーバーの構成済キーストアにアクセスできる場合は、同じキーストアをJDeveloperのDefaultDomain/config/fmwconfig/dirにコピーし、このキーストアを使用するようにJDeveloperドメインを構成します。ここで必要な手順は、第36.1.2.2項「WLSTを使用したキーストアの構成」のものとまったく同じであり、その上で、クライアント・スタブに次のコマンドを指定する必要があります。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("orakey");

36.4.2 WebCenter PortalクライアントAPIを使用するアプリケーションの標準トポロジの構成

クライアント・アプリケーションがWebCenter Portalと同じドメインの一部である場合は、GroupSpaceWSContext()に対して次のコマンドを設定するだけで済みます。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("webcenter");

クライアント・アプリケーションがJDeveloperであり、WebCenter Portalサーバーの構成済キーストアにアクセスできる場合は、同じキーストアをJDeveloperのDefaultDomain/config/fmwconfig/dirにコピーし、このキーストアを使用するようにJDeveloperドメインを構成します。ここで必要な手順は、第36.2.2.2項「WLSTを使用したキーストアの構成」のものとまったく同じであり、その上で、クライアント・スタブに次のコマンドを指定する必要があります。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("webcenter");

36.4.3 WebCenter PortalクライアントAPIを使用するアプリケーションの複合トポロジの構成

クライアント・アプリケーションがWebCenter Portalと同じドメインの一部である場合は、GroupSpaceWSContext()に対して次のコマンドを設定するだけで済みます。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("webcenter");

クライアント・アプリケーションがJDeveloperの場合、同じキーストアをJDeveloperのDefaultDomain/config/fmwconfig/dirにコピーして、このキーストアを使用するようにJDeveloperドメインを構成します。ここで必要な手順は、第36.3.2.2項「WLSTを使用したキーストアの構成」のものとまったく同じであり、その上で、クライアント・スタブに次のコマンドを指定する必要があります。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("webcenter");

37 ポートレット・プロデューサのセキュリティの構成

この章では、WSRPおよびJPDKポートレット・プロデューサのセキュリティを処理するようWebCenter PortalまたはPortal Frameworkアプリケーションを構成する方法を説明します。

この章の内容は次のとおりです。

- 第37.1項「WSRPプロデューサの保護」

- 第37.2項「PDK-Javaプロデューサの保護」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

37.1 WSRPプロデューサの保護

次の各項で、WebCenter PortalおよびPortal FrameworkアプリケーションからJSR-168標準ベースのWSRPポートレットにセキュアにアクセスする方法を説明します。

- 第37.1.1項「プロデューサのデプロイ」

- 第37.1.2項「プロデューサ・エンドポイントへのポリシーの添付」

- 第37.1.3項「キーストアの設定」

WSRPプロデューサの保護の概要は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のWS-Securityを使用したWSRPプロデューサを介するアイデンティティ伝播の保護に関する項を参照してください。

37.1.1 プロデューサのデプロイ

WS-Security用にプロデューサを構成する前に、第21.11項「ポートレット・プロデューサ・アプリケーションのデプロイ」で説明されている手順を実行して、標準準拠のポートレット・プロデューサをOracle WebLogic管理対象サーバーにデプロイする必要があります。

37.1.2 プロデューサ・エンドポイントへのポリシーの添付

この項では、セキュリティ・ポリシーをWSRPプロデューサ・エンドポイントに添付する方法について説明します。WSRPプロデューサでサポートされるポリシーは次のとおりです。

- ユーザー名トークン(パスワードあり)
wss10_username_token_with_message_protection_service_policy

このポリシーは、メッセージ・レベルの保護(メッセージの整合性と機密保護)、およびWS-Security 1.0標準に従ったインバウンドSOAPリクエストの認証を行います。WS-SecurityのBasic 128スイートの非対称キー・テクノロジ、具体的には、メッセージの機密保護のためのRSA鍵メカニズム、メッセージの整合性のためのSHA-1ハッシュ・アルゴリズム、およびAES-128ビット暗号化が使用されます。キーストアは、セキュリティ構成を使用して構成されます。認証は、WS-Securityユーザー名トークンのSOAPヘッダーにあるcredentialsを使用して実施されます。ユーザーのサブジェクトは、現在構成されているアイデンティティ・ストアに対して確立されます。

- ユーザー名トークン(パスワードなし)
wss10_username_id_propagation_with_msg_protection_service_policy

このポリシーでは、WS-Security 1.0標準で示されたメカニズムを使用して、メッセージレベルの保護(メッセージの整合性および機密保護)およびインバウンドSOAPリクエストのアイデンティティ伝搬を実施します。メッセージの保護は、非対称型キー・テクノロジであるWS-SecurityのBasic128スイート(具体的には、機密保護に使用するRSAキー・メカニズム、整合性に使用するSHA-1ハッシング・アルゴリズム、およびAES-128ビット暗号化)を使用して提供されます。アイデンティティは、UsernameToken WS-Security SOAPヘッダーに指定されたユーザー名を使用して設定されます。サブジェクトは、現在構成されているアイデンティティ・ストアに対して確立されます。

- SAMLトークン
次の4つの「SAMLトークン」ポリシーがあります。

- WSS 1.0 SAMLトークン・ポリシー:
wss10_saml_token_service_policy

このポリシーでは、WS-Security SOAPヘッダーのSAMLトークンに指定された資格証明を使用することによってユーザーが認証されます。SAMLトークンに指定された資格証明は、SAMLログイン・モジュールに対して認証されます。このポリシーは、SOAPベースのあらゆるエンドポイントに適用できます。

- メッセージ整合性付きWSS 1.0 SAMLトークン
wss10_saml_token_with_message_integrity_service_policy

このポリシーは、メッセージ・レベルの整合性保護と、WS-Security 1.0標準に従ったインバウンドSOAPリクエストのSAMLベースの認証を行います。また、このポリシーでは、WS-Securityの非対称鍵テクノロジのBasic 128スイート、具体的には、メッセージ整合性のためのSHA-1ハッシュ・アルゴリズムが使用されます。

- メッセージ保護付きWSS 1.0 SAMLトークン
wss10_saml_token_with_message_protection_service_policy

このポリシーは、メッセージ・レベルの保護と、WS-Security 1.0標準に従ったインバウンドSOAPリクエストのSAMLベースの認証を行います。WS-SecurityのBasic 128スイートの非対称キー・テクノロジ、具体的には、機密保護のためのRSAキー・メカニズム、整合性のためのSHA-1ハッシュ・アルゴリズム、およびAES-128ビット暗号化が使用されます。

- メッセージ保護付きWSS 1.1 SAMLトークン
wss11_saml_token_with_message_protection_service_policy

このポリシーは、メッセージ・レベルの保護(メッセージ整合性とメッセージ機密保護)、およびWS-Security 1.1標準に従ったインバウンドSOAPリクエストのSAMLベースの認証を行います。メッセージは、WS-Securityの対称鍵テクノロジのBasic 128スイートを使用して保護されます。具体的には、メッセージ機密保護にはRSA鍵メカニズム、メッセージ整合性にはSHA-1ハッシュ・アルゴリズムが使用され、AES-128ビット暗号化も使用されます。キーストアは、セキュリティ構成を使用して構成されます。WS-Securityバイナリ・セキュリティ・トークンからSAMLトークンを抽出し、その資格証明を構成済アイデンティティ・ストアに対するユーザーの検証に使用します。このポリシーは、SOAPベースのすべてのエンドポイントにアタッチできます。

キーストアは、セキュリティ構成を使用して構成されます。WS-Securityバイナリ・セキュリティ・トークンからSAMLトークンを抽出し、その資格証明を構成済アイデンティティ・ストアに対するユーザーの検証に使用します。

ポリシーをプロデューサ・エンドポイントに添付する手順は次のとおりです。

1. Fusion Middleware Controlを開き、ターゲット・ドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6項「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「アプリケーションのデプロイ」ノードを開き、ポリシーの添付先のプロデューサをクリックします。

3. 「アプリケーションのデプロイ」メニューから、「Webサービス」を選択します。
このプロデューサの「Webサービスのサマリー」ページが表示されます(図37-1を参照)。

図37-1 「Webサービスのサマリー」ページ

4. 「Webサービス・エンドポイント」タブを開き、ポリシーの添付先のエンドポイントをクリックします。

注意:
マークアップ・サービス・ポートのみを保護する必要があります(WSRP_V2_Markup_ServiceおよびWSRP_V1_Markup_Service)。

このプロデューサの「Webサービス・エンドポイント」ページが表示されます(図37-2を参照)。

図37-2 「Webサービス・エンドポイント」ページ

5. 「ポリシー」タブを開いて、プロデューサに現在添付されているポリシーを表示します(図37-3を参照)。

図37-3 「Webサービス・エンドポイント」の「ポリシー」ページ

6. 「アタッチ/デタッチ」をクリックして、ポリシーを追加または削除します。
使用可能なポリシーとその説明が示された「ポリシーの添付/解除」ページが表示されます(図37-4を参照)。

図37-4 「ポリシーの添付/解除」ページ

7. 「使用可能なポリシー」で、検索するポリシー・カテゴリとしてCategoryおよびSecurityを選択し、「検索」アイコンをクリックすると、セキュリティ・ポリシーが表示されます。

8. 添付するポリシーを選択し、「添付」をクリックします。複数のポリシーを選択するには、[Ctrl]キーを使用します。
「添付されたポリシー」の下のリストにポリシーが表示されます(図37-5を参照)。

図37-5 添付されたポリシーが表示された「ポリシーの添付/解除」ページ

9. プロデューサ・エンドポイントに添付するポリシーの追加が終了したら、「OK」をクリックします。

37.1.3 キーストアの設定

WSRPプロデューサにキーストアを作成および構成する手順は、使用しているWebCenter PortalまたはPortal Frameworkアプリケーション環境のトポロジによって異なります。これらの手順については、次の各項で説明しています。

- 第36.1項「単純トポロジの場合のWS-Securityの構成」

- 第36.2項「標準トポロジの場合のWS-Securityの構成」

- 第36.3項「複合トポロジの場合のWS-Securityの構成」

キーストアを設定するための詳細な手順およびWSRPプロデューサを構成する際のWS-Securityのその他の側面については、これらの項を参照してください。

37.2 PDK-Javaプロデューサの保護

共有鍵をメッセージの整合性保護のために定義できますが、これはSSLとともに使用する必要があります。共有鍵をパスワード資格証明として格納する手順は次のとおりです。

- 管理サーバー・インスタンスの資格証明ストアに、パスワード資格証明として共有鍵を定義します。これは、Fusion Middleware ControlまたはWLSTを使用して実行できます。

- Webプロデューサを再起動して、テスト・ページにアクセスします。アプリケーション・ログをチェックして、共有鍵が適切に適用されていることを確認します。

注意:
共有鍵の使用では、メッセージの整合性保護のみを実施できます。完全なメッセージ保護には、SSLが必要です。SSLを使用したPDK-Javaポートレット保護の詳細は、第35.5項「SSLを使用したWebCenter Portalからポートレット・プロデューサへの接続の保護」を参照してください。

37.2.1 パスワード資格証明としての共有鍵の定義

管理サーバー・インスタンスの資格証明ストアに、Fusion Middleware ControlコマンドまたはWLSTコマンドを使用して、パスワード資格証明として共有鍵を定義できます。これらについて、次の各項で説明します。

- 第37.2.1.1項「Fusion Middleware Controlを使用した共有鍵の定義」

- 第37.2.1.2項「WLSTを使用した共有鍵の定義」

37.2.1.1 Fusion Middleware Controlを使用した共有鍵の定義

Fusion Middleware Controlを使用して共有鍵を定義する手順は、次のとおりです。

1. Fusion Middleware Controlにログインします。
Fusion Middleware Controlへのログインの詳細は、第6項「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、ターゲット・ドメイン(wc_domainなど)をクリックします。

3. 「WebLogicドメイン」メニューの「セキュリティ」→「資格証明」を選択します。
「資格証明」ペインが表示されます(図37-6を参照)。

図37-6 「資格証明」ペイン

4. 「マップの作成」をクリックし、「マップ名」としてPDKと入力して、「OK」をクリックします。

5. 「キーの作成」をクリックして、作成したマップ(PDK)を選択します。

6. 「ユーザー名」(この値は使用されないため、どのような値でも指定できます)、「キー」(pdk.<service_id>.sharedKeyの形式。<service_id>はプロデューサの名前)および「パスワード」(10から20桁の16進数)に値を入力して、「OK」をクリックします。
「資格証明」ペインに新規共有鍵が表示されます(図37-7を参照)。

図37-7 新規共有鍵が表示された「資格証明」ペイン

37.2.1.2 WLSTを使用した共有鍵の定義

次の手順で説明するように、WLSTを使用して共有鍵を定義することもできます。

1. 第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」に示されているとおりにWLSTを起動し、ターゲット・ドメインの管理サーバー・インスタンスに接続します。

2. 次のコマンドを使用して、ターゲット・ドメインの管理サーバーに接続します。

connect('user_name','password, 'host_id:port')

ここで:

- user_nameは、管理サーバーへのアクセスに使用されるユーザー・アカウントの名前です(例: weblogic)。

- passwordは、管理サーバーにアクセスするためのパスワードです。

- host_idは、管理サーバーのホストIDです。

- portは、管理サーバーのポート番号です(例: 7001)。

3. WLST createCredコマンドを使用して、プロデューサの共有鍵資格証明を資格証明ストアに追加します。

createCred(map='PDK', key='pdk.service_id.sharedKey.user_name', user='user_name', password='password')

ここで:

- service_idは、共有鍵の作成対象のプロデューサの名前です(例: omniPortlet)。

- user_nameは、ユーザーの名前です。この値は使用されないため、どのような値でも指定できます。

- passwordは、10から20桁の16進数値です。

例:

createCred(map='PDK', key='pdk.omniPortlet.sharedKey', user='sharedKey', password='1234567890abc')

注意:
資格証明の作成後は、前述のものと同じパラメータを指定したWLST updateCredコマンドを使用して、資格証明を更新できます。

4. プロデューサを再起動します。
Webプロデューサでは、初めてリクエストを処理する際(ブラウザ・テスト・ページ・リクエストやプロデューサの初回登録時など)にプロパティが適用されるため、共有鍵資格証明の設定後にプロデューサを再起動する必要があります。

37.2.1.3 共有鍵へのPDK-Javaプロデューサの登録

PDK-Javaプロデューサの登録については、第21.4項「Oracle PDK-Javaプロデューサの登録」で説明されています。 共有鍵にPDK-Javaプロデューサを登録する場合、次の操作も実行する必要があります。

- プロデューサの登録時に、「プロデューサ・セッションの有効化」オプションを選択します。

- 「ポートレット・プロデューサ接続の追加」セクションで、資格証明マップの作成時に使用するパスワードを共有鍵として入力します。

38 偽装の管理

この章では、WebCenter Portal偽装を管理および構成する方法について説明します。これにより、指定されたユーザーが他のポータル・ユーザーを偽装し、これらのユーザーとして操作を実行できます。(偽装者による)偽装セッションの開始方法および(被偽装者による)偽装セッションの許可方法の手順については、『Oracle WebCenter Portalの使用』の「WebCenter Portal偽装の使用」を参照してください。偽装ELおよび偽装APIの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の偽装に関連したELに関する項を参照してください。

この章には次の項が含まれます:

- 第38.1項「WebCenter Portal偽装の概要」

- 第38.2項「WebCenter Portalの偽装の準備」

- 第38.3項「WebCenter Portalの偽装の構成」

- 第38.4項「偽装者の構成」

- 第38.5項「偽装の無効化」

- 第38.6項「セッション・インジケータをオフにする」

- 第38.7項「偽装ホットキーのオーバーライド」

- 第38.8項「WebCenter Portal偽装の監査ログの管理」

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

38.1 WebCenter Portal偽装の概要

この項には次のサブセクションが含まれます:

- 第38.1.1項「WebCenter Portal偽装について」

- 第38.1.2項「WebCenter Portal偽装の使用のベスト・プラクティス」

38.1.1 WebCenter Portal偽装について

WebCenter Portal偽装を使用すると、WebCenter Portal管理者またはシステム管理者が、サポート担当者やアプリケーション管理者などのユーザーのグループ(「偽装者」)に偽装の権限を割り当てることができます。こうすることによって、偽装者は他のユーザー(「被偽装者」)として操作を実行できます。これは、偽装する追加の権限を偽装者に付与する被偽装者が対象となることに注意してください。これは、次のような場合に役立つ可能性があります。

- 顧客サポート担当者が、ユーザーが直面している問題を理解するために、そのユーザーのかわりとしてアクションを実行する場合。

- 管理者が、ユーザーのかわりに操作を実行する場合。

- 会社の管理職が不在のときに、その管理職のかわりにその責務を果たす権限を誰かに委任する必要がある場合。

38.1.2 WebCenter Portal偽装の使用のベスト・プラクティス

また被偽装者のシステムからOracle Access Manager (OAM)に参加するすべてのアプリケーションは、偽装者へのアクセスが可能になります。唯一の例外は、偽装者が偽装タスク・フローにアクセスして、偽装の権限を付与したり変更することができなくなることです。したがって、管理者が偽装の権限を付与する際には、偽装者が潜在的にアクセス可能な対象を考慮して、細心の注意を払う必要があります。偽装者は、ごく限られたグループにする必要があります。

偽装に対する監査ログ機能をオンにして、管理者は監査ログを定期的にモニターし、偽装アクティビティを確認する必要があります。監査ログ機能の詳細は、第38.8項「WebCenter Portal偽装の監査ログの管理」を参照してください。

偽装セッションを開始するには、被偽装者と偽装者が、偽装セッションの適切な時間帯に同意する必要があります。この場合、被偽装者はその時間帯にのみ偽装の権限を付与する必要があります。被偽装者は、偽装者が完了した直後に偽装の権限を取り消す必要があります。

偽装者がログアウトすると、偽装セッションが終了することに注意してください。また偽装セッションは、指定された偽装時間の終点に達したときにも終了します。たとえば、ユーザーが午後の1:00から2:00の間に偽装者に偽装の権限を付与した場合、偽装者が偽装セッションを1:00から2:00の間のいつ開始しても、そのセッションは2:00に終了します。

また、偽装者が偽装セッションを行っている最中に、ユーザーが明示的に偽装権限付与を取り消した場合、取消し操作はそのユーザーに対する既存の偽装セッションには影響を与えません。影響を与えるのは、次回偽装者がユーザーの偽装を試みたときのみです。ユーザーは、有効な被偽装者のリストには表示されません。

38.2 WebCenter Portalの偽装の準備

WebCenter Portal偽装はOAM 11.1.2.0に依存しています。WebCenter Portalインスタンスのために偽装を有効化するには、その前にまずOAM 11g (Oracleのシングル・サインオン・ソリューション)をインストールして構成し、OAMで偽装を有効にする必要があります。OAM 11gのインストールと構成の詳細は、第33.2項「Oracle Access Manager(OAM)の構成」を参照してください。

この項には次のサブセクションが含まれます:

- 第38.2.1項「WebCenter Portal偽装の要件」

- 第38.2.2項「OAMでの偽装の有効化」

- 第38.2.3項「アイデンティティ・ストアへの偽装属性の追加」

38.2.1 WebCenter Portal偽装の要件

WebCenter Portalの偽装を準備するには、まずOAM 11.1.2.0をインストールして構成し、OAMで偽装を有効にする必要があります。また、参加しているユーザーごとに偽装属性を追加する必要があります。

注意:
WebCenter Portal偽装では、OAM 11.1.2.0をシングル・サインオン・ソリューションとしてインストールおよび構成し、OID 11.1.2.0をアイデンティティ・ストアとしてインストールおよび構成することが要求されます。

- 10gまたは11gのいずれかのWebGateを使用してOAM 11.1.2.0をインストールおよび構成する(第33.2項「Oracle Access Manager(OAM)の構成」を参照してください)

- 偽装を有効化する

- アイデンティティ・ストアで各参加ユーザーに偽装属性を追加する

- 参加しているWebCenter Portalインスタンスごとに偽装を構成する

- WebCenterアプリケーション・ロールに偽装の権限を追加することにより、偽装の権限を持つユーザーを構成する

38.2.2 OAMでの偽装の有効化

第33.2項「Oracle Access Manager(OAM)の構成」で説明されているように(10gまたは11gのいずれかのWebGateを使用して) OAM 11.1.2.0をインストールおよび構成した後、次に示すようにidmConfigToolを使用してOAMで偽装を有効化して続行します。

偽装を有効にするには:

1. Oracle Fusion Middleware Oracle Identity Management Suite統合の概要のidmConfigToolコマンドの使用に関する項で示すように、idmConfigToolを使用してOAMを構成します。

2. 示されているようにプロパティ・ファイルを作成しますが、OAM11G_IMPERSONATION_FLAGをtrueに設定します。

38.2.3 アイデンティティ・ストアへの偽装属性の追加

ユーザーを偽装者または被偽装者として有効にするには、それらのユーザーが、OIDで偽装権限付与を保存するために使用可能な次の属性を保持している必要があります。

- orclImpersonationGrantee

- orclImpersonationGranter

これらの属性は、OIDでデフォルトで使用可能なorclIDXPersonオブジェクト・クラスの一部です。このオブジェクト・クラスは、偽装者または被偽装者として参加させるユーザーのユーザー・レコードごとに、オブジェクト・クラスのリストに追加する必要があります。これを実行するには、次の各項で説明されているように、オブジェクト・クラスの追加を個別のユーザーに対して行うか、複数のユーザーに対するバルク更新として行います。

- 第38.2.3.1項「個々のユーザーに対する偽装属性の追加」

- 第38.2.3.2項「複数のユーザーに対する偽装属性の追加」

38.2.3.1 個々のユーザーに対する偽装属性の追加

個々のユーザーに対してOIDで偽装権限付与を保存するための属性を追加するには、次の手順に従います。

個々のユーザーにオブジェクト・クラスを追加するには:

1. ODSMにログインします(通常はhttp://host:port/odsm)。

2. OAMおよびWebCenter用に構成されているディレクトリに接続します。

3. 各参加ユーザーに対して、次の手順を実行します。

1. データブラウザでドリルダウンするか、データブラウザの検索フィールドを使用して、変更するユーザーを見つけます。

2. 図38-1で示されているように、「属性」画面を開いて、既存のオブジェクト・クラスのリストにorclIDXPersonオブジェクト・クラスを追加します。

図38-1 ODSMの「属性」タブ

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

38.2.3.2 複数のユーザーに対する偽装属性の追加

bulkmodifyツールを使用してバルク更新として、OIDで偽装権限付与を保存するために使用可能な属性を追加することができます。このツールを使用するには、OIDがインストールされているマシンにアクセスでき、システム管理者の権限を持ち、OIDデータベースのパスワードを知っている必要があります。

複数のユーザーに対してOIDで偽装権限付与を保存するための属性を追加するには:

1. OIDを停止します。

2. $ORACLE_HOME/ldap/binに移動して、bulkmodifyツールを実行します。
オブジェクト・クラスを追加するすべてのユーザーが存在するDNとしてbasednを指定します。接続文字列はOID DB接続文字列です。これは通常OIDDB ($ORACLE_INSTANCE/config/tnsnames.oraから決定されます)です。入力を要求されたら、DBのパスワードを指定します。コマンドの実行例を次に示します。

bulkmodify connect="OIDDB" basedn="cn=Users,dc=us,dc=oracle,dc=com" attribute="objectclass" value="orclIDXPerson" add=true
This tool can only be executed if you know database user password for OID
Enter OID Password ::

------------------------------------------------------------
Modifying entries under "cn=users,dc=us,dc=oracle,dc=com" ...
------------------------------------------------------------

------------------------------------------------------------
Total 72 Entries are modified.

3. OIDを再起動します。
これで、指定されたDNの下にあるすべてのユーザーのorclIDXPersonオブジェクト・クラスが構成されているはずです。bulkmodifyツールの詳細は、『Oracle Identity Managementリファレンス』のbulkmodifyに関する項を参照してください。

38.3 WebCenter Portalの偽装の構成

OAMをインストールして構成し、OAMで偽装を有効化したら、次に示すように、WebCenter PortalインスタンスでOAM偽装のトリガー・エンド・ポイントを構成する必要があります。

1. WLSTを使用して、Weblogic管理サーバーに管理者として接続し次のコマンドを実行しますが、このとき、oamhostおよびoamserverportをOAMの該当するホストIDおよびポートで置き換えます。

addOAMSSOProvider(loginuri="/${app.context}/adfAuthentication", logouturi="/oamsso/logout.html",
beginimpuri="http://oamhost:oamserverport/oam/server/impersonate/start",
endimpuri="http://oamhost:oamserverport/oam/server/impersonate/end")

2. WebCenter Portalドメイン内のすべてのサーバーを再起動します(管理サーバーを含む)。

3. WebCenter PortalサーバーとOAMとの間に時間差がある場合は、それを説明することが必要になることもあります。偽装の開始時刻と終了時刻は、WebCenter Portalで受け入れられても、時間設定の整合性を取るために、OAMによって強制されます。時間差を説明する手順は次のとおりです。

1. 管理者としてWebCenter Portalにログインします。

2. 「管理」→「属性」を選択します。
「属性」ページが表示されます。

ヒント:
ブラウザでページを開くことにより、「属性」ページに直接アクセスすることもできます。

http://host:port/webcenter/faces/oracle/webcenter/webcenterapp/view/pages/admin/WebCenterAdmin-CustomAttributes.jspx

ここでhostおよびportは、WC_SpacesサーバーのホストおよびポートのIDです。

3. WebCenter PortalサーバーがOAMサーバーより遅れている場合は+を使用して偽装時間デルタを秒単位で指定し、進んている場合は-記号を使用して指定します。例:

oracle.webcenter.security.impersonation.timedelta = -480

これは、OAMとWebCenter Portalとの間に8分の時間差があり、WebCenter Portalサーバーの方が進んでいる場合を示しています。

ヒント:
$domain.home/bin/setDomainEnv.shファイルに設定を追加することもできます。

EXTRA_JAVA_PROPERTIES="-Doracle.webcenter.spaces.osso=true
-Doracle.webcenter.security.impersonation.timedelta=-480"
export EXTRA_JAVA_PROPERTIES

4. WebCenter Portal管理対象サーバー(WC_Spaces)を再起動します。

38.4 偽装者の構成

OAMとWebCenter Portalを構成したら、webcenter#-#impersonatorsロールにユーザーまたはグループを追加することにより、偽装権限の付与先のユーザーを構成することも必要になります。初期設定でこのロールが付与されているユーザーはいません。WebCenter Portalインスタンスでユーザーを偽装する資格があるのは、直接のメンバーシップまたはエンタープライズ・ロール・メンバーシップによってこのロールに属しているユーザーのみです。

注意:
他のユーザーを偽装できるようになる権限をユーザーに付与する際には、注意が必要です。偽装の権限を付与するのは、この機能を業務上必要としているユーザーのみにしてください。ベスト・プラクティスの詳細は、第38.1.2項「WebCenter Portal偽装の使用のベスト・プラクティス」を参照してください。

grantAppRole WLSTコマンドを使用して、webcenter#-#impersonatorsロールを1つ以上のエンタープライズ・ロールまたは1人以上のユーザーに付与します。例:

- SupportRepresentativesと呼ばれるエンタープライズ・ロールに偽装者のロールを付与するには:

grantAppRole(appStripe="webcenter", appRoleName="webcenter#-#impersonators",
principalClass="weblogic.security.principal.WLSGroupImpl",
principalName="SupportRepresentatives")

- weblogicという名前のユーザーに偽装者のロールを割り当てるには:

grantAppRole(appStripe="webcenter", appRoleName="webcenter#-#impersonators",
principalClass="weblogic.security.principal.WLSUserImpl",
principalName="weblogic")

エンタープライズ・ロールまたはユーザーの偽装者権限を取り消すには、revokeAppRole WLSTを使用します。例:

- SupportRepresentativesと呼ばれるエンタープライズ・ロールから偽装者のロールを取り消すには:

revokeAppRole(appStripe="webcenter", appRoleName="webcenter#-#impersonators",
principalClass="weblogic.security.principal.WLSGroupImpl",
principalName="SupportRepresentatives")

- weblogicという名前のユーザーから偽装者のロールを取り消すには:

revokeAppRole(appStripe="webcenter", appRoleName="webcenter#-#impersonators",
principalClass="weblogic.security.principal.WLSUserImpl",
principalName="weblogic")

注意:
ロールの割当ての変更はすぐに有効になります。管理対象サーバーを再起動する必要はありません。

38.5 偽装の無効化

WebCenter Portal偽装はデフォルトでは無効になっているので、偽装をあらかじめ有効にしていないかぎり、オフにするためにすべきことはありません。ただし、すでに偽装を有効にしていて、これから無効にする場合は、WebCenter PortalおよびOAMで次の手順に従ってオフにしてください。

WebCenter Portalで偽装をオフにした場合、その特定のインスタンスでのみ無効になることに注意してください。OAMで偽装を無効にするまで、偽装が無効化された他のWebCenter Portalインスタンスが影響を受けることはありません。

WebCenter Portalの偽装を無効化する手順は次のとおりです。

1. 管理者としてFusion Middleware Controlにログインします。

2. 「WebCenterドメイン」→「セキュリティ」→「セキュリティ・プロバイダ構成」に移動します。

3. 「プロパティ」セクションに移動して「構成」をクリックします。

4. PropertySetsで、偽装の開始URIと終了URI (通常は"props.auth.uri.0")を定義するプロパティ・セットを見つけます。

5. プロパティimp.begin.urlおよびimp.end.urlを削除します。

6. WebCenter Portalドメイン内のすべてのサーバーを再起動します(管理サーバーを含む)。
OAMで偽装を無効にするまで、他のWebCenter Portalドメインの偽装は引き続き有効になることに注意してください。

OAMで偽装を無効にして、偽装を完全にオフにする手順は次のとおりです。

1. DOMAIN_HOME/config/fmwconfig/oam-config.xmlファイルをバックアップします。

2. oam-config.xmlファイルを編集のために開きます。

3. 次に示すようにImpersonationConfigをfalseに設定します。

<Setting Name="ImpersonationConfig"Type="htf:map"> <Setting Name="EnableImpersonation"Type="xsd:boolean">false</Setting> </Setting>

4. oam-config.xmlを保存します。

5. OAMおよびそのすべてのコンポーネントを再起動します。

38.6 セッション・インジケータをオフにする

セッション・インジケータは、偽装セッション中にデフォルトで偽装者の画面に表示されるオーバーレイです。このオーバーレイは、偽装セッションがアクティブであるという視覚的な手掛かりを提供し、また「偽装の中止」をクリックすることでセッションを中止する迅速な方法も提供しますが、図38-2に示すようにユーザーの(被偽装者の)画面の一部の表示を妨げる場合があります。

注意:
偽装セッション通知ツールバーがオフになっている場合、「偽装の中止」ボタンが表示されなくなるので、ユーザーは「偽装」ページを使用して偽装セッションを中止する必要があります。

図38-2 偽装セッション - セッション・インジケータのオーバーレイ

次に示すように、セッション・インジケータのオーバーレイをオフにすることができます。

セッション・インジケータをオフにするには:

1. 管理者としてWebCenter Portalにログインします。

2. 「管理」→「属性」を選択します。
「属性」ページが表示されます。

ヒント:
ブラウザでページを開くことにより、「属性」ページに直接アクセスすることもできます。

http://host:port/webcenter/faces/oracle/webcenter/webcenterapp/view/pages/admin/WebCenterAdmin-CustomAttributes.jspx

ここでhostおよびportは、WC_SpacesサーバーのホストおよびポートのIDです。

3. 次に示すように通知プロパティをfalseに設定します。

oracle.webcenter.security.impersonation.notification=false

この場合、「偽装プリファレンス」画面を使用して偽装セッションを終了する必要があることに注意してください。「偽装プリファレンス」画面の使用の詳細は、『Oracle WebCenter Portalの使用』の「WebCenter Portal偽装の使用」を参照してください。

4. WC_Spaces管理対象サーバーを再起動して、変更を有効にします。

38.7 偽装ホットキーのオーバーライド

偽装者が被偽装者のリストを表示するために使用するデフォルトのCtrl-Shift-Iホットキー・シーケンスは、必要に応じてオーバーライドすることができます。

ホットキー・シーケンスを変更するには:

1. 管理者としてWebCenter Portalにログインします。

2. 「管理」→「属性」を選択します。
「属性」ページが表示されます。

ヒント:
ブラウザでページを開くことにより、「属性」ページに直接アクセスすることもできます。

http://host:port/webcenter/faces/oracle/webcenter/webcenterapp/view/pages/admin/WebCenterAdmin-CustomAttributes.jspx

ここでhostおよびportは、WC_SpacesサーバーのホストおよびポートのIDです。

3. 次に示すように新しいホットキー・シーケンスを設定します。

oracle.webcenter.security.impersonation.key=new key

ここでnew keyは、Ctrl-Shiftに追加する単一の文字です。デフォルトの"I"を別の単一文字でオーバーライドすることだけ可能です。Ctrl-Shiftシーケンスは事前定義されており、このキーよりも常に優先されます。オーバーライドされる文字が他のコンポーネント、ツールまたはプラグインによって使用されていないことを必ず確認してください。たとえば、Ctrl-Shift-Mはメニューで使用され、Ctrl-Shift-KおよびCtrl-Shift-Jは開発者ツールやエラー・コンソールなどのブラウザ・プラグインでときどき使用されます。

4. WC_Spacesサーバーを再起動して、変更を有効にします。

38.8 WebCenter Portal偽装の監査ログの管理

WebCenter Portal偽装を有効にすると、Fusion Middleware Audit Serviceの一部として偽装関連のイベントのログ記録がアクティブになります。デフォルトでは、監査ログ・イベントはファイル(監査バスストップ)に格納されますが、データベースにアップロードして永続化することもできます。

注意:
WebCenter Portal偽装を有効にする場合は、監査ログも有効にすることを強くお薦めします。偽装を有効にすると、監査ログによって、偽装者、被偽装者および各偽装イベントのコンテキストが追跡されます。
監査バスストップ・ファイルの容量は限られているため、イベントの発生後、それらが問合せ可能になるまでに時間がかかる場合は、ログ情報をデータベースに格納することもお薦めします。

偽装監査ログの主な利点は次のとおりです。

- ポータル、ポータル・サーバーおよびポータル・サーバーの主要アーティファクトのセキュリティ設定を変更するイベントを追跡できます。

- 監査可能なイベントには、偽装者、被偽装者およびイベントのコンテキストの定義に役立つすべての関連イベント・ペイロードが含まれます。

- ロギング・レベルを定義できます。

- ログに記録されたイベントをデータベースにアップロードすると、それらは永続的に参照可能になります。

- 監査サービスを通じて、監査イベントに関するレポートを参照できます。

WebCenter Portalの監査ログの管理の詳細は、第29章「Oracle WebCenter Portal監査ログの管理」を参照してください。 監査サービスでデータベースを使用するための構成の詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の監査の構成と管理に関する項を参照してください。

第VIII部

ライフサイクル: WebCenter Portal

『Oracle WebCenter Portalの管理』のこの部では、WebCenter Portalのライフサイクル操作について説明します。

第VIII部の内容は次のとおりです。

- 第39項「WebCenter Portalのライフ・サイクルの理解」

- 第40項「ポータル、テンプレート、アセットおよび拡張機能のデプロイ」

- 第41項「WebCenter Portalのバックアップ、リカバリおよびクローニングの管理」

39 WebCenter Portalのライフ・サイクルの理解

この章では、WebCenter Portalをそのライフ・サイクル全体を通して管理するためのタスク、ツールおよび手法について説明します。

この章には次のトピックが含まれます:

- 第39.1項「WebCenter Portalのライフ・サイクルとは」

- 第39.2項「主要なWebCenter Portalのライフ・サイクル・タスクとは」

- 第39.3項「WebCenter Portalのライフ・サイクルへの参加者」

- 第39.4項「WebCenter Portalのステージング環境および本番環境の理解」

- 第39.5項「WebCenter Portalのライフ・サイクルを管理するツール」

- 第39.6項「WebCenter Portalのライフ・サイクル操作の実行に必要な権限」

- 第39.7項「WebCenter Portalのステージング環境または本番環境の初回の設定」

- 第39.8項「開発環境からのWebCenter Portalデプロイメントの管理」

- 第39.9項「ステージングから本番へのポータル変更の管理」

- 第39.10項「本番からステージングへの変更の管理」

- 第39.11項「WebCenter Portalのライフ・サイクルを通したセキュリティの管理」

- 第39.12項「WebCenter Portalのライフ・サイクルを通したバックアップの管理」

注意:
Portal Frameworkアプリケーションには異なるライフ・サイクルがあります。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「WebCenter Portal Frameworkアプリケーション・ライフ・サイクルの理解」を参照してください。

権限:
この章のタスクを実行するには、次のロールが付与されている必要があります。

- WebLogic Server: Adminロール。Oracle WebLogic Server管理コンソールから付与します。

- WebCenter Portal: Administratorロール。ポータル・ビルダー管理から付与します。

第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

39.1 WebCenter Portalのライフ・サイクルとは

ポータルのライフ・サイクルとは、ポータル・ビルダーを使用したデプロイメントによるポータルの作成から本番インスタンスまでの過程を表します。開発者、コンテンツ・モデラー、コンテンツ・コントリビュータ、IT管理者、ポータル・サイト管理者を含む多くのアクターが、ライフ・サイクルに関与します。ライフ・サイクルのフェーズには、通常、開発、テスト、ステージングおよび本番が含まれます。各フェーズでは特定のタスクを実行する必要があります。コンテンツ・リポジトリの設定など、一部のタスクは一度だけ実行します。その他のタスクは、バックアップの作成や夜間ビルドの実行などで頻繁に実行されます。ポータルのライフ・サイクルのフェーズを、表39-1に示します。

表39-1 WebCenter Portalのライフ・サイクルのフェーズ

ライフ・サイクル・フェーズ

主要なアクター/ロール

説明

開発

- ポータル開発者

- Web開発者

- コンテンツ・モデラー

- コンテンツ・コントリビュータ

- アプリケーション・スペシャリスト

開発者は、WebCenter Portalのブラウザベースのツールであるポータル・ビルダーを使用して、新しいポータルを開発できます。

高度な要件に対応するために、開発者はJDeveloperを使用して、ポータル・アセットと共有ライブラリ(カスタム・ポータル・コンポーネントを含む)のさらなる開発およびデプロイを行うことができます。

開発ポータルは、通常、テストのデータとコンテンツを使用します。ライフ・サイクルのこのフェーズで開発される機能の一部は、次のとおりです。

- ポータル

- ポートレット

- タスク・フロー

- 共有ライブラリ

- スキン

- ナビゲーション・モデル

- ページ・テンプレート

- 表示テンプレート

- コンテンツ・モデル

- データ転送とポートレット間通信

- 初期セキュリティ

テスト

- 開発者

- QAエンジニア

- システム管理者

開発ポータルは、独立したテスト環境にデプロイされます。テスト環境には、通常、独自のMetadata Service (MDS)とデータベース・ベースのポリシー・ストア、および専用のOracle WebCenter Contentインスタンスが含まれています。

テスト環境には、本番ポータルには組み込まれないテスト・データやテスト・コンテンツが含まれることもあります。

ポートレット・プロデューサは、テスト環境と開発環境で共有される場合もあります。ただし、使用負荷が高い場合には、個別インスタンスの作成をお薦めします。

ステージング

- アプリケーション・スペシャリスト

- システム管理者

- コンテンツ・コントリビュータ

ステージング環境では、ポータルが本番に移行する前に最終的な構成およびテストが行われる安定した環境が提供されます。コンテンツ・コントリビュータはコンテンツを追加して、ポータルの構造を調整します。

一般に、ステージング環境には、専用のOracle WebCenter Contentサーバーだけでなく、専用のポートレット・プロデューサ・サーバー(WC_Portlet)、分析、アクティビティ・グラフおよびデータ統合のためのユーティリティ・サーバー(WC_Utilities)、およびディスカッションとお知らせのためのコラボレーション・サーバー(WC_Collaboration)が含まれます。ステージング・サーバーは、通常、本番サイトのミラーとして保持されます。

本番

- アプリケーション・スペシャリスト

- システム管理者

- コンテンツ・コントリビュータ

- ナレッジ・ワーカー

本番ポータルはライブで、エンド・ユーザーも使用できます。本番のポータルは、オンライン状態のときに、ポータル・ビルダー、「アセット」ページおよびコンポーザなどのツールで変更できます。たとえば、管理者はポータルにポートレットをさらに追加したり、ポータルのコンテンツを再構成できます。

適切な権限を持った個々のユーザーは、ビューをカスタマイズすることも可能です。

WebCenter Portalでは、ポータルとコンテンツを本番環境に移行するための一連のWLSTコマンドを用意しています。第40.7項「ステージングから本番へのポータルの移動」を参照してください。

一部のバックエンド・データは手動で移動する必要があります。詳細は、第40.8項「ステージングから本番への外部ポータル・データの移動」を参照してください。

注意: 管理者は、2つの環境が「同期」状態の場合、つまり、必ず最初にステージの変更を行い、その後デプロイメントまたは伝播を使用してメタデータの変更を本番にプッシュすることにより、ステージングのメタデータの変更を本番に伝播できます。詳細は、第40.9項「本番でのポータルの管理」を参照してください。

39.2 主要なWebCenter Portalのライフ・サイクル・タスクとは

ライフ・サイクルの各フェーズでは、特定のタスクを実行するアクター(開発者、管理者、コンテンツ・コントリビュータなど)が必要です。ここでは、ポータルのライフ・サイクルの各フェーズで実行されるタスクの種類の概要を示します。

- 第39.2.1項「1回かぎりの設定タスク」

- 第39.2.2項「開発環境のタスク」

- 第39.2.3項「ステージ環境のタスク」

- 第39.2.4項「本番環境のタスク」

39.2.1 1回かぎりの設定タスク

WebCenter Portalに対して開発、テスト、ステージおよび本番の各環境を設定するには、特定の準備手順を実行する必要があります。表39-2に、これらの予備設定タスクおよびそれを適用する環境の一般的なリストを示します。

第39.7項「WebCenter Portalのステージング環境または本番環境の初回の設定」を参照してください。

表39-2 一般的な1回かぎりの設定タスク

設定タスク

JDeveloperの開発
(アセットと共有ライブラリのみ)

ポータル・ビルダーの開発/テスト

ステージ

本番

Oracle JDeveloperおよびJDeveloperのWebCenter Portal拡張機能のインストール

はい

いいえ

いいえ

いいえ

Oracle WebCenter Portalのインストール

いいえ

はい

はい

はい

Oracle WebLogic Serverのインストール(ドメインおよび管理対象サーバーの作成)

いいえ

はい

はい

はい

RCUによる必要なデータベース・スキーマの作成

いいえ

はい

はい

はい

Oracle WebCenter Contentのインストールおよび構成

はい

はい

はい

はい

Oracle Access Managerなどのアイデンティティ管理コンポーネントのインストール

いいえ

はい

はい

はい

ポリシー・ストアでの必須のOracle Platform Security Servicesポリシーの作成

いいえ

はい

はい

はい

資格証明ストアでの必要なユーザー資格証明の作成

いいえ

はい

はい

はい

バックエンド・サーバーへの接続の作成

はい

はい

はい

はい

ソース・コントロールおよび夜間ビルド・スクリプトの設定

はい

いいえ

いいえ

いいえ

デプロイおよび構成スクリプトの作成

いいえ

はい

はい

はい

バックアップ・スクリプトの作成

いいえ

いいえ

はい

はい

WebCenter Portalのパーソナライズの統合/構成

はい

はい

はい

はい

39.2.2 開発環境のタスク

開発者は、WebCenter Portalのブラウザベースのツールであるポータル・ビルダーを使用して、新しいポータルおよびポータル・コンポーネントを開発できます。

高度な要件に対応するために、開発者はJDeveloperを使用して、ポータル・アセット、共有ライブラリ(カスタム・ポータル・コンポーネントを含む)およびポートレットのさらなる開発およびデプロイを行うことができます。JDeveloper開発環境では、各開発者に、ソース・コントロール・システムおよび共有Oracle WebCenter Contentリポジトリに接続されている、ローカルのJDeveloperインスタンスがあります。

39.2.3 ステージ環境のタスク

WebCenter Portalは、開発環境よりステージング環境において、より大きな役割を果たします。しかし、ポートレット、タスク・フローおよびポータル・アセットに対して開発から時折更新が発生した場合、これをステージ環境にデプロイする必要があります。これらの断続的な更新を容易に実行するために、WebCenter Portalでは、一連のWLSTコマンドおよびWebCenter Portal内の同等のメニュー・オプションが用意されており、ポータル・アセットの更新を開発からステージにインポートすることができます。ステージング環境でポートレットとタスク・フローを更新する場合は、通常の方法で再デプロイします。

詳細は、第39.4.1項「WebCenter Portalのステージング環境の設定」および第40章「ポータル、テンプレート、アセットおよび拡張機能のデプロイ」を参照してください。

39.2.4 本番環境のタスク

ステージ環境で変更をテストして承認したら、これらを本番環境にプッシュする必要があります。WebCenter Portalでは、一連のWLSTコマンドおよびWebCenter Portal内のインポート/エクスポート・オプションが用意されており、ステージでデプロイされたポータル・サーバー全体または個々のポータル、ポータル・テンプレートおよびアセットを本番にプッシュすることができます。詳細は、第41.5項「別のターゲットへのWebCenter Portal全体の移行」および第40.7項「ステージングから本番へのポータルの移動」を参照してください。

さらに、WebCenter Portalでは、ポータルのメタデータへの変更のみをステージから本番サーバーに伝播するWLSTコマンドが用意されています。詳細は、第40.9.3項「ステージングから本番へのポータル変更の伝播」を参照してください。

エクスポート/インポート・プロセス時に、必要に応じて、サーバー名、ポート、コンテンツ管理接続など、環境間で異なる接続情報を分けて変更できます。

注意:
ステージからの変更および更新をデプロイすると、ステージ環境に存在しない新しい接続がターゲット上に作成されますが、本番で構成された既存の接続が変更されることはありません。

39.3 WebCenter Portalのライフ・サイクルへの参加者

多くの様々な人がポータルのライフ・サイクルに関与します。通常、その人々(表39-1における主要なアクター)は次の一般的なロールのいずれかに(複数の場合もあり)分類されます。

- 開発者: JDeveloperを使用して、WebCenter Portal用のポートレット、タスク・フロー、ポータル・アセットおよび共有ライブラリを構築/拡張/デプロイし、ソース・コントロールの管理も行います。

- Web開発者: ポータル・ビルダーを使用して、ポータルの構築および開発を行います。

- システム管理者: WLSTコマンドを使用して、異なる環境間でポータルを移動します。バックアップを作成して、バックアップからリストアします。ビルドおよびソース・コントロール・システムをメンテナンスします。
WebCenter Portalに対する完全な管理権限を持っています。WebCenter Portal管理を使用して、グローバルなレイアウトの変更、ツールとサービスの有効化、セキュリティ設定の委任などを行います。

- アプリケーション・スペシャリスト: 「アセット」ページを使用して、ポータル構造の拡張およびポータルに対する再利用可能なコンポーネントの定義を行います。

- コンテンツ・モデラー: Oracle WebCenter ContentのSite Studioデザイナを使用してコンテンツをモデリングします。

- コンテンツ・コントリビュータ: イメージ、ドキュメント・ファイル、ビデオおよびオーディオ・コンテンツなど、ポータルに表示される、またはポータルから使用できるすべてのコンテンツを開発します。

- ナレッジ・ワーカー: 本番ポータルのエンド・ユーザーまたはコンシューマ。コンテンツの検索、作成および更新を行います。他のビジネス・ユーザーとコラボレーションします。

39.4 WebCenter Portalのステージング環境および本番環境の理解

この項では、ポータルのライフ・サイクルのステージング・フェーズおよび本番フェーズについて説明します。図39-1に、ステージング環境から本番環境への一般的な流れを示します。この図では、最初にWebCenter Portalインスタンス全体のステージング環境から本番環境への移行を示しています。

後でポータルが更新されたり、ステージで新しいポータルが開発された場合、それらを必要に応じて本番に移行することができます。WLSTのdeployまたはpropagateコマンドを使用して、ステージでの更新を直接本番に移行したり、ポータル・ビルダーまたはWLSTのexportおよびimportコマンドを使用して、ステージでの更新のファイルへのエクスポートおよび本番サーバーへのインポートを行うことができます。

注意:
図39-1は、考えられるすべてのポータル機能を表してはいません。

図39-1 WebCenter Portalステージング環境から本番環境への流れ

39.4.1 WebCenter Portalのステージング環境の設定

ステージング環境では、ポータルが本番に移行する前に最終的な構成およびテストが行われる安定した環境が提供されます。一般に、ステージング環境には、専用のコンテンツ・サーバー、ディスカッション・サーバーだけでなく、専用のポートレット・プロデューサ・サーバーおよびユーティリティ・サーバー(分析、アクティビティ・グラフおよびデータ統合用)が含まれます。ステージング環境では、外部のLDAPベースのアイデンティティ・ストア(Oracle Internet Directoryなど)も設定する必要があります。一般的な設定タスクのリストは、表39-2 「一般的な1回かぎりの設定タスク」を参照してください。

初めてステージング環境を設定する場合には、次を参照してください。

- 第39.7項「WebCenter Portalのステージング環境または本番環境の初回の設定」

ステージング環境への増分変更の詳細は、次を参照してください。

- 第40.7項「ステージングから本番へのポータルの移動」

- 第40.6項「ステージングから本番への接続の詳細の移動」

- 第40.8項「ステージングから本番への外部ポータル・データの移動」

39.4.2 WebCenter Portalステージング環境へのコンテンツの追加

コンテンツ開発者は、コンテンツをステージング・サーバーに直接追加できます。Oracle WebCenter Contentのコンテンツ・ワークフロー機能を使用して、コンテンツの承認を管理できます。また、WebCenter Portalにはポータル・コンテンツの作成および編集用のブラウザ・ツールが備わっています。

ポータルを作成またはデプロイする際、WebCenter Portalではバックエンド・コンテンツ・サーバー上にポータル専用のフォルダを作成します。ポータルをステージから本番に移動するときに、オプションで、ポータルとともにポータルのコンテンツ・フォルダを移動できます。第40.7項「ステージングから本番へのポータルの移動」を参照してください。

39.4.3 ステージングから本番へのポータルの移動

ステージング環境は、プロビジョニングおよびテストが完了すると、本番環境に移行してユーザーがアクセスできるようになります。初めてステージング環境を本番環境にコピーする場合は、ステージのWebCenter Portalインスタンス全体を本番環境に移行します。その後、本番環境がライブ状態になったら、WLSTコマンド、自動WLSTスクリプトおよびレプリケーション・テクニックを使用して、ポータルのメタデータ、コンテンツおよびアセットに対する増分更新を実行できます。

通常、ポータルの更新はシステム管理者が実行します。詳細は、第40.7項「ステージングから本番へのポータルの移動」を参照してください。

更新プロセス時に、必要に応じて、サーバー名、ポート、コンテンツ管理接続など、環境間で異なる接続情報を分けて変更できます。詳細は、第40.6項「ステージングから本番への接続の詳細の移動」を参照してください。

注意:
ステージからの変更および更新をデプロイすると、ステージ環境に存在しない新しい接続がターゲット上に作成されますが、本番で構成された既存の接続が変更されることはありません。

新規の/更新されたポータル・テンプレートおよびアセットは、アプリケーション・スペシャリストが本番サーバーにプッシュすることができます。第40.2項「ポータル・テンプレートのデプロイ」および第40.3項「アセットのデプロイ」を参照してください。

39.5 WebCenter Portalのライフ・サイクルを管理するツール

WebCenter Portalには、ポータルの設計、構築、デプロイ、および開発 - テスト - ステージ - 本番環境間またはWebCenter Portalインストール間での情報の移動を行うことができる、一連のツールおよびユーティリティが用意されています。

- Oracle JDeveloperおよびOracle ADF: Oracle JDeveloperおよびOracle ADFには、ポートレットの構築とデプロイおよびポータル・アセットの拡張とデプロイを行うためのツールとフレームワークが備わっています。
ポータル用のカスタム・タスク・フローやその他のカスタム・コンポーネントを開発し、WebCenter Portalの共有ライブラリにデプロイして使用することもできます。

- ラウンドトリップ開発: ラウンドトリップ開発とは、メンテナンスや機能強化のために、ポータル・アセットをWebCenter PortalからエクスポートしてJDeveloperにインポートしなおすことができる機能および手法です。ラウンドトリップ開発の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の反復およびラウンドトリップ開発手法の使用に関する項を参照してください。

- エンタープライズ・デプロイメント: ポータルを本番環境にデプロイする準備が整ったら、WLSTのexportWebCenterPortalsおよびimportWebCenterPortalsコマンドを使用できます。詳細は、第40.9.2項「ステージングから本番へのポータルの直接デプロイ」および第40.1.2項「ポータル・アーカイブのデプロイ」を参照してください。
または、メタデータの変更をステージから本番に伝播できるように、ステージ環境と本番環境を接続して「同期」状態を維持する場合、WLSTコマンドdeployWebCenterPortalsを使用します。第40.1項「ポータルのデプロイ」も参照してください。

- ブラウザベースの管理ツール: 次に示す様々なブラウザベースのツールにより、管理者はポータル・デプロイメントを構成、管理およびモニターできます。

- ポータル・ビルダー管理

- Enterprise Manager Fusion Middleware Controlコンソール

- WebLogic Server管理コンソール

詳細は、第1.13項「Oracle WebCenter Portalの管理ツール」を参照してください。表39-3「ライフ・サイクル操作のためのWebCenter PortalおよびWebLogic Serverの権限の要件 」も参照してください。

- スクリプト・ツール: システム管理者は、ポータル・デプロイメントを構成、管理、バックアップおよびリストアできます。
詳細は、第1.13.3項「Oracle WebLogic Scripting Tool (WLST)」を参照してください。

39.6 WebCenter Portalのライフ・サイクル操作の実行に必要な権限

表39-3は、ライフ・サイクル操作の実行に必要なWebLogic ServerのロールおよびWebCenter Portalの権限を示しています。

表39-3 ライフ・サイクル操作のためのWebCenter PortalおよびWebLogic Serverの権限の要件

WebCenter Portalオブジェクト

ツール

WebLogic
Serverのロール

WebCenter Portalの権限

ポータル

ポータルをWebCenter Portalから直接デプロイ

WLST

Monitor
(またはそれ以上)

Portals - Manage Security and Configuration

ポータルをWebCenter Portalから直接伝播

WLST

Monitor
(またはそれ以上)

Portals - Manage Security and Configuration

ポータル・アーカイブをインポートまたはエクスポート

WLST

Monitor
(またはそれ以上)

Portals - Manage Security and Configuration

ポータル・アーカイブをインポートまたはエクスポート

WebCenter Portal

-

Portals - Manage Security and Configuration

ポータル・テンプレート

ポータル・テンプレート・アーカイブをインポートまたはエクスポート

WLST

Monitor
(またはそれ以上)

Portal Templates - Manage All

ポータル・テンプレート・アーカイブをインポートまたはエクスポート

WebCenter Portal

-

Portal Templates - Manage All

ポータル・アセット

アセット・アーカイブをインポートまたはエクスポート

WLST

Monitor
(またはそれ以上)

次のいずれか:

- Create、Edit、Delete Assets

- Create、Edit、Delete <Portal_Asset_Type>

アセット・アーカイブをインポートまたはエクスポート

WebCenter Portal

-

Portal - Manage Configuration

および次のいずれか:

- Create、Edit、Delete Assets

- Create、Edit、Delete <Portal_Asset_Type>

アセット・アーカイブをインポートまたはエクスポート

JDeveloper

-

-

ポータル拡張機能 (ADF共有ライブラリ)

ポータル拡張機能をJDeveloperから直接デプロイ

JDeveloper

Monitor
(またはそれ以上)

Portals - Manage Security and Configuration

ポータル拡張機能アーカイブをインポートまたはエクスポート

JDeveloper

-

-

ポータル接続

接続をインポートまたはエクスポート

WLST

Operator
(またはそれ以上)

-

共有アセット

アセット・アーカイブをインポートまたはエクスポート

WLST

Monitor
(またはそれ以上)

Create、Edit、Delete <Shared_Asset_Type>

アセット・アーカイブをインポートまたはエクスポート

WebCenter Portal

-

Application - Manage Configuration

Create、Edit、Delete <Shared_Asset_Type>

アセット・アーカイブをインポートまたはエクスポート

JDeveloper

-

-

WebCenter Portal (すべてのポータル)

アーカイブをインポートまたはエクスポート

WLST

Monitor
(またはそれ以上)

Application - Manage

アーカイブをインポートまたはエクスポート

Fusion Middleware Control

Monitor
(またはそれ以上)

Application - Manage

39.7 WebCenter Portalのステージング環境または本番環境の初回の設定

初めてWebCenter Portalのステージ環境および本番環境を設定する場合は、『Oracle WebCenter Portalインストレーション・ガイド』の指示に従います。両方の環境が設定され、ステージ環境を本番サーバーに移行する準備が整ったら、第41章「別のターゲットへのWebCenter Portal全体の移行」

セキュリティ・ポリシーおよび資格証明を初めて環境に移動する際の詳細は、 第39.11項「WebCenter Portalのライフ・サイクルを通したセキュリティの管理」も参照してください。

注意:
ステージ・インスタンスからFusion Middleware本番インスタンス全体をクローニングすることは、「テストから本番へ」と呼ばれることもあります。WebCenter Portalインスタンスを他のFusion Middlewareコンポーネントとともにクローニングする方法の詳細は、管理者ガイドのOracle WebCenter Portalの新しいターゲット環境への移動に関する項を参照してください。

39.8 開発環境からのWebCenter Portalデプロイメントの管理

新しいポータル・アセットおよび拡張機能のテストが完了したら、開発者は通常、新しいコンポーネントをアーカイブにデプロイし、WebCenter Portalへのデプロイメントのために管理者に提供します。たとえば、ポータル・アセット・アーカイブ(.earファイル)、ADFライブラリ(.jarファイル)および共有ライブラリ(.warファイル)などです。

開発者は、適切な権限が与えられた場合、JDeveloperからWebCenter Portalにアセット/拡張機能を直接デプロイすることができます。たとえば、開発者がテスト環境でアセット/拡張機能のデプロイを許可されても、ステージ・サーバーおよび本番サーバーにデプロイできない場合があります。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の拡張機能のポータル・サーバーへの直接デプロイに関する項およびアセットのWebCenter Portalへの直接アップロードに関する項を参照してください。

39.9 ステージングから本番へのポータル変更の管理

実際には、ステージング環境と本番はステージ環境に変更が施されるまでは同一のままです。承認された変更は、次の2つの方法で本番に移動できます。

- ステージでの更新をファイルにエクスポートし、次にポータル・ビルダーまたはWLSTコマンドを使用してファイルの変更を本番サーバーにインポートします。

- WLSTのdeployまたはpropagateコマンドを使用して、ステージでの更新を本番に直接デプロイします。

伝播機能は、ポータル・メタデータ(ページ、アセット、ページで削除されたポートレットなど)の変更を移行する場合に便利です。伝播ではポータル・メタデータの変更のみが転送されるため、本番サーバーを再起動する必要はなく、ダウンタイムは生じません。伝播機能を使用する場合、本番に対する変更の最初のセットを、deployWebCenterPortalコマンドを使用して移動する必要があります - このコマンドにより、本番インスタンス上にステージ・ポータル全体が再作成され、ステージ・ポータルおよび本番ポータル上に照合ラベル(たとえば、LABEL_1)が作成されます。その後、変更をステージから本番に伝播するときに、ステージと本番の両方の環境で、ポータルのラベルが1だけ増分されます。ラベルが一致した場合のみ、ポータルの変更を別のポータル・インスタンスに伝播できます。

詳細は、第40.9項「本番でのポータルの管理」を参照してください。

付録E「WebCenter Portalのライフサイクル中のラベル付け」も参照してください。

39.10 本番からステージングへの変更の管理

WLSTコマンドまたはポータル・ビルダー管理を使用して、個々の本番ポータルをアーカイブにエクスポートし、ステージング・サイトにインポートしなおすことができます。詳細は、第40.1.2.2項「別のサーバーへのポータル・アーカイブのデプロイ」を参照してください。

本番システム全体をステージにミラー化する場合、本番WebCenter Portalインスタンスをバックアップ/リストアするか、または本番WebCenter Portalインスタンスを実行しているWebLogic Serverをクローニングします。詳細は、第41章「WebCenter Portalのバックアップ、リカバリおよびクローニングの管理」を参照してください。

39.11 WebCenter Portalのライフ・サイクルを通したセキュリティの管理

この項では、ポータルのセキュリティ・ポリシーと資格証明をあるWebCenter Portal環境から別の環境へ移行する手法について説明します。

単一のポータルのセキュリティ・ポリシー

ポータルごとに、独自のセキュリティ・ポリシーがあります。初めてWebCenter Portalインスタンスにポータルをデプロイする場合、ポータルのセキュリティ・ポリシーを組み込む必要があります。再デプロイ時には、セキュリティ・ポリシーはオプションになります。たとえば、ポータルをステージングから本番に再デプロイするときには、多くの場合、本番システム上で行われたポリシーの変更をオーバーライドしないことが重要です。第40.1項「ポータルのデプロイ」も参照してください。

WebCenter Portalアプリケーション全体のセキュリティ・ポリシー(ホーム・ポータルを含む、すべてのポータル)

WebCenter Portalアプリケーション全体をバックアップ(またはエクスポート)するときには、ホーム・ポータルまたは個々のポータルのセキュリティ・ポリシーがアーカイブに含まれるので、セキュリティ情報をあるインスタンスから別のインスタンスに移動/リストアすることができます。詳細は、第41.5項「別のターゲットへのWebCenter Portal全体の移行」を参照してください。

WebCenter Portalに対するバックエンドのアイデンティティ・ストアおよび資格証明ストア

別のインスタンスに移行する場合、アイデンティティ・ストア、資格証明ストア、ポリシー・ストアなどの、セキュリティに関するバックエンド・コンポーネントを移行する必要があります。詳細は、第41.6.7項「ポリシー・ストアのバックアップおよびリストア(LDAPとデータベース)」および第41.6.8項「資格証明ストアのバックアップおよびリストア(LDAPとデータベース)」を参照してください。

39.12 WebCenter Portalのライフ・サイクルを通したバックアップの管理

詳細は、第41章「WebCenter Portalのバックアップ、リカバリおよびクローニングの管理」を参照してください。

40 ポータル、テンプレート、アセットおよび拡張機能のデプロイ

WebCenter Portalには、WebCenter Portalインストールと、ステージング環境または本番環境との間で管理者が情報をデプロイ、バックアップあるいは移動できる一連のユーティリティが用意されています。

この章には次のトピックが含まれます:

- 第40.1項「ポータルのデプロイ」

- 第40.2項「ポータル・テンプレートのデプロイ」

- 第40.3項「アセットのデプロイ」

- 第40.4項「デバイスおよびデバイス・グループのデプロイ」

- 第40.5項「カスタム共有ライブラリの拡張機能のデプロイ」

- 第40.6項「ステージングから本番への接続の詳細の移動」

- 第40.7項「ステージングから本番へのポータルの移動」

- 第40.8項「ステージングから本番への外部ポータル・データの移動」

- 第40.9項「本番でのポータルの管理」

- 第40.10項「制限事項」

権限:
この章の内容は、システム管理者を対象としています。
ポータル、テンプレート、アセット、接続および拡張機能のデプロイに必要なロールと権限の詳細は、第39.6項「WebCenter Portalのライフ・サイクル操作の実行に必要な権限」を参照してください。

第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

40.1 ポータルのデプロイ

この項には次のトピックが含まれます:

- 第40.1.1項「ポータルのデプロイメントについて」

- 第40.1.2項「ポータル・アーカイブのデプロイ」

- 第40.9.2項「ステージングから本番へのポータルの直接デプロイ」

- 第40.1.3項「ポータル階層のデプロイ」

40.1.1 ポータルのデプロイメントについて

ポータルを別のポータル・サーバーにデプロイする場合、ターゲット・サーバーにソース・ポータルをコピーして、ソース・ポータルのデータの全部または一部を含めることができます。

ターゲット・サーバーに新しいポータルをデプロイする作業と既存のポータルを再デプロイする作業はまったく同じです。すでにターゲットに存在するポータルをデプロイする場合、そのポータルは削除され、新しいポータルとして再作成されます。

注意:
ポータル全体を再デプロイするのではなく、ソース・ポータルのメタデータの変更をターゲットに伝播する場合は、第40.9.3項「ステージングから本番へのポータル変更の伝播」を参照してください。

オンライン・ポータルをポータル・アーカイブにデプロイしたり、ポータルを別のサーバーに直接デプロイしたりすることができます。

- ポータル・アーカイブのデプロイメント: 多くの場合、ソース・ポータルのアーカイブ(.parファイル)を作成してから、アーカイブ・ポータルをターゲット・サーバーにインポートします。ポータル・ビルダー管理やWLSTコマンドを使用して、ポータルをアーカイブにエクスポートして、ポータルをファイルからインポートできます。
詳細は、第40.1.2.2項「別のサーバーへのポータル・アーカイブのデプロイ」を参照してください。

- ポータルの直接デプロイメント: ターゲット・サーバーに直接接続している場合、WLSTコマンドdeployWebCenterPortalを使用して、ポータルを別のターゲット・サーバーにデプロイできます。この方法は、ポータルのメタデータの変更を伝播する場合に便利です。
詳細は、第40.9.2項「ステージングから本番へのポータルの直接デプロイ」を参照してください。

図40-1「別のターゲット・サーバーへのポータルのデプロイ」に、ポータル(およびその関連データ)を別のサーバーに移動できる様々な方法を示します。

図40-1 別のターゲット・サーバーへのポータルのデプロイ

ポータルとともにデプロイされる情報

内部に格納されているデータ、つまり、WebCenter Portalデータベース、WebCenter ContentリポジトリおよびMDSに格納されているポータル・データは、ポータルと同時にターゲットにデプロイできます。要件に応じて、デプロイメント(またはインポート)に関するオプションを設定して、この情報をデプロイメントに含めたりデプロイメントから除外したりすることができます。

表40-1 ポータルのデプロイメントのオプション

ポータルとともにデプロイ可能な情報

WLSTのオプションimportWebCenterPortals

ポータル・ビルダーのインポート・オプション

WLSTのオプションdeployWebCenterPortal

ポータル・ページ

常に含まれる

常に含まれる

常に含まれる

アセット

- ページ・テンプレート

- ナビゲーション

- リソース・カタログ

- スキン

- ページ・スタイル

- コンテンツ・プレゼンタ表示テンプレート

- タスク・フロー・スタイル

- タスク・フロー

- データ・コントロール

- ページレット

常に含まれる

常に含まれる

常に含まれる

ポータル・コンテンツ・フォルダ

importPortalContent

コンテンツ・サーバー上のポータル・フォルダを含む

deployPortalContent

ポータルのアクティビティおよび使用状況データ:

- アクティビティ・ストリーム

- カレンダ・イベント

- フィードバック

- リスト

- リンク

- メッセージ・ボード

- ピープル・コネクション

- 投票

- プロファイル

- アンケート

importData

サービス・データを含む

deployData

ポータル・セキュリティ・データ:

(ポータルがターゲットに存在する場合のオプション)

- ポータルのロールおよび権限

- メンバーの詳細とそのロールの割当て

importSecurity

セキュリティを含む

deploySecurity

ポータルのカスタマイズ:

- ポータルレベルのカスタマイズ(システムのページ、アセット、タスク・フローなど)

- ユーザーレベルのカスタマイズ(ユーザー・パーソナライズと呼ばれる場合もある)

importCustomizations

カスタマイズを含む

deployCustomizations

ポータルのデプロイメントで移行されない情報

一部のポータル情報は、外部に格納されているため、ポータルと同時にデプロイできません。たとえば、次のような情報があります。

- ポータル・アセット、コンテンツ・プレゼンタまたはSite Studioで使用されるコンテンツ

- ポータル・ディスカッション

- ポータル・メール

- ポータル分析

- カスタム・タスク・フローおよび共有ライブラリ

- ポータル接続*

他にも、次のような移行されない情報があります。

- 共有アセット

- ホーム・ポータル

注意:
*接続は、個別にエクスポートおよびインポートされます。詳細は、第40.1.2.1.3項「接続プロパティ・ファイルの理解」を参照してください。

ソースWebCenter PortalインストールとターゲットWebCenter Portalインストールが異なる外部サーバーに接続されている状況で、ソース・ポータルに関連付けられた情報がターゲットで必要になる場合、外部ポータル・データを個別に移動する必要があります。詳細は、第40.8.1項「個々のポータルのバックエンド・コンポーネントの移行」を参照してください。

場合によっては、ソースとターゲットの両方で同じ外部サーバーを使用することもあります。たとえば、ポータル・プロデューサ・サーバーまたはOracle Internet Directoryサーバーは、どちらの環境でも共有されます。

40.1.2 ポータル・アーカイブのデプロイ

管理者は、ポータル・ビルダーまたはWLSTコマンドを使用して、ポータル・アーカイブ(.parファイル)を任意のWebCenter Portalデプロイメントにデプロイできます。ターゲットWebCenter Portalは、1つ以上のポータルをファイルからデプロイ(またはインポート)するときに稼働している必要があります。

図40-2 ポータル・アーカイブのデプロイ

この項には次のトピックが含まれます:

- 第40.1.2.1項「ポータル・アーカイブの理解」

- 第40.1.2.2項「別のサーバーへのポータル・アーカイブのデプロイ」

- 第40.1.2.3項「ポータル・アーカイブの作成」

- 第40.1.2.4項「アーカイブからの1つ以上のポータルのインポート」

- 第40.1.2.5項「ポータル・アーカイブの表示および抽出」

注意:
ポータルをアーカイブから別のサーバーにデプロイする場合、ポータル伝播を使用して後からポータルに増分更新を行うことはできません。ポータル伝播機能は、ポータルの直接デプロイメントで使用する場合のみ可能です。詳細は、第40.9項「本番でのポータルの管理」を参照してください。

40.1.2.1 ポータル・アーカイブの理解

ポータル・ビルダーまたはWLSTコマンドexportWebCenterPortalsを使用して、単一のポータル(ポータル階層全体)のポータル・アーカイブ(.parファイル)を作成したり、複数のポータルとポータル階層を同じ.parファイルにアーカイブしたりすることができます。

ポータル・アーカイブには、次の内容を含めることができます。

- ポータル・データの1つ以上のアーカイブ・ファイル(.pdr)

- エクスポート・ログ・ファイル(.log)

- WebCenter Portalの接続プロパティ・ファイル(connection.properties)

注意:
ポータル・アーカイブ(.parファイル)は、WLSTコマンドlistWebCenterPortalArchiveを使用して抽出できます。

図40-3 ポータル・アーカイブのデプロイメント

この項の内容は次のとおりです。

- ポータル・データ・ファイル(PDR)の理解

- エクスポート・ログ・ファイルの理解

- 接続プロパティ・ファイルの理解

40.1.2.1.1 ポータル・データ・ファイル(PDR)の理解

ポータル・アーカイブには、図40-3「ポータル・アーカイブのデプロイメント」に示すように、アーカイブに追加するポータルまたはポータル階層ごとにポータル・データ・ファイル(PDR)が含まれます。

ポータル・データ・ファイルには、次の2つのファイルが含まれます。

- transport.mar: 単一ポータルまたはポータル階層のメタデータ、データおよびコンテンツを取得するメタデータ・アーカイブ。

- メタデータ: ポータルのページ、アセット、グローバル・カスタマイズ、ユーザー・カスタマイズ、ポートレットなどの、MDSに格納されているメタデータ。

- データ: WebCenter Portalデータベース表に格納されている、ポータル・アクティビティ、ポータル・イベントなどのデータ。

- コンテンツ: ドキュメント・サービスを提供するポータル専用に作成されるフォルダのコンテンツ。
フォルダは、oracle\webcenter\lifecycle\importexport\data\oracle-webcenter-doclib\docsexport.zipにある.zipファイルにアーカイブされます。

アーカイブには、他の場所に格納される、ポータルやコンテンツで参照されるWebコンテンツは含まれません。バックエンドWebCenter Content Serverのポータルに割り当てられたフォルダのみがポータルとともに含まれます。

- policy-store.xml: ポータルまたはポータル階層のセキュリティ・ポリシー。

表40-2「ポータル・アーカイブ(PDRファイル)にエクスポートされる情報」では、.pdrファイルに含まれる情報について詳しく説明します。また、この表では、ファイル内の情報の場所を示し、インポート時にオプションとなる情報が強調表示されています。

表40-2 ポータル・アーカイブ(PDRファイル)にエクスポートされる情報

PDRファイルにエクスポートされる情報

エクスポート

インポート

PDRの場所

常時/オプション/不可

ポータル・ページ

常時

常時

\transport.mar\oracle\webcenter\page\

ポートレット

常時

常時

\oracle\adf\portlet

ポータル・アセット

- ページ・テンプレート

- ナビゲーション

- リソース・カタログ

- スキン

- ページ・スタイル

- コンテンツ・プレゼンタ表示テンプレート

- タスク・フロー・スタイル

- タスク・フロー

- データ・コントロール

- ページレット

常時

常時

\transport.mar\oracle\webcenter\siteresources\

ポータル・コンテンツ・フォルダ

オプション

オプション

\transport.mar\oracle\webcenter\lifecycle\importexport\data\oracle-webcenter-doclib\docsexport.zip

ポータルのアクティビティおよび使用状況データ:

- アクティビティ・ストリーム

- カレンダ・イベント

- フィードバック

- リスト

- リンク

- メッセージ・ボード

- ピープル・コネクション

- プロファイル

- 投票

- アンケート

- タグ

常時

オプション

\transport.mar\oracle\webcenter\lifecycle\importexport\data

ポータル・セキュリティ・データ:

- ポータルのロールおよび権限

- メンバーの詳細とそのロールの割当て

常時

オプション

(ポータルがターゲットに存在する場合)

policy-store.xml

ポータルのカスタマイズ:

- ポータルレベルのカスタマイズ(システムのページ、アセット、タスク・フローなど)

- ユーザーレベルのカスタマイズ(ユーザー・パーソナライズと呼ばれる場合もある)

常時

オプション

\transport.mar\oracle\webcenter\

次の手段でポータルによって参照される外部コンテンツ:

- ポータル・ページ

- ポータル・アセット

- コンテンツ・プレゼンタ表示テンプレート

- Site Studio

- その他

不可*

-

-

外部サーバーに格納されるデータ:

- ディスカッション

- メール

- お知らせ

- 分析

- カスタム・タスク・フローおよび共有ライブラリ

不可*

-

-

共有アセット

不可*

-

-

ホーム・ポータル

不可*

-

-

*PDRファイルに含まれない情報

ポータル・データ・アーカイブには、共有アセットやホーム・ポータルに関連する情報は含まれません。

ポータル・データ・アーカイブには、ポータル独自のコンテンツ・フォルダの外部に格納されるコンテンツ(ポータル・アセット、ポータル・ページ、コンテンツ・プレゼンタまたはSite Studioで使用されるコンテンツなど)は含まれません。同様に、アーカイブには、ディスカッション、お知らせおよびメールなどの外部で格納されるデータも含まれません。このデータを移動する方法については、第40.8.1項「個々のポータルのバックエンド・コンポーネントの移行」を参照してください。

40.1.2.1.2 エクスポート・ログ・ファイルの理解

1つ以上のポータルをエクスポートする場合、ポータル・アーカイブ(.parファイル)内にはログ・ファイル(.logファイル)があります。エクスポート・ログには、すべてのポータル、MDSメタデータ・ファイル、およびアーカイブに含まれるデータ(ポータル・データを含むデータベース表の名前)がリスト表示されます。

エクスポート・ログは、参照目的の場合やポータル・アーカイブを比較する場合に特に役立ちます。

例40-1「ポータル・アーカイブのエクスポート・ログ」に、エクスポート・ログの一般的な書式を示します。

例40-1 ポータル・アーカイブのエクスポート・ログ

Exporting portal: MySalesPortal

Processing subportals : MySales, TeamSales

MDS Documents included for portal: MySalesPortal, MySales, TeamSales
/oracle/webcenter/lifecycle/importexport/data.xml
/oracle/webcenter/siteresources/...
/oracle/webcenter/page/...
/pageDefs/oracle/webcenter/page/...
/oracle/webcenter/siteresources/...
/oracle/webcenter/space/metadata/spaces/...
/oracle/webcenter/translations/...
/oracle/webcenter/space/metadata/spaces/...
/oracle/webcenter/security/...
/oracle/webcenter/framework/scope/...

Exported database data for portal: MySalesPortal, MySales, TeamSales  at 2012-09-26-05:00:59

Database data included for portal: MySalesPortal, MySales, TeamSales
WC_LIST_ROW$
WC_RELATIONSHIP_RESOURCE
WC_RELATIONSHIP_RESOURCE_ATT
WC_RELATIONSHIP_INFO
WC_RELATIONSHIP
WC_RELATIONSHIP_INFO_ATT
WC_PPL_COMMON_SETTING
WC_SURVEY
WC_SURVEY_PROPERTY
WC_SURVEY_QUESTION
WC_SURVEY_QUESTION_PROPERTY
WC_CAL_CATEGORY
WC_CAL_EVENT
WC_CAL_ATTENDEE
WC_AS_ACTIVITY_ELEMENT
WC_AS_CUSTATTR
WC_AS_OBJECT_DETAIL
WC_AS_OBJECT
WC_AS_ACTOR_DETAIL
WC_AS_ACTOR
WC_COMMENT
WC_LIKE

Archive created for portal: MySalesPortal, MySales, TeamSales.

Portal data archive created: /tmp/expportal7553974727669501601/MySalesPortal-2012-09-26-05:00:59.pdr

40.1.2.1.3 接続プロパティ・ファイルの理解

WLSTコマンドexportWebCenterPortalsを使用してポータルをアーカイブにエクスポートする場合、ポートレット・プロデューサ、Webサービス、外部サーバーおよびアプリケーションに接続するためにソース・ポータル環境で使用される接続情報は、connection.propertiesというファイルに保存されます。connection.propertiesファイルはポータル・アーカイブ内に含まれ、コピーもポータル・アーカイブと同じディレクトリに配置されます。

接続情報は、バックアップの目的にかぎりポータル・アーカイブに含まれるため、ポータルをバックアップした時点の接続構成を簡単に確認できます。また、必要に応じて、その接続構成を、別の時点の接続構成またはWebCenter Portalインスタンスのリストア時の接続構成と比較できます。

接続の全部または一部が存在しないWebCenter Portalターゲットでポータルのインポート、デプロイ、伝播またはリストアを行う予定の場合、WLSTコマンドexportWebCenterPortalConnectionsを使用して、ソース環境からconnection.propertiesファイルを生成し、WLSTコマンドimportWebCenterPortalConnectionsを使用して、そのファイルで構成済の失われた接続をターゲット環境にインポートすることをお薦めします。詳しい手順は、第40.6.2項「ファイルからの新しいWebCenter Portal接続のインポート」を参照してください。

注意:

- connection.propertiesファイルは、WLSTコマンドexportWebCenterPortalsを使用してポータルをエクスポートすると生成されますが、このファイルは、ポータル・ビルダー管理からポータルをエクスポートする場合は含まれません。

- connection.propertiesファイルは、WLSTコマンドexportWebCenterPortalConnectionsを実行するときにも生成されます。詳細は、第40.6.1項「ファイルへのWebCenter Portal接続の詳細のエクスポート」を参照してください。

- ソースWebCenter Portal環境で構成されるすべての接続は、connection.propertiesにエクスポートされます。このファイルの接続情報は、アーカイブのポータルに固有ではありません。

- ターゲットには、新しい接続のみがインポートされます。ターゲットに存在する接続は無視されます。

接続の詳細の変更

サーバー名やポートなどの一部の接続情報がソース環境とターゲット環境で異なる場合、ポータルのインポート、デプロイ、伝播またはリストアを行う前に、ファイルの接続の詳細を分けて変更することができます。

表40-3に、ソースとターゲットで同じホストを使用しないために別のURLパラメータがターゲットで必要な場合の例を示します。

表40-3 例: ソース環境とターゲット環境で接続URLが異なる場合

接続タイプ

ソース接続: URLパラメータ

ターゲット接続: URLパラメータ

WSRPポートレット・プロデューサ

http://mysource.com:8899/MyWSRPPortletProducer/portlets/wsrp2?WSDL

http://mytarget.com:8899/MyWSRPPortletProducer/portlets/wsrp2?WSDL

PDK-Javaプロデューサ

http://source.host.com:7778/myJPDKPortletProducer/providers

http://target.host.com:7778/myJPDKPortletProducer/providers

Webサービス

http://source.example.com/getEmployee?empId=20+deptId=10

http://target.example.com/getEmployee?empId=20+deptId=10

図40-4に、新しい接続がターゲットに作成される前にソース・パラメータとターゲット・パラメータが変わる場合、接続の詳細をconnection.propertiesで編集する方法を示します。

図40-4 ターゲットでのconnection.propertiesを使用した接続の作成

接続タイプと接続プロパティ

表40-4に、connection.propertiesファイルで取得されるすべての接続と、各種接続タイプでエクスポートされるプロパティを示します。この表には、デプロイメント前に編集できるプロパティと、ターゲットで設定する必要があるプロパティも示されています。

注意:

- 特定の接続タイプに対する必須のプロパティまたはオプションのプロパティなど、個々の接続プロパティの詳細は、該当の接続タイプの章を参照してください。各章のリストについては、第VIII部「ツール、ポートレット・プロデューサおよび外部アプリケーションの管理」を参照してください。

- 表40-4でデプロイメント時に編集しますか?がはいとなっているプロパティのみをconnection.propertiesで編集することを強くお薦めします。なんらかの理由でデプロイメント時に編集しますか?がいいえのプロパティを編集する必要がある場合は、Fusion Middleware ControlまたはWLSTコマンドを使用してターゲットに接続を移行した後に編集できます。

表40-4 connection.propertiesにエクスポートされる接続プロパティ

接続タイプ

エクスポートされるプロパティ

デプロイメント時に編集しますか?

注意およびデプロイメント後の構成要件

WSRPポートレット・プロデューサ

url

proxyHost

proxyPort

timeout

externalApp

tokenType

defaultUser

issuerName

recipientAlias

はい

はい

はい

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

デプロイメント後のセキュリティ構成:

registrationProperties

keyStorePath

keyStorePswd

sigKeyAlias

sigKeyPswd

encKeyAlias

encKeyPswd

enforcePolicyURI

脚注 1

PDK-Javaプロデューサ

url

proxyHost

proxyPort

subscriberId

serviceId

sharedKey

timeout

establishSession

externalApp

はい

はい

はい

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

デプロイメント後のセキュリティ構成:

mapUser

useProxy

Webサービス接続

url

proxyHost

proxyPort

mtom

addressing

wsrm

security

はい

はい

はい

いいえ

いいえ

いいえ

いいえ

Webサービス接続は、データ・コントロールで使用されます。

脚注参照 1

URL接続:

HTTP URL

url

authenticationType

connectionClassName

realm

はい

いいえ

いいえ

いいえ

デプロイメント後のセキュリティ構成:

password

user

attributes

URL接続:

ファイルURL

url

はい

ページレット・プロデューサ

url

はい

分析コレクタ

collectorPort

host

isEnabled

timeout

isUnicast

defaultConnection

はい

いいえ

いいえ

いいえ

いいえ

いいえ

host: isUnicastが0に設定される場合はclusterName、isUnicastが1に設定される場合はcollectorHostを表します。

BPELサーバー

url

policy

recipientKeyAlias

linkURL

はい

いいえ

いいえ

いいえ

ディスカッション・サーバー

url

adminUser

application.root.category.id

recipientKeyAlias

policyURIForAuthAccess

policyURIForPublicAccess

timeout

defaultConnection

はい

はい

はい

いいえ

いいえ

いいえ

いいえ

いいえ

外部アプリケーション

url

authMethod

userFieldName

pwdFieldName

displayName

publicCredentialEnabled

sharedCredentialEnabled

AdditionalFields

はい

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

パブリック資格証明または共有資格証明をソースで構成する場合、その資格証明はセキュリティ上の理由でエクスポートされません。これらの資格証明は、必要に応じてデプロイメント後にターゲットで構成する必要があります。

プレゼンス・サーバー:
Microsoft Live Communications Server

url

poolName

adapter

timeout

appId

AdditionalProperty

defaultConnection

はい

はい

いいえ

いいえ

いいえ

いいえ

いいえ

プレゼンス・サーバー:

Microsoft Office Communications Server 2007/Microsoft Lync 2010

url

poolName

userDomain

adapter

timeout

appId

AdditionalProperty

defaultConnection

はい

はい

はい

いいえ

いいえ

いいえ

いいえ

いいえ

メール・サーバー

imapHost

smtpHost

imapPort

smtpPort

smtpSecured

imapSecured

appId

timeOut

AdditionalProperties

defaultConnection

はい

はい

はい

はい

はい

はい

いいえ

いいえ

いいえ

いいえ

デプロイメント後のLDAP構成:

LdapDomain

LdapDefaultUser

LdapHost

LdapBaseDn

LdapAdminUsername

LdapPort

LdapSecured

個人イベント・サーバー

webServiceUrl

adapterName

appId

defaultConnection

はい

いいえ

いいえ

いいえ

Oracle SES

url

appUser

defaultConnection

はい

いいえ

いいえ

promptForPasswordが1に設定される場合、ユーザーにはappPasswordのプロンプトが表示されます。

WebCenter Content Server (ソケット)

serverHost

serverPort

extAppId

timeout

socketType

webContextRoot

cacheInvalidationInterval

binaryCacheMaxEntrySize

defaultConnection

はい

はい

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

デプロイメント後のセキュリティ構成:

adminUsername

adminPassword

keystorePassword

privateKeyPassword

WebCenter Content Server (socketssl)

serverHost

serverPort

extAppId

timeout

socketType

webContextRoot

cacheInvalidationInterval

binaryCacheMaxEntrySize

defaultConnection

keystoreLocation

privateKeyAlias

はい

はい

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

デプロイメント後のセキュリティ構成:

adminUsername

adminPassword

keystorePassword

privateKeyPassword

WebCenter Content Server (jaxws)

url

extAppId

timeout

socketType

webContextRoot

cacheInvalidationInterval

binaryCacheMaxEntrySize

defaultConnection

clientSecurityPolicy

はい

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

デプロイメント後のセキュリティ構成:

adminUsername

adminPassword

keystorePassword

privateKeyPassword

WebCenter Content Server (Web)

url

extAppId

timeout

socketType

webContextRoot

cacheInvalidationInterval

binaryCacheMaxEntrySize

defaultConnection

はい

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

デプロイメント後のセキュリティ構成:

adminUsername

adminPassword

keystorePassword

privateKeyPassword

Oracle Portal

dataSource

extAppId

timeout

はい

いいえ

いいえ

ファイル・システム

path

はい

ワークリスト接続

BPELConnection

いいえ

脚注 1  セキュリティ関連の構成: 接続にはポリシー情報のみが含まれます。セキュリティ・ポリシーに設定されたオーバーライドは含まれないため、デプロイメント後にこれらのパラメータを構成する必要があります。

接続情報を別のサーバーにデプロイする方法を確認するには、第40.6項「ステージングから本番への接続の詳細の移動」を参照してください。

40.1.2.2 別のサーバーへのポータル・アーカイブのデプロイ

最初に、ポータルをアーカイブ(.parファイル)にデプロイ(またはエクスポート)してから、アーカイブをターゲット・サーバーにインポートします。第40.1.2.1項「ポータル・アーカイブの理解」も参照してください。

注意:
ポータルをアーカイブから別のサーバーにデプロイする場合、ポータル伝播を使用して後からポータルに増分更新を行うことはできません。ポータル伝播機能は、ポータルの直接デプロイメントで使用する場合のみ可能です。詳細は、第40.9項「本番でのポータルの管理」を参照してください。

ポータル・アーカイブをエクスポートしてからインポートするには:

1. 第40.1.2.3.1項「ポータル・アーカイブの前提条件」で説明するポータル・アーカイブの前提条件をすべて満たします。

2. ソース・ポータルを次のようにエクスポートします。

- WLSTを使用する場合は、第40.1.2.3.3項「WLSTを使用したオンライン・ポータルのアーカイブへのエクスポート」を参照してください。

- ポータル・ビルダーを使用する場合は、第40.1.2.3.2項「ポータル・ビルダー管理を使用したオンライン・ポータルのアーカイブへのエクスポート」を参照してください。

3. (オプション)外部に格納されているデータとコンテンツをターゲットに移行します。
詳細は、第40.8.1項「個々のポータルのバックエンド・コンポーネントの移行」を参照してください。

4. ターゲットにポータルを次のようにインポートします。

- WLSTを使用する場合は、第40.1.2.4.3項「WLSTを使用したポータルのアーカイブからのインポート」を参照してください。

- ポータル・ビルダーを使用する場合は、第40.1.2.4.2項「ポータル・ビルダー管理を使用したポータルのアーカイブからのインポート」を参照してください。

40.1.2.3 ポータル・アーカイブの作成

管理者は、WebCenter Portalで実行するポータルまたはポータル階層のアーカイブ(.parファイル)を生成できます。ポータル・ビルダーまたはWLSTコマンドexportWebCenterPortalsを使用してアーカイブを作成し、オプションでポータルのコンテンツ・フォルダを含めることができます。

ポータル・アーカイブの作成方法を確認するには、次の項を参照してください。

- 第40.1.2.3.1項「ポータル・アーカイブの前提条件」

- 第40.1.2.3.2項「ポータル・ビルダー管理を使用したオンライン・ポータルのアーカイブへのエクスポート」

- 第40.1.2.3.3項「WLSTを使用したオンライン・ポータルのアーカイブへのエクスポート」

40.1.2.3.1 ポータル・アーカイブの前提条件

ポータルをアーカイブ(.parファイル)にエクスポートする前に、次の事項を確認します。

- Webサービス・データ・コントロール: エクスポートするポータルにWebサービス・データ・コントロールが含まれる場合、エクスポートが正常に行われるには、関連するすべてのWebサービスが稼働中でアクセス可能である必要があります。

- ポートレット・プロデューサ: エクスポートするポータルにポートレットが含まれる場合、すべてのポートレット・メタデータがアーカイブに含まれるようにするには、関連するすべてのポートレット・プロデューサが稼働中でアクセス可能である必要があります。

- ポータル・フォルダ外部のコンテンツ: ポータル・アセット、ポータル・ページ、コンテンツ・プレゼンタおよびSite Studioで使用される、ポータル・フォルダの外部で格納されるコンテンツ(ファイル、イメージおよびアイコンなど)は、アーカイブに自動的に含まれません。すべての依存ファイルを、ターゲット・コンテンツ・サーバーの適切な場所にコピーする必要があります。

注意:
MDSにアーティファクトを格納するレガジー・ポータル(アセットを含む)を管理する場合、MDSのすべての依存アーティファクトをコンテンツ・サーバーに再配置することをお薦めします。MDSに格納されているアーティファクトを移動しない場合、MDSのWLSTコマンドexportMetadata/importMetadataを使用して、MDSのコンテンツを別のターゲットに移動できます。例:

exportMetadata(application='webcenter', server='WC_Spaces',
toLocation='/tmp/content',
docs='/oracle/webcenter/siteresources/scopedMD/shared/**')

importMetadata(application='webcenter', server='WC_Spaces',
fromLocation='/tmp/content',
docs='/oracle/webcenter/siteresources/scopedMD/shared/**')

- WebCenter Content構成: ソース・インスタンスとターゲット・インスタンスの両方が同じWebCenter Content構成である必要があります。混合構成間でのコンテンツの移動は、サポートされていません。たとえば、両方のインスタンスでFolders_gまたはFrameworkFoldersがフォルダ・サービスとして構成されている必要があります。Folders_gがソース・インスタンスで有効化され、FrameworkFoldersがターゲット・インスタンスで有効化されている場合、2つのインスタンス間でのポータル(コンテンツを含む)のエクスポートまたはインポートは失敗します。

40.1.2.3.2 ポータル・ビルダー管理を使用したオンライン・ポータルのアーカイブへのエクスポート

WebCenter Portal管理者は、ここで説明するように、ポータル・ビルダー管理を使用して、ポータルをアーカイブにエクスポートできます。ポータル・アーカイブは、ローカル・ファイル・システムまたはリモート・サーバーのファイル・システムに保存できます。

注意:
ポータル・テンプレートもエクスポートできますが、別のプロセスになります。ポータルとポータル・テンプレートを1つのアーカイブにエクスポートすることはできません。詳細は、第40.2.1.1項「WebCenter Portalを使用したポータル・テンプレートのアーカイブへのエクスポート」を参照してください。

ポータル・ビルダー管理を使用して1つ以上のポータルをエクスポートするには:

1. 「管理」リンクをクリックします。

2. 「ポータル」タブをクリックして、「ポータル」ページを表示します。
次のURLをブラウザに入力して、「ポータル」管理ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/portals

関連項目:
Oracle WebCenter Portalでのポータルの構築の付録「WebCenter PortalプリティURL」。

3. 表の行を強調表示して、必要なポータルを選択します。
[Ctrl]キーを押しながら行をクリックして、複数の行を選択します。

ヒント:
エクスポート・プロセスでのデータの競合を防ぐには、選択したすべてのポータル(サブポータルを含む)が、一時的であっても、エクスポート・プロセス中はオフラインになっていることをお薦めします。詳細は、第46.11項「任意のポータルのオフライン化」を参照してください。
Portals-Manage Security and Configuration権限を持つメンバーは、ポータルがオフラインの場合でも引き続きアクセスできるため、エクスポートの実行中に変更を行わないようにメンバーに依頼します。

4. ツールバーで「エクスポート」をクリックします。
「ポータルのエクスポート」ペインが開きます(図40-5)。選択したすべてのポータルがリスト表示されます。ポータル階層を選択した場合、階層全体をエクスポートする必要があります。子ポータルを選択して削除することはできません。

ポータルを除外する場合は、ポータルの名前の横の「削除」アイコンをクリックします(図40-5の青い十字型のアイコン)。

図40-5 ポータルのエクスポート

5. 「ポータル・アーカイブ」に、ファイル拡張子.parを付けて名前を入力するか、デフォルト名を受け入れます。
ポータル・アーカイブのデフォルトのファイル名では、一意性を保証するため、webcenter_random_number.parのように乱数を使用します。

6. 各ポータルのコンテンツ・フォルダをエクスポートするには、「コンテンツ・サーバー上のポータル・フォルダを含む」を選択します。
ドキュメント・サービスを使用してポータル・ドキュメント(ファイル、フォルダ、Wiki、ブログ)を作成、管理および格納するポータルの場合、フォルダはWebCenter Portalのコンテンツ・リポジトリに自動的に作成されます。このフォルダに格納されるコンテンツのみをポータルとともにエクスポートできます。たとえば、コンテンツ・プレゼンタで表示されるWebコンテンツやページはポータルのコンテンツ・フォルダに格納されないためエクスポートに含まれません。第40.1.2.1.1項「ポータル・データ・ファイル(PDR)の理解」も参照してください。

注意:

- コンテンツ・フォルダを含めると、ポータル・アーカイブのサイズが大きくなります。大量のポータルや大量のコンテンツ・フォルダをエクスポートする場合、アーカイブがファイルの最大アップロード・サイズ(デフォルトで2GB)を超えないように注意してください。必要な場合は、第9.12項「最大ファイル・アップロード・サイズの変更」の説明に従い、この設定を大きくすることができます。

- MDSにアーティファクトを格納するレガジー・ポータル(アセットを含む)を管理する場合、MDSのすべての依存アーティファクトをコンテンツ・サーバーに再配置することをお薦めします。MDSに格納されているアーティファクトを移動せず、アセット・アーカイブ内にMDSコンテンツを含めない場合、MDSのWLSTコマンドexportMetadata/importMetadataを使用して、MDSコンテンツを別の機会に移動することができます。例:

exportMetadata(application='webcenter', server='WC_Spaces',
toLocation='/tmp/content',
docs='/oracle/webcenter/siteresources/scopedMD/shared/**')

importMetadata(application='webcenter', server='WC_Spaces',
fromLocation='/tmp/content',
docs='/oracle/webcenter/siteresources/scopedMD/shared/**')

7. 「エクスポート」をクリックします。

8. エクスポート・プロセス中に進捗情報が表示されます(図40-6)。
エクスポート・プロセスが完了したら、エクスポート・アーカイブ(.parファイル)の場所を指定します。

図40-6 ポータルのエクスポートが処理中の場合

次のいずれかを選択します。

- ダウンロード: エクスポートの.parファイルはローカル・ファイル・システムに保存されます。
ブラウザでダウンロードされ、アーカイブはローカルに保存されます。実際のダウンロード場所は、ブラウザの設定ごとに異なります。

一部のブラウザには、ダウンロードのサイズを制限する設定があります。エクスポート・アーカイブのサイズが大きくダウンロードされない場合、ブラウザ設定を確認します。

- サーバーに保存: エクスポートの.parファイルはサーバー位置に保存されます。
「サーバーに保存」ダイアログが表示されたら(図40-7)、「アーカイブの場所」に適切なパスを入力し(例: /tmp)、「保存」をクリックします。指定したサーバー・ディレクトリが存在し、write権限があることを確認します。

図40-7 サーバー位置へのエクスポート・アーカイブの保存

9. 「閉じる」をクリックして「ポータルのエクスポート 」ペインを閉じます。

エクスポート・アーカイブ(.parファイル)は、指定された場所に保存されます。

40.1.2.3.3 WLSTを使用したオンライン・ポータルのアーカイブへのエクスポート

WLSTコマンドexportWebCenterPortalsを使用して、1つ以上のポータルをポータル・アーカイブ(.parファイル)にエクスポートします。WLSTを使用してポータル・アーカイブを作成する場合、ポータルのコンテンツ・フォルダと接続情報をアーカイブに含めるかどうかを選択できます。

exportWebCenterPortals(appName, fileName, [names, offlineDuringExport,
exportPortalContent, exportConnections, server, applicationVersion])

設定するオプションは、特定のアーカイブ要件によって異なります。コマンドの構文については、『WebLogic Scripting Toolコマンド・リファレンス』のexportWebCenterPortalsに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

次に、いくつかの例を示します。

例1: 2つのポータルのエクスポート

この例では、SalesおよびFinanceという2つのポータルと、すべてのコンテンツ、データ、セキュリティ、カスタマイズおよび接続情報をエクスポートします。

exportWebCenterPortals(appName='webcenter', fileName='MyPortalExport.par',
names='Sales,Finance', exportPortalContent=1, exportConnections=1)

例2: コンテンツ・フォルダまたは接続の詳細を含めない単一オフライン・ポータルのエクスポート

この例では、MySalesをオフラインにして、ポータルをMyPortalExport.parにエクスポートします。

exportWebCenterPortals(appName='webcenter', fileName='MyPortalExport.par',
names='Sales', offlineDuringExport=1)

40.1.2.4 アーカイブからの1つ以上のポータルのインポート

管理者は、アーカイブ・ポータル(.parファイル)を任意のWebCenter Portal Serverにデプロイできます。WLSTコマンドimportWebCenterPortalsを使用してポータル・アーカイブをインポートするか、ポータル・ビルダー管理を使用できます。

インポートの際、アーカイブに含まれるすべてのポータルは、ターゲット・サーバーで作成または再作成されます。既存のポータルは、削除されてから置き換えられ、新しいポータルが作成されます。ターゲット・サーバーで使用可能なポータルと同じ名前のポータルをインポートする場合、オンラインのポータルは上書きできないため、それらのポータルがターゲット・アプリケーションでオフラインになっていることを確認します。詳細は、第46.11項「任意のポータルのオフライン化」を参照してください。

注意:
WLSTを使用してポータルをインポートする場合、オプションforceOffline=1を設定して、オンライン・ポータルが自動的にオフラインになるようにすることができます。この方法でオフライン化されたポータルは、インポート・プロセス終了時はオフラインのままです。

ポータルは、同じポータルの同時インポートまたはエクスポートを回避するために、インポート操作中にロックされます。他のユーザーが特定のポータルをインポートする場合、同じポータルをインポート(またはエクスポート)しようとするすべての後続の試みはブロックされます。

1つ以上のポータルをインポートした後で、Oracle Secure Enterprise Searchクロールを開始して、新たにインポートされたデータを索引付けすることを検討してください。

ポータルのセキュリティ(インポート時のオプション)

すべてのポータルには適切に機能するセキュリティ・ポリシーが必要になるため、新しいポータルを初めてインポートするときにポータルのセキュリティ・ポリシーを含める必要があります。既存のポータルは、セキュリティ・ポリシーに準拠しており、この場合、セキュリティ情報を上書きするか、または既存のセキュリティ・ポリシーを維持しているかどうかを調べます。

既存のセキュリティ・モデルを上書きするため、本番インスタンスでのセキュリティのインポートは特に注意してください。

既存のポータルのセキュリティをインポートする場合、セキュリティ・ポリシーの更新はすぐに適用されません。ポータルの最新セキュリティ・ポリシーを採用するには、WebCenter Portalにログインしているユーザーがログアウトして再度ログインする必要があります。

本番インスタンスでセキュリティをインポートして上書きする際は注意してください。

注意:
ソース環境とターゲット環境の両方のユーザーが同一である必要があります。共有アイデンティティ・ストアを使用しない場合、システム管理者は、ユーザーをターゲットに移行する必要があります。第41.6.1.2項「WebCenter Portalスキーマ・データのバックアップ(エクスポート)」および第41.6.1.3項「WebCenter Portalデータのリストア(インポート)」を参照してください。

ポータル・アーカイブ・データ(インポート時のオプション)

データ移行が重要な場合、アクティビティ・ストリーム、イベント、フィードバック、リスト、リンク、メッセージ・ボード、ピープル・コネクション、プロファイル、投票およびアンケートなど、ソース・ポータルに関連付けられたデータをインポートするように選択できます。

このデータはターゲットで不要な場合もあります。たとえば、ステージング環境と本番環境との間でポータルをインポートする場合などです。

ポータル・アーカイブ・コンテンツ(インポート時のオプション)

ポータル・アーカイブにポータルのコンテンツ・フォルダが含まれる場合があります。含まれる場合、この情報をインポートするかどうかも選択できます。インポート時に、アーカイブのコンテンツ・フォルダによってターゲットのフォルダ(ある場合)が上書きされます。

注意:
コンテンツ・プレゼンタで表示されるWebコンテンツやページはポータルのコンテンツ・フォルダに格納されないため、ポータル・アーカイブには含まれません。

外部ポータル・データ(個別インポート)

ディスカッションなど、外部に格納されるデータはポータルごとに移行できますが、これは個別プロセスになります。第40.8.1項「個々のポータルのバックエンド・コンポーネントの移行」を参照してください。

ポータル・アーカイブのインポート方法を確認するには、次の項を参照してください。

- 第40.1.2.4.1項「ポータルのインポートの前提条件」

- 第40.1.2.4.2項「ポータル・ビルダー管理を使用したポータルのアーカイブからのインポート」

- 第40.1.2.4.3項「WLSTを使用したポータルのアーカイブからのインポート」

40.1.2.4.1 ポータルのインポートの前提条件

ポータル・アーカイブ(.parファイル)をインポートする前に、次の事項を確認します。

- 共有アイデンティティ・ストア: ソース環境とターゲット環境のユーザーが同じであることを確認します。

- ターゲットに存在するポータル: アーカイブのポータルがターゲットに存在するかどうかを確認します。必要な場合、インポート・プロセスで既存のポータルをオフライン化します。

- Webサービス・データ・コントロール: インポートするポータルにWebサービス・データ・コントロールが含まれる場合、インポートが正常に行われるには、関連するすべてのWebサービスが稼働中でアクセス可能である必要があります。

- ポートレット・プロデューサ: ポータルで使用されるポートレット・プロデューサが、ポータルのインポート時に稼働している必要があります。

- 共有アセット: ポータルが共有アセットを参照する場合、ポータルが適切に機能するには、ポータルのインポート前(または後)に、必要な共有アセットをターゲットに移動していることを確認します。

- 外部サーバー、アプリケーション、Webサービスおよびポートレット・プロデューサへの接続: 特定の外部接続の構成に依存するポータルは、同様の接続がターゲットに存在しない場合は機能しません。ポータルをインポートする前に、必要なすべての接続がターゲットに存在することを確認します。ターゲットで接続を作成または再構成する場合、ターゲットの管理対象サーバーの再起動が必要になる場合があります。詳細は、第40.6項「ステージングから本番への接続の詳細の移動」を参照してください。

- アーカイブ・バージョン: インポートするポータル・アーカイブまたはポータル・テンプレート・アーカイブが、WebCenter Portal 11.1.1.8.0以降からエクスポートされたものであることを確認します。このリリースのアーカイブのファイル拡張子は.parです。
これより以前のバージョンのアーカイブ(ファイル拡張子は.ear)をインポートできますが、この方法でインポートするポータルまたはポータル・テンプレートは、アップグレードされたWebCenter Portal 11.1.1.9.0インスタンスで完全に機能するとはかぎりません。ソース環境を11.1.1.9.0にアップグレードしてエクスポート・アーカイブ(.parファイル)を作成することをお薦めします。詳細は、パッチ適用ガイドの「Oracle WebCenter Portalへのパッチ適用」を参照してください。

40.1.2.4.2 ポータル・ビルダー管理を使用したポータルのアーカイブからのインポート

WebCenter Portal管理者は、ポータル・ビルダー管理を使用して1つ以上のポータルおよびポータル階層をポータル・アーカイブからインポートできます。

1つ以上のポータルを.parファイルからインポートするには:

1. 「管理」リンクをクリックします。

2. 「ポータル」タブをクリックして、「ポータル」ページを表示します。
次のURLをブラウザに入力して、「ポータル」管理ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/portals

関連項目:
Oracle WebCenter Portalでのポータルの構築の付録「WebCenter PortalプリティURL」。

3. ツールバーで「インポート」をクリックします。

ヒント:
1つ以上のポータルを既存のポータルのサブポータルとしてインポートするには、「インポート」ボタンをクリックする前にターゲット・ポータルを選択します。

「ポータルのインポート」ダイアログが開きます(図40-8)。

図40-8 ポータルのインポート

4. ポータル・アーカイブ(.parファイル)の場所を指定します。次のいずれかを選択します。

- 自分のコンピュータで表示: 場所をテキスト・ボックスに入力します。あるいは、「参照」をクリックして、.parファイルが格納されているディレクトリをローカル・ファイル・システム上で見つけます。

- WebCenter Portalサーバーで表示: WebCenter Portalをデプロイするサーバーのパス(アーカイブ・ファイル名を含む)をテキスト・ボックスに入力します。たとえば、/tmp/MyPortalExport.parのようになります。WebCenter Portalからアクセス可能な共有の場所を指定できます。

5. 「アーカイブの参照」をクリックして、インポートが可能なコンテンツを確認します(図40-9)。

図40-9 ポータルのインポート

指定したアーカイブのすべてのポータルの名前が表に表示されます。「タイプ」列は、アーカイブのポータルとターゲットに存在するポータルとの間に競合があることを示します。

- 新規: この名前のポータルはターゲットに存在しません。インポートの際に新しいポータルが作成されます。

- 置換: この名前のポータルでGUIDが同じポータルがターゲットに存在します。既存のポータルはインポート時に削除され、ポータル・アーカイブのバージョンに置き換えられます。

- 競合: この名前のポータルがターゲットに存在しますが、ターゲットのポータルと、インポートしようとしているポータルのGUIDが異なります。あるいは、このポータルのGUIDと、ターゲットのいずれかのポータルのGUIDが同じですが、ポータル名が一致しません。
インポート・プロセスで、インポートしようとしているポータルとターゲットに存在するポータルとの間に競合が検出された場合、問題を解決する必要があります。たとえば、名前は一致してもGUIDが異なるために競合が発生している場合は、ソース・ポータルの名前を変更して新しいエクスポート・アーカイブを作成するか、ターゲット・アプリケーションの競合ポータルの名前を変更して同じアーカイブをインポートします。

6. 必要に応じて、インポートのオプションを設定します。詳細は、表40-5を参照してください。

表40-5 ポータルのインポートのオプション

フィールド

説明

カスタマイズを含む

これを選択すると、ポータルのカスタマイズがインポートされます。

インポート時にオプションとなるカスタマイズの詳細は、表40-1「ポータルのデプロイメントのオプション」および表40-2「ポータル・アーカイブにエクスポートされる情報(PDRファイル)」を参照してください。

インポートによって、ターゲットのポータルの既存のカスタマイズ(ある場合)が完全に上書きされるわけではありません。ポータル・アーカイブに含まれるカスタマイズのみがインポート時に上書きされるため、ターゲットの他のカスタマイズはそのまま変わりません。

このオプションの選択を解除した場合は、次のようになります。

- 新しいポータルはカスタマイズを含めずにインポートされます。たとえば、デフォルトのタスク・フローはカスタマイズなしでインポートされ、デフォルトのポータル設定が使用されて、すべてのユーザー・カスタマイズが除外されます。

- ターゲットにすでに存在するポータルをインポートする場合、ターゲットの既存のカスタマイズは保持されます。

注意: ポートレットおよびページのカスタマイズは常にインポートされます。

コンテンツ・サーバー上のポータル・フォルダを含む

(指定したアーカイブに1つ以上のポータルのコンテンツ・フォルダが含まれる場合のみ表示されます。)

これを選択すると、アーカイブに含まれるすべてのコンテンツ・フォルダがインポートされます。ターゲットに存在するフォルダはインポート時に上書きされます。

このオプションの選択を解除すると、ポータルのコンテンツ・フォルダ(ある場合)は除外されます。このオプションは、テスト・コンテンツが不要になったステージング環境と本番環境との間で移行する場合に便利です。

注意: 大量のコンテンツ・フォルダを含むポータル・アーカイブは、ファイルの最大アップロード・サイズ(デフォルトで2GB)を超えることがあります。importWebCenterPortals WLSTコマンドを使用して、現在のアップロード・サイズを超えるポータル・アーカイブをインポートすることをお薦めします。第40.1.2.4.3「WLSTを使用したポータルのアーカイブからのインポート」を参照してください。必要な場合は、第9.12項「最大ファイル・アップロード・サイズの変更」の説明に従い、このアップロード設定を大きくすることができます。

セキュリティ・ポリシーを含む

これを選択すると、ポータルとともにセキュリティ情報がインポートされます。

選択した場合、次のセキュリティ関連情報がインポートされます。

- ポータル・ロール(および各ロールに割り当てられた権限)。

- ポータル・メンバー(およびメンバー・ロール割当て)。

ポータルのセキュリティ情報をインポートしない場合は、このオプションの選択を解除します。このオプションは、次のようにステージング環境と本番環境との間でポータルをインポートする場合に役立ちます。

- テストで使用されるメンバーが本番環境で必要ない場合。

- ポータルが本番インスタンスに存在し、セキュリティ情報を上書きする必要がない場合。

注意: 新しいポータルをインポートする場合、セキュリティ・ポリシーがないと新しいポータルをインポートできないため、このオプションを必ず選択してください。

サービス・データを含む

これを選択すると、アクティビティ・ストリーム、イベント、フィードバック、リスト、リンク、メッセージ・ボード、ピープル・コネクション、プロファイル、投票およびアンケートに関する、WebCenter Portalデータベースに格納されたポータル関連データがインポートされます。

ポータル関連データをインポートしない場合は、このオプションの選択を解除します。このオプションを選択すると、ターゲットのデータ(ある場合)は保持されます。たとえば、テスト環境から、テスト・データが不要になるステージング環境や本番環境にポータルを移動する場合などがあります。

注意: インポート・プロセスでは、メール、ディスカッション、お知らせなど、外部に格納されているデータは移動されません。

7. 「インポート」をクリックします。

- ターゲットのWebCenter Portalアプリケーションに存在するポータルをインポートしようとすると、「置換の確認」ダイアログが表示されます。既存のポータルを上書きするかどうかを確認する必要があります。
既存のポータルを削除してインポートしたバージョンに置き換えるには、「はい」を選択します。インポート・プロセスを取り消すには、「いいえ」を選択します。

- インポート・プロセスで、インポートしようとしているポータルとターゲットに存在するポータルとの間に競合が検出された場合、問題の解決に役立つメッセージが表示されます。たとえば、ターゲット・アプリケーションのポータルとインポートしようとしているポータルの名前が同じでGUIDが異なる場合、競合メッセージが表示されます。この場合は、ソース・ポータルの名前を変更して新しいエクスポート・アーカイブを作成するか、ターゲット・アプリケーションの競合ポータルの名前を変更して同じアーカイブをインポートできます。

- ポータル・アーカイブがファイルの最大アップロード・サイズ(デフォルトで2GB)を超える場合、ポータルはインポートできません。importWebCenterPortals WLSTコマンドを使用して、現在のアップロード・サイズを超えるポータル・アーカイブをインポートすることをお薦めします。詳細は、第40.1.2.4.3「WLSTを使用したポータルのアーカイブからのインポート」を参照してください。必要な場合は、このアップロード設定を大きくすることができます。詳細は、第9.12項「最大ファイル・アップロード・サイズの変更」を参照してください。

注意:

- MDSにアーティファクトを格納するレガジー・ポータル(アセットを含む)を使用する場合、MDSのすべての依存アーティファクトをコンテンツ・サーバーに再配置することをお薦めします。MDSに格納されているアーティファクトを移動せず、アセット・アーカイブ内にMDSコンテンツを含めない場合、MDSのWLSTコマンドexportMetadata/importMetadataを使用して、MDSコンテンツを別の機会に移動することができます。例:

exportMetadata(application='webcenter', server='WC_Spaces',
toLocation='/tmp/content',
docs='/oracle/webcenter/siteresources/scopedMD/shared/**')

importMetadata(application='webcenter', server='WC_Spaces',
fromLocation='/tmp/content',
docs='/oracle/webcenter/siteresources/scopedMD/shared/**')

情報メッセージが表示されます。

8. 「はい」をクリックしてポータルのインポートを確定します。
すべてのポータルが正常にインポートされると、情報メッセージが表示されます(図40-10)。

図40-10 ポータルが正常にインポートされた場合

9. 「閉じる」をクリックして「ポータルのインポート」ウィンドウを閉じます。

通常、新しいポータルを使用できるようにするには、ある程度の追加作業が必要です。そのため、新しくインポートされたすべてのポータルは、最初はオフラインになっています。たとえば、次の操作を行うことがあります。

- バックエンド・コンポーネントに関連付けられたデータの移行。詳細は、第40.8.1項「個々のポータルのバックエンド・コンポーネントの移行」を参照してください。

- メンバーの追加や招待。

- ツールとサービスの有効化または無効化。

ポータルのコンテンツとメンバーシップの詳細をファイナライズすると、ポータルを再度オンラインにすることができます。第46.12項「任意のポータルの再オンライン化」を参照してください。

注意:
高可用性クラスタ環境では、ポータルのインポートがフェールオーバーによって失敗した場合、「管理」の下にある「ポータル」ページにアクセスするたびにエラーが表示されます。ポータルがポータル・リストに表示されていますが、削除することはできません。また、「エクスポート」オプションが無効と表示されているため、他のポータルをインポートまたはエクスポートすることはできず、「インポート」オプションをクリックするとエラーが表示されます。この問題を解決するには、WLSTコマンドImportWebCenterPortalsを使用して、失敗したポータルを再度インポートします。詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のimportWebCenterPortalsに関する項を参照してください。

40.1.2.4.3 WLSTを使用したポータルのアーカイブからのインポート

WLSTコマンドimportWebCenterPortalsを使用して、1つ以上のアーカイブ・ポータルをWebCenter Portalにインポートします。

importWebCenterPortals(appName, fileName, names, [parentPortal,
importCustomizations, importPortalContent, importSecurity, importData,
importActivities, overwrite, savePortals, forceOffline, importLog])

WLSTを使用してポータルをインポートする場合、アーカイブ内のすべての内容をインポートする必要はありません。アーカイブに複数のポータルが含まれる場合、インポートするポータルのみを指定できます。ポータルとともにどの程度の情報をインポートするかも指定できます。たとえば、ポータルのコンテンツ・フォルダ、カスタマイズ、セキュリティ情報またはデータをインポートするかどうかを選択できます。これらのオプションは、テスト環境から、テスト関連のデータやコンテンツが必ずしも必要ではないステージング環境または本番環境にポータルを移動する場合などに役立ちます。

設定するオプションは、特定の要件によって異なります。コマンドの構文については、『WebLogic Scripting Toolコマンド・リファレンス』のimportWebCenterPortalsに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

次に、いくつかの例を示します。

例1: ターゲットに2つのポータルを初めてインポートする場合

この例では、SalesおよびFinanceという2つのポータルと、すべてのコンテンツ、データ、セキュリティおよびカスタマイズをインポートして、インポート・ログ・ファイルの名前と場所も指定します。

importWebCenterPortals(appName='webcenter', fileName='MyPortalExport.par',
names='Sales,Finance', importLog='/myimportlogs/myPortal_import.log')

例2: ターゲットに存在するポータルをインポートする場合

この例では、ターゲットでmyExistingPortalというポータルをバックアップして、ターゲット・ポータルをアーカイブ・バージョン(可能性のあるすべてのデータを除外)で上書きします。

importWebCenterPortals(appName='webcenter', fileName='MyPortalExport.par',
names='myExistingPortal', importCustomizations=0, importPortalContent=0,
importSecurity=0,importData=0, importActivities=0, overwrite=1, savePortals=1)

40.1.2.5 ポータル・アーカイブの表示および抽出

WLSTコマンドlistWebCenterPortalArchiveを使用して、ポータル・アーカイブ(.parファイル)のコンテンツを表示します。必要に応じて、ポータル・アーカイブのコンテンツを、選択した場所に抽出することもできます。コマンドの構文については、『WebLogic Scripting Toolコマンド・リファレンス』のlistWebCenterPortalArchiveに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

40.1.3 ポータル階層のデプロイ

WebCenter Portalでは、ポータル階層は、1つの親ポータルと1つ以上のサブポータルで構成されます(図40-11を参照)。ポータル階層のデプロイメント・プロセスは、単一ポータルのプロセスと同じですが、階層内のポータル間に依存関係があるため、いくつかのガイドラインと制限事項があります。詳細は、次を参照してください。

- ポータル階層をエクスポートする場合のガイドライン

- ポータル階層をインポートする場合のガイドライン

ポータル階層をエクスポートする場合のガイドライン

ポータル階層をエクスポートする際に、目的が別のサーバーへのデプロイメントやバックアップの場合、親ポータルをエクスポートして、階層全体が<parentportalname>-<datetimestamp>.pdrという単一のポータル・データ・ファイル(PDR)にエクスポートされるように指定します。

重要:
階層内のポータル間には様々な依存関係があるため、ポータル階層全体を常にエクスポートおよびインポートすることをお薦めします。

たとえば、図40-11に示す階層のポータルをエクスポートするには、次のように指定します。

exportWebCenterPortals(appName='webcenter', fileName='myPortalHierarchies.par',
names='Sales,MyProject')

「Tasks」は「Task X」と「Task Y」の親ポータルですが、階層内で最も高いポータルではありません。「Tasks」階層のみをエクスポートしようとする場合、「My Project」から継承される情報がエクスポート・アーカイブから除外されます。

図40-11 ポータル階層のデプロイ

ポータル階層をインポートする場合のガイドライン

- アーカイブの子ポータルを選択してインポートしたりリストアしたりすることはできません。必ず、階層全体をエクスポートして、ターゲットに階層全体をインポートします。

- ターゲットに階層ポータルをインポートするときに親を変更しないでください。

たとえば、図40-11に示す階層のすべてのポータルをインポートするには、次のように指定します。

importWebCenterPortals(appName='webcenter', fileName='myPortalHierarchies.par',
names='Sales,MyProject', forceOffline=1)

40.2 ポータル・テンプレートのデプロイ

管理者は、ポータル・テンプレートをWebCenter Portalからエクスポートして、そのテンプレートを別のポータル・サーバーにデプロイできます。初期設定のテンプレートはエクスポートできません。

エクスポートおよびインポート・ユーティリティは、WebCenter Portalインスタンス間での情報の移動に主に使用されますが、ポータル・テンプレートのエクスポート機能は、バックアップ・サービスとしても役立ち、他のユーザーとのテンプレートの共有と交換にも便利です。

ポータル・テンプレートには、ページ、ドキュメント、ディスカッション、リストおよびセキュリティ情報(カスタム・ロールやメンバーの詳細など)を含めることができます。ポータル・テンプレートをエクスポートすると、この情報がすべてポータル・データ・ファイル(PDR)でパッケージ化されます。このPDRファイルには、メタデータ・アーカイブ(MARファイル)と、テンプレートのセキュリティ・ポリシー情報を含む単一のXMLファイルが含まれます。

すべてのテンプレート・データがポータル・テンプレート・アーカイブに含まれる場合、ポータル・テンプレートを別のWebCenter Portal Serverにデプロイする際にテンプレート・データをターゲットに手動で移行する必要はありません。

ドキュメント・サービス(ファイル、フォルダ、Wiki、ブログ)を使用するポータル・テンプレートは、WebCenter Portalのバックエンド・コンテンツ・リポジトリでコンテンツ・フォルダを自動的に所有します。ポータル・ビルダー管理を使用してポータル・テンプレートをエクスポートする場合、このフォルダに格納されるコンテンツは、自動的にポータル・テンプレート・アーカイブ(.pdr)に含まれるため、別のターゲット・サーバーへのデプロイメントが容易になります。フォルダは、transport.mar\oracle\webcenter\lifecycle\importexport\data\oracle-webcenter-doclib\docsexport.zipにある.zipファイルに追加されます。

WLSTコマンドexportWebCenterPortalTemplatesを使用してポータル・テンプレートをエクスポートする場合、コンテンツ・フォルダはオプションになります。

注意:
ポータル・テンプレート・アーカイブには、ポータル・テンプレートで参照されるWebコンテンツやページ(他の場所に格納される)は含まれません。たとえば、コンテンツ・プレゼンタで表示される情報(ポータル・テンプレートのコンテンツ・フォルダに格納されない)などがあります。WebCenter Portalのバックエンド・コンテンツ・リポジトリのポータル・テンプレートに割り当てられたフォルダのみが、ポータル・テンプレート・アーカイブに含まれます。

この項には次のトピックが含まれます:

- 第40.2.1項「ポータル・テンプレートのエクスポート」

- 第40.2.2項「ポータル・テンプレートのインポート」

40.2.1 ポータル・テンプレートのエクスポート

管理者は、WLSTコマンドexportWebCenterPortalTemplatesを使用して、1つ以上のポータル・テンプレートをアーカイブにエクスポートできます。あるいは、管理者とアプリケーション・スペシャリストは、ポータル・ビルダー管理を使用して、ポータル・テンプレートをアーカイブにエクスポートできます。

この項には次のトピックが含まれます:

- 第40.2.1.1項「WebCenter Portalを使用したポータル・テンプレートのアーカイブへのエクスポート」

- 第40.2.1.2項「WLSTを使用したポータル・テンプレートのアーカイブへのエクスポート」

40.2.1.1 WebCenter Portalを使用したポータル・テンプレートのアーカイブへのエクスポート

アプリケーション・スペシャリスト(およびPortal Templates-Manage All権限を持つその他のユーザー)は、ポータル・テンプレートをWebCenter Portalからエクスポートできます。詳細は、Oracle WebCenter Portalでのポータルの構築のポータル・テンプレートのエクスポートに関する項を参照してください。

注意:
ポータルとポータル・テンプレートを1つのアーカイブにエクスポートすることはできません。ポータルのエクスポートは個別のプロセスになります。詳細は、第40.1.2.3.2項「ポータル・ビルダー管理を使用したオンライン・ポータルのアーカイブへのエクスポート」を参照してください。

40.2.1.2 WLSTを使用したポータル・テンプレートのアーカイブへのエクスポート

WLSTコマンドexportWebCenterPortalTemplatesを使用して、1つ以上のポータル・テンプレートをアーカイブ(.parファイル)にエクスポートします。WLSTを使用してポータル・テンプレート・アーカイブを作成する場合、ポータルのコンテンツ・フォルダをアーカイブに含めるかどうかを選択できます。

exportWebCenterPortalTemplates(appName, fileName, [names,
exportPortalTemplateContent, server, applicationVersion])

設定するオプションは、特定のアーカイブ要件によって異なります。コマンドの構文については、『WebLogic Scripting Toolコマンド・リファレンス』のexportWebCenterPortalTemplatesに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

次に、いくつかの例を示します。

例1: 2つのポータル・テンプレートのエクスポート

この例では、SalesTargetTemplateおよびNewProjectTemplateという2つのテンプレートと、その関連コンテンツ・フォルダをエクスポートします。

exportWebCenterPortalTemplates(appName='webcenter',
fileName='MyTemplateExport.par', names='SalesTargetTemplate,NewProjectTemplate',
exportPortalTemplateContent=1)

例2: コンテンツ・フォルダを含まない単一ポータル・テンプレートのエクスポート

この例では、New Hireテンプレートをエクスポートします。ドキュメントはこのテンプレートで有効ではないため、テンプレートにコンテンツ・フォルダはありません。

exportWebCenterPortals(appName='webcenter', fileName='MyTemplateExport.par',
names='NewHire')

40.2.2 ポータル・テンプレートのインポート

管理者は、WLSTコマンドimportWebCenterPortalsを使用して、1つ以上のポータル・テンプレートを別のWebCenter Portal Serverにデプロイできます。あるいは、管理者とアプリケーション・スペシャリストは、ポータル・ビルダー管理を使用して、ポータル・テンプレートをアーカイブからインポートできます。

インポート時に、アーカイブに含まれるすべてのポータル・テンプレートがターゲット・アプリケーションで再作成されます。ターゲットにポータル・テンプレートが存在する場合は、削除されて置き換えられます。ポータル・テンプレートが存在しない場合は作成されます。

新たにインポートされたポータル・テンプレートは、すぐには使用できません。すべてのユーザーが使用できるようにするには、新たにインポートされたテンプレートを公開する必要があります。Oracle WebCenter Portalでのポータルの構築のポータル・テンプレートの公開または非表示に関する項を参照してください。

この項には次のトピックが含まれます:

- 第40.2.2.1項「WebCenter Portalを使用したポータル・テンプレートのアーカイブからのインポート」

- 第40.2.2.2項「WLSTを使用したポータル・テンプレートのアーカイブからのインポート」

40.2.2.1 WebCenter Portalを使用したポータル・テンプレートのアーカイブからのインポート

アプリケーション・スペシャリスト(およびPortal Templates-Manage All権限を持つその他のユーザー)は、ポータル・テンプレートをWebCenter Portalにインポートできます。詳細は、Oracle WebCenter Portalでのポータルの構築のポータル・テンプレートのインポートに関する項を参照してください。

40.2.2.2 WLSTを使用したポータル・テンプレートのアーカイブからのインポート

WLSTコマンドimportWebCenterPortalsを使用して、1つ以上のポータル・テンプレートをアーカイブ(.parファイル)からインポートします。WLSTを使用してポータル・テンプレート・アーカイブをインポートする場合、テンプレートのコンテンツ・フォルダをインポートするかどうかを選択できます。

importWebCenterPortals(appName, fileName, names, [importPortalContent], [overwrite], [savePortals], [importLog])

設定するオプションは、特定のアーカイブ要件によって異なります。コマンドの構文については、『WebLogic Scripting Toolコマンド・リファレンス』のimportWebCenterPortalsに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

次に、いくつかの例を示します。

例1: コンテンツを含まない新しいポータル・テンプレートのインポート

次の例では、myPortalTemplateExport.parにアーカイブされているポータル・テンプレートNew Hireをインポートして、インポート・ログ・ファイルの名前と場所を指定します。ドキュメントはこのテンプレートで有効ではないため、テンプレートにコンテンツ・フォルダはありません。

importWebCenterPortals(appName='webcenter', fileName='myPortalTemplateExport.par',
names='NewHire', importLog='newHireTemplate_import.log')

例2: コンテンツを含む2つの既存のポータル・テンプレートのインポート

この例では、SalesTargetTemplateおよびNewProjectTemplateというポータル・テンプレートをターゲットでバックアップして、既存のテンプレートとそのコンテンツ・フォルダを、myPortalTemplateExport.parの情報で上書きします。

importWebCenterPortals(appName='webcenter', fileName='myPortalTemplateExport.par',
names='SalesTargetTemplate,NewProjectTemplate', importPortalContent=1,
overwrite=1, savePortals=1, importLog='myPortalTemplate_import.log')

40.3 アセットのデプロイ

認可されたユーザーは、WebCenter Portalの実行時に、スキンおよびページ・テンプレートなどのアセットをダウンロードし、Oracle JDeveloperなどのツールでそれらのアセットを編集および拡張してから、WebCenter Portalにデプロイしなおすことができます。アセットを他のWebCenter Portalインスタンスと共有するユーザーやWebCenter Portalインスタンスに移行するユーザーも、ダウンロード機能とアップロード機能を使用できます。

WebCenter Portalユーザーは、ポータル・ビルダーを使用して次のアセットをダウンロードおよびアップロードでき、管理者は、WLSTコマンドを使用して同じタスクを実行できます。

- ページ・テンプレート

- ナビゲーション

- リソース・カタログ

- スキン

- ページ・スタイル

- コンテンツ・プレゼンタ表示テンプレート

- タスク・フロー・スタイル

- タスク・フロー

- データ・コントロール

注意:
個々のページレットのアップロードまたはダウンロードはできませんが、個々のポータルやWebCenter Portalインスタンス全体を移行するときにすべてのアセット(ページレットを含む)が含まれます。

WebCenter Portalのアセットをダウンロード(またはエクスポート)する場合、アセットの詳細はエクスポート・アーカイブ(.earファイル)に保存されます。希望のファイル名を使用して、エクスポート・アーカイブをローカル・ファイル・システムまたはリモート・サーバー・ファイル・システムに保存することができます。

外部アセットの依存関係

アセットで使用または参照されるアーティファクト(アイコン、イメージおよびデータ・コントロールなど)はアーカイブに含まれません。アセットを別のWebCenter Portalインスタンスにアップロードする場合、依存アセット・アーティファクトを手動で管理および移動する必要があります。コンテンツの識別や移動が簡単になるように、必要に応じて、アセットのアーティファクト専用のフォルダ構造をコンテンツ・サーバーで使用することをお薦めします。

注意:
MDSにアーティファクトを格納するレガシー・アセットを管理する場合、依存アーティファクトをコンテンツ・サーバーに再配置することをお薦めします。ただし、MDSに格納されているアーティファクトを移動する必要がある場合は、MDSのWLSTコマンドexportMetadataおよびimportMetadataを使用できます。例:

exportMetadata(application='webcenter', server='WC_Spaces',
toLocation='/tmp/content',
docs='/oracle/webcenter/siteresources/scopedMD/shared/**')

importMetadata(application='webcenter', server='WC_Spaces',
fromLocation='/tmp/content',
docs='/oracle/webcenter/siteresources/scopedMD/shared/**')

この項には次のトピックが含まれます:

- 第40.3.1項「アーカイブへのアセットのエクスポート」

- 第40.3.2項「アーカイブからのアセットのインポート」

40.3.1 アーカイブへのアセットのエクスポート

この項では、アセット・アーカイブを作成する様々な方法について説明します。次のトピックが含まれています。

- 第40.3.1.1項「ポータル・ビルダーによるアーカイブへのアセットのエクスポート」

- 第40.3.1.2項「WLSTを使用したアーカイブへのアセットのエクスポート」

- 第40.3.1.3項「JDeveloperによるアーカイブへのアセットのエクスポート」

第40.3.2.1項「アセットのインポート(またはエクスポート)に必要な権限について」も参照してください。

40.3.1.1 ポータル・ビルダーによるアーカイブへのアセットのエクスポート

管理者、アプリケーション・スペシャリストおよびポータル・モデレータは、ポータル・ビルダーからアセットをエクスポートできます。詳細は、Oracle WebCenter Portalでのポータルの構築のアセットのダウンロードに関する項を参照してください。

40.3.1.2 WLSTを使用したアーカイブへのアセットのエクスポート

管理者は、WLSTコマンドexportWebCenterResourceを使用して、単一アセットをWebCenter Portalからエクスポートできます。

exportWebCenterResource(appName, fileName, resourceType, [resourceGUID,
resourceName, spaceName, exportContentDirectory,server, applicationVersion])

設定するオプションは、エクスポートするアセットによって異なります。コマンドの構文については、『WebLogic Scripting Toolコマンド・リファレンス』のexportWebCenterResourceに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

次に、いくつかの例を示します。

例1: 「Sales」ポータルに属するページ・テンプレートのエクスポート

次の例では、Salesポータルのページ・テンプレートをmySalesPageTemplateExport.earというファイルにエクスポートします。

exportWebCenterResource(appName='webcenter',
fileName='mySalesPageTemplateExport.ear', resourceType='pageTemplate',
resourceGUID='gsr47d9a5ac_7398_439a_97d2_8b54ce905f7e, spaceName='SalesPortal')

例2: GUIDで識別する共有ポータル・スキンのエクスポート

次の例では、共有ポータル・スキンをmySharedSkinExport.earというファイルにエクスポートします。

exportWebCenterResource(appName='webcenter', fileName='mySharedSkinExport.ear',
resourceType='skin', resourceGUID='gsr5a8c2fcc_bc7f_4cba_9254_36df58d66e60)

例3: 名前で識別する共有ポータル・スキンのエクスポート

次の例では、同じ共有ポータル・スキンをエクスポートしますが、GUIDではなくスキンの表示名を指定します。

exportWebCenterResource(appName='webcenter', fileName='mySharedSkinExport.ear',
resourceType='skin', resourceName='MyCompanySkin)

40.3.1.3 JDeveloperによるアーカイブへのアセットのエクスポート

開発者は、他のユーザーがデプロイできるように、JDeveloperで作成または拡張したアセットをアーカイブ(.earファイル)にエクスポートできます。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のアーカイブへのWebCenter Portalアセットのエクスポートに関する項を参照してください。

40.3.2 アーカイブからのアセットのインポート

WebCenter Portalのエクスポート・アーカイブ(.earファイル)に以前に保存されたアセットのみをインポートできます。詳細は、第40.3.1項「アーカイブへのアセットのエクスポート」を参照してください。

インポート時:

- 既存のアセット、つまり、同じ内部IDを持つアセットが上書きされます。

- ポータル・アセットは、常に同じポータルにインポートされます。リソースを別のポータルにインポートできません。

この項では、アセットをアーカイブからWebCenter Portalにインポートする様々な方法について説明します。次のトピックが含まれています。

- 第40.3.2.1項「アセットのインポート(またはエクスポート)に必要な権限について」

- 第40.3.2.2項「ポータル・ビルダーを使用したアセットのアーカイブからのインポート」

- 第40.3.2.3項「WLSTを使用したアセットのアーカイブからのインポート」

40.3.2.1 アセットのインポート(またはエクスポート)に必要な権限について

表40-6に、ポータル・ビルダー管理を使用したアセットのインポート(またはエクスポート)に必要なロールと権限を示します。

注意:
WLSTを使用してアセットをインポート(またはエクスポート)するには、WebLogic ServerのMonitorロール(またはそれ以上のロール)も必要です。

表40-6 ポータル・ビルダーを使用したアセットのインポート(またはエクスポート)に必要な権限

アセット

WebCenter Portalの必要なロールまたは権限

説明

共有アセット

- Administrator

- このロールには、共有アセットをインポートおよびエクスポートするために必要な権限が含まれています(Create, Edit, Delete AssetsおよびManage Configuration)。第49.6項「アプリケーション・ロールおよび権限の管理」も参照してください。

または

共有アセット

- Create, Edit, Delete <リソース・タイプ>

- この権限を使用すると、WebCenter Portalの共有アセットを作成および管理できます。

- Manage Configuration

- このアプリケーションレベルの権限(Manage Configuration)により、ポータル・ビルダー管理ページにアクセスできます。

ポータル・アセット

- Moderator

- このロールには、必要な権限(Create, Edit, Delete AssetsおよびManage Configuration)が含まれています。『Oracle WebCenter Portalの使用』のポータルのロールおよび権限の管理に関する項も参照してください。

または

ポータル・アセット

- Create, Edit, Delete Resources (標準)
または

Create, Edit, Delete <resourcetype> (拡張)

- これらの権限を使用すると、特定のポータルのアセットを作成および管理できます。ポータルに応じて、標準またはアドバンスト権限のいずれかが適用されます。

- Manage Configuration

- このポータルレベルの権限(Manage Configuration)により、特定のポータルのアセット管理ページにアクセスできます。

40.3.2.2 ポータル・ビルダーを使用したアセットのアーカイブからのインポート

管理者、アプリケーション・スペシャリストおよびポータル・モデレータは、ポータル・ビルダーからアセットをインポートできます。詳細は、Oracle WebCenter Portalでのポータルの構築のアセットのアップロードに関する項を参照してください。

40.3.2.3 WLSTを使用したアセットのアーカイブからのインポート

管理者は、WLSTコマンドimportWebCenterResourceを使用して、単一アセットをWebCenter Portalにデプロイできます。

importWebCenterResource(appName, fileName, [resourceType, spaceName,
overwriteContentDirectory, server, applicationVersion])

設定するオプションは、デプロイするアセットによって異なります。コマンドの構文については、『WebLogic Scripting Toolコマンド・リファレンス』のimportWebCenterResourceに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

次に、いくつかの例を示します。

例1: 「Sales」ポータルへのページ・テンプレートのデプロイ

次の例では、mySalesPageTemplateExport.earにアーカイブされているページ・テンプレートをSalesポータルにインポートします。

importWebCenterResource(appName='webcenter',
fileName='mySalesPageTemplateExport.ear', resourceType='pageTemplate',
spaceName='SalesPortal')

例2: 共有ポータル・スキンのデプロイ

次の例では、mySharedSkinExport.earにアーカイブされている共有ポータル・スキンをインポートします。

importWebCenterResource(appName='webcenter', fileName='mySharedSkinExport.ear',
resourceType='skin')

40.4 デバイスおよびデバイス・グループのデプロイ

管理者は、デバイス・グループおよびデバイスをファイル(.earファイル)にエクスポートし、これらを別のWebCenter Portalインスタンスにインポート(デプロイ)できます。たとえば、ステージングで開発されたデバイスまたはデバイス・グループを本番サーバーに移動する場合や、デバイスおよびデバイス・グループを別のWebCenter Portalインストールと共有する場合などがあります。

注意:
デフォルトのデバイス・グループやデバイスをエクスポートまたはインポートすることはできません。自分や他の管理者が作成またはコピーしたデバイス・グループやデバイスのみをエクスポートおよびインポートできます。

この項には次のトピックが含まれます:

- 第40.4.1項「アーカイブへのデバイスおよびデバイス・グループのエクスポート」

- 第40.4.2項「アーカイブからのデバイスおよびデバイス・グループのインポート」

40.4.1 アーカイブへのデバイスおよびデバイス・グループのエクスポート

この項には次のトピックが含まれます:

- 第40.4.1.1項「ポータル・ビルダーを使用したデバイスおよびデバイス・グループのエクスポート」

- 第40.4.1.2項「WLSTを使用したデバイスおよびデバイス・グループのエクスポート」

40.4.1.1 ポータル・ビルダーを使用したデバイスおよびデバイス・グループのエクスポート

管理者は、ポータル・ビルダー管理から1つ以上のデバイスおよびデバイス・グループをファイル(.earファイル)にエクスポートできます。詳細は、第53.4項「デバイスおよびデバイス・グループのライフ・サイクルの管理」を参照してください。

40.4.1.2 WLSTを使用したデバイスおよびデバイス・グループのエクスポート

管理者は、WLSTコマンドexportWebCenterResourceを使用して、WebCenter Portalの単一のデバイスまたはデバイス・グループをファイル(.earファイル)にエクスポートできます。

exportWebCenterResource(appName, fileName, resourceType, [resourceName, server,
applicationVersion])

コマンドの構文については、『WebLogic Scripting Toolコマンド・リファレンス』のexportWebCenterResourceに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

次に、いくつかの例を示します。

例1: デバイス・グループのエクスポート

次の例では、WebCenter Portalの「MyMobileDeviceGroup」というデバイス・グループをエクスポートします。

exportWebCenterResource(appName='webcenter', fileName='myDeviceGroupExport.ear',
resourceType='deviceGroup', resourceName='MyMobileDeviceGroup)

例2: デバイスのエクスポート

次の例では、WebCenter Portalの「MyMobileDevice」というデバイスをエクスポートします。

exportWebCenterResource(appName='webcenter', fileName='myDeviceExport.ear',
resourceType='device', resourceName='MyMobileDevice)

40.4.2 アーカイブからのデバイスおよびデバイス・グループのインポート

この項には次のトピックが含まれます:

- 第40.4.2.1項「ポータル・ビルダーを使用したデバイスおよびデバイス・グループのインポート」

- 第40.4.2.2項「WLSTを使用したデバイスおよびデバイス・グループのインポート」

40.4.2.1 ポータル・ビルダーを使用したデバイスおよびデバイス・グループのインポート

管理者は、ポータル・ビルダー管理を使用して1つ以上のデバイスおよびデバイス・グループをファイル(.earファイル)からインポートできます。詳細は、第53.4項「デバイスおよびデバイス・グループのライフ・サイクルの管理」を参照してください。

40.4.2.2 WLSTを使用したデバイスおよびデバイス・グループのインポート

管理者は、WLSTコマンドimportWebCenterResourceを使用して、1つ以上のデバイスまたはデバイス・グループをファイル(.earファイル)からWebCenter Portalにデプロイできます。

importWebCenterResource(appName, fileName, [resourceType, server,
applicationVersion])

コマンドの構文については、『WebLogic Scripting Toolコマンド・リファレンス』のimportWebCenterResourceに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

次に、いくつかの例を示します。

例1: デバイス・グループのデプロイ

次の例では、myDeviceGroupExport.earにエクスポートされたデバイス・グループをインポートします。

importWebCenterResource(appName='webcenter', fileName='myDeviceGroupExport.ear',
resourceType='deviceGroup')

例2: デバイスのデプロイ

次の例では、myDeviceExport.earにアーカイブされているデバイスをインポートします。

importWebCenterResource(appName='webcenter', fileName='myDeviceExport.ear',
resourceType='device')

40.5 カスタム共有ライブラリの拡張機能のデプロイ

開発者は、JDeveloperを使用して、ポータルのカスタムADFライブラリ・コンポーネント(管理対象Bean、タスク・フローおよびデータ・コントロールなど)を構築したり、これらのコンポーネントを共有ライブラリの拡張機能としてポータル・サーバーにデプロイしたりすることができます。

『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のJDeveloperを使用したWebCenter Portalのコンポーネントの開発に関する項も参照してください。

40.6 ステージングから本番への接続の詳細の移動

管理者は、WLSTコマンドexportWebCenterPortalConnectionsおよびimportWebCenterPortalConnectionsを使用して、あるWebCenter Portalインストールの接続の詳細を別のWebCenter Portalインストールに移行できます。これらのコマンドは、ポータルをインポートまたはリストアする際に、ソース・サーバーで使用される接続(ポートレット・プロデューサ接続やWebサービス接続など)がターゲット・サーバーに存在しない場合に役立ちます。

移行できる接続タイプの詳細は、第40.1.2.1.3項「接続プロパティ・ファイルの理解」を参照してください。

この項には次のトピックが含まれます:

- 第40.6.1項「ファイルへのWebCenter Portal接続の詳細のエクスポート」

- 第40.6.2項「ファイルからの新しいWebCenter Portal接続のインポート」

40.6.1 ファイルへのWebCenter Portal接続の詳細のエクスポート

WebLogic ServerのOperatorロール(あるいはそれ以上のロール)を持っている場合、WLSTコマンドexportWebCenterPortalConnectionsを使用して、特定のWebCenter Portalインストールに現在構成されている接続情報をファイルにエクスポートできます。

exportWebCenterPortalConnections(appName, fileName, [connectionType,
connectionName, logFile, server, applicationVersion])

注意:
特定のポータルの接続はエクスポートできません。接続は、すべてのポータル間で共有されます。

設定するオプションは、エクスポートする接続情報によって異なります。コマンドの構文については、『WebLogic Scripting Toolコマンド・リファレンス』のexportWebCenterPortalConnectionsに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

次に、いくつかの例を示します。

例1: WSRPプロデューサおよび外部アプリケーションのすべての接続をファイルにデプロイする場合

次の例では、WSRPプロデューサと外部アプリケーションの接続のみを、myconnection.propertiesというファイルにエクスポートします。

exportWebCenterPortalConnections(appName='webcenter',
fileName='/myConnections/myconnection.properties',
connectionType='wsrpProducerConnection,externalAppConnection')

例2: 特定のWSRPプロデューサ接続をファイルにデプロイする場合

次の例では、MyWSRP1およびMyWRSP2という2つのWSRPプロデューサ接続の接続構成情報をエクスポートします。

exportWebCenterPortalConnections(appName='webcenter',
fileName='/myConnections/connection.properties',
connectionType='wsrpProducerConnection', connectionName='MyWSRP1,MyWSRP2')

40.6.2 ファイルからの新しいWebCenter Portal接続のインポート

WebLogic ServerのOperatorロール(あるいはそれ以上のロール)を持っている場合、WLSTコマンドimportWebCenterPortalConnectionsを使用して、あるWebCenter Portalインストールからエクスポートされた接続情報を別のWebCenter Portalインストールにデプロイできます。

importWebCenterPortalConnections(appName, fileName, [promptForPassword, logFile,
server, applicationVersion])

ターゲットには、新しい接続のみがインポートされます。ターゲットにすでに存在する接続は無視されます。ソース接続情報は、WLSTコマンドexportWebCenterPortalConnectionsを使用してエクスポートする必要があります。この方法を確認するには、第40.6.1項「ファイルへのWebCenter Portal接続の詳細のエクスポート」を参照してください。

必要な場合、ターゲットに接続情報をデプロイする前に、接続情報を含むファイルを編集できます。第40.1.2.1.3項「接続プロパティ・ファイルの理解」も参照してください。

例1: ファイルからの接続のインポート

次の例では、/myConnectionsにあるmyconnection.propertiesというファイルで定義される接続をインポートします。接続のインポート操作に関する詳細情報のログは、importConnection.logにも記録されます。

importWebCenterPortalConnections(appName='webcenter',
fileName='/myConnections/myconnection.properties',logFile='importConnection.log')

例2: 資格証明が必要な接続のインポート

次の例では、/myConnectionsにあるmyconnection.propertiesというファイルで定義される接続をインポートし、必要な場合は資格証明のプロンプトを表示します。

importWebCenterPortalConnections(appName='webcenter',
fileName='/myConnections/myconnection.properties', promptForPassword=1)

コマンドの構文については、『WebLogic Scripting Toolコマンド・リファレンス』のimportWebCenterPortalConnectionsに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

40.7 ステージングから本番へのポータルの移動

ポータルを本番サーバーに移動する前に、ステージング環境を使用してポータルの開発とテストを行う場合、両方の環境が同期するように、必ず最初にステージングの変更を行い、その変更を本番に移動することをお薦めします。ポータルを移動する手順は、第40.9項「本番でのポータルの管理」で説明する手順とまったく同じです。

40.8 ステージングから本番への外部ポータル・データの移動

この項の内容は次のとおりです。

- 第40.8.1項「個々のポータルのバックエンド・コンポーネントの移行」

- 第40.8.2項「ポータル・サーバー全体のバックエンド・コンポーネントの移行」

40.8.1 個々のポータルのバックエンド・コンポーネントの移行

1つ以上のポータルを別のサーバーに移動または移行した後、各種バックエンド・コンポーネントで格納されているポータル・データを(オプションで)移行できます。

ディスカッション:

- 第40.8.1.1項「アーカイブへのポータル・ディスカッションのエクスポート」

- 第40.8.1.2項「アーカイブからのポータル・ディスカッションのインポート」

コンテンツ:

- 第40.8.1.3項「ポータルのコンテンツのエクスポート」

- 第40.8.1.4項「ポータルのコンテンツのインポート」

ページレット:

- 第22.5.1項「ページレット・プロデューサ・リソースのエクスポートおよびインポート」

- 第22.5.2項「WLSTを使用したページレット・プロデューサ・メタデータのエクスポートおよびインポート」

1つ以上のポータルをインポートした後で、Oracle Secure Enterprise Searchクロールを開始して、新たにインポートされたデータを索引付けすることを検討してください。

40.8.1.1 アーカイブへのポータル・ディスカッションのエクスポート

ディスカッション・サーバーの管理コンソールを使用して、特定のポータルに関連付けられているディスカッションをエクスポートします。

ポータル・ディスカッションが.xmlファイルにエクスポートされ、DOMAIN_HOME/config/fmwconfig/servers/<target_server_name>/owc_discussions/data/ディレクトリの.zipファイルに保存されます。

DOMAIN_HOMEは、Oracle WebLogic Serverドメインのパスです。例: MW_HOME/user_projects/domains/my_domain/config/fmwconfig/servers/WC_Collaboration/owc_discussions/data/。

ポータルのディスカッションをエクスポートするには:

1. ディスカッション・サーバーの管理コンソールにログインします。
コンソールのURLがわかっている場合は、直接ログインできます。例: http://example.com:8890/owc_discussions/admin

または、次のようにWebCenter Portalからログインします。

1. WebCenter Portal管理を開きます。
詳細は、第47章「ポータル・ビルダー管理内の「管理」ページの検索」を参照してください。

2. 「ポータル」をクリックします。

3. ディスカッションをエクスポートするポータルを選択して、「管理」を選択します。

4. 「ツールとサービス」、「ディスカッション」の順にクリックします。

5. このポータルに関連付けられている「フォーラム名」/「フォーラムID」または「カテゴリ名」/「カテゴリID」を書き留めます。
WebCenter Portalのディスカッション・サーバーは、ディスカッション・カテゴリおよびフォーラムIDを順番に生成します。ターゲット・システムにこのIDが存在する場合、インポートされたフォーラム(またはカテゴリ)には新しい一意のIDが割り当てられるため、インポートされたポータルが新しいIDをポイントするように再構成する必要があります。詳細は、後述の手順11を参照してください。

6. 「フォーラムの管理」をクリックして、ディスカッション・サーバーの管理コンソールにログインします。

2. 管理コンソールで、「システム」メニューを選択し、サイドバーで、「XMLインポートおよびエクスポート」を選択します。

3. 「データのエクスポート」を選択します。

4. 次のオプションを設定します(図40-12)。

1. エクスポート・オプション: 「カスタム・オプション」を選択し、すべてのチェック・ボックスを選択します。

2. コンテンツのエクスポート: 「特定のコンテンツのエクスポート」を選択して、必要なフォーラムまたはカテゴリの名前を選択します。
注意: 複数のフォーラムをサポートするポータルは、カテゴリを使用してディスカッションを格納します。他のポータルは単一フォーラムを使用します。

3. エクスポート場所、エクスポート・ファイル名、エクスポート・ファイルのエンコーディング: デフォルト値を保持します。

図40-12 個々のポータルのディスカッションのエクスポート

5. 「エクスポートの開始」をクリックします。

6. 完了したら、MW_HOME/user_projects/domains/my_domain/config/fmwconfig/servers/<server_name>/owc_discussions/dataディレクトリからターゲット・ディスカッション・サーバーの同じ場所に.zipファイル(エクスポート.xmlファイルを含む)をコピーします。
例: MW_HOME/user_projects/domains/my_domain/config/fmwconfig/servers/WC_Collaboration/owc_discussions/data

ターゲット・システムにディスカッションをインポートする前に、移行するポータルがターゲット上に存在している必要があります。第40.1.2.4.2項「ポータル・ビルダー管理を使用したポータルのアーカイブからのインポート」を参照してください。

40.8.1.2 アーカイブからのポータル・ディスカッションのインポート

ディスカッション・サーバーの管理コンソールを使用して、別のWebCenter Portal環境からエクスポートされたディスカッションをインポートします。

ディスカッション・データをインポートする前に、関連するポータルがターゲット上に存在することを確認します。第40.1.2.2項「別のサーバーへのポータル・アーカイブのデプロイ」または第40.9.2項「ステージングから本番へのポータルの直接デプロイ」を参照してください。

注意:
WebCenter Portalのディスカッション・サーバーは、ディスカッション・カテゴリおよびフォーラムIDを順番に生成します。このため、2つのターゲット間(または、ソースとターゲット間)でディスカッション・データをインポートする場合、両方のシステムに同じIDが存在する可能性があります。IDのクラッシュが発生した場合、インポートされたフォーラム(またはカテゴリ)には新しい一意のIDが割り当てられるため、ポータルが新しいIDをポイントするように再構成する必要があります。詳細は、後述の手順11を参照してください。

特定のポータルのディスカッションをインポートするには:

1. ターゲットのディスカッション・サーバーの管理コンソールにログインします。
コンソールのURLがわかっている場合は、直接ログインできます。例: http://example.com:8890/owc_discussions/admin

または、次のようにWebCenter Portalからログインします。

1. WebCenter Portal管理を開きます。
詳細は、第47章「ポータル・ビルダー管理内の「管理」ページの検索」を参照してください。

2. 「ポータル」をクリックします。

3. データをインポートするポータルを選択して、「管理」を選択します。

4. 「ツールとサービス」、「ディスカッション」の順にクリックします。

5. 「フォーラムの管理」(右端)をクリックし、管理コンソールにログインします。

2. 管理コンソールで、「システム」メニューを選択し、サイドバーで、「XMLインポートおよびエクスポート」を選択します。

3. 「データのインポート」を選択します。

4. 利用可能なリストから適切なインポート・ファイルを選択します(図40-13)。
必要なファイルがリスト表示されていない場合は、ソース・ディレクトリDOMAIN_HOME/config/fmwconfig/servers/<target_server_name>/owc_discussions/data/からこのターゲット上の同じ場所にエクスポート.zipファイルをコピーします。第40.8.1.1項「アーカイブへのポータル・ディスカッションのエクスポート」も参照してください。

DOMAIN_HOMEは、Oracle WebLogic Serverドメインのパスです。例: MW_HOME/user_projects/domains/my_domain/config/fmwconfig/servers/WC_Collaboration/owc_discussions/data/

図40-13 ポータルのディスカッションのインポート

5. 「インポートの開始」をクリックします。
インポート時に、ディスカッション・データはディスカッション・サーバーにコピーされます。次の手順で、以前に移行したポータルを、この新たにインポートされたデータと再度関連付けます。

6. 「コンテンツ」メニューを選択し、サイドバーで「コンテンツ・サマリー」を選択します。
システムのすべてのカテゴリおよびフォーラムがここにリスト表示されます。

7. 「WebCenter」を選択し、新たにインポートされたフォーラムまたはカテゴリの「移動」ボタンをクリックします。

8. ターゲットWebCenter Portalのルート・カテゴリを選択し、「カテゴリの移動」をクリックします。
「カテゴリのサマリー」ページに新しい場所が表示されます。

9. サイドバーの「権限」をクリックします。

10. ユーザー・タイプ: 「すべてのユーザー」および「登録済のユーザー」のすべての権限を解除し、「変更の保存」をクリックします(図40-14)。

図40-14 フォーラム権限の編集

11. WebCenter Portalで、ポータルのディスカッション・フォーラム設定に移動して、ポータルと、インポートしたばかりのディスカッション・データを再度関連付けます。

1. WebCenter Portal管理を開きます。
詳細は、第47章「ポータル・ビルダー管理内の「管理」ページの検索」を参照してください。

2. 「ポータル」をクリックします。

3. データをインポートするポータルを選択して、「管理」を選択します。

4. 「ツールとサービス」、「ディスカッション」の順にクリックします。

5. 「カテゴリID」または「フォーラムID」の横の「検索」アイコンをクリックし、リストからインポート済カテゴリ(またはフォーラム)を選択して、「選択」をクリックします。

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

40.8.1.3 ポータルのコンテンツのエクスポート

ポータルに関連付けられているドキュメントとコンテンツはポータル・フォルダに配置することをお薦めします。ポータルをアーカイブにエクスポートする場合、このポータル・フォルダをポータル・アーカイブに含めるオプションがあります(第40.1.2.3項「ポータル・アーカイブの作成」を参照)。また、ポータルを別のポータル・サーバーに直接デプロイする場合、同様のオプションがあります(第40.9.2項「ステージングから本番へのポータルの直接デプロイ」を参照)。

注意:
ポータルと一緒にポータル・フォルダを移行しない場合、WebCenter Content Serverの移行ツールを使用してポータル・フォルダをターゲットに手動で移行できます。詳細は、Oracle WebCenter Contentの管理のシステムの移行とアーカイブに関する項を参照してください。

ポータル・フォルダ以外に、ポータルでは、次のような他の場所にあるコンテンツを参照します。

- コンテンツ・サーバーの他のフォルダ

- 外部コンテンツ・リポジトリまたはWebの場所

他のフォルダや場所のコンテンツはポータルと一緒にエクスポートできないため、ターゲット・システムでソースと同じコンテンツにアクセスできるようにする必要があります。第40.8.1.4項「ポータルのコンテンツのインポート」も参照してください。

どのような場合でも、ドキュメントとコンテンツはソース・コンテンツ・リポジトリに残るため、ポータルをターゲットに移行した後に必要なコンテンツを適宜移行できます。

40.8.1.4 ポータルのコンテンツのインポート

ポータル・ビルダー管理からポータルをインポートする場合、ドキュメントをポータルとともにインポートする場合は、インポート・ダイアログで「コンテンツ・サーバー上のポータル・フォルダを含む」を選択できます。WLSTコマンドimportWebCenterPortalsを使用してインポートを行う場合は、importPortalContent=1を設定します。

注意:

- ポータル・アーカイブに必ずポータル・フォルダが含まれるわけではありません。ポータル・フォルダを含めるには、エクスポート時に「コンテンツ・サーバー上のポータル・フォルダを含む」オプションを同様に選択する必要があります。詳細は、第40.1.2.3項「ポータル・アーカイブの作成」を参照してください。

- ステージング環境のポータル・フォルダに、イメージなど、サポートするイメージを参照するHTMLファイルが含まれる場合、インポートしたHTMLファイルが本番環境でサポートするファイルを指していることを確認する必要があります。

ポータル・フォルダに格納されないコンテンツ

ポータル独自のコンテンツ・フォルダの外部に格納されるコンテンツがポータル・アーカイブに含まれることはありません。ポータルにポータル・アセット、ポータル・ページ、コンテンツ・プレゼンタ表示テンプレート、またはポータル・フォルダの外部のコンテンツを参照するコンポーネントが含まれる場合、次のいずれかの操作を行う必要があります。

- このようなコンテンツを手動でターゲットに移動します。

- ターゲットがソースと同じコンテンツにアクセスできるようにします。

注意:
ポータルを別のターゲットに移動する場合、コンテンツ・プレゼンタのデータ参照は、コンテンツ・サーバーの接続名とルート・フォルダ名がソースとターゲットの両方で同じ場合のみ維持されます。

Oracle WebCenter Content Serverの移行ツールの詳細は、Oracle WebCenter Contentの管理のシステムの移行とアーカイブに関する項を参照してください。他のコンテンツ・リポジトリについては、メーカーの製品ドキュメントを参照してください。

40.8.2 ポータル・サーバー全体のバックエンド・コンポーネントの移行

ポータル・サーバー全体を移動または移行する前に、アプリケーションで使用されるすべてのバックエンド・コンポーネントを移行する必要があります。第41.5項「別のターゲットへのWebCenter Portal全体の移行」を参照してください。

40.9 本番でのポータルの管理

この項には次のトピックが含まれます:

- 第40.9.1項「ポータル伝播の理解」

- 第40.9.2項「ステージングから本番へのポータルの直接デプロイ」

- 第40.9.3項「ステージングから本番へのポータル変更の伝播」

40.9.1 ポータル伝播の理解

管理者は、ステージング環境と本番環境が接続されて「同期」状態の場合、ステージングのメタデータの変更を本番に伝播できます。必ず最初にステージングの変更を行い、その後デプロイメントまたは伝播を使用してメタデータの変更を本番にプッシュすることを強くお薦めします。

伝播機能は、ポータル・メタデータ(ページ、アセット、ページで削除されたポートレットなど)の変更を移行する場合に便利です。伝播ではポータル・メタデータの変更のみが転送されるため、本番サーバーを再起動する必要はなく、ダウンタイムは生じません。詳細は、表40-7を参照してください。

表40-7 本番に伝播されるポータルの変更

伝播されるポータルの変更

可/不可

ポータルレベルのカスタマイズ(メタデータ)

ポータル・ページおよびシステム・ページ

はい

ポートレット

はい

アセット

はい

タスク・フロー

はい

ユーザーレベルのカスタマイズ(メタデータ)

ポータル・ページ

はい

ポートレット

いいえ

タスク・フロー・インスタンス

はい

ポータル・フォルダ・コンテンツ

いいえ

サブポータル

いいえ

ポータルのアクティビティおよび使用状況データ

(アクティビティ・ストリーム、カレンダ・イベント、フィードバック、リスト、リンク、メッセージ・ボード、ピープル・コネクション、プロファイル、投票、アンケート)

いいえ

ポータル・セキュリティ・データ

(ポータル・ロールおよび権限、メンバーの詳細とそのロールの割当て)

いいえ

ポータルで参照される外部コンテンツ

(ポータル・ページ、ポータル・アセット、コンテンツ・プレゼンタ表示テンプレート、Site Studioなどで参照)

いいえ

外部サーバーに格納されるデータ

(ディスカッション、メール、お知らせ、分析、カスタム・タスク・フローおよび共有ライブラリ)

いいえ

伝播時のラベル付け

伝播機能を使用する場合、WLSTコマンドdeployWebCenterPortalを使用して、ポータルから本番へデプロイを移動する必要がありますが、このコマンドにより、本番インスタンス上にステージ・ポータル全体が再作成され、ステージ・ポータルおよび本番ポータル上に照合ラベル(たとえば、LABEL_1)が作成されます。その後、WLSTコマンドpropagateWebCenterPortalを使用して変更をステージから本番に伝播する際には、次の表に示すように、ステージと本番の両方の環境でポータルのラベルが1だけ増分されます。

ステージングのポータルの変更

アクション

WLSTコマンド

ラベル

初回のみ

ステージング・ポータルを本番にデプロイします。

deployWebCenterPortal

LABEL_1

以降の変更

このステージング・ポータルのメタデータ変更を本番に伝播します。

propagateWebCenterPortal

LABEL_2

以降の変更

追加のメタデータ変更を伝播します。

"

LABEL_3

以降の変更...

"

"

LABLE_n+1

付録E「WebCenter Portalのライフサイクル中のラベル付け」も参照してください。

40.9.2 ステージングから本番へのポータルの直接デプロイ

管理者は、WLSTコマンドdeployWebCenterPortalを使用して、単一のオンライン・ポータルを別のターゲット・サーバーに直接デプロイできます。指定したポータルに1つ以上のサブポータルがある場合、依存ポータルもデプロイされます。ソースのポータルのメタデータ変更(ページやアセットの更新など)をターゲットに伝播する場合は、この方法を使用してポータルをデプロイする必要があります。

ポータルをデプロイする前に、いくつかの前提条件タスクを完了する必要があります。全体のプロセスは次のようになります。

- 手順1: ポータルの直接デプロイメントの前提条件の完了

- 手順2: ソース環境でのdeployWebCenterPortalの実行

- 手順3: 新たにデプロイしたポータルのターゲット環境での検証

手順1: ポータルの直接デプロイメントの前提条件の完了

WLSTコマンドdeployWebCenterPortalを実行する前に、次の操作を行います。

1. WebCenter Portalがデプロイされている管理対象サーバーの名前がソース環境とターゲット環境で同じであることを検証します。たとえば、WC_Spacesなどになります。
管理対象サーバーの名前が一致する場合にのみ、deployWebCenterPortalを実行できます。管理対象サーバー名が異なる場合は、第40.1.2.3項「ポータル・アーカイブの作成」の説明に従い、ポータル・アーカイブのデプロイメントをかわりに使用します。

2. 少なくともWebLogic ServerのMonitorロールおよびWebCenter Portal権限Portals - Manage Security and Configurationを持っていることを確認します。

3. ソースWebCenter PortalとターゲットWebCenter Portalとの間に接続が存在することを確認します。
まだ接続がない場合は、WLSTコマンドadf_createHttpURLConnectionを使用して、ソース環境からターゲットへの接続を作成します。

たとえば、ソース環境で次のように実行します。

adf_createHttpURLConnection(appName='webcenter',name='MyWebCenterPortalTarget',
url='http://example.com:7777', user='myuser', password='mypassword',
realm='ProductionRealm')

第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

4. (オプション)外部に格納されているポータル・データをターゲット環境に移動します。
詳細は、第40.8.1項「個々のポータルのバックエンド・コンポーネントの移行」を参照してください。

5. (オプション)ポータル(およびポータル・コンポーネント)で使用されるすべての接続がターゲットで構成されていることを確認します。
deployWebCenterPortalコマンドでは、たとえば、Webサービス・データ・コントロールに構成されている接続を移行しません。ターゲットに存在しない接続は個別に移行する必要があります。詳細は、第40.6項「ステージングから本番への接続の詳細の移動」を参照してください。

手順2: ソース環境でのdeployWebCenterPortalの実行

ソースWebCenter Portalで、次の操作を行います。

1. ソースWebCenter PortalのOracleホーム・ディレクトリからWLSTツールを起動し、WebCenter Portalの管理サーバーに接続します。
詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

2. WLSTコマンドdeployWebCenterPortalを実行して、ポータルをターゲット・サーバーにデプロイします。

deployWebCenterPortal(appName, portalName, targetConnectionName
[deployCustomizations, deployContent, deploySecurity, deployData,
deployActivities, overwrite, savePortal, deployLog, server,
applicationVersion])

コマンドの構文と説明の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のdeployWebCenterPortalに関する項を参照してください。

設定するオプションは、特定のデプロイメント要件によって異なります。次に、2つの一般的な例を示します。

例1: ターゲットにポータルを初めてデプロイする場合

この例では、myPortalという新しいポータルと、その関連コンテンツ、データ、セキュリティおよびカスタマイズをすべてデプロイし、さらにデプロイ・ログ・ファイルの名前と場所を指定します。

deployWebCenterPortal(appName='webcenter',portalName='myPortal',
targetConnectionName='MyWebCenterPortalTarget',deployCustomizations=1,
deployPortalContent=1,deploySecurity=1,deployData=1,deployActivities=1,
deployLog='/mydeploylogs/myPortal_deploy.log')

注意:
新しいポータルはセキュリティ・ポリシーがないとインポートできないため、新しいポータルをインポートする場合は必ずdeploySecurity=1を設定してください。

例2: ターゲットに存在するポータルを再デプロイする場合

この例では、ターゲットでmyExistingPortalというポータルをバックアップした後、ターゲット・ポータル(overwrite=1)をソース・ポータルで上書きします。ターゲット・ポータルに関連付けられているコンテンツ、データ、セキュリティおよびカスタマイズは保持されます。

deployWebCenterPortal(appName='webcenter',portalName='myExistingPortal',
targetConnectionName='MyWebCenterPortalTarget',deployCustomizations=0,
deployPortalContent=0,deploySecurity=0,deployData=0,overwrite=1,savePortal=1)

3. デプロイメント・ログ・ファイルを調べます。
このファイルは、指定した場所(deployLog)、または一時ディレクトリのPortalDeploy_<timestamp>.logというファイルで入手できます。

手順3: 新たにデプロイしたポータルのターゲット環境での検証

ターゲットWebCenter Portalで、次の操作を行います。

1. ターゲットWebCenter Portalにログインします。

2. 新しいポータル・デプロイメントに移動します。

3. ポータルが予想どおりに機能することを検証します。

40.9.3 ステージングから本番へのポータル変更の伝播

ポータルの直接伝播は、ソース環境とターゲット環境との間に接続が存在し、ポータルが以前にWLSTコマンドdeployWebCenterPortalsを使用してターゲットに直接デプロイされた場合のみ可能です。第40.9.2項「ステージングから本番へのポータルの直接デプロイ」を参照してください。

ステージングから本番にメタデータ変更を伝播するには:

1. WLSTコマンドadf_createHttpURLConnectionを実行して、本番サーバーへの接続を作成します。

adf_createHttpURLConnection(appName, name, url, user, password, realm)

2. WLSTコマンドpropagateWebCenterPortalを実行して、ポータルのメタデータを伝播します。

propagateWebCenterPortal(appName, portalName, targetConnectionName,
[savePortal, propagateLog, server, applicationVersion])

設定するオプションは、特定の要件によって異なります。コマンドの構文については、『WebLogic Scripting Toolコマンド・リファレンス』のpropagateWebCenterPortalに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

次にいくつかの例を示します。

例1: ポータルのメタデータ変更の伝播

次のコマンドでは、本番サーバーへの接続(MyProductionConnection)を作成し、myPortalというポータルのメタデータ変更をターゲット・サーバーに伝播します。

adf_createHttpURLConnection(appName='webcenter', name='MyProductionConnection',
url='http://example.com:7777', user='myuser',  password='mypassword',
realm='ProductionRealm')

propagateWebCenterPortal(appName='webcenter', portalName='myPortal',
targetConnectionName='MyProductionConnection')

例2: ポータルのメタデータ変更を伝播する前にターゲット・ポータルをバックアップする場合

次の例では、ターゲットでmyPortalをバックアップして、myPortalというポータルのメタデータ変更を伝播し、さらに伝播ログ・ファイルの名前と場所を指定します。

propagateWebCenterPortal(appName='webcenter', portalName='myPortal',
targetConnectionName='MyProductionConnection', savePortal=1
propagateLog='/mypropagationlogs/myPortal_propagation.log')

40.10 制限事項

ポータル・デプロイメントとポータル伝播の操作は、2つのWebLogic Serverインスタンス間または2つのIBM WebSphereインスタンス間でのみサポートされます。IBM WebSphereからOracle WebLogic Server(逆も同様)にポータルをデプロイまたは伝播することはできません。

41 WebCenter Portalのバックアップ、リカバリおよびクローニングの管理

この章では、WebCenter Portalインストールをバックアップおよびリストアするための手法とツールについて説明します。

この章には次のトピックが含まれます:

- 第41.1項「WebCenter Portalのバックアップおよびリカバリの理解」

- 第41.2項「WebCenter Portalのバックアップ、リカバリおよび移行のツールの比較」

- 第41.3項「個々のポータルのバックアップ」

- 第41.4項「バックアップからのポータルのリストア」

- 第41.5項「別のターゲットへのWebCenter Portal全体の移行」

- 第41.6項「WebCenter Portalインストール全体のバックアップ」

- 第41.7項「WebCenter Portalインストール全体のリストア」

- 第41.8項「スクリプトを使用したWebCenter Portalのバックアップおよびリストア」

- 第41.9項「WebCenter Portal環境のクローニング」

権限:
この章の内容は、システム管理者を対象としています。
ポータル、テンプレート、アセット、接続および拡張機能のデプロイに必要なロールと権限の詳細は、第39.6項「WebCenter Portalのライフ・サイクル操作の実行に必要な権限」を参照してください。

第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

41.1 WebCenter Portalのバックアップおよびリカバリの理解

データベース・ハードウェアを消失した場合や、ファイルまたはデータベースから誤ってデータを削除した場合などの障害からデータをリカバリするには、個々のポータルとWebCenter Portalインスタンス全体を頻繁にバックアップすることが重要です。バックアップの頻度は、WebCenter Portalにより格納されている基礎となる情報が特定の環境でどのくらいの頻度で変更されるか、およびどのくらいの時間と情報量を消失しても許容されるかによって決まります。データが業務にとって非常に重要であり、障害発生時にはデータのリストアが必須である場合は、増分バックアップまたは部分バックアップを適用できます。

WebCenter Portalには、様々なバックアップ・オプションが用意されています。管理者は、次の内容をバックアップできます。

- 1つ以上のポータルまたはポータル階層
WebCenter Portalには、個々のポータルをバックアップおよびリストアするための、エクスポートとインポート用のWLSTコマンドがあります。詳細は、第41.3項「個々のポータルのバックアップ」および第41.4項「バックアップからのポータルのリストア」を参照してください。

- WebCenter Portal環境全体
WebCenter Portalおよび各種バックエンド・コンポーネントのバックアップとリカバリは、データベースのエクスポートとインポートのユーティリティ、および様々な他のツールから管理できます。詳細は、第41.6項「WebCenter Portalインストール全体のバックアップ」および第41.8項「スクリプトを使用したWebCenter Portalのバックアップおよびリストア」を参照してください。

- WebCenter Portalのメタデータ、データおよびセキュリティ
WebCenter Portalには、WebCenter Portalで所有するデータをバックアップまたは移行するための、エクスポートとインポート用のWLSTコマンドおよび手法が用意されています。所有するデータには、WebCenter PortalのMDSデータ(共有アセット、ビジネス・ロール・ページおよびシステム・ページのカスタマイズを含む)、データベース・データ(WEBCENTERデータベース・スキーマのみ)およびセキュリティなどがあります。詳細は、第41.5項「別のターゲットへのWebCenter Portal全体の移行」を参照してください。

注意:
この章では、WebCenter Portalデータをバックアップおよびリストアするための手法のみについて説明しています。Oracle Fusion Middlewareのバックアップとリカバリの戦略については、管理者ガイドの高度な管理: バックアップおよびリカバリに関する項を参照してください。

41.2 WebCenter Portalのバックアップ、リカバリおよび移行のツールの比較

表41-1では、WebCenter Portalのバックアップおよびリストア、またはWebCenter Portalの別のターゲットへの移行で使用できる様々なツールを比較しています。

表41-1 WebCenter Portalのバックアップ、リストアおよび移行のツール

バックアップおよびリストア

バックアップおよびリストアのスクリプト

移行/バックアップ

ポータル/ポータル・テンプレート

WebCenter Portalインストール全体

WebCenter Portalのみ

実行方法

WLSTコマンド:

exportWebCenterPortals

exportWebCenterPortalTemplates

importWebCenterPortals

次の内容に基づきカスタマイズ可能なスクリプト:

master_script.sh、wlst_script.py、backup.properties、restore.properties

WLSTコマンド:

exportWebCenterApplication

importWebCenterApplication

前提条件

WebCenter Portalを、ターゲットにインストールし、完全に構成して実行する必要があります。

WebCenter Portalを、ターゲットにインストールし、完全に構成して実行する必要があります。

WebCenter Portalを、ターゲットにインストールし、完全に構成して実行する必要があります。

使用時期

個々のポータル、ポータル階層、ポータル・テンプレートをバックアップおよびリストアする場合に使用します。

ポータルやポータル・テンプレートが1つまたは2つのみ破損した場合に役立ちます。

(破損した場合に)バックアップ・スクリプトを使用して以前に取得した、毎晩または週1回のバックアップからWebCenter Portalをリストアする場合に使用します。adf-config.xmlとconnections.xmlの構成、および/metadata/security/data/credentialsの資格証明のリストアに使用します。

WebCenter Portalインストール全体を、新しいマシン、またはすでにインストールされてOracle WebCenter Portal用に構成されているWebLogic Serverインスタンスに完全にリストアする場合に使用します。

ステージングから本番への設定で役立ちます。これは、本番インスタンスがインストールおよび構成されており、ステージング・インスタンスのWebCenter Portal(複数のポータル、共有アセット、セキュリティなどを含む)をターゲットに初めてコピーする場合です。

1回の手順でターゲットに移動する必要がある、共有アセットまたは他のグローバル・アーティファクトを大量に使用する複数サイトのポータルに適しています。

破損したWebCenter Portalインスタンスのリストアにはお薦めしません。

バックアップと移行の対象

ポータルのポータルレベルのカスタマイズおよびユーザー・カスタマイズ。

ポータルレベルのタスク・フローのカスタマイズ、ポータルレベルのタスク・フロー・インスタンスのカスタマイズ、ポータルレベル・タスク・フロー・インスタンスのユーザー・カスタマイズ。

ポータル・コンテンツおよびポータル・データ。

ポータルのセキュリティ権限およびロール。

詳細は、次を参照してください。

第40.1.2.1項「ポータル・アーカイブの理解」

第40.1.3項「ポータル階層のデプロイ」

第40.2項「ポータル・テンプレートのデプロイ」

すべてのツールおよびサービス(ディスカッション、お知らせ、イベント、ポートレット、アクティビティ、タグ、ワークリストなど)のMDSメタデータ。

タスク・フロー、ポートレット、システム・ページ、共有アセットのカスタマイズ。

すべてのポータルおよびグローバル・アーティファクトのセキュリティ・ロールと権限、およびユーザーロール割当て。ユーザーと監査データも移行されます。

WEBCENTERおよびMDSデータベース・スキーマに格納されるデータ。

オプションで、DISCUSSIONS、DISCUSSIONS_CRAWLER、ACTIVITIES、PORTLET、OCSなどの他のスキーマに格納されるデータ。

すべてのツールおよびサービス(ディスカッション、お知らせ、イベント、ポートレット、アクティビティ、タグ、ワークリストなど)のMDSメタデータ。

タスク・フロー、ポートレット、システム・ページ、共有アセットのカスタマイズ。

すべてのポータルおよびグローバル・アーティファクトのセキュリティ・ロールと権限、およびユーザーロール割当て

アクティビティ・ストリーム、ポータル・イベント、フィードバック、リスト、リンク、メッセージ・ボード、ピープル・コネクション、プロファイル、投票、アンケートおよびタグに関する、WEBCENTERデータベース・スキーマに格納されるデータ。

バックアップと移行の対象外

共有アセット、グローバル・カスタマイズおよびホーム・ポータルなどのアプリケーションレベルの情報。

WebCenter Portalドメイン。

コンテンツ・サーバー、ディスカッション・サーバー、BPELサーバー、メール・サーバーなどの他のバックエンド・システムに格納されるデータ。

WSRPプロデューサ、PDK-Javaプロデューサ、ディスカッション・サーバーなどへのWebCenter Portal接続。詳細は、第40.1.2.1.3項「接続プロパティ・ファイルの理解」を参照してください。

adf-config.xmlに格納されるアプリケーションレベルの設定(ドメイン/MDS)

資格証明(メタデータ/セキュリティ/データ/資格証明)。

WebCenter Portalドメイン。

長所

特定のポータルやポータル・テンプレートのみがバックアップおよびリストアされるため、比較的高速に行われます。

バックアップおよびリストアする内容をさらに詳細に制御できます。

破損したポータルの数がわずかな場合に最も効果的です。

WebCenter Portalで所有するデータを定期的にバックアップするには、簡単で拡張性があり、信頼できる方法です。

すべての内容を含む大規模な単一アーカイブではなく、複数の細かいバックアップ・アーカイブが生成されます。

MDSデータ、WEBCENTERデータベース・データ、カスタマイズおよびセキュリティが1回の手順で取得されます。

使用しやすく、個別に4つのコマンドを使用するよりも、すばやく行われます。

短所

共有アセットまたはホーム・ポータルをバックアップすることはできません。

データベース・スキーマWEBCENTERおよびMDSを一緒にリストアする必要があります。一緒にリストアしない場合、データが同期しなくなる可能性があります。

OCSなどのスキーマを追加でリストアする場合、データの整合性を維持するには、これらを同時に同じポイントでリストアしておく必要があります。

増分バックアップまたはリストアはサポートされません。

ドメイン構成はバックアップ・スクリプトに含まれないため、ドメインを個別にバックアップする必要があります。管理者ガイドのOracle WebLogic Serverのバックアップおよびリカバリの推奨事項に関する項を参照してください。

様々なバックエンド・サーバーが構成されている別のインスタンスでリストアする場合はお薦めしません。

多くの内部処理が必要です。

ネイティブ・ツールは、データベースからのデータの抽出に使用されません。

注意:
Fusion Middlewareのテストから本番のスクリプトを使用して、WebCenter Portal、WebCenter Content、SOA Suite、BIなどとともにインストールおよび構成されるFusion Middlewareインスタンス全体を、1つ以上のターゲット環境にレプリケートします。これらのスクリプトにより、複数のターゲットで複雑なインストール・プロセスが繰り返されることはありません。詳細は、管理者ガイドの「テストから本番環境への移動」を参照してください。
ソースWebCenter Portalインストールを使用している場合、つまり、顧客がメタデータ、データ、セキュリティを作成した場合は、テストから本番のスクリプトはお薦めしません。

41.3 個々のポータルのバックアップ

1つ以上のポータル(またはポータル階層)のバックアップ・プロセスは簡単です。WLSTコマンドexportWebCenterPortalsを使用して、ポータルとそのコンテンツ・フォルダをアーカイブし、必要に応じて、ディスカッション・サーバーなどのバックエンド・コンポーネントのポータルに格納されているデータを追加でバックアップします。

手順は次のようになります。

1. ポータルをエクスポート・アーカイブ(PARファイル)にバックアップします。
第41.3.1項「WLSTを使用したポータルのバックアップ」を参照してください。

2. 必要に応じて、ポータルのディスカッション・データをバックアップします。
第41.3.2項「ポータルのディスカッション・データのバックアップ」を参照してください。

3. 他の外部データがある場合はバックアップします。
第41.3.3項「ポータルの他の外部データおよびコンテンツのバックアップ」を参照してください。

この項の情報では、ポータルのバックアップを手動で実行する方法について説明します。頻繁にバックアップする必要がある場合や、定期的なバックアップ・スケジュールを設定する場合は、バックアップ・プロセスを自動化するスクリプトを作成できます。詳細は、第41.8項「スクリプトを使用したWebCenter Portalのバックアップおよびリストア」を参照してください。

第41.4項「バックアップからのポータルのリストア」も参照してください。

注意:
多数のポータルの同時バックアップは、サーバー構成によってはシステム・パフォーマンスに影響を及ぼす可能性があるためお薦めしません。パフォーマンスの重大な低下が生じる場合は、バックアップまたはエクスポート・プロセスをより小さないくつかのグループに分けてください。

41.3.1 WLSTを使用したポータルのバックアップ

WLSTコマンドexportWebCenterPortalsを使用して、1つ以上のポータルをアーカイブ(PARファイル)にバックアップします。

ポータル・アーカイブ(PARファイル)内にバックアップされる情報と、アーカイブに含まれない情報を確認するには、第40.1.2.1項「ポータル・アーカイブの理解」を参照してください。

注意:
ポータル・アーカイブには、共有アセットやホーム・ポータルに関連する情報は含まれません。

データ損失を防ぐには、次のようにすることをお薦めします。

- バックアップ・プロセスでポータルをオフラインにしてデータの競合を防止する(offlineDuringExport=1)

- アーカイブにポータル・コンテンツ・フォルダを含める(exportPortalContent=1)

- アーカイブに接続情報を含める(exportConnections=1)

注意:
接続情報はポータルに固有ではありません。ソースWebCenter Portalインストール用に構成されたすべての接続がエクスポートされます。第40.1.2.1.3項「接続プロパティ・ファイルの理解」も参照してください。

- ポータルにWebサービスのデータ・コントロールやポートレットが含まれる場合、エクスポートが正常に行われるには、関連するすべてのWebサービスまたはプロデューサが稼働中でアクセス可能であることを確認します。

たとえば、WLSTコマンドを次のように実行します。

exportWebCenterPortals(appName='webcenter', fileName='BackupSalesPortals_31March2013.par', names='GlobalSales,MySales', offlineDuringExport=1, exportPortalContent=1, exportConnections=1)

設定するオプションは、特定のアーカイブ要件によって異なります。コマンドの構文については、『WebLogic Scripting Toolコマンド・リファレンス』のexportWebCenterPortalsに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

ポータルを後でリストアするには、第41.4項「バックアップからのポータルのリストア」を参照してください。

41.3.2 ポータルのディスカッション・データのバックアップ

ディスカッション・サーバー管理コンソールを使用して、後でリストアする特定のポータルのディスカッション・データを.zipファイルに必要に応じてバックアップします。詳細は、第40.8.1.1項「アーカイブへのポータル・ディスカッションのエクスポート」および第40.8.1.2項「アーカイブからのポータル・ディスカッションのインポート」を参照してください。

第41.4項「バックアップからのポータルのリストア」を参照してください。

41.3.3 ポータルの他の外部データおよびコンテンツのバックアップ

バックアップ・ファイルには、ポータルがコンテンツ・プレゼンタおよびSite Studioを使用して参照する外部格納データ(外部のWebコンテンツやページなど)は含まれないため、外部データを個別にバックアップする必要があります。同様に、ポータルがその独自のコンテンツ・フォルダの外部にあるドキュメントやファイルを参照する場合、ポータルで使用するすべての記憶域がバックアップされることを確認する必要があります。

どちらの場合も、外部データとコンテンツのバックアップ方法の手順については、該当する製品のドキュメントを参照してください。

41.4 バックアップからのポータルのリストア

WLSTコマンドimportWebCenterPortalsを使用して、1つ以上のポータルをバックアップ・アーカイブからリストアできます。既存のポータルは削除されて置き換えられます。

手順は次のようになります。

1. ポータルのバックアップ・アーカイブ(PARファイル)をターゲットにインポートして、ポータルをリストアします。
第41.4.1項「WLSTを使用したポータルのアーカイブからのリストア」を参照してください。

2. 必要に応じて、ポータルのディスカッション・データをリストアします。
第41.4.2項「ポータルのディスカッション・データのリストア」を参照してください。

3. 他の外部データおよびコンテンツがある場合はリストアします。
第41.4.3項「ポータルの他の外部データおよびコンテンツのリストア」を参照してください。

この項の情報では、ポータルのバックアップを手動でリストアする方法について説明します。必要な場合は、リストア・プロセスを自動化するスクリプトを作成できます。詳細は、第41.8項「スクリプトを使用したWebCenter Portalのバックアップおよびリストア」を参照してください。

第41.3項「個々のポータルのバックアップ」も参照してください。

41.4.1 WLSTを使用したポータルのアーカイブからのリストア

WLSTコマンドimportWebCenterPortalsを使用して、1つ以上のポータルをアーカイブ(PARファイル)からリストアします。

データ損失を防ぐには、次のようにすることをお薦めします。

- ポータルをリストアする前に、なんらかの理由でターゲットから失われる、ポータルで使用する接続をインポートします。
詳細は、第40.6.2項「ファイルからの新しいWebCenter Portal接続のインポート」を参照してください。

- ポータルをリストアする際にポータルをオフラインにします(forceOffline=1)。
ポータル・モデレータは、リストア後にポータルをオンラインに戻すことができます。

- アーカイブ内の情報をすべてインポートします(importCustomizations=1, importPortalContent=1, importSecurity=1, importData=1, importActivities=1)。

- ポータルにWebサービスのデータ・コントロールまたはポートレットが含まれる場合、インポートが正常に行われるには、関連するすべてのWebサービスおよびプロデューサも稼働中でアクセス可能である必要があります。

たとえば、WLSTコマンドを次のように実行します。

importWebCenterPortals(appName='webcenter',
fileName='BackupSalesPortals_31March2013.par', names='GlobalSales,MySales',
parentPortal='Sales', importCustomizations=1, importPortalContent=1,
importSecurity=1, importData=1, importActivities=1,
overwrite=1, savePortals=1, forceOffline=1,
importLog=/mybackups/RestoreSalesPortals_31march2013.log')

設定するオプションは、特定の要件によって異なります。コマンドの構文については、『WebLogic Scripting Toolコマンド・リファレンス』のimportWebCenterPortalsに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
一部のバックエンド・コンポーネント、特にディスカッション・サーバーに関連付けられたポータル関連のデータは、ポータルをエクスポートまたはインポートした後で移行する必要があります。次のトピックの第41.4.2項「ポータルのディスカッション・データのリストア」および第41.4.3項「ポータルの他の外部データおよびコンテンツのリストア」を参照してください。

41.4.2 ポータルのディスカッション・データのリストア

ディスカッション・サーバー管理コンソールを使用して、特定のポータルのディスカッション・データをバックアップの.zipファイルからリストアします。詳細は、第40.8.1.2項「アーカイブからのポータル・ディスカッションのインポート」および第40.8.1.1項「アーカイブへのポータル・ディスカッションのエクスポート」を参照してください。

第41.3項「個々のポータルのバックアップ」を参照してください。

41.4.3 ポータルの他の外部データおよびコンテンツのリストア

ポータルで使用する外部データまたはコンテンツをバックアップした場合、必要に応じてバックアップから情報をリストアする方法の手順については、該当の製品ドキュメントを参照してください。

たとえば、コンテンツ・プレゼンタおよびSite Studioを使用してポータルが参照する一部の外部格納データ(外部のWebコンテンツやページなど)、またはポータル独自のコンテンツ・フォルダの外部に格納されているドキュメントを定期的にバックアップする場合などです。

41.5 別のターゲットへのWebCenter Portal全体の移行

エクスポートおよびインポートを使用して、システム管理者は、WebCenter Portalインスタンスを別のターゲットに移行できます。これはステージングから本番への設定で役立ちます。これは、本番インスタンスがインストールおよび構成されており、ステージングのWebCenter Portalインスタンス全体(複数のポータル、共有アセット、グローバル・アーティファクト、セキュリティなどを含む)をターゲットに初めてコピーする必要がある場合です。

また、この項で説明するエクスポートおよびインポートのユーティリティを使用して、特定のポータルで所有されないWebCenter Portalのグローバル・アーティファクト(共有アセット、ビジネス・ロール・ページ、個人用ページおよびカスタマイズされたシステム・ページなど)をバックアップすることもできます。

この項には次のトピックが含まれます:

- 第41.5.1項「WebCenter Portalのインポートおよびエクスポートの理解」

- 第41.5.2項「WebCenter Portalのエクスポートおよびインポートの前提条件」

- 第41.5.3項「アーカイブへのWebCenter Portalのエクスポート」

- 第41.5.4項「WebCenter Portalアーカイブのインポート」

注意:
FrameworkFoldersコンポーネントを使用するように構成されているOracle WebCenter Content Serverインスタンス間でOracle WebCenter Portalコンテンツを移行するには、構成移行ユーティリティとともにアーカイバ・ツールを使用します。アーカイバではFolders_gコンテンツの移動をサポートしていますが、FrameworkFoldersの表の移行のみです。
アーカイバでFrameworkFoldersのフォルダ構造のみを移動するには、「データのエクスポート」(表)タブを使用して次の表をエクスポートまたはインポートします: FolderFoldersおよびFolderMetaDefault (FrameworkFoldersMetaDefaultsとも呼ばれます)。表の内容も移行するには、FolderFiles表もエクスポートまたはインポートします。

アーカイバの詳細は、Oracle WebCenter Contentの管理のシステムの移行とアーカイブに関する項を参照してください。

41.5.1 WebCenter Portalのインポートおよびエクスポートの理解

エクスポートおよびインポートを使用して、システム管理者は、WebCenter Portalインスタンス全体をステージング環境と本番環境との間で移行できます。図41-1に示すように、WLSTコマンドまたはFusion Middleware Controlを使用して、WebCenter Portalを1つのエクスポート・アーカイブ(.earファイル)にエクスポートできます。

表41-2に示すように、WebCenter Portalのエクスポート・アーカイブ(.earファイル)には複数のファイルが含まれます。

表41-2 WebCenter Portalのエクスポート・アーカイブEARファイル内のファイル

ファイル

説明

transport.mar

WebCenter Portalインスタンス全体のMDSメタデータとデータベース・スキーマ・データを取得するメタデータ・アーカイブ

policy-store.xml

セキュリティ・ポリシー情報。

lifecycle.xml

エクスポートするMDSパスなど、エクスポート・プロセスに関する詳細を記録するログ・ファイル。

このファイルの情報は、2つのエクスポート・アーカイブを比較する場合や、エクスポートおよびインポート・プロセスに関する問題を診断する場合に役立ちます。

oracle-archive.xml

バージョン情報と互換性情報を含むXMLファイル。

図41-1 別のターゲットへのWebCenter Portalの移行

WebCenter Portalアーカイブに含まれる情報

WebCenter Portalアーカイブには、メタデータ・サービス(MDS)リポジトリに格納される次の情報を含めることができます。

- ポータルおよびテンプレート: すべてのポータルおよびポータル・テンプレート

- アセット: すべての共有アセットおよびポータル・アセット

- ページ: システム・ページ、ビジネス・ロール・ページ、個人用ページおよびポータル・ページを含むすべてのページ

- グローバル・カスタマイズ: MDSに格納される、アプリケーション、システム・ページ、その他のページ、アセット、ポートレットおよびタスク・フローに適用されるすべてのグローバル・カスタマイズ。

- ユーザー・カスタマイズ: MDSに格納される、アプリケーション、ページおよびタスク・フローに適用されるすべてのユーザー定義カスタマイズ。パーソナライズと呼ばれる場合もあります。

- アプリケーションおよびサービスのメタデータ: MDSに格納される、アプリケーションとサービスのすべてのメタデータ(オブジェクト定義)

注意:
図41-1に示すように、一部のMDSカスタマイズはエクスポートではオプションになります。すべてのカスタマイズを移行する場合は、エクスポート・オプション「カスタマイズを含む」を設定する必要があります。

さらに、WebCenter Portalアーカイブ(.earファイル)には、次の内容を含めることができます。

- ツールおよびサービスのデータ: WebCenter Portalスキーマ(WEBCENTER)にデータを格納するツールおよびサービスに関連付けられたデータベースのデータ
データの移行はオプションです。データを移行するには、エクスポート・オプション「サービス・データを含む」を設定する必要があります。

- セキュリティ: すべてのロール、権限およびユーザー・ロール割当て:

- アプリケーション・ロール(および各ロールに割り当てられた権限)

- ホーム・ポータルのユーザー詳細およびそのアプリケーション・ロールの割当て

- 個々のポータル・メンバー(および各ポータルでのロール割当て)

WebCenter Portalアーカイブに含まれない情報

WebCenter Portalアーカイブ(.earファイル)には、MDSまたはWebCenter Portalデータベース・スキーマにデータを格納しないツールおよびサービス(分析、アクティビティ・グラフ、お知らせ、ディスカッション、(コンテンツ・サーバー上の)ドキュメント、インスタント・メッセージおよびプレゼンス(IMP)、メール、ページレット、カレンダ・イベント、パーソナライズおよびワークリストなど)に関連付けられたデータは含まれません。これらのツールとサービスに関連付けられたデータをバックアップまたは移動する方法については、第41.6項「WebCenter Portalインストール全体のバックアップ」を参照してください。

接続情報はWebCenter Portalアーカイブ内に含まれませんが、ソース環境で構成された接続情報を別のファイルにエクスポートして、その接続情報をターゲットにデプロイできます。サーバー名、ポート、コンテンツ管理接続などの接続情報が2つの環境で異なる場合、接続ファイルをデプロイする前に、接続の詳細を分けて変更できます。詳細は、第40.6項「ステージングから本番への接続の詳細の移動」を参照してください。

図41-2は、WebCenter Portalを別のターゲットに移行する際に、常に含まれる情報、絶対に含まれない情報またはオプションの情報について詳細を正確に示したものです。

図41-2 WebCenter Portalインスタンス全体とともにエクスポートおよびインポートされる情報

WebCenter Portalのエクスポートとインポートは、Fusion Middleware ControlまたはWLSTコマンドを使用して実行できます。詳細は、次を参照してください。

- 第41.5.2項「WebCenter Portalのエクスポートおよびインポートの前提条件」

- 第41.5.3項「アーカイブへのWebCenter Portalのエクスポート」

- 第41.5.4項「WebCenter Portalアーカイブのインポート」

41.5.2 WebCenter Portalのエクスポートおよびインポートの前提条件

WebCenter Portalインスタンスをエクスポートまたはインポートする前に、次の前提条件のタスクを完了しておきます。

1. WebCenter Portalをエクスポートまたはインポートする前に、すべてのバックエンド・コンポーネントをバックアップまたは移行します。
LDAPアイデンティティ・ストア、資格証明ストア、ポリシー・ストア、ディスカッション・サーバー、コンテンツ・サーバー、ポートレット・プロデューサなど、アプリケーションのバックエンド・コンポーネントを移行します。詳細は、第41.6項「WebCenter Portalインストール全体のバックアップ」を参照してください。

2. WebCenter Portalのメタデータおよびスキーマが格納されているデータベースが稼働中であることを確認します。稼働中でない場合、エクスポートとインポートは機能しません。

3. アプリケーションにWebサービスのデータ・コントロールやポートレットが含まれる場合、エクスポートとインポートが正常に行われるには、関連するすべてのWebサービスまたはプロデューサが稼働中でアクセス可能であることを確認します。

4. WebCenter Portalを別のターゲットに移行する場合、ターゲット・インスタンスで構成されるツールとサービスが、ソース・インスタンスで構成されたツールとサービスのスーパーセットであることを確認します。つまり、ターゲットは、ソースの構成で使用するツールとサービスの少なくとも同じセットで構成される必要があります。そうでない場合は、インポート操作が失敗します。

5. ソースからエクスポートされた接続をターゲットにインポートします。
詳細は、第40.6項「ステージングから本番への接続の詳細の移動」を参照してください。

6. ソース環境とターゲット環境の両方のユーザーが同じであることを確認します。

重要:
共有アイデンティティ・ストアを使用しない場合、ユーザーを移行する必要があります。

ページ・ユーザーがホーム・ポータルで作成する個人用ページは、ターゲットおよびソース・アプリケーションの両方が同じLDAPアイデンティティ・ストアを使用する場合にのみ移行されます。これは個人用ページ割当てがユーザーGUIDごとであるからです。

ソースでAdministratorロールを割り当てられたすべてのユーザーがターゲット・アイデンティティ・ストアに存在することを確認します。インポート時に、WebCenter Portalのセキュリティ・ポリシーにリストされているユーザーは、ドメインに対して構成されているアイデンティティ・ストアでチェックされます。ユーザーが見つからない場合、そのユーザーに関連付けられているポリシーは削除されます。第31.4項「外部LDAPサーバーへの管理者アカウントの移行」も参照してください。

7. WebCenter Portalアーカイブをインポートする前に、データベース・スキーマWEBCENTERおよびMDSをターゲットでバックアップします。
第41.6項「WebCenter Portalインストール全体のバックアップ」を参照してください。

8. インポートするWebCenter Portalのアーカイブ.earファイルが、WebCenter Portal 11.1.1.9.0からエクスポートされたものであることを確認します。
アーカイブを、以前のバージョンから直接WebCenter Portal 11.1.1.9.0にインポートすることはできません。必要な場合は、エクスポート・アーカイブを作成する前に、ソース環境を11.1.1.9.0にアップグレードする必要があります。詳細は、パッチ適用ガイドのOracle WebCenter Portalへのパッチ適用に関する項を参照してください。

41.5.3 アーカイブへのWebCenter Portalのエクスポート

この項では、Fusion Middleware ControlおよびWLSTコマンドを使用して、WebCenter Portalインスタンス全体をエクスポートする方法について説明します。WebCenter Portalは、ローカル・ファイル・システムまたはリモート・サーバーのファイル・システムに保存可能な単一のエクスポート・アーカイブ(.earファイル)にエクスポートされます。

注意:
アーカイブに含まれる内容については、第41.1項「WebCenter Portalのバックアップおよびリカバリの理解」を参照してください。

この項の内容は次のとおりです。

- 第41.5.3.1項「Fusion Middleware Controlを使用したWebCenter Portalのエクスポート」

- 第41.5.3.2項「WLSTを使用したWebCenter Portalのエクスポート」

41.5.3.1 Fusion Middleware Controlを使用したWebCenter Portalのエクスポート

システム管理者は、Fusion Middleware Controlを使用して、WebCenter Portalアプリケーション全体をエクスポートできます。

WebCenter Portalをエクスポートするには:

1. Fusion Middleware Controlで、WebCenter Portalのホームページに移動します。
第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「アプリケーションのエクスポート」を選択します(図41-3)。

図41-3 「WebCenter Portal」メニュー: 「アプリケーションのエクスポート」オプション

3. エクスポート・アーカイブの「ファイル名」を変更するか、デフォルトの名前をそのまま使用します。
一意性を保証するために、デフォルトの.earファイル名には、一意のIDのwebcenter_wholeapp_ts_unique_ID.earが含まれています(図41-4)。

図41-4 エクスポート・アーカイブの命名

4. 必要に応じて、エクスポートのオプションを設定します。詳細は、表41-3を参照してください。

表41-3 WebCenter Portal: 「アプリケーションのエクスポート」オプション

フィールド

説明

ツール/サービス・データを含む

これを選択すると、ツールおよびサービス(アクティビティ・ストリーム、ポータル・イベント、フィードバック、リスト、リンク、メッセージ・ボード、ピープル・コネクション、プロファイル、投票、アンケートおよびタグ)について、WebCenter Portalデータベース・スキーマ(WEBCENTER)に格納されるデータがエクスポートされます。MDSリポジトリに保存されたデータもエクスポートされることに注意してください。

ソースおよびターゲット・リスト定義が一致しない場合はリスト・データを常に再エクスポートします。リスト定義がターゲット上に存在し、その後ソースで変更される場合にのみ不一致が発生します。

エクスポートするアプリケーションに大量のデータが含まれる場合は、データベース・エクスポート・ユーティリティをかわりに使用してWebCenter Portalスキーマ・データをエクスポート(およびインポート)することを考慮してください。詳細は、第41.6.1.2項「WebCenter Portalスキーマ・データのバックアップ(エクスポート)」および第41.6.1.3項「WebCenter Portalデータのリストア(インポート)」を参照してください。

WebCenter Portalデータベース・スキーマ(WEBCENTER)に格納されるデータをエクスポートしない場合は、このオプションの選択を解除します。たとえば、テスト環境からステージング環境や本番環境にWebCenter Portalを移行する際にテスト・データが不要になる場合などです。

注意: エクスポート・プロセスでは、分析、アクティビティ・グラフ、お知らせ、ディスカッション、(コンテンツ・サーバー上の)ドキュメント、インスタント・メッセージおよびプレゼンス(IMP)、メール、ページレット、カレンダ・イベント、パーソナライズおよびワークリストといった、外部にデータを格納するサービスに関連付けられたデータをエクスポートしません。これらのサービスに関連するデータをバックアップまたは移動する方法の詳細は、その製品のドキュメントを参照してください。第41.6項「WebCenter Portalインストール全体のバックアップ」も参照してください。

カスタマイズを含む

これを選択すると、アプリケーションレベル(グローバル)のカスタマイズおよびユーザーレベルのカスタマイズがエクスポートされます。エクスポート時にオプションとなるカスタマイズについては、図41-2を参照してください。

このオプションの選択を解除すると、アプリケーションレベルまたはユーザーレベルのカスタマイズが含まれずにWebCenter Portalはエクスポートされます。

図41-2「WebCenter Portalインスタンス全体とともにエクスポートおよびインポートされる情報」も参照してください。

5. 「エクスポート」をクリックします。

6. 「ダウンロード」ダイアログで(図41-5)、「エクスポート」をクリックして続行するかどうかを確認します。

図41-5 エクスポート・アーカイブのダウンロード

エクスポート・プロセス中に進捗情報が表示されます。エクスポート処理中はエクスポートされているアプリケーションにアクセスできません。

7. エクスポート・プロセスが完了したら、エクスポート・アーカイブ(.ear)の保存場所を指定します。

図41-6 エクスポート・アーカイブの保存

次のいずれかを選択します。

- ダウンロード: エクスポートのEARファイルはローカル・ファイル・システムに保存されます。
ブラウザでダウンロードされ、アーカイブはローカルに保存されます。実際のダウンロード場所は、ブラウザの設定ごとに異なります。

- サーバーへエクスポート: エクスポートのEARファイルはサーバー位置に保存されます。
「アーカイブの場所」ダイアログが表示されたら(図41-7)、「サーバーの場所」に適切なパスを入力し(例: /tmp)、「保存」をクリックします。EARの名前はここでは必要ありません。

指定したサーバー・ディレクトリにwrite権限があることを確認します。

図41-7 アーカイブの場所

8. 「閉じる」をクリックして「エクスポート」ウィンドウを閉じます。

エクスポート・アーカイブ(.EAR)は、指定された場所に保存されます。

診断ログ・ファイルWC_Spaces-diagnostic.logを調べて、エクスポート・プロセス時にレポートされた警告またはエラーを確認してください。ログ・ファイルを表示するには、メニュー・オプション「WebCenter Portal」→「ログ」→「ログ・メッセージの表示」を選択します。詳細は、第28.2.1項「WebCenter Portalログの表示および構成」を参照してください。

第G.7項「WebCenter Portalのインポートおよびエクスポートのトラブルシューティング」も参照してください。

41.5.3.2 WLSTを使用したWebCenter Portalのエクスポート

WLSTコマンドexportWebCenterApplicationを使用して、WebCenter Portalインスタンス全体をエクスポートします。

次の例では、WebCenter Portalを、MDSのすべてのカスタマイズ(アプリケーションレベルとユーザーレベルの両方のカスタマイズ)およびデータベース・データと一緒にmyAppExport.earというファイルにエクスポートします。

wls:/weblogic/serverConfig>exportWebCenterApplication(appName='webcenter',
fileName='myAppExport.ear', exportCustomizations=1, exportData=1)

次の例では、テストWebCenter Portalインスタンスをエクスポートします。この場合、テスト時に作成されるデータ(リスト、イベント、リンク、タグなど)は、ターゲット・インスタンスでは必要ありません。.earファイルは、WLSTコマンドの実行元の場所に保存されます。

wls:/weblogic/serverConfig>exportWebCenterApplication(appName='webcenter',
fileName='myTestAppExport.ear', exportData=0)

コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のexportWebCenterApplicationに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

41.5.4 WebCenter Portalアーカイブのインポート

この項では、Fusion Middleware ControlおよびWLSTコマンドを使用して、WebCenter Portalアプリケーション全体をインポートする方法について説明します。

WebCenter Portalをインポートする前に、第41.5.2項「WebCenter Portalのエクスポートおよびインポートの前提条件」に示すすべてのタスクを完了していることを確認します。

この項の内容は次のとおりです。

- 第41.5.4.1項「Fusion Middleware Controlを使用したWebCenter Portalのインポート」

- 第41.5.4.2項「WLSTを使用したWebCenter Portalのインポート」

- 第41.5.4.3項「インポート後のWebCenter Portalの検証」

41.5.4.1 Fusion Middleware Controlを使用したWebCenter Portalのインポート

システム管理者は、Fusion Middleware Controlを使用して、WebCenter Portalインスタンス全体をインポートできます。

Fusion Middleware Controlを使用してWebCenter Portalをインポートするには:

1. Fusion Middleware Controlで、WebCenter Portalのホームページに移動します。
第6.2項「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「アプリケーションのインポート」を選択します。

3. WebCenter Portalアプリケーションのインポート・ページ(図41-8)で、WebCenter Portalアーカイブ(.ear)の場所を指定します。

図41-8 アプリケーションのインポート・ページ

次のうちから選択します。

- ローカル・ファイル・システムにあるアーカイブ:「アーカイブの場所」を入力します。あるいは、「参照」をクリックして、.earファイルが格納されているローカル・ファイル・システム上のディレクトリを見つけます。

- サーバー・ファイル・システムにあるアーカイブ: 「アーカイブの場所」を入力します。WebCenter Portalからアクセス可能な共有の場所になります。

選択するアーカイブには、WebCenter Portal全体のエクスポートが含まれる必要があります。ここで個々のポータルまたはポータル・テンプレートをインポートすることはできません。詳細は、第40.1.2.4項「アーカイブからの1つ以上のポータルのインポート」、 第40.1.2.4項「アーカイブからの1つ以上のポータルのインポート」を参照してください。

4. 「インポート」をクリックします。

5. WebCenter Portalアプリケーションのインポート・ダイアログで、「インポート」をクリックします。

図41-9 アプリケーションのインポート・ダイアログ

インポートが完了すると、成功メッセージが表示されます。

WebCenter Portalインスタンス全体をインポートした後、WebCenter Portalにログインして、インポートしたコンテンツを検証します。詳細は、第41.5.4.3項「インポート後のWebCenter Portalの検証」を参照してください。

41.5.4.2 WLSTを使用したWebCenter Portalのインポート

WLSTコマンドimportWebCenterApplicationを使用して、WebCenter Portalインスタンス全体をアーカイブからインポートします。コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のimportWebCenterApplicationに関する項を参照してください。

次の例では、エクスポート・アーカイブmyAppExport.earからWebCenter Portalをインポートします。

wls:/weblogic/serverConfig>importWebCenterApplication(appName='webcenter',fileName='myAppExport.ear')

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
WebCenter Portalインスタンスをインポートした後、WebCenter Portalにログインして、インポートしたコンテンツを検証します。詳細は、第41.5.4.3項「インポート後のWebCenter Portalの検証」を参照してください。

41.5.4.3 インポート後のWebCenter Portalの検証

アーカイブからWebCenter Portalをインポートした後、次の操作を行う必要があります。

1. 新たにインポートしたWebCenter Portalインスタンスをデプロイする管理対象サーバー(WC_Spaces)を再起動します。
クラスタ環境で、クラスタの各管理対象サーバーを再起動します。第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」も参照してください。

2. WebCenter Portalにログインして、すべてのポータルとポータル・テンプレートが予想どおりに使用できることを検証します。
使用できない場合は、第G.7.3項「ポータルおよびポータル・テンプレートがインポート後に使用できない」を参照してください。

3. Oracle Secure Enterprise Searchクローラを開始し、新たにインポートされたデータを索引付けします。
Oracle Secure Enterprise Search管理者ガイドも参照してください。

41.6 WebCenter Portalインストール全体のバックアップ

データベース・ハードウェアの障害や、ファイルまたはデータベースから誤ってデータを削除したことが原因で生じるデータ損失を防ぐには、WebCenter Portalインストール全体を頻繁にバックアップすることが重要です。

この項では、ポータル・サーバーのすべてのポータル、すべてのデータベース・データ、MDS、および他のバックエンド・サーバーに格納されているデータを完全にバックアップする場合に必要な手順についてまとめています。バックアップ・プロセスでは、すべての内容が含まれる1つの大規模なアーカイブではなく複数のバックアップ・アーカイブが生成されるため、きめ細かなリストア・プロセスが容易になります。

手順は次のようになります。

1. WebCenter Portalスキーマのすべてのデータをバックアップします。
「WebCenter Portalスキーマ・データのバックアップ(エクスポート)」を参照してください。

2. MDSスキーマのすべてのデータをバックアップします。
「すべてのMDSスキーマ・データのバックアップ(エクスポート)」を参照してください。

3. Content Serverのすべてのデータをバックアップします。
「すべてのWebCenter Contentデータのバックアップおよびリストア」を参照してください。

4. ディスカッション・サーバーのすべてのデータをバックアップします。
「すべてのディスカッション・スキーマ・データのバックアップ(エクスポート)」を参照してください。

5. WebCenter Portalに格納されている他のスキーマ・データをバックアップします。
「他のスキーマ・データ(ACTIVITIESとPORTLET)のバックアップおよびリストア」を参照してください。

6. WebCenter Portalで使用されるポートレット・プロデューサのデータをバックアップします。
「ポートレット・プロデューサのメタデータのバックアップおよびリストア」を参照してください。

7. ページレット・プロデューサのメタデータをバックアップします。
「ページレット・プロデューサのメタデータのバックアップおよびリストア」を参照してください。

8. アクティビティ・グラフと分析のメタデータをバックアップします。
「アクティビティ・グラフと分析のメタデータのバックアップおよびリストア」を参照してください。

9. パーソナライズ・データをバックアップします。
「パーソナライズのメタデータのバックアップおよびリストア」を参照してください。

10. セキュリティ・ストアをバックアップします。
「LDAPアイデンティティ・ストアのバックアップおよびリストア」、「ポリシー・ストアのバックアップおよびリストア(LDAPとデータベース)」および「資格証明ストアのバックアップおよびリストア(LDAPとデータベース)」を参照してください。

11. WebCenter PortalをホストするWebLogicドメインをバックアップします。
「WebCenter Portalドメインのバックアップおよびリストア」を参照してください。

12. 監査構成をバックアップします。
「監査リポジトリ構成のバックアップおよびリストア」を参照してください。

この項の情報では、手動でバックアップする方法について説明します。頻繁にバックアップする必要がある場合や、定期的なバックアップ・スケジュールを設定する場合は、バックアップ・プロセスを自動化するスクリプトを作成できます。詳細は、第41.8項「スクリプトを使用したWebCenter Portalのバックアップおよびリストア」を参照してください。

41.6.1 WebCenter Portalのすべてのスキーマ・データのバックアップおよびリストア

WebCenter Portalのデータベース・スキーマ(WEBCENTER)では、アクティビティ・ストリーム、ポータル・イベント、フィードバック、リスト、リンク、メッセージ・ボード、ピープル・コネクション、プロファイル、投票、アンケートおよびタグなど、各種ツールおよびサービスのデータを格納します。

この項には次のトピックが含まれます:

- 前提条件

- WebCenter Portalスキーマ・データのバックアップ(エクスポート)

- WebCenter Portalデータのリストア(インポート)

41.6.1.1 前提条件

Oracleデータベース・スキーマをバックアップまたはリストアする場合、スキーマ・データをバックアップまたはリストアする前に、setenvやexportを使用して、次の環境変数を設定します。

- ORACLE_HOME: データベース・ホーム

- ORACLE_SID: スキーマのサービスID

- TNS_ADMIN: ORACLE_HOME/network/adminに設定

41.6.1.2 WebCenter Portalスキーマ・データのバックアップ(エクスポート)

スキーマ・データWEBCENTERをバックアップするには、データベースに適したユーティリティを使用します。

- Oracleデータベースの場合、データベースのDB_ORACLE_HOME/binに移動して、例41-1「WEBCENTERスキーマ・データのエクスポート」で説明されるコマンドを実行します。
expdpコマンドの詳細は、『Oracle Databaseユーティリティ』を参照してください。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

例41-1 WEBCENTERスキーマ・データのエクスポート

sqlplus "sys/password as sysdba"
create or replace directory mydmpdirectory as
'full_path_to_directory_on_file_system';
GRANT read,write ON directory mydmpdirectory TO public;
exit;

DB_ORACLE_HOME/bin/expdp \"sys/password@serviceid as sysdba\"
directory=mydmpdirectory dumpfile=webcenterportal.dmp SCHEMAS=srcprefix_WEBCENTER
EXCLUDE=STATISTICS NOLOGFILE=Y

ここで:

- DB_ORACLE_HOMEは、WebCenter Portalのスキーマ(WEBCENTER)のデータベースがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベースの一意のSIDです。たとえば、mydb1234のように指定します。

- directoryは、ダンプ・ファイルが作成されるデータベース・マシン上の場所です。

- dumpfileは、エクスポートされたデータを含むファイルの名前です。

- SCHEMASは、インポートするターゲット・スキーマを識別します。スキーマの名前は、インストール時に使用されたRCU接尾辞(_WEBCENTER)に、ユーザーが指定した接頭辞を加えたものになります。例: DEV_WEBCENTER。

- EXCLUDE=STATISTICSは、表の統計をエクスポートしないことを指定します。

- NOLOGFILE=Yは、ログ・ファイルの作成を抑制します。

第41.6.1.3項「WebCenter Portalデータのリストア(インポート)」も参照してください。

41.6.1.3 WebCenter Portalデータのリストア(インポート)

バックアップからスキーマ・データWEBCENTERをリストアするには、データベースに適したユーティリティを使用します。

- Oracleデータベースの場合、データベースのDB_ORACLE_HOME/binに移動して、例41-2または例41-3で説明されるコマンドを実行します。
impdpコマンドの詳細は、『Oracle Databaseユーティリティ』を参照してください。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

OracleデータベースでWEBCENTERスキーマをリストアするには:

1. ターゲットのWebCenter Portalインスタンスをシャットダウンします。

2. WEBCENTERスキーマがインストールされるデータベースのDB_ORACLE_HOME/binに移動し、sysdbaとしてsqlplusを使用してそのデータベースに接続し、次のコマンドを実行します。

DB_ORACLE_HOME/bin/sqlplus "sys/password@serviceid as sysdba"
create or replace directory dmpdir as 'mydmpdirectory';
GRANT read,write ON directory dmpdir TO public;

3. 次のいずれかを実行します。

- ソースとターゲットのスキーマ名が一致する場合:

drop user tgtprefix_WEBCENTER cascade;
exit;

- ソースとターゲットのスキーマ名が異なる場合:

drop user tgtprefix_WEBCENTER cascade;
create user tgtprefix_WEBCENTER identified by password default tablespace
tgtprefix_IAS_WEBCENTER temporary tablespace name_IAS_TEMP;
grant connect,resource to tgtprefix_WEBCENTER;
exit;

ここで:

- tgtprefix_WEBCENTERはユーザー名です。これは、インストール時に使用されたRCU接尾辞_WEBCENTERに、ユーザーが指定した接頭辞を加えたものです。例: DEV_WEBCENTER。

- passwordは、ターゲット・ユーザーのパスワードです。

- tgtprefix_IAS_WEBCENTERは、デフォルトの表領域を識別します。たとえば、インストール時に使用されたRCU接尾辞IAS_WEBCENTERに、ユーザーが指定した接頭辞を加えたものになります。例: DEV_IAS_WEBCENTER。

- name_IAS_TEMPは一時表領域を識別します。例: DEV_IAS_TEMP。

4. 例41-2または例41-3に示すように、インポート・ツールを実行します。

例41-2 WebCenter Portalスキーマ・データのインポート(ソースとターゲットのスキーマ名が一致する場合)

DB_ORACLE_HOME/bin/impdp \"sys/password@serviceid as sysdba\"
directory=mydmpdirectory dumpfile=webcenterportal.dmp SCHEMAS=tgtprefix_WEBCENTER

例41-3 WebCenter Portalスキーマ・データのインポート(ソースとターゲットのスキーマ名が異なる場合)

DB_ORACLE_HOME/bin/impdp \"sys/password@serviceid as sysdba\"
directory=mydmpdirectory dumpfile=webcenterportal.dmp
remap_schema=srcprefix_WEBCENTER:tgtprefix_WEBCENTER
remap_tablespace=source_tablespace:target_tablespace exclude=user
TABLE_EXISTS_ACTION=REPLACE

ここで:

- DB_ORACLE_HOMEは、WebCenter Portalのスキーマ(WEBCENTER)のデータベースがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベースの一意のSIDです。たとえば、mydb1234のように指定します。

- directoryは、ダンプ・ファイルを配置するデータベース・マシン上の場所です。

- dumpfileは、インポートするデータを含むファイルの名前です。

- SCHEMASは、インポートするターゲット・スキーマを識別します。スキーマの名前は、インストール時に使用されたRCU接尾辞(_WEBCENTER)に、ユーザーが指定した接頭辞を加えたものになります。例: DEV_WEBCENTER。
このパラメータは、ソースとターゲットのスキーマ名が一致するときに使用します。たとえば、両方のスキーマの名前はDEV_WEBCENTERになります。

- REMAP_SCHEMAは、ソースおよびターゲット・スキーマを識別します。このパラメータは、ソースとターゲットのスキーマ名が異なる場合に使用します。スキーマの名前は、インストール時に使用されたRCU接尾辞(_WEBCENTER)に、ユーザーが指定した接頭辞を加えたものになります。例: DEV_WEBCENTER。

- REMAP_TABLESPACEは、ソースおよびターゲット表領域を識別します。ソース表領域内の永続データのインポートで選択されたすべてのオブジェクトが、ターゲット表領域で作成されるように再マップします。例: source_tablespace:target_tablespace。

- TABLE_EXISTS_ACTION=REPLACEは、現在の表を削除して、ダンプ・ファイルに含まれているとおりに表を作成します。

41.6.2 すべてのMDSスキーマ・データのバックアップおよびリストア

MDSスキーマには、WebCenter Portalのカスタマイズのメタデータとデータが含まれます。

この項には次のトピックが含まれます:

- 前提条件

- すべてのMDSスキーマ・データのバックアップ(エクスポート)

- MDSスキーマ・データのリストア(インポート)

41.6.2.1 前提条件

Oracleデータベース・スキーマをバックアップまたはリストアする場合、スキーマ・データをバックアップまたはリストアする前に、setenvやexportを使用して、次の環境変数を設定します。

- ORACLE_HOME: データベース・ホーム

- ORACLE_SID: スキーマのサービスID

- TNS_ADMIN: ORACLE_HOME/network/adminに設定

注意:
これらのバックアップ(エクスポート)およびリストア(インポート)手順が機能するには、ソースとターゲットのスキーマ名が一致している必要があります。たとえば、両方のスキーマの名前をDEV_MDSとします。

41.6.2.2 すべてのMDSスキーマ・データのバックアップ(エクスポート)

MDSデータをバックアップするには、データベースに適したユーティリティを使用します。

- Oracleデータベースの場合、データベースのDB_ORACLE_HOME/binに移動して、例41-4「MDSスキーマ・データのエクスポート」で説明されるコマンドを実行します。
expdpコマンドの詳細は、『Oracle Databaseユーティリティ』を参照してください。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

例41-4 MDSスキーマ・データのエクスポート

sqlplus "sys/password as sysdba"
create or replace directory mydmpdirectory as
'full_path_to_directory_on_file_system';
GRANT read,write ON directory mydmpdirectory TO public;
exit;

DB_ORACLE_HOME/bin/expdp \"sys/password@serviceid as sysdba\"
directory=mydmpdirectory dumpfile=mds.dmp SCHEMAS=srcprefix_MDS
EXCLUDE=STATISTICS NOLOGFILE=Y

ここで:

- DB_ORACLE_HOMEは、WebCenter PortalのMDSスキーマのデータベースがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベースの一意のSIDです。たとえば、mydb1234のように指定します。

- directoryは、ダンプ・ファイルが作成されるデータベース・マシン上の場所です。

- dumpfileは、エクスポートされたデータを含むファイルの名前です。

- SCHEMASは、エクスポートされるスキーマです。インストール時に使用されたRCU接尾辞(_MDS)に、ユーザーが指定した接頭辞を加えたものになります。例: DEV_MDS。
ソースとターゲットのスキーマ名は一致している必要があります。たとえば、両方のスキーマの名前をDEV_MDSとします。

- EXCLUDE=STATISTICSは、表の統計をエクスポートしないことを指定します。

- NOLOGFILE=Yは、ログ・ファイルの作成を抑制します。

第41.6.2.3項「MDSスキーマ・データのリストア(インポート)」も参照してください。

41.6.2.3 MDSスキーマ・データのリストア(インポート)

バックアップからMDSスキーマ・データをリストアするには、データベースに適したユーティリティを使用します。

- Oracleデータベースの場合、データベースのDB_ORACLE_HOME/binに移動して、例41-5「MDSスキーマ・データのインポート」で説明されるコマンドを実行します。
impdpコマンドの詳細は、『Oracle Databaseユーティリティ』を参照してください。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

OracleデータベースでMDSスキーマをリストアするには:

1. ターゲットのMDSインスタンスをシャットダウンします。

2. MDSスキーマがインストールされるデータベースのDB_ORACLE_HOME/binに移動し、sysdbaとしてsqlplusを使用してそのデータベースに接続し、次のコマンドを実行します。

DB_ORACLE_HOME/bin/sqlplus "sys/password@serviceid as sysdba"
create or replace directory dmpdir as 'mydmpdirectory';
GRANT read,write ON directory dmpdir TO public;

3. MDSスキーマを削除してsqlplusを終了します。

drop user tgtprefix_MDS cascade;
exit;

4. 例41-5「MDSスキーマ・データのインポート」の説明に従い、インポート・ツールを実行します。

例41-5 MDSスキーマ・データのインポート

DB_ORACLE_HOME/bin/impdp \"sys/password@serviceid as sysdba\"
directory=mydmpdirectory dumpfile=mds.dmp SCHEMA=tgtprefix_MDS

ここで:

- DB_ORACLE_HOMEは、WebCenter PortalのMDSスキーマのデータベースがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベースの一意のSIDです。たとえば、mydb1234のように指定します。

- directoryは、ダンプ・ファイルを配置するデータベース・マシン上の場所です。

- dumpfileは、インポートするデータを含むファイルの名前です。

- SCHEMASは、インポートするスキーマです。インストール時に使用されたRCU接尾辞(_MDS)に、ユーザーが指定した接頭辞を加えたものになります。例: DEV_MDS。
ソースとターゲットのスキーマ名は一致している必要があります。たとえば、両方のスキーマの名前をDEV_MDSとします。

41.6.3 すべてのWebCenter Contentデータのバックアップおよびリストア

Oracle WebCenter Contentを完全にバックアップするには、WebCenter Contentのデータベース・スキーマ(OCS)のデータをバックアップして、WebCenter Contentのすべてのネイティブ(vault)ファイルおよびWeb表示可能(weblayout)ファイルをバックアップし、さらに他の構成データもバックアップする必要があります。詳細は、管理者ガイドのOracle WebCenter Contentのバックアップおよびリカバリの推奨事項に関する項を参照してください。

オプションで、WebCenter Portalインスタンス(または特定のPortal Frameworkアプリケーション)のルート・フォルダを個別のアーカイブにバックアップできます。ルート・フォルダのバックアップは、フォルダが破損した場合や、フォルダ全体を別のターゲットに移行する場合に役立ちます。手順の詳細は、Oracle WebCenter Contentの管理のシステムの移行とアーカイブに関する項を参照してください。

注意:
WebCenter Portalのルート・フォルダをリストアまたは移行する場合は、次の事項を考慮してください。

- セキュリティ・データはルート・フォルダとともにアーカイブされない

- ルート・フォルダの移行は、WebCenter Portalを初めて起動する前に行われる必要がある
(WebCenter Portalのみ)。WebCenter Portalを初めて起動するときに、ルート・フォルダがContent ServerのWebCenter Portalに自動で作成されます。このフォルダは、別のWebCenter Portalインスタンスからエクスポートされたルート・フォルダのアーカイブで後から上書きすることはできません。内部ルート・フォルダIDが一致しないためです。ルート・フォルダのコンテンツの移行を予定する場合、WebCenter Portalインスタンスを初めて起動する前に移行する必要があります。

- ソースとターゲットのフォルダIDの「カウンタ」が一致する必要がある
Content Serverにフォルダを作成するたびに、フォルダIDカウンタが1だけ増分されます。ソースおよびターゲットのカウンタが同期していない場合は、インポート操作後にターゲットにフォルダを作成しようとした際に問題が発生することがあります。たとえば、IDが5、6、7、8であるフォルダをインポートする際に、ターゲットのフォルダIDカウンタが4である場合は、IDが5であるフォルダを作成しようとするため、次回ターゲットにフォルダを作成しようとした際にエラーが発生します。唯一の回避策は、SQLを使用してターゲットのカウンタ・テーブルを手動で変更することです。

ルート・フォルダのバックアップが、すべてのリストア使用例に適しているとはかぎらないため、プライマリのバックアップ/リストア戦略に対応するように、WebCenter Contentのすべてのデータベース・スキーマをバックアップすることをお薦めします。

WebCenter Contentのデータをリストアした後、WebCenter Portalにログインして、ドキュメント関連のタスク・フローを使用するポータルを開きます。ドキュメント・サービスがそのポータルで有効になっていて、インポートされたフォルダが予期したとおりに使用可能であることを確認します。

41.6.4 ディスカッション・スキーマ・データのバックアップおよびリストア

ディスカッションおよびお知らせでは、次の2つのデータベース・スキーマに情報を格納します。

- DISCUSSIONS: ディスカッションおよびお知らせのデータを格納します。

- DISCUSSIONS_CRAWLER: ディスカッション・サーバーをクロールするOracle Secure Enterprise Search (SES)を有効にします。

この項には次のトピックが含まれます:

- 前提条件

- すべてのディスカッション・スキーマ・データのバックアップ(エクスポート)

- ディスカッション・スキーマ・データのリストア(インポート)

41.6.4.1 前提条件

Oracleデータベース・スキーマをバックアップまたはリストアする場合、スキーマ・データをバックアップまたはリストアする前に、setenvやexportを使用して、次の環境変数を設定します。

- ORACLE_HOME: データベース・ホーム

- ORACLE_SID: データベースのサービスID

- TNS_ADMIN: ORACLE_HOME/network/adminに設定

41.6.4.2 すべてのディスカッション・スキーマ・データのバックアップ(エクスポート)

すべてのディスカッション・スキーマ・データをバックアップするには、データベースに適したユーティリティを使用します。

- Oracleデータベースの場合、データベースのDB_ORACLE_HOME/binに移動して、例41-6「ディスカッション・スキーマ・データのエクスポート」で説明されるコマンドを実行します。
expdpコマンドの詳細は、『Oracle Databaseユーティリティ』を参照してください。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

注意:

- この項では、ディスカッション・サーバー・データ全体をエクスポートする方法について説明します。単一のポータルのディスカッションをエクスポートする場合は、第41.3.2項「ポータルのディスカッション・データのバックアップ」を参照してください。

例41-6 ディスカッション・スキーマ・データのエクスポート

sqlplus "sys/password as sysdba"
create or replace directory mydmpdirectory as 'full_path_to_directory_on_file_system';
GRANT read,write ON directory mydmpdirectory TO public;
exit;

DB_ORACLE_HOME/bin/expdp \"sys/password@serviceid as sysdba\" directory=mydmpdirectory dumpfile=discussions.dmp SCHEMAS=srcprefix_DISCUSSIONS,srcprefix_DISCUSSIONS_CRAWLER EXCLUDE=STATISTICS NOLOGFILE=Y

ここで:

- DB_ORACLE_HOMEは、WebCenter Portalのディスカッション・スキーマのデータベースがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベースの一意のSIDです。たとえば、mydb1234のように指定します。

- directoryは、ダンプ・ファイルが作成されるデータベース・マシン上の場所です。

- dumpfileは、エクスポートされたデータを含むファイルの名前です。

- SCHEMASは、エクスポートするスキーマを識別します。インストール時に使用されたRCU接尾辞(_DISCUSSIONSおよび_DISCUSSIONS_CRAWLER)に、ユーザーが指定した接頭辞を加えたものになります。例: DEV_DISCUSSIONS。
両方のスキーマからデータをエクスポートするには、各スキーマ名をカンマで区切ります。

- EXCLUDE=STATISTICSは、表の統計をエクスポートしないことを指定します。

- NOLOGFILE=Yは、ログ・ファイルの作成を抑制します。

第41.6.4.3項「ディスカッション・スキーマ・データのリストア(インポート)」も参照してください。

41.6.4.3 ディスカッション・スキーマ・データのリストア(インポート)

バックアップからディスカッション・スキーマ・データをリストアするには、データベースに適したユーティリティを使用します。

- Oracleデータベースの場合、データベースのDB_ORACLE_HOME/binに移動して、例41-7または例41-8で説明されるコマンドを実行します。
impdpコマンドの詳細は、『Oracle Databaseユーティリティ』を参照してください。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

OracleデータベースでスキーマDISCUSSIONSおよびDISCUSSIONS_CRAWLERをリストアするには:

1. ターゲットのディスカッション・サーバーをシャットダウンします。

2. スキーマDISCUSSIONSおよびDISCUSSIONS_CRAWLERがインストールされるデータベースのDB_ORACLE_HOME/binに移動し、sysdbaとしてsqlplusを使用してそのデータベースに接続し、次のコマンドを実行します。

DB_ORACLE_HOME/bin/sqlplus "sys/password@serviceid as sysdba"
create or replace directory dmpdir as 'mydmpdirectory';
GRANT read,write ON directory dmpdir TO public;

3. 次のいずれかを実行します。

- ソースとターゲットのスキーマ名が一致する場合:

drop user tgtprefix_DISCUSSIONS cascade;
drop user tgtprefix_DISCUSSIONS_CRAWLER cascade;
exit;

- ソースとターゲットのスキーマ名が異なる場合:

drop user tgtprefix_DISCUSSIONS cascade;
drop user tgtprefix_DISCUSSIONS_CRAWLER cascade;
create user tgtprefix_DISCUSSIONS identified by password default tablespace
tgtprefix_IAS_DISCUSSIONS temporary tablespace name_IAS_TEMP;
grant connect,resource to tgtprefix_DISCUSSIONS
exit;

ここで:

- tgtprefix_DISCUSSIONSはユーザー名です。これは、インストール時に使用されたRCU接尾辞_DISCUSSIONSに、ユーザーが指定した接頭辞を加えたものです。例: DEV_DISCUSSIONS。

- passwordは、ターゲット・ユーザーのパスワードです。

- tgtprefix_IAS_DISCUSSIONSは、デフォルトの表領域を識別します。たとえば、インストール時に使用されたRCU接尾辞IAS_DISCUSSIONSに、ユーザーが指定した接頭辞を加えたものになります。例: DEV_IAS_DISCUSSIONS。

- name_IAS_TEMPは一時表領域を識別します。例: DEV_IAS_TEMP。

4. 例41-7または例41-8の説明に従い、インポート・ツールを実行します。

例41-7 ディスカッション・スキーマ・データのインポート(ソースとターゲットのスキーマ名が一致する場合)

DB_ORACLE_HOME/bin/impdp \"sys/password@serviceid as sysdba\"
directory=mydmpdirectory dumpfile=discussions.dmp
SCHEMAS=tgtprefix_DISCUSSIONS,tgtprefix_DISCUSSIONS_CRAWLER

例41-8 ディスカッション・スキーマ・データのインポート(ソースとターゲットのスキーマ名が異なる場合)

DB_ORACLE_HOME/bin/impdp \"sys/password@serviceid as sysdba\"
directory=mydmpdirectory dumpfile=discussions.dmp
remap_schema=srcprefix_DISCUSSIONS:tgtprefix_DISCUSSIONS
remap_schema=srcprefix_DISCUSSIONS_CRAWLER:tgtprefix_DISCUSSIONS_CRAWLER
remap_tablespace=source_tablespace:target_tablespace exclude=user
TABLE_EXISTS_ACTION=REPLACE

ここで:

- DB_ORACLE_HOMEは、WebCenter Portalのディスカッション・スキーマのデータベースがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベースの一意のSIDです。たとえば、mydb1234のように指定します。

- directoryは、ダンプ・ファイルを配置するデータベース・マシン上の場所です。

- dumpfileは、インポートするデータを含むファイルの名前です。

- SCHEMASは、インポートするスキーマを識別します。インストール時に使用されたRCU接尾辞(_DISCUSSIONSおよび_DISCUSSIONS_CRAWLER)に、ユーザーが指定した接頭辞を加えたものになります。スキーマDISCUSSIONSとDISCUSSIONS_CRAWLERのユーザー指定の接頭辞は同じです。例: DEV_DISCUSSIONSおよびDEV_DISCUSSIONS_CRAWLER。
このパラメータは、ソースとターゲットのスキーマ名が一致するときに使用します。たとえば、ソース・データベースとターゲット・データベースのスキーマの名前は、どちらもDEV_DISCUSSIONSおよびDEV_DISCUSSIONS_CRAWLERになります。

- REMAP_SCHEMAは、ソースおよびターゲット・スキーマを識別します。このパラメータは、ソースとターゲットのスキーマ名が異なる場合に使用します。スキーマの名前は、インストール時に使用されたRCU接尾辞(_DISCUSSIONS)に、ユーザーが指定した接頭辞を加えたものになります。例: DEV_DISCUSSIONS。
スキーマDISCUSSIONSおよびDISCUSSIONS_CRAWLERのユーザー指定の接頭辞は同じになります。

- REMAP_TABLESPACEは、ソースおよびターゲット表領域を識別します。ソース表領域内の永続データのインポートで選択されたすべてのオブジェクトが、ターゲット表領域で作成されるように再マップします。例: source_tablespace:target_tablespace。

- TABLE_EXISTS_ACTION=REPLACEは、現在の表を削除して、ダンプ・ファイルに含まれているとおりに表を作成します。

41.6.5 他のスキーマ・データ(ACTIVITIESとPORTLET)のバックアップおよびリストア

前のトピックで説明したスキーマ(WEBCENTER、MDS、DISCUSSIONSおよびDISCUSSIONS_CRAWLER)以外に、WebCenter Portalでは、他のいくつかのスキーマにデータを格納できます。

- ACTIVITIESは、アクティビティ・グラフおよび分析のデータを格納します。

- PORTLETは、ポートレットおよびページレットのデータを格納します。

バックアップとリストアの手順はすべてのスキーマに共通です。データベースに適したユーティリティを使用してください。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

- Oracleデータベースの場合、データベースのDB_ORACLE_HOME/binに移動して、次の例で説明されるコマンドを実行します。

- 例41-9「スキーマ・データのエクスポート(Oracleデータベース)」

- 例41-10「スキーマ・データのインポート(ソースとターゲットのスキーマ名が一致する場合)」

- 例41-11「スキーマ・データのインポート(ソースとターゲットのスキーマ名が異なる場合)」

expdpコマンドとimpdpコマンドの詳細は、『Oracle Databaseユーティリティ』を参照してください。

前提条件(Oracleデータベース)

Oracleデータベース・スキーマをバックアップまたはリストアする場合、スキーマ・データをバックアップまたはリストアする前に、setenvやexportを使用して、次の環境変数を設定します。

- ORACLE_HOME: データベース・ホーム

- ORACLE_SID: スキーマのサービスID

- TNS_ADMIN: ORACLE_HOME/network/adminに設定

スキーマ・データのエクスポート(Oracleデータベース)

例41-9に、Oracleデータベースのスキーマ・データをエクスポートするexpdpコマンドのサンプルを示します。エクスポートするスキーマに合うように、schemadump.dmpおよびSCHEMA_NAMEを置き換えます。

例41-9 スキーマ・データのエクスポート(Oracleデータベース)

sqlplus "sys/password as sysdba"
create or replace directory mydmpdirectory as
'full_path_to_directory_on_file_system';
GRANT read,write ON directory mydmpdirectory TO public;
exit;

DB_ORACLE_HOME/bin/expdp \"sys/password@serviceid as sysdba\"
directory=mydmpdirectory dumpfile=schemadump.dmp SCHEMAS=srcprefix_SCHEMA_NAME
EXCLUDE=STATISTICS NOLOGFILE=Y

ここで:

- DB_ORACLE_HOMEは、データベース・スキーマがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベースの一意のSIDです。たとえば、mydb1234のように指定します。

- directoryは、ダンプ・ファイルが作成されるデータベース・マシン上の場所です。

- dumpfileは、エクスポートされたデータを含むファイルの名前です。

- SCHEMASは、エクスポートするスキーマです。これは、インストール時に使用されたRCU接尾辞(_SCHEMA_NAME)に、ユーザーが指定した接頭辞を加えたものです。例: DEV_ACTIVITIES。
複数のスキーマからデータをエクスポートするには、各スキーマ名をカンマで区切ります。

- EXCLUDE=STATISTICSは、表の統計をエクスポートしないことを指定します。

- NOLOGFILE=Yは、ログ・ファイルの作成を抑制します。

スキーマ・データのインポート(Oracleデータベース)

例41-10および例41-11に、スキーマ・データをインポートするimpdpコマンドのサンプルを示します。インポートするスキーマに合うように、schemadump.dmpおよびSCHEMA_NAMEを置き換えます。

1. ターゲットのWebCenter Portalインスタンスをシャットダウンします。

2. スキーマがインストールされるデータベースのDB_ORACLE_HOME/binに移動し、sysdbaとしてsqlplusを使用してそのデータベースに接続し、次のコマンドを実行します。

DB_ORACLE_HOME/bin/sqlplus "sys/password@serviceid as sysdba"
create or replace directory dmpdir as 'mydmpdirectory';
GRANT read,write ON directory dmpdir TO public;

3. 次のいずれかを実行します。

- ソースとターゲットのスキーマ名が一致する場合:

drop user tgtprefix_SCHEMA_NAME cascade;
exit;

- ソースとターゲットのスキーマ名が異なる場合:

drop user tgtprefix_SCHEMA_NAME cascade;
create user tgtprefix_SCHEMA_NAME identified by password default tablespace
tgtprefix_IAS_SCHEMA_NAME temporary tablespace name_IAS_TEMP;
grant connect,resource to tgtprefix_SCHEMA_NAME;
exit;

ここで:

- tgtprefix_SCHEMA_NAMEはユーザー名です。これは、インストール時に使用されたRCU接尾辞_SCHEMA_NAMEに、ユーザーが指定した接頭辞を加えたものです。例: DEV_ACTIVITIES。

- passwordは、ターゲット・ユーザーのパスワードです。

- tgtprefix_IAS_SCHEMA_NAMEは、デフォルトの表領域を識別します。たとえば、インストール時に使用されたRCU接尾辞IAS_SCHEMA_NAMEに、ユーザーが指定した接頭辞を加えたものになります。例: DEV_IAS_ACTIVITIES。

- name_IAS_TEMPは一時表領域を識別します。例: DEV_IAS_TEMP。

4. 例41-10または例41-11の説明に従い、インポート・ツールを実行します。

例41-10 スキーマ・データのインポート(ソースとターゲットのスキーマ名が一致する場合)

DB_ORACLE_HOME/bin/impdp \"sys/password@serviceid as sysdba\"
directory=mydmpdirectory dumpfile=schemadump.dmp SCHEMAS=tgtprefix_SCHEMA_NAME

例41-11 スキーマ・データのインポート(ソースとターゲットのスキーマ名が異なる場合)

DB_ORACLE_HOME/bin/impdp \"sys/password@serviceid as sysdba\"
directory=mydmpdirectory dumpfile=schemadump.dmp
remap_schema=srcprefix_SCHEMA_NAME:tgtprefix_SCHEMA_NAME
remap_tablespace=source_tablespace:target_tablespace exclude=user
TABLE_EXISTS_ACTION=REPLACE

ここで:

- DB_ORACLE_HOMEは、データベース・スキーマがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベースの一意のSIDです。たとえば、mydb1234のように指定します。

- directoryは、ダンプ・ファイルを配置するデータベース・マシン上の場所です。

- dumpfileは、インポートするデータを含むファイルの名前です。

- SCHEMASは、インポートするスキーマです。これは、インストール時に使用されたRCU接尾辞(_SCHEMA_NAME)に、ユーザーが指定した接頭辞を加えたものです。例: DEV_ACTIVITIES。
このパラメータは、ソースとターゲットのスキーマ名が一致するときに使用します。たとえば、両方のスキーマの名前をDEV_ACTIVITIESとします。

複数のスキーマからデータをエクスポートするには、各スキーマ名をカンマで区切ります。

- REMAP_SCHEMAは、ソースおよびターゲット・スキーマを識別します。このパラメータは、ソースとターゲットのスキーマ名が異なる場合に使用します。スキーマの名前は、インストール時に使用されたRCU接尾辞(_SCHEMA_NAME)に、ユーザーが指定した接頭辞を加えたものになります。例: DEV_ACTIVITIES。

- REMAP_TABLESPACEは、ソースおよびターゲット表領域を識別します。ソース表領域内の永続データのインポートで選択されたすべてのオブジェクトが、ターゲット表領域で作成されるように再マップします。例: source_tablespace:target_tablespace。

- TABLE_EXISTS_ACTION=REPLACEは、現在の表を削除して、ダンプ・ファイルに含まれているとおりに表を作成します。

41.6.6 LDAPアイデンティティ・ストアのバックアップおよびリストア

Oracle Internet Directoryなど、外部アイデンティティ・ストアでは、基礎となるデータベースにデータを格納します。Oracle Internet Directoryのデータベース・スキーマ・データをバックアップおよびリストアする方法については、管理者ガイドのOracle Internet Directoryのバックアップおよびリカバリの推奨事項に関する項を参照してください。

別のLDAPアイデンティティ・ストアを使用する場合は、該当製品に適したバックアップおよびリカバリのドキュメントを参照してください。

41.6.7 ポリシー・ストアのバックアップおよびリストア(LDAPとデータベース)

WLSTコマンドmigrateSecurityStoreを使用して、WebCenter PortalまたはPortal Frameworkアプリケーションに構成されているポリシー・ストアをバックアップしてからリストアします。本番環境では、ポリシーをLDAPまたはデータベースに格納することをお薦めします。ファイルベースのポリシー・ストアはお薦めしません。

migrateSecurityStoreを使用して、次の操作を行います。

- LDAPまたはデータベースベースのポリシー・ストアをバックアップ・ファイルにバックアップする

- LDAPまたはデータベースのポリシー・ストアをバックアップ・ファイルからリストアする

詳細は、Oracle Platform Security Servicesによるアプリケーションの保護の手動によるポリシーの移行に関する項を参照してください。

『WebLogic Scripting Toolコマンド・リファレンス』のmigrateSecurityStoreに関する項も参照してください。

注意:
WebCenter Portalのエクスポートとインポートのユーティリティ(exportWebCenterApplicationおよびimportWebCenterApplication)を使用してWebCenter Portalを別のインスタンスに移行する場合は、セキュリティ・ポリシー・データが含まれるため、このインスタンスのポリシー・ストアを手動で移行する必要はありません。詳細は、第41.5項「別のターゲットへのWebCenter Portal全体の移行」を参照してください。

41.6.8 資格証明ストアのバックアップおよびリストア(LDAPとデータベース)

WLSTコマンドmigrateSecurityStoreを使用して、WebCenter PortalまたはPortal Frameworkアプリケーションに構成されている資格証明ストアをバックアップしてからリストアします。本番環境では、資格証明をLDAPまたはデータベースに格納することをお薦めします。ファイルベースの資格証明ストアはお薦めしません。

migrateSecurityStoreを使用して、次の操作を行います。

- LDAPまたはデータベースベースの資格証明ストアをバックアップ・ファイルにバックアップする

- LDAPまたはデータベースの資格証明ストアをバックアップ・ファイルからリストアする

詳細は、Oracle Platform Security Servicesによるアプリケーションの保護のmigrateSecurityStoreによる資格証明の移行に関する項を参照してください。

『WebLogic Scripting Toolコマンド・リファレンス』のmigrateSecurityStoreに関する項も参照してください。

41.6.9 WebCenter Portalドメインのバックアップおよびリストア

ドメイン構成をバックアップおよびリストアする方法については、管理者ガイドのOracle WebLogic Serverのバックアップおよびリカバリの推奨事項に関する項を参照してください。

41.6.10 ポートレット・プロデューサのメタデータのバックアップおよびリストア

ポートレット・プロデューサでは、登録ハンドルとポートレット参照データを、コンシューマ・アプリケーション(WebCenter PortalまたはPortal Frameworkアプリケーション)とともにメタデータとして格納します。この項では、アプリケーションで格納されるポートレット・メタデータをWLSTコマンドexportPortletClientMetadataを使用してバックアップする方法と、ポートレット・メタデータをimportPortletClientMetadataを使用してリストアする方法について説明します。

注意:
WebCenter Portalのエクスポートとインポートのユーティリティ(exportWebCenterApplicationおよびimportWebCenterApplication)を使用してWebCenter Portalを別のインスタンスに移行する場合はポートレット・メタデータが含まれるため、このインスタンスのポートレット・プロデューサのメタデータを手動で移行する必要はありません。詳細は、第41.5項「別のターゲットへのWebCenter Portal全体の移行」を参照してください。

この項には次のトピックが含まれます:

- ポートレット・クライアント・メタデータのバックアップ(エクスポート)

- ポートレット・クライアント・メタデータのリストア(インポート)

データベースで格納されるポートレット・プロデューサのデータをバックアップする方法については、第41.6.5項「他のスキーマ・データ(ACTIVITIESとPORTLET)のバックアップおよびリストア」を参照してください。

41.6.10.1 ポートレット・クライアント・メタデータのバックアップ(エクスポート)

WebCenter PortalまたはPortal Frameworkアプリケーションなど、単一アプリケーションのポートレット・クライアント・メタデータおよびプロデューサのカスタマイズとパーソナライズをエクスポートするには、WLSTコマンドexportPortletClientMetadataを使用します。このコマンドは、アプリケーションで使用されるすべてのポートレット・プロデューサのメタデータをエクスポートします。特定のプロデューサのメタデータをエクスポートすることはできません。

構文と例の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のexportPortletClientMetadataに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

41.6.10.2 ポートレット・クライアント・メタデータのリストア(インポート)

WebCenter PortalやPortal Frameworkアプリケーションのポートレット・クライアント・メタデータおよびプロデューサのカスタマイズとパーソナライズをインポートするには、WLSTコマンドimportPortletClientMetadataを使用します。

前提条件:

- アプリケーション・メタデータまたはスキーマが格納されているデータベースおよびポートレット・プロデューサが稼働している必要があります。

- WLSTコマンドexportPortletClientMetadataを使用して、ポートレット・クライアント・メタデータ、プロデューサのカスタマイズおよびパーソナライズを.earファイルにエクスポートします。第41.6.10.1項「ポートレット・クライアント・メタデータのバックアップ(エクスポート)」も参照してください。

構文と例の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のimportPortletClientMetadataに関する項を参照してください。メタデータ・サービス(MDS)カスタムWLSTコマンドに関する項も参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

41.6.11 ページレット・プロデューサのメタデータのバックアップおよびリストア

ページレット・プロデューサでは、MDSに構成データとコンテンツを格納します。ページレット・メタデータは、WLSTコマンドexportMetadataおよびimportMetadataを使用して、個別のアーカイブにバックアップできます。詳細は、第22.5項「ページレット・プロデューサ・コンポーネントのインポート、エクスポート、バックアップおよびリカバリの管理」を参照してください。

41.6.12 アクティビティ・グラフと分析のメタデータのバックアップおよびリストア

アクティビティ・グラフでは、分析のWebCenter Portalイベント・データをマッピングするためのメタデータ定義をMDSに格納します。アクティビティ・グラフのメタデータは、WLSTコマンドexportAGMetadataおよびimportAGMetadataを使用して、個別のアーカイブにバックアップできます。また、WLSTコマンドexportAGProviderConfigurationを使用して、特定のプロバイダに関するプロバイダ構成メタデータをアクティビティ・グラフ・メタデータ定義ファイルにバックアップすることもできます。詳細は、第10.6項「アクティビティ・グラフ・スキーマのカスタマイズの管理」を参照してください。

ACTIVITIESデータベース・スキーマ全体をバックアップするには、第41.6.5項「他のスキーマ・データ(ACTIVITIESとPORTLET)のバックアップおよびリストア」を参照してください。

41.6.13 パーソナライズ・メタデータのバックアップおよびリストア

パーソナライズ・ファイルはMDSに格納されます。WebCenter PortalまたはPortal FrameworkアプリケーションについてMDSに格納されるパーソナライズ・データは、WLSTコマンドexportMetadataを使用してアーカイブにバックアップし、必要に応じて、importMetadataを使用してパーソナライズ・データをアーカイブからリストアできます。

MDSのパーソナライズ・データをバックアップ(エクスポート)する場合:

exportMetadata(application='wcps-services', server='server_name',
toLocation='archive_file_name', remote='true')

アーカイブのパーソナライズ・データをMDSにリストア(インポート)する場合:

importMetadata(application='wcps-services', server='server_name',
fromLocation='archive_file_name', remote='true')

例:

exportMetadata(application='wcps-services', server='WC_Utilities',
toLocation='/backup_11_11_2013/backupWCPS.zip', remote='true')

importMetadata(application='wcps-services', server='WC_Utilities',
fromLocation='/backup_11_11_2013/backupWCPS.zip, remote='true')

41.6.14 監査リポジトリ構成のバックアップおよびリストア

監査ポリシーと監査リポジトリ構成は、WLSTコマンドexportAuditConfigおよびimportAuditConfigを使用して、ファイルにバックアップできます。

構文の詳細と例は、『WebLogic Scripting Toolコマンド・リファレンス』のexportAuditConfigに関する項およびimportAuditConfigに関する項を参照してください。

41.7 WebCenter Portalインストール全体のリストア

この項では、ハードウェアの障害後、またはファイルやデータベースから誤ってデータを削除した後に、WebCenter Portalインストールをリストアする方法について説明します。この項の手順を使用して、WebCenter Portalインストール全体を、新しいマシン、またはすでにインストールされてOracle WebCenter Portal用に構成されているWebLogic Serverインスタンスに完全にリストアします。

この項の手順では、リストアされたインスタンスで使用されるバックエンド・サーバーおよび接続が、リストア・プロセス前に構成されたバックエンド・サーバーおよび接続とまったく同じであることが前提になります。

重要:
データベース・スキーマWEBCENTERおよびMDSは、データが同期するように一緒にリストアする必要があります。
OCSなどのスキーマを追加でリストアする必要がある場合、データの整合性を維持するには、これらを同時に同じポイントでリストアしておく必要があります。

手順は次のようになります。

1. WebCenter Portalスキーマをバックアップからリストアします。
「WebCenter Portalデータのリストア(インポート)」を参照してください。

2. MDSスキーマ・データをバックアップからリストアします。
「MDSスキーマ・データのリストア(インポート)」を参照してください。

3. (オプション)Content Serverデータをバックアップからリストアします。
「すべてのWebCenter Contentデータのバックアップおよびリストア」を参照してください。

4. (オプション)ディスカッション・スキーマ・データをバックアップからリストアします。
「ディスカッション・スキーマ・データのリストア(インポート)」を参照してください。

5. (オプション)WebCenter Portalの他のスキーマ・データをバックアップからリストアします。
「他のスキーマ・データ(ACTIVITIESとPORTLET)のバックアップおよびリストア」を参照してください。

6. セキュリティ・ストア・データをバックアップからリストアします。
詳細は、次を参照してください。

- ポリシー・ストアのバックアップおよびリストア(LDAPとデータベース)

- 資格証明ストアのバックアップおよびリストア(LDAPとデータベース)

- (オプション)LDAPアイデンティティ・ストアのバックアップおよびリストア

7. (オプション)WebCenter Portalの接続をバックアップからリストアします。
「ファイルからの新しいWebCenter Portal接続のインポート」を参照してください。

8. (オプション)WebCenter Portalの監査構成をバックアップからリストアします。
「監査リポジトリ構成のバックアップおよびリストア」を参照してください。

9. (オプション)WebCenter PortalをホストするWebLogic Serverドメインをバックアップからリストアします。
「WebCenter Portalドメインのバックアップおよびリストア」を参照してください。

10. 再起動して、リストアした内容を検証します。

場合によっては、個々のツールとサービスに関連付けられたメタデータをリストアする必要があります。この場合、次のトピックを参照してください。

- ポートレット・プロデューサのメタデータのみをバックアップからリストアします。
「ポートレット・プロデューサのメタデータのバックアップおよびリストア」を参照してください。

- ページレット・プロデューサのMDSメタデータのみをバックアップからリストアします。
「ページレット・プロデューサのメタデータのバックアップおよびリストア」を参照してください。

- アクティビティ・グラフと分析のMDSメタデータのみをバックアップからリストアします。
「アクティビティ・グラフと分析のメタデータのバックアップおよびリストア」を参照してください。

- MDSのパーソナライズ・データのみをバックアップからリストアします。
「パーソナライズのメタデータのバックアップおよびリストア」を参照してください。

この項の情報では、手動でリストアする方法について説明します。データを頻繁にリストアまたは移行する必要がある場合は、プロセスを自動化するスクリプトを作成できます。詳細は、第41.8項「スクリプトを使用したWebCenter Portalのバックアップおよびリストア」を参照してください。

41.8 スクリプトを使用したWebCenter Portalのバックアップおよびリストア

WebCenter Portalインストールを手動でバックアップするには時間がかかる場合があります。定期的なバックアップを自動化してスケジュール設定するスクリプトを使用すると、効率が上がり、時間が大幅に節約されます。Oracleにはこの開始に役立つサンプルのバックアップ・スクリプトが用意されています。このスクリプトを使用すると、インストールやバックアップの要件に合せてカスタマイズできます。

詳細は、次のトピックを参照してください。

- 第41.8.1項「バックアップおよびリストアのスクリプト・ファイルの理解」

- 第41.8.2項「スクリプトを使用したWebCenter Portalのバックアップ」

- 第41.8.3項「スクリプトを使用したWebCenter Portalのバックアップからのリストア」

41.8.1 バックアップおよびリストアのスクリプト・ファイルの理解

Oracleには、バックアップとリカバリのプロセスの自動化に役立つサンプル・スクリプトが用意されています。サンプル・スクリプトにより、次の情報のバックアップとリストアが行われます。

- データベース・スキーマ: WebCenter Portalの必要なすべてのスキーマをバックアップします。

- ファイル・ストアのデータ: WebCenter Contentファイル・システムに格納されているWebCenter Portalデータをバックアップおよびリストアします。

- セキュリティ情報: WebCenter Portalのポリシー・ストア、資格証明ストア、監査構成をバックアップおよびリストアします。

表41-4に、バックアップおよびリカバリ用に提供されるサンプル・スクリプトとファイルを示します。

表41-4 バックアップおよびリストア用のサンプル・スクリプトおよびファイル

サンプル・スクリプトおよびファイル

説明

使用目的

master_script.sh

データベースのエクスポート・コマンドを実行し、WebCenter Contentをファイル・システムにアーカイブして、WLSTのエクスポートおよびインポートのコマンドを実行するシェル・スクリプト。

第41.8.1.1項「master_script.sh」を参照してください。

バックアップおよびリストア

wlst_script.py

ポートレットとセキュリティのメタデータをエクスポートおよびインポートするためのWLSTコマンドを実行するPythonスクリプト。

第41.8.1.2項「wlst_script.py」を参照してください。

バックアップおよびリストア

backup.properties

WebCenter Portalデータベースをバックアップして、master_script.shおよびwlst_script.pyでWLSTのエクスポート・コマンドを実行する入力パラメータを含むプロパティ・ファイル。

第41.8.1.3項「backup.propertiesファイルおよびrestore.propertiesファイル」を参照してください。

バックアップのみ

restore.properties

WebCenter Portalデータベースをリストアして、WLSTのインポート・コマンドをバックアップ・ファイルから実行できる、master_script.shおよびwlst_script.pyの入力パラメータを含むプロパティ・ファイル。

第41.8.1.3項「backup.propertiesファイルおよびrestore.propertiesファイル」を参照してください。

リストアのみ

サンプル・ファイルは、確認や変更を行うための起動スクリプトです。あるいは、必要に応じて、独自のスクリプトを最初から作成できます。

41.8.1.1 master_script.sh

master_script.shを例41-12に示します。

このスクリプトは、次のデータベース・スキーマに格納されるWebCenter Portalデータをバックアップ(エクスポート)できます。

- WEBCENTER

- MDS

- DISCUSSIONS

- DISCUSSIONS_CRAWLER

- OCS

- ACTIVITIES

- PORTLET

バックアップ時に、スクリプトは、バックアップするスキーマごとにデータベースのエクスポート・コマンドexpdpを実行します。

DB_ORACLE_HOME/bin/expdp \"sys/password@serviceid as sysdba\" directory=backup_directory dumpfile=dump_file_name.dmp SCHEMAS=prefix_SCHEMA_NAME EXCLUDE=STATISTICS NOLOGFILE=y

関連項目:
個々のスキーマのデータベース・コマンドexpdpについては、第41.6項「WebCenter Portalインストール全体のバックアップ」で説明しています。

スクリプトにより、ファイル・システムに格納されているWebCenter Contentのネイティブ・ファイル(vaultフォルダ)およびWeb表示可能ファイル(weblayoutフォルダ)もエクスポートまたはインポートされます。

- ファイル・システムに格納されているWebCenter Contentファイルをバックアップするには、スクリプトで次のように実行します。
tar cvf wcc_vault.tar WCP_ORACLE_HOME/ucm/vault

tar cvf wcc_weblayout.tar WCP_ORACLE_HOME/ucm/weblayout

- ターゲット・ファイル・システムでWebCenter Contentファイルをリストアするには、スクリプトで次のように実行します。
tar xvf wcc_vault.tar

tar xvf wcc_weblayout.tar

最後に、WLSTコマンドのスクリプトwlst_script.pyをコールします。詳細は、第41.8.1.2項「wlst_script.py」を参照してください。

例41-12 サンプル・スクリプト: master_script.sh

## master_script.sh
## Backs up or restores a WebCenter Portal installation
## Executes database export or import commands and a Python script containing WLST commands.
############ No User Input Required ########################################
# Reading the properties files for WebCenter Portal back up or restore...
PROPS_FILE=$1

exportimport=`sed '/^\#/d' $PROPS_FILE | grep 'OPERATION'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
dump_directory=`sed '/^\#/d' $PROPS_FILE | grep 'DATA_DIRECTORY'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
oracle_db_home=`sed '/^\#/d' $PROPS_FILE | grep 'DB_ORACLE_HOME'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
oracle_db_admin=`sed '/^\#/d' $PROPS_FILE | grep 'DB_ADMIN_USER'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
oracle_db_adminpwd=`sed '/^\#/d' $PROPS_FILE | grep 'DB_ADMIN_PASSWORD'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
oracle_db_sid=`sed '/^\#/d' $PROPS_FILE | grep 'DB_SID'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
oracle_db_connect_webcenter=`sed '/^\#/d' $PROPS_FILE | grep 'DB_CONNECT_WEBCENTER_SCHEMA'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
oracle_db_connect_mds=`sed '/^\#/d' $PROPS_FILE | grep 'DB_CONNECT_MDS_SCHEMA'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
oracle_db_connect_discussions=`sed '/^\#/d' $PROPS_FILE | grep 'DB_CONNECT_DISCUSSIONS_SCHEMA'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
oracle_db_connect_ocs=`sed '/^\#/d' $PROPS_FILE | grep 'DB_CONNECT_OCS_SCHEMA'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
oracle_db_connect_activities=`sed '/^\#/d' $PROPS_FILE | grep 'DB_CONNECT_ACTIVITIES_SCHEMA'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
oracle_db_connect_portlet=`sed '/^\#/d' $PROPS_FILE | grep 'DB_CONNECT_PORTLET_SCHEMA'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`

#Read schema information from the properties file.
src_webcenter_schema=`sed '/^\#/d' $PROPS_FILE | grep 'EXP_WEBCENTER_SCHEMA'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
src_mds_schema=`sed '/^\#/d' $PROPS_FILE | grep 'EXP_MDS_SCHEMA'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
src_ocs_schema=`sed '/^\#/d' $PROPS_FILE | grep 'EXP_OCS_SCHEMA'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
src_discussions_schema=`sed '/^\#/d' $PROPS_FILE | grep 'EXP_DISCUSSIONS_SCHEMA'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
src_discussions_crawler_schema=`sed '/^\#/d' $PROPS_FILE | grep 'EXP_DISCUSSIONS_CRAWLER_SCHEMA'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
src_activities_schema=`sed '/^\#/d' $PROPS_FILE | grep 'EXP_ACTIVITIES_SCHEMA'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
src_portlet_schema=`sed '/^\#/d' $PROPS_FILE | grep 'EXP_PORTLET_SCHEMA'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`

# Read WLST connection information from the properties file.
username=`sed '/^\#/d' $PROPS_FILE | grep 'WLST_ADMIN_USER'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
password=`sed '/^\#/d' $PROPS_FILE | grep 'WLST_ADMIN_PASSWORD'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
adminconsole=`sed '/^\#/d' $PROPS_FILE | grep 'WLST_ADMIN_CONSOLE'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
wlstlocation=`sed '/^\#/d' $PROPS_FILE | grep 'WLST_LOCATION'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
wlstscriptfile=`sed '/^\#/d' $PROPS_FILE | grep 'WLST_SCRIPT_LOCATION'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
wcpServer=`sed '/^\#/d' $PROPS_FILE | grep 'WCP_SERVER_NAME'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
jpsConfigFile=`sed '/^\#/d' $PROPS_FILE | grep 'JPS_CONFIG_FILE'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
sourceJpsContextPolicy=`sed '/^\#/d' $PROPS_FILE | grep 'SRC_JPS_CONTEXT_POLICYSTORE'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
destinationJpsContextPolicy=`sed '/^\#/d' $PROPS_FILE | grep 'TGT_JPS_CONTEXT_POLICYSTORE'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
sourceJpsContextCred=`sed '/^\#/d' $PROPS_FILE | grep 'SRC_JPS_CONTEXT_CREDSTORE'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
destinationJpsContextCred=`sed '/^\#/d' $PROPS_FILE | grep 'TGT_JPS_CONTEXT_CREDSTORE'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
backupPolicyStoreFile=`sed '/^\#/d' $PROPS_FILE | grep 'POLICYSTORE_FILE_NAME'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
backupCredStoreFile=`sed '/^\#/d' $PROPS_FILE | grep 'CREDSTORE_FILE_NAME'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
wccVaultLoc=`sed '/^\#/d' $PROPS_FILE | grep 'WCC_VAULT_LOC'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`
wccWeblayoutLoc=`sed '/^\#/d' $PROPS_FILE | grep 'WCC_WEBLAYOUT_LOC'  | tail -n 1 | cut -d "=" -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'`

#Data dump files that database schema data is exported to or imported from
wcdmp=wcdmp.dmp
mdsdmp=mdsdmp.dmp
discussionsdmp=discussionsdmp.dmp
ocsdmp=ocsdmp.dmp
activitiesdmp=activities.dmp
portletdmp=portlet.dmp

#Portlet client metadata export archive (.EAR) that portlet client metadata is exported to or imported from
portletdatafilename=portletdata.ear

#Audit configuration file that audit information is exported to or imported from
auditFileName=audit.xml

#Running WebCenter Portal back up and recovery scripts...

#On backup - Create a folder with a timestamp under the dump_directory folder
#On restore - Read user specified base directory to import from
current_time=$(date "+%Y.%m.%d-%H.%M.%S")
backup_directory=$dump_directory
if [ ! -z "$exportimport" ]; then
if [ $exportimport = 'export' ]; then
#'Creating backup directory.'
backup_directory=$dump_directory/$current_time
rm -rf $backup_directory
mkdir $backup_directory
fi
if [ $exportimport = 'import' ]; then
backup_directory=$dump_directory
fi
fi

#Writing output to a log file
outputLogFile=$2
# Create a pipe file
mknod $backup_directory/pipefile.$$ p
# Start tee process in background to read it and output content to screen and log file
rm -rf $backup_directory/$outputLogFile
tee $backup_directory/$outputLogFile <$backup_directory/pipefile.$$ &
exec &>$backup_directory/pipefile.$$

#Common for backup (export) and restore (import)
#Create directories and grant read write permissions
export ORACLE_HOME=$oracle_db_home
export ORACLE_SID=$oracle_db_sid
export TNS_ADMIN=$ORACLE_HOME/network/admin
cd $oracle_db_home/bin

if [ ! -z "$exportimport" ]; then
# Start back up (export)
if [ $exportimport = 'export' ]; then
echo 'Back up started...'
if [ -n "$src_webcenter_schema" ] && [ -n "$wcdmp" ]; then
./sqlplus "$oracle_db_connect_webcenter as sysdba" << eof_disp
create or replace directory dmpdir as '$backup_directory';
GRANT read,write ON directory dmpdir TO public;
eof_disp
echo 'Exporting the WEBCENTER  schema...'
./expdp \"$oracle_db_connect_webcenter as sysdba\" directory=dmpdir
dumpfile=$wcdmp  SCHEMAS=$src_webcenter_schema EXCLUDE=STATISTICS NOLOGFILE=y
fi
if [ -n "$src_mds_schema" ] && [ -n "$mdsdmp" ]; then
./sqlplus "$oracle_db_connect_mds as sysdba" << eof_disp
create or replace directory dmpdir as '$backup_directory';
GRANT read,write ON directory dmpdir TO public;
eof_disp
echo 'Exporting the MDS schema...'
./expdp \"$oracle_db_connect_mds as sysdba\" directory=dmpdir
dumpfile=$mdsdmp  SCHEMAS=$src_mds_schema EXCLUDE=STATISTICS NOLOGFILE=y
fi
if [ -n "$src_discussions_schema" ] && [ -n "$discussionsdmp" ]; then
./sqlplus "$oracle_db_connect_discussions as sysdba" << eof_disp
create or replace directory dmpdir as '$backup_directory';
GRANT read,write ON directory dmpdir TO public;
eof_disp
echo 'Exporting the DISCUSSIONS schema...'
./expdp \"$oracle_db_connect_discussions as sysdba\" directory=dmpdir
dumpfile=$discussionsdmp  SCHEMAS=$src_discussions_schema EXCLUDE=STATISTICS
NOLOGFILE=y
fi
if [ -n "$src_ocs_schema" ] && [ -n "$ocsdmp" ]; then
./sqlplus "$oracle_db_connect_ocs as sysdba" << eof_disp
create or replace directory dmpdir as '$backup_directory';
GRANT read,write ON directory dmpdir TO public;
eof_disp
echo 'Exporting the OCS schema...'
./expdp \"$oracle_db_connect_ocs as sysdba\" directory=dmpdir
dumpfile=$ocsdmp  SCHEMAS=$src_ocs_schema EXCLUDE=STATISTICS NOLOGFILE=y
if [ -n "$wccVaultLoc" ]; then
echo -e '\nExporting vault files for WebCenter Content...'
cd $backup_directory
tar cvf wcc_vault.tar -C $wccVaultLoc/vault .
if [ -f "$backup_directory/wcc_vault.tar" ]; then
echo -e '\nExported vault files for WebCenter Content to:
'$backup_directory'/wcc_vault.tar'
fi
cd $oracle_db_home/bin
fi
if [ -n "$wccWeblayoutLoc" ]; then
echo -e '\nExporting weblayout files for WebCenter Content...'
cd $backup_directory
tar cvf wcc_weblayout.tar -C $wccWeblayoutLoc/weblayout .
if [ -f "$backup_directory/wcc_weblayout.tar" ]; then
echo -e '\nExported weblayout files for WebCenter Content to:
'$backup_directory'/wcc_weblayout.tar'
fi
cd $oracle_db_home/bin
fi
fi
if [ -n "$src_activities_schema" ] && [ -n "$activitiesdmp" ]; then
./sqlplus "$oracle_db_connect_ocs as sysdba" << eof_disp
create or replace directory dmpdir as '$backup_directory';
GRANT read,write ON directory dmpdir TO public;
eof_disp
echo 'Exporting the ACTIVITIES schema...'
./expdp \"$oracle_db_connect_activities as sysdba\" directory=dmpdir
dumpfile=$activitiesdmp  SCHEMAS=$src_activities_schema EXCLUDE=STATISTICS
NOLOGFILE=y
fi
if [ -n "$src_portlet_schema" ] && [ -n "$portletdmp" ]; then
./sqlplus "$oracle_db_connect_ocs as sysdba" << eof_disp
create or replace directory dmpdir as '$backup_directory';
GRANT read,write ON directory dmpdir TO public;
eof_disp
echo 'Exporting the PORTLET schema...'
./expdp \"$oracle_db_connect_portlet as sysdba\" directory=dmpdir
dumpfile=$portletdmp  SCHEMAS=$src_portlet_schema EXCLUDE=STATISTICS NOLOGFILE=y
fi

#Call the WLST command script.
cd $wlstlocation
./wlst.sh $wlstscriptfile $exportimport $username $password $adminconsole
$backup_directory/$portletdatafilename $wcpServer $jpsConfigFile
$sourceJpsContextPolicy $destinationJpsContextPolicy $sourceJpsContextCred
$destinationJpsContextCred $backup_directory/$auditFileName

#Copy the backup policy store and credential store files to the backup location.
if [ -f "$backupPolicyStoreFile" ]; then
mv $backupPolicyStoreFile $backup_directory
fi
if [ -f "$backupCredStoreFile" ]; then
mv $backupCredStoreFile $backup_directory
fi
echo 'Back up completed successfully. Backup created at location:
'$backup_directory'. Check the log file: '$backup_directory/$outputLogFile' for additional details.'
fi

#Start restore (import)...
if [ $exportimport = 'import' ]; then
echo 'Restore started...'
if [ -f "$backup_directory/wcc_vault.tar" ]; then
echo -e '\nImporting vault files for WebCenter Content...'
cd $wccVaultLoc/vault
tar xvf $backup_directory/wcc_vault.tar
echo -e '\nImported vault files for WebCenter Content from:
'$backup_directory'/wcc_vault.tar to the location: '$wccVaultLoc'/vault'
fi
if [ -f "$backup_directory/wcc_weblayout.tar" ]; then
echo -e '\nImporting weblayout files for WebCenter Content...'
cd $wccWeblayoutLoc/weblayout
tar xvf $backup_directory/wcc_weblayout.tar
echo -e '\nImported weblayout files for WebCenter Content from:
'$backup_directory'/wcc_weblayout.tar to the location:
'$wccWeblayoutLoc'/weblayout'
fi
#Call the WLST commands script.
cd $wlstlocation
./wlst.sh $wlstscriptfile $exportimport $username $password $adminconsole
$backup_directory/$portletdatafilename $wcpServer $jpsConfigFile
$destinationJpsContextPolicy $sourceJpsContextPolicy $destinationJpsContextCred
$sourceJpsContextCred $backup_directory/$auditFileName
echo 'Restoration completed successfully. Check the log file:
'$backup_directory/$outputLogFile' for additional details.'
fi
fi
#Clean up pipe file
rm -f $backup_directory/pipefile.$$

41.8.1.2 wlst_script.py

wlst_script.shを例41-13に示します。

このスクリプトでは、WebCenter Portalインストールの管理コンソールに接続してから、次の内容のバックアップ(エクスポート)またはリストア(インポート)のいずれかを行います。

- ポートレット・クライアント・メタデータ

- ポリシー・ストア

- 資格証明ストア

- 監査構成情報

バックアップ時に実行されるWLSTのエクスポート・コマンド

バックアップ時に、スクリプトではWLSTの次のエクスポート・コマンドを実行します。

- exportPortletClientMetadata(appName, fileName, server)

- migrateSecurityStore(type='appPolicies', configFile, src, dst, overWrite, srcApp, dstApp)

- migrateSecurityStore(type='credStore', configFile, src, dst)

- exportAuditConfig(fileName)

リストア時に実行されるWLSTのインポート・コマンド

リストア時に、スクリプトではWLSTの次のインポート・コマンドを実行します。

- importPortletClientMetadata(appName, fileName, server)

- migrateSecurityStore(type='appPolicies', configFile, src, dst, overWrite, srcApp, dstApp)

- migrateSecurityStore(type='credStore', configFile, src, dst)

- importAuditConfig(fileName)

関連項目:
各アイテムをバックアップまたはリストアする場合は、第41.6項「WebCenter Portalインストール全体のバックアップ」または第41.7項「WebCenter Portalインストール全体のリストア」の該当する項を参照してください。

例41-13 サンプル・スクリプト: wlst_script.py

## wlst_script.py
## Python script that runs export and import WLST commands.
############ No User Input Required ###################

# Get user credentials and other parameters from the properties file
exportOrImport = sys.argv[1]
username = sys.argv[2]
password = sys.argv[3]
adminconsole = sys.argv[4]
fileName = sys.argv[5]
wcpServerName = sys.argv[6]
jpsConfigFile = sys.argv[7]
destination = sys.argv[8]
source = sys.argv[9]
dstCred = sys.argv[10]
sourceCred = sys.argv[11]
auditFileName=sys.argv[12]

# Connect to the given host
connect(username,password,adminconsole)

if (exportOrImport == 'export' ):
# Run export WLST commands
# Export portlet data
print 'Exporting portlet data...'
exportPortletClientMetadata(appName='webcenter', fileName=fileName, server=wcpServerName)
if webcenterErrorOccurred(): # COMMAND STATUS
print "Error while exporting the portlet data."
else:
print 'Successfully exported the portlet data.'

# Export security
print 'Exporting the policy store...'
migrateSecurityStore(type='appPolicies', configFile=jpsConfigFile, src=source,
dst=destination, overWrite='true', srcApp='webcenter', dstApp='webcenter')
print 'Exporting the credential store...'
migrateSecurityStore(type='credStore', configFile=jpsConfigFile, src=sourceCred,
dst=dstCred)
print 'Exporting audit configuration...'
exportAuditConfig(fileName=auditFileName)

elif (exportOrImport == 'import' ):
# Run import WLST commands
# Import portlet data
print 'Importing portlet data...'
importPortletClientMetadata(appName='webcenter', fileName=fileName, server=wcpServerName)
if webcenterErrorOccurred(): # COMMAND STATUS
print "Error while importing portlet data."
else:
print 'Successfully imported portlet data.'

# Import security
print 'Importing the policy store...'
migrateSecurityStore(type='appPolicies', configFile=jpsConfigFile, src=source, dst=destination, overWrite='true', srcApp='webcenter', dstApp='webcenter')
print 'Importing the credential store...'
migrateSecurityStore(type='credStore', configFile=jpsConfigFile, src=sourceCred, dst=dstCred)
print 'Importing audit configuration...'
importAuditConfig(fileName=auditFileName)

41.8.1.3 backup.propertiesファイルおよびrestore.propertiesファイル

backup.propertiesファイルには、master_script.shおよびwlst_script.pyでのバックアップ・コマンドの入力パラメータが含まれます。たとえば、ファイル名、データベース・ホームの場所、データベース接続文字列、スキーマ名などがあります。

リストア・コマンドの入力パラメータを定義するには、類似する.propertiesファイル(restore.properties)が必要です。

表41-5に、backup.propertiesファイルとrestore.propertiesファイルの入力パラメータを示し、これらについて説明します。

例41-14に、backup.propertiesファイルとサンプル値を示します。

例41-15に、restore.propertiesファイルとサンプル値を示します。

表41-5 バックアップ・スクリプトおよびリストア・スクリプトのユーザー定義パラメータ

バックアップ/リストアのパラメータ

説明

例

OPERATION

スクリプトでWebCenter Portalデータのバックアップ(エクスポート)とリストア(インポート)のどちらを行うかを決定します。

バックアップの場合:

export

リストアの場合:

import

データベース情報

DATA_DIRECTORY

バックアップ・スクリプトの場合:

スクリプトで作成されるバックアップ・ファイルを格納するファイル・システムの場所。

スクリプトを実行するたびに、ここで指定したディレクトリの下に新しいサブディレクトリが作成されます。各サブディレクトリの名前には、2013.03.18-05.20.28のようなタイムスタンプが含まれます。

リストア・スクリプトの場合:

リストア元のバックアップを含むディレクトリ。

バックアップの場合:

DATA_DIRECTORY=/scratch/aime1/mywebcenterportal_backupscripts/mybackups

リストアの場合:

DATA_DIRECTORY=/scratch/aime1/mywebcenterportal_backupscripts/mybackups/2013.03.18-05.20.28

DB_ORACLE_HOME

データベース・ホームのディレクトリ。

/scratch/aime1/mywork/db1234

DB_ADMIN_USER

データベース管理ユーザー。

mydbadminuser

DB_ADMIN_PASSWORD

データベース管理ユーザーのパスワード。

mypassword

DB_SID

データベースのSID。

db1234

WebCenter Contentフォルダ

バックアップおよびリストアの場合:

WCC_VAULT_LOC

WebCenter Contentのvaultファイルのファイル・システムの場所。

/scratch/aime1/mwork/mymw/user_projects/domains/WLS_WC/ucm/cs

WCC_WEBLAYOUT_LOC

WebCenter Contentのweblayoutファイルのファイル・システムの場所。

/scratch/aime1/mwork/mymw/user_projects/domains/WLS_WC/ucm/cs

データベース接続文字列
(バックアップ・スクリプトのみ)

OPERATION=exportの場合は必須。

バックアップのみの場合:

DB_CONNECT_WEBCENTER_SCHEMA

エクスポートするWEBCENTERデータベース・スキーマの接続文字列。

mydbadmin/mypassword@db1234

DB_CONNECT_MDS_SCHEMA

エクスポートするMDSデータベース・スキーマの接続文字列。

mydbadmin/mypassword@db1234

DB_CONNECT_OCS_SCHEMA

エクスポートするOCSデータベース・スキーマの接続文字列。

mydbadmin/mypassword@db1234

DB_CONNECT_DISCUSSIONS_SCHEMA

エクスポートするDISCUSSIONSデータベース・スキーマの接続文字列。

mydbadmin/mypassword@db1234

DB_CONNECT_ACTIVITIES_SCHEMA

エクスポートするACTIVITIESデータベース・スキーマの接続文字列。

mydbadmin/mypassword@db1234

DB_CONNECT_PORTLET_SCHEMA

エクスポートするPORTLETデータベース・スキーマの接続文字列。

mydbadmin/mypassword@db1234

エクスポートするデータベース・スキーマ
(バックアップ・スクリプトのみ)

OPERATION=exportの場合は必須。

バックアップのみの場合:

EXP_WEBCENTER_SCHEMA

エクスポートするWEBCENTERスキーマの名前。

mysrcprefix_WEBCENTER

EXP_MDS_SCHEMA

エクスポートするMDSスキーマの名前。

mysrcprefix_MDS

EXP_DISCUSSIONS_SCHEMA

エクスポートするDISCUSSIONSスキーマの名前。

mysrcprefix_DISCUSSIONS

EXP_DISCUSSIONS_CRAWLER_SCHEMA

エクスポートするDISCSUSSIONS_CRAWLERスキーマの名前。

mysrcprefix_DISCUSSIONS_CRAWLER

EXP_OCS_SCHEMA

エクスポートするOCSスキーマの名前。

mysrcprefix_OCS

EXP_ACTIVITIES_SCHEMA

エクスポートするACTIVITIESスキーマの名前。

mysrcprefix_ACTIVITIES

EXP_PORTLET_SCHEMA

エクスポートするPORTLETスキーマの名前。

mysrcprefix_PORTLET

WLSTのエクスポートおよびインポート

バックアップおよびリストアの場合:

WLST: 全般

WLST_ADMIN_USER

WLSTと管理サーバーを接続する管理ユーザーの名前。

mywlstadmin

WLST_ADMIN_PASSWORD

管理ユーザーのパスワード。

WLST_ADMIN_CONSOLE

次の形式で指定される、管理サーバーのホスト名とポート。

protocol://listen_address:listen_port

t3://myhost.com:24647

WLST_LOCATION

WLSTスクリプトの場所。Oracle WebCenter PortalのすべてのWLSTコマンドは、WebCenter PortalのOracleホーム・ディレクトリ(WCP_ORACLE_HOME)から実行する必要があります。

WCP_ORACLE_HOME/common/bin/wlst.sh

/scratch/aime1/mywork/mymw/mywcp_oraclehome/common/bin

WLST_SCRIPT_LOCATION

WLSTのバックアップおよびリストア・スクリプトの場所。

/scratch/aime1/myportal_server_scripts/wlst_script.py

WCP_SERVER_NAME

WebCenter Portalアプリケーション(webcenter)がデプロイされる管理対象サーバーの名前。

WC_Spaces

WLST: セキュリティ

JPS_CONFIG_FILE

WLSTコマンドが実行されるディレクトリに相対的な構成ファイルの名前と場所(デフォルトの名前はjps-config.xml)。

/scratch/aime1/mywork/mymw/user_projects/domains/myDomainHome/config/fmwconfig/backup-config-mycopy.xml

SRC_JPS_CONTEXT_POLICYSTORE

構成ファイルのjps-contextの名前。ここで、ソース・ポリシー・ストアが指定されます。

mysourcePolicy

TGT_JPS_CONTEXT_POLICYSTORE

構成ファイルの別のjps-contextの名前。ここで、ターゲット・ポリシー・ストアが指定されます。

mytargetPolicy

SRC_JPS_CONTEXT_CREDSTORE

構成ファイルのjps-contextの名前。ここで、ソース資格証明ストアが指定されます。

mysourceCred

TGT_JPS_CONTEXT_CREDSTORE

構成ファイルの別のjps-contextの名前。ここで、ターゲット資格証明ストアが指定されます。

mytargetCred

POLICYSTORE_FILE_NAME

バックアップまたはリストアするポリシー・ストアの名前と場所(JPS_CONFIG_FILEで指定)

/scratch/portal_server_scripts/backup/backup-system-jazn-data.xml

CREDSTORE_FILE_NAME

バックアップまたはリストアする資格証明ストアの名前と場所(場所はJPS_CONFIG_FILEで指定、ファイル名はcwallet.sso)

/scratch/portal_server_scripts/backup/cwallet.sso

例41-14 サンプル・バックアップ・スクリプトのプロパティ: backup.properties

## backup.properties for backing up WebCenter Portal
## Specify valid values for your environment
############ User Input Required #############

##OPERATION - Specify either export or import
##  For backup scripts, specify OPERATION=export
##  For restore scripts, specify OPERATION=import
##
OPERATION=export

##Specify database information
##For backup scripts, specify source database details here
##
##   DATA_DIRECTORY    Location on the file system that contains the backup
##                     scripts files
##   DB_ORACLE_HOME    Database home directory
##   DB_ADMIN_USER     Database admin user
##   DB_ADMIN_PASSWORD Password for the database admin user
##   DB_SID            Database SID
##
DATA_DIRECTORY=/scratch/aime1/mywebcenterportal_scripts/mybackups
DB_ORACLE_HOME=/scratch/aime1/mywork/db1234
DB_ADMIN_USER=mydbadmin
DB_ADMIN_PASSWORD=mypassword
DB_SID=db1234

##Specify WebCenter Content vault and weblayout file location information
##For backup scripts, specify the source directories here
##
WCC_VAULT_LOC=/scratch/aime1/mywork/mymw/user_projects/domains/myDomainHome/ucm/cs
WCC_WEBLAYOUT_LOC=/scratch/aime1/mwork/mymw/user_projects/domains/myDomainHome/ucm/cs

##Specify a connect string for each schema to export
##For backup scripts, specify connect strings for the source schemas here
## Use the format: <adminuser>/<password>@<serviceID>
## For example: mydbadmin/mypassword@db1234
##
DB_CONNECT_WEBCENTER_SCHEMA=mydbadmin/mypassword@db1234
DB_CONNECT_MDS_SCHEMA=mydbadmin/mypassword@db1234
DB_CONNECT_OCS_SCHEMA=mydbadmin/mypassword@db1234
DB_CONNECT_DISCUSSIONS_SCHEMA=mydbadmin/mypassword@db1234
DB_CONNECT_ACTIVITIES_SCHEMA=mydbadmin/mypassword@db1234
DB_CONNECT_PORTLET_SCHEMA=mydbadmin/mypassword@db1234

##Database schemas to export

##Identify source database schemas to export
##For back up scripts, specify source schema names here.
##
EXP_WEBCENTER_SCHEMA=myprefix_WEBCENTER
EXP_MDS_SCHEMA=myprefix_MDS
EXP_DISCUSSIONS_SCHEMA=myprefix_DISCUSSIONS
EXP_DISCUSSIONS_CRAWLER_SCHEMA=myprefix_DISCUSSIONS_CRAWLER
EXP_OCS_SCHEMA=myprefix_OCS
EXP_ACTIVITIES_SCHEMA=myprefix _ACTIVITIES
EXP_PORTLET_SCHEMA=myprefix_PORTLET

##Specify information for WLST export commands

##Specify general WLST information
##For backup scripts, specify details for the source system here
##
## WLST_ADMIN_USER     Name of the admin user connecting WLST to the Admin Server
## WLST_ADMIN_PASSWORD Password of the admin user
## WLST_ADMIN_CONSOLE  Host name and port of the Admin Server. Use the format:
##                     protocol://listen_address:listen_port
## WLST_LOCATION   Location of the WLST script. You must run WebCenter Portal WLST
##                 commands from your WebCenter Portal Oracle home directory
##                 (WCP_ORACLE_HOME/common/bin/wlst.sh)
## WLST_SCRIPT_LOCATION Location of the back up script (wlst_script.py)
## WCP_SERVER_NAME Name of the managed server on which the WebCenter Portal
##                 application (webcenter) is deployed
##
WLST_ADMIN_USER=mywlstadmin
WLST_ADMIN_PASSWORD=mypassword
WLST_ADMIN_CONSOLE=t3://myhost.com:24647
WLST_LOCATION=/scratch/aime1/mywork/mymw/mywcp/common/bin
WLST_SCRIPT_LOCATION=/scratch/aime1/mywebcenterportal_scripts/wlst_script.py
WCP_SERVER_NAME=WC_Spaces

## Specify information for security export
## (Policy store and credential store)
## Provide details about the security configuration file (jps-config.xml).
## For backup scripts, specify details about the source jps-config.xml here
##
## JPS_CONFIG_FILE              Location of the configuration file relative to
##                              the directory from which WLST commands run
## SRC_JPS_CONTEXT_POLICYSTORE  Name of a jps-context in the configuration file,
##                              where the source policy store is specified
## TGT_JPS_CONTEXT_POLICYSTORE  Name of another jps-context in the configuration
##                              file, where the target policy store is specified
## SRC_JPS_CONTEXT_CREDSTORE    Name of a jps-context in the configuration file,
##                              where the source credential store is specified
## TGT_JPS_CONTEXT_CREDSTORE  Name of another jps-context in the configuration
##                            file, where the target credential store is specified
## POLICYSTORE_FILE_NAME      Name and location of the policy store that you
##                            wamt to back up (as specified in JPS_CONFIG_FILE)
## CREDSTORE_FILE_NAME        Name and location of the credential store that you
##                            want to back up (location is as specified in
##                            JPS_CONFIG_FILE, with the file name cwallet.sso)
##
JPS_CONFIG_FILE=/scratch/aime1/mywork/mymw/user_projects/domains/MyDomainHome/config/fmwconfig/mybackup-jps-config.xml
SRC_JPS_CONTEXT_POLICYSTORE=mysourcePolicy
TGT_JPS_CONTEXT_POLICYSTORE=mytargetPolicy
SRC_JPS_CONTEXT_CREDSTORE=mysourceCred
TGT_JPS_CONTEXT_CREDSTORE=mytargetCred
POLICYSTORE_FILE_NAME=/scratch/aime1/mywebcenterportal_scripts/backup/backup-system-jazn-data.xml
CREDSTORE_FILE_NAME=/scratch/aime1/mywebcenterportal_scripts/backup/cwallet.sso

例41-15 サンプル・リストア・スクリプトのプロパティ: restore.properties

## restore.properties for restoring WebCenter Portal from a backup
## Specify valid values for your environment
############ User Input Required #############

##OPERATION - Specify either export or import
##  For backup scripts, specify OPERATION=export
##  For restore scripts, specify OPERATION=import
##
OPERATION=import

##Specify database information
##  For restore scripts, specify target database details here
##
##   DATA_DIRECTORY    Location on the file system that contains the backup
##                     files you want to restore
##   DB_ORACLE_HOME    Database home directory
##   DB_ADMIN_USER     Database admin user
##   DB_ADMIN_PASSWORD Password for the database admin user
##   DB_SID            Database SID
##
DATA_DIRECTORY=/scratch/aime1/mywebcenterportal_scripts/mybackups/2013.05.30-08.39.28
DB_ORACLE_HOME=/scratch/aime1/mywork/db1234
DB_ADMIN_USER=mydbadmin
DB_ADMIN_PASSWORD=mypassword
DB_SID=db1234

##Specify WebCenter Content vault and weblayout file location information
##  For restore scripts, specify the target directories here
##
WCC_VAULT_LOC=/scratch/aime1/mywork/mymw/user_projects/domains/myDomainHome/ucm/cs
WCC_WEBLAYOUT_LOC=/scratch/aime1/mwork/mymw/user_projects/domains/myDomainHome/ucm/cs

##Specify information for WLST import commands

##Specify general WLST information
## For restore scripts, specify details for the target system here
##
## WLST_ADMIN_USER     Name of the admin user connecting WLST to the Admin Server
## WLST_ADMIN_PASSWORD Password of the admin user
## WLST_ADMIN_CONSOLE  Host name and port of the Admin Server. Use the format:
##                     protocol://listen_address:listen_port
## WLST_LOCATION   Location of the WLST script. You must run WebCenter Portal WLST
##                 commands from your WebCenter Portal Oracle home directory
##                 (WCP_ORACLE_HOME/common/bin/wlst.sh)
## WLST_SCRIPT_LOCATION Location of the restore script (wlst_script.py)
## WCP_SERVER_NAME Name of the managed server on which the WebCenter Portal
##                 application (webcenter) is deployed
##
WLST_ADMIN_USER=mywlstadmin
WLST_ADMIN_PASSWORD=mypassword
WLST_ADMIN_CONSOLE=t3://myhost.com:24647
WLST_LOCATION=/scratch/aime1/mywork/mymw/mywcp/common/bin
WLST_SCRIPT_LOCATION=/scratch/aime1/mywebcenterportal_scripts/wlst_script.py
WCP_SERVER_NAME=WC_Spaces

## Specify information for security import
## (Policy store and credential store)
## Provide details about the security configuration file (jps-config.xml).
## For restore scripts, specify details about the target jps-config.xml here
##
## JPS_CONFIG_FILE              Location of the configuration file relative to
##                              the directory from which WLST commands run
## SRC_JPS_CONTEXT_POLICYSTORE  Name of a jps-context in the configuration file,
##                              where the source policy store is specified
## TGT_JPS_CONTEXT_POLICYSTORE  Name of another jps-context in the configuration
##                              file, where the target policy store is specified
## SRC_JPS_CONTEXT_CREDSTORE    Name of a jps-context in the configuration file,
##                              where the source credential store is specified
## TGT_JPS_CONTEXT_CREDSTORE  Name of another jps-context in the configuration
##                            file, where the target credential store is specified
## POLICYSTORE_FILE_NAME      Name and location of the policy store that you
##                            wamt to restore (as specified in JPS_CONFIG_FILE)
## CREDSTORE_FILE_NAME        Name and location of the credential store that you
##                            want to restore (location is as specified in
##                            JPS_CONFIG_FILE, with the file name cwallet.sso)
##
JPS_CONFIG_FILE=/scratch/aime1/mywork/mymw/user_projects/domains/MyDomainHome/config/fmwconfig/restore-jps-config.xml
SRC_JPS_CONTEXT_POLICYSTORE=mysourcePolicy
TGT_JPS_CONTEXT_POLICYSTORE=mytargetPolicy
SRC_JPS_CONTEXT_CREDSTORE=mysourceCred
TGT_JPS_CONTEXT_CREDSTORE=mytargetCred
POLICYSTORE_FILE_NAME=/scratch/aime1/mywebcenterportal_scripts/mybackups/2013.05.30-08.39.2/backup-system-jazn-data.xml
CREDSTORE_FILE_NAME=/scratch/aime1/mywebcenterportal_scripts/mybackups/2013.05.30-08.39.28/cwallet.sso

41.8.2 スクリプトを使用したWebCenter Portalのバックアップ

この項では、スクリプト・ファイルを使用してWebCenter Portalバックアップを設定、検証およびスケジュールする方法について説明します。

1. バックアップ・スクリプトを作成します(初回のみ)。

2. セキュリティ・ストアのバックアップの前提条件タスクを完了します(初回のみ)。

3. バックアップ・パラメータを設定してスクリプトをカスタマイズします(初回のみ)。

4. バックアップ・スクリプトを実行します。

5. バックアップ・アーカイブを検証します。

6. スクリプトを使用して定期的なバックアップのスケジュールを設定します。

バックアップ・スクリプトの作成

(初回のみ)

1. スクリプトとバックアップ用のディレクトリをファイル・システムに作成します。
例: /scratch/aime1/mywebcenterportal_scripts/backups

2. 例41-12「サンプル・スクリプト: master_script.sh」のコードをコピーしてテキスト・エディタに貼り付け、ファイルの名前をmaster_script_backup.shにして、手順1で作成したディレクトリに保存します。

注意:
UNIXまたはLinuxで実行する場合、スクリプトに非表示の文字やDOSの文字が含まれないようにしてください。

3. 例41-13「サンプル・スクリプト: wlst_script.py」のコードをコピーしてテキスト・エディタに貼り付け、ファイルの名前をwlst_script.pyにして同じディレクトリに保存します。

4. 例41-14「サンプル・バックアップ・スクリプトのプロパティ: backup.properties」のコードをコピーしてテキスト・エディタに貼り付け、ファイルの名前をbackup.propertiesにして同じディレクトリに保存します。

セキュリティ・ストアのバックアップの前提条件タスクの完了

(初回のみ)

ソース環境で次のようにします。

1. バックアップ・スクリプト用にjps-config.xmlファイルのコピーを作成します。
このファイルは、次の場所にあります。

SOURCE_DOMAIN_HOME/config/fmwconfig/jps-config.xml

コピーにmybackup-jps-config.xmlのような名前を付けて、同じ場所に保存します。例: /scratch/aime1/mywork/mymw/user_projects/domains/MyDomainHome/config/fmwconfig/mybackup-jps-config.xml

2. ポリシー・ストアをバックアップするためのソース情報とターゲット情報を次のように構成します。

1. ターゲットのポリシー・ストアをポイントするには、(閉じタグ</serviceInstances>の上に)次のセクションを追加します。

<serviceInstance
name="policystore.backup.xml"
provider="policystore.xml.provider"
location="<some_location>/mybackup-system-jazn-data.xml">
<description>File Based Policy Store Service Instance</description>
</serviceInstance>

バックアップ・スクリプトがアクセスできる場所ならどこでも選択できます。例:

/scratch/aime1/mywebcenterportal_scripts/backups/backup-system-jazn-data.xml

この場合、backup-system-jazn-data.xmlは、次の場所にあるsystem-jazn-data.xmlのコピーです。

/scratch/aime1/mywork/mymw/user_projects/domains/MyDomainHome/config/fmwconfig/

2. (閉じタグ</jpsContexts>の上で)次のエントリを追加して構成します。

<jpsContext name="mysourcePolicy">
<serviceInstanceRef ref="policystore.ldap"/>
</jpsContext>

<jpsContext name="mytargetPolicy">
<serviceInstanceRef ref="policystore.backup.xml"/>
</jpsContext>

3. 資格証明ストアをバックアップするためのソース情報とターゲット情報を次のように構成します。

1. ターゲットの資格証明ストアをポイントするには、(閉じタグ</serviceInstances>の上に)次のセクションを追加します。

<serviceInstance
name="credstore.backup.xml"
provider="credstore.xml.provider"
location="<some_location>">
<description>File Based Credential Store Service Instance</description>
</serviceInstance>

バックアップ・スクリプトがアクセスできる場所ならどこでも選択できます。例: /scratch/aime1/mywebcenterportal_scripts/backups。

2. (閉じタグ</jpsContexts>の上で)次のエントリを追加して構成します。

<jpsContext name="mysourceCred">
<serviceInstanceRef ref="credstore.ldap"/>
</jpsContext>

<jpsContext name="mytargetCred">
<serviceInstanceRef ref="credstore.backup.xml"/>
</jpsContext>

バックアップ・パラメータの設定およびスクリプトのカスタマイズ

(初回のみ)

1. テキスト・エディタでbackup.propertiesを開きます。

2. OPERATION=exportであることを確認します。

3. ファイルでパラメータの値を指定します。
各パラメータの説明については、表41-5を参照してください。

注意:
不要なパラメータはコメント・アウトできます。

4. 必要に応じて、バックアップ・スクリプトをカスタマイズします。
オブジェクトを除外するには、関連するバックアップ・コマンドのコードをコメント・アウトします。スクリプトを使用して追加のオブジェクトをバックアップするには、必要なコードを追加します。

5. 変更を保存します。

バックアップ・スクリプトの実行

1. 次の環境変数を設定します。
ORACLE_HOME

ORACLE_SID

TNS_ADMIN

2. バックアップ・プロセスで使用されるすべてのディレクトリの読取り権限と書込み権限を保持していることを確認します。

3. マスター・バックアップ・スクリプトを実行して、バックアップ・プロパティ・ファイルの名前とログ・ファイルの名前を次のように指定します。

sh master_backup_script_name backup_properties_file_name log_file_name

例:

sh master_script_backup.sh backup.properties mybackup.log

「Backup completed successfully...」というメッセージは、バックアップ・プロセスが完了したことを示し、バックアップとexport.logファイルを配置するディレクトリが表示されます。

スクリプトを実行するたびに、バックアップ・データは、以前のバックアップが保持されるように、メイン・バックアップ・フォルダ(DATA_DIRECTORY)の下にある別のフォルダに保存されます。タイムスタンプ情報はバックアップ・フォルダ名に含まれるため、バックアップと特定の日時との関連付けが容易です。

バックアップ・アーカイブの検証

1. データのバックアップを含むディレクトリ、つまり、backup.propertiesでDATA_DIRECTORYパラメータに指定した場所の下にあるタイムスタンプのフォルダに移動します。

2. 次のバックアップ・ファイルが使用できることを確認します。

- 1つ以上の.dmpファイル

- wcc_vault.tar

- wcc_weblayout.tar

- portletdata.ear

- backup-system-jazn-data.xml

- cwallet.sso

- audit.xml

- .log file

スクリプトを使用した定期的なバックアップのスケジュール設定

データのバックアップをmaster_script_backup.shで正常に作成することでバックアップ・スクリプト構成を検証したら、バックアップを定期的にスケジュール設定することをお薦めします。

スクリプトを実行するたびに、バックアップ・データは、以前のバックアップが保持されるように、メイン・バックアップ・フォルダ(DATA_DIRECTORY)の下にある別のフォルダに保存されます。

データのバックアップ時のデータ整合性の問題を最小限に抑えるには、ピーク使用時にバックアップのスケジュールを設定しないことをお薦めします。

41.8.3 スクリプトを使用したWebCenter Portalのバックアップからのリストア

この項では、スクリプト・ファイルを使用して、WebCenter Portalインストールをバックアップからリストアする方法について説明します。

1. リストア・スクリプトを作成します(初回のみ)。

2. セキュリティ・ストアのリストアの前提条件タスクを完了します(初回のみ)。

3. リストア・スクリプトのパラメータを設定します(初回のみ)。

4. データベース・スキーマを手動でリストアします。

5. リストア・スクリプトを実行します。

6. リストアされたデータを検証します。

リストア・スクリプトの作成

(初回のみ)

1. (「スクリプトを使用したWebCenter Portalのバックアップ」の手順に従い)前に作成したバックアップ・スクリプトmaster_script.shおよびwlst_script.pyを複製して、これらを別の場所にコピーします。
例: /scratch/aime1/mywebcenterportal_scripts/restore

2. 例41-15「サンプル・リストア・スクリプトのプロパティ: restore.properties」のコードをコピーしてテキスト・エディタに貼り付け、ファイルの名前をrestore.propertiesにして同じディレクトリに保存します。

3. 必要に応じて、ファイルの名前を変更します。
例: master_script_restore.sh、wlst_restore_script.py、restore.properties

手動によるデータベース・スキーマのリストア

1. すべてのターゲット・スキーマがRCUを使用して作成され、ターゲット・スキーマの名前がソース・スキーマの名前と一致することを確認します。

2. (オプション)。デフォルトのデータ・ソースを別のスキーマにポイントする場合は、WebLogic Server管理コンソールを使用して、スキーマ名とデータベースの詳細を更新します。

3. すべてのサーバーを停止します。

4. 必要に応じて、スキーマ・データをリストアします。

重要:
データベース・スキーマWEBCENTERおよびMDSは、データが同期するように一緒にリストアする必要があります。
PORTLETやOCSなどのスキーマを追加でリストアする必要がある場合、データ整合性を維持するには、これらを同時に(WEBCENTERとMDSの後)同じポイントでリストアしておく必要があります。

この例では、WEBCENTERスキーマとMDSスキーマをリストアするコマンドを示します。

./sqlplus "sys/password@serviceid as sysdba"
create or replace directory dmpdir as 'mydmpdirectory';
GRANT read,write ON directory dmpdir TO public;

##Drop WEBCENTER and MDS schemas ##

drop user srcprefix_WEBCENTER cascade;
drop user srcpreix_MDS cascade;
exit;
./impdp \"sys/password@serviceid as sysdba\" directory=dmpdir dumpfile=webcenterportal.dmp SCHEMAS=srcprefix_WEBCENTER
./impdp \"sys/password@serviceid as sysdba\" directory=dmpdir dumpfile=mds.dmp SCHEMAS=srcprefix_MDS

ここで:

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベースの一意のSIDです。たとえば、mydb1234のように指定します。

- directoryは、ダンプ・ファイルを配置するデータベース・マシン上の場所です。

- dumpfileは、インポートするデータを含むファイルの名前です。

- SCHEMASは、ターゲット・スキーマを識別します。スキーマの名前は、インストール時に使用されたRCU接尾辞(_WEBCENTERと_MDS)に、ユーザーが指定した接頭辞を加えたものになります。例: DEV_WEBCENTER。
ソースとターゲットのスキーマ名は一致している必要があります。たとえば、両方のスキーマの名前をDEV_WEBCENTERとします。

例:

./sqlplus "sys/mypassword@db1234 as sysdba"
create or replace directory dmpdir as '/scratch/mywebcenterportal_scripts/backup/2013.05.04-02.36.48';
GRANT read,write ON directory dmpdir TO public;

##Drop WEBCENTER and MDS schemas ##

drop user DEV_WEBCENTER cascade;
drop user DEV_MDS cascade;
exit;
./impdp \"sys/mypassword@db1234 as sysdba\" directory=dmpdir dumpfile=wcdmp.dmp SCHEMAS=DEV_WEBCENTER
./impdp \"sys/mypassword@db1234 as sysdba\" directory=dmpdir dumpfile=mdsdmp.dmp SCHEMAS=DEV_MDS

注意:
DISCUSSIONS、PORTLETS、ACTIVITIESおよびOCSなど、他のスキーマをリストアする必要がある場合は、サーバーを起動する前に行います。

5. すべてのサーバーを起動します。

セキュリティ・ストアのリストアの前提条件タスクの完了

(初回のみ)

ターゲット環境で次のようにします。

1. リストア・スクリプト用にjps-config.xmlファイルのコピーを作成します。
このファイルは、次の場所にあります。

TARGET_DOMAIN_HOME/config/fmwconfig/jps-config.xml

コピーにmyrestore-jps-config.xmlのような名前を付けて、同じ場所に保存します。例: /scratch/aime1/mywork/mymw/user_projects/domains/MyDomainHome/config/fmwconfig/myrestore-jps-config.xml

2. ポリシー・ストアをリストアするためのソース情報とターゲット情報を次のように構成します。

1. ソースのポリシー・ストアをポイントするには、(閉じタグ</serviceInstances>の上に)次のセクションを追加します。

<serviceInstance
name="policystore.backup.xml"
provider="policystore.xml.provider"
location="<some_location>/mybackup-system-jazn-data.xml">
<description>File Based Policy Store Service Instance</description>
</serviceInstance>

指定した場所には、リストアする、以前にバックアップされたポリシー・ストアが含まれている必要があります。例: /scratch/aime1/mywebcenterportal_scripts/backups/2013.06.19-09.20.14/backup-system-jazn-data.xml

2. (閉じタグ</jpsContexts>の上で)次のエントリを構成します。

<jpsContext name="targetPolicy">
<serviceInstanceRef ref="policystore.ldap"/>
</jpsContext>

<jpsContext name="sourcePolicy">
<serviceInstanceRef ref="policystore.backup.xml"/>
</jpsContext>

3. 資格証明ストアをリストアするためのソース情報とターゲット情報を次のように構成します。

1. ソースの資格証明ストアをポイントするには、(閉じタグ</serviceInstances>の上に)次のセクションを追加します。

<serviceInstance
name="credstore.backup.xml"
provider="credstore.xml.provider"
location="<some_location>">
<description>File Based Credential Store Service Instance</description>
</serviceInstance>

指定した場所には、リストアする、以前にバックアップされた資格証明ストア(cwallet.sso)が含まれている必要があります。例: /scratch/aime1/mywebcenterportal_scripts/backups/2013.06.19-09.20.14。

2. (閉じタグ</jpsContexts>の上で)次のエントリを構成します。

<jpsContext name="targetCred">
<serviceInstanceRef ref="credstore.ldap"/>
</jpsContext>

<jpsContext name="sourceCred">
<serviceInstanceRef ref="credstore.backup.xml"/>
</jpsContext>

リストア・スクリプトのパラメータの設定

(初回のみ)

1. テキスト・エディタでrestore.propertiesを開きます。

2. OPERATION=importであることを確認します。

3. ファイルですべてのパラメータの値を指定します。
各パラメータの説明については、表41-5を参照してください。

4. 変更を保存します。

リストア・スクリプトの実行

1. 次の環境変数を設定します。
ORACLE_HOME

ORACLE_SID

TNS_ADMIN

2. リストア・プロセスで使用されるすべてのディレクトリの読取り権限と書込み権限を保持していることを確認します。

3. マスター・リストア・スクリプトを実行して、リストア・プロパティ・ファイルの名前とログ・ファイルの名前を次のように指定します。

sh master_restore_script_name bestore_properties_file_name log_file_name

例:

sh master_script_restore.sh backup.properties myrestore.log

「Restoration completed successfully...」というメッセージは、リストア・プロセスが完了したことを示し、restore.logファイルを配置するディレクトリが表示されます。

リストアされたデータの検証

WebCenter Portalインストールを確認します。

1. 1つ以上のデータベース・スキーマをインポートする場合、それらのデータベースをシャットダウンして再起動し、すべての管理対象サーバーを再起動します。

2. ターゲットのWebCenter Portalインスタンスに、リストアされたデータが含まれていることを検証します。

41.9 WebCenter Portal環境のクローニング

クローニングにより、既存のWebCenter Portal環境に基づいて新しいWebCenter Portal環境が作成されます。WebCenter Portalインストールのインストール、構成、カスタマイズ、検証を行うことができ、システムが安定している場合、すべてのコンポーネントとその構成をソース環境からコピーして別の環境を作成できます。これにより、ソース環境に組み込んでテストしたすべての変更を再実行する必要がないため、時間が節約されます。詳細は、管理者ガイドのターゲット環境へのOracle WebCenter Portalの移動に関する項を参照してください。

第IX部

ライフ・サイクル: Portal Frameworkアプリケーション

『Oracle WebCenter Portalの管理』のこの部では、Portal Frameworkアプリケーションのライフサイクル操作について説明します。

第IX部の内容は次のとおりです。

- 第42章「Portal Frameworkアプリケーションのデプロイ」

- 第43章「管理コンソールを使用したPortal Frameworkアプリケーションの管理」

- 第44章「Portal Frameworkアプリケーションのエクスポート、インポート、バックアップおよびリカバリの管理」

多くの様々な人がPortal Frameworkアプリケーションのライフ・サイクルに関与します。このガイドでは、ポータル・アプリケーションのデプロイ、構成および管理に主要な責任を持つ管理者が実行するライフ・サイクルのタスクについてのみ説明します。Portal Frameworkアプリケーションをそのライフ・サイクル全体を通して管理するツールおよび手法の概要は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「WebCenter Portal Frameworkアプリケーション・ライフ・サイクルの理解」を参照してください。

42 Portal Frameworkアプリケーションのデプロイ

この章では、Oracle JDeveloperで作成したEnterprise Archive、つまりEARファイルからのPortal Frameworkアプリケーションのデプロイ、アンデプロイおよび再デプロイについて説明します。

- 第42.1項「Portal Frameworkアプリケーションのデプロイ」

- 第42.2項「Portal Frameworkアプリケーションのアンデプロイ」

- 第42.3項「Portal Frameworkアプリケーションの再デプロイ」

- 第42.4項「デプロイ後の構成」

EARファイルの作成方法の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のWebLogic管理対象サーバーへのPortal Frameworkアプリケーションのデプロイに関する項を参照してください。

この章には、Oracle WebCenter Portalの初期設定のポータル・アプリケーション「WebCenter Portal」のデプロイおよびインストールに関する手順は含まれていません。WebCenter Portalおよびその関連コンポーネントのインストールの詳細は、『Oracle WebCenter Portalインストレーション・ガイド』の「Oracle WebCenter Portalのインストール」を参照してください。WSRPおよびPDK-Javaのポートレット・プロデューサ・アプリケーションのデプロイの詳細は、第21.11項「ポートレット・プロデューサ・アプリケーションのデプロイ」を参照してください。

権限:
この章のタスクを実行するには、次のロールが付与されている必要があります。

- WebLogic Server: Oracle WebLogic Server管理コンソールを使用して付与される、AdminロールまたはDeployerロール。

- Portal Frameworkアプリケーション: 管理コンソールを使用して付与される、Administratorロール。

第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

42.1 Portal Frameworkアプリケーションのデプロイ

この項では、JDeveloperで作成されたPortal Frameworkアプリケーションを本番ドメインにデプロイするために必要な手順について説明します。この項のデプロイ手順では、EARファイルをデプロイすること、その場所が判明していること、およびデプロイ先のドメインが存在することを前提としています。

WebLogic Serverドメインの作成方法の詳細は、『Oracle WebCenter Portalインストレーション・ガイド』の新しいドメインの作成に関する項を参照してください。アプリケーションのデプロイの詳細は、Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイを参照してください。

この項には次のトピックが含まれます:

- 第42.1.1項「デプロイメント・ロードマップ」

- 第42.1.2項「デプロイメントの前提条件」

- 第42.1.3項「アプリケーションEARファイルの準備」

- 第42.1.4項「管理対象サーバーの作成」

- 第42.1.5項「メタデータ・サービス・リポジトリの作成および登録」

- 第42.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」

- 第42.1.7項「カスタマイズおよびデータの環境間の移行」

- 第42.1.8項「分散環境で実行するためのアプリケーションの構成」

42.1.1 デプロイメント・ロードマップ

この項のフロー・チャートと表は、Portal FrameworkアプリケーションをOracle WebLogic管理対象サーバーにデプロイするための前提条件と必要なタスクの概要を示しています。図42-1に、Portal Frameworkアプリケーションのデプロイ手順およびそれらを実行するロールを示します。

図42-1 管理対象サーバーへのPortal Frameworkアプリケーションのデプロイ

表42-1に、JDeveloperからPortal Frameworkアプリケーションをデプロイするためのタスク、サブタスクおよびそれらの実行担当者を示します。

表42-1 管理対象サーバーへのPortal Frameworkアプリケーションのデプロイ

担当者

タスク

サブタスク

ノート

開発者

1. アプリケーションのパッケージ化

1.a データ・ソース・タイプの選択(データベース接続のパッケージ化)

グローバル・データ・ソースまたはアプリケーションレベルのデータ・ソースのどちらかを使用できます。

グローバル・データ・ソースを使用する場合、デプロイする前にWLS管理コンソールでデータ・ソースを作成する必要があります。

アプリケーションレベルのデータ・ソースを使用する場合、デプロイした後にWLS管理コンソールで資格証明のマッピングを追加する必要があります。

1.b アプリケーション・セキュリティ・データのパッケージ化

このサブタスクには、資格証明、アイデンティティ・データおよびアプリケーション・ポリシーのパッケージ化が含まれます。

1.c デプロイメント・プロファイルの作成

このサブタスクには、WARおよびEARのファイルの作成が含まれます。

管理者

2. ターゲット環境の準備

2.a 管理対象サーバーの作成およびプロビジョニング

2.b MDSリポジトリの作成および登録

2.c ターゲット環境の構成

2.d サーバー接続の作成

管理者

3. 管理対象サーバーへのアプリケーションのデプロイ

最終手順として、Fusion Middleware Control、WLSTまたはWLS管理コンソールのいずれかを使用して、アプリケーションを管理対象サーバーにデプロイします。

42.1.2 デプロイメントの前提条件

Portal Frameworkアプリケーションは、Oracle WebCenter PortalライブラリでプロビジョニングされるWebLogic管理対象サーバー・インスタンスにデプロイできます。

注意:
インストール中に作成した事前構成済管理対象サーバーのいずれかや管理サーバーにPortal Frameworkアプリケーションをデプロイすることはお薦めしません。Portal Frameworkアプリケーションの場合、アプリケーションをデプロイする前に新しいWLS管理対象サーバーを作成してプロビジョニングするには、『Oracle WebCenter Portalインストレーション・ガイド』の既存ドメインの拡張に関する項の手順を実行してください。ポートレット・プロデューサ・アプリケーションの場合、オプションで新しいWebLogic管理対象サーバーを作成するか、WC_Portletサーバーにデプロイできます。

デプロイする前に必要な作業は次のとおりです。

- 第42.1.3項「アプリケーションEARファイルの準備」で説明されているように、アプリケーションEARファイルを準備します。

- 第42.1.4項「管理対象サーバーの作成」で説明されているように、WebLogic管理対象サーバーを作成します。

- 第42.1.5項「メタデータ・サービス・リポジトリの作成および登録」で説明されているように、Metadata Service (MDS)リポジトリを作成して登録します。

注意:
ページ、接続またはタスク・フローなどのアーティファクトに大規模な変更が加えられた更新アプリケーションをデプロイする前に、ランタイム・カスタマイズ(JDeveloperを使用しないカスタマイズ)を削除する必要があります。

これらの手順を完了したら、第42.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」の説明に従ってアプリケーションをデプロイすることで続行してください。

42.1.3 アプリケーションEARファイルの準備

アプリケーションをデプロイする前に、まずデプロイメント・プロファイルを作成する必要があります。アプリケーションがEARファイルとしてOracle WebLogic管理対象サーバーにデプロイできるように、デプロイメント・プロファイルによって、Portal Frameworkアプリケーションおよびその関連ファイルをパッケージ化します。

アプリケーション用デプロイメント・プロファイル(およびその結果のEARファイル)の作成方法の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のFrameworkアプリケーションのパッケージ化に関する項を参照してください。

42.1.3.1 EARファイル・コンテンツ

EARファイルは、複数の情報アーティファクトをパッケージ化します。次のものが含まれます。

- アプリケーション自体: .jspx、.jarおよび.classファイルなどの各種のアプリケーションです。

- アプリケーション構成: このアプリケーション用に構成されたツール、サービスおよびプロデューサとの接続プロパティ、およびURLエンドポイントが含まれます。

- アプリケーション・メタデータ: アプリケーションのデザイン時に作成されたアプリケーション・メタデータのエクスポートです。

- ポートレット・カスタマイズ: ポートレット用のカスタマイズ設定とデータが含まれます。この情報はプロデューサ内に保持されますが、登録されたプロデューサのあるアプリケーションがパッケージ化されるときにエクスポートされます。カスタマイズ・データは、Portal Frameworkアプリケーションの残りのメタデータでパッケージ化されます。

42.1.4 管理対象サーバーの作成

Portal Frameworkアプリケーションをデプロイする前に、必要な共有ライブラリおよびMDSリポジトリが含まれているOracle WebCenter Portal Frameworkテンプレートに基づいて、WebLogic管理対象サーバーを作成する必要があります。Portal Frameworkアプリケーションがポートレット化されている場合、Oracle WebCenter Portal Custom Services Producerサーバー(WC_CustomServicesProducer)にデプロイしてください。ポートレット化されたアプリケーションは、Oracle WebCenter Portal Custom Portalサーバーにはデプロイできません。必要なポートレット・ライブラリが不足しているからです。MDSスキーマだけでなく、WebCenter PortalおよびアクティビティもOracle WebCenter Portal Custom Services ProducerサーバーおよびOracle WebCenter Portal Custom Portalサーバーがターゲットです。

新しい管理対象サーバーの作成方法の詳細は、『Oracle WebCenter Portalインストレーション・ガイド』の既存ドメインの拡張に関する項を参照してください。新しいドメインの作成方法の詳細は、『Oracle WebCenter Portalインストレーション・ガイド』の新しいドメインの作成に関する項を参照してください。

42.1.5 メタデータ・サービス・リポジトリの作成および登録

アプリケーションを管理対象サーバーにデプロイする前に、そのアプリケーション用のMetadata Service (MDS)リポジトリ・スキーマをWebLogicドメインの管理サーバー・インスタンスに作成して登録する必要がある場合があります。ターゲット・サーバー(Oracle WebCenter Portal Custom PortalサーバーまたはOracle WebCenter Portal Custom Services Producerサーバー)にはすでにMDSデータ・ソースが構成されているため、事前に構成されたサーバーMDSデータ・ソースを使用しない場合のみ、この手順が必要です。ただし、他のアプリケーションで共有している場合、新しいMDSスキーマは作成しないでください。

注意:
この項で説明しているカスタム・スキーマを使用するかわりに、WebCenter Portalのインストール時に作成されたMDSスキーマを使用してデプロイすると、これらのスキーマのデータを壊す危険性があります。

デプロイ時には、本番環境で使用できるように、EARファイルにエクスポートされた一部の構成情報およびアプリケーション・メタデータをMDSスキーマにインポートする必要があります。ターゲット・メタデータ・スキーマを選択したら、メタデータのインポートはデプロイ時に自動的に実行されます(第42.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」を参照)。

MDSスキーマは、リポジトリ作成ユーティリティ(RCU)を使用して作成します。MDSスキーマを作成したら、Fusion Middleware Controlを使用するか、WLSTを使用したコマンド行から登録する必要があります。

この項には次のサブセクションが含まれます:

- 第42.1.5.1項「リポジトリ作成ユーティリティを使用したMDSスキーマの作成」

- 第42.1.5.2項「Fusion Middleware Controlを使用したMDSスキーマの登録」

- 第42.1.5.3項「WLSTを使用したMDSスキーマの登録」

42.1.5.1 リポジトリ作成ユーティリティを使用したMDSスキーマの作成

アプリケーションをデプロイする前に、まずリポジトリ作成ユーティリティ(RCU)を使用してMDSスキーマをデータベース・サーバーのインスタンスに作成し、デプロイ先ドメインの管理サーバーに登録して、アプリケーションのメタデータもデプロイできるようにする必要があります。

次の手順を実行するときは、MDSスキーマ名と、アクセスするためのログイン資格証明を必ずメモに記録してください。この情報は、デプロイメント処理の続きの手順で必要になります。

MDSスキーマの作成するには:

1. RCU_HOME/binに移動し、次のコマンドを実行してRCUを起動します。

rcu

RCUの「ようこそ」ページが表示されます(図42-2を参照)。

図42-2 RCUの「ようこそ」ページ

2. 「次へ」をクリックします。

3. 「リポジトリの作成」ページで、「作成」を選択し、「次へ」をクリックします。
「データベース接続の詳細」ページが表示されます(図42-3を参照)。

図42-3 「データベース接続の詳細」ページ

4. 「データベース・タイプ」を選択し、「ホスト名」、「ポート」、「サービス名」、「ユーザー名」および「パスワード」に入力して、スキーマを追加するデータベースの接続詳細を指定したら、「次へ」をクリックします。

5. 「前提条件」ポップアップが表示されたら、「OK」をクリックします。
「コンポーネントの選択」ページが表示されます(図42-4を参照)。

図42-4 「コンポーネントの選択」ページ

6. 「接頭辞の新規作成」を選択して、スキーマ名に付加する接頭辞を入力します。

7. 「AS共通スキーマ」の下の「Metadata Services」コンポーネントを選択します。他のコンポーネントが選択されていないことを確認してください。

8. 「次へ」をクリックし、「前提条件」ポップアップが表示されたら、「OK」をクリックします。
「スキーマ・パスワード」ページが表示されます。

9. スキーマ・パスワードの適用方法を選択し、パスワードを入力して確認します。

10. 「次へ」をクリックします。

11. 「表領域のマップ」ページで、「次へ」をクリックします。

12. 表領域作成のプロンプトが表示されたら、「OK」をクリックし、操作が完了したら再度「OK」をクリックします。

13. 「サマリー」ページで「作成」をクリックして、スキーマを作成します。

14. 「完了サマリー」ページでスキーマの作成が正常に完了したことが確認できたら、「閉じる」をクリックします。

42.1.5.2 Fusion Middleware Controlを使用したMDSスキーマの登録

アプリケーションをデプロイする前に、ドメインに新しいMDSスキーマを登録して、管理対象サーバーで実行しているアプリケーションがアクセスできるようにする必要があります。

Fusion Middleware Controlを使用してMDSリポジトリを登録する手順は、次のとおりです。

1. Fusion Middleware Controlを開き、ターゲット・ドメインにログインします。
Fusion Middleware Controlへのログインの詳細は、第6項「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. 「ナビゲーション・ペイン」で、「ファーム」を開き、次に「WebLogicドメイン」を開きます。

3. デプロイ先のドメインを選択します。

4. 「WebLogicドメイン」メニューから「メタデータ・リポジトリ」を選択します。
「メタデータ・リポジトリ」ページが表示されます(図42-5を参照)。

図42-5 「メタデータ・リポジトリ」ページ

5. 「データベース・ベース・リポジトリ」セクションで、「登録」をクリックします。
「データベース・ベースのメタデータ・リポジトリの登録」ページが表示されます(図42-6を参照)。

図42-6 「データベース・ベースのメタデータ・リポジトリの登録」ページ

6. 「データベース接続」セクションで、次の情報を入力します。

- データベース: データベースのタイプを選択します。

- ホスト名: ホストの名前を入力します。

- ポート: データベースのポート番号を入力します(例: 1521)。

- サービス名: データベースのサービス名を入力します。データベースのデフォルトのサービス名は、orclなどのデータベース名、およびexample.comなどのドメイン名で構成されるグローバル・データベース名です。この場合、orcl.example.comがサービス名になります。

- ユーザー名: SYSDBAロールが割り当てられた、データベースのユーザー名を入力します(例: SYS)。

- パスワード: ユーザーのパスワードを入力します。

- ロール: データベースのロールを選択します(例: SYSDBA)。

7. 「問合せ」をクリックします。
データベースで使用可能なスキーマおよびそれらのメタデータ・リポジトリのリストがある表が表示されます。

8. リポジトリを選択し、次の情報を入力します。

- リポジトリ名: MDSスキーマの名前を入力します。

- スキーマ・パスワード: スキーマを作成したときに指定したスキーマ・パスワードを入力します。

9. 「OK」をクリックします。
リポジトリが、Oracle WebLogic Serverドメインに登録されます。

42.1.5.3 WLSTを使用したMDSスキーマの登録

データベース・ベースのMDSリポジトリは、WLSTを使用して、コマンド行からregisterMetadataDBRepositoryコマンドを実行することによっても登録できます。

WLSTを使用してMDSスキーマを登録する手順は、次のとおりです。

1. 第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」の説明に従って、WLSTを起動します。

2. 次のコマンドを使用して、MDSスキーマを登録します。

registerMetadataDBRepository(name='mds_name', dbVendor='db_vendor', host='host_name', port='port_number',
dbName='db_name', user='username', password='password', targetServers='target_server')

ここで:

- mds_nameは、登録するMDSスキーマの名前です。

- db_vendorは、使用されるデータベースのベンダーです。

- host_nameは、データベース・サーバーの完全修飾サーバー名です。

- port_numberは、データベース・サーバーのポート番号です。

- db_nameは、MDSの格納に使用されるデータベースの名前です。

- usernameは、データベース・スキーマのユーザー名です。

- passwordは、データベース・スキーマのパスワードです。

- target_serverは、ターゲット・サーバーの名前です。複数のターゲットの場合、ターゲット・サーバーの名前をカンマで区切ってください。必ずターゲットのリストにWLS管理サーバーを含めて、アプリケーションをデプロイするときにMDSデータベース・リポジトリ名が「デプロイ・プラン」ダイアログに表示されるようにします。

たとえば、example.comというホスト名のターゲット・サーバーserver1上のOracleデータベースorclにMDSスキーマmds1を登録するには、次のコマンドを実行してください。

registerMetadataDBRepository(name='mds1', dbVendor='ORACLE', host='example.com',
port='1521',dbName='orc1', user='username', password='password',  targetServers='server1','AdminServer')

42.1.6 WebLogic管理対象サーバーへのアプリケーションのデプロイ

表42-2に、様々なアプリケーションのデプロイ先の管理対象サーバーをリストします。

JDeveloperで作成されたPortal Frameworkアプリケーションの場合、デプロイする前に、『Oracle WebCenter Portalインストレーション・ガイド』の既存ドメインの拡張に関する項の説明に従って、新しいOracle WebCenter Portal Custom Portalサーバー、あるいはポートレット化されている場合はOracle WebCenter Portal Custom Services Producerサーバーを作成してプロビジョニングします。

表42-2 デプロイ・ターゲット

アプリケーション・タイプ

管理対象サーバー名

Portal Frameworkアプリケーション

WC_CustomPortal

WebCenter Portal Portlet Producerアプリケーション

WC_CustomServicesProducer

WebCenter Portal Portlet Producerアプリケーション以外

WC_Portlet

ポートレット・プロデューサ・アプリケーションの場合、管理対象サーバー・インスタンスを作成するか、WC_Portletサーバーにデプロイできます。

注意:
インストール中に作成した事前構成済管理対象サーバーのいずれかや管理サーバーにPortal Frameworkアプリケーションをデプロイすることはお薦めしません。

Portal Frameworkアプリケーションをデプロイできる方法は複数あります。それらの方法について次の項で説明します。

- 第42.1.6.1項「情報アーティファクト・ストアの選択」

- 第42.1.6.2項「データ・ソースの選択」

- 第42.1.6.3項「Oracle JDeveloperを使用したアプリケーションのデプロイ」

- 第42.1.6.4項「Fusion Middleware Controlを使用したアプリケーションのデプロイ」

- 第42.1.6.5項「WLSTを使用したアプリケーションのデプロイ」

- 第42.1.6.6項「WLS管理コンソールを使用したアプリケーションのデプロイ」

- 第42.1.6.7項「デプロイ・プランの保存と再利用」

42.1.6.1 情報アーティファクト・ストアの選択

第42.1.3項「アプリケーションEARファイルの準備」で説明したように、パッケージ化されたEARファイルは、アプリケーション・バイナリ、アプリケーション構成、アプリケーション・メタデータおよびポートレット・カスタマイズを含めて、複数の情報アーティファクトで構成されます。

デプロイメント中に、これらの情報アーティファクトは、アプリケーションがデプロイされるインスタンスで正しい情報ストアに移動される必要があります。これらのアーティファクトのターゲット情報ストアを表42-3に示します。

表42-3 情報アーティファクトのターゲット・ストア

情報アーティファクト

ターゲット情報ストア

アプリケーション・バイナリ

ターゲット・サーバー・インスタンス

アプリケーション構成

MDS

アプリケーション・メタデータ

MDS

ポートレット・カスタマイズ

ターゲット・プロデューサ

デプロイ用に選択したツールにかかわらず、正しくデプロイするには、ターゲット情報ストアの場所を指定する必要があります。アプリケーションのデプロイは、MDSの場所が間違っていたり指定されないと失敗します。ただし、ターゲット・プロデューサが間違って指定されていてもアプリケーションはデプロイされます。ターゲット・プロデューサを間違って指定したら、ポートレットは自動的にはインポートされないため使用できません。その場合、次のいずれかを実行してください。

- Fusion Middleware Control (第21.2.1項「Fusion Middleware Controlを使用したWSRPプロデューサの登録」および第21.4.1項「Fusion Middleware Controlを使用したOracle PDK-Javaプロデューサの登録」を参照)、またはWLSTコマンド(第21.2.2項「WLSTを使用したWSRPプロデューサの登録」または第21.4.2項「WLSTを使用したOracle PDK-Javaプロデューサの登録」を参照)を使用して、デプロイ後のポートレット・プロデューサ接続を編集し、アプリケーションを再デプロイします。

- WLSTコマンドを使用して、ポートレット・カスタマイズをエクスポートおよびインポートします(第44.1項「データ移行のためのFrameworkアプリケーションのエクスポートおよびインポート」を参照)。

注意:
アプリケーションのデプロイ時に、すでに存在するターゲット・プロデューサが間違って指定された場合、間違ったプロデューサにポートレットはインポートされるため、それらのポートレットは使用できません。

42.1.6.2 データ・ソースの選択

データ・ソースには次の3つの基本オプションがあります。

- すでに存在するデータ・ソースを使用して、Oracle WebCenter Portalのカスタム・ポータル管理対象サーバーにデプロイします

- WebCenterDSやActivitiesDSの名前でないグローバル・データ・ソースを使用して、管理対象サーバーにデプロイします

- ローカル・アプリケーション・コンテキストの任意の名前のデータ・ソースを使用して、管理対象サーバーにデプロイします

この項では、これらのオプションのメリットとデメリットについて説明します。

すでに存在するデータ・ソースを使用して、Oracle WebCenter Portalのカスタム・ポータル管理対象サーバーにデプロイします

このオプションは、必要なデータ・ソースにアクセスするためのPortal Frameworkアプリケーションの有効化を最も簡単にでき、推奨デプロイメント・パスです。

すでに存在するデータ・ソースを使用してデプロイするには、JDeveloperの「アプリケーション・プロパティ・デプロイメント」画面で、「デプロイ中にweblogic-jdbc.xmlディスクリプタを自動生成および同期化」チェック・ボックスの選択を解除してください。

アプリケーションに、WebCenterDSまたはActivitiesDS (あるいはその両方)用に構成された既存データベース接続があり、それらの名前がそれぞれwebcenter/CustomPortalおよびactivities/CustomPortalではない場合、デプロイ前にデータベース接続をアプリケーションから削除するか、データベース接続を作成して命名規則に沿って名前を付ける必要があります。

WebCenterDSやActivitiesDSの名前でないグローバル・データ・ソースを使用して、管理対象サーバーにデプロイします

Oracle WebCenter Custom Portalテンプレートを使用して作成された管理対象サーバーでアプリケーションを実行しない場合、あるいはWebCenterDSまたはActivitiesDS以外の名前のカスタム・データ・ソースに対してアプリケーションを実行する場合、このデプロイメント・パスを使用します。

このオプションの場合、Portal Frameworkアプリケーションにデータベース接続があり、WEBCENTERまたはACTIVITIESのスキーマと関連付けられている必要があります。JDeveloperの「アプリケーション・プロパティ・デプロイメント」画面の「デプロイ中にweblogic-jdbc.xmlディスクリプタを自動生成および同期化」チェック・ボックスの選択は解除してください。WLSサーバーでグローバル・データ・ソースを使用する場合、JDeveloperプロジェクトでアプリケーション用に作成されたデータベース接続の名前に一致するJNDI名で作成されている必要があります。詳細は、『Oracle WebLogic Server JDBCデータ・ソースの構成と管理』のJDBCデータ・ソースの作成に関する項を参照してください。

ローカル・アプリケーション・コンテキストの任意の名前のデータ・ソースを使用して、管理対象サーバーにデプロイします

ローカル・アプリケーション・コンテキストのデータ・ソースで十分な場合、このデプロイメント・パスを使用してください。

このオプションを使用するには、WebCenterDSまたはActivitiesDS(あるいはその両方)用にデータベース接続がPortal Frameworkアプリケーションに作成されており関連付けられている必要があります。どのデータ・ソースかは、アプリケーションで使用されているツールおよびサービスに依存します。JDeveloperの「アプリケーション・プロパティ・デプロイメント」画面では、「デプロイ中にweblogic-jdbc.xmlディスクリプタを自動生成および同期化」チェック・ボックスを選択してください。

42.1.6.3 Oracle JDeveloperを使用したアプリケーションのデプロイ

WebLogic Serverにアクセスするために必要な資格証明があれば、Oracle JDeveloperを使用して、Portal Frameworkアプリケーションを開発環境からWebLogic Serverインスタンスに直接デプロイできます。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のWebLogic管理対象サーバー接続の作成に関する項および管理対象サーバーへのPortal Frameworkアプリケーションのデプロイに関する項を参照してください。

42.1.6.4 Fusion Middleware Controlを使用したアプリケーションのデプロイ

Fusion Middleware Controlを使用してPortal Frameworkアプリケーションをデプロイするには、アプリケーション・アーカイブの場所と、アプリケーションのデプロイ・プランが存在するかどうかを確認する必要があります。デプロイ・プランの詳細は、第42.1.6.7項「デプロイ・プランの保存と再利用」を参照してください。

注意:
デプロイするときに指定したメタデータ・リポジトリおよびADF接続の詳細は、デプロイ・プランの一部として格納されません。これらのデプロイ・プロパティは、アプリケーションをデプロイするたびに指定する必要があります。
更新する予定があり、アプリケーションを頻繁にデプロイするためにこれらの構成変更を保存する場合、WLSTまたはFusion Middleware Controlを使用して、デプロイ後にこれらの構成変更を行うことをお薦めします。こうした構成変更は、デプロイ・プランに保存されてMDSリポジトリに保持されるため、アプリケーションを再デプロイするときに再設定する必要はありません。

Fusion Middleware Controlを使用してPortal Frameworkアプリケーションをデプロイする手順は、次のとおりです。

1. Fusion Middleware Controlにログインします。
第6.1項「Fusion Middleware Controlコンソールの表示」を参照してください。

2. ナビゲーション・ペインで「WebLogicドメイン」を開き、ターゲットの管理対象サーバーが作成されたドメインをクリックします。

3. 「WebLogicドメイン」メニューから、「アプリケーション・デプロイメント」→「デプロイ」を選択します。
「アーカイブの選択」ページが表示されます(図42-7を参照)。

図42-7 「アーカイブの選択」ページ

4. 「アーカイブまたは展開済ディレクトリ」セクションで、次のいずれかを実行します。

- 「アーカイブはこのWebブラウザが稼働しているマシンに存在します。」を選択して、アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを探します。

- 「アーカイブまたは展開済ディレクトリはEnterprise Managerが稼働しているサーバーに存在します。」を選択して、アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを探します。

5. 「デプロイ・プラン」セクションで、次のいずれかを実行します。

- 「デプロイ構成が行われるとき、新規デプロイ・プランを作成します。」を選択し、再デプロイ処理の後に、新しいデプロイ・プランを自動的に作成します。

- 「デプロイ・プランはこのWebブラウザが稼働しているマシンに存在します。」を選択して、プランへのパスを入力するか、「参照」をクリックしてプランを探します。

- 「デプロイ・プランはEnterprise Managerが稼働しているサーバーに存在します。」を選択して、プランへのパスを入力するか、「参照」をクリックしてプランを探します。

6. 「次へ」をクリックします。
「ターゲットの選択」ページが表示されます(図42-8を参照)。

図42-8 「ターゲットの選択」ページ

7. アプリケーションをデプロイするターゲット・サーバーを選択し、「次へ」をクリックします。
「アプリケーション属性」ページが表示されます(図42-9を参照)。

図42-9 「アプリケーション属性」ページ

8. 「ターゲット・メタデータ・リポジトリ」で、「メタデータ・リポジトリ」ウィンドウを表示するためのアイコンをクリックします。図42-10に示すように、このウィンドウからアプリケーションのリポジトリを選択できます。「リポジトリ」ドロップダウン・リストを使用して必要なリポジトリを選択し、「OK」をクリックします。

注意:
「ターゲット・メタデータ・リポジトリ」オプションは、MDSリポジトリにインポートされるメタデータがアプリケーションに含まれている場合にのみ表示されます。このオプションは、ポートレット・プロデューサ・アプリケーションの場合は表示されません。

図42-10 「メタデータ・リポジトリの選択」ウィンドウ

9. リポジトリで使用するパーティションの名前を入力します(通常はアプリケーションの名前)。各アプリケーションには、リポジトリで一意のパーティションが設定されている必要があります。

10. 「次へ」をクリックします。
「デプロイ設定」ページが表示されます(図42-11を参照)。

図42-11 「デプロイ設定」ページ

これで、ターゲットMDSの場所の指定は完了です(第42.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」を参照)。

11. 「ADF接続の構成」の「編集」アイコンをクリックして、Portal Frameworkアプリケーションに関連付けられた接続設定をチェックします。
「ADF接続の構成」ページが表示されます(図42-12を参照)。

図42-12 「ADF接続の構成」ページ

12. 接続ごとに「編集」アイコンをクリックして、接続設定がターゲット環境に対して正しいことを確認します(本番やステージングなど)。
たとえば、ディスカッション・フォーラム接続の場合(図42-13を参照)、ディスカッション・サーバーへのURL、およびサーバーとの接続に使用されるユーザー・アカウントが、ターゲット環境に対して正しいことを確認してください。

図42-13 ディスカッション・フォーラム接続の設定

WSRPプロデューサの場合、WSRPプロデューサ接続およびWebサービス接続がプロデューサごとに表示されます。通常、Webサービス接続のみターゲット・プロデューサに合せて変更する必要があります。これには4つのURLエンドポイントが含まれていますが、これらをすべて変更する必要があります。WSRPプロデューサ接続では、アプリケーション・サーバー用に、デフォルトのプロキシ設定とは個別に設定できるプロキシ設定のみ必要に応じて構成します。

EARファイルのポートレット・プロデューサへの接続を、ターゲット・デプロイ環境のプロデューサを指すように変更する必要がある場合、必ずここで変更してください。これで、アプリケーションが起動したときに、ポートレット・カスタマイズがターゲット・プロデューサにインポートされます。詳細は、第42.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」を参照してください。

注意:
アプリケーションが初めて起動したときに、接続できるターゲット・プロデューサがなかった場合、インポートは失敗します。ポートレット・プロデューサに接続できるようになったら、アプリケーションを再起動してインポートを再実行してください。
「ADF接続の構成」ページを使用してプロデューサ接続を修正しないまま間違ったプロデューサの場所(例: 開発環境のプロデューサ)を指しており、そのプロデューサが接続可能な場合、ポートレットは間違ったプロデューサにインポートされます。

デプロイ後にこれを修正するには、Fusion Middleware Control (第21.2.1項「Fusion Middleware Controlを使用したWSRPプロデューサの登録」および第21.4.1項「Fusion Middleware Controlを使用したOracle PDK-Javaプロデューサの登録」を参照)、またはWLSTコマンド(第21.2.2項「WLSTを使用したWSRPプロデューサの登録」または第21.4.2項「WLSTを使用したOracle PDK-Javaプロデューサの登録」を参照)を使用してプロデューサのURLエンドポイントを編集してから、アプリケーションを再デプロイしてください(第42.3.2項「Fusion Middleware Controlを使用したPortal Frameworkアプリケーションの再デプロイ」を参照)。

13. 必要に応じて、Webモジュールなどの追加デプロイ・オプションを指定して、アプリケーションやセキュリティ移行設定に含めます。

14. オプションで、「デプロイ・プラン」セクションの「デプロイ・プランの編集」をクリックし、現在選択しているデプロイ・プランを編集します。

15. オプションで、「デプロイ・プラン」セクションの「デプロイ・プランの保存」をクリックし、アプリケーションを再デプロイするときに再利用できるように、現在選択しているデプロイ・プランを保存します。

16. デプロイ・プロセスを開始するには、「デプロイ」をクリックします。
Fusion Middleware Controlに処理メッセージが表示されます。

17. 「正常にデプロイされました」ページで「閉じる」をクリックします。
これで、Portal Frameworkアプリケーション(およびそのデプロイ・プラン)が、WebLogic管理対象サーバー・インスタンスでデプロイされました。

18. Fusion Middleware Controlセッション中にアプリケーションをデプロイしたWebLogic管理対象サーバーを再起動する場合、「ファーム」メニューから「ファーム」をリフレッシュして、アプリケーションのステータスを更新します。

注意:
デプロイ時に接続を構成した場合、それらはデプロイ・プランの一部として格納されません。次回デプロイするときは、これらの接続詳細を再度指定する必要があります。

42.1.6.5 WLSTを使用したアプリケーションのデプロイ

WLSTコマンド行を使用してPortal Frameworkアプリケーションをデプロイするには、WLSTが管理サーバーと接続している必要があります。管理サーバーをホストしているコンピュータで、deployコマンドを起動する必要があります。

WLSTを使用してPortal Frameworkアプリケーションをデプロイする手順は、次のとおりです。

1. WLSTシェルを起動します。
WLSTシェルの起動の詳細は、第1.13.3項「Oracle WebLogic Scripting Tool (WLST)」を参照してください。

2. Oracle WebCenter Portalインストールの管理サーバーに接続します。

connect("user_name","password","host_name:port")

ここで:

- user_nameは、管理サーバーにアクセスするユーザーの名前です(例: weblogic)。

- passwordは、管理サーバーにアクセスするためのパスワードです(例: weblogic)。

- host_nameは、管理サーバーのホスト名です(例: myserver.example.com)。

- portは、管理サーバーのポート番号です(デフォルトは7001)。
次のメッセージが表示されます。

Successfully connected to Admin Server 'AdminServer' that belongs to domain 'wc_domain'.

3. 次のコマンドを実行して、MDS構成を取得します。

archive = getMDSArchiveConfig(fromLocation='ear_file_path')

ear_file_pathは、デプロイするEARファイルのパスとファイル名です(例: /tmp/myEarFile.ear)。詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のgetMDSArchiveConfigコマンドに関する項を参照してください。

4. MDS構成情報をEARファイルから取得した後、Oracle WebCenter Portalの設定に応じて、適切なMDSスキーマ情報を設定する必要があります(たとえば、アプリケーションは、特定のスキーマに基づいたデータベース接続を使用している場合があります)。MDSスキーマ情報を設定するには、次のコマンドを実行してください。

archive.setAppMetadataRepository(repository='respository',partition='partition',type='DB',jndi='jndi')

ここで:

- repositoryは、データベース・スキーマの名前です(例: mds-Feb23demo)。

- partitionは、リポジトリ内の個々のエンティティです。これによって、各アプリケーションが独自のネームスペースを持つことができます(例: webcenter)。

- jndiは、アプリケーション・サーバーの他のコンポーネントによるアクセスを可能にするために使用するパスおよび名前です(例: jdbc/mds/Feb23demo)。

5. MDSリポジトリ情報を設定した後、次のコマンドを使用してMDS構成情報を保存します。

archive.save()

6. WLSTのdeployコマンドを使用して、Portal Frameworkアプリケーションをデプロイします。

deploy(app_name, path, [targets] [stageMode], [planPath], [options])

ここで:

- appNameは、デプロイするPortal Frameworkアプリケーションの名前です(例: コンポーザWLSTApp)。

- pathは、デプロイするEARファイルへのパスです(例: /tmp/customApp.ear)。

- targetsには、アプリケーションのデプロイ先管理対象サーバーを指定します(例: CustomAppServer)。オプションで、カンマで区切れば複数のターゲットを指定できます。異なるサーバー上にアプリケーション・アーカイブの異なるモジュールをデプロイできるようにするには、たとえばmodule1@server1のように、各ターゲットをモジュール名で修飾します。この引数は、WLSTが現在接続されているサーバーにデフォルト設定されます。

- [stageMode]には、オプションで、デプロイするアプリケーションのステージング・モードを定義します。有効な値は、stage、nostageおよびexternal_stageです。

- [planPath]には、オプションで、デプロイ・プラン・ファイルの名前を定義します。ファイル名は、絶対名にすることも、アプリケーション・ディレクトリに対する相対名にすることもできます。この引数は、アプリケーション・ディレクトリ内のplan/plan.xmlファイル(存在する場合)にデフォルト設定されます。

- [options]は、オプションで、名前と値のペアとして指定したデプロイメント・オプションのカンマ区切りリストです。有効なオプションの詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のWLSTのdeployコマンドに関する項を参照してください。

次のメッセージが表示されたら、アプリケーションが正常にデプロイされて、アクセスの準備ができたことを意味します。

Completed the deployment of Application with status completed

注意:
WLSTはデプロイ時に接続変更のプロンプトを表示しないため、EARファイルの接続情報を使用して、前回の起動時のターゲット・プロデューサの場所を特定します。その場所に到達できない場合、ターゲット・プロデューサの起動およびアプリケーションの再起動を行ってアプリケーションをデプロイした後に、場所を修正してください。ポートレット・カスタマイズの移行は自動的に開始されます。
プロデューサ接続が、接続可能な間違ったプロデューサを指している場合(たとえば、開発プロデューサ)、ポートレット・カスタマイズの移行はそれらのプロデューサを使用して開始されます。間違っていても移行は完了しているため、アプリケーションを再起動しても移行処理は自動的には起動されません。

デプロイ後にこれを修正するには、Fusion Middleware Control (第21.2.1項「Fusion Middleware Controlを使用したWSRPプロデューサの登録」および第21.4.1項「Fusion Middleware Controlを使用したOracle PDK-Javaプロデューサの登録」を参照)、またはWLSTコマンド(第21.2.2項「WLSTを使用したWSRPプロデューサの登録」または第21.4.2項「WLSTを使用したOracle PDK-Javaプロデューサの登録」を参照)を使用してプロデューサのURLエンドポイントを編集してから、アプリケーションを再デプロイしてください(第42.3.2項「Fusion Middleware Controlを使用したPortal Frameworkアプリケーションの再デプロイ」を参照)。

42.1.6.6 WLS管理コンソールを使用したアプリケーションのデプロイ

WLS管理コンソールを使用すると、Portal Frameworkアプリケーションまたはポートレット・プロデューサ・アプリケーションをデプロイできます。しかし、コンソールでは、基本的なMDS接続も含め、ADF接続を変更できません。このコンソールを使用してPortal Frameworkアプリケーションをデプロイするには、EARファイルのMDS接続をターゲット・デプロイメント・リポジトリに合せて構成する必要があります。第42.1.6.5項「WLSTを使用したアプリケーションのデプロイ」の手順1-5を実行したら、次の手順を実行して、WLS管理コンソールからPortal Frameworkアプリケーションまたはポートレット・プロデューサ・アプリケーションをデプロイしてください。

注意:
インストール中に作成した事前構成済管理対象サーバーのいずれかや管理サーバーにPortal Frameworkアプリケーションをデプロイすることはお薦めしません。JDeveloperで作成されたPortal Frameworkアプリケーションの場合、デプロイする前に新しい管理対象サーバーを作成してプロビジョニングするには、『Oracle WebCenter Portalインストレーション・ガイド』の既存ドメインの拡張に関する項の手順を実行してください。ポートレット・プロデューサ・アプリケーションの場合、管理対象サーバー・インスタンスを作成するか、オプションでWC_Portletサーバーにデプロイできます。

WLS管理コンソールを使用してPortal Frameworkアプリケーションまたはポートレット・プロデューサ・アプリケーションをデプロイする手順は、次のとおりです。

1. WLS管理コンソールにログインします。
WLS管理コンソールへのログインの詳細は、第1.13.2項「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「デプロイメント」をクリックします。
「デプロイメントのサマリー」ページが表示されます(図42-14を参照)。

図42-14 デプロイメント・サマリー

3. 「デプロイメント・サマリー」ペインで、「インストール」をクリックします。
「アプリケーション・インストール・アシスタント」ページが表示されます(図42-15を参照)。

図42-15 「アプリケーション・インストール・アシスタント」ページ

4. 「アプリケーション・インストール・アシスタント」の「パス」フィールドを使用して、インストールするWebアプリケーションまたはポートレット・プロデューサ・アプリケーションに対応するEARファイルを検索します。EARファイルを選択して、「次へ」をクリックします。
「アプリケーション・インストール・アシスタント」ページの2ページ目が表示されます(図42-16を参照)。

図42-16 「アプリケーション・インストール・アシスタント」 - 2ページ目

5. 「このデプロイメントをアプリケーションとしてインストールする」(Portal Frameworkアプリケーションとポートレット・プロデューサの両方用)を選択して、「次へ」をクリックします。
「アプリケーション・インストール・アシスタント」の3ページ目が表示されます(図42-17を参照)。

図42-17 「アプリケーション・インストール・アシスタント」 - 3ページ目

6. Webアプリケーションのデプロイ先デプロイ・ターゲットを選択し、「次へ」をクリックします。

7. 指定した構成設定を確認し、「終了」をクリックしてインストールを完了します。
デプロイ後にプロデューサのURLを変更するには、Fusion Middleware Control (第21.2.1項「Fusion Middleware Controlを使用したWSRPプロデューサの登録」および第21.4.1項「Fusion Middleware Controlを使用したOracle PDK-Javaプロデューサの登録」を参照)、またはWLSTコマンド(第21.2.2項「WLSTを使用したWSRPプロデューサの登録」または第21.4.2項「WLSTを使用したOracle PDK-Javaプロデューサの登録」を参照)を使用してプロデューサのURLエンドポイントを編集してから、アプリケーションを再デプロイしてください(第42.3.2項「Fusion Middleware Controlを使用したPortal Frameworkアプリケーションの再デプロイ」を参照)。

42.1.6.7 デプロイ・プランの保存と再利用

デプロイメント・プランには、アーカイブを管理対象サーバーにデプロイするために必要な構成データが含まれています。アプリケーションの構築およびテスト時、または第42.1.6.4項「Fusion Middleware Controlを使用したアプリケーションのデプロイ」の説明に従い、Fusion Middleware Controlを使用してEARファイルをデプロイする際に、デプロイメント・プランを作成できます。EARファイル内にパッケージ化されたデプロイメント・ディスクリプタが存在する場合は、デプロイメントでこれらのファイル内のデータが使用されます。web.xmlファイルに変更を加える必要がある場合は、デプロイメント・プランを作成することをお薦めします。

作成したら、デプロイ・プランを、アプリケーション・プロパティの一部としてターゲットの管理対象サーバーに保存しておけば、アプリケーションを再デプロイするときに再利用できます。再デプロイは、第42.3.2項「Fusion Middleware Controlを使用したPortal Frameworkアプリケーションの再デプロイ」の説明に従ってFusion Middleware Controlを使用するか、第42.3.3項「WLSTを使用したPortal Frameworkアプリケーションの再デプロイ」の説明に従ってWLSTを使用して行います。

42.1.7 カスタマイズおよびデータの環境間の移行

デプロイされたアプリケーションのページ、ツールとサービス、およびポートレット(PDK-JavaおよびWSRPバージョン2のプロデューサ)に対して行われたカスタマイズは、エクスポートおよびインポートできます。詳細は、第44章「データ移行のためのPortal Frameworkアプリケーションのエクスポートおよびインポート」を参照してください。

42.1.8 分散環境で実行するためのアプリケーションの構成

分散環境で実行するためのPortal Frameworkアプリケーションの構成の詳細は、『Oracle WebCenter Portalエンタープライズ・デプロイメント・ガイド』、および高可用性ガイドの「Oracle ADFおよびOracle WebCenter Portalのための高可用性の構成」を参照してください。

42.2 Portal Frameworkアプリケーションのアンデプロイ

この項では、Fusion Middleware Controlを使用するか、WLSTを使用したコマンド行から、Portal Frameworkアプリケーションまたはポートレット・プロデューサ・アプリケーションをアンデプロイする方法について説明します。

注意:
Portal Frameworkアプリケーションをアンデプロイしても、アプリケーションを同じドメインに再デプロイするときのために、そのアプリケーションの資格証明およびMDSカスタマイズは保持されます。アプリケーションをこのドメインに再デプロイしない場合、または次のデプロイまでに初期状態にリセットする必要がある場合は、第42.2.3項「アプリケーションの資格証明マップの削除」で説明されているように、アプリケーションをアンデプロイした後に、資格証明ストアからアプリケーションの資格証明マップを削除できます。また、管理者ガイドのリポジトリからのメタデータ・パーティションの削除に関する項で説明されているように、MDSリポジトリ・パーティションも削除できます。

この項には次のサブセクションが含まれます:

- 第42.2.1項「Fusion Middleware Controlを使用したPortal Frameworkアプリケーションのアンデプロイ」

- 第42.2.2項「WLSTを使用したPortal Frameworkアプリケーションのアンデプロイ」

- 第42.2.3項「アプリケーションの資格証明マップの削除」

42.2.1 Fusion Middleware Controlを使用したPortal Frameworkアプリケーションのアンデプロイ

この項では、Fusion Middleware Controlを使用してPortal Frameworkアプリケーションをアンデプロイする方法について説明します。

Fusion Middleware Controlを使用してPortal Frameworkアプリケーションをアンデプロイする手順は、次のとおりです。

1. Fusion Middleware Controlにログインします。
第6.1項「Fusion Middleware Controlコンソールの表示」を参照してください。

2. ナビゲーション・ペインで「アプリケーション・デプロイメント」を開き、アンデプロイするアプリケーションをクリックします。

3. 「アプリケーション・デプロイメント」メニューから、「アプリケーション・デプロイメント」→「アンデプロイ」を選択します。

4. 確認ページで「アンデプロイ」をクリックします。

5. 操作が完了したら、「閉じる」をクリックします。

42.2.2 WLSTを使用したPortal Frameworkアプリケーションのアンデプロイ

この項では、WLSTを使用してPortal Frameworkアプリケーションをアンデプロイする方法について説明します。

WLSTを使用してPortal Frameworkアプリケーションをアンデプロイする手順は、次のとおりです。

1. WLSTシェルを起動します。
WLSTシェルの起動の詳細は、第1.13.3項「Oracle WebLogic Scripting Tool (WLST)」を参照してください。

2. WebCenter Portalインストールの管理サーバーに接続します。

connect("user_name","password","host_name:port")

ここで:

- user_nameは、管理サーバーにアクセスするユーザーの名前です(例: weblogic)。

- passwordは、管理サーバーにアクセスするためのパスワードです(例: weblogic)。

- host_nameは、管理サーバーのホスト名です(例: myserver.example.com)。

- portは、管理サーバーのポート番号です(デフォルトは7001)。
次のメッセージが表示されます。

Successfully connected to Admin Server 'AdminServer' that belongs to domain 'wc_domain'.

3. undeployコマンドを使用して、アプリケーションをアンデプロイします。

undeploy(app_name,[targets],[options])

ここで:

- app_nameは、デプロイされたアプリケーションのデプロイ名です。

- [targets]は、アプリケーションが削除されるターゲット・サーバーのリストです。オプション。これを指定しない場合は、現在のすべてのターゲットにデフォルト値が設定されます。

- [options]は、名前と値のペアとして指定したデプロイメント・オプションのカンマ区切りリストです。オプション。オプションの完全なリストは、deployコマンドを参照してください。

42.2.3 アプリケーションの資格証明マップの削除

Portal Frameworkアプリケーションをアンデプロイしても、そのアプリケーションの資格証明は削除されません。そのため、アンデプロイ後に、Fusion Middleware Controlを使用して、アプリケーションで使用された資格証明マップを手動で削除する必要があります。

Fusion Middleware Controlを使用してアプリケーションの資格証明マップを削除するには:

1. アプリケーションのadf-config.xmlのコンテンツを参照し、adfAppUIDの値を確認して、そのアプリケーションによって使用された資格証明マップ名を特定します。例:

<adf:adf-properties-child xmlns="http://xmlns.oracle.com/adf/config/properties">
<adf-property name="adfAppUID" value="Veeva-7209"/>
</adf:adf-properties-child>

この場合、アプリケーションによって使用された資格証明マップ名は、Veeva-7209です。

2. Fusion Middleware Controlにログインします。
Fusion Middleware Controlへのログインの詳細は、第6項「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

3. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、ターゲット・ドメイン(wc_domainなど)を選択します。

4. 「WebLogicドメイン」ドロップダウン・メニューの「セキュリティ」→「資格証明」を選択します。
「資格証明」ペインが表示されます(図42-18を参照)。

図42-18 「資格証明」ペイン

5. 資格証明マップを選択し、「削除」をクリックします。

6. 「はい」をクリックして資格証明マップの削除を確定します。

42.3 Portal Frameworkアプリケーションの再デプロイ

この項では、Fusion Middleware Controlを使用するか、WLSTを使用したコマンド行から、Portal Frameworkアプリケーションを再デプロイする方法について説明します。新しいバージョンのアプリケーションを再デプロイすると、次を変更できません。

- アプリケーションのデプロイ・ターゲット

- アプリケーションのセキュリティ・モデル

デプロイ・ターゲットまたはアプリケーションのセキュリティ設定を変更するには、アクティブなバージョンのアプリケーションを最初にアンデプロイする必要があります。アプリケーションをアンデプロイする方法の詳細は、第42.2項「Portal Frameworkアプリケーションのアンデプロイ」を参照してください。

注意:
wcps-services.earおよびwsrp-tools-as.earなどのシステム.EARファイルの中には、バージョニングされずに、再デプロイが意図されていないものもあります。これらのファイルを再デプロイするとエラーが発生します。

この項には次のサブセクションが含まれます:

- 第42.3.1項「再デプロイに関する考慮事項」

- 第42.3.2項「Fusion Middleware Controlを使用したPortal Frameworkアプリケーションの再デプロイ」

- 第42.3.3項「WLSTを使用したPortal Frameworkアプリケーションの再デプロイ」

42.3.1 再デプロイに関する考慮事項

アプリケーションを再デプロイするとき、アプリケーション・データへの変更は保持しようと考える場合がほとんどです。デプロイ後の実行時に、アプリケーションに関する3つの重要な情報が変更することがあります。

- アプリケーション構成: 接続情報が含まれます。

- アプリケーション・メタデータ: アプリケーション自体に対するカスタマイズおよびパーソナライズが含まれます。これらは、ユーザーがページを編集してコンテンツを追加するなどしたときに作成されます。

- ポートレット・プリファレンス: ポートレット・インスタンスのカスタマイズおよびパーソナライズが含まれます。

注意:
ページ、接続またはタスク・フローなどのアーティファクトに大規模な変更が加えられた更新アプリケーションを再デプロイする前に、ランタイム・カスタマイズ(JDeveloperを使用しないカスタマイズ)を削除する必要があります。

次の項では、アプリケーションに関するこれら3種類の情報を保持する方法について説明します。

- 第42.3.1.1項「アプリケーション構成の保持」

- 第42.3.1.2項「サービスおよびユーザー・カスタマイズの保持」

- 第42.3.1.3項「アセット・カスタマイズの保持」

- 第42.3.1.4項「ポートレット・カスタマイズの保持」

注意:
アプリケーション情報を保持するには、初期デプロイを使用して作成または使用された同じMDSパーティションを使用して再デプロイする必要があります。

42.3.1.1 アプリケーション構成の保持

ほとんどの場合、ツールとサービスのエンドポイントおよびポートレット・プロデューサは、本番環境よりもテスト環境またはステージング環境で異なります。そのため、アプリケーションを本番環境に再デプロイするとき、アプリケーションを再構成して、本番環境のサービスおよびプロデューサで稼働できるようにするか、以前使用された構成を再利用できるようにする必要があります。Fusion Middlewareは、MDSリポジトリに構成情報を格納することによってこれを容易にします。

アプリケーションを初めてデプロイしたとき、アプリケーション構成のベース・ドキュメントがMDSリポジトリに作成されます。この構成は、EARファイルにパッケージ化されている、アプリケーションの接続およびそれらのプロパティのすべてが含まれたセットです。デプロイ後は、本番環境の仕様に合せて、Fusion Middleware ControlまたはWLSTを使用して接続を編集する必要がある場合があります。この再構成によって、構成変更のためのカスタマイズのレイヤーがMDSリポジトリに作成されます。

アプリケーションを再デプロイすると、アプリケーションでパッケージ化された構成がベース・ドキュメントとして使用されますが、構成へのカスタマイズは保持されます。したがって、アプリケーションの再デプロイ設定は最新の構成と一致します。

ただし、カスタマイズが完全に保持されるのは、ベース・ドキュメントに変更がない場合のみです。パッケージ化された接続情報が変更されたアプリケーションを再デプロイすると、次の結果が予想されます。

- パッケージ化された構成に新しい接続が追加されます。
新しい接続は問題なく表示されます。

- パッケージ化された構成から接続が削除されます。
前回のデプロイ後にこの接続を構成した場合、デプロイ後にこの接続は表示されないため再作成する必要があります。

- パッケージ化された構成で接続プロパティが変更されます。
カスタマイズされたプロパティが使用されます。接続のカスタマイズは、プロパティ・レベルではなく、個々の接続レベルで管理されます。

42.3.1.1.1 WLSTを使用したデプロイメント全体にわたる構成の保持

WLSTコマンドを使用して、ステージ・インスタンス上でPortal Frameworkアプリケーションを構成する場合、WLSTコマンドをスクリプトを簡単に統合し、次にそのスクリプトのバリアントを使用して、本番インスタンス上に接続を再作成することができます。このアプローチを使用すると、パッケージ化された構成の詳細について心配することなく、常にターゲット構成に対してアプリケーションを再構成することができます。

42.3.1.2 サービスおよびユーザー・カスタマイズの保持

アプリケーション・メタデータは、デプロイ後の実行時にユーザーが行ったカスタマイズによって変更されます。ほとんどの場合、アプリケーションを再デプロイするとき、以前にユーザーに表示されていた環境を正確に再現できるようにカスタマイズ情報を保持する必要があります。

アプリケーションおよびユーザー・カスタマイズはMDSリポジトリに格納され、構成設定の保持に関するルールがアプリケーション・メタデータの保持にも適用します。

アプリケーションが再デプロイされると、すべてのアプリケーション・アーティファクトのベース・ドキュメントは、EARファイルにパッケージ化されているもので置換されます。ただし、カスタマイズは保持されます。ベース・アーティファクトが変更されないかぎり、この情報への影響はありません。その場合、構成設定と同じルールが適用されます。これらを次に説明します。

- 新しい要素がパッケージに追加された場合、そのまま表示されます。

- 作成されたカスタマイズの要素がパッケージから削除された場合、それらのカスタマイズは無視されます。

- 要素が変更された場合、その影響は変更内容によって異なるため、検証する必要があります。

ベスト・プラクティスに関する注意:
状況に応じて、本番アプリケーションのインスタンスにあるすべてのアプリケーションおよびユーザー・カスタマイズをエクスポートして、テストまたはステージングのインスタンスにインポートしてください。その後、それらのカスタマイズに対してアプリケーションをテストすれば、新しい変更によって意図しない影響が発生するかどうかを確認できます。

42.3.1.3 アセット・カスタマイズの保持

「アセット」ページを使用すれば、ユーザーは実行時に新しいアセットを作成できます。アプリケーションを再デプロイするとき、実行時に作成されたアセットを保持するには、再デプロイ前に、まず実行中のアプリケーションからアセットをダウンロードして、そのアーカイブ・ファイルをデザインタイム環境にインポートする必要があります。

実行時に作成されたアセットのダウンロードとインポートを実行しなかった場合、アプリケーションを再デプロイすると失われます。「アセット」ページではそれらは使用できませんが、失われたアセットを使用し実行時に作成された新しいページは使用できます。これは、新しいアセットが作成されると実行時に更新されるgeneric-site-resources.xmlファイルが、デザインタイム・バージョンのファイルによって、再デプロイ時に上書きされるためです。

42.3.1.4 ポートレット・カスタマイズの保持

ポートレット・カスタマイズは、メタデータでEARファイルにパッケージ化されます。デプロイ後にアプリケーションを起動すると、ターゲット・プロデューサへのポートレット・カスタマイズの移行が開始します。ターゲット・プロデューサは、接続カスタマイズの解決によって特定されます。再デプロイ前にプロデューサ接続を編集した場合、編集された接続がターゲット・プロデューサの特定に使用されます。事前に存在するファイルと同じチェックサム(つまり同じファイル)のEARファイルを再デプロイすると、ポートレット・カスタマイズおよびパーソナライズは上書きされません。

42.3.2 Fusion Middleware Controlを使用したPortal Frameworkアプリケーションの再デプロイ

この項では、Fusion Middleware Controlを使用してPortal Frameworkアプリケーションを再デプロイする方法について説明します。

Fusion Middleware Controlを使用してPortal Frameworkアプリケーションを再デプロイする手順は、次のとおりです。

1. Fusion Middleware Controlにログインします。詳細は、第6.1項「Fusion Middleware Controlの表示」を参照してください。

2. ナビゲーション・ペインから、ファーム、「WebLogicドメイン」、続いてドメインを開きます。

3. アプリケーションの再デプロイ先サーバーを選択し、右クリックしてメニューから「アプリケーション・デプロイメント - 再デプロイ」を選択します。
「アプリケーションの選択」ページが表示されます(図42-19を参照)。

図42-19 「アプリケーションの選択」ページ

4. 再デプロイするアプリケーションを選択します。

5. 「次へ」をクリックし、「アーカイブの選択」ページを表示します(図42-20を参照)。

図42-20 「アーカイブの選択」ページ

6. 「アーカイブまたは展開済ディレクトリ」セクションで、次のいずれかを実行します。

- 「アーカイブはこのWebブラウザが稼働しているマシンに存在します。」を選択して、アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを探します。

- 「アーカイブまたは展開済ディレクトリはEnterprise Managerが稼働しているサーバーに存在します。」を選択して、アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを探します。

7. 「デプロイ・プラン」セクションで、次のいずれかを実行します。

- 「デプロイ構成が行われるとき、新規デプロイ・プランを作成します。」を選択し、再デプロイ処理の後にデプロイ・プランを自動的に作成します。

- 「デプロイ・プランはこのWebブラウザが稼働しているマシンに存在します。」を選択して、プランへのパスを入力するか、「参照」をクリックしてプランを探します。

- 「デプロイ・プランはEnterprise Managerが稼働しているサーバーに存在します。」を選択して、プランへのパスを入力するか、「参照」をクリックしてプランを探します。

8. 「次へ」をクリックします。
「アプリケーション属性」ページが表示されます(図42-21を参照)。

図42-21 「アプリケーション属性」ページ

9. application.xmlにアプリケーションのコンテキスト・ルートを指定しなかった場合、「Webモジュールのコンテキスト・ルート」セクションで指定します。コンテキスト・ルートはWebモジュールのURIです。Webサービスを含む各WebモジュールまたはEJBモジュールには、コンテキスト・ルートが存在する場合があります。

10. 「ターゲット・メタデータ・リポジトリ」セクションで、MDSリポジトリを選択し、「パーティション」に入力します。

注意:
最初にアプリケーションをデプロイしたときに使用したリポジトリ接続およびパーティション名を使用してください。そうしなければ、すべてのカスタマイズは失われます。

11. 「次へ」をクリックします。
「デプロイ設定」ページが表示されます(図42-22を参照)。

図42-22 「デプロイ設定」ページ

12. このページでは、アプリケーションをデプロイする前に、接続を構成するなどの共通タスクを実行したり、デプロイ・プランを編集したり、ディスクに保存できます。次を実行できます。

- Webモジュールの構成

- アプリケーション・ロールおよびポリシー用のアプリケーション・セキュリティを構成します。

- ADF接続設定の構成

13. 「ADF接続の構成」の「編集」アイコンをクリックして、Portal Frameworkアプリケーションに関連付けられた接続設定をチェックします。

注意:
ADF接続の編集は、前回デプロイした後に設定されていない接続に対してのみ必要です。前回デプロイした後に構成された接続は、この手順で指定された設定をオーバーライドします。

「ADF接続の構成」ページが表示されます(図42-23を参照)。

図42-23 「ADF接続の構成」ページ

14. 接続ごとに「編集」アイコンをクリックして、接続設定がターゲット環境に対して正しいことを確認します(本番やステージングなど)。
たとえば、ディスカッション・フォーラム接続の場合(図42-24を参照)、ディスカッション・サーバーへのURL、およびサーバーとの接続に使用されるユーザー・アカウントが、ターゲット環境に対して正しいことを確認してください。

図42-24 ディスカッション・フォーラム接続の設定

15. 必要に応じて、Webモジュールなどの追加デプロイ・オプションを指定して、アプリケーションやセキュリティ移行設定に含めます。

16. 「デプロイ・プラン」を開きます。
「デプロイ・プラン」設定が表示されます(図42-25を参照)。

図42-25 「デプロイ設定」ページ - 「デプロイ・プラン」セクション

必要に応じて、デプロイ・プランを編集してローカル・ハード・ドライブに保存しておけば、後でアプリケーションを再デプロイするときにこれらの設定を再利用できます。デプロイ・プランの詳細は、第42.1.6.7項「デプロイ・プランの保存と再利用」を参照してください。

17. 「再デプロイ」をクリックします。

18. 再デプロイが完了したら、「閉じる」をクリックします。

注意:
Fusion Middleware Controlセッション中にアプリケーションをデプロイしたWebLogic管理対象サーバーを再起動する場合、「ファーム」メニューから「ファーム」をリフレッシュして、アプリケーションのステータスを更新します。

42.3.3 WLSTを使用したPortal Frameworkアプリケーションの再デプロイ

WLSTコマンド行を使用してPortal Frameworkアプリケーションを再デプロイするには、WLSTが管理サーバーと接続している必要があります。管理サーバーをホストしているコンピュータで、redeployコマンドを起動する必要があります。

WLSTを使用してPortal Frameworkアプリケーションを再デプロイする手順は、次のとおりです。

1. WLSTシェルを起動します。
WLSTシェルの起動の詳細は、第1.13.3項「Oracle WebLogic Scripting Tool (WLST)」を参照してください。

2. Oracle WebCenter Portalインストールの管理サーバーに接続します。

connect("user_name","password","host_name:port")

ここで:

- user_nameは、管理サーバーにアクセスするユーザーの名前です(例: weblogic)。

- passwordは、管理サーバーにアクセスするためのパスワードです(例: weblogic)。

- host_nameは、管理サーバーのホスト名です(例: myserver.example.com)。

- portは、管理サーバーのポート番号です(デフォルトは7001)。
次のメッセージが表示されます。

Successfully connected to Admin Server 'AdminServer' that belongs to domain 'wc_domain'.

3. redeployコマンドを使用して、アプリケーションを再デプロイします。

redeploy(app_name,[planPath],[options])

ここで:

- app_nameは、再デプロイするアプリケーションのデプロイ名です。

- [planPath]は、デプロイ・プラン・ファイルの名前です。このファイル名は、アプリケーション・ディレクトリの絶対名または相対名のいずれかにできます。オプション。この引数は、アプリケーション・ディレクトリ内のplan/plan.xmlファイル(存在する場合)にデフォルト設定されます。

- [options]は、名前と値のペアとして指定したデプロイメント・オプションのカンマ区切りリストです。オプション。オプションの完全なリストは、deployコマンドを参照してください。

42.4 デプロイ後の構成

Portal Frameworkアプリケーションがデプロイされたら、デプロイされた設定が、ターゲットの管理対象サーバーに対して有効かどうかを確認する必要があります。確認の対象設定は、セキュリティ、接続およびデータ・ソースの設定です。

この項には次のサブセクションが含まれます:

- 第42.4.1項「デプロイ後のセキュリティ構成の確認」

- 第42.4.2項「デプロイ後のアプリケーション接続の確認」

- 第42.4.3項「データ・ソース接続の確認」

- 第42.4.4項「アプリケーションのチューニング」

42.4.1 デプロイ後のセキュリティ構成の確認

アプリケーションをデプロイする前に、ターゲットの管理対象サーバーで、アイデンティティ・ストア、ポリシーおよび資格情報ストアを設定する必要があります。デプロイ後は、アプリケーション構成がターゲット・サーバーの構成に一致することを確認してください。また、第30.2.5項「デプロイ後のセキュリティ構成タスク」で説明されているように、SSLおよびシングル・サインオンなど、デプロイ後に適用可能な他のすべてのセキュリティ構成が適切に構成されていることも確認してください。

42.4.2 デプロイ後のアプリケーション接続の確認

Portal Frameworkアプリケーションをデプロイした後、アプリケーションによって使用されるすべての接続が適切に設定されていることを確認してください。構成または再構成する必要があると考えられる接続は、次のとおりです。

- BPELワークリスト

- 外部アプリケーション

- ディスカッション・サーバー

- メール・サーバー

- インスタント・メッセージおよびプレゼンス(IMP)サーバー

- 検索

- WSRPプロデューサ

- PDK-Javaポートレット・プロデューサ

- Webサービス

- コンテンツ・リポジトリ

- 個人イベント・サーバー

- 分析コレクタ

42.4.3 データ・ソース接続の確認

Portal Frameworkアプリケーションをカスタム管理対象サーバーにデプロイした後、テスト時に構成したデータ・ソースが、デプロイしたアプリケーションに対して有効かどうかを確認してください。Portal FrameworkアプリケーションでMetadata Service (MDS)リポジトリ用のデータ・ソースを構成する方法の詳細は、『Oracle WebLogic Server JDBCデータ・ソースの構成と管理』の「JDBCデータ・ソースの構成」を参照してください。データ・ソースを設定するとき、パスワードを指定する必要があります。指定しないと、アプリケーションをデプロイするときに接続が作成されない可能性があります。

42.4.4 アプリケーションのチューニング

Portal Frameworkアプリケーションをデプロイして適切に構成した後、第27.5項「Oracle WebCenter Portalのパフォーマンスのチューニング」で説明されているように、システム・ファイルの制限、データ・ソース設定およびJRockit仮想マシン(JVM)の引数を確認してください。また、パフォーマンス問題の診断方法の詳細は、パフォーマンス・チューニング・ガイドの「Oracle WebCenter Portalのパフォーマンスのチューニング」、およびOracle WebCenter Portalのパフォーマンスのモニタリングに関する項も参照してください。

43 管理コンソールを使用したPortal Frameworkアプリケーションの管理

この章では、Portal Frameworkアプリケーションで使用できる実行時管理コンソールについて説明します。Portal Frameworkアプリケーションは、WebCenter Portal Frameworkアプリケーション・テンプレートを使用して、Oracle JDeveloperで構築されるポータル・アプリケーションです。

この章には次のトピックが含まれます:

- 第43.1項「Portal Frameworkアプリケーションの管理コンソールの概要」

- 第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」

- 第43.3項「Portal Frameworkアプリケーションのデフォルト設定の構成」

- 第43.4項「Portal Frameworkアプリケーションのメンバーとロールの管理」

- 第43.5項「Portal Frameworkアプリケーションのアセットの管理」

- 第43.6項「Portal Frameworkアプリケーションのサービス、ポートレット・プロデューサおよび外部アプリケーションの構成」

- 第43.7項「Portal Frameworkアプリケーションの変更のステージングから本番への伝播」

権限:
この章のタスクを実行するには、Portal Frameworkアプリケーションの管理コンソールでAdministratorロールが付与されている必要があります。詳細は、第43.4.2項「アプリケーション・ロールおよび権限の理解」を参照してください。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

43.1 Portal Frameworkアプリケーションの管理コンソールの概要

Portal Frameworkアプリケーションでは、デフォルトでいくつかの管理ページ(図43-1)が提供されます。認証された管理者は、これらのページを使用して、次のような一般的な管理作業を実行できます。

- アプリケーションレベルのプリファレンスの設定

- ユーザーの管理とアプリケーション・ロールの付与

- アプリケーション・アセットの管理と構成

- コンテンツの管理

- ポートレット・プロデューサの管理と構成

- 外部アプリケーションの管理と構成

- 投票の作成と管理

- アプリケーションの更新の伝播

図43-1 WebCenter Portal管理コンソール

43.2 Portal Frameworkアプリケーションの管理コンソールへのアクセス

Portal Frameworkアプリケーションの管理コンソールにアクセスする手順は、次のとおりです。

1. 管理者としてアプリケーションにログインします。
最初は、システム管理者のみがWebCenter Portal管理コンソールを使用できます。他のユーザーにAdministratorロールを付与する方法の詳細は、第43.4.3.3項「ユーザーへの管理権限の付与」を参照してください。

2. 次のいずれかを実行します。

- 「管理」リンクをクリックします(図43-2)。

図43-2 WebCenter Portal管理コンソール: 「管理」リンク

- ダイレクトURLを使用して、WebCenter Portal管理コンソールにアクセスします。
デフォルトのダイレクトURLは、次のとおりです。

http://www.server:port/context_root/admin

例: http://mycompany.com:8888/myapp/admin

ただし、アプリケーション開発者は、次のようにweb.xmlエントリを使用してダイレクトURLをカスタマイズできます。

<servlet-mapping>
<servlet-name>PortalAdminServlet</servlet-name>
<url-pattern>/admin</url-pattern>
</servlet-mapping>

WebCenter Portal管理コンソールが表示されます(図43-1を参照)。

43.3 Portal Frameworkアプリケーションのデフォルト設定の構成

Portal Frameworkアプリケーションは、デプロイ時に様々なデフォルト設定によって事前構成されますが、管理者はWebCenter Portal管理コンソールから、それらの設定をユーザーに合わせてカスタマイズできます。「構成」タブ(図43-3)では、デフォルトのページ・テンプレート、スキン、リソース・カタログおよびナビゲーション・モデルを指定できます。

図43-3 WebCenter Portal管理コンソール: 「構成」タブ

この項には次のトピックが含まれます:

- 第43.3.1項「デフォルト・ページ・テンプレートの選択」

- 第43.3.2項「デフォルト・リソース・カタログの選択」

- 第43.3.3項「デフォルト・ナビゲーションの選択」

- 第43.3.4項「デフォルト・スキンの選択」

- 第43.3.5項「デフォルト・ベース・リソースURLの選択」

43.3.1 デフォルト・ページ・テンプレートの選択

Portal Frameworkアプリケーションでは、ページ・テンプレートによって、どのように個々のページとページ・グループがユーザーの画面に表示されるかが定義されます。どのページも、ページ・テンプレート内に表示されます。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「ページ・テンプレートの開発」を参照してください。

管理者は、ページの表示に使用するデフォルト・ページ・テンプレートを定義できます。

アプリケーションのデフォルト・ページ・テンプレートを選択するには:

1. 「構成」管理タブに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 表示されたリストから「デフォルト・ページ・テンプレート」を選択します。
選択したテンプレートは、既存のページと新しく作成したすべてのページに適用されます。

注意:
ユーザーがページを作成し、リンクをページ・テンプレートにハードコードした場合、「デフォルト・ページ・テンプレート」の効果はなくなります。

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

43.3.2 デフォルト・リソース・カタログの選択

Portal Frameworkアプリケーションでは、リソース・カタログによって、レイアウト・コンポーネント、タスク・フロー、ポートレット、ドキュメントなど、認可されたユーザーが実行時にアプリケーションに追加できる要素の集合が指定されます。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「リソース・カタログの開発」を参照してください。

アプリケーションのデフォルト・リソース・カタログを選択するには:

1. 「構成」管理タブに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 表示されたリストから「デフォルト・リソース・カタログ」を選択します。
選択したカタログは、ユーザーがコンテンツをページやページ・テンプレートなどに追加するときに提供されます。

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

43.3.3 デフォルト・ナビゲーションの選択

ナビゲーションを使用すると、ユーザーはPortal Frameworkアプリケーション内を移動し、必要な情報にすばやくアクセスできます。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「ナビゲーション・モデルの開発」を参照してください。

管理者は、${navigationContext.defaultNavigation}へのEL参照が存在するときに使用されるナビゲーションを定義できます。これにより、管理者が一度デフォルト・ナビゲーション・モデルを指定した後、それをシステム全体で変更できるようになります。

アプリケーションのデフォルト・ナビゲーションを選択する手順は、次のとおりです。

1. 「構成」管理タブに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 表示されたリストから「デフォルト・ナビゲーション」を選択します。
選択したナビゲーションは、${navigationContext.defaultNavigation}へのEL参照が存在するときに適用されます。

注意:
ユーザーがナビゲーション・モデルの参照をハードコードした場合(タスク・フローのパラメータ内など)、「デフォルト・ナビゲーション」の効果はなくなります。

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

43.3.4 デフォルト・スキンの選択

システム管理者は、Portal Frameworkアプリケーションのスキンを変更することによって、そのデフォルトの外観をカスタマイズできます。スキンによって、ユーザー・インタフェースの表示が変更されますが、アプリケーションの動作は変更されません。

デフォルト・スキンを選択する手順は、次のとおりです。

1. 「構成」管理タブに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 表示されたリストから「デフォルト・スキン」を選択します。
選択したスキンが、アプリケーション内のすべてのページに適用されます。

注意:
WebCenter Portal管理コンソールによって使用される内部スキンは変化しないため、管理ページが「デフォルト・スキン」の影響を受けることはありません。

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

43.3.5 デフォルト・ベース・リソースURLの選択

開発者は、EL式を使用して、静的リソースのターゲットURLを動的に生成できます。これを実行する方法の1つは、ベースURLプリファレンスを定義して、リソースを目的のサーバーにリダイレクトすることです。この方法を使用する場合、EL式の形式は次のようになります。

<af:image source="#{preferenceBean.baseResourceURL}/images/globe.png"/>

管理者は、実行時にアプリケーションの管理コンソール内でベースURLを構成できます。

デフォルト・ベース・リソースURLを選択する手順は、次のとおりです。

1. 「構成」管理タブに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「ベース・リソースURL」フィールドに、静的リソースに使用するサーバーの詳細を、次の形式に従って入力します。

protocol://serverName:serverPortcontextPath

例:

http://myserver.com:7101/myFolder

ヒント:
有効なサーバーに解決されるEL式を使用することもできます。たとえば、デフォルトの設定は次のとおりです。

#{request.scheme}://#{request.serverName}:#{request.serverPort}#{request.contextPath}

43.4 Portal Frameworkアプリケーションのメンバーとロールの管理

Administratorロールを付与されたユーザーは、WebCenter Portal管理コンソールを通じて、アプリケーション・メンバーおよびロールを管理できます。「セキュリティ」タブ(図43-4)では、メンバーの追加、ロールの定義、権限とロールの付与と取消し、およびメンバーの削除を実行できます。

図43-4 WebCenter Portal管理コンソール: 「セキュリティ」タブ

この項には次のトピックが含まれます:

- 第43.4.1項「ユーザーの理解」

- 第43.4.2項「アプリケーション・ロールおよび権限の理解」

- 第43.4.3項「ユーザーの管理」

- 第43.4.4項「アプリケーション・ロールおよび権限の管理」

注意:
「セキュリティ」タブには、「ロール・マネージャ」タスク・フローが表示されます。このタスク・フローは、任意のPortal Frameworkアプリケーションに個別に追加できます。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のロール・マネージャ・タスク・フローの使用に関する項を参照してください。

43.4.1 ユーザーの理解

Portal Frameworkアプリケーションの各ユーザーには、既存のアイデンティティ・ストアから直接プロビジョニングされたログイン・アカウントが必要です。最初は、システム管理者(デフォルトではweblogic)のみがログインでき、このデフォルト・ユーザーにAdministratorロールを通じて(表43-1を参照)すべての管理権限が付与されます。

システム管理者は、アイデンティティ・ストア内の個々のユーザーとユーザー・グループをアプリケーションのメンバーにし、各メンバーに適切なアプリケーション・ロールを割り当てる必要があります。デフォルトおよびカスタム・アプリケーション・ロールについては、第43.4.2.1項「アプリケーション・ロールの理解」を参照してください。

システム管理者は、1人以上の別のユーザーにアプリケーションのAdministratorロールを割り当て、それらのユーザーにこの職責を委任することもできます。

表43-1 Portal Frameworkアプリケーションのデフォルト管理者

ユーザー

説明

システム管理者(weblogic)

Oracle WebCenter Portalドメイン全体の管理者です。このユーザーは、ドメイン内の任意のアプリケーションを管理できます。

43.4.2 アプリケーション・ロールおよび権限の理解

アプリケーション・ロールは、Portal Frameworkアプリケーション内のアセットとサービスへのユーザーのアクセス・レベルを制御します。この項では、アプリケーション・ロールおよび権限について説明します。この項の内容は次のとおりです。

- 第43.4.2.1項「アプリケーション・ロールの理解」

- 第43.4.2.2項「アプリケーション権限の理解」

43.4.2.1 アプリケーション・ロールの理解

アプリケーション・ロールの割当ては、システム管理者の職責です。管理者は、メンバーにデフォルトのアプリケーション・ロールを割り当てるか、アプリケーションに固有のカスタム・ロールを追加で作成できます。詳細は、次を参照してください。

- 第43.4.2.1.1項「デフォルトのアプリケーション・ロール」

- 第43.4.2.1.2項「カスタム・アプリケーション・ロール」

- 第43.4.2.2.1項「アプリケーション権限」

- 第43.4.2.2.2項「ディスカッション・サーバーのロール・マッピング」

- 第43.4.2.2.3項「エンタープライズ・グループのロール・マッピングの理解」

Portal Frameworkアプリケーション内で定義されたアプリケーション・ロールおよび権限は、そのアプリケーションのポリシー・ストアに格納されるため、適用範囲はそのアプリケーションに限定され、WebCenter Portalドメインまたはその他のドメイン内の権限には関与しません。エンタープライズ・ロールはこれとは異なり、アプリケーションのアイデンティティ・ストアに格納されるため、そのアプリケーション内の権限には関与しません。

43.4.2.1.1 デフォルトのアプリケーション・ロール

Portal Frameworkアプリケーションには、削除できないデフォルトのアプリケーション・ロールがあります(表43-2)。

表43-2 Portal Frameworkアプリケーションのデフォルトのロール

アプリケーション・ロール

説明

Administrator

Administratorロールを持つユーザーは、アプリケーション全体のプリファレンスの設定、アセットの管理、コンテンツ・リポジトリの構成、投票の作成、およびプロデューサと外部アプリケーションの登録を実行できます。

また、管理者はアプリケーションのユーザーとロールの管理、および他のユーザーへの権限の委任または権限の取消しを実行することもできます。

最初は、Administratorsエンタープライズ・グループが、Administratorロールを通じてすべての管理権限を割り当てられる唯一のメンバーになります。つまり、Administratorsグループのユーザーに、Portal Frameworkアプリケーションのすべての管理権限が割り当てられます。

AppConnectionManager

このロールを持つユーザーは、対応するタスク・フローを通じて、ポートレット・プロデューサと外部アプリケーションを管理(作成、更新および削除)できます。

最初は、Administratorロールを持つユーザーのみが、AppConnectionManagerロールのメンバーになります。

AppConnectionViewer

このロールを持つユーザーは、対応するタスク・フローを通じて、ポートレット・プロデューサと外部アプリケーションを表示できます。

最初は、ログインした(authenticated-roleを持つ)すべてのユーザーがAppConnectionViewerロールのメンバーになります。

AppConnectionViewerロールには権限が直接付与されないため、authenticated-roleに付与されるすべての権限がこのロールのメンバーにも付与されます。

authenticated-role

認証されたユーザーには、標準OPSS (Oracle Platform Security Services)ロールのauthenticated-roleが付与されます。

anonymous-role

アプリケーションにアクセスできるが、ログインしていないユーザーには、標準OPSS (Oracle Platform Security Services)アプリケーション・ロールのanonymous-roleが付与されます。これらは匿名の識別できないユーザーであり、パブリック・コンテンツのみを参照できます。

43.4.2.1.2 カスタム・アプリケーション・ロール

カスタム・アプリケーション・ロール(ユーザー定義ロールとも呼ばれます)は、使用するPortal Frameworkアプリケーションに固有のロールです。必須のアプリケーション・ロールの識別、適切なロール名の選択および各ロールの職責の定義は、アプリケーションを設定する際に管理者が行う仕事です。

たとえば、教育環境では、Teacher、Student、Guestなどのロールが必要になります。 一方、企業環境では、Finance、Sales、Human Resources、Supportなどが適切なロールとなります。

ユーザーのアプリケーション・ロールの設定方法は、第43.4.4.1項「アプリケーション・ロールの定義」を参照してください。

43.4.2.2 アプリケーション権限の理解

すべてのアプリケーション・ロールには、権限と呼ばれる特定の定義済の権利があります。これらの権限により、各ユーザーは、アプリケーション内で特定のアクションを実行できます。他の権限からその内容を継承する権限はありません。

この項には次のトピックが含まれます:

- 第43.4.2.2.1項「アプリケーション権限」

- 第43.4.2.2.2項「ディスカッション・サーバーのロール・マッピング」

- 第43.4.2.2.3項「エンタープライズ・グループのロール・マッピングの理解」

43.4.2.2.1 アプリケーション権限

表43-3に、アプリケーションの権限が分類されリストされています。

「管理」を除くすべての権限は、他の権限からその内容を継承しません。

表43-3 Portal Frameworkアプリケーションのアプリケーション権限

カテゴリ

アプリケーション権限

アプリケーション

管理: すべての「管理コンソール」ページ(「アセット 」、「サービス」、「セキュリティ」、「構成」および「伝播」)へのアクセス。ユーザーはこれらのページを通じて、アプリケーション・セキュリティ(ユーザーやロール)の管理、アプリケーション全体のプロパティとサービスの構成、アプリケーション・アセットの管理、ページの作成と管理、およびアプリケーションの変更の伝播を実行できます。

構成: ユーザーによる、「構成」タブへの操作の表示とそれらの実行。

伝播: ユーザーによる、「伝播」タブへの操作の表示とそれらの実行。

タスク・フロー・スタイル

作成、編集および削除: WebCenter Portal管理コンソール(「アセット」タブ)を使用した、アプリケーションのタスク・フロー・スタイルの作成、編集および削除。

作成: アプリケーションのタスク・フロー・スタイルの作成。

編集: タスク・フロー・スタイルの編集。

第43章「Portal Frameworkアプリケーションのアセットの管理」を参照してください。

コンテンツ・プレゼンタ・テンプレート

作成、編集および削除: WebCenter Portal管理コンソール(「アセット」タブ)を使用した、アプリケーションのコンテンツ・プレゼンタ・テンプレートのアップロード、編集および削除。

作成: アプリケーションのコンテンツ・プレゼンタ・テンプレートのアップロード。

編集: アプリケーションレベルのコンテンツ・プレゼンタ・テンプレートの編集。

第43章「Portal Frameworkアプリケーションのアセットの管理」を参照してください。

スキン

作成、編集および削除: WebCenter Portal管理コンソール(「アセット」タブ)を使用した、スキンの作成、編集および削除。

作成: アプリケーションのスキンの作成。

編集: スキンの編集。

第43章「Portal Frameworkアプリケーションのアセットの管理」を参照してください。

タスク・フロー

作成、編集および削除: WebCenter Portal管理コンソール(「アセット」タブ)を使用した、タスク・フロー・スタイルに基づくタスク・フローの作成、編集および削除。

作成: アプリケーションのタスク・フローの作成。

編集: タスク・フローの編集。

第43章「Portal Frameworkアプリケーションのアセットの管理」を参照してください。

リソース・カタログ

作成、編集および削除: WebCenter Portal管理コンソール(「アセット」タブ)を使用した、アプリケーションのリソース・カタログの作成、編集および削除。

作成: アプリケーションのリソース・カタログの作成。

編集: リソース・カタログの編集。

第43章「Portal Frameworkアプリケーションのアセットの管理」を参照してください。

ページ・スタイル

作成、編集および削除: WebCenter Portal管理コンソール(「アセット」タブ)を使用した、ページ・スタイルの作成、編集および削除。

作成: アプリケーションのページ・スタイルの作成。

編集: ページ・スタイルの編集。

第43章「Portal Frameworkアプリケーションのアセットの管理」を参照してください。

データ・コントロール

作成、編集および削除: WebCenter Portal管理コンソール(「アセット」タブ)を使用した、アプリケーションのデータ・コントロールの作成、編集および削除。

作成: アプリケーションのデータ・コントロールの作成。

編集: データ・コントロールの編集。

第43章「Portal Frameworkアプリケーションのアセットの管理」を参照してください。

ナビゲーション

作成、編集および削除: WebCenter Portal管理コンソール(「アセット」タブ)を使用した、アプリケーションのナビゲーションの作成、編集および削除。

作成: アプリケーションのナビゲーションの作成。

編集: ナビゲーションの編集。

第43章「Portal Frameworkアプリケーションのアセットの管理」を参照してください。

ページ・テンプレート

作成、編集および削除: WebCenter Portal管理コンソール(「アセット」タブ)を使用した、ページ・テンプレートの作成、編集および削除。

作成: アプリケーションのページ・テンプレートの作成。

編集: ページ・テンプレートの編集。

第43章「Portal Frameworkアプリケーションのアセットの管理」を参照してください。

ページ

ページ・アクセス権の付与: ページのセキュリティの管理。

ページの編集: ページ・コンテンツの追加または編集、コンテンツの再配置、およびページ・パラメータとページ・プロパティの設定。

ページのカスタマイズ: すべてのユーザーを対象としたページのカスタマイズ。

ページのパーソナライズ: コンテンツの追加、編集または削除による、ページの表示のパーソナライズ。

表示: ページの表示。

リンク

作成および削除: オブジェクト間のリンクの作成と削除、およびリンク権限の管理。

削除: 2つのオブジェクト間のリンクの削除。

作成: オブジェクト間のリンクの作成。

リスト

作成、編集および削除: リストとリスト・データの作成、編集および削除。

リストの作成: リストの作成。

リストの編集: リスト列定義の編集。

リストの削除: 任意のリストの削除。

リスト・データの編集: リスト・データの追加、編集および削除。

リストの表示: リストとリスト・データの表示。

ピープル・コネクション

ピープル・コネクションの管理: ピープル・コネクション・サービスを対象としたアプリケーション全体の設定の管理。

ピープル・コネクション・データの更新: ピープル・コネクション・サービスに関連付けられたコンテンツの編集。

人とのコネクション: ピープル・コネクション・サービスに関連付けられたコンテンツの他のユーザーとの共有。

43.4.2.2.2 ディスカッション・サーバーのロール・マッピング

リモート(バックエンド)・リソースへのアクセスが必要なサービスでも、ロール・マッピング・ベースの認可が必要になります。つまり、Portal Frameworkアプリケーション内でディスカッションを使用できるロールは、バックエンド・ディスカッション・サーバー上の対応するロールにマップされている必要があります。

Portal Frameworkアプリケーションは、アプリケーション・ロールを使用して、アプリケーション内のユーザー権限を管理します。ディスカッション・サーバーでは、異なるロールと権限のセットが適用されます。

Discussions-Create Edit Delete権限を割り当てられたPortal Frameworkアプリケーション・ユーザーは、自動的にディスカッション・サーバー・ユーザーとして追加され、Category Admin権限を持つAdministratorロールを(ディスカッション・サーバー上で)割り当てられます。Portal Frameworkアプリケーションでは、AdministratorロールにデフォルトでDiscussions-Create Edit Delete権限が割り当てられます(表43-4)。

表43-4 ディスカッション・サーバーのロールと権限

ディスカッション・サーバーのロール

ディスカッション・サーバーの権限

Portal Frameworkアプリケーション
同等のアプリケーション権限

Administrator

Category Admin

Discussions-Create, Edit, and Delete

権限が付与されたカテゴリ内のサブ・カテゴリ、フォーラムおよびトピックの作成、読取り、更新および削除。

43.4.2.2.3 エンタープライズ・グループのロール・マッピングの理解

同じエンタープライズ・グループに属する個々のユーザーまたは複数のユーザーに、Portal Frameworkアプリケーション・ロールを割り当てることができます。バックエンドのアイデンティティ・ストアにおける、その後のエンタープライズ・グループの更新内容は、自動的にPortal Frameworkアプリケーションに反映されます。まず、エンタープライズ・グループにPortal Frameworkアプリケーション・ロールを割り当てると、そのエンタープライズ・グループに属するすべてのユーザーに同じロールが割り当てられます。ユーザーがグループから抜けると、ロールが取り消されます。ユーザーがグループに入ると、ロールが付与されます。

Portal Frameworkアプリケーションで、エンタープライズのグループからロールへのマッピングを正しくメンテナンスするには、ディスカッション・サーバーおよびコンテント・サーバーなどのバックエンド・サーバーもエンタープライズ・グループをサポートする必要があります。このリリースで提供されるWebCenter Portalディスカッション・サーバーとWebCenter Contentコンテンツ・サーバーのバージョンでは、エンタープライズ・グループがサポートされますが、以前のバージョンではサポートされない場合があります。

注意:
ロールを割り当てられたグループにユーザーを追加することは、動的ではありません。つまり、ユーザーは、ロールに基づいてアセットにすぐにアクセスできない場合があります。これに対処するために、次の例に示すように、refreshGroupSpaceCache WLSTコマンドを使用してキャッシュをクリアすることができます。

refreshGroupSpaceCache(appName='webcenter', spaceNames='', syncMode=true, updateType='all', cleanCache=false)

こうしない場合は、キャッシュがリフレッシュされるのを待つだけになります。

43.4.3 ユーザーの管理

管理者は、すべてのアプリケーション・ユーザーに適切な権限を割り当てる必要があります。ユーザーが権限を得るには、適切なアプリケーション・ロールを通じて、そのユーザーにアプリケーションのメンバーシップを付与する必要があります。

この項では、メンバーの追加方法とロールの割当て方法について説明します。この付録には、次の項があります。

- 第43.4.3.1項「アプリケーション・ロールへのメンバーの追加」

- 第43.4.3.2項「ユーザーへの異なるロールの割当て」

- 第43.4.3.3項「ユーザーへの管理権限の付与」

- 第43.4.3.4項「アプリケーション・ロールの取消し」

- 第43.4.3.5項「ユーザーの追加または削除」

43.4.3.1 アプリケーション・ロールへのメンバーの追加

同じエンタープライズ・グループに属する個々のユーザーまたは複数のユーザーにメンバーシップを付与するには、「セキュリティ」タブを使用します。メンバーシップの対象となるのは、アイデンティティ・ストア内で定義された任意のユーザーまたはグループです。第31.3項「組込みLDAPアイデンティティ・ストアへのユーザーの追加」を参照してください。

新規ユーザーやエンタープライズ・グループから除外されたユーザーなど、バックエンド・アイデンティティ・ストアの更新内容は、自動的にPortal Frameworkアプリケーションに反映されます。まず、エンタープライズ・グループにアプリケーション・ロールを割り当てると、そのグループに属するすべてのユーザーに同じロールが割り当てられます。ユーザーがグループから抜けると、ロールが取り消されます。ユーザーがグループに入ると、ロールが付与されます。

注意:
Portal Frameworkアプリケーションで、エンタープライズのグループからロールへのマッピングを正しくメンテナンスするには、ディスカッション・サーバーおよびコンテント・サーバーなどのバックエンド・サーバーもエンタープライズ・グループをサポートする必要があります。WebCenter Portal 11.1.1.2.0以降で提供されるWebCenter Portalのディスカッション・サーバーとOracle WebCenter Contentではエンタープライズ・グループがサポートされますが、それ以前のバージョンではサポートされない場合があります。

適切なアプリケーション・ロールを通じてユーザーにメンバーシップを付与する手順は、次のとおりです。

1. 「セキュリティ」管理タブに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「ロール名」ペインで、ユーザーに割り当てるロールを選択します。
選択したロールをすでに割り当てられているメンバーのリストが右側(「メンバー」ペイン内)に表示されます。

アプリケーションのすべての管理権限を割り当てる場合にのみ、「管理者」を選択します。必要なロールがリストにない場合は、要件を満たす新規ロールを作成します(第43.4.4.1項「アプリケーション・ロールの定義」を参照)。

3. 「ユーザーの追加」、「グループの追加」または「ロールの追加」をクリックします(図43-5)。
ユーザーの追加: 個々のユーザーへのメンバーシップの付与

グループの追加: ユーザー・グループに属するすべてのユーザーへのメンバーシップの付与

ロールの追加: 特定のアプリケーション・ロールを割り当てられたすべてのユーザーへのメンバーシップの付与

図43-5 WebCenter Portal管理コンソール: メンバーの追加

4. ユーザー、グループまたはアプリケーション・ロールの正確な名前がわかっている場合は、検索ボックス(「ユーザーの追加」、「グループの追加」または「ロールの追加」)にその名前を入力し、矢印アイコンをクリックします。正確な名前がわからない場合は、次のように名前の一部を使用して、アイデンティティ・ストア内を検索できます(図43-6を参照)。

図43-6 「ユーザーの追加」ペイン: ユーザーの検索

5. 選択したロールを割り当てるユーザー、グループまたはロールを選択し、「追加先」をクリックします。[Ctrl]キーを押して、複数の名前を選択します。

注意:
直接、間接を問わず、ユーザー、グループまたはロールがすでにロールを保持している場合、ロールを割り当てることはできません。周期的なロールの割当ては許可されません。

新規メンバーが「メンバー」ペインに表示されます。

6. 完了したら、「完了」をクリックします。

43.4.3.2 ユーザーへの異なるロールの割当て

Portal Frameworkアプリケーションのユーザー・ロールは、変更されることがあります。たとえば、ユーザーが営業から経理部門に異動になった場合、ユーザーのロール割当ては「営業」から「経理」に変更されます。ユーザーのロールを変更するには、まずユーザーの以前のロールのメンバーシップを取り消した後、そのユーザーを新しいロールに追加します。詳細は、第43.4.3.4項「アプリケーション・ロールの取消し」と第43.4.3.1項「アプリケーション・ロールへのメンバーの追加」を参照してください。

注意:
自分のロールまたはシステム管理者のロールは、変更できません。第43.4.2.1項「アプリケーション・ロールの理解」を参照してください。

43.4.3.3 ユーザーへの管理権限の付与

Administratorロールを使用すると、Portal Frameworkアプリケーションのすべての管理権限を簡単にユーザーに付与できます。管理者は最高レベルの権限を持ち、アプリケーションのすべてを表示および変更できるため、Administratorロールの割当ては慎重に行います。

ユーザーとロールの管理など、ほとんどの管理タスクはAdministratorロールにのみ許可されています。第43.4.2.1.1項「デフォルトのアプリケーション・ロール」も参照してください。

43.4.3.4 アプリケーション・ロールの取消し

該当しないアプリケーション・ロール割当てを取り消すのは簡単です。ただし、ユーザーのアプリケーション・ロールをすべて取り消しても、そのユーザーはアイデンティティ・ストアから削除されません。

注意:
自分のロール割当てまたはシステム管理者のロールを取り消すことはできません。第43.4.2項「アプリケーション・ロールおよび権限の理解」を参照してください。

アプリケーション・ロールを取り消す手順は、次のとおりです。

1. 「セキュリティ」管理タブに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「ロール名」ペインからロールを選択します。

3. 「メンバー」リストからユーザー、グループまたはアプリケーション・ロールを選択します。

4. 「メンバーの削除」をクリックします。

5. プロンプトが表示されたら、「削除」をクリックしてユーザーのロールを取り消します。

43.4.3.5 ユーザーの追加または削除

管理者は、Portal Frameworkアプリケーションのアイデンティティ・ストアで直接新しいユーザー・データの追加またはユーザー資格証明の削除を実行できません。アイデンティティ・ストアの管理はシステム管理者の職責であり、WLS管理コンソールを通じて実行するか、組込みLDAPアイデンティティ・ストアに対し、LDAPコマンドを使用して直接実行します。第31.3項「組込みLDAPアイデンティティ・ストアへのユーザーの追加」を参照してください。

43.4.4 アプリケーション・ロールおよび権限の管理

Portal Frameworkアプリケーションは、アプリケーション・ロールを使用して、アプリケーション内のユーザーの権限を管理します。この項では、「セキュリティ」管理ページ(図43-7)からアプリケーション・ロールとその権限を管理する方法を説明します。

図43-7 WebCenter Portal管理コンソール: 「セキュリティ」タブ

Portal Frameworkアプリケーションでは、デフォルトのアプリケーション・ロールがいくつか提供されます。デフォルトのアプリケーション・ロールは削除できませんが、各ロールのデフォルトの権限割当てを変更できます。詳細は、第43.4.2項「アプリケーション・ロールおよび権限の理解」を参照してください。

この項には次のトピックが含まれます:

- 第43.4.4.1項「アプリケーション・ロールの定義」

- 第43.4.4.2項「アプリケーション・ロールの権限の変更」

- 第43.4.4.3項「認証されていないユーザーへのロールの付与または削除」

- 第43.4.4.4項「認証されているすべてのユーザーへのロールの付与」

- 第43.4.4.5項「アプリケーション・ロールの削除」

43.4.4.1 アプリケーション・ロールの定義

ロールを使用してアプリケーション・ユーザーのグループの特性を示し、Portal Frameworkアプリケーションでユーザーが何を表示でき、どのような操作を実行できるかを決定します。

アプリケーション・ロールを定義する際には、自己記述的なロール名を使用し、ロール・ポリシーは可能なかぎり簡単なものにします。最小限のロールを選択し、効果的なポリシーを維持します。

新規のロールに対する権限の割当ては、適切なアクセス権を割り当てるように注意します。ロールに必要のない追加のアクションをユーザーが実行できないようにすると同時に、必要なアクティビティの実行までも不注意に制限しないようにします。場合によっては、ユーザーが複数のロールに該当することもあります。

新規のアプリケーション・ロールを定義する手順は、次のとおりです。

1. 「セキュリティ」管理タブに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「ロール名」ペインの上にある追加アイコン(プラス記号)をクリックします。
「ロールの作成」ダイアログが表示されます(図43-8)。

図43-8 WebCenter Portal管理コンソール: 「ロールの作成」ダイアログ

3. 新規ロールの名前と説明を入力し、「ロールの作成」をクリックします。
自己記述的なロール名を付けます。どのユーザーがどのロールに所属するかを可能なかぎり明白にします。ロール名には、英数字、空白、@およびアンダースコアを使用できます。

新規ロールが「ロール」ペインにリストされます(図43-9)。

図43-9 WebCenter Portal管理コンソール: 「ロール」ペイン

4. 第43.4.4.2項「アプリケーション・ロールの権限の変更」の説明に従って、ロールのユーザー権限を定義します。

43.4.4.2 アプリケーション・ロールの権限の変更

新規ロールの作成後に権限を設定する必要がありますが、管理者はアプリケーション・ロールに関連付けられた権限をいつでも変更できます。

アプリケーション・ロールの権限により、各ユーザーは、アプリケーション内で特定のアクションを実行できます。アプリケーション権限については、第43.4.2項「アプリケーション・ロールおよび権限の理解」を参照してください。

ロールに関連付けられた権限を変更するには:

1. 「セキュリティ」管理タブに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 権限を表示または変更するロールを選択し、編集アイコン(鉛筆)をクリックします。
「ロールの編集」ダイアログに、ロールの現在の権限が表示されます(図43-10)。

図43-10 WebCenter Portal管理コンソール: 「ロールの編集」ダイアログ

3. 権限のチェック・ボックスを選択またはクリアして、ロールの権限を有効または無効にします。

4. 「適用」をクリックして保存するか、「OK」をクリックして保存および終了します。

新しい権限は即時有効になります。

43.4.4.3 認証されていないユーザーへのロールの付与または削除

Portal Frameworkアプリケーションにログインしていないユーザーには、anonymous-roleが割り当てられます。最初は、anonymous-roleを持つユーザーに権限は付与されず、それらのユーザーは、ログイン・ページやランディング・ページなどのパブリック・アプリケーション・ページ、および個々のユーザーがパブリックにすることを選択したコンテンツのみを表示できます。

注意:
anonymous-roleに権限を付与する際は、注意が必要です。管理権限や、不要と思われる権限は付与しないようにしてください。セキュリティ上の理由から、ユーザーがアプリケーション内で表示できる内容と実行できる操作を制限することをお薦めします。アプリケーションへのパブリックまたは匿名アクセスを提供していない場合は、現在anonymous-roleに付与されている権限をすべて削除するか、それらをauthenticated-roleに移行する必要があります。

アプリケーション・ロールをパブリック・ユーザーに付与する手順は、次のとおりです。

1. 「セキュリティ」管理タブに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 認証されていないユーザーに適した権限を付与するロールをまだ定義していない場合は、その作業を実行します。
第43.4.4.1項「アプリケーション・ロールの定義」を参照してください。

3. 認証されていないユーザーに適した権限を定義するロールを選択します。

4. 「パブリック・アクセス用の匿名ロールの追加」をクリックします(図43-11)。(anonymous-roleがすでに追加されており、そのロールを削除する必要がある場合は、「削除」をクリックします。)

図43-11 WebCenter Portal管理コンソール: パブリック・アクセスの追加

anonymous-roleが「メンバー」リストに追加されます(図43-12)。

図43-12 WebCenter Portal管理コンソール: パブリック・アクセスの追加

43.4.4.4 認証されているすべてのユーザーへのロールの付与

Portal Frameworkアプリケーションにログインしているユーザーには、authenticated-roleが割り当てられます。

その他の重要な注意点は、次のとおりです。

- 認証されたユーザーはすべてanonymous-roleの対象にもなっているため、anonymous-roleに付与されているすべての権限が認証されたユーザーに対して自動的に成立します。

- カスタム・アプリケーション・ロールは、authenticated-roleの権限をすべて継承します。

43.4.4.5 アプリケーション・ロールの削除

アプリケーション・ロールは、不要になった時点でアプリケーションから削除する必要があります。これにより、有効なロール・リストを維持し、不適切なロール割当てを防止できます。ただし、直接、間接を問わず、自分に割り当てられたロールは削除できません。

アプリケーション・ロールは、それらがまだユーザーに割り当てられている場合でも削除されます。

注意:
デフォルトのロールAdministrator、AppConnectionManager、AppConnectionViewer、authenticated-roleおよびanonymous-roleは削除できません。第43.4.2.1.1項「デフォルトのアプリケーション・ロール」も参照してください。

デフォルトのロールは削除できないため、アプリケーション・ユーザーは、他のアプリケーション・ロールがすべて取り消された場合でも、authenticated-roleを通じてログインできます。

アプリケーション・ロールを削除するには:

1. 「セキュリティ」管理タブに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. ロールのリストから削除するロールを選択し、削除アイコン(x)をクリックします。

3. 図43-13 アプリケーション・ロールの削除

4. プロンプトが表示されたら、「削除」をクリックしてロールの削除を確認します。
ロールが表から削除されます。このロールのみを割り当てられたユーザーは、引き続きauthenticated-userロールを通じてログインできます。

43.5 Portal Frameworkアプリケーションのアセットの管理

管理コンソールの「アセット」ページを使用すると、アプリケーション・アセットを管理できます(図43-14)。アプリケーション・アセットには、ページ、ページ・テンプレート、ナビゲーション、リソース・カタログ、スキン、ページ・スタイル、コンテンツ・プレゼンタ表示テンプレート、タスク・フロー・スタイル、データ・コントロールおよびタスク・フローがあります。実行できるタスクには、アプリケーション・アセットの作成、編集、コピー、公開、アップロード、ダウンロードなどがあります。様々なアセットの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のポータル・リソースの概要に関する項を参照してください。

図43-14 管理コンソール: 「アセット」ページ

この項には次のトピックが含まれます:

- 第43.5.1項「ページの使用」

- 第43.5.2項「アセットの作成」

- 第43.5.3項「アセットのコピー」

- 第43.5.4項「アセットの編集」

- 第43.5.5項「アセットのプロパティの設定」

- 第43.5.6項「アセットの表示と非表示」

- 第43.5.7項「アセット・セキュリティの設定」

- 第43.5.8項「アセットのアップロードとダウンロード」

- 第43.5.9項「アセットのプレビュー」

- 第43.5.10項「アセットの削除」

43.5.1 ページの使用

実行時には、アプリケーション・ページを作成および管理できます。

この項には次のトピックが含まれます:

- 第43.5.1.1項「ページの作成」

- 第43.5.1.2項「サブページの作成」

- 第43.5.1.3項「ページのアクセス権限の設定」

- 第43.5.1.4項「ページの並替え」

- 第43.5.1.5項「ページ階層内のページの移動」

- 第43.5.1.6項「ページ名の変更」

ページの編集、コピーまたは削除については、この章の後半に記載されている、リソースに関する一般的な手順を参照してください。

43.5.1.1 ページの作成

実行時にアプリケーション・ページを作成するには:

1. 管理コンソールの「アセット」タブを開きます。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 左側にあるナビゲーション・パネルの「ページ」をクリックします。

3. メニュー・バーの「ページの作成」をクリックします。

4. 「ページの作成」ダイアログ(図43-15)の「ページ名」フィールドに、ページの名前を入力します。

5. 「ページ・テンプレート」リストから、ページのベースにするページ・テンプレートを選択します。

6. 「ページ・スタイル」リストから、ページに使用するスタイルを選択します。
ページ・スタイルの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のページ・スタイルの概要に関する項を参照してください。

図43-15 「ページの作成」ダイアログ

7. 「作成」をクリックします。
新しく作成したページが「アセット」ページにリストされます。このページは、ページの「アクション」メニューで提供されるオプションを使用して管理できます(図43-16)。

図43-16 ページの「アクション」メニュー

43.5.1.2 サブページの作成

サブページの作成手順は、第43.5.1.1項「ページの作成」で説明したメイン・ページの作成手順に似ています。「アセット」ページで、サブページを作成するページの「サブページ」列にある「作成」をクリックする必要があります(図43-17)。デフォルトでは、サブページはその親ページのセキュリティを継承します。

図43-17 サブページを作成するための「作成」リンク

43.5.1.3 ページのアクセス権限の設定

すべてのアプリケーション・ページはルート・ノードの下にあり、デフォルトでそのルート・ノード用に定義された権限を継承します。ルート・ノード用のカスタム権限を定義することもできます。また、ルート・ノードのデフォルトの権限をオーバーライドし、個々のページ用のカスタム権限を指定することもできます。デフォルトでは、サブページはその親ページのセキュリティを継承します。

ページのアクセス権限の設定時に、アクセス方法を「セキュリティの委譲」または「親のセキュリティの継承」から選択できます(図43-18)。

図43-18 「ページのアクセス権限の設定」ダイアログ

次のうちから選択します。

- セキュリティの委譲: ページと対話できるユーザーを定義する場合に選択します。このオプションを選択すると、ページが現在その親から継承しているすべての権限がダイアログに表示されます。これは実質的には、ページに適用される現在のセキュリティ・ポリシーを示しています。新しい権限付与の追加や既存の権限付与の削除によって、権限付与を調整することもできます。

- 親のセキュリティの継承: ページの親ノード用に定義された権限を継承する場合に選択します。このオプションを設定すると、ページ上で定義されたセキュリティ権限はすべて削除され、親ノードのセキュリティ設定が有効になります。

ページの次の権限アクションを定義できます。

- 管理: 他のすべてのページ権限を付与します。通常は、スーパー管理者のアクセス・タイプを指定するために使用します。この権限アクションは、ルート・ノードでアクセスを定義するときにのみ使用できます。

- 付与: 自分と同様のアクセス権を他のユーザー、グループまたはロールに付与することをユーザーに許可します。たとえば、ユーザーが「付与」および「編集」権限を保持している場合、そのユーザーはこれら2つのアクションの実行権限のみを付与でき、「削除」や「パーソナライズ」など、他の権限を付与することはできません。

- 作成: 現在のページの下にサブページを作成することをユーザーに許可します。

- 削除: ページをそのすべてのサブページとともに削除することをユーザーに許可します。

- 編集: ページの編集をユーザーに許可します。

- パーソナライズ: ページのパーソナライズをユーザーに許可します。

- 表示: ページの表示をユーザーに許可します。

すべての権限は、委任または包含という2つの権限モデルのいずれかに従います。委任モデルが適用されるのは、エンティティに特定の権限アクションが許可されているかどうかを評価する唯一の基準が、そのエンティティにページの特定の権限が付与されたかどうかである場合です。「表示」以外の権限アクションは、すべてこのカテゴリに分類されます。権限が包含タイプになるのは、エンティティに付与されたページの権限が、セキュリティを定義する、上の階層のすべてのノードにも付与されている場合です。「表示」権限アクションのみが、このカテゴリに分類されます。

このため、ページを表示するには、その特定のページと、ルート・ノードまで続くその上の階層に含まれるすべてのノードで「表示」権限アクションが許可されている必要があります。ページ階層の中間ノードで「表示」権限が付与されていない場合、その特定のページは表示できません。他の権限アクション(削除や編集など)は、そのページの該当する権限が付与されていれば実行できます。

この項には次のトピックが含まれます:

- 第43.5.1.3.1項「個々のページの権限の設定」

- 第43.5.1.3.2項「ルート・ノードの権限の設定」

43.5.1.3.1 個々のページの権限の設定

特定のページの権限を設定する手順は次のとおりです。

1. 第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」の説明に従って、「アセット」ページに移動します。

2. 左側にあるナビゲーション・パネルの「ページ」をクリックします。

3. ページのリストから、必要なページの「アクション」メニューを開き、「アクセスの設定」を選択します。

図43-19 ページのアクセス権限の設定

4. 「ページのアクセス権限の設定」ダイアログで、アクセス方法を選択します(図43-20)。

- セキュリティの委譲 - 階層内のこのページ・ノード、およびその子の中でセキュリティがオーバーライドされていないノードを管理および更新できるユーザーを定義する場合、この方法を選択します。この方法を選択すると、使用可能なデフォルトの権限が表示されます。新しい権限の追加や既存の権限の削除によって、権限を調整することもできます。
このオプションを選択した場合、手順5に進みます。

- 親のセキュリティの継承 - ページの親ノード用に定義された権限を継承する場合、この方法を選択します。この方法を選択した場合、「OK」をクリックして変更を保存し、ダイアログを終了します。

図43-20 ページのアクセス権限の設定

5. 「セキュリティの委譲」を選択した場合、ページへのアクセス権限を付与するユーザー、グループまたはロールを指定します。

- アイデンティティ・ストアに含まれる個々のユーザーを検索および選択するには、「ユーザーの追加」をクリックします。必要なユーザーを選択し、「OK」をクリックします。

- アイデンティティ・ストアに含まれるユーザーのグループを検索および選択するには、「グループの追加」をクリックします。必要なグループを選択し、「OK」をクリックします。

- ページへのアクセス権限を付与するアプリケーション・ロールを検索および選択するには、「ロールの追加」をクリックします。必要なロールを選択し、「OK」をクリックします。

6. 「ロールまたはユーザー」列にリストされているユーザー、グループまたはロールごとに、付与するアクセス・レベルを指定します。付与できる権限は、「付与」、「作成」、「削除」、「編集」、「パーソナライズ」および「表示」です。
各権限の詳細は、第43.5.1.3項「ページのアクセス権限の設定」を参照してください。

7. オプションで、「ログイン・ユーザー・アクセス用の認証ロールの追加」アイコンをクリックしてauthenticated-roleを追加し、認証されたすべてのユーザーのアクセス権限を定義できます。anonymous-roleを追加し、必要な権限をすべてのユーザーに付与するには、「パブリック・アクセス用の匿名ロールの追加」アイコンをクリックします。

8. 任意のユーザー、グループまたはロールの権限を取り消す場合は、そのエンティティを選択し、「アクセス権限の削除」をクリックします。

9. 「OK」をクリックして、ページのセキュリティ設定を保存します。
ページの「アクセス」列に表示される鍵アイコンは、そのページのアクセス方法として「セキュリティの委譲」が設定されていることを示し、矢印アイコンは、そのページのアクセス方法として「親のセキュリティの継承」が設定されていることを示しています(図43-21)。

図43-21 ページに指定されたアクセス方法

43.5.1.3.2 ルート・ノードの権限の設定

セキュリティがオーバーライドされていないページ・ノードとサブページ・ノードのアクセス設定は、ルート・ノードから導出されます。ルート・ノードの権限を定義するには、「アセット」タブの「ページ」ページにある「デフォルト・アクセスの設定」オプションを使用します(図43-22)。残りの手順は、特定のページの権限を設定する手順と同じです。詳細は、第43.5.1.3.1項「個々のページの権限の設定」を参照してください。

ルート・ノードの設定時には、他の権限に加えて、「管理」権限も設定できます。この権限を持つユーザーは、個々のページの設定にかかわらず、ページ階層全体にアクセスできます。

図43-22 ルート・ノードのアクセス権限の設定

43.5.1.4 ページの並替え

ページは並べ替えることができます。この順序は、ページ問合せを通じてページをナビゲーション・モデルに含めるときに使用されます。

ページの順序を変更するには:

1. 管理コンソールの「アセット」ページに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 左側にあるナビゲーション・パネルの「ページ」をクリックします。

3. ページ階層内の必要な場所にページをドラッグします。
ページの順序を変更するために、「並替え」列に表示されたアイコンを使用することもできます(図43-23)。これらのアイコンを使用すると、ページをリストの先頭、リストの末尾、直前のページの前、またはリストの次に表示されているページの後に移動できます。

図43-23 ページの並替え

43.5.1.5 ページ階層内のページの移動

ページ階層でのページの表示レベルを変更できます。ページを移動して、サブページ、ルート・レベルのページ、または親ページとして表示できます。

ページ階層内でページを移動する手順は、次のとおりです。

1. 管理コンソールの「アセット」ページに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 左側にあるナビゲーション・パネルの「ページ」をクリックします。

3. 移動するページの「アクション」メニューを開き、「ページの移動」を選択します(図43-24)。

図43-24 ページの「アクション」メニュー

4. 「ページの移動」ダイアログで、ページの移動先となるページ階層内のレベルを選択します。
たとえば、ページをMyPageのサブページとして表示する場合は、「MyPage」をクリックします(図43-25)。

図43-25 ページの移動

5. 「OK」をクリックします。
図43-26で、「サブページ」列に表示されているサブページ・アイコンは、MyPageにサブページが含まれていることを示しています。

図43-26 ページ階層内の更新されたページ

43.5.1.6 ページ名の変更

ページ名を変更する手順は、次のとおりです。

1. 第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」の説明に従って、管理コンソールの「アセット」ページに移動します。

2. 左側にあるナビゲーション・パネルの「ページ」をクリックします。

3. 名前を変更するページの「アクション」メニューを開き、「ページ名の変更」を選択します。

4. 「ページ名の変更」ダイアログで、任意の名前を入力します。

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

43.5.2 アセットの作成

アプリケーションのデプロイ後も、管理者は組織の要件に合わせて、そのアプリケーションを定期的に更新する必要があります。Portal Frameworkアプリケーションを使用すると、アプリケーションを再デプロイする必要なく、アセットを実行時に作成および編集できます。

注意:
実行時に、コンテンツ・プレゼンタ表示テンプレートを作成することはできません。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「コンテンツ・プレゼンタ表示テンプレートの作成」を参照してください。

アセットを作成するには:

注意:
ページ、ページレットまたはデータ・コントロールの作成手順は、他のアセットの場合と異なります。

- ページの作成の詳細は、第43.5.1.1項「ページの作成」を参照してください。

- ページレットの作成の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のOracle WebCenter Portalのページレット・プロデューサを使用したページレットの作成に関する項を参照してください。

- データ・コントロールの作成の詳細は、Oracle WebCenter Portalでのポータルの構築のデータ・コントロールの作成に関する項を参照してください。Portal Frameworkアプリケーションの実行時にデータ・コントロールを作成する手順は、WebCenter Portalの場合に似ています。

- 実行時のページ・スタイルとタスク・フロー・スタイルの作成は、既存のスタイルをコピーすることによってのみ行えます。詳細は、第43.5.3項「アセットのコピー」を参照してください。

1. 管理コンソールの「アセット」ページに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 左側にあるナビゲーション・パネルで、作成するアセットのカテゴリを選択します。

3. メニュー・バーの「作成」をクリックします。

4. 「作成」ダイアログの「名前」フィールドに、アセットの名前を入力します。

5. 「説明」フィールドに、アセットの説明を入力します。

6. 「コピー元」リストから、新規アセットを作成するために拡張する既存のアセットを選択します。

注意:
「コピー元」リストは、ページ・テンプレート、ナビゲーション、リソース・カタログおよびスキンに対して提供されます。タスク・フローでは使用できません。

7. (タスク・フローの場合のみ) 新しいアセットに使用する「タスク・フロー・スタイル」を選択します。

8. 「作成」をクリックします。
新しく作成したアセットが「アセット」ページにリストされます。アセットの隣にあるチェック・ボックスが空の場合、そのアセットがまだ公開されておらず、ユーザーが使用できないことを示しています。アセットの公開の詳細は、第43.5.6項「アセットの表示と非表示」を参照してください。

43.5.3 アセットのコピー

アセットのコピーを作成できます。この機能は、アセットのバックアップを作成する場合や、元のアセットの使用中にアセットを更新する場合、または新しいアセットを作成する開始点として既存のアセットを使用する場合に役立ちます。リソースのコピーを作成すると、そのコピーは非表示としてマークされます。

アセットのコピーを作成する手順は、次のとおりです。

1. 管理コンソールの「アセット」ページに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 左側にあるナビゲーション・パネルで、任意のアセット・タイプを選択します。

3. アセットのリストから、コピーするアセットを選択します。

4. 「アクション」メニューの「コピー」を選択します。

注意:
ページのコピーを作成するには、ページの「アクション」メニューから「ページのコピー」を選択します。「ページのコピー」ダイアログで、ページ名を指定し、「OK」をクリックします。

5. 「コピー」ダイアログで、「表示名」フィールドにコピーの名前を入力します(図43-27)。

図43-27 アセットのコピー

6. 「説明」フィールドに、新しいアセットの説明を入力します。

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

43.5.4 アセットの編集

実行時には、次の2つのタイプのアセットの編集が可能です。

- 編集: コンポーザまたは「編集」ダイアログを使用してアセットを編集する方法を提供します。

- ソースの編集: アセットのソース・コードを編集できます。

43.5.4.1 「編集」オプションを使用したアセットの編集

実行時にアセットを編集するには:

1. 管理コンソールの「アセット」ページに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 左側にあるナビゲーション・パネルで、任意のアセット・タイプを選択します。

3. アセットのリストから、編集するアセットを選択します。

4. 「アクション」列で、「編集」をクリックします(図43-28)。

注意:
ページを編集するには、ページの「アクション」メニューから「ページの編集」オプションを選択します。

図43-28 アセットの「編集」オプション

5. 必要に応じてアセットを編集します。

編集できるプロパティは、アセットによって異なります。編集できるアセットのプロパティについては、Oracle WebCenter Portalでのポータルの構築の「編集」オプションを使用したアセットの編集に関する項にリストされている、関連アセットの章を参照してください。Portal Frameworkアプリケーションの実行時にアセットを編集する手順は、WebCenter Portalの場合に似ています。

43.5.4.2 アセットのソース・コードの編集

実行時のアセットの編集をよりきめ細かく制御するには、データ・コントロールとページを除く任意のカスタム・アセットの基礎となるソース・コードを編集します。

アセットのソース・コードを編集するには:

1. 管理コンソールの「アセット」ページに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 左側にあるナビゲーション・パネルで、任意のアセット・タイプを選択します。

3. アセットのリストから、編集するアセットを選択します。

4. 「アクション」メニューの「ソースの編集」を選択します。
「ソースの編集」ダイアログに、アセット定義が表示されます。

5. 必要に応じてコードを編集します(図43-29)。
コード内のXML構文は検証され、タグが欠けていたり誤って追加された場合は、エラー・メッセージが表示されます。検証は、CSSファイルなど、XML以外のファイルに対しては実行されません。

図43-29 アセットのソースの編集

6. 完了したら、「保存して閉じる」をクリックします。

43.5.5 アセットのプロパティの設定

各アセットには、その表示プロパティおよび属性を定義する、特定の関連プロパティがあります。認可されたユーザーは、「プロパティの編集」ダイアログを使用して、これらのプロパティを編集できます。「プロパティの編集」ダイアログに表示されるプロパティの詳細は、Oracle WebCenter Portalでのポータルの構築のアセットに関する情報の表示に関する項を参照してください。

この項では、「プロパティの編集」ダイアログへのアクセス方法とアセット・プロパティの設定方法について説明します。次のトピックが含まれています。

注意:
この項で説明するプロパティは、ページ・アセットには当てはまりません。

- 第43.5.5.1項「アセットの「プロパティの編集」ダイアログへのアクセス」

- 第43.5.5.2項「アセットの名前または説明の編集」

- 第43.5.5.3項「アイコンとアセットの関連付け」

- 第43.5.5.4項「アセットの分類」

- 第43.5.5.5項「アセット属性の設定」

43.5.5.1 アセットの「プロパティの編集」ダイアログへのアクセス

アセットの「プロパティの編集」ダイアログにアクセスする手順は、次のとおりです。

1. 管理コンソールの「アセット」ページに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 左側にあるナビゲーション・パネルで、任意のアセット・タイプを選択します。

3. アセットのリストから、編集するアセットを選択します。

4. 「アクション」メニューの「プロパティの編集」を選択します。
「プロパティの編集」ダイアログが開きます(図43-30)。

図43-30 アセットの「プロパティの編集」ダイアログ

5. 必要に応じてプロパティを編集します。詳細は、次を参照してください。

- 第43.5.5.2項「アセットの名前または説明の編集」

- 第43.5.5.3項「アイコンとアセットの関連付け」

- 第43.5.5.4項「アセットの分類」

- 第43.5.5.5項「アセット属性の設定」

6. 完了したら、「OK」をクリックします。

43.5.5.2 アセットの名前または説明の編集

アセットは、その表示名に従って、「アセット」ページ上でソートされます。アセット・セットが整理された状態を維持するには、基準となる名前付けスキームと説明方法を決定することを検討します。これは必須手順ではありませんが、特定のアセットの用途を明確に識別する際に役立つ場合があります。

アセットの名前または説明を編集するには:

1. 第43.5.5.1項「アセットの「プロパティの編集」ダイアログへのアクセス」の手順に従って、編集するアセットの「プロパティの編集」ダイアログを開きます。

2. 「表示名」フィールドで、アセットの表示名を編集します。

3. 「説明」フィールドに、アセットの説明を入力します。

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

43.5.5.3 アイコンとアセットの関連付け

アイコンとアイコンを関連付けることができます。WebCenter Portalの現在のバージョンでは、実行時にページを作成するときに、ページ・スタイルに対してのみ、それに関連付けられたアイコンが表示されます。

アイコンとアイコンを関連付ける手順は、次のとおりです。

1. 第43.5.5.1項「アセットの「プロパティの編集」ダイアログへのアクセス」の手順に従って、編集するアセットの「プロパティの編集」ダイアログを開きます。

2. 「アイコンURI」フィールドに、目的のアイコンへの標準URIパスを入力します。
たとえば、次のように入力します。

/mycompany/webcenter/page/images/myimage.png

指定できるのは、絶対URL(ブラウザのアドレス・フィールドに入力した場合でも機能するURL)か、アプリケーションの/oracle/webcenter/siteresources/scopedMD/sharedフォルダに格納されているイメージを指す相対URLです。

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

43.5.5.4 アセットの分類

アセットは、関連グループに分類できます。たとえば、営業に関連付けられたすべてのページ・スタイルは、salesカテゴリに分類されます。この値は、「プロパティの編集」ダイアログでのみ公開され、使用できます。

アセットを分類する手順は次のとおりです。

1. 第43.5.5.1項「アセットの「プロパティの編集」ダイアログへのアクセス」の手順に従って、編集するアセットの「プロパティの編集」ダイアログを開きます。

2. 「カテゴリ」フィールドにカテゴリ名を入力します。

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

43.5.5.5 アセット属性の設定

「プロパティの編集」ダイアログを通じて公開されるデフォルトの属性(「表示名」、「説明」など)に加えて、アセットのカスタム属性を公開することもできます。「プロパティの編集」ダイアログでは、属性の名前と値のペアを入力するための「属性」セクションが提供されます(図43-31)。

図43-31 アセットの「属性」セクション

たとえば、editPageAfterCreationはページ・スタイルのカスタム属性で、そのスタイルの新規作成ページを編集モードまたは表示モードのいずれで開くかを制御します。値は、trueまたはfalseです。この属性を特定のページ・スタイルに関連付けると、選択したスタイルに基づいてユーザーがページを作成するたびに属性値が考慮され、それに従ってページが動作します。

アセット属性を設定する手順は次のとおりです。

1. 第43.5.5.1項「アセットの「プロパティの編集」ダイアログへのアクセス」の手順に従って、編集するアセットの「プロパティの編集」ダイアログを開きます。

2. 「属性」セクションの「名前」フィールドに、属性名を入力します。

3. 「値」フィールドに、属性の値を入力します。

4. さらに属性を追加する場合は、「さらに追加」をクリックします。
これにより、「属性」セクションに新しい行が追加されます。その後、「名前」および「値」フィールドに、必要な詳細を入力できます。

5. アセットに関連付けられている属性を削除するには、削除する属性の隣に表示されている「削除」アイコンをクリックします。

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

43.5.6 アセットの表示と非表示

アセットを作成すると、そのアセットはデフォルトで非表示としてマークされます。非表示のアセットは、アセット・ピッカー内で使用できません。アセットを使用可能にするには、そのアセットを公開する必要があります。

使用可能なすべてのアセットについて、「アセット」ページ上のアセットに対する「使用可能」列に、青色のチェックマークが付いたチェック・ボックスが表示されます。「使用可能」列のチェック・ボックスが空の場合、そのアセットが非表示としてマークされていることを示しています(図43-32)。

図43-32 アセットの表示と非表示

アセットを表示または非表示にする手順は、次のとおりです。

1. 管理コンソールの「アセット」ページに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 左側にあるナビゲーション・パネルで、任意のアセット・タイプを選択します。

3. アセットのリストから、表示または非表示にするアセットを選択します。

4. 非表示のアセットを表示するには、「使用可能」列の空のチェック・ボックスを選択します。
使用可能なアセットを非表示にするには、「使用可能」列のチェック・ボックスを選択解除します。

注意:
ページを使用可能としてマークするには、「アセット」ページにある「ページを表示」列のチェック・ボックスを選択します。このチェック・ボックスが空の場合、ページは非表示としてマークされます。

43.5.7 アセット・セキュリティの設定

アプリケーション内のアセットに、すべてのユーザーがアクセスできるか、特定のユーザーまたはグループのみがアクセスできるかを制御できます。デフォルトでは、アプリケーションレベルの権限によって、アセットのアクセス権限が制御されます。「セキュリティ設定」ダイアログでは、アプリケーションレベルの権限とは別に、選択したアセットに対する特定の権限を定義できます。

ページのアクセス権限の設定の詳細は、第43.5.1.3項「ページのアクセス権限の設定」を参照してください。

ページ以外のアセットにアクセス権限を設定する手順は、次のとおりです。

1. 管理コンソールの「アセット」ページに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 左側にあるナビゲーション・パネルで、任意のアセット・タイプを選択します。

3. アセットのリストから、アクセス権限を設定するアセットを選択します。

4. 「アクション」メニューの「セキュリティ設定」を選択します。

5. 「セキュリティ設定」ダイアログで、次のいずれかのオプションを選択して、アクセス方法を指定します(図43-33)。

- カスタム権限の使用 - 選択したアセットを管理および更新できるユーザーを定義する場合、このオプションを選択します。このオプションを選択した場合、ダイアログ内の他のコントロールは使用可能になります。手順6に進んでください。

注意:
「カスタム権限の使用」を選択した場合、1人以上のユーザーまたは1つ以上のグループに「管理」アクセス権限が付与されていることを確認してください。

- アプリケーション権限の使用 - 選択したアセットのアクセス設定を、アプリケーション用に定義した設定から継承する場合、このオプションを選択します。このオプションを選択した場合、「OK」をクリックして変更を保存し、ダイアログを終了します。

注意:
「アプリケーション権限の使用」を選択すると、すでに設定されているカスタム権限はすべて削除されます。

図43-33 アセットの「セキュリティ設定」ダイアログ

6. 「カスタム権限の使用」を選択した場合、アセットのアクセス権限を付与するユーザーまたはグループを指定します。

- アイデンティティ・ストアで選択可能な個々のユーザーを検索および選択するには、「ユーザーの追加」をクリックします。

- アイデンティティ・ストアで選択可能なユーザーのグループを検索および選択するには、「グループの追加」をクリックします。

7. 選択されているユーザーまたはグループごとに、付与するアクセス・レベルを指定します。次を選択します。

- 管理: アセットへの完全なアクセス権限を付与する場合にクリックします。これらのユーザーは、編集、削除、アクセス権限の付与、表示または非表示などのタスクを実行できます。

- 更新: アセットを編集する権限を付与する場合にクリックします。これらのユーザーは、アセットを編集できますが、削除できません。

8. 任意のユーザーまたはグループの権限を取り消す場合は、そのエンティティを選択し、「アクセス権限の削除」をクリックします。

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

43.5.8 アセットのアップロードとダウンロード

デプロイ済のアプリケーションでは、実行時にアセットを編集できます。ただし、よりきめ細やかな制御を行う目的で、設計時にアセットを編集することもできます。この場合、実行時に作成したアセットをダウンロードし、設計時にJDeveloperで編集した後、更新されたアセットを再度アプリケーションにアップロードできるため、アプリケーションを再デプロイする必要はありません。

注意:
ページとページレットは、アセット・レベルでダウンロードまたはアップロードできません。

「ダウンロード」および「アップロード」オプションを使用すると、デプロイ後のラウンドトリップ・アプリケーション開発が可能になります。これらのアクションによって、より簡単に、新しいアセットや更新されたアセットをJDeveloperからアプリケーションに移動し、必要に応じて、それらのアセットをアプリケーションからJDeveloperでの開発に戻すことができます。

43.5.8.1 アセットのダウンロード

アセットをダウンロードすると、その構成がアーカイブ・ファイル内に保存されます。このアーカイブ・ファイルは、ローカル・ファイル・システムまたはリモート・サーバー・ファイル・システムに保存できます。

アセットをダウンロードする手順は次のとおりです。

1. 管理コンソールの「アセット」ページに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 左側にあるナビゲーション・パネルで、任意のアセット・タイプを選択します。

3. アセットのリストから、ダウンロードするアセットを選択します。

4. メニュー・バーの「ダウンロード」をクリックします。

5. 「ダウンロード」ダイアログの「アーカイブ・ファイル名」フィールドに、エクスポート・アーカイブ・ファイルの名前を入力します。

6. 次を選択します。

- 自分のコンピュータに保存: エクスポート・アーカイブ・ファイルをローカル・ファイル・システムに保存する場合にクリックします。

- WebCenter Portalサーバーに保存: エクスポート・アーカイブ・ファイルをリモート・サーバー・ファイル・システムに保存する場合にクリックします。「パス」フィールドにサーバー上でアーカイブ・ファイルを保存する場所を入力します。

7. 「ダウンロード」をクリックします。

8. アセットをダウンロードしたら、それをJDeveloperにインポートできます。

43.5.8.2 アセットのアップロード

JDeveloperでアセットを編集したら、それらを実行時にアプリケーションにアップロードできます。

アセットをアップロードする際の注意事項:

- 既存のアセット、つまり、同じ内部IDを持つアセットが上書きされます。

- ローカル・ファイル・システムまたはリモート・サーバー上のアセットは、アーカイブ・ファイル形式にする必要があります。

実行時にアセットをアップロードする手順は、次のとおりです。

1. 管理コンソールの「アセット」ページに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 左側にあるナビゲーション・パネルで、任意のアセット・タイプを選択します。

3. メニュー・バーの「アップロード」をクリックします。

4. 「アップロード」ダイアログで、次を選択します。

- 自分のコンピュータで表示: ローカル・ファイル・システムからアーカイブ・ファイルをアップロードする場合にクリックします。ファイルを見つけるには、「ファイルの選択」をクリックします。

- WebCenter Portalサーバーで表示: リモート・サーバー・ファイル・システムにアーカイブ・ファイルをアップロードする場合にクリックします。下のフィールドに、サーバー上でファイルを見つける場所を入力します。

5. 「アップロード」をクリックします。

6. アセットがポータルにすでに存在する場合は、「はい」をクリックして、アセットをアーカイブ・ファイルのコンテンツで置き換えることを確定します。

43.5.9 アセットのプレビュー

実行時にアセットを編集し、変更をプレビューした後、必要に応じてさらに調整を行うことができます。

アセットをプレビューするには:

1. 管理コンソールの「アセット」ページに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 左側にあるナビゲーション・パネルで、任意のアセット・タイプを選択します。

3. プレビューするアセットの名前をクリックします。

注意:
すべてのアセットをプレビューできるわけではありません。アセットの名前がハイパーリンクではない場合、そのアセットはプレビューできません。

アセットは、ポータルでの使用時と同様に表示されます。

4. アセットを表示して操作し、希望どおりの外観と動作が得られるかどうかを確認します。

5. 完了したら、「閉じる」をクリックします。
アセットを編集して変更を加えたり、アセットを公開してアプリケーションで使用できるようにすることができます。

43.5.10 アセットの削除

アセットが不要になったら、そのアセットをアプリケーションから削除できます。組込みアセットは削除できません。

注意:
アセットを削除する前に、そのアセットが使用中でないことを確認する必要があります。アセットを削除対象としてマークすると、使用中であっても削除されます。

アセットを削除するには:

1. 管理コンソールの「アセット」ページに移動します。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 左側にあるナビゲーション・パネルで、任意のアセット・タイプを選択します。

3. アセットのリストから、削除するアセットを選択します。

4. メニュー・バーの「削除」をクリックします。

注意:
ページを削除するには、ページの「アクション」メニューから「ページの削除」オプションを選択します。ページを削除すると、そのサブページも削除されます。

5. 「削除」ダイアログで、「OK」をクリックしてプロセスを完了します。

43.6 Portal Frameworkアプリケーションのサービス、ポートレット・プロデューサおよび外部アプリケーションの構成

WebCenter Portal管理コンソールを通じて、Portal Frameworkアプリケーションに対する複数のWebCenter Portalサービスを管理および構成できます。「サービス」タブ(図43-34)からは、コンテンツ・リポジトリ、投票、ポートレット・プロデューサおよび外部アプリケーションを管理および構成できます。

図43-34 WebCenter Portal管理コンソール: 「サービス」タブ

分析など、一部のサービスはデフォルトで使用できるため、管理者レベルでの構成は不要です。投票など、その他のサービスを稼働させるには、管理権限を持つユーザーによる追加の構成が必要です。

この項には次のトピックが含まれます:

- 第43.6.1項「コンテンツの管理」

- 第43.6.2章「ポートレット・プロデューサの管理」

- 第43.6.3項「外部アプリケーションの管理」

- 第43.6.4項「投票の作成と構成」

43.6.1 コンテンツの管理

システム管理者は、WebCenter Portal管理コンソールを通じて、アプリケーションのプライマリ・コンテンツ・リポジトリに格納されたコンテンツを管理できます(図43-35)。管理者は、ここからコンテンツの追加、編集、更新、ドキュメント・バージョン履歴の管理、および役立つ情報(ファイルとフォルダのダイレクトURLやダウンロードURLなど)へのアクセスを実行できます。

Portal Frameworkアプリケーションのコンテンツ・リポジトリを登録し、プライマリ(またはデフォルト)・コンテンツ・リポジトリを決定するのは、システム管理者の職責です。この管理ページに、異なるコンテンツ・リポジトリのコンテンツを表示する必要がある場合は、プライマリ(またはデフォルト)・コンテンツ・リポジトリ接続の再構成が必要になることがあります。第9.7項「アクティブな(またはデフォルトの)コンテンツ・リポジトリ接続の変更」を参照してください。

図43-35 プライマリ・ドキュメント・リポジトリのコンテンツ

この項には次のトピックが含まれます:

- 第43.6.1.1項「新規フォルダの作成」

- 第43.6.1.2項「Wikiページの作成」

- 第43.6.1.3項「ファイルの編集」

- 第43.6.1.4項「ドキュメントのアップロード」

- 第43.6.1.5項「ドキュメントのチェックアウト」

- 第43.6.1.6項「ドキュメントの新規バージョンのアップロード」

- 第43.6.1.7項「コンテンツ・アイテムのバージョン履歴の表示」

- 第43.6.1.8項「ドキュメントのダイレクトURLとダウンロードURLの取得」

- 第43.6.1.9項「表示コンテンツの列の整理」

- 第43.6.1.10項「フォルダとドキュメントのセキュリティの設定」

43.6.1.1 新規フォルダの作成

新規フォルダを作成するには:

1. 管理コンソールに移動して、「サービス」タブを開きます。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「コンテンツ」を選択します。

3. 新規フォルダの作成先となるフォルダを開きます。

4. 「ファイル」メニューの「新規フォルダ」を選択します。

5. 「フォルダの作成」ダイアログで、「フォルダ名」フィールドにわかりやすい名前を入力し、「作成」をクリックして、フォルダを作成します。

ヒント:
フォルダの名前を変更したり、フォルダを削除するには、「ファイル」メニューから適切なオプションを選択します。このメニューでは、フォルダに格納されたコンテンツの切取り、コピーおよび貼り付けを実行するためのオプションも提供されます。
ディレクトリ内のフォルダを非表示にするには、「表示」メニューの「フォルダの非表示」を選択します。非表示のフォルダを表示するには、「フォルダの非表示」オプションを選択解除します。

43.6.1.2 Wikiページの作成

Wikiドキュメントを作成するには:

1. 管理コンソールに移動して、「サービス」タブを開きます。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「コンテンツ」を選択します。

3. Wikiページの作成先となるフォルダを選択します。

4. 「新規Wikiドキュメント」をクリックします。
リッチ・テキスト・エディタが表示されます。

5. 「タイトル」フィールドにわかりやすいタイトルを入力し、「作成」をクリックして、選択したフォルダにWikiページを作成します。

43.6.1.3 ファイルの編集

Wikiドキュメントなどのコンテンツを編集するには:

1. 管理コンソールに移動して、「サービス」タブを開きます。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「コンテンツ」を選択します。

3. 編集するアイテムをクリックします。
Wiki、ブログおよびその他のリッチ・テキスト・ベースのコンテンツを直接編集できます。ダウンロードする必要があるその他のファイル形式については、変更を行ってから、ファイルをアップロードします。

4. 「ファイル」メニューの「編集」を選択します。
Wikiの場合は、ファイルがリッチ・テキスト・エディタ内で開きます(図43-36)。

図43-36 編集用に開いたWikiページ

5. 「保存して閉じる」をクリックし、ドキュメントを保存して閉じます。

43.6.1.4 ドキュメントのアップロード

ドキュメントをアップロードする手順は、次のとおりです。

1. 管理コンソールに移動して、「サービス」タブを開きます。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「コンテンツ」を選択します。

3. ドキュメントのアップロード先となるフォルダを選択します。

4. 「ドキュメントのアップロード」をクリックします。「<Folder Name>へのドキュメントのアップロード」ダイアログが表示されます。

5. 「ドキュメントのアップロード」セクションで、「参照」をクリックし、必要なドキュメントを選択します。必要に応じて「説明」セクションに説明を入力し、「アップロード」をクリックします。選択したディレクトリにドキュメントがアップロードされます。
Portal Frameworkアプリケーションの最大ファイル・アップロード・サイズは2MBです。Portal Frameworkアプリケーション開発者は、この制限を設計時にカスタマイズできます。

ヒント:
一度に複数のドキュメントをアップロードできます。「追加」をクリックしてフィールドを追加することによって、任意の数のドキュメントをアップロードできます。
ドキュメントをダウンロードするには、そのドキュメントを選択し、「ダウンロード」をクリックします。

43.6.1.5 ドキュメントのチェックアウト

ドキュメントをチェックアウトする手順は、次のとおりです。

1. 管理コンソールに移動して、「サービス」タブを開きます。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「コンテンツ」を選択します。

3. チェックアウトするドキュメントを選択します。

4. 「ファイル」メニューの「チェックアウト」を選択します。ドキュメントがチェックアウトされ、チェックアウト済のステータスを示す鍵アイコンが表示されます(図43-37)。

図43-37 チェックアウトされたドキュメント

ヒント:
チェックアウトを取り消すには、ディレクトリ内でそのドキュメントを選択し、「ファイル」メニューの「チェックアウトの取消」を選択します。

43.6.1.6 ドキュメントの新規バージョンのアップロード

ドキュメントの新規バージョンをアップロードする手順は、次のとおりです。

1. 管理コンソールに移動して、「サービス」タブを開きます。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「コンテンツ」を選択します。

3. チェックアウトするドキュメントを選択します。

4. 「ファイル」メニューの「新規バージョンのアップロード」を選択します。

5. 「新規バージョンのアップロード」ダイアログで、「参照」をクリックし、ドキュメントの別のバージョンを選択します(図43-38)。必要に応じて説明を入力し、「アップロード」をクリックします。

図43-38 ドキュメントの新規バージョンのアップロード

43.6.1.7 コンテンツ・アイテムのバージョン履歴の表示

イメージやWikiページなどのドキュメントのバージョン履歴を表示する手順は、次のとおりです。

1. 管理コンソールに移動して、「サービス」タブを開きます。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「コンテンツ」を選択します。

3. ドキュメントがあるフォルダに移動します。

4. バージョン履歴を表示するドキュメントを選択します。

5. 「表示」メニューの「バージョン履歴」を選択します。バージョン履歴が表示されます(図43-39)。

図43-39 ドキュメントのバージョン履歴

ヒント:
アイテムのプロパティを表示するには、ディレクトリ内でそのアイテムを選択し、「表示」メニューの「プロパティ」を選択します。

43.6.1.8 ドキュメントのダイレクトURLとダウンロードURLの取得

ダイレクトURLを使用するとドキュメントを表示でき、ダウンロードURLを使用するとそのドキュメントをダウンロードできます。これらのURLを取得する手順は、次のとおりです。

1. 管理コンソールに移動して、「サービス」タブを開きます。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「コンテンツ」を選択します。

3. ドキュメントがあるフォルダに移動します。

4. URLを取得するドキュメントを選択します。

5. 「表示」メニューの「リンクの取得」を選択します。

6. 「リンクの取得」ダイアログで、このドキュメントを表示する場合は、「ダイレクトURL」をクリックします。このドキュメントをダウンロードする場合は、「ダウンロードURL」をクリックします。

43.6.1.9 表示コンテンツの列の整理

プライマリ・リポジトリ内のアイテムごとに、コンテンツ・アイテムの名前、最終変更日、チェックアウト・ステータスなど、表示する関連情報を選択できます。また、選択した列を並べ替えて、任意の情報を特定の順序で表示することもできます。

43.6.1.9.1 列の表示

コンテンツ・アイテムに関して表示する情報の列を選択する手順は、次のとおりです。

1. 管理コンソールに移動して、「サービス」タブを開きます。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「コンテンツ」を選択します。

3. ドキュメントがあるフォルダに移動します。

4. 「表示」メニューの「列」を選択し、コンテンツ・アイテムに関して表示する情報のタイトルを選択します(図43-8)。

図43-40 列: 表示

43.6.1.9.2 列の並替え

列を並べ替える手順は、次のとおりです。

1. 管理コンソールに移動して、「サービス」タブを開きます。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「コンテンツ」を選択します。

3. ドキュメントがあるフォルダに移動します。

4. 「表示」メニューの「列の並替え」を選択します。
「列の並替え」ダイアログが表示されます(図43-41)。

図43-41 列: 並替え

43.6.1.10 フォルダとドキュメントのセキュリティの設定

次の条件を満たすと、「ファイル」メニューの「コンテンツ」タブに「セキュリティ」メニュー・アイテムが表示されます。

- 第9.2.3.9項「アイテム・レベルのセキュリティの構成」の説明に従って、Oracle WebCenter Content Serverでアイテム・レベルのセキュリティを有効化した。

- 第9.2.3.9項「アイテム・レベルのセキュリティの構成」の説明に従ってOracle WebCenter Content Serverでアイテム・レベルのセキュリティを有効化したときに、該当するドキュメントに割り当てられたセキュリティ・グループがSpecialAuthGroups設定にリストされた。

- ユーザーがOracle WebCenter Content Serverのドキュメントまたはフォルダの管理権限を持っている。

セキュリティ機能の使用の詳細は、『Oracle WebCenter Portalの使用』のフォルダまたはファイルでのセキュリティ・オプションの設定に関する項を参照してください。

43.6.2 ポートレット・プロデューサの管理

管理コンソールを使用すると、ポートレット・プロデューサの登録、編集および削除を行うことができます。管理コンソールを使用してポートレット・プロデューサを管理する方法の詳細は、第21.9項「管理コンソールを使用したポートレット・プロデューサの管理」を参照してください。

43.6.3 外部アプリケーションの管理

WebCenter Portal管理コンソールを使用すると、外部アプリケーションの登録、編集および削除を行うことができます。WebCenter Portal管理コンソールを使用して外部アプリケーションを管理する方法の詳細は、第23.4項「WebCenter Portal管理コンソールを使用した外部アプリケーションの管理」を参照してください。

43.6.4 投票の作成と構成

システム管理者は、WebCenter Portal管理コンソールを通じて、実行時にPortal Frameworkアプリケーションのオンライン投票を作成および構成できます。投票を使用すると、関係者の調査(意見および経験レベルなど)、重要な情報を思い出すことができるかどうかの確認、およびフィードバックの収集ができます。

この項には次のトピックが含まれます:

- 第43.6.4.1項「投票について」

- 第43.6.4.2項「投票の作成、構成および分析」

- 第43.6.4.3項「投票の編集」

- 第43.6.4.4項「投票の削除」

- 第43.6.4.5項「投票のクローズ」

- 第43.6.4.6項「投票の結果の分析」

- 第43.6.4.7項「投票の実施」

- 第43.6.4.8項「投票タスク・フローのプロパティの設定」

43.6.4.1 投票について

投票を使用すると、投票を実施するだけでなく、次のことを実行できます。

- 「投票の作成」アイコンをクリックし、セクション見出しと質問を追加することによって、投票を作成します。

- 投票の配信スケジュールを設定します。

- 投票を、新規投票で使用できるテンプレートとして保存します。

- 投票の結果を分析します。

投票は、RSS、検索(投票テキストの検索)、インスタント・メッセージおよびプレゼンス、最近のアクティビティなど、多くのWebCenter Portalサービスと統合されています。

図43-42は、投票の例を示しています。

図43-42 投票の例

ユーザーが投票を完了するには、その投票が公開され、オープンしている必要があります。未公開またはクローズした投票は完了できません。

43.6.4.2 投票の作成、構成および分析

「投票」ページ(図43-43)では、投票を作成し、それらに対して、投票の編集、保存(投票または投票テンプレートとして)、投票の公開、投票のクローズ、現在の投票のステータスの分析、投票の削除などの操作を実行できます。「投票」ページ上の投票データは、いつでも「リフレッシュ」アイコンをクリックして更新できます。

新規投票を追加するには:

1. 「サービス」管理タブをクリックします。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「投票」をクリックします(図43-43)。

図43-43 WebCenter Portal管理コンソール: 投票

3. 「投票の作成」をクリックします。
「投票の作成」ダイアログが開きます(図43-44)。

図43-44 「投票の作成」ダイアログ

4. 「名前」を入力し、必要に応じて投票の「説明」を入力して、「作成」をクリックします。
「デザイン」タブが開きます(図43-45)。

図43-45 投票の作成: 「デザイン」タブ

5. 「追加」をクリックして、オプションを選択します(図43-46)。
次のオプションから選択します。

- 質問の追加 - 新しい投票の質問を追加します

- セクションの追加 - 投票にセクションを追加します

- テンプレートの追加 - 投票に既存のテンプレートを適用します

図43-46 投票の作成: 「追加」オプション

6. 投票の質問を整理するためにセクションを追加するには、「セクションの追加」をクリックします。
「セクションの作成」ダイアログが開きます(図43-47)。

図43-47 投票: 「セクションの作成」ダイアログ

1. リッチ・テキスト・エディタで、セクションに対するわかりやすい説明テキストを入力します(図43-47)。

2. セクション見出しに書式を適用します(そうすることを選択した場合)。

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

4. 「追加」をクリックして、「セクションの追加」を選択し、投票に他のセクションを追加します。

7. セクション内の「追加」をクリックしてセクションの下に投票の質問を追加し、次に「質問の追加」を選択して(図43-48)各投票の質問を追加します。

図43-48 投票の作成: 「質問の追加」

「質問の作成」ダイアログが開きます(図43-49)。

図43-49 「質問の作成」ダイアログ

1. ドロップダウン・リストから質問のタイプを選択します(図43-50)。

図43-50 投票: 「質問の作成」および「質問の編集」ダイアログ: 質問のタイプ

2. 質問のテキストおよび回答選択肢を入力します(図43-51)。
複数選択式の問題の場合は、各選択肢を別々の行に記載する必要があります。

図43-51 投票: 「質問の作成」ダイアログ

3. ユーザーのレスポンスに対して説明またはコメントを追加する場合は、「コメント・フィールドの追加」を選択して、フィールドのラベルを入力し、行数を指定します。

4. 問題を必須にする場合は、「質問に対する回答が必要」を選択します。

5. 「OK」をクリックします。
この例の場合、現在のデザインは図43-52のようになります。

図43-52 投票の作成の例: 「デザイン」タブ

6. 「追加」をクリックして、「質問の追加」を選択し、セクションに他の質問を追加します。

8. 「スケジュール」タブをクリックし、投票の公開およびクローズ・オプションを選択します(図43-53を参照)。
投票を実施するには、ユーザーに対してその投票が公開され、オープンしている必要があります。未公開またはクローズした投票は実施できません。

図43-53 投票の作成: 「スケジュール」タブ

1. 「公開オプション」から選択を行います。
投票を編集用に下書きモードのままにするか、すぐに公開するか、指定日に公開するかを選択します。

指定日に公開することを選択した場合、カレンダーから公開時間を入力するには、「日付および時間の選択」アイコンをクリックします。

リッチ・テキスト・エディタで投票の始めに表示されるテキストをカスタマイズするには、「導入メッセージの編集」をクリックします。

2. 「クローズ・オプション」から選択を行います。
公開済の投票を、特定のレスポンス数に達した時点でクローズするか、特定の日にクローズするかを選択できます。両方のオプションを選択した場合、投票はいずれかの条件が満たされたときにクローズします。

指定日に投票をクローズすることを選択した場合、カレンダーからクローズ時間を入力するには、「日付および時間の選択」アイコンをクリックします。

リッチ・テキスト・エディタで投票の終わりに表示されるテキストをカスタマイズするには、「結びのメッセージの編集」をクリックします。

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

4. 「保存」をクリックして、スケジュールを保存します。

9. 「設定 」をクリックし、ユーザーが投票を実施した後に表示される内容を選択します(図43-54)。
たとえば、投票の実施後に表示される感謝ページとして、カスタムURLまたはJSFタスク・フローを設定できます。

図43-54 投票の作成: 「設定 」タブ

「投票の実施後」で、次のいずれかのオプションを選択します。

- 「結びのメッセージを'感謝'メッセージとして表示」または「投票結果を表示」
「投票結果を表示」を選択した場合は、「次のグラフで表示」で「2Dグラフ」または「3Dグラフ」を選択します。

- 「カスタムURLを'感謝'ページとして使用」
ユーザーの投票後に表示するページのURLを入力します。

URLは、ポータル・ページのURLまたは外部URLの任意のURLです。ポータルでページを作成する場合は、ここでそのページのプリティURLを指定できます(たとえば、http://<host>:<port>/webcenter/portal/<portalname>/pages/<pagename)。

- 「カスタム・タスク・フローを'感謝'ページとして使用」
ユーザーの投票後に表示するカスタム・タスク・フローのメタデータ・ファイルの場所をコピーします。メタデータ・ファイルの場所は、「アセット」ページの「タスク・フロー」ページで表示できます(Oracle WebCenter Portalでのポータルの構築のアセットに関する情報の表示に関する項を参照)。タスク・フローに使用できるオプションの詳細は、Oracle WebCenter Portalでのポータルの構築のタスク・フローの管理に関する項を参照してください。

カスタム・タスク・フローを作成する場合は、Oracle WebCenter Portalでのポータルの構築のデータを視覚化するタスク・フローの作成に関する項を参照して、タスク・フローが使用できることを確認します(Oracle WebCenter Portalでのポータルの構築のアセットの表示/非表示に関する項を参照)。

10. 投票の実施後、「分析」タブを開いて投票データを表示します。(図43-55)。
第43.6.4.6項「投票の結果の分析」を参照してください。

図43-55 投票の作成: 「分析」タブ

11. 「保存」をクリックして、投票を保存します(図43-56)。

図43-56 投票の保存

投票を保存するときに、テンプレートとして保存することが選択できます。テンプレートとして保存すると、後でその投票のテンプレートを他の投票に適用することができます。

図43-57は、 投票がポータル・ページで公開された後の状態を示しています。ユーザーが投票を表示して実施するには、ページに「投票の実施」タスク・フローを追加します。第43.6.4.7項「投票の実施」を参照してください。

図43-57 「投票の実施」タスク・フローに表示された投票

43.6.4.3 投票の編集

投票を編集するには:

1. 「サービス」管理タブをクリックします。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「投票」をクリックします(図43-43)。

3. 投票名リンクをクリックして、投票名と説明を編集します。

4. 「アクション」メニューをクリックして、「デザイン」を選択し、変更を加えます(図43-58)。
詳細は、第43.6.4.2項「投票の作成、構成および分析」を参照してください。

図43-58 投票の編集オプション

5. 「保存」、「閉じる」をクリックします。

43.6.4.4 投票の削除

投票を削除するには:

1. 「サービス」管理タブをクリックします。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「投票」をクリックします(図43-43)。

3. 投票を選択して、「アクション」メニューをクリックし、「削除」を選択します(図43-59)。

図43-59 投票の「削除」オプション

4. 「投票の削除」ダイアログで「はい」をクリックします。

5. 「保存」、「閉じる」をクリックします。

43.6.4.5 投票のクローズ

投票をクローズする手順は、次のとおりです。

1. 「サービス」管理タブをクリックします。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「投票」をクリックします(図43-43)。

3. 投票を選択して、「アクション」メニューをクリックし、「クローズ」を選択します(図43-60)。
「クローズ」オプションは、投票を公開した後にのみ使用できます。

図43-60 投票の「クローズ」オプション

投票のステータスが「クローズ済」に変更され、投票がクローズされた日時が表示されます。

ヒント:
投票を再度オープンする場合は、「アクション」メニューをクリックし、「公開」を選択します。

4. 「保存」、「閉じる」をクリックします。

43.6.4.6 投票の結果の分析

ユーザーが投票を実施した後に、投票の結果を分析することができます。

投票を分析する手順は、次のとおりです。

1. 「サービス」管理タブをクリックします。
第43.2項「Portal Frameworkアプリケーションの管理コンソールへのアクセス」を参照してください。

2. 「投票」をクリックします(図43-43)。

3. 「アクション」メニューをクリックして、「分析」を選択します(図43-61)。

図43-61 投票の「分析」オプション

「分析」ページが開きます(図43-62)。

図43-62 投票マネージャ: 「分析」ページ

4. 投票実施者がコメントを追加するために投票にフィールドを含めた場合は、「サマリーの表示」をクリックすると、統合されたコメントが表示されます。
「レスポンス・サマリー」ダイアログが開きます(図43-63)。

図43-63 「レスポンス・サマリー」ダイアログ

コメントを追加するオプションを投票回答者に与えた場合、すべてのコメントを表示するには、投票のカスタム・フィールド名の名前を開きます。

43.6.4.7 投票の実施

「投票の実施」タスク・フロー(図43-42)には、Poll Idパラメータを持つ特定の投票を表示するように設定されていないかぎり、最近公開された使用可能な投票が表示されます(図43-63)。

注意:
「投票の実施」タスク・フローを使用する手順は、次のとおりです。

- 「投票の実施」タスク・フローがリソース・カタログにない場合は、リソース・カタログに追加して、そのリソース・カタログを「ページのリソース・カタログ」に適用する必要があります。『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「リソース・カタログの開発」を参照してください。

- 「投票の実施」タスク・フローは、ポータルの適切なページに追加する必要があります。『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「ページの作成およびリソースの追加」を参照してください。

ユーザーがその投票のレスポンスを送信した後、このタスク・フローには、次の最近公開された投票が表示されます。

43.6.4.8 投票タスク・フローのプロパティの設定

投票タスク・フローには関連するプロパティがあり、十分な権限を持つユーザーは、これらのプロパティにコンポーザの「コンポーネント・プロパティ」ダイアログを介してアクセスできます(図43-64)。

図43-64 タスク・フローのコンポーネント・プロパティ

注意:
『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「投票タスク・フローのパラメータ」の表を参照してください。

43.7 Portal Frameworkアプリケーションの変更のステージングから本番への伝播

WebCenter Portal管理コンソールには、Portal Frameworkアプリケーションのメタデータをステージング・サーバーから本番サーバーに移行するための伝播ツールが含まれています。サイト管理者は、このツールを必要に応じて使用することで、承認された変更をダウンタイムを発生させることなく本番サーバーにプッシュします。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の伝播ツールを使用したステージングから本番への伝播に関する項を参照してください。

44 Portal Frameworkアプリケーションのエクスポート、インポート、バックアップおよびリカバリの管理

この章では、Portal Frameworkアプリケーションで使用可能なエクスポート、インポート、バックアップおよびリカバリの機能とツールについて説明します。

この章には次のトピックが含まれます:

- 第44.1項「データ移行のためのPortal Frameworkアプリケーションのエクスポートおよびインポート」

- 第44.2項「Portal Frameworkアプリケーションのバックアップおよびリカバリ」

Portal Frameworkアプリケーションでは、様々な機能についての構成および内容に関連するデータが複数の場所に格納されています。Oracle WebCenter Portalには、障害回復や、開発からステージングおよび本番までの本番ライフサイクル全体を容易にするための一連のユーティリティが用意されており、それによりこのデータをバックアップし、ステージング環境と本番環境のPortal Frameworkアプリケーションの間でデータを移動できます。

テスト・インスタンスを本番インスタンスに移行する場合は、管理者ガイドのOracle WebCenter Portalのターゲット環境への移動に関する項で、別の移行手段に関する説明を参照してください。

権限:
この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。
第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

44.1 データ移行のためのPortal Frameworkアプリケーションのエクスポートおよびインポート

この項では、Oracle JDeveloperを使用して開発したPortal Frameworkアプリケーションのメタデータおよびアプリケーションのカスタマイズをエクスポートおよびインポートする方法について説明します。

次の項が含まれます:

- 第44.1.1項「Portal Frameworkアプリケーションのエクスポートおよびインポートの理解」

- 第44.1.2項「Portal Frameworkアプリケーションのエクスポートおよびインポートの前提条件」

- 第44.1.3項「Portal Frameworkアプリケーションのポートレット・クライアント・メタデータのエクスポート」

- 第44.1.4項「Portal Frameworkアプリケーションのポートレット・クライアント・メタデータのインポート」

- 第44.1.5項「Portal Frameworkアプリケーションのポータル・リソースのエクスポート」

- 第44.1.6項「Portal Frameworkアプリケーションのポータル・リソースのインポート」

- 第44.1.7項「Portal Frameworkアプリケーションのメタデータのエクスポート」

- 第44.1.8項「Portal Frameworkアプリケーションのメタデータのインポート」

- 第44.1.9項「Portal Frameworkアプリケーションのセキュリティの移行」

- 第44.1.10項「Portal Frameworkアプリケーションのスキーマ・データの移行」

44.1.1 Portal Frameworkアプリケーションのエクスポートおよびインポートの理解

ステージング環境と本番環境間で、Portal Frameworkアプリケーション、アプリケーション間の接続およびカスタマイズ(つまり、アプリケーション、ページおよびポートレットに適用されたカスタマイズ)をエクスポートおよびインポートするには、いくつかの移行ツールを使用できます(図44-1)。

図44-1 Portal Frameworkアプリケーションのエクスポートおよびインポート

表44-1に、使用可能な移行ツールとその機能を示します。表44-1にリストされているすべてのカスタマイズは、Portal Frameworkアプリケーションを使用して移行されます。

表44-1 Portal Frameworkアプリケーション移行ツール

移行ツール

機能

ポートレット・クライアントWLSTコマンド

ポートレット・クライアント・メタデータ、ポートレット・カスタマイズおよびパーソナライズをエクスポートおよびインポートできます。

ポータル・リソースWLSTコマンド

スキン、ページ・テンプレートなどのポータル・リソースをエクスポートおよびインポートできます。

MDS WLSTコマンド

次のデータをエクスポートおよびインポートできます。

- ページ、ツールおよびサービスに対して行われたカスタマイズを含むPortal Frameworkアプリケーション・メタデータ

- connections.xmlおよびadf-config.xmlドキュメントで格納されたデータ

セキュリティ移行WLSTコマンド

ロールおよびユーザーとロールのマッピングが含まれるセキュリティ・ポリシーをエクスポートおよびインポートできます。

Oracle Databaseユーティリティ

Portal Frameworkアプリケーション・データをエクスポートおよびインポートできます。詳細は、『Oracle Databaseユーティリティ』の「Oracle Data Pump」の部を参照してください。

Oracle以外のデータベース・ユーティリティ

データ移行ツールの詳細は、データベース・メーカーのドキュメントを参照してください。

44.1.2 Portal Frameworkアプリケーションのエクスポートおよびインポートの前提条件

Portal Frameworkアプリケーションのメタデータおよびカスタマイズをエクスポートまたはインポートする前に、次のことを確認してください。

- アプリケーション・メタデータおよびスキーマが格納されているデータベースが稼働中であること。

- ターゲット・インスタンスが、ソース・インスタンスと同じツールおよびサービスのセットで構成されていること。必要であれば追加のツールおよびサービスをターゲットで構成できますが、少なくともソースとターゲットの構成は一致している必要があります。

- ソースおよびターゲット・インスタンスは、同じWebCenter Content構成を持ちます。混合構成間でのコンテンツの移動は、サポートされていません。たとえば、両方のインスタンスでFolders_gまたはFrameworkFoldersがフォルダ・サービスとして構成されている必要があります。Folders_gがソース・インスタンスで有効化され、FrameworkFoldersがターゲット・インスタンスで有効化されている場合、2つのインスタンス間でのポータル(コンテンツを含む)のエクスポートまたはインポートは失敗します。

- ポリシーがインポート時に移行されるように、jps.policystore.removalパラメータがアプリケーションのweblogic-application.xmlでOFFに設定されていること。

<application-param>
<param-name>jps.policystore.removal</param-name>
<param-value>OFF</param-value>
</application-param>

このオプションが設定されていない場合、ポリシー情報がインポートされません。一部のインスタンスでは、ポリシー・データを移行しない場合があります。これは、テスト環境から、テスト・データが必要とされない本番環境に移行する場合です。ただし、実行時にソース・インスタンスで作成されたページはターゲット・インスタンス上に表示されません。これは、ページ許可がターゲット上に存在しないためです。

44.1.3 Portal Frameworkアプリケーションのポートレット・クライアント・メタデータのエクスポート

Portal Frameworkアプリケーションに対するポートレット・クライアント・メタデータおよびプロデューサのカスタマイズとパーソナライズをエクスポートするには、WLSTコマンドexportPortletClientMetadataを使用します。このコマンドはアプリケーション全体で実行されるため、アプリケーションで格納されるすべてのプロデューサのメタデータをエクスポートします。特定のプロデューサのメタデータをエクスポートすることはできません。

コマンドを実行する前に、Portal Frameworkアプリケーションをデプロイするカスタム管理対象サーバー、ポートレット・プロデューサ、およびアプリケーション・メタデータまたはスキーマを格納するデータベースが稼働中であることを確認してください。

構文の詳細と例は、『WebLogic Scripting Toolコマンド・リファレンス』のexportPortletClientMetadataに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

すべてのアプリケーションに関連付けられたポートレット・クライアント・メタデータをエクスポートする方法の詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のJSR 286ポートレット用永続性ストアの管理方法に関する項およびPDK-Javaプロデューサ永続性ストアの移行に関する項を参照してください。

44.1.4 Portal Frameworkアプリケーションのポートレット・クライアント・メタデータのインポート

Portal Frameworkアプリケーションに対するポートレット・クライアント・メタデータおよびプロデューサのカスタマイズとパーソナライズをインポートするには、WLSTコマンドimportPortletClientMetadataを使用します。

前提条件:

- アプリケーション・メタデータまたはスキーマが格納されているデータベースおよびポートレット・プロデューサが稼働している必要があります。

- WLSTコマンドexportPortletClientMetadataを使用して、ポートレット・クライアント・メタデータおよびプロデューサのカスタマイズとパーソナライズをEARファイルにエクスポートします。第44.1.3項「Portal Frameworkアプリケーションのポートレット・クライアント・メタデータのエクスポート」も参照してください。

構文と例の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のimportPortletClientMetadataに関する項を参照してください。メタデータ・サービス(MDS)カスタムWLSTコマンドも参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

44.1.5 Portal Frameworkアプリケーションのポータル・リソースのエクスポート

認可されたユーザーは、Portal Frameworkアプリケーションの実行時に、スキンおよびページ・テンプレートなどのポータル・リソースをダウンロードし、Oracle JDeveloperなどのツールでそれらのリソースを編集および展開し、Portal Frameworkアプリケーションにアップロードすることができます。ポータル・リソースを他のPortal Frameworkアプリケーションと共有、または他のPortal Frameworkアプリケーションに移行するユーザーもダウンロード機能を使用できます。

Portal Frameworkの管理コンソールから実行時に次のポータル・リソースをダウンロードできます。

- スキン

- ページ・スタイル

- ページ・テンプレート

- コンテンツ・プレゼンタ表示テンプレート

- ナビゲーション

- リソース・カタログ

- タスク・フロー

- タスク・フロー・スタイル

ポータル・リソースをダウンロード(またはエクスポート)すると、リソースの詳細がエクスポート・アーカイブ(.EAR)に保存されます。希望のファイル名を使用して、エクスポート・アーカイブをローカル・ファイル・システムまたはリモート・サーバー・ファイル・システムに保存することができます。

詳細は、第43.5.8項「アセットのアップロードとダウンロード」を参照してください。

または、システム管理者はWLSTコマンドexportWebCenterResourceを使用して同じタスクを実行できます。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のexportWebCenterResourceに関する項を参照してください。

44.1.6 Portal Frameworkアプリケーションのポータル・リソースのインポート

認可されたユーザーは、Portal Frameworkアプリケーションの実行時に、スキンおよびページ・テンプレートなどのポータル・リソースをインポートできます。WebCenter Portal管理コンソールから実行時に次のポータル・リソースをインポートできます。

- スキン

- ページ・スタイル

- ページ・テンプレート

- コンテンツ・プレゼンタ・テンプレート

- ナビゲーション

- リソース・カタログ

- タスク・フロー

- タスク・フロー・スタイル

ローカル・ファイル・システムまたはリモート・サーバー・ファイル・システム上のWebCenter Portalエクスポート・アーカイブ・ファイル(.ear)に以前に保存されたポータル・リソースをインポートできます。既存のポータル・リソース、つまり同じ内部IDを持つリソースがインポート時に上書きされます。

詳細は、第43.5.8項「アセットのアップロードとダウンロード」を参照してください。

または、管理者はWLSTコマンドimportWebCenterResourceを使用して同じタスクを実行できます。コマンドの構文と例は、『WebLogic Scripting Toolコマンド・リファレンス』のimportWebCenterResourceに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

44.1.7 Portal Frameworkアプリケーションのメタデータのエクスポート

ページ、タスク・フロー、ツールおよびサービスに関連付けられたPortal Frameworkアプリケーションのメタデータは、Oracleメタデータ・ストア(MDS)に格納されます。MDSの詳細は、管理者ガイドの「MDSリポジトリの管理」を参照してください。

特定のPortal Frameworkアプリケーションについては、exportMetadataコマンドを使用して、MDSに格納されているすべてベース・ドキュメントとそのカスマイズあるいは特定のツールまたはサービスのメタデータをエクスポートすることができます。

例:

exportMetadata(application='myWebCenterApp', server='WC_CustomPortal', toLocation='/tmp/myrepos', docs='/oracle/webcenter/**')

ここで:

- application: メタデータをエクスポートするPortal Frameworkアプリケーション名(例: myWebCenterApp)。

- server: Portal Frameworkアプリケーションをデプロイするサーバー(例: WC_CustomPortal)。

- toLocation: ソース・パーティションから選択したドキュメントをエクスポートする先のターゲット・ディレクトリ。toLocationパラメータは、異なるサーバー間でメタデータを移行するための一時ファイル・システムとして使用できます。

- docs: ドキュメントの完全修飾名とドキュメント名パターン(*および**のパターン)のカンマ区切りリスト。
この例では、"docs='/oracle/webcenter/**"はMDSでメタデータを格納しているすべてのOracle WebCenter Portalのツールおよびサービスに対して必要なドキュメントをエクスポートします。

注意:
"docs='/oracle/webcenter/**"コマンドは、ポートレットのカスタマイズやパーソナライズ、またはconnections.xmlやadf-config.xmlなどの構成ファイルへの変更はエクスポートしません。

- ポートレット・メタデータをエクスポートするには、WLSTコマンドexportPortletClientMetadataを実行します。第44.1.3項「Portal Frameworkアプリケーションのポートレット・クライアント・メタデータのエクスポート」も参照してください。

- MDSで格納されている構成ファイルの更新をエクスポートするには、WLSTコマンドexportMetadataを"docs='/META-INF/mdssys/cust/adfshare/adfshare/**"とともに実行します。付録A「adf-config.xmlおよびconnections.xml」も参照してください。

構文の詳細と例は、『WebLogic Scripting Toolコマンド・リファレンス』のexportMetadataに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

ベース・ドキュメントとカスタマイズ・ドキュメントからなるメタデータは、次のパスに格納されます。

- 分析: /oracle/webcenter/analytics/**

- お知らせ: /oracle/webcenter/collab/announcement/**

- ブログ: /oracle/webcenter/blog/**

- ドキュメント: /oracle/webcenter/doclib/**および/oracle/webcenter/doclib/view/jsf/fragments/**

- ディスカッション: /oracle/webcenter/collab/forum/**

- 一般設定: /oracle/webcenter/generalsettings/**

- イベント: /oracle/webcenter/collab/events/**

- 外部アプリケーション: /oracle/webcenter/admin/**およびoracle/adfinternal/extapp/**

- インスタント・メッセージおよびプレゼンス: /oracle/webcenter/collab/rtc/**

- リンク: /oracle/webcenter/relationship/**

- 言語: /oracle/webcenter/webcenterapp/**

- リスト: /oracle/webcenter/list/**および/oracle/webcenter/list/view/jsf/regions/**

- メール: /oracle/webcenter/collab/mail/**

- ナビゲーション: /oracle/webcenter/navigationtaskflows/**

- 注意: /oracle/webcenter/note/**

- ページ: /oracle/webcenter/page/** and /pageDefs/**

- 投票: /oracle/webcenter/collab/survey/**

- ピープル・コネクション(コネクション): /oracle/webcenter/peopleconnections/connection/**

- ピープル・コネクション(フィードバック): /oracle/webcenter/peopleconnections/kudos/**

- ピープル・コネクション(プロファイル・ギャラリ): /oracle/webcenter/peopleconnections/personalweb/**

- ピープル・コネクション (プロファイル): /oracle/webcenter/peopleconnections/profile/**

- ピープル・コネクション (メッセージ・ボード): /oracle/webcenter/peopleconnections/wall/**

- 投票: /oracle/webcenter/collab/survey/**

- 最近のアクティビティ: /oracle/webcenter/recentactivity/**

- リソース・アクション・ハンドラ: /oracle/webcenter/framework/service/**

- RSSニュース・フィード: oracle/webcenter/rssviewer/**

- スコープ: /oracle/webcenter/framework/scope/**

- 検索: /oracle/webcenter/search/**

- セキュリティ: /oracle/webcenter/security/**

- スマート・タグ: /oracle/webcenter/collab/smarttag/**

- ポータル・ブラウザ: /oracle/webcenter/community/**

- ポータル連絡先: /oracle/webcenter/people/**

- サブスクリプション: /oracle/webcenter/notification/**

- タグ: /oracle/webcenter/tagging/**

- adf-config.xml、connections.xml: /META-INF/mdssys/cust/adfshare/adfshare/**
構成ファイルの更新は、Oracle WebCenter Portalのツールとサービスのメタデータの横の/oracle/webcenter/ディレクトリの下に格納されません。これらのファイルに関連付けられたカスタマイズをエクスポートするには、exportMetadata"docs='META-INF/mdssys/cust/adfshare/adfshare/**"とともに実行します。付録A「adf-config.xmlおよびconnections.xml」も参照してください。

44.1.8 Portal Frameworkアプリケーションのメタデータのインポート

Portal Frameworkアプリケーションのツールとサービスのメタデータおよびカスタマイズをインポートするには、WLSTコマンドimportMetadataを使用します。例:

importMetadata(application='myWebCenterApp', server='WC_CustomPortal', fromLocation='/tmp/myrepos', docs='/**')

ここで:

- application: メタデータをインポートするPortal Frameworkアプリケーション名(例: myWebCenterApp)。

- server: アプリケーションがデプロイされるターゲット・サーバーの名前(例: WC_CustomPortal)。

- fromLocation: ドキュメントがインポートされる元のソース・ディレクトリ。fromLocationパラメータは、異なるサーバー間でメタデータを移行するための一時ファイル・システムの場所とすることができます。

- docs: ドキュメントの完全修飾名とドキュメント名パターン(*および**のパターン)のカンマ区切りリスト。

構文の詳細と例は、『WebLogic Scripting Toolコマンド・リファレンス』のimportMetadataに関する項を参照してください。

第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

44.1.9 Portal Frameworkアプリケーションのセキュリティの移行

セキュリティの移行には、アイデンティティ・ストア、資格証明ストアおよびポリシー・ストアのPortal Frameworkアプリケーションから別のPortal Frameworkアプリケーションへの移動が含まれます。Portal Frameworkアプリケーションの移行プロセスは、初期設定のアプリケーション"WebCenter Portal"で説明されているものとまったく同じです。詳細は、次を参照してください。

- 第41.6.6項「LDAPアイデンティティ・ストアのバックアップおよびリストア」

- 第41.6.7項「ポリシー・ストアのバックアップおよびリストア(LDAPとデータベース)」

- 第41.6.8項「資格証明ストアのバックアップおよびリストア(LDAPとデータベース)」

44.1.10 Portal Frameworkアプリケーションのスキーマ・データの移行

Portal Frameworkアプリケーションに対するアプリケーションのスキーマ・データを移行またはバックアップするには、エクスポートおよびインポート・データベース・ユーティリティを使用します。この項には次のサブセクションが含まれます:

- 第44.1.10.1項「Portal Frameworkアプリケーションで使用されるスキーマの理解」

- 第44.1.10.2項「Portal Frameworkアプリケーションのスキーマ・データのエクスポート」

- 第44.1.10.3項「Portal Frameworkアプリケーションのスキーマ・データのインポート」

44.1.10.1 Portal Frameworkアプリケーションで使用されるスキーマの理解

Oracle WebCenter Portalのコンポーネントでは、サポートされているデータベースに様々なスキーマをインストールすることが必要になります。Portal Frameworkアプリケーションでは、次の1つ以上のスキーマを使用できます。

- WEBCENTER: アプリケーションでタグ、リンク、リスト、投票およびピープル・コネクションを使用します

- PORTLET: ポートレット・プロデューサのデータおよびカスタマイズを格納します

- ACTIVITIES: アクティビティ・グラフおよび分析データを格納します

- DISCUSSIONSおよびDISCUSSIONS_CRAWLER: ディスカッションおよびお知らせを格納します

- OCS: Oracle WebCenter Content Serverにドキュメントを保存します

44.1.10.2 Portal Frameworkアプリケーションのスキーマ・データのエクスポート

Portal Frameworkアプリケーションに関連付けられたデータをエクスポートするには、適切なデータベース・ユーティリティを使用します。

- Oracleデータベースの場合、データベースのORACLE_HOME/binに移動して、expdpコマンドを実行します。
たとえば、WEBCENTERスキーマのエクスポート方法を示している例44-1を参照してください。この例では、スキーマ・データをエクスポートする前に、エクスポートされたデータを格納するディレクトリを作成する必要があることを示しています。第44.1.10.1項「Portal Frameworkアプリケーションで使用されるスキーマの理解」にリストされているその他のスキーマに対しても、同様のコマンドを使用できます。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

例44-1 Oracle Data Pumpユーティリティ(WEBCENTERスキーマのエクスポート)

sqlplus "sys/password@serviceid as sysdba"
create or replace directory dmpdir as 'full_path_to_directory_on_file_system';
GRANT read,write ON directory dmpdir TO public;
exit;

DB_ORACLE_HOME/bin/expdp \"sys/password@serviceid as sysdba\"
directory=dmpdir dumpfile=wcp.dmp SCHEMAS=srcprefix_WEBCENTER EXCLUDE=STATISTICS  NOLOGFILE=Y

ここで:

- DB_ORACLE_HOMEは、WebCenter Portalスキーマ(WEBCENTER)のデータベースがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。たとえば、mydb1234のように指定します。

- serviceidは、データベース接続のサービスIDです。

- directoryは、ダンプ・ファイルが作成されるデータベース・マシン上の場所です。

- dumpfileは、エクスポートされたデータを含むファイルの名前を識別します。

- SCHEMASは、エクスポートされるスキーマを識別します。インストール時に使用されたRCU接尾辞(_WEBCENTER)を、ユーザーが指定した接頭辞とともに含めます。例: DEV_WEBCENTER。

- EXCLUDE=STATISTICSは、表の統計をエクスポートしないことを指定します。

- NOLOGFILE=Yは、ログ・ファイルの作成を抑制します。

expdpコマンドの詳細は、『Oracle Databaseユーティリティ』を参照してください。

44.1.10.3 Portal Frameworkアプリケーションのスキーマ・データのインポート

Portal Frameworkアプリケーション・データをインポートするには、適切なデータベース・ユーティリティを使用します。

- Oracleデータベースの場合、データベースのORACLE_HOME/binに移動して、impdpコマンドを実行します。
たとえば、WEBCENTERスキーマのインポート方法を示している例44-2を参照してください。第44.1.10.1項「Portal Frameworkアプリケーションで使用されるスキーマの理解」にリストされているその他のスキーマに対しても、同様のコマンドを使用できます。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

例44-2 Oracle Data Pumpユーティリティ(WEBCENTERスキーマのインポート)

DB_ORACLE_HOME/bin/sqlplus "sys/password@serviceid as sysdba"
create or replace directory dmpdir as 'mydmpdirectory';
GRANT read,write ON directory dmpdir TO public;
drop user tgtprefix_WEBCENTER cascade;
exit;

DB_ORACLE_HOME/bin/impdp  \"sys/password@serviceid as sysdba\"
directory=dmpdir dumpfile=wcp.dmp SCHEMAS=tgtprefix_WEBCENTER

ここで:

- DB_ORACLE_HOMEは、WebCenter Portalスキーマ(WEBCENTER)のデータベースがインストールされるディレクトリです。

- passwordは、システム・データベース・ユーザーのパスワードです。

- serviceidは、データベース接続のサービスIDです。

- directoryは、ダンプ・ファイルを配置するデータベース・マシン上の場所です。

- dumpfileは、インポートするデータを含むファイルの名前です。

- SCHEMASは、インポートするターゲット・スキーマを識別します。スキーマの名前は、インストール時に使用されたRCU接尾辞(_WEBCENTER)に、ユーザーが指定した接頭辞を加えたものになります。例: DEV_WEBCENTER。
SCHEMASパラメータは、ソースとターゲットのスキーマ名が一致するときに使用します。たとえば、両方のスキーマの名前はDEV_WEBCENTERになります。

スキーマ名が一致しないときには、かわりにREMAP_SCHEMAパラメータを使用します。詳細は、例41-3「WebCenter Portalスキーマ・データのインポート(ソースとターゲットのスキーマ名が異なる場合)」を参照してください。

impdpコマンドの詳細は、『Oracle Databaseユーティリティ』を参照してください。

44.2 Portal Frameworkアプリケーションのバックアップおよびリカバリ

データベース・ハードウェアを消失した場合や、ファイルやデータベースから誤ってデータを削除した場合などの障害からデータをリカバリするには、Portal Frameworkアプリケーションを頻繁にバックアップすることが重要です。バックアップの頻度は、アプリケーションに格納されている基礎となる情報が特定の顧客アプリケーションでどのくらいの頻度で変更されるか、およびどのくらいの時間と情報量を消失しても許容されるかによって決まります。データが業務にとって非常に重要であり、障害発生時にはデータのリストアが必須である場合は、増分バックアップまたは部分バックアップを適用できます。

Portal FrameworkアプリケーションおよびWebCenter Portalコンポーネントのバックアップとリカバリは、データベースのエクスポートおよびインポート・ユーティリティ、および様々な他のツールから管理できます。詳細は、管理者ガイドの「詳細管理: バックアップおよびリカバリ」を参照してください。

第X部

複数言語ポータル

『Oracle WebCenter Portalの管理』のこの部では、Oracle WebCenter Portalの言語と翻訳について説明します。

第X部の内容は次のとおりです。

- 第45章「複数言語ポータルの管理」

45 複数言語ポータルの管理

この章では、WebCenter Portalでサポート可能な言語と、アプリケーションおよびポータル・レベルでの翻訳とポータル内の特定文字列の翻訳の管理方法について説明します。

この章には次のトピックが含まれます:

- 第45.1項「WebCenter Portalの言語について」

- 第45.2項「アプリケーション・レベルでの文字列の変更と翻訳」

- 第45.3項「ポータルの文字列の翻訳」

- 第45.4項「ポータルの特定文字列に対する翻訳の変更と追加」

- 第45.5項「WebCenter Portalへの新規言語のサポートの追加」

権限:
この章のタスクを実行するには、次のロールが付与されている必要があります。

- WebLogic Server: Oracle WebLogic Server管理コンソールを使用して付与される、AdminロールまたはMonitorロール。

- WebCenter Portal: ポータル・ビルダー管理を使用して付与されるAdministratorロール、または次の権限を付与するカスタム・ロール。
Basic Services: Edit Page Access, Structure, and Content permission。

第1.8項「管理操作、ロールおよびツールの理解」も参照してください。

45.1 WebCenter Portalの言語について

ポータルで異なる言語をサポートする必要がある場合、ローカライズされたコンテンツをユーザーが選択した言語とロケールに基づいて表示するように、ポータルを構成できます。たとえば、イタリア語を話すユーザーがページを表示することがわかっている場合、イタリア語が(ブラウザ、ユーザー・プリファレンス、ポータルまたはアプリケーション設定で)選択されたときにページ内のテキスト文字列をイタリア語で表示するように、ページをローカライズできます。

また、ロケールを選択する際は、選択したロケールに適用される、特殊な書式について考慮する必要があります。たとえば、通常の情報の表示方向が左から右、右から左のどちらであるか、数字をどのように表記するか(通貨情報など)などを考慮します。

WebCenter Portal内に表示される主な情報のタイプは、次の3つです。

- ユーザー・インタフェース(UI)要素。フィールドとボタンのラベル、シードされたボイラープレート・テキストなどがあります。

- ユーザー入力メタデータ。ページ名、ポータル名、ポータルの説明などがあります。

- ユーザーが追加したコンテンツ。お知らせ、ドキュメント、ディスカッション・フォーラム・コンテンツなどがあります。

変更に関する処理は、情報のタイプごとに異なります。

- UI要素:

注意:
UI要素には、28の言語と100の異なるロケールに対応した、デフォルトの翻訳が含まれています。デフォルトのUIテキストが会社の要件に合っていない場合や、会社で追加の言語をサポートする必要がある場合にのみ、このテキストを変更する必要があります。

- WebCenter Portalアプリケーション全体(1つのポータルだけでなく)のテキストを変更するには、オーバーライド・バンドル(SpacesSeedDataOverrideBundle.xlf)の文字列を編集します。

- 特定のポータルのUIテキストを変更するには、ポータル固有のリソース・バンドル(scope-resource-bundle.xlf)に含まれる文字列を編集します。

- ユーザー入力メタデータ(ページ名、ポータル名、ポータルの説明など)は、文字列としてポータルのリソース・バンドルに保存されます。ポータルごとに、独自のリソース・バンドルがあります。ユーザー入力メタデータを変更するには、ポータル固有のリソース・バンドルに含まれる文字列を編集します。

注意:
一般的に、複数の言語で表示する必要があるユーザー入力メタデータは、会社全体向けのコンテンツまたはカスタマに表示されるコンテンツであり、多くの場合、なんらかの形式で翻訳が提供されます。より特殊なコンテンツ(特定の部門や地域に固有のコンテンツなど)に必要な言語は1つのみである可能性が高く、したがって翻訳を必要としません。

- ユーザーが追加したコンテンツは、通常、そのユーザーが使用する言語で表示されます。

45.1.1 WebCenter Portalによってデフォルトでサポートされる言語

WebCenter Portalでは、28の言語と100の異なるロケールに対応した翻訳が実行時に提供されます。

表45-1のリストには、デフォルトでWebCenter Portalに提供されるすべての言語が含まれています。ユーザーは、特定の言語に関連付けられたロケールを選択することもできます。たとえば、ユーザーは言語をアラビア語に変更し、その言語グループの中で、アルジェリア、バーレーン、ジブチなど、20の異なるロケールを選択できます。

表45-1 WebCenter Portalで提供される言語

AからGe

GrからRo

RuからT

アラビア語

ギリシャ語

ロシア語

ポルトガル語(ブラジル)

ヘブライ語

中国語(簡体字)

チェコ語

ハンガリー語

スロバキア語

デンマーク語

イタリア語

スペイン語

オランダ語

日本語

スウェーデン語

英語

韓国語

タイ語

フィンランド語

ノルウェー語

中国語(繁体字)

フランス語

ポーランド語

トルコ語

フランス語(カナダ)

ポルトガル語

ドイツ語

ルーマニア語

注意:
Oracle Enterprise Managerなど、WebCenter Portalにサービスを提供する管理層では、WebCenter Portalで使用可能な言語サブセットが提供されます。それらを次に示します。

- 英語

- ポルトガル語(ブラジル)

- 中国語(簡体字)

- 中国語(繁体字)

- フランス語

- ドイツ語

- イタリア語

- 日本語

- 韓国語

- スペイン語

ディスカッションには、WebCenter Portalのディスカッション・サーバーが使用されます。初期設定では、ディスカッション・サーバー・アプリケーションでは、英語とスペイン語がサポートされています。表45-1にリストされているその他の言語はサポートされません。ただし、アプリケーションはユーザー独自の翻訳ファイルを受け入れます。詳細は、Jiveのドキュメント・サイトを参照してください。この情報は、ディスカッション・サーバー・アプリケーションのユーザー・インタフェースに明示的に示されます。

注意:
ページレット・プロデューサの管理UIでは、9か国語の管理言語とオランダ語がサポートされています。

45.2 アプリケーション・レベルでの文字列の変更と翻訳

変更または翻訳対象が、アプリケーション全体のUIテキスト、特定ポータルのUIテキスト、またはポータル内のユーザー入力メタデータのいずれであっても、そのプロセスは基本的に同じで、該当するファイルをそれぞれ変更するだけです。

アプリケーション全体にシードされたUIテキストを変更するには、オーバーライド・バンドル(SpacesSeedDataOverrideBundle.xlf)を編集します。

アプリケーション・レベルで文字列を変更または翻訳するには:

1. WLSTを起動します。詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

2. WLSTコマンドexportMetadataを使用して、オーバーライド・バンドルをエクスポートします。

exportMetadata(application='webcenter',server='WC_Spaces',toLocation='/tmp/metadata',docs='/xliffBundles/SpacesSeedDataOverrideBundle.xlf')

この例では、WC_Spaces管理対象サーバー上のWebCenter Portal (webcenter)のSpacesSeedDataOverrideBundle.xlfを/tmp/metadataフォルダにエクスポートします。アプリケーション名には、必ずwebcenterを使用してください。

WebCenter Portalのインストールをホストする管理対象サーバーの名前と一致するようにserver値を変更します。

toLocation値を、文字列ファイルのエクスポート先となる場所に変更します。

詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。 『WebLogic Scripting Toolコマンド・リファレンス』のexportMetadataに関する項も参照してください。

3. /xliffBundles/SpacesSeedDataOverrideBundle.xlfをエクスポートしたフォルダに移動します。

注意:
編集したファイルを正しくエンコードしないと、翻訳をインポートする際にエラーが発生する場合があります。Oracle JDeveloperは特殊文字を自動的に正しくエンコードするため、ファイルの編集にはOracle JDeveloperを使用することをお薦めします。

4. ベース言語の文字列を変更する場合には、テキスト・エディタで/xliffBundles/SpacesSeedDataOverrideBundle.xlfを開きます。
ファイルを別の言語に翻訳する場合には、そのファイルの言語固有バージョンを作成します。たとえば、アプリケーション全体のUIテキストをカタリナ語に翻訳するには、ファイルの名前をSpacesSeedDataOverrideBundle_ca.xlfにします。翻訳の場合には、通常このファイルを翻訳チームに送信し、翻訳チームがファイルを更新して返信します。

5. 変更または翻訳する<trans-unit>ブロックを見つけます。
SpacesSeedDataOverrideBundle.xlf内のID属性は、WebCenter Portalのコンポーザに表示されるUI要素のリソース・キーに対応します。

たとえば、アプリケーション全体のSpacesSeedDataOverrideBundle.xlfファイルに含まれるAnnouncementsタイトルの<trans-unit>ブロックは、次のとおりです。

<trans-unit id="ANNOUNCEMENTS.TITLE">
<source>Announcements</source>
</trans-unit>

6. <source>ブロック内のテキストをビジネス要件に合わせて編集し、ファイルを保存します。

7. WLSTコマンドのimportMetadataを使用して、更新された文字列ファイルをWebCenter Portalに再度インポートします。例:

importMetadata(application='webcenter',server='WC_Spaces',fromLocation='/tmp/metadata',docs='/xliffBundles/SpacesSeedDataOverrideBundle.xlf')

この例では、/tmp/metadataフォルダから、該当する文字列ファイルをWC_Spaces管理対象サーバー上のwebcenterアプリケーションにインポートしています。fromLocationのパスを、文字列ファイルのインポート元となる場所に変更します。アプリケーション名には、必ず「webcenter」を使用してください。WebCenter Portalのインストールをホストするサーバーと一致するようにサーバー名を変更します。

詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。 『WebLogic Scripting Toolコマンド・リファレンス』のimportMetadataに関する項も参照してください。

8. WC_Spaces管理対象サーバーを再起動し、変更がUIの表示に反映されていることを確認します。

45.3 ポータルの文字列の翻訳

特定のポータルの文字列を翻訳するには、ポータル固有のリソース・バンドル(scope-resource-bundle.xlf)を編集します。翻訳できる文字列は、ポータルの表示名、説明およびページ・タイトルです。

ポータルの文字列を翻訳するには:

1. WLSTを起動します。詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

2. WLSTコマンドのexportMetadataを使用して、文字列ファイルをエクスポートします。

- すべての文字列ファイルをエクスポートする場合は、docs属性を含めません。例:

exportMetadata(application='webcenter',server='WC_Spaces',toLocation='/tmp/metadata')

この例では、WC_Spaces管理対象サーバー上にあるWebCenter Portal (webcenter)のすべての文字列ファイルを/tmp/metadataフォルダにエクスポートしています。アプリケーション名には、必ずwebcenterを使用してください。

WebCenter Portalのインストールをホストする管理対象サーバーの名前と一致するようにserverの値を変更します。

toLocationのパスを、文字列ファイルのエクスポート先となる場所に変更します。

- 特定の文字列ファイルのみをエクスポートする場合は、docs属性を含めます。例:

exportMetadata(application='webcenter',server='WC_Spaces',toLocation='/tmp/metadata',docs='/oracle/webcenter/translations/scopedMD/PORTAL_GUID/scope-resource-bundle.xlf')

この例の結果は1つ目の例と似ていますが、ポータル固有のリソース・バンドルのみがエクスポートされます。PORTAL_GUIDを文字列の変更対象となるポータルのGUIDに置換します。

注意:
複数のファイルをエクスポートするには、ファイルの場所をカンマで区切ります。

詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。 『WebLogic Scripting Toolコマンド・リファレンス』のexportMetadataに関する項も参照してください。

3. 文字列ファイルをエクスポートしたフォルダに移動します。

注意:
編集したファイルを正しくエンコードしないと、翻訳をインポートする際にエラーが発生する場合があります。Oracle JDeveloperは特殊文字を自動的に正しくエンコードするため、ファイルの編集にはOracle JDeveloperを使用することをお薦めします。

4. 文字列をベース言語で変更する場合は、/oracle/webcenter/translations/scopedMD/PORTAL_ GUID/scope-resource-bundle.xlfを開き、PORTAL_GUIDを、文字列の変更対象となるポータルのGUIDに置換します。
ファイルを別の言語に翻訳する場合には、そのファイルの言語固有バージョンを作成して、テキスト・エディタで開きます。たとえば、ポータルのUIテキストをカタリナ語に翻訳するには、ファイルの名前をscope-resource-bundle_ca.xlfにします。

5. 翻訳する<trans-unit>ブロックを見つけます。
scope-resource-bundle.xlf内のOBJECTGUID属性は、WebCenter Portalのコンポーザに表示されるUI要素のリソース・キーに対応します。

たとえば、ポータル固有のscope-resource-bundle.xlfファイル内にあるページの表示名では、<trans-unit>ブロックは次のようになります。

<trans-unit id="SCOPEGUID:s2f80d470_6cc4_479a_884c_9feb574b35d6:Pagedf7eed1_13eea02290b__7ff6:SERVICEID:oracle.webcenter.page:OBJECTTYPE:page:OBJECTGUID::PAGES.:Page2.jspx.DISPLAY_NAME">
<source>Personal25</source>
</trans-unit>

6. <source>ブロック内のテキストをビジネス要件に合わせて編集し、ファイルを保存します。

7. WLSTコマンドのimportMetadataを使用して、更新された文字列ファイルをWebCenter Portalにインポートします。例:

- すべての文字列ファイルをインポートする場合は、docs属性を含めません。例:

importMetadata(application='webcenter',server='WC_Spaces',fromLocation='/tmp/metadata')

この例では、すべての文字列ファイルを、/tmp/metadataフォルダからWC_Spaces管理対象サーバー上のwebcenterアプリケーションにインポートしています。fromLocationのパスを、文字列ファイルのインポート元となる場所に変更します。アプリケーション名には、必ず「webcenter」を使用してください。WebCenter Portalのインストールをホストするサーバーと一致するようにサーバー名を変更します。

- 特定の文字列ファイルのみをインポートする場合は、docs属性を含めます。

importMetadata(application='webcenter',server='WC_Spaces',fromLocation='/tmp/metadata',docs='/oracle/webcenter/translations/scopedMD/PORTAL_GUID/scope-resource-bundle.xlf')

この例の結果は1つ目の例と似ていますが、ポータル固有のリソース・バンドルのみがインポートされます。PORTAL_GUIDを文字列の変更対象となるポータルのGUIDに置換します。docs属性を使用することをお薦めします。

注意:
複数のファイルをインポートするには、ファイルの場所をカンマで区切ります。

詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。 『WebLogic Scripting Toolコマンド・リファレンス』のimportMetadataに関する項も参照してください。

8. WC_Spaces管理対象サーバーを再起動し、変更がUIの表示に反映されていることを確認します。

45.4 ポータルの特定文字列に対する翻訳の変更と追加

ビジネス要件に合わせるために、ポータルの特定文字列のみを翻訳する場合があります。たとえば、ポータル内のページにある特定のインスタンスで、「お知らせ」タスク・フローのタイトルのみを翻訳する必要がある場合があります。

ポータル内の文字列の特定のインスタンスに翻訳を追加するには:

1. WLSTコマンドのexportMetadataを使用して、文字列ファイルをエクスポートします。例:

exportMetadata(application='webcenter',server='WC_Spaces',toLocation='/tmp/metadata',docs='/oracle/webcenter/translations/scopedMD/PORTAL_GUID/scope-resource-bundle.xlf')

この例では、WC_SpacesにデプロイされたWebCenter Portal (webcenter)のポータル固有のリソース・バンドルを/tmp/metadataフォルダにエクスポートしています。PORTAL_GUIDを文字列の変更対象となるポータルのGUIDに置換します。必要に応じて、WebCenter Portalのインストールに合うようにサーバー名を変更します。toLocationのパスを、文字列ファイルのエクスポート先となる場所に変更する必要があります。

詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。 『WebLogic Scripting Toolコマンド・リファレンス』のexportMetadataに関する項も参照してください。

2. 翻訳する文字列ファイルの言語/ロケール固有バージョンを作成します。
/oracle/webcenter/translations/scopedMD/PORTAL_ GUID/scope-resource-bundle.xlfをコピーして、PORTAL_GUIDをポータルのGUIDに置換します。次にそのファイルに必要な名前を付けて保存します。たとえば、ポータル全体のUIテキストをカタリナ語に翻訳するには、ファイルの名前をscope-resource-bundle_ca.xlfにします。

3. 翻訳されるファイルを翻訳チームに送信して、編集します。翻訳の手順は、次のとおりです。

1. JDeveloperまたはテキスト・エディタで文字列ファイルを開きます。

注意:
編集したファイルを正しくエンコードしないと、翻訳をインポートする際にエラーが発生する場合があります。Oracle JDeveloperは特殊文字を自動的に正しくエンコードするため、ファイルの編集にはOracle JDeveloperを使用することをお薦めします。

2. 変更する<trans-unit>ブロックを見つけます。
ポータル固有のscope-resource-bundle.xlfファイルの<trans-unit>ブロックの場合、次のようになります。SCOPEGUIDは選択したポータルの内部IDを示し、OBJECTGUIDは「お知らせ」タスク・フローのIDを示しています。

<trans-unit id="SCOPEGUID:s7735bad2_2e7d_4d73_a360_423a64bfc111:SERVICEID:oracle.webcenter.peopleconn:OBJECTTYPE:profile:OBJECTGUID:ANNOUNCEMENTS.TITLE">
<source>Announcements</source>
</trans-unit>

OBJECTGUID属性(scope-resource-bundle.xlf内)は、コンポーザで必要な文字列に表示されるリソース・キーに対応します。リソース・キーの詳細は、『Oracle WebCenter Portalでのポータルの構築』の文字列のリソース・キーの確認に関する項を参照してください。

3. 必要に応じて、指定された<trans-unit>ブロックの<source>テキストを翻訳します。

4. ファイルを保存します。

4. WLSTコマンドのimportMetadataを使用して、更新された文字列ファイルをWebCenter Portalに再度インポートします。例:

importMetadata(application='webcenter',server='WC_Spaces',fromLocation='/tmp/metadata',docs='/oracle/webcenter/translations/scopedMD/PORTAL_GUID/scope-resource-bundle.xlf')

この例では、指定されたポータルの文字列ファイルを、/tmp/metadataフォルダからWC_Spaces管理対象サーバーにデプロイされたWebCenter Portal (webcenter)にインポートしています。PORTAL_GUIDを文字列の変更対象となるポータルのGUIDに置換します。必要に応じて、WebCenter Portalのインストールに合うように管理対象サーバーの名前を変更します。fromLocationのパスを、文字列ファイルのインポート元となる場所に変更します。

詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。 『WebLogic Scripting Toolコマンド・リファレンス』のimportMetadataに関する項も参照してください。

5. WebCenter Portal内の必要なUI要素のリソース・キーを更新します。たとえば、ポータル内における特定の「お知らせ」タスク・フローのタイトルを翻訳する場合、次の手順を実行します。

1. WebCenter Portalにログオンして必要なポータルに移動し、タイトルを翻訳する「お知らせ」タスク・フローの「コンポーネント・プロパティ」ダイアログを開きます。「コンポーネント・プロパティ」ダイアログへのアクセスの詳細は、『Oracle WebCenter Portalでのポータルの構築』のコンポーネント・プロパティの変更に関する項を参照してください。

2. 「表示オプション」タブの「テキスト」フィールドで、新しいリソース・キーを次の形式で指定します。

#{o_w_f_t_TranslationsRBBean['trans-unit id']}

trans-unit idは、scope-resource-bundle.xlfファイルの「お知らせ」タスク・フローのIDです。たとえば、次のリソース・キーを指定します。

#{o_w_f_t_TranslationsRBBean['SCOPEGUID:s7735bad2_2e7d_4d73_a360_423a64bfc111:SERVICEID:oracle.webcenter.peopleconn:OBJECTTYPE:profile:OBJECTGUID:ANNOUNCEMENTS.TITLE']}

3. 「OK」をクリックします(図45-1)。

図45-1 「お知らせ」タスク・フローの「コンポーネント・プロパティ」ダイアログ

6. WC_Spaces管理対象サーバーを再起動し、WebCenter Portalで変更内容が反映されているかどうかを確認します。

45.5 WebCenter Portalへの新規言語のサポートの追加

WebCenter Portalではデフォルトでサポートされていない新規言語のサポートを追加できます。WebCenter Portalを有効化して追加言語をサポートするには、ポータルの文字列をリソース・バンドル内で新規言語に翻訳し、2つの言語の構成ファイル(supported-languages.xmlおよびfaces-config.xml)を更新し、該当する言語更新をカスタム共有ライブラリにデプロイします。

新規言語のサポート追加に関する情報は、Oracle Technology NetworkのOracle WebCenter Portalホワイト・ペーパーおよびテクニカル・ノートページにあるホワイト・ペーパーSpacesのサンプル拡張機能を参照してください。

第XI部

ポータル・ビルダー管理におけるポータルの管理

『Oracle WebCenter Portalの管理』のこの部では、ポータル・ビルダーの管理について説明します。

第XI部の内容は次のとおりです。

- 第46章「ポータル・ビルダー内の「ポータル」ページの検索」

- 第47章「ポータル・ビルダー管理内の「管理」ページの検索」

- 第48章「ポータル間のグローバルなデフォルト設定の構成」

- 第49章「ポータル間のセキュリティの管理」

- 第50章「システム・ページのカスタマイズ」

- 第51章「ビジネス・ロール・ページの管理」

- 第52章「個人用ページの管理」

- 第53章「デバイス設定の管理」

- 第54章「ポータル間のタスク・フローのカスタマイズ」

- 第55章「ポータル間のグローバル属性での作業」

- 第56章「ポータルの使用状況の分析」

46 ポータル・ビルダー内の「ポータル」ページの検索

この章では、ポータル・ビルダー内の「ポータル」ページでポータルを管理する方法について説明します。

この章には次のトピックが含まれます:

- 第46.1項「ポータル・ビルダー内の「ポータル」ページについて」

- 第46.2項「ポータル・ビルダー内の「ポータル」ページへのアクセス」

- 第46.3項「ポータル・リストのソート」

- 第46.4項「ポータルの作成」

- 第46.5項「ポータルのエクスポートおよびインポート」

- 第46.6項「任意のポータルに関する情報の表示」

- 第46.7項「類似のポータルの表示」

- 第46.8項「ポータルへのリンクの共有」

- 第46.9項「任意のポータルのクローズ」

- 第46.10項「任意のポータルの再アクティブ化」

- 第46.11項「任意のポータルのオフライン化」

- 第46.12項「任意のポータルの再オンライン化」

- 第46.13項「サブポータルの作成」

- 第46.14項「ポータルまたはサブポータルの移動(親の変更)」

- 第46.15項「ポータルの削除」

権限:
この章で説明するタスクを任意のポータルで実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server-Manage Configuration

ポータル・モデレータである場合(またはポータルのManage Configuration権限がある場合)には、『Oracle WebCenter Portalでのポータルの構築』のポータルの管理に関する項で説明されているように、そのポータル上でのみこれらのタスクを実行できます。

権限の詳細は、第49.3項「アプリケーション・ロールおよび権限について」を参照してください。

46.1 ポータル・ビルダー内の「ポータル」ページについて

ポータル・ビルダーの「ポータル」ページ(図46-1)からWebCenter Portalのすべてのポータルの編集および管理にアクセスできます。

「ポータル」ページでは、インポートおよびエクスポートのサービスも提供されており、バックアップやポータルのステージング環境や本番環境への移行を実行できます。ポータルのエクスポートおよびインポートは、システム管理者またはポータル・サーバー - 構成の管理権限を持つユーザーのみ使用できます。ポータル・テンプレートをエクスポートおよびインポートする場合には、アプリケーションレベルの管理権限は必要ありません(『Oracle WebCenter Portalでのポータルの構築』のポータル・テンプレートのエクスポートとインポートに関する項を参照)。

その他のユーザーがこの「ポータル」ページを表示するには、「ポータル」メニューから「ポータル・ビルダー」を選択するか、単一のポータルを管理している場合は「すべてのポータルに戻る」をクリックします。適切な権限が付与されていれば、ユーザーはこのページを使用してポータルを編集したり、管理できます。ただし、この章はすべてのポータルで管理アクションを実行できるシステム管理者を対象にしています。作成する個別のポータルや管理権限を持つそれぞれのポータルの管理の詳細は、『Oracle WebCenter Portalでのポータルの構築』の「ポータルの管理」を参照してください。

図46-1 WebCenter Portal管理: 「ポータル・ビルダー」内の「ポータル」ページ

46.2 ポータル・ビルダー内の「ポータル」ページへのアクセス

WebCenter Portal内のすべてのポータルを管理するには:

1. ポータル・ビルダー内の「ポータル」ページを次のいずれかの方法で開きます。

- 「ポータル」メニューから、「ポータル・ビルダー」を選択します。

- 上部のメニュー・バーで「管理」リンク(図46-2)をクリックし、「ポータル」タブをクリックします。

図46-2 WebCenter Portalの「管理」リンク

- ブラウザで次のURLを入力し、「ポータル」ページに直接移動します。

http://host:port/webcenter/portal/builder/portals

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

「ポータル」ページが表示されます(図46-3)。

図46-3 WebCenter Portal管理: 「ポータル・ビルダー」内の「ポータル」ページ

2. ポータル・ビルダーの「ポータル」ページで、左側のペインから次のいずれかを選択します。

- すべてのポータル: パブリックとプライベートの両方で使用できるすべてのポータルを表示します。作成済であることが表示されない場合、ポータルは非表示と定義されます。

- モデレート対象: モデレータ権限を持つポータルを表示します。

- 参加済: メンバーとして所属するポータルを表示します。

- パブリック: ポータルURLを使用してすべてのユーザーがアクセスできるポータルを表示します。

- 検出可能: 検索結果で検出できるポータルを表示します。

46.3 ポータル・リストのソート

「ポータル」ページにあるポータルのリストをソートするには:

1. ポータル・ビルダーの「ポータル」ページ(第46.2項「ポータル・ビルダー内の「ポータル」ページへのアクセス」を参照)で、「ソート基準」選択リスト(図46-4)をクリックします。

注意:
「すべてのポータル」が左の選択ペインで選択されている場合、「表示名」および「最終アクセス」以外ではソートできません。

図46-4 ポータル・リストのソート

2. ページのポータルの表示順序を、次のいずれかから選択します。

- 作成日: 最近作成されたものから過去にさかのぼって表示されます。

- 表示名: ポータル管理の「タイトル」値で指定されたように、外部表示名によりアルファベット順に表示されます。

- 最終アクセス: 最近表示されたものから過去にさかのぼって、更新されたかどうかに関係なく表示されます。

- 最終更新: 最近更新されたものから過去にさかのぼって表示されます。

- メンバー数: ポータルのメンバーが最大から最小の順に表示されます。

- ポータル名: ポータル管理の「名前」値で指定されたように、ポータルの内部名がアルファベット順に表示されます。内部名は「ポータル」ページには表示されません。

46.4 ポータルの作成

新規ポータルを作成するには:

1. ポータル・ビルダーの「ポータル」ページ(第46.2項「ポータル・ビルダー内の「ポータル」ページへのアクセス」を参照)で、「ポータルの作成」(図46-5)をクリックします。

図46-5 新規ポータルの作成

「ポータル・テンプレートの選択」ページが表示されます。

ポータル作成に関する情報は、『Oracle WebCenter Portalでのポータルの構築』の「新規ポータルの作成と構築」を参照してください。

46.5 ポータルのエクスポートおよびインポート

ポータルをエクスポートおよびインポートできるのは、システム管理者のみです。詳細は、次を参照してください。

- 第40.1.2.3.2項「ポータル・ビルダー管理を使用したオンライン・ポータルのアーカイブへのエクスポート」

- 第40.1.2.4.2項「ポータル・ビルダー管理を使用したポータルのアーカイブからのインポート」

第G.8項「個別のポータルとポータル・テンプレートのインポートおよびエクスポートのトラブルシューティング」も参照してください。

46.6 任意のポータルに関する情報の表示

ポータル・ビルダーの「ポータル」ページで、ポータルのアクティブ、オンライン、オフラインの状況、ポータルへの最近のアクセス状況、メンバー数がすぐにわかります。

ポータルに関する情報を表示するには:

1. ポータル・ビルダーの「ポータル」ページ(第46.2項「ポータル・ビルダー内の「ポータル」ページへのアクセス」を参照)で、表内の行を強調表示して必要なポータルを選択します。

2. 「アクション」メニューから、「ポータルについて」を選択します(図46-6)。

図46-6 ポータルに関する情報の表示

3. 「ポータルについて」ダイアログ内の情報を検索します(図46-7)。

図46-7 「ポータルについて」ダイアログ

- 名前: ポータルURLに表示されるポータルの内部名。

- 表示名: ポータルの表示名。この名前は、ポータルの上部と、「ポータル」ページなどのポータルを選択できるその他の場所に表示されます。

- 内部ID: 他のアプリケーションがこのポータルを参照する際に使用する、ポータルのID。

- 説明: ポータルの作成時やポータル管理の設定の際に指定されるポータルの説明。

- 作成者: ポータル作成者であるユーザーの名前。

- 作成日: ポータルが作成された日付と時間。

- ダイレクトURL: ポータルへ直接アクセスできるURL。

46.7 類似のポータルの表示

ポータルは同じメンバーが似たようなアクションを実行している場合(特にコンテンツを編集する場合)、互いに類似したものになると考えられます。「類似ポータル」は「アクティビティ・グラフ」サービスによって提供されます。詳細は、『Oracle WebCenter Portalでのポータルの構築』の類似のポータル・タスク・フローの使用に関する項を参照してください。

現在のポータルと類似したポータルのリストを表示するには:

1. ポータル・ビルダーの「ポータル」ページ(第46.2項「ポータル・ビルダー内の「ポータル」ページへのアクセス」を参照)で、表内の行を強調表示して必要なポータルを選択します。
[Ctrl]キーを押しながら、1つ以上のポータルを選択します。

2. 「アクション」メニューから、「類似ポータル」を選択します(図46-8)。

図46-8 「類似ポータル」の表示

3. 「類似ポータル」ダイアログで、ポータルを選択して開くか、「表示オプション」(鉛筆)アイコン(図46-9)をクリックして、類似ポータルの基準を変更します。

図46-9 「類似ポータル」の「表示オプション」ダイアログ

4. 「表示オプション」ダイアログ(図46-9)に表示するポータルの数と表示基準を入力して、「OK」をクリックします。

46.8 ポータルへのリンクの共有

ポータルを他のユーザーと共有する場合、他のユーザーのアクティビティ・ストリームに表示されるポータルへのリンクを公開できます。適切な権限を持つユーザーは、ポータルの表示名を指定するリンクをクリックして、ポータルに直接アクセスできます。

ポータルへの直接リンクを公開するには:

1. ポータル・ビルダーの「ポータル」ページ(第46.2項「ポータル・ビルダー内の「ポータル」ページへのアクセス」を参照)で、表内の行を強調表示して必要なポータルを選択します。

2. 「アクション」メニューから、「リンクの共有」を選択します(図46-10)。

図46-10 ポータルへのリンクの共有

3. 「共有」ダイアログ(図46-11)に、オプションでリンクとともに表示されるコメントを入力します。

図46-11 ポータルの「共有」ダイアログ

4. 「共有対象」リストで、リンクを共有するユーザーを選択します。

- 全員: 現在のポータルのすべてのメンバーとアクティビティ・ストリームでリンクを共有します。これは、メンバーにポータルの更新を通知する際に便利です。

- ポータル: 「ポータルの選択」ダイアログを開き、選択したポータルのすべてのメンバーのアクティビティ・ストリームでリンクを共有するポータルを選択できます。これは、自分のポータルに関心を持つ可能性がある他のポータルのメンバーと情報を共有する場合に便利です。

5. 「公開」をクリックします。

46.9 任意のポータルのクローズ

ポータルは、デフォルトでアクティブです。アクティブに使用されなくなったポータルをクローズできます。ポータルをクローズすると、そのコンテンツはアーカイブされます。ポータルをクローズすると、そのポータルはすべてのユーザーの「ポータル」メニューから削除され、ユーザーが「表示」リストから「クローズ」を選択する場合にのみホーム・ポータルの「ポータル」ページに表示されます。クローズしたポータルのコンテンツは、クローズ後もアクセスしたり検索して参照できます。ポータル・メンバーがそのポータルで引き続き作業するには、クローズしたポータルを表示するか、プリティURL (http://host:port/webcenter/portal/portalName)でアクセスします。

ポータルをクローズすると、そのポータル内で実行されるすべてのアクティビティがホーム・ポータルの「アクティビティ・ストリーム」に反映されなくなります。クローズしたポータルのホーム・ページでのみポータルのアクティビティが表示されるようになります。

ポータルを一時的にクローズする場合は、ポータルをオフラインにします。第46.11項「任意のポータルのオフライン化」を参照してください。

ポータルをクローズするには:

1. ポータル・ビルダーの「ポータル」ページ(第46.2項「ポータル・ビルダー内の「ポータル」ページへのアクセス」を参照)で、表内の行を強調表示して必要なポータルを選択します。
[Ctrl]キーを押しながら、1つ以上のポータルを選択します。

2. 「アクション」メニューから、「閉じる」を選択します(図46-12)。

図46-12 ポータルのクローズ

3. 「OK」をクリックして、アクションを確定します。
ステータスが「アクティブ」から「クローズ済」に変更される点に注意してください(図46-13を参照)。

図46-13 「クローズ済」のポータル・ステータス

46.10 任意のポータルの再アクティブ化

ポータルを使用しなくなった場合、クローズすることがあります(第46.9項「任意のポータルのクローズ」)。ポータルを再度開く場合には、再アクティブ化できます。

ポータルを再アクティブ化するには:

1. ポータル・ビルダーの「ポータル」ページ(第46.2項「ポータル・ビルダー内の「ポータル」ページへのアクセス」を参照)で、表内の行を強調表示して必要なポータルを選択します。
Ctrl+click操作で、1つ以上のポータルを選択します。

2. 「アクション」メニューから、「アクティブ化」を選択します(図46-14)。

図46-14 ポータルのアクティブ化

3. 「OK」をクリックして、アクションを確定します。
ステータスが「クローズ済」から「アクティブ」に変更されている点に注意してください。

46.11 任意のポータルのオフライン化

ポータルは、デフォルトでオンラインです。メンテナンスのためにポータルを一時的にオフラインにできます。たとえば、不適切なコンテンツに気付いた場合、ポータルをオフライン化してそのコンテンツを変更し、再びオンラインに戻すことができます。オフラインのポータルにアクセスしたり再度オンラインに戻すことができるのは、システム管理者かManage Configuration権限を持つポータル・メンバーのみです。他のメンバーにはそのポータルの「ポータルが使用できません」ページが表示されます(第50章「システム・ページのカスタマイズ」を参照)。

再び使用しないポータルの永続的なクローズは、第46.9項「任意のポータルのクローズ」を参照してください。

ポータルをオフラインにするには:

1. ポータル・ビルダーの「ポータル」ページ(第46.2項「ポータル・ビルダー内の「ポータル」ページへのアクセス」を参照)で、表内の行を強調表示して必要なポータルを選択します。
[Ctrl]キーを押しながら、1つ以上のポータルを選択します。

2. 「アクション」メニューから、「オフラインに設定」を選択します(図46-15)。

図46-15 ポータルのオフライン化

3. 「OK」をクリックして、アクションを確定します。
ステータスが「オンライン」から「オフライン」に変更される点に注意してください(図46-16参照)。

図46-16 「オフライン」のポータル・ステータス

46.12 任意のポータルの再オンライン化

任意のポータルを再オンライン化するには:

1. ポータル・ビルダーの「ポータル」ページ(第46.2項「ポータル・ビルダー内の「ポータル」ページへのアクセス」を参照)で、表内の行を強調表示して必要なポータルを選択します。
[Ctrl]キーを押しながら、1つ以上のポータルを選択します。

2. 「アクション」メニューから、「オンラインに設定」を選択します(図46-17)。

図46-17 ポータルのオンライン化

3. 「OK」をクリックして、アクションを確定します。
ステータスが「オフライン」から「オンライン」に変更されている点に注意してください。

46.13 サブポータルの作成

どのポータルにも1つまたは複数のサブポータルを作成できます。親ポータルから、そのサブポータルに移動できます(第46.14項「ポータルまたはサブポータルの移動(親の変更)」を参照)。

サブポータルを作成するには:

1. ポータル・ビルダーの「ポータル」ページ(第46.2項「ポータル・ビルダー内の「ポータル」ページへのアクセス」を参照)で、サブポータルを作成するポータルの行をクリックします。

2. 「アクション」メニューから、「サブポータルの作成」を選択します(図46-18)。

図46-18 サブポータルの作成

「ポータル・テンプレートの選択」ページが表示されます。

サブポータル作成の詳細は、『Oracle WebCenter Portalでのポータルの構築』のサブポータルの作成に関する項を参照してください。

46.14 ポータルまたはサブポータルの移動(親の変更)

Portals-Manage Security and Configuration権限を持ったWebCenter Portalシステム管理者は、ポータルを移動してサブポータルにしたりサブポータルの親を変更したりできます。すべてのメタデータ(ページ、移動、セキュリティなど)とデータは、サブポータルの移動時に保持されます。

1つまたは複数のポータルのサブポータルをその現在の親ポータルから移動するには:

1. ポータル・ビルダーの「ポータル」ページ(第46.2項「ポータル・ビルダー内の「ポータル」ページへのアクセス」を参照)で、移動するポータルまたはサブポータルの行をクリックします。
ポータルのサブポータルを表示するには、「サブポータル」アイコンをクリックします(図46-19)。

図46-19 「サブポータル」アイコン

[Ctrl]キーを押しながら、1つ以上のポータルを選択します。

2. 「アクション」メニューから、「親の変更」を選択します(図46-20)。

図46-20 別の親ポータルへのポータルの移動

3. 「新規の親の選択」ダイアログ(図46-21)で、新規の親ポータルを選択するか、「親ポータルなし」チェック・ボックスを選択して、選択したポータルをポータル階層のルート親に移動します。

図46-21 「新規の親の選択」ダイアログ

注意:
WebCenter Portal内のすべてのポータルとサブポータルはリストに記載されているので、選択したサブポータルをポータル階層の下方に移動して、別のサブポータルの下に配置できます。

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

46.15 ポータルの削除

ポータルがある期間の間クローズされていたり非アクティブになっていた場合、WebCenter Portalから永続的に削除することも可能です。Portals-Manage Security and Configuration権限を持ったシステム管理者は、どのポータルも削除できます。ポータルの削除は永続的です。削除後に復元することはできません。

ポータルを削除した場合:

- そのポータルに関連付けられたすべてのページが削除されます。

- そのポータルに関連付けられたリンク、リスト、注意、タグおよびイベントが削除されます。

- ポータルのロールおよびメンバーシップが削除されます。

- ディスカッションおよびお知らせにより管理されたコンテンツは、デフォルトのフォーラムやポータルで作成されたカテゴリに保存されている場合でも削除されます。デフォルト以外のフォーラムやカテゴリで管理されたコンテンツは削除されません(詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルのディスカッション・フォーラムの設定の変更に関する項を参照)。

- WebCenter Portalにより自動的に作成されたポータルのメール配信リストが削除されます。ただし、ポータル・モデレータがカスタマイズした配信リストは削除されません(詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルのメール配信リストの構成に関する項を参照)。

- コンテンツ・リポジトリ、メールなど外部サービスにより管理されるコンテンツが削除されます。

- ポータルがポータル階層で親である場合、子のサブポータルも削除されます。

モデレータがポータルの設定を編集中のときにポータルを削除することはできませんが、それ以外には制限はありません。

ポータルを削除するには:

1. ポータル・ビルダーの「ポータル」ページ(第46.2項「ポータル・ビルダー内の「ポータル」ページへのアクセス」を参照)で、表内の行を強調表示して削除するポータルを選択します。
Ctrl+click操作で、1つ以上のポータルを選択します。

2. 「アクション」メニューから、「削除」を選択します(図46-22)。

図46-22 ポータルの削除

3. 「削除」をクリックしてポータルの削除を確定します。

なんらかの理由で削除のプロセスが失敗した場合、ポータルは「ポータル」タブから削除されません。この現象は、バックエンド・サーバーに接続できない場合に発生することがあります。「削除」を再度クリックすれば、ポータルは削除されます。

47 ポータル・ビルダー管理内の「管理」ページの検索

この章では、WebCenterポータル・ビルダー管理内の「管理」ページについて説明し、「管理」ページから実行できるタスクの概要を示します。

この章には次のトピックが含まれます:

- 第47.1項「ポータル・ビルダー管理について」

- 第47.2項「「ポータル・ビルダー管理」ページへのアクセス」

- 第47.3項「ポータル・ビルダー管理タスクの実行」

権限:
この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server-Manage Configuration

さらに、ポータルの作成および管理の権限(Portals-Create PortalsおよびPortals-Manage Security and Configurationまたはどちらか一方)が必要です。権限の詳細は、第49.3項「アプリケーション・ロールおよび権限について」を参照してください。

注意:

- Internet Explorerを使用している場合、「互換表示」をオフにしてからWebCenter Portalにアクセスしてください。Internet Explorerでは、「ツール」メニューから「互換表示設定」を選択します。「互換表示設定」ダイアログで、すべてのオプションを選択解除し、「閉じる」をクリックします。

- WebCenter Portalでは、1つのブラウザ・タブまたはウィンドウ表示のみがサポートされます。WebCenter Portalを複数のブラウザ・タブやウィンドウに同時に表示しようとしても、正しく動作しません。

47.1 ポータル・ビルダー管理について

WebCenter Portalシステム管理者は、「ポータル・ビルダー管理」ページからWebCenter Portalアプリケーション全体を管理できます。

- Administratorロールを持つユーザーは、WebCenter Portalのアプリケーション全体のプロパティの設定、ビジネス・ロール・ページの作成、ディスカッション・フォーラム、メールおよびピープル・コネクション・サービスのデフォルト設定の構成、プロデューサと外部アプリケーションの登録、およびその他の管理作業(ログイン・ページや自己登録ページの編集など)を実行できます。
また管理者は、WebCenter Portalのユーザーおよびロールの管理、他のユーザーに対する権限の委任や取消し、ポータルおよびポータル・テンプレートの管理、さらにポータル情報のインポートおよびエクスポートを実行できます。システム管理者のロールに関する詳細は、第2.1項「システム管理者のロール」を参照してください。

- システム管理者は、「WebCenter Portal管理」ページから、WebCenter Portalに対する一般的な設定(アプリケーション名とロゴ、デフォルトのスキンとページ・テンプレート、リソース・カタログ、ランディング・ページなど)の指定、セキュリティ設定(ユーザー・ロールおよびグループ・ロールと各ロールに対するデフォルトの権限など)の指定、ツールとサービスの管理、ビジネス・ページ、システム・ページおよび個人用ページの管理を実行できます。
WebCenterの「ポータル・ビルダー管理」ページの詳細は、第47.3項「ポータル・ビルダー管理タスクの実行」を参照してください。

47.2 「ポータル・ビルダー管理」ページへのアクセス

管理アクションの多くは、WebCenterの「ポータル・ビルダー管理」ページから実行できます。システム管理者としてログインした後、このページにアクセスする方法は次のとおりです。

- メニュー・バーで「管理」リンクをクリックします(図47-1)。

図47-1 WebCenter Portalの「管理」リンク

- ブラウザに次のURLを入力し、WebCenter Portalの「管理」ページに直接移動します。

http://host:port/webcenter/portal/builder/administration

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

47.3 ポータル・ビルダー管理タスクの実行

WebCenter Portalには、7つの主要な「管理」ページがあります(図47-2)。

- 一般

- セキュリティ

- ツールとサービス

- システム・ページ

- ビジネス・ロール・ページ

- 個人用ページ

- デバイス設定

図47-2 WebCenter Portalの「管理」

表47-1に、システム管理者が「管理」ページから実行できるアクションの説明と、各アクションを実行する際に必要な権限を示します。

表47-1 WebCenter Portalの「管理」ページ

ページ

説明

必要な権限

一般

このページを使用して、次のようなWebCenter Portalのアプリケーションレベルのプロパティを設定します。

- アプリケーション名とロゴ

- デフォルトのページ・テンプレート、スキンおよびナビゲーション

- 使用するリソース・カタログ

- ページ・フッターのオプション

- デフォルトの言語

- ユーザーやグループの開始ページまたはポータル

- 自己登録オプション

詳細は、第48章「ポータル間のグローバルなデフォルト設定の構成」を参照してください。

PortalServer-Manage All

または

Portal Server-Manage Configuration

セキュリティ

このページを使用して、ユーザーに対する表示および変更可能な項目を制御できるデフォルトのセキュリティ・モデルを表示します。WebCenter Portalにユーザーおよびグループを追加して、ロールを割り当てることもできます。

詳細は、第49章「ポータル間のセキュリティの管理」を参照してください。

Portal Server-Manage All

ツールとサービス

このページを使用して、WebCenter Portalのツールとサービスの設定を管理できます。

詳細は、第8章「ツールおよびサービスの管理」を参照してください。

Portal Server-Manage All

または

Portal Server-Manage Configuration

システム・ページ

このページを使用してデフォルトの事前構成済ページをカスタマイズします。これには、WebCenter Portalで使用できるタスク・フローなどが含まれます。

詳細は、第50章「システム・ページのカスタマイズ」を参照してください。

Portal Server-Manage All

または

Portal Server-Manage Configuration

または

Portals-Create, Edit, and Delete Pages

ビジネス・ロール・ページ

このページを使用して、特定のユーザーおよびグループを対象としたページでの作業や、これらのビジネス・ロール・ページに対するページ管理タスクを実行します。

詳細は、第51章「ビジネス・ロール・ページの管理」を参照してください。

Portal Server-Manage All

または

Portal Server-Manage Configuration

または

Portals-Create, Edit, and Delete Pages

個人用ページ

このページを使用して、ユーザーが作成する個人用ページを管理します。ユーザーは個人用ページを作成して、そのページへのアクセスを設定できます。ただし、システム管理者は、他のユーザーが作成した個人用ページを編集できます。

詳細は、第52章「個人用ページの管理」を参照してください。

Portal Server-Manage All

または

Portal Server-Manage Configuration

または

Portals-Create, Edit, and Delete Pages

デバイス設定

このページを使用して、WebCenter Portalのデバイス・グループとデバイスを作成および管理します。デバイス・グループを作成し、種々のデバイスをそれに関連付け、デバイス・グループに対して使用するスキンやページ・テンプレートなどのアセットを指定できます。

詳細は、第53章「デバイス設定の管理」を参照してください。

Portal Server-Manage All

または

Portal Server-Manage Configuration

48 ポータル間のグローバルなデフォルト設定の構成

この章では、WebCenterポータル・ビルダー管理の「一般」ページで使用できるタスクについて説明します(図48-1)。システム管理者はデフォルト設定を変更して、組織の要件に合わせることが可能です。

この章には次のトピックが含まれます:

- 第48.1項「名前とロゴのカスタマイズ」

- 第48.2項「デフォルト・ページ・テンプレートの選択」

- 第48.3項「デフォルト・スキンの選択」

- 第48.4項「デフォルト・ナビゲーションの選択」

- 第48.5項「デフォルト・リソース・カタログの選択」

- 第48.6項「コピーライトとプライバシ宣言文のカスタマイズ」

- 第48.7項「オンライン・ヘルプ・リンクのカスタマイズ」

- 第48.8項「デフォルト表示言語の選択」

- 第48.9項「デフォルト開始ページ(またはランディング・ページ)の選択」

- 第48.10項「セッション・タイムアウト設定の指定」

- 第48.11項「自己登録の有効化」

- 第48.12項「新しいページのデフォルトのルック・アンド・フィールの選択」

- 第48.13項「ホーム・ポータルへのアクセスの有効化と無効化」

- 第48.14項「WebCenter Portalツールとサービスのデフォルトの設定」

権限:
この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server-Manage Configuration

さらに、ポータルの作成および管理の権限(Portals-Create PortalsおよびPortals-Manage Security and Configurationまたはどちらか一方)が必要です。権限の詳細は、第49.3項「アプリケーション・ロールおよび権限について」を参照してください。

図48-1 「ポータル・ビルダー」の「管理」:「一般」ページ

48.1 名前とロゴのカスタマイズ

初期状態では、Oracleロゴとアプリケーション名の「WebCenter Portal」が、すべてのポータルのバナーに表示されます(図48-2)。ロゴも名前のどちらも、対象ユーザーにより相応しいものに変更できます。たとえば、ここに会社名や会社の部署名を表示できます。

指定するロゴは、アプリケーションのページ・テンプレートに応じてサイズを変更します。ロゴのサイズを調整するには、ページ・テンプレートを変更します。『Oracle WebCenter Portalでのポータルの構築』のページ・テンプレートの編集に関する章を参照してください。

図48-2 WebCenter Portalの名前とロゴ

WebCenter Portalの名前とロゴを変更するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「アプリケーション名」フィールドに、新しい名前を入力します(図48-3)。
英数字や、ポータル、アンダースコア(_)およびダッシュ(-)も許可されます。たとえば、Finance Department - My Corporationのようになります。

図48-3 アプリケーションの名前とロゴのカスタマイズ

3. ロゴを変更するには、「アプリケーション・ロゴ」フィールドの隣にある「参照」をクリックします。

4. 「ファイルのアップロード」ダイアログで、使用するロゴに移動します。
ロゴのイメージ・ファイルは、最大150 KBに指定できます。サポートされているファイル形式は、.gifまたは.GIF、.pngまたは.PNGおよび.jpgまたは.JPGです。ファイルがアップロードされない場合には、アップロードしているファイルのサイズを確認します。ファイル名に使用できるのは英数字のみです。

ロゴはWebCenter Portalのイメージ・ディレクトリ(/webcenter/images)にアップロードされ、ただちに新しいロゴがアプリケーション・バナーの左上隅に表示されます。

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

48.2 デフォルト・ページ・テンプレートの選択

WebCenter Portalでは、ページ・テンプレートによって、個々のページとページ・グループがどのようにユーザーの画面で表示されるかが定義されます。どのページも、ページ・テンプレート内に表示されます。システム管理者がページを表示するために使用するデフォルト・ページ・テンプレートを定義できる場所は、次のとおりです。

- ホーム・ポータル

- 新規ポータル(ポータルのテンプレートが特定のページ・テンプレートの使用を指定していない場合)

ポータル・モデレータは自分のポータル内でデフォルトの選択をオーバーライドできますが、ユーザーはホーム・ポータルに適用されたページ・テンプレートをオーバーライドできません。

デバイス・グループの「デフォルト・ページ・テンプレート」は、「WebCenter Portal管理」の「デバイス設定」からもオーバーライドできるようになりました。第53.2.2項「デバイスの編集」で説明されているように、適切なデバイス・グループを編集します。選択したグループのデバイスで使用するには、「アセット」セクションからデフォルト・ページ・テンプレートを選択します。

各ページ・テンプレートはスキンと連携して、ポータル内のページ全体のルック・アンド・フィールを決定します。ページ・テンプレートはページ上のコンポーネントの場所と動作を制御しますが、スキンは色、フォントなど様々なコンポーネントの視覚的な外観を制御します。

関連項目:
スキンの詳細は、『Oracle WebCenter Portalでのポータルの構築』の「スキンでの作業」を参照してください。

各ページ・テンプレートでは優先スキンを定義して、そのページ・テンプレートに対して最適に連携するスキンを特定できます。そのページ・テンプレートをポータルのデフォルト・ページ・テンプレートとして選択したり、システムのデフォルトとして選択すると、デフォルトのスキンは自動的にそのページ・テンプレートの優先スキンに更新されます。

関連項目:
詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・テンプレートの優先スキンの設定に関する項を参照してください。

『Oracle WebCenter Portalでのポータルの構築』の「ページ・テンプレートでの作業」も参照してください。

WebCenter Portalのデフォルト・ページ・テンプレートを選択するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 次のいずれかを実行します。

- 使用可能リストから「デフォルト・ページ・テンプレート」を選択します(図48-4)。

注意:
[system default]では、webcenter-config. xmlにハードコードされているWebCenter Portal用に定義されているデフォルト・ページ・テンプレートを指定します。

このリストにページ・テンプレートを追加する方法は、『Oracle WebCenter Portalでのポータルの構築』のページ・テンプレートの公開と非表示に関する項を参照してください。

図48-4 「デフォルト・ページ・テンプレート」の選択

- 「拡張編集オプション」アイコンをクリックして「式ビルダー」を選択し、特定の基準に基づいて動的にデフォルト・ページ・テンプレートを決定するEL式を入力します。ELアシスタンスが必要な場合、アプリケーション開発者はEL式を提供できます。『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の付録「式言語の式」を参照してください。
たとえば、ログイン・ユーザーが所属する部署や組織に応じて、デフォルト・ページ・テンプレートを変更することもできます。

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

48.3 デフォルト・スキンの選択

システム管理者は、デフォルト・スキンを変更して、すべてのユーザーに対するWebCenter Portalのデフォルトの外観をカスタマイズすることもできます。スキンによって、ユーザー・インタフェースの表示が変更されますが、アプリケーションの動作は変更されません。第48.3.1項「WebCenter Portalのスキンの適用」を参照してください。

ユーザーは、ユーザー・プリファレンスを使用してデフォルト・スキンの選択をオーバーライドできます。ただし、特定のページ・テンプレートで使用するスキンは、多くの場合、作成されます。そのため、スキンの選択は選択したページ・テンプレートと互換性があることが必要です。詳細は、『Oracle WebCenter Portalの使用』のビューのルック・アンド・フィールの変更に関する項を参照してください。

すべての組込みスキンが要件に合わない場合や、企業ブランドを反映するルック・アンド・フィールを適用する場合には、独自のADFスキンを作成して適用できます。独自のページ・テンプレートの場合、優先スキンを示すには、カスタム属性であるpreferredSkinを指定されたページ・テンプレートで優先的に使用されるスキンのスキン・ファミリIDの値に設定します(「共有アセット」を選択して「ページ・テンプレート」をコピーし、「アクション」ドロップダウン・リストから「プロパティの編集」を選択します)。こうすることにより、作成したページ・テンプレートが選択されたときにスキンを優先スキンに切り替えることができます。そのページ・テンプレートが変更された場合、スキンはそのページ・テンプレートに一致するように更新されます(式に設定されていなくても)。詳細は、『Oracle WebCenter Portalでのポータルの構築』のスキンの作成に関する項を参照してください。

デバイス・グループの「デフォルト・スキン」は、「WebCenter Portal管理」の「デバイス設定」からもオーバーライドできるようになりました。適切なデバイス・グループを選択し、「アクション」ドロップダウン・リストから「編集」を選択します。選択したグループのデバイスで使用するには、「アセット」セクションからデフォルト・スキンを選択します。

必要に応じて、EL式のデフォルト・スキンを参照できます。ELアシスタンスが必要な場合、アプリケーション開発者はEL式を提供できます。『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の付録「式言語の式」を参照してください。

個々のユーザーがシステム管理者により指定されたデフォルト・スキンを使用しない場合、ユーザーがユーザー・プリファレンスによりスキンを変更してホーム・ポータル・ビューに適用できます。『Oracle WebCenter Portalでのポータルの構築』のポータルのデフォルト・スキンの設定に関する項を参照してください。

48.3.1 WebCenter Portalのスキンの適用

WebCenter Portalのスキンを設定すると、そのスキンはホーム・ポータル、およびアプリケーションレベルのスキン設定を使用するすべてのポータルに適用されます。そのスキンは作成されたすべての新規ポータルにも適用されます。

スキンをWebCenter Portalに適用するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 次のいずれかを実行します。

- 使用可能リストからアプリケーション・スキンを選択します(図48-5)。

注意:
「アプリケーション・スキン」リストに目的のスキンが表示されない場合、その「選択可能」オプションが選択解除されているためである可能性があります。詳細は、『Oracle WebCenter Portalでのポータルの構築』のスキンの管理に関する項を参照してください。

各ページ・テンプレートでは優先スキンを定義して、そのページ・テンプレートに対して最適に連携するスキンを特定できます。ページ・テンプレートがポータルの新規デフォルト・ページ・テンプレートまたはシステムのデフォルトとして選択されると、そのデフォルト・スキンが自動的にそのページ・テンプレートの優先スキンに更新されます。

関連項目:
詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・テンプレートの優先スキンの設定に関する項を参照してください。

警告:

選択したデフォルト・ページ・テンプレートの優先スキン以外のスキンにデフォルト・スキンを変更すると、予期しない結果が生じる可能性があります。

図48-5 スキンのWebCenter Portalへの適用

- 「拡張編集オプション」アイコンをクリックして「式ビルダー」を選択し、特定の基準に基づいて動的にデフォルト・アプリケーション・スキンを決定するEL式を入力します。
たとえば、ログイン・ユーザーが所属する部署や組織に応じて、デフォルト・スキンを変更することもできます。

3. 「保存」をクリックします。
選択するスキンがWebCenter Portal、作成したすべての新規ポータル、およびアプリケーションレベルのスキン設定を使用するすべてのポータルに適用されます。そのスキンは、アプリケーションレベルのスキン設定がオーバーライドされたポータルには適用されません。

48.4 デフォルト・ナビゲーションの選択

WebCenter Portalでは、ナビゲーション・モデルにより素早く簡単に情報に移動して確認できます。システム管理者は、ホーム・ポータルの情報を表示するために使用するナビゲーションを指定できます。

または、特定の基準に基づいて動的にナビゲーションを決定するEL式を入力できます。ELアシスタンスが必要な場合、アプリケーション開発者はEL式を提供できます。『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の付録「式言語の式」を参照してください。たとえば、ログイン・ユーザーが所属する部署や組織に応じて、別々のナビゲーションを表示することもできます。

『Oracle WebCenter Portalでのポータルの構築』の「ナビゲーションでの作業」も参照してください。

ホーム・ポータルのナビゲーション・モデルを選択するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 次のいずれかを実行します。

- 使用可能リストから「ホーム・ポータルのナビゲーション」を選択します(図48-6)。
このリストにナビゲーションを追加する方法は、『Oracle WebCenter Portalでのポータルの構築』のポータル・アセットの表示および非表示に関する項を参照してください。

図48-6 「ホーム・ポータルのナビゲーション」の選択

- 「拡張編集オプション」アイコンをクリックして「式ビルダー」を選択し、特定の基準に基づいて動的にナビゲーションを決定するEL式を入力します。ELアシスタンスが必要な場合、アプリケーション開発者はEL式を提供できます。『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の付録「式言語の式」を参照してください。

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

48.5 デフォルト・リソース・カタログの選択

WebCenter Portalでは、ページ、ページ・テンプレート、ページ・スタイルまたはタスク・フロー・アセットを編集する際に「コンテンツの追加」をクリックすると、リソース・カタログが表示されます。リソース・カタログには一連のフォルダおよびサブフォルダの使用可能なリソースが示されます。そのコンテンツは、現在使用可能なサービスおよびページやページ・テンプレートを編集するユーザーの権限に応じて動的に変わります。使用可能なリソースには、タスク・フロー、ポートレットおよびイメージ、コンテンツ・ボックス、ハイパーリンクなどのページ・コンポーネントが含まれます。WebCenter Portalは、複数の組込みデフォルト・リソース・カタログを提供します。ただし、新しいタスク・フローの追加、タスク・フローの削除またはターゲット・ユーザーに適切なフォルダ階層の再編成、あるいは新しいカスタム・リソース・カタログの作成を最初から行うことができます。詳細は、『Oracle WebCenter Portalでのポータルの構築』の「リソース・カタログでの作業」を参照してください。

システム管理者が指定できる使用するデフォルト・ページ・カタログの場所は、次のとおりです。

- 新規ポータル

- ホーム・ポータル

- ビジネス・ロール・ページ

- ポータル内のページ・テンプレート

- ホーム・ポータルのページ・テンプレート

デフォルト・リソース・カタログを選択する手順は次のとおりです。

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「アセット」セクションで、図48-7に示されているリストからデフォルト・リソース・カタログを選択します。
これらリストに既存のリソース・カタログを公開する方法は、『Oracle WebCenter Portalでのポータルの構築』のポータル・アセットの表示および非表示に関する項を参照してください。

図48-7 アセットに対するリソース・カタログの選択

3. オプションで、「拡張編集オプション」アイコンをクリックして「式ビルダー」を選択し、特定の基準に基づいて動的にデフォルト・リソース・カタログを決定するEL式を入力します。たとえば、ログイン・ユーザーが属するロールに応じて、デフォルト・リソース・カタログを変更することもできます。ELアシスタンスが必要な場合、アプリケーション開発者はEL式を提供できます。『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の付録「式言語の式」を参照してください。

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

48.6 コピーライトとプライバシ宣言文のカスタマイズ

システム管理者は、WebCenter Portalのコピーライトとプライバシ宣言文をカスタマイズしたり、非表示にすることができます。

- コピーライト: アプリケーション全体のコピーライト宣言文を表示します。

- プライバシURL: アプリケーション全体のプライバシ・ポリシーが含まれるドキュメントにリンクします。

デフォルト・ページ・テンプレートでは、コピーライトとプライバシURLはWebCenter Portalのページ・フッターに表示されます(図48-8)。

オプションで、コピーライト・メッセージとプライバシ・ドキュメントをEL式で参照できます。ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。Oracle WebCenter PortalおよびOracle JDeveloperによるポータルの開発の式言語式を参照してください。

図48-8 ページ・フッターのコピーライトとプライバシ宣言文

個々のポータルには独自のコピーライトとプライバシ宣言文を記載できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のコピーライト宣言文とプライバシURLのカスタマイズに関する項を参照してください。

コピーライトとプライバシ宣言文をカスタマイズしたり非表示にするには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「オプション」セクションで、「ページ・フッターの表示」を選択または選択解除し、それぞれページ・フッターのコピーライトとプライバシの情報を表示または非表示にします(図48-9)。

図48-9 コピーライトとプライバシURLのカスタマイズ

必要に応じて法律上の注意点とプライバシURLを変更します。

- コピーライト: WebCenter Portalに対する適切なコピーライト宣言文を入力します。コピーライト情報が不要な場合には、このフィールドは空白のままにします。

- プライバシURL: アプリケーションのプライバシ・ポリシーの場所を指定します。完全修飾URLを入力します。プライバシ情報が不要な場合には、このフィールドは空白のままにします。

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

48.7 オンライン・ヘルプ・リンクのカスタマイズ

WebCenter Portalのオンライン・ヘルプは、「ヘルプ」リンクをクリックすると表示されます(図48-10)。

図48-10 WebCenter Portalの「ヘルプ」リンク

初期状態では、この「ヘルプ」リンクはOracleの組込みヘルプを開きます。『Oracle WebCenter Portalでのポータルの構築』のグローバル・ヘルプに関する項を参照してください。また、特に自分のユーザーを対象にオンライン・ヘルプを記述して、別のヘルプの場所に「ヘルプ」リンクをリダイレクトすることも可能です。

オプションで、「ヘルプ」の場所をEL式で参照できます。ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』の式言語式を参照してください。

「ヘルプ」リンクをカスタマイズすると、ヘルプ・ボタン、ヘルプ・アイコンなどによりWebCenter Portalの組込みヘルプが引き続き使用できます。

メイン・ヘルプ・リンクをカスタマイズするには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「オプション」セクションで、「グローバル・ヘルプURL」フィールドにヘルプの場所を入力します(図48-11)。

図48-11 WebCenter Portalオンライン・ヘルプの「グローバル・ヘルプURL」

完全修飾URLを次の形式で入力します。

http://host:port/helplocation

例:

http://myhost:8888/myhelp

デフォルト・グローバル・ヘルプURLは、/webcenterhelp/spaces?topic=welcome_mainです。このURLはOracle Help for the Web (OHW)を開き、WebCenter Portalに対するOracleの組込みヘルプを表示します。デフォルト設定に戻す場合には、このURLを入力します。

注意:
「グローバル・ヘルプURL」フィールドを空白のままにすると、「ヘルプ」リンクは表示されません。

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

カスタム・ヘルプが適切に開いているかどうかを確認するには、WebCenter Portalの「ヘルプ」をクリックします。

48.8 デフォルト表示言語の選択

初期設定で、WebCenter Portalでは、27の言語と100の異なるロケールがサポートされています。WebCenter Portalのシステム管理者が、デフォルトの表示言語を選択する必要があります。デフォルト言語を選択する際は、アプリケーションを使用する人々の大多数に適した言語は何かを考慮します。デフォルト言語を選択する際は、アプリケーションを使用する人々の大多数に適した言語は何かを考慮します。たとえば、ログインしたユーザーの部署や組織に応じて、デフォルトの表示言語を変更することもできます。ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』の式言語式を参照してください。

ユーザーが初めてWebCenter Portalにログインすると、デフォルト言語が表示されますが、個々のユーザーはユーザー・プリファレンスにより表示言語をパーソナライズできます。『Oracle WebCenter Portalでのポータルの構築』のポータルの表示言語の設定に関する項を参照してください。

デフォルト表示言語は、ユーザーがWebCenter Portalにログインする際にのみ適用されます。ようこそページ、ログイン・ページなどのパブリック・ページはブラウザの言語で表示されます。デフォルト言語が指定されていない場合、ブラウザの言語が使用されます。『Oracle WebCenter Portalでのポータルの構築』の表示言語の優先順位に関する項も参照してください。

注意:
モデレータは、特定のポータルの表示言語を指定できます。定義の際に、このポータル言語はデフォルトの言語および任意の言語のユーザー・プリファレンスの両方をオーバーライドします。『Oracle WebCenter Portalでのポータルの構築』のポータルの表示言語の設定に関する項も参照してください。

WebCenter Portalのデフォルト表示言語を選択するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 次のいずれかを実行します。

- 使用可能リストから「デフォルト言語」を選択します(図48-12)。
必要な言語がドロップダウン・リストにない場合、「カスタマイズ」をクリックして必要な言語のチェック・ボックスを選択し、「保存」をクリックします。第48.8.1項「言語リストのカスタマイズ」を参照してください。

図48-12 デフォルト言語の選択

完全に新しい言語を追加するには、ローカライズ・チームがWebCenter Portalリソース・バンドルをその新しい言語に翻訳し、その翻訳をWebCenter Portalがデプロイされている管理対象サーバーにデプロイする必要があります。詳細は、第45.5項「WebCenter Portalへの新規言語のサポートの追加」を参照してください。

- 「拡張編集オプション」アイコンをクリックして「式ビルダー」を選択し、特定の基準に基づいて動的にデフォルト言語を決定するEL式を入力します。ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』の式言語式を参照してください。

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

ここでの選択に対して使用可能な表示言語は、ユーザー・プリファレンスによりユーザーおよびポータル・モデレータにも提供されます。システム管理者は、ユーザーが使用できる言語の範囲を縮小できます。詳細は、第48.8.1項「言語リストのカスタマイズ」を参照してください。

48.8.1 言語リストのカスタマイズ

初期設定では、WebCenter Portalには27の言語と100の異なるロケールが用意されており、これらの言語はすべてデフォルトで使用可能になっています。システム管理者は、ユーザーに合うように言語を調整できます。たとえば、非常に簡略化した言語リストが必要な場合には地域言語バリアントをすべて削除できます。または、特にヨーロッパのユーザーを対象にしたポータルの場合、ヨーロッパの言語のみを提供できます。

ユーザーが使用できる言語をカスタマイズするには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デフォルト言語」の横の「カスタマイズ」をクリックします(図48-13)。

図48-13 デフォルト言語のオプションのカスタマイズ

3. 各言語チェック・ボックスの選択(または選択解除)により提供する言語を選択します(図48-14)。

図48-14 使用可能な言語の選択

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

48.9 デフォルト開始ページ(またはランディング・ページ)の選択

デフォルトでは、ユーザーには、ログイン時にホーム・ポータルが表示されますが、初期ランディング・ページを特定のポータルやページにするよう構成できます。特定のグループ、認証されたユーザー、およびパブリック・ユーザーに対する開始ページを指定できます。詳細は、第49章「ポータル間のセキュリティの管理」を参照してください。

WebCenter Portalのランディング・ページを選択するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デフォルト・ポータル」セクションで、ユーザーがログインした際の初期画面(ホーム・ポータル、特定のポータルやページなど)を選択します(図48-15)。

図48-15 デフォルト開始ページの選択

- 選択したグループに対するデフォルト・ランディング・ページを指定するには、第48.9.1項「グループに対するデフォルト開始ページの選択」を参照してください。

- 指定したどのグループにも属さないその他のすべての認証済ユーザーに対するデフォルト・ランディング・ページを指定するには、第48.9.2項「認証済ユーザーに対するデフォルト開始ページの選択」を参照してください。

- すべてのパブリック・ユーザー対するデフォルト・ランディング・ページを指定するには、第48.9.3項「パブリック・ユーザーに対するデフォルト開始ページの選択」を参照してください。

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

48.9.1 グループに対するデフォルト開始ページの選択

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デフォルト・ポータル」セクションで、選択済企業グループに特定の開始ページを表示する場合、「グループの追加」をクリックします。

注意:
デフォルト・ポータルをグループ・メンバーに表示するには、そのポータルが非表示またはプライベートであっても、そのグループ自体がポータルのメンバーである必要があります。

3. 「グループの追加」ダイアログで、グループを検索するかリストからグループを選択し、「OK」をクリックします。
選択したグループが表に追加されます(図48-16)。

図48-16 グループのランディング・ページの指定

グループは、ログインするとホーム・ポータルに移動します。

4. ランディング・ページの「場所」を変更するには、グループ名を選択して「編集」をクリックします。
「編集」ダイアログが開きます(図48-17)。

図48-17 ランディング・ページのオプション

5. 目的のグループに最初に表示されるのが、ホーム・ポータルか、特定のポータルまたはページかを選択します。

- ホーム・ポータルを開く。デフォルトで選択されています。ユーザーには、最初のログイン時にホーム・ポータルが表示されます。

- 特定のポータルを開く。特定のポータルの表示を指定する際にこのオプションを選択し、ポータル名を入力するか「参照」をクリックしてポータルのリストから選択します。「ポータルの表示」リストからオプションを選択し、「OK」をクリックします。例:

http://host:port/webcenter/portal/portalName

- 特定のページURLを開く。特定のページの表示を指定する際に選択し、そのページの場所を入力します。

注意:
指定されたページをすべてのユーザーが使用できることを確認します(『Oracle WebCenter Portalでのポータルの構築』のページ・セキュリティの設定に関する項を参照)。ユーザーに指定されたページのアクセス権限がない場合、「ページが見つかりません」メッセージが表示されます。

通常、これは内部のページです。この例に示すように、完全修飾のページURLか相対ページURLを入力できます。

http://mywebcenter.com:8888/webcenter/portal/page/landingpage

http://mywebcenter.com:8888/webcenter/portal/portalname/page/landingpage

/portals/portalname/page/landingpage

外部ページを指定する場合には、必ず完全修飾URLを指定してください。

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

48.9.2 認証済ユーザーに対するデフォルト開始ページの選択

WebCenter PortalのユーザーにはデフォルトでAuthenticated-Userロールが付与されています。ポータルのページにアクセスするためのAuthenticated-Userロール権限が付与されるまで、ポータルには完全にアクセスできません。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル・ロールの権限の表示および編集に関する項を参照してください。

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「認証されたユーザー」セクションで、第48.9.1項「グループに対するデフォルト開始ページの選択」で指定された、いずれのグループにも属さない、認証されたユーザーに対して、最初のログイン時に表示される画面を指定します(図48-18)。

図48-18 「認証されたユーザー」に対するランディング・ページの選択

- ホーム・ポータルを開く。デフォルトで選択されています。ユーザーには、最初のログイン時にホーム・ポータルが表示されます。

- 特定のポータルを開く。特定のポータルの表示を指定する際に選択し、次のようにポータル名を入力します。

http://host:port/webcenter/portal/portalName

または、「参照」をクリックして、ポータルのリストから選択します(図48-19)。「ポータルの追加」リストからオプションを選択して「OK」をクリックするか、「検索」フィールドにポータル名を入力して「検索」をクリックします。

図48-19 「ポータルの追加」ダイアログ

- 特定のページURLを開く。特定のページの表示を指定する際に選択し、そのページの場所を入力します。

注意:
指定されたページをすべてのユーザーが使用できることを確認します(『Oracle WebCenter Portalでのポータルの構築』のページ・セキュリティの設定に関する項を参照)。ユーザーに指定されたページのアクセス権限がない場合、「ページが見つかりません」メッセージが表示されます。

通常、これは内部のページです。この例に示すように、完全修飾のページURLか相対ページURLを入力できます。

http://mywebcenter.com:8888/webcenter/portal/page/landingpage

http://mywebcenter.com:8888/webcenter/portal/portalname/page/landingpage

/portals/portalname/page/landingpage

外部ページを指定する場合には、必ず完全修飾URLを指定してください。

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

48.9.3 パブリック・ユーザーに対するデフォルト開始ページの選択

ログインせずにWebCenter Portalにアクセスする任意のユーザーは、Public-Userロールを引き受けます。詳細は、第49章「ポータル間のセキュリティの管理」を参照してください。

ポータルを、そのポータルが含まれるWebCenter Portalインスタンスにアクセスする任意のユーザーが使用できるようにできます。WebCenter Portalアカウントへの登録は不要です。提供されるパブリック情報により、ポータルをメンバー以外のユーザーやWebCenter Portalコミュニティ外のユーザーと共有できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルへのパブリック・アクセス権限の付与に関する項を参照してください。

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デフォルト・ログイン設定」セクションで、パブリック・ユーザーが最初にログインする際に表示される画面を指定します(図48-20)。

図48-20 「パブリック・ユーザー」に対するランディング・ページの選択

- ようこそページを開きます。デフォルトで選択されています。ユーザーには、最初のログイン時にWebCenter Portalのようこそページが表示されます。

- 特定のポータルを開く。特定のポータルの表示を指定する際に選択し、ポータル名を入力します。例:

http://host:port/webcenter/portal/portalName

または、「参照」をクリックして、ポータルのリストから選択します(図48-19)。「ポータルの追加」リストからオプションを選択して「OK」をクリックするか、「検索」フィールドにポータル名を入力して「検索」をクリックします。

- 特定のページURLを開く。特定のページの表示を指定する際に選択し、そのページの場所を入力します。
通常、これは内部のページです。この例に示すように、完全修飾のページURLか相対ページURLを入力できます。

http://mywebcenter.com:8888/webcenter/portal/page/landingpage

http://mywebcenter.com:8888/webcenter/portal/portalname/page/landingpage

/portals/portalname/page/landingpage

外部ページを指定する場合には、必ず完全修飾URLを指定してください。

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

48.10 セッション・タイムアウト設定の指定

WebCenter Portalセッションで長期間アクティビティがない場合、タイムアウトとなります。初期設定のWebCenter Portalでは、セッション・タイムアウトは45分に設定されています。セッションがタイムアウトとなるまでのデフォルトの経過時間(分)を変更して、セッションがタイムアウトとなる際にポップアップまたはウィンドウを表示するかどうかを選択できます。

注意:
セッション・タイムアウトの値は、「属性」ページに属性名wcSessionTimeoutPeriodで表示することも可能です。

WebCenter Portalのセッション・タイムアウト設定を変更するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「セッション・タイムアウト」セクションで、WebCenter Portalがタイムアウトとなった場合に必要な結果を選択します(図48-21)。

図48-21 「セッション・タイムアウト」オプション

- タイムアウト・ページの表示。WebCenter Portalタイムアウト・ページをブラウザで表示する場合に選択します(図48-22)。この場合、ユーザーは表示されたリンクをクリックして再度ログインし、デフォルト開始ページを再起動できます(第48.9項「デフォルト開始ページ(またはランディング・ページ)の選択」も参照)。

図48-22 タイムアウト・ページ

- タイムアウトのポップアップ表示。「セッション・タイムアウト」値に達した場合、「期限切れ警告」通知のポップアップを表示する際に選択します(図48-23)。タイムアウトを回避するには、2分以内に「OK」をクリックします。「期限切れ警告」に2分以内に応答しないと、セッションはタイムアウトとなります。タイムアウト通知のポップアップで(図48-24)、「OK」をクリックして再度ログインし、セッションが期限切れになったときにアクティブだったページを再起動します。
ブラウザがポップアップを表示するように設定されている場合、「タイムアウトのポップアップ表示」オプションが機能します。ブラウザがポップアップをブロックするように設定されている場合、タイムアウト・ページが表示されます。

図48-23 「期限切れ警告」の通知(セッション・タイムアウトの際に表示)

図48-24 タイムアウトの通知(セッション・タイムアウトの2分後に表示)

3. (オプション)「セッション・タイムアウト(分)」フィールドに、新しい値を入力します。
デフォルト値は45分、最低値は5、最大値は1440 (24時間)です。このフィールドを空白のままにすると、デフォルト値(45)が適用されます。

注意:
WebCenter Portalでシングル・サインオン(SSO)が構成されている場合、ここで設定するセッション・タイムアウト値はSSOタイムアウト値より高くしないようお薦めします。セッション・タイムアウトは使用可能な物理メモリーと、サポートする必要がある同時ユーザー数のファクタです。セッション・タイムアウト値がSSOのセッション・タイムアウト値より少ない場合、WebCenter HTTPセッションはここで指定された期間の後にタイムアウトとなりますが、SSOがタイムアウトに達していなければ新規WebCenterセッションが自動的に作成されます。

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

48.11 自己登録の有効化

WebCenter Portalシステム管理者は、アプリケーションの自己登録を有効化できます。自己登録により、招待済ユーザーと未招待ユーザーは独自のログインとパスワードを作成できます。自己登録したユーザーはただちに自動的にWebCenter Portalへのアクセス権が付与され、新規ユーザー・アカウントがアイデンティティ・ストアで作成されます。

この項には次の情報が含まれます:

- 第48.11.1項「自己登録について」

- 第48.11.2項「すべてのユーザーの自己登録の有効化」

- 第48.11.3項「招待者限定の自己登録の有効化」

48.11.1 自己登録について

自己登録を使用すると、ユーザーはWebCenter Portalに独自のログインとパスワードを作成できます。自己登録したユーザーはただちに自動的にWebCenter Portalへのアクセス権が付与され、新規ユーザー・アカウントがWebCenter Portalのアイデンティティ・ストアに作成されます。

パブリック・ユーザーに自己登録が許可されている場合、WebCenter Portalログイン・ページに「登録」リンクまたはボタンが表示されます。この機能を有効化するには、第48.11.2項「すべてのユーザーの自己登録の有効化」を参照してください。

招待による自己登録も使用可能です。この機能を使用すると、ポータル・モデレータは現在WebCenter Portalに登録されていないユーザーでポータルに関心を持っている可能性のあるユーザーにメンバーシップの招待状を送信できます。ポータルにアクセスする前に、招待されたユーザーはWebCenter Portalでアカウントを作成する必要があり、そのアカウントの詳細がWebCenter Portalのアイデンティティ・ストアに追加されます。承認が必要な場合、ポータルへアクセスする前にモデレータがサブスクリプション・リクエストを承認する必要があります。ポータルがパブリックである場合やそれ以上の承認が必要でない場合には、新規ユーザーはポータルにただちにアクセスできます。第48.11.3項「招待者限定の自己登録の有効化」も参照してください。

注意:
自己登録がWebCenter Portalで有効化されていない場合、アイデンティティ・ストア管理はWLS管理コンソールにより実行されます(またはLDAPコマンドを使用して、組込みLDAPアイデンティティ・ストアに対して直接実行されます)。これはシステム管理者の職責です。第31.3項「組込みLDAPアイデンティティ・ストアへのユーザーの追加」も参照してください。

自己登録ページは、WebCenter Portalで提供されています。Administratorロールを持つユーザーは、ページに新規コンポーネントを追加し、必要に応じてページ・レイアウトを変更できます。第50章「システム・ページのカスタマイズ」を参照してください。

注意:
プリティURLを使用して自己登録ページにアクセスできますが、この方法でアクセスした場合、ページ上のフィールドはアクティブではありません。登録されていないユーザーがWebCenter Portalサインイン・ページの「登録」リンクをクリックしてページにアクセスした場合にのみ、フィールドがアクティブになります。

WebCenter Portalで提供されている自己登録ページは、すでに使用されている電子メール・アドレスで登録しようとしているユーザーに、ユーザー名リマインダ・メール・メッセージの送信を提案します(図48-25)。

図48-25 すでに登録済の電子メール・アドレス

この機能は、WebCenter Portalでメール・サービスの認証を行う外部アプリケーションに対してパブリック資格証明が定義されている場合にのみ動作します。この機能で問題が発生する場合には、メール・サーバーの接続とそれに関連付けられた外部アプリケーションの接続が適切に構成されており、パブリック資格証明が定義されていることを確認します。第15.4項「メール・サーバーの登録」も参照してください。

- Enterprise Managerを使用したパブリック資格証明の設定に関する詳細は、第23章「外部アプリケーションの管理」の表23-5「外部アプリケーション接続: 共有ユーザー資格証明とパブリック・ユーザー資格証明」を参照してください。

- WLSTを使用したパブリック資格証明の設定に関する詳細は、「Oracle WebLogic Scripting Tool」のaddExtAppCredentialに関する項を参照してください。

48.11.2 すべてのユーザーの自己登録の有効化

パブリック・ユーザーに自己登録が許可されている場合、WebCenter Portalログイン・ページに「登録」リンクまたはボタンが表示されます(図48-26)。

図48-26 「ログイン」ページで使用可能な自己登録

新規ユーザーは、WebCenter Portalへのアクセス権を取得する前にアカウントを作成する必要があります。

自己登録するユーザーはWebCenter Portalのアイデンティティ・ストアに直接追加され、Authenticated-Userロールが割り当てられます。初期状態では、Authenticated-Userロールを持つユーザーは、ホーム・ポータル、作成するページ、およびパブリック・ページにアクセスできます。また、パブリック・ポータルの表示、自己サブスクリプションが許可されている任意のポータルへの参加、独自のポータルの作成も許可されます。自己登録を有効にする場合、要件に完全に適合するようAuthenticated-User権限を変更することを検討してください。第43.4.4.2項「アプリケーション・ロールの権限の変更」を参照してください。

WebCenter Portalで任意のユーザーに自己登録を許可するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「パブリック・ユーザーに自己登録を許可」を選択します(図48-27)。
このオプションを選択解除すると、パブリック・ユーザーはWebCenter Portalで自己登録できません。この場合でも、必要に応じて、招待者限定の自己登録を有効化します。第48.11.3項「招待者限定の自己登録の有効化」を参照してください。

図48-27 パブリック・ユーザーへの自己登録の許可

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

『Oracle WebCenter Portalの使用』のWebCenter Portalでの自己登録に関する項も参照してください。

48.11.3 招待者限定の自己登録の有効化

初期状態では、登録済のWebCenter Portalユーザーのみがポータル・メンバーの候補になります。これが大半のWebCenter Portalユーザーの要件に適合する場合でも、一部のポータルではWebCenter Portalコミュニティ外のメンバーを採用する必要が生じます。

システム管理者は、招待者限定の自己登録を許可することにより、WebCenter Portal外のユーザーにポータル・メンバーシップを供与できます。このオプションが有効になると、ポータル・モデレータはカスタマイズ可能な招待状を電子メールで送信して、任意のユーザーを招待し自分のポータルに参加させることができます。この招待状には、招待された参加者がポータル・メンバーシップを受け入れる際にクリックするセキュアな自己登録URLが含まれます。

この方法で採用された新規メンバーは、ポータルへのアクセス権を取得する前にWebCenter Portalでアカウントを作成する必要があります。招待により自己登録するユーザーは、アイデンティティ・ストアおよびポータルのメンバー・リストに追加されます。

注意:
また、招待により自己登録するユーザーには、デフォルトのアプリケーション・ロール(Authenticated-User)も割り当てられます。初期状態では、Authenticated-Userロールを持つユーザーは、 ホーム・ポータル、作成するページ、およびパブリック・ページにアクセスできます。また、パブリック・ポータルの表示、自己サブスクリプションが許可されている任意のポータルへの参加、独自のポータルの作成も許可されます。自己登録を有効にする場合、要件に完全に適合するようにAuthenticated-User権限を変更することを検討してください。第43.4.4.2項「アプリケーション・ロールの権限の変更」も参照してください。

招待を介してWebCenter Portalで任意のユーザーに自己登録を許可するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「一般」をクリックします。
ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/general

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「招待を介した自己登録の許可」を選択します(図48-28)。
このオプションを選択解除すると、既存のユーザーのみがポータル・メンバーシップの候補となります。

図48-28 招待を介した自己登録の許可

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

このオプションを有効化すると、ポータル・モデレータは任意のユーザーを招待して自分のポータルのメンバーにすることができます。『Oracle WebCenter Portalでのポータルの構築』の非登録ユーザーの招待に関する項を参照してください。

48.12 新しいページのデフォルトのルック・アンド・フィールの選択

管理者は、初めてのユーザーに対するページ作成を簡素化したり、ユーザーを特定のページ・スキームおよびスタイルに誘導するために、システム、ビジネス・ロールおよび個人用ページに対して、デフォルトのルック・アンド・フィールを設定できます。

詳細は、次の各章を参照してください。

- 第50章「システム・ページのカスタマイズ」

- 第51章「ビジネス・ロール・ページの管理」

- 第52章「個人用ページの管理」

ユーザーごとに、ホーム・ポータル・ビューでデフォルト設定をパーソナライズできます。詳細は、第52.2項「個人用ページのためのアプリケーションレベルのページ作成のデフォルトの設定」を参照してください。

48.13 ホーム・ポータルへのアクセスの有効化と無効化

ホーム・ポータルへのアクセスはオプションであり、ユーザーが個人コンテンツを格納して個人タスクを実行するためのプライベートな作業領域を提供することは必須ではありません。ユーザーは、ホーム・ポータルにアクセスしなくても、共同プロジェクトに全面的に参加できます。

ホーム・ポータルへのアクセス権限がないユーザーは、個人の生産性向上ツールの使用(お気に入りなど)、個人用ページの作成、他のユーザーが共有する個人用ページの表示の操作を行うことができません。

Portal Server: View権限により、ユーザーがホーム・ポータルにアクセスできるかどうかを制御します。管理者は、WebCenter Portalを使用して、すべてのユーザーのアクセスまたは特定のユーザーのアクセスのみを無効化できます。異なるロールに対して必要な権限設定を決定するには、表48-1を使用します。

ホーム・ポータルへのアクセスを有効化または無効化するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「セキュリティ」をクリックします。
あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/builder/administration/security

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「ロール」タブで、必要に応じて「ポータル・サーバー」の下にあるロールの「表示」チェック・ボックス(図48-29を参照)を選択または選択解除します(表48-1を参照)。

図48-29 Portal Server: View権限

表48-1 Portal Server: View権限

ロール

Portal Server: Viewを選択

Portal Server: Viewを選択解除

Administrator

このロールを割り当てられたユーザーは常に、ホーム・ポータルにアクセスできます。

管理者の場合は該当なし。

Application Specialist

このロールを割り当てられたユーザーは常に、ホーム・ポータルにアクセスできます。

このロールを割り当てられたユーザーは、ホーム・ポータルにはアクセスできません。(認証されたユーザーおよびパブリック・ユーザーに対して、Portal Server: View権限が無効化されていると仮定します。)

Public User

認証されていないユーザーは、個人用ページおよびパブリックとマークが付けられているコンテンツを表示できます。

認証されていないユーザーは、ログイン・ページのみを表示できます。

認証済ユーザー

すべてのユーザーが、ホーム・ポータルにアクセスできます。

ユーザーは、ホーム・ポータルへのアクセスを許可する別のロールを付与されないかぎり、ホーム・ポータルにはアクセスできません。

Any Custom Role

カスタム・ロールを割り当てられたユーザーは、ホーム・ポータルにアクセスできます。

カスタム・ロールを割り当てられたユーザーは、ホーム・ポータルにはアクセスできません。(認証されたユーザーおよびパブリック・ユーザーに対して、Portal Server: View権限が無効化されていると仮定します。)

3. 「適用」をクリックして、変更を保存します。
新しい権限が即時に有効になります。

48.14 WebCenter Portalツールとサービスのデフォルトの設定

システム管理者は、WebCenter Portalのツールとサービスのオプションを設定することもできます。詳細は、第8章「ツールおよびサービスの管理」を参照してください。

49 ポータル間のセキュリティの管理

この章では、WebCenterポータル・ビルダー管理の「セキュリティ」ページで使用できるタスクについて説明します。システム管理者はデフォルト設定を変更して、組織の要件に合わせることが可能です。

この章には次の項が含まれます:

- 第49.1項「ポータルのセキュリティについて」

- 第49.2項「ユーザーについて」

- 第49.3項「アプリケーション・ロールおよび権限について」

- 第49.4項「ポータル内のロールおよび権限について」

- 第49.5項「ユーザーの管理」

- 第49.6項「アプリケーション・ロールおよび権限の管理」

- 第49.7項「ユーザーおよびロールに関する問題のトラブルシューティング」

権限:
この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server-Manage Configuration

さらに、ポータルの作成および管理の権限(Portals-Create PortalsおよびPortals-Manage Security and Configurationまたはどちらか一方)が必要です。

WebCenter Portal権限の詳細は、第49.3項「アプリケーション・ロールおよび権限について」を参照してください。

ポータルの権限の詳細は、『Oracle WebCenter Portalでのポータルの構築』の「ポータルのロールと権限の管理」を参照してください。

49.1 ポータルのセキュリティについて

WebCenter Portalには包括的なセキュリティ・モデルが用意されており、これによりユーザーに表示される画面を制御し、WebCenter Portal内の変更を実行できます。WebCenterポータル・ビルダー管理の「セキュリティ」ページ(図49-1)を使用して、個々のポータルやホーム・ポータルにアクセスできるユーザー(およびグループ)を制御し、様々な権限を有効化または無効化することでユーザーやグループが表示および実行できる項目を正確に制御できます。

図49-1 「ポータル・ビルダー」の「管理」:「セキュリティ」ページ

特定のポータル内で、個々のページ、ページ・コンテンツ(タスク・フロー、ポートレット、ドキュメント、フォルダなど)、およびリソース(ページ・テンプレート、ページ・スタイル、スキン、リソース・カタログなど)へのユーザーおよびグループのアクセスを制限できます。

図49-2 WebCenter Portalのセキュリティ

ユーザーとグループ

ユーザーとはアイデンティティ・ストア内の1人の個人を意味し、グループには複数のユーザーが含まれます。WebCenter Portalでは、権限を個々のユーザーおよびユーザーのグループに付与できます。

未登録のユーザーおよび自己登録

自己登録を使用すると、未登録のユーザーはWebCenter Portalに独自のログインとパスワードを作成できます。自己登録したユーザーはただちに自動的にWebCenter Portalへのアクセス権が付与され、新規ユーザー・アカウントがWebCenter Portalのアイデンティティ・ストアに作成されます。

アプリケーション・ロールおよびポータル・ロール

アプリケーション・ロールは、一部の管理機能に対して、WebCenter Portal全体に影響を及ぼす可能性のあるホーム・ポータルでのユーザー(またはグループ)の画面表示および実行内容を決定します。ポータル・ロールは特定のポータル内のアクションを制御します。

ポータルおよびポータル階層

ポータルでは、関連のあるサービス、ページおよびコンテンツに対して専用のアクセス可能な領域を提供したり、指定されたメンバーの加入をサポートすることにより、プロジェクト・チームや関心のあるコミュニティの形成とコラボレーションがサポートされます。

ポータル階層は、1つ以上のサブポータルを持つ親ポータルで構成されています。サブポータルは、その親のセキュリティ(メンバー、ロールおよび権限)を継承できます。

ホーム・ポータル

デフォルトでは、ホーム・ポータルは共有ポータルで、ログインしているすべてのユーザーがアクセスできます。ユーザーがホーム・ポータル内で作業している間は、アプリケーション・ロールが適用されます。大部分のアプリケーションでは、ホーム・ポータルは、ソーシャル・ネットワーキングと個人コンテンツに重点を置いています。

リソース (アセット)

様々なポータル・リソース(アセット)が、ポータル全体の構造、ルック・アンド・フィールおよびコンテンツの定義に役立ちます。そのようなリソースには、ページ・テンプレート、ページ・スタイル、スキン、ナビゲーション・モデル、リソース・カタログ、コンテンツ・プレゼンタ表示テンプレート、タスク・フロー・スタイル、データ・コントロールおよびタスク・フローがあります。ユーザーに適切な権限があれば、アプリケーション全体、単一のポータルまたはポータル階層のリソース(アセット)を構築してカスタマイズできます。

ページ

ページを編集する権限のあるすべてのユーザーは、他のユーザーやグループにアクセス権などの権限を付与できます。たとえば、セールス・グループのすべてのユーザーに対する表示のみの権限の付与、セールス・マネージャに対する権限の編集、単一ユーザーに対する権限の管理を実行できます。または、ページに対してアプリケーションからのアクセス権の継承を指定できます。

ページ・コンテンツ、ファイル、およびフォルダ

一部のページに含まれるコンテンツを、選択した一連のユーザーのみに表示したり、他の1人のユーザーのみに表示したりすることができます。たとえば、セールス担当者を対象としたページに、2つの「お知らせ」タスク・フロー(1つはすべてのセールス担当者が対象、もう1つはセールス・マネージャのみが対象)を含めることができます。2つ目の「お知らせ」タスク・フローへのアクセスを制限することで、管理レベルのお知らせをセールス・マネージャ以外のすべてのユーザーに対して非表示にできます。

49.2 ユーザーについて

WebCenter Portalのユーザーには、既存のアイデンティティ・ストアから直接プロビジョニングされたWebCenter Portalのログイン・アカウントがあります。詳細は、第31.3項「組込みLDAPアイデンティティ・ストアへのユーザーの追加」を参照してください。

アイデンティティ・ストアのすべてのユーザーには、Authenticated-UserロールによりWebCenter Portalの最小限の権限が割り当てられます。唯一の例外はシステム管理者(デフォルトではweblogic)です。初期設定では、システム管理者はAdministratorロールにより完全な管理権限を割り当てられた唯一のユーザーです。詳細は、次の項の第49.3.1.1項「デフォルトのアプリケーション・ロール」を参照してください。

各ユーザーに適切なアプリケーション・ロールを割り当てるのは、システム管理者の仕事です。または、システム管理者は他のユーザーにAdministratorロールを割り当てることを選択し、この職務を委任することもできます。

表49-1 WebCenter Portalのデフォルトの管理者

ユーザー

説明

システム管理者(weblogic)

アプリケーション・サーバー全体の管理者は、スーパー管理者またはFusion Middleware管理者と呼ばれることがあります。このユーザーは、WebCenter Portalなどサーバー上のすべてのアプリケーションを管理できます。

49.3 アプリケーション・ロールおよび権限について

アプリケーション・ロールは、WebCenter Portal内の情報とサービスへのユーザーのアクセス・レベルを制御します。特に、アプリケーション・ロールとその権限により、ユーザーのホーム・ポータルでの表示と実行可能な操作が決定されます。

この項の内容は次のとおりです。

第49.3.1項「アプリケーション・ロールについて」

第49.3.2項「アプリケーションの権限について」

49.3.1 アプリケーション・ロールについて

アプリケーション・ロールの割当ては、WebCenter Portal管理者の職責です。管理者は、ユーザーにデフォルトのアプリケーション・ロールを割り当てるか、WebCenter Portalのデプロイメントに固有の追加のカスタム・ロールを作成できます。詳細は、次を参照してください。

- 第49.3.1.1項「デフォルトのアプリケーション・ロール」

- 第49.3.1.2項「カスタム・アプリケーション・ロール」

ユーザーがホーム・ポータル内で作業している間は、アプリケーション・ロールが適用されます。ユーザーが特定のポータル内で作業している場合は、別のロールと権限のセットが適用されます。各メンバーに対して適切なロール割当てを決定するのは、ポータル・モデレータの職責です。詳細は、『Oracle WebCenter Portalでのポータルの構築』の第49.6項「アプリケーション・ロールおよび権限の管理」およびポータルのセキュリティの管理に関する章を参照してください。

注意:
WebCenter Portal内で定義されたアプリケーション・ロールと権限は、ポリシー・ストアに保存されるため、このWebCenter Portalにのみ適用されます。エンタープライズ・ロールはこれとは異なり、アプリケーションのアイデンティティ・ストアに格納されるため、そのWebCenter Portal内の権限には関与しません。第30.2.2項「アプリケーション・ロールとエンタープライズ・ロール」を参照してください。

49.3.1.1 デフォルトのアプリケーション・ロール

WebCenter Portalには、複数のデフォルトのアプリケーション・ロールが用意されています(表49-2)。Administrator、Public-UserおよびAuthenticated Userのデフォルトのアプリケーション・ロールは削除できませんが、各ロールのデフォルトの権限割当てを変更できます。詳細は、第49.6.2項「アプリケーション・ロールの権限の変更」を参照してください。

表49-2 WebCenter Portalのデフォルトのアプリケーション・ロール

アプリケーション・ロール

説明

変更の可否

管理者

Administratorロールを持つユーザーは、WebCenter Portalのアプリケーション全体のプロパティの設定、ビジネス・ロール・ページの作成、ディスカッション・フォーラム、メールおよびピープル・コネクション・サービスのデフォルト設定の構成、プロデューサと外部アプリケーションの登録、およびその他の管理作業(ログイン・ページや自己登録ページの編集など)を実行できます。

また管理者は、WebCenter Portalのユーザーおよびロールの管理、他のユーザーに対する権限の委任や取消し、ポータルおよびポータル・テンプレートの管理、さらにポータル情報のインポートおよびエクスポートを実行できます。

初期設定では、システム管理者はAdministratorロールによりWebCenter Portalの完全な管理権限を割り当てられた唯一のユーザーです。

可*

*読取り専用のアプリケーション権限を除く

アプリケーション・スペシャリスト

Application Specialistロールを持つユーザーは、ポータルの作成、ポータル・テンプレートの管理、ページ、ページ・スタイル、ページ・テンプレート、コンテンツ・プレゼンタ・テンプレート、データ・コントロール、ナビゲーション、ページレット、リソース・カタログ、スキン、タスク・フロー・スタイルおよびタスク・フローの作成、編集、削除、ピープル・コネクション・データの更新およびユーザーとの接続を実行できます。

はい

認証されたユーザー

WebCenter Portalの認証されたユーザーには、Authenticated-Userロールが付与されます。ログインするユーザーにはこのロールが割り当てられ、デフォルトではホーム・ポータル、自分が作成したページおよびパブリック・ページにアクセスできます。またこれらのユーザーは、パブリック・ポータルの表示、ポータルの作成およびポータル・テンプレートの作成を実行できます。

このロールは、Public-Userロールから権限を継承します。

WebCenter Portalでは、Authenticated-Userロールは標準OPSS (Oracle Platform Security Services)ロールのauthenticated-roleと同じです。

はい

パブリック・ユーザー

ログインせずにWebCenter Portalにアクセスする任意のユーザーには、Public-Userロールが付与されます。これらは匿名の識別できないユーザーであり、パブリック・コンテンツのみを参照できます。

WebCenter Portalでは、Public-Userロールは標準OPSS (Oracle Platform Security Services)ロールのanonymous-roleと同じです。

はい

49.3.1.2 カスタム・アプリケーション・ロール

カスタム・アプリケーション・ロール(ユーザー定義ロールとも呼ばれます)は、使用するWebCenter Portalに固有のロールです。WebCenter Portalを設定する際には、必要なアプリケーション・ロールの特定、適切なロール名の選択、各ロールの職責の定義はWebCenter Portalの管理者が実行します。

たとえば、教育環境では、先生、生徒、来賓などのロールが必要になります。一方、企業環境では、経理、営業、人事、サポートなどが適切なロールとなります。

WebCenter Portalでは、カスタム・アプリケーション・ロールはAuthenticated-Userロールから権限を継承します。

WebCenter Portalユーザーのアプリケーション・ロールの設定方法は、第49.6.1項「アプリケーション・ロールの定義」を参照してください。

49.3.2 アプリケーションの権限について

すべてのアプリケーション・ロールには、権限と呼ばれる特定の定義済の権利があります。これらの権限により、各ユーザーは、ホーム・ポータル内で特定のアクションを実行できます。権限には、次のようなカテゴリがあります。後続の表に各カテゴリのリストを示します。

- ポータル・サーバー

- ポータル

- ポータル・テンプレート

- ページ

- コンテンツ・プレゼンタ・テンプレート

- データ・コントロール

- ディスカッション

- リンク

- ナビゲーション

- ページ・スタイル

- ページ・テンプレート

- ページレット

- ピープル・コネクション

- リソース・カタログ

- スキン

- タスク・フロー・スタイル

- タスク・フロー

Manage Allを除くすべての権限は、他の権限からその内容を継承しません。

表49-3 WebCenter Portalのアプリケーションの権限

カテゴリ

アプリケーション権限

ポータル・サーバー

すべて管理: すべてのWebCenter Portal管理ページ(「ポータル」、「管理」、「共有アセット」、「属性」「ポータル・テンプレート」および「プリファレンス」)にアクセスできます。これらのページにより、ユーザーは、アプリケーション・セキュリティ(ユーザー/ロール)の管理、アプリケーション全体のプロパティとサービスの構成、リソースの管理、ビジネス・ロール・ページの作成、すべてのユーザーの個人用ページの管理、システム・ページのカスタマイズ、すべてのユーザーにアクセスできるポータルの表示、ポータルとポータル・テンプレートのエクスポート/インポートを実行できます。

一部の管理タスクが初期設定のAdministratorロールにのみ許可され、ポータル-セキュリティと構成の管理権限を付与して実行できません。それらのタスクには、ログイン・ページ、自己登録ページおよびプロファイル・ギャラリ・ページの編集、およびすべてのポータル、すべてのポータル・テンプレート、外部アプリケーション、およびポートレット・プロデューサを管理する機能が含まれます。

構成の管理: セキュリティ権限以外はPortal Server-Manage All権限と同じです。この権限を持つユーザーは「管理」: 「セキュリティ」ページにアクセスできません。

表示: ユーザーはWebCenter Portalを表示でき、ホーム・ポータルへのアクセス権が付与されます。詳細は、第49.6.3項「パブリック・ユーザーへの権限の付与」および第49.6.4項「認証されたユーザーへの権限の付与」を参照してください。

ポータル

セキュリティと構成の管理: 「ページ」と「アセット」を除くすべてのポータル管理ページ(「概要」、「設定」、「属性」、「セキュリティ」、「ツールとサービス」、「サブポータル」、「システム・ページ」)へのアクセスが有効です。これらのページを使用すると、ユーザーは、ポータル・メンバーシップの管理、権限とロールの割当て、ポータルとリソースの管理、削除、エクスポート、ポータル・プロパティの設定およびサービスの可用性の管理を実行できます。

- ポータル・ページにアクセスするには、pageおよびasset権限を持っている必要があります。

- ポータル・アセットにアクセスするには、asset権限を持っている必要があります。

Manage Configuration権限とManage Membership権限を含みます。

構成の管理: セキュリティ権限以外はセキュリティと構成の管理権限と同じです。この権限を持つユーザーでポータル・マネージャでない場合、「セキュリティ」ページにアクセスできません。この権限を持つユーザーは、「ロール」ページと「メンバー」ページにはアクセスできません。

- ポータル・ページにアクセスするには、pageおよびasset権限を持っている必要があります。

- ポータル・アセットにアクセスするには、asset権限を持っている必要があります。

この権限を持つユーザーは、必ずポータルの表示が許可されます。

Manage Membership (メンバーシップの管理) - ポータルの管理設定で、「ロール」ページと「メンバー」ページにアクセスできます。これらのページを通じて、ユーザーはポータルのメンバーやロールを作成、編集および削除できます。

ポータルの作成: ユーザーはポータルを作成できます。

ポータル・テンプレート

すべて管理: ユーザーは、すべてのポータル・テンプレートの管理(「ポータル・テンプレート」ページで)およびアクセス可能なテンプレートの削除を実行できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のすべてのポータル・テンプレートの管理に関する項を参照してください。

ポータル・テンプレートの作成: ユーザーはポータル・テンプレートを作成できます。

ページ

ページの作成、編集および削除: ユーザーは自分のホーム・ポータルのページを作成、編集および削除できます。

ページの削除: ユーザーは自分のホーム・ポータルのページを削除できます。

ページの編集: ユーザーは個人用ページ・コンテンツの追加または編集、コンテンツの再配置、およびページのパラメータとプロパティの設定が可能です。

ページのカスタマイズ: ユーザーは、コンテンツを追加、編集または削除することで、ホーム・ポータルのページの表示をカスタマイズできます。

ページの表示: ユーザーはホーム・ポータルのページを表示できます。

ページの作成: ユーザーはホーム・ポータルの新しいページを作成または設計できます。

これらの権限は、ホーム・ポータルにのみ適用されます。これらの権限は、ポータル内に作成したページには適用されません。ポータル内のページ権限は、ポータル・モデレータによりポータルごとに付与されます。詳細は、『Oracle WebCenter Portalでのポータルの構築』の「ポータルのロールと権限の管理」を参照してください。

コンテンツ・プレゼンタ・テンプレート

コンテンツ・プレゼンタ・テンプレートの作成、編集および削除: ユーザーは、ポータル・ビルダーを使用してアプリケーションのコンテンツ表示テンプレートを作成、編集および削除できます。

コンテンツ・プレゼンタ・テンプレートの作成: ユーザーはアプリケーションのコンテンツ表示テンプレートを作成できます。

コンテンツ・プレゼンタ・テンプレートの編集: ユーザーはアプリケーションレベルのコンテンツ表示テンプレートを編集できます。

詳細は、『Oracle WebCenter Portalでのポータルの構築』の「コンテンツ・プレゼンタを使用したコンテンツの公開」を参照してください。

データ・コントロール

データ・コントロールの作成、編集および削除: ユーザーは、ポータル・ビルダーを使用してアプリケーションのデータ・コントロールを作成、編集および削除できます。

データ・コントロールの作成: ユーザーはアプリケーションのデータ・コントロールを作成できます。

データ・コントロールの編集: ユーザーはアプリケーションレベルのデータ・コントロールを編集できます。

詳細は、『Oracle WebCenter Portalでのポータルの構築』のデータ・コントロールでの作業に関する章を参照してください。

ディスカッション

ディスカッションの作成、編集および削除: ユーザーは、バックエンドのディスカッション・サーバー上のカテゴリ、フォーラムおよびトピックの管理、およびすべてのポータルのディスカッション・フォーラム・プロパティの設定を実行できます。

詳細は、第49.3.2.2項「ディスカッション・サーバーのロール・マッピングの理解」を参照してください。

リンク

リンクの作成と削除: ユーザーは、オブジェクト間のリンクの作成と削除、およびリンクの権限の管理を実行できます。

リンクの作成: ユーザーは、オブジェクト間のリンクの作成および作成したリンクの削除を実行できます。

リンクの削除: ユーザーは2つのオブジェクト間のリンクを削除できます。

ナビゲーション

ナビゲーションの作成、編集および削除: ユーザーは、ポータル・ビルダーを使用してアプリケーションのナビゲーションを作成、編集および削除できます。

ナビゲーションの作成: ユーザーはアプリケーションのナビゲーションを作成できます。

ナビゲーションの編集: ユーザーはアプリケーションレベルのナビゲーションを編集できます。

詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル・ナビゲーションの使用に関する章を参照してください。

ページ・スタイル

ページ・スタイルの作成、編集および削除: ユーザーはポータル・ビルダーを使用して、ページ・スタイルを作成、編集および削除できます。

ページ・スタイルの作成: ユーザーはアプリケーションのページ・スタイルを作成できます。

ページ・スタイルの編集: ユーザーはアプリケーションレベルのページ・スタイルを編集できます。

詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・スタイルの使用に関する項を参照してください。

ページ・テンプレート

ページ・テンプレートの作成、編集および削除: ユーザーはポータル・ビルダーを使用して、ページ・テンプレートを作成、編集および削除できます。

ページ・テンプレートの作成: ユーザーはアプリケーションのページ・テンプレートを作成できます。

ページ・テンプレートの編集: ユーザーはアプリケーションレベルのページ・テンプレートを編集できます。

詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・テンプレートでの作業に関する章を参照してください。

ページレット

ページレットの作成、編集、および削除: ユーザーはポータル・ビルダーを使用して、ページレットを作成、編集および削除できます。

ページレットの作成: ユーザーはアプリケーションのページレットを作成できます。

ページレットの編集: ユーザーはアプリケーションレベルのページレットを編集できます。

詳細は、『Oracle WebCenter Portalでのポータルの構築』のページレットの使用の章を参照してください。

ピープル・コネクション

ピープル・コネクションの管理: ユーザーはピープル・コネクション・サービスのアプリケーション全体の設定を管理できます。

ピープル・コネクション・データの更新: ユーザーはピープル・コネクション・サービスに関連付けられたコンテンツを編集できます。

人とのコネクション: ユーザーはピープル・コネクション・サービスに関連付けられたコンテンツを他のユーザーと共有できます。

リソース・カタログ

リソース・カタログの作成、編集および削除: ユーザーは、ポータル・ビルダーを使用してアプリケーションのリソース・カタログを作成、編集および削除できます。

リソース・カタログの作成: ユーザーはアプリケーションのリソース・カタログを作成できます。

リソース・カタログの編集: ユーザーはアプリケーションレベルのリソース・カタログを編集できます。

詳細は、『Oracle WebCenter Portalでのポータルの構築』の「リソース・カタログでの作業」を参照してください。

スキン

スキンの作成、編集および削除: ユーザーはポータル・ビルダーを使用してスキンを作成、編集および削除できます。

スキンの作成: ユーザーはアプリケーションのスキンを作成できます。

スキンの編集: ユーザーはアプリケーションレベルのスキンを編集できます。

詳細は、『Oracle WebCenter Portalでのポータルの構築』の「スキンでの作業」を参照してください。

タスク・フロー・スタイル

タスク・フロー・スタイルの作成、編集および削除: ユーザーは、ポータル・ビルダーを使用してアプリケーションのコンテンツ表示テンプレートを作成、編集および削除できます。

タスク・フロー・スタイルの作成: ユーザーはアプリケーションのコンテンツ表示テンプレートを作成できます。

タスク・フロー・スタイルの編集: ユーザーはアプリケーションレベルのコンテンツ表示テンプレートを編集できます。

詳細は、『Oracle WebCenter Portalでのポータルの構築』の「コンテンツ・プレゼンタを使用したコンテンツの公開」を参照してください。

タスク・フロー

タスク・フローの作成、編集および削除: ユーザーはポータル・ビルダーにより、タスク・フロー・スタイルに基づいてタスク・フローを作成、編集および削除できます。

タスク・フローの作成: ユーザーはアプリケーションのタスク・フローを作成できます。

タスク・フローの編集: ユーザーはアプリケーションレベルのタスク・フローを編集できます。

詳細は、『Oracle WebCenter Portalでのポータルの構築』のタスク・フローの使用に関する章を参照してください。

49.3.2.1 デフォルトの権限の理解

表49-4は、初期設定のアプリケーション・ロールに割り当てられたデフォルトの権限を示しています。

✔: 明示的に付与されている権限やアクションを示します。

✙: 明示的に権限が付与されている場合の暗黙的な権限を示します。

表49-4 WebCenter Portalのデフォルトのアプリケーション・ロールと権限

デフォルトのアプリケーション・ロール

権限

管理者

アプリケーション・スペシャリスト

認証されたユーザー

パブリック・ユーザー

ポータル・サーバー

すべて管理

✔

構成の管理

✙

表示

✙

✔

✔

✔

ポータル

セキュリティと構成の管理

✔

構成の管理

メンバーシップの管理

ポータルの作成

✔

✔

ポータル・テンプレート

すべて管理

✔

✔

ポータル・テンプレートの作成

✔

ページ

作成、編集および削除

✔

✔

削除

編集

カスタマイズ

表示

作成

✔

コンテンツ・プレゼンタ・テンプレート

作成、編集および削除

✔

✔

作成

編集

データ・コントロール

作成、編集および削除

✔

✔

作成

編集

ディスカッション

作成、編集および削除

✔

リンク

作成と削除

✔

作成

削除

タスク・フロー・スタイル

作成、編集および削除

✔

✔

作成

編集

ナビゲーション

作成、編集および削除

✔

✔

作成

編集

ページ・スタイル

作成、編集および削除

✔

✔

作成

編集

ページ・テンプレート

作成、編集および削除

✔

✔

作成

編集

ページレット

作成、編集および削除

✔

✔

作成

編集

ピープル・コネクション

ピープル・コネクションの管理

✔

ピープル・コネクション・データの更新

✔

✔

人とのコネクション

✔

✔

リソース・カタログ

作成、編集および削除

✔

✔

作成

編集

スキン

作成、編集および削除

✔

✔

作成

編集

タスク・フロー

作成、編集および削除

✔

✔

作成

編集

49.3.2.2 ディスカッション・サーバーのロール・マッピングの理解

リモート(バックエンド)のリソースにアクセスする必要のある一部のWebCenter Portalサービスは、ロールマッピング・ベースの認可も必要です。つまり、WebCenter Portal内でユーザーが「ディスカッション」サービスと連携できるWebCenter Portalのロールを、WebCenter Portalのディスカッション・サーバー上の対応するロールにマップする必要があります。

WebCenter Portalでは、アプリケーション・ロールを使用してホーム・ポータル内のユーザー権限を管理し、ポータル・ロールを使用して特定のポータル内のユーザー権限を管理します。WebCenter Portalのディスカッション・サーバーでは、ロールと権限の異なるセットが適用されます。

WebCenter Portalのディスカッションおよびお知らせを使用しているユーザーは、自動的に適切なディスカッション・サーバー・ロールにマップされます。詳細は、表49-5および表49-6を参照してください。

表49-5 ディスカッション・サーバーのロールと権限: アプリケーション

ディスカッション・サーバーのロール

ディスカッション・サーバーの権限

WebCenter Portal
同等のアプリケーション権限

管理者

Category Admin

Discussions-Create, Edit, and Delete

権限が付与されたカテゴリ内のサブ・カテゴリ、フォーラムおよびトピックの作成、読取り、更新および削除。

表49-6 ディスカッション・サーバーのロールと権限: ポータル用

ディスカッション・サーバーのロール

ディスカッション・サーバーの権限

WebCenter Portal
ポータル内の同等の権限

モデレータ

Category Admin

Forum Admin

- Discussions-Create, Edit, and Delete
フォーラムおよびトピックの作成、読取り、更新および削除。

- Announcements-Create, Edit, and Delete
お知らせの作成、読取り、更新および削除。

Create Message

Create Announcement

- Discussions-Create and Edit
トピックの作成および編集。

- Announcements-Create and Edit
お知らせの作成および編集。

Read Forum

Create Thread

- Discussions-Reply To
ディスカッション・トピックへの返信。

Read Forum

- Discussions-View
フォーラムおよびトピックの表示。

- Announcements-View
お知らせの表示。

WebCenter PortalでApplication-Discussions-Create Edit Delete権限を割り当てられたすべてのユーザーは、WebCenter Portalのディスカッション・サーバーに自動的に追加され、Category Admin権限を持つAdministratorロールを割り当てられます。初期設定のWebCenter Portalでは、Application-Discussions-Create Edit Delete権限はAdministratorロールにのみ割り当てられています。

同様に指定されたポータルで、ディスカッションおよびお知らせ権限を割り当てられたすべてのメンバーは、ディスカッション・サーバーの対応する権限を割り当てられます。

49.3.2.3 エンタープライズ・グループのロール・マッピングの理解

WebCenter Portalでは、同じエンタープライズ・グループに属する個々のユーザーまたは複数のユーザーを、WebCenter Portalロールに割り当てることができます。バックエンドのアイデンティティ・ストアにおける、それ以降のエンタープライズ・グループの更新内容は、自動的にWebCenter Portalに反映されます。まず、エンタープライズ・グループにWebCenter Portalロールを割り当てると、そのエンタープライズ・グループに属するすべてのユーザーに同じロールが付与されます。ユーザーがグループから抜けると、ロールが取り消されます。ユーザーがグループに入ると、ロールが付与されます。

WebCenter Portalで、エンタープライズのグループからロールへのマッピングを正しくメンテナンスするには、ディスカッション・サーバーやコンテンツ・サーバーなどのバックエンド・サーバーでもエンタープライズ・グループがサポートされている必要があります。このリリースで提供されるWebCenter Portalディスカッション・サーバーとWebCenter Contentコンテンツ・サーバーのバージョンでは、エンタープライズ・グループがサポートされますが、以前のバージョンではサポートされない場合があります。詳細は、第49.7項「ユーザーおよびロールに関する問題のトラブルシューティング」を参照してください。

49.4 ポータル内のロールおよび権限について

ユーザーが特定のポータルのメンバーになると、異なるセットのロールと職責が適用されます。詳細は、『Oracle WebCenter Portalでのポータルの構築』の「ポータルのセキュリティの管理」を参照してください。

49.5 ユーザーの管理

管理者は、すべてのWebCenter Portalユーザーに適切な権限を割り当てる必要があります。ユーザーが権限を取得するには、適切なアプリケーション・ロールに割り当てられている必要があります。

「ユーザーとグループ」ページ(図49-3)から、管理者はWebCenter Portalへのアクセス権を持つすべてのユーザー(アイデンティティ・ストアで定義されたすべてのユーザー)のアプリケーション・ロールを管理できます。ここから、ユーザー・ロールの割当ての変更、管理権限の付与およびユーザー権限の取消しを実行できます。「ユーザーとグループ」ページにアクセスするには、ポータル・ビルダー管理を開いて、「セキュリティ」をクリックします。詳細は、第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照してください。

特別な(デフォルトではない)アプリケーション権限を付与されたユーザーのみが、この表に記載されます。最初は、WebCenter Portalのアイデンティティ・ストア内のすべてのユーザーに、Authenticated-Userロールにより最小限の権限が割り当てられます。デフォルトのAuthenticated-Userロールを持つユーザーは、このリストには記載されません。第49.3.1.1項「デフォルトのアプリケーション・ロール」も参照してください。

図49-3 WebCenter Portal管理: 「ユーザーとグループ」ページ

この項では、ロールの割当て方法について説明します。この項の内容は次のとおりです。

- 第49.5.1項「ユーザー(およびグループ)へのロールの割当て」

- 第49.5.2項「ユーザーへの異なるロールの割当て」

- 第49.5.3項「ユーザーへの管理権限の付与」

- 第49.5.4項「アプリケーション・ロールの取消し」

- 第49.5.5項「ユーザーの追加または削除」

49.5.1 ユーザー(およびグループ)へのロールの割当て

最初は、WebCenter Portalのアイデンティティ・ストア内のすべてのユーザーに、Authenticated-Userロールにより最小限の権限が割り当てられます。個々のユーザー(または同じエンタープライズ・グループに属する複数のユーザー)に、WebCenterポータル管理を使用して異なるアプリケーション・ロールを割り当てることができます。

新規ユーザーやエンタープライズ・グループから除外されたユーザーなど、バックエンド・アイデンティティ・ストアの更新内容は、自動的にWebCenter Portalに反映されます。まず、エンタープライズ・グループにWebCenter Portalロールを割り当てると、そのエンタープライズ・グループに属するすべてのユーザーに同じロールが付与されます。ユーザーがグループから抜けると、ロールが取り消されます。ユーザーがグループに入ると、ロールが付与されます。

注意:
WebCenter Portalで、エンタープライズのグループからロールへのマッピングを正しくメンテナンスするには、ディスカッション・サーバーやコンテンツ・サーバーなどのバックエンド・サーバーでもエンタープライズ・グループがサポートされている必要があります。バックエンド・サーバーがエンタープライズ・グループをサポートしていない場合には、「Group [name] not found in the Identity Store」というメッセージが表示されます。第49.7項「ユーザーおよびロールに関する問題のトラブルシューティング」も参照してください。

ユーザー(またはユーザーのグループ)に異なるアプリケーション・ロールを割り当てるには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「セキュリティ」をクリックします。
あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/builder/administration/security

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「ユーザーとグループ」をクリックします(図49-3)。
このページには、追加ロールが定義されているユーザーのリストが記載されています。

3. ドロップダウン・リストから「ユーザー」または「グループ」を選択します。
「ユーザー」を選択して、アイデンティティ・ストアで定義された1人または複数のユーザーに権限を付与します。「グループ」を選択して、ユーザー・グループに権限を付与します。

4. ユーザーまたはグループの正確な名前がわかる場合には、テキスト・ボックスに名前を入力します。複数の名前はカンマで区切ります。
正確な名前がわからない場合、アイデンティティ・ストアを検索できます。

1. 「検索」アイコンをクリックします()。
「ユーザーの検索」(または「グループの検索」)ダイアログが開きます(図49-4)。

図49-4 アイデンティティ・ストアのユーザーおよびグループの検索

2. ユーザーまたはグループの検索語を入力して、「検索」アイコンをクリックします。
アイデンティティ・ストアのユーザーまたはグループの検索のヒントは、『Oracle WebCenter Portalでのポータルの構築』のアイデンティティ・ストアでのユーザーまたはグループの検索に関する項を参照してください。

検索基準に一致するユーザー(またはグループ)が、「ユーザーの選択」ダイアログ・ボックスに表示されます。検索するフィールドの詳細は、『Oracle WebCenter Portalでのポータルの構築』のアイデンティティ・ストアでのユーザーまたはグループの検索に関する項を参照してください。

ヒント:

- *salesのように、*をワイルドカードとして使用します。

- アイデンティティ・ストアにあるすべてのユーザー(またはグループ)のリストを表示するには、検索フィールドを空白のままにします。

- 名と姓で検索するには、2つの検索語の間にスペースを入力します。たとえば、名がjoで姓のsmの場合、jo smのようにします。

3. リストから1つ以上の名前を選択します。
複数のユーザーまたはグループにロールを割り当てるには、すべての必要な名前を複数選択します。[Ctrl]キーを押しながら行をクリックして、複数の名前を選択します。

4. 「OK」をクリックします。
選択した名前は「ユーザーとグループ」タブに表示されます。

5. ロールを割り当てるには、ドロップダウン・リストから「ロール」を選択します。
選択したユーザー(またはグループ)に対して適切なロールを選択します。WebCenter Portalの完全な管理権限を割り当てる場合にのみ、「管理者」を選択します。

必要なロールがリストにない場合は、要件を満たす新規ロールを作成します(第49.6.1項「アプリケーション・ロールの定義」を参照)。

ロールが1つも選択されていない場合、ユーザーはAuthenticated-Userロールを引き受けます。第49.3.1.1項「デフォルトのアプリケーション・ロール」を参照してください。

6. 「アクセス権の付与」をクリックします。
ユーザー/ユーザー・グループの名前と新規ロールの割当てが、表に表示されます。

注意:
グループ名はクリック可能で、クリックによりドリルダウンして、現在のグループ・メンバーのユーザー名を確認できます。
メンバーのリストは、Oracle Entitlements Server (OES)ロールに基づいた動的グループには表示されません。これは、OESロールが動的属性に基づいているため、静的メンバーが含まれていないことによります。第31.8項「WebCenter Portalの動的グループの構成」も参照してください。

49.5.2 ユーザーへの異なるロールの割当て

WebCenter Portalのユーザー・ロールは、変更されることがあります。たとえば、ユーザーが営業から経理部門に異動になった場合、ユーザーのロール割当ては「営業」から「経理」に変更されます。

注意:
自分のロールまたはシステム管理者のロールは、変更できません。第49.3.1項「アプリケーション・ロールについて」を参照してください。

ユーザーに異なるロールを割り当てるには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「セキュリティ」をクリックします。
あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/builder/administration/security

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「ユーザーとグループ」をクリックします(図49-3)。

3. 「既存の付与の管理」表で、目的のユーザーまで下へスクロールします。
デフォルト以外のロールを割り当てられたユーザーのみが、表に表示されます。目的のユーザーがリストにない場合、第49.5.1項「ユーザー(およびグループ)へのロールの割当て」に説明されているように、必要なロールを付与します。

4. 「アクション」アイコンをクリックし、ドロップダウン・リストから「ロールの変更」を選択します。
「ロールの変更」ダイアログ・ボックスが開きます(図49-5)。

図49-5 ユーザーのアプリケーション・ロールの変更

5. 次のようにロールを選択します。

- WebCenter Portalの完全な管理権限を割り当てる際には、「管理者」を選択します。

- 使用可能リストから1つ以上の名前を選択します。
必要なロールがリストにない場合は、要件を満たす新規ロールを作成します(第49.6.1項「アプリケーション・ロールの定義」を参照)。

少なくとも1つのロールを選択する必要があります。すべてのロールの割当てを取り消して、ユーザー権限をデフォルトのAuthenticated-Userロールに戻すには、第49.5.4項「アプリケーション・ロールの取消し」を参照してください。

6. 「OK」をクリックします。
新規ロール割当てが、表に表示されます。

49.5.3 ユーザーへの管理権限の付与

Administratorロールを使用して、WebCenter Portalの完全な管理権限をユーザーに付与するのは簡単です。管理者は最高レベルの権限を持ち、WebCenter Portalのすべてを表示および変更できるため、Administratorロールの割当ては慎重に行います。

一部の管理タスクがAdministratorロールにのみ許可され、ポータル-セキュリティと構成の管理権限を付与して実行できません。それらのタスクには、ログイン・ページ、自己登録ページおよびプロファイル・ギャラリ・ページの編集が含まれます。第49.3.1.1項「デフォルトのアプリケーション・ロール」も参照してください。

ユーザーに管理権限を付与する手順は、次のとおりです。

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「セキュリティ」をクリックします。
あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/builder/administration/security

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「ユーザーとグループ」をクリックします(図49-3)。
「ロール」列には、Administratorロールによる完全な管理権限がすでに割り当てられているユーザーが示されています。

3. 「既存の付与の管理」表で、目的のユーザーまで下へスクロールします。
デフォルト以外のロールを割り当てられたユーザーのみが、表に表示されます。目的のユーザーがリストにない場合、第49.5.1項「ユーザー(およびグループ)へのロールの割当て」の手順に従って、Administratorロールを付与します。

4. 「アクション」アイコンをクリックし、ドロップダウン・リストから「ロールの変更」を選択します。
「ロールの変更」ダイアログ・ボックスが開きます(図49-5)。

5. WebCenter Portalの完全な管理権限を割り当てる際には、「管理者」を選択します。

6. 「OK」をクリックします。
新規のロール割当てが、表に表示されます。

49.5.4 アプリケーション・ロールの取消し

適用することがなくなったアプリケーション・ロール割当てを取り消すのは簡単です。個々にロールを取り消すか、特定のユーザーに割り当てられたすべてのアプリケーション・ロールを一度に取り消します。

ユーザーのアプリケーション・ロールをすべて取り消した場合でも、そのユーザーはアイデンティティ・ストアから削除されず、引き続きデフォルトのAuthenticated-Userロールを使用してWebCenter Portalにアクセスできます。

注意:
自分のロール割当てまたはシステム管理者のロールを取り消すことはできません。第49.3.1項「アプリケーション・ロールについて」を参照してください。

アプリケーション・ロールを取り消す手順は、次のとおりです。

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「セキュリティ」をクリックします。
あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/builder/administration/security

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「ユーザーとグループ」をクリックします(図49-3)。
このページには、追加ロールが定義されているユーザーのリストが記載されています。

3. 「既存の付与の管理」表で、目的のユーザーまで下へスクロールします。

4. 「アクション」アイコンをクリックします。

- 「ロールの変更」アイコンをクリックして、1つ以上の特定のアプリケーション・ロールを取り消します。第49.5.2項「ユーザーへの異なるロールの割当て」も参照してください。

- 「ロール割当ての削除」を選択してそのユーザーに割り当てられたロールをすべて取り消し、確認を求められたら「削除」をクリックします。

そのユーザーのアクセス権がすぐに取り消されます。

特定のユーザーに割り当てられたロールをすべて削除すると、そのユーザーは「ユーザーとグループ」ページのリストには表示されなくなります。そのユーザーはアイデンティティ・ストアに残るため、引き続きAuthenticated-UserロールによりWebCenter Portalにアクセスできます。第49.3.1.1項「デフォルトのアプリケーション・ロール」を参照してください。

49.5.5 ユーザーの追加または削除

WebCenter Portal管理者は、WebCenter Portalのアイデンティティ・ストアに対して直接新しいユーザー・データを追加したり、ユーザー資格証明を削除することはできません。アイデンティティ・ストアの管理はシステム管理者の職責であり、WLS管理コンソールを通じて実行するか、組込みLDAPアイデンティティ・ストアに対し、LDAPコマンドを使用して直接実行します。第31.3.1項「WLS管理コンソールを使用したアイデンティティ・ストアへのユーザーの追加」も参照してください。

ただし、WebCenter Portal管理者はアプリケーションの自己登録を有効化できます。自己登録により、招待済ユーザーと未招待ユーザーはWebCenter Portalに独自のログインとパスワードを作成できます。自己登録したユーザーはただちに自動的にWebCenter Portalへのアクセス権が付与され、新規ユーザー・アカウントがアイデンティティ・ストアで作成されます。第48.11項「自己登録の有効化」も参照してください。

49.6 アプリケーション・ロールおよび権限の管理

WebCenter Portalではアプリケーション・ロールを使用して、ホーム・ポータルで作業するユーザーの権限を管理します。管理者は、「ロール」ページでアプリケーション・ロールと権限を管理します(図49-6)。

図49-6 WebCenter Portal管理: 「ロール」ページ

この項では、WebCenter Portalの「管理」ページからアプリケーション・ロールとその権限を管理する方法について説明します。この項の内容は次のとおりです。

- 第49.6.1項「アプリケーション・ロールの定義」

- 第49.6.2項「アプリケーション・ロールの権限の変更」

- 第49.6.3項「パブリック・ユーザーへの権限の付与」

- 第49.6.4項「認証されたユーザーへの権限の付与」

- 第49.6.5項「アプリケーション・ロールの削除」

49.6.1 アプリケーション・ロールの定義

WebCenter Portalユーザーのグループを特徴付けるロールを使用して、そのロールによりホーム・ポータルで表示および実行できる内容を決定します。

アプリケーション・ロールを定義する際には、自己記述的なロール名を使用し、ロール・ポリシーは可能なかぎり簡単なものにします。最小限のロールを選択し、効果的なポリシーを維持します。

新規のロールに対する権限の割当ては、適切なアクセス権を割り当てるように注意します。ロールには必要以上に多くのアクションをユーザーが実行できないようにすると同時に、必要なアクティビティの実行までも不注意に制限しないようにします。場合によっては、ユーザーが複数のロールに該当することもあります。

新規のアプリケーション・ロールを定義する手順は、次のとおりです。

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「セキュリティ」をクリックします。
あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/builder/administration/security

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「ロール」をクリックします(図49-6)。
WebCenter Portalの現在のアプリケーション・ロールは、表の列として表示されます。

3. 「ロールの作成」をクリックして、WebCenter Portalユーザーの新しいロールを定義します。

図49-7 新しいロールの作成

4. ロールに合った名前を入力します。
自己記述的なロール名を付けます。どのユーザーがどのロールに所属するかを可能なかぎり明白にします。ロール名には、英数字、空白、@およびアンダースコアを使用できます。

5. (オプション)「ロール・テンプレート」を選択します。
新しいロールは、ロール・テンプレートから権限を継承します。この権限は次の手順で変更できます。

「管理者」を選択して、完全な管理権限を継承するロールを作成します。逆に、「パブリック・ユーザー」を選択して、通常は最小限の権限を割り当てるロールを作成します。または、カスタム・アプリケーション・ロールを選択して自分のテンプレートにします。

6. 「OK」をクリックします。
新しいロールが列として表に表示されます。ユーザーがこのロールを使用して実行できるアクションが、権限リストに表示されます。

7. このロールのユーザー権限を変更するには、各権限チェック・ボックスを選択または選択解除します。

8. 「適用」をクリックして、ロールの権限に対して指定したすべての変更を保存します。

49.6.2 アプリケーション・ロールの権限の変更

管理者は、アプリケーションに関連付けられた権限をいつでも変更できます。アプリケーション権限の詳細は、第49.3.2項「アプリケーションの権限について」を参照してください。

アプリケーション・ロールの権限により、各ユーザーはホーム・ポータル内で特定のアクションを実行できます。Manage Allを除くすべての権限は、他の権限からその内容を継承しません。

注意:
Administratorロールについては、アプリケーションの権限を変更することはできません。第49.3.1.1項「デフォルトのアプリケーション・ロール」も参照してください。

ロールに関連付けられた権限を変更するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「セキュリティ」をクリックします。
あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/builder/administration/security

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「ロール」をクリックします(図49-6)。
WebCenter Portalの現在のアプリケーション・ロールは、表の列として表示されます。

3. 「権限」チェック・ボックスを選択または選択解除して、ロールの権限を有効または無効にします。

4. 「適用」をクリックして保存します。
新しい権限は即時有効になります。

49.6.3 パブリック・ユーザーへの権限の付与

WebCenter Portalにログインしない任意のユーザーは、Public-Userロールを引き受けます。初期設定では、Public-Userロールにより最小限の権限(Portal Server - View権限のみ)が付与されます。

注意:
Public-Userロールに権限を付与する際には注意してください。Portal Server-Manage All、Portal Server-Manage Configurationなどの管理権限や、不要と思われる権限は付与しないようにしてください。第49.3.2項「アプリケーションの権限について」も参照してください。

Portal Server-View権限の付与

Portal Server - View権限により、認証されていないユーザーは、ようこそページや個々のユーザーがパブリック指定を選択しているコンテンツなどのパブリックWebCenter Portalページを表示できます。

Portal Server - View権限がPublic-Userロールに付与される場合:

- パブリックに指定されているすべての個人用ページまたは個人用コンテンツが、WebCenter Portalコミュニティ外の承認されていないユーザー(Webアクセス権を持つすべてのユーザー)に対してアクセス可能になることを確認してください。

- パブリック・ユーザーが(ようこそページに)ログインする前に、パブリック・ユーザーに表示されるデフォルトのようこそページのカスタマイズを検討してください。第50章「システム・ページのカスタマイズ」を参照してください。

承認されていないユーザーに、「パブリック」とマークされたWebCenter Portalコンテンツを表示させない場合、Portal Server - View権限をPublic-Userロールに付与しないでください。パブリック・アクセスが無効になっていると、パブリック・コンテンツは承認されていないユーザーには表示されません。また、WebCenter Portalのようこそページも表示されません。パブリック・ユーザーは直接ログイン・ページにダイレクトされます。管理者は、必要に応じて、デフォルトのログイン・ページをカスタマイズできます。第50.2項「すべてのポータルのシステム・ページのカスタマイズ」を参照してください。

その他の権限の付与

Public-Userロールに権限を割り当てる際には注意してください。セキュリティ上の理由から、匿名ユーザーがWebCenter Portal内で表示できる内容と実行できる操作を制限することをお薦めします。

49.6.4 認証されたユーザーへの権限の付与

WebCenter Portalにログインしているすべてのユーザーは、Authenticated-Userロールを引き受けます。初期設定では、Authenticated-Userロールには、次に示す権限を介して最小限の権限が付与されます。Portal Server - View、Portals-Create、Portal Templates-Create、Pages-Create、Update People Connections DataおよびConnect with People。

その他の重要な注意点は、次のとおりです。

- Authenticated-Userロールは、Public-Userロールからの権限を必ず継承します。

- カスタム・アプリケーション・ロールは、Authenticated-Userロールの権限をすべて継承します。

49.6.5 アプリケーション・ロールの削除

アプリケーション・ロールが不要になったら、WebCenter Portalから削除する必要があります。これにより、有効なロール・リストを維持し、不適切なロール割当てを防止できます。

アプリケーション・ロールは、ユーザーに割り当てられている場合でも削除できます。デフォルトのロールはいずれも削除できないため、WebCenter PortalユーザーにはAuthenticated-Userロールが常時割り当てられます。

注意:
Administrator、Public-UserおよびAuthenticated Userのデフォルトのアプリケーション・ロールは削除できません(Application Specialistロールは削除できます)。第49.3.1.1項「デフォルトのアプリケーション・ロール」を参照してください。

アプリケーション・ロールを削除するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「セキュリティ」をクリックします。
あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/builder/administration/security

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「ロール」をクリックします(図49-6)。
WebCenter Portalの現在のアプリケーション・ロールは、表の列として表示されます。

3. 削除するロールの横にある「ロールの削除」アイコンを選択します(図49-8)。

図49-8 アプリケーション・ロールの削除

4. 「削除」をクリックしてロールの削除を確定します。
ロールが表から削除されます。このロールのみが割り当てられているすべてのユーザーは、デフォルトのAuthenticated-Userロールを引き受け、「ユーザーとグループ」タブには表示されません。

49.7 ユーザーおよびロールに関する問題のトラブルシューティング

WebCenter Portalで、エンタープライズのグループからロールへのマッピングを正しくメンテナンスするには、バックエンドのディスカッション・サーバーとコンテンツ・サーバーでエンタープライズ・グループがサポートされている必要があります。Oracle WebCenter Portal 11.1.1.2.0以降で提供されているWebCenter Portalのディスカッション・サーバー・バージョンとWebCenter ContentのContent Serverバージョンは、両方ともエンタプライズ・グループをサポートしていますが、旧バージョンではサポートしていない場合があります。バックエンド・サーバーがエンタープライズ・グループをサポートしていない場合には、グループの追加を試行すると、次のようなエラー・エラー・メッセージが表示されます。

警告: グループ[name]がアイデンティティ・ストアに見つかりません

また、エラーでは下記のような詳細情報を記載したログが記録されます。

[2011-03-28T01:03:07.143-07:00] [WC_Spaces] [NOTIFICATION] [WCS-07855]
oracle.webcenter.doclib.internal.spaces.AbstractDoclibRoleMapper] [tid: pool-1-daemon-thread-1] [userId: monty]
[ecid: a4789a41d7e6bc9f:36de4556:12efb72d049:-8000-00000000000002c0,0:5]
[APP: webcenter#11.1.1.4.0] Adding groups [oracle.webcenter.security.common.WCGroup@18b96a3] to documents service roles [Administration, Delete Documents, Create and Edit Documents, View Documents] for
scope Scope[name=rbgs25mar01, guid=sbf125dd4_cd43_41cc_9d3d_467d06e84100][2011-03-28T01:03:09.122-07:00] [WC_Spaces] [ERROR] [WCS-44002] [oracle.webcenter.security.rolemapping.RoleManager]
[tid: [ACTIVE].ExecuteThread: '3' for queue: 'weblogic.kernel.Default (self-tuning)'] [userId: monty]
[ecid: a4789a41d7e6bc9f:36de4556:12efb72d049:-8000-00000000000002c0,0]
[APP: webcenter#11.1.1.4.0] The Role Mapping provider encountered an exception while performing security role mapping for service oracle.webcenter.doclib.
[[oracle.webcenter.security.rolemapping.spi.RoleMappingSPIException: Cannot add role null and permissions, 15, to the account for the folder, rbgs25mar01 for the user/group Admin.        at
oracle.webcenter.doclib.internal.spaces.UCMSpacesUtils$2.newException(UCMSpacesUtils.java:2595)

注意:
以前のリリースでは、バックエンド・サーバーがエンタープライズ・グループをサポートしていない場合、エンタープライズ・グループに属するユーザーは、個々にWebCenter Portalロールに追加されました。この動作が変更されました。

50 システム・ページのカスタマイズ

この章では、WebCenter Portalで使用可能な初期設定のシステム・ページとそのカスタマイズ方法について説明します。

注意:
システム管理者がアプリケーション・レベルでシステム・ページに加えたすべての変更は、すべてのポータルの同等のシステム・ページで反映されます。たとえば、システム管理者がイメージをアプリケーションレベルの「お知らせ」システム・ページに追加すると、そのイメージはすべてのポータルでポータルレベルの「お知らせ」システム・ページに表示されます。ホータルレベルのシステム・ページに加えた変更は、関連付けられたポータルにのみ反映されます。ポータルにシステム・ページを表示する場合、アプリケーションレベルで指定したすべてのカスタマイズが適用された後で、ポータルレベルで指定したカスタマイズが適用されます。

この章には次のトピックが含まれます:

- 第50.1項「システム・ページについて」

- 第50.2項「すべてのポータルのシステム・ページのカスタマイズ」

- 第50.3項「システム・ページのプロパティの設定」

- 第50.4項「システム・ページからのすべてのページ・カスタマイズの削除」

権限:
この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server-Manage Configuration

権限の詳細は、第49.3項「アプリケーション・ロールおよび権限について」を参照してください。

50.1 システム・ページについて

システム・ページは初期設定で用意されており、特定の目的を達成するように設計されています。たとえば、ポータルにアクセスした際にログインしないユーザーには、パブリックの「ようこそ」ページを表示できます。

システム・ページには様々なユーティリティ・ページが用意されており、それらのページをカスタマイズして会社のブランドを反映し、役立つヒントを提供し、必要なその他の機能強化を表示することができます。そこでは、ポータルの迅速な開発がサポートされ、紹介ページの提供から、動的に生成されて個々のユーザーに合わせたコンテンツを提供するページに至るまでの幅広いニーズが実現します(「アクティビティ・ストリーム」ページなど)。

システム・ページは、想定ユーザーを対象とするページへのアクセス設定により事前構成されています。たとえば、「ようこそ」ページはanonymous-role、「アクティビティ・ストリーム」ページは個々のユーザーを対象として、各ユーザーに合わせた動的コンテンツで構成されます。この事前構成のビューでは、システム・ページのセキュリティ設定を変更できません。

ただし、システム・ページのカスタマイズは可能です。カスタマイズにより、システム・ページのシード済コンテンツを強化して、会社のブランドの適用、ヒント・テキストの追加、追加機能(タスク・フロー、ポートレットなど)の提供などを実現できるようになります。

また、システム・ページによりタスク・フローのカスタマイズも可能になります。システム・ページの「タスク・フロー・エディタ」は、指定された範囲におけるシード済タスク・フローのすべてのインスタンスを1つの操作でカスタマイズする環境を提供します。(「アセット」ページまたは「共有アセット」ページを使用して作成されたカスタム・タスク・フローは、このページを使用して編集することはできません。)認可されたユーザーは、このページにシード済タスク・フローを追加し、そのタスク・フローのすべてのインスタンスをカスタマイズできます。詳細は、第54章「ポータル間のタスク・フローのカスタマイズ」を参照してください。

表50-1に、初期設定で提供されるシステム・ページの一覧と説明を示し、表示されるコンテキストに関する情報を示します。

表50-1 シード済システム・ページ

ページ

説明

コンテキスト

アクティビティ

ホーム・ポータルに対して、ピープル・コネクション・サービスから「パブリッシャ」タスク・フローと「アクティビティ・ストリーム」タスク・フローが表示されます。詳細は、『Oracle WebCenter Portalの使用』の「ポータル・アクティビティの追跡」を参照してください。

これはアプリケーションレベルのシステム・ページです。

アクティビティ・ストリーム

ポータルに対して、ピープル・コネクション・サービスから「パブリッシャ」タスク・フローと「アクティビティ・ストリーム」タスク・フローが表示されます。詳細は、『Oracle WebCenter Portalの使用』の「ポータル・アクティビティの追跡」を参照してください。

認証された(ログインしている)ユーザーそれぞれのホーム・ポータルにデフォルトで表示されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

分析

アプリケーションの使用状況とパフォーマンス・メトリックに関する情報を提供します。詳細は、第56章「ポータルの使用状況の分析」を参照してください。

「分析」タスク・フローを機能させるには、「分析」スキーマ(ACTIVITIES)をインストールして構成し、WebCenter Portalと分析コレクタの間の接続を設定する必要があります。

ホーム・ポータルでの表示で使用可能です。構成の要件が満たされている場合にのみ有用です。

これはアプリケーションレベルのシステム・ページです。

お知らせ

「お知らせマネージャ」タスク・フローを表示します。詳細は、『Oracle WebCenter Portalの使用』の「「お知らせ」での作業」を参照してください。

多くの初期状態のポータル・テンプレートにデフォルトで表示されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

ディスカッション

「ディスカッション・フォーラム・マネージャ」タスク・フローを表示します。詳細は、『Oracle WebCenter Portalの使用』の「ディスカッションの表示と参加」の章を参照してください。

多くの初期状態のポータル・テンプレートにデフォルトで表示されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

ドキュメント

「ドキュメント・エクスプローラ」タスク・フローを表示します。

2種類の「ドキュメント」システム・ページがあります。1つは現在のユーザーの個人用ドキュメントを表示するホーム・ポータル用、もう1つはそのポータルにアップロードされたドキュメントを表示するポータル用です。詳細は、『Oracle WebCenter Portalの使用』の「ドキュメントの作成と管理」を参照してください。

多くの初期状態のポータル・テンプレートにデフォルトで表示されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

エラーが発生しました

エラーが発生するとエラー・ページを表示します。

アプリケーションのエラーが発生すると表示されます。

これはアプリケーションレベルのシステム・ページです。

イベント

「イベント」タスク・フローを表示します。詳細は、『Oracle WebCenter Portalの使用』の「カレンダとイベントでの作業」を参照してください。

多くの初期状態のポータル・テンプレートにデフォルトで表示されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

リスト

「リスト・マネージャ」タスク・フローを表示します。詳細は、『Oracle WebCenter Portalの使用』の「リストでの作業」を参照してください。

多くの初期状態のポータル・テンプレートにデフォルトで表示されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

ログイン

ポータルにログインするためのフィールドを表示します。

すべてのアプリケーション・ページへのパブリック・アクセスを無効にしたり、現在のセッションの期限が切れた場合に、「WebCenter Portalようこそページ」のかわりに表示されます。

これはアプリケーションレベルのシステム・ページです。

メンバー

ポータルのメンバーを管理するための機能を提供します。詳細は、『Oracle WebCenter Portalでのポータルの構築』の「ポータルのメンバーの管理とロールの割当て」を参照してください。

一部のシード済ポータル・テンプレートでは、デフォルトのナビゲーションで「メンバー」ページとして表示されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

いずれのページにもアクセスできません

いずれのページにもアクセスできないことをユーザーに通知するメッセージを表示します。

ポータルのページでユーザーがアクセス権限を持たないポータルに移動したときに表示されます。アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

ページが見つかりません

ページが見つからないことをユーザーに通知するメッセージを表示します。

これはアプリケーションレベルのシステム・ページです。

ユーザーが、WebCenter Portal内で使用されなくなったページや、アクセス権限を持たないページに移動すると表示されます。

ページ・ビューア

外部のWebサイト(google.comなど)を、ポータルのページ・テンプレート内に表示します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のリソースのナビゲーション・モデルへの追加に関する項を参照してください。

外部URLアイテム(ターゲットの同じページとともに)が含まれたナビゲーション・モデルを作成する際に使用されます。ユーザーがナビゲーションでそのようなリンクをクリックすると、「ページ・ビューア」が使用されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

ポータルが見つかりません

ポータルが見つからないことをユーザーに通知するメッセージを表示します。

ユーザーが使用されなくなったポータルに移動する際に、表示されます。

これはアプリケーションレベルのシステム・ページです。

ポータル

現在のユーザーがアクセスできるすべてのポータルのビューを表示します。さらに、ポータルの作成、検索、ソートおよびフィルタリングの機能を提供します。詳細は、『Oracle WebCenter Portalの使用』の使用可能なポータルの表示とアクセスに関する項を参照してください。

ユーザーが「ポータル」メニューから「ポータルの参照」を選択すると表示されます。

これはアプリケーションレベルのシステム・ページです。

ポータル・テンプレート

すべての使用可能なポータル・テンプレートのビューを表示します。ポータル・テンプレートの作成、編集およびフィルタリング用のコントロールと、選択したポータル・テンプレートに関する情報の表示用のコントロールが含まれます。詳細は、『Oracle WebCenter Portalでのポータルの構築』の「ポータル・テンプレートでの作業」を参照してください。

「ポータル・テンプレート」ページの管理ページに表示されます。

これはアプリケーションレベルのシステム・ページです。

プロファイル

現在のユーザーの「プロファイル・ギャラリ」を表示します。これには、「アクティビティ・ストリーム」、「コネクション」、「ドキュメント」、組織図(「組織」)およびユーザーのプロファイル詳細(「情報」)のサブページが含まれます。詳細は、『Oracle WebCenter Portalの使用』の「プロファイルの管理」と「ドキュメントの作成と管理」を参照してください。

認証された(ログインしている)ユーザーそれぞれのホーム・ポータルにデフォルトで表示されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

リソース・ビューア

ポータルのページ・テンプレート内にリソースを表示します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のリソースのナビゲーション・モデルへの追加に関する項を参照してください。

リソース・アイテムが含まれたナビゲーション・モデル(ターゲットの同じページとともに)を作成する際に使用されます。ユーザーがナビゲーションでそのようなリンクをクリックすると、「リソース・ビューア」が使用されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

検索

「検索結果」ページを表示します。詳細は、『Oracle WebCenter Portalの使用』の「WebCenter Portalの検索について」の項を参照してください。

検索結果の表示が動的にレンダリングされます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

自己登録

WebCenter Portalにユーザー独自のログイン・アカウントを作成する手段を提供します。詳細は、『Oracle WebCenter Portalの使用』のWebCenter Portalでの自己登録に関する項を参照してください。

ユーザーが「ログイン」または「WebCenter Portalようこそページ」で「登録」をクリックすると表示されます。

これはアプリケーションレベルのシステム・ページです。

セルフサービス・メンバーシップ

サブスクリプションによりメンバーシップを許可するよう構成されたポータルをサブスクライブする手段を提供します。詳細は、『Oracle WebCenter Portalの使用』のポータルへの参加に関する項を参照してください。

ユーザーがポータルへのサブスクリプションを開始すると表示されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

タグ・センター

「タグ・センター」タスク・フローを表示します。詳細は、『Oracle WebCenter Portalの使用』の「タグとブックマークの使用」を参照してください。

ユーザーが、複数の方法のうちの1つにより「タグ・センター」に移動する際に表示されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

タスク・フロー・エディタ

指定された範囲におけるシード済タスク・フローのすべてのインスタンスを一度の操作によりカスタマイズするための環境を提供します。(「アセット」ページや「共有アセット」ページにより作成されたカスタム・タスク・フローはサポートされません。)詳細は、第54章「ポータル間のタスク・フローのカスタマイズ」を参照してください。

シード済タスク・フローの追加、およびそれらのタスク・フローのすべてのインスタンスのカスタマイズを、認可されたユーザーに許可します。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

タスク・フロー・ビューア

ポータルのページ・テンプレート内にタスク・フローを表示します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のリソースのナビゲーション・モデルへの追加に関する項を参照してください。

タスク・フロー・アイテム(ターゲットの同じページとともに)が含まれたナビゲーション・モデルを作成する際に使用されます。ユーザーがナビゲーションでそのようなリンクをクリックすると、「タスク・フロー・ビューア」が使用されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

未許可

ポータルやページへのアクセスが認可されていないことをユーザーに通知するメッセージを表示します。

ユーザーが、アクセス権限を持たないポータルやページに移動すると、表示されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

使用不可

ポータルが使用不可であることをユーザーに通知するメッセージを表示します。

ユーザーがオフラインのポータルに移動する際に、表示されます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

ユーザー・プロファイル

現在のユーザー以外のユーザーのプロファイル・ギャラリを表示します。デフォルトでは、現在のユーザーのプロファイル・ギャラリと同じサブページおよびタスク・フローが表示されます。他のユーザーに関連付けられている情報が表示される点が異なります。

現在のユーザーが別のユーザーのプロファイルにアクセスすると、動的にレンダリングされます。

アプリケーションレベルとポータルレベルの両方のシステム・ページが使用可能です。

WebCenter Portalようこそページ

ログイン・フィールド、登録リンク、ボイラープレート情報を、特定機能に関するヘルプ・トピックへのリンク、パブリック・ポータルへのリンク、かわりのセッション言語の選択に対する言語変更機能とともに表示します。

これは、パブリックのようこそページです。ユーザーがWebCenter Portalにアクセスした際に、最初に表示されるページです。

すべてのアプリケーション・ページへのパブリック・アクセスを無効にすると、パブリックのようこそページは表示されず、ユーザーは「ログイン」ページにダイレクトされます。

これはアプリケーションレベルのシステム・ページです。

50.2 すべてのポータルのシステム・ページのカスタマイズ

初期状態のシステム・ページをカスタマイズして、所属する組織のブランドやルック・アンド・フィールに合うように表示できます。既存のコンポーネントを削除し、新しいコンポーネントを追加し、ページ・レイアウトを変更できます。ただし、システム・ページの入力フィールドとボタンを編集または削除することはできません。

この項では、WebCenter Portalのシステム・ページをカスタマイズする方法について説明します。次のサブセクションが含まれます:

- 第50.2.1項「アプリケーションレベルのシステム・ページのカスタマイズ」

- 第50.2.2項「デバイス・グループ用システム・ページのページ・バリアントの作成」

- 第50.2.3項「デバイス・グループ用システム・ページのページ・バリアントの管理」

ポータルのシステム・ページをカスタマイズするには、『Oracle WebCenter Portalでのポータルの構築』の「ポータルでのシステム・ページのカスタマイズ」を参照してください。

50.2.1 アプリケーションレベルのシステム・ページのカスタマイズ

編集可能な任意のシステム・ページをカスタマイズできます。この手順は、すべてのアプリケーションレベルのシステム・ページ用です。デバイス・グループごとに使用するシステム・ページのページ・バリアントを作成してある場合、これらのページ・バリアントをカスタマイズすることも可能です。

アプリケーションレベルのシステム・ページまたはページ・バリアントをカスタマイズするには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「システム・ページ」をクリックします。
ブラウザに次のURLを入力して、「システム・ページ」ページに直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/systempages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. システム・ページの横にある「カスタマイズ」リンクをクリックして、コンポーザでそれを開きます(図50-1)。

図50-1 システム・ページの横にある「カスタマイズ」リンク

3. デバイス・グループ用システム・ページのバリアント(システム管理者がアプリケーションレベルで作成)をカスタマイズするには、システム・ページ・バリアントのアイコンを展開し、カスタマイズするデバイス・グループの「カスタマイズ」をクリックします(図50-2)。

図50-2 デバイス・グループ用システム・ページのバリアントのカスタマイズ

4. ページをカスタマイズして保存します。

関連項目:
ページの編集は、『Oracle WebCenter Portalでのポータルの構築』のページの編集に関する項を参照してください。

50.2.2 デバイス・グループ用システム・ページのページ・バリアントの作成

ページ・バリアントは、特定のデバイスのサイズや特徴を対象とした特定のデバイス・グループの既存ページの代替ビューです。ベース・ページとページ・バリアントには、同じURlとセキュリティ設定が指定されていますが、ベース・ページに対するコンテンツの変更は、どれもバリアント・ページに反映されません。逆の場合も同じです。

注意:
WebCenter Portalのデバイス設定の管理に関する詳細は、第53章「デバイス設定の管理」を参照してください。

初期設定では、ページ・バリアントを作成できるのは、次のシステム・ページのみです。「エラーが発生しました」、「ログイン」、「いずれのページにもアクセスできません」、「ページが見つかりません」、「ポータルが見つかりません」、「自己登録」、「未許可」、「使用不可」および「WebCenter Portalようこそページ」。

システム管理者のみが、アプリケーションレベルのシステム・ページに対してページ・バリアントを作成できます。ポータル・モデレータは、システム管理者がシステム・ページのページ・バリアントを作成した後にのみ、そのシステム・ページのページ・バリアントをポータル・レベルでカスタマイズできます。ポータルのシステム・ページまたはページ・バリアントをカスタマイズするには、『Oracle WebCenter Portalでのポータルの構築』の「ポータルのシステム・ページのカスタマイズ」を参照してください。

ページ・バリアントがサポート対象のデバイス・グループに作成されていない場合、ベース・ページにはそのデバイス・グループに属するデバイスのみが表示されます。

使用可能な各デバイス・グループにページ・バリアントを作成できます。ただし、作成できるのは、ページごとに1つのデバイス・グループに対して1つのページ・バリアントのみです。つまり、同じページにiOSフォンのデバイス・グループのページ・バリアントを2つ作成することはできませんが、同じページにiOSフォンのデバイス・グループのページ・バリアントを1つ作成し、Androidフォンのデバイス・グループのページ・バリアントをもう1つ作成することは可能です。iOSフォンのデバイス・グループのページ・バリアントは別のページに作成できます。

デバイス・グループのシステム・ページのページ・バリアントを作成するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「システム・ページ」をクリックします。
ブラウザに次のURLを入力して、「システム・ページ」ページに直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/systempages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. ページ・バリアントを作成するシステム・ページの横にある「ページ・バリアントの作成」リンク(図50-3)をクリックします。

注意:
初期設定では、デバイス・グループのページ・バリアントが提供されているのは、次のシステム・ページのみです。「エラーが発生しました」、「ログイン」、「いずれのページにもアクセスできません」、「ページが見つかりません」、「ポータルが見つかりません」、「自己登録」、「未許可」、「使用不可」および「WebCenter Portalようこそページ」。

図50-3 システム・ページの横にある「ページ・バリアントの作成」リンク

3. 表示される「ページ・バリアントの作成」ダイアログで、「デバイス・グループ」ドロップダウン・リスト(図50-4)からページ・バリアントを作成するデバイス・グループを選択します。
ベース・ページがシステム内でシードされます。ベース・ページは、デフォルトのデバイス・グループに属するデバイスに対して常時レンダリングされています(デフォルトのデバイス・グループの詳細は、第53章「デバイス設定の管理」を参照してください)。ページ・バリアントがデフォルトとしても設定されているデバイス・グループに対して存在している場合、そのベース・ページはページ・バリアントより優先されます。デスクトップ・ブラウザからページを開くと、デフォルトでデバイス・グループは「デスクトップ・ブラウザ」に設定されているため、「デスクトップ・ブラウザ」バリアントが作成されているかどうかにかかわらず、ベース・ページが表示されます。他のデバイスから開くと、選択したページ・バリアントが表示されます。

たとえば、iOSフォンをデフォルト・ページに変更すると、ベース・ページはそのデバイス・タイプに設定されます。iPhoneでは、ベース・ページが表示され、iOS Phonesページ・バリアントは表示されません。ただし、デスクトップ上には「デスクトップ・ブラウザ」のバリアントが表示され、ベース・ページは表示されません。デフォルトのデバイス・グループを変更しない場合、作成した「デスクトップ・ブラウザ」バリアントはデスクトップ・ブラウザに表示されません。その場合でも、ベース・ページはデスクトップに表示されます。

注意:
デフォルトのデバイス・グループを変更する場合には注意してください。ベース・ページまたはそのページ・バリアントをグローバルに表示する際にデフォルトの動作が変更されます。

図50-4 「ページ・バリアントの作成」ダイアログ

4. 「作成」をクリックします。
モバイルのアイコンがページの横に表示され、そのページのページ・バリアントが使用できることを示します(図50-5)。

図50-5 ページ・バリアントが使用できることを示すアイコン

5. 「展開」アイコンをクリックして、デバイス・グループのページ・バリアントを表示します(図50-6)。

図50-6 デバイス・グループのページ・バリアント

同じページに別のデバイス・グループの別のページ・バリアントを作成できます。ただし、すでにページ・バリアントが作成されている同じデバイス・グループに別のページ・バリアントを作成することはできません。

6. ページ・バリアントを作成後には、次のいずれかを実行できます。

- デバイス・グループの横にある「編集」をクリックして、コンポーザでそのページを編集します。
ページの編集は、『Oracle WebCenter Portalでのポータルの構築』のページの編集に関する項を参照してください。

- デバイス・グループの横にある「削除」をクリックして、ページ・バリアントを削除します。「削除」を再びクリックして、削除を確定します。

- デバイス・グループの横にある「ソースの編集」をクリックして、ソース・コードを編集します。
詳細は、『Oracle WebCenter Portalでのポータルの構築』のページのソース・コードの表示と変更に関する項を参照してください。

50.2.3 デバイス・グループ用システム・ページのページ・バリアントの管理

デバイス・グループのページ・バリアントとシステム・ページのページ・バリアントの作成に関する詳細は、第50.2.2項「デバイス・グループ用システム・ページのページ・バリアントの作成」を参照してください。

システム・ページのページ・バリアントを管理するには:

1. 「展開」アイコンをクリックして、デバイス・グループのページ・バリアントを表示します(図50-7)。

図50-7 デバイス・グループのページ・バリアント

2. コンポーザでページ・バリアントを編集するには、「編集」をクリックします。
ページの編集は、『Oracle WebCenter Portalでのポータルの構築』のページの編集に関する項を参照してください。

3. ページ・バリアントを削除するには、「削除」をクリックします。「削除」を再びクリックして、削除を確定します。

4. ソース・コードを編集するには、「ソースの編集」をクリックします。
ページのソース・コード編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページのソース・コードの表示と変更に関する項を参照してください。

50.3 システム・ページのプロパティの設定

システム・ページのページ・プロパティには、ページの背景色とイメージを指定し、追加のCSSエンコーディングを適用し、パラメータを設定する手段が用意されています。

システム・ページのプロパティを編集するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「システム・ページ」をクリックします。
ブラウザに次のURLを入力して、「システム・ページ」ページに直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/systempages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. システム・ページの横の「カスタマイズ」リンクをクリックして、コンポーザでそれを開きます(図50-8)。

図50-8 システム・ページの横にある「カスタマイズ」リンク

3. 「ページ・プロパティ」アイコン(図50-9)をクリックして、「ページ・プロパティ」ダイアログを開きます(図50-10)。

関連項目:
ページの編集は、『Oracle WebCenter Portalでのポータルの構築』のページの編集に関する項を参照してください。

図50-9 「ページ・プロパティ」アイコン

4. 「表示オプション」タブのプロパティを変更するには、『Oracle WebCenter Portalでのポータルの構築』のページの背景色、イメージおよびCSSエンコーディングの指定に関する項を参照してください。

5. 「パラメータ」タブで(図50-10)、既存のパラメータを必要に応じて変更します(表50-2を参照)。

図50-10 「ページ・プロパティ」ダイアログ: パラメータ

注意:
すべてのパラメータ値は式言語(EL)エディタへのアクセス権を提供し、それを使用して定数値のかわりに変数値を選択または指定できます。値フィールドの横にある「編集」アイコンをクリックして「式ビルダー」を選択し、エディタを開きます。ELアシスタンスが必要な場合、アプリケーション開発者はEL式を提供できます。『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の付録「式言語の式」を参照してください。

表50-2 システム・ページのパラメータ

パラメータ

説明

pg_theme

システム・ページを表示する際に、以前のリリースのルック・アンド・フィール(初期設定)を使用するか、現在のリリースの新しいルック・アンド・フィールを使用するかを指定します。

有効な値は次のとおりです。

- spaces_blue。以前のリリース(11.1.1.7.0以前)のルック・アンド・フィールを使用します。

- 11ps7_greyまたはこのフィールドを空白のままにします。現在のリリースの新しいルック・アンド・フィールを使用します。

pg_pageTemplateID

システム・ページを表示する際に、以前のリリースのデフォルトのページ・テンプレートを使用するか、現在のリリースのデフォルトの空白テンプレートを使用するかを指定します。有効な値は次のとおりです。

- spaces_blue。以前のリリース(11.1.1.7.0以前)のデフォルトのページ・テンプレートを使用します。

- このフィールドを空白のままにします。現在のリリースのデフォルトの空白テンプレートを使用します。

- page_template_GUID。GUID値で指定したページ・テンプレートを使用します。

6. 新規パラメータを追加するには:

- 「ページ・パラメータの追加」をクリックします。

- 「ページ・パラメータの追加」ダイアログに、新規パラメータの「名前」を入力し、「パラメータの追加」をクリックして、値入力フィールドが表示される「パラメータ」タブにパラメータを追加します。

- オプションで、新規パラメータの値を入力します。

50.4 システム・ページからのすべてのページ・カスタマイズの削除

システム・ページをデフォルトの初期状態に戻すには、すべてのページのカスタマイズを削除します。

注意:
この処理では、タスク・フローのカスタマイズは削除されません。タスク・フローのカスタマイズを削除するには、システム・ページで指定されたタスク・フローを改訂する必要があります。詳細は、第54章「ポータル間のタスク・フローのカスタマイズ」を参照してください。

システム・ページからすべてのカスタマイズを削除するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「システム・ページ」をクリックします。
ブラウザに次のURLを入力して、「システム・ページ」ページに直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/systempages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. システム・ページの横にある「デフォルトに戻す」リンクをクリックします(図50-11)。

図50-11 システム・ページの横にある「デフォルトに戻す」リンク

3. 表示された確認ダイアログで、「復元」をクリックします。
すべてのカスタマイズは、選択したシステム・ページから永続的に削除されます。システム・ページをそのデフォルト状態に戻す際に、そのシステム・ページにバリアントが作成されていても、ページ・バリアントは影響を受けません。

51 ビジネス・ロール・ページの管理

この章では、ビジネス・ロール・ページを作成してターゲット化する方法およびその他の関連するビジネス・ロール・ページ管理タスクを実行する方法について説明します。

この章には次のトピックが含まれます:

- 第51.1項「ビジネス・ロール・ページについて」

- 第51.2項「ビジネス・ロール・ページのためのページ作成のデフォルトの設定」

- 第51.3項「ビジネス・ロール・ページの作成」

- 第51.4項「ビジネス・ロール・ページのターゲット・ユーザーの指定」

- 第51.5項「カスタム・ビジネス・ロール・ページへのアクセス権限の取消し」

- 第51.6項「ビジネス・ロール・ページへのナビゲーションの提供」

- 第51.7項「ビジネス・ロール・ページのデフォルトの表示順の設定」

- 第51.8項「ビジネス・ロール・ページの編集」

- 第51.9項「ビジネス・ロール・ページのソースの編集」

- 第51.10項「ビジネス・ロール・ページのコピー」

- 第51.11項「ビジネス・ロール・ページからのすべてのユーザー・カスタマイズの削除」

- 第51.12項「カスタム・ビジネス・ロール・ページの削除」

権限:
この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server-Manage Configuration

さらに、ポータルの作成および管理の権限(Portals-Create PortalsおよびPortals-Manage Security and Configurationまたはどちらか一方)が必要です。権限の詳細は、第49.3項「アプリケーション・ロールおよび権限について」を参照してください。

51.1 ビジネス・ロール・ページについて

ビジネス・ロール・ページは、関連性の高いコンテンツを特定のユーザーに公開する方法を提供します。ビジネス・ロール・ページは、営業チーム、会計チーム、管理スタッフなどの特定のタイプのグループ、またはユーザー(あるいはユーザー・ロール)向けのページです。

ビジネス・ロール・ページは、WebCenter Portalシステム管理者がビジネス・ロール・ページを公開すると、ターゲットのビジネス・ロールを共有するすべてのユーザーのホーム・ポータル・ビューで使用できます。たとえば、HR_ORGロールに割り当てられたすべてのユーザーをターゲットにするビジネス・ロール・ページは、ロールHR_ORGに割り当てられたすべてのユーザーのホーム・ポータル・ビューに表示されます。

ヒント:
ビジネス・ロール・ページがホーム・ポータル・ナビゲーションに表示されていなくても、ターゲットのユーザーはこのページを「ページのパーソナライズ」ページで常に使用できます。

HR_ORGロールに割り当てられていない個人ユーザーにページを表示する場合、システム管理者はこのユーザーにアクセス権限を付与できます。シードされたビジネス・ロール・ページ(表51-1を参照)には、変更できない事前設定されたアクセス設定があります。シードされたビジネス・ロール・ページのアクセス設定を変更する方法の詳細は、第51.4.3項「シードされたビジネス・ロール・ページのアクセス権限の設定」を参照してください。

システム管理者は、ビジネス・ロール・ページを作成できる唯一のユーザー・タイプです。その他のユーザーは、システム管理者が権限を付与した場合のみ、ビジネス・ロール・ページの編集、コピーおよび削除、ならびにページの権限の変更を行えます(詳細は、第51.4項「ビジネス・ロール・ページのターゲット・ユーザーの指定」を参照)。

表51-1に、デフォルトのWebCenter Portalインストールに含まれているシードされたビジネス・ロール・ページをリストし、説明します。また、これらが表示されるコンテキストについて説明します。

これらのページは、WebCenter Portal偽装を除いて、「システム・ページ」ページにも表示されます(第50章「システム・ページのカスタマイズ」を参照)。

表51-1 シードされたビジネス・ロール・ページ

ページ

説明

コンテキスト

アクティビティ

「ピープル・コネクション」および「パブリッシャ」タスク・フローから「アクティビティ・ストリーム」を表示します。これはコンテンツをストリームに投稿するために使用できます。詳細は、『Oracle WebCenter Portalの使用』のポータル・アクティビティの追跡に関する項および「フィードバックおよびメッセージ・ボードでの作業」を参照してください。

認証された(ログインしている)ユーザーそれぞれのホーム・ポータル・ビューにデフォルトで表示されます。

分析

WebCenter Portal、ポータル、ポートレットおよびサービスに関係のあるパフォーマンス・メトリックを表示します。詳細は、第27.1項「Oracle WebCenter Portalのパフォーマンス・メトリックの理解」を参照してください。

デフォルトでは非表示ですが、ホーム・ポータルのシステム管理者のビューの「ページのパーソナライズ」ページでアクセスできます。

ドキュメント

「ドキュメント・エクスプローラ」タスク・フローを表示します。詳細は、『Oracle WebCenter Portalでのポータルの構築』の「「ドキュメント・サービス」タスク・フローについて」の項を参照してください。

デフォルトでは、認証されたユーザーそれぞれのホーム・ポータル・ビューに表示されます。

プロファイル

現在のユーザーの「プロファイル」を表示します。これには、「アクティビティ」、「コネクション」、「ドキュメント」、組織図(「組織」)およびユーザーのプロファイル詳細(「情報」)のサブページが含まれます。詳細は、『Oracle WebCenter Portalの使用』の「プロファイルの管理」および『Oracle WebCenter Portalでのポータルの構築』の「「ドキュメント・サービス」タスク・フローについて」の項を参照してください。

デフォルトでは、認証されたユーザーそれぞれのホーム・ポータル・ビューに表示されます。

ポータル

現在のユーザーと関係のあるポータルを表示します(ユーザーが属しているポータル、ユーザーがアクセス権限を持っているポータル、ユーザーが検索できるポータルなど)。リストされた各ポータルには、ポータルでアクションを実行するためのオプション付きの関連メニューがあります。このページでは、ポータルの作成および追加のポータルの検索を行うためのコントロールも提供します。

デフォルトでは、認証されたユーザーそれぞれのホーム・ポータル・ビューに表示されます。

ポータル・テンプレート

デフォルトおよびカスタムのポータル・テンプレートのリストを表示し、カスタム・ポータル・テンプレートを作成する方法およびテンプレートのリストをフィルタリングする方法を提供します。

デフォルトでは非表示ですが、認証された各ユーザーのホーム・ポータル・ビューの「ページのパーソナライズ」ページでアクセスできます。

タグ・センター

「タグ」タスク・フローまたは検索結果内のタグをユーザーがクリックしたときにレンダリングされる「タグ・センター」を表示します。詳細は、『Oracle WebCenter Portalの使用』の「タグの使用」を参照してください。

ユーザーがタグをクリックすると起動します。

WebCenter Portal偽装

WebCenter Portalシステム管理者が、サポート担当者や他のポータル管理者などのユーザー(「偽装者」)のグループに偽装の権限を割り当てることができるページを表示します。こうすることによって、偽装者は他のユーザー(「被偽装者」)として操作を実行できます。詳細は、第38章「偽装の管理」を参照してください。

(偽装者による)偽装セッションの開始方法および(被偽装者による)偽装セッションの許可方法の手順については、『Oracle WebCenter Portalの使用』の「WebCenter Portal偽装の使用」を参照してください。偽装ELおよび偽装APIの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』のWebCenter Portal偽装ELおよび偽装APIの使用に関する項を参照してください。

WebCenter Portal偽装は、OAM 11g 11.1.2.0に依存しています。WebCenter Portalインスタンスのために偽装を有効化するには、その前にまずOAM 11g (Oracleのシングル・サインオン・ソリューション)をインストールして構成し、OAMで偽装を有効にする必要があります。OAM 11gのインストールと構成の詳細は、第33.2項「Oracle Access Manager(OAM)の構成」を参照してください。

51.2 ビジネス・ロール・ページのためのページ作成のデフォルトの設定

WebCenter Portalシステム管理者は、ページ作成のデフォルトを設定し、ビジネス・ロール・ページの作成に必要な手順の数を減らすことができます。つまり、「ページの作成」ダイアログを開いたときにデフォルトで選択されるページ・スタイルを指定できます。「ページの作成」ダイアログをバイパスすることも選択できます。こうすると、デフォルトのページ・スタイルが強制的に選択されます。

関連項目:
ビジネス・ロール・ページ用にシステム管理者が設定するページ作成のデフォルトは、個人用ページにも影響します。認証されたユーザーは、ホーム・ポータルで作成した独自の個人用ページのページ作成のデフォルトをオーバーライドできます(詳細は、『Oracle WebCenter Portalの使用』の個人用ページのページ作成のデフォルトの設定に関する項を参照)。ポータルで作成されるページのデフォルトは、ポータル・モデレータによって制御されます(詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル・ページの作成および編集に関する項を参照)。

ビジネス・ロール・ページのページ作成のデフォルトを設定するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。
ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/businessrolepages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「ページ・デフォルトの設定」をクリックして、「ページ・デフォルトの設定」ダイアログを開きます(図51-1)。

図51-1 「ページ・デフォルトの設定」ダイアログ

3. 「ページ・スタイル」ドロップダウン リストからページ・レイアウトを選択します。

関連項目:
シードされたページ・スタイルの詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・スタイルの概要に関する項を参照してください。このリストは、追加のカスタム・ページ・スタイルを含む場合や、ページ・スタイルを短いリストに制限している場合があります。

4. 「ワンクリック・ページ作成の有効化」のオプションを選択します。

- はい: 「ページの作成」ダイアログをバイパスし、指定した「ページ・スタイル」を使用してすべての個人用ページを作成します。

ヒント:
「ページの作成」ダイアログをバイパスしてページを作成する場合、新しいページは汎用名になります。ページ名の変更の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページの名前変更に関する項を参照してください。

- いいえ: 「ページの作成」ダイアログが表示され、指定した「ページ・スタイル」がすべての個人用ページの「ページの作成」ダイアログのデフォルトとして選択されます。新しい個人用ページに異なるスタイルを選択できます。

5. 「保存」をクリックして変更を保存し、ダイアログを終了します。

51.3 ビジネス・ロール・ページの作成

注意:
個人用ページまたはビジネス・ロール・ページの「ページのコピー」アクションを選択して、これをビジネス・ロール・ページとしてコピーすることも可能です。詳細は、第52.8項「個人用ページのコピー」および第51.10項「ビジネス・ロール・ページのコピー」を参照してください。

新しいビジネス・ロール・ページを作成するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。
ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/businessrolepages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「作成」をクリックします(図51-2)。

図51-2 ビジネス・ロール・ページの「作成」オプション

ワンクリック・ページ作成を有効にしている場合、新しいページがリストに表示されます。ワンクリック・ページ作成を有効にしなかった場合、次の手順に進みます。

3. 「ページの作成」ダイアログで、一意のページ名を「ページ名」フィールドに入力し、「ページ・スタイル」を選択します(図51-3)。

図51-3 「ページの作成」ダイアログ

関連項目:
シードされたページ・スタイルの概要は、『Oracle WebCenter Portalでのポータルの構築』の初期ページ・スタイルに関する項を参照してください。

4. 「作成」をクリックします。
新しいページがビジネス・ロール・ページのリストに表示されます。

関連項目:
システム管理者は、カスタム・ページ・スタイルに属性を設定できます。この属性によって、そのスタイルに基づいて新しく作成されるページを、ページ編集モードで開くかページ表示モードで開くかを決めることができます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル・アセットのプロパティの設定に関する項を参照してください。

後でページにコンテンツを追加できます。次の項(第51.4項「ビジネス・ロール・ページのターゲット・ユーザーの指定」)では、ビジネス・ロール・ページのアクセス権限を設定する手順を説明します。

5. 次の手順:

- 第51.4項「ビジネス・ロール・ページのターゲット・ユーザーの指定」の説明に従って、ページのユーザーを定義します。

- 第51.7項「ビジネス・ロール・ページのデフォルトの表示順の設定」の説明に従って、ページの表示順を選択します。

- 『Oracle WebCenter Portalでのポータルの構築』のページでのWeb開発コンポーネントの使用に関する項の説明に従って、コンテンツをページに追加します。

51.4 ビジネス・ロール・ページのターゲット・ユーザーの指定

ビジネス・ロール・ページのターゲット・ユーザーはときどき変化する場合があります。たとえば、元々製品開発チーム用に設計したページをセールス・チーム全体に表示する必要が生じる場合があります。マーケティング部門のページにパブリック・アクセス権限を指定する必要が生じる場合があります。選択した部門のメンバーにEdit Pages権限などの追加のアクセス権限を付与する必要が生じる場合があります。

注意:
システム管理者は、作成するビジネス・ロール・ページのアクセス権限を設定できます(詳細は、第51.4.1項「カスタム・ビジネス・ロール・ページのアクセス権限の設定」を参照)。
シードされたビジネス・ロール・ページのデフォルトのアクセス権限の設定は、WebCenter Portalのユーザー・インタフェースから変更できません(表51-1「シードされたビジネス・ロール・ページ」を参照)。シードされたビジネス・ロール・ページのアクセス権限を設定する方法の詳細は、第51.4.3項「シードされたビジネス・ロール・ページのアクセス権限の設定」を参照してください。

「ページのパーソナライズ」ページのページのアクセス権限を設定する制御はホーム・ポータルにあり、「ビジネス・ロール・ページ」ページのアクセス権限を設定する制御はWebCenter Portal管理にあります(図51-4)。

図51-4 カスタム・ビジネス・ロール・ページの「ページのアクセス権限の設定」オプション

この項では、ビジネス・ロール・ページの特定のアクセス権限の設定方法およびページをパブリックにする方法について説明します。次のサブセクションが含まれます:

- 第51.4.1項「カスタム・ビジネス・ロール・ページのアクセス権限の設定」

- 第51.4.2項「カスタム・ビジネス・ロール・ページへのパブリック・アクセス権限の付与」

- 第51.4.3項「シードされたビジネス・ロール・ページのアクセス権限の設定」

51.4.1 カスタム・ビジネス・ロール・ページのアクセス権限の設定

システム管理者は、作成するビジネス・ロール・ページのアクセス権限を設定できます。ただし、WebCenter Portal管理のユーザー・インタフェースを使用して、シードされたビジネス・ロール・ページのアクセス権限を設定することはできません(シードされたビジネス・ロール・ページへのアクセス権限の設定の詳細は、第51.4.3項「シードされたビジネス・ロール・ページのアクセス権限の設定」を参照)。

作成したカスタム・ビジネス・ロール・ページのターゲット・ユーザーを指定するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。
ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/businessrolepages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. アクセス権限を設定しているカスタム・ビジネス・ロール・ページの「アクション」アイコンを選択してクリックし、「ページのアクセス権限の設定」を選択して「ページのアクセス権限の設定」ダイアログを開きます(図51-5)。

図51-5 「ページのアクセス権限の設定」ダイアログ

ロールauthenticated-role(WebCenter Portalにログインしているユーザー)が「ロールまたはユーザー」の下に追加されます。

3. すべてのパブリック・ユーザー(ログインしなかったユーザーおよびログインしていたユーザー)にアクセス権限を付与するには、「パブリック・アクセス権限の追加」をクリックします。
ロールanonymous-roleが「ロールまたはユーザー」の下に追加されます。

関連項目:
ビジネス・ロール・ページへのパブリック・アクセス権限を有効にするこの方法は、表示アクセス権限に加えてその他の権限をパブリック・ユーザーに付与する方法を提供します。このようなユーザーに表示アクセス権限のみを付与するには、第51.4.2項「カスタム・ビジネス・ロール・ページへのパブリック・アクセス権限の付与」の手順に従って、これを素早く設定できます。

4. 選択したユーザー、グループおよびアプリケーション・ロールにアクセス権限を付与するには、「アクセス権限の追加」をクリックします。
「アクセス権限の追加」ダイアログが開きます(図51-6)。

図51-6 「アクセス権限の追加」ダイアログ

5. ホーム・ポータルでこのビジネス・ロール・ページを公開するユーザー、グループおよびアプリケーション・ロールを特定します。
選択可能なすべてのユーザー、グループおよびアプリケーション・ロールから選択します。検索機能を使用してアイデンティティ・ストアを検索します。

1. 「検索」フィールドに、ユーザー、グループまたはアプリケーション・ロールの検索語を入力します。アイデンティティ・ストアの検索のヒントは、『Oracle WebCenter Portalでのポータルの構築』のアイデンティティ・ストアでのユーザーまたはグループの検索に関する項を参照してください。

ヒント:
この検索は大/小文字を区別しません。

2. 「検索」アイコンをクリックします。
検索条件と一致するユーザー、グループおよびアプリケーション・ロールが、「ユーザーの追加」ダイアログに表示されます。

3. リストから1つ以上の名前を選択します。
複数のユーザーを選択するにはCtrl+Clickを押します。

4. 「選択」をクリックします。
選択結果が、「ページのアクセス権限の設定」ダイアログに表示されます。デフォルトでは、選択したユーザーには「ページの表示」権限が付与されます。

6. ユーザー名、グループまたはアプリケーション・ロールそれぞれに対して、1つ以上のチェック・ボックスを選択してページの権限を付与します。

- ページの表示 - ユーザーはページを表示できますが、ページに対するアクションを実行できません。

- ページの編集 - ユーザーはページを編集できます。これには、コンテンツの追加、並べ替えおよび削除、ならびにページ・スキームの変更が含まれます。

- ページの削除 - ユーザーはページを削除できます。

- すべてのページ・アクションの実行 - ユーザーにはページに対する完全なアクセス権限があります。これらのユーザーは、ページの編集、ページ・レイアウトの改訂、他のユーザーに対する追加のアクセス権限の設定およびその他のすべてのページ権限の設定を実行できます。

- ページのパーソナライズ - ユーザーはページの個人用ビューを変更できます。このような変更は、ページの他のユーザーのビューには影響しません。

- ページへのアクセス権限を取り消すには、ユーザーまたはロールを選択し、「アクセス権限の削除」をクリックします。

ヒント:
権限を取り消すには、チェック・ボックスを選択解除します。

7. 「OK」をクリックして、変更を保存します。
このページは、ターゲット・ユーザーが次回WebCenter Portalにログインしたときにホーム・ポータルのビューに表示されます。

51.4.2 カスタム・ビジネス・ロール・ページへのパブリック・アクセス権限の付与

任意のユーザー(ログインしているかしていないかは不問)が、特定のカスタム・ビジネス・ロール・ページを表示できるように指定できます。このようなページをパブリック・ホーム・ポータルに公開できます。またはURLをパブリック・ビジネス・ロール・ページに公開し、すべてのユーザーが簡単にアクセスできるようにすることができます。

関連項目:
この項で説明するプロセスでは、すべてのパブリック・ユーザーが、選択したカスタム・ビジネス・ロール・ページを表示できます。パブリック・ユーザーにページに関する追加の権限を付与するには、第51.4.3項 「シードされたビジネス・ロール・ページのアクセス権限の設定」で説明されている手順に従います。

カスタム・ビジネス・ロール・ページをパブリックにするには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。
ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/businessrolepages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. アクセス権限を設定しているビジネス・ロール・ページの「アクション」アイコンをクリックし、「パブリックにする」を選択します(図51-7)。

図51-7 カスタム・ビジネス・ロール・ページの「パブリックにする」オプション

51.4.3 シードされたビジネス・ロール・ページのアクセス権限の設定

初期設定のビジネス・ロール・ページ(「アクティビティ」や「ポータル」など)は、デフォルトではすべてのユーザーが使用できます(表51-1「シードされたビジネス・ロール・ページ」を参照)。WebCenter Portalを使用してシードされたビジネス・ロール・ページのセキュリティを変更することはできません。デフォルトのセキュリティ設定を変更する場合、たとえばシードされたビジネス・ロール・ページをすべてのユーザーに対して非表示にする場合、pages.xmlファイル内のデフォルトのビジネス・ロール・ページの設定を変更し、WLSTコマンドexportMetadata /importMetadataを使用してWebCenter Portalが使用するMDSリポジトリに変更をアップロードする必要があります。

シードされたビジネス・ロール・ページのデフォルトのセキュリティ設定を変更するには:

1. WLSTコマンドexportMetadataを実行して、ユーザー・ロールanonymous-roleおよびauthenticated-roleに対してpages.xmlをエクスポートします。
例:

exportMetadata(application='webcenter',server='WC_Spaces',toLocation='/scratch/mdsdump', docs='/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/role/anonymous-role/pages.xml')

exportMetadata(application='webcenter',server='WC_Spaces',toLocation='/scratch/mdsdump', docs='/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/role/authenticated-role/pages.xml')

ここで、toLocationはエクスポートするファイルのシステム上のターゲット・ディレクトリを指定します。構文の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のexportMetadataに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

2. 両方のpages.xmlファイルのセキュリティを必要に応じて変更します。つまり、各ビジネス・ロール・ページを非表示または表示にマークします。

<!-- Business Role Pages -->
<pageDef id="Page_2eb852ac_10f5902cb2f__7ff7"
contentMRef="/oracle/webcenter/page/scopedMD/
s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/
ActivityStreamMainView.jspx" shared="true" hidden="true"/>...

<pageDef id="Page_2eb852ac_10f5902cb2f__7ff7"
contentMRef="/oracle/webcenter/page/scopedMD/
s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/
ASpaceTemplatesMainView.jspx" shared="true" hidden="false"/>...

<pageDef id="Page_2eb852ac_10f5902cb2f__7ff7"
contentMRef="/oracle/webcenter/page/scopedMD/
s8bba98ff_4cbb_40b8_beee_296c916a23ed/businessRolePages/
MyProfileMainView.jspx" shared="true" hidden="true"/>...

- 非表示にするページに対してhidden="true"を設定します。

- 表示するページに対してhidden="false"を設定します。

3. WLSTコマンドimportMetadataを使用して、pages.xmlファイルに対する変更をMDSにアップロードします。
例:

importMetadata(application='webcenter',server='WC_Spaces',fromLocation='/scratch/mdsdump', docs='/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/role/anonymous-role/pages.xml')
importMetadata(application='webcenter',server='WC_Spaces',fromLocation='/scratch/mdsdump', docs='/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/role/authenticated-role/pages.xml')

ここで、fromLocationはインポートするファイルを含むディレクトリを指定します。構文の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のimportMetadataに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:
デフォルトでは、任意の認証されたユーザー・ロールまたは匿名ユーザー・ロールは、「アクティビティ・ストリーム」ページを表示できません(ここで例として使用)。ただし、ユーザーは、WebCenter Portalにログインしている場合、「ページのパーソナライズ」ページからこの設定をオーバーライドし、「ページを表示」オプションを使用してページを表示できます。このユーザー・カスタマイズは、/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/user/<GUID of user>/pages.xmlとしてMDSにも格納されます。
<GUID of user>は、表WC_AS_ACTOR_DETAIL.ACTOR_IDから問合せできます。

MDS内のこのpages.xmlファイルを削除すると、/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/role/authenticated-role/pages.xmlの設定機能に戻ります。

51.5 カスタム・ビジネス・ロール・ページへのアクセス権限の取消し

カスタム・ビジネス・ロール・ページへのアクセス権限を取り消すには:

1. 第51.4.1項「カスタム・ビジネス・ロール・ページのアクセス権限の設定」の手順に従い、「ページのアクセス権限の設定」ダイアログを開きます。

2. 「ロールまたはユーザー」から、アクセス権限を取り消すユーザー、グループまたはアプリケーション・ロールがある行を選択し、「アクセス権限の削除」をクリックします(図51-8)。

図51-8 「ページのアクセス権限の設定」ダイアログの「アクセス権限の削除」オプション

3. 確認ダイアログで「削除」をクリックします。

51.6 ビジネス・ロール・ページへのナビゲーションの提供

ユーザーにビジネス・ロール・ページへのナビゲーションを提供するオプションには次のものがあります。

- 第51.6.1項「ビジネス・ロール・ページの表示および非表示」で説明されているように、「ページを表示」チェック・ボックスを使用して、1つの手順ですべての認可されたユーザーにページを表示できます。

- 第51.6.2項「ビジネス・ロール・ページへのナビゲーションの作成」で説明されているように、ビジネス・ロール・ページへのナビゲーション・リンクを作成します。

51.6.1 ビジネス・ロール・ページの表示および非表示

ホーム・ポータル・ナビゲーションでビジネス・ロール・ページを表示または非表示にするには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。
ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/businessrolepages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 表示または非表示にするページで次の手順を実行します(図51-9)。

- 「ページを表示」列のチェック・ボックスを選択し、認可されたユーザーのホーム・ポータル・ビューのページを表示します。

- 「ページを表示」列のチェック・ボックスを選択解除し、ビューのページを非表示にします。

図51-9 ビジネス・ロール・ページの「ページを表示」オプション

51.6.2 ビジネス・ロール・ページへのナビゲーションの作成

ユーザーがページ権限を使用してビジネス・ロール・ページを使用できるようにした後、そのページへのリンクをホーム・ポータル・ナビゲーションに含めることによってアクセスしやすくすることもできます。このプロセスは、『Oracle WebCenter Portalでのポータルの構築』のナビゲーション・モデルへのリソースの追加に関する項で説明しています。

51.7 ビジネス・ロール・ページのデフォルトの表示順の設定

ビジネス・ロール・ページを論理的な順序で表示すると、ページのコンテンツにアクセスしやすくなり、ユーザーをナビゲートしやすくなります。WebCenter Portalシステム管理者は、ビジネス・ロール・ページがその意図するユーザーに表示されるように初期順序を決定できます。これを実行するには、ページをドラッグ・アンド・ドロップして目的の順序にするか、または「並替え」アイコンをクリックします。

個々のユーザーは、ホーム・ポータルの「ページのパーソナライズ」ページで指定した初期表示順序を変更できます。また、使用しないビジネス・ロール・ページを非表示にできます。

注意:
ページの順序と表示/非表示を定義する場所は2箇所あります。WebCenter Portal管理(ここで説明)と「ページのパーソナライズ」ページ(『Oracle WebCenter Portalの使用』のホーム・ポータルのページ順の並替えに関する項で説明)です。2つの違いは、管理の変更はアプリケーションのカスタマイズであり、「ページのパーソナライズ」の変更はユーザー・カスタマイズであることです。ユーザー・カスタマイズは、該当するユーザーのビューではアプリケーションのカスタマイズより優先されます。

ビジネス・ロール・ページの表示順を変更するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。
ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/businessrolepages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. ビジネス・ロール・ページを選択し、「並替え」列の矢印をクリックし、表示順を変更します(図51-10)。

図51-10 ビジネス・ロール・ページの「並替え」アイコン

かわりに、ページをドラッグ・アンド・ドロップして目的の順序にできます。

51.8 ビジネス・ロール・ページの編集

ビジネス・ロール・ページのEdit Page権限を付与されたユーザーであれば誰でもそのページを編集できます。これらのユーザーにとって、編集プロセスは通常のページと同じです(詳細は、『Oracle WebCenter Portalでのポータルの構築』のページの編集に関する項および『Oracle WebCenter Portalの使用』の個人用ページの編集に関する項を参照)。

WebCenter Portalシステム管理者は、「管理」ページからビジネス・ロール・ページの編集を開始することも可能です。

ビジネス・ロール・ページを編集するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。
ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/businessrolepages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. ページを選択し、編集するページの「アクション」アイコンをクリックし、「ページの編集」を選択します(図51-11)。

図51-11 カスタム・ビジネス・ロール・ページの「編集」オプション

コンポーザでページが編集モードで開きます。コンポーザでのページの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページの編集に関する項を参照してください。

3. ページを編集し、「保存」、「閉じる」の順にクリックして終了します。

51.9 ビジネス・ロール・ページのソースの編集

コンポーザでページを開かずにビジネス・ロール・ページのソースを編集できます。

ビジネス・ロール・ページのソースを編集するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。
ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/businessrolepages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. ソースを編集するカスタム・ページの「アクション」アイコンをクリックし、「ソースの編集」ページを選択します(図51-12)。

図51-12 カスタム・ビジネス・ロール・ページの「ソースの編集」オプション

「ソースの編集」ダイアログが開きます(図51-13)。

図51-13 「ソースの編集」ダイアログ

3. 必要に応じてページのソースを編集します。
ページのソースの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページのソース・コードの表示および変更に関する項を参照してください。

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

51.10 ビジネス・ロール・ページのコピー

ビジネス・ロール・ページをコピーすると、これを別のビジネス・ロール・ページとして保存したり、ホーム・ポータルのビューに個人用ページとして保存したりできます。別のビジネス・ロール・ページをコピーする場合、アクセス権限は元のページからコピーされないため、その新しいページについてアクセス権限を設定する必要があります(詳細は、第51.4項「ビジネス・ロール・ページのターゲット・ユーザーの指定」を参照)。カスタム・ビジネス・ロール・ページはコピーできません。

シードされたビジネス・ロール・ページをコピーするには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。
ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/businessrolepages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. ページを選択し、コピーするページの「アクション」アイコンをクリックし、「ページのコピー」を選択します(図51-14)。

図51-14 シードされたビジネス・ロール・ページの「ページのコピー」オプション

3. 「ページのコピー」ダイアログで、新しいページの名前を入力します(図51-15)。

図51-15 「ページのコピー」ダイアログ

4. 「名前を付けてコピー」の横で、コピーが個人用ページかビジネス・ロール・ページかを指定します。

- コピーを同じジョブ・ロールの人のグループに公開する場合、「ビジネス・ロール・ページ」を選択します。

- 自分のビューにのみコピーを公開(つまり、ホーム・ポータルのビューに個人用ページとして公開)する場合、「個人用ページ」を選択します。

5. 「OK」をクリックします。
コンポーザでページが編集モードで開きます。コンポーザでのページの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページの編集に関する項を参照してください。

6. 必要に応じてページを編集し、「保存」をクリックして終了します。

51.11 ビジネス・ロール・ページからのすべてのユーザー・カスタマイズの削除

選択したビジネス・ロール・ページから、すべてのユーザー・カスタマイズを削除する制御を使用できます。この制御を使用すると、タスク・フローの並べ替え、サイズ変更、折りたたみなどの個人の変更が削除されます。これは、ビジネス・ロール・ページのユーザーごとの個人用ビューで実行します。

ビジネス・ロール・ページのすべてのビューからすべてのユーザー・カスタマイズを削除するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。
ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/businessrolepages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. ターゲット・ページの横の「アクション」メニューから「パーソナライズの削除」を選択します。

3. 結果として表示される確認ダイアログで、「OK」をクリックします。
ユーザーによってページの自分のビューに追加されたすべてのユーザー・カスタマイズが削除されます。つまり、タスク・フローが元の位置に戻って、元のサイズになったり、折りたたまれていたタスク・フローが開いたりします。

51.12 カスタム・ビジネス・ロール・ページの削除

カスタム・ビジネス・ロール・ページのDelete Page権限を付与されたユーザーであれば誰でもそのページを削除できます。これらのユーザーにとって、このプロセスは通常のページの削除と同じです(詳細は、『Oracle WebCenter Portalでのポータルの構築』のページの削除に関する項を参照)。WebCenter Portalシステム管理者は、カスタム・ビジネス・ロール・ページを「管理」ページから削除することも可能です。

注意:
シードされたビジネス・ロール・ページ(表51-1「シードされたビジネス・ロール・ページ」を参照)は、システム管理者でも削除できません。

カスタム・ビジネス・ロール・ページをWebCenter Portalから削除すると、これをリカバリすることはできません。削除したページは永続的に削除され、このページに以前割り当てられたユーザーは、ホーム・ポータルのビューにこれを表示できなくなります。

カスタム・ビジネス・ロール・ページを削除するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。
ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/businessrolepages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 削除するページの「アクション」アイコンをクリックし、「ページの削除」を選択します(図51-16)。

図51-16 カスタム・ビジネス・ロール・ページの「ページの削除」オプション

3. 確認ダイアログで、「削除」をクリックします。

52 個人用ページの管理

この章では、WebCenter Portalで個人用ページを管理する方法について説明します。個人用ページのコンテンツを管理する責任は主として個人にありますが、WebCenter Portalシステム管理者もデフォルトではすべての個人用ページにアクセスできます。システム管理者は、個人用データの所有者が個人用ページに関して問題を抱えた場合や組織を去った場合に個人用データのクリーンアップや管理を行う必要がある場合があります。

この章には次のトピックが含まれます:

- 第52.1項「個人用ページの管理について」

- 第52.2項「個人用ページのためのアプリケーションレベルのページ作成のデフォルトの設定」

- 第52.3項「個人用ページのアクセス権限の変更」

- 第52.4項「ユーザーによる個人用ページの作成の防止」

- 第52.5項「個人用ページへのナビゲーションの提供」

- 第52.6項「管理権限を使用した個人用ページの編集」

- 第52.7項「個人用ページのソースの編集」

- 第52.8項「個人用ページのコピー」

- 第52.9項「個人用ページからのすべてのユーザー・カスタマイズの削除」

- 第52.10項「ポータル管理ページを使用した個人用ページの削除」

権限:
この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server-Manage Configuration

さらに、ポータルの作成および管理の権限(Portals-Create PortalsおよびPortals-Manage Security and Configurationまたはどちらか一方)が必要です。権限の詳細は、第49.3項「アプリケーション・ロールおよび権限について」を参照してください。

52.1 個人用ページの管理について

個人用ページは、ユーザーがホーム・ポータルの個人用ビューに作成するページです。WebCenter Portalシステム管理者は、他のユーザーが作成したすべての個人用ページに対する完全なアクセス権限を持っています。完全なアクセス権限とは、任意のユーザーの個人用ページに対して編集、コピー、名前の変更、アクセス権限の設定、削除などのアクションを実行できることを意味します。

システム管理者は、すべての人の個人用ページに、一元的な場所である「管理」ページからアクセスできます。「個人用ページ」サブページでは、ページの作成者および最終変更日時に関する情報を含む個人用ページのリストにアクセスできます。

「アクション」メニューはリストされたそれぞれのページに関連付けられ、コンポーザでの編集、ユーザー・カスタマイズの削除、コピー、名前変更、保護、ソースの編集、削除および個人用ページのパブリック化のオプションにアクセスできます(図52-1)。

図52-1 個人用ページのページの「アクション」メニュー

その他のオプションには、ページへのリンクを含むメール・メッセージの送信やページに関する情報の表示があります。

52.2 個人用ページのためのアプリケーションレベルのページ作成のデフォルトの設定

認可されたユーザーが自分用に設定できるページ作成のデフォルト(『Oracle WebCenter Portalの使用』の個人用ページのためのページ作成のデフォルトの設定に関する項を参照)に加えて、システム管理者は個人用ページのためにアプリケーションレベルのページ作成のデフォルトを設定できます。ページ作成のデフォルトを構成した後、アプリケーションレベルのページ作成のデフォルトは、すべての個人用ページの作成に影響します。この制御(「ページ・デフォルトの設定」)は、WebCenter Portal管理の「ビジネス・ロール・ページ」で使用できます(詳細は、第51.2項「ビジネス・ロール・ページのためのページ作成のデフォルトの設定」を参照)。

注意:
ホーム・ポータルの「ページのパーソナライズ」ページを使用して認可されたユーザーが設定したページ作成のデフォルトは、この章で説明するアプリケーションレベルの設定より優先されます。

52.3 個人用ページのアクセス権限の変更

システム管理者は、すべての個人用ページを表示および管理する権限があります。通常ページの所有者は、ページを表示できる人を決定できますが、システム管理者は、他のユーザーが作成した個人用ページすべてにデフォルトでアクセスできます。

個人用ページのアクセス権限を変更するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「個人用ページ」をクリックします。
ブラウザに次のURLを入力して直接「個人用ページ」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/personalpages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 保護するページの「アクション」アイコンをクリックし、「ページのアクセス権限の設定」を選択します(図52-1を参照)。
「ページのアクセス権限の設定」ダイアログが開きます(図52-2を参照)。

図52-2 「ページのアクセス権限の設定」ダイアログ

3. 認証されたユーザーに対してアクセス権限を設定するには、「認証済アクセス権限の追加」をクリックします。
ロールauthenticated-roleが「ロールまたはユーザー」の下に追加されます(図52-3)。これを使用して、アクセス権限をWebCenter Portalにログインしているすべてのユーザーに設定します。

図52-3 認証されたロールのアクセス権限

新しく追加されたロールには「表示」アクセス権限のみがあることに注意してください。その他の権限をユーザー・ロールに適切に設定します。

4. パブリック・ユーザーに対してアクセス権限を設定するには、「パブリック・アクセス権限の追加」をクリックします。
ロールanonymous-roleが「ロールまたはユーザー」の下に追加されます(図52-4)。これを使用して、アクセス権限をWebCenter Portalにログインしていないすべてのユーザーに設定します。

図52-4 匿名ロールのアクセス権限

新しく追加されたロールには「表示」アクセス権限のみがあることに注意してください。その他の権限をユーザー・ロールに適切に設定します。匿名ロールは「表示」アクセス権限のみのままにしておくことをお薦めします。

5. その他のユーザーおよびロールへのアクセス権限を付与するには、「アクセス権限の追加」をクリックし、「アクセス権限の追加」ダイアログを開きます(図52-5)。

図52-5 「アクセス権限の追加」ダイアログ

6. このページにアクセスできるユーザーを特定します。
選択可能なすべてのユーザー、グループおよびアプリケーション・ロールから選択します。検索機能を使用してアイデンティティ・ストアを検索します。

1. 「検索」フィールドで、2文字以上入力し、「検索」アイコンをクリックします。アイデンティティ・ストアの検索のヒントは、『Oracle WebCenter Portalでのポータルの構築』のアイデンティティ・ストアでのユーザーまたはグループの検索に関する項を参照してください。

ヒント:
この検索は大/小文字を区別しません。

検索条件と一致するユーザー、グループおよびロールが、「アクセス権限の追加」ダイアログに表示されます。

2. リストから1つ以上の名前を選択します。
複数のユーザーを選択するにはCtrl+Clickを押します。

3. 「選択」をクリックします。
選択したユーザーおよびグループが、「ページのアクセス権限の設定」ダイアログに表示されます。デフォルトでは、ユーザーにはページに対する「ページの表示」権限があります。その他の権限を適切に設定します。

7. 現在のユーザーまたはロールに割り当てられた権限を変更するには、1つ以上のチェック・ボックスを選択し、ページの権限を付与します。

- ページの表示 - 選択したユーザーまたはロールはページにアクセスして表示できますが、ページに対するアクションを実行できません。

- ページの編集 - 選択したユーザーまたはロールはページを編集できます。これには、コンテンツの追加、並べ替えおよび削除が含まれます。

- ページの削除 - 選択したユーザーまたはロールはページを削除できます。

- すべてのページ・アクションの実行 - 選択したユーザーまたはロールにはページに対する完全なアクセス権限があります。ユーザーは、ページの編集、ページ・レイアウトの改訂、他のユーザーに対する追加のアクセス権限の設定およびその他のすべてのページ権限の設定を実行できます。

- ページのパーソナライズ - 選択したユーザーまたはロールはページをパーソナライズできます。パーソナライズとは、表示モードでのページに対して行われた変更です。このような変更は、ページの他のユーザーのビューには影響しません。

ヒント:
同じ手順を実行し、リストされたユーザーまたはロールに対する1つ以上の権限を選択解除することによって権限を取り消すことができます。

- ページへのアクセス権限を取り消すには、ユーザーまたはロールを選択し、「アクセス権限の削除」をクリックします。

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

52.4 ユーザーによる個人用ページの作成の防止

アプリケーションレベルの権限Create-Pagesを取り消して、ユーザーがホーム・ポータルに個人用ページを作成できないようにすることができます。アプリケーションレベルの権限Create-Pagesは、個人用ページの作成に対してのみ適用されます。ポータルにページを作成することは、そのポータル独自のセキュリティ設定によって制御されます(ポータルのセキュリティ設定、つまりポータルレベルのユーザーおよびロールの詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルでのメンバーの管理およびロールの割当てに関する項を参照してください。)

アプリケーションレベルの権限を取り消すプロセスは、『Oracle WebCenter Portalでのポータルの構築』のポータル・ロールの権限の表示および編集に関する項で説明しています。

52.5 個人用ページへのナビゲーションの提供

ポータルのナビゲーションで個人用ページへのリンクを追加する場合、『Oracle WebCenter Portalでのポータルの構築』のナビゲーション・モデルへのリソースの追加に関する項を参照してください。WebCenter Portalナビゲーションでの作業の詳細は、『Oracle WebCenter Portalでのポータルの構築』のナビゲーションでの作業に関する章を参照してください。

52.6 管理権限を使用した個人用ページの編集

システム管理者は、ユーザーがホーム・ポータルのビューに作成した個人用ページを表示および変更する権限があります。個人用ページのコンテンツの編集は主に個人が行いますが、システム管理者がそのようなコンテンツを編集する必要がある場合があります。第52.7項「個人用ページのソースの編集」も参照してください。

個人用ページを編集するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「個人用ページ」をクリックします。
ブラウザに次のURLを入力して直接「個人用ページ」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/personalpages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 編集するページの「アクション」アイコンをクリックし、「ページの編集」を選択します(図52-1を参照)。
コンポーザでページが開きます。

関連項目:
コンポーザを使用したページの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページの編集に関する項を参照してください。

3. ページを更新し、「保存」、「閉じる」の順にクリックして終了します。

52.7 個人用ページのソースの編集

コンポーザでページを開かずに個人用ページのソースを編集できます。

個人用ページのソースを編集するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「個人用ページ」をクリックします。
ブラウザに次のURLを入力して直接「個人用ページ」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/personalpages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. ソースを編集するページの「アクション」アイコンをクリックし、「ソースの編集」ページを選択します(図52-8)。

図52-6 ページの「アクション」メニューの「ソースの編集」オプション

「ソースの編集」ダイアログが開きます(図52-9)。

図52-7 「ソースの編集」ダイアログ

3. 必要に応じてページのソースを編集します。
ページのソースの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページのソース・コードの表示および変更に関する項を参照してください。

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

52.8 個人用ページのコピー

システム管理者は、WebCenter Portalの任意のページをコピーする権限があります。これには、他のユーザーが作成した個人用ページのコピーも含まれます。管理者として個人用ページをコピーするとき、これをビジネス・ロール・ページとして保存して他のユーザーにプッシュしたり、ホーム・ポータルの独自のビューに個人用ページとして保存したりできます。

ヒント:
別のビジネス・ロール・ページを作成する場合、アクセス権限は元のページからコピーされないため、その新しいページについてアクセス権限を設定する必要があります。詳細は、第51.4項「ビジネス・ロール・ページのターゲット・ユーザーの指定」を参照してください。

個人用ページをコピーするには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「個人用ページ」をクリックします。
ブラウザに次のURLを入力して直接「個人用ページ」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/personalpages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. コピーするページの「アクション」アイコンをクリックし、「ページのコピー」を選択します(図52-8)。

図52-8 ページの「アクション」メニューの「ページのコピー」オプション

「ページのコピー」ダイアログが開きます(図52-9)。

図52-9 「ページのコピー」ダイアログ

3. 新しいページの名前を入力します。

4. 「名前を付けてコピー」の横で、コピーが個人用ページかビジネス・ロール・ページかを指定します。

- 同じジョブ機能を持つ人のグループまたは同じエンタープライズ・グループに属する人がページを使用できるようにする場合、「ビジネス・ロール・ページ」を選択します。

- 自分のビューのみにコピーを公開する場合、「個人用ページ」を選択します。

ページのコピーの詳細は、『Oracle WebCenter Portalでのポータルの構築』のページのコピーに関する項を参照してください。

5. 「OK」をクリックします。
コンポーザで新しいページが編集モードで開きます。

関連項目:
コンポーザを使用したページの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページの編集に関する項を参照してください。

6. 必要に応じてページを更新し、「保存」、「閉じる」の順にクリックしてコンポーザを終了します。

52.9 個人用ページからのすべてのユーザー・カスタマイズの削除

選択した個人用ページからすべてのユーザー・カスタマイズを削除する制御を使用できます。この制御を使用すると、タスク・フローの並べ替え、サイズ変更、折りたたみなどの個人の変更が削除されます。この変更は、ページの各ユーザーの個人用ビューに影響します。

個人用ページのすべてのビューからすべてのユーザー・カスタマイズを削除するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「個人用ページ」をクリックします。
ブラウザに次のURLを入力して直接「個人用ページ」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/personalpages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. ターゲット・ページの横の「アクション」アイコンをクリックし、「パーソナライズの削除」を選択します(図52-10)。

図52-10 ページの「アクション」メニューの「パーソナライズの削除」オプション

3. 結果として表示されるダイアログで、「OK」をクリックします。
ページのユーザー独自のビューにユーザーによって追加されたすべてのユーザー・カスタマイズが削除されます。つまり、タスク・フローが元の位置に戻って元のサイズになったり、折りたたまれていたタスク・フローが開いたりします

52.10 ポータル管理ページを使用した個人用ページの削除

他のユーザーが作成した個人用ページに対する完全なアクセス権限に加えて、WebCenter Portalシステム管理者は必要に応じてこれらを削除することも可能です。

注意:
個人用ページを削除すると、これをリカバリすることはできません。

個人用ページを削除するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「個人用ページ」をクリックします。
ブラウザに次のURLを入力して直接「個人用ページ」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/administration/personalpages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 削除するページの「アクション」アイコンをクリックし、「ページの削除」を選択します(図52-11)。

図52-11 ページの「アクション」メニューの「ページの削除」オプション

3. 確認ダイアログで、「削除」をクリックします。
ページの削除の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページの削除に関する項を参照してください。

53 デバイス設定の管理

この章では、WebCenter Portalでデバイス設定を管理する方法について説明します。デバイス設定を使用すると、デスクトップのブラウザ、スマートフォン、タブレットなど様々なデバイスでポータルがレンダリングする方法を制御できます。

この章の内容は次のとおりです。

- 第53.1項「デバイス設定について」

- 第53.2項「デバイスの作成および管理」

- 第53.3項「デバイス・グループの作成および管理」

- 第53.4項「デバイスおよびデバイス・グループのライフ・サイクルの管理」

- 第53.5項「デバイスのプレビュー」

- 第53.6項「デバイス設定のガイドラインおよびベスト・プラクティス」

- 第53.7項「デバイス属性の検出: サンプル・タスク・フロー」

権限:
この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server-Manage Configuration

権限の詳細は、第49.3項「アプリケーション・ロールおよび権限について」を参照してください。

53.1 デバイス設定について

デバイス設定を正常に管理するには、この項で説明する概念に精通している必要があります。

- 第53.1.1項「デバイス設定の概要」

- 第53.1.2項「デバイスとは何か」

- 第53.1.3項「デバイス・グループとは何か」

- 第53.1.4項「その他の関連概念」

- 第53.1.5項「基本的なユースケース: 新しいデバイスのサポートの追加」

- 第53.1.6項「デバイス設定を適用する方法の理解」

53.1.1 デバイス設定の概要

エンタープライズ・ポータル・ユーザーは、スマートフォン、タブレット、デスクトップのブラウザなど様々なデバイスからポータルにアクセスします。デバイス設定および関係する機能を使用すると、ポータル・ページを様々なデバイスに正確にレンダリングする方法を制御できます。システム管理者は、新しいタイプのデバイスのサポートやポータル・ページを特定のデバイスにレンダリングする方法の変更や向上を求められる場合があります。

WebCenter Portalには、ある特定のリクエストがどのタイプのデバイスから送信されるのかを認識し、該当するデバイスにポータルを適切にレンダリングする機能があります。システム管理者は、デバイス設定を使用して、このデバイス認識を変更または調整するとともに、特定のデバイスまたはデバイス・クラスに関連付けるページ・テンプレートおよびスキンを指定します。これは、スキンとテンプレートを正確に割り当てる方法を制御するデバイス設定を通して行います。

初期設定でWebCenter Portalには、スマートフォン、タブレットまたはデスクトップのブラウザのような一般的なデバイス・クラスに合わせてレンダリングするように設計されているいくつかのページ・テンプレートが用意されています。これらのテンプレートをそのまま使用したり、必要に応じてこれらを変更したり、新しいものを作成したりできます。

システム管理者として、次の場合にデバイス設定の使用を検討します。

- 新しいデバイスまたはデバイス・クラスに対するレンダリングのサポートを追加する必要がある場合。

- デバイスまたはデバイス・クラスにポータル・ページをレンダリングする方法で問題が検出された場合。

- ポータル開発者がデバイス固有のページを作成し、これが検出されず、ターゲット・デバイスに表示されないことがわかった場合。

53.1.2 デバイスとは何か

デバイスとは、WebCenter Portalでは、スマートフォンやタブレットなどの、ユーザーがポータルとやり取りするために使用する物理的デバイスを意味します。ポータル・ページがリクエストされるたびに、WebCenter Portalはリクエスト元のデバイスのタイプを判断します。この情報によって、ポータルは、デバイスが関連付けられているデバイスのカテゴリつまり「デバイス・グループ」を判断できます。第53.1.3項「デバイス・グループとは何か」を参照してください。

WebCenter Portalには、iPhone、iPad、iPad mini、Samsung Galaxy Nexus、Samsung Galaxy Note 10.1など、すぐに使用できる多数の事前構成済のデバイスが付属しています。必要に応じて新しいデバイスを作成することも可能です。

図53-1に、「管理」ページにリストされたデフォルトのデバイスの一部を示します。

図53-1 管理者用デバイスのリスト

各デバイスには、3つの主要な特性(名前、表示名およびユーザー・エージェント文字列)があります。

- 名前: デバイスの一意の名前。特定のユースケースでは、この名前を使用することにより、式言語の式を使用して開発者がこれを検出することができます。

- 表示名: この名前は、ポータル・ビルダーのユーザー・インタフェースに表示されます。

- ユーザー・エージェント: リクエスト元のデバイスを識別するために使用する正規表現の文字列。たとえば、.*iPhone.+3G.+OS.+2_2.*などの表現は、iPhone 3Gの様々なバージョンに対応します。

注意:
ユーザー・エージェント文字列は正規表現であり、Javaプラットフォーム(java.util.regex.Pattern)によって指定された構文に準拠しています。したがって、ある特殊文字を照合する場合、これらに対してエスケープ文字を使用する必要がある場合があります。これらの文字には[\^$.|?*+()などがあり、場合によっては中括弧文字{}も含まれます。たとえば、丸括弧には、\(iPhone; CPU iPhone OS 5_0 like Mac OS X\)のようにエスケープ文字「\」を使用する必要があります。詳細は、正規表現構文に関する優れたリファレンスを読むことをお薦めします。

システム管理者は、新しいデバイスの作成および既存のものの管理を実行できます。たとえば、ユーザー・エージェント文字列を変更し、新しいバージョンのデバイスを正しく識別することが必要になる場合があります。または、必要に応じて新しいデバイスを作成することが必要になる場合があります。詳細は、第53.2項「デバイスの作成および管理」を参照してください。

53.1.3 デバイス・グループとは何か

デバイス・グループとは、同様の表示要件を共有する一連のデバイスを意味します。初期設定のWebCenter Portalには、デスクトップのブラウザ、iOSフォン、Androidフォン、iOSタブレット、Androidタブレットなどのいくつかの事前構成済デバイス・グループが付属しています。

デバイス・グループには適切なデバイスが含まれます。たとえば、iOSフォン・デバイス・グループには、iPhone、iPhone 3G、iPhone 3GS、iPhone 4、iPhone 4Sなどが含まれます。さらにデバイスを作成するとき、これらを既存のグループに追加したり、必要に応じて新しいグループを作成したりできます。

デバイス・グループの利点は、サポートされるデバイスごとに表示アセット(ページ・テンプレートおよびスキン)を構成する必要がないことです。そうではなく、複数の関連デバイスをグループに追加して、それらのデバイスが使用するアセットを指定できます。図53-2に、デバイス・グループの「管理」ページを示します。このページを使用すると、デバイス・グループに対して、作成、編集、コピー、アップロードなどの操作を実行できます。詳細は、第53.3項「デバイス・グループの作成および管理」を参照してください。

図53-2 デバイス・グループの「管理」ページ

53.1.4 その他の関連概念

次の機能はデバイス設定と関係があります。これらには、デフォルトのデバイス・グループ、ページ・バリアントおよびフォールバック・ページなどがあります。

- デフォルトのデバイス・グループ: 常に1つのデバイス・グループがデフォルトとして指定されます。初期設定では、デフォルトのデバイス・グループはデスクトップのブラウザです。つまり、デフォルトでは、新しいポータルのすべてのページはデスクトップのブラウザのデバイス・グループに関連付けられます。認識されていないデバイスからリクエストが来ると、ポータル・ページは、デフォルトのデバイス・グループ設定に従ってレンダリングされます。

注意:
ベース・ページは、常にデフォルトのデバイス・グループに属しているデバイスでレンダリングされます。

デフォルトのデバイス・グループは、ポータルのテンプレート機能と関連付けられています(ポータルのテンプレートは新しいポータルの基盤となるテンプレートです)。ポータルのテンプレートから作成されるポータルは、そのテンプレートのデフォルトのデバイス・グループを自動的に受け取ります。同様に、ポータルからポータルのテンプレートを作成する場合、そのポータルに関連付けられたデフォルトのデバイス・グループがテンプレートに配置されます。

使用するデバイス・グループをWebCenter Portalが選択する方法の詳細は、第53.1.6項「デバイス設定を適用する方法の理解」を参照してください。

- ページ・バリアント: ページ・バリアントとは、特定のデバイスで使用するために設計された、既存または「ベース」のページの代替ビューです。バリアントの派生元のベース・ページとページ・バリアント自体は、同じURI、セキュリティ設定、パラメータなどを持っていますが、これらは、ターゲット・デバイスに対して適切な特定のレンダリング特性を使用して設計されます。ページ・バリアントを作成するとき、これに関連付けるデバイス・グループおよびページ・スタイルを指定できます。
ページ・バリアントにはいくつかの使用法があります。会社のイントラネットのポータル・ページの1つが、特定のデバイスに対してエラーを返すことがわかったとします。たとえば、そのようなエラーが、フラッシュ・ビデオを含むページをAppleのデバイスでレンダリングするときに発生するとします。この場合、ページがAppleのデバイス用にリクエストされた場合のみ使用し、その他のデバイス用には使用しないようなページのバリアントを作成できます。この場合、バリアントには、おそらくフラッシュ・ビデオのかわりにイメージが含まれ、エラーは表示されなくなります。

ページ・バリアントは、通常、アプリケーションのスペシャリストによって作成されますが、管理者のみがシステム・ページのページ・バリアントを作成できます。たとえば、スマートフォンに適したログイン・ページ・バリアントを作成できます。

システム・ページのページ・バリアントの作成の詳細は、第50.2.2項「デバイス・グループ用システム・ページのページ・バリアントの作成」を参照してください。 ポータル・ページのページ・バリアントの作成の詳細は、『Oracle WebCenter Portalでのポータルの構築』のデバイス・グループのページ・バリアントの作成に関する項を参照してください。

- フォールバック・ページ: もう一つの関連概念はフォールバック・ページです。ページにページ・バリアントがない場合には、常にベース・ページがデフォルトでレンダリングされますが、この動作をオーバーライドしてこの状況でページを表示しないようにできます。

注意:
ページのフォールバック動作が、「ページを表示しない」に設定されている場合、(ナビゲーション・モデルで定義されているような)そのページへのナビゲーション・リンクはすべてビューで非表示になります。言い換えると、メッセージ「デバイスで使用できるページがありません」という結果になるすべてのナビゲーション・リンクは、ユーザーに表示されません。

個別ページまたはすべてのポータル・ページに対してフォールバックを設定できます。フォールバックの詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・バリアントが存在しない場合の特定ページのページ動作の設定に関する項を参照してください。

53.1.5 基本的なユースケース: 新しいデバイスのサポートの追加

ここでは、管理するポータルのデバイス設定で作業する必要がある場合に理解を助けるユースケースを説明します。

現在サポートしているタブレット・デバイスとは異なる画面解像度およびサイズを備えた新しいミニタブレットがリリースされたとします。実際に、ユーザーは、会社のイントラネット・ポータルがこのデバイスで正しくレンダリングされないこと、つまり、空白が多く、会社のロゴが正しく表示されないことに気付きます。この新しいデバイスのサポートを求められています。この場合、基本的な手順は次のようになります。

1. このデバイスがポータルに送信するユーザー・エージェント文字列を検出します。

2. 新しいデバイスのユーザー・エージェント文字列と一致するユーザー・エージェント文字列を持つ新しいデバイスを作成します。第53.2.1項「新しいデバイスの作成」を参照してください。

3. 同様のレンダリング特性を新しいデバイスと共有するすべてのデバイス用のデバイス・グループを作成します。この場合、デバイス・グループは、新しいタブレットと同様の表示特性を持つデバイスを保持することになります。第53.3.1項「デバイス・グループの作成」を参照してください。

4. 適切なスキンおよびページ・テンプレートをデバイス・グループに適用します。必要に応じて、新しいアセットを一から作成するか、または既存のものをコピーして変更します。

5. 新しいデバイスをデバイス・グループに追加します。

6. 新しいデバイスに関してポータルをテストし、正しくレンダリングされることを確認します。

7. 同様のミニタブレット・デバイスがリリースされた場合、同じグループに追加できます。

53.1.6 デバイス設定を適用する方法の理解

図53-3に、WebCenter Portalが複数の異なるデバイスからのリクエストを処理する方法のフローを説明します。

図53-3 ポータルが異なるデバイスからのリクエストを処理する方法

図53-3に示すように、リクエストがサーバーに送られると、リクエストのヘッダーにあるユーザー・エージェント文字列が調べられます。次に、WebCenter Portalは、そのユーザー・エージェント(正規表現の文字列)と一致するデバイスを探します。

ユーザー・エージェントが着信ユーザー・エージェントに潜在的にマップできるデバイスが複数定義されている場合、サーバーはリクエストを最適なデバイスにマップしようとします。最適なデバイスとは、そのユーザー・エージェントに最大限の一致が含まれるデバイスです。

デバイスが特定されると、WebCenter Portalは、これがデバイス・グループにあるかどうかを確認します。複数のグループに存在する場合、ポータルのデバイス・グループのリストの最初のものを使用します。第53.3.6項「デバイス・グループの順序付け」も参照してください。

デバイスが特定されない場合、WebCenter Portalは「デフォルトのデバイス・グループ」を現在のリクエストに割り当てます。

最後に、そのデバイス・グループに関連付けられた適切なスキン、ページ・テンプレートおよびページ・バリアント(存在する場合)が返され、ページがデバイスでレンダリングされます。ページにページ・バリアントがない場合、デフォルトではベース・ページがレンダリングされますが、この動作をオーバーライドしてこの状況でページを表示しないようにできます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・バリアントが存在しない場合のポータルのページ動作の設定に関する項を参照してください。

53.2 デバイスの作成および管理

この項では、デバイスの作成および管理方法について説明します。

- 第53.2.1項「新しいデバイスの作成」

- 第53.2.2項「デバイスの編集」

- 第53.2.3項「デバイスのコピー」

- 第53.2.4項「デバイスのリストのフィルタリング」

- 第53.2.5項「デバイスの削除」

注意:
場合によっては、「デバイス設定」ページでデバイス構成を追加または変更した後に、ページ・バリアントを表示できないことがあります。この場合、ログアウトしてからログインしてキャッシュをクリアします。その後、デバイスは正しく認識されます。

53.2.1 新しいデバイスの作成

新しいデバイスを作成するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「デバイス設定」をクリックします。
ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/administration/device

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デバイス」タブで、「作成」をクリックします。
「デバイス」、「オプション属性」および「追加属性」の3つのセクションを含む「デバイスの作成」ページが表示されます。

3. 「デバイス」セクションで、次の詳細を指定します。

- 名前: デバイスの名前。この名前は一意である必要があり、スペースを含めることはできません。この名前を使用することにより、式言語の式を使用してこれを検出することができます。

- 表示名: デバイスの表示名を指定します。この名前は一意である必要があり、ポータル・ビルダーのユーザー・インタフェースに表示されます。

- ユーザー・エージェント - ユーザー・エージェント文字列を指定します。WebCenter Portalは、リクエスト・ヘッダーで渡されたユーザー・エージェント文字列(ユーザーのデバイスから送信されたもの)と、このフィールドで指定された文字列とを比較して、デバイスを識別します。このパラメータは、リクエスト・ヘッダーとリテラル一致する必要はありません。正規表現として認識されるため、このフィールドには任意の有効な正規表現を入力できます。

注意:
ユーザー・エージェント文字列は正規表現であり、Javaプラットフォーム(java.util.regex.Pattern)によって指定された構文に準拠しています。したがって、ある特殊文字を照合する場合、これらに対してエスケープ文字を使用する必要がある場合があります。これらの文字には[\^$.|?*+()などがあり、場合によっては中括弧文字{}も含まれます。たとえば、丸括弧には、\(iPhone; CPU iPhone OS 5_0 like Mac OS X\)のようにエスケープ文字「\」を使用する必要があります。詳細は、正規表現構文に関する優れたリファレンスを読むことをお薦めします。

- 説明: (オプション)デバイスの目的を識別する際に役に立つ説明を指定します。

4. 表示解像度の高さや幅などの属性を管理するには、「オプション属性」セクションを使用します。図53-4に示すように、必要に応じてデフォルト値を編集できます。

注意:
オプション属性は、ポータルがデバイスでレンダリングされる方法に影響しません。これは、ページ設計者の役に立つようにデバイスの情報を指定する方法を提供するだけです。ポータルの設計者は、式言語を使用して、デバイス属性の値にアクセスできます。

図53-4 オプション属性の指定

5. 必要に応じて、属性を追加します。「追加属性」セクションで、「属性の追加」をクリックして、名前と値を指定します。

注意:
追加属性は、ポータルがデバイスでレンダリングされる方法に影響しません。これは、ページ設計者の役に立つようにデバイスの情報を指定する方法を提供するだけです。ポータルの設計者は、式言語を使用して、デバイス属性の値にアクセスできます。

6. 「作成」をクリックしてデバイスを作成します。

53.2.2 デバイスの編集

既存のデバイスを編集するには:

注意:
場合によっては、「デバイス設定」ページでデバイス構成を追加または変更した後に、ページ・バリアントを表示できないことがあります。この場合、ログアウトしてからログインしてキャッシュをクリアします。その後、デバイスは正しく認識されます。

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「デバイス設定」をクリックします。
ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/administration/device

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デバイス」タブで、編集するデバイスを選択し、「アクション」メニューをクリックして、「編集」を選択します。

3. デバイス設定を編集します。編集できるデバイス設定の詳細は、第53.2.1項「新しいデバイスの作成」を参照してください。

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

53.2.3 デバイスのコピー

デバイスのコピーの作成は次のことを行うときに便利です。

- デバイスのバックアップを作成するとき。

- デバイスを更新するが、元のものも使用できるように保持するとき。

- 新しいデバイスを作成する開始点として組込みのデバイスを使用するとき。

デバイス・グループをコピーするには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「デバイス設定」をクリックします。
ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/administration/device

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デバイス」タブで、コピーするデバイスを選択し、「アクション」メニューをクリックして、「コピー」を選択します。

3. 「コピー」ダイアログで、デバイスの名前、表示名、ユーザー・エージェントおよび説明を指定します。

4. 「OK」をクリックします。
コピーされたデバイスが「デバイス」リストに表示されます。

53.2.4 デバイスのリストのフィルタリング

「フィルタ」フィールドでは、「デバイス」表に表示されるデバイスのリストをフィルタできます。フィルタリングは、デバイス・グループ名、表示名、説明およびユーザー・エージェントに対して検索を行います。

53.2.5 デバイスの削除

作成またはコピーした任意のデバイスを削除できます。初期設定でシードされたデバイスはどれも削除できません。

デバイスを削除するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「デバイス設定」をクリックします。
ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/administration/device

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デバイス」タブをクリックします。

3. 削除するデバイスを選択します。(複数のデバイスを選択する場合、[Ctrl]キーを押しながらクリックします。)

注意:
削除できるのは、作成またはコピーしたデバイスのみです。WebCenter Portalに付属していた初期設定のデバイスは削除できません。

4. 「削除」をクリックします。

5. 「デバイスの削除」ダイアログでアクションを確認します。

53.3 デバイス・グループの作成および管理

デバイス・グループは、類似した表示要件を共有するデバイスの集合を表します。この項では、サポートするデバイス・グループの作成および管理方法について説明します。

- 第53.3.1項「デバイス・グループの作成」

- 第53.3.2項「デバイス・グループの編集」

- 第53.3.3項「デバイス・グループのコピー」

- 第53.3.4項「デバイス・グループの表示および非表示」

- 第53.3.5項「デフォルト・デバイス・グループの設定」

- 第53.3.6項「デバイス・グループの順序付け」

- 第53.3.7項「デバイス・グループのフィルタリング」

- 第53.3.8項「デバイス・グループの削除」

第53.1.5項「基本的なユースケース: 新しいデバイスのサポートの追加」も参照してください。

注意:
場合によっては、「デバイス設定」ページでデバイス構成を追加または変更した後に、ページ・バリアントを表示できないことがあります。この場合、ログアウトしてからログインしてキャッシュをクリアします。その後、デバイスは正しく認識されます。

53.3.1 デバイス・グループの作成

デバイス・グループを作成するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「デバイス設定」をクリックします。
ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/administration/device

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デバイス・グループ」タブで、「作成」をクリックします。
「デバイス・グループの作成」ページが表示されます(図53-5)。

3. 図53-5 デバイス・グループの作成

4. 新しいデバイス・グループの名前と表示名を指定します。名前は一意の名前にして、内部的に使用する必要があります。表示名は、ポータル・ビルダーに表示される名前です。この名前も一意の名前にする必要があります。

5. 「デバイス」セクションで、矢印を使用して、追加する使用可能なデバイスを「デバイス・グループ」リストに移動します。

6. 「アセット」セクションで、そのデバイス・グループで使用するページ・テンプレートとスキンを選択します。

注意:
アセットの横の「拡張編集オプション」矢印、「式ビルダー」を順にクリックし、EL式を「式エディタ」に入力します。ELを使用すると、スキンまたはテンプレートを動的に選択できます。ELのサポートが必要な場合は、開発者がEL式を指定できます。『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』の式言語式の付録を参照してください。

7. グループを作成するには、「作成」をクリックします。

53.3.2 デバイス・グループの編集

デバイス・グループの表示名の変更、デバイス・グループの目的を説明する説明の編集およびデバイス・グループに関連付けられたスキンおよびテンプレート(またはこれらのいずれか)の変更を実行できます。デバイス・グループを特定するために内部的に使用されるデバイス・グループの名前を変更することはできません。

デバイス・グループの基本的詳細を編集するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「デバイス設定」をクリックします。
ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/administration/device

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デバイス・グループ」タブで、編集するデバイス・グループを選択し、「アクション」メニューをクリックして、「編集」を選択します。

3. 「デバイス・グループの編集」ページで、デバイス・グループに必須の「表示名」を指定します。

4. 「説明」ボックスで、デバイス・グループが作成された目的を指定します。

5. 「アセット」セクションで、そのデバイス・グループで使用するページ・テンプレートとスキンを選択します。

注意:
アセットの横の「拡張編集オプション」矢印、「式ビルダー」を順にクリックし、EL式を「式エディタ」に入力します。ELを使用すると、スキンまたはテンプレートを動的に選択できます。ELのサポートが必要な場合は、開発者がEL式を指定できます。『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』の式言語式の付録を参照してください。

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

7. 「閉じる」をクリックして、「デバイス・グループの編集」ページを閉じます。

53.3.3 デバイス・グループのコピー

デバイス・グループのコピーを作成できます。これは次のことを行うときに便利です。

- デバイス・グループのバックアップを作成するとき。

- デバイス・グループを更新するが、元のものも使用できるように保持するとき。

- 新しいデバイス・グループを作成する開始点として組込みのデバイス・グループを使用するとき。

デバイス・グループのコピーを作成すると、元のデバイス・グループのステータスとは関係なくコピーは非表示としてマークされます。

デバイス・グループをコピーするには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「デバイス設定」をクリックします。
ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/administration/device

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デバイス・グループ」タブで、コピーするデバイス・グループを選択し、「アクション」メニューをクリックして、「コピー」を選択します。

3. 「コピー」ダイアログで、デバイス・グループの名前、表示名および説明を指定します(図53-6)。

図53-6 デバイス・グループのコピー

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

53.3.4 デバイス・グループの表示および非表示

デバイス・グループ(組込みかカスタム化は不問)はすべて、非表示または使用可能としてマークできます。デバイス・グループの名前の横のチェック・マークは、デバイス・グループが使用可能であることを示しています。チェック・ボックスが空の場合、デバイス・グループをポータルで使用できないことを示しています(図53-7)。この設定は、ページ・バリアントを作成するときに使用できる選択肢も制御します。デバイス・グループが非表示の場合、新しいページ・バリアントで使用するオプションとして表示されず、そのグループでページ・バリアントを作成できません。表示/非表示の設定は、「ポータル管理」設定から継承されますが、ポータル・モデレータによってポータル・レベルでオーバーライドできます。『Oracle WebCenter Portalでのポータルの構築』のデバイス・グループのページ・バリアントの作成に関する項も参照してください。

デフォルトでは、デバイス・グループを作成するとき、これは使用不可としてマークされます。

図53-7 使用可能なデバイス・グループおよび非表示のデバイス・グループ

デバイス・グループを表示または非表示にするには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「デバイス設定」をクリックします。
ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/administration/device

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デバイス・グループ」タブの「使用可能」列で、「使用可能」列のチェック・ボックスを選択または選択解除して、デバイス・グループを表示または非表示にします。

53.3.5 デフォルトのデバイス・グループの設定

デスクトップのブラウザという名前の組込みデバイス・グループは、WebCenter Portalのデフォルトのデバイス・グループです。作成するすべての新しいページは、デフォルトのデバイス・グループに自動的に関連付けられます。

「デバイス・グループ」タブで、Defaultは、デフォルトとして設定されているデバイス・グループの横に表示されます。

デバイス・グループをデフォルトとして設定するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「デバイス設定」をクリックします。
ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/administration/device

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デバイス・グループ」タブで、デフォルトとして指定するデバイス・グループを選択し、「アクション」メニューをクリックして、「デフォルトとして設定」を選択します。
Defaultが選択したデバイス・グループの横に表示されるようになります。

53.3.6 デバイス・グループの順序付け

デバイスを使用してユーザーがWebCenter Portalにアクセスする場合、ポータルは、そのデバイスが属するデバイス・グループと関連付けられたページ・テンプレートやスキンなどのアセットを使用してレンダリングされます。ただし、デバイスは複数のデバイス・グループと関連付けられている場合があります。このような場合、「デバイス・グループ」タブ内のデバイス・グループの順序によって、デバイス・グループの優先順位が決まります。

デバイス・グループの順序を定義するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「デバイス設定」をクリックします。
ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/administration/device

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デバイス・グループ」タブで、順序付けアイコンを使用してデバイス・グループの順序を定義します。

- 最上位に移動: クリックすると、選択したデバイス・グループが、表示されているデバイス・グループのリストの最上位に移動します。
これは、デバイスが複数のデバイス・グループに属している場合、最上位のデバイス・グループが優先されることを意味します。

- 上へ移動: クリックすると、選択したデバイス・グループが、表示されているデバイス・グループのリスト内で1レベル上に移動します。

- 下へ移動: クリックすると、選択したデバイス・グループが、表示されているデバイス・グループのリスト内で1レベル下に移動します。

- 最下位に移動: クリックすると、選択したデバイス・グループが、表示されているデバイス・グループのリストの最下位に移動します。

図53-8 デバイス・グループの並替え

53.3.7 デバイス・グループのフィルタリング

「フィルタ」フィールドでは、「デバイス・グループ」表に表示されるデバイス・グループのリストをフィルタリングできます。フィルタリングにより、デバイス・グループ名、表示名および説明での検索が行われます。

53.3.8 デバイス・グループの削除

デバイス・グループが不要になった場合、これを削除できます。ただし、削除できるのはカスタム・デバイス・グループのみで、組込みデバイス・グループは削除できません。

注意:
デバイス・グループが削除されても、そのデバイス・グループに関連付けられたページ・バリアントはそのまま存在します(これらは削除されません)。デバイス・グループの削除に関する重要なガイドラインは、第53.6項「デバイス設定のガイドラインおよびベスト・プラクティス」を参照してください。

デバイス・グループを削除するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「デバイス設定」をクリックします。
ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/administration/device

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デバイス・グループ」タブで、削除するデバイス・グループを選択し、「削除」をクリックします。

3. 「デバイス・グループの削除」ダイアログで、「削除」をクリックします。

53.4 デバイスおよびデバイス・グループのライフ・サイクルの管理

デバイス・グループおよびデバイスをファイルにダウンロードし、これらを別のWebCenter Portalインスタンスにアップロードできます。たとえば、デバイス・グループをステージング・サーバーから本番サーバーに移動する場合は、次の項で説明するライフ・サイクル・メカニズムを使用します。

- 第53.4.1項「デバイス・グループまたはデバイスのダウンロード」

- 第53.4.2項「デバイス・グループまたはデバイスのアップロード」

注意:

- ダウンロードできるのは、コピーまたは作成したデバイス・グループまたはデバイスのみです。初期設定のデバイス・グループはどれもダウンロードできません。

- デバイス・グループをアップロードまたはダウンロードする場合、そのデバイス・グループに関連付けられているすべてのアーティファクトが含まれます(そのグループに関連付けられているすべてのデバイスを含む)。たとえば、新しいデバイスを作成し、これをグループに追加してからそのグループをダウンロードしたとします。この場合、そのグループを別のサーバーにアップロードすると、その新しいデバイスはデバイスのリストに自動的に追加されます。

53.4.1 デバイス・グループまたはデバイスのダウンロード

デバイス・グループまたはデバイスをファイルにダウンロードするには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「デバイス設定」をクリックします。
ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/administration/device

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デバイス・グループ」または「デバイス」タブで、ダウンロードするデバイス・グループまたはデバイスを選択します。複数の行を選択するには、[Ctrl]キーを押しながらクリックします。

3. 「ダウンロード」をクリックします。

4. 「ダウンロード」ダイアログの「アーカイブ・ファイル名」フィールドに、アーカイブ・ファイルの名前を入力します。

5. 次を選択します。

- 「自分のコンピュータに保存」を選択すると、アーカイブ・ファイルがローカル・ファイル・システムに保存されます。「ダウンロード」ボタンをクリックすると、ファイル・システム上でファイルを保存する場所の入力を求めるプロンプトが表示されます。

- 「WebCenter Portalサーバーに保存」を選択すると、アーカイブ・ファイルがサーバーのファイル・システムに保存されます。「パス」フィールドに、サーバー上でアーカイブ・ファイルを保存する場所を入力します。『Oracle WebCenter Portalでのポータルの構築』のアセットのダウンロードに関する項も参照してください。

53.4.2 デバイス・グループまたはデバイスのアップロード

前にダウンロードしたデバイスまたはデバイス・グループをポータルにアップロードするには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「デバイス設定」をクリックします。
ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/builder/administration/device

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「デバイス・グループ」または「デバイス」タブで、「アップロード」をクリックします。

3. 「デバイス / デバイス・グループのアップロード」ダイアログを使用して、ファイル・システム上で.earファイルを探します。

4. 「アップロード」をクリックします。

53.5 デバイスのプレビュー

WebCenter Portalには、ページおよびページ・バリアントが特定のデバイスでどのようにレンダリングされるかをプレビューできるプレビュー機能が組み込まれています。詳細は、『Oracle WebCenter Portalでのポータルの構築』のデバイスのページ・バリアントのプレビューに関する項を参照してください。

53.6 デバイス設定のガイドラインおよびベスト・プラクティス

この項では、デバイス設定での作業のベスト・プラクティスについて説明します。

本番ポータルのデフォルトのデバイス・グループを変更しない

本番ポータルのデフォルトのデバイス・グループを変更すると、予期しない動作を引き起こす場合があります。ポータルを本番にしたら、デフォルトのデバイス・グループを変更しないことが適切です。

本番ポータルのカスタムのデバイス・グループを削除しない

本番またはポータルのカスタムのデバイス・グループを削除した場合、サーバーは、既存のポータルがそのデバイス・グループを使用していることを警告せず、場合によっては正しくないページ・レンダリングが発生します。

デバイス・グループを誤って削除した場合

削除したデバイス・グループと同じデバイス・グループ名の別のデバイス・グループを作成できます。デバイス・グループが削除されても、そのページ・バリアントはシステムから削除されません。これらのページ・バリアントは、デバイス・グループの名前を使用して関連付けられています。同じ名前のデバイス・グループを再作成すると、これらすべてのページが元に戻ります。

デバイスのリクエストに関する情報が必要な場合

場合によっては、ポータルへのアクセスに使用するデバイスの情報を取得し、ポータルによるデバイスのマッピング先のデバイス設定を検出すると役に立ちます。便宜を図るために、第53.7項「デバイス属性の検出: サンプル・タスク・フロー」に、このデバイス情報を返すタスク・フローを作成するために開発者が使用できるコードをリストします。

53.7 デバイス属性の検出: サンプル・タスク・フロー

式言語の式を使用して、デバイス属性を返すことができます。この目的のために使用できるサンプル・コードは、『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』のデバイス設定に関連するEL式の付録で示されます。開発者は、このコードを使用して、ポータルが指定のデバイスでレンダリングされる方法に関する問題のトラブルシューティングで役に立つデバイス情報を返すタスク・フローを作成できます。図53-9は、このサンプル・コードを使用して作成したタスク・フローからの出力を示しています。

図53-9 サンプル・タスク・フローからの出力

54 ポータル間のタスク・フローのカスタマイズ

この章では、「タスク・フロー・エディタ」システム・ページを使用して、WebCenter Portalのすべてのポータルが使用できるようにタスク・フローをカスタマイズする方法について説明します。

注意:
タスク・フローのカスタマイズは、設計時にOracle JDeveloperを使用して行うことも可能です。このプロセスは、この章で説明する実行時の手順とは大きく異なります。詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の「タスク・フローのカスタマイズ」を参照してください。

この章には次のトピックが含まれます:

- 第54.1項「アプリケーション・レベルでのタスク・フローのカスタマイズについて」

- 第54.2項「アプリケーション・レベルでのタスク・フローのカスタマイズ」

- 第54.3項「タスク・フローのカスタマイズの削除」

権限:
この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server-Manage Configuration

さらに、ポータルの作成および管理の権限(Portals-Create PortalsおよびPortals-Manage Security and Configurationまたはどちらか一方)が必要です。権限の詳細は、第49.3項「アプリケーション・ロールおよび権限について」を参照してください。

54.1 アプリケーション・レベルでのタスク・フローのカスタマイズについて

タスク・フローのカスタマイズは、現在のスコープ内の特定のタスク・フローに対するすべてのインスタンスが影響を受けるような方法で、そのタスク・フローを構成する方法を提供します。たとえばすべてのポータルについて、リンクまたはアイコンを、それを必要とするタスク・フローに追加できます。

タスク・フローのカスタマイズ機能は、「タスク・フロー・エディタ」システム・ページで排他的に使用できます。「タスク・フロー・エディタ」システム・ページは、アプリケーション(すべてのポータル)と個別のポータルの両方に対して使用できます。

- すべてのポータル(ホーム・ポータルを含む)間で指定のタスク・フローのすべてのインスタンスを変更するには、この章で説明するように、アプリケーション・レベルの「タスク・フロー・エディタ」システム・ページでタスク・フローをカスタマイズします。

- 指定のポータルで公開されているインスタンスのみを変更するために、ポータル・モデレータは、ポータルレベルの「タスク・フロー・エディタ」システム・ページでタスク・フローをカスタマイズできます。『Oracle WebCenter Portalでのポータルの構築』の「ポータルのタスク・フローのカスタマイズ」を参照してください。

注意:
アプリケーション・レベルでタスク・フローの要素をカスタマイズし、別のユーザーがポータル・レベルで同じタスク・フローの要素をカスタマイズした場合、そのポータルではポータルレベルのカスタマイズが優先されます。

「タスク・フロー・エディタ」システム・ページは、初期設定のタスク・フローのカスタマイズを可能にするために用意されています。「アセット」ページまたは「共有アセット」ページを使用して作成されたカスタム・タスク・フローは、この方法ではカスタマイズできません。

システム・ページには「デフォルトに戻す」機能があり、権限を持つユーザーは、すべてのページ・カスタマイズを削除して、システム・ページをデフォルトの状態に戻すことができます。「デフォルトに戻す」によって、カスタマイズされたタスク・フローはデフォルトの状態に戻らないので注意してください。タスク・フローのカスタマイズを削除するには、「タスク・フローのリセット」という別のコントロールを使用します。

関連項目:
システム・ページの「デフォルトに戻す」機能および「タスク・フローのリセット」機能の詳細は、それぞれ第50.4項「システム・ページからのすべてのページ・カスタマイズの削除」および第54.3項「タスク・フローのカスタマイズの削除」を参照してください。

54.2 アプリケーション・レベルでのタスク・フローのカスタマイズ

この項では、アプリケーション・レベルで、WebCenter Portalのタスク・フローのカスタマイズを実行する方法について説明します。

注意:
アプリケーション・レベルでタスク・フローの要素をカスタマイズし、別のユーザーがポータル・レベルで同じタスク・フローの要素をカスタマイズした場合、そのポータルではポータル・レベルのカスタマイズが優先されます。

「タスク・フロー・エディタ」システム・ページを使用してアプリケーション全体のタスク・フローのカスタマイズを実行するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「システム・ページ」をクリックします。
ブラウザに次のURLを入力して、「システム・ページ」ページに直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/systempages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「タスク・フロー・エディタ」システム・ページの横にある「カスタマイズ」リンク(図54-1)をクリックして、ページ・エディタ(コンポーザ)でこれを開きます。

図54-1 「タスク・フロー・エディタ」システム・ページの横にある「カスタマイズ」リンク

3. 編集するタスク・フローを「タスク・フロー・エディタ」ページに追加します。
ページにタスク・フローを追加する方法は、リソース・カタログの他のコンポーネントを追加する方法と同じです。詳細は、『Oracle WebCenter Portalでのポータルの構築』のページへのコンポーネントの追加に関する項を参照してください。

4. 「構造」をクリックしてページのソースを表示します(図54-2)。

図54-2 「タスク・フロー・エディタ」システム・ページの「構造」ビュー

5. カスタマイズするタスク・フローの横にある「タスク・フローの編集」リンクをクリックします(図54-3)。

図54-3 Regionタグの横にある「タスク・フローの編集」リンク

6. 「タスク・フローの編集を確認」ダイアログで、「編集」をクリックします。
「構造」ビューが、編集するタスク・フローのソース・コード階層にズーム・インします(図54-4)。

図54-4 タスク・フローのズーム・イン・ビュー

7. タスク・フロー要素のプロパティを設定するには、タスク・フロー要素を「タスク・フロー・エディタ」でクリックし、「regionのプロパティの表示」をクリックします。または、「region」を右クリックし、「編集」 (図54-5)を選択します。

図54-5 「構造」ビューのページで選択したタスク・フローの要素

「コンポーネント・プロパティ」ダイアログが開きます(図54-6)。

図54-6 「コンポーネント・プロパティ」ダイアログ

8. 要素のプロパティの変更を行います。
コンポーネントの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』の「ページでのリソース・カタログ・コンポーネントの追加および編集」を参照してください。コンポーネントの詳細は、『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter Portalコンポーネント」を参照してください。

注意:
1つの要素の変更は、現在のスコープ内のタスク・フローにあるすべての類似の要素に影響することに注意してください。たとえば、フォルダ名で使用するフォントの変更は、選択したインスタンスのみではなくスコープ内すべてのフォルダ名に影響します。

9. 「適用」をクリックし、変更の結果を表示します。「OK」をクリックして変更を保存し、ダイアログを終了します。
現在のスコープ内にあるカスタマイズされたタスク・フローのすべてのインスタンスが、このカスタマイズでレンダリングされます。

10. 「保存」、「閉じる」を順にクリックしてコンポーザを終了します。

54.3 タスク・フローのカスタマイズの削除

WebCenter Portalでシードされたタスク・フローに対して行われたすべてのカスタマイズを削除できます。

注意:
この手順は、実行時に作成されたタスク・フローには適用されません。つまり、「アセット」ページまたは「共有アセット」ページを使用して作成されたタスク・フローです。実行時に作成されたタスク・フローへの変更は、レイヤー化されたタスク・フローではなくベースの編集です。したがって、「タスク・フローのリセット」をクリックするとき、削除するカスタマイズ・レイヤーはありません。

アプリケーション・レベルで行われたタスク・フローのカスタマイズを削除するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「システム・ページ」をクリックします。
ブラウザに次のURLを入力して、「システム・ページ」ページに直接移動することも可能です。

http://host:port/webcenter/portal/builder/administration/systempages

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「タスク・フロー・エディタ」システム・ページの横にある「カスタマイズ」リンク(図54-7)をクリックして、ページ編集モードでこれを開きます。

図54-7 システム・ページの横にある「カスタマイズ」リンク

3. 「構造」をクリックし、カスタマイズされたタスク・フローを選択します。

4. 「タスク・フローの編集を確認」ダイアログで、「タスク・フローの編集」をクリックします。

5. 「タスク・フローのリセット」をクリックします。

図54-8 選択した要素の「タスク・フローのリセット」オプション

6. 「タスク・フローのリセット」ダイアログで、「タスク・フローのリセット」をクリックしてアクションを確認します。

55 ポータル間のグローバル属性での作業

この章では、WebCenter Portalの任意のポータルで使用できるグローバル属性をシステム管理者が管理する方法について説明します。

この章には次のトピックが含まれます:

- 第55.1項「グローバル属性について」

- 第55.2項「グローバル属性の追加」

- 第55.3項「グローバル属性の編集」

- 第55.4項「グローバル属性の削除」

権限:
この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは少なくとも次の権限を付与されているカスタム・ロールが必要です。

- Portal Server-Manage Configuration

権限の詳細は、第49.3項「アプリケーション・ロールおよび権限について」を参照してください。

55.1 グローバル属性について

どのポータルにも、名前、説明、作成日、アイコンなどの組込み属性があります。これらの組込み属性の他に、ポータル・モデレータは、ポータルおよびその特性に固有のカスタム属性を追加して、追加のポータル情報(メタデータ)を指定できます。カスタム属性はポータル全体に伝播します。特定のポータルに固有の属性での作業の詳細は、『Oracle WebCenter Portalでのポータルの構築』の「ポータルでの属性の管理」を参照してください。

ポータル固有の属性の他に、システム管理者は、ポータル・ビルダー管理の「属性」ページ(図55-1)からグローバル属性を追加および管理できます。グローバル属性は任意のポータルで使用できます。

図55-1 ポータル・ビルダー管理:「属性」

カスタム属性は単なる名前と値のペアです(customerId=400、orderId=11、userName=Smithなど)。カスタム属性名は特定のポータル内で一意です。たとえば、お客様を分析する目的でパラメータcustomerIdを入力として取るいくつかのカスタム・タスク・フロー(お客様の売上履歴、顧客満足度の評価、将来の売上予測、お客様連絡先情報など)とともに、ポータルでグローバル属性を使用できます。適切な値を持つcustomerIdという名前で定義されたカスタム属性を使用すると、customerIdを受け入れることができるすべてのタスク・フローは、そのお客様固有の情報を表示できます。

カスタム属性は、式言語(EL)の式を使用して取得することもできます。たとえば、EL式は、ポータルを表示するURLを介して渡される値(たとえばcustomerid=10)を読み取ることができます。パラメータ値に基づいてカスタマイズされたコンテンツを配信するポータル・ページ、タスク・フローまたはポートレットは、グローバル・カスタム属性値を受け入れることができ、それに応じて次の式言語(EL)構文を使用してコンテンツを表示し、グローバル・カスタム属性値にアクセスできます。

#{WCAppContext.application.applicationConfig.customAttributes[attributeName]

ELアシスタンスが必要な場合、アプリケーション開発者はEL式を提供できます。『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の付録「式言語の式」を参照してください。

55.2 グローバル属性の追加

任意のポータルで使用する新しいグローバル属性を追加するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「属性」をクリックします。
ブラウザに次のURLを入力して直接「属性」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/attributes

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 「属性の追加」をクリックします(図55-2)。

図55-2 WebCenter Portal管理: 属性の追加

「属性の追加」ダイアログが開きます(図55-3)。

図55-3 カスタム属性の名前と値の入力

3. 属性の一意の名前を入力します。有効な名前は、英字で始まり英数字のみから構成されます。

4. 必要に応じて、カスタム属性の値を入力します。入力した値は文字列値として処理されます。

5. 「追加」をクリックしてカスタム属性を保存し、これを「属性」ページのリストに表示します。

55.3 グローバル属性の編集

グローバル属性を編集するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「属性」をクリックします。
ブラウザに次のURLを入力して直接「属性」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/attributes

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 属性の「アクション」アイコンをクリックして、「属性の編集」を選択します。

3. 「属性の編集」ダイアログで、属性の値を変更します。入力した値は文字列値として処理されます。

4. 「OK」をクリックして、変更を保存します。

55.4 グローバル属性の削除

グローバル属性を削除するには:

1. 「管理」ページ(第47.2項「「ポータル・ビルダー管理」ページへのアクセス」を参照)で、「属性」をクリックします。
ブラウザに次のURLを入力して直接「属性」ページに移動することも可能です。

http://host:port/webcenter/portal/builder/attributes

関連項目:
『Oracle WebCenter Portalでのポータルの構築』の付録「WebCenter PortalプリティURL」。

2. 属性の「アクション」アイコンをクリックして、「属性の削除」を選択します。

3. 確認ダイアログで、「削除」をクリックします。

56 ポータルの使用状況の分析

この章では、ポータルのリアルタイム使用状況およびアクティビティのレポートを提供するために実行時に分析サービス・タスク・フローをアプリケーション・ページに追加する方法について説明します。

この章の内容は次のとおりです。

- 第56.1項「分析タスク・フローおよびサービスについて」

- 第56.2項「分析管理ページについて」

- 第56.3項「分析タスク・フローでの作業」

分析タスク・フローを機能させるには、分析スキーマ(ACTIVITIES)をインストールして構成し、アプリケーションと分析コレクタの間の接続を設定する必要があります。分析スキーマおよび分析サービスのバックエンドを管理する方法の詳細は、第11章「分析の管理」を参照してください。

Oracle JDeveloperを使用して設計時に分析タスク・フローを追加する方法は、『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』の分析の統合に関する章を参照してください。

権限:
この章のタスクを実行するには、ポータル・ビルダー管理からWebCenter PortalのAdministratorロールが付与されているか、またはApplication-Manage Configurationの権限を持つ個々のポータル・モデレータである必要があります。
ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

56.1 分析タスク・フローおよびサービスについて

分析サービスを使用すると、WebCenter Portal管理者およびモデレータは、WebCenter Portalのトラフィックおよび使用状況を追跡および分析できます。分析サービスでは、次の基本機能が提供されます。

- 使用状況トラッキング・メトリック: 分析サービスは、コミュニティ、ポートレット・トラフィックなどの一般的なWebCenter Portal機能のメトリックを収集および報告します。

- 動作トラッキング: 分析サービスを使用して、WebCenter Portalメトリックを分析し、ページ訪問期間、一定期間の使用状況などの使用パターンを特定できます。

- ユーザー・プロファイルの相関: 分析サービスを使用して、メトリック情報をユーザー・プロファイル情報と関係付けることができます。国、会社、役職などのユーザー・プロファイル・データを基準に、使用状況トラッキング・レポートを表示およびフィルタ処理できます。

注意:
プロファイル情報はキャッシュされます。つまり、ユーザー・プロファイルの変更は、キャッシュが更新されるまでレポートに表示されません。デフォルトのキャッシュ時間は60分ですが、管理者はこの値を変更できます。

56.2 分析管理ページについて

Manage Configuration権限を持っているWebCenter Portal管理者は、WebCenter Portal全体のメトリックを表示する分析コンソールを使用できます。このコンソールは、4つのページから構成され、いくつかの異なるレポートをグループ化しています。

- サマリー・メトリック: ポータルのトラフィック、ページ・ビューおよびログインのメトリック

- ポータル・メトリック: ポータルの使用状況およびレスポンス時間

- ポートレット・メトリック: ポートレットのビューおよびレスポンス時間

- サービス・メトリック: 検索、ドキュメント、wiki、ブログおよびディスカッションの使用状況

図56-1 管理者用分析コンソール

このコンソールはデフォルトで、「分析」というビジネス・ロール・ページからのみアクセスできます。ユーザーが「分析」ページを表示するには、WebCenter Portalの管理者が必要な権限を付与する必要があります。このページは、アクセスおよび使用状況の統計を分析する必要があるユーザーを対象としています。そのようなユーザーとして、管理者、営業部門またはマーケティング部門の部長や担当重役、ビジネス・アナリストなどが考えられます。

他のビジネス・ロール・ページと同様に、分析ページは割り当てられたすべてのユーザーにプッシュされ、ホーム・ポータルに表示されます。分析ページをホーム・ポータルで使用できるようになると、ユーザーは「ページの管理」ダイアログでページを表示または非表示にできます。

56.3 分析タスク・フローでの作業

この項では、分析タスク・フローについて説明します。これには、分析タスク・フローのポータル・ページへの追加方法、分析タスク・フローのカスタマイズ方法、分析タスク・フローのプロパティの変更方法、レポート・ビューのパーソナライズ方法が含まれます。

この項には次のトピックが含まれます:

- 第56.3.1項「分析タスク・フローの理解」

- 第56.3.2項「分析タスク・フローのページへの追加」

- 第56.3.3項「分析レポートのカスタマイズ」

- 第56.3.4項「分析レポートのパーソナライズ」

- 第56.3.5項「分析タスク・フローのプロパティの設定」

56.3.1 分析タスク・フローの理解

この項では、WebCenter Portalに付属しているすべての分析タスク・フローをリストし、説明します。「管理者」とマークされているものは管理者アカウントを持っているユーザーのみが使用でき、「システム管理者」とマークされているものはシステム管理者のみが使用できます。

次のタスク・フローは初期設定で使用できます。

アプリケーション分析:

- 第56.3.1.1項「WebCenterトラフィック」

- 第56.3.1.2項「ページ・トラフィック(管理者)」

- 第56.3.1.3項「ログイン・メトリック(システム管理者)」

ポータル分析:

- 第56.3.1.4項「ポータル・トラフィック(システム管理者)」

- 第56.3.1.5項「ポータル・レスポンス時間(システム管理者)」

ポートレット分析:

- 第56.3.1.6項「ポートレット・トラフィック(管理者)」

- 第56.3.1.7項「ポートレット・インスタンス・トラフィック(管理者)」

- 第56.3.1.8項「ポートレット・レスポンス時間(管理者)」

- 第56.3.1.9項「ポートレット・インスタンス・レスポンス時間(管理者)」

サービス分析:

- 第56.3.1.10項「検索メトリック」

- 第56.3.1.11項「ドキュメント・メトリック(システム管理者)」

- 第56.3.1.12項「Wikiメトリック(システム管理者)」

- 第56.3.1.13項「ブログ・メトリック(システム管理者)」

- 第56.3.1.14項「ディスカッション・フォーラム・メトリック(システム管理者)」

注意:
次の各項で示すイメージは、各レポートの1つのビューを表しています。ただし、各レポートをカスタマイズして別の方法(棒グラフ、円グラフ、折れ線グラフ、表など)でデータを表示できます。レポートのカスタマイズの詳細は、第56.3.3項「分析レポートのカスタマイズ」および第56.3.4項「分析レポートのパーソナライズ」を参照してください。

56.3.1.1 WebCenterトラフィック

「WebCenterトラフィック」タスク・フローは、ポータル内の一般的なイベントのサマリー・ビューを表示します。このタスク・フローを使用して、アプリケーション全体のイベント(ポータル・ビュー、ページ・ビュー、ポートレット・ビュー、ログイン、検索数、wikiビュー、ブログ・ビュー、ディスカッション・フォーラム・ビューおよびドキュメント・ビュー)を追跡します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のWebCenterトラフィックに関する項を参照してください。

56.3.1.2 ページ・トラフィック(管理者)

「ページ・トラフィック」タスク・フローは、ページ・ヒット数および任意のポータル・ページを訪問した一意のユーザー数を表示します。このタスク・フローを使用すると、最も多く訪問されているページ(上位ページ)および訪問数が最も少ないページ(下位ページ)がすぐにわかります。詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・トラフィック(管理者)に関する項を参照してください。

56.3.1.3 ログイン・メトリック(システム管理者)

「ログイン」タスク・フロー(図56-2)は、ユーザーがWebCenter Portalにログインした回数をレポートします。

このタスク・フローを使用すると、ポータルへのログインの合計回数および一意のユーザーがWebCenter Portalにログインした回数がわかります。

図56-2 分析タスク・フロー: ログイン・メトリック

56.3.1.4 ポータル・トラフィック(システム管理者)

「ポータル・トラフィック」タスク・フロー(図56-3)は、個々のポータルの使用状況情報(ページ・ヒット数、一意のユーザー数、一意の訪問数(同じWebCenter Portalセッション中の同じポータル内での複数の連続したページ・ビューは1回の訪問として処理))を表示します。

このタスク・フローを使用すると、最も人気のあるポータル(上位)および最も人気のないポータル(下位)がすぐにわかります。データをフィルタ処理して、特定のポータルのみを表示するかまたはすべてのポータルを表示できます。

図56-3 分析タスク・フロー: ポータル・トラフィック

注意:
ホーム・ポータルはデータに含まれていません。

56.3.1.5 ポータル・レスポンス時間(システム管理者)

「ポータル・レスポンス時間」タスク・フロー(図56-4)は、指定した期間の個々のポータルのページ・パフォーマンス情報(平均、最小および最大のレスポンス時間)を表示します。このタスク・フローを使用すると、最も遅いポータル(下位)および最も速いポータル(上位)がすぐにわかります。データをフィルタ処理して、特定のポータルのみを表示するかまたはすべてのポータルを表示できます。

図56-4 分析タスク・フロー: ポータル・レスポンス時間

注意:
ホーム・ポータルはデータに含まれていません。

56.3.1.6 ポートレット・トラフィック(管理者)

「ポートレット・トラフィック」タスク・フローは、ポートレットの使用状況情報(ポートレット・ヒット数(ポートレットが表示された回数)およびポートレットにアクセスした一意のユーザー数)を表示します。

このタスク・フローを使用すると、最も人気のあるポートレット(上位)および最も人気のないポートレット(下位)がすぐにわかります。データをフィルタ処理して、特定のポートレットのみを表示するかまたはすべてのポートレットを表示できます。同様に、ポータルを基準にポートレットのデータをフィルタ処理できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポートレット・トラフィック(管理者)に関する項を参照してください。

56.3.1.7 ポートレット・インスタンス・トラフィック(管理者)

「ポートレット・インスタンス・トラフィック」タスク・フローは、個々のポートレット・インスタンスの使用状況情報(ポートレット・ヒット数(ポートレットが表示された回数)およびポートレットにアクセスした一意のユーザー数)を表示します。同じポートレットが複数のページに表示される場合は、各配置がポートレット・インスタンスとして考慮されます。

このタスク・フローを使用すると、最も人気のあるポートレット・インスタンス(上位)および最も人気のないポートレット・インスタンス(下位)がすぐにわかります。データをフィルタ処理して、特定のポートレット・インスタンスのみを表示するかまたはすべてのポートレット・インスタンスを表示できます。同様に、ポータルを基準にポートレットのデータをフィルタ処理できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポートレット・インスタンス・トラフィック(管理者)に関する項を参照してください。

56.3.1.8 ポートレット・レスポンス時間(管理者)

「ポートレット・レスポンス時間」タスク・フローは、個々のポートレットのパフォーマンス情報(平均、最小および最大のレスポンス時間)を表示します。このタスク・フローを使用すると、最も遅いポートレット(下位)および最も速いポートレット(上位)がすぐにわかり、パフォーマンス・データを比較できます。ページ・パフォーマンスと最も遅いポートレットには直接の関係があることが多いため、ポートレット・レスポンス時間は重要です。ポータル内での低パフォーマンスをトラブルシューティングする際、最もパフォーマンスが悪いポートレットを特定することが重要です。データをフィルタ処理して、特定のポートレットのみを表示するかまたはすべてのポートレットを表示できます。同様に、ポータルを基準にポートレットのデータをフィルタ処理できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポートレット・レスポンス時間(管理者)に関する項を参照してください。

56.3.1.9 ポートレット・インスタンス・レスポンス時間(管理者)

「ポートレット・インスタンス・レスポンス時間」タスク・フローは、個々のポートレット・インスタンスのパフォーマンス情報(平均、最小および最大のレスポンス時間)を表示します。同じポートレットが複数のページに表示される場合は、各配置がポートレット・インスタンスとして考慮されます。

このタスク・フローを使用すると、最も遅いポートレット・インスタンス(下位)および最も速いポートレット・インスタンス(上位)がすぐにわかり、パフォーマンス・データを比較できます。データをフィルタ処理して、特定のポートレット・インスタンスのみを表示するかまたはすべてのポートレット・インスタンスを表示できます。同様に、ポータルを基準にポートレットのデータをフィルタ処理できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポートレット・インスタンス・レスポンス時間(管理者)に関する項を参照してください。

56.3.1.10 検索メトリック

「検索メトリック」タスク・フローは、ポータル内で実行された検索を追跡します。このタスク・フローを使用すると、最多検索語句(上位)および最少検索語句(下位)がすぐにわかります。詳細は、『Oracle WebCenter Portalでのポータルの構築』のメトリックの検索に関する項を参照してください。

56.3.1.11 ドキュメント・メトリック(システム管理者)

「ドキュメント・メトリック」タスク・フロー(図56-5)は、ドキュメントのアクセス頻度を追跡します。このタスク・フローを使用すると、最も人気のあるドキュメント(上位)および最も人気のないドキュメント(下位)がすぐにわかります。データをフィルタ処理して、特定のポータルのみを表示するかまたはすべてのポータルを表示できます。

注意:
ホーム・ポータルのドキュメントはこのレポートには含まれません。

注意:
同じ名前の異なるドキュメントが2つある場合、2つの別のドキュメントとして処理されます。このメトリックにはコンテキストの親フォルダが含まれています。

図56-5 分析タスク・フロー: ドキュメント・メトリック

56.3.1.12 Wikiメトリック(システム管理者)

「Wikiメトリック」タスク・フロー(図56-6)は、WebCenter Portal内でのwikiのアクセス頻度を追跡します。このタスク・フローを使用すると、最も人気のあるwiki(上位)および最も人気のないwiki(下位)がすぐにわかります。データをフィルタ処理して、特定のポータルのみを表示するかまたはすべてのポータルを表示できます。

図56-6 分析タスク・フロー: Wikiメトリック

56.3.1.13 ブログ・メトリック(システム管理者)

「ブログ・メトリック」タスク・フロー(図56-7)は、WebCenter Portal内でのブログのアクセス頻度を追跡します。このタスク・フローを使用すると、最も人気のあるブログ(上位)および最も人気のないブログ(下位)がすぐにわかります。データをフィルタ処理して、特定のポータルのみを表示するかまたはすべてのポータルを表示できます。

図56-7 分析タスク・フロー: ブログ・メトリック

56.3.1.14 ディスカッション・フォーラム・メトリック(システム管理者)

「ディスカッション・フォーラム・メトリック」タスク・フロー(図56-8)は、WebCenter Portal内のディスカッション・フォーラムを追跡します。このタスク・フローを使用すると、最も人気のあるディスカッション(上位)および最も人気のないディスカッション(下位)がすぐにわかります。データをフィルタ処理して、特定のポータルのみを表示するかまたはすべてのポータルを表示できます。

図56-8 分析タスク・フロー: ディスカッション・フォーラム・メトリック

56.3.2 分析タスク・フローのページへの追加

分析タスク・フローをページに追加するプロセスは、他のタスク・フローと同じです(詳細は、『Oracle WebCenter Portalでのポータルの構築』のコンポーネントのページへの追加に関する項を参照)。このプロセスは、リソース・カタログでこれらのタスク・フローを検索する場合のみ異なります。すべての分析タスク・フローは分析フォルダにあります。

図56-9 「リソース・カタログ」の分析フォルダ

注意:
分析タスク・フローをポータルのページに追加すると、すべてのポータルの情報ではなくそのポータルの情報のみが表示されます。

56.3.3 分析レポートのカスタマイズ

ページ編集モードでレポート設定を編集することによって、分析レポートのデフォルト設定を指定できます。編集モードの間に行った変更は、ページ表示モードのすべてのユーザーに対してデフォルトのレポート設定になります。

たとえば、分析ページを編集し、トラフィック・レポートの「サマリー・メトリック」ページで次の設定を変更できます。レポート・タイプを円グラフに設定し、時間枠を今週に設定し、表示から「ディスカッション・フォーラム」を削除します。ユーザーが分析ページに訪問すると、これらの設定がデフォルトで適用されます。ユーザーは、必要に応じてレポートを編集できます。これは、ユーザーが一般的に使用することがわかっている特定の設定がある場合や、グループ固有ページ上の分析タスク・フローの特定のインスタンスをカスタマイズする場合に便利です。

レポート設定を構成して、表示モードでユーザーが使用できる制御を指定することもできます。詳細は、『Oracle WebCenter Portalでのポータルの構築』の分析レポートのカスタマイズに関する項を参照してください。

56.3.4 分析レポートのパーソナライズ

分析タスク・フローには、レポート上部に表示オプションがあり、レポートの左側に問合せオプションがあります。これらのオプションを使用すると、必要に応じてレポートに含まれているメトリックおよびレポートの表示方法を変更することによって、レポートをパーソナライズできます。ほとんどのオプションはすべての分析タスク・フローで同じです。

この項には次のサブセクションが含まれます:

- 第56.3.4.1項「レポート表示オプション」

- 第56.3.4.2項「問合せオプション」

56.3.4.1 レポート表示オプション

レポート上部にあるレポート表示オプションを使用すると、レポートのタイプの選択、組み込むメトリックのタイプの選択、および一部のタスク・フローでは表示する上位/下位の範囲の制御を実行できます。

レポートのタイプ

選択した表示オプションおよび問合せオプションに応じて、棒グラフ、円グラフ、折れ線グラフまたは表としてレポートを表示できます。レポートのタイプを選択するには、該当するアイコンをクリックします。

表56-1に、様々な表示オプションと問合せオプションで使用可能なレポート・タイプを示します。この表には次の列があります。

- 「選択したメトリック」は、メトリックのリスト内で選択されたもの、単一のメトリックまたは複数のメトリックを指定します。

注意:
「検索メトリック」タスク・フローおよび「ドキュメント・メトリック」タスク・フローは、単一のメトリックのみを表示します。メトリックを選択するリストはありません。

- 「グループ化基準オプション」は、レポートの左にある「グループ化オプション」セクションから選択されたもの、「選択なし」または選択可能な選択肢のいずれかを指定します。

- 棒、円、折れ線および表は、指定した選択肢でそのタイプのレポートを表示できるかどうかを指定します。

図56-1 分析タスク・フローの表示オプション

選択したメトリック

グループ化基準オプション

棒

円

折れ線

表

単一のメトリック
ログイン・トラフィック・タスク・フロー

選択なし

いいえ

いいえ

いいえ

はい

単一のメトリック
その他すべてのタスク・フロー

選択なし

はい

はい

いいえ

はい

単一のメトリック

時間間隔、ユーザー・プロパティまたはこれら両方*

はい

いいえ

はい

はい

複数のメトリック
WebCenterトラフィックおよび
ログイン・トラフィック・タスク・フロー

選択なし

はい

はい

いいえ

はい

複数のメトリック
その他すべてのタスク・フロー

選択なし

はい

いいえ

はい

はい

複数のメトリック
WebCenterトラフィックおよびログイン・トラフィック・タスク・フロー

時間間隔またはユーザー・プロパティ

はい

いいえ

はい

はい

複数のメトリック
その他すべてのタスク・フロー

時間間隔またはユーザー・プロパティ

いいえ

いいえ

いいえ

はい

複数のメトリック
ログイン・トラフィック・タスク・フロー

両方*

いいえ

いいえ

いいえ

はい

*グループ化オプションの両方はログイン・トラフィック・タスク・フローに対してのみ使用できます。

メトリック

レポートに組み込むメトリックのタイプを選択できます。メトリックのオプションは使用しているタスク・フローに応じて異なります。

- WebCenterトラフィック: 「ポータル」、「ページ」、「ポートレット」、「ログイン」、「検索」、「Wiki」、「ブログ」、「ディスカッション・フォーラム」、「ドキュメント」

- ページ・トラフィック: ヒット、ユーザー数(重複を除く)

- ログイン・メトリック: ログイン、ユーザー数(重複を除く)

- ポータル・トラフィック: 「ヒット」、「ユーザー数(重複を除く)」、「訪問」

- ポータル・レスポンス時間: 「平均レスポンス時間」、「最小レスポンス時間」、「最大レスポンス時間」

- ポートレット・トラフィック: ヒット、ユーザー数(重複を除く)

- ポートレット・インスタンス・トラフィック: ヒット、ユーザー数(重複を除く)

- ポートレット・レスポンス時間: 平均レスポンス時間、最小レスポンス時間、最大レスポンス時間

- ポートレット・インスタンス・レスポンス時間: 平均レスポンス時間、最小レスポンス時間、最大レスポンス時間

- 検索メトリック: このタスク・フローは検索メトリックのみを表示するため、メトリックを選択するオプションはありません。

- ドキュメント・メトリック: このタスク・フローはドキュメント・メトリックのみを表示するため、メトリックを選択するオプションはありません。

- Wikiメトリック: ビュー、ユーザー数(重複を除く)

- ブログ・メトリック: ビュー、ユーザー数(重複を除く)

- ディスカッション・フォーラム・メトリック: ビュー、ユーザー数(重複を除く)

レポートに組み込むメトリックを選択するには、レポートの上にあるリストからメトリックを選択します。

図56-10 分析タスク・フロー: メトリックの選択

上位、下位またはカスタムの範囲

一部のタスク・フローでは、レポートでメトリックの上位、下位、すべてまたはカスタムの範囲の表示を指定できます。これらのオプションを使用すると、ポータルの最も人気がある項目および最も人気がない項目がわかります。

レポートでメトリックの上位または下位の範囲を表示するには、レポートの上のリストで「上」または「下」を選択し、数を選択して範囲を定義します。

カスタムの範囲を表示するには、レポートの上のリストで、「指定」を選択し、「選択」をクリックします。

上オプションおよび下オプションは、「ページ」、「ポートレット・トラフィック」、「ポートレット・インスタンス・トラフィック」、「レスポンス時間」、「ポートレット・レスポンス時間」、「ポートレット・インスタンス・レスポンス時間」で使用できます。

カスタム範囲オプションは、「ページ」、「トラフィック」、「レスポンス時間」、「ポートレット・トラフィック」、「ポートレット・インスタンス・トラフィック」、「レスポンス時間」、「ポートレット・レスポンス時間」、「ポートレット・インスタンス・レスポンス時間」、「検索メトリック」、「ドキュメント・メトリック」、「Wikiメトリック」、「ブログ・メトリック」、「ディスカッション・フォーラム・メトリック」で使用できます。

56.3.4.2 問合せオプション

分析タスク・フローには、レポートの左に次の問合せオプションが組み込まれています。

- レポート・サマリー
選択した表示オプションおよび問合せオプションのサマリーをレポートに表示します。

- 時間枠
レポートに表示するメトリックの日付の範囲を指定できます。次のオプションから選択できます。「昨日」、「今日」、「今週」、「先週」、「今月」、「先月」、「過去3か月間」、「過去6か月間」、「今年」、「昨年」または独自の日付範囲を指定できます。

- ユーザー・プロパティ
ユーザー・プロパティを基準にレポートをフィルタ処理できます。リストからプロパティを選択した後、そのプロパティに含める必要があるまたは含めてはならない値を指定できます。フィルタ処理されたプロパティに当てはまるメトリックのみがレポートに表示されます。

- プロパティ: レポートをフィルタ処理するプロパティを選択します。「市区町村」、「会社」、「国」、「部門」、「表示名」、「従業員ID」、「IMユーザー」、「マネージャ」、「電話番号」、「都道府県」、「番地」、「役職」または「郵便番号」を選択できます。

- 演算子: プロパティをフィルタ処理する方法を選択します。「次を含む」または「次を含まない」を選択できます。

- 値: プロパティをフィルタ処理する値を入力します。

注意:
ワイルドカード(%、?など)を使用して検索するには、円マーク(\)をワイルドカードの前に付ける必要があります。たとえば、giveまたはgivingを検索するには、「値」ボックスにgiv\%と入力します。

- 追加オプション
ホーム・ポータル・ページをレポートのデータに組み込むことができます。これらのオプションは、(「ページ・トラフィック」レポート内の)「ページ」タスク・フローで使用できます。

- ポータル
分析タスク・フローをホーム・ポータルまたはビジネス・ロール・ページで表示する場合、レポートに追加するポータルを選択できます。分析タスク・フローを特定のポータル内で使用する場合は、そのポータルのメトリックのみが表示され、「ポータル」オプションは使用できません(グレー表示)。

レポートに追加するポータルを指定するには、「ポータル・フィルタ」アイコンをクリックして「ポータルの指定」ポップアップを表示します。レポートに追加するポータルを選択します。複数のポータルを選択するには、[Ctrl]キーまたは[Shift]キーを押しながらクリックします。

このオプションは、「トラフィック」、「ログイン」または「検索メトリック」の各タスク・フローでは使用できません。

- グループ化オプション
レポートでメトリックをグループ化する基準のオプションを選択できます。時間間隔(時間、日付、週、月または年)、ユーザー・プロパティまたは「ログイン」タスク・フローあるいは両方でグループ化できます。

注意:
この設定は、レポートで使用可能な表示オプションに影響します(表56-10を参照)。

56.3.5 分析タスク・フローのプロパティの設定

分析サービス・タスク・フローには関連するプロパティがあり、十分な権限を持つユーザーは、これらのプロパティにコンポーザの「コンポーネント・プロパティ」ダイアログを介してアクセスできます(図56-11)。

図56-11 分析タスク・フロー: コンポーネント・プロパティ

「コンポーネント・プロパティ」ダイアログへのアクセスの詳細は、『Oracle WebCenter Portalでのポータルの構築』のコンポーネントでのプロパティの設定に関する項を参照してください。

次の各項では、イベント・サービス・タスク・フローおよび「パラメータ」タブのプロパティについて説明します。

- 第56.3.5.1項「分析サービス・タスク・フローのプロパティについて」

- 第56.3.5.2項「分析サービス・タスク・フローのパラメータ」

56.3.5.1 分析サービス・タスク・フローのプロパティについて

デフォルトのタスク・フロー・コンテンツは、「コンポーネント・プロパティ」ダイアログの「パラメータ」タブ上のプロパティによって制御されます。このタブのパラメータの詳細は、第56.3.5.2項「分析サービス・タスク・フローのパラメータ」を参照してください。一部のタスク・フローでは、このタブのパラメータにより、ページ・パラメータやページ定義変数へのタスク・フローの結付けが容易になります。ページおよびコンポーネントの結付けの詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ、タスク・フロー、ポートレットおよびADFコンポーネントの結付けに関する項を参照してください。

「表示オプション」、「スタイル」および「コンテンツ・スタイル」の各タブのプロパティを変更すると、タスク・フローの外観および動作に影響します。これらのプロパティはすべてのタスク・フローに共通です。詳細は、『Oracle WebCenter Portalでのポータルの構築』のコンポーネント・プロパティの変更に関する項を参照してください。

「イベント」タブのコンテンツは、タスク・フローがサポートするイベントによって異なります。詳細は、『Oracle WebCenter Portalでのポータルの構築』のコンポーネント・コンテキスト・イベントでの作業に関する項を参照してください。

「パラメータ」タブおよび「表示オプション」タブのすべてのプロパティは、式言語(EL)エディタへのアクセス権を提供し、これを使用して定数値のかわりに変数値を選択または指定できます。プロパティ・フィールドの横の「編集」アイコンをクリックしてエディタを開きます。

注意:
「コンポーネント・プロパティ」ダイアログの汎用の「表示オプション」タブにEL式を入力した場合には必ず、その入力が自動的に検証されます。EL構文が無効な場合、エラーが表示され、その値は適用も保存もされません。汎用の「表示オプション」は、『Oracle WebCenter Portalでのポータルの構築』の表示オプションのプロパティに関する項にカタログされているものです。WebCenter PortalのELの詳細は、『Oracle WebCenter PortalおよびOracle Jdeveloperでのポータルの開発』の付録「式言語の式」を参照してください。
ELの検証は、汎用ではない表示オプションに対しては実行されません。

56.3.5.2 分析サービス・タスク・フローのパラメータ

表56-2では、分析サービス・タスク・フロー固有のパラメータについて説明しています。

表56-2 分析タスク・フローのパラメータ

パラメータ

説明

Analytics Report Title

分析データの上に表示される表示タイトルを指定します。

注意:

- 「表示オプション」ページでは、TextプロパティではなくAnalytics Report Titleを使用してください。Textの値を変更しても分析タスク・フローには影響しません。

- 分析コンソールではレポートのタイトルを変更できません。

Analytics Resource Id

MDSのタスク・フロー・インスタンスのユーザー・カスタマイズ/アプリケーション・カスタマイズを格納するために使用するMDSドキュメントを指定します。

注意: この値を編集しないでください。

Application Name*

分析データを表示するWebCenter Portalアプリケーションを指定します。WebCenter Portalでは、これは常にwebcenterです。

分析データベースを使用すると、複数のアプリケーションからのイベント・データを格納できるため、表示するアプリケーション・データを識別するためにこのパラメータが必要です。

省略すると、タスク・フローは、サポートされているすべてのWebCenter Portalアプリケーションの分析データを表示します。

Max Data Points Per Series

棒グラフまたは折れ線グラフに表示されるデータ・ポイントの最大数を指定します。デフォルト値は25です。有効な値は1から1000までです。

注意: データ点の数を増やすと、レポートのレンダリングにかかる時間が増える場合があります。

第XII部

付録

この部では、『Oracle WebCenter Portalの管理』の付録情報について説明します。

第XII部の内容は次のとおりです。

- 付録A「Oracle WebCenter Portalの構成」

- 付録B「WebCenter PortalのOracle HTTP Server構成」

- 付録C「サード・パーティ製品のサポート」

- 付録D「Oracle Secure Enterprise Searchの評価のための構成」

- 付録E「WebCenter Portalのライフサイクル中のラベル付け」

- 付録F「WebCenter PortalへのWikiコンテンツの移行」

- 付録G「Oracle WebCenter Portalのトラブルシューティング」

- 付録H「FrameworkFoldersへのFolders_gの移行」

- 付録I「WebCenter PortalへのPortal Frameworkアプリケーションの移行」

A Oracle WebCenter Portalの構成

この章では、WebCenter PortalアプリケーションおよびPortal Frameworkアプリケーションの主な2つの構成ファイルadf-config.xmlおよびconnections.xmlについて説明します。この付録では、これらの両方のファイルとその検索方法について説明します。また、これらのファイルをいつ構成し、どのツールを使用するかについても説明します。

web.xml、webcenter-config.xmlなどの他の構成ファイルについてもここで説明します。第1.3.5項「Oracle WebCenter Portalの構成に関する考慮事項」も参照してください。

この付録には次のトピックが含まれます:

- 第A.1項「構成ファイル」

- 第A.2項「クラスタ構成」

- 第A.3項「構成ツール」

付録G「Oracle WebCenter Portalの構成に関する問題のトラブルシューティング」を参照してください。

A.1 構成ファイル

adf-config.xml、connections.xmlおよびweb.xmlは、WebCenter Portalアプリケーション、Portal Frameworkアプリケーション、およびこれらのバックエンド・サービスの構成に使用します。また、初期状態のWebCenter Portalアプリケーションに固有のwebcenter-config.xml構成ファイルは、アプリケーション全体の設定の構成に使用します。

この項では、アプリケーションでの各ファイルの使用方法およびこれらのファイルのデプロイ後の場所について説明します。この項には次のサブセクションが含まれます:

- adf-config.xmlおよびconnections.xml

- web.xml

- webcenter-config.xml

A.1.1 adf-config.xmlおよびconnections.xml

adf-config.xmlおよびconnections.xmlは両方とも、開発環境でアプリケーションにより使用されるディスカッション・サーバー、メール・サーバーまたはコンテンツ・サーバーなどの設計時構成情報を格納します。

- adf-config.xml: アプリケーションレベルの設定(アプリケーションが現在使用しているディスカッション・サーバーやメール・サーバーなど)が格納されます。
『Oracle Application Development Framework Fusion開発者ガイド』を参照してください。

- connections.xml: WebCenter Portalサービスの接続の詳細が格納されます。
『Oracle Application Development Framework Fusion開発者ガイド』を参照してください。

WebCenter PortalアプリケーションまたはPortal Frameworkアプリケーションを本番環境にデプロイした後で、Fusion Middleware ControlまたはWebLogic Scripting Tool (WLST)コマンドを使用して、これらのファイルのプロパティを再構成することをお薦めします。たとえば、本番サーバー・インスタンスをポイントするように接続の詳細を変更する必要がある場合があります。付録A「構成ツール」を参照してください。

Fusion Middleware ControlおよびWLSTコマンドを使用する主な利点は、デプロイ後に加えた構成の変更が、アプリケーションのOracle Metadata Services (MDS)リポジトリにカスタマイズとして格納されることです。MDSは、デプロイされた元のバージョンのadf-config.xmlおよびconnections.xmlをベース・ドキュメントとして使用し、単一のカスタマイズ・レイヤーを使用して後続のすべてのカスタマイズを別個にMDSに格納します。将来、アプリケーションが再デプロイされる場合、以前の構成の変更がすべて保持されます。

WebCenter PortalアプリケーションまたはPortal Frameworkアプリケーションの起動時に、MDSに格納されたアプリケーション・カスタマイズが該当するベース・ドキュメントに適用され、アプリケーションは、マージされたドキュメント(カスタマイズされているベース・ドキュメント)を構成プロパティの最終セットとして使用します。

この項には次のサブセクションが含まれます:

- MDSのデプロイ後のカスタマイズの確認

- MDSカスタマイズが含まれている構成ファイルのエクスポート

- 構成の競合の処理

- adf-config.xmlまたはconnections.xmlのMDSカスタマイズの削除

- 使用する構成ツール

MDSカスタマイズの詳細は、管理者ガイドのMDSリポジトリの理解に関する項を参照してください。

MDSのデプロイ後のカスタマイズの確認

デプロイ後、常にFusion Middleware ControlまたはWLSTコマンドを使用して、最新の構成を確認するか、または構成を変更します。Fusion Middleware Controlでは、多くの場合、WebCenter Portal固有の構成画面を使用しますが、役立つシステムMBeanブラウザは、構成設定の確認にも使用できます。これらのツールは常に現在の構成を示すため、通常、ベース・ドキュメントのコンテンツや、adf-config.xmlおよびconnections.xmlなどのファイルのMDSカスタマイズ・データを調べたり変更したりする必要はありません。

MDSの情報を参照することは役立つ場合があります。なんらかの理由で、MDSに格納される構成ファイルのカスタマイズを抽出するか調べる必要がある場合は、WLSTコマンドexportMetadataを使用してください。

関連項目:
構文の詳細と例は、『WebLogic Scripting Toolコマンド・リファレンス』のexportMetadataに関する項を参照してください。

たとえば、アプリケーション名がwebcenterで、WC_Spaces管理対象サーバーにデプロイされるWebCenter Portalのconnections.xmlのMDSカスタマイズを決定するには、ファイル名および場所は常に/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xmlであり、次のように指定できます。

exportMetadata(application='webcenter', server='WC_Spaces',
toLocation='/tmp/mydata',
docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

同様に、adf-config.xmlのMDSカスタマイズを決定するには、次のように指定できます。

exportMetadata(application='webcenter', server='WC_Spaces',
toLocation='/tmp/mydata',
docs='/META-INF/mdssys/cust/adfshare/adfshare/adf-config.xml.xml')

toLocationを指定することにより、ファイル・カスタマイズの保存先を選択します。たとえば、toLocationは/tmp/mydataに設定され、要求されたファイルは/tmp/mydata/META-INF/mdssys/cust/adfshare/adfshareに保存されます。

要求されたファイルに対してカスタマイズが存在しない場合、指定された場所には何も保存されず、同じ場所に以前に抽出されたカスタマイズは上書きされません。

MDSカスタマイズが含まれている構成ファイルのエクスポート

システムMBeanブラウザを使用して、adf-config.xmlまたはconnections.xmlなど、構成ファイルの現在のバージョン、つまり、MDSカスタマイズとマージされたベース・ドキュメントが含まれているバージョンのファイルを取得できます。

MDSカスタマイズを含むadf-config.xmlまたはconnections.xmlをシステムMBeanブラウザからエクスポートするには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。詳細は、次を参照してください。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalアプリケーションの場合: 「WebCenterポータル」メニューから、「システムMBeanブラウザ」を選択します。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「システムMBeanブラウザ」を選択します。

3. 「アプリケーション定義のMBean」を開きます。

4. エクスポートするファイルに関連付けられていたMBeanに移動します。
たとえば、adf-config.xmlまたはconnections.xmlのMBeansに移動する手順は、次のとおりです。

- adf-config.xml: 「oracle.adf.share.config」→「サーバー: (サーバー名)」→「アプリケーション: (アプリケーション名)」→「ADFConfig」→「ADFConfig」をクリックします。
WebCenter Portalアプリケーション: 「oracle.adf.share.config」→「サーバー: (WC_Spaces)」→「アプリケーション: (webcenter)」→「ADFConfig」→「ADFConfig」をクリックします。

- connections.xml: 「oracle.adf.share.connections」→「サーバー: (サーバー名)」→「アプリケーション: (アプリケーション名)」→「ADFConnnections」→「ADFConnnections」をクリックします。
WebCenter Portalアプリケーション: 「oracle.adf.share.config」→「サーバー: (WC_Spaces)」→「アプリケーション: (webcenter)」→「ADFConnections」→「ADFConnections」をクリックします。

5. 「操作」タブをクリックします。

6. 「エクスポート」をクリックします。
あるいは、「ExportToDisk」をクリックしてXMLファイルのサーバーの場所を指定します。

7. 「起動」をクリックします。
「エクスポート」操作を選択した場合、XMLファイルの内容が画面に表示されます(図A-1)。

図A-1 MDSカスタマイズが含まれている構成ファイルのエクスポート

構成の競合の処理

MDSカスタマイズは、挿入/削除/置換えが必要な要素およびその場所をコールするために、ベース・ドキュメントの要素への参照を使用します。要素が誤って今後の再デプロイから削除され、MDSにその要素への参照が含まれる場合、WebCenter PortalまたはPortal Frameworkアプリケーションの構成は破損している可能性があります。

たとえば、myconnectionという設計時に作成された接続で、MyPortalAppという、JDeveloperを使用して構築されたPortal Frameworkアプリケーションについて考えてみます。アプリケーションは、管理対象サーバーにデプロイされ、myconnectionのURLは変更されました。この変更は、新しいURLを使用するためにmyconnectionを更新する目的で、カスタマイズ手順としてMDSに格納されます。将来、myconnectionが設計時に、および同じMDS詳細を使用して再デプロイされたアプリケーションで削除される場合は、構成の競合が発生します。つまり、MDSのカスタマイズ手順がmyconnectionを検出しようとしますが、このような構成は存在しません。

この問題に直面しない可能性がありますが、adf-config.xmlまたはconnections.xmlに変更を行った後で、以前にデプロイされたアプリケーションが破損している可能性がある場合は、次のオプションを使用します。

- 競合の原因となっているMDSカスタマイズを手動で削除します。

1. adf-config.xmlまたはconnections.xmlのMDSカスタマイズ情報を抽出します。
たとえば、WebCenter Portalでは次のように指定します。

exportMetadata(application='webcenter', server='WC_Spaces',
toLocation='/tmp/mydata',
docs='/META-INF/mdssys/cust/adfshare/adfshare/adf-config.xml.xml')

exportMetadata(application='webcenter', server='WC_Spaces',
toLocation='/tmp/mydata',
docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

2. ドキュメントから競合の原因となっているカスタマイズ手順を削除します。

3. 変更されたドキュメントをMDSにインポートします。
たとえば、WebCenter Portalでは次のように指定します。

importMetadata(application='webcenter', server='WC_Spaces',
fromLocation='/tmp/mydata',
docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

importMetadata(application='webcenter', server='WC_Spaces',
fromLocation='/tmp/mydata',
docs='/META-INF/mdssys/cust/adfshare/adfshare/adf-config.xml.xml')

4. 管理対象サーバーを再起動します。

- adf-config.xmlまたはconnections.xmlのMDSカスタマイズを削除し、新しいEARファイルをデプロイして、Fusion Middleware ControlまたはWLSTを使用して最初からアプリケーションを再構成します。
詳細な手順は下の「adf-config.xmlまたはconnections.xmlのMDSカスタマイズの削除」を参照してください。

- 新しいパーティションまたはより古いカスタマイズが削除されるパーティションでEARファイルを再デプロイします。どちらの場合でも、adf-config.xmlまたはconnections.xmlのアプリケーション・カスタマイズ、およびすべてのユーザー・カスタマイズを含む、アプリケーションに対してMDSに以前に格納されたすべてのデータが失われます。Fusion Middleware ControlまたはWLSTを使用して、最初からアプリケーションを再構成する必要もあります。
『WebLogic Scripting Toolコマンド・リファレンス』のdeleteMetadataに関する項を参照してください。

adf-config.xmlまたはconnections.xmlのMDSカスタマイズの削除

この項では、connections.xmlまたはadf-config.xmlのすべてのデプロイ後の構成を削除する方法について説明します。この操作は元に戻せません。カスタマイズは永久に削除されます。

MDSカスタマイズを削除したい場合、次に示す手順を実行する前に、exportMetadataコマンドを使用して、既存のファイルのコピーを保存することをお薦めします。

1. exportMetadataコマンドを使用して、connections.xmlおよびadf-config.xmlをバックアップします。
たとえば、WebCenter Portalでは次のように指定します。

exportMetadata(application='webcenter', server='WC_Spaces',
toLocation='/tmp/mydata',
docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

exportMetadata(application='webcenter', server='WC_Spaces',
toLocation='/tmp/mydata',
docs='/META-INF/mdssys/cust/adfshare/adfshare/adf-config.xml.xml')

2. WLSTを使用して、connections.xmlのカスタマイズを削除します。
たとえば、WebCenter Portalでは次のように指定します。

deleteMetadata(application='webcenter', server='WC_Spaces',
docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

3. WLSTを使用して、adf-config.xmlのカスタマイズを削除します。
たとえば、WebCenter Portalでは次のように指定します。

deleteMetadata (application='webcenter', server='WC_Spaces', docs='/META-INF/mdssys/cust/adfshare/adfshare/adf-config.xml.xml')

4. アプリケーションを再起動します。

5. Fusion Middleware ControlまたはWLSTを使用して、最初からアプリケーションを再構成します。

A.1.2 web.xml

web.xmlは、標準のJ2EEアプリケーション・デプロイメント記述子ファイルで、アプリケーションの/META-INFディレクトリにあります。通常、web.xmlの実行時設定には、初期化パラメータ、カスタム・タグ・ライブラリの場所およびセキュリティ設定が含まれます。

ほとんどのweb.xmlプロパティは静的であるため、アプリケーションの.earファイルを生成してデプロイする前に設計時にアプリケーションに対して指定されます。デプロイされた環境で一部のプロパティを変更する必要がある場合は、「デプロイメント設定」ページの「Webモジュールの構成」画面から一部のプロパティを編集できます。第42.1.6.4項「Fusion Middleware Controlを使用したアプリケーションのデプロイ」の図42-11を参照してください。

connections.xmlおよびadf-config.xmlと異なり、web.xmlはデプロイ後のカスタマイズをMDSに格納しません。また、Fusion Middleware ControlまたはWLSTコマンドを使用して、WebCenter Portalなどの既存のデプロイでweb.xmlを変更できません。

注意:
WebCenter PortalまたはPortal Frameworkアプリケーションのweb.xmlは、デプロイ後に編集しないでください。インストール環境を破損するおそれがあるため、アプリケーションの.earファイルを展開することはお薦めしません。

web.xmlの変更が必要になるケースはごくわずかです。たとえば、次のものを変更する場合があります。

- コンテンツ・リポジトリ・アップロード・パラメータ: UPLOAD_MAX_MEMORY、UPLOAD_MAX_DISK_SPACEおよびUPLOAD_TEMP_DIR。
Portal Frameworkアプリケーションについては、第9.12項「最大ファイル・アップロード・サイズの変更」を参照してください。

WebCenter Portalでは、webcenter-config.xmlでuploadedFileMaxDiskSpaceパラメータを使用して、ファイルの最大アップロード・サイズを構成します。詳細は、付録A「webcenter-config.xml」を参照してください。

- HTTPセッションの失効後の経過時間。
Portal Frameworkアプリケーションについては、パフォーマンス・チューニング・ガイドのPortal FrameworkアプリケーションのHTTPセッション・タイムアウトの設定に関する項を参照してください。

WebCenter Portalについては、第48.10項「セッション・タイムアウト設定の指定」を参照してください。

- JSPページ・タイムアウト値。
Portal Frameworkアプリケーションについては、パフォーマンス・チューニング・ガイドのJSPページ・タイムアウトの設定に関する項を参照してください。

- Internet Explorerのブラウザ互換性通知。oracle.adf.view.rich.HIDE_UNSUPPORTED_BROWSER_ALERTSパラメータを設定します。

<!-- Suppress Browser Compatibility popup messages -->
<context-param>
<param-name>
oracle.adf.view.rich.HIDE_UNSUPPORTED_BROWSER_ALERTS
</param-name>
<param-value>IECompatibilityModes</param-value>
</context-param>

注意: かわりに、Internet Explorerユーザーは「互換表示」をオフにしてからWebCenter PortalアプリケーションまたはPortal Frameworkアプリケーションにアクセスできます。Internet Explorerでは、「ツール」メニューを選択し、「互換表示設定」を選択します。「互換表示設定」ダイアログで、すべてのオプションを選択解除し、「閉じる」をクリックします。

A.1.3 webcenter-config.xml

webcenter-config.xmlは、初期状態のアプリケーションであるWebCenter Portalの構成ファイルです。このファイルには、アプリケーション名、ロゴなどのアプリケーションレベルの設定が含まれています。このファイルのプロパティのほとんどは、WebCenter Portal管理画面から管理されるため、webcenter-config.xmlを直接編集する必要はありません。詳細は、第47章「ポータル・ビルダー管理内の「管理」ページの検索」および第48章「ポータル間のグローバルなデフォルト設定の構成」を参照してください。

webcenter-config.xmlの設定の手動変更が必要になるケースはごくわずかです。たとえば、次のものを変更する場合があります。

- 最大ファイル・アップロード・サイズ(uploadedFileMaxDiskSpace): デフォルト設定は2GBです。

この設定を変更する場合は、次のように、MDSからwebcenter-config.xmlの最新バージョンをエクスポートし、uploadedFileMaxDiskSpace値を変更する必要があります。

1. 最新のwebcenter-config.xmlをMDSからエクスポートします。
例:

exportMetadata(application='webcenter', server='WC_Spaces',
toLocation='/tmp/mydata',
docs='/oracle/webcenter/webcenterapp/metadata/mdssys/cust/site/webcenter/webcen
ter-config.xml.xml')

注意:
webcenter-config.xmlは、WebCenterの「ポータル・ビルダー管理」の「一般」ページでグローバルなデフォルト設定を初めて構成したときにMDSに作成されます。ファイルがMDSに存在しない場合、webcenter-config.xmlを直接編集できます。ファイルは、/oracle/webcenter/webcenterapp/metadata/webcenter-config.xmlにあります。

2. MDSからエクスポートされたwebcenter-config.xml.xmlをテキスト・エディタで開いて次のスニペットを追加し、必要に応じてuploadedFileMaxDiskSpace値を変更します。

<mds:replace
node="webcenter(xmlns(webcenter=http://xmlns.oracle.com/webcenter/webcenterapp)
)/webcenter:uploadedFileMaxDiskSpace"/>
<mds:insert
after="webcenter(xmlns(webcenter=http://xmlns.oracle.com/webcenter/webcenterapp
))/webcenter:custom-attributes" parent="webcenter">
<uploadedFileMaxDiskSpace
xmlns="http://xmlns.oracle.com/webcenter/webcenterapp">2147483648</uploadedFileMaxDiskSpace>
</mds:insert>

3. webcenter-config.xml.xmlを保存して閉じます。

4. 更新したwebcenter-config.xml.xmlファイルをMDSにインポートします。
例:

importMetadata(application='webcenter', server='WC_Spaces',
fromLocation='/tmp/mydata',
docs='/oracle/webcenter/webcenterapp/metadata/mdssys/cust/site/webcenter/webcen
ter-config.xml.xml')

A.2 クラスタ構成

Fusion Middleware Control、WLSTまたはシステムMBeanブラウザを介したすべてのデプロイ後の構成は、MDSリポジトリにカスタマイズとして格納されます。クラスタ環境では、MDSリポジトリはすべてのノード間で共有されるため、あるノードで行われたすべてのWebCenter Portal構成の変更は、クラスタ内のすべてのノードに表示されます。動的ではない構成の変更を反映させるには、クラスタ内のすべてのノードを再起動する必要があります。第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

WebCenter PortalアプリケーションおよびPortal Frameworkアプリケーションでは、Fusion Middleware ControlまたはWLSTを使用して行ったほとんどの構成変更は動的ではありません。たとえば、様々なツールおよびサービス(分析、アクティビティ・グラフ、お知らせ、ディスカッション、ドキュメント、イベント、メール、インスタント・メッセージおよびプレゼンス、検索、ワークリストなど)の接続詳細を追加または変更する場合は、アプリケーションの管理対象サーバーを再起動する必要があります。ただし、2つの例外があり、ポートレット・プロデューサおよび外部アプリケーションの登録は動的です。登録した新規ポートレット・プロデューサや外部アプリケーションは、アプリケーションで即座に使用可能になります。既存の接続に対して行った変更も即座に有効になります。

クラスタ環境で構成ファイルを編集する場合、クラスタ構成全体で同期を維持できるように、各クラスタ・メンバーで同一の変更が行われていることを確認する必要があります。

A.3 構成ツール

WebCenter PortalおよびPortal Frameworkのアプリケーション・デプロイメントを構成するための様々なツールがあります。この項では、利用可能なツールについて概説します。

注意:
WebCenter Portal構成パラメータのほとんどは不変であり、特に指定されないかぎり、実行時に変更できません。

デプロイ後、常にFusion Middleware ControlまたはWebLogic Scripting Tool (WLST)コマンドを使用して、最新の構成を確認するか、または構成を変更します。Fusion Middleware Controlでは、多くの場合、WebCenter Portal固有の構成画面を使用しますが、役立つシステムMBeanブラウザは、構成設定の確認および変更にも使用できます。

これらのツールの詳細は、下記を参照してください。

- Oracle Enterprise Manager Fusion Middleware Controlコンソール

- Oracle WebLogic Scripting Tool(WLST)

- システムMBeanブラウザ

これらのツールは常に現在の構成を示すため、通常、構成ファイルのコンテンツやadf-config.xmlまたはconnections.xmlなどのファイルのMDSカスタマイズ・データを調べたり、手動で変更する必要はありません。アプリケーションを再デプロイする場合に同じMDS詳細を使用する場合は、これらのツールを使用して実行されるすべての構成が保持されます。

使用する構成ツール

デプロイ後の構成のための任意のツールを使用できます。ただし、より新しいインスタンスをプロビジョニングしたり、オートメーション用に構成手順を複数回繰り返す場合は、Fusion Middleware Controlなどのツールを使用したスクリーンベースの構成は効率的ではありません。このような場合は、WLSTスクリプトを記述して、必要な構成を実行することを強くお薦めします。

Fusion Middleware Controlを使用して行うことが可能なすべての構成操作は、Oracle WebCenter PortalのWLSTコマンドを使用して実行できます。WLSTスクリプトを使用して、たとえば、アプリケーションのデプロイ、管理対象サーバーの作成、アプリケーションのMDSプロパティの設定、データ・ソースの構成などの他のコンポーネントを構成することもできます。

ドメイン構成を自動化する場合は、一連のWLSTコマンドとしてWebLogic Server管理コンソールで構成アクションを記録し、WLSTを使用してコマンドをリプレイすることができます。このトピックの詳細は、Oracle WebLogic Serverの概要のWLSTスクリプトの記録に関する項を参照してください。

ヒント:
OracleドキュメントでWebLogic Server管理コンソールの手順を記載している場合は、「レコード」オプションを使用して処理を自動化することを検討してください。

デプロイメント固有のプロパティを構成するための別の方法は、WebCenter PortalまたはPortal Frameworkアプリケーションのデプロイ・プランを使用することです。デプロイメントで変更される一般的なプロパティには次のものがあります。

- 接続用のホスト/ポートのプロパティ

- web.xmlの標準J2EEアーティファクト

第42.1.6項「WebLogic管理対象サーバーへのアプリケーションのデプロイ」を参照してください。

注意:
このように再構成が可能な場合は、行ったメタデータ・リポジトリおよびADF接続構成の変更は、デプロイ・プランの一部として保存されません。すなわち、デプロイされるアーカイブで保存されます。したがって、構成の変更を後続の再デプロイで繰り返す必要があります。
アプリケーションを複数回、再デプロイする場合は、Fusion Middleware ControlまたはWLSTコマンドを使用して、デプロイ後の構成を実行することをお薦めします。こうすれば、構成の変更はMDSで保存され、再デプロイ時にそのまま維持されます。

B WebCenter PortalのOracle HTTP Server構成

Oracle WebCenter PortalコンポーネントがOracle WebLogic Server上で実行している場合、Oracle WebLogic ServerへのフロントエンドとしてOracle HTTP Server (OHS)を設定できます。フロントエンドとしてOHSが必要なシナリオの一部は、次のとおりです。

- Site StudioとOracle WebCenter Content Server間でOSSOが正しく機能するため。これはOHSのmod_ossoを介して実現されます。

- Oracle WebLogic Serverクラスタ・ノード間で適切な負荷の分散を行うため。これはOHSのmod_wlを介して実現されます。

- OHSはOAMのWebGateコンポーネント用に必要です。

- OHSはリバース・プロキシとして使用されます。

これらの場合、mod_wl_ohsモジュールを構成して、リクエストをOHSからOracle WebLogic Serverへプロキシ可能にする必要があります。

サンプルのmod_wl_ohs.conf

Fusion Middleware Controlを使用してmod_wl_ohsモジュールを構成した後で、mod_wl_ohs.confファイルは例B-1のようになります。このファイルのデフォルトの場所は、OHS_HOME/Oracle_WT1/instances/instance1/config/OHS/ohs1/mod_wl_ohs.confです。

例B-1 WebCenter Portal: サンプルのmod_wl_ohs.confファイル

# WebCenter Portal Application
<Location /webcenter>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
</Location>
<Location /webcenterhelp>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
</Location>
<Location /rss>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
</Location>
<Location /rest>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
</Location>
# Discussions
<Location /owc_discussions/admin>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8890
</Location>
<Location /owc_discussions/OWCDiscussionsServicePublic>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8890
</Location>
<Location /owc_discussions/OWCDiscussionsServiceAuthenticated>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8890
</Location>
# SES Search
<Location /rsscrawl>
SetHandler weblogic-handler
WeblogicHost ses.example.com
WeblogicPort 7777
</Location>
<Location /sesUserAuth>
SetHandler weblogic-handler
WeblogicHost ses.example.com
WeblogicPort 7777
</Location>
# Portlets
<Location /portalTools>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8889
</Location>
<Location /wsrp-tools>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8889
</Location>
<Location /pagelets>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8889
</Location>
# Personalization
<Location /wcps>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8891
</Location>
# Activity Graph
<Location /activitygraph-engines>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8891
</Location>
# UCM
#  Web server context root for Oracle WebCenter Content Server
<Location /cs>
SetHandler weblogic-handler
WeblogicHost ucm.example.com
WeblogicPort 16200
</Location>
#  Enables Oracle WebCenter Content Server authentication
<Location /adfAuthentication>
SetHandler weblogic-handler
WeblogicHost ucm.example.com  # Same as /cs entry
WeblogicPort 16200            # Same as /cs entry
</Location>
#  SAML SSO
<Location /samlacs/acs>
SetHandler weblogic-handler
WeblogicHost ucm.example.com
WeblogicPort 16200
</Location>
# BPEL Server
<Location /workflow>
SetHandler weblogic-handler
WeblogicHost soa.example.com
WeblogicPort 8001
</Location>
# SharePoint
<Location /wcsdocs>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
</Location>
<Location /_vti_bin>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
</Location>

SSLディレクティブ

SSLを構成している場合、次の追加のディレクティブが必要です。

- WLProxySSL ON

- WLProxySSLPassThrough ON

たとえば、mod_wl_ohs.confエントリは例B-2のようになります。

例B-2 WebCenter Portal: SSLディレクティブを使用したmod_wl_ohs.confファイル

# WebCenter Portal Application
<Location /webcenter>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
WLProxySSL ON
WLProxySSLPassThrough ON
</Location>
<Location /webcenterhelp>
SetHandler weblogic-handler
WeblogicHost webcenter.example.com
WeblogicPort 8888
WLProxySSL ON
WLProxySSLPassThrough ON
</Location>
...

フロントエンド・リスニング・ホストおよびフロントエンド・リスニング・ポート

Oracle HTTP Server (OHS)フロントエンドがサイト・エントリ・ポイントでもある場合、Oracle WebLogic Server管理コンソールを使用して、OHSフロントエンドを使用する各サーバーに対してFrontEnd HostおよびFrontEnd HTTP Portを設定します。

クラスタのエラー・ページの構成

次のようにErrorPageパラメータをmod_wl_ohs.confに組み込みます。

<Location /webcenter>
WebLogicCluster
app1.mycompany.com:8888,app2.mycompany.com:8888,app3.company.com:8888

SetHandler weblogic-handler
ErrorPage http://mycompany.com/error.html
</Location>

すべてのWC_Spaces管理対象サーバーが停止している場合、ユーザーはhttp://company.com/error.htmlにリダイレクトされます。任意の管理対象サーバーがオンラインになると、ユーザーは通常どおりWebCenter Portalにアクセスできます。

Oracle HTTP Server管理者ガイドのConfiguring mod_wl_ohsに関する項も参照してください。

C サード・パーティ製品のサポート

この付録は、WebCenter PortalアプリケーションおよびPortal Frameworkアプリケーションと併用できるサード・パーティ製品の一覧表です。

表C-1 WebCenter Portal: サード・パーティ製品のサポート

機能

製品とバージョン

詳細

データベース

IBM DB2 9.7以降

Microsoft SQL Server 2005、Microsoft SQL Server 2008

Oracle Fusion Middleware 11gR1のシステム要件およびサポートされるプラットフォームも参照

アイデンティティ・ストア

サポートされているLDAPアイデンティティ・ストアのタイプ

第30.2.3項「デフォルトのアイデンティティ・ストアおよびポリシー・ストア」

ドキュメント

Microsoft Office SharePoint Server (MOSS) 2007 SP2

第9.3項「Microsoft SharePointリポジトリの構成」

ドキュメント

Microsoft Windows SharePoint Services (WSS)バージョン3 SP2

第9.3項「Microsoft SharePointリポジトリの構成」

イベント

Microsoft Exchange Server 2003Microsoft Exchange Server 2007、Microsoft Exchange Server 2010、Microsoft Exchange Server 2013

第13.3項「イベントの個人イベントに関する前提条件」

メール

Microsoft Exchange Server 2007、Microsoft Exchange Server 2010、Microsoft Exchange Server 2013

第15.3.2.1項「WebCenter PortalのためのMicrosoft Exchange Server 2007、2010または2013の構成」

プレゼンス

Microsoft Office Live Communications Server (LCS) 2005 R2

第14.2.1項「Microsoft Live Communications Server (LCS)の前提条件」

プレゼンス

Microsoft Office Communications Server (LCS) 2007 SP1

第14.2.2項「Microsoft Office Communications Server (OCS)の前提条件」

プレゼンス

Microsoft Lync 2010

第14.2.3項「Microsoft Lyncの前提条件」

Office統合

Microsoft Office 2007、Microsoft Office 2010、Microsoft Office 2003

第26.2項「Microsoft Office統合の構成」

D Oracle Secure Enterprise Searchの評価のための構成

この付録では、評価の目的でWebCenter PortalでOracle Secure Enterprise Search (SES)を構成する方法について説明します。この構成は本番環境ではお薦めしません。

この付録には次のトピックが含まれます:

- 第D.1項「構成スクリプトの理解」

- 第D.2項「Oracle SESのアイデンティティ管理システムの構成」

- 第D.3項「Oracle SESのためのOracle WebCenter Content Serverの設定」

- 第D.4項「Oracle SESのためのOracle WebCenter Portalディスカッション・サーバーの設定」

- 第D.5項「WebCenter Portalを検索するためのOracle SESの設定」

- 第D.6項「構成スクリプトの実行」

ヒント:
第18章「WebCenter PortalでのOracle Secure Enterprise Searchの管理」を読んで検討し、この簡易的な構成を試す前に、必要な手順の詳細を理解しておいてください。

権限:
この章の内容は、WebCenter Portalシステム管理者を対象としています。この章のタスクを実行するには、次のロールが付与されている必要があります。

- WebLogic Server Adminロール。Oracle WebLogic Server管理コンソールから付与します。

- WebCenter Portal Administratorロール。ポータル・ビルダー管理から付与します。

- Portal FrameworkアプリケーションのAdministratorロール。アプリケーションの管理コンソールから付与します。

ロールと権限の詳細は、第1.8項「管理操作、ロールおよびツールの理解」を参照してください。

D.1 構成スクリプトの理解

WebCenter Portalには、評価目的でOracle SESを構成できるスクリプト(ConfigureSES.py)が用意されています。

注意:

- この評価設定は、SSLおよびSSOが有効化されていない環境で使用するためのものです。

- このスクリプトはOracle SES 11.1.2.2以降でサポートされます。第D.5.5項「Oracle SESファセットおよびソート属性の構成」は、Oracle SES 11.2.2.2に対してのみ適用可能です。

このスクリプトは次のタスクを実行します。

- WebCenter PortalでのOracle SESへの接続の作成

- Oracle SESでのフェデレーション・トラステッド・エンティティの作成

- WebCenter Portalでのクロール・ロールを持つクロール・ユーザーの作成

- Oracle SESでのContent Serverソースの作成

- Oracle SESでのディスカッション・ソースとお知らせソースの作成

- Oracle SESでのWebCenterソースの作成

次のタスクは、スクリプトを実行する前に構成する必要があります。

- 第D.2項「Oracle SESのアイデンティティ管理システムの構成」

- 第D.3項「Oracle SESのためのOracle WebCenter Content Serverの設定」

- 第D.4項「Oracle SESのためのOracle WebCenter Portalディスカッション・サーバーの設定」

- 第D.5項「WebCenter Portalを検索するためのOracle SESの設定」

D.2 Oracle SESのアイデンティティ管理システムの構成

この項では、WebCenter Portalを検索するために必要なOracle SESの初期構成について説明します。

1. Oracle SES管理ユーザー名とインストール時に指定されたパスワードでOracle SESにログオンします。

- ブラウザを開き、Oracle SESインストール後に指定されたURLを入力します。(これは、http://host:port/search/admin/index.jspの形式となります。)

- Oracle SES 11.2.2.2では、デフォルトの管理ユーザー名はsearchsysですが、インストール中に別の名前を指定できます。

- Oracle SES 11.1.2.2では、管理ユーザー名はeqsysです。

2. Oracle SESは、ユーザーを検証および認証するためにアイデンティティ管理システムとともに構成する必要があります。これはセキュアな検索のために必要です。そうすることで、検索時に、アクセス権限に基づいてユーザーが表示することを許可される結果のみが返されるようになります。
WebCenter PortalはOracle SESとの通信時にアイデンティティ伝播を使用するため、WebCenter Portalのユーザー・ベースはOracle SESのユーザー・ベースと一致している必要があります。そうするための1つの方法は、WebCenter PortalとOracle SESを、Oracle Internet Directoryなどの同じアイデンティティ管理システムに対して構成することです。

注意:
サポートされているすべてのアイデンティティ管理システムについては、第30.2.3項「デフォルトのアイデンティティ・ストアおよびポリシー・ストア」を参照してください。
各Oracle SESインスタンスに対して、1つのアイデンティティ・プラグインのみを設定できます。すべてのリポジトリ(Oracle WebCenter Content Server、Oracle WebCenter Portal Discussions Server、およびOracle WebCenter Portal)は、Oracle SESと同じユーザー・ベースを共有する必要があります。

Oracle SESには、Oracle Internet Directory、Oracle WebCenter Content Server、Microsoft Active Directoryなどのアイデンティティ管理システムのための多数のアイデンティティ・プラグインが含まれています。詳細は、製品に含まれるOracle SESドキュメントを参照してください。(これらは、Oracle Fusion Middlewareドキュメント・ライブラリのWebCenter Portal製品の領域にリストされています。)

次の例では、Oracle Internet Directory用のアイデンティティ・プラグインを設定します。

1. Oracle SES管理ツールで、「グローバル設定」→「アイデンティティ管理設定」ページに移動し、利用可能なアイデンティティ・プラグインから「Oracle Internet Directory」を選択し、「アクティブ化」をクリックします。

2. 次の値を入力します。
ホスト名: Oracle Internet Directoryが実行されているコンピュータのホスト名

ポート: Oracle Internet Directoryのポート番号

SSLの使用: trueまたはfalse

レルム: dc=us,dc=oracle,dc=comなどのOracle Internet Directoryレルム

ユーザー名: cn=orcladminなどのOracle Internet Directory管理ユーザー名

パスワード: 管理ユーザーのパスワード

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

3. WebCenter Portalエンド・ユーザーが検索時にセキュアに伝播されるようにするため、各Oracle SESインスタンスには1つの信頼できるエンティティが必要です。(信頼できるエンティティにより、Oracle SES上で問合せを実行する際にアプリケーションが自身をOracle SESに対して認証し、ユーザーをアサートできるようになります。)この信頼できるエンティティは、Oracle SESの背後のアイデンティティ管理サーバーに存在するユーザーにすることも、Oracle SESで内部的に作成されるユーザーにすることもできます。
ConfigureSES.pyスクリプト、WLSTまたはOracle SESで信頼できるエンティティを作成できます。

ConfigureSES.pyスクリプトで信頼できるエンティティを作成するには、ConfiguresSES.propertiesを次の値に設定します。

do.config.entity=true
proxy.entity.name=<Federation Trusted Entity name>
prosy.entity.password=<Federation Trusted Entity password>

WLSTで信頼できるエンティティを作成するには、createFederationTrustedEntityコマンドを使用します。例:

createFederationTrustedEntity(appName='webcenter', sesUrl='http://mySEShost.com:7777/search/api/admin/AdminService', sesPassword='mySESAdminPassword'
entityName='myTrustedEntityUser', entityPassword='myTrustedEntityUserPassword', desc='Trusted entity for WebCenter Portal', sesSchema='eqsys')

コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のcreateFederationTrustedEntityに関する項を参照してください。

Oracle SESで信頼できるエンティティを作成するには、次の手順に従ってください。

1. Oracle SES管理ツールで、「グローバル設定」→「フェデレーション・トラステッド・エンティティ」ページに移動します。

2. 信頼できるエンティティの名前を入力します。これは、WebCenter Portalが検索時に(エンド・ユーザー・アイデンティティをOracle SESに伝播する前に)自身をOracle SESに対して認証するために使用する名前です。
エンティティがアクティブなアイデンティティ・プラグインによって認証されるようにするには:

- エンティティ名がアイデンティティ管理システム内に存在するユーザーの名前であることを確認します。

- パスワード・フィールドを空白のままにします。

- 「アイデンティティ・プラグインを認証に使用」チェック・ボックスを選択します。

- アクティブなアイデンティティ・プラグインの「認証属性」に対応する認証の属性値を入力します。

エンティティがOracle SESによって認証されるようにするには:

- 任意のユーザー名(例: wcsearch)とパスワード(例: MyPassword1)を入力します。

- 「アイデンティティ・プラグインを認証に使用」チェック・ボックスは選択しないでください。

詳細は、Oracle SESの「フェデレーション・トラステッド・エンティティ」ページのオンライン・ヘルプを参照してください。

注意:
この信頼できるエンティティ名とパスワードは、後でWLSTコマンドcreateSESConnectionにおけるappUserおよびappPasswordプロパティとして必要になります。

注意:
参考までに、この章では次のサンプル・ユーザー名が使用されています。

- wcsearch: Oracle SESフェデレーション・トラステッド・エンティティのユーザー

- mycrawladmin: リスト、ページ・メタデータ、ポータル、プロファイルなどの特定のオブジェクトをクロールするための、WebCenter Portalおよびアイデンティティ管理システム内のクロール管理ユーザー

- sescrawer (または管理ユーザー): sescrawlerrole (またはadmin)ロールを持つOracle WebCenter Content Serverのクロール管理ユーザー

D.3 Oracle SESのためのOracle WebCenter Content Serverの設定

この項では、Oracle SESによりクロール可能となるようにOracle WebCenter Content Server(特に、WebCenter Portalがドキュメントの格納に使用するContent Server)を構成する方法について説明します。

次の手順はContent Server内で実行する必要があります。

関連項目:
Content Serverのロールおよびユーザーの管理方法を示すContent Serverオンライン・ヘルプ

1. クロール・ユーザーを作成します。
adminロールを持つユーザーでクロールする場合、クロール・ユーザーとして管理ユーザー・アカウントを使用します。

非管理ユーザーでクロールする場合、次の手順に従います。

1. sescrawlerroleロールを作成します。

2. ユーザーsescrawlerを作成し、これにsescrawlerroleロールを割り当てます。このユーザーがOracle SES内にContent Serverを作成します。

3. sceCrawlerRole=sescrawlerroleをconfig.cfg (MW_HOME/user_projects/domains/yourdomain/ucm/cs/config内)に追加します。
または、sceCrawlerRole=sescrawlerrole行をWebCenter Content Serverのユーザー・インタフェース(「管理」→「一般構成」→「追加の構成変数」)に追加できます。

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

3. Content Serverコンソールで、SESCrawlerExportコンポーネントをコンテンツ・サーバーにインストールします(まだインストールされていない場合)。

1. システム管理者としてContent Serverにログオンします。例: http://host:port/cs。

2. 「管理」ドロップダウン・メニューから、「管理サーバー」(図D-1)を選択します。

図D-1 Content Serverの管理

3. インスタンス名のボタンをクリックします。

4. 左側のペインのメニュー・リストから「コンポーネント・マネージャ」をクリックします(図D-2)。

図D-2 Content Serverの「コンポーネント・マネージャ」

5. 「統合」の下の「SESCrawlerExport」を選択し、「更新」をクリックします。

6. 構成パラメータを入力します。(構成パラメータは、インストール後に変更することもできます。)
SESCrawlerExportにより提供される認証および認可APIのセキュリティを無効にします。つまり、「Secure APIの無効化」をfalseに設定します。これにより、SESCrawlerExportによって提供されるセキュリティが、Content Serverによってではなく内部的に実行されるようになります。

さらに、クラスタ化環境の場合のみ、feedLocパラメータで、Content Serverのノードによりアクセスされる共有ディスク上の場所を指定する必要があります。また、これらの各ノードは同じようにこの場所を参照する必要があります(例: sharedDrive/dir1/dir2)。これは指定されたデフォルトの場所(相対パス)ではないことに注意してください。

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

4. Content Serverリポジトリのスナップショットを撮ります。

1. システム管理者としてContent Serverにログオンします。例: http://host:port/cs。

2. 「管理」ドロップダウン・メニューから、「SESCrawlerExport」を選択します。

3. 「すべてのソース」を選択し、「スナップショットの取得」(図D-3)をクリックします。

図D-3 Content Serverのスナップショット

ソースの最初のクロールまたはその後のフル・クロールの前にスナップショットを撮ることは重要です。

スナップショットにより、コンポーネントのインストール時に指定された場所にconfigFile.xmlが生成され、feedLocの下のソース名のサブディレクトリにフィードが作成されます。

5. Content ServerがWebレンディション用に構成されている場合、Content Server内のアイテムはPDF形式でレンダリングされます。コンテンツ・アイテムのネイティブMIMEタイプのレンディションは上書きされます。たとえば、Microsoft Office WordドキュメントのMIMEタイプはapplication/mswordですが、Content ServerでWebレンディションを使用すると、MIMEタイプはapplication/pdfになります。Mimetypeパラメータをapplication/mswordに設定して検索問合せを実行しても、Wordドキュメントは返されません。
Content ServerがWebレンディションを使用するように構成されている場合、Content Serverメタデータ・リストにdFormat値が含まれるように構成し、必要なMIMEタイプがOracle SESにエクスポートされるようにする必要があります。これは、MIMEタイプで検索を絞り込めるようにするために必要です。

1. 「SESCrawlerExport管理」ページに戻り、「SESCrawlerExportの構成」(図D-4)をクリックします。

図D-4 Content Serverのスナップショット

2. デフォルトでは、「メタデータ・リスト」フィールドは空白です(図D-5)。オプションで、必要な任意のカスタム・メタデータ値(xで始まる)をこのフィールドに追加します。たとえば、「メタデータ・リスト」の次のエントリには、カスタム属性が含まれています。

xCollectionID, xWCTags, xRegionDefinition

図D-5 Content Serverの「メタデータ・リスト」

3. 11.1.1.8より前のバージョンのContent Serverを使用している場合、dFormat値をこの「メタデータ・リスト」フィールドに追加する必要があります。空白の場合のデフォルト値を変更すると、そのデフォルト値は削除されるため、これらを再度追加する必要があります。(Content Server 11.1.1.8.0には、検索に必要なほとんどの値(dFormatを含む)が含まれています。)
したがって、11.1.1.8より前のバージョンのContent Serverを使用している場合、次のように「メタデータ・リスト」(および「x」で始まるカスタム・メタデータ・フィールド)にデフォルト値を手動で入力する必要があります。

dFormat,dID,dDocName,dRevLabel,dDocType,dDocAccount,dSecurityGroup,
dOriginalName,dReleaseDate,dOutDate,dDocCreator,dDocLastModifier,dDocCreate
dDate,dDocFunction

6. ファセット検索用の「サムネイル・オプション」を構成します。

注意:
Oracle SES 11.2.2.2はドキュメント・サムネイルをサポートしますが、以前のリリースのOracle SESはこれをサポートしません。

「管理」タブで、「サムネイル・オプションの構成」を選択し、検索結果でのドキュメント・サムネイルを有効にします。デフォルト設定のままにし、「更新」をクリックします(図D-6)。

図D-6 サムネイル・オプションの構成

関連項目:
この製品に付属しているDeployment Guide.pdf

D.4 Oracle SESのためのOracle WebCenter Portalディスカッション・サーバーの設定

この項では、Oracle SESによりクロール可能となるようにOracle WebCenter Portalのディスカッション・サーバー(特に、WebCenter Portalがディスカッションおよびお知らせの格納に使用するディスカッション・サーバー)を構成する方法について説明します。

注意:
WebCenter Portal (Oracleデータベースを含む)およびOracle WebCenter Portalのディスカッション・サーバーの新しいインストールがある場合は、この手順は必要ありません。これは、アップグレードされた(パッチが適用された)インスタンスを使用している場合にのみ必要になります。
該当するデータ・ソースのデータベース・スキーマの詳細は、Oracle WebLogic Serverコンソールから検索できます。

1. リポジトリ作成ユーティリティ(RCU)を実行して、ディスカッション・クローラのWebCenter Portalコンポーネントがシステムにインストールされていることを確認します。

- OracleデータベースおよびMicrosoft SQL Serverデータベース:
MyPrefix_DISCUSSIONSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

MyPrefix_DISCUSSIONS_CRAWLERユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に構成されていることを検証します。

- IBM DB2データベース:
MyPrefix_DSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。

MyPrefix_DCユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に構成されていることを検証します。

注意:
IBM DB2データベースの場合、MyPrefixは5文字に制限されます。IBM DB2では、認証にオペレーティング・システム・ユーザーが使用されます(つまり、データベース・ユーザーは実質的にはオペレーティング・システム・ユーザーです)。オペレーティング・システムによっては、ユーザー名に8文字の制限があるため、これは8文字のユーザー名にする必要があります。

ディスカッション・クローラ・コンポーネントがインストールされていない場合、RCUを使用してこれをインストールする必要がありますが、このとき、接頭辞は、Oracle WebCenter Portalのディスカッション・サーバー・コンポーネントと同じものを選択します。また、RCUでの表領域の指定手順で、デフォルトの表領域としてPrefix_IAS_DISCUSSIONSを選択します。これにより、Oracle SESのユーザーがインストールされます。

詳細は、第42章「Portal Frameworkアプリケーションのデプロイ」を参照してください。

2. インスタンスがWebCenter 11.1.1.1.0のみからアップグレードされる場合、次のツールを実行して(まだ実行していない場合)、Oracle WebCenter Portalのディスカッション・サーバー・データベース・スキーマ内のデータをアップグレードします。

注意:
この手順は、インスタンスをWebCenter 11.1.1.1.0からアップグレードした場合にのみ必要になります。WebCenter 11.1.1.1.0より後にインストールされたインスタンスでは、必要ありません。

java -jar \
MW_HOME/discussionserver/discussionserver-upgradeforses.jar \
<command_line_parameters>

ここでcommand_line_parametersは、次のMDSスキーマの詳細とディスカッション・データベース・スキーマの詳細です。

-mds_jdbc_user user_id \
-mds_jdbc_password password \
-mds_jdbc_url url \
-discussions_jdbc_user user_id \
-discussions_jdbc_password password \
-discussions_jdbc_url url

ここでmds_jdbc_user、mds_jdbc_passwordおよびmds_jdbc_urlは、MDSスキーマにログインするための値で、discussions_jdbc_user、discussions_jdbc_passwordおよびdiscussions_jdbc_urlは、ディスカッション・データベース・スキーマにログインするための値です。

例:

java -jar MW_HOME/as11r1wc/discussionserver/discussionserver-upgradeforses.jar\
-mds_jdbc_user foo \
-mds_jdbc_password MyPassword1 \
-mds_jdbc_url jdbc:oracle:thin:@host:port:SID \
-discussions_jdbc_user foo \
-discussions_jdbc_password MyPassword1 \
-discussions_jdbc_url jdbc:oracle:thin:@host:port:SID

D.5 WebCenter Portalを検索するためのOracle SESの設定

この項の手順は、Oracle SES管理ツールで実行する必要があります。

次の手順が必要です。

1. 第D.5.1項「Oracle SES管理ツールへのログオン」

2. 第D.5.2項「ドキュメントを検索するためのOracle SESの設定」

3. 第D.5.3項「ディスカッションおよびお知らせを検索するためのOracle SESの設定」

4. 第D.5.4項「WebCenter Portalクローラからのコンポーネントの除外」

5. 第D.5.5項「Oracle SESファセットおよびソート属性の構成」

6. 第D.5.6項「追加のOracle SES構成」

関連項目:
Oracle SESに必要なすべてのパッチがインストールされていることを確認します。必要なパッチの最新情報は、『Oracle WebCenter Portalインストレーション・ガイド』の検索のバックエンド要件に関する項およびリリース・ノートを参照してください。
Oracle SES構成の詳細は、製品に付属のOracle SESドキュメントを参照してください。(これらは、Oracle Fusion Middlewareドキュメント・ライブラリのWebCenter Portal製品の領域にリストされています。)

D.5.1 Oracle SES管理ツールへのログオン

Oracle SES管理ツールを開きます。

1. ブラウザを開き、インストール後に指定されたURLを入力します。(これは、http://host:port/search/admin/index.jspの形式となります。)

2. Oracle SES管理ユーザー名とインストール時に指定されたパスワードでログオンします。

- Oracle SES 11.2.2.2では、デフォルトの管理ユーザー名はsearchsysですが、インストール中に別の名前を指定できます。

- Oracle SES 11.1.2.2では、管理ユーザー名はeqsysです。

D.5.2 ドキュメントを検索するためのOracle SESの設定

Oracle SESを使用してWebCenter Portalドキュメントを検索するには、まずドキュメント・サービス・マネージャを(ドキュメント・サービス・インスタンスおよびドキュメント・サービス・パイプラインとともに)設定する必要があります。

1. ドキュメント・サービス・マネージャを構成します(Oracle SESインスタンスごとに1回)。

注意:
ドキュメント・サービスは、ドキュメントがクロールされる際のドキュメントの処理に関与するプラグインです。ドキュメント・サービスにより、WebCenter Portal(またはPortal Framework)アプリケーションで使用されるドキュメントに索引付け可能な属性をWebCenter Portalで追加できるようになります。
検索属性名は一意である必要があります。2つの属性に同じ名前を使用することはできません。たとえば、属性が文字列のデータ型で存在する場合に、名前が同じで異なるデータ型の別の属性がクローラにより検出されると、そのクローラは2番目の属性を無視します。新しい属性を作成する前に、Oracle SESドキュメント内のOracle SES属性名とタイプのリストを必ず確認してください。

1. 「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。「新規マネージャの作成」を選択し、「次へ」をクリックして次のパラメータを入力します。
マネージャ・クラス名: oracle.webcenter.search.crawl.ucm.ses.WcUcmDsManager

マネージャJARファイル名: search-crawl-ucm.jar

注意:
webcenter_search_ses_plugins.zipファイルによりORACLE_HOME/search/lib/plugins/doc/search-crawl-ucm.jarがインストールされます。

「次へ」をクリックして、「終了」をクリックします(図D-7)。

図D-7 Oracle SESでのドキュメント・サービス・マネージャの作成

2. ドキュメント・サービス・インスタンスを作成します。
再度、「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。今回は、「利用可能なマネージャから選択」で「Secure Enterprise Search WebCenter UCMプラグイン」を選択し、「次へ」をクリックします(図D-8)。

図D-8 ドキュメント・サービスの作成

次のパラメータを入力します。

インスタンス名: ドキュメント・パイプラインを作成するときに使用する名前をここに入力します。

WebCenterアプリケーション名: バックエンドContent Serverでこのアプリケーションを識別するために使用される一意の名前。

接続名: WebCenter Portal (またはPortal Frameworkアプリケーション)がドキュメントの保存に使用するプライマリContent Server接続の名前。

WebCenter URL接頭辞: アプリケーションがデプロイされるホストおよびポート。例: http://myhost:8888。

注意:
Fusion Middleware ControlまたはlistDocumentsSpacesPropertiesコマンドを使用して、第18.5.1項「Oracle SESのためのWebCenter Portalの設定」の説明に従って、アプリケーション名と接続名を特定してください。

3. ドキュメント・サービス・パイプラインを作成します。これによりドキュメント・サービス・インスタンスが呼び出されます。
再度、「グローバル設定」→「ドキュメント・サービス」ページで、「ドキュメント・サービス・パイプライン」セクションの下の「作成」をクリックします(図D-9)。

図D-9 ドキュメント・サービス・パイプラインの作成

4. 「ドキュメント・サービス・パイプラインの作成」ページで、このパイプラインの名前を入力します。前の手順で作成したドキュメント・サービス・インスタンスが「使用可能なサービス」の下にリストされるはずです。このドキュメント・サービス・インスタンスを選択し、矢印ボタンを使用してこれを「パイプラインで使用済」の下に移動します。

注意:
作成したこのパイプラインは、ドキュメント・クローラを作成するためにConfigureSES.pyスクリプトで使用されます。第D.6項「構成スクリプトの実行」の「ucm.pipeline」フィールドに、このパイプライン名を指定する必要があります。

D.5.3 ディスカッションおよびお知らせを検索するためのOracle SESの設定

Oracle SESを使用してWebCenter Portalのディスカッションとお知らせを検索するには、まず、ディスカッション用に3つとお知らせ用に1つのOracle SESデータベース・ソースを設定する必要があります。3つのディスカッション・リソースは、フォーラム用、フォーラム内のトピック用およびフォーラム内の応答用です。これら個別のソースを使用すると、ユーザーは、フォーラム内のすべてのメッセージおよび応答の結果を表示せずにフォーラムの検索結果を表示できます。

たとえば、ディスカッション・ソースに次のものがあるとします。

- ソース名GS_ForumsおよびビューFORUMCRAWLER_VW

- ソース名GS_TopicsおよびビューTHREADCRAWLER_VW

- ソース名GS_RepliesおよびビューMESSAGECRAWLER_VW

お知らせのソースのソース名をGS_Announcements、ビューをANNOUNCEMENTS_VWにできます。

注意:
Oracle、Microsoft SQL ServerおよびIBM DB2データベースでは、手順が多少異なります。

1. JDBCドライバを構成します。

1. Microsoft SQL ServerまたはIBM DB2データベースをクロールするには、適切なJDBCドライバjarファイルをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。

注意:

- Microsoft SQL Serverの場合: Microsoft JDBCドライバ・ファイル、sqljdbc.jarおよびsqljdbc4.jarをコピーします。

- DB2: IBMドライバ・ファイルdb2jcc.jarおよびdb2jcc_license_cu.jarをコピーします(IBM DB2 UDBクライアントから取得可能)。

JDBCドライバがJRE 1.5用とJRE 1.6用で異なる場合(たとえば、JRE 1.5ではsqljdbc.jar、JRE 1.6ではsqljdbc4.jarなど)、次の手順を実行します。

- 両方のドライバJarをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。

- JRE 1.6バージョンのドライバJar (SQLServerの場合sqljdbc4.jar)のエントリを、ORACLE_HOME/search/config/searchctl.confのCLASSPATH要素に追加します。

- 中間層を再起動します。

2. drivers.propertiesファイルをDatabaseName:DriverClassNameの情報を使用して更新します。

3. JRE 1.5 JDBCドライバJarファイル名を、appsjdbc.jarおよびDBCrawler.jarのMETA-INF/MANIFEST.MF内のクラスパスに追加します。
例: 変更前

Class-Path:  sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar

変更後

Class-Path:  db2jcc.jar sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar

変更前

Class-Path: appsjdbc.jar

変更後

Class-Path: db2jcc.jar appsjdbc.jar

KEYという名前が付けられていないkey属性の場合、drivers.propertiesファイル内のJDBCドライバ情報を変更して、database_name: driver_class_name, key_attribute_nameのようにキー属性名を指定します。

たとえば、IDという名前のキー属性の場合、次のようになります。

oracle : oracle.jdbc.driver.OracleDriver, ID

クロール問合せでは、キー値列名の別名としてkey_attribute_nameを使用します。この例で、IDはKEYVALの別名です。

SELECT keyval id, content, url, lastmodifieddate, lang FROM sales_only

OracleおよびSQL Serverデータベース: drivers.propertiesになにも指定されていない場合、次のデフォルト・ドライバが使用されます。

- Oracle: oracle.jdbc.driver.OracleDriver

- SQL Server: com.microsoft.sqlserver.jdbc.SQLServerDriver

2. IBM DB2データベースの場合のみ、次の手順が必要となります。

1. データベース・クローラ・ソースを使用するクローラが実行されていないことを確認します。Oracle SES管理ツールの「ホーム」→「スケジュール」ページで、クローラの進捗状況とステータスを確認します。(「ステータスのリフレッシュ」をクリックします。)

2. appsjdbc.jarファイルとDBCrawler.jarファイルを再作成します。クローラが失敗してログ・ファイルに次のエラーが記録されないよう、META-INF/MANIFEST.MFが正しく更新されていることを確認してください。

EQP-80406: Loading JDBC driver failed

3. Oracle_Home/search/lib/plugins/oracleapplications/drivers.propertiesファイルを変更して次の行を追加します。

db2: com.ibm.db2.jcc.DB2Driver

4. ORACLE_HOME/search/config/searchctl.confのCLASSPATH要素にドライバJar (db2jcc.jar)を追加します。例:

#CLASS PATH
CLASSPATH=ORACLE_HOME/search/webapp/config:ORACLE_HOME/search/webapp/
SESAuthenticator.jar:ORACLE_HOME/search/lib/plugins/commons-plugins-
stubs.jar :ORACLE_HOME/search/lib/plugins/oracleapplications/db2jcc.jar

5. ORACLE_HOME/search/config/searchctl.confファイルのJVM_OPTIONSを編集して、システム・プロパティ"-Doracle.home=ORACLE_HOME/search"を追加します。例:

JVM_OPTIONS= -Djava.awt.headless=true
-Dweblogic.RootDirectory=ORACLE_HOME/search/base_domain
-Doracle.home=ORACLE_HOME/search

6. ORACLE_HOME/search/lib/plugins/oracleapplications/pluginmessages.jarファイルをORACLE_HOME/search/libディレクトリにコピーします。

7. データベース・ソースを作成します。正しい認可問合せを入力し、「セキュリティ属性の付与」で使用した属性名が認可問合せで使用する属性名と一致していることを確認します。一致していない場合、ドキュメントの検索の際、ユーザーは結果を得ることができません。

D.5.4 WebCenter Portalクローラからのコンポーネントの除外

WebCenter Portalクローラは次のコンポーネントを検索するためにデータを収集します。

- oracle.webcenter.peopleconnections.profile (ユーザー)

- oracle.webcenter.community (ポータル)

- oracle.webcenter.page (ページ・メタデータ)

- oracle.webcenter.list (リスト)

これらのコンポーネントのいずれかの検索を無効にするには、URLパラメータ?excludedServiceIdsを使用します。つまり、Oracle SES管理ツールのOracle WebCenterソースの「ホーム」→「ソース」ページで、パラメータConfiguration URLの?excludedServiceIdsを、除外するサービスIDのカンマ区切りリストと同一に設定します。

例D-1 ピープル・コネクション・プロファイルのクロールの無効化

http://host:port/rsscrawl?excludedServiceIds=oracle.webcenter.peopleconnections.profile

例D-2 ページ・メタデータのクロールの無効化

http://host:port/rsscrawl?excludedServiceIds=oracle.webcenter.page

例D-3 プロファイルおよびページ・メタデータのクロールの無効化

http://host:port/rsscrawl?excludedServiceIds=oracle.webcenter.peopleconnections.profile,oracle.webcenter.page

D.5.5 Oracle SESファセットおよびソート属性の構成

ファセットは、新しい検索を実行せずにインデックス化されたデータを移動することによってユーザーが検索を詳細設定できるOracle SESオブジェクトです。まず、Oracle SESで(提供されるファイルを使用して)ファセットを定義する必要があります。Oracle SESで定義されたファセットは、「ツールとサービス」→「検索」管理ページを使用してWebCenter Portalで適用されます。

注意:
Oracle SES 11.2.2.2は、WebCenter Portalによるファセット検索をサポートしていますが、以前のリリースのOracle SESの検索はこれをサポートしていません。この項は、Oracle SES 11.2.2.2にのみ適用可能です。

WebCenter Portalには、Oracle SES Admin APIコマンド行インタフェース用の次の入力ファイルが用意されています。

- facet.xml: Oracle SESでファセットを構成します。

- searchAttrSortable.xml: 絶対ソートの属性を定義します。

これらのファイルをoracle.webcenter.framework/ses/webcenter_portal_ses_admin.zipで見つけます。このファイルを解凍し、readme.txtファイルの指示に従います。

これら2つのファイルをOracle SESから実行すると、次のファセットが作成されます。

- Author

- Last Modified Date

- Mimetype

- Tags

- Scope GUID (これは「ポータル」ファセットとして表示されます。この値は、検索結果ページでポータル表示名に変換されます。)

- Service ID (このファセットはユーザー・インタフェースには表示されません。有効なすべてのツールおよびサービスは検索結果ページに表示されます。)

注意:
facet.xmlスクリプトおよびsearchAttrSortable.xmlスクリプトは必須です。WebCenter Portalで検索するには、Oracle SESでのファセット作成のみでは不十分です。
また、Scope GUIDおよびService IDファセットは必須です。ファセット名では、大/小文字が区別されます。これらのファセット名を正確に指定する必要があります。

これらのファイルを実行した後、Oracle SES管理ツールの「グローバル設定」→「ファセット」ページにファセットが表示されます(図D-10)。

図D-10 Oracle SESファセット

新しいファセットを作成するには、「グローバル設定」→「ファセット」ページで「作成」をクリックします。ファセット値の生成元であるファセットの名前および検索属性を入力します。「文字列」ファセット・タイプには、パス・デリミタも入力する必要があります。これは、選択したファセット・ツリー・ノードのファセット・ツリー階層を問合せページに表示するための境界用に使用する1文字で、たとえば、"tools/power tool/drills"の"/"がパス・デリミタです。ファセット・ツリーが1レベルの深さの場合(つまりこのノードに子ノードがない場合)、これを空白に設定できます。

「作成してカスタマイズ」をクリックしてファセットを作成し、「ファセットの編集」画面でこのノードを構成します。日付タイプまたは数値タイプのファセットのファセット・ノードを構成できます。たとえば、「最終変更日」ファセットの場合、「昨年」、「先月」、「今日」、特定の2つの日付の間などのノードを作成できます。

「ノード構成」タブには、ファセット階層がツリー形式およびXML形式で表示され、ここで選択したファセット・ノードの子ノードを追加、編集および削除できます。ファセット・ノードを編集した後、「適用」をクリックして変更内容を保存します。

注意:
Scope GUIDファセットまたはService IDファセットは変更または削除しないでください。

Oracle SESで行われた変更は、アプリケーション・スペシャリストが「ツールとサービス」→「検索」管理ページに移動するとWebCenter Portalで適用されます。WebCenter Portalでは、この「検索」管理ページが開くまでファセットの変更が検出されません。WebCenter Portalでは、使用するために選択したファセットがポータルごとに記憶されます。

D.5.6 追加のOracle SES構成

必要に応じて、セキュリティ・フィルタの有効期間を構成できます。これにより、システム内のユーザーの認可ポリシーがリフレッシュされます。ユーザー・ポリシーが頻繁に変更される場合は、有効期間を短くするのが最適です。(この付録では、例としてOracle Internet Directoryアイデンティティ・プラグインを使用しています。)

たとえば、Oracle SES管理ツールの「グローバル設定」→「問合せ構成」ページの「セキュア検索の構成」の下で、「セキュリティ・フィルタ有効期間(分)」に0を入力します。

セキュリティ・フィルタ有効期間の有効な値は、0分(キャッシュなし)から526500分(1年間のキャッシュ)です。

注意:
ConfigureSES.pyはsetSESVersion WLSTコマンドを実行するため、このコマンドはこの章の構成の一部として必要ありません。

D.6 構成スクリプトの実行

オラクル社のConfigureSES.py Pythonスクリプトを使用すると、残りのOracle SES構成を簡素化できます。この自動構成の内容は次のとおりです。

- WebCenter PortalでのOracle SESへの接続の作成

- Oracle SESでのフェデレーション・トラステッド・エンティティの作成

- WebCenter Portalでのクロール・ロールを持つクロール・ユーザーの作成

- Oracle SESでのContent Serverソースの作成

- Oracle SESでのディスカッション・ソースとお知らせソースの作成

- Oracle SESでのWebCenterソースの作成

スクリプトとそのプロパティ・ファイルは、WCP_ORACLE_HOME/webcenter/scripts/ses_11.2.2.2/ディレクトリにあります。

次の手順に従ってスクリプトを実行します。

1. ディレクトリを参照するように環境変数を設定します。例:

setenv SESDIR Oracle_WC1/webcenter/scripts/ses_11.1.2.2/

2. 適切な値でConfigureSES.propertiesファイルを更新します。例D-4に、WebCenter Portalアプリケーション用のサンプル値を示します。

例D-4 WebCenter Portalアプリケーション

# Required update:
#   Actions can be selected or deselected. See properties with 'do' prefix.
#   All 'do*' properties have 'false' value.
#   Change value to 'true' after meeting prerequisite by filling properties with
no values.
#   For properties with values, check that they are valid in your environment.
#
# Preset values:
#   Documents crawler and Jive database crawler sections contain values of common
repository used by WebCenter development team.

# ----------------------------------

# Prerequisite - wls instance must be started
admin.user=weblogic
admin.url=app_server.example.com:7005
admin.server=app_server.example.com
admin.password=welcome1
webcenter.host=app_server.example.com
webcenter.port=8892

# Prerequisite - SES instance must be started
ses.host=ses_server.example.com
ses.port=5720
ses.schema=searchsys
ses.admin.password=welcome1

# Prerequisite - Entity name must not exist
do.config.entity=true
proxy.entity.name=webcenterproxy
proxy.entity.password=welcome1

# Prerequisite - webcenter-wls instance must be started
do.config.spaces.crawl.user=true
do.config.connection=true
do.spaces.crawl=true
spaces.crawl.password=welcome1
spaces.crawl.authuseridformat=nickname

# Prerequisite - UCM instance must be started
do.document.crawl=true
ucm.host=ucm_server.example.com
ucm.port=9400
ucm.source=default
ucm.admin.user=weblogic
ucm.admin.password=welcome1
ucm.crawl.authuseridformat=nickname

# Prerequisite - Documents Instance and Documents Pipeline on SES must be created
ucm.pipeline=stake04-8888

# Prerequisite - Jive database must be started
do.discussions.crawl=false
discussions.host=discussions_server.example.com
discussions.port=8890
discussions.db.connstring=jdbc:oracle:thin:@wcdb.example.com:1521/wcdb
discussions.db.admin.user=WC_DISCUSSIONS_CRAWLER
discussions.db.admin.password=welcome1
discussions.crawl.authuseridformat=nickname

3. デフォルト・ディレクトリをwlst.shスクリプトのディレクトリに設定します。例:

cd Oracle_WC1/oracle/as11gr1wc/common/bin/

4. ConfigureSES.pyスクリプトをConfigureSES.propertiesで実行します。例:

./wlst.sh $SESDIR/ConfigureSES.py $SESDIR/ConfigureSES.properties

5. スクリプトが正常に完了したら、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Spaces)を再起動する必要があります。詳細は、管理者ガイドのWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

E WebCenter Portalのライフサイクル中のラベル付け

この付録では、内部ラベルを使用して、ポータル・インスタンスを保持する方法について説明します(ステージング・ポータルと本番ポータルの同期化など)。内部ラベルが一致した場合のみ、ポータルの変更を別のポータル・インスタンスに伝播できます。

各ポータル・デプロイメントは内部ラベルを維持します。ポータルを別のサーバーにデプロイまたは伝播するときには、ソース・ポータルのラベルがポータルとともにターゲットにコピーされます。同様に、ポータルを(エクスポートまたはバックアップの目的で)アーカイブにデプロイする場合、ポータルのラベルは.parファイル内に含められます。

表E-1に、ラベル付けのシナリオを示します。このシナリオでは、Salesポータルがステージングから本番にデプロイされた後、ステージングと本番の間で伝播と再デプロイメントが行われます。

注意:
ポータル・アーカイブのエクスポートには、ポータルが通過するフェーズに応じてPTL_またはPTLEXPPORTAL_というパターンのラベルが含められます。少なくとも1回のデプロイメントを実行したポータルには、PTL_のラベル・パターンが含められます。(エクスポート時に)まだデプロイされていないポータルには、PTLEXPPORTAL_のラベル・パターンが含められます。

表E-1 ポータル・デプロイメントおよび伝播の内部ラベル付け

手順

アクション

ステージングのラベル

本番のラベル

1

ステージングのSalesポータルを本番にデプロイします

WLSTコマンドdeployWebCenterPortalを使用します

PTL_GUID_#$#_1_user

PTLEXPPORTAL_GUID_#$#_1_user

PTL_GUID_#$#_1_user

2

ステージングのSalesポータルを変更して、その変更を本番に伝播します

WLSTコマンドpropagateWebCenterPortalを使用します

PTL_GUID_#$#_1_user

PTLEXPPORTAL_GUID_#$#_1_user

PTL_GUID_#$#_2_user

PTL_GUID_#$#_1_user

-

PTL_GUID_#$#_2_user

3

ステージングのSalesポータルを本番に再デプロイします

WLSTコマンドdeployWebCenterPortalを使用します

PTL_GUID_#$#_1_user

PTLEXPPORTAL_GUID_#$#_1_user

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

PTLEXPPORTAL_GUID_#$#_2_user

PTL_GUID_#$#_1_user

-

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

-

4

ステージングのSalesポータルの変更を本番に伝播します

WLSTコマンドpropagateWebCenterPortalを使用します

PTL_GUID_#$#_1_user

PTLEXPPORTAL_GUID_#$#_1_user

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

PTLEXPPORTAL_GUID_#$#_2_user

PTL_GUID_#$#_4_user

PTL_GUID_#$#_1_user

-

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

-

PTL_GUID_#$#_4_user

5

本番ポータルをバックアップします

WLSTコマンドexportWebCenterPortalsを使用します

PTL_GUID_#$#_1_user

PTLEXPPORTAL_GUID_#$#_1_user

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

PTLEXPPORTAL_GUID_#$#_2_user

PTL_GUID_#$#_4_user

-

PTL_GUID_#$#_1_user

-

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

-

PTL_GUID_#$#_4_user

PTLEXPPORTAL_GUID_#$#_1_user

6

ステージング・ポータルをバックアップします

WLSTコマンドexportWebCenterPortalsを使用します

PTL_GUID_#$#_1_user

PTLEXPPORTAL_GUID_#$#_1_user

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

PTLEXPPORTAL_GUID_#$#_2_user

PTL_GUID_#$#_4_user

-

PTLEXPPORTAL_GUID_#$#_3_user

PTL_GUID_#$#_1_user

-

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

-

PTL_GUID_#$#_4_user

PTLEXPPORTAL_GUID_#$#_1_user

-

7

ステージングのSalesポータルの変更を本番に伝播します

WLSTコマンドpropagateWebCenterPortalを使用します

PTL_GUID_#$#_1_user

PTLEXPPORTAL_GUID_#$#_1_user

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

PTLEXPPORTAL_GUID_#$#_2_user

PTL_GUID_#$#_4_user

-

PTLEXPPORTAL_GUID_#$#_3_user

PTL_GUID_#$#_5_user

PTL_GUID_#$#_1_user

-

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

-

PTL_GUID_#$#_4_user

PTLEXPPORTAL_GUID_#$#_1_user

-

PTL_GUID_#$#_5_user

8

本番が破損したため、本番Salesポータルを最新のバックアップ・アーカイブ(手順5で作成)からリストアします

WLSTコマンドimportWebCenterPortalsを使用します

PTL_GUID_#$#_1_user

PTLEXPPORTAL_GUID_#$#_1_user

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

PTLEXPPORTAL_GUID_#$#_2_user

PTL_GUID_#$#_4_user

-

PTLEXPPORTAL_GUID_#$#_3_user

PTL_GUID_#$#_5_user

-

PTL_GUID_#$#_1_user

-

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

-

PTLEXPPORTAL_GUID_#$#_1_user

-

-

-

PTL_GUID_#$#_4_user

9

ステージングのSalesポータルの変更を本番に伝播します

WLSTコマンドpropagateWebCenterPortalを使用します

PTL_GUID_#$#_1_user

PTLEXPPORTAL_GUID_#$#_1_user

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

PTLEXPPORTAL_GUID_#$#_2_user

PTL_GUID_#$#_4_user

-

PTLEXPPORTAL_GUID_#$#_3_user

PTL_GUID_#$#_5_user

-

PTL_GUID_#$#_6_user

PTL_GUID_#$#_1_user

-

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

-

PTLEXPPORTAL_GUID_#$#_1_user

-

-

-

PTL_GUID_#$#_4_user

PTL_GUID_#$#_6_user

10

ステージングが破損したため、ステージングSalesポータルを最新のバックアップ・アーカイブ(手順6で作成)からリストアします

WLSTコマンドimportWebCenterPortalsを使用します

PTL_GUID_#$#_1_user

PTLEXPPORTAL_GUID_#$#_1_user

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

PTLEXPPORTAL_GUID_#$#_2_user

PTLEXPPORTAL_GUID_#$#_3_user

-

-

-

-

-

PTL_GUID_#$#_4_user

PTL_GUID_#$#_1_user

-

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

-

PTLEXPPORTAL_GUID_#$#_1_user

-

-

-

PTL_GUID_#$#_4_user

PTL_GUID_#$#_6_user

-

11

ステージングのSalesポータルを本番に伝播します

本番のポータルがステージングのものよりも新しいため伝播は失敗します。

Salesポータルを再デプロイするか、またはステージングで本番ポータルをリストアします(それぞれ手順12および13)。

-

12

本番からSalesポータルをエクスポートします

PTL_GUID_#$#_1_user

PTLEXPPORTAL_GUID_#$#_1_user

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

PTLEXPPORTAL_GUID_#$#_2_user

PTLEXPPORTAL_GUID_#$#_3_user

-

-

-

-

-

PTL_GUID_#$#_4_user

PTL_GUID_#$#_1_user

-

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

-

PTLEXPPORTAL_GUID_#$#_1_user

-

-

-

PTL_GUID_#$#_4_user

PTL_GUID_#$#_6_user

-

PTLEXPPORTAL_GUID_#$#_2_user

13

本番からエクスポートしたSalesポータルのアーカイブ(手順12)からステージングでSalesポータルをリストアします

PTL_GUID_#$#_1_user

PTLEXPPORTAL_GUID_#$#_1_user

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

PTLEXPPORTAL_GUID_#$#_2_user

PTLEXPPORTAL_GUID_#$#_3_user

-

-

-

-

-

PTL_GUID_#$#_4_user

-

PTL_GUID_#$#_6_user

PTL_GUID_#$#_1_user

-

PTL_GUID_#$#_2_user

PTL_GUID_#$#_3_user

-

PTLEXPPORTAL_GUID_#$#_1_user

-

-

-

PTL_GUID_#$#_4_user

PTL_GUID_#$#_6_user

-

PTLEXPPORTAL_GUID_#$#_2_user

-

ラベルは内部での使用専用であるため、これらのラベルを表示したり管理したりする必要はありません。ソース・ラベルとターゲット・ラベルに不一致がある場合、エラー・メッセージが表示されます。例:

シナリオ1: ターゲットにデプロイしていないポータルを伝播しようとしています。ポータルの内部デプロイメント・ラベルがターゲットにないため、次のメッセージが表示されます。

ポータル<portal_name>のデプロイメントの内部ラベルはターゲットに存在しません。ポータルがターゲットにデプロイされていることを確認してください。

シナリオ2: ポータルを伝播しようとしていますが、ターゲットのラベルがソースに存在しません。ソースのラベルがターゲットのラベルより下位であるため、次のメッセージが表示されます。

ポータルを伝播できません。ポータル{0}のソースおよびターゲットの内部ラベルが一致しません。ターゲットでポータルを再デプロイしてポータルを同期した後に、その他の伝播を試行してください。

ソース・ポータルがターゲットよりも前のラベルでリストアされた場合、この種の不一致が発生する可能性があります。

F WebCenter PortalへのWikiコンテンツの移行

この付録では、カスタムwiki抽出ツールをドキュメント移行ユーティリティと組み合せて使用することで、wikiコンテンツをConfluenceなどのwikiアプリケーションからWebCenter Portalに移行する方法について説明します。カスタムwiki抽出ツールは、ドキュメント移行ユーティリティを使用して、wikiコンテンツをWebCenter Portalコンテンツ・リポジトリにインポート可能なアーカイブ形式に抽出します。ポータル、ポータル・テンプレート、wikiドキュメントおよびwikiページに対してContent Serverで作成したコンテンツの理解とともにドキュメント移行ユーティリティおよびそのアーカイブの形式についての詳細な理解が必要です。

注意:
WebCenter Portalのこのリリース(11.1.1.9.0)では、ポータル・フォルダとポータル・テンプレート・フォルダのエクスポートまたはインポートにドキュメント移行ユーティリティを使用しないでください。このリリース以降、コンテンツ・フォルダは、ポータルまたはポータル・テンプレートでエクスポートされます。詳細は、第40.1項「ポータルのデプロイ」および第40.2項「ポータル・テンプレートのデプロイ」を参照してください。

この付録には次のトピックが含まれます:

- 第F.1項「WikiドキュメントおよびWikiページの理解」

- 第F.2項「ドキュメント移行ユーティリティの理解」

- 第F.3項「ソースWikiアプリケーションからWebCenter Portalへのデータの移行」

F.1 WikiドキュメントおよびWikiページの理解

この項では、WebCenter Portalでのwikiドキュメントおよびwikiページの形式とその動作方法について説明します。WebCenter Portalでのwikiドキュメントおよびwikiページの詳細は、『Oracle WebCenter Portalの使用』の「Wikiでの作業」を参照してください。

この項には次のトピックが含まれます:

- 第F.1.1項「Wikiドキュメントの理解」

- 第F.1.2項「Wikiページの理解」

F.1.1 Wikiドキュメントの理解

WebCenter Portalでは、ドキュメント・タスク・フローを使用してwikiドキュメントを作成できます。これらのドキュメントは、ポータル内に作成されたフォルダ階層の任意の場所に置くことができます。Wikiドキュメントは他のタイプのドキュメントとともに存在するか、または単一フォルダ内にすべてのwikiドキュメントを配置することを選択できます。

wikiドキュメントがWebCenter Portalで作成される場合、HTMLドキュメントが作成され、Content Serverにチェックインされます。このwikiドキュメントには、ドキュメントが通常のHTMLドキュメントではなく、wikiドキュメントであることをWebCenter Portalに伝える特別なメタデータ値が含まれます。これらのメタデータ値は次のとおりです。

dDocType = Application
dDocFunction = wiki
dOriginalName (document filename) = <wikiName>.htm

前述のメタデータを含むWebCenter Portalのドキュメントを開く場合、WebCenter Portalはそれをwikiドキュメントとして表示します。

F.1.2 Wikiページの理解

WebCenter Portalで、Wikiページ・テンプレートに基づいてページを作成することによりwikiページを作成できます。wikiページに移動すると、wikiドキュメントが表示されます。ポータルの表示テンプレートに従って、クリックして、ポータルにすべてのwikiページをリストすることができる「Wiki」メニューを表示することができます。wikiページの作成方法の詳細は、『Oracle WebCenter Portalの使用』の「Wikiでの作業」を参照してください。

wikiページがWebCenter Portalで作成される場合、次のアーティファクトがContent Serverで作成されます。

- wikiフォルダが、wikiページが作成されているポータルのフォルダに作成され、wikiフォルダの名前はwikiページ名と同じですが、特殊文字が削除されています。
/RootFolder/PortalFolder/wikiPageNameFolder/

ルート・フォルダは、Content Serverでフォルダ・サービスとしてFolders_gまたはFrameworkFoldersのどちらが有効化されているかに依存します。Folders_gが有効化されている場合、wikiフォルダは次のパスに作成されます。

/WebCenter/PortalFolder/wikiPageNameFolder/

FrameworkFoldersが有効化されている場合、wikiフォルダは次のパスに作成されます: /Enterprise Libraries/PortalFolder/wikiPageNameFolder/

- ドキュメントは、次のメタデータとともにwikiフォルダ内に作成されます。

- dDocTitle = ドキュメント・タイトル(wikiページ名と同じ名前で、拡張子.htmを持つ)

- dOriginalName = ドキュメント・ファイル名(dDocTitleと同じ)

- dDocFunction = wiki

- dDocType = Application

- xWCPageID = wikiページのJSPXページの名前

これは例を使用して適切に示されます。wikiページが作成されているポータルがMarketingで、作成されているwikiページがWiki1の場合、次のアーティファクトがContent Serverで作成されます。

- フォルダ:

- Folders_g設定内のフォルダの場所: /WebCenter/Marketing/Wiki1

- FrameworkFolders設定内のフォルダの場所: /Enterprise Libraries/Marketing/Wiki1

- ドキュメント:
Folders_g設定内のドキュメントの場所: /WebCenter/Marketing/Wiki1/Wiki1.htm

FrameworkFolders設定内のドキュメントの場所:

/Enterprise Libraries/Marketing/Wiki1/Wiki1.htm

ドキュメントの属性セット:

- dDocTitle= Wiki1.htm

- dOriginalName = Wiki1.htm

- dDocFunction = 'wiki'

- dDocType = 'Application'

- xWCPageID = Wiki1.jspx

wikiページに移動すると、次の処理が実行されます。

- Content Serverが次の場所のドキュメントを問い合せます。
/RootFolder/PortalFolder/wikiPageNameFolder/wikiPageName.htm

- ドキュメントが見つかった場合は、wikiドキュメントとして表示されます。

- ドキュメントでwikiページが見つからない場合は、wikiフォルダのコンテンツが表示されます。

F.2 ドキュメント移行ユーティリティの理解

WebCenter Portalのこのリリース(11.1.1.9.0)では、第F.3項「ソースWikiアプリケーションからWebCenter Portalへのデータの移行」で説明されているように、既存のwikiアプリケーションからWebCenter Portalへのコンテンツの移行には、ドキュメント移行ユーティリティのみを使用してください。

注意:
ポータル・フォルダとポータル・テンプレート・フォルダのエクスポートまたはインポートにドキュメント移行ユーティリティを使用しないでください。このリリースでは、コンテンツ・フォルダは、ポータルまたはポータル・テンプレートでエクスポートされます。詳細は、第40.1項「ポータルのデプロイ」および第40.2項「ポータル・テンプレートのデプロイ」を参照してください。

この項では、ドキュメント移行ユーティリティについて説明します。この付録には、次の項があります。

- 第F.2.1項「ドキュメント移行ユーティリティのエクスポート機能の理解」

- 第F.2.2項「ドキュメント移行ユーティリティのインポート機能の理解」

F.2.1 ドキュメント移行ユーティリティのエクスポート機能の理解

エクスポート時に、指定されたポータルおよびポータル・テンプレートのContent Serverに格納されたドキュメント・コンテンツは、ドキュメント移行アーカイブに抽出されます。ドキュメント移行アーカイブは、ポータルまたはポータル・テンプレートのすべてのコンテンツをアーカイブのその独自のトップレベル・フォルダに抽出します。このフォルダの名前は、Content Serverのポータルまたはポータル・テンプレート・フォルダの内部GUIDに基づいています。

ドキュメント移行アーカイブには、エクスポートでは各ポータルまたはポータル・テンプレートのルート・フォルダが含まれます。つまり、4つのポータルからコンテンツをエクスポートする場合、アーカイブには4つのルート・フォルダがあります。これらのルート・フォルダの名前は、Content Serverの対応するポータルまたはポータル・テンプレート・フォルダの内部GUIDに基づいています。

ポータルまたはポータル・テンプレートごとに1つのアーカイブを持つために、ドキュメント移行ユーティリティは一度に1つのポータル/ポータル・テンプレートおよび固有のアーカイブ名を指定して、コールされる必要があります。

アーカイブ内の各トップ・レベル・フォルダにはXMLドキュメントが存在し(ExportImportData.xml)、そのルート・フォルダにあるデータについて詳細に説明しています(つまり、そのポータルまたはポータル・テンプレート用にエクスポートされたデータについて説明しています)。また、インポート時にメンテナンスされる、ソースContent Server内のフォルダおよびファイルのすべてのメタデータも含まれています。アーカイブの形式の詳細は、第F.2項「ドキュメント移行ユーティリティの理解」を参照してください。また、ソースとターゲット間でメンテナンスされるメタデータの詳細は、第F.2.2.1項「ドキュメント移行ユーティリティのメタデータの処理方法の理解」を参照してください。

コンテンツがエクスポートされるポータルまたはポータル・テンプレートがある場合、エクスポート中に次が発生します。

- 一時ディレクトリが作成されます。

- 各ポータルまたはポータル・テンプレートに対して

- ディレクトリが、その名前がContent Serverの対応するフォルダのGUIDである一時ディレクトリに作成されます

- ExportImportData.xmlドキュメントがその新しいディレクトリ内に作成されます

- Content Serverは、ポータル/ポータル・テンプレートのコンテンツを問い合せます

- コンテンツがある場合、コンテンツが読み込まれ、フォルダおよびドキュメントに関する情報がExportImportData.xmlドキュメントに記述されます。実際のファイルは、Content Serverとしてフォルダ階層を維持するディレクトリにダウンロードされます。たとえば、Content Serverで、ドキュメントdoc1.docがフォルダFolder1内にある場合、次に示すように、ドキュメントはFolder1の下のルート・フォルダに追加されます。

/<tmpDir>/<portalFolder>/Folder1/doc1.doc

- すべてのコンテンツが抽出された後で、一時ディレクトリのコンテンツ全体がドキュメント移行アーカイブに圧縮されます。

F.2.2 ドキュメント移行ユーティリティのインポート機能の理解

ドキュメント移行ユーティリティを使用してコンテンツをインポートする前に、ターゲットのポータルまたはポータル・テンプレート(あるいはその両方)がターゲットContent Serverに存在している必要があります。これらのフォルダがContent Serverに存在しない場合、ドキュメント・コンテンツのインポートは失敗します。

注意:
ソース内にあるのと同じ名前を持つポータルまたはポータル・テンプレートをターゲット内に作成して、動作させることはできません。この操作を行うと、Content Server内のフォルダの名前がソース内にあるフォルダと同じ名前になりますが、GUIDは異なります。このフォルダGUIDは、WebCenter Portal内のポータルとContent Server内のフォルダを結び付けるために使用され、さらにエクスポート・アーカイブ内のデータとターゲットContent Server内のターゲット・フォルダを同期化するのにも使用されます。

インポート時に、ドキュメント移行アーカイブが読み込まれ、各ポータルまたはポータル・テンプレートのデータごとに、ターゲットContent Serverの対応するポータルまたはポータル・テンプレートのフォルダにコンテンツが再作成されます。アーカイブのトップ・レベル・フォルダの名前は、ターゲットContent Serverインスタンスのポータルまたはポータル・テンプレート・フォルダと同期化するために使用されます。ターゲットContent Serverのポータルまたはポータル・テンプレート・フォルダにコンテンツがすでに含まれている場合、そのコンテンツはインポート処理が開始される前に削除されます。

注意:
ファイル内のすべてのプロパティを指定して、ドキュメント移行ユーティリティを実行する場合、デフォルトの動作は、プロパティ・ファイルのCheckExistingContentsプロパティ(値はtrueまたはfalse)を指定することにより上書きできます。falseに設定される場合、ターゲット・フォルダが既存のコンテンツに対してチェックされないようにデフォルトの動作がオーバーライドされ、既存のコンテンツは削除されません。この設定がfalseの場合は注意する必要があります。ターゲットのコンテンツが同じコンテンツIDを持つか、同じフォルダのコンテンツが同じファイル名を持つ場合、インポートは失敗します。

各トップ・レベル・フォルダ内にあるXMLドキュメント(ExportImportData.xml)は、インポートを実行するために使用されます。このドキュメントには、ターゲットContent Server内で再作成するファイルとフォルダの階層が記述されています。また、アーティファクトの作成時に使用されるメタデータ、またドキュメントについては、アップロード時に使用するアーカイブのネイティブ・ファイルのパスも含まれています。アーカイブの形式の詳細は、第F.2項「ドキュメント移行ユーティリティの理解」を参照してください。

インポート時に、次の操作が実行されます。

- ドキュメント移行アーカイブが一時ディレクトリに解凍されます。

- アーカイブのルートにある各フォルダに対して(ポータルまたはポータル・テンプレートを表す)

- 対応するフォルダは、ターゲットContent Serverインスタンスから取得されます(Content ServerのフォルダのGUIDであるフォルダ名を使用)。

- ExportImportData.xmlドキュメントが読み込まれます

- ExportImportData.xmlで記述される各フォルダまたはファイルに対して、コンテンツがターゲット・インスタンスで再作成されます。
フォルダおよびファイルのExportImportData.xmlドキュメントの属性は、作成されるコンテンツのメタデータとして使用され、ファイルはアーカイブの対応する場所からアップロードされます。

- インポートが成功した場合は、その最後に、この一時ディレクトリは削除されます。完了する前にインポートが失敗する場合は、この一時ディレクトリはそのまま残ります。

F.2.2.1 ドキュメント移行ユーティリティのメタデータの処理方法の理解

ドキュメント移行ユーティリティは、ソースとターゲット間でできるだけ多くのメタデータを維持します。ただし、多くの内部メタデータ(IDなど)は維持されません。次のメタデータは、エクスポート・セットには含まれません。

- 作成日(例: Folders_g設定のdCreateDate、dReleaseDate、dDocLastModifiedDate)などの日付メタデータ。FrameworkFolders設定のfCreateDate and fLastModifiedDate)。

- ドキュメントに対して

- ドキュメントの改訂またはレンディションの内部識別子(例: Folders_g設定のdID、dDocおよびFrameworkFolders設定のdIDおよびdDocId)がありません。コンテンツID、dDocNameが含まれることに注意してください。

- ドキュメントが存在するフォルダのID (例: Folders_g設定のxCollectionIDおよびFrameworkFolders設定のfParentGUID)

- Web表示可能レンディションがありません。これらはドキュメントがターゲットにチェックインされるときに再作成されるためです

- 実際のファイルに関する情報がありません(たとえば、そのファイル・タイプやMIMEタイプ)。これらはドキュメントがターゲットにチェックインされるときに設定されるためです

- ターゲットでドキュメントを作成するときには関連がないため、チェックアウト済、リリース済状態などのステータス情報(たとえば、dIsCheckedOut、dReleaseState)がありません

- フォルダに対して

- 親フォルダIDなどの内部識別子またはパス、または独自のパス(例: Folders_g設定のhasCollectionID、dCollectionID、dCollectionGUID、hasCollectionPath、and dCollectionPath、およびFrameworkFolders設定のfParentGUID、fFolderGUID、fApplicationGUID)がありません。

- ストレージ・ルール。これはターゲットContent Serverの構成に依存しているためです

- セキュリティ・グループまたは他のセキュリティ権限。これらはコンテンツがターゲットで作成されるときに設定されるためです(例: Folders_g設定のdSecurityGroup、dRead、canReadCollection、およびFrameworkFolders設定のfSecurityGroup)

維持されるメタデータ:

- フォルダ名やドキュメント・タイトルなどのアーティファクトの名前(例: Folders_g設定のdCollectionNameおよびdDocTitle、およびFrameworkFolders設定のfFolderName、fDisplayNameおよびdDocTitle)。

- コンテンツを作成し、それを変更したユーザーの名前(例: Folders_g設定のdCollectionOwnerおよびdDocOwner、およびFrameworkFolders設定のfOwnerおよびdDocOwner)。

- dDocFunction、dDocType、xWCPageIDなどのWikiメタ―データ

- ドキュメントに対して

- ドキュメントに対してアップロードするファイルの名前(dOriginalName)

- コンテンツID (dDocName)
インポート時に、同じコンテンツIDを持つコンテンツ・アイテムがターゲットContent Serverにすでに存在する場合、インポートは失敗します。プロパティCheckExistingContents=falseを設定して、インポートを再実行する場合、コンテンツIDエラーを回避するために、ターゲット・フォルダに、インポートされるアーカイブから取得されたコンテンツが含まれていないことを確認します。

- カスタム・メタデータ(たとえば、myCustomInteger)。

F.2.2.2 ドキュメント移行のアーカイブ

ドキュメント移行ユーティリティは、ソースContent Serverからコンテンツをエクスポートするときに、単一のアーカイブを作成します。このアーカイブは、ドキュメント移行ユーティリティを実行して、ターゲット環境にデータをインポートする際に使用されます。ドキュメント移行アーカイブには、特定のレイアウトがあり、アーカイブがこのレイアウトに一致しない場合、ドキュメント移行ユーティリティのインポートは失敗します。

アーカイブ形式

次にドキュメント移行アーカイブのレイアウトについて説明します。

アーカイブのトップ・レベルには、データがエクスポートされた、各ポータル/ポータル・テンプレートのフォルダがあります。

- 単一のポータル/ポータル・テンプレートがエクスポートされている場合、ルート・フォルダは1つしかありません。複数のポータル/ポータル・テンプレートがエクスポートされている場合は、複数のルート・フォルダがあります。

- ルート・フォルダ名は、Content Serverの対応するフォルダの内部GUIDと同じです(たとえば、13828FE1-75D8-4A0B-A53B-A76AE78C1AE6)

各トップ・レベル・フォルダには、そのポータルまたはポータル・テンプレートに対してターゲットContent Serverで再作成するためにファイルおよびフォルダの階層を記述するExportImportData.xmlドキュメントがあります。このドキュメントには、アーティファクトの作成時に使用されるメタデータが含まれています(xCollectionID、isreadonly、xStorageRuleなどの内部メタデータは含まれません)。ドキュメントに対して、アップロードで使用するためのアーカイブのネイティブ・ファイルへのパスが含まれています。

各トップレベル・ポータルおよびポータル・テンプレート・フォルダにはエクスポート済ドキュメントがあります。トップレベル・フォルダ内のドキュメントのレイアウトは、ソースContent Serverのポータル・スペースおよびポータル・テンプレートのレイアウトに似ています。たとえば、ドキュメントdoc1.docがfolder1にある場合、アーカイブのトップレベル・フォルダには、doc1.docが存在するフォルダfolder1が含まれています。トップレベル・フォルダのドキュメント・ファイル/フォルダ構造は、ExportImportData.xmlに記載されている階層に一致する必要があります。これは、インポート・コードがターゲットにドキュメントをアップロードしながら、そのドキュメントに記載されているドキュメントのネイティブ・ファイルを検出できるからです。ソースのポータルまたはポータル・テンプレート・フォルダの空のフォルダは、アーカイブにはありません。ただし、これらのフォルダは、ターゲットで再作成されるように、ExportImportData.xmlドキュメントで依然として記載されています。

簡略化された概要では、これは次のように表示されます。

- Portal1トップ・レベル・フォルダ:

- ExportImportData.xml

- <ソースと同じフォルダ階層に配列されるPortal1のドキュメント>

- Portal2トップ・レベル・フォルダ:

- ExportImportData.xml

- <ソースと同じフォルダ階層に配列されるPortal2のドキュメント>

ExportImportData.xmlドキュメントの理解

ExportImportData.xmlドキュメントのXSDを次に示します。

ExportImportData.xmlのXSD:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:element name="groupspace-folder" type="FolderType" />

<!-- 'folders' must contain 1 or more 'folder' child elements -->
<xs:complexType name="FoldersType">
<xs:sequence>
<xs:element name="folder" type="FolderType"
minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>

<!-- 'documents' must contain 1 or more 'document' elements -->
<xs:complexType name="DocumentsType">
<xs:sequence>
<xs:element name="document" type="DocumentType"
minOccurs="1" maxOccurs="unbounded" />
</xs:sequence>
</xs:complexType>

<!-- 'attributes' must have 1 or more 'attribute' child elements -->
<xs:complexType name="AttributesType">
<xs:sequence>
<xs:element name="attribute" type="AttributeType"
minOccurs="1" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>

<!-- 'folder' has to have 1 and only 1 'attributes' child element
0 or 1 'folders' child element, 0 or 1 'documents' child element -->
<xs:complexType name="FolderType">
<xs:sequence>
<xs:element name="attributes" type="AttributesType"
minOccurs="1" maxOccurs="1" />
<xs:element name="folders"    type="FoldersType"
minOccurs="0" maxOccurs="1" />
<xs:element name="documents"  type="DocumentsType"
minOccurs="0" maxOccurs="1" />
</xs:sequence>
</xs:complexType>

<!-- 'document' has to have : 1 and only 1 'attributes' child element
and nothing else -->
<xs:complexType name="DocumentType">
<xs:sequence>
<xs:element name="attributes" type="AttributesType"
minOccurs="1" maxOccurs="1" />
</xs:sequence>
</xs:complexType>

<!-- 'attribute' element has to have a 'name' and 'value' attributes -->
<xs:complexType name="AttributeType">
<xs:attribute name="name"  type="xs:string" use="required" />
<xs:attribute name="value" type="xs:string" use="required" />
</xs:complexType>

</xs:schema>

ここで:

- <groupspace-folder>は、ポータルまたはポータル・テンプレート・フォルダを表すルート・タグです。
このタグには<attributes>タグが含まれ、ルート・フォルダおよびエクスポート・データに関する属性数が含まれます。これらの属性は情報のみを目的としているため、インポートでは使用されません。

- <attributes>は、ドキュメントまたはフォルダのすべての属性をグループ化するために使用されます。
このタグには、1つ以上の<attribute>タグが含まれる必要があります。他の子タグは許可されません。

- <attribute>には、フォルダまたはドキュメントのメタデータが含まれます。
このタグには次の2つの属性があります。

- name: Content Serverメタデータ名

- value: メタデータの値

子タグは許可されません。

- <folders>は、現在のフォルダのすべてのフォルダをグループ化するために使用されます。
このタグには、1つ以上の<folder>タグが含まれる必要があります。他の子タグは許可されません。

- <folder>は、子フォルダを示すために使用されます。
このタグには、<attributes>タグが必要です。フォルダに子フォルダがある場合は、<folders>タグがあります。フォルダに子ドキュメントがある場合は、<documents>タグがあります。

- <documents>は、現在のフォルダのすべてのドキュメントをグループ化するために使用されます。
このタグには、1つ以上の<document>タグが含まれる必要があります。他の子タグは許可されません。

- <document>は、現在のフォルダのすべてのドキュメントを示すために使用されます。
このタグには、<attributes>タグが必要です。他の子タグは許可されません。

Folders_g設定の注釈付きの例

次の注釈付きの例は、Folders_gがフォルダ・サービスとして使用される場合の、部分的に完了したExportImportData.xmlドキュメントを示します。例には、実際のExportImportData.xmlドキュメントでは存在しない空行とXMLコメントが含まれていることに注意してください。

<?xml version="1.0"encoding="UTF-8"standalone="yes"?>
<groupspace-folder>

<attributes>
<!-- Contains a set of attributes of the main portal folder -->
<attribute name="export-date" value="2011-07-22 13:02:29"/>
</attributes>

<folders> <!-- only present if the portal contains any child folders -->
<folder> <!-- a 'folder' tag exists for each child folder -->
<attributes>
<!-- contains the set of folder attributes, examples below -->
<attribute value="F1" name="dCollectionName"/>
</attributes>
<!-- a 'folder' tag will contain the 'folders' tag if this folder
contains child folders, i.e. if 'F1' has child folders -->
<folders>
<folder>
<!-- attribute tags, child folders, child documents etc -->
</folder>
</folders> <!-- closing tag for all the folders in the
current folder à
<!-- a 'folder' tag will contain the 'documents' tag if this folder
contains documents, i.e. if 'F1' has documents at its root -->
<documents>
<document>
<!-- attributes tags, see below -->
</document>
</documents> <!-- closing tag for all the documents in the
current folder -->
</folder> <!-- closing tag for folder 'F1' -->
</folders> <!-- closing tag for all the folders in the portal root -->

<documents> <!- only present if the folder contains any documents
in the root folder -->
<document> <!-- a 'document' tag exists for each document in the
folder -->
<attributes>
<!- contains the set of document attributes, examples below -->
<attribute name="dDocTitle" value="Doc1"/>
<attribute name="xForceFolderSecurity" value="TRUE"/>
<attribute name="xSecurityClearanceLevel" value="public"/>
</attributes>
<document> <!-- closing tag for document 'Doc1' -->
</documents><!-- closing tag for all the documents in the portal root -->

</groupspace-folder>

FrameworkFolders設定の注釈付きの例

次の注釈付きの例は、FrameworkFoldersがフォルダ・サービスとして使用される場合の、部分的に完了したExportImportData.xmlドキュメントを示します。例には、実際のExportImportData.xmlドキュメントでは存在しない空行とXMLコメントが含まれていることに注意してください。

<groupspace-folder>
<attributes>
<!-- Contains a set of attributes of the main portal folder -->
<attribute name="export-date" value="2011-07-22 13:02:29"/>
</attributes>

<folders><!-- only present if the portal contains any child folders -->
<folder><!-- a 'folder' tag exists for each child folder -->
<attributes>
<!-- contains the set of folder attributes, examples below -->
<attribute value="F1" name="fFolderName"/>
</attributes>
<!-- a 'folder' tag will contain the 'folders' tag if this folder contains child folders, i.e. if 'F1' has child folders -->
<folders>
<folder>
<!-- attribute tags, child folders, child documents etc -->
</folder>
</folders>
<!-- closing tag for all the folders in the current folder-->
<!-- a 'folder' tag will contain the 'documents' tag if this folder contains documents, i.e. if 'F1' has documents at its root -->
<documents>
<document>
<!-- attributes tags, see below -->
</document>
</documents><!-- closing tag for all the documents in the current folder -->
</folder>
<!-- closing tag for folder 'F1' -->
</folders>
<!-- closing tag for all the folders in the portal root -->
<documents>
<!-- only present if the folder contains any documents in the root folder -->
<document>
<!-- a 'document' tag exists for each document in the folder -->
<attributes>
<!-- contains the set of document attributes, examples below -->
<attribute name="dDocTitle" value="Doc1"/>
<attribute value="0" name="fInhibitPropagation"/>
</attributes>
</document>
<!-- closing tag for document 'Doc1' -->
</documents>
<!-- closing tag for all the documents in the portal root -->
</groupspace-folder>

ExportImportData.xmlドキュメントの構築

次にXMLドキュメントの構築方法に関する疑似コードを示します。

- query Content Server for the portal's folder information
- create a 'group-space-folder' node
- create an 'attributes' node
- for each of the three attributes we want to maintain (folder name, path
and GUID)
- create an 'attribute' node with name and value
- add that 'attribute' node to the 'attributes' node
- add that 'attributes' node to the 'group-space-folder' node

- query Content Server for the contents of the portal root folder
- * If there are child folders
- Create a 'folders' node
- For each child folder
- create a 'folder' node
- create an 'attributes' node
- for each folder metadata we want to maintain
- create an 'attribute' node with name and value
- add that 'attribute' node to the 'attributes' node
- add the 'attributes' node to the 'folder' node
- query Content Server for the contents of this current folder
- go to * and repeat traversing folders which reside in this
current folder
- go to # and repeat for documents which reside in this current
folder
- add the 'folder' node to the 'folders' node
- add the 'folders' node to the parent node (which will either be a
'folder' node or the 'group-space-folder' node)

- # If there are documents in this current folder
- create a 'documents' node
- for each document
- create a 'document' node
- create an 'attributes' node
- for each metadata we want to maintain
- create an 'attribute' node with name and value
- add that 'attribute' node to the 'attributes' node
- add the 'attributes' node to the 'document' node
- add that 'document' node to the 'documents' node
- add the 'documents' node to the 'folder' node

- use jaxb to write the whole data to an xml file

ドキュメント移行アーカイブの例

1セットのサンプル・データおよび例のポータルの1つに対するサンプルExportImportData.xmlドキュメントのアーカイブ形式の例を次に示します。

WebCenterデータ

次の例では、2つのポータル(MarketingおよびSales)がWebCenter Portalで作成されています。Marketingポータルでは、2つのwikiページが作成されています: MarketingWikiおよびTradeshows。Marketingポータルには、2つのフォルダ(「ブランド」および「プレゼンテーション」)が作成されていて、後者にはPowerPointドキュメントおよびwikiドキュメントを持つサブフォルダが含まれています。Salesポータルにはwikiページがありませんが、いくつかのコンテンツを持つ3つのフォルダが含まれています。

- Marketing
Marketingポータルには、Content ServerフォルダGUID= 29A4E019-7AE7-46A1-823B-AF16A313BBEFが含まれています。

- MarketingWiki

- 次のメタデータを持つMarketingWiki.htm:
dOriginalName="MarketingWiki.htm"
dDocTitle="MarketingWiki.htm"
dDocFunction="wiki"
dDocType="Application"
xWCPageID="Page2.jspx"

- プレゼンテーション

- ブランド
ProductBranding.pptx

- 次のメタデータを持つPresentation Dates.htm:
(ここでwikiページが前述のMarketingWiki.htmに関して作成されるときに作成されるのではなく、wikiドキュメントがポータルのフォルダ内で作成されることに注意してください)
dOriginalName=" Presentation Dates.htm"
dDocTitle="Presentation Dates"
dDocFunction="wiki"
dDocType="Application"
xWCPageID = not set (wikiページの作成時にwikiが作成されなかった)

- ProjectedDesigns.pptx

- 製品

- TradeShows

- 次のメタデータを持つTradeShows.htm:
dOriginalName=" TradeShows.htm"
dDocTitle=" TradeShows.htm"
dDocFunction="wiki"
dDocType="Application"
xWCPageID="Page4.jspx"

- Sales
「WebCenter Content」フォルダ GUID = 629BFEBD-4E83-4DCA-895A-C72E5192FBFD

- DecConference

- GuestSpeakers.doc

- SalesConference

- Attendees.doc

- TalkSchedules.doc

- BudgetForcasts.doc

アーカイブ・コンテンツ

- 29A4E019-7AE7-46A1-823B-AF16A313BBEF (Marketingポータル・コンテンツを含む)

- MarketingWiki

- MarketingWiki.htm

- プレゼンテーション

- ブランド(ProductBranding.pptx)

- ProjectedDesigns.pptx

- Presentation Dates.htm

- Tradeshows

- TradeShows.htm

- ExportImportData.xml

- 2001Plans.doc

- 629BFEBD-4E83-4DCA-895A-C72E5192FBFD (Salesポータル・コンテンツを含む)

- DecConference

- GuestSpeakers.doc

- SalesConference

- Attendees.doc

- TalkSchedules.doc

- ExportImportData.xml

- BudgetForcasts.doc

注意:
このフォルダにはドキュメントが含まれないため、Marketingポータルのルート・フォルダの下にProductsフォルダはありません。

Folders_g設定内のMarketingポータルのExportImportData.xml

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<groupspace-folder>
<attributes>
<attribute value="2011-10-27 15:50:18" name="export-date" />
<attribute value="/WebCenter0711/Marketing/" name="group-space-path" />
<attribute value="Marketing" name="group-space-name" />
<attribute value="29A4E019-7AE7-46A1-823B-AF16A313BBEF"
name="group-space-guid" />
</attributes>
<folders>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="sysadmin" name="dCollectionCreator" />
<attribute value="MarketingWiki" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="Page2.jspx" name="xWCPageId" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="sysadmin" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Page2.jspx" name="xWCPageId" />
<attribute value="wiki" name="dDocFunction" />
<attribute value="Application" name="dDocType" />
<attribute value="0" name="ishidden" />
<attribute value="sysadmin" name="dDocOwner" />
<attribute value="MarketingWiki.htm" name="dOriginalName" />
<attribute value="MarketingWiki.htm" name="dDocTitle" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="sysadmin" name="dDocCreator" />
<attribute value="sysadmin" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012754" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="sysadmin" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</folder>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="sysadmin" name="dCollectionCreator" />
<attribute value="Presentations" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="sysadmin" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
<folders>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="sysadmin" name="dCollectionCreator" />
<attribute value="Branding" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="sysadmin" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Document" name="dDocType" />
<attribute value="sysadmin" name="dDocOwner" />
<attribute value="0" name="ishidden" />
<attribute value="ProductBranding.pptx" name="dDocTitle" />
<attribute value="ProductBranding.pptx"
name="dOriginalName" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="sysadmin" name="dDocCreator" />
<attribute value="sysadmin" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012748" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="sysadmin" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</folder>
</folders>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="wiki" name="dDocFunction" />
<attribute value="Application" name="dDocType" />
<attribute value="0" name="ishidden" />
<attribute value="sysadmin" name="dDocOwner" />
<attribute value="Presentation Dates" name="dDocTitle" />
<attribute value="Presentation Dates.htm"
name="dOriginalName" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="sysadmin" name="dDocCreator" />
<attribute value="sysadmin" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012758" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="sysadmin" name="dDocLastModifier" />
</attributes>
</document>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Document" name="dDocType" />
<attribute value="sysadmin" name="dDocOwner" />
<attribute value="0" name="ishidden" />
<attribute value="ProjectedDesigns.pptx" name="dDocTitle" />
<attribute value="ProjectedDesigns.pptx"
name="dOriginalName" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="sysadmin" name="dDocCreator" />
<attribute value="sysadmin" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012747" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="sysadmin" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</folder>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="sysadmin" name="dCollectionCreator" />
<attribute value="Products" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="sysadmin" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
</folder>
<folder>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="sysadmin" name="dCollectionCreator" />
<attribute value="TradeShows" name="dCollectionName" />
<attribute value="0" name="isLink" />
<attribute value="Page4.jspx" name="xWCPageId" />
<attribute value="sysadmin" name="dCollectionOwner" />
<attribute value="sysadmin" name="dCollectionModifier" />
<attribute value="1" name="dCollectionEnabled" />
</attributes>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Page4.jspx" name="xWCPageId" />
<attribute value="wiki" name="dDocFunction" />
<attribute value="Application" name="dDocType" />
<attribute value="0" name="ishidden" />
<attribute value="sysadmin" name="dDocOwner" />
<attribute value="TradeShows.htm" name="dOriginalName" />
<attribute value="TradeShows.htm" name="dDocTitle" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="sysadmin" name="dDocCreator" />
<attribute value="sysadmin" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012756" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="sysadmin" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</folder>
</folders>
<documents>
<document>
<attributes>
<attribute value="TRUE" name="xForceFolderSecurity" />
<attribute value="Document" name="dDocType" />
<attribute value="sysadmin" name="dDocOwner" />
<attribute value="0" name="ishidden" />
<attribute value="2011Plans.doc" name="dDocTitle" />
<attribute value="2011Plans.doc" name="dOriginalName" />
<attribute value="FALSE" name="xInhibitUpdate" />
<attribute value="0" name="isreadonly" />
<attribute value="0" name="CustomInteger" />
<attribute value="sysadmin" name="dDocCreator" />
<attribute value="sysadmin" name="dDocAuthor" />
<attribute value="OWCSVR01USORAC012746" name="dDocName" />
<attribute value="1" name="dRevisionID" />
<attribute value="sysadmin" name="dDocLastModifier" />
</attributes>
</document>
</documents>
</groupspace-folder>

FrameworkFolders設定内のMarketingポータルのExportImportData.xml

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<groupspace-folder>
<attributes>
<attribute value="2011-10-27 15:50:18" name="export-date" />
<attribute value="/Enterprise Libraries/Marketing/" name="group-space-path" />
<attribute value="Marketing" name="group-space-name" />
<attribute value="WC01:29a4e019-7ae7-46a1-823b-af16a313bbef"
name="group-space-guid" />
</attributes>
<folders>
<folder>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="MarketingWiki" name="fDisplayName"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="Page2.jspx" name="xWCPageId" />
<attribute value="sysadmin" name="fCreator"/>
<attribute value="owner" name="fFolderType"/>
<attribute value="MarketingWiki" name="fFolderName"/>
</attributes>
<documents>
<document>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="MarketingWiki.htm" name="fDisplayName"/>
<attribute value="MarketingWiki.htm" name="fFileName"/>
<attribute value="wiki" name="dDocFunction"/>
<attribute value="Page2.jspx" name="xWCPageId" />
<attribute value="sysadmin" name="fCreator"/>
<attribute value="Application" name="dDocType"/>
<attribute value="sysadmin" name="dDocOwner"/>
<attribute value="MarketingWiki" name="dDocTitle"/>
<attribute value="MarketingWiki.htm" name="dOriginalName"/>
<attribute value="0" name="CustomInteger"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="dDocCreator"/>
<attribute value="sysadmin" name="dDocAuthor"/>
<attribute value="OWCSVR01USORAC012754" name="dDocName"/>
<attribute value="1" name="dRevisionID"/>
<attribute value="sysadmin" name="dDocLastModifier"/>
</attributes>
</document>
</documents>
</folder>
<folder>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="Presentations" name="fDisplayName"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="owner" name="fFolderType"/>
<attribute value="Presentations" name="fFolderName"/>
</attributes>
<folders>
<folder>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="Branding" name="fDisplayName"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="owner" name="fFolderType"/>
<attribute value="Branding" name="fFolderName"/>
</attributes>
<documents>
<document>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="ProductBranding.pptx" name="fDisplayName"/>
<attribute value="ProductBranding.pptx" name="fFileName"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="Document" name="dDocType"/>
<attribute value="sysadmin" name="dDocOwner"/>
<attribute value="ProductBranding" name="dDocTitle"/>
<attribute value="ProductBranding.pptx" name="dOriginalName"/>
<attribute value="0" name="CustomInteger"/>
<attribute value="sysadmin" name="dDocCreator"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="dDocAuthor"/>
<attribute value="OWCSVR01USORAC012748" name="dDocName"/>
<attribute value="1" name="dRevisionID"/>
<attribute value="sysadmin" name="dDocLastModifier"/>
</attributes>
</document>
</documents>
</folder>
</folders>
<documents>
<document>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="Presentation Dates.htm" name="fDisplayName"/>
<attribute value="Presentation Dates.htm" name="fFileName"/>
<attribute value="wiki" name="dDocFunction"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="Application" name="dDocType"/>
<attribute value="sysadmin" name="dDocOwner"/>
<attribute value="Presentation Dates" name="dDocTitle"/>
<attribute value="Presentation Dates.htm" name="dOriginalName"/>
<attribute value="0" name="CustomInteger"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="dDocCreator"/>
<attribute value="sysadmin" name="dDocAuthor"/>
<attribute value="OWCSVR01USORAC012758" name="dDocName"/>
<attribute value="1" name="dRevisionID"/>
<attribute value="sysadmin" name="dDocLastModifier"/>
</attributes>
</document>
<document>
<attributes>
<attribute value="1" name="dPublishedRevisionID"/>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="ProjectedDesigns.pptx" name="fDisplayName"/>
<attribute value="ProjectedDesigns.pptx" name="fFileName"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="Document" name="dDocType"/>
<attribute value="sysadmin" name="dDocOwner"/>
<attribute value="ProjectedDesigns" name="dDocTitle"/>
<attribute value="ProjectedDesigns.pptx" name="dOriginalName"/>
<attribute value="0" name="CustomInteger"/>
<attribute value="sysadmin" name="dDocCreator"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="dDocAuthor"/>
<attribute value="OWCSVR01USORAC012747" name="dDocName"/>
<attribute value="1" name="dRevisionID"/>
<attribute value="sysadmin" name="dDocLastModifier"/>
</attributes>
</document>
</documents>
</folder>
<folder>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="Products" name="fDisplayName"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="owner" name="fFolderType"/>
<attribute value="Products" name="fFolderName"/>
</attributes>
</folder>
<folder>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="TradeShows" name="fDisplayName"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="Page4.jspx" name="xWCPageId" />
<attribute value="sysadmin" name="fCreator"/>
<attribute value="owner" name="fFolderType"/>
<attribute value="TradeShows" name="fFolderName"/>
</attributes>
<documents>
<document>
<attributes>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="Page4.jspx" name="xWCPageId" />
<attribute value="TradeShows.htm" name="fDisplayName"/>
<attribute value="TradeShows.htm" name="fFileName"/>
<attribute value="wiki" name="dDocFunction"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="Application" name="dDocType"/>
<attribute value="sysadmin" name="dDocOwner"/>
<attribute value="TradeShows" name="dDocTitle"/>
<attribute value="TradeShows.htm" name="dOriginalName"/>
<attribute value="0" name="CustomInteger"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="dDocCreator"/>
<attribute value="sysadmin" name="dDocAuthor"/>
<attribute value="OWCSVR01USORAC012756" name="dDocName"/>
<attribute value="1" name="dRevisionID"/>
<attribute value="sysadmin" name="dDocLastModifier"/>
</attributes>
</document>
</documents>
</folder>
</folders>
<documents>
<document>
<attributes>
<attribute value="1" name="dPublishedRevisionID"/>
<attribute value="sysadmin" name="fLastModifier"/>
<attribute value="sysadmin" name="fOwner"/>
<attribute value="2011Plans.doc" name="fDisplayName"/>
<attribute value="2011Plans.doc" name="fFileName"/>
<attribute value="sysadmin" name="fCreator"/>
<attribute value="Document" name="dDocType"/>
<attribute value="sysadmin" name="dDocOwner"/>
<attribute value="2011Plans" name="dDocTitle"/>
<attribute value="2011Plans.doc" name="dOriginalName"/>
<attribute value="0" name="CustomInteger"/>
<attribute value="sysadmin" name="dDocCreator"/>
<attribute value="0" name="fInhibitPropagation"/>
<attribute value="sysadmin" name="dDocAuthor"/>
<attribute value="OWCSVR01USORAC012746" name="dDocName"/>
<attribute value="1" name="dRevisionID"/>
<attribute value="sysadmin" name="dDocLastModifier"/>
</attributes>
</document>
</documents>
</groupspace-folder>

F.3 ソースWikiアプリケーションからWebCenter Portalへのデータの移行

既存のwikiアプリケーションからWebCenter Portalにコンテンツを移行するには、次の手順を実行します。

1. wikiコンテンツのインポート用にWebCenter Portalを準備します。

2. カスタムwiki抽出ツールを記述して実行し、Wikiアプリケーションからアーカイブ(ドキュメント移行ユーティリティで期待される正確な形式に一致している必要がある)にコンテンツを抽出します。

3. ドキュメント移行ユーティリティを使用して、Content Serverにアーカイブをインポートします。

4. WebCenter Portalでwikiページを作成し、Content Serverのコンテンツを関連付けます。

これら手順は、次の項で詳細に説明します。

- 第F.3.1項「WikiコンテンツのインポートのためのWebCenter Portalの準備」

- 第F.3.2項「Wikiアプリケーションからコンテンツを抽出するためのカスタムWiki抽出ツールの記述と実行」

- 第F.3.3項「ドキュメント移行ユーティリティを使用したターゲット・ポータルへのアーカイブのインポート」

- 第F.3.4項「Content Serverのコンテンツに対するWebCenter PortalのWikiページの作成」

F.3.1 WikiコンテンツのインポートのためのWebCenter Portalの準備

ドキュメント・ツールがポータルまたはポータル・テンプレートで有効になっている場合、フォルダがそのポータルまたはポータル・テンプレートに対してContent Serverで作成されます。これらのフォルダのGUIDは、ドキュメント移行ユーティリティとともに使用するアーカイブを構築するために決定される必要があります。フォルダGUIDは次の手順で決定されます。

1. すべてのwikiコンテンツを単一ポータルまたは複数のポータルにインポートするかどうかを決定します。

2. WebCenter Portalにログインし、ポータルを作成して、ポータルの内部名をメモします。
ドキュメント・ツールを含むテンプレートを使用していることを確認します。そうでない場合、ドキュメント・ツールを有効にして、ポータル作成後にロール権限を設定する必要があります。

3. Content Serverにログインします。

4. ユーザーのレイアウトが「トップ・メニュー」であることを確認します。

1. ユーザー名をクリックして、ユーザーのプロファイル・ページを表示します。

2. 「ユーザーのパーソナライズの設定」の下で、「レイアウト」をTop Menuに設定していることを確認します。

5. wikiコンテンツがインポートされる各ポータルに対して、フォルダGUIDを決定します。

1. 「コンテンツの参照」をクリックします。

2. WebCenter Portalインスタンスのルート・フォルダをクリックします。
これは、Content Server接続のRoot Folder設定と同じです。

3. ポータルのフォルダをクリックします。
フォルダ名は、ポータルの内部名と同じです。

4. フォルダ情報を表示するには、ツールバーの「情報」をクリックします。

5. URLにIsSoap=1を追加します。

6. Folders_g設定内の文字列dCollectionGUIDを検索します。例:

<idc:field name="dCollectionGUID">05573322-E895-EDA3-8A83-07CF39CBDE05</idc:field>

FrameworkFoldersフォルダ・サービスを使用している場合は、文字列fApplicationGUIDを検索します。例:

<idc:field name="fApplicationGUID">WC01:8c1c6442-a258-4cd7-8cf1-adb60fc45ce2</idc:field>

6. 次の手順でアーカイブを構築する際にGUIDが必要となるため、ポータル・フォルダ名とそのGUIDをメモします。

F.3.2 Wikiアプリケーションからコンテンツを抽出するためのカスタムWiki抽出ツールの記述と実行

ソースwikiアプリケーションから、ドキュメント移行ユーティリティとともに使用するのに適したアーカイブにコンテンツを抽出するには、カスタム・アプリケーションを記述する必要があります。アーカイブの形式の詳細は、第F.2項「ドキュメント移行ユーティリティの理解」を参照してください。

カスタムwiki抽出ツールは、次の手順を実行する必要があります。

1. wikiコンテンツを抽出して配置します。
一時ディレクトリを作成し、ソースwikiアプリケーションからその一時ディレクトリにwikiコンテンツを抽出して、WebCenter Portalに表示されるとおりにファイル・システムに配置します。

2. wikiドキュメントのソースHTMLをクリーンアップします。
各wikiドキュメントに対して、HTMLを編集して、アプリケーション固有のHTMLタグを削除します。

3. URLをリライトします。
各wikiドキュメントに対して、ソースwikiアプリケーションのコンテンツへの既存のURLを、WebCenter Portalにインポートされる同じアーティファクトのURLに置き換えます。

4. ExportImportData.xmlドキュメントを構築します。
各ルート・フォルダに対して、エクスポート・セットのデータを記述し、インポートの実行に使用されるExportImportData.xmlドキュメントを構築します。

5. アーカイブ・ファイルを構築します。
wikiコンテンツをWebCenter Portalにインポートするために使用可能な操作済wikiコンテンツのアーカイブを作成します。

これらの各手順については、次の項で詳細に説明します。

- 第F.3.2.1項「Wikiコンテンツの抽出と配置」

- 第F.3.2.2項「WikiドキュメントのソースHTMLのクリーンアップ」

- 第F.3.2.3項「URLのリライト」

- 第F.3.2.4項「ExportImportData.xmlドキュメントの構築」

- 第F.3.2.5項「アーカイブ・ファイルの構築」

F.3.2.1 Wikiコンテンツの抽出と配置

ソース・アプリケーションのwikiドキュメントはファイル・システムの一時ディレクトリに抽出され、コンテンツがターゲットWebCenter Portalインスタンスにレイアウトされる方法をファイル・システムが模倣するように配置される必要があります。すべてのwikiドキュメントが単一ポータルにインポートされる場合、Content Serverの対応するポータル・フォルダのGUIDを使用して名付けられている単一のルート・フォルダの下にコンテンツのすべてが配置される必要があります。wikiドキュメントが複数のポータルにインポートされる場合、Content Serverの対応するフォルダのGUIDを使用して名付けられている複数のルート・フォルダの下にコンテンツが配置される必要があります。Content Serverにおけるポータル・フォルダのGUIDの決定の詳細は、第F.3.1項「WikiコンテンツのインポートのためのWebCenter Portalの準備」を参照してください。

ファイル・システムにwikiコンテンツを配置する場合は、そのコンテンツのWebCenter Portalでの使用方法を考慮する必要があることに注意してください。例:

- wikiページが作成される場合は、wikiページのwikiドキュメントが同じ名前のフォルダの下にある必要があります。wikiページの詳細は、第F.1項「WikiドキュメントおよびWikiページの理解」を参照してください。

- フォルダに多数のコンテンツが含まれている場合は、そのフォルダのコンテンツのレンダリングに障害が発生する可能性があります。

- Content Serverには、フォルダ数とフォルダ内に格納可能なファイル数を制限する2つの設定があります(「仮想フォルダ当たりの最大フォルダ数」および「仮想フォルダ当たりの最大コンテンツ数」)。wikiコンテンツを配置する場合は、フォルダ制限設定より多くのフォルダおよびドキュメント制限設定より多くのドキュメントがフォルダにないことを確認してください。

抽出したwikiコンテンツを作成するには、次のタスクを実行します。

1. wikiドキュメントをインポートする先の各ポータルのルート・フォルダを作成し、Content Serverの対応するポータル・フォルダのGUIDに基づいてフォルダに名前を付けます。

2. インポート後に、wikiページがWebCenter Portalで作成されるwikiドキュメントに対して行う操作は次のとおりです。

1. wikiドキュメントと同じ名前を持つwikiフォルダを作成します。

2. このフォルダにwikiドキュメントを配置します。

3. 必要に応じて、このフォルダに他のドキュメントを配置します。

4. 関連するイメージおよび/またはドキュメントがある場合は、同様にそれらのドキュメントをこのwikiフォルダに追加します。

3. 他のwikiドキュメントについて、ドキュメントを含めるフォルダ階層を作成します。

例:

Content ServerのPortal S1のフォルダには、21SD15F13B8_141D_421B_AD0e_BC54B6F16893のGUIDがあります。インポート後に、MarketingWikiおよびTradeshows wikiページが作成され、これらのwikiページにMarketingWiki.htmおよびTradeshows.htm wikiドキュメントが表示される必要があります。

抽出されたwikiドキュメントおよびアーティファクトの整理された構造を次に示します。

21SD15F13B8_141D_421B_AD0e_BC54B6F16893 (Root portal folder)
Home.htm (Wiki document)
MarketingWiki (Folder)
MarketingWiki.htm (Wiki document)
Branding (Folder)
Presentation Dates.htm (Wiki document)
Presentations (Folder)
ProductBranding.pptx (File)
ProjectedDesigns.pptx (File)
Tradeshows (Folder)
TradeShows.htm (Wiki document)
Images (Folder)
Image.jpg (Image)

F.3.2.2 WikiドキュメントのソースHTMLのクリーンアップ

WebCenter Portalで、wikiページが編集されるときにwikiエディタでHTMLタグが削除されます。したがって、インポート後にwikiドキュメントを編集する場合に削除されるタグの混乱を回避するために、WebCenter Portalにインポートする前に、wikiドキュメントでHTMLタグを削除することをお薦めします。次のタグは安全に削除することができます。

<html>, </html>
<head>, </head>
<meta>, </meta>
<title>, </title>
<body>, </body>
<tbody>, </tbody>
<thead>, </thead>
<tfoot>, </tfoot>
<script>, </script>
<link>, </link>

F.3.2.3 URLのリライト

ソースwikiアプリケーションのWikiページには、組込みイメージまたは他のwikiページやドキュメントへのリンクなど、ソースwikiアプリケーション内のアーティファクトを参照するURLが含まれる場合があります。これらのアーティファクトは、ターゲットWebCenter Portalインスタンスに移行され、これらのリンクは、ターゲットWebCenter Portalインスタンスの新しいアーティファクトの場所を参照するために更新される必要があります。

抽出されたwikiページの次のタイプのURLは、WebCenter Portalの同じアーティファクトのURLを参照するために変更される必要があります。

- 他のWikiページへのリンク

- 組込みイメージへのリンク

- ドキュメントへのリンク

次の手順に従って、wikiドキュメントのURLをリライトします。

1. 手順3のURLの置換で使用されるターゲットWebCenter Portalインスタンスの属性を定義します。

- WC_BASE_URL: WebCenterインスタンス・ベースURL
例: WC_BASE_URL=https://webcenter.example.com

- UCM_ID: Content ServerへのWebCenter Portalの接続の名前
例: UCM_ID=dev_ucm

- SPACE_GUID: コンテンツが存在するWebCenter PortalのポータルのGUID
例: SPACE_GUID=s21sd15f13b8_141d_421b_ad0e_bc54b6f16893

GUIDの決定の詳細は、第F.3.1項「WikiコンテンツのインポートのためのWebCenter Portalの準備」を参照してください。

2. 各コンテンツ・アイテムについて、手順3のURLの置換で使用されるアイテムの属性を定義します。

- FILE_NAME: コンテンツ・アイテムのファイル名
例: FILE_NAME=Home.htm

- FILE_ID: 一意のContent ServerのコンテンツID
例: MARKETINGPORTAL1001

FILE_IDは、Content Serverインスタンス全体にわたって、一意である必要があることに注意してください。推奨値は、一意の番号が後に付加された(名前にポータルのない)wikiドキュメントがインポートされるポータルの名前です(前述の例では、ポータル名はMarketing Portal)。

3. 次のように、定義された属性を使用してURLをリライトします。
組込みイメージ

- 新しいURLの形式:
IMG_REPLACE=img alt="FILE_NAME" resourceid="UCM_ID#dDocName:FILE_ID" src="WC_BASE_URL/webcenter/content/conn/UCM_ID/uuid/dDocName%3aFILE_ID"

- 例:

- ソースURL:
<img alt="image.jpg" src="images/image.jpg">

- WebCenterのURL:
<img alt="image.jpg" resourceid="dev-ucm#dDocName:WSIMPORT4" src="http://webcenter.example.com/webcenter/content/conn/dev-ucm/uuid/dDocName%3aWSIMPORT4">

Wikiページ

- 新しいURLの形式:
URL_REPLACE=WC_BASE_URL/webcenter/faces/owResource.jspx?z=oracle.webcenter.doclib%21SPACE_GUID%21UCM_ID%2523dDocName%253AFILE_ID%21%21FILE_NAME

- 例:

- ソースURL:
<a href="Home.htm">Home</a>

- WebCenterのURL:
<a href="http://webcenter.example.com/webcenter/faces/owResource.jspx?z=oracle.webcenter.doclib%21sd15f13b8_141d_421b_ad0e_bc54b6f16893%21dev-ucm%2523dDocName%253AWSIMPORT25%21%21Home.htm>Home</a>

ドキュメントへのリンク

- 新しいURLの形式:
DOCUMENT_REPLACE=WC_BASE_URL/webcenter/content/conn/UCM_ID/uuid/dDocName%3aFILE_ID

- 例:

- ソースURL:
<a href="MarketingWiki/Presentations/ProductBranding.pptx"> Download Product Branding Presentation</a>

- WebCenterのURL:
<a href="http://webcenter.example.com/webcenter/content/dev-ucm/uuid/dDocName%3aWSIMPORT7"> Download Product Branding Presentation</a>

F.3.2.4 ExportImportData.xmlドキュメントの構築

インポートされるコンテンツを含む各ルート・フォルダで、ExportImportData.xmlドキュメントを作成する必要があります。ExportImportData.xmlドキュメントは、ルート・フォルダのコンテンツを記述し、ドキュメント移行ユーティリティを使用してWebCenter Portalにコンテンツをインポートする際にインポートを実行するために使用されます。ドキュメント移行ユーティリティおよびExportImportData.xmlドキュメントの詳細は、第F.2項「ドキュメント移行ユーティリティの理解」を参照してください。

インポート時にドキュメントとともに作成されるメタデータは、ExportImportData.xmlドキュメントで指定する必要があります。WebCenter Portalでは、wikiドキュメントはHTMLドキュメントとして格納されますが、通常のHTMLドキュメントではなくwikiドキュメントとして識別するための追加のメタデータを持ちます。ExportImportData.xmlドキュメントが、抽出されたコンテンツのすべてのwikiドキュメントに対してこのメタデータを指定していることを確認してください。wikiドキュメントに必要なメタデータの詳細は、第F.1項「WikiドキュメントおよびWikiページの理解」を参照してください。

注意:
コンテンツID (dDocName)は、ドキュメントが指定されずにチェックインされるときに、Content Serverによって自動的に生成されます。ドキュメントのコンテンツIDを固定する場合は、ExportImportData.xmlドキュメントにドキュメント・メタデータとともにdDocNameメタデータを含めてください。dDocNameは、Content Server全体で一意である必要があります。そうでない場合、ドキュメントのチェックインは失敗します。コンテンツIDに独自の接頭辞を選択し、末尾に番号を順次追加することをお薦めします。

ExportImportData.xmlドキュメントは、ルート・フォルダごとに手動で生成できます。または、カスタム・スクリプトを記述して、ルート・フォルダのコンテンツを通過し、ドキュメントを生成することができます。

ファイル・システムのコンテンツの構造が、ExportImportData.xmlドキュメントで正しく詳述されている必要があります。ExportImportData.xmlドキュメントとファイル・システムで記述されるコンテンツの階層間で不一致がある場合、ターゲットContent Serverのポータル・フォルダへのインポートは失敗します。

例:

この例では、convert_programという名前のカスタム・スクリプトが、21SD15F13B8_141D_421B_AD0e_BC54B6F16893というルート・フォルダを通過して、フォルダのコンテンツを詳述している現在作業中のディレクトリにExportImportData.xmlドキュメントを作成します。

cd 21SD15F13B8_141D_421B_AD0e_BC54B6F16893
run convert_program

F.3.2.5 アーカイブ・ファイルの構築

ルート・ポータル・フォルダを圧縮することにより、抽出され、操作されたwikiドキュメントのアーカイブを作成します。圧縮されたアーカイブは、ルート・フォルダのコンテンツだけではなく、アーカイブ内にルート・フォルダを持っている必要があります。1つの圧縮ファイルには、様々なポータル用に複数のルート・フォルダを含むことができます。またはルート・フォルダごとに1つの圧縮ファイルを作成できます。

例:

次の例で、wikiドキュメントは、フォルダ/scratch/wikiexportsの21SD15F13B8_141D_421B_AD0e_BC54B6F16893というフォルダで抽出および操作されており、作成するアーカイブは、wsimport.zipです。

cd /scratch/wikiexports
zip –r wcimport.zip 21SD15F13B8_141D_421B_AD0e_BC54B6F16893/

注意:
一部の圧縮ツールがアーカイブを上書きするのではなく、すでに存在している場合、指定されたアーカイブにコンテンツを追加するため、フォルダ・コンテンツを圧縮する前に、アーカイブが存在していないことを確認してください。

F.3.3 ドキュメント移行ユーティリティを使用したターゲット・ポータルへのアーカイブのインポート

ターゲットContent Serverにコンテンツをインポートするには、前の手順で生成されたアーカイブを指定して、ドキュメント移行ユーティリティを実行します。ドキュメント移行ユーティリティの使用方法の詳細は、第F.3.3.2項「ドキュメント移行ユーティリティを使用したコンテンツの移行」を参照してください。

WebCenter Portalにログインして、コンテンツがインポートされたポータルに移動して、コンテンツが存在することを確認します。

F.3.3.1 ドキュメント移行ユーティリティの実行に必要なプロパティ

表F-1に、ドキュメント移行ユーティリティの実行に必要なプロパティを示します。ユーティリティの実行方法の詳細は、第F.3.3.2項「ドキュメント移行ユーティリティを使用したコンテンツの移行」を参照してください。

表F-1 ドキュメント移行プロパティ

プロパティ

説明

要件

Usage

コンテンツをファイルにインポートまたはエクスポートするかどうかを指定します。オプションはimportおよびexportです

エクスポートおよびインポート

MDSConn

MDS JDBC接続を次の形式で指定します。

jdbc:oracle:thin:@host:port:SIDまたは

jdbc:oracle:thin:@host:port/ServiceName

エクスポート

MDSUser

WebCenter Portalで使用されるMDSユーザー名を指定します。

エクスポート

MDSPwd

MDSユーザーのパスワードを指定します。パスワードのプロンプトを表示させないためにのみこれを含めます。

エクスポート

ExportScopes

各ポータル/ポータル・テンプレートの内部名をエクスポートするコンテンツとともに指定します。複数のポータル/テンプレート名をカンマで区切ります。ポータル・テンプレート名の先頭にspacetemplate/<template_internal_name>を付けます。カンマ区切りリストにスペースがないことを確認します。

「ポータルについて」および「ポータル・テンプレートについて」ダイアログから内部名を取得できます。ここに表示名は入力しないでください。

エクスポート

UCMConn

Content Server URLを次の形式で指定します: idc://host:intradocPort

usage=exportの場合、コンテンツのエクスポート元からContent ServerインスタンスのURLを指定します。

usage=importの場合、コンテンツのインポート先へContent ServerインスタンスのURLを指定します。

エクスポートおよびインポート

UCMUser

RIDCからの接続に使用されるContent Serverユーザー名を指定します。このユーザーには、エクスポートまたはインポートを実行するための十分な権限が必要です。つまり、外部アイデンティティ・ストアに定義されているユーザーまたはContent Server管理者sysadminである必要があります。

エクスポートおよびインポート

UCMPwd

Content Serverユーザーのパスワードを指定します。パスワードのプロンプトを表示させないためにのみこれを含めます。

エクスポートおよびインポート

UCMSpacesRoot

WebCenter Portalコンテンツが格納されているルート・フォルダを示します。値は、/foldernameとして設定できます。

エクスポートおよびインポート

TmpDirPath

オプション。データ抽出の一時的な場所。指定されない場合、デフォルトはシステムのtmpディレクトリです。

エクスポートおよびインポート

ArchivePath

ドキュメント・アーカイブの場所。

エクスポートおよびインポート

ArchiveName

オプション。ドキュメント・アーカイブの名前(.zip)。デフォルトは、docsexport.zipです。

エクスポートおよびインポート

F.3.3.2 ドキュメント移行ユーティリティを使用したコンテンツの移行

次のいずれかの方法を使用できます。

- プロパティ・ファイルでのドキュメント移行プロパティの指定

- コマンド行でのドキュメント移行プロパティの指定

- 求められた場合のコマンド行でのドキュメント移行プロパティの指定

プロパティ・ファイルでのドキュメント移行プロパティの指定

1. エクスポート/インポートに必要なすべてのプロパティを含むプロパティ・ファイルを作成します。すべてのプロパティの説明は、表F-1を参照してください。

1. 次のプロパティ・ファイルをメモ帳または別の適切なテキスト・エディタにコピーして貼り付け、環境に応じて編集します。

# Document migration properties.

# Specify whether you want to export content to a file or
# import content from an archive to another content repository
# valid values: export | import
Usage=export

# Specify connection details for Oracle WebCenter Content repository:
#   UCMConn - Content Server URL. Format: idc://host:intradocPort
#   UCMUser - Content Server user name used to connect through RIDC
#   UCMPwd  - Password for UCMUser. Only include to avoid password prompt
#   UCMSpacesRoot - Root folder where WebCenter Portal content is stored.
Format: /foldername
# Required for: Export and Import

UCMConn=idc://mycontentserver.mycompany.com:9444
UCMUser=<enter Content Server admin user name here>
#UCMPwd=<enter password for UCMUser here>
#UCMSpacesRoot=/portalrootfolder

# Specify a temp directory and name/location for the export archive
#   TmpDirPath  -Optional. Temporary location for data extraction.
#                If not specified, defaults to the system temporary directory.
#   ArchiveName -Optional. Name for the document archive (.zip).
#                Default is docsexport.zip.
#   ArchivePath -Document archive location
# Required for: Export and Import

TmpDirPath=/scratch/user1/migrateMyPortalDocs/tmpdir
ArchivePath=/scratch/user1/migrateMyPortalDocs/output
ArchiveName=myportaldocs.zip

# Specify MDS details (export only)
#   MDSConn - MDS JDBC connection. Format:
#                jdbc:oracle:thin:@host:port:SID   or
#                jdbc:oracle:thin:@host:port/ServiceName
#   MDSUser - MDS schema user name used by the WebCenter Portal application
#   MDSPwd = Password for MDSUser. Only include to avoid password prompt
# Required for: Export

MDSConn=jdbc:oracle:thin:@mymdshost.mycompany.com:1521:wkcdb01
MDSUser=<enter MDS user name here>
#MDSPwd=<enter password for MDSUser here>

# Specify target portal for export or import.
# Seperate multiple portal/template names with a comma.
# Use internal names only. Do not enter display names.
# Obtain internal names from "About Portal" and "About Portal Template" dialogs.
# Prefix portal template names with 'spacetemplate/<template_internal_name>'
# as indicated in the example.
# Required for: Export

ExportScopes=MyPortal1,MyPortal2,spacetemplate/MyPortalTemplate

2. ファイルを保存します。たとえば、myMigrationProperties.propertiesとして保存します。

2. ドキュメント移行ユーティリティcontent-migration-tool.jarがあるWCP_ORACLE_HOME/webcenter/archivesディレクトリに移動します。

3. 絶対パスをコマンド行上のドキュメント移行プロパティ・ファイルに指定することにより、ドキュメント移行ユーティリティを実行します(例F-1)。

java -jar content-migration-tool.jar <absolute_path_to_migrationPropertiesFilename>

オプションで、第F.3.3.3項「追加のログを指定したドキュメント移行ユーティリティの実行」の説明に従って、java.util.logging.config.fileパラメータを使用したログ設定を指定します。

例F-1 プロパティ・ファイルでのドキュメント移行プロパティの指定

java -jar content-migration-tool.jar /home/user1/myMigrationProperties.properties

コマンド行でのドキュメント移行プロパティの指定

1. ドキュメント移行ユーティリティcontent-migration-tool.jarがあるWCP_ORACLE_HOME/webcenter/archivesディレクトリに移動します。

2. コマンド行上で個々のプロパティを指定することにより、ドキュメント移行ユーティリティを実行します。
コンテンツをエクスポートするには:

java -jar content-migration.jar Usage UCMConn UCMUser TmpDirPath ArchivePath ArchiveName MDSConn MDSUser ExportScopes [UCMPwd MDSPwd] UCMSpacesRoot

コンテンツをインポートするには:

java -jar content-migration.jar Usage UCMConn UCMUser TmpDirPath ArchvePath ArchiveName [UCMPwd] UCMSpacesRoot

注意: オプションで、コマンド行上で、UCMPwdおよびMDSPwdパラメータを指定できます。指定しない場合は、これらを指定するよう求められます。

オプションで、第F.3.3.3項「追加のログを指定したドキュメント移行ユーティリティの実行」の説明に従って、java.util.logging.config.fileパラメータを使用したログ設定を指定します。

求められた場合のコマンド行でのドキュメント移行プロパティの指定

1. ドキュメント移行ユーティリティcontent-migration-tool.jarがあるWCP_ORACLE_HOME/webcenter/archivesディレクトリに移動します。

2. 求められた場合はコマンド行上でプロパティを指定することにより、ドキュメント移行ユーティリティを実行します。

java -jar content-migration.jar

オプションで、第F.3.3.3項「追加のログを指定したドキュメント移行ユーティリティの実行」の説明に従って、java.util.logging.config.fileパラメータを使用したログ設定を指定します。

F.3.3.3 追加のログを指定したドキュメント移行ユーティリティの実行

次のようにオプションでjava.util.logging.config.fileパラメータを使用し、追加のログを指定してドキュメント移行ユーティリティを実行できます。

java -Djava.util.logging.config.file=<absolute_path_to_logging_properties_file> -jar content-migration-tool.jar <migrationProperties>

注意: java.util.logging.config.fileパラメータは、javaコマンドの直後、-jarの前に指定する必要があります。

logging_properties_fileに次のような設定が含まれます。

handlers=java.util.logging.ConsoleHandler.level=INFO
java.util.logging.ConsoleHandler.level=FINER
java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter
oracle.webcenter.doclib.level=INFO

F.3.4 Content Serverのコンテンツに対するWebCenter PortalのWikiページの作成

WebCenter Portal wikiページを使用して、インポートされたwikiを表示するには、次の手順を実行します。wikiページの詳細は、第F.1項「WikiドキュメントおよびWikiページの理解」を参照してください。

1. WebCenter Portalにログインします。

2. コンテンツがアップロードされているポータルを検索します。

3. 「アクション」をクリックし、「作成」→「ページ」の順に選択します。

4. wikiページに「名前」を指定し、Wikiページ・レイアウトを選択します。
wikiページの名前がWebCenter Portalのポータル・フォルダのフォルダ名と一致している必要があることに注意してください。このフォルダには同じ名前のwikiページが含まれています。

たとえば、ポータル・フォルダに、MarketingWikiフォルダとMarketingWiki.htmドキュメントがある場合、wikiページの名前は、MarketingWikiである必要があります。

G Oracle WebCenter Portalのトラブルシューティング

この付録では、Oracle WebCenter Portalのトラブルシューティング情報について説明します。

この付録には次のトピックが含まれます:

- 第G.1項「トラブルシューティングのロードマップ」

- 第G.2項「Oracle WebCenter Portalの構成に関する問題のトラブルシューティング」

- 第G.3項「Oracle WebCenter Portal WLSTコマンドの問題のトラブルシューティング」

- 第G.4項「Oracle WebCenter Portalのパフォーマンスに関する問題のトラブルシューティング」

- 第G.5項「My Oracle Supportを使用してその他のトラブルシューティング情報を得る」

- 第G.6項「WebCenter Portalワークフローのトラブルシューティング」

- 第G.7項「WebCenter Portalのインポートおよびエクスポートのトラブルシューティング」

- 第G.8項「個別のポータルとポータル・テンプレートのインポートおよびエクスポートのトラブルシューティング」

G.1 トラブルシューティングのロードマップ

このドキュメントのロードマップを使用して、Oracle WebCenter Portalのトラブルシューティング情報を参照します。図G-1で、問題を最もよく示す開始点を見つけ図形をクリックするか、表G-1のリンクをクリックして、必要な項に移動します。

図G-1 Oracle WebCenter Portalのトラブルシューティングのロードマップ

表G-1 WebCenter Portalのトラブルシューティングの開始点

実行する処理

ガイド内のトラブルシューティングの項へのリンク

- Oracle WebCenter Portalの構成に関する問題のトラブルシューティング

第G.2項「Oracle WebCenter Portalの構成に関する問題のトラブルシューティング」

- Oracle WebCenter Portal WLSTに関する問題のトラブルシューティング

第G.3項「Oracle WebCenter Portal WLSTコマンドの問題のトラブルシューティング」

- Oracle WebCenter Portalのログとメトリックのモニター

第27項「Oracle WebCenter Portalのパフォーマンスのモニタリング」

第28項「Oracle WebCenter Portalログの管理」

- Oracle WebCenter Portalのパフォーマンスに関する問題のトラブルシューティング

第G.4項「Oracle WebCenter Portalのパフォーマンスに関する問題のトラブルシューティング」

G.2 Oracle WebCenter Portalの構成に関する問題のトラブルシューティング

この項には次のサブセクションが含まれます:

- 第G.2.1項「インストールされているOracle WebCenter Portalのバージョンを調べる方法」

- 第G.2.2項「WebCenter PortalのメニューがFusion Middleware Controlに表示されない」

- 第G.2.3項「使用不可の構成オプション」

- 第G.2.4項「1つ以上のツールまたはサービスに関する構成問題」

- 第G.2.5項「あるアプリケーションの構成が別のアプリケーションに反映される」

- 第G.2.6項「ログはオープン・ファイルが多すぎることを示している」

G.2.1 インストールされているOracle WebCenter Portalのバージョンを調べる方法

ご使用の環境にインストールされているOracle WebCenter Portalの製品およびコンポーネントのバージョン情報を入手するには、必ずOracleのOPatchユーティリティを使用します。

lsinventoryオプションを指定してOPatchコマンドを実行するには:

1. Opatch環境変数のWCP_ORACLE_HOME、MW_HOMEおよびPATHを設定します。
パッチ適用ガイドのOracle OPatchを使用したOracle Fusion Middlewareへのパッチの適用に関する項を参照してください。

2. 次のOPatchコマンドを実行します。
opatch lsinventory -details

次のように、インストールされているコンポーネントとそのバージョン番号のリストが出力されます。

...
Oracle Upgrade Assistant for Webcenter             11.1.1.9.0
Oracle WebCenter Portal Suite                      11.1.1.9.0
Oracle WebCenter Portal Suite 11g                  11.1.1.9.0
Oracle WebCenter Portal: Activity Graph            11.1.1.9.0
Oracle WebCenter Portal: Analytics Collector       11.1.1.9.0
Oracle WebCenter Portal: Discussions Server        11.1.1.9.0
Oracle Webcenter Portal: Framework                 11.1.1.9.0
Oracle Webcenter Portal: Framework Core            11.1.1.9.0
Oracle WebCenter Portal: Pagelet Producers         11.1.1.9.0
Oracle WebCenter Portal: Personalization           11.1.1.9.0
Oracle Webcenter Portal: Portlet Server            11.1.1.9.0
Oracle WebCenter Portal: RCU                       11.1.1.9.0
Oracle Webcenter Portal: Spaces                    11.1.1.9.0
Oracle WebCenter Portal: Suite Components          11.1.1.9.0
Oracle WebCenter Portal: Wiki                      11.1.1.9.0
...

注意:
Oracle WebCenter Portal Suite 11gはOracle WebCenter Portal Suiteの子コンポーネントであり、バージョンは必ず同じになります。

パッチ適用ガイドのOracle OPatchを使用したOracle Fusion Middlewareへのパッチの適用に関する項およびOracle Universal InstallerおよびOPatchユーザーズ・ガイド for Windows and UNIXのOUIベースのOracleホーム用のLsinventoryコマンドに関する項を参照してください。

注意:
バージョン番号を入手するには、必ずOPatchを使用してください。図G-2および図G-3に示されているように、Fusion Middleware ControlでOracle WebCenter Portal製品およびコンポーネント名とともに表示されるバージョンは、インストールされている製品の実際のバージョン番号と一致していません。

図G-2 Fusion Middleware ControlでのWebCenter Portalの正しくないバージョン番号の表示

図G-3 Fusion Middleware Controlでの他のアプリケーションの正しくないバージョン番号の表示

G.2.2 WebCenter PortalのメニューがFusion Middleware Controlに表示されない

問題

Fusion Middleware Controlにログインした後、使用しているアプリケーションの「アプリケーションのデプロイ」メニューで、「WebCenterポータル」オプションが見つかりません。

解決策

次のことを確認します。

- デプロイ済アプリケーションは、JDeveloperでWebCenter Portal Frameworkアプリケーションのテンプレートを使用して作成されたPortal Frameworkアプリケーションであること。
「WebCenterポータル」オプションは、JDeveloperでWebCenter Portal Frameworkアプリケーションのテンプレートを使用して開発されたアプリケーションに対してのみ表示されます。

- デプロイ済Portal Frameworkアプリケーションが稼働中であること。

- デプロイ済Portal Frameworkアプリケーションには、MDSリポジトリおよびパーティションに関する正確な情報が含まれ、MDSリポジトリはアプリケーションからアクセス可能であること。この情報を確認するには、adf-config.xmlファイルのmetadata-store-usagesセクションをチェックします。MDSの詳細は、管理者ガイドのMDSリポジトリの理解に関する項を参照してください。

- 次の構成をサポートするために、Portal Frameworkアプリケーションが必須アーティファクトと一緒にパッケージ化されていること。

- adf-jndi-configネームスペースは、アプリケーションのadf-config.xmlファイルで構成されます。これは、設計時にプロビジョニングされます。次はadf-jndi-configネームスペースの例(太字のテキスト)です。

<adf-config xmlns="http://xmlns.oracle.com/adf/config"
xmlns:jndiC="http://xmlns.oracle.com/adf/jndi/config"
xmlns:ns2="http://xmlns.oracle.com/mds/config"
xmlns:ns3="http://xmlns.oracle.com/adf/mds/config">
...
...
</adf-config>

- MBeansを登録するために、適切なリスナーがweb.xmlファイルに存在します。これは、設計時にプロビジョニングされます。たとえば、web.xmlファイルの次のスニペットで太字のテキストを表示します。

<listener>
<description>ADF Config MBeans</description>
<display-name>ADF Config MBeans</display-name>
<listener-class>oracle.adf.mbean.share.config.ADFConfigLifeCycleCallBack</listener-class>
</listener>
<listener>
<description>ADF Connection MBeans</description>
<display-name>ADF Connection MBeans</display-name>
<listener-class>oracle.adf.mbean.share.connection.ADFConnectionLifeCycleCallBack</listener-class>
</listener>

- ADFConfigおよびADFConnection MBeanが、WebCenter PortalまたはPortal Frameworkアプリケーションに対して登録されていること。システムMBeanブラウザを使用して、これらのMBeanが登録されているかどうかを確認できます。

1. Fusion Middleware Controlで、アプリケーションのシステムMBeanブラウザを開きます。次のいずれかを実行します。
WebCenter Portalでは、メニュー・オプションの「WebCenterポータル」→「システムMBeanブラウザ」を選択します。

Portal Frameworkアプリケーションでは、メニュー・オプションの「アプリケーションのデプロイ」→「システムMBeanブラウザ」を選択します。

2. 「アプリケーション定義のMBean」→「oracle.adf.mbean.share.connection」の下で、アプリケーションのADFConnection MBeanを見つけます(図G-4を参照)。

3. 同様に、「アプリケーション定義のMBean」→「oracle.adf.mbean.share.config」の下で、アプリケーションのADFConfig MBeanを見つけます(図G-4を参照)。

図G-4 アプリケーション定義のMBean

第1.13.4項「システムMBeanブラウザ」も参照してください。

- adf-connections.xmlおよびadf-config.xmlで最新の構成を見直し、内容が正しいかどうかを確認すること。よくある問題は次のとおりです。

- 構成ファイルがXMLスキーマに準拠していません。たとえば、スキーマで許可されている構成要素の出現回数が1回のみの場合に、重複した構成要素が存在します。

- ファイル内で参照される構成にXMLネームスペースがありません。

- XML要素がXMLネームスペースで修飾されていません。

付録Aの「MDSカスタマイズが含まれている構成ファイルのエクスポート」も参照してください。

- アプリケーションの診断ログを確認して、モジュールoracle.adf.mbean.share.connectionおよびoracle.adf.mbean.share.configのメッセージを分析し、必要な作業を判断すること。

- WebCenter Portalの場合、このログ・ファイルがDOMAIN_HOME/servers/ServerName/logsディレクトリで参照可能です。ログ・ファイルは、ServerName-diagnostic.logの命名規則に従います。第28.2.1項「WebCenter Portalログの表示および構成」も参照してください。

- Portal Frameworkアプリケーションの場合、このログ・ファイルがDOMAIN_HOME/servers/ServerName/logsディレクトリで参照可能です。ログ・ファイルは、ServerName-diagnostic.logの命名規則に従います。第28.2.2項「Portal Frameworkアプリケーション・ログの表示および構成」も参照してください。

G.2.3 使用不可の構成オプション

問題

Fusion Middleware ControlからWebCenter PortalまたはPortal Frameworkアプリケーションを構成する場合は、次のメッセージが表示されます。

Configuration options currently unavailable. The application application_name might be down, did not start-up properly, or is incorrectly packaged.
Check the log files for further details.

たとえば、Fusion Middleware Controlで、「アプリケーション設定」画面から利用できるオプションを変更しようとしているか、「WebCenter Portalサービス構成」画面から接続を構成しようとしています。

解決策

アプリケーションの診断ログを確認します。

- WebCenter Portalの場合、このログ・ファイルがDOMAIN_HOME/servers/ServerName/logsディレクトリで参照可能です。ログ・ファイルは、ServerName-diagnostic.logの命名規則に従います。第28.2.1項「WebCenter Portalログの表示および構成」も参照してください。

- Portal Frameworkアプリケーションの場合、このログ・ファイルがDOMAIN_HOME/servers/ServerName/logsディレクトリで参照可能です。ログ・ファイルは、ServerName-diagnostic.logの命名規則に従います。第28.2.2項「Portal Frameworkアプリケーション・ログの表示および構成」も参照してください。

モジュールoracle.adf.mbean.share.connectionおよびoracle.adf.mbean.share.configのメッセージを分析し、必要な作業を判断します。

第G.2.2項「WebCenter PortalのメニューがFusion Middleware Controlに表示されない」も参照してください。

G.2.4 1つ以上のツールまたはサービスに関する構成問題

アプリケーションでサポートされていないサービスを構成しないようにしてください。ご使用のアプリケーションが使用するように設計されていないサービス、たとえばディスカッションを構成しようとすると、Enterprise ManagerおよびWLSTを使用したWebCenter Portalの構成は失敗します。

即時利用可能なアプリケーションであるWebCenter Portalは、すべてのツールとサービスをサポートするように設計されていますが、JDeveloperを使用して作成したPortal Frameworkアプリケーションは、開発者が設計時に特別に追加したサービスに対して、アプリケーションの構成内でのアーティファクトのみを提供します。たとえば開発者がJDeveloperでアプリケーションのディスカッションを追加または構成しなかった場合は、デプロイ後にEnterprise ManagerおよびWLSTでディスカッションを構成できません。

1つ以上のツールまたはサービスの構成または接続に関して問題が発生している場合は、次の適切なトラブルシューティングの項を参照してください。

- 第9.13項「コンテンツ・リポジトリに関する問題のトラブルシューティング」

- 第10.8項「推奨に関する問題のトラブルシューティング」

- 第11.11項「分析に関する問題のトラブルシューティング」

- 第12.12項「お知らせおよびディスカッションに関する問題のトラブルシューティング」

- 第13.9項「イベントに関する問題のトラブルシューティング」

- 第15.11項「メールに関する問題のトラブルシューティング」

- 第19.6項「通知に関する問題のトラブルシューティング」

- 第18.7項「Oracle SESに関する問題のトラブルシューティング」

- 第20.7項「ワークリストに関する問題のトラブルシューティング」

- 第21.13項「ポートレット・プロデューサ問題のトラブルシューティング」

- 第21.12.3項「WebCenterサービス・ポートレットのトラブルシューティング」

- 第30.3項「セキュリティ構成に関する問題のトラブルシューティング」

- 第11489872章「WebCenter Portalのインポートおよびエクスポートのトラブルシューティング」

- 第11489872章「個別のポータルとポータル・テンプレートのインポートおよびエクスポートのトラブルシューティング」

G.2.5 あるアプリケーションの構成が別のアプリケーションに反映される

問題

WebCenter PortalまたはPortal Frameworkアプリケーションを構成しましたが、これらの構成が別のアプリケーションでも表示されます。

たとえば、MyPortalApp1という名前のPortal Frameworkアプリケーションのメール接続を作成または編集すると、その接続の変更が別のアプリケーションMyPortalApp2でも表示されます。

解決策

これは複数のアプリケーションがMDSパーティションを同じスキーマで共有する場合に発生します。この問題を解決するには、これらのアプリケーションを再度デプロイして、各アプリケーションが異なるMDSスキーマまたは異なるMDSパーティションを使用するようにします。異なるMDSリポジトリまたはパーティションを使用するために、MDSリポジトリを作成するか、既存のアプリケーションを構成する方法の詳細は、管理者ガイドのメタデータ・リポジトリの管理に関する項を参照してください。

G.2.6 ログはオープン・ファイルが多すぎることを示している

問題

WebCenter PortalまたはPortal Frameworkアプリケーションにアクセスできないか、エラー・メッセージが表示されていて、オープン・ファイルが多すぎるという問題があることを診断ログ・ファイルが示しています。

解決策

次の操作を実行します。

- 各バックエンド・サーバー(主にデータベース)で構成されるファイル・ハンドル数を確認し、必要に応じて数を増やします。

- ファイル・ハンドル数を増加した後でも問題が解決されない場合は、/etc/sysctl.confファイルのfs.file-maxの値を確認し、必要に応じて値を増やします。

G.3 Oracle WebCenter Portal WLSTコマンドの問題のトラブルシューティング

この項には次のサブセクションが含まれます:

- 第G.3.1項「Oracle WebCenter Portal WLSTのどのコマンドも機能しない」

- 第G.3.2項「WLSTコマンドが特定のツールまたはサービスに対して機能しない」

- 第G.3.3項「指定された接続名がすでに存在している」

- 第G.3.4項「WLSTシェルがWebLogic Serverに接続されない」

- 第G.3.5項「同じ名前の複数のアプリケーションがドメインにすでに存在している」

- 第G.3.6項「同じ名前の複数のアプリケーションが管理対象サーバーにすでに存在している」

- 第G.3.7項「ドメイン・ランタイム・ツリーにすでにメッセージが表示される」

第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

G.3.1 Oracle WebCenter Portal WLSTのどのコマンドも機能しない

問題

WLSTコマンドをいずれも実行できません。

解決策

次のことを確認します。

- Oracle WebCenter Portal WLSTコマンドは常に、WebCenter Portal Oracleホーム・ディレクトリ(WCP_ORACLE_HOME/common/bin)から実行してください。
間違ったディレクトリからOracle WebCenter PortalのWLSTコマンドを起動しようとすると、NameErrorが表示されます。

- Python以外のファイルは、WLSTソース・ディレクトリ: WCP_ORACLE_HOME/common/bin/wlstには格納されません。このディレクトリには、.py拡張子のみを持つファイルが含まれる必要があります。
この場所にあるデフォルトのセットのファイルには、法律に関するオラクル社のPythonファイルが含まれています。ユーザーは、このディレクトリにPython以外のスクリプトをコピーすることは可能です(たとえば、バックアップ・ファイル、構文エラーを含むテストPythonファイルなど)。

- webcenter-wlst.jarは、WCP_ORACLE_HOME/common/bin/wlst/libにあります。

第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

G.3.2 WLSTコマンドが特定のツールまたはサービスに対して機能しない

問題

WLSTコマンドが特定のツールまたはサービスに対して実行できないため、そのツール/サービスを構成できません。

解決策

最初に、listApplicationsまたはdisplayMetricTableNamesなどの一般的なOracle WebCenter Portal以外のコマンドを実行して、これらのコマンドが機能するかどうかを確認します。一般的なコマンドが機能しない場合は、第G.3.1項「Oracle WebCenter Portal WLSTのどのコマンドも機能しない」で説明される解決策を適用してください。

一般的なコマンドが機能する場合は、テスト・コマンドを実行して、Oracle WebCenter Portal固有のコマンドに構文エラーがないか確認します。適切なWSLTチェック・コマンドを実行してください(表G-2を参照)。

表G-2 Oracle WebCenter Portalツールおよびサービスのファイル名とWLSTコマンド

サービス名

ファイル名

WLSTコマンド

アクティビティ・グラフ

ActivityGraph.py

metadataAdminCheck()

アクティビティ・ストリーム

ActivityStream.py

asCheck()

分析

Analytics.py

OpenUsage.py

analyticsCheck()

openusageCheck()

ディスカッションおよびお知らせ

Forum.py
JiveAdmin.py

fcpCheck()

ドキュメント

Doclib.py

doclibCheck()

外部アプリケーション

ExtApp.py

extCheck()

ポータル・イベント

Community.py

ceCheck()

インスタント・メッセージおよびプレゼンス

Imp.py

rtcCheck()

メール

Mail.py

mailCheck()

通知

Notification.py

notificationCheck()

個人イベント

Personal.py

peCheck()

プロデューサ

PDK-Javaプロデューサ

Pdk.py

pdkCheck()

WSRPプロデューサ

Wsrp.py

wsrpCheck()

ページレット・プロデューサ

Ensemble.py

ensembleCheck()

プロデューサ・ヘルパー

Producer.py

producerHelperCheck()

RSSニュース・フィード

RSS.py

rssCheck()

検索

Ses.py

sesCheck()

ワークリスト

Bpel.py

bpelCheck()

エクスポート/インポート: WebCenter Portalアプリケーション

Lifecycle.py

lifecycleCheck()

エクスポート/インポート: ポータルおよびテンプレート

ExtImp.py

expimpCheck()

ユーザーの同期化

SynchronizeUser.py

userRenameCheck()

ユーザーの名前変更

UserRename.py

userRenameCheck()

WebCenter Portal: 一般

サービス・フレームワーク

WcServiceFwk.py

serviceFwkCheck()

一般設定

WebCenterGeneralSettings.py

generalSettingsCheck()

WebCenter PortalおよびSOA

WebCenterSpacesSOA.py

spaceCheck()

第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

Oracle WebCenter PortalのWLSTコマンドの詳細は、『WebLogic Scripting Toolコマンド・リファレンス』の「WebCenter PortalのカスタムWLSTコマンド」を参照してください。

G.3.3 指定された接続名がすでに存在している

問題

Connection_Nameという名前の接続を作成できません。次のメッセージが表示されます。

A connection with name Connection_Name already exists.

たとえば、WLSTコマンドcreateExtAppConnectionを使用して外部アプリケーション接続を作成しようとしているか、createMailConnectionを使用してメール・サーバーに接続しようとしています。

解決策

接続名は、WebCenter PortalまたはPortal Frameworkアプリケーションのすべての接続タイプにおいて一意である必要があります。使用中の名前で接続を作成しようとするとエラーが発生します。接続に一意の名前を使用していることを確認してください。

G.3.4 WLSTシェルがWebLogic Serverに接続されない

問題

WLSTコマンドを実行する前に、Oracle WebCenter Portalの管理サーバーに接続する必要があります。接続しなければ、Oracle WebCenter Portal WLSTコマンドは機能しません。

解決策

WLSTシェルを管理対象サーバーに接続するには、次のコマンドを実行してください。

connect(username, password , serverhost:serverport)

第G.3.1項「Oracle WebCenter Portal WLSTのどのコマンドも機能しない」および第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

G.3.5 同じ名前の複数のアプリケーションがドメインにすでに存在している

問題

サービスの接続の作成やポートレット・プロデューサの登録などの操作をWebCenter PortalまたはPortal Frameworkアプリケーションで実行しようとすると、次のメッセージが表示されます。

Another application named "YourApplicationName" exists. Specify the Server on which your application is deployed. Use: server="YourServerName".

同じ名前の複数のアプリケーションがドメインに存在している場合に、このメッセージが表示されます。これは通常、同じアプリケーションが複数の管理対象サーバーにデプロイされる、クラスタ環境で発生します。

たとえば、次のWLSTコマンドを使用してMyAppというアプリケーションのポートレット・プロデューサを登録する場合があります。

registerWSRPProducer(appName='myApp', name='MyWSRPSamples', url='http://myhost.com:9999/ portletapp/portlets/wsrp2?WSDL')

解決策

WLSTコマンドを実行する管理対象サーバーを指定します。つまり、server引数を追加します。例:

registerWSRPProducer(appName='myApp', name='MyWSRPSamples', url='http://myhost.com:9999/portletapp/portlets/wsrp2?WSDL', server=WC_CustomPortal2)

第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

G.3.6 同じ名前の複数のアプリケーションが管理対象サーバーにすでに存在している

問題

サービスの接続の作成やポートレット・プロデューサの登録などの操作をWebCenter PortalまたはPortal Frameworkアプリケーションで実行しようとすると、次のメッセージが表示されます。

Another application named "application_name" exists on the server managedServerName.

このメッセージは、指定された管理対象サーバーに同じ名前の複数のアプリケーションが存在していることを示します。これは通常、アプリケーションが別のバージョンを割り当てられている場合に発生します。

たとえば、次のWLSTコマンドを使用してMyAppというアプリケーションのポートレット・プロデューサを登録する場合があります。

registerWSRPProducer(appName='myApp', name='MyWSRPSamples', url='http://myhost.com:9999/portletapp/portlets/wsrp2?WSDL')

解決策

WLSTコマンドを実行するアプリケーションのバージョンを指定します。つまり、server引数とapplicationVersion引数を追加します。例:

registerWSRPProducer(appName='myApp', name='MyWSRPSamples', url='http://myhost.com:9999/portletapp/portlets/wsrp2?WSDL', server=WC_CustomPortal1, applicationVersion=2)

第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

G.3.7 ドメイン・ランタイム・ツリーにすでにメッセージが表示される

問題

WLSTコマンドの実行中に、次のメッセージが表示されます。

Already in Domain Runtime Tree

解決策

何も実行する必要がありません。これは情報のみを目的としています。

G.4 Oracle WebCenter Portalのパフォーマンスに関する問題のトラブルシューティング

この項の情報は、Oracle WebCenter Portalのパフォーマンス関連問題の診断に役立ちます。

この項には次のサブセクションが含まれます:

- パフォーマンスのモニタリングとトラブルシューティング・ツールについて

- システム全体の遅さをトラブルシューティングする方法

- 表示の遅いページを特定する方法

- 表示の遅いページのコンポーネントを特定する方法

- 遅いページ・リクエストをトラブルシューティングする方法

- JRockitフライト記録を使用してリクエストをトラブルシューティングする方法

G.4.1 パフォーマンスのモニタリングとトラブルシューティング・ツールについて

様々なツールを使用して、Oracle WebCenter Portal環境でのパフォーマンス問題をモニタリングおよびトラブルシューティングできます。

表G-3 パフォーマンスのモニタリングとトラブルシューティング・ツール

ツール

使用目的

参照先

Enterprise Manager

Fusion Middleware Control

単一のOracle Fusion Middlewareファームに関するWebCenter Portalのメトリックとログ・ファイルをリアルタイム・モードでモニターします。

WebCenter Portalデプロイメント用のMDSとパーティションなどのサービス構成を確認します。

Enterprise Manager Fusion Middleware Controlの起動

Grid Control

傾向を分析するために、WebCenter Portalメトリックをリアルタイムかつ履歴的観点からモニターします。また基礎となるホストおよびオペレーティング・システム、データベースなどもモニターします。

Oracle Enterprise Manager 11g Grid Controlは、Oracle Fusion Middleware 11gインストールに属していないため、個別にインストールする必要があります。Grid Controlを使用すると、複数のOracle Fusion MiddlewareファームとWebLogicドメインを一元的に管理できます。

Oracle Enterprise Manager Grid Control

WebCenterポータル・ページ・パフォーマンス・アナライザ

WebCenter Portalのポータル・ページのパフォーマンスを分析します。WebCenter Portalでページを表示すると、このツールによって、個々のページ・コンポーネントのパフォーマンスが動的に測定および表示されます。

表示の遅いページのコンポーネントを特定する方法

JConsole

JavaアプリケーションとJava仮想マシン(JVM)をグラフィカルにモニターします。

JConsoleを使用してJVMをモニターする方法

JRockit Mission Control

メモリー、CPU使用率および他のランタイム・メトリックに関するライブ・データを取得および表示します。

JFR記録を使用した遅いリクエストのトラブルシューティング

Eclipse Memory Analyzer

メモリー・リークを見つけ、メモリー使用率を減らします。

メモリー・リークとヒープ使用量問題のトラブルシューティング

Threadlogic

スレッド・ダンプを分析します。

非常に遅いページ・パフォーマンス、多いスレッド数およびシステム・ハングの診断のためのスレッド・ダンプの生成

G.4.2 システム全体の遅さをトラブルシューティングする方法

表G-4に記載されているアクションを使用して、システム全体の遅さをトラブルシューティングします。

表G-4 システム全体の遅さのトラブルシューティング

アクション

説明

詳細

1

主要なシステム・リソースを確認します。

システム・リソースの確認(CPUとメモリー)

2

topまたはvmstatを使用して、システムの遅さの原因がCPU、メモリーまたはIO競合の問題であるかどうかを確認します。

システム・リソース使用率のモニタリング

3

Java Virtual Machine (JVM)のパフォーマンスをモニターします。

Java Virtual Machine (JVM)の使用状況のモニタリング

4

OIDおよびデータベースの接続プール設定を確認します。

接続プール設定の確認

5

Oracleデータベースの自動ワークロード・リポジトリ(AWR)レポートを生成し、データベース関連の問題を診断します。

データベースの自動ワークロード・リポジトリ(AWR)レポートの生成

6

tcpdumpを使用して、ネットワーク関連問題を調査および診断します。

tcpdumpを使用したネットワーク関連問題の診断

7

pingを使用してネットワーク待機時間を測定します。

pingを使用したネットワーク待機時間の測定

8

スレッド・ダンプを収集します。

非常に遅いページ・パフォーマンス、多いスレッド数およびシステム・ハングの診断のためのスレッド・ダンプの生成

9

WC_Spaces-diagnostic.logでエラーを検索し、正しいロギング・レベルが有効になっているかどうかを確認します。

診断ログの分析

10

DMS Spyを使用して、Javaオブジェクト・キャッシュ内のアクティビティなど、内部DMSメトリック・データをモニターします。

DMS Spyを使用した内部パフォーマンス・メトリックの表のモニター

11

WebLogic Serverのaccess.logを参照し、HTTPリクエスト/レスポンスのキャッシュ設定を確認します。

HTTP圧縮設定を確認します。

HTTPリクエストのキャッシュの確認

HTTP圧縮の確認

12

HTTPモニタリング・ツールを使用して、リクエストおよびレスポンス時間を分析します。

ブラウザのレスポンス時間の確認

13

パフォーマンスを測定する前に、システムをウォーム・アップします。

パフォーマンスの再テスト前のシステムのウォーム・アップ

G.4.2.1 システム・リソースの確認(CPUとメモリー)

パフォーマンス問題が発生する場合は、十分なシステム・ハードウェア・リソースがあること、つまりOracle WebCenter Portalインストール用のCPUと物理メモリー容量が適切かどうかを確認することが重要です。

システム・リソースが不足していると、多くの様々な問題が発生する可能性があります。システム・リソースは、個々のサービスによって使用されます。システムの使用状況を定期的にモニタリングおよび記録すると、システム・ハードウェアのアップグレードが必要かどうか、または一部のサービスを別のマシンに移動する必要があるかどうかを判断する際に役立ちます。

システムのCPUとメモリーを確認するには:

- Linuxでは、次のファイルでCPUとメモリーの情報を確認します。

- /proc/cpuinfo
cpuinfoファイルには、モデル、CPUコア、CPU MHz、キャッシュ・サイズなどの重要なCPU情報と、プロセッサで利用できる命令セットを示すフラグが含まれています。複数のプロセッサまたは複数のコアのあるシステムには、それぞれ異なるエントリがあります。

- /proc/meminfo
meminfoファイルで参照する重要なフィールドには、MemTotal、MemFree、CachedおよびSwapTotalなどがあります。

- Windowsでは、タスク・マネージャ(「パフォーマンス」→「リソース・モニター」)からCPUとメモリーの情報にアクセスします。

G.4.2.2 システム・リソース使用率のモニタリング

Linuxでは、topおよびvmstatユーティリティを使用して、システムの遅さの原因がCPU、メモリーまたはI/O競合の問題であるかどうかを確認します。システム・リソースの低下を検出した場合は、次の操作を行うことができます。

- プロセスを別のマシンに移動するか、未使用のプロセス/プログラムを停止して、物理メモリーまたはCPUサイクル、あるいはその両方を開放します。

- システム・ハードウェア・リソースをアップグレードします。

詳細は、次を参照してください。

- Linuxでtopを使用してシステム・リソース使用率をモニターする方法

- Linuxでvmstatを使用してシステム・リソース使用率をモニターする方法

注意:
Windowsでは、タスク・マネージャを使用してシステム・リソースをモニターするか、未使用のプロセスおよびプログラムを停止します。詳細は、Windowsのドキュメントを参照してください。

G.4.2.2.1 Linuxでtopを使用してシステム・リソース使用率をモニターする方法

topユーティリティは、システム・リソース使用率の継続的な更新レポートを表示するため、システムにおけるメモリーおよびCPUの上位コンシューマを特定できます。

レポートのtop部分には、システム時間、起動時間、CPU使用率、物理およびスワップ・メモリー使用量、プロセス数などの情報が表示されます。次に示すのは、CPU使用率を基準にソートされたプロセスのリストです。

注意:
メモリー使用量でソートするには、[Shift]+[M]を使用します。CPU使用率でソートするには、[Shift]+[P]を使用します。

# top
2:10:49  up 8 day,  3:47,  20 users,  load average: 0.34, 0.19, 0.10
75 processes: 20 sleeping, 2 running, 8 zombie, 0 stopped
CPU states:   5.1% user   1.1% system   0.0% nice   0.0% iowait  93.6% idle
Mem:   512216k av,  506176k used,    6540k free,    0k shrd,   21888k buff
Swap: 1044216k av,  161672k used,  882544k free     199388k cached

PID   USER  PRI NI  SIZE  RSS   SHARE STAT %CPU %MEM   TIME    CPU COMMAND
2330  admin  15  0  161M  70M   2132  S    4.9  14.0   1000m   0    oracle
2605  lin    15  0  8240  6340  3804  S    0.3  1.2    1:12    0    oracle
3413 harvey  15  0  6668  5324  3216  R    0.3  1.0    0:20    0    oracle

トラブルシューティングのヒント - top:

- freeメモリーが100MB未満、およびキャッシュされたメモリーが1GB未満の場合は、システム・メモリーが低下しています。

- %wa(I/O待機)が常に10%を超えている場合は、システムは物理I/Oによってブロックされるため遅くなる可能性があります。

- システムに負荷がないときは、idle値が100%に近く、system/userのCPU使用率が0%に近いことを確認します。

- topのメモリー表示で、各プロセス(PID)のメモリー使用率(%MEM)を特定します。メモリーに余裕がなく、スワップ領域使用率が高い場合は、次のことを検討します。
- メモリー使用量の高いプロセスを別のマシンに移動します

- 仮想マシンへのメモリー割当てを増やします

- 物理メモリーを追加します

G.4.2.2.2 Linuxでvmstatを使用してシステム・リソース使用率をモニターする方法

vmstatユーティリティは、システムの様々な部分(システム・プロセス、メモリー、スワップ、I/O、CPU、Virtual Memory Managerなど)に関する現行の統計を表示します。これらの統計は、コマンドが最後に実行されたときから現在までのデータを使用して生成されます。コマンドを初めて実行すると、最後の再起動から現在までのデータが表示されます。

vmstatを実行するとき、vmstat <リフレッシュ率(秒)>という形式を使用して、統計をリフレッシュする頻度(秒)を指定できます。

例: vmstat 3

システム・リソース使用率を頻繁に更新すると、CPU/メモリー使用率の傾向と、使用率の傾向がWebCenter PortalまたはPortal Frameworkアプリケーションのパフォーマンスにどのように影響するかを確認することができます。システムが安定している場合は、スワップ・メトリック(siおよびso)がほぼゼロに登録されます。

# vmstat 3
procs           memory              swap        io       system      cpu
r  b    swpd  free   buff    cache   si   so    bi    bo   in    cs us sy id wa
3  0    144 1058184 868324 12343056    0    0   220    83   33    14 10  1 88  1
0  0    144 1058184 868324 12343056    0    0     0   117  478   656  5  1 94  0
0  0    144 1058192 868324 12343056    0    0     0    69  696   860  9  1 90  0
2  0    144 1058264 868324 12343056    0    0     0     0  914  1127  5  2 93  0
0  0    144 1057864 868324 12343316    0    0     0   184  857  1021  7  1 92  0
2  0    144 1057592 868324 12343316    0    0     0   155 1596  1646  5  4 91  0
0  0    144 1057592 868324 12343316    0    0     0     0  737   839  5  2 94  0
0  0    144 1057592 868324 12343316    0    0     0    57  694   743  8  2 91  0
2  0    144 1057592 868324 12343316    0    0     0     0  358   437  2  0 98  0

トラブルシューティングのヒント - vmstat:

- スワップ・メトリック(siおよびso)が頻繁にゼロ以外になる場合は、システム・メモリーに余裕がなくなり、システムがスラッシング・モードになる可能性があります。システム・メモリーの低下は、パフォーマンスに大きな影響を与えます。つまりシステムで実行されているプログラムが非常に遅くなります。頻繁にシステム・メモリーが低下する場合は、マシン上のメモリーを増やしてください。

- CPUアイドル時間(id)が常に10%未満の場合は、CPUは最大能力または過剰能力で動作しています。そのような状況では、システムにさらに負荷がかかると、パフォーマンスが著しく低下します。

G.4.2.3 Java Virtual Machine (JVM)の使用状況のモニタリング

Java Virtual Machine (JVM)は、Oracle WebCenter Portalパフォーマンスに大きな影響を及ぼす可能性があります。このため、継続してJVMをモニターし次を追跡することをお薦めします。

1. メモリー使用量

2. CPU使用率

3. スレッド・アクティビティ

Fusion Middleware Controlのアプリケーションの「最近のWebLogic Serverメトリック」ページから、3つすべてのメトリックをモニターできます(図G-5)。詳細は、第27.1.8項「WebLogic Serverメトリックの理解」および第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

図G-5 「最近のWebLogic Serverメトリック」ページ - JVMメトリック

- メモリーの傾向のモニター: JVMは頻繁にメモリーの割当てと解放を行います。メモリー・リークと高いメモリー使用量を検出するには、メモリーの傾向を長期間(1時間また数時間)分析する必要があります。
メモリー・グラフで一番下の傾向線が上昇している場合は、メモリー・リークを示しています。メモリー・グラフの一番下のポイントは、完全ガベージ・コレクションの後にメモリー使用量がどこまで低下する可能性があるかを示します。少なくとも2つのメモリー・ダンプ(1つはメモリーが健全である場合、もう1つはメモリーの完全ガベージ・コレクションで過度の量をリサイクルできない場合)を採取すると、メモリー・ダンプを比較して、メモリーを消費しているコンポーネントを特定できます。

第G.4.5.4項「メモリー・リークとヒープ使用量問題のトラブルシューティング」も参照してください。

- CPU使用率のモニター: CPU使用率で不定期にスパイクが発生するのは正常ですが、CPU使用率が長期間高い(85-90%)場合は、通常、パフォーマンスに影響を及ぼす可能性のあるCPU問題が発生していることを示します。
CPU使用率が過負荷に見える場合は、定期的(たとえば5秒ごと)にいくつかのスレッド・ダンプを比較すると、CPU使用率の高さの原因を明らかにすることができます。

あるいは、JRockit Flight Recorderのようなプロファイリング・ツールを使用すると、CPU使用率を詳細に把握することができます。

- スレッド・アクティビティのモニターとスレッド・ダンプの分析(スタックされたスレッド、ブロックされたスレッド、デッドロック): 負荷状態が安定している場合は、スレッド数は一定です。突然のスパイクやスレッド数の増加は、一般的にシステム内に問題があることを示しています。
このような場合、複数のスレッド・ダンプを採取して、スタック/ブロックされたスレッドまたはデッドロックのコール元スタックを把握することができます。スレッド分析ツールを使用すると、余分なスレッドの原因とそれによって何が実行されているかを特定でき、また問題のある領域とパフォーマンスが低下している領域を検出できます。第G.4.5.2項「スタック・スレッドのトラブルシューティング」も参照してください。

第G.4.2.8項「非常に表示が遅いページのパフォーマンス、高スレッド数およびシステム・ハングの診断のためのスレッド・ダンプの生成」も参照してください。

ヒント:
Oracle Fusion Middlewareの診断フレームワークでは、スタックされたスレッド、デッドロックされたスレッドなどの一般的な問題に関する情報を収集して管理し、そのような問題の診断と解決を支援します。あるいは、診断ダンプをOracleサポート・サービスに送信することもできます。詳細は、管理者ガイドの「問題の診断」を参照してください。

Fusion Middleware Control、JConsole、JVisualVM、JRockit Mission Controlなどの様々なツールを使用して、JVMパフォーマンスをモニターできます。これらのいずれかのツールを使用して、JVMの現在の状態およびアクティビティ・スレッドとその状態を表示します。パフォーマンス・チューニング・ガイドのJava仮想マシン(JVM)のチューニングに関する項も参照してください。

G.4.2.3.1 JConsoleを使用してJVMをモニターする方法

管理者はまず、Fusion Middleware Controlのアプリケーションの「最近のWebLogic Serverメトリック」ページを使用してJVMをモニターできます(図G-5を参照)。よりアグレッシブなリアルタイム・メトリックが必要な場合は、別の選択肢としてJConsoleを使用します(図G-6を参照)。

JConsoleは、HotSpot、JRockit、IBM JVMなどJVMのすべてのタイプで利用できます。

JConsoleの実行可能ファイルは、JAVA_HOME/bin/jconsole.exeにあります。

図G-6 JConsole

G.4.2.4 接続プール設定の確認

この項では、次の接続プール設定を確認する方法を説明します。

- WebCenter Portalデータ・ソース(JDBC接続プール設定)

- アイデンティティ・ストア(JNDI接続プール設定)

レスポンス時間が遅く、診断ログ・ファイルに接続/接続プール・メッセージが含まれていたり、最近のスレッド・ダンプに接続プールからの接続の取得を待機しているコール元スタックが含まれていたりする場合に、この項の情報が役に立つことがあります。

G.4.2.4.1 WebCenter Portalデータ・ソース(JDBC接続プール設定)

管理者は、Fusion Middleware Controlを使用してWebCenter PortalまたはPortal FrameworkアプリケーションのJDBC接続メトリックをモニターできます。「WebLogic Serverメトリック」ページ(図G-7)のJDBC使用状況の情報を使用して、JDBCの構成または接続プール・サイズの調整が必要かどうかを評価します。

第27.2項「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」も参照してください。

図G-7 「最近のWebLogic Serverメトリック」ページ - JDBC使用状況

「最近のJDBC使用状況」グラフには、管理対象サーバーで現在オープンになっているJDBC接続数が表示されます。ここで表示されるJDBCセッション数は、JDBCデータ・ソースごとの「現在アクティブな接続数」メトリックの合計です。

使用状況が高く上昇傾向にある場合は、管理者は、WebLogic Server管理コンソールを使用してデータ・ソースの接続プール設定を表示および構成したり、個々のデータ・ソースの使用状況パターンを詳細にモニターしたりすることができます。一定期間データ・ソースの使用状況をモニターすると、次のことを行うことができます。

- 特定のデータベース接続に対する最適な接続プール・サイズの決定。

- 負荷がなければデータ・ソース接続数が減少しない場合の接続プールのリークの検出と解決。

ヒント:
接続プールのモニタリング時に「表のカスタマイズ」を選択して、次のような追加のメトリックを表示します。

- 接続遅延時間

- 現在の最大容量

- 再接続の失敗数

- 最大待機時間

- 接続待機の現在数

- 接続待機の失敗総数

同時実行性の高いシステムでは、プール内の最大接続数(「最大接続数」設定)を変更することもできます。ここでは、様々なWebCenter Portalデータ・ソースの初期設定の最大値を示します。

WebCenter Portal
データ・ソース

接続プールの
デフォルトの最大接続数

WebCenterDS

50

ActivitiesDS

25

mds-SpacesDS

50

mds-owsmDS

15

mds-PageletProducerDS

50

mds-ServicesProducerDS

50

mds-wcpsDS

50

PersonalizationDS

25

Portlet-ServicesProducerDS

50

PortletDS

50

WC-ServicesProducerDS

25

注意:
各接続ではWebLogic Server内のメモリーが使用され、データベース内のプロセスが消費されます。そのため不必要に大きな接続プール値を指定しないでください。

- 特定のデータ・ソースをモニターするには、WebLogic Server管理コンソールにログインし、「サービス」→「データ・ソース」を選択し、データ・ソース名をクリックして、「モニタリング」タブをクリックします。

- 特定のデータ・ソースの接続プールを変更するには、WebLogic Server管理コンソールにログインし、「サービス」→「データ・ソース」を選択し、データ・ソース名をクリックして、「接続プール」タブをクリックします。

『Oracle WebLogic Server JDBCデータ・ソースの構成と管理』のデータ・ソース接続プールのチューニングに関する項を参照してください。

G.4.2.4.2 アイデンティティ・ストア(JNDI接続プール設定)

通常、JNDI接続プールは常に有効になっています。ただし、WebCenter Portal/Portal Frameworkアプリケーションとアイデンティティ・ストア(Oracle Internet Directory、Active Directoryなど)間の接続でSSLが使用される場合は、追加の構成がいくつか必要になります。デフォルトでは、SSLポートを選択すると、JNDI接続がプールされないため、ログインしてユーザー、グループなどのアイデンティティ・ストアのエンティティを検索するときに、レスポンス時間が長くなり、パフォーマンスが低下します。詳細と指示は、パフォーマンス・チューニング・ガイドのアイデンティティ・ストア構成のチューニングに関する項を参照してください。

G.4.2.5 データベースの自動ワークロード・リポジトリ(AWR)レポートの生成

データベース・アクセスが遅くなる、たとえば、アクティビティ・ストリームの問合せ、MDSの問合せまたはJPA(Java Persistence API)の問合せがWebCenter Portalアプリケーションでの様々な操作で遅くなる場合は、自動ワークロード・リポジトリ(AWR)レポートを分析して、Oracleデータベースにおけるパフォーマンス関連問題の根本原因を診断できます。

AWRレポートを生成する前に、まず、データベースをホストしているマシンの一般的なヘルス(CPU/メモリー)を確認します(第G.4.2.2項「システム・リソース使用率のモニタリング」を参照)。システム・リソースの制限がパフォーマンス低下の原因でない場合は、AWRレポートでデータベースのパフォーマンス情報と統計を調べます。

詳細は、パフォーマンス・チューニング・ガイドのデータベース・パラメータのチューニングに関する項および『Oracle Databaseパフォーマンス・チューニング・ガイド』の自動ワークロード・リポジトリ・レポートの生成に関する項を参照してください。

G.4.2.6 tcpdumpを使用したネットワーク関連問題の診断

ネットワーク・トラフィックをリスニングおよび取得するネットワーク・ユーティリティであるtcpdumpを使用して、ネットワーク関連問題を調査および診断します。

たとえば、Enterprise ManagerのWebCenter Portalページにあるパフォーマンス・メトリックはサーバーのパフォーマンスが正常であることを示しているが、エンド・ユーザーはパフォーマンスが不安定/遅いことを報告している場合は、ネットワークに問題がある可能性があります。tcpdumpまたは同様のネットワーク・モニタリング・ツールを使用してネットワーク・トラフィックを追跡し、予想外に長い待機時間の原因が(ネットワーク上の)環境問題であるかどうかを確認します。

このユーティリティを実行してネットワーク・データを分析する方法は、tcpdumpのドキュメントを参照してください。

G.4.2.7 pingを使用したネットワーク待機時間の測定

pingを使用してネットワーク待機時間を測定します。

Oracle WebCenter Portalのインストールは、様々なバックエンド・コンポーネントとサービス(Oracle HTTP Server、Oracle WebCenter Content Server、LDAPサーバー、インスタント・メッセージおよびプレゼンス・サーバー、メール・サーバー、ポートレット・サーバー、データベースなど)によって変わります。必要なコンポーネントがすべて同じマシンに存在しない場合は、ネットワーク待機時間を最小にするためにコンポーネントを密接して配置すること、可能な場合は同じサブネットに配置することをお薦めします。

あるマシンから別のマシンに対してpingを使用し、ネットワーク待機時間が1ミリ秒未満であることを確認します。

G.4.2.8 表示が非常に遅いページのパフォーマンス、高スレッド数およびシステム・ハングの診断のためのスレッド・ダンプの生成

専用のスレッド・ダンプ・ファイルにスレッド・ダンプを生成し、次にThreadLogicやシンプルなテキスト編集ツールなどのスレッド分析ツールを使用して、スレッド実行ロジックおよび進捗状況の把握と関連付けを行うことをお薦めします。

Sun JVM(HotSpot)のスレッド・ダンプを1つのファイルに生成するには:

>jstack <pid> > threaddump.txt

Oracle JRockit JVMのスレッド・ダンプを1つのファイルに生成するには:

>jrcmd print_threads <pid> > threaddump.txt

一定のサンプリング間隔で一連のスレッド・ダンプを生成しておくと、非常に遅いメソッド・コール、スタック・スレッド、デッドロックなどの問題を確認する際に役立つ場合があります。たとえば、ダンプを毎秒生成する単純なスクリプトを作成できます。また遅いリクエストを診断する場合は、遅いリクエストの長さに対応する適切な期間を選択できます。

この例では、スレッド・ダンプを毎秒生成します。

#!/bin/bash
for i in {1..20}
do
JAVA_HOME/bin/jstack <pid> > thread_dump_$i.txt
sleep 1
done

ThreadLogicなどのスレッド分析ツールの機能の詳細は、適切な製造元のドキュメントを参照してください。

注意:
WebLogic Serverがデッドロックやスタック・スレッドを検出すると、関連するスレッド・ダンプが、次の場所にあるサーバーの出力ログ・ファイルに自動的に生成されます。

DOMAIN_NAME\servers\SERVER_NAME\logs\SERVER_NAME.out

たとえば、初期設定のアプリケーションであるWebCenter Portalの出力ログは、DOMAIM_NAME\servers\WC_Spaces\logs\WC_Spaces.outにあります。

出力ファイルはシンプルなテキスト・ファイルで、スレッド情報などの様々なサーバー・メッセージを含みます。

G.4.2.9 診断ログの分析

WebCenter PortalまたはPortal Frameworkアプリケーションをホストする管理対象サーバーの診断ログ(<managed_server_name>-diagnostic.log)でエラー、インシデントおよび警告を見つけます。

アプリケーションがエラー状態で動作している場合は、パフォーマンスに大きな影響を与える可能性があります。たとえば、WebCenter Content Serverへの接続が一時的に止まるかアクセス不能になった場合、接続を試行中に、コンテンツ関連コンポーネントのあるページのレスポンスが非常に遅くなり、最終的にタイムアウトになることがあります。

タイムアウト、サービス使用不可、キャッシュ・エラーなどが原因のエラー、インシデントおよび警告メッセージは、診断ログ・ファイルに記録されます。この診断ログは、Fusion Middleware Controlから表示できます。第28.2.1項「WebCenter Portalログの表示および構成」も参照してください。

注意:
パフォーマンスの測定時に、デバッグ/トレース・メッセージ、つまりCONFIG(700)より低いレベルは記録されていないことを確認します。普通、詳細または最も詳細メッセージが表示される場合、システムはデバッグ・モードで動作しています。つまり大部分のリクエストが通常よりかなり遅くなっています。より低いレベルのロギングを一時的に構成して問題をデバッグする場合は、パフォーマンスを測定する前に必ずログ・レベルを変更します。

G.4.2.10 DMS Spyを使用した内部パフォーマンス・メトリックの表のモニター

DMS Spyサーブレットを使用すると、Webブラウザから内部DMSメトリック・データにアクセスできます。このサーブレットは、長期間システムをモニターする場合に有用で、内部システムの動作とパフォーマンスの把握に役立ちます。

通常、Oracle WebCenter Portal固有のメトリックのモニターにDMS Spyを使用することはありません。この情報へは、Fusion Middleware Controlを使用するほうがより簡単にアクセスできるためです。ただし、ADFアプリケーション・モジュール(AM)プールに関する警告/エラー・メッセージの表示などの他の主要なメトリックに関心がある場合は、ここでAMプール・メトリックを調査できます。同様に、Javaオブジェクト・キャッシュ(JOC)に関するメッセージが表示される場合は、JOCのDMSモニタリング機能を有効にしてJOC内のアクティビティを観察できます。

JOC DMSモニタリングを有効にするには、javacache.xmlファイル(通常は<webcenter_portal_domain>/config/fmwconfig/servers/WC_Spaces/javacache.xml)を編集します。

1. javacache.xmlファイルを開きます。
通常、ファイルの場所は、<webcenter_domain>/config/fmwconfig/servers/<server_name>/javacache.xmlです。

たとえばWebCenter Portalの場合、ファイルの場所は、<webcenter_domain>/config/fmwconfig/servers/WC_Spaces/javacache.xmlです。

2. 次のエントリを変更します。
<dms enabled="false"/>

変更後: <dms enabled="true"/>

3. WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動します。
たとえば、WebCenter Portalの場合は、WC_Spacesを再起動します。

有効後は、左のパネルに2つの新しいエントリ(java_cache_regionとjoc)が表示されます。

java_cache_regionは、各領域にどれくらいのキャッシュ・メモリーが割り当てられているかを示します。表示される値は、キャッシュ・サイズ設定の判断に役立ちます。たとえばMDSキャッシュ・サイズは、デフォルトでは、adf-config.xml内で100MBに設定されています。

<max-size-kb>100000</max-size-kb>

Region Name: ADFApplication<N>とADFApplication<N>/main_regionは、どちらもMDSキャッシュによって使用されます。ADFApplication<N>とADFApplication<N>/main_regionメモリーの合計が100MBに近く、JVMに十分な未使用ヒープ・メモリーがある場合は、MDSキャッシュ・サイズ(<max-size-kb>)を増やすことができるため、MDSキャッシュがいっぱいになることがなく、MDSキャッシュの効率性が向上します。

詳細は、パフォーマンス・チューニング・ガイドのSpyサーブレットを使用したパフォーマンス・メトリックの表示に関する項を参照してください。

G.4.2.11 HTTPリクエストのキャッシュの確認

大部分のWebページには、イメージ、CSSファイル、JavaScriptファイルなどの頻繁に変更されないリソースが含まれています。そのようなリソースはネットワーク経由のダウンロードに時間がかかるため、Webページのロード時間が増加します。HTTPキャッシュを使用すると、そのようなリソースをブラウザまたはプロキシで保存またはキャッシュできます。リソースがキャッシュされると、Webページへの次回アクセス時に、ブラウザまたはプロキシはリソースを再度ダウンロードするかわりに、ローカルにキャッシュされたコピーを参照できます。キャッシュでは、必要なリソースに対するHTTPリクエストを削除することにより、ラウンド・トリップ時間を短縮します。これは、次回ユーザー・アクセス時のページ・ロード時間の大幅な短縮に役立つばかりでなく、サイトの帯域幅とホスティングのコストを低減します。

デフォルトでは、WebCenter Portalによって処理される静的リソースは、ADFCachingFilterを使用して、ブラウザが静的コンテンツをキャッシュできるようにする必須レスポンス・ヘッダーを追加します。サイトでパフォーマンス問題が発生している場合は、ブラウザが静的リソースをキャッシュしていることを確認する必要があります。キャッシュが適切に機能していない場合は、静的なWebCenter Portalリソースは、ブラウザにキャッシュされるのではなくサーバーから繰り返しフェッチされるため、パフォーマンスに影響を与える可能性があります。静的ポータル・リソースのキャッシュ問題の考えられる理由として、WebCenter Portalとブラウザ間に配置されたプロキシまたはネットワーク・コンポーネントによるなんらかの損失の可能性があります。

注意:
ADFCachingFilterの詳細は、『Oracle Application Development Framework Webユーザー・インタフェース開発者ガイド』を参照してください。

Firebug (Firefox)またはhttpWatch (Internet ExplorerおよびFirefox)などのHTTPリクエストのモニタリング・ツールを使用して、ブラウザとサーバーとの間のHTTPトラフィックをモニターします。このようなツールを使用すると、キャッシュに問題があるかどうか、つまり静的リソース(JavaScript、CSSファイルなど)がリクエストごとにフェッチされるか、長期間キャッシュされないか、あるいはまったくキャッシュされないかを確認できます。このようなモニタリング・ツールを使用するときは、レスポンス内にブラウザ・キャッシュ関連のタグ(たとえば適切なmax-age値が設定されたCache-Controlヘッダーや、適切なキャッシュ有効期間が設定されたExpiresタグ)があることを確認します。

WebCenter PortalまたはPortal Frameworkアプリケーションがデプロイされている管理対象サーバーのaccess.logを調べて、HTTPキャッシュを分析することもできます。たとえば、ログを参照して、特定のユーザー/IPが同じリソースに対して繰り返しリクエストを行っているかどうかを確認します。繰り返されたリクエストがログに含まれている場合は、リクエストのキャッシュ・ヘッダーが間違っている可能性があり、キャッシュ問題をさらに調査する必要があります。様々な段階を省くために、静的リソースにアクセスすることから始めます。たとえば、wgetまたはcurlコマンドを使用し、ローカル・マシンで同コマンドを発行することにより、WebLogic Serverポートを使用している静的リソースを直接フェッチします。次に、アプリケーションをホストしているWebLogic Serverをフロントエンド処理する他のエンティティ(Oracle HTTP ServerやApacheなど)経由で、同じリソースにアクセスします。必要に応じてパケットのトレースを有効にし、WebCenter Portal層からのレスポンスを見つけて、問題がOracle WebCenter Portal側で発生しているのかネットワークで発生しているのかを確認します。

注意:
WebCenter Portalのアクセス・ログは、ORACLE_HOME/user_projects/domains/wc_domain/servers/WC_Spaces/logs/access.logにあります。

この項では、WebCenter Portalによって処理される静的リソースについて説明しますので、ご使用の環境の静的リソースに関する同様の問題も検討してください。たとえば、ユーザー独自の静的リソースを共通ページが参照するリッチUIを使用している場合は、そのようなコンテンツがどのようにキャッシュされるかを確認する必要があります。ApacheのHeaderディレクティブを使用して、ファイル・タイプ(イメージ、CSSなど)またはURLパス・パターンのどちらかを基準に静的リソースのキャッシュを実行することを検討します。たとえばApacheの次の構成では、レスポンス・ヘッダーをブラウザに戻し、URLパス/my_images/下のすべてのコンテンツを30日間キャッシュします(2592000は、30日を秒数で表した数)。

<Location /my_images/>
Header set Cache-Control "max-age=2592000, public"
</Location>

G.4.2.12 HTTP圧縮の確認

HTTPキャッシュに加えて、レスポンスに対するHTTP圧縮の特性を確認することが重要です。HTTP圧縮は、Webサーバーからブラウザに転送されるコンテンツ(大部分はテキスト)を圧縮するための、パブリックに定義された方法です。圧縮により、送信されるバイト数が軽減し、パフォーマンスが向上します。HTTP圧縮では、パブリックなドメイン圧縮アルゴリズムを使用して、サーバー側でHTML、XML、JavaScript、CSSなどのファイル形式をエンコードします。圧縮されたコンテンツを配信する標準ベースのこの方法は、HTTP/1.1に組み込まれており、現在のすべてのWebブラウザではHTTP/1.1プロトコルがサポートされています。つまり、圧縮されたファイルをクライアント側で自動的にデコードすることができます。そのため、クライアント側でソフトウェアの追加やユーザー操作を行う必要はありません。

デフォルトでは、WebCenter Portalによって処理される静的リソースは、ADFCachingFilter ()を使用して、CSSやJavaScriptなどの静的コンテンツを圧縮します。サイトでパフォーマンス問題が発生している場合は、ブラウザに圧縮されたレスポンスが表示されていることを確認する必要があります。第G.4.2.11項「HTTPリクエストのキャッシュの確認」で説明した、HTTPリクエストのモニタリング・ツールの1つを使用して、値gzipが設定されたContent-Encodingレスポンス・ヘッダーのレスポンスをスキャンできます。Content-Encodingレスポンス・ヘッダーは、クライアント(つまりブラウザ)が圧縮コンテンツをサポートしている場合にかぎり送信されます。

注意:
ADFCachingFilterの詳細は、『Oracle Application Development Framework Webユーザー・インタフェース開発者ガイド』を参照してください。

ブラウザがリクエスト・ヘッダーAccept-Encoding: gzipを送信する場合は、ブラウザは圧縮されたコンテンツを処理できるということです。圧縮されたレスポンスが表示されない場合は、圧縮されたコンテンツを処理できることを示すAccept-Encodingヘッダーがクライアントによって送信されることを確認します。

通常圧縮を必要とするファイル形式には、HTML、CSS、XML、JavaScriptがあります。大部分のイメージ、音楽およびビデオはすでに圧縮されているため、圧縮に対応するようにこれらのファイル形式を構成する必要はありません。

Apacheのmod_deflateまたはmod_gzipを使用して、MIMEタイプ(text/cssなど)またはファイル拡張子(*.htmlなど)のどちらかを基準にリソースの圧縮を実行することを検討します。たとえば、Apacheの圧縮リソースの構成がAddOutputFilterByTypeごとに次のように表示されます。

<Location />
SetOutputFilter DEFLATE
AddOutputFilterByType DEFLATE text/plain
AddOutputFilterByType DEFLATE text/xml
AddOutputFilterByType DEFLATE text/html
AddOutputFilterByType DEFLATE application/xhtml+xml
AddOutputFilterByType DEFLATE text/css
AddOutputFilterByType DEFLATE application/xml
AddOutputFilterByType DEFLATE image/svg+xml
AddOutputFilterByType DEFLATE application/rss+xml
AddOutputFilterByType DEFLATE application/atom_xml
AddOutputFilterByType DEFLATE application/x-javascript
SetEnvIfNoCase Request_URI \.(?:gif|jpe?g|png)$ no-gzip dont-vary
SetEnvIfNoCase Request_URI \.(?:exe|t?gz|zip|bz2|sit|rar)$ no-gzip dont-vary
SetEnvIfNoCase Request_URI \.(?:pdf|doc?x|ppt?x|xls?x)$ no-gzip dont-vary
SetEnvIfNoCase Request_URI \.avi$ no-gzip dont-vary
SetEnvIfNoCase Request_URI \.mov$ no-gzip dont-vary
SetEnvIfNoCase Request_URI \.mp3$ no-gzip dont-vary
SetEnvIfNoCase Request_URI \.mp4$ no-gzip dont-vary
</Location>

G.4.2.13 ブラウザのレスポンス時間の確認

Firebug (Firefox)またはhttpWatch (Internet ExplorerおよびFirefox)などのHTTPリクエストのモニタリング・ツールを使用して、ブラウザとサーバーとの間のHTTPトラフィックをモニターします。一般的なユーザー・アクションのHTTPリクエストのフローとタイミングを理解している場合は、アプリケーションのパフォーマンス問題の診断と解決に役立つ可能性があります。たとえばユーザーがログインするたびに、ユーザーのブラウザとサーバー間でいくつかのリダイレクトが発生する可能性があります。ログイン・サーバーに対するリクエストに時間がかかりすぎている場合は、WebLogic Serverではなくログイン・サーバーを調査する必要があることがわかります。同様に、アプリケーションのランディング・ページのロード・リクエストが遅い場合は、ランディング・ページの高速化に取り組むことができます。

G.4.2.14 パフォーマンスの再テスト前のシステムのウォーム・アップ

なんらかの理由でOracle WebCenter Portalの管理対象サーバーを再起動する場合は、Just-In-Time (JIT)コンパイルのオーバーヘッドを回避するために、必ずシステムをウォーム・アップしてからパフォーマンスを再テストしてください。

システムをウォーム・アップするために、パフォーマンスを後で測定するステップを手動で実行するか、ロード・テスト・ツールを使用してステップの数回の反復を実行することができます。WebLogicの管理対象サーバーを再起動すると、多くの場合、最初のリクエストは通常より遅くなります。つまり、エンド・ユーザーが経験する一般的なパフォーマンスは実現されません。

G.4.3 表示の遅いページを特定する方法

Fusion Middleware Controlを使用し、WebCenter PortalまたはPortal Frameworkアプリケーションの最も遅いページを判断します。パフォーマンスが低下したページが頻繁に使用される(起動メトリックが高い)場合、そのようなページのパフォーマンスの向上に集中的に取り組むことは意味のあることです。

最も遅いページを見つけるには:

1. Fusion Middleware Controlにログインし、WebCenter PortalまたはPortal Frameworkアプリケーションのホームページに移動します。

- 第6.2項「WebCenter Portalのホームページへの移動」

- 第6.3項「Portal Frameworkアプリケーションのホームページへの移動」

2. 次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「モニタリング」→「最近のページ・メトリック」を選択します。

- WebCenter Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「最近のページ・メトリック」を選択します。

pageResponseTimeしきい値よりレスポンスが遅いページ・リクエストは、ページ上部のグラフに赤色で表示されます。

3. 「時間(ミリ秒)」列の「降順ソート」矢印をクリックして、レスポンス時間を基準にページ・リクエストをソートします。
しきい値を超えたページ・レスポンス時間は、表内にオレンジで表示されます。

4. 最も遅いページを特定し、ページが表示されるポータルを書き留めます。

5. 最も遅いページがリクエストされる頻度など、詳細なメトリックについては、次のいずれかを実行します。

- WebCenter Portalの場合: 「WebCenterポータル」メニューから、「モニタリング」→「全ページ・メトリック」を選択します。
注意: ホーム・ポータルにあるページのリクエストは、「全ページ・メトリック」ページから除外されます。

- Portal Frameworkアプリケーションの場合: 「アプリケーションのデプロイ」メニューから、「WebCenterポータル」→「全ページ・メトリック」を選択します。

第27.1.5項「ページ・リクエスト・メトリックの理解」および第27.3項「主要なパフォーマンス・メトリックのしきい値および収集のカスタマイズ」も参照してください。

G.4.4 表示の遅いページのコンポーネントを特定する方法

WebCenter PortalのPage Performance Analyzerを使用すると、ポータル・ページに個々のコンポーネントを表示するのにかかった時間、および1つのページを表示するのにかかった全体時間を簡単に確認できます。有効になっている場合、ポータル・ページを表示するたびに、このツールによって、個々のページ・コンポーネントのパフォーマンスが動的に測定および表示されます。

Portal Page Performance Analyzerは、第1レベルのパフォーマンス分析を実行する開発者、独自のページを構築する顧客、およびWebCenter Portalでページをカスタマイズするユーザーにとって有用な機能です。

この項には次のサブセクションが含まれます:

- Portal Page Performance Analyzerについて

- ポータル・ページのパフォーマンス分析の有効化および無効化

- 現在のセッションのページ・タイミング情報の表示および非表示

- Page Performance Analyzerを使用したパフォーマンスの問題のトラブルシューティング

- 制限事項

G.4.4.1 Portal Page Performance Analyzerについて

Portal Page Analyzerでは、表示の遅いページの診断を簡単に、かつ最小限の設定と構成で行えます。この機能が有効な場合、上位レベルのページ・コンポーネントの表示に要した時間が計算されて表示されるため、どのコンポーネントがページ表示の遅れの原因になっているかを一目で確認できます。ページの表示に要した全体時間も、ページの左上に表示されます(図G-8を参照)。

図G-8 ポータル・ページに表示されたタイミング情報

ページ・コンポーネントのタイミングについて

WebCenter Portalでは、上位レベルのページ・コンポーネントがShowDetailFrameで囲まれているため、これらのコンポーネントを移動したり、ページ上で表示または非表示にしたり、Oracle コンポーザで編集することができます。ここで表示されるのは、各ShowDetailFrameの全体時間です。

ページの全体時間について

ページの全体時間は、個々のページ・コンポーネントのタイミングの合計に、セッション・レプリケーション、ページ状態の保存およびリストア、ページ・レベルのセキュリティ・チェックなど、ページ・レベルの各操作の処理時間を加えたものです。

カラー・コーディング

問題領域への注意を喚起するため、パフォーマンス・タイミングは様々な色で表示されます。次の表を参照してください。

色

表示時間

緑

< 100ミリ秒

緑/黄

100 - 500ミリ秒

黄

500ミリ秒 - 1秒

オレンジ

1 - 3秒

赤

> 3秒

G.4.4.2 ポータル・ページのパフォーマンス分析の有効化および無効化

Portal Page Performance Analyzerは、初期状態では無効です。この機能を使用するには、管理者がその使用を明示的に有効化する必要があります。このツールを実行することによるページ・パフォーマンスへの影響は最小限ですが、いくつかの追加のページ処理が必要になります。

本番環境では、追加のパフォーマンス・データ収集と処理が行われないように、通常はAnalyzerを無効化しておいて、特定のページのパフォーマンスの問題が報告されたときに動的に有効化することをお薦めします。

Analyzerをほとんどの時間、無効にする別の理由として、本番環境のパフォーマンス・データがエンド・ユーザーに対して非表示になることがあげられます。

WebCenter PortalインスタンスのPortal Page Analyzerを有効化または無効化するには:

1. WLSTコマンドexportMetadataを使用して、MDSからwebcenter-config.xmlベース・ファイルをエクスポートします。
例:

exportMetadata(application='webcenter', server='WC_Spaces', toLocation='/tmp/mydata', docs='/oracle/webcenter/webcenterapp/metadata/webcenter-config.xml')

2. MDSからエクスポートされたwebcenter-config.xmlをテキスト・エディタで開いて、perfdebug-enabled属性をtrueまたはfalseに設定して、この機能を有効化または無効化します。
例:

<webcenter:perfdebug-enabled>true</webcenter:perfdebug-enabled>

3. webcenter-config.xmlを保存して閉じます。

4. 更新したwebcenter-config.xmlファイルをMDSにインポートします。
例:

importMetadata(application='webcenter', server='WC_Spaces', fromLocation='/tmp/mydata', docs='/oracle/webcenter/webcenterapp/metadata/webcenter-config.xml')

この変更を反映するのにWebCenter Portalの再起動は不要です。

この機能を有効化しても、ページ・パフォーマンス情報は自動的には表示されません。ポータル・ページにタイミング情報を表示する場合は、その情報の表示を明示的にリクエストする必要があります。詳細は、第G.4.4.3項「現在のセッションのページ・タイミング情報の表示および非表示」を参照してください。

G.4.4.3 現在のセッションのページ・タイミング情報の表示および非表示

管理者がWebCenter PortalインスタンスでPage Performance Analyzerを有効化すると、そのWebCenter Portalインスタンスにアクセスできるすべてのユーザーは、次のようにページURLにperfDebugパラメータを追加することで、現在のユーザー・セッションでページ・タイミング情報を表示するか、非表示にするかを指定できます。

目的

ページURLへのperfDebugパラメータの追加

ポータル・ページでのタイミング情報の表示

&perfDebug=on

ページ・パフォーマンス情報の表示の中止

&perfDebug=off

ポータル・ページでタイミング情報を表示するには:

1. 管理者が、WebCenter PortalインスタンスでPage Performance Analyzerを有効化していることを確認します。
第G.4.4.2項「ポータル・ページのパフォーマンス分析の有効化および無効化」も参照してください。

2. WebCenter Portalにログインし、調査対象のポータル・ページに移動します。
このページがパブリック・ページである場合は、ログインする必要はありません。

3. ページURL (図G-9)の最後に&perfDebug=onを追加します。
例:

http://mycompany.com/webcenter/portal/MySalesPortal?_adf.ctrl-state=mji8314i6_4&_afrLoop=474789135539036&perfDebug=on

4. 「実行」をクリックするか、[Enter]を押して、タイミング情報ありでページを再表示します(図G-8)。
それ以降に表示するすべてのページでもタイミング情報が示されます。

図G-9 ページURLへのperfDebugパラメータの追加

ページ・タイミング情報の表示を中止するには:

1. ブラウザで、ページURL (図G-9)の最後に&perfDebug=onを追加します。
例:

http://mycompany.com/webcenter/portal/MySalesPortal?_adf.ctrl-state=mji8314i6_4&_afrLoop=474789135539036&perfDebug=off

2. 「実行」をクリックするか、[Enter]を押して、タイミング情報なしでページを再表示します。

G.4.4.4 Page Performance Analyzerを使用したパフォーマンスの問題のトラブルシューティング

この項の手順では、WebCenter Portalの各ツールを使用して、表示の遅いページをトラブルシューティングする方法について説明します。

1. ユーザーにより、特定のページのパフォーマンスの問題が報告された場合は、表示の遅いページに移動して、パフォーマンス低下がいつも発生することを確認してください。
または、Fusion Middleware Controlを使用して、アプリケーション内の表示が一番遅いページをプロアクティブに特定します。第G.4.3項「表示の遅いページを特定する方法」を参照してください。

2. ページURLに&perfDebug=onを追加して、そのページのタイミング情報を表示します。
第G.4.4.3項「現在のセッションのページ・タイミング情報の表示および非表示」も参照してください。

注意:
ページ・タイミング情報が表示されない場合は、管理者にPage Performance Analyzerの有効化を依頼してください。詳細は、第G.4.4.2項「ポータル・ページのパフォーマンス分析の有効化および無効化」を参照してください。

3. 表示が一番遅いページ・コンポーネントを特定し、さらに問題をトラブルシューティングします。
たとえば、表示が遅いコンポーネントに次のものが含まれる場合、

- ドキュメント、wikiまたはコンテンツ・プレゼンタ: バックエンドContent ServerのパフォーマンスとContent Serverが使用するデータベースをチェックします。

- アクティビティ・ストリーム: AWRレポートを使用してデータベース・パフォーマンスをチェックし、アクティビティ・ストリームによって使用されているデータベース表をチューニングできるかどうかを調べます。

- コラボレーション機能: 関連付けられたバックエンド・サーバーのパフォーマンスをチェックします。たとえば、お知らせまたはディスカッションの場合、ディスカッション・サーバーのパフォーマンスをモニターします。

- ポートレット: Fusion Middleware Controlを使用して、ポートレット・リクエストのタイミング情報、エラー、ポートレット・プロデューサのパフォーマンスなどをモニターします。

4. 必要に応じて、表示の遅いページ・コンポーネントを別の空白ページに追加して、さらにプロファイリングを行います。
たとえば、JRockitフライト記録を使用してボトルネックを特定します。

G.4.4.5 制限事項

Page Performance Analyzerは、WebCenter Portal 11.1.1.8.0以降で作成したポータル・ページで最適に機能します。それより前のリリースでは、一部のページ・テンプレートにコンポーネントの時間とページの全体時間の表示に必要なタグが含まれていなかったり、一部のタスク・フローにactivation=deferredが構成されていませんでした。

G.4.5 表示の遅いページ・リクエストをトラブルシューティングする方法

この項の情報を使用して、ページ・パフォーマンスの低下に関連する問題を診断します。

- ライブ・リクエストのトラブルシューティング

- スタック・スレッドのトラブルシューティング

- JFR記録を使用した遅いリクエストのトラブルシューティング

- メモリー・リークとヒープ使用量問題のトラブルシューティング

- コンテンツに対する遅いリクエストのトラブルシューティング

G.4.5.1 ライブ・リクエストのトラブルシューティング

実行中の遅いページ・リクエストをトラブルシューティングするには、ユーザー・セッションが動作しているサーバーに対するJRockit Flight Recorder(JFR)レコードを抽出および表示します。第G.4.6項「JRockitフライト記録を使用してリクエストをトラブルシューティングする方法」も参照してください。

または、第G.4.2.8項「表示が非常に遅いページのパフォーマンス、高スレッド数およびシステム・ハングの診断のためのスレッド・ダンプの生成」で説明されているように、等間隔のいくつかのスレッド・ダンプをたとえば1、2秒ごとに採取します。

スレッド・ダンプを比較すると、特定のメソッド・コールに長時間を費やしたスレッドに気付く場合があります。これは、いくつかの連続したスレッド・ダンプ内のコール・スタックが同じであるためです。たとえば、データベース、Oracle WebCenter Content Server、コラボレーション・サーバー、ポートレット・プロデューサ、LDAPサーバーなどに対するメソッド・コールが存在することがあります。この場合は、関連するバックエンド・サーバーを調査して、問題を詳細に診断することができます。

G.4.5.2 スタック・スレッドのトラブルシューティング

スタック・スレッドは、次のようないくつかの理由で発生することがあります。

- サーバーがもう少しでメモリー不足になります。サーバーがメモリー不足状態に近づくと、すべてのリクエストが遅くなります。メモリー不足問題を解決するには、第G.4.5.3項「JFR記録を使用した遅いリクエストのトラブルシューティング」を参照してください。

- デッドロック・スレッド。スレッド・ダンプを採取し、デッドロック・スレッドを検索します。これにより、通常、製品コードの問題が明らかになります。

- 極度に遅いページ・リクエスト。等間隔のいくつかのスレッド・ダンプを採取し、実行に時間のかかっているメソッドを見つけます。
リクエストにかかる時間が10分を超える場合は、スタック・スレッドが、次のディレクトリにあるOracle WebLogic Serverのserver_name.outに報告されます。

(UNIX) DOMAIN_HOME/servers/server_name/logs
(Windows) DOMAIN_HOME\servers\server_name\logs

例:

<Mar 4, 2012 7:44:08 AM PST> <Error> <WebLogicServer> <BEA-000337>
<[STUCK] ExecuteThread: '19' for queue: 'weblogic.kernel.Default (self-tuning)'
has been busy for "600" seconds working on the request
"weblogic.servlet.internal.ServletRequestImpl@18986012[

GET
/server_name/faces/PimDashboardUiShellPage?_afrLoop=1398820150000&_afrWindowMod
e=0&_adf.ctrl-state=a44e7uxcc_13 HTTP/1.1
Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg,
application/x-shockwave-flash, application/x-ms-application,
application/x-ms-xbap, application/vnd.ms-xpsdocument, application/xaml+xml,
application/vnd.ms-excel, application/vnd.ms-powerpoint, application/msword,
*/*
Accept-Language: fr
UA-CPU: x86
...
]", which is more than the configured time (StuckThreadMaxTime) of "600"
seconds
. Stack trace:
Thread-164 "[STUCK] ExecuteThread: '19' for queue: 'weblogic.kernel.Default
(self-tuning)'" <alive, in native, suspended, priority=1, DAEMON> {
jrockit.net.SocketNativeIO.readBytesPinned(SocketNativeIO.java:???)
jrockit.net.SocketNativeIO.socketRead(SocketNativeIO.java:24)
java.net.SocketInputStream.socketRead0(SocketInputStream.java:???)
java.net.SocketInputStream.read(SocketInputStream.java:107)
...

スタック・スレッドの診断

スレッドが別のサーバーからのレスポンスを待機していることをスタックが示す場合は、他のサーバーのステータスを確認し、次のステップに進む前に、サーバーにパフォーマンス上の問題がないかどうかを調べます。

スタック・スレッドが、スタックされる前に行っていたことを判断するには、次のステップを実行します。

1. server_name.outにある次のいくつかのログ・メッセージで、インシデントが作成されたことを示すメッセージを確認します。例:

<Mar 4, 2012 7:44:10 AM PST> <Alert> <Diagnostics> <BEA-320016>
<Creating diagnostic image in DOMAIN_HOME/servers
/server_name/adr/diag/ofm/MyDomain/
server_name_1/incident/incdir_394 with a lockout minute
period of 1.>

前述のメッセージは、各スタック・スレッドが報告された後に必ず表示されるとはかぎりません。出力されるのは、1時間に最大でも4回です。メッセージが表示されない場合は、次のディレクトリの下のサブディレクトリにあるreadmeファイルを確認して、手動でincidentディレクトリを見つけてください。

(UNIX) DOMAIN_HOME/servers/server_name/adr/diag/ofm/domain_name/server_name/incident
(Windows) DOMAIN_HOME\servers\server_name\adr\diag\ofm\domain_name\server_name\incident

incidentディレクトリには、JFR記録を含むWLDF診断イメージとスレッド・ダンプを含むファイルがあります。

インシデントの診断の詳細は、管理者ガイドの「問題の診断」を参照してください。

2. スレッド・ダンプを確認して、スレッドのコール・スタックを見つけます。スレッドがブロックされロックを待機中の場合は、ロックを保持しているスレッドが何を実行しているかを確認します。

3. JDBCコールに長時間を要していることをコール・スタックが示す場合は、データベースにAWRレポートを生成し、問合せと検索および調整する表を見つけます。
第G.4.2.5項「データベースの自動ワークロード・リポジトリ(AWR)レポートの生成」を参照してください。

4. JRockitフライト記録ファイルJRockitFlightRecorder.jfrで詳細を確認します。さらに、incidentディレクトリのreadme.txtファイルに記録されるリクエストのECIDと、Oracle WebLogic Serverログも必要になります。
第G.4.6項「JRockitフライト記録を使用してリクエストをトラブルシューティングする方法」も参照してください。

スタック・スレッドの原因となったリクエストのECIDは、エラー・メッセージに記録されます。

G.4.5.3 JFR記録を使用した遅いリクエストのトラブルシューティング

第G.4.6項「JRockitフライト記録を使用してリクエストをトラブルシューティングする方法」を参照してください。

G.4.5.4 メモリー・リークとヒープ使用量問題のトラブルシューティング

WebCenter PortalまたはPortal Frameworkアプリケーションのパフォーマンスが徐々に低下し、ヒープ使用量とガベージ・コレクション・アクティビティが増加しており、さらにOutOfMemoryErrorsが表示される場合は、アプリケーション内でメモリー・リークが発生し、JVMの空きメモリー容量が連続して減少する可能性があります。

図G-10は、JConsoleに表示される一般的なメモリー・リークの傾向を示しています。

図G-10 JConsoleにおける一般的なメモリー・リークの傾向

この問題を解決するには:

1. OutOfMemoryErrorsエラーの原因を判断します。

- server_name.outファイルで、OutOfMemoryErrorsエラーを確認します。
server_name.outファイルは、次の場所にあります。

(UNIX) DOMAIN_HOME/servers/server_name/logs
(Windows) DOMAIN_HOME\servers\server_name\logs

- OutOfMemoryErrorsエラーが発生したときに、メモリー・ダンプを採取します。
例:

Sun HotSpotの場合: jmap -dump:live,format=b,file=<path>/heap.hprof <pid>

JRockitの場合: jrcmd <pid> hprofdump filename=<path>/heap.hprof

OutOfMemoryErrorsが発生するたびに、HPROFバイナリ形式(.hprofファイル)で自動的にヒープ・ダンプを生成するようにJRockitを構成できます。構成するには、JRockit JVMオプション-XX:+HeapDumpOnOutOfMemoryErrorを設定します。詳細は、Oracle JRockitコマンド行リファレンスを参照してください。

2. 管理対象サーバーを再起動します。
問題が解決しない場合は、ステップ3に進みます。

3. HPROFバイナリ形式を処理できるヒープ・ダンプ分析ツール(Eclipse Memory Analyzerなど)で、heap.hprofファイルを開きます。

4. 大部分のメモリーを保持しているオブジェクトとクラスを判断します。

5. 必要に応じて、いくつかのヒープ・ダンプを採取し、メモリーを消費および増加させているオブジェクトまたはクラスを判断します。
少なくとも2つのメモリー・ダンプを採取します。

- システムがウォーム・アップし安定したときに、1番目のダンプを採取します。

- システムのメモリーが不足しつつあるとき、つまり完全ガベージ・コレクションによって最大ヒープ・サイズから取得されるのが300MB未満になったときに、2番目のダンプを採取します。

Sun HotSpot(jmap)またはJRockit(jcrcmd)を使用してヒープ・ダンプを採取する手順は、ステップ1で説明しています。

Oracle JRockit JDKツール・ガイドの「診断コマンドの実行」を参照してください。Eclipse Memory Analyzerなどの多くのメモリー・ヒープ・ダンプ分析ツールを使用すると、2つのヒープ・ダンプを比較してメモリー増加領域を特定できます。

ヒープ・ダンプは、メモリーが保持される(保持ヒープ)原因に関する情報を提供します。メモリーの割当て方法を知り、問題のさらなる解決が必要になる場合があります。このような場合は、ステップ6に進みます。

6. JRockit Mission Control Clientに属するJRockit Memory Leak Detectorツールを使用して、メモリーの割当て方法を理解します。
詳細は、JRockit Mission Controlのオンライン・ヘルプを参照してください。

G.4.5.5 コンテンツに対する遅いリクエストのトラブルシューティング

ページ・パフォーマンスが遅い原因がコンテンツ/ドキュメント関連のコンポーネント、たとえばドキュメント・サービス・タスク・フロー、コンテンツ・プレゼンタ・タスク・フロー、Wikiまたはブログの場合は、バックエンドOracle WebCenter Content Server(「システム監査情報」ページ)のパフォーマンス・メトリックを参照することをお薦めします。詳細は、『Oracle WebCenter Contentの管理』のシステム監査情報の表示に関する項を参照してください。

データベースに送信される問合せごとにパフォーマンス情報を確認できるように、systemdatabaseトレース・オプションが選択されていることを確認します。詳細は、『Oracle WebCenter Contentの管理』のサーバー全体のトレースに関する項を参照してください。

G.4.6 JRockitフライト記録を使用してリクエストをトラブルシューティングする方法

JRockit Flight Recorder(JFR)ファイルには、時間を費やす様々なイベントの記録が含まれています。リクエストが遅い場合は、JRockit Flight Recorder(JFR)ファイルを分析して、リクエストに時間のかかる原因を探ることができます。

JFRファイルを作成するには:

1. 次のコマンドを実行して、Oracle WebLogic ServerからJFRファイルを抽出します。

UNIX) JROCKIT_HOME/bin/jrcmd jrockit_pid dump_flightrecording recording=1 copy_to_file=path compress_copy=true

(Windows) JROCKIT_HOME\bin\jrcmd.exe jrockit_pid dump_flightrecording recording=1 copy_to_file=path compress_copy=true

jrcmdコマンド行ツールの詳細は、Oracle JRockit JDKツール・ガイドの診断コマンドの実行に関する項を参照してください。

2. ファイルを表示するには、次のディレクトリからJRockit Mission Control Clientを開始します。

(UNIX) JAVA_HOME/bin/bin/jrmc

(Windows) JAVA_HOME\bin\jrmc.exe

3. 「ファイル」→「ファイルを開く」を選択して、JFRファイルを選択します。

4. 最も遅いリクエストを見つけるか、特定のリクエストを調査します。

最も遅いリクエストを特定するには:

特定のリクエストを調査するには:

1. JRockitFlightRecorder.jfrページで、「イベント」アイコンをクリックします。

2. ページ下部の「ログ」タブをクリックします。

3. 左側の「イベント・タイプ」ナビゲーション・ペインで、「ダイナミック・モニタリング・システム」とHttpRequestを見つけます。

4. 「HTTPリクエスト」をクリックして、その他すべてのイベント・タイプの選択を解除します。

5. 「ログ」タブの「イベント・ログ」セクションで、「期間」列をクリックして期間を降順でソートします。
各行はHTTPリクエストに対応し、期間列にはそのリクエストのレスポンス時間が表示されます。

6. 表内の行をクリックして、リクエストの属性を表示します。

7. 「イベント属性」セクションで、開始時間とリクエストを処理したスレッドに注目します。

1. そのリクエストの実行コンテキスト識別子(ECID)を見つけます。
リクエストが、スタック・スレッドによってトリガーされたインシデントに関連する場合は、インシデントのreadme.txtファイルにECIDが含まれます。

あるいは、Oracle WebLogic Server HTTP access.logで特定のユーザーからのリクエストを検索することができます。管理者ガイドのログ・ファイルの検索と表示に関する項を参照してください。

2. JRockit Mission Control ClientのJRockitFlightRecorder.jfrページで、「WebLogic」アイコンをクリックします。
注意: 「WebLogic」アイコンを利用できない場合は、「ヘルプ」→「プラグインのインストール」を選択して、Oracle WebLogic Serverプラグインをダウンロードします。

3. ページ下部の「ECIDs」タブをクリックします。

4. 「ECIDs」セクションの「列のフィルタ処理」リストから、「ECID」をクリックします。

5. 検索ボックスにECIDを入力して、[Enter]を選択します。

6. 結果表で、一致するECIDのある行を強調表示し、右クリックしてメニューを表示します。

7. 「操作セット」→「クリア」を選択し、次に「操作セット」→「一致ECIDの追加」→「ECID」を選択して、ECIDを操作セットに追加します。
これにより、ユーザーは操作セットに関連付けられたイベントのみを表示できます。

8. 「イベント」アイコンをクリックします。

9. 左側の「イベント・タイプ」ナビゲーション・ペインで、「ダイナミック・モニタリング・システム」とHttpRequestを見つけます。

10. 「HTTPリクエスト」をクリックして、その他すべてのイベント・タイプの選択を解除します。 ** 「イベント・ログ」セクションで、「操作セットのみ表示」をクリックします。
各行は、一致するECIDのあるリクエストに対応します。

11. 表内の行をクリックして、リクエストの属性を表示します。

12. 開始時間とリクエストを処理したスレッドに注目します。

5. 開始時間とリクエストを処理したスレッドを特定したら、「ログ」タブに移動し、リクエストの期間の時間枠のみを含めるように、画面上部の時間セレクタをドラッグします。

6. 「イベント・ログ」セクションで、次のように検索を実行します。

1. 「操作セットのみ表示」の選択を解除します。

2. 検索ボックスにスレッド名を入力します。

3. 「列のフィルタ処理」リストから、「スレッド」を選択します。

4. [Enter]を選択します。

7. 左側の「イベント・タイプ」ナビゲーション・ペインで、目的のイベントをクリックします。通常これらのイベントは、「ダイナミック・モニタリング・システム」、「Javaアプリケーション」、および「WebLogic」→「JDBC」の下にあります。
選択済イベントは、「イベント・ログ」セクションの表に表示されます。

8. 「開始時間」列をクリックして、これらのイベントが発生した時間をソートするか、「期間」列をクリックして最も時間のかかったイベントを表示します。
「JDBC文実行」イベントは、SQL実行に対応しています。遅いSQL文がある場合は、イベントの詳細にSQLテキストが表示されます。これらのイベントには、コール・スタックはありません。

9. 遅いSQL文のコール・スタックを確認するには、「JDBC文実行」イベント直後に発生した「ソケット読取り」イベントを表示します。
このイベントは、SQL結果が返されるのを待機しているOracle WebLogic Serverに対応し、イベントの詳細にコール・スタックが含まれています。

10. 長い「Javaブロック」および「Java待機」イベントのコール・スタックを参照し、パフォーマンス低下の原因を特定できるかどうかを確認します。
『Oracle WebLogic Server診断フレームワークの構成と使用』のJRockit Mission ControlのFlight Recorderデータの分析に関する項を参照してください。

11. デフォルトのレコードで取得されるものより詳細な情報が必要であり、遅いリクエストを再現できる場合は、明示的なレコードを開始できます。
Oracle JRockit Flight Recorderランタイム・ガイドの明示的なレコードの開始に関する項を参照してください。

G.5 My Oracle Supportを使用してその他のトラブルシューティング情報を得る

My Oracle Support(以前はMetaLink)を使用して、Oracle WebCenter Portal問題を解決することができます。My Oracle Supportには、次のような有用なトラブルシューティング・リソースが含まれています。

- ナレッジ・ベース記事

- コミュニティのフォーラムとディスカッション

- パッチとアップグレード

- 動作保証情報

注意:
My Oracle Supportを使用して、サービス・リクエストを記録することもできます。

My Oracle Supportには、https://support.oracle.comからアクセスできます。

G.6 WebCenter Portalワークフローのトラブルシューティング

WebCenter Portalワークフローで問題が発生する場合、次の項を参照してください。

- 第G.6.1項「WebCenter Portalワークフローの構成の検証」

- 第G.6.2項「WebCenter Portalワークフローの問題のトラブルシューティング」

G.6.1 WebCenter Portalワークフローの構成の検証

『Oracle WebCenter Portalインストレーション・ガイド』には、WebCenter Portalワークフローのインストール方法と構成方法が記載されています。詳細は、WebCenter Portalワークフローのバックエンド要件に関する項を参照してください。ワークフローの構成は、次のように検証できます。

1. WebCenter Portalにログインします。

2. ポータルを作成し、「メンバー」タブに移動します(「管理」リンク→「セキュリティ」→「メンバー」をクリックします)。

3. 任意のロールを持つ新しいメンバー(たとえば、User2)を招待します。

4. ログアウトした後、User2としてログインします。

5. 「ワークリスト」タスク・フローに移動します。

6. 招待通知を開いて、「承認」ボタンをクリックします。

7. ポータルを開きます。

WebCenter Portalワークフローが正常に機能している場合は、新しく作成したポータルをUser2が使用できます。ポータルが使用できない場合やリストされていない場合は、その構成に問題があります。

G.6.2 WebCenter Portalワークフローの問題のトラブルシューティング

WebCenter Portalワークフローが正常に機能していない場合は、次の手順で問題をトラブルシューティングします。

1. 次の手順で、WebCenter PortalワークフローがOracle SOAサーバーにデプロイされていることを確認します。

1. Fusion Middleware Controlにログインします。

2. WebCenterWorklistDetailApp.earがデプロイされていることを確認します。

3. sca_CommunityWorkflows.jarがデプロイされていることを確認します。

詳細は、『Oracle WebCenter Portalインストレーション・ガイド』のOracle SOA Server - ドメインの拡張に関する項を参照してください。

2. 次の手順で、Oracle SOAサーバーとWebCenter Portalアプリケーション間のWebサービス接続がセキュアであることを確認します。

1. Oracle SOAサーバーのキーストア・ファイル内の別名をチェックします。
たとえば、次のコマンドを使用して、Oracle SOAサーバーのキーストア・ファイルの内容をリストします。

keytool -list -v -keystore bpel.jks -storepass <password>

次の内容のエントリがあるはずです。

Alias name: webcenter_portals_ws

『Oracle WebCenter Portalインストレーション・ガイド』のSOAドメインの設定に関する項を参照してください。

2. WebCenter PortalとOracle SOAサーバーの資格証明ストアが、両方とも正しく構成されていることを確認します。

3. 接続の両端に、次のようなキーストアが存在することを確認します。
- webcenter.jks (WebCenter Portalサーバー側にコピーされる)

- bpel.jks (Oracle SOAサーバー側にコピーされる)

たとえば、次のコマンドでwebcenter.jksおよびbpel.jksが生成されます。

keytool -genkeypair -keyalg RSA -dname "cn=webcenter,dc=us,dc=oracle,dc=com" -alias webcenter -keypass mypassword -keystore webcenter.jks -storepass mypassword -validity 360
keytool -exportcert -v -alias webcenter -keystore webcenter.jks -storepass mypassword -rfc -file webcenter.cer
keytool -importcert -alias webcenter_spaces_ws  -file webcenter.cer -keystore bpel.jks -storepass mypassword
keytool -genkeypair -keyalg RSA -dname "cn=bpel,dc=us,dc=oracle,dc=com" -alias bpel -keypass mypassword -keystore bpel.jks -storepass mypassword -validity 360
keytool -exportcert -v -alias bpel -keystore bpel.jks -storepass mypassword -rfc -file bpel.cer
keytool -importcert -alias bpel -file bpel.cer -keystore webcenter.jks -storepass mypassword

『Oracle WebCenter Portalの管理』の「SOAドメイン・キーストアの作成」を参照してください。

4. Oracle SOAサーバー(soa-infra)で、BPMWorkflowAdminアプリケーション・ロールのロール・メンバーを構成します。
weblogicユーザーを含まないアイデンティティ・ストアにドメインを関連付ける場合は、それ以外の有効なユーザーをアプリケーション・ロールBPMWorkflowAdminに割り当てる必要があります。この作業は、SOA OracleホームからWLSTコマンドを使用して実行します。たとえば、LDAPに存在するmontyという名前のユーザーを割り当てるには、次のように実行します。

cd $SOA_ORACLE_HOME/common/bin/
wlst.sh

connect('<admin username>','<admin password>', 'mysoahost.example.com:7001')
revokeAppRole(appStripe="soa-infra", appRoleName="BPMWorkflowAdmin", principalClass="oracle.security.jps.service.policystore.ApplicationRole", principalName="SOAAdmin")
grantAppRole(appStripe="soa-infra", appRoleName="BPMWorkflowAdmin", principalClass="weblogic.security.principal.WLSUserImpl", principalName="monty")

『WebLogic Scripting Toolコマンド・リファレンス』のWLSTセキュリティ・コマンドの概要に関する項を参照してください。

G.7 WebCenter Portalのインポートおよびエクスポートのトラブルシューティング

この項には次のサブセクションが含まれます:

- 第G.7.1項「ResourceLimitExceptionの問題」

- 第G.7.2項「LockRefreshTaskの問題」

- 第G.7.3項「ポータルおよびポータル・テンプレートがインポート後に使用できない」

- 第G.7.4項「ソース・アプリケーションとターゲット・アプリケーションが同じContent Serverを共有している場合は、ポータルまたはドキュメントを移行できない」

G.7.1 ResourceLimitExceptionの問題

問題

すべてのポータルまたはWebCenter Portalインスタンス全体をエクスポートしようとすると、次のResourceLimitExceptionエラーが表示されます。

Weblogic.common.resourcepool.ResourceLimitException

解決策

JDBC接続プールで最大容量を増加します。接続プールを再構成するには、WLS管理コンソールにログインします。「サービス」から、「データ・ソース」、「WebCenterDS」、「接続プール」タブを選択します。

G.7.2 LockRefreshTaskの問題

問題

WebCenter Portalインスタンス全体またはポータルをインポートまたはエクスポートしようとすると、次のようなLockRefreshTask警告が表示されます。

[WARNING] [][oracle.webcenter.lifecycle.operation.LockRefreshTask]

インポートまたはエクスポート操作を再度試行すると、次のようなエラーが表示されます。

Starting WebCenter Portal application import...
WebCenter Portal application import started.

Error occurred while performing import
None
Check the WebCenter Portal log files for additional details.
Unable to contact MBeanServer for
oracle.webcenter.lifecycle:ApplicationName=webcenter,Location=WC_Spaces,name=Lifec
ycleManager,type=LifecycleManager,Application=webcenter,ApplicationVersion=11.1.1.
4.0
Error occurred while destroying MBean
The lock hasnt been released from the previous failed import.

解決策

予期しない異常なインポートまたはエクスポート操作の失敗が原因で作成され、破棄されなかったMDSの不要なロックをdeleteMetadata WLSTコマンドを使用して削除します。失敗した操作に応じて、次のいずれかのコマンドを実行します。

WebCenter Portalアプリケーションのインポートに失敗した場合、次のコマンドを実行します。

deleteMetadata(application='webcenter', server='WC_Spaces', docs='/oracle/webcenter/lock/applicationImport/applicationImport.xml')

WebCenter Portalアプリケーションのエクスポートに失敗した場合、次のコマンドを実行します。

deleteMetadata(application='webcenter', server='WC_Spaces', docs='/oracle/webcenter/lock/applicationExport/applicationExport.xml')

ポータルのインポートに失敗した場合、次のコマンドを実行します。

deleteMetadata(application='webcenter', server='WC_Spaces', docs='/oracle/webcenter/lock/scopeImport/**')

ポータルのエクスポートに失敗した場合、次のコマンドを実行します。

deleteMetadata(application='webcenter', server='WC_Spaces', docs='/oracle/webcenter/lock/gsExportImport/**')

G.7.3 ポータルおよびポータル・テンプレートがインポート後に使用できない

問題

インポート操作後にWebCenter Portalに最初にログインすると、移行したポータルおよびポータル・テンプレートが予期したとおりに使用できません。これは、ポータルまたはポータル・テンプレート・キャッシュが適切にリフレッシュできない場合に発生することがあります。

解決策

refreshGroupSpaceCacheおよびrefreshSpaceTemplateCache WLSTコマンドを使用して、ポータルまたはポータル・テンプレート・キャッシュを手動でリフレッシュします。

キャッシュ(すべてのポータル)を完全にクリアするには:

refreshGroupSpaceCache(appName='webcenter', spaceNames='', syncMode=1,updateType='all', cleanCache=1)

キャッシュ(すべてのポータル・テンプレート)を完全にクリアするには:

refreshSpaceTemplateCache(appName='webcenter', spaceTemplateNames='',syncMode=1, updateType='all', cleanCache=1)

コマンド構文の詳細と例は、『WebLogic Scripting Toolコマンド・リファレンス』のrefreshGroupSpaceCacheに関する項およびrefreshSpaceTemplateCacheに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

G.7.4 ソース・アプリケーションとターゲット・アプリケーションが同じContent Serverを共有している場合は、ポータルまたはドキュメントを移行できない

同じContent Serverを共有している2つの異なるWebCenter Portalインスタンス間でポータルまたはポータル・テンプレートを移行できません。

G.8 個別のポータルとポータル・テンプレートのインポートおよびエクスポートのトラブルシューティング

この項には次のサブセクションが含まれます:

- 第G.8.1項「エクスポートまたはインポートの失敗後にポータルがブロックされる」

- 第G.8.2項「インポート後にページまたはポータルが見つからないというメッセージが表示される」

- 第G.8.3項「ポータル・インポート・アーカイブが最大ファイル・アップロード・サイズを超えている」

- 第G.8.4項「エクスポート時にポータルの最大数を超える」

- 第G.8.5項「リストが適切にインポートされない」

- 第G.8.6項「ツールとサービスが構成されているポータルのエクスポートおよびインポート」

- 第G.8.7項「インポート後にツールとサービスが無効化される」

- 第G.8.8項「サブポータル・ページからのインポート」

- 第G.8.9項「ソース・アプリケーションとターゲット・アプリケーションが同じContent Serverを共有している場合は、ポータルをインポートできない」

- 第G.8.10項「マルチバイト言語でのポータルのエクスポートおよびインポート」

G.8.1 エクスポートまたはインポートの失敗後にポータルがブロックされる

ポータルのエクスポートまたはインポート操作時にエラーが発生した場合は、一部のポータルがブロックされている可能性があります。ポータルのブロックを解除するには、一時的にポータルをオンラインの状態に戻してから、再度オフラインの状態にし、エクスポートまたはインポート操作を実行してください。オンライン・モードとオフライン・モードを切り替えることにより、ポータルのブロックが解除されます。詳細は、第46.11項「任意のポータルのオフライン化」および第46.12項「任意のポータルの再オンライン化」を参照してください。『WebLogic Scripting Toolコマンド・リファレンス』のWLSTコマンドsetSpaceStateも参照してください。

G.8.2 インポート後にページまたはポータルが見つからないというメッセージが表示される

インポート操作後に初めてWebCenter Portalにログインするときに、最後にアクセスしたページまたはポータルが存在しない場合、「ページが見つかりません」または「ポータルが見つかりません」というメッセージが表示される場合があります。最後にアクセスしたページの情報はインポート操作中に保持されるため、このようなメッセージが表示されることがあります。

G.8.3 ポータル・インポート・アーカイブが最大ファイル・アップロード・サイズを超えている

問題

WebCenter Portalにコンテンツをアップロードするには、ファイル・サイズ制限があります。エクスポートのアーカイブが最大アップロード・サイズを超える場合、WebCenter Portal管理からのインポート操作が失敗します。

解決策

WLSTを使用してポータル・アーカイブをインポートします。詳細は、第40.1.2.4.3項「WLSTを使用したポータルのアーカイブからのインポート」を参照してください。

または、webcenter-config.xmlの最大アップロード・サイズを変更します。デフォルトの最大アップロード・サイズは2GBです。第9.12項「最大ファイル・アップロード・サイズの変更」を参照してください。

G.8.4 エクスポート時にポータルの最大数を超える

問題

エクスポートできるポータルの最大数は、MDSデータ・ソースに対して指定する接続プール・サイズの80%以下である必要があります。エクスポートしようとするポータルの数が多すぎると、次のResourceLimitExceptionエラーが表示される場合があります。

Weblogic.common.resourcepool.ResourceLimitException

解決策

エクスポートするポータルの数を減らします。または、接続プールの設定を変更します。詳細は、パフォーマンス・チューニング・ガイドを参照してください。

G.8.5 リストが適切にインポートされない

問題

リストが、ソースおよびターゲット・システムのリスト定義の相違により、適切にインポートされていません。

解決策

リスト・データをエクスポートおよびインポートすることを検討してください。これにより、リスト・データがインポートされるリスト定義と一貫性を持つようになります。

データなしにインポートする場合は、ターゲット・システムのリスト・データはインポートされたリスト定義と一貫性を持つように移行されます。リスト列データ・タイプが変更される場合、可能な場合は、列の値はターゲット・データ・タイプからインポートされたデータ・タイプに変換されます。リスト列がインポート時に削除される場合、列の値は削除されます。

G.8.6 ツールとサービスが構成されているポータルのエクスポートおよびインポート

問題

ツールとサービスが構成されているポータルをエクスポートし、これらのツールやサービスの一部またはすべてが構成されていないインスタンスから同じポータルをインポートしようとすると、次のエラー・メッセージが表示されます。

The following services are not configured: <list of tools and services>. Please configure these services and try again.

解決策

ツールとサービスをターゲットに追加するか、または次に示すアーカイブのdata.xmlファイルからサービス関連の情報を削除して、この問題を解決することができます。

サービス関連の情報を削除する操作は、次のとおりです。

1. アーカイブを抽出します。
アーカイブには、2つのファイル(policy-store.xmlおよびtransport.mar)が含まれます。

2. ディレクトリにtransport.marを展開します。
data.xmlファイルは、oracle\webcenter\lifecycle\importexportディレクトリにあります。

3. エラー・メッセージでリストされるターゲットに存在しないすべてのツールとサービスのサービス・タグを削除します。
前述のエラー・メッセージ例では、次を削除する必要があります。

<service id="oracle.webcenter.collab.forum" version="11.1.1.0">
<metadataUsages>
<metadataUsage includeBaseDocuments="YES" includeSystemCustomizations="YES">
<paths>
<include path="/oracle/webcenter/collab/forum/scopedMD/s516227ec_dde1_4991_9e18_28d487cb3bce/**"/>
</paths>
</metadataUsage>
</metadataUsages>
</service>

<service id="oracle.webcenter.collab.rtc" version="11.1.1.0"/>

4. トップレベルのディレクトリOracleおよびpagedefsをtransport.marという名前のファイルに圧縮することにより、transport.marをリパックします。

5. 新しく作成したtransport.marおよびpolicy-store.xmlファイルをアーカイブに圧縮することにより、exportアーカイブをリパックします。

6. 新しいアーカイブをインポートします。

G.8.7 インポート後にツールとサービスが無効化される

問題

ポータルのインポート後に、ポータル管理で直接「ツールとサービス」タブに移動すると、ソース・ポータルで有効化されている場合でも、すべてのツールとサービスが無効化されます。

これは、インポートするアーカイブに、WebCenter Portal 11.1.1.8より前のリリースからエクスポートされたポータルが含まれる際に発生する場合があります。

解決策

必要に応じて、ツールとサービス用の「有効化」チェック・ボックスを選択します。

または、インポート後にポータル管理に移動するかわりに、ポータルを開きます。ポータルに初めてアクセスするときに、ツールとサービスが自動的に有効化されます。

G.8.8 サブポータル・ページからのインポート

問題

「ポータル」ページからポータルをインポートする場合、インポートしたポータルが現在のポータルのサブポータルに自動的になることはありません。新たにインポートされたポータルは、「ポータル」スイッチャ・メニュー、ポータル・ブラウザ・タスク・フローまたは「ポータル」ページに表示されます。これらは、使用可能なすべてのポータルを表示しています。

解決策

アーカイブをインポートする前に「ポータル」ページで親ポータルを選択すると、サブポータルとしてポータルをインポートできます。

G.8.9 ソース・アプリケーションとターゲット・アプリケーションが同じContent Serverを共有している場合は、ポータルをインポートできない

同じContent Serverを共有している2つの異なるWebCenter Portalアプリケーション間でポータルまたはポータル・テンプレートをエクスポート/インポートできません。

同様に、同じContent Serverを共有している2つの異なるWebCenter Portalアプリケーション間でドキュメント移行ユーティリティを使用してポータル・ドキュメントを移行できません。

G.8.10 マルチバイト言語でのポータルのエクスポートおよびインポート

問題

Linuxでは、名前付け制限により、マルチバイト言語で作成された1つ以上のポータルに対して、個々のポータルのエクスポートまたはインポートが失敗します。ポータル名は、英数字およびポータル文字("a" - "z"、"A" - "Z"、"0" - "9"、およびWebCenter Portalが"_"(アンダースコア)で置き換えるシングルバイト・ポータル文字)に制限されます。他の文字がポータル名で使用される場合、エクスポートまたはインポートは失敗します。

解決策

Oracle WebCenter Portalがデプロイされるサーバー上で名前付け制限を強制します。これを行うには、環境変数LC_ALLをutf-8に設定します。

H FrameworkFoldersへのFolders_gの移行

この付録では、Oracle WebCenter Content ServerでOracle WebCenter PortalコンテンツをFolders_gフォルダ・サービスからFrameworkFoldersフォルダ・サービスに移行する方法について説明します。

この付録の内容は次のとおりです。

- H.1項「FrameworkFoldersへのFolders_gの移行の理解」

- H.2項「Folders_gおよびFrameworkFoldersのディレクトリ構造の理解」

- H.3項「別個のContent Serverに接続されているWebCenter PortalおよびPortal Frameworkアプリケーションの移行」

- H.4項「同じContent Serverに接続されているWebCenter PortalおよびPortal Frameworkアプリケーションの移行」

- H.5項「移行に関する問題のトラブルシューティング」

H.1 FrameworkFoldersへのFolders_gの移行の理解

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

Oracle WebCenter Portalのまったく新しいインストールの場合、Content ServerでFrameworkFoldersコンポーネントを有効にすることをお薦めします。Folders_gフォルダ・サービスを使用する以前のバージョンからパッチを適用されたOracle WebCenter Portalインスタンスの場合は、引き続きFolders_gを使用するか、FrameworkFolderフォルダ・サービスに移行するかを選択できます。パフォーマンスを向上させてContent Serverの任意の新機能を使用できるようにするために、Content ServerのFrameworkFoldersコンポーネントを有効化することをお薦めします。

注意:
FrameworkFoldersは、以前のFolders_gコンポーネントに置き換わるコンポーネントの名前です。以前のフォルダ・インタフェースはコントリビューション・フォルダと呼ばれるようになりました。FrameworkFoldersコンポーネントによりサポートされるインタフェースはFoldersと呼ばれます。
この章では、FrameworkFoldersとFolders_gという用語を使用して移行プロセスを説明します。UIの選択またはコマンドを指す場合を除き、FrameworkFoldersという用語はFoldersと同義で使用され、Folders_gという用語はコントリビューション・フォルダと同義で使用されます。

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

図H-1および表H-1に、現在の環境を最もよく表すOracle WebCenter Portalインストールの開始ポイント、およびFolders_gおよびFrameworkFoldersフォルダ・サービスを選択するためにたどることのできるパスを示します。

図H-1 Folders_gおよびFrameworkFolders設定の開始ポイント

表H-1 Folders_gおよびFrameworkFolders設定の開始ポイント

開始ポイント

タスク

サブタスク

Oracle WebCenter Portalの新規インストール?

FrameworkFoldersコンポーネントの有効化

11.1.1.9.0にアップグレードされたOracle WebCenter Portal 11gの既存のインストール?

引き続きFolders_gを使用するかFrameworkFoldersに移行するかを選択します。

引き続きFolders_gを使用する場合、これ以上の構成は不要です。

Folders_gからFrameworkFoldersに移行する場合:

- 同じContent Server: WebCenter PortalおよびPortal Frameworkアプリケーションが同じContent Serverに接続されている場合、一緒に移行します。

- 異なるContent Server: WebCenter PortalおよびPortal Frameworkアプリケーションが異なるContent Serverインスタンスに接続されている場合、別々に移行します。

H.2 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

図H-2は、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の下に整理されてます。

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

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

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

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

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

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

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

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

H.3 別個のContent Serverに接続されているWebCenter PortalおよびPortal Frameworkアプリケーションの移行

ここでは、別個のContent Serverに接続されている場合に、WebCenter PortalおよびPortal FrameworkアプリケーションをFolders_gからFrameworkFolders設定に移行する手順について説明します。WebCenter PortalおよびPortal Frameworkアプリケーションは任意の順序で移行できます。WebCenter Portalを最初に移行する必要はありません。

- H.3.1項「FrameworkFoldersへのWebCenter Portalメタデータの移行」

- H.3.2項「FrameworkFoldersへのPortal Frameworkアプリケーションの移行」

H.3.1 FrameworkFoldersへのWebCenter Portalメタデータの移行

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

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

- H.3.1.1項「移行ロードマップ」

- H.3.1.2項「exportFoldersGDataの実行による移行前データの生成」

- H.3.1.3項「FrameworkFoldersへのWebCenter Portalメタデータの移行」

- H.3.1.4項「migrateFoldersGDataToFrameworkFoldersの実行による移行したデータの検証」

H.3.1.1 移行ロードマップ

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

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

図H-5 WebCenter PortalデータのFolders_gからFrameworkFoldersへの移行

表H-2 WebCenter PortalデータのFolders_gからFrameworkFoldersへの移行

タスク

説明

ドキュメント

WLSTコマンドexportFoldersGDataの実行

WLSTコマンドexportFoldersGDataをWebCenter Portal Oracleホーム・ディレクトリから実行して、移行前データを生成します。

H.3.1.2項「exportFoldersGDataの実行による移行前データの生成」

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

Content Serverで移行ユーティリティを実行して、WebCenter PortalデータをFolders_gからFrameworkFoldersに移行します。

H.3.1.3項「FrameworkFoldersへのWebCenter Portalメタデータの移行」

WLSTコマンドmigrateFoldersGDataToFrameworkFoldersの実行

WLSTコマンドmigrateFoldersGDataToFrameworkFoldersをWebCenter Portal Oracleホーム・ディレクトリから実行して、移行したデータを検証します。

H.3.1.4項「migrateFoldersGDataToFrameworkFoldersの実行による移行したデータの検証」

すべての管理対象サーバーの再起動

WebCenter PortalおよびContent Server管理対象サーバーを含むすべての管理対象サーバーを再起動します。

管理者ガイドのOracle WebLogic Serverインスタンスの起動と停止に関する項を参照してください。

H.3.1.2 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/')

コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のexportFoldersGDataに関する項を参照してください。このコマンドは、WebCenter Portal Oracleホーム・ディレクトリから実行する必要があります。WLSTコマンドの実行方法の詳細は、第1.13.3.1項「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の実行中に、ファイルに別の場所を選択できます。

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

図H-6 PreMigrationData.csvファイルのサンプル

H.3.1.3 FrameworkFoldersへのWebCenter Portalメタデータの移行

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

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

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

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

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

3. 次の属性をconfig.cfgファイルに追加します。
MigrationFormatForfApplicationGUID=dCollectionName:dCollectionGUID

config.cfgファイルはWCC_DOMAIN/ucm/cs/config/config.cfgにあります。WCC_DOMAINは、Oracle WebCenter Contentドメインを指します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

11. PersonalSpaces、WebCenter Portalルート・フォルダおよびコントリビューション・フォルダにWebCenter Portalで参照されているコンテンツがある場合、これら以外のフォルダを移行します。手順10で使用したのと同じ手順に従います。
「フォルダ移行: 除外されたフォルダ」ダイアログで、移行する以外のすべてのフォルダが「移行から除外されるレガシー・フォルダ」ボックスに表示されていることを確認します。

12. Folders_gを無効にします。
「拡張コンポーネント・マネージャ」ページの「有効コンポーネント」リスト・ボックスで、Folders_gを選択し、「無効化」をクリックします。このページへのアクセスの詳細は、第9.2.3.1.2項「Folders_gコンポーネントの有効化」を参照してください。

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

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

図H-10 索引の再構築

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

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

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

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

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

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

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

コマンドの構文と例については、『WebLogic Scripting Toolコマンド・リファレンス』のmigrateFoldersGDataToFrameworkFoldersに関する項を参照してください。WLSTコマンドの実行方法の詳細は、第1.13.3.1項「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)に変更されます(図H-11を参照)。このフォルダ・パスの変更は、マッピング・ファイルに保存されます。

図H-11 移行後のFrameworkFoldersのディレクトリ構造

- マッピング・ファイルを使用し、WLSTコマンドexportFoldersGDataで生成されたMDSドキュメントで、dCollectionID値をfFolderGUID値に置き換えます。また、WebCenter Portalルート・フォルダ名またはPersonalSpacesを含む古いパス参照が新しいパスに置き換えられます。たとえば、/PersonalSpaces/weblogicが/Enterprise Libraries/weblogicに置き換えられます。
不整合があった場合は、MigrationDiagnostic.logでレポートされます。トラブルシューティング情報については、H.5項「移行に関する問題のトラブルシューティング」を参照してください。

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

H.3.2 FrameworkFoldersへのPortal Frameworkアプリケーションの移行

ここでは、Portal FrameworkアプリケーションのメタデータをFolders_gからFrameworkFoldersに移行する手順について説明します。

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

- H.3.2.1項「移行ロードマップ」

- H.3.2.2項「Portal FrameworkアプリケーションのFolders_gデータのエクスポート」

- H.3.2.3項「FrameworkFoldersへのPortal Frameworkアプリケーション・メタデータの移行」

- H.3.2.4項「移行したデータの検証」

- H.3.2.5項「Portal Frameworkアプリケーションのソース・コードの移行」

H.3.2.1 移行ロードマップ

この項のフロー・チャート(図H-12)と表(表H-3)で、Portal FrameworkアプリケーションのFolders_gからFrameworkFoldersへの移行に必要な手順について概説します。

図H-12 Portal FrameworkアプリケーションのFolders_gからFrameworkFoldersへの移行

表H-3 Portal Frameworkアプリケーション・データのFolders_gからFrameworkFoldersへの移行

タスク

説明

ドキュメント

WLSTコマンドexportFoldersGDataの実行

WLSTコマンドexportFoldersGDataをWebCenter Portal Oracleホーム・ディレクトリから実行して、移行前データをエクスポートします。

H.3.2.2項「Portal FrameworkアプリケーションのFolders_gデータのエクスポート」

Content Serverでのフォルダ移行ユーティリティの実行

Content Serverで移行ユーティリティを実行して、Portal FrameworkアプリケーションのデータをFolders_gからFrameworkFoldersに移行します。

H.3.2.3項「FrameworkFoldersへのPortal Frameworkアプリケーション・メタデータの移行」

WLSTコマンドmigrateFoldersGDataToFrameworkFoldersの実行

WLSTコマンドmigrateFoldersGDataToFrameworkFoldersをWebCenter Portal Oracleホーム・ディレクトリから実行して、移行したデータを検証します。

H.3.2.4項「移行したデータの検証」

ソース・コードの移行およびPortal Frameworkアプリケーションの再デプロイ

Portal Frameworkアプリケーションのソース・コードを移行して、アプリケーションを再デプロイします。

H.3.2.5項「Portal Frameworkアプリケーションのソース・コードの移行」

Portal Frameworkアプリケーションがデプロイされている管理対象サーバーの再起動

Portal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動します。

第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」

H.3.2.2 Portal FrameworkアプリケーションのFolders_gデータのエクスポート

WLSTコマンドexportFoldersGDataを使用して、Portal FrameworkアプリケーションのFolders_gデータをエクスポートします。コマンド構文は次のとおりです。

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

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

exportFoldersGData(appName='customapp',server='Custom_Server',connectionName='MyContentServerConnection',directoryPath='/scratch/myTemp_Dir/')

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

WLSTコマンドmigrateFoldersGDataToFrameworkFoldersでは、exportFoldersGDataによって生成されたFolders_gの移行前データを使用してデータ整合性レポートを生成し、すべてのファイルとフォルダがFrameworkFoldersに正しく移行されたことを検証します。

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

- Portal Frameworkアプリケーションの移行前メタデータを生成します

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

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

PreMigrationData.csvファイルには、Portal Frameworkアプリケーションの次のメタデータが含まれます。

- Portal Frameworkアプリケーションのフォルダ名

- dCollectionGUID。Portal FrameworkアプリケーションをContent Server上のフォルダにマップするために使用する識別子

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

- dCollectionName。Portal Frameworkアプリケーションの名前

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

- dDocAccount。アカウント名

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

図H-6に、PreMigrationData.csvファイルのサンプルを示します。各行には、Portal Frameworkアプリケーションのメタデータが表示されます。

図H-13 PreMigrationData.csvファイルのサンプル

H.3.2.3 FrameworkFoldersへのPortal Frameworkアプリケーション・メタデータの移行

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

Portal FrameworkアプリケーションのメタデータをFolders_gからFrameworkFoldersに移行するには:

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

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

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

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

4. 「管理」→「フォルダ移行」を選択します。

5. 移行プロセスから除外するフォルダを指定するには、「除外されたフォルダの変更」リンクをクリックします(図H-14)。これにより、「フォルダ移行: 除外されたフォルダ」ダイアログが表示されます。

図H-14 フォルダの移行

6. 「レガシー・フォルダの参照」ペインから、「PersonalSpaces」や「Trash」など、除外する1つ以上のフォルダを選択します。選択したフォルダは「移行から除外されるレガシー・フォルダ」ペインに移動されます(図H-15を参照)。
Portal Frameworkアプリケーションの場合、コントリビューション・フォルダやWebCenter Portalルート・フォルダなど、アプリケーションの接続先の最上位フォルダを移行する必要があります。これらのフォルダが除外リストに含まれていないことを確認します。

H-15 フォルダの移行からの除外

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

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

9. 「参照」ダイアログで「Enterprise Libraries」を選択し、「OK」をクリックします(図H-16)。

図H-16 フォルダ移行先の選択

移行のために選択したフォルダは、「Enterprise Libraries」の下にエンタープライズ・ライブラリとして移行されます。

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

11. Folders_gを無効にします。
「拡張コンポーネント・マネージャ」ページの「有効コンポーネント」リスト・ボックスで、Folders_gを選択し、「無効化」をクリックします。このページへのアクセスの詳細は、第9.2.3.1.2項「Folders_gコンポーネントの有効化」を参照してください。

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

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

図H-17 索引の再構築

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

H.3.2.4 移行したデータの検証

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

構文:

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

次の例では、Folders_gデータを/scratch/myTemp_Dirディレクトリから、管理対象サーバーCustom_Serverにデプロイされたcustomappという名前のPortal FrameworkアプリケーションのFrameworkFoldersに移行します。MyContentServerConnectionは、移行の実行に使用するContent Server接続です。

migrateFoldersGDataToFrameworkFolders(appName='customapp',server='Custom_Server',connectionName='MyContentServerConnection',directoryPath='/scratch/myTemp_Dir/')

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

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

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

- 移行したPortal Frameworkアプリケーション・コンテンツのメタデータが生成され、WLSTコマンドexportFoldersGDataで生成された移行前メタデータに対して検証されます。移行した各フォルダがエンタープライズ・ライブラリであること、およびアカウント名とセキュリティ・グループの値が移行前メタデータと同じであることが検証されます。
データの不整合があった場合は、コマンド実行後に表示されるサマリー・テキストでレポートされ、次のデフォルトの場所にあるログ・ファイルにも保存されます: WCP_ORACLE_HOME/common/wlst/POST_MIGRATION/MigrationDiagnostic.log。

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

- マッピング・ファイルを使用し、WLSTコマンドexportFoldersGDataで生成されたMDSドキュメントで、dCollectionIDの値をfFolderGUID値に置き換えます。
不整合があった場合は、MigrationDiagnostic.logでレポートされます。トラブルシューティング情報については、H.5項「移行に関する問題のトラブルシューティング」を参照してください。

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

H.3.2.5 Portal Frameworkアプリケーションのソース・コードの移行

Portal FrameworkアプリケーションをFrameworkFolders設定に移行した後、アプリケーションのソース・コードも移行して、アプリケーションを再デプロイする必要があります。

Portal Frameworkアプリケーションのソース・コードを移行するには:

1. Portal Frameworkアプリケーションのソース・コードを含むマシンで、Folders_gの移行前データをコピーします。デフォルトでは、Folders_gの移行前データはWCP_ORACLE_HOME/common/wlst/FG_FF_MIGRATIONディレクトリ・パスにエクスポートされます。

2. WCP_ORACLE_HOME/webcenter/archivesに移動します。

3. 次のコマンドを実行します。

java -jar foldersg-metadata-migration-tool.jar source AppSourceRootDirectory PreMigrationDataDirectory UCMConnectionName UCMUser UCMConnectionUrl ReportMode

ここで:

- source: 移行する必要のあるアプリケーションのソース・コードを指定する識別子。値をsourceとして指定します。

- AppSourceRootDirectory:Portal Frameworkアプリケーションのソース・コード・ディレクトリのパス。

- PreMigrationDataDirectory: Folders_gの移行前データをコピーしたディレクトリのパス。

- UCMConnectionName: Content Server接続の名前。

- UCMUser: Content Serverユーザーの名前。

- UCMConnectionUrl: idc://server:port形式のContent Server URL。

- ReportMode : この引数がtrueに設定されている場合、コマンドを実行するとレポート・ファイルが生成されます。このレポート・ファイルには、実際の移行時に行われたすべてのメタデータの変更が含まれます。引数のデフォルト値はfalseです。
注意: この引数がtrueに設定されている場合にWLSTコマンドを実行しても、実際の移行は行われません。

たとえば、次のコマンドでは、Content Server接続my-ucmを使用して、doclibCusAppという名前のPortal Frameworkアプリケーションのソース・コードを移行します。

java -jar foldersg-metadata-migration-tool.jar source /home/monty/doclibCusApp /home/monty/cusapp/PRE_MIGRATION my-ucm sysadmin

4. Portal Frameworkアプリケーションをコンパイルして再デプロイします。詳細は、第42.3項「Portal Frameworkアプリケーションの再デプロイ」を参照してください。
Portal Frameworkアプリケーションの再デプロイ後は、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

H.4 同じContent Serverに接続されているWebCenter PortalおよびPortal Frameworkアプリケーションの移行

この項のフロー・チャート(図H-18)と表(表H-4)では、WebCenter PortalおよびPortal Frameworkアプリケーション・データを、同じContent Serverに接続されているFolders_gからFrameworkFoldersに移行するのに必要な手順について概説します。

図H-18 同じContent Serverに接続されているWebCenter PortalおよびPortal Frameworkアプリケーションの移行

表H-4 同じContent Serverに接続されているWebCenter PortalおよびPortal Frameworkアプリケーションの移行

タスク

説明

ドキュメント

WebCenter Portalデータに対するWLSTコマンドexportFoldersGDataの実行

WLSTコマンドexportFoldersGDataコマンドを実行して、WebCenter Portalの移行前データをエクスポートします。

H.3.1.2項「exportFoldersGDataの実行による移行前データの生成」

各Portal Frameworkアプリケーションに対するWLSTコマンドexportFoldersGDataの実行

各Portal Frameworkアプリケーションに対してWLSTコマンドexportFoldersGDataを実行して、その移行前データをエクスポートします。

H.3.2.2項「Portal FrameworkアプリケーションのFolders_gデータのエクスポート」

FrameworkFoldersおよびFolders_gが有効化されていることを確認します。

FrameworkFoldersコンポーネントを有効化します。また、Folders_gが有効化されていることも確認します。

第9.2.3.1項「必須コンポーネントの有効化」

WebCenter Portalデータを移行した後、Portal Frameworkアプリケーション・データを移行

Content Serverで移行ユーティリティを実行してWebCenter Portalデータを移行した後、Portal Frameworkアプリケーション・データをFolders_gからFrameworkFoldersに移行します。

H.4.1項「WebCenter PortalおよびPortal Frameworkアプリケーションのメタデータの移行」

WebCenter Portalに対するWLSTコマンドmigrateFoldersGDataToFrameworkFoldersの実行

WLSTコマンドmigrateFoldersGDataToFrameworkFoldersコマンドを実行して、WebCenter Portalの移行済データを検証します。

WebCenter PortalアプリケーションのcontentDbConnectionUrlおよびcontentDbUserNameパラメータの指定は必須であることに注意してください。

H.3.1.4項「migrateFoldersGDataToFrameworkFoldersの実行による移行したデータの検証」

Portal Frameworkアプリケーションに対するWLSTコマンドmigrateFoldersGDataToFrameworkFoldersの実行

WLSTコマンドmigrateFoldersGDataToFrameworkFoldersを実行して、Portal Frameworkアプリケーションの移行済データを検証します。

Portal FrameworkアプリケーションのcontentDbConnectionUrlおよびcontentDbUserNameパラメータの指定はオプションであることに注意してください。

H.3.2.4項「移行したデータの検証」

WC_Spaces管理対象サーバーを再起動します

WC_Spaces管理対象サーバーを再起動します。

第7.3項「WebCenter Portalアプリケーションの起動および停止」

Portal Frameworkアプリケーションのソース・コードを移行して、アプリケーションを再デプロイ

Portal Frameworkアプリケーションのソース・コードを移行して、アプリケーションを再デプロイします。

H.3.2.5項「Portal Frameworkアプリケーションのソース・コードの移行」

Portal Frameworkアプリケーションがデプロイされている管理対象サーバーの再起動

Portal Frameworkアプリケーションがデプロイされている管理対象サーバーを再起動します。

第7.2項「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」

H.4.1 WebCenter PortalおよびPortal Frameworkアプリケーションのメタデータの移行

同じContent Serverに接続されている場合に、WebCenter PortalおよびPortal FrameworkアプリケーションのメタデータをFolders_gからFrameworkFoldersに移行するには:

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

2. 次の属性をconfig.cfgファイルに追加します: MigrationFormatForfApplicationGUID=dCollectionName:dCollectionGUID
config.cfgファイルはWCC_DOMAIN/ucm/cs/config/config.cfgにあります。WCC_DOMAINは、Oracle WebCenter Contentドメインを指します。

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

4. 「管理」→「フォルダ移行」を選択します。

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

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

2. 「フォルダ移行: 除外されたフォルダ」ダイアログで、移行から除外すべきフォルダを指定します。PersonalSpacesルート・フォルダ以外のすべてのフォルダが「移行から除外されるレガシー・フォルダ」ペインに表示されていることを確認します(図H-19)。

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

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

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

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

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

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

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

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

7. 手順2で追加したMigrationFormatForfApplicationGUID属性をconfig.cfgから削除します。

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

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

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

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

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

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

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

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

図H-21 フォルダ移行先の選択

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

10. PersonalSpaces、WebCenter Portalルート・フォルダおよびコントリビューション・フォルダにWebCenter PortalまたはPortal Frameworkアプリケーションで参照されているコンテンツがある場合、これら以外のフォルダを移行します。これらのフォルダはエンタープライズ・ライブラリとして移行する必要があります。手順9で使用したのと同じ手順に従います。
「フォルダ移行: 除外されたフォルダ」ダイアログで、移行する以外のすべてのフォルダが「移行から除外されるレガシー・フォルダ」ボックスに表示されていることを確認します。

11. Folders_gを無効にします。
「拡張コンポーネント・マネージャ」ページの「有効コンポーネント」リスト・ボックスで、Folders_gを選択し、「無効化」をクリックします。このページへのアクセスの詳細は、第9.2.3.1.2項「Folders_gコンポーネントの有効化」を参照してください。

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

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

図H-22 索引の再構築

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

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

この項では、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接続に設定しなおして、移行を続行します。

問題

Folders_gからFrameworkFoldersフォルダ・サービスへの移行後、Portal Frameworkアプリケーションのナビゲーション・リンクが表示されません。WC_CustomPortal管理対象サーバーにデプロイされているPortal Frameworkアプリケーションの移行後、移行ログで次の例外がレポートされます。

oracle.webcenter.content.integration.spi.ucm.UCMBridge setTrashStatus[[SEVERE: Unable to retrieve trash status for repository UCM.  When calling service COLLECTION_GET_ADMIN_MARKED_CONFIG, as user sysadmin, at timestamp7/28/14 3:21 AM, recieved status code -32.

解決策

Oracle WebCenter Portal環境にWC_Spaces管理対象サーバーおよびWC_CustomPortal管理対象サーバーの両方が構成されている場合、Portal Frameworkアプリケーションを移行する前に、WEBCENTERスキーマを確認してください。WC_PORTAL_PROPERTIES表で、WCPP_VALUE行に値FOLDERS_Gが含まれる場合、行を削除する必要があります。

問題

WebCenter PortalおよびPortal Frameworkアプリケーションの両方が同じContent Serverに接続されており、Portal Frameworkアプリケーションのドキュメント・タスク・フローでstartFolderPathが/PersonalSpacesとして指定されています。Portal FrameworkアプリケーションをFolders_gフォルダ・サービスからFrameworkFoldersフォルダ・サービスに移行した後、コンテンツがドキュメント・タスク・フローに表示されません。たとえば、startFolderPath = /PersonalSpaces/Karenの場合、Portal Frameworkアプリケーションのドキュメント・タスク・フローのコンテンツが表示されません。

解決策

startFolderPath属性を更新し、/PersonalSpacesを/Enterprise Librariesに置き換えます。これを、アプリケーションのソース・コードと、アプリケーションがデプロイされている管理対象サーバーの両方で更新する必要があります。

Portal Frameworkアプリケーションのソース・コードで、次の操作を行います。

1. /PersonalSpacesの.xmlファイルを探して、/Enterprise Librariesに置き換えます。
たとえば、startFolderPathの値が/PersonalSpaces/Karenに設定されている場合、/Enterprise Libraries/Karenに変更します。

2. 第42.3項「Portal Frameworkアプリケーションの再デプロイ」に説明されているとおりに、Portal Frameworkアプリケーションをコンパイルして再デプロイします。

Portal Frameworkアプリケーションがデプロイされている管理対象サーバーで、次の操作を行います。

1. WLSTコマンドexportMetadataを使用してPortal Frameworkアプリケーションの.xmlファイルをエクスポートして、ファイルをバックアップします。exportMetadataの詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のexportMetadataに関する項を参照してください。

2. エクスポートされた.xmlファイルで、/PersonalSpacesを探して/Enterprise Librariesに置き換えます。
たとえば、startFolderPathの値が/PersonalSpaces/Karenの場合、/Enterprise Libraries/Karenに変更します。

3. WLSTコマンドimportMetadataを使用して.xmlファイルをインポートします。importMetadataの詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のimportMetadataに関する項を参照してください。

問題

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

解決策

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

FrameworkFoldersサービスの詳細は、Oracle WebCenter Contentサービス・リファレンスの「フォルダ・サービス」を参照してください。

表H-5 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

I WebCenter PortalへのPortal Frameworkアプリケーションの移行

この付録では、Portal FrameworkアプリケーションをポータルとしてWebCenter Portalに移行する方法について説明します。

この付録の内容は次のとおりです。

- WebCenter PortalへのPortal Frameworkアプリケーションの移行について

- 移行ロードマップ

- Portal Frameworkアプリケーション移行の詳細

- Portal Frameworkアプリケーション移行の問題のトラブルシューティング

I.1 WebCenter PortalへのPortal Frameworkアプリケーションの移行について

Oracle WebCenter Portalは、JDeveloperでPortal Frameworkアプリケーションを作成およびデプロイするためのPortal Frameworkテクノロジをサポートしています。Portal Frameworkテクノロジは引き続き製品内で使用でき、11g R1製品ラインでも完全にサポートされていますが、Oracle WebCenter Portalリリース11.1.1.7.0以降メンテナンス・モードにあります。これは、OracleがPortal Frameworkアプリケーションへの新規機能の追加を停止したことを意味します。たとえば、リリース11.1.1.8.0でWebCenter Portalアプリケーション(すぐに利用できる、エンタープライズ対応のカスタマイズ可能なアプリケーション)に追加されたポータル・ビルダーおよびモバイルWebサポートのような機能は、Portal Frameworkアプリケーションでは使用できません。

WebCenter Portal FrameworkテクノロジはOracle WebCenter Portal 12c R2リリースでは使用できなくなります。Portal Frameworkアプリケーションを実行しており、新規機能の利点を活用する場合はPortal FrameworkアプリケーションをポータルとしてWebCenter Portalに移行することを検討するようお薦めします。

次の条件は、WebCenter PortalへのPortal Frameworkアプリケーションの移行に関連しています:

- Portal FrameworkアプリケーションがポータルとしてWebCenter Portalアプリケーションに移行されます。

- リリース11.1.1.6.0、11.1.1.7.0、11.1.1.8.xおよび11.1.1.9.xからのPortal FrameworkアプリケーションのみがWebCenter Portal 11.1.1.9.0の最新リリースに移行できます。

- WebCenter Portal管理対象サーバー(ポータル・サーバーとも呼ばれます)に移行できるPortal Frameworkアプリケーションは1つのみです。このサーバーがWebCenter Portalアプリケーションをホストします。複数のPortal Frameworkアプリケーションを同じポータル・サーバーに移行することはできません。さらに、Portal Frameworkアプリケーションは単一ポータルとしてのみ移行できます。複数のポータルとしてポータル・サーバーに移行することはできません。

- 移行できるPortal Frameworkアプリケーションが複数ある場合、各アプリケーションを異なるポータル・サーバーに対するポータルとして移動します。その後、様々なポータルをインポートしてそのすべてを単一のポータル・サーバーに集めることができます。接続名を確実に同じに維持します。これは、エクスポートおよびインポートのライフサイクル操作にとっての必要条件のためです。

- Portal Frameworkアプリケーションをデプロイするポータル・サーバーおよびサーバーは同じドメインにある必要があります。

- Portal Frameworkアプリケーションを移行するポータル・サーバーには何もデータが含まれていない必要があります。つまり、既存のポータル、アクティビティなどが何もない新規インストールのような形式である必要があります。

I.2 移行ロードマップ

図I-1および表I-1に、Portal FrameworkアプリケーションをWebCenter Portalに移行するために必要なステップの概要を示します。

図I-1 WebCenter PortalへのPortal Frameworkアプリケーションの移行

表I-1 WebCenter PortalへのPortal Frameworkアプリケーションの移行

タスク

説明

ドキュメントのリンク

使用中の既存のOracle WebCenter Portal環境のクローニング

Oracle WebCenter Portalの新規環境を既存の環境に基づいて作成します。Portal Frameworkアプリケーションを、クローニングされたインスタンスを使用して移行することになります。

注意: 実行中の本番環境にあるPortal Frameworkアプリケーションを移行しようとしないでください。常に、本番環境とは別の環境で移行を実行してください。

管理者ガイドのターゲット環境へのOracle WebCenter Portalの移動に関する項を参照してください。

既存の11.1.1.6.0、11.1.1.7.0または11.1.1.8.xインストールに11.1.1.9.0へのパッチを適用

既存のOracle WebCenter Portal 11.1.1.6.0、11.1.1.7.0または11.1.1.8.xインストールに11.1.1.9.0へのパッチを適用します。

すでにWebCenter Portalリリース11.1.1.9.xにいる場合、このステップをスキップして最新のバンドル・パッチを適用します。

注意: 環境にパッチを適用中は、パッチ適用ガイドでWebCenter Portalに対してリストされているパッチ適用後のタスクの実行は不要です。パッチ適用後のタスクはWebCenter Portalアプリケーションに対してのみ適用可能で、Portal Frameworkアプリケーションには適用できません。

パッチ適用ガイドの次のリンクを参照してください:

- Oracle WebCenter Portal 11.1.1.8.xインストールにパッチを適用するには、Oracle WebCenter Portal 11.1.1.8.xインストールへのパッチ適用に関する項を参照してください。

- Oracle WebCenter Portal 11.1.1.7.0インストールにパッチを適用するには、Oracle WebCenter Portal 11.1.1.7.0インストールへのパッチ適用に関する項を参照してください。

- Oracle WebCenter Portal 11.1.1.6.0インストールにパッチを適用するには、Oracle WebCenter Portal 11.1.1.6.0インストールへのパッチ適用に関する項を参照してください。

最新のWebCenter Portalバンドル・パッチの適用

最新のWebCenter Portalバンドル・パッチを適用します。

パッチをMy Oracle Support(http://support.oracle.com)からダウンロードします。

パッチで使用できるREAD MEファイルに従います。

ドメインを拡張してWebCenter Portal管理対象サーバーをインストール

既存のOracle WebCenter Portalドメインを拡張してWebCenter Portal管理対象サーバー(WC_Spaces)(ポータル・サーバーとも呼ばれます)をインストールします。

注意: ターゲット・ポータル・サーバーがすでに存在する場合、新規インスタンスのように何もデータが含まれていないことを確認してください。

注意: Portal Frameworkアプリケーションがデプロイされるポータル・サーバーおよびサーバーが同じドメインにあることを確認してください。

詳細は『Oracle WebCenter Portalインストレーション・ガイド』のOracle WebCenter Portal製品をインストールするドメインの拡張に関する項を参照してください。

デフォルト以外の場所に格納されたページのMDSへのインポート

ページが/oracle/webcenter/portalapp以外のパスに格納されている場合、

移行対象として考慮されるようにメタデータ・ストア(MDS)にパッケージ化します。

第I.2.1項「デフォルト以外の場所からMDSへのページのインポート」

ポータルの作成

WebCenter Portalにログオンしてポータルを作成します。

十分に考慮した後、ポータル名を選択します。これは、現在のPortal Frameworkアプリケーションが移動されるターゲット・ポータルであるためです。

『Oracle WebCenter Portalでのポータルの構築』の新しいポータルの作成と構築に関する項を参照してください。

接続を移行するためのmigrateFrameworkApplicationConnectionsの実行

Portal Frameworkアプリケーションで構成された接続を移行するためにmigrateFrameworkApplicationConnections WLSTコマンドを実行します。このコマンドは再実行可能です。

第I.2.2項「接続を移行するためのmigrateFrameworkApplicationConnectionsの実行」

Portal Frameworkアプリケーションを移行するためのmigrateFrameworkApplicationToWebCenterの実行

Portal Frameworkアプリケーションを移行するためにmigrateFrameworkApplicationToWebCenter WLSTコマンドを実行します。

このコマンドは再実行可能です。

第I.3項「Portal Frameworkアプリケーション移行の詳細」を読み、Portal FrameworkからWebCenter Portalへの移行時にページ、アセット、リストなどのアーティファクトの移行をバックグラウンドで処理する方法を理解してからこのコマンドを実行することもできます。

第I.2.3項「Portal Frameworkアプリケーションを移行するためのmigrateFrameworkApplicationToWebCenterの実行」

すべてのサーバーの再起動

ノード・マネージャおよびすべてのサーバーを再起動します。

『Oracle WebCenter Portalインストレーション・ガイド』のサーバーの起動に関する項を参照してください。

カスタム・タスク・フローの移行

カスタム・タスク・フローをWebCenter Portalの共有ライブラリとしてデプロイします。

第I.2.4項「カスタム・タスク・フローの移行」

静的リソースの移行

イメージ、スタイル・シートおよびJavaScriptコードなどの静的リソースをWebCenter Portalの共有ライブラリとしてデプロイすることにより移行します。

第I.2.5項「静的リソースの移行」

SQLデータ・コントロールの移行

SQLデータ・コントロールにより使用されるデータ・ソースをWebCenter Portal管理対象サーバー、WC_Spacesにデプロイします。また、移行されたSQLデータ・コントロールのデータ・ソースおよびパスワードを更新します。

第I.2.6項「SQLデータ・コントロールの移行」

ドキュメントの移行

オプションですが、お薦めします。

Portal Frameworkアプリケーション・ドキュメントを、Content Serverのターゲット・ポータル用にプロビジョニングされたフォルダに移動します。次にmigrateFrameworkApplicationDocumentsToWebCenterを実行してすべての古いパス参照を新しいパスで更新します。このコマンドは再実行可能です。

第I.2.7項「ドキュメントの移行」

お知らせおよびディスカッションの移行

オプションですが、お薦めします。

お知らせおよびディスカッションのトピックを、Portal Frameworkアプリケーションが使用するフォーラムおよびカテゴリからターゲット・ポータル用にプロビジョニングされたフォーラムまたはカテゴリに移動します。次にmigrateFrameworkApplicationDiscussionsToWebCenterを実行してページ定義ファイルのフォーラム参照を更新します。このコマンドは再実行可能です。

第I.2.8項「お知らせおよびディスカッションの移行」

I.2.1 デフォルト以外の場所からMDSへのページのインポート

Portal Frameworkアプリケーションでは、設計時に作成されたページはデフォルトでパスoracle/webcenter/portappに格納されます。ページを他の場所に格納することを選択できます。ただし、移行中はデフォルトの場所に格納されたページのみが移行対象として考慮されます。デフォルト以外の場所に格納されたページも確実に移行されるようにするには、該当するページをメタデータ・ストア(MDS)にインポートする必要があります。

デフォルト以外の場所からMDSにページをインポートする手順:

1. Portal Frameworkアプリケーションを開きます。

2. デフォルト以外の場所に格納されているページとそれらに対応するページ定義ファイルを探し、それらを一時的な場所に置きます。
たとえば、ページがcom/hr/pagesの下にあるものとします。次のサンプルの.jspxファイルと対応するページ定義ファイルを作業領域またはWARから探します:

- /com/hr/pages/Training.jspx

- /com/hr/pages/TrainingPageDef.xml

- /com/hr/pages/Employees.jspx

- /com/hr/pages/EmployeesPageDef.xml

これらのファイルを/tmp/mdsなどの一時ディレクトリに移動します。

WARでは、PageDef.xmlはWEB-INF/classesの下にある場合があります。作業領域に指定されたPageDefパスのみをコピーします。この例では、/com/hr/pagesからコピーする必要があります。

3. 次のように、Oracleホーム・ディレクトリに移動してWLSTスクリプトを起動します。

- (UNIX) ORACLE_HOME/common/bin/wlst.sh

- (Windows) ORACLE_HOME\common\bin\wlst.cmd

4. WLSTコマンド・プロンプトで、次のコマンドを入力してOracle WebCenter Portalの管理サーバーに接続します。

wls:/offline>connect('user_name','password', 'protocol(optional):host_name:port_number')

例:

connect(username='weblogic', password='mypassword', url='myhost.example.com:7001')

このコマンドのヘルプについては、WLSTコマンド・プロンプトでhelp('connect')と入力してください。WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

5. importMetadata WLSTコマンドを実行してアプリケーションのメタデータをMDSにインポートします。

importMetadata(application, server, fromLocation,  [docs, restrictCustTo, excludeAllCust, excludeBaseDocs, excludeExtendedMetadata, excludeUnmodifiedDocs, cancelOnException, applicationVersion, remote, tenantName])

コマンド構文の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のimportMetadataに関する項を参照してください。

たとえば、次のコマンドを実行すると、一時ディレクトリ/tmp/mdsに格納されたすべてのページとページ定義がMDSリポジトリにコピーされます。

importMetadata(appName='webcenter', server='WC_Spaces', fromLocation='/tmp/mds', docs='/**')

後からmigrateFrameworkApplication WLSTコマンドを実行してPortal Frameworkアプリケーションを移行する場合は、必ずpagePath引数を/com/hr/pagesに設定し、これらのページが移行対象として考慮されるようにします。

I.2.2 接続を移行するためのmigrateFrameworkApplicationConnectionsの実行

Portal Frameworkアプリケーションを移行する前に、ポータル・サーバーへのすべての接続をmigrateFrameworkApplicationConnections WLSTコマンドを使用して移行します。

ポータル・サーバーにPortal Frameworkアプリケーションの接続を移行する手順:

1. 次のように、Oracleホーム・ディレクトリに移動してWLSTスクリプトを起動します。

- (UNIX) ORACLE_HOME/common/bin/wlst.sh

- (Windows) ORACLE_HOME\common\bin\wlst.cmd

2. WLSTコマンド・プロンプトで、次のコマンドを入力してOracle WebCenter Portalの管理サーバーに接続します。

wls:/offline>connect('user_name','password', 'protocol(optional):host_name:port_number')

例:

connect(username='weblogic', password='mypassword', url='myhost.example.com:7001')

このコマンドのヘルプについては、WLSTコマンド・プロンプトでhelp('connect')と入力してください。WLSTコマンドの実行方法の詳細は、第1.13.3.1項「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

3. listJCRContentServerConnections WLSTコマンドを実行して、WebCenter Portalのデフォルト接続として設定されるPortal FrameworkアプリケーションのContent Server接続の名前を取得し、Content Serverリポジトリ管理者の名前を取得します。コマンドから返される出力の次の値を書き留めます。

- 接続名: 次の手順でmigrateFrameworkApplicationConnections WLSTコマンドを実行中に接続名をprimaryConnectionNameパラメータの値として渡す必要があります。

- 管理ユーザー名: 次の手順でmigrateFrameworkApplicationConnections WLSTコマンドを実行中に管理者名をadminUserNameパラメータの値として渡す必要があります。管理ユーザー名の値が返されない場合は、sysadminをadminUserNameの値として使用します。

コマンド構文の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のlistJCRContentServerConnectionsに関する項を参照してください。

4. migrateFrameworkApplicationConnections WLSTコマンドを実行します:

migrateFrameworkApplicationConnections(appName, fwkAppName, server, fwkAppServer, migrationDirectory, [spacesRoot, securityGroup, primaryConnectionName, adminUserName, applicationVersion])

コマンド構文の詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のmigrateFrameworkApplicationConnectionsに関する項を参照してください。

次の例では、WC_CustomPortalにデプロイされたPortal FrameworkアプリケーションHRApplicationからWC_SpacesにデプロイされたWebCenter Portalアプリケーションに接続が移行されます。接続が移行された後、ucm-conn (Portal FrameworkアプリケーションのContent Server接続の名前)がWebCenter PortalのデフォルトのContent Server接続として設定されます。移行ログがフォルダ/scratch/migrateの下に格納されます。

wls:/weblogic/serverConfig>migrateFrameworkApplicationConnections(appName='webcenter',fwkAppName='HRApplication',server='WC_Spaces',fwkAppServer='WC_CustomPortal',migrationDirectory='/scratch/migrate',spacesRoot='/WebCenter',securityGroup='webcenter',primaryConnectionName='ucm-conn',adminUserName='weblogic')

注意:
ノード・マネージャが構成されている場合、WC_Spaces管理対象サーバーがmigrateFrameworkApplicationConnections WLSTコマンドの実行後に自動的に再起動されます。ノード・マネージャが設定されていない場合、WC_Spacesを手動で再起動します。

5. Portal Frameworkアプリケーションからのすべての接続がポータル・サーバー上に存在することを検証します。たとえばPortal FrameworkアプリケーションにContent Server接続が含まれている場合、listJCRContentServerConnections WLSTコマンドを使用してポータル・サーバーにも接続が存在することを検証します。WLSTコマンドの詳細は、『WebLogic Scripting Toolコマンド・リファレンス』のWebCenter PortalのカスタムWLSTコマンドに関する項を参照してください。

6. すべての接続を見直して、デフォルトの接続がWebCenter Portalに対して正しくマークされていることを確認します。
Portal Frameworkアプリケーションの接続を移行する際、接続構成がポータル・サーバー上のターゲット・ポータルに継承されます。通常は、デフォルトの接続はポータル・サーバー上に保持されます。あるタイプの接続が1つのみ移行されている場合、それがデフォルトの接続として指定されているといないとに関係なく、移行後にポータル・サーバー上にデフォルトの接続として保持されます。たとえば、アプリケーションに単一のディスカッション・サーバー接続が含まれ、デフォルトの接続としてマークされていない場合、移行後にこの接続がポータル・サーバー上にデフォルトの接続として設定されます。あるタイプの複数の接続が移行され、デフォルトの接続として何も設定されていない場合、そのタイプの接続で移行後にポータル・サーバー上にデフォルトの接続としてマークされるものはありません。たとえば、アプリケーションに2つのディスカッション・サーバー接続が含まれ、どちらもデフォルトの接続としてマークされていない場合、移行後にデフォルトとしてマークされるディスカッション・サーバー接続はありません。ポータル・サーバー上では、使用可能なサービスのデフォルトとして1つマークする必要があります。したがって、必要であればデフォルトの接続を手動で設定する必要があります。migrateFrameworkApplicationConnectionsの実行中に、primaryConnectionNameパラメータを使用してデフォルトのContent Server接続を指定できます。

I.2.2.1 migrateFrameworkApplicationConnectionsにより生成される出力

migrateFrameworkApplicationConnections WLSTコマンドを実行すると、FwkAppConnectionMigrationDiagnostic.logファイルがmigrationDirectoryパラメータに指定されたディレクトリの下のlogsディレクトリ内に生成されます。FwkAppConnectionMigrationDiagnostic.logには、Portal Frameworkアプリケーションの移行前後のWebCenter Portalのデフォルトの接続の詳細が含まれます。

FwkAppConnectionMigrationDiagnostic.logファイルの出力例を次に示します:

------------------------------------------------
Default connections in webcenter portal prior to migration
------------------------------------------------
Discussion Forum connection:Default Connection not specified.
IMP connection:Default Connection not specified.
Mail connection:Default Connection not specified.
JCR Content Server connection:WebCenterSpaces-ucm
SES connection:
Personal Event connection:Default Connection not specified.

Setting default connection in webcenter portal
----------------------------
Setting default discussion forum connection: collab-conn
IMP connection: Either no connection exists or multiple connections exist, hence not setting default connection.
Mail connection: Either no connection exists or multiple connections exist, hence not setting default connection.
SES connection: Either no connection exists or multiple connections exist, hence not setting default connection.
Personal Event connection: Either no connection exists or multiple connections exist, hence not setting default connection.
Setting default JCR Content Server connection: UCM
Parameters specified are: spacesRoot=/webcenter, securityGroup=webcenter

------------------------------------------------
Default connections in webcenter portal after the migration
------------------------------------------------
Discussion Forum connection:collab-conn
IMP connection:Default Connection not specified.
Mail connection:Default Connection not specified.
JCR Content Server connection:UCM
SES connection:
Personal Event connection:Default Connection not specified.

migrateFrameworkApplicationConnections WLSTコマンドでは、さらに内部的に使用される2つのファイルconnections.propertiesおよびmigrate_connections.logが生成されます。connections.propertiesファイルにはPortal Frameworkアプリケーションからエクスポートされる接続の詳細が含まれ、migrate_connections.logファイルにはWebCenter Portalの接続インポート操作のログが含まれます。

I.2.3 migrateFrameworkApplicationToWebCenterを実行したPortal Frameworkアプリケーションの移行

接続の移行後に、Portal FrameworkアプリケーションをmigrateFrameworkApplicationToWebCenter WLSTコマンドを使用してWebCenter Portalに移行します:

migrateFrameworkApplicationToWebCenter(appName, fwkAppName, server, fwkAppServer,adminUrl, adminUser, targetPortal, migrationDirectory, [pagePath, navigationFile, properties, applicationVersion])

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

次の例では、WC_Spaces管理対象サーバーにデプロイされたWebCenter PortalアプリケーションのポータルFinancePortalにPortal FrameworkアプリケーションFinanceApplicationが移行されます。移行中、FinancePortalのナビゲーションを構築するためにナビゲーション・ファイルcustom-navigation-model.xmlが使用されます。移行ログがフォルダ/scratch/migrateの下に格納されます。

wls:/weblogic/serverConfig>migrateFrameworkApplicationToWebCenter(appName='webcenter',fwkAppName='FinanceApplication',server='WC_Spaces',fwkAppServer='WC_CustomPortal',adminUrl='t3://wcphost.example.com:adminport',adminUser='weblogic',targetPortal='FinancePortal',migrationDirectory='/scratch/migrate',navigationFile='/oracle/webcenter/portalapp/navigations/custom-navigation-model.xml')

migrateFrameworkApplicationToWebCenter WLSTコマンドは再実行可能です。それ以降の各実行に次が適用されます:

- 以前に失敗したまたは移行されなかったアーティファクトの移行が試行されます。

- 各実行の結果はログ・ファイルに追加されます。

- 同じターゲット・ポータル名を、以前のコマンドの実行で指定したtargetPortalパラメータに指定する必要があります。

- 同じ移行ディレクトリを、以前のコマンドの実行で使用したmigrationDirectoryパラメータに指定する必要があります。

migrateFrameworkApplicationToWebCenterを実行中の静的リソース用パスの更新

Portal FrameworkアプリケーションにCSS、静的イメージおよびJavaScriptなどの静的リソースが含まれている場合、migrateFrameworkApplicationToWebCenter WLSTコマンドを実行してもポータル・サーバーに移行されません。アプリケーションの移行後に静的リソースをポータル・サーバー上に共有ライブラリとして手動でデプロイする必要があります。これで通常は、Portal Frameworkアプリケーションで使用されたものと同じパスが保持されます。ただし、リソースがすでに異なるパス経由でポータル・サーバーでアクセス可能な場合、または異なるパスへのリソースの移動を選択した場合、移行中に更新される新旧のリソース・パスのマッピングを提供できます。このためには、migrateFrameworkApplicationToWebCenterを実行する前にmigratedResources.propertiesという名前のファイルを作成し、アプリケーションで使用された静的リソースの既存の場所と新規の場所のマッピングのリストを追加します。たとえば、次のエントリはswooshy.pngのすべての発生に対する既存のパスを新規パス/adf/webcenter/swooshy.pngで置き換える必要があることを指定します。

/image/swooshy.png=/adf/webcenter/swooshy.png

注意:
migratedResources.propertiesに指定したパスが正しいことを確認します。migrateFrameworkApplicationToWebCenter WLSTコマンドでパスは検証されません。不正なパスはPortal Frameworkアプリケーションの移行を壊す可能性があります。

migratedResources.propertiesファイルをmigrateFrameworkApplicationToWebCenter WLSTコマンドの migrationDirectory引数に指定された場所にあるresourcesフォルダの下に置く必要があります。たとえば、migrationDirectoryが/tmp/migrateであるとします。migratedResources.propertiesを/tmp/migrate/resourcesの下に置く必要があります。コマンドを実行するとmigratedResources.propertiesが読み込まれ、静的リソースに対する適切なパス変更がポータル・サーバー上で実行されます。

I.2.3.1 migrateFrameworkApplicationToWebCenterにより生成される出力

migrateFrameworkApplicationToWebCenter WLSTコマンドを実行すると、次のディレクトリおよびアーティファクトがmigrationDirectoryパラメータに指定されたディレクトリの下に生成されます:

- assets: Portal Frameworkアプリケーションで使用されたアセットのエクスポートおよびインポート・アーカイブを格納します。また、アセットの新旧パスのマッピングを含むmigratedAssets.propertiesファイルも含まれます。アセットの詳細は、第I.3.2項「アセット」を参照してください。

- logs: 次のログ・ファイルが含まれます:

- 正常に移行されたアーティファクトの数および移行に失敗した数などの高度なレベルの移行詳細を含むFwkAppMigrationReport.log。

- 移行プロセスに関する詳細情報を含むFwkAppMigrationDiagnostic.log。たとえば、様々なアセットを移行するために起動されたハンドラの詳細、ソース・アプリケーション内のページとターゲット・ポータルのマッピング、および特定のページが移行できなかった場合はその詳細な理由が含まれます。

- mds-cust: Portal Frameworkアプリケーションのカスタマイズ・ドキュメントが含まれます。

- mds-export: Portal FrameworkアプリケーションからエクスポートされたMDSドキュメントが含まれます。

- mds-import: WebCenter PortalにインポートするMDSドキュメントが含まれます。

- pages: Portal Frameworkアプリケーションからターゲット・ポータルに移行されたページのマッピングを含むmigratedPages.propertiesファイルが含まれます。また、ポータル・セキュリティをオーバーライドする移行されたページのリストを含むmigratedPagesWithOverridePolicy.propertiesファイルも含まれます。これらのファイルおよびページ移行の詳細は、第I.3.1項「ページ」を参照してください。

- portal-data: 移行後のポータル・サーバーのMDSドキュメントが含まれます。これは、移行パス、ドキュメント・パスおよびディスカッションIDなどの任意のパスを修正するために使用されます。

- portlet: WebCenter PortalにインポートするポートレットのMDSドキュメントが含まれます。

静的リソース移行用のmigratedResources.propertiesファイルを格納するためにこのフォルダを作成した場合は、migrationDirectoryパラメータに指定したディレクトリにもresourcesフォルダが含まれる場合があります。

I.2.4 カスタム・タスク・フローの移行

Portal Frameworkアプリケーションにカスタム・タスク・フローが含まれていた場合は、アプリケーションの移行後にカスタム・タスク・フローをWebCenter Portalに移行する必要があります。カスタム・タスク・フローの移行には次のタスクのすべてが関連しています:

- 第I.2.4.1項「ADFライブラリのJARファイルとしてのカスタム・タスク・フローのデプロイ」

- 第I.2.4.2項「共有ライブラリのWARファイルとしてのタスク・フローJARのパッケージ化およびデプロイ」

- 第I.2.4.3項「WebCenter Portal Serverの拡張機能を使用した共有ライブラリのWARのアクセス"

I.2.4.1 ADFライブラリのJARファイルとしてのカスタム・タスク・フローのデプロイ

Portal Frameworkアプリケーションで使用されたカスタム・タスク・フローはJARファイルとしてパッケージ化する必要があり、これが次にWARファイルとしてパッケージ化されて共有ライブラリとしてポータル・サーバーにデプロイされます。

Portal Frameworkアプリケーションで使用されたカスタム・タスク・フローは、別個のFusion Webアプリケーション(ADF)アプリケーションとして開発されたかPortal Frameworkアプリケーション内に追加されたかのいずれかである必要があります。

Portal Frameworkアプリケーション内で開発されたカスタム・タスク・フローをADFライブラリのJARファイルとしてデプロイする手順:

注意:
別個のFusion Webアプリケーション(ADF)アプリケーションとして開発されたカスタム・タスク・フローをデプロイする手順は、Portal Frameworkアプリケーション内で開発されたカスタム・タスク・フローをデプロイするための手順と同じです。Portalプロジェクトのかわりに、ViewControllerプロジェクト上で手順を実行する必要があります。JARはViewController/deployの場所に書き込まれます。

1. JDeveloper 11.1.1.9.0で、カスタム・タスク・フローを含むPortal Frameworkアプリケーションを開きます。

2. 既存のWARデプロイメント・プロファイルを削除します:

1. アプリケーション・ナビゲータで、Portalプロジェクトを右クリックして「プロジェクト・プロパティ」を選択します。

2. 「プロジェクト・プロパティ」ダイアログで、「デプロイ」をクリックします。

3. Portal WAR Fileデプロイメント・プロファイルを選択し、「削除」をクリックしてから「OK」をクリックします。

3. Portalプロジェクト用の新しいADFライブラリのJARファイル・デプロイメント・プロファイルを作成します:

1. Portalプロジェクトを右クリックし、「新規」を選択します。

2. 「新規ギャラリ」で、「一般」を開き、「デプロイメント・プロファイル」、「ADFライブラリのJARファイル」の順に選択して「OK」をクリックします。

3. 「デプロイメント・プロファイルの作成」ダイアログで、「デプロイメント・プロファイル名」フィールドにデプロイメント・プロファイルの名前を指定して「OK」をクリックします。

4. ADFライブラリのJARファイル・デプロイメント・プロファイルのプロパティの編集ダイアログで、リスト表示された依存性をすべて削除して「OK」をクリックします。

5. 「プロジェクト・プロパティ」ダイアログで、「OK」をクリックします。

4. PortalプロジェクトをADFライブラリのJARファイルにデプロイします:

1. Portalプロジェクトを右クリックし、「デプロイ」を選択してから前の手順で作成したデプロイメント・プロファイルを選択します。

2. 「デプロイ」ダイアログで、「ADFライブラリのJARファイルへのデプロイ」を選択してプロジェクトをADFライブラリのJARファイルとしてデプロイするように指定します。

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

4. 「完了」をクリックします。
JARはPortal/deployの場所に書き込まれます。

I.2.4.2 共有ライブラリのWARファイルとしてのタスク・フローJARのパッケージ化およびデプロイ

カスタム・タスク・フローのJARファイル用に共有ライブラリのWARファイルを作成する手順:

1. Oracle JDeveloperで、Fusion Web Application (ADF)テンプレートを使用してADF Fusionアプリケーションを作成します。

2. アプリケーションで、新規プロジェクトを作成します。

1. 「アプリケーション」メニューから、「新規プロジェクト」を選択します。

2. 「プロジェクト」の下で「汎用プロジェクト」が選択されていることを確認します。

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

4. プロジェクト名およびその他の詳細を指定してから「終了」をクリックします。

3. 新規作成したプロジェクト用のWARデプロイメント・プロファイルを作成します:

1. アプリケーション・ナビゲータで、新規作成したプロジェクトを右クリックし、「新規」を選択します。

2. 「新規ギャラリ」ダイアログで、「一般」を開き、「デプロイメント・プロファイル」、「WARファイル」の順に選択して、「OK」をクリックします。

3. 「デプロイメント・プロファイルの作成 - WARファイル」ダイアログで、デプロイメント・プロファイルの名前を入力し、「OK」をクリックします。

4. 「WARデプロイメント・プロファイルのプロパティの編集」ダイアログで、「Java EE Webコンテキスト・ルートを指定」を選択してコンテキスト・ルートを入力し、「OK」をクリックします。

5. 「プロジェクト・プロパティ」ダイアログの「デプロイメント・プロファイル」で、作成したWARファイルを選択し、「OK」をクリックします。

4. タスク・フローのJARファイルをWARデプロイメント・プロファイルに追加します:

1. プロジェクトを右クリックして、「プロジェクト・プロパティ」を選択します。

2. 「ライブラリとクラスパス」の下で、「JAR/ディレクトリの追加」をクリックします。

3. 「アーカイブまたはディレクトリの追加」ダイアログで、Portalプロジェクトに対して作成したADFライブラリのJARファイルを参照します。

5. プロジェクトのweb.xmlファイルに移動し、次のエントリ以外のすべてのエントリを削除します。

<?xml version = '1.0' encoding = 'UTF-8'?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
version="2.5" xmlns="http://java.sun.com/xml/ns/javaee">
</web-app>

web.xmlは、アプリケーション・ナビゲータでプロジェクトのWeb Content/WEB-INFフォルダの下にあります。

I.2.4.3 Portal Serverの拡張機能を使用した共有ライブラリのWARのアクセス

WebCenter Portalには、「WebCenter Portalサーバー拡張機能」というJDeveloperテンプレートが用意されており、このテンプレートを使用すると、WebCenter Portalで使用するカスタム共有ライブラリをデプロイできます。

WebCenter Portalの共有ライブラリのWARファイルとしてカスタム・タスク・フローにアクセスする手順:

1. JDeveloperで「WebCenter Portalサーバー拡張機能」ワークスペースを作成します。詳細は、『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』の「WebCenter Portalサーバー拡張機能」ワークスペースの作成に関する項を参照してください。

2. デプロイメント・ディスクリプタweblogic.xmlがPortalSharedLibrary\Web Content\WEB-INFの下にない場合は、次の手順でデプロイメント・ディスクリプタを作成します。詳細は、『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』のWebCenter Portalへの追加共有ライブラリの登録に関する項を参照してください。

3. WebCenter Portal共有ライブラリに拡張機能をデプロイします。詳細は、『Oracle WebCenter PortalおよびOracle JDeveloperでのポータルの開発』のWebCenter Portal共有ライブラリ(extend.spaces.webapp.war)への拡張機能のデプロイに関する項を参照してください。

カスタム・タスク・フローがWebCenter Portal上に共有ライブラリとしてデプロイされた後、カスタム・タスク・フローは、Portal Frameworkアプリケーションを移行したポータルで使用できるようになります。

注意:
WebCenter Portalでは、オプションとしてカスタム・タスク・フローを新規リソース・カタログに登録し、そのカタログをターゲット・プロファイルで使用可能にできます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のリソース・カタログの作成に関する項を参照してください。
カスタム・タスク・フローがリソース・カタログで使用可能になると、ユーザーはタスク・フローをポータル・ページに追加できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のページへのコンポーネントの追加に関する項を参照してください。

I.2.5 静的リソースの移行

Portal Frameworkアプリケーションには、PortalプロジェクトおよびPortalWebAssetsと呼ばれる静的アプリケーション・リソース・プロジェクトが含まれます。イメージ、スタイル・シートおよびHTMLなどの静的リソースは、PortalプロジェクトのWeb Contentフォルダの下またはPortalWebAssetsプロジェクトの下に配置できます。また、静的ファイルを「共有」フォルダの下に配置することもできます。静的リソースは、通常はアプリケーションにバンドルされてデプロイされます。

- 「共有」フォルダ: 静的リソースを図I-2に示されているように「ベース・パス」フォルダ/oracle/webcenter/portalapp/sharedに配置できます。アプリケーションをデプロイすると、これらのファイルは.marファイルとしてパッケージ化されてMDSにインポートされます。Portal FrameworkアプリケーションをmigrateFrameworkApplicationToWebCenter WLSTコマンドを使用して移行すると、共有静的リソースはポータル・サーバー上のターゲットMDSにコピーされます。手動で移行する必要はありません。

図I-2 「共有」フォルダ内の静的リソース

- 「Webコンテンツ」フォルダ: PortalWebAssetsプロジェクトまたはPortalプロジェクトのWeb Contentフォルダの静的リソースを配置できます(図I-3を参照)。これらの静的リソースは.warファイルにパッケージ化され、アプリケーションのデプロイ時にターゲット・サーバーにデプロイされます。Portal Frameworkアプリケーションを移行する際、これらの静的リソースは移行されません。手動で共有ライブラリとしてパッケージ化し、WebCenter Portal管理対象サーバー上にデプロイする必要があります。

図I-3 「Webコンテンツ」フォルダ内の静的リソース

PortalプロジェクトのWeb ContentフォルダまたはPortalWebAssetsプロジェクトに格納された静的リソースを共有ライブラリとしてデプロイする手順:

1. Fusion Webアプリケーション(ADF)アプリケーション・テンプレートに基づいてアプリケーションを作成します。
これで、ModelおよびViewControllerプロジェクトがアプリケーションに作成されます。

2. Portal FrameworkアプリケーションのPortalWebAssetsおよびPortalプロジェクトの下に格納されたすべての静的コンテンツをViewController/public_html/フォルダにコピーし、新規作成されたアプリケーションでフォルダ構造をそのまま維持します。例:

- ファイル・システム上で、Portal/public_html/images/banner_2.jpgを/ViewController/public_html/images/banner_2.jpgにコピーします。

- Portal/public_html/css/sample.cssを/ViewController/public_html/css/sample.cssにコピーします。

3. Fusion Webアプリケーション(ADF)アプリケーションを共有ライブラリとしてデプロイします。これを行うには次の手順が必要になります。

1. アプリケーションをADFライブラリのJARファイルとしてデプロイします。

2. JARを共有ライブラリのWARファイルとしてパッケージ化およびデプロイします。

3. 共有ライブラリのWARファイルをWebCenter Portalサーバーの拡張機能を使用してアクセスします。

これらの手順の詳細は、第I.2.4項「カスタム・タスク・フローの移行」を参照してください。静的リソースを移行する手順はカスタム・タスク・フローを移行する手順と同じです。

静的リソースがWebCenter Portal上でアクセス可能になった後、静的イメージ、CSSおよびHTMLは、Portal Frameworkアプリケーションを移行したターゲット・ポータルで使用できるようになります。

注意:
静的リソースを共有ライブラリとしてWebCenter Portal管理対象サーバーにデプロイするかわりに、パフォーマンスを向上させるためにファイルを本番環境でOracle HTTP Server (OHS)に配置できます。このためには、PortalWebAssetsのフォルダ構造全体またはPortalプロジェクトあるいはMDSのSharedフォルダ・パスをOHSのドキュメント・ルートにコピーする必要があります。

I.2.6 SQLデータ・コントロールの移行

Portal FrameworkアプリケーションにSQLデータ・コントロールを作成している間は、アプリケーションがデプロイされるカスタム・ポータル・サーバーをターゲットとするすべてのデータ・ソースを使用できます。Portal Frameworkアプリケーションを移行した後、SQLデータ・コントロールが機能するためにそのデータ・ソースのターゲットを、WebCenter Portalがデプロイされる管理対象サーバーWC_Spacesに設定する必要があります。さらに、WebCenter Portalの移行されたSQLデータ・コントロール内のデータ・ソースの詳細を更新する必要があります。

SQLデータ・コントロールを移行する手順:

1. SQLデータ・コントロールにより使用されるすべてのデータ・ソースのターゲットをWC_Spacesに設定します。

1. Oracle WebLogic Serverコンソールで、「サービス」→「データ・ソース」へ移動します。

2. SQLデータ・コントロールにより使用されるデータ・ソースをクリックしてその設定を表示します。

3. 「ターゲット」タブを開きます。

4. WC_Spaces管理対象サーバーの横にあるチェック・ボックスを選択してデータ・ソースのターゲットをこのサーバーに設定します。

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

2. SQLデータ・コントロールを編集してデータ・ソースの詳細を更新します:

1. WebCenter Portalにログオンして、ポータル管理に移動します。

2. 「共有アセット」タブをクリックして、「共有アセット」ページを表示します。

3. サイドバーで、「統合」の下にある「データ・コントロール」をクリックします。

4. 編集するデータ・コントロールの「編集」クイック・リンクをクリックします。

5. 「データソース」ドロップダウン・リストから、SQLデータ・コントロールに使用するデータソースを選択します。このデータ・ソースはWC_Spacesをターゲットとする必要があります。

6. 「パスワード」フィールドに、データ・ソースに接続するために使用するパスワードを入力します。

7. 「保存して閉じる」をクリックします。

データ・コントロールの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のデータ・コントロールの編集に関する項を参照してください。

I.2.7 ドキュメントの移行

この項には次のトピックが含まれます:

- 第I.2.7.1項「ドキュメントの移行について」

- 第I.2.7.2項「ドキュメントを移行する方法」

- 第I.2.7.3項「migrateFrameworkApplicationDocumentsToWebCenterにより生成される出力」

I.2.7.1 ドキュメントの移行について

Portal FrameworkアプリケーションをポータルとしてWebCenter Portalに移行した後、移行されたページ上のドキュメント・タスク・フローは引き続きContent Server上の古い場所からドキュメントにアクセスします。ただし、ターゲットのポータルに追加された新規ドキュメントはすべて、ポータル用にプロビジョニングされたフォルダに格納されます。Portal Frameworkアプリケーションのコンテンツを、Content Serverのターゲット・ポータル用にプロビジョニングされたフォルダに移動することをお薦めします。これにより、すべてのドキュメントが同じ場所に格納され、同じセキュリティ・グループを使用するようになります。コンテンツを移行せず、後からコンテンツとともにポータルをエクスポートまたはインポートする場合、該当するコンテンツは継承されません。さらに、コンテンツに設定されたセキュリティには、ポータルレベルのセキュリティはミラー化されません。

ターゲット・ポータル用にプロビジョニングされたフォルダに手動でドキュメントを移動すると、Content Server上のフォルダ・パスが変化します。ただし、ターゲット・ポータルは引き続き古いフォルダ・パスを参照しているため、ドキュメントはポータル・ページに正しく表示されません。フォルダ・パス参照およびドキュメント・メタデータを更新するには、新旧のフォルダ・パス参照のマッピングを含むマッピングCSVファイルを作成する必要があります。次に、migrateFrameworkApplicationDocumentsToWebCenter WLSTコマンドを実行し、フォルダ・パス参照を更新するパラメータとして.csvファイルを渡す必要があります。

Oracle WebCenter Contentでは、Folders_gおよびFrameworkFoldersという2つのフォルダ・ソリューションが提供されます。Folders_gおよびFrameworkFoldersの両方において、階層フォルダ・インタフェースが提供されていますが、コンテンツを整理する方法はこれら2つの設定で異なります。Content Serverで構成されているフォルダ・ソリューションに基づいて、ドキュメントを適切なフォルダに移動する必要があります。

Folders_g設定内のドキュメント

Content ServerがFolders_gを使用するように構成されたWebCenter Portal環境では、Portal Frameworkアプリケーションを移行したターゲット・ポータル上でドキュメント・サービスを有効にすると、WebCenter Portalのルート・ディレクトリの下にポータル用のフォルダが作成されます。このフォルダにドキュメントを移動する必要があります。

たとえば、hrappという名前のPortal FrameworkアプリケーションをHR Portalという名前のポータルに移行したとします。さらに、hrappのドキュメントが、図I-4に示されているように、トップレベルのフォルダContribution Folders/hrappの下のサブフォルダBlogs、DocumentsおよびTrainingに格納されています。

HR Portalのドキュメント・サービスを有効にすると、次のフォルダがContent Server上に作成されます:

/webcenter/HR Portal

ここで、webcenterはmigrateFrameworkApplicationConnectionsコマンドを実行中に指定したspacesRootパラメータの値です。Content Server UIを使用して、アプリケーションのドキュメントをHR Portalフォルダに移行する必要があります。図I-4に、hrappの各サブフォルダをどのようにしてHR Portalに移動できるかのサンプルを示します。これはContent Serverのターゲット・ポータル用にプロビジョニングされたフォルダです。

図I-4 Folders_g設定: 移行前後のフォルダ構造

フォルダ・パス参照およびドキュメント・メタデータを更新するために、MigrationMappingFile.csvという名前のマッピング・ファイルを作成するものとします。図I-4に示されたフォルダ構造を更新するには、マッピング・ファイルに次のエントリを含む必要があります:

#old path, new path
/Contribution Folders/hrapp/Blogs,/webcenter/HR Portal/Blogs
/Contribution Folders/hrapp/Documents,/webcenter/HR Portal/Documents
/Contribution Folders/hrapp/Training,/webcenter/HR Portal/Training

migrateFrameworkApplicationDocumentsToWebCenter WLSTコマンドの実行中にマッピング・ファイルの名前をmigrationFolderMappingFile引数に指定すると、ドキュメント・パスおよびメタデータが更新され、ドキュメントが移行後のページに正しく表示されます。

FrameworkFolders設定内のドキュメント

WebCenter PortalがContent Server上のFrameworkFoldersコンポーネントを使用するように構成されている場合、ポータル・フォルダはエンタープライズ・ライブラリとして処理され、パス/Enterprise Librariesの下に格納されます。ポータルに公開されたドキュメントは、パス/Enterprise Libraries/portal_nameの下に格納されます。

たとえば、hrappという名前のPortal FrameworkアプリケーションをHR Portalという名前のポータルに移行したとします。さらに、hrappのドキュメントが、トップレベルのフォルダEnterprise Libraries/hrappの下のサブフォルダBlogs、DocumentsおよびTrainingに格納されています。移行後、移行されたページは引き続き既存のドキュメントにEnterprise Libraries/hrappの場所からアクセスします。

HR Portalのドキュメント・サービスを有効にすると、次のフォルダがContent Server上に作成されます:

/Enterprise Libraries/HR Portal

ターゲット・ポータルで作成する新規ページは、すべてパス/Enterprise Libraries/HR Portalにあるポータルのエンタープライズ・ライブラリに格納されます。Content Server UIを使用して、アプリケーションの既存のドキュメントをこのフォルダに移行する必要があります。図I-5に、Portal Frameworkアプリケーションの各サブフォルダをどのようにしてターゲット・ポータルのフォルダに移動できるかのサンプルを示します。

図I-5 FrameworkFolders設定: 移行前後のフォルダ構造

フォルダ・パス参照およびドキュメント・メタデータを更新するために、MigrationMappingFile.csvという名前のマッピング・ファイルを作成するものとします。図I-5に示されたフォルダ構造を更新するには、マッピング・ファイルに次のエントリを含む必要があります:

#old_path,new_path
/Enterprise Libraries/hrapp/Blogs,/Enterprise Libraries/HR Portal/Blogs
/Enterprise Libraries/hrapp/Documents,/Enterprise Libraries/HR Portal/Documents
/Enterprise Libraries/hrapp/Training,/Enterprise Libraries/HR Portal/Training

migrateFrameworkApplicationDocumentsToWebCenter WLSTコマンドの実行時にマッピング・ファイルの名前をmigrationFolderMappingFile引数に指定すると、ドキュメント・パスおよびメタデータが更新され、ドキュメントが移行後のページに正しく表示されます。

I.2.7.2 ドキュメントを移行する方法

Portal Frameworkアプリケーションで使用されたドキュメントをターゲット・ポータル用にプロビジョニングされたフォルダに移行する手順:

1. WebCenter Portalにログオンします。

2. ターゲット・ポータルでドキュメント・サービスを有効にします。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルで使用可能なツールとサービスの有効化および無効化に関する項を参照してください。

3. Content Serverにログオンし、Portal Frameworkアプリケーションで使用されたトップレベルのフォルダを、ターゲット・ポータル用にプロビジョニングされたフォルダに移動します。
Folders_gおよびFrameworkFoldersの設定で使用されたフォルダ構造の詳細は、第I.2.7.1項「ドキュメントの移行について」を参照してください。

4. Portal Frameworkアプリケーションのトップレベル・フォルダをContent Server上のターゲット・ポータルのフォルダに移行する前と後のフォルダ構造のマッピングを含む.csvファイルを作成します。

注意:
.csvマッピング・ファイルに、新旧のフォルダ・パスに関する正確で完全な詳細が含まれていることを確認します。パスが正しくない場合、ドキュメント移行は失敗し、ドキュメントはWebCenter Portalのターゲット・ポータルで使用できなくなります。
Folders_gおよびFrameworkFoldersの設定で使用された.csvマッピング・ファイルのエントリ例を表示するには、第I.2.7.1項「ドキュメントの移行について」を参照してください。

5. migrateFrameworkApplicationDocumentsToWebCenter WLSTコマンドを実行してすべての古いパス参照をターゲット・ポータルの新しいパスで更新し、Portal Frameworkアプリケーションのドキュメント・メタデータをWebCenter Portalに移行します。

migrateFrameworkApplicationDocumentsToWebCenter(appName, server, targetPortal, migrationFolderMappingFile, migrationDirectory, [connectionName, applicationVersion])

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

たとえば、次のコマンドではWC_Spaces管理対象サーバーにデプロイされたWebCenter PortalアプリケーションにPortal Frameworkアプリケーションのドキュメント・メタデータが移行されます。移行は、ターゲット・ポータルHR PortalでデフォルトのContent Server接続を使用して実行されます。移行ログがパスtmp/migrateの下に格納されます。フォルダ・パスはマッピング・ファイルMigrationMappingFile.csvを使用して更新されます。

migrateFrameworkApplicationDocumentsToWebCenter(appName='webcenter', server='WC_Spaces', targetPortal='HR Portal', migrationFolderMappingFile='/tmp/migrationmap/MigrationMappingFile.csv', migrationDirectory='/tmp/migrate')

6. ノード・マネージャおよびすべてのサーバーを再起動します。

I.2.7.3 migrateFrameworkApplicationDocumentsToWebCenterにより生成される出力

migrateFrameworkApplicationDocumentsToWebCenter WLSTコマンドを実行すると、FwkAppDocumentMigrationDiagnostic.logファイルがmigrationDirectoryパラメータに指定されたディレクトリの下のlogsディレクトリ内に生成されます。FwkAppDocumentMigrationDiagnostic.logには、MDSドキュメントのエクスポートおよびインポート操作の詳細などのドキュメント移行プロセスの詳細が含まれます。

FwkAppDocumentMigrationDiagnostic.logファイルの出力例を次に示します:

WebCenter Framework Application Documents Migration Log File
-----------------------------------------------------------

#############################################################################
Executing migration wlst command migrateFrameworkApplicationDocumentsToWebCenter
#############################################################################
[TRACE]: Entering class: FwkAppMigration, method: migrateFrameworkApplicationDocumentsToWebCenter
[TRACE]: Parameters provided are: appName: webcenter, server: WC_Spaces, targetPortal: FwkAppPortal1, migrationDirectory: /scratch/migration/migration_log/migrationLog-2016_05_25/docMigration, connectionName: ,applicationVersion:
[TRACE]: The migration directory default/specified: /scratch/migration/migration_log/migrationLog-2016_05_25/docMigration has necessary permissions
[TRACE]: Entering class: FwkAppMigration, method: _getDefaultDocLibConnectionName
[TRACE]: Exiting method: _getDefaultDocLibConnectionName, returning:: connectionName: UCM
[TRACE]: Entering class: FwkAppMigration, method: _getUCMConnectionUrl
[TRACE]: Exiting method: _getUCMConnectionUrl, returning:: ucmUrl: idc://adc.example.com:9444
[TRACE]: Entering class: FwkAppMigration, method: _getDocumentsSpacesRoot
[TRACE]: Exiting method: _getDocumentsSpacesRoot, returning:: spacesRoot: /webcenter
[TRACE]: derived attributes,  ucmConnectionUrl: idc://adc.example.com:9444, Portal Server Spaces Root: /webcenter

[TRACE]: Entering the class: oracle.webcenter.doclib.fwkapp.FwkAppDocumentMigrationUtils, method: isDocLibProvisioned with parameters, scope: FwkAppPortal1 (guid=s0fd1c1cc_00e3_4e0a_9bb1_f2bffc1001d5), migrationDirectory: /scratch/migration/migration_log/migrationLog-2016_05_25/docMigration
[TRACE]: The connection to Content Server exists and the Documents service is provisioned for the portal.
[SUCCESS]: Documents service is validated. Connection to Content Server exists and documents service is provisioned for the portal.

[TRACE]: Migration folder mapping file: /tmp/MigrationMapping.txt

[TRACE]: Entering the class: oracle.webcenter.doclib.fwkapp.FwkAppDocumentMigrationUtils, method: validateMigrationFolderMappingFile with parameters, migrationFolderMappingFile: /tmp/MigrationMapping.txt, migrationDirectory: /scratch/migration/migration_log/migrationLog-2016_05_25/docMigration, connectionName: UCM, connectionUrl: idc://adc.example.com:9444
[TRACE]: Socket Timeout: 18000000
[TRACE]: Migration folder mapping file data: /Enterprise Libraries/fwkapproot/Blogs,/Enterprise Libraries/FwkAppPortal1(webcenter)/Blogs
[TRACE]: Foldering Service :FRAMEWORK_FOLDERS
[TRACE]: Migration folder mapping file data: /Enterprise Libraries/fwkapproot/Documents,/Enterprise Libraries/FwkAppPortal1(webcenter)/Documents
[TRACE]: Foldering Service :FRAMEWORK_FOLDERS
[SUCCESS]: The migration folder mapping file validation is successful.
[SUCCESS]: validation completed successfully on migration mapping file.

[SUCCESS]: Export of MDS documents is complete.

[TRACE]: Starting migration of MDS documents.

[TRACE]: Entering the class: oracle.webcenter.doclib.fwkapp.FwkAppDocumentMigrationUtils, method: massageMdsDocuments with parameters, scope: FwkAppPortal1 (guid=s0fd1c1cc_00e3_4e0a_9bb1_f2bffc1001d5), connectionName: UCM, migrationDirectoryPath: /scratch/migration/migration_log/migrationLog-2016_05_25/docMigration
[TRACE]: migration map entry line (1): /Enterprise Libraries/fwkapproot/Blogs,/Enterprise Libraries/FwkAppPortal1(webcenter)/Blogs
[TRACE]: migration map entry line (2): /Enterprise Libraries/fwkapproot/Documents,/Enterprise Libraries/FwkAppPortal1(webcenter)/Documents
[TRACE]: In the File: /scratch/migration/migration_log/migrationLog-2016_05_25/docMigration/ExportDirectory/pageDefs/oracle/webcenter/page/scopedMD/s0fd1c1cc_00e3_4e0a_9bb1_f2bffc1001d5/Page24PageDef.xml, all refrences of '/Enterprise Libraries/fwkapproot/Documents' is replaced with '/Enterprise Libraries/FwkAppPortal1(webcenter)/Documents'.
[TRACE]: In the File: /scratch/migration/migration_log/migrationLog-2016_05_25/docMigration/ExportDirectory/pageDefs/oracle/webcenter/page/scopedMD/s0fd1c1cc_00e3_4e0a_9bb1_f2bffc1001d5/Page25PageDef.xml, all refrences of '/Enterprise Libraries/fwkapproot/Documents' is replaced with '/Enterprise Libraries/FwkAppPortal1(webcenter)/Documents'.
[TRACE]: In the File: /scratch/migration/migration_log/migrationLog-2016_05_25/docMigration/ExportDirectory/pageDefs/oracle/webcenter/page/scopedMD/s0fd1c1cc_00e3_4e0a_9bb1_f2bffc1001d5/Page37PageDef.xml, all refrences of '/Enterprise Libraries/fwkapproot/Documents' is replaced with '/Enterprise Libraries/FwkAppPortal1(webcenter)/Documents'.
[SUCCESS]: Migration of MDS documents is complete.

[SUCCESS]: Migration of MDS documents is complete.
[TRACE]: Importing the modified MDS documents.

[SUCCESS]: Successfully imported the modified MDS documents.

[TRACE]: Entering the class: oracle.webcenter.doclib.fwkapp.FwkAppDocumentMigrationUtils, method: propagatePortalAccount with parameters, scope: FwkAppPortal1 (guid=s0fd1c1cc_00e3_4e0a_9bb1_f2bffc1001d5), connectionName: UCM, connectionUrl: idc://adc.example.com:9444, spacesRoot: webcenter, migrationDirectory: /scratch/migration/migration_log/migrationLog-2016_05_25/docMigration
[TRACE]: Socket Timeout: 18000000
[TRACE]: Foldering Service :FRAMEWORK_FOLDERS
[TRACE]: Portal enterprise library fFolderGUID: 13ECEF7A2661182EF3CE253B2BBD88EC
[TRACE]: Account to be propagated to all child items of the portal: s0fd1c1cc00e34e0a9bb1f2bffc1001d5
[TRACE]: Foldering Service :FRAMEWORK_FOLDERS
[TRACE]: Portal account is successfully propagated to: s0fd1c1cc00e34e0a9bb1f2bffc1001d5

[SUCCESS]: migrateFrameworkApplicationDocumentsToWebCenter successfully executed.

I.2.8 お知らせおよびディスカッションの移行

この項には次のトピックが含まれます:

- 第I.2.8.1項「お知らせおよびディスカッションの移行について」

- 第I.2.8.2項「お知らせおよびディスカッションを移行する方法」

- 第I.2.8.3項「migrateFrameworkApplicationDiscussionsToWebCenterにより生成される出力」

I.2.8.1 お知らせおよびディスカッションの移行について

Portal Frameworkアプリケーションをターゲット・ポータルに移行した後、お知らせおよびディスカッションを含む移行されたページは引き続き移行前と同じように機能します。ターゲット・ポータルは、Portal Frameworkアプリケーションに構成されているフォーラムまたはカテゴリからのお知らせおよびディスカッションのトピックに引き続きアクセスします。アプリケーションでお知らせおよびディスカッションを管理する権限があった場合、移行されたポータルでも引き続きその権限があります。ただし、ターゲット・ポータル用にプロビジョニングされたフォーラムまたはカテゴリにお知らせおよびディスカッションを移動することで、ポータル・サーバーのセキュリティ・モデルにあわせてお知らせおよびディスカッションの使用状況を調整することをお薦めします。これにより、お知らせおよびディスカッションのセキュリティをターゲット・ポータル内から管理する利点が提供されます。

Portal Serverセキュリティ・モデル

Portal Frameworkアプリケーション設定で、お知らせおよびディスカッションの権限をディスカッション・サーバー管理コンソールを使用して管理します。ディスカッション・サーバーでは、ユーザーおよびエンタープライズ・ロールに直接アクセス権限を付与できます。一方、ポータル・サーバー設定で、ポータル内からWebCenter Portal管理を使用してお知らせおよびディスカッション権限を管理できます。ポータル・サーバーでは、ポータル・ルールを使用してセキュリティを管理します。適切なお知らせおよびディスカッション権限を様々なロールに付与します。その後、適切なユーザーおよびエンタープライズ・ロールを追加することでこれらのロールのメンバーシップを管理できます。ユーザーまたはエンタープライズ・ロールをポータル・ロールから追加または削除するたびに、対応するお知らせまたはディスカッション権限がディスカッション・サーバー上でもそのユーザーまたはエンタープライズ・ロールから自動的に付与または取り消されます。

ディスカッション・サーバーでは、カテゴリの下のフォーラムは親カテゴリから継承したセキュリティ設定をオーバーライドできます。ポータル・サーバー・セキュリティ・モデルでは、すべてのフォーラムが親カテゴリからセキュリティを継承し、親セキュリティの設定をオーバーライドすることはできません。ポータル・サーバー・セキュリティ・モデルにあわせた調整中に、ターゲット・ポータルがカテゴリを使用するようにプロビジョニングされている場合はフォーラム固有セキュリティ設定が構成されていないことを確認する必要があります。

お知らせ

ポータルにお知らせサービスを有効にすると、ネーミング書式Portal_Name-Announcements、たとえばHR Portal-Announcementsを使用して新規フォーラムが作成されます。このフォーラムはポータルの「お知らせ」システム・ページにリンクされます。ポータル・サーバー・モデルの利点を活用するには、既存のお知らせをすべて、ディスカッション・サーバーでターゲット・ポータル用にプロビジョニングされたフォーラムに移行する必要があります。

ディスカッション

ポータルでディスカッション・サービスを有効にすると、ネーミング書式Portal_Name、たとえばHR Portalを使用して新規ディスカッションが作成されます。このフォーラムはポータルの「ディスカッション」システム・ページにリンクされます。ポータル・サーバー・モデルの利点を活用するには、既存のディスカッションをすべて、ディスカッション・サーバーでターゲット・ポータル用にプロビジョニングされたフォーラムに移行する必要があります。

Portal Frameworkアプリケーションで、ディスカッション・トピックが様々なフォーラム間に格納されている場合、ターゲット・ポータルで複数フォーラムのサポートを有効にする必要があります。これにより、すべてのポータル・フォーラムを格納するポータル用のカテゴリが作成されます。既存のディスカッション・フォーラムをすべて、ポータル用にプロビジョニングされたカテゴリに移動する必要があります。

移行

既存のお知らせおよびディスカッションをすべて、ディスカッション・サーバーでターゲット・ポータル用にプロビジョニングされたフォーラムまたはカテゴリに移行する際、移行されたポータル・ページ上のフォーラムまたはカテゴリのIDを更新する必要があります。このためには、新旧IDのマッピングを含むCSVファイルを作成する必要があります。次に、migrateFrameworkApplicationDiscussionsToWebCenter WLSTコマンドを実行し、IDを更新するパラメータとして.csvファイルを渡す必要があります。

例: お知らせおよびディスカッションの移行

hrappという名前のPortal Frameworkアプリケーションが、そのお知らせおよびディスカッションをディスカッション・サーバー上の次のフォーラムに格納するシナリオを検討してください:

- お知らせ: hrapp-announcementsフォーラムに格納されます。フォーラムIDは3です。

- ディスカッション: 次に示す様々なフォーラム間に格納されます: hrapp-training、hrapp-process、hrapp-policies、いずれもhrapp-catという名前のIDが2のカテゴリの下にあります。hrapp-trainingフォーラムには、親カテゴリhrapp-catから継承したセキュリティ設定をオーバーライドする明示的なセキュリティ設定があります。

hrappをHR Portalという名前のターゲット・ポータルに移行すると、移行されたページは引き続きhrapp-announcementsフォーラムおよびhrapp-catカテゴリからのお知らせおよびディスカッションにアクセスします。

HR Portal用のお知らせサービスおよびディスカッション・サービスを有効にしたときにポータル・サーバー・セキュリティ・モデルに移動するために次が作成されます:

- お知らせ: HR Portal-Announcementsという名前のフォーラムがIDを7として作成されます。

- ディスカッション: HR Portalという名前のフォーラムがデフォルトでID 5で作成されます。しかし複数フォーラムのサポートを有効にした場合、HR Portalという名前のカテゴリがID 3で作成されます。HR PortalフォーラムはHR Portalカテゴリの下に移動されます。

ディスカッション・サーバーでは、お知らせおよびディスカッションを次のように移動します:

- hrapp-announcementsフォーラムをthe HR Portal-Announcementsフォーラムとマージしてお知らせを移行します。これで、ディスカッション・トピックがhrapp-announcementsにあれば、それもHR Portal-Announcementsに移動されます。

- hrapp-trainingフォーラムをhrapp-catカテゴリからHR Portalカテゴリに移動します。

- hrapp-processフォーラムをhrapp-catカテゴリからHR Portalカテゴリに移動します。

- hrapp-policiesフォーラムをhrapp-catカテゴリからHR Portalカテゴリに移動します。

- HR Portal-Announcementsとマージされたディスカッション・トピックをHR Portalフォーラムに移動します。

- 明示的なセキュリティ設定をhrapp-trainingフォーラムから削除して、親カテゴリHR Portalからセキュリティを継承するようにします。

次に、次のエントリを持つDiscussionsMappingFile.csvファイルを作成する必要があります:

#old id, new id
a3, a7
f3, f5
c2, c3

ここで、aはお知らせフォーラムを参照し、fはディスカッション・フォーラムを参照し、cはカテゴリを参照します。

migrateFrameworkApplicationDiscussionsToWebCenter WLSTコマンドを実行してページ定義内のIDの更新およびパラメータの修正を実行中に、DiscussionsMappingFile.csvファイルをパラメータとして渡す必要があります。

WLSTコマンドを実行した後、HR Portalの移行されたページにthe HR Portal-Announcementsフォーラムからのお知らせと、HR Portalカテゴリからのディスカッション・トピックおよびフォーラムが表示されます。

I.2.8.2 お知らせおよびディスカッションを移行する方法

お知らせおよびディスカッションをポータル・サーバー・モデルに移行する手順:

1. WebCenter Portalにログオンします。

2. ターゲット・ポータル上でお知らせサービスおよびディスカッション・サービスを有効にします。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルで使用可能なツールとサービスの有効化および無効化に関する項を参照してください。
お知らせの場合、通常はこれでポータルのフォーラムがPortal_Name-Announcements、たとえばHR Portal-Announcementsの名前でポータル・サーバー用に構成されたルート・カテゴリに作成されます。

ディスカッションの場合、これで単一のフォーラムがポータルと同じ名前、たとえばHR Portalで、ポータル・サーバー用に構成されたルート・カテゴリの下に作成されます。

3. ポータルの「ツールとサービス」管理の下の「お知らせ」ページに移動し、ポータルに対して指定されたフォーラムIDを書き留めます。これが、Portal Frameworkアプリケーションにより使用されるフォーラムからすべてのお知らせを移動するフォーラムです。「お知らせ」ページのアクセスの詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル用お知らせフォーラム設定の変更に関する項を参照してください。

4. ポータルの「ツールとサービス」管理の下の「ディスカッション」ページに移動します。

- 単一のフォーラム: ポータル用のディスカッション・サービスを有効にすると、デフォルトで単一のフォーラムがポータル用にプロビジョニングされます。Portal Frameworkアプリケーションでディスカッションに単一のフォーラムが使用されていた場合、引き続き単一のフォーラムを使用します。ポータルに表示されるフォーラムIDを書き留めます。すべてのディスカッション・トピックをPortal Frameworkアプリケーションからこのフォーラムに移動することになります。

- 複数のフォーラム: Portal Frameworkアプリケーションのディスカッションの使用が異なるフォーラムにわたっている場合、「ポータルの複数フォーラムのサポート」オプションを選択します。これにより、ポータル用のカテゴリが作成されます。カテゴリIDを書き留めます。すべてのフォーラムをPortal Frameworkアプリケーションからこのカテゴリに移動することになります。

- 複数のカテゴリ: WebCenter Portalはポータルに対して複数のカテゴリをサポートしていません。Portal Frameworkアプリケーションが異なるカテゴリの下にディスカッションを格納していた場合、「ポータルの複数フォーラムのサポート」オプションを選択し、カテゴリIDを書き留めます。様々なカテゴリ間のすべてのフォーラムを、ポータル用にプロビジョニングされたカテゴリに移動することが必要になります。

「ディスカッション」ページのアクセスの詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル用ディスカッション・フォーラム設定の変更に関する項を参照してください。

5. ディスカッション・サーバー管理コンソールにログオンします。詳細は、第12.11.1項「ディスカッション・サーバー管理コンソールへのアクセス」を参照してください。
最初に、ポータル用にプロビジョニングされたお知らせフォーラム、つまりPortal_Name-Announcementsにお知らせを移動する必要があります。

6. 既存のお知らせをターゲット・ポータルのフォーラムに移動する手順:

1. 「コンテンツ」タブのカテゴリ・サマリーの下でPortal Frameworkアプリケーションのお知らせデータを含むフォーラムを開きます。このフォーラムから、ポータル用にプロビジョニングされたフォーラムにお知らせを移動することになります。

2. フォーラムIDを書き留めます。このIDは後でマッピング・ファイルに指定することが必要になります。

3. フォーラム・オプションナビゲーション・リストからデータのマージを選択します。
これにより、すべてのお知らせデータを既存のフォーラムまたは新規フォーラムに移動するオプションが示されます。

4. すべてのデータを次のフォーラムに移動リストから、ターゲット・ポータルで使用されるフォーラム、たとえばHR Portal-Announcementsを選択します。

図I-6 ターゲット・ポータルのフォーラムへのお知らせの移動

5. データのマージをクリックします。
これにより、古いフォーラムからすべてのお知らせがHR Portal-Announcementsなどのターゲット・ポータルのフォーラムに移動します。古いフォーラムにディスカッション・トピックが含まれていた場合、それらのトピックもHR Portal-Announcementsに移動されます。この手順の後半でディスカッション・フォーラムを移動するとき、これらのトピックをお知らせフォーラムからディスカッション・フォーラムに移動することが必要になります。

WebCenter Portalでは、ここで「お知らせ」システム・ページにアクセスすると、移動したすべてのお知らせがリスト表示されることがわかります。ただし、お知らせタスク・フローを含むポータル・ページにアクセスすると、別のフォーラムにお知らせを移動したため空であることがわかります。この問題を修正するには、マッピング・ファイルを作成してフォーラムIDを更新し、この手順の後半でWLSTコマンドを実行することになります。

6. Portal Frameworkアプリケーションで複数のフォーラムにお知らせを格納した場合、他のフォーラムから同じ手順を使用してお知らせを移動します。

7. ディスカッションをターゲット・ポータルのフォーラムまたはカテゴリに移動する手順:

1. 「コンテンツ」タブのカテゴリ・サマリーの下で、移行するディスカッションを含むフォーラムを開きます。Portal Frameworkアプリケーションでディスカッション・データがカテゴリに格納された場合、そのカテゴリを開きます。

2. フォーラムIDまたはカテゴリIDを書き留めます。このIDは後でマッピング・ファイルに指定することが必要になります。

3. フォーラム・オプションナビゲーション・リストから「コンテンツの管理」を選択します。
これにより、ポータル用にプロビジョニングされたフォーラムに移動する必要があるすべてのトピックがリスト表示されます。カテゴリを選択した場合、これにより、ポータル用にプロビジョニングされたカテゴリに移動する必要があるすべてのフォーラムがリスト表示されます。

4. 「アクション」列で、各トピックまたはフォーラムのチェック・ボックスを選択してから「移動」をクリックします(図I-7)。

図I-7 ターゲット・ポータルのフォーラムへのディスカッション・トピックの移動

5. 表示されたフォーラムまたはカテゴリのリストから、すべてのディスカッション・トピックまたはフォーラムの移動先を選択します。たとえば、HR Portalを選択します。

6. ディスカッション・トピックを移動するために「スレッドの移動」をクリックします。フォーラムをカテゴリに移動する場合は、「フォーラムの移動」ボタンが表示されます。
これにより、選択したフォーラムにすべてのトピックが移動するか、選択したカテゴリにすべてのフォーラムが移動します。図I-8は、カテゴリの選択されたすべてのフォーラムがターゲット・ポータルのカテゴリに移動することを示しています。

図I-8 ターゲット・ポータルのカテゴリへのディスカッション・フォーラムの移動

7. お知らせを移動したときに古いフォーラムにディスカッション・トピックが含まれていた場合は、それらのトピックもポータルのお知らせフォーラム(HR Portal-Announcements)に移動します。ディスカッション・トピックを、お知らせフォーラムからポータルで使用されているディスカッションに移動する必要があります。

8. WebCenter Portal管理で、お知らせおよびディスカッションに対する権限を要件どおりに設定します。
ポータル・セキュリティの管理の詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルのロールと権限の管理に関する項を参照してください。お知らせおよびディスカッション・セキュリティの詳細は、第I.2.8.1項「お知らせおよびディスカッションの移行について」を参照してください。

9. ディスカッション・サーバー管理コンソールで、フォーラム固有の明示的セキュリティ設定をすべて削除します。これは、フォーラムをカテゴリに移動する場合で、ターゲット・ポータル用にプロビジョニングされた親カテゴリから派生したセキュリティをフォーラムがオーバーライドする場合に適用できます。
権限を削除するには、フォーラム・オプションナビゲーション・リストから「権限」を選択します。次に、権限サマリータブの「削除」列で「削除」アイコンをクリックしてユーザーに対するすべての権限を削除します。この操作をすべてのユーザーおよびグループに対して実行します(図I-9)。

フォーラム・オプションナビゲーション・リストから管理者/モデレータを選択し、権限サマリータブにリスト表示されたすべてのユーザーおよびグループを削除します。

図I-9 フォーラム固有権限の削除

一度ディスカッション・トピックまたはフォーラムを移動すると、「ディスカッション」システム・ページですべてのトピック/フォーラムの表示が適宜開始します。ただし、ディスカッション・タスク・フローを含む移行されたページは、別の場所にトピック/フォーラムを移動したためディスカッションの表示を停止します。この問題を修正するには、次に新旧のディスカッションIDのマッピングを含むマッピング・ファイルを作成し、そのマッピング・ファイルを指定してWLSTコマンドを実行します。

8. フォーラムおよびカテゴリの新旧IDのマッピングを含むマッピング.csvファイルを作成します。
たとえばIDが6のフォーラムからIDが8のHR Portal-Announcementsフォーラムにお知らせを移動したとします。また、ID 3のディスカッション・フォーラムからポータルのID 5のディスカッション・フォーラムにデータを移動しました。さらに、ID 2のカテゴリに属するフォーラムを別のID 3のカテゴリに移動しました。マッピング・ファイルには次のエントリが含まれます:

#old id, new id
a6, a8
f3, f5
c2, c3

ここで、aはお知らせフォーラムを参照し、fはディスカッション・フォーラムを参照し、cはカテゴリを参照します。

注意:
マッピング.csvファイルに、新旧IDに関する正確で完全な詳細が含まれていることを確認します。詳細が正しくない場合、WebCenter Portalのターゲット・ポータルでお知らせおよびディスカッションにアクセスできなくなります。

次の手順でWLSTコマンドを実行するときに、この.csvファイルへのパスを指定する必要があります。

9. migrateFrameworkApplicationDiscussionsToWebCenter WLSTコマンドを実行してページ定義内のパラメータを修正した後、お知らせおよびディスカッションを含むポータルにアクセスしたときにお知らせおよびディスカッションが正しく表示されます。

migrateFrameworkApplicationDiscussionsToWebCenter(appName, server, targetPortal, discussionsMappingFile, migrationDirectory, [applicationVersion])

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

10. ノード・マネージャおよびすべてのサーバーを再起動します。

これにより、お知らせおよびディスカッションの使用がポータル・サーバー・モデルにあわせて正常に調整されました。

I.2.8.3 migrateFrameworkApplicationDiscussionsToWebCenterにより生成される出力

migrateFrameworkApplicationDiscussionsToWebCenter WLSTコマンドを実行すると、FwkAppMigrationReport.logファイルが更新され、FwkAppDiscussionMigrationDiagnostic.logファイルがmigrationDirectoryパラメータに指定されたディレクトリ内に生成されます。

FwkAppMigrationReport.log

正常に移行されたアーティファクトの数および移行に失敗した数などの高度なレベルの移行詳細を含むFwkAppMigrationReport.logファイル。migrateFrameworkApplicationDiscussionsToWebCenter WLSTコマンドを実行すると、ディスカッションおよびお知らせ関連の詳細がFwkAppMigrationReport.logに追加されます。たとえば、ファイルに次のサンプル・エントリが含まれる場合があります:

-------------------------------------------------------
Discussions Migration
-------------------------------------------------------
3 files modified to fix discussion ids
Fixing up discussion ids successfully completed

FwkAppDiscussionMigrationDiagnostic.log

migrateFrameworkApplicationDiscussionsToWebCenter WLSTコマンドの実行でFwkAppDiscussionMigrationDiagnostic.logファイルが生成されます。このファイルには、ディスカッション・マッピング・ファイルに基づいて更新されたディスカッションIDなどの詳細が含まれます。FwkAppDiscussionMigrationDiagnostic.logファイルの出力例を次に示します:

-----------------------------------------------------------
WebCenter Framework Application Discussions Migration Log File
-----------------------------------------------------------
#############################################################################
Executing migration wlst command migrateFrameworkApplicationDiscussionsToWebCenter
#############################################################################
[TRACE]: Entering class: FwkAppMigration, method: migrateFrameworkApplicationDiscussionsToWebCenter
[TRACE]: Parameters provided are: appName: webcenter, server: WC_Spaces, targetPortal: FwkAppPortal1, migrationDirectory: /scratch/migration/migration_log/migrationLog-2016_05_09, discussionsMappingFile: /tmp/DiscussionsMappingFile.csv,applicationVersion:
[TRACE]: The migration directory default/specified: /scratch/migration/migration_log/migrationLog-2016_05_09 has necessary permissions
[TRACE]: Discussion mapping file: /tmp/DiscussionsMappingFile.csv
[TRACE]: Entering the class: DiscussionMigrationUtil, method: validateMappingFile with parameters, migrationDiscussionsMappingFile: /tmp/DiscussionsMappingFile.csv, migrationDirectory: /scratch/migration/migration_log/migrationLog-2016_05_09
[TRACE]: Migration discussion mapping file data: a6,a8
[TRACE]: Migration discussion mapping file data: f1,f9
[TRACE]: Migration discussion mapping file data: c4,c5
[SUCCESS]: The discussion migration mapping file validation is successful.
[SUCCESS]: validation completed successfully on discussions mapping file.
[SUCCESS]: Obtained Portal GUID used for discussions migration: s0fd1c1cc_00e3_4e0a_9bb1_f2bffc1001d5
[SUCCESS]: Export of MDS documents is complete.
[TRACE]: Starting migration of MDS documents.
[TRACE]: Entering the class: DiscussionMigrationUtil, method: migrateDiscussions with parameters, scope: FwkAppPortal1 (guid=s0fd1c1cc_00e3_4e0a_9bb1_f2bffc1001d5), migrationDirectoryPath: /scratch/migration/migration_log/migrationLog-2016_05_09
[TRACE]: migration map entry line (1): a6,a8
[TRACE]: migration map entry line (2): f1,f9
[TRACE]: migration map entry line (3): c4,c5
[TRACE]: In the File: /scratch/migration/migration_log/migrationLog-2016_05_09/portal-data/discussions-mds-export/pageDefs/oracle/webcenter/page/scopedMD/s0fd1c1cc_00e3_4e0a_9bb1_f2bffc1001d5/Page14PageDef.xml, for taskflow /oracle/webcenter/collab/forum/view/taskflows/main-task-flow.xml#forum-main, Category Id 4 is replaced with id 5
[TRACE]: In the File: /scratch/migration/migration_log/migrationLog-2016_05_09/portal-data/discussions-mds-export/pageDefs/oracle/webcenter/page/scopedMD/s0fd1c1cc_00e3_4e0a_9bb1_f2bffc1001d5/Page15PageDef.xml, for taskflow /oracle/webcenter/collab/announcement/view/taskflows/main-view-definition.xml#announcement-main-view, Announcement Id 6 is replaced with id 8
[TRACE]: In the File: /scratch/migration/migration_log/migrationLog-2016_05_09/portal-data/discussions-mds-export/pageDefs/oracle/webcenter/page/scopedMD/s0fd1c1cc_00e3_4e0a_9bb1_f2bffc1001d5/Page5PageDef.xml, for taskflow /oracle/webcenter/collab/forum/view/taskflows/main-task-flow.xml#forum-main, Forum Id 1 is replaced with id 9
[SUCCESS]: Migration of MDS documents is complete.
[TRACE]: Importing the modified MDS documents.
[SUCCESS]: Successfully imported the modified MDS documents.
Framework Application discussions migration is complete.

I.3 Portal Frameworkアプリケーション移行の詳細

この項では、Portal FrameworkアプリケーションをWebCenter Portalに移行するときにページ、アセットおよびリストなどのアーティファクトの移行がバックグラウンドでどのように処理されるかについて説明します。

次の項が含まれます:

- 第I.3.1項「ページ」

- 第I.3.2項「アセット」

- 第I.3.3項「リスト」

- 第I.3.4項「ピープル・コネクション」

- 第I.3.5項「ポートレット」

- 第I.3.6項「リンクおよびタグ」

- 第I.3.7項「アクティビティ・ストリーム」

- 第I.3.8項「セキュリティ」

I.3.1 ページ

ページとは、Portal Frameworkアプリケーションの基本的な構成要素で、ユーザーに提供する様々なタイプのコンテンツを公開するために使用されます。

Portal Frameworkアプリケーションのページ

Portal Frameworkアプリケーションでは、設計時および実行時にページを作成できます。デフォルトでは、ページは次の場所に格納されます:

- 実行時のページ: /oracle/webcenter/portalapp/pagehierarchy

- 設計時のページおよびそのページ定義ファイル: /oracle/webcenter/portalapp/pages
これが設計時のファイル用にお薦めする場所です。ページを他の場所に格納することを選択できます。ページ定義ファイルもページの.jspxファイルと同じMDSネームスペースに格納されます。

ページ階層は/oracle/webcenter/portalapp/pagehierarchyで使用可能なpages.xmlを介して管理されます。子ページを持つページのそれぞれに、親のpages.xmlを参照する別々のpagePages.xmlがあります。

デフォルトで、アプリケーションのナビゲーション・モデルがdefault-navigation-model.xmlに定義されています。通常、アプリケーション内のページは、そのアプリケーションのナビゲーションに明示的に含まれているか、ページがページ階層に含まれている場合はpages.xmlページ問合せを介した参照によりアクセスできます。

WebCenter Portalのページ

WebCenter Portalアプリケーションでは、ポータルのページおよびアーティファクトは次のパスに作成されます: oracle/webcenter/page/scopedMD/<scopeGUID>/.ページ階層はpages.xmlを介して保持されていません。このファイルはポータルで使用可能なすべてのページに対する参照を単に含んでいます。かわりに、ポータル階層は/oracle/webcenter/siteresources/scopedMD/scopeGUID/navigation/GSRID/に格納されたポータル・ナビゲーション・ファイルportal-default-navigation.xmlを介して保持されています。このファイルを編集してその他のナビゲーション・アイテムを追加できます。ただし、ファイル名を変更したり、別のファイルを使用してポータル・ナビゲーションを管理することはできません。

ページの移行

Portal Frameworkアプリケーションの移行中に、デフォルト・パスの下で検出されたすべてのページがターゲット・ポータルに移行され、アプリケーションのデフォルトのナビゲーション・ファイルを使用してターゲット・ポータルのナビゲーションが構築されます。

アプリケーションのページがデフォルト以外の場所に格納されている場合、移行手順を開始する前に該当するページをMDSにインポートする必要があります。次に、migrateFrameworkApplicationToWebCenter WLSTコマンドを実行中にページを移行するためのpagePathパラメータを指定する必要があります。さらに、アプリケーションがカスタム・ナビゲーション・ファイルを使用する場合、そのパスをWLSTコマンドの実行中にnavigationFileパラメータに指定する必要があります。

たとえば、次に示したコードではhrappのデフォルト・パスの下で検出されたすべてのページがHR Portalに移行されます。また、pagePathパラメータに指定された場所にあるページが移行されます。navigationModel1.xmlファイルは、HR Portalのナビゲーション・モデルを構築するために使用されます。

migrateFrameworkApplicationToWebCenter(appName='webcenter', fwkAppName='hrapp', fwkAppServer='WC_Spaces', migrationDirectory='/tmp/mig1', targetPortal='HR Portal', pagePath='/com/xyz/hr/pages,/com/xyz/hr/pages', navigationFile='/oracle/webcenter/portalapp/navigations/navigationModel1.xml')

migrateFrameworkApplicationToWebCenterにより生成されるページ関連出力

migrateFrameworkApplicationToWebCenterコマンドを実行すると、次のページ関連ファイルが生成されてmigrationDirectoryパラメータに指定された場所に格納されます:

- pages/migratedPages.properties: ターゲット・ポータルに移行されたPortal Frameworkアプリケーション・ページのマッピングが含まれます。たとえば、図I-10はPage1.jspxが内部的にPage7.jspxとして移行されたことを示します。

図I-10 migratedPages.propertiesファイル

- pages/migratedPagesWithOverridePolicy.properties: ターゲット・ポータルに移行された、セキュリティをオーバーライドするPortal Frameworkアプリケーション・ページのマッピングが含まれます(図I-11)。

図I-11 migratedPagesWithOverridePolicy.propertiesファイル

- pages/fwkAppPageDef.properties: Portal Frameworkアプリケーションのページとそのページ定義ファイルのマッピングを含みます。このファイルを使用して、移行中にページに対応する適切なページ定義を識別します(図I-12)。

図I-12 fwkAppPageDef.propertiesファイル

- logs/FwkAppMigrationReport.log: 移行対象として検討されたページ数、正常に移行されたページ数または移行に失敗したページ数などの高度なレベルのページ詳細が含まれます(図I-13)。

図I-13 FwkAppMigrationReport.logファイル

- logs/FwkAppMigrationDiagnostic.log: どのページが正常に移行されたか、および移行できなかったページがあった場合はその理由を指定する詳細なログが含まれます。どのナビゲーション・ファイルが使用されたかなどのその他の詳細もリスト表示されます(図I-14)。

図I-14 FwkAppMigrationDiagnostic.logファイル

考慮事項

- Portal Frameworkアプリケーションでは、ページ定義ファイルを作成せずにページを作成できます。移行中、対応するページ定義ファイルがないページはターゲット・ポータルに移行されません。ページ定義ファイルを作成してから再度移行を試行する必要があります。

- ページが移行されると、そのページ・テンプレート使用(ある場合)がポータル・レベルで構成されたテンプレートを使用するようにデフォルト設定されます。ポータル・レベルのこのテンプレートは、移行後に希望するページ・テンプレート・アセットに変更できます。または、個々のページ・テンプレートを、ページレベルの設定で希望するページ・テンプレートに変更できます。

- ページが/oracle/webcenter/portalapp/pages以外の他の場所にある場合は、それらのページが移行対象として考慮されるように、第I.2.1項「デフォルト以外の場所からMDSへのページのインポート」の説明に従ってページをMDSにインポートする必要があります。その後、migrateFrameworkApplicationToWebCenter WLSTコマンドを実行するときに、pagePath引数を指定する必要があります。

- 移行されたすべてのページに対して、ターゲット・ポータル・レベルでのページ・セキュリティ設定が使用されます。Portal Frameworkアプリケーションでは、ページセキュリティがオーバーライドされた場合、引き続きターゲット・ポータルでもセキュリティがオーバーライドされます。

- 移行中、すべてのページ・リンク、プリティURIおよびその他のリソース・パスが更新されて新しい更新済パスが反映されます。

- migrateFrameworkApplicationToWebCenter WLSTコマンドを再実行すると、前に移行に失敗したページまたは前の移行試行後の新規のページのみが移行対象として考慮されます。コマンドを実行するたびに、ポータル・ナビゲーションが削除されて再作成されます。

I.3.2 アセット

Portal Frameworkアプリケーションを移行すると、次のアセット(前にリソースとして参照したもの)が存在する場合はWebCenter Portalに移行されます:

- コンテンツ・プレゼンタ・テンプレート

- データ・コントロール

- ナビゲーション・モデル

- ページ・テンプレート

- ページ・スタイル

- リソース・カタログ

- スキン

- タスク・フロー

- タスク・フロー・スタイル

Portal Frameworkアプリケーションには、シードされた特定の、またはデフォルトのポータル・アセットが含まれます。アプリケーションの構築中は、デフォルト・アセットの使用を選択するか、独自のカスタム・アセットを作成して固有の要件を満たせます。アプリケーションを移行すると、カスタム・アセットのみがWebCenter Portalに移行されます。シードされたアセットはすでにポータル・サーバーに存在するため移行されません。

Portal Frameworkアプリケーションのアセットは共有アセットとしてポータル・サーバー上に移行されます。アプリケーションを移行するためにmigrateFrameworkApplicationToWebCenter WLSTコマンドを再実行するたびに、ポータル・サーバー上のカスタム・アセットがPortal Frameworkアプリケーションからのカスタム・アセットで上書きされます。

migrateFrameworkApplicationToWebCenter WLSTコマンドは、migrationDirectoryパラメータに指定された場所のアセット・ディレクトリの下にmigratedAssets.propertiesファイルを生成します。図I-15は、migratedAssets.propertiesの出力例を示します。移行されたアセットの新旧パス、スキンおよびナビゲーション・モデルが示されています。

図I-15 migratedAssets.propertiesファイル

アセット関連のログもlogsディレクトリの下のFwkAppMigrationReport.logおよびFwkAppMigrationDiagnostic.logファイルに格納されます。これらのファイルの詳細は、第I.3.1項「ページ」を参照してください。

I.3.3 リスト

リスト・サービスに関連したデータは、Portal FrameworkアプリケーションのWEBCENTERスキーマの表に格納されます。移行中に、データはWebCenter Portalで使用されるWEBCENTERスキーマの対応する表に移行されます。

Portal Frameworkアプリケーションをターゲット・ポータルに移行した後、ポータル・ページにリスト・タスク・フローが含まれている場合はリスト・サービスを手動で有効にする必要があります。

I.3.4 ピープル・コネクション

ピープル・コネクション・サービスに関連したデータは、Portal FrameworkアプリケーションのWEBCENTERスキーマの表に格納されます。移行中に、データはWebCenter Portalで使用されるWEBCENTERスキーマの対応する表に移行されます。

I.3.5 ポートレット

Portal Frameworkアプリケーションを移行すると、すべてのポートレットおよびそのメタデータがWebCenter Portalに移行されます。移行中、ポートレット・メタデータがPortal FrameworkアプリケーションのMDSからエクスポートされて、WebCenter PortalのMDSに再インポートされます。

ポートレット・プロデューサが移行時に停止している場合、対応するポートレットは移行されません。移行を開始する前に、ポートレット・プロデューサが起動および実行していることを確認してから、アプリケーションの移行を再度試行できます。

I.3.6 リンクおよびタグ

リンクおよびタグ付けサービスに関連したデータは、Portal FrameworkアプリケーションのWEBCENTERスキーマにある表に格納されます。移行中に、データはWebCenter Portalで使用されるWEBCENTERスキーマの対応する表に移行されます。リソースは、ターゲット・ポータルで新規リソース・パスが適用可能であればそれを使用するように更新されます。

I.3.7 アクティビティ・ストリーム

アクティビティ・ストリーム・サービスに関連したデータは、Portal FrameworkアプリケーションのWEBCENTERスキーマにある表に格納されます。アクティビティ・ストリーム・データはユーザーによりお気に入り登録およびコメントができます。このデータもWEBCENTERに格納されます。移行中に、すべてのアクティビティ・ストリーム・データがWebCenter Portalで使用されるWEBCENTERスキーマの表に移行されます。

I.3.8 セキュリティ

次のセキュリティ関連の変更は、WebCenter Portalのターゲット・ポータルへのPortal Frameworkアプリケーションの移行時に実行されます:

- カスタム・ロールにアセット、関連およびプロファイルまたはアプリケーションレベルの権限が含まれている場合、移行後にこのロールがポータル・サーバー・レベルで作成されます。カスタム・ロールにページ権限が含まれている場合、移行後にこのロールがターゲット・ポータルに作成されます。
上にリスト表示されたすべての権限がカスタム・ロールに含まれている場合、移行後にターゲット・ポータルおよびポータル・サーバー・レベルの両方にロールが作成されます。

- Portal Frameworkアプリケーションのロールに付与された権限およびユーザーおよびグループは、ポータル・サーバー・ロールに継承されます。

- Portal Frameworkアプリケーション内のシードされた管理者ロールのメンバーが、WebCenter Portalの管理者およびポータル・モデレータ・ロールに追加されます。シードされたAppConnectionManagerおよびAppConnectionViewerロールのメンバーが、WebCenter Portalのサーバー管理者ロールに追加されます。

- Portal Frameworkアプリケーションでは、セキュリティをオーバーライドするページ以外のすべてのページに適用可能なユーザー、グループ、およびアプリケーションのロールにデフォルトの権限が付与されている可能性があります。ユーザーおよびグループのメンバーシップのみが継承され(権限は継承されず)、ターゲット・ポータルのメンバーとなります。

- カスタム・ページ権限がポータル・ページに継承されます。ページに関する権限が付与されたユーザーおよびグループは、ポータルのメンバーでないかぎりページにアクセスできません。移行後、ターゲット・ポータルでポータル・ビューア・ロールが付与されます。

- Portal Frameworkアプリケーションでは、ページがデフォルト以外の場所に格納され、アプリケーションがカスタム・ナビゲーション・モデルを使用する可能性があります。これらのページがWebCenter Portalに表示されるために、ページ定義ファイルで権限が匿名または認証ロールに付与されています。移行後、これらの付与は継承されず、ページはポータル・ページに定義されたセキュリティ・モデルに従います。

次のセキュリティ設定は移行されません:

- Portal Frameworkアプリケーション内のシードされた管理者ロールに対する付与は、WebCenter Portalの管理者ロールに移行されません。メンバーシップのみが継承されます。

- 匿名ロールおよび認証ロールに付与されたカスタム・ページ権限のみがWebCenter Portalに継承されます。これらのロールに付与されたその他の権限は継承されません。

- Portal Frameworkアプリケーションで、アプリケーション・ロールを別のアプリケーション・ロールまたは「デフォルト権限」ノードのメンバーとして指定できます。これはWebCenter Portalではサポートされないため、ユーザーおよびグループ・メンバーシップのみがWebCenter Portalのカスタム・ロールに継承されます。

- Portal Frameworkアプリケーションにあるオーバーライドされたアセット権限はいずれもWebCenter Portalに継承されません。必要に応じて手動で権限をオーバーライドできます。

- Portal Frameworkアプリケーションでは、カスタム・アクセスを提供するための個々のタスク・フローに対する権限を、タスク・フローごとにユーザーに付与できます。アプリケーションの移行時に、タスク・フローの権限は移行されません。カスタムの権限クラスを作成している場合、そのクラスもポータル・サーバーに移行されません。ポータル・サーバーで利用できる権限クラスを使用する必要があります。

I.4 Portal Frameworkアプリケーション移行の問題のトラブルシューティング

この項では、Portal FrameworkアプリケーションからWebCenter Portalへの移行中に発生する可能性がある問題をトラブルシューティングする方法を説明します。

次の項が含まれます:

- 第I.4.1項「ページ定義ファイルがないために移行されなかったページ」

- 第I.4.2項「移行後にレンダリングしないページ・テンプレート」

- 第I.4.3項「接続エラーのためにタスク・フローにアクセスできない」

- 第I.4.4項「移行されなかったページ」

- 第I.4.5項「指定した移行ディレクトリにアクセスできない」

I.4.1 ページ定義ファイルがないために移行されなかったページ

問題

ログに、ページ定義ファイルがないためにページが移行されなかったことが示されています。ログには、次のエントリが含まれます:

Page /oracle/webcenter/portalapp/pages/navigation-renderer.jspx could not be migrated, Reason: Unable to find page definition file for page "/oracle/webcenter/portalapp/pages/navigation-renderer.jspx".

解決策

移行中、対応するページ定義ファイルがないページはターゲット・ポータルに移行されません。ページ定義ファイルを作成してから再度移行を試行します。

I.4.2 移行後にレンダリングしないページ・テンプレート

問題

Portal Frameworkアプリケーションはカスタム・ページ・テンプレートを使用するようにswooshyページ・テンプレートに基づいて構成されました。移行後、ページ・テンプレートはターゲット・ポータルで正しくレンダリングしていません。ページ・テンプレートに使用されたイメージは欠落し、「ようこそ」メッセージ、「管理」、「ポータルに戻る」および「ログイン」/「ログアウト」など上部にあるリンクは白色で表示されるため不鮮明です。

解決策

Portal Frameworkアプリケーションを移行する際、ページ・テンプレートで使用されたイメージおよびスタイルおよびカスタム・コードなどの静的リソースは自動的には移行されません。すべてのカスタム・リソースおよびコードを共有ライブラリとしてWebCenter Portalにデプロイし、ターゲット・ポータルで使用可能にします。詳細は、第I.2.5項「静的リソースの移行」を参照してください。

カスタム・コードがWebCenter Portal環境に関連があることを確認する必要があります。たとえば、swooshyページ・テンプレートでは、「管理」リンクがユーザーが管理者ロールに割り当てられているかどうかに基づいてPortal Frameworkアプリケーションにレンダリングされます。一方、管理者ロールはWebCenter Portalに関連がありません。同様に、WebCenter Portalにおけるログインおよびログアウト操作もPortal Frameworkアプリケーションとは異なる処理がされます。

移行後にデフォルトのポータル・テンプレートの1つに基づいてカスタム・ポータル・テンプレートを作成して使用し、必要に応じて変更することをお薦めします。

I.4.3 接続エラーのためにタスク・フローにアクセスできない

問題

Portal Frameworkアプリケーションには、メール・サーバーに対する2つの接続が含まれます。移行後、ターゲット・ポータルでメール・タスク・フローにアクセスすると次のエラー・メッセージが表示される:

No default or active connection available for: oracle.webcenter.collab.mail

解決策

WebCenter Portalでは、サービスが機能するためにデフォルトの接続を指定することが必須です。Portal Frameworkアプリケーションに含まれているメール・サーバー接続が1つのみの場合、それがデフォルトの接続として指定されているといないとに関係なく、移行後にポータル・サーバー上にデフォルトの接続としてマークされます。アプリケーションに同じタイプの複数の接続(たとえばメール・サーバーの接続)が含まれ、デフォルトの接続として何も設定されていない場合、そのタイプの接続で移行後にポータル・サーバー上にデフォルトの接続としてマークされるものはありません。移行後、デフォルトの接続を手動で設定する必要があります。

メール・タスク・フローが機能するために、メール・サーバー接続をWebCenter Portalでのデフォルトの接続として設定します。詳細は、『Oracle WebCenter Portalの管理』のアクティブな(またはデフォルトの)メール・サーバーの選択に関する項を参照してください。

FwkAppConnectionMigrationDiagnostic.logファイルをレビューし、次のサンプル・ログに示されたメッセージが含まれている場合は、すべての必須サービスのデフォルトの接続が設定されていることを確認してください:

IMP connection: Either no connection exists or multiple connections exist, hence not setting default connection.
Mail connection: Either no connection exists or multiple connections exist, hence not setting default connection.
SES connection: Either no connection exists or multiple connections exist, hence not setting default connection.
Personal Event connection: Either no connection exists or multiple connections exist, hence not setting default connection.

I.4.4 移行されなかったページ

問題

移行後にターゲット・ポータルをレビュー中に、Portal Frameworkアプリケーションからのページがいくつか移行されずポータル・ナビゲーションにリスト表示されていないことがわかりました。

解決策

移行中はデフォルトの場所に格納されたページのみがターゲット・ポータルに移行されます。Portal Frameworkアプリケーションにデフォルト以外の場所に格納されたページが含まれている場合、該当するページを手動でMDSにインポートして移行対象として選択されていることを確認します。migrateFrameworkApplicationToWebCenter WLSTコマンドを実行中に、該当するページをWebCenter Portalに移行するためのpagePathパラメータにデフォルト以外のページの場所を指定する必要があります。詳細は、第I.2.1項「デフォルト以外の場所からMDSへのページのインポート」および第I.2.3項「Portal Frameworkアプリケーションを移行するためのmigrateFrameworkApplicationToWebCenterの実行」

I.4.5 指定した移行ディレクトリにアクセスできない

問題

Portal Frameworkアプリケーションを移行しようとすると、移行プロセスで、WLSTコマンドのmigrationDirectoryパラメータで指定された、移行データを格納するためのディレクトリを作成できないまたはこのディレクトリアクセスできないことを示すエラーが返されます。

解決策

Portal Frameworkアプリケーションを複数ノード設定で移行している場合は、WLSTコマンドのmigrationDirectoryパラメータで、すべてのノードからアクセスおよび書き込みが可能な共有ディレクトリを指定します。また、ディレクトリにすべてのノードから同じパスを使用してアクセス可能であることを確認します。

オラクルの法律上の注意点について

コピーライトについて

Copyright © 1994-2017, Oracle and/or its affiliates. All rights reserved.

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクルまでご連絡ください。

制限付権利について

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

アルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のアルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが非公開の試作版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のベータ・トライアル契約のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle PartnerNetwork Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

ドキュメントのアクセシビリティについて

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害のあるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。