Oracle® Fusion Middleware

Oracle WebCenter Portalの管理

12c (12.2.1.1)

E77296-01(原本部品番号:E71586-01)

2016年6月

Oracle WebCenter Portalの管理方法について説明する、システム管理者向けのドキュメントです。システム管理者は、Oracle Enterprise Manager Fusion Middleware Control、Oracle WebLogic Server管理コンソール、Oracle WebLogic Scripting Tool (WLST)コマンドおよびWebCenter Portalの管理ページを使用して、ポータルのデプロイ方法、バックエンド・サーバーの構成方法、パフォーマンスのモニター方法、バックアップとリカバリの戦略の実装方法などを習得します。

Oracle Fusion Middleware Oracle WebCenter Portalの管理 12c (12.2.1.1)

E77296-01

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

原本著者: Savita Thakur

原本協力者: G.Annapoorani、Ingrid Snedecor、Chaitra Ramaprasad

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

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

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

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 Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

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およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

登場人物リスト

- ナレッジ・ワーカー

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

- 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 ツールとサービス

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

- 1.2.6 分析

- 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 ディスカッション・サーバーの構成

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

- 1.3.8 分析に関する考慮事項

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

- 1.4 Oracle WebCenter Portalのインストールの理解

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

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

- 1.7 セキュリティの理解

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

- 1.9 Oracle WebCenter Portalの管理ツール

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

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

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

- 1.9.2.1 ドメイン構成のロック

- 1.9.3 Oracle WebLogic Scripting Tool(WLST)

- 1.9.3.1 Oracle WebLogic Scripting Tool (WLST)コマンドの実行

- 1.9.3.1.1 Oracle WebCenter Portal WLSTコマンドの実行のヒント

- 1.9.4 システムMBeanブラウザ

- 1.9.5 WebCenter Portalの管理ページ

第II部 スタート・ガイド

2 WebCenter Portalの管理のスタート・ガイド

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

- 2.2 WebCenter Portalのインストール

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

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

- 2.5 WebCenter Portalのためのシステム管理 - Fusion Middleware管理者ロール(ロードマップ)

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

3 Enterprise Manager Fusion Middleware Controlの起動

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

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

- 3.2.1 WebCenter Portalのホームページ

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

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

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

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

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

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

- 4.2.2 管理対象サーバーの起動と停止

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

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

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

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

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

第III部 ツールおよびサービスの管理

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

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

- 5.1.1 ツールおよびサービスのバックエンド・リポジトリ

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

- 5.2.1 MDSリポジトリの設定

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

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

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

- 5.2.4.1 Fusion Middleware Controlを使用したプロキシ・サーバーの設定

- 5.2.4.2 WLSTを使用したプロキシ・サーバーの設定

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

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

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

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

6 Oracle WebCenter Content Serverへの接続の管理

- 6.1 Oracle WebCenter Content Serverの接続について

- 6.2 Oracle WebCenter Content Serverの構成の前提条件

- 6.2.1 Oracle WebCenter Content Serverのインストールの前提条件

- 6.2.2 Inbound Refineryのインストールの前提条件

- 6.2.3 Oracle WebCenter Content ServerおよびInbound Refineryの構成の前提条件

- 6.2.4 Oracle WebCenter Content ServerおよびInbound Refineryのセキュリティの前提条件

- 6.3 Oracle WebCenter Content Serverの構成ロードマップ

- 6.4 Oracle WebCenter Content Serverの構成

- 6.4.1 必須コンポーネントの有効化

- 6.4.1.1 FrameworkFoldersコンポーネントの有効化

- 6.4.1.2 WebCenterConfigureコンポーネントの有効化

- 6.4.2 Dynamic Converterコンポーネントの構成

- 6.4.2.1 Dynamic Converterコンポーネントの有効化

- 6.4.2.2 ファイル・タイプ、ファイル・サイズおよびタイムアウト設定の指定

- 6.4.3 Inbound Refineryの構成

- 6.4.3.1 アウトバウンド・プロバイダの作成

- 6.4.3.2 変換するファイル形式の選択

- 6.4.3.3 WikiおよびブログのPDFへの変換の有効化

- 6.4.3.4 ファイル変換のタイムアウト設定の指定

- 6.4.4 Oracle WebCenter Content Serverに対するSSLの設定

- 6.4.5 SESクローラの構成

- 6.4.6 Site Studioの設定

- 6.4.6.1 iFrame化UIの有効化

- 6.4.7 フルテキスト検索の有効化

- 6.4.8 Oracle WebCenter Content Serverでのコンテンツ・プロファイルの作成

- 6.4.9 Digital Asset Managerの有効化

- 6.4.10 Oracle WebCenter Content Serverに対する追加オプション構成

- 6.4.10.1 Desktop用のOracle WebCenter Content Serverの構成

- 6.4.10.2 ファイル・ストア・プロバイダの構成

- 6.4.10.3 ノード・マネージャの設定

- 6.4.10.4 ローカライゼーション・プロパティの構成

- 6.4.10.5 リッチ・テキスト・エディタのWikiマークアップ・タブの表示および非表示

- 6.4.10.6 リッチ・テキスト・エディタのテキスト折返しの無効化

- 6.4.11 デフォルトのOracle WebCenter Content Serverのリポジトリの登録

- 6.4.11.1 Oracle WebCenter Portalに対するOracle WebCenter Content Serverのデフォルト接続の構成

- 6.4.11.2 Oracle WebCenter Content ServerにシードされるOracle WebCenter Portalデータの確認

- 6.5 Oracle WebCenter Content Serverへの接続の作成

- 6.5.1 Oracle WebCenter Content Serverへの接続の作成について

- 6.5.2 Fusion Middleware Controlを使用したOracle WebCenter Content Serverへの接続の作成

- 6.5.2.1 ソケットベース通信を使用したOracle WebCenter Content Serverへの接続

- 6.5.2.2 セキュア・ソケットベース通信を使用したOracle WebCenter Content Serverへの接続

- 6.5.2.3 JAX-WSを使用したOracle WebCenter Content Serverへの接続

- 6.5.2.4 HTTPを使用したOracle WebCenter Content Serverへの接続

- 6.5.3 WLSTを使用したOracle WebCenter Content Serverの登録

- 6.5.4 RIDCソケット・タイプに対するOracle WebCenter Content Server接続パラメータ

- 6.6 Oracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定

- 6.6.1 Fusion Middleware Controlを使用したOracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定

- 6.6.2 WLSTを使用したOracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定

- 6.7 Oracle WebCenter Content Serverの接続の詳細の変更

- 6.7.1 Fusion Middleware Controlを使用したOracle WebCenter Content Serverの接続の詳細の変更

- 6.7.2 WLSTを使用したOracle WebCenter Content Serverの接続の詳細の変更

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

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

- 6.7.4.1 Oracle WebCenter Content Serverのコントリビュータ・データ・ファイルの変更

- 6.7.4.2 Oracle WebCenter Content Serverのキャッシュ無効化間隔の変更

- 6.7.4.2.1 Fusion Middleware Controlを使用したキャッシュ無効化間隔の変更

- 6.7.4.2.2 WLSTを使用したキャッシュ無効化間隔の変更

- 6.7.4.3 キャッシュ設定のテスト

- 6.8 Oracle WebCenter Content Serverの接続の削除

- 6.8.1 Fusion Middleware Controlを使用したOracle WebCenter Content Serverの接続の削除

- 6.8.2 WLSTを使用したOracle WebCenter Content Serverの接続の削除

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

- 6.10 コンテンツ・マネージャのDOCSの構成

7 分析の管理

- 7.1 WebCenter Portalの分析について

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

- 7.1.2 分析タスク・フロー

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

- 7.3 分析の前提条件

- 7.3.1 分析: インストール

- 7.3.2 分析: 構成

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

- 7.3.4 分析: 制限事項

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

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

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

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

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

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

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

- 7.5.3.1 Fusion Middleware Controlを使用したWebCenter Portalイベント収集の無効化

- 7.5.3.2 WLSTを使用したWebCenter Portalイベント収集の無効化

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

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

- 7.8 分析データのパージ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- 8.9 ディスカッション・サーバー接続のテスト

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

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

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

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

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

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

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

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

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

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

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

- 9.2 WebCenter Portal用の個人イベントの構成

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

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

- 9.3.1.1 Microsoft Exchange Server 2013: インストール

- 9.3.1.2 Microsoft Exchange Server 2013: 構成

- 9.3.1.3 Microsoft Exchange Server 2013: セキュリティに関する考慮事項

- 9.3.1.4 Microsoft Exchange Server 2013: 制限事項

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

- 9.3.2.1 Microsoft Exchange Server 2010: インストール

- 9.3.2.2 Microsoft Exchange Server 2010: 構成

- 9.3.2.3 Microsoft Exchange Server 2010: セキュリティに関する考慮事項

- 9.3.2.4 Microsoft Exchange Server 2010: 制限事項

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

- 9.3.3.1 Microsoft Exchange Server 2007: インストール

- 9.3.3.2 Microsoft Exchange Server 2007: 構成

- 9.3.3.3 Microsoft Exchange Server 2007: セキュリティに関する考慮事項

- 9.3.3.4 Microsoft Exchange Server 2007: 制限事項

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

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

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

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

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

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

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

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

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

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

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

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

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

10 他のOracleアプリケーションの統合

- 10.1 他のOracleアプリケーションの統合について

- 10.2 Siebelアプリケーションの統合

- 10.2.1 WebサービスとしてのSiebelアプリケーションの統合方法

- 10.2.1.1 Siebelアプリケーションの準備方法

- 10.2.1.1.1 インバウンドWebサービスの作成方法

- 10.2.1.1.2 インバウンドWebサービス向けの操作の作成方法

- 10.2.1.2 Siebel Webサービス・データ・コントロールの使用方法

- 10.2.2 Siebel Webエンジンを使用したSiebelアプリケーションの統合方法

- 10.3 E-Business Suiteアプリケーションの統合

- 10.3.1 EBSアプリケーションの統合について

- 10.3.1.1 EBS統合の理解

- 10.3.1.2 EBSアプリケーションを統合するための要件

- 10.3.2 EBSの統合に必要な構成

- 10.3.2.1 シングル・サインオンなしで使用するOIDの準備方法

- 10.3.2.2 EBSでのユーザーの作成と職責の割当て方法

- 10.3.2.3 EBSアプリケーション・プロファイル・オプションの構成方法

- 10.3.2.4 AutoConfigを使用した信頼できるポータルとしてのWebCenterホストの追加方法

- 10.3.3 WSRPポートレットとしてのEBSアプリケーションの統合方法

- 10.3.3.1 EBSポートレットのリモート・アクセスの準備方法

- 10.3.3.2 EBSアプリケーションの統合方法

- 10.3.3.2.1 EBSポートレットのリモート・アクセスの準備方法

- 10.3.3.2.2 WebCenter PortalへのEBS WSRPプロデューサの登録方法

- 10.3.3.2.3 ポータル・ページへのEBSポートレットの追加方法

- 10.3.3.2.4 ポートレット接続のテスト方法

- 10.3.4 データ・コントロールとしてのEBSアプリケーションの統合方法

- 10.3.4.1 WSDLの生成方法

- 10.3.4.2 Webサービス・データ・コントロールのポータル・ページへの追加方法

- 10.4 JD Edwardsアプリケーションの統合

- 10.4.1 JD Edwardsアプリケーションのリモート・アクセスの準備方法

- 10.4.2 プロデューサの登録方法

- 10.4.3 WebCenter PortalページへのJD Edwardsポートレットの追加方法

- 10.4.4 ポートレット接続のテスト方法

- 10.5 PeopleSoftアプリケーションの統合

- 10.5.1 PeopleSoftアプリケーションの統合について

- 10.5.1.1 PeopleSoft統合の理解

- 10.5.1.2 PeopleSoftアプリケーションを統合するための要件

- 10.5.2 WSRPポートレットとしてのPeopleSoftアプリケーションの統合方法

- 10.5.2.1 PeopleSoftアプリケーションのリモート・アクセスの準備方法

- 10.5.2.2 PeopleTools 8.52以降向けのWS-Securityの構成方法

- 10.5.2.3 WebCenter PortalへのWS-Securityポリシーの添付方法

- 10.5.2.3.1 メッセージ整合性付きのWSS 1.0 SAMLトークンの構成方法

- 10.5.2.3.2 パスワードなしのWSS 1.0ユーザー名トークンの構成方法

- 10.5.2.3.3 メッセージ保護付きのWSS 1.0 SAMLトークンの構成方法

- 10.5.2.3.4 パスワード付きのWSS 1.0ユーザー名トークンの構成方法

- 10.5.2.4 WebCenter PortalへのPeopleSoftアプリケーションの統合方法

- 10.5.2.4.1 WebCenter PortalへのPeopleSoft WSRPプロデューサの登録方法

- 10.5.2.4.2 WebCenter PortalページへのPeopleSoftポートレットの追加方法

- 10.5.2.4.3 ポータル・ポートレット接続のテスト方法

- 10.5.2.5 PeopleTools 8.51向けのWS-Securityの構成方法

- 10.5.2.5.1 メッセージ整合性付きのWSS10 SAMLトークン向けのWS-Securityの構成方法

- 10.5.2.5.2 メッセージ保護付きのWSS10 SAMLトークン向けのWS-Securityの構成方法

- 10.5.2.5.3 パスワード付きのWSS10ユーザー名トークン向けのWS-Securityの構成方法

- 10.5.3 WebCenter Portalへのデータ・コントロールとしてのPeopleSoftアプリケーションの統合方法

- 10.5.3.1 WSDLの準備方法

- 10.5.3.2 Webサービス・データ・コントロールの作成方法

- 10.6 Oracle Business Intelligenceプレゼンテーション・サービスの統合

- 10.6.1 Oracle Business Intelligenceプレゼンテーション・サービスの統合について

- 10.6.1.1 Oracle Business Intelligenceプレゼンテーション・サービスの統合の理解

- 10.6.1.2 Oracle Business Intelligenceプレゼンテーション・サービスを統合するための要件

- 10.6.1.3 拡張統合オプション

- 10.6.2 Oracle BIプレゼンテーション・カタログに接続するための資格証明の構成方法

- 10.6.2.1 BIImpersonatorUserの確認方法

- 10.6.2.2 BIImpersonatorUserの作成方法

- 10.6.2.3 BIImpersonatorUserへの権限の付与方法

- 10.6.3 WebCenter PortalへのOracle Business Intelligenceオブジェクトの統合方法

- 10.6.3.1 デプロイ後のプレゼンテーション・サービス接続の追加または変更方法

- 10.6.3.2 WebCenter Portalリソース・カタログへのOracle BIオブジェクトの追加方法

- 10.6.3.3 実行時のOracle BIコンテンツの追加方法

- 10.6.3.4 ビジネス・インテリジェンス・オブジェクトのプロンプト値の変更方法

- 10.6.3.5 ビジネス・インテリジェンス・タスク・フローの初期化パラメータの変更方法

- 10.7 Oracle Document Cloud Serviceとの統合

- 10.7.1 Oracle Document Cloud Serviceの統合について

- 10.7.2 WSLTを使用したデフォルトのDocument Cloud Service接続の作成

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

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

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

- 11.2.1 Microsoft Lync: インストール

- 11.2.2 Microsoft Lync: 構成

- 11.2.2.1 シンプル・デプロイ

- 11.2.2.2 リモート・デプロイ

- 11.2.2.2.1 Application Provisionerの構築

- 11.2.2.2.2 LyncサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニング

- 11.2.2.2.3 WBemTestを使用したAllowedDomainsの追加

- 11.2.2.2.4 Topology BuilderまたはPowerShellコマンドレットを使用した信頼済サービス・エントリの移行

- 11.2.2.2.5 IISサーバーの構成

- 11.2.2.2.6 UCMA v2.0のインストール

- 11.2.2.2.7 WebCenter PortalのProxyアプリケーションのインストール

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

12 メールの管理

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

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

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

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

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

- 12.3.2.1 WebCenter PortalのためのMicrosoft Exchange Server 2007、2010または2013の構成

- 12.3.2.1.1 Microsoft Exchange Serverからの証明書の取得

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

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

- 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.7.1 Fusion Middleware Controlを使用したメール接続の削除

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

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

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

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

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

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

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

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

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

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

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

- 13.3.3 コネクションの構成

- 13.3.4 プロファイルの構成

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

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

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

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

- 13.5.1 組込みLDAPの構成例

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

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

14 RSSの管理

- 14.1 RSSについて

- 14.2 RSSの前提条件

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

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

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

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

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

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

- 15.3.1 Oracle SES - インストール

- 15.3.2 Oracle SES - 構成

- 15.3.3 Oracle SES - セキュリティ

- 15.4 Oracle SES接続の設定

- 15.4.1 Oracle SES接続のテスト

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

- 15.4.2.1 Fusion Middleware Controlを使用したOracle SES接続の登録

- 15.4.2.2 WLSTを使用したOracle SES接続の登録

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

- 15.4.3.1 Fusion Middleware Controlを使用したアクティブなOracle SES接続の選択

- 15.4.3.2 WLSTを使用したアクティブなOracle SES接続の設定

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

- 15.4.4.1 Fusion Middleware Controlを使用したOracle SES接続の詳細の変更

- 15.4.4.2 WLSTを使用したOracle SES接続の詳細の変更

- 15.4.5 Oracle SES接続の削除

- 15.4.5.1 Fusion Middleware Controlを使用したOracle SES接続の削除

- 15.4.5.2 WLSTを使用したOracle SES接続の削除

- 15.5 WebCenter Portalを検索するためのOracle SESの構成

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

- 15.5.1.1 WLSTを使用した検索パラメータの構成

- 15.5.1.2 Fusion Middleware Controlを使用した検索パラメータとクローラの構成

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

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

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

- 15.5.4.1 Oracle SES管理ツールへのログオン

- 15.5.4.2 ドキュメントを検索するためのOracle SESの設定

- 15.5.4.3 ディスカッションおよびお知らせを検索するためのOracle SESの設定

- 15.5.4.4 ポータル、リスト、人およびページ・メタデータを検索するためのOracle SESの設定

- 15.5.4.5 スペース・クローラからのコンポーネントの除外

- 15.5.4.6 追加のOracle SES構成

- 15.5.4.7 Oracle SESファセットおよびソート属性の構成

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

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

- 15.6 WebCenter Portal管理での検索の管理

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

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

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

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

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

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

- 16.3 通知の設定

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

- 16.3.2 通知の前提条件

- 16.3.2.1 インストール

- 16.3.2.2 構成

- 16.3.2.3 セキュリティ

- 16.3.2.4 制限事項

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

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

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

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

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

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

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

- 16.5 通知接続のテスト

17 WebCenter Portalメンバーシップ・ワークフローに対するSOA接続の管理

- 17.1 WebCenter Portalワークフローのロードマップの構成

- 17.2 BPEL接続について

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

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

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

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

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

- 17.6 OAMのWebcenter PortalワークフローURLの除外

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

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

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

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

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

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

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

- 18.2.5 WSRPプロデューサの接続パラメータ

- 18.2.6 WSRPプロデューサのセキュリティの接続パラメータ

- 18.2.7 WSRPプロデューサのキーストア接続パラメータ

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

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

- 18.4.1 WSRPプロデューサの登録情報の編集について

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

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

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

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

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

- 18.5 WSRPポートレット・プロデューサの登録解除

- 18.5.1 ポートレット・プロデューサの登録解除について

- 18.5.2 Fusion Middleware Controlを使用したWSRPポートレット・プロデューサの登録解除

- 18.5.3 WLSTを使用したWSRPポートレット・プロデューサの登録解除

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

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

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

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

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

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

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

- 18.7 Oracle PDK-Javaポートレット・プロデューサの管理

- 18.7.1 Oracle PDK-Javaポートレット・プロデューサの登録

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

- 18.7.3 Oracle PDK-Javaポートレット・プロデューサの登録情報の編集

- 18.7.4 Oracle PDK-Javaポートレット・プロデューサの登録解除

- 18.7.5 Oracle PDK-Javaポートレット・プロデューサの接続パラメータ

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

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

- 19.1.1 概要

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

- 19.1.3 WSRPポートレットの公開

- 19.1.4 OpenSocialガジェットの公開

- 19.1.5 WebCenter Interactionポートレットの公開

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

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

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

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

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

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

- 19.3 ページレット・プロデューサでのWSRPポートレット・プロデューサの登録

- 19.4 ポートレットベースのページレットの使用

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

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

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

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

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

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

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

- 19.6.2.1 WLSTを使用したページレット・プロデューサ・メタデータのエクスポート

- 19.6.2.2 WLSTを使用したページレット・プロデューサ・メタデータのインポート

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

21 RESTサービスの管理

- 21.1 RESTサービスについて

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

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

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

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

- 21.4 RESTのルート名の変更

- 21.5 圧縮の使用

- 21.6 認証の処理

第IV部 モニタリング

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

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

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

- 22.1.1.1 メトリック収集: 起動時以降

- 22.1.1.2 メトリック収集: 最近の履歴

- 22.1.1.3 メトリック収集: 最新のN回のサンプル

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

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

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

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

- 22.1.5.1 フル・ページ・メトリックと部分ページ・メトリックの理解

- 22.1.5.2 最近のページ・メトリック

- 22.1.5.3 全ページ・メトリック

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

- 22.1.6.1 最近のポートレット・メトリック

- 22.1.6.2 全ポートレット・プロデューサ・メトリック

- 22.1.6.3 全ポートレット・メトリック

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

- 22.1.7.1 「WebLogic Serverメトリック」セクション

- 22.1.7.2 「最近のCPUおよびメモリー使用状況」セクション

- 22.1.7.3 「最近のセッションおよびスレッド使用状況」セクション

- 22.1.7.4 「最近のJDBC使用状況」セクション

- 22.1.7.5 「ヘルス・メトリック」セクション

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

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

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

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

- 22.1.11.1 すべてのツールとサービスに共通するメトリック

- 22.1.11.2 特定のツールまたはサービス固有のメトリック

- 22.1.11.2.1 お知らせのメトリック

- 22.1.11.2.2 BPELワークリストのメトリック

- 22.1.11.2.3 コンテンツ・リポジトリのメトリック

- 22.1.11.2.4 ディスカッションのメトリック

- 22.1.11.2.5 イベントのメトリック

- 22.1.11.2.6 外部アプリケーションのメトリック

- 22.1.11.2.7 インスタント・メッセージおよびプレゼンス・メトリック

- 22.1.11.2.8 インポートおよびエクスポートのメトリック

- 22.1.11.2.9 リストのメトリック

- 22.1.11.2.10 メールのメトリック

- 22.1.11.2.11 ノートのメトリック

- 22.1.11.2.12 ページ操作のメトリック

- 22.1.11.2.13 ピープル・コネクションのメトリック

- 22.1.11.2.14 RSSニュース・フィードのメトリック

- 22.1.11.2.15 検索のメトリック

- 22.1.11.3 ツールとサービスに関する一般的な問題のトラブルシューティング

- 22.1.11.3.1 お知らせ: 問題およびアクション

- 22.1.11.3.2 コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション

- 22.1.11.3.3 ディスカッション: 問題およびアクション

- 22.1.11.3.4 外部アプリケーション: 問題およびアクション

- 22.1.11.3.5 イベント: 問題およびアクション

- 22.1.11.3.6 インスタント・メッセージおよびプレゼンス: 問題およびアクション

- 22.1.11.3.7 インポートおよびエクスポート: 問題およびアクション

- 22.1.11.3.8 リスト: 問題およびアクション

- 22.1.11.3.9 メール: 問題およびアクション

- 22.1.11.3.10 ノート: 問題およびアクション

- 22.1.11.3.11 ページ・サービス: 問題およびアクション

- 22.1.11.3.12 ポートレットおよびプロデューサ: 問題およびアクション

- 22.1.11.3.13 ピープル・コネクション: 問題およびアクション

- 22.1.11.3.14 RSSニュース・フィード: 問題およびアクション

- 22.1.11.3.15 検索: 問題およびアクション

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

- 22.2.1 WebCenter Portalの最近のパフォーマンス・メトリックのモニタリング

- 22.2.2 ポータル・メトリックのモニタリング

- 22.2.3 WebCenter Portalのページ・メトリックのモニタリング

- 22.2.4 WebCenter Portalのサービス・メトリックのモニタリング

- 22.2.5 メトリック・パレットを通じたすべてのメトリックのモニタリング

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

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

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

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

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

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

- 22.3.6 WebCenter Portalのしきい値および収集オプションの編集

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

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

- 22.6 データ・キャッシング・パフォーマンスの向上

- 22.6.1 Coherenceキャッシュ・タイプのサマリー

- 22.6.2 WebCenter PortalのデフォルトのCoherenceキャッシュ

- 22.6.3 デフォルト構成のオーバーライド

23 Oracle WebCenter Portalログの管理

- 23.1 診断ロギングの概要

- 23.1.1 WebCenter Portal診断ログ

- 23.1.2 Oracle WebCenter PortalのメッセージID

- 23.1.3 Oracle WebCenter Portalパフォーマンス・メトリックの範囲外状態

- 23.1.4 ロガー

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

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

- 23.2.2 WebCenter Portalのエラー・メッセージの表示および構成

24 Oracle WebCenter Portal監査ログの管理

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

- 24.2 監査ログの構成

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

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

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

- 24.3.1 WebCenter Portal監査ログの使用

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

第V部 セキュリティの管理

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

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

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

- 25.2.1 管理者アカウント

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

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

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

- 25.2.4.1 権限ベースの認可

- 25.2.4.2 ロールマッピング・ベースの認可

- 25.2.4.3 WebCenter Portalのデフォルトのポリシー・ストア権限

- 25.2.4.4 デフォルトのコードベース権限

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

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

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

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

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

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

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

- 26.3.2.1 外部LDAPアクセスの有効化

- 26.3.2.2 LDIFファイルの作成

- 26.3.2.3 ユーザーの追加

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

- 26.4.1 外部LDAPを使用するためのディスカッション・サーバーの移行

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- 27.4 資格証明の管理

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

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

- 27.5.1.1 Fusion Middleware Controlを使用したWebCenter Portal管理者ロールの付与

- 27.5.1.2 WLSTを使用したWebCenter Portal管理者ロールの付与

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

- 27.5.2.1 Fusion Middleware Controlを使用したアプリケーション・ロールの付与

- 27.5.2.2 WLSTを使用したアプリケーション・ロールの付与

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

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

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

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

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

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

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

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

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

- 28.2 Oracle Access Managerの構成

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

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

- 28.2.3 OAM 11gのインストールと構成

- 28.2.3.1 OAM 11gのインストールと構成

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

- 28.2.3.3 Web層でのWebGateのインストール

- 28.2.3.4 Webゲート・エージェントの登録

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

- 28.2.4.1 Oracle Internet Directoryオーセンティケータの構成

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

- 28.2.4.3 デフォルト・オーセンティケータとプロバイダの順序の構成

- 28.2.4.4 OAMシングル・サインオン・プロバイダの追加

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

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

- 28.2.6.1 SSO用のWebCenter Portalの構成

- 28.2.6.2 SSO用のディスカッション・サーバーの構成

- 28.2.6.2.1 WebCenter Portal用のディスカッション・サーバー接続の作成

- 28.2.6.3 SSO用のSOAサーバー接続の構成

- 28.2.6.4 外部リーダーを使用したRSSフィード用のOAMの構成

- 28.2.6.5 OAM 11g用のWebLogic Server管理コンソールとEnterprise Managerの構成

- 28.2.6.6 SSO用のSecure Enterprise Searchの構成

- 28.2.6.7 SSO用のContent Serverの構成

- 28.2.6.8 接続フィルタを使用したアクセスの制限

- 28.2.6.9 ポートレット・プロデューサと追加コンポーネントの構成

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

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

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

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

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

- 28.3.2.1.1 SAML SSO用のWebCenter Content Serverの構成

- 28.3.2.1.2 SAML SSO用のディスカッション・サーバーの構成

- 28.3.2.1.3 証明書の構成とエクスポート

- 28.3.2.1.4 SSLの設定

- 28.3.2.2 SAMLベースのSSOの構成

- 28.3.2.2.1 シングル・サインオンのスクリプト

- 28.3.2.2.2 スクリプトの使用

- 28.3.2.3 外部リーダーを使用したRSS用のSAML SSOの構成

- 28.3.2.4 構成のチェック

- 28.3.2.5 SAML SSO構成の無効化

- 28.3.2.6 SAML SSO構成の削除

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

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

- 28.4.2 システム要件

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

- 28.4.3.1 ネゴシエート・アイデンティティ・アサーション・プロバイダの構成

- 28.4.3.2 Active Directory認証プロバイダの構成

- 28.4.3.3 WebCenter Portalの構成

- 28.4.3.4 SSO用のディスカッション・サーバーの構成

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

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

- 28.5.2 OAM 11gでの仮想ホストの構成

29 SSLの構成

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

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

- 29.1.2 カスタム・アイデンティティ・キーストアおよびカスタム信頼キーストアの構成

- 29.1.3 SSL接続の構成

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

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

- 29.2.2 SSL証明書の構成

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

- 29.3.1 ディスカッションのカスタム・キーストアの作成

- 29.3.2 ディスカッションのアイデンティティ・キーストアと信頼キーストアの構成

- 29.3.3 ディスカッションのSSL接続の構成および保護

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

- 29.4.1 ポートレット・プロデューサのカスタム・キーストアの作成

- 29.4.2 ポートレット・プロデューサのアイデンティティ・キーストアと信頼キーストアの構成

- 29.4.3 ポートレット・プロデューサのSSL接続の構成

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

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

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

- 29.5.1.1 OIDでのSSLの有効化

- 29.5.1.2 OID証明書のインポート

- 29.5.1.3 SSL接続の確立

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

- 29.6.1 WebCenter Portal (クライアント)側のキーストアおよびキーの構成

- 29.6.2 コンテンツ・サーバー側のキーストアおよびキーの構成

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

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

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

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

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

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

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

30 Webサービス・セキュリティの構成

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

- 30.1.1 WebCenter Portalドメイン・キーストアの作成

- 30.1.2 SOAドメイン・キーストアの作成

- 30.1.3 ディスカッション・サーバーの構成

- 30.1.3.1 WebCenter PortalおよびディスカッションWebサービス・エンドポイントに対するセキュリティ・ポリシーの添付

- 30.1.3.2 ディスカッション・エンドポイントの保護

- 30.1.3.2.1 Fusion Middleware Controlを使用したディスカッション・サーバー・エンドポイントの保護

- 30.1.3.2.2 WLSTを使用したディスカッション・サーバー・エンドポイントの保護

- 30.1.3.3 ディスカッション・サーバーの接続設定の構成

- 30.2 複数ドメインのWS-Securityの構成

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

- 30.2.2 SOAドメイン・キーストアの作成

- 30.2.3 外部ディスカッション・サーバーの構成

- 30.2.3.1 ディスカッション・サービス・エンドポイントの保護

- 30.2.3.2 ディスカッション・サーバー・キーストアの作成

- 30.2.3.3 ディスカッション・サーバーの接続設定の構成

- 30.2.4 外部ポートレット・ドメイン・キーストアの作成

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

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

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

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

- 30.5 標準トポロジを拡張する場合のJKSコマンド・サマリー

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

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

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

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

- 31.1.3 キーストアの設定

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

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

- 31.2.1.1 Fusion Middleware Controlを使用した共有鍵の定義

- 31.2.1.2 WLSTを使用した共有鍵の定義

- 31.2.1.3 共有鍵へのOracle PDK-Javaプロデューサの登録

32 偽装の管理

- 32.1 WebCenter Portal偽装の概要

- 32.1.1 WebCenter Portal偽装について

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

- 32.2 WebCenter Portalの偽装の準備

- 32.2.1 WebCenter Portal偽装の要件

- 32.2.2 OAMでの偽装の有効化

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

- 32.2.3.1 個々のユーザーに対する偽装属性の追加

- 32.2.3.2 複数のユーザーに対する偽装属性の追加

- 32.3 WebCenter Portalの偽装の構成

- 32.4 偽装者の構成

- 32.5 偽装の無効化

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

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

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

第VI部 WebCenter Portalのライフ・サイクルの管理

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

- 33.1 WebCenter Portalのライフ・サイクルについて。

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

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

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

- 33.2.3 ライフ・サイクルのタスク

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

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

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

- 34.1 ポータルのデプロイ

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

- 34.1.2 WebCenter Portalを使用したポータルの直接デプロイ

- 34.1.2.1 ポータル・サーバー接続の作成

- 34.1.2.2 WebCenter Portalを使用したポータルのデプロイ

- 34.1.2.3 ポータルのデプロイメント履歴の表示

- 34.1.3 WLSTを使用したポータルの直接デプロイ

- 34.1.3.1 手順1: ポータルの直接デプロイメントの前提条件の完了

- 34.1.3.2 手順2: ソース環境でのdeployWebCenterPortalの実行

- 34.1.3.3 手順3: 新たにデプロイしたポータルのターゲット環境での検証

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

- 34.1.4.1 ポータル・アーカイブの理解

- 34.1.4.1.1 接続プロパティ・ファイルの理解

- 34.1.4.2 アーカイブの保護

- 34.1.4.2.1 アーカイブ・ファイルの保護について

- 34.1.4.2.2 アーカイブ・ファイルの保護

- 34.1.4.3 ポータル・アーカイブのエクスポートおよびインポート

- 34.1.4.4 アーカイブへのポータルのエクスポート

- 34.1.4.4.1 ポータルのエクスポートの前提条件

- 34.1.4.4.2 WebCenter Portal管理を使用したオンライン・ポータルのアーカイブへのエクスポート

- 34.1.4.4.3 WLSTを使用したオンライン・ポータルのアーカイブへのエクスポート

- 34.1.4.4.4 REST APIを使用したポータルのエクスポート

- 34.1.4.5 アーカイブからのポータルのインポート

- 34.1.4.5.1 ポータルのインポートの前提条件

- 34.1.4.5.2 WebCenter Portal管理を使用したポータルのアーカイブからのインポート

- 34.1.4.5.3 WLSTを使用したポータルのアーカイブからのインポート

- 34.1.4.5.4 REST APIを使用したポータルのインポート

- 34.1.4.6 ポータル・アーカイブの表示および抽出

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

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

- 34.2.1.1 WebCenter Portalを使用したポータル・テンプレートのアーカイブへのエクスポート

- 34.2.1.2 WLSTを使用したポータル・テンプレートのアーカイブへのエクスポート

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

- 34.2.2.1 WebCenter Portalを使用したポータル・テンプレートのアーカイブからのインポート

- 34.2.2.2 WLSTを使用したポータル・テンプレートのアーカイブからのインポート

- 34.3 アセット、デバイスおよびデバイス・グループのデプロイ

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

- 34.3.1.1 WebCenter Portalからアーカイブへのアセットのエクスポート

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

- 34.3.1.2.1 WebCenter Portalを使用したデバイスおよびデバイス・グループのエクスポート

- 34.3.1.2.2 WLSTを使用したデバイスおよびデバイス・グループのエクスポート

- 34.3.1.3 WLSTを使用したアーカイブへのアセット、デバイスまたはデバイス・グループのエクスポート

- 34.3.1.4 REST APIを使用したアセットのエクスポート

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

- 34.3.2.1 アセットのインポート(またはエクスポート)に必要な権限について

- 34.3.2.2 WebCenter Portalを使用したアセットのアーカイブからのインポート

- 34.3.2.3 WebCenter Portalを使用したデバイスおよびデバイス・グループのインポート

- 34.3.2.4 WLSTを使用したアセットのアーカイブからのインポート

- 34.3.2.5 REST APIを使用したアセットのインポート

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

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

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

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

- 34.6 ポータルのディスカッションとページレット・プロデューサのリソースの移行

- 34.6.1 アーカイブへのポータル・ディスカッションのエクスポート

- 34.6.2 アーカイブからのポータル・ディスカッションのインポート

- 34.7 本番でのポータルの伝播および再デプロイ

- 34.7.1 ポータル伝播の理解

- 34.7.2 WebCenter Portalを使用したポータル変更の伝播

- 34.7.3 WLSTを使用したポータル変更の伝播

- 34.7.4 WebCenter Portalを使用したポータルの再デプロイ

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

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

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

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

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

- 35.3.2 ポータルのディスカッションおよび外部データのバックアップ

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

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

- 35.4.2 ポータルのディスカッションおよび外部データのリストア

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

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

- 35.5.1.1 前提条件

- 35.5.1.2 WebCenter Portalスキーマ・データのバックアップ(エクスポート)

- 35.5.1.3 WebCenter Portalデータのリストア(インポート)

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

- 35.5.2.1 前提条件

- 35.5.2.2 すべてのMDSスキーマ・データのバックアップ(エクスポート)

- 35.5.2.3 MDSスキーマ・データのリストア(インポート)

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

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

- 35.5.4.1 前提条件

- 35.5.4.2 すべてのディスカッション・スキーマ・データのバックアップ(エクスポート)

- 35.5.4.3 ディスカッション・スキーマ・データのリストア(インポート)

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

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

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

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

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

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

- 35.5.10.1 ポートレット・クライアント・メタデータのバックアップ(エクスポート)

- 35.5.10.2 ポートレット・クライアント・メタデータのリストア(インポート)

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

- 35.5.12 分析のメタデータのバックアップおよびリストア

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

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

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

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

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

- 35.6.3.1 Fusion Middleware Controlを使用したWebCenter Portalのエクスポート

- 35.6.3.2 WLSTを使用したWebCenter Portalのエクスポート

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

- 35.6.4.1 Fusion Middleware Controlを使用したWebCenter Portalのインポート

- 35.6.4.2 WLSTを使用したWebCenter Portalのインポート

- 35.6.4.3 インポート後のWebCenter Portalの検証

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

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

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

- 35.8.1.1 master_script.sh

- 35.8.1.2 wlst_script.py

- 35.8.1.3 backup.propertiesファイルおよびrestore.propertiesファイル

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

- 35.8.2.1 バックアップ・スクリプトの作成

- 35.8.2.2 セキュリティ・ストアのバックアップの前提条件タスクの完了

- 35.8.2.3 バックアップ・パラメータの設定およびスクリプトのカスタマイズ

- 35.8.2.4 バックアップ・スクリプトを実行します。

- 35.8.2.5 バックアップ・アーカイブを検証します。

- 35.8.2.6 スクリプトを使用して定期的なバックアップのスケジュールを設定します。

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

- 35.8.3.1 リストア・スクリプトの作成

- 35.8.3.2 手動によるデータベース・スキーマのリストア

- 35.8.3.3 セキュリティ・ストアのリストアの前提条件タスクの完了

- 35.8.3.4 リストア・スクリプトのパラメータを設定します。

- 35.8.3.5 リストア・スクリプトを実行します。

- 35.8.3.6 リストアされたデータの検証

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

第VII部 複数言語ポータルの管理

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

- 36.1 WebCenter Portalの言語について

- 36.1.1 WebCenter Portalによってデフォルトでサポートされる言語

- 36.2 アプリケーション・レベルでの文字列の変更と翻訳

- 36.3 ポータルの文字列の翻訳

- 36.4 ポータルの特定文字列に対する翻訳の変更と追加

- 36.5 WebCenter Portalへの新規言語のサポートの追加

第VIII部 WebCenter Portalでのポータルの管理

37 WebCenter Portal管理の設定ページの理解

- 37.1 WebCenter Portal管理の設定ページについて

- 37.2 WebCenter Portal管理の設定ページへのアクセス

- 37.3 WebCenter Portal管理の設定の使用

38 WebCenter Portal管理のポータル・ページの理解

- 38.1 WebCenter Portal管理のポータル・ページについて

- 38.2 WebCenter Portal管理のポータル・ページへのアクセス

- 38.3 ポータル・リストのソート

- 38.4 ポータルの作成

- 38.5 ポータルのエクスポートおよびインポート

- 38.6 任意のポータルに関する情報の表示

- 38.7 ポータルへのリンクの共有

- 38.8 任意のポータルのクローズ

- 38.9 任意のポータルの再アクティブ化

- 38.10 任意のポータルのオフライン化

- 38.11 任意のポータルの再オンライン化

- 38.12 ポータルの削除

39 ポータル間のグローバルなデフォルト設定の構成

- 39.1 ホーム・ポータルでの名前とロゴのカスタマイズ

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

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

- 39.3.1 WebCenter Portalのスキンの適用

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

- 39.5 コピーライトとプライバシ宣言文のカスタマイズ

- 39.6 オンライン・ヘルプ・リンクのカスタマイズ

- 39.7 デフォルト表示言語の選択

- 39.7.1 言語リストのカスタマイズ

- 39.8 デフォルト・スタート(またはランディング)・ページの選択

- 39.8.1 グループに対するデフォルト開始ページの選択

- 39.8.2 認証済ユーザーに対するデフォルト開始ページの選択

- 39.8.3 パブリック・ユーザーに対するデフォルト開始ページの選択

- 39.9 セッション・タイムアウト設定の指定

- 39.10 自己登録の有効化

- 39.10.1 自己登録について

- 39.10.2 すべてのユーザーの自己登録の有効化

- 39.10.3 招待者限定の自己登録の有効化

- 39.11 新しいページのデフォルトのルック・アンド・フィールの選択

- 39.12 ホーム・ポータルへのアクセスの有効化と無効化

- 39.13 WebCenter Portalツールとサービスのデフォルトの設定

40 ポータル間のセキュリティの管理

- 40.1 WebCenter Portalのセキュリティについて

- 40.2 ユーザーについて

- 40.3 アプリケーション・ロールおよび権限について

- 40.3.1 アプリケーション・ロールについて

- 40.3.1.1 デフォルトのアプリケーション・ロール

- 40.3.1.2 カスタム・アプリケーション・ロール

- 40.3.2 アプリケーションの権限について

- 40.3.2.1 アプリケーション権限の理解

- 40.3.2.2 アプリケーション・ロールへのデフォルトのアプリケーション権限の割当て

- 40.3.2.3 ディスカッション・サーバーのロール・マッピングの理解

- 40.3.2.4 エンタープライズ・グループのロール・マッピングの理解

- 40.4 ポータル内のロールおよび権限について

- 40.5 ユーザーの管理

- 40.5.1 ユーザーの追加と削除

- 40.5.2 アプリケーション・ロールへのユーザー(およびグループ)の割当て

- 40.5.3 異なるアプリケーション・ロールへのユーザーの割当て

- 40.5.4 アプリケーション・ロールの取消し

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

- 40.6.1 アプリケーション・ロールと権限の表示

- 40.6.2 アプリケーション・ロールの定義

- 40.6.3 アプリケーション・ロールの権限の変更

- 40.6.3.1 パブリック・ユーザーへの権限の付与

- 40.6.3.2 認証されたユーザーへの権限の付与

- 40.6.3.3 ポータル作成者への権限の付与

- 40.6.4 アプリケーション・ロールの削除

41 ポータル間のグローバル属性での作業

- 41.1 グローバル属性について

- 41.2 グローバル属性の追加

- 41.3 グローバル属性の編集

- 41.4 グローバル属性の削除

42 システム・ページのカスタマイズ

- 42.1 システム・ページについて

- 42.1.1 組込みシステム・ページについて

- 42.2 すべてのポータルのシステム・ページのカスタマイズ

- 42.2.1 デバイス・グループ用システム・ページのページ・バリアントの作成

- 42.2.2 デバイス・グループ用システム・ページのページ・バリアントの管理

- 42.3 システム・ページのプロパティの設定

- 42.4 システム・ページからのすべてのページ・カスタマイズの削除

43 ビジネス・ロール・ページの管理

- 43.1 ビジネス・ロール・ページについて

- 43.1.1 組込みビジネス・ロール・ページについて

- 43.2 ビジネス・ロール・ページのためのページ作成のデフォルトの設定

- 43.3 ビジネス・ロール・ページの作成

- 43.4 ビジネス・ロール・ページのターゲット・ユーザーの指定

- 43.4.1 カスタム・ビジネス・ロール・ページのアクセス権限の設定

- 43.4.2 カスタム・ビジネス・ロール・ページへのパブリック・アクセス権限の付与

- 43.4.3 シードされたビジネス・ロール・ページのアクセス権限の設定

- 43.5 カスタム・ビジネス・ロール・ページへのアクセス権限の取消し

- 43.6 ビジネス・ロール・ページの表示および非表示

- 43.7 ビジネス・ロール・ページのデフォルトの表示順の設定

- 43.8 ビジネス・ロール・ページの編集

- 43.9 ビジネス・ロール・ページのソースの編集

- 43.10 ビジネス・ロール・ページのコピー

- 43.11 ビジネス・ロール・ページからのすべてのユーザー・カスタマイズの削除

- 43.12 カスタム・ビジネス・ロール・ページの削除

44 個人用ページの管理

- 44.1 個人用ページの管理について

- 44.2 個人用ページのためのアプリケーションレベルのページ作成のデフォルトの設定

- 44.3 ユーザーによる個人用ページの作成の防止

- 44.4 個人用ページへのナビゲーションの提供

- 44.5 個人用ページのアクセス権限の変更

- 44.6 個人用ページの編集

- 44.7 個人用ページのソースの編集

- 44.8 個人用ページのコピー

- 44.9 個人用ページからのすべてのユーザー・カスタマイズの削除

- 44.10 個人用ページの削除

45 デバイス設定の管理

- 45.1 デバイス設定について

- 45.1.1 デバイス設定の概要

- 45.1.2 デバイスとは何か

- 45.1.3 デバイス・グループとは何か

- 45.1.4 その他の関連概念

- 45.1.5 基本的なユースケース: 新しいデバイスのサポートの追加

- 45.1.6 デバイス設定を適用する方法の理解

- 45.2 デバイスの作成および管理

- 45.2.1 新しいデバイスの作成

- 45.2.2 デバイスの編集

- 45.2.3 デバイスのコピー

- 45.2.4 デバイスのリストのフィルタリング

- 45.2.5 デバイスの削除

- 45.3 デバイス・グループの作成および管理

- 45.3.1 デバイス・グループの作成

- 45.3.2 デバイス・グループの編集

- 45.3.3 デバイス・グループのコピー

- 45.3.4 デバイス・グループの表示および非表示

- 45.3.5 デフォルトのデバイス・グループの設定

- 45.3.6 デバイス・グループの順序付け

- 45.3.7 デバイス・グループのフィルタリング

- 45.3.8 デバイス・グループの削除

- 45.4 デバイスおよびデバイス・グループのライフ・サイクルの管理

- 45.4.1 デバイス・グループまたはデバイスのダウンロード

- 45.4.2 デバイス・グループまたはデバイスのアップロード

- 45.5 デバイスのプレビュー

- 45.6 デバイス設定のガイドラインおよびベスト・プラクティス

- 45.7 デバイス属性の検出: サンプル・タスク・フロー

46 タスク・フローのカスタマイズ

- 46.1 アプリケーション・レベルでのタスク・フローのカスタマイズについて

- 46.2 アプリケーション・レベルでのタスク・フローのカスタマイズ

- 46.3 タスク・フローのカスタマイズの削除

47 ポータルの使用状況の分析

- 47.1 分析タスク・フローおよびサービスについて

- 47.2 分析管理ページについて

- 47.3 分析タスク・フローでの作業

- 47.3.1 分析タスク・フローの理解

- 47.3.1.1 WebCenterトラフィック

- 47.3.1.2 ページ・トラフィック(管理者)

- 47.3.1.3 ログイン・メトリック(システム管理者)

- 47.3.1.4 ポータル・トラフィック(システム管理者)

- 47.3.1.5 ポータル・レスポンス時間(システム管理者)

- 47.3.1.6 ポートレット・トラフィック(管理者)

- 47.3.1.7 ポートレット・インスタンス・トラフィック(管理者)

- 47.3.1.8 ポートレット・レスポンス時間(管理者)

- 47.3.1.9 ポートレット・インスタンス・レスポンス時間(管理者)

- 47.3.1.10 検索メトリック

- 47.3.1.11 ドキュメント・メトリック(システム管理者)

- 47.3.1.12 Wikiメトリック(システム管理者)

- 47.3.1.13 ブログ・メトリック(システム管理者)

- 47.3.1.14 ディスカッション・フォーラム・メトリック(システム管理者)

- 47.3.2 分析タスク・フローのページへの追加

- 47.3.3 分析レポートのカスタマイズ

- 47.3.4 分析レポートのパーソナライズ

- 47.3.4.1 レポートの表示オプション

- 47.3.4.2 問合せオプション

- 47.3.5 分析タスク・フローのプロパティの設定

- 47.3.5.1 分析サービス・タスク・フローのプロパティについて

- 47.3.5.2 分析サービス・タスク・フローのパラメータ

付録

A Oracle WebCenter Portalの構成

- A.1 構成ファイル

- A.1.1 adf-config.xmlおよびconnections.xml

- A.1.1.1 MDSのデプロイ後のカスタマイズの確認

- A.1.1.2 MDSカスタマイズが含まれている構成ファイルのエクスポート

- A.1.1.3 構成の競合の処理

- A.1.1.4 adf-config.xmlまたはconnections.xmlのMDSカスタマイズの削除

- A.1.2 web.xml

- A.1.3 webcenter-config.xml

- A.2 クラスタ構成

- A.3 構成ツール

- A.4 コンテンツ・マネージャでのファイル・アップロード・サイズの変更

B WebCenter PortalのOracle HTTP Server構成

- B.1 Oracle HTTP Server構成

- B.1.1 Oracle HTTP Serverを使用するシナリオ

- B.1.2 サンプルのmod_wl_ohs.conf

- B.1.3 OHSの構成

C サード・パーティ製品のサポート

- C.1 サード・パーティ製品のサポート

D WebCenter PortalへのWikiコンテンツの移行

- D.1 WikiドキュメントおよびWikiページの理解

- D.1.1 Wikiドキュメントの理解

- D.1.2 Wikiページの理解

- D.2 ソースWikiアプリケーションからWebCenter Portalへのデータの移行

- D.2.1 WikiコンテンツのインポートのためのWebCenter Portalの準備

- D.2.2 Wikiアプリケーションからコンテンツを抽出するためのカスタムWiki抽出ツールの記述と実行

- D.2.2.1 Wikiコンテンツの抽出と配置

- D.2.2.2 WikiドキュメントのソースHTMLのクリーンアップ

- D.2.2.3 URLのリライト

- D.2.2.4 ExportImportData.xmlドキュメントの構築

- D.2.2.5 アーカイブ・ファイルの構築

- D.2.3 ドキュメント移行ユーティリティを使用したターゲット・ポータルへのアーカイブのインポート

- D.2.3.1 ドキュメント移行ユーティリティの実行に必要なプロパティ

- D.2.3.2 ドキュメント移行ユーティリティを使用したコンテンツの移行

- D.2.3.2.1 プロパティ・ファイルでのドキュメント移行プロパティの指定

- D.2.3.2.2 コマンド行でのドキュメント移行プロパティの指定

- D.2.3.2.3 求められた場合のコマンド行でのドキュメント移行プロパティの指定

- D.2.3.3 追加のログを指定したドキュメント移行ユーティリティの実行

- D.2.4 WebCenter Content Serverのコンテンツに対するWebCenter PortalのWikiページの作成

E FrameworkFoldersへのFolders_gの移行

- E.1 FrameworkFoldersへのFolders_gの移行の理解

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

- E.3 WebCenter Portalデータの移行

- E.3.1 移行ロードマップ

- E.3.2 exportFoldersGDataの実行による移行前データの生成

- E.3.3 FrameworkFoldersへのWebCenter Portalメタデータの移行

- E.3.4 migrateFoldersGDataToFrameworkFoldersの実行による移行したデータの検証

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

F Oracle WebCenter Portalのトラブルシューティング

- F.1 My Oracle Supportを使用したその他のトラブルシューティング情報

- F.2 Oracle WebCenter Portalの構成に関する問題のトラブルシューティング

- F.2.1 使用不可の構成オプション

- F.2.2 ログは開いているファイルが多すぎることを示している

- F.3 Oracle WebCenter Portal WLSTコマンドの問題のトラブルシューティング

- F.3.1 Oracle WebCenter Portal WLSTのどのコマンドも機能しない

- F.3.2 WLSTコマンドが特定のツールまたはサービスに対して機能しない

- F.3.3 指定された接続名がすでに存在している

- F.3.4 WLSTシェルがWebLogic Serverに接続されない

- F.3.5 同じ名前の複数のアプリケーションがドメインにすでに存在している

- F.3.6 同じ名前の複数のアプリケーションが管理対象サーバーにすでに存在している

- F.3.7 ドメイン・ランタイム・ツリーにすでにメッセージが表示される

- F.4 Oracle WebCenter Portalのパフォーマンスに関する問題のトラブルシューティング

- F.4.1 パフォーマンスのモニタリングとトラブルシューティング・ツールについて

- F.4.2 表示の遅いページを特定する方法

- F.4.3 表示の遅いページのコンポーネントを特定する方法

- F.4.3.1 Portal Page Performance Analyzerについて

- F.4.3.2 ポータル・ページのパフォーマンス分析の有効化および無効化

- F.4.3.3 現在のセッションのページ・タイミング情報の表示および非表示

- F.4.3.4 Page Performance Analyzerを使用したパフォーマンスの問題のトラブルシューティング

- F.4.4 表示の遅いページ・リクエストをトラブルシューティングする方法

- F.4.4.1 ライブ・リクエストのトラブルシューティング

- F.4.4.2 スタック・スレッドのトラブルシューティング

- F.4.4.3 JFR記録を使用した遅いリクエストのトラブルシューティング

- F.4.4.4 メモリー・リークとヒープ使用量問題のトラブルシューティング

- F.4.4.5 コンテンツに対する遅いリクエストのトラブルシューティング

- F.4.5 JRockitフライト記録を使用してリクエストをトラブルシューティングする方法

- F.5 WebCenter Portalワークフローのトラブルシューティング

- F.5.1 電子メール通知が動作しない

- F.5.2 WebCenter Portalワークフローの構成の検証

- F.5.3 WebCenter Portalワークフローの問題のトラブルシューティング

- F.6 WebCenter Portalのインポートおよびエクスポートのトラブルシューティング

- F.6.1 ResourceLimitExceptionの問題

- F.6.2 LockRefreshTaskの問題

- F.6.3 ポータルおよびポータル・テンプレートがインポート後に使用できない

- F.6.4 ソース・アプリケーションとターゲット・アプリケーションが同じContent Serverを共有している場合は、ポータルまたはドキュメントを移行できない

- F.6.5 接続の作成時にターゲット・ポータル・サーバーが使用不可として表示される

- F.7 個別のポータルとポータル・テンプレートのインポートおよびエクスポートのトラブルシューティング

- F.7.1 エクスポートまたはインポートの失敗後にポータルがブロックされる

- F.7.2 インポート後にページまたはポータルが見つからないというメッセージが表示される

- F.7.3 ポータル・インポート・アーカイブが最大ファイル・アップロード・サイズを超えている

- F.7.4 エクスポート時にポータルの最大数を超える

- F.7.5 リストが適切にインポートされない

- F.7.6 ツールとサービスが構成されているポータルのエクスポートおよびインポート

- F.7.7 インポート後にツールとサービスが無効化される

- F.7.8 サブポータル・ページからのインポート

- F.7.9 ソース・アプリケーションとターゲット・アプリケーションが同じContent Serverを共有している場合は、ポータルをインポートできない

- F.7.10 共有ライブラリの変更がポータルのデプロイメント後に使用できない

- F.7.11 インポートしたポータルにメンバーが表示されない

- F.7.12 ブラウザ・ロケールでデプロイメント・メッセージが表示されない

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

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

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

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

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

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

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

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

- F.8.8 Microsoft Exchangeでのパスワードの変更

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

- F.9.1 認証の失敗

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

- F.9.3 ログイン失敗

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

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

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

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

- F.9.8 「お知らせ」ページで「ユーザーは認可されていません。」と表示される

- F.9.9 「ディスカッション」ページで「ユーザーは認可されていません。」と表示される

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

- F.11 ユーザーおよびロールに関する問題のトラブルシューティング

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

- F.12.1 WebCenter Portalで使用できないドキュメント・ツール

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

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

- F.14.1 検索結果が見つからない

- F.14.1.1 Oracle SES接続

- F.14.1.2 ドキュメントとディスカッションの接続

- F.14.1.3 WebCenter Portalのクロール構成

- F.14.1.4 Oracle SES構成

- F.14.1.5 ユーザー認証

- F.14.1.6 Oracle SESのクロール

- F.14.1.7 Oracle SESの認可

- F.14.2 検索失敗のエラー

- F.14.3 WebCenter Portalにview権限を付与できない

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

はじめに

『Oracle WebCenter Portalの管理』へようこそ。

このガイドでは、WebCenter Portalコンポーネントの起動、停止および構成方法、バックエンド・サーバーとセキュリティの構成方法、パフォーマンスのモニター方法、ポータル・デプロイメントとサービスのバックアップ、リカバリおよび移行方法など、Oracle WebCenter Portalを管理する方法について説明します。

対象読者

このドキュメントは、Oracle WebCenter Portalのインストールを担当するシステム管理者を対象としています。これらのロールおよびその他のWebCenter Portalの人物の詳細は、「登場人物リスト」を参照してください。

このガイドでは、読者が『Oracle Fusion Middlewareの管理』に記述された概念および内容について理解していることを前提としています。

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

Oracleのアクセシビリティへの取り組みについては、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を参照してください。

関連ドキュメント

詳細は、Oracle Fusion Middleware 12c (12.2.1.1)ドキュメンテーション・セットの次のドキュメントを参照してください。

- 『Oracle Fusion Middlewareの管理』

- Oracle WebCenter Portalのインストールおよび構成

- Oracle WebCenter Portalの使用

- Oracle WebCenter Portalによるポータルの作成

- Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発

- WebCenter WLSTコマンド・リファレンス

表記規則

このマニュアルでは次の表記規則を使用します。

表記規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

登場人物リスト

WebCenter Portalドキュメントは、特定のガイドのタスクが特定の仮想の人物に対応するように整理されています。各人物は、 WebCenter Portalで作業をするのに必要なスキルのセット(基礎的なスキルから高度なスキルまで)に関連付けられています。たとえば、このガイドは、システム管理者という人物を対象としています。

この章では、WebCenter Portalの人物を紹介し、それぞれどのようにWebCenter Portalを利用する場合があるかを説明します。各人物には、WebCenter Portalで提供されるすぐに使用できるデフォルトのロールが割り当てられています。デフォルトのロールには、その人物が実行する典型的な業務に適する一意の権限セットが付与されています。これらのデフォルトのロールを変更したり、組織独自のニーズに合うように新しいロールを構成することができることに注意してください。

通常、WebCenter Portalを操作する人は、次の人物で構成されたチームとして連携して作業を行います。

- ナレッジ・ワーカー

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

- Web開発者

- 開発者

- システム管理者

ナレッジ・ワーカー

Karenは、通常、WebCenter Portalを使用して、コンテンツの提供やレビュー、ソーシャル・ネットワークへの参加、ホーム・ポータルを利用した独自のドキュメントやプロファイルの管理を行っているナレッジ・ワーカーです。

アプリケーション・レベルでのKarenの権限は、デフォルトのAuthenticated-Userロールに付与されるような権限になります。このロールは、組織に固有のニーズに応じてカスタマイズされることがあります。ポータル・レベルでは、ポータル・マネージャは、「ページの表示」権限と「ページのカスタマイズ」権限を持つロールをKarenに割り当てます。

ロールおよび権限の詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルのロールおよび権限に関する項を参照してください。

WebCenter Portalでのナレッジ・ワーカーのタスク

次に、Karenのようなナレッジ・ワーカーの一般的なタスクを示します。

- コンテンツ・コントリビューション権限が割り当てられているページの編集および更新

- 情報、ファイルおよびリンクを共有し、インスタント・メッセージ、メール、メッセージ・ボード、ディスカッション、Wikiおよびブログを通してやり取りすることによる、他のWebCenter Portalユーザーとの接続および共同作業

- Content Serverに格納されるドキュメントのアップロード、共有および管理

- チームまたはプロジェクト・ポータルへの参加

- コンテンツ更新時の通知の受信、メンバーになっているポータルおよび接続しているユーザーのアクティビティの表示、お知らせの表示、ディスカッションの参加、およびWebCenter Portal RSSフィードのモニタリングにより、WebCenter Portal内の変更に関する最新動向の把握

- お気に入り、ノート、カレンダ、リスト、ポータル・オブジェクトへのリンク、およびタグを使用することによる整理された状態の維持

KarenがWebCenter Portalで使用可能な機能により習熟するにしたがって、ポータルの作成など、より高度なタスクを実行するようになる可能性があります。より高度なナレッジ・ワーカーとして、彼女の役割はアプリケーション・スペシャリストのタスクと重複するようになります。

Karenのようなナレッジ・ワーカーを対象にした情報は、『Oracle WebCenter Portalの使用』に記載されています。アプリケーション・スペシャリストのタスクと重複する高度なタスクの説明は、『Oracle WebCenter Portalでのポータルの構築』に記載されています。

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

Ariは、WebCenter Portalで作業し、ポータルとその構造(ページ階層、ナビゲーション、セキュリティ)およびそのコンテンツ(ページ上のコンポーネント、レイアウト、動作など)を作成および管理するアプリケーション・スペシャリストです。一般的なプロジェクトでは、Ariは、Karen (ナレッジ・ワーカー)、Wendy (Web開発者)、およびDave (開発者)の成果物を統合します。

アプリケーション・レベルでのAriの権限は、デフォルトのApplication Specialistロールに付与されるような権限になります。このロールは、組織に固有のニーズに応じてカスタマイズされていることがあります。自分で作成したポータルで、AriはPortal Managerロールで可能なアクションを実行し、ポータルを管理します。

ロールおよび権限の詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルのロールおよび権限に関する項を参照してください。

WebCenter Portalでのアプリケーション・スペシャリストのタスク

次に、Ariのようなアプリケーション・スペシャリストの一般的なタスクを示します。

- 新しいポータルの計画および作成

- 所有するポータルの編集および管理

- ページ・コンポーネントの追加および構成にページ・エディタ(コンポーザ)およびリソース・カタログを使用した、ポータル・ページの作成および構築

- ポータル・アセット、ツールとサービスの作成および管理

- すべてのポータルに渡る共有アセットおよびポータル・テンプレートの管理

Ariのようなアプリケーション・スペシャリストを対象にした情報は、『Oracle WebCenter Portalでのポータルの構築』に記載されています。ホーム・ポータルの個人用ビューを操作する場合、Ariは『Oracle WebCenter Portalの使用』も参照します。

Web開発者

Wendyは、すべてのポータルに一貫した、ブランディングされたルック・アンド・フィールを提供することに重点的に取り組むWeb開発者です。Wendyは、グラフィック・デザインとHTMLマークアップを提供し、これによりAri (WebCenter Portalでのアプリケーション・スペシャリスト)またはDave (JDeveloperでの開発者)はコンテンツまたはページ・スタイル・テンプレート、スキンなどを作成できます。これらのアセットが作成されると、Ariはこれらを利用してポータル・ページを作成できます。通常、WendyはWebCenter Portalと直接やり取りすることはありません。

WebCenter PortalでのWeb開発者のタスク

次に、WendyのようなWeb開発者の一般的なタスクを示します。

- 企業ポータルのルック・アンド・フィールの開発

- 新しいポータル・ページ・テンプレートの設計

WendyのようなWeb開発者を対象にした情報は、『Oracle WebCenter Portalでのポータルの構築』のポータルのルック・アンド・フィールの作成に関する項に記載されています。

開発者

Daveは、主にコンポーネント(タスク・フロー、ページ・テンプレート、コンテンツ・テンプレートなど)の開発を担当する開発者です。これらは、Ari (アプリケーション・スペシャリスト)によって公開および利用されます。DaveはJDeveloperで作業し、WebCenter Portalで使用するアセットを開発および拡張します。

開発者のタスク

次に、Daveのような開発者の一般的なタスクを示します。

- カスタム・アセット(WebCenter Portalのポータル用のページ・テンプレートやリソース・カタログなど)の開発

- Javaポートレットの開発

- タスク・フロー、マネージドBean、およびその他のコンポーネントを開発してデプロイします。

- カスタムのパーソナライズ・コンポーネントを開発します。

- ソース・コントロール システムをメンテナンスします。

- ビルド・システムをメンテナンスします。

Daveのような開発者を対象にした情報は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』に記載されています。

システム管理者

Syedは、システム管理者です。システム管理者は、IT担当者やビジネス・ユーザーからの要求に応じて新しいマシンを設定し、既存のアプリケーションのシステムとデータベースをクローニングまたはバックアップします。また、パッチ、パッケージおよびアプリケーションをインストールし、その他の管理に関連する作業を実行します。Syedはシステム管理者として、別のツール(Fusion Middleware Controlやコマンド行ツールなど)を使用します。Enterprise Managerを利用してポータル設定を構成し、WebCenter Contentやその他のFusion Middleware製品およびOracleアプリケーションなどの統合も構成します。

WebCenter Portalでは、デフォルトのAdministratorロールに付与されるような権限を持ちます。これは、すべてのポータル(ホーム・ポータルを含む)のグローバル・オプションを管理および設定するための排他的アクセスを提供します。

アプリケーションレベルのロールおよび権限の詳細は、「アプリケーション・ロールおよび権限について」を参照してください。

システム管理者のタスク

次に、Syedのようなシステム管理者の一般的なタスクを示します。

- WebCenter Portal管理を使用して、すべてのポータル(ポータルのインポートとエクスポートを含む)およびサイト全体のセキュリティを管理します

- WebCenter Portal管理を使用して、サイト全体のシステム・ページ、ビジネス・ロール・ページおよび個人ページを管理します

- セキュリティ、分類、メタデータ、ワークフロー、ガバナンスを主導します。

- 管理機能の管理コンソールを使用します。

- 管理機能のコマンド行ユーティリティを実行します。

- 開発者の成果物の本番バージョンをインストールおよび構成します。

- 本番バージョンおよびオペレーティング・システムにパッチを適用します。

- 本番バージョンのクローンおよびバックアップを作成します。

- 本番バージョンのリストアを実行します。

- 本番バージョンに関する問題についてオペレーティング・システムをモニターします。

- アプリケーションをデプロイおよび再デプロイします。

Syedのようなシステム管理者を対象とした情報は、このマニュアルおよびWebCenter WLSTコマンド・リファレンスに記載されています。

第I部 Oracle WebCenter Portalの概要

『Oracle WebCenter Portalの管理』のこの部では、Oracle WebCenter Portalとその管理ツールの概要について説明します。

- Oracle WebCenter Portalの管理の概要

1 Oracle WebCenter Portalの管理の概要

この章では、Oracle WebCenter Portalおよび管理ツールの概要を示します。

この章の内容は次のとおりです。

- Oracle WebCenter Portalの概要

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

- Oracle WebCenter Portalのトポロジ

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

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

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

- セキュリティの理解

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

- Oracle WebCenter Portalの管理ツール

1.1 Oracle WebCenter Portalの概要

Oracle WebCenter Portalへようこそ。

企業ではOracle WebCenter Portalを使用して、Oracle Fusion MiddlewareおよびOracle Fusion Applicationsに次世代のユーザー・エクスペリエンス(UX)の基盤を提供する、エンタープライズ規模のイントラネットおよびエクストラネット・ポータルを構築します。通常、Oracle WebCenter Portalを使用して構築されたポータルでは、何千ものユーザーによる、複数のバックエンド・ソースからのコンテンツおよびデータの作成、更新およびアクセスがサポートされます。WebCenter Portalは、主要ポータル製品と関連テクノロジーの豊富なポートフォリオから最高のUX機能を利用して、直観的なユーザー・エクスペリエンスを提供します。ユーザーの観点から見た場合、統合はシームレスです。

WebCenter Portalの詳細な概要については、『Oracle WebCenter Portalの使用』のOracle WebCenter Portalの概要説明の項を参照してください。

この項では、WebCenter Portalのコンポーネントおよびアーキテクチャについて説明し、次のトピックで構成されています。

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

- Oracle WebCenter Portalのトポロジ

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

Oracle WebCenter Portalは次のコンポーネントで構成されています。

- WebCenter Portal Framework

- Application Development Framework

- ポータル・コンポーザ

- ツールとサービス

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

- 分析

1.2.1 WebCenter Portal Framework

次のものを含むポータル機能をADFに挿入します。

- ランタイム・アプリケーションのカスタマイズ(アプリケーションを再デプロイせずに、ポータル・コンポーザを使用してWebCenter Portalを即時変更できます)

- JSR-168およびJSR-286標準ベースのWSRPポートレットのサポート

- 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 ポータル・コンポーザ

ポータル・コンポーザは、WebCenter Portalのブラウザ・ベースの作成、編集および管理のすべての領域を含みます。

- エンタープライズ・ポータル、複数のサイトおよびコミュニティを作成するためのブラウザ・ベースのプラットフォーム。

- ホーム・ポータルとは、ユーザーが自分のプロファイル、使用可能なポータル、ポータル・テンプレートおよびドキュメントへのアクセス権を持つ場所であり、ホーム・ポータルの独自のビューの特定の要素をカスタマイズできます。

- 実行時にポータルをカスタマイズでき、ポータルの設定変更や、ポータル・ページおよびデバイス対応のページ・バリアントを作成できる、ブラウザ・ベースのポータル・エディタです。直観的なページ・エディタでページ・レイアウトやプロパティ、配線を変更することができ、タスク・フロー、ポートレット、スレッド・ディスカッション、ブログ、Wiki、お知らせ、RSS、アクティビティ・ストリーム、検索およびその他のコンポーネントが含まれます。

1.2.4 ツールとサービス

表1-1に、WebCenter Portalで使用可能なツールとサービスを示します。

表1-1 WebCenter Portalのツールとサービス

A - I

L - T

アクティビティ・ストリーム

リンク

分析

リスト

お知らせ

メール

ディスカッション

ノート

ドキュメント(Wikiおよびブログを含む)

ピープル・コネクション

イベント

RSS

インスタント・メッセージおよびプレゼンス(IMP)

検索

タグ

WebCenter Portalのツールとサービスは、次のものを提供します。

- エンタープライズレベルのサービスとのシームレスな統合

- バックエンド・サービスを抽象化するシン・アダプタ・レイヤー。例:

- コンテンツ・アダプタ: Content Server

- プレゼンス・アダプタ: Microsoft Lync

- 統合された接続アーキテクチャによって表されるバックエンド・システム

- 機能豊富なタスク・フロー・コンポーネントによって提示されるサービスへのユーザー・インタフェース

詳細は、「ツールおよびサービスの管理」を参照してください。

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

ディスカッション・サーバーは、Oracle WebCenter Portalとともに提供されるため、ポータルにディスカッション・フォーラムおよびお知らせを統合できます。詳細は、「お知らせおよびディスカッションの管理」を参照してください。

1.2.6 分析

WebCenter Portalの分析機能により、ユーザーは、次のような様々なユーザー・アクティビティを表示できます。

- ログイン・データ

- ページ・ビュー

- ポートレット・ビュー

- 検索メトリック

- ページ・レスポンス・データ

- ポータルの使用状況

詳細は、「分析の管理」を参照してください。

1.3 Oracle WebCenter Portalのトポロジ

この項では、Oracle WebCenter Portalのトポロジおよび構成について説明します。この項の内容は次のとおりです。

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

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

- Oracle WebCenter Portalの起動順序

- Oracle WebCenter Portalの依存性

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

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

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

- 分析に関する考慮事項

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

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

Oracle WebCenter Portalのインストールにより、Oracleホーム・ディレクトリの下にWebCenter Portal製品ホーム・ディレクトリ(wcportal)が作成され、WebCenter Portalのバイナリとサポート・ファイルが格納されます(図1-1)。

図1-1 Oracle WebCenter Portalのインストールのディレクトリ構造

また、インストールによって、様々なWebCenter Portalコンポーネントをホストする管理サーバーおよび複数の管理対象サーバーを含むWebCenter Portalドメイン(デフォルト名はbase_domain)も作成されます。図1-2では、アプリケーションは黄色で表示され、それらが実行される管理対象サーバーは茶色で表示されます。

図1-2 初期設定のWebCenter Portalトポロジ

初期設定の管理対象サーバーは、次のOracle WebCenter Portalコンポーネントをホストします。

- WC_Portal: WebCenter Portal (Oracleの初期設定のポータル・アプリケーション)および分析をホストします

- WC_Portlet: 初期設定のポートレット、ページレット・プロデューサおよびWebCenter Portalツールをホストします

- WC_Collaboration: ディスカッション・サーバーおよび統合のために選択した追加のサービスをホストします

管理対象サーバーの詳細は、『Oracle Fusion Middlewareの管理』のOracle Fusion Middlewareの理解に関する項を参照してください。

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

Oracle WebCenter Portalのインストール時に、管理対象サーバーは、システム・ライブラリおよびOracle ADFライブラリでプロビジョニングされます。表1-2に、管理対象サーバー、およびそれらで実行するアプリケーションをリストします。

表1-2 Oracle WebCenter Portal管理対象サーバーおよびアプリケーション

管理対象サーバー

インストールされるアプリケーション

アプリケーション名

WC_Portal

WebCenter Portal

WebCenter Portalオンライン・ヘルプ

分析

webcenter

webcenter-help

analytics-collector

WC_Portlet

OmniPortlet

WSRPツール

ページレット・プロデューサ

portalTools

wsrp-tools

pagelet-producer

WC_Collaboration

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

owc_discussions

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アプリケーション。

起動順序は、依存の順序でもあります。依存するコンポーネントが正常にデプロイされない場合は、後のコンポーネントが正しく機能しない可能性があります。

アプリケーションの起動は、ディスカッション・サーバーまたは他のバックエンド・サーバーなどの外部サービスが使用可能かどうかには依存しません。詳細は、「Oracle WebCenter Portalの依存性」を参照してください。

1.3.4 Oracle WebCenter Portalの依存性

WebCenter Portalは、複数の外部サーバー、ツールおよびサービスを使用します(表1-3)。「構成」列に、接続を構成または初期化するためにWebCenter Portalに提供される情報のタイプをリストします。「アクセス」列には、サービスの実行時アクセスで使用されるプロトコルの一覧を示します。

表1-3 依存するリソース - アクセス・タイプ

外部サーバー、ツールまたはサービス

構成

アクセス

分析

分析コレクタへのUDPアクセス

UDP

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

ディスカッション・サーバー管理へのHTTPアクセス

SOAP/HTTP

Content Server

管理サーバーへのソケット接続。WebCenter Portalの外側にあるContent Serverへのアクセスが必要な場合にのみ、HTTPアクセスが必要になります。

ソケットまたはHTTP

インスタント・メッセージおよびプレゼンス・サーバー

インスタント・メッセージおよびプレゼンス・サーバー管理へのHTTPアクセス

SOAP/HTTP

メール・サーバー

IMAP/SMTPサーバー

IMAP/SMTP

個人イベント・サーバー

カレンダ・サービスへのHTTPアクセス

SOAP/HTTP

ポートレット

プロバイダWSDLのHTTPロケーション

SOAP/HTTP

検索サーバー

検索サーバーへのHTTPアクセス

HTTP

SOAサーバー接続

BPELサーバーへのHTTPアクセス

SOAP/HTTP

MDSおよびスキーマ

JDBC

JDBC

サーバーまたはサービスが利用できないときでも、WebCenter Portalの起動は可能ですが、アプリケーションの実行時にエラーが表示される場合があります。唯一の例外は、Oracle Metadata Services Repository (MDS)であり、MDSがない場合は、WebCenter Portalが機能しなくなります。

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

WebCenter Portalの主な構成ファイルを表1-4に示します。これらのファイルは、アプリケーションのデプロイメントの.EARファイル内で供給されます。

表1-4 WebCenter Portalの構成ファイル

アーティファクト

用途

adf-config.xml

WebCenter Portalがどのディスカッション・サーバーまたはメール・サーバーを現在使用しているかなど、Application Development Framework (ADF)およびアプリケーションの設定に関する基本構成を格納します。

connections.xml

外部サービスへの接続のための基本構成を格納します。

WebCenter Portalは、構成データを格納するためにOracle Metadata Services (MDS)リポジトリを使用し、Oracle WebLogicフレームワーク内のJDBCデータ・ソースとしてMDSリポジトリにアクセスします。

MDSリポジトリは、アプリケーションのカスタマイズとして、WebCenter Portalへのデプロイ後の構成変更を格納します。MDSは、デプロイされた元バージョンのadf-config.xmlおよびconnections.xmlをベース・ドキュメントとして使用し、単一のカスタマイズ・レイヤーを使用して後続のすべてのアプリケーション・カスタマイズを別個にMDSに格納します。

WebCenter Portalが起動すると、MDSに格納されているアプリケーション・カスタマイズが適切なベース・ドキュメントに適用され、アプリケーションは、マージ済ドキュメント(カスタマイズが適用されたベース・ドキュメント)を構成プロパティの最終セットとして使用します。

サーバー・クラスタにデプロイされるアプリケーションの場合、クラスタのすべてのメンバーは、MDSリポジトリ内の同じ場所から読み取ります。

Oracleはデプロイ後構成のための複数の管理ツールを提供するため、一般には、管理者は、adf-config.xmlおよびconnections.xmlなどのファイルのためにベース・ドキュメントのコンテンツ(またはMDSカスタマイズ・データ)を調べたり手動で変更したりする必要はありません。ベース・ドキュメントの場所を特定する必要がある場合や、MDS内の情報を確認する必要がある場合は、「Oracle WebCenter Portalの構成」を参照してください。

利用可能な構成ツールの詳細は、「Oracle WebCenter Portalの管理ツール」を参照してください。

注意:

構成ミスをもたらす可能性があるため、adf-config.xmlまたはconnections.xmlを手動で編集することはお薦めしません。

WebCenter Portalは、デプロイ後の構成情報をMDSに格納しますが、ポートレット・プロデューサおよびディスカッション・サーバーのための構成情報は、ファイル・システムまたはデータベースに格納されます(表1-5)。

表1-5 WebCenter Portalの構成の場所

アプリケーション

構成情報の格納場所がMDS

構成情報の格納場所がファイル・システム

構成情報の格納場所がデータベース

WebCenter Portal

はい

いいえ

いいえ

ポートレット・プロデューサ

いいえ

はい

いいえ

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

いいえ

はい

はい

1.3.6 ディスカッション・サーバーの構成

Oracle WebCenter Portalのディスカッション・サーバーは、構成情報をそのデータベースに格納します。また、起動構成情報をDOMAIN_HOME/config/fmwconfig/servers/WC_COLLABORATION/owc_discussionsに格納します。このディレクトリには、jive_startup.xml、jive.licenseファイル、およびディスカッション・サーバー・インスタンスのためのログ・ファイルを含むlogsディレクトリが含まれます。

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

WebCenter PortalはJ2EEアプリケーションとして実行され、アプリケーションの状態と構成はMDSリポジトリに永続的に残ります。アプリケーション内のユーザー・セッション情報は、ローカルでメモリーに保持されます。クラスタ環境では、この状態は、クラスタの他のメンバーにレプリケートされます。

ポートレットまたはサービス環境内のアプリケーション・カスタマイズは、そのサービスによって存続します。初期設定では、Oracleポートレット、構築した任意のカスタム・ポートレット、およびディスカッション・サーバーには、すべて、それら固有のデータベース永続性メカニズムがあります。

1.3.8 分析に関する考慮事項

WebCenter Portalの分析機能には、状態はありません。分析コレクタによって受け取られた要求は、すぐに実行されます。WebCenter Portalによって開始される要求、または分析コレクタによって処理される要求など、転送中の状態は保証されません。

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

WebCenter Portal、ポートレット・プロデューサ、ディスカッション・サーバーなどで実行される操作は、アプリケーションを実行しているWebLogic管理対象サーバーに直接ログ記録されます。

DOMAIN_HOME/servers/Server_Name/logs/Server_Name-diagnostic.log

たとえば、WebCenter Portalの診断は、/base_domain/servers/WC_Portal/logs/WC_Portal-diagnostic.logにログ記録されます

各WebLogic管理対象サーバーのログ・ファイルは、Oracle WebLogic Server管理コンソールから表示できます。ログを表示するには、Oracle WebLogic Server管理コンソールhttp://<admin_server_host>:<port>/consoleにアクセスし、診断ログ・ファイルをクリックします。

Fusion Middleware Controlから診断ログを表示および構成することもできます。「ログ情報の表示および構成」を参照してください。

1.4 Oracle WebCenter Portalのインストールの理解

WebCenter Portalのインストールには、多少の計画が必要です。考慮する質問の一部には、次のものがあります。

- どのOracle WebCenter Portalコンポーネントを使用しますか。

- 何人のユーザーがこのデプロイメントにアクセスしますか。

- エンタープライズ・デプロイメントのためにどのように高可用性を提供できますか。

- WebCenter Portalをどのように保護できますか。

Oracle WebCenter Portalのインストールおよびインストール後の管理タスクの詳細は、『Oracle WebCenter Portalのインストールおよび構成』を参照してください。

インストール後のエンタープライズ構成は、『Oracle WebCenter Portalエンタープライズ・デプロイメント・ガイド』を参照してください。

インストール後の高可用性構成は、『高可用性ガイド』を参照してください。

インストール後のセキュリティ構成は、「デプロイ後のセキュリティ構成タスク」を参照してください。

初期設定のトポロジは、「Oracle WebCenter Portalのトポロジ」で簡単に説明しています。トポロジの特定の領域は対応する各章で説明しており、たとえば、セキュリティ関連の側面は「Oracle WebCenter Portalセキュリティの管理」で説明しています。

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

Oracle WebCenter Portalは、WebCenter Portalのデプロイ、構成、起動と停止、および維持のための複数の異なるツールを提供します。これらすべてのツールは、「Oracle WebCenter Portalの管理ツール」で説明しています。

実行できる管理タスクは、割り当てられているOracle WebLogic Serverロール(Admin、OperatorまたはMonitor)によって異なります。表1-6に、一般的な操作のために必要なOracle WebLogic Serverロールをリストします。これらのロールは、操作がFusion Middleware Control、WLSTコマンドまたはWebLogic Server管理コンソールを介して実行されるかどうかに該当します。

表1-6 WebCenterポータルの操作およびOracle WebLogic Serverロール

操作

Adminロール

Operatorロール

Monitorロール

WebCenter Portal

起動および停止

はい

はい

いいえ

パフォーマンス・メトリックの表示

はい

はい

はい

ログ情報の表示

はい

はい

はい

ログ・ファイルの構成

はい

はい

はい

構成の表示

はい

はい

はい

新しい接続の構成

はい

はい

いいえ

接続の編集

はい

はい

いいえ

接続の削除

はい

はい

いいえ

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

はい

いいえ

いいえ

セキュリティの構成

はい

いいえ

いいえ

セキュリティの表示(アプリケーション・ロール/ポリシー)

はい

はい

はい

WebCenter Portalのみ

アプリケーション全体のエクスポート

はい

いいえ

いいえ

アプリケーション全体のインポート

はい

いいえ

いいえ

表1-7に、WebCenter Portalに関連する様々な管理操作を実行するために使用できるツールをまとめています。WebCenter Portalロールベースのセキュリティの詳細は、「ポータル間のセキュリティの管理」を参照してください。

表1-7 WebCenter Portalの操作および管理ツール

操作

Fusion Middleware Control

WLSTコマンド

WebLogic Server管理コンソール

WebCenter Portal管理

WebCenter Portal

起動および停止

はい

はい

はい

いいえ

パフォーマンス・メトリックの表示

はい

いいえ

いいえ

いいえ

ログ情報の表示

はい

いいえ

いいえ

いいえ

ログ・ファイルの構成

はい

いいえ

いいえ

いいえ

構成の表示

はい

はい

いいえ

いいえ

新しい接続の構成

はい

はい

いいえ

いいえ

接続の編集

はい

はい

いいえ

いいえ

接続の削除

はい

はい

いいえ

いいえ

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

はい

はい

いいえ

はい

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

はい

はい

いいえ

はい

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

はい

はい

はい

いいえ

セキュリティの構成

はい

はい

はい

いいえ

WebCenter Portalのみ

ワークフローの構成

はい

はい

いいえ

いいえ

アプリケーション全体のエクスポート

はい

はい

いいえ

いいえ

アプリケーション全体のインポート

はい

はい

いいえ

いいえ

WebCenter Portalのカスタマイズ

いいえ

いいえ

いいえ

はい

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

いいえ

いいえ

いいえ

はい

ページの管理

いいえ

いいえ

いいえ

はい

ポータルの管理

いいえ

いいえ

いいえ

はい

ポータルのエクスポート

いいえ

いいえ

いいえ

はい

ポータルのインポート

いいえ

いいえ

いいえ

はい

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

パフォーマンスのモニタリングにより、管理者は、環境内の問題およびパフォーマンスのボトルネックを識別できます。「Oracle WebCenter Portalのパフォーマンスのモニタリング」では、WebCenter Portalで使用できるパフォーマンス・メトリックの範囲、およびFusion Middleware Controlを使用したパフォーマンス・メトリックのモニター方法について説明します。また、診断ログ・ファイルに記録された情報を分析することにより、問題をトラブルシューティングする方法についても説明します。

1.7 セキュリティの理解

Oracle WebCenter Portalの推奨セキュリティ・モデルは、Java Authentication and Authorization Service (JAAS)モデルを実装するOracle ADF Securityに基づいています。次の章では、WebCenter Portalアプリケーションのセキュリティ構成について説明します。

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

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

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

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

- SSLの構成

- Webサービス・セキュリティの構成

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

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

Oracle WebCenter Portalでは、様々な機能領域についての構成および内容に関連するデータが複数の場所に格納されています。Oracle WebCenter Portalには、障害回復や、開発からステージングおよび本番までの本番ライフサイクル全体を容易にするための一連のユーティリティが用意されており、それによりこのデータをバックアップし、ステージング環境と本番環境間でデータを移動できます。

「WebCenter Portalのバックアップ、リカバリおよびクローニングの管理」では、これらの作業に利用可能なバックアップ、インポートおよびエクスポートの機能とツールについて説明します。

1.9 Oracle WebCenter Portalの管理ツール

Oracle WebCenter Portalには、次の管理ツールがあります。

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

- Oracle WebLogic Server管理コンソール

- Oracle WebLogic Scripting Tool(WLST)

- システムMBeanブラウザ

- WebCenter Portalの「管理」ページ

管理者は、構成ファイルを編集するかわりに、これらのツールを使用して管理タスクを実行する必要があります。最適なツールを決定するためのヘルプは、「構成ツール」を参照してください。

1.9.1 Oracle Enterprise Manager Fusion Middleware Controlコンソール

Oracle Enterprise Manager Fusion Middleware Controlコンソールは、Oracle WebCenter Portalをインストールする際にデプロイされるブラウザベースの管理アプリケーションです。Fusion Middleware Controlコンソールを使用すると、ドメイン(Oracle WebCenter Portalを含むドメインなど)をモニターおよび管理できます。

Fusion Middleware Controlでは、多種多様なパフォーマンス・データおよび管理機能を整理し、個別のWebベースのホームページで提供しています。これらのホームページでは、Webブラウザから、WebCenter Portalコンポーネントの最も重要なモニタリング・データおよび最も一般的な管理機能をすぐに見つけることができます。Fusion Middleware Controlコンソールの一般情報は、『Oracle Fusion Middlewareの管理』のOracle Enterprise Manager Fusion Middleware Controlの使用の開始に関する項を参照してください。

Fusion Middleware Controlは、Oracle WebCenter Portalの主要管理ツールです。このツールを使用して、次のことができます。

- バックエンドのサービスとツールの構成

- セキュリティ管理の構成

- プロセス・ライフ・サイクルの制御

- ログ・ファイルへのアクセスおよびログ構成の管理

- データ移行の管理

- パフォーマンスのモニター

- 実行時の問題の診断

- 関連コンポーネントの管理(親管理対象サーバー、MDS、ポートレット・プロデューサなど)

1.9.1.1 Fusion Middleware Controlコンソールの表示

Fusion Middleware Controlの起動の詳細は、「Fusion Middleware Controlコンソールの表示」を参照してください。

1.9.2 Oracle WebLogic Server管理コンソール

Oracle WebLogic Server管理コンソールは、WebLogic Serverドメインの管理に使用されるブラウザ・ベースのグラフィカル・ユーザー・インタフェースです。

管理サーバーは、管理コンソール(管理サーバー管理対象サーバーのホスト・アプリケーションへネットワーク・アクセスできる、サポートされている任意のWebブラウザからアクセス可能なWebアプリケーション)をホストします。

管理コンソールを使用すると、以下の操作ができます。

- WebLogic Serverインスタンスの構成、起動、停止

- WebLogic Serverクラスタの構成

- データベース接続(JDBC)、メッセージング(JMS)などのWebLogic Serverサービスの構成

- セキュリティ・パラメータの構成(ユーザー、グループおよびロールの作成や管理など)

- アプリケーションの構成とデプロイ

- サーバー・パフォーマンスとアプリケーション・パフォーマンスのモニター

- サーバー・ログ・ファイルとドメイン・ログ・ファイルの表示

- アプリケーションのデプロイメント記述子の表示

- 選択した実行時アプリケーションのデプロイメント記述子要素の編集

Oracle WebLogic Server管理コンソールの詳細は、『Oracle Fusion Middlewareの管理』のOracle WebLogic Server管理コンソールの表示に関する項を参照してください。

1.9.2.1 ドメイン構成のロック

構成を変更する前に、本番モードのドメインの構成設定をロックする必要があります。管理コンソールのチェンジ・センター(図1-3)に移動し、「ロックして編集」をクリックします。

構成の更新が完了したら、「構成の解放」をクリックして変更を解放します。

ドメインが開発モードの場合は、「ロックして編集」オプションを使用できず、変更は自動的にコミットされます。

図1-3 Oracle WebLogic Server管理コンソール内のチェンジ・センター

1.9.3 Oracle WebLogic Scripting Tool (WLST)

WebLogic Scripting Tool (WLST)により、コマンド行から、Oracle WebCenter PortalなどのOracle Fusion Middlewareコンポーネントを管理できます。

WLSTは、Jythonに基づいた、Oracle WebLogic Serverドメインを管理するための完全なコマンド行スクリプト環境です。WLSTは、ローカル変数、条件変数およびフロー制御文などのJythonの標準機能に対するサポートに加えて、Oracle WebLogic Serverに固有の一連のスクリプト機能(コマンド)も提供します。WebLogicのスクリプト言語は、Jythonの言語構文に従って個々のニーズに合せて拡張できます。

Oracleでは、WebCenter Portalを詳細に管理およびモニターしたり、コンテンツ・リポジトリ、ポートレット・プロデューサ、外部アプリケーションなどのバックエンド・サービスへの接続を管理するためのWLSTコマンドを提供しています。Oracle WebCenter PortalのすべてのWLSTコマンドは、WebCenter WLSTコマンド・リファレンスのWebCenter PortalのカスタムWLSTコマンドに関する項で説明されています。

1.9.3.1 Oracle WebLogic Scripting Tool (WLST)コマンドの実行

Oracle WebCenter PortalのすべてのWLSTコマンドは、Oracleホーム・ディレクトリ(ORACLE_HOME)から実行する必要があります。

注意:

間違ったディレクトリからWLSTコマンドを実行しようとすると、NameErrorが表示されます。WLSTコマンドは、常にOracleホーム・ディレクトリから実行します。

「Oracle WebCenter Portalのトラブルシューティング」も参照してください。

コマンド行からWLSTを実行するには:

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')

ここで

- user_nameは、管理サーバーに接続しているオペレータのユーザー名です。

- passwordは、管理サーバーに接続しているオペレータのパスワードです。

- protocolは、管理サーバーとの接続用のプロトコルであり、オプションです

- host_nameは、管理サーバーのホスト名です。

- port_numberは、管理サーバーのポート番号です。

例:

connect(username='weblogic', password='mypassword', url='t3://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コマンドを実行できます。

1.9.3.1.1 Oracle WebCenter Portal WLSTコマンドの実行のヒント

- Oracle WebCenter PortalのWLSTコマンドをリストするには、WLSTコマンド・プロンプトで、help('webcenter')と入力します。
メッセージNo help for webcenter found...が表示される場合は、WLSTスクリプトを誤ったディレクトリから実行している可能性があります。たとえば、wlst.shまたはwlst.cmdを、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がクラスタにデプロイされている場合には必須になります。

- Oracle WebCenter PortalのWLSTコマンドのオンライン・ドキュメントは、WebCenter WLSTコマンド・リファレンスのWebCenter PortalのカスタムWLSTコマンドに関する項で参照できます

1.9.4 システムMBeanブラウザ

Fusion Middleware Controlには、Oracle WebLogic Serverまたは選択したアプリケーションのMBeanを参照できる、一連のMBeanブラウザが用意されています。

注意:

システムMBeanブラウザから、WebCenter PortalのMBeanをモニターおよび構成できますが、構成のためのツールとしてはお薦めしません。WebCenter Portalの設定は、Fusion Middleware ControlまたはWLSTコマンドを使用して、ホームページから構成することをお薦めします。

アプリケーションのMBeanにアクセスするには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「システムMBeanブラウザ」を選択します。

3. 「アプリケーション定義のMBean」で、表示または構成するMBeanに移動します。

たとえば、次のようにして、adf-config.xmlおよびconnections.xmlのMBeanに移動できます(図1-4)。

- adf-config - 「oracle.adf.share.config」→「サーバー: (サーバー名)」→「アプリケーション: (アプリケーション名)」→「ADFConfig」→「ADFConfig」→「ADFConfig」をクリックします

- connections - 「oracle.adf.share.connections」→「サーバー: (サーバー名)」→「アプリケーション: (アプリケーション名)」→「ADFConnnections」→「ADFConnnections」をクリックします

4. MBeanの属性を表示するには、「属性」タブでMBeanを選択し、必要な属性をクリックします。一部の属性の値は変更できます。これを行うには、「値」列に値を入力します。

図1-4 システムMBeanブラウザ

5. 親MBean (たとえば、ADFConfigまたはADFConnections)に移動して「操作」タブを選択し、「保存」をクリックして変更を保存します。

6. WebCenter Portalがデプロイされている管理対象サーバーを再起動します。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

1.9.5 WebCenter Portalの管理ページ

WebCenter Portalにはいくつかの管理ページがあり、これらは管理者のユーザー名とパスワードを使用してWebCenter Portalにログインしたユーザーのみに表示されます。

WebCenter Portalの管理ページでは、次のことができます。

- WebCenter Portalのカスタマイズ

- ユーザーおよびロールの管理

- ツールとサービスの設定の管理

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

- 個々のポータルおよびポータル・テンプレートの管理

- ビジネス・ロール・ページの作成および管理

- 個人用ページの管理

- 個々のポータルおよびポータル・テンプレートのエクスポートとインポート

詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください。

第II部 スタート・ガイド

『Oracle WebCenter Portalの管理』のこの部では、Oracle WebCenter Portalの管理を始める際に役立つチェックリストを示します。

- WebCenter Portalの管理のスタート・ガイド

- Enterprise Manager Fusion Middleware Controlの起動

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

2 WebCenter Portalの管理のスタート・ガイド

この章では、WebCenter Portalを起動および実行するシステム管理者のロールと職責について説明します。

この章の内容は次のとおりです。

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

- WebCenter Portalのインストール

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

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

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

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

権限

この章のタスクを実行するには、次のロールが付与されている必要があります。

- WebLogic Server: Oracle WebLogic Server管理コンソールを使用してAdminロールが付与されます。
このロールが付与されたユーザーは、Fusion Middleware管理者とも呼ばれます。

- WebCenter Portal: WebCenter Portal管理を使用してAdministratorロールが付与されます。
このロールが付与されたユーザーは、WebCenter Portal管理者とも呼ばれます。

「管理操作、ロールおよびツールの理解」も参照してください。

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 Server管理コンソールまたはOracle WebLogic Scripting Tool (WLST)を使用して、Administratorグループにユーザーをもう1人追加します。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の管理ユーザーおよびロールに関する項を参照してください。
Oracle WebLogic Serverは、Adminロールに加えて、OperatorおよびMonitorという他の2つのロールを提供します。これらのロールの詳細は、「管理操作、ロールおよびツールの理解」の表1-6を参照してください。

- WebCenter Portal: WebCenter Portal管理から、別のユーザーにAdministratorロールを割り当てます。詳細は、「異なるアプリケーション・ロールへのユーザーの割当て」を参照してください。
WebCenter Portal管理者は、WebCenter Portalアプリケーションの中で最高の権限を持っています。この管理者は、WebCenter Portalのすべての側面の表示およびカスタマイズ、ユーザーとロールの管理、および別のユーザーへの職責の委任を行うことができます。

WebCenter Portalを起動および実行するために、システム管理者が実行する必要のあるその他の作業を知るには、表2-1の下にリストされる手順に従ってください。

初期設定のWebCenter Portalをカスタマイズするためにシステム管理者が実行できることを知るには、表2-2に従ってください。

注意:

システム管理者は、現在進行中のすべての管理およびメンテナンスのタスクも担当します。詳細は、「WebCenter Portalのシステム管理 – Fusion Middleware管理者ロール(ロードマップ)」を参照してください。

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

バックエンド・コンポーネントには次のものが含まれる可能性があります。

- コンテンツ・リポジトリ

- BPELサーバー[1]

- 分析コレクタ

- ディスカッション・サーバー[1]

- イベント・サーバー

- メール・サーバー

- プレゼンス・サーバー

- Oracle Secure Enterprise Search

- WebCenter Portalリポジトリ[1]

Fusion Middleware管理者

3.次のツールのどちらかを使用して、外部アプリケーションおよびポートレット・プロデューサに接続 :

- Fusion Middleware Control

- WLST

ポートレット・プロデューサには、次のものが含まれる可能性があります。

- WSRPプロデューサ[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の構成。

SSOおよびSSLの構成はオプションです。

Fusion Middleware管理者

6.(オプション) WebCenter Portalのシステム・オプションの構成:

- Portalワークフロー[1]

- 通知メッセージ・チャネル

- 検索クローラ

- 検索設定

- RSSニュース・フィード

Fusion Middleware管理者

7.WC_Portal (WebCenter Portalがデプロイされる管理対象サーバー)の再起動

WebCenter Portal管理者

8.WebCenter Portalにログイン

WebCenter Portal管理者

9.グローバル・オプションの設定およびWebCenter Portalのカスタマイズ

WebCenter Portal管理者

10.アプリケーション・ロールへのユーザー(およびグループ)の割当て

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

表2-2のロードマップは、WebCenter Portal管理者が新しいターゲット・ユーザーに合わせてWebCenter Portalをカスタマイズするために実行できる作業の概要を示しています。

表2-2 ロードマップ - WebCenter Portalの初回のカスタマイズ

タスク

ドキュメント

担当者

1.WebCenter Portalへのログイン

WebCenter Portalに管理権限でログインし、管理ページにアクセスします。

- WebCenter Portalの管理ページへのアクセス

ヒント:

WebCenter PortalのURLはhttp://host:port/webcenterです

WebCenter Portal管理のURLはhttp://host:port/webcenter/portal/admin/settingsです

WebCenter Portal管理者

2.WebCenter Portalのカスタマイズ

WebCenter Portalをターゲット・ユーザーに合わせてカスタマイズします。アプリケーションの名前およびロゴの選択、企業ブランドの適用、言語オプションの設定、デフォルト・ポータルやデフォルト・アセットの選択などがあります。詳細は、次を参照してください。

- WebCenter Portal管理の設定の使用

- ポータル間のグローバルなデフォルト設定の構成

- システム・ページのカスタマイズ

- ビジネス・ロール・ページの管理

- 個人用ページの管理

WebCenter Portal管理者

3.自己登録ポリシーの決定

新規ユーザー登録に関するポリシーを設定します。WebCenter Portalコミュニティの外部ユーザーによる自己登録を招待者にのみ許可するか、自己登録を広く一般に許可します。

- 招待者限定の自己登録の有効化

- すべてのユーザーの自己登録の有効化

WebCenter Portal管理者

4.パブリック・ユーザー・エクスペリエンスの計画

第一印象は、非常に重要です。ようこそページに表示されるコンテンツ、およびユーザーがログインする前のWebCenter Portalの外観を決定します。

- ようこそページまたは自己登録ページのカスタマイズ

- ログイン・ページのカスタマイズ

- デフォルトの表示言語の選択

- デフォルトのアプリケーション・ロール

WebCenter Portal管理者

5.ロールの作成および他のユーザーへの責任の委任

ユーザーのグループを特徴付けるロールを作成して、そのロールがWebCenter Portalで表示できる内容と実行できる内容を決定します。アイデンティティ・ストアでユーザー・ロールの管理および割当てを行います。

- WebCenter Portalのセキュリティについて

- アプリケーション・ロールへのユーザー(およびグループ)の割当て

- アプリケーション・ロールの定義

- 異なるアプリケーション・ロールへのユーザーの割当て

- アプリケーション・ロールの権限の変更

WebCenter Portal管理者

6.ホーム・ポータルのカスタマイズ

WebCenter Portalユーザーのデフォルトのホーム・ポータルを設計します。各ユーザーのロールに関連のある重要な情報およびアプリケーションに即時にアクセスできるようにします。

- ビジネス・ロール・ページのためのページ作成のデフォルトの設定

- ビジネス・ロール・ページの作成

デフォルトのページ・スキームおよびページ・テンプレートにより、一貫性のあるルック・アンド・フィールを奨励または強制します。

- 新しいページのデフォルトのルック・アンド・フィールの選択

WebCenter Portal管理者

7.ディスカッション・フォーラムおよびお知らせの設定

ディスカッション・フォーラムおよびお知らせのデフォルト・オプションを構成します。

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

WebCenter Portal管理者

8.ピープル・コネクション・コンポーネントの設定

アクティビティ・ストリーム、個人プロファイル、接続、メッセージ・ボードおよびフィードバックのデフォルトを構成します。

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

WebCenter Portal管理者

9.メール通知の設定

すべてのユーザーのメールのためのデフォルト・オプションを構成します。

- メール通知の送信の構成

WebCenter Portal管理者

10.既製のポータルおよびポータル・テンプレートの提供

ユーザーは集中管理なしで独自のポータルを作成して管理できます。作成する可能性が高いポータル・タイプのテンプレートを作成することにより、有利なスタートを切ることができます。

- 新規ポータルの作成と構築

- 新規ポータル・テンプレートの作成

WebCenter Portal管理者

2.5 WebCenter Portalのためのシステム管理 - Fusion Middleware管理者ロール(ロードマップ)

表2-3のロードマップに、WebCenter Portalの稼働を維持するためにシステム管理者が実行する一般的な作業の概要を示します。

表2-3 ロードマップ - WebCenter Portalの管理およびモニタリング

タスク

ドキュメント

ロール

管理対象サーバーの起動および停止

構成の変更を有効にするため、または所定のメンテナンスのために、管理対象サーバーを再起動します。

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

ヒント: WebCenter Portalの管理対象サーバーの名前はWC_Portalです。

Fusion Middleware管理者

ログ・ファイルの表示および管理

ログ・ファイルからの問題の識別および診断。WebCenter Portalのログには、起動と停止の情報、エラー、警告およびその他の情報を含む、すべてのイベント・タイプが記録されます。

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

Fusion Middleware管理者

パフォーマンスのモニター

Fusion Middleware ControlでWebCenter Portalアプリケーションのパフォーマンスを分析し、現在の状態をモニターします。

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

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

WebLogic ServerのロールAdmin、Operator、Monitorのいずれかを付与されたシステム管理者は、パフォーマンス・メトリックを表示できます。詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

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管理者

- コンテンツ・リポジトリ

- Oracle WebCenter Content Serverへの接続の管理

- メール・サーバー

- メールの管理

- BPELサーバー

- WebCenter Portalメンバーシップ・ワークフローに対するSOA接続の管理

- コラボレーション

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

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

- カレンダ

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

- Secure Enterprise Search

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

- 分析

- 分析の管理

- イベント、リンク、リスト、ノート、タグおよびピープル・コネクション

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

- MDSリポジトリの設定

外部アプリケーションおよびポートレット・プロデューサの変更

Fusion Middleware Controlを使用して接続を追加、変更および削除します。次を参照してください。

Fusion Middleware管理者

- 外部アプリケーション

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

- ポートレット・プロデューサ

- WSRPプロデューサの登録

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

SSL通信の構成

セキュアな通信を構成します。

- SSLの構成

- Webサービス・セキュリティの構成

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

『Oracle Platform Security Servicesによるアプリケーションの保護』も参照してください。

Fusion Middleware管理者

アイデンティティ、ポリシーおよび資格証明ストアの再関連付け

アイデンティティまたはポリシー・ストアの再関連付け

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

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

『Oracle Platform Security Servicesによるアプリケーションの保護』も参照してください。

Fusion Middleware管理者

WebCenterのリポジトリの再構成

WebCenter Portalリポジトリを再構成します。

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

Fusion Middleware管理者

MDSリポジトリの再構成

アプリケーションのMDSリポジトリを再構成します。

- MDSリポジトリの設定

『Oracle Fusion Middlewareの管理』も参照してください。

- MDSリポジトリの管理

- 異なるMDSリポジトリまたはパーティションを使用するためのアプリケーションの構成

- ソース・システムからターゲット・システムへのメタデータの移動

Fusion Middleware管理者

WebCenter Portalワークフローの再構成

異なるBPELサーバーへWebCenter Portalワークフローをインストールし、接続を再構成します。

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

Fusion Middleware管理者

ポータル、ポータル・テンプレート、アセットまたはポータル・サーバー全体の移行またはエクスポート

様々なエクスポート機能を使用して、リモート・インスタンスへのコンテンツの移動、またはステージング環境と本番環境の間でのコンテンツの移動を行います。

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

- ポータルのデプロイ

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

- アセット、デバイスおよびデバイス・グループのデプロイ

Fusion Middleware管理者

WebCenter Portalアプリケーションのインポート

様々なインポート機能を使用して、バックアップからのWebCenter Portalのリストア、リモート・インスタンスへのコンテンツの移動、またはステージング環境と本番環境の間でのコンテンツの移動を行います。

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

- ポータルのデプロイ

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

- アセット、デバイスおよびデバイス・グループのデプロイ

Fusion Middleware管理者

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

表2-4のロードマップに、WebCenter Portalの稼働時にシステム管理者が実行する一般的な作業の概要を示します。

メンテナンスのためにWebCenter Portalをオフラインにする必要がある場合は、オフライン中にアプリケーションへのアクセスを試みるユーザーに対して適切なメッセージが表示されることを確認してください。

表2-4 ロードマップ - WebCenter Portalの稼働の維持

タスク

ドキュメント

ロール

アプリケーション設定の変更

アプリケーション全体の設定を必要に応じて変更します。

- WebCenter Portal管理の設定の使用

- ポータル間のグローバルなデフォルト設定の構成

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

- システム・ページのカスタマイズ

- ビジネス・ロール・ページの管理

- 個人用ページの管理

WebCenter Portal管理者

ホーム・ポータルの管理

個人用ページおよびビジネス・ロール・ページを管理します。コンテンツをホーム・ポータルにプッシュします。

- ビジネス・ロール・ページの管理

- 個人用ページの管理

- システム・ページのカスタマイズ

WebCenter Portal管理者

ポータルの管理

任意のポータルを一時的にオフラインにし、非アクティブなポータルを終了します。任意のポータルを編集および削除します。

- 任意のポータルに関する情報の表示

- 任意のポータルのクローズ

- 任意のポータルのオフライン化

- 任意のポータルの再オンライン化

- ポータルの削除

WebCenter Portal管理者

ポータル・テンプレートの管理

ポータル・テンプレートを管理します。任意のテンプレートを確認および削除します。

- 新規ポータル・テンプレートの作成

WebCenter Portal管理者

ユーザーおよびロールのメンテナンス

セキュリティをメンテナンスします。ユーザー・ロールの権限の変更、新しいロールの割当てを行います。

- アプリケーション・ロールの権限の変更

- ユーザーへの異なるロールの割当て

WebCenter Portal管理者

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

外部アプリケーションをメンテナンスします。エントリを追加、変更および削除します。

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

WebCenter Portal管理者

AppConnectionManager

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

ポートレット・プロデューサをメンテナンスします。エントリを追加、変更および削除します。

- ポートレット・プロデューサの登録

WebCenter Portal管理者

AppConnectionManager

1
初期設定で自動構成済

3 Enterprise Manager Fusion Middleware Controlの起動

この章では、Oracle Enterprise Manager Fusion Middleware Controlコンソールにアクセスする方法と、必要なすべての構成、モニタリングおよび管理作業を実行できるOracle WebCenter Portal関連ページを表示する方法について説明します。

この章の内容は次のとおりです。

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

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

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

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdmin、OperatorまたはMonitorロールが付与されている必要があります。

「管理操作、ロールおよびツールの理解」も参照してください。

3.1 Fusion Middleware Controlコンソールの表示

システム管理者は、Fusion Middleware Controlコンソールにログインして、Oracle WebCenter Portalを管理するページにアクセスできます。この場合、ロールにより、ログイン後に表示できる内容および実行できる操作が決定されます。詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

Fusion Middleware Controlコンソールにアクセスする手順は次のとおりです。

1. Fusion Middleware Controlを起動します。

Fusion Middleware Controlはドメインに対して構成されており、Oracle WebLogic Server管理サーバーの起動時に自動的に起動されます。『Oracle Fusion Middlewareの管理』の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

『Oracle Fusion Middlewareの管理』のポートの管理の概要に関する項も参照してください。

3. ドメインの管理者「ユーザー名」および「パスワード」の有効な詳細を入力します。

管理ユーザーのデフォルト・ユーザー名は、weblogicです。これは、最初にFusion Middleware Controlにログインするために使用できるアカウントです。

4. 「ログイン」をクリックします。

最初に表示されるページは、ドメインのホームページです(図3-1)。このページは、ナビゲーション・ペインでドメインの名前を選択することによって、いつでも表示できます。

ヒント:

ログインできない場合は、WebLogic管理コンソールにログインし、ホスト、ポートおよび資格証明の確認を試みてください。Weblogic管理コンソールはFusion Middleware Controlと同じホストおよびポートでアクセスできます(http://host.domain:port/console)。

図3-1 ドメインのホームページ

ナビゲーション・ペインからドリルダウンして、WebCenter Portalを含む、ドメイン内のすべてのコンポーネントを表示および管理できます。手順の詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

3.2 WebCenter Portalのホームページへの移動

この項には次のトピックが含まれます:

- WebCenter Portalのホームページ。

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

3.2.1 WebCenter Portalのホームページ

WebCenter Portalのホームページ(図3-2)から、WebCenter Portalの管理を開始します。このページには、WebCenter Portalを構成する、すべてのコンポーネントとツール/サービスのステータス、パフォーマンスおよび可用性が表示されます。

図3-2 WebCenter Portalのホームページ

WebCenter Portalのホームページに表示されるメトリックを使用すると次のことができます。

- WebCenter Portalアプリケーションのステータスの確認と主要なパフォーマンス・データの表示。

- 即時報告するグラフによって、想定通りにアプリケーションが実行されているかどうかを迅速に確認:

- ページおよびポートレットの可用性およびパフォーマンスの問題

- WebLogicサーバーとバックエンドLDAPサーバーの一般的なヘルス

「WebCenter Portalメトリック」と「WebLogicサーバー・メトリック」セクションのリンクにマウスを移動すると表示情報の簡単な説明が表示され、リンクをクリックすると詳細がドリルダウンされます。

- CPUとヒープ・メモリー使用率のグラフをモニターし、システム・リソースが低下した状態で実行されているかどうかを検出。

- アプリケーションが様々な負荷の下でどのように実行されるかを確認するためとシステム・リソースの問題を診断するための、ユーザー・アクセス率と比較した全体的なレスポンス時間の追跡。

- 最も使用されるポータル、最も遅い実行者の迅速な確認、および最も多くのエラーを記録しているポータルの判別とドリルダウン。

- アプリケーションで使用されるWebCenter Portalツール/サービスのステータスおよび主要なパフォーマンス・メトリックの表示。

- 個々のポータル、ツール/サービス、外部アプリケーション、ポートレットおよびプロデューサの詳細なパフォーマンス情報へのドリルダウン。

- WebCenter Portalアプリケーションが実行されているWebLogic Server管理対象サーバーおよびMDSリポジトリを含む、他の主要なコンポーネントへの移動。

注意:

ホームページに表示されるパフォーマンス・メトリックの詳細、注意点およびインストールに関する問題の診断方法は、「主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断」を参照してください。

WebCenter Portalのホームページには、「WebCenter Portal」メニュー(図3-3)も表示されます。

図3-3 WebCenter Portalアプリケーションのメニュー

「WebCenterポータル」メニューから、次のことが行えます。

- すべてのコンポーネントの詳細なパフォーマンス・メトリックのドリルダウン

- ライブ・メトリックの選択および図表化

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

- 診断情報の分析およびログの構成

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

- ポートレット・プロデューサの登録および管理

- アプリケーション設定の構成

- バックエンド・サービスの管理

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

- セキュリティ・ポリシーおよびロールの構成

- ADFおよびMDSオプションの構成

- Webサービス関連の情報の表示

WebCenter Portalのホームページから実行するほとんどのタスクは、このガイドで説明されています。詳細は、「WebCenter Portalの管理のスタート・ガイド」を参照してください。

3.2.2 WebCenter Portalのホームページへの移動

WebCenter Portalのメイン・ホームページに移動する手順は次のとおりです。

1. Fusion Middleware Controlにログオンします。

Fusion Middleware Control Consoleの表示を参照してください。

2. ページ上部の「ターゲット・ナビゲーション」アイコンをクリックします。

3. 「ターゲット・ナビゲーション」(図3-4)で、「WebCenter」→「ポータル」→「サーバー」を開きます。

4. 「WebCenter Portal」(WC_Portal)を選択して、WebCenter Portalのインストールのホームページに移動します(図3-4)。

図3-4 WebCenter Portalのホームページへの移動

ナビゲータ・メニューがどのように「WebCenterポータル」に変わるかに注意してください(図3-5)。

図3-5 WebCenter Portalのホームページおよびメニューの表示

特定のコンポーネントのためのコンテキスト・メニューにアクセスする別の方法は、ナビゲーション・ツリーでノードを右クリックすることです。たとえば、WebCenter Portal (WC_Portal)ノード(図3-4の左の「サーバー」ノードの下)を右クリックすると、同じ「WebCenter Portal」メニューが表示されます。

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

WebCenter Portalのページから、WebLogic Serverドメイン、サーバー、Javaコンポーネント、MDSリポジトリなどの関連するコンポーネントに属するページに移動することは簡単です。

WebCenter Portalのホームページで、「関連コンポーネント」セクション内のリンクをクリックして、WebCenter Portalアプリケーション自体、WebLogic Serverインストール・ページ、またはFusion Middleware Control内のMDSリポジトリ・ページへ移動します。「WebCenter Portalのホームページへの移動」も参照してください。

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

この章では、アプリケーションがデプロイされている管理対象サーバーを再起動する方法について説明します。Fusion Middleware ControlまたはWLSTを使用して行った、WebCenter Portal構成のほとんどの変更は、動的ではありません。変更を有効にするには、管理対象サーバーを再起動する必要があります。たとえば、バックエンド・サーバーの接続詳細を変更する場合は、アプリケーションの管理対象サーバーを再起動する必要があります。例外もあります。ポートレット・プロデューサおよび外部アプリケーションの登録は動的です。登録した新規ポートレット・プロデューサや外部アプリケーションは、アプリケーションで即座に使用可能になります。既存の接続に対して行った変更も即座に有効になります。

この章の内容は次のとおりです。

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

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

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

すべての起動および停止操作は、Oracle WebLogic Server管理コンソールからも実行できます。『Oracle WebLogic Serverサーバーの起動と停止の管理』のサーバーの起動および停止に関する項も参照してください。

注意:

Fusion Middleware ControlまたはOracle WebLogic Server管理コンソールを使用して、管理サーバー、管理対象サーバーおよびWebCenter Portalを起動および停止する前に、ノード・マネージャを実行している必要があります。

あるいは、管理サーバーまたは管理対象サーバーを、startWeblogic.shまたはstartManagedWebLogic.shスクリプトをそれぞれ使用してコマンド行から起動できます。

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminまたはOperatorロールが付与されている必要があります。

「管理操作、ロールおよびツールの理解」も参照してください。

4.1 ノード・マネージャの起動

Fusion Middleware ControlまたはOracle WebLogic Server管理コンソールを使用して、管理サーバー、管理対象サーバーおよびWebCenter Portalを起動および停止する前に、ノード・マネージャを実行している必要があります。

startNodeManager.shを使用してノード・マネージャを起動する方法の詳細は、『Oracle WebLogic Serverノード・マネージャの管理』のノード・マネージャの使用に関する項を参照してください。

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

この節の内容は以下のとおりです。

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

- 管理対象サーバーの起動と停止

4.2.1 Oracle WebCenter Portal管理対象サーバー

Fusion Middleware ControlまたはWLSTを使用して行った、WebCenter Portal構成のほとんどの変更は、動的ではありません。変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

管理対象サーバーを起動または再起動すると、その管理対象サーバーにデプロイされているすべてのアプリケーションは自動的に起動します。詳細は、表4-1も参照してください。

表4-1 Oracle WebCenter Portal管理対象サーバーおよびアプリケーション

管理対象サーバー

アプリケーション

WC_Portal

webcenter (WebCenter Portalアプリケーション)

webcenter-help (WebCenter Portalオンライン・ヘルプ)

analytics-collector (分析)

WC_Portlet

portalTools (OmniPortlet)

wsrp-tools (WSRPツール)

pagelet-producer (ページレット・プロデューサ)

WC_Collaboration

owc_discussions (ディスカッション・サーバー)

注意:

この項では、表4-1に示すWebCenter Portal管理対象サーバーを起動および停止する方法を説明します。他のコンポーネントの管理対象サーバーを起動および停止するには、次を参照してください。

- Oracle WebCenter Content管理対象サーバーは、『Oracle WebCenter Contentのインストールと構成』を参照してください

- Oracle SOA Server管理対象サーバーは、『Oracle SOA SuiteおよびBusiness Process Managementのインストールと構成』を参照してください

管理対象サーバーに特定の起動順序はありませんが、複数の管理対象サーバーを起動する必要がある場合は、WebCenter Portalがデプロイされている管理対象サーバーを最後に起動することをお薦めします。

4.2.2 管理対象サーバーの起動と停止

Fusion Middleware Controlを使用してWebCenter Portal管理対象サーバーを起動、停止または再起動する手順は次のとおりです。

1. Fusion Middleware Controlにログインします。

2. 「ターゲット・ナビゲーション」アイコンをクリックし、「ターゲット・ナビゲーション」ペインで、「WebLogicドメイン」を開きます。

3. 「wc_domain」を開き、起動または停止する管理対象サーバーを選択します(図4-2)。

管理対象サーバーのホームページが表示されます。

図4-1 管理対象サーバーのホームページへのアクセス

4. 「WebLogic Server」メニューから:

- 管理対象サーバーを起動するには、「制御」→「起動」を選択します。

- 管理対象サーバーを停止するには、「制御」→「停止」を選択します。

図4-2 管理対象サーバーの起動または停止

あるいは、「ターゲット・ナビゲーション」ペインで管理対象サーバーの名前を右クリックして、管理対象サーバーのメニュー・オプションにアクセスします。

コマンド行ツールを使用してWebCenter Portal管理対象サーバーを起動または停止するには、『Oracle Fusion Middlewareの管理』のOracle WebLogic Serverインスタンスの起動および停止に関する項を参照してください。

4.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 Fusion Middlewareの管理』のOracle WebLogic Server管理コンソールの表示に関する項を参照してください。

注意:

アプリケーション構成を変更したら、WebCenter PortalがデプロイされているWC_Portal管理対象サーバーを再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

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

WebCenter Portalを起動すると、ユーザーがアプリケーションを使用できるようになり、停止すると使用できなくなります。

Fusion Middleware Controlを使用してWebCenter Portalを起動する手順は次のとおりです。

1. Fusion Middleware Controlで、WebCenter Portalアプリケーションのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「制御」→「起動」を選択します。

あるいは、「WC_Portal」を「ターゲット・ナビゲーション」ペインで右クリックして、このメニュー・オプションにアクセスします。

進行状況メッセージが表示されます。

3. 「閉じる」をクリックします。

アプリケーションのステータスが「稼働中」(緑色の矢印)に変化する様子に注意してください。

4.3.2 WLSTを使用したWebCenter Portalの起動

WLSTコマンドのstartApplicationを使用して、WebCenter Portalを起動します。コマンドの構文と詳細な例は、『WebLogic Server WLSTコマンド・リファレンス』のstartApplicationに関する項を参照してください。

WebCenter Portalアプリケーションの場合、appName引数は常にwebcenterになります。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

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

WebCenter Portalアプリケーションを停止すると、誰もそのアプリケーションを使用できなくなります。アプリケーションを停止してもそのソース・ファイルはサーバーから削除されません。停止したアプリケーションを後で再起動すると、再び利用できます。

WebCenter Portalを停止しても、WebCenter Portalアプリケーションがデプロイされている管理対象サーバー(WC_Portal)は引き続き使用できます。

Fusion Middleware Controlを使用してWebCenter Portalアプリケーションを停止する手順は次のとおりです。

1. Fusion Middleware Controlで、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「制御」を選択します。

あるいは、「WC_Portal」を「ターゲット・ナビゲーション」ペインで右クリックして、このメニュー・オプションにアクセスします。

3. 「OK」をクリックして、続行します。

進行状況メッセージが表示されます。

4. 「閉じる」をクリックします。

ステータスが「停止中」(赤色の矢印)に変化する様子に注意してください。

4.3.4 WLSTを使用したWebCenter Portalの停止

WLSTコマンドのstopApplicationを使用して、WebCenter Portalアプリケーションを停止します。コマンドの構文と詳細な例は、『WebLogic Server WLSTコマンド・リファレンス』のstopApplicationに関する項を参照してください。

WebCenter Portalアプリケーションの場合、appName引数は常にwebcenterになります。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

第III部 ツールおよびサービスの管理

『Oracle WebCenter Portalの管理』のこの部では、WebCenter Portalで使用するツール、サービス、ポートレット・プロデューサおよび外部アプリケーションの管理タスクについて説明します。

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

- Oracle WebCenter Content Serverへの接続の管理

- 分析の管理

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

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

- 他のOracleアプリケーションの統合

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

- メールの管理

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

- RSSの管理

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

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

- WebCenter Portalメンバーシップ・ワークフローに対するSOA接続の管理

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

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

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

- RESTサービスの管理

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

この章では、WebCenter Portalにおけるツールとサービスの管理の概要について説明します。また、必要なバックエンド・サーバーについて説明し、ポータルでツールとサービスを有効化する際の情報も提供します。

この章の内容は次のとおりです。

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

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

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

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: WebCenter Portal管理を使用してAdministratorロールが付与されます。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

説明するタスクは、システム管理者がアプリケーションレベルで実行します。『Oracle WebCenter Portalでのポータルの構築』のポータル・ツールおよびサービスの概要に関する項で説明されているように、ポータル・レベルでツールとサービスを使用することは、アプリケーション・スペシャリストまたはポータル・マネージャのタスクです。

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

WebCenter Portalは、ツールとサービス使用して、コラボレーション、ソーシャル・ネットワーキングおよび個人生産性の機能を公開し、またツールとサービスはタスク・フローを使用して、それらの機能のサブセットを公開します。タスク・フローには、特定のツールまたはサービスから利用できるすべての機能または一部の機能を公開できる、再利用可能な機能が用意されています。

一部のツール(タグなど)は初期状態で使用しても正しく動作しますが、その他のツールは追加の構成(外部バックエンド・サーバーへの接続など)が必要になります。次のツールとサービスでは、関連情報が格納されている外部データ・リポジトリやサーバー(コンテンツ・サーバー、プレゼンス・サーバー、ディスカッション・サーバー、メール・サーバーなど)との接続が必要です。

- 分析

- お知らせ

- ディスカッション

- ドキュメント(Wikiおよびブログを含む)

- イベント

- インスタント・メッセージおよびプレゼンス(IMP)

- メール

- RSS

- 検索(Oracle SESアダプタ用)

また、次のツールとサービスでは、関連情報(リレーションシップ・マッピングなど)が格納されているデータベース・スキーマとの接続が必要です。

- 分析

- ドキュメント(コメントおよびアクティビティ・ストリームを含めるWikiおよびブログ)

- リンク

- リスト

- ピープル・コネクション

- タグ

表5-1に、各種のツールとサービスに関連するデータが格納される場所(MDS、データベース、または外部のリポジトリやサーバー)を示します。これらのリポジトリのいずれか1つが使用できないときに影響を受けるツールやサービスを知っておくと便利です。

- MDS: ツールやサービスによっては、接続メタデータをメタデータ・サービス・リポジトリ(MDS)に格納します。デプロイした後にアプリケーションに加えた変更は、MDSにカスタマイズとして格納されます。詳細は、「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。
WebCenter Portalでは、MDSはデフォルトでインストールおよび構成されます(「MDSリポジトリの設定」を参照)。

- データベース: ツールやサービスによっては、関連情報(リレーションシップ・マッピングなど)が格納されているデータベース・スキーマとの接続が必要です。
詳細は、「データベース接続の設定」を参照してください。

- 外部リポジトリまたはサーバー: ツールやサービスによっては、関連情報が格納されている外部データ・リポジトリ(コンテンツ・サーバー、プレゼンス・サーバーまたはメール・サーバーなど)との接続が必要です。
これらの接続の設定の詳細は、このガイドの関連する章を参照してください(表5-1を参照)。たとえば、外部ディスカッション・サーバーへの接続の設定方法の詳細は、「お知らせおよびディスカッションの管理」を参照してください(表5-1の関連情報の列を参照)。

関連項目:

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

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

5.1.1 ツールおよびサービスのバックエンド・リポジトリ

表5-1に、WebCenter Portalで提供されているツールおよびサービスの一覧と、各接続の設定の関連情報を示します。

表5-1 ツールとサービスのデータ・リポジトリ

ツールとサービス

説明

MDS

データベース・スキーマ

外部リポジトリ

関連情報

アクティビティ・ストリーム

コネクションのアクティビティ、ポータル内で実行したアクション、およびビジネス・アクティビティについてのストリーミング表示を提供します

ACTIVITIESスキーマ

データベース接続の設定

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

分析

ポータル・アプリケーションの使用状況とパフォーマンスのメトリックを表示できます

ACTIVITIESスキーマ

X

データベース接続の設定

分析の管理

お知らせ

重要なアクティビティおよびイベントに関するお知らせを投稿できる機能を、認証されたすべてのユーザーに提供します。

X

DISCUSSIONSスキーマ

X

MDSリポジトリの設定

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

ディスカッション

スレッドで構成されるディスカッションの作成、質問の投稿と返信、および回答の検索が可能な機能を提供します。

X

DISCUSSIONSスキーマ

X

MDSリポジトリの設定

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

ドキュメント

ファイルのアップロード、ファイルやフォルダの作成と管理、ファイルのチェックアウト、バージョニングなどを含む、コンテンツの管理およびストレージの機能を提供します。ドキュメント・ツールは、Wikiとブログの機能もサポートします。

X

X

MDSリポジトリの設定

データベース接続の設定

Oracle WebCenter Content Serverへの接続の管理

イベント

認証されたユーザーの広範囲なグループに関連するイベントのスケジュールの作成およびメンテナンスの機能を提供します。また、Exchangeサーバーが構成されている場合は、Outlookカレンダーから個人用イベントへのアクセスも提供します。

X

WEBCENTERスキーマ(Portalイベント)

X (個人イベント)

MDSリポジトリの設定

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

インスタント・メッセージおよびプレゼンス(IMP)

認証された他のユーザーのステータス(オンライン、オフライン、ビジーまたは退席中)を確認したり、ユーザーに即時に連絡できる機能を提供します。

X

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

『Oracle WebCenter Portalの使用』のインスタント・メッセージおよびプレゼンス・ビューアの使用に関する項

リンク

関連情報の表示、アクセスおよび関連付けの機能を提供します。たとえば、ディスカッションからドキュメントにリンクできます。

WEBCENTERスキーマ

データベース接続の設定

『Oracle WebCenter Portalの使用』のWebCenter Portalの情報のリンクに関する項

リスト

リストを作成、公開および管理できる機能を提供します。

X

WEBCENTERスキーマ

MDSリポジトリの設定

データベース接続の設定

『Oracle WebCenter Portalでのポータルの構築』のポータルへの情報リストの追加に関する項

メール

IMAPおよびSMTPのメール・サーバーとの容易な統合を提供します。これにより、メッセージの表示、添付ファイルを含むメールの作成、メッセージの返信と転送、およびメッセージの削除などのメール機能を実行できます。

X

X

MDSリポジトリの設定

メールの管理

メッセージおよびフィードバック

コネクションおよびアクティビティ・ストリームに向けてメッセージ、添付ファイル、フィードバックを投稿する機能を提供します。

X

ACTIVITIESスキーマ

X

MDSリポジトリの設定

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

ノート

素早く書き留める機能、および様々な個人関連情報を保持する機能を提供します。

X

MDSリポジトリの設定

通知

サービスおよびアプリケーション・オブジェクトをサブスクライブして、それらのオブジェクトが変更されると1つ以上のメッセージング・チャネルから通知を受信するための手段を提供します。

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

ピープル・コネクション

個人プロファイルの作成、現在のステータスの表示、および他のユーザーのアクティビティの表示などのソーシャル・ネットワーキング機能を提供します

WEBCENTERスキーマ

X

データベース接続の設定

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

プロファイル

ユーザーの連絡先情報(電子メール・アドレス、勤務先住所、電話番号など)、部門、上司、写真、ポータルのアクティビティ、パブリック・ドキュメント、およびコネクションについてのビューを提供します

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

RSS

単一の場所(ニュース・リーダー)から多数の異なるWebサイトのコンテンツにアクセスできる機能を提供します。

X

MDSリポジトリの設定

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

RSSの管理

検索

サービス、アプリケーションまたはサイト全体を検索できる機能を提供します。

(これにはOracle Secure Enterprise Searchの統合が含まれます。)

X

X

MDSリポジトリの設定

WebCenter PortalでのOracle Secure Enterprise Searchの管理

タグ

1つ以上の個人関連キーワードを特定のページに割り当てる機能を提供します

X

WEBCENTERスキーマ

MDSリポジトリの設定

データベース接続の設定

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

WebCenter Portalで特定のツールとサービスを動作させるには、各種のバックエンド・データ・リポジトリを構成する必要があります。

この節の内容は以下のとおりです。

- MDSリポジトリの設定

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

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

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

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

5.2.1 MDSリポジトリの設定

ツールやサービスによっては、メタデータ・サービス・リポジトリ(MDS)に情報を格納します。

WebCenter Portalでは、MDSはデフォルトでインストールおよび構成されます。

関連項目:

『Oracle Fusion Middlewareの管理』のメタデータ・リポジトリの管理に関する項。

5.2.2 データベース接続の設定

多くのツールやサービスは、WebCenter Portalリポジトリに情報を格納します。このリポジトリは、WebCenter Portalスキーマ(WEBCENTER)がインストールされているデータベースです。これらのツールとサービスの完全なリストは、表5-1を参照してください。たとえば、リンク・サービスでは、どのオブジェクトがどのオブジェクトにリンクされているかといった、関連マッピング情報をこのデータベースに格納します。その他のツール(分析など)の一部では、ACTIVITIESスキーマが必要になります。

WebCenter Portalには、WEBCENTERおよびACTIVITIESスキーマがデフォルトで構成されるため、さらに構成を行う必要がありません。

アプリケーションで使用される接続タイプに応じて、次のいずれかを実行します。

- 間接パスワードを使用するアプリケーションレベルのデータ・ソースがアプリケーションに含まれていない場合、グローバル・データ・ソースを作成します。グローバル・データ・ソースの作成の詳細は、『Oracle Fusion Middlewareの管理』のJDBCデータ・ソースの作成と管理に関する項を参照してください。

- 間接パスワードを使用するアプリケーションレベルのデータ・ソースをアプリケーションが使用している場合、接続資格証明をマップします。パスワードの設定は、Oracle WebLogic管理コンソールを使用して、「セキュリティ」の「資格証明マッピング」タブで行います。「構成」の「接続プール」タブで間接データ・ソースのパスワードを変更しても、影響はありません。資格証明マッピングの詳細は、『Oracle WebLogic Server JDBCデータ・ソースの管理』のJDBCデータ・ソースの作成に関する項で、JDBCデータ・ソースのセキュリティの資格証明マッピングに関する記載を参照してください。

- アプリケーションがJDBC URL接続を使用する場合、グローバル・アプリケーション・ストアの情報とアプリケーション資格証明ストアに格納されている情報をマージします。資格証明の移行動作の詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の資格証明ストアの構成に関する項を参照してください。

典型的なビジネスのシナリオでは、アプリケーションは別々の管理対象サーバーにデプロイされて、それらのアプリケーションのために複数のデータベースがリポジトリとして使用されます。

リポジトリ接続を再構成すると、WARファイルのWEB-INFディレクトリにあるローカルのdatasourceファイルおよび*-jdbc.xmlファイルは、新しい接続詳細で更新されます。ただし、JNDI Nameおよびdata source名は変更されません。なんらかの理由でJNDI Nameを変更したら、adf-config.xmlファイルも更新する必要があります。JNDI名は、jdbc/connection-nameDSの形式で指定する必要があります。たとえば、connection1という接続名がアプリケーションで使用されている場合、JNDI名はjdbc/connection1DSとなります。

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

ツールやサービスによっては、関連情報が格納されている外部データ・リポジトリ(コンテンツ・サーバー、プレゼンス・サーバーまたはメール・サーバーなど)との接続が必要です。これらのツールとサービスの完全なリスト、およびこのガイド内の関連する章へのリンクは、表5-1を参照してください。リンク先には、接続構成についての説明があります。

管理者は、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用して、WebCenter Portalアプリケーションがデプロイされるバックエンド・サーバーの接続を確認および構成する必要があります。

注意:

Fusion Middleware ControlまたはWLSTを使用してサービス構成に対して加えた変更のほとんどは、動的ではありません。変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

5.2.4 プロキシ・サーバーの設定

WebCenter Portalのアクティビティ・ストリームのタスク・フローで外部RSSニュース・フィードおよび外部リンクを有効化するには、プロキシ・サーバーが必要になります。RSSサービスおよびアクティビティ・ストリーム・サービスは、同じプロキシ・サーバー設定を共有します。

プロキシ・サーバーは、Fusion Middleware ControlまたはWLSTを使用して設定できます。

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

- Fusion Middleware Controlを使用したプロキシ・サーバーの設定

- WLSTを使用したプロキシ・サーバーの設定

5.2.4.1 Fusion Middleware Controlを使用したプロキシ・サーバーの設定

Fusion Middleware Controlを使用してプロキシ・サーバーを設定するには:

1. Fusion Middleware Controlにログオンし、アプリケーションのホームページに移動します。

詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「アプリケーション構成」を選択します。

3. 「プロキシ・サーバー」セクションに、プロキシ・サーバーのホスト名とポート番号を入力します。詳細は、表5-2を参照してください。

表5-2 RSSプロキシ・サーバーの詳細

フィールド

説明

プロキシ・ホスト

プロキシ・サーバーのホスト名を入力します。

プロキシ・ポート

プロキシ・サーバーが実行されているポート番号を入力します。

4. 「適用」をクリックして、この接続を保存します。

5. アプリケーションがデプロイされている管理対象サーバーを再起動します。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

5.2.4.2 WLSTを使用したプロキシ・サーバーの設定

WLSTコマンドsetWebCenterProxyConfigを使用して、RSSニュース・フィードおよびアクティビティ・ストリーム・タスク・フローによって使用される、プロキシ・ホストおよびポート番号を指定します。例:

setWebCenterProxyConfig(appName='webcenter', proxyHost='www-proxy.example.com', proxyPort='80')

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetWebCenterProxyConfigに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しいプロキシ詳細を使用して起動するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

getWebCenterProxyConfigコマンドを使用して、RSSおよびアクティビティ・ストリーム・タスク・フローによって使用されている現在のプロキシ・ホストおよびポートを検出します。例:

getWebCenterProxyConfig(appName='webcenter')

プロキシ・ホストおよびポートの現在の設定を削除する場合、unsetWebCenterProxyConfigコマンドを使用します。例:

unsetWebCenterProxyConfig(appName='webcenter')

詳細は、WebCenter WLSTコマンド・リファレンスのプロキシ・サーバーに関する項を参照してください。

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

自身の認証を行うアプリケーションと、ツールまたはサービスが対話する場合、資格証明プロビジョニングをできるように、そのアプリケーションと外部アプリケーション定義を関連付けることができます。外部アプリケーションの使用の詳細は、「外部アプリケーションの管理」を参照してください。

ヒント:

これらのツールとサービスのいくつか(たとえば、IMP、イベント、メール)に同一のLDAPサーバーと資格証明を使用する予定がある場合は、それらのために単一の接続を作成して、共有される接続全体で使用するプロパティを指定することを検討してください。

頻繁なパスワード変更が必要になる追加の制約が要求されるアイデンティティ・ストアでは、単一の共有接続を作成すると特に便利です。外部アプリケーション接続を1つのみ作成することで、パスワード変更後の無効なログインの試行が最小限に抑えられるようになり、パスワード・ロックアウトの発生を回避できます。

次のツールとサービスでは、接続や認証の定義に外部アプリケーションを使用できます。

- ドキュメント

- イベント

- インスタント・メッセージおよびプレゼンス

- メール

- RSSビューア(保護されているRSSフィード使用時)

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

システム管理者は、外部サーバーへの接続の管理を担当します。また、データベース・スキーマと、WebCenter Portalに固有のアプリケーション・データを格納するMetadata Service (MDS)リポジトリのメンテナンスも担当します。詳細は、「WebCenter Portalの管理のスタート・ガイド」を参照してください。

バックエンド・サーバーが意図的またはその他の理由で構成されていない場合、WebCenter Portalは、そのツールに関連する機能を提供できなくなります。

- 関連するタスク・フローは、リソース・カタログで利用できなくなります。

- 既存のタスク・フローは、ツールまたはサービスが利用できないことを示すメッセージを表示します。

- ツールまたはサービスは、ポータルの管理設定からポータル・マネージャが利用できるものとしてリストされなくなります。

有効な接続が存在する場合は、関連するツールまたはサービスがWebCenter Portalで利用できます。詳細は、「WebCenter Portalでのツールおよびサービスの有効化と無効化」を参照してください。

WebCenter Portalの「管理」の「ツールとサービス」ページでは、いくつかのオプション構成を必要に応じて実行できます。詳細は、「WebCenter Portalのツールおよびサービスの構成」を参照してください。

ツールおよびサービスの一時的な問題のレポート

ツールまたはサービスが一時的に利用できない場合、システム管理者は、Fusion Middleware Controlを使用してサービスに関連する問題を調査、診断および解決できます。「WebCenter Portalのホームページへの移動」も参照してください。

ツールおよびサービスが利用できないときのタスク・フローの非表示

ほとんどのツールとサービスはオプションです。特定のツールやサービスを一時的または永続的にアプリケーションで提供しないことにする場合は、デフォルトの初期設定で表示される、関連するタスク・フローの削除を検討してください。

特定のポータルに対するツールおよびサービスの有効化と無効化

ポータル・マネージャは、ポータル内で使用可能なツールを有効化または無効化できます。『Oracle WebCenter Portalでのポータルの構築』のポータルで利用可能なツールおよびサービスの有効化と無効化に関する項を参照してください。

WebCenter Portalでのツールおよびサービスの有効化と無効化、および構成の詳細は、「WebCenter Portalでのツールおよびサービスの有効化と無効化」および「WebCenter Portalのツールおよびサービスの構成」を参照してください。

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

WebCenter Portalが提供するツールとサービスにより、ポータルのメンバーは、これらのツールとサービスに関連付けられた各種のタスク・フローを使用してコラボレーションとコミュニケーションが可能になります。個人用ノートなど、一部のツールはデフォルトで使用できるため、さらに構成を行う必要はありません。その他のツール(ディスカッションなど)や、その他のサービス(メールなど)では、バックエンド・サーバーへの接続と追加の構成が必要です。「ツールおよびサービスの管理の概要」を参照してください。

有効な接続が存在する場合は、関連するツールまたはサービスがWebCenter Portalで利用できます。メール・サービスを除き、ツールまたはサービスがテンプレートに組み込まれていない場合は、ポータル・マネージャまたはアプリケーション・スペシャリストがポータル内でツールまたはサービスを有効にする必要があります。メール・サービスは、ポータルの作成時に有効化されます。また、メール・サービスがシステム管理者によって構成されている場合は、個別のポータルでは無効化できなくなります。ポータル・テンプレートにツールが組み込まれていると、そのツールは初回使用時に有効になります。ポータル・マネージャは、ポータル内のツールを手動で無効にできます。ただし、メール・サービスは除きます。

ポータル・マネージャがポータルでツールを手動で有効にした場合は、WebCenter Portalがバックエンド・サーバーで必要な構成を処理します。たとえば、ポータル・マネージャがポータルでディスカッションを有効にした場合、WebCenter Portalはディスカッション・サーバー上でそのポータル用にディスカッション記憶域を構成し、ロールマッピング・ベースの認可を実行しますが、これはつまり、ポータル内でユーザーがディスカッションと連携できるWebCenter Portalのロールを、ディスカッション・サーバー上の対応するロールにマップするということです。「ディスカッション・サーバーのロール・マッピングの理解」も参照してください。ロールマッピングが失敗した場合は、ポータル・マネージャにメールで通知されますが、ユーザーはディスカッションにはアクセスできません。

新しいポータルの作成に使用したテンプレートでツールが有効化されている場合は、そのツールに初めてユーザーがアクセスしたときに、WebCenter Portalにより、バックエンド・サーバーの構成が処理されます。たとえば、/webcenter/portal/PortalName/Discussionsにあるポータルの「ディスカッション」ページにユーザーが初めて移動すると、WebCenter Portalは、ディスカッション・サーバーにそのポータル用のディスカッション記憶域を構成し、ロールマッピング・ベースの認可を実行して、ディスカッション・ページを表示します。

次のツールとサービスは、ポータル・テンプレートに組み込まれていると、初回使用時に自動的に有効化できます。

- お知らせ

- ディスカッション

- イベント

- リスト

- ドキュメント

注意:

以前のリリースでは、これらのツールとサービスは、初回使用時ではなく、ポータルの作成時に有効化されていました。ほとんどの場合、ポータル・マネージャは独自のポータルのツールとサービスを管理しますが、WebCenter Portalのシステム管理者は、この作業を必要に応じて実行することもできます。ポータルでのツールおよびサービスの有効化と無効化の詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルで利用可能なツールおよびサービスの有効化と無効化に関する項を参照してください。

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

ツールとサービスは、この章で前述したように、システム管理者が該当するバックエンド・アプリケーションに対する設定と接続を行うことで構成されます。

この接続が存在していると、ポータルでツールやサービスが利用できます。ポータル・マネージャは、各自のポータルでツールとサービスの管理を担当します。ただし、システム管理者の場合は、WebCenter Portalの「管理」の「ツールとサービス」ページを使用して、WebCenter Portalの追加構成の一部を設定できます。

WebCenter Portalの「管理」の「ツールとサービス」ページにあるオプションを構成する手順は次のとおりです。

1. 「管理」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「ツールとサービス」をクリックします。

ブラウザに次のURLを入力して、直接「ツールとサービス」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/tools

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

図5-1 WebCenter Portalの「ツールとサービス」ページ

2. 使用可能なタブをクリックして、デフォルトの構成を表示します。

タブの詳細は、オンライン・ヘルプ・アイコンをクリックしてください。

3. オプションで、一部のツールとサービスに追加の構成を行います。

- ディスカッション - ディスカッションを格納するルート・カテゴリを変更します。詳細は、「WebCenter Portalのディスカッション・フォーラム・オプションの構成」を参照してください。

- 検索 - Oracle SES 11.2.2.2 が構成される場合は、表示する検索結果のタイプを選択したり、その他のカスタマイズを行うこともできます。詳細は、「WebCenter PortalでのOracle Secure Enterprise Searchの管理」を参照してください。

- 外部アプリケーション - 新しい外部アプリケーションを登録します。または、既存の外部アプリケーションを編集および登録解除します。詳細は、「外部アプリケーションの管理」を参照してください。

- メール - デフォルトのメール・クライアントに、ローカル・メール・クライアントかWebCenter Portalのメール・サービスのいずれかを指定します。詳細は、「WebCenter Portalのメール通知の送信の構成」を参照してください。

- ピープル・コネクション - ピープル・コネクション機能のオプションを設定します。詳細は、「WebCenter Portalのピープル・コネクションの構成」を参照してください。

- ポートレット・プロデューサ - 新しいポートレット・プロデューサを登録します。または、既存のポートレット・プロデューサを編集および登録解除します。詳細は、ポートレット・プロデューサの管理を参照してください。

- ポータル・サーバー接続 - WebCenter Portalをデプロイする新しいポータル・サーバーを登録します。詳細は、「ポータルのデプロイ」を参照してください。

6 Oracle WebCenter Content Serverへの接続の管理

Oracle WebCenter Content Serverへの接続を作成して、Oracle WebCenter Portal内のコンテンツ統合を有効化できます。

この章の内容は次のとおりです。

- Oracle WebCenter Content Serverの接続について

- Oracle WebCenter Content Serverの構成の前提条件

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

- Oracle WebCenter Content Serverの構成

- Oracle WebCenter Content Serverへの接続の作成

- Oracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定

- Oracle WebCenter Content Serverの接続の詳細の変更

- Oracle WebCenter Content Serverの接続の削除

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

- コンテンツ・マネージャのDOCSの構成

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、WebCenter Portal管理を使用して付与されるWebCenter PortalのAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

6.1 Oracle WebCenter Content Serverの接続について

Oracle WebCenter Portalは、Oracle WebCenter Content Serverの機能を活用して、コンテンツのアップロード、ファイルとフォルダの作成および管理、ファイルのチェックアウト、バージョニングなどを含む、コンテンツの管理と格納の機能を提供します。

WebCenter Portalでコンテンツ統合を提供するには、WebCenter Content Serverの接続を1つ以上構成し、それをデフォルト接続(アクティブまたはプライマリ接続と呼ばれることもあります)としてマークする必要があります。

注意:

WebCenter Portalでは、複数のContent Serverの接続がサポートされています。

ただし、iFrameは、デフォルトのコンテンツ・サーバー接続でのみサポートされます。したがって、ポータル・マネージャがコンテンツ・マネージャ・タスク・フローまたはコンテンツ・プレゼンタのプロパティを設定するとき、これらのタスク・フローでPDFファイルなどのファイル・コンテンツを表示するためにiFrameを使用する場合、デフォルト以外のコンテンツ・サーバー接続を指定できません。

注意:

予期しない問題が発生する可能性があるので、デフォルトのOracle WebCenter Content Serverの接続は、作成後、変更しないことをお薦めします。問題が発生した場合、Oracleサポートに連絡してください。

WebCenter Content Serverの構成の前提条件は、「Oracle WebCenter Content Serverの構成の前提条件」で説明しています。WebCenter Content Serverへの接続を作成する前に、記載されている構成を完了していることを確認します。

WebCenter Portalでは、次のものを使用したコンテンツ統合が提供されます。

- コンテンツ・マネージャ・タスク・フロー: WebCenter Content Serverのドキュメントおよび他のタイプのコンテンツをユーザーが表示および管理できるようにします。

- コンテンツ・プレゼンタ・タスク・フロー: エンド・ユーザーが様々な方法でWebCenter Content Serverからコンテンツを選択し、利用可能な表示テンプレートを使用してコンテンツ・アイテムを表示できるようにします。

- Wikiページおよびブログ・ページ: 共同のポータル・ページをユーザーが作成できるようにします。

- コンテンツ・コントリビューションおよびコンテンツ公開: エンド・ユーザーがテキスト、イメージおよびビデオをポータル・ページに追加できるようにします。WebCenter Content Serverへの接続は、コンテンツ・コントリビューションおよびコンテンツ公開には必要ありませんが、WebCenter Content Serverの接続が存在する場合は、WebCenter Content Serverに格納されたイメージをイメージ・コンポーネントで公開でき、WebCenter Content Serverのアイテムへのリンクをイメージ・コンポーネントおよびテキスト・コンポーネントに追加できます。

コンテンツ統合が可能なポータル(ホーム・ポータルを含む)には、WebCenter PortalのデフォルトのWebCenter Content Serverの接続で識別されたWebCenter Content Serverリポジトリに独自のドキュメント・フォルダがあります。

デフォルト接続の設定の詳細は、「Fusion Middleware Controlを使用したOracle WebCenter Content Serverへの接続の作成」を参照してください。WebCenter PortalのデフォルトのWebCenter Content Serverの接続に対する追加プロパティの設定の詳細は、「Oracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定」を参照してください。

デフォルトのWebCenter Content Serverの接続によって識別されるコンテンツ・リポジトリは、WebCenter Portalで使用されるものと同じアイデンティティ・ストアに接続する必要があります。

他のサービス接続と同様に、デプロイ後のWebCenter Content Serverの接続は、Oracle Enterprise Manager Fusion Middleware ControlまたはWLSTコマンド行ツールを使用して登録および管理されます。接続情報は構成ファイルおよびOracle Metadata Servicesリポジトリに格納されます。詳細は、「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

WebCenter Portalのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後に加えたすべての変更は、MDSリポジトリにカスタマイズとして格納されます。

注意:

Fusion Middleware ControlまたはWLSTを使用して行ったWebCenter Content Serverの接続の変更は動的ではないため、変更を有効にするには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

接続の詳細が定義されると、ユーザーは、コンテンツ・マネージャ・タスク・フローおよびコンテンツ・プレゼンタ・タスク・フローを介して、接続済WebCenter Content Serverリポジトリのコンテンツを公開できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルでのコンテンツの使用に関する項および『Oracle WebCenter Portalの使用』のポータルへのコンテンツの追加に関する項を参照してください。

注意:

Microsoft SharePointはWebCenter Portalのバックエンド・コンテンツ・ストアとして直接サポートされていませんが、SharePointドキュメントのリポジトリとしてContent Serverを使用できます。詳細は、『Microsoft SharePointのためのOracle WebCenter Contentストレージ・コネクタの管理』を参照してください。

6.2 Oracle WebCenter Content Serverの構成の前提条件

この項では、Oracle WebCenter Content Serverに進む前に理解しておく必要のある前提条件と他の考慮事項について説明します。

この項には次のトピックが含まれます:

- Oracle WebCenter Content Serverのインストールの前提条件

- Inbound Refineryのインストールの前提条件

- Oracle WebCenter Content ServerおよびInbound Refineryの構成の前提条件

- Oracle WebCenter Content ServerおよびInbound Refineryのセキュリティの前提条件

6.2.1 Oracle WebCenter Content Serverのインストールの前提条件

Oracle WebCenter Content Serverは、Oracle Fusion Middlewareコンポーネントの1つであるOracle WebCenter Contentの一部としてインストールされます。

WebCenter Contentのインストールの詳細は、『Oracle WebCenter Contentのインストールと構成』のOracle WebCenter Contentのインストールに関する項を参照してください。

すでに以前のバージョンのWebCenter Content Serverがインストールされている場合は、それを構成する前に、そのインストールをWebCenter Content 12cにアップグレードしてください。WebCenter Content 12cへのアップグレードの詳細は、Oracle WebCenterのアップグレードのOracle WebCenter Content環境のアップグレードに関する項を参照してください。

6.2.2 Inbound Refineryのインストールの前提条件

Oracle WebCenter Portalのコンテンツ統合では、WebCenter Contentのインストールの一環としてOracle WebCenter Content: Inbound Refineryもインストールすることをお薦めします。

Inbound Refineryは、ドキュメント、デジタル・イメージ、動画などの電子アセット用のファイル変換を管理する変換サーバーです。また、ドキュメントと画像のサムネイル機能、およびビデオのストーリボードも提供します。Inbound Refineryを使用して、WebCenter Content Serverに格納されているコンテンツ・アイテムを変換できます。Inbound Refineryのインストールは、『Oracle WebCenter Contentのインストールと構成』で説明されています。

注意:

WebCenter Content ServerとInbound Refineryは、同じドメインにインストールする必要があります。WebCenter Content ServerとInbound Refineryは、WebCenter Portalと同じドメインにインストールすることをお薦めします。これらを同じドメインにインストールすると、外部LDAP認証プロバイダを使用するための追加構成は必要なくなります。

6.2.3 Oracle WebCenter Content ServerおよびInbound Refineryの構成の前提条件

Oracle WebCenter Content ServerとInbound Refineryをインストールした後、Oracle WebCenter Portal固有の追加手順などの、インストール後の初期設定を構成する必要があります。

一般的なインストール後の設定は、『Oracle WebCenter Contentのインストールと構成』のContent Serverインスタンスの構成に関する項で説明されています。次の表に、WebCenter Portal固有の手順を示します。設定を更新した後は、必ずサーバーを再起動してください。

表6-1 構成の前提条件 - WebCenter Content Server

設定

説明

サーバーのソケット・ポート

これは、RIDCを使用してWebCenter Portalが接続するintradocポートです(デフォルトは4444)。この値は、WebCenter Content Server管理対象サーバーのMW_HOME/user_projects/domains/ucm_domain/ucm/ibr/config/config.cfg構成ファイルにIntradocServerPortとして格納されます。

受信ソケット接続アドレス・セキュリティ・フィルタ

どのマシンがソケット接続によってWebCenter Content Serverにアクセスできるかを指定するサーバー・フィルタ。この値は、SocketHostAddressSecurityFilterとして管理対象サーバーの構成ファイルに格納されます。

フルテキスト検索

(オプションですが、強くお薦めします)

フルテキスト検索エンジンを指定します。SearchIndexerEngineName=ORACLETEXTSEARCHは推奨値です。

表6-2 構成の前提条件 - Inbound Refinery

設定

説明

サーバーのソケット・ポート

このポートは、WebCenter Content ServerとInbound Refineryとの通信に使用されます。この値はインストール後の構成ページで入力されており、Inbound Refineryの構成情報ページにある「サーバー・ポート」で確認できます。また、MW_HOME/user_projects/domains/ucm_domain/ucm/ibr/config/config.cfgファイル内のIntradocServerPortでも確認できます。

受信ソケット接続アドレス・セキュリティ・フィルタ

どのマシンがRIDCによってInbound Refineryにアクセスできるかを指定するサーバー・フィルタ。この値は、SocketHostAddressSecurityFilterとして管理対象サーバーの構成ファイルに格納されます。

6.2.4 Oracle WebCenter Content ServerおよびInbound Refineryのセキュリティの前提条件

Oracle WebCenter Content ServerとInbound Refineryは、同じドメインにインストールする必要があります。WebCenter Content ServerとInbound Refineryは、Oracle WebCenter Portalと同じドメインにインストールすることをお薦めします。これらを同じドメインにインストールすると、外部LDAP認証プロバイダを使用するための追加構成は必要なくなります。

WebCenter Content Serverは、WebCenter Portalと同じアイデンティティ・ストアLDAPサーバーを使用するように構成する必要があります。アイデンティティ・ストアを外部のLDAPサーバーに再度関連付ける方法の詳細は、「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」を参照してください。

また、WebCenter Content Serverおよび他のWebCenter Portalコンポーネントにアクセスするときにユーザーが2回ログインする必要がないように、シングル・サインオン・ソリューションをインストールおよび構成することをお薦めします。シングル・サインオン・ソリューションの詳細は、「シングル・サインオンの構成」を参照してください。

6.3 Oracle WebCenter Content Serverの構成ロードマップ

この項のフロー・チャートは、Oracle WebCenter Content ServerがOracle WebCenter Portalと連動してコンテンツ統合を提供するために必要な前提条件とタスクの概要を示しています。

フロー・チャート(図6-1)に手順を示します。手順は表6-3でも説明されており、詳細は「Oracle WebCenter Content Serverの構成」のトピックに記載されています。

図6-1 WebCenter Portalに対するWebCenter Content Serverの構成

表6-3 WebCenter Content Serverに対するWebCenter Portalの構成タスク

タスク

説明

ドキュメント

必須コンポーネントの有効化

必須

WebCenter Portal用にWebCenter Content Serverのインスタンスを構成する、WebCenterConfigureコンポーネントを有効にする必要があります。

WebCenter Content Server内でコンテンツへの階層フォルダ・インタフェースを提供する、FrameworkFoldersコンポーネントも有効にする必要があります。

また、AutoSuggestConfigコンポーネントも有効にしてください。このコンポーネントは、Web UIに必要なAutoSuggest機能環境変数を設定します。

「必須コンポーネントの有効化」を参照してください。

Dynamic Converterコンポーネントの構成

必須

このコンポーネントによってHTMLレンディションが可能になります。DynamicConverterコンポーネントとWebCenterConfigureコンポーネントの両方がインストールされている場合、WebCenter Portalでスライド・プレビューアを使用できます。

「Dynamic Converterコンポーネントの構成」を参照してください。

Inbound Refineryの構成

オプションですが、強くお薦めします

ドキュメント、デジタル・イメージ、動画などの電子アセット用のファイル変換を管理する変換サーバーです。また、ドキュメントと画像のサムネイル機能、およびビデオのストーリボードも提供します。Inbound Refineryを使用して、WebCenter Content Serverに格納されているコンテンツ・アイテムを変換できます。

「Inbound Refineryの構成」を参照してください。

WebCenter Content Server用のSecure Sockets Layer (SSL)の構成

オプションですが、強くお薦めします

セキュアなアイデンティティ伝播を保証するには、WebCenter Content Serverに対してSSLを設定します。

「Oracle WebCenter Content Serverに対するSSLの設定」を参照してください。

SESクローラの構成

オプション

デフォルトの検索アダプタをオーバーライドして、ドキュメント、ページ、人などのWebCenter Portalリソースの統合ランキング結果の取得にOracle SESを使用できます。

「Oracle SESのためのOracle WebCenter Content Serverの設定」を参照してください。

また、「SESクローラの構成」も参照してください。

Site Studioの構成

オプションですが、強くお薦めします

Site Studioを構成すると、Site Studioを使用してSite Studioアセット(リージョン定義および表示テンプレート)を作成し、そのアセットをコンテンツ・プレゼンタで使用できるようになります。Site Studioが不要であることが確実ではない場合、後でやり直すことがないように、インストールおよび構成することを強くお薦めします。

「Site Studioの設定」を参照してください。

詳細は、『Oracle WebCenter Portalでのポータルの構築』のコンテンツ・プレゼンタを使用したコンテンツの公開に関する項も参照してください。Oracle Site Studioの管理も参照してください。

フルテキスト検索オプションの有効化

オプションですが、強くお薦めします

フルテキストの検索および索引付け機能の構成は、名目上はオプションですが、フルテキスト検索用にOracleTextSearch検索オプションを使用することを強くお薦めします。このオプションは、Oracle Databaseとの組合せでのみ使用可能なことに注意してください。MS-SQLには、DATABASE.FULLTEXTオプションを使用します。

「フルテキスト検索の有効化」を参照してください。

詳細は、『Oracle WebCenter Contentのインストールと構成』のWebCenter Content用のOracleTextSearchの構成に関する項および『Oracle WebCenter Contentのマネージング』のSite Studioの統合に関する項も参照してください。

コンテンツ・プロファイルの作成

オプション

ユーザーは、コンテンツ・プロファイルに基づいてコンテンツをアップロードできます

「Oracle WebCenter Content Serverでのコンテンツ・プロファイルの作成」を参照してください。

コンテンツ・プロファイルの作成の詳細は、『Oracle WebCenter Contentのマネージング』のコンテンツ・プロファイルの管理に関する項を参照してください。

Digital Asset Managerの有効化

オプション

コンテンツ・プレゼンタを使用してポータルで異なるイメージ・レンディションを使用する場合、WebCenter Content ServerでDigital Asset Manager (DAM)を有効化できます。

「Digital Asset Managerの有効化」を参照してください。

『Oracle WebCenter Contentのマネージング』のイメージ変換およびビデオ変換の使用に関する項も参照してください。

追加オプション構成

オプション

残りの構成が完了したら、必要に応じてデスクトップ統合の構成、FileStore Providerコンポーネントの構成およびノード・マネージャの設定が可能です。

「Oracle WebCenter Content Serverに対する追加オプション構成」を参照してください。

Content Serverの登録

必須

ほとんどの場合、WebCenter Portalの最初の起動時に接続が構成されますが、少なくとも接続のテストを行って、接続が使用している環境用に正しく構成されていること、およびデータが正しくシードされていることを確認してください。

「Oracle WebCenter Portalに対するOracle WebCenter Content Serverのデフォルト接続の構成」を参照してください。

「Oracle WebCenter Content ServerにシードされるOracle WebCenter Portalデータの確認」で説明されているように、シードされるデータも必ず確認してください。

6.4 Oracle WebCenter Content Serverの構成

Oracle WebCenter Content 12cをインストールするか、これにアップグレードした後、Oracle WebCenter Content ServerとOracle WebCenter Portalを連動させるために実行するいくつかの構成タスクがあります。

構成タスクは、表6-3に示すとおりです。

注意:

構成を開始する前に、この項の構成手順の開始点を定義した「Oracle WebCenter Content Serverの構成の前提条件」で説明しているインストール手順と構成手順を完了しておく必要があります。

注意:

競合を回避し、複数のWebCenter Content Serverインスタンス間のドキュメントの移行を保証するために、WebCenter Content Serverインスタンスで一意の自動採番接頭辞を入力したことを確認してください。自動採番接頭辞がすべてのWebCenter Content Serverインスタンス間で一意であることを確認するには、WebCenter Content Serverにログインして、「管理」→「管理サーバー」→「一般構成」の順に移動します。

この項には次のトピックが含まれます:

- 必須コンポーネントの有効化

- Dynamic Converterコンポーネントの構成

- Inbound Refineryの構成

- Oracle WebCenter Content Serverに対するSSLの設定

- SESクローラの構成

- Site Studioの設定

- フルテキスト検索の有効化

- Oracle WebCenter Content Serverでのコンテンツ・プロファイルの作成

- Digital Asset Managerの有効化

- Oracle WebCenter Content Serverに対する追加オプション構成

- デフォルトのOracle WebCenter Content Serverのリポジトリの登録

6.4.1 必須コンポーネントの有効化

コンポーネントとは、追加の機能を提供したり既存の機能を変更するために、Oracle WebCenter Content Serverにプラグインできる機能単位です。

Oracle WebCenter Portal用にWebCenter Content Serverを準備するには、次の操作を行う必要があります。

- FrameworkFoldersの有効化
詳細は、「FrameworkFoldersコンポーネントの有効化」を参照してください

- WebCenterConfigureの有効化
詳細は、「WebCenterConfigureコンポーネントの有効化」を参照してください

- AutoSuggestConfigの有効化
AutoSuggestConfigは、Web UIに必要なAutoSuggest機能環境変数を設定します。このコンポーネントを有効化する場合は、FrameworkFoldersやWebCenterConfigureなどの他のコンポーネントの有効化のために使用した同じ手順を実行してください。

6.4.1.1 FrameworkFoldersコンポーネントの有効化

FrameworkFoldersは、従来のファイル・システムと同様に、Oracle WebCenter Content Server内の一部またはすべてのコンテンツを編成および検索するための階層フォルダ・インタフェースを提供します。さらに、これによってWebCenter Content Serverモバイル・アプリケーションを使用して、ポータルのコンテンツにアクセスして、ADFコンテンツUIを活用できるようになります。

FrameworkFoldersコンポーネントを有効化するには:

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

2. 「メイン」メニューから、「管理」→「管理サーバー」→「コンポーネント・マネージャ」を選択します。

3. 「コンポーネント・マネージャ」ページで、FrameworkFoldersチェック・ボックスを選択します。

4. 「更新」をクリックします。

5. 「拡張コンポーネント・マネージャ」をクリックします。

6. 「拡張コンポーネント・マネージャ」ページで、次を確認します。

- FrameworkFoldersが「有効なコンポーネント」セクションにリストされている

- Folders_gが「無効なコンポーネント」セクションにリストされている

7. WebCenter Content Serverインスタンスを再起動します。

6.4.1.2 WebCenterConfigureコンポーネントの有効化

Oracle WebCenter Portal用にOracle WebCenter Content Serverを構成するために、WebCenterConfigureコンポーネントを有効化する必要があります。

表6-4は、このコンポーネントを有効化する際にWebCenter Content Serverで実行されるタスクを示しています。

WebCenterConfigureコンポーネントを有効にするには:

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

2. 「メイン」メニューから、「管理」→「管理サーバー」→「コンポーネント・マネージャ」を選択します。

3. 「コンポーネント・マネージャ」ページで、「WebCenterConfigure」チェック・ボックスを選択します。

ヒント:

「コンポーネント・マネージャ」ページで、「Dynamic Converter」などの他のコンポーネントを選択できます(これらのコンポーネントを使用する予定だが、使用しないときは後で有効化する必要がある場合)。

4. 「更新」をクリックします。

5. 「拡張コンポーネント・マネージャ」をクリックします。

6. 「拡張コンポーネント・マネージャ」ページで、WebCenter Configureが「有効なコンポーネント」セクションにリストされていることを確認します。

7. WebCenter Content Serverインスタンスを再起動します。

WebCenterConfigureコンポーネントを有効化すると、WebCenter Content Serverで特定のタスクが実行されます。表6-4で、これらのタスクについて説明します。

表6-4 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となります。

次のメタデータ・フィールドの追加

- 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で動作させるための、Site Studioコンテンツの切替えウィザードの特定の動作のオーバーライド

これにより、コンテンツ・プレゼンタ内からSite Studioコンテンツの切替えウィザードとSite Studioコントリビュータ・エディタにアクセスして、WebCenter Portalから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/ディレクトリにコピーされます。

6.4.2 Dynamic Converterコンポーネントの構成

Dynamic Converterコンポーネントを構成して、Oracle WebCenter Portalのスライド・プレビューア機能を有効にします。

スライド・プレビューアでは、Dynamic Converterによってオンザフライで生成される、HTMLレンディションが利用されます。

注意:

Inbound Refineryも構成する必要があります。これを構成していないと、すべてのプレビューが失敗します。Inbound Refineryの構成手順は、「Inbound Refineryの構成」を参照してください。

Dynamic Converterの構成には、次の2つの手順が含まれます。

- Dynamic Converterの有効化。
詳細は、「Dynamic Converterコンポーネントの有効化」を参照してください。

ヒント:

必須コンポーネントを有効化している場合は、すでにDynamic Converterを有効化している可能性があります。

- Dynamic Converterの利用が可能なファイル・タイプの定義
詳細は、「ファイル・タイプ、ファイル・サイズおよびタイムアウト設定の指定」を参照してください。

6.4.2.1 Dynamic Converterコンポーネントの有効化

Dynamic Converterによって、Oracle WebCenter Portalのスライド・プレビューアで使用できるHTMLレンディションがオンザフライで生成されます。

Dynamic Converterコンポーネントを有効化する手順は次のとおりです。

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

2. 「メイン」メニューから、「管理」→「管理サーバー」→「コンポーネント・マネージャ」を選択します。

3. 「コンポーネント・マネージャ」ページでDynamicConverterチェック・ボックスを選択します。

4. 「更新」をクリックします。

5. WebCenter Content Serverインスタンスを再起動します。

6.4.2.2 ファイル・タイプ、ファイル・サイズおよびタイムアウト設定の指定

Dynamic Converterコンポーネントを有効化した後で、Dynamic Converterの利用が可能なファイル・タイプを定義する必要があります。Dynamic Converterが処理できる最大ファイル・サイズと、変換操作が失敗するまでの時間も指定できます。

Dynamic Converterでサポートされるファイル・タイプ、許可される最大ファイル・サイズおよびタイムアウト設定を設定する手順は次のとおりです。

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

2. 「メイン」メニューから、「管理」→「Dynamic Converterの管理」→「構成設定」を選択します。

注意:

「Dynamic Converterの管理」メニュー・オプションは、Dynamic Converterコンポーネントを有効化した後にWebCenter Content Serverインスタンスを再起動しないと、表示されません。

3. 「変換フォーマット」セクションで、Dynamic Converterを有効化するファイル形式をドロップダウン・リストから選択します。HTMLレンディションを生成できる必要があるすべてのドキュメント・フォーマット(Word、Excel、PowerPoint、PDFなど)を選択します。

4. 「最大ファイル・サイズ」フィールドで、Dynamic Converterによって処理されるファイルの最大サイズを指定します。

注意:
コンテンツ・マネージャを使用するか、wiki、ブログ、アクティビティ・ストリームなどの機能からアップロードされるファイルの最大アップロード・サイズの指定の詳細は、「Oracle WebCenter Portalの構成」を参照してください。

5. 「タイムアウト」フィールドで、動的変換の実行時間がそれを超えた場合に失敗とする時間を指定します。

注意:
Inbound Refineryサーバーのタイムアウト設定の設定の詳細は、「ファイル変換のタイムアウト設定の指定」を参照してください。

6.4.3 Inbound Refineryの構成

Inbound Refineryは、ドキュメント、デジタル・イメージ、動画などの電子アセット用のファイル変換を管理する変換サーバーです。また、ドキュメントと画像のサムネイル機能、およびビデオのストーリボードも提供します。

オプションですが、強くお薦めします

Inbound Refineryを使用して、Oracle WebCenter Content Serverに格納されているコンテンツ・アイテムを変換できます。「Dynamic Converter」コンポーネントを有効化した場合(スライド・プレビューを生成するために使用)は、IBRも構成する必要があります。

Inbound Refineryを構成するには、WebCenter Content ServerからInbound Refineryへの送信プロバイダを設定し、変換するファイル・タイプを指定する必要があります。必要に応じて、wikiおよびブログのPDFへの変換も有効化します。

Inbound Refineryの構成前に、次のことを完了しておきます。

- 「Oracle WebCenter Content Serverのインストールの前提条件」の説明に従ってInbound Refineryをインストールしています

- 「Oracle WebCenter Content ServerおよびInbound Refineryの構成の前提条件」の説明に従ってインストール後の初期構成を完了しています

この項には次のサブセクションが含まれます:

- アウトバウンド・プロバイダの作成

- 変換するファイル形式の選択

- WikiおよびブログのPDFへの変換の有効化

- ファイル変換のタイムアウト設定の指定

6.4.3.1 アウトバウンド・プロバイダの作成

Oracle WebCenter Content ServerからInbound Refineryにファイルを送信して変換を実施するには、「Inbound Refinery変換ジョブの処理」オプションを事前に選択して、WebCenter Content ServerからInbound Refineryへの送信プロバイダを設定する必要があります。

アウトバウンド・プロバイダを作成するには:

1. WebCenter 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構成情報ページを表示するには:

a. WebCenter Content Serverにログインして、「管理」→「instanceNameの構成」を選択します。

b. 「サーバーの構成」をクリックしてサーバーの構成を表示します。

または、「管理」→「管理サーバー」→「一般構成」でIBRにログインします。

- インスタンス名: Inbound Refineryのインスタンス名(config.cfgファイルのIDC_Name値)。この値は、「コンテンツ・サーバーのインスタンス名」のインストール後の構成ページに入力されたものです。インスタンス名を検索するには、Inbound Refineryにログインして、「管理」→「instanceNameの構成」に移動します。

- 相対Webルート: Inbound RefineryインスタンスのWebルート(例: /ibr/)。

4. 「変換オプション」で、「Inbound Refinery変換ジョブの処理」を選択します。「Inbound Refineryの読取り専用モード」は選択しないでください。

5. 「追加」をクリックします。

6. WebCenter Content Serverを再起動します。

7. 「プロバイダ」ページに戻り、プロバイダの「接続状態」の値がgoodになっていることを確認します。

値がgoodでない場合は、これまでのすべての入力値に誤りがないことを再確認するとともに、WebCenter Content ServerインスタンスとInbound Refineryインスタンスが互いにping可能なことを確認します。

6.4.3.2 変換するファイル形式の選択

Oracle WebCenter Content Serverに対してどのファイルをInbound Refineryに送信して変換するかを指示するには、ファイル・フォーマットを選択する必要があります。

変換するファイル形式を選択するには:

1. WebCenter Content Serverの「管理」メニューから、「リファイナリ管理」を選択し、「ファイル・フォーマット・ウィザード」を選択します。

注意:

Inbound Refineryインスタンスへの有効な送信プロバイダがない場合、Refinery Administrationはリストに表示されません。

WebCenter Content Serverに、「ファイル・フォーマット・ウィザード」ページが表示されます。このページでは、WebCenter Content Serverへのチェックイン時に変換対象としてInbound Refineryに送信するファイル形式を構成します。

2. 変換するファイル・フォーマットを選択します。

変換対象としてInbound Refineryに送信するすべてのファイル・タイプを確実に選択してください。HTMLは選択しません。また、wikiとブログについても、WebCenterConversionsコンポーネントを介してこれらの変換を有効化していない場合は選択しないでください。この有効化については、「WikiおよびブログのPDFへの変換の有効化」で説明します。

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

6.4.3.3 WikiおよびブログのPDFへの変換の有効化

WikiおよびブログのPDFへの変換を有効化するには、まず、Inbound RefineryサーバーとOracle WebCenter 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)の使用に関する項を参照してください。

ヒント:

『Oracle WebCenter Contentのマネージング』のOpen OfficeによってPDFに変換されるファイル形式に関する項も参照してください。

WebCenter PortalでWikiおよびブログのPDFへの変換を有効化するには、まず次のことを実行する必要があります。

- Inbound RefineryとのOpenOffice統合の設定。詳細は、『Oracle WebCenter Contentのマネージング』のOpenOfficeを使用するInbound Refineryの構成に関する項 を参照してください。

- 『Oracle WebCenter Contentのマネージング』のOpenOfficeクラス・ファイルのクラスパスの設定に関する項で説明している手順を実行します(ホストにログインしないでOpenOfficeを使用する方法に関する項も参照してください)。

1. WebCenterConversionコンポーネントをインストールします。

a. Inbound Refineryサーバーにログインします。

b. 「管理」をクリックし、「管理サーバー」を選択します。
Inbound Refineryの「管理サーバー」ページが表示されます。

c. 「コンポーネント・マネージャ」で、「拡張コンポーネント・マネージャ」リンクをクリックします。
「コンポーネント・マネージャ」ページが表示されます。

d. 「新規コンポーネントのインストール」セクションで、WebCenterConversions.zipへのパスを選択して「インストール」をクリックします。
WebCenterConversions.zipは、MW_HOME/wcportal/install/にあります。

WebCenterConversionコンポーネントが「無効なコンポーネント」ボックスに表示されます。

e. 「WebCenterConversion」を選択して「有効化」をクリックします。

f. Inbound Refineryサーバーを再起動します。

2. Inbound RefineryがOpenOfficeと統合できるようにします。

a. Inbound Refineryサーバーに再度ログインします。

b. 「管理」をクリックし、「管理サーバー」を選択します。
Inbound Refineryの「管理サーバー」ページが表示されます。

c. 「コンポーネント・マネージャ」ページで、「OpenOfficeConversion」チェック・ボックスを選択します。

d. Inbound Refineryサーバーを再起動します。

3. WebCenterConversionコンポーネントを有効にします。

a. Inbound Refineryサーバーで、「変換設定」の下にある「変換リスト」リンクをクリックします。
これにより、「変換リスト」ページが表示されます。

b. 「変換」表で、HtmToPDFOpenOfficeの「承認」チェック・ボックスを選択し、「更新」をクリックします。
関連付けられたWebCenter Content Serverインスタンスの、WebCenter Content Serverのファイル・フォーマット・ウィザードで、Wikiとブログのオプションが表示されるようになります。

4. WebCenter Content ServerでWikiおよびブログのPDFへの変換を有効化します。

a. WebCenter Content Serverにログインします。

b. 「管理」ノードを開き、「リファイナリ管理」を開いて、「ファイル・フォーマット・ウィザード」をクリックします。

c. 「ファイル・タイプの選択」で、「Wiki」および「ブログ」チェック・ボックスを選択し、「更新」をクリックします。

5. Inbound RefineryでPDF変換を有効にします。

a. Inbound Refineryサーバーに再度ログインします。

b. 「変換設定」を選択し、「プライマリWebレンディション」を選択します。

c. 「OpenOfficeを使用してPDFに変換」オプションを選択します。

d. 「更新」をクリックします。

6.4.3.4 ファイル変換のタイムアウト設定の指定

オプションで、Inbound Refineryによる個別の変換操作について最大と最小の処理時間を設定できます。

変換操作に対してタイムアウト設定を構成する手順は次のとおりです。

1. Inbound Refineryサーバーにログオンします。

2. 「設定」で、「タイムアウト」を選択します。

3. 必要に応じて、様々な変換操作の最小および最大のタイムアウト設定を指定します。

4. 「更新」をクリックします。

注意:
Dynamic Converterのタイムアウト設定の設定の詳細は、「ファイル・タイプ、ファイル・サイズおよびタイムアウト設定の指定」を参照してください。

6.4.4 Oracle WebCenter Content Serverに対するSSLの設定

コンテンツ・リポジトリに使用するOracle WebCenter PortalとOracle WebCenter Content Serverが、同じシステム上または信頼できる同じプライベート・ネットワーク上にない場合、アイデンティティ伝播はセキュアではありません。

セキュアなアイデンティティ伝播を保証するには、さらにWebCenter Content Serverに対してSSLを設定する必要があります。

6.4.5 SESクローラの構成

デフォルトの検索アダプタをオーバーライドして、ドキュメント、ページ、人などのOracle WebCenter Portalリソースの統合ランキング結果の取得にOracle SESを使用できます。

オプション

SESクローラの構成は、「Oracle SESのためのOracle WebCenter Content Serverの設定」の手順に従ってください。

6.4.6 Site Studioの設定

Site Studioを構成すると、Site Studioを使用してSite Studioアセット(リージョン定義および表示テンプレート)を作成し、そのアセットをコンテンツ・プレゼンタで使用できるようになります。

オプションですが、強くお薦めします

Site Studioの構成はオプションですが、この構成を行わないと、コンテンツ・プレゼンタでのSite Studio関連のアセットの作成および使用はできません。Site Studioが不要であることが確実ではない場合、後でやりなおすことがないように、インストールおよび構成することを強くお薦めします。

Site Studioを有効化する手順は次のとおりです。

1. WebCenter Content Serverにログインして、「管理サーバー」ページを開きます。

「コンポーネント・マネージャ」ページが表示されます。

2. 「すべての機能」をクリックします。

ドキュメント管理、フォルダ、Inbound Refinery、統合およびWebコンテンツ管理カテゴリのすべてのコンポーネントが表示されます。

3. 有効化する各コンポーネントのチェック・ボックスを選択します。次のコンポーネントを有効化する必要があります。

- LinkManager

- SiteStudio

- DBSearchContainsOpSupport (フルテキスト検索に必要)

- PortalVCRHelper

4. 「更新」をクリックします。

5. WebCenter Content Serverインスタンスを再起動します。

6. WebCenter Content Serverに再度ログインして、「管理」ページを開きます。

7. 「Site Studioの管理」を選択し、「デフォルトのプロジェクト・ドキュメント情報の設定」を選択します。

8. デフォルトを受け入れて「更新」をクリックします。

9. 「Site Studioの管理」を選択し、「デフォルトのWebアセット・ドキュメント情報の設定」を選択します。

10. デフォルトを受け入れて「更新」をクリックします。

11. Site Studio Designerを使用するには、WebCenter Content Serverコンソールにログインし、「コンテンツ・サーバー」→「ダウンロード」に移動して、Site Studio Designerのダウンロードとインストールを実行します。

Site Studioを設定した後、WebCenter Content ServerインスタンスにRD_ARTICLEリージョン定義などの適切なアセットをシードするために、Oracle WebCenter Portalを起動(または再起動)します。

6.4.6.1 iFrame化UIの有効化

個別のウィンドウではなく、インライン・フレームを使用してコンテンツ・プレゼンタにSite Studioが表示されるようにする必要があり、Oracle WebCenter PortalとOracle WebCenter Content Serverが同じドメインにない(Webアドレスの観点で)場合は、Oracle HTTP Server (OHS)を構成する必要があります。

ノート

- iFrame化のサポートを有効化する前に、「Oracle HTTP Serverのインストールと構成」の説明に従って、OHSのインストールと構成を完了しておく必要があります。

- コンテンツ・プレゼンタは異なるコンテンツ・サーバー接続を指定できますが、iFrameはデフォルトのコンテンツ・サーバー接続でのみサポートされます。

iFrame化UIを有効化する手順は次のとおりです。

1. mod_wl_ohs.confファイルを開いて、このファイルが適切なWebCenter Content Serverインスタンスを指していることを確認します。

このファイルのデフォルトの場所は、OHS_HOME/Oracle_WT1/instances/instance1/config/OHS/ohs1/mod_wl_ohs.confです

2. Content Serverの接続プロパティをwebContextRoot='/cs'に更新します。

注意:

この設定は、OHSが設定されていない場合や、正しく動作していない場合には、設定しないでください。

3. WebCenter 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>

WebCenter 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の構成の詳細は、「Oracle HTTP Serverの構成」を参照してください。

これでWebCenter PortalのフロントエンドがOHSになったため、WebCenter Portalへのアクセス時にOHSからそうする必要があることに注意してください。したがって、次のURLを指定してアプリケーションにアクセスします。

http://host:OHSPort/webcenter

例:

http://my.example.com:7777/webcenter

6.4.7 フルテキスト検索の有効化

デフォルトでは、Oracle WebCenter Content Serverで使用されるデータベースは、メタデータのみの検索および索引付け機能の提供を目的に設定されます。しかし、フルテキストの検索および索引付け機能も追加でサポートするように、データベースのデフォルト構成を変更できます。

オプションですが、強くお薦めします

名目上はオプションですが、OracleTextSearchオプションを使用してフルテキスト検索を実装することをお薦めします。

詳細は、『Oracle WebCenter Contentのインストールと構成』のContent Server用のOracleTextSearchの構成に関する項および『Oracle WebCenter Contentのマネージング』のSite Studioの統合に関する項を参照してください。

6.4.8 Oracle WebCenter Content Serverでのコンテンツ・プロファイルの作成

ユーザーは、Content Serverプロファイルを使用してコンテンツをアップロードできます。

オプション

WebCenter Content Serverプロファイルの詳細は、『Oracle WebCenter Contentのマネージング』のコンテンツ・プロファイルの管理に関する項を参照してください。

コンテンツ・チェックイン・ページを使用して、ファイルをWebCenter Content Serverにチェックインできます。必須フィールドはアスタリスク(*)で示されています。すべてのコンテンツ・プロファイルには、必須フィールドを含める必要があります。これらが含まれていないと、チェックインに失敗します。

WebCenter Content Serverプロファイルには、WebCenter Content Serverにファイルをアップロードするために必要となる必須フィールドに加えて、ドキュメント・ライブラリおよびOracle WebCenter Portalでアップロード・プロファイルを正しく動作させるための次のフィールドも含める必要があります。

- xCollectionID: フォルダ名の永続化用

- xIdcProfile: プロファイル値の永続化用

- dRevLabel: 新しいバージョンのチェックインを可能にするために、CHECKIN_SEL_FORM APIで必要

これらのフィールドを非表示フィールドとしてプロファイルに追加できます。

6.4.9 Digital Asset Managerの有効化

フル・イメージ・レンディションをサポートするには、イメージがチェックインされているOracle WebCenter Content ServerでDigital Asset Manager (DAM)が有効化されている必要があります。

オプション

たとえば、イメージを含むページを、デスクトップ・ブラウザで表示する場合は高解像度の大きなイメージを使用し、携帯電話で表示する場合は低解像度の小さいイメージを使用し、タブレットで表示する場合はサイズは中型であるが低解像度のイメージを使用できます。

DAMが有効な場合、イメージがチェックインする際に様々なレンディションが自動的に作成され、チェックイン時にレンディション・セットによって判断されます。DAMには組込みのレンディション・セットがいくつか用意されていますが、Content Server管理者は新しいレンディション・セットを作成することもできます。個々のレンディションは、適切なEL式を使用することでコンテンツ・プレゼンタ表示テンプレートの名前で参照できます。

DAMが有効でない場合、サポートがwebレンディションおよびthumbnailレンディションによるInbound Refineryを介したイメージ・レンディションのみに制限されます。

DAMの有効化およびレンディション・セットの作成の詳細は、『Oracle WebCenter Contentのマネージング』のイメージおよびビデオの変換の使用に関する項を参照してください。

注意:

Oracle WebCenter Portalでは、イメージのみの複数のレンディションをサポートします(ビデオはサポートしません)。

6.4.10 Oracle WebCenter Content Serverに対する追加オプション構成

この項では、追加のオプション構成について説明します。これらの構成はOracle WebCenter Content Serverを適切に機能させるために必須ではありませんが、これらに構成によって価値が得られ、WebCenter Content Serverのエンタープライズ・インストールのベスト・プラクティスが確立されます。

この項には次のトピックが含まれます:

- Desktop用のOracle WebCenter Content Serverの構成

- ファイル・ストア・プロバイダの構成

- ノード・マネージャの設定

- ローカライゼーション・プロパティの構成

- リッチ・テキスト・エディタのWikiマークアップ・タブの表示および非表示

- リッチ・テキスト・エディタのテキスト折返しの無効化

6.4.10.1 Desktop用のOracle WebCenter Content Serverの構成

Oracle WebCenter Content: Desktopを使用すると、Windowsエクスプローラ、Microsoft Officeアプリケーション(Word、ExcelおよびPowerpoint)、電子メール・クライアント(Microsoft OutlookおよびLotus Notes)、Webブラウザ(Internet Explorer、Mozilla FirefoxおよびGoogle Chrome)などの数多くの使い慣れたデスクトップ・アプリケーションから、Oracle WebCenter Content Serverのファイルに簡単にアクセスできるようになります。

Desktopクライアント・ソフトウェアがWebCenter Content Serverに接続するためには、次のシステム・コンポーネントをサーバーで有効にする必要があります。

- CoreWebdav。コンテンツ管理を統合するためのコアとなるWebDAV機能を提供します。

また、次のコンポーネントも有効化する必要があります。

- サーバーに対してコアとなるコンテンツ管理統合機能を処理するDesktopIntegrationSuite。

- DesktopTag。コンテンツを追跡する目的で使用されるMicrosoft Officeファイルのカスタム・プロパティを管理したり、Microsoft Officeアプリケーションでワークフロー処理機能を提供します。

- 統合階層のコンテンツ・フォルダを有効化するFramework Folders。

また、次のコンポーネントも有効化できます。

- 電子メール・メッセージ・フィールドを電子メール・メタデータ・フィールドにマップし、Microsoft OutlookおよびLotus Notesでコンテンツ・フォルダに電子メールをドラッグ・アンド・ドロップする場合にも必要なEmailMetadata。

Desktop用にWebCenter Content Serverを構成する手順は次のとおりです。

1. WebCenter Content Serverにログインします。

2. WebCenter Content Serverの「管理」トレイまたはメニューで、「管理サーバー」→「コンポーネント・マネージャ」を選択します。

3. 「コンポーネント・マネージャ」ページで「フォルダ」を選択し、フォルダ・カテゴリのコンポーネントを表示します。

4. FrameworkFoldersコンポーネントを選択します。

5. DesktopIntegrationSuiteとDesktopTag、オプションでEmailMetadataの各コンポーネントを選択します。

6. 「更新」ボタンをクリックして「OK」をクリックし、選択を確定します。

7. 「コンポーネント・マネージャ」ページの最初の段落で、「拡張コンポーネント・マネージャ」をクリックします。

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

9. CoreWebdavコンポーネントが有効化されていることを確認します。

a. 「拡張コンポーネント・マネージャ」ページの「カテゴリ・フィルタ」で、「システム・コンポーネントの表示」を選択します。

b. CoreWebdavが「有効なコンポーネント」ボックス内にない場合は、「無効なコンポーネント」ボックスでCoreWebdavを選択し、「有効化」ボタンをクリックします。

10. WebCenter Content Serverを再起動します。

Desktopの追加構成情報は、『Oracle WebCenter Contentのマネージング』のDesktopの管理に関する項を参照してください。

Desktopクライアント・ソフトウェアは、デスクトップ統合を使用するユーザーのコンピュータにインストールする必要があります。詳細は、『Oracle WebCenter Content: Desktopの使用』のコンピュータ上でのDesktopクライアント・ソフトウェアの設定に関する項を参照してください。

6.4.10.2 ファイル・ストア・プロバイダの構成

Oracle WebCenter Content Serverでは、コンテンツの格納および編成用の従来のファイル・システムのかわりに、データ管理用のファイル・ストアが使用されます。

File Store Providerコンポーネントは、(ドキュメントが格納されていない)新しいWebCenter Content Serverインスタンスに対して、デフォルトでインストール、有効化およびアップグレードされます。File Store Providerコンポーネントは、このコンポーネントによって公開される機能(Web、ボールトおよびWeb URLパス表現の変更など)を活用するために、デフォルトのファイル・ストア(DefaultFileStore)を自動的にアップグレードします。

File Store ProviderコンポーネントはWebCenter Content Serverインタフェースでファイル・ストア機能を公開し、追加の構成オプションを使用可能にします。たとえば、バイナリ・ラージ・オブジェクト(BLOB)データ型を使用して、ファイル・システムのかわりにデータベースにコンテンツを格納するように、WebCenter Content Serverインスタンスを構成できます。

File Store Providerでは、チェックインされたコンテンツおよび関連付けられたメタデータが、システム管理者が設定した基準に基づいて調べられ、これらにストレージ・ルールが割り当てられます。基準には、メタデータ、プロファイルまたはその他の考慮事項を含めることができます。ストレージ・ルールによって、WebCenter Content ServerシステムによるボールトおよびWebファイルの格納方法と、これらへのWebサーバーからのアクセス方法が決まります。

File Store Providerコンポーネントを使用することによって、WebCenter Content Serverシステムの管理対象のコンテンツの格納とコンテンツへのアクセスのためのデータドリブン・ルールを定義できます。次に示す構成手順では、ファイル・システム上ではなくデータベースにコンテンツが確実に格納されるようにするためのストレージ・ルールが作成されます。

ストレージ・ルールを作成するには:

1. システム管理者としてWebCenter Content Serverインスタンスにログインします。

2. 「管理」を選択し、「プロバイダ」を選択します。

「プロバイダ」ページが表示されます。

3. DefaultFileStoreプロバイダの隣にある「アクション」列の「情報」をクリックします。

「ファイル・ストア・プロバイダ情報」ページが表示されます。

4. ルール名(例: DBStorage)を指定し、JDBCストレージを選択します。

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

「ファイル・ストア・プロバイダの編集」ページが表示されます。

6. 「更新」をクリックします。

7. WebCenter Content Serverインスタンスを再起動します。

6.4.10.3 ノード・マネージャの設定

Oracle WebCenter Content Serverおよびこのサーバーが配置されているドメイン内の他のサーバーの構成および管理の追加手順として、Oracle WebLogic Serverノード・マネージャの使用も考えられます。ノード・マネージャを使用すると、WebLogic Serverインスタンスのリモートからの起動および停止、これらのモニター、および予期しない障害発生後の自動再起動が可能になります。

WebCenter Content Server、管理サーバーおよびノード・マネージャが同じWebLogic Serverドメイン内でともに動作するように、これらを構成できます。ノード・マネージャは、いずれかのサーバー・インスタンスをホストするすべてのマシンにインストールされます。ノード・マネージャの使用の詳細は、『Oracle WebCenter Contentのインストールと構成』のOracle WebCenter Contentでのノード・マネージャの使用に関する項を参照してください。

6.4.10.4 ローカライゼーション・プロパティの構成

コンテンツ・マネージャ・タスク・フローが機能し、英語以外のロケールの適切な翻訳が表示されるようにするには、ローカライゼーション用にContent Serverを構成する必要があります。

Content Serverでロケールの有効または無効を構成する手順は次のとおりです。

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

2. メイン・メニューから、「管理」→「ローカライズ」を選択します。

3. 必要なロケールのチェック・ボックスを選択します。

4. 「更新」をクリックします。

6.4.10.5 リッチ・テキスト・エディタのWikiマークアップ・タブの表示および非表示

リッチ・テキスト・エディタ(RTE)でWikiドキュメントを作成または編集するときに、デフォルトでは、「Wikiマークアップ」タブが非表示にされています。「Wikiマークアップ」タブを表示または非表示にするには、構成ファイルblog-wiki-config.xml.xmlを編集します。

オプション

警告:

RTEの「Wikiマークアップ」タブと、その他のタブの間で切り替えると、データが失われる場合があります。このため、デフォルトでは「Wikiマークアップ」タブが無効化されています。「Wikiマークアップ」タブを有効化する前に、有効化することにより発生する可能性のある問題について考慮してください。

ポータルの「Wikiマークアップ」タブを表示および非表示にするには:

1. 最新の構成ファイルblog-wiki-config.xml.xmlをMDSからエクスポートします。

exportMetadata(application='webcenter', server='WC_Portal', 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|false]"/></mds:modify>

ここで:

- true: 「Wikiマークアップ」タブの表示

- false (デフォルト): 「Wikiマークアップ」タブの非表示

4. 更新したファイルをMDSにインポートします。

importMetadata(application='webcenter', server='WC_Portal', fromLocation='/scratch/aime1', docs='/oracle/webcenter/doclib/config/mdssys/cust/site/webcenter/blog-wiki-config.xml.xml')

6.4.10.6 リッチ・テキスト・エディタのテキスト折返しの無効化

デフォルトでは、リッチ・テキスト・エディタでHTMLソースが68文字で折り返されます。これにより、一部のマルチバイトの記号が誤って折り返される場合があります。この問題が発生する場合は、リッチ・テキスト・エディタのテキスト折返しを無効化できます。

オプション

リッチ・テキスト・エディタのテキスト折返しを無効化する手順は次のとおりです。

1. 最新の構成ファイルblog-wiki-config.xml.xmlをMDSからエクスポートします。

exportMetadata(application='webcenter', server='WC_Portal', 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. 構成ファイルを編集して、次に示すように要素text.wrap.lengthの値を0に変更します。

<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='text.wrap.length']"><mds:attribute name="value" value="0"/></mds:modify>

4. 更新したファイルをMDSにインポートします。

importMetadata(application='webcenter', server='WC_Portal', fromLocation='/scratch/aime1', docs='/oracle/webcenter/doclib/config/mdssys/cust/site/webcenter/blog-wiki-config.xml.xml')

6.4.11 デフォルトのOracle WebCenter Content Serverのリポジトリの登録

Oracle WebCenter PortalとOracle WebCenter Content Server間のデフォルトの接続は、WebCenter Portalの最初の起動時に構成される場合がありますが、接続のテストを行って、期待されるデータが正しくシードされていることを確認することを強くお薦めします。

オプションですが、強くお薦めします

この項には次のトピックが含まれます:

- Oracle WebCenter Portalに対するOracle WebCenter Content Serverのデフォルト接続の構成

- Oracle WebCenter Content ServerにシードされるOracle WebCenter Portalデータの確認

6.4.11.1 Oracle WebCenter Portalに対するOracle WebCenter Content Serverのデフォルト接続の構成

Oracle WebCenter PortalとOracle WebCenter Content Server間のデフォルトの接続は、WebCenter Portalの最初の起動時に自動的に構成される場合がありますが、接続のテストを行って、使用している環境用に正しく構成されていることを確認してください。

高可用性環境やシングル・サインオン環境では、WebCenter Portalのホストおよびポート設定を変更する必要がある場合があります。

WebCenter Content Serverをインストールおよび構成して、WebCenter Portalを再起動した後、WebCenter PortalとWebCenter Content Serverの間の接続が正しく構成されていることを確認します。接続が正しく構成されていない場合は、「Oracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定」に示されているようにそれを構成します。

一部のWebCenter Portalコンポーネントは、WebCenter Portalの最初の起動時にWebCenter Content Serverにシードされるデータを使用します。WebCenter Portalで他のコンポーネントを構成する前に、期待されるデータが正しくシードされていることを、「Oracle WebCenter Content ServerにシードされるOracle WebCenter Portalデータの確認」の説明に従って確認してください。

6.4.11.2 Oracle WebCenter Content ServerにシードされるOracle WebCenter Portalデータの確認

Oracle WebCenter Portalの最初の起動時には、一連のデフォルト・データがデフォルトのOracle WebCenter Content Serverにシードされます。WebCenter Portalインスタンスに対してWebCenter Content Serverにシードされるデータは、デフォルトのWebCenter Content Serverの接続で設定されるプロパティに基づきます。

例:

Portal Server Identifier = /WebCenter1
Security Group = WC1

データが正しくない場合や、部分的にしかシードされていない場合は、WebCenter PortalのログとWebCenter Content Serverの構成を確認して、それらのプロパティに必要な修正を行います。その後、WebCenter Portalインスタンスを再起動してデータを再シードしてください。デフォルトのWebCenter Content Serverの接続の設定、およびWebCenter Portalのコンテンツ・リポジトリに必要な追加のプロパティの設定の詳細は、「Oracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定」を参照してください。

表6-5は、シードされるWebCenter Portalデータ(「シードされるデータ」)、シードされるデータのネーミング(「ネーミング」)、およびWebCenter Content Serverにデータが作成されていることの確認方法(「検証」)を示しています。

表6-5 WebCenter Portalでシードされるデータ

シードされるデータ

ネーミング

検証

セキュリティ・グループ

1つのセキュリティ・グループがシードされます。

securityGroup

例: WC1

WebCenter Content Serverで、「管理」→「管理アプレット」→「ユーザー管理」→「セキュリティ」→「グループの権限」に移動します

ロール

2つのロールがシードされます。

- securityGroupUser (セキュリティ・グループに対するR権限を持つ)

- securityGroupAuthenUser (セキュリティ・グループに対するRWD権限を持つ)

例: WC1UserおよびWC1AuthenUser

WebCenter Content Serverで、「管理」→「管理アプレット」→「ユーザー管理」→「セキュリティ」→「ロールの権限」に移動します

ルート・フォルダ名

portalServerIdentifier

(Security Group = securityGroup)

例: /WebCenter1

コンテンツを参照します(フォルダはトップレベルのフォルダとしてリストされます)。

デフォルト属性 - パブリック・ユーザー

すべてのパブリック・ユーザーには次の権限があります。

- アカウント接頭辞PUBLICに対する読取り権限

- アカウント接頭辞WCILSに対する読取り権限

- securityGroupロール

ExtendedConfigProperties表に対する問合せを実行します。または、WebCenter Content Serverにログインした後にユーザー名をクリックして、ロールとアカウントをリストするユーザーのプロファイル・ページを表示し、アカウントPUBLICおよびWCILSと、ロールsecurityGroupUserが含まれていることを確認します

デフォルト属性 - 認証されたユーザー

認証されたすべてのユーザーには次の権限があります。

- アカウント接頭辞AUTHENに対する読取り権限

- アカウント接頭辞WCILSに対する読取り、書込み、削除、管理権限

- securityGroupAuthenUserロール

ExtendedConfigProperties表に対する問合せを実行します。または、WebCenter Content Serverにログインした後にユーザー名をクリックして、ロールとアカウントをリストするユーザーのプロファイル・ページを表示し、アカウントAUTHENおよびWCILSと、ロールsecurityGroupAuthenUserが含まれていることを確認します

表6-6は、ホーム・ポータルに対してシードされるデータ(「シードされるデータ」)、シードされるデータのネーミング(「ネーミング」)、およびWebCenter Content Serverにデータが作成されていることの確認方法(「検証」)を示しています。同じWebCenter Content Serverを使用しているWebCenter Portalインスタンスの数にかかわらず、ホーム・ポータルのデータはWebCenter Content Serverインスタンスに1回のみシードされます。したがって、複数のWebCenter Portalインスタンスで同じWebCenter Content Serverを使用している場合、これらのインスタンスは同じホーム・ポータル・データを共有することになります。

表6-6 ホーム・ポータルに対してシードされるデータ

シードされるデータ

ネーミング

検証

セキュリティ・グループ

1つのセキュリティ・グループがシードされます。

PersonalSpaces

WebCenter Content Serverで、「管理」→「管理アプレット」→「ユーザー管理」→「セキュリティ」→「グループの権限」に移動します

ロール

2つのロールがシードされます。

- PersonalSpacesRole (セキュリティ・グループPersonalSpacesに対するR権限を持つ)

- PersonalSpacesAuthenRole (セキュリティ・グループPersonalSpacesに対するRWD権限を持つ)

WebCenter Content Serverで、「管理」→「管理アプレット」→「ユーザー管理」→「セキュリティ」→「ロールの権限」に移動します

ルート・フォルダ名

PersonalSpaces (Security Group=PersonalSpaces)

コンテンツを参照します(フォルダはトップレベルのフォルダとしてリストされます)。

デフォルト属性 - パブリック・ユーザー

すべてのパブリック・ユーザーには次の権限があります。

- ルート・フォルダのアカウントに対する読取り権限

- PersonalSpacesロール

ExtendedConfigProperties表に対する問合せを実行します。または、WebCenter Content Serverにログインした後にユーザー名をクリックして、ロールとアカウントをリストするユーザーのプロファイル・ページを表示し、アカウントPEWebCenter/PUと、ロールPersonalSpacesRoleが含まれていることを確認します

デフォルト属性 - 認証されたユーザー

認証されたすべてのユーザーには次の権限があります。

- PersonalSpacesAuthenRoleロール

ExtendedConfigProperties表に対する問合せを実行します。または、WebCenter Content Serverにログインした後にユーザー名をクリックして、ロールとアカウントをリストするユーザーのプロファイル・ページを表示し、ロールPersonalSpacesAuthenRoleが含まれていることを確認します

6.5 Oracle WebCenter Content Serverへの接続の作成

Oracle WebCenter Portalを最初に起動するときにOracle WebCenter Content Serverへのデフォルト接続が自動的に作成および構成されるようにできますが、デフォルト設定を変更したり、他のWebCenter Content Serverリポジトリを登録することができます。

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

- Oracle WebCenter Content Serverへの接続の作成について

- Fusion Middleware Controlを使用したOracle WebCenter Content Serverへの接続の作成

- WLSTを使用したOracle WebCenter Content Serverの登録

- RIDCソケット・タイプに対するOracle WebCenter Content Server接続パラメータ

6.5.1 Oracle WebCenter Content Serverへの接続の作成について

Oracle WebCenter Content Serverへの接続を作成するときには、考慮事項がいくつか存在します。

次の点を考慮してください。

- Oracle WebCenter Portalは、Remote Intradoc Client (RIDC)経由でWebCenter Content Serverと通信します。RIDCにより、WebCenter PortalはWebCenter Content Serverのサービスをリモートで実行できます。また、接続プーリング、セキュリティ、プロトコルの固有情報なども処理されます。RIDCは、ソケットベース通信、およびHTTPプロトコルとJAX-WSプロトコルをサポートします。

- ソケット - ソケット・プロトコルは、Intradocソケット・ポート経由でWebCenter Content Serverと通信します。このプロトコルは、WebCenter PortalとWebCenter Content Server間の信頼できる接続を必要とし、パスワード検証は行いません。
セキュリティを強化するために、SSLを介して実行されるようにソケットベース通信を構成することもできます

- HTTP - RIDCは、HTTPClientパッケージを使用して、WebCenter Content Serverに接続されたWebサーバーと通信します。ソケット・プロトコルとは異なり、このプロトコルでは、各リクエストについて認証資格証明が必要です。
また、HTTPプロトコルは、Oracle Traffic DirectorなどのHTTPロード・バランサを使用して負荷分散することもできます。

- JAX-WS - JAX-WSを使用する場合、WebCenter Portalからのすべての接続が自動的に信頼できる接続となると想定するのではなく、WebCenter PortalがWebCenter Content Serverに対して各接続を認証する必要があります。JAX-WSプロトコルは、適切に構成されたWebCenter Content ServerインスタンスとRIDCクライアントがインストールされているOracle WebCenter Contentでのみサポートされます。

- デフォルトのWebCenter Content Serverの接続には、追加構成が必要です。

- WebCenter Content Serverインスタンスに対する管理権限を持つユーザー名が必要です(Content Administrator)。ポータル・コンテンツ、セキュリティ・グループおよびロール用のフォルダの作成と保守、およびコンテンツへのアクセス権の管理には、このユーザーが使用されます。デフォルトのコンテンツ管理者はsysadminです。
WebCenter Portalユーザーにかわって操作を実行するには、この接続に対する管理権限が必要です。

- ポータル・サーバー識別子の値は、すべてのWebCenter Portalコンテンツの格納場所である、WebCenter Content Serverリポジトリ内のルート・フォルダの名前として使用されます。ポータル・サーバー識別子の値には、まだ存在しないWebCenter Content Serverフォルダを指定する必要があります。形式は/foldernameを使用します。たとえば、/MyWebCenterPortalなどです。ポータル・サーバー識別子は、/やWebCenter Content Serverのルート自体にすることはできず、これは異なるポータル間で一意にする必要があります。WebCenter Portalの起動時に、指定したフォルダが作成されます。無効なエントリの例: /、/foldername/、/foldername/subfolder。

- セキュリティ・グループはこのWebCenter Content Serverリポジトリ内でWebCenter Portalインスタンスを識別し、これには一意の値(例: MyWCPApp)を指定する必要があります。この名前は14文字以内とし、英字を先頭に、英数字またはアンダースコア文字の任意の組合せで構成する必要があります。
セキュリティ・グループの値は、次のことのために使用されます。

- 複数のWebCenter Portalインスタンスが同じWebCenter Content Serverインスタンスを共有しており、アプリケーション間で一意にする必要があるときにデータを分離するために使用する。

- WebCenter Portalインスタンスで作成されたすべてのデータを格納するセキュリティ・グループの名前として使用する。

- ロールの接頭辞として使用する(名前の書式はsecurityGroupUserおよびsecurityGroupAuthenUser)。

- 特定のWebCenter Portalインスタンス用にアカウントに対するユーザー権限をストライプ化するために使用する。

- 特定のWebCenter Portalインスタンス用にデフォルトの属性をストライプ化するために使用する。

セキュリティ・グループとロールの詳細は、『Oracle WebCenter Contentの管理』の「高度な管理: セキュリティ」を参照してください。フォルダの詳細は、『Oracle WebCenter Contentのマネージング』のコンテンツの整理に関する項を参照してください。

- ポータル・サーバー識別子とセキュリティ・グループの値は、次のとおりです。

- WebCenter Portalでのデフォルト接続用に、ポータル・サーバー識別子とセキュリティ・グループの値を使用してWebCenter Content Serverにシード・データが作成され、それによってポータル関連データの格納が可能になります。

警告:

ポータル・サーバー識別子またはセキュリティ・グループの値を個別に変更しないでください。常に両方を変更する必要があります。つまり、WebCenter Portalを構成し、実行した後にポータル・サーバー識別子の値を変更する場合は、セキュリティ・グループも変更する必要があります(逆の場合も同様です)。つまり、WebCenter Portalにすでにシード・データが格納されている場合は、両方(ポータル・サーバー識別子およびセキュリティ・グループ)の値を一意の値に変更する必要があります。

これらの値を変更しても、WebCenter Content Server内の既存のシード・データの名前は変更されません。かわりに、アプリケーションを起動したときに、新しい値を使用して新しいシード・データが作成されます。アプリケーションが起動すると、新しいポータル・サーバー識別子フォルダの下に新しいWebCenter Portalデータが作成され、以前のフォルダの下の既存のデータは使用できなくなります。つまり、以前、ポータル・サーバー識別子の変更前にドキュメント・ツールが有効であったWebCenter Portalで、ドキュメント・ツールが無効化されます。

注意:

ポータル・サーバー識別子とセキュリティ・グループの値は変更されますが、WebCenter Content Serverの他のすべてのフォルダと同様、検索結果には引き続き以前のフォルダが表示されます。

- WebCenter Portalは起動時に、WebCenter PortalのデフォルトのWebCenter Content Serverリポジトリにシード・データを作成します(このデータがまだ存在しない場合)。

6.5.2 Fusion Middleware Controlを使用したOracle WebCenter Content Serverへの接続の作成

Fusion Middleware Controlを使用して、Oracle WebCenter Content ServerをOracle WebCenter Portalのコンテンツ・リポジトリとして登録できます。

この項には次のトピックが含まれます:

- ソケットベース通信を使用したOracle WebCenter Content Serverへの接続

- セキュア・ソケットベース通信を使用したOracle WebCenter Content Serverへの接続

- JAX-WSを使用したOracle WebCenter Content Serverへの接続

- HTTPを使用したOracle WebCenter Content Serverへの接続

6.5.2.1 ソケットベース通信を使用したOracle WebCenter Content Serverへの接続

ソケット・プロトコルは、Intradocソケット・ポート経由でOracle WebCenter Content Serverと通信します。

注意:

デフォルトのWebCenter Content Serverの接続には、いくつかの追加構成が必要です。詳細は、「Fusion Middleware Controlを使用したOracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定」を参照してください。

ソケットベース通信を使用してWebCenter Content Serverに接続する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 「追加」をクリックします。

5. 「接続名」フィールドに、WebCenter Content Serverの接続の一意の名前を入力します。

ヒント:

この名前は、WebCenter Portalのすべての接続タイプにおいて一意である必要があります。

6. 「リポジトリ・タイプ」は「Oracle Content Server」です。

7. 「アクティブな接続」を選択して、これをWebCenter Portalに対するデフォルトのWebCenter Content Serverの接続にします。

複数のWebCenter Content Serverインスタンスに対する接続を作成でき、すべての接続が使用されます。1つの接続をデフォルト接続にする必要があります。デフォルト接続は、ポータル関連ドキュメントを格納するためにWebCenter Portalによって使用されるものです。

これがWebCenter Portalに対するデフォルト接続の場合、いくつかの追加構成が必要です。詳細は、「Fusion Middleware Controlを使用したOracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定」を参照してください。

注意:

このオプションの選択を解除しても、接続は無効化されません。接続が不要になった場合は、その接続を削除する必要があります。詳細は、「Fusion Middleware Controlを使用したOracle WebCenter Content Serverの接続の削除」を参照してください。

8. 「RIDCソケット・タイプ」ドロップダウン・リストから、「ソケット」を選択します。

9. 「サーバー・ホスト」フィールドに、WebCenter Content Serverが稼働しているマシンのホスト名を入力します。

たとえば、mycontentserver.example.comなどです。

10. 「サーバー・ポート」フィールドに、WebCenter Content Serverのincomingプロバイダに対して指定されているポートを入力します。

このプロパティは、WebCenter Content Server構成ファイル内のIntradocServerPort設定に対応しています。これは、デフォルトで4444になります。

ヒント:

WebCenter Content Serverにログインし、「管理」→「管理サーバー」→「一般構成」→「追加の構成変数」→「IntradocServerPort」に移動し、現在の値を検索できます。

11. 「接続タイムアウト」フィールドに、WebCenter Content Serverへのログインを試行する、接続タイムアウト・メッセージを発行するまでの時間(ミリ秒)を入力します。

この値は、すべてのサービス・リクエストの基礎となるRIDC接続のソケット・タイムアウトとしても使用されます。

「接続タイムアウト」が設定されていない場合は、次の値が使用されます。

- ログイン・タイムアウト - oracle.webcenter.contentリソース用に構成されたデフォルトの同時実効性タイムアウト(30秒または30000ミリ秒)。『パフォーマンスのチューニング』の同時実行性管理の構成に関する項を参照してください。

- RIDCソケット・タイムアウト - デフォルトのRIDCソケット・タイムアウト(60秒または60000ミリ秒)。

ヒント:

「接続タイムアウト」に60000ミリ秒未満の値を指定すると、RIDCソケット・タイムアウトが早くなり、長時間実行しているリクエストがタイムアウトする可能性が高くなるため、これを指定しないことをお薦めします。たとえば、長時間実行中の検索、長時間に及ぶファイルのアップロード、長時間に及ぶコピー操作などでタイムアウトが発生する可能性があります。

12. 「認証メソッド」ドロップダウン・リストから、次を選択します。

- WebCenter Content Serverがユーザーの認証にWebCenter Portalと同じアイデンティティ・ストアを使用する場合、「アイデンティティ伝播」。
このオプションを選択する場合は、適切な「コンテンツ・サーバーのWebサーバー・コンテキスト・ルート」も指定する必要があります。

- WebCenter Content Serverがユーザーの認証に外部アプリケーションを使用する場合、「外部アプリケーション」。パブリック資格証明、共有資格証明またはマップされた資格証明を使用する場合は、このオプションを選択します。
このオプションを選択する場合は、適切な「関連付けられている外部アプリケーション」も指定する必要があります。

13. (「認証メソッド」が「アイデンティティ伝播」の場合のみ) WebCenter Content ServerのフロントエンドがOracle HTTP Server (OHS)の場合、「コンテンツ・サーバーのWebサーバー・コンテキスト・ルート」フィールドに、WebCenter Content ServerのWebサーバー・コンテキスト・ルートを入力します。

形式/contextRootを使用します。たとえば、/csとなります。

コンテンツ・プレゼンタを使用してSite Studioコンテンツを作成または編集する場合は、Oracle HTTP Server (OHS)を介してWebCenter Portalにアクセスにすることをお薦めします。Oracle HTTP Server (およびWebContextRoot構成)がなくても、コンテンツ・プレゼンタ内からSite Studioコンテンツの作成や編集を行えますが、作成および編集アクションは、コンテンツ・プレゼンタ・タスク・フロー内で開かれるのではなく、新しいブラウザ・ウィンドウ(またはタブ)が起動されます。詳細は、『Oracle WebCenter Portalでのポータルの構築』の「コンテンツ・プレゼンタ構成」ダイアログでのSite Studioコンテンツの作成および編集に関する項を参照してください。

14. (「認証メソッド」が「外部アプリケーション」の場合のみ)「関連付けられている外部アプリケーション」ドロップダウン・リストから、WebCenter Content Serverでユーザーの認証に使用するアプリケーションを選択します。

ヒント:

アプリケーションがWebCenter Portalにまだ登録されていない場合は、ここで「新規作成」を選択してそれを登録します。詳細は、「Fusion Middleware Controlを使用した外部アプリケーションの登録」を参照してください。

15. 「管理者ユーザー名」フィールドに、このWebCenter Content Serverインスタンスの管理権限を持つユーザーのユーザー名を入力します。

このユーザーは、プロファイルに基づいてコンテンツ・タイプ情報をフェッチするため、およびキャッシュ無効化の目的でドキュメントの変更を追跡するために使用されます。

デフォルト値はsysadminです。

16. 「管理者パスワード」フィールドに、「管理者ユーザー名」フィールドで指定したユーザーのパスワードを入力します。

17. 「キャッシュ無効化間隔」フィールドに、外部のWebCenter Content Serverコンテンツの変更を何分間隔で確認するかを入力します。

WebCenter Portalは、変更されたアイテムをキャッシュから自動的にクリアします。最小間隔は2分です。

デフォルトではキャッシュ無効化は無効になっているため、コンテンツ変更の定期的な確認は行われません(0が表示されます)。

18. 「キャッシュされたドキュメントの最大サイズ(バイト)」に、WebCenter Content Serverバイナリ・ドキュメントの最大キャッシュ可能サイズ(バイト数)を入力します。

このサイズより大きいドキュメントは、WebCenter Portalによってキャッシュされません。

デフォルトは102400バイト(100KB)です。

ヒント:

この値は、マシンのメモリー構成およびキャッシュするバイナリ・ドキュメントのタイプに応じて調整してください。Coherenceが有効化されている場合を除き、キャッシュの最大合計サイズはありません。

Coherenceを使用している場合、バイナリ・キャッシュに使用するメモリー量合計を追加で指定できます。この理由により、どのタイプの本番環境にもCoherenceを使用することを強くお薦めします。これは、高可用性(HA)環境の要件です。詳細は、「コンテンツ・プレゼンタのキャッシュ設定の変更」を参照してください。

注意:

WebCenter Content Serverに格納されている大部分のドキュメントは、バイナリ・コンテンツ、つまりイメージ、プレーン・テキスト、Wordドキュメントなどとみなされます。唯一の例外はCDFデータ・ファイルに格納されるSite Studioコンテンツで、これは仮想コンテンツ・リポジトリ(VCR)キャッシュ(またはノード・キャッシュ)に個別にキャッシュされます。

19. 「テスト」をクリックして、作成した接続が機能するかどうかを検証します。

20. 「OK」をクリックして接続を保存します。

登録された接続がコンテンツ・マネージャ・タスク・フローおよびコンテンツ・プレゼンタ・タスク・フローで使用可能になり、WebCenter Portalでページに追加できるようになります。『Oracle WebCenter Portalでのポータルの構築』のコンテンツ・マネージャ・タスク・フローの使用に関する項も参照してください。

接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります(デフォルトはWC_Portal)。詳細は、「管理対象サーバーの起動と停止」を参照してください。

6.5.2.2 セキュア・ソケットベース通信を使用したOracle WebCenter Content Serverへの接続

ソケット・プロトコルは、Intradocソケット・ポート経由でOracle WebCenter Content Serverと通信します。セキュリティを強化するために、SSLを介して実行されるようにソケットベース通信を構成することもできます。

セキュア・ソケットベース通信を使用してWebCenter Content Serverに接続するには、次のことを実行する必要があります。

- WebCenter Content ServerでSSLを構成します。

注意:

デフォルトのWebCenter Content Serverの接続には、いくつかの追加構成が必要です。詳細は、「Fusion Middleware Controlを使用したOracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定」を参照してください。

セキュア・ソケットベース通信を使用してWebCenter Content Serverに接続する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 「追加」をクリックします。

5. 「接続名」フィールドに、WebCenter Content Serverの接続の一意の名前を入力します。

ヒント:

この名前は、WebCenter Portalのすべての接続タイプにおいて一意である必要があります。

6. 「リポジトリ・タイプ」は「Oracle Content Server」です。

7. 「アクティブな接続」を選択して、これをWebCenter Portalに対するデフォルトのWebCenter Content Serverの接続にします。

複数のWebCenter Content Serverインスタンスに対する接続を作成でき、すべての接続が使用されます。1つの接続をデフォルト接続にする必要があります。デフォルト接続は、ポータル関連ドキュメントを格納するためにWebCenter Portalによって使用されるものです。

これがWebCenter Portalに対するデフォルトのWebCenter Content Serverの接続である場合は、いくつかの追加構成が必要です。詳細は、「Fusion Middleware Controlを使用したOracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定」を参照してください。

注意:

このオプションの選択を解除しても、接続は無効化されません。接続が不要になった場合は、その接続を削除する必要があります。詳細は、「Fusion Middleware Controlを使用したOracle WebCenter Content Serverの接続の削除」を参照してください。

8. 「RIDCソケット・タイプ」ドロップダウン・リストから、「ソケットSSL」を選択します。

9. 「サーバー・ホスト」フィールドに、WebCenter Content Serverが稼働しているマシンのホスト名を入力します。

たとえば、mycontentserver.example.comなどです。

10. 「サーバー・ポート」フィールドに、WebCenter Content Serverのsslincomingプロバイダに対して指定されているポートを入力します。

このプロパティは、WebCenter Content Server構成ファイル内のIntradocServerPort設定に対応しています。これは、デフォルトで4444になります。

ヒント:

WebCenter Content Serverにログインし、「管理」→「管理サーバー」→「一般構成」→「追加の構成変数」→「IntradocServerPort」に移動し、現在の値を検索できます。

11. 「接続タイムアウト」フィールドに、WebCenter Content Serverへのログインを試行する、接続タイムアウト・メッセージを発行するまでの時間(ミリ秒)を入力します。

この値は、すべてのサービス・リクエストの基礎となるRIDC接続のソケット・タイムアウトとしても使用されます。

「接続タイムアウト」が設定されていない場合は、次の値が使用されます。

- ログイン・タイムアウト - oracle.webcenter.contentリソース用に構成されたデフォルトの同時実効性タイムアウト(30秒または30000ミリ秒)。『パフォーマンスのチューニング』の同時実行性管理の構成に関する項を参照してください。

- RIDCソケット・タイムアウト - デフォルトのRIDCソケット・タイムアウト(60秒または60000ミリ秒)。

ヒント:

「接続タイムアウト」に60000ミリ秒未満の値を指定すると、RIDCソケット・タイムアウトが早くなり、長時間実行しているリクエストがタイムアウトする可能性が高くなるため、これを指定しないことをお薦めします。たとえば、長時間実行中の検索、長時間に及ぶファイルのアップロード、長時間に及ぶコピー操作などでタイムアウトが発生する可能性があります。

12. 「認証メソッド」ドロップダウン・リストから、次を選択します。

- WebCenter Content Serverがユーザーの認証にWebCenter Portalと同じアイデンティティ・ストアを使用する場合、「アイデンティティ伝播」。
このオプションを選択する場合は、適切な「コンテンツ・サーバーのWebサーバー・コンテキスト・ルート」も指定する必要があります。

- WebCenter Content Serverがユーザーの認証に外部アプリケーションを使用する場合、「外部アプリケーション」。パブリック資格証明、共有資格証明またはマップされた資格証明を使用する場合は、このオプションを選択します。
このオプションを選択する場合は、適切な「関連付けられている外部アプリケーション」も指定する必要があります。

13. (「認証メソッド」が「アイデンティティ伝播」の場合のみ) WebCenter Content ServerのフロントエンドがOracle HTTP Server (OHS)の場合、「コンテンツ・サーバーのWebサーバー・コンテキスト・ルート」フィールドに、WebCenter Content ServerのWebサーバー・コンテキスト・ルートを入力します。

形式/contextRootを使用します。たとえば、/csとなります。

コンテンツ・プレゼンタを使用してSite Studioコンテンツを作成または編集する場合は、Oracle HTTP Server (OHS)を介してWebCenter Portalにアクセスにすることをお薦めします。Oracle HTTP Server (およびWebContextRoot構成)がなくても、コンテンツ・プレゼンタ内からSite Studioコンテンツの作成や編集を行えますが、作成および編集アクションは、コンテンツ・プレゼンタ・タスク・フロー内で開かれるのではなく、新しいブラウザ・ウィンドウ(またはタブ)が起動されます。詳細は、『Oracle WebCenter Portalでのポータルの構築』の「コンテンツ・プレゼンタ構成」ダイアログでのSite Studioコンテンツの作成および編集に関する項を参照してください。

14. (「認証メソッド」が「外部アプリケーション」の場合のみ)「関連付けられている外部アプリケーション」ドロップダウン・リストから、WebCenter Content Serverでユーザーの認証に使用するアプリケーションを選択します。

ヒント:

アプリケーションがWebCenter Portalにまだ登録されていない場合は、ここで「新規作成」を選択してそれを登録します。詳細は、「Fusion Middleware Controlを使用した外部アプリケーションの登録」を参照してください。

15. 「管理者ユーザー名」フィールドに、このWebCenter Content Serverインスタンスの管理権限を持つユーザー名を入力します。

このユーザーは、プロファイルに基づいてコンテンツ・タイプ情報をフェッチするため、およびキャッシュ無効化の目的でドキュメントの変更を追跡するために使用されます。

デフォルトはsysadminです。

16. 「管理者パスワード」フィールドに、「管理者ユーザー名」フィールドで指定したユーザーのパスワードを入力します。

17. 「キー・ストアの場所」フィールドに、セキュリティ・アサーションの署名に使用する秘密鍵が含まれるキーストアの場所を入力します。

キーストアの場所は、絶対パスである必要があります。

たとえば、D:\keys\keystore.xyzとなります。

18. 「キー・ストア・パスワード」フィールドに、キーストアへのアクセスに必要なパスワードを入力します。

たとえば、T0PS3CR3Tとなります。

19. 「秘密鍵の別名」フィールドに、キーストアのクライアント秘密鍵の別名を入力します。

この秘密鍵に対応する公開鍵をサーバーのキーストアにインポートする必要があります。

特殊文字および空白を含まない別名を指定する必要があります。

たとえば、enigmaとなります。

20. 「秘密鍵のパスワード」フィールドに、キーストアの秘密鍵の別名とともに使用されるパスワードを入力します。

たとえば、c0d3bR3ak3Rとなります。

21. 「キャッシュ無効化間隔」フィールドに、外部のWebCenter Content Serverコンテンツの変更を何分間隔で確認するかを入力します。

WebCenter Portalは、変更されたアイテムをキャッシュから自動的にクリアします。最小間隔は2分です。

デフォルトではキャッシュ無効化は無効になっているため、コンテンツ変更の定期的な確認は行われません(0が表示されます)。

22. 「キャッシュされたドキュメントの最大サイズ(バイト)」に、WebCenter Content Serverバイナリ・ドキュメントの最大キャッシュ可能サイズ(バイト数)を入力します。

このサイズより大きいドキュメントは、WebCenter Portalによってキャッシュされません。

デフォルトは102400バイト(100KB)です。

ヒント:

この値は、マシンのメモリー構成およびキャッシュするバイナリ・ドキュメントのタイプに応じて調整してください。Coherenceが有効化されている場合を除き、キャッシュの最大合計サイズはありません。

Coherenceを使用している場合、バイナリ・キャッシュに使用するメモリー量合計を追加で指定できます。この理由により、どのタイプの本番環境にもCoherenceを使用することを強くお薦めします。これは、高可用性(HA)環境の要件です。詳細は、「コンテンツ・プレゼンタのキャッシュ設定の変更」を参照してください。

注意:

WebCenter Content Serverに格納されている大部分のドキュメントは、バイナリ・コンテンツ、つまりイメージ、プレーン・テキスト、Wordドキュメントなどとみなされます。唯一の例外はCDFデータ・ファイルに格納されるSite Studioコンテンツで、これは仮想コンテンツ・リポジトリ(VCR)キャッシュ(またはノード・キャッシュ)に個別にキャッシュされます。

23. 「テスト」をクリックして、作成した接続が機能するかどうかを検証します。

24. 「OK」をクリックして接続を保存します。

登録された接続がコンテンツ・マネージャ・タスク・フローおよびコンテンツ・プレゼンタ・タスク・フローで使用可能になり、WebCenter Portalでページに追加できるようになります。『Oracle WebCenter Portalでのポータルの構築』のコンテンツ・マネージャ・タスク・フローの使用に関する項も参照してください。

接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります(デフォルトはWC_Portal)。詳細は、「管理対象サーバーの起動と停止」を参照してください。

6.5.2.3 JAX-WSを使用したOracle WebCenter Content Serverへの接続

WebCenter Portalからのすべての接続が自動的に信頼できる接続となることを想定するのではなく、Oracle WebCenter PortalでJAX-WSを使用して、各接続をOracle WebCenter Content Serverで認証する必要があります。

注意:

デフォルトのWebCenter Content Serverの接続には、いくつかの追加構成が必要です。詳細は、「Fusion Middleware Controlを使用したOracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定」を参照してください。

JAX-WSを使用してWebCenter Content Serverに接続する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 「追加」をクリックします。

5. 「接続名」フィールドに、WebCenter Content Serverの接続の一意の名前を入力します。

ヒント:

この名前は、WebCenter Portalのすべての接続タイプにおいて一意である必要があります。

6. 「リポジトリ・タイプ」は「Oracle Content Server」です。

7. 「アクティブな接続」を選択して、これをWebCenter Portalに対するデフォルトのWebCenter Content Serverの接続にします。

複数のWebCenter Content Serverインスタンスに対する接続を作成でき、すべての接続が使用されます。1つの接続をデフォルト接続にする必要があります。デフォルト接続は、ポータル関連ドキュメントを格納するためにWebCenter Portalによって使用されるものです。

これがWebCenter Portalのデフォルトのコンテンツ・リポジトリである場合は、いくつかの追加構成が必要です。詳細は、「Fusion Middleware Controlを使用したOracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定」を参照してください。

注意:

このオプションの選択を解除しても、接続は無効化されません。接続が不要になった場合は、その接続を削除する必要があります。詳細は、「Fusion Middleware Controlを使用したOracle WebCenter Content Serverの接続の削除」を参照してください。

8. 「RIDCソケット・タイプ」ドロップダウン・リストから、JAX-WSを選択します。

9. 「WebサービスURL」フィールドに、JAX-WSプロトコルを使用している場合に、WebCenter Content Serverに接続するために必要なWebサービスURLを入力します。

http://host:port/webRootの形式を使用します

例: http://myhost.com:9044/idcnativews

10. 「クライアント・セキュリティ・ポリシー」フィールドに、使用するクライアント・セキュリティ・ポリシーを入力します。

例: oracle/wss11_saml_token_with_message_protection_service_policy

JAX-WSクライアント・セキュリティ・ポリシーには、有効なOWSMポリシーを使用できますが、WebCenter Content ServerのネイティブWebサービスであるIdcWebLoginサービスに対して構成されたセキュリティ・ポリシーに一致する必要があります。IdcWebLoginサービスの詳細は、『Oracle WebCenter Contentでの開発』のWebCenter Content Webサービスに関する項を参照してください。

ヒント:

使用している環境でグローバル・ポリシー・アタッチメント(GPA)をサポートしている場合は、このフィールドを空白のままにします。

11. 「接続タイムアウト」フィールドに、WebCenter Content Serverへのログインを試行する、接続タイムアウト・メッセージを発行するまでの時間(ミリ秒)を指定します。

「接続タイムアウト」が設定されていない場合、oracle.webcenter.contentリソース用に構成されたデフォルトの同時実効性タイムアウトが使用されます(30秒または30000ミリ秒)。『パフォーマンスのチューニング』の同時実行性管理の構成に関する項を参照してください。

12. 「管理者ユーザー名」フィールドに、このWebCenter Content Serverインスタンスの管理権限を持つユーザー名を入力します。

このユーザーは、プロファイルに基づいてコンテンツ・タイプ情報をフェッチするため、およびキャッシュ無効化の目的でドキュメントの変更を追跡するために使用されます。

デフォルトはsysadminです。

13. 「管理者パスワード」フィールドに、「管理者ユーザー名」フィールドで指定したユーザーのパスワードを入力します。

14. 「キャッシュ無効化間隔」フィールドに、外部のWebCenter Content Serverコンテンツの変更を何分間隔で確認するかを入力します。

変更されたアイテムは、WebCenter Portalによって自動的にキャッシュからクリアされます。最小間隔は2分です。

デフォルトではキャッシュ無効化は無効になっているため、コンテンツ変更の定期的な確認は行われません(0が表示されます)。

15. 「キャッシュされたドキュメントの最大サイズ(バイト)」に、WebCenter Content Serverバイナリ・ドキュメントの最大キャッシュ可能サイズ(バイト数)を入力します。

このサイズより大きいドキュメントは、WebCenter Portalによってキャッシュされません。

デフォルトは102400バイト(100KB)です。

ヒント:

この値は、マシンのメモリー構成およびキャッシュするバイナリ・ドキュメントのタイプに応じて調整してください。Coherenceが有効化されている場合を除き、キャッシュの最大合計サイズはありません。

Coherenceを使用している場合、バイナリ・キャッシュに使用するメモリー量合計を追加で指定できます。この理由により、どのタイプの本番環境にもCoherenceを使用することを強くお薦めします。これは、高可用性(HA)環境の要件です。詳細は、「コンテンツ・プレゼンタのキャッシュ設定の変更」を参照してください。

注意:

WebCenter Content Serverに格納されている大部分のドキュメントは、バイナリ・コンテンツ、つまりイメージ、プレーン・テキスト、Wordドキュメントなどとみなされます。唯一の例外はCDFデータ・ファイルに格納されるSite Studioコンテンツで、これは仮想コンテンツ・リポジトリ(VCR)キャッシュ(またはノード・キャッシュ)に個別にキャッシュされます。

16. 「テスト」をクリックして、作成した接続が機能するかどうかを検証します。

17. 「OK」をクリックして接続を保存します。

登録された接続がコンテンツ・マネージャ・タスク・フローおよびコンテンツ・プレゼンタ・タスク・フローで使用可能になり、WebCenter Portalでページに追加できるようになります。『Oracle WebCenter Portalでのポータルの構築』のコンテンツ・マネージャ・タスク・フローの使用に関する項も参照してください。

接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります(デフォルトはWC_Portal)。詳細は、「管理対象サーバーの起動と停止」を参照してください。

6.5.2.4 HTTPを使用したOracle WebCenter Content Serverへの接続

RIDCは、HTTPClientパッケージを使用して、Oracle WebCenter Content Serverに接続されたWebサーバーと通信します。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 「追加」をクリックします。

5. 「接続名」フィールドに、WebCenter Content Serverの接続の一意の名前を入力します。

ヒント:

この名前は、WebCenter Portalのすべての接続タイプにおいて一意である必要があります。

6. 「リポジトリ・タイプ」は「Oracle Content Server」です。

7. 「アクティブな接続」は選択しないでください。

HTTPプロトコルでアイデンティティ伝播が許可されることはないため、これはWebCenter Portalに対するデフォルトのWebCenter Content Serverの接続を使用する場合には不適切です。つまり、ポータル関連ドキュメントを格納するために使用されているバックエンドWebCenter Content Serverリポジトリへの接続には、このプロトコルを使用できません。

8. 「RIDCソケット・タイプ」ドロップダウン・リストから、「Web」を選択します。

9. 「Web URL」フィールドに、WebCenter Content ServerのWebサーバーURLを入力します。

http://host:port/webRoot/pluginRootの形式を使用します。

例: http://mycontentserver/cms/idcplug

。

10. 「接続タイムアウト」フィールドに、WebCenter Content Serverへのログインを試行する、接続タイムアウト・メッセージを発行するまでの時間(ミリ秒)を指定します。

この値は、すべてのサービス・リクエストの基礎となるRIDC接続のソケット・タイムアウトとしても使用されます。

「接続タイムアウト」が設定されていない場合は、次の値が使用されます。

- ログイン・タイムアウト - oracle.webcenter.contentリソース用に構成されたデフォルトの同時実効性タイムアウト(30秒または30000ミリ秒)。『パフォーマンスのチューニング』の同時実行性管理の構成に関する項を参照してください。

- RIDCソケット・タイムアウト - デフォルトのRIDCソケット・タイムアウト(60秒または60000ミリ秒)。

ヒント:

「接続タイムアウト」に60000ミリ秒未満の値を指定すると、RIDCソケット・タイムアウトが早くなり、長時間実行しているリクエストがタイムアウトする可能性が高くなるため、これを指定しないことをお薦めします。たとえば、長時間実行中の検索、長時間に及ぶファイルのアップロード、長時間に及ぶコピー操作などでタイムアウトが発生する可能性があります。

11. 「関連付けられている外部アプリケーション」ドロップダウン・リストから、WebCenter Content Serverでユーザーの認証に使用するアプリケーションを選択します。

ヒント:

アプリケーションがWebCenter Portalにまだ登録されていない場合は、ここで「新規作成」を選択してそれを登録します。詳細は、「Fusion Middleware Controlを使用した外部アプリケーションの登録」を参照してください。

12. 「管理者ユーザー名」フィールドに、このWebCenter Content Serverインスタンスの管理権限を持つユーザー名を入力します。

このユーザーは、プロファイルに基づいてコンテンツ・タイプ情報をフェッチするため、およびキャッシュ無効化の目的でドキュメントの変更を追跡するために使用されます。

デフォルトはsysadminです。

13. 「管理者パスワード」フィールドに、「管理者ユーザー名」フィールドで指定したユーザーのパスワードを入力します。

14. 「キャッシュ無効化間隔」フィールドに、外部のWebCenter Content Serverコンテンツの変更を何分間隔で確認するかを入力します。

変更されたアイテムは、WebCenter Portalによって自動的にキャッシュからクリアされます。最小間隔は2分です。

デフォルトではキャッシュ無効化は無効になっているため、コンテンツ変更の定期的な確認は行われません(0が表示されます)。

15. 「キャッシュされたドキュメントの最大サイズ(バイト)」に、WebCenter Content Serverバイナリ・ドキュメントの最大キャッシュ可能サイズ(バイト数)を入力します。

このサイズより大きいドキュメントは、WebCenter Portalによってキャッシュされません。

デフォルトは102400バイト(100KB)です。

ヒント:

この値は、マシンのメモリー構成およびキャッシュするバイナリ・ドキュメントのタイプに応じて調整してください。Coherenceが有効化されている場合を除き、キャッシュの最大合計サイズはありません。

Coherenceを使用している場合、バイナリ・キャッシュに使用するメモリー量合計を追加で指定できます。この理由により、どのタイプの本番環境にもCoherenceを使用することを強くお薦めします。これは、高可用性(HA)環境の要件です。詳細は、「コンテンツ・プレゼンタのキャッシュ設定の変更」を参照してください。

注意:

WebCenter Content Serverに格納されている大部分のドキュメントは、バイナリ・コンテンツ、つまりイメージ、プレーン・テキスト、Wordドキュメントなどとみなされます。唯一の例外はCDFデータ・ファイルに格納されるSite Studioコンテンツで、これは仮想コンテンツ・リポジトリ(VCR)キャッシュ(またはノード・キャッシュ)に個別にキャッシュされます。

16. 「OK」をクリックして接続を保存します。

17. 「テスト」をクリックして、作成した接続が機能するかどうかを検証します。

登録された接続がコンテンツ・マネージャ・タスク・フローおよびコンテンツ・プレゼンタ・タスク・フローで使用可能になり、WebCenter Portalでページに追加できるようになります。『Oracle WebCenter Portalでのポータルの構築』のコンテンツ・マネージャ・タスク・フローの使用に関する項も参照してください。

接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります(デフォルトはWC_Portal)。詳細は、「管理対象サーバーの起動と停止」を参照してください。

6.5.3 WLSTを使用したOracle WebCenter Content Serverの登録

WLSTコマンドcreateContentServerConnectionを使用して、Oracle WebCenter Content ServerをOracle WebCenter Portalに登録します。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのcreateContentServerConnectionに関する項を参照してください。

接続をWebCenter Portalに対するデフォルト接続として構成するには、isPrimary='true'を設定します。接続をプライマリとして指定する場合は、プライマリWebCenter Content Server接続に必要ないくつかの追加のプロパティを指定するために、setContentServerProperties WLSTコマンドを実行する必要があります。「WLSTを使用したOracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定」を参照してください。

注意:

デフォルトのWebCenter Content Serverの接続には、追加の接続プロパティを設定する必要があります。詳細は、「Oracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定」を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

新しい接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

コンテンツ・マネージャ・タスク・フローまたはコンテンツ・プレゼンタ・タスク・フローを使用している場合は、初期プロビジョニングが実行されるように、最初にWebCenter Content Serverを起動する必要があることに注意してください。

6.5.4 RIDCソケット・タイプに対するOracle WebCenter Content Server接続パラメータ

Oracle WebCenter Content Serverの接続に対して設定する必要がある構成パラメータは、RIDCソケット・タイプによって異なります。

表6-7 RIDCソケット・タイプに対するWebCenter Content Server接続パラメータ

接続パラメータ(WLSTコマンド引数)

RIDCソケット・タイプ: HTTP

RIDCソケット・タイプ: ソケット

RIDCソケット・タイプ: セキュア・ソケット

RIDCソケット・タイプ: JAX-WS

接続名

(name)

必須

必須

必須

必須

リポジトリ・タイプ

Oracle Content Server

Oracle Content Server

Oracle Content Server

Oracle Content Server

アクティブな接続

(isPrimary)

オプション

オプション

オプション

オプション

RIDCソケット・タイプ

(socketType)

Web

ソケット

ソケットSSL

JAX-WS

サーバー・ホスト

(serverHost)

該当なし

必須

必須

該当なし

サーバー・ポート

(serverPort)

該当なし

必須

デフォルトは4444です

必須

デフォルトは4444です

該当なし

Web URL

(url)

必須

http://host:port/webRoot/pluginRootの形式を使用します

該当なし

該当なし

該当なし

WebサービスURL

(url)

該当なし

該当なし

該当なし

必須

http://host:port/webRootの形式を使用します

クライアント・セキュリティ・ポリシー

(clientSecurityPolicy)

該当なし

該当なし

該当なし

グローバル・ポリシー・アタッチメント(GPA)が使用されていない場合は必須です。使用されている場合は、空白のままにしておく必要があります

Content ServerのネイティブWebサービスであるIdcWebLoginサービスに対して構成された対応するサーバー側のポリシーに一致する必要があります

接続タイムアウト

(timeout)

オプション

60000 (ミリ秒)未満の値を指定しないでください

ログイン・タイムアウトは30000 (ミリ秒)、RIDCソケット・タイムアウトは60000 (ミリ秒)にデフォルト設定されます

オプション

60000 (ミリ秒)未満の値を指定しないでください

ログイン・タイムアウトは30000 (ミリ秒)、RIDCソケット・タイムアウトは60000 (ミリ秒)にデフォルト設定されます

オプション

60000 (ミリ秒)未満の値を指定しないでください

ログイン・タイムアウトは30000 (ミリ秒)、RIDCソケット・タイムアウトは60000 (ミリ秒)にデフォルト設定されます

オプション

デフォルトは30000 (ミリ秒)です

認証方式

該当なし

必須

必須

該当なし

Webサーバー・コンテキスト・ルート

(webContextRoot)

該当なし

「認証メソッド」が「アイデンティティ伝播」に設定されている場合は必須

「認証メソッド」が「外部アプリケーション」に設定されている場合は該当なし

「認証メソッド」が「アイデンティティ伝播」に設定されている場合は必須

「認証メソッド」が「外部アプリケーション」に設定されている場合は該当なし

該当なし

関連付けられている外部アプリケーション

(extAppId)

必須

「認証メソッド」が「外部アプリケーション」に設定されている場合は必須

「認証メソッド」が「アイデンティティ伝播」に設定されている場合は該当なし

「認証メソッド」が「外部アプリケーション」に設定されている場合は必須

「認証メソッド」が「アイデンティティ伝播」に設定されている場合は該当なし

該当なし

管理者ユーザー名

(adminUserName)

オプション

デフォルトは、sysadminです

オプション

デフォルトは、sysadminです

オプション

デフォルトは、sysadminです

必須

デフォルトは、sysadminです

管理者パスワード

(adminPassword)

必須

該当なし

該当なし

オプション

パスワードが使用されるかどうかは、選択したJAX-WSセキュリティ・ポリシーに応じて異なります

キー・ストアの場所

(keystoreLocation)

該当なし

該当なし

必須

該当なし

キー・ストア・パスワード

(keystorePassword)

該当なし

該当なし

必須

該当なし

秘密鍵の別名

(privateKeyAlias)

該当なし

該当なし

必須

該当なし

秘密鍵のパスワード

(privateKeyPassword)

該当なし

該当なし

必須

該当なし

キャッシュ無効化間隔

(cacheInvalidationInterval)

オプション

デフォルトは0 (無効)です

オプション

デフォルトは0 (無効)です

オプション

デフォルトは0 (無効)です

オプション

デフォルトは0 (無効)です

キャッシュされたドキュメントの最大サイズ(バイト)

(binaryCacheMaxEntrySize)

オプション

デフォルトは102400バイトです

オプション

デフォルトは102400バイトです

オプション

デフォルトは102400バイトです

オプション

デフォルトは102400バイトです

6.6 Oracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定

デフォルトのコンテンツ・リポジトリは、ポータル関連のドキュメントを格納するためにWebCenter Portalによって使用されます。デフォルトのリポジトリには、いくつかの追加構成が必要です。

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

- Fusion Middleware Controlを使用したOracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定

- WLSTを使用したOracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定

6.6.1 Fusion Middleware Controlを使用したOracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定

ポータル・ドキュメントを格納するためにOracle WebCenter Portalによって使用されているOracle WebCenter Content Serverの接続の接続情報を表示、変更および削除できます。

警告:

ポータル・サーバー識別子またはセキュリティ・グループの値を個別に変更しないでください。常に両方を変更する必要があります。つまり、WebCenter Portalを構成し、実行した後にポータル・サーバー識別子の値を変更する場合は、セキュリティ・グループも変更する必要があります(逆の場合も同様です)。つまり、WebCenter Portalにすでにシード・データが格納されている場合は、両方(ポータル・サーバー識別子およびセキュリティ・グループ)の値を一意の値に変更する必要があります。

Fusion Middleware Controlを使用してデフォルトのWebCenter Content Serverの接続の接続プロパティを設定する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. デフォルト接続を選択し、「編集」をクリックします。

5. 「ポータル・サーバー識別子」フィールドに、WebCenter Portalコンテンツが格納されたWebCenter Content Serverのフォルダの名前を入力します。

形式/folderNameを使用します。

たとえば、/WebCenterまたは/WCPMain。

このフォルダはWebCenter Content Serverのルート・フォルダ(/)にはできず、これはアプリケーション間で一意である必要があります。フォルダが存在しない場合、それが作成されます。

注意:

この値を変更しても、WebCenter Content Server内の既存のシード・データの名前は変更されません。かわりに、WebCenter Portalを起動すると、新しい値を使用して新しいシード・データが作成されます。WebCenter Portalが起動すると、新しいフォルダの下に新しいデータが作成され、以前のフォルダの下の既存のデータは使用できなくなります。つまり、以前、ポータル・サーバー識別子の変更前にドキュメント・ツールが有効であったWebCenter Portalで、ドキュメント・ツールが無効化されます。

WebCenter Content Serverの他のすべてのルート・フォルダと同様、検索結果には引き続き以前のフォルダが表示されます。

警告:

ポータル・サーバー識別子を変更する場合は、セキュリティ・グループにも新しい値を指定する必要があります。

6. 「コンテンツ管理者」フィールドに、WebCenter Content Serverインスタンスの管理権限を持つユーザー名を入力します。

たとえば、sysadminです。

このユーザーは、WebCenter Portalコンテンツのフォルダの作成と維持や、コンテンツ・アクセス権限の管理に使用されます。WebCenter Portalユーザーにかわって操作を実行できるようにするために、デフォルト接続には管理権限が必要です。

7. 「セキュリティ・グループ」フィールドに、WebCenter Portalで作成されたWebCenter Content Serverのファイルに割り当てられたセキュリティ・グループの値として使用する一意の識別子を入力します。

この名前は、複数のWebCenter Portalインスタンスが同じWebCenter Content Serverインスタンスを共有している場合にデータを区別するために使用されます。

アプリケーション名は次のようにする必要があります。

- すべてのWebCenter Portalアプリケーション間で一意にします。

- 先頭がアルファベットで、その後は英数字またはアンダースコアの任意の組合せである必要があります。

- 30文字以下である必要があります。

警告:

セキュリティ・グループを変更する場合は、ポータル・サーバー識別子にも新しい値を指定する必要があります。

8. 「OK」をクリックして、変更を保存します。

更新した接続プロパティの使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります(デフォルトはWC_Portal)。

6.6.2 WLSTを使用したOracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定

WLSTコマンドを使用して、ポータル・ドキュメントを格納する場所を識別するためにOracle WebCenter Portalで使用されているOracle WebCenter Content Serverの接続のプロパティを表示、設定および削除します。

デフォルトのWebCenter Content Serverの接続に対して、次の値を設定する必要があります。

- portalServerIdentifier-WebCenter Portalコンテンツが格納されたWebCenter Content Serverのフォルダの名前を指定します。

- adminUserName-WebCenter Content Serverインスタンスに対する管理権限を持つユーザー名を指定します。

- securityGroup-フィールドに、WebCenter Portalで作成されたWebCenter Content Serverのファイルに割り当てられたセキュリティ・グループの値として使用する一意の識別子を指定します。

警告:

portalServerIdentifierまたはsecurityGroupの値を個別に変更しないでください。常に両方を変更する必要があります。つまり、WebCenter Portalを構成し、実行した後にportalServerIdentifierの値を変更する場合は、securityGroupの値も変更する必要があります(逆の場合も同様です)。つまり、WebCenter Portalにすでにシード・データが格納されている場合は、両方(portalServerIdentifierおよびsecurityGroup)の値を一意の値に変更する必要があります。

次のコマンドを使用します(コマンドの構文と詳細な例は、WebCenter WLSTコマンド・リファレンスのlinkedに関する項を参照してください)。

- listContentServerProperties

- setContentServerProperties

- deleteContentServerProperties

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

6.7 Oracle WebCenter Content Serverの接続の詳細の変更

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

- Fusion Middleware Controlを使用したOracle WebCenter Content Serverの接続の詳細の変更

- WLSTを使用したOracle WebCenter Content Serverの接続の詳細の変更

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

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

6.7.1 Fusion Middleware Controlを使用したOracle WebCenter Content Serverの接続の詳細の変更

Fusion Middleware Controlを使用して、Oracle WebCenter Content Serverの接続の詳細を変更できます。

Fusion Middleware Controlを使用してWebCenter Content Serverの接続の詳細を更新する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、Oracle WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。

パラメータの詳細は、「Fusion Middleware Controlを使用したOracle WebCenter Content Serverへの接続の作成」を参照してください。

6. 「テスト」をクリックして、更新した接続が機能するかどうかを検証します。

7. 「OK」をクリックして、変更を保存します。

8. 更新された接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

6.7.2 WLSTを使用したOracle WebCenter Content Serverの接続の詳細の変更

WLSTコマンドsetContentServerConnectionを使用して、Oracle WebCenter Content Serverの接続の詳細を編集します。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetContentServerConnectionに関する項を参照してください。

特定の接続をデフォルト接続として構成するには、isPrimary='true'を設定します。「WLSTを使用したOracle WebCenter Content Serverのデフォルト接続に対する接続プロパティの設定」を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

更新された接続の詳細の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

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

デフォルトでは、コンテンツ・プレゼンタはローカル(インメモリー)キャッシュを使用するように構成されています。ただし、本番環境のすべてのタイプでCoherenceを使用することをお薦めします。これは、高可用性(HA)環境での要件です。Coherenceの構成ファイルを変更することで、Coherenceでのコンテンツ・キャッシュを有効にできます。

注意:

ご使用のCoherenceのライセンスは、購入したライセンス・オプションによっては複数ノードの環境をサポートしない可能性があります。

キャッシュのメカニズムとしてCoherenceを有効化およびテストする手順は次のとおりです。

1. ORACLE_HOME/wcportal/webcenter/modules/oracle.webcenter.framework/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. サンプル・ファイル(例6-1)およびエントリの説明(表6-8)に基づいて、Coherence構成ファイルをローカル環境に合わせて変更します。

表6-8 content-coherence-cache-config.xml内のキャッシュ・エントリ

キャッシュ・エントリ名

説明

repo.ucm.nodeUidCache.*

IDに基づいてリポジトリのノードのリストを格納します。このキャッシュ・エントリのサイズは、アクティブなリポジトリ内のノードの数に依存します。このキャッシュは、ノード・データのリフレッシュ時期およびこのデータが他のアプリケーションから変更された回数に基づいて有効期限が切れます。

キー - ノードUID - 文字列

値 - Oracle WebCenter Content Serverノード・オブジェクト

repo.ucm.nodePathToUidCache.*

パスに基づいてリポジトリのノードのリストを格納します。このキャッシュのサイズは、デフォルトのリポジトリ内のノードの数に依存します。このキャッシュ・エントリは、ノード・データのリフレッシュ時期およびこのデータが他のアプリケーションから変更された回数に基づいて有効期限が切れます。サイズおよび有効期限は、nodeUidCacheのものと同じである必要があります。

キー - ノード・パス - 文字列

値 - ノードUID - 文字列

repo.ucm.securityInfoCache.*

ノードのキャッシュ済セキュリティ情報を格納します。このキャッシュのサイズは、リポジトリ内のノードの数に依存します。このキャッシュは、ノード・セキュリティ・データの更新頻度に基づいて有効期限が切れます。

キー - ノードUID - 文字列

値 - ノードのセキュリティ情報

repo.ucm.typeNameCache.*

コンテンツ・タイプ情報をキャッシュします。このキャッシュのサイズは、リポジトリ内のタイプの数に依存します。このキャッシュは、タイプ情報のリフレッシュ時期およびタイプが他のアプリケーションから変更された回数に基づいて有効期限が切れます。

キー - コンテンツ・タイプUID - 文字列

値 - ContentTypeオブジェクト

repo.ucm.typeNamesCache.*

WebCenter Content Serverが認識しているすべてのタイプ名をキャッシュします。すべてのタイプ名は同時に(単一キー)キャッシュされるため、同時に有効期限が切れます。

このキャッシュは、新しいタイプの作成または削除の頻度に基づいて有効期限が切れます。

キー - このキャッシュには1つのキーtypeNamesしかありません

値 - タイプ名のArrayList<String>

binaryCache.*

バイナリ・プロパティ・データをキャッシュします。リポジトリ構成プロパティbinaryCacheMaxEntrySizeより小さいバイナリのみキャッシュされます。

このキャッシュのサイズは、binaryCacheMaxEntrySize設定より小さいバイナリ・プロパティの使用回数と使用頻度に基づくか、またはバイナリ・キャッシュで使用されるメモリー容量の合計に基づきます。

このキャッシュは、バイナリ・データのリフレッシュ時期およびこのデータが他のアプリケーションから変更された回数に基づいて有効期限が切れます。

キー - ノードUIDおよびバイナリ・プロパティUID (nodeUid.propUid) - 文字列

値 - バイナリ・ストリーム・データ - byte[]

注意: WebCenter Content Serverに格納されているほとんどのドキュメントは、イメージ、プレーン・テキスト、Word文書などのバイナリ・コンテンツです。唯一の例外はCDFデータ・ファイルに格納されるSite Studioコンテンツで、これは仮想コンテンツ・リポジトリ(VCR)キャッシュ(またはノード・キャッシュ)に個別にキャッシュされます。

repo.ucm.searchCriteriaCache.*

WebCenter Content Serverの検索文法に基づいて、パラメータへの検索問合せセットをキャッシュします。このキャッシュのサイズは、繰り返し実行されることが予想される一意の検索の数に依存します。

最終的に未使用の検索の有効期限が切れて、キャッシュ・メモリーを抑えるように、有効期限を設定する必要があります。

キー - 検索問合せパラメータのセット。

値 - コンテンツ・サーバー用語での検索問合せパラメータのセット。

repo.ucm.indexedFieldsCache.*

リポジトリの索引付き(検索可能)システム・プロパティを保持します。このキャッシュには、次の3つのキーがあります。

- indexedFieldsは、WebCenter Content Serverのすべての索引付きフィールドを保持します。

- indexedFolderPropsは、フォルダの索引付きシステム・プロパティを保持します。

- indexedDocPropsは、ドキュメントの索引付きシステム・プロパティを保持します。

このキャッシュは、索引付きフィールドの変更頻度に基づいて有効期限が切れます。

キー - 文字列

値 - Map<String,Boolean>は、各索引付きプロパティ名のキー、およびそのプロパティも順序付けが可能かを示すブール値を保持します。

repo.ucm.securityUserCache.*

ローカル・ユーザー名(現在のアプリケーション)とWebCenter Content Server内の同じユーザーの名前との間のマッピングをキャッシュします。このキャッシュのサイズは、同時ユーザーまたはよくアクセスするユーザー、あるいはその両方の数に依存します。

このキャッシュは、ユーザー・アイデンティティ・マッピングの更新頻度に基づいて有効期限が切れます。

キー - ローカル・ユーザーID - 文字列

値 - WebCenter Content ServerのユーザーId - 文字列

repo.ucm.profileTriggerValueCache.*

ドキュメントが作成されたときに使用可能になるように、特定のプロファイルのプロファイル・トリガー値をキャッシュします。このキャッシュ内の最大エントリ数は、暗黙的にWebCenter Content Serverインスタンス上のプロファイルの最大数に制限されます。キャッシュ・エントリは小さいサイズです。プライマリ・エントリで異なるのは有効期限です。これは、プロファイル・トリガー・フィールドの値がWebCenter Content Server内で変更される頻度に依存します。これらの値は、プロファイルがWebCenter Content Serverシステム上で一旦構成されると変更されることはほとんどありません。そのため、有効期限を適切に設定する必要があります。

キー - WebCenter Content Serverプロファイル名 - 文字列

値 - WebCenter Content Serverのプロファイル・トリガー値 - 文字列

4. Coherenceが正しく構成されていることをテストできるように、setDomainEnv.shファイルに次を追加します。

JAVA_OPTIONS="${JAVA_OPTIONS} -Dtangosol.coherence.management=all"
export JAVA_OPTIONS

5. WC_Portalサーバーを再起動して、コマンド行からjconsoleと入力し、WC_Portalに対応するプロセスを選択してJConsoleを開き、それに接続します。

6. JConsoleの「MBean」タブでCoherenceを確認します。

注意:

- MBeanがJconsoleに表示されるには、キャッシュになんらかの内容が存在する必要があります。つまり、MBeanが存在するには、「コンテンツ・プレゼンタ」ページを作成し、アクセスしている必要があります。

- 「コンテンツ・プレゼンタ」ページが存在することで、キャッシュに移入されると、WC_Portalサーバーに接続されたJConsoleで、「Coherence」→「Cache」→「LocalCache」を開き、repo.ucm.*.{ucm-connection-name}の複数のエントリを表示できます。例: repo.ucm.typeNameCache.{ucm-connection-name}です

例6-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>

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

ここでは、変更が取得されようにContent Serverのキャッシュ無効化間隔を変更する方法について説明します。

この項には次のトピックが含まれます:

- Oracle WebCenter Content Serverのコントリビュータ・データ・ファイルの変更

- Oracle WebCenter Content Serverのキャッシュ無効化間隔の変更

- キャッシュ設定のテスト

6.7.4.1 Oracle WebCenter Content Serverのコントリビュータ・データ・ファイルの変更

コンテンツ・プレゼンタ・タスク・フローにより、Page-Edit権限を持つOracle WebCenter Portalユーザーはコンテンツの選択および表示をカスタマイズできます。コンテンツ・プレゼンタでは、コンテンツの単一アイテム、フォルダの下にあるコンテンツ、アイテムのリストまたはコンテンツの問合せを選択した後、WebCenter Portalのページでそのコンテンツをレンダリングするコンテンツ・プレゼンタ・テンプレートを選択できます。

コンテンツ・プレゼンタではOracle WebCenter Content Serverのフォルダとファイルが表示される他に、Oracle Site Studioとの統合により、Site Studioのコントリビュータ・データ・ファイル(WebCenter Content Serverドキュメント)をSite Studioリージョン・テンプレートまたはカスタム・コンテンツ・プレゼンタ表示テンプレートで作成、アクセス、編集および表示できます。コンテンツ・プレゼンタ表示テンプレートの作成の詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のコンテンツ・プレゼンタ表示テンプレートの開発に関する項を参照してください。

WebCenter Content Serverのコントリビュータ・データ・ファイルをWebCenter Content Serverを介して直接変更する場合があります。この操作は完全にサポートされています。ただし、コントリビュータ・データ・ファイルがWebCenter Portalを使用する以外の方法で変更される場合、同じデータ・ファイルを使用する実行中のWebCenter Portalページに、それらは即時には表示されません。これは、WebCenter Portalページではコンテンツ・プレゼンタを使用してデータ・ファイルのコンテンツを表示するが、WebCenter Portalはキャッシュされたバージョンのデータ・ファイルを使用しているためです。幸い、このような変更が即時に自動的に取得されるように、キャッシュを構成する方法があります。

6.7.4.2 Oracle WebCenter Content Serverのキャッシュ無効化間隔の変更

Oracle WebCenter Content Serverのキャッシュ無効化間隔を変更することで、キャッシュ・スイーパ・ユーティリティでキャッシュをモニターできるようになります。

キャッシュ・スイーパはWebCenter Content Serverの変更を問い合せて、変更があった場合、キャッシュに「ダーティ」というフラグを付けます。これにより、アプリケーションはWebCenter Content Serverからドキュメントの新規コピーを取得し、キャッシュされたバージョンをこれと置き換えます。

デフォルトでは、キャッシュ無効化間隔の初期値は0 (分)に設定されています。すなわち、スイーパはオフになっています。スイーパをオンにするには、値を(分単位で)設定する必要があります。設定できる最小値は2 (分)です。これは、Fusion Middleware Controlの「キャッシュ詳細」ページで、またはWLSTコマンドを使用して行うことができます。

この項には次のトピックが含まれます:

- Fusion Middleware Controlを使用したキャッシュ無効化間隔の変更

- WLSTを使用したキャッシュ無効化間隔の変更

6.7.4.2.1 Fusion Middleware Controlを使用したキャッシュ無効化間隔の変更

Fusion Middleware Controlを使用してキャッシュ無効化間隔を変更できます。

Fusion Middleware Controlを使用してキャッシュ無効化間隔を変更するには:

1. Fusion Middleware Controlにログインし、Oracle WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 「キャッシュ詳細」セクションで、キャッシュ無効化間隔を2 (最小許容時間)または同様の低い値に設定します。

注意:

一部のインスタンスでは、Fusion Middleware Controlでキャッシュ無効化間隔の値を一度設定(および保存)すると、値は固定化され、setContentServerConnectionのWLSTコマンドを使用して間隔の値を0に設定しなおすことしかできません。詳細は、「WLSTを使用したキャッシュ無効化間隔の変更」を参照してください。

6.7.4.2.2 WLSTを使用したキャッシュ無効化間隔の変更

setContentServerConnectionのWLSTコマンドを使用して、キャッシュ無効化間隔の値を更新できます。

次のようにコマンドを実行します。

setContentServerConnection(appName, name, [socketType, url, serverHost, serverPort, keystoreLocation, keystorePassword, privateKeyAlias, privateKeyPassword, webContextRoot, clientSecurityPolicy, cacheInvalidationInterval, binaryCacheMaxEntrySize, adminUsername, adminPassword, extAppId, timeout, isPrimary, server, applicationVersion])

例:

setContentServerConnection(appName='webcenter',name='UCM', socketType='socket', serverHost='webcenter.oracle.local', serverPort='4444', webContextRoot='/cs', cacheInvalidationInterval='2', binaryCacheMaxEntrySize='1024',adminUsername='sysadmin',isPrimary=1)

ヒント:

コマンドを実行するための他の必須パラメータ値を取得するために、listContentServerConnections(appName='webcenter',verbose=true)コマンドを使用できます。

注意:

変更を有効にするために、Oracle WebCenter Portal管理対象サーバー(WC_Portal)を再起動する必要があります。

6.7.4.3 キャッシュ設定のテスト

スイーパをオンにすると、変更されたキャッシュ・オブジェクトのみが無効化されます。

これをテストするには、イベントをモニターおよび報告するようにOracle WebCenter Content Serverを構成します。

イベントをモニターおよび報告するようにOracle WebCenter Content Serverを構成する手順は次のとおりです。

1. WebCenter Content Serverコンソール・アプリケーションにログインし、「管理」メニュー項目下の「システム監査情報」を選択します。

コンソールで左のメニュー表示オプションが使用されている場合、そこに「管理」リンクがあります。

2. 「トレース・セクション情報」で、「アクティブなセクション」にsystemとrequestauditのみを追加します。完全冗長トレースと「保存」を選択し、「更新」ボタンをクリックします。その後、「サーバー出力を表示」メニュー・オプションを選択します。ブラウザ・ビューが変更され、ログが表示されます。これが、WebCenter Content Serverを構成するために必要なすべてです。

たとえば、キャッシュ無効化間隔が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)

... other trace info ...

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. トレース・ログが適切にレポートされたら、次のステップではスイーパをテストするようにOracle 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がWebCenter Content ServerへのWebCenter Portal VCR接続によって呼び出されたことを示しています。VCR_GET_DOCUMENT_BY_NAME呼出しに注目してください。

これら2つのページの以降のリフレッシュでは、(WebCenter Content Serverのサーバー出力の表示をリフレッシュした後)同じVCR_GET_DOCUMENT_BY_NAME呼出しのトレースはないことがわかります。これは、ページはキャッシュからドキュメントを取得しているためです。

4. 次の手順では、Content Serverコンソールを使用して、バックドアでいずれかのドキュメントを変更します。これを行うには、データ・ファイル・ドキュメントを見つけて、コンテンツ情報ページでデータ・ファイルの編集を選択します。

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分ごとに実行されます。

WebCenter 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*****

6.8 Oracle WebCenter Content Serverの接続の削除

この項には次のトピックが含まれます:

- Fusion Middleware Controlを使用したOracle WebCenter Content Serverの接続の削除

- WLSTを使用したOracle WebCenter Content Serverの接続の削除

注意:

使用していないWebCenter Content Serverの接続のみ削除します。接続がデフォルト接続してマークされている場合は、アクティブ・リストからその接続を除外してから削除します。

6.8.1 Fusion Middleware Controlを使用したOracle WebCenter Content Serverの接続の削除

Fusion Middleware Controlを使用して、Oracle WebCenter Content Serverの接続を削除できます。

コンテンツ・リポジトリ接続を削除するには:

1. Fusion Middleware Controlにログインし、Oracle WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください

2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「コンテンツ・リポジトリ」を選択します。

4. 接続名を選択し、「削除」をクリックします。

5. この変更を有効にするには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

6.8.2 WLSTを使用したOracle WebCenter Content Serverの接続の削除

WLSTコマンドのdeleteContentServerConnectionを使用して、コンテンツ・リポジトリ接続を削除します。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのdeleteContentServerConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

この変更を有効にするには、Oracle WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項 を参照してください。

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

デフォルトでは、ファイルの最大アップロード・サイズは2GBです。

最大ファイル・アップロード・サイズをカスタマイズできます。詳細は、「コンテンツ・マネージャでのファイル・アップロード・サイズの変更」を参照してください。

6.10 コンテンツ・マネージャのDOCSの構成

コンテンツ・マネージャ・タスク・フローはHybrid Enterprise Content Managementもサポートし、これによりOracle Document Cloud Serviceのエンタープライズ・コンテンツに簡単に迅速にアクセスすることができます。コンテンツ・サーバーでDocument Cloud Service統合の設定を構成し、Oracle Document Cloud Serviceフォルダを作成する必要があります。詳細は、『Oracle WebCenter Contentの管理』のDocument Cloud Service統合の設定に関する項を参照してください。

Hybrid Enterprise Content Managementをサポートするには、「構造」ビューでドキュメントのプロパティをカスタマイズして、DOCS埋込みUIをストレッチする必要があります。

システム・ページでドキュメントのプロパティを設定するには、「システム・ページ」で、ドキュメント・ページの横の「カスタマイズ」リンクを選択し、region[Edit Task Flow]ノードを選択します。システム・ページのドキュメントのプロパティの設定の詳細は、「システム・ページのプロパティの設定」を参照してください。

タスク・フローの次のパラメータを設定します。

- 「パラメータ」タブでdimensionsFromをparentに設定します。
パラメータを設定するには、「リージョンのプロパティの表示」アイコンをクリックします。

- Display Optionsタブで、StretchContentをtrueに設定します
「表示オプション」を設定するには、showDetailFrameノードを選択し、「showDetailFrameのプロパティの表示」アイコンをクリックします。

- 「コンテンツ・スタイル」タブで、必要な高さを設定します。たとえば、800pxです。
「コンテンツ・スタイル」を設定するには、showDetailFrameノードを選択し、「showDetailFrameのプロパティの表示」アイコンをクリックします。

7 分析の管理

この章では、WebCenter Portalの分析を構成および管理する方法について説明します。分析により、ポータルの使用状況とパフォーマンス・メトリックを表示することができます。

WebCenter Portalのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後に行ったすべての構成変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。分析コレクタ構成に対するすべての変更は、分析データベースに格納されます。

注意:

Fusion Middleware ControlまたはWLSTを使用して分析の構成に対して加えた変更は動的ではないため、変更を有効にするには、分析コレクタまたはポータル・アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章の内容は次のとおりです。

- WebCenter Portalの分析について

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

- 分析の前提条件

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

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

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

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

- 分析データのパージ

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

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、WebCenter Portal管理を使用して付与されるAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

7.1 WebCenter Portalの分析について

WebCenter Portal管理者およびビジネス・ユーザーは、分析を使用することによって、ポータルの使用状況を追跡および分析できます。分析では、次の基本機能が提供されます。

- 使用状況トラッキング・メトリック: 分析は、コミュニティ、ページおよびポートレットの訪問を含む、一般的なポータル機能のメトリックを収集し、レポートします。

- 動作トラッキング: ユーザーはポータル・メトリックを分析して、ポータル訪問期間や、一定期間の使用状況などの使用パターンを特定できます。

- ユーザー・プロファイルの相関: ユーザーは、メトリック情報をユーザー・プロファイル情報と関係付けることができます。国、会社、都道府県などのユーザー・プロファイル・データを基準に、使用状況トラッキング・レポートを表示およびフィルタ処理できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』の問合せオプションに関する項を参照してください。

次の各項では、分析のコンポーネントと、すぐに使用可能なタスク・フローの概要を説明します。

- 分析のコンポーネント

- 分析タスク・フロー

7.1.1 分析のコンポーネント

図7-1は、WebCenter Portalにおける分析のコンポーネントを示しています。

- WC_Portal: Oracle WebCenter Portalおよび分析コレクタがデプロイされている管理対象サーバー。

- イベント・データ: 定義されたイベント・セットが分析によって追跡および収集されます。すぐに使用可能な最多発イベントの包括的なセットが付属しています。

- Open Usage API: OpenUsage APIによって、UDP (ユーザー・データグラム・プロトコル)を使用して分析コレクタにメトリックが送信されます。

- 分析コレクタ: 分析コレクタ・コンポーネントによって、イベント・データが収集されます。
分析コレクタをクラスタ化して、スケーラビリティと信頼性を高めることができます。

- 分析データベース: 分析データベース(ACTIVITIES)には、ポータル・イベントおよび非ポータル・イベントから収集されたメトリックが格納されます。

- 分析タスク・フロー: 分析によって、一般的なポータル機能のメトリックを報告する一連のタスク・フローが提供されます。

- MDS: タスク・フローのカスタマイズを格納するMetadata Service (MDS)リポジトリ。

図7-1 分析のコンポーネント

7.1.2 分析タスク・フロー

表7-1は、WebCenter Portalで使用可能な分析タスク・フローを示しています。これらのタスク・フローの詳細および使用方法は、『Oracle WebCenter Portalでのポータルの構築』の分析の概要に関する項を参照してください。

表7-1 WebCenter Portalでの分析タスク・フロー

分析タスク・フロー

説明

WebCenter Portalトラフィック

ポータル内の一般的なイベントのサマリー・ビュー。

ページ・トラフィック

ポータル内のページへのアクセス数と、いずれかのページにアクセスした一意のユーザー数が表示されます。

ログイン・メトリック

ポータルへのログインについて報告されます。

ポートレット・トラフィック

ポートレットの使用状況データが表示されます。

ポートレット・レスポンス時間

ポートレットのパフォーマンス・データが表示されます。

ポートレット・インスタンス・トラフィック

ポートレット・インスタンスの使用状況データが表示されます。

同じポートレットが複数のページに表示される場合は、各配置がポートレット・インスタンスとして考慮されます。

ポートレット・インスタンス・レスポンス時間

ポートレット・インスタンスのパフォーマンス・データが表示されます。

検索メトリック

ポータルの検索が追跡されます。

Wikiメトリック

最も人気が高い/低いwikiが追跡されます。

ブログ・メトリック

最も人気が高い/低いブログが追跡されます。

ディスカッション・メトリック

最も人気が高い/低いディスカッションが追跡されます。

ポータル・トラフィック

ポータルの使用状況データが表示されます。

ポータル・レスポンス時間

ポータルのページ・パフォーマンス・データが表示されます。

7.2 分析の構成ロードマップ

図7-2のフロー・チャートと表7-2のタスクは、WebCenter Portalで分析を動作させるための前提条件と必要なタスクの概要を示しています。

図7-2 WebCenter Portalで分析を使用するための構成

表7-2 WebCenter Portalで分析を使用するための構成

担当者

タスク

サブタスク

管理者

1.Oracle WebCenter Portalと、分析のバックエンド・コンポーネントをインストールします

管理者

2.(オプション)次のツールのいずれかを使用して、分析コレクタ設定を構成します

- システムMBeanブラウザ

- WLST

管理者

3.次のツールのいずれかを使用して、Oracle WebCenter Portalと分析コレクタ間の接続を構成します。

- Fusion Middleware Control

- WLST

WebCenter Portal管理者

4.分析データがWebCenter Portalで使用可能なことをテストします

4.a WebCenter Portalに管理者権限でログインします

4.b 分析ビジネス・ロールのメイン・ページを開いてライブ・データを表示します

http://host:port/webcenter/portal/system/Analytics

7.3 分析の前提条件

この項には次のトピックが含まれます:

- 分析: インストール

- 分析: 構成

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

- 分析: 制限事項

7.3.1 分析: インストール

分析コレクタはOracle WebCenter Portalのオプションのインストール・オプションです。この製品をインストールするには、Fusion Middleware構成ウィザードで「Oracle WebCenter Portal Analytics Collector」を選択します。インストール手順の詳細は、『Oracle WebCenter Portalのインストールおよび構成』を参照してください。

分析スキーマ(ACTIVITIES)とWebCenter Portalスキーマ(WEBCENTER)は、同じデータベースにインストールすることも、別々のデータベースにインストールすることもできます。

7.3.2 分析: 構成

分析コレクタは、インストールのデフォルトを使用して、初期設定でイベントを受信するように構成されています。デフォルト値がインストール環境に適さない場合や、クラスタを使用している場合は、WLSTまたはMBeanブラウザを使用して別の値を構成できます。詳細は、「分析コレクタ設定の構成」を参照してください。

ただし、初期設定では、WebCenter Portalは、分析コレクタにイベントを送信するようには構成されていません。WebCenter Portalの使用状況とパフォーマンス・メトリックを収集する場合は、分析コレクタを登録してイベント収集を有効にする必要があります。詳細は、「アプリケーション用の分析コレクタの登録」を参照してください。接続されると、分析データが収集され、それ以上の構成なしに(分析タスク・フローを介して)アプリケーションに表示されます。

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

WebCenter Portalのリソース・カタログでは、適切な権限を持つユーザーにのみ分析タスク・フローが表示されます。

- 管理者: Administratorロールを持つユーザーはすべての分析タスク・フローにアクセスできます

- ポータル・マネージャ: 特定のポータル内でPortal Managerロールを持つメンバーは、そのポータルの使用状況データを表示する分析タスク・フローにアクセスできます

分析の使用状況データは、ポータル分析には有益ですが、ポータル・ユーザーの個人データまたは機密データとみなされる場合があります。WebCenter Portalの管理者および個別のポータル・マネージャは、使用状況メトリックに関連するセキュリティとプライバシの権利を保護するために、ページのセキュリティを管理し、分析データを公開するページにアクセスできるユーザーを、指定された適切なユーザーのみに制限する必要があります。『Oracle WebCenter Portalでのポータルの構築』の分析の概要に関する項を参照してください。

7.3.4 分析: 制限事項

分析タスク・フローにはカスタム・イベント情報は表示されません。

7.4 分析コレクタ設定の構成

分析コレクタは、インストール時に、次のデフォルト値を使用してイベントを受信するように構成されます。

- コレクタ・ホスト名: localhost

- デフォルト・ポート: 31314

- 最大ポート番号: 31314

- ブロードキャスト・タイプ: ユニキャスト

- クラスタリング: クラスタリング設定は適用されません。クラスタリングはこのバージョンではサポートされません。

注意:

WebCenter Portalで使用されているデータベースがAL16UTF16以外に設定されている各国語文字セットを使用する場合、分析起動リスナーは起動に失敗する可能性があります。「各国語文字セット」オプションは、データベースの作成時にDatabase Configuration Assistantで構成します。発生する可能性のある問題を回避するために、「各国語文字セット」の設定をデフォルト値AL16UTF16のままにすることをお薦めします。

これらのデフォルト値がインストール環境に適さない場合や、クラスタを使用している場合は、WLSTを使用するか、またはFusion Middleware ControlでMBeanブラウザを使用して、適切な値を構成できます。

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

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

これらの分析コレクタ構成設定は分析データベース(ACTIVITIES)に格納されます。

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

WLSTコマンドのsetAnalyticsCollectorConfigを使用して、分析コレクタのイベント収集プロパティを設定します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetAnalyticsCollectorConfigに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

プロパティ値の使用を開始するには、分析コレクタ・アプリケーションがデプロイされている管理対象サーバー(WC_Portal)を再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

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

分析コレクタのイベント収集プロパティを設定するには、Fusion Middleware ControlでシステムMBeanブラウザを使用します。

分析コレクタ(デプロイ場所: 管理対象サーバーWC_Portal)を構成する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、次を参照してください。

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

2. システムMBeanブラウザを開きます。「WebCenter Portal」メニューから、「システムMBeanブラウザ」を選択します。

3. 次の場所に移動します。「アプリケーション定義のMBean」→「oracle.webcenter.analytics」→「サーバー: WC_Portal」→「アプリケーション: analytics-collector」→「CollectorConfiguration」→「構成」

または、CollectorConfigurationを検索するか、MBeanパターンoracle.webcenter.analytics:*を使用してシステムMBeanブラウザ・ツリーをフィルタ処理します。

図7-3 システムMBeanブラウザ: 分析コレクタ・プロパティ

4. 分析コレクタの構成プロパティを変更します。詳細については、表7-3を参照してください。

表7-3 分析コレクタ: 構成プロパティ

フィールド

説明

BroadcastType

分析コレクタがハートビートをブロードキャストして、その位置をイベント・プロデューサに通知するネットワーク・チャネルを指定します。有効な値はBroadcastおよびMulticastです。

Broadcast: 標準のネットワーク・ブロードキャスト・チャネルを使用します。

Multicast: 指定された固定マルチキャスト・アドレスを使用します。

ClusterEnabled

クラスタリング設定は適用されません。クラスタリングはこのバージョンではサポートされません。

ClusterName

クラスタリング設定は適用されません。クラスタリングはこのバージョンではサポートされません。

CollectorHeartbeatFrequency

クラスタリング設定は適用されません。クラスタリングはこのバージョンではサポートされません。

CollectorDefaultPort

分析コレクタがリスニングするデフォルト・ポート番号を入力します。デフォルト値は31314です。

CollectorHostName

分析コレクタを実行しているホスト名を入力します。

デフォルト設定はlocalhostです。

CollectorMaximumPort

分析コレクタがリスナーの割当て時に使用できる最大ポート番号を入力します。

このプロパティは、ほとんどの場合、同じボックスで複数のコレクタが稼働するクラスタ化環境で使用されます。各コレクタは、指定されているポート範囲内の空きポートで受信UDPメッセージをリスニングします。範囲は、デフォルト・ポート番号からmaxPort番号までです。

5. 新しい設定の使用を開始するには、分析コレクタ・アプリケーションがデプロイされている管理対象サーバー(WC_Portal)を再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

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

OpenUsage APIを使用してWebCenter Portalで発生したイベントを分析コレクタに送信できます。送信したイベントは、分析で使用されます。これらのツールが提供するいずれかの機能またはタスク・フローを使用する場合は、WebCenter Portalを分析コレクタに接続する必要があります。

WebCenter Portalに対して複数の分析コレクタ接続を登録できますが、使用される分析コレクタは1つ(つまり、デフォルト(またはアクティブな)接続)のみです。

新しい構成の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

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

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

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

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

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

WebCenter Portal用に分析コレクタを登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「サービス構成」ページを開きます。「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「分析」を選択します。

4. 分析コレクタに接続するには、「追加」をクリックします(図7-4)。

図7-4 分析コレクタ接続の構成

5. この接続の一意の名前を入力します。

この名前は、WebCenter Portalのすべての接続タイプ間で一意である必要があります。

図7-5 分析コレクタ接続の追加

6. この接続を分析に使用する場合は、「アクティブな接続」を選択します。

WebCenter Portalに対して複数の分析コレクタ接続を登録できますが、使用される接続は1つのみであり、デフォルト(またはアクティブな)接続が使用されます。

7. OpenUsage APIによって生成された分析イベントを分析コレクタに送信するには、「WebCenterポータル・イベント収集の有効化」を選択します。

分析データを収集しない場合は、このオプションの選択を解除します。

8. 分析コレクタの接続の詳細を入力します。詳細は、表7-4を参照してください。

表7-4 分析コレクタ接続: 接続の詳細

フィールド

説明

メッセージング・モード

このプロパティでは、イベントをクラスタ化された分析コレクタにマルチキャスト・モードで送信するか、または単一の分析コレクタにユニキャスト通信を使用して送信するかを指定します。現在のリリースでは分析コレクタのクラスタリングはサポートされていないため、このリリースの有効な値はUnicastのみです。

コレクタ・ホスト名

メッセージング・モードをUnicastに設定した場合は、分析コレクタを実行しているホスト名を入力します。

デフォルト設定はlocalhostです。

コレクタ・ポート

分析コレクタがイベントをリスニングするポートを入力します。デフォルト値は31314です。

9. 「OK」をクリックして保存します。

10. 新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

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

WLSTコマンドのcreateAnalyticsCollectorConnectionを使用して、WebCenter Portal用に分析コレクタ接続を作成します。既存の接続を更新するには、setAnalyticsCollectorConnectionを使用します。コマンドの構文と例は、『WebLogic Server WLSTコマンド・リファレンス』のcreateAnalyticsCollectorConnectionに関する項およびsetAnalyticsCollectorConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しい接続の使用を開始するには、isEnabled=1およびdefault=1であることを確認してから、WebCenter Portalがデプロイされている管理対象サーバーを再起動します。『WebLogic Server WLSTコマンド・リファレンス』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

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

OpenUsage APIによって生成されるイベントを収集しない場合は、イベント送信を一時的または永続的に停止できます。

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

- Fusion Middleware Controlを使用したWebCenter Portalイベント収集の無効化

- WLSTを使用したWebCenter Portalイベント収集の無効化

7.5.3.1 Fusion Middleware Controlを使用したWebCenter Portalイベント収集の無効化

WebCenter Portalのイベント収集を無効化する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「サービス構成」ページを開きます。「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「分析」を選択します。

4. 表で接続を選択して「編集」をクリックします。

5. 「WebCenterポータル・イベント収集の有効化」の選択を解除します(図7-6)。

図7-6 分析イベント収集の無効化

6. この変更を有効にするには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

7.5.3.2 WLSTを使用したWebCenter Portalイベント収集の無効化

WLSTを使用してイベントの収集を無効化するには、isEnabled引数を0 (false)に設定したsetAnalyticsCollectorConnectionコマンドを実行します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetAnalyticsCollectorConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

7.6 分析イベント収集の検証

次の場所にあるトレース・ログを調べることによって、イベントが分析コレクタに到達するかどうかを確認できます。

<base_domain_name>/servers/WC_Portal/logs/analytics-collector/collector.trc

イベント・メッセージは次のようなものです。

[2015-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_Portal_port/collector

このページに表示される内容は次のとおりです。

- コレクタのデフォルト・ポート

- コレクタの最大ポート

- コレクタのサーバー名

- ブロードキャスト・タイプ

- クラスタ有効

- クラスタ名

- パーティショニング有効

- 今年の時間ディメンション

- スペース・ディメンションが存在(WebCenter Portalの場合)

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

分析コレクタが収集を行うよう構成されているイベントを表示するには、Fusion Middleware ControlでシステムMBeanブラウザを使用します。

分析イベントの現在のリストを表示するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. システムMBeanブラウザを開きます。「WebCenter Portal」メニューから、「システムMBeanブラウザ」を選択します。

3. 次の場所に移動します。「アプリケーション定義のMBean」→「oracle.webcenter.analytics」→「サーバー: WC_Portal」→「アプリケーション: analytics-collector」→「CollectorServices」→「サービス」

または、CollectorServicesを検索するか、MBeanパターンoracle.webcenter.analytics:*を使用してシステムMBeanブラウザ・ツリーをフィルタ処理します。

4. 「操作」タブを選択します。

図7-7 システムMBeanブラウザ: 分析イベントの登録

5. 「listRegisteredEventTypes」をクリックします。

6. 「起動」をクリックします。

または、WLSTコマンドlistAnalyticsEventTypesを使用します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのlistAnalyticsEventTypesに関する項を参照してください。

7.8 分析データのパージ

分析データのパージの詳細は、『Oracle Fusion Middlewareの管理』のOracle WebCenter Portal分析データのパージに関する項を参照してください。

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

分析データのパーティション化の詳細は、『Oracle Fusion Middlewareの管理』のOracle WebCenter Portal分析データのパーティション化に関する項を参照してください。

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

この章では、WebCenter Portalのお知らせおよびディスカッションを構成および管理する方法について説明します。お知らせおよびディスカッションは両方とも、WebCenter Portalのディスカッション・サーバーへの同一の接続を使用します。

特に明記しないかぎり、WebCenter Portalのディスカッション・サーバー内では構成変更を行わないでください。WebCenter Portalのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。WebCenter Portalのディスカッション・サーバーに関するトラブルシューティングのヒントは、「お知らせおよびディスカッションに関する問題のトラブルシューティング」を参照してください。

デプロイ後に加えた構成変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用して行ったディスカッションとお知らせの構成の変更は動的ではありません。変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

問題のトラブルシューティングは、「お知らせおよびディスカッションに関する問題のトラブルシューティング」を参照してください。

この章の内容は次のとおりです。

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

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

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

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

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

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

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

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

- ディスカッション・サーバー接続のテスト

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

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

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

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、WebCenter Portal管理を使用して付与されるAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

トラブルシューティングの詳細は、「お知らせおよびディスカッションに関する問題のトラブルシューティング」を参照してください。

重要
Oracleでは、Jive Softwareからの組込みディスカッション・サーバーをサポートしています。Oracleでは、WebCenter Portalタスク・フローで使用可能なJiveの機能をサポートしています。Jive WebServiceレイヤーのAPIを使用するカスタム開発は、Oracleによる再検討の対象となっているため、サポートされていません。Jive Softwareがディスカッション・サーバーの一部として配信している他の機能は、Oracle推奨ではなく、サポートされていません。参照専用として、Jive Forumsのドキュメントが付属しています。WebCenter Portal製品のインストール対象外となるJive Softwareのインストールおよびアップグレードは、サポートされません。

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

お知らせおよびディスカッションにより、ユーザーは、WebCenter Portalでのディスカッションを開始、公開および保管できるようになります。ユーザーは、お知らせおよびディスカッションをポータル・ページに作成して公開できます。

ディスカッションおよびお知らせには、WebCenter Portalのディスカッション・サーバーへの単一の接続が必要です。WebCenter Portalのディスカッション・サーバーは、Oracle Fusion Middlewareを使用してインストールできます。

Fusion Middleware ControlコンソールまたはWLSTを使用して追加のディスカッション・サーバー接続を登録できますが、一度にアクティブにできる接続は1つのみです。次を参照してください。

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

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

WebCenter Portalでディスカッションおよびお知らせを使用するには、いくつかの追加構成が必要になります。これには、WebCenter Portalのすべてのディスカッションおよびお知らせを格納する(ディスカッション・サーバー上の)カテゴリの選択などが含まれます。この構成はWebCenter Portal内で行います。詳細は、「WebCenter Portalのディスカッション・フォーラム・オプションの構成」を参照してください。

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

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

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

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

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

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

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

WebCenter Portalのインストール時に、WebCenter Portalのディスカッション・サーバーのインストールを選択します。リポジトリ作成ユーティリティ(RCU)を使用してDISCUSSIONSスキーマを作成します。

Oracle Fusion Middleware構成ウィザードによって、選択したWebCenter Portalコンポーネントをホストする管理対象サーバーがドメインに自動的に作成されます。

関連項目:

『Oracle WebCenter Portalのインストールおよび構成』のOracle WebCenter Portalのインストールおよび構成に関する項。

注意:

クラスタ化キャッシュを有効にしていると、ディスカッション・コンテンツへの更新がすぐにはリフレッシュされなくなります。ユーザーは、「リフレッシュ」アイコンをクリックして、いつでも手動リフレッシュを強制実行できます。

ディスカッション・サーバー: 高可用性インストール

WebCenter Portalのディスカッション・サーバーを高可用性に対応するように設定する手順は次のとおりです。

1. クラスタ化された環境にWC_Collaborationドメインをインストールします。

2. 次のURL書式を使用して、管理者としてディスカッション・サーバー管理コンソールにログオンします(http://host:port/owc_discussions/admin)。

3. 「キャッシュ設定」ページに移動(ページ上部の「システム」リンクをクリックして「キャッシュ設定」を選択)して、キャッシュ機能セクションまでスクロール・ダウンし、クラスタリングの有効化を選択します(図8-1)。

図8-1 キャッシュ機能: クラスタリング

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

注意:

新規またはパッチ適用済のWebCenter Portalインスタンスでは、割り当てられたセキュリティ・ポリシーの構成は、セキュリティ・ポリシーなしに設定されます。Oracle Web Services Manager (OWSM)のセキュリティ・ポリシーを、WebCenter PortalのWebサービス・エンドポイントおよびディスカッションの認証Webサービス・エンドポイントに添付する必要があります。

詳細は、「WebCenter PortalおよびディスカッションWebサービス・エンドポイントに対するセキュリティ・ポリシーの添付」を参照してください。

ディスカッション・サーバーを構成するための多数のWLSTコマンドがあります。

表8-1で説明されているように、次のWLSTコマンドを使用して、WebCenter Portalのディスカッション・サーバーのシステム・プロパティを表示、設定および削除できます。

注意:

syncDiscussionServerPermissionsなどの、ディスカッション・サーバーのWLSTコマンドを実行するには、管理サーバーに接続するユーザーは、ディスカッション・サーバーの管理権限も同時に所持している必要があります。

WLSTコマンドの詳細は、『WebLogic Server WLSTコマンド・リファレンス』のディスカッションおよびお知らせに関する項を参照してください。

表8-1 ディスカッション・サーバーのWLSTコマンド

WLSTコマンド

用途

詳細

getDiscussionsServerProperty

ディスカッション・サーバーのプロパティ値を返します

『WebLogic Server WLSTコマンド・リファレンス』のgetDiscussionsServerPropertyに関する項を参照してください。

setDiscussionsServerProperty

ディスカッション・サーバーのプロパティを設定します

『WebLogic Server WLSTコマンド・リファレンス』のsetDiscussionsServerPropertyに関する項を参照してください。

removeDiscussionsServerProperty

現在設定されているディスカッション・サーバーのプロパティ値を削除します

『WebLogic Server WLSTコマンド・リファレンス』のremoveDiscussionsServerPropertyに関する項を参照してください。

addDiscussionsServerAdmin

ディスカッション・サーバーのシステム管理者権限をユーザーまたはグループに付与します

このコマンドは、現在の管理者のいずれも含まない新しいアイデンティティ・ストアにディスカッション・サーバーを接続する際に役立ちます。

『WebLogic Server WLSTコマンド・リファレンス』のaddDiscussionsServerAdminに関する項を参照してください。

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

- WS-Securityによって、WebCenter PortalとWebCenter Portalのディスカッション・サーバーとの間に信頼関係を確立すると、WebCenter Portalは、ユーザーの資格証明がなくてもディスカッション・サーバーにユーザー・アイデンティティ情報を渡せるようになります。
「Webサービス・セキュリティの構成」のいずれかの手順に従って、WebCenter Portalのディスカッション・サーバーのOWSM WS-Securityを構成します。

- WebCenter Portalからディスカッション・サーバーに送信される、WebCenter Portalのディスカッション・サーバー固有のWebサービス・メッセージは暗号化されません。メッセージの機密保護のために、Secure Socket Layer (SSL)を介してディスカッション・サーバーのURLにアクセスするか、OWSMポリシーでWebサービスのエンド・ポイントを保護してください。詳細は、「SSLの構成」および「Webサービス・セキュリティの構成」を参照してください。

- WebCenter Portalのディスカッション・サーバーはフォルトで、組込みLDAPアイデンティティ・ストアを使用するように構成されています。組込みLDAPストア内のすべてのユーザーがディスカッション・サーバーにログオンできます。また、Administratorsグループ内のすべてのユーザーがディスカッション・サーバーの管理権限を所持します。
本番環境では、アイデンティティ・ストアを外部LDAPサーバーに再度関連付ける必要があります(「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」を参照)。さらに、システム管理者アカウントを外部LDAPに移行するか(「外部LDAPサーバーへの管理者アカウントの移行」を参照)、管理者アカウントを移行しない場合は、ディスカッション・サーバーの新しい管理者アカウントを識別するために追加の手順が必要になります(「外部LDAPを使用するためのディスカッション・サーバーの移行」を参照)。

- WebCenter Portalのディスカッション・サーバーとその他のWebCenter Portalのコンポーネントにアクセスするときに、ユーザーが2回ログインする必要がないように、シングル・サインオン・ソリューションをインストールして構成することをお薦めします。Oracle Access Manager、Oracle Single Sign-OnまたはSAMLベースのシングル・サインオンを使用したシングル・サインオン・セキュリティを利用するように、ディスカッション・サーバーを構成できます。

注意:

SSOの構成後は、ディスカッション・サーバーへの直接のログインはサポートされません。Oracle HTTP Server URLからログインします。

シングル・サインオン・ソリューションの詳細は、「シングル・サインオンの構成」を参照してください。Oracle Access Manager (OAM)のディスカッション固有の追加構成手順は、「SSO用のディスカッション・サーバーの構成」を参照してください。

注意:

WebCenter Portalをソース・アプリケーションとし、WebCenter Portalのディスカッション・サーバーをターゲット・アプリケーションとして、SAMLシングル・サインオンを設定した場合は、WebCenter PortalからWebCenter Portalのディスカッション・サーバーの管理ページに次のようにアクセスできます。

- 「管理」→「ツールとサービス」
「ディスカッション・サーバー管理コンソールへのアクセス」を参照してください。

- Portal_Name→「設定」→「ツールとサービス」

ただし、WebCenter Portalのディスカッション・サーバーの管理ページはシングル・サインオンに参加しないため、管理ページに直接アクセスすると、ディスカッション・サーバーへの再ログインが求められます。

- WebCenter Portalがシングル・サインオン・ソリューションに統合されていない場合は、owc_discussionユーザー(/owc_discussions)とowc_discussion管理ユーザー(/owc_discussions/admin)で異なるログイン・セッションが必要になります。

- ユーザー・アイデンティティ: ユーザー・アイデンティティ管理は、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のディスカッション・サーバーを再起動します。それによって、適切な初期化がアプリケーションに対して実行されるようになります。

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

WebCenter Portalのディスカッション・サーバーURLでは、ラベルの表示に英語とスペイン語のみをサポートしていますが、UTF-8形式でのデータの入力が可能です。ディスカッション・サーバーでのユーザーの操作には、WebCenter Portal (すべてのサポート対象言語を含む)を使用することをお薦めします。ディスカッション・トピックやお知らせなどのデータで、WebCenter Portalでサポートされているすべての言語がサポートされ、ディスカッション・サーバーでも表示されます。

WebCenter PortalインスタンスがMicrosoft Windows上でネイティブ・エンコーディングで実行されている場合、ディスカッションとお知らせでは、ASCII以外のユーザー名がサポートされません。Linux環境の場合、ディスカッションとお知らせでASCII以外のユーザー名をサポートするには、WebCenter Portalがデプロイされているサーバーの環境変数LC_ALLをutf-8に設定しておく必要があります。

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

WebCenter Portalには複数のディスカッション・サーバー接続を登録できますが、一度にアクティブにできる接続は1つのみです。

新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

この項には次のトピックが含まれます:

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

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

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

ディスカッション・サーバーを登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、アプリケーションのホームページに移動します。

詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「ディスカッションおよびお知らせ」を選択します。

4. 新規のディスカッション・サーバーに接続するには、「追加」をクリックします(表8-3)。

図8-2 ディスカッションおよびお知らせ接続の構成

5. この接続の一意の名前を入力し、この接続をWebCenter Portalのアクティブな(またはデフォルトの)接続にするかどうかを指定します(表8-2)。

表8-2 ディスカッションおよびお知らせ接続: 名前

フィールド

説明

接続名

接続の一意の名前を入力します。

この名前は、WebCenter Portalのすべての接続タイプ間で一意である必要があります。

アクティブな接続

これを選択すると、この接続がWebCenter Portalでディスカッションおよびお知らせに使用されます。

1つのアプリケーションに対して複数のディスカッション・サーバー接続を登録できますが、ディスカッションとお知らせに使用される接続はデフォルトの(またはアクティブな)接続1つのみです。

6. ディスカッション・サーバーの接続の詳細を入力します。詳細は、表8-3を参照してください。

表8-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エンドポイントに適用)を入力します。これは、構成されたキーストアにある、ディスカッション・サーバーの公開鍵を含む証明書の別名です。

「Webサービス・セキュリティの構成」も参照してください。

7. ディスカッションおよびお知らせ接続の詳細オプションを構成します(表8-4)。

表8-4 ディスカッションおよびお知らせ接続: 詳細構成

フィールド

説明

接続タイムアウト(秒)

接続の適切なタイムアウトを指定します。

これは、WebCenter Portalが接続タイムアウト・メッセージを発行するまでにディスカッション・サーバーからのレスポンスを待機する時間(秒)です。

デフォルトは、-1です。これは、サービスのデフォルトが使用されることを示します。サービスのデフォルトは10秒です。

8. ディスカッション・サーバーへの接続には、追加のパラメータ(表8-5に示すものなど)が必要になる場合があります。

表8-5 追加のディスカッション接続プロパティ

追加の接続プロパティ

説明

application.root.category.id

(WebCenter Portalのみ)すべてのディスカッション・フォーラムを格納する、ディスカッション・サーバー上のアプリケーション・ルート・カテゴリID。たとえば、3に設定すると、すべてのフォーラムがID 3のカテゴリに格納されます。

linkURL

ユーザーをディスカッション・サーバーの管理コンソールにリンクするために使用するURL。「サーバーURL」プロパティと異なる場合にのみ、指定する必要があります(たとえば、SSOまたはHTTPSが構成されている場合)。

別のパブリック外部URLを指定する場合は、次の形式を使用します。protocol://host:port

例: http://example.com:7777

ディスカッション・サーバーへの接続に追加のパラメータが必要な場合は、「追加プロパティ」を開き、必要な詳細を入力します(表8-6)。

表8-6 ディスカッションおよびお知らせ接続: 追加プロパティ

フィールド

説明

追加

「追加」をクリックして、追加の接続パラメータを指定します。

- プロパティ名: 接続プロパティの名前を入力します。

- プロパティ値: プロパティのデフォルト値を入力します。

- プロパティはセキュアか: 暗号化が必要かどうかを指定します。選択した場合、プロパティの値は、暗号化を使用してセキュアに格納されます。
たとえば、この値が実際のパスワードである場合、admin.passwordプロパティを保護するためにこのオプションを選択します。

削除

「削除」をクリックして、選択したプロパティを削除します。

「削除」をクリックする前に、正しい行を選択します。

注意: 「OK」をクリックするまで、削除された行は無効として表示されます。

9. 「OK」をクリックして、この接続を保存します。

10. 新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

WebCenter Portalの場合、ディスカッションに対していくつかの追加構成を行うことをお薦めします。詳細は、「WebCenter Portalのディスカッション・フォーラム・オプションの構成」を参照してください。

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

WLSTコマンドのcreateDiscussionForumConnectionを使用して、ディスカッション・サーバー接続を作成します。コマンドの構文と例は、『WebLogic Server WLSTコマンド・リファレンス』のcreateDiscussionForumConnectionに関する項を参照してください。

新規の接続をアクティブに使用するようにディスカッションおよびお知らせを構成するには、default=trueを設定します。

WS-Security用の追加プロパティを必ず設定します。「WLSTを使用したディスカッション・サーバー接続の詳細の変更」を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

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

WebCenter Portalには複数のディスカッション・サーバー接続を登録できますが、一度にアクティブにできる接続は1つのみです。アクティブな接続は、次のもののバックエンド・ディスカッション・サーバーになります。

- ディスカッション・タスク・フロー(ディスカッション・フォーラム・マネージャ、ディスカッション、ポピュラー・トピック、最近のトピック、監視フォーラム、監視トピック)

- お知らせタスク・フロー(お知らせマネージャ、お知らせ)

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

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

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

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

アクティブな接続を変更するには:

1. Fusion Middleware Controlにログインし、アプリケーションのホームページに移動します。

詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「ディスカッションおよびお知らせ」を選択します。

「ディスカッションおよびお知らせ接続の管理」表に、現在のアクティブな接続(ある場合)が示されます。

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」をクリックします。

5. 「アクティブな接続」チェック・ボックスを選択します。

6. 「OK」をクリックして、接続を更新します。

7. 新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

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

WLSTコマンドのsetDiscussionForumConnectionをdefault=trueで使用して、既存の接続をアクティブ化します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetDiscussionForumConnectionに関する項を参照してください。

ディスカッションおよびお知らせの接続を無効にするには、その接続を削除するか、別の接続を「アクティブな接続」にするか、またはremoveDiscussionForumServicePropertyコマンドを使用します。

removeDiscussionForumServiceProperty('appName='webcenter', property='selected.connection')

このコマンドを使用すると、接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。詳細は、WebCenter WLSTコマンド・リファレンスのremoveDiscussionForumServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

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

ディスカッション・サーバー接続の詳細はいつでも変更できます。

変更後の(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

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

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

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

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

ディスカッション・サーバー接続の詳細を更新する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、アプリケーションのホームページに移動します。

詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「ディスカッションおよびお知らせ」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータの詳細は、表8-3および表8-5を参照してください。

6. 「OK」をクリックして、変更を保存します。

7. 更新された(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

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

WLSTコマンドのsetDiscussionForumConnectionを使用して、接続の詳細を編集します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetDiscussionForumConnectionに関する項を参照してください。

追加パラメータを設定するには、setDiscussionForumConnectionPropertyコマンドを使用します。詳細は、WebCenter WLSTコマンド・リファレンスのsetDiscussionForumConnectionPropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

更新された(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

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

ディスカッション・サーバー接続はいつでも削除できますが、アクティブな接続を削除する際には注意が必要です。ディスカッション・タスク・フローとお知らせタスク・フローはいずれもバックエンド・ディスカッション・サーバーを必要とするため、アクティブな接続を削除すると機能しなくなります。

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

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

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

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

ディスカッション・サーバー接続を削除するには:

1. Fusion Middleware Controlにログインし、アプリケーションのホームページに移動します。

詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「ディスカッションおよびお知らせ」を選択します。

4. 接続名を選択し、「削除」をクリックします。

注意:

管理対象サーバーを再起動する前に、他の接続をアクティブとして選択してください。そうしないとディスカッションおよびお知らせの機能が無効になります。

5. この変更を行うには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

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

WLSTコマンドのdeleteConnectionを使用して、接続を削除します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのdeleteConnectionに関する項を参照してください。

別の接続がアクティブとしてマークされていることを確認します。アクティブな接続がないと、ツールが無効化されます。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

この変更を有効にするには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

8.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)に設定し、管理対象サーバーを再起動します。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetDiscussionForumServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

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

WLSTコマンドのsetAnnouncementServicePropertyを使用して、お知らせのデフォルトを設定します。

- miniview.page_size: お知らせのクイック・ビューに表示する最大お知らせ数。

- mainview.page_size: お知らせのメイン・ビューに表示する最大お知らせ数。

- linksview.page_size: お知らせのリンク・ビューに表示する最大お知らせ数。

- announcements.expiration.days: お知らせを表示し、編集可能にする日数。

コマンドの構文と例は、『WebLogic Server WLSTコマンド・リファレンス』のディスカッションおよびお知らせに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

8.9 ディスカッション・サーバー接続のテスト

次のURLを使用してディスカッション・サーバーへのアクセスを試みます。

http://host:port/owc_discussions

すべての公開情報をリストするページが表示されるはずです。

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

WLSTコマンドaddDiscussionsServerAdminは、ディスカッション・サーバーのシステム管理者権限をユーザーまたはグループに付与します。WLSTコマンドaddDiscussionsCategoryAdminは、ディスカッション・サーバーのカテゴリ管理者権限を特定のカテゴリIDのユーザーまたはグループに付与します。

これらのコマンドは、現在の管理者を含まない新規のアイデンティティ・ストアにディスカッション・サーバーを接続するときに便利です。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのaddDiscussionsServerAdminに関する項およびaddDiscussionsCategoryAdminに関する項を参照してください。

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

WebCenter Portalに対して作成されるデフォルト・ドメイン管理者は、WebCenter Portalのディスカッション・サーバーの管理者でもあります。デフォルト以外のユーザーをディスカッション・サーバーの管理者にすることも可能です。

ドメインの作成時に、他の任意のユーザーをドメイン管理者として指定すると、ドメインのすべての管理権限がそのユーザーに付与されます。ただし、ドメイン作成後に、WebCenter Portalとディスカッション・サーバーの両方で、そのデフォルト以外のユーザーに管理者ロールを手動で付与する必要があります。WebCenter Portalのデフォルト以外のユーザーに管理者権限を付与する方法の詳細は、「WebCenter Portal管理者ロールの付与」を参照してください。

WebCenter Portalのディスカッション・サーバーの場合、デフォルト・ユーザーはスーパー管理者です。この項では、デフォルト以外のユーザーに管理者権限を付与する方法について説明します。

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

WLSTコマンドのaddDiscussionsServerAdminでは、ディスカッション・サーバーのシステム管理者権限をユーザーまたはグループに付与できます。これは、ディスカッション・サーバーを新しいアイデンティティ・ストアに接続するときに役立ちます。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのaddDiscussionsServerAdminに関する項を参照してください。

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

WebCenter Portalのディスカッション・サーバーの管理者ロールをデフォルト以外のユーザーに付与する手順は次のとおりです。

1. 次のURL書式を使用して、管理者としてディスカッション・サーバー管理コンソールにログオンします(http://host:port/owc_discussions/admin)。

2. ページの一番上にあるリンクのリストで「設定」リンクをクリックします。

3. 左側のナビゲーション・パネルで、「管理者/モデレータ」リンクが選択されていない場合は、これをクリックします。

4. 「Admins & Moderators」ページで、「Grant New Permissions」タブをクリックします。

5. 「システム管理」チェック・ボックスを選択します。

6. 「特定のユーザー」チェック・ボックスを選択して、WebCenter Portalのディスカッション・サーバーの管理権限を付与するユーザーを指定します。

7. 「Grant New Permission」をクリックします。

これで、管理権限を割り当てたユーザーとして、WebCenter Portalのディスカッション・サーバーにログオンできるようになりました。

図8-3 WebCenter Portalのディスカッション・サーバーの管理者ロールの付与

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

デフォルト以外の必要なユーザーにディスカッション・サーバー管理者ロールを割り当てた後に、デフォルト・ユーザーの管理者ロールを取り消すことができます。

管理者ロールを取り消す手順は次のとおりです。

1. 管理者ロールが割り当てられたデフォルト以外のユーザーとして、ディスカッション・サーバー管理コンソールにログオンします。

「ディスカッション・サーバー管理コンソールへのアクセス」も参照してください。

2. ページの一番上にあるリンクのリストで「設定」リンクをクリックします。

3. 左側のナビゲーション・パネルで、「管理者/モデレータ」リンクが選択されていない場合は、これをクリックします。

4. 「管理者およびモデレータ」ページの「権限のサマリー」タブで、必要なユーザー(例: weblogic)の「システム管理」チェック・ボックスの選択を解除します。(図8-4)

図8-4 管理者ロールの取消し

5. 「変更の保存」をクリックします。

これで、WebCenter Portalのディスカッション・サーバーを管理する管理権限がデフォルトのユーザーから取り消されました。

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

ディスカッション・フォーラムでは、メンバーはプロジェクトやコミュニティの目標に関連するコンテンツを取得、共有および保存できます。

注意:

この項で説明するタスクを実行するには、WebCenter PortalのAdministrator (Portal Server - Manage All)権限が必要です。

管理者は、WebCenter Portalの管理ページ(図8-5)から、アプリケーション全体に対するディスカッション・フォーラム・オプションの設定を行います。

図8-5 ディスカッション・フォーラム・オプションの設定

「ディスカッション」ページから、ディスカッション関連の設定の構成と、ディスカッション・サーバー管理ページへのアクセスを行えます。

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

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

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

注意:

システム管理者は、WebCenter Portalとディスカッション・サーバーとの間の接続をメンテナンスします。この接続に関する問題が発生した場合は、システム管理者に問題を報告してください。「ディスカッション・サーバーの登録」も参照してください。

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

便宜性のために、ディスカッション・サーバーの管理コンソール(ディスカッション・フォーラムの構成と管理のためのWebベースのツール)には、WebCenter Portalの管理ページからアクセスできます。ディスカッション・サーバーの管理コンソールでは、すべてのカテゴリおよびフォーラムに移動して、それらのプロパティを編集したり、新しいカテゴリおよびフォーラムを作成することができます。また、ディスカッション・サーバーのキャッシュ、セキュリティ、およびその他の各種プロパティを設定できます。

1. WebCenter Portalの管理ページを開きます。

詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ディスカッション」を選択します。

3. 「フォーラムの管理」をクリックします(図8-6)。

図8-6 「ディスカッション・フォーラム設定」の「フォーラムの管理」リンク

4. ログイン・ページが表示されたら、ディスカッション・サーバーの管理者ログイン資格証明を入力します。

注意:

「フォーラム管理」リンクが動作しない場合は、シングル・サインオンまたはHTTPSが構成されている可能性があります。システム管理者は、パブリックの外部URLを指定(linkURLプロパティを使用)する必要があります。

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

WebCenter Portalの管理者は、WebCenter Portalのすべてのディスカッションおよびお知らせが格納されるディスカッション・サーバー上のルート・カテゴリを変更できます。

デフォルトのシステム・ルート・カテゴリは、ほとんどの場合で適切ですが、別の場所を選択することもできます。これは、WebCenter Portalが、複数のアプリケーションのディスカッション・フォーラムをホストしているディスカッション・サーバーに接続しているときに役立つことがあります。

次が推奨されます。

- WebCenter Portalに専用のカテゴリを選択してください。複数のOracle WebCenter Portalが同一のルート・カテゴリを共有すると、競合が発生する可能性があります。

- WebCenter Portalの稼働後に、ルート・カテゴリを切り替えないでください。ルート・カテゴリを変更すると、古いルートに含まれるすべてのディスカッション・フォーラムは引き続き動作しますが、古いカテゴリに格納されたディスカッションまたはお知らせへのリンクは作成できなくなります。

既存のディスカッションは、データ・コピー・オプションで保存したポータル・テンプレートに保持できます。たとえば、WebCenter Portalの「管理」の「ツールとサービス」→「ディスカッション」ページで、テンプレートにコピーする最近のトピックと返信の数(1から25まで)を入力します。

ポータル・テンプレートは、指定したルート・カテゴリで1つまたは複数のフォーラムをサポートします。いくつかのテンプレートでは、そのテンプレートに基づいた新しいポータルごとに、ルート・カテゴリに1つのフォーラムが自動的に作成されます。

ディスカッション・フォーラムの格納場所を指定するには:

1. WebCenter Portal管理を開きます。

詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ディスカッション」を選択します(図8-7)。

図8-7 ディスカッションとお知らせが格納される場所の指定

3. ディスカッションの格納に適した「ルート・カテゴリ」を指定します。

「検索」アイコンをクリックし、選択可能なカテゴリを見つけて、最適な場所を選択します。

新しいカテゴリを作成する場合は、「カテゴリの作成」をクリックします。新しいカテゴリを作成するには、ディスカッション・サーバーのシステム管理者権限が必要になります。

4. 「適用」をクリックして設定を保存します。

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

WebCenter Portalの管理者は、ポータル・テンプレートにコピーする最近のトピックと返信の数を制限できます。大量のデータをコピーすることはパフォーマンスに影響するため、トピックまたは返信には25件までの上限があります。ポータル・テンプレートに最近のトピックまたは返信を含めないようにするには、ゼロを指定します。

1. WebCenter Portal管理を開きます。

詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ディスカッション」を選択します(図8-8)。

図8-8 ポータル内のトピック数および返信数の指定

3. ポータル・テンプレートに保存する適切な「トピック」数と「返信」数を指定します。

4. 「適用」をクリックして設定を保存します。

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

この章では、WebCenter PortalでMicrosoft Exchangeの個人の予定表を公開するためのイベントの構成および管理方法について説明します。

WebCenter Portalのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後に加えた構成変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用して行ったイベントの構成変更は動的ではないため、変更を有効にするには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章の内容は次のとおりです。

- イベント接続について

- WebCenter Portal用の個人イベントの構成

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

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

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

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

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

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

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、WebCenter Portal管理を使用して付与されるAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

トラブルシューティングの詳細は、「イベントに関する問題のトラブルシューティング」を参照してください。

9.1 イベント接続について

WebCenter Portalにおいて、イベントは、ミーティング、約束、およびその他のタイプのチーム、プロジェクトまたはグループの出来事をスケジュールするために使用できるポータル・カレンダを提供します。またイベントを通じて、Microsoft Exchangeの個人の予定表にアクセスし、特定のポータルに関連付けられていないイベントをここでスケジュールすることもできます。

個人の予定表はMicrosoft Exchange Serverから提供されるため、このサーバーへの接続が必要です。Fusion Middleware ControlコンソールまたはWLSTを使用して、Microsoft Exchange Server接続を登録できます。

イベントを機能させるには、接続をアクティブとしてマークする必要があります。追加のMicrosoft Exchange Server接続を登録できますが、一度にアクティブにできる接続は1つのみです。

ユーザーがWebCenter Portalで個人イベントを表示するには、Microsoft Exchange Server上にアカウントを保有している必要があります。

9.2 WebCenter Portal用の個人イベントの構成

個人イベントへのアクセスを提供するための、構成プロセスの手順を示すガイドとして、この項のロードマップを使用してください。

この項のフロー・チャート(図9-1)と表(表9-1)は、WebCenter Portalで個人イベントを動作させるために必要な前提条件とタスクの概要を示しています。

図9-1 WebCenter Portal用の個人イベントの構成

表9-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: セキュリティに関する考慮事項」を参照)

管理者

2.次のツールのいずれかを使用して、アプリケーションとイベント・サーバー間の接続を構成します

- Fusion Middleware Control (「Fusion Middleware Controlを使用したイベント・サーバーの登録」を参照)

- WLST (「WLSTを使用したイベント・サーバーの登録」を参照)

エンド・ユーザー

3.WebCenter Portalで個人の予定表が動作していることをテストします

3.a WebCenter Portalにログインして、ホーム・ポータル内のページにイベント・タスク・フローを追加します

3.b イベント・タスク・フローで「個人カレンダにログイン」をクリックし、MS Exchange Serverを入力します

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

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

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

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

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

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

この項では、個人イベント用のサーバーとしてMicrosoft Exchange Server 2013を使用する場合の前提条件について説明します。

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

- Microsoft Exchange Server 2013: インストール

- Microsoft Exchange Server 2013: 構成

- Microsoft Exchange Server 2013: セキュリティに関する考慮事項

- Microsoft Exchange Server 2013: 制限事項

9.3.1.1 Microsoft Exchange Server 2013: インストール

インストールの詳細は、Microsoft Exchange Server 2013のドキュメントを参照してください。

9.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>

9.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. IISの「computer_name」ノード→「サイト」→「既定のWebサイト」→「EWS」で、「認証」をダブルクリックします。

3. 「基本認証」を右クリックして「有効にする」を選択し、EWSアプリケーションに対して基本認証を有効化します。

4. 「サイト」で「既定のWebサイト」を右クリックして「仮想ディレクトリの追加」を選択し、Services.wsdl、Messages.xsdおよびTypes.xsdに匿名アクセスを提供するのに使用する仮想ディレクトリを作成します。

5. 「仮想ディレクトリの追加」ダイアログの「別名」フィールドで、仮想ディレクトリの名前を指定します(ExchWSなど)。

6. 「物理パス」フィールドで、仮想ディレクトリへのパスを指定します。たとえば、次のようになります(図9-2)。

C:\Program Files\Microsoft\Exchange Server\V14\ClientAccess\exchweb\ews

図9-2 仮想ディレクトリの作成

7. 「接続」をクリックします。

8. 「接続モード」ダイアログで、「アプリケーション・ユーザー」(パススルー認証)が選択されていることを確認します。

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

10. IISの「既定のWebサイト」→「ExchWS」で「認証」をダブルクリックします。

11. 「匿名認証」を右クリックして「有効にする」(図9-3)を選択します。

図9-3 匿名認証の有効化

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

9.3.1.4 Microsoft Exchange Server 2013: 制限事項

現在、既知の制限事項はありません。

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

この項では、個人イベント用のサーバーとしてMicrosoft Exchange Server 2010を使用する場合の前提条件について説明します。

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

- Microsoft Exchange Server 2010: インストール

- Microsoft Exchange Server 2010: 構成

- Microsoft Exchange Server 2010: セキュリティに関する考慮事項

- Microsoft Exchange Server 2010: 制限事項

9.3.2.1 Microsoft Exchange Server 2010: インストール

インストールの詳細は、Microsoft Exchange Server 2010のドキュメントを参照してください。

9.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>

9.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. IISの「computer_name」ノード→「サイト」→「既定のWebサイト」→「EWS」で、「認証」をダブルクリックします。

3. 「基本認証」を右クリックして「有効にする」を選択し、EWSアプリケーションに対して基本認証を有効化します。

4. 「サイト」で「既定のWebサイト」を右クリックして「仮想ディレクトリの追加」を選択し、Services.wsdl、Messages.xsdおよびTypes.xsdに匿名アクセスを提供するのに使用する仮想ディレクトリを作成します。

5. 「仮想ディレクトリの追加」ダイアログの「別名」フィールドで、仮想ディレクトリの名前を指定します(ExchWSなど)。

6. 「物理パス」フィールドで、仮想ディレクトリへのパスを指定します。たとえば、次のようになります(図9-4)。

C:\Program Files\Microsoft\Exchange Server\V14\ClientAccess\exchweb\ews

図9-4 仮想ディレクトリの作成

7. 「接続」をクリックします。

8. 「接続モード」ダイアログで、「アプリケーション・ユーザー」(パススルー認証)が選択されていることを確認します。

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

10. IISの「既定のWebサイト」→「ExchWS」で「認証」をダブルクリックします。

11. 「匿名認証」を右クリックして「有効にする」(図9-5)を選択します。

図9-5 匿名認証の有効化

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

9.3.2.4 Microsoft Exchange Server 2010: 制限事項

現在、既知の制限事項はありません。

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

この項では、個人イベント用のサーバーとしてMicrosoft Exchange Server 2007を使用する場合の前提条件について説明します。

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

- Microsoft Exchange Server 2007: インストール

- Microsoft Exchange Server 2007: 構成

- Microsoft Exchange Server 2007: セキュリティに関する考慮事項

- Microsoft Exchange Server 2007: 制限事項

9.3.3.1 Microsoft Exchange Server 2007: インストール

インストールの詳細は、Microsoft Exchange Server 2007のドキュメントを参照してください。

9.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>

9.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

9.3.3.4 Microsoft Exchange Server 2007: 制限事項

現在、既知の制限事項はありません。

9.4 イベント・サーバーの登録

WebCenter Portalには複数のイベント・サーバーを登録できますが、一度にアクティブにできるサーバーは1つのみです。

新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

この項には次のトピックが含まれます:

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

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

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

イベント・サーバーを登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。

詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「個人イベント」を選択します。

4. 新しいイベント・サーバー・インスタンスに接続するには、「追加」をクリックします。

「個人イベント接続の追加」ページが表示されます(図9-6)。

図9-6 イベント接続の構成

5. この接続の一意の名前を入力し、Microsoft Exchange Serverのバージョンを指定して、この接続をWebCenter Portalのアクティブな(またはデフォルトの)接続にするかどうかを指定します(図9-6)。

表9-2 個人イベント接続: 名前

フィールド

説明

接続名

接続の一意の名前を入力します。この名前は、WebCenter Portalのすべての接続タイプ間で一意である必要があります。

接続タイプ

接続先のMicrosoft Exchange Serverを選択します。

- Microsoft Exchange Server 2007

- Microsoft Exchange Server 2010

- Microsoft Exchange Server 2013

アクティブな接続

これを選択すると、この接続がWebCenter Portalでイベントに使用されます。

複数のイベント・サーバー接続を登録できますが、イベントで使用される接続はデフォルトの(またはアクティブな)接続1つのみです。

6. イベント・サーバーの接続の詳細を入力します(表9-3)。

表9-3 個人イベント: 接続の詳細

フィールド

説明

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がデプロイされている管理対象サーバーを再起動する必要があります。

詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

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

WLSTコマンドのcreatePersonalEventConnectionを使用して、イベント・サーバー接続を作成します。既存の接続を変更するには、setPersonalEventConnectionを使用します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのcreatePersonalEventConnectionに関する項およびsetPersonalEventConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

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

WebCenter Portalには複数のイベント・サーバー接続を登録できますが、一度にアクティブにできる接続は1つのみです。

この項には次のトピックが含まれます:

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

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

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

アクティブな接続を変更するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。

詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「個人イベント」を選択します。

「個人イベント接続の管理」表に、現在のアクティブな接続(ある場合)が示されます(図9-7)。

図9-7 個人イベント用のアクティブな接続

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」をクリックします。

5. 「アクティブな接続」チェック・ボックスを選択します。

6. 「OK」をクリックして、接続を更新します。

7. 新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

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

WLSTコマンドのsetPersonalEventConnectionをdefault=trueで使用して、既存のイベント・サーバー接続をアクティブ化します。コマンドの構文と例は、『WebLogic Server WLSTコマンド・リファレンス』のsetPersonalEventConnectionに関する項を参照してください。

その後、イベント接続を無効化するには、default=falseと指定して同じWLSTコマンドを実行します。接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

アクティブな接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

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

イベント・サーバー接続の詳細はいつでも変更できます。

更新された(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

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

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

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

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

イベント・サーバー接続の詳細を更新する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「個人イベント」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。

パラメータ情報の詳細は、表9-3を参照してください。

6. 「OK」をクリックして、変更を保存します。

7. 更新された(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

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

WLSTコマンドのsetPersonalEventConnectionを使用して、既存のイベント・サーバー接続を編集します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetPersonalEventConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

更新された(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

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

イベント・サーバー接続はいつでも削除できますが、アクティブな接続を削除する際は注意が必要です。アクティブな接続を削除すると、ユーザーが個人の予定表にイベントを作成できなくなります。

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

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

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

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

イベント・サーバー接続を削除するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。

詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのリストから、「個人イベント」を選択します。

4. 接続名を選択し、「削除」をクリックします。

注意:

管理対象サーバーを再起動する前に、他の接続をアクティブとして選択してください。そうしないとサービスが無効になります。

5. この変更を行うには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

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

WLSTコマンドのdeleteConnectionを使用して、イベント・サーバーの接続を削除します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

この変更を有効にするには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』の管理対象サーバーの起動および停止に関する項を参照してください。

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

イベント・サーバーへの接続を確認するには:

1. WebCenter Portalのページにイベント・タスク・フローを追加します。

ヒント:

WebCenter Portalでは、ホーム・ポータルのページにタスク・フローを追加します。『Oracle WebCenter Portalでのポータルの構築』のページへのイベント・タスク・フローの追加に関する項を参照してください。

2. 「個人イベント」をクリックして、「個人カレンダにログイン」をクリックします。

3. Microsoft Exchange Serverのログイン資格証明を入力します。

Microsoft Exchange Serverからの個人イベントがタスク・フローに表示されます。

10 他のOracleアプリケーションの統合

この章では、Siebel、E-Business Suite、JD Edwards、PeopleSoft、Oracle Business Intelligenceなどの他のOracleアプリケーションをWebCenter Portalと統合する方法を説明します。

この章の内容は次のとおりです。

- 他のOracleアプリケーションの統合について

- Siebelアプリケーションの統合

- E-Business Suiteアプリケーションの統合

- JD Edwardsアプリケーションの統合

- PeopleSoftアプリケーションの統合

- Oracle Business Intelligenceプレゼンテーション・サービスの統合

- Oracle Document Cloud Serviceとの統合

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、WebCenter Portal管理を使用して付与されるAdministratorロールが付与されている必要があります。WebCenter Portalのこれらの権限とは別に、統合する他のOracleアプリケーションの追加権限も必要になる場合があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

10.1 他のOracleアプリケーションの統合について

Oracle WebCenter Portalは、コンテキストに応じた統一されたユーザー・エクスペリエンスを提供できるように設計された統合テクノロジ・スイートです。WebCenter Portalは、構造化コンテンツと非構造化コンテンツ、ビジネス・インテリジェンス、ビジネス・プロセス、通信およびコラボレーション・サービスを統合して、エンタープライズ・アプリケーション間の境界を取り除きます。自社で使用できる他のアプリケーションをWebCenter Portalと統合することで、これらのアプリケーションの機能を活用するコンテキスト中心型のコンポジット・アプリケーションを作成して、WebCenter Portalを拡張して、従業員の労働形態を変革できます。

WebCenter Portalは、業界標準のテクノロジを使用して他のアプリケーション・コンポーネントを統合します(主にWSRPポートレットとして)。図10-1は、WebCenter Portalと他のOracleアプリケーションの統合で使用されるテクノロジを示しています。

図10-1 WebCenter Portalの統合

すべてのアプリケーションが同じ統合メカニズムをサポートしているわけではありませんが、統合プロセスは一般に非常にシンプルであり、その内容は、統合するアプリケーション・オブジェクトをポートレットとして公開して、そのポートレットをWebCenter Portalに登録して、そのポートレットをページに追加してから、結果を実行およびテストするというものです。

図10-1は、Siebel、E-Business Suite、JD Edwards、PeopleSoftおよびOracle Business Intelligenceとして統合できるアプリケーションを示しています。これらのOracleアプリケーションは、十分にサポートされ、この章で説明されています。ただし、実際には、WSRPポートレットとしてオブジェクトを公開できる任意のアプリケーションを統合できます。それらを統合するプロセスは、ここで取り上げられているOracleアプリケーションの場合と同じです。つまり、オブジェクトをポートレットとして公開し、ポートレットをWebCenter Portalに登録し、ポートレットをページに追加します。公開されたポートレットをWebCenter Portal内で利用する方法の詳細は、サポートされているOracleアプリケーションのいずれかのドキュメントを参照してください。

10.2 Siebelアプリケーションの統合

この項では、Siebel WebサービスをWebCenter Portalアプリケーションに統合する方法を説明します。また、Siebel Webエンジン(SWE)を使用してSiebelオブジェクトを統合する方法も説明します。SiebelとWebCenterは連係して、SiebelのCRM機能をポートレットとしてWebCenter Portalに組み込むことができます。Siebelアプリケーションは、Webサービスとして統合することも、次の項で説明しているSiebel Webエンジン(SWE)を使用して統合することもできます。

- WebサービスとしてのSiebelアプリケーションの統合方法

- Siebel Webエンジンを使用したSiebelアプリケーションの統合方法

10.2.1 WebサービスとしてのSiebelアプリケーションの統合方法

この項では、SiebelアプリケーションをWebサービスとしてWebCenter Portalに統合する方法を説明します。

この項には次のサブセクションが含まれます:

- Siebelアプリケーションの準備方法

- Siebel Webサービス・データ・コントロールの使用方法

10.2.1.1 Siebelアプリケーションの準備方法

この項では、インバウンドWebサービスを作成して、このインバウンド・サービス向けの操作を設定し、WSDLを生成する方法を説明します。このWSDLは、後でWebCenter Portalに対するデータ・コントロールを作成するために使用します。

この項には次のサブセクションが含まれます:

- インバウンドWebサービスの作成方法

- インバウンドWebサービス向けの操作の作成方法

10.2.1.1.1 インバウンドWebサービスの作成方法

インバウンドWebサービスを作成するには:

1. 管理者としてSiebelアプリケーションにログインします。

2. 「管理」の「Webサービス」ページに移動します。

3. インバウンドWebサービスをクリックします。

「インバウンドWebサービス」ページでは、標準で用意されているWebサービスと、現在公開されている他のWebサービスが表示されます。

4. 「メニュー」をクリックして、ドロップダウン・リストからNew Recordを選択します。

5. 設定するWebサービスに応じて、「ネームスペース」、「名前」、「ステータス」および「コメント」の値を入力します。例:

フィールド名

値

ネームスペース

http://xmlns.oracle.com

名前

Siebel Customer Account

ステータス

Active

コメント

For Fusion Middleware

6. 「サービス・ポート」ペインまでスクロールして、「メニュー」ドロップダウン・リストから「新規レコード」を選択します。

7. 「名前」にCustAccountと入力して、「タイプ」をクリックします。

8. インバウンドWebサービス・ポート・タイプ・ピック・アプレットで、「新規」タブを開きます。

9. 「実装タイプ」としてBusiness Serviceを選択します。

10. 「サービス名」リストから、Siebel Accountを選択します。

11. インバウンドWebサービス・ポート・タイプ・ピック・アプレットで、「OK」をクリックして、インバウンドWebサービスを作成します。

12. 「サービス・ポート」ダイアログの「トランスポート」ドロップダウン・リストから、HTTPを選択します。

13. 「アドレス」フィールドで、使用するSiebelインスタンスのURLを設定します。例:

http://xmlns.oracle.com/eai_enu/start.swe?SWEExtSource=WebService&SWEExtCmd=Execute&UserName=SADMIN&Password=SADMIN

14. 「メニュー」ドロップダウン・リストから、Save Recordを選択します。

10.2.1.1.2 インバウンドWebサービス向けの操作の作成方法

インバウンドWebサービスの作成後(「インバウンドWebサービスの作成方法」を参照)、次の手順に従って、操作をインバウンドWebサービスに追加し、WSDLファイルを作成します。

1. 「操作」セクションまでスクロールして、「メニュー」ドロップダウン・リストからNewを選択します。

2. 「操作名」フィールドにAccountInsertと入力します。

3. 「メソッド表示名」をクリックして、ビジネス・サービス・メソッド・ダイアログを開きます。

4. 「メソッド」としてInsertを選択し、「OK」をクリックします。

5. 「認証タイプ」ドロップダウン・リストから、適切な認証タイプを選択します。

認証タイプ

セッション・タイプ

説明

なし

なし

匿名ユーザー・ログイン情報とともに単一のリクエストが送信されて、レスポンスが送出された後にセッションはクローズされます。

匿名セッションがSWSEプラグインによって識別されるためには、UsernameTokenとPasswordTextがSOAPヘッダーに含まれていない必要があります。

ユーザー名とパスワード

なし

ログインに使用されたユーザー名とパスワードとともに単一のリクエストが送信されて、レスポンスが送出された後にセッションはクローズされます。

ユーザー名とパスワード

ステートレス

ログインのための初期リクエストによって確立されたセッションはオープン状態のままになり、後続のリクエストで使用できます。ユーザー名とパスワードを使用してログインが行われ、セッション・トークンはアウトバウンド・レスポンスに含まれたSOAPヘッダーに格納されて返されます。セッションは開いたままになります。

セッション・トークン(ステートレス)

ステートレス

セッション・トークンに格納された情報を使用して、確立済のセッションに再接続するためのリクエストです。セッションがクローズされている場合は、自動再ログインが実行されます。Siebelサーバーは、レスポンスのSOAPヘッダーにセッション・トークンを組み込みます。セッションは開いたままになります。

セッション・トークン(ステートレス)

なし

SOAPヘッダーによってセッション・トークンが伝送されており、セッション・タイプが「なし」に設定されている場合は、SWSE上のセッション・マネージャはこのセッションをクローズして(このセッションからログアウトして)、そのセッション・トークンを無効化します。そのセッション・トークンは当該セッションが無効化された後は使用されません。

6. 「新規」をクリックして、新規操作を作成します。

7. 「操作名」フィールドに、新規操作の名前を入力します(AccountQueryByExampleなど)。

8. 新規操作のメソッド表示名をクリックします。

9. 「ビジネス・サービス・メソッド」ダイアログで、問合せメソッドを選択して(「例による問合せ」など)、「OK」をクリックします。

10. 前述のステップ6から9に従って、必要に応じてさらに操作を追加します。

11. 「サービス・ポート」ペインで、「メニュー」ドロップダウン・リストからSave Recordを選択します。

12. 「インバウンドWebサービス」ペインで、「メニュー」ドロップダウン・リストからSave Recordを選択します。

13. 「メニュー」ドロップダウン・リストからClear Cacheを選択します。

14. 「WSDLの生成」をクリックします。

15. 「ファイルのダウンロード」ダイアログで、「開く」をクリックします。

16. 「ファイル」→「別名保存」を選択します。

17. WSDLファイルを保存するディレクトリに移動して、このファイルの名前を入力して、「保存」をクリックします。

10.2.1.2 Siebel Webサービス・データ・コントロールの使用方法

この項では、Webサービス・データ・コントロールを作成し、ポータル・ページに追加する方法を説明します。この項の手順では、「Siebelアプリケーションの準備方法」の説明に従って、アプリケーションが準備され、WSDLが生成済であるとします。

注意:

データ・コントロールまたはデータ・コントロールを含むタスク・フローをポータル・ページに追加する前に、WebCenter PortalのWS-Securityを構成する必要があります。WS-Securityの構成の詳細は、『Oracle WebCenter Portalの管理』のWebサービス・セキュリティのログイン資格証明の構成に関する項を参照してください。

Webサービス・データ・コントロールの作成の詳細は、『Oracle WebCenter Portalでのポータルの構築』のデータ・コントロールの作成に関する項を参照してください。Webサービス・データ・コントロールの詳細は、『Oracle WebCenter Portalでのポータルの構築』のWebサービス・データ・コントロールに関する項も参照してください。

Webサービス・データ・コントロールを作成するには:

1. データ・コントロールを作成するWebCenter Portalまたはポータルで、「共有アセット」ページまたは「アセット」ページのいずれかに移動します。

2. 「データ・コントロール」を選択し、「作成」をクリックします。

「新規データ・コントロールを作成します。」ダイアログが表示されます(図10-31を参照)。

図10-2 「新規データ・コントロールを作成します。」ダイアログ

3. 「新規データ・コントロールを作成します。」ダイアログで、データ・コントロールの「名前」と「説明」を入力して、「データ・コントロール・タイプ」として「Web Service」を選択し、「続行」をクリックします。

4. 「WSDLの生成方法」で生成したWSDL URLおよびデータ・コントロールのその他の詳細を入力し、「続行」をクリックします。

5. 「メソッドの表示」をクリックします。

6. 使用可能にするメソッドを選択し、「次へ」をクリックします。

7. パラメータのデフォルト値があれば入力し、「作成」をクリックします。

8. データ・コントロールを使用可能にするには、「共有アセット」ページまたは「アセット」ページから、「タスク・フロー」を選択します。「新規タスクフローを作成します。」ダイアログが表示されます(図10-33を参照)。

図10-3 新規タスク・フローの作成ダイアログ

9. タスク・フローの「名前」と「説明」を入力し、使用する「マッシュアップ・スタイル」を選択して「作成」をクリックし、タスク・フローを作成します。

10. タスク・フローを選択し、「編集」アイコンをクリックします。

11. データ・コントロールを(パラメータ形式で)タスク・フローに表として追加し、データを検証します。

12. タスク・フローを使用可能にするには、「管理」→「ビジネス・ロール・ページ」に移動します。

13. 「ビジネス・ロール・ページ」を選択し、「作成」アイコンをクリックします。

14. ページを編集して変更を保存します。

15. タスク・フローをページにドロップし、データを検証します。

10.2.2 Siebel Webエンジンを使用したSiebelアプリケーションの統合方法

Webサービスを使用してSiebelアプリケーションを統合できます。さらに、Siebel Webエンジン(SWE)を使用してSiebelアプリケーションをWebCenter Portalに統合することもできます。

Siebel Webエンジン(SWE)は、Siebelユーザー・インタフェースをレンダリングする役割を果たします。Siebel Webテンプレートは、アプリケーションのリポジトリ定義内のSiebelオブジェクトをレンダリングする際に、このHTMLレイアウト情報(マークアップ情報)をSiebel Webエンジンに提供します。SWEから返されるマークアップは、XML対応アプリケーション内でレンダリングするためのXMLにすることも、ワイヤレス・デバイス上でレンダリングするためのWML (Wireless Markup Language)にすることもできます。これにより、SiebelビューをXMLとして返すようにSWEに要求して、データ要素を解析し、結果をWebCenter Portalアプリケーション内に表示することが可能になります。

また、SWEとWebテンプレートの詳細は、Siebelポータル・フレームワーク・ガイド(特に、外部Webアプリケーションへのコンテンツ配信に関する項)およびSiebelビジネス・アプリケーション構成ガイドというSiebel Bookshelfガイドを参照してください。

10.3 E-Business Suiteアプリケーションの統合

この項では、E-Business SuiteアプリケーションをWebCenter Portalに統合する方法を説明します。

この項には次のサブセクションが含まれます:

- EBSアプリケーションの統合について

- EBSの統合に必要な構成

- WSRPポートレットとしてのEBSアプリケーションの統合方法

- データ・コントロールとしてのEBSアプリケーションの統合方法

10.3.1 EBSアプリケーションの統合について

この項では、Oracle E-Business SuiteポートレットをWebCenter Portalに統合するにあたっての統合のポイントと要件を説明します。

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

- EBSの統合の理解

- EBSアプリケーションを統合するための要件

10.3.1.1 EBS統合の理解

標準で用意されているOracle E-Business Suite OA Frameworkベースのポートレット(アプリケーション・ナビゲータ、お気に入りなど)は、WSRPとJSR 168に準拠しています。したがって、これらのOracle E-Business Suiteポートレットをページに追加すれば、WebCenter PortalなどのWSRP準拠ポータル・サーバーからそれらのポートレットにアクセスできるようになります。「ポータル・ページへのEBSポートレットの追加方法」の手順に従って、それらをWebCenter Portalまたはポータル・ページに追加します。

同様にWebCenter Portalに追加可能なWSRPとJSR 168に準拠した新しいE-Business Suiteポートレットを作成することもできます。WSRPとJSR 168に準拠したポータルの作成および使用については、「EBSアプリケーションの統合方法」で説明します。

10.3.1.2 EBSアプリケーションを統合するための要件

Oracle E-Business SuiteポータルをWebCenter Portalに統合するための要件は次のとおりです。

- ポートレットとして公開するリージョンは、Oracle E-Business Suite OA Framework リリース12を使用して作成する必要があります。これより前のバージョンは、WSRPとJSR 168に準拠していないからです。

- Oracle E-Business Suiteは、Oracle Internet Directory (OID)と次のいずれかのシングル・サインオン・ソリューションを使用するように構成できます。

注意:

WebCenter PortalとOracle E-Business Suiteの両方で同じOIDインスタンスおよびユーザーIDを共有する必要があります。

- Oracle Single Sign-On(OSSO)

- Oracle Access Manager(OAM)

OSSOを使用している場合は、My Oracle Supportドキュメント376811.1の手順に従って、E-Business Suite リリース12をOIDおよびOSSOと統合してください。

OAMを使用している場合は、My Oracle Supportドキュメント975182.1の手順に従って、E-Business Suite リリース12をOAMと統合してください。

E-Business Suiteは、OAMまたはOSSOなしでOIDを構成することもできます。詳細は、「シングル・サインオンなしで使用するOIDの準備方法」を参照してください。

注意:

Oracle E-Business Suiteはシングル・サインオンなしでOracle Internet Directory (OID)を使用するように構成できますが、ユーザーが統合されたポータルまたはデータ・コントロールの間を移動するたびに資格証明の入力を求められるため、この方法はお薦めしません。

- WebCenter Portalに対してE-Business Suite Portlet Producerへのアクセス権を付与して、適切なユーザーを追加および構成しておく必要があります。

注意:

一部の手順の実行には、システム管理者の権限が必要になることがあります。

10.3.2 EBSの統合に必要な構成

この項では、WebCenter Portalへのポータルまたはデータ・コントロールの統合を試行する前に、必要な構成について説明します。

この項には次のサブセクションが含まれます:

- シングル・サインオンなしで使用するOIDの準備方法

- EBSでのユーザーの作成と職責の割当て方法

- EBSアプリケーション・プロファイル・オプションの構成方法

- AutoConfigを使用した信頼できるポータルとしてのWebCenterホストの追加方法

10.3.2.1 シングル・サインオンなしで使用するOIDの準備方法

この項では、OAMまたはOSSOのいずれも使用せず、オプションのスタンドアロン環境としてOIDを構成する手順について説明します。ユーザーが統合されたポータルまたはデータ・コントロールの間を移動するたびに資格証明の入力を求められるため、この方法はお薦めしていないことに注意してください。SSOソリューションをインストール済の場合は、「EBSでのユーザーの作成と職責の割当て方法」に進みます。

注意:

WebCenter PortalとOracle E-Business Suiteの両方で同じOIDインスタンスおよび同じユーザーIDを共有する必要があります。

1. 次の手順で、OIDインスタンスをホスト・サーバーに登録します。

a. 次のコマンドを実行します。
$FND_TOP/bin/txkrun.pl -script=SetSSOReg -registerinstance=yes

b. 次のプロンプトで、必要な情報を指定します。

Enter the host name where the Oracle iAS Infrastructure database is installed ? <Enter the OID Host>
Enter the LDAP Port of the Oracle Internet Directory server ? <Enter the LDAP Port>
Enter SSL LDAP Port of the Oracle Internet Directory server ? <Enter the LDAP SSL Port>
Enter the Oracle Internet Directory Administrator (orcladmin) Bind password ? <Password>
Enter Oracle E-Business apps database user password ? <Password>

c. $ADMIN_SCRIPTS_HOMEに移動して次のコマンドを実行し、すべてのサービスを再起動します。
./adstpall.sh apps/<apps to stop>

続いて次を実行します。

./adstrtal.sh apps/<apps to start>

2. 次の手順に従って、OIDを登録します。

a. 次のコマンドを実行します。
$FND_TOP/bin/txkrun.pl -script=SetSSOReg -registeroid=yes

b. 次のプロンプトで、必要な情報を指定します。

Enter LDAP Host name ? <Enter the OID Host>
Enter the LDAP Port on Oracle Internet Directory server ? <Enter the LDAP Port>
Enter the Oracle Internet Directory Administrator (orcladmin) Bind password ? <Password>
Enter the instance password that you would like to register this application instance with ? <Password>
Enter Oracle E-Business apps database user password ? <Password>

c. $ADMIN_SCRIPTS_HOMEに移動して次のコマンドを実行し、すべてのサービスを再起動します。
./adstpall.sh apps/<apps to stop>

続いて次を実行します。

./adstrtal.sh apps/<apps to start>

3. 引き続いて、「EBSアプリケーション・プロファイル・オプションの構成方法」の説明に従って、EBSプロファイル・オプションを構成します。

10.3.2.2 EBSでのユーザーの作成と職責の割当て方法

EBSとの統合を有効にするには、WebCenter PortalとEBSは共通のOIDアイデンティティ・ストアを保有する必要があります。共通OIDを使用して、EBSで新規ユーザーを作成するかOIDの既存のユーザーを使用し、そのユーザーに職責を割り当てます。これにより、そのユーザーはWebCenter Portalのポートレットに確実にアクセスできます。

新規ユーザーを作成して職責を割り当てるには:

1. EBSにログインしていない場合は、システム管理者としてログインします。

2. 「ナビゲーション」ペインで、システム管理者ノード、「セキュリティ」、「ユーザー」と開き、「定義」をクリックします。

「ユーザー」ウィンドウが表示されます(図10-4)。

図10-4 「ユーザー」ウィンドウ

3. 「ユーザー名」と「パスワード」を入力します。パスワード期限オプションは「なし」に設定する必要があります。

4. 職責の割当てタブを開き、追加する「職責」を検索してそれに関連付ける「アプリケーション」を割り当て(たとえば、Preferences SSWAを検索してOracle iProcurementを割り当てます)、「保存」をクリックします(図10-5を参照)。

図10-5 職責の割当てタブを表示する「ユーザー」ウィンドウ

5. 確認するには、新しく作成されたユーザーでログインし、職責に関連付けられたアプリケーションがリストされていることを確認します。

6. 引き続いて、「EBSアプリケーション・プロファイル・オプションの構成方法」の説明に従って、EBSアプリケーション・プロファイル・オプションを構成します。

10.3.2.3 EBSアプリケーション・プロファイル・オプションの構成方法

この項では、EBSアプリケーション・プロファイル・オプションを構成する方法について説明します。この手順は、SSOおよび非SSO構成の両方に必要です。

EBSプロファイル・オプションを構成するには:

1. EBSにシステム管理者としてログインします。

2. 「ナビゲーション」ペインで、システム管理者ノードを開き、プロファイル・オプションの定義をクリックします。

3. 「プロファイル」ウィンドウを閉じます。

4. 「ナビゲータ」で、プロファイル・システム値を選択し、「オープン」をクリックします。

システム・プロファイル値の検索ウィンドウが表示されます(図10-6を参照)

図10-6 システム・プロファイル値の検索ウィンドウ

5. 「プロファイル」名を入力して更新し、「検索」をクリックします。

システム・プロファイル値ウィンドウが表示されます(図10-7を参照)。

図10-7 システム・プロファイル値ウィンドウ

次のプロファイルの値を更新し、それぞれの更新後にエントリを保存します。

アプリケーションSSO有効OIDアイデンティティ追加イベント = Enabled

アプリケーションSSOログイン・タイプ = Both

アプリケーションSSO LDAP同期 = Enabled

アプリケーションSSOタイプ = SSWA w/ SSO

同じユーザー名のOIDユーザーを使用するリンク・アプリケーション・ユーザー = Enabled

6. $ADMIN_SCRIPTS_HOMEに移動して次のコマンドを実行し、すべてのサービスを再起動します。

./adstpall.sh apps/<apps to stop>

続いて次を実行します。

./adstrtal.sh apps/<apps to start>

7. 引き続いて、「AutoConfigを使用した信頼できるポータルとしてのWebCenterホストの追加方法」の説明に従って、信頼できるホストとしてWebCenterホストを追加します。

10.3.2.4 AutoConfigを使用した信頼できるポータルとしてのWebCenterホストの追加方法

EBS WSDLは保護されているため、EBS AutoConfigツールを使用してWebCenter Portalインスタンスのホストを使用するためのエントリを追加してから、EBS WSDLにアクセスします。この構成手順を実行せずWSDLへのアクセスを試みると、「403 禁止」エラーが発生します。

WebCenter Portalホストを信頼できるポータルとして追加する手順は次のとおりです。

1. EBSにログインしていない場合は、システム管理者としてログインします。

2. 「ナビゲーション」ペインで、システム管理者ノード、Oracle Applicationsマネージャと開き、「ワークフロー」をクリックします。

3. 「サイトマップ」タブを開き、「AutoConfig」をクリックします。

4. 「パラメータの編集」列で、アプリケーション層行の「編集」アイコンをクリックします。

5. 「システム」タブを開き、oa_web_serverノードを開きます。

6. ノードのリストでポートレット・プロデューサURLへのアクセスを持つノードを検索し、WebCenterホストへ追加して「保存」をクリックします。複数のホスト名を追加する必要がある場合は、ホスト名をスペースで区切ります。

7. 次のようにプロンプトが表示されたら、パスワードとしてappsを入力して自動構成スクリプトを実行します。

cd $ADMIN_SCRIPTS_HOME

./adautocfg.sh

8. $ADMIN_SCRIPTS_HOMEから次のコマンドを実行し、すべてのサービスを再起動します。

./adstpall.sh apps/<apps to stop>

続いて次を実行します。

./adstrtal.sh apps/<apps to start>

10.3.3 WSRPポートレットとしてのEBSアプリケーションの統合方法

この項では、EBSリージョンをWSRPポートレットとしてWebCenter Portalに統合する方法を説明します。開始するには、ポートレット・ジェネレータを使用してそのリージョンのポートレットを生成し、続いてプロデューサの登録およびWebCenter Portalへの統合を実行する必要があります。

この項には次のサブセクションが含まれます:

- EBSポートレットのリモート・アクセスの準備方法

- EBSアプリケーションの統合方法

10.3.3.1 EBSポートレットのリモート・アクセスの準備方法

Oracle E-Business Suiteは、既存のスタンドアロンのOracle Application Frameworkリージョンをポートレットに変換するポートレット・ジェネレータと呼ばれるツールを提供します。ポートレット化できるようにするには、リージョンには次のプロパティが必要です。

- リージョンには、定義済のアプリケーション・モジュール(AM)が必要です。そのAMのスタンドアロン・プロパティはtrueに設定されている必要があります。

- インライン・リージョンには、定義済のAMが必要です。そのAMのスタンドアロン・プロパティはtrueに設定されている必要があります。

- コンテンツ・リージョンには定義済のAMが必要です(コンテンツ・リージョンにはスタンドアロン・プロパティはありません)。

ポートレット・ジェネレータを使用したポートレットとしてEBS機能を公開するには:

1. EBSにシステム管理者としてログインします。

2. 「ナビゲーション」ペインで、機能管理者ノードを開き、「ホーム」をクリックします。

アプリケーション管理ページが表示されます(図10-8を参照)。

図10-8 アプリケーション管理ページ

3. ポートレット化タブを開き、「アプリケーションの短縮名」フィールドの「検索」アイコンをクリックします(または、わかっている場合は「アプリケーションの短縮名」を入力)。

図10-9 「アプリケーションの短縮名」の「検索」ダイアログ

4. 「検索基準」条件を選択し(たとえば、Application Nameを選択してOracle iProcurementを入力)、ポートレット化する機能を検索します。

5. 検索結果で返された行を選択し、「選択」をクリックします。

6. 「実行」をクリックしてポートレット化できるEBS機能をリストします。

7. 公開する機能のポートレット化アイコンをクリックします(たとえば、AdvisoryWarningRN)。

「ポートレットの作成」ダイアログが表示されます(図10-10を参照)。

図10-10 「ポートレットの作成」ダイアログ

8. リージョン(たとえば、Preferences SSWA)に関連付ける「職責」を入力するか、「検索」機能を使用します。

9. 「適用」をクリックします。

10. 引き続いて、ポータルにEBSプロデューサを登録し、統合します(「EBSアプリケーションの統合方法」を参照)。

10.3.3.2 EBSアプリケーションの統合方法

この項には次のサブセクションが含まれます:

- EBSポートレットのリモート・アクセスの準備方法

- WebCenter PortalへのEBS WSRPプロデューサの登録方法

- ポータル・ページへのEBSポートレットの追加方法

- ポートレット接続のテスト方法

10.3.3.2.1 EBSポートレットのリモート・アクセスの準備方法

「EBSポートレットのリモート・アクセスの準備方法」の項の説明に従って、ポートレット化するスタンドアロン・リージョンを準備します。

ポートレットをWebCenter Portalに追加する前に、メニューと関数の定義がキャッシュされるため、必ずApacheリスナーをバウンスしてください。

10.3.3.2.2 WebCenter PortalへのEBS WSRPプロデューサの登録方法

Fusion Middleware Controlを使用して、EBS WSRPプロデューサをWebCenter Portalに直接登録できます。

Fusion Middleware Controlを使用してEBS WSRPプロデューサを登録するには:

1. 「EBSポートレットのリモート・アクセスの準備方法」の説明に従って、WebCenter Portalで使用するEBSページのリモート・アクセスの準備を行います。

2. WebCenter PortalドメインのFusion Middleware Control(デフォルトではwc_domain)にログインします。

3. 「ナビゲーション・バー」でWebCenter Portalを開き、「WebCenterポータル」メニューで「プロデューサの登録」を選択します。

「ポートレット・プロデューサの追加」ページが表示されます。

4. 接続名を入力し、「プロデューサ・タイプ」をWSRP Producerに設定して、ステップ1でコピーしたWSDLエンドポイントURLを「URLエンドポイント」フィールドに貼り付けます。

5. 「OK」をクリックし、プロデューサ接続が正常に作成されたことを確認します。

6. 引き続いて、「ポータル・ページへのEBSポートレットの追加」の説明に従って、該当ポートレットをポータル・ページに追加します。

10.3.3.2.3 ポータル・ページへのEBSポートレットの追加方法

次の手順に従って、EBSリモート・プロデューサをWebCenter Portalページで使用します。

1. WebCenter Portalにログインし、オプションで、ターゲット・ポータルを開きます。

2. EBSポータルの追加先となるページに移動するか、新規ページを作成します。

3. 「コンテンツの追加」をクリックし、リソース・カタログで「UIコンポーネント」、「ポートレット」の順に選択します。

カスタム・リソース・カタログが作成済の場合は、「ポートレット」が表示されないことがあります。この場合は、それをリソース・カタログに追加する必要があります。リソース・カタログの管理の詳細は、『Oracle WebCenter Portalでのポータルの構築』のリソース・カタログの使用に関する項を参照してください。

4. Fusion Middleware Controlに追加したポートレットをクリックします。

5. ポータル・ページを追加するEBSポートレットの「追加」をクリックします。

6. ポータル・ページで、ポートレットの「処理の表示」メニューをクリックし、「表示オプション」を選択します。

7. 「表示オプション」ダイアログで、IframeにポートレットをレンダリングするをTrueに設定して、「OK」をクリックします。

8. 引き続いて、「ポートレット接続のテスト方法」の説明に従って、ポートレット接続をチェックします。

10.3.3.2.4 ポートレット接続のテスト方法

次の手順に従って、コンテンツを変更し、その変更内容がEBSアプリケーションに表示されることを確認することで、ポートレット接続をテストします。

1. EBSポートレットを追加したWebCenter Portalまたはポータル・ページで、なんらかの情報を変更します。この情報は、その変更内容をEBSアプリケーションで確認できるものである必要があります。

2. 変更を保存し、変更内容がEBSアプリケーションでも表示されることを確認します。

10.3.4 データ・コントロールとしてのEBSアプリケーションの統合方法

この項では、EBSアプリケーションをWebサービス・データ・コントロールとしてWebCenter Portalページに追加する方法について説明します。

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

- WSDLの生成方法

- Webサービス・データ・コントロールのポータル・ページへの追加方法

10.3.4.1 WSDLの生成方法

この項では、WSDLの作成方法について説明します。

1. E-Business SuiteにSYSADMINユーザーとしてログオンします。

2. 「ナビゲーション」ペインで、「統合されたSOAゲートウェイ」ノードを開き、「統合されたSOAゲートウェイ」サブノードで統合リポジトリをクリックします。

3. 「統合リポジトリ」タブから、公開するEBSアプリケーションの部分へ移動します。たとえば、価格リクエスト・インタフェースの場合、「Order Managementパッケージ」→「Advanced Pricing (qp)」→「価格表」と移動し、統合点のリストから価格リクエストを選択します。

4. 「WSDLの生成」をクリックし、Webサービスとして統合点(この例では、PL/SQL API統合点)を公開します。

5. 「WSDLの表示」リンクを右クリックして新しいタブまたは新しいウィンドウでリンクを開きます(後で必要となるため、タブまたはウィンドウは開いたままにします)。

6. 「統合リポジトリ」ページの「プロシージャとファンクション」(図10-11を参照)で、アクセス権が付与されるようにオブジェクトのボックスを選択し「アクセス権の付与」をクリックします。

図10-11 統合リポジトリ - 価格リクエストの例

7. 「権限受領者タイプ」および「権限受領者の名前」(公開されたオブジェクトへのアクセス権を付与するユーザー)を選択するか、「検索」ツールを使用します。この例では、ASADMINにアクセス権を付与します。

図10-12 統合リポジトリ - 「付与の作成」ページ

10.3.4.2 Webサービス・データ・コントロールのポータル・ページへの追加方法

WSDLを作成したら、引き続いて、WSDLを使用してWebサービス・データ・コントロールを作成できます。

注意:

データ・コントロールまたはデータ・コントロールを含むタスク・フローをポータル・ページに追加する前に、WebCenter PortalのWS-Securityを構成する必要があります。WS-Securityの構成の詳細は、「Webサービス・セキュリティの構成」を参照してください。

Webサービス・データ・コントロールの作成の詳細は、『Oracle WebCenter Portalでのポータルの構築』のWebサービス・データ・コントロールの作成に関する項を参照してください。Webサービス・データ・コントロールの詳細は、『Oracle WebCenter Portalでのポータルの構築』のWebサービス・データ・コントロールに関する項を参照してください。

Webサービス・データ・コントロールを作成するには:

1. データ・コントロールを作成するWebCenter Portalまたはポータルで、「共有アセット」ページまたは「アセット」ページのいずれかに移動します。

2. 「データ・コントロール」を選択し、「作成」をクリックします。

「新規データ・コントロールを作成します。」ダイアログが表示されます(図10-31を参照)。

図10-13 「新規データ・コントロールを作成します。」ダイアログ

3. 「新規データ・コントロールを作成します。」ダイアログで、データ・コントロールの「名前」と「説明」を入力して、「データ・コントロール・タイプ」として「Web Service」を選択し、「続行」をクリックします。

4. 「WSDLの生成方法」で生成したWSDL URLおよびデータ・コントロールのその他の詳細を入力し、「続行」をクリックします。

5. 「メソッドの表示」をクリックします。

6. 使用可能にするメソッドを選択し、「次へ」をクリックします。

7. パラメータのデフォルト値があれば入力し、「作成」をクリックします。

8. データ・コントロールを使用可能にするには、「共有アセット」ページまたは「アセット」ページから、「タスク・フロー」を選択します。「新規タスクフローを作成します。」ダイアログが表示されます(図10-33を参照)。

図10-14 新規タスク・フローの作成ダイアログ

9. タスク・フローの「名前」と「説明」を入力し、使用する「マッシュアップ・スタイル」を選択して「作成」をクリックし、タスク・フローを作成します。

10. タスク・フローを選択し、「編集」アイコンをクリックします。

11. データ・コントロールを(パラメータ形式で)タスク・フローに表として追加し、データを検証します。

12. タスク・フローを使用可能にするには、「管理」→「ビジネス・ロール・ページ」に移動します。

13. 「ビジネス・ロール・ページ」を選択し、「作成」アイコンをクリックします。

14. ページを編集して変更を保存します。

15. タスク・フローをページにドロップし、データを検証します。

10.4 JD Edwardsアプリケーションの統合

この項では、JD EdwardsアプリケーションをWebCenter Portalに統合する方法を説明します。

この項には次のサブセクションが含まれます:

- JD Edwardsアプリケーションのリモート・アクセスの準備方法

- プロデューサの登録方法

- WebCenter PortalページへのJD Edwardsポートレットの追加方法

- ポートレット接続のテスト方法

10.4.1 JD Edwardsアプリケーションのリモート・アクセスの準備方法

JD Edwardsスタンドアロン・リージョンをWebCenter Portalに追加する前に、JD Edwards内でそれらをポートレットとして外部で使用できるようにし、事前構成されたWSDLをwebclient.war/wsdlディレクトリに配置することで、リージョンをポートレット化する準備を整える必要があります。WSDL URLは、JD Edwards WSRPプロデューサを登録し、WebCenter Portalまたはポータル・ページからそれを利用できるようにするために必要です。ブラウザでJDE WSDLのXMLコンテンツを表示するには、ブラウザでページのページ・ソースを開きます。詳細は、「Oracle WebCenterによるWSRPの管理」を参照してください。

10.4.2 プロデューサの登録方法

『Oracle WebCenter Portalの管理』のポートレット・プロデューサの登録に関する項で説明されているように、JD Edwards WSRPプロデューサはWebCenter Portalで直接登録できます。また、次の手順で説明するとおり、Fusion Middleware Controlを使用してJD Edwards WSRPを登録できます。

Fusion Middleware Controlを使用してJD Edwards WSRPプロデューサを登録するには:

1. 「JD Edwardsアプリケーションのリモート・アクセスの準備方法」の説明に従って、WebCenter Portalで使用するJD Edwardsページのリモート・アクセスの準備を行います。

2. WebCenter PortalドメインのFusion Middleware Control(デフォルトではwc_domain)にログインします。

3. 「ナビゲーション・バー」でWebCenter Portalを開き、「WebCenterポータル」メニューで「プロデューサの登録」を選択します。

「ポートレット・プロデューサの追加」ページが表示されます。

4. 「接続名」としてJDEを入力し、「プロデューサ・タイプ」を「WSRPプロデューサ」に設定して、ステップ1でコピーしたWSDLエンドポイントURLを「URLエンドポイント」フィールドに貼り付けます。

5. 「OK」をクリックし、プロデューサ接続が正常に作成されたことを確認します。

6. 引き続いて、「WebCenter PortalページへのJD Edwardsポートレットの追加方法」の説明に従って、該当ポートレットをポータル・ページに追加します。

10.4.3 WebCenter PortalページへのJD Edwardsポートレットの追加方法

次の手順に従って、JD Edwardsリモート・プロデューサをWebCenter Portalで使用します。

1. WebCenter Portalにログインします。

2. JD Edwardsポータルの追加先となるページに移動するか、新規ページを作成します。

3. 「コンテンツの追加」をクリックし、リソース・カタログで「UIコンポーネント」、「ポートレット」の順に選択します。

カスタム・カタログが作成済の場合は、「ポートレット」が表示されないことがあります。この場合は、それをリソース・カタログに追加する必要があります。リソース・カタログの管理の詳細は、『Oracle WebCenter Portalでのポータルの構築』のリソース・カタログの使用に関する項を参照してください。

4. Fusion Middleware Controlに追加したポートレットをクリックします。

5. ポータル・ページに追加するJD Edwardsポートレットの「追加」をクリックします。

6. ポータル・ページで、ポートレットの「処理の表示」メニューをクリックし、「表示オプション」を選択します。

7. 「表示オプション」ダイアログで、IframeにポートレットをレンダリングするをTrueに設定して、「OK」をクリックします。

8. 引き続いて、「ポートレット接続のテスト方法」の説明に従って、ポートレット接続をチェックします。

10.4.4 ポートレット接続のテスト方法

次の手順に従って、コンテンツを変更し、その変更内容がJD Edwardsアプリケーションに表示されることを確認することで、ポートレット接続をテストします。

1. JD Edwardsポートレットを追加したWebCenter Portalまたはポータル・ページで、なんらかの情報を変更します。この情報は、その変更内容をJD Edwardsアプリケーションで確認できるものである必要があります。

2. 変更を保存し、変更内容がJD Edwardsアプリケーションでも表示されることを確認します。

10.5 PeopleSoftアプリケーションの統合

この項では、PeopleSoftアプリケーションをWebCenter Portalに統合する方法を説明します。

この項には次のサブセクションが含まれます:

- PeopleSoftアプリケーションの統合について

- WSRPポートレットとしてのPeopleSoftアプリケーションの統合方法

- WebCenter Portalへのデータ・コントロールとしてのPeopleSoftアプリケーションの統合方法

10.5.1 PeopleSoftアプリケーションの統合について

この項では、WebCenter PortalでのPeopleSoftアプリケーションの統合に関連する利点および方法を説明します。

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

- PeopleSoftの統合の理解

- PeopleSoftアプリケーションを統合するための要件

10.5.1.1 PeopleSoftの統合の理解

PeopleTools 8.51以降を使用すると、PeopleSoftアプリケーションをWSRPポートレットとしてWebCenter Portalなどのリモート・アプリケーション内で公開できます。これにより、PeopleSoftのごく一部の機能のみにアクセスする必要のあるユーザーは、PeopleSoftアプリケーション全体を開いたり習得したりすることなく、WebCenter Portalを通じてその機能にアクセスできるようになります。

10.5.1.2 PeopleSoftアプリケーションを統合するための要件

この項では、PeopleSoftオブジェクトをWebCenter Portalに統合するための前提条件を説明します。

- PeopleSoft 9.0以降。

- PeopleTools 8.51以降。

- PeopleSoftへの自動サインオンのためにWS-Securityを使用している場合は、SAMLアサーションが有効になるためには、PeopleSoftとOracle WebCenter Portalのサーバー上の日付/時刻が同期化されている必要があります。これについて問題がある場合は、PeopleSoftのWebサーバーの時刻をOracle WebCenter Portalサーバーより少し進めてもかまいません。

- PeopleTools 8.51の場合は、WS-Securityを完全にサポートするためには、必要に応じてカスタムOWSMポリシーを作成して構成してください。詳細は、「PeopleTools 8.51向けのWS-Securityの構成方法」を参照してください。

- PeopleTools 8.51の場合、大文字のサブジェクト名のみがサポートされています。統合を機能させるには、WebCenterで完全に大文字のユーザーIDのみを使用できるようにすることが必要です。

10.5.2 WSRPポートレットとしてのPeopleSoftアプリケーションの統合方法

この項では、PeopleSoftアプリケーションをWSRPポートレットとしてWebCenter Portalに公開する方法を説明します。

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

- PeopleSoftアプリケーションのリモート・アクセスの準備方法

- PeopleTools 8.52以降向けのWS-Securityの構成方法

- WebCenter PortalへのWS-Securityポリシーの添付方法

- WebCenter PortalへのPeopleSoftアプリケーションの統合方法

- PeopleTools 8.51向けのWS-Securityの構成方法

10.5.2.1 PeopleSoftアプリケーションのリモート・アクセスの準備方法

この項では、PeopleSoftアプリケーションをWebCenter Portalで使用できるように準備する方法を説明します。

PeopleSoftアプリケーションを準備するには:

1. 管理者としてPeopleSoftにログインします。

2. メイン・メニューからPeopleToolsを選択します。

3. 「PeopleTools」メイン・メニューから、「ポータル」を開きます。

4. 構造とコンテンツを選択します。

「構造とコンテンツ」ページには、WSRPポートレットとして公開できるPeopleSoftオブジェクトを含むフォルダのリストが表示されます(図10-15参照)。

図10-15 「構造とコンテンツ」ページ

5. WebCenter Portalでポートレットとして公開するサービスを含むフォルダおよび(必要に応じて)サブフォルダに移動し、「編集」をクリックしてフォルダを開きます。たとえば、「セルフサービス」、「個人情報」、「個人情報サマリー」を選択できます。

「コンテンツ参照管理」ページが表示されます(図10-16を参照)。

図10-16 「コンテンツ参照管理」ページ

6. 「一般」タブで、WSRP作成可能チェック・ボックスを選択します。

7. ページを保存します。

8. PeopleSoft Application Designerで、PeopleSoftで表示される「リクエスト詳細」ページに対してコンポーネント・オブジェクトを開き、「コンポーネント・プロパティ」セクションでWSRP準拠チェック・ボックスを選択します。

9. メイン・メニューから、「PeopleTools」、「ポータル」を開き、「WSRP のプロデュース」を選択します。

「プロデューサ提供ポートレット」ページが表示されます(図10-17を参照)。

図10-17 「プロデューサ提供ポータル」ページ

10. 当該サービスが公開されていることを確認してから、「Web サービス エンドポイントURL」を開き、URL (WSDL)をコピーします。

11. ブラウザで新しいタブを開いて、コピーしたURLをナビゲーション・バーに貼り付けて、WSDLページにアクセスします。

12. そのURLをクリップボードにコピーします。

13. 引き続いて、「WebCenter PortalへのPeopleSoftアプリケーションの統合方法」の説明に従って、PeopleSoft WSRPプロデューサをWebCenter Portalに統合します。

10.5.2.2 PeopleTools 8.52以降向けのWS-Securityの構成方法

この項では、WebCenter PortalおよびPeopleSoftの両方に対してキーストアを作成し、双方の間で秘密鍵を交換する方法について説明します。この手順は、WebCenter PortalにWS-Securityポリシーを追加する前に実行する必要があります。

1. 最初に、秘密鍵orakeyを持つWebCenterキーストアwebcenter.jks、PeopleSoftの公開鍵rootCA、およびPeopleSoftがWS-Security受信者として使用する証明書を、次のkeytoolコマンドを使用して作成します。

./keytool -genkeypair -keyalg RSA -dname "cn=orakey,dc=us,dc=oracle,dc=com" -alias orakey -keypass password -keystore webcenter.jks -storepass password -validity 720

./keytool -exportcert -v -alias orakey -keystore webcenter.jks -storepass password -rfc -file orakey.cer

./keytool -importcert -trustcacerts -alias orakey -file orakey.cer -keystore peoplesoft.jks -storepass password

2. 次に、秘密鍵rootCAを持つPeopleSoftキーストアpeoplesoft.jks、WebCenterの公開鍵orakey、およびWebCenterがWS-Security受信者として使用する証明書を作成します。

./keytool -genkeypair -keyalg RSA -dname "cn=rootCA,dc=us,dc=oracle,dc=com" -alias rootCA -keypass password -keystore peoplesoft.jks -storepass password -validity 720

./keytool -exportcert -v -alias rootCA -keystore peoplesoft.jks -storepass password -rfc -file rootca.cer

./keytool -importcert -trustcacerts -alias rootCA -file rootca.cer -keystore webcenter.jks -storepass password

3. WebCenter PortalおよびPeopleSoftのキーストアを作成したら、peoplesoft.jksをPeopleSoftホストに、webcenter.jksをWebCenterホストに次のようにコピーします。

- peoplesoft.jksを<Domain_Home>/config/fmwconfig/にコピー

- webcenter.jksを/home/psadm2/psft/pt/8.52/webserv/<Domain_Name>/applications/peoplesoft/pspc.war/WEB-INF/classesにコピー

4. 次に示すように、PeopleSoftに証明書をインストールします。

a. PeopleSoftに管理者としてログインし、「PeopleTools」→「セキュリティ」→「セキュリティ オブジェクト」→「電子証明書」に移動します。
「電子証明書」ページが表示されます(図10-18を参照)。

図10-18 「電子証明書」ページ

b. 「+」をクリックして新規エントリを追加します。
図10-19に示すように、RemoteおよびRootCAの電子証明書を追加する必要があります。

図10-19 「電子証明書」ページ

c. 「タイプ」にRootCA、「別名」にorakey、発行機関別名にorakeyを入力し、「検索」アイコン(虫メガネ)をクリックします。

d. 「インポート」をクリックし、ポップアップで先に作成したorakey.cerのテキスト全体を入力し、「OK」をクリックします。

e. 「+」をクリックして別の新規エントリを追加し、「タイプ」にRemote、「別名」にorakey、発行機関別名にorakeyを入力し、「検索」アイコンをクリックします。

f. 「インポート」をクリックし、ポップアップで先に作成したorakey.cerのテキスト全体を入力し、「OK」をクリックします。

5. /home/psadm2/psft/pt/8.52/webserv/<Domain_Name>/applications/peoplesoft/pspc.war/WEB-INF/classesにあるWSS.propertiesファイルを更新し、peoplesoft.jksファイルを参照します。

6. 図10-20に示すように、PSCipher.shを使用して暗号化されたパスワードを作成し、キーストア・パスワードを更新します。

図10-20 PSCipher.sh

7. PeopleSoftで次のローカル・ノード定義を確認します。

a. 「Peopletools」→「ポータル」→「ノード定義」へ移動します。
「ノード」ページが表示されます。

b. 「検索」をクリックしてPSFT-HRをクリックします。

図10-21 「ノード定義」ページ

c. 「認証オプション」ドロップダウン・リストからPasswordを選択し、「保存」をクリックします。

8. 引き続いて、「WebCenter PortalへのWS-Securityポリシーの添付方法」の説明に従って、WS-SecurityポリシーをWebCenter Portalに追加します。

10.5.2.3 WebCenter PortalへのWS-Securityポリシーの添付方法

この項では、WebCenter PortalにWS-Securityポリシーを添付する方法について説明します。

注意:

次の手順を続行する前に、「PeopleTools 8.52以降向けのWS-Securityの構成方法」の説明に従って、WebCenterおよびPeopleSoftのキーストアを構成しておく必要があります。

- メッセージ整合性付きのWSS 1.0 SAMLトークンの構成方法

- パスワードなしのWSS 1.0ユーザー名トークンの構成方法

- メッセージ保護付きのWSS 1.0 SAMLトークンの構成方法

- パスワード付きのWSS 1.0ユーザー名トークンの構成方法

10.5.2.3.1 メッセージ整合性付きのWSS 1.0 SAMLトークンの構成方法

次の手順に従って、WebCenter Portal用にメッセージ整合性ポリシー付きのWSS1.0 SAMLトークンを構成します。

1. PeopleSoftサーバーの次のディレクトリに移動します。
/home/psadm2/psft/pt/8.53/webserv/peoplesoft/piabin

次のコマンドを実行します。

./redeployWSRP.sh 6

これにより、PeopleSoft WSRPセキュリティ・オプションを更新し、WSRPBaseService with SAMLToken Full Securityを使用できます。

2. PeopleSoftで、「PeopleTools」→「セキュリティ」→「SAML 管理設定」→「SAML インバウンド設定」に移動します。
「SAML インバウンド設定」ページが表示されます(図10-22を参照)。

図10-22 「SAML インバウンド設定」ページ

3. WebCenter PortalユーザーとPeopleSoftユーザーが異なるOIDを使用している場合(設定の例を次に示します)は、「新規値の追加」タブを開いてWebCenterユーザーをPeopleSoftユーザーにマッピングし、「保存」をクリックします。
例:

- 証明書の別名: orakey

- 発行機関: WWW.ORACLE.COM

- サブジェクト名: pat

- 識別子名: WWW.ORACLE.COM

- Peoplesoft ユーザー ID のマッピング: PS

4. 引き続いて、「WebCenter PortalへのPeopleSoftアプリケーションの統合方法」の説明に従って、ポータル・ページにWSRPプロデューサを登録し、該当ポートレットを追加します。

10.5.2.3.2 パスワードなしのWSS 1.0ユーザー名トークンの構成方法

次の手順に従って、WebCenter Portalにパスワード・ポリシーなしのWSS 1.0ユーザー名トークンを添付します。

1. 次のように、PeopleSoftでWebCenterユーザーを作成します。

a. PeopleSoftで、「PeopleTools」→「セキュリティ」→「ユーザー プロファイル」→「ユーザー プロファイルのコピー」に移動します。
「ユーザー プロファイルのコピー」ページが表示されます(図10-23を参照)。

図10-23 「ユーザー プロファイルのコピー」ページ - 「検索条件」

b. 追加するユーザーを検索します(PSなど)。
検索結果が表示されます(図10-24を参照)。

図10-24 「ユーザー プロファイルのコピー」ページ - 「検索結果」

c. 「新規ユーザー ID」(Patなど)、「説明」、「新規パスワード」を入力し、「ID タイプ情報をコピー」オプションを選択して「保存」をクリックします。

2. Fusion Middleware Controlにログインして、ドメインを選択し、「セキュリティ」→「セキュリティ・プロバイダ構成」に移動します。
「セキュリティ・プロバイダ構成」ページが表示されます。

3. 「キーストア」セクションを開いて「構成」をクリックします。
「キーストアの構成」ページが表示されます。

4. 「キーストア・パス」に./webcenter.jks、「キーの別名」にorakey、「暗号化の別名」にorakeyを入力します。関連付けられたパスワードを入力し、「OK」をクリックします。
変更した構成を有効にするには、ドメイン全体を再起動する必要があります。

5. /home/psadm2/psft/pt/8.53/webserv/peoplesoft/piabinに移動して次のコマンドを実行します。
./redeployWSRP.sh 8

これにより、PeopleSoft WSRPセキュリティ・オプションが更新され、WSRPBaseService with UsernameToken、No Password Full Security Option With WSS Responseが使用できます。

6. 引き続いて、「WebCenter PortalへのPeopleSoftアプリケーションの統合方法」の説明に従って、WebCenter Portalまたはポータル・ページにWSRPプロデューサを登録し、該当ポートレットを追加します。

10.5.2.3.3 メッセージ保護付きのWSS 1.0 SAMLトークンの構成方法

次の手順に従って、WebCenter Portalにメッセージ保護ポリシー付きのWSS1.0 SAMLトークンを添付します。

1. /home/psadm2/psft/pt/8.53/webserv/peoplesoft/piabinに移動して次のコマンドを実行します。
./redeployWSRP.sh 10

これにより、PeopleSoft WSRPセキュリティ・オプションが更新され、WSRPBaseService with SAMLToken Full Security Option With WSS Responseが使用できます。

2. 引き続いて、「WebCenter PortalへのPeopleSoftアプリケーションの統合方法」の説明に従って、ポータル・ページにWSRPプロデューサを登録し、該当ポートレットを追加します。

10.5.2.3.4 パスワード付きのWSS 1.0ユーザー名トークンの構成方法

次の手順に従って、WebCenter Portalにメッセージ保護ポリシー付きのWSS1.0 SAMLトークンを添付します。

1. /home/psadm2/psft/pt/8.53/webserv/peoplesoft/piabinに移動して次のコマンドを実行します。
./redeployWSRP.sh 7

これにより、PeopleSoft WSRPセキュリティ・オプションが更新され、WSRPBaseService with UsernameToken Full Security Option With WSS Responseが使用できます。

2. 引き続いて、「WebCenter PortalへのPeopleSoftアプリケーションの統合方法」の説明に従って、WebCenter Portalまたはポータル・ページにWSRPプロデューサを登録し、該当ポートレットを追加します。

10.5.2.4 WebCenter PortalへのPeopleSoftアプリケーションの統合方法

この項では、PeopleSoftアプリケーションをWebCenter Portalに統合する方法を説明します。

この項には次のサブセクションが含まれます:

- WebCenter PortalへのPeopleSoft WSRPプロデューサの登録方法

- WebCenter PortalページへのPeopleSoftポートレットの追加方法

- ポータル・ポートレット接続のテスト方法

10.5.2.4.1 WebCenter PortalへのPeopleSoft WSRPプロデューサの登録方法

『Oracle WebCenter Portalの管理』のポートレット・プロデューサの登録に関する項で説明されているように、PeopleSoft WSRPプロデューサはWebCenter Portalで直接登録できます。また、次の手順で説明するとおり、Fusion Middleware Controlを使用してPeopleSoft WSRPを登録できます。

Fusion Middleware Controlを使用してPeopleSoft WSRPプロデューサを登録するには:

1. 「PeopleSoftアプリケーションのリモート・アクセスの準備方法」の説明に従って、WebCenter Portalで使用するPeopleSoftページのリモート・アクセスの準備を行います。

2. WebCenter PortalドメインのFusion Middleware Control(デフォルトではwc_domain)にログインします。

3. 「ナビゲーション・バー」でWebCenter Portalを開き、「WebCenterポータル」メニューで「プロデューサの登録」を選択します。
「ポートレット・プロデューサの追加」ページが表示されます。

4. 「プロデューサ・タイプ」を「WSRPプロデューサ」に設定し、「接続名」を入力して、ステップ1でコピーしたWSDLエンドポイントURLを「URLエンドポイント」フィールドに貼り付けます。

5. 必要に応じて、「PeopleTools 8.51向けのWS-Securityの構成方法」の説明に従い、WebCenter Portal内でWS-Securityを構成します。

6. 「OK」をクリックし、プロデューサ接続が正常に作成されたことを確認します。

7. 引き続いて、「WebCenter PortalページへのPeopleSoftポートレットの追加方法」の説明に従って、該当ポートレットをWebCenter Portalまたはポータル・ページに追加します。

10.5.2.4.2 WebCenter PortalページへのPeopleSoftポートレットの追加方法

次の手順に従って、WebCenter Portalまたはポータル・ページにPeopleSoftポートレットを追加します。

1. WebCenter Portalにログインします。
WS-Securityを構成したら、PeopleSoftの「SAML インバウンド設定」ページで使用されているユーザー・アカウントを使用していることを確認します(「WebCenter PortalへのWS-Securityポリシーの添付方法」を参照)。

2. PeopleSoftポータルの追加先となるページに移動するか、新規ページを作成します。

3. 「コンテンツの追加」をクリックし、リソース・カタログで「UIコンポーネント」、「ポートレット」の順に選択します。
カスタム・カタログが作成済の場合は、「ポートレット」が表示されないことがあります。この場合は、それをリソース・カタログに追加する必要があります。リソース・カタログの管理の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページでのリソース・カタログ・コンポーネントの使用に関する項を参照してください。

4. Fusion Middleware Controlに追加したポートレットをクリックします。

5. ポータル・ページに追加するPeopleSoftページの「追加」をクリックします。

6. ポータル・ページで、ポートレットの「処理の表示」メニューをクリックし、「表示オプション」を選択します。

7. 「表示オプション」ダイアログで、IframeにポートレットをレンダリングするをTrueに設定して、「OK」をクリックします。

8. 引き続いて、「ポータル・ポートレット接続のテスト方法」の説明に従って、ポートレット接続をチェックします。

10.5.2.4.3 ポータル・ポートレット接続のテスト方法

次の手順に従って、コンテンツを変更し、その変更内容がPeopleSoftアプリケーションに表示されることを確認することで、ポートレット接続をテストします。

1. PeopleSoftポートレットを追加したWebCenter Portalまたはポータル・ページで、なんらかの情報を変更します。この情報は、その変更内容をPeopleSoftアプリケーションで確認できるものである必要があります。

2. 変更を保存し、変更内容がPeopleSoftアプリケーションでも表示されることを確認します。

10.5.2.5 PeopleTools 8.51向けのWS-Securityの構成方法

この項では、PeopleTools 8.51でサポートされているOWSMポリシーについて説明します。PeopleToolsリリース8.51は、メッセージ内の送信WS-Securityヘッダーをサポートしていない点に注意する必要があります。ただし、一部のデフォルトのOracle WebCenter Portal/OWSMポリシーでは、送信メッセージと受信メッセージの両方がセキュリティ保護されている必要があります。このギャップを埋めるために、必要に応じてカスタムOWSMポリシーを作成してください。この項では、カスタムWS-Securityポリシーを作成する必要があり、それらを構成するためにWebCenter Portal側での手順が必要となる異なる統合シナリオについても説明します。

PeopleTools 8.51との統合シナリオの場合は、OWSMポリシーとして、メッセージ整合性付きWSS10 SAMLトークン、メッセージ保護付きWSS10 SAMLトークンまたはパスワード付きWSS10ユーザー名トークンを使用できます。

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

- メッセージ整合性付きのWSS10 SAMLトークン向けのWS-Securityの構成方法

- メッセージ保護付きのWSS10 SAMLトークン向けのWS-Securityの構成方法

- パスワード付きのWSS10ユーザー名トークン向けのWS-Securityの構成方法

10.5.2.5.1 メッセージ整合性付きのWSS10 SAMLトークン向けのWS-Securityの構成方法

(PeopleSoftポリシー: WSRPBaseService with SAMLToken Full Security Option (timestamp))

この項では、メッセージ整合性付きのWSS10 SAMLトークン(oracle/wss10_saml_token_with_message_integrity_client_policy)ポリシー向けにWS-Securityを構成する方法を説明します。

WS-Securityを構成する手順は次のとおりです。

1. 「Webサービス・セキュリティの構成」で説明されているように、Oracle WebCenter Portal/OWSMキーストアを設定します。

2. Oracle WebCenter Portalドメインの公開鍵が含まれた証明書を生成して、PeopleToolsの管理者に送信します。これにより、その証明書をPeopleToolsの構成にインポートできるようになります。

3. プロデューサの登録時に、wss10_saml_token_with_message_integrity_client_policyを選択します。

4. 引き続いて、WSRPポートレットをWebCenter PortalページまたはFrameworkアプリケーション・ページに追加します。

10.5.2.5.2 メッセージ保護付きのWSS10 SAMLトークン向けのWS-Securityの構成方法

(PeopleSoftポリシー: WSRPBaseService with SAMLToken Full Security Option (timestamp) With WSS Response)

OWSMに付属しているデフォルトのメッセージ保護付きWSS10 SAMLトークン(oracle/wss10_saml_token_with_message_protection_client_policy)ポリシーでは、レスポンスも署名および暗号化されることが要求されます。しかし、PeopleToolsリリース8.51以前はWS-Securityヘッダーをレスポンスに格納して送信できないため(最初のcookie/get portlet handleコールのみにセキュリティ・ヘッダーが含まれており、後続のコールには含まれていません)、oracle/wss10_saml_token_with_message_protection_client_policyポリシーに基づいたカスタム・ポリシーを作成して添付する必要があります。

カスタム・ポリシーを作成するには:

1. Fusion Middleware Controlにログインし、Oracle WebCenter Portalドメイン(デフォルトではwc_domain)に移動します。

2. 「WebLogicドメイン」メニューから、「Webサービス」→「ポリシー」を選択します。

3. wss10_saml_token_with_message_protection_client_policyを選択して、「類似作成」をクリックします。

4. このポリシーに新しい名前を付けます(例: oracle/wss10_saml_token_with_message_protection_plaintext_response_client_policy)。

5. 「レスポンス」タブを開き、「メッセージの署名設定」および「メッセージの暗号化設定」の「本体全体を含める」チェック・ボックスを選択解除して、ポリシーを保存します。

6. PeopleSoftキーストアの公開証明書がWebCenter Portalドメイン内で使用されているキーストアにインポートされていることを確認します。

7. 次の例に示すように、WLSTを使用して、新しく作成されたポリシーを使ってプロデューサを登録します。

registerWSRPProducer('webcenter', 'wc-pt851-saml_msg-protection', 'http://xmlns.oracle.com/pspc/pswsdl/ps/EMPLOYEE', timeout=100, tokenType='oracle/wss10_saml_token_with_message_protection_plaintext_response_client_policy',
enforcePolicyURI='false', issuer='www.oracle.com', sigKeyAlias='webcenter',sigKeyPswd='welcome1', encKeyAlias='webcenter', encKeyPswd='welcome1', recptAlias='peopleTools_public')

recptAliasパラメータの値として、インポートされたpeoplesft公開鍵の別名を使用します。

注意:

プロデューサを登録するにはWLSTを使用する必要があります。Fusion Middleware Controlは固定ポリシー名のみ受け入れ可能なため、enforcePolicyURI='false'を渡すことで、WLSTを使用してプロデューサにこのポリシーを登録する必要があります。

10.5.2.5.3 パスワード付きのWSS10ユーザー名トークン向けのWS-Securityの構成方法

(PeopleSoftポリシー: WSRPBaseService with UsernameToken Full Security Option With WSS Response)

OWSMに付属しているデフォルトのパスワード付きWSS10ユーザー名トークン(oracle/wss10_username_token_with_message_protection_client_policy)ポリシーでは、レスポンスも署名および暗号化されることが要求されます。しかし、PeopleToolsリリース8.51以前はWS-Securityヘッダーをレスポンスに格納して送信できないため(最初のcookie/get portlet handleコールのみにセキュリティ・ヘッダーが含まれており、後続のコールには含まれていません)、oracle/wss10_username_token_with_message_protection_client_policyポリシーに基づいたカスタム・ポリシーを作成して添付する必要があります。

カスタム・ポリシーを作成するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalドメイン(デフォルトではwc_domain)に移動します。

2. 「WebLogicドメイン」メニューから、「Webサービス」→「ポリシー」を選択します。

3. wss10_username_token_with_message_protection_client_policyを選択して、「類似作成」をクリックします。

4. このポリシーに新しい名前を付けます(例: oracle/wss10_username_token_with_message_protection_plaintext_response_client_policy)。

5. 「レスポンス」タブを開き、「メッセージの署名設定」および「メッセージの暗号化設定」の「本体全体を含める」チェック・ボックスを選択解除して、ポリシーを保存します。

6. PeopleSoftキーストアの公開証明書がOracle WebCenter Portalドメイン内で使用されているキーストアにインポートされていることを確認します。

7. 次の例に示すように、WLSTを使用して、新しく作成されたポリシーを使ってプロデューサを登録します。

registerWSRPProducer('webcenter', '<Producer_Name>', '<URL>', timeout=100,
tokenType='oracle/wss10_username_token_with_message_protection_plaintext_response_client_policy', extApp='<Ext_App_Name>',
enforcePolicyURI='false', issuer='www.oracle.com',
sigKeyAlias='webcenter',sigKeyPswd='welcome1', encKeyAlias='webcenter',
encKeyPswd='welcome1', recptAlias='peopleTools_public')

recptAliasパラメータの値として、インポートされたpeoplesft公開鍵の別名を使用します。

注意:

プロデューサを登録するにはWLSTを使用する必要があります。Fusion Middleware Controlは固定ポリシー名のみ受け入れ可能なため、enforcePolicyURI='false'を渡すことで、WLSTを使用してプロデューサにこのポリシーを登録する必要があります。

10.5.3 WebCenter Portalへのデータ・コントロールとしてのPeopleSoftアプリケーションの統合方法

この項では、PeopleSoftアプリケーションをWebサービス・データ・コントロールとしてWebCenter Portalに追加する方法を説明します。

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

- WSDLの準備方法

- Webサービス・データ・コントロールの作成方法

10.5.3.1 WSDLの準備方法

次の手順に従って、WSDLを準備します。

1. 管理者としてPeopleSoftコンソールにログインします。

2. 「PeopleTools」→「Web プロファイル」→「Web プロファイル設定」に移動します。

3. 「検索」をクリックし、結果リストからDEVを選択します。

図10-25 「Web プロファイル設定」ページ

4. 「一般」タブを開き、ホストの「認証ドメイン」を入力します。

たとえば、ホスト名がps.example.comの場合は、「認証ドメイン」フィールドに.example.comを入力します。

5. 変更を保存し、アプリケーションを閉じます。

6. C:\Windows\System32\drivers\etc\hostsファイルを開いて編集します。

7. 新しい行で、IPアドレスと認証ドメインを含む完全ホスト名を入力します。

例:

193.128.1.113 ps.example.com

8. ファイルを保存してサーバーを再起動します。

9. 次のURLを使用してPeopleSoftアプリケーションにログインします。

http://<host_name>:8000/ps/signon.html

例:

http://ps.example.com:8000/ps/signon.html

10. 「メイン メニュー」から、「PeopleTools」→「インテグレーション ブローカー」→「設定」→「ゲートウェイ」に移動します。

11. ゲートウェイIDのLOCALを検索します。ゲートウェイのローカルURLを次のように設定します。

http://<host_name>:8000/PSIGW/PeopleSoftListeningConnector

12. ゲートウェイのローカルURLを使用して、ゲートウェイがアクティブであるかどうかping確認をします。

13. 「ゲートウェイ設定プロパティ」を開いて管理者としてログインします。

14. 「PeopleSoft ノード設定」ページで、使用されているノードがPSFT_HRであることを確認します。

15. ノードをpingします

16. 「メイン メニュー」から、「PeopleTools」→「インテグレーション ブローカー」→「設定」→「サービス設定」に移動します。

17. 「ターゲット ロケーションの設定」を開き、「ターゲット ロケーション」が<Local Gateway URL>/PSFT_HRに設定されていることを確認します。

18. 「メイン メニュー」から、「PeopleTools」→「インテグレーション ブローカー」→「インテグレーション設定」→「ノード」に移動します。

19. 「検索」をクリックします。

20. 「デフォルト ローカル ノード」のPSFT_HRをクリックします。

21. 「ノード」タブで、図10-26の例のように、デフォルト・ユーザーIDを正しく設定します。

図10-26 「ノード」ページ - 「ノード定義」

22. 「検索に戻る」をクリックします。

23. ANONYMOUSノードをクリックします。

24. 図10-27の例のように、デフォルト・ユーザーIDをPeopleSoftのログインID (PSなど)に変更します。

図10-27 「ノード」ページ - 「ノード定義」

25. 変更を保存し、「メイン メニュー」→「PeopleTools」→「インテグレーション ブローカー」→「Web サービス」→「CI ベース サービス」に移動します。

26. 図10-28の例のように、「コンポーネント インターフェイス名」(たとえばCURRENCY)を検索して選択します。

図10-28 「CI ベース サービス」ページ - 「コンポーネント インターフェイスの選択」

27. 「CI ステータス確認」をクリックします。

「CI ベース サービス」 - 「ステータス確認」ページが表示されます(図10-29を参照)。

図10-29 CIベース・ステータスの確認 - 「ステータス確認」ページ

28. 使用可能なメソッド(この場合GetおよびFind)を選択し、「選択アクションの表示」をクリックします。

29. 「アクション確認」ダイアログで、「選択アクションの実行」をクリックします。

30. 「サービス定義の表示」をクリックします。

31. 「Web サービスの提供」をクリックします。

「サービス オペレーションの選択」ページが表示されます(図10-30を参照)。

図10-30 「サービス オペレーションの選択」ページ

32. 「全て選択」チェック・ボックスを選択し、最後のページになるまで「次へ」をクリックします。

33. 「終了」をクリックしてWSDLを生成します。

これで、WSDL URLにアクセスできます。この例では、URLは次のようになります。

http://ps.example.com:8000/PSIGW/PeopleSoftServiceListeningConnector/PSFT_HR/CI_CURRENCY.1.wsdl\\\\

34. 引き続いて、「Webサービス・データ・コントロールの作成方法」で示されるように、Webサービス・データ・コントロールを作成します。

10.5.3.2 Webサービス・データ・コントロールの作成方法

WSDLを作成したら、引き続いて、WSDLを使用してWebサービス・データ・コントロールを作成できます。この項では、「WSDLの準備方法」で始められた例を続けます。

注意:

データ・コントロールまたはデータ・コントロールを含むタスク・フローをポータル・ページに追加する前に、WebCenter PortalのWS-Securityを構成する必要があります。WS-Securityの構成の詳細は、『Oracle WebCenter Portalの管理』の「Webサービス・セキュリティの構成」を参照してください。

Webサービス・データ・コントロールの作成の詳細は、『Oracle WebCenter Portalでのポータルの構築』のWebサービス・データ・コントロールの作成に関する項を参照してください。Webサービス・データ・コントロールの詳細は、『Oracle WebCenter Portalでのポータルの構築』のWebサービス・データ・コントロールに関する項も参照してください。

Webサービス・データ・コントロールを作成するには:

1. データ・コントロールを作成するWebCenter Portalまたはポータルで、「共有アセット」ページまたは「アセット」ページのいずれかに移動します。

2. 「データ・コントロール」を選択し、「作成」をクリックします。

「新規データ・コントロールを作成します。」ダイアログが表示されます(図10-31を参照)。

図10-31 「新規データ・コントロールを作成します。」ダイアログ

3. 「新規データ・コントロールを作成します。」ダイアログで、データ・コントロールの「名前」と「説明」を入力して、「データ・コントロール・タイプ」として「Web Service」を選択し、「続行」をクリックします。

4. WSDL URLおよびデータ・コントロールのその他の詳細を入力し、「続行」をクリックします。この例では、URLは次のようになります。

http://ps.example.com:8000/PSIGW/PeopleSoftServiceListeningConnector/PSFT_HR/CI_CURRENCY.1.wsdl

5. この例では、CURRENCY_CDの「デフォルト値」にUSDを入力し、「作成」をクリックします(図10-32を参照)。

図10-32 「新規データ・コントロールを作成します。」ダイアログ - CI_Currency_Gメソッド・パラメータ

6. データ・コントロールを使用可能にするには、「共有アセット」ページまたは「アセット」ページから、「タスク・フロー」を選択します。「新規タスクフローを作成します。」ダイアログが表示されます(図10-33を参照)。

図10-33 新規タスク・フローの作成ダイアログ

7. 「作成」をクリックしてタスク・フローを作成します。

8. タスク・フローを選択し、「編集」アイコンをクリックします。

9. データ・コントロールを(パラメータ形式で)タスク・フローに表として追加し、データを検証します。

10. タスク・フローを使用可能にするには、「管理」→「ビジネス・ロール・ページ」に移動します。

11. 「ビジネス・ロール・ページ」を選択し、「作成」アイコンをクリックします。

12. ページを編集して変更を保存します。

13. タスク・フローをページにドロップし、データを検証します。

10.6 Oracle Business Intelligenceプレゼンテーション・サービスの統合

この項では、Oracle Business Intelligenceプレゼンテーション・サービス・カタログと統合するようにWebCenter Portalを構成する方法を説明します。実行時に、ユーザーはビジネス・インテリジェンス・オブジェクトをWebCenter Portalページに追加できます。

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

- Oracle Business Intelligenceプレゼンテーション・サービスの統合について

- Oracle BIプレゼンテーション・カタログに接続するための資格証明の構成方法

- WebCenter PortalへのOracle Business Intelligenceオブジェクトの統合方法

10.6.1 Oracle Business Intelligenceプレゼンテーション・サービスの統合について

この項では、Oracle Business Intelligenceプレゼンテーション・サービス・カタログと統合するようにWebCenter Portalを構成する方法を説明します。

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

- Oracle Business Intelligenceプレゼンテーション・サービスの統合の理解

- Oracle Business Intelligenceプレゼンテーション・サービスを統合するための要件

- 拡張統合オプション

10.6.1.1 Oracle Business Intelligenceプレゼンテーション・サービスの統合の理解

Oracle WebCenter Portalユーザーは、プレゼンテーション・サービス・カタログのフォルダを開いて参照し、分析のビューを表示できます。プレゼンテーション・サービス・カタログに表示されるビュー・タイプは、表、ピボット・テーブル、チャート、ファンネル・チャート、ゲージ、ナラティブ、ティッカおよびタイトルです。プレゼンテーション・サービス・カタログに表示されないビュー・タイプは、ビュー・セレクタ、列セレクタ、論理SQLおよび結果なしのビューです。

ユーザーは、ダッシュボード・フォルダを参照してダッシュボードと関連付けられたページを探すこともできますが、ダッシュボード・ページ内を参照して自身のコンポーネント(ダッシュボードに埋め込まれた分析など)を表示することはできません。

10.6.1.2 Oracle Business Intelligenceプレゼンテーション・サービスを統合するための要件

『Oracle Business Intelligence Enterprise Edition開発者ガイド』のOracle BI EEプレゼンテーション・サービス接続の作成に関する項に従って、BIアプリケーションへの接続を設定してセキュリティを構成する必要もあります。「Oracle BIプレゼンテーション・カタログに接続するための資格証明の構成方法」の説明に従って、この接続用の資格証明を指定する必要もあります。

次の前提条件が適用されます。

Oracle WebCenter Portal

- データベース接続、Content Server接続およびFusion Middleware Controlも含めて、WC_Portalサーバーがインストール済および構成済

OBIEE

- Oracle Business Intelligenceアプリケーション

- OBI Enterprise Editionリリース11.1.1.7.0

- OBIアプリケーション リリース7.9.6.3 (オプション)

- OBIEEはインストール済、構成済で実行中(データベース: OBI Enterprise Edition)

- OBIアプリケーションはインストール済、設定済で、すべてのコンテンツがOBIEE環境から使用可能(オプション)

セキュリティ

OBIEE統合では、WebCenterおよびOBIEE間で同じアイデンティティ・ストア・ユーザー名が移入される必要があります。これは次のいずれかの方法で実行できます。

- WebCenterとOBIEEが同じアイデンティティ・ストアを共有(推奨)

- WCとOBIEEの異なるアイデンティティ・ストア間で、同じユーザー名を維持

10.6.1.3 拡張統合オプション

ページ上に簡単にドロップできるビジネス・インテリジェンス分析、ダッシュボード、スコアカード・コンポーネントなど、「Oracle Business Intelligenceプレゼンテーション・サービスの統合」の各項で説明したリソースの追加方法に加えて、WebサービスおよびBI EE論理SQLビュー・オブジェクトを使用して、ビジネス・インテリジェンス・データをFrameworkアプリケーションに埋め込むオプションもあります。Webサービスの使用の詳細は、『Oracle Business Intelligence Enterprise Editionインテグレーターズ・ガイド』のOracle Business Intelligence Webサービスの概要に関する項を参照してください。BI EE論理SQLビュー・オブジェクトの使用の詳細は、『Oracle Business Intelligence Enterprise Edition開発者ガイド』のOracle BI EE論理SQLビュー・オブジェクトの使用に関する項を参照してください。

10.6.2 Oracle BIプレゼンテーション・カタログに接続するための資格証明の構成方法

設計時に、Oracle BIプレゼンテーション・カタログに接続するための資格証明を指定する必要があります。これらの資格証明を使用して、Oracle BIプレゼンテーション・カタログからビジネス・インテリジェンス・オブジェクト(分析、ダッシュボード、スコアカード・コンポーネントなど)のリストが取得されます。

このプロセスによって、プレゼンテーション・サーバーへのログインがアプリケーションの現在のユーザーと同じであること、すべてのアクセス・チェックが現在のユーザーとして実行されること、およびデータが現在のユーザーとしてフェッチされることが保証されます。ADFページに、ユーザーがアクセスできないビジネス・インテリジェンス・オブジェクトが含まれている場合は、ADFページは、ユーザーがこれらのオブジェクトにアクセスするための適切な権限を持っていないことを示すメッセージを返します。

セキュリティが有効になっている場合は、「偽装の実行」パラメータをtrueに設定する必要があります。

この項には次のサブセクションが含まれます:

- BIImpersonatorUserの確認方法

- BIImpersonatorUserの作成方法

- BIImpersonatorUserへの権限の付与方法

10.6.2.1 BIImpersonatorUserの確認方法

BIImpersonatorUserユーザーが存在するかどうか、そのユーザーに割り当てられたロールが正しいかどうかを確認するには、次の手順を使用します。

1. 管理者アカウントを使用して、Oracle BI EEインスタンス用のWLS管理コンソールを開きます。

2. 「ドメイン構造」ペインに移動して、「セキュリティ・レルム」を選択します。

「レルム」ペインが表示されます。

3. 「レルム」ペインで、<myrealm>を選択します。

「設定」ダイアログが表示されます。

4. 「設定」ダイアログで、「ユーザーとグループ」タブを開きます。

5. BIImpersonatorUserがユーザーのリストに表示されていることを確認します。

BIImpersonatorUserがリストに表示されていない場合は、引き続いて、「BIImpersonatorUserの作成方法」の説明に従って、BIImpersonatorUserを作成します。

6. 管理者アカウントでFusion Middleware Controlにログインします。

7. 「ナビゲーション」パネルからWeblogic Domainノードを開き、bifoundation_domainを選択します。

8. 「WebLogicドメイン」メニューから、「セキュリティ」→「アプリケーション・ポリシー」を選択します。

9. 「アプリケーション・ポリシー」ページの「検索」で、「アプリケーション・ストライプ」ドロップダウン・リストからobiを選択します。

10. 「プリンシパル・タイプ」ドロップダウン・リストから、Userを選択します。

11. 「名前」フィールドにBIImpersonatorUserを入力し、検索を開始します(図10-34)。

図10-34 「アプリケーション・ポリシー」ペイン - bifoundation_domain

12. 見つかったら、次の内容を確認します。

- リソース名: oracle.bi.server.impersonatorUser

- リソース・タイプ: oracle.bi.server.permission

- 権限アクション: _all_

- 権限クラス: oracle.security.jps.ResourcePermission

13. BIImpersonatorUserが見つからない場合は、引き続いて、「BIImpersonatorUserへの権限の付与方法」の説明に従って、BIImpersonatorUserに権限を追加します。

10.6.2.2 BIImpersonatorUserの作成方法

BIImpersonatorUserユーザーを作成して、Oracle BI EEプレゼンテーション・サービス接続を利用し、Oracle BI EEオブジェクトを含むアプリケーションを保護するには、次の手順を実行します。偽装者ユーザーの資格証明をOracle BI EEプレゼンテーション・サービス接続に適用するには、事前にアプリケーションでADFセキュリティが有効になっている必要があります。

偽装ユーザー機能は、Oracle BI EEとADFがOracle Internet Directory (OID)を共有していない場合に、Oracle BIオブジェクトが含まれたアプリケーションを保護します。偽装ユーザーの作成と使用のプロセスを開始する前に、この機能が現在の環境内で構成されていることを確認する必要があります。

この手順を実行する前に、自身または管理者がWebLogic ServerのOracle BI EEレルム内にユーザーを作成して、このレルム内の各ユーザーにBIConsumerグループを割当て済であることを確認してください。詳細は、『Oracle Business Intelligence Enterprise Edition開発者ガイド』の偽装ユーザーの作成と使用方法に関する項を参照してください。

次の手順に従って、BIImpersonatorUserユーザーを作成します。

1. 管理者アカウントを使用して、Oracle BI EEインスタンス用のWLS管理コンソールを開きます。

2. 「ドメイン構造」ペインに移動して、「セキュリティ・レルム」を選択します。

「レルム」ペインが表示されます。

3. 「レルム」ペインで、<myrealm>を選択します。

「設定」ダイアログが表示されます。

4. 「設定」ダイアログで、「ユーザーとグループ」タブを開きます。

5. 「ユーザー」タブが表示されていることを確認して、「新規」をクリックします。

6. ユーザー名としてBIImpersonatorUserと入力して、パスワードを入力します。

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

10.6.2.3 BIImpersonatorUserへの権限の付与方法

次の手順に従って、Fusion Middleware Controlを使用してBIImpersonatorUserに権限を付与します。

1. お使いのOracle BI EEインスタンス用のFusion Middleware Controlを開きます。

2. 「ナビゲーション」パネルからWeblogic Domainノードを開き、bifoundation_domainを選択します。

bifoundation_domainペインが表示されます。

3. bifoundation_domainペインで「WebLogicドメイン」メニューを開き、「セキュリティ」→「アプリケーション・ポリシー」を選択します。

「検索」ペインが表示されます。

4. 「アプリケーション・ポリシー」ページの「検索」で、「アプリケーション・ストライプ」ドロップダウン・リストからobiを選択します。

5. 「作成」をクリックします。

「アプリケーション権限の作成」ペインが表示されます(図10-35)。

図10-35 「アプリケーション権限の作成」ペイン

6. 「権限受領者」で、「追加」をクリックします。

「ユーザーの追加」ダイアログが表示されます。

7. 「タイプ」ドロップダウン・リストから、Userを選択します。

8. 「プリンシパル名」フィールドにoracle.bi.server.impersonatorUserを入力し、「OK」をクリックします。

9. 「権限」で、「追加」をクリックします。

「権限の追加」ダイアログが表示されます(図10-36)。

図10-36 「権限の追加」ダイアログ

10. 「権限」を選択し、「権限クラス」フィールドにoracle.security.jps.ResourcePermissionを入力します。

11. 「リソース名」フィールドにoracle.bi.server.impersonatorUserを入力し、検索を開始して「続行」をクリックします。

12. 検索で何も返されなかった場合は、「権限クラス」フィールドにoracle.security.jps.ResourcePermissionを入力し、「リソース名」フィールドにoracle.bi.server.impersonatorUserを入力します。

13. 「選択」をクリックします。

14. 「アプリケーション権限」ページで、「OK」をクリックします。

15. 加えた変更内容が表示されない場合は、次のサーバーを停止して再起動します。

- Oracle BI EEサーバー

- Oracle BI EEプレゼンテーション・サーバー

- WebLogic Server

10.6.3 WebCenter PortalへのOracle Business Intelligenceオブジェクトの統合方法

次の手順に従って、ポータルとBIオブジェクトの統合を構成します。

- デプロイ後のプレゼンテーション・サービス接続の追加または変更方法

- WebCenter Portalリソース・カタログへのOracle BIオブジェクトの追加方法

- 実行時のOracle BIコンテンツの追加方法

- ビジネス・インテリジェンス・オブジェクトのプロンプト値の変更方法

- ビジネス・インテリジェンス・タスク・フローの初期化パラメータの変更方法

10.6.3.1 デプロイ後のプレゼンテーション・サービス接続の追加または変更方法

BIオブジェクトをWebCenter Portalに統合することを開始する前に、まずWebCenter PortalからBIサーバーへの接続を構成する必要があります。Oracle BI EEで提供されているADF MBeanを使用すると、デプロイ済のポータルやBI ADFアプリケーションへの新しい接続を追加できます。デプロイ済アプリケーションの既存の接続を変更することもできます。MBeanは、アプリケーションとともにデプロイされて、デプロイ後にFusion Middleware Controlを使用してアクセスできます。

次の手順を実行する前に、「Oracle BIプレゼンテーション・カタログに接続するための資格証明の構成方法」の手順に従って、Oracle BIプレゼンテーション・カタログに接続するための資格証明をあらかじめ指定しておく必要があります。

注意:

ポータルとOracle Business Intelligenceアプリケーションの間で同じアイデンティティ・ストアが共有されていない場合は、該当するユーザーを両方のシステムで作成する必要があります。

次の手順に従って、アプリケーションのデプロイ後に接続を構成します。

1. Fusion Middleware Controlを開いて、次のいずれかの操作を実行して自身のWebLogicドメインを選択します。

- お使いのアプリケーションがBI ADFドメインにデプロイされている場合は、「アプリケーション・デプロイメント <お使いのドメイン>」ツリー・ノードを選択します。

- 使用するアプリケーションがWebCenter Portalドメインにデプロイされている場合は、「WebCenter」ツリー・ノード、「WebCenter Portal」ツリー・ノードおよびwebcenter(11.1.1.4.0) (WC_Portal)ツリー・ノードの順に選択します。この手順を実行するには、WC_Portalサーバーが実行されている必要がある点に注意してください。

2. リストから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」ペインが表示されます。

3. 「システムMBeanブラウザ」ペインで、次のパスをたどって「ADF接続」ツリー・ノードに移動します。

a. 「アプリケーション定義のMBean」ツリー・ノードを選択します。

b. 「oracle.adf.share.connections」ツリー・ノードを選択します。

c. 「サーバー: <サーバー名>」ツリー・ノードを選択します。
たとえば、Server:DefaultServerやServer:WC_Portalなどです。

d. 「アプリケーション:<アプリケーション名>」ツリー・ノードを選択します。
たとえば、Application:Application2やApplication:webcenterなどです。

e. ADF接続ツリー・ノードを開きます。

f. 子ADF接続ツリー・ノードを開きます。
対応するMBean情報が「アプリケーション定義のMBean」ペインに表示されます。

4. 「アプリケーション定義のMBean」ペインで、「操作」タブを開いてから、「createConnection」をクリックしてプレゼンテーション・サービス接続を作成します。
「操作:createConnection」ダイアログが表示されます。

5. この接続の必要な値を指定します。
接続タイプの「値」フィールドにBISoapConnectionと入力して、接続名の「値」フィールドに任意の名前を入力して、「起動」をクリックして接続を作成します。

6. 「システムMBeanブラウザ」ペインで、「リフレッシュ」をクリックしてツリーをリフレッシュして、新しい接続を表示します。

7. この接続を変更するには、「システムMBeanブラウザ」ペインでこの接続を探してクリックします。
この接続の情報が「アプリケーション定義のMBean」ペインに表示されます。

8. 「システムMBeanブラウザ」ペインから「ADF接続」に移動して、「属性」タブを開きます。

9. 次に示すようにBISoap接続情報を入力し、「適用」をクリックして変更を適用します。

- OBIEE URLからログイン・ページへの接続には、次の情報が必要です。

context =analytics
host =<host name>
port =7001 or the local value
protocol =HTTP

- BIImpersonatorUserからの接続には、次の情報が必要です。

username =BIImpersonatorUser
password =<password>

10. 「ナビゲーション」ペインのADFConnectionsフォルダで、「操作」タブを開き、「保存」をクリックして接続を保存します。

11. 「起動」をクリックすると、次のメッセージが表示されます。
"Confirmation Operation executed successfully."

10.6.3.2 WebCenter Portalリソース・カタログへのOracle BIオブジェクトの追加方法

Oracle BIコンテンツをポータル・ページに追加する前に、Oracle BIプレゼンテーション・カタログに格納されているオブジェクトをWebCenter Portalリソース・カタログに追加する必要があります。

1. 管理者またはアプリケーション・スペシャリストとしてWebCenter Portalにログインします。

2. ポータル・ブラウザで、「管理」タイルをクリックします。

3. 「共有アセット」をクリックし、「リソース・カタログ」をクリックします。

4. 「作成」をクリックします。

5. 「名前」フィールドに、作成するリソース・カタログの名前を入力します。必要に応じて他のフィールドに入力します。

6. 「使用可能」チェック・ボックスを選択してリソース・カタログを使用可能にします。

7. 新しいリソース・カタログを選択して「編集」をクリックします。

8. 「追加」メニューから「ライブラリから追加」を選択します。

9. 「接続」をダブルクリックします。

「BIプレゼンテーション・サービス」フォルダが表示されます。

10. このフォルダを開いてOracle BIオブジェクトを表示して、追加するオブジェクトを探して選択します。

11. 「追加」をクリックして、選択したオブジェクトをカタログに追加します。

実行時のリソース・カタログの管理の詳細は、『Oracle WebCenter Portalでのポータルの構築』のリソース・カタログの使用に関する項を参照してください。

10.6.3.3 実行時のOracle BIコンテンツの追加方法

次の手順に従って、ポータル・ページを作成して、このページにOracle BIオブジェクトを追加します。この手順を実行する前に、Oracle BIオブジェクトをWebCenter Portalリソース・カタログに追加しておく必要があります(「WebCenter Portalリソース・カタログへのOracle BIオブジェクトの追加方法」を参照)。

1. WebCenter Portalにログインし、新しいポータルを作成するか、既存のポータルにアクセスします。

2. Oracle BIオブジェクトが含まれているリソース・カタログをポータル・ページのデフォルト・リソース・カタログとして設定します。「デフォルト・リソース・カタログの選択」を参照してください

3. ポータル・エディタで、新しいページを作成します。

4. ページ・エディタで、「コンテンツの追加」をクリックしてリソース・カタログを開き、Oracle BIオブジェクトが含まれているフォルダを参照します。

5. 分析またはダッシュボードを選択して、「追加」をクリックします。
選択したオブジェクトが当該ページに追加されます。

10.6.3.4 ビジネス・インテリジェンス・オブジェクトのプロンプト値の変更方法

次の手順に従って、分析またはダッシュボードのフィルタやプロンプトの値を変更することで、ポータル・ページをテストします。

1. 作成したページを開きます。

2. 実行中のページで、「ページ・アクション」をクリックしてから、「編集」リンクをクリックして編集モードを開始します。

3. フィルタまたはプロンプトを含む分析またはダッシュボードを追加します。ページへのOracle BIオブジェクトの追加の詳細は、「実行時のOracle BIコンテンツの追加方法」を参照してください。

4. ページの編集モードを終了せずに、ポータル・ページを保存します。

5. ポータル・ページで、プロンプト値を変更して、「OK」をクリックします。

6. 編集モードを終了して、ページを保存して、アプリケーションによってプロンプト値が正しく適用されたことを確認します。

10.6.3.5 ビジネス・インテリジェンス・タスク・フローの初期化パラメータの変更方法

次の手順を使用して、ビジネス・インテリジェンス・タスク・フローの初期化パラメータをテストします。

1. 作成したページを開きます。

2. 実行中のページで、「ページ・アクション」をクリックしてから、「編集」リンクをクリックして編集モードを開始します。

3. タスク・フローの一部である分析またはダッシュボードを追加します。.jspxページへのビジネス・インテリジェンス・コンテンツの追加の詳細は、「実行時のOracle BIコンテンツの追加方法」を参照してください。

4. ページの編集モードを終了せずに、ポータル・ページを保存します。

5. ビジネス・インテリジェンス・オブジェクトを見つけ、「編集」(スパナ)アイコンをクリックします。

「コンポーネント・プロパティ」ダイアログが表示されます。

6. ポータル・ページで、「パラメータ」タブを開き、オブジェクトのパラメータを変更して、「OK」をクリックします。

7. 「パラメータ」タブを開き、オブジェクトのパラメータを変更して、「OK」をクリックします。

8. 編集モードを終了して、ページを保存して、アプリケーションによって変更後のパラメータ値が正しく適用されたことを確認します。

10.7 Oracle Document Cloud Serviceとの統合

この項では、Oracle WebCenter PortalでDocument Oracle Serviceを統合する方法について説明します。

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

- Oracle Document Cloud Serviceの統合について

- WSLTを使用したデフォルトのDocument Cloud Service接続の作成

10.7.1 Oracle Document Cloud Serviceの統合について

Oracle DOCSコンテンツ・マネージャ・タスク・フローにより、ユーザーはOracle WebCenter PortalをOracle Document Cloud Serviceに統合でき、Oracle Document Cloud Service内のドキュメントに迅速にアクセスできます。ドキュメントを追加、表示、管理および共有でき、Oracle WebCenter Portalからの強固なセキュリティでクラウド・サーバーでの共同作業を実行することができます。

Oracle DOCSコンテンツ・マネージャ・タスク・フロー:

- WebCenter PortalからOracle Document Cloud Serviceへの容易で安全なアクセスを提供します。

- 他の人との容易な共同作業が可能

Oracle Documents Cloud Serviceの詳細は、『Oracle Cloud Oracle Documents Cloud Serviceの使用』のOracle Documents Cloud Serviceでできることに関する項を参照してください。

WebCenter PortalとOracle Document Cloud Serviceの統合

1. WebCenterドメインをOracle Document Cloud Serviceに追加し、Oracle WebCenter Portal内のOracle Documentsから埋込みコンテンツの表示を可能にします。

注意:

Oracle Document Cloud Serviceに管理者としてログインします。ユーザー・メニューで、「管理」を選択してから、「管理」メニューで、「ドキュメント」を選択します。ドキュメント・ページで、「埋込みコンテンツ」オプションを有効にします。「許可されるドメイン」フィールドに、ポータル・ホストの名前およびポート番号を指定します。

たとえば、hostname:port

詳細は、『Oracle Cloud Oracle Documents Cloud Serviceの管理』のコンテンツの他のドメインへの埋込みに関する項を参照してください。

2. Oracle Document Cloud ServiceをOracle WebCenter Portalに登録します。詳細は、「WSLTを使用したデフォルトのDocument Cloud Service接続の作成」を参照してください。

3. Oracle DOCSコンテンツ・マネージャ・タスク・フローをOracle WebCenterポータル・ページに追加します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のページへのOracle DOCSコンテンツ・マネージャ・タスク・フローの追加に関する項を参照してください。

4. (オプション)Oracle Document Cloud Service接続をカスタマイズします。詳細は、『Oracle WebCenter Portalでのポータルの構築』のDocument Cloud Service URL接続のカスタマイズに関する項を参照してください。

注意:
Oracle Document Cloud Service接続をカスタマイズして、デフォルトのURL接続を別の接続に変更できます。

10.7.2 WSLTを使用したデフォルトのDocument Cloud Service接続の作成

WLSTを使用してOracle WebCenter PortalのデフォルトのDocument Cloud Service URL接続を作成します。WLSTコマンドはadf_createHttpURLConnectionです。

WLSTコマンドの構文を次に示します。

adf_createHttpURLConnection(appName=<application name>, name=<connection name>, url='http://<host>:<port>/Documents')

各要素の意味は次のとおりです。

- appNameは、webcenterなどのアプリケーション名です。

- nameはデフォルトのURL接続です。名前をWCP-DOCSに設定します。

- urlは使用しているWebCenter PortalのURLです。

WLSTの詳細は、『Oracle WebLogic Scripting Tool (WLST)』を参照してください。

adf_createHttpURLConnection(appName='webcenter', name='WCP-DCS', url='http://slc02htm.us.oracle.com:8890/Documents')

次のWLSTコマンドを使用して、作成した接続をリストでき、接続を削除することもできます

- 作成した接続をリストするには、次のWLSTコマンドを実行します。

adf_listURLConnection(appName=<application name>)

例:

adf_listURLConnection(appName='webcenter')

- 接続を削除するには次を使用します

deleteConnection(appName=<application name>, name='connection name')

例:

deleteConnection(appName='webcenter', name='WCP-DCS')

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

この章では、WebCenter Portalのインスタント・メッセージおよびプレゼンス(IMP)を構成および管理する方法について説明します。

WebCenter Portalのバックエンドのツールとサービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後にアプリケーションに加えた変更はすべて、MDSメタデータ・ストアにカスタマイズとして格納されます。「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用して行ったインスタント・メッセージおよびプレゼンスの構成変更は動的ではないため、変更を有効にするには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章の内容は次のとおりです。

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

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

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

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

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

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

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

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

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、WebCenter Portal管理を使用して付与されるAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

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

インスタント・メッセージおよびプレゼンス(IMP)を使用すると、認証された他のアプリケーション・ユーザーのプレゼンス・ステータス(オンライン、オフライン、ビジーまたは退席中)を確認して、インスタント・メッセージ(IM)やメールなどの対話オプションに簡単にアクセスできます。

バックエンド・プレゼンス・サーバーへの単一の接続が必要です。WebCenter PortalはMicrosoft Lync 2010に対して動作保証されています。

注意:

Oracle Beehive Server接続は、このリリースではサポートされていません。

アプリケーションのプレゼンス・サーバー接続は、Fusion Middleware ControlコンソールまたはWLSTを使用して登録できます。IMPを機能させるには、接続をアクティブとしてマークする必要があります。追加のプレゼンス・サーバー接続を登録できますが、一度にアクティブにできる接続は1つのみです。

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

この項では、Microsoft Lync 2010をインスタント・メッセージおよびプレゼンスのプレゼンス・サーバーとして使用するための前提条件を示します。

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

- Microsoft Lync: インストール

- Microsoft Lync: 構成

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

11.2.1 Microsoft Lync: インストール

インストールの詳細は、Microsoft Lync 2010のドキュメントを参照してください。

11.2.2 Microsoft Lync: 構成

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

- シンプル・デプロイ

- リモート・デプロイ

- Application Provisionerの構築

- LyncサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニング

- WBemTestを使用したAllowedDomainsの追加

- Topology BuilderまたはPowerShellコマンドレットを使用した信頼済サービス・エントリの移行

- IISサーバーの構成

- UCMA v2.0のインストール

- WebCenter PortalのProxyアプリケーションのインストール

Microsoft Lync 2010をIMPのプレゼンス・サーバーとして使用するには、Microsoft Lync 2010用のWebCenter PortalのProxyアプリケーションを、次のいずれかのトポロジでデプロイする必要があります。

- シンプル・デプロイ: すべてのコンポーネントが同じボックスに存在します。

- リモート・デプロイ: プロキシ・アプリケーションとMicrosoft Lyncが別々のボックスに存在します。

11.2.2.1 シンプル・デプロイ

このトポロジでは、Lyncボックス上にホストされているInternet Information Services (IIS)サーバーにWebCenter PortalのProxyアプリケーションをデプロイします。

1. Microsoft Unified Communications Managed API (UCMA) 2.0をLyncボックスにインストールします。

詳細は、「UCMA v2.0のインストール」を参照してください。

2. WebCenter PortalのProxyアプリケーションをIISサーバーにデプロイします。

このプロキシ・アプリケーションは、Lyncサーバーとのやり取り、および情報の送受信のためのWebサービスを提供します。WebCenter PortalはこれらのWebサービスと通信し、データを表示します。詳細は、「WebCenter PortalのProxyアプリケーションのインストール」を参照してください。

11.2.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

図11-1に、様々なデプロイ・エンティティで実行される手順(UCMA v2.0のインストールを含む)の概要を示します。

図11-1 Microsoft Lyncの構成: リモート・デプロイ

これらの手順の詳細は、次の項で説明します。

11.2.2.2.1 Application Provisionerの構築

この項では、Lyncにアクセスする他のIISサーバーをプロビジョニングするための、Microsoft社による手順を示します。

1. Visual Studio 2008を任意の開発者ボックスにインストールします(必ずしもIIS/Lyncである必要はありません)。

2. 「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ボックスにコピーします。

7. 次の「LyncサーバーでのWebCenter PortalのProxyアプリケーションのプロビジョニング」の手順を参照してください。

11.2.2.2.2 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に対して実行されるように移行されます。ドメインを追加するには、「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に移行します。

「Topology BuilderまたはPowerShellコマンドレットを使用した信頼済サービス・エントリの移行」を参照してください。

7. LyncサーバーでLync Certificateウィザードを使用して、前の手順で書き留めておいたサーバーFQDNをサブジェクト名として証明書を作成します。

この証明書は、IISサーバーからの要求の認可に使用されます。

8. 証明書が作成されたら、証明書を表示します。

9. 「詳細」タブで、「ファイルにコピー」をクリックします。

証明書のエクスポート・ウィザードが表示されます。

10. 秘密鍵を使用して、証明書をファイルにエクスポートします。

証明書の名前が付いた.pfx (Personal Information Exchange)ファイルが生成されます。

11. 次の「WBemTestを使用したAllowedDomainsの追加」の手順を参照してください。

11.2.2.2.3 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のインスタンス」ダイアログで、「オブジェクトの保存」をクリックします。

15. 次の「Topology BuilderまたはPowerShellコマンドレットを使用した信頼済サービス・エントリの移行」の手順に移動します。

11.2.2.2.4 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

「IISサーバーの構成」を参照してください。

11.2.2.2.5 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をインストールします。

詳細は、「UCMA v2.0のインストール」を参照してください。

5. UCMAをインストールしたら、このプロキシ・アプリケーションをIISサーバー上にデプロイします。

WebCenter PortalのProxyアプリケーションは、Lyncとのやり取り、および情報の送受信のためのWebサービスを提供します。WebCenter PortalはこれらのWebサービスと通信し、データを表示します。詳細は、「WebCenter PortalのProxyアプリケーションのインストール」を参照してください。

6. WebCenter PortalのProxyアプリケーションが抽出された場所に移動して、Web.configを開き、appSettings XMLノードを編集して、前の項(第12.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と対話できるようになりました。

11.2.2.2.6 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/en-us/download/details.aspx?id=9781

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アセンブリがインストールされます。

11.2.2.2.7 WebCenter PortalのProxyアプリケーションのインストール

1. owc_ocs2007.zipを抽出します。zipファイルはWebCenter Companion Adaptersにあり、OTNからダウンロードできます。WebCenter Portalのダウンロード・ページに移動し、前提条件および推奨のインストール・プロセス・セクションからWebCenter Companion Adaptersをダウンロードします。

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

11.2.3 Microsoft Lync: セキュリティに関する考慮事項

ユーザーが資格証明を提供してLyncサーバーに対して自分を認証できるように、Microsoft Lync接続用の外部アプリケーションを構成する必要があります。

保護されたアプリケーションでは、ユーザーがプレゼンス・ステータスを取得できます。Lyncでは、セキュリティが必要な場合、信頼できるプライベート・ネットワーク上にLyncが存在する必要があります。

Lyncには、外部資格情報を変更するためのオプションが用意されています。これは、外部アプリケーションを使用するかわりになります。ログインしたユーザーは、「プレゼンス」タグをクリックし、メニューから「資格情報の変更」を選択できます。

詳細は、「Fusion Middleware Controlを使用したインスタント・メッセージおよびプレゼンス・サーバーの登録」を参照してください。

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

WebCenter Portalには複数のプレゼンス・サーバー接続を登録できますが、同時にアクティブにできる接続はそのうち1つのみです。

新しい(アクティブな)プレゼンス・サーバーの使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

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

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

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

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

プレゼンス・サーバー接続を登録するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「インスタント・メッセージおよびプレゼンス」を選択します。

4. 新しいプレゼンス・サーバーに接続するには、「追加」をクリックします(図11-2)。

図11-2 インスタント・メッセージおよびプレゼンスの構成

5. この接続の一意の名前を入力し、プレゼンス・サーバー・タイプを指定して、この接続をアプリケーションのアクティブな(またはデフォルトの)接続にするかどうかを指定します(表11-1)。

表11-1 インスタント・メッセージおよびプレゼンス接続: 名前

フィールド

説明

接続名

接続の一意の名前を入力します。この名前は、WebCenter Portalのすべての接続タイプ間で一意である必要があります。

接続タイプ

プレゼンス・サーバーのタイプを指定します。

注意: Microsoft Lync接続は、Microsoft Office Communications Server 2010接続タイプを使用します。(Oracle Beehive Server接続は、このリリースではサポートされていません。)

アクティブな接続

これを選択すると、この接続がWebCenter Portalでインスタント・メッセージおよびプレゼンスに使用されます。

1つのアプリケーションに対して複数のプレゼンス・サーバー接続を登録できますが、IMPで使用される接続はデフォルトの(またはアクティブな)接続1つのみです。

6. インスタント・メッセージおよびプレゼンスをホストするサーバーの接続の詳細を入力します(表11-2)。

表11-2 インスタント・メッセージおよびプレゼンス接続: 接続の詳細

フィールド

説明

サーバーURL

インスタント・メッセージおよびプレゼンスをホストするサーバーのURLを入力します。

例: http://mylynchost.com:8888

ユーザー・ドメイン

この接続に関連付ける(Microsoft Office Communications Serverの) Active Directoryドメインの名前を入力します。Lync接続の場合はユーザー・ドメインが必須です。

ユーザー・ドメインの詳細は、Microsoft社のドキュメントを参照してください。

プール名

この接続に関連付けられているプールの名前を入力します。このプール名は必須です。

プール名の詳細は、Microsoft社のドキュメントを参照してください。

関連付けられている外部アプリケーション

インスタント・メッセージおよびプレゼンス・サーバーを外部アプリケーションと関連付けます。外部アプリケーションの資格証明情報が、ユーザーをインスタント・メッセージおよびプレゼンス・サーバーに対して認証するために使用されます。

外部アプリケーションは必須です。

リストから既存の外部アプリケーションを選択することも、「新規作成」をクリックして新規の外部アプリケーションを構成することもできます。

インスタント・メッセージおよびプレゼンス用に構成する外部アプリケーションでは、POST認証方式を使用する必要があります。また、Display to Userに構成(選択)されたAccountという追加のフィールド(名前プロパティ)も指定する必要があります。詳細は、「外部アプリケーションの管理」を参照してください。

7. 「拡張構成」フィールドにタイムアウトを入力します(表11-4)。

表11-3 インスタント・メッセージおよびプレゼンス接続: 拡張構成

フィールド

説明

接続タイムアウト(秒)

接続の適切なタイムアウトを指定します。

これは、WebCenter Portalが接続タイムアウト・メッセージを発行するまでにプレゼンス・サーバーからのレスポンスを待機する時間(秒)です。

デフォルトは-1です。これは、デフォルトが使用されることを示します。デフォルトは10秒です。

8. プレゼンス・サーバーに接続するためには追加のパラメータが必要になる場合があります。

プレゼンス・サーバーへの接続に追加のパラメータが必要な場合は、「追加プロパティ」を開き、必要な詳細を入力します(表11-4)。

表11-4 インスタント・メッセージおよびプレゼンス接続: 追加プロパティ

フィールド

説明

追加

「追加」をクリックして、追加の接続パラメータを指定します。

- プロパティ名: 接続プロパティの名前を入力します。

- プロパティ値: プロパティのデフォルト値を入力します。

- プロパティはセキュアか: 暗号化が必要かどうかを指定します。選択した場合、プロパティの値は、暗号化を使用してセキュアに格納されます。
たとえば、この値が実際のパスワードである場合、admin.passwordプロパティを保護するためにこのオプションを選択します。

削除

「削除」をクリックして、選択したプロパティを削除します。

「削除」をクリックする前に、正しい行を選択します。

注意: 「OK」をクリックするまで、削除された行は無効として表示されます。

9. 「OK」をクリックして、この接続を保存します。

10. 新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

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

WLSTコマンドのcreateIMPConnectionを使用して、プレゼンス・サーバーの接続を作成します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのcreateIMPConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

新規のIMP接続をアクティブに使用するようにインスタント・メッセージおよびプレゼンスを構成するには、default=trueを設定します。詳細は、「WLSTを使用したインスタント・メッセージおよびプレゼンス用のアクティブな接続の選択」を参照してください。

注意:

新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のコマンド行を使用した管理対象サーバーの起動および停止に関する項を参照してください。

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

WebCenter Portalには複数のインスタント・メッセージおよびプレゼンス・サーバー接続を登録できますが、一度にアクティブにできる接続は1つのみです。アクティブな接続がWebCenter Portalのバックエンド・プレゼンス・サーバーになります。

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

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

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

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

アクティブな接続を変更するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「インスタント・メッセージおよびプレゼンス」を選択します。

「インスタント・メッセージおよびプレゼンス接続の管理」表に、現在のアクティブな接続(ある場合)が示されます。

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」をクリックします。

5. 「アクティブな接続」チェック・ボックスを選択します。

6. 「OK」をクリックして、接続を更新します。

7. 新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

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

WLSTコマンドのsetIMPConnectionをdefault=trueで使用して、既存のプレゼンス・サーバー接続をアクティブ化します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetIMPConnectionに関する項を参照してください。

プレゼンス・サーバー接続を無効化するには、その接続を削除するか、別の接続を「アクティブな接続」にするか、removeIMPServicePropertyコマンドを使用します。

removeIMPServiceProperty('appName='webcenter', property='selected.connection')

このコマンドを使用すると、接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。詳細は、WebCenter WLSTコマンド・リファレンスのremoveIMPServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

このアクティブな接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のコマンド行を使用した管理対象サーバーの起動および停止に関する項を参照してください。

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

インスタント・メッセージおよびプレゼンス・サーバー接続の詳細はいつでも変更できます。

更新された(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

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

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

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

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

インスタント・メッセージおよびプレゼンス・サーバーの接続の詳細を更新する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「インスタント・メッセージおよびプレゼンス」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。

パラメータの詳細は、表11-2を参照してください。

6. 「OK」をクリックして、変更を保存します。

7. 更新された(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

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

WLSTコマンドのsetIMPConnectionを使用して、プレゼンス・サーバー接続の詳細を編集します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetIMPConnectionに関する項を参照してください。

プレゼンス・サーバーへの接続に追加のパラメータが必要な場合は、setIMPConnectionPropertyコマンドを使用します。詳細は、WebCenter WLSTコマンド・リファレンスのsetIMPConnectionPropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

更新された(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』の管理対象サーバーの起動および停止に関する項を参照してください。

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

インスタント・メッセージおよびプレゼンス接続はいつでも削除できますが、アクティブな接続を削除する際には注意が必要です。ユーザー・プレゼンス・オプションはバックエンド・インスタント・メッセージおよびプレゼンス・サーバーを必要とするため、アクティブな接続を削除すると、ユーザー・プレゼンス・オプションは使用できなくなります。

接続を削除するとき、インスタント・メッセージおよびプレゼンスに関連付けられている外部アプリケーションの目的がこの接続をサポートすることのみであれば、その外部アプリケーションを削除することを考慮してください。詳細は、「外部アプリケーション接続の削除」を参照してください。

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

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

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

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

インスタント・メッセージおよびプレゼンス・サーバー接続を削除するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「インスタント・メッセージおよびプレゼンス」を選択します。

4. 接続名を選択し、「削除」をクリックします。

5. この変更を行うには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

注意:

管理対象サーバーを再起動する前に、別の接続をアクティブとしてマークしてください。そうしないと、インスタント・メッセージおよびプレゼンスが無効になります。

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

WLSTコマンドのdeleteConnectionを使用して、プレゼンス・サーバーの接続を削除します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

11.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でこのデフォルトを変更できます。

コマンドの構文と詳細な例は、WebCenter WLSTコマンド・リファレンスのsetIMPServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

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

Oracle RTC Webサービスでは、呼び出して妥当性をテストできる一連のWebメソッドを公開しています。接続を検証するには、Webサービスのエンドポイントにアクセスしてみます。次の例は、アプリケーション・コンテキスト・パスを/RTCと仮定しています。

- protocol://host/RTC/ApplicationConfigurationService.asmx

- protocol://host/RTC/RTCService.asmx

- protocol://host/RTC/OCSWebService.asmx

12 メールの管理

この章では、WebCenter Portalのメールを構成および管理する方法について説明します。また、「メールの送信」機能の構成方法についても説明しますが、この機能を使用すると、アプリケーション・アセットはそれ自身から直接メールを送信できます。「メールの送信」機能には、メールは必要ありません。つまり、「メール」コンポーネントがWebCenter Portalで構成されていない場合でも、ユーザーはメール通知を送信できます。

WebCenter Portalのバックエンド・サーバーを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後に加えた変更はすべて、MDSメタデータ・ストアにカスタマイズとして格納されます。「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用して行ったメールの構成変更は動的ではないため、変更を有効にするには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章の内容は次のとおりです。

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

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

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

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

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

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

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

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

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

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

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、WebCenter Portal管理を使用して付与されるAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

メールに関する問題のトラブルシューティングは、「メールに関する問題のトラブルシューティング」を参照してください。

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

Oracle WebCenter Portalでは、Microsoft Exchange Serverや、IMAP4およびSMTPをサポートするすべてのメール・サーバーをサポートしています。ユーザーがWebCenter Portal内でメールにアクセスし、読取り、返信、転送といった基本的な操作を実行できるようにするには、まず、適切なメール・サーバーを登録する必要があります。メールは事前には構成されていません。

複数のメール・サーバー接続に登録できます。

WebCenter Portalでは、複数のメール接続がサポートされています。アクティブとしてマークされたメール接続が、WebCenter Portalでのメールのデフォルトの接続です。すべての追加の接続は代替として提供され、ユーザーは、使用する接続をユーザー・プリファレンスで選択できます。

12.2 メールの構成ロードマップ

この項では、ロードマップを構成プロセスにおける管理者のガイドとして使用します。

図12-1と図12-1に、WebCenter Portalでメールを動作させるための前提条件と必要な作業の概要を示します。

図12-1 メールの構成

表12-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. 次のいずれかの方法でメールにアクセスします

- メール・タスク・フローで「メールにログイン」をクリックし、メール・サーバーのログイン資格証明を入力します

- 「プリファレンス」→「メール」ページに移動してメール資格証明を指定します。

12.3 メール・サーバーの前提条件

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

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

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

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

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

12.3.1 メール・サーバー: インストール

インストールの詳細は、ご使用のメール・サーバーのドキュメントを参照してください。

12.3.2 メール・サーバー: 構成

WebCenter Portalでは、ポータル配信リストを作成および管理できます。この機能は、Microsoft Exchangeでのみサポートされます。

有効な場合、ポータル配信リストはポータルが作成されるたびに自動的に作成されます。LDAPベースDN (サポートされるLDAPベースDNは1つのみ)が変化せず、Microsoft Exchange Active Directory上に作成されたユーザーがWebCenter Portalで使用されるアイデンティティ・ストアに作成されたユーザーに対応している場合、ポータルに追加されたユーザーは対応するポータル配信リストに自動的に追加され、ポータルから削除されたユーザーは対応するポータル配信リストから自動的に削除されます。この機能を無効化するには、LDAP (Active Directory)サーバーの詳細をメール接続に入力しないでください。

詳細は、「Fusion Middleware Controlを使用したメール・サーバーの登録」の手順7を参照してください。

メール・サーバーでのユーザーの追加の詳細は、メール・サーバーの製品ドキュメントを参照してください。WebCenter Portalのアイデンティティ・ストアへのユーザーの追加の詳細は、「組込みLDAPアイデンティティ・ストアへのユーザーの追加」を参照してください。

Microsoft Exchange 2007、Microsoft Exchange 2010およびMicrosoft Exchange 2013は、構成の前提条件がある唯一のメール・サーバーです。他のメール・サーバーを使用している場合は、この項の以降の部分を省略してかまいません。

12.3.2.1 WebCenter PortalのためのMicrosoft Exchange Server 2007、2010または2013の構成

Microsoft Exchange Server 2007、2010または2013の証明書をWebCenter Portalキーストアに追加する必要があります。これには、次の手順が必要になります。

1. Microsoft Exchange Serverからの証明書の取得

2. WebCenter Portalキーストアへの証明書の追加

3. 証明書をインポートしたら、サーバーを再起動します。

12.3.2.1.1 Microsoft Exchange Serverからの証明書の取得

ご使用のメール・サーバーのインストール管理者から証明書を取得します。この項では、Microsoft Exchange Serverから証明書を取得する方法の1つを説明します。

Microsoft Exchange Server 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コマンド・リファレンス』を参照してください。

12.3.2.1.1.1 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

キーストアへの証明書の追加の詳細は、「証明書の構成とエクスポート」を参照してください。

2. サーバーを再起動します。

12.3.2.1.1.1.1 Microsoft Exchange Serverに関する考慮事項

- IMAPポートは993で、secured=trueです。SMTPポートは587で、secured=trueです。

- 次のエラーが表示される場合は、ドメイン起動ファイル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. 管理対象サーバーを再起動します。

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

詳細は、「SSLを使用したWebCenter PortalからIMAPおよびSMTPへの接続の保護」を参照してください。

注意:

LDAPがセキュア・モードで実行するように構成されている場合は、LDAP保護プロパティを追加(true/falseに設定)して、配信リストの作成時にLDAPを使用するようにしてください。詳細については、表12-4を参照してください。

12.3.4 メール・サーバー: 制限事項

WebCenter Portalでは、メールでWebCenter Portal配信リストの自動管理を可能にするために、Microsoft Exchangeメール・サーバー接続が必要です。

12.4 メール・サーバーの登録

複数のメール・サーバー接続に登録できます。新しいメール接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

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

- Fusion Middleware Controlを使用したメール・サーバーの登録

- WLSTを使用したメール・サーバーの登録

12.4.1 Fusion Middleware Controlを使用したメール・サーバーの登録

メール・サーバーをWebCenter Portalに登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。

詳細は、「WebCenter Portalのホームページへの移動」を参照してください

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「メール・サーバー」を選択します。

4. 新規のメール・サーバーに接続するには、「追加」をクリックします(図12-2)。

図12-2 メール・サーバーの構成

5. この接続の一意の名前を入力し、この接続をアプリケーションのアクティブな(またはデフォルトの)接続にするかどうかを指定します(表12-2)。

表12-2 メール・サーバー接続: 名前

フィールド

説明

接続名

接続の一意の名前を入力します。この名前は、WebCenter Portalのすべての接続タイプ間で一意である必要があります。

アクティブな接続

この接続をメールのデフォルトの(またはアクティブな)接続にするかどうかを指定します。

複数のメール・サーバー接続を登録できます。

WebCenter Portalでは、複数のメール接続がサポートされています。アクティブとしてマークされたメール接続が、メールのデフォルトの接続です。すべての追加の接続は代替として提供され、ユーザーは、使用する接続をユーザー・プリファレンスで選択できます。

6. メール・サーバーの接続の詳細を入力します(表12-3)。

表12-3 メール・サーバー接続の詳細

フィールド

説明

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の両方に対するユーザーの認証に同じ資格証明を使用します。

リストから既存の外部アプリケーションを選択することも、「新規作成」をクリックして新規の外部アプリケーションを構成することもできます。詳細は、「外部アプリケーションの管理」を参照してください。

メールの外部アプリケーションでは、Authentication Method=POSTを使用する必要があります。また、一部のメール・ヘッダー・フィールドをカスタマイズできます(「ユーザーに表示」が有効の場合)。

- プロパティ: mail.user.emailAddress (メールの送信者)
プロパティ: mail.user.displayName (メールの表示名)

プロパティ: mail.user.replyToAddress (メールの返信先アドレス)

これらのプロパティは、特定のメール・アドレスが外部アプリケーションとメール・サーバーで同じであることを保証します。これらのプロパティはメール接続に追加され、メールで「送信元」、「表示名」および「返信先」の各フィールドに使用されます(図12-3)。追加プロパティの構成については、表12-7を参照してください。

アプリケーションで、要求時にユーザーID情報をメール送信する機能を備えた自己登録ページを用意している場合、ここで選択した外部アプリケーションに対してパブリック資格証明が構成されていることを確認してください。パブリック資格証明が定義されていない場合、要求時にユーザーにメールが送信されません。たとえば、WebCenter Portalでは、デフォルトの自己登録ページでこの機能を提供しています。

7. WebCenter Portal配信リストを管理するActive DirectoryサーバーのLDAP接続の詳細を指定します(表12-4)。

WebCenter Portalは、配信リストをActive Directoryサーバーで管理するMicrosoft Exchangeをサポートしています。

注意:

配信リストをWebCenter Portalで動作させるには、Active Directoryサーバーの詳細をメール接続の一部として指定する必要があります。

表12-4 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. メール・サーバー接続の拡張オプションを構成します(表12-5)。

表12-5 メール・サーバー接続: 拡張構成

フィールド

説明

接続タイムアウト(秒)

接続の適切なタイムアウトを指定します。

これは、WebCenter Portalが接続タイムアウト・メッセージを発行するまでにメール・サーバーからのレスポンスを待機する時間(秒)です。

デフォルトは-1で、これはデフォルトが使用されることを意味します。デフォルトは10秒です。

9. オプションとして、メール・サーバー接続にパラメータを追加できます(表12-6)。

表12-6 メールに接続する追加のプロパティ

追加の接続プロパティ

説明

charset

接続のために使用される文字セットを示します。

デフォルトのcharsetは、UTF-8です。ISO-8859-1などの他のキャラクタセットを使用する場合は、charset接続プロパティを設定します。

各種のIMAPプロパティ

任意の有効なIMAP接続プロパティ。例: mail.imap.connectionpoolsize。

有効なプロトコル・プロパティのリストは、メール・サーバーのドキュメントを参照してください。標準IMAPプロパティのリストは、Java Mail APIを参照してください。

https://javamail.java.net/nonav/docs/api/com/sun/mail/imap/package-summary.html

各種のSMTPプロパティ

任意の有効なSMTP接続プロパティ。例: mail.smtp.timeout。

有効なプロトコル・プロパティのリストは、メール・サーバーのドキュメントを参照してください。標準SMTPプロパティのリストは、Java Mail APIを参照してください。

https://javamail.java.net/nonav/docs/api/com/sun/mail/smtp/package-summary.html

メール・サーバーへの接続に追加のパラメータが必要な場合は、「追加プロパティ」を開き、必要な詳細を入力します(表12-7を参照)。

表12-7 メール接続: 追加プロパティ

フィールド

説明

追加

「追加」をクリックして、追加の接続パラメータを指定します。

- プロパティ名: 接続プロパティの名前を入力します。

- プロパティ値: プロパティのデフォルト値を入力します。

- プロパティはセキュアか: 暗号化が必要かどうかを指定します。選択した場合、プロパティの値は、暗号化を使用してセキュアに格納されます。
たとえば、この値が実際のパスワードである場合、admin.passwordプロパティを保護するためにこのオプションを選択します。

削除

「削除」をクリックして、選択したプロパティを削除します。

「削除」をクリックする前に、正しい行を選択します。

注意: 「OK」をクリックするまで、削除された行は無効として表示されます。

図12-3 メール接続の追加プロパティ

10. 「OK」をクリックして、この接続を保存します。

11. 新しい(アクティブな)接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

12.4.2 WLSTを使用したメール・サーバーの登録

WLSTコマンドのcreateMailConnectionを使用して、メール・サーバーの接続を作成します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスの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では、デフォルトの自己登録ページでこの機能を提供しています。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetMailConnectionPropertyに関する項を参照してください。

新規のメール・サーバー接続をデフォルトの接続として使用するようにメールを構成するには、default=trueを設定します。詳細は、「WLSTを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択」を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しいメール接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のコマンド行を使用した管理対象サーバーの起動および停止に関する項を参照してください。

12.5 アクティブな(またはデフォルトの)メール・サーバー接続の選択

WebCenter Portalには複数のメール・サーバー接続を登録できますが、デフォルトの接続として指定できる接続は1つのみです。デフォルトの接続は、次の項目のバックエンド・メール・サーバーとなります。

- メール・タスク・フロー

- WebCenter Portal配信リスト

- 「メールの送信」アイコンがあるすべての場所

この項では、次の内容について説明します。

- Fusion Middleware Controlを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択

- WLSTを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択

12.5.1 Fusion Middleware Controlを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択

デフォルトの接続を変更するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。

詳細は、「WebCenter Portalのホームページへの移動」を参照してください

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「メール・サーバー」を選択します。

「メール・サーバー接続の管理」表に、現在のアクティブな接続(ある場合)が示されます(図12-4)。

図12-4 メール・サーバー: アクティブな接続

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」をクリックします。

5. 「アクティブな接続」チェック・ボックスを選択します。

6. 「OK」をクリックして、接続を更新します。

7. 新しいデフォルト接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

12.5.2 WLSTを使用したアクティブな(またはデフォルトの)メール・サーバー接続の選択

WLSTコマンドのsetMailConnectionをdefault=trueで使用して、既存のメール・サーバー接続をメール用のデフォルトの接続にします。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetMailConnectionに関する項を参照してください。

デフォルト引数をtrueからfalseに変更しても、その接続がメール用のデフォルトの接続でなくなることはありません。

メール・サーバー接続を無効にするには、その接続を削除するか、別の接続を「アクティブな接続」にするか、またはremoveMailServicePropertyコマンドを使用します。

removeMailServiceProperty(appName='webcenter', property='selected.connection')

このコマンドを使用すると、接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。詳細は、WebCenter WLSTコマンド・リファレンスのremoveMailServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

アクティブな接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のコマンド行を使用した管理対象サーバーの起動および停止に関する項を参照してください。

12.6 メール・サーバー接続の詳細の変更

メール・サーバー接続の詳細はいつでも変更できます。

更新されたメール接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。

この項では、次の内容について説明します。

- Fusion Middleware Controlを使用したメール・サーバー接続の詳細の変更

- WLSTを使用したメール・サーバー接続の詳細の変更

12.6.1 Fusion Middleware Controlを使用したメール・サーバー接続の詳細の変更

メール・サーバー接続の詳細を更新する手順は、次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。

詳細は、「WebCenter Portalのホームページへの移動」を参照してください

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「メール・サーバー」を選択します

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。

パラメータの詳細は、表12-3を参照してください。

6. 「OK」をクリックして、変更を保存します。

7. 更新された接続の詳細の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

12.6.2 WLSTを使用したメール・サーバー接続の詳細の変更

WLSTコマンドのsetMailConnectionを使用して、既存のメール・サーバー接続の詳細を編集します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetMailConnectionに関する項を参照してください。

メール・サーバーとの接続に追加のパラメータが必要な場合は、setMailConnectionPropertyコマンドを使用します。詳細は、WebCenter WLSTコマンド・リファレンスのsetMailConnectionPropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

更新された接続の使用を開始するには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』の管理対象サーバーの起動および停止に関する項を参照してください。

12.7 メール・サーバー接続の削除

メール・サーバー接続はいつでも削除できますが、アクティブな(またはデフォルトの)接続を削除する際には注意が必要です。メール・タスク・フローはバックエンド・メール・サーバーを必要とするため、アクティブな接続を削除すると機能しなくなります。

接続を削除するとき、メール・サーバー接続に関連付けられている外部アプリケーションの目的がこの接続をサポートすることのみであれば、その外部アプリケーションを削除することを考慮してください。詳細は、「外部アプリケーション接続の削除」を参照してください。

この項では、次の内容について説明します。

- Fusion Middleware Controlを使用したメール接続の削除

- WLSTを使用したメール接続の削除

12.7.1 Fusion Middleware Controlを使用したメール接続の削除

メール・サーバー接続を削除するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。

詳細は、「WebCenter Portalのホームページへの移動」を参照してください

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「メール・サーバー」を選択します。

4. 接続名を選択し、「削除」をクリックします。

5. この変更を行うには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

注意:

管理対象サーバーを再起動する前に、別の接続をアクティブとしてマークしてください。そうしないとメールが無効になります。

12.7.2 WLSTを使用したメール接続の削除

WLSTコマンドのdeleteConnectionを使用して、メール・サーバーの接続を削除します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

12.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に制限されます。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetMailServicePropertyに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

12.9 メール・サーバー接続のテスト

Thunderbird、Outlookなどの任意のクライアントを使用してメール・サーバーに接続することによって、メール・サーバーが稼働していることを確認します。

Microsoft Exchangeの場合、「Administrative Tools」→「Services」に移動して、次のコンポーネントが実行中(「Status」が「Started」)であることを確認します。

- Microsoft Exchange IMAP4

- 簡易メール転送プロトコル(SMTP)

12.10 WebCenter Portalのメール通知の送信の構成

システム管理者は、WebCenter Portalの管理設定を使用したメール・オプションの設定を担当します(図12-5)。「メールの送信」通知の使用の詳細は、『Oracle WebCenter Portalの使用』の「メールの送信」機能に関する項を参照してください。

図12-5 メール・オプションの設定

このページから、メール送信機能のメール・クライアントを割り当てることができます。この機能により、アプリケーション・アセットは、メール送信アイコンを使用して、タスク・フローから直接メールを送信できます(図12-6)。

図12-6 メール送信アイコン

たとえば、ユーザーはお知らせのメール送信アイコンをクリックして、お知らせテキスト、作成者、作成日および場所などの情報があらかじめ入力されたメール・ウィンドウを開くことができます。これらは必要に応じて、編集したりメールに追加したりできます。メール・ウィンドウの事前入力方法は、送信側のリソースによって異なります。たとえば、お知らせからでは、お知らせのタイトルがあらかじめ入力された状態で、メール送信のメール・ウィンドウが開きます。

ポータル内では、ポータルのすべてのメンバーにメールを送信できます。これが、ポータル作成時のデフォルトの配信リストになります。ポータル・マネージャ(および、ポータルでManage Security and Configuration権限を付与されたすべてのユーザー)が、ポータルの管理者設定の「ツールとサービス」ページでこれを設定します。『Oracle WebCenter Portalでのポータルの構築』のポータルのメール配信リストの構成に関する項を参照してください。

WebCenter Portalのすべてのメール送信通知において、Microsoft Outlook、Mozilla Thunderbirdなどのローカル・メール・クライアント、またはWebCenter Portal独自のメール・サービスを使用できます。ローカル・メール・クライアントがデフォルトです。メール送信機能には、メール・サービスは必要ありません。つまり、メール・サービスが未構成の場合でも、WebCenter Portalのメール・サービスでメール送信機能を使用できます。アプリケーション・スペシャリストまたはポータル・マネージャは、ポータル・メンバーがデフォルトのメール・クライアント設定をオーバーライドできるかどうかを指定できます。

注意:

一部のブラウザでは、英語以外の多数の言語について、「メールの送信」の通知が文字化けします。マルチバイト・キャラクタがエンコードされている場合(mailto:プロトコルの場合は必須)、URLの長さがブラウザの制限を超過します。回避策として、ローカル・メール・クライアントではなくWebCenter Portalのメール・サービスを使用するように、「メールの送信」機能を構成してください。

システム管理者として、ユーザーがデフォルトのメール・クライアント設定をオーバーライドできるかどうかを指定することもできます。

関連項目:

メール・サーバーの登録

12.10.1 メール通知の送信の共有メール接続の有効化

メール・サーバー接続に関連付けられた外部アプリケーションに対して、共有資格証明が構成されている場合、ユーザーはWebCenter Portalのメール・サービスを使用してメールを送信するときに資格証明を指定する必要がなくなります。

共有メール接続を有効にするには:

1. ポータルがメールの送信にWebCenter Portalのメール・サービスを使用していることを確認します。

a. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「ツールとサービス」をクリックします。

b. 「メール」を選択します。

c. 「メールの送信のデフォルト・メール・クライアント」が「WebCenter Portalのメール・サービス」に設定されていることを確認します。

「WebCenter Portalのメール通知の送信の構成」も参照してください。

2. 共有資格証明で構成された外部アプリケーションを使用するメール接続を設定し、このメール接続の名前を記録します。

3. 共有メール資格証明が必要になるポータルを開き、共有メール接続の名前を指定します。
詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルの共有メール接続の構成に関する項を参照してください。

13 ピープル・コネクションの管理

この章では、ピープル・コネクション・サービスに必要なバックエンド構成の要件について説明します。

この章の内容は次のとおりです。

- ピープル・コネクション・サービスについて

- ピープル・コネクションの前提条件

- WebCenter Portalのピープル・コネクションの構成

- アクティビティ・ストリーム・スキーマのアーカイブ

- 組織ビューの管理チェーンの指定

- プロファイルの構成プロパティの設定

- プロファイルとアイデンティティ・ストアの同期

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、WebCenter Portal管理を使用して付与されるAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

13.1 ピープル・コネクション・サービスについて

ピープル・コネクション・サービスは、ユーザーのコネクションのアクティビティを作成、連携および追跡するためのソーシャル・ネットワーキング・ツールです。このサービスの各機能により、ユーザーは自分の個人プロファイルの管理、他のユーザーのプロファイルへのアクセス、非定型のフィードバックの提供、メッセージの投稿、アクティビティの追跡ができるほか、他のユーザーとつながることができます。

ピープル・コネクションの機能は次のとおりです。

- アクティビティ・ストリーム: アプリケーションまたはソーシャル・ネットワーキング・アクションによって生成されたユーザー・アクティビティを表示します。

- コネクション: 他のアプリケーション・ユーザーとつながって、情報の共有、パフォーマンスに対するコメント、メッセージの交換およびアクティビティの追跡ができます。

- フィードバック: 他のユーザーに非定型なパフォーマンス・フィードバックを送ります

- メッセージ・ボード: 他のユーザーにメッセージを投稿できます。

- プロファイル: 自分に関する情報を入力したり、他のユーザーの情報を表示することができます

- パブリッシャ: ステータス・メッセージの公開やファイルおよびリンクの投稿ができます。

ピープル・コネクション・サービスによって、その機能を使用するためのタスク・フローが提供されます。

関連項目:

ポータルにピープル・コネクション機能を追加する方法の詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルへの接続の追加に関する項を参照してください。

WebCenter Portalのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後にWebCenter Portalに加えた変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用して行った、WebCenter Portalツールおよびサービス構成のほとんどの変更は、動的ではありません。変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

ピープル・コネクションの構成の詳細は、「WebCenter Portalのピープル・コネクションの構成」を参照してください。

13.2 ピープル・コネクションの前提条件

ピープル・コネクション・サービスを使用するには、WEBCENTERスキーマがデータベースにインストールされている必要があります。

本番環境では、企業は、可能性のあるコネクションの移入をピープル・コネクションに提供する手段としてそのバックエンド・アイデンティティ・ストアを利用できます。開発環境では、開発者がテスト・ユーザーをjazn-data.xmlファイルに追加できます。

たとえば、プロファイルは、WebCenter Portalにそのユーザーを提供しているバックエンド・アイデンティティ・ストアからその情報をまとめて取得します。また、プロファイルでは、この情報の一部を変更したり、アイデンティティ・ストアに格納されていない追加データを提供することも可能です。

本番バージョンのアプリケーションのバックエンド(LDAP)アイデンティティ・ストアへの接続の詳細は、「アイデンティティ・ストアの構成」を参照してください。

13.3 WebCenter Portalのピープル・コネクションの構成

この項では、ピープル・コネクション機能に対するアプリケーション全体の値を設定する手順について説明します。次のサブセクションが含まれます:

- ピープル・コネクションの管理設定へのアクセス

- アクティビティ・ストリームの構成

- コネクションの構成

- プロファイルの構成

- メッセージ・ボードの構成

- フィードバックの構成

13.3.1 ピープル・コネクションの管理設定へのアクセス

ピープル・コネクションの管理設定にアクセスするには:

1. WebCenter Portal管理を開きます。

詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ピープル・コネクション」を選択します。

または、次のURLを使用して、「ピープル・コネクション」を選択します。

http://host:port/webcenter/portal/admin/tools

ピープル・コネクションの機能名を示すタブが右側に表示されます。

13.3.2 アクティビティ・ストリームの構成

アクティビティ・ストリームは、ユーザーのアプリケーション・アクティビティの公開および追跡を目的としたものです。アクティビティ・ストリームの構成設定では、ストリーミングの対象となるユーザーおよびアクティビティ、ユーザーのストリーミング・アクティビティの表示を許可されるユーザー、ストリーミング・アクティビティごとにLIKE登録とコメントの機能を有効にするかどうかを指定します(図13-1)。

図13-1 ピープル・コネクションの管理設定

どのユーザーにユーザーのアクティビティを表示して、どのタイプのアクティビティを追跡するかは、アクティビティ・ストリームの構成で決定します。表13-1に、アクティビティ・ストリームで追跡できるアクティビティのタイプを示します。

表13-1 アクティビティ・ストリームで追跡されるアクティビティ

機能領域

追跡されるアクティビティ

スコープ

アクティビティの共有または非公開

お知らせ

- お知らせの作成

- お知らせの編集

ポータル

他のポータル・メンバーと共有

コネクション

- コネクションへの招待

- コネクションへの参加

ホーム・ポータル

招待者および被招待者のコネクションと共有されます。

ディスカッション

- フォーラムの作成

- トピックの作成

- トピックへの返信

ポータル

他のポータル・メンバーと共有

ドキュメント

- パブリッシャからのドキュメントのアップロード

- ポータル

- ホーム・ポータル

- アクティビティ・ストリームからのドキュメントのアップロードのみが追跡されます。

イベント

- イベントの作成

- イベントの編集

ポータル

他のポータル・メンバーと共有

フィードバック

- フィードバックの投稿

- フィードバックの受信

ホーム・ポータル

該当するアクティビティの表示を許可されたユーザーとの共有。(詳細は、『Oracle WebCenter Portalの使用』のフィードバック・プリファレンスの設定に関する項を参照)

リスト

- リストの作成

- リストへの行の追加

- リスト行の編集

ポータル

他のポータル・メンバーと共有

メッセージ・ボード

- メッセージの投稿

- メッセージの受信

ホーム・ポータル

該当するアクティビティの表示を許可されたユーザーとの共有。(詳細は、『Oracle WebCenter Portalの使用』のメッセージ・プリファレンスの設定に関する項を参照してください。)

ページ

- ページの作成

- ページの編集

- タグの追加

- タグの削除

- ポータル

- ホーム・ポータル

- ポータルのページに対するアクティビティは、他のポータル・メンバーと共有されます。

- ホーム・ポータルのページに対するアクティビティはユーザーに非公開になります。

プロファイル

- 写真の更新

- プロファイルの更新

- 個人ステータス・ノートの更新

ホーム・ポータル

該当するアクティビティの表示を許可されたユーザーとの共有。(詳細は、『Oracle WebCenter Portalの使用』のプロファイル・プリファレンスの設定に関する項を参照してください。)

WebCenter Portal管理

- ポータルの作成

- ポータルへの参加

ポータル

他のポータル・メンバーと共有

タグ付け

- タグの追加

- タグの削除

- ポータル

- ホーム・ポータル

- ポータル内のアクティビティは、すべてのポータル・メンバーと共有されます。

- ホーム・ポータル内でのアクティビティは、該当するアクティビティの表示を許可されたすべてのユーザーと共有されます。(詳細は、「アクティビティ・ストリームの構成」および『Oracle WebCenter Portalの使用』のアクティビティ・ストリーム・プリファレンスの設定に関する項を参照してください。)

アクティビティ・ストリームを構成して、次のカテゴリからアクションを表示または非表示にします。

- 人 - どのユーザーのアクティビティを表示するかを決定する場合(現在のユーザーまたは現在のユーザーとユーザーのコネクションの両方)。

- WebCenter Portal - 使用可能なすべてのポータルのアクティビティを表示するか、またはホーム・ポータルのみのアクティビティを表示するかを決定する場合。

- サービス・カテゴリ - アクティビティを報告するサービスを選択して、それらのデフォルトの選択内容をユーザーが個人プリファレンスでオーバーライドできるようにする場合、またはオーバーライドを禁止する場合。

- プライバシ - 現在のユーザーのアクティビティを表示できるユーザーを選択する場合。

- コメントとLIKE登録 - 投稿されたアクティビティにユーザーがコメントできるようにする場合、および投稿されたアクティビティをLIKE登録できるようにする場合

すべてのユーザーに対するアクティビティ・ストリームを構成するには:

1. WebCenter Portal管理を開きます。

詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ピープル・コネクション」を選択します。

または、次のURLを使用して、「ピープル・コネクション」を選択します。

http://host:port/webcenter/portal/admin/tools

ピープル・コネクションの機能名を示すタブが右側に表示されます。

3. 「アクティビティ・ストリーム」タブをクリックして、そのタブを手前に表示します。

4. 「人」の下で、どのユーザーのアクティビティを表示するかを選択します。

- 自分のみ - 現在のユーザーのアクティビティのみを、そのユーザーのアクティビティ・ストリームのビューに表示します。

- 自分とマイ・コネクション - 現在のユーザーのアクティビティと、そのユーザーのコネクションのアクティビティを、そのユーザーのアクティビティ・ストリームのビューに表示します。

- 個人用以外 - 現在のユーザーのアクティビティ・ストリームのビューから、ホーム・ポータルからストリーミングされるアクティビティをすべて省略します。

5. 「ポータル」の下で、次の項目からアクティビティを表示するものを選択します。

- すべてのポータル - ユーザーがアクセスできるすべてのポータル

- マイ・ポータル - ユーザーが管理するすべてのポータル

- ポータルなし - ホーム・ポータルのみ

6. 「サービス・カテゴリ」の下で、アクティビティを公開するサービスを選択します。

注意:

サービスのアクティビティは、選択されていないものも追跡されますが、アクティビティ・ストリームには表示されません。このアクティビティを後から表示するように選択すると、選択されていなかったときに発生したすべてのアクティビティが表示されます。

表13-1に、アクティビティ・ストリームで追跡されるアクティビティを示します。

7. 必要に応じて、「所有者オーバーライドの許可」を選択して、ユーザーが個人プリファレンスから特定のサービスの設定をオーバーライドできるようにします。

このチェック・ボックスの選択を解除すると、ユーザーは、ここで設定したアプリケーション・デフォルトをオーバーライドできなくなります。

8. 「プライバシ」の下で、現在のユーザーのアクティビティを表示できるユーザーを指定した後、それらのユーザーがこの設定を個人プリファレンスでオーバーライドできるかどうかを指定します。

表13-2に、各オプションのリストと説明を示します。

表13-2 アクティビティ・ストリームの「プライバシ」のオプション

オプション

説明

すべてのアクティビティを表示できるユーザー

他のユーザーのアクティビティを表示できるユーザーを指定します。次のうちから選択します。

- 全員 - すべてのユーザー(ログインしていないユーザーも含む)が、他のユーザーのアクティビティを表示できます。

- 認証済ユーザー - ログインしているユーザーが、他のユーザーのアクティビティを表示できます。

- マイ・コネクション - ユーザーBがユーザーAをコネクションとして承諾している場合、ユーザーAはユーザーBのアクティビティを表示できます。ユーザーAは、ユーザーAのアクティビティも表示できます。

- 自分 - ユーザーAのみがユーザーAのアクティビティを表示できます。

所有者オーバーライドの許可

ユーザーが自分の「ピープル・コネクション」の「プリファレンス」からアプリケーションのデフォルト設定をオーバーライドできるようにします(詳細は、『Oracle WebCenter Portalの使用』のアクティビティ・ストリームのプリファレンスの設定に関する項を参照してください)。

9. 「コメントとLIKE登録」ノードを開いて、LIKE登録とコメントの書込みを許可するかどうかを指定します。

- 「アクティビティ・ストリームのオブジェクトに対するコメントを有効にします」を選択すると、ユーザーは指定した「アクティビティ・ストリーム」アイテムにコメントできるようになります。このチェック・ボックスの選択を解除すると、ユーザーはコメントできなくなります。

- 「アクティビティ・ストリームのオブジェクトを他のユーザーがLIKE登録できるようにします」を選択すると、ユーザーはアクティビティ・ストリームのアイテムをLIKE登録できるようになります。このチェック・ボックスの選択を解除すると、ユーザーはLIKE登録できなくなります。

ヒント:

ユーザーは、オブジェクトを含むストリーミング・アイテムに対してお気に入り登録とコメントの書込みができます。たとえば、ユーザーは「Jackがメッセージを投稿しました」をLIKE登録したりコメントを投稿できます。ユーザーは、「JackとJillには現在コネクションがあります」などのシステム・メッセージをLIKE登録したりコメント投稿することはできません。

詳細は、『Oracle WebCenter Portalの使用』のWebCenter Portal内のアイテムのLIKE登録、コメントおよび共有に関する項を参照してください。

10. 「適用」をクリックして、構成設定を保存します。

13.3.3 コネクションの構成

コネクションの構成では、別のユーザーのコネクションを表示できるユーザーを選択した後、それらのユーザーがコネクションへの参加の招待を自動的に承諾するかどうかを指定します(図13-2)。

図13-2 コネクションの構成設定

コネクションを構成する手順は次のとおりです。

1. WebCenter Portal管理を開きます。

詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください

2. 「ツールとサービス」をクリックして、「ピープル・コネクション」を選択します。

または、次のURLを使用して、「ピープル・コネクション」を選択します。

http://host:port/webcenter/portal/admin/tools

ピープル・コネクションの機能名を示すタブが右側に表示されます。

3. 「コネクション」タブをクリックして、このタブを手前に表示します。

表13-3に、各オプションのリストと説明を示します。

表13-3 コネクションの構成オプション

オプション

説明

表示アクセス権の付与先

ユーザーのコネクションへの表示アクセス権を自動的に付与するユーザーのクラス

選択したユーザーは、別のユーザーのコネクションの表示と対話が可能になります。次のうちから選択します。

- 全員 - すべてのユーザー(ログインしていないユーザーを含む)が、他のユーザーのコネクションを表示できます。

- 認証済ユーザー - ログインしているユーザーのみが、他のユーザーのコネクションを表示できます。

- ユーザーのコネクション - ユーザーとユーザーのコネクションのみが、ユーザーのコネクションを表示できます。

- ユーザーのみ - 自分のコネクションのみ表示できます。

所有者オーバーライドの許可

管理者による表示アクセス設定を、ユーザーがオーバーライドすることを許可または禁止するオプション。

- 選択すると、ここで指定した管理表示アクセス設定をユーザーが各自の個人プリファレンスでオーバーライドできるようになります(詳細は、『Oracle WebCenter Portalの使用』のコネクション・プリファレンスの設定に関する項を参照してください)。

- 選択解除すると、ユーザーは管理表示アクセス設定をオーバーライドできなくなります。

招待の自動承認

- 選択すると、デフォルトでは、コネクションへの参加の招待がすべて自動的に承諾されます。

- 選択解除すると、デフォルトでは、コネクションへの参加の招待にユーザーが明示的に承諾または拒否する必要があります。

4. 「適用」をクリックして、構成設定を保存します。

13.3.4 プロファイルの構成

認証されたすべてのユーザーには、個人情報(電子メール・アドレス、電話番号、勤務場所、部門、上司、直属の部下など)を表示するプロファイルがあります。すべての属性は、WebCenter Portal用に構成されたLDAPアイデンティティ・ストアに格納され、このストアから読み取られます。ただし、3つの属性を除きます。この3つの例外は、プロファイルの写真と専門分野、およびパブリッシャのステータス・メッセージです。

プロファイルの管理構成設定を使用して、ユーザーに各自のアプリケーション・パスワードの変更を許可するかどうか、どのプロファイル・セクションを表示するか、ユーザーに各自のプロファイルの詳細の更新を許可するかどうかを指定します。また、ユーザーが更新可能なプロファイルの属性を指定します(図13-3)。

図13-3 プロファイルの構成設定

個人プロファイルは、「サマリー」、「従業員」、「勤務先連絡先」、「個人情報」というセクションで示されます。各セクションには、セクションの見出しに関連する情報が表示されます。たとえば、「サマリー」には、ユーザーの名前、電子メール・アドレス、事業所所在地などの基本的な詳細の集合が含まれています。

構成設定では、「サマリー」セクションのアクセス設定により、ユーザーを検索できるユーザーを制御します(たとえば、グローバル検索、人ピッカー、他のユーザーを検索してコネクションへの参加を招待する検索など)。たとえば、「サマリー」の表示を「全員」に許可していると、ユーザーは認証されていない(パブリック)ユーザーの検索対象になります。「認証済ユーザー」にのみ他のユーザーの「サマリー」セクションの表示を許可していると、ログインしているユーザーのみがユーザーを検索できるようになります。「このセクションを表示できるユーザー」の値に「なし」を選択すると、そのユーザーは検索結果に表示されなくなります。

ユーザーは、「プリファレンス」からの「サマリー」セクションでプライバシ設定を変更できません(詳細は、『Oracle WebCenter Portalの使用』のプロファイル・プリファレンスの設定に関する項を参照してください)。「サマリー」セクションのプライバシは、この項で説明されている設定により、すべてのユーザーに対してグローバル・レベルで制御されます。

管理者は、各セクションに表示する情報を選択し、ユーザーが各自のプロファイル・データと各自のアプリケーション・パスワードをWebCenter Portalで編集できるようにするかどうかを決定します。

プロファイルを構成する手順は次のとおりです。

1. WebCenter Portal管理を開きます。

詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください

2. 「ツールとサービス」をクリックして、「ピープル・コネクション」を選択します。

または、次のURLを使用して、「ピープル・コネクション」を選択します。

http://host:port/webcenter/portal/admin/tools

ピープル・コネクションの機能名を示すタブが右側に表示されます。

3. 「プロファイル」タブをクリックして、このタブを手前に表示します。

表13-4に、各オプションのリストと説明を示します。

表13-4 プロファイルの構成オプション

オプション

説明

パスワード変更の許可

ユーザーが各自のアプリケーション・パスワードを変更できるようにするかどうかを指定します

- 選択すると、ユーザーは自分のアプリケーション・パスワードを変更できるようになります。

- 選択解除すると、ユーザーは自分のアプリケーション・パスワードを変更できなくなります。このオプションは、組織がユーザーの資格証明の管理に単一の個別アプリケーション用意しているため、各アプリケーションからパスワード管理を提供する必要がない場合に役立ちます。

プロファイルのアクセス

どのプロファイル・セクションを表示して、ユーザーが各自のプロファイルの詳細を更新できるようにするかどうかを指定します。

次に示す表の列で、アプリケーションのデフォルトを設定します。

プロファイル・セクション - ユーザー・プロファイルに表示する情報のグループを特定します。

ビューの設定 - 特定のプロファイル・セクションを表示できるユーザーを指定し、それらのデフォルトをユーザーが個人プリファレンスで変更できるかどうかを示します。

「サマリー」セクションの「ビューの設定」では、どのユーザーがサマリーの詳細を表示できるかのみでなく、そのユーザーが人の検索で誰の検索対象になるかについても制御します。

次の項目に値を設定します。

- このセクションを表示できるユーザー - 関連するプロファイル・セクションをデフォルトで表示できるユーザーのタイプを指定します。
全員 - すべてのユーザー(ログインしていないユーザーを含む)が、他のユーザーのプロファイルの関連プロファイル・セクションを表示できます。

認証済ユーザー - ログインしているユーザーのみが、他のユーザーのプロファイルの関連プロファイル・セクションを表示できます。

ユーザーのコネクション - 現在のユーザーとのコネクションがあるユーザーが、他のユーザーのプロファイルの関連プロファイル・セクションを表示できます。このオプションは、「サマリー」を除くすべてのセクションで選択できます。

ユーザーのみ - ユーザーのみが各自の関連プロファイル・セクションの詳細を表示できます。

なし - このセクションは、すべてのユーザーに対して非表示になります。

- 所有者オーバーライドの許可 - ここで指定したデフォルトのアプリケーション設定について、ユーザーによるオーバーライドを有効または無効にします。選択すると有効になり、選択解除すると無効になります。

編集可能 - 選択すると、ユーザーは自分の個人プロファイルの関連プロファイル・セクションを編集できるようになります。選択解除すると、関連プロファイル・セクションを編集できなくなります。

この設定では、プロファイル・タスク・フローに「編集」リンクを表示するかどうかも制御します。ただし、デフォルト・バージョンの「プロファイル」ページの「編集」ボタンまたはリンクの表示には影響しません。他のプロファイル管理設定を使用すると、ユーザーによるプロファイルの詳細の変更をすべて禁止できます。

プロファイル属性: 設定の編集

セクションの属性の編集をデフォルトでユーザーに許可することを示します。

「更新の許可」で次のように設定します。

- 属性を選択して、ユーザーが自分のプロファイルでその値を編集できるようにします。

- 属性の選択を解除して、ユーザーが自分のプロファイルで編集できないようにします。

4. 「適用」をクリックして、構成設定を保存します。

13.3.5 メッセージ・ボードの構成

メッセージ・ボードは、ユーザーに自分のコネクションに向けたメッセージの表示および投稿の手段を提供します。メッセージ・ボードの構成設定により、メッセージの表示と投稿、ユーザーが残したメッセージの編集と削除、受信したメッセージの削除と表示の変更を誰が行えるかを指定したり、各メッセージに対するコメント書込みとお気に入り登録を有効にするかどうかを制御することができます(図13-4)。

図13-4 メッセージ・ボードの構成設定

関連項目:

LIKE登録とコメントの詳細は、『Oracle WebCenter Portalの使用』のアイテムに対するLIKE登録、コメントおよび共有に関する項を参照してください。

メッセージ・ボードを構成するには:

1. WebCenter Portal管理を開きます。

詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください

2. 「ツールとサービス」をクリックして、「ピープル・コネクション」を選択します。

または、次のURLを使用して、「ピープル・コネクション」を選択します。

http://host:port/webcenter/portal/admin/tools

ピープル・コネクションの機能名を示すタブが右側に表示されます。

3. 「メッセージ・ボード」タブをクリックして、そのタブを手前に表示します。

表13-5に、各オプションのリストと説明を示します。

表13-5 メッセージ・ボードの構成オプション

オプション

説明

表示アクセス権の付与先

メッセージ・ボードのメッセージを表示できるユーザーを指定します。

- 全員 - すべてのユーザー(ログインしていないユーザーも含む)が、ユーザーのメッセージ・ボードのメッセージを表示できます。

- 認証済ユーザー - ログインしているユーザーのみが、ユーザーのメッセージ・ボードのメッセージを表示できます。

- ユーザーのコネクション - ユーザーおよびユーザーのコネクションのみが、ユーザーのメッセージ・ボードを表示できます。

- ユーザーのみ - ユーザーのみが、自分のメッセージ・ボードでメッセージを表示できます。

投稿アクセス権の付与先

メッセージ・ボードにメッセージを投稿できるユーザーを指定します。

- 全員 - すべてのユーザー(ログインしていないユーザーを含む)が、メッセージ・ボードにメッセージを投稿できます。

- 認証済ユーザー - ログインしているユーザーのみが、メッセージ・ボードにメッセージを投稿できます。

- ユーザーのコネクション - ユーザーおよびユーザーのコネクションのみが、ユーザーのメッセージ・ボードにメッセージを投稿できます。

- ユーザーのみ - ユーザーのみが、自分のメッセージ・ボードにメッセージを投稿できます。

所有者オーバーライドの許可

これらの管理デフォルトをユーザーがオーバーライドできるかどうかを指定します。

- 選択すると、ユーザーが「プリファレンス」からデフォルト設定を編集できるようになります(詳細は、『Oracle WebCenter Portalの使用』のピープル・コネクション・プリファレンスの設定に関する項を参照してください)。

- 選択解除すると、管理者によるデフォルトのアプリケーション設定が強制されます。

ユーザーが他のメッセージ・ボードに投稿するメッセージで処理できるようにします

ユーザーが投稿したメッセージで処理できるかどうかを指定します。

- メッセージの編集 - 選択すると、ユーザーはメッセージ・ボードへの自分の投稿を編集できるようになります。選択解除すると、ユーザーは自分の投稿したメッセージを編集できなくなります。

- メッセージの削除 - 選択すると、ユーザーはメッセージ・ボードへの自分の投稿を削除できるようになります。選択解除すると、ユーザーは自分の投稿したメッセージを削除できなくなります。

ユーザーが他のユーザーから受信したメッセージを処理できるようにします

ユーザーが、他のユーザーから受信したメッセージを処理できるかどうかを指定します

- メッセージの削除 - 選択すると、ユーザーは他のユーザーから受信したメッセージを削除できるようになります。選択解除すると、ユーザーは受信したメッセージを削除できなくなります。

- メッセージの可視性の変更 - 選択すると、ユーザーは特定のユーザーからのメッセージを非表示または表示にできるようになります。選択解除すると、ユーザーはメッセージの非表示または表示ができなくなります。

メッセージ・ボードからのメッセージへのコメントを有効にします

ユーザーがメッセージ・ボードに投稿されたメッセージにコメントできるかどうかを指定します。

- 選択すると、ユーザーはメッセージにコメントできるようになります。「コメント」リンクが、各メッセージの下に表示されます。ユーザーは、これをクリックしてコメントを入力します。詳細は、『Oracle WebCenter Portalの使用』のWebCenter Portal内のアイテムのLIKE登録、コメントおよび共有に関する項を参照してください。

- 選択解除すると、コメントが禁止されます。

メッセージ・ボードからのメッセージのお気に入り登録を有効にします

ユーザーがメッセージをLIKE登録できるかどうかを指定します。

- 選択すると、ユーザーはメッセージをお気に入り登録できます。「お気に入り登録」リンクが、各メッセージの下に表示されます。詳細は、『Oracle WebCenter Portalの使用』のWebCenter Portal内のアイテムのLIKE登録、コメントおよび共有に関する項を参照してください。

- 選択解除すると、お気に入り登録できなくなります。

4. 「適用」をクリックして、構成設定を保存します。

13.3.6 フィードバックの構成

フィードバックは、他のアプリケーション・ユーザーへのユーザー・フィードバックを表示および投稿する手段を提供します。フィードバックの構成設定では、ユーザーが受信したフィードバックの表示および投稿アクセスの付与、ユーザーが投稿したフィードバックの表示アクセスの付与、ユーザーによるデフォルトの管理設定のオーバーライドの許可、ユーザーが投稿したフィードバックのそのユーザーによる削除の有効化、および他のユーザーが投稿したフィードバックのユーザーによる表示または非表示の有効化に対する制御が提供されます(図13-5)。

図13-5 フィードバックの構成設定

フィードバックの構成設定では、フィードバックの表示、投稿、および削除が可能なユーザーを特定するための制御が提供されます。

フィードバックを構成する手順は次のとおりです。

1. WebCenter Portal管理を開きます。

詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください

2. 「ツールとサービス」をクリックして、「ピープル・コネクション」を選択します。

または、次のURLを使用して、「ピープル・コネクション」を選択します。

http://host:port/webcenter/portal/admin/tools

ピープル・コネクションの機能名を示すタブが右側に表示されます。

3. 「フィードバック」タブをクリックして、このタブを手前に表示します。

表13-6に、各オプションのリストと説明を示します。

表13-6 フィードバックの構成オプション

オプション

説明

表示アクセス権の付与先

現在のユーザーのフィードバックを表示できるユーザーを指定します。

- 全員 - すべてのユーザー(ログインしていないユーザーも含む)が、特定のユーザーのフィードバックを表示できます。

- 認証済ユーザー - ログインしているユーザーのみが、特定のユーザーのフィードバックを表示できます。

- ユーザーのコネクション - ユーザーとユーザーのコネクションのみが、特定のユーザーのフィードバックを表示できます。

- ユーザーのみ - 他のユーザーが特定のユーザーのフィードバックを表示できないようにします。

投稿アクセス権の付与先

ユーザー・フィードバックを投稿できるユーザーを指定します。

- 全員 - すべてのユーザー(ログインしていないユーザーも含む)が、特定のユーザーにフィードバックを投稿できます。

- 認証済ユーザー - ログインしているユーザーのみが、特定のユーザーにフィードバックを投稿できます。

- ユーザーのコネクション - ユーザーとユーザーのコネクションのみが、特定のユーザーにフィードバックを投稿できます。

- ユーザーのみ - ユーザーは、自分にのみフィードバックを投稿できます。事実上、フィードバックが無効になります。

投稿されたフィードバックの表示アクセス権の付与先

「表示」メニューを表示して、フィードバック・タスク・フローの投稿したフィードバックと受信したフィードバックの間を切り替えることができるユーザーを指定します。

- 全員 - すべてのユーザー(ログインしていないユーザーも含む)に、「表示」メニューのオプションが表示されます。

- 認証済ユーザー - ログインしているユーザーにのみ、「表示」メニューのオプションが表示されます。

- ユーザーのコネクション - ユーザーとユーザーのコネクションにのみ、「表示」メニューが表示されます。

- ユーザーのみ - 現在のユーザー以外のすべてのユーザーの「表示」メニューが無効になります。各ユーザーが現在のユーザーのフィードバック・タスク・フローにアクセスすると、現在のユーザーが受信したフィードバックのみが表示されます。

所有者オーバーライドの許可

これらの管理デフォルトをユーザーがオーバーライドできるかどうかを指定します。

- 選択すると、ユーザーはユーザー・プリファレンスからアプリケーションのデフォルト設定を変更できるようになります。(詳細は、『Oracle WebCenter Portalの使用』のフィードバック・プリファレンスの設定に関する項を参照)。

- 選択解除すると、ユーザーはフィードバックについての管理者設定を変更できなくなります。

ユーザーが他のユーザーへのフィードバックで処理できるようにします

ユーザーが投稿したフィードバックを削除できるかどうかを示します。

- 「フィードバックの削除」を選択すると、ユーザーは自分が投稿したフィードバックを削除できるようになります。

- 「フィードバックの削除」を選択解除すると、ユーザーは自分が投稿したフィードバックを削除できなくなります。

フィードバックの所有者が他のユーザーによって投稿されたフィードバックを処理できるようにします

他のユーザーからのフィードバックをユーザーが非表示または表示にできるかどうかを示します。

- 「フィードバックの可視性の変更」を選択すると、ユーザーは他のユーザーからのフィードバックを非表示または表示にできるようになります。

- 「フィードバックの可視性の変更」を選択解除すると、他のユーザーが投稿したフィードバックを非表示または表示にできなくなります。

4. 「適用」をクリックして、構成設定を保存します。

13.4 アクティビティ・ストリーム・スキーマのアーカイブ

管理者は、次のWLSTコマンドを使用してアクティビティ・ストリーム・スキーマ内のデータをアーカイブおよびリストアできます。

- archiveASByDate - 指定した日付よりも古いアクティビティ・ストリーム・データをアーカイブします。

- archiveASByDeletedObjects - 削除されたオブジェクトに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- archiveASByClosedSpaces - 現在クローズ中のポータルに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- archiveASByInactiveSpaces - 指定した日付から非アクティブになっているポータルに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- restoreASByDate - 指定した日付以降のアーカイブされたアクティビティ・ストリーム・データを本番の表にリストアします。

- truncateASArchive - アクティビティ・ストリーム・アーカイブ・データを切り捨てます。

- archiveASBySpace - ポータルに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- archiveASAllSpaces - すべてのポータルに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- archiveASByUser - ユーザーに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- archiveASAllUsers - すべてのユーザーに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- archiveASByDeletedActors - 削除されたアクターに関連付けられているアクティビティ・ストリーム・データをアーカイブします。

- showASStatistics - アクティビティ・ストリーム統計をレポートします。

詳細は、WebCenter WLSTコマンド・リファレンスのアクティビティ・ストリームに関する項を参照してください。

13.5 組織ビューの管理チェーンの指定

組織ビュー・タスク・フローと「プロファイル」ページの「組織」タブでは、管理チェーンの視覚化が提供されます。たとえば、上司と直属の部下についてのビューがレンダリングされます(図13-6)。

図13-6 上司と直属の部下についての組織ビュー

デフォルトでは、このような組織ビューの管理チェーンを定義する値は指定されていません。つまり、ユーザーの詳細を提供するバックエンド・アイデンティティ・ストアのユーザーによって、上司が自動的に指定されることはないということです。

ヒント:

「プロファイル」ページの「情報」タブにある「マネージャ」の値も、この項で説明する方法で定義されます。

組織ビューに管理チェーンがレンダリングされるようにするには、「直属の部下」のユーザーにmanager属性が指定されるように、WebCenter Portalの認証に使用するバックエンド・アイデンティティ・ストアを設定する必要があります。また、manager属性は、マネージャ・ユーザーの識別名(DN)として定義する必要があります(「組込みLDAPの構成例」を参照)。

ヒント:

LDAP環境では、1人のユーザーは1人のユーザーによってのみ管理されますが、その同じ環境で、1人のユーザーは複数のユーザーを管理できます。

13.5.1 組込みLDAPの構成例

管理チェーンは、Oracle WebLogic Server (WLS)の組込みLDAPまたはOracle Internet Directory (OID)などの外部LDAPで指定できます。ただし、組込みLDAPで定義する管理チェーンは、テストや概念実証を目的としたもので、本番用ではありません。本番用には、WebCenter Portal認証用アイデンティティ・ストアに、外部LDAP (OIDなど)を使用する必要があります。

関連項目:

詳細は、「アイデンティティ・ストアの構成」または使用しているLDAP実装に付属のドキュメントを参照してください。

この例では、WebLogic Serverの組込みLDAPでテスト用または概念実証用に管理チェーンを定義する方法について説明します。

注意:

この例で説明する手順は、外部LDAPに対する手順と同様です。つまり、属性(manager)を作成して、ユーザーごとにこの属性の値を設定することになります。この値には、選択したユーザーの上司のDNを入力します。

この例に示すユーザーは次の3人です。

- user1

- user2

- manager_user

これらのユーザーに管理チェーンを定義するには:

1. 外部ビューア(Apache Directory Studioなど)を使用して、組込みLDAPを参照できるようにします。

a. WLS管理コンソールに移動して、管理者ユーザーとしてログインします。

b. ドメイン(例: wc_domain)をクリックして「セキュリティ」タブを開き、「組込みLDAP」サブタブを開きます(図13-7)。

図13-7 Oracle WebLogic Server管理コンソール

c. 「資格証明」フィールドに値を入力し、「資格証明の確認」フィールドに同じ値を再度入力します。

ヒント:

デフォルトの資格証明は、ランダム生成されたパスワードです。覚えやすいものに設定してください。

d. 管理サーバーと管理対象サーバーを再起動します。

2. 手順1で選択したLDAPビューアを起動して、次の詳細を使用して接続を作成します。

- hostname (例: example.com)

- port (WLS管理ポート。例: 7001)

- Bind DN (cn=Admin)

- Password (手順1cで設定した資格証明)

3. DITツリー内でユーザーを探して、user1に移動します(図13-8)。
たとえば、次に示す順でクリックします。

- dc=wc_domain

- ou=myrealm

- ou=people

- uid=user1

図13-8 LDAPブラウザのDITツリーでのユーザーの選択

4. 「属性の説明」列で、managerタイプの新しい属性を追加します。

ヒント:

[Ctrl]、[Shift]、[+]を同時に押すと、「新規属性」ダイアログが開きます。

5. 属性値には、manager_userのDNを選択します(図13-9)。
たとえば、ルートの下で次の順に選択します。

- dc=wc_domain

- ou=myrealm

- ou=people

- uid=manager_user

図13-9 「DNの選択」ダイアログ

6. user2に対して手順3から5を繰り返します。

この時点で、user1とuser2は、manager_userの部下になります。これを確認するには、user1としてWebCenter Portalにログインして、「プロファイル」ページの「情報」タブに移動します。ユーザーmanager_userが、上司として表示されます(図13-10)。

図13-10 「プロファイル」ページの「情報」タブ

ヒント:

「マネージャ」の値(この例では、manager_user)をクリックすると、上司のプロファイルが表示されます。「組織」タブにアクセスすると、現在表示しているプロファイルに関連付けられた組織ビューが表示されます。

13.6 プロファイルの構成プロパティの設定

管理者は、WLSTコマンドを使用してプロファイルの構成プロパティを設定できます(ユーザー・インタフェースに表示されるプロファイルのバージョンの設定など)。管理者は次の操作を実行できます。

- プロファイルの構成プロパティを設定するには、setProfileConfigを実行します。
構文:

setProfileConfig(appName, [ProfilePageVersion], [ProfileSyncHourOfDay], [ProfileSyncFrequencyInDays], [server], [applicationVersion])

このコマンドは、次のパラメータを受け取ります。

- appName: この操作を実行するWebCenter Portalアプリケーションの名前。例: webcenter。

- ProfilePageVersion: (オプション)使用するプロファイル・ページのバージョン。ProfilePageVersionの有効な値は、次のとおりです。

- v1: 旧形式のプロファイル・ページを使用します(11.1.1.7.0以前)

- v2: (デフォルト)新しいプロファイル・ページ(11.1.1.8.0で導入)のフォーマットを使用します

注意:

プロファイル・ページのバージョン変更は、WebCenter Portalアプリケーションがデプロイされているサーバーを再起動するまで有効になりません。

- 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

- ProfileSyncHourOfDay

- ProfileSyncFrequencyInDays

- server: (オプション)アプリケーションがデプロイされているターゲット・サーバーの名前。

- applicationVersion: (オプション)アプリケーションのバージョン番号。

13.7 プロファイルとアイデンティティ・ストアの同期

管理者はWLSTコマンドを使用して、LDAPアイデンティティ・ストアのプロファイル情報をWebCenter Portalと同期できます。管理者は次の操作を実行できます。

- startSyncProfilesまたはstopSyncProfilesを実行して、すべてのユーザーまたは1つのユーザーのプロファイル同期を開始または停止します。

- isSyncProfilesRunningを実行して、プロファイル同期が現在実行中かどうかを確認します。

- 様々なプロファイル同期オプションを設定します。

- setProfilePhotoSyncを実行して、LDAPのユーザー・プロファイル写真を同期するかどうかを指定します。

- syncProfileを実行して、特定のユーザーのプロファイル情報を同期します。

詳細は、WebCenter WLSTコマンド・リファレンスの次のコマンド・リファレンスを参照してください。

- startSyncProfiles

- stopSyncProfiles

- isSyncProfilesRunning

- setProfilePhotoSync

- syncProfile

14 RSSの管理

この章では、WebCenter PortalのRSS機能を構成および管理する方法について説明します。

この章の内容は次のとおりです。

- RSSについて

- RSSの前提条件

- 外部RSSニュース・フィードのためのプロキシ・サーバーの設定

- 外部RSSニュース・フィード接続のテスト

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、WebCenter Portal管理を使用して付与されるAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

14.1 RSSについて

RSS機能には、RSSビューアと、様々なWebCenter Portalツールおよびサービスからのニュース・フィードを表示するRSSサービスが含まれます。RSSビューアを使用すれば、複数の異なるWebサイトからの外部ニュース・フィードをWebCenter Portal内で表示できます。RSSは、ディスカッション、リストおよびお知らせを含む様々なポータル・リソースからコンテンツ更新情報を配信します。

14.2 RSSの前提条件

RSS機能はバックエンド・サーバーを必要としません。これを使用するために接続を設定する必要はありません。ただし、ネットワーク構成によっては、WebCenter Portalが外部RSSニュース・フィードのコンテンツを表示できるように、プロキシ・サーバーの設定が必要になる場合があります。

14.3 外部RSSニュース・フィードのためのプロキシ・サーバーの設定

WebCenter Portalで外部RSSニュース・フィードを使用できるようにするには、プロキシ・サーバーを設定する必要があります。

アクティビティ・ストリーム・タスク・フローで外部リンクを表示する場合は、プロキシ・サーバーも必要です。RSSとアクティビティ・ストリームは、同じプロキシ・サーバー設定を共有します。

Fusion Middleware ControlまたはWLSTのいずれかを使用して、プロキシ・サーバーを構成できます。詳細は、「プロキシ・サーバーの設定」を参照してください。

14.4 外部RSSニュース・フィード接続のテスト

プロキシ・サーバーをRSSビューア用に設定したら、接続をテストして、外部RSSフィードにアクセスできることを確認します。

プロキシ・サーバーがRSSビューア用に適切に設定されていることを確認する手順は次のとおりです。

1. WebCenter Portalで、RSSタスク・フローをページに追加します。

RSSタスク・フローの追加およびURLの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のRSSニュース・フィードのポータルへの追加に関する項を参照してください。

2. RSSタスク・フローを編集して、外部RSSフィードのURLを設定します。

例:

http://www.oracle.com/ocom/groups/public/@ocom/documents/webcontent/196280.xml

RSSフィードが正しく表示されれば、プロキシの構成は適切に設定されています。

15 WebCenter PortalでのOracle Secure Enterprise Searchの管理

この章では、WebCenter Portalのほとんどのオブジェクトを索引付けおよび検索するようにOracle Secure Enterprise Search (SES) 11.2.2.2を構成する方法について説明します。

この章の内容は次のとおりです。

- Oracle SESを使用した検索について

- WebCenter PortalでのOracle SESの構成ロードマップ

- Oracle SESを使用するための前提条件

- Oracle SES接続の設定

- WebCenter Portalを検索するためのOracle SESの構成

- WebCenter Portal管理での検索の管理

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、WebCenter Portal管理を使用して付与されるAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

15.1 Oracle SESを使用した検索について

Oracle SESには、次の利点と機能があります。

- Oracle SESでは、最も関連性の高いアイテムが最初に表示される、統合ランキング結果が提供されます。

- Oracle SESは、徹底した検索を提供します。たとえば、WebCenter Portalでリストを検索する場合、Oracle SESで検索するのはリストの列名と列の内容です。

- Oracle SESでは、WebCenter Portal外の他のリポジトリの検索が可能です。

- Oracle SESでは、検索インタフェースをカスタマイズするための検索REST APIとデータ・コントロールがサポートされています。

- 検索は、アプリケーションの管理設定でカスタマイズできます。Oracle SES 11.2.2.2では、ファセット検索、検索ボックスでのフィルタ検索およびドキュメントのサムネイルをサポートします。Oracle SES 11.2.2.2を使用したカスタマイズは、タスク・フローのパラメータが表示されたとしても、すべて、「ツールとサービス」→「検索」管理ページで行います。WebCenter Portal管理における検索の構成の詳細は、「WebCenter Portal管理での検索の管理」を参照してください。

注意:

この作業は管理者が実行します。ポータル・レベルの検索の使用は、アプリケーション・スペシャリストまたはポータル・マネージャの作業になります。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルへの検索の追加に関する項を参照してください。

- Oracle SESは、次のリソースを検索するように構成できます。

- ドキュメント(Wikiおよびブログを含む)

- お知らせおよびディスカッション

- ポータル、リスト、ページ、メタデータ、人

注意:

Oracle SESがWebCenter Portalを検索するよう構成されている場合、その他のクロールされていないリソース(ノート、イベントなど)は検索結果に返されません。

すべてのソースの結果が合せてリストされ、最も関連性の高いアイテムが最初に表示されます。たとえば、ユーザー名の検索を実行する場合、そのユーザーが作成したドキュメントではなく、そのユーザーの連絡先情報(つまり、ピープル・コネクション内の正確なユーザー名)を探している可能性が高いと考えられます。

- WebCenter Portalリソースを索引付けするには、次の3つのタイプのOracle SESクローラを使用できます。

- ドキュメント・クローラ: Oracle SES Content Serverソース・タイプを使用して、Wikiおよびブログを含むドキュメントをクロールします。

- ディスカッション・クローラ: Oracle SES Databaseソース・タイプを使用して、ディスカッションおよびお知らせをクロールします。

- スペース・クローラ: Oracle SES Oracle WebCenterソース・タイプを使用して、リスト、ページ・メタデータ、ポータル、プロファイルなどの特定のオブジェクトをクロールします。

注意:

Oracle SESクローラはバックエンド・リポジトリへのコネクタ経由でデータを収集します。Oracle SESでは、各コネクタは「クロール・ソース」として構成されます。各クロール・ソースには、リレーショナル・データベースやContent Serverリポジトリなどのデータを保持するリポジトリのタイプを識別するためのタイプがあります。

Oracle SESを構成する際には、使用可能なOracle SESクローラをすべて有効化する必要があります。あるOracle SESクローラを有効化して、他のクローラは有効化しないということはお薦めしません。たとえば、Oracle SESを構成する場合、ドキュメントをクロールして、ディスカッションはクロールしないという構成はしないでください。

15.2 WebCenter PortalでのOracle SESの構成ロードマップ

構成プロセス全体のガイドとしてこの項のロードマップを使用してください。

- ロードマップ: Oracle SESの構成
図15-1 (または表15-1)に、Oracle SESを動作させるための前提条件と必要な作業の概要を示します。

図15-1 Oracle SESの構成

表15-1 Oracle SESの構成

担当者

タスク

管理者

1. 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.(オプション)ポータルに検索タスク・フローを追加します

15.3 Oracle SESを使用するための前提条件

この項には次のトピックが含まれます:

- Oracle SES - インストール

- Oracle SES - 構成

- Oracle SES - セキュリティ

15.3.1 Oracle SES - インストール

この章の各項では、Oracle SES 11.2.2.2およびOracle WebCenter Content Server 12.2.1を実行していることを前提としています。WebCenter Portal 12.2.1では、これらのバージョンのみがサポートされます。

Oracle SESのインストールの詳細は、『Oracle WebCenter Portalのインストールと構成』の検索のバックエンド要件に関する項を参照してください。

関連項目:

Oracle SESに必要なすべてのパッチをインストール済であることを確認することは重要です。必要なパッチの最新情報は、リリース・ノートを確認してください。

15.3.2 Oracle SES - 構成

1. Oracle SESは、ユーザーを検証および認証するためにアイデンティティ管理システムとともに構成する必要があります。これはセキュアな検索のために必要です。そうすることで、検索時に、アクセス権限に基づいてユーザーが表示することを許可される結果のみが返されるようになります。
WebCenter PortalはOracle SESとの通信時にアイデンティティ伝播を使用するため、WebCenter Portalのユーザー・ベースはOracle SESのユーザー・ベースと一致している必要があります。そうするための1つの方法は、WebCenter PortalとOracle SESを、Oracle Internet Directoryなどの同じアイデンティティ管理システムに対して構成することです。

注意:

サポートされているすべてのアイデンティティ管理システムの詳細は、「デフォルトのアイデンティティ・ストアおよびポリシー・ストア」を参照してください。

各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 Unified Directory (OUD)をアイデンティティ・ストアとして使用している場合は、プラグインSun Java System Directory Serverを使用してOUDアイデンティティ・ストアを構成します。

次の例では、Oracle Internet Directory用のアイデンティティ・プラグインを設定します。

a. Oracle SES管理ツールで、「グローバル設定」→「アイデンティティ管理設定」ページに移動し、利用可能なアイデンティティ・プラグインから「Oracle Internet Directory」を選択し、「アクティブ化」をクリックします。

b. 次の値を入力します。
ホスト名: Oracle Internet Directoryが実行されているコンピュータのホスト名

ポート: Oracle Internet Directoryのポート番号

SSLの使用: trueまたはfalse

レルム: Oracle Internet Directoryレルム(dc=us,dc=oracle,dc=comなど)

ユーザー名: Oracle Internet Directory管理ユーザー名(cn=orcladminなど)

パスワード: 管理ユーザーのパスワード

c. 「送信」をクリックします。

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コマンドを使用します。

例: 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')

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのcreateFederationTrustedEntityに関する項を参照してください。

これをOracle SESで実行するには、次の手順に従ってください。

a. Oracle SES管理ツールで、「グローバル設定」→「フェデレーション・トラステッド・エンティティ」ページに移動します。

b. 信頼できるエンティティの名前を入力します。これは、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のクロール管理ユーザー

15.3.3 Oracle SES - セキュリティ

ほとんどのエンタープライズ・デプロイメントでは、セキュアなHTTP接続が必要です。Secure Socket Layer (SSL)は、インターネット上で機密のコンテンツを安全に送信するための暗号化プロトコルです。パスワードやその他のセキュアなデータをネットワーク上で送信する際には、SSLで保護されたチャネルを使用することを強くお薦めします。

手順の詳細は、「SSLを使用したOracle SESへの接続の保護」を参照してください。

15.4 Oracle SES接続の設定

この項には次のトピックが含まれます:

- Oracle SES接続のテスト

- Oracle Secure Enterprise Searchサーバーの登録

- アクティブなOracle SES接続の選択

- Oracle SES接続の詳細の変更

- Oracle SES接続の削除

15.4.1 Oracle SES接続のテスト

ブラウザに次のOracle SES Webサービス操作のURLを入力して、Oracle SES接続を確認します。

http://host:port/search/query/

このURLアドレスがブラウザで表示されない場合、Oracle SESサーバーのホストまたはポートのどちらかが間違っているか、またはOracle SESが起動されていません。

15.4.2 Oracle Secure Enterprise Searchサーバーの登録

WebCenter Portalアプリケーションには複数のOracle SES接続を登録できますが、一度にアクティブにできる接続はそのうち1つのみです。Fusion Middleware ControlまたはWLSTを使用して接続を登録できます。

この項には次のトピックが含まれます:

- Fusion Middleware Controlを使用したOracle SES接続の登録

- WLSTを使用したOracle SES接続の登録

15.4.2.1 Fusion Middleware Controlを使用したOracle SES接続の登録

Oracle SESインスタンスを登録するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「検索」を選択します。

4. 新規のOracle SESインスタンスに接続するには、「追加」をクリックします(図15-2)。

図15-2 Oracle Secure Searchの構成

5. 「Secure Enterprise Search接続の追加」ページで、この接続の一意の名前を入力し、この接続をアプリケーションのアクティブな(またはデフォルトの)接続にするかどうかを指定します(図15-3)。

図15-3 Secure Enterprise Search接続の追加

表15-2

表15-2 Oracle SES接続: 名前

フィールド

説明

接続名

接続の一意の名前を入力します。名前は、WebCenter Portalアプリケーション内で(すべての接続タイプにわたって)一意である必要があります。

アクティブな接続

これを選択すると、この接続にWebCenter Portalの検索プラットフォームとして定義されているOracle SESインスタンスが使用されます。

1つのアプリケーションに対して複数のOracle SES接続を登録できますが、使用される接続は1つのみ(つまり、デフォルトの接続またはアクティブな接続)です。

6. Oracle SESインスタンスの接続の詳細を入力します(表15-3)。

表15-3 Oracle SES - 接続の詳細

フィールド

説明

SOAP URL

Oracle SESが検索リクエストを有効化するために公開するWebサービスURLを入力します。

次の形式を使用します。

http://host:port/search/query/OracleSearch

例:

http://myHost:7777/search/query/OracleSearch

フェデレーション・トラステッド・エンティティ名

「Oracle SES - 構成」で作成したOracle SESフェデレーション・トラステッド・エンティティのユーザー名を入力します。

ヒント: このユーザーは、Oracle SES管理ツールの「グローバル設定」→「フェデレーション・トラステッド・エンティティ」ページで構成されます。

WebCenter Portalアプリケーションは、WebCenter Portalユーザーにかわって検索を実行できるように、Oracle SESに対して信頼できるアプリケーションとして自身を認証する必要があります。

この章の例では、この値にwcsearchを使用しています。

フェデレーション・トラステッド・エンティティ・パスワード

フェデレーション・トラステッド・エンティティのパスワードを入力します。

7. 「OK」をクリックして、この接続を保存します。

注意:

新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Portal)を再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

15.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は「Oracle SES - 構成」で作成したOracle SESフェデレーション・トラステッド・エンティティのユーザー名です。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのcreateSESConnectionに関する項を参照してください。

新規のOracle SES接続をアクティブに使用するように検索を構成するには、default=trueを設定します。詳細は、「WLSTを使用したアクティブなOracle SES接続の設定」を参照してください。

関連項目:

WLSTを使用したOracle SES接続の詳細の変更

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

新しい(アクティブな)接続または設定の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Portal)を再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のスクリプトを使用した管理対象サーバーの起動および停止に関する項を参照してください。

15.4.3 アクティブなOracle SES接続の選択

WebCenter Portalアプリケーションには複数のOracle SES接続を登録できますが、一度にアクティブにできる接続はそのうち1つのみです。

注意:

「Oracle Secure Enterprise Searchサーバーの登録」でアクティブな接続を選択している場合は、この項に示す手順を実行する必要はありません。

この項には次のトピックが含まれます:

- Fusion Middleware Controlを使用したアクティブなOracle SES接続の選択

- WLSTを使用したアクティブなOracle SES接続の設定

15.4.3.1 Fusion Middleware Controlを使用したアクティブなOracle SES接続の選択

アクティブな接続を変更するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「検索」を選択します。

「セキュアなEnterprise Search接続の管理」表に、現在のアクティブな接続(ある場合)が示されます。

4. アクティブな(またはデフォルトの)接続にする接続を選択し、「編集」(図15-4)をクリックします。

図15-4 「編集」アイコン

5. 「アクティブな接続」チェック・ボックス(図15-5)を選択します。

図15-5 「アクティブな接続」チェック・ボックス

6. 「OK」をクリックして、接続を更新します。

注意:

新しい(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Portal)を再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

15.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)

完全なコマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetSESConnectionに関する項を参照してください。

後からOracle SES接続を無効化するには、同じWLSTコマンドをdefault=falseとともに実行します。接続の詳細は保持されますが、この接続はアクティブな接続として示されなくなります。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

アクティブな接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Portal)を再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

15.4.4 Oracle SES接続の詳細の変更

Oracle SES接続の詳細はいつでも変更できます。

更新された(アクティブな)接続の使用を開始するには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。

注意:

この項の手順は、「Oracle Secure Enterprise Searchサーバーの登録」で構成された詳細を変更する場合にのみ必要になります。

この項には次のトピックが含まれます:

- Fusion Middleware Controlを使用したOracle SES接続の詳細の変更

- WLSTを使用したOracle SES接続の詳細の変更

15.4.4.1 Fusion Middleware Controlを使用したOracle SES接続の詳細の変更

Oracle SESインスタンスの接続の詳細を更新する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページで、「検索」を選択します。

4. 接続名を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータの詳細は、表15-3を参照してください。

6. 「OK」をクリックして、変更を保存します。

注意:

更新された(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Portal)を再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

15.4.4.2 WLSTを使用したOracle SES接続の詳細の変更

WLSTコマンドのsetSESConnectionを使用して、既存のOracle SES接続を変更します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetSESConnectionに関する項を参照してください。

注意:

更新された(アクティブな)接続の使用を開始するには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Portal)を再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

15.4.5 Oracle SES接続の削除

Oracle SES接続はいつでも削除できますが、アクティブな接続を削除する際は注意が必要です。アクティブな接続を削除すると、ユーザーは外部リポジトリのコンテンツを検索できなくなります。

この項には次のトピックが含まれます:

- Fusion Middleware Controlを使用したOracle SES接続の削除

- WLSTを使用したOracle SES接続の削除

15.4.5.1 Fusion Middleware Controlを使用したOracle SES接続の削除

Oracle SESサーバー接続を削除するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「サービス接続」ドロップダウンから、「検索」を選択します。

4. 接続名を選択し、「削除」をクリックします。

図15-6 接続削除アイコン

注意:

この変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Portal)を再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

15.4.5.2 WLSTを使用したOracle SES接続の削除

WLSTコマンドのdeleteConnectionを使用して、Oracle SES接続を削除します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのdeleteConnectionに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

この変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Portal)を再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

15.5 WebCenter Portalを検索するためのOracle SESの構成

この項では、WebCenter Portal用にOracle SESを設定するために必要な手順について説明します。次のトピックが含まれています:

- Oracle SESのためのWebCenter Portalの設定

- Oracle SESのためのOracle WebCenter Content Serverの設定

- Oracle SESのためのOracle WebCenter Portalディスカッション・サーバーの設定

- WebCenter Portalを検索するためのOracle SESの設定

- WLSTを使用したOracle SESのバージョンの構成

- WLSTを使用した検索クローラの構成

注意:

Oracle SESを検索エンジンとして有効にするために実行する必要があるタスクの概要は、「WebCenter PortalでのOracle SESの構成ロードマップ」を参照してください。必要なタスクを実行する方法や順序が複数ある場合があります。

関連項目:

Oracle SESを使用した検索について

15.5.1 Oracle SESのためのWebCenter Portalの設定

この項では、Oracle SESと連動するようWebCenter Portalを構成する方法について説明します。

1. WebCenter PortalとOracle SES間の接続を作成および構成し、オプションとしてソース・グループを指定します。

関連項目:

「WLSTを使用したOracle SES接続の登録」および「WLSTを使用したOracle SES接続の詳細の変更」

2. Oracle SESを使用してポータル、リストまたはページ・メタデータを検索するには、まずWebCenter Portalおよびバックエンドのアイデンティティ管理サーバー(mycrawladminなど)で、クロール管理ユーザーを作成する必要があります。クロール管理ユーザーは一度だけ作成する必要があります。

注意:

ユーザーの作成方法の詳細は、ご使用のアイデンティティ管理システムのドキュメントを参照してください。

次の例では、Oracle Directory Services Managerを使用してmycrawladminユーザーを作成します。

a. 「データ・ブラウザ」タブで、ターゲットcnに移動し、「作成」をクリックします。この例では、「dc=com,dc=oracle,dc=us,cn=Users」に移動します。「オブジェクト・クラスの追加」ダイアログで、該当するオブジェクト・クラスを選択し、「OK」をクリックします。(図15-7)。

図15-7 Oracle Directory Services Manager - 「オブジェクト・クラスの追加」

b. 識別名(DN)パスを見つけて、「選択」(図15-8)をクリックします。この例では、「dc=com,dc=oracle,dc=us,cn=Users」を選択します。

図15-8 Oracle Directory Services Manager - DNパスの選択

c. 「新規エントリの作成」ダイアログで、プロパティを入力し、「次へ」をクリックします(図15-9)。

図15-9 Oracle Directory Services Manager - 「新規エントリの作成」

d. 新規エントリが正常に作成されたことを確認したら、「終了」をクリックします。(図15-10)

図15-10 Oracle Directory Services Manager - 「ステータス」

3. 「Oracle SES - 構成」で作成したクロール管理ユーザーにクロール・アプリケーション・ロールを付与します。例:

grantAppRole(appStripe="webcenter",
appRoleName="webcenter#-#defaultcrawl",
principalClass="weblogic.security.principal.WLSUserImpl",
principalName="mycrawladmin");

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスを参照してください。

注意:

WLSTの変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Portal)を再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のスクリプトを使用した管理対象サーバーの起動および停止に関する項を参照してください。

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_Portal1"のようになります。

次の例は、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 "/WebCenter1221"
The Documents repository administrator is "sysadmin"
The Documents application name is "WC1221"
The Documents primary connection is "stxxl18-ucm12g"

注意:

返されるアプリケーション名とプライマリ接続を記録してください。これらの値は、後で(「ドキュメントを検索するためのOracle SESの設定」で) Oracle SESでドキュメントをクロールするよう設定する際に必要になります。

注意:

WLSTの変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Portal)を再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のスクリプトを使用した管理対象サーバーの起動および停止に関する項を参照してください。

15.5.1.1 WLSTを使用した検索パラメータの構成

WLSTコマンドのsetSearchConfigを使用して、検索パラメータを変更します。

次の例は、Oracle SESを検索するデータ・グループ(ソース・グループとも呼ばれる)を指定する方法を示しています。

例: ソース・グループの設定

setSearchSESConfig(appName='webcenter',
dataGroup='mySources')

ここで、dataGroupは、「追加のOracle SES構成」で作成したソース・グループです。

次の例は、表示される検索結果数を増加させる方法を示しています。Oracle SESの結果で表示される検索結果数のデフォルトの設定は5ですが、一般的に設定される結果数は5より大きくなります。

例: 表示される検索結果数の増加

setSearchConfig(appName='webcenter',
numResultsMain=10)

次の例は、サービスが検索を実行するために許可される最大時間(ミリ秒)を構成する方法を示しています。サービスがいつタイムアウトするかは、主にシステムの負荷に依存します。常にタイムアウト・エラーが生じる場合は、このパラメータを調整してください。

例: WebCenter Portalで検索結果を待機する最大時間の構成

setSearchConfig(appName='webcenter',
executionTimeout=10000)

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetSearchConfigに関する項を参照してください。

15.5.1.2 Fusion Middleware Controlを使用した検索パラメータとクローラの構成

Fusion Middleware Controlを使用して、Oracle SESを有効化または無効化したり、検索設定を構成できます。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「アプリケーション構成」を選択します。

3. 「検索クローラ」セクション(図15-11)で、オプションでWebCenter Portalコンテンツをクロールする頻度を指定し、「適用」をクリックします。

デフォルトでは、スペース・クローラのフル・クロールは7日ごとに発生しますが、別の頻度を指定することもできます。(3つのクローラすべてにおいて、増分クロールはOracle SESで設定されたスケジュールによって開始されます。)

- 図15-11 WebCenter Portal検索のアプリケーション設定

4. 同じページで、必要に応じて「検索設定」パラメータを構成し、「適用」をクリックします。

- Oracle Secure Enterprise Searchデータ・グループ: 検索するOracle SESソース・グループを指定します。値を指定しない場合、Oracle SESインスタンス内のすべてが検索されます。

- 実行タイムアウト: サービスが検索を実行できる最大時間(ミリ秒単位)を入力します。

- 実行者の準備タイムアウト: サービスが検索を初期化できる最大時間(ミリ秒単位)を入力します。

- サービス当たりの結果数 - 保存済検索タスク・フロー: 保存済検索タスク・フローに表示される、サービス当たりの検索結果数を入力します。

- サービス当たりの結果数 - 検索ページ: メインの検索ページから送信された検索に対して、サービスごとに表示する検索結果の数を入力します。すべての結果を表示する場合、ユーザーは「すべて表示」をクリックできます。

WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要はありません。

15.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ロールを持つユーザーでクロールする場合、クロール・ユーザーとして管理ユーザー・アカウントを使用します。

非管理ユーザーでクロールする場合、次の手順に従います。

a. sescrawlerroleロールを作成します。

b. ユーザーsescrawlerを作成し、これにsescrawlerroleロールを割り当てます。このユーザーがOracle SES内にContent Serverを作成します。

c. 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コンポーネントをコンテンツ・サーバーにインストールします(まだインストールされていない場合)。

a. システム管理者としてContent Serverにログオンします。例: http://host:port/cs。

b. 「管理」ドロップダウン・メニューから、「管理サーバー」(図15-12)を選択します。

図15-12 Content Serverの管理

c. インスタンス名のボタンをクリックします。

d. 左側のペインのメニュー・リストから「コンポーネント・マネージャ」をクリックします(図15-13)。

図15-13 Content Serverの「コンポーネント・マネージャ」

e. 「統合」の下の「SESCrawlerExport」を選択し、「更新」をクリックします。

f. 構成パラメータを入力します。(構成パラメータは、インストール後に変更することもできます。)
SESCrawlerExportにより提供される認証および認可APIのセキュリティを無効にします。つまり、「Secure APIの無効化」をfalseに設定します。これにより、SESCrawlerExportによって提供されるセキュリティが、Content Serverによってではなく内部的に実行されるようになります。

さらに、クラスタ化環境の場合のみ、feedLocパラメータで、Content Serverのノードによりアクセスされる共有ディスク上の場所を指定する必要があります。また、これらの各ノードは同じようにこの場所を参照する必要があります(例: sharedDrive/dir1/dir2)。これは指定されたデフォルトの場所(相対パス)ではないことに注意してください。

g. Content Serverを再起動します。

4. Content Serverリポジトリのスナップショットを撮ります。

a. システム管理者としてContent Serverにログオンします。例: http://host:port/cs。

b. 「管理」ドロップダウン・メニューから、「SESCrawlerExport」を選択します。

c. 「すべてのソース」を選択し、「スナップショットの取得」(図15-14)をクリックします。

図15-14 Content Serverのスナップショット

ソースの最初のクロールまたはその後のフル・クロールの前にスナップショットを撮ることは重要です。

スナップショットにより、コンポーネントのインストール時に指定された場所にconfigFile.xmlが生成され、feedLocの下のソース名のサブディレクトリにフィードが作成されます。

5. Content ServerがWebレンディションを使用するように構成されている場合、Content Serverメタデータ・リストにdFormat値が含まれるように構成し、必要なMIMEタイプがOracle SESにエクスポートされるようにする必要があります。これは、MIMEタイプで検索を絞り込めるようにするために必要です。
Content ServerがWebレンディション用に構成されている場合、Content Server内のアイテムはPDF形式でレンダリングされます。コンテンツ・アイテムのネイティブMIMEタイプのレンディションは上書きされます。たとえば、Microsoft Office WordドキュメントのMIMEタイプはapplication/mswordですが、Content ServerでWebレンディションを使用すると、MIMEタイプはapplication/pdfになります。Mimetypeパラメータをapplication/mswordに設定して検索問合せを実行しても、Wordドキュメントは返されません。

a. SESCrawlerExport管理ページに戻り、「SESCrawlerExportの構成」(図15-15)をクリックします。

図15-15 Content Serverのスナップショット

b. デフォルトでは、「メタデータ・リスト」フィールドは空白です(図15-16)。オプションで、必要な任意のカスタム・メタデータ値(xで始まる)をこのフィールドに追加します。たとえば、「メタデータ・リスト」の次のエントリには、カスタム属性が含まれています。

xCollectionID,xWCTags, xRegionDefinition

図15-16 Content Serverの「メタデータ・リスト」

6. ファセット検索用の「サムネイル・オプション」を構成します。

a. 「管理」タブで、「サムネイル・オプションの構成」を選択し、検索結果でのドキュメント・サムネイルを有効にします。

b. デフォルト設定のままにし、「更新」をクリックします(図15-17)。

図15-17 サムネイル・オプションの構成

関連項目:

Content Serverの構成の詳細は、製品に同梱のDeployment Guide.pdfを参照してください。

15.5.3 Oracle SESのためのOracle WebCenter Portalディスカッション・サーバーの設定

この項では、Oracle SESによりクロール可能となるようにディスカッション・サーバー(特に、WebCenter Portalがディスカッションおよびお知らせの格納に使用するディスカッション・サーバー)を構成する方法について説明します。

注意:

WebCenter Portal (Oracleデータベースを含む)およびOracle WebCenter Portalのディスカッション・サーバーの新しいインストールがある場合は、この手順は必要ありません。これは、アップグレードされた(パッチが適用された)インスタンスを使用している場合にのみ必要になります。

該当するデータ・ソースのデータベース・スキーマの詳細は、Oracle WebLogic Serverコンソールから検索できます。

ディスカッション・サーバーを構成する手順は次のとおりです。

1. リポジトリ作成ユーティリティ(RCU)を実行して、ディスカッション・クローラのWebCenter Portalコンポーネントがシステムにインストールされていることを確認します。

2. OracleデータベースおよびMicrosoft SQL Serverデータベースの場合は、MyPrefix_DISCUSSIONSユーザーがRCUにインストールされていることを確認することによって、Oracle WebCenter Portalのディスカッション・サーバーのバック・エンドが適切に構成されていることを検証します。MyPrefix_DISCUSSIONS_CRAWLERユーザーがRCUにインストールされていることを確認することによって、ディスカッション・クローラが適切に構成されていることを検証します。

3. ディスカッション・クローラ・コンポーネントがインストールされていない場合、RCUを使用してこれをインストールする必要がありますが、このとき、接頭辞は、Oracle WebCenter Portalのディスカッション・サーバー・コンポーネントと同じものを選択します。また、RCUでの表領域の指定手順で、デフォルトの表領域としてPrefix_IAS_DISCUSSIONSを選択します。これにより、Oracle SESのユーザーがインストールされます。

15.5.4 WebCenter Portalを検索するためのOracle SESの設定

この項の手順は、Oracle SES管理ツールで実行する必要があります。

次の手順が必要です。

1. Oracle SES管理ツールへのログオン

2. ドキュメントを検索するためのOracle SESの設定

3. ディスカッションおよびお知らせを検索するためのOracle SESの設定

4. ポータル、リスト、人およびページ・メタデータを検索するためのOracle SESの設定

5. Oracle SESファセットおよびソート属性の構成

6. 追加のOracle SES構成

関連項目:

Oracle SESに必要なすべてのパッチがインストールされていることを確認します。必要なパッチの最新情報は、『Oracle WebCenter Portalのインストールおよび構成』の検索のバックエンド要件に関する項およびリリース・ノートを参照してください。

Oracle SES構成の詳細は、製品に付属のOracle SESドキュメントを参照してください。(これらは、Oracle Fusion Middlewareドキュメント・ライブラリのWebCenter Portal製品の領域にリストされています。)

15.5.4.1 Oracle SES管理ツールへのログオン

Oracle SES管理ツールを開きます。

1. ブラウザを開き、Oracle SESインストール後に指定されたURLを入力します。(これは、http://host:port/search/admin/index.jspの形式となります。)

2. Oracle SES管理ユーザー名とインストール時に指定されたパスワードでログオンします。

15.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属性名とタイプのリストを必ず確認してください。

a. 「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。

b. 「新規マネージャの作成」を選択し、「次へ」をクリックして次のパラメータを入力します(図15-18)。

- マネージャ・クラス名: 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がインストールされます。

図15-18 Oracle SESでのドキュメント・サービス・マネージャの作成

c. 「次へ」をクリックして、「完了」をクリックします。

d. ドキュメント・サービス・インスタンスを作成します。

- 「グローバル設定」→「ドキュメント・サービス」ページで、「作成」をクリックします。

- 「選択対象」の「使用可能なマネージャ」でSecure Enterprise Search WebCenter UCMプラグインを選択し、「次へ」をクリックします(図15-19)

図15-19 ドキュメント・サービスの作成

- パラメータは次の要領で指定してください。

オプション

説明

インスタンス名

ドキュメント・パイプラインの作成中に使用する任意の名前をここに入力します。

WebCenterアプリケーション名

バックエンドContent ServerでこのWebCenter Portalアプリケーションを識別するために使用される一意の名前。

接続名

WebCenter Portalがドキュメントの保存に使用するプライマリContent Server接続の名前です。

WebCenter URL接頭辞

WebCenter Portalアプリケーションがデプロイされるホストおよびポート。例: http://myhost:8888

注意:

Fusion Middleware ControlまたはlistDocumentsSpacesPropertiesコマンドを使用して、「Oracle SESのためのWebCenter Portalの設定」の説明に従って、アプリケーション名と接続名を特定してください。

e. ドキュメント・サービス・パイプラインを作成します。これによりドキュメント・サービス・インスタンスが呼び出されます。

- 「グローバル設定」→「ドキュメント・サービス」ページで、「ドキュメント・サービス・パイプライン」セクションの下の「作成」をクリックします(図15-20)。

図15-20 ドキュメント・サービス・パイプラインの作成

f. 「ドキュメント・サービス・パイプラインの作成」ページで、このパイプラインのカスタム名を入力します。
前の手順で作成したドキュメント・サービス・インスタンスが「使用可能なサービス」の下にリストされるはずです。このドキュメント・サービス・インスタンスを選択し、矢印ボタンを使用してこれを「パイプラインで使用済」の下に移動します。

2. ドキュメントのContent Serverソースを作成します。

関連項目:

Content Serverソースを作成する別の方法は、「WLSTを使用した検索クローラの構成」を参照してください

a. 「ホーム」→「ソース」に移動します。

b. 「ソース・タイプ」ドロップダウン・リストで、「Oracle Content Server」を選択し、「作成」(図15-21)をクリックします。

図15-21 Content Serverソースの作成

c. 次のパラメータ情報を入力します(図15-22)。

図15-22 Oracle WebCenter Content Serverソースのパラメータ

パラメータ

説明

ソース名

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 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の場合、このフィールドは空白のままにします。

スクラッチ・ディレクトリ

オプション。Oracle SESインスタンスが配置されるシステム上のディレクトリを指定します。

d. 「次へ」をクリックします。

e. 「ユーザー定義ソースの作成 : ステップ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の場合、このフィールドは空白のままにします。

f. 「作成およびカスタマイズ」をクリックして(または作成したソースを編集して)、その他のソース・パラメータを参照します。

g. 「クロール・パラメータ」タブで、Document Service Pipelineと入力します。

h. 「有効化」をクリックして作成したパイプラインを選択します。

15.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のデータベースでは、手順が多少異なります。

1. JDBCドライバを構成します。

a. Microsoft SQL Serverデータベースをクロールするには、適切なJDBCドライバjarファイルをOracle SESのORACLE_HOME/search/lib/plugins/oracleapplicationsディレクトリにダウンロードします。

注意:

Microsoft SQL Serverの場合、Microsoft JDBCドライバ・ファイル、sqljdbc.jarおよびsqljdbc4.jarをコピーします。

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要素に追加します。

- 中間層を再起動します。

b. drivers.propertiesファイルをDatabaseName:DriverClassNameの情報を使用して更新します。

c. JRE 1.5 JDBCドライバJarファイル名を、appsjdbc.jarおよびDBCrawler.jarのMETA-INF/MANIFEST.MF内のクラスパスに追加します。
例: 変更前

Class-Path:  sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar

変更後

Class-Path:  sqljdbc.jar rsscrawler.jar  ../../pluginmessages.jar

変更前

Class-Path: appsjdbc.jar

変更後

Class-Path: 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. ディスカッション・ソースまたはお知らせソースを作成します。

関連項目:

これらのソースを作成する別の方法は、「WLSTを使用した検索クローラの構成」を参照してください

a. Oracle SESで、「ホーム」→「ソース」に進みます。

b. 「ソース・タイプ」ドロップダウン・リストで、「データベース」を選択し、「作成」(図15-23)をクリックします。

図15-23 データベース・ソースの作成

c. パラメータは次の要領で指定してください。

パラメータ

説明

ソース名

unique_name。たとえば、ディスカッション・フォーラムをクロールする場合、GS_Forums (お知らせをクロールする場合は、GS_Announcements)

データベース接続文字列

次のうち1つを入力してください。

- Oracleデータベース: 次のうち1つを入力してください。

- jdbc:oracle:thin:@host:port:sid

- jdbc:oracle:thin@host:port/serviceId

- Microsoft SQL Serverデータベース: jdbc:sqlserver://host_or_IP_address:port;database_nameと入力します

ユーザーID

次のうち1つを入力してください。

- Oracleデータベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DISCUSSIONS_CRAWLER

- Microsoft SQL Serverデータベース: Oracle WebCenter Portalのディスカッション・サーバーのインストール時に作成されたユーザーMyPrefix_DISCUSSIONS_CRAWLER

パスワード

このユーザーのパスワード

問合せ

次のいずれかの問合せを入力します。

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
注意: 以前のリリースのコンテンツ・サーバーでは、「セキュリティ属性の付与」にFORUMIDが使用されていました。

d. 「次へ」をクリックします。

e. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページの「認可マネージャ」セクションで次のパラメータを入力します(事前に移入されていない場合)。

パラメータ

説明

プラグイン・クラス名

oracle.search.plugin.security.auth.db.DBAuthManager

JARファイル名

oracleapplications/DBCrawler.jar

認可データベース接続文字列

次のうち1つを入力してください。

- Oracleデータベース: 次のいずれかを入力します。

- jdbc:oracle:thin:@host:port:sid

- jdbc:oracle:thin@host:port/serviceId

- Microsoft SQL Serverデータベース: jdbc:sqlserver://host_or_IP_address:port;database_nameと入力します

ユーザーID

次のうち1つを入力してください。

- Oracleデータベース: ユーザーMyPrefix_DISCUSSIONS_CRAWLERを入力します

- Microsoft SQL Serverデータベース: ユーザーMyPrefix_DISCUSSIONS_CRAWLERを入力します

パスワード

このユーザーのパスワード

単一レコード問合せ

false

認可問合せ

(1行で)次のように入力します。

SELECT DISTINCT forumID as WCSECATTR
FROM AUTHCRAWLER_FORUM_VW
WHERE username = LOWER(?) UNION SELECT DISTINCT -1 as WCSECATTR
FROM AUTHCRAWLER_FORUM_VW

SELECT DISTINCT forumID as WCSECATTR FROM AUTHCRAWLER_FORUM_VW WHERE username = LOWER(?)UNION SELECT DISTINCT -1 as WCSECATTR FROM AUTHCRAWLER_FORUM_VW
注意: 以前のリリースのコンテンツ・サーバーでは、次の認可問合せが使用されていました。

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アイデンティティ・プラグインを使用している場合は、このパラメータは空白のままにします。

f. 「作成」をクリックしてソースの作成を完了します。

15.5.4.4 ポータル、リスト、人およびページ・メタデータを検索するためのOracle SESの設定

この項では、Oracle WebCenterソースを作成する方法について説明します。

関連項目:

Oracle WebCenterソースを作成する別の方法は、「WLSTを使用した検索クローラの構成」を参照してください

1. 「ホーム」→「ソース」ページに移動します。

2. 「ソース・タイプ」ドロップダウン・リストで、「Oracle WebCenter」を選択し、「作成」(図15-24)をクリックします。

図15-24 Oracle WebCenterソースの作成

3. 次のソース・パラメータを入力します(図15-25)。

注意:

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とともに使用する方法の詳細は、「OAM 11gのインストールと構成」を参照してください

ソース名: unique_name

構成URL: host:port_of_WebCenterPortal/rsscrawl。例: http://myhost:8888/rsscrawl

認証タイプ: BASIC

ユーザーID: 「Oracle SES - 構成」で登録したクロール管理ユーザー。例: mycrawladmin

パスワード: クロール管理ユーザーのパスワード

レルム: jazn.com

Oracle SSOログインURL: このフィールドは空白のままにします。

Oracle SSOアクションURL: このフィールドは空白のままにします。

スクラッチ・ディレクトリ: オプション。Oracle SESインスタンスが配置されるシステム上のディレクトリを指定します。

最大接続試行回数: データ・フィードにアクセスするためまたはステータス・フィードをアップロードするための接続試行の最大数。

図15-25 Oracle WebCenterソースのパラメータ

4. 「次へ」をクリックします。

5. 「ユーザー定義ソースの作成 : ステップ2 : 認可」ページでは、「プラグイン・クラス名」および「認可エンドポイント」が事前に移入されています。「プラグイン・クラス名」は、oracle.webcenter.search.auth.plugin.WebCenterAuthManagerである必要があります。

次のプラグイン・パラメータを入力します。

Jarファイル名: webcenter/search-auth-plugin.jar (注意: これはデフォルト値から変更する必要があります。)

レルム: jazn.com

ユーザーID: 「Oracle SES - 構成」で登録したクロール管理ユーザー。例: mycrawladmin

パスワード: クロール管理ユーザーのパスワード

認可ユーザーID形式: アクティブなアイデンティティ・プラグインで使用される認証属性。この値を見つけるには、Oracle SESで、「グローバル設定 - アイデンティティ管理設定」ページに移動します。「アクティブ・プラグイン」の下の「認証属性」の値を入力します(たとえば、nickname、usernameなど)。Oracle E-Business Suite R12アイデンティティ・プラグインを使用している場合、このパラメータは空白のままにします。

6. 「作成」をクリックしてソースの作成を完了します。

15.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のカンマ区切りリストと同一に設定します。

例: ピープル・コネクション・プロファイルのクロールの無効化

http://host:port/rsscrawl?excludedServiceIds=oracle.webcenter.peopleconnections.profile

例: ページ・メタデータのクロールの無効化

http://host:port/rsscrawl?excludedServiceIds=oracle.webcenter.page

例: プロファイルおよびページ・メタデータのクロールの無効化

http://host:port/rsscrawl?excludedServiceIds=oracle.webcenter.peopleconnections.profile,oracle.webcenter.page

15.5.4.6 追加のOracle SES構成

この項では、Oracle SES管理ツールで必要な手順について説明します。

1. Content Server、ディスカッション、お知らせおよび作成したWebCenter Portalのソースの名前を含む、ソース・グループを作成します。

a. 「検索」→「ソース・グループ」に進み、「作成」をクリックします。

b. 「Oracle SESのためのWebCenter Portalの設定」で入力したソース・グループ名と同じ名前を入力します。

c. 「ソース・タイプの選択」ドロップダウン・リストから、各ソース・タイプ(Database、Oracle Content Server、Oracle WebCenter)を選択し、各ソース・タイプに対してリストされた「使用可能なソース」から、そのソース・タイプに対して作成したソースを「割り当てられたソース」リストに移動します。

d. 「終了」をクリックします。

2. 必要に応じて、セキュリティ・フィルタの有効期間を構成します。これにより、システム内のユーザーの認可ポリシーがリフレッシュされます。ユーザー・ポリシーが頻繁に変更される場合は、有効期間を短くするのが最適です。(この章では、例としてOracle Internet Directoryアイデンティティ・プラグインを使用しています。)
たとえば、「グローバル設定」→「問合せ構成」ページの「セキュア検索の構成」の下で、「セキュリティ・フィルタ有効期間(分)」に0を入力します。

セキュリティ・フィルタ有効期間の有効な値は、0分(キャッシュなし)から526500分(1年間のキャッシュ)です。

3. すべてを索引付けするには、各ソースに対してフル・クロールを強制する必要があります。つまり、各ソースの既存の増分クロール・スケジュールを、まずすべてのドキュメントを処理するように変更する必要があります。
この手順は非常に重要で、これで、コンテンツが最初に完全に索引付けされるまで、検索が機能しなくなります。

注意:

WLSTでfullCrawlIntervalInHoursパラメータを使用して、またはFusion Middleware ControlでFull Crawl Intervalパラメータを使用してスペース・クローラのスケジュールを設定できます。

「ホーム」→「スケジュール」ページに進み、ソース・スケジュールを選択して「編集」をクリックし、フル・クロールを強制します。

各ソースのクロールが完了したら、同じページに戻り、クロール・ポリシーを増分(前回のクロール以降に変更されたドキュメントを索引付けする)に戻します。また、このページの「頻度」セクションで、増分クロールの実行に手動以外のタイプ(毎週、毎日など)を選択します。

注意:

Content Serverの最初のクロールの前に、Content Serverの「管理」ページに進み、「SESクローラ・エクスポート」を選択してスナップショットを撮ることを忘れないでください。詳細は、「Oracle SESのためのOracle WebCenter Content Serverの設定」を参照してください。

15.5.4.7 Oracle SESファセットおよびソート属性の構成

ファセットは、新しい検索を実行せずにインデックス化されたデータを移動することによってユーザーが検索を詳細設定できるOracle SESオブジェクトです。まず、Oracle SESで(提供されるファイルを使用して)ファセットを定義する必要があります。Oracle SESで定義されたファセットは、「ツールとサービス」→「検索」管理ページを使用して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スクリプトは必須です。WebCenter Portalで検索するには、Oracle SESでのファセット作成のみでは不十分です。

また、Scope GUIDおよびService IDファセットは必須です。ファセット名では、大/小文字が区別されます。これらのファセット名を正確に指定する必要があります。

これらのファイルを実行した後、Oracle SES管理ツールの「グローバル設定」→「ファセット」ページにファセットを表示できます(図15-26)。

図15-26 Oracle SESファセット

1. 新しいファセットを作成するには、「グローバル設定」→「ファセット」ページで「作成」をクリックします。

2. ファセット値の生成元であるファセットの名前および検索属性を入力します。
「文字列」ファセット・タイプには、パス・デリミタも入力する必要があります。これは、選択したファセット・ツリー・ノードのファセット・ツリー階層を問合せページに表示するための境界用に使用する1文字で、たとえば、"tools/power tool/drills"の"/"がパス・デリミタです。ファセット・ツリーが1レベルの深さの場合(つまりこのノードに子ノードがない場合)、これを空白に設定できます。

3. 「作成してカスタマイズ」をクリックしてファセットを作成し、「ファセットの編集」ページでこのノードを構成します。
日付タイプまたは数値タイプのファセットのファセット・ノードを構成できます。たとえば、「最終変更日」ファセットの場合、「昨年」、「先月」、「今日」、特定の2つの日付の間などのノードを作成できます。「ノード構成」タブには、ファセット階層がツリー形式およびXML形式で表示され、ここで選択したファセット・ノードの子ノードを追加、編集および削除できます。

注意:

Scope GUIDファセットまたはService IDファセットは変更または削除しないでください。

4. ファセット・ノードを編集した後、「適用」をクリックして変更内容を保存します。

Oracle SESで行われた変更は、ポータル・マネージャが「ツールとサービス」→「検索」管理ページに移動するとWebCenter Portalで適用されます。WebCenter Portalでは、この「検索」管理ページが開くまでファセットの変更が検出されません。WebCenter Portalでは、使用するために選択したファセットがポータルごとに記憶されます。

15.5.5 WLSTを使用したOracle SESのバージョンの構成

WLSTコマンドのsetSESVersionを実行して、デフォルトの接続に関連付けられたOracle SESインスタンスのバージョン情報を取得して、格納する必要があります。このコマンドにより、ファセット検索と、「ツールとサービス」→「検索」管理ページが有効になります。このページは、Oracle SES 11.2.2.2を使用した検索の設定をカスタマイズするために必要になります。Oracle SESのバージョンが正しく設定されていることを確認するには、WLSTコマンドのlistSESVersionを実行します。

例15-1に、これらのコマンドを示します。完全なコマンドの構文と例は、『WebLogic Server WLSTコマンド・リファレンス』のsetSESVersionに関する項およびlistSESVersionに関する項を参照してください。

例15-1 ファセット問合せと「ツールとサービス」の「検索」管理ページの有効化

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')

15.5.6 WLSTを使用した検索クローラの構成

WLSTコマンドを使用して、クローラを作成したり、クローラのスケジュールを開始、停止および削除できます。これらのコマンドでは、Oracle SES内の新しいデータをクロールしたり、構成データが変更されると古いクローラを削除できます。

次の例に、これらのコマンドの一部を示します。詳細は、WebCenter WLSTコマンド・リファレンスのcreateSpacesCrawlerに関する項を参照してください。

例: 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')

例: 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')

例: 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のデフォルトの管理ユーザー名)ですが、インストール中に別の名前も指定できます。

- WLSTの変更を反映させるには、アプリケーションがデプロイされている管理対象サーバー(デフォルトではWC_Portal)を再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のスクリプトを使用した管理対象サーバーの起動および停止に関する項を参照してください。

15.6 WebCenter Portal管理での検索の管理

システム管理者は、WebCenter Portal管理の「検索」ページを使用して、ホーム・ポータルまたはすべてのポータルの検索を構成できます。ポータル・マネージャは、管理するポータルの検索設定をリセットできます。

1. WebCenter Portalの管理ページを開きます(「WebCenter Portal管理の設定ページへのアクセス」を参照)。

2. 「ツールとサービス」をクリックし、「検索」を選択します。
検索設定ページが開きます(図15-27)。

図15-27 WebCenter Portal管理: 検索の構成

3. ファセットがサポートされたOracle Secure Enterprise Search 11.2.2を使用するために、「ファセットがサポートされた新規検索タスク・フローを使用します」(デフォルトで選択)が選択されていることを確認します。

このチェック・ボックスを選択解除する場合は、「検索 - 非ファセット検索」タスク・フロー(ファセットのかわりにリファイナを使用)を使用します。これを実行すると、このページの次回アクセス時にこのページの残りの設定がグレー表示され、「検索 - 非ファセット検索」タスク・フロー・パラメータで検索設定を構成することが必要となります。

注意:

ポータル・マネージャは、アプリケーションレベルで構成された設定に関係なく、自分のポータルのファセットまたは非ファセット検索を設定できます。

最適なパフォーマンスとスケーラビリティに加えて、ファセットのサポートと容易な構成のためには、Oracle SESリリース11.2.2.2以降で新しい「検索 - ファセット検索」タスク・フローを使用するようアプリケーションを構成してください。ただし、アップグレードされたインスタンスで、特定の機能を保持するために、古い「検索 - 非ファセット検索」タスク・フローを引き続き使用するよう選択する場合もあります。

Oracle SES 11.1.2は使用できますが、この現行リリースではサポートされなくなりました。

関連項目:

以前のWebCenter Portal/Oracle SESインスタンスからアップグレードしており、ファセット・サポートを備えた新しい検索タスク・フローを使用するよう選択している場合、以前の検索のユーザー・プリファレンスは「検索」管理ページ上の設定によってオーバーライドされます。以前のカスタマイズの内容を保持するには、「検索」管理ページでそれらのカスタマイズをリセットする必要があります。

4. 「フィルタリング・ドロップダウンの有効化」チェック・ボックスを選択して、ユーザーに表示する結果のタイプを選択します。
「フィルタリング・ドロップダウンの有効化」チェック・ボックスを選択すると、ユーザーは、「すべて」の検索ではなく、「含める」列で選択した特定のサービスを検索できます。フィルタリングの構成の詳細は、『Oracle WebCenter Portalでのポータルの構築』のファセット検索でのフィルタリング・ドロップダウンの構成に関する項を参照してください。

注意:
ポータル・マネージャは、管理するポータルごとに異なるフィルタリング・ドロップダウン構成ができます。

5. 「ホーム・ポータル」など、ホーム・ポータルのみまたはすべてのポータルの検索結果を含めるように「検索スコープ」を設定します。

6. 検索結果とともに表示するファセットを選択します(『Oracle WebCenter Portalでのポータルの構築』のファセットの構成に関する項を参照)。

Oracle SES内でまずファセット(必須のScope、GUIDおよびServiceIDファセットを含む)を構成する必要があります。システム管理者は、Oracle SES内でファセットを作成、変更、および削除します。(WebCenter Portalでは、この検索管理ページが開くまでファセットの変更が検出されません。)詳細は、「ポータル、リスト、人およびページ・メタデータを検索するためのOracle SESの設定」を参照してください。

注意:

検索結果ページには、Oracle SES管理ツールの「グローバル設定」→「ファセット名の翻訳」ページで指定された翻訳に従ったファセット名が表示されます。ファセット名は、ユーザー・ロケールで翻訳された名前です。ただし、WebCenter Portalの「検索」管理ページには、基本ファセット名(つまり、翻訳されていない名前)が表示されます。例外は「ポータル」ファセット名で、これはOracle SESではなくWebCenter Portalで指定された翻訳に従います。

7. 「カスタム属性」セクションでは、「含める」セクションに属性を移動して、検索結果に表示されるカスタム検索属性と、それらの属性の表示順序を選択できます。
(標準ではなく)カスタム属性の構成の詳細は、『Oracle WebCenter Portalでのポータルの構築』のカスタム属性による検索結果の強化に関する項を参照してください。

8. 「適用」をクリックして設定を保存します。

16 サブスクリプションおよび通知の管理

この章では、サブスクリプションおよび通知の管理方法について説明します。管理者は、アプリケーションレベルのサブスクリプションに対するアプリケーション全体のデフォルトを作成し、そのデフォルトを強制適用することもできます。また、通知配信の処理用サーバーを特定する接続タイプを指定し、WLSTコマンドを使用して通知メッセージング構成の詳細を設定および取得できます。

この章の内容は次のとおりです。

- サブスクリプションおよび通知について

- デフォルトのサブスクリプション・プリファレンスの設定

- 通知の設定

- カスタム通知テンプレートの作成および適用

- 通知接続のテスト

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。WebCenter Portalでは、WebCenter Portal管理でAdministratorロールが付与されます。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

16.1 サブスクリプションおよび通知について

WebCenter Portalでは、サブスクリプションおよび通知を使用することで、興味のあるサービスやアプリケーション・オブジェクトのタイプをサブスクライブできます。したがってユーザーは、サブスクライブしたサービスやオブジェクトに影響する変更について、選択したメッセージング・チャネルから適時に通知を受信します。

関連項目:

ポータルに通知機能を追加する方法は、『Oracle WebCenter Portalでのポータルの構築』のポータルへの通知の追加に関する項を参照してください。

WebCenter Portalのバックエンド・サービスを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。デプロイ後にWebCenter Portalに加えた変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用して行った、WebCenter Portalツールおよびサービス構成のほとんどの変更は、動的ではありません。変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

16.2 デフォルトのサブスクリプション・プリファレンスの設定

WebCenter Portalユーザーは、WebCenter Portalの「プリファレンス」ダイアログで各自のサブスクリプション・プリファレンスを設定します。その前に、WebCenter Portal管理者がデフォルト値を設定し、すべてのユーザーが使用できるアプリケーションレベルのサブスクリプション・オプションを指定して、それらのデフォルトを変更可能かどうかを決定できます。

この項では、サブスクリプションのデフォルトの概要を示し、そのデフォルト値の設定手順について説明します。

この項では、次の内容について説明します。

- サブスクリプションのデフォルトについて

- サブスクリプションのデフォルトの設定

- WebCenter Portalでのサブスクリプション・プリファレンスの設定

16.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

これらの属性が連動して、「プリファレンス」のサブスクリプションページの「一般サブスクリプション」タブの初期状態が決まります(図16-1)。

図16-1 「プリファレンス」 - 「サブスクリプション」: 「一般サブスクリプション」ページ

表16-1に、管理者レベルのカスタム・サブスクリプション設定が「一般サブスクリプション」タブの表示に及ぼす効果を示します。

表16-1 管理者のデフォルトがサブスクリプション・プリファレンスに及ぼす影響

subscription-enabled(1)

end-user-configurable

プリファレンス内のオプション

True

True

通常のレンダリング、チェック・ボックスが選択された状態

True

False

灰色表示、チェック・ボックスが選択された状態

False

True

通常のレンダリング、チェック・ボックスが選択されていない状態

False

False

非表示、チェック・ボックスが非表示の状態。

ヒント:

表16-1で、ほとんどの通知に最も一般的なシナリオはfalse/trueです(3行目)。

表16-2に、アプリケーションレベルの通知をトリガーできるアクションのタイプと、対応するサービスIDを示します。

表16-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

16.2.2 サブスクリプションのデフォルトの設定

アプリケーションレベルのサブスクリプション・プリファレンスのデフォルトを設定する手順は次のとおりです。

1. パスに/oracle/webcenter/notificationが含まれるディレクトリに移動し、フォルダcustomを作成します。

ヒント:

このディレクトリ構造は、パスに/oracle/webcenter/notification/customが含まれてさえいれば、任意のディレクトリで開始または終了できます。

2. customフォルダ、つまり/oracle/webcenter/notification/custom/の下の任意のサブディレクトリに、ファイルnotification-service-settings.xmlを作成します。

3. この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コマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

例:

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以下のすべてのパスとファイルを指定しています。

WLSTコマンドのimportMetadataの詳細は、『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』のimportMetadataに関する項を参照してください。

表16-3に、サービスID oracle.webcenter.peopleconnections.connectionsに対する様々な設定の組合せの効果を示します。

表16-3 コネクションのサブスクリプション構成の効果

subscription-enabled

end-user-configurable

効果

true

true

- サブスクライブしているユーザーに他のユーザーがコネクションへの招待を送信した場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できます。

true

false

- サブスクライブしているユーザーに他のユーザーがコネクションへの招待を送信した場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できません。[2]

false

true

- サブスクライブしているユーザーに他のユーザーがコネクションへの招待を送信した場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- ユーザーはこのデフォルト設定を変更できます。

false

false

- サブスクライブしているユーザーに他のユーザーがコネクションへの招待を送信した場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- このデフォルト設定を変更するオプションは非表示になっています。

表16-4に、サービスID oracle.webcenter.peopleconnections.wallに対する様々な設定の組合せの効果を示します。

表16-4 メッセージ・ボードのサブスクリプション構成の効果

subscription-enabled

end-user-configurable

効果

true

true

- 他のユーザーがサブスクライブしているユーザーのメッセージ・ボードにメッセージを投稿、メッセージ・ボード上の投稿をお気に入り登録、またはメッセージ・ボード上の投稿にコメントした場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できます。

true

false

- 他のユーザーがサブスクライブしているユーザーのメッセージ・ボードにメッセージを投稿、メッセージ・ボード上の投稿をお気に入り登録、またはメッセージ・ボード上の投稿にコメントした場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できません。

false

true

- 他のユーザーがサブスクライブしているユーザーのメッセージ・ボードにメッセージを投稿、メッセージ・ボード上の投稿をお気に入り登録、またはメッセージ・ボード上の投稿にコメントした場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- ユーザーはこのデフォルト設定を変更できます。

false

false

- 他のユーザーがサブスクライブしているユーザーのメッセージ・ボードにメッセージを投稿、メッセージ・ボード上の投稿をお気に入り登録、またはメッセージ・ボード上の投稿にコメントした場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- このデフォルト設定を変更するオプションは非表示になっています。

表16-5に、サービスID oracle.webcenter.peopleconnections.kudosに対する様々な設定の組合せの効果を示します。

表16-5 フィードバックのサブスクリプション構成の効果

subscription-enabled

end-user-configurable

効果

true

true

- 他のユーザーがサブスクライブしているユーザーに対するフィードバックを残した場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できます。

true

false

- 他のユーザーがサブスクライブしているユーザーに対するフィードバックを残した場合、サブスクライブしているユーザーは通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できません。

false

true

- 他のユーザーがサブスクライブしているユーザーに対するフィードバックを残した場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- ユーザーはこのデフォルト設定を変更できます。

false

false

- 他のユーザーがサブスクライブしているユーザーに対するフィードバックを残した場合、サブスクライブしているユーザーは通知メッセージを受信しません。

- このデフォルト設定を変更するオプションは非表示になっています。

表16-6に、サービスID oracle.webcenter.communityに対する様々な設定の組合せの効果を示します。

表16-6 ポータル管理のサブスクリプション構成の効果

subscription-enabled

end-user-configurable

効果

true

true

- ユーザーのポータル・メンバーシップ・ロールが変更された場合、ユーザーがポータルのメンバーとして追加された場合、またはユーザーがポータルのメンバーから削除された場合にサブスクライブしているユーザーは、通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できます。

true

false

- ユーザーのポータル・メンバーシップ・ロールが変更された場合、ユーザーがポータルのメンバーとして追加された場合、またはユーザーがポータルのメンバーから削除された場合にサブスクライブしているユーザーは、通知メッセージを受信します。

- ユーザーはこのデフォルト設定を変更できません。

false

true

- ユーザーのポータル・メンバーシップ・ロールが変更された場合、ユーザーがポータルのメンバーとして追加された場合、またはユーザーがポータルのメンバーから削除された場合にサブスクライブしているユーザーは、通知メッセージを受信しません。

- ユーザーはこのデフォルト設定を変更できます。

false

false

- ユーザーのポータル・メンバーシップ・ロールが変更された場合、ユーザーがポータルのメンバーとして追加された場合、またはユーザーがポータルのメンバーから削除された場合にサブスクライブしているユーザーは、通知メッセージを受信しません。

- このデフォルト設定を変更するオプションは非表示になっています。

16.2.3 WebCenter Portalでのサブスクリプション・プリファレンスの設定

各ユーザーは、WebCenter Portalの「プリファレンス」で、各自のサブスクリプション・プリファレンスを設定します。この目的のために、次の2つの「プリファレンス」ページが用意されています。

- サブスクリプション: 自分のポータル・メンバーシップやピープル・コネクション・サービス(コネクション、メッセージ・ボードおよびフィードバック)で発生するアクションについて通知を受けるためにサブスクライブしたり、アプリケーションレベルやオブジェクトレベルの自分のサブスクリプションを表示および削除できます
詳細は、『Oracle WebCenter Portalの使用』のアプリケーション、ポータルおよびオブジェクトへのサブスクライブに関する項を参照してください。

- メッセージング: 優先するメッセージング・チャネルおよびフィルタを構成するための各コントロールにアクセスできます(BPEL接続タイプのみ)。
詳細は、『Oracle WebCenter Portalの使用』のメッセージング・チャネルおよびフィルタの設定と管理に関する項を参照してください。

16.3 通知の設定

この項では、メッセージング接続タイプの概要を示すとともに、通知チャネルを定義する前に満たしておく必要がある前提条件、および通知で使用する通知チャネルを設定する手順について説明します。次のサブセクションが含まれます:

- 接続チャネルについて

- 通知の前提条件

- 通知の構成ロードマップ

- Fusion Middleware Controlを使用した通知チャネルの指定

- WLSTを使用した通知チャネルの指定

- 例: WLSTを使用したWebCenter Portalのメール通知の設定

16.3.1 接続チャネルについて

通知の接続タイプによって、ユーザーがWebCenter Portalで各自の通知用のメッセージング・プリファレンスを構成するときに使用できるメッセージング・チャネルが決まります。

次の2つの接続タイプ候補のうち、いずれかを使用します。

- BPELサーバー: メールおよびショート・メッセージ・サービス(SMS)の2つのメッセージング・チャネル・オプションを提供します。

- メール・サーバー: WebCenter Portal用に構成されたメール・サーバーのみを経由して通知メッセージを配信します。

BPELサーバー接続タイプ

BPELサーバーを選択する場合、ユーザー・メッセージング・サービス(UMS)が利用可能なBPELサーバーへの接続が確立されていることが前提となります。BPELサーバーへの接続の詳細は、「WebCenter Portalメンバーシップ・ワークフローに対するSOA接続の管理」を参照してください。

WebCenter PortalでsetSpacesWorkFlowConnectionNameが設定されている場合、WebCenter Portalの「プリファレンス」の「メッセージング」パネルで、「構成の管理」ボタンが使用可能になります。

ヒント:

通知にBPELサーバーを使用する場合は、setSpacesWorkFlowConnectionNameで使用する接続と同じ接続を、通知でも使用してください。

メール・サーバー接続タイプ

メール・サーバーを選択する場合、メール・サーバーへの接続が確立されていることが前提となります。さらに、メール・サーバー接続と関連付けられている外部アプリケーションが共有資格証明を含んでいる必要があります。メール・サーバーへの接続の詳細は、「メールの管理」を参照してください。

選択した接続タイプがメール・サーバーの場合、WebCenter Portalの「プリファレンス」の「メッセージング」パネルで「構成の管理」ボタンが灰色表示される場合とされない場合があります。これは、spacesWorkFlowConnectionを設定したかどうかによります。これとは関係なく、選択した接続タイプがメール・サーバーで、メッセージング・プリファレンスの「構成の管理」ボタンをクリックしてユーザー・メッセージング・プリファレンスを開いた場合、行った変更はすべて無視されます。

関連項目:

『Oracle WebCenter Portalの使用』のメッセージング・チャネルおよびフィルタの設定と管理に関する項

16.3.2 通知の前提条件

通知の接続タイプを定義する前に、次の各項で説明する点を考慮し、指定の手順を実行する必要があります。

- インストール

- 構成

- セキュリティ

- 制限事項

16.3.2.1 インストール

通知に関連するインストールの要件は、通知メッセージングに選択する接続タイプによって異なります。

通知メッセージングにBPEL接続経由でユーザー・メッセージング・サービス(UMS)を使用する場合、デフォルトではメール・ドライバのみがインストールされていることに注意ください。SMSメッセージング・チャネルを使用するには、これらに対応するドライバもインストールする必要があります。

通知メッセージングにメール・サービスを使用する場合、通知に固有のインストールは必要ありませんが、「メールの管理」の説明に従ってメール・サービスを構成する必要があります。

16.3.2.2 構成

通知の構成の前提条件も、通知メッセージングに選択する接続タイプによって異なります。

BPELサーバーの構成

ユーザーにメッセージング・チャネルのオプション(メールおよびショート・メッセージ・サービス(SMS))を用意する場合は、BPELサーバーへの接続が確立されている必要があります。通知では、ユーザー・メッセージング・サービス(UMS)によるマルチチャネル通知をサポートするためにSOAインストールが使用されます。UMSは、SOAドメインの一部としてインストールされます。初期設定では、メール・ドライバのみが構成されています。SMSドライバも使用可能ですが、デプロイする必要があります。

詳細は、『Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理』のWebCenter Portalメンバーシップ・ワークフローに対するSOA接続の管理に関する項を参照してください。

メール・サーバーの構成

ユーザーが常にメールでのみ通知を受けるようにする場合、メール・サーバーへの接続が確立されている必要があります。さらに、メール・サーバー接続と関連付けられている外部アプリケーションが共有資格証明を含んでいる必要があります。詳細は、「メールの管理」を参照してください。

メール通知は、各ユーザーのプロファイルで指定された優先言語で送信されます。ユーザーの優先言語が指定されていない場合は、サーバーのロケール設定がメール通知に使用されます。たとえば、サーバーが韓国ロケールで実行されており、ユーザーの優先言語が設定されていない場合、通知メールの言語は韓国語になります。

優先言語の設定の詳細は、『Oracle WebCenter Portalの使用』の優先表示言語の選択に関する項を参照してください。

16.3.2.3 セキュリティ

特に通知に関連するセキュリティの考慮事項はありません。

16.3.2.4 制限事項

アクティビティによっては、将来送信される通知タスクを作成するものがあります。たとえば、ユーザーが将来の有効日を指定したお知らせを作成すると、このお知らせが有効になったときに通知が送信されるように、WebCenter Portalアプリケーション・サーバーで通知タスクが作成されます。ただし、通知にメール・サービスを使用する場合は、WebCenter Portalアプリケーション・サーバーが再起動されたときに、将来の通知タスクは削除されます。

UMSは、音声やインスタント・メッセージなど、通知ではサポートされていない複数のメッセージング・チャネルをサポートしています。通知では、UMSからメールおよびSMSのみを使用します。

WebCenter Portalリリース12.2.1.0.0では、新しいドキュメント・サービス・タスク・フローが導入されました。新しいタスク・フローおよびサブスクリプションおよび通知の統合は、このリリースではサポートされていません。そのため、ドキュメント関連のアクティビティによって通知はトリガーされません。新しいドキュメント・タスク・フローおよびサブスクリプションおよび通知の統合は、今後のリリースで再導入される予定です。

16.3.3 通知の構成ロードマップ

図16-2および表16-7に、WebCenter Portalで通知サービスを動作させるための前提条件と必要な作業の概要を示します。

図16-2 通知サービスの構成

表16-7 通知の構成

担当者

タスク

サブタスク

ノート

管理者

1.通知のバックエンド・コンポーネントを設定します。

- BPELサーバーの設定

- メール・サーバーの設定

管理者

2.(メール・サーバーの場合のみ)外部アプリケーションを構成します。

- メール・サーバーへの外部アプリケーションの接続を作成します

- メール・サーバーの外部アプリケーションの共有資格証明を構成します

管理者

3.WebCenter Portalアプリケーションと選択したバックエンド・コンポーネント間の接続を作成または変更します

- BPELサーバーとの接続を作成します

- メール・サーバーとの接続を作成します

管理者

4.次のいずれかのツールを使用して、通知に使用する接続のタイプ(BPELまたはメール)を選択します。

- Fusion Middleware Control

- WLST

管理者

5.アプリケーションがデプロイされている管理対象サーバーを再起動します。

WebCenter Portalの場合は、WC_Portalを再起動します。

管理者

6.すべてのユーザーに対するデフォルトのサブスクリプション・プリファレンスを設定します

アプリケーション・スペシャリスト/エンド・ユーザー

7. アプリケーション内で通知を構成してテストします

- アプリケーション・スペシャリスト

- エンド・ユーザー

16.3.4 Fusion Middleware Controlを使用した通知チャネルの指定

Fusion Middleware Controlで通知メッセージの接続タイプを指定する手順は次のとおりです。

1. Oracle Fusion Middlewareにログインし、WebCenter Portalのホームページに移動します。
詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenterポータル」メニューから、「設定」→「アプリケーション構成」を選択します。

3. 「アプリケーション構成」ページで、下へスクロールしてページ下部の「通知」に移動し、アウトバウンド通知に使用する接続タイプとして「BPELサーバー」または「メール・サーバー」のいずれかを選択します。

4. 次の手順は、選択した接続タイプによって異なります。
「BPELサーバー」を選択した場合:

a. 「接続名」のリストから、その接続を設定するときに指定したBPELサーバーの名前を選択します。

b. 「送信者のメール・アドレス」フィールドに、すべての通知メッセージの送信元とするメール・アドレスを入力します。送信者のメール・アドレスは、対応するドメインからメッセージを送信するように構成されているドライバの少なくとも1つに一致する必要があります。

c. 「送信者のSMSアドレス」フィールドに、ユーザー・メッセージング・サービス(UMS)ですべての通信メッセージの送信元のドライバとして使用される4桁から6桁の数値を入力します。送信者のSMSアドレスは、対応するドメインからメッセージを送信するように構成されているドライバの少なくとも1つに一致する必要があります。

「メール・サーバー」を選択した場合は、「接続名」のリストからメール接続を選択します。

5. 変更を保存します。

6. 変更を有効にするために、WebCenter Portalがデプロイされている管理対象サーバーを再起動します。

16.3.5 WLSTを使用した通知チャネルの指定

WLSTコマンドのsetNotificationsConfigを使用して、通知で使用する接続タイプを構成します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetNotificationsConfigに関する項を参照してください。同ガイドのgetNotificationsConfigに関する項も参照してください。

関連項目:

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

この構成の更新は、MDSリポジトリに格納されます。構成の変更を有効にするには、アプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、『Oracle Fusion Middlewareの管理』のWLSTを使用した管理対象サーバーの起動および停止に関する項を参照してください。

16.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という名前の接続が作成されます。

詳細は、WebCenter WLSTコマンド・リファレンスの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)

詳細は、WebCenter WLSTコマンド・リファレンスのaddExtAppFieldに関する項を参照してください。

4. メール接続を作成します。

createMailConnection(appName='webcenter',name='NotificationSharedConn',
imapHost='<mailserver>',imapPort=143,
smtpHost='<mailserver>',smtpPort=25,
imapSecured=false,smtpSecured=false,
appId='NotificationSharedApp',default=1)

このコマンドにより、NotificationSharedConnという名前のメール接続が作成されます。

詳細は、WebCenter WLSTコマンド・リファレンスのcreateMailConnectionに関する項を参照してください。

5. メールを通知チャネルとして設定します。

setNotificationsConfig(appName='webcenter', type='MAIL',
name='NotificationSharedConn')

これにより、NotificationSharedConnが通知の送信時に使用されるメール接続として設定されます。

詳細は、WebCenter WLSTコマンド・リファレンスのsetNotificationsConfigに関する項を参照してください。

6. 変更を有効にするために、WebCenter Portalがデプロイされている管理対象サーバー(デフォルトではWC_Portal)を再起動します。

7. WebCenter Portalにログインし、「プロファイル」ページの「情報」タブに移動して、自分の電子メール・アドレスが「電子メール」フィールドに設定されていることを確認します。これは、通知が目的の電子メール・アドレスに送信されるようにするためです。

電子メール・アドレスが設定されていない場合は、「編集」をクリックし、「電子メール」フィールドに自分の電子メール・アドレスを指定したら、「保存」をクリックします。

8. 通知を受けるアクティビティをサブスクライブします。たとえば、「プリファレンス」ページに移動し、「サブスクリプション」をクリックして、「ポータル管理」を選択すると、メンバーシップやロールの変更に関する通知を受信できます。

9. サブスクライブしたアクティビティを実行して構成をテストします。たとえば、自分のロールをPortal Managerから別のカスタム・ロールに変更して通知をトリガーします。

16.4 カスタム通知テンプレートの作成および適用

ユーザーがメールで受信する通知メッセージには、コンテンツおよびコンテンツ表示用のデフォルトの書式があります。アプリケーション管理者は、デフォルトのかわりにカスタム・テンプレートを作成して適用することで、通知メッセージに独自の書式を設定できます。

この項では、通知メッセージ用のカスタム・テンプレートの作成に関する詳細について説明します。次のサブセクションが含まれます:

- デフォルト通知テンプレートの上書きについて

- デフォルト通知テンプレートの上書き

16.4.1 デフォルト通知テンプレートの上書きについて

WLSTコマンドを使用してMDSにアクセスし、defaultTemplate.xmlファイル(または右から左に記述する言語のサポートが必要な場合はdefaultTemplate_rtl.xmlファイル)を上書きすることで、サブスクリプションベースの通知メッセージのレイアウトとコンテンツをカスタマイズできます。

関連項目:

WLSTコマンドの実行方法の詳細は、「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/>は空のままにします。

次の例は、通知メッセージ・テンプレート・ファイルのデフォルトの内容を示しています。これを使用してカスタム・ファイルを作成できます。

注意:

これらのカスタム・ファイルの違いは、特に<style>タグ内にあり、そこで右揃えか左揃えかが指定されています。

例

<?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>

<?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>

16.4.2 デフォルト通知テンプレートの上書き

デフォルトの通知テンプレート(XMLファイル)を上書きして、通知メッセージの書式をカスタマイズする手順は次のとおりです。

1. ディレクトリを/tmp/repository/oracle/webcenter/notification/custom/templateという形式で作成します。

後でこれを使用して、ファイルをMDSにインポートし、元のアプリケーション・ファイルをオーバーライドします。

2. 作成したディレクトリに、defaultTemplate.xml (または右から左へ記述する言語テンプレートの場合はdefaultTemplate_rtl.xml)という名前のカスタムXMLファイルを作成します。

3. これらのデフォルト・ファイルの1つを編集したバージョンをカスタム・ファイルにコピーします。

4. WLSTコマンドのimportMetadata()を使用して、カスタム・ファイルをWebCenter PortalのMDSリポジトリにアップロードします。ネームスペースoracle/webcenter/notification/customを含む絶対パスにカスタム・ファイルを置いて元のファイルを上書きします。

例:

importMetadata(application='webcenter', server='WC_Portal', fromLocation='template-file-location', docs='/oracle/webcenter/notification/custom/template/defaultTemplate.xml')

注意:

WLSTコマンドのimportMetadaの詳細は、『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』のimportMetadataに関する項を参照してください。

template-file-locationは、完全修飾カスタム・ファイルが置かれているディレクトリを示します。完全修飾カスタム・ファイルは、通常、そのネームスペースに対応するMDSリポジトリ内のディレクトリ構造に置かれています。たとえば、ファイルが次のネームスペースに作成されているとします。

/tmp/repository/oracle/webcenter/notification/custom/template/defaultTemplate.xml

5. WLSTコマンドのimportMetadata()を実行して、カスタム・ファイルをWebCenter PortalのMDSリポジトリにアップロードします。

例:

importMetadata(application='webcenter', server='WC_Portal',
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というパスが少なくとも必要です。

6. WebCenter Portalを再起動します。

16.5 通知接続のテスト

一般に、管理者が設定した時点で通知が有効かどうかは、基礎となるメール接続またはBPEL接続に依存します。これらの接続をテストして有効であれば、その延長として通知接続の要件も満たされます。

ヒント:

メール接続のテストの詳細は、「メール・サーバー接続のテスト」を参照してください。

[1] subscription-enabled属性は、サブスクリプション機能全体を有効化または無効化するのではなく、単にプリファレンス・オプションの初期状態を設定します。たとえば、subscription-enabled="true"の場合は、WebCenter Portalの「プリファレンス」の関連付けられたサブスクリプション・オプションがデフォルトで選択されます。subscription-enabled="false"の場合、関連付けられたサブスクリプション・オプションはデフォルトで選択されません。

[2]
これは初期設定のデフォルトです

17 WebCenter Portalメンバーシップ・ワークフローに対するSOA接続の管理

この章では、WebCenter Portalからメンバーシップ・ワークフロー通知に対するSOA接続を構成および管理する方法について説明します。WebCenter Portalから、メンバーシップ承認と通知を構成して、Oracle BPM Worklistに表示されるようにできます。

WebCenter Portalのバックエンド・サーバーを確認および構成するには、常にFusion Middleware ControlまたはWLSTコマンド行ツールを使用してください。WebCenter Portalのデプロイ後に加えたすべての変更は、MDSメタデータ・ストアにカスタマイズとして格納されます。「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。

注意:

Fusion Middleware ControlまたはWLSTを使用して行ったSOA接続の変更は動的ではないため、変更を有効にするには、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

この章の内容は次のとおりです。

- WebCenter Portalワークフローのロードマップの構成

- BPEL接続について

- BPELサーバーの前提条件

- WebCenter PortalワークフローをホスティングするBPELサーバーの指定

- 電子メールで送信するWebCenter Portalワークフロー通知の構成

- OAMのWebcenter PortalワークフローURLの除外

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、デプロイされたアプリケーションでAdministratorロールが付与されている必要があります。

- WebCenter Portal: Oracle WebCenter Portal管理を使用してAdministratorロールが付与されます。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

BPMワークリストに関する問題のトラブルシューティングは、「電子メール通知が動作しない」を参照してください

17.1 WebCenter Portalワークフローのロードマップの構成

この項の表17-1に、WebCenter PortalでOracle BPM Worklistを使用するための前提条件と必要なタスクの概要を示します。

表17-1 WebCenter Portal用のワークフローの構成

担当者

タスク

サブタスク

管理者

1.WebCenter PortalとOracle SOA Suiteをインストールします

管理者

2.次のいずれかを使用して、BPEL接続を作成しWebCenter Portalワークフローを有効にします。

- Fusion Middleware Control: WebCenter PortalワークフローをホスティングするBPELサーバーの指定を参照してください。

- WLST: createBPELConnectionを使用してBPEL接続を作成し、setSpacesWorkflowConnectionNameを使用してワークフローを有効にします。詳細は、WebCenter WLSTコマンド・リファレンスのcreateBPELConnectionおよびsetBPELConnectionを参照してください。

管理者

3.WebCenter Portalワークフローをデプロイします:

- sca_CommunityWorkflows.jar (/Oracle_Home/wcportal/common/soa-composite/wcp/で取得できます)

- WebCenterWorklistDetailApp.ear (Oracle_Home/wcportal/webcenter/applications/WebCenterWorklistDetailApp.earで取得できます)

注意: SOAのインストール時に、「テンプレート」ページでOracle Webcenter Portalコンポジット - 12.2.1.0 [wcportal]オプションを選択した場合、WebCenterWorklistDetailApp.earがデプロイされます。

管理者

4.WebCenter Portalと同じアイデンティティ・ストアを使用するようにBPELサーバーを構成します[1]

管理者

5.BPELサーバーへの接続を保護します

6.a (オプション)シングル・サインオンを構成します

OAM R2以降を使用する場合は、Webcenter PortalワークフローURLを除外
6.b WS-Securityを構成します

6.c (オプション) SSLを構成します

エンド・ユーザー

7.Oracle BPM Worklistアプリケーションへの統合がWebCenter Portalで動作していることをテストします

7.a WebCenter Portalで、ポータルを作成してメンバーを招待します。

『Oracle WebCenter Portalでのポータルの構築』のポータルのメンバーの管理とロールの割当てに関する項を参照してください。

7.b Oracle BPM Worklistにログインして、ワークリスト・アイテムを表示します。

7.c 招待のワークリスト・アイテムを選択して、「承認」をクリックします。

『Oracle SOA SuiteでのSOAアプリケーションの開発』のOracle BPM Worklistの使用に関する項を参照してください

7.d ログアウトしてからポータル・マネージャとしてログインし、「メンバー」タブを表示します。ユーザーが選択したロールのメンバーとなり、ステータスが「招待済」に設定されていないことを確認します。

『Oracle WebCenter Portalでのポータルの構築』の登録済ユーザーの招待に関する項を参照してください。

17.2 BPEL接続について

BPEL接続に関する操作を行うときには、次の点に留意してください。

- デフォルトのBPELサーバーを構成すると、WebCenter Portalのユーザーは、SOA BPMワークリストで表示できる通知を使用してメンバーシップを管理できます。詳細は、 『Oracle SOA SuiteでのSOAアプリケーションの開発』のOracle BPM Worklistの使用に関する項を参照してください。

- WebCenter Portalワークフローでは、Oracle SOA Suiteが含まれるBPELサーバーへの単一接続が必要になります。詳細は、「WebCenter PortalワークフローをホスティングするBPELサーバーの指定」を参照してください。

17.3 BPELサーバーの前提条件

ワークリストのスムーズな動作を確実にするために、次の点に留意してください。

- Oracle BPM WorklistアプリケーションがSOAサーバーに組み込まれていることを確認します。URLの書式は次のとおりです。

http://host:port/integration/worklistapp

Oracle BPM WorklistがOracle SOA SuiteのBPELサーバーと同じドメインで実行されていない場合は、アイデンティティ・ストア(LDAP)を共有するか(推奨)、同じユーザー名をアイデンティティ・ストアに含める必要があります。

- WebCenterの管理対象サーバーのクロックと、Oracle SOA Suite BPELの管理対象サーバーのクロックは、アサーションの新しさをチェックするSAML認証条件NotBeforeに違反しないように同期する必要があります。

- 構成に関連する例外の存在は許されません。WLSTコマンドlistWorklistConnectionsを使用して、構成した接続を表示して接続の詳細を検証してください。接続のリストを表示した後、/integration/worklistappで追加されたURLプロパティを使用してそれらの接続を検証します。http://host:port/integration/worklistappでOracle BPM Worklistアプリケーションにアクセスできることを確認してください。

- Oracle SOA Suite BPELの管理対象サーバーがアイデンティティ・ストアを使用するように構成されていて、そのアイデンティティ・ストアにBPMWorkflowAdmin(デフォルトではweblogic)が含まれていない場合、『Oracle SOA SuiteでのSOAアプリケーションの開発』のワークリストにログインしているWebLogicユーザーの有効化に関する項の説明に従って、BPMWorkflowAdminユーザーを構成する必要があります

- ワークリストの管理対象サーバーとOracle SOA SuiteのBPELサーバーの管理対象サーバーの両方で、wsm-pmアプリケーションが問題なく実行されている必要があります。これは、次のURLを使用して検証できます。

http://host:port/wsm-pm/validator

BPELサーバーの問題を解決する方法の詳細は、「WebCenter Portalワークフローのトラブルシューティング」を参照してください。

この項では、次の内容について説明します。

- BPELサーバー: インストールと構成

- BPELサーバー: セキュリティに関する考慮事項

17.3.1 BPELサーバー: インストールと構成

WebCenter Portalでは、Oracle SOA Suiteに含まれるOracle BPEL Process Manager (BPEL)サーバーのBPMワークリストを使用します。

ワークリストを使用するには、Oracle SOA Suiteをインストールする必要があります。Oracle SOA Suiteのインストール方法の詳細は、『Oracle SOA SuiteおよびBusiness Process Managementのインストールと構成』を参照してください。

Oracle SOA Suiteをインストールした後、BPELサーバーを使用してワークリストを表示および管理するようにWebCenter Portalを構成できます。

17.3.2 BPELサーバー: セキュリティに関する考慮事項

ワークリストは、現在認証されているユーザーのタスクを表示するものです。ポータル・ユーザーがOracle SOA SuiteのBPELサーバー上でタスクを格納および取得するには、そのユーザーの名前が共有ユーザー・ディレクトリ(LDAP)に存在しているか、BPELサーバーとWebCenter Portalの両方で同様に設定されている必要があります。

たとえば、ユーザーrsmithがBPELサーバー上でタスクを格納および取得する場合、BPELサーバーとWebCenter Portalの両方にユーザーrsmithが存在している必要があります。

追加のログイン・プロンプトが表示されないようにWebCenter PortalからBPELワークリスト・タスクの詳細にアクセスするには、WebCenter PortalサーバーとOracle SOA SuiteサーバーでOracle Single Sign-Onサーバーを共有するように構成する必要があります。詳細は、「Oracle Access Managerの構成」を参照してください。

セキュアな接続の場合は、SOAとWebCenter Portalの間のWS-Securityを構成できます。詳細は、「Webサービス・セキュリティの構成」を参照してください。

17.4 WebCenter PortalワークフローをホスティングするBPELサーバーの指定

WebCenter Portalでは、内部ワークフロー(ワークリスト、ポータル・メンバーシップの通知、ポータル・サブスクリプションの要求など)をホストするためにOracle SOA Suiteに含まれているBPELサーバーが使用されます。WebCenter Portalのワークフロー機能を有効にするには、BPELサーバーへの接続が必要です。

注意:

WebCenter Portalワークフローは、WebCenter Portalを使用するように構成されたSOA管理対象サーバーにデプロイする必要があります。『Oracle WebCenter Portalのインストールおよび構成』のWebCenter Portalワークフローのバックエンド要件に関する項も参照してください。

ワークリストの通知用接続を構成する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」、「アプリケーション構成」の順に選択します(図17-1)。

図17-1 「WebCenter Portal」の「アプリケーション構成」メニュー

「アプリケーション設定」ページが開きます(図17-2)。

図17-2 ワークフローをデプロイするBPELサーバーの選択

3. BPEL SOAP URLフィールドに、ワークリストのSOAサーバーの名前を指定します。

ここで指定したSOAサーバー名には、WebCenter PortalのBPMワークリストが含まれます。

4. 「WebCenterポータル・ワークフローの有効化」を選択します。

5. 「適用」をクリックします。

6. この変更を有効にするには、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーWC_Portalを再起動します。

「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

17.5 電子メールで送信するWebCenter Portalワークフロー通知の構成

WebCenter Portalには、SOAワークフローと統合されるヒューマン・ワークフロー(人間による操作が必要)があります。SOAサーバーは電子メールを構成し、通知をユーザーの受信箱に配信できます。ユーザーは通知を承認または却下できます。

この項では、電子メール通知を有効にし、メール・サーバー詳細を構成することで、WebCenter Portalワークフロー通知を電子メールでユーザーに送信する方法について簡単に説明します。説明の詳細は、『Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理』のヒューマン・ワークフロー通知プロパティの構成に関する項を参照してください。

1. Fusion Middleware Controlを使用して、SOAを更新し、電子メール通知を有効にします。図17-3に示すように、SOAサーバーの下で、「SOA管理」、「ワークフロー・プロパティ」の順に選択します。

図17-3 SOA管理: ワークフロー構成

2. 「通知モード」として「電子メール」を選択し、使用する電子メールの有効なアカウントを指定します(図17-4)。

図17-4 「電子メール」通知モードのプロパティ

3. 「「メッセージング・ドライバ」ページに移動」をクリックします(図17-4)。

4. ユーザー・メッセージング電子メール・ドライバの「ドライバの構成」アイコンを選択します(図17-5)。

図17-5 関連ドライバ

5. 通知用の電子メール・ドライバを構成するには、『Oracle Managed File Transferの使用』の通知のための電子メール・ドライバの構成に関する項を参照してください

6. 終了後は、構成の更新を保存し、SOA管理対象サーバーを再起動します。(WebCenter Portalの場合、構成または再起動は不要です。)

ユーザーがポータルに参加するように招待されると、「承認」または「却下」リンクを含む電子メールが送信されます。

注意:

通知をテストするために、ポータル管理設定の「メンバー」ページで、ユーザーを追加し、電子メール通知メッセージを編集できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルのメンバーの管理とロールの割当てに関する項を参照してください。

17.6 OAMのWebcenter PortalワークフローURLの除外

Oracle SOA Suite BPELサーバーがOAM 11g R2以降を使用するように構成されている場合、WebCenter PortalワークフローのエンドポイントをOAMサーバーから除外する必要があります。

OAM 11g R2以降からWebCenter Portalワークフローのエンドポイントを除外する手順:

1. OAM管理コンソールを開きます。

2. アプリケーション・ドメインに移動します。

3. 「リソース」タブを開き、「作成」をクリックします。

4. HTTPタイプのリソースを作成します。

5. 「リソースURL」に、次を入力します。
/soa-infra/services/default/CommunityWorkflows/**

6. 「保護レベル」を「除外」に設定します。

7. 別のHTTPタイプのリソースを作成し、「リソースURL」を次のように指定します。
/soa-infra/services/default/CommunityWorkflows*

8. 「保護レベル」を「除外」に設定します。

9. 「適用」をクリックします。

10. OHSを再起動します。

[1]
デフォルトで自動構成済

18 ポートレット・プロデューサの管理

プロデューサへの接続を作成することによって、WSRPポートレット・プロデューサを登録できます。プロデューサを登録すると、そのポートレットをWebCenter Portalで使用できます。この章では、WSRPポートレット・プロデューサのデプロイ方法についても説明します。

この章の内容は次のとおりです。

- ポートレット・プロデューサについて

- WSRPプロデューサの登録

- WSRPプロデューサの接続テスト

- WSRPプロデューサの登録情報の編集

- ポートレットベースのページレットの使用

- WSRPポートレット・プロデューサの登録解除

- ポートレット・プロデューサ・アプリケーションのデプロイ

- Oracle PDK-Javaポートレット・プロデューサの管理

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、WebCenter Portal管理を使用して付与されるWebCenter PortalのAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

18.1 ポートレット・プロデューサについて

WebCenter Portalでは、他のアプリケーションが提供するポートレットを使用することによって、これらのアプリケーションの機能を自分のポータルで公開できます。ポータルでは、パッケージ・アプリケーション・ベンダーなどのサード・パーティが提供するポートレット、およびWebCenter Portalまたは他のOracle製品を使用して構築されたポートレットを使用できます。

表18-1に、WebCenter Portal内でポートレット・プロデューサとしてサポートされる一部の製品を示します。

デフォルトでは、Administratorロールを持つユーザーにAppConnectionManagerロールが割り当てられるため、アプリケーション管理者は、WebCenter Portal管理コンソールを通じてポートレット・プロデューサを構成できます。AppConnectionManagerロールの詳細は、「デフォルトのアプリケーション・ロールを参照してください。

表18-1 サポートされているポートレット・プロデューサ

ポートレット・プロデューサ

サポート対象か

ノート

Oracle WebLogic Portal

はい

詳細は、『Oracle WebLogic Portalポートレット開発ガイド』の他のシステムで使用するJavaポートレットのエクスポートに関する項を参照してください。

Oracle WebCenter Interaction

適用外

E-Business Suiteアプリケーション

はい

詳細は、「E-Business Suiteアプリケーションの統合」を参照してください

PeopleSoftアプリケーション

はい

詳細は、「PeopleSoftアプリケーションの統合」を参照してください。

JD Edwardsアプリケーション

はい

詳細は、「JD Edwardsアプリケーションの統合」を参照してください。

注意:

サード・パーティによって構築され、WebCenter Portalによって使用されるWSRPプロデューサが正常に動作するための前提は次のとおりです。

- プロデューサはベンダー固有のWSRP拡張機能に依存しません。

- ポートレットは使用しているアプリケーションについて、たとえば、特定のJavaScriptメソッドがページ内に存在する必要があるなどの前提条件を作りません。

アプリケーション管理者は、提供されている管理ページ、またはポートレット・プロデューサのタスク・フローが含まれるページから、実行時にポートレット・プロデューサを登録および管理できます。

システム管理者は、Fusion Middleware ControlまたはWLSTコマンド行ツールを使用して、WebCenter Portalのポートレット・プロデューサを登録および管理できます。

ポートレット・プロデューサを使用する際には、次の点に留意してください。

- いくつかの組込みプロデューサが、WebCenter Portalに付属しています(OmniPortletおよびWSRPツール)。次のEARファイルはWebCenter Portalに同梱されています。

- portalTools.ear: OmniPortlet

- wsrp-tools.ear: WSRPツール

portalTools.earファイルおよびwsrp-tools.earファイルは、registerOOTBProducers WLSTコマンドを使用してインストールできます。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのregisterOOTBProducersに関する項を参照してください。

- JSR 286ポートレットをページに追加する前に、所有しているWSRPプロデューサを登録しておく必要があります。WebCenter WLSTコマンド・リファレンスのregisterSampleProducersに関する項を参照してください。

- Oracle Portlet Producer製品(サーバー)が本番環境にインストールされ、wsrp-toolsおよびportalToolsのURLにアクセスできる必要があります。Oracle Portlet Producerがインストールされていない場合は、『Oracle WebCenter Portalのインストールおよび構成』の既存ドメインの拡張に関する項を参照して、本番環境にインストールしてください。

- ポートレット・プロデューサへの接続を作成するとき、プロデューサはWebCenter Portalにより登録され、接続はconnections.xmlファイルに追加されます。WRSPプロデューサでは、命名規則connectionname-wsconnに従いWebサービス接続も作成されます。登録中に、接続メタデータがOracle Metadata Services (MDS)リポジトリおよび登録中のプロデューサに作成されます。プロデューサのポートレットが利用されると、ユーザー・カスタマイズがプロデューサに保存されます。登録解除中に、プロデューサの接続とカスタマイズは削除されます。

- デプロイ後のすべての接続構成はMDSに格納されます。詳細は、「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。MDSの詳細は、『Oracle Fusion Middlewareの管理』のメタデータ・リポジトリの管理に関する項を参照してください。

- ポートレット・プロデューサの登録は動的です。新規のポートレット・プロデューサや既存のプロデューサに対する更新は、WebCenter Portalで即座に使用可能になります。WebCenter Portalや管理サーバーを再起動する必要はありません。

- インスタンス間でプロデューサを移行するには、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のWSRPプロデューサ永続性ストアの移行に関する項で説明している移行ユーティリティを使用してください。

- ポートレット・プロデューサの保護の詳細は、「WSRPプロデューサの保護」を参照してください。

- Oracle PDK-Javaを使用して作成したポートレット・プロデューサの詳細は、「Oracle PDK-Javaポートレット・プロデューサの管理」を参照してください。

18.2 WSRPプロデューサの登録

WSRPポートレット・プロデューサを登録するときには、プロデューサの運用パラメータを表す基本情報を指定する必要があります。この情報は、WebCenter Portalがプロデューサと通信し、プロデューサを通じてポートレットと通信するために使用されます。

WebCenter Portalは、WSPR 1.0とWSRP 2.0のプロデューサをどちらもサポートします。WSRP 2.0標準では、特にポートレット間通信と、ポートレット・カスタマイズのエクスポートおよびインポートをサポートしています。標準ベースのJSR 286ポートレットの作成時には、WSRP 2.0の利点を活用できます。

WebCenter Portalには、デプロイ済のアプリケーションにWSRPプロデューサを登録する複数のツールが用意されています。

この項には次のトピックが含まれます:

- Fusion Middleware Controlを使用したWSRPプロデューサの登録

- WLSTを使用したWSRPプロデューサの登録

- マップされたユーザーIDのための権限のポリシー・ストアへの追加

- WebCenter PortalでのWSRPポートレット・プロデューサの登録

また、Oracle PDK-Javaを使用して開発したポートレット・プロデューサを登録することもできます。詳細は、「Oracle PDK-Javaポートレット・プロデューサの登録」を参照してください。

18.2.1 Fusion Middleware Controlを使用したWSRPプロデューサの登録

Fusion Middleware Controlを使用して、WSRPポートレット・プロデューサを登録できます。

Fusion Middleware Controlを使用してWSRPポートレット・プロデューサを登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。

3. 「ポートレット・プロデューサ接続の追加」セクションで、WSRPプロデューサの接続の詳細を入力します。

パラメータの詳細は、「WSRPプロデューサの接続パラメータ」を参照してください。

4. 「セキュリティ」セクションを使用して、アイデンティティ伝播またはアサーションに使用するセキュリティ・トークンのタイプを指定します。

パラメータの詳細は、「WSRPプロデューサのセキュリティの接続パラメータ」を参照してください。

伝播またはアサートされたユーザー情報が含まれるセキュリティ・トークンは、SOAPヘッダー内のXML要素として表されます。セキュリティ・トークンとSOAPメッセージ本文は、WebCenter Portalで発生したSOAPメッセージの認証性を証明するためにデジタル署名されます。WebCenter Portalでは、6つのタイプのセキュリティ・トークンをサポートします。

- WSS 1.0ユーザー名トークン(パスワードなし)

- WSS 1.0ユーザー名トークン(パスワードあり)

- WSS 1.0 SAMLトークン

- メッセージ整合性付きWSS 1.0 SAMLトークン

- メッセージ保護付きWSS 1.0 SAMLトークン

- メッセージ保護付きWSS 1.1 SAMLトークン

SAMLは、Security Assertion Markup Languageの略語です。これらの各セキュリティ・トークンの詳細は、「WSRPプロデューサのセキュリティの接続パラメータ」を参照してください。

注意:

PeopleSoft WSRPプロデューサは、ユーザー名トークン(パスワードあり)およびメッセージ整合性付きSAMLトークンの2つのプロファイルをサポートします。その他のOracle WSRPプロデューサでは、6種類のプロファイルすべてがサポートされています。その他のWSRPコンテナについては、サポートされているトークン形式を各ベンダーに確認してください。

5. 「キーストア」セクションを使用して、SOAPメッセージの一部分(セキュリティ・トークンとSOAPメッセージ本文)の署名に使用する証明書および秘密鍵が含まれるキーストアの場所を指定します。

これらのプロパティは、ドメインで指定されている構成をオーバーライドする場合にのみ設定します。

パラメータの詳細は、「WSRPプロデューサのキーストア接続パラメータ」を参照してください。

6. 「OK」をクリックします。
新しいプロデューサが接続表に表示されます。

18.2.2 WLSTを使用したWSRPプロデューサの登録

WLSTコマンドのregisterWSRPProducerを使用して、WSRPポートレット・プロデューサとの接続を作成し、WebCenter Portalにプロデューサを登録します。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのregisterWSRPProducerに関する項を参照してください。

関連項目:

deregisterWSRPProducer、listWSRPProducers、refreshProducer、registerOOTBProducers、registerSampleProducers

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

18.2.3 マップされたユーザーIDのための権限のポリシー・ストアへの追加

「デフォルト・ユーザー」フィールドを使用して別のユーザー・アイデンティティにマップする場合、ポリシー・ストアに権限を追加する必要もあります。

ポリシー・ストアに権限を追加するには、次のいずれかを実行します。

注意:

バージョン番号(ある場合)を含むクライアント・アプリケーション名にMyAppIDを置き換えます。

- 次の権限を直接ポリシー・ストアに追加します。

<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>

- WLSTコマンドのgrantPermissionを実行して権限を付与します。

例:

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')

コマンドの構文と例は、『インフラストラクチャ・セキュリティWLSTコマンド・リファレンス』のgrantPermissionに関する項を参照してください。WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

18.2.4 WebCenter PortalでのWSRPポートレット・プロデューサの登録

WebCenter Portal管理でWSRPポートレット・プロデューサを登録できます。

WebCenter PortalでWSRPプロデューサを登録する手順は次のとおりです。

1. WebCenter Portal管理を開きます。

詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ポートレット・プロデューサ」を選択します。

または、次のURLを使用して、「ポートレット・プロデューサ」を選択します。

http://host:port/webcenter/portal/admin/settings/tools

3. メニュー・バーの「登録」をクリックします。

4. 「ポートレット・プロデューサの登録」ページで、WSRPポートレット・プロデューサの接続の詳細を入力します。
詳細は、「WSRPプロデューサの接続パラメータ」を参照してください。

5. 「セキュリティ」セクションを使用して、アイデンティティ伝播またはアサーションに使用するセキュリティ・トークンのタイプを指定します。

詳細は、「WSRPプロデューサのセキュリティの接続パラメータ」を参照してください。

伝播またはアサートされたユーザー情報が含まれるセキュリティ・トークンは、SOAPヘッダー内のXML要素として表されます。セキュリティ・トークンおよびSOAPメッセージ本文はデジタル署名されて、WebCenter PortalアプリケーションからのSOAPメッセージ送信元の真正性が証明されます。WebCenter Portalでは、6つのタイプのセキュリティ・トークンをサポートします。

- WSS 1.0ユーザー名トークン(パスワードなし)

- WSS 1.0ユーザー名トークン(パスワードあり)

- WSS 1.0 SAMLトークン

- メッセージ整合性付きWSS 1.0 SAMLトークン

- メッセージ保護付きWSS 1.0 SAMLトークン

- メッセージ保護付きWSS 1.1 SAMLトークン

SAMLは、Security Assertion Markup Languageの略語です。これらの各セキュリティ・トークンの詳細は、「WSRPプロデューサのセキュリティの接続パラメータ」を参照してください。

6. 「テスト」をクリックして、指定したサーバーの詳細が正しいことを確認します。

サーバーに接続できると、成功メッセージが表示されます。サーバーがダウンしている、またはホスト情報が正しくないか有効でない場合、接続の失敗メッセージが表示されます。

注意:

テストでは、サーバー(ホスト/ポート)の単純なPINGテストが実行されます。host:portの後のパス内のすべてのものが無視されます。プロデューサがアクセス可能かどうかを確認するには、ブラウザでプロデューサのテスト・ページにアクセスします。詳細は、「WSRPプロデューサの接続テスト」を参照してください。

7. 「OK」をクリックします。

18.2.5 WSRPプロデューサの接続パラメータ

WSRPポートレット・プロデューサを登録する場合、設定する必要がある接続パラメータがいくつかあります。

表18-2 WSRPポートレット・プロデューサの接続パラメータ

フィールド

説明

接続名

WebCenter Portal内のこのポートレット・プロデューサ登録を識別する一意名を入力します。名前は、すべてのWebCenter Portal接続タイプにおいて一意である必要があります。

ここで指定する名前は、リソース・カタログ(「ポートレット」フォルダの下)に表示されます。

プロデューサ・タイプ

「WSRPプロデューサ」を選択します。

WSDL URL

WSRPプロデューサの登録URLを入力します。

構文はWSRP実装によって異なります。たとえば、Oracle WSRPコンテナにデプロイされたポートレットのURL形式は次のとおりです。

http://host:port/context_root/portlets/wsrp2?WSDL

http://host:port/context_root/portlets/wsrp1?WSDL

http://host:port/context_root/portlets/?WSDL (下位互換性を持つ場合はWSRP 1.0)

ここで:

- hostはプロデューサがデプロイされているサーバーです。

- portは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:port/context_root/info

プロキシを使用しますか。

WebCenter Portalで、このプロデューサに接続するときHTTPプロキシを使用する場合、選択します。これを選択した場合は、「プロキシ・ホスト」および「プロキシ・ポート」の値を入力してください。

プロキシはWebCenter Portalおよびリモート・ポートレット・プロデューサがファイアウォールで区切られている場合に必要であり、HTTPプロキシはプロデューサと通信するために必要です。

プロキシ・ホスト

プロキシ・サーバーのホスト名またはIPアドレスを入力します。

プロキシ・サーバー名の先頭にhttp://を付けないでください。

プロキシ・ポート

プロキシ・サーバーがリスニングするポート番号を入力します。デフォルト・ポートは80です。

デフォルトの実行タイムアウト(秒)

プロデューサとの通信で適切なタイムアウト時間(秒単位)を入力します。たとえば、プロデューサがWebCenter Portalページ上にポートレットを登録、登録解除または表示するために許容される最大時間です。デフォルト値は30秒です。

個々のポートレットは、その自体のタイムアウト時間を定義する場合があります。このタイムアウト値は、ここで指定されている値よりも優先されます。

18.2.6 WSRPプロデューサのセキュリティの接続パラメータ

WSRPポートレット・プロデューサを登録する場合、指定できるセキュリティ設定がいくつかあります。

表18-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トークン

- なし

これらの各オプションの説明は、表18-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アプリケーションで認証されていない場合、リモート・プロデューサに対してアサートするユーザー名を入力します。

認証されていない場合は、ID anonymousがアプリケーション・ユーザーに関連付けられます。anonymousの値はリモート・プロデューサに適していない場合があるため、ここで別のアイデンティティを指定する必要があります。ただし、この場合は、WebCenter Portalがユーザーを認証していないため、指定するデフォルト・ユーザーはリモート・プロデューサで権限の低いユーザーになることに注意してください。そのユーザーがアプリケーションに対して認証済である場合、デフォルト・ユーザーではなく、そのユーザーのアイデンティティがアサートされます。

WSRPリモート・プロデューサはこの情報を受け入れるように設定する必要があります。「マップされたユーザーIDのための権限のポリシー・ストアへの追加」の説明に従ってポリシー・ストアに権限を追加する必要もあります。

有効なトークン: メッセージ整合性付きWSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.0 SAMLトークン、WSS 1.0 SAMLトークン、メッセージ保護付きWSS 1.1 SAMLトークン、WSS 1.0ユーザー名トークン(パスワードなし)。

関連付けられている外部アプリケーション(パスワード付きのユーザー名)

このプロデューサが認証に外部アプリケーションを使用する場合、「関連付けられている外部アプリケーション」ドロップダウン・リストを使用してアプリケーションを指定します。目的のアプリケーションがリストに表示されない場合は、「新規作成」を選択して、ここで外部アプリケーションを定義します。

有効なオプション: 「WSS 1.0ユーザー名(パスワードあり)」のみ。

表18-4 トークン・プロファイルのオプション

トークン・プロファイル

説明

メッセージ整合性付きWSS 1.0 SAMLトークン

wss10_saml_token_with_message_integrity_client_policy

このポリシーでは、WS-Security 1.0標準に従って、メッセージレベルの整合性保護およびアウトバウンドSOAPリクエストのSAMLベースの認証が実施されます。SOAPメッセージに組み込まれているSAMLトークンは、送信者保証確認付き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トークンが組み込まれ、確認タイプはsender-vouchesです。このポリシーは、非対称鍵テクノロジのWS-SecurityのBasic128スイートを使用します。具体的には、メッセージ機密性のためのRSAキー・メカニズム、メッセージ整合性のためのSHA-1ハッシュ・アルゴリズム、およびAES-128ビット暗号化です。

WSS 1.0ユーザー名トークン(パスワードなし)

oracle/wss10_username_id_propagation_with_msg_protection_client_policy

このポリシーでは、WS-Security 1.0標準に従って、アウトバウンドSOAPリクエストに対して、証明書ベースのメッセージ保護を使用したパスワード付きのユーザー名トークン・プロファイル・ベースのアイデンティティ伝播が実施されます。資格証明(user nameのみ)は、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のBasic128スイートを使用します。具体的には、メッセージ機密性のためのRSAキー・メカニズム、メッセージ整合性のためのSHA-1ハッシュ・アルゴリズム、およびAES-128ビット暗号化です。

WSRPプロデューサには、別のIDストアがある場合、このトークン・プロファイルを使用します。プロデューサに関連する外部アプリケーションを定義し、その外部アプリケーションをこのプロデューサと関連付ける必要があります。

WSS 1.0 SAMLトークン

oracle/wss10_saml_token_client_policy

このポリシーでは、WS-Security 1.0標準に従って、アウトバウンドSOAPリクエスト・メッセージのSAMLベースの認証が実施されます。このポリシーでは、ユーザーのアイデンティティが伝播されます。通常、これはメッセージ保護および整合性チェックが不要な内部部門でのデプロイメントに使用されます。

このポリシーでは、キーストアの構成は不要です。

メッセージ保護付きWSS 1.1 SAMLトークン

oracle/wss11_saml_token_with_message_protection_client_policy

このポリシーでは、WS-Security 1.1標準に従って、メッセージレベルの保護(整合性と機密性)およびアウトバウンドSOAPリクエストへのSAMLトークンの移入が実施されます。SOAPメッセージに組み込まれているSAMLトークンは、送信者保証確認付きSAMLベース認証で使用されます。このポリシーは、署名および暗号化のために対称鍵テクノロジを、署名の承認のために非対称鍵テクノロジのWS-SecurityのBasic 128スイートを使用します。

なし

トークンなし。「なし」を選択した場合、WS-SecurityヘッダーはSOAPメッセージに添付されません。

18.2.7 WSRPプロデューサのキーストア接続パラメータ

WSRPポートレット・プロデューサを登録すると、SOAPメッセージの署名に使用する証明書および秘密鍵が含まれるキーストアの場所を指定できます。

表18-5 WSRPプロデューサのキーストアの接続パラメータ

フィールド

説明

受信者の別名

プロデューサの証明書に関連付けられたキーストア別名を指定します。

この証明者を使用して、プロデューサへのメッセージを暗号化します。

ストア・パス

SOAPメッセージ(セキュリティ・トークンとメッセージ本文)の署名または暗号化に使用する証明書および秘密鍵が含まれるキーストアの絶対パスを入力します。この表に示されている署名、暗号化および受信者キーはこのキーストアで使用できる必要があります。

指定されたキーストア・ファイルは、JDKのキーツール・ユーティリティを使用して作成されている必要があります。

パスワード

キーストアの作成時に設定されたキーストアへのパスワードを指定します。パスワードが使用できない場合や正しくない場合、プロデューサを使用できません。

署名キーの別名

署名キーの別名を入力します。

「署名キーの別名」は、署名に使用される秘密鍵に関連付けられた証明書の識別子です。

署名キーのパスワード

「署名鍵の別名」に指定された別名によって識別されるキーにアクセスするためのパスワードを指定します。

暗号化キーの別名

返されるメッセージを暗号化するには、プロデューサによって使用されるキーの別名を入力します。有効な値は、指定されたキーストアにあるキーの別名の1つです。

このプロパティは省略可能です。指定しない場合、プロデューサでは、戻りメッセージの暗号化のために署名鍵を使用します。

暗号化キーのパスワード

暗号化キーにアクセスするためのパスワードを入力します。

18.3 WSRPプロデューサの接続テスト

WSRPポートレット・プロデューサ接続をテストして、プロデューサが稼働していることを確認できます。

1. 次のプロデューサURLを取得します。

http://host:port/context_root/info

WSRP v2プロデューサ接続の場合、プロデューサURL形式は次のとおりです。

http://host:port/context_root/portlets/wsrp2?WSDL

例:

http://example.com:7778/MyPortletApp/portlets/wsrp2?WSDL

WSRP v1プロデューサ接続の場合、プロデューサURL形式は次のとおりです。

http://host:port/context_root/portlets/wsrp1?WSDL

例:

http://example.com:7778/MyPortletApp/portlets/wsrp1?WSDL

2. ブラウザ・ウィンドウでプロデューサのURLを実行します。

18.4 WSRPプロデューサの登録情報の編集

WebCenter Portalには、WSRPポートレット・プロデューサの登録情報を編集する複数のツールが用意されています。

この項には次のトピックが含まれます:

- WSRPプロデューサの登録情報の編集について

- Fusion Middleware Controlを使用したWSRPプロデューサ登録情報の編集

- WLSTを使用したプロデューサ登録情報の編集

- WebCenter PortalでのWSRPプロデューサの登録情報の編集

- WSRPプロデューサ・メタデータの新しいWSDL URLへの移行

- ポートレット・クライアント構成の編集

Oracle PDK-Javaポートレット・プロデューサの登録情報の編集方法の詳細は、「Oracle PDK-Javaポートレット・プロデューサの登録詳細の編集」を参照してください。

18.4.1 WSRPプロデューサの登録情報の編集について

プロデューサ登録情報はいつでも更新できます。

プロデューサが別の場所に移動する場合、そのプロデューサに定義した接続を再構成する必要があります。Fusion Middleware ControlまたはWLSTを使用してWDSL URLプロパティを編集できます。

ユーザーがWebCenter Portalで作業している間に行ったポートレットのカスタマイズとパーソナライズをすべて保持するには、プロデューサのカスタマイズとパーソナライズもプロデューサの新しい場所に移行する必要があります。ポートレット・クライアントのメタデータを別の場所に移行するには、WLSTコマンドexportPortletClientMetadataおよびimportPortletClientMetadataを使用します。

詳細は、「ポートレット・クライアント・メタデータのバックアップ(エクスポート)」および「ポートレット・クライアント・メタデータのバックアップ(エクスポート)」を参照してください。

18.4.2 Fusion Middleware Controlを使用したWSRPプロデューサ登録情報の編集

Fusion Middleware Controlを使用してWSRPプロデューサ登録情報を編集できます。

Fusion Middleware Controlを使用してポートレット・プロデューサの接続の詳細を更新する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ポートレット・プロデューサ」を選択します。

4. 「ポートレット・プロデューサ接続の管理」セクションで、変更するプロデューサを選択して「編集」をクリックします。

5. 「ポートレット・プロデューサ接続の編集」セクションで、必要に応じて接続の詳細を変更します。

詳細は、「WSRPプロデューサの接続パラメータ」を参照してください。

6. 「OK」をクリックします。

18.4.3 WLSTを使用したプロデューサ登録情報の編集

WLSTコマンドのsetWSRPProducerを使用して、WSRPポートレット・プロデューサの接続の詳細を編集します。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetWSRPProducerに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

18.4.4 WebCenter PortalでのWSRPプロデューサの登録情報の編集

WebCenter Portalでは、ポートレット・プロデューサに指定された多くの登録情報にアクセスして変更できます。

WebCenter Portalでポートレット・プロデューサの登録情報を編集する手順は次のとおりです。

1. WebCenter Portal管理を開きます。

詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ポートレット・プロデューサ」を選択します。

または、次のURLを使用して、「ポートレット・プロデューサ」を選択します。

http://host:port/webcenter/portal/admin/tools

3. 編集するポートレット・プロデューサを選択します。

4. メニュー・バーの「編集」をクリックします。

5. プロデューサ登録のプロパティを必要に応じて編集します

詳細は、「WSRPプロデューサの接続パラメータ」および「WSRPプロデューサのセキュリティの接続パラメータ」を参照してください。

「プロデューサ名」または「プロデューサ・タイプ」は編集できません。

注意:

「WSDL URL」の値は編集可能ですが、たとえば、プロデューサのポートが変更されたときに別のプロデューサをポイントするには、新しいプロデューサが元のプロデューサの永続性ストアにアクセスできるか、または元のプロデューサの永続性ストアが新しいプロデューサの永続性ストアに移行されていることが必要です。詳細は、「他のスキーマ・データ(ACTIVITIESとPORTLET)のバックアップおよびリストア」を参照してください。

6. 必要な設定をすべて変更したら、「テスト」をクリックして、指定したサーバーの詳細が正しいことを確認します。

サーバーに接続できると、成功メッセージが表示されます。サーバーがダウンしている、またはホスト情報が正しくないか有効でない場合、接続の失敗メッセージが表示されます。

注意:

テストでは、サーバー(ホスト/ポート)の単純なPINGテストが実行されます。host:portの後のパス内のすべてのものが無視されます。プロデューサがアクセス可能かどうかを確認するには、ブラウザでプロデューサのテスト・ページにアクセスします。詳細は、「WSRPプロデューサの接続テスト」を参照してください。

7. 完了したら、「OK」をクリックします。

18.4.5 WSRPプロデューサ・メタデータの新しいWSDL URLへの移行

プロデューサが別の場所に移動する場合、ユーザーがWebCenter Portalで作業している間に行ったポートレットのカスタマイズとパーソナライズをすべて保持するには、既存のプロデューサ・メタデータを新しい場所に移行する必要もあります。プロデューサへの既存のすべての接続は、新しい場所をポイントするように再構成する必要があります。

WSRPプロデューサのメタデータを新しいURLエンドポイントに移行する手順は、次のとおりです。

1. WLSTコマンドのexportPortletClientMetadataを使用して、プロデューサのメタデータをエクスポートします。
コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのexportPortletClientMetadataに関する項を参照してください。

2. WLSTコマンドsetWSRPProducerを使用して、プロデューサのWSDL URLを変更します。
コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetWSRPProducerに関する項を参照してください。

3. WLSTコマンドのimportPortletClientMetadataを使用して、プロデューサのメタデータをインポートします。
コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのimportPortletClientMetadataに関する項を参照してください。

18.4.6 ポートレット・クライアント構成の編集

adf-config.xmlファイルには、WebCenter Portalサービスの構成情報が含まれています。ポートレット・クライアント構成の詳細は、このファイルのadf-portlet-configセクションで指定されています。

次の例は、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 enabled="true">
<serviceConfigFile>myPortletCoherenceConfig.xml</serviceConfigFile>
</cacheSettings>
</adf-portlet-config>

アプリケーション開発者は、アプリケーションのadf-config.xmlファイルを編集して、ポートレット・クライアント構成を編集できます。ただし、この場合は、変更後にアプリケーションの再デプロイが必要になります。アプリケーションを再デプロイせずに、実行時にポートレット・クライアントの構成を編集するには、WLSTコマンドを使用します。

WLSTコマンドのsetPortletClientConfigを使用して、ポートレット・クライアントの構成情報を編集します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetPortletClientConfigに関する項を参照してください。

このWLSTコマンドの使用後は、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

関連項目:

listPortletClientConfig、getPortletClientConfig

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

18.5 WSRPポートレット・プロデューサの登録解除

WebCenter Portalには、WSRPポートレット・プロデューサの登録を解除する複数のツールが用意されています。

この項には次のトピックが含まれます:

- ポートレット・プロデューサの登録解除について

- Fusion Middleware Controlを使用したWSRPポートレット・プロデューサの登録解除

- WLSTを使用したWSRPポートレット・プロデューサの登録解除

- WebCenter PortalでのWSRPポートレット・プロデューサの登録解除

Oracle PDK-Javaポートレット・プロデューサを登録解除する方法の詳細は、「Oracle PDK-Javaポートレット・プロデューサの登録解除」を参照してください。

18.5.1 ポートレット・プロデューサの登録解除について

WSRPポートレット・プロデューサはいつでも登録解除できます。

登録解除されたプロデューサと関連付けられたポートレットは機能しなくなるため、プロデューサを登録解除する前に、WebCenter Portalへの影響を考慮してください。ポートレット・プロデューサ呼出しのメトリックをチェックして、プロデューサの使用頻度を確認します。詳細は、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

プロデューサの登録を解除すると、WebCenter Portalとリモート・プロデューサの両方から登録データが削除されます。

- WebCenter Portal - プロデューサ接続は削除され、プロデューサのメタデータも削除されます。

- リモート・プロデューサ: (ポートレット自体ではなく)ポートレット・インスタンスが削除されます。

ポートレット・インスタンスはWebCenter Portalページから削除されません。ユーザーには、ポートレットのかわりに「ポートレットがありません」というメッセージが表示されます。

注意:

このポートレット・プロデューサに関連付けられている外部アプリケーションの目的がこのプロデューサをサポートすることのみであれば、その外部アプリケーションを削除することも考慮してください。「外部アプリケーション接続の削除」を参照してください。

18.5.2 Fusion Middleware Controlを使用したWSRPポートレット・プロデューサの登録解除

Fusion Middleware Controlを使用して、WSRPポートレット・プロデューサを登録解除できます。

ポートレット・プロデューサを登録解除するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ポートレット・プロデューサ」を選択します。

4. 登録を解除するプロデューサの名前を選択し、「削除」をクリックします。

接続の詳細が削除されます。このプロデューサに関連付けられたポートレットに、WebCenter Portalからアクセスできなくなります。

18.5.3 WLSTを使用したWSRPポートレット・プロデューサの登録解除

WLSTコマンドを使用してWSRPポートレット・プロデューサを登録解除します。

WLSTコマンドのderegisterWSRPProducerを使用してWSRPポートレット・プロデューサ接続を登録解除します。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのderegisterWSRPProducerに関する項を参照してください。

次のWLSTコマンドを使用して、WebCenter Portalに用意されている組込みプロデューサまたはサンプルのプロデューサの登録を解除します。

- 組込みプロデューサ: deregisterOOTBProducers
コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのderegisterOOTBProducersに関する項を参照してください。

- サンプルのプロデューサ: deregisterSampleProducers
コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのderegisterSampleProducersに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

18.5.4 WebCenter PortalでのWSRPポートレット・プロデューサの登録解除

WebCenter Portalの特定のプロデューサを使用する必要がなくなった場合には、そのプロデューサを登録解除できます。

WebCenter PortalでWSRPポートレット・プロデューサを登録解除する手順は次のとおりです。

1. WebCenter Portal管理を開きます。

詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ポートレット・プロデューサ」を選択します。

または、次のURLを使用して、「ポートレット・プロデューサ」を選択します。

http://host:port/webcenter/portal/admin/settings/tools

3. 登録解除するポートレット・プロデューサを選択します。

4. メニュー・バーの「登録解除」をクリックします。

5. 「削除の確認」ダイアログで、「登録解除」をクリックして登録解除のプロセスを完了します。

18.6 ポートレット・プロデューサ・アプリケーションのデプロイ

JDeveloperで開発したポートレット・プロデューサ・アプリケーションは、WebCenter Portalポートレット・プロデューサをサポートするように構成されたOracle WebLogic管理対象サーバー・インスタンスにデプロイできます。

アプリケーションを管理対象サーバーにデプロイするには、Oracle Enterprise Manager Fusion Middleware Control、Oracle WebLogic管理コンソールまたはWLSTを使用できます。

これらの管理ツールの詳細は、「Oracle WebCenter Portalの管理ツール」を参照してください。

JDeveloper内からポートレット・プロデューサ・アプリケーションをデプロイすることもできます。

この項には次のトピックが含まれます:

- ポートレット・プロデューサ・アプリケーションのデプロイの準備

- Fusion Middleware Controlを使用したポートレット・プロデューサ・アプリケーションのデプロイ

- Oracle WebLogic Server管理コンソールを使用したポートレット・プロデューサ・アプリケーションのデプロイ

- WLSTを使用したポートレット・プロデューサ・アプリケーションのデプロイ

- Oracle JDeveloperを使用したポートレット・プロデューサ・アプリケーションのデプロイ

アプリケーションのデプロイの詳細は、『Oracle Fusion Middlewareの管理』のアプリケーションのデプロイに関する項を参照してください。

18.6.1 ポートレット・プロデューサ・アプリケーションのデプロイの準備

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ファイルが作成されます。

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ファイルを作成します。

次の例ではWebプロキシが指定されます。

java -Dhttp.proxyHost=myhttpproxy.com -Dhttp.proxyPort=80 -jar wsrp-predeploy.jar wsrp-samples.ear

この例ではWSRP-wsrp-samples.earが作成されます。

18.6.2 Fusion Middleware Controlを使用したポートレット・プロデューサ・アプリケーションのデプロイ

Fusion Middleware Controlを使用して、ポートレット・プロデューサをデプロイできます。

Fusion Middleware Controlを使用してPortal Frameworkアプリケーションをデプロイするには、アプリケーション・アーカイブの場所と、アプリケーションのデプロイ・プランが存在するかどうかを確認する必要があります。

Fusion Middleware Controlを使用してポートレット・プロデューサ・アプリケーションをデプロイする手順は次のとおりです。

1. Fusion Middleware Controlにログインします。

2. 「ターゲット・ナビゲーション」ペインで「WebLogicドメイン」を開き、ターゲットの管理対象サーバーが作成されたドメインをクリックします。

3. 「WebLogicドメイン」メニューから、「デプロイメント」を選択します。

4. 「デプロイメント」→「デプロイ」を選択します。

「アーカイブの選択」ページが表示されます。

5. 「アーカイブまたは展開済ディレクトリ」セクションで、次のいずれかを実行します。

- 「アーカイブはこのWebブラウザが稼働しているマシンに存在します。」を選択して、アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを探します。

- 「アーカイブまたは展開済ディレクトリはEnterprise Managerが稼働しているサーバーに存在します。」を選択して、アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを探します。

6. 「デプロイ・プラン」セクションで、次のいずれかを実行します。

- 「デプロイ構成が行われるとき、新規デプロイ・プランを作成します。」を選択し、再デプロイ処理の後に、新しいデプロイ・プランを自動的に作成します。

- 「デプロイ・プランはこのWebブラウザが稼働しているマシンに存在します。」を選択して、プランへのパスを入力するか、「参照」をクリックしてプランを探します。

- 「デプロイ・プランはEnterprise Managerが稼働しているサーバーに存在します。」を選択して、プランへのパスを入力するか、「参照」をクリックしてプランを探します。

7. 「次へ」をクリックします。

「ターゲットの選択」ページが表示されます。

8. アプリケーションをデプロイするターゲット・サーバーを選択し、「次へ」をクリックします。

「アプリケーション属性」ページが表示されます。

9. 「次へ」をクリックします。

「デプロイ設定」ページが表示されます。

10. 「ADF接続の構成」の「編集」アイコンをクリックして、Portal Frameworkアプリケーションに関連付けられた接続設定をチェックします。

「ADF接続の構成」ページが表示されます。

11. 接続ごとに「編集」アイコンをクリックして、接続設定がターゲット環境に対して正しいことを確認します(本番やステージングなど)。

WSRPプロデューサの場合、WSRPプロデューサ接続およびWebサービス接続がプロデューサごとに表示されます。通常、Webサービス接続のみターゲット・プロデューサに合せて変更する必要があります。これには4つのURLエンドポイントが含まれていますが、これらをすべて変更する必要があります。WSRPプロデューサ接続では、アプリケーション・サーバー用に、デフォルトのプロキシ設定とは個別に設定できるプロキシ設定のみ必要に応じて構成します。

EARファイルのポートレット・プロデューサへの接続を、ターゲット・デプロイ環境のプロデューサを指すように変更する必要がある場合、必ずここで変更してください。これで、アプリケーションが起動したときに、ポートレット・カスタマイズがターゲット・プロデューサにインポートされます。

注意:

アプリケーションが初めて起動したときに、接続できるターゲット・プロデューサがなかった場合、インポートは失敗します。ポートレット・プロデューサに接続できるようになったら、アプリケーションを再起動してインポートを再実行してください。

「ADF接続の構成」ページを使用してプロデューサ接続を修正しないまま間違ったプロデューサの場所(例: 開発環境のプロデューサ)を指しており、そのプロデューサが接続可能な場合、ポートレットは間違ったプロデューサにインポートされます。

これを修正するには、デプロイメントの後、Fusion Middleware ControlまたはWLSTコマンドを使用してプロデューサURLエンドポイントを変更し、その後、アプリケーションを再デプロイします。

12. 必要に応じて、Webモジュールなどの追加デプロイ・オプションを指定して、アプリケーションやセキュリティ移行設定に含めます。

13. オプションで、「デプロイ・プラン」セクションの「デプロイ・プランの編集」をクリックし、現在選択しているデプロイ・プランを編集します。

14. オプションで、「デプロイ・プラン」セクションの「デプロイ・プランの保存」をクリックし、アプリケーションを再デプロイするときに再利用できるように、現在選択しているデプロイ・プランを保存します。

15. デプロイ・プロセスを開始するには、「デプロイ」をクリックします。

Fusion Middleware Controlに処理メッセージが表示されます。

16. 「正常にデプロイされました」ページで「閉じる」をクリックします。

これで、ポートレット・プロデューサ・アプリケーション(およびそのデプロイ・プラン)が、WebLogic管理対象サーバー・インスタンスでデプロイされました。

17. Fusion Middleware Controlセッション中にアプリケーションをデプロイしたWebLogic管理対象サーバーを再起動する場合、「ファーム」メニューから「ファーム」をリフレッシュして、アプリケーションのステータスを更新します。

デプロイ時に接続を構成した場合、それらはデプロイ・プランの一部として格納されません。次回デプロイするときは、これらの接続詳細を再度指定する必要があります。

18.6.3 Oracle WebLogic Server管理コンソールを使用したポートレット・プロデューサ・アプリケーションのデプロイ

WebLogic Server管理コンソールを使用して、ポートレット・プロデューサ・アプリケーションをデプロイできます。しかし、コンソールでは、基本的なMDS接続も含め、ADF接続を変更できません。

このコンソールを使用してポートレット・プロデューサ・アプリケーションをデプロイするには、EARファイルのMDS接続をターゲット・デプロイメント・リポジトリに合わせて構成する必要があります。「WLSTを使用したポートレット・プロデューサ・アプリケーションのデプロイ」の手順1-5を実行したら、次の手順を実行して、WLS管理コンソールを使用してポートレット・プロデューサ・アプリケーションをデプロイしてください。

注意:

インストール中に作成した事前構成済管理対象サーバーのいずれかや管理サーバーにポートレット・プロデューサ・アプリケーションをデプロイすることはお薦めしません。デプロイする前に新しい管理対象サーバー・インスタンスを作成するか、オプションでWC_Portletサーバーにデプロイできます。

WLS管理コンソールを使用してポートレット・プロデューサ・アプリケーションをデプロイする手順は次のとおりです。

1. WLS管理コンソールにログインします。

WLS管理コンソールへのログインの詳細は、「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「デプロイメント」をクリックします。

「デプロイメントのサマリー」ページが表示されます。

3. 「インストール」をクリックします。

「アプリケーション・インストール・アシスタント」ページが表示されます。

4. 「アプリケーション・インストール・アシスタント」の「パス」フィールドを使用して、インストールするポートレット・プロデューサ・アプリケーションに対応するEARファイルを検索します。EARファイルを選択して、「次へ」をクリックします。

「アプリケーション・インストール・アシスタント」ページの2ページ目が表示されます。

5. 「Install this deployment as an application」を選択してから「Next」をクリックします。

「アプリケーション・インストール・アシスタント」の3ページ目が表示されます。

6. アプリケーションのデプロイ先デプロイ・ターゲットを選択し、「次へ」をクリックします。

7. 指定した構成設定を確認し、「終了」をクリックしてインストールを完了します。

デプロイメント後にプロデューサURLを変更するには、Fusion Middleware ControlまたはWLSTコマンドを使用してプロデューサURLエンドポイントを変更し、その後、アプリケーションを再デプロイします。

18.6.4 WLSTを使用したポートレット・プロデューサ・アプリケーションのデプロイ

WLSTコマンド行を使用して、ポートレット・プロデューサをデプロイできます。

WLSTコマンド行を使用してポートレット・プロデューサ・アプリケーションをデプロイするには、WLSTが管理サーバーと接続している必要があります。管理サーバーをホストしているコンピュータで、deployコマンドを起動する必要があります。

WLSTを使用してポートレット・プロデューサ・アプリケーションをデプロイする手順は次のとおりです。

1. WLSTシェルを起動します。

WLSTシェルの起動の詳細は、「Oracle WebLogic Scripting Tool (WLST)」を参照してください。

2. Oracle WebCenter Portalインストールの管理サーバーに接続します。

connect("user_name","password","host_name:port")

ここで:

- user_nameは、管理サーバーにアクセスするユーザーの名前です(例: weblogic)。

- passwordは、管理サーバーにアクセスするためのパスワードです(例: welcome1)。

- 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)。詳細は、『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』の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コマンドを使用してポートレット・プロデューサ・アプリケーションをデプロイします。

deploy(app_name, path, [targets] [stageMode], [planPath], [options])

ここで:

- appNameは、デプロイするポートレット・プロデューサ・アプリケーションの名前です(例: myPortlets)。

- pathは、デプロイするEARファイルへのパスです(例: /tmp/customApp.ear)。

- targetsには、アプリケーションのデプロイ先管理対象サーバーを指定します(例: AppServer)。オプションで、カンマで区切れば複数のターゲットを指定できます。異なるサーバー上にアプリケーション・アーカイブの異なるモジュールをデプロイできるようにするには、たとえばmodule1@server1のように、各ターゲットをモジュール名で修飾します。この引数は、WLSTが現在接続されているサーバーにデフォルト設定されます。

- stageModeには、オプションで、デプロイするアプリケーションのステージング・モードを定義します。有効な値はstage、nostage、およびexternal_stageです。

- planPathには、オプションで、デプロイ・プラン・ファイルの名前を定義します。ファイル名は、絶対名にすることも、アプリケーション・ディレクトリに対する相対名にすることもできます。この引数のデフォルトは、アプリケーション・ディレクトリのplan/plan.xmlファイル(存在する場合)です。

- optionsは、オプションで、名前と値のペアとして指定したデプロイメント・オプションのカンマ区切りリストです。有効なオプションの詳細は、『WebLogic Server WLSTコマンド・リファレンス』のdeployに関する項を参照してください。

次のメッセージが表示されたら、アプリケーションが正常にデプロイされて、アクセスの準備ができたことを意味します。

Completed the deployment of Application with status completed

注意:

WLSTはデプロイ時に接続変更のプロンプトを表示しないため、EARファイルの接続情報を使用して、前回の起動時のターゲット・プロデューサの場所を特定します。その場所に到達できない場合、ターゲット・プロデューサの起動およびアプリケーションの再起動を行ってアプリケーションをデプロイした後に、場所を修正してください。ポートレット・カスタマイズの移行は自動的に開始されます。

プロデューサ接続が、接続可能な間違ったプロデューサを指している場合(たとえば、開発プロデューサ)、ポートレット・カスタマイズの移行はそれらのプロデューサを使用して開始されます。間違っていても移行は完了しているため、アプリケーションを再起動しても移行処理は自動的には起動されません。

これを解決するには、デプロイメントの後、Fusion Middleware ControlまたはWLSTコマンドを使用してプロデューサURLエンドポイントを変更し、その後、アプリケーションを再デプロイします。

18.6.5 Oracle JDeveloperを使用したポートレット・プロデューサ・アプリケーションのデプロイ

WebLogicサーバーへのアクセスに必要な資格証明がある場合は、Oracle JDeveloperを使用してポートレット・プロデューサ・アプリケーションを開発環境からOracle WebLogic管理対象サーバー・インスタンスに直接デプロイできます。

詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のポートレット・プロデューサのデプロイに関する項を参照してください。

18.7 Oracle PDK-Javaポートレット・プロデューサの管理

システム管理者は、Fusion Middleware ControlまたはWLSTコマンド行ツールを使用して、WebCenter PortalのOracle PDK-Javaポートレット・プロデューサを登録および管理できます。

この項には次のトピックが含まれます:

- Oracle PDK-Javaポートレット・プロデューサの登録

- Oracle PDK-Javaプロデューサの接続テスト

- Oracle PDK-Javaポートレット・プロデューサの登録情報の編集

- Oracle PDK-Javaポートレット・プロデューサの登録解除

18.7.1 Oracle PDK-Javaポートレット・プロデューサの登録

Fusion Middleware Control、WLSTコマンドまたはWebCenter Portal管理を使用して、Oracle PDK-Javaポートレット・プロデューサを登録できます。

Fusion Middleware Controlを使用したOracle PDK-Javaポートレット・プロデューサの登録

Fusion Middleware Controlを使用してOracle PDK-Javaポートレット・プロデューサを登録する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。
「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。

3. 「ポートレット・プロデューサ接続の追加」セクションで、Oracle PDK-Javaプロデューサの接続の詳細を入力します。
パラメータの詳細は、「Oracle PDK-Javaポートレット・プロデューサの接続パラメータ」を参照してください。

4. 「OK」をクリックします。
新しいプロデューサが接続表に表示されます。

WLSTを使用したOracle PDK-Javaポートレット・プロデューサの登録

WLSTコマンドのregisterPDKJavaProducerを使用して、PDK-Javaポートレット・プロデューサとの接続を作成し、WebCenter Portalにプロデューサを登録します。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのregisterPDKJavaProducerに関する項を参照してください。

関連項目:

deregisterPDKJavaProducer、listPDKJavaProducers、refreshProducer

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

WebCenter PortalでのOracle PDK-Javaポートレット・プロデューサの登録

WebCenter PortalでOracle PDK-Javaポートレット・プロデューサを登録する手順は次のとおりです。

1. WebCenter Portal管理を開きます。
詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ポートレット・プロデューサ」を選択します。
または、次のURLを使用して、「ポートレット・プロデューサ」を選択します。

http://host:port/webcenter/portal/admin/settings/tools

3. メニュー・バーの「登録」をクリックします。

4. 「ポートレット・プロデューサの登録」ページで、Oracle PDK-Javaプロデューサの接続の詳細を入力します。詳細は、「Oracle PDK-Javaポートレット・プロデューサの接続パラメータ」を参照してください。

5. 「テスト」をクリックして、指定したサーバーの詳細が正しいことを確認します。
サーバーに接続できると、成功メッセージが表示されます。サーバーがダウンしている、またはホスト情報が正しくないか有効でない場合、接続の失敗メッセージが表示されます。

注意:

テストでは、サーバー(ホスト/ポート)の単純なPINGテストが実行されます。host:portの後のパス内のすべてのものが無視されます。プロデューサがアクセス可能かどうかを確認するには、ブラウザでプロデューサのテスト・ページにアクセスします。詳細は、「Oracle PDK-Javaプロデューサの接続テスト」を参照してください。

6. 「OK」をクリックします。

18.7.2 Oracle PDK-Javaプロデューサの接続テスト

Oracle PDK-Javaポートレット・プロデューサ接続を検証するには、プロデューサURLをブラウザ・ウィンドウで実行します。

次の形式を使用します。

http://host:port/context-root/providers/producer_name

例:

http://domain.example.com:7778/axyz/providers/sample

18.7.3 Oracle PDK-Javaポートレット・プロデューサの登録情報の編集

WebCenter Portalには、Oracle PDK-Javaポートレット・プロデューサの登録情報を編集する複数のツールが用意されています。

Fusion Middleware Controlを使用したOracle PDK-Javaポートレット・プロデューサの登録情報の編集

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。詳細は、次を参照してください。
詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ポートレット・プロデューサ」を選択します。

4. 「ポートレット・プロデューサ接続の管理」セクションで、変更するプロデューサを選択して「編集」をクリックします。

5. 「ポートレット・プロデューサ接続の編集」セクションで、必要に応じて接続の詳細を変更します。
詳細は、「Oracle PDK-Javaポートレット・プロデューサの接続パラメータ」を参照してください。

6. 「OK」をクリックします。

WLSTを使用したOracle PDK-Javaポートレット・プロデューサの登録情報の編集

WLSTコマンドのsetPDKJavaProducerを使用して、Oracle PDK-Javaポートレット・プロデューサの接続の詳細を編集します。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetPDKJavaProducerに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

WebCenter Portalでの Oracle PDK-Javaポートレット・プロデューサの登録情報の編集

WebCenter Portalでは、ポートレット・プロデューサに指定された多くの登録情報にアクセスして変更できます。

1. WebCenter Portal管理を開きます。
詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ポートレット・プロデューサ」を選択します。
または、次のURLを使用して、「ポートレット・プロデューサ」を選択します。

http://host:port/webcenter/portal/admin/tools

3. 編集するポートレット・プロデューサを選択します。

4. メニュー・バーの「編集」をクリックします。

5. プロデューサ登録のプロパティを必要に応じて編集します。
詳細は、「Oracle PDK-Javaポートレット・プロデューサの接続パラメータ」を参照してください。

「プロデューサ名」または「プロデューサ・タイプ」は編集できません。

注意:

「URLエンドポイント」の値は編集可能ですが、たとえば、プロデューサのポートが変更されたときに別のプロデューサをポイントするには、新しいプロデューサが元のプロデューサの永続性ストアにアクセスできるか、または元のプロデューサの永続性ストアが新しいプロデューサの永続性ストアに移行されていることが必要です。詳細は、「他のスキーマ・データ(ACTIVITIESとPORTLET)のバックアップおよびリストア」を参照してください。

6. 必要な設定をすべて変更したら、「テスト」をクリックして、指定したサーバーの詳細が正しいことを確認します。
サーバーに接続できると、成功メッセージが表示されます。サーバーがダウンしている、またはホスト情報が正しくないか有効でない場合、接続の失敗メッセージが表示されます。

注意:

テストでは、サーバー(ホスト/ポート)の単純なPINGテストが実行されます。host:portの後のパス内のすべてのものが無視されます。プロデューサがアクセス可能かどうかを確認するには、ブラウザでプロデューサのテスト・ページにアクセスします。詳細は、「Oracle PDK-Javaプロデューサの接続テスト」を参照してください。

18.7.4 Oracle PDK-Javaポートレット・プロデューサの登録解除

WebCenter Portalには、WSRPポートレット・プロデューサの登録を解除する複数のツールが用意されています。

WSRPポートレット・プロデューサはいつでも登録解除できます。

登録解除されたプロデューサと関連付けられたポートレットは機能しなくなるため、プロデューサを登録解除する前に、WebCenter Portalへの影響を考慮してください。ポートレット・プロデューサ呼出しのメトリックをチェックして、プロデューサの使用頻度を確認します。詳細は、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

プロデューサの登録を解除すると、WebCenter Portalとリモート・プロデューサの両方から登録データが削除されます。

- WebCenter Portal - プロデューサ接続は削除され、プロデューサのメタデータも削除されます。

- リモート・プロデューサ: (ポートレット自体ではなく)ポートレット・インスタンスが削除されます。

ポートレット・インスタンスはWebCenter Portalページから削除されません。ユーザーには、ポートレットのかわりに「ポートレットがありません」というメッセージが表示されます。

注意:

このポートレット・プロデューサに関連付けられている外部アプリケーションの目的がこのプロデューサをサポートすることのみであれば、その外部アプリケーションを削除することも考慮してください。「外部アプリケーション接続の削除」を参照してください。

Fusion Middleware Controlを使用したOracle PDK-Javaポートレット・プロデューサの登録解除

Fusion Middleware Controlを使用してOracle PDK-Javaポートレット・プロデューサを登録解除する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。
「WebCenter Portalのホームページへの移動」を参照してください

2. 「WebCenter Portal」メニューから「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「ポートレット・プロデューサ」を選択します。

4. 登録を解除するプロデューサの名前を選択し、「削除」をクリックします。
接続の詳細が削除されます。このプロデューサに関連付けられたポートレットに、WebCenter Portalからアクセスできなくなります。

WLSTを使用したOracle PDK-Javaポートレット・プロデューサの登録解除

WLSTコマンドのderegisterPDKProducerを使用して、Oracle PDK-Javaポートレット・プロデューサを登録解除します。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのderegisterPDKJavaProducerに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

WebCenter PortalでのOracle PDK-Javaポートレット・プロデューサの登録解除

WebCenter PortalでOracle PDK-Javaポートレット・プロデューサを登録解除する手順

1. WebCenter Portal管理を開きます。
詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください。

2. 「ツールとサービス」をクリックして、「ポートレット・プロデューサ」を選択します。
または、次のURLを使用して、「ポートレット・プロデューサ」を選択します。

http://host:port/webcenter/portal/admin/settings/tools

3. 登録解除するポートレット・プロデューサを選択します。

4. メニュー・バーの「登録解除」をクリックします。

5. 「削除の確認」ダイアログで、「登録解除」をクリックして登録解除のプロセスを完了します。

18.7.5 Oracle PDK-Javaポートレット・プロデューサの接続パラメータ

Oracle PDK-Javaポートレット・プロデューサを登録する場合は、設定する必要がある接続パラメータがいくつかあります。

表18-6 Oracle PDK-Javaポートレット・プロデューサの接続パラメータ

フィールド

説明

接続名

WebCenter Portal内のこのポートレット・プロデューサ登録を識別する一意名を入力します。名前は、すべてのWebCenter Portal接続タイプにおいて一意である必要があります。

ここで指定する名前は、リソース・カタログ(「ポートレット」フォルダの下)に表示されます。

プロデューサ・タイプ

「Oracle PDK-Javaプロデューサ」を選択します。

URLエンドポイント

次の構文を使用して、Oracle PDK-JavaプロデューサのURLを入力します。

http://host:port/context_root/providers

ここで:

- hostはプロデューサがデプロイされているサーバーです

- portはHTTPリスナーのポート番号です

- context_rootは、Webアプリケーションのコンテキスト・ルートです

- providersは、静的テキストです。

例

http://myHost.com:7778/myEnterprisePortlets/providers

サービスID

このプロデューサの一意の識別子を入力します。

PDK-Javaでは、1つのアダプタ・サーブレットの下に複数のプロデューサをデプロイできます。プロデューサは、それらのユニークなサービスIDで識別されます。サービスIDがURLのエンド・ポイントに追加されていないときにのみ、指定する必要があります。たとえば、次の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つが認証を必要とする場合は、「関連付けられている外部アプリケーション」ドロップダウンを使用して、正しい外部アプリケーションを指定します。

目的のアプリケーションがリストに表示されない場合は、「新規作成」を選択して、ここで外部アプリケーションを定義します。

「外部アプリケーションの登録」も参照してください。

セッションを確立しますか。

これを選択した場合、このプロデューサからポートレットを実行するときにユーザー・セッションが有効化されます。セッションが有効な場合、それらはプロデューサのサーバーに保持されます。これによりポートレット・コードはセッションに情報を保持できます。

メッセージ認証はセッションを使用します。このため、共有鍵を指定するには、このオプションを選択する必要があります。

プロデューサとサーバーの間でセッションレス通信を行う場合は、このオプションを選択しないでください。

デフォルトの実行タイムアウト(秒)

プロデューサとの通信で適切なタイムアウト時間(秒単位)を入力します。たとえば、プロデューサがWebCenter Portalページ上にポートレットを登録、登録解除または表示するために許容される最大時間です。これはデフォルトで30秒に設定されます。

個々のポートレットは、その自体のタイムアウト時間を定義する場合があります。このタイムアウト値は、ここで指定されている値よりも優先されます。

サブスクライバID

登録するプロデューサのコンシューマを識別する文字列を入力します。

プロデューサがWebCenter Portalに登録されている場合は、プロデューサへのコールが行われます。コール中に、コンシューマ(このインスタンスではWebCenter Portal)は、プロデューサにサブスクライバIDの値を渡します。プロデューサは、サブスクライバIDの希望する値を表示しない場合、登録の呼出しを拒否する可能性があります。

共有鍵

暗号化を処理するように設定されているプロデューサに使用する共有鍵を入力します。

共有鍵は、メッセージ認証用のメッセージ署名を生成するための暗号化アルゴリズムで使用されます。共有鍵を使用してプロデューサが設定されている場合、ここに間違った共有鍵を入力すると、プロデューサ登録は失敗するので注意してください。共有キーは、10文字から20文字までの英数字を含むことができます。

共有鍵はHMACキーとも呼ばれます。

19 ページレット・プロデューサの管理

Oracle WebCenter Portalのページレット・プロデューサは(以前はOracle WebCenter Ensembleと呼ばれていました)、ページレットの動的な開発とデプロイに役立つ有用なツールのセットを提供します。ページレット・プロデューサのプロキシは、内部のアプリケーションや保護されたコンテンツを含む内部リソースへの外部アクセスをユーザーに提供します。ページレット・プロデューサを使用すれば、WSRPポートレットとOpenSocialガジェットを、Webページまたはアプリケーションで使用できるようにページレットとして公開できます。

この章では、ページレット・プロデューサの管理コンソールを使用してページレットを登録、編集およびデプロイする方法について説明します。

この章の内容は次のとおりです。

- ページレット・プロデューサについて

- ページレット・プロデューサの登録

- ページレット・プロデューサでのWSRPポートレット・プロデューサの登録

- トラスト・サービス・アイデンティティ・アサータの構成

- ページレット・プロデューサ・コンポーネントのインポート、エクスポート、バックアップおよびリカバリの管理

ページレットの開発とデプロイの詳細は、Oracle JDeveloperによるWebCenter Portalアセットおよびカスタム・コンポーネントの開発のページレットの使用に関する項を参照してください。

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、およびOracle WebCenter Portal管理を使用してAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

19.1 ページレット・プロデューサについて

この項では、ページレット・プロデューサの概念と機能について概説します。この項の内容は次のとおりです。

- 概要

- ページレット・プロデューサ・コンソールの使用

- WSRPポートレットの公開

- OpenSocialガジェットの公開

- WebCenter Interactionポートレットの公開

19.1.1 概要

ページレット・プロデューサ(旧称: Oracle WebCenter Ensemble)では、ページレットを作成して、WebCenter Portalアプリケーションなどの他のWeb環境で、プラットフォーム固有のポートレットを公開するために使用できます。ページレット・プロデューサは、動的ページレットの開発を容易にする有用なツールと機能の集まりを提供します。ページレット・プロデューサのアーキテクチャ、コンポーネントの説明およびページレット・プロデューサの要件の詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のページレットの概要に関する項を参照してください。

ページレット・プロデューサの登録は動的です。既存のプロデューサに対する追加と更新はすぐに使用可能になります。ほとんどの場合、アプリケーションや管理対象サーバーを再起動する必要はありません。

注意:

現在のリリースでは、ページレット・プロデューサの管理設定を変更できるのは一度に1人の管理者のみです。同時に複数の編集が行われた場合、1つの編集のみが成功します。ただし、データの整合性は常に保持されます。

19.1.2 ページレット・プロデューサ・コンソールの使用

ページレット・プロデューサ・コンソールは、ページレット・プロデューサのデプロイで様々なオブジェクトの作成と管理に使用されるブラウザ・ベース管理ツールです。このコンソールから、リソースとしてのWebアプリケーションの登録、ページレットの作成、プロキシおよび変換設定の管理などを行うことができます。

- ページレット・プロデューサ・コンソールには、WebCenter Portalの「共有アセット」ページからアクセスできます。

注意:

ページレット・プロデューサ・コンソールでは、標準の管理言語とオランダ語のみがサポートされています。これらの言語以外をブラウザの言語に構成すると、現在のサーバーに定義された言語に戻ります。

- ページレット・プロデューサ・コンソールには、Webブラウザで次のURLを指定してアクセスすることもできます:
http://host:port/pagelets/admin

ページレット・プロデューサ・コンソールは、次の場所からアクセシビリティ・モードで起動することもできます:

http://host:port/pagelets/admin/accessible

ページレット・プロデューサ・コンソールを使用したページレット・プロデューサの構成の詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のページレット・プロデューサの設定の構成に関する項を参照してください。

19.1.3 WSRPポートレットの公開

ページレット・プロデューサを使用すれば、WSRPポートレットをWebページまたはアプリケーションで使用できるようにページレットとして公開できます。

『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のページレット・プロデューサの設定の構成に関する項の説明に従ってページレット・プロデューサを設定した後、次の手順に従ってWSRPポートレットをインポートします。

1. 「ページレット・プロデューサでのWSRPポートレット・プロデューサの登録」で説明しているように、ポートレット・プロデューサをページレット・プロデューサに登録します。

2. これにより、プロデューサのポートレット定義に基づいて、ページレット・プロデューサ・コンソールにリソースとページレットが自動的に作成されます。リソース設定の詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のリソースの作成に関する項を参照してください。

3. インポートされたリソースまたは関連付けられているページレットを変更するには、インポートされたリソースのコピーを作成する必要があります。詳細は、「ポートレットベースのページレットの使用」を参照してください。

同じ手順を実行して、Oracle PDK-Javaポートレットを公開することもできます。

19.1.4 OpenSocialガジェットの公開

ページレット・プロデューサを使用すれば、OpenSocialガジェットをWebページまたはアプリケーションで使用できるようにページレットとして公開できます。詳細は、Oracle JDeveloperによるWebCenter Portalアセットおよびカスタム・コンポーネントの開発のOpenSocialリソース(OpenSocialガジェット・プロデューサ)の構成方法およびOpenSocial設定の構成方法に関する項を参照してください。

19.1.5 WebCenter Interactionポートレットの公開

ページレット・プロデューサを、Oracle WebCenter Interaction用のポートレット・プロバイダとして使用できます。いくつかの構成ページで、Oracle WebCenter Interactionと連携するためのCSP設定を定義できます。これらの設定およびオブジェクトの構成の詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のWCIデータ・ソースの構成方法に関する項およびWebCenter Interactionでのページレットの使用(例)に関する項を参照してください。

1. ページレット・プロデューサ・コンソールのCSP設定ページでページレット・プロデューサの設定を構成して、Oracle WebCenter Interactionの資格証明マッパー、SOAP APIサービスおよびイメージ・サービスとともに使用できるようにします。

2. CSPリソースを作成して、ポートレット・コードをホストするサーバーへのページレット・プロデューサ接続を設定します。

3. Oracle WebCenter Interactionポートレット用のページレットを作成します。

19.2 ページレット・プロデューサの登録

この項では、Fusion Middleware ControlとWLSTコマンドを使用してページレット・プロデューサを登録および構成する方法について説明します。

この項では、次の内容について説明します。

- Fusion Middleware Controlを使用したページレット・プロデューサの登録

- WLSTを使用したページレット・プロデューサの登録

- WebCenter Portal用のページレット・プロデューサ・サービスの構成

- WebCenter Portalを使用したページレット・プロデューサの登録

- ページレット・プロデューサの別のコンテキストへの再デプロイ

ページレットの開発とデプロイの詳細は、Oracle JDeveloperによるWebCenter Portalアセットおよびカスタム・コンポーネントの開発のページレットの使用に関する項を参照してください。

19.2.1 Fusion Middleware Controlを使用したページレット・プロデューサの登録

Fusion Middleware Controlを使用してページレット・プロデューサを登録するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「プロデューサの登録」を選択します。

3. ページレット・プロデューサの接続の詳細を入力します(表19-1)。

表19-1 ページレット・プロデューサの接続パラメータ

フィールド

説明

接続名

このページレット・プロデューサのインスタンスをアプリケーション内で識別するための一意の名前。名前は、すべてのWebCenter Portal接続タイプにおいて一意である必要があります。ここで指定した名前は、「UIコンポーネント」→「ページレット・プロデューサ」フォルダにあるコンポーザに表示されます(デフォルト)。

プロデューサ・タイプ

「ページレット・プロデューサ」を選択します。

サーバーURL

ページレット・プロデューサへのURL。URLには、完全修飾ドメイン名を含める必要があります。次の構文を使用します。

<protocol>://<host_name>:<port_number>/pagelets/

例:

http://myhost.com:7778/pagelets/

ページレットにセキュアなデータが含まれている場合、登録するURLでhttpsプロトコルを使用する必要があります。次に例を示します。

https://myhost.com:7779/pagelets/

コンテキスト・ルートは、必要に応じて/pagelets/から変更できます。詳細は、「ページレット・プロデューサの別のコンテキストへの再デプロイ」を参照してください。

注意: WebCenter Portalでは、ページレット・プロデューサのURLがOAMによって保護されている場合、ページレット・カタログへのURLを除外する(アクセス制御なしで直接マップする)必要があります。そうしないと、RESTを使用した場合にカタログが空白になります。ページレット・カタログのURLは、http://<host_name>:<port_number>/ pagelets/api/v2/ensemble/pageletsです

4. 「OK」をクリックします。新しいプロデューサが接続表に表示されます。

19.2.2 WLSTを使用したページレット・プロデューサの登録

registerPageletProducerコマンドを使用して、ページレット・プロデューサをWebCenter Portalアプリケーション用に登録します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのregisterPageletProducerに関する項を参照してください。

WLSTを使用して、現在の接続詳細を表示または編集することもできます。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

19.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)リポジトリに格納されます。詳細は、「Oracle WebCenter Portalの構成に関する考慮事項」を参照してください。MDSの詳細は、『Oracle Fusion Middlewareの管理』の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」サーバーを選択して「保存」をクリックします。

19.2.4 WebCenter Portalを使用したページレット・プロデューサの登録

この項では、WebCenter Portalでページレット・プロデューサを登録する方法について説明します。

WebCenter Portalにログインして「管理」をクリックします。

「ツールとサービス」に移動します

「ポートレット・プロデューサ」をクリックします

1. WebCenter Portalにログインして「管理」をクリックします。

2. 「構成」タブに移動し、「ツールとサービス」をクリックします。

3. 「サービスとプロバイダ」ページで、「ポートレット・プロデューサ」をクリックします。

4. 「登録」をクリックし、「ページレット・プロデューサ」を選択します。

5. ページレット・プロデューサの接続の詳細を入力します(表19-2)。

表19-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/から変更できます。詳細は、「ページレット・プロデューサの別のコンテキストへの再デプロイ」を参照してください。

注意: WebCenter Portalでは、ページレット・プロデューサのURLがOAMによって保護されている場合、ページレット・カタログへのURLを除外する(アクセス制御なしで直接マップする)必要があります。そうしないと、RESTを使用した場合にカタログが空白になります。ページレット・カタログのURLは、http://<host_name>:<port_number>/ pagelets/api/v2/ensemble/pageletsです

19.2.5 ページレット・プロデューサの別のコンテキストへの再デプロイ

場合によっては、ページレット・プロデューサに対して定義したデフォルトのWebコンテキストを変更する必要が生じることがあります。この項では、ページレット・プロデューサを別のコンテキストに再デプロイする方法について説明します。

最初の手順は、管理サーバーに対するページレット・プロデューサのデータ・ソースをターゲットにして、ページレット・プロデューサEARファイルを見つけます。

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 JDeveloperによるWebCenter Portalアセットおよびカスタム・コンポーネントの開発のOpenSocial設定の構成方法に関する項を参照してください。

19.3 ページレット・プロデューサでのWSRPポートレット・プロデューサの登録

ページレット・プロデューサは、Oracle WebCenter Portalおよびサードパーティ・ポータルで使用できるようにWSRPポートレットをページレットとして公開できますが、ポートレット・プロデューサをページレットとして使用する前に、それを登録する必要があります。

Fusion Middleware Controlを使用してWSRPポートレット・プロデューサを登録する手順は次のとおりです。

ページレット・プロデューサ・コンソールを使用してWSRPエンドポイントをポートレット・プロデューサとして登録したり、「ポートレット・プロデューサの管理」で説明しているように、Fusion Middleware Control、WLSTまたは「WebCenter管理」ページを使用することもできます。登録すると、新しいページレット・プロデューサ・リソースが作成され、WSRPエンドポイントに関連付けられたポートレットを表示するページレットが自動的にそのリソースに移入されます。

注意:

ポートレット・プロデューサを登録した後、ポートレット・リソースのコピーを作成し、Oracle WebCenter Portalで使用するリソースのコピーの名前を変更します。

ページレット・プロデューサ・コンソールからポートレット・プロデューサ設定にアクセスする手順は次のとおりです。

1. 管理者としてWebCenter Portalにログインし、「管理」ページに移動します。

2. 「共有アセット」タブを開き、「ページレット」を選択します。

3. 「作成」をクリックし、ページレット・プロデューサにログインします。

4. ナビゲータのツールバー・メニューから「プロデューサ」を選択し、「登録」をクリックします。

5. 「ポートレット・プロデューサの登録」ページで、プロデューサの登録情報を入力します。パラメータの詳細は、「WSRPプロデューサの接続パラメータ」を参照してください。

6. 「テスト」をクリックして設定をテストし、プロデューサを登録する準備が整っている場合は「OK」をクリックし、ページレット・プロデューサ・コンソールに戻る場合は「取消」をクリックします。

19.4 ポートレットベースのページレットの使用

自動生成されたポートレット・リソースとページレットは変更できません。プロデューサに変更を加えて永続的な参照を作成するには、自動生成されたアセットを最初にコピーする必要があります。「共有アセット」ページでアセットを選択し、「アクション」メニューの「コピー」を選択します。コピーされたバージョンのリソースは編集可能であり、インジェクタなどの様々な要素を追加してページレットの機能をカスタマイズできます。レプリケートされたリソースはメタデータのエクスポートに含められます。

既存のポートレット・プロデューサに基づいて新規リソースを作成してから個々のページレットを作成する方法で、ポートレット・ベースのページレットを白紙の状態から定義することもできます。詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のページレットとしてのWSRPポートレットの使用に関する項を参照してください。

19.5 トラスト・サービス・アイデンティティ・アサータの構成

この項では、トラスト・サービス・アイデンティティ・アサータを構成する方法について説明します。

この項には次のトピックが含まれます:

- トラスト・サービス・アイデンティティ・アサータについて

- トラスト・サービス・アイデンティティ・アサータの構成の準備

- トラスト・サービス・アイデンティティ・アサータの構成の実行

19.5.1 トラスト・サービス・アイデンティティ・アサータについて

WebCenter Portalは、サーバー間のRESTコールを使用してページレット・プロデューサと通信します。管理ユーザーのアイデンティティをページレット・プロデューサに渡すには、WLSのトラスト・サービス・アイデンティティ・アサータをページレット・プロデューサ(サーバー)で設定し、OPSSキーストア・サービスの資格証明をページレット・プロデューサ(サーバー)とWebCenter Portal (クライアント)の両方で設定する必要があります。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のアプリケーション・セキュリティとOPSSの統合に関する項を参照してください。

19.5.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の実行前に入力しておく必要があります。

表19-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に含まれるキー・ペアの公開鍵のエクスポート先とエクスポート元になるファイル・パスです。

/home/user/Oracle/Middleware/user_projects/domains/my_domain/config/fmwconfig/wckey.cer

前述のプロパティに加え、複数のオプションのプロパティがconfigureTrustServiceIdentityAsserter.propertiesで定義されています。これらのプロパティがファイルで定義されていない場合は、次の「デフォルト値」列の下にリストされた値が使用されます。

表19-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ファイルを開いてください。各プロパティの完全な説明と、トラスト・アイデンティティ・アサーションの全体的な構成プロセスは、インライン・コメントに記載されています。

19.5.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は必要ありません。

19.6 ページレット・プロデューサ・コンポーネントのインポート、エクスポート、バックアップおよびリカバリの管理

ページレット・プロデューサは、その構成とコンテンツに関連したデータをOracleメタデータ・ストア(MDS)に格納し、障害回復や、開発からステージングおよび本番までの本番ライフサイクル全体を容易にします。この項では、使用できるインポート、エクスポートおよびバックアップの各機能について説明します。

- ページレット・プロデューサのリソースのエクスポートおよびインポート

- WLSTを使用したページレット・プロデューサ・メタデータのエクスポートおよびインポート

- ページレット・プロデューサのバックアップおよびリストア

MDSの詳細は、『Oracle Fusion Middlewareの管理』のOracle Metadata Repositoryの管理に関する項を参照してください。

19.6.1 ページレット・プロデューサのリソースのエクスポートおよびインポート

ページレット・プロデューサ・アセットは、ページレット・プロデューサ・コンソールを使用してエクスポートおよびインポートできます。WebCenter Portalの「共有アセット」ページから、ページレットを直接エクスポートまたはインポートすることはできません。ページレット・プロデューサ共有アセットをエクスポートまたはインポートする場合は、この項で説明するようにページレット・プロデューサ・コンソールを使用するか、「WLSTを使用したページレット・プロデューサ・メタデータのエクスポートおよびインポート」で説明するように従ってWLSTを使用する必要があります。

ページレット・プロデューサ・コンソールを使用して、ページレット・プロデューサ・アセットをインポートまたはエクスポートするには:

1. 次のいずれかの方法でページレット・プロデューサ・コンソールを開きます。

- WebCenter Portalで、「管理」→「共有アセット」→「ページレット」に移動します。「作成」をクリックし、「続行」をクリックして、ページレット・プロデューサ・コンソールを開きます。WebCenter Portalに戻る準備が整ったら、「取消」をクリックします。

- 次のURLにナビゲートします。
http://<host_name>:<port_number>/pagelets/admin。

2. 「移動先:」ドロップダウン・リストから「エクスポート/インポート」を選択します。

3. 「エクスポート」、「インポート」、「変数」のいずれかをクリックして、実行するアクティビティを選択します。

- アセットのリストから選択したものを新しいMDSパッケージにエクスポートする場合は、「エクスポート」ペインを使用します。

- 既存のMDSパッケージを参照して、そのパッケージをページレット・プロデューサにインポートする場合は、「インポート」ペインを使用します。

- ルートURLの変数を定義し、内部URLを保護してインポートを簡易化する場合は、「変数」ペインを使用します。

4. リソースをエクスポートするには、「エクスポート」をクリックします。
「エクスポート」ペインが表示されます(図19-1を参照)

図19-1 ページレット・プロデューサ・コンソール: 「エクスポート」ペイン

a. エクスポートに含めるアイテムを確認します。

b. 「次へ」をクリックします。
ホストURLが表示されます(図19-2)。

図19-2 ホストURL

c. 「ホスト」にURLを入力し(このURLが定義されている場合は、「変数」フィールドをクリックして変数を使用する)、「エクスポート」をクリックします。

5. リソースをインポートするには、「インポート」をクリックします。
「インポート」ペインが表示されます(図19-1を参照)。

図19-3 ページレット・プロデューサ・コンソール: インポート・オプション

a. 「参照」をクリックして、インポートするファイルを選択します。

b. 「送信」をクリックして、インポートを開始します。

c. プロンプトが表示された場合は、「スキップ」または「上書き」(インポートのターゲット側に既存のリソースがある場合)を選択します。

6. 変数を定義するには、「変数」をクリックします。
「変数」ペインが表示されます(図19-4を参照)。

図19-4 ページレット・プロデューサ・コンソール: 「変数」ペイン

a. 「変数の追加」をクリックします。

b. 「ホスト」フィールドにホスト名を入力します。

c. ホストURLに関連付ける変数名を「変数」フィールドに入力します。

d. 変数の追加を続けるには、「変数の追加」をクリックします。
追加が完了すると、「エクスポート」ペインでホストURLの一部として変数が使用できるようになります。

19.6.2 WLSTを使用したページレット・プロデューサ・メタデータのエクスポートおよびインポート

ページレット・プロデューサで作成したメタデータはMDSに格納され、WLSTを使用してアクセスできます。WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

現在はWLSTを使用したグローバル移行のみがサポートされており、ソース環境のすべてのデータはエクスポート済のMDSパッケージに格納され、ターゲット環境内のすべてのデータはそのパッケージがインポートされる時点で上書きされます。

注意:

WebCenter Portal実装をステージングから本番に移行する場合、ページレット・プロデューサのデータのエクスポートとインポートは、移行ツールによって処理されます。ただし、ステージング環境でページレット・プロデューサのオブジェクトに変更が加えられている場合、これらの変更は、この項で説明されているWLSTコマンドを使用して、個別に移行する必要があります。移行後にページレット・プロデューサが動作しない場合は、WebCenter Portalアプリケーションでページレット・プロデューサ用に定義したサーバーURLを確認してください。このURLの設定の詳細は、「ページレット・プロデューサの登録」を参照してください。WebCenter Portalの移行の詳細は、「WebCenter Portalのライフ・サイクルの理解」を参照してください。

19.6.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: ドキュメントの完全修飾名とドキュメント名パターン(*および**のパターン)のカンマ区切りのリスト。

構文の詳細と例は、WebCenter WLSTコマンド・リファレンスのexportMetadataに関する項を参照してください。

19.6.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: ドキュメントの完全修飾名とドキュメント名パターン(*および**のパターン)のカンマ区切りリスト。

構文の詳細と例は、WebCenter WLSTコマンド・リファレンスのimportMetadataに関する項を参照してください。

注意:

オブジェクトの構成で使用した環境固有のURLは、インポート後は手動で更新する必要があります。

19.6.3 ページレット・プロデューサのバックアップおよびリストア

ページレット・プロデューサのバックアップとリカバリの操作は、標準MDSバックアップおよびリストアの一部であり、データベースのエクスポート・ユーティリティおよびインポート・ユーティリティやその他の様々なツールを使用して管理できます。詳細は、『Oracle Fusion Middlewareの管理』の高度な管理: バックアップとリカバリに関する項を参照してください。

デフォルトでは、ページレット・プロデューサの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>

20 外部アプリケーションの管理

この章では、WebCenter Portalデプロイメントの外部アプリケーションを登録および管理する方法について説明します。

外部アプリケーションは独自の認証プロセスを実装したアプリケーションです。つまり、これはWebCenter Portalアプリケーションのシングル・サインオン・プロセスに参加しないアプリケーションのことです。

アプリケーション管理者は、Fusion Middleware ControlまたはWLSTコマンド行ツールを使用するか、実行時に初期設定の管理ページまたは外部アプリケーション・タスク・フローを使用して、外部アプリケーションを登録および管理できます。

デプロイ後にWebCenter Portalに対して行った外部アプリケーションの変更はすべて、MDSリポジトリにカスタマイズとして格納されます。

注意:

外部アプリケーションの構成は動的です。WebCenter Portalの構成変更は即時反映されます。アプリケーションや管理対象サーバーを再起動する必要はありません。

この章の内容は次のとおりです。

- 外部アプリケーションについて

- 外部アプリケーションの登録

- 外部アプリケーション接続の詳細の変更

- WebCenter Portal管理コンソールを使用した外部アプリケーションの管理

- 外部アプリケーション接続のテスト

- 外部アプリケーション接続の削除

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、WebCenter Portal管理を使用して付与されるAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

20.1 外部アプリケーションについて

独自の認証を処理するアプリケーションとWebCenter Portalがやり取りする場合、そのアプリケーションと外部アプリケーション定義を関連付けて、資格証明プロビジョニングに備えることができます。そのためには、外部アプリケーション定義を使用して、それらの個別に認証されたアプリケーションからコンテンツにアクセスする手段を指定します。

外部アプリケーション・サービスは、エンド・ユーザー側からのシングル・サインオン操作を再現するために、ユーザー名とパスワードおよび外部アプリケーション用のその他の資格証明をすべて取得し、これらの情報を資格証明が必要なWebCenter Portalツールやアプリケーションに渡します。WebCenter Portalツールや他のアプリケーションは、この情報をエンド・ユーザーのかわりに使用してログインします。このユーザー名とパスワードの組合せは、アプリケーションがデプロイされているWebLogicドメイン用に構成された資格証明ストアにセキュアに格納されます。

注意:

外部アプリケーションへのログイン時に、「ログイン情報を保存する」チェック・ボックスを選択しない場合、高可用性(HA)環境でフェイルオーバーが発生すると、そのユーザー・セッションのプロビジョニング済の資格証明は失われます。同一ユーザー・セッション内で外部アプリケーション・コンテンツにアクセスしようとすると、資格証明を再度指定するように要求されます。

図20-1 外部アプリケーション接続の追加

20.2 外部アプリケーションの登録

WebCenter Portalの外部アプリケーションは、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を再起動する必要はありません。

この項では、次の手順を説明します。

- Fusion Middleware Controlを使用した外部アプリケーションの登録

- WLSTを使用した外部アプリケーションの登録

WebCenter Portal管理を使用した外部アプリケーションの登録の詳細は、「WebCenter Portalのツールおよびサービスの構成」を参照してください。

20.2.1 Fusion Middleware Controlを使用した外部アプリケーションの登録

外部アプリケーションを登録するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「外部アプリケーション」を選択します。

4. 新規の外部アプリケーションを登録するには、「追加」をクリックします。

表20-1 外部アプリケーション接続: 名前

フィールド

説明

アプリケーション名

アプリケーションの名前を入力します。名前は、アプリケーション内で(すべての接続タイプにわたって)一意である必要があります。

例: yahoo

注意: 登録後に「アプリケーション名」を編集することはできません。

表示名

WebCenter Portalユーザーにわかりやすいアプリケーション名を入力します。ここで指定した表示名が、この外部アプリケーションを操作する、アプリケーションのエンド・ユーザーに表示されます。

例: My Yahoo

このフィールドを空白のままにした場合、「アプリケーション名」が使用されます。

5. 外部アプリケーションの一意の名前と、この外部アプリケーションを操作するアプリケーション・ユーザーに表示される表示名を入力します。

表20-2 外部アプリケーション接続: 名前

フィールド

説明

アプリケーション名

アプリケーションの名前を入力します。名前は、アプリケーション内で(すべての接続タイプにわたって)一意である必要があります。

例: yahoo

注意: 登録後に「アプリケーション名」を編集することはできません。

表示名

WebCenter Portalユーザーにわかりやすいアプリケーション名を入力します。ここで指定した表示名が、この外部アプリケーションを操作する、アプリケーションのエンド・ユーザーに表示されます。

例: My Yahoo

このフィールドを空白のままにした場合、「アプリケーション名」が使用されます。

6. 外部アプリケーションのログインの詳細を入力します(表20-3)。

表20-3 外部アプリケーション接続: ログインの詳細

フィールド

説明

自動ログインの有効化

これを選択した場合、ユーザーはこのアプリケーションに自動的にログインできます。このオプションを選択した場合、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. 外部アプリケーションで使用される認証方式を選択します(表20-4)。

表20-4 外部アプリケーション接続: 認証の詳細

フィールド

説明

認証方式

外部アプリケーションで使用されるフォーム送信方式を選択します。次のいずれかを選択します。

- GET: ページ・リクエストをサーバーに送信し、ログイン資格証明をログインURLの一部として送信します。この認証方式を使用すると、ユーザー名とパスワードがURL内に公開されるため、セキュリティ・リスクが発生する可能性があります。

- POST: ログイン資格証明をフォームの本文内で送信します。これはデフォルトです。

- 基本: ログイン資格証明をリクエスト内の認証ヘッダーとしてサーバーに送信します。この認証方式を使用すると、資格証明が傍受されやすいうえ、このスキームではサーバーから返される情報が保護されないため、セキュリティ・リスクが発生する可能性があります。クライアントとサーバーのコンピュータの間の接続が安全であり、信頼できることが前提となります。

「認証方式」は、ブラウザからメッセージが送信される方法を指定します。この値は、外部アプリケーションのログイン・フォームのHTMLソース(たとえば、<form method="POST" action="https://login.yahoo.com/config/login?" AutoComplete="off">)を表示すると調べることができます。

8. 必要な場合、追加のログイン・フィールドおよび詳細を指定します。

詳細については、表20-5を参照してください。

表20-5 外部アプリケーション接続: 追加ログイン・フィールド

フィールド

説明

追加ログイン・フィールド

アプリケーションに追加のログイン基準が必要な場合は、「追加ログイン・フィールド」を開きます。

たとえば、Lotus Notesアプリケーションでは、user nameとpasswordの他に2つのフィールド(HostとMailFilename)が必要です。

「追加」をクリックして、ログイン・フォームの追加フィールドを指定します。それぞれの新しいフィールドで次を実行します。

- 名前: ユーザーがログインするために入力する必要のあるHTMLログイン・フォームのフィールドを識別する名前を入力します。アプリケーションで基本認証が使用される場合、このフィールドは適用されません。

- 値: フィールドのデフォルト値を入力するか、ユーザーが指定できるように空白のままにしておきます。アプリケーションで基本認証が使用される場合、このフィールドは適用されません。

- ユーザーに表示: これを選択した場合、外部アプリケーションのログイン画面にこのフィールドが表示されます。このフィールドを表示しない(チェック・ボックスを選択しない)場合は、デフォルトの「値」を指定する必要があります。

ログイン・フィールドを削除するには、「削除」をクリックします。

9. 必要な場合、共有ユーザー資格証明およびパブリック・ユーザー資格証明を指定します(表20-6)。

表20-6 外部アプリケーション接続: 共有ユーザー資格証明とパブリック・ユーザー資格証明

フィールド

説明

共有資格証明の有効化

この外部アプリケーションで共有ユーザー資格証明を有効にするかどうかを指定します。有効にする場合は資格証明を指定します。「共有資格証明の有効化」を選択してから、共有ユーザーの「ユーザー名」および「パスワード」資格証明を入力します。

共有資格証明が指定されると、WebCenter Portalからこの外部アプリケーションにアクセスするすべてのユーザーは、ここで定義されたユーザー名とパスワードを使用して認証します。WebCenter Portalユーザーには、ログイン・フォームは表示されません。

WebCenter Portalユーザーが自分自身の資格証明を定義する必要はないため、共有資格証明を持つ外部アプリケーションは外部アプリケーションのパスワード変更タスク・フロー(「マイ・アカウント」など)では表示されません。

パブリック資格証明の有効化

認証されていないユーザー(パブリック・ユーザー)がこの外部アプリケーションにアクセスできるかどうかを指定します。「パブリック資格証明の有効化」を選択してから、パブリック・ユーザーの「ユーザー名」および「パスワード」資格証明を入力します。

パブリック資格証明が指定されると、WebCenter Portalのパブリック・ページからこの外部アプリケーションにアクセスするパブリック・ユーザーは、ここで定義されたユーザー名とパスワードを使用してログインします。パブリック資格証明を指定しない場合、パブリック・ユーザーには、この外部アプリケーションにパブリック・ユーザーがアクセスできないことを示す認可エラーが表示されます。

10. 「OK」をクリックして、アプリケーションを登録します。

20.2.2 WLSTを使用した外部アプリケーションの登録

WLSTコマンドのcreateExtAppConnectionを使用して、外部アプリケーション接続を作成します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのcreateExtAppConnectionに関する項を参照してください。

WLSTコマンドのaddExtAppCredentialを使用して、外部アプリケーション接続の共有資格証明またはパブリック資格証明を追加します。詳細は、WebCenter WLSTコマンド・リファレンスのaddExtAppCredentialに関する項を参照してください。

WLSTコマンドのaddExtAppFieldを使用して、既存の外部アプリケーション接続に追加のログイン基準を定義します。詳細は、WebCenter WLSTコマンド・リファレンスのaddExtAppFieldに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

20.3 外部アプリケーション接続の詳細の変更

この項では、外部アプリケーション接続の詳細を変更する方法を説明します。この項の内容は次のとおりです。

- Fusion Middleware Controlを使用した外部アプリケーション接続の変更

- WLSTを使用した外部アプリケーション接続の変更

20.3.1 Fusion Middleware Controlを使用した外部アプリケーション接続の変更

外部アプリケーション接続の詳細を更新するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「外部アプリケーション」を選択します。

4. 変更する外部アプリケーションの名前を選択し、「編集」をクリックします。

5. 必要に応じて接続の詳細を編集します。パラメータの詳細は、表20-3を参照してください。外部アプリケーションの名前は編集できないので注意してください。

6. 「OK」をクリックして、変更を保存します。

20.3.2 WLSTを使用した外部アプリケーション接続の変更

WLSTコマンドのsetExtAppConnectionを使用して、既存の外部アプリケーション接続の詳細を編集します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetExtAppConnectionに関する項を参照してください。

注意:

追加のログイン・フィールドに関連する詳細を編集するには、setExtAppFieldを使用します。既存の共有資格証明またはパブリック資格証明を編集するには、setExtAppCredentialを使用します。

追加のログイン・フィールドを削除するには、removeExtAppFieldを使用します。共有資格証明またはパブリック資格証明を削除するには、removeExtAppFieldを使用します。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

WebCenter Portalでの外部アプリケーションの変更の詳細は、『Oracle WebCenter Portalの使用』の外部アプリケーション接続の詳細の編集に関する項を参照してください。

20.4 WebCenter Portal管理コンソールを使用した外部アプリケーションの管理

外部アプリケーションは独自の認証プロセスを実装したアプリケーションです。つまり、これはWebCenter Portalアプリケーションのシングル・サインオン・プロセスに参加しないアプリケーションのことです。WebCenter Portalアプリケーションが、自身の認証を行うアプリケーションと対話する場合、資格証明プロビジョニングを可能にする外部アプリケーションを登録できます。

デフォルトでは、Administratorロールを持つユーザーにAppConnectionManagerロールが割り当てられるため、アプリケーション管理者は、WebCenter Portal管理コンソールを通じて外部アプリケーションを構成できます。アプリケーション管理者は、WebCenter Portal管理コンソールを通じて、実行時にWebCenter Portalの外部アプリケーションを登録、編集および削除できます。AppConnectionManagerロールの詳細は、「デフォルトのアプリケーション・ロール」を参照してください。

この項には次のトピックが含まれます:

- 外部アプリケーションの登録

- 外部アプリケーションの編集と削除

20.4.1 外部アプリケーションの登録

実行時に外部アプリケーションを登録する手順は次のとおりです。

1. 「サービス」管理タブに移動します。

2. 「外部アプリケーション」を選択します(図20-2)。

3. 「登録」をクリックします。

図20-2 WebCenter Portal管理コンソール: 外部アプリケーション

4. 外部アプリケーションの接続の詳細を入力します。

1つ以上のフィールドの詳細は、次の表を参照してください。

- 表20-1

- 表20-3

- 表20-4

- 表20-5

- 表20-6

5. 「テスト」をクリックして、接続の詳細を検証します。

6. 「OK」をクリックして、アプリケーションを登録します。

20.4.2 外部アプリケーションの編集と削除

実行時に外部アプリケーションを変更または削除する手順は次のとおりです。

1. 「サービス」管理タブに移動します。

2. 「外部アプリケーション」を選択します(図20-2)。

3. 必要な外部アプリケーションを選択し、次のいずれかをクリックします。

- 外部アプリケーションの接続の詳細を更新するには、「編集」をクリックします。

- 外部アプリケーションを削除するには、「登録解除」をクリックします。
外部アプリケーション接続を削除すると、ユーザーはそのアプリケーションにアクセスできなくなり、外部アプリケーションに依存するサービスが正常に機能しなくなる可能性があるため、削除する際は注意してください。

20.5 外部アプリケーション接続のテスト

ログインURLを使用して外部アプリケーションを作成する場合は、そのログインURLにアクセス可能であることを確認します。ダイレクトURLの詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の自動シングル・サインオンに関する項を参照してください。

20.6 外部アプリケーション接続の削除

外部アプリケーション接続を削除すると、WebCenter Portalのユーザーはその外部アプリケーションにアクセスできなくなり、外部アプリケーションに依存するツールまたはサービスが正常に機能しなくなる可能性があるため、削除する際は注意してください。

この項には次のトピックが含まれます:

- Fusion Middleware Controlを使用した外部アプリケーション接続の削除

- WLSTを使用した外部アプリケーション接続の削除

20.6.1 Fusion Middleware Controlを使用した外部アプリケーション接続の削除

外部アプリケーション接続を削除するには:

1. Fusion Middleware Controlにログインし、WebCenter Portalアプリケーションのホームページに移動します。

2. 「WebCenter Portal」メニューから、「設定」→「サービス構成」を選択します。

3. 「WebCenter Portalサービス構成」ページのサービスのリストから、「外部アプリケーション」を選択します。

4. 削除する外部アプリケーションの名前を選択し、「削除」をクリックします。

20.6.2 WLSTを使用した外部アプリケーション接続の削除

WLSTコマンドのdeleteConnectionを使用して、外部アプリケーション接続を削除します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのdeleteConnectionに関する項を参照してください。

注意:

追加のログイン・フィールドを削除するには、removeExtAppFieldを使用します。共有資格証明またはパブリック資格証明を削除するには、removeExtAppCredentialを使用します。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

21 RESTサービスの管理

この章では、Oracle WebCenter PortalのRESTサービスの管理の概要を説明します。

この章の内容は次のとおりです。

- RESTサービスについて

- RESTの有効化に必要な手動構成の実行

- セキュリティ・トークンの理解

- RESTのルート名の変更

- 圧縮の使用

- 認証の処理

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロール、Oracle WebCenter Portal管理でAdministratorロールが付与されている必要があります。

ロールと権限の詳細は、「管理操作、ロールおよびツールの理解」を参照してください。

21.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をサポートするサービスの全リストと、RESTおよびOracle WebCenter Portal REST APIの詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のWebCenter Portal REST APIの使用に関する項を参照してください。

21.2 RESTの有効化に必要な手動構成の実行

Oracle WebCenter Portal REST APIはデフォルトでは有効化されていません。REST APIの動作を有効化するには、2つの異なる構成をサーバー側で行う必要があります。アイデンティティ・アサータを構成し、必要なエントリを資格証明ストアにシードする必要があります。これにより、RESTセキュリティ・トークンが適切に機能するようになります。セキュリティ・トークンの詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のWebCenter Portal REST APIのセキュリティに関する考慮事項に関する項を参照してください。

Oracle WebCenter Portalの初回インストール後に、次の構成作業を行います。構成作業が実行済でないことに気づいた場合も実行してください。

- アイデンティティ・アサータの構成

- WebLogic Server資格証明ストアの構成

21.2.1 アイデンティティ・アサータの構成

REST APIを使用する前に、アイデンティティ・アサータを構成する必要があります。手順の詳細は、「RESTサービス・アイデンティティ・アサータの構成」を参照してください。

21.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")

21.3 セキュリティ・トークンの理解

ユーザーが範囲指定したセキュリティ・トークンは、各RESTサービスURIのhref属性とtemplate属性に埋め込まれます。トークンの生成および検証はいずれもサーバーで行われ、「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 JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のWebCenter Portal REST APIのセキュリティに関する考慮事項に関する項を参照してください。

21.4 RESTのルート名の変更

REST APIのルート名の変更は必須ではありませんが、場合によっては必要になることがあります。RESTのルート名を変更するための推奨される方法は、URLの書換えによってそれを行うことです。詳細は、『Oracle HTTP Server管理者ガイド』のURLの書換えおよびプロキシ・サーバーの機能に関する項を参照してください。たとえば、URLの書換え後、次のREST API URLは同じサーバーを参照します。

- http://myhost:8888/rest/api/resourceIndex

- http://myhost:8888/pathname/rest/api/resourceIndex

21.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管理者ガイド』を参照してください。

Oracle HTTP Server (OHS)を使用しているか、Apacheを実行している場合は、Rest APIレスポンスで圧縮を使用するために、HTTPリクエスト・ヘッダーAccept-Encoding: gzip, deflateを追加することができます。

OHSを使用している場合は、mod_deflateまたはmod_gzipサーバー・モジュールを追加して圧縮を有効化することもできます。この手法の詳細は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』のOracle HTTP Serverモジュールの理解に関する項を参照してください。

Oracle Web Cacheの詳細は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』の圧縮に関する項とコンテンツのキャッシュおよび圧縮に関する項を参照してください。

21.6 認証の処理

デフォルトでは、RESTサービスは、アイデンティティ・アサーション・プロバイダからの認証を受け入れるように構成されています。アイデンティティ・アサーション・プロバイダが構成されていない場合は、基本認証が使用されます。

アイデンティティ・アサーション・プロバイダの構成の詳細は、「RESTサービス・アイデンティティ・アサータの構成」を参照してください。

詳細は、『Oracle WebLogic Serverセキュリティの管理12c (12.2.1)』の認証プロバイダの構成に関する項を参照してください。

第IV部 モニタリング

『Oracle WebCenter Portalの管理』のこの部では、Oracle Enterprise Manager Fusion Middlewareコンソールを使用したWebCenter PortalおよびPortal Frameworkアプリケーションのモニタリング方法について説明します。

- Oracle WebCenter Portalのパフォーマンスのモニタリング

- Oracle WebCenter Portalログの管理

- Oracle WebCenter Portal監査ログの管理

22 Oracle WebCenter Portalのパフォーマンスのモニタリング

この章では、WebCenter Portalで使用できるパフォーマンス・メトリックの範囲、およびFusion Middleware Controlを使用したパフォーマンス・メトリックのモニター方法について説明します。また、診断ログ・ファイルに記録された情報を分析することにより、問題をトラブルシューティングする方法についても説明します。WebCenter Portalを定期的にモニターしている管理者は、開発の傾向を認識し、今後のパフォーマンス問題を防ぐことを習得します。

この章の内容は次のとおりです。

- Oracle WebCenter Portalのパフォーマンス・メトリックの理解

- Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示

- キー・パフォーマンス・メトリックしきい値および収集のカスタマイズ

- Oracle WebCenter Portalに関するパフォーマンス問題の診断および解決

- Oracle WebCenter Portalのパフォーマンスのチューニング

- データ・キャッシング・パフォーマンスの向上

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdmin、OperatorまたはMonitorロールが付与されている必要があります。

「管理操作、ロールおよびツールの理解」も参照してください。

22.1 Oracle WebCenter Portalのパフォーマンス・メトリックの理解

管理者は、Fusion Middleware Controlを使用して、WebCenter Portalを構成するすべてのコンポーネント、ツールおよびサービスと、アプリケーション全体のパフォーマンスと可用性をモニターできます。Fusion Middleware Controlを使用してOracle WebCenter Portalメトリックにアクセスするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表示される情報を最大限に活用するには、パフォーマンス・メトリックの計算方法とその意味を理解することが重要です。ここでは、参照用にOracle WebCenter Portalのすべてのパフォーマンス・メトリックを一覧表示して説明します。示されているソーシャル・ネットワーキング、個人の生産性およびコラボレーションに関するメトリックをすべて使用できるアプリケーション(Oracle WebCenter Portalなど)もあれば、ここに示されている機能のうち1つまたは数個しか使用できないアプリケーションもあります。

この項には次のトピックが含まれます:

- Oracle WebCenter Portalのメトリック収集の理解

- キー・パフォーマンス・メトリックの理解

- 主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断

- 共通のパフォーマンスの問題およびアクションの理解

- ページ・リクエスト・メトリックの理解

- ポートレット・プロデューサのメトリックの理解

- WebLogic Serverメトリックの理解

- セキュリティ・メトリックの理解

- ページ・レスポンス・メトリックおよび負荷メトリックの理解

- ポータル・メトリックの理解

- ツール・メトリックおよびサービス・メトリックの理解

22.1.1 Oracle WebCenter Portalのメトリック収集の理解

パフォーマンス・メトリックは、Oracle WebCenter Portalで自動的に有効になり、Fusion Middleware Controlに表示されます。WebCenter Portalのパフォーマンス・メトリックを収集するために、オプションの設定や追加構成の実行は必要ありません。アプリケーションの実行が遅い場合やハングアップした場合など、問題が発生したときは、Fusion Middleware Controlでリアルタイムにパフォーマンス・メトリックを調査して、問題の詳細を調べることができます。

この項では、Oracle WebCenter Portalでメトリック・データを収集し、表示する様々な方法について説明します。

- メトリック収集: 起動時以降

- メトリック収集: 最近の履歴

- メトリック収集: 最新のN回のサンプル

22.1.1.1 メトリック収集: 起動時以降

WebCenter PortalをホスティングするWebLogic Serverが稼働中である場合に常に、リアルタイム・メトリックは使用可能です。コンテナの起動以後に収集または集計されるリアルタイム・メトリックは、Oracle WebCenter Portalメトリック・ページで「起動時以降」の見出しの下に表示されます。こうしたメトリックは、WebLogic Serverの存続期間にわたり集計されたデータを提供します。ここで集計されるデータによって、システム全体のパフォーマンスを把握し、「最近の履歴」に示された最近のリクエストのパフォーマンスと比較できます。

たとえば、4時間前に起動された管理対象サーバーにデプロイされているWebCenter Portalについて考えてみます。その期間、WebCenter Portalは10,000個のポートレット・リクエストを処理し、それにかかった合計レスポンス時間は500,000ミリ秒でした。このシナリオの場合、ポートレットの「起動時以降」メトリックが表示されます。

- 起動時以降: 呼出し(カウント): 10000

- 起動時以降: 平均時間(ミリ秒): 50

注意:

メトリック収集は、コンテナの再起動後にあらためて開始します。再起動前に収集されたデータは使用できなくなります。

22.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分のメトリックが表示されるようになります。
ほとんどのライブ環境は、長時間にわたってアイドル状態になることはないので、最近のメトリックが非アクティブであることが理由で一時停止することはめったにありません。ただし、断続的に使用するテスト環境やしばらくの間使用しないテスト環境では、ここで説明したように、最近のメトリックの収集が一時的に停止する可能性があります。

22.1.1.3 メトリック収集: 最新のN回のサンプル

「起動時以降」と「最近の履歴」のメトリックは、特定の期間におけるパフォーマンスを計算し、その期間で集約したメトリックを表示します。Oracle WebCenter Portalではそれ以外にも、一連の主要なWebCenter Portalメトリックのリクエスト当たりのパフォーマンス情報を収集し、レポートします。そのようなメトリックを使用すると、それまでのリクエストを考慮することなく、個々のリクエストごとの成功およびレスポンス時間を参照できます。初期状態では、最新の100回のサンプルを使用して主要なメトリックのパフォーマンス/可用性を計算しますが、インストールに合わせてサンプル・セットを増減できます。

たとえば、最新の100回のページ・リクエストのうち10回が失敗した場合、ページ可用性は90%と計算されます。サンプル・セットを50回に減らして、そのうち10ページで失敗した場合、ページ可用性は80%とレポートされます。

この例は、サンプル・セットのサイズがパフォーマンス・レポートに及ぼす影響を示しています。任意の値を選択できますが、最新のN回のメトリック・サンプルはメモリー上で保持されるので、サンプル数を増やす場合はメモリー要件が増えることも考慮してください。最大でも数百回のサンプルにとどめることをお薦めします。

インストールで主要なパフォーマンス・メトリックをレポートするために使用するサンプル数を変更するには、「主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成」を参照してください。

Oracle WebCenter Portalの主要なパフォーマンス・メトリックとしきい値の詳細は、「主要なパフォーマンス・メトリックの理解」を参照してください。

22.1.2 主要なパフォーマンス・メトリックの理解

WebCenter Portalの可用性とパフォーマンスを診断するには通常、WebCenter PortalアプリケーションからJVMやWebLogic Serverなどの複数のコンポーネントまで、全般的に様々な重要メトリックを参照する必要があります。

WebCenter Portalのパフォーマンスに影響を及ぼす可能性がある問題を速やかに特定し、診断できるように、Oracle WebCenter Portalは一連の主要なパフォーマンス・メトリックの最新のN回のサンプルを収集し、Fusion Middleware Controlで公開します。アプリケーションの主要なパフォーマンス・メトリック情報にアクセスするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

しきい値によって、パフォーマンスのアラートまたは警告をトリガーするタイミングが決まります。Oracle WebCenter Portalシステムにとって適切な境界を表すしきい値を設定できるので、Enterprise Manager Fusion Middleware Controlで関連性のあるパフォーマンス・アラートを取得できます。主要なパフォーマンス・メトリックが、構成されているしきい値から外れた値である場合、Fusion Middleware Controlでは色分けされて表示されるので、簡単に見つけることができます。しきい値の詳細は、「主要なパフォーマンス・メトリックしきい値および収集のカスタマイズ」を参照してください。

可用性のように、成功または失敗がレポートされるメトリックの場合、特にしきい値を設定する必要はありません。

Oracle WebCenter Portalでは、表22-1に示す主要なパフォーマンス・メトリックの警告しきい値を管理できます。

表22-1 主要なパフォーマンス・メトリックの収集

コンポーネント

主要なパフォーマンス・メトリック

メトリックのサンプリング

WebCenter Portal

アクティブ・セッション

X分当たり1サンプル

WebCenter Portal - ページ

ページ・レスポンス時間

リクエスト別

WebCenter Portal - ポートレット

ポートレット・レスポンス時間

リクエスト別

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サンプルの頻度ですが、この値は必要に応じてカスタマイズできます。詳細は、「WebLogic Serverヘルス・チェックの頻度の構成」を参照してください。

「主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成」で説明されているように、Oracle WebCenter Portalが収集するサンプルの合計数も構成可能です。デフォルトのサンプル・セット数は100個です。メトリック・サンプルを維持するとメモリーを消費するため、過度のサンプル数を指定しないでください(多くても数百にすることをお薦めします)。

Oracle WebCenter Portalの主要なパフォーマンス・メトリックは、WebCenter Portalのパフォーマンスに影響を及ぼす可能性がある共通の問題を、管理者が速やかに特定し、診断できるように、特に選択されています。すべての主要なパフォーマンス・メトリック・データは、Fusion Middleware Controlのアプリケーションのホームページで表示できます。

22.1.3 主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断

WebCenter Portalを定期的にモニターしている場合は、開発の傾向を認識し、今後のパフォーマンス問題を防ぐことを習得します。その手始めとして最適な場所は、Enterprise Manager Fusion Middleware Controlのアプリケーションのホーム・ページです。ホームページには、アプリケーションを構成する様々なコンポーネント、ツールおよびサービスと、アプリケーションがデプロイされているWebLogic Serverについて、ステータス、パフォーマンス、可用性および他の主要なメトリックが表示されます。

この項では、Oracle WebCenter Portalを扱い慣れていないユーザーが、Fusion Middleware Controlで表示される情報を使用して問題を特定および診断する方法について理解を深めるために役立つ情報について説明します。

図22-1は、初期設定のアプリケーションWebCenter Portalをモニタリングする手順の概要を示しています。

図22-1 WebCenter Portalのシステム・ヘルスの分析: 主な手順

注意:

- 手順4は、アプリケーションでポートレットの機能が使用されている場合にのみ適用されます。

- 使用されていない機能の棒グラフは灰色表示されます。

- 折れ線グラフでデータ表示を開始するには、少なくとも3つのデータ・ポイントが必要です。

表22-2 システム・ヘルスの分析: 各手順の説明

手順

説明

WebCenter Portalのホームページへの移動

Enterprise Manager Fusion Middleware Controlを使用してポータル・アプリケーションのパフォーマンスをモニターします。その手始めとして最適な場所は、アプリケーションのホームページです。「WebCenter Portalのホームページへの移動」を参照してください。

1 CPUとヒープ・メモリーの使用率のチェック

CPUとメモリーの使用率が高すぎると全体的なパフォーマンスが低下するので、他のOracle WebCenter Portal固有のメトリックを確認する前に、常にCPUとメモリーに関するメトリックを確認することが重要です。

「最近のCPUおよびメモリー使用状況」のチャートをチェックして、使用率の現在の傾向を確認します。

- CPU使用率が高いかどうか。CPU使用率で不定期にスパイクが発生するのは正常ですが、CPU使用率が長期間にわたって高い(85から90%)場合は、通常、CPU問題が発生していることを示しています。CPUの問題をトラブルシューティングするには、次の各項を参照してください。
WebLogic Serverメトリックの理解

- メモリー使用率が高いかどうか。メモリーが最大ヒープ・サイズに近づいており、傾向が下に向かっていないことをチャートが示している場合は、原因を分析するためにメモリー・ダンプをいくつか取得してください。最大ヒープ・サイズ情報にアクセスするには:
1. WebLogic Server管理コンソールにログインします。

2. 「環境」→「サーバー」→<managed_server name>に移動します。

3. 「モニタリング」→「パフォーマンス」タブをクリックします。

4. 「最大ヒープ・サイズ」を確認します。

「JFR記録を使用した遅いリクエストのトラブルシューティング」を参照してください。

次の手順: チャートで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接続の数が制限値を超えている場合、接続リークを詳細に分析できます。ガベージ・コレクション・レートが制限値を超えている場合、ヒープ・ダンプの採取を採取できます。

詳細は、「WebLogic Serverメトリックの理解」および「Oracle WebCenter Portalのパフォーマンスに関する問題のトラブルシューティング」を参照してください。

範囲外のメトリックは、チャートでは赤で、「ヘルス・メトリック」表ではオレンジで、それぞれ表示されます。診断ログをスキャンして、そのような状況が発生している記録をすべて調査します。インメモリー情報はN回分のメトリック・サンプルしかありませんが、ログには問題の発生回数に関する大量の履歴情報や、問題が発生したときのユーザーのようなコンテキストに関する情報が格納されています。

次にサンプル・メッセージを示します。

[WC_Portal] [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では、メッセージ・タイプ、メッセージ・コードおよび他の文字列パターンに関する詳細を検索することによって、このタイプのすべてのメッセージを検索できます。「ログ情報の表示および構成」を参照してください。

デフォルトでは警告のしきい値が設定されているのは「CPU使用率」のみですが、「ヒープ・メモリー使用率」などの他の主要なWebLogic Serverメトリックにもしきい値を構成できます。「主要なメトリックのしきい値の構成」を参照してください。

診断ログで、エラー、障害、および構成またはネットワークの問題をチェックします。

問題がWebCenter ContentやSOAなど、別のバックエンド・サーバーに関連している場合、それらの管理対象サーバーでもJVM/WebLogic Serverのヘルス(CPU、ヒープ、スレッドなど)を確認します。

同様に、WebCenter Portalインストール内のWC_Portlet、WC_UtilitiesおよびWC_Collaborationなどの他の管理対象サーバーのWebLogic Serverヘルスを調査します。

次の手順: WebLogic Serverがしきい値の範囲内で動作していることがチャートに示されている場合、WebCenter Portalアプリケーションのヘルスを確認します。

3 ページ・パフォーマンスのモニター

ホームページの上部にある「WebCenter Portalメトリック」セクションを参照します。

ページ可用性/パフォーマンスのチャートで、ページ・リクエストが予期したとおりに現在応答しているかどうかを確認します。最近のページ・リクエストに関する問題を調査するには、詳細をドリルダウンします。

「時間」列と「ページ名」列で「昇順ソート」/「降順ソート」の矢印を使用して、特定のページまたは一連のページで急増するパターンが存在するかどうか、またはパフォーマンスのスパイクがよりランダムに発生するようになっていないかを確認します。

範囲外のメトリックは、チャートでは赤で、「ページ・メトリック」表ではオレンジで、それぞれ表示されます。詳細は、「ページ・リクエスト・メトリックの理解」を参照してください。診断ログをスキャンして、そのような状況が発生している記録をすべて調査します。インメモリー情報はN回分のメトリック・サンプルしかありませんが、ログには問題の発生回数に関する大量の履歴情報や、問題が発生したときのユーザーのようなコンテキストに関する情報が格納されています。

次にサンプル・メッセージを示します。

[WC_Portal] [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では、メッセージ・タイプ、メッセージ・コードおよび他の文字列パターンに関する詳細を検索することによって、このタイプのすべてのメッセージを検索できます。「ログ情報の表示および構成」を参照してください。

パフォーマンスが低下している個々のページを特定します。詳細は、「表示の遅いページを特定する方法」を参照してください。

「全ページ・メトリック」ページに移動し、このページの実行履歴を参照します(起動時以降および過去10-15分)。このページは常に動作に時間がかかるのかどうかを確認します。

ページで異常が発生している場合は、「遅いページ・リクエストをトラブルシューティングする方法」を参照してください。

4. ポートレットのパフォーマンスのモニター

ホームページの上部にある「WebCenter Portalメトリック」セクションを参照します。

ポートレット可用性/パフォーマンスのチャートで、ポートレットが予期したとおりに現在動作しているかどうかを確認します。最近のポートレット・リクエストに関する問題を調査するには、詳細をドリルダウンします。範囲外のメトリックは、チャートでは赤で、「ポートレット・メトリック」表ではオレンジで、それぞれ表示されます。詳細は、「ポートレット・プロデューサのメトリックの理解」を参照してください。

範囲外の条件は管理対象サーバーの診断ログにも記録されるので、すべての履歴イベント、すなわちメモリー内に保持されている最新のサンプル・セットより多い量の履歴イベントを調査できます。例:

[WC_Portal] [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 MyPortlets is
out-of-bounds.

予期したとおりのパフォーマンスを示していない個々のポートレットまたはポートレット・プロデューサを特定します。

「全サービス・メトリック」ページに移動して「プロデューサ」または「ポートレット」を選択し、ポートレット/ポートレット・プロデューサの実行履歴を参照します(起動時以降および過去10-15分)。パフォーマンスが最近低下したのか、常に動作に時間がかかるのかを確認します。

ポートレットのパフォーマンスがしきい値の範囲内で正常な場合、次の手順を実行します。

1. ポートレット(たとえばWC_Portlets)をホストしている管理対象サーバーのJVM/WebLogic Serverのヘルスを確認(すなわち、CPU、ヒープ、スレッドなどを調査)します。

2. ブラウザでポートレット・プロデューサのURLを入力し、プロデューサが使用可能かどうかを確認します。

3. ポートレット・プロデューサの接続構成を確認します。

4. WebCenter Portalアプリケーションとポートレット・プロデューサの間のネットワーク接続の問題をチェックします。

5. WebCenter Portalでポートレット操作をシミュレートします。すなわち、ポートレットで表示、パーソナライズまたは操作を実行して、問題が常態化しているのか、間欠的なのかを確認します。

ポートレットで異常が発生している場合は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のポートレットのトラブルシューティングに関する項を参照してください。

次の手順: ポートレット・リクエストがしきい値の範囲内で動作していることがチャートに示されている場合、LDAPサーバーのパフォーマンスを確認します。

5.LDAPサーバーのパフォーマンスのモニター

ホームページの上部にある「セキュリティ」セクションで、LDAPメトリックを参照します。

キャッシュ・ヒット率は、サーバー起動時は0ですが、通常はウォーム・アップするにつれて増加し、90%を超えます。詳細は、「セキュリティ・メトリックの理解」を参照してください。

通常は、平均LDAP参照時間はほんの数ミリ秒です。参照に長い時間がかかる場合は、LDAPサーバーまたはネットワークに関する問題が発生している可能性があります。

- 単純なバインド操作に対するLDAPサーバーのレスポンス時間を測定する場合、コマンドldapbind -D "UserDN" -h ldaphost.example.com -p <port> -w <password>を実行します。

Oracle Internet Directoryを使用している場合は、パフォーマンスを改善し、ボトルネックを回避する方法について、『パフォーマンスのチューニング』のOracle Internet Directoryパフォーマンス・チューニングに関する項を参照してください。他のLDAPサーバーについては、該当の製品ドキュメントを参照してください。

次の手順: LDAPサーバーがしきい値の範囲内で動作している場合、他の領域を調査します。

6. 個々のツールまたはサービスのモニター

ホームページの下部にある「WebCenter Portalサービス」セクションを参照します。詳細は、「ツール・メトリックおよびサービス・メトリックの理解」を参照してください。

特定のツールまたはサービスが「停止中」または「不明」であるかどうかがすぐにわかります。考えられる原因とアクションについて、「ツールとサービスに関する一般的な問題のトラブルシューティング」を参照してください。

「平均時間」または「呼出し」で表をソートすると、優先的に取り組むツールまたはサービスがわかります。

名前をクリックして「全サービス・メトリック」ページに移動します。「起動時以降」と「最近の履歴」のメトリックを比較して、パフォーマンスが最近低下したのか、常に動作に時間がかかるのかを確認します。

22.1.4 共通のパフォーマンスの問題およびアクションの理解

Oracle WebCenter Portalメトリックが範囲外である場合は、次のことを行います。

- メモリー、CPU、ネットワーク、外部プロセスなどの要素を含めて、システム・リソースをチェックします。「Oracle WebCenter Portalのトラブルシューティング」を参照してください。

- 問題がシステム全体のものか、特定のツールまたはサービスに関するものかを判断するために他のメトリックをチェックします。

- 問題が特定のツールまたはコンポーネントに関連する場合は、バックエンド・サーバーが停止していないかどうか、また過負荷ではないかどうかをチェックします。

- WebLogic Serverを長期間実行している場合は、起動時以降のメトリックと最近の履歴のメトリックを比較し、最近になってパフォーマンスが低下していないかどうか、低下している場合はその程度を判断します。

- ツールまたはサービスのステータスが「停止中」であるか、機能しない操作がある場合、ダイレクトURLによりバックエンド・サーバーの検証、テストおよびpingを行います。詳細は、該当する章の接続のテストに関する項を参照してください。章のリストは、「ツールとサービスの管理」を参照してください。
ツールまたはサービスへの接続を再構成する場合、変更を反映するために、WebCenter Portalアプリケーションがデプロイされている管理対象サーバーを再起動する必要があります。サーバーのホスト/ポートの詳細など、主要な接続属性を変更した場合、接続を再構成して管理対象サーバーを再起動するまでは、サーバーへの接続が切断されてサービスが使用不可になる可能性があります。

注意:

一部の主要なパフォーマンス・メトリックが範囲外条件をトリガーするしきい値は、カスタマイズ可能です。「主要なパフォーマンス・メトリックしきい値および収集のカスタマイズ」を参照してください。

22.1.5 ページ・リクエスト・メトリックの理解

Fusion Middleware Controlでは、WebCenter Portalのページ・リクエストの可用性とパフォーマンスをモニターできます。最近のページ・データおよび履歴(全)ページ・データをモニターできます。

この項の内容は次のとおりです。

- フル・ページ・メトリックと部分ページ・メトリックの理解

- 最近のページ・メトリック

- 全ページ・メトリック

注意:

この項で説明するページ・リクエスト・メトリックは、「ページ操作のメトリック」で説明しているページ操作のメトリックとは異なります。ページ操作のメトリックでは、ページの作成など、ページ関連の操作がモニターされます。これに対して、この項で説明するページ・リクエスト・メトリックでは、個々のページ・ビュー/表示リクエストがモニターされます(ページ編集操作は含まれません)。

22.1.5.1 フル・ページ・メトリックと部分ページ・メトリックの理解

パフォーマンス・データは、フル・ページ・リクエストと部分ページ・リクエストについて収集されます。フル・ページのメトリックには部分ページのメトリックは含まれません。

部分ページ・リクエストでは、ページの部分のみが表示されます。したがって、ページ内のページのパフォーマンスをモニターできます。部分ページのリフレッシュ動作は、部分ページ・レンダリング(PPR: partial page rendering)と呼ばれています。PPRにより、ページ全体をリフレッシュする必要なく、ページ上の特定のコンポーネントのみを再レンダリングできます。一般的なシナリオでは、入力コンポーネントでユーザーが選択または入力したものが出力コンポーネントに表示されます。同様に、コマンド・リンクまたはボタンにより、ページ全体がリフレッシュされることなく、ページ上の別のコンポーネントが再レンダリングされる場合があります。

ページ上の個々のコンポーネントの部分的なページ・レンダリングでは、部分ページのメトリックのみが増加し、フル・ページのメトリックは変化しません。たとえば、ページ上のカレンダのリフレッシュでは、部分ページの呼出しが1増加しますが、フル・ページの呼出しは変化しません。

PPRの詳細は、『Oracle ADF FacesによるWebユーザー・インタフェースの開発』の部分ページ・コンテンツの再レンダリングに関する項を参照してください。

22.1.5.2 最近のページ・メトリック

WebCenter Portalのホームページに、最近のページ可用性メトリックとページ・パフォーマンス・メトリックのサマリーが表示されます(図22-2および表22-3)。ページ可用性/パフォーマンス・チャートでは、ページ・リクエストが予想以上に時間がかかっているか、または失敗しているかどうかが一目でわかります。

注意:

ホームページにアクセスするには、「WebCenter Portalのホームページへの移動」を参照してください。

「ページ可用性」チャートと「ページ・パフォーマンス」チャートでは、最新のN回のページ・リクエスト(デフォルトではNは100)における可用性とパフォーマンスがレポートされます。時間範囲は、最も早いページ/ポートレットのリクエスト時刻から現在時刻までです。「主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成」を参照してください。

右側の%値は、特定の時間制限内に応答したページ・リクエストの割合を示します。この割合は、最新のN回のページ・リクエストの情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のページ・リクエストのうち3回がページ・レスポンスのしきい値を超えた場合、ページ・パフォーマンスは97%と表示されます。

棒グラフ・ステータス(緑/赤)は、ステータスが変更されるまでは、時間が経過しても変更されません。したがって、%パフォーマンス値と見た目の緑/赤の比率は必ずしも一致しません。たとえば、最初の5回のページ・リクエストが範囲外であり、システムは9時間アイドル(ページ・リクエストがない)状態であり、1時間当たり95回の正常なページ・リクエストが存在するシナリオを考えます。この場合、棒グラフは90%が赤(9時間)、10%が緑(1時間)で表示されますが、%パフォーマンス値は95%と表示されます(Nが100で、サンプル100個のうち95個が正常)。不一致が発生するのは、棒グラフが期間全体で均一に描画されるのに対して、ページ・リクエストは通常は期間全体に均一に分散しないからです。

図22-2 WebCenter Portalホームページ上の最近のページのサマリー

チャートが問題やインシデントを示している場合は、「ページ可用性」リンクまたは「ページ・パフォーマンス」リンクをクリックしてより詳細な情報に移動し、さらに問題を診断できます(図22-3および表22-3を参照)。

最近のページ・メトリックのページ(図22-3)の情報を使用して、最近のページ・パフォーマンスの問題をトラブルシューティングします。ページ・リクエストが予想以上に時間がかかっているか、または失敗している場合、ページ上部のページ可用性/パフォーマンス・チャートが赤で表示されます。

注意:

初期状態では、ページ・レスポンスしきい値は10,000ミリ秒なので、レスポンス時間が10,000ミリ秒を超えるページのチャートは赤で表示されます。このしきい値がインストールに適さない場合、その値を変更できます。「主要なパフォーマンス・メトリックしきい値および収集のカスタマイズ」を参照してください。

図22-3 最近のページ・メトリック

このチャートは、最新のN回のページ・リクエストの可用性/パフォーマンスをレポートします。時間範囲は、最も早いページ・リクエスト時刻から最後のページ・リクエスト時刻までです。

表の情報を使用して、遅いページの名前およびそのページが属するポータルを特定します。

ページ・レスポンスの問題を診断するには、次にある手順3のアドバイスを参照してください: 「ページ・パフォーマンスのモニター」(表22-2)。

表22-3 最近のページ・リクエスト・メトリック

メトリック

説明

可用性

最新のN回のページ・リクエストのページ可用性を示します。

- 緑: ページ・リクエストの成功を表します。

- 赤: ページ・リクエストで失敗が発生したことを表します。
下部の表の「ステータス」列を参照し、失敗したページ・リクエストを特定します。

- %: 成功したページ・リクエストの割合。割合は、最新のN回のページ・リクエストのステータス情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のページ・リクエストのうち5回が失敗した場合、ページ可用性は95%と表示されます。

パフォーマンス

最新のN回のページ・リクエストのページ・パフォーマンスを示します。

- 緑: 許容されるページ・レスポンス時間であること、すなわちレスポンス時間が事前定義済しきい値より短いことを表します。

- 赤: ページ・レスポンス時間が設定されている制限値より長いことを表します。たとえば、インストールでページ・レスポンスしきい値を3,000ミリ秒と指定している場合、レスポンス時間が3,000ミリ秒を超えるたびに警告メッセージがトリガーされ、範囲外の状態が記録されます。
初期状態では、ページ・レスポンスしきい値は10,000ミリ秒です。

下部の表の時間の列を参照します。しきい値を超えるレスポンスはオレンジで表示されます。「降順ソート」の矢印をクリックすると、最も遅いページを確認できます。遅いページを開いて調査し、ページの再設計またはページ・コンテンツの変更/削除によりページ・パフォーマンスを向上できる余地があるかどうかを評価します。

- %: 指定されている時間制限内に応答したページ・リクエストの割合。この割合は、最新のN回のページ・リクエストの情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のページ・リクエストのうち10回がページ・レスポンスのしきい値を超えた場合、ページ・パフォーマンスは90%と表示されます。

日時

ページがリクエストされた日時。

ページ名

リクエストされたページの名前。

ポータル名

ページが格納されているポータルの名前。

部分ページ・リフレッシュ

フル・ページ・リフレッシュ(false)または部分ページ・リフレッシュ(true)のどちらのページ・リクエストなのかを示します。

ステータス

ページ・リクエストが成功(「成功」)したのか、失敗(「失敗」)したのかを示します。「失敗」はオレンジのテキストで表示されます。

時間(ミリ秒)

ページ(フル・ページまたは部分ページ)のリフレッシュにかかった時間(ミリ秒)。時間が事前定義済ページ・レスポンスしきい値を超えた場合、値はオレンジで表示されます。

22.1.5.3 全ページ・メトリック

図22-4に示すように、ページ・アクティビティに関連する履歴パフォーマンス・メトリックも表示されます。表22-4に、これらのメトリックを示します。このページには、フル・ページ・リクエストと部分ページ・リクエストの両方のメトリックが表示され、必要に応じて表示するデータをフィルタ処理できます。

注意:

Fusion Middleware Controlを使用してこれらのメトリックにアクセスするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

図22-4 全ページ・リクエスト・メトリック

このページの上部の表には、個々のページのステータスとパフォーマンスがまとめて表示されます。この表を使用すると、使用可能なページがすぐにわかり、個々のパフォーマンスと相対的なパフォーマンスを確認できます。

統計は、ページが作成されると使用可能になり、ページがアクセスされたり使用されたりするたびに更新されます。

注意:

ホーム・ポータルのページのメトリックは含まれません。

表22-4 ページ・リクエスト・メトリック: フル・ページおよび部分ページ

フィールド

説明

表示オプション

表に表示するデータをフィルタ処理します。

- ページ名フィルタ: 検索語の全部または一部を入力し、「リフレッシュ」アイコンをクリックすると、ページ名が一致するすべてのページでリストが更新されます。すべてのページを表示するには、検索語をクリアし、「リフレッシュ」を再度クリックします。

- ポータル名フィルタ - 検索文字列全体またはその一部を入力してから、「リフレッシュ」アイコンをクリックします。リストがリフレッシュされ、一致する文字列をポータルの表示名に含むページがすべて表示されます。すべてのポータル(以前はスペースと呼ばれていました)のページ・メトリックを表示するには、検索語をクリアし、「リフレッシュ」を再度クリックします。

- 最大行数: 表に表示するページの総数を制限します。

- 表示 - 最もアクセスされたページ、最も遅いページまたは最もエラーが多いページのメトリックを表示します。選択に応じて、表のページは次の順序で並べられます。
- 呼出し数(最もアクセスされたページ)

- 平均ページ処理時間(最も遅いページ)

- エラー数(最もエラーが多いページ)

- 期間 - 起動時以降または過去15分間(最近の履歴)に収集されたメトリック情報を表示します。

上位5つのページがチャートに表示されます。

ページ名

フィルタ基準(指定されている場合)に一致するページの名前。

フィルタ基準が指定されない場合は、すべてのページがリストされます。

ポータル名

フィルタ基準(指定されている場合)に一致するポータルの名前。

フィルタ基準が指定されない場合は、すべてのポータルのページがリストされます。

呼出し

1分当たりのページ(フル・ページまたは部分ページ)の呼出し総数:

- 起動時以降

- 過去15分

平均時間(ミリ秒)

ページ(フル・ページまたは部分ページ)を表示するための平均時間(ミリ秒)。

- 起動時以降

- 過去15分

最大時間(ミリ秒)

ページ(フル・ページまたは部分ページ)の表示にかかった最大時間。

エラー(フル・ページのみ)

ページで発生した1分当たりのエラー数。

成功した呼出し(フル・ページのみ)

成功したページ呼出しの割合。

- 起動時以降

- 過去15分

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、ページ・リクエストの失敗の原因を特定してください。「ログ情報の表示および構成」を参照してください。

ページ数/分

ページの1分当たりのアクセス回数。ページ・スループットとも呼ばれます。

- 起動時以降

- 過去15分

全ページ・リクエスト・メトリック: グラフ

表の下のグラフを使用すると、次の内容が一目でわかります。

- 呼出し: 最も使用回数の多いページまたは最も使用回数の少ないページ(つまり、最も多い呼出しまたは最も少ない呼出しが記録されているページ)を示すグラフ。

- ページ・スループット - 1分間にアクセスされた平均ページ数を示すグラフ。このグラフを使用すると、ヒット率が高い(または低い)ページを特定できます。

- エラー - エラーの数を示すグラフ。このグラフを使用すると、エラー率を比較できます。

- 平均処理時間: 平均ページ・レスポンス時間(ミリ秒)を示すグラフ。このグラフを使用すると、パフォーマンスが最高(または最低)のページを特定できます。

様々なページを比較するには:

- 「ページ名フィルタ」で適切なフィルタリング基準を指定します。

- 表で1つ以上のページを選択し、「チャートで表示」をクリックします。

22.1.6 ポートレット・プロデューサのメトリックの理解

Fusion Middleware Controlでは、WebCenter Portalで使用されているすべてのポートレットおよびポートレット・プロデューサの可用性とパフォーマンスをモニターできます。最近のポートレット・データおよび履歴(全)ポートレット・データをモニターできます。次の各項では、監視可能なメトリックについて説明します。

- 最近のポートレット・メトリック

- 全ポートレット・プロデューサ・メトリック

- 全ポートレット・メトリック

22.1.6.1 最近のポートレット・メトリック

WebCenter Portalのホームページに、最近のポートレット可用性メトリックとポートレット・パフォーマンス・メトリックのサマリーが表示されます(図22-5および表22-5)。ポートレット可用性/パフォーマンス・チャートでは、ポートレット・リクエストが予想以上に時間がかかっているか、または失敗しているかどうかが一目でわかります。

注意:

ホームページにアクセスするには、「WebCenter Portalのホームページへの移動」を参照してください。

「ポートレット可用性」チャートと「ポートレット・パフォーマンス」チャートでは、最新のN回のポートレット・リクエスト(デフォルトではNは100)における可用性とパフォーマンスがレポートされます。時間範囲は、最も早いページ/ポートレットのリクエスト時刻から現在時刻までです。「主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成」を参照してください。

右側の%値は、特定の時間制限内に応答したポートレット・リクエストの割合を示します。この割合は、最新のN回のポートレット・リクエストの情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のポートレット・リクエストのうち25回がポートレット・レスポンスのしきい値を超えた場合、ポートレット・パフォーマンスは75%と表示されます。詳細については、表22-5を参照してください。

棒グラフ・ステータス(緑/赤)は、ステータスが変更されるまでは、時間が経過しても変更されません。したがって、%パフォーマンス値と見た目の緑/赤の比率は必ずしも一致しません。「最近のページ・メトリック」の説明は、ポートレット・チャートにも当てはまります。

図22-5 WebCenter Portalホームページ上の最近のポートレット・メトリックのサマリー

チャートが問題やインシデントを示している場合は、「ポートレット可用性」リンクまたは「ポートレット・パフォーマンス」リンクをクリックしてより詳細な情報に移動し、さらに問題を診断できます(図22-6および表22-5)。

図22-6 最近のポートレット・メトリック

このページの情報を使用して、最近のポートレットのパフォーマンスの問題をトラブルシューティングします。ポートレット・リクエストが予想以上に時間がかかっているか、または失敗している場合、ページ上部のポートレット可用性/パフォーマンス・チャートが赤で表示されます。

注意:

初期状態では、ポートレット・レスポンスしきい値は10,000ミリ秒なので、レスポンス時間が10,000ミリ秒を超えるポートレットのチャートは赤で表示されます。このしきい値がインストールに適さない場合、その値を変更できます。詳細は、「主要なパフォーマンス・メトリックしきい値および収集のカスタマイズ」を参照してください。

このチャートは、最新のN回のポートレット・リクエストの可用性/パフォーマンスをレポートします。時間範囲は、最も早いポートレット・リクエスト時刻から最後のポートレット・リクエスト時刻までです。

この表の情報を使用して、遅いポートレットを特定します。ポートレットの名前およびそのポートレットが属するプロデューサを特定できます。

ポートレットの問題を診断するには、「手順5. ポートレットのパフォーマンスのモニター(表22-2)。

表22-5 最近のポートレット・メトリック

メトリック

説明

ポートレット可用性

最新のN回のポートレット・リクエストのポートレット可用性を示します。

- 緑: ポートレット・リクエストの成功を表します。

- 赤: ポートレット・リクエストで失敗が発生したことを表します。
下部の表の「ステータス」列を参照し、失敗したポートレット・リクエストを特定します。

- %: 成功したポートレット・リクエストの割合。割合は、最新のN回のポートレット・リクエストのステータス情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のポートレット・リクエストのうち5回が失敗した場合、ポートレット可用性は95%と表示されます。

ポートレット・パフォーマンス

最新のN回のポートレット・リクエストのポートレット・パフォーマンスを示します。

- 緑: 許容されるポートレット・レスポンス時間であること、すなわちレスポンス時間が事前定義済しきい値より短いことを表します。

- 赤: ポートレット・レスポンス時間が設定されている制限値より長いことを表します。たとえば、インストールでポートレット・レスポンスしきい値を60ミリ秒と指定している場合、レスポンス時間が60ミリ秒を超えるたびに警告メッセージがトリガーされ、範囲外の状態が記録されます。
初期状態では、ポートレット・レスポンスしきい値は10,000ミリ秒です。

下部の表の時間の列を参照します。しきい値を超えるレスポンスはオレンジで表示されます。「降順ソート」の矢印をクリックすると、最も遅いポートレットを確認できます。ポートレット名を特定したら、そのポートレットを調査して、効率を高める変更方法を評価できます。

- %: 指定されている時間制限内に応答したポートレット・リクエストの割合。この割合は、最新のN回のポートレット・リクエストの情報を使用して計算されます。たとえば、Nが100のときに、最新の100回のポートレット・リクエストのうち10回がポートレット・レスポンスのしきい値を超えた場合、ポートレット・パフォーマンスは90%と表示されます。

日時

ポートレット・リクエストの日時。

ポートレット名

リクエストされたポートレットの名前。

22.1.6.2 全ポートレット・プロデューサ・メトリック

図22-7に示すように、WebCenter Portalで使用されているポートレット・プロデューサの履歴パフォーマンス・メトリックもモニターできます。このページに表示される情報については、次の表で説明します。

- 表22-6

- 表22-7

注意:

Fusion Middleware Controlを使用してこれらのメトリックにアクセスするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

図22-7 ポートレット・プロデューサのメトリック

表22-6 ポートレット・プロデューサ: サマリー

メトリック

説明

ステータス

アプリケーションで使用されているポートレット・プロデューサの現在のステータス

- 稼働中(緑色の上矢印): すべてのポートレット・プロデューサが稼働中であることを示します。

- 停止中(赤色の下矢印): 1つ以上のポートレット・プロデューサが現在使用できないことを示します。プロデューサ・インスタンスが停止しているか、ネットワーク接続の問題がある可能性があります。

- 不明(時計): なんらかの理由でポートレット・プロデューサのステータスを問い合せることができません。管理対象サーバーが停止しているか、ネットワークの問題が原因でノードにアクセスできない可能性があります。さらに診断するには、管理サーバーのログおよび管理対象サーバーのログを確認します。

成功した呼出し(%)

成功したポートレット・プロデューサ起動の割合:

- 起動時以降

- 過去15分

リクエストが失敗すると、可用性に影響します。これには、アプリケーションに関連する失敗(タイムアウトや内部エラーなど)やクライアント/サーバーの失敗(レスポンス・コードHTTP4xxまたはHTTP5xxで返されたリクエスト、不正なコンテンツ・タイプが含まれるレスポンス、SOAP障害(該当する場合)など)があります。

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。「ログ情報の表示および構成」を参照してください。

呼出し

1分当たりのポートレット・プロデューサの呼出し数:

- 起動時以降

- 過去15分

このメトリックでは、アプリケーションに関連する各ポートレット・リクエストが測定されます。このため、アプリケーションのキャッシュ・ヒット、エラーまたはタイムアウトにより、この合計はプロデューサ・サーバーに対して送信された実際のHTTPリクエスト数よりも多くなることがあります。

平均時間(ミリ秒)

ポートレット・リクエストにかかった平均時間(結果には関係ありません):

- 起動時以降

- 過去15分

表22-7 ポートレット・プロデューサ: 詳細

メトリック

説明

最もポピュラーなプロデューサ

各プロデューサの起動回数(チャートで表示)。

チャートの最大値は、最も多く使用されているポートレット・プロデューサを示します。

最小値は、最も使用されていないポートレット・プロデューサを示します。

レスポンス時間

WebCenter Portal起動以降の、各ポートレット・プロデューサがプロデューサ・リクエストの処理に要する平均時間(チャートに表示)。

チャートの最大値は、パフォーマンスが最も低いポートレット・プロデューサを示します。

最小値は、パフォーマンスが最も高いポートレット・プロデューサを示します。

プロデューサ名

モニター対象のポートレット・プロデューサの名前。

ポートレット・プロデューサの名前をクリックすると、アプリケーションで使用される各ポートレットの詳細情報が表示されます。表22-9を参照してください。

ステータス

各ポートレット・プロデューサの現在のステータス:

- 稼働中(緑色の上矢印): ポートレット・プロデューサが稼働中であることを示します。

- 停止中(赤色の下矢印): ポートレット・プロデューサが現在使用できないことを示します。プロデューサ・インスタンスが停止しているか、ネットワーク接続の問題がある可能性があります。

- 不明(時計): なんらかの理由でポートレット・プロデューサのステータスを問い合せることができません。

プロデューサ・タイプ

ポートレット・プロデューサ・タイプ: 「Web」または「WSRP」

- Webポートレット・プロデューサ: J2EEアプリケーション・サーバーにデプロイされるOracle PDK-Javaプロデューサ。これは多くの場合リモートであり、HTTP上でSimple Object Access Protocol (SOAP)を使用して通信します。

- WSRPポートレット・プロデューサ: Web Services for Remote Portlets (WSRP)は、標準対応のコンテナと任意のWSRPアプリケーションの間の相互運用を可能にするWebサービス標準です。

成功した呼出し(%)

成功したプロデューサ起動の割合:

- 起動時以降

- 過去15分

呼出し

各プロデューサの起動回数:

- 起動時以降

- 過去15分

この列で表をソートすると、WebCenter Portal内で最も頻繁にアクセスされているポートレット・プロデューサがわかります。

平均時間(ミリ秒)

ポートレット・リクエストにかかった平均時間(結果には関係ありません):

- 起動時以降

- 過去15分

このメトリックは、機能していないポートレット・プロデューサを検出する場合に使用します。このメトリックを「呼出し」メトリックと組み合せて使用すると、優先的に取り組む必要のあるプロデューサがわかります。

最大時間(ミリ秒)

プロデューサ・リクエストの処理にかかった最大時間。

- 成功 - HTTP200xxレスポンス・コード

- リダイレクト - HTTP300xxレスポンス・コード

- クライアント・エラー数 - HTTP400xxレスポンス・コード

- サーバー・エラー - HTTP500xxレスポンス・コード

22.1.6.3 全ポートレット・メトリック

図22-8に示すように、WebCenter Portalで使用されている個々のポートレットの履歴パフォーマンス・メトリックもモニターできます。このページに表示される情報については、次の表で説明します。

- 表22-8

- 表22-9

- 表22-10

- 表22-11

注意:

Fusion Middleware Controlを使用してこれらのメトリックにアクセスするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

図22-8 ポートレット・メトリック

表22-8 ポートレット: サマリー

メトリック

説明

ステータス

WebCenter Portalで使用されているポートレットの現在のステータス:

- 稼働中(緑色の上矢印): すべてのポートレットが稼働中であることを示します。

- 停止中(赤色の下矢印): 1つ以上のポートレットが現在使用できないことを示します。プロデューサ・インスタンスが停止しているか、ネットワーク接続の問題がある可能性があります。他の原因については、「ポートレットおよびプロデューサ: 問題およびアクション」を参照してください。

- 不明(時計): なんらかの理由でポートレットのステータスを問い合せることができません。管理対象サーバーが停止しているか、ネットワークの問題が原因でノードにアクセスできない可能性があります。さらに診断するには、管理サーバーのログおよび管理対象サーバーのログを確認します。

成功した呼出し(%)

成功したポートレット起動の割合:

- 起動時以降

- 過去15分

リクエストが失敗すると、可用性に影響します。これには、タイムアウトや内部エラーなどのアプリケーションに関連する失敗、そしてクライアント/サーバー・エラーが含まれます。

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。「ログ情報の表示および構成」を参照してください。

呼出し

1分当たりのポートレットの呼出し数:

- 起動時以降

- 過去15分

このメトリックでは、アプリケーションに関連する各ポートレット・リクエストが測定されます。このため、アプリケーションのキャッシュ・ヒット、エラーまたはタイムアウトにより、この合計はポートレット・プロデューサに対して送信された実際のHTTPリクエスト数よりも多くなることがあります。

平均時間(ミリ秒)

ポートレットに関連付けられた操作の処理にかかった平均時間(結果には関係ありません):

- 起動時以降

- 過去15分

表22-9 ポートレット: 詳細

メトリック

説明

最もポピュラーなポートレット

各ポートレットの起動回数(チャートで表示)。

チャートの最大値は、最も多く使用されているポートレットを示します。

最小値は、最も使用されていないポートレットを示します。

レスポンス時間

WebCenter Portal起動以降の、各ポートレットがリクエストの処理に要する平均時間(チャートに表示)。

チャートの最大値は、パフォーマンスが最も低いポートレットを示します。

最小値は、パフォーマンスが最も高いポートレットを示します。

ポートレット名

モニター対象のポートレットの名前。

ステータス

各ポートレットの現在のステータス:

- 稼働中(緑色の上矢印): ポートレットが稼働中であることを示します。

- 停止中(赤色の下矢印): ポートレットが現在使用できないことを示します。プロデューサ・インスタンスが停止しているか、ネットワーク接続の問題がある可能性があります。

プロデューサ名

ポートレットのアクセスに使用されるポートレット・プロデューサの名前。

プロデューサ・タイプ

ポートレット・プロデューサ・タイプ: 「Web」または「WSRP」

- Webポートレット・プロデューサ: J2EEアプリケーション・サーバーにデプロイされるOracle PDK-Javaプロデューサ。これは多くの場合リモートであり、HTTP上でSimple Object Access Protocol (SOAP)を使用して通信します。

- WSRPポートレット・プロデューサ: Web Services for Remote Portlets (WSRP)は、標準対応のコンテナと任意のWSRPアプリケーションの間の相互運用を可能にするWebサービス標準です。

成功した呼出し(%)

成功したポートレット起動の割合:

- 起動時以降

- 過去15分

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。「ログ情報の表示および構成」を参照してください。

呼出し

各ポートレットの起動回数:

- 起動時以降

- 過去15分

この列で表をソートすると、WebCenter Portal内で最も頻繁にアクセスされているポートレットがわかります。

平均時間(ミリ秒)

各ポートレットでリクエストの処理にかかった平均時間(結果には関係ありません):

- 起動時以降

- 過去15分

このメトリックは、パフォーマンスの低いポートレットを検出する場合に使用します。このメトリックを「呼出し」メトリックと組み合せて使用すると、優先的に取り組む必要のあるポートレットがわかります。

最大時間(ミリ秒)

ポートレット・リクエストの処理にかかった最大時間。

- 成功 - HTTP200xx

- リダイレクト - HTTP300xx

- クライアント・エラー数- HTTP400xx

- サーバー・エラー- HTTP500xx

パフォーマンス統計のHTTPレスポンス・コード別の内訳を調べると、全体の平均レスポンス時間を増加させている要因を特定できます。たとえば、ポートレット・プロデューサ・タイムアウトによる失敗が、全体の平均レスポンス時間を増加させている場合などがあります。

表22-10 ポートレット: HTTPレスポンス・コードの統計

メトリック

説明

ポートレット名

モニター対象のポートレットの名前。

呼出し数

- 成功

- リダイレクト

- クライアント・エラー数

- サーバー・エラー

タイプ(HTTPレスポンス・コード)別の呼出し回数:

- 起動時以降

- 過去15分

表22-11を参照してください。

平均時間(ミリ秒)

- 成功

- リダイレクト

- クライアント・エラー数

- サーバー・エラー

各ポートレットでリクエストの処理にかかった平均時間:

- 起動時以降

- 過去15分

このメトリックは、機能していないポートレットを検出する場合に使用します。このメトリックを「呼出し」メトリックと組み合せて使用すると、優先的に取り組む必要のあるポートレットがわかります。

表22-11 HTTPレスポンス・コード

HTTPレスポンスおよびエラー・コード

説明

200 - リクエスト成功

HTTP2xxレスポンス・コードを返すポートレット・リクエスト、またはリモート・プロデューサにHTTPリクエストを送信しなくても成功したポートレット・リクエスト(たとえば、キャッシュ・ヒットなど)。

300 - 解決できなかったリダイレクト

HTTP3xxレスポンス・コードを返すポートレット・リクエスト。

400 - リクエストを完了できずに失敗

HTTP4xxレスポンス・コードを返すポートレット・リクエスト。

500 - サーバー・エラーのために失敗

なんらかの原因で失敗したポートレット・リクエスト(HTTP5xxレスポンス・コードを返すリクエストや、アプリケーションに関連するエラー、タイムアウト、不正なコンテンツ・タイプ・レスポンス、またはSOAP障害が原因で失敗したリクエストを含む)。

22.1.7 WebLogic Serverメトリックの理解

WebCenter Portalのホームページに、最近のWebLogic Serverパフォーマンスのサマリーが表示されます(図22-9および表22-12)。チャートが問題やインシデントを示している場合は、より詳細な情報に移動して、さらに問題を診断できます。

注意:

ホームページにアクセスするには、「WebCenter Portalのホームページへの移動」を参照してください。

図22-9 ホームページ上の最近のWebLogic Serverメトリックのサマリー

チャート・レポートは、WebLogic Serverの直前の100回のヘルス・チェックに基づいています。デフォルトでは、メトリックは5分ごとに記録されるため、直前の8時間にわたって収集されたデータをここに表示できます。サーバーが最近起動した場合は、サーバーが起動してから現在時刻にいたるまでのデータがチャートに表示されます。

注意:

必要に応じて、自分のインストールに合うようにメトリックの収集頻度をカスタマイズできます。詳細は、「主要なパフォーマンス・メトリックしきい値および収集のカスタマイズ」を参照してください。

表22-12 ホームページ上の最近のWebLogic Serverメトリック

メトリック

説明

ヘルス

Oracle WebLogic Server自己ヘルス・モニタリング機能によりレポートされた最近のWebLogic Serverヘルスのサマリー。このメトリックは、サーバー・ヘルス、スレッド・ヘルスおよびJDBCヘルスが対象です。

- 緑: WebLogic Serverヘルス・チェックの成功を表します。

- 赤: WebLogic Serverヘルス・チェック時にインシデントが発生したことを表します。
(OKとレポートされない)失敗したヘルス・チェックを特定するには、「ヘルス」をクリックします。図22-10を参照してください。

- %: 成功したWebLogic Serverヘルス・チェックの割合。デフォルトでは、割合は直前の100回のヘルス・チェックからのステータス情報を使用して計算されます。たとえば、直前の100回のヘルス・チェックのうち5回失敗した場合(OKとレポートされない場合)、ヘルスは95%と表示されます。

インシデント

WebLogic Serverメトリックがしきい値の設定(CPU使用率、メモリー使用率、スレッド数、JDBC接続の数、セッション・メトリックなどのメトリック)を超えた回数。

たとえば、メトリック・データ・セットで、スレッド数が事前に定義されたしきい値を2回超え、JDBC接続の数がしきい値制限を3回超えた場合、表示されるインシデント数は5です。

インシデント数が0を超える場合、赤い十字形のアイコンが表示されます。「インシデント」リンクをクリックして「最近のWebLogic Serverメトリック」ページ(図22-9)にドリルダウンし、「ヘルス・メトリック」表を調べて、さらにインシデントを診断します。

「ヘルス」または「インシデント」をクリックすると、「最近のWebLogic Serverメトリック」ページ(図22-9)にドリルダウンできます。このページに表示されるメトリックについては、次の項で説明します。

- 「WebLogic Serverメトリック」セクション

- 「最近のCPUおよびメモリー使用状況」セクション

- 「最近のセッションおよびスレッド使用状況」セクション

- 「最近のJDBC使用状況」セクション

- 「ヘルス・メトリック」セクション

図22-10 「最近のWebLogic Serverメトリック」ページ

22.1.7.1 「WebLogic Serverメトリック」セクション

メトリック

説明

一般

稼働開始

サーバーが最後に起動した日時。

状態

このサーバーの現在のライフサイクルの状態。たとえば、サーバーが実行中状態の場合は、リクエストを受信して処理できます。また、管理状態の場合は、管理リクエストのみを受信できます。

詳細は、『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分間に記録された比率を示します。「WebLogic Serverヘルス・チェックの頻度の構成」を参照してください。

ガベージ・コレクション平均時間(ミリ秒)

ガベージ・コレクションの各実行でJava Virtual Machineが費やした時間の長さの平均(ミリ秒)。表示される平均は直前の5分間のものです。

デフォルトでは、このメトリックは、直前の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%と表示されます。

22.1.7.2 「最近のCPU使用率とメモリー使用量」セクション

このグラフは、直前の100回のヘルス・チェックにおけるJava仮想マシンのCPUおよびメモリー使用状況を示します。時間範囲は最も早いヘルス・チェックで開始し、最後のヘルス・チェックの時間で終了します。

このパフォーマンス・グラフから、仮想マシン用に構成されているメモリー/CPUの実際の使用量と、増加傾向にあるかどうかを判断できます。これにより、その仮想マシン内で実行しているアプリケーションが、仮想マシンに割り当てられている以上のメモリーを必要としており、仮想マシンにメモリーを追加することで(ホスト・レベルで十分なメモリーがある場合)、パフォーマンスが改善される可能性があることが明らかになります。同様に、追加のCPUリソースが必要かどうかを評価できます。

メトリック

説明

CPU使用率(%)

Java Virtual Machine (JVM)で現在使用されているCPUの比率。これには、JVMがホスト・コンピュータ内のすべてのプロセッサに与えている負荷が含まれます。

たとえば、ホストが複数のプロセッサを使用する場合、この値はすべてのプロセッサの平均ロードのスナップショットを表します。

ヒープ使用量(MB)

Java Virtual Machine (JVM)で現在使用されているメモリー・ヒープのサイズ(MB)。

22.1.7.3 「最近のセッションおよびスレッド使用状況」セクション

このグラフは、直前の100回のヘルス・チェックで記録されたアクティブ・セッションおよびアクティブ・スレッドの数を示します。時間範囲は最も早いヘルス・チェックで開始し、最後のヘルス・チェックの時間で終了します。

アクティブ・セッションおよびアクティブ・スレッドの数は、システムの負荷とともに増減します。グラフが突然の増加を示したり、セッションまたはスレッドの数が増え続ける場合は、問題を詳しく調査して、動作の変化を引き起こした原因を把握します。

メトリック

説明

アクティブ・セッション

アプリケーションのアクティブ・セッションの数。

アクティブ・スレッド

アプリケーションのアクティブ・スレッドの数。

22.1.7.4 「最近のJDBC使用状況」セクション

このグラフは、直前の100回のヘルス・チェックで記録されたオープンJDBCセッションの数を示します。時間範囲は最も早いヘルス・チェックで開始し、最後のヘルス・チェックの時間で終了します。

ここに表示される全体のオープンJDBCセッション数は、サーバーに属するすべてのデータ・ソースにおける現在アクティブな接続数メトリックを使用して計算されます。

このチャートを使用して、使用されているJDBCセッションの数と、システムがJDBCリソースをリークしているかどうかを判断します。このチャートの情報を使用すると、JDBC構成または接続プール・サイズを調整する必要があるかどうかを評価できます。

22.1.7.5 「ヘルス・メトリック」セクション

この表には、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 JRockit JDKを使用している場合、このメトリックはJava仮想マシン(JVM)で現在使用中のCPUの割合を示します。これには、JVMがホスト・コンピュータ内のすべてのプロセッサに与えている負荷が含まれます。

たとえば、ホストが複数のプロセッサを使用する場合、この値はすべてのプロセッサの平均ロードのスナップショットを表します。

ヒープ使用量(MB)

JVMで現在使用されているメモリー・ヒープの総量(MB)。

ガベージ・コレクション平均時間(ミリ秒)

ガベージ・コレクションの各実行でJava Virtual Machineが費やした時間の長さの平均(ミリ秒)。表示される平均は直前の5分間のものです。

デフォルトでは、このメトリックは、直前の5分間の平均を示します。「WebLogic Serverヘルス・チェックの頻度の構成」を参照してください。

ガベージ・コレクション・レート(/分)

Java Virtual Machine (JVM)がガベージ・コレクション・ルーチンを呼び出している比率(/分)。

デフォルトでは、このメトリックは、直前の5分間に記録された比率を示します。「WebLogic Serverヘルス・チェックの頻度の構成」を参照してください。

アクティブ・セッション

アプリケーションのアクティブ・セッションの数。

アクティブな実行スレッド

プール内のアクティブな実行スレッドの数。

アイドル中の実行スレッド数

プール内のアイドル・スレッドの数。この数には、スタンバイ・スレッドおよびスタック・スレッドは含まれません。この数は、新しい処理が届いたときに対応することができるスレッドの数を示します。

占有スレッド数

リクエストによって現在保持されているスレッドの数。これらのスレッドは、構成されているタイムアウトの経過後にスタックとして宣言されるか、プールに戻されます。必要な場合は、自己チューニング・メカニズムによって戻されます。

オープンJDBC接続

現在オープンしているJDBC接続の数。

22.1.8 セキュリティ・メトリックの理解

WebCenter Portalのホームページに、主要ないくつかのセキュリティ関連パフォーマンス・メトリックが表示されます(図22-11および表22-13)。

注意:

ホームページにアクセスするには、「WebCenter Portalのホームページへの移動」を参照してください。

図22-11 ホームページ上のセキュリティ・メトリック

「起動時以降」のメトリックと「最近の履歴」のメトリックを比較すると、最近になってパフォーマンスが低下していないかどうか、低下している場合はその程度を判断できます。

表22-13 セキュリティ・メトリック

メトリック

説明

LDAPキャッシュ・ヒット率(%)

キャッシュ・ヒットとなるLDAP検索の割合。

平均LDAP参照時間(ミリ秒)

LDAP検索リクエスト完了の平均時間。

- 起動時以降

- 過去15分[1]

LDAP検索に時間がかかる場合は、LDAPサーバーに問題があり、それが原因で低速なレスポンス時間を引き起こしている可能性があります。Oracle Internet Directoryを使用している場合は、パフォーマンスを改善し、ボトルネックを回避する方法について、『パフォーマンスのチューニング』のOracle Internet Directoryパフォーマンス・チューニングに関する項を参照してください。他のLDAPサーバーについては、該当の製品ドキュメントを参照してください。

22.1.9 ページ・レスポンス・メトリックおよび負荷メトリックの理解

アプリケーションのホームページ上の「ページ・レスポンス」チャート(図22-11)は、ページ・リクエストに対するWebLogic Serverのレスポンス時間と、処理されているリクエスト数(負荷)を示します。

すべてのポータルでの平均ページ処理時間(ミリ秒)は、15分間にわたって計算されます。1分当たりの呼出し数も表示され、平均ページ処理時間が増加しているのか減少しているのかを判断する上で役立ちます。ページ処理時間の低下が、多数のユーザーがシステムにアクセスしていることが原因の場合は、1分当たりの呼出しの増加がグラフに表示されます。ユーザー数が増加していない場合(1分当たりの呼出しグラフが増加したり変化していない場合)、ページ処理速度の低下は、マシン・リソースの問題や、JVMリソースの不足(メモリー不足、データベース接続の競合など)の可能性が高いと考えられます。

「表ビュー」をクリックして、5分間隔で記録された詳細なレスポンス値および負荷値を参照します。

注意:

ホームページにアクセスするには、「WebCenter Portalのホームページへの移動」を参照してください。

図22-12 ホームページ上のページ・レスポンス・メトリック

「起動時以降」のメトリックと「最近の履歴」のメトリック(直前の15分)を比較すると、最近になってパフォーマンスが低下していないかどうか、低下している場合はその程度を判断できます。

22.1.10 ポータル・メトリックの理解

(WebCenter Portalのみ) 図22-13に示すように、Fusion Middleware Controlを使用して、個々のポータルの現在のパフォーマンス・メトリックを表示できます。このページに表示されるメトリックについては、表22-14および「すべてのツールとサービスに共通するメトリック」で説明しています。

注意:

ホーム・ポータルのメトリックは含まれません。

図22-13 ポータル・メトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

このページの上部の表には、個々のポータルのステータスとパフォーマンスがまとめて表示されます。この表を使用すると、どのポータルが稼働中かがすぐにわかり、個別的および相対的なパフォーマンスを確認できます。

統計は、ポータルが作成されると使用可能になり、メンバーがポータルにアクセスしたり使用するたびに更新されます。

表示されているデータは、次の方法でフィルタ処理できます。

- ポータル名フィルタ: 検索文字列全体またはその一部を入力してから、[Enter]を押します。リストがリフレッシュされ、一致する文字列を表示名に含むポータルがすべて表示されます。すべてのポータルのメトリックを表示するには、検索語をクリアし、[Enter]を再度押します。

- 最大行数: 表に表示するポータルの総数を制限します。

- 表示: 最もアクセスされたポータル、最も遅いポータルまたは最もエラーが多いポータルのメトリックを表示します。選択に応じて、表のポータルは次の順序で並べられます。
- 呼出し数(最もアクセスされたポータル)

- 平均ページ処理時間(最も遅いポータル)

- エラー数(最もエラーが多いポータル)

- 期間 - 起動時以降または過去15分間(最近の履歴)に収集されたメトリック情報を表示します。

上位5つのポータルがチャートに表示されます。

表22-14 ポータル・メトリック

メトリック

説明

名前

フィルタ基準(指定されている場合)に一致するポータルの名前。

フィルタ基準が指定されない場合は、すべてのポータルがリストされます。

ステータス

各ポータルの現在のステータス:

- 稼働中(緑色の上矢印): 最後のポータル操作が成功したことを示します。ポータルは稼働中です。

- 停止中(赤色の下矢印): ポータルが現在使用できないか、予期しないエラーまたは例外のために最後のポータル操作が失敗したことを示します。認証の失敗などのユーザー・エラーによってステータスが「停止中」に変わることはありません。

- 使用不可(時計): ステータス情報は現在使用できません。

呼出し

ポータル呼出しの合計数:

- 起動時以降

- 過去15分

エラー

記録されたエラーの数。

成功した呼出し(%)

成功したポータル呼出しの割合:

- 起動時以降

- 過去15分

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、ポータル・リクエストの失敗の原因を特定してください。「ログ情報の表示および構成」を参照してください。

ページ・スループット

各ポータルについて1分間に処理された平均ページ数:

- 起動時以降

- 過去15分

平均時間(ミリ秒)

ポータルにページを表示するための平均時間(ミリ秒):

- 起動時以降

- 過去15分

最大時間(ミリ秒)

ポータルでページの表示にかかった最大時間。

最小時間(ミリ秒)

ポータルでページの表示にかかった最小時間。

ポータル・メトリック - グラフ

表の下のグラフを使用して、ポータルに関する情報を確認します。

- 呼出し: 最もアクティブ/人気のポータル(つまり、最も多くの呼出しが記録されているポータル)を示すグラフ。

- ページ・スループット: 各ポータルについて1分間にアクセスされた平均ページ数を示すグラフ。このグラフを使用すると、ページ・ヒット率が高い(または低い)ポータルを特定できます。

- 平均処理時間: 平均ページ・レスポンス時間(ミリ秒)を示すグラフ。このグラフを使用すると、ページ・パフォーマンスが最高(または最低)のポータルを特定できます。

- エラー: エラーを最も多くレポートしているポータルを示すグラフ。このグラフを使用すると、エラー率を比較できます。

異なるポータルのセットを比較する手順は次のとおりです。

- 適切なフィルタリング基準を指定します。

- 表で1つ以上のポータルを選択し、「チャートで表示」をクリックします。

22.1.11 ツール・メトリックおよびサービス・メトリックの理解

この項には次のトピックが含まれます:

- すべてのツールとサービスに共通するメトリック

- 特定のツールまたはサービス固有のメトリック

- ツールとサービスに関する一般的な問題のトラブルシューティング

22.1.11.1 すべてのツールとサービスに共通するメトリック

Fusion Middleware Controlでは、WebCenter Portalで使用されるツールやサービスのパフォーマンスを次の方法でモニターする機能を提供します。

- サービス・サマリー: WebCenter Portalで使用されている各ツールまたはサービスのパフォーマンス・メトリックのサマリー。表22-15に、共通のパフォーマンス・メトリックを使用するツールとサービスを示します。表22-16で、共通メトリックについて説明します。

- 最もポピュラーな操作および個別の操作のレスポンス時間。表22-17で、これらのメトリックについて説明します。

- 操作別メトリック: 個別の操作のパフォーマンス・メトリック。表22-15に、個別の操作のパフォーマンスをモニターするために使用される共通のパフォーマンス・メトリックを示します。表22-17で、これらのメトリックについて説明します。

表22-15 ツールとサービスの共通メトリック

ツールまたはサービス

サービス・サマリー(起動時以降および過去15分)

操作別メトリック(起動時以降および過去15分)

お知らせ

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

SOAサーバー

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

該当なし

ディスカッション・フォーラム

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

外部アプリケーション

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

イベント

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

インポート/エクスポート

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

インスタント・メッセージおよびプレゼンス(IMP)

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

リスト

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

メール

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

ノート

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

ページ

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

ピープル・コネクション

パフォーマンス・メトリックには、次のものが含まれます。

- 平均処理時間(ミリ秒)

- 呼出し

- 成功した呼出し(%)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

RSS

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

使用不可

検索

パフォーマンス・メトリックには、次のものが含まれます。

- ステータス

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

パフォーマンス・メトリックには、次のものが含まれます。

- 最もポピュラーな操作

- レスポンス時間

- 成功した呼出し(%)

- 呼出し

- 平均時間(ミリ秒)

- 最大時間(ミリ秒) (起動時以降のみ)

表22-16では、すべての操作のパフォーマンスをモニタリングするために使用されるメトリックについて説明します。

表22-16 共通メトリックの説明: サマリー(すべての操作)

メトリック

説明

ステータス

ツールまたはサービスの現在のステータス:

- 稼働中(緑色の上矢印): ツールまたはサービスが稼働中であり、最後の操作が成功したことを示します。

- 停止中(赤色の下矢印): ツールまたはサービスが現在使用できないことを示します。最後の操作が予期しないエラーまたは例外により失敗しました。認証の失敗などのユーザー・エラーによってステータスが「停止中」に変わることはありません。

- 不明(時計) - なんらかの理由により、ツールまたはサービスがWebCenter Portalのステータスを問合せできないことを示します。管理対象サーバーが停止しているか、ネットワークの問題が原因でノードにアクセスできない可能性があります。

特定のツールまたはサービスが停止中または不明の場合は、考えられる原因とアクションについて、「ツールとサービスに関する一般的な問題のトラブルシューティング」を参照してください。

成功した呼出し(%)

成功したサービス呼出しの割合。成功した呼出し(%)は、成功した呼出し数を呼出し数で除算した値に一致します。

- 起動時以降

- 過去15分

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。「ログ情報の表示および構成」を参照してください。

呼出し

1分当たりのサービス呼出し数:

- 起動時以降

- 過去15分

このメトリックは、操作の処理で特定のツールまたはサービスが呼び出される頻度に関するデータを提供します。サービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたツールおよびサービスを特定できます。

平均時間(ミリ秒)

ツールまたはサービスに関連付けられた操作の処理にかかった平均時間。このメトリックは、操作の処理に費やされた総時間を評価するために呼出し数のメトリックとともに使用できます。

- 起動時以降

- 過去15分

このメトリックを使用すると、ツールおよびサービス全体のパフォーマンスを判断できます。このメトリックが範囲外の場合は(操作の平均時間が増加しているか予想より高い場合)、個々の名前をクリックして、詳細なメトリック・データを表示します。

表22-17では、ツール、サービスまたはコンポーネントによって実行される各操作のパフォーマンスをモニターするために使用されるメトリックについて説明します。

表22-17 共通メトリックの説明: 操作別

メトリック

説明

最もポピュラーな操作

各操作の起動回数(チャートで表示)。

チャートの最大値は、最も多く使用されている操作を示します。

最小値は、最も使用されていない操作を示します。

レスポンス時間

WebCenter Portalが起動されてから、サービスに関連付けられた操作の処理にかかった平均時間(チャートで表示)。

チャートの最大値は、パフォーマンスが最も低い操作を示します。

最小値は、パフォーマンスが最も高い操作を示します。

操作

モニター対象の操作。「特定のツールまたはサービス固有のメトリック」を参照してください。

呼出し

各操作の起動回数:

- 起動時以降

- 過去15分

このメトリックは、操作の処理で特定のツールまたはサービスが呼び出される頻度に関するデータを提供します。サービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたサービスを特定できます。

平均時間(ミリ秒)

各操作の処理にかかった平均時間:

- 起動時以降*

- 最近の履歴

*この情報は、「レスポンス時間」チャートにも表示されます。

最大時間(ミリ秒)

各操作の処理にかかった最大時間。

22.1.11.2 特定のツールまたはサービス固有のメトリック

この項では、すべてのツール、サービスおよびコンポーネントの操作別メトリックについて説明します。この項には次のトピックが含まれます:

- お知らせのメトリック

- BPELワークリストのメトリック

- コンテンツ・リポジトリのメトリック

- ディスカッションのメトリック

- 外部アプリケーションのメトリック

- イベントのメトリック

- インスタント・メッセージおよびプレゼンス・メトリック

- インポートおよびエクスポートのメトリック

- リストのメトリック

- メールのメトリック

- ノートのメトリック

- ページ操作のメトリック

- ピープル・コネクションのメトリック

- RSSニュース・フィード・メトリック

- 検索のメトリック

WebCenter Portalの現在のパフォーマンス・メトリックにアクセスするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

22.1.11.2.1 お知らせのメトリック

お知らせに関連するパフォーマンス・メトリック(図22-14)については、表22-18および「すべてのツールとサービスに共通するメトリック」で説明しています。

図22-14 お知らせのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表22-18 お知らせ: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

ログイン

(お知らせにアクセスしている) WebCenter Portalユーザーが、お知らせをホストしているディスカッション・サーバーにログインします。

特定の原因については、「お知らせ: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

ログアウト

WebCenter Portalユーザーが、お知らせをホストしているディスカッション・サーバーからログアウトします。

特定の原因については、「お知らせ: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

検索

お知らせテキスト内の文字列を検索します。

お知らせの検索に失敗する場合は、お知らせのテキストに検索語が含まれていることを確認します。

その他の原因については、「お知らせ: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

作成

お知らせを作成します。

特定の原因については、「お知らせ: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

リスト

お知らせのリストを取得します。

特定の原因については、「お知らせ: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

22.1.11.2.2 BPELワークリストのメトリック

ワークリストに関連するパフォーマンス・メトリックについては、「すべてのツールとサービスに共通するメトリック」で説明しています。

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

22.1.11.2.3 コンテンツ・リポジトリのメトリック

次の表では、ドキュメントおよびコンテンツ・プレゼンタに関連するパフォーマンス・メトリック(図22-15および図22-16)について説明します。

- 表22-19

- 表22-20

- 表22-21

- 表22-22

図22-15 コンテンツ・リポジトリのメトリック

図22-16 コンテンツ・リポジトリのメトリック: 操作別

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表22-19 コンテンツ・リポジトリ: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

ダウンロード

1つ以上のドキュメントをコンテンツ・リポジトリからダウンロードします。

特定の原因については、「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

アップロード

1つ以上のドキュメントをコンテンツ・リポジトリにアップロードします。

特定の原因については、「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

検索

コンテンツ・リポジトリに格納されているドキュメントを検索します。

特定の原因については、「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

ログイン

コンテンツ・リポジトリへの接続を確立し、ユーザーを認証します。

特定の原因については、「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

削除

コンテンツ・リポジトリに格納されている1つ以上のドキュメントを削除します。

特定の原因については、「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

フォルダのリスト

コンテンツ・リポジトリに格納されているフォルダのリストを表示します。この操作は、コンテンツ・プレゼンタに固有のものです。

特定の原因については、「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

項目の取得

コンテンツ・リポジトリに保存されたドキュメントやイメージなどの項目を表示します。この操作は、コンテンツ・プレゼンタに固有のものです。

特定の原因については、「コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

表22-20 コンテンツ・リポジトリのメトリック: サマリー(すべてのリポジトリ)

メトリック

説明

ステータス

ドキュメント・ツールの現在のステータス:

- 稼働中(緑色の上矢印): ドキュメント・ツールが稼働中であり、最後の操作が成功したことを示します。

- 停止中(赤色の下矢印): ドキュメント・ツールが現在使用できないか、サービス・リクエストが失敗していることを示します。これはまた、最後の操作が予期しないエラーまたは例外により失敗したことを示します。認証の失敗などのユーザー・エラーによってステータスが「停止中」に変わることはありません。
ドキュメントに問題がある場合は、診断ログを調べて、このツールが停止した原因を特定してください。「ログ情報の表示および構成」を参照してください。

よくある失敗原因は次のとおりです。

- コンテンツ・リポジトリが停止しているか、応答していません。

- アプリケーションと1つ以上のコンテンツ・リポジトリの間にネットワーク接続の問題があります。

- 1つ以上のコンテンツ・リポジトリに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

- 不明(時計): なんらかの理由でツールのステータスを問い合せることができません。管理対象サーバーが停止しているか、ネットワークの問題が原因でノードにアクセスできない可能性があります。さらに診断するには、管理サーバーのログおよび管理対象サーバーのログを確認します。

成功した呼出し(%)

成功したドキュメントの呼出し(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の割合:

- 起動時以降

- 過去15分

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。「ログ情報の表示および構成」を参照してください。

呼出し

1分当たりのドキュメントの呼出し数(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」):

- 起動時以降

- 過去15分

このメトリックは、操作の処理で特定のツールまたはサービスが呼び出される頻度に関するデータを提供します。サービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたツールまたはサービスを特定できます。

平均時間(ミリ秒)

ドキュメントに関連付けられた操作(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の処理にかかった平均時間:

- 起動時以降

- 過去15分

最もポピュラーな操作

各操作の起動回数(チャートで表示)。

チャートの最大値は、最も多く使用されている操作を示します。

最小値は、最も使用されていない操作を示します。

レスポンス時間

WebCenter Portalが起動されてから、ドキュメントに関連付けられた操作の処理にかかった平均時間(チャートで表示)。

チャートの最大値は、パフォーマンスが最も低い操作を示します。

最小値は、パフォーマンスが最も高い操作を示します。

ダウンロード・スループット(バイト数/秒)

ドキュメントがダウンロードされる速度。

アップロード・スループット(バイト数/秒)

ドキュメントがアップロードされる速度。

表22-21 コンテンツ・リポジトリのメトリック: 各リポジトリの操作サマリー

メトリック

説明

ステータス

コンテンツ・リポジトリの現在のステータス:

- 稼働中(緑色の上矢印): コンテンツ・リポジトリが稼働中であり、最後の操作が成功したことを示します。

- 停止中(赤色の下矢印): コンテンツ・リポジトリが現在使用できないか、サービス・リクエストが失敗していることを示します。これはまた、最後の操作が予期しないエラーまたは例外により失敗したことを示します。認証の失敗などのユーザー・エラーによってステータスが「停止中」に変わることはありません。
コンテンツ・リポジトリに問題がある場合は、診断ログを調べて、このサービスが停止した原因を特定してください。「ログ情報の表示および構成」を参照してください。

よくある失敗原因は次のとおりです。

- コンテンツ・リポジトリが停止しているか、応答していません。

- アプリケーションと1つ以上のコンテンツ・リポジトリの間にネットワーク接続の問題があります。

- 1つ以上のコンテンツ・リポジトリに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

- 不明(時計): なんらかの理由でツールまたはサービスのステータスを問い合せることができません。管理対象サーバーが停止しているか、ネットワークの問題が原因でノードにアクセスできない可能性があります。さらに診断するには、管理サーバーのログおよび管理対象サーバーのログを確認します。

成功した呼出し(%)

このコンテンツ・リポジトリに対して成功したドキュメントの呼出し(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の割合:

- 起動時以降

- 過去15分

「成功した呼出し(%)」が100%を下回っている場合、診断ログを調べて、サービス・リクエストの失敗の原因を特定してください。「ログ情報の表示および構成」を参照してください。

呼出し

このコンテンツ・リポジトリに対する1分当たりのドキュメントの呼出し数(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」):

- 起動時以降

- 過去15分

このメトリックは、操作の処理で特定のツールまたはサービスが呼び出される頻度に関するデータを提供します。ツールおよびサービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたツールおよびサービスを特定できます。

平均時間(ミリ秒)

このコンテンツ・リポジトリに対してドキュメントに関連付けられた操作(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の処理にかかった平均時間:

- 起動時以降

- 過去15分

ダウンロードされたバイト数

このコンテンツ・リポジトリからダウンロードされたデータ量。

ダウンロード・スループット(バイト数/秒)

このコンテンツ・リポジトリからドキュメントがダウンロードされる速度。

アップロードされたバイト数

このコンテンツ・リポジトリにアップロードされたデータ量。

アップロード・スループット(バイト数/秒)

このコンテンツ・リポジトリにドキュメントがアップロードされる速度。

最大時間(ミリ秒)

このコンテンツ・リポジトリに対してドキュメントに関連付けられた操作(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の処理にかかった最大時間。

表22-22 コンテンツ・リポジトリのメトリック: 各リポジトリの操作詳細

メトリック

説明

呼出し

ドキュメント操作別の呼出し数(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」):

- 起動時以降

- 過去15分

このメトリックは、操作の処理で特定のサービスが呼び出される頻度に関するデータを提供します。サービス間でこのメトリックを比較することで、アプリケーション内で最も頻繁に使用されたサービスを特定できます。

平均処理時間(ミリ秒)

ドキュメントに関連付けられた各操作(「アップロード」、「ダウンロード」、「検索」、「ログイン」、「削除」)の処理にかかった平均時間:

- 起動時以降

- 過去15分

22.1.11.2.4 ディスカッションのメトリック

ディスカッションに関連するパフォーマンス・メトリック(図22-17)については、表22-23および「すべてのツールとサービスに共通するメトリック」で説明しています。

図22-17 ディスカッションのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表22-23 ディスカッション: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

ログイン

(ディスカッションにアクセスしている) WebCenter Portalユーザーが、ディスカッション・フォーラムをホストしているディスカッション・サーバーにログインします。

特定の原因については、「ディスカッション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

ログアウト

WebCenter Portalユーザーが、ディスカッション・フォーラムをホストしているディスカッション・サーバーからログアウトします。

特定の原因については、「ディスカッション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

フォーラムの作成

ディスカッション・サーバー内に、特定のカテゴリに含まれるディスカッション・フォーラムを作成します。

フォーラムの作成に関する問題がある場合は、次の原因が考えられます。

- ディスカッション・フォーラムを作成する必要があるカテゴリが削除されました。

- ユーザーにディスカッション・フォーラムを作成する権限がありません。

その他の特定の原因については、「ディスカッション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

トピックの作成

ディスカッション・サーバー内に、特定のフォーラムに含まれるトピックを作成します。

トピックの作成に関する問題がある場合は、次の原因が考えられます。

- トピックを作成する必要があるディスカッション・フォーラムが削除されました。

- ユーザーにトピックを作成する権限がありません。

その他の特定の原因については、「ディスカッション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

フォーラムのリスト

ディスカッション・サーバーから、特定のカテゴリ内のフォーラムのリストを取得します。

ディスカッション・フォーラムの表示に関する問題がある場合は、次の原因が考えられます。

- ユーザーにカテゴリのフォーラムを表示する権限がありません。

- フォーラムをフェッチするカテゴリが削除されました。

その他の特定の原因については、「ディスカッション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

トピックのリスト

ディスカッション・サーバーから、特定のフォーラム内のトピックのリストを取得します。

トピックの表示に関する問題がある場合は、次の原因が考えられます。

- ユーザーにフォーラムのトピックを表示する権限がありません。

- トピックをフェッチするフォーラムが削除されました。

その他の特定の原因については、「ディスカッション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

検索

ディスカッション・サーバーでディスカッション・フォーラム内の文字列を検索します。

フォーラムの検索に関する問題がある場合は、次の原因が考えられます。

- 指定の検索語を含むトピック/メッセージが存在しません。

- 検索語オブジェクトが存在するカテゴリまたはフォーラムが削除されました。

その他の特定の原因については、「ディスカッション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

22.1.11.2.5 イベントのメトリック

イベントに関連するパフォーマンス・メトリックについては、表22-24および「すべてのツールとサービスに共通するメトリック」で説明しています。

図22-18 イベントのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表22-24 イベント: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

イベントの作成

WebCenter Portalのリポジトリでポータル・イベントまたは個人カレンダ・イベントを作成します。

特定の原因については、「イベント: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

イベントの更新

WebCenter Portalのリポジトリに格納されているポータル・イベントまたは個人カレンダ・イベントを更新します。

特定の原因については、「イベント: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

イベントの削除

WebCenter Portalのリポジトリからポータル・イベントまたは個人カレンダ・イベントを削除します。

特定の原因については、「イベント: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

イベントのリスト

WebCenter Portalのリポジトリからイベントのリストを取得します。

特定の原因については、「イベント: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

イベントの検索

イベント・テキスト内の文字列を検索します。

特定の原因については、「イベント: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

22.1.11.2.6 外部アプリケーションのメトリック

外部アプリケーションに関連するパフォーマンス・メトリックについては、表22-25および「すべてのツールとサービスに共通するメトリック」で説明しています。

図22-19 外部アプリケーションのメトリック

図22-20 外部アプリケーションのメトリック: 操作別

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表22-25 外部アプリケーション: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

資格証明のフェッチ

外部アプリケーションの資格証明を取得します。

特定の原因については、「外部アプリケーション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

資格証明の格納

外部アプリケーションのユーザー資格証明を格納します。

特定の原因については、「外部アプリケーション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

外部アプリケーションのフェッチ

外部アプリケーションを取得します。

特定の原因については、「外部アプリケーション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

自動ログイン

WebCenter Portalユーザーが(自動ログイン機能を使用して)外部アプリケーションにログインします。

特定の原因については、「外部アプリケーション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

22.1.11.2.7 インスタント・メッセージおよびプレゼンス・メトリック

インスタント・メッセージおよびプレゼンスに関連するパフォーマンス・メトリックについては、表22-26および「すべてのツールとサービスに共通するメトリック」で説明しています。

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表22-26 インスタント・メッセージおよびプレゼンス: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

プレゼンスの取得

インスタント・メッセージおよびプレゼンス・サーバーからユーザー・プレゼンス情報を取得します。

特定の原因については、「インスタント・メッセージおよびプレゼンス: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

ログイン

(インスタント・メッセージおよびプレゼンスにアクセスしている) WebCenter Portalユーザーがインスタント・メッセージおよびプレゼンス・サーバーにログインします。

特定の原因については、「インスタント・メッセージおよびプレゼンス: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

ログアウト

(インスタント・メッセージおよびプレゼンスにアクセスしている) WebCenter Portalユーザーがインスタント・メッセージおよびプレゼンス・サーバーからログアウトします。

特定の原因については、「インスタント・メッセージおよびプレゼンス: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

22.1.11.2.8 インポートおよびエクスポートのメトリック

インポートおよびエクスポートに関連するパフォーマンス・メトリック(図22-21)については、表22-27および「すべてのツールとサービスに共通するメトリック」で説明しています。これらのメトリックはWebCenter Portalにのみ適用されます。

図22-21 インポート/エクスポートのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表22-27 インポート/エクスポート: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

エクスポート

WebCenter Portalアプリケーション全体をエクスポートします。

特定の原因については、「インポートおよびエクスポート: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

インポート

WebCenter Portalアプリケーション全体をインポートします。

特定の原因については、「インポートおよびエクスポート: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

22.1.11.2.9 リストのメトリック

(WebCenter Portalのみ)リストに関連するパフォーマンス・メトリック(図22-22)については、表22-28および「すべてのツールとサービスに共通するメトリック」で説明しています。

図22-22 リストのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表22-28 リスト: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

リストの作成

ユーザー・セッション内でリストを作成します。

「データの保存」操作を実行すると、新しいリストがMDSリポジトリに対してコミットされます。

特定の原因については、「リスト: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

リストのコピー

ユーザー・セッション内でリストおよびそのデータをコピーします。

「データの保存」操作を実行すると、コピーしたリストおよびリスト・データがMDSリポジトリとWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

特定の原因については、「リスト: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

リストの削除

ユーザー・セッション内でリストおよびそのデータを削除します。

「データの保存」操作を実行すると、リストの変更がMDSリポジトリとWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

特定の原因については、「リスト: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

行の作成

ユーザー・セッション内でリスト・データの行を作成します。

「データの保存」操作を実行すると、リスト・データの変更がWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

特定の原因については、「リスト: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

行の更新

ユーザー・セッション内でリスト・データの行を更新します。

「データの保存」操作を実行すると、リスト・データの変更がWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

特定の原因については、「リスト: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

行の削除

ユーザー・セッション内でリスト・データの行を削除します。

「データの保存」操作を実行すると、リスト・データの変更がWebCenter Portalのリポジトリ(リスト・データの格納先のデータベース)に対してコミットされます。

特定の原因については、「リスト: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

検索

メタデータ・リポジトリからIDによりリストを取得します。

特定の原因については、「リスト: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

データの保存

(ユーザー・セッション内の)リストおよびリスト・データのすべての変更をメタデータ・サービス・リポジトリとWebCenter Portalのリポジトリ(リスト情報の格納先のデータベース)に保存します。

特定の原因については、「リスト: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

22.1.11.2.10 メールのメトリック

メールに関連するパフォーマンス・メトリック(図22-23)については、表22-29および「すべてのツールとサービスに共通するメトリック」で説明しています。

図22-23 メールのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表22-29 メール: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

ログイン

WebCenter Portalユーザーが、メール・サービスをホストしているメール・サーバーにログインします。

特定の原因については、「メール: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

ログアウト

WebCenter Portalユーザーが、メール・サービスをホストしているメール・サーバーからログアウトします。

特定の原因については、「メール: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

受信

メールを受信します。

特定の原因については、「メール: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

送信

メールを送信します。

特定の原因については、「メール: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

検索

特定の文字列を含むメールを検索します。

特定の原因については、「メール: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

22.1.11.2.11 ノートのメトリック

ノートに関連するパフォーマンス・メトリック(図22-24)については、表22-30および「すべてのツールとサービスに共通するメトリック」で説明しています。

図22-24 ノートのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表22-30 ノート: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

作成

個人用ノートを作成します。

「変更の保存」操作を実行すると、新しいノートがMDSリポジトリに対してコミットされます。

特定の原因については、「ノート: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

更新

個人用ノートを更新します。

「変更の保存」操作を実行すると、ノートの更新がMDSリポジトリに対してコミットされます。

特定の原因については、「ノート: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

検索

MDSリポジトリからノートを取得します。

特定の原因については、「ノート: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

削除

MDSリポジトリからノートを削除します。

特定の原因については、「ノート: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

22.1.11.2.12 ページ操作のメトリック

ページ操作に関連するパフォーマンス・メトリック(図22-25)については、表22-31および「すべてのツールとサービスに共通するメトリック」で説明しています。

注意:

この項で説明するページ操作のメトリックは、「ページ・リクエスト・メトリックの理解」で説明しているページ・リクエスト・メトリックとは異なります。ページ操作のメトリックでは、ページの作成など、ページ関連の操作がモニターされます。これに対して、ページ・リクエスト・メトリックでは、個々のページ・ビュー/表示リクエストがモニターされます(ページ編集操作は含まれません)。

図22-25 ページ操作のメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表22-31 ページ・サービス: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

作成

WebCenter Portalでページを作成します。

特定の原因については、「ページ・サービス: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

コピー

ページをコピーします。

特定の原因については、「ページ・サービス: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

削除

ページを削除します。

特定の原因については、「ページ・サービス: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

検索

特定の文字列を含むページを検索します。

特定の原因については、「ページ・サービス: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

22.1.11.2.13 ピープル・コネクションのメトリック

ピープル・コネクションに関連するパフォーマンス・メトリックについては、表22-32および「すべてのツールとサービスに共通するメトリック」で説明しています。

図22-26 ピープル・コネクションのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表22-32 ピープル・コネクション: モニター対象の操作

操作

説明

パフォーマンス問題: ユーザー処理

プロファイルの取得

ユーザーのプロファイルを取得します。

特定の原因については、「ピープル・コネクション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

アクティビティの取得

ユーザーのフィルタ・オプションに基づいてアクティビティを取得します。

特定の原因については、「ピープル・コネクション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

アクティビティの公開

ユーザー・セッションにアクティビティを公開し、それをWebCenter Portalに保存します。

特定の原因については、「ピープル・コネクション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

メッセージの取得

ユーザーのメッセージを取得します。

特定の原因については、「ピープル・コネクション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

フィードバックの取得

ユーザーのフィードバックを取得します。

特定の原因については、「ピープル・コネクション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

コネクションの取得

ユーザーの接続を取得します。

特定の原因については、「ピープル・コネクション: 問題およびアクション」を参照してください。

一般的な原因については、「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

22.1.11.2.14 RSSニュース・フィードのメトリック

RSSニュース・フィードに関連するパフォーマンス・メトリック(図22-27)については、「すべてのツールとサービスに共通するメトリック」で説明しています。

図22-27 RSSニュース・フィードのメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

22.1.11.2.15 検索のメトリック

検索に関連するパフォーマンス・メトリック(図22-28)については、表22-33および「すべてのツールとサービスに共通するメトリック」で説明しています。

図22-28 検索のメトリック

Fusion Middleware Controlを使用してこれらのメトリックをモニターするには、「Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示」を参照してください。

表22-33 検索: 検索ソース

操作

説明

お知らせ

お知らせのテキストが検索されます。

ドキュメント

ファイルおよびフォルダ内のコンテンツが検索されます。

ディスカッション・フォーラム

フォーラムおよびトピックが検索されます。

WebCenter Portal

リンク、リスト、ノート、タグ、イベントなど、ポータルに保存されたコンテンツが検索されます。

ポータル・イベント

ポータル・イベントが検索されます。

リンク

リンクが作成された対象のオブジェクトが検索されます(たとえば、お知らせ、ディスカッション・フォーラムのトピック、ドキュメント、イベントなど)。

リスト

リストで保存された情報が検索されます。

ノート

アラームなどのノート・テキストが検索されます。

Oracle Secure Enterprise Search

ディスカッション、タグ・クラウド、ノート、その他のツールおよびサービスのコンテンツが検索されます。

ページ

アプリケーション・ページ、個人ページ、パブリック・ページ、wikiページおよびブログ・ページに追加されたコンテンツが検索されます。

22.1.11.3 ツールとサービスに関する一般的な問題のトラブルシューティング

この項では、個々のツールおよびサービスで発生する可能性がある問題と、それらの問題に対処するためのアクションについて説明します。

関連項目:

共通のパフォーマンスの問題およびアクションの理解

この項には次のトピックが含まれます:

- お知らせ: 問題およびアクション

- コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション

- ディスカッション: 問題およびアクション

- 外部アプリケーション: 問題およびアクション

- イベント: 問題およびアクション

- インスタント・メッセージおよびプレゼンス: 問題およびアクション

- インポートおよびエクスポート: 問題およびアクション

- リスト: 問題およびアクション

- メール: 問題およびアクション

- ノート: 問題およびアクション

- ページ・サービス: 問題およびアクション

- ポートレットおよびプロデューサ: 問題およびアクション

- ピープル・コネクション: 問題およびアクション

- RSSニュース・フィード: 問題およびアクション

- 検索: 問題およびアクション

22.1.11.3.1 お知らせ: 問題およびアクション

お知らせに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- ディスカッション・サーバーが停止しているか、応答していません。

- アプリケーションとディスカッション・サーバーの間にネットワーク接続の問題があります。

- お知らせに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

22.1.11.3.2 コンテンツ・リポジトリ(ドキュメントおよびコンテンツ・プレゼンタ): 問題およびアクション

ドキュメント・サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。また、次のいずれかを実行します。

- Content Server (Oracle WebCenter Content)の場合は、バックエンド・サーバーが稼働していることを確認します。

- Content Serverの場合は、サービスが適切に機能していないクライアントのソケット接続が開いていることを確認します。Intradocサーバー・ポート経由でContent Serverとの通信を許可されたIPアドレスのリストを確認します(IPアドレス・フィルタ)。詳細は、『Oracle Fusion Middleware Oracle WebCenter Contentの管理』のFusion Middleware Controlを使用したインターネット構成の変更に関する項を参照してください。

- (機能チェック)バックエンド・サーバーのログをチェックします。Content Serverの場合、「Content Server」→「管理」→「ログ・ファイル」→「Content Serverログ」に移動します。

- (機能チェック)モジュール名の先頭が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_Portal-diagnostic.logという名前が付けられます。「ログ情報の表示および構成」を参照してください。

22.1.11.3.3 ディスカッション: 問題およびアクション

ディスカッションに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- ディスカッション・サーバーが停止しているか、応答していません。

- アプリケーションとディスカッション・サーバーの間にネットワーク接続の問題があります。

- ディスカッションに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

22.1.11.3.4 外部アプリケーション: 問題およびアクション

外部アプリケーション・サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- アプリケーションに対して資格証明ストアが構成されていません。

- 構成されている資格証明ストア(たとえばOracle Internet Directoryなど)が停止しているか、応答していません。

22.1.11.3.5 イベント: 問題およびアクション

イベント(ポータル・イベントまたは個人イベント)に関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- WebCenter Portalのリポジトリ(イベント情報が保存されるデータベース)が使用可能ではありません。

- アプリケーションとWebCenter Portalのリポジトリの間にネットワーク接続の問題があります。

- イベントに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

22.1.11.3.6 インスタント・メッセージおよびプレゼンス: 問題およびアクション

インスタント・メッセージおよびプレゼンスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- インスタント・メッセージおよびプレゼンス・サーバーが使用可能ではありません。

- アプリケーションと、インスタント・メッセージおよびプレゼンス・サーバーの間にネットワーク接続の問題があります。

- インスタント・メッセージおよびプレゼンス・サーバーに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

22.1.11.3.7 インポートおよびエクスポート: 問題およびアクション

インポートおよびエクスポートに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。

22.1.11.3.8 リスト: 問題およびアクション

リストに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- リストに関連付けられているデータが格納されているMDSリポジトリまたはWebCenter Portalのリポジトリが使用可能ではありません。

- アプリケーションとリポジトリの間にネットワーク接続の問題があります。

22.1.11.3.9 メール: 問題およびアクション

メールに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- メール・サーバーが使用可能ではありません。

- アプリケーションとメール・サーバーの間にネットワーク接続の問題があります。

- メール・サーバーに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

22.1.11.3.10 ノート: 問題およびアクション

ノートで問題が発生した場合は、MDSリポジトリ(ノート情報が保存されるリポジトリ)が使用不可ではないか、または応答が低速になっていないかをチェックします。

22.1.11.3.11 ページ・サービス: 問題およびアクション

ページ編集サービスに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- WebCenter Portalのリポジトリ(ページ情報の格納先のデータベース)が使用できません。

- アプリケーションとWebCenter Portalのリポジトリの間にネットワーク接続の問題があります。

22.1.11.3.12 ポートレットおよびプロデューサ: 問題およびアクション

ポートレット・プロデューサに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- ポートレット・プロデューサ・サーバーが停止しているか、応答していません。

- ポートレット・プロデューサに関連付けられた接続構成情報が間違っているか、有効でなくなりました。

- プロデューサ・リクエストがタイムアウトしました。

- 特定のプロデューサに関する問題またはそのプロデューサの特定のポートレットに起因するパフォーマンスの問題が存在します。

22.1.11.3.13 ピープル・コネクション: 問題およびアクション

ピープル・コネクションに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- サービスが停止しているか、応答していません。

- WebCenter Portalのリポジトリ(ピープル・コネクション情報の格納先のデータベース)が使用できません。

- アプリケーションとWebCenter Portalのリポジトリの間にネットワーク接続の問題があります。

22.1.11.3.14 RSSニュース・フィード: 問題およびアクション

RSSニュース・フィードに関する問題が発生した場合で、ステータスが「停止中」であるときは、このサービスが使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- RSSサービスが使用可能ではありません。

- アクティビティ・データを検索中のサービスが失敗しました。例:

- ディスカッション・データまたはお知らせデータを取得できない場合: ディスカッションおよびお知らせのパフォーマンスをチェックします。

- リスト・データを取得できない場合: リストのパフォーマンスをチェックします。

22.1.11.3.15 検索: 問題およびアクション

検索(サービス実行元)に関する問題が発生した場合で、ステータスが「停止中」であるときは、この実行元が使用できない原因を確認するために診断ログをチェックします。よくある失敗原因は次のとおりです。

- 実行元のリポジトリが使用可能ではありません。

- アプリケーションと実行元のリポジトリの間にネットワーク接続の問題があります。

- 実行元に関連付けられた接続構成情報が間違っているか、有効でなくなりました。

- 検索中のコンテンツ・リポジトリが現在使用できません。

22.2 Fusion Middleware Controlを使用したパフォーマンス・メトリックの表示

Fusion Middleware Controlでは、WebCenter Portalの様々なパフォーマンス・メトリックをモニターできます。

管理者は、WebCenter Portal全体およびそれを構成するすべてのコンポーネントとサービスのパフォーマンスおよび可用性をモニターできます。これらの詳細なメトリックは、パフォーマンス問題の診断に役立ちます。また、定期的にモニターすれば、開発段階で傾向を把握し、将来のパフォーマンス問題を回避することができます。

WebCenter Portalのホームページには、いくつかの主要なパフォーマンス・メトリックが表示されます(図22-29)。

図22-29 WebCenter Portalのホームページ

ページ上部のチャートにより、WebCenter Portalアプリケーションが予期したとおりに稼働しているか、実行速度が遅いかが一目でわかります。より詳細なメトリックにドリルダウンして問題領域のトラブルシューティングを行い、適切な処理を行うことができます。着目する項目の詳細は、「主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断」を参照してください。

この項では、WebCenter Portalメトリック・ページの移動方法について説明します。この項の内容は次のとおりです。

- WebCenter Portalの最近のパフォーマンス・メトリックのモニタリング

- ポータル・メトリックのモニタリング

- WebCenter Portalのサービス・メトリックのモニタリング

- WebCenter Portalのページ・メトリックのモニタリング

- メトリック・パレットを通じたすべてのメトリックのモニタリング

22.2.1 WebCenter Portalの最近のパフォーマンス・メトリックのモニタリング

WebCenter Portalまたは特定のポータルが現在適切に稼働していることを確認する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. ホームページで、WebCenter Portalが予期したとおりに稼働しているかどうかを確認します。

着目する項目の詳細は、「主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断」を参照してください。

3. 「ページ・パフォーマンス」、「ポートレット可用性」、「ヘルス」など、ホームページ上のリンクをクリックして、より詳細なメトリックにドリルダウンします。

または、次のメニュー・オプションを使用して詳細な最近のメトリックにアクセスします。

- 「WebCenterポータル」→「モニタリング」→「最近のページ・メトリック」

- 「WebCenterポータル」→「モニタリング」→「最近のポートレット・メトリック」

- 「WebCenterポータル」→「モニタリング」→「最近のWebLogic Serverメトリック」

これらのページのメトリックの詳細は、「ページ・リクエスト・メトリックの理解」、「ポートレット・プロデューサのメトリックの理解」および「WebLogic Serverメトリックの理解」を参照してください。

22.2.2 ポータル・メトリックのモニタリング

WebCenter Portal内で作成されたポータルのパフォーマンス・メトリックを参照する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「モニタリング」→「全ポータル・メトリック」を選択します。

表示されるメトリックの詳細は、「ポータル・メトリックの理解」を参照してください。「共通のパフォーマンスの問題およびアクションの理解」を参照してください。

3. 特定のポータルの詳細なページ・メトリックにドリルダウンするか、特定のポータルのセットを比較します。

- 特定のポータル(以前はスペースと呼ばれていました)の詳細なパフォーマンス情報を表示する手順は次のとおりです。
「ポータル名フィルタ」フィールドで、ポータルの名前を入力し、[Enter]を押します。ポータル・フィルタリング・オプションの詳細は、「ポータル・メトリックの理解」を参照してください。

または

「名前」列で、パフォーマンス・メトリックを表示するポータルの名前(リンク)をクリックします。

どちらの場合も、選択したポータルのページ・メトリックが表示されます。

- 1つ以上のポータルのパフォーマンスを比較するには、表の1つ以上の行を選択し、「チャートで表示」をクリックします。

22.2.3 WebCenter Portalのページ・メトリックのモニタリング

ページ・メトリックを参照する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. ホームページのページ可用性/パフォーマンスのチャートで、ページ・リクエストが予期したとおりに現在応答しているかどうかを確認します。

より詳細な情報にドリルダウンするには、「ページ可用性」、「ページ・パフォーマンス」をクリックするか、「モニタリング」→「最近のページ・メトリック」を選択します。表示されるメトリックの詳細は、「最近のページ・メトリック」を参照してください。

3. 起動時以降のページ・パフォーマンスをモニターするには、「モニタリング」→「全ページ・メトリック」を選択します。

特定のページ、すべてのページまたは特定のページ・セットのメトリックを表示できます。表示されるメトリックおよびページ・フィルタリング・オプションの詳細は、「全ページ・メトリック」を参照してください。

4. ページ編集操作のパフォーマンスをモニターするには、「モニタリング」→「全サービス・メトリック」を選択し、表内の「ページ」をクリックします。

表示されるメトリックの詳細は、「ページ操作のメトリック」を参照してください。

22.2.4 WebCenter Portalのサービス・メトリックのモニタリング

WebCenter Portalアプリケーションのサービスのメトリックを参照する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「モニタリング」→「全サービス・メトリック」を選択します。

「WebCenterポータル・サービス・メトリック」ページの一番上にある「サービス・サマリー」を使用すると、どのサービスが稼働中かがすぐにわかり、WebCenter Portalにより使用されているこれらのサービスの個別的および相対的なパフォーマンスを確認できます。

メトリックは、ツール、サービス、アプリケーションまたはポートレットが初めてアクセスされたときに使用可能になります。構成されていないサービスや、一度も使用されていないサービスは、「サマリー」表に表示されません。

3. サービスの名前をクリックして、より詳細なメトリックにドリルダウンします。

個々のメトリックの詳細は、「特定のツールまたはサービス固有のメトリック」を参照してください。「ツールとサービスに関する一般的な問題のトラブルシューティング」も参照してください。

22.2.5 メトリック・パレットを通じたすべてのメトリックのモニタリング

WebCenter Portalに関して収集されたパフォーマンス・メトリックを参照し、チャート化する手順は次のとおりです。

1. Fusion Middleware Controlコンソールで、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「モニタリング」→「パフォーマンス・サマリー」を選択します。

「パフォーマンス・サマリー」ページの上部にある「メトリック・パレットの表示」ボタンを使用して、「メトリック・パレット」を表示します。このパレットでは、個々のメトリックを選択およびモニターできます。

3. 「メトリック・パレット」で、「WebCenter Portal」の下のフォルダを開き、メトリックのチェック・ボックスを選択して、グラフ形式または表形式でメトリックをモニターします。

図22-30に、「パフォーマンス・サマリー」ページとメトリック・パレットを示します。「メトリック・パレット」には、WebCenter Portalのパフォーマンス・メトリックに加えて、任意のJ2EEアプリケーションに関連付けられている一般的なパフォーマンス・メトリック(ADFアプリケーション・モジュール・プールのメトリックなど)も表示されます。

メトリックのオンライン・ヘルプを表示するには、目的のディレクトリ、またはディレクトリ内のメトリックを右クリックし、「ヘルプ」を選択します。

図22-30 WebCenter Portal: パフォーマンス・サマリーおよびメトリック・パレット

22.3 主要なパフォーマンス・メトリックのしきい値および収集のカスタマイズ

この項には次のトピックが含まれます:

- 主要なパフォーマンス・メトリックのカスタマイズ・オプションの理解

- デフォルトのメトリック収集およびしきい値設定の理解

- 主要なメトリックのしきい値の構成

- WebLogic Serverヘルス・チェックの頻度の構成

- 主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成

- WebCenter Portalのしきい値および収集オプションの編集

22.3.1 主要なパフォーマンス・メトリックのカスタマイズ・オプションの理解

Oracle WebCenter Portalが主要なパフォーマンス・メトリックを収集およびレポートする方法は、各自のインストールに合うように、様々な方法で微調整できます。

- 主要なパフォーマンス・メトリックの警告しきい値のカスタマイズ
たとえば、インストール内で、ページ・レスポンス時間が15秒を超える場合は警告メッセージをトリガーし、DMSで範囲外の状態をレポートすることを指定できます。範囲外の状態はパフォーマンス・チャート内でも赤色で表示され、問題があることが通知されます。

詳細は、「主要なメトリックのしきい値の構成」を参照してください。

- 主要なパフォーマンス・メトリック用に収集するサンプル数のカスタマイズ
デフォルトのサンプル・サイズ(100)が自分のインストールにとって多すぎたり少なすぎたりする場合は、より適切な値を構成できます。

詳細は、「主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成」を参照してください。

- ヘルス・チェックの頻度のカスタマイズ
より積極的なスケジュールがインストールで要求される場合は、システム・ヘルスをより頻繁にチェックできます。デフォルトのヘルス・チェック頻度は5分です。

詳細は、「WebLogic Serverヘルス・チェックの頻度の構成」を参照してください。

「WebCenter Portalのしきい値および収集オプションの編集」も参照してください。

22.3.2 デフォルトのメトリック収集およびしきい値設定の理解

WebCenter Portalのメトリック収集オプションおよびメトリックしきい値設定は、metric_properties.xmlファイルで構成できます。デフォルト設定は、例22-1の中で太字で示されています。

注意:

すべての時間しきい値は、ミリ秒単位で指定されます。メモリー・サイズはバイト単位で指定され、CPU使用率はパーセンテージで指定されます。

例22-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>

このファイル内のすべての設定の詳細は、次の表を参照してください。

- 表22-35

- 表22-36

デフォルト設定を変更する方法の詳細は、「主要なパフォーマンス・メトリックのしきい値および収集のカスタマイズ」を参照してください。

22.3.3 主要なメトリックのしきい値の構成

いくつかの主要なパフォーマンス・メトリックのデフォルトの警告しきい値は、各自のOracle WebCenter Portalインストールに合うようにカスタマイズできます。表22-34は、構成できる主要なパフォーマンス・メトリックとそのデフォルトのしきい値(ある場合)を示しています。

初期状態では、しきい値は、ページ・レスポンス(10秒を超える)、ポートレット・レスポンス(10秒を超える)およびCPU使用率(80%を超える)についてのみ事前に構成されています。

注意:

値undefは、しきい値が定義されていないことを意味します。

表22-34にリストされているメトリックはすべて、そのしきい値を変更できます。たとえば、デフォルトでは、表示にかかる時間が10秒を超えるページは警告メッセージをトリガーし、DMSで範囲外の状態をレポートし、パフォーマンス・チャートで赤色を表示して、ページ・レスポンスが非常に低速であることを即時に通知します。ポータル・アプリケーションによっては、許容できるレスポンス時間が5秒の場合もあります。この場合はしきい値を5,000 (ミリ秒)に変更して、実際に問題がある場合にパフォーマンス・チャートで赤色のみ表示するようにできます。

表22-34 構成可能なメトリックしきい値

メトリック名

説明

デフォルトのしきい値

コンパレータ

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>

表22-34に、各パラメータの説明を示します。

表22-35 主要なパフォーマンス・メトリックのしきい値の構成

<Metric>パラメータ

構成可能

説明

name

いいえ

メトリックの名前。

メトリック名は、表22-34にリストされている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つ以上のメトリックしきい値を編集するには、「WebCenter Portalのしきい値および収集オプションの編集」の手順に従います。

22.3.4 WebLogic Serverヘルス・チェックの頻度の構成

初期状態では、WebCenter PortalがデプロイされるWebLogic Serverの一般的なヘルスは5分ごとにチェックされ、その結果は「WebLogic Serverメトリックの理解」のページでレポートされます。

より積極的なスケジュールがインストールで要求される場合は、システム・ヘルスをより頻繁にチェックできます。

ヘルス・チェックの頻度は、metrics_properties.xml内で次の形式を使用して構成されます。

<thread_config>
<thread component_type="oracle_webcenter" interval="<value>"/>
</thread_config>

表22-36に、各パラメータの説明を示します。

表22-36 ヘルス・チェックの頻度の構成

<thread>パラメータ

デフォルト値

構成可能

説明

component_type

oracle_webcenter

いいえ

Oracle WebCenter Portalの場合、component_typeは常にoracle_webcenterです。

interval

5分間

はい

ヘルス・チェックの間隔(分単位)を指定します。

例:

<thread component_type="oracle_webcenter" interval="10"/>

頻度を変更するには、「WebCenter Portalのしきい値および収集オプションの編集」の手順に従います。

22.3.5 主要なパフォーマンス・メトリックの計算で使用されるサンプル数の構成

Oracle WebCenter Portalでは、一定の数のデータ・サンプルに基づいて、いくつかの主要なパフォーマンス・メトリック(ページ、ポートレットおよびWebLogic Server)の最近のパフォーマンスが収集され、レポートされます。初期状態では、各メトリック・タイプの最新の100サンプルを使用して(100サンプルのページ・メトリック、100サンプルのポートレット・メトリックなど)、これらの主要なパフォーマンス・メトリックが計算されます。

サンプル・セットは、インストールに合わせて増減できます。主要なパフォーマンス・メトリックのすべてのサンプルはメモリーに保持されるため、サンプル数を増やす場合は、メモリーの消費が増えることを考慮する必要があります。最大でも数百のサンプルにとどめることをお薦めします。「Oracle WebCenter Portalのメトリック収集の理解」を参照してください。

注意:

範囲外のすべてのメトリックは管理対象サーバーの診断ログに記録されるため、後でログをスキャンして、過去に起きたことをいつでも確認できます。つまり、メモリーに一時的に格納されるN回分のメトリック・サンプルを超える分を確認できます。

サーバーの起動プロパティWC_HEALTH_MAX_COLLECTIONSにより、Oracle WebCenter Portalによって収集されるメトリック・サンプルの数が決まります。プロパティが指定されない場合は、100サンプルが収集されます。

主要なパフォーマンス・メトリックに関して収集するサンプル数をカスタマイズする手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。

2. WebCenter Portalがデプロイされている管理対象サーバーに移動します: 「環境」→「サーバー」→WC_Portal。

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. 管理対象サーバーを再起動します。

22.3.6 WebCenter Portalのしきい値および収集オプションの編集

WebCenter Portalのメトリックのしきい値および収集基準を変更する手順は次のとおりです。

1. 例22-1のXMLスニペットをコピーし、metric_properties.xmlという名前のテキスト・ファイルに保存します。

2. 必要に応じて、metric_properties.xml内のメトリック収集パラメータおよびメトリックしきい値を編集します。

注意:

Oracle WebCenter Portalインストールに適したしきい値を選択する際は、マシン・リソースと、システムのトポロジおよび構成を考慮する必要があります。インストールはそれぞれ異なるため、大部分のメトリックにはデフォルトまたは推奨されるしきい値設定はありません。

次の各表では、すべての設定およびそのデフォルト(ある場合)について説明します。

- 表22-35

- 表22-36

3. 更新したmetric_properties.xmlファイルを次の場所にコピーします。

- DOMAIN_HOME。

- 別の適切なディレクトリ。

4. プロパティ・ファイルのフル・パスを指すように、サーバーの起動引数WEBCENTER_METRIC_PROPERTIESを構成します。

a. WebLogic Server管理コンソールにログインします。

b. アプリケーションがデプロイされている管理対象サーバーに移動します。
WebCenter Portalの場合は、「環境」→「サーバー」→WC_Portalに移動します。

c. 「サーバーの起動」タブをクリックします。

d. 「引数」テキスト領域に、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

e. 管理対象サーバーを再起動します。

22.4 Oracle WebCenter Portalに関するパフォーマンス問題の診断および解決

この章で説明するパフォーマンス・メトリックを使用すると、WebCenter Portalの現在のステータスとパフォーマンスを、Fusion Middleware Controlからすばやく評価できます。パフォーマンスが低速な場合は、問題を完全に診断および修正するために、さらに調査する必要がある可能性があります。詳細は、「主要なパフォーマンス・メトリック・データによるシステム・ヘルスの分析および診断」を参照してください。

この章では、一般的なパフォーマンスの問題およびアクションについて説明しています。

- 共通のパフォーマンスの問題およびアクションの理解

- ツールとサービスに関する一般的な問題のトラブルシューティング

パフォーマンスに関連するトラブルシューティングの詳細は、「Oracle WebCenter Portalのトラブルシューティング」を参照してください。

22.5 Oracle WebCenter Portalのパフォーマンスのチューニング

WebCenter Portalのチューニングの詳細は、『パフォーマンスのチューニング』のOracle WebCenter Portalのパフォーマンス・チューニングに関する項を参照してください。システム制限(open-files-limit)、JDBCデータ・ソース、JVM引数、セッション・タイムアウト、ページ・タイムアウト、接続タイムアウト、同時タイムアウト、キャッシュなどのチューニング方法を確認できます。

22.6 データ・キャッシング・パフォーマンスの向上

パフォーマンスおよびスケーラビリティを強化するために、WebCenter Portalではデータ・キャッシング・ソリューションにCoherenceをデフォルトで使用します。ただし、WebCenter Portalに含まれるOracle Coherenceライセンスは制限されています。つまり、デフォルトでは、分散データ・キャッシングを持たないローカル・キャッシング・スキームがサポートされています。高可用性(HA)環境デプロイメントでは、キャッシュされたエントリがJVM/マシン間で共有されません。

ただし、CoherenceまたはWebLogicのライセンスを持っている場合は、分散モードを使用すると、クラスタ環境でパフォーマンスが向上します。この項では、分散キャッシュの設定方法、およびWebCenter Portalのデフォルトのキャッシュ構成をオーバーライドしてパフォーマンスを向上する方法について説明します(適切なライセンスを所有している場合)。

この項では、次の項目について説明します。

- Coherenceキャッシュ・タイプのサマリー

- WebCenter PortalのデフォルトのCoherenceキャッシュ

- デフォルト構成のオーバーライド

注意:

Coherenceの構成の詳細は、『Oracle WebLogic Serverクラスタの管理』のCoherenceクラスタの構成および管理に関する項を参照してください。

22.6.1 Coherenceキャッシュ・タイプのサマリー

Coherenceが提供するキャッシュ・モードの基本的なタイプを表22-37に示します。

表22-37 基本的なキャッシュ・タイプ

キャッシュ名

説明

分散

データはクラスタ内のすべてのマシン間でパーティション化されます。フォルト・トレランスを実現するため、パーティション・キャッシュでは、各データをクラスタ内の1つ以上の個別マシンに保持するように構成できます。分散キャッシュはCoherenceで最もよく使用されるキャッシュです。

レプリケート

データは、クラスタ内のすべてのメンバーに完全にレプリケートされます。このキャッシュは、読取りにおいては、線形のスケーラビリティを示す最速のパフォーマンスを示しますが、書込みのスケーラビリティは優れていません(クラスタ内のすべてのメンバーによる書込み処理が必要なため)。データがすべてのマシンにレプリケートされるので、サーバーを追加しても、キャッシュの合計容量は増加しません。

オプティミスティック

レプリケート・キャッシュに似ていますが、同時実効性の制御は行われません。この実装では、レプリケート・キャッシュより、書込みのスループットが高くなります。また、MRU/MFUベースのキャッシュなどのキャッシュ・データの格納に、代替の基礎となるストアを使用できます。ただし、2つのクラスタ・メンバーが基礎となるローカル・ストアの削除やパージを個別に実行すると、それぞれに保持しているストア・コンテンツがクラスタ・メンバー間で異なる可能性があります。

ニア

ニア・キャッシュはハイブリッドなキャッシュであり、一般に分散キャッシュまたはリモート・キャッシュとローカル・キャッシュを組み合せた役割を果たします。パーティション・キャッシュによってバッキングされたニア・キャッシュでは、反復的なデータ・アクセスにおいて0ミリ秒のローカル・アクセスが可能になります。同時実行性が可能になり、整合性およびフェイルオーバーが保証されるだけでなく、レプリケーション・キャッシュとパーティション・キャッシュの長所が効率的に結合されます。

ローカル

ローカル・キャッシュは、特定のクラスタ・ノードに対してローカルである(つまりノード内に完全に含まれる)キャッシュです。クラスタ・サービスではありませんが、Coherenceローカル・キャッシュ実装は、各種クラスタ・キャッシュ・サービスと組み合せて使用されることがよくあります。

Coherenceにより提供されるキャッシュのタイプの詳細は、『Oracle Coherenceでのアプリケーションの開発』のCoherenceキャッシュの概要に関する項を参照してください。

22.6.2 WebCenter PortalのデフォルトのCoherenceキャッシュ

WebCenter Portalのユーザー構成可能なデフォルトのCoherenceキャッシュを表22-38に示します。

表22-38 WebCenter PortalのデフォルトのCoherenceキャッシュ

キャッシュ名

用途

デフォルトのCoherence構成

oracle.webcenter.spaces.model.ApplicationSpaceObjects

アプリケーション・スペースのキャッシュ

WebCenter_12HourCache

oracle.webcenter.spaces.model.SpaceProperties

スペース・プロパティのキャッシュ

WebCenter_12HourCache

oracle.webcenter.genericsiteresources

汎用サイト・リソースのキャッシュ

WebCenter_12HourCache

oracle.webcenter.profile

ユーザーのプロファイルのキャッシュ

WebCenter_60MinuteCache

oracle.webcenter.doclib.provisioned

ドキュメント・ライブラリのキャッシュ(プロビジョニング済および構成済)

WebCenter_12HourCache

oracle.webcenter.page

ページ定義のキャッシュ

WebCenter_12HourCache

表22-38に示すデフォルトのCoherence構成のプロパティは次のようになります。

デフォルトの構成

削除ポリシー

高ユニット

有効期限の遅延

WebCenter_12HourCache

ハイブリッド

1000

12時間

WebCenter_60MinuteCache

ハイブリッド

1000

1時間

ここで:

- 高ユニットは、プルーニングが開始されるまでキャッシュに配置できる単位の最大数を表します

- ハイブリッド削除ポリシーでは、エントリに対するアクセス頻度と最後にアクセスされた時間の組合せに基づいて(加重スコア)、削除対象エントリが選択されます。アクセス頻度が最も低いエントリおよびアクセスされていない期間が最も長いエントリが最初に削除されます。

- 有効期限の遅延では、前回の更新からエントリが期限切れとマークされるまでの、キャッシュでエントリが保持される期間を指定します。期限切れのエントリを読み取るには、構成済のキャッシュ・ストアからエントリをリロードすることになります。期限切れになった値は、キャッシュから定期的に破棄されます。

Coherenceは、スタンドアロン・アプリケーションとともに、アプリケーション・サーバー・ライブラリとして、またはEARやWARファイル内あるいはWebLogic Serverコンテキスト内のJava EEモジュールの一部として、デプロイできます。

22.6.3 デフォルト構成のオーバーライド

デフォルトでは、WebCenter Portalはローカル・データ・キャッシング・モードを使用します。分散モードを使用してクラスタ環境でのパフォーマンスを向上するために、デフォルト構成をオーバーライドできます。

デフォルト構成をオーバーライドする手順は次のとおりです。

1. WebLogicクラスタ(高可用性構成で必要な場合)およびCoherenceクラスタを構成します。

詳細は、『Oracle WebLogic Serverクラスタの管理』のCoherenceクラスタの構成と管理に関する項を参照してください。

2. デフォルト構成をオーバーライドするためのキャッシュ構成ファイルを定義します。

詳細は、『Oracle Coherenceでのアプリケーションの開発』のキャッシュ構成に関する項および例示キャッシュ構成に関する項を参照してください。

注意:

実行時にキャッシュ構成ファイルをオーバーライドするには、キャッシュ構成ファイルがJNDI名にバインドされている必要があります。WebCenter PortalでGARファイルのoverride-propertyを使用されるために定義されているJNDI名は、ExamplesGarです。オーバーライドする場合は、必ず同じ名前を使用してください。

デフォルトでは、ローカル・キャッシングが使用されます。表22-38で示されている、キャッシュ構成ファイルの使用可能なキャッシュの正確な名前を使用してください。

たとえば、ピープル・プロファイル・キャッシュは名前oracle.webcenter.profileで一意に識別され、デフォルトでローカル・スキームWebCenter_60MinuteCacheにマッピングされます。ユーザー・プロファイル・オブジェクトの再作成は高負荷であるため、ポータルで作業するユーザーの数が多い場合は、ユーザーのプロファイルをキャッシュすることが適切であることがあります。キャッシュのサイズを増やすことで、ユーザー・プロファイル・オブジェクトをキャッシュに保持し、アクティビティ・ストリームでのパフォーマンスを向上できます。

分散スキームを使用するためにこのキャッシュをオーバーライドする場合は、キャッシュ名を正確に指定する必要があります。

<cache-mapping>
<cache-name>oracle.webcenter.profile</cache-name>
<scheme-name>my_distributed_scheme</scheme-name>
</cache-mapping>

ここで、my_distributed_schemeは、新しく定義された分散キャッシュ・スキームを示します。

3. 構成ファイルを定義した後、クラスタでWLSTを使用してデフォルトのキャッシュ構成ファイルをオーバーライドします。

詳細は、『Oracle WebLogic Serverクラスタの管理』のキャッシュ構成ファイルのオーバーライドに関する項を参照してください。

また、WebLogic Server管理コンソールでデフォルトのキャッシュ構成をオーバーライドすることもできます。詳細は、WebLogic Server管理コンソール・オンライン・ヘルプのクラスタ・キャッシュ構成の作成に関する項を参照してください。

すべての構成の変更は、デフォルトで管理サーバーで保持され、WebCenter Portalのアップグレード後も維持されます。

[1]
最近のパフォーマンス・メトリックの計算には、直近の10分から15分間のデータが使用されます。詳細は、「Oracle WebCenter Portalのメトリック収集の理解」を参照してください。

23 Oracle WebCenter Portalログの管理

この章では、WebCenter Portalで診断ロギングおよびエラー・メッセージを構成する方法について説明します。

この章の内容は次のとおりです。

- 診断ロギングの概要

- ログ情報の表示および構成

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdmin、OperatorまたはMonitorロールが付与されている必要があります。

「管理操作、ロールおよびツールの理解」も参照してください。

23.1 診断ロギングの概要

起動と停止に関連するすべての診断情報、エラー、警告メッセージ、HTTPリクエストに関するアクセス情報、その他の情報がログ・ファイルに保存されます。

Fusion Middleware ControlとWLSTを使用したログの管理および分析の概要は、『Oracle Fusion Middlewareの管理』のログ・ファイルと診断データの管理に関する項を参照してください。

『Oracle Fusion Middlewareの管理』の診断フレームワークの理解に関する項も参照してください。

この項には次のトピックが含まれます:

- WebCenter Portal診断ログ

- Oracle WebCenter PortalのメッセージID

- Oracle WebCenter Portalパフォーマンス・メトリックの範囲外状態

- ロガー

23.1.1 WebCenter Portal診断ログ

WebCenter Portalの診断ログ・ファイルはWC_Portal-diagnostic.logです。

このログは、DOMAIN_HOME/servers/WC_Portal/logsディレクトリで参照可能です。

23.1.2 Oracle WebCenter PortalのメッセージID

Oracle WebCenter Portalのログ・メッセージは、次のカテゴリに分類されます。

表23-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-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

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

23.1.3 Oracle WebCenter Portalパフォーマンス・メトリックの範囲外状態

範囲外の状態は管理対象サーバーの診断ログにも記録されるので、いつでも履歴イベントを調べることができます。パフォーマンス関連のメッセージは、メッセージID接頭辞WCS-692<nn>を使用して記録され、メトリック名、値、および範囲外であるメトリックを記述するメッセージが含まれます。

WebCenter Portalの診断ログに記録されるメッセージの例を次に示します。

[WC_Portal] [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_Portal] [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_Portal] [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_Portal] [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 myPortlets is out-of-bounds

23.1.4 ロガー

23.2 ログ情報の表示および構成

この項には次のトピックが含まれます:

- WebCenter Portalログの表示および構成

- WebCenter Portalのエラー・メッセージの表示および構成

23.2.1 WebCenter Portalログの表示および構成

WebCenter Portalアプリケーションのログ・メッセージを表示する手順は次のとおりです。

1. Fusion Middleware Controlで、WebCenter Portalのホームページに移動します。
「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「ログ」→「ログ・メッセージの表示」を選択します。

3. 「ログ・メッセージ」ページで、警告、エラー、通知などを検索します。

WebCenter Portalのログ・ファイルを構成するには:

1. Fusion Middleware Controlで、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「ログ」→「ログ構成」を選択します。

3. 「ログ構成」ページの「ログ・ファイル」タブで、ログ設定を構成します。

詳細は、『Oracle Fusion Middlewareの管理』のログ・ファイルの表示と検索に関する項を参照してください。

23.2.2 WebCenter Portalのエラー・メッセージの表示および構成

開発者によるWebCenter Portalアセットのデバッグを支援するために、管理者は、コール・スタックが含まれるエラー・メッセージを有効化して、WebCenter Portalエラー・ページに表示されるようにすることができます。

注意:

セキュリティ上の理由から、エラー・メッセージは本番環境では有効化しないでください。エラー・メッセージは開発環境およびステージング環境に制限することをお薦めします。

エラー・メッセージを有効にする手順は次のとおりです。

1. WLSTを使用してWebCenterドメインの管理サーバーに接続します。
WLSTコマンドを実行して管理サーバーに接続する方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

2. ローカル・ファイル・システムに新しいフォルダ(/tmp/WCconfig)を作成します。

3. 次を実行して、webcenter-config.xml構成ファイルを、作成した/tmp/WCconfigフォルダにエクスポートします。

exportMetadata(application='webcenter', server='WC_Portal', toLocation='/tmp/WCconfig', docs='/oracle/webcenter/webcenterapp/metadata/webcenter-config.xml')

4. webcenter-config.xmlファイル(/tmp/WCconfig/oracle/webcenter/webcenterapp/metadataフォルダ内)を開き、showError-enableプロパティをtrueに変更して、エラー・メッセージを有効化します。

<webcenter:showError-enabled>true</webcenter:showError-enabled>

または、falseに設定して無効化します。

<webcenter:showError-enabled>false</webcenter:showError-enabled>

5. ファイルを保存し、次のWLSTコマンドを使用して、管理サーバーに再度インポートします。

importMetadata(application='webcenter', server='WC_Portal',fromLocation='/tmp/WCconfig', docs='/oracle/webcenter/webcenterapp/metadata/webcenter-config.xml')

この変更を有効にするために管理サーバーを再起動する必要はないことに注意してください。

24 Oracle WebCenter Portal監査ログの管理

この章では、WebCenter Portal監査ログの管理の概要について説明します。

この章の内容は次のとおりです。

- 監査ログの管理の概要

- 監査ログの構成

- WebCenter Portal監査イベントの表示

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。

「管理操作、ロールおよびツールの理解」も参照してください。

24.1 監査ログの管理の概要

監査ログを有効にすると、Fusion Middleware監査サービスの一環として、ポータル関連のイベントが追跡されます。デフォルトでは、監査ログ・イベントはファイル(監査バスストップ)に格納されますが、データベースにアップロードして永続化することもできます(詳細は、「監査ストア・データベースの構成」を参照)。監査バスストップ・ファイルの容量にはかぎりがあるため、ログ情報をデータベースに格納することをお薦めします。そうすることで、イベントの発生から長時間経過した後でも、そのイベントを問い合せできるようになります。

注意:

WebCenter Portal偽装を有効にする場合は、監査ログも有効にすることを強くお薦めします。偽装を有効にすると、監査ログによって、偽装者、被偽装者およびイベントのコンテキストが追跡されます。

監査ログの主な利点は次のとおりです。

- ポータル、ポータル・サーバーおよびポータル・サーバーの主要アーティファクトのセキュリティ設定を変更するイベントを追跡できます

- ロギング・レベルを定義できます

- ログに記録されたイベントをデータベースにアップロードすると、それらは永続的に参照可能になります。

- 監査サービスを通じて、監査イベントに関するレポートを参照できます。

監査サービスとその構成の詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のOracle Fusion Middleware監査フレームワークの概要に関する項を参照してください。監査サービスを構成してデータベースを使用する方法の詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の監査の構成および管理に関する項を参照してください。

24.2 監査ログの構成

この項では、WebCenter Portalのログを有効および無効にする方法、ログ・レベルを設定する方法および監査ストア・データベースを設定する方法について説明します。

この項には、次の項目が含まれます。

- ロギング・レベルの設定

- 監査ストア・データベースの構成

24.2.1 ロギング・レベルの設定

デフォルトでは、WebCenter Portalの監査ログは無効になっています(つまりNoneに設定されています)。これを有効にするには、次の例のように、ロギング・レベルをNone以外の値(Lowなど)に設定します。各ロギング・レベルに含まれるロギング・カテゴリの詳細は、「WebCenter Portal監査ログの使用」を参照してください。

WebCenter Portal監査イベントの監査ロギング・レベルを変更するには、次のWLSTコマンドを使用します。

ロギング・レベルをLowに設定する場合:

setAuditPolicy(componentType="webcenter",filterPreset="Low")

次のようにロギング・レベルをMediumに設定します。

setAuditPolicy(componentType="webcenter",filterPreset="Medium")

WebCenter Portalのログを無効にする場合:

setAuditPolicy(componentType="webcenter",filterPreset="None")

正常に実行された場合、エラーはスローされず、警告なしで完了します。WC_Portalサーバーを再起動して、ロギング・レベルの変更を完了します。

監査ロギングの管理および構成に使用できるその他のWLSTコマンドの詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の監査のためのWLSTコマンドに関する項を参照してください。

24.2.2 監査ストア・データベースの構成

監査ストアは、リポジトリ作成ユーティリティ(RCU)によって作成される、事前定義済のOracle Fusion Middleware監査フレームワーク・スキーマを含むデータベースです。デフォルトでは、監査ログは次の例のように、auditlogsディレクトリ内のファイルとして格納されます。

DOMAIN_HOME/servers/WC_Portal/logs/auditlogs/webcenter#11.1.1.4.0/audit_1_0.log

データベース永続性が構成されると、監査ローダーはこのファイルからデータを取得し、それを監査フレームワーク・スキーマ内に配置します。監査サービスを構成してデータベースを使用する方法の詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の監査の構成および管理に関する項を参照してください。

監査スキーマの名前を確認する必要があります(接尾辞は常にIAUです)。また、次のように監査リポジトリをデータベースに設定する必要があります。

setAuditRepository(switchToDB='true',dataSourceName='jdbc/AuditDB',interval='15')

注意:

ストア内の監査データは累積されることが予想され、時間の経過に伴って増加します。データベースは、他のアプリケーションによって使用される運用データベースではなく、監査専用のスタンドアロンRDBMSであるのが理想的です。

24.3 WebCenter Portal監査イベントの表示

この項では、監査ログに記録されるWebCenter Portal監査イベントについて説明し、監査スキーマへの偽装イベントの問合せに使用できる単純なSQL文を紹介します。

この項では、次の内容について説明します。

- WebCenter Portal監査ログの使用

- 監査スキーマへの問合せ

24.3.1 WebCenter Portal監査ログの使用

表24-1は、設定したログ・レベルに応じて監査ログに記録されるWebCenter Portal監査イベントを示しています。各WebCenter Portalツール(ドキュメント、お知らせ、ディスカッション、Wikiとブログ、フォーラム、フォーラム・メッセージ、フォーラム・トピック、フォーラム・カテゴリなど)は、ログ内の対応するToolArtifactIDとToolTypeによって識別されます。

ログ・レベルをLowに設定した場合、次のカテゴリのイベントがログに記録されます。

- PortalLifeCycle

- PortalRoleManagement

- PortalRoleMemberManagement

- PortalToolAccessManagement

- ImpersonationSessionMgmt

ログ・レベルをMediumに設定した場合、さらに次のカテゴリのイベントがログに記録されます。

- PortalToolsManagement

- PortalPagesManagement

表24-1 WebCenter Portal監査イベント

Event Category

Event Name

Event Payload

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

GrantImpersonationAccessRevokeImpersonationAccessBeginImpersonationEndImpersonation

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

24.3.2 監査スキーマへの問合せ

監査スキーマを構成し、監査リポジトリをデータベースに設定したら、この生成された監査データに基づいてレポートを生成できます。レポートを作成するには、次の手順を実行します。

1. 次のコマンドを実行してSQLファイルを生成することによって、監査表に基づくビューを生成します。その後、このファイルを使用して、WebCenter Portalコンポーネント固有のデータに関するビューを、監査DB表から作成できます。

createAuditDBView(fileName="/tmp/WCPortalAuditView.sql", componentType="webcenter")

IAUスキーマの所有者(TEST_IAUなど)は、ビューの作成権限を持っている必要があります。ビューを作成するには、システムDBAとして、WCPortalAuditView.sqlファイルを実行するか、次のSQLコマンドを実行します。

grant create view to TEST_IAU

作成されるビューの名前は、webcenter_AUDITVIEWのようになります。

2. ビューを使用して、監査データベースへの問合せを実行します。次の例のように、WebCenter Portalツールの監査属性名を、表の列名として使用します。WCPortalAuditView.sqlファイルを開くと、表の列名とWebCenter Portal属性のマッピングを確認できます。

- 次のSQL文は、イベント・タイプBeginImpersonationおよびEndImpersonationとしてログに記録された、WebCenter Portalツールのすべての属性を返します。

select * from webcenter_AUDITVIEW where EventType like '%Impersonation';

- 次のSQL文は、いずれかのポータルを削除したすべてのユーザーと、削除されたポータルの情報をリストします。

select InitiatorUID,InitiatorMail,PortalID,PortalName,PortalURL from webcenter_AUDITVIEW where EventType = 'DeletePortal';

- 次のSQL文は、WebCenter Portalのすべての監査データを返します。

select * from webcenter_AUDITVIEW;

WebCenter Portalのアクティビティを定期的にモニターする場合は、SQL問合せを使用するSQLデータ・ソースを作成し、そのデータ・ソースを、表やその他の視覚化としてポータル・ページ上にドロップできます。SQLデータ・ソースの詳細は、『Oracle WebCenter Portalでのポータルの構築』のデータ・ソースでの作業に関する項を参照してください。

第V部 セキュリティの管理

『Oracle WebCenter Portalの管理』のこの部では、Oracle WebCenter Portalのセキュリティ管理のトピックに関する情報を示します。

- Oracle WebCenter Portalセキュリティの管理

- アイデンティティ・ストアの構成

- ポリシーおよび資格証明ストアの構成

- シングル・サインオンの構成

- SSLの構成

- Webサービス・セキュリティの構成

- ポートレット・プロデューサのセキュリティの構成

- 偽装の管理

25 Oracle WebCenter Portalセキュリティの管理

この章では、WebCenter Portalの保護の概要を説明し、さらにその初期デプロイ時に設定されているセキュリティ構成について説明します。

この章の内容は次のとおりです。

- アプリケーション・セキュリティの概要

- デフォルトのセキュリティ構成

WebCenter Portalのセキュリティ構成の特定の局面の詳細は、次を参照してください。

- アイデンティティ・ストアの構成

- ポリシーおよび資格証明ストアの構成

- シングル・サインオンの構成

- SSLの構成

- Webサービス・セキュリティの構成

- ポートレット・プロデューサのセキュリティの構成

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。

「管理操作、ロールおよびツールの理解」も参照してください。

25.1 アプリケーション・セキュリティの概要

WebCenter Portalの推奨セキュリティ・モデルは、Java Authentication and Authorization Service (JAAS)モデルを実装するOracle ADFセキュリティに基づいています。Oracle ADFセキュリティの詳細は、『Oracle Application Development FrameworkによるFusion Webアプリケーションの開発』を参照してください。

図25-1は、WebCenter Portalアプリケーション・デプロイメントとそのサービス、サーバー、ポートレット、ポートレット・プロデューサ、アイデンティティ・ストア、資格証明ストア、ポリシー・ストア、およびOracle Enterprise Managerの関係を示しています。

図25-1 WebCenter Portalアプリケーションの基本的なアーキテクチャ

図25-2は、バックエンド・サーバーが接続された、デプロイ後の基本的なWebCenter Portalアプリケーションを示しています。

図25-2 バックエンド・サーバーが接続されたWebCenter Portalアプリケーションのアーキテクチャ

図25-3は、WebCenter Portalアプリケーションのセキュリティ・レイヤーを示しています。

図25-3 WebCenter Portalのセキュリティ・レイヤー

WebCenter Portalアプリケーションは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

OPSS (Oracle Platform Security Services)

OPSSでは、次のものがサポートされています。

- Anonymous-role

- Authenticated-role

- アイデンティティ・ストア、ポリシー・ストアおよび資格証明ストア

- アイデンティティ管理サービス

- Oracle Web Service Managerセキュリティ

- 認可

- ポリシーおよび資格証明ライフサイクル

WebLogic Serverセキュリティ

WebLogic Serverセキュリティでは、次のものがサポートされています。

- WebLogicオーセンティケータ

- アイデンティティ・アサータ

- J2EEコンテナ・セキュリティ

- SSL

25.2 デフォルトのセキュリティ構成

この項では、WebCenter Portalアプリケーションのデプロイ時に設定されているセキュリティ構成と、デプロイ後に実行する必要のある構成タスクについて説明します。

- 管理者アカウント

- アプリケーション・ロールとエンタープライズ・ロール

- デフォルトのアイデンティティ・ストアおよびポリシー・ストア

- デフォルトのポリシー・ストアの権限および付与

- デプロイ後のセキュリティ構成タスク

25.2.1 管理者アカウント

WebCenter Portalアプリケーションでは、事前に用意されているアカウントはありませんが、WebCenter Portalアプリケーションのデフォルトのシステム管理者アカウント(weblogic)には特定の権限が事前に付与されています。インストールでシステム管理者ロールのアカウント名にweblogicを使用しない場合は、「ユーザーおよびアプリケーション・ロールの管理」の手順に従って、このロールにその他のユーザーを1つ以上構成する必要があります。

注意:

weblogicアカウントはシステム管理者アカウントです。そのため、ユーザーレベルのアーティファクトを作成する際には使用しないでください。weblogicアカウントは、Fusion Middleware Controlで新規ユーザー・アカウントを作成する場合にのみ使用してください。

25.2.2 アプリケーション・ロールとエンタープライズ・ロール

アプリケーション・ロールは、組込みLDAPサーバーのアイデンティティ・ストア部分に存在するロールや、エンタープライズLDAPプロバイダにより定義されたロールとは異なります。アプリケーション・ロールはアプリケーションに固有であり、ポリシー・ストアのアプリケーション固有のストライプで定義されます。

エンタープライズ・アイデンティティ・ストアに格納されているエンタープライズ・ロールは、エンタープライズ・レベルでのみ適用されます。つまり、ユーザーやシステム管理者がエンタープライズ・アイデンティティ・ストア内部に定義したロールおよび権限は、アプリケーション内の権限とは異なります。

WebCenter Portal内では、アプリケーション・ロールおよび権限を企業のアイデンティティ・ストア内のユーザーに割り当てることができます。また、エンタープライズ・アイデンティティ・ストア内に定義されたエンタープライズ・ロールに対してアプリケーション・ロールおよび権限を割り当てることもできます。

25.2.3 デフォルトのアイデンティティ・ストアおよびポリシー・ストア

WebCenter Portalはデフォルトで、ファイルベースの組込みLDAPアイデンティティ・ストアを使用してアプリケーションレベルのユーザーIDを格納し、Oracle RDBMS (リリース10.2.0.4以降、リリース11.1.0.7以降およびリリース11.2.0.1以降)ポリシー・ストアを使用してポリシー権限を格納するように構成されています。

組込みLDAPアイデンティティ・ストアはセキュアではありますが、本番クラスのストアではないため、エンタープライズ本番環境向けの外部LDAPベース・アイデンティティ・ストア(Oracle Internet Directoryなど)と置き換える必要があります。アイデンティティ・ストア・タイプのサポートされているバージョンのリストは、Oracle Fusion Middleware 12cの動作保証を参照してください。

注意:

デフォルトのファイルベースのポリシー・ストアは、開発用および単一ノードのWebCenter Portal構成用にのみ使用してください。エンタープライズ・デプロイメントでは、「アイデンティティ・ストアの構成」の説明に従って、ポリシー・ストアおよび資格証明ストアをデータベースまたは外部LDAPベースのストアに再度関連付ける必要があります。

ポリシー・ストアおよび資格証明ストアでは、デフォルトのデータベース・ストアまたはOracle Internet Directory 11gR1または10.1.4.3のいずれかを使用できます。外部LDAPベースのストアを使用する場合は、ポリシー・ストアと資格証明ストアで同じLDAPサーバーを使用するように構成する必要がある点に注意してください。同様に、データベースを使用する場合は、ポリシー・ストアと資格証明ストアで同じデータベースを使用する必要があります。

サポートされているアイデンティティ・ストア、ポリシー・ストアおよび資格証明ストアの構成の詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のサポートされているLDAPベース、DBベース、およびファイルベースのサービスに関する項を参照してください。アイデンティティ・ストア、ポリシー・ストアおよび資格証明ストアの再構成の詳細は、「アイデンティティ・ストアの構成」および「ポリシーおよび資格証明ストアの構成」を参照してください。

注意:

ディスカッションはデフォルトで、組込みLDAPアイデンティティ・ストアを使用するように構成されています。組込みLDAPストア内のすべてのユーザーがディスカッション・サーバーにログオンできます。また、Administratorsグループ内のすべてのユーザーがディスカッション・サーバーの管理権限を保有します。

アイデンティティ・ストアを外部LDAPサーバーに再度関連付けた場合、システム管理者アカウントを外部LDAPに移行するか(「外部LDAPサーバーへの管理者アカウントの移行」を参照)、管理者アカウントを移行しない場合は、ディスカッション・サーバーの新しい管理者アカウントを識別するために追加の手順が必要になります(「外部LDAPを使用するためのディスカッション・サーバーの移行」を参照)。

WebCenter PortalとContent Serverの両方で同じLDAPサーバーを共有する必要があります。詳細は、「Oracle WebCenter ContentとWebCenter Portalでアイデンティティ・ストアLDAPサーバーを共有するための構成」を参照してください。

25.2.4 デフォルトのポリシー・ストアの権限および付与

ADFセキュリティの権限モデルでは、権限ベースの認可およびロールベースの認可の両方がサポートされています。次のトピックでは、これらの2つの認可タイプ、デフォルトのポリシー・ストア権限およびコードベース権限について説明します。

- 権限ベースの認可

- ロールマッピング・ベースの認可

- WebCenter Portalのデフォルトのポリシー・ストア権限

- デフォルトのコードベース権限

25.2.4.1 権限ベースの認可

権限ベースの認可は、リストなど、Oracle Platform Security Services (OPSS)を使用してWebCenter Portalアプリケーション内にアクセス制御が実装されているツールで使用されます。WebCenter Portalには、ユーザーおよびロール管理ツールが豊富に用意されています。これらのツールによってアプリケーション・ロールを作成し、そのロールに付与する必要がある権限を定義できます。WebCenter Portalでのユーザーおよびロールの管理の詳細は、「ポータル間のセキュリティの管理」を参照してください。

25.2.4.2 ロールマッピング・ベースの認可

リモート(バックエンド)リソースへのアクセスが必要なツールおよびサービスでは、ロール・マッピングベースの認可が必須になります。たとえば、ディスカッションで、WebCenter Portalのユーザー(1つ以上のアプリケーション・ロールにマップされている)をディスカッション・サーバーの別のロール・セットにマップする必要がある場合は、ロール・マッピングが必須です。

たとえば、WebCenter Portalアプリケーションでは次のようになります。

- WebCenter Portalのロールは、バックエンドのディスカッション・サーバーの対応するロールにマップされます。

- ユーザーに新しいWebCenter Portalロールが付与されると、バックエンドのディスカッション・サーバーで同様の権限が付与されます。たとえば、ユーザーPatがWebCenter PortalでDiscussions-Create/Edit/Delete権限を付与された場合、バックエンドのディスカッション・サーバーで、対応する権限がPatに付与されます。

詳細は、「ディスカッション・サーバーのロール・マッピングの理解」を参照してください。

25.2.4.3 WebCenter Portalのデフォルトのポリシー・ストア権限

WebCenter Portalには、初期設定で次のデフォルト・ロールが用意されています。

デフォルトのアプリケーション・ロール:

- 管理者

- アプリケーション・スペシャリスト

- ポータル作成者

- 認証されたユーザー

- パブリック・ユーザー

デフォルトのアプリケーション・ロールの詳細は、「ポータル間のセキュリティの管理」を参照してください。

ポータル内のデフォルトのロール:

- ポータル・マネージャ

注意:

ParticipantおよびViewerのポータルレベルのロールはデフォルトでは作成されません。ポータルの迅速な作成および不必要なロールの削除を目的に、デフォルトで作成されるデフォルトのポータルレベルのロールはほとんどありません。

25.2.4.4 デフォルトのコードベース権限

WebCenter Portalは、権限チェックを使用して保護されたセキュリティ・プラットフォームでAPIを内部的にコールします。したがって、OPSSのAPIを呼び出すには、アプリケーションに適切な権限を付与する必要があります(たとえば、ポリシー・ストアにアクセスして権限を付与または取り消す(PolicyStoreAccessPermission)ための権限や、アプリケーション・ロールに基本的な権限を付与するための権限など)。

同様に、WebCenter Portalでは、WebCenter Portalの権限を使用して公開する各種操作に対して事前にアクセスを認可しておき、OPSS APIを権限付きアクションとして呼び出す必要があります。

25.2.5 デプロイ後のセキュリティ構成タスク

WebCenter Portalをデプロイした後で、次のセキュリティ関連の構成タスクをサイトに対して実行することを考慮する必要があります。

- 外部LDAPを使用するためのアイデンティティ・ストアの再関連付け
WebCenter Portalではデフォルトで、アイデンティティ・ストアに組込みLDAPが使用されます。事前に構成されている組込みLDAPは、セキュアではありますが、大規模なエンタープライズ本番環境には適さない場合があります。Oracle Internet Directory (OID)などの外部LDAPを使用するようにアイデンティティ・ストアを構成する方法の詳細は、「アイデンティティ・ストアの構成」を参照してください。

注意:

WebCenter Portalのディスカッション・サーバーはデフォルトで、組込みLDAPアイデンティティ・ストアを使用するように構成されています。組込みLDAPストア内のすべてのユーザーがディスカッション・サーバーにログオンできます。また、Administratorsグループ内のすべてのユーザーがディスカッション・サーバーの管理権限を保有します。

アイデンティティ・ストアを外部LDAPサーバーに再度関連付けた場合、システム管理者アカウントを外部LDAPに移行するか(「外部LDAPサーバーへの管理者アカウントの移行」を参照)、管理者アカウントを移行しない場合は、ディスカッション・サーバーの新しい管理者アカウントを識別するために追加の手順が必要になります(「外部LDAPを使用するためのディスカッション・サーバーの移行」を参照)。

WebCenter Portalに関しては、WebCenter PortalアプリケーションおよびContent Serverは同じLDAPサーバーを共有する必要があります。詳細は、「Oracle WebCenter ContentとWebCenter Portalでアイデンティティ・ストアLDAPサーバーを共有するための構成」を参照してください。

- SSOの構成
シングル・サインオン(SSO)を使用すると、ユーザーはサブアプリケーションごとにログインするのではなく(wikiページへのアクセスなど)、WebCenter Portalおよびコンポーネント全体で1回ログインするだけで済みます。ユーザーは、アクセスするアプリケーションまたはコンポーネントごとに別個のユーザーIDおよびパスワードを保持する必要がありません。ただし、より厳密な方式を使用して機密性の高いアプリケーションを保護できるように、多様な認証方式を構成することもできます。WebCenter Portalでは、4つのシングル・サインオン・ソリューション(Oracle Access Manager (OAM)、Oracle Single Sign-on (OSSO)、SAMLベースのシングル・サインオン・ソリューション、およびSimple and Protected Negotiate (SPNEGO)メカニズムとKerberosプロトコルに基づいたWindows認証による、Microsoftクライアント用SSOソリューション)がサポートされています。これらのソリューションの説明およびシングル・サインオンの概要は、「シングル・サインオンの構成」を参照してください。

- SSLの構成
Secure Sockets Layer (SSL)は、追加の認証レイヤーを提供し、交換されるデータを暗号化することによってWebCenter Portalとコンポーネントの間の接続のセキュリティを強化します。データ交換が機密的なアプリケーションまたはコンポーネント間の接続では、SSLを使用して接続を保護することを考慮してください。本番環境でSSLを使用して保護できる、または保護する必要のある接続のリストは、「SSLの構成」を参照してください。

注意:

SSLを使用すると、計算が集中的に行われ、接続のオーバーヘッドが増加します。このため、SSLは必要でないかぎりは使用しないでください。SSLは本番環境まで保留しておくことをお薦めします。

26 アイデンティティ・ストアの構成

この章では、アイデンティティ・ストアを、デフォルトの組込みLDAPアイデンティティ・ストアではなく外部のLDAPと再度関連付ける方法について説明します。また、Oracle WebCenter Content Server用のLDAPサーバーを構成する方法についても説明します。

この章の内容は次のとおりです。

- 外部LDAPサーバーへのアイデンティティ・ストアの再関連付け

- 外部LDAPアイデンティティ・ストア用のGUID属性の構成

- 組込みLDAPアイデンティティ・ストアへのユーザーの追加

- 外部LDAPサーバーへの管理者アカウントの移行

- Oracle WebCenter ContentとWebCenter Portalでアイデンティティ・ストアLDAPサーバーを共有するための構成

- libOVDを使用した複数のアイデンティティ・ストアLDAPサーバーの集約

- WebCenter Portalの動的グループの構成

- RESTサービス・アイデンティティ・アサータの構成

注意:

アイデンティティ・ストアを再度関連付ける前に、次の関連する構成ファイルを必ずバックアップしてください。

- config.xml

- jps-config.xml

念のため、ドメインの管理サーバーのboot.propertiesファイルもバックアップしてください。

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。

「管理操作、ロールおよびツールの理解」も参照してください。

26.1 外部LDAPサーバーへのアイデンティティ・ストアの再関連付け

ほとんどの場合、アイデンティティ・ストアは、デフォルトの組込みLDAPは使用せずに、外部LDAPサーバーに再度関連付ける必要があります。様々なタイプのLDAPサーバーを使用できますが、この項では、Oracle Internet Directory (OID)を使用するようにアイデンティティ・ストアを構成する方法を説明します。

注意:

外部LDAPサーバーへのアイデンティティ・ストアの再関連付けは、ドキュメントまたはディスカッション・ツールを使用している場合にのみ必須で、その場合はWC_Portalサーバー、Content Serverおよびコラボレーション・サーバーをすべて同じ外部LDAPサーバーを使用するように構成する必要があります。

アイデンティティ・ストア用のLDAPサーバーで強力なパスワード・ポリシーを設定することをお薦めします。次の要件を満たすユーザー・パスワードが推奨されます。

- パスワードには、連続する3文字以上のユーザーのアカウント名またはユーザーのフル・ネームの一部を含めないでください。

- パスワードの長さは、6文字以上または最小パスワード長ポリシー設定で指定された文字数以上にする必要があります。

- 古いパスワードを再利用する前にユーザー・アカウントに関連付ける必要がある一意の新しいパスワードの数を決定する強制パスワード履歴ポリシー設定。この値は、0と24の間で設定できます(この値を0に設定した場合、強制パスワード履歴は無効になります。パスワード再利用によるセキュリティの脆弱性を防止するために、24などの大きい値を設定することをお薦めします)。

- パスワードには、英字の大文字(AからZ)、英字の小文字(aからz)、10進数の数字(0から9)、英数字以外の文字(!$#,%など)の4つのカテゴリのうち、少なくとも3つのカテゴリの文字を含める必要があります。

他のサポートされているLDAP用のGUID属性は、「外部LDAPアイデンティティ・ストア用のGUID属性の構成」を参照してください。サポートされているLDAPサーバーの他のユーザー属性マッピングは、『Oracle Platform Security Servicesによるアプリケーションの保護』のユーザーおよびロールAPIリファレンスに関する項を参照してください。WebCenter PortalによってサポートされているLDAPのチューニングとパフォーマンスの詳細は、『パフォーマンスのチューニング』のアイデンティティ・ストア構成のチューニングに関する項を参照してください。

注意:

(WebCenter Portalのインストール時にそのデフォルト構成で作成されたデフォルトのデータベース・ストアではなく)既存のデータベースをアイデンティティ・ストアに使用するには、OVDを使用するか、ユーザーおよびロールAPIに基づいてカスタム・プロバイダを記述する必要があります。LibOVDをデータベース・アイデンティティ・ストアとともに使用しないでください。

注意:

本番環境の外部LDAPアイデンティティ・ストア(OIDなど)を別の外部LDAPストアに再度関連付けすることはサポートされていません。ビジネス要件によりそのような再関連付けを行う場合は、プロセス中にユーザー情報やアーティファクトが失われる可能性があるため、実施前にOracleサポートにご連絡ください。

アイデンティティ・ストアをOIDに再度関連付ける手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。

WebLogic Server管理コンソールへのログインの詳細は、「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。

「セキュリティ・レルムのサマリー」ペインが表示されます。

3. 「名前」列で、アイデンティティ・ストアを再度関連付けるレルムをクリックします。

「レルムの設定」ペインが表示されます。

4. 「プロバイダ」タブを開きます。

プロバイダの設定ペインが表示されます。

5. 「新規」をクリックして、新しいプロバイダを追加します。

「新しい認証プロバイダの作成」ペインが表示されます。

6. プロバイダの名前を入力します(OIDAuthenticatorなど、Oracle Internet Directoryに対してユーザーを認証するプロバイダの名前)を入力します。

7. LDAPディレクトリに適したオーセンティケータをオーセンティケータのリストから選択します。

一般的なDefaultAuthenticatorを選択するのではなく、構成するLDAPに関連付けられたオーセンティケータを選択してください。たとえば、OIDの場合はOracleInternetDirectoryAuthenticator、iPlanetの場合はIPlanetAuthenticatorを選択します。

注意:
iPlanetを使用する場合は、./user_projects/domains/soainfra/config/fmwconfig/jps-config.xmlのvirtualizeプロパティをtrueに設定します。

<serviceInstance name="idstore.ldap" provider="idstore.ldap.provider">
<property name="idstore.config.provider" value="oracle.security.jps.wls.internal.idstore.WlsLdapIdStoreConfigProvider"/>
<property name="CONNECTION_POOL_CLASS" value="oracle.security.idm.providers.stdldap.JNDIPool"/>
<property name="virtualize" value="true"/>
<property name="OPTIMIZE_SEARCH" value="true"/>
</serviceInstance>

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およびデフォルトの管理者アカウントの詳細は、「外部LDAPサーバーへの管理者アカウントの移行」を参照してください。

注意:

複数のオーセンティケータを使用する場合は、REQUIRED制御フラグを使用しないでください。オーセンティケータのリストでREQUIRED制御フラグが見つかった場合、その位置に関係なく、後続のオーセンティケータは調査されません。

16. 変更が有効になるように、管理サーバーと管理対象サーバーを再起動します。

26.2 外部LDAPアイデンティティ・ストア用のGUID属性の構成

この項では、Oracle LDAP以外の実装で使用される様々なGUID属性について説明します。サポートされている他のLDAPサーバーの他のユーザー属性マッピングは、『Oracle Platform Security Servicesによるアプリケーションの保護』のユーザーおよびロールAPIリファレンスに関する項を参照してください。『Oracle Platform Security Servicesによるアプリケーションの保護』のユーザー属性をLDAPディレクトリにマップする方法に関する項も参照してください。「LDAPディレクトリへのユーザー属性のマッピング」の表に示されているように、すべての属性がWebLogic Server (WLS)に付属する組込みLDAPサーバーを含むすべての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

26.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に再度関連付けする予定がある場合は、再関連付けの手順(「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」を参照)を先に実行してください。組込みLDAPをOIDや他の外部LDAP実装に再度関連付けする場合、ユーザーやユーザーのアーティファクトが移行できないことがあるからです。したがって、本番環境にユーザーを移行する場合を除き、組込みLDAPにはユーザーを追加しないでください。組込みLDAPは、テスト環境のみで使用することを目的としており、本番環境への移行が可能なステージング環境で使用することは意図していません。

WebCenter Portalでは自己登録がサポートされます。WebCenter Portalに自己登録した新規ユーザーは、アイデンティティ・ストアに直接追加されます。自己登録の詳細は、「自己登録の有効化」を参照してください。

注意:

アイデンティティ・ストアへのユーザーの追加は、一般にシステム管理者のタスクであり、アプリケーションレベルの管理者は必要な権限を持っていてもこのタスクを実行できない場合があります。

この項では、次の内容について説明します。

- WLS管理コンソールを使用したアイデンティティ・ストアへのユーザーの追加

- LDIFファイルを使用したアイデンティティ・ストアへのユーザーの追加

26.3.1 WLS管理コンソールを使用したアイデンティティ・ストアへのユーザーの追加

WebLogic Server管理コンソールから組込みLDAPアイデンティティ・ストアにユーザーを追加するには:

1. WebLogic Server管理コンソールにログインします。

WebLogic Server管理コンソールへのログインの詳細は、「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。

「セキュリティ・レルムのサマリー」ペインが表示されます。

3. 「名前」列で、ユーザーを追加するレルムをクリックします。

「レルムの設定」ペインが表示されます。

4. 「ユーザーとグループ」タブをクリックし、現行ユーザーのリストを表示します。

5. 「新規」をクリックして、新しいユーザーを追加します。

6. 「新しいユーザーの作成」ページで、「名前」フィールドに新しいユーザーのログイン名を入力します。

ユーザー名では大/小文字が区別されます。また、ユーザー名は一意である必要があります。カンマ、タブ、および次のカンマ区切りリスト内のその他の文字は使用しないでください。

< >、#、|、&、?、( )、{ }

7. 「説明」フィールドに、ユーザーの説明(たとえば、ユーザーのフル・ネーム)を入力します。

8. 「プロバイダ」ドロップダウン・メニューからDefaultAuthenticatorを選択します。

9. 「パスワード」フィールドに、ユーザーのパスワードを入力します。

WebLogic認証プロバイダで定義されたユーザーのパスワードの最低限の長さは8文字です(他のLDAPプロバイダではパスワード長の要件が異なる場合があります)。本番環境では、weblogic/weblogicのようなユーザー名とパスワードの組合せは使用しないでください。

10. 「パスワードの確認」フィールドにパスワードを再入力します。

11. 「OK」をクリックして変更を保存し、ユーザーを追加します。

追加したユーザーがユーザー・リストに表示されます。

26.3.2 LDIFファイルを使用したアイデンティティ・ストアへのユーザーの追加

LDIFファイルを使用して組込みLDAPアイデンティティ・ストアにユーザーを直接追加する手順は次のとおりです。LDIFファイルを使用すると、WebLogic Server管理コンソールからでは使用できない追加のユーザー属性を指定できます。組込みLDAPサーバーはLDAPに準拠したサーバーであるため、LDAPコマンドを使用してユーザーを追加または変更できます。また、ディレクトリを検索することもできます。これは、ユーザー・アカウントをエクスポートおよびインポートする場合に役立ちます。

LDIFファイルを使用して組込みLDAPにユーザーを追加するには、次のタスクを実行する必要があります。

- 外部LDAPアクセスの有効化

- LDIFファイルの作成

- ユーザーの追加

26.3.2.1 外部LDAPアクセスの有効化

LDAPアクセス資格証明は、WebLogic Serverのインストール時にランダム値として設定され、config.xmlファイルに暗号化されます。外部LDAPアクセスを有効にするには、組込みLDAPのアクセス資格証明をリセットする必要があります。

組込みLDAPのアクセス資格証明をリセットする手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。

WebLogic Server管理コンソールへのログインの詳細は、「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、wc_domainをクリックします。

3. wc_domainの「設定」ペインで「セキュリティ」タブをクリックし、「組込みLDAP」タブをクリックします。

wc_domainの「設定」ペインに組込みLDAP設定が表示されます。

4. 「資格証明」フィールドに新しいパスワードを入力し、「資格証明の確認」フィールドに再度入力します。

5. 「保存」をクリックして設定を保存します。

6. WebLogicサーバーを再起動します。

これを行った後は、次の値を使用してLDAPサーバーにアクセスできるようになります。

- 管理アクセスのDN値は"cn=Admin"です。

- パスワードは「資格証明」フィールドに入力した値です。

- ポートは管理ポートと同じポート(デフォルトは7001)です。

26.3.2.2 LDIFファイルの作成

LDIFファイルは任意のテキスト・エディタで作成できます。また、LDIFファイルには、組込みLDAPディレクトリに該当する任意の属性を含めることができます。WebLogic Serverの組込みLDAPサーバーのデフォルトでサポートされているobjectclassesは次のとおりです。

- person

- inetOrgPerson

- organizationalPerson

- wlsUser

組込みLDAPサーバーと正常に対話するには、ディレクトリ情報ツリー(DIT)のデフォルト・レイアウトを理解しておく必要があります。組込みLDAPディレクトリのデフォルト・レイアウトを図26-1に示します。

図26-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アイデンティティ・ストアには追加できません。

26.3.2.3 ユーザーの追加

次の例では、ldappaddコマンドを使用しています。このコマンドは、Oracle Internet Directoryサーバーに付属のLDAPコマンド行ユーティリティに含まれます。ldappaddコマンドの使用の詳細は、『Oracle Identity Managementリファレンス』のOracle Internet Directoryデータ管理ツールに関する項を参照してください。WebCenter Portalでサポートされる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

26.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管理者ロールのユーザーへの付与の詳細は、「WebCenter Portal管理者ロールの付与」を参照してください。

weblogic(デフォルト)ユーザーを外部LDAPディレクトリに作成できない場合は、2つのオプションがあります。次のことを実行できます。

- DefaultAuthenticatorプロバイダを維持したまま、weblogicアカウントとローカルの組込みLDAPサーバーをWebLogic Serverで使用し、WebLogic Server管理コンソールからサーバーの起動と停止および他の管理者用操作を行います。DefaultAuthenticatorを維持する場合は、DefaultAuthenticationプロバイダの制御フラグがSUFFICIENTに設定されていることを確認してください。このオプションを選択する場合は、「外部LDAPを使用するためのディスカッション・サーバーの移行」の手順に従って、追加の手順を実行する必要もあります。

注意:

DefaultAuthenticatorからweblogicユーザー・アカウントを使用する場合は、WebCenter Portalにアクセスする際にこのアカウントを使用しないでください。アプリケーション・コードから外部LDAPストアのユーザーを検索できなくなります。

- DefaultAuthenticatorを削除し、管理者用操作(サーバーの起動や停止など)で使用する有効なユーザー・アカウントを「管理者」グループに含めます。その他の名前のグループに含める場合は、そのグループにOIDまたは他の外部LDAPでドメインの管理を許可されたユーザーのリストが含まれている必要があります。「管理者」以外の名前を使用する場合は、WebLogic Serverグローバル管理者ロールの定義でグループ名を更新する必要があります。デフォルトでは、これは「管理者」というエンタープライズ・グループのメンバーシップとして定義されています。管理者グループ名の変更の詳細は、「管理者グループ名の変更」を参照してください。

注意:

OWSMはDefaultAuthenticatorによって指定されたOracleSystemUserおよびOracleSystemGroupエンティティに依存するため、組込みLDAPを削除した後、OWSMが動作するには、デフォルト・ユーザーを変更する必要があります。詳細は、『Oracle Web Services ManagerによるWebサービスの保護とポリシーの管理』のデフォルト・ユーザーの変更に関する項を参照してください。

この項には次のトピックが含まれます:

- 外部LDAPを使用するためのディスカッション・サーバーの移行

- 管理者グループ名の変更

26.4.1 外部LDAPを使用するためのディスカッション・サーバーの移行

ディスカッション・サーバーをインストールしており、管理者アカウントを外部LDAPに移行しない場合(「外部LDAPサーバーへの管理者アカウントの移行」を参照)、WebLogic Serverでオーセンティケータの順序を変更する前に、ディスカッション・サーバーで新しい管理者アカウントを識別するために追加の手順を実行する必要があります。

1. ディスカッション・サーバーの管理者にするユーザー・アカウントを外部LDAPから選択します。

2. 外部LDAPから選択したユーザー・アカウントに一致する管理者アカウントをDefaultAuthenticator(組込みLDAP)に作成します。組込みLDAPと外部LDAPサーバーのアカウント名は一致する必要があります。

組込みLDAPへのユーザーの追加の詳細は、「組込みLDAPアイデンティティ・ストアへのユーザーの追加」を参照してください。

3. ディスカッション・サーバー管理コンソールに起動アイデンティティ・アカウント(weblogic)でログインし、次にアクセスします。

http://host:port/owc_discussions/admin

hostとportはWLS_Services管理対象サーバーのホストIDとポート番号です。

4. 「設定」→管理者/モデレータをクリックします。

「管理者およびモデレータ」ページが表示されます(図26-2を参照)。

図26-2 「管理者およびモデレータ」ページ

5. 新規権限の付与をクリックします。

新規権限の付与ペインが表示されます(図26-3を参照)。

図26-3 新規権限の付与ペイン

6. 作成したユーザーにシステム管理者権限を付与します(図26-4を参照)。

図26-4 「新規権限の付与」ペインでの新規ユーザーの入力

7. 「システム」→「システム・プロパティ」をクリックします。

「Jiveプロパティ」ページが表示されます(図26-5を参照)。

図26-5 「Jiveプロパティ」ページ

8. 赤でマークされたプロパティが追加され、図26-5のように設定されていることを確認します。

9. WebLogic Server管理コンソールにログインします。

WebLogic Server管理コンソールへのログインの詳細は、「Oracle WebLogic Server管理コンソール」を参照してください。

10. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。

「セキュリティ・レルムのサマリー」ペインが表示されます。

11. 「名前」列で、管理者グループ名を変更するレルムをクリックします。

レルムの設定ペインが表示されます。

12. 「プロバイダ」タブを選択し、「認証」サブタブを選択したら、外部LDAPのオーセンティケータがリストの先頭に表示されるように認証プロバイダの順序を変更します(図26-6の例を参照)。

図26-6 認証プロバイダの順序変更後の「プロバイダ」タブ

13. ドメインの管理サーバーとディスカッション・サーバーを再起動します。

14. まだ実行していない場合は、外部LDAPでユーザーを作成し、そのユーザーにWebCenter Portal管理者ロールを付与します(「WebCenter Portal管理者ロールの付与」を参照)。

26.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管理コンソールへのログインの詳細は、「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。

「セキュリティ・レルムのサマリー」ペインが表示されます。

3. 「名前」列で、管理者グループ名を変更するレルムをクリックします。

レルムの設定ペインが表示されます。

4. 「ロールとポリシー」タブを開き、「レルム・ロール」サブタブを開きます。

「レルム・ロール」設定ペインが表示されます。

5. 「グローバル・ロール」ノードを開き、「ロール」ノードを開きます。

6. Adminロールの「ロール条件の表示」をクリックします。

「グローバル・ロールの編集」ページが表示されます。

デフォルトでは、Oracle Internet Directory(または他の構成済アイデンティティ・ストア)のAdministratorsグループにはWebLogic Serverで管理者ロールを持つユーザーが定義されています。

7. 「条件の追加」をクリックして、別のグループ名を追加します。

「グローバル・ロールの編集」ページに「述部リスト」が表示されます。

8. 「述部リスト」からGroupを選択し、「次へ」をクリックします。

「グローバル・ロールの編集」ページに「引数」が表示されます。

9. 新規管理者グループの名前を入力して、「追加」をクリックします。

10. 選択した新規管理者グループを残したまま既存の管理者グループを削除するには、そのグループを選択して「削除」をクリックします。

11. 「終了」をクリックして、変更内容を保存します。

この変更を行うと、指定した新規グループのすべてのメンバーにWebLogic Serverの管理権限が付与されます。

26.5 Oracle WebCenter ContentとWebCenter Portalでアイデンティティ・ストアLDAPサーバーを共有するための構成

WebCenter Content Serverは、WebCenter Portalと同じアイデンティティ・ストアLDAPサーバーを使用するように構成する必要があります。WebCenter Contentの構成の詳細は、「Oracle WebCenter Content Serverへの接続の管理」を参照し、『Oracle Platform Security Servicesによるアプリケーションの保護』のLDAPアイデンティティ・ストア・サービスの構成に関する項も参照してください。

26.6 libOVDを使用した複数のアイデンティティ・ストアLDAPサーバーの集約

複数のアイデンティティ・ストアを持つサイトでは、libOVDを使用してそのユーザー・プロファイル情報を集約できます。次の2つのシナリオの構成手順を説明します。

- それぞれに完全なユーザー・プロファイル情報が存在する個別のアイデンティティ・ストアでユーザーを有効にする場合。

- それぞれに部分的な属性が存在する2つのアイデンティティ・ストアで同一ユーザーを有効にする場合。

注意:

Active Directoryによる自己登録をサポートする場合は、「Active Directoryを使用してWebCenter Portalを構成するとユーザーが自己登録できない」に記載されているトラブルシューティングを必ず参照してください。

この項では、次の項目について説明します。

- アイデンティティ・ストアに完全なユーザー・プロファイルが存在する場合のlibOVDの構成

- アイデンティティ・ストアに部分的なユーザー・プロファイルが存在する場合のlibOVDの構成

- 単一オーセンティケータの復元

26.6.1 アイデンティティ・ストアに完全なユーザー・プロファイルが存在する場合のlibOVDの構成

各アイデンティティ・ストアに完全なユーザー・プロファイルが存在する場合にlibOVDを構成する手順は次のとおりです。

1. 構成するアイデンティティ・ストアのWLS管理コンソールで必要なオーセンティケータを作成し、ドメインのWeblogic管理サーバーおよび管理対象サーバーを再起動します。または、jps-config.xmlでアイデンティティ・ストア情報を手動で構成することもできます。

2. アイデンティティ・ストア・サービス・インスタンスをjps-config.xmlで更新し、値がtrueであるvirtualizeプロパティを追加します。これは手動でjps-config.xmlファイルを編集するか、Fusion Middleware Controlを使用して実行できます。

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"/>
<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」は実際の値に置き換えてください。

26.6.2 アイデンティティ・ストアに部分的なユーザー・プロファイルが存在する場合のlibOVDの構成

各アイデンティティ・ストアに部分的なユーザー・プロファイルのみが存在する場合にlibOVDを構成するには:

1. 構成するアイデンティティ・ストアのWLS管理コンソールで必要なオーセンティケータを作成し、ドメインのWeblogic管理サーバーおよび管理対象サーバーを再起動します。または、jps-config.xmlでアイデンティティ・ストア情報を手動で構成することもできます。

2. アイデンティティ・ストア・サービス・インスタンスをjps-config.xmlで更新し、値がtrueであるvirtualizeプロパティを追加します。これは手動でjps-config.xmlファイルを編集するか、Fusion Middleware Controlを使用して実行できます。

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"/>

<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管理サーバーと管理対象サーバーを再起動します。

26.6.3 単一オーセンティケータの復元

単一オーセンティケータを復元するには結合アダプタ・ルールを削除します。これにより、「アイデンティティ・ストアに部分的なユーザー・プロファイルが含まれる場合のlibOVDの構成」で実行した構成が取り消されます。

結合アダプタ・ルールを削除するには、Weblogic管理サーバーに接続して、次のWLSTコマンドを実行します。

deleteAdapter(adapterName="JoinAdapter1")
modifyLDAPAdapter(adapterName="oid auth", attribute="Visible", value="Yes")
modifyLDAPAdapter(adapterName="AD", attribute="Visible", value="Yes")

WebLogic管理サーバーと管理対象サーバーを再起動し、両方のアイデンティティ・ストアのユーザーがログインできることを確認します。

26.7 WebCenter Portalの動的グループの構成

動的グループとは、動的に移入される静的グループです。動的グループは、ロールに割り当てて、WebCenter Portal内で静的グループと同様に使用できます。

WebCenter Portalアプリケーション内では、静的グループと動的グループは区別されません。動的グループはすべて、アイデンティティ・ストアに構成され(構成内容は使用するLDAP実装に固有のものになります)、静的グループと同様に公開されます(事実上、動的グループは、静的なメンバー・リストと、動的に決定されるメンバーシップで構成されています)。

グループの動的メンバーシップを定義するには、グループのlabeledURI属性に適切なLDAP問合せフィルタを設定します。問合せフィルタには、グループのメンバーシップを定義するユーザー・セットが定義されています。

Oracle Internet Directoryで動的グループを作成するには、LDIFファイルとldapaddコマンドを使用するか、またはOracle Directory Services Manager (ODSM)を使用します。これら2つのオプションについて、次の各項で説明します。

- LDIFファイルを使用した動的グループの作成

- Oracle Directory Services Managerを使用した動的グループの作成

注意:

OVDが使用されている場合を除き、動的グループはOID以外のLDAPではサポートされません。

26.7.1 LDIFファイルを使用した動的グループの作成

LDIFファイルを使用して動的グループを作成するには:

1. テキスト・エディタでLDIFファイルを作成します。次の例では、デフォルトのユーザー検索ベース内で役職が「Manager」のユーザーをすべて表す動的グループを定義する方法を示します。

例: 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サーバーを更新します。例:

例: 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

26.7.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を使用したOracle Internet Directoryの管理に関する項を参照してください。

2. 「移動先」リストで「データ・ブラウザ」を選択します。

3. データ・ブラウザで「新規エントリ」アイコンをクリックします。

4. DNを指定して、オブジェクト・クラスorclDynamicGroupおよびgroupOfUniqueNamesを追加します。

5. 「必須プロパティ」タブで、CN属性を指定します。

6. 「オプション・プロパティ」タブで、labeleduriの属性を指定します。

7. 「OK」をクリックして、動的グループの定義を完了します。

ツリー・ビューをリフレッシュすると、作成した新しいグループが表示されるはずです。ODSMにはグループ・メンバーは表示されません。

26.8 RESTサービス・アイデンティティ・アサータの構成

この項では、RESTサービス用のアイデンティティ・アサータを構成する方法について説明します。WebCenter PortalでRESTサービス(RESTサービスAPIを含む)を使用する場合は、WebCenterドメインのアイデンティティ・ストアにRESTサービス用のアイデンティティ・アサータを構成する必要があります。次の項では、Oracle WebLogic ServerでOPSSトラスト・サービス・インスタンスとアイデンティティ・アサータを構成する方法について説明します。

この項では、次の項目について説明します。

- RESTサービス・インスタンスおよびアイデンティティ・アサータの理解

- クライアント・アプリケーションの設定

- WLSトラスト・サービス・アサータの構成

26.8.1 RESTサービス・インスタンスおよびアイデンティティ・アサータの理解

WebCenter Portalおよび他のOracle WebLogicアプリケーションでは、それらのアプリケーションで必要な方法でREST APIを使用して情報を表示できますが、そのようなコールは中間層から発信されるため、ユーザーはログイン資格証明を再度入力するよう求められます。これに対処するには、ユーザー・アイデンティティがHTTPヘッダーに伝播され、OPSSトラスト・サービス・アサータによってアサートされるときに境界認証を使用します。

ユーザー・アイデンティティをアプリケーション間で正常に伝幡するには、それらのアプリケーションでトラスト・サービス・インスタンスを正しく構成して使用する必要があります。図26-7に、アイデンティティ伝幡とアサーションに関連する各種コンポーネントを示します。

図26-7 RESTのアイデンティティ伝幡とアサーション

次に、RESTのアイデンティティ伝幡とアサーションに関連した一連のイベントを示します。

1. エンド・クライアント(ブラウザ、スマートフォン・アプリケーション)は、WebCenter Portalアプリケーションに接続します。

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はレスポンスを使用して、エンド・ユーザーにページを表示します。

26.8.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. 「WebCenter Portalドメイン・キーストアの作成」の説明に従ってキーストアを作成および構成し、アイデンティティ・アサータ用にWebLogic Serverを構成します。クライアント証明書および秘密鍵用のキーストアがまずプロビジョニングされます。このクライアント証明書はエクスポートされ、トラスト・キーストアにインポートされます。

3. jps-config.xml構成ファイルを編集します。

a. DOMAIN_HOME/config/fmwconfigディレクトリに移動し、テキスト・エディタでjps-config.xmlファイルを開きます。

b. jps-config.xmlファイルに次のものが含まれていることを確認します。

<serviceInstance name="keystore" provider="keystore.provider" location="./default-keystore.jks">

c. 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. すべてのサーバーを再起動します。

26.8.3 WLSトラスト・サービス・アサータの構成

この項では、WebLogic Serverトラスト・サービス・アサータを構成する方法について説明します。

WebLogic Serverトラスト・サービス・アサータを構成するには:

1. WebLogic管理コンソールに管理者としてログインします。

2. 「セキュリティ・レルム」→「myrealm」に移動します。

3. 「プロバイダ」タブを開き、「認証」サブタブを開きます。

「新しい認証プロバイダの作成」ページが表示されます。

4. 新しいアサータの「名前」を入力します(例: TrustServiceIdAsserter)。

5. アサータの「タイプ」にTrustServiceIdentityAsserterを選択します。

このアサータは、受信リクエストのトークンをデコードおよび検証するためにトラスト・サービスAPIをコールし、アサートされたサブジェクトを確立する際にユーザー名をWebLogicに渡します。

6. 「OK」をクリックして、変更を保存します。

7. すべての管理対象サーバーを再起動します。

27 ポリシーおよび資格証明ストアの構成

この章では、Oracle Internet Directory (OID)などの外部LDAPサーバーを使用するようにポリシーおよび資格証明ストアを構成する方法について説明します。

WebCenter Portalを最初にインストールすると、データベースを使用するためにポリシーおよび資格証明ストアが構成されます。本番環境では、デフォルトのデータベースまたは外部LDAP (Oracle Internet Directory 11gR1または10.1.4.3)を使用するようにポリシーおよび資格証明ストアが構成されている必要があります。HA環境または本番環境では、ファイルベースのLDAPの使用を試みないでください。

ポリシーおよび資格証明ストアをOIDと再度関連付けるには、LDAPディレクトリにルート・ノードを作成し、Fusion Middleware Controlを使用して、またはWLSTを使用してコマンド行から、ポリシーおよび資格証明ストアをOIDサーバーと再度関連付けます。ポリシーおよび資格証明ストアを再度関連付けて外部LDAPベースのストアを使用する際は、同じLDAPサーバーを使用するように資格証明ストアとポリシー・ストアを構成する必要があることに注意してください。ただし、アイデンティティ・ストアは、サポートされている他の任意のLDAPサーバーを使用することができ、ポリシー・ストアや資格証明ストアと同じLDAPサーバーを使用する必要はありません。トラブルシューティングの詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の再関連付けの失敗に関する項を参照してください。

注意:

ポリシー・ストアを再度関連付ける前に、次の関連する構成ファイルを必ずバックアップしてください。

- jps-config.xml

- system-jazn-data.xml

念のため、ドメインの管理サーバーのboot.propertiesファイルもバックアップしてください。

この章の内容は次のとおりです。

- ルート・ノードの作成

- Fusion Middleware Controlを使用した資格証明およびポリシー・ストアの再関連付け

- WLSTを使用した資格証明およびポリシー・ストアの再関連付け

- 資格証明の管理

- ユーザーおよびアプリケーション・ロールの管理

- WebCenter Portalにおける招待による自己登録の構成

- ポリシー・ストアのリフレッシュ間隔および他のキャッシュ設定の設定

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。

「管理操作、ロールおよびツールの理解」も参照してください。

27.1 ルート・ノードの作成

ポリシーおよび資格証明ストアをOIDと再度関連付ける際の最初のステップでは、LDAPディレクトリでLDIFファイルを作成し、すべてのデータを追加するルート・ノードを追加します。ルート・ノードを作成するには、『Oracle Platform Security Servicesによるアプリケーションの保護』のLDAPベースのセキュリティ・ストアを使用する場合の前提条件に関する項の手順に従います。ファイルを作成してノードを追加したら、Fusion Middleware ControlまたはWLSTを使用してストアを再度関連付けます。

27.2 Fusion Middleware Controlを使用した資格証明およびポリシー・ストアの再関連付け

ポリシーおよび資格証明ストアをOracle Internet Directoryに再度関連付ける前に、『Oracle Platform Security Servicesによるアプリケーションの保護』のLDAPベースのセキュリティ・ストアを使用する場合の前提条件に関する項の説明に従って、まずルート・ノードを作成する必要があります。ルート・ノードを作成したら、『Oracle Platform Security Servicesによるアプリケーションの保護』のFusion Middleware Controlを使用した再関連付けに関する項の手順に従います。再関連付けが失敗した場合は、『Oracle Platform Security Servicesによるアプリケーションの保護』の再関連付けの失敗に関する項を参照してください。

27.3 WLSTを使用した資格証明およびポリシー・ストアの再関連付け

ポリシーおよび資格証明ストアをOracle Internet Directoryに再度関連付ける前に、『Oracle Platform Security Servicesによるアプリケーションの保護』のLDAPポリシー・ストアを使用する場合の前提条件に関する項の説明に従って、まずルート・ノードを作成する必要があります。再関連付けが失敗した場合は、『Oracle Platform Security Servicesによるアプリケーションの保護』の再関連付けの失敗に関する項を参照してください。

WLSTを使用して資格証明およびポリシー・ストアを再度関連付ける手順は次のとおりです。

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")

27.4 資格証明の管理

管理者は、Fusion Middleware Controlを使用して、WebCenter Portalドメイン資格証明ストアの資格証明を管理できます。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のFusion Middleware Controlでの資格証明の管理に関する項を参照してください。

27.5 ユーザーおよびアプリケーション・ロールの管理

この項では、Fusion Middleware Control、WLST、およびWebCenter Portalの実行時管理ページを使用して、ユーザー・ロールとアプリケーション・ロールを管理する方法を説明します。

この項には次のサブセクションが含まれます:

- WebCenter Portal管理者ロールの付与

- アプリケーション・ロールの付与

- 実行時管理ページの使用

27.5.1 WebCenter Portal管理者ロールの付与

WebCenter Portalは、最初のオーセンティケータによってマップされたアイデンティティ・ストア内のユーザーのみを認識します。WebCenter Portal管理者アカウントは当初は組込みのLDAPサーバーにのみ作成されるため、Oracle Internet Directoryなどの外部LDAPをWebCenter Portalのプライマリ・オーセンティケータとして構成する場合は、そのLDAP内にユーザーを作成し、そのユーザーにWebCenter Portal管理者ロールを付与する必要もあります。

次の項の説明に従って、Fusion Middleware ControlまたはWLSTを使用してWebCenter Portal管理者ロールをユーザーに付与できます。

- Fusion Middleware Controlを使用したWebCenter Portal管理者ロールの付与

- WLSTを使用したWebCenter Portal管理者ロールの付与

27.5.1.1 Fusion Middleware Controlを使用したWebCenter Portal管理者ロールの付与

この項では、WebCenter Portal管理者ロールをデフォルトのweblogicアカウント以外のユーザー・アカウントに付与する方法について説明します。

Fusion Middleware Controlを使用してWebCenter Portal管理者ロールを付与する手順は次のとおりです。

1. Fusion Middleware Controlにログインし、WebCenter Portalホームページに移動します。
「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「セキュリティ」→「アプリケーション・ロール」を選択します。
「アプリケーション・ロール」ページが開きます(図27-1を参照)。

図27-1 「アプリケーション・ロール」ページ

3. WebCenter Portal管理者ロールを検索します。

- 「ロール名」フィールドに、管理者ロールの次の内部識別子を入力して、「検索」(矢印)アイコンをクリックします。

s8bba98ff_4cbb_40b8_beee_296c916a23ed#-#Administrator

検索の結果として、管理者ロールの識別子であるs8bba98ff_4cbb_40b8_beee_296c916a23ed#-#Administratorが返されます。

4. 検索結果から管理者ロールの識別子をクリックし、「編集」をクリックします。
アプリケーション・ロールの編集ページが開きます(図27-2を参照)。

図27-2 「アプリケーション・ロールの編集」ページ

5. 「メンバー」セクションから、「追加」をクリックします。
「プリンシパルの追加」ダイアログが開きます(図27-3を参照)。

図27-3 「プリンシパルの追加」ダイアログ

6. 管理者ロールを割り当てるユーザーを検索します。

a. 「タイプ」ドロップダウンから、「ユーザー」を選択します。

b. ユーザー名の一部またはユーザー名の最初の文字が含まれるように「プリンシパル名」または「表示名」、あるいはその両方のフィールドに検索条件を入力します。

c. オプションで、「ユーザー」を選択した場合は、「拡張オプション」セクションから「プリンシパル名をここに入力する場合に選択します」オプションを選択して、「プリンシパル名」または「表示名」、あるいはその両方のフィールドに検索条件を入力します。

d. 「OK」をクリックします。
「プリンシパルの追加」ダイアログが閉じ、ユーザー名がメンバーのリストに追加されます。

7. 「アプリケーション・ロールの編集」ページからweblogicロールを削除するには、ロールを選択して「削除」をクリックし、確認ダイアログで「はい」をクリックします。

8. 「アプリケーション・ロールの編集」ページで、「OK」をクリックします。

27.5.1.2 WLSTを使用したWebCenter Portal管理者ロールの付与

WLSTを使用して別のユーザーにWebCenter Portal管理者ロールを付与する手順は次のとおりです。

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")

27.5.2 アプリケーション・ロールの付与

この項では、Fusion Middleware ControlおよびWLSTコマンドを使用してアプリケーション・ロールにユーザーを追加する方法について説明します。

この項では、次の項目について説明します。

- Fusion Middleware Controlを使用したアプリケーション・ロールの付与

- WLSTを使用したアプリケーション・ロールの付与

27.5.2.1 Fusion Middleware Controlを使用したアプリケーション・ロールの付与

この項では、Fusion Middleware Controlを使用してユーザーにアプリケーション・ロールを付与する方法を説明します。

1. Fusion Middleware Controlにログインし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「セキュリティ」→「アプリケーション・ロール」を選択します。
「アプリケーション・ロール」ページが開きます(図27-1を参照)。

図27-4 「アプリケーション・ロール」ページ

3. 「ロール名」フィールドに、webcenterと入力してWebCenter Portalのすべてのアプリケーション・ロールを検索するか、ロールの名前を入力し(例: appConnectionManager)、「検索」(矢印)アイコンをクリックします。
名前がはっきりわからない場合は、部分検索語を入力するか、フィールドを空白のままにして、すべてのアプリケーション・ロールを表示します。

「アプリケーション・ロール」ページが開きます(図27-5を参照)。

図27-5 「アプリケーション・ロール」ページ

4. ユーザーを追加するロールを選択し、「編集」をクリックします(図27-6を参照)。
たとえば、パブリック・ロールにユーザーを追加するには、行「パブリック・ロール」を選択します。

図27-6 ロール名の検索結果

5. 選択したロールに対して開く「アプリケーションの編集」ページで、「追加」をクリックします(図27-7を参照)。

図27-7 「アプリケーション・ロールの編集」ページ

6. 開いている「プリンシパルの追加」ダイアログで(図27-3を参照)、ユーザーを検索します。

a. 「タイプ」ドロップダウンから、「ユーザー」を選択します。

b. ユーザー名の一部またはユーザー名の最初の文字が含まれるように「プリンシパル名」または「表示名」、あるいはその両方のフィールドに検索条件を入力します。

c. 「検索済プリンシパル」表からユーザー名を選択し、「OK」をクリックします。
「プリンシパルの追加」ダイアログが閉じ、アプリケーション・ロールの編集ページでアプリケーション・ロールのメンバーのリストにユーザー名が追加されます(図27-8を参照)。

図27-8 アプリケーション・ロールに追加されたユーザー

7. 「アプリケーション・ロールの編集」ページで、「OK」をクリックします。

8. WebCenter Portal (WC_Portal)管理対象サーバーを再起動します。

27.5.2.2 WLSTを使用したアプリケーション・ロールの付与

grantAppRoleコマンドを使用して、ユーザーにアプリケーション・ロールを付与します。構文および使用状況の詳細は、『WebLogic Server WLSTコマンド・リファレンス』のgrantAppRoleに関する項を参照してください。

27.5.3 実行時管理ページの使用

管理者はWebCenter Portalの「セキュリティ」タブを使用して、アプリケーション・ロールを定義し、アイデンティティ・ストアで定義されたユーザーにアプリケーション・ロールを付与できます。WebCenter Portalでのユーザーとアプリケーション・ロールの管理の詳細は、「ユーザーおよびアプリケーション・ロールの管理」を参照してください。

注意:

「パスワード変更の許可」プロパティは、ユーザーがWebCenter Portal内で各自のパスワードを変更できるかどうかを指定しますが、これは企業のアイデンティティ・ストアで慎重に管理する必要があります。WebCenter Portal管理者はWebCenter Portalのプロファイル管理設定のページからこのプロパティを設定できます。詳細は、「プロファイルの構成」を参照してください。

27.6 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コマンドでの資格証明の管理に関する項を参照してください。

27.7 ポリシー・ストアのリフレッシュ間隔および他のキャッシュ設定の設定

この項では、インストール後に構成する必要がある推奨キャッシュ設定を示します。キャッシュ・サイズと最大グループ階層の設定は特定の環境に基づく必要がありますが、次の項では開始点として使用できる推奨事項を示します。WebCenter Portalのチューニング・パラメータと推奨値の全リストは、『パフォーマンスのチューニング』のOracle WebCenter Portalパフォーマンスのチューニングに関する項を参照してください。

この項には次のトピックが含まれます:

- ポリシー・ストアのリフレッシュ間隔の設定

- 接続プール・キャッシュの設定

- ユーザー・キャッシュ設定の設定

- グループ・キャッシュ設定の設定

27.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によるアプリケーションの保護』のポリシー・キャッシュのリフレッシュに関する項を参照してください。

27.7.2 接続プール・キャッシュの設定

この項では、接続プール・キャッシュの推奨設定を説明します。

接続プール・キャッシュを設定する手順は次のとおりです。

1. WLS管理コンソールにログインします。

2. 「セキュリティ・レルム」→[realm]→「プロバイダ」→[provider]→「構成」→「プロバイダ固有」を選択します。

3. 接続プール・キャッシュのパラメータを次の推奨値に設定します。

- 接続プール・サイズ = 最大接続ユーザー数

- 接続タイムアウト = 30

- 接続再試行制限 = 1

- 結果タイム・リミット = 1000

- キープアライブの有効化 = true

4. 変更を保存し、ドメイン内のすべてのサーバーを再起動します。

27.7.3 ユーザー・キャッシュ設定の設定

この項では、ユーザー・キャッシュ設定の推奨設定を説明します。

ユーザー・キャッシュ設定を設定する手順は次のとおりです。

1. WLS管理コンソールにログインします。

2. 「セキュリティ・レルム」→[realm]→「プロバイダ」→[provider]→「構成」→「プロバイダ固有」を選択します。

3. ユーザー・キャッシュのパラメータを次の推奨値に設定します。

- キャッシュの有効化 = true

- キャッシュ・サイズ = 3200

- キャッシュTTL = session timeout

- 結果タイム・リミット = 1000

- キープアライブの有効化 = true

4. 変更を保存し、ドメイン内のすべてのサーバーを再起動します。

27.7.4 グループ・キャッシュ設定の設定

この項では、グループ・キャッシュ設定の推奨設定を説明します。

グループ・キャッシュ設定を設定する手順は次のとおりです。

1. WLS管理コンソールにログインします。

2. 「セキュリティ・レルム」→[realm]→「プロバイダ」→[provider]→「パフォーマンス」を選択します。

3. グループ・キャッシュのパラメータを次の推奨値に設定します。

- グループ・メンバーシップ・ルックアップの階層キャッシュを有効化 = true

- キャッシュ・サイズ = 3200

- キャッシュ内の最大グループ階層数 = 1024

- グループ階層キャッシュTTL = session timeout

- キープアライブの有効化 = true

4. 変更を保存し、ドメイン内のすべてのサーバーを再起動します。

28 シングル・サインオンの構成

この章では、WebCenter Portalで利用できるシングル・サインオン(SSO)ソリューションと各ソリューションの構成方法について説明します。

この章の内容は次のとおりです。

- シングル・サインオンの概要

- Oracle Access Managerの構成

- SAMLベースのシングル・サインオンの構成

- Microsoftクライアント用のSSOの構成

- 仮想ホストを使用したSSOの構成

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。

「管理操作、ロールおよびツールの理解」も参照してください。

28.1 シングル・サインオンの概要

シングル・サインオンでは、ユーザーがコンポーネントにアクセスするたびにログインする必要があるのではなく、1回のログインで済むようにトポロジのコンポーネント全体の認証が提供されます。シングル・サインオンを実装しない場合、ユーザーはWebCenter PortalからディスカッションやContent Serverなどのコンポーネントにアクセスするたびに資格証明を提供する必要があります。

いくつかのソリューションを使用して、WebCenter Portal向けにシングル・サインオンを実装できます。この項では、その利点と推奨アプリケーションを説明します。

オラクル社のエンタープライズ・クラスのアイデンティティ管理とセキュリティ対策のための製品スイートの一部であるOracle Access Manager (OAM)は、WebCenter Portal用のいくつかのシングル・サインオン・オプションを含む広範なアイデンティティ管理およびセキュリティ機能を提供します。OAM (特にOAM 11g)は、Oracle WebCenter Portal 12cのインストールに推奨されるシングル・サインオン・ソリューションです。

Oracle Access ManagerやOracle SSOのようなエンタープライズ・クラスのシングル・サインオン・インフラストラクチャが用意されていない開発環境(非本番環境)で、WebCenter Portalおよび関連するWebツール(ディスカッションなど)内でのみシングル・サインオン機能を提供する必要がある場合は、SAMLベースのSSOソリューションを構成できます。他のエンタープライズ・アプリケーションにもシングル・サインオンを提供する必要がある場合は、このソリューションはお薦めできません。

Active Directoryのユーザー・アカウントによってMicrosoftドメイン・コントローラを使用して認証を行うMicrosoftデスクトップ・ログインを使用している場合は、Microsoftのクライアントに対するSSOの構成も検討できます。

28.2 Oracle Access Managerの構成

Oracle Access Manager (OAM)は、柔軟で拡張可能な認証と認可のほか、監査サービスを提供します。この項では、WebLogicサーバー側およびSSOに参加するパートナ・アプリケーションとしてのWebCenter Portalアプリケーションの構成方法を含め、OAMシングル・サインオン認証のためにWebCenter Portalを構成する方法を説明します。

次のトピックでは、OAM 11gのインストールと構成の手順を示します。

- OAMのコンポーネントとトポロジ

- OAM構成のロードマップ

- OAM 11gのインストールと構成

- OAM用のWebLogicドメインの構成

- Oracle HTTP Serverのインストールと構成

- 追加のシングル・サインオン構成

- OAMインストールのテスト

28.2.1 OAMのコンポーネントとトポロジ

図28-1は、Oracle Access Managerを使用してWebCenter Portalアプリケーションのシングル・サインオンを設定するために必要なコンポーネントとトポロジを示しています。

図28-1 OAMシングル・サインオンのコンポーネントとトポロジ

OAMは次のコンポーネントから構成されます。

- アクセス・サーバー: アクセス・ゲートに対して認証、認可および監査サービスを提供するスタンドアロン・サーバー。OAMには1台のアクセス・サーバーがセットアップされます。これはOAMのインストール自体の一環として行われます。

- WebGate: Webリソース(HTTP)リクエストをインターセプトして認証と認可のためにアクセス・サーバーに転送する、すぐに利用可能なプラグイン。

- アイデンティティ・アサーション・プロバイダ(IAP): 境界認証によって設定されるヘッダー情報に基づいてユーザーのアイデンティティをアサートするセキュリティ・プロバイダの種類。OAMの統合により、OAM IAPとして構成できるOAM IDアサータが提供されます。OAM IDアサータは、認証またはアイデンティティ・アサーションに使用できます。OAM SSOの統合では、プロバイダの「共通」設定の「アクティブなタイプ」でobSSOCookieを選択して、アイデンティティ・アサーション・プロバイダ(IAP)としてOAM IDアサータを構成することが必要です。

OAMシングル・サインオン・プロセスのフロー

図28-2は、OAMのシングル・サインオン・プロセスのフローを示しています。

図28-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アプリケーションを実行中のWLSサーバーにリダイレクトされて、そこから目的のコンテンツやアプリケーションがユーザーに提供されます。
WebGate→mod_wl→WebCenter Portalアプリケーション(ディスカッションなど)→コンテンツが認証されたユーザーに提供されます

- 認可ポリシーでアクセスが拒否されている場合は、管理者が決定した別のURLにユーザーはリダイレクトされます。

28.2.2 OAM構成のロードマップ

図28-3と表28-1は、OAMを使用してWebCenter Portalのシングル・サインオンを構成するために必要な前提条件とタスクの概要を示しています。

図28-3 OAMを使用したWebCenter Portalのシングル・サインオンの構成

表28-1は、OAMを使用してWebCenter Portalのシングル・サインオンを構成するためのタスクとサブタスクを示しています。

表28-1 OAMを使用したWebCenter Portalのシングル・サインオンの構成

担当者

タスク

管理者

1.OAM 11gのインストールと構成

管理者

2.OAM用のWebLogicドメインの構成

2.a Oracle Internet Directoryオーセンティケータの構成

2.b OAMアイデンティティ・アサータの構成

2.c デフォルト・オーセンティケータとプロバイダの順序の構成

2.d OAMシングル・サインオン・プロバイダの追加

管理者

3. Oracle HTTP Serverのインストールと構成

管理者

4.追加のシングル・サインオン構成

4.a SSO用のWebCenter Portalの構成

4.b SSO用のディスカッション・サーバーの構成

4.c SSO用のSOAサーバー接続の構成

4.d 外部リーダーを使用したRSSフィード用のOAMの構成

4.e OAM 11g用のWebLogic Server管理コンソールとEnterprise Managerの構成

4.f SSO用のContent Serverの構成

4.g 接続フィルタを使用したアクセスの制限

管理者

5.OAMインストールのテスト

28.2.3 OAM 11gのインストールと構成

この項では、OAM 11gのインストールおよび構成方法について説明し、次の内容を含みます。

- OAM 11gのインストールと構成

- Oracle HTTP Serverのインストールと構成

- Web層でのWebGateのインストール

- WebGateエージェントの登録

28.2.3.1 OAM 11gのインストールと構成

注意:

Oracle WebCenter Portalおよび環境に必要な他のすべてのコンポーネントをインストールした後に、OAMをインストールしてください(『Oracle WebCenter Portalのインストールと構成』を参照)。また、必要な接続も、すべて事前に構成およびテストしてください。

『Oracle Identity Managementインストレーション・ガイド』のOracle Identity Managementのインストールと構成に関する項の説明に従って、Oracle Access Manager (OAM)をインストールします。理想的なシナリオは、OAMとシングル・サインオンに参加するすべてのアプリケーションが同じアイデンティティ・ストアを共有することです。デフォルトでは、OAMは組込みのLDAPアイデンティティ・ストアを使用します。

OIDなどの外部アイデンティティ・ストアを使用するようにOAMを構成するには、『Oracle Access Management管理者ガイド』の新しいユーザー・アイデンティティ・ストアの登録に関する項を参照してください。この項には、デフォルトまたはシステム・ストアとして構成された外部アイデンティティ・ストアを設定し、このストアをポイントするように1つ以上の認証モジュールを構成するためのポインタが示されています。デフォルトでは、OAMに構成されたWebCenterポリシーは、OAMに指定されたデフォルト認証スキーム(通常はフォームベースの認証スキームLDAPScheme)を使用します。

デフォルト・スキームを使用する場合は、スキームが使用する認証モジュールは、WebCenterのインストールと同じアイデンティティ・ストアをポイントする必要があります。オプションとして、デフォルト以外の認証スキームを構成することができます。この場合も、WebCenterが使用するアイデンティティ・ストアをこれが確実にポイントするようにしてください。それから、『Oracle Identity Managementインストレーション・ガイド』のOracle Identity Managementのインストールと構成に関する項の説明に従って、WebLogic管理ドメインでOracle Access Managerを構成します。

28.2.3.2 Oracle HTTP Serverのインストールと構成

Oracle HTTP Server (OHS)がインストールされていない場合、「Oracle HTTP Serverのインストールと構成」の説明に従ってOHSをインストールします。

インストールが終了したら、「Web層でのWebGateのインストール」の説明に従ってWebGateをインストールします。

28.2.3.3 Web層でのWebGateのインストール

この項では、OHS WebGateのインストールおよび構成方法について説明します。

注意:

OHS WebGateのインストール中は必ずOracle HTTP Serverを停止し、「WebGateエージェントの登録」の説明に従ってWebGateエージェントを登録した後でのみ再起動してください。

1. 『WebGate for Oracle Access Managerのインストール』の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のインストールまたはパッチ適用後に実行する必要があります。

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

28.2.3.4 WebGateエージェントの登録

Web層にWebGateをインストールしたら、WebGateエージェントの登録も行う必要があります。次の手順では、OAMのインストールで構成されたデフォルト認証スキーム(通常はフォームベースの認証スキームLDAPScheme)を使用する保護されたポリシーを自動的に作成します。シングル・サインオンのログイン・ページをカスタマイズする場合、または他の認証スキームでリソースを保護する場合は、OAMコンソールを使用してそれを変更してください(詳細は、『Oracle Access Management管理者ガイド』の認証スキームの管理に関する項を参照)。

注意:

環境で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がインストールされている場合は、次の手順に従います。

a. 次の例に示されているように、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>

b. 次のコマンドを実行します。

<RREG_Home>/bin/oamreg.sh policyUpdate input/WebCenterOAM11gPolicyUpdate.xml

入力を要求されたら、OAMの資格証明を入力します。URIファイルをインポートするかどうか尋ねられたら、yesと入力して、<RREG_HOME>/input/soa.oam.confを指定します。

ポリシーはSOAリソースを使用して更新されます。

c. 再度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層と関連するコンポーネントをインストールおよび構成したら、「OAM用のWebLogicドメインの構成」の説明に従ってポリシー・マネージャを構成し、「追加のシングル・サインオン構成」の説明に従って適用される追加のサービスとコンポーネントの構成を実行します。

28.2.4 OAM用のWebLogicドメインの構成

環境が複数のドメインにまたがっている場合(例: WebCenter Portalのドメイン、別個のSOAのドメインおよび別個のContent Serverのドメイン)、それぞれのドメインについてこの項の手順を繰り返してください。

この項では、次の内容について説明します。

- Oracle Internet Directoryオーセンティケータの構成

- OAMアイデンティティ・アサータの構成

- デフォルト・オーセンティケータとプロバイダの順序の構成

- OAMシングル・サインオン・プロバイダの追加

28.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管理コンソールへのログインの詳細は、「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. 「保存」をクリックします。

28.2.4.2 OAMアイデンティティ・アサータの構成

OAMアイデンティティ・アサータは、プロバイダの制御フラグをREQUIREDに設定して構成する必要があります。

OAMアイデンティティ・アサータを構成するには:

1. WebLogic Server管理コンソールにログインします。

WebLogic Server管理コンソールへのログインの詳細は、「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。

「セキュリティ・レルムのサマリー」ペインが表示されます。

3. OAMアイデンティティ・アサータを構成するレルム・エントリをクリックします。

レルムの「設定」ペインが表示されます。

4. 「プロバイダ」タブを開きます。

「プロバイダ設定」が表示されます。

5. 「新規」をクリックして、プロバイダを作成します。

「新しい認証プロバイダの作成」ペインが表示されます。

6. 新しいプロバイダの名前(例: OAM ID Asserter)を入力し、そのタイプとしてOAMIdentityAsserterを選択して、「OK」をクリックします。

7. 「プロバイダ」タブで、新しく追加したプロバイダをクリックします。

オーセンティケータの「共通設定」ペインが表示されます。

8. 制御フラグをREQUIREDに設定し、OAM_REMOTE_USERとObSSOCookieが「アクティブなタイプ」に設定されていることをチェックします。

9. 「保存」をクリックして、設定を保存します。

28.2.4.3 デフォルト・オーセンティケータとプロバイダの順序の構成

OAMアイデンティティ・アサータを構成したら、デフォルト・オーセンティケータの制御フラグがSUFFICIENTに設定されていることを確認して、次のようにプロバイダを並べ替えます。

1. プロバイダの設定ペインに移動します。

2. デフォルト・オーセンティケータを開き、制御フラグがSUFFICIENTに設定されていることを確認します。

3. 先ほど作成した2つのプロバイダ以外の全プロバイダについて、同じことを行います。

4. 設定ペインで、プロバイダの順序を次のようにリセットします:

- OAMIdentityAsserter (REQUIRED)

- OracleInternetDirectoryAuthenticator (SUFFICIENT)

- DefaultAuthenticator (SUFFICIENT)

- DefaultIdentityAsserter

5. 引き続いて、「SSO用のWebCenter Portalの構成」の説明に従って、シングル・サインオン・モード用にWebCenter Portalを構成します。また、「追加のシングル・サインオン構成」の説明に従って、環境に適用する他のサービスおよびコンポーネントの構成を実行してください。

28.2.4.4 OAMシングル・サインオン・プロバイダの追加

デフォルト・オーセンティケータの制御フラグが適切に設定されていることとプロバイダの順序が正しいことをチェックしたら、次で説明されているように、OAM SSOプロバイダを追加して、すべてのサーバーを再起動します。

1. WLSTを使用してWebLogicドメインに接続し、次のコマンドを実行します。

addOAMSSOProvider(loginuri="/${app.context}/adfAuthentication", logouturi="/oamsso/logout.html")

2. すべてのサーバーを再起動します。

28.2.5 Oracle HTTP Serverのインストールと構成

この手順は、OAMをインストールおよび構成した後、WebLogicドメインを構成する前に実行する必要があります。

Oracle HTTP Server(OHS)をインストールおよび構成する手順は次のとおりです。

1. 使用するOHSのインストールがまだない場合は、『Oracle HTTP Serverのインストールと構成』のOracle HTTP Serverのインストールの理解に関する項の指示に従ってOracle HTTP Serverをインストールします。

2. mod_wl_ohs.confの次の例を使用して、WebCenter Portal用のOracle WebLogic Serverにリクエストを転送するようにWeb層OHSを構成します。WebLogicポート番号が構成と一致するようにしてください。詳細は、『WebGate for Oracle Access Managerのインストール』のOAM用のOracle HTTP Server 11g WebGateのインストールと構成に関する項を参照してください。

注意:

この例では、WebCenter Portalが非クラスタベースのインストールであることを前提としています。クラスタ化環境の場合は、WebLogicHostとWebLogicPortを環境の必要に応じてWeblogicClusterに変更してください。詳細は、『WebGate for Oracle Access Managerのインストール』の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>
SetHandler weblogic-handler
WebLogicHost webcenter.example.com
WebLogicPort 8890
</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>

</IfModule>

# <Location /weblogic>
#      SetHandler weblogic-handler
#      PathTrim /weblogic
#      ErrorPage  http:/WEBLOGIC_HOME:WEBLOGIC_PORT/
#  </Location>

注意:

前述のLocationリストのエントリは、着信パスを、対応するアプリケーションが常駐する適切なWebLogic Server管理対象サーバーにマップします。

28.2.6 追加のシングル・サインオン構成

次の項で説明する構成は、サイトのセキュリティを強化するために必要であるか、または役に立ちます。これらの構成が完了したら、「OAMインストールのテスト」の説明に従ってOAMインストールのテストを行ってください。

- SSO用のWebCenter Portalの構成

- SSO用のディスカッション・サーバーの構成

- SSO用のSOAサーバー接続の構成

- 外部リーダーを使用したRSSフィード用のOAMの構成

- OAM 11g用のWebLogic Server管理コンソールとEnterprise Managerの構成

- SSO用のSecure Enterprise Searchの構成

- SSO用のContent Serverの構成

- 接続フィルタを使用したアクセスの制限

- ポートレット・プロデューサと追加コンポーネントの構成

28.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_Portalサーバーを再起動します。

28.2.6.2 SSO用のディスカッション・サーバーの構成

この項では、シングル・サインオン用のディスカッション・サーバーを構成する方法を説明します。SSO用のディスカッション・サーバーを構成する前に、「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」の説明に従って、WebCenter Portalと同じアイデンティティ・ストアLDAPを使用するようにこれが構成されていることを確認してください。デフォルトの管理者アカウントを外部LDAPに移動しないことを選択した場合は、「外部LDAPを使用するためのディスカッション・サーバーの移行」の指示にも従ってください。

注意:

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をポイントしている必要があります。

28.2.6.2.1 WebCenter Portal用のディスカッション・サーバー接続の作成

この項では、Web層のホストおよびポートの値を使用するようにWebCenter Portal用のディスカッション・サーバー接続を更新する方法を説明します。次の手順では、ディスカッション・コンポーネントがWebCenter Portalドメインにすでにインストールおよび構成されていることを前提としています。

1. Fusion Middleware ControlまたはWLSTを使用して、ディスカッション・サーバーのURLホストおよびポート設定をWC_Portal管理対象サーバーの設定からWeb層のホストおよびポート設定に変更します。これらの設定の変更方法の詳細は、「ディスカッション・サーバー接続の詳細の変更」を参照してください。

2. WC_Portal管理対象サーバーを再起動します。

WebCenter Portalにログインすると、ディスカッション・サーバーにも自動的にサインオンします。

28.2.6.3 SSO用のSOAサーバー接続の構成

すでにSOAサーバー接続をセットアップしてある場合は、SOAサーバーのホストとポートのかわりにWeb層のホストとポートを使用するようにURLを変更します。このことは、「WebCenter PortalワークフローをホスティングするBPELサーバーの指定」の説明に従い、Fusion Middleware Controlを使用して実行できます。

URLを変更してOAM SSOに必要な設定を完了したら、WebCenter Portal管理サーバー上で次のコマンドを実行して変更を有効にします。

setBPELConnection('webcenter','WebCenter-Worklist', 'http://webtier.example.com:7777')

28.2.6.4 外部リーダーを使用したRSSフィード用のOAMの構成

デフォルトでは、WebCenter Portal RSSフィードはSSOによって保護されています。ただし、保護されたままの状態では、それらは外部リーダーでうまく機能しません。外部リーダーを使用したアクセスが重要な場合は、その外部リーダーが処理できるWebLogic ServerのBASIC認証によってRSSサーブレットの認証が処理されるように、WebCenter Portal RSSリソースをOAMポリシーから除外することをお薦めします。

OAM 11gのRSSフィードを非保護にする手順は次のとおりです。

1. OAM管理コンソールを開きます。

2. 「ポリシー構成」タブを開いて、「アプリケーション・ドメイン」→<該当するアプリケーション・ドメイン>を選択します。

3. 「リソース」タブを開いて、/rss*を検索します。

結果の中に、次のような項目が表示されるはずです。

/rss*

/rss/.../*

/rss/rssservlet*

/rss/rssservlet/.../*

4. それぞれのリソースについて、そのリソースを選択して「編集」をクリックします。

5. 各リソースの保護レベルをProtectedからExcludedに変更して、「適用」をクリックします。

リソースの認証ポリシーと認可ポリシーが削除されることに注意してください。

6. タブを閉じてOHSを再起動します。

28.2.6.5 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. セキュリティ保護が必要なリソースを追加します。各リソースに対して、次の手順を実行します。

a. 「リソース・タイプ」としてhttpを選択します。

b. WebGateエージェントの登録時に作成したホスト識別子を選択します。

c. 「リソースURL」に、WebLogic Server管理コンソールのリソースURL(/console)またはEnterprise ManagerのリソースURL(/em)を入力します。

d. リソースの「説明」を入力し、「適用」をクリックします。

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ログイン・フォームのプロンプトが表示されます。

28.2.6.6 SSO用のSecure Enterprise Searchの構成

WebCenter PortalとSESに定義された対応する認証エンド・ポイントが使用するWebCenter Portalデータとリポジトリをクロールするために定義されるクロール・ソースは、適切に認証されるようにWeb層OHSポートを通してルーティングする必要があります(認証方式は引き続きBASICおよびレルムjazn.comになります)。SES接続の構成の詳細は、「Oracle SES接続の設定」を参照してください。

28.2.6.7 SSO用のContent Serverの構成

SSOのセットアップが完了し、Content Serverの接続をセットアップしたら、Fusion Middleware Controlを使用して、または次のWLSTの例のように、JCRContentServerConnectionにWebコンテキスト・ルートを指定します。

setJCRContentServerConnection(appName, name, webContextRoot='/cs')

Webコンテキスト・ルートを設定することで、SSOがセットアップされていることをドキュメント・ライブラリのコードに伝えます。この設定は、SSOを完全にセットアップするまでは設定しないでください。

28.2.6.8 接続フィルタを使用したアクセスの制限

ユーザーが適切に認証されるように、Web層OHSポートを通してのみWebCenter Portalおよび関連するコンポーネントへのアクセスを許可するには、次の手順に従います。

1. WebLogic Server管理コンソールにログインします。

WebLogic Server管理コンソールへのログインの詳細は、「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アドレスからの全トラフィックを拒否するように指定しています。もちろん、環境に適切なネットワーク・フィルタを作成する必要があります。接続フィルタの作成の詳細は、『WebLogicセキュリティ・サービスによるアプリケーションの開発』のカスタム接続フィルタの開発に関する項を参照してください。

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

28.2.6.9 ポートレット・プロデューサと追加コンポーネントの構成

OHSを通してルーティングされるようにポートレット・プロデューサ・アプリケーションをセットアップした場合は、登録用のプロデューサURLを指定する際に必ずOHSホストおよびポートを使用してください。これは、wsrp-toolsのようなデフォルトのプロデューサ、サービス・プロデューサ、ページレット・プロデューサおよび明示的に構成した他のプロデューサに適用されます。

28.2.7 OAMインストールのテスト

OAM 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アクセス出力から取得します)。ログイン・チャレンジは表示されず、パブリック・コンテンツを表示できるはずです。ログイン後にこれにアクセスすると、アクセス権を持つすべてのコンテンツが表示されるはずです。

- Content Server: プロファイルUIに移動し、ログインをチャレンジされずに、iFrame内に埋め込まれているContent Server画面が表示できることを確認します。すでにWebCenter Portalにログインしている際には、ログインせずにコンテンツ・プレゼンタ・テンプレートのSite Studioコンテンツにもアクセスできます。

- SOA: ワークフロー・タスク・フローのリンクにアクセスして、ログインをチャレンジされないことを確認します。

- ディスカッション・フォーラム: ディスカッション・アプリケーション(http://host:port/owc_discussions)にアクセスして、ログインします。ログインがSSOログイン・チャレンジであることを確認します。同様に、ディスカッション・サーバー(http://host:port/owc_discussions/admin)に管理者ログインする場合も、SSOログイン・チャレンジを使用する必要があります。

28.3 SAMLベースのシングル・サインオンの構成

Security Assertion Markup Language (SAML)によって、WebLogic ServerドメインおよびWebブラウザまたは他のHTTPクライアントで実行されているWebベースのアプリケーションやWebサービス間でクロスプラットフォームの認証が可能になります。WebLogic Serverは、WebCenter Portalに対して、SAMLに基づくシングル・サインオン(SSO)をサポートします(ページレット・プロデューサ・アプリケーションはサポートされません)。

シングル・サインオン構成に参加する1つのサイトでユーザーが認証されると、SSO構成の他のサイトでも自動的に認証され、別途ログインする必要はありません。ページレット・プロデューサ・アプリケーションはSAML SSOに参加しないので、ページレット・プロデューサ・アプリケーションにアクセスするユーザーは明示的にログインする必要があることに注意してください。

注意:

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およびSOAに対してSAML 1.1ベースのシングル・サインオンをセットアップする方法を説明します。

この項には次のトピックが含まれます:

- SAMLのコンポーネントとトポロジ

- SAMLベースのシングル・サインオンの構成

28.3.1 SAMLのコンポーネントとトポロジ

図28-5は、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アサーションの形式でセキュリティ情報をアサートする権限を持つエンティティ)です。

図28-4は、WebCenter PortalとSOAドメインの両方を含む、POSTが構成されたSAML SSO構成のコンポーネントとフローを示しています。このフローは、ディスカッションのようなシングル・サインオンに参加する他の宛先アプリケーションの場合と似ています。

図28-4 詳細なSAMLシングル・サインオンのコンポーネントとトポロジ(POSTプロファイルを構成)

図28-5は、WebCenter Portalとディスカッション・アプリケーションの間のSAML SSOフローを含む、POSTが構成されたSAML SSO構成の簡略化されたバージョンのコンポーネントとフローを示しています。

図28-5 SAMLシングル・サインオンのコンポーネントとトポロジ(POSTプロファイルを構成)

フローの手順は次のとおりです。

1. ユーザーのブラウザが、ユーザーの資格証明を入力して、WebCenter Portalドメイン(wc_domain)のWebLogic管理対象サーバー(WC_Portal)上にホストされているWebCenter Portal (ソース・サイト)にアクセスします。

2. WebCenter Portalが、認証サービス・プロバイダにユーザーの資格証明を渡します。

3. 認証に成功すると、認証されたセッションが確立されて、WebCenter Portalのようこそページが表示されます。

4. ユーザーがようこそページで、同じドメインの異なるWebLogic Server (WC_Collaboration)上にホストされているディスカッション宛先サイトのセキュアなWebページにアクセスするためのリンクをクリックします。これによって、構成されているサイト間転送サービス(ITS)サーブレットへのコールがトリガーされます。この場合は、ITSサーブレットが、WebCenter Portalと同じJSESSIONID Cookieを共有するソース・サイト内(つまり、WC_Portal管理対象サーバー上の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. ユーザーは再認証の必要なしで宛先サイト(ディスカッション)にログインします。

28.3.2 SAMLベースのシングル・サインオンの構成

この項では、一連の自動化されたスクリプトを使用して、SAMLベースのシングル・サインオンのためにWebCenter Portalと関連するサービスおよびコンポーネントを構成する方法を説明します。

この項には次のトピックが含まれます:

- SAMLシングル・サインオンの前提条件

- SAMLベースのSSOの構成

- 外部リーダーを使用したRSS用のSAML SSOの構成

- 構成のチェック

- SAML SSO構成の無効化

- SAML SSO構成の削除

28.3.2.1 SAMLシングル・サインオンの前提条件

この項では、SAMLベースのシングル・サインオンを構成する前に実行する必要がある一連の手順を説明します。これらの手順では、WebCenter Portalと関連付けられたコンポーネントがインストール済で、関連する接続が構成およびテスト済であることを前提としています。

SAMLベースのSSOの前提条件について、次のトピックで説明します。

- SAML SSO用のWebCenter Content Serverの構成

- SAML SSO用のディスカッション・サーバーの構成

- 証明書の構成とエクスポート

- SSLのセットアップ

28.3.2.1.1 SAML SSO用のWebCenter 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の編集の詳細は、「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>セクションにあることを確認します。

28.3.2.1.2 SAML SSO用のディスカッション・サーバーの構成

デフォルトでは、Oracle WebCenter Portalのディスカッション・サーバー用にデプロイされる.EARファイルは、フォームベースのOracle SSOまたはOracle Access Manager SSOをサポートします。したがって、Oracle WebCenter Portalのディスカッション・サーバーをSAMLベースのシングル・サインオン用に構成する前に、SAML SSOバージョンのディスカッション・サーバーの.EARファイルをデプロイすることが必要になります。

注意:

SSO用のディスカッション・サーバーを構成する前に、「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」の説明に従って、WebCenter Portalと同じアイデンティティ・ストアLDAPを使用するようにこれが構成されていることを確認してください。デフォルトの管理者アカウントを外部LDAPに移動しないことを選択した場合は、「外部LDAPを使用するためのディスカッション・サーバーの移行」の指示にも従ってください。

SAML SSOバージョンのOracle WebCenter Portalのディスカッション・サーバーをデプロイおよび構成する手順は次のとおりです。

1. WebLogic Server管理コンソールに管理者としてログインします。

WebLogic Server管理コンソールへのログインの詳細は、「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. 「Install this deployment as an application」を選択してから「Next」をクリックします。

7. 「名前」をowc_discussionsに設定します。

8. .EARファイルをデプロイします。

9. ディスカッション・サーバー管理コンソールに管理者としてログインします(ディスカッション・サーバー管理コンソールへのログインの詳細は、「SSO用のディスカッション・サーバーの構成」を参照してください)。

10. 「システム・プロパティ」ページを開き、owc_discussions.sso.modeプロパティを追加または編集(すでに存在している場合)して、その値をtrueに設定します。

11. (ディスカッション・サーバーがデプロイされた)WC_Collaboration管理対象サーバーを再起動します。

28.3.2.1.3 証明書の構成とエクスポート

SAMLのソース・サイトと宛先サイト間の通信を保護するために、通信を暗号化する必要があります。さらに、証明書を使用して、SAMLの対話時に他のパーティのアイデンティティを検証することが必要です。

次の例に示すように、getOpssService、listKeyStoreAliasesおよびexportKeyStoreCertificateのWLSTコマンドを使用して、SAMLアサーションの暗号化に使用するために選択した証明書を取得およびエクスポートします。必ずWebCenter Portalドメインの管理サーバーとWC_Portalに対して構成されたキーストア上でexportKeyStoreCertificateコマンドを実行するようにしてください。詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のキーストア・サービスを使用したキーと証明書の管理に関する項を参照してください。これらのコマンドの構文の詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のキーストア・サービスのコマンド・リファレンスに関する項を参照してください。

次の例では、デフォルトでWebLogic Serverに構成されているdemoidentityキーストアで使用可能なDemoIdentity証明書をエクスポートする方法を説明します。現在の環境で構成されているキーストアの証明書をリストしてエクスポートし、SAML構成で使用するためのガイドラインとして使用してください。

connect()
svc = getOpssService(name='KeyStoreService')
svc.listKeyStoreAliases(appStripe="system", name="demoidentity", password='DemoIdentityKeyStorePassPhrase', type="*")
svc.exportKeyStoreCertificate(appStripe='system', name='demoidentity', password='DemoIdentityKeyStorePassPhrase', alias='DemoIdentity',
type='Certificate', filepath='/tmp/demoidentity.der'

注意:
前述のfilepathに使用されるパスは、wcsamlsso.propertiesのcertPathの値に一致する必要があります。また、証明書はPEM/DER形式でのみエクスポートする必要があることに注意してください。

28.3.2.1.4 SSLの設定

トランスポートレベルのセキュリティを提供するためにWebCenter PortalのインストールでSSLを必要とする場合は、「SSLの構成」で説明されているようにシングル・サインオンを構成する前にSSLを構成する必要があります。SSLのセットアップはSSOの有効化とは無関係であることに注意してください。

28.3.2.2 SAMLベースのSSOの構成

WebCenter Portalと環境に必要なサービスおよびコンポーネントをインストールしたら、この項で説明されているスクリプトを使用してSAMLベースのシングル・サインオンを構成します。

このスクリプトでは、次を構成することで、WebLogic環境にSAMLベースのシングル・サインオンをセットアップします。

- SAML資格証明マッピング・プロバイダ

- 必要なリライイング・パーティ

- ソース・サイトのフェデレーション・サービス

- SAMLアイデンティティ・アサータ

- 必要なアサーティング・パーティ

- 宛先サイトのフェデレーション・サービス

この項には次のトピックが含まれます:

- シングル・サインオンのスクリプト

- スクリプトの使用

28.3.2.2.1 シングル・サインオンのスクリプト

WebCenter Portalおよび関連するアプリケーション用にSAML 1.1 SSOを構成するためのシングル・サインオン・スクリプトは、WCP_ORACLE_HOME/webcenter/scripts/samlssoフォルダに格納されています。SAMLの構成に関係するのは、次のファイルです。

- wcsamlsso.properties

- configureSpaces.py

- configureCollab.py

- configureUtilities.py

- configureSOA.py

- configureUCM.py

- configureREST.py

- configureForum.py

- configureWorklistIntegration.py

- configureCS.py

- configureBPM.py

wcsamlsso.properties

このプロパティ・ファイル(WCP_ORACLE_HOME/webcenter/scripts/samlsso/wcsamlsso.properties)は、SAML SSOのセットアップに必要な構成情報をカプセル化します。構成スクリプトを実行する前に、プロパティ・ファイルをWCP_ORACLE_HOME/common/binフォルダにコピーし、ディレクトリをそのフォルダに変更して、次で説明するようにwcsamlsso.propertiesを編集します。

プロパティ・ファイルには次のセクションがあります。

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がインストールされ、ポータル・ワークフローが有効化されている場合は、このセクションを指定してください。詳細は、「WebCenter PortalワークフローをホスティングするBPELサーバーの指定」を参照してください。

- worklist_integration - ワークリスト統合アプリケーションURL。soa_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層を使用して両方にアクセスする必要があります。

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)

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)。

configureBPM.py

Oracle BPMワークリストのアサーティングおよびリライイング・パーティを構成するための実行可能スクリプト(WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureBPM.py)。

28.3.2.2.2 スクリプトの使用

SAMLベースのシングル・サインオンを構成するスクリプトを使用する手順は次のとおりです。

注意:

スクリプトの実行中に構成ミスによるエラーが発生した場合、SAML SSO構成は未完了の状態で終了する可能性があります。提供された構成スクリプトを再実行できない場合は、「SAML SSO構成の削除」の説明に従って、構成を再試行する前にSAML SSOアーティファクトをクリーンアップする必要があります。

1. この構成で使用されるすべてのドメインの管理サーバーが稼働中であることを確認してください。

2. プロパティ・ファイルを適用するため、WCP_ORACLE_HOME/common/binからstoreUserConfig WLSTコマンドを使用して、様々なドメインの接続情報を含む構成およびキー・ファイルを生成します。使用方法と構文の詳細は、コマンド行のヘルプ(help('storeUserConfig'))を使用してください。

a. WLSTを使用し、管理ユーザー名とパスワードを使用してWebCenter Portalドメインに接続し、次のコマンドを実行します。
storeUserConfig('spacesconfig.secure', 'spaceskey.secure')

これによってユーザー構成ファイルと関連するキー・ファイルが作成されます。ユーザー構成ファイルには、暗号化されたユーザー名とパスワードが含まれます。キー・ファイルには、ユーザー名とパスワードの暗号化と復号化に使用される秘密鍵が含まれます。前述のコマンドは、WLSTを呼び出したディレクトリに構成およびキー・ファイルを格納します。または、より安全なパスをオプションで指定できます。

b. 管理ユーザー名とパスワードを使用してコラボレーション・ドメインに接続した後で、手順2aを繰り返します。ユーティリティ・サーバーがWebCenter Portalと同じドメイン(wc_domain)内にある場合でも、WebCenter Portalドメインに接続し、このコマンドを実行する必要があります。
storeUserConfig('collabconfig.secure', 'collabkeykey.secure')

c. 管理ユーザー名とパスワードを使用してユーティリティ・ドメインに接続した後で、手順2aを繰り返します。ユーティリティ・サーバーがWebCenter Portalと同じドメイン(wc_domain)内にある場合でも、WebCenter Portalドメインに接続し、このコマンドを実行する必要があります。
storeUserConfig('utilitiesconfig.secure', 'utilitieskey.secure')

d. 管理ユーザー名とパスワードを使用してSOAドメインに接続した後で、手順2aを繰り返します。WebCenter Portalと同じドメインにSOAがインストールされていても、WebCenter Portalドメインに接続してこのコマンドを実行する必要があります。
storeUserConfig('soaconfig.secure', 'soakey.secure')

e. 管理ユーザー名とパスワードを使用して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を編集して、セットアップに適用されるセクションを指定します。プロパティ・ファイルのセクションの詳細な説明は、「シングル・サインオンのスクリプト」を参照してください。

5. WCP_ORACLE_HOME/common/binからWLSTを起動して、次に示された順番でスクリプトを実行します。

注意:

スクリプトには明示的な接続コマンドが含まれているので、スクリプトはWLSTオフライン・モードで実行してください。

a. execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureSpaces.py')
WebCenter Portalドメインの管理サーバーを含むすべてのサーバーを再起動します。

b. ディスカッション・サーバーをセットアップしてある場合は、configureCollab.pyスクリプトを実行します。
execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureCollab.py')

ディスカッションがWebCenter Portalと同じドメインに属している場合は、WC_Collaboration管理対象サーバーのみを再起動します。そうでない場合は、コラボレーション・ドメインの管理サーバーを含むすべてのサーバーを再起動します。

c. ユーティリティ・サーバーをセットアップしてある場合は、configureUtilities.pyスクリプトを実行します。
execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureUtilities.py')

ユーティリティ・サーバーがWebCenter Portalと同じドメインに属している場合は、WC_Utilitiesサーバーのみを再起動します。そうでない場合は、ユーティリティ・ドメインの管理サーバーを含むすべてのサーバーを再起動します。

d. WebCenter PortalのSOAサーバー接続を構成してある場合は、configureSOA.pyスクリプトを実行します。
execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureSOA.py')

SOAドメインの管理サーバーを含むすべてのサーバーを再起動します。

e. 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/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がインストールされている場合はこれを行ってください。再起動は不要です。

execfile('<WCP_ORACLE_HOME>/webcenter/scripts/samlsso/configureBPM.py') - セットアップにOracle BPMワークリストがインストールされている場合はこれを行ってください。再起動は不要です。

7. 「構成のチェック」の手順を使用して、インストールをチェックします。

注意:

プロパティ・ファイルには機密情報が含まれているので、SAML SSOセットアップの構成および検証後に<WCP_ORACLE_HOME>/common/binからこれを削除してください。また、前述の手順2で生成した構成ファイルとキー・ファイルも削除してください。

注意:

スクリプトの実行中にエラーが発生した場合は、スクリプトを再実行する前に、「SAML SSO構成の削除」の説明に従って、スクリプトによってセットアップされたアサーティングおよびリライイング・パーティを削除する必要があります。

古いSAML SSO構成を削除したら、スクリプトを再実行してください。

28.3.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のアサーティング・パーティを無効化または削除します。

28.3.2.4 構成のチェック

次の手順に従って、シングル・サインオン構成が正しく動作することをチェックします。

シングル・サインオン構成をテストする手順は次のとおりです。

1. 新しいブラウザを使用して、WebCenter Portalにログインし、「ポータル設定」→「サービス」→「ディスカッション」の「フォーラム管理」をクリックしても、資格証明についてチャレンジされないことをチェックします(このサービスがポータル用にプロビジョニングされていると仮定します)。

2. ディスカッションまたはワークリスト・タスク・フローからRSSリンクにアクセスして、ログインのためにチャレンジされないことをチェックします。

3. Content Serverの場合は、プロファイル・ユーザー・インタフェースに移動し、ログインをチャレンジされずに、iFrame内に埋め込まれている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_Portalサーバーおよび宛先サイトをホストしているサーバーのロギングも有効化します。ログは$domain.home/servers/<server>/logs/<server>.logで使用可能です。WC_Portalおよび他のアプリケーション・サーバーのロギングの有効化方法の詳細は、「WebCenter Portalログの表示および構成」を参照してください。スクリプトを再実行する前に、「SAML SSO構成の削除」の説明に従って、SAML SSO構成を削除します。

28.3.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構成を削除します。

a. WLSドメインのWLS管理コンソールにログインします。

b. セキュリティ・レルムを開き、「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」を選択して、表示されたアサーティング・パーティをすべて無効にします。

5. アプリケーションを開き、サインインを要求されないことをチェックして、SAML SSO構成が無効になっていることを確認します。

28.3.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構成を削除します。

a. WLSドメインのWLS管理コンソールにログインします。

b. セキュリティ・レルムを開き、「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」を選択して、表示されたアサーティング・パーティをすべて削除します。

c. 「プロバイダ」→「認証」→「wcsamlia」→「管理」→「証明書」に移動し、そこで証明書をすべて削除します。

d. 「プロバイダ」→「認証」→「wcsamlia」に移動し、SAMLアイデンティティ・アサータを削除します。

e. WLSドメイン全体を再起動します。

9. アプリケーションを開き、サインインを要求されないことをチェックして、SAML SSO構成が削除されていることを確認します。これで、スクリプトを再度安全に使用して、SAML SSOを再構成できるようになります。

28.4 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クライアントの使用の詳細は、第25章「Microsoft Office統合の管理」を参照してください。

プラットフォームを越えた認証は、元々Windowsシステム間で行われているKerberosプロトコルを使用した認証サービスをエミュレートすることで実現されます。クロスプラットフォーム認証を有効にするためには、非Windowsサーバー(この場合はWebLogic Server)は、認証に使用されるKerberosトークンを抽出するためにSPNEGOトークンを解析する必要があります。

この項には次のサブセクションが含まれます:

- MicrosoftクライアントSSOの概念

- システム要件

- Microsoftクライアントの構成

28.4.1 MicrosoftクライアントSSOの概念

Kerberosの理解

Kerberosは、ネットワークのサービスに対するリクエストを認証するためのセキュアな方法です。Kerberosプロトコルは、クライアント、サーバーおよびそれらを仲介するKDC(Key Distribution Center)という信頼できるサード・パーティの3つのパーティから構成されます。Kerberosでは、ユーザーがそのアイデンティティを証明するKerberosチケットをサーバーに提供できる場合は、サーバーはユーザーがそのサービスにアクセスすることを許可します。ユーザーとサービスの両方が、KDCに登録された鍵を持つ必要があります。

次の図は、クライアントがサーバーに接続する前に行われる必要がある基本的なやり取りを示しています。

図28-6 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が処理します。)

図28-7 SPNEGOベースの認証

28.4.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フレームワーク1.1および適切に構成されたWebサービス・クライアント。

注意:

クライアントはWindows 2000のドメインにログオンしていて、そのドメイン内のActive Directoryサーバーから取得したKerberosの資格証明を保持している必要があります。ローカル・ログインは機能しません。

28.4.3 Microsoftクライアントの構成

MicrosoftクライアントでSSOを構成するには、図28-8に示されているMicrosoft Active Directory、MicrosoftクライアントおよびWebLogic Serverドメインを構成する必要があります。構成手順とトラブルシューティングの詳細は、『Oracle WebLogic Serverセキュリティの管理12c (12.2.1)』のMicrosoftクライアントでのシングル・サインオンの構成に関する項を参照してください。

図28-8 MicrosoftクライアントでのSSOの構成

SSO用にMicrosoftクライアントを構成するには:

1. Kerberosを使用するようにネットワーク・ドメインを構成します。

2. WebLogic Server用にKerberos識別情報を作成します。

a. WebLogic Serverの動作するホスト用にActive Directoryのユーザー・アカウントを作成します。

b. 作成したアカウント用にサービス・プリンシパル名を作成します。

c. このアカウントのユーザー・マッピングとキータブ・ファイルを作成します(『Oracle WebLogic Serverセキュリティの管理12c (12.2.1)』のMicrosoftクライアントでのシングル・サインオンの構成に関する項を参照)。

3. ブラウザ・クライアント(Internet ExplorerまたはMozilla Firefox)を選択し、Kerberosトークンを使用するようにそれを構成します(Oracle Argus Insightインストレーション・ガイドのKerberosトークンを返すためのブラウザの構成に関する項を参照)。

4. Kerberos認証を使用するようにWebLogic Serverドメイン(この場合はwc_domain)をセットアップします。

a. MicrosoftドメインのActive Directoryサーバーと手順2で作成したキータブ・ファイルをポイントするJAASログイン・ファイルを作成します(『Oracle WebLogic Serverセキュリティの管理12c (12.2.1)』のJAASログイン・ファイルの作成に関する項を参照)。

b. WebLogic Serverセキュリティ・レルムでネゴシエート・アイデンティティ・アサーション・プロバイダを構成します(「ネゴシエート・アイデンティティ・アサーション・プロバイダの構成」を参照)。

c. Active Directoryオーセンティケータを使用するようにWebLogic Serverドメインを構成して、WebLogicドメインがアイデンティティ・ストアと同じActive Directoryドメインを使用するようにします。または、別のアイデンティティ・ストアを使用して、このストアのユーザーをドメインのActive Directoryユーザーと照合することもできますが、2つの異なるアイデンティティ・ストアを使用すると同期が失われる危険性があるため、Active Directoryオーセンティケータを使用することをお薦めします(「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_Portal server without going through OHS)
-Dnon_sso_host=example.com (the host for the WLS WC_Portal server)
-Dnon_sso_port=8888 (the port for the WLS WC_Portal server)
-Dsso_base_url=http://example.com:7777 (the URL for accessing the WC_Portal server through OHS)

non_sso値は、プロトコル、ホストおよびポートについてのマシン上の値です。sso値は、OHSを通してルーティングされた際にユーザーに表示される値です。

6. WebCenter Portalに対しては、「仮想ホストを使用したSSOの構成」の説明に従って、WebCenter Portal用のOracle WebLogic Serverにリクエストを転送するようにWeb層OHSを構成します。

7. 手順5で指定した起動引数を使用して、WebLogic Server (管理サーバーおよび管理対象サーバー)を再起動します。SOAドメインに対して手順4、5および6を繰り返し、SOAアプリケーションでのシングル・サインオンを有効化します。

8. OHSを再起動して変更を有効にします。

9. ディスカッション・サーバーを構成します(「SSO用のディスカッション・サーバーの構成」を参照)。

28.4.3.1 ネゴシエート・アイデンティティ・アサーション・プロバイダの構成

この項では、ネゴシエート・アイデンティティ・アサーション・プロバイダの作成および構成手順を説明します。ネゴシエーションIDアサーション・プロバイダを使用すると、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管理コンソールへのログインの詳細は、「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。

「セキュリティ・レルムのサマリー」ペインが表示されます。

3. セキュリティ・レルムをクリックします。

セキュリティ・レルムの「設定」ページが表示されます。

4. 「プロバイダ」タブを開き、「認証」サブタブを選択します。

「認証設定」ペインが表示されます。

5. 「新規」をクリックします。

「新しい認証プロバイダの作成」ペインが表示されます。

6. アイデンティティ・アサータの「名前」を入力し、「タイプ」としてNegotiateIdentityAsserterを選択します。

7. 「OK」をクリックします。

28.4.3.2 Active Directory認証プロバイダの構成

次の手順に従って、WebLogic管理コンソールを使用してActive Directory認証プロバイダを構成します。

Active Directory認証プロバイダを構成するには:

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」をクリックします。
「セキュリティ・レルムのサマリー」ペインが表示されます。

3. セキュリティ・レルムをクリックします。
セキュリティ・レルムの「設定」ページが表示されます。

4. 「プロバイダ」タブを開き、「認証」サブタブを選択します。
「認証設定」ペインが表示されます。

5. 「新規」をクリックします。
「新しい認証プロバイダの作成」ペインが表示されます。

6. 認証プロバイダの「名前」を入力し、「タイプ」としてActiveDirectoryAuthenticatorを選択します。

7. 「OK」をクリックします。

8. プロバイダのリストで、今作成した認証プロバイダをクリックします。
プロバイダの「設定」ページが表示されます。

9. 「構成」タブを開き、「共通」サブタブを開きます。

10. 「制御フラグ」をSUFFICIENTに設定して、「保存」をクリックします。

注意:

他のすべてのオーセンティケータの制御フラグの設定も、SUFFICIENTに変更する必要があります。制御フラグがREQUIREDに設定された既存のデフォルト・オーセンティケータがある場合は、これをSUFFICIENTに変更する必要があります。

11. 「プロバイダ固有」サブタブを開きます。
プロバイダ固有の設定ペインが表示されます。

12. 次の表に示されているように、各フィールドに値を入力します。これら以外のフィールドは、デフォルト値のままにします。

表28-2 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に設定されていることを確認します。

a. ネゴシエート・アイデンティティ・アサータ

b. ActiveDirectoryAuthenticator (SUFFICIENT)

c. DefaultAuthenticator (SUFFICIENT)

d. 他のオーセンティケータ

28.4.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_Portalサーバーの起動時にoracle.webcenter.spaces.osso=trueフラグを使用することをお薦めします。このフラグはSSOが使用されていることをWebCenter Portalに告げるため、デフォルトのランディング・ページにログイン・フォームは表示されなくなります。かわりに、ユーザーが自動的にログインしてSSO認証を起動するためのログイン・リンクが表示されます。WNA用に構成されたWindowsネットワーク内でFirefoxを使用してWebCenter Portalにアクセスする場合、またはWindowsネットワーク・ドメインの外側からいずれかのブラウザを使用してWebCenter Portalにアクセスする場合は、ユーザーがこのログイン・リンクをクリックするとログイン・ページが表示されます。

28.4.3.4 SSO用のディスカッション・サーバーの構成

この項では、シングル・サインオン用のディスカッション・サーバーを構成する方法を説明します。SSO用のディスカッション・サーバーを構成する前に、「外部LDAPを使用するためのディスカッション・サーバーの移行」の説明に従って、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に設定します)。

28.5 仮想ホストを使用したSSOの構成

この項では、コンテキスト・ルートとして/を使用するアプリケーションを含む環境に必要なOHS構成と、シングル・サインオンが呼び出される際にOHSで必要な追加構成について説明します。

この項には次のサブセクションが含まれます:

- 仮想ホストの必要性の理解

- OAM 11g用の仮想ホストの構成

28.5.1 仮想ホストの必要性の理解

仮想ホストという用語は、1台のマシン上で複数のWebサイト(www.company1.comとwww.company2.comなど)を実行することを示します。仮想ホストはIPベース(それぞれのWebホストごとに異なるIPアドレスを持つこと)にすることも、名前ベース(各IPアドレスに複数の名前を持つこと)にすることもできます。それらが同じ物理サーバー上で動作しているという事実は、エンド・ユーザーにはわかりません。仮想ホストの詳細は、Apacheのドキュメントを参照してください。

28.5.2 OAM 11g用の仮想ホストの構成

仮想ホスト用にOAM 11gを構成するには、BASIC認証のみをサポートするアプリケーションやシングル・サインオンを必要としないアプリケーションについてシングル・サインオンをバイパスする必要があります。

これらの手順を完了する前に、「Oracle Access Managerの構成」に示されている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などの他のアプリケーションでは、シングル・サインオンが必要なため、この仮想ホストからそれらのアプリケーションへのアクセスは拒否されます。

29 SSLの構成

この章では、Oracle WebCenter PortalおよびコンポーネントをSSLで保護する方法を説明します。

この章の内容は次のとおりです。

- SSLを使用したブラウザからWebCenter Portalへの接続の保護

- SSLを使用したOracle HTTP ServerからWebCenter Portalへの接続の保護

- SSLを使用したブラウザからディスカッションへの接続の保護

- SSLを使用したWebCenter Portalからポートレット・プロデューサへの接続の保護

- WebCenter PortalからLDAPアイデンティティ・ストアへの接続の保護

- SSLを使用したWebCenter PortalからContent Serverへの接続の保護

- SSLを使用したWebCenter PortalからIMAPおよびSMTPへの接続の保護

- SSLを使用したOracle SESへの接続の保護

- SSLを使用したWebCenter Portalから外部BPELサーバーへの接続の保護

注意:

次のサービスやアプリケーションでは、メッセージ保護付きのWS-Securityを使用できるため、SSLのためのハード要件はありません。

- BPELサーバー - Oracle BPM Worklist

- WSRPプロデューサ

- ディスカッションおよびお知らせ

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。

「管理操作、ロールおよびツールの理解」も参照してください。

29.1 SSLを使用したブラウザからWebCenter Portalへの接続の保護

この項では、WebCenter Portalで使用するOracle Platform Security Services (OPSS)キーストア・サービスの構成方法の概要を説明します。これにはFusion Middleware Controlも使用できますが、このドキュメントの範囲はWLSTの使用方法に制限されています。

注意:

デフォルトのJavaキーストア・サービス(JKS)は、Oracle Platform Security Services (OPSS)キーストア・サービスに置き換えられます。WC_Portalをサーバーとして、およびOPSSをキーストア・サービスとして使用します。

WebLogic Server環境でのSSL構成の詳細および手順は、『Oracle Platform Security Servicesによるアプリケーションの保護』のキーストア・サービスを使用したキーと証明書の管理に関する項を参照してください。

OPSSキーストア・サービスでは、メッセージ・セキュリティを確保するためにキーおよび証明書を管理する代替の方式が提供されています。OPSSキーストア・サービスは、ドメイン内のすべてのサーバーのキーと証明書を一元的に管理および保存することで、証明書とキーの使用を容易にします。OPSSキーストア・サービスを使用して、KSSタイプのキーストアを作成して管理します。

SSLを使用したブラウザからWebCenter Portalへの接続の保護は、次の手順で構成されます。

- カスタム・キーストアの作成

- カスタム・アイデンティティ・キーストアおよびカスタム信頼キーストアの構成

- SSL接続の構成

注意:

構成プロセスの概要は、この項で説明されています。詳細および手順は、『Oracle Platform Security Servicesによるアプリケーションの保護』のキーストア・サービスを使用したSSLの構成に関する項を参照してください。

29.1.1 カスタム・キーストアの作成

最初の手順では、WebCenter Portalにカスタム・キーストアを生成します。

キーストア・サービスを構成する手順:

1. WLSTコンソールを使用して、WebLogic Serverに接続します。

connect('username','password','hostname:port')

2. OPSSサービスの参照名を取得します。

svc = getOpssService(name='KeyStoreService')

3. 新しいキーストアを作成します。

注意:
システム・ストライプにキーストアを作成し、その権限をfalseに設定する必要があります。

次のコマンドを入力します。

svc.createKeyStore(appStripe='system', name='webcenter_wls', password='password', permission=false)

ここで:

- svc = getOpssService()へのコールによって取得したサービス・コマンド・オブジェクト

- appStripe = キーストアが作成されるストライプの名前

- name = キーストアの名前

- password = キーストアのパスワード

- permission = 権限とパスワードの両方によって保護する場合はfalse (キーストアを権限のみで保護する場合はtrue)

4. キー・ペアを生成します。

実際の別名、ドメイン名および資格証明を使用します。次の例では、デフォルトのCA署名証明書も使用します。

svc.generateKeyPair(appStripe='system', name='webcenter_wls', password='password', dn='cn=webcenteridentity,dc=example,dc=com', keysize='2048', alias='webcenter_wls',  keypassword='password')

ここで:

- svc = getOpssService()へのコールによって取得したサービス・コマンド・オブジェクト

- appStripe = キーストアを含むストライプの名前

- name = キー・ペアが生成されるキーストアの名前

- password = キーストアのパスワード

- dn = キー・ペアをラップする証明書の識別名

- keysize = キーのサイズ

- alias = キー・ペア・エントリの別名

- keypassword = キーのパスワード

5. (オプション)次のコマンドを使用して、キーストアとキーストア内の別名をリストします。

svc.listKeyStores(appStripe='*')

これにより、system/webcenter_wlsがリストされます。

ここで:

- svc = getOpssService()へのコールによって取得したサービス・コマンド・オブジェクト

- appStripe = キーストアをリストするストライプの名前

次のように入力します。

svc.listKeyStoreAliases(appStripe="system",name="webcenter_wls", password="password", type="*")

これにより、別名webcenter_wlsがリストされます。

ここで:

- svc = getOpssService()へのコールによって取得したサービス・コマンド・オブジェクト

- appStripe = キーストアを含むストライプの名前

- name = キーストアの名前

- password = キーストアのパスワード

- type = 別名をリストするエントリのタイプ。有効な値は、Certificate、TrustedCertificate、SecretKeyまたは*です

6. 次のsyncKeyStoresコマンドを実行します。

syncKeyStores(appStripe='system', keystoreFormat='KSS')

7. WC_Portal管理対象サーバーを再起動します。

29.1.2 カスタム・アイデンティティ・キーストアおよびカスタム信頼キーストアの構成

アイデンティティ・キーストアおよび信頼キーストアの構成方法の概要は、『Oracle WebLogic Serverセキュリティの管理12c (12.2.1)』のカスタム・アイデンティティおよびカスタム信頼に対するOPSSキーストア・サービスの構成の主な手順に関する項を参照してください。

次の手順では、WebCenter Portalサーバーに、カスタム・アイデンティティ・キーストアおよびカスタム信頼キーストアを構成します。

IDキーストアおよび信頼キーストアを構成するには:

1. WebLogic Server管理コンソールにログインします。

WebLogic Server管理コンソールへのログインの詳細は、「Oracle WebLogic Server管理コンソール」を参照してください。

2. アイデンティティ・キーストアおよび信頼キーストアを構成するWebCenter Portalサーバー(WC_Portal)をクリックします。

WebCenter Portalサーバーの「設定」ペインが開きます。

3. 「構成」タブ、「キーストア」サブタブの順に開きます。
「キーストア」ペインが開きます。

4. 「変更」をクリックします。

5. 「キーストア」として「カスタム・アイデンティティとカスタム信頼」を選択し、「保存」をクリックします。

6. 「アイデンティティ」の下で、「SSLを使用したブラウザからWebCenter Portalへの接続の保護」で作成したカスタム・アイデンティティ・キーストアのパスとファイル名を入力します。
「SSLを使用したブラウザからWebCenter Portalへの接続の保護」の例を使用する場合は、kss://system/webcenter_wlsを入力します
ここで

- alias = system

- keystore_alias_name = webcenter_wls

7. 「カスタム・アイデンティティ・キーストアのタイプ」として、KSSと入力します。

8. カスタム・アイデンティティ・キーストアのパスワードを入力し、確認のためにもう一度入力します。

9. 「信頼」の下で、「カスタム信頼キーストア」をkss://system/trustに設定します。

10. 「カスタム信頼キーストアのタイプ」にKSSと入力し、「保存」をクリックしてエントリを保存します。

11. 「SSL」タブを開きます。

12. 「秘密鍵の別名」(webcenter_wlsなど)および「秘密鍵のパスフレーズ」(welcome1など)を入力し、「保存」をクリックしてエントリを保存します。

29.1.3 SSL接続の構成

SSL接続の構成の概要は、『Oracle WebLogic Serverセキュリティの管理12c (12.2.1)』のアウトバウンドSSL接続のクライアント証明書の指定に関する項を参照してください。

SSL接続を構成するには:

1. WebCenter Portalサーバーの「設定」ペインで、「構成」タブ、「全般」サブタブの順に開きます。

「一般構成」ペインが表示されます。

2. 「SSLリスニング・ポートの有効化」を選択します。

3. SSLリスニング・ポート番号を入力し、「保存」をクリックします。

4. 「構成」タブで、「SSL」サブタブを開き、ページの下部にある「詳細」オプションを開きます。

SSLの詳細オプションが表示されます。

5. 「相互クライアント証明書の動作」オプションを「クライアント証明書をリクエストしない」に設定し、「保存」をクリックします。

6. 「設定」ペインの「制御」タブを開き、「起動と停止」サブタブを選択します。

7. 「SSLの再起動」をクリックします。

8. WebLogic Serverを再起動し、SSL WebCenter Portal URLを開きます。
開発環境またはテスト環境の場合のみ(つまり、本番環境ではない場合)、証明書内のホスト名が実際のホスト名に一致しないときは、サーバーを次のコマンドで起動する必要があります。
-Dweblogic.security.SSL.ignoreHostnameVerification=true

9. セッションの証明書を受け入れ、ログインします。

29.2 SSLを使用したOracle HTTP ServerからWebCenter Portalへの接続の保護

Oracle HTTP Server (OHS)とWebCenter Portalとの間の接続の保護については、次の各項で説明しています。

- カスタム・アイデンティティ・キーストアおよびカスタム信頼キーストアの構成

- SSL接続の構成

- WebCenter PortalポートからHTTP Serverへのワイヤリング

- SSL証明書の構成

29.2.1 WebCenter PortalポートからHTTP Serverへのワイヤリング

WebCenter PortalポートからHTTP Serverにワイヤリングする手順は次のとおりです。

1. OHS 12cをインストールして構成します(『Oracle HTTP Serverのインストールと構成』のOracle HTTP Serverソフトウェアのインストールに関する項を参照してください)。
デフォルトでは、SSLポートを使用して構成されています。

2. ファイルDOMAIN_HOME/config/fmwconfig/components/OHS/instances/ohs1/mod_wl_ohs.confを開きます。

3. WebCenter URLをmod_wl_ohs.confに追加して、WebCenter PortalがOHSと連動するようにします。

<Location/webcenter>
SetHandler weblogic-handler
WebLogicHost host_id
WebLogicPort port
</Location>

host_idおよびportをWebLogicサーバーIDおよびポート番号に置き換えます。

注意:
mod_wl_ohsを使用する場合は、『Oracle WebLogic Serverプロキシ・プラグイン12.2.1の使用』のOracle WebLogic Serverプロキシ・プラグインの構成の準備に関する項に記載されている前提条件を完了する必要があります。

4. ノード・マネージャを起動します。

DOMAIN_HOME/bin/startNodeManager.sh &

『Oracle HTTP Serverのインストールと構成』のノード・マネージャの起動に関する項を参照してください。

5. OHSサーバーを再起動します。

DOMAIN_HOME/bin/stopComponent.sh ohs1 & DOMAIN_HOME/bin/startComponent.sh ohs1

6. 次のURLが機能していることを確認します。

http://OHS_12c_installation_host:port

http://OHS_12c_installation_host:OHS_12c_installation_port/webcenter

7. OHS SSLを使用して、WebCenter SSLポートを構成します。

a. 次のURLをチェックして、OHS SSLポートが稼働中であることを確認します。

https://ohs_ssl_host:ohs_ssl_port

b. WebCenter SSLポートを構成するには、ファイルOHSのssl.confファイルを開きます(DOMAIN_HOME/config/fmwconfig/components/OHS/instances/ohs1/ssl.conf。

c. 次のエントリ(WebCenter SSLのホストおよびポート)をssl.confに追加して、WebCenter PortalがOHS SSLポートで実行されるようにします。

注意:
このスニペットは、</VirtualHost>タグの直前に挿入する必要があります(つまり、仮想ホスト・タグの末尾)。

<Location /webcenter>
SetHandler weblogic-handler
WebLogicHost host_id
WebLogicPort port
SecureProxy ON
WlSSLWallet /filepath/ohs12c/user_projects/domains/base_domain/config/fmwconfig/components/OHS/instances/ohs1/keystores/default
</Location>

8. OHSを再起動します。

29.2.2 SSL証明書の構成

WebCenter Portalの証明書を信頼するようにOHSを構成するには、WC_Portal証明書をOHSトラスト・ストアにインポートする必要があります。

SSL証明書を構成するには:

1. 次のWLSTを使用して、WC_Portalアイデンティティ・キーストアからWC_Portal証明書をエクスポートします。

svc = getOpssService(name='KeyStoreService')
svc.exportKeyStoreCertificate(appStripe='system', name='webcenter_wls', password='password', alias='webcenter_wls', type='TrustedCertificate', filepath='/filepath/certificate/webcenter.cer')

ここで:

- svc = getOpssService()へのコールによって取得したサービス・コマンド・オブジェクト

- appStripe = キーストアを含むストライプの名前

- name = キーストアの名前

- password = キーストアのパスワード

- type = 別名をリストするエントリのタイプ。有効な値は、Certificate、TrustedCertificateまたはCertificateChainです

- filepath = 証明書、信頼できる証明書または証明書チェーンのエクスポート先のファイルの絶対パス

2. この証明書をOHS側のウォレットにインポートします。
/domain_home/config/fmwconfig/components/OHS/instances/ohs1/keystores/defaultに移動し、次のorapkiコマンドを実行します(通常はIDM_HOMEに配置されている)。

setenv JAVA_HOME /Java_install_location/jdk1.8.0_40/
/OHS_install_location/oracle_common/bin/orapki wallet add -wallet . -trusted_cert -cert <webcenter_wls.cer location> -auto_login_only

3. OHS証明書を信頼するようにWebCenter Portalを構成するには、OHSウォレットからユーザー証明書をエクスポートして、それをWebLogicトラスト・ストアに信頼できる証明書としてインポートします。

/OHS_install_location/oracle_common/bin/orapki wallet display -wallet .
/OHS_install_location/oracle_common/bin/orapki wallet export -wallet . -cert cert.txt -dn 'dn_value'

ここで、dn_valueは、wallet display -walletコマンドで返される結果を指します。

4. OHS証明書をWC_Portal管理対象サーバーのトラスト・ストアにインポートします。

keytool -importcert -alias ohs_cert -file wls_java_home/jre/lib/security/cacerts

ここで、wls_java_homeはWebLogic Javaホーム・ディレクトリを指し、keytoolはwls_java_home/jre/bin/keytoolにインストールされています。wls_java_homeのパスを見つけるには、domain_home/bin/setDomainEnv.sh (UNIX)またはdomain_home\bin\setDomainEnv.cmd (Windows)を実行できます。

5. WebCenterでは、WebLogicコンソールにログインして、WebLogicプラグインのチェック・ボックスが有効になっているかを確認します。

a. WebLogicコンソールにログインします。

b. 左側のナビゲーションでドメイン名をクリックします。

c. 「Webアプリケーション」タブをクリックします。

d. 「WebLogicプラグインの有効化」オプションを選択して、「保存」をクリックします。

6. OHSおよびWC_Portalサーバーを再起動します。

これで、SSL OHS URL (https://<ohs ssl host>:<ohs ssl port>/webcenter)にアクセスできるようになりました。

7. URLにアクセスした後、証明書を受け入れます。

29.3 SSLを使用したブラウザからディスカッションへの接続の保護

SSLを使用したブラウザからディスカッションへの接続の保護については、次の各項で説明しています。

- ディスカッションのカスタム・キーストアの作成

- ディスカッションのアイデンティティ・キーストアと信頼キーストアの構成

- ディスカッションのSSL接続の構成および保護

29.3.1 ディスカッションのカスタム・キーストアの作成

ディスカッションへの接続を保護するには、まず、次の手順に従ってカスタム・キーストアを生成します。

1. WLSTコンソールを使用して、WebLogic Serverに接続します。

connect('weblogic','password','host:port’)

2. OPSSサービス参照を取得します。

svc = getOpssService(name='KeyStoreService')

3. 新しいキーストアを作成します。

注意:
システム・ストライプにキーストアを作成し、その権限をfalseに設定する必要があります

svc.createKeyStore(appStripe='system', name='collab_wls', password='password', permission=false)

ここで:

- svc = getOpssService()へのコールによって取得したサービス・コマンド・オブジェクト

- appStripe = キーストアが作成されるストライプの名前

- name = キーストアの名前

- password = キーストアのパスワード

- permission = キーストアが権限によってのみ保護される場合はtrue、権限とパスワードの両方によって保護される場合はfalse

4. keytoolを使用して、キー・ペアを生成します。

svc.generateKeyPair(appStripe='system', name='collab_wls', password='password', dn='cn=collabidentity,dc=example,dc=com', keysize='2048', alias='collab_wls', keypassword='welcome1')

ここで:

- svc = getOpssService()へのコールによって取得したサービス・コマンド・オブジェクト

- appStripe = キーストアを含むストライプの名前

- name = キー・ペアが生成されるキーストアの名前

- password = キーストアのパスワード

- dn = キー・ペアをラップする証明書の識別名

- keysize = キーのサイズ

- alias = キー・ペア・エントリの別名

- keypassword = キーのパスワード

5. オプションで、キーストアとキーストア内の別名をリストします。

svc.listKeyStores(appStripe='*')

これにより、system/collab_wlsがリストされます。

ここで:

- svc = getOpssService()へのコールによって取得したサービス・コマンド・オブジェクト

- appStripe = キーストアをリストするストライプの名前

次のように入力します。

svc.listKeyStoreAliases(appStripe="system",name="collab_wls", password="password", type="*")

これにより、別名collab_wlsがリストされます

ここで:

- svc = getOpssService()へのコールによって取得したサービス・コマンド・オブジェクト

- appStripe = キーストアを含むストライプの名前

- name = キーストアの名前

- password = キーストアのパスワード

- type = 別名をリストするエントリのタイプ。有効な値は、Certificate、TrustedCertificate、SecretKeyまたは*です

6. syncKeyStoresを実行します。

syncKeyStores(appStripe='system', keystoreFormat='KSS')

29.3.2 ディスカッションのアイデンティティ・キーストアと信頼キーストアの構成

次の手順では、WebCenter Collaborationサーバーに、カスタム・アイデンティティ・キーストアとカスタム信頼キーストアを構成します。

ディスカッションのアイデンティティ・キーストアおよび信頼キーストアを構成する手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。

WebLogic Server管理コンソールへのログインの詳細は、「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「環境」を開き、「サーバー」をクリックします。

「サーバーのサマリー」ペインが表示されます。

3. アイデンティティ・キーストアおよび信頼キーストアを構成するWebCenter Collaborationサーバー(WC_Collaboration)をクリックします。

コラボレーション・サーバーの「設定」ペインが表示されます。

4. 「構成」タブ、「キーストア」サブタブの順に開きます。

「キーストア」ペインが表示されます。

5. 「変更」をクリックします。

6. 「キーストア」として「カスタム・アイデンティティとカスタム信頼」を選択し、「保存」をクリックします。

7. 「アイデンティティ」の下で、kss://system/collab_wls (「ディスカッションのカスタム・キーストアの作成」)で作成したカスタム・アイデンティティ・キーストアのパスとファイル名を入力します。

8. 「カスタム・アイデンティティ・キーストアのタイプ」として、KSSと入力します。

9. カスタム・アイデンティティ・キーストアのパスワードを入力し、確認のためにもう一度入力します(welcome1など)。

10. 「信頼」の下で、「カスタム信頼キーストア」をkss://system/trustに設定し、「保存」をクリックします。

11. 「カスタム信頼キーストアのタイプ」としてKSSを入力し、カスタム信頼キーストアのパスワードを入力し、確認のためにもう一度入力して、「保存」をクリックします。

12. WLS管理コンソールで、「サーバー」→「WC_Collaboration」に移動し、「構成」タブを開き、「SSL」サブタブを開きます。

13. 秘密鍵の別名(collab_wlsなど)を入力し、秘密鍵のパスワード(welcome1など)を設定します。

14. 「保存」をクリックしてエントリを保存します。

15. WebCenter Collaborationサーバー(WC_Collaboration)の「設定」ペインで、「構成」タブを開き、「全般」サブタブを開きます。

「一般構成」ペインが開きます。

16. 「SSLリスニング・ポートの有効化」を選択します。

17. SSLリスニング・ポート番号を入力し、「保存」をクリックします。

18. 「構成」タブで、「SSL」サブタブを開き、ページの下部にある「詳細」オプションを開きます。

19. 「相互クライアント証明書の動作」オプションが、「クライアント証明書をリクエストしない」に設定されていることを確認し、「保存」をクリックします。

20. 「制御」タブを開きます。

「制御設定」ペインが開きます。

21. 「SSLの再起動」をクリックします。

29.3.3 ディスカッションのSSL接続の構成および保護

ディスカッションのSSL接続を構成する手順は次のとおりです。

1. WebCenter Collaborationサーバー(WC_Collaborationサーバー)を再起動して、SSLコラボレーションURL (https://host:port/owc_discussions)を開きます。
URLにアクセスするときに、証明書が生成され、ブラウザに保存されます。

2. 証明書をダウンロードし、.PEMまたは.CRT形式で保存します。

3. 次のコマンドを使用して、JDK_HOME内のcacertsに証明書をインポートします。

keytool -importcert -alias collab_cert –file /filepath/sslcertificate/collabcert.crt –keystore..../oracle_common/jdk/jre/lib/security/cacerts

4. パスワードを求められたらchangeitを入力し、YESを入力します。

5. お知らせおよびディスカッションのために、Oracle Enterprise Managerでhttps://jiveのURLを登録します。

6. WC_Portal管理対象サーバーを再起動します。

7. お知らせおよびディスカッションをテストします。

29.4 SSLを使用したWebCenter Portalからポートレット・プロデューサへの接続の保護

SSLを使用したWSRPへの接続の保護については、次の各項で説明しています。

- ポートレット・プロデューサのカスタム・キーストアの作成

- ポートレット・プロデューサのアイデンティティ・キーストアと信頼キーストアの構成

- ポートレット・プロデューサのSSL接続の構成

- SSL対応WSRPプロデューサの登録およびポートレットの実行

29.4.1 ポートレット・プロデューサのカスタム・キーストアの作成

KSSキーストアを使用してWebCenterポートレットでSSLを構成するには、次の手順が必要です。

1. WLSTコンソールを使用して、WebLogic Serverに接続します。

connect('weblogic','password','host:port’)

2. OPSSサービス参照を取得します。

svc = getOpssService(name='KeyStoreService')

3. 新しいキーストアを作成します。

注意:
システム・ストライプにキーストアを作成し、その権限をfalseにする必要があります。

svc.createKeyStore(appStripe='system', name='portlet_wls', password='password', permission=false)
ここで:

- svc = getOpssService()へのコールによって取得したサービス・コマンド・オブジェクト

- appStripe = キーストアが作成されるストライプの名前

- name = キーストアの名前

- password = キーストアのパスワード

- permission = 権限とパスワードの両方によって保護する場合はfalse (キーストアを権限のみで保護する場合はtrue)

4. キー・ペアを生成します。

svc.generateKeyPair(appStripe='system', name='portlet_wls', password='password', dn='cn=customidentity,dc=example,dc=com', keysize='2048', alias='portlet_wls', keypassword='password')

ここで:

- svc = getOpssService()へのコールによって取得したサービス・コマンド・オブジェクト

- appStripe = キーストアを含むストライプの名前

- name = キー・ペアが生成されるキーストアの名前

- password = キーストアのパスワード

- dn = キー・ペアをラップする証明書の識別名

- keysize = キーのサイズ

- alias = キー・ペア・エントリの別名

- keypassword = キーのパスワード

5. オプションで、キーストアとキーストア内の別名をリストします。
これは、system/portlet_wlsをリストします:

svc.listKeyStores(appStripe='*')

- svc = getOpssService()へのコールによって取得したサービス・コマンド・オブジェクト

- appStripe = キーストアをリストするストライプの名前

これは、エイリアスportlet_wlsをリストします:

svc.listKeyStoreAliases(appStripe="system",name="portlet_wls", password="password", type="*")

- svc = getOpssService()へのコールによって取得したサービス・コマンド・オブジェクト

- appStripe = キーストアを含むストライプの名前

- name = キーストアの名前

- password = キーストアのパスワード

- type = 別名をリストするエントリのタイプ。有効な値は、Certificate、TrustedCertificate、SecretKeyまたは*です

6. syncKeyStoresを実行します。

syncKeyStores(appStripe='system', keystoreFormat='KSS')

29.4.2 ポートレット・プロデューサのアイデンティティ・キーストアと信頼キーストアの構成

次の手順では、WebCenterポートレット・サーバーに、カスタム・アイデンティティ・キーストアと信頼キーストアを構成します(WC_Portletなど)。

アイデンティティ・キーストアおよび信頼キーストアの構成方法の概要は、「SSLを使用したブラウザからWebCenter Portalへの接続の保護」を参照してください。

ポートレット・サーバーのアイデンティティ・キーストアと信頼キーストアを構成する手順は次のとおりです。

1. WebLogic Server管理コンソールにログインします。
WebLogic Server管理コンソールへのログインの詳細は、「Oracle WebLogic Server管理コンソール」を参照してください。

2. 「ドメイン構造」ペインで、「環境」を開き、「サーバー」をクリックします。
「サーバーのサマリー」ペインが表示されます。

3. アイデンティティ・キーストアおよび信頼キーストアを構成するWebCenterポートレット・サーバー(WC_Portletなど)をクリックします。
ポートレット・サーバーの「設定」ペインが表示されます。

4. 「構成」タブ、「キーストア」サブタブの順に開きます。
「キーストア」ペインが表示されます。

5. 「変更」をクリックします。

6. 「キーストア」として「カスタム・アイデンティティとカスタム信頼」を選択し、「保存」をクリックします

7. 「アイデンティティ」の下で、kss://system/portlet_wls (「ポートレット・プロデューサのカスタム・キーストアの作成」)で作成したカスタム・アイデンティティ・キーストアのパスとファイル名を入力します。

8. 「カスタム・アイデンティティ・キーストアのタイプ」として、KSSと入力します。

9. カスタム・アイデンティティ・キーストアのパスワードを入力し、確認のためにもう一度入力します(welcome1など)。

10. 「信頼」の下で、「カスタム信頼キーストア」をkss://system/trustに設定し、「保存」をクリックします。

11. 「カスタム信頼キーストアのタイプ」としてKSSを入力し、カスタム信頼キーストアのパスワードを入力し、確認のためにもう一度入力して、「保存」をクリックします。

12. 「SSL」タブを開きます。

13. 秘密鍵の別名(portlet_wlsなど)を入力し、秘密鍵のパスワード(welcome1など)を設定します。

14. 「保存」をクリックして、エントリを保存します。

注意:

ページレット・プロデューサでは、SSL構成のためにカスタム・アイデンティティおよびJava標準信頼キーストア・タイプを使用する必要があります。Java標準信頼キーストア(JKS)の構成方法の詳細は、『Oracle WebLogic Serverセキュリティの管理 12c (12.2.1)』のキーストアの構成に関する項 を参照してください。

29.4.3 ポートレット・プロデューサのSSL接続の構成

SSLを構成するには、『Oracle WebLogic Serverセキュリティの管理12c (12.2.1)』ガイドのWebLogic ServerにおけるSSLの構成の概要に関する項を参照してください。

ポートレット・サーバーのSSL接続を構成する手順は次のとおりです。

1. WebCenterポートレット・サーバー(WC_Portlet)の「設定」ペインで、「構成」タブを開き、「全般」サブタブを開きます。

2. 「SSLリスニング・ポートの有効化」を選択します。

3. SSLリスニング・ポート番号を入力します。

4. 「保存」をクリックします。

5. 「構成」→「SSL」を選択し、ページの下部にある「詳細」オプションを開きます。

6. 「相互クライアント証明書の動作」オプションが、「クライアント証明書をリクエストしない」に設定されていることを確認します。

7. 「保存」をクリックします。

8. 「制御」タブを開きます。

「制御設定」ペインが開きます。

9. 「SSLの再起動」をクリックします。

10. ポートレット・サーバー(WC_Portlet)を再起動して、SSL WSRPポートレットのURL (https://host:port/<context-root>/portlets/wsrp2?WSDL)を開きます。

11. セッションの証明書を受け入れ、WSDLをロードします。

29.4.4 SSL対応WSRPプロデューサの登録およびポートレットの実行

WebCenter Portalにポートレットを登録するために、WC_Portal管理対象サーバーを構成します。これは、JAVA_HOMEトラスト・ストア(/jdk/jre/lib/security/cacerts)内の証明書も使用します。

SSL対応WSRPプロデューサを登録し、ポートレットを実行する手順は次のとおりです。

1. SSL WSRPポートレットURL (https://host:port/<context-root>/portlets/wsrp2?WSDL)にアクセスしたときに、証明書が生成され、ブラウザに保存されています。

2. 証明書をダウンロードして、.PEMまたは.crt形式で保存します。

Firefox 3.0以降を使用して、証明書を直接.PEM形式にダウンロードします。他のブラウザの場合は、WebLogic Server der2pemツールを使用してPEM形式に変換します。der2pemツールの使用の詳細は、『Oracle WebLogic Serverコマンド・リファレンス』のder2pemに関する項を参照してください。

3. 次のkeytoolコマンドを使用して、/jdk/jre/lib/security内のcacertsファイルに証明書をインポートします。

keytool -importcert -alias portlet_cert -file portlet_pem -keystore cacerts

ここで:

- portlet_certは、ポートレット証明書の別名です。

- portlet_pemは、ポートレット証明書ファイルです(例: portlet_cert.pem)。

4. WC_Portalを再起動します。

5. SSL対応ポートレットURLを登録します。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')

6. HTTPまたはHTTPSのWebCenter Portal URLにナビゲートします。

7. ページを作成し、「ポートレット」リンクに移動します。

8. 登録済のWSRPプロデューサに移動します。

9. ポートレットをページに追加します。

10. ページの表示モードに変更して、WSRPポートレットが適切にレンダリングすることを確認します。

29.5 WebCenter PortalからLDAPアイデンティティ・ストアへの接続の保護

SSL用にLDAPサーバー・ポートを構成するには、LDAPサーバーの適切な管理ドキュメントを参照してください。Oracle Internet Directory (OID)ではデフォルトで、SSLポートがインストールされます。WebCenter PortalからLDAP通信にこのポートを使用するには、適切なオーセンティケータにより認証できるようにアイデンティティ・ストアを構成する必要があります。アイデンティティ・ストアに対してこの作業を行うための手順は、「アイデンティティ・ストアの構成」を参照してください。

Oracle WebLogicサーバーにとってCAが不明である場合は、次の各項で説明している追加手順を完了します。

- OID認証局(CA)のエクスポート

29.5.1 OID認証局(CA)のエクスポート

次の各トピックでは、OIDへのWebCenter Portal接続を保護する方法について説明します。

1. OIDでのSSLの有効化

2. OID証明書のインポート

3. SSL接続の確立

29.5.1.1 OIDでのSSLの有効化

このトピックでは、OIDでSSLを有効にする方法について説明します。

注意:

OIDはserver authモードで構成する必要があります。

1. 次のコマンドを実行して、Oracleウォレットを作成します。

<OID_INSTALL_LOC>/oracle_common/bin/orapki wallet create -wallet <wallet_location>/OID_Wallet -auto_login

注意:
要求されたら、パスワードを入力します。

各要素の意味は次のとおりです。

- <OID_INSTALL_LOC>はOIDがインストールされている場所です。
<wallet_location>はOID_Walletという名前の新しいウォレットを作成する場所です。ウォレットの場所を指定しない場合、新しいウォレットは、コマンドを実行する、現在のディレクトリ内に作成されます。

2. 次のコマンドを実行して、Oracleウォレットに証明書を追加します。

<OID_INSTALL_LOC>/oracle_common/bin/orapki wallet add -wallet -wallet <wallet_location>/OID_Wallet -dn cn=<Domain name> -keysize 2048 -self_signed -sign_alg sha1 -validity 1000

各要素の意味は次のとおりです。

- <OID_INSTALL_LOC>はOIDのインストール場所です。

- <wallet_location>はウォレットの場所です。

- cnはOIDサーバーがインストールされているドメインの名前です。/etc/hostsファイルからドメイン名を見つけることができます。
たとえば、cn=<Domain name>などです。

- -sign_algは署名アルゴリズムです。MD5は署名アルゴリズムのデフォルト値です。
JDKの最新バージョンであるJDK8はMD5アルゴリズムをサポートしないので、署名アルゴリズムにはsha1またはsha2を指定する必要があります。たとえば、sha1です。

- -self_signedは自己署名証明書です。
CAにより信頼された証明書を取得し、適切にインポートすることもできます。詳細は、「Secure Sockets Layer (SSL)の構成」を参照してください。

3. 次のコマンドを実行してOIDでSSLパラメータを構成します。

ldapmodify -h OID_host -p OID_port -D cn=OID_admin -w password
dn:cn=oid1,cn=osdldapd,cn=subconfigsubentry
changetype: modify
replace: orclsslauthentication
orclsslauthentication: 32
-
replace: orclsslwalleturl
orclsslwalleturl: file://<wallet_location>/OID_wallet

4. OIDサーバーを再起動します。

5. 次のコマンドを実行することで、SSL接続が正常に作成されたことを確認します。

./ldapbind -h OID_host -p OID_port -U 2 -W file://<wallet_location>/OID_Wallet  -P password

各要素の意味は次のとおりです。

- <wallet_location>/OID_Walletはウォレットの場所です。

6. 次のコマンドを実行して証明書をエクスポートします。

<OID_INSTALL_LOC>/oracle_common/bin/orapki wallet export -wallet /<wallet_location>/OID_Wallet -dn "cn=<Domain name>" -cert oid_trust.cer

各要素の意味は次のとおりです。

- <OID_install_LOC>/<wallet_location>/OID_Walletはウォレットの場所です。

- oid_trust.cerは証明書です。デフォルトでは、ウォレットの証明書は、コマンドが実行される現行ディレクトリに作成されます。パスを指定する場合、ウォレットの証明書は/OID_Install_LOC/oid_cert_trust.cerなどの指定された場所に作成されます。

29.5.1.2 OID証明書のインポート

このトピックでは、OID証明書をWebCenterのWebLogic Serverトラスト・ストアにインポートする方法について説明します。

注意:

この手順はWebCenter PortalサーバーがインストールされているWebLogicドメインで実行する必要があります。

1. 次のコマンドを使用して、証明書をWebCenter PortalのOracle WebLogic Server信頼ストアにインポートします。

keytool -importcert -v -trustcacerts -alias oid_server_trust -file oid_trust.cer -keystore cacerts -storepass changeit

注意:

cacertsパスは、次の手順で取得できます。

a. WebLogicコンソールにログインし、「サーバー」に移動し、WC_Portalサーバーをクリックします。

b. 「構成」をクリックし、「キーストア」サブタブをクリックします。

c. Java標準信頼キーストアで指定されたパスを確認します。

注意:

Java標準信頼キーストアで指定されたパスはcacertパスです。

2. Oracle WebLogic ServerでOIDを構成します。

詳細は、「Oracle Internet Directoryオーセンティケータの構成」を参照してください。

注意:

プロバイダ固有の情報を入力する場合は、SSLホストおよびポートを指定して、「SSLの有効化」チェック・ボックスを選択してください。

29.5.1.3 SSL接続の確立

このトピックでは、アイデンティティ・ストアとLDAPサーバー間にSSL接続を確立する方法について説明します。

注意:

この手順はWebCenter PortalサーバーがインストールされているWebLogicドメインで実行する必要があります。

1. 次のスクリプトを実行して、環境を設定します。

setenv WL_HOME <WCP_INSTALL_LOCATION>/wlserver
setenv ORACLE_HOME <WCP_ORACLE_HOME>
cd $WL_HOME/server/bin
./setWLSEnv.sh
cd $ORACLE_HOME/oracle_common/bin

2. 次のスクリプトを使用して、キーストアを作成します。

libovdconfig.sh -host wls_host -port wls_adminserver_port -userName
wls_user_name -domainPath full_path_domain_home -createKeystore

- hostはOracle WebLogic Serverホストです。

- portはOracle WebLogic Serverの管理サーバーのポートです。

- usernameはOracle WebLogic Serverの管理ユーザー名です。

- domainPathはドメイン・ホームへの完全パスです。

注意:
キーストアは次の場所に作成されます。keystore $DOMAIN_HOME/config/fmwconfig/ovd/default/keystores/adapters.jks

3. keytoolコマンドを使用して、証明書をキーストアにインポートします。adapters.jksという名前のキーストアに対する構文は次のとおりです。

以前に生成したOIDをエクスポートしたことを確認します。詳細は、「OIDでのSSLの有効化」を参照してください。

注意:

キーストアadapters.jksが手順2で作成されます。

$JAVA_HOME/bin/keytool -importcert
-keystore $DOMAIN_HOME/config/fmwconfig/ovd/default/keystores/adapters.jks
-storepass keystore_password_used_in_libovdconfig.sh
-alias alias_name
-file full_path_to_LDAPCert_file
-noprompt

4. Oracle WebLogic Serverと管理対象サーバーを再起動します。

5. WebCenter Portalにアクセスし、OIDユーザーとしてログインします。正常にログインできるようになります。

注意:
ホスト名の検証の例外を受信した場合、次のパラメータを設定します。

-Dweblogic.security.SSL.ignoreHostnameVerification=true

29.6 SSLを使用したWebCenter PortalからContent Serverへの接続の保護

リポジトリの接続を作成するコンテンツ・サーバーとWebCenter Portalアプリケーションが、同じシステム上または信頼できる同じプライベート・ネットワーク上にない場合、アイデンティティ伝播は保護されません。アイデンティティ伝播のセキュリティを確保するには、コンテンツ・サーバーのSSLも構成する必要があります。

SSLを使用したコンテンツ・サーバーの保護には、次のタスクが含まれます。

- WebCenter Portal (クライアント)側のキーストアおよびキーの構成

- コンテンツ・サーバー側のキーストアおよびキーの構成

- 信頼できるクライアントのシグネチャの確認

- アイデンティティ伝播の保護

本番環境では、実際の証明書のみを使用することをお薦めします。実際の証明書を使用する場合のキーストアの構成方法の詳細は、『Oracle WebCenter Contentの管理』のコンテンツ・サーバーのセキュリティ・プロバイダの理解に関する項を参照してください。

29.6.1 WebCenter Portal (クライアント)側のキーストアおよびキーの構成

アイデンティティ・キーストアおよび信頼キーストアの構成方法の概要は、「SSLを使用したブラウザからWebCenter Portalへの接続の保護」を参照してください。詳細およびステップごとの手順は、『Oracle WebLogic Serverセキュリティの管理 12c (12.2.1)』のSSLを使用したWebCenter Portalへの接続の保護に関する項を参照してください。

(クライアント)側のキーストアを構成する手順:

1. keytoolの場所(例: jdk/bin)に移動し、コマンド・プロンプトを開きます。

2. 次のkeytoolコマンドを実行して、クライアント・キーストアを生成します。

svc.generateKeyStore(appStripe='stripe1', name='keystore1', password='password', alias=Client private key alias dn='cn=client)

3. キーが正常に作成されたことを確認するために、オプションで次のkeytoolコマンドを実行できます。

svc.listKeyStoreAliases(appStripe="stripe1",name="keystore1", password='', type="*")

エイリアスClient private key aliasがリストされます

4. キーを使用するには、次のkeytoolコマンドを実行してキーに署名します。

5. 次のkeytoolコマンドを実行して、クライアントの公開鍵をエクスポートします。

exportKeyStore(appStripe='stripe1', name='keystore',
password='password', alias='Client private key alias', keypassword='keypass1',
filepath='client.pubkey')

29.6.2 コンテンツ・サーバー側のキーストアおよびキーの構成

アイデンティティ・キーストアおよび信頼キーストアの構成方法の概要は、「SSLを使用したブラウザからWebCenter Portalへの接続の保護」を参照してください。詳細およびステップごとの手順は、『Oracle WebLogic Serverセキュリティの管理 12c (12.2.1)』のSSLを使用したWebCenter Portalへの接続の保護に関する項を参照してください。

コンテンツ・サーバー側のキーストアを構成する手順:

1. keytoolの場所(例: jdk/bin)に移動し、コマンド・プロンプトを開きます。

2. 次のkeytoolコマンドを実行して、サーバー・キーストアを生成します。

svc.generateKeyPair(appStripe='stripe1', name='keystore', password='password', dn='cn=server', keysize='2048', alias='Server public key alias', keypassword='keypass1')

3. キーが正常に作成されたことを確認するには、次のkeytoolコマンドを実行します。

svc.listKeyStoreAliases(appStripe="stripe1",name="keystore1", password='', type="*")

エイリアスServer private key aliasがリストされます

4. キーを使用するには、次のkeytoolコマンドを実行してキーに署名します。

5. 次のkeytoolコマンドを実行して、サーバーの公開鍵をサーバー・キーストアにエクスポートします。

svc.exportKeyStore(appStripe='stripe1', name='keystore1', password='password', alias='Server public key alias', keypassword='keypass1', type='TrustedCertificate', filepath='server.pubkey')

29.6.3 信頼できるクライアントのシグネチャの検証

信頼できるクライアントのシグネチャを検証するには、クライアントの公開鍵をサーバー・キーストアにインポートします。

1. keytoolが配置されている場所に移動し、コマンド・プロンプトを開きます。

2. 信頼できるクライアントのシグネチャを検証するには、次のkeytoolコマンドを実行して、クライアントの公開鍵をサーバー・キーストアにインポートします。

importKeyStore(appStripe='stripe1', name='keystore1', password='password',
aliases='Client public key alias', keypasswords='keypass1',
type='TrustedCertificate', filepath='client.pubkey')

3. 次のkeytoolコマンドを実行して、サーバーの公開鍵をクライアント・キーストアにインポートします。

importKeyStore(appStripe='stripe1', name='keystore1', password='password',
aliases='Server public key alias', keypasswords='keypass1',
type='TrustedCertificate', filepath='server.pubkey')

キーを自己認証するかどうかを尋ねられたら、Yesと入力します。次に、この手順が正常に完了すると生成されるサンプル出力を示します。

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.

29.6.4 アイデンティティ伝播の保護

アイデンティティ伝播を保護するには、コンテンツ・サーバーのSSLを構成する必要があります。

1. コンテンツ・サーバーに管理者としてログオンします。

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ファイルを構成します。次は、トラストストアとキーストアの情報を入力した後の.hdaファイルを示しています。

サンプルsslconfig.hdaファイル

@Properties LocalData
TruststoreFile=/tmp/ssl/server_keystore
KeystoreFile=/tmp/ssl/server_keystore
@end

29.7 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. 「メール・サーバーの登録」の説明に従って、メール・サーバーへの接続を登録します。

8. WebCenter Portalを再起動します。

9. WebCenter Portalにログインし、メール資格証明を提供します。

29.8 SSLを使用したOracle SESへの接続の保護

SES用にSSLを構成するシナリオは2つあります。1つ目のシナリオは、WebCenter PortalがすでにSSLを使用して保護されているが、SESは保護されていない場合です。2つ目のシナリオは、SESがすでにSSLを使用して保護されているが、WebCenter Portalは保護されていない場合です。これら2つのシナリオについて、次の各項で説明します。

- SSLを使用したOracle SESの保護

- SSLを使用したOracle SESへの接続の保護

29.8.1 SSLを使用したOracle SESの保護

注意:
このシナリオでは、WebCenter PortalはすでにSSLを使用して保護されていますが、SESは保護されていません。

SSLを使用してSESを保護する手順は次のとおりです。

SESへの接続を登録する前に、まず、証明書をトラスト・ストアにインポートする必要があります。次の手順に従って、トラスト・ストアに証明書を格納し、Oracle Secure Enterprise Search (SES)への接続を登録します。

HTTPS URLの証明書をダウンロードして保存する手順は次のとおりです。

1. 次の証明書名を使用して、WebCenter側でSSLを構成します。

cn=<myhost>

<myhost>は、WebCenterがインストールされているホストの完全修飾名です。

WebCenter PortalでのSSLの構成の詳細は、「SSLを使用したブラウザからWebCenter Portalへの接続の保護」を参照してください。

2. WebCenter証明書をPEM形式で(つまり<myhost>.crtとして)エクスポートします。
Firefox 3.0以降を使用すると、証明書を.PEM形式で直接ダウンロードできます。それ以外のブラウザの場合は、次の手順を実行した後、WebLogic Serverのder2pemツールを使用してPEM形式に変換してください。

a. 「証明書」をクリックします。

b. ポップアップ・ウィンドウで、「詳細」タブを開き、「ファイルにコピー...」をクリックします。
DER encoded binary(X.509)形式を使用して、証明書をファイルにコピーします。

c. .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. 正常にハンドシェイクを実行するには、次の手順が必要です。

a. 次のコマンドを使用して、WebCenter Portalを再起動します。-Dweblogic.security.SSL.minimumProtocolVersion=TLSv1

b. 10.3.6パッチをSESサーバーに適用します。http://aru.us.oracle.com:8080/ARU/ViewPatchRequest/process_form?aru=17092883

注意:

- WebLogic ServerのSESのサーバー・バージョンは10.3.6で、WebCenterのWebLogic Serverバージョンは12.2.1です。

- デフォルトでは、TLSv1.1およびTLSv1.2のみが12.2.1でサポートされています。10.3.6およびJDK 1.6_29 (SES環境)では、SSLv3およびTLSv1のみがサポートされています。

5. SESで、クロールおよび認可エンドポイントがWebCenter PortalアプリケーションのHTTPSポートを指す、Oracle WebCenterのソースを作成します。

6. クロールのスケジュールおよびソース・グループを作成します(「Fusion Middleware Controlを使用した検索パラメータとクローラの構成」を参照)。

7. SESのWebCenter側の構成を完了し、SESおよびWebCenter Portalを再起動します。

8. WebCenter Portalでいくつかオブジェクトを作成し、クロールを開始します。

9. クロールが完了したら、キーワード検索を実行します。WebCenter Portalに結果が表示されます。

29.8.2 SSLを使用したOracle SESへの接続の保護

注意:
このシナリオでは、WebCenter PortalはSSLを使用して保護されていませんが、SESは保護されています。

SES証明書をWebCenter Portalトラスト・ストアにインポートする手順は次のとおりです。

1. SESでのSSLを有効にします。

a. Oracle SES管理コンソールで、デフォルト設定の「デモ・アイデンティティとデモ信頼」のままにします。

b. 検索サーバー(search_server1など)にアクセスし、「全般」ページで「SSLリスニング・ポートの有効化」を「True」に設定して、SESでのSSLを有効にします。

c. サーバーを再起動します

2. Oracle SESをWebCenterに登録し(「Oracle Secure Enterprise Searchサーバーの登録」を参照)、SSL対応SESインスタンスをWebCenter Portalに登録します。

3. ブラウザを使用して、Oracle Secure Enterprise Searchが検索リクエストを有効化するために公開するWebサービスURLにナビゲートします。

http://host:port/search/query/OracleSearch

例:

https://example.com:7777/search/query/OracleSearch

4. ページにカーソルを置いて、マウスで右クリックし、「プロパティ」を選択します。

5. 「証明書」をクリックします。

6. ポップアップ・ウィンドウで、「詳細」タブを開き、「ファイルにコピー...」をクリックします。

DER encoded binary(X.509)形式を使用して、証明書をファイルにコピーします。

7. .DER形式の証明書を.PEM形式に変換します。

Firefox 3.0以降を使用して、証明書を直接.PEM形式にダウンロードします。他のブラウザの場合は、WebLogic Server der2pemツールを使用してPEM形式に変換します。der2pemツールの使用の詳細は、『Oracle WebLogic Serverコマンド・リファレンス』のder2pemに関する項を参照してください。WebLogicでは、.PEM以外の形式は認識されません。

8. 次のコマンドを使用して、JDK_HOMEのWebCenter Portal cacertsに証明書をインポートします。

keytool -import -alias ses_cer -file cert_file.cer -keystore cacerts -storepass changeit

cert_fileは、ダウンロードした証明書ファイルの名前です。

9. 「Oracle Secure Enterprise Searchサーバーの登録」の手順に従って、SESへの接続を登録します。

10. WebCenter Portalを再起動します。

29.9 SSLを使用したWebCenter Portalから外部BPELサーバーへの接続の保護

この項では、BPELサーバーが外部SOAドメインにある場合に、WebCenter PortalからBPELサーバーへの接続を保護する方法を説明します。

注意:

SOAが外部ドメインにインストールされているときは、アイデンティティ・アサータおよびオーセンティケータをWebCenter Portalの場合とまったく同じように構成する必要があります。外部LDAPアイデンティティ・ストアにアイデンティティ・アサータおよびオーセンティケータを構成する手順の詳細は、「外部LDAPサーバーへのアイデンティティ・ストアの再関連付け」を参照してください。

SSLを使用して、WebCenter Portalから外部BPELサーバーへの接続を保護する手順は次のとおりです。

1. Oracle SOA 12cをインストールし、構成します。
『SOA SuiteおよびBusiness Process Management SuiteのQuick Start for Developersのインストール』のOracle SOA SuiteのQuick Start for Developersのインストールに関する項を参照してください。

2. WebCenterから、次のコマンドを実行して、WebCenterのSOAへの接続を作成します。

createBPELConnection('webcenter','WebCenter-Worklist'
setSpacesWorkflowConnectionName('webcenter', 'WebCenter-Worklist', 'SOA_host:port','oracle/wss10_saml_token_client_policy')

3. WebCenterから、SSLを有効にします。
「SSLを使用したブラウザからWebCenter Portalへの接続の保護」の手順に従います。

4. SOAから、SSLを有効にします。
「SSLを使用したブラウザからWebCenter Portalへの接続の保護」の手順に従います。ただし、webcenter_wlsのかわりにsoa_wlsを使用し、webcenteridentityのかわりにsoaidentityを使用します。

5. WebCenter PortalおよびSOAのキーストアを構成します。
「WebCenter Portalドメイン・キーストアの作成」および「SOAドメイン・キーストアの作成」を参照してください。

6. WebCenter WebLogicサーバーとSOA WebLogicサーバーを同じOIDにワイヤリングします。

7. WebCenterから、SOAの公開証明書およびCA証明書をWebCenterトラスト・ストアにインポートします。

keytool -importcert -trustcacerts -alias soa_cert -file /filepath/certificate/bpel.cer -keystore /filepath/cacerts -storepass changeit

keytool -importcert -trustcacerts -alias soa_trust -file /filepath/certificate/democabpel.cer -keystore /filepath/cacerts -storepass changeit

8. SOAから、WebCenterの公開証明書およびCA証明書をSOAトラスト・ストアにインポートします。

keytool -importcert -trustcacerts -alias webcenter_cert -file /filepath/certificate/webcenter.cer -keystore /filepath/cacerts -storepass changeit

keytool -importcert -trustcacerts -alias webcenter_trust -file /filepath/certificate/democaprod.cer -keystore /filepath/cacerts -storepass changeit

9. WebCenterから、Oracle Enterprise ManagerのSOA HTTPSホストおよびポートを使用するように、SOA接続の詳細を変更します。

10. WebcenterのsetDomainEnv.shに、-Dweblogic.security.SSL.ignoreHostnameVerification=trueをEXTRA_JAVA_PROPERTIESとして追加します。

11. WC_PortalサーバーおよびSOA管理対象サーバーを再起動します。

30 Webサービス・セキュリティの構成

この章では、WebCenter Portalおよび関連するサービスとコンポーネントに、Webサービス・セキュリティ(WS-Security)を設定する方法を説明します。

WS-Securityでは、OPSSキーストア・サービス(KSS)キーストアを使用し、1つ以上のドメインを対象として、WebCenter Portalアプリケーションと補助アプリケーションおよびコンポーネントのセキュリティ資格証明を取得および管理するメカニズムを提供します。KSSキーストアは、認証およびデータ整合性に使用可能な公開鍵および秘密鍵に関する情報を提供します。

次のトピックでは、WS-Securityを使用した標準トポロジを構成する方法(WebCenter PortalアプリケーションとWSRPプロデューサが同じドメインを共有し、BPELサーバーが外部SOAドメインに存在する場合)、およびこの構成をより複雑な環境用に拡張する方法について説明します(たとえば、2番目のディスカッション・サーバーが別のドメインに存在し、BPELサーバーが別のSOAドメインに存在し、1つのWSRPプロデューサが外部ポートレット・ドメインに存在する場合)。

- 標準トポロジの場合のWS-Securityの構成

- 複数ドメインのWS-Securityの構成

- WebCenter Portal Client APIを使用するアプリケーションに対するWS-Securityを使用したWebCenter Portalの保護

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。

「管理操作、ロールおよびツールの理解」も参照してください。

30.1 標準トポロジの場合のWS-Securityの構成

この項では、WebCenter Portalアプリケーション、WSRPプロデューサおよびディスカッション・サーバーは同一ドメインを共有しているが、BPEL (SOA)サーバーは外部ドメインに配置されているトポロジの場合にWS-Securityを構成する方法を説明します。

標準トポロジ

- ドメイン1 : WebCenter Portal、ディスカッション、ポートレット・プロデューサ

- ドメイン2 : SOA

標準の2つのドメイン・トポロジの場合にWS-Securityを構成する手順は、次の各項で説明しています。

- WebCenter Portalドメイン・キーストアの作成

- SOAドメイン・キーストアの作成

- ディスカッション・サーバーの構成

30.1.1 WebCenter Portalドメイン・キーストアの作成

この項では、OPSSキーストア・サービス(KSS)を使用してWebCenter Portalキーストアおよびキーを作成する方法を説明します。キーストアとは、使用可能な公開鍵および秘密鍵の情報を提供するファイルです。キーは、認証やデータ整合性など、様々な目的に使用されます。また、ユーザー証明書や、ピア証明書の検証に必要なトラスト・ポイントも、キーストアにセキュアに格納されます。キーストアを作成すると、KSSを使用して、WebCenter Portal、ディスカッション・サーバー、BPELサーバーおよびWSRPプロデューサのセキュリティ資格証明を取得および管理できます。OPSSキーストア・サービスの詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のキーストア・サービスを使用したキーと証明書の管理に関する項を参照してください。

WebCenter Portalドメイン・キーストアを作成するには:

1. 次のWLSTコマンドを実行します。
svc = getOpssService(name='KeyStoreService')

2. 次のWLSTコマンドを使用して、キーストアを作成します。

svc.createKeyStore(appStripe='appStripe', name='producer', password='password', permission=true/false))

ここで:

- appstripe - キーストア・ストライプ名。キーストア内に作成されたキーおよび証明書はアプリケーション・ストライプまたは製品内に存在し、ドメイン内の各ストライプには一意の名前が付けられます

- name - キーストア名

- password - キーストア・パスワード

- permission — 権限とパスワードの両方によって保護する場合はfalse (キーストアを権限のみで保護する場合はtrue)

例:

svc.createKeyStore(appStripe='WCPortalStripe', name='producer', password='welcome1', permission=true))

3. この新しく作成されたキーストアのキー・ペアを生成します。

svc.generateKeyPair(appStripe='appstripe', name='name', password='password', dn='CN=Producer, OU=Producer, O=MyOrganization, L=MyTown, ST=MyState, C=US', keysize='2048', alias='producer', keypassword='keypassword')

ここで:

- appstripe - キーストア・ストライプ名。キーストア内に作成されたキーおよび証明書はアプリケーション・ストライプまたは製品内に存在し、ドメイン内の各ストライプには一意の名前が付けられます

- name - キーストア名

- password - キーストア・パスワード

- dn - ドメイン名(dn='CN=webcenter_certificate'など)

- alias - 公開鍵の別名

- keypassword - 新しい公開鍵のパスワード

例:

svc.generateKeyPair(appStripe='WCPortalStripe', name='producer', password='welcome1', dn='CN=Producer, OU=Producer, O=MyOrganization, L=MyTown, ST=MyState, C=US', keysize='2048', alias='producer', keypassword='welcome1')

4. プロデューサ証明書(コンシューマによって使用される)をエクスポートします。

svc.exportKeyStoreCertificate(appStripe='appstripe', name='name', password='password', alias='alias', type='TrustedCertificate',filepath='filepath')

ここで:

- appstripe - キーストア・ストライプ名。キーストア内に作成されたキーおよび証明書はアプリケーション・ストライプまたは製品内に存在し、ドメイン内の各ストライプには一意の名前が付けられます

- name - キーストア名

- password - キーストア・パスワード

- alias - 公開鍵の別名

- keypassword - 新しい公開鍵のパスワード

- filepath - 証明書パス

例:

svc.exportKeyStoreCertificate(appStripe='WCPortalStripe', name='producer', password='welcome1', alias='producer', type='TrustedCertificate',filepath='/scratch/certificate/webcenter.cer')

30.1.2 SOAドメイン・キーストアの作成

この項では、OPSSキーストア(KSS)を使用してSOAドメイン・キーストアおよびキーを作成する方法を説明します。KSSコマンドの構文情報および参照情報は、『Oracle Fusion Middlewareインフラストラクチャ・セキュリティWLSTコマンド・リファレンス』のOPSSキーストア・サービス・コマンドに関する項を参照してください。

SOAドメイン・キーストアを作成するには:

1. 次のWLSTコマンドを使用して、OPSSサービス・コマンド・オブジェクトを取得します。

svc = getOpssService(name='KeyStoreService')

2. キーストアを作成します。

svc.createKeyStore(appStripe='appStripe', name='name', password='password', permission=true/false))

ここで:

- appstripe - キーストア・ストライプ名。キーストア内に作成されたキーおよび証明書はアプリケーション・ストライプまたは製品内に存在し、ドメイン内の各ストライプには一意の名前が付けられます

- name - キーストア名

- password - キーストア・パスワード

- permission — 権限とパスワードの両方によって保護する場合はfalse (キーストアを権限のみで保護する場合はtrue)

例:

svc.createKeyStore(appStripe='SOAStripe', name='bpel', password='welcome1', permission=true))

3. 新しく作成されたキーストアのキー・ペアを生成します。

svc.generateKeyPair(appStripe='appstripe', name='name', password='password', dn='CN=Producer, OU=Producer, O=MyOrganization, L=MyTown, ST=MyState, C=US', keysize='2048', alias='bpel', keypassword='keypassword')

ここで:

- appstripe - キーストア・ストライプ名。キーストア内に作成されたキーおよび証明書はアプリケーション・ストライプまたは製品内に存在し、ドメイン内の各ストライプには一意の名前が付けられます

- name - キーストア名

- password - キーストア・パスワード

- dn - ドメイン名(dn='CN=webcenter_certificate'など)

- alias - 公開鍵の別名

- keypassword - 新しい公開鍵のパスワード

例:

svc.generateKeyPair(appStripe='SOAStripe', name='bpel', password='welcome1', dn='CN=BPEL, OU=Consumer, O=MyOrganization, L=MyTown, ST=MyState, C=US', keysize='2048', alias='bpel', keypassword='welcome1')

4. プロデューサによってエクスポートされた証明書をインポートします。

svc.importKeyStoreCertificate(appStripe='appStripe', name='name', password='password', alias='webcenter_spaces_ws', keypassword='keypassword', filepath='filepath',type='TrustedCertificate')

ここで:

- appstripe - キーストア・ストライプ名。キーストア内に作成されたキーおよび証明書はアプリケーション・ストライプまたは製品内に存在し、ドメイン内の各ストライプには一意の名前が付けられます

- name - キーストア名

- password - キーストア・パスワード

- keypassword - 新しい公開鍵のパスワード

- filepath - 証明書パス

注意:

importKeyStoreCertificateコマンドの別名は、常にwebcenter_spaces_wsに設定する必要があります。この別名は変更しないでください。SOAユースケースが失敗します。

例:

svc.importKeyStoreCertificate(appStripe='SOAStripe', name='bpel', password='welcome1', alias='webcenter_spaces_ws', keypassword='welcome1', filepath='/scratch/certificate/webcenter.cer',type='TrustedCertificate')

5. プロデューサによってインポートされる公開証明書をエクスポートします。

svc.exportKeyStoreCertificate(appStripe='appstripe', name='name', password='password', alias='alias', filepath='filepath',type='TrustedCertificate')

ここで:

- appstripe - キーストア・ストライプ名。キーストア内に作成されたキーおよび証明書はアプリケーション・ストライプまたは製品内に存在し、ドメイン内の各ストライプには一意の名前が付けられます

- name - キーストア名

- password - キーストア・パスワード

- alias - 公開鍵の別名

- filepath - 証明書パス

例:

svc.exportKeyStoreCertificate(appStripe='SOAStripe', name='bpel', password='welcome1', alias='bpel', filepath='/scratch/certificate/bpel.cer',type='TrustedCertificate')

6. SOAドメインに新しく作成されたストライプを登録します。

configureWSMKeystore('/WLS/base_domain','KSS', 'kss://appstripe/bpel', signAlias='bpel', cryptAlias='bpel', signAliasPassword='signAliasPassword',cryptAliasPassword='cryptAliasPassword')

ここで:

- WLS/base_domain — ドメイン名で、次の形式に従う必要があります。WLS/<domainName>

- kss://appstripe/bpel — KSSキーストア名

- cryptAlias — 公開鍵別名

- appstripe - キーストア・ストライプ名。キーストア内に作成されたキーおよび証明書はアプリケーション・ストライプまたは製品内に存在し、ドメイン内の各ストライプには一意の名前が付けられます

- signAliasPassword — 公開鍵のパスワード

- cryptAlias — 公開鍵別名

- cryptAliasPassword — 公開鍵のパスワード

例:

configureWSMKeystore('/WLS/base_domain','KSS', 'kss://SOAStripe/bpel', signAlias='bpel', cryptAlias='bpel', signAliasPassword='signAliasPassword',cryptAliasPassword='cryptAliasPassword')

7. SOAドメインに新しく作成されたbpelストライプにキーストア権限を付与します。

grantPermission(permClass="oracle.security.jps.service.keystore.KeyStoreAccessPermission", permTarget="stripeName=SOAStripe,keystoreName=bpel,alias=*", permActions="read")

8. コンシューマ証明書をWebCenterにインポートします。

svc.importKeyStoreCertificate(appStripe='appstripe', name='name', password='password', alias='bpel', keypassword='keypassword', filepath='filepath', type='TrustedCertificate')

ここで:

- appstripe - キーストア・ストライプ名。キーストア内に作成されたキーおよび証明書はアプリケーション・ストライプまたは製品内に存在し、ドメイン内の各ストライプには一意の名前が付けられます

- name - キーストア名

- password - キーストア・パスワード

- alias - 公開鍵の別名

- keypassword - 新しいキーのパスワード

- filepath - 証明書パス

例:

svc.importKeyStoreCertificate(appStripe='WCPortalStripe', name='producer', password='welcome1', alias='bpel', keypassword='welcome1', filepath='/scratch/certificate/bpel.cer', type='TrustedCertificate')

9. プロデューサ・ストライプを登録します。

configureWSMKeystore('/WLS/wc_domain','KSS', 'kss://appstripe/producer', signAlias='producer', signAliasPassword='signAliasPassword', cryptAlias='cryptAlias', cryptAliasPassword='cryptAliasPassword')

ここで:

- wc_domain — WebCenter Portalドメイン

- signAliasPassword — 公開鍵のパスワード

- cryptAlias — 公開鍵別名

- cryptAliasPassword — 公開鍵のパスワード

例:

configureWSMKeystore('/WLS/WLS_SOAWC','KSS', 'kss://WCPortalStripe/producer', signAlias='producer', signAliasPassword='welcome1', cryptAlias='producer', cryptAliasPassword='welcome1')

10. 新しく作成されたトライプにキーストア権限を付与します。

grantPermission(permClass="oracle.security.jps.service.keystore.KeyStoreAccessPermission", permTarget="stripeName=WCPortalStripe,keystoreName=producer,alias=*", permActions="read")

30.1.3 ディスカッション・サーバーの構成

トポロジのディスカッション・サーバーがWC_Portalサーバーと同じドメインにあり、本番環境で使用されない場合は、追加のキーストア構成は必要ありません。これは、WebCenter Portalドメインに構成されているキーストアがディスカッション・サーバーでも使用されるからです。ただし、本番環境では、ディスカッションWebサービス・エンドポイントをOWSMポリシーで保護し、ディスカッション・サーバー接続設定を構成する必要があります。これらの構成手順は、次の各トピックで説明します。

- WebCenter PortalおよびディスカッションWebサービス・エンドポイントに対するセキュリティ・ポリシーの添付

- ディスカッション・エンドポイントの保護

- ディスカッション・サーバーの接続設定の構成

注意:

WebCenter Portalからディスカッション・サーバーに送信されるディスカッション固有のWebサービス・メッセージは暗号化されません。メッセージの機密保護のため、Secure Socket Layer (SSL)を介してディスカッション・サーバーのURLにアクセスする必要があります。詳細は、「SSLの構成」を参照してください。

30.1.3.1 WebCenter PortalおよびディスカッションWebサービス・エンドポイントに対するセキュリティ・ポリシーの添付

新規またはパッチ適用済のWebCenter Portalインスタンスでは、割り当てられたセキュリティ/ポリシーの構成は、セキュリティ・ポリシーなしに設定されます。Oracle Web Services Manager (OWSM)のセキュリティ・ポリシーを、WebCenter PortalのWebサービス・エンドポイントおよびディスカッションの認証Webサービス・エンドポイントに添付する必要があります。本番環境では、「ディスカッション・エンドポイントの保護」の手順に従って、セキュリティを強化することで続行します。

注意:

パッチが適用されるWebCenter Portalインスタンスでは、パッチを適用する前にポリシー名を決定し、アップグレードした後にポリシーが同じであることを確認する必要があります。

Webサービス・セキュリティ・ポリシー構成を新しいインスタンスに添付する手順は次のとおりです。

注意:

クラスタ化環境では、WebCenter Portalおよびディスカッションがデプロイされている管理対象サーバーごとにこれらの手順を繰り返します。

1. WC_PortalおよびWC_Collaboration管理対象サーバーが実行中であることを確認します。

2. 次のWLSTコマンドを実行して、OWSMポリシーをディスカッションWebサービス・エンドポイントに添付します。

attachWebServicePolicy(application='owc_discussions', moduleName='owc_discussions', moduleType='web', serviceName='OWCDiscussionsServiceAuthenticated', subjectName='OWCDiscussionsServiceAuthenticated', policyURI='oracle/wss10_saml_token_service_policy')

3. WC_PortalおよびWC_Collaboration管理対象サーバーを再起動します。

30.1.3.2 ディスカッション・エンドポイントの保護

ディスカッションWebサービス・エンドポイントでは、WebCenter Portalから発信されるコールに対してユーザー・アイデンティティを伝播する必要があります。本番環境では、転送中に他者がメッセージを改ざんしたり、表示したりできないように、Webサービス・エンドポイントをOWSMポリシーで保護する必要があります。これを実行するには、パブリック・アクセス用のWebサービス・エンドポイントと認証済ユーザー・アクセス用のエンドポイントの両方を、Fusion Middleware ControlまたはWLSTを使用して適切なOWSMポリシーで保護する必要があります。

この項では、次の項目について説明します。

- Fusion Middleware Controlを使用したディスカッション・サーバー・エンドポイントの保護

- WLSTを使用したディスカッション・サーバー・エンドポイントの保護

30.1.3.2.1 Fusion Middleware Controlを使用したディスカッション・サーバー・エンドポイントの保護

Fusion Middleware Controlを使用してディスカッション・エンドポイントを保護する手順は次のとおりです。

1. Fusion Middleware Controlにログインして、ナビゲーション・ペインから、「WebCenter」→「ポータル」→「ディスカッション」を開いて、「ディスカッション(WC_Collaboration)」をクリックします。

「ディスカッション」ホームページが表示されます(図30-1を参照)。

図30-1 「ディスカッション」ホームページ

2. owc_discussionsターゲットをクリックします。

owc_discussionsアプリケーションのホームページが表示されます(図30-2を参照)。

図30-2 owc_discussionsのホームページ

3. 「アプリケーションのデプロイ」メニューから、「Webサービス」を選択します。

owc_discussionsアプリケーションの「Webサービス」ページが表示されます(図30-3を参照)。

図30-3 owc_discussionsの「Webサービス」ページ

4. 「Webサービス」タブを開き、OWCDiscussionsServiceAuthenticated Webサービス・エンドポイントをクリックします。

owc_discussionsのWebサービス・エンドポイント・ページが表示されます(図30-4を参照)。

図30-4 「Webサービス・エンドポイント」ページ

5. 「アタッチ/デタッチ」をクリックします。

「ポリシーの添付」ページが表示されます(図30-5を参照)。

図30-5 「ポリシーの添付」ページ

6. 「アタッチ」ボタンと「デタッチ」ボタンを使用して、oracle/wss11_saml_token_with_message_protection_service_policyを添付し、oracle/wss10_saml_token_service_policyを削除します。

7. 「OK」をクリックします。

30.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')

30.1.3.3 ディスカッション・サーバーの接続設定の構成

「ディスカッション・サーバーの登録」で説明しているように、使用しているWebCenter Portalアプリケーションに構成されているディスカッション・サーバーの接続にWS-Securityクライアント証明書情報を指定する必要があります。図30-6は、「ディスカッションおよびお知らせ接続の編集」ページの接続詳細の設定の例を示しています。

図30-6 「ディスカッションおよびお知らせ接続の編集」ページ

30.2 複数ドメインのWS-Securityの構成

この項では、たとえば、WebCenter Portalアプリケーション、BPEL (SOA)サーバー、ディスカッション・サーバーおよびWSRPプロデューサ・サーバーがそれぞれ独自のドメインに存在するトポロジの場合に、標準トポロジのWS-Securityの構成を拡張する方法を説明します。

複数ドメイン・トポロジ

- ドメイン1 : WebCenter Portal

- ドメイン2 : SOA (BPEL)サーバー

- ドメイン3 : ディスカッション・サーバー

- ドメイン4 : WSRPプロデューサ

複数のドメインが含まれるトポロジの場合にWS-Securityを構成する手順は、次の各トピックで説明しています。

- WebCenter Portalドメイン・キーストアの設定

- SOAドメイン・キーストアの作成

- 外部ディスカッション・サーバーの構成

- 外部ポートレット・ドメイン・キーストアの作成

30.2.1 WebCenter Portalドメイン・キーストアの設定

WebCenter Portalドメイン・キーストアを作成する場合は、「WebCenter Portalドメイン・キーストアの作成」で説明している、標準トポロジでWS-securityを構成する手順に従います。キーストアを作成すると、KSSを使用して、WebCenter Portal、ディスカッション・サーバー、BPELサーバーおよびWSRPプロデューサのセキュリティ資格証明を取得および管理できます。OPSSキーストア・サービスの詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のキーストア・サービスを使用したキーと証明書の管理に関する項を参照してください。

30.2.2 SOAドメイン・キーストアの作成

「SOAドメイン・キーストアの作成」の説明に従い、OPSSキーストア(KSS)を使用してSOAドメイン・キーストアおよびキーを作成します。KSSコマンドの構文情報および参照情報は、『Oracle Fusion Middlewareインフラストラクチャ・セキュリティWLSTコマンド・リファレンス』のOPSSキーストア・サービス・コマンドに関する項を参照してください。

30.2.3 外部ディスカッション・サーバーの構成

ディスカッション・サーバーがWebCenter Portalとは異なるドメインにある場合は、ディスカッション・サーバーにキーストアを作成して構成し、公開鍵が含まれる証明書をエクスポートして、それをWebCenter Portalドメインにインポートする必要があります。本番環境では、ディスカッションのWebサービス・エンドポイントをOWSMポリシーで保護し、ディスカッション・サーバー接続設定を構成する必要もあります。それらの設定手順は、次の各項で説明します。

- ディスカッション・サービス・エンドポイントの保護

- ディスカッション・サーバー・キーストアの作成

- ディスカッション・サーバーの接続設定の構成

30.2.3.1 ディスカッション・サービス・エンドポイントの保護

ディスカッションのWebサービス・エンドポイントでは、WebCenter Portalから発信されるコールに対してユーザー・アイデンティティを伝播する必要があります。「ディスカッション・エンドポイントの保護」の手順に従い、Fusion Middleware ControlまたはWLSTを使用してこれらのエンドポイントを保護します。

30.2.3.2 ディスカッション・サーバー・キーストアの作成

この項では、OWSMで使用されるキー・ペアが含まれるキーストアをディスカッション・サーバーに作成し、公開鍵が含まれる証明書をエクスポートして、それをWebCenter Portalドメインにインポートできるようにする方法を説明します。

owc_discussionsキーストアを作成するには:

1. ディスカッション・サーバーから、次のWLSTコマンドを実行します。

svc = getOpssService(name='KeyStoreService')

2. キーストアを作成します。

svc.createKeyStore(appStripe='appStripe', name='discussions', password='password', permission=true/false))

ここで:

- appstripe - キーストア・ストライプ名。キーストア内に作成されたキーおよび証明書はアプリケーション・ストライプまたは製品内に存在し、ドメイン内の各ストライプには一意の名前が付けられます

- name - キーストア名

- password - キーストア・パスワード

- permission — 権限とパスワードの両方によって保護する場合はfalse (キーストアを権限のみで保護する場合はtrue)

例:

svc.createKeyStore(appStripe='dfstripe', name='discussions', password='welcome1', permission=false)

3. 新しく作成されたキーストアのキー・ペアを生成します。

svc.generateKeyPair(appStripe='appstripe', name='name', password='password', dn='CN=Producer, OU=Producer, O=MyOrganization, L=MyTown, ST=MyState, C=US', keysize='2048', alias='discussions', keypassword='keypassword')

ここで:

- appstripe - キーストア・ストライプ名。キーストア内に作成されたキーおよび証明書はアプリケーション・ストライプまたは製品内に存在し、ドメイン内の各ストライプには一意の名前が付けられます

- name - キーストア名(この場合はdiscussions)。

- password - キーストア・パスワード

- dn — ドメイン名

- alias - 公開鍵の別名(この場合はdiscussions)

- keypassword - 新しい公開鍵のパスワード

例:

svc.generateKeyPair(appStripe='dfstripe', name='discussions', password='welcome1', dn='CN=DISCUSSIONS, OU=Consumer, O=MyOrganization, L=MyTown, ST=MyState, C=US', keysize='2048', alias='discussions', keypassword='welcome1')

4. プロデューサによってエクスポートされた証明書をインポートします。

svc.importKeyStoreCertificate(appStripe='appStripe', name='name', password='password', alias='webcenter_df_ws', keypassword='keypassword', filepath='filepath',type='TrustedCertificate')

ここで:

- appstripe - キーストア・ストライプ名。キーストア内に作成されたキーおよび証明書はアプリケーション・ストライプまたは製品内に存在し、ドメイン内の各ストライプには一意の名前が付けられます

- name - キーストア名(この場合はdiscussions)

- password - キーストア・パスワード

- keypassword - 新しい公開鍵のパスワード

- filepath - 証明書パス

例:

svc.importKeyStoreCertificate(appStripe='dfstripe', name='discussions', password='welcome1', alias='webcenter_df_ws', keypassword='welcome1', filepath='/scratch/certificate/webcenter.cer',type='TrustedCertificate')

5. プロデューサによってインポートされる公開証明書をエクスポートします。

svc.exportKeyStoreCertificate(appStripe='appstripe', name='name', password='password', alias='alias', filepath='filepath',type='TrustedCertificate')

ここで:

- appstripe - キーストア・ストライプ名。キーストア内に作成されたキーおよび証明書はアプリケーション・ストライプまたは製品内に存在し、ドメイン内の各ストライプには一意の名前が付けられます

- name - キーストア名

- password - キーストア・パスワード

- alias - 公開鍵の別名

- filepath - 証明書パス

例:

svc.exportKeyStoreCertificate(appStripe='dfstripe', name='discussions', password='welcome1', alias='discussions', filepath='/workplace/certificate/discussions.cer',type='TrustedCertificate')

6. 新しく作成されたストライプを登録します。

configureWSMKeystore('/WLS/base_domain','KSS', 'kss://dfstripe/discussions', signAlias='discussions', cryptAlias='discussions', signAliasPassword='signAliasPassword',cryptAliasPassword='cryptAliasPassword')

ここで:

- signAliasPassword — 署名鍵別名のパスワード

- cryptAliasPassword — 暗号化鍵別名のパスワード

7. 新しく作成されたdiscussionsストライプにキーストア権限を付与します。

grantPermission(permClass="oracle.security.jps.service.keystore.KeyStoreAccessPermission", permTarget="stripeName=dfstripe,keystoreName=discussions,alias=*", permActions="read")

8. 管理対象サーバーおよび管理サーバーを再起動します。

9. ディスカッション公開証明書をWebCenterにインポートします。

svc.importKeyStoreCertificate(appStripe='appstripe', name='name', password='password', alias='discussions', keypassword='keypassword', filepath='filepath', type='TrustedCertificate')

ここで:

- appstripe - キーストア・ストライプ名。キーストア内に作成されたキーおよび証明書はアプリケーション・ストライプまたは製品内に存在し、ドメイン内の各ストライプには一意の名前が付けられます

- name - キーストア名

- password - キーストア・パスワード

- alias - 公開鍵の別名

- keypassword - 新しいキーのパスワード

- filepath - 証明書パス

例:

svc.importKeyStoreCertificate(appStripe='WCPortalStripe', name='producer', password='welcome1', alias='discussions', keypassword='welcome1', filepath='/workplace/certificate/discussions.cer', type='TrustedCertificate')

30.2.3.3 ディスカッション・サーバーの接続設定の構成

「ディスカッション・サーバーの登録」で説明しているように、WebCenter Portalに構成されているディスカッション・サーバーの接続にWS-Securityクライアント証明書情報を指定する必要があります。図30-7は、「ディスカッションおよびお知らせ接続の編集」ページの接続詳細の設定の例を示しています。

図30-7 「ディスカッションおよびお知らせ接続の編集」ページ

30.2.4 外部ポートレット・ドメイン・キーストアの作成

外部ポートレット・ドメイン・キーストアを作成するには:

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は、キーストア・パスワードです。

例: 証明書のインポート

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)。
例: キー・ペアの生成

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 -storepasskeystore_password -rfc -file producer_public_key.cer

ここで:

- keystore_passwordは、キーストアのパスワードです(例: MyPassword)。

例: 公開鍵が含まれる証明書のエクスポート

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)。

例: 証明書のインポート

keytool -importcert -alias producer_public_key -file producer_public_key.cer  -keystore webcenter.jks -storepass MyPassword

30.3 WebCenter Portal Client APIを使用するアプリケーションに対するWS-Securityを使用したWebCenter Portalの保護

この項では、WebCenter Portal APIを公開するアプリケーション(コンシューマ)とWebCenter Portal (プロデューサ)の間の通信のセキュリティが確保され、そのAPIを呼び出すユーザーのアイデンティティが保護されるように、WebCenter PortalにWS-Securityを構成する場合に必要な管理者タスクについて説明します。

この項には次のトピックが含まれます:

- WebCenter PortalクライアントAPIを使用するアプリケーションの標準トポロジの構成

- WebCenter PortalクライアントAPIを使用するアプリケーションの複数ドメイン・トポロジの構成

30.3.1 WebCenter PortalクライアントAPIを使用するアプリケーションの標準トポロジの構成

クライアント・アプリケーションがWebCenter Portalと同じドメインの一部である場合は、GroupSpaceWSContext()に対して次のコマンドを設定するだけで済みます。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("producer");

注意:

ここでの別名は常に公開鍵にする必要があります。

クライアント・アプリケーションがJDeveloperであり、WebCenter Portalサーバーの構成済キーストアにアクセスできる場合は、同じキーストアをJDeveloperのDefaultDomain/config/fmwconfig/dirにコピーし、このキーストアを使用するようにJDeveloperドメインを構成します。これらの手順は、「WebCenter Portalドメイン・キーストアの作成」の手順とまったく同じであり、その上で、クライアント・スタブに次のコマンドを指定する必要があります。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("producer");

30.3.2 WebCenter PortalクライアントAPIを使用するアプリケーションの複数ドメイン・トポロジの構成

クライアント・アプリケーションがWebCenter Portalと同じドメインの一部である場合は、GroupSpaceWSContext()に対して次のコマンドを設定するだけで済みます。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("producer");

注意:

ここでの別名は常に公開鍵にする必要があります。

クライアント・アプリケーションがJDeveloperの場合、同じキーストアをJDeveloperのDefaultDomain/config/fmwconfig/dirにコピーして、このキーストアを使用するようにJDeveloperドメインを構成します。これらの手順は、「WebCenter Portalドメイン・キーストアの作成」の手順とまったく同じであり、その上で、クライアント・スタブに次のコマンドを指定する必要があります。

GroupSpaceWSContext context = new GroupSpaceWSContext();
context.setRecipientKeyAlias("producer");

30.4 標準トポロジの場合のJKSコマンド・サマリー

標準トポロジの場合にキーストアを迅速に構成するには、次のコマンド・サマリーを使用します。これらのコマンドは、JKSキーストアの構成方法について説明します。

WebCenter側

次の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

SOA側

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 bpel.cer
keytool -importcert -alias webcenter_spaces_ws -file webcenter_public.cer -keystore bpel.jks -storepass welcome1

WebCenter側

keytool -importcert -alias bpel -file bpel.cer -keystore webcenter.jks -storepass welcome1

webcenter.jksファイルをdomain_home/config/fmwconfigディレクトリにコピーし、bpel.jksファイルをsoa_domain_home/config/fmwconfigディレクトリにコピーします。

SOAドメイン・キーストアの構成

次のWLSTコマンドを実行してキーストアを登録します。

configureWSMKeystore('/WLS/wc_domain',JKS, 'webcenter.jks', signAlias='producer', signAliasPassword='signAliasPassword', cryptAlias='cryptAlias', cryptAliasPassword='cryptAliasPassword')

ここで:

- wc_domain — WebCenter Portalドメイン

- signAliasPassword — 公開鍵のパスワード

- cryptAlias — 公開鍵別名

- cryptAliasPassword — 公開鍵のパスワード

例:

configureWSMKeystore(context='/WLS/wc_domain', keystoreType='JKS', location='./consumer.jks',keystorePassword='welcome1', signAlias='consumer', signAliasPassword='welcome1', cryptAlias='consumer', cryptAliasPassword='welcome1')

30.5 標準トポロジを拡張する場合のJKSコマンド・サマリー

複数ドメイン・トポロジの場合にキーストアおよびDFプロパティを迅速に構成するには、次のコマンド・サマリーを使用します。

WebCenter側

次の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

SOA側。

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 bpel.cer

keytool -importcert -alias webcenter_spaces_ws -file webcenter_public.cer -keystore bpel.jks -storepass welcome1

証明書を信頼するかを尋ねられたら、yesと答えます。

ディスカッション

keytool -genkeypair -keyalg RSA -dname "cn=disc,dc=example,dc=com" -alias discussions -keypass MyPassword -keystore discussions.jks

keytool -exportcert -v -alias discussions -keystore discussions.jks -storepass MyPassword -rfc -file disc.cer

keytool -importcert -alias webcenter_public -file webcenter_public.cer -keystore discussions.jks -storepass MyPassword

証明書を信頼するかを尋ねられたら、yesと答えます。

WebCenter側

keytool -importcert -alias df_webcenter_public -file disc.cert -keystore discussions.jks -storepass MyPassword

証明書を信頼するかを尋ねられたら、yesと答えます。

keytool -importcert -alias webcenter_spaces_ws -file bpel.cer -keystore bpel.jks -storepass MyPassword

注意:
webcenter_spaces_wsとしての別名を維持します。

外部ディスカッション・サーバー・ドメイン・キーストアの構成

WebCenter側で次のWLSTコマンドを実行してキーストアを登録します。

configureWSMKeystore(context='/WLS/wc_domain',keystoreType='JKS',location='./producer.jks',keystorePassword='welcome1',signAlias='producer',signAliasPassword='welcome1',cryptAlias='producer',cryptAliasPassword='welcome1')

ここで:

- wc_domain — WebCenter Portalドメイン

- signAliasPassword — 公開鍵のパスワード

- cryptAlias — 公開鍵別名

- cryptAliasPassword — 公開鍵のパスワード

SOAドメイン・キーストアの構成

次のWLSTコマンドを実行してキーストアを登録します。

configureWSMKeystore(context='/WLS/wc_domain',keystoreType='JKS',location='./bpel.jks',keystorePassword='welcome1',signAlias='producer',signAliasPassword='welcome1',cryptAlias='producer',cryptAliasPassword='welcome1')

ここで:

- wc_domain — WebCenter Portalドメイン

- signAliasPassword — 公開鍵のパスワード

- cryptAlias — 公開鍵別名

- cryptAliasPassword — 公開鍵のパスワード

ディスカッション・キーストアの登録

次のWLSTコマンドを実行してキーストアを登録します。

configureWSMKeystore('/WLS/wc_domain','JKS', discussions.jks, signAlias='producer', signAliasPassword='signAliasPassword', cryptAlias='cryptAlias', cryptAliasPassword='cryptAliasPassword')

ここで:

- wc_domain — WebCenter Portalドメイン

- signAliasPassword — 公開鍵のパスワード

- cryptAlias — 公開鍵別名

- cryptAliasPassword — 公開鍵のパスワード

ディスカッション・サーバー接続の構成

「ディスカッション・サーバーの登録」で説明しているように、WebCenter Portalに構成されているディスカッション・サーバーの接続にWS-Securityクライアント証明書情報を指定します。「ディスカッションおよびお知らせ接続の編集」ページの接続詳細の設定の例は、「ディスカッション・サーバーの接続設定の構成」も参照してください。

31 ポートレット・プロデューサのセキュリティの構成

この章では、WSRPおよびJPDKポートレット・プロデューサのセキュリティを処理するようにWebCenter Portalを構成する方法を説明します。

この章の内容は次のとおりです。

- WSRPプロデューサの保護

- PDK-Javaプロデューサの保護

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。

「管理操作、ロールおよびツールの理解」も参照してください。

31.1 WSRPプロデューサの保護

次の各項で、WebCenter PortalからJSR-168標準ベースのWSRPポートレットにセキュアにアクセスする方法を説明します。

- プロデューサのデプロイ

- プロデューサ・エンドポイントへのポリシーの添付

- キーストアの設定

31.1.1 プロデューサのデプロイ

WS-Security用にプロデューサを構成する前に、「ポートレット・プロデューサ・アプリケーションのデプロイ」で説明されている手順を実行して、標準準拠のポートレット・プロデューサをOracle WebLogic管理対象サーバーにデプロイする必要があります。

31.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 UsernameToken SOAPヘッダーの資格証明を使用して行われます。ユーザーのサブジェクトは、現在構成されているアイデンティティ・ストアに対して確立されます。

- ユーザー名トークン(パスワードなし)
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へのログインの詳細は、「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「アプリケーションのデプロイ」ノードを開き、ポリシーの添付先のプロデューサをクリックします。

3. 「アプリケーションのデプロイ」メニューから、「Webサービス」を選択します。

プロデューサの「Webサービスのサマリー」ページが表示されます。

4. 「Webサービス・エンドポイント」タブを開き、ポリシーの添付先のエンドポイントをクリックします。

「WSMポリシー・サブジェクト構成」ページが表示されます(図31-1を参照)。

図31-1 WSMポリシー・サブジェクト構成

注意:

マークアップ・サービス・ポートのみを保護する必要があります(WSRP_V2_Markup_ServiceおよびWSRP_V1_Markup_Service)。

プロデューサの「Webサービス・エンドポイント」ページが表示されます。

5. 「ポリシー」タブを開いて、プロデューサに現在添付されているポリシーを表示します。

6. 「アタッチ/デタッチ」をクリックして、ポリシーを追加または削除します。

使用可能なポリシーとその説明が示された「ポリシーのアタッチ/デタッチ」ページが表示されます。

7. 「使用可能なポリシー」で、検索するポリシー・カテゴリとしてCategoryおよびSecurityを選択し、「検索」アイコンをクリックすると、セキュリティ・ポリシーが表示されます。

8. 添付するポリシーを選択し、「添付」をクリックします。複数のポリシーを選択するには、[Ctrl]キーを使用します。

ポリシーが、「アタッチされたポリシー」の下のリストに表示されます。

9. プロデューサ・エンドポイントに添付するポリシーの追加が終了したら、「OK」をクリックします。

31.1.3 キーストアの設定

WSRPプロデューサにキーストアを作成および構成する手順は、使用しているWebCenter Portal環境のトポロジによって異なり、これらの手順については、次の各項で説明しています。

- 標準トポロジの場合のWS-Securityの構成

- 複数ドメインのWS-Securityの構成

キーストアを設定するための詳細な手順およびWSRPプロデューサを構成する際のWS-Securityのその他の側面については、これらの項を参照してください。

31.2 PDK-Javaプロデューサの保護

共有鍵をメッセージの整合性保護のために定義できますが、これはSSLとともに使用する必要があります。共有鍵をパスワード資格証明として格納する手順は次のとおりです。

- 管理サーバー・インスタンスの資格証明ストアに、パスワード資格証明として共有鍵を定義します。これは、Fusion Middleware ControlまたはWLSTを使用して実行できます。

- Webプロデューサを再起動して、テスト・ページにアクセスします。アプリケーション・ログをチェックして、共有鍵が適切に適用されていることを確認します。

注意:

共有鍵の使用では、メッセージの整合性保護のみを実施できます。完全なメッセージ保護には、SSLが必要です。SSLを使用したPDK-Javaポートレット保護の詳細は、「SSLを使用したWebCenter Portalからポートレット・プロデューサへの接続の保護」を参照してください。

31.2.1 パスワード資格証明としての共有鍵の定義

管理サーバー・インスタンスの資格証明ストアに、Fusion Middleware ControlコマンドまたはWLSTコマンドを使用して、パスワード資格証明として共有鍵を定義でき、これらについて次の各項で説明します。

- Fusion Middleware Controlを使用した共有鍵の定義

- WLSTを使用した共有鍵の定義

31.2.1.1 Fusion Middleware Controlを使用した共有鍵の定義

Fusion Middleware Controlを使用して共有鍵を定義する手順は、次のとおりです。

1. Fusion Middleware Controlにログインします。

Fusion Middleware Controlへのログインの詳細は、「Enterprise Manager Fusion Middleware Controlの起動」を参照してください。

2. ナビゲーション・ペインで、「WebLogicドメイン」ノードを開き、ターゲット・ドメイン(wc_domainなど)をクリックします。

3. 「WebLogicドメイン」メニューの「セキュリティ」→「資格証明」を選択します。

「資格証明」ペインが表示されます。

4. 「マップの作成」をクリックし、「マップ名」としてPDKと入力して、「OK」をクリックします。

5. 「キーの作成」をクリックして、作成したマップ(PDK)を選択します。

6. 「ユーザー名」(この値は使用されないため、どのような値でも指定できます)、「キー」(pdk.<service_id>.sharedKeyの形式。<service_id>はプロデューサの名前)および「パスワード」(10から20桁の16進数)に値を入力して、「OK」をクリックします。

新しい鍵が「資格証明」ペインに表示されます。

31.2.1.2 WLSTを使用した共有鍵の定義

次の手順で説明するように、WLSTを使用して共有鍵を定義することもできます。

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プロデューサでは、初めてリクエストを処理する際(ブラウザ・テスト・ページ・リクエストやプロデューサの初回登録時など)にプロパティが適用されるため、共有鍵資格証明の設定後にプロデューサを再起動する必要があります。

31.2.1.3 共有鍵へのOracle PDK-Javaプロデューサの登録

PDK-Javaプロデューサの登録については、「Oracle PDK-Javaポートレット・プロデューサの登録」を参照してください。共有鍵にOracle PDK-Javaプロデューサを登録する場合は、次のことも実行する必要があります。

- プロデューサの登録時に、「プロデューサ・セッションの有効化」オプションを選択します。

- 「ポートレット・プロデューサ接続の追加」セクションで、資格証明マップの作成時に使用するパスワードを共有鍵として入力します。

32 偽装の管理

この章では、WebCenter Portal偽装を管理および構成する方法について説明します。これにより、指定されたWebCenter Portalユーザーが他のユーザーを偽装し、これらのユーザーとして操作を実行できます。

(偽装者による)偽装セッションを開始する方法および(被偽装者による)偽装セッションを許可する方法の詳細は、『Oracle WebCenter Portalの使用』のWebCenter Portal偽装の使用に関する項を参照してください。偽装ELおよび偽装APIの詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の偽装に関連したELに関する項を参照してください。

この章の内容は次のとおりです。

- WebCenter Portal偽装の概要

- WebCenter Portalの偽装の準備

- WebCenter Portalの偽装の構成

- 偽装者の構成

- 偽装の無効化

- セッション・インジケータをオフにする

- 偽装ホットキーのオーバーライド

- WebCenter Portal偽装の監査ログの管理

権限

この章のタスクを実行するには、Oracle WebLogic Server管理コンソールでWebLogic ServerのAdminロールが付与されている必要があります。MonitorまたはOperatorロールを持つユーザーは、セキュリティ情報を表示できますが変更することはできません。

「管理操作、ロールおよびツールの理解」も参照してください。

32.1 WebCenter Portal偽装の概要

この項には次のトピックが含まれます:

- WebCenter Portal偽装について

- WebCenter Portal偽装の使用のベスト・プラクティス

32.1.1 WebCenter Portal偽装について

WebCenter Portal偽装を使用すると、WebCenter Portal管理者またはシステム管理者が、サポート担当者やアプリケーション管理者などのユーザーのグループ(「偽装者」)に偽装の権限を割り当てることができます。こうすることによって、偽装者は他のユーザー(「被偽装者」)として操作を実行できます。これは、偽装する追加の権限を偽装者に付与する被偽装者が対象となることに注意してください。この機能は次のような場合に役立ちます。

- 顧客サポート担当者が、ユーザーが直面している問題を理解するために、そのユーザーのかわりとしてアクションを実行する場合。

- 管理者が、ユーザーのかわりに操作を実行する場合。

- 会社の管理職が不在のときに、その管理職のかわりにその責務を果たす権限を誰かに委任する必要がある場合。

32.1.2 WebCenter Portal偽装の使用のベスト・プラクティス

また被偽装者のシステムからOracle Access Manager (OAM)に参加するすべてのアプリケーションは、偽装者へのアクセスが可能になります。唯一の例外は、偽装者が偽装タスク・フローにアクセスして、偽装の権限を付与したり変更することができなくなることです。したがって、管理者が偽装の権限を付与する際には、偽装者が潜在的にアクセス可能な対象を考慮して、細心の注意を払う必要があります。偽装者は、ごく限られたグループにする必要があります。

偽装に対する監査ログ機能をオンにして、管理者は監査ログを定期的にモニターし、偽装アクティビティを確認する必要があります。監査ログ機能の詳細は、「WebCenter Portal偽装の監査ログの管理」を参照してください。

偽装セッションを開始するには、被偽装者と偽装者が、偽装セッションの適切な時間帯に同意する必要があります。この場合、被偽装者はその時間帯にのみ偽装の権限を付与する必要があります。被偽装者は、偽装者が完了した直後に偽装の権限を取り消す必要があります。

偽装者がログアウトすると、偽装セッションが終了することに注意してください。また偽装セッションは、指定された偽装時間の終点に達したときにも終了します。たとえば、ユーザーが午後の1:00から2:00の間に偽装者に偽装の権限を付与した場合、偽装者が偽装セッションを1:00から2:00の間のいつ開始しても、そのセッションは2:00に終了します。

また、偽装者が偽装セッションを行っている最中に、ユーザーが明示的に偽装権限付与を取り消した場合、取消し操作はそのユーザーに対する既存の偽装セッションには影響を与えません。影響を与えるのは、次回偽装者がユーザーの偽装を試みたときのみです。ユーザーは、有効な被偽装者のリストには表示されません。

32.2 WebCenter Portalの偽装の準備

WebCenter Portal偽装はOAM 11.1.2.0に依存しています。WebCenter Portalインスタンスのために偽装を有効化するには、その前にまずOAM 11g (Oracleのシングル・サインオン・ソリューション)をインストールして構成し、OAMで偽装を有効にする必要があります。OAM 11gのインストールと構成の詳細は、「Oracle Access Managerの構成」を参照してください。

この項には次のトピックが含まれます:

- WebCenter Portal偽装の要件

- OAMでの偽装の有効化

- アイデンティティ・ストアへの偽装属性の追加

32.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をインストールおよび構成する(「Oracle Access Managerの構成」を参照してください)

- 偽装を有効化する

- アイデンティティ・ストアで各参加ユーザーに偽装属性を追加する

- 参加しているWebCenter Portalインスタンスごとに偽装を構成する

- WebCenterアプリケーション・ロールに偽装の権限を追加することにより、偽装の権限を持つユーザーを構成する

32.2.2 OAMでの偽装の有効化

「Oracle Access Managerの構成」で説明されているように(10gまたは11gのいずれかのWebGateを使用して) OAM 11.1.2.0をインストールおよび構成した後、次に示すようにidmConfigToolを使用してOAMで偽装を有効化して続行します

偽装を有効にする手順は次のとおりです。

1. idmConfigToolを使用して、次のドキュメントのIDM構成ツールを使用したAccess Managerの構成に関する項に示されているように、OAMを構成します: 『Oracle Fusion Middleware Oracle Identity Managementエンタープライズ・デプロイメント・ガイド』。

2. 示されているようにプロパティ・ファイルを作成しますが、OAM11G_IMPERSONATION_FLAGをtrueに設定します。

32.2.3 アイデンティティ・ストアへの偽装属性の追加

ユーザーを偽装者または被偽装者として有効にするには、それらのユーザーが、OIDで偽装権限付与を保存するために使用可能な次の属性を保持している必要があります。

- orclImpersonationGrantee

- orclImpersonationGranter

これらの属性は、OIDでデフォルトで使用可能なorclIDXPersonオブジェクト・クラスの一部です。このオブジェクト・クラスは、偽装者または被偽装者として参加させるユーザーのユーザー・レコードごとに、オブジェクト・クラスのリストに追加する必要があります。これを実行するには、次の各トピックで説明されているように、オブジェクト・クラスの追加を個別のユーザーに対して行うか、複数のユーザーに対するバルク更新として行います。

- 個々のユーザーに対する偽装属性の追加

- 複数のユーザーに対する偽装属性の追加

32.2.3.1 個々のユーザーに対する偽装属性の追加

個々のユーザーに対してOIDで偽装権限付与を保存するための属性を追加するには、次の手順に従います。

個々のユーザーにオブジェクト・クラスを追加するには:

1. ODSMにログインします(通常はhttp://host:port/odsm)。

2. OAMおよびWebCenter用に構成されているディレクトリに接続します。

3. 各参加ユーザーに対して、次の手順を実行します。

a. データブラウザでドリルダウンするか、データブラウザの検索フィールドを使用して、変更するユーザーを見つけます。

b. 図32-1で示されているように、「属性」画面を開いて、既存のオブジェクト・クラスのリストにorclIDXPersonオブジェクト・クラスを追加します。

図32-1 ODSMの「属性」タブ

c. 「適用」をクリックします。

32.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リファレンス』を参照してください。

32.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によって強制されます。時間差を説明する手順は次のとおりです。

a. 管理者としてWebCenter Portalにログインします。

b. 「管理」→「属性」を選択します。
「属性」ページが表示されます。

ヒント:

ブラウザでページを開くことにより、「属性」ページに直接アクセスすることもできます。

http://host:port/webcenter/faces/oracle/webcenter/webcenterapp/view/pages/admin/WebCenterAdmin-CustomAttributes.jspx

ここでhostおよびportは、WC_PortalサーバーのホストおよびポートのIDです。

c. 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

d. WebCenter Portal管理対象サーバー(WC_Portal)を再起動します。

32.4 偽装者の構成

OAMとWebCenter Portalを構成したら、webcenter#-#impersonatorsロールにユーザーまたはグループを追加することにより、偽装権限の付与先のユーザーを構成することも必要になります。初期設定でこのロールが付与されているユーザーはいません。WebCenter Portalインスタンスでユーザーを偽装する資格があるのは、直接のメンバーシップまたはエンタープライズ・ロール・メンバーシップによってこのロールに属しているユーザーのみです。

注意:

他のユーザーを偽装できるようになる権限をユーザーに付与する際には、注意が必要です。偽装の権限を付与するのは、この機能を業務上必要としているユーザーのみにしてください。ベスト・プラクティスの詳細は、「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")

注意:

ロールの割当ての変更はすぐに有効になります。管理対象サーバーを再起動する必要はありません。

32.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およびそのすべてのコンポーネントを再起動します。

32.6 セッション・インジケータをオフにする

セッション・インジケータは、偽装セッション中にデフォルトで偽装者の画面に表示されるオーバーレイです。このオーバーレイは、偽装セッションがアクティブであるという視覚的な手掛かりを提供し、また「偽装の中止」をクリックすることでセッションを中止する迅速な方法も提供しますが、図32-2に示すようにユーザーの(被偽装者の)画面の一部の表示を妨げる場合があります。

注意:

偽装セッション通知ツールバーがオフになっている場合、「偽装の中止」ボタンが表示されなくなるので、ユーザーは「偽装」ページを使用して偽装セッションを中止する必要があります。

図32-2 偽装セッション - セッション・インジケータのオーバーレイ

次に示すように、セッション・インジケータのオーバーレイをオフにすることができます。

セッション・インジケータをオフにするには:

1. 管理者としてWebCenter Portalにログインします。

2. 「管理」→「属性」を選択します。

「属性」ページが表示されます。

ヒント:

ブラウザでページを開くことにより、「属性」ページに直接アクセスすることもできます。

http://host:port/webcenter/faces/oracle/webcenter/webcenterapp/view/pages/admin/WebCenterAdmin-CustomAttributes.jspx

ここでhostおよびportは、WC_PortalサーバーのホストおよびポートのIDです。

3. 次に示すように通知プロパティをfalseに設定します。

oracle.webcenter.security.impersonation.notification=false

この場合、「偽装プリファレンス」画面を使用して偽装セッションを終了する必要があることに注意してください。偽装プリファレンス画面の使用の詳細は、『Oracle WebCenter Portalの使用』のWebCenter Portal偽装の使用に関する項を参照してください。

4. WC_Portal管理対象サーバーを再起動して、変更を有効にします。

32.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_Portalサーバーのホストおよびポートの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_Portalサーバーを再起動して、変更を有効にします。

32.8 WebCenter Portal偽装の監査ログの管理

WebCenter Portal偽装を有効にすると、Fusion Middleware Audit Serviceの一部として偽装関連のイベントのログ記録がアクティブになります。デフォルトでは、監査ログ・イベントはファイル(監査バスストップ)に格納されますが、データベースにアップロードして永続化することもできます。

注意:

WebCenter Portal偽装を有効にする場合は、監査ログも有効にすることを強くお薦めします。偽装を有効にすると、監査ログによって、偽装者、被偽装者および各偽装イベントのコンテキストが追跡されます。

監査バスストップ・ファイルの容量は限られているため、イベントの発生後、それらが問合せ可能になるまでに時間がかかる場合は、ログ情報をデータベースに格納することもお薦めします。

偽装監査ログの主な利点は次のとおりです。

- ポータル、ポータル・サーバーおよびポータル・サーバーの主要アーティファクトのセキュリティ設定を変更するイベントを追跡できます。

- 監査可能なイベントには、偽装者、被偽装者およびイベントのコンテキストの定義に役立つすべての関連イベント・ペイロードが含まれます。

- ロギング・レベルを定義できます

- ログに記録されたイベントをデータベースにアップロードすると、それらは永続的に参照可能になります。

- 監査サービスを通じて、監査イベントに関するレポートを参照できます。

WebCenter Portalの監査ログ機能の管理の詳細は、「Oracle WebCenter Portal監査ログの管理」を参照してください。監査サービスを構成してデータベースを使用する方法の詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の監査の構成および管理に関する項を参照してください。

第VI部 WebCenter Portalのライフ・サイクルの管理

『Oracle WebCenter Portalの管理』のこの部では、WebCenter Portalのライフ・サイクル操作について説明します。

- WebCenter Portalのライフサイクルの理解

- ポータル、テンプレート、アセットおよび拡張機能のデプロイ

- WebCenter Portalのバックアップ、リカバリおよびクローニングの管理

33 WebCenter Portalのライフサイクルの理解

この章では、WebCenter Portalをそのライフ・サイクル全体を通して管理するためのタスク、ツールおよび手法について説明します。

この章の内容は次のとおりです。

- WebCenter Portalのライフ・サイクルについて。

- 主要なWebCenter Portalのライフ・サイクル・タスクとは。

- WebCenter Portalのライフ・サイクル操作の実行に必要な権限

- WebCenter Portalのライフ・サイクルを通したセキュリティの管理

権限

この章のタスクを実行するには、次のロールが付与されている必要があります。

- WebLogic Server: Oracle WebLogic Server管理コンソールを使用してAdminロールが付与されます。

- WebCenter Portal: WebCenter Portal管理を使用してAdministratorロールが付与されます。

「管理操作、ロールおよびツールの理解」も参照してください。

33.1 WebCenter Portalのライフ・サイクルについて。

ポータルのライフ・サイクルとは、WebCenter Portalを使用したデプロイメントによるポータルの作成から本番インスタンスまでの過程を表します。このライフ・サイクルには、ソフトウェア開発者、コンテンツ・モデラー、コンテンツ・コントリビュータ、IT管理者、ポータル・サイト管理者などの多くの人々が関与します。ライフ・サイクルのフェーズには、通常、開発、テスト、ステージングおよび本番が含まれます。各フェーズでは特定のタスクを実行する必要があります。コンテンツ・リポジトリの設定など、一部のタスクは一度だけ実行します。その他の、バックアップの作成や夜間ビルドの実行などのタスクは、より頻繁に実行されます。ポータルのライフ・サイクルのフェーズについては、表33-1で説明しています。

表33-1 WebCenter Portalのライフ・サイクルのフェーズ

ライフ・サイクルのフェーズ

主要なアクター/ロール

説明

開発

- ポータル開発者

- Web開発者

- コンテンツ・モデラー

- コンテンツ・コントリビュータ

- アプリケーション・スペシャリスト

開発者は、WebCenter Portalのブラウザベースのツールを使用して、新しいポータルを開発できます。

高度な要件に対応するために、開発者はJDeveloperを使用して、ポータル・アセットと共有ライブラリ(カスタム・ポータル・コンポーネントを含む)のさらなる開発およびデプロイを行うことができます。

開発ポータルは、通常、テストのデータとコンテンツを使用します。ライフ・サイクルのこのフェーズで開発される機能の一部は、次のとおりです。

- ポータル

- スキン、ページ・テンプレート、コンテンツ・プレゼンタ表示テンプレートなどのポータル・アセット

- 視覚化テンプレートとカスタム視覚化テンプレート

- 共有ライブラリ

- データ転送とポートレット間通信

- 初期セキュリティ

- ポートレット

テスト

- 開発者

- QAエンジニア

- システム管理者

開発ポータルは、独立したテスト環境にデプロイされます。テスト環境には、通常、独自のMetadata Service (MDS)とデータベース・ベースのポリシー・ストア、および専用のOracle WebCenter Contentインスタンスが含まれています。

テスト環境には、本番ポータルには組み込まれないテスト・データやテスト・コンテンツが含まれることもあります。

アプリケーション・データ・ソースやポートレット・プロデューサなどのコンポーネントが、テスト環境と開発環境で共有される場合があります。

ステージング

- アプリケーション・スペシャリスト

- システム管理者

- コンテンツ・コントリビュータ

ステージング環境では、ポータルが本番に移行する前に最終的な構成およびテストが行われる安定した環境が提供されます。コンテンツ・コントリビュータはコンテンツを追加して、ポータルの構造を調整します。

一般に、ステージング環境には、専用のOracle WebCenter Content Serverだけでなく、専用のポートレット・プロデューサ・サーバー(WC_Portlet)、およびディスカッションとお知らせのためのコラボレーション・サーバー(WC_Collaboration)が含まれます。ステージング環境では、外部のLDAPベースのアイデンティティ・ストア(Oracle Internet Directoryなど)も設定する必要があります。ステージング・サーバーは、通常、本番サイトのミラーとして保持されます。

ポートレット、タスク・フローおよびポータル・アセットに対して開発から時折更新が発生した場合、これをステージ環境にデプロイする必要があります。WebCenter Portal管理を使用して、ポータル・アセットの更新を開発環境からステージング環境にインポートできます。ステージング環境でポートレットとタスク・フローを更新する場合は、通常の方法で再デプロイします。

本番

- アプリケーション・スペシャリスト

- システム管理者

- コンテンツ・コントリビュータ

- ナレッジ・ワーカー

本番ポータルはライブで、エンド・ユーザーも使用できます。

適切な権限を持った個々のユーザーは、ビューをカスタマイズすることも可能です。

WebCenter Portal管理を使用して、ポータルとコンテンツを本番環境に移動できます。一部のバックエンド・データは手動で移動する必要があります。ポータルとコンテンツの移動にWLSTコマンドを使用することもできます。

管理者は、2つの環境が「同期」状態の場合、つまり、常に最初にステージの変更を行い、その後デプロイメントまたは伝播を使用してメタデータの変更を本番にプッシュすることにより、ステージングのポータルの変更を本番に伝播できます。本番のポータルは、オンライン状態のときに、WebCenter Portalで変更できます。ただし、本番サーバーに対する直接の変更は、最小限にする必要があります。

33.2 主要なWebCenter Portalのライフ・サイクル・タスクとは。

ライフ・サイクルの各フェーズでは、特定のタスクを実行するアクター(開発者、管理者、コンテンツ・コントリビュータなど)が必要です。この項では、ポータルのライフ・サイクルで実行されるタスクの種類の概要を示します。

- 1回かぎりの設定タスク

- WebCenter Portalのステージング環境および本番環境の理解

- ライフ・サイクルのタスク

33.2.1 1回かぎりの設定タスク

WebCenter Portalに対して開発、テスト、ステージおよび本番の各環境を設定するには、特定の準備手順を実行する必要があります。表33-2に、これらの予備設定タスクおよびそれを適用する環境の一般的なリストを示します。

表33-2 一般的な1回かぎりの設定タスク

設定タスク

JDeveloperの開発(アセットと共有ライブラリのみ)

WebCenter Portalの開発/テスト

ステージ

本番

Oracle JDeveloperおよびJDeveloperのWebCenter Portal拡張機能のインストール

はい

いいえ

いいえ

いいえ

Oracle WebCenter Portalのインストール

いいえ

はい

はい

はい

Oracle WebLogic Serverのインストール(ドメインおよび管理対象サーバーの作成)

いいえ

はい

はい

はい

RCUによる必要なデータベース・スキーマの作成

いいえ

はい

はい

はい

Oracle WebCenter Contentのインストールおよび構成

はい

はい

はい

はい

Oracle Access Managerなどのアイデンティティ管理コンポーネントのインストール

いいえ

はい

はい

はい

ポリシー・ストアでの必須のOracle Platform Security Servicesポリシーの作成

いいえ

はい

はい

はい

資格証明ストアでの必要なユーザー資格証明の作成

いいえ

はい

はい

はい

バックエンド・サーバーへの接続の作成

はい

はい

はい

はい

ソース・コントロールおよび夜間ビルド・スクリプトの設定

はい

いいえ

いいえ

いいえ

デプロイおよび構成スクリプトの作成

いいえ

はい

はい

はい

バックアップ・スクリプトの作成

いいえ

いいえ

はい

はい

33.2.2 WebCenter Portalのステージング環境および本番環境の理解

この項では、ポータルのライフ・サイクルのステージング・フェーズおよび本番フェーズについて説明します。図33-1に、ステージング環境から本番環境への一般的な流れを示します。ステージング環境は、プロビジョニングおよびテストが完了すると、本番環境に移行してユーザーがアクセスできるようになります。初めてステージング環境を本番環境にコピーする場合は、ステージのWebCenter Portalインスタンス全体を本番環境に移行します。これには、ポリシー・ストアの移行、MDSデータ(アプリケーション統合、RESTエンドポイント、SQLデータ・ソース)およびContent Serverリポジトリに格納されているすべてのWebCenter Portalデータも含まれます。

その後、本番環境がライブになると、本番でのポータルの変更は必要に応じて伝播できます。ステージで開発された新しいポータルを本番に対して個別にデプロイできます。また、必要な場合は、既存のポータルを再デプロイできます。

すべてのポータルの接続を1つのWebCenter Portalインスタンスから別のインスタンスに手動で個別に移動できます。

ステージ環境および本番環境で実行する様々なライフ・サイクルのタスクの詳細は、「ライフ・サイクルのタスク」を参照してください。

注意:

図33-1は、考えられるすべてのポータル機能を表してはいません。

図33-1 WebCenter Portalステージング環境から本番環境への流れ

33.2.3 ライフ・サイクルのタスク

表33-3に、WebCenter Portalライフ・サイクルで実行する必要がある可能性のあるタスクを示します。

表33-3 ライフ・サイクルのタスク

ライフ・サイクルのタスク

説明

使用するツール

方法

ポータル・インスタンス全体を移行

ステージング環境と本番環境の両方を設定および構成した後、初めて、ステージのWebCenter Portalインスタンスをターゲットにコピーします。

- Enterprise Manager Fusion Middleware Controlコンソール

- WLST

- 別のターゲットへのWebCenter Portal全体の移行

ポータルをデプロイ

ポータルをターゲットに直接デプロイするか、ポータル・アーカイブを作成してターゲットにインポートします。
個々の本番ポータルをアーカイブにエクスポートし、ステージング・サイトに再度インポートすることもできます。

- WebCenter Portal

- WLST

- ポータルのデプロイ

個々のアセットをデプロイ

アセットを共有したり、アセットを他のWebCenter Portalインスタンスに移行することができます。また、アセットをダウンロードし、Oracle JDeveloperなどのツールで編集および拡張した後、WebCenter Portalに再度デプロイすることもできます。必要な権限のある開発者は、JDeveloperからWebCenter Portalにアセットや拡張機能を直接デプロイすることができます。

- WebCenter Portal

- WLST

- ポータル・テンプレートのデプロイ

- アセット、デバイスおよびデバイス・グループのデプロイ

ポータルの変更を伝播

ステージング環境と本番環境が接続されて「同期」状態の場合、ステージングのポータルの変更を本番に伝播できます。
ポータル伝播では、ポータルに加えられた増分変更のみがターゲット・サーバーにプッシュされます。

- WebCenter Portal

- WLST

- 本番でのポータルの伝播および再デプロイ

ポータルを再デプロイ

ポータルの初期デプロイメントの後、ポータルをターゲットに再デプロイすることを選択できます。ポータルを再デプロイすると、そのポータルは削除され、新しいポータルとして再作成されます。

- WebCenter Portal

- WLST

- WebCenter Portalを使用したポータルの再デプロイ

接続を移行

ポータルをデプロイすると、その接続もデプロイされます。すべてのポータルの接続を1つのWebCenter Portalインスタンスから別のインスタンスに個別に移動できます。

- WLST

- ステージングから本番への接続の詳細の移動

バックアップ

データベース・ハードウェアを消失した場合や、ファイルまたはデータベースから誤ってデータを削除した場合などの障害からデータをリカバリするには、個々のポータルとWebCenter Portalインスタンス全体を頻繁にバックアップすることが重要です。

- WebCenter Portal

- WLST

- 個々のポータルのバックアップ

- WebCenter Portalインストール全体のバックアップ

リカバリ

1つ以上のポータルまたはWebCenter Portalインストール全体をバックアップ・アーカイブから完全にリストできます。

- WebCenter Portal

- WLST

- バックアップからのポータルのリストア

- WebCenter Portalインストール全体のリストア

- スクリプトを使用したWebCenter Portalのバックアップからのリストア

33.3 WebCenter Portalのライフ・サイクル操作の実行に必要な権限

表33-4は、ライフ・サイクル操作の実行に必要なWebLogic ServerのロールおよびWebCenter Portalの権限を示しています。

表33-4 ライフ・サイクル操作のためのWebCenter PortalおよびWebLogic Serverの権限の要件

WebCenter Portalオブジェクト

ツール

WebLogic Serverのロール

WebCenter Portalの権限

WebCenter Portal (アプリケーション・レベル)

アーカイブをインポートまたはエクスポート

Fusion Middleware Control

Monitor (またはそれ以上)

Application: Manage

アーカイブをインポートまたはエクスポート

WLST

Monitor (またはそれ以上)

Application: Manage

ポータル — 直接デプロイ/アーカイブ・インポート

ポータルの直接デプロイまたはポータル・アーカイブのインポート

WebCenter Portal

Portal Server – Deploy (ソース)
Portals: Manage Configuration (ソース)

Portals - Create Portals (ターゲット)

ポータルの直接デプロイまたはポータル・アーカイブのインポート

WLST

Monitor (またはそれ以上)

Portal Server – Deploy (ソース)
Portals: Manage Configuration (ソース)

Portals - Create Portals (ターゲット)

ポータルの再デプロイまたはポータル・アーカイブの再インポート

WebCenter Portal

Portal Server – Deploy (ソース)
Portals: Manage Configuration (ソース)

Portals: Manage Security and Configuration (ターゲット)

Portals - Create Portals (ターゲット)

ポータルの再デプロイまたはポータル・アーカイブの再インポート

WLST

Monitor (またはそれ以上)

Portal Server – Deploy (ソース)
Portals: Manage Configuration (ソース)

Portals: Manage Security and Configuration (ターゲット)

Portals - Create Portals (ターゲット)

ポータル — アーカイブのエクスポート

ポータル・アーカイブのエクスポート

WebCenter Portal

-

Portals: Manage Security and Configuration

ポータル・アーカイブのエクスポート

WLST

Monitor (またはそれ以上)

Portals: Manage Security and Configuration

ポータル・テンプレート

ポータル・テンプレート・アーカイブをエクスポートまたはインポート

WebCenter Portal

-

Portal Templates: Manage All

ポータル・テンプレート・アーカイブをエクスポートまたはインポート

WLST

Monitor (またはそれ以上)

Portal Templates: Manage All

ポータル・アセット

アセット・アーカイブをエクスポートまたはインポート

WebCenter Portal/REST API

-

Portal: Manage Configuration

および次のいずれか:

- Create、Edit、Delete Assets

- Create、Edit、Delete <Portal_Asset_Type>

アセット・アーカイブをエクスポートまたはインポート

WLST

Monitor (またはそれ以上)

次のいずれか:

- Create、Edit、Delete Assets

- Create、Edit、Delete <Portal_Asset_Type>

共有ライブラリ

ポータル拡張機能をJDeveloperから直接デプロイ

JDeveloper

Monitor (またはそれ以上)

Portals: Manage All

WebCenter Portal接続

すべてのWebCenter Portal接続をエクスポートまたはインポート

WLST

Operator (またはそれ以上)

-

共有アセット

アセット・アーカイブをインポートまたはエクスポート

WebCenter Portal

-

Application: Manage Configuration

Create、Edit、Delete <Shared_Asset_Type>

アセット・アーカイブをインポートまたはエクスポート

WLST

Monitor (またはそれ以上)

Create、Edit、Delete <Shared_Asset_Type>

33.4 WebCenter Portalのライフ・サイクルを通したセキュリティの管理

この項では、ポータルのセキュリティ・ポリシーと資格証明をあるWebCenter Portal環境から別の環境へ移行する手法について説明します。

単一のポータルのセキュリティ・ポリシー

ポータルごとに、独自のセキュリティ・ポリシーがあります。初めてWebCenter Portalインスタンスにポータルをデプロイする場合、ポータルのセキュリティ・ポリシーを組み込む必要があります。再デプロイ時には、セキュリティ・ポリシーはオプションになります。たとえば、ポータルをステージングから本番に再デプロイするときには、多くの場合、本番システム上で行われたポリシーの変更をオーバーライドしないことが重要です。「ポータルのデプロイ」も参照してください。

WebCenter Portalアプリケーション全体のセキュリティ・ポリシー(ホーム・ポータルを含む、すべてのポータル)

WebCenter Portalアプリケーション全体をバックアップ(またはエクスポート)するときには、ホーム・ポータルまたは個々のポータルのセキュリティ・ポリシーがアーカイブに含まれるので、セキュリティ情報をあるインスタンスから別のインスタンスに移動/リストアすることができます。詳細は、「別のターゲットへのWebCenter Portal全体の移行」を参照してください。

WebCenter Portalに対するバックエンドのアイデンティティ・ストアおよび資格証明ストア

別のインスタンスに移行する場合、アイデンティティ・ストア、資格証明ストア、ポリシー・ストアなどの、セキュリティに関するバックエンド・コンポーネントを移行する必要があります。詳細は、「ポリシー・ストアのバックアップおよびリストア(LDAPとデータベース)」および「資格証明ストアのバックアップおよびリストア(LDAPとデータベース)」を参照してください。

34 ポータル、テンプレート、アセットおよび拡張機能のデプロイ

WebCenter Portalには、WebCenter Portalインストールと、ステージング環境または本番環境との間で管理者が情報をデプロイ、バックアップあるいは移動できる一連のユーティリティが用意されています。

この章の内容は次のとおりです。

- ポータルのデプロイ

- ポータル・テンプレートのデプロイ

- アセット、デバイスおよびデバイス・グループのデプロイ

- カスタム共有ライブラリの拡張機能のデプロイ

- ステージングから本番への接続の詳細の移動

- ポータルのディスカッションとページレット・プロデューサのリソースの移行

- 本番でのポータルの伝播および再デプロイ

権限

この章の内容は、システム管理者を対象としています。

ポータル、テンプレート、アセット、接続および拡張機能のデプロイに必要なロールと権限の詳細は、「WebCenter Portalのライフ・サイクル操作の実行に必要な権限」を参照してください。

「管理操作、ロールおよびツールの理解」も参照してください。

34.1 ポータルのデプロイ

この項には次のトピックが含まれます:

- ポータルのデプロイメントについて

- WebCenter Portalを使用したポータルの直接デプロイ

- WLSTを使用したポータルの直接デプロイ

- ポータル・アーカイブのデプロイ

34.1.1 ポータルのデプロイメントについて

ポータルを別のポータル・サーバーにデプロイする場合、ターゲット・サーバーにソース・ポータルをコピーして、ソース・ポータルのデータの全部または一部を含めるよう選択できます。

ポータルの初期デプロイメントの後、ポータルを再デプロイすること、またはポータルの変更のみをターゲットに伝播することを選択できます。ポータルを再デプロイする場合、これは単純に削除されて新しいポータルとして再作成されます。ポータル伝播では、ポータルに加えられた増分変更のみがターゲット・サーバーにプッシュされます。

ポータルは、次の方法でデプロイできます。

- ポータルの直接デプロイメント - ターゲット・サーバーへの直接接続が存在する場合、WebCenter Portal管理を使用してポータルをターゲット・サーバーにデプロイできます。deployWebCenterPortalのWLSTコマンドを使用してポータルをターゲット・サーバーに直接デプロイすることもできます。詳細は、「WebCenter Portalを使用したポータルの直接デプロイ」および「WLSTを使用したポータルの直接デプロイ」を参照してください。

- ポータル・アーカイブのデプロイメント - WebCenter Portal管理を使用して、ソース・ポータルのアーカイブ(.parファイル)をエクスポートして、アーカイブ・ポータルをターゲット・サーバーにインポートできます。WLSTコマンドを使用して、ポータルをアーカイブにエクスポートして、ポータルをファイルからインポートすることもできます。
詳細は、「ポータル・アーカイブのインポートとエクスポート」を参照してください。

ポータルとともに常にデプロイされる情報

ポータルがデプロイされるとき、常に、次の詳細が含まれます。

- ポータル・ページ

- ポータル・アセット: ページ・テンプレート、リソース・カタログ、スキン、ページ・スタイル、コンテンツ・プレゼンタ表示テンプレート、タスク・フロー・スタイル、タスク・フロー、レイアウト、ページレット、データ・コントロール、視覚化テンプレート、データ視覚化(依存ビジネス・オブジェクトとデータ・ソースを含む)、ビジネス・オブジェクト、データ・ソース(その接続を含む)

- ポータルのアクティビティおよび使用状況データ: アクティビティ・ストリーム、カレンダ・イベント、フィードバック、リスト、リンク、メッセージ・ボード、ピープル・コネクション、プロファイルおよびアンケート

- ポータルのセキュリティ・データ: ポータル・ロールと権限、およびメンバーの詳細とそのロールの割当て

ポータルとともにオプションでデプロイ可能な情報

ポータルをデプロイするとき、オプションで、ポータルのデプロイメントの一部として次のものを含めることを選択できます。

- ポータルのコンテンツ: ポータルのドキュメントおよび関連するコンテンツが、Content Serverのポータルのコンテンツ・フォルダに配置されます。ポータルのデプロイメント中にコンテンツ・フォルダを移動しない場合、WebCenter Content Serverの移行ツールを使用してフォルダをターゲットに手動で移動できます。詳細は、『Oracle WebCenter Contentの管理』のシステムの移行とアーカイブに関する項を参照してください。
ポータルのデプロイメントには、ポータル独自のコンテンツ・フォルダの外部に格納されているコンテンツは含められません。ポータルにポータル・アセット、ポータル・ページ、コンテンツ・プレゼンタ表示テンプレート、またはポータルのコンテンツ・フォルダの外部のコンテンツを参照する他のコンポーネントが含まれる場合、それらのコンテンツを手動で移動するか、ターゲットがソースと同じコンテンツにアクセスできるようにする必要があります。ポータルを別のターゲットに移動する場合、コンテンツ・プレゼンタのデータ参照は、Content Serverの接続名とルート・フォルダ名がソースとターゲットの両方で同じ場合のみ維持されます。

- 共有アセット: ポータルのデプロイ中に、ポータルによって使用されるすべての共有アセットをデプロイすることを選択できます。

- 共有ライブラリ: ポータルのデプロイ中に、ポータルによって使用される共有ライブラリをデプロイすることを選択できます。共有ライブラリをデプロイすることを選択した場合は、デプロイされるメインの共有ライブラリはextend.spaces.webappになり、これを他のライブラリに依存するようにできます。デプロイメントの一部として、メインの共有ライブラリのすべての新しいバージョン(新規作成または更新)の依存ライブラリも含められます。ただし、これは依存ライブラリの最初のレベルのみに実行されます。たとえば、extend.spaces.webappはCustomSharedLibrary1に依存し、CustomSharedLibrary1はCustomSharedLibrary2に依存するとします。CustomSharedLibrary1とCustomSharedLibrary2の両方で更新されたバージョンが利用できる場合は、共有ライブラリのデプロイメントの一部として、CustomSharedLibrary1のみが含められます。

ポータルのデプロイメントで含められない情報

一部のポータル情報は、外部に格納されているため、ポータルと同時にデプロイできません。たとえば、次のような情報があります。

- ポータルのコンテンツ・フォルダの外部に格納されたポータル・アセット、コンテンツ・プレゼンタまたはSite Studioで使用されるコンテンツ

- ポータル・ディスカッション

- ポータル・メール

- ポータル分析

- ページレット・プロデューサのリソース

注意:

接続は、個別にエクスポートおよびインポートされます。詳細は、「接続プロパティ・ファイルの理解」を参照してください。

図34-1に、ポータル(およびその関連データ)を別のサーバーに移動できる様々な方法を示します。

図34-1 ターゲット・サーバーへのポータルのデプロイ

ソースWebCenter PortalインストールとターゲットWebCenter Portalインストールが異なる外部サーバーに接続されている状況で、ソース・ポータルに関連付けられた情報がターゲットで必要になる場合、外部ポータル・データを個別に移動する必要があります。

場合によっては、ソースとターゲットの両方で同じ外部サーバーを使用することもあります。たとえば、ポータル・プロデューサ・サーバーまたはOracle Internet Directoryサーバーは、どちらの環境でも共有されます。

注意:
ポータルのエクスポートまたはデプロイ中に、サーバーが停止してクラスタ内の他のサーバーにフェイルオーバーすると、操作が失敗します。ページをリフレッシュして、エクスポートまたはデプロイメント操作を再度実行する必要があります。
50MBを超えるポータルをデプロイする場合は、要件に応じて、ターゲット・サーバー上の最大ファイル・アップロード・サイズを変更してください。詳細は、「コンテンツ・マネージャでのファイル・アップロード・サイズの変更」を参照してください。

ポータルのデプロイメントの問題のトラブルシューティングの詳細は、「Oracle WebCenter Portalのトラブルシューティング」を参照してください。

34.1.2 WebCenter Portalを使用したポータルの直接デプロイ

WebCenter Portal管理を使用して、最初に、ターゲット・サーバーへの接続を作成し、次に、ポータルをターゲット・サーバーに直接デプロイします。ポータルがデプロイされた後、そのデプロイメント・ステータスとデプロイメント履歴を表示できます。

この項には次のトピックが含まれます:

- ポータル・サーバー接続の作成

- WebCenter Portalを使用したポータルのデプロイ

- ポータルのデプロイメント履歴の表示

34.1.2.1 ポータル・サーバー接続の作成

ポータルをデプロイする前に、ターゲット・ポータル・サーバーへの接続を設定する必要があります。

ポータル・サーバー接続を作成する手順は次のとおりです。

1. WebCenter Portalにログオンして、ポータル管理に移動します。

2. 「ツールとサービス」をクリックします。

3. ツールとサービスのリストから、「ポータル・サーバー接続」を選択します。

4. 「作成」をクリックして、ポータル・サーバー接続を作成します。

5. 「ポータル・サーバー接続の作成」セクションで、次の詳細情報を指定します。

a. 「名前」ボックスに、接続の名前を指定します。使用できるのは英数字のみであることに注意してください。

b. 「URL」ボックスに、ターゲット・ポータル・サーバーのURLを次の形式で指定します。
http://targetserverhost:port

ここで、targetserverhost:portは、ポータルをデプロイするポータル・サーバーのホスト名およびポート番号です。

c. 「ユーザー名」ボックスに、ターゲット・サーバーへの接続に使用するユーザー名を入力します。

d. 「パスワード」ボックスに、指定したユーザー名のパスワードを入力します。

6. 「テスト」をクリックして、接続が機能することを確認します。

7. 「作成」をクリックします。
ポータル・サーバーがオフラインであることが原因で接続テストに失敗した場合は、接続が設定され、サーバーが利用可能になると使用できることに注意してください。

34.1.2.2 WebCenter Portalを使用したポータルのデプロイ

注意:

ポータルのデプロイは主にシステム管理者のタスクですが、Portal Server: Deploy権限を他のカスタム・ロールに割り当てることができます。ポータルをデプロイできるユーザー・ロールを制限するために、カスタム・ロールを作成して、この権限をカスタム・ロールに割り当てることをお薦めします。

ポータルのポータル・マネージャ(または委任マネージャ)のみがポータルをデプロイでき、これに加えて、Portal Server: Deploy権限を持つロールも必要です。カスタム・アプリケーション・ロールの作成とロールへのユーザーの追加の詳細は、「アプリケーション・ロールの定義」および「アプリケーション・ロールへのユーザー(およびグループ)の割当て」を参照してください。

WebCenter Portalを使用してポータルをデプロイする手順は次のとおりです。

1. WebCenter Portalで、『Oracle WebCenter Portalでのポータルの構築』のポータル管理へのアクセスに関する項の説明に従って、ポータル管理にアクセスします

2. 「デプロイ」アイコンをクリックします。

3. 「ターゲット・ポータル・サーバー」の下の「サーバー名」リストから、ポータルのデプロイに使用するポータル・サーバー接続を選択します。この接続は、「ポータル・サーバー接続の作成」の説明に従って作成したものです。

4. ポータルのデプロイメントに関するコメントがある場合は、「コメント」ボックスに指定します。

5. 「オプション」セクションで、デプロイメント・オプションを選択します。

- ポータル・コンテンツを含める: Content Serverに格納されるポータル・コンテンツが、ターゲット・サーバー上のポータル・デプロイメントに含まれる必要があることを指定する場合に選択します。

- 共有アセットを含める: ポータルによって使用される共有アセットをデプロイします。共有アセットをデプロイしない場合はチェック・ボックスの選択を解除します。

- 共有ライブラリを含める: ポータルによって使用される共有ライブラリをデプロイします。共有ライブラリをデプロイしない場合はチェック・ボックスの選択を解除します。共有ライブラリをポータル・デプロイメントに含める場合は、共有ライブラリの変更が取得されるように、ポータルのデプロイ後にターゲット・サーバーを再起動する必要があります。

ポータルを初めてデプロイする場合、「変更を伝播するかわりに再デプロイ」チェック・ボックスは無効として表示されます。Expanding the 「詳細の変更」セクションを展開すると、ポータルが(初めて)デプロイされるため、すべてのデータがターゲット・サーバーに送信されるというメッセージが表示されます。ポータルを伝播するとき、このセクションに、前回のデプロイメント以降にポータルに対して加えられた変更が表示されます。

図34-2 ポータルのデプロイ

6. 「デプロイ」をクリックします。

「ポータルのデプロイ」ダイアログには、ポータルのデプロイメントの進捗およびステータスが表示されます。ポータルがデプロイされている間、必要に応じてダイアログを閉じてポータルでの作業を続行することを選択できます。

図34-3 ポータルのデプロイメント・ステータス

7. 「閉じる」をクリックします。

ポータルがデプロイされると、そのデプロイメント履歴とステータスを表示できます。詳細は、「ポータルのデプロイメント履歴の表示」を参照してください。

8. ポータルのデプロイメントに共有ライブラリを含めた場合は、ポータルがデプロイされたターゲット・サーバーを再起動します。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

34.1.2.3 ポータルのデプロイメント履歴の表示

WebCenter Portal管理を使用してポータルのデプロイメント履歴を表示する手順は次のとおりです。

1. 「ポータル」管理ページ(「WebCenter Portal管理のポータル・ページへのアクセス」を参照)で、「ポータルのデプロイメント」をクリックします。

「最新のデプロイメント」タブには、1日以内にデプロイされたポータルのデプロイメント・ステータスが表示されます。

2. ポータルの横の「詳細」リンクをクリックして、デプロイメントの詳細を表示します。

「ポータル・デプロイメント詳細」ダイアログに、ターゲット・サーバーの名前とデプロイメントの日時が表示されます。これには、ポータルのデプロイ中に追加されたコメントも表示されます(ある場合)。

図34-4 ポータル・デプロイメント詳細

3. 「閉じる」をクリックします。

4. 「デプロイメント履歴」タブをクリックします。

タブには、各ポータルのデプロイメント・ステータスが表示されます。

図34-5 デプロイメント履歴

5. ポータルのデプロイメント・ステータスのリンクをクリックします。

これにより、選択したポータルのすべてのデプロイメント操作が表示されます。図34-6は、MyPortalというポータルの2つのレコードを示し、その1つは初期デプロイメント、もう一方は伝播のものです。

図34-6 デプロイメント操作

6. デプロイメント操作の横の「詳細」をクリックします。

これにより、デプロイメント操作に関連するすべての詳細が表示されます。

34.1.3 WLSTを使用したポータルの直接デプロイ

WLSTコマンドdeployWebCenterPortalを使用して、単一のオンライン・ポータルを別のターゲット・サーバーに直接デプロイできます。WLSTを使用してソースのポータルの変更をターゲットに伝播する場合は、deployWebCenterPortalを使用してポータルをデプロイする必要があります。

ポータルをデプロイする前に、いくつかの前提条件タスクを完了する必要があります。全体のプロセスは次のようになります。

- 手順1: ポータルの直接デプロイメントの前提条件の完了

- 手順2: ソース環境でのdeployWebCenterPortalの実行

- 手順3: 新たにデプロイしたポータルのターゲット環境での検証

34.1.3.1 手順1: ポータルの直接デプロイメントの前提条件の完了

WLSTコマンドdeployWebCenterPortalを実行する前に、次の操作を行います。

1. WebCenter Portalがデプロイされている管理対象サーバーの名前がソース環境とターゲット環境で同じであることを検証します。たとえば、WC_Portalなどになります。

管理対象サーバーの名前が一致する場合にのみ、deployWebCenterPortalを実行できます。管理対象サーバー名が異なる場合は、「アーカイブへのポータルのエクスポート」の説明に従い、ポータル・アーカイブのデプロイメントをかわりに使用します。

2. WebLogic ServerのMonitor以上のロールと、WebCenter Portal権限Portals: Manage Security and Configurationを持っていることを確認します。

3. ソースとターゲットのWebCenter Portalの間に接続が存在することを確認します。WebCenter Portal管理を使用して作成された接続がすでに存在している場合は、それを使用してポータルをデプロイすることも、UIを使用して新しいものを作成することもできます。

ソース環境からターゲットへの接続が存在せず、WLSTを使用してそれを作成する場合は、WLSTコマンドadf_createHttpURLConnectionを使用します。

たとえば、ソース環境で次のように実行します。

adf_createHttpURLConnection(appName='webcenter',name='MyWebCenterPortalTarget',
url='http://example.com:7777', user='myuser', password='mypassword',
realm='ProductionRealm')

「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

34.1.3.2 手順2: ソース環境でのdeployWebCenterPortalの実行

ソースWebCenter Portalで、次の操作を行います。

1. ソースWebCenter PortalのOracleホーム・ディレクトリからWLSTツールを起動し、WebCenter Portalの管理サーバーに接続します。

詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

2. WLSTコマンドdeployWebCenterPortalを実行して、ポータルをターゲット・サーバーにデプロイします。

deployWebCenterPortal(appName, portalName, targetConnectionName
[deployCustomizations, deployPortalContent, deploySecurity, deployData,
deployActivities, deploySharedAssets, deployConnections, overwrite, savePortal, deployLog, server,
applicationVersion])

コマンドの構文と説明の詳細は、WebCenter WLSTコマンド・リファレンスのdeployWebCenterPortalに関する項を参照してください。設定するオプションは、特定のデプロイメント要件によって異なります。

次の例では、ターゲット・サーバーに初めてmyPortalという新しいポータルをデプロイします。また、ここでそのすべての関連コンテンツをデプロイし、デプロイ・ログ・ファイルの名前および場所を指定します。

deployWebCenterPortal(appName='webcenter',portalName='myPortal',
targetConnectionName='MyWebCenterPortalTarget', deployPortalContent=1,deployActivities=1,
deployLog='/mydeploylogs/myPortal_deploy.log')

注意:

新しいポータルはセキュリティ・ポリシーがないとインポートできないため、新しいポータルをインポートする場合は必ずdeploySecurity=1を設定してください。

ターゲットに存在するポータルを再デプロイする場合

ターゲット・サーバーにすでに存在するポータルを再デプロイする場合は、deployWebCenterPortalコマンドをoverwrite=1を指定して使用します。次の例では、ターゲットでmyExistingPortalというポータルをバックアップした後、ターゲット・ポータル(overwrite=1)をソース・ポータルで上書きします。ターゲット・ポータルに関連付けられたコンテンツは保持されます。

deployWebCenterPortal(appName='webcenter',portalName='myExistingPortal',
targetConnectionName='MyWebCenterPortalTarget', deployPortalContent=0,overwrite=1,savePortal=1)

3. デプロイメント・ログ・ファイルを調べます。

このファイルは、指定した場所(deployLog)、または一時ディレクトリのPortalDeploy_<timestamp>.logというファイルで入手できます。

34.1.3.3 手順3: 新たにデプロイしたポータルのターゲット環境での検証

ターゲットWebCenter Portalで、次の操作を行います。

1. ターゲットWebCenter Portalにログインします。

2. 新しいポータル・デプロイメントに移動します。

3. ポータルが予想どおりに機能することを検証します。

34.1.4 ポータル・アーカイブのデプロイ

管理者は、WebCenter PortalまたはWLSTコマンドを使用して、ポータル・アーカイブ(.parファイル)を任意のWebCenter Portalインストールにデプロイできます。ターゲット・ポータル・サーバーは、1つ以上のポータルをファイルからデプロイ(またはインポート)するときに稼働している必要があります。

図34-7 ポータル・アーカイブのデプロイ

この項には次のトピックが含まれます:

- ポータル・アーカイブの理解

- アーカイブの保護

- ポータル・アーカイブのエクスポートおよびインポート

- アーカイブへのポータルのエクスポート

- アーカイブからのポータルのインポート

- ポータル・アーカイブの表示および抽出

注意:

ポータルをアーカイブから別のサーバーにデプロイする場合、ポータル伝播を使用して後からポータルに増分更新を行うことはできません。ポータル伝播機能は、ポータルの直接デプロイメントで使用する場合のみ可能です。「本番でのポータルの伝播および再デプロイ」を参照してください。

34.1.4.1 ポータル・アーカイブの理解

単一ポータルのポータル・アーカイブ(.parファイル)を作成することも、同じ.parファイルに複数のポータルをアーカイブすることもできます。

ポータル・アーカイブには、次の内容を含めることができます。

- 1つ以上のポータル・データ・アーカイブ(.pdr)ファイル: ポータル・アーカイブには、アーカイブに追加した各ポータルのPDRが含まれます。PDRには、ポータルのセキュリティ・ポリシーと、ポータルのメタデータ、データおよびコンテンツを取得するメタデータ・アーカイブが含まれます。

- エクスポート・ログ・ファイル(.log): エクスポート・ログ・ファイルには、すべてのポータル、MDSメタデータ・ファイル、およびアーカイブに含まれるデータ(ポータル・データを含むデータベース表の名前)がリスト表示されます。

- connections.xmlファイル: 詳細は、「接続プロパティ・ファイルの理解」を参照してください。

- WebCenter Portalの接続プロパティ・ファイル(connection.properties)

注意:

ポータル・アーカイブ(.parファイル)は、WLSTコマンドlistWebCenterPortalArchiveを使用して抽出できます。

図34-8 ポータル・アーカイブのデプロイメント

34.1.4.1.1 接続プロパティ・ファイルの理解

接続の全部または一部が存在しないWebCenter Portalターゲットでポータルのインポート、デプロイ、伝播またはリストアを行う予定の場合、WLSTコマンドexportWebCenterPortalConnectionsを使用して、ソース環境からconnection.propertiesファイルを生成し、WLSTコマンドimportWebCenterPortalConnectionsを使用して、そのファイルで構成済の存在しない接続をターゲット環境にインポートすることをお薦めします。詳しい手順は、「ファイルからの新しいWebCenter Portal接続のインポート」を参照してください。

注意:

- connection.propertiesファイルは、WLSTコマンドexportWebCenterPortalConnectionsを実行するときにも生成されます。詳細は、「ファイルへのWebCenter Portal接続の詳細のエクスポート」を参照してください。

- ソースWebCenter Portal環境で構成されるすべての接続は、connection.propertiesにエクスポートされます。このファイルの接続情報は、アーカイブのポータルに固有ではありません。

- ターゲットには、新しい接続のみがインポートされます。ターゲット上に存在する接続は無視されます。

接続の詳細の変更

サーバー名やポートなどの一部の接続情報がソース環境とターゲット環境で異なる場合、ポータルのインポート、デプロイ、伝播またはリストアを行う前に、ファイルの接続の詳細を分けて変更することができます。

表34-1に、ソースとターゲットで同じホストを使用しないために別のURLパラメータがターゲットで必要な場合の例を示します。

表34-1 例: ソース環境とターゲット環境で接続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

図34-9に、新しい接続がターゲットに作成される前にソース・パラメータとターゲット・パラメータが変わる場合、接続の詳細をconnection.propertiesで編集する方法を示します。

図34-9 ターゲットでのconnection.propertiesを使用した接続の作成

接続タイプと接続プロパティ

表34-2に、connection.propertiesファイルで取得されるすべての接続と、各種接続タイプでエクスポートされるプロパティを示します。この表には、デプロイメント前に編集できるプロパティと、ターゲットで設定する必要があるプロパティも示されています。

注意:

- 特定の接続タイプに対する必須のプロパティまたはオプションのプロパティなど、個々の接続プロパティの詳細は、該当の接続タイプの章を参照してください。章のリストは、「ツールとサービスの管理」を参照してください。

- 表34-2でデプロイメント時に編集しますか。がはいとなっているプロパティのみをconnection.propertiesで編集することを強くお薦めします。なんらかの理由でデプロイメント時に編集しますか?がいいえのプロパティを編集する必要がある場合は、Fusion Middleware ControlまたはWLSTコマンドを使用してターゲットに接続を移行した後に編集できます。

表34-2 connection.propertiesにエクスポートされる接続プロパティ

接続タイプ

エクスポートされるプロパティ

デプロイメント時に編集しますか。

注意およびデプロイメント後の構成要件

WSRPポートレット・プロデューサ

url

proxyHost

proxyPort

timeout

externalApp

tokenType

defaultUser

issuerName

recipientAlias

はい

はい

はい

いいえ

いいえ

いいえ

いいえ

いいえ

いいえ

デプロイメント後のセキュリティ構成:

registrationProperties

keyStorePath

keyStorePswd

sigKeyAlias

sigKeyPswd

encKeyAlias

encKeyPswd

enforcePolicyURI

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 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

ファイル・システム

path

はい

ワークリスト接続

BPELConnection

いいえ

REST接続

url

はい

接続情報を別のサーバーにデプロイする方法を確認するには、「ステージングから本番への接続の詳細の移動」を参照してください。

34.1.4.2 アーカイブの保護

この項には次のトピックが含まれます:

- アーカイブ・ファイルの保護について

- アーカイブ・ファイルの保護

34.1.4.2.1 アーカイブ・ファイルの保護について

WebCenter Portalは、ポータル・アーカイブをエクスポートまたはインポートするときに実行される検証チェックをサポートします。これにより、破損したファイルや任意のファイルがポータル・サーバーに含まれることが防止され、ポータル・アーカイブが保護されます。

ライフ・サイクル操作に対して、次のいずれかのセキュリティ・レベルを設定することを選択できます。

- 高セキュリティ・モード: 資格証明を格納する外部アプリケーションに対してマップされたExternallySecureLifecycleOperationsカスタム属性を設定し、チェックサム値を格納するファイルを暗号化または復号化します。

- 中程度のセキュリティ・モード: 値enableに対してマップされたSecureLifecycleOperationsカスタム属性を設定します。値をenableに設定するか、空白のままにすると、ライフ・サイクル操作はデフォルトの非セキュア・モードで実行されます。値をenableに設定すると、ライフ・サイクル操作が保護され、チェックサムが暗号化または復号化プロセスに対する資格証明として機能します。

- 非セキュア・モード: デフォルトでは、アーカイブに対するセキュリティ制限なしでライフ・サイクル操作が実行されます。

エクスポート操作中に、チェックサムが計算されて、すべてのライフ・サイクル・アーカイブ(ポータル・アーカイブ、アプリケーション・アーカイブおよびアセット・アーカイブ)に追加されます。チェックサムは、.parまたは.aarファイル内のlifecycle.chkというファイルに格納され、ファイルが暗号化されます。アーカイブのインポート中に、ファイルが復号化されてチェックサム値がフェッチされます。中程度のセキュリティ・モードでは、(内部で計算された)チェックサムが、ファイルを暗号化または復号化するためのパスワードとして機能します。高セキュリティ・モードでは、共有資格証明を持つ外部アプリケーションがパスワードとして使用され、パスワードをフェッチするためにExternallySecureLifecycleOperationsカスタム属性が使用されます。

ライフ・サイクル操作のセキュア・モードを構成するときは、次のことを考慮してください。

- 保護されたソース環境でアーカイブがエクスポートされて、ターゲット環境が保護されていない場合は、アーカイブでセキュリティ検証が実行されません。

- ライフ・サイクル操作が保護されており、アーカイブのインポート中にアーカイブにlifecycle.chkファイルがない場合、セキュリティ違反となり、インポート操作が許可されません。

- ライフ・サイクル操作を保護する必要がある場合は、ターゲットとソースのインスタンスで同じセキュリティ・レベルを設定する必要があります。異なるレベルのセキュリティ・モードはサポートされません。

- 高セキュリティ・モードが設定されている場合、暗号化と復号化が機能するには、ソースとターゲットの両方のインスタンスで同じパスワードを使用する必要があります。

34.1.4.2.2 アーカイブ・ファイルの保護

アプリケーション、ポータルおよびアセットのアーカイブを保護するために、ライフ・サイクル操作に高セキュリティ・モードまたは中程度のセキュリティ・モードのいずれかを設定することを選択できます。

アプリケーション、ポータルおよびアセットのアーカイブを保護する手順は次のとおりです。

1. WebCenter Portalにログオンします。

2. アーカイブを保護するための目的のセキュリティ・モードを構成します。

オプション

手順

高セキュリティ・モードを有効化する

a. ExternallySecureLifecycleOperationsというカスタム・グローバル属性を作成します。

b. カスタム属性の値をenableに設定します。カスタム・グローバル属性の作成の詳細は、「グローバル属性の追加」を参照してください。

中程度のセキュリティ・モードを有効化する

a. 外部アプリケーションを登録して、共有資格証明を指定します。詳細は、「外部アプリケーションの登録」を参照してください。

b. SecureLifecycleOperationsというカスタム・グローバル属性を作成します。外部アプリケーションの名前を値として指定します。カスタム属性の作成の詳細は、「グローバル属性の追加」を参照してください。

34.1.4.3 ポータル・アーカイブのエクスポートおよびインポート

ターゲット・サーバーへの直接接続が存在しない場合、最初にポータルをアーカイブ(.parファイル)にエクスポートしてから、アーカイブをターゲット・サーバーにインポートして、ポータルをデプロイできます。また、ポータルのバックアップを作成して、後で同じインスタンスにリストアする場合にも、ポータル・アーカイブを作成できます。

注意:

ポータルをアーカイブから別のサーバーにデプロイする場合、ポータル伝播を使用して後からポータルに増分更新を行うことはできません。ポータル伝播機能は、ポータルの直接デプロイメントで使用する場合のみ可能です。「本番でのポータルの伝播および再デプロイ」を参照してください。

ポータル・アーカイブをエクスポートしてからインポートするには:

1. 「ポータルのエクスポートの前提条件」で説明するポータル・アーカイブの前提条件をすべて満たします。

2. ソース・ポータルを次のようにエクスポートします。

- WebCenter Portalを使用する場合は、「WebCenter Portal管理を使用したオンライン・ポータルのアーカイブへのエクスポート」を参照してください。

- WLSTを使用する場合は、「WLSTを使用したオンライン・ポータルのアーカイブへのエクスポート」を参照してください。

- REST APIを使用する場合は、「REST APIを使用したポータルのエクスポート」を参照してください

3. (オプション)外部に格納されているデータとコンテンツをターゲットに移行します。

詳細は、「ポータルのディスカッションとページレット・プロデューサのリソースの移行」を参照してください。

4. ターゲットにポータルを次のようにインポートします。

- WebCenter Portalを使用する場合は、「WebCenter Portal管理を使用したポータルのアーカイブからのインポート」を参照してください。

- WLSTを使用する場合は、「WLSTを使用したポータルのアーカイブからのインポート」を参照してください。

- REST APIを使用する場合は、「REST APIを使用したポータルのインポート」を参照してください

34.1.4.4 アーカイブへのポータルのエクスポート

WebCenter Portalで実行するポータルのアーカイブ(.parファイル)を生成できます。ポータル・アーカイブは、WebCenter Portal、exportWebCenterPortalsのWLSTコマンドまたはREST APIを使用して作成できます。

ポータル・アーカイブの作成方法を確認するには、次の項を参照してください。

- ポータルのエクスポートの前提条件

- WebCenter Portal管理を使用したオンライン・ポータルのアーカイブへのエクスポート

- WLSTを使用したオンライン・ポータルのアーカイブへのエクスポート

- REST APIを使用したポータルのエクスポート

34.1.4.4.1 ポータルのエクスポートの前提条件

ポータルをアーカイブ(.parファイル)にエクスポートする前に、次の事項を確認します。

- Content Serverに格納されるポータル・コンテンツ: Content Serverに格納されるポータル・コンテンツをポータル・アーカイブに含める場合、Content Serverが稼働していることを確認します。

- Webサービス・データ・コントロール: エクスポートするポータルにWebサービス・データ・コントロールが含まれる場合、エクスポートが正常に行われるには、関連するすべてのWebサービスが稼働中でアクセス可能である必要があります。

- ポートレット・プロデューサ: エクスポートするポータルにポートレットが含まれる場合、すべてのポートレット・メタデータがアーカイブに含まれるようにするには、関連するすべてのポートレット・プロデューサが稼働中でアクセス可能である必要があります。

- ポータル・フォルダ外部のコンテンツ: ポータル・アセット、ポータル・ページ、コンテンツ・プレゼンタおよびSite Studioで使用される、ポータル・フォルダの外部に格納されているコンテンツ(ファイル、イメージおよびアイコンなど)は、アーカイブに自動的に含まれません。すべての依存ファイルを、ターゲット・コンテンツ・サーバーの適切な場所にコピーする必要があります。

注意:

MDSにアーティファクトを格納するレガジー・ポータル(アセットを含む)を管理する場合、MDSのすべての依存アーティファクトをコンテンツ・サーバーに再配置することをお薦めします。MDSに格納されているアーティファクトを移動しない場合、MDSのWLSTコマンドexportMetadata/importMetadataを使用して、MDSのコンテンツを別のターゲットに移動できます。例:

exportMetadata(application='webcenter', server='WC_Portal',
toLocation='/tmp/content',
docs='/oracle/webcenter/siteresources/scopedMD/shared/**')

importMetadata(application='webcenter', server='WC_Portal',
fromLocation='/tmp/content',
docs='/oracle/webcenter/siteresources/scopedMD/shared/**')

34.1.4.4.2 WebCenter Portal管理を使用したオンライン・ポータルのアーカイブへのエクスポート

Portal Server-Manage Configuration権限により、WebCenter Portal管理を使用してポータルをアーカイブにエクスポートして、ローカル・ファイル・システムまたはリモート・サーバー・ファイル・システムにポータル・アーカイブを保存できます。

注意:

ポータル・テンプレートもエクスポートできますが、別のプロセスになります。ポータルとポータル・テンプレートを1つのアーカイブ内にエクスポートすることはできません。詳細は、「WebCenter Portalを使用したポータル・テンプレートのアーカイブへのエクスポート」を参照してください。

WebCenter Portal管理を使用して1つ以上のポータルをエクスポートする手順は次のとおりです。

1. 「ポータル」管理ページ(「WebCenter Portal管理のポータル・ページへのアクセス」を参照)で、表内の行を強調表示してエクスポートするポータルを選択します。

複数の行を選択するには、[Ctrl]を押しながらクリックします。

注意:

エクスポート・プロセスでのデータの競合を防ぐには、選択したすべてのポータルが、一時的であっても、エクスポート・プロセス中はオフラインになっていることをお薦めします。詳細は、「任意のポータルのオフライン化」を参照してください。

Portals: Manage Security and Configuration権限を持つメンバーは、ポータルがオフラインであってもアクセスできるので、エクスポートの完了中にそのメンバーによって変更が行われないようにします。

2. ツールバーで「エクスポート」をクリックします。

「ポータルのエクスポート」ペインが開きます(図34-10)。選択したすべてのポータルがリスト表示されます。

ポータルを除外する場合は、ポータルの名前の横の「削除」アイコンをクリックします(図34-10の青い十字型のアイコン)。

図34-10 ポータルのエクスポート

3. 「ポータル・アーカイブ」に、ファイル拡張子.parを付けて名前を入力するか、デフォルト名を受け入れます。

ポータル・アーカイブのデフォルトのファイル名では、一意性を保証するため、webcenter_random_number.parのように乱数を使用します。

4. 各ポータルのコンテンツ・フォルダをエクスポートするには、「ポータル・コンテンツを含める」を選択します。

ドキュメント・サービスを使用してポータル・ドキュメント(ファイル、フォルダ、Wiki、ブログ)を作成、管理および格納するポータルの場合、フォルダはWebCenter Portalのコンテンツ・リポジトリに自動的に作成されます。このフォルダに格納されるコンテンツのみをポータルとともにエクスポートできます。たとえば、コンテンツ・プレゼンタで表示されるWebコンテンツやページはポータルのコンテンツ・フォルダに格納されないためエクスポートに含まれません。

注意:

- コンテンツ・フォルダを含めると、ポータル・アーカイブのサイズが大きくなります。大量のポータルや大量のコンテンツ・フォルダをエクスポートする場合、アーカイブがファイルの最大アップロード・サイズ(デフォルトで2GB)を超えないように注意してください。必要な場合は、「最大ファイル・アップロード・サイズの変更」の説明に従い、この設定を大きくすることができます。

- MDSにアーティファクトを格納するレガジー・ポータル(アセットを含む)を管理する場合、MDSのすべての依存アーティファクトをコンテンツ・サーバーに再配置することをお薦めします。MDSに格納されているアーティファクトを移動せず、アセット・アーカイブ内にMDSコンテンツを含めない場合、MDSのWLSTコマンドexportMetadata/importMetadataを使用して、MDSコンテンツを別の機会に移動することができます。例:

exportMetadata(application='webcenter', server='WC_Portal',
toLocation='/tmp/content',
docs='/oracle/webcenter/siteresources/scopedMD/shared/**')

importMetadata(application='webcenter', server='WC_Portal',
fromLocation='/tmp/content',
docs='/oracle/webcenter/siteresources/scopedMD/shared/**')

5. 「共有アセットを含める」を選択して、ポータルで使用される共有アセットをエクスポートします。

6. 「エクスポート」をクリックします。

7. エクスポート・プロセス中に進捗情報が表示されます(図34-11)。

エクスポート・プロセスが完了したら、エクスポート・アーカイブ(.parファイル)の場所を指定します。

図34-11 ポータルのエクスポートが処理中の場合

次のいずれかを選択します。

- ダウンロード: エクスポートの.parファイルはローカル・ファイル・システムに保存されます。
ブラウザでダウンロードされ、アーカイブはローカルに保存されます。実際のダウンロード場所は、ブラウザの設定ごとに異なります。

一部のブラウザには、ダウンロードのサイズを制限する設定があります。エクスポート・アーカイブのサイズが大きくダウンロードされない場合、ブラウザ設定を確認します。

- サーバーに保存: エクスポートの.parファイルはサーバー位置に保存されます。.parファイルはデフォルトのパスDOMAIN_HOME/WC_Archivesに保存され、ここでDOMAIN_HOMEはWebCenter Portalがインストールされたドメインの場所を示しています。
ファイルが保存されたら、「OK」をクリックして、「情報」ダイアログを閉じます。

8. 「閉じる」をクリックして「ポータルのエクスポート」ダイアログを閉じます。

34.1.4.4.3 WLSTを使用したオンライン・ポータルのアーカイブへのエクスポート

WLSTコマンドexportWebCenterPortalsを使用して、1つ以上のポータルをポータル・アーカイブ(.parファイル)にエクスポートします。WLSTを使用してポータル・アーカイブを作成する場合、ポータルのコンテンツ・フォルダと接続情報をアーカイブに含めるかどうかを選択できます。

exportWebCenterPortals(appName, fileName, [names, offlineDuringExport,
exportPortalContent, exportConnections, exportSharedAssets, server, applicationVersion])

設定するオプションは、特定のアーカイブ要件によって異なります。コマンドの構文の詳細は、WebCenter WLSTコマンド・リファレンスのexportWebCenterPortalsに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「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)

34.1.4.4.4 REST APIを使用したポータルのエクスポート

REST APIサポートを使用して、ポータルのポータル・アーカイブ(.parファイル)を生成できます。

REST APIを使用してポータルをエクスポートするには、次の形式のURLを使用します。

http://host:port/rest/api/v1/portal/portals/portal_shortId/archive?utoken=utoken_value

ここで、host: portはポータルが実行されているサーバーのホスト名とポート番号で、portal_shortIdはエクスポートされるポータルのショートIDです。

ポータル・コンテンツもエクスポートする場合は、次のようにincludePortalContentValueパラメータをURLに含めます。

http://host:port/rest/api/v1/portal/portals/portal_shortId/archive?includePortalContent=includePortalContentValue&utoken=utoken_value

includePortalContentのデフォルト値は0です。0より大きい値はtrueとして処理され、ポータル・コンテンツがポータル・アーカイブに含められます。

ポータルをエクスポートするには、wpfas/modules/rest-service/servlet/src/java/oracle/webcenter/jaxrs/services/portal/controller/PortalsResource.javaで、次の形式のGET操作を追加します。

@GET
@Path("{portalId}/archive")
public Response exportPortal(@PathParam("portalId") String portalId,
@DefaultValue(START_INDEX_DEFAULT)
@QueryParam("includePortalContent") int includePortalContent);

GET操作により、ポータルのエクスポートを実行するAPIがコールされます。その後、PARファイルをローカル・クライアントにダウンロードできます。レスポンス・コード200は、ポータルのエクスポートが成功したことを表します。

34.1.4.5 アーカイブからのポータルのインポート

管理者は、アーカイブ・ポータル(.parファイル)を任意のWebCenter Portal Serverにデプロイできます。WLSTコマンドimportWebCenterPortalsを使用してポータル・アーカイブをインポートするか、WebCenter Portal管理を使用できます。

インポートの際、アーカイブに含まれるすべてのポータルは、ターゲット・サーバーで作成または再作成されます。既存のポータルは、削除されてから置き換えられ、新しいポータルが作成されます。ターゲット・サーバーで使用可能なポータルと同じ名前のポータルをインポートする場合、オンラインのポータルは上書きできないため、それらのポータルがターゲット・アプリケーションでオフラインになっていることを確認します。詳細は、「任意のポータルのオフライン化」を参照してください。

注意:

WLSTを使用してポータルをインポートする場合、オプションforceOffline=1を設定して、オンライン・ポータルが自動的にオフラインになるようにすることができます。この方法でオフライン化されたポータルは、インポート・プロセス終了時はオフラインのままです。

ポータルは、同じポータルの同時インポートまたはエクスポートを回避するために、インポート操作中にロックされます。他のユーザーが特定のポータルをインポートする場合、同じポータルをインポート(またはエクスポート)しようとするすべての後続の試みはブロックされます。

1つ以上のポータルをインポートした後で、Oracle Secure Enterprise Searchクロールを開始して、新たにインポートされたデータを索引付けすることを検討してください。

ポータル・アーカイブ・コンテンツ(インポート時のオプション)

ポータル・アーカイブにポータルのコンテンツ・フォルダが含まれる場合があります。含まれる場合、この情報をインポートするかどうかも選択できます。インポート時に、アーカイブのコンテンツ・フォルダによってターゲットのフォルダ(ある場合)が上書きされます。

注意:

コンテンツ・プレゼンタで表示されるWebコンテンツやページはポータルのコンテンツ・フォルダに格納されないため、ポータル・アーカイブには含まれません。

外部ポータル・データ(個別インポート)

ディスカッションなど、外部に格納されるデータはポータルごとに移行できますが、これは個別プロセスになります。「ポータルのディスカッションとページレット・プロデューサのリソースの移行」を参照してください。

ポータル・アーカイブのインポート方法を確認するには、次の項を参照してください。

- ポータルのインポートの前提条件

- WebCenter Portal管理を使用したポータルのアーカイブからのインポート

- WLSTを使用したポータルのアーカイブからのインポート

- REST APIを使用したポータルのインポート

34.1.4.5.1 ポータルのインポートの前提条件

ポータル・アーカイブ(.parファイル)をインポートする前に、次の事項を確認します。

- 共有アイデンティティ・ストア: ソース環境とターゲット環境のユーザーが同じであることを確認します。共有アイデンティティ・ストアを使用しない場合、システム管理者は、ユーザーをターゲットに移行する必要があります。「WebCenter Portalスキーマ・データのバックアップ(エクスポート)」および「WebCenter Portalデータのリストア(インポート)」を参照してください。

- ターゲットに存在するポータル: アーカイブのポータルがターゲットにすでに存在するかどうかを確認します。必要な場合、「任意のポータルのオフライン化」の説明に従って、インポート・プロセスで既存のポータルをオフライン化します。

- Webサービス・データ・コントロール: インポートするポータルにWebサービス・データ・コントロールが含まれる場合、インポートが正常に行われるには、関連するすべてのWebサービスが稼働中でアクセス可能である必要があります。

- ポートレット・プロデューサ: ポータルで使用されるポートレット・プロデューサが、ポータルのインポート時に稼働している必要があります。

- 外部サーバー、アプリケーション、Webサービスおよびポートレット・プロデューサへの接続: 特定の外部接続の構成に依存するポータルは、同様の接続がターゲットに存在しない場合は機能しません。ポータルをインポートする前に、必要なすべての接続がターゲットに存在することを確認します。ターゲットで接続を作成または再構成する場合、ターゲットの管理対象サーバーの再起動が必要になる場合があります。詳細は、「ステージングから本番への接続の詳細の移動」を参照してください。

- アーカイブ・バージョン: WebCenter Portal 11gリリースからポータル・アーカイブをインポートする場合、まず最新リリースのWebCenter Portal 12cにアップグレードし、ポータル・エクスポート・アーカイブ(.parファイル)を再作成してから、それをインポートします。
アップグレードの詳細は、Oracle WebCenterのアップグレードを参照してください

34.1.4.5.2 WebCenter Portal管理を使用したポータルのアーカイブからのインポート

WebCenter Portal管理者は、ポータル・ビルダー管理を使用して1つ以上のポータルおよびポータル階層をポータル・アーカイブからインポートできます。

1つ以上のポータルを.parファイルからインポートするには:

1. 「ポータルのインポートの前提条件」に示されたポータルのインポートの前提条件を満たしていることを確認します。

2. 「ポータル」管理ページ(「WebCenter Portal管理のポータル・ページへのアクセス」を参照)で、ツールバーの「インポート」をクリックします。

「ポータルのインポート」ダイアログが開きます(図34-12)。

図34-12 ポータルのインポート

3. ポータル・アーカイブ(.parファイル)の場所を指定します。次のいずれかを選択します。

- 自分のコンピュータで表示: 場所をテキスト・ボックスに入力します。あるいは、「参照」をクリックして、.parファイルが格納されているディレクトリをローカル・ファイル・システム上で見つけます。

- WebCenter Portalサーバーで表示: WebCenter Portalをデプロイするサーバーのパス(アーカイブ・ファイル名を含む)をテキスト・ボックスに入力します。たとえば、/tmp/MyPortalExport.parのようになります。WebCenter Portalからアクセス可能な共有の場所を指定できます。

4. 「アーカイブの参照」をクリックして、インポートが可能なコンテンツを確認します(図34-13)。

図34-13 ポータルのインポート

指定したアーカイブのすべてのポータルの名前が表に表示されます。「タイプ」列は、アーカイブのポータルとターゲットに存在するポータルとの間に差異があることを示します。

- 新規: この名前のポータルはターゲットに存在しません。インポートの際に新しいポータルが作成されます。

- 置換: この名前のポータルでGUIDが同じポータルがターゲットに存在します。既存のポータルはインポート時に削除され、ポータル・アーカイブのバージョンに置き換えられます。

- 競合: この名前のポータルがターゲットに存在しますが、ターゲットのポータルと、インポートしようとしているポータルのGUIDが異なります。あるいは、このポータルのGUIDと、ターゲットのいずれかのポータルのGUIDが同じですが、ポータル名が一致しません。
インポート・プロセスで、インポートしようとしているポータルとターゲットに存在するポータルとの間に競合が検出された場合、問題を解決する必要があります。たとえば、名前は一致してもGUIDが異なるために競合が発生している場合は、ソース・ポータルの名前を変更して新しいエクスポート・アーカイブを作成するか、ターゲット・アプリケーションの競合ポータルの名前を変更して同じアーカイブをインポートします。

5. 必要に応じて、インポートのオプションを設定します。詳細は、表34-3を参照してください。

表34-3 ポータルのインポートのオプション

フィールド

説明

ポータル・コンテンツを含める

(指定したアーカイブに1つ以上のポータルのコンテンツ・フォルダが含まれる場合のみ表示されます。)

これを選択すると、アーカイブに含まれるすべてのコンテンツ・フォルダがインポートされます。ターゲットに存在するフォルダはインポート時に上書きされます。

このオプションの選択を解除すると、ポータルのコンテンツ・フォルダ(ある場合)は除外されます。このオプションは、ステージ環境と本番環境の間を移行する場合や、テスト・コンテンツが不要になった場合に便利です。

注意: 大きいコンテンツ・フォルダを含むポータル・アーカイブは、ファイルの最大アップロード・サイズを超える場合があります(デフォルトでは2GB)。importWebCenterPortals WLSTコマンドを使用して、現在のアップロード・サイズを超えるポータル・アーカイブをインポートすることをお薦めします。「WLSTを使用したポータルのアーカイブからのインポート」を参照してください。必要な場合は、「最大ファイル・アップロード・サイズの変更」の説明に従い、アップロード設定を大きくすることができます。

共有アセットを含める

ポータルで使用される、スキンまたはページ・テンプレートなどの共有アセットをインポートする場合に選択します。

6. 「インポート」をクリックします。

- ターゲットのWebCenter Portalアプリケーションに存在するポータルをインポートしようとすると、「ポータル置換の確認」ダイアログが表示されます。既存のポータルを上書きするかどうかを確認する必要があります。
既存のポータルを削除してインポート・バージョンで置き換えるには、「はい」をクリックします。インポート・プロセスを取り消すには、「いいえ」をクリックします。

- インポート・プロセスで、インポートしようとしているポータルとターゲットに存在するポータルとの間に競合が検出された場合、問題の解決に役立つメッセージが表示されます。たとえば、ターゲット・アプリケーションのポータルとインポートしようとしているポータルの名前が同じでGUIDが異なる場合、競合メッセージが表示されます。この場合は、ソース・ポータルの名前を変更して新しいエクスポート・アーカイブを作成するか、ターゲット・アプリケーションの競合ポータルの名前を変更して同じアーカイブをインポートできます。

- ポータル・アーカイブがファイルの最大アップロード・サイズ(デフォルトで2GB)を超える場合、ポータルはインポートできません。importWebCenterPortals WLSTコマンドを使用して、現在のアップロード・サイズを超えるポータル・アーカイブをインポートすることをお薦めします。詳細は、「WLSTを使用したポータルのアーカイブからのインポート」を参照してください。必要に応じて、アップロード設定を増やすことができます。詳細は、「最大ファイル・アップロード・サイズの変更」を参照してください。

注意:

- MDSにアーティファクトを格納するレガジー・ポータル(アセットを含む)を使用する場合、MDSのすべての依存アーティファクトをコンテンツ・サーバーに再配置することをお薦めします。MDSに格納されているアーティファクトを移動せず、アセット・アーカイブ内にMDSコンテンツを含めない場合、MDSのWLSTコマンドexportMetadata/importMetadataを使用して、MDSコンテンツを別の機会に移動することができます。例:

exportMetadata(application='webcenter', server='WC_Portal',
toLocation='/tmp/content',
docs='/oracle/webcenter/siteresources/scopedMD/shared/**')

importMetadata(application='webcenter', server='WC_Portal',
fromLocation='/tmp/content',
docs='/oracle/webcenter/siteresources/scopedMD/shared/**')

情報メッセージが表示されます。

7. 「はい」をクリックしてポータルのインポートを確定します。

すべてのポータルが正常にインポートされると、情報メッセージが表示されます(図34-14)。

図34-14 ポータルが正常にインポートされた場合

8. 「閉じる」をクリックして「ポータルのインポート」ウィンドウを閉じます。

通常、新しいポータルを使用できるようにするには、ある程度の追加作業が必要です。そのため、新しくインポートされたすべてのポータルは、最初はオフラインになっています。たとえば、次のような操作を一時的に行う場合があります。

- バックエンド・コンポーネントに関連付けられたデータの移行。詳細は、「ポータルのディスカッションとページレット・プロデューサのリソースの移行」を参照してください。

- メンバーの追加や招待。

- ツールとサービスの有効化または無効化。

ポータルのコンテンツとメンバーシップの詳細をファイナライズすると、ポータルを再度オンラインにすることができます。「任意のポータルの再オンライン化」を参照してください。

34.1.4.5.3 WLSTを使用したポータルのアーカイブからのインポート

WLSTコマンドimportWebCenterPortalsを使用して、1つ以上のアーカイブ・ポータルをWebCenter Portalにインポートします。

importWebCenterPortals(appName, fileName, [names, parentPortal,
importCustomizations, importPortalContent, importSecurity, importData,
importActivities, overwrite, savePortals, forceOffline, importLog, importConnections, connPropertiesFile, importSharedAssets, server, applicationVersion])

WLSTを使用してポータルをインポートする場合、アーカイブ内のすべての内容をインポートする必要はありません。アーカイブに複数のポータルが含まれる場合、インポートするポータルのみを指定できます。ポータルとともにどの程度の情報をインポートするかも指定できます。たとえば、ポータルのコンテンツ・フォルダまたは共有アセットをインポートするかどうかを選択できます。これらのオプションは、テスト環境から、テスト関連のデータやコンテンツが必ずしも必要ではないステージング環境または本番環境にポータルを移動する場合などに役立ちます。

設定するオプションは、特定の要件によって異なります。コマンドの構文の詳細は、WebCenter WLSTコマンド・リファレンスのimportWebCenterPortalsに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「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', importPortalContent=0, importActivities=0, overwrite=1, savePortals=1)

34.1.4.5.4 REST APIを使用したポータルのインポート

REST APIを使用して、ポータルをWebCenter Portalにインポートできます。

REST APIを使用してポータルをインポートするには、次の形式のURLを使用します。

http://host:port/rest/api/v1/portal/portals?utoken=<utoken_value>

ここで、host:portはポータルをインポートするサーバーのホスト名およびポート番号です。

ポータルをインポートするには、wpfas/modules/rest-service/servlet/src/java/oracle/webcenter/jaxrs/services/portal/controller/PortalsResource.javaで、次の形式のPOST操作を追加します。

@POST
@Consumes({MediaType.MULTIPART_FORM_DATA, MediaType.APPLICATION_OCTET_STREAM})
@ResourceType("urn:oracle:webcenter:portal:portals")

public Response importPortal(MultiPart multiPartData,
@DefaultValue(START_INDEX_DEFAULT)
@QueryParam("includePortalContent") int includePortalContent);

POST操作を使用してポータルのインポートを実行するには、コンテンツ・タイプがmultipart/form-dataとして指定されている必要があります。マルチパート形式では、各パートはオブジェクトのデータの連続する部分です。各オブジェクトのパートは、個別に任意の順序でアップロードできます。いずれかのパートの送信が失敗した場合は、他のパートに影響を与えることなくそのパートを再送信できます。また、POST操作では、fileNameキーにマップされるポータル・アーカイブのファイル名も必要です。

34.1.4.6 ポータル・アーカイブの表示および抽出

WLSTコマンドlistWebCenterPortalArchiveを使用して、ポータル・アーカイブ(.parファイル)のコンテンツを表示します。必要に応じて、ポータル・アーカイブのコンテンツを、選択した場所に抽出することもできます。コマンドの構文の詳細は、『WebLogic Server WLSTコマンド・リファレンス』のlistWebCenterPortalArchiveに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

34.2 ポータル・テンプレートのデプロイ

管理者は、ポータル・テンプレートをWebCenter Portalからエクスポートして、そのテンプレートを別のポータル・サーバーにデプロイできます。デフォルトのテンプレートはエクスポートできません。

エクスポートおよびインポート・ユーティリティは、WebCenter Portalインスタンス間での情報の移動に主に使用されますが、ポータル・テンプレートのエクスポート機能は、バックアップ・サービスとしても役立ち、他のユーザーとのテンプレートの共有と交換にも便利です。

ポータル・テンプレートには、ページ、ドキュメント、ポータル・アセットおよびセキュリティ情報(カスタム・ロールやメンバーの詳細など)を含めることができます。すべてのテンプレート・データがポータル・テンプレート・アーカイブに含まれる場合、ポータル・テンプレートを別のWebCenter Portal Serverにデプロイする際にテンプレート・データをターゲットに手動で移行する必要はありません。

ドキュメント・サービス(ファイル、フォルダ、Wiki、ブログ)を使用するポータル・テンプレートは、WebCenter Portalのバックエンド・コンテンツ・リポジトリにコンテンツ・フォルダを自動的に持ちます。WebCenter Portal管理を使用してポータル・テンプレートをエクスポートする場合、このフォルダに格納されるコンテンツは、自動的にポータル・テンプレート・アーカイブに含まれるため、別のターゲット・サーバーへのデプロイメントが容易になります。

WLSTコマンドexportWebCenterPortalTemplatesを使用してポータル・テンプレートをエクスポートする場合、コンテンツ・フォルダはオプションになります。

注意:

ポータル・テンプレート・アーカイブには、ポータル・テンプレートで参照されるWebコンテンツやページ(他の場所に格納される)は含まれません。たとえば、コンテンツ・プレゼンタで表示される情報(ポータル・テンプレートのコンテンツ・フォルダに格納されない)などがあります。WebCenter Portalのバックエンド・コンテンツ・リポジトリでポータル・テンプレートに割り当てられたフォルダのみが、ポータル・テンプレート・アーカイブに含まれます。

この項には次のトピックが含まれます:

- ポータル・テンプレートのエクスポート

- ポータル・テンプレートのインポート

34.2.1 ポータル・テンプレートのエクスポート

管理者は、WLSTコマンドexportWebCenterPortalTemplatesを使用して、1つ以上のポータル・テンプレートをアーカイブにエクスポートできます。あるいは、管理者とアプリケーション・スペシャリストは、WebCenter Portal管理を使用して、ポータル・テンプレートをアーカイブにエクスポートできます。

この項には次のトピックが含まれます:

- WebCenter Portalを使用したポータル・テンプレートのアーカイブへのエクスポート

- WLSTを使用したポータル・テンプレートのアーカイブへのエクスポート

34.2.1.1 WebCenter Portalを使用したポータル・テンプレートのアーカイブへのエクスポート

アプリケーション・スペシャリスト(およびPortal Templates: Manage All権限を持つその他のユーザー)は、WebCenter Portalからポータル・テンプレートをエクスポートできます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル・テンプレートのエクスポートに関する項を参照してください。

注意:

ポータルとポータル・テンプレートを1つのアーカイブ内にエクスポートすることはできません。ポータルのエクスポートは個別のプロセスになります。詳細は、「WebCenter Portal管理を使用したオンライン・ポータルのアーカイブへのエクスポート」を参照してください。

34.2.1.2 WLSTを使用したポータル・テンプレートのアーカイブへのエクスポート

WLSTコマンドexportWebCenterPortalTemplatesを使用して、1つ以上のポータル・テンプレートをアーカイブ(.parファイル)にエクスポートします。WLSTを使用してポータル・テンプレート・アーカイブを作成する場合、ポータルのコンテンツ・フォルダをアーカイブに含めるかどうかを選択できます。

exportWebCenterPortalTemplates(appName, fileName, [names,
exportPortalTemplateContent, exportConnections, server, applicationVersion])

設定するオプションは、特定のアーカイブ要件によって異なります。コマンドの構文の詳細は、WebCenter WLSTコマンド・リファレンスのexportWebCenterPortalTemplatesに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「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')

34.2.2 ポータル・テンプレートのインポート

管理者は、WLSTコマンドimportWebCenterPortalsを使用して、1つ以上のポータル・テンプレートをWebCenter Portal Serverにデプロイできます。あるいは、管理者とアプリケーション・スペシャリストは、WebCenter Portal管理を使用して、ポータル・テンプレートをアーカイブからインポートできます。

インポート時に、アーカイブに含まれるすべてのポータル・テンプレートがターゲット・アプリケーションで再作成されます。ターゲットにポータル・テンプレートが存在する場合は、削除されて置き換えられます。ポータル・テンプレートが存在しない場合は作成されます。

新たにインポートされたポータル・テンプレートは、すぐには使用できません。すべてのユーザーが使用できるようにするには、新たにインポートされたテンプレートを公開する必要があります。『Oracle WebCenter Portalでのポータルの構築』のポータル・テンプレートの公開または非表示に関する項を参照してください。

この項には次のトピックが含まれます:

- WebCenter Portalを使用したポータル・テンプレートのアーカイブからのインポート

- WLSTを使用したポータル・テンプレートのアーカイブからのインポート

34.2.2.1 WebCenter Portalを使用したポータル・テンプレートのアーカイブからのインポート

アプリケーション・スペシャリスト(およびPortal Templates: Manage All権限を持つその他のユーザー)は、WebCenter Portalにポータル・テンプレートをインポートできます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル・テンプレートのインポートに関する項を参照してください。

34.2.2.2 WLSTを使用したポータル・テンプレートのアーカイブからのインポート

WLSTコマンドimportWebCenterPortalsを使用して、1つ以上のポータル・テンプレートをアーカイブ(.parファイル)からインポートします。WLSTを使用してポータル・テンプレート・アーカイブをインポートする場合、テンプレートのコンテンツ・フォルダをインポートするかどうかを選択できます。

importWebCenterPortals(appName, fileName, [names], [parentPortal], [importCustomizations], [importPortalContent], [importSecurity], [importData], [importActivities], [overwrite], [savePortals], [forceOffline], [importLog], ]importConnections], [connPropertiesFile], [importSharedAssets], [server], [applicationVersion])

設定するオプションは、特定のアーカイブ要件によって異なります。コマンドの構文の詳細は、WebCenter WLSTコマンド・リファレンスのimportWebCenterPortalsに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「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')

34.3 アセット、デバイスおよびデバイス・グループのデプロイ

認可されたユーザーは、WebCenter Portalの実行時に、スキンおよびページ・テンプレートなどのアセットをダウンロードし、Oracle JDeveloperなどのツールでそれらのアセットを編集および拡張してから、WebCenter Portalにデプロイしなおすことができます。アセットを他のWebCenter Portalインスタンスと共有するユーザーやWebCenter Portalインスタンスに移行するユーザーも、ダウンロード機能とアップロード機能を使用できます。

WebCenter Portalユーザーは、WebCenter Portalを使用して次のアセットをダウンロードおよびアップロードでき、管理者は、WLSTコマンドを使用して同じタスクを実行できます。

- ページ・テンプレート

- リソース・カタログ

- スキン

- ページ・スタイル

- コンテンツ・プレゼンタ表示テンプレート

- 可視化

- ページレット

- ビジネス・オブジェクト

- タスク・フロー・スタイル

- タスク・フロー

- レイアウト

- データ・コントロール

- データ・ソース

注意:

個々のページレットのアップロードまたはダウンロードはできませんが、個々のポータルやWebCenter Portalインスタンス全体を移行するときにすべてのアセット(ページレットを含む)が含まれます。

WebCenter Portalのアセットをダウンロード(またはエクスポート)する場合、アセットの詳細はエクスポート・アーカイブ(.aarファイル)に保存されます。希望のファイル名を使用して、エクスポート・アーカイブをローカル・ファイル・システムまたはリモート・サーバー・ファイル・システムに保存することができます。アセットによって使用または参照されるアイコンやイメージなどのアーティファクトは、それらがContent Serverのポータルのコンテンツ・フォルダに格納されてコンテンツ・フォルダがソース・サーバーとターゲット・サーバーで同期している場合を除いて、エクスポート・アーカイブまたはインポート・アーカイブに含まれません。

デバイスおよびデバイス・グループ

管理者は、デバイス・グループおよびデバイスをファイル(.aarファイル)にエクスポートし、これらを別のWebCenter Portalインスタンスにインポート(デプロイ)できます。たとえば、ステージングで開発されたデバイスまたはデバイス・グループを本番サーバーに移動する場合や、デバイスおよびデバイス・グループを別のWebCenter Portalインストールと共有する場合などがあります。

注意:

デフォルトのデバイス・グループやデバイスをエクスポートまたはインポートすることはできません。自分や他の管理者が作成またはコピーしたデバイス・グループやデバイスのみをエクスポートおよびインポートできます。

この項には次のトピックが含まれます:

- アーカイブへのアセット、デバイスおよびデバイス・グループのエクスポート

- アーカイブからのアセットのインポート

34.3.1 アーカイブへのアセット、デバイスおよびデバイス・グループのエクスポート

この項では、アセット、デバイスおよびデバイス・グループのアーカイブを作成する様々な方法について説明します。次のトピックが含まれています:

- WebCenter Portalからアーカイブへのアセットのエクスポート

- アーカイブへのデバイスおよびデバイス・グループのエクスポート

- WLSTを使用したアーカイブへのアセット、デバイスまたはデバイス・グループのエクスポート

- REST APIを使用したアセットのエクスポート

「アセットのインポート(またはエクスポート)に必要な権限について」も参照してください。

34.3.1.1 WebCenter Portalからアーカイブへのアセットのエクスポート

管理者、アプリケーション・スペシャリストおよびポータル・マネージャは、WebCenter Portalからアセットをエクスポートできます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のアセットのダウンロードに関する項を参照してください。

34.3.1.2 アーカイブへのデバイスおよびデバイス・グループのエクスポート

この項には次のトピックが含まれます:

- WebCenter Portalを使用したデバイスおよびデバイス・グループのエクスポート

- WLSTを使用したデバイスおよびデバイス・グループのエクスポート

34.3.1.2.1 WebCenter Portalを使用したデバイスおよびデバイス・グループのエクスポート

管理者は、WebCenter Portal管理から1つ以上のデバイスおよびデバイス・グループをファイル(.parファイル)にエクスポートできます。詳細は、「デバイスおよびデバイス・グループのライフ・サイクルの管理」を参照してください。

34.3.1.2.2 WLSTを使用したデバイスおよびデバイス・グループのエクスポート

管理者は、WLSTコマンドexportWebCenterResourceを使用して、WebCenter Portalの単一のデバイスまたはデバイス・グループをエクスポート・アーカイブ(.aarファイル)にエクスポートできます。

exportWebCenterResource(appName, fileName, resourceType, [resourceGUID, resourceName, spaceName, exportContentDirectory, server,
applicationVersion])

コマンドの構文の詳細は、WebCenter WLSTコマンド・リファレンスのexportWebCenterResourceに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

次に例を示します。

例1: デバイス・グループのエクスポート

次の例では、WebCenter Portalの「MyMobileDeviceGroup」というデバイス・グループをエクスポートします。

exportWebCenterResource(appName='webcenter', fileName='myDeviceGroupExport.aar',
resourceType='deviceGroup', resourceName='MyMobileDeviceGroup)

例2: デバイスのエクスポート

次の例では、WebCenter Portalの「MyMobileDevice」というデバイスをエクスポートします。

exportWebCenterResource(appName='webcenter', fileName='myDeviceExport.aar',
resourceType='device', resourceName='MyMobileDevice)

34.3.1.3 WLSTを使用したアーカイブへのアセット、デバイスまたはデバイス・グループのエクスポート

管理者は、WLSTコマンドexportWebCenterResourceを使用して、単一アセット、デバイスまたはデバイス・グループをWebCenter Portalからエクスポートできます。

exportWebCenterResource(appName, fileName, resourceType, [resourceGUID,
resourceName, spaceName, exportContentDirectory, server, applicationVersion])

設定するオプションは、エクスポートするアセット、デバイスまたはデバイス・グループによって異なります。コマンドの構文の詳細は、WebCenter WLSTコマンド・リファレンスのexportWebCenterResourceに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

次に例を示します。

例1: 「Sales」ポータルに属するページ・テンプレートのエクスポート

次の例では、Salesポータルのページ・テンプレートをmySalesPageTemplateExport.aarというファイルにエクスポートします。

exportWebCenterResource(appName='webcenter',
fileName='mySalesPageTemplateExport.aar', resourceType='pageTemplate',
resourceGUID='gsr47d9a5ac_7398_439a_97d2_8b54ce905f7e, spaceName='SalesPortal')

例2: GUIDで識別する共有ポータル・スキンのエクスポート

次の例では、共有ポータル・スキンをmySharedSkinExport.aarというファイルにエクスポートします。

exportWebCenterResource(appName='webcenter', fileName='mySharedSkinExport.aar',
resourceType='skin', resourceGUID='gsr5a8c2fcc_bc7f_4cba_9254_36df58d66e60)

例3: 名前で識別する共有ポータル・スキンのエクスポート

次の例では、同じ共有ポータル・スキンをエクスポートしますが、GUIDではなくスキンの表示名を指定します。

exportWebCenterResource(appName='webcenter', fileName='mySharedSkinExport.aar',
resourceType='skin', resourceName='MyCompanySkin)

例4: デバイス・グループのエクスポート

次の例では、WebCenter Portalの「MyMobileDeviceGroup」というデバイス・グループをエクスポートします。

exportWebCenterResource(appName='webcenter', fileName='myDeviceGroupExport.aar',
resourceType='deviceGroup', resourceName='MyMobileDeviceGroup)

例5: デバイスのエクスポート

次の例では、WebCenter Portalの「MyMobileDevice」というデバイスをエクスポートします。

exportWebCenterResource(appName='webcenter', fileName='myDeviceExport.aar',
resourceType='device', resourceName='MyMobileDevice)

34.3.1.4 REST APIを使用したアセットのエクスポート

Oracle WebCenter Portalには、特定のアセットをポータルまたは共有アセット領域からアーカイブ(.aar)にダウンロードするためのREST APIが用意されています。

REST APIを使用してアセットをエクスポートするには、次の形式のURLを使用します。

http://host:port/rest/api/v1/portal/typeOfAsset/assetId/archive?utoken=utokenvalue

ここで、typeOfAssetはページ・テンプレート、スキン、視覚化テンプレート、リソース・カタログなどのエクスポートするアセットを示します。

アセットをエクスポートするには、wpfas/modules/rest-service/servlet/src/java/oracle/webcenter/jaxrs/services/portal/controller/AssetTypeResource.javaで、次の形式のGET操作を追加します

@GET
@Path("{id}/archive")
public Response exportPortal(@PathParam("id") String id);

ここで、PathParamのidはエクスポートされるアセットのショートIDです。

34.3.2 アーカイブからのアセットのインポート

WebCenter Portalのアセット・エクスポート・アーカイブ(.aarファイル)に以前に保存されたアセットのみをインポートできます。詳細は、「アーカイブへのアセット、デバイスおよびデバイス・グループのエクスポート」を参照してください。

インポート時:

- 既存のアセット、つまり、同じ内部IDを持つアセットが上書きされます。

- ポータル・アセットは、常に同じポータルにインポートされます。リソースを別のポータルにインポートできません。

この項では、アセットをアーカイブからWebCenter Portalにインポートする様々な方法について説明します。次のトピックが含まれています:

- アセットのインポート(またはエクスポート)に必要な権限について

- WebCenter Portalを使用したアセットのアーカイブからのインポート

- WLSTを使用したアセットのアーカイブからのインポート

34.3.2.1 アセットのインポート(またはエクスポート)に必要な権限について

表34-4に、WebCenter Portal管理を使用したアセットのインポート(またはエクスポート)に必要なロールと権限を示します。

注意:

WLSTを使用してアセットをインポート(またはエクスポート)するには、WebLogic ServerのMonitorロール(またはそれ以上のロール)も必要です。

表34-4 WebCenter Portalを使用したアセットのインポート(またはエクスポート)に必要な権限

アセット

WebCenter Portalの必要なロールまたは権限

説明

共有アセット

- Administrator

または

- このロールには、共有アセットをインポートおよびエクスポートするために必要な権限が含まれています(Create, Edit, Delete AssetsおよびManage Configuration)。「アプリケーション・ロールおよび権限の管理」も参照してください。

共有アセット

- Create, Edit, Delete <リソース・タイプ>

- この権限を使用すると、WebCenter Portalの共有アセットを作成および管理できます。

- Manage Configuration

- このアプリケーションレベルの権限(Manage Configuration)により、WebCenter Portalの管理ページにアクセスできます。

ポータル・アセット

- Portal Manager

または

- このロールには、必要な権限(Create, Edit, Delete AssetsおよびManage Configuration)が含まれています。「アプリケーション・ロールおよび権限の管理」も参照してください。

ポータル・アセット

- Create, Edit, Delete Resources (標準)
または

Create, Edit, Delete <resourcetype> (拡張)

- これらの権限を使用すると、特定のポータルのアセットを作成および管理できます。ポータルに応じて、標準またはアドバンスト権限のいずれかが適用されます。

- Manage Configuration

- このポータルレベルの権限(Manage Configuration)により、特定のポータルのアセット管理ページにアクセスできます。

34.3.2.2 WebCenter Portalを使用したアセットのアーカイブからのインポート

管理者、アプリケーション・スペシャリストおよびポータル・マネージャは、WebCenter Portalからアセットをインポートできます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のアセットのアップロードに関する項を参照してください

34.3.2.3 WebCenter Portalを使用したデバイスおよびデバイス・グループのインポート

管理者は、WebCenter Portal管理を使用して1つ以上のデバイスおよびデバイス・グループをファイル(.parファイル)からインポートできます。詳細は、「デバイスおよびデバイス・グループのライフ・サイクルの管理」を参照してください。

34.3.2.4 WLSTを使用したアセットのアーカイブからのインポート

管理者は、WLSTコマンドimportWebCenterResourceを使用して、単一アセット、デバイスまたはデバイス・グループをWebCenter Portalにデプロイできます。

importWebCenterResource(appName, fileName, [resourceType, spaceName,
overwriteContentDirectory, server, applicationVersion])

設定するオプションは、デプロイするアセット、デバイスまたはデバイス・グループによって異なります。コマンドの構文の詳細は、WebCenter WLSTコマンド・リファレンスのimportWebCenterResourceに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

次に例を示します。

例1: 「Sales」ポータルへのページ・テンプレートのデプロイ

次の例では、mySalesPageTemplateExport.aarにアーカイブされているページ・テンプレートをSalesポータルにインポートします。

importWebCenterResource(appName='webcenter',
fileName='mySalesPageTemplateExport.aar', resourceType='pageTemplate',
spaceName='SalesPortal')

例2: 共有ポータル・スキンのデプロイ

次の例では、mySharedSkinExport.aarにアーカイブされている共有ポータル・スキンをインポートします。

importWebCenterResource(appName='webcenter', fileName='mySharedSkinExport.aar',
resourceType='skin')

例3: デバイス・グループのデプロイ

次の例では、myDeviceGroupExport.aarにエクスポートされたデバイス・グループをインポートします。

importWebCenterResource(appName='webcenter', fileName='myDeviceGroupExport.aar',
resourceType='deviceGroup')

例4: デバイスのデプロイ

次の例では、myDeviceExport.aarにアーカイブされているデバイスをインポートします。

importWebCenterResource(appName='webcenter', fileName='myDeviceExport.aar',
resourceType='device')

34.3.2.5 REST APIを使用したアセットのインポート

Oracle WebCenter Portalには、特定のアセットをポータルまたは共有アセット領域からアーカイブ(.aarファイル)にダウンロードするためのREST APIが用意されています。

REST APIを使用してアセットをエクスポートするには、次の形式のURLを使用します。

http://host:port/rest/api/v1/portal/portals/portalShortId/typeOfAsset?utoken=utokenvalue

ここで、typeOfAssetはページ・テンプレート、スキン、視覚化テンプレート、リソース・カタログなどのエクスポートするアセットで、portalShortIdはアセットがインポートされるポータルのショートIDを示します。

ポータルまたは共有アセット領域にアセットをインポートするには、wpfas/modules/rest-service/servlet/src/java/oracle/webcenter/jaxrs/services/portal/controller/PortalsReosurce.javaで、次の形式のPOST操作を追加します。

@POST
@Consumes({MediaType.MULTIPART_FORM_DATA, MediaType.APPLICATION_OCTET_STREAM})
@Path("{portalId}/<typeOfAsset>")
@ResourceType("urn:oracle:webcenter:portal:<assetType>")
public Response importPortal(@PathParam("portalId") String portalId,
MultiPart multiPartData);

ここで、PathParamのportalIdはアセットがインポートされるポータルのショートIDで、multipartDataはアップロードに使用されるファイルを含むマルチパート・データです。

POST操作を使用してアセットをインポートするには、コンテンツ・タイプがmultipart/form-dataとして指定されている必要があります。マルチパート形式では、各パートはオブジェクトのデータの連続する部分です。各オブジェクトのパートは、個別に任意の順序でアップロードできます。いずれかのパートの送信が失敗した場合は、他のパートに影響を与えることなくそのパートを再送信できます。また、POST操作でfileNameキーにマップされるアセット・アーカイブのファイル名が必要です。

共有アセットをインポートする場合、次の形式のURLも使用できます。

http://host:port/rest/api/v1/portal/typeOfAsset?utoken=utokenvalue

共有アセットをインポートするには、wpfas/modules/rest-service/servlet/src/java/oracle/webcenter/jaxrs/services/portal/controller/AssetTypeResource.javaで、次の形式のPOST操作を追加します。

POST
@Consumes({MediaType.MULTIPART_FORM_DATA, MediaType.APPLICATION_OCTET_STREAM})
@ResourceType("urn:oracle:webcenter:portal:<assetType>")
public Response importPortal(MultiPart multiPartData)

34.4 カスタム共有ライブラリの拡張機能のデプロイ

開発者は、JDeveloperを使用して、ポータルのカスタムADFライブラリ・コンポーネント(管理対象Bean、タスク・フローおよびデータ・コントロールなど)を構築したり、これらのコンポーネントを共有ライブラリの拡張機能としてポータル・サーバーにデプロイしたりすることができます。

『Oracle JDeveloperによるWebCenter Portalアセットとカスタム・コンポーネントの開発』の共有ライブラリの開発に関する項も参照してください。

共有ライブラリがポータルによって使用される場合、ポータルのデプロイまたは伝播中にそれらを他のインスタンスにプッシュするよう選択できます。

34.5 ステージングから本番への接続の詳細の移動

管理者は、WLSTコマンドexportWebCenterPortalConnectionsおよびimportWebCenterPortalConnectionsを使用して、あるWebCenter Portalインストールの接続の詳細を別のWebCenter Portalインストールに移行できます。これらのコマンドは、ポータルをインポートまたはリストアする際に、ソース・サーバーで使用される接続(ポートレット・プロデューサ接続やWebサービス接続など)がターゲット・サーバーに存在しない場合に役立ちます。

移行できる接続タイプの詳細は、「接続プロパティ・ファイルの理解」を参照してください。

この項には次のトピックが含まれます:

- ファイルへのWebCenter Portal接続の詳細のエクスポート

- ファイルからの新しいWebCenter Portal接続のインポート

34.5.1 ファイルへのWebCenter Portal接続の詳細のエクスポート

WebLogic ServerのOperatorロール(あるいはそれ以上のロール)を持っている場合、WLSTコマンドexportWebCenterPortalConnectionsを使用して、特定のWebCenter Portalインストールに現在構成されている接続情報をファイルにエクスポートできます。

exportWebCenterPortalConnections(appName, fileName, [connectionType,
connectionName, logFile, server, applicationVersion])

注意:

特定のポータルの接続はエクスポートできません。接続は、すべてのポータル間で共有されます。

設定するオプションは、エクスポートする接続情報によって異なります。コマンドの構文の詳細は、WebCenter WLSTコマンド・リファレンスのexportWebCenterPortalConnectionsに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「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')

34.5.2 ファイルからの新しいWebCenter Portal接続のインポート

WebLogic ServerのOperatorロール(あるいはそれ以上のロール)を持っている場合、WLSTコマンドimportWebCenterPortalConnectionsを使用して、あるWebCenter Portalインストールからエクスポートされた接続情報を別のWebCenter Portalインストールにデプロイできます。

importWebCenterPortalConnections(appName, fileName, [promptForPassword, logFile,
server, applicationVersion])

ターゲットには、新しい接続のみがインポートされます。ターゲットにすでに存在する接続は無視されます。ソース接続情報は、WLSTコマンドexportWebCenterPortalConnectionsを使用してエクスポートする必要があります。この方法を確認するには、「ファイルへのWebCenter Portal接続の詳細のエクスポート」を参照してください。

必要な場合、ターゲットに接続情報をデプロイする前に、接続情報を含むファイルを編集できます。「接続プロパティ・ファイルの理解」も参照してください。

例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)

コマンドの構文の詳細は、『WebCenter WLSTコマンド・リファレンス』のimportWebCenterPortalConnectionsに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

34.6 ポータルのディスカッションとページレット・プロデューサのリソースの移行

1つ以上のポータルを別のサーバーに移動または移行した後、各種バックエンド・コンポーネントで格納されているポータル・データを(オプションで)移行できます。ディスカッションとページレット・プロデューサのリソースがポータルで使用される場合、これにこれらの移行が含まれます。

ディスカッション:

- アーカイブへのポータル・ディスカッションのエクスポート

- アーカイブからのポータル・ディスカッションのインポート

ページレット:

- ページレット・プロデューサのリソースのエクスポートおよびインポート

- WLSTを使用したページレット・プロデューサ・メタデータのエクスポートおよびインポート

1つ以上のポータルをインポートした後で、Oracle Secure Enterprise Searchクロールを開始して、新たにインポートされたデータを索引付けすることを検討してください。

34.6.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からログインします。

a. WebCenter Portal管理を開きます。
詳細は、「WebCenter Portal管理の設定ページの理解」を参照してください。

b. 「ポータル」をクリックします。

c. ディスカッションをエクスポートするポータルを選択して、「管理」を選択します。

d. 「ツールとサービス」、「ディスカッション」の順にクリックします。

e. このポータルに関連付けられている「フォーラム名」/「フォーラムID」または「カテゴリ名」/「カテゴリID」を書き留めます。
WebCenter Portalのディスカッション・サーバーは、ディスカッション・カテゴリおよびフォーラムIDを順番に生成します。ターゲット・システムにこのIDが存在する場合、インポートされたフォーラム(またはカテゴリ)には新しい一意のIDが割り当てられるため、インポートされたポータルが新しいIDをポイントするように再構成する必要があります。詳細は、後述の手順11を参照してください。

f. 「フォーラムの管理」をクリックして、ディスカッション・サーバーの管理コンソールにログインします。

2. 管理コンソールで、「システム」メニューを選択し、サイドバーで、「XMLインポートおよびエクスポート」を選択します。

3. 「データのエクスポート」を選択します。

4. 次のオプションを設定します(図34-15)。

a. エクスポート・オプション: 「カスタム・オプション」を選択し、すべてのチェック・ボックスを選択します。

b. コンテンツのエクスポート: 「特定のコンテンツのエクスポート」を選択して、必要なフォーラムまたはカテゴリの名前を選択します。
注意: 複数のフォーラムをサポートするポータルは、カテゴリを使用してディスカッションを格納します。他のポータルは単一フォーラムを使用します。

c. エクスポート場所、エクスポート・ファイル名、エクスポート・ファイルのエンコーディング: デフォルト値を保持します。

図34-15 個々のポータルのディスカッションのエクスポート

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

ターゲット・システムにディスカッションをインポートする前に、移行するポータルがターゲット上に存在している必要があります。「WebCenter Portal管理を使用したポータルのアーカイブからのインポート」を参照してください。

34.6.2 アーカイブからのポータル・ディスカッションのインポート

ディスカッション・サーバーの管理コンソールを使用して、別のWebCenter Portal環境からエクスポートされたディスカッションをインポートします。

ディスカッション・データをインポートする前に、関連するポータルがターゲット上に存在することを確認します。「ポータル・アーカイブのインポートとエクスポート」または「WLSTを使用したポータルの直接デプロイ」を参照してください。

注意:

WebCenter Portalのディスカッション・サーバーは、ディスカッション・カテゴリおよびフォーラムIDを順番に生成します。このため、2つのターゲット間(または、ソースとターゲット間)でディスカッション・データをインポートする場合、両方のシステムに同じIDが存在する可能性があります。IDのクラッシュが発生した場合、インポートされたフォーラム(またはカテゴリ)には新しい一意のIDが割り当てられるため、ポータルが新しいIDをポイントするように再構成する必要があります。詳細は、後述の手順11を参照してください。

特定のポータルのディスカッションをインポートするには:

1. ターゲットのディスカッション・サーバーの管理コンソールにログインします。
コンソールのURLがわかっている場合は、直接ログインできます。例: http://example.com:8890/owc_discussions/admin

または、次のようにWebCenter Portalからログインします。

a. WebCenter Portal管理を開きます。
詳細は、「WebCenter Portal管理の設定ページの理解」を参照してください。

b. 「ポータル」をクリックします。

c. データをインポートするポータルを選択して、「管理」を選択します。

d. 「ツールとサービス」、「ディスカッション」の順にクリックします。

e. 「フォーラムの管理」(右端)をクリックし、管理コンソールにログインします。

2. 管理コンソールで、「システム」メニューを選択し、サイドバーで、「XMLインポートおよびエクスポート」を選択します。

3. 「データのインポート」を選択します。

4. 利用可能なリストから適切なインポート・ファイルを選択します(図34-16)。
必要なファイルがリスト表示されていない場合は、ソース・ディレクトリ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/

図34-16 ポータルのディスカッションのインポート

5. 「インポートの開始」をクリックします。
インポート時に、ディスカッション・データはディスカッション・サーバーにコピーされます。次の手順で、以前に移行したポータルを、この新たにインポートされたデータと再度関連付けます。

6. 「コンテンツ」メニューを選択し、サイドバーで「コンテンツ・サマリー」を選択します。
システムのすべてのカテゴリおよびフォーラムがここにリスト表示されます。

7. 「WebCenter」を選択し、新たにインポートされたフォーラムまたはカテゴリの「移動」ボタンをクリックします。

8. ターゲットWebCenter Portalのルート・カテゴリを選択し、カテゴリの移動をクリックします。
「カテゴリのサマリー」ページに新しい場所が表示されます。

9. サイドバーの「権限」をクリックします。

10. ユーザー・タイプ: 「すべてのユーザー」および「登録済のユーザー」のすべての権限を解除し、「変更の保存」をクリックします(図34-17)。

図34-17 フォーラム権限の編集

11. WebCenter Portalで、ポータルのディスカッション・フォーラム設定に移動して、ポータルと、インポートしたばかりのディスカッション・データを再度関連付けます。

a. WebCenter Portal管理を開きます。
詳細は、「WebCenter Portal管理の設定ページの理解」を参照してください。

b. 「ポータル」をクリックします。

c. データをインポートするポータルを選択して、「管理」を選択します。

d. 「ツールとサービス」、「ディスカッション」の順にクリックします。

e. 「カテゴリID」または「フォーラムID」の横の「検索」アイコンをクリックし、リストからインポート済カテゴリ(またはフォーラム)を選択して、「選択」をクリックします。

f. 「保存」をクリックします。

34.7 本番でのポータルの伝播および再デプロイ

この項には次のトピックが含まれます:

- ポータル伝播の理解

- WebCenter Portalを使用したポータル変更の伝播

- WLSTを使用したポータルの直接デプロイ

- WLSTを使用したポータル変更の伝播

- WebCenter Portalを使用したポータルの再デプロイ

34.7.1 ポータル伝播の理解

管理者は、ステージング環境と本番環境が接続されて「同期」状態の場合、ステージングのポータルの変更を本番に伝播できます。たとえば、新しいページや追加または変更されたアセットなどのポータルの変更を伝播できます。常に最初にステージングの変更を行い、その後デプロイメントまたは伝播を使用してポータルの変更を本番にプッシュすることを強くお薦めします。伝播によって、本番サーバーの再起動が必要になることも、停止時間が発生することもありません。

ステージングから本番に伝播される変更のリストは、表34-5を参照してください

表34-5 本番に伝播されるポータルの変更

伝播されるポータルの変更

はい/いいえ

ポータル・ページ

はい

アセット

はい

ポートレット

はい

ポータル・フォルダ・コンテンツの変更

はい

ポータルのアクティビティおよび使用状況データ

(アクティビティ・ストリーム、カレンダ・イベント、フィードバック、リスト、リンク、メッセージ・ボード、ピープル・コネクション、プロファイル、アンケート)

いいえ

カスタム・ページ・セキュリティを除くポータル・セキュリティ・データ

(ポータル・ロールおよび権限、メンバーの詳細とそのロールの割当て)

いいえ

ポータルで参照される外部コンテンツ

(ポータル・ページ、ポータル・アセット、コンテンツ・プレゼンタ表示テンプレート、Site Studioなどで参照)

いいえ

外部サーバーに格納されるデータ

(ディスカッション、メール、お知らせ、分析、カスタム・タスク・フローおよび共有ライブラリ)

いいえ

ポータルの構造上の変更の場合は再デプロイメントが必要です。

- ポータル・ページに対して、カスタム・セキュリティを設定できます。ポータルの伝播中に、カスタム・ページ・セキュリティの変更が伝播されます。ただし、既存のロール(ソース・サーバーとターゲット・サーバーの両方に存在するロール)に対するポータルレベルのセキュリティの変更のみが伝播されます。新しいロールを作成し、新しいページ権限を追加するか、メンバーを追加または削除した場合は、新しいロールがターゲット・サーバーに存在しないと、変更が伝播されません。そのような変更を移行するには、ポータルを再デプロイする必要があります。

- ポータルをデプロイした後に、ドキュメントなどの新しいツールを有効化したり、ソース・サーバーでそれを無効化した後でポータルの変更を伝播した場合は、ツール関連の変更がターゲット・サーバーに反映されません。変更を有効にするには、ポータルを再デプロイする必要があります。

34.7.2 WebCenter Portalを使用したポータル変更の伝播

ポータルに加えた変更をターゲット・サーバーに伝播する手順は次のとおりです。

1. WebCenter Portalで、『Oracle WebCenter Portalでのポータルの構築』のポータル管理へのアクセスに関する項の説明に従って、ポータル管理にアクセスします。

2. 「デプロイ」アイコンをクリックします。

注意:
「デプロイ」アイコンは、アプリケーション・レベルの権限Portal Server: Deployを付与されている場合にのみ表示されます。

3. 「ターゲット・ポータル・サーバー」の下の「サーバー名」リストから、ポータルの変更の伝播に使用される接続を選択します。これは、ポータルのデプロイに使用された接続と同じものである必要があります。

4. 「コメント」ボックスに、ポータルの伝播に関連するコメントを指定します。

5. 「オプション」セクションで、伝播オプションを選択します。

- ポータル・コンテンツを含める: Content Serverに格納されるポータル・コンテンツがターゲット・サーバーに伝播される必要があることを指定する場合に選択します。

- 共有アセットを含める: ポータルによって使用される共有アセットを伝播します。共有アセットを伝播しない場合はチェック・ボックスの選択を解除します。

- 共有ライブラリを含める: ポータルによって使用される共有ライブラリを伝播します。共有ライブラリを伝播しない場合はチェック・ボックスの選択を解除します。共有ライブラリを伝播するよう選択する場合、共有ライブラリの変更が取得されるように、ポータルの変更を伝播した後でターゲット・サーバーを再起動する必要があります。

6. 「詳細の変更」セクションを展開して、伝播されるアーティファクトまたは設定を表示します。

- ポータル・アセット: 前回の伝播の後に追加または更新されたポータル・アセットをリストします。たとえば、図34-18の「ページ」のカテゴリには、前回の伝播の後に追加された3つのページが示されます。

- 共有アセット: 前回の伝播の後に追加または更新されたポータルによって使用される共有アセットをリストします。

- 共有ライブラリ: 前回の伝播の後に追加または更新されたポータルによって使用される共有ライブラリをリストします。

図34-18 ポータル変更の伝播

7. 「伝播」をクリックします。

「ポータルのデプロイ」ダイアログには、ポータルの伝播の進捗およびステータスが表示されます。ポータルが伝播されている間、必要に応じてポータルで作業することを選択できます。

8. 「閉じる」をクリックします。

9. 共有ライブラリを伝播した場合、共有ライブラリの変更を有効にするために、ターゲット・サーバーを再起動します。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

34.7.3 WLSTを使用したポータル変更の伝播

ポータルの直接伝播は、ソース環境とターゲット環境との間に接続が存在し、ポータルが以前にWLSTコマンドdeployWebCenterPortalsを使用してターゲットに直接デプロイされた場合のみ可能です。「WLSTを使用したポータルの直接デプロイ」を参照してください。

ステージングから本番にメタデータ変更を伝播するには:

1. WLSTコマンドpropagateWebCenterPortalを実行して、ポータルのメタデータを伝播します。

propagateWebCenterPortal(appName, portalName, targetConnectionName,
[savePortal, propagateLog, propagateSharedAssets, propagatePortalContent, server, applicationVersion])

設定するオプションは、特定の要件によって異なります。コマンドの構文の詳細は、WebCenter WLSTコマンド・リファレンスのpropagateWebCenterPortalに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「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をバックアップして、ポータル・コンテンツおよびポータルで使用される共有アセットに対するすべての変更を含む、ポータルの変更を伝播し、さらに伝播ログ・ファイルの名前と場所を指定します。

propagateWebCenterPortal(appName='webcenter', portalName='myPortal',
targetConnectionName='MyProductionConnection', savePortal=1
propagateLog='/mypropagationlogs/myPortal_propagation.log', propagateSharedAssets=1, propagatePortalContent=1,)

34.7.4 WebCenter Portalを使用したポータルの再デプロイ

WebCenter Portalでポータルを再デプロイする場合、既存のポータルに関するすべての情報がターゲット・サーバーから削除され、新しいポータルが作成されます。

WebCenter Portalを使用してポータルを再デプロイする手順は次のとおりです。

1. WebCenter Portalで、『Oracle WebCenter Portalでのポータルの構築』のポータル管理へのアクセスに関する項の説明に従って、ポータル管理にアクセスします。

2. 「デプロイ」アイコンをクリックします。

注意:
「デプロイ」アイコンは、アプリケーション・レベルの権限Portal Server: Deployを付与されている場合にのみ表示されます。

3. 「コメント」ボックスに、ポータルの再デプロイメントに関連するコメントを指定します。

4. 「ターゲット・ポータル・サーバー」の「サーバー名」リストから、ポータルのデプロイに使用された接続を選択します。

5. 「オプション」セクションで、オプションを選択します。

- 変更を伝播するかわりに再デプロイ: ポータルを再デプロイする必要があることを指定する場合に選択します。

- ポータル・コンテンツを含める: Content Serverに格納されるポータル・コンテンツが、ポータルの再デプロイメントに含まれる必要があることを指定する場合に選択します。

- 共有アセットを含める: ポータルによって使用される共有アセットをデプロイします。共有アセットをデプロイしない場合はチェック・ボックスの選択を解除します。

- 共有ライブラリを含める: ポータルによって使用される共有ライブラリをデプロイします。共有ライブラリをデプロイしない場合はチェック・ボックスの選択を解除します。共有ライブラリをポータル・デプロイメントに含める場合は、共有ライブラリの変更が取得されるように、ポータルの再デプロイ後にターゲット・サーバーを再起動する必要があります。

図34-19 ポータルの再デプロイ

6. 「デプロイ」をクリックします。

「ポータルのデプロイ」ダイアログには、ポータルのデプロイメントの進捗およびステータスが表示されます。ポータルが再デプロイされている間、必要に応じてポータルで作業することを選択できます。

7. 「閉じる」をクリックします。

8. 共有ライブラリを再デプロイすることを選択した場合、共有ライブラリの変更を有効にするために、ターゲット・サーバーを再起動します。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

1
セキュリティ関連の構成: 接続にはポリシー情報のみが含まれます。セキュリティ・ポリシーに設定されたオーバーライドは含まれないため、デプロイメント後にこれらのパラメータを構成する必要があります。

35 WebCenter Portalのバックアップ、リカバリおよびクローニングの管理

この章では、WebCenter Portalインストールをバックアップおよびリストアするための手法とツールについて説明します。

この章の内容は次のとおりです。

- WebCenter Portalのバックアップおよびリカバリの理解

- WebCenter Portalのバックアップ、リカバリおよび移行のツールの比較

- 個々のポータルのバックアップ

- バックアップからのポータルのリストア

- 別のターゲットへのWebCenter Portal全体の移行

- WebCenter Portalインストール全体のバックアップ

- WebCenter Portalインストール全体のリストア

- スクリプトを使用したWebCenter Portalのバックアップおよびリストア

- WebCenter Portal環境のクローニング

権限

この章の内容は、システム管理者を対象としています。

ポータル、テンプレート、アセット、接続および拡張機能のデプロイに必要なロールと権限の詳細は、「WebCenter Portalのライフ・サイクル操作の実行に必要な権限」を参照してください。

「管理操作、ロールおよびツールの理解」も参照してください。

35.1 WebCenter Portalのバックアップおよびリカバリの理解

データベース・ハードウェアを消失した場合や、ファイルまたはデータベースから誤ってデータを削除した場合などの障害からデータをリカバリするには、個々のポータルとWebCenter Portalインスタンス全体を頻繁にバックアップすることが重要です。バックアップの頻度は、WebCenter Portalにより格納されている基礎となる情報が特定の環境でどのくらいの頻度で変更されるか、およびどのくらいの時間と情報量を消失しても許容されるかによって決まります。データが業務にとって非常に重要であり、障害発生時にはデータのリストアが必須である場合は、増分バックアップまたは部分バックアップを適用できます。

WebCenter Portalには、様々なバックアップ・オプションが用意されています。管理者は、次の内容をバックアップできます。

- 1つ以上のポータル
WebCenter Portalには、個々のポータルをバックアップおよびリストアするための、エクスポートとインポート用のWLSTコマンドがあります。詳細は、「個々のポータルのバックアップ」および「バックアップからのポータルのリストア」を参照してください。

- WebCenter Portal環境全体
WebCenter Portalおよび各種バックエンド・コンポーネントのバックアップとリカバリは、データベースのエクスポートとインポートのユーティリティ、および様々な他のツールから管理できます。詳細は、「WebCenter Portalインストール全体のバックアップ」および「スクリプトを使用したWebCenter Portalのバックアップおよびリストア」を参照してください。

注意:

この章では、WebCenter Portalデータをバックアップおよびリストアするための手法のみについて説明しています。Oracle Fusion Middlewareのバックアップとリカバリの戦略の詳細は、『Oracle Fusion Middlewareの管理』の高度な管理: バックアップおよびリカバリに関する項を参照してください。

35.2 WebCenter Portalのバックアップ、リカバリおよび移行のツールの比較

表35-1では、WebCenter Portalのバックアップおよびリストア、またはWebCenter Portalの別のターゲットへの移行で使用できる様々なツールを比較しています。

表35-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インスタンスのリストアにはお薦めしません。

バックアップと移行の対象

Content Server上のポータルのコンテンツ・フォルダに格納されているコンテンツ、ポータル・ページとアセット、および永続ストアに格納されたポータル・データ

ポータルのセキュリティ権限およびロール。

詳細は、次を参照してください。

ポータル・アーカイブの理解

ポータル・テンプレートのデプロイ

すべてのツールおよびサービス(ディスカッション、お知らせ、イベント、ポートレット、アクティビティ、タグ、ワークリストなど)のMDSメタデータ。

すべてのポータルおよびグローバル・アーティファクトのセキュリティ・ロールと権限、およびユーザーロール割当て。ユーザーと監査データも移行されます。

WEBCENTERおよびMDSデータベース・スキーマに格納されるデータ。

オプションで、DISCUSSIONS、DISCUSSIONS_CRAWLER、ACTIVITIES、PORTLET、OCSなどの他のスキーマに格納されるデータ。

MDSおよびWEBCENTERスキーマ・ページに格納されているデータ、アプリケーション統合アセット、軽量コンテンツ・アイテム、およびツールとサービス(ディスカッション、お知らせ、イベント、ポートレット、アクティビティ、タグなど)。

すべてのポータルおよびグローバル・アーティファクトのセキュリティ・ロールと権限、およびユーザー・ロールの割当て

アクティビティ・ストリーム、ポータル・イベント、フィードバック、リスト、リンク、メッセージ・ボード、ピープル・コネクション、プロファイル、アンケートおよびタグに関する、WEBCENTERデータベース・スキーマに格納されるデータ。

バックアップと移行の対象外

Content Server上のポータルのコンテンツ・フォルダの外部にあるすべてのコンテンツ、およびポータルによって使用されるすべての共有ライブラリ

WebCenter Portalドメイン。

コンテンツ・サーバー、ディスカッション・サーバー、BPELサーバー、メール・サーバーなどの他のバックエンド・システムに格納されるデータ。

adf-config.xmlに格納されるアプリケーションレベルの設定(ドメイン/MDS)

資格証明(メタデータ/セキュリティ/データ/資格証明)。

WebCenter Portalドメイン。

長所

特定のポータルやポータル・テンプレートのみがバックアップおよびリストアされるため、比較的高速に行われます。

バックアップおよびリストアする内容をさらに詳細に制御できます。

破損したポータルの数がわずかな場合に最も効果的です。

WebCenter Portalで所有するデータを定期的にバックアップするには、簡単で拡張性があり、信頼できる方法です。

すべての内容を含む大規模な単一アーカイブではなく、複数の細かいバックアップ・アーカイブが生成されます。

MDSデータ、WEBCENTERデータベース・データ、カスタマイズおよびセキュリティが1回の手順で取得されます。

使用しやすく、個別に4つのコマンドを使用するよりも、すばやく行われます。

短所

Content Server上のポータルのコンテンツ・フォルダの外部にあるコンテンツ、ポータルで使用される共有ライブラリ、およびホーム・ポータルをバックアップできません。

データベース・スキーマWEBCENTERおよびMDSを一緒にリストアする必要があります。一緒にリストアしない場合、データが同期しなくなる可能性があります。

OCSなどのスキーマを追加でリストアする場合、データの整合性を維持するには、これらを同時に同じポイントでリストアしておく必要があります。

増分バックアップまたはリストアはサポートされません。

ドメイン構成はバックアップ・スクリプトに含まれないため、ドメインを個別にバックアップする必要があります。『Oracle Fusion Middlewareの管理』の高度な管理: バックアップおよびリカバリに関する項を参照してください。

様々なバックエンド・サーバーが構成されている別のインスタンスでリストアする場合はお薦めしません。

多くの内部処理が必要です。

ネイティブ・ツールは、データベースからのデータの抽出に使用されません。

注意:

Fusion Middlewareのテストから本番のスクリプトを使用して、WebCenter Portal、WebCenter Content、SOA Suite、BIなどとともにインストールおよび構成されるFusion Middlewareインスタンス全体を、1つ以上のターゲット環境にレプリケートします。これらのスクリプトにより、複数のターゲットで複雑なインストール・プロセスが繰り返されることはありません。詳細は、『Oracle Fusion Middlewareの管理』のテスト環境から本番環境への移行に関する項を参照してください。

ソースWebCenter Portalインストールを使用している場合、つまり、顧客がメタデータ、データ、セキュリティを作成した場合は、テストから本番のスクリプトはお薦めしません。

35.3 個々のポータルのバックアップ

ポータルのバックアップ・プロセスは単純です。WLSTコマンドexportWebCenterPortalsを使用して、ポータルとそのコンテンツ・フォルダをアーカイブし、必要に応じて、ディスカッション・サーバーなどのバックエンド・コンポーネントのポータルに格納されているデータを追加でバックアップします。

手順は次のとおりです。

1. ポータルをエクスポート・アーカイブ(PARファイル)にバックアップします。

「WLSTを使用したポータルのバックアップ」を参照してください。

2. 必要に応じて、ポータルのディスカッションおよび外部データをバックアップします。

「ポータルのディスカッションおよび外部データのバックアップ」を参照してください。

この項の情報では、ポータルのバックアップを手動で実行する方法について説明します。頻繁にバックアップする必要がある場合や、定期的なバックアップ・スケジュールを設定する場合は、バックアップ・プロセスを自動化するスクリプトを作成できます。詳細は、「スクリプトを使用したWebCenter Portalのバックアップおよびリストア」を参照してください。

「バックアップからのポータルのリストア」も参照してください。

注意:

多数のポータルの同時バックアップは、サーバー構成によってはシステム・パフォーマンスに影響を及ぼす可能性があるためお薦めしません。パフォーマンスの重大な低下が生じる場合は、バックアップまたはエクスポート・プロセスをより小さないくつかのグループに分けてください。

35.3.1 WLSTを使用したポータルのバックアップ

WLSTコマンドexportWebCenterPortalsを使用して、1つ以上のポータルをアーカイブ(PARファイル)にバックアップします。

ポータル・アーカイブ(PARファイル)内にバックアップされる情報と、アーカイブに含まれない情報を確認するには、「ポータル・アーカイブの理解」を参照してください。

注意:

ポータル・アーカイブには、共有アセットやホーム・ポータルに関連する情報は含まれません。

データ損失を防ぐには、次のようにすることをお薦めします。

- バックアップ・プロセスでポータルをオフラインにしてデータの競合を防止する(offlineDuringExport=1)

- アーカイブにポータル・コンテンツ・フォルダを含める(exportPortalContent=1)

- アーカイブに接続情報を含める(exportConnections=1)

注意:

接続情報はポータルに固有ではありません。ソースWebCenter Portalインストール用に構成されたすべての接続がエクスポートされます。「接続プロパティ・ファイルの理解」も参照してください。

- ポータルにWebサービスのデータ・コントロールやポートレットが含まれる場合、エクスポートが正常に行われるには、関連するすべてのWebサービスまたはプロデューサが稼働中でアクセス可能であることを確認します。

たとえば、WLSTコマンドを次のように実行します。

exportWebCenterPortals(appName='webcenter', fileName='BackupSalesPortals_31March2013.par', names='GlobalSales,MySales', offlineDuringExport=1, exportPortalContent=1, exportConnections=1)

設定するオプションは、特定のアーカイブ要件によって異なります。コマンドの構文の詳細は、WebCenter WLSTコマンド・リファレンスのexportWebCenterPortalsに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

ポータルを後でリストアするには、「バックアップからのポータルのリストア」を参照してください。

35.3.2 ポータルのディスカッションおよび外部データのバックアップ

ディスカッション・サーバー管理コンソールを使用して、後でリストアする特定のポータルのディスカッション・データを.zipファイルに必要に応じてバックアップします。詳細は、「アーカイブへのポータル・ディスカッションのエクスポート」および「アーカイブからのポータル・ディスカッションのインポート」を参照してください。

バックアップ・ファイルには、ポータルがコンテンツ・プレゼンタおよびSite Studioを使用して参照する外部格納データ(外部のWebコンテンツやページなど)は含まれないため、外部データを個別にバックアップする必要があります。同様に、ポータルがその独自のコンテンツ・フォルダの外部にあるドキュメントやファイルを参照する場合、ポータルで使用するすべての記憶域がバックアップされることを確認する必要があります。どちらの場合も、外部データとコンテンツのバックアップ方法の手順については、該当する製品のドキュメントを参照してください。

35.4 バックアップからのポータルのリストア

WLSTコマンドimportWebCenterPortalsを使用して、1つ以上のポータルをバックアップ・アーカイブからリストアできます。既存のポータルは削除されて置き換えられます。

手順は次のとおりです。

1. ポータルのバックアップ・アーカイブ(PARファイル)をターゲットにインポートして、ポータルをリストアします。

「WLSTを使用したポータルのアーカイブからのリストア」を参照してください。

2. 必要に応じて、ポータルのディスカッション・データおよび外部データをリストアします。

「ポータルのディスカッションおよび外部データのリストア」を参照してください。

この項の情報では、ポータルのバックアップを手動でリストアする方法について説明します。必要な場合は、リストア・プロセスを自動化するスクリプトを作成できます。詳細は、「スクリプトを使用したWebCenter Portalのバックアップおよびリストア」を参照してください。

35.4.1 WLSTを使用したポータルのアーカイブからのリストア

WLSTコマンドimportWebCenterPortalsを使用して、1つ以上のポータルをアーカイブ(PARファイル)からリストアします。

データ損失を防ぐには、次のようにすることをお薦めします。

- ポータルをリストアする前に、なんらかの理由でターゲットから失われる、ポータルで使用する接続をインポートします。
「ファイルからの新しい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')

設定するオプションは、特定の要件によって異なります。コマンドの構文の詳細は、WebCenter WLSTコマンド・リファレンスのimportWebCenterPortalsに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

一部のバックエンド・コンポーネント、特にディスカッション・サーバーに関連付けられたポータル関連のデータは、ポータルをエクスポートまたはインポートした後で移行する必要があります。詳細は、「ポータルのディスカッションおよび外部データのリストア」を参照してください。

35.4.2 ポータルのディスカッションおよび外部データのリストア

ディスカッション・サーバー管理コンソールを使用して、特定のポータルのディスカッション・データをバックアップの.zipファイルからリストアします。詳細は、「アーカイブからのポータル・ディスカッションのインポート」および「アーカイブへのポータル・ディスカッションのエクスポート」を参照してください。

ポータルで使用する外部データまたはコンテンツをバックアップした場合、必要に応じてバックアップから情報をリストアする方法の手順については、該当の製品ドキュメントを参照してください。たとえば、コンテンツ・プレゼンタおよびSite Studioを使用してポータルが参照する一部の外部格納データ(外部のWebコンテンツやページなど)、またはポータル独自のコンテンツ・フォルダの外部に格納されているドキュメントを定期的にバックアップする場合などです。

35.5 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. セキュリティ・ストアをバックアップします。

「LDAPアイデンティティ・ストアのバックアップおよびリストア」、「ポリシー・ストアのバックアップおよびリストア(LDAPとデータベース)」および「資格証明ストアのバックアップおよびリストア(LDAPとデータベース)」を参照してください。

10. WebCenter PortalをホストするWebLogicドメインをバックアップします。

「WebCenter Portalドメインのバックアップおよびリストア」を参照してください。

11. 監査構成をバックアップします。

「監査リポジトリ構成のバックアップおよびリストア」を参照してください。

この項の情報では、手動でバックアップする方法について説明します。頻繁にバックアップする必要がある場合や、定期的なバックアップ・スケジュールを設定する場合は、バックアップ・プロセスを自動化するスクリプトを作成できます。詳細は、「スクリプトを使用したWebCenter Portalのバックアップおよびリストア」を参照してください。

35.5.1 WebCenter Portalのすべてのスキーマ・データのバックアップおよびリストア

WebCenter Portalのデータベース・スキーマ(WEBCENTER)では、アクティビティ・ストリーム、ポータル・イベント、フィードバック、リスト、リンク、メッセージ・ボード、ピープル・コネクション、プロファイル、アンケートおよびタグなど、各種ツールおよびサービスのデータを格納します。

この項には次のトピックが含まれます:

- 前提条件

- WebCenter Portalスキーマ・データのバックアップ(エクスポート)

- WebCenter Portalデータのリストア(インポート)

35.5.1.1 前提条件

Oracleデータベース・スキーマをバックアップまたはリストアする場合、スキーマ・データをバックアップまたはリストアする前に、setenvやexportを使用して、次の環境変数を設定します。

- ORACLE_HOME: データベース・ホーム

- ORACLE_SID: スキーマのサービスID

- TNS_ADMIN: ORACLE_HOME/network/adminに設定

35.5.1.2 WebCenter Portalスキーマ・データのバックアップ(エクスポート)

スキーマ・データWEBCENTERをバックアップするには、データベースに適したユーティリティを使用します。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

- Oracleデータベースの場合、データベースのDB_ORACLE_HOME/binに移動して、次の例で説明されるコマンドを実行します。expdpコマンドの詳細は、ガイドを参照してください。

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は、ログ・ファイルの作成を抑制します。

「WebCenter Portalデータのリストア(インポート)」も参照してください。

35.5.1.3 WebCenter Portalデータのリストア(インポート)

バックアップからスキーマ・データWEBCENTERをリストアするには、データベースに適したユーティリティを使用します。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. インポート・ツールを実行します。

たとえば、ソースとターゲットのスキーマ名が一致するWebCenter Portalスキーマ・データをインポートするには、次のコマンドを実行します。

DB_ORACLE_HOME/bin/impdp \"sys/password@serviceid as sysdba\"
directory=mydmpdirectory dumpfile=webcenterportal.dmp SCHEMAS=tgtprefix_WEBCENTER

たとえば、ソースとターゲットのスキーマ名が異なる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は、現在の表を削除して、ダンプ・ファイルに含まれているとおりに表を作成します。

impdpコマンドの詳細は、ガイドを参照してください。

35.5.2 すべてのMDSスキーマ・データのバックアップおよびリストア

MDSスキーマには、WebCenter Portalのカスタマイズのメタデータとデータが含まれます。

この項には次のトピックが含まれます:

- 前提条件

- すべてのMDSスキーマ・データのバックアップ(エクスポート)

- MDSスキーマ・データのリストア(インポート)

35.5.2.1 前提条件

Oracleデータベース・スキーマをバックアップまたはリストアする場合、スキーマ・データをバックアップまたはリストアする前に、setenvやexportを使用して、次の環境変数を設定します。

- ORACLE_HOME: データベース・ホーム

- ORACLE_SID: スキーマのサービスID

- TNS_ADMIN: ORACLE_HOME/network/adminに設定

注意:

これらのバックアップ(エクスポート)およびリストア(インポート)手順が機能するには、ソースとターゲットのスキーマ名が一致している必要があります。たとえば、両方のスキーマの名前をDEV_MDSとします。

35.5.2.2 すべてのMDSスキーマ・データのバックアップ(エクスポート)

MDSデータをバックアップするには、データベースに適したユーティリティを使用します。Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

Oracleデータベースの場合、データベースのDB_ORACLE_HOME/binに移動して、次のコマンドを実行します。

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は、ログ・ファイルの作成を抑制します。

expdpコマンドの詳細は、ガイドを参照してください。

「MDSスキーマ・データのリストア(インポート)」も参照してください。

35.5.2.3 MDSスキーマ・データのリストア(インポート)

バックアップからMDSスキーマ・データをリストアするには、データベースに適したユーティリティを使用します。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. インポート・ツールを実行します。たとえば、次のようなコマンドを実行します。

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とします。

impdpコマンドの詳細は、ガイドを参照してください。

35.5.3 すべてのWebCenter Contentデータのバックアップおよびリストア

Oracle WebCenter Contentを完全にバックアップするには、WebCenter Contentのデータベース・スキーマ(OCS)のデータをバックアップして、WebCenter Contentのすべてのネイティブ(vault)ファイルおよびWeb表示可能(weblayout)ファイルをバックアップし、さらに他の構成データもバックアップする必要があります。詳細は、『Oracle Fusion Middlewareの管理』の高度な管理: バックアップおよびリカバリに関する項を参照してください。

オプションで、WebCenter Portalインスタンスのルート・フォルダを個別のアーカイブにバックアップできます。ルート・フォルダのバックアップは、フォルダが破損した場合や、フォルダ全体を別のターゲットに移行する場合に役立ちます。手順の詳細は、『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にログインして、ドキュメント関連のタスク・フローを使用するポータルを開きます。ドキュメント・サービスがそのポータルで有効になっていて、インポートされたフォルダが予期したとおりに使用可能であることを確認します。

35.5.4 ディスカッション・スキーマ・データのバックアップおよびリストア

ディスカッションおよびお知らせでは、次の2つのデータベース・スキーマに情報を格納します。

- DISCUSSIONS: ディスカッションおよびお知らせのデータを格納します。

- DISCUSSIONS_CRAWLER: ディスカッション・サーバーをクロールするOracle Secure Enterprise Search (SES)を有効にします。

この項には次のトピックが含まれます:

- 前提条件

- すべてのディスカッション・スキーマ・データのバックアップ(エクスポート)

- ディスカッション・スキーマ・データのリストア(インポート)

35.5.4.1 前提条件

Oracleデータベース・スキーマをバックアップまたはリストアする場合、スキーマ・データをバックアップまたはリストアする前に、setenvやexportを使用して、次の環境変数を設定します。

- ORACLE_HOME: データベース・ホーム

- ORACLE_SID: データベースのサービスID

- TNS_ADMIN: ORACLE_HOME/network/adminに設定

35.5.4.2 すべてのディスカッション・スキーマ・データのバックアップ(エクスポート)

すべてのディスカッション・スキーマ・データをバックアップするには、データベースに適したユーティリティを使用します。Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

Oracleデータベースの場合、データベースのDB_ORACLE_HOME/binに移動して、次のコマンドを実行します。

注意:

この項では、ディスカッション・サーバー・データ全体をエクスポートする方法について説明します。単一のポータルのディスカッションをエクスポートする場合は、「ポータルのディスカッションおよび外部データのバックアップ」を参照してください。

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は、ログ・ファイルの作成を抑制します。

expdpコマンドの詳細は、ガイドを参照してください。

「ディスカッション・スキーマ・データのリストア(インポート)」も参照してください。

35.5.4.3 ディスカッション・スキーマ・データのリストア(インポート)

バックアップからディスカッション・スキーマ・データをリストアするには、データベースに適したユーティリティを使用します。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. インポート・ツールを実行します。

たとえば、ソースとターゲットのスキーマ名が一致するディスカッション・スキーマ・データをインポートするには、次のコマンドを実行します。

DB_ORACLE_HOME/bin/impdp \"sys/password@serviceid as sysdba\"
directory=mydmpdirectory dumpfile=discussions.dmp
SCHEMAS=tgtprefix_DISCUSSIONS,tgtprefix_DISCUSSIONS_CRAWLER

たとえば、ソースとターゲットのスキーマ名が異なるディスカッション・スキーマ・データをインポートするには、次のコマンドを実行します。

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は、現在の表を削除して、ダンプ・ファイルに含まれているとおりに表を作成します。

35.5.5 他のスキーマ・データ(ACTIVITIESとPORTLET)のバックアップおよびリストア

前のトピックで説明したスキーマ(WEBCENTER、MDS、DISCUSSIONSおよびDISCUSSIONS_CRAWLER)以外に、WebCenter Portalでは、他のいくつかのスキーマにデータを格納できます。

- ACTIVITIESは、分析のデータを格納します

- PORTLETは、ポートレットおよびページレットのデータを格納します。

バックアップとリストアの手順はすべてのスキーマに共通です。データベースに適したユーティリティを使用してください。

- Oracle以外のデータベースの場合、製造元のドキュメントを参照してください。

- Oracleデータベースの場合、データベースのDB_ORACLE_HOME/binに移動して、この項で説明するコマンドを実行します。
expdpコマンドとimpdpコマンドの詳細は、ガイドを参照してください。

前提条件(Oracleデータベース)

Oracleデータベース・スキーマをバックアップまたはリストアする場合、スキーマ・データをバックアップまたはリストアする前に、setenvやexportを使用して、次の環境変数を設定します。

- ORACLE_HOME: データベース・ホーム

- ORACLE_SID: スキーマのサービスID

- TNS_ADMIN: ORACLE_HOME/network/adminに設定

スキーマ・データのエクスポート(Oracleデータベース)

次の例に、Oracleデータベースのスキーマ・データをエクスポートするexpdpコマンドのサンプルを示します。エクスポートするスキーマに合うように、schemadump.dmpおよびSCHEMA_NAMEを置き換えます。

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データベース)

この項では、スキーマ・データをインポートする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. インポート・ツールを実行します。

たとえば、ソースとターゲットのスキーマ名が一致するスキーマ・データをインポートするには、次のコマンドを実行します。

DB_ORACLE_HOME/bin/impdp \"sys/password@serviceid as sysdba\"
directory=mydmpdirectory dumpfile=schemadump.dmp SCHEMAS=tgtprefix_SCHEMA_NAME

たとえば、ソースとターゲットのスキーマ名が一致するスキーマ・データをインポートするには、次のコマンドを実行します。

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は、現在の表を削除して、ダンプ・ファイルに含まれているとおりに表を作成します。

35.5.6 LDAPアイデンティティ・ストアのバックアップおよびリストア

Oracle Internet Directoryなど、外部アイデンティティ・ストアでは、基礎となるデータベースにデータを格納します。Oracle Internet Directoryのデータベース・スキーマ・データをバックアップおよびリストアする方法の詳細は、『Oracle Fusion Middlewareの管理』の高度な管理: バックアップおよびリカバリに関する項を参照してください。

別のLDAPアイデンティティ・ストアを使用する場合は、該当製品に適したバックアップおよびリカバリのドキュメントを参照してください。

35.5.7 ポリシー・ストアのバックアップおよびリストア(LDAPとデータベース)

WLSTコマンドmigrateSecurityStoreを使用して、WebCenter Portalに構成されているポリシー・ストアをバックアップしてからリストアします。本番環境では、ポリシーをLDAPまたはデータベースに格納することをお薦めします。ファイルベースのポリシー・ストアはお薦めしません。

migrateSecurityStoreを使用して、次の操作を行います。

- LDAPまたはデータベースベースのポリシー・ストアをバックアップ・ファイルにバックアップする

- LDAPまたはデータベースのポリシー・ストアをバックアップ・ファイルからリストアする

詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』の手動によるポリシーの移行に関する項を参照してください。

WebCenter WLSTコマンド・リファレンスのmigrateSecurityStoreに関する項も参照してください。

注意:

WebCenter Portalのエクスポートとインポートのユーティリティ(exportWebCenterApplicationおよびimportWebCenterApplication)を使用してWebCenter Portalを別のインスタンスに移行する場合は、セキュリティ・ポリシー・データが含まれるため、このインスタンスのポリシー・ストアを手動で移行する必要はありません。詳細は、「別のターゲットへのWebCenter Portal全体の移行」を参照してください。

35.5.8 資格証明ストアのバックアップおよびリストア(LDAPとデータベース)

WLSTコマンドmigrateSecurityStoreを使用して、WebCenter Portalに構成されている資格証明ストアをバックアップしてからリストアします。本番環境では、資格証明をLDAPまたはデータベースに格納することをお薦めします。ファイルベースの資格証明ストアはお薦めしません。

migrateSecurityStoreを使用して、次の操作を行います。

- LDAPまたはデータベースベースの資格証明ストアをバックアップ・ファイルにバックアップする

- LDAPまたはデータベースの資格証明ストアをバックアップ・ファイルからリストアする

詳細は、『Oracle Platform Security Servicesによるアプリケーションの保護』のmigrateSecurityStoreによるすべての資格証明の移行に関する項を参照してください。

WebCenter WLSTコマンド・リファレンスのmigrateSecurityStoreに関する項も参照してください。

35.5.9 WebCenter Portalドメインのバックアップおよびリストア

ドメイン構成をバックアップおよびリストアする方法の詳細は、『Oracle Fusion Middlewareの管理』の高度な管理: バックアップおよびリカバリに関する項を参照してください。

35.5.10 ポートレット・プロデューサのメタデータのバックアップおよびリストア

ポートレット・プロデューサでは、登録ハンドルとポートレット・プリファレンス・データを、コンシューマ・アプリケーション(WebCenter Portal)とともにメタデータとして格納します。この項では、アプリケーションで格納されるポートレット・メタデータをWLSTコマンドexportPortletClientMetadataを使用してバックアップする方法と、ポートレット・メタデータをimportPortletClientMetadataを使用してリストアする方法について説明します。

注意:

WebCenter Portalのエクスポートとインポートのユーティリティ(exportWebCenterApplicationおよびimportWebCenterApplication)を使用してWebCenter Portalを別のインスタンスに移行する場合はポートレット・メタデータが含まれるため、このインスタンスのポートレット・プロデューサのメタデータを手動で移行する必要はありません。詳細は、「別のターゲットへのWebCenter Portal全体の移行」を参照してください。

この項には次のトピックが含まれます:

- ポートレット・クライアント・メタデータのバックアップ(エクスポート)

- ポートレット・クライアント・メタデータのリストア(インポート)

データベースで格納されるポートレット・プロデューサのデータをバックアップする方法の詳細は、「他のスキーマ・データ(ACTIVITIESとPORTLET)のバックアップおよびリストア」を参照してください。

35.5.10.1 ポートレット・クライアント・メタデータのバックアップ(エクスポート)

WebCenter Portalなど、単一アプリケーションのポートレット・クライアント・メタデータおよびプロデューサのカスタマイズとパーソナライズをエクスポートするには、WLSTコマンドexportPortletClientMetadataを使用します。このコマンドは、アプリケーションで使用されるすべてのポートレット・プロデューサのメタデータをエクスポートします。特定のプロデューサのメタデータをエクスポートすることはできません。

構文の詳細と例は、『WebLogic Server WLSTコマンド・リファレンス』のexportPortletClientMetadataに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

35.5.10.2 ポートレット・クライアント・メタデータのリストア(インポート)

WebCenter Portalに対するポートレット・クライアント・メタデータおよびプロデューサのカスタマイズとパーソナライズをインポートするには、WLSTコマンドimportPortletClientMetadataを使用します。

前提条件:

- アプリケーション・メタデータまたはスキーマが格納されているデータベースおよびポートレット・プロデューサが稼働している必要があります。

- WLSTコマンドexportPortletClientMetadataを使用して、ポートレット・クライアント・メタデータ、プロデューサのカスタマイズおよびパーソナライズを.earファイルにエクスポートします。「ポートレット・クライアント・メタデータのバックアップ(エクスポート)」も参照してください。

構文の詳細と例は、WebCenter WLSTコマンド・リファレンスのimportPortletClientMetadataに関する項およびexportPortletClientMetadataに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

35.5.11 ページレット・プロデューサのメタデータのバックアップおよびリストア

ページレット・プロデューサでは、MDSに構成データとコンテンツを格納します。ページレット・メタデータは、WLSTコマンドexportMetadataおよびimportMetadataを使用して、個別のアーカイブにバックアップできます。詳細は、「ページレット・プロデューサ・コンポーネントのインポート、エクスポート、バックアップおよびリカバリの管理」を参照してください。

35.5.12 分析のメタデータのバックアップおよびリストア

ACTIVITIESデータベース・スキーマ全体をバックアップするには、「他のスキーマ・データ(ACTIVITIESとPORTLET)のバックアップおよびリストア」を参照してください。

35.5.13 監査リポジトリ構成のバックアップおよびリストア

監査ポリシーと監査リポジトリ構成は、WLSTコマンドexportAuditConfigおよびimportAuditConfigを使用して、ファイルにバックアップできます。

構文の詳細と例は、『WebLogic Server WLSTコマンド・リファレンス』のexportAuditConfigに関する項およびimportAuditConfigに関する項を参照してください。

35.6 別のターゲットへのWebCenter Portal全体の移行

エクスポートおよびインポートを使用して、システム管理者は、WebCenter Portalインスタンスを別のターゲットに移行できます。これはステージングから本番への設定で役立ちます。これは、本番インスタンスがインストールおよび構成されており、ステージングのWebCenter Portalインスタンス全体(複数のポータル、共有アセット、グローバル・アーティファクト、セキュリティなどを含む)をターゲットに初めてコピーする必要がある場合です。

また、この項で説明するエクスポートおよびインポートのユーティリティを使用して、特定のポータルで所有されないWebCenter Portalのグローバル・アーティファクト(共有アセット、ビジネス・ロール・ページ、個人用ページおよびカスタマイズされたシステム・ページなど)をバックアップすることもできます。

この項には次のトピックが含まれます:

- WebCenter Portalのインポートおよびエクスポートの理解

- WebCenter Portalのエクスポートおよびインポートの前提条件

- アーカイブへのWebCenter Portalのエクスポート

- WebCenter Portalアーカイブのインポート

35.6.1 WebCenter Portalのインポートおよびエクスポートの理解

エクスポートおよびインポートを使用して、システム管理者は、WebCenter Portalインスタンス全体をステージング環境と本番環境との間で移行できます。図35-1に示すように、WLSTコマンドまたはFusion Middleware Controlを使用して、WebCenter Portalを1つのエクスポート・アーカイブ(.parファイル)にエクスポートできます。

図35-1に示すように、WebCenter Portalのエクスポート・アーカイブ(.parファイル)には複数のファイルが含まれます。

図35-1 別のターゲットへのWebCenter Portalの移行

WebCenter Portalアーカイブに含まれる情報

WebCenter Portalアーカイブには、メタデータ・サービス(MDS)リポジトリに格納される次の情報を含めることができます。

- ポータルおよびテンプレート: すべてのポータルおよびポータル・テンプレート

- アセット: すべての共有アセットおよびポータル・アセット

- 軽量コンテンツ: すべてのポータルのコンテンツ・フォルダ、スタイル・テキストおよびテキストからのイメージ。

- ページ: システム・ページ、ビジネス・ロール・ページ、個人用ページおよびポータル・ページを含むすべてのページ

さらに、WebCenter Portalアーカイブ(.parファイル)には、次の内容を含めることができます。

- ツールおよびサービスのデータ: WebCenter Portalスキーマ(WEBCENTER)にデータを格納するツールおよびサービスに関連付けられたデータベースのデータ
データの移行はオプションです。データを移行するには、エクスポート・オプション「サービス・データを含む」を設定する必要があります。

- セキュリティ: すべてのロール、権限およびユーザー・ロール割当て:

- アプリケーション・ロール(および各ロールに割り当てられた権限)

- ホーム・ポータルのユーザー詳細およびそのアプリケーション・ロールの割当て

- 個々のポータル・メンバー(および各ポータルでのロール割当て)

WebCenter Portalアーカイブに含まれない情報

WebCenter Portalアーカイブ(.parファイル)には、MDSまたはWebCenter Portalデータベース・スキーマにデータを格納しないツールおよびサービス(分析、お知らせ、ディスカッション、(コンテンツ・サーバー上の)ドキュメント、インスタント・メッセージおよびプレゼンス(IMP)、メール、ページレット、カレンダ・イベント、パーソナライズおよびワークリストなど)に関連付けられたデータは含まれません。これらのツールとサービスに関連付けられたデータをバックアップまたは移動する方法の詳細は、「WebCenter Portalインストール全体のバックアップ」を参照してください。

接続情報はWebCenter Portalアーカイブ内に含まれませんが、ソース環境で構成された接続情報を別のファイルにエクスポートして、その接続情報をターゲットにデプロイできます。サーバー名、ポート、コンテンツ管理接続などの接続情報が2つの環境で異なる場合、接続ファイルをデプロイする前に、接続の詳細を分けて変更できます。詳細は、「ステージングから本番への接続の詳細の移動」を参照してください。

常にエクスポートおよびインポートされる情報

WebCenter Portalを別のターゲットに移行するときに、次の情報は常に含まれます。

- セキュリティ・ポリシー

- policy-store.xml: アプリケーションのロールと権限およびポータルのロールと権限

- ユーザー・ロールの割当て

- MDS - 共有/ポータル・アセット

- ページ・テンプレート

- ナビゲーション

- リソース・カタログ

- スキン

- ページ・スタイル

- コンテンツ・プレゼンタ・テンプレート

- マッシュアップ・スタイル

- データ・コントロール

- タスク・フロー

- MDS - ツール/サービス・データ: ノート

- MDS - ツール/サービス・メタデータ

- お知らせ

- ディスカッション

- ドキュメント

- イベント

- リスト(定義)

- ノート

- メール

- ページ

- ポートレット

- 最近のアクティビティ

- リソース・カタログ

- RSSニュース・フィード

- 検索

- タグ

- ワークリスト

- MDS – ポータルのカスタマイズ: ポータルの管理設定

- MDS – ユーザーのカスタマイズ: ページ、タスク・フローおよびプリファレンス

- WebCenter Portalスキーマ - データ

- アクティビティ・ストリーム

- ポータル・イベント

- フィードバック

- リンク

- リスト

- メッセージ・ボード

- プロファイル

- タグ

- ピープル・コネクション: プロファイル、メッセージ・ボード、フィードバック、接続、アクティビティ・ストリームのデフォルト設定、アクティビティ・ストリーム・タスク・フローのカスタマイズ

エクスポートおよびインポートされない情報

WebCenter Portalを別のターゲットに移行するときに、次の情報は含まれません。

- 外部 - アプリケーション・アーティファクト: アイコンおよびイメージ

- External - ツール/サービス・データ

- ドキュメント(コンテンツ・サーバー上)

- Wikiとブログ

- アクティビティ・グラフ

- 分析

- お知らせ

- ディスカッション

- IMP

- メール

- 個人イベント

- ワークリスト

- 即時利用可能: ポータル・テンプレートおよび接続

注意:
接続は、オプションに基づいてエクスポートまたはインポートできます。

WebCenter Portalのエクスポートとインポートは、Fusion Middleware ControlまたはWLSTコマンドを使用して実行できます。詳細は、次を参照してください。

- WebCenter Portalのエクスポートおよびインポートの前提条件

- アーカイブへのWebCenter Portalのエクスポート

- WebCenter Portalアーカイブのインポート

35.6.2 WebCenter Portalのエクスポートおよびインポートの前提条件

WebCenter Portalインスタンスをエクスポートまたはインポートする前に、次の前提条件のタスクを完了しておきます。

1. WebCenter Portalをエクスポートまたはインポートする前に、すべてのバックエンド・コンポーネントをバックアップまたは移行します。
LDAPアイデンティティ・ストア、資格証明ストア、ポリシー・ストア、ディスカッション・サーバー、コンテンツ・サーバー、ポートレット・プロデューサなど、アプリケーションのバックエンド・コンポーネントを移行します。詳細は、「WebCenter Portalインストール全体のバックアップ」を参照してください。

2. WebCenter Portalのメタデータおよびスキーマが格納されているデータベースが稼働中であることを確認します。稼働中でない場合、エクスポートとインポートは機能しません。

3. アプリケーションにWebサービスのデータ・コントロールやポートレットが含まれる場合、エクスポートとインポートが正常に行われるには、関連するすべてのWebサービスまたはプロデューサが稼働中でアクセス可能であることを確認します。

4. WebCenter Portalを別のターゲットに移行する場合、ターゲット・インスタンスで構成されるツールとサービスが、ソース・インスタンスで構成されたツールとサービスのスーパーセットであることを確認します。つまり、ターゲットは、ソースの構成で使用するツールとサービスの少なくとも同じセットで構成される必要があります。そうでない場合は、インポート操作が失敗します。

5. ソースからエクスポートされた接続をターゲットにインポートします。
詳細は、「ステージングから本番への接続の詳細の移動」を参照してください。

6. ソース環境とターゲット環境の両方のユーザーが同じであることを確認します。

注意:

共有アイデンティティ・ストアを使用しない場合、ユーザーを移行する必要があります。

ページ・ユーザーがホーム・ポータルで作成する個人用ページは、ターゲットおよびソース・アプリケーションの両方が同じLDAPアイデンティティ・ストアを使用する場合にのみ移行されます。これは個人用ページ割当てがユーザーGUIDごとであるからです。

ソースでAdministratorロールを割り当てられたすべてのユーザーがターゲット・アイデンティティ・ストアに存在することを確認します。インポート時に、WebCenter Portalのセキュリティ・ポリシーにリストされているユーザーは、ドメインに対して構成されているアイデンティティ・ストアでチェックされます。ユーザーが見つからない場合、そのユーザーに関連付けられているポリシーは削除されます。「外部LDAPサーバーへの管理者アカウントの移行」も参照してください。

7. WebCenter Portalアーカイブをインポートする前に、データベース・スキーマWEBCENTERおよびMDSをターゲットでバックアップします。
「WebCenter Portalインストール全体のバックアップ」を参照してください。

8. インポートするWebCenter Portalのアーカイブ.parファイルが、WebCenter Portal 12.2.1からエクスポートされたものであることを確認します。
アーカイブを、以前のバージョンから直接WebCenter Portal 12.2.1にインポートすることはできません。必要な場合は、エクスポート・アーカイブを作成する前に、ソース環境を12.2.1にアップグレードする必要があります。詳細は、Oracle WebCenterのアップグレードのOracle WebCenter Portalのアップグレードに関する項を参照してください。

35.6.3 アーカイブへのWebCenter Portalのエクスポート

この項では、Fusion Middleware ControlおよびWLSTコマンドを使用して、WebCenter Portalインスタンス全体をエクスポートする方法について説明します。WebCenter Portalは、ローカル・ファイル・システムまたはリモート・サーバーのファイル・システムに保存可能な単一のエクスポート・アーカイブ(.parファイル)にエクスポートされます。

注意:

アーカイブに含まれる内容の詳細は、「WebCenter Portalのバックアップおよびリカバリの理解」を参照してください。

この項には、次の項目が含まれます。

- Fusion Middleware Controlを使用したWebCenter Portalのエクスポート

- WLSTを使用したWebCenter Portalのエクスポート

35.6.3.1 Fusion Middleware Controlを使用したWebCenter Portalのエクスポート

システム管理者は、Fusion Middleware Controlを使用して、WebCenter Portalアプリケーション全体をエクスポートできます。

WebCenter Portalをエクスポートするには:

1. Fusion Middleware Controlで、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「アプリケーションのエクスポート」を選択します(図35-2)。

図35-2 「WebCenter Portal」メニュー: 「アプリケーションのエクスポート」オプション

3. エクスポート・アーカイブの「ファイル名」を変更するか、デフォルトの名前をそのまま使用します。

一意性を保証するために、デフォルトの.parファイル名には、一意のIDのwebcenter_wholeapp_ts_unique_ID.parが含まれています(図35-3)。

図35-3 エクスポート・アーカイブの命名

4. 「エクスポート」をクリックします。

5. 「ダウンロード」ダイアログで(図35-4)、「エクスポート」をクリックして続行するかどうかを確認します。

図35-4 エクスポート・アーカイブのダウンロード

エクスポート・プロセス中に進捗情報が表示されます。エクスポート処理中はエクスポートされているアプリケーションにアクセスできません。

6. エクスポート・プロセスが完了したら、エクスポート・アーカイブ(.par)の保存場所を指定します。

図35-5 エクスポート・アーカイブの保存

次のいずれかを選択します。

- ダウンロード - エクスポートのPARファイルはローカル・ファイル・システムに保存されます。
ブラウザでダウンロードされ、アーカイブはローカルに保存されます。実際のダウンロード場所は、ブラウザの設定ごとに異なります。

- サーバーへエクスポート - エクスポートのPARファイルはサーバー位置に保存されます。
「アーカイブの場所」ダイアログが表示されたら(図35-6)、「サーバーの場所」に適切なパスを入力し(例: /tmp)、「保存」をクリックします。PARの名前はここでは必要ありません。

指定したサーバー・ディレクトリにwrite権限があることを確認します。

図35-6 アーカイブの場所

7. 「閉じる」をクリックして「エクスポート」ウィンドウを閉じます。

エクスポート・アーカイブ(.PAR)が指定の場所に保存されます。

診断ログ・ファイルWC_Spaces-diagnostic.logを調べて、エクスポート・プロセス時にレポートされた警告またはエラーを確認してください。ログ・ファイルを表示するには、メニュー・オプション「WebCenter Portal」→「ログ」→「ログ・メッセージの表示」を選択します。詳細は、「WebCenter Portalログの表示および構成」を参照してください。

「WebCenter Portalのインポートおよびエクスポートのトラブルシューティング」も参照してください。

35.6.3.2 WLSTを使用したWebCenter Portalのエクスポート

WLSTコマンドexportWebCenterApplicationを使用して、WebCenter Portalインスタンス全体をエクスポートします。

次の例では、WebCenter Portalを、MDSのすべてのカスタマイズ(アプリケーションレベルとユーザーレベルの両方のカスタマイズ)およびデータベース・データと一緒にmyAppExport.parというファイルにエクスポートします。connection.propertiesファイルへの接続もエクスポートします。

wls:/weblogic/serverConfig>exportWebCenterApplication(appName='webcenter',
fileName='myAppExport.par', connectionFileName='connection.properties')

次の例では、テストWebCenter Portalインスタンスをエクスポートします。.parファイルは、WLSTコマンドの実行元の場所に保存されます。

wls:/weblogic/serverConfig>exportWebCenterApplication(appName='webcenter',
fileName='myTestAppExport.par')

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのexportWebCenterApplicationに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

35.6.4 WebCenter Portalアーカイブのインポート

この項では、Fusion Middleware ControlおよびWLSTコマンドを使用して、WebCenter Portalアプリケーション全体をインポートする方法について説明します。

WebCenter Portalをインポートする前に、「WebCenter Portalのエクスポートおよびインポートの前提条件」に示すすべてのタスクを完了していることを確認します。

この項には、次の項目が含まれます。

- Fusion Middleware Controlを使用したWebCenter Portalのインポート

- WLSTを使用したWebCenter Portalのインポート

- インポート後のWebCenter Portalの検証

35.6.4.1 Fusion Middleware Controlを使用したWebCenter Portalのインポート

システム管理者は、Fusion Middleware Controlを使用して、WebCenter Portalインスタンス全体をインポートできます。

Fusion Middleware Controlを使用してWebCenter Portalをインポートする手順は次のとおりです。

1. Fusion Middleware Controlで、WebCenter Portalのホームページに移動します。

「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「アプリケーションのインポート」を選択します。

3. アプリケーションのインポート・ページ(図35-7)で、WebCenter Portalアーカイブ(.par)の場所を指定します。

図35-7 アプリケーションのインポート・ページ

次のいずれかを選択します。

- ローカル・ファイル・システムにあるアーカイブ: 「アーカイブの場所」を入力します。または、「参照」をクリックして、.parファイルが格納されているローカル・ファイル・システムでディレクトリを検索します。

- サーバー・ファイル・システムにあるアーカイブ: 「アーカイブの場所」を入力します。WebCenter Portalからアクセス可能な共有の場所になります。

選択するアーカイブには、WebCenter Portal全体のエクスポートが含まれる必要があります。ここで個々のポータルまたはポータル・テンプレートをインポートすることはできません。詳細は、「アーカイブからのポータルのインポート」を参照してください。

4. 「インポート」をクリックします。

5. アプリケーションのインポート・ダイアログ(図35-8)で、「インポート」をクリックします。

図35-8 アプリケーションのインポート・ダイアログ

インポートが完了すると、成功メッセージが表示されます。

WebCenter Portalインスタンス全体をインポートした後、WebCenter Portalにログインして、インポートしたコンテンツを検証します。詳細は、「インポート後のWebCenter Portalの検証」を参照してください。

35.6.4.2 WLSTを使用したWebCenter Portalのインポート

WLSTコマンドimportWebCenterApplicationを使用して、WebCenter Portalインスタンス全体をアーカイブからインポートします。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのimportWebCenterApplicationに関する項を参照してください。

次の例では、エクスポート・アーカイブmyAppExport.parからWebCenter Portalをインポートします。

wls:/weblogic/serverConfig>importWebCenterApplication(appName='webcenter',fileName='myAppExport.par')

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

注意:

WebCenter Portalインスタンスをインポートした後、WebCenter Portalにログインして、インポートしたコンテンツを検証します。詳細は、「インポート後のWebCenter Portalの検証」を参照してください。

35.6.4.3 インポート後のWebCenter Portalの検証

アーカイブからWebCenter Portalをインポートした後、次の操作を行う必要があります。

1. 新たにインポートしたWebCenter Portalインスタンスをデプロイする管理対象サーバー(WC_Portal)を再起動します。

クラスタ環境で、クラスタの各管理対象サーバーを再起動します。「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」も参照してください。

2. WebCenter Portalにログインして、すべてのポータルとポータル・テンプレートが予想どおりに使用できることを検証します。

使用できない場合は、「ポータルおよびポータル・テンプレートがインポート後に使用できない」を参照してください。

3. Oracle Secure Enterprise Searchクローラを開始し、新たにインポートされたデータを索引付けします。

35.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メタデータのみをバックアップからリストアします。
「分析のメタデータのバックアップおよびリストア」を参照してください。

この項の情報では、手動でリストアする方法について説明します。データを頻繁にリストアまたは移行する必要がある場合は、プロセスを自動化するスクリプトを作成できます。詳細は、「スクリプトを使用したWebCenter Portalのバックアップおよびリストア」を参照してください。

35.8 スクリプトを使用したWebCenter Portalのバックアップおよびリストア

WebCenter Portalインストールを手動でバックアップするには時間がかかる場合があります。定期的なバックアップを自動化してスケジュール設定するスクリプトを使用すると、効率が上がり、時間が大幅に節約されます。Oracleにはこの開始に役立つサンプルのバックアップ・スクリプトが用意されています。このスクリプトを使用すると、インストールやバックアップの要件に合せてカスタマイズできます。

詳細は、次のトピックを参照してください。

- バックアップおよびリストアのスクリプト・ファイルの理解

- スクリプトを使用したWebCenter Portalのバックアップ

- スクリプトを使用したWebCenter Portalのバックアップからのリストア

35.8.1 バックアップおよびリストアのスクリプト・ファイルの理解

Oracleには、バックアップとリカバリのプロセスの自動化に役立つサンプル・スクリプトが用意されています。サンプル・スクリプトにより、次の情報のバックアップとリストアが行われます。

- データベース・スキーマ: WebCenter Portalの必要なすべてのスキーマをバックアップします。

- ファイル・ストアのデータ: WebCenter Contentファイル・システムに格納されているWebCenter Portalデータをバックアップおよびリストアします。

- セキュリティ情報: WebCenter Portalのポリシー・ストア、資格証明ストア、監査構成をバックアップおよびリストアします。

表35-2に、バックアップおよびリカバリ用に提供されるサンプル・スクリプトとファイルを示します。

表35-2 バックアップおよびリストア用のサンプル・スクリプトおよびファイル

サンプル・スクリプトおよびファイル

説明

使用目的

master_script.sh

データベースのエクスポート・コマンドを実行し、WebCenter Contentをファイル・システムにアーカイブして、WLSTのエクスポートおよびインポートのコマンドを実行するシェル・スクリプト。

「master_script.sh」を参照してください。

バックアップおよびリストア

wlst_script.py

ポートレットとセキュリティのメタデータをエクスポートおよびインポートするためのWLSTコマンドを実行するPythonスクリプト。

「wlst_script.py」を参照してください。

バックアップおよびリストア

backup.properties

WebCenter Portalデータベースをバックアップして、master_script.shおよびwlst_script.pyでWLSTのエクスポート・コマンドを実行する入力パラメータを含むプロパティ・ファイル。

「backup.propertiesファイルおよびrestore.propertiesファイル」を参照してください。

バックアップのみ

restore.properties

WebCenter Portalデータベースをリストアして、WLSTのインポート・コマンドをバックアップ・ファイルから実行できる、master_script.shおよびwlst_script.pyの入力パラメータを含むプロパティ・ファイル。

「backup.propertiesファイルおよびrestore.propertiesファイル」を参照してください。

リストアのみ

サンプル・ファイルは、確認や変更を行うための起動スクリプトです。あるいは、必要に応じて、独自のスクリプトを最初から作成できます。

35.8.1.1 master_script.sh

master_script.shは、次のデータベース・スキーマに格納される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については、「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をコールします。詳細は、「wlst_script.py」を参照してください。

次に、サンプルの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.$$

35.8.1.2 wlst_script.py

wlst_script.shスクリプトでは、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)

注意:

各アイテムをバックアップまたはリストアする場合は、「WebCenter Portalインストール全体のバックアップ」または「WebCenter Portalインストール全体のリストア」の該当する項を参照してください。

次に、サンプルの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
disconnect()
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
disconnect()
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)

35.8.1.3 backup.propertiesファイルおよびrestore.propertiesファイル

backup.propertiesファイルには、master_script.shおよびwlst_script.pyでのバックアップ・コマンドの入力パラメータが含まれます。たとえば、ファイル名、データベース・ホームの場所、データベース接続文字列、スキーマ名などがあります。

リストア・コマンドの入力パラメータを定義するには、類似する.propertiesファイル(restore.properties)が必要です。

表35-3に、backup.propertiesファイルとrestore.propertiesファイルの入力パラメータを示し、これらについて説明します。

表35-3 バックアップ・スクリプトおよびリストア・スクリプトのユーザー定義パラメータ

バックアップ/リストアのパラメータ

説明

例

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_Portal

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

次の例では、サンプルの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_Portal

## 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

次の例では、サンプルの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_Portal

## 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

35.8.2 スクリプトを使用したWebCenter Portalのバックアップ

この項では、スクリプト・ファイルを使用してWebCenter Portalバックアップを設定、検証およびスケジュールする方法について説明します。

1. バックアップ・スクリプトを作成します(初回のみ)。

2. セキュリティ・ストアのバックアップの前提条件タスクを完了します(初回のみ)。

3. バックアップ・パラメータを設定してスクリプトをカスタマイズします(初回のみ)。

4. バックアップ・スクリプトを実行します。

5. バックアップ・アーカイブを検証します。

6. スクリプトを使用して定期的なバックアップのスケジュールを設定します。

35.8.2.1 バックアップ・スクリプトの作成

(初回のみ)

1. スクリプトとバックアップ用のディレクトリをファイル・システムに作成します。

例: /scratch/aime1/mywebcenterportal_scripts/backups

2. master_script.shからmaster_script.shのサンプル・コードをコピーしてテキスト・エディタに貼り付け、ファイルの名前をmaster_script_backup.shにして、手順1で作成したディレクトリに保存します。

注意:

UNIXまたはLinuxで実行する場合、スクリプトに非表示の文字やDOSの文字が含まれないようにしてください。

3. wlst_script.pyからwlst_script.pyのサンプル・コードをコピーしてテキスト・エディタに貼り付け、ファイルの名前をwlst_script.pyにして同じディレクトリに保存します。

4. backup.propertiesファイルおよびrestore.propertiesファイルからbackup.propertiesのサンプル・コードをコピーしてテキスト・エディタに貼り付け、ファイルの名前をbackup.propertiesにして同じディレクトリに保存します。

35.8.2.2 セキュリティ・ストアのバックアップの前提条件タスクの完了

(初回のみ)

ソース環境で次のようにします。

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. ポリシー・ストアをバックアップするためのソース情報とターゲット情報を次のように構成します。

a. ターゲットのポリシー・ストアをポイントするには、(閉じタグ</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/

b. (閉じタグ</jpsContexts>の上で)次のエントリを追加して構成します。

<jpsContext name="mysourcePolicy">
<serviceInstanceRef ref="policystore.db"/>
</jpsContext>

<jpsContext name="mytargetPolicy">
<serviceInstanceRef ref="policystore.backup.xml"/>
</jpsContext>

3. 資格証明ストアをバックアップするためのソース情報とターゲット情報を次のように構成します。

a. ターゲットの資格証明ストアをポイントするには、(閉じタグ</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。

b. (閉じタグ</jpsContexts>の上で)次のエントリを追加して構成します。

<jpsContext name="mysourceCred">
<serviceInstanceRef ref="credstore.db"/>
</jpsContext>

<jpsContext name="mytargetCred">
<serviceInstanceRef ref="credstore.backup.xml"/>
</jpsContext>

35.8.2.3 バックアップ・パラメータの設定およびスクリプトのカスタマイズ

(初回のみ)

1. テキスト・エディタでbackup.propertiesを開きます。

2. OPERATION=exportであることを確認します。

3. ファイルでパラメータの値を指定します。

各パラメータの説明については、表35-3を参照してください。

注意:

不要なパラメータはコメント・アウトできます。

4. 必要に応じて、バックアップ・スクリプトをカスタマイズします。

オブジェクトを除外するには、関連するバックアップ・コマンドのコードをコメント・アウトします。スクリプトを使用して追加のオブジェクトをバックアップするには、必要なコードを追加します。

5. 変更を保存します。

35.8.2.4 バックアップ・スクリプトを実行します。

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)の下にある別のフォルダに保存されます。タイムスタンプ情報はバックアップ・フォルダ名に含まれるため、バックアップと特定の日時との関連付けが容易です。

35.8.2.5 バックアップ・アーカイブを検証します。

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ファイル

35.8.2.6 スクリプトを使用して定期的なバックアップのスケジュールを設定します。

データのバックアップをmaster_script_backup.shで正常に作成することでバックアップ・スクリプト構成を検証したら、バックアップを定期的にスケジュール設定することをお薦めします。

スクリプトを実行するたびに、バックアップ・データは、以前のバックアップが保持されるように、メイン・バックアップ・フォルダ(DATA_DIRECTORY)の下にある別のフォルダに保存されます。

データのバックアップ時のデータ整合性の問題を最小限に抑えるには、ピーク使用時にバックアップのスケジュールを設定しないことをお薦めします。

35.8.3 スクリプトを使用したWebCenter Portalのバックアップからのリストア

この項では、スクリプト・ファイルを使用して、WebCenter Portalインストールをバックアップからリストアする方法について説明します。

1. リストア・スクリプトを作成します(初回のみ)。

2. データベース・スキーマを手動でリストアします(初回のみ)。

3. セキュリティ・ストアのリストアの前提条件タスクを完了します(初回のみ)。

4. リストア・スクリプトのパラメータを設定します。

5. リストア・スクリプトを実行します。

6. リストアされたデータを検証します。

35.8.3.1 リストア・スクリプトの作成

(初回のみ)

1. (「スクリプトを使用したWebCenter Portalのバックアップ」の手順に従い)前に作成したバックアップ・スクリプトmaster_script.shおよびwlst_script.pyを複製して、これらを別の場所にコピーします。

例: /scratch/aime1/mywebcenterportal_scripts/restore

2. backup.propertiesファイルおよびrestore.propertiesファイルからrestore.propertiesのサンプル・コードをコピーしてテキスト・エディタに貼り付け、ファイルの名前をrestore.propertiesにして同じディレクトリに保存します。

3. 必要に応じて、ファイルの名前を変更します。

例: master_script_restore.sh、wlst_restore_script.py、restore.properties

35.8.3.2 手動によるデータベース・スキーマのリストア

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. すべてのサーバーを停止します。

35.8.3.3 セキュリティ・ストアのリストアの前提条件タスクの完了

(初回のみ)

ターゲット環境で次のようにします。

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. ポリシー・ストアをリストアするためのソース情報とターゲット情報を次のように構成します。

a. ソースのポリシー・ストアをポイントするには、(閉じタグ</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

b. (閉じタグ</jpsContexts>の上で)次のエントリを構成します。

<jpsContext name="targetPolicy">
<serviceInstanceRef ref="policystore.ldap"/>
</jpsContext>

<jpsContext name="sourcePolicy">
<serviceInstanceRef ref="policystore.backup.xml"/>
</jpsContext>

3. 資格証明ストアをリストアするためのソース情報とターゲット情報を次のように構成します。

a. ソースの資格証明ストアをポイントするには、(閉じタグ</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。

b. (閉じタグ</jpsContexts>の上で)次のエントリを構成します。

<jpsContext name="targetCred">
<serviceInstanceRef ref="credstore.ldap"/>
</jpsContext>

<jpsContext name="sourceCred">
<serviceInstanceRef ref="credstore.backup.xml"/>
</jpsContext>

35.8.3.4 リストア・スクリプトのパラメータを設定します。

(初回のみ)

1. テキスト・エディタでrestore.propertiesを開きます。

2. OPERATION=importであることを確認します。

3. ファイルですべてのパラメータの値を指定します。

各パラメータの説明については、表35-3を参照してください。

4. 変更を保存します。

35.8.3.5 リストア・スクリプトを実行します。

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ファイルを配置するディレクトリが表示されます。

35.8.3.6 リストアされたデータの検証

WebCenter Portalインストールを確認します。

1. 1つ以上のデータベース・スキーマをインポートする場合、それらのデータベースをシャットダウンして再起動し、すべての管理対象サーバーを再起動します。

2. ターゲットのWebCenter Portalインスタンスに、リストアされたデータが含まれていることを検証します。

35.9 WebCenter Portal環境のクローニング

クローニングにより、既存のWebCenter Portal環境に基づいて新しいWebCenter Portal環境が作成されます。WebCenter Portalインストールのインストール、構成、カスタマイズ、検証を行うことができ、システムが安定している場合、すべてのコンポーネントとその構成をソース環境からコピーして別の環境を作成できます。これにより、ソース環境に組み込んでテストしたすべての変更を再実行する必要がないため、時間が節約されます。詳細は、『Oracle Fusion Middlewareの管理』のOracle WebCenter Portalを移動するための追加手順に関する項を参照してください。

第VII部 複数言語ポータルの管理

『Oracle WebCenter Portalの管理』のこの部では、Oracle WebCenter Portalの言語と翻訳について説明します。

- 複数言語ポータルの管理

36 複数言語ポータルの管理

この章では、WebCenter Portalでサポート可能な言語と、アプリケーションおよびポータル・レベルでの翻訳とポータル内の特定文字列の翻訳の管理方法について説明します。

この章の内容は次のとおりです。

- WebCenter Portalの言語について

- アプリケーションレベルでの文字列の変更と翻訳

- ポータルの文字列の翻訳

- ポータルの特定文字列に対する翻訳の変更と追加

- WebCenter Portalへの新規言語のサポートの追加

権限

この章のタスクを実行するには、次のロールが付与されている必要があります。

- WebLogic Server: Oracle WebLogic Server管理コンソールを使用して付与される、AdminロールまたはMonitorロール。

- WebCenter Portal: WebCenter Portal管理を使用して付与されるAdministratorロール、または次の権限を付与されているカスタム・ロール。
Basic Services: Edit Page Access, Structure, and Content permission。

「管理操作、ロールおよびツールの理解」も参照してください。

36.1 WebCenter Portalの言語について

ポータルで異なる言語をサポートする必要がある場合、ローカライズされたコンテンツをユーザーが選択した言語とロケールに基づいて表示するように、ポータルを構成できます。

たとえば、イタリア語を話すユーザーがページを表示することがわかっている場合、イタリア語が(ブラウザ、ユーザー・プリファレンス、ポータルまたはアプリケーション設定で)選択されたときにページ内のテキスト文字列をイタリア語で表示するように、ページをローカライズできます。

また、ロケールを選択する際は、選択したロケールに適用される、特殊な書式について考慮する必要があります。たとえば、通常の情報の表示方向が左から右、右から左のどちらであるか、数字をどのように表記するか(通貨情報など)などを考慮します。

WebCenter Portal内に表示される主な情報のタイプは、次の3つです。

- ユーザー・インタフェース(UI)要素。フィールドとボタンのラベル、シードされたボイラープレート・テキストなどがあります。

- ユーザー入力メタデータ。ページ名、ポータル名、ポータルの説明などがあります

- ユーザーが追加したコンテンツ。公開済テキストおよびイメージ、ドキュメント、お知らせ、ディスカッション・フォーラム・コンテンツなどがあります

変更に関する処理は、情報のタイプごとに異なります。

- UI要素:

注意:

UI要素には、28の言語と100の異なるロケールに対応した、デフォルトの翻訳が含まれています。デフォルトのUIテキストが会社の要件に合っていない場合や、会社で追加の言語をサポートする必要がある場合にのみ、このテキストを変更する必要があります。

- WebCenter Portalアプリケーション全体(1つのポータルだけでなく)のテキストを変更するには、オーバーライド・バンドル(SpacesSeedDataOverrideBundle.xlf)の文字列を編集します。

- 特定のポータルのUIテキストを変更するには、ポータル固有のリソース・バンドル(scope-resource-bundle.xlf)に含まれる文字列を編集します。

- ユーザー入力メタデータ(ページ名、ポータル名、ポータルの説明など)は、文字列としてポータルのリソース・バンドルに保存されます。ポータルごとに、独自のリソース・バンドルがあります。ユーザー入力メタデータを変更するには、ポータル固有のリソース・バンドルに含まれる文字列を編集します。

注意:

一般的に、複数の言語で表示する必要があるユーザー入力メタデータは、会社全体向けのコンテンツまたはカスタマに表示されるコンテンツであり、多くの場合、なんらかの形式で翻訳が提供されます。より特殊なコンテンツ(特定の部門や地域に固有のコンテンツなど)に必要な言語は1つのみである可能性が高く、したがって翻訳を必要としません。

- コンテンツ公開コンポーネントで追加されたコンテンツは翻訳でき、システム管理者がコンテンツ・プレゼンタを使用して翻訳済WebCenterコンテンツ・アイテムを表示できます。お知らせおよびディスカッション・フォーラムで追加されたコンテンツは、通常、そのユーザーが使用する言語で表示されます。
ローカライズされたコンテンツの提供の詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルの他の言語への翻訳に関する項を参照してください。

36.1.1 WebCenter Portalによってデフォルトでサポートされる言語

WebCenter Portalでは、28の言語と100の異なるロケールに対応した翻訳が実行時に提供されます。

表36-1のリストには、追加設定なしでWebCenter Portalからすぐに利用できるすべての言語が含まれています。ユーザーは、特定の言語に関連付けられたロケールを選択することもできます。たとえば、ユーザーは言語をアラビア語に変更し、その言語グループの中で、アルジェリア、バーレーン、ジブチなど、20の異なるロケールを選択できます。

表36-1 WebCenter Portalで提供される言語

AからGe

GrからRo

RuからT

アラビア語

ギリシャ語

ロシア語

ポルトガル語(ブラジル)

ヘブライ語

中国語(簡体字)

チェコ語

ハンガリー語

スロバキア語

デンマーク語

イタリア語

スペイン語

オランダ語

日本語

スウェーデン語

英語

韓国語

タイ語

フィンランド語

ノルウェー語

中国語(繁体字)

フランス語

ポーランド語

トルコ語

フランス語(カナダ)

ポルトガル語

ドイツ語

ルーマニア語

注意:

Oracle Enterprise Managerなど、WebCenter Portalにサービスを提供する管理層では、WebCenter Portalで使用可能な言語サブセットが提供されます。これには次のものがあります。

- 英語

- ポルトガル語(ブラジル)

- 中国語(簡体字)

- 中国語(繁体字)

- フランス語

- ドイツ語

- イタリア語

- 日本語

- 韓国語

- スペイン語

ディスカッションには、WebCenter Portalのディスカッション・サーバーが使用されます。初期設定では、ディスカッション・サーバー・アプリケーションでは、英語とスペイン語がサポートされています。これは表36-1にリストされている他の言語をサポートしません。ただし、アプリケーションはユーザー独自の翻訳ファイルを受け入れます。詳細は、Jiveのドキュメント・サイトを参照してください。この情報は、ディスカッション・サーバー・アプリケーションのユーザー・インタフェースに明示的に示されます。

注意:

ページレット・プロデューサの管理UIでは、9か国語の管理言語とオランダ語がサポートされています。

36.2 アプリケーションレベルでの文字列の変更と翻訳

変更または翻訳対象が、アプリケーション全体のUIテキスト、特定ポータルのUIテキスト、またはポータル内のユーザー入力メタデータのいずれであっても、そのプロセスは基本的に同じで、該当するファイルをそれぞれ変更するだけです。

アプリケーション全体にシードされたUIテキストを変更するには、オーバーライド・バンドル(SpacesSeedDataOverrideBundle.xlf)を編集します。

アプリケーション・レベルで文字列を変更または翻訳するには:

1. WLSTを起動します。詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

2. WLSTコマンドexportMetadataを使用して、オーバーライド・バンドルをエクスポートします。

exportMetadata(application='webcenter',server='WC_Portal',toLocation='/tmp/metadata',docs='/xliffBundles/SpacesSeedDataOverrideBundle.xlf')

この例では、WC_Portal管理対象サーバー上のWebCenter Portal (webcenter)のSpacesSeedDataOverrideBundle.xlfを/tmp/metadataフォルダにエクスポートします。アプリケーション名には、必ずwebcenterを使用してください。

WebCenter Portalのインストールをホストする管理対象サーバーの名前と一致するようにserver値を変更します。

toLocation値を、文字列ファイルのエクスポート先となる場所に変更します。

詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』の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_Portal',fromLocation='/tmp/metadata',docs='/xliffBundles/SpacesSeedDataOverrideBundle.xlf')

この例では、/tmp/metadataフォルダから、該当する文字列ファイルをWC_Portal管理対象サーバー上のwebcenterアプリケーションにインポートしています。fromLocationのパスを、文字列ファイルのインポート元となる場所に変更します。アプリケーション名には、必ず「webcenter」を使用してください。WebCenter Portalのインストールをホストするサーバーと一致するようにサーバー名を変更します。

詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』のimportMetadataに関する項も参照してください。

8. WC_Portal管理対象サーバーを再起動し、変更がUIの表示に反映されていることを確認します。

36.3 ポータルの文字列の翻訳

特定のポータルの文字列を翻訳するには、ポータル固有のリソース・バンドル(scope-resource-bundle.xlf)を編集します。翻訳できる文字列は、ポータルの表示名、説明およびページ・タイトルです。

ポータルの文字列を翻訳するには:

1. WLSTを起動します。詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

2. WLSTコマンドのexportMetadataを使用して、文字列ファイルをエクスポートします。

- すべての文字列ファイルをエクスポートする場合は、docs属性を含めません。例:

exportMetadata(application='webcenter',server='WC_Portal',toLocation='/tmp/metadata')

この例では、WC_Portal管理対象サーバー上にあるWebCenter Portal (webcenter)のすべての文字列ファイルを/tmp/metadataフォルダにエクスポートしています。アプリケーション名には、必ずwebcenterを使用してください。

WebCenter Portalのインストールをホストする管理対象サーバーの名前と一致するようにserverの値を変更します。

toLocationのパスを、文字列ファイルのエクスポート先となる場所に変更します。

- 特定の文字列ファイルのみをエクスポートする場合は、docs属性を含めます。例:

exportMetadata(application='webcenter',server='WC_Portal',toLocation='/tmp/metadata',docs='/oracle/webcenter/translations/scopedMD/PORTAL_GUID/scope-resource-bundle.xlf')

この例の結果は1つ目の例と似ていますが、ポータル固有のリソース・バンドルのみがエクスポートされます。PORTAL_GUIDを文字列の変更対象となるポータルのGUIDに置換します。

注意:

複数のファイルをエクスポートするには、ファイルの場所をカンマで区切ります。

詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』の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の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_Portal',fromLocation='/tmp/metadata')

この例では、すべての文字列ファイルを、/tmp/metadataフォルダからWC_Portal管理対象サーバー上のwebcenterアプリケーションにインポートしています。fromLocationのパスを、文字列ファイルのインポート元となる場所に変更します。アプリケーション名には、必ず「webcenter」を使用してください。WebCenter Portalのインストールをホストするサーバーと一致するようにサーバー名を変更します。

- 特定の文字列ファイルのみをインポートする場合は、docs属性を含めます。

importMetadata(application='webcenter',server='WC_Portal',fromLocation='/tmp/metadata',docs='/oracle/webcenter/translations/scopedMD/PORTAL_GUID/scope-resource-bundle.xlf')

この例の結果は1つ目の例と似ていますが、ポータル固有のリソース・バンドルのみがインポートされます。PORTAL_GUIDを文字列の変更対象となるポータルのGUIDに置換します。docs属性を使用することをお薦めします。

注意:

複数のファイルをインポートするには、ファイルの場所をカンマで区切ります。

詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』のimportMetadataに関する項も参照してください。

8. WC_Portal管理対象サーバーを再起動し、変更がUIの表示に反映されていることを確認します。

36.4 ポータルの特定文字列に対する翻訳の変更と追加

ビジネス要件に合わせるために、ポータルの特定文字列のみを翻訳する場合があります。たとえば、ポータル内のページにある特定のインスタンスで、「お知らせ」タスク・フローのタイトルのみを翻訳する必要がある場合があります。

ポータル内の文字列の特定のインスタンスに翻訳を追加するには:

1. WLSTコマンドのexportMetadataを使用して、文字列ファイルをエクスポートします。例:

exportMetadata(application='webcenter',server='WC_Portal',toLocation='/tmp/metadata',docs='/oracle/webcenter/translations/scopedMD/PORTAL_GUID/scope-resource-bundle.xlf')

この例では、WC_PortalにデプロイされたOracle WebCenter Portal (webcenter)のポータル固有のリソース・バンドルを/tmp/metadataフォルダにエクスポートしています。PORTAL_GUIDを文字列の変更対象となるポータルのGUIDに置換します。必要に応じて、WebCenter Portalのインストールに合うようにサーバー名を変更します。toLocationのパスを、文字列ファイルのエクスポート先となる場所に変更する必要があります。

詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。WebCenter WLSTコマンド・リファレンスのexportMetadataに関する項も参照してください。

2. 翻訳する文字列ファイルの言語/ロケール固有バージョンを作成します。
/oracle/webcenter/translations/scopedMD/PORTAL_ GUID/scope-resource-bundle.xlfをコピーして、PORTAL_GUIDをポータルのGUIDに置換します。次にそのファイルに必要な名前を付けて保存します。たとえば、ポータル全体のUIテキストをカタリナ語に翻訳するには、ファイルの名前をscope-resource-bundle_ca.xlfにします。

3. 翻訳されるファイルを翻訳チームに送信して、編集します。翻訳の手順は、次のとおりです。

a. JDeveloperまたはテキスト・エディタで文字列ファイルを開きます。

注意:

編集したファイルを正しくエンコードしないと、翻訳をインポートする際にエラーが発生する場合があります。Oracle JDeveloperは特殊文字を自動的に正しくエンコードするため、ファイルの編集にはOracle JDeveloperを使用することをお薦めします。

b. 変更する<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内)は、Portalコンポーザで必要な文字列に表示されるリソース・キーに対応します。リソース・キーの詳細は、『Oracle WebCenter Portalでのポータルの構築』の文字列のリソース・キーの確認に関する項を参照してください。

c. 必要に応じて、指定された<trans-unit>ブロックの<source>テキストを翻訳します。

d. ファイルを保存します。

4. WLSTコマンドのimportMetadataを使用して、更新された文字列ファイルをWebCenter Portalに再度インポートします。例:

importMetadata(application='webcenter',server='WC_Portal',fromLocation='/tmp/metadata',docs='/oracle/webcenter/translations/scopedMD/PORTAL_GUID/scope-resource-bundle.xlf')

この例では、指定されたポータルの文字列ファイルを、/tmp/metadataフォルダからWC_Portal管理対象サーバーにデプロイされたOracle WebCenter Portal (webcenter)にインポートしています。PORTAL_GUIDを文字列の変更対象となるポータルのGUIDに置換します。必要に応じて、WebCenter Portalのインストールに合うように管理対象サーバーの名前を変更します。fromLocationのパスを、文字列ファイルのインポート元となる場所に変更します。

詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。WebCenter WLSTコマンド・リファレンスのimportMetadataに関する項も参照してください。

5. WebCenter Portal内の必要なUI要素のリソース・キーを更新します。たとえば、ポータル内における特定の「お知らせ」タスク・フローのタイトルを翻訳する場合、次の手順を実行します。

a. WebCenter Portalにログオンし、ページ・エディタでお知らせタスク・フローが含まれるポータル・ページを開きます。『Oracle WebCenter Portalでのポータルの構築』のページ・エディタでページを開く方法に関する項を参照してください。

b. コンポーネント・ツールバーで、「アクション・メニューの表示」をクリックして、「表示オプション」を選択して「表示オプション」ダイアログを開きます。

c. 「テキスト」フィールドに、次の形式の新しいリソース・キーを指定します。

#{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']}

d. 「OK」をクリックします(図36-1)。

図36-1 「お知らせ」タスク・フローの「コンポーネント・プロパティ」ダイアログ

6. WC_Portal管理対象サーバーを再起動し、WebCenter Portalで変更内容が反映されているかどうかを確認します。

36.5 WebCenter Portalへの新規言語のサポートの追加

WebCenter Portalではデフォルトでサポートされていない新規言語のサポートを追加できます。WebCenter Portalを有効化して追加言語をサポートするには、ポータルの文字列をリソース・バンドル内で新規言語に翻訳し、2つの言語の構成ファイル(supported-languages.xmlおよびfaces-config.xml)を更新し、該当する言語更新をカスタム共有ライブラリにデプロイします。

新規言語のサポート追加に関する情報は、Oracle Technology NetworkのOracle WebCenter Portalホワイト・ペーパーおよびテクニカル・ノートのページにあるホワイト・ペーパーSpacesのサンプル拡張機能を参照してください。

第VIII部 WebCenter Portalでのポータルの管理

『Oracle WebCenter Portalの管理』のこの部では、WebCenter Portal管理のページでWebCenter Portalユーザーのグローバル設定を管理する方法について説明します。

- WebCenter Portal管理の設定ページの理解

- WebCenter Portal管理のポータル・ページの理解

- ポータル間のグローバルなデフォルト設定の構成

- ポータル間のセキュリティの管理

- ポータル間のグローバル属性での作業

- システム・ページのカスタマイズ

- ビジネス・ロール・ページの管理

- 個人用ページの管理

- デバイス設定の管理

- タスク・フローのカスタマイズ

- ポータルの使用状況の分析

37 WebCenter Portal管理の設定ページの理解

この章では、WebCenter Portal管理の「設定」ページで使用できるタスクについて説明します。

この章の内容は次のとおりです。

- WebCenter Portal管理の設定ページについて

- WebCenter Portal管理の設定ページへのアクセス

- WebCenter Portal管理の設定の使用

権限

この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは実行する特定のタスクに必要な権限を付与されているカスタム・ロールが必要です。設定ページで必要な権限の概要は、表37-1を参照してください。

注意:

- Internet Explorerを使用している場合は、WebCenter Portalにアクセスする前に互換性モードをオフにしてください。Internet Explorerの「ツール」メニューで、「互換性表示設定」を選択します。「互換表示設定」ダイアログで、すべてのオプションを選択解除し、「閉じる」をクリックします。

- WebCenter Portalでは、1つのブラウザ・タブまたはウィンドウ表示のみがサポートされます。WebCenter Portalを複数のブラウザ・タブまたはウィンドウに同時に表示しようとしても、正しく動作しません。

37.1 WebCenter Portal管理の設定ページについて

システム管理者は、WebCenter Portal管理の設定ページで(図37-1)、「WebCenter Portal管理の設定の使用」に記載されたタスクを実行できます。

図37-1 WebCenter Portal管理の「設定」

37.2 WebCenter Portal管理の設定ページへのアクセス

WebCenter Portal管理の「設定」ページを次の手順で開きます。

- 「ポータル」メニューから「管理」を選択し、「設定」をクリックします。

- ポータル・ブラウザで、「管理」タイル(図37-2)をクリックし、「設定」をクリックします。

図37-2 WebCenter Portalの「管理」へのアクセス

- ブラウザで次のURLを入力し、「設定」ページに直接移動します。

http://host:port/webcenter/portal/admin/settings

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

37.3 WebCenter Portal管理の設定の使用

WebCenter Portal管理の「設定」には、図37-3に示すページが含まれており、表37-1で説明しています。

図37-3 WebCenter Portal管理の「設定」

表37-1に、システム管理者がWebCenter Portal管理の「設定」の各ページで実行できるアクションの説明と、各アクションの実行に必要な権限を示します。

表37-1 WebCenter Portal管理の「設定」ページ

ページ

説明

必要な権限

一般

このページを使用して、次のようなWebCenter Portalのアプリケーションレベルのプロパティを設定します。

- アプリケーション名とロゴ

- デフォルトのページ・テンプレート、スキンおよびナビゲーション

- 使用するリソース・カタログ

- ページ・フッターのオプション

- デフォルト言語

- ユーザーやグループの開始ページまたはポータル

- セッション・タイムアウトのオプションおよび設定

- 自己登録オプション

詳細は、「ポータル間のグローバルなデフォルト設定の構成」を参照してください。

Portal Server: Manage All

または

Portal Server: Manage Configuration

セキュリティ

このページを使用して、ユーザーに対する表示および変更可能な項目を制御できるデフォルトのセキュリティ・モデルを表示します。WebCenter Portalにユーザーおよびグループを追加して、ロールを割り当てることもできます。

詳細は、「ポータル間のセキュリティの管理」を参照してください。

Portal Server: Manage All

ツールとサービス

このページを使用して、WebCenter Portalのツールとサービスの設定を管理します。

詳細は、「ツールおよびサービスの管理」を参照してください。

Portal Server: Manage All

または

Portal Server: Manage Configuration

注意: ツールおよびサービスの一部では追加の権限が必要な場合があります。たとえば、ピープル・コネクション、ポートレット・プロデューサおよび外部アプリケーションには、WebCenter PortalのAdministratorロールおよびWebLogic ServerのAdminロールが必要になります

属性

このページを使用して、WebCenter Portalの属性の設定を管理します。

詳細は、「ポータル間のグローバル属性での作業」を参照してください。

Portal Server: Manage All

または

Portal Server: Manage Configuration

システム・ページ

このページを使用してデフォルトの事前構成済ページをカスタマイズします。これには、WebCenter Portalで使用できるタスク・フローなどが含まれます。

詳細は、「システム・ページのカスタマイズ」を参照してください。

Portal Server: Manage All

または

Portal Server: Manage Configuration

または

Pages: Create, Edit, and Delete Pages

ビジネス・ロール・ページ

このページを使用して、特定のユーザーおよびグループを対象としたページでの作業や、これらのビジネス・ロール・ページに対するページ管理タスクを実行します。

詳細は、「ビジネス・ロール・ページの管理」を参照してください。

Portal Server: Manage All

または

Portal Server: Manage Configuration

または

Pages: Create, Edit, and Delete Pages

個人用ページ

このページを使用して、ユーザーが作成する個人用ページを管理します。ユーザーは個人用ページを作成して、そのページへのアクセスを設定できます。ただし、システム管理者は、他のユーザーが作成した個人用ページを編集できます。

詳細は、「個人用ページの管理」を参照してください。

Portal Server: Manage All

または

Portal Server: Manage Configuration

または

Pages: Create, Edit, and Delete Pages

デバイス設定

このページを使用して、WebCenter Portalのデバイス・グループとデバイスを作成および管理します。デバイス・グループを作成し、種々のデバイスをそれに関連付け、デバイス・グループに対して使用するスキンおよびページ・テンプレートなどのアセットを指定できます。

詳細は、「デバイス設定の管理」を参照してください。

Portal Server: Manage All

または

Portal Server: Manage Configuration

38 WebCenter Portal管理のポータル・ページの理解

この章では、WebCenter Portal管理の「ポータル」ページでポータルを管理する方法について説明します。

この章の内容は次のとおりです。

- WebCenter Portal管理のポータル・ページについて

- WebCenter Portal管理のポータル・ページへのアクセス

- ポータル・リストのソート

- ポータルの作成

- ポータルのエクスポートおよびインポート

- 任意のポータルに関する情報の表示

- ポータルへのリンクの共有

- 任意のポータルのクローズ

- 任意のポータルの再アクティブ化

- 任意のポータルのオフライン化

- 任意のポータルの再オンライン化

- ポータルの削除

権限

この章で説明するタスクを任意のポータルで実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portals: Manage Security and Configuration

ポータル・マネージャ(またはポータルの Administration: Manage Security and ConfigurationまたはAdministration: Manage Configuration権限を持っている場合)は、『Oracle WebCenter Portalでのポータルの構築』のポータルの管理に関する項で説明されているように、そのポータル上でこれらのタスクを実行できます。

権限の詳細は、「アプリケーション・ロールおよび権限について」を参照してください。

38.1 WebCenter Portal管理のポータル・ページについて

WebCenter Portal管理のポータル・ページ(図38-1)からWebCenter Portalのすべてのポータルの編集および管理(ポータルのエクスポートとインポートを含む)にアクセスできます。

適切な権限が付与されていれば、ユーザーはこのページを使用してポータルを編集したり、管理できます。ただし、この章はすべてのポータルで管理アクションを実行できるシステム管理者を対象にしています。作成する個別のポータルや管理権限を持つそれぞれのポータルの管理の詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルの管理に関する項を参照してください。

図38-1 WebCenter Portal管理 - 「ポータル」ページ

38.2 WebCenter Portal管理のポータル・ページへのアクセス

WebCenter Portal内のすべてのポータルを管理する手順は次のとおりです。

1. 次のいずれかの方法で、WebCenter Portal管理の「ポータル」ページを開きます。

- 「ポータル」メニューから「管理」を選択して「ポータル」をクリックします。

- ポータル・ブラウザで、「管理」タイル(図38-2)をクリックして、「ポータル」をクリックします。

図38-2 WebCenter Portalの「管理」のアクセス

- ブラウザで次のURLを入力し、「ポータル」ページに直接移動します。

http://host:port/webcenter/portal/admin/portals

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

「ポータル」ページが表示されます(図38-3)。

図38-3 WebCenter Portal管理 - 「ポータル」ページ

2. 「ポータル」管理ページで、左側のペインから次のいずれかを選択します。

- すべてのポータル: パブリックとプライベートの両方で使用できるすべてのポータルを表示します。

注意:
システム管理者などのように、Portal Server: Manage ConfigurationまたはPortals: Manage Security and Configuration権限を持つユーザーは、このページで非表示のポータルを表示できます。これらのユーザーはポータルを管理(設定およびメンバーシップの変更)できますが、自分がポータル・メンバーでない場合、ポータル・ページとコンテンツを表示できません。

- 管理対象: ポータル・マネージャ権限を持っているポータルを表示します。

- 参加済: メンバーとして所属するポータルを表示します。

- パブリック: ポータルURLを使用してすべてのユーザーがアクセスできるポータルを表示します。

- 検出可能: 検索結果で検出できるポータルを表示します。

38.3 ポータル・リストのソート

「ポータル」ページにあるポータルのリストをソートする手順は次のとおりです。

1. 「ポータル」管理ページ(「WebCenter Portal管理のポータル・ページへのアクセス」を参照)で、「ソート基準」選択リスト(図38-4)をクリックします。

注意:

「すべてのポータル」が左の選択ペインで選択されている場合、「表示名」および「最終アクセス」以外ではソートできません。

図38-4 ポータル・リストのソート

2. ページのポータルの表示順序を、次のいずれかから選択します。

- 作成日: 最近作成されたものから過去にさかのぼって表示されます。

- 表示名: ポータル管理の「タイトル」値で指定されたように、外部表示名によりアルファベット順に表示されます。

- 最終アクセス: 最近表示されたものから過去にさかのぼって、更新されたかどうかに関係なく表示されます。

- 最終更新: 最近更新されたものから過去にさかのぼって表示されます。

- メンバー数: ポータルのメンバーが最大から最小の順に表示されます。

- ポータル名: ポータル管理の「名前」値で指定されたように、ポータルの内部名がアルファベット順に表示されます。内部名は「ポータル」ページには表示されません。

38.4 ポータルの作成

新規ポータルを作成する手順は次のとおりです。

1. 「ポータル」管理ページ(「WebCenter Portal管理のポータル・ページへのアクセス」を参照)で、左側のペインの「ポータルの作成」(図38-5)をクリックします。

図38-5 新規ポータルの作成

「ポータル・テンプレートの選択」ページが表示されます。

ポータルの作成の詳細は、『Oracle WebCenter Portalでのポータルの構築』の新規ポータルの作成と構築に関する項を参照してください。

38.5 ポータルのエクスポートおよびインポート

Portals: Manage Security and Configuration権限により、ポータルをエクスポートおよびインポートできます。詳細は、次を参照してください。

- WebCenter Portal管理を使用したオンライン・ポータルのアーカイブへのエクスポート

- WebCenter Portal管理を使用したポータルのアーカイブからのインポート

「個別のポータルとポータル・テンプレートのインポートおよびエクスポートのトラブルシューティング」も参照してください。

38.6 任意のポータルに関する情報の表示

「ポータル」管理ページで、ポータルのアクティブ、オンライン、オフラインの状況、ポータルへの最近のアクセス状況、メンバー数がすぐにわかります。

ポータルに関する情報を表示する手順は次のとおりです。

1. 「ポータル」管理ページ(「WebCenter Portal管理のポータル・ページへのアクセス」を参照)で、表内の行を強調表示してポータルを選択します。

2. 「アクション」メニューから、「ポータルについて」を選択します(図38-6)。

図38-6 ポータルに関する情報の表示

3. 「ポータルについて」ダイアログで、次の情報を参照します(図38-7)。

図38-7 「ポータルについて」ダイアログ

- 名前: ポータルURLに表示されるポータルの内部名。

- 表示名: ポータルの表示名。この名前は、このポータルの上部に表示されるとともに、各種ポータルを選択できるその他の場所(「ポータル」ページなど)に表示されます。

- 内部ID: 他のアプリケーションがこのポータルを参照する際に使用する、ポータルのID。

- 説明: ポータルの作成時やポータル管理の設定の際に指定されるポータルの説明。

- 作成者: ポータル作成者であるユーザーの名前。

- 作成日: ポータルが作成された日付と時間。

- ダイレクトURL: ポータルへ直接アクセスできるURL。

38.7 ポータルへのリンクの共有

他のユーザーとポータルを共有する場合は、他のユーザーのアクティビティ・ストリームに表示されるポータルにリンクを公開します。適切な権限を持つユーザーは、ポータルの表示名を指定するリンクをクリックして、ポータルに直接アクセスできます。

ポータルへの直接リンクを公開する手順は次のとおりです。

1. 「ポータル」管理ページ(「WebCenter Portal管理のポータル・ページへのアクセス」を参照)で、表内の行を強調表示して必要なポータルを選択します。

2. 「アクション」メニューから、「リンクの共有」を選択します(図38-8)。

図38-8 ポータルへのリンクの共有

3. 「共有」ダイアログ(図38-9)では、オプションで、リンクとともに表示されるコメントを入力します。

図38-9 ポータルの「共有」ダイアログ

4. 「共有対象」リストで、リンクを共有する対象を選択します。

- 全員: 現在のポータルのすべてのメンバーとアクティビティ・ストリームでリンクを共有します。これは、メンバーにポータルの更新を通知する際に便利です。

- ポータル: 「ポータルの選択」ダイアログを開き、選択したポータルのすべてのメンバーのアクティビティ・ストリームでリンクを共有するポータルを選択できます。これは、自分のポータルに関心を持つ可能性がある他のポータルのメンバーと情報を共有する場合に便利です。

5. 「公開」をクリックします。

38.8 任意のポータルのクローズ

ポータルは、デフォルトでアクティブです。アクティブに使用されなくなったポータルをクローズできます。ポータルをクローズすると、そのコンテンツはアーカイブされます。ポータルをクローズすると、そのポータルはすべてのユーザーの「ポータル」メニューから削除され、ユーザーが「表示」リストから「クローズ」を選択する場合にのみホーム・ポータルの「ポータル」ページに表示されます。クローズしたポータルのコンテンツは、クローズ後もアクセスしたり検索して参照できます。ポータル・メンバーがそのポータルで引き続き作業するには、クローズしたポータルを表示するか、プリティURL (http://host:port/webcenter/portal/portalName)でアクセスします。

ポータルをクローズすると、そのポータル内で実行されるすべてのアクティビティがホーム・ポータルの「アクティビティ・ストリーム」に反映されなくなります。クローズしたポータルのホームページでのみポータルのアクティビティが表示されるようになります。

ポータルを一時的にクローズする場合は、ポータルをオフラインにします。「任意のポータルのオフライン化」を参照してください。

ポータルをクローズする手順は次のとおりです。

1. 「ポータル」管理ページ(「WebCenter Portal管理のポータル・ページへのアクセス」を参照)で、表内の行を強調表示して必要なポータルを選択します。

複数のポータルを選択するには、[Ctrl]を押しながらクリックします。

2. 「アクション」メニューから、「閉じる」を選択します(図38-10)。

図38-10 ポータルのクローズ

3. 「OK」をクリックして、アクションを確定します。

ステータスが「アクティブ」から「クローズ済」に変更される点に注意してください(図38-11を参照)。

図38-11 「クローズ済」のポータル・ステータス

38.9 任意のポータルの再アクティブ化

ポータルを使用しなくなった場合、クローズできます(「任意のポータルのクローズ」)。ポータルを再度開く場合には、再アクティブ化できます。

ポータルを再アクティブ化する手順は次のとおりです。

1. 「ポータル」管理ページ(「WebCenter Portal管理のポータル・ページへのアクセス」を参照)で、表内の行を強調表示して必要なポータルを選択します。

複数のポータルを選択するには、[Ctrl]を押しながらクリックします。

2. 「アクション」メニューから、「アクティブ化」を選択します(図38-12)。

図38-12 ポータルのアクティブ化

3. 「OK」をクリックして、アクションを確定します。

ステータスが「クローズ済」から「アクティブ」に変更されている点に注意してください。

38.10 任意のポータルのオフライン化

ポータルは、デフォルトでオンラインです。メンテナンスのためにポータルを一時的にオフラインにできます。たとえば、不適切なコンテンツに気付いた場合、ポータルをオフライン化してそのコンテンツを変更し、再びオンラインに戻すことができます。Portals: Manage Security and Configuration権限により、オフラインのポータルにアクセスでき、再びオンラインにすることもできます。この権限がない場合は、ユーザーには「ポータルが使用できません」ページが表示されます(「システム・ページのカスタマイズ」を参照)。

再び使用しないポータルの永続的なクローズは、「任意のポータルのクローズ」を参照してください。

ポータルをオフラインにする手順は次のとおりです。

1. 「ポータル」管理ページ(「WebCenter Portal管理のポータル・ページへのアクセス」を参照)で、表内の行を強調表示して必要なポータルを選択します。

複数のポータルを選択するには、[Ctrl]を押しながらクリックします。

2. 「アクション」メニューから、「オフラインに設定」を選択します(図38-13)。

図38-13 ポータルのオフライン化

3. 「OK」をクリックして、アクションを確定します。

ステータスが「オンライン」から「オフライン」に変更される点に注意してください(図38-14参照)。

図38-14 「オフライン」のポータル・ステータス

38.11 任意のポータルの再オンライン化

任意のポータルを再オンライン化する手順は次のとおりです。

1. 「ポータル」管理ページ(「WebCenter Portal管理のポータル・ページへのアクセス」を参照)で、表内の行を強調表示して必要なポータルを選択します。

複数のポータルを選択するには、[Ctrl]を押しながらクリックします。

2. 「アクション」メニューから、「オンラインに設定」を選択します(図38-15)。

図38-15 ポータルのオンライン化

3. 「OK」をクリックして、アクションを確定します。

ステータスが「オフライン」から「オンライン」に変更されている点に注意してください。

38.12 ポータルの削除

ポータルがある期間の間クローズされていたり非アクティブになっていた場合、WebCenter Portalから永続的に削除することも可能です。ポータルの削除は永続的です。削除後に復元することはできません。

ポータルを削除した場合:

- そのポータルに関連付けられたすべてのページが削除されます。

- そのポータルに関連付けられたリンク、リスト、注意、タグおよびイベントが削除されます。

- ポータルのロールおよびメンバーシップが削除されます。

- ディスカッションおよびお知らせにより管理されたコンテンツは、デフォルトのフォーラムやポータルで作成されたカテゴリに保存されている場合でも削除されます。デフォルト以外のフォーラムやカテゴリで管理されたコンテンツは削除されません(詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルのディスカッション・フォーラムの設定の変更に関する項を参照)。

- Oracle WebCenter Portalにより自動的に作成されたポータルのメール配信リストが削除されます。ただし、ポータル・マネージャがカスタマイズした配信リストは削除されません(詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルのメール配信リストの構成に関する項を参照)。

- コンテンツ・リポジトリ、メールなど外部サービスにより管理されるコンテンツが削除されます。

ポータル・マネージャがポータルの設定を編集中のときにポータルを削除することはできませんが、それ以外には制限はありません。

ポータルを削除する手順は次のとおりです。

1. 「ポータル」管理ページ(「WebCenter Portal管理のポータル・ページへのアクセス」を参照)で、表内の行を強調表示して削除するポータルを選択します。

複数のポータルを選択するには、[Ctrl]を押しながらクリックします。

2. 「アクション」メニューから、「削除」を選択します(図38-16)。

図38-16 ポータルの削除

3. 「削除」をクリックしてポータルの削除を確定します。

なんらかの理由で削除のプロセスが失敗した場合、ポータルは「ポータル」ページから削除されません。この現象は、バックエンド・サーバーに接続できない場合に発生することがあります。「削除」を再度クリックすれば、ポータルは削除されます。

39 ポータル間のグローバルなデフォルト設定の構成

この章では、WebCenter Portal管理の一般ページ(図39-1)で使用できるタスクについて説明します。システム管理者はデフォルト設定を変更して、組織の要件に合わせることが可能です。

この章の内容は次のとおりです。

- ホーム・ポータルでの名前とロゴのカスタマイズ

- デフォルト・ページ・テンプレートの選択

- デフォルト・スキンの選択

- デフォルト・リソース・カタログの選択

- 著作権およびプライバシ情報のカスタマイズ

- オンライン・ヘルプ・リンクのカスタマイズ

- デフォルトの表示言語の選択

- デフォルト開始ページ(またはランディング・ページ)の選択

- セッション・タイムアウト設定の指定

- 自己登録の有効化

- 新しいページのデフォルトのルック・アンド・フィールの選択

- ホーム・ポータルへのアクセスの有効化と無効化

- WebCenter Portalツールとサービスのデフォルトの設定

権限

この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server: Manage All

- Portal Server: Manage Configuration

図39-1 WebCenter Portal管理: 「一般」ページ

39.1 ホーム・ポータルでの名前とロゴのカスタマイズ

初期状態では、Oracleロゴとアプリケーション名のWebCenter Portalが、ホーム・ポータル・ページのバナーに表示されます(図39-2)。ホーム・ポータル・ページのロゴと名前は、両方ともターゲット・ユーザーにより相応しいものに変更できます。たとえば、ここに会社名や会社の部署名を表示できます。

注意:
WebCenter Portal管理の「一般」ページでアプリケーション名とアプリケーション・ロゴに加えた変更は、ホーム・ポータルのページにのみ影響を及ぼします。WebCenter Portalの他の管理ページへの影響はありません。

ポータルの各ページのロゴを変更するには、『Oracle WebCenter Portalでのポータルの構築』のポータル・アイコンの変更に関する項とポータル・ロゴの変更に関する項を参照してください。

指定するロゴは、アプリケーションのページ・テンプレートに応じてサイズを変更します。ロゴのサイズを調整するには、ページ・テンプレートを変更します。『Oracle WebCenter Portalでのポータルの構築』のページ・テンプレートの編集に関する項を参照してください。

図39-2 ホーム・ポータルのWebCenter Portalの名前とロゴ

ホーム・ポータルの名前またはロゴを変更する手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「アプリケーション名」フィールドに、新しい名前を入力します(図39-3)。

図39-3 アプリケーションの名前とロゴのカスタマイズ

3. ロゴを変更するには、「アプリケーション・ロゴ」フィールドの隣にある「参照」をクリックします。

4. 「ファイルのアップロード」ダイアログで、使用するロゴに移動します。

ロゴのイメージ・ファイルは、最大150 KBに指定できます。サポートされているファイル形式は、.gifまたは.GIF、.pngまたは.PNGおよび.jpgまたは.JPGです。ファイルがアップロードされない場合には、アップロードしているファイルのサイズを確認します。

ロゴがWebCenter Portalのイメージ・ディレクトリ(/webcenter/images)にアップロードされます。

5. 「保存」をクリックします。
変更を確認するには、ホーム・ポータルに移動し、ただちに新しいロゴがバナー領域の左上隅に表示されます。

39.2 デフォルト・ページ・テンプレートの選択

WebCenter Portalでは、ページ・テンプレートによって、ユーザーの画面に個々のページとページ・グループを表示する方法を定義します。どのページも、ページ・テンプレート内に表示されます。システム管理者がページを表示するために使用するデフォルト・ページ・テンプレートを定義できる場所は、次のとおりです。

- ホーム・ポータル

- 新規ポータル(ポータルのテンプレートが特定のページ・テンプレートの使用を指定していない場合)

ポータル・マネージャは自分のポータル内でデフォルトの選択をオーバーライドできますが、ユーザーはホーム・ポータルに適用されたページ・テンプレートをオーバーライドできません。

デバイス・グループのデフォルト・ページ・テンプレートは、WebCenter Portal管理の「デバイス設定」からもオーバーライドできるようになりました。「デバイスの編集」の説明に従って、適切なデバイス・グループを編集します。選択したグループのデバイスで使用するデフォルト・ページ・テンプレートは、「アセット」セクションから選択します。

各ページ・テンプレートはスキンと連携して、ポータル内のページ全体のルック・アンド・フィールを決定します。ページ・テンプレートはページ上のコンポーネントの場所と動作を制御し、スキンは、色、フォントなどの様々な側面でコンポーネントの視覚的な外観を制御します。

関連項目:

スキンの詳細は、『Oracle WebCenter Portalでのポータルの構築』のスキンでの作業に関する項を参照してください。

各ページ・テンプレートでは優先スキンを定義して、そのページ・テンプレートに対して最適に連携するスキンを特定できます。そのページ・テンプレートをポータルのデフォルト・ページ・テンプレートとして選択したり、システムのデフォルトとして選択すると、デフォルトのスキンは自動的にそのページ・テンプレートの優先スキンに更新されます。

関連項目:

詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・テンプレートの優先スキンの設定に関する項を参照してください。

『Oracle WebCenter Portalでのポータルの構築』のページ・テンプレートの使用に関する項も参照してください。

WebCenter Portalのデフォルト・ページ・テンプレートを選択する手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 次のいずれかを行います。

- 使用可能なリストから「デフォルト・ページ・テンプレート」を選択します(図39-4)。

注意:

[system default]では、webcenter-config. xmlにハードコードされているWebCenter Portal用に定義されているデフォルト・ページ・テンプレートを指定します。

このリストにページ・テンプレートを追加する方法の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・テンプレートの公開と非表示に関する項を参照してください。

図39-4 「デフォルト・ページ・テンプレート」の選択

- 「拡張編集オプション」アイコンをクリックして「式ビルダー」を選択し、特定の基準に基づいて動的にデフォルト・ページ・テンプレートを決定するEL式を入力します。ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の式言語式に関する項を参照してください。
たとえば、ログイン・ユーザーが所属する部署や組織に応じて、デフォルト・ページ・テンプレートを変更することもできます。

3. 「保存」をクリックします。

39.3 デフォルト・スキンの選択

システム管理者は、デフォルト・スキンを変更して、すべてのユーザーに対するWebCenter Portalのデフォルトの外観をカスタマイズすることもできます。スキンによって、ユーザー・インタフェースの表示が変更されますが、アプリケーションの動作は変更されません。「WebCenter Portalのスキンの適用」を参照してください。

ユーザーは、ユーザー・プリファレンスを使用してデフォルト・スキンの選択をオーバーライドできます。ただし、特定のページ・テンプレートで使用するスキンは、多くの場合、作成されます。そのため、スキンの選択は選択したページ・テンプレートと互換性があることが必要です。詳細は、『Oracle WebCenter Portalの使用』のビューのルック・アンド・フィールの変更に関する項を参照してください。

すべての組込みスキンが要件に合わない場合や、企業ブランドを反映するルック・アンド・フィールを適用する場合には、独自のADFスキンを作成して適用できます。独自のページ・テンプレートの場合、優先スキンを示すには、カスタム属性であるpreferredSkinを指定されたページ・テンプレートで優先的に使用されるスキンのスキン・ファミリIDの値に設定します(「共有アセット」を選択して「ページ・テンプレート」をコピーし、「アクション」ドロップダウン・リストから「プロパティの編集」を選択します)。こうすることにより、作成したページ・テンプレートが選択されたときにスキンを優先スキンに切り替えることができます。そのページ・テンプレートが変更された場合、スキンはそのページ・テンプレートに一致するように更新されます(式に設定されていなくても)。詳細は、『Oracle WebCenter Portalでのポータルの構築』のスキンの作成に関する項を参照してください。

デバイス・グループのデフォルト・スキンは、WebCenter Portal管理の「デバイス設定」からもオーバーライドできるようになりました。適切なデバイス・グループを選択し、「アクション」ドロップダウン・リストから「編集」を選択します。選択したグループのデバイスで使用するには、「アセット」セクションからデフォルト・スキンを選択します。

必要に応じて、EL式のデフォルト・スキンを参照できます。ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の式言語式に関する項を参照してください。

個々のユーザーがシステム管理者により指定されたデフォルト・スキンを使用しない場合、ユーザーがユーザー・プリファレンスによりスキンを変更してホーム・ポータル・ビューに適用できます。『Oracle WebCenter Portalでのポータルの構築』のポータルのデフォルト・スキンの設定に関する項を参照してください。

39.3.1 WebCenter Portalのスキンの適用

WebCenter Portalのスキンを設定すると、そのスキンはホーム・ポータル、およびアプリケーションレベルのスキン設定を使用するすべてのポータルに適用されます。そのスキンは作成されたすべての新規ポータルにも適用されます。

スキンをWebCenter Portalに適用する手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 次のいずれかを行います。

- 使用可能リストからアプリケーション・スキンを選択します(図39-5)。

注意:

「アプリケーション・スキン」リストに目的のスキンが表示されない場合、その「選択可能」オプションが選択解除されているためである可能性があります。詳細は、『Oracle WebCenter Portalでのポータルの構築』のスキンの管理に関する項を参照してください。

各ページ・テンプレートでは優先スキンを定義して、そのページ・テンプレートに対して最適に連携するスキンを特定できます。ページ・テンプレートがポータルの新規デフォルト・ページ・テンプレートまたはシステムのデフォルトとして選択されると、そのデフォルト・スキンが自動的にそのページ・テンプレートの優先スキンに更新されます。

関連項目:

詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・テンプレートの優先スキンの設定に関する項を参照してください。

警告:

デフォルト・スキンを、選択されたデフォルトのページ・テンプレートの優先スキン以外に変更すると、予期しない結果になることがあります。

図39-5 スキンのWebCenter Portalへの適用

- 「拡張編集オプション」アイコンをクリックして「式ビルダー」を選択し、特定の基準に基づいて動的にデフォルト・アプリケーション・スキンを決定するEL式を入力します。
たとえば、ログイン・ユーザーが所属する部署や組織に応じて、デフォルト・スキンを変更することもできます。

3. 「保存」をクリックします。

選択するスキンがWebCenter Portal、作成したすべての新規ポータル、およびアプリケーションレベルのスキン設定を使用するすべてのポータルに適用されます。そのスキンは、アプリケーションレベルのスキン設定がオーバーライドされたポータルには適用されません。

39.4 デフォルト・リソース・カタログの選択

WebCenter Portalでは、ページ、ページ・テンプレート、ページ・スタイルまたはタスク・フロー・アセットを編集する際に「コンテンツの追加」をクリックすると、リソース・カタログが表示されます。リソース・カタログには一連のフォルダおよびサブフォルダの使用可能なリソースが示されます。そのコンテンツは、現在使用可能なサービスおよび現在のユーザーの権限に応じて動的に変わります。使用可能なリソースには、タスク・フロー、ポートレット、およびイメージ、テキスト、ハイパーリンクなどのページ・コンポーネントが含まれます。WebCenter Portalでは複数の組込みデフォルト・リソース・カタログが用意されていますが、新規タスク・フローの追加、タスク・フローの削除、フォルダ階層の再編成を実行して、ユーザーにより適するものにしたり、新しいカスタム・リソース・カタログを最初から作成することができます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のリソース・カタログでの作業に関する項を参照してください。

システム管理者がページ、ページ・テンプレート、ページ・スタイルおよびタスク・フロー・アセットに使用するデフォルト・リソース・カタログを指定できる場所は、次のとおりです。

- 新規ポータル

- ホーム・ポータル

- ビジネス・ロール・ページ

- ポータル内のページ・テンプレート

- ホーム・ポータルのページ・テンプレート

デフォルト・リソース・カタログを選択する手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「アセット」セクションで、図39-6に示されているリストからデフォルト・リソース・カタログを選択します。

これらのリストに既存のリソース・カタログを公開する方法の詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル・アセットの表示と非表示に関する項を参照してください。

図39-6 リソース・カタログの選択

3. オプションで、「拡張編集オプション」アイコンをクリックして「式ビルダー」を選択し、特定の基準に基づいて動的にデフォルト・リソース・カタログを決定するEL式を入力します。たとえば、ログイン・ユーザーが属するロールに応じて、デフォルト・リソース・カタログを変更することもできます。ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の式言語式に関する項を参照してください。

4. 「保存」をクリックします。

39.5 コピーライトとプライバシ宣言文のカスタマイズ

システム管理者は、WebCenter Portalのコピーライトとプライバシ宣言文をカスタマイズまたは非表示にすることができます。

- コピーライト: アプリケーション全体のコピーライト宣言文を表示します。

- プライバシURL: アプリケーション全体のプライバシ・ポリシーが含まれるドキュメントにリンクします。

デフォルト・ページ・テンプレートでは、コピーライトとプライバシURLはWebCenter Portalのページ・フッターに表示されます(図39-7)。

オプションで、コピーライト・メッセージとプライバシ・ドキュメントをEL式で参照できます。ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の式言語式に関する項を参照してください。

図39-7 ページ・フッターのコピーライトとプライバシ宣言文へのリンク

個々のポータルには独自のコピーライトとプライバシ宣言文を記載できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のコピーライト宣言文とプライバシURLのカスタマイズに関する項を参照してください。

コピーライトとプライバシ宣言文をカスタマイズしたり非表示にするには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「オプション」セクションで、「ページ・フッターの表示」を選択または選択解除し、それぞれページ・フッターのコピーライトとプライバシの情報を表示または非表示にします(図39-8)。

図39-8 コピーライトとプライバシURLのカスタマイズ

必要に応じて法律上の注意点とプライバシURLを変更します。

- コピーライト: WebCenter Portalに対する適切なコピーライト宣言文を入力します。コピーライト情報が不要な場合には、このフィールドは空白のままにします。

- プライバシURL: アプリケーションのプライバシ・ポリシーの場所を指定します。完全修飾URLを入力します。プライバシ情報が不要な場合には、このフィールドは空白のままにします。

3. 「保存」をクリックします。

39.6 オンライン・ヘルプ・リンクのカスタマイズ

WebCenter Portalのオンライン・ヘルプおよびその他の役立つリソースに、「ヘルプ」リンクからアクセスできます(図39-9)。

図39-9 WebCenter Portalの「ヘルプ」リンク

初期状態では、この「ヘルプ」リンクはOracleの組込みヘルプを開きます。『Oracle WebCenter Portalでのポータルの構築』のグローバル・ヘルプに関する項を参照してください。また、特に自分のユーザーを対象にオンライン・ヘルプを記述して、別のヘルプの場所に「ヘルプ」リンクをリダイレクトすることも可能です。

オプションで、「ヘルプ」の場所をEL式で参照できます。ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の式言語式に関する項を参照してください。

「ヘルプ」リンクをカスタマイズすると、ヘルプ・ボタン、ヘルプ・アイコンなどによりWebCenter Portalの組込みヘルプが引き続き使用できます。

メイン・ヘルプ・リンクをカスタマイズするには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「オプション」セクションで、「グローバル・ヘルプURL」フィールドにヘルプの場所を入力します(図39-10)。

図39-10 WebCenter Portalオンライン・ヘルプの「グローバル・ヘルプURL」

完全修飾URLを次の形式で入力します。

http://host:port/helplocation

例:

http://myhost:8888/myhelp

デフォルト・グローバル・ヘルプURLは、/webcenterhelp/spaces?topic=welcome_rrです。このURLはOracle Help for the Web (OHW)を開き、WebCenter Portalに対するOracleの組込みヘルプを表示します。デフォルト設定に戻す場合には、このURLを入力します。

注意:

「グローバル・ヘルプURL」フィールドを空白のままにすると、「ヘルプ」リンクは表示されません。

3. 「保存」をクリックします。

カスタム・ヘルプが適切に開いているかどうかを確認するには、WebCenter Portalの「ヘルプ」をクリックします。

39.7 デフォルト表示言語の選択

初期設定で、WebCenter Portalでは、27の言語と100の異なるロケールがサポートされています。WebCenter Portalのシステム管理者が、デフォルトの表示言語を選択する必要があります。デフォルト言語を選択する際は、アプリケーションを使用する人々の大多数に適した言語は何かを考慮します。デフォルト言語を選択する際は、アプリケーションを使用する人々の大多数に適した言語は何かを考慮します。たとえば、ログインしたユーザーの部署や組織に応じて、デフォルトの表示言語を変更することもできます。ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の式言語式に関する項を参照してください。

ユーザーがWebCenter Portalに初めてログインしたときにデフォルト言語が表示されますが、各ユーザーはユーザー・プリファレンスを介して表示言語をパーソナライズできます。『Oracle WebCenter Portalでのポータルの構築』のポータルの表示言語の設定に関する項を参照してください。

デフォルト表示言語は、ユーザーがWebCenter Portalにログインする際にのみ適用されます。ようこそページ、ログイン・ページなどのパブリック・ページはブラウザの言語で表示されます。デフォルト言語が指定されていない場合、ブラウザの言語が使用されます。『Oracle WebCenter Portalでのポータルの構築』の表示言語の優先順位に関する項も参照してください。

注意:

ポータル・マネージャは、特定のポータルの表示言語を指定できます。定義の際に、このポータル言語はデフォルトの言語および任意の言語のユーザー・プリファレンスの両方をオーバーライドします。『Oracle WebCenter Portalでのポータルの構築』のポータルの表示言語の設定に関する項も参照してください。

WebCenter Portalのデフォルト表示言語を選択する手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 次のいずれかを行います。

- 使用可能リストから「デフォルト言語」を選択します(図39-11)。
必要な言語がドロップダウン・リストにない場合、「カスタマイズ」をクリックして必要な言語のチェック・ボックスを選択し、「保存」をクリックします。「言語リストのカスタマイズ」を参照してください。

図39-11 デフォルト言語の選択

完全に新しい言語を追加するには、ローカライズ・チームがWebCenter Portalリソース・バンドルをその新しい言語に翻訳し、その翻訳をWebCenter Portalがデプロイされている管理対象サーバーにデプロイする必要があります。詳細は、「WebCenter Portalへの新規言語のサポートの追加」を参照してください。

- 「拡張編集オプション」アイコンをクリックして「式ビルダー」を選択し、特定の基準に基づいて動的にデフォルト言語を決定するEL式を入力します。ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の式言語式に関する項を参照してください。

3. 「保存」をクリックします。

ここでの選択に対して使用可能な表示言語は、ユーザー・プリファレンスによりユーザーおよびポータル・マネージャにも提供されます。システム管理者は、ユーザーが使用できる言語の範囲を縮小できます。詳細は、「言語リストのカスタマイズ」を参照してください。

39.7.1 言語リストのカスタマイズ

初期設定では、WebCenter Portalには27の言語と100の異なるロケールが用意されており、これらの言語はすべてデフォルトで使用可能になっています。システム管理者は、ユーザーに合うように言語を調整できます。たとえば、非常に簡略化した言語リストが必要な場合には地域言語バリアントをすべて削除できます。または、特にヨーロッパのユーザーを対象にしたポータルの場合、ヨーロッパの言語のみを提供できます。

ユーザーが使用できる言語をカスタマイズするには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「デフォルト言語」の横の「カスタマイズ」をクリックします(図39-12)。

図39-12 デフォルト言語のオプションのカスタマイズ

3. 各言語チェック・ボックスの選択(または選択解除)により提供する言語を選択します(図39-13)。

図39-13 使用可能な言語の選択

4. 「保存」をクリックします。

39.8 デフォルト開始ページ(またはランディング・ページ)の選択

デフォルトでは、ユーザーがログインするとポータル・ブラウザが表示されますが、初期ランディング・ページは、ホーム・ポータル、特定のポータルまたは特定のページに変更できます。特定のグループ、認証されたユーザー、およびパブリック・ユーザーに対する開始ページを指定できます。

システム管理者は、表39-1に示されているように、WebCenter Portalのランディング・ページを構成できます。

表39-1 WebCenter Portalのランディング・ページの動作

ランディング・ページのURL

認証済ユーザーまたはグループ

パブリック・ユーザー

/webcenterまたは/webcenter/portal

構成および認証されたランディング・ページが表示されます

認証されていないランディング・ページが表示されます

/webcenter/portal/<portal_name>/<page_name>

- リソースがパブリックであるか、ユーザーがリソースにアクセスできる場合は、リソース・ページが表示されます

- リソースが存在しないか、ユーザーにアクセス権がない場合は、「ページが見つかりません」エラーが表示されます

リソースがパブリックでないか存在しない場合、ログイン・ページが表示されます

WebCenter Portalのランディング・ページを選択する手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「デフォルト・ポータル」セクションで、ユーザーがログインしたときに何が最初に表示されるようにするかを選択します(図39-14)。

図39-14 デフォルト開始ページの選択

- 選択したグループに対するデフォルト・ランディング・ページを指定するには、「グループに対するデフォルト開始ページの選択」を参照してください。

- 指定したどのグループにも属さないその他のすべての認証済ユーザーに対するデフォルト・ランディング・ページを指定するには、「認証済ユーザーに対するデフォルト開始ページの選択」を参照してください。

- すべてのパブリック・ユーザーに対するデフォルト・ランディング・ページを指定するには、「パブリック・ユーザーに対するデフォルト開始ページの選択」を参照してください。

3. 「保存」をクリックします。

39.8.1 グループに対するデフォルト開始ページの選択

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「デフォルト・ポータル」セクションで、選択済企業グループに特定の開始ページを表示する場合、「グループの追加」をクリックします。

注意:

デフォルト・ポータルが非表示またはプライベートの場合、そのポータルをグループ・メンバーに表示するには、そのグループ自体がポータルのメンバーである必要があります。

3. 「グループの追加」ダイアログで、グループを検索するかリストからグループを選択し、「OK」をクリックします。

選択したグループが表に追加されます(図39-15)。

図39-15 グループのランディング・ページの指定

グループに属するすべてのユーザーは、WebCenter Portalにログインすると、デフォルト・ランディング・ページが表示されます。デフォルトでは、ランディング・ページはポータル・ブラウザに設定されることに注意してください。

4. ランディング・ページの「場所」を変更するには、グループ名を選択して「編集」をクリックします。

「編集」ダイアログが開きます(図39-16)。

図39-16 ランディング・ページのオプション

5. 目的のグループに最初に表示されるのが、ホーム・ポータルか、特定のポータルまたはページかを選択します。

注意:

指定されたページまたはポータルをすべてのユーザーが使用できることを確認します(『Oracle WebCenter Portalでのポータルの構築』のページ・セキュリティの設定に関する項を参照)。ユーザーに指定されたページまたはポータルのアクセス権限がない場合、「ページが見つかりません」

- ホーム・ポータルを開く。ユーザーが最初にログインしたときにホーム・ポータルが表示されるように指定する場合に選択します。

- 特定のポータルを開く。特定のポータルの表示を指定する際に選択し、ポータル名を入力するか「参照」をクリックしてポータルのリストから選択します。「ポータルの表示」リストからオプションを選択し、「OK」をクリックします。たとえば、次のようにします。

http://host:port/webcenter/portal/portalName

- 特定のページURLを開く。特定のページの表示を指定する際に選択し、そのページの場所を入力します。
通常、これは内部のページです。この例に示すように、完全修飾のページURLか相対ページURLを入力できます。

http://mywebcenter.com:8888/webcenter/portal/page/landingpage

/portals/portalname/page/landingpage

外部ページを指定する場合には、必ず完全修飾URLを指定してください。

6. 「保存」をクリックします。

39.8.2 認証済ユーザーに対するデフォルト開始ページの選択

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「認証されたユーザー」セクションで、「グループに対するデフォルト開始ページの選択」で指定された、いずれのグループにも属さない、認証されたユーザーに対して、最初のログイン時に表示される画面を指定します(図39-17)。

図39-17 「認証されたユーザー」に対するランディング・ページの選択

- ポータル・ブラウザを開く。デフォルトで選択されます。ユーザーには、最初のログイン時にポータル・ブラウザが表示されます。

- ホーム・ポータルを開く。ユーザーが最初にログインしたときにホーム・ポータルが表示されるように指定する場合に選択します。

- 特定のポータルを開く。特定のポータルの表示を指定する際に選択し、次のようにポータル名を入力します。

http://host:port/webcenter/portal/portalName

または、「参照」をクリックして、ポータルのリストから選択します(図39-18)。「ポータルの追加」リストからオプションを選択して「OK」をクリックするか、「検索」フィールドにポータル名を入力して「検索」をクリックします。

図39-18 「ポータルの追加」ダイアログ

- 特定のページ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. 「保存」をクリックします。

39.8.3 パブリック・ユーザーに対するデフォルト開始ページの選択

WebCenter Portalにログインせずにアクセスするすべてのユーザーには、Public-Userロールが付与されます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルのロールと権限の管理に関する項を参照してください。

ポータルを、そのポータルが含まれるWebCenter Portalインスタンスにアクセスする任意のユーザーが使用できるようにできます。WebCenter Portalアカウントへの登録は不要です。提供されるパブリック情報により、ポータルをメンバー以外のユーザーやWebCenter Portalコミュニティ外のユーザーと共有できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルへのパブリック・アクセス権限の付与に関する項を参照してください。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「デフォルト・ログイン設定」セクションで、パブリック・ユーザーが最初にログインする際に表示される画面を指定します(図39-19)。

図39-19 「パブリック・ユーザー」に対するランディング・ページの選択

- ようこそページを開きます。デフォルトで選択されます。ユーザーには、最初のログイン時にWebCenter Portalのようこそページが表示されます。

- 特定のポータルを開く。特定のポータルの表示を指定する際に選択し、ポータル名を入力します。たとえば、次のようにします。

http://host:port/webcenter/portal/portalName

または、「参照」をクリックして、ポータルのリストから選択します(図39-18)。「ポータルの追加」リストからオプションを選択して「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. 「保存」をクリックします。

39.9 セッション・タイムアウト設定の指定

WebCenter Portalセッションで長時間アクティビティがないと、そのセッションはタイムアウトします。初期の設定では、WebCenter Portalのセッション・タイムアウトは20分に設定されています。共有ライブラリをデプロイするとき、/webcenterルート・コンテキストに追加のパスが追加される場合(/webcenter/images/など)があります。/webcenterルート・コンテキストに基づいたURLがWebCenter Portalによって処理されない場合、HTTPセッション・タイムアウトは24時間に設定されています。

セッションがタイムアウトとなるまでのデフォルトの経過時間(分)を変更して、セッションがタイムアウトとなる際にポップアップまたはウィンドウを表示するかどうかを選択できます。

注意:

セッション・タイムアウトの値は、「属性」ページに属性名wcSessionTimeoutPeriodで表示することも可能です。

WebCenter Portalのセッション・タイムアウトの設定を変更する手順:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「セッション・タイムアウト」セクションで、WebCenter Portalがタイムアウトとなった場合に必要な結果を選択します(図39-20)。

図39-20 「セッション・タイムアウト」オプション

- タイムアウト・ページの表示。WebCenter Portalタイムアウト・ページをブラウザで表示する場合に選択します(図39-21)。この場合、ユーザーは表示されたリンクをクリックして再度ログインし、デフォルト開始ページを再起動できます(「デフォルト開始ページ(またはランディング・ページ)の選択」も参照)。

図39-21 タイムアウト・ページ

- タイムアウトのポップアップ表示。「セッション・タイムアウト」値に達した場合、「期限切れ警告」通知のポップアップを表示する際に選択します(図39-22)。タイムアウトを回避するには、2分以内に「OK」をクリックします。「期限切れ警告」に2分以内に応答しないと、セッションはタイムアウトとなります。タイムアウト通知のポップアップで(図39-23)、「OK」をクリックして再度ログインし、セッションが期限切れになったときにアクティブだったページを再起動します。
ブラウザがポップアップを表示するように設定されている場合、「タイムアウトのポップアップ表示」オプションが機能します。ブラウザがポップアップをブロックするように設定されている場合、タイムアウト・ページが表示されます。

図39-22 「期限切れ警告」の通知(セッション・タイムアウトの際に表示)

図39-23 タイムアウトの通知(セッション・タイムアウトの2分後に表示)

3. (オプション)「セッション・タイムアウト(分)」フィールドに、新しい値を入力します。

デフォルト値は45分、最低値は5、最大値は1440 (24時間)です。このフィールドを空白のままにすると、デフォルト値(45)が適用されます。

注意:

WebCenter Portalがシングル・サインオン(SSO)用に構成されている場合、ここで設定するセッション・タイムアウト値は、SSOのタイムアウトより高い値にしないことをお薦めします。セッション・タイムアウトは使用可能な物理メモリーと、サポートする必要がある同時ユーザー数のファクタです。セッション・タイムアウト値がSSOのセッション・タイムアウト値より少ない場合、WebCenter HTTPセッションはここで指定された期間の後にタイムアウトとなりますが、SSOがタイムアウトに達していなければ新規WebCenterセッションが自動的に作成されます。

4. 「保存」をクリックします。

39.10 自己登録の有効化

システム管理者は、WebCenter Portalの自己登録を有効にすることができます。自己登録により、ユーザーは独自のログインとパスワードを作成できます。自己登録したユーザーはただちに自動的にWebCenter Portalへのアクセス権が付与され、新規ユーザー・アカウントがアイデンティティ・ストアで作成されます。

この項の内容は次のとおりです。

- 自己登録について

- すべてのユーザーの自己登録の有効化

- 招待者限定の自己登録の有効化

39.10.1 自己登録について

自己登録により、ユーザー独自のWebCenter Portalログインとパスワードの作成が可能になります。自己登録したユーザーはただちに自動的にWebCenter Portalへのアクセス権が付与され、新規ユーザー・アカウントがWebCenter Portalのアイデンティティ・ストアに作成されます。

パブリック・ユーザーの自己登録が許可されている場合、WebCenter Portalのサインイン・ページに「アカウントに登録」リンクが表示されます。この機能を有効化するには、「すべてのユーザーの自己登録の有効化」を参照してください。

招待による自己登録も使用可能です。ポータル・マネージャは、この機能により、現在WebCenter Portalに登録されていないが、ポータルに関心を持つ可能性のあるユーザーにメンバーシップ招待状を送信できます。ポータルにアクセスする前に、招待されたユーザーはWebCenter Portalにアカウントを作成する必要があり、そのアカウントの詳細がWebCenter Portalのアイデンティティ・ストアに追加されます。承認が必要な場合は、ポータルへのアクセス権を取得する前に、ポータル・マネージャがサブスクリプション・リクエストを承認する必要があります。ポータルがパブリックであるか、さらなる承認が必要でない場合、新規ユーザーはポータルにすぐにアクセスできます。「招待者限定の自己登録の有効化」を参照してください。

注意:

自己登録がWebCenter Portalのために有効化されていない場合、アイデンティティ・ストア管理はWLS管理コンソールを介して実行(またはLDAPコマンドを使用して、組込みLDAPアイデンティティ・ストアに直接実行)され、システム管理者がこれを担当します。「組込みLDAPアイデンティティ・ストアへのユーザーの追加」も参照してください。

自己登録ページは、WebCenter Portalで提供されています。Administratorロールを持つユーザーは、ページに新規コンポーネントを追加し、必要に応じてページ・レイアウトを変更できます。「システム・ページのカスタマイズ」を参照してください。

注意:

プリティURLを使用して自己登録ページにアクセスできますが、この方法でアクセスした場合、ページ上のフィールドはアクティブではありません。登録されていないユーザーがWebCenter Portalサインイン・ページの「登録」リンクをクリックしてページにアクセスした場合にのみ、フィールドがアクティブになります。

WebCenter Portalで提供されている自己登録ページは、すでに使用されている電子メール・アドレスで登録しようとしているユーザーに、ユーザー名リマインダ・メール・メッセージの送信を提案します(図39-24)。

図39-24 すでに登録済の電子メール・アドレス

この機能は、WebCenter Portalのメール・サービスの認証を提供している外部アプリケーションのためのパブリック資格証明が定義されている場合にのみ動作します。この機能で問題が発生する場合には、メール・サーバーの接続とそれに関連付けられた外部アプリケーションの接続が適切に構成されており、パブリック資格証明が定義されていることを確認します。「メール・サーバーの登録」も参照してください。

- Enterprise Managerを使用したパブリック資格証明の設定の詳細は、「外部アプリケーションの管理」の表20-6を参照してください。

- WLSTを使用したパブリック資格証明の設定の詳細は、『Oracle WebLogic Scripting Tool』のaddExtAppCredentialを参照してください。

39.10.2 すべてのユーザーの自己登録の有効化

パブリック・ユーザーの自己登録が許可されている場合、WebCenter Portalのサインイン・ページに「アカウントに登録」リンクが表示されます (図39-25)。

図39-25 サインイン・ページで使用可能な自己登録

新規ユーザーは、Oracle WebCenter Portalへのアクセス権を取得する前にアカウントを作成する必要があります。

自己登録するユーザーはWebCenter Portalのアイデンティティ・ストアに直接追加され、Authenticated-Userロールが割り当てられます。Authenticated-Userロールを持つユーザーは、デフォルトでホーム・ポータル、自分で作成したページおよびパブリック・ページにアクセスできます。また、パブリック・ポータルの表示、自己サブスクリプションが許可されている任意のポータルへの参加、独自のポータルの作成も許可されます。自己登録を有効にする場合、要件に完全に適合するようAuthenticated-User権限を変更することを検討してください。アプリケーション・ロール権限の変更を参照してください。

WebCenter Portalで任意のユーザーに自己登録を許可する手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「パブリック・ユーザーに自己登録を許可」を選択します(図39-26)。

このオプションを選択解除すると、パブリック・ユーザーはWebCenter Portalで自己登録できません。招待者限定ベースの自己登録を有効にする場合は、「招待者限定の自己登録の有効化」を参照してください。

図39-26 パブリック・ユーザーへの自己登録の許可

3. 「保存」をクリックします。

『Oracle WebCenter Portalの使用』のWebCenter Portalへの自己登録に関する項に記載されたとおり、現在はインターネットにアクセスできるすべてのユーザーが自己をWebCenter Portalアプリケーションのユーザーとして登録できます。WebCenter Portalに登録しようとしたときに、ユーザーに応答が返されない場合、ユーザーはブラウザを更新して再試行する必要があります。

39.10.3 招待者限定の自己登録の有効化

デフォルトでは、WebCenter Portalに登録されたユーザーのみがポータル・メンバーシップの候補になります。これが大半のWebCenter Portalユーザーの要件に適合する場合でも、一部のポータルではWebCenter Portalコミュニティ外のメンバーを採用する必要が生じます。

システム管理者は、招待者限定の自己登録を許可することにより、WebCenter Portal外のユーザーにポータル・メンバーシップを供与できます。このオプションが有効な場合、ポータル・マネージャは、カスタマイズされた招待状を電子メールで送信することにより、ポータルに参加するようにすべてのユーザーを招待できます。この招待状には、招待された参加者がポータル・メンバーシップを受け入れる際にクリックするセキュアな自己登録URLが含まれます。

この方法で募集された新メンバーは、ポータルにアクセスする前に、WebCenter Portalにアカウントを作成する必要があります。招待により自己登録するユーザーは、アイデンティティ・ストアおよびポータルのメンバー・リストに追加されます。

注意:

また、招待により自己登録するユーザーには、デフォルトのアプリケーション・ロール(Authenticated-User)も割り当てられます。Authenticated-Userロールを持つユーザーは、デフォルトでホーム・ポータル、自分で作成したページおよびパブリック・ページにアクセスできます。また、パブリック・ポータルの表示、自己サブスクリプションが許可されている任意のポータルへの参加、独自のポータルの作成も許可されます。自己登録を有効にする場合、要件に完全に適合するようにAuthenticated-User権限を変更することを検討してください。「アプリケーション・ロールの権限の変更」も参照してください。

招待を介してWebCenter Portalで任意のユーザーに自己登録を許可する手順は次のとおりです。

1. 「WebCenter Portalにおける招待による自己登録の構成」で説明しているように、前提条件の構成が設定されていることを確認してください。

2. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「一般」をクリックします。

ブラウザに次のURLを入力して直接「一般」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/general

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

3. 「招待を介した自己登録の許可」を選択します(図39-27)。

このオプションを選択解除すると、既存のユーザーのみがポータル・メンバーシップの候補となります。

図39-27 招待を介した自己登録の許可

4. 「保存」をクリックします。

このオプションを有効化すると、ポータル・マネージャは任意のユーザーを招待して自分のポータルのメンバーにすることができます。『Oracle WebCenter Portalでのポータルの構築』の未登録ユーザーの招待に関する項を参照してください。

39.11 新しいページのデフォルトのルック・アンド・フィールの選択

管理者は、初めてのユーザーに対するページ作成を簡素化したり、ユーザーを特定のページ・スキームおよびスタイルに誘導するために、システム、ビジネス・ロールおよび個人用ページに対して、デフォルトのルック・アンド・フィールを設定できます。

関連情報:

- システム・ページのカスタマイズ

- ビジネス・ロール・ページの管理

- 個人用ページの管理

ユーザーごとに、ホーム・ポータル・ビューでデフォルト設定をパーソナライズできます。詳細は、「個人用ページのためのアプリケーションレベルのページ作成のデフォルトの設定」を参照してください。

39.12 ホーム・ポータルへのアクセスの有効化と無効化

ホーム・ポータルへのアクセスはオプションであり、ユーザーが個人コンテンツを格納して個人タスクを実行するためのプライベートな作業領域を提供することは必須ではありません。ユーザーは、ホーム・ポータルにアクセスしなくても、共同プロジェクトに全面的に参加できます。

ホーム・ポータルへのアクセス権限がないユーザーは、個人の生産性向上ツールの使用(お気に入りなど)、個人用ページの作成、他のユーザーが共有する個人用ページの表示の操作を行うことができません。

Portal Server: View権限により、ユーザーがホーム・ポータルにアクセスできるかどうかを制御します。管理者は、WebCenter Portalを使用して、すべてのユーザーのアクセスまたは特定のユーザーのアクセスのみを無効化できます。異なるロールに対して必要な権限設定を決定するには、表39-2を使用します。

ホーム・ポータルへのアクセスを有効化または無効化する手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「セキュリティ」をクリックします。

あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/admin/settings/security

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「ロール」タブで、「ロール」リストからロールを選択して、必要に応じて「ポータル・サーバー」の下にあるロールの「表示」チェック・ボックス(図39-28を参照)を選択または選択解除します(表39-2を参照)。

図39-28 Portal Server: View権限

表39-2 Portal Server: View権限

ロール

Portal Server: Viewを選択

Portal Server: Viewを選択解除

Administrator

このロールを割り当てられたユーザーは常に、ホーム・ポータルにアクセスできます。

管理者の場合は該当なし。

Application Specialist

このロールを割り当てられたユーザーは常に、ホーム・ポータルにアクセスできます。

このロールを割り当てられたユーザーは、ホーム・ポータルにはアクセスできません。(認証されたユーザーおよびパブリック・ユーザーに対して、Portal Server: View権限が無効化されていると仮定します。)

Portal Creator User

このロールを割り当てられたユーザーは常に、ホーム・ポータルにアクセスできます。

このロールを割り当てられたユーザーは、ホーム・ポータルにはアクセスできません。(認証されたユーザーおよびパブリック・ユーザーに対して、Portal Server: View権限が無効化されていると仮定します。)

Public User

認証されていないユーザーは、個人用ページおよびパブリックとマークが付けられているコンテンツを表示できます。

認証されていないユーザーは、ログイン・ページのみを表示できます。

Authenticated User

すべてのユーザーが、ホーム・ポータルにアクセスできます。

ユーザーは、ホーム・ポータルへのアクセスを許可する別のロールを付与されないかぎり、ホーム・ポータルにはアクセスできません。

Any Custom Role

カスタム・ロールを割り当てられたユーザーは、ホーム・ポータルにアクセスできます。

カスタム・ロールを割り当てられたユーザーは、ホーム・ポータルにはアクセスできません。(認証されたユーザーおよびパブリック・ユーザーに対して、Portal Server: View権限が無効化されていると仮定します。)

3. 「保存」をクリックして変更を保存します。

新しい権限が即時に有効になります。

39.13 WebCenter Portalツールとサービスのデフォルトの設定

システム管理者は、WebCenter Portalのツールとサービスのオプションを設定することもできます。詳細は、「ツールおよびサービスの管理」を参照してください。

40 ポータル間のセキュリティの管理

この章では、WebCenter Portal管理の「セキュリティ」ページで使用できるタスクについて説明します。システム管理者は、デフォルト設定を変更して、カスタム・アプリケーション・ユーザー・ロールに適切な権限を割り当てたり、これらのアプリケーション・ロールにユーザーを割り当てたり、組織で必要な新しいカスタム・ロールを作成することができます。

この章の内容は次のとおりです。

- WebCenter Portalのセキュリティについて

- ユーザーについて

- アプリケーション・ロールおよび権限について

- ポータル内のロールおよび権限について

- ユーザーの管理

- アプリケーション・ロールと権限の管理

権限

この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server: Manage All

40.1 WebCenter Portalのセキュリティについて

WebCenter Portalは、ユーザーがWebCenter Portalで参照および変更できる内容を制御できるように、包括的なセキュリティ・モデルを提供しています。WebCenter Portal管理のセキュリティ・ページ(図40-1)を使用して、個々のポータルおよびホーム・ポータルにアクセスできるユーザー(およびグループ)を制御し、様々な権限を有効または無効にすることでユーザー(およびグループ)が参照および実行できる内容を正確に制御できます。

図40-1 WebCenter Portal管理: 「セキュリティ」ページ

特定のポータル内で、個々のページ、ページ・コンテンツ(タスク・フロー、ポートレット、ドキュメント、フォルダなど)、およびアセット(ページ・テンプレート、ページ・スタイル、スキン、リソース・カタログなど)へのユーザーおよびグループのアクセスを制限できます。

図40-2 WebCenter Portalのセキュリティ

ユーザーとグループ

ユーザーとはアイデンティティ・ストア内の1人の個人を意味し、グループには複数のユーザーが含まれます。WebCenter Portalでは、個々のユーザーおよびユーザー・グループに権限を付与できます。

未登録のユーザーおよび自己登録

自己登録により、まだ登録していないユーザーは独自のWebCenter Portalログインとパスワードを作成できます。自己登録したユーザーはただちに自動的にWebCenter Portalへのアクセス権が付与され、新規ユーザー・アカウントがWebCenter Portalのアイデンティティ・ストアに作成されます。

アプリケーション・ロールおよびポータル・ロール

アプリケーション・ロールによって、ホーム・ポータルでユーザーが参照および実行できる内容が決まり、一部の管理機能では、すべてのWebCenter Portalに作用する場合があります。ポータル・ロールは特定のポータル内のアクションを制御します。

ポータル

ポータルでは、関連のあるサービス、ページおよびコンテンツに対して専用の容易にアクセス可能な領域を提供したり、指定されたメンバーの加入をサポートすることにより、プロジェクト・チームや関心のあるコミュニティの形成とコラボレーションがサポートされます。

ホーム・ポータル

デフォルトでは、ホーム・ポータルは共有ポータルで、ログインしているすべてのユーザーがアクセスできます。ユーザーがホーム・ポータル内で作業している間は、アプリケーション・ロールが適用されます。大部分のアプリケーションでは、ホーム・ポータルは、ソーシャル・ネットワーキングと個人コンテンツに重点を置いています。

アセット

様々なポータル・リソースが、ポータル全体の構造、ルック・アンド・フィールおよびコンテンツの定義に役立ちます。そのようなリソースには、ページ・テンプレート、ページ・スタイル、スキン、リソース・カタログ、コンテンツ・プレゼンタ表示テンプレート、タスク・フロー・スタイル、データ・コントロールおよびタスク・フローがあります。ユーザーに適切な権限があれば、アプリケーション全体または個々のポータルのリソースを構築してカスタマイズできます。

ページ

ページを編集する権限のあるすべてのユーザーは、他のユーザーやグループにアクセス権などの権限を付与できます。たとえば、セールス・グループのすべてのユーザーに対する表示のみの権限の付与、セールス・マネージャに対する権限の編集、単一ユーザーに対する権限の管理を実行できます。または、ページに対してアプリケーションからのアクセス権の継承を指定できます。

ページ・コンテンツ、ファイル、およびフォルダ

一部のページに含まれるコンテンツを、選択した一連のユーザーのみに表示したり、他の1人のユーザーのみに表示したりすることができます。たとえば、セールス担当者を対象としたページに、2つの「お知らせ」タスク・フロー(1つはすべてのセールス担当者が対象、もう1つはセールス・マネージャのみが対象)を含めることができます。2つ目の「お知らせ」タスク・フローへのアクセスを制限することで、管理レベルのお知らせをセールス・マネージャ以外のすべてのユーザーに対して非表示にできます。

40.2 ユーザーについて

WebCenter Portalユーザーは、既存のアイデンティティ・ストアから直接にプロビジョニングされる、WebCenter Portalのログイン・アカウントを持っています。「組込みLDAPアイデンティティ・ストアへのユーザーの追加」も参照してください。

アイデンティティ・ストアのすべてのユーザーは、Authenticated-Userロールを介してWebCenter Portalの最小限の権限を割り当てられます。唯一の例外はシステム管理者(デフォルトではweblogic)です。初期設定では、システム管理者はAdministratorロールにより完全な管理権限を割り当てられた唯一のユーザーです。詳細は、次の項の「デフォルトのアプリケーション・ロール」を参照してください。

各ユーザーに適切なアプリケーション・ロールを割り当てるのは、システム管理者の仕事です。または、システム管理者は他のユーザーにAdministratorロールを割り当てることを選択し、この職務を委任することもできます。

表40-1 WebCenter Portalのデフォルトの管理者

ユーザー

説明

システム管理者(weblogic)

アプリケーション・サーバー全体の管理者は、スーパー管理者またはFusion Middleware管理者と呼ばれることがあります。このユーザーは、WebCenter Portalなどサーバー上のすべてのアプリケーションを管理できます。

40.3 アプリケーション・ロールおよび権限について

アプリケーション・ロールは、ユーザーがWebCenter Portalで利用できる情報とサービスに対するアクセス・レベルを制御します。

この項の内容は次のとおりです。

- アプリケーション・ロールについて

- アプリケーションの権限について

40.3.1 アプリケーション・ロールについて

アプリケーション・ロールの割当ては、WebCenter Portal管理者の職責です。管理者は、ユーザーにデフォルトのアプリケーション・ロールを割り当てるか、アプリケーションのデプロイメントに固有の追加のカスタム・ロールを作成できます。詳細は、次の項を参照してください。

- デフォルトのアプリケーション・ロール

- カスタム・アプリケーション・ロール

ユーザーがホーム・ポータルまたはアプリケーションレベルのタスクで作業している間は、アプリケーション・ロールが適用されます。ユーザーが特定のポータル内で作業している場合は、別のロールと権限のセットが適用されます。各メンバーに対して適切なロール割当てを決定するのは、ポータル・マネージャの職責です。「アプリケーション・ロールおよび権限の管理」と『Oracle WebCenter Portalでのポータルの構築』のポータルのセキュリティの管理に関する項も参照してください。

注意:

WebCenter Portal内で定義されたアプリケーション・ロールと権限は、ポリシー・ストアに保存されるため、そのWebCenter Portalにのみ適用されます。エンタープライズ・ロールはこれとは異なり、アプリケーションのアイデンティティ・ストア内に格納され、WebCenter Portal内のいずれかの権限を意味するものではありません。「アプリケーション・ロールとエンタープライズ・ロール」を参照してください。

40.3.1.1 デフォルトのアプリケーション・ロール

WebCenter Portalには、複数のデフォルトのアプリケーション・ロールがあります(表40-2)。デフォルトのアプリケーション・ロールのAdministrator、Public-UserおよびAuthenticated-Userは削除できませんが、各ロールへのデフォルトの権限割当ては変更できます。詳細は、「アプリケーション・ロールの権限の変更」を参照してください。

表40-2 WebCenter Portalのデフォルトのアプリケーション・ロール

アプリケーション・ロール

説明

変更の可否

管理者

Administratorロールを持つユーザーは、WebCenter Portalのアプリケーション全体のプロパティの設定、ビジネス・ロール・ページの作成、ディスカッション・フォーラム、メールおよびピープル・コネクション・サービスのデフォルト設定の構成、プロデューサと外部アプリケーションの登録、およびその他の管理作業(ログイン・ページや自己登録ページの編集など)を実行できます。

また管理者は、WebCenter Portalのユーザーおよびロールの管理、他のユーザーへの権限の委任または権限の取消し、ポータルおよびポータル・テンプレートの管理のほかに、ポータルのインポートとエクスポート、ポータルのデプロイと伝播も実行できます。

初期設定では、Administratorロールを通じてWebCenter Portalのすべての管理権限がシステム管理者のみに割り当てられます。

注意:
Administratorロールでは、プライベート・ポータルに対する管理権限(メンバーシップの管理など)が許可されますが、プライベート・ポータルのページ・コンテンツへはアクセスできません。

可*

*読取り専用のアプリケーション権限を除く

AppConnectionManager

このロールを持つユーザーは、対応するタスク・フローを通じて、ポートレット・プロデューサと外部アプリケーションを管理(作成、更新および削除)できます。

最初は、Administratorロールを持つユーザーのみが、AppConnectionManagerロールのメンバーになります。

AppConnectionManagerロールのメンバーシップを管理するには、次のオプションを使用します。

- WLSTコマンド:

- grantAppRole: ユーザーまたはロールを接続マネージャに追加する場合(コマンド構文および例については、『インフラストラクチャ・セキュリティWLSTコマンド・リファレンス』のgrantAppRoleに関する項を参照してください)。

- revokeAppRole: メンバーを接続マネージャから削除する場合(コマンド構文および例については、『インフラストラクチャ・セキュリティWLSTコマンド・リファレンス』のrevokeAppRoleに関する項を参照してください)。

- Enterprise Manager (『Oracle Platform Security Servicesによるアプリケーションの保護』のアプリケーション・ロールの管理に関する項を参照してください)。

注意: Oracle WebCenter PortalのUIでAppConnectionManagerロールは表示できません。

不可

AppConnectionViewer

このロールを持つユーザーは、対応するタスク・フローを通じて、ポートレット・プロデューサと外部アプリケーションを表示できます。

最初は、ログインした(authenticated-roleを持つ)すべてのユーザーがAppConnectionViewerロールのメンバーになります。

AppConnectionViewerロールのメンバーシップを管理するには、次のオプションを使用します。

- WLSTコマンド:

- grantAppRole: ユーザーまたはロールを接続マネージャに追加する場合(コマンド構文および例については、『インフラストラクチャ・セキュリティWLSTコマンド・リファレンス』のgrantAppRoleに関する項を参照してください)。

- revokeAppRole: メンバーを接続マネージャから削除する場合(コマンド構文および例については、『インフラストラクチャ・セキュリティWLSTコマンド・リファレンス』のrevokeAppRoleに関する項を参照してください)。

- Enterprise Manager (『Oracle Platform Security Servicesによるアプリケーションの保護』のアプリケーション・ロールの管理に関する項を参照してください)。

注意: Oracle WebCenter PortalのUIでAppConnectionViewerロールは表示できません。

不可

アプリケーション・スペシャリスト

Application Specialistロールを持つユーザーは、ポータルの作成、ポータル・テンプレートの管理、ページ、ページ・スタイル、ページ・テンプレート、コンテンツ・プレゼンタ・テンプレート、データ・コントロール、ページレット、リソース・カタログ、スキン、タスク・フロー・スタイルおよびタスク・フローの作成、編集、削除、ピープル・コネクション・データの更新およびユーザーとの接続を実行できます。

はい

ポータル作成者

Portal Creatorロールを持つユーザーには、デフォルトでPortals: Create PortalsおよびPortal Server: Viewの権限が割り当てられます。このロールのユーザーは、ポータル・テンプレートを管理または作成できません。このロールは、選択した数人のポータル・ユーザーのみがポータルを作成できるようにするために用意されています。

ポータルの作成時に、Portal Creatorロールは、ポータルレベルのPortal Managerロールに固有の権限を継承します。このロールのユーザーは、自分がメンバーであるポータルと、自分が管理するそれらのポータルをインポート、エクスポートおよびデプロイできます(アプリケーション・レベルのPortal Server: Deploy権限を持つロールである場合のみ)。

はい

認証されたユーザー

WebCenter Portalの認証されたユーザーには、Authenticated-Userロールが付与されます。ログインするユーザーにはこのロールが割り当てられ、デフォルトではホーム・ポータル、自分が作成したページおよびパブリック・ページにアクセスできます。これらのユーザーは、パブリック・ポータルも表示できます。

デフォルトでは、次の権限によって、Authenticated-Userロールに最小限の権限が付与されます。

- Portal Server: View

- Portals: Create Portals

- Portal Templates: Create Portal Templates

- Pages: Create Pages

- People Connections: Update People Connections Data

- People Connections: Connect with People

Authenticated-Userロールにも、ポータルおよびポータル・テンプレートを作成する権限があります。

このロールは、Public-Userロールから権限を継承します。

すべてのカスタム・アプリケーション・ロールは、Authenticated-Userロールから権限を継承します。

WebCenter Portalでは、Authenticated-Userロールは、標準OPSS (Oracle Platform Security Services)ロールのauthenticated-roleと同等です。

はい

パブリック・ユーザー

ログインせずにWebCenter Portalにアクセスする任意のユーザーには、Public-Userロールが付与されます。これらは匿名の識別できないユーザーであり、パブリック・コンテンツのみを参照できます。

デフォルトでは、Public-Userロールは、最小限の権限(Portal Server: View権限のみ)を付与されます。

WebCenter Portalでは、Public-Userロールは標準OPSS (Oracle Platform Security Services)ロールのanonymous-roleと同じです。

注意: Public-Userロールに権限を付与する場合は注意が必要です。Portal Server: Manage All、Portal Server: Manage Configurationなどの管理権限、または必要でないとされる権限を付与しないでください。「アプリケーションの権限について」も参照してください。

承認されていないユーザーに「パブリック」とマークされたWebCenter Portalコンテンツが表示されないようにする場合、Portal Server: View権限をPublic-Userロールに付与しないでください。パブリック・アクセスが無効になっていると、パブリック・コンテンツは承認されていないユーザーには表示されません。また、WebCenter Portalのようこそページも表示されません。パブリック・ユーザーには直接ログイン・ページが表示されます。管理者は、必要に応じて、デフォルトのログイン・ページをカスタマイズできます。「すべてのポータルのシステム・ページのカスタマイズ」を参照してください。

はい

40.3.1.2 カスタム・アプリケーション・ロール

カスタム・アプリケーション・ロール(ユーザー定義ロールとも呼ばれる)は、各WebCenter Portalに固有のロールです。WebCenter Portalを設定する際には、必要なアプリケーション・ロールの特定、適切なロール名の選択、各ロールの職責の定義はWebCenter Portalの管理者が実行します。

たとえば、教育環境では、先生、生徒、来賓などのロールが必要になります。一方、企業環境では、経理、営業、人事、サポートなどが適切なロールとなります。

WebCenter Portalでは、カスタム・アプリケーション・ロールはAuthenticated-Userロールから権限を継承します。

WebCenter Portalユーザーのアプリケーション・ロールの設定方法の詳細は、「アプリケーション・ロールの定義」を参照してください。

40.3.2 アプリケーションの権限について

すべてのアプリケーション・ロールには、権限と呼ばれる特定の定義済の権利があります。これらの権限により、各ユーザーは、ホーム・ポータル内で特定のアクションを実行できます。権限にはカテゴリがあり、後続の表に各カテゴリのリストを示します。

- 表40-3に、WebCenter Portalで利用できるアプリケーション権限を示します。

- 表40-4に、アプリケーション・ロールと、WebCenter Portalのこれらのロールに割り当てられたデフォルトの権限を示します。

Manage Allを除くすべての権限は、他の権限からその内容を継承しません。

40.3.2.1 アプリケーション権限の理解

表40-3に、WebCenter Portalで利用できるアプリケーションレベルの権限を示します。

表40-3 アプリケーション権限

カテゴリ

アプリケーション権限

ポータル・サーバー

すべて管理: WebCenter Portalのすべての管理ページ(「設定」、「ポータル」、「共有アセット」、「属性」および「ポータル・テンプレート」)にアクセスできます。これらのページにより、ユーザーは、アプリケーション・セキュリティ(ユーザー/ロール)の管理、アプリケーション全体のプロパティとサービスの構成、リソースの管理、ビジネス・ロール・ページの作成、すべてのユーザーの個人用ページの管理、システム・ページのカスタマイズ、すべてのユーザーがアクセスできるポータルの表示、ポータルとポータル・テンプレートのエクスポート/インポートを実行できます。

一部の管理タスクは、初期設定のAdministratorロールのみに限定されており、Portals: Manage Security and Configuration権限の付与によって実行することはできません。それらのタスクには、ログイン・ページ、自己登録ページおよびプロファイル・ギャラリ・ページの編集、およびすべてのポータル、すべてのポータル・テンプレート、外部アプリケーション、およびポートレット・プロデューサを管理する機能が含まれます。

構成の管理: Portal Server: Manage All権限と同じですが、セキュリティ権限は含まれていません。この権限を持つユーザーは「セキュリティ」ページにアクセスできません。

表示: ユーザーはWebCenter Portalを参照でき、ホーム・ポータルにアクセスできます。表40-2を参照してください。

デプロイ: ユーザーはポータルをデプロイおよび伝播できます。詳細は、「ポータル、テンプレート、アセットおよび拡張機能のデプロイ」を参照してください。

ポータル

セキュリティと構成の管理 - 「アセット」を除くすべてのポータル管理ページ(「概要」、「設定」、「属性」、「セキュリティ」、「ツールとサービス」)にアクセスできます。これらのページを使用すると、ユーザーは、ポータル・メンバーシップの管理、権限とロールの割当て、ポータルとリソースの管理、削除、デプロイおよびエクスポート、ポータル・プロパティの設定およびサービスの可用性の管理を実行できます。

- ポータル・ページにアクセスするには、pageおよびasset権限を持っている必要があります。

- ポータル・アセットにアクセスするには、asset権限を持っている必要があります。

Manage Configuration権限とManage Membership権限を含みます。

Manage Configuration (構成の管理) - Manage Security and Configuration権限と同じですが、セキュリティ権限を除きます。この権限を持つユーザーでポータル・マネージャでない場合、「セキュリティ」ページにアクセスできません。この権限を持つユーザーは、「ロール」ページと「メンバー」ページにはアクセスできません。

- ポータル・ページにアクセスするには、pageおよびasset権限を持っている必要があります。

- ポータル・アセットにアクセスするには、asset権限を持っている必要があります。

この権限を持つユーザーは、必ずポータルの表示が許可されます。

メンバーシップの管理 - ポータルの管理設定で、「ロール」ページと「メンバー」ページにアクセスできます。これらのページを通じて、ユーザーはポータルのメンバーやロールを作成、編集および削除できます。

ポータルの作成 - ユーザーはポータルを作成できます。

『Oracle WebCenter Portalでのポータルの構築』のポータルのロールと権限の管理に関する項を参照してください。

ポータル・テンプレート

すべて管理: ユーザーは、すべてのポータル・テンプレートの管理(「ポータル・テンプレート」ページで)およびアクセス可能なテンプレートの削除を実行できます。『Oracle WebCenter Portalでのポータルの構築』のすべてのポータル・テンプレートの管理に関する項を参照してください。

ポータル・テンプレートの作成: ユーザーはポータル・テンプレートを作成できます。

ページ

ページの作成、編集および削除: ユーザーはホーム・ポータルのページを作成、編集および削除できます。

ページの削除: ユーザーはホーム・ポータルのページを削除できます。

ページの編集: ユーザーは個人用ページ・コンテンツの追加または編集、コンテンツの再配置、およびページのパラメータとプロパティの設定が可能です。

ページのカスタマイズ: ユーザーは、コンテンツを追加、編集または削除することで、ホーム・ポータルのページの表示をカスタマイズできます。

ページの表示: ユーザーはホーム・ポータルのページを表示できます。

ページの作成: ユーザーはホーム・ポータルの新しい個人用ページを作成できます。

ページ・コンテンツのコントリビュート:

これらの権限は、ホーム・ポータルのページに適用されます。これらの権限は、ポータル内に作成したページには適用されません。ポータル内のページ権限は、ポータル・マネージャにより付与されます。『Oracle WebCenter Portalでのポータルの構築』のポータルのロールと権限の管理に関する項を参照してください。

アプリケーション統合の視覚化テンプレート

視覚化テンプレートの作成、編集および削除: ユーザーはWebCenter Portalを使用して、視覚化テンプレートを作成、編集および削除できます。

視覚化テンプレートの作成: ユーザーはアプリケーションの視覚化テンプレートを作成できます。

視覚化テンプレートの編集: ユーザーはアプリケーションレベルの視覚化テンプレートを編集できます。

『Oracle WebCenter Portalでのポータルの構築』の視覚化テンプレートの使用に関する項を参照してください。

コンテンツ・プレゼンタ・テンプレート

コンテンツ・プレゼンタ・テンプレートの作成、編集および削除: ユーザーは、WebCenter Portalを使用してコンテンツ表示テンプレートを作成、編集および削除できます。

コンテンツ・プレゼンタ・テンプレートの作成: ユーザーはアプリケーションのコンテンツ表示テンプレートを作成できます。

コンテンツ・プレゼンタ・テンプレートの編集: ユーザーはアプリケーションレベルのコンテンツ表示テンプレートを編集できます。

『Oracle WebCenter Portalでのポータルの構築』のコンテンツ・プレゼンタによるコンテンツの公開に関する項を参照してください。

データ・コントロール

データ・コントロールの作成、編集および削除: ユーザーは、WebCenter Portalを使用してデータ・コントロールを作成、編集および削除できます。

データ・コントロールの作成: ユーザーはアプリケーションのデータ・コントロールを作成できます。

データ・コントロールの編集: ユーザーはアプリケーションレベルのデータ・コントロールを編集できます。

『Oracle WebCenter Portalでのポータルの構築』のWeb Serviceデータ・コントロールの使用に関する項を参照してください。

ディスカッション

ディスカッションの作成、編集および削除: ユーザーは、バックエンドのディスカッション・サーバー上のカテゴリ、フォーラムおよびトピックの管理、およびすべてのポータルのディスカッション・フォーラム・プロパティの設定を実行できます。

「ディスカッション・サーバーのロール・マッピングの理解」を参照

リンク

リンクの作成と削除: ユーザーは、オブジェクト間のリンクの作成と削除、およびリンクの権限の管理を実行できます。

リンクの作成: ユーザーは、オブジェクト間のリンクの作成および作成したリンクの削除を実行できます。

リンクの削除: ユーザーは2つのオブジェクト間のリンクを削除できます。

ページ・スタイル

ページ・スタイルの作成、編集および削除: ユーザーはWebCenter Portalを使用して、ページ・スタイルを作成、編集および削除できます。

ページ・スタイルの作成: ユーザーはアプリケーションのページ・スタイルを作成できます。

ページ・スタイルの編集: ユーザーはアプリケーションレベルのページ・スタイルを編集できます。

『Oracle WebCenter Portalでのポータルの構築』のページ・スタイルの使用に関する項を参照してください。

ページ・テンプレート

ページ・テンプレートの作成、編集および削除: ユーザーはWebCenter Portalを使用して、ページ・テンプレートを作成、編集および削除できます。

ページ・テンプレートの作成: ユーザーはアプリケーションのページ・テンプレートを作成できます。

ページ・テンプレートの編集: ユーザーはアプリケーションレベルのページ・テンプレートを編集できます。

『Oracle WebCenter Portalでのポータルの構築』のページ・テンプレートの使用に関する項を参照してください。

ページレット

ページレットの作成、編集、および削除: ユーザーはWebCenter Portalを使用して、ページレットを作成、編集および削除できます。

ページレットの作成: ユーザーはアプリケーションのページレットを作成できます。

ページレットの編集: ユーザーはアプリケーションレベルのページレットを編集できます。

『Oracle WebCenter Portalでのポータルの構築』のページレットの使用に関する項を参照してください。

ピープル・コネクション

ピープル・コネクションの管理: ユーザーはピープル・コネクション・サービスのアプリケーション全体の設定を管理できます。

ピープル・コネクション・データの更新: ユーザーはピープル・コネクション・サービスに関連付けられたコンテンツを編集できます。

人とのコネクション: ユーザーはピープル・コネクション・サービスに関連付けられたコンテンツを他のユーザーと共有できます。

リソース・カタログ

リソース・カタログの作成、編集および削除: ユーザーは、WebCenter Portalを使用してリソース・カタログを作成、編集および削除できます。

リソース・カタログの作成: ユーザーはアプリケーションのリソース・カタログを作成できます。

リソース・カタログの編集: ユーザーはアプリケーションレベルのリソース・カタログを編集できます。

『Oracle WebCenter Portalでのポータルの構築』のリソース・カタログの使用に関する項を参照してください。

スキン

スキンの作成、編集および削除: ユーザーはWebCenter Portalを使用してスキンを作成、編集および削除できます。

スキンの作成: ユーザーはアプリケーションのスキンを作成できます。

スキンの編集: ユーザーはアプリケーションレベルのスキンを編集できます。

『Oracle WebCenter Portalでのポータルの構築』のスキンの使用に関する項を参照してください。

タスク・フロー・スタイル

タスク・フロー・スタイルの作成、編集および削除: ユーザーは、WebCenter Portalを使用してコンテンツ表示テンプレートを作成、編集および削除できます。

タスク・フロー・スタイルの作成: ユーザーはアプリケーションのコンテンツ表示テンプレートを作成できます。

タスク・フロー・スタイルの編集: ユーザーはアプリケーションレベルのコンテンツ表示テンプレートを編集できます。

『Oracle WebCenter Portalでのポータルの構築』のコンテンツ・プレゼンタによるコンテンツの公開に関する項を参照してください。

タスク・フロー

タスク・フローの作成、編集および削除: ユーザーはWebCenter Portalにより、タスク・フロー・スタイルに基づいてタスク・フローを作成、編集および削除できます。

タスク・フローの作成: ユーザーはアプリケーションのタスク・フローを作成できます。

タスク・フローの編集: ユーザーはアプリケーションレベルのタスク・フローを編集できます。

『Oracle WebCenter Portalでのポータルの構築』のタスク・フローの使用に関する項を参照してください。

40.3.2.2 アプリケーション・ロールへのデフォルトのアプリケーション権限の割当て

表40-4は、組込みアプリケーション・ロールに割り当てられたデフォルトの権限を示しています。

✔: 明示的に付与されている権限やアクションを示します。

✙: 明示的に権限が付与されている場合の暗黙的な権限を示します。

表40-4 WebCenter Portalのデフォルトのアプリケーション・ロールと権限

権限

管理者

アプリケーション・スペシャリスト

ポータル作成者

パブリック・ユーザー

認証されたユーザー

ポータル・サーバー

すべて管理

✔

構成の管理

✙

表示

✙

✔

✔

✔

✔

デプロイ

✙

ポータル

セキュリティと構成の管理

✔

✔

構成の管理

メンバーシップの管理

ポータルの作成

✔

✔

✔

ポータル・テンプレート

すべて管理

✔

✔

ポータル・テンプレートの作成

✔

ページ

ページの作成、編集および削除と、コンテンツのコントリビュート

✔

✔

ページの削除

ページの編集

ページのカスタマイズ

ページの表示

ページの作成

✔

アプリケーション統合の視覚化

アプリケーション統合の視覚化の管理

✔

コンテンツ・プレゼンタ・テンプレート

コンテンツ・プレゼンタ・テンプレートの作成

コンテンツ・プレゼンタ・テンプレートの作成、編集および削除

✔

✔

コンテンツ・プレゼンタ・テンプレートの編集

データ・コントロール

データ・コントロールの作成

データ・コントロールの作成、編集および削除

✔

✔

データ・コントロールの編集

ディスカッション

ディスカッションの作成、編集および削除

✔

リンク

リンクの作成

リンクの作成と削除

✔

リンクの編集

ページ・スタイル

ページ・スタイルの作成

ページ・スタイルの作成、編集および削除

✔

✔

ページ・スタイルの編集

ページ・テンプレート

ページ・テンプレートの作成

ページ・テンプレートの作成、編集および削除

✔

✔

ページ・テンプレートの編集

ページレット

ページレットの作成

ページレットの作成、編集、および削除

✔

✔

ページレットの編集

ピープル・コネクション

ピープル・コネクションの管理

✔

ピープル・コネクション・データの更新

✔

✔

人とのコネクション

✔

✔

リソース・カタログ

リソース・カタログの作成

リソース・カタログの作成、編集および削除

✔

✔

リソース・カタログの編集

スキン

スキンの作成

スキンの作成、編集および削除

✔

✔

スキンの編集

タスク・フロー・スタイル

タスク・フロー・スタイルの作成

タスク・フロー・スタイルの作成、編集および削除

✔

✔

タスク・フロー・スタイルの編集

タスク・フロー・スタイル

タスク・フローの作成

タスク・フローの作成、編集および削除

✔

✔

タスク・フローの編集

40.3.2.3 ディスカッション・サーバーのロール・マッピングの理解

リモート(バックエンド)・リソースにアクセスする必要のある一部のWebCenter Portalサービスでは、ロールマッピング・ベースの認可も必要であり、このため、WebCenter Portalでのディスカッション・サービスの使用を許可するWebCenter Portalロールを、WebCenter Portalのディスカッション・サーバー上の対応するロールにマップする必要があります。

WebCenter Portalでは、アプリケーション・ロールを使用してホーム・ポータル内のユーザー権限を管理し、ポータル・ロールを使用して特定のポータル内のユーザー権限を管理します。WebCenter Portalのディスカッション・サーバーでは、ロールと権限の異なるセットが適用されます。

WebCenter Portalのディスカッションおよびお知らせを使用しているユーザーは、自動的に適切なディスカッション・サーバー・ロールにマップされます(表40-5および表40-6)。

表40-5 ディスカッション・サーバーのロールと権限: アプリケーション

ディスカッション・サーバーのロール

ディスカッション・サーバーの権限

WebCenter Portal同等のアプリケーション権限

管理者

Category Admin

Discussions-Create, Edit, and Delete

権限が付与されたカテゴリ内のサブ・カテゴリ、フォーラムおよびトピックの作成、読取り、更新および削除。

表40-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ロールにのみ割り当てられます。

同様に指定されたポータルで、ディスカッションおよびお知らせ権限を割り当てられたすべてのメンバーは、ディスカッション・サーバーの対応する権限を割り当てられます。

40.3.2.4 エンタープライズ・グループのロール・マッピングの理解

WebCenter Portalでは、同じエンタープライズ・グループ内の個々のユーザーまたは複数のユーザーを、WebCenter Portalロールに割り当てることができます。バックエンドのアイデンティティ・ストアにおける、それ以降のエンタープライズ・グループの更新内容は、自動的にWebCenter Portalに反映されます。まず、エンタープライズ・グループにWebCenter Portalロールを割り当てると、そのエンタープライズ・グループに属するすべてのユーザーに同じロールが付与されます。ユーザーがグループから抜けると、ロールが取り消されます。ユーザーがグループに入ると、ロールが付与されます。

WebCenter Portalで、エンタープライズのグループからロールへのマッピングを正しくメンテナンスするには、ディスカッション・サーバーやコンテンツ・サーバーなどのバックエンド・サーバーでもエンタープライズ・グループがサポートされている必要があります。このリリースで提供されるWebCenter Portalディスカッション・サーバーとWebCenter ContentのContent Serverのバージョンでは、エンタープライズ・グループがサポートされますが、以前のバージョンではサポートされない場合があります。「ユーザーおよびロールに関する問題のトラブルシューティング」も参照してください。

40.4 ポータル内のロールおよび権限について

ユーザーが特定のポータルのメンバーになると、異なるセットのロールと職責が適用されます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルでのセキュリティの管理に関する項を参照してください。

40.5 ユーザーの管理

システム管理者は、すべてのWebCenter Portalユーザーに適切な権限を割り当てる必要があります。ユーザーが権限を取得するには、適切なアプリケーション・ロールに割り当てられている必要があります。

ユーザーとグループ・ページ(図40-3)から、システム管理者は、WebCenter Portalへのアクセス権を持つすべてのユーザー(アイデンティティ・ストアに定義されたすべてのユーザー)のアプリケーション・ロールを管理できます。ここから、ユーザー・ロールの割当ての変更、管理権限の付与およびユーザー権限の取消しを実行できます。「ユーザーとグループ」ページにアクセスするには、WebCenter Portal管理の設定を開き、「セキュリティ」をクリックします。詳細は、「WebCenter Portal管理の設定ページへのアクセス」を参照してください。

特別な(デフォルトではない)アプリケーション権限を付与されたユーザーのみが、この表に記載されます。最初は、WebCenter Portalのアイデンティティ・ストア内のすべてのユーザーに、Authenticated-Userロールにより最小限の権限が割り当てられます。デフォルトのAuthenticated-Userロールを持つユーザーは、このリストには記載されません。「デフォルトのアプリケーション・ロール」も参照してください。

図40-3 WebCenter Portal管理: 「ユーザーとグループ」ページ

この項ではロールを割り当てる方法について説明し、次のサブセクションで構成されています。

- ユーザーの追加と削除

- アプリケーション・ロールへのユーザー(およびグループ)の割当て

- 異なるアプリケーション・ロールへのユーザーの割当て

- アプリケーション・ロールの取消し

40.5.1 ユーザーの追加と削除

WebCenter Portal管理者は、WebCenter Portalのアイデンティティ・ストアに対して直接新しいユーザー・データを追加したり、ユーザー資格証明を削除することはできません。アイデンティティ・ストアの管理はシステム管理者の職責であり、WLS管理コンソールを通じて実行するか、組込みLDAPアイデンティティ・ストアに対し、LDAPコマンドを使用して直接実行します。「WLS管理コンソールを使用したアイデンティティ・ストアへのユーザーの追加」も参照してください。

ただし、WebCenter Portal管理者はアプリケーションの自己登録を有効化できます。自己登録により、パブリック・ユーザーは独自のWebCenter Portalログインとパスワードを作成できます。自己登録したユーザーはただちに自動的にWebCenter Portalへのアクセス権が付与され、新規ユーザー・アカウントがアイデンティティ・ストアで作成されます。「自己登録の有効化」も参照してください。

40.5.2 アプリケーション・ロールへのユーザー(およびグループ)の割当て

最初は、WebCenter Portalのアイデンティティ・ストア内のすべてのユーザーに、Authenticated-Userロールにより最小限の権限が割り当てられます。個々のユーザー(または同じエンタープライズ・グループに属する複数のユーザー)に、WebCenter Portal管理を使用して異なるアプリケーション・ロールを割り当てることができます。

新規ユーザーまたはエンタープライズ・グループから脱退するユーザーなどの、バックエンド・アイデンティティ・ストアでの更新は、WebCenter Portalに自動的に反映されます。まず、エンタープライズ・グループにWebCenter Portalロールを割り当てると、そのエンタープライズ・グループに属するすべてのユーザーに同じロールが付与されます。ユーザーがグループから抜けると、ロールが取り消されます。ユーザーがグループに入ると、ロールが付与されます。

注意:

WebCenter Portalで、エンタープライズのグループからロールへのマッピングを正しくメンテナンスするには、ディスカッション・サーバーやコンテンツ・サーバーなどのバックエンド・サーバーでもエンタープライズ・グループがサポートされている必要があります。バックエンド・サーバーがエンタープライズ・グループをサポートしていない場合には、「Group [name] not found in the Identity Store」というメッセージが表示されます。「ユーザーおよびロールに関する問題のトラブルシューティング」も参照してください。

ユーザー(またはユーザーのグループ)に異なるアプリケーション・ロールを割り当てるには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「セキュリティ」をクリックします。
あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/admin/settings/security

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「ユーザーとグループ」をクリックします(図40-3)。
このページには、追加ロールが定義されているユーザーのリストが記載されています。

3. ドロップダウン・リストから「ユーザー」または「グループ」を選択します。

- 「ユーザー」を選択して、アイデンティティ・ストアで定義された1人または複数のユーザーに権限を付与します。

- 「グループ」を選択して、ユーザー・グループに権限を付与します。

4. ユーザーまたはグループの正確な名前がわかる場合には、テキスト・ボックスに名前を入力します。複数の名前はカンマで区切ります。
正確な名前がわからない場合、アイデンティティ・ストアを検索できます。

a. 「検索」アイコンをクリックします()。
「ユーザーの検索」(または「グループの検索」)ダイアログ・ボックスが開きます(図40-4)。

図40-4 アイデンティティ・ストアのユーザーおよびグループの検索

b. ユーザーまたはグループの検索語を入力して、「検索」アイコンをクリックします。
アイデンティティ・ストアのユーザーまたはグループの検索のヒントは、『Oracle WebCenter Portalでのポータルの構築』のアイデンティティ・ストアでのユーザーまたはグループの検索に関する項を参照してください。

検索基準に一致するユーザー(またはグループ)が、「ユーザーの選択」ダイアログ・ボックスに表示されます。検索するフィールドの詳細は、『Oracle WebCenter Portalでのポータルの構築』のアイデンティティ・ストアでのユーザーまたはグループの検索に関する項を参照してください

ヒント

- *salesのように、*をワイルドカードとして使用します。

- アイデンティティ・ストアにあるすべてのユーザー(またはグループ)のリストを表示するには、検索フィールドを空白のままにします。

- 名と姓で検索するには、2つの検索語の間にスペースを入力します。たとえば、名がjoで姓のsmの場合、jo smのようにします。

c. リストから1つ以上の名前を選択します。
複数のユーザーまたはグループにロールを割り当てるには、すべての必要な名前を複数選択します。複数の名前を選択するには、[Ctrl]キーを押しながら行をクリックします。

d. 「OK」をクリックします。
選択した名前は「ユーザーとグループ」タブに表示されます。

5. ロールを割り当てるには、ドロップダウン・リストから「ロール」を選択します。
選択したユーザー(またはグループ)に対して適切なロールを選択します。

注意:

WebCenter Portalのすべての管理権限を割り当てる場合にのみ「管理者」を選択します。

- 必要なロールがリストにない場合は、要件を満たす新規ロールを作成します(「アプリケーション・ロールの定義」を参照)。

- ロールが1つも選択されていない場合、ユーザーはAuthenticated-Userロールを引き受けます。「デフォルトのアプリケーション・ロール」を参照してください。

6. 「アクセス権の付与」をクリックします。
ユーザー/ユーザー・グループの名前と新規ロールの割当てが、表に表示されます。

注意:

グループ名はクリック可能で、クリックによりドリルダウンして、現在のグループ・メンバーのユーザー名を確認できます。

40.5.3 異なるアプリケーション・ロールへのユーザーの割当て

WebCenter Portalでのユーザーのロールは、変更されることがあります。たとえば、ユーザーが営業から経理部門に異動になった場合、ユーザーのロール割当ては「営業」から「経理」に変更されます。ユーザーに複数のロールを割り当てることもできます。

注意:

自分のロールまたはシステム管理者のロールは、変更できません。「アプリケーション・ロールについて」を参照してください。

ユーザーに異なるロールを割り当てるには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「セキュリティ」をクリックします。

あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/admin/settings/security

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「ユーザーとグループ」をクリックします(図40-3)。

3. 「既存の付与の管理」表で、ロール割当てを変更するユーザーまで下へスクロールします。

デフォルト以外のロールを割り当てられたユーザーのみが、表に表示されます。目的のユーザーがリストに表示されない場合は、「ユーザー(およびグループ)へのアプリケーション・ロールの割当て」で説明しているように、必要なロールを付与します。

4. 「アクション」アイコンをクリックして、ドロップダウン・リストから「ロールの変更」を選択します。

「ロールの変更」ダイアログが開きます(図40-5)。

図40-5 ユーザーのアプリケーション・ロールの変更

5. 次のようにロールを選択します。

- WebCenter Portalのすべての管理権限を割り当てるには、「管理者」を選択します。
管理者は最高レベルの権限を持ち、WebCenter Portalのすべてを表示および変更できるため、Administratorロールの割当ては慎重に行います。

ログイン・ページ、自己登録ページおよびプロファイル・ギャラリ・ページの編集などの一部の管理タスクは、Administratorロールに限定されています。「デフォルトのアプリケーション・ロール」も参照してください。

- 利用できるリストから1つ以上のロールを選択します(ユーザーまたはグループに1つ以上のロールを割り当てることができます)。
必要なロールがリストにない場合は、要件を満たす新規ロールを作成します(「アプリケーション・ロールの定義」を参照)。

少なくとも1つのロールを選択する必要があります。すべてのロールの割当てを取り消して、ユーザー権限をデフォルトのAuthenticated-Userロールに戻すには、「アプリケーション・ロールの取消し」を参照してください。

6. 「OK」をクリックします。

新規ロール割当てが、表に表示されます。

40.5.4 アプリケーション・ロールの取消し

適用することがなくなったアプリケーション・ロール割当てを取り消すのは簡単です。個々にロールを取り消すか、特定のユーザーに割り当てられたすべてのアプリケーション・ロールを一度に取り消します。

ユーザーのアプリケーション・ロールをすべて取り消した場合でも、そのユーザーはアイデンティティ・ストアから削除されず、引き続きデフォルトのAuthenticated-Userロールを使用してOracle WebCenter Portalにアクセスできます。

注意:

自分のロール割当てまたはシステム管理者のロールを取り消すことはできません。「アプリケーション・ロールについて」を参照してください。

アプリケーション・ロールを取り消す手順は、次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「セキュリティ」をクリックします。

あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/admin/settings/security

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「ユーザーとグループ」をクリックします(図40-3)。

このページには、追加ロールが定義されているユーザーのリストが記載されています。

3. 「既存の付与の管理」表で、目的のユーザーまで下へスクロールします。

4. 「アクション」アイコンをクリックします。

- 「ロールの変更」を選択して、取り消すアプリケーション・ロールの選択を解除します。「異なるアプリケーション・ロールへのユーザーの割当て」も参照してください。

- 「ロール割当ての削除」を選択してそのユーザーに割り当てられたロールをすべて取り消し、確認を求められたら「削除」をクリックします。

そのユーザーのアクセス権がすぐに取り消されます。

特定のユーザーに割り当てられているすべてのロールを削除すると、そのユーザーは「ユーザーとグループ」ページにリストされません。そのユーザーはアイデンティティ・ストアに残るため、引き続きAuthenticated-UserロールによりOracle WebCenter Portalにアクセスできます。「デフォルトのアプリケーション・ロール」を参照してください。

40.6 アプリケーション・ロールおよび権限の管理

WebCenter Portalでは、ホーム・ポータルで操作を行うユーザーの権限を管理するためにアプリケーション・ロールを使用しています。管理者は、「ロール」ページでアプリケーション・ロールと権限を管理します(図40-6)。組込みアプリケーション・ロールおよび権限の詳細は、表40-4を参照してください。

図40-6 WebCenter Portal管理: 「ロール」ページ

この項では、WebCenter Portal管理でアプリケーション・ロールとその権限を管理する方法について説明します。次のサブセクションが含まれます:

- アプリケーション・ロールと権限の表示

- アプリケーション・ロールの定義

- アプリケーション・ロールの権限の変更

- アプリケーション・ロールの削除

40.6.1 アプリケーション・ロールと権限の表示

「ロール」ページで、「ロール」ドロップダウンを使用してアプリケーション・ロールを選択して、その関連付けられている権限を表示します。

ロールに関連付けられている権限を表示する手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「セキュリティ」をクリックします。

あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/admin/settings/security

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「ロール」タブをクリックして、「ロール」ページ(図40-6)を開き、Administratorロールと、そのデフォルトで関連付けられている権限を表示します。

3. 「ロール」ドロップダウン(図40-7)からロールを選択してその関連付けられている権限を表示します。

図40-7 WebCenter Portal管理: 「ロール」ページ

4. 次のいずれかの操作を実行します。

- 新しいアプリケーション・ロールを作成するには、「アプリケーション・ロールの定義」を参照してください。

- ロールの定義済権限を変更するには、「アプリケーション・ロールの権限の変更」を参照してください。

- アプリケーション・ロールを削除するには、「アプリケーション・ロールの削除」を参照してください。

5. 「保存」をクリックします。

40.6.2 アプリケーション・ロールの定義

WebCenter Portalユーザーのグループを特徴付けるロールを使用して、そのロールによりホーム・ポータルで表示および実行できる内容を決定します。

アプリケーション・ロールを定義する際には、自己記述的なロール名を使用し、ロール・ポリシーは可能なかぎり簡単なものにします。最小限のロールを選択し、効果的なポリシーを維持します。

新規のロールに対する権限の割当ては、適切なアクセス権を割り当てるように注意します。ロールには必要以上に多くのアクションをユーザーが実行できないようにすると同時に、必要なアクティビティの実行までも不注意に制限しないようにします。場合によっては、ユーザーが複数のロールに該当することもあります。

新規のアプリケーション・ロールを定義する手順は、次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「セキュリティ」をクリックします。

あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/admin/settings/security

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「ロール」タブをクリックして、「ロール」ページ(図40-6)を開き、Administratorロールと、そのデフォルトで関連付けられている権限を表示します。

3. 「ロールの作成」をクリックして、WebCenter Portalユーザーの新しいロールを定義します。

図40-8 新しいロールの作成

4. ロールに合った名前を入力します。

自己記述的なロール名を付けます。どのユーザーがどのロールに所属するかを可能なかぎり明白にします。ロール名には、英数字、空白およびアンダースコアを使用できます。

5. (オプション)「ロール・テンプレート」を選択します。

新しいロールは、ロール・テンプレートから権限を継承します。この権限は次の手順で変更できます。

「管理者」を選択して、完全な管理権限を継承するロールを作成します。逆に、「パブリック・ユーザー」を選択して、通常は最小限の権限を割り当てるロールを作成します。または、カスタム・アプリケーション・ロールを選択して自分のテンプレートにします。

6. 「OK」をクリックします。

「ロール」ドロップダウンに新しいロールが表示されます。ユーザーがこのロールを使用して実行できるアクションが、権限リストに表示されます。別のロールを選択するには、「ロール」ドロップダウンを使用します。

7. このロールのユーザー権限を変更するには、各権限チェック・ボックスを選択または選択解除します。

8. 「保存」をクリックして、ロールの権限に対して指定したすべての変更を保存します。

40.6.3 アプリケーション・ロールの権限の変更

管理者は、アプリケーションに関連付けられた権限をいつでも変更できます。アプリケーション権限の詳細は、「アプリケーションの権限について」を参照してください。

アプリケーション・ロールの権限により、各ユーザーはホーム・ポータル内で特定のアクションを実行できます。Manage Allを除くすべての権限は、他の権限からその内容を継承しません。

注意:

Administratorロールについては、アプリケーションの権限を変更することはできません。「デフォルトのアプリケーション・ロール」も参照してください。

ロールに関連付けられた権限を変更するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「セキュリティ」をクリックします。

あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/admin/settings/security

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「ロール」(図40-6)タブをクリックします。

ページが開き、Administratorロールと、そのデフォルトで関連付けられている権限が表示されます。

3. 「ロール」ドロップダウンから、権限を変更するロールを選択します。

選択したロールに関連付けられている権限が「権限」列の隣に表示されます。

4. 「権限」チェック・ボックスを選択または選択解除して、ロールの権限を有効または無効にします。
組込みロールの権限を変更する場合は、慎重に行う必要があります。表40-2を参照してください。

5. 「保存」をクリックします。

新しい権限は即時有効になります。

40.6.3.1 パブリック・ユーザーへの権限の付与

WebCenter Portalにログインしていないユーザーは、Public-Userロールを引き受けます。デフォルトでは、Public-Userロールは、最小限の権限(Portal Server: View権限のみ)を付与されます。

注意:

Public-Userロールに権限を付与する際には注意してください。Portal Server: Manage All、Portal Server: Manage Configurationなどの管理権限、または必要でないとされる権限を付与しないでください。「アプリケーションの権限について」も参照してください。

Portal Server-View権限の付与

Portal Server: View権限により、認証されていないユーザーは、ようこそページや個々のユーザーがパブリック指定を選択しているコンテンツなどのパブリックWebCenter Portalページを表示できます。

Portal Server: View権限がPublic-Userロールに付与される場合:

- パブリックに指定されているすべての個人用ページまたは個人用コンテンツが、WebCenter Portalコミュニティ外の承認されていないユーザー(Webアクセス権を持つすべてのユーザー)に対してアクセス可能になることをユーザーに周知してください。

- パブリック・ユーザーがログインする前に、パブリック・ユーザーに表示されるデフォルトのようこそページのカスタマイズを検討してください。「システム・ページのカスタマイズ」を参照してください。

承認されていないユーザーに「パブリック」とマークされたWebCenter Portalコンテンツが表示されないようにする場合、Portal Server: View権限をPublic-Userロールに付与しないでください。パブリック・アクセスが無効になっていると、パブリック・コンテンツは承認されていないユーザーには表示されません。また、WebCenter Portalのようこそページも表示されません。パブリック・ユーザーには直接ログイン・ページが表示されます。管理者は、必要に応じて、デフォルトのログイン・ページをカスタマイズできます。「すべてのポータルのシステム・ページのカスタマイズ」を参照してください。

その他の権限の付与

Public-Userロールに権限を割り当てる際には注意してください。セキュリティ上の理由から、匿名ユーザーがWebCenter Portal内で表示および実行できる内容を制限することをお薦めします。

40.6.3.2 認証されたユーザーへの権限の付与

WebCenter Portalにログインしているすべてのユーザーは、Authenticated-Userロールを引き受けます。デフォルトでは、次の権限によって、Authenticated-Userロールに最小限の権限が付与されます。

- Portal Server: View

- Portals: Create Portals

- Portal Templates: Create Portal Templates

- Pages: Create Pages

- People Connections: Update People Connections Data

- People Connections: Connect with People

その他の重要な注意点は、次のとおりです。

- Authenticated-Userロールは、Public-Userロールからの権限を必ず継承します。

- すべてのカスタム・アプリケーション・ロールは、Authenticated-Userロールの権限を継承します。

40.6.3.3 ポータル作成者への権限の付与

Portal Creatorロールは、特に、ポータルを作成するために、ログイン・ユーザーに付与されます。

初期設定では、このロールは、最小限の権限を持ちます: Portal Server: ViewおよびPortals: Create Portals。ポータルを作成した後、Portal Creatorロールには、Portal Managerロールに固有の権限が付与されます。

40.6.4 アプリケーション・ロールの削除

アプリケーション・ロールが必要でなくなった場合は、削除することをお薦めします。これにより、有効で管理可能なロール・リストを維持し、不適切なロール割当てを防止できます。

アプリケーション・ロールは、ユーザーに割り当てられている場合でも削除できます。デフォルトのロールはいずれも削除できないため、WebCenter PortalユーザーにはAuthenticated-Userロールが常時割り当てられます。

注意:

デフォルトのアプリケーション・ロールのAdministrator、Public-UserおよびAuthenticated-Userは、削除できません(Application SpecialistおよびPortal Creatorロールは削除できます)。「デフォルトのアプリケーション・ロール」を参照してください。

アプリケーション・ロールを削除するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「セキュリティ」をクリックします。

あるいは、「セキュリティ」ページに直接移動するには、ブラウザで次のURLを入力します。

http://host:port/webcenter/portal/admin/settings/security

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「ロール」(図40-6)タブをクリックします。

ページが開き、Administratorロールと、そのデフォルトで関連付けられている権限が表示されます。

3. 「ロール」ドロップダウンから、削除するロールを選択します(図40-7)。

注意:

デフォルトのアプリケーション・ロールのAdministrator、Public-UserおよびAuthenticated-Userは、削除できません(Application SpecialistおよびPortal Creatorロールは削除できます)。

WebCenter Portalで選択されたロールに関連付けられた権限が表に表示されます。

4. 削除するロールの隣の「削除」をクリックします(図40-9)。

図40-9 アプリケーション・ロールの削除

5. 「削除」をクリックしてロールの削除を確定します。

ロールが表から削除されます。このロールに割り当てられていたすべてのユーザーは、Authenticated-Userロールを引き受けます。

41 ポータル間のグローバル属性での作業

この章では、WebCenter Portalの任意のポータルで使用できるグローバル属性をシステム管理者が管理する方法について説明します。

この章の内容は次のとおりです。

- グローバル属性について

- グローバル属性の追加

- グローバル属性の編集

- グローバル属性の削除

権限

この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは少なくとも次の権限を付与されているカスタム・ロールが必要です。

- Portal Server: Manage AllまたはPortal Server: Manage Configuration

権限の詳細は、「アプリケーション・ロールおよび権限について」を参照してください。

41.1 グローバル属性について

どのポータルにも、名前、説明、作成日、アイコンなどの組込み属性があります。これらの組込み属性の他に、ポータル・マネージャは、ポータルおよびその特性に固有のカスタム属性を追加して、追加のポータル情報(メタデータ)を指定できます。カスタム属性はポータル全体に伝播します。特定のポータルに固有の属性での作業の詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル・ページでの作業に関する項を参照してください。

システム管理者は、ポータル固有の属性の他に、WebCenter Portal管理の属性ページ(図41-1)で、グローバル属性を追加および管理できます。グローバル属性は任意のポータルで使用できます。

図41-1 WebCenter Portal管理: 属性

カスタム属性は単なる名前と値のペアです(customerId=400、orderId=11、userName=Smithなど)。カスタム属性名は特定のポータル内で一意です。たとえば、お客様を分析する目的でパラメータcustomerIdを入力として取るいくつかのカスタム・タスク・フロー(お客様の売上履歴、顧客満足度の評価、将来の売上予測、お客様連絡先情報など)とともに、ポータルでグローバル属性を使用できます。適切な値を持つcustomerIdという名前で定義されたカスタム属性を使用すると、customerIdを受け入れることができるすべてのタスク・フローは、そのお客様固有の情報を表示できます。

カスタム属性は、式言語(EL)の式を使用して取得することもできます。たとえば、EL式は、ポータルを表示するURLを介して渡される値(customerid=10など)を読み取ることができます。パラメータ値に基づいてカスタマイズされたコンテンツを配信するポータル・ページ、タスク・フローまたはポートレットの場合は、グローバル・カスタム属性値を受け入れ、そのグローバル・カスタム属性値に次の式言語(EL)構文を使用してアクセスすることで適切にコンテンツを表示できます。

#{WCAppContext.application.applicationConfig.customAttributes[attributeName]}

ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の式言語式に関する項を参照してください

41.2 グローバル属性の追加

任意のポータルで使用する新しいグローバル属性を追加する手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「属性」をクリックします。

ブラウザに次のURLを入力して直接「属性」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/attributes

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 属性ページで、「属性の追加」(図41-2)をクリックします。

図41-2 WebCenter Portal管理: 属性の追加

「属性の追加」ダイアログが開きます(図41-3)。

図41-3 カスタム属性の名前と値の入力

3. 属性の一意の名前を入力します。有効な名前は、英字で始まり英数字のみから構成されます。

4. 必要に応じて、カスタム属性の値を入力します。入力した値は文字列値として処理されます。

5. 「追加」をクリックしてカスタム属性を保存し、これを「属性」ページのリストに表示します。

41.3 グローバル属性の編集

グローバル属性を編集するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「属性」をクリックします。

ブラウザに次のURLを入力して直接「属性」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/attributes

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「属性」ページで、属性の「アクション」アイコンをクリックして、「属性の編集」を選択します。

3. 「属性の編集」ダイアログで、属性の値を変更します。入力した値は文字列値として処理されます。

4. 「OK」をクリックして、変更を保存します。

41.4 グローバル属性の削除

グローバル属性を削除するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「属性」をクリックします。

ブラウザに次のURLを入力して直接「属性」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/attributes

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「属性」ページで、属性の「アクション」アイコンをクリックして、「属性の削除」を選択します。

3. 確認ダイアログで、「削除」をクリックします。

42 システム・ページのカスタマイズ

この章では、WebCenter Portalで使用可能な初期設定のシステム・ページとそのカスタマイズ方法について説明します。

注意:

システム管理者がシステム・ページに加えた変更は、すべてのポータルに反映されます。たとえば、システム管理者がイメージを「お知らせ」システム・ページに追加すると、そのイメージはすべてのポータルの「お知らせ」システム・ページに表示されます。個々のポータルに限定してシステム・ページを変更することはできません。

この章の内容は次のとおりです。

- システム・ページについて

- すべてのポータルのシステム・ページのカスタマイズ

- システム・ページのプロパティの設定

- システム・ページからのすべてのページ・カスタマイズの削除

権限

この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server: Manage AllまたはPortal Server: Manage Configuration

- Pages: Create, Edit, and Delete Pages

権限の詳細は、「アプリケーション・ロールおよび権限について」を参照してください。

42.1 システム・ページについて

システム・ページは、特定の状況で表示されるように設計されている、一連のデフォルトユーティリティ・ページです。たとえば、ポータルへのアクセス時にログインしていないユーザーには、パブリックの「ようこそ」ページが表示されます。システム・ページでは、ポータルの迅速な開発がサポートされ、紹介ページの提供から、動的に生成されて個々のユーザーに合わせたコンテンツを提供するページに至るまでの幅広いニーズが実現します(「アクティビティ・ストリーム」ページなど)。

システム・ページは、想定ユーザーを対象とするページへのアクセス設定により事前構成されています。たとえば、「ようこそ」ページはanonymous-role、「アクティビティ・ストリーム」ページは個々のユーザーを対象として、各ユーザーに合わせた動的コンテンツで構成されます。この事前構成のビューでは、システム・ページのセキュリティ設定を変更できません。

システム・ページをカスタマイズして会社のブランドを反映したり、役立つヒントやその他の機能(タスク・フローおよびポートレットなど)を提供することができます。システム・ページをカスタマイズすると、そのページに、WebCenter Portalのルック・アンド・フィールが更新された状態で、ユーザーのカスタマイズが表示されます。システム・ページをカスタマイズするまで、WebCenter Portalには汎用バージョンのシステム・ページがWebCenter Portalの前のリリースで使用されたルック・アンド・フィールで表示されます。

また、システム・ページによりタスク・フローのカスタマイズも可能になります。システム・ページの「タスク・フロー・エディタ」は、指定された範囲におけるシード済タスク・フローのすべてのインスタンスを1つの操作でカスタマイズする環境を提供します。つまり、認可されたユーザーは、シード済タスク・フローをこのページに追加してカスタマイズし、そのカスタマイズをタスク・フローのすべてのインスタンスに適用できます。「アセット」ページまたは「共有アセット」ページを使用して作成したカスタム・タスク・フローは、このページでは編集できないことに注意してください。詳細は、「タスク・フローのカスタマイズ」を参照してください。

注意:

システム・ページのリストおよび説明は、「組込みシステム・ページについて」を参照してください。

42.1.1 組込みシステム・ページについて

表42-1は、WebCenter Portalに含まれるシステム・ページの一覧と説明、およびシステム・ページが表示されるコンテキストに関する情報を提供します。

表42-1 組込みシステム・ページ

ページ

説明

コンテキスト

WebCenter Portalのバージョン情報

WebCenter Portalの情報を提供します(バージョンおよび著作権情報を含む)

「ヘルプ」メニューをクリックして「バージョン情報」を選択するか、フッターの「WebCenter Portalのバージョン情報」リンクをクリックすると表示されます。

アクティビティ

ホーム・ポータルに対して、ピープル・コネクション・サービスから「パブリッシャ」タスク・フローと「アクティビティ・ストリーム」タスク・フローが表示されます。詳細は、『Oracle WebCenter Portalの使用』のポータル・アクティビティの追跡に関する項を参照してください。

すべての認証済(ログインしている)ユーザーのホーム・ポータルにデフォルトで表示されます。

アクティビティ・ストリーム

ポータルに対して、ピープル・コネクション・サービスから「パブリッシャ」タスク・フローと「アクティビティ・ストリーム」タスク・フローが表示されます。詳細は、『Oracle WebCenter Portalの使用』のポータル・アクティビティの追跡に関する項を参照してください。

組込みポータル・テンプレートでホームページにデフォルトで表示されます。

分析

アプリケーションの使用状況とパフォーマンス・メトリックに関する情報を提供します。詳細は、「ポータルの使用状況の分析」を参照してください。

「分析」タスク・フローを機能させるには、「分析」スキーマ(ACTIVITIES)をインストールして構成し、WebCenter Portalと分析コレクタの間の接続を設定する必要があります。

ホーム・ポータルでの表示で使用可能です。構成の要件が満たされている場合にのみ有用です。

お知らせ

「お知らせマネージャ」タスク・フローを表示します。詳細は、『Oracle WebCenter Portalの使用』のお知らせの使用に関する項を参照してください。

組込みポータル・テンプレートにデフォルトで表示されます。

ディスカッション

「ディスカッション・フォーラム・マネージャ」タスク・フローを表示します。詳細は、『Oracle WebCenter Portalの使用』のディスカッションの表示と参加に関する項を参照してください。

組込みポータル・テンプレートにデフォルトで表示されます。

ドキュメント

「コンテンツ・マネージャ」タスク・フローを表示します。

2種類の「ドキュメント」システム・ページがあります。1つは現在のユーザーの個人用ドキュメントを表示するホーム・ポータル用、もう1つはそのポータルにアップロードされたドキュメントを表示するポータル用です。詳細は、『Oracle WebCenter Portalの使用』のドキュメントの追加と管理に関する項を参照してください。

組込みポータル・テンプレートにデフォルトで表示されます。

エラーが発生しました

エラーが発生するとエラー・ページを表示します。

アプリケーションのエラーが発生すると表示されます。

イベント

「イベント」タスク・フローを表示します。詳細は、『Oracle WebCenter Portalの使用』のカレンダとイベントの使用に関する項を参照してください。

組込みポータル・テンプレートにデフォルトで表示されます。

リスト

「リスト・マネージャ」タスク・フローを表示します。詳細は、『Oracle WebCenter Portalの使用』のリストの使用に関する項を参照してください。

組込みポータル・テンプレートにデフォルトで表示されます。

メンバー

ポータルのメンバーを管理するための機能を提供します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルのメンバーの管理とロールの割当てに関する項を参照してください。

一部の組込みポータル・テンプレートで、デフォルトのナビゲーションに「メンバー」ページとして表示されます。

いずれのページにもアクセスできません

いずれのページにもアクセスできないことをユーザーに通知するメッセージを表示します。

ポータルのページでユーザーがアクセス権限を持たないポータルに移動すると表示されます。

ページが見つかりません

ページが見つからないことをユーザーに通知するメッセージを表示します。

ユーザーが、WebCenter Portal内で使用されなくなったページや、アクセス権限を持たないページに移動すると表示されます。

ページ・ビューア

外部のWebサイト(google.comなど)を、ポータルのページ・テンプレート内に表示します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のリソースのナビゲーション・モデルへの追加に関する項を参照してください。

ポータル・ナビゲーションに外部URLアイテム(ターゲットの同じページとともに)が含まれる場合に使用されます。ユーザーがナビゲーションでそのようなリンクをクリックすると、「ページ・ビューア」が使用されます。

ポータルが見つかりません

ポータルが見つからないことをユーザーに通知するメッセージを表示します。

ユーザーが使用されなくなったポータルに移動すると表示されます。

ポータル

現在のユーザーがアクセスできるすべてのポータルのビューを表示します。さらに、ポータルの作成、検索、ソートおよびフィルタリングの機能を提供します。詳細は、『Oracle WebCenter Portalの使用』の使用可能なポータルの表示とアクセスに関する項を参照してください。

ユーザーが「ポータル」メニューから「ポータル・ブラウザ」を選択すると表示されます。

ポータル・テンプレート

すべての使用可能なポータル・テンプレートのビューを表示します。ポータル・テンプレートの作成、編集およびフィルタリング用のコントロールと、選択したポータル・テンプレートに関する情報の表示用のコントロールが含まれます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル・テンプレートの使用に関する項を参照してください。

「ポータル・テンプレート」ページの管理ページに表示されます。

プロファイル

現在のユーザーの「プロファイル・ギャラリ」を表示します。これには、「アクティビティ・ストリーム」、「コネクション」、「ドキュメント」、組織図(「組織」)およびユーザーのプロファイル詳細(「情報」)のサブページが含まれます。詳細は、『Oracle WebCenter Portalの使用』のプロファイルの管理に関する項およびドキュメントの作成と管理に関する項を参照してください。

認証された(ログインしている)ユーザーそれぞれのホーム・ポータルにデフォルトで表示されます。

パブリック・ポータル

ポータル・ブラウザにすべてのパブリック・ポータルを表示します。

WebCenter Portalサインイン・ページでパブリック・ポータルの表示を選択すると表示されます。

リソース・ビューア

ページ・テンプレートに囲まれた、ポータル内のポートレット・リソースを表示します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のナビゲーション・モデルへのアイテムの追加に関する項を参照してください。

ポータル・ナビゲーションにポートレット・リソースのリンクが含まれる場合に使用されます。ユーザーがナビゲーションでそのようなリンクをクリックすると、「リソース・ビューア」が使用されます。

検索

「検索結果」ページを表示します。詳細は、『Oracle WebCenter Portalの使用』のWebCenter Portalでの検索についてに関する項を参照してください。

検索結果の表示が動的にレンダリングされます。

自己登録

WebCenter Portalにユーザー独自のログイン・アカウントを作成する手段を提供します。詳細は、『Oracle WebCenter Portalの使用』のWebCenter Portalへの自己登録に関する項を参照してください。

WebCenter Portalサインイン・ページで「登録」をクリックすると表示されます。

セルフサービス・メンバーシップ

サブスクリプションによるメンバーシップを許可するように構成されたポータルにサブスクリプションの手段を提供します。詳細は、『Oracle WebCenter Portalの使用』のポータルへの参加に関する項を参照してください。

ユーザーがポータルへのサブスクリプションを開始すると表示されます。

サインイン

ポータルにログインするためのフィールドを表示します。

すべてのアプリケーション・ページへのパブリック・アクセスが無効化されている場合、および現在のセッションが期限切れになった場合に、WebCenter Portalサインイン・ページのかわりに表示されます。

タグ・センター

ユーザーがタグを管理できるようにするためのタグ・センターを表示します。詳細は、『Oracle WebCenter Portalの使用』のタグの使用に関する項を参照してください。

「タグ」タスク・フローまたは検索結果内のタグをユーザーがクリックしたときに動的に表示されます。

タスク・フロー・エディタ

指定された範囲内の組込みタスク・フローのすべてのインスタンスを、1回の操作でカスタマイズする環境を提供します。(「アセット」ページまたは「共有アセット」ページを使用して作成したカスタム・タスク・フローは、このページでは編集できません。)詳細は、「タスク・フローのカスタマイズ」を参照してください。

認可されたユーザーによる、組込みタスク・フローの追加、およびそれらのタスク・フローのすべてのインスタンスのカスタマイズを許可します。

タスク・フロー・ビューア

ページ・テンプレートに囲まれた、ポータル内のタスク・フロー・リソースを表示します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のナビゲーション・モデルへのアイテムの追加に関する項を参照してください

ポータル・ナビゲーションにタスク・フロー・リソースのリンクが含まれる場合に使用されます。ユーザーがナビゲーションでそのようなリンクをクリックすると、「タスク・フロー・ビューア」が使用されます。

未許可

ポータルやページへのアクセスが認可されていないことをユーザーに通知するメッセージを表示します。

ユーザーがアクセス権限を持たないポータルやページに移動すると表示されます。

使用不可

ポータルが使用不可であることをユーザーに通知するメッセージを表示します。

ユーザーがオフラインのポータルに移動すると表示されます。

ユーザー・プロファイル

現在のユーザー以外のユーザーのプロファイル・ギャラリを表示します。デフォルトでは、現在のユーザーのプロファイル・ギャラリと同じサブページおよびタスク・フローが表示されます。他のユーザーに関連付けられている情報が表示される点が異なります。

現在のユーザーが別のユーザーのプロファイルにアクセスすると、動的にレンダリングされます。

WebCenter Portalようこそページ

ログイン・フィールド、「登録」リンク(自己登録が有効な場合)、パブリック・ポータルへのリンク、フッター・リンク、および代替セッション言語を選択するための言語変更を表示します。

これは、パブリックのようこそページです。ユーザーがWebCenter Portalにアクセスした際に、最初に表示されるページです。

すべてのアプリケーション・ページへのパブリック・アクセスを無効にすると、パブリックのようこそページは表示されず、ユーザーは「ログイン」ページにダイレクトされます。

42.2 すべてのポータルのシステム・ページのカスタマイズ

組込みシステム・ページをカスタマイズして、所属する組織のブランドやルック・アンド・フィールに合うように表示できます。既存のコンポーネントを削除し、新しいコンポーネントを追加し、ページ・レイアウトを変更できます。ただし、システム・ページの入力フィールドとボタンを編集または削除することはできません。

デバイス・グループごとに使用するシステム・ページのページ・バリアントを作成してある場合、これらのページ・バリアントをカスタマイズすることも可能です。

システム・ページまたはシステム・ページ・バリアントをカスタマイズする手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「システム・ページ」をクリックします。

ブラウザで次のURLを入力して、「システム・ページ」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/systempages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項

2. システム・ページの横にある「カスタマイズ」リンクをクリックして、コンポーザでそれを開きます(図42-1)。

図42-1 システム・ページの横にある「カスタマイズ」リンク

3. デバイス・グループ用システム・ページのバリアントをカスタマイズするには、システム・ページのバリアントのアイコンを開いて、カスタマイズするデバイス・グループの「編集」をクリックします(図42-2)。

図42-2 デバイス・グループ用システム・ページのバリアントのカスタマイズ

4. ページを編集して保存します。

関連項目:

システム・ページの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のコンポーザでの構造ビューのページの編集に関する項を参照してください。

42.2.1 デバイス・グループ用システム・ページのページ・バリアントの作成

ページ・バリアントは、特定のデバイスのサイズや特徴を対象とした特定のデバイス・グループの既存ページの代替ビューです。ベース・ページとページ・バリアントには、同じURlとセキュリティ設定が指定されていますが、ベース・ページに対するコンテンツの変更は、どれもバリアント・ページに反映されません。逆の場合も同じです。

注意:

WebCenter Portalのデバイス設定の管理の詳細は、「デバイス設定の管理」を参照してください。

システム管理者のみが、アプリケーションレベルのシステム・ページに対してページ・バリアントを作成できます。ページ・バリアントがサポート対象のデバイス・グループに作成されていない場合、ベース・ページにはそのデバイス・グループに属するデバイスのみが表示されます。

初期設定では、次のシステム・ページについてのみページ・バリアントを作成できます。「エラーが発生しました」、「いずれのページにもアクセスできません」、「ページが見つかりません」、「ポータルが見つかりません」、「自己登録」、「サインイン」、「未許可」、「使用不可」および「WebCenter Portalようこそページ」。

使用可能な各デバイス・グループにページ・バリアントを作成できます。ただし、作成できるのは、ページごとに1つのデバイス・グループに対して1つのページ・バリアントのみです。つまり、同じページにiOSフォンのデバイス・グループのページ・バリアントを2つ作成することはできませんが、同じページにiOSフォンのデバイス・グループのページ・バリアントを1つ作成し、Androidフォンのデバイス・グループのページ・バリアントをもう1つ作成することは可能です。iOSフォンのデバイス・グループのページ・バリアントは別のページに作成できます。

デバイス・グループのシステム・ページのページ・バリアントを作成するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「システム・ページ」をクリックします。

ブラウザで次のURLを入力して、「システム・ページ」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/systempages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. ページ・バリアントを作成するシステム・ページの横にある「ページ・バリアントの作成」リンク(図42-3)をクリックします。

注意:

初期設定では、次のシステム・ページについてのみページ・バリアントを作成できます。「エラーが発生しました」、「いずれのページにもアクセスできません」、「ページが見つかりません」、「ポータルが見つかりません」、「自己登録」、「サインイン」、「未許可」、「使用不可」および「WebCenter Portalようこそページ」。

図42-3 システム・ページの横にある「ページ・バリアントの作成」リンク

3. 表示される「ページ・バリアントの作成」ダイアログで、「デバイス・グループ」ドロップダウン・リストからページ・バリアントを作成するデバイス・グループを選択します(図42-4)

ベース・ページがシステム内でシードされます。ベース・ページは、デフォルトのデバイス・グループに属するデバイスに対して常時レンダリングされています(デフォルトのデバイス・グループの詳細は、「デバイス設定の管理」を参照)。ページ・バリアントがデフォルトとしても設定されているデバイス・グループに対して存在している場合、そのベース・ページはページ・バリアントより優先されます。デスクトップ・ブラウザからページを開くと、デフォルトでデバイス・グループは「デスクトップ・ブラウザ」に設定されているため、「デスクトップ・ブラウザ」バリアントが作成されているかどうかにかかわらず、ベース・ページが表示されます。他のデバイスから開くと、選択したページ・バリアントが表示されます。

たとえば、iOSフォンをデフォルト・ページに変更すると、ベース・ページはそのデバイス・タイプに設定されます。iPhoneでは、ベース・ページが表示され、iOS Phonesページ・バリアントは表示されません。ただし、デスクトップ上には「デスクトップ・ブラウザ」のバリアントが表示され、ベース・ページは表示されません。デフォルトのデバイス・グループを変更しない場合、作成した「デスクトップ・ブラウザ」バリアントはデスクトップ・ブラウザに表示されません。その場合でも、ベース・ページはデスクトップに表示されます。

注意:

デフォルトのデバイス・グループを変更する場合には注意してください。ベース・ページまたはそのページ・バリアントをグローバルに表示する際にデフォルトの動作が変更されます。

図42-4 「ページ・バリアントの作成」ダイアログ

4. 「作成」をクリックします。

モバイル・アイコンが展開ボタンとともにページの横に表示され、そのページのページ・バリアントが使用できることを示します(図42-5)。

図42-5 ページ・バリアントが使用できることを示すアイコン

5. 「展開」ボタンをクリックして、デバイス・グループのページ・バリアントを表示します(図42-6)。

図42-6 デバイス・グループのページ・バリアント

同じページに別のデバイス・グループの別のページ・バリアントを作成できます。ただし、すでにページ・バリアントが作成されている同じデバイス・グループに別のページ・バリアントを作成することはできません。

6. ページ・バリアントを作成後には、次のいずれかを実行できます。

- デバイス・グループの横にある「編集」をクリックして、コンポーザでシステム・ページを編集します。
システム・ページの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のコンポーザでの構造ビューのページの編集に関する項を参照してください。

- デバイス・グループの横にある「削除」をクリックして、ページ・バリアントを削除します。「削除」を再びクリックして、削除を確定します。

- デバイス・グループの横にある「ソースの編集」をクリックして、ソース・コードを編集します。
詳細は、『Oracle WebCenter Portalでのポータルの構築』のページのソース・コードの表示と変更に関する項を参照してください。

42.2.2 デバイス・グループ用システム・ページのページ・バリアントの管理

デバイス・グループのページ・バリアント、およびシステム・ページのページ・バリアントの作成の詳細は、「デバイス・グループ用システム・ページのページ・バリアントの作成」を参照してください。

システム・ページのページ・バリアントを管理するには:

1. 「展開」アイコンをクリックして、デバイス・グループのページ・バリアントを表示します(図42-7)。

図42-7 デバイス・グループのページ・バリアント

2. コンポーザでページ・バリアントを編集するには、「編集」をクリックします。

システム・ページの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のコンポーザでの構造ビューのページの編集に関する項を参照してください。

3. ページ・バリアントを削除するには、「削除」をクリックします。

4. 「削除」を再びクリックして、削除を確定します。

5. ソース・コードを編集するには、「ソースの編集」をクリックします。

ページのソース・コードの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページのソース・コードの表示と変更に関する項を参照してください。

42.3 システム・ページのプロパティの設定

システム・ページのページ・プロパティには、ページの背景色とイメージを指定し、追加のCSSエンコーディングを適用し、パラメータを設定する手段が用意されています。

システム・ページのプロパティを編集するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「システム・ページ」をクリックします。

ブラウザで次のURLを入力して、「システム・ページ」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/systempages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. システム・ページの横の「カスタマイズ」リンクをクリックして、コンポーザでそれを開きます(図42-8)。

図42-8 システム・ページの横にある「カスタマイズ」リンク

3. 「ページ・プロパティ」アイコン(図42-9)をクリックして、「ページ・プロパティ」ダイアログを開きます(図42-10)。

関連項目:

システム・ページの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のコンポーザでの構造ビューのページの編集に関する項を参照してください。

図42-9 「ページ・プロパティ」アイコン

4. 「表示オプション」タブでプロパティを変更するには、『Oracle WebCenter Portalでのポータルの構築』のレイアウト・コンポーネントの使用に関する項を参照してください。

5. 「パラメータ」タブで(図42-10)、既存のパラメータを必要に応じて変更します(表42-2を参照)。

図42-10 「ページ・プロパティ」ダイアログ: パラメータ

注意:

すべてのパラメータ値は式言語(EL)エディタへのアクセス権を提供し、それを使用して定数値のかわりに変数値を選択または指定できます。値フィールドの横にある「編集」アイコンをクリックして「式ビルダー」を選択し、エディタを開きます。ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の式言語式に関する項を参照してください。

表42-2 システム・ページのパラメータ

パラメータ

説明

pg_pageTemplateID

システム・ページを表示する際に、以前のリリースのデフォルトのページ・テンプレートを使用するか、現在のリリースのデフォルトの空白テンプレートを使用するかを指定します。有効な値は次のとおりです。

- page_template_GUID。GUID値で指定したページ・テンプレートを使用します。

6. 新規パラメータを追加するには:

- 「ページ・パラメータの追加」をクリックします。

- 「ページ・パラメータの追加」ダイアログに、新規パラメータの「名前」を入力し、「パラメータの追加」をクリックして、値入力フィールドが表示される「パラメータ」タブにパラメータを追加します。

- オプションで、新規パラメータの値を入力します。

42.4 システム・ページからのすべてのページ・カスタマイズの削除

システム・ページをデフォルトの初期状態に戻すには、すべてのページのカスタマイズを削除します。

注意:

この処理では、タスク・フローのカスタマイズは削除されません。タスク・フローのカスタマイズを削除するには、システム・ページで指定されたタスク・フローを改訂する必要があります。詳細は、「タスク・フローのカスタマイズ」を参照してください。

システム・ページからすべてのカスタマイズを削除するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「システム・ページ」をクリックします。

ブラウザで次のURLを入力して、「システム・ページ」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/systempages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. システム・ページの横にある「デフォルトに戻す」リンクをクリックします(図42-11)。

図42-11 システム・ページの横にある「デフォルトに戻す」リンク

3. 表示された確認ダイアログで、「復元」をクリックします。

すべてのカスタマイズは、選択したシステム・ページから永続的に削除されます。システム・ページをそのデフォルト状態に戻す際に、そのシステム・ページにバリアントが作成されていても、ページ・バリアントは影響を受けません。

43 ビジネス・ロール・ページの管理

この章では、ビジネス・ロール・ページを作成してターゲット化する方法およびその他の関連するビジネス・ロール・ページ管理タスクを実行する方法について説明します。

この章の内容は次のとおりです。

- ビジネス・ロール・ページについて

- ビジネス・ロール・ページのためのページ作成のデフォルトの設定

- ビジネス・ロール・ページの作成

- ビジネス・ロール・ページの対象者の指定

- カスタム・ビジネス・ロール・ページへのアクセス権限の取消し

- ビジネス・ロール・ページの表示と非表示

- ビジネス・ロール・ページのデフォルトの表示順序の設定

- ビジネス・ロール・ページの編集

- ビジネス・ロール・ページのソースの編集

- ビジネス・ロール・ページのコピー

- ビジネス・ロール・ページ内のすべてのユーザー・カスタマイズの削除

- カスタム・ビジネス・ロール・ページの削除

権限

この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server: Manage AllまたはPortal Server: Manage Configuration

- Pages: Create, Edit, and Delete Pages

権限の詳細は、「アプリケーション・ロールおよび権限について」を参照してください。

43.1 ビジネス・ロール・ページについて

ビジネス・ロール・ページは、関連性の高いコンテンツを特定のユーザーに公開する方法を提供します。ビジネス・ロール・ページは、営業チーム、会計チーム、管理スタッフなどの特定のタイプのグループ、またはユーザー(あるいはユーザー・ロール)向けのページです。

ビジネス・ロール・ページは、WebCenter Portalシステム管理者がビジネス・ロール・ページを公開すると、ターゲットのビジネス・ロールを共有するすべてのユーザーのホーム・ポータル・ビューで使用できます。たとえば、HR_ORGロールを割り当てられたすべてのユーザーをターゲットにするビジネス・ロール・ページは、HR_ORGロールを割り当てられたすべてのユーザーのホーム・ポータル・ビューに表示されます。

ヒント:

ビジネス・ロール・ページがホーム・ポータル・ナビゲーションに表示されていても表示されていなくても、ターゲットのユーザーはこのページを「ページのパーソナライズ」ページで常に使用できます。シードされたビジネス・ロール・ページのリストは、「組込みビジネス・ロール・ページについて」を参照してください。

HR_ORGロールに割り当てられていない個人ユーザーにページを表示する場合、システム管理者はこのユーザーにアクセス権限を付与できます。シードされたビジネス・ロール・ページ(表43-1を参照)には、変更できない事前設定されたアクセス設定があります。シードされたビジネス・ロール・ページのアクセス設定を変更する方法の詳細は、「シードされたビジネス・ロール・ページのアクセス権限の設定」を参照してください。

システム管理者は、ビジネス・ロール・ページを作成できる唯一のユーザー・タイプです。その他のユーザーは、システム管理者が権限を付与した場合のみ、ビジネス・ロール・ページの編集、コピーおよび削除、ならびにページの権限の変更を行えます(詳細は、「ビジネス・ロール・ページのターゲット・ユーザーの指定」を参照)。

表43-1は、デフォルトのWebCenter Portalインストールに含まれているシードされたビジネス・ロール・ページのリスト、説明およびこれらが表示されるコンテキストの説明です。

これらのページは、WebCenter Portal偽装を除いて、「システム・ページ」ページにも表示されます(詳細は、「システム・ページのカスタマイズ」を参照)。

43.1.1 組込みビジネス・ロール・ページについて

表43-1は、WebCenter Portalの組込みビジネス・ロール・ページの一覧です。

表43-1 組込みビジネス・ロール・ページ

ページ

説明

コンテキスト

アクティビティ

「ピープル・コネクション」および「パブリッシャ」タスク・フローから「アクティビティ・ストリーム」を表示します。これはコンテンツをストリームに投稿するために使用できます。詳細は、『Oracle WebCenter Portalの使用』のポータル・アクティビティの追跡に関する項およびフィードバックおよびメッセージ・ボードでの作業に関する項を参照してください。

認証された(ログインしている)ユーザーそれぞれのホーム・ポータル・ビューにデフォルトで表示されます。

分析

WebCenter Portal、ポータル、ポートレットおよびサービスに関係のあるパフォーマンス・メトリックを表示します。詳細は、「Oracle WebCenter Portalのパフォーマンス・メトリックの理解」を参照してください。

デフォルトでは非表示ですが、ホーム・ポータルのシステム管理者のビューの「ページのパーソナライズ」ページでアクセスできます。

ドキュメント

「ドキュメント・エクスプローラ」タスク・フローを表示します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のタスク・フローの使用に関する項を参照してください。

デフォルトでは、認証されたユーザーそれぞれのホーム・ポータル・ビューに表示されます。

プロファイル

現在のユーザーの「プロファイル」を表示します。これには、「アクティビティ」、「コネクション」、「ドキュメント」、組織図(「組織」)およびユーザーのプロファイル詳細(「情報」)のサブページが含まれます。詳細は、『Oracle WebCenter Portalの使用』のプロファイルの管理に関する項、および『Oracle WebCenter Portalでのポータルの構築』のタスク・フローの使用に関する項を参照してください。

デフォルトでは、認証されたユーザーそれぞれのホーム・ポータル・ビューに表示されます。

ポータル

現在のユーザーと関係のあるポータルを表示します(ユーザーが属しているまたはユーザーがアクセス権限を持っているポータル、ユーザーが検索できるポータルなど)。リストされた各ポータルには、ポータルでアクションを実行するためのオプション付きの関連メニューがあります。このページでは、ポータルの作成および追加のポータルの検索を行うためのコントロールも提供します。

デフォルトでは、認証されたユーザーそれぞれのホーム・ポータル・ビューに表示されます。

ポータル・テンプレート

デフォルトおよびカスタムのポータル・テンプレートのリストを表示し、カスタム・ポータル・テンプレートを作成する方法およびテンプレートのリストをフィルタリングする方法を提供します。

デフォルトでは非表示ですが、認証された各ユーザーのホーム・ポータル・ビューの「ページのパーソナライズ」ページでアクセスできます。

タグ・センター

ユーザーがタグを管理できるようにするためのタグ・センターを表示します。詳細は、『Oracle WebCenter Portalの使用』のタグ付けのポータルへの追加に関する項を参照してください。

「タグ」タスク・フローまたは検索結果内のタグをユーザーがクリックしたときに動的に表示されます。

WebCenter Portal偽装

WebCenter Portalシステム管理者が、サポート担当者や他のポータル管理者などのユーザー(偽装者)のグループに偽装の権限を割り当てることができるページを表示します。こうすることによって、偽装者は他のユーザー(被偽装者)として操作を実行できます。詳細は、「偽装の管理」を参照してください。

(偽装者による)偽装セッションを開始する方法および(被偽装者による)偽装セッションを許可する方法の詳細は、『Oracle WebCenter Portalの使用』のWebCenter Portal偽装の使用に関する項を参照してください。偽装ELおよび偽装APIの詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のWebCenter Portal偽装ELおよび偽装APIの使用に関する項を参照してください。

WebCenter Portal偽装は、OAM 11g 11.1.2.0に依存しています。WebCenter Portalインスタンスのために偽装を有効化するには、その前にまずOAM 11g (Oracleのシングル・サインオン・ソリューション)をインストールして構成し、OAMで偽装を有効にする必要があります。OAM 11gのインストールと構成の詳細は、「Oracle Access Managerの構成」を参照してください。

43.2 ビジネス・ロール・ページのためのページ作成のデフォルトの設定

WebCenter Portalシステム管理者は、ページ作成のデフォルトを設定し、ビジネス・ロール・ページの作成に必要な手順の数を減らすことができます。つまり、「ページの作成」ダイアログを開いたときにデフォルトで選択されているページ・スタイルを指定できます。「ページの作成」ダイアログをバイパスすることも選択できます。こうすると、デフォルトのページ・スタイルが強制的に選択されます。

関連項目:

ビジネス・ロール・ページ用にシステム管理者が設定するページ作成のデフォルトは、個人用ページにも影響します。認証されたユーザーは、ホーム・ポータルで作成した独自の個人用ページのページ作成のデフォルトをオーバーライドできます(詳細は、『Oracle WebCenter Portalの使用』の個人用ページのページ作成のデフォルトの設定に関する項を参照)。ポータルで作成されるページのデフォルトは、ポータル・マネージャによって制御されます(詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル・ページの作成および編集に関する項を参照)。

ビジネス・ロール・ページのページ作成のデフォルトを設定するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。

ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/admin/settings/businessrolepages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「ページ・デフォルトの設定」をクリックして、「ページ・デフォルトの設定」ダイアログを開きます(図43-1)。

図43-1 「ページ・デフォルトの設定」ダイアログ

3. 「ページ・スタイル」ドロップダウン・リストからページ・レイアウトを選択します。

関連項目:

シードされたページ・スタイルの詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・スタイルについてに関する項を参照してください。このリストは、追加のカスタム・ページ・スタイルを含む場合や、ページ・スタイルを短いリストに制限している場合があります。

4. 「ワンクリック・ページ作成の有効化」のオプションを選択します。

- はい: 「ページの作成」ダイアログをバイパスし、指定した「ページ・スタイル」を使用してすべての個人用ページを作成します。

ヒント:

「ページの作成」ダイアログをバイパスしてページを作成する場合、新しいページは汎用名になります。ページ名の変更の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページの名前変更に関する項を参照してください。

- いいえ: 「ページの作成」ダイアログが表示され、指定した「ページ・スタイル」がすべての個人用ページの「ページの作成」ダイアログのデフォルトとして選択されます。新しい個人用ページに別のスタイルを選択できます。

5. 「保存」をクリックして変更を保存し、ダイアログを終了します。

43.3 ビジネス・ロール・ページの作成

注意:

個人用ページまたはビジネス・ロール・ページの「ページのコピー」アクションを選択して、これをビジネス・ロール・ページとしてコピーすることも可能です。詳細は、「個人用ページのコピー」および「ビジネス・ロール・ページのコピー」を参照してください。

新しいビジネス・ロール・ページを作成するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。

ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/admin/settings/businessrolepages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「作成」をクリックします(図43-2)。

図43-2 ビジネス・ロール・ページの「作成」オプション

ワンクリック・ページ作成を有効にしている場合、新しいページがリストに表示されます。ワンクリック・ページ作成を有効にしなかった場合、次の手順に進みます。

3. 「ページの作成」ダイアログで、一意のページ名を「ページ名」フィールドに入力し、「ページ・スタイル」を選択します(図43-3)。

図43-3 「ページの作成」ダイアログ

関連項目:

シードされたページ・スタイルの概要は、『Oracle WebCenter Portalでのポータルの構築』のページ・スタイルの使用に関する項を参照してください。

4. 「作成」をクリックします。

新しいページがビジネス・ロール・ページのリストに表示されます。

関連項目:

システム管理者は、カスタム・ページ・スタイルに属性を設定できます。この属性によって、そのスタイルに基づいて新しく作成されるページを、ページ編集モードで開くかページ表示モードで開くかを決めることができます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータル・アセットのプロパティの設定に関する項を参照してください。

後でページにコンテンツを追加できます。次の項(「ビジネス・ロール・ページのターゲット・ユーザーの指定」)では、ビジネス・ロール・ページのアクセス権限を設定する手順を説明します。

5. 次の手順を実行します。

- 「ビジネス・ロール・ページのターゲット・ユーザーの指定」の説明に従って、ページのユーザーを定義します。

- 「ビジネス・ロール・ページのデフォルトの表示順の設定」の説明に従って、ページの表示順を選択します。

- 『Oracle WebCenter Portalでのポータルの構築』のページでのWeb開発コンポーネントの使用に関する項の説明に従って、コンテンツをページに追加します。

43.4 ビジネス・ロール・ページのターゲット・ユーザーの指定

ビジネス・ロール・ページのターゲット・ユーザーはときどき変化する場合があります。たとえば、元々製品開発チーム用に設計したページをセールス・チーム全体に表示する必要が生じる場合があります。マーケティング部門のページにパブリック・アクセス権限を指定する必要が生じる場合があります。選択した部門のメンバーにEdit Pages権限などの追加のアクセス権限を付与する必要が生じる場合があります。

注意:

システム管理者は、作成するビジネス・ロール・ページのアクセス権限を設定できます(詳細は、「カスタム・ビジネス・ロール・ページのアクセス権限の設定」を参照)。

シードされたビジネス・ロール・ページ(表43-1を参照)のデフォルトのアクセス権限の設定は、WebCenter Portalのユーザー・インタフェースから変更できません。シードされたビジネス・ロール・ページのアクセス権限を設定する方法の詳細は、「シードされたビジネス・ロール・ページのアクセス権限の設定」を参照してください。

作成したビジネス・ロール・ページのアクセス権を設定するためのコントロールは、WebCenter Portal管理で見つけることができます(図43-4)。

図43-4 カスタム・ビジネス・ロール・ページの「ページのアクセス権限の設定」オプション

この項では、ビジネス・ロール・ページの特定のアクセス権限の設定方法およびページをパブリックにする方法について説明します。次のサブセクションが含まれます:

- カスタム・ビジネス・ロール・ページのアクセス権限の設定

- カスタム・ビジネス・ロール・ページへのパブリック・アクセス権限の付与

- シードされたビジネス・ロール・ページのアクセス権限の設定

43.4.1 カスタム・ビジネス・ロール・ページのアクセス権限の設定

システム管理者は、作成するビジネス・ロール・ページのアクセス権限を設定できます。ただし、WebCenter Portal管理のユーザー・インタフェースを使用して、シードされたビジネス・ロール・ページのアクセス権限を設定することはできません(シードされたビジネス・ロール・ページのアクセス権限の設定の詳細は、「シードされたビジネス・ロール・ページのアクセス権限の設定」を参照)。

作成したカスタム・ビジネス・ロール・ページのターゲット・ユーザーを指定するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。
ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/admin/settings/businessrolepages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. アクセス権限を設定しているカスタム・ビジネス・ロール・ページの「アクション」アイコンを選択してクリックし、「ページのアクセス権限の設定」を選択し(図43-4)、「ページのアクセス権限の設定」ダイアログを開きます(図43-5)。

図43-5 「ページのアクセス権限の設定」ダイアログ

3. 「認証済アクセス権限の追加」をクリックし、ページにアクセスするAuthenticated-userロールのすべてのユーザーを追加します。
authenticated-roleロール(WebCenter Portalにログインしているユーザー)が「ロールまたはユーザー」の下に追加されます。

4. すべてのパブリック・ユーザー(ログインしなかったユーザーおよびログインしていたユーザー)にアクセス権限を付与するには、「パブリック・アクセス権限の追加」をクリックします。
ロールanonymous-roleが「ロールまたはユーザー」の下に追加されます。

関連項目:

ビジネス・ロール・ページへのパブリック・アクセス権限を有効にするこの方法は、表示アクセス権限に加えてその他の権限をパブリック・ユーザーに付与する方法を提供します。このようなユーザーに表示アクセス権限のみを付与するには、「カスタム・ビジネス・ロール・ページへのパブリック・アクセス権限の付与」の手順に従って、これをすばやく設定できます。

5. 選択したユーザー、グループおよびアプリケーション・ロールにアクセス権限を付与するには、「アクセス権限の追加」をクリックします。
「アクセス権限の追加」ダイアログが開きます(図43-6)。

図43-6 「アクセス権限の追加」ダイアログ

6. ホーム・ポータルでこのビジネス・ロール・ページを公開するユーザー、グループおよびアプリケーション・ロールを特定します。
選択可能なすべてのユーザー、グループおよびアプリケーション・ロールから選択します。検索機能を使用してアイデンティティ・ストアを検索します。

a. 「検索」フィールドに、ユーザー、グループまたはアプリケーション・ロールの検索語を入力します。アイデンティティ・ストアの検索のヒントは、『Oracle WebCenter Portalでのポータルの構築』のアイデンティティ・ストアでのユーザーまたはグループの検索に関する項を参照してください。

ヒント:

この検索は大/小文字を区別しません。

b. 「検索」アイコンをクリックします。
検索条件と一致するユーザー、グループおよびアプリケーション・ロールが、「ユーザーの追加」ダイアログに表示されます。

c. リストから1つ以上の名前を選択します。
複数のユーザーを選択するには[Ctrl]を押しながらクリックします。

d. 「選択」をクリックします。
選択結果が、「ページのアクセス権限の設定」ダイアログに表示されます。デフォルトでは、選択したユーザーには「ページの表示」権限が付与されます。

7. ユーザー名、グループまたはアプリケーション・ロールそれぞれに対して、1つ以上のチェック・ボックスを選択してページの権限を付与します。

- ページの表示 - ユーザーはページを表示できますが、ページに対するアクションを実行できません。

- ページの編集 - ユーザーはページを編集できます。これには、コンテンツの追加、並べ替えおよび削除、ならびにページ・スキームの変更が含まれます。

- ページの削除 - ユーザーはページを削除できます。

- すべてのページ・アクションの実行 - ユーザーにはページに対する完全なアクセス権限があります。これらのユーザーは、ページの編集、ページ・レイアウトの改訂、他のユーザーに対する追加のアクセス権限の設定およびその他のすべてのページ権限の設定を実行できます。

- ページのパーソナライズ - ユーザーはページの個人用ビューを変更できます。このような変更は、ページの他のユーザーのビューには影響しません。

- ページへのアクセス権限を取り消すには、ユーザーまたはロールを選択し、「アクセス権限の削除」をクリックします。

ヒント:

権限を取り消すには、チェック・ボックスを選択解除します。

8. 「OK」をクリックして、変更を保存します。
このページは、ターゲット・ユーザーが次回WebCenter Portalにログインしたときにホーム・ポータルのビューに表示されます。

43.4.2 カスタム・ビジネス・ロール・ページへのパブリック・アクセス権限の付与

任意のユーザー(ログインしているかしていないかは不問)が、特定のカスタム・ビジネス・ロール・ページを表示できるように指定できます。このようなページをパブリック・ホーム・ポータルに公開できます。またはURLをパブリック・ビジネス・ロール・ページに公開し、すべてのユーザーが簡単にアクセスできるようにすることができます。

関連項目:

この項で説明するプロセスでは、すべてのパブリック・ユーザーが、選択したカスタム・ビジネス・ロール・ページを表示できます。パブリック・ユーザーにページの追加権限を付与するには、「シードされたビジネス・ロール・ページのアクセス権限の設定」で説明されている手順に従います。

カスタム・ビジネス・ロール・ページをパブリックにするには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。

ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/admin/settings/businessrolepages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. アクセス権限を設定しているビジネス・ロール・ページの「アクション」アイコンをクリックし、「パブリックにする」を選択します(図43-7)。

図43-7 カスタム・ビジネス・ロール・ページの「パブリックにする」オプション

43.4.3 シードされたビジネス・ロール・ページのアクセス権限の設定

初期設定のビジネス・ロール・ページ(「アクティビティ」および「ポータル」など)は、デフォルトですべてのユーザーが使用できます(表43-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_Portal',toLocation='/scratch/mdsdump', docs='/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/role/anonymous-role/pages.xml')

exportMetadata(application='webcenter',server='WC_Portal',toLocation='/scratch/mdsdump', docs='/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/role/authenticated-role/pages.xml')

ここで、toLocationはエクスポートするファイルのシステム上のターゲット・ディレクトリを指定します。構文の詳細は、『WebLogic Server WLSTコマンド・リファレンス』のexportMetadataに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「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_Portal',fromLocation='/scratch/mdsdump', docs='/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/role/anonymous-role/pages.xml')
importMetadata(application='webcenter',server='WC_Portal',fromLocation='/scratch/mdsdump', docs='/oracle/webcenter/page/scopedMD/s8bba98ff_4cbb_40b8_beee_296c916a23ed/role/authenticated-role/pages.xml')

ここで、fromLocationはインポートするファイルを含むディレクトリを指定します。構文の詳細は、『WebLogic Server WLSTコマンド・リファレンス』のimportMetadataに関する項を参照してください。

WLSTコマンドの実行方法の詳細は、「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の設定機能に戻ります。

43.5 カスタム・ビジネス・ロール・ページへのアクセス権限の取消し

カスタム・ビジネス・ロール・ページへのアクセス権限を取り消すには:

1. 「カスタム・ビジネス・ロール・ページのアクセス権限の設定」の手順に従い、「ページのアクセス権限の設定」ダイアログを開きます。

2. 「ロールまたはユーザー」から、アクセス権限を取り消すユーザー、グループまたはアプリケーション・ロールがある行を選択し、「アクセス権限の削除」をクリックします(図43-8)。

図43-8 「ページのアクセス権限の設定」ダイアログの「アクセス権限の削除」オプション

3. 確認ダイアログで「削除」をクリックします。

43.6 ビジネス・ロール・ページの表示および非表示

認可されたすべてのユーザーのホーム・ポータル・ナビゲーションでビジネス・ロール・ページを表示または非表示にする手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。

ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/admin/settings/businessrolepages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 表示または非表示にするページで次の手順を実行します(図43-9)。

- 「ページを表示」列のチェック・ボックスを選択し、認可されたユーザーのホーム・ポータル・ビューのページを表示します。

- 「ページを表示」列のチェック・ボックスを選択解除し、ビューのページを非表示にします。

図43-9 ビジネス・ロール・ページの「ページを表示」オプション

43.7 ビジネス・ロール・ページのデフォルトの表示順の設定

ビジネス・ロール・ページを論理的な順序で表示すると、ページのコンテンツにアクセスしやすくなり、ユーザーをナビゲートしやすくなります。WebCenter Portalシステム管理者は、ビジネス・ロール・ページがその対象ユーザーに表示される初期順序を決定できます。これを実行するには、ページをドラッグ・アンド・ドロップして目的の順序にするか、または「並替え」アイコンをクリックします。

個々のユーザーは、ホーム・ポータルの「ページのパーソナライズ」ページで指定した初期表示順序を変更できます。また、使用しないビジネス・ロール・ページを非表示にできます。

注意:

ページの順序と表示/非表示を定義する場所は2箇所あります。WebCenter Portal管理(ここで説明)と「ページのパーソナライズ」ページ(『Oracle WebCenter Portalの使用』のホーム・ポータルのページ順の並替えに関する項で説明)です。2つの違いは、管理の変更はアプリケーションのカスタマイズであり、「ページのパーソナライズ」の変更はユーザー・カスタマイズであることです。ユーザー・カスタマイズは、該当するユーザーのビューではアプリケーションのカスタマイズより優先されます。

ビジネス・ロール・ページの表示順を変更するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。

ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/admin/settings/businessrolepages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. ビジネス・ロール・ページを選択し、「並替え」列の矢印をクリックし、表示順を変更します(図43-10)。

図43-10 ビジネス・ロール・ページの「並替え」アイコン

かわりに、ページをドラッグ・アンド・ドロップして目的の順序にできます。

43.8 ビジネス・ロール・ページの編集

ビジネス・ロール・ページのEdit Page権限を付与されたユーザーであれば誰でもそのページを編集できます。これらのユーザーにとって、編集プロセスは通常のページと同じです(詳細は、『Oracle WebCenter Portalでのポータルの構築』のページの編集に関する項および『Oracle WebCenter Portalの使用』の個人用ページの編集に関する項を参照)。

WebCenter Portalシステム管理者は、ビジネス・ロール・ページの編集を開始することも可能です。

カスタム・ビジネス・ロール・ページを編集する手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。

ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/admin/settings/businessrolepages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. ページを選択し、編集するページの「アクション」アイコンをクリックし、「ページの編集」を選択します(図43-11)。

図43-11 カスタム・ビジネス・ロール・ページの「編集」オプション

コンポーザでページが編集モードで開きます。コンポーザでのページの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページの編集に関する項を参照してください。

3. ページを編集し、「保存」、「閉じる」の順にクリックして終了します。

43.9 ビジネス・ロール・ページのソースの編集

ビジネス・ロール・ページのEdit Page権限がある場合は、コンポーザでページを開かずにページのソースを編集できます。

カスタム・ビジネス・ロール・ページのソースを編集する手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。

ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/admin/settings/businessrolepages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. ソースを編集するカスタム・ページの「アクション」アイコンをクリックし、「ソースの編集」を選択します(図43-12)。

図43-12 カスタム・ビジネス・ロール・ページの「ソースの編集」オプション

「ソースの編集」ダイアログが開きます(図43-13)。

図43-13 「ソースの編集」ダイアログ

3. 必要に応じてページのソースを編集します。

ページのソースの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページのソース・コードの表示および変更に関する項を参照してください。

4. 「OK」をクリックします。

43.10 ビジネス・ロール・ページのコピー

ビジネス・ロール・ページをコピーすると、これを別のビジネス・ロール・ページとして保存したり、ホーム・ポータルのビューに個人用ページとして保存することができます。別のビジネス・ロール・ページをコピーする場合、アクセス権限は元のページからコピーされないため、その新しいページについてアクセス権限を設定する必要があります(詳細は、「ビジネス・ロール・ページのターゲット・ユーザーの指定」を参照)。カスタム・ビジネス・ロール・ページはコピーできません。

シードされたビジネス・ロール・ページをコピーするには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。

ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/admin/settings/businessrolepages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. ページを選択し、コピーするページの「アクション」アイコンをクリックし、「ページのコピー」を選択します(図43-14)。

図43-14 シードされたビジネス・ロール・ページの「ページのコピー」オプション

3. 「ページのコピー」ダイアログで、新しいページの名前を入力します(図43-15)。

図43-15 「ページのコピー」ダイアログ

4. 「名前を付けてコピー」の横で、ページのコピーが個人用ページかビジネス・ロール・ページかを指定します。

- コピーを同じジョブ・ロールの人のグループに公開する場合、「ビジネス・ロール・ページ」を選択します。

- 自分のビューにのみコピーを公開(つまり、ホーム・ポータルのビューに個人用ページとして公開)する場合、「個人用ページ」を選択します。

5. 「OK」をクリックします。

コンポーザでページが編集モードで開きます。コンポーザでのページの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページの編集に関する項を参照してください。

6. 必要に応じてページを編集し、「保存」をクリックして終了します。

43.11 ビジネス・ロール・ページからのすべてのユーザー・カスタマイズの削除

選択したビジネス・ロール・ページから、すべてのユーザー・カスタマイズを削除する制御を使用できます。この制御を使用すると、タスク・フローの並べ替え、サイズ変更、折りたたみなどの個人の変更が削除されます。これは、ビジネス・ロール・ページのユーザーごとの個人用ビューで実行します。

カスタム・ビジネス・ロール・ページのすべてのビューからすべてのユーザー・カスタマイズを削除する手順は次のとおりです。

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。

ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/admin/settings/businessrolepages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. ターゲット・ページの横の「アクション」メニューから「パーソナライズの削除」を選択します。

3. 結果として表示される確認ダイアログで、「OK」をクリックします。

ユーザーによってページの自分のビューに追加されたすべてのユーザー・カスタマイズが削除されます。つまり、タスク・フローが元の位置に戻って、元のサイズになったり、折りたたまれていたタスク・フローが開いたりします。

43.12 カスタム・ビジネス・ロール・ページの削除

カスタム・ビジネス・ロール・ページのDelete Page権限を付与されたユーザーであれば誰でもそのページを削除できます。これらのユーザーにとって、このプロセスは通常のページの削除と同じです(詳細は、『Oracle WebCenter Portalでのポータルの構築』のページの削除に関する項を参照)。WebCenter Portalシステム管理者は、カスタム・ビジネス・ロール・ページを削除できます。

注意:

シードされたビジネス・ロール・ページ(表43-1を参照)は、システム管理者でも削除できません。

カスタム・ビジネス・ロール・ページをWebCenter Portalから削除すると、これをリカバリすることはできません。削除したページは永続的に削除され、このページに以前割り当てられたユーザーは、ホーム・ポータルのビューにこれを表示できなくなります。

カスタム・ビジネス・ロール・ページを削除するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「ビジネス・ロール・ページ」をクリックします。

ブラウザに次のURLを入力して「ビジネス・ロール・ページ」に直接移動することも可能です。

http://host:port/webcenter/portal/admin/settings/businessrolepages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 削除するページの「アクション」アイコンをクリックし、「ページの削除」を選択します(図43-16)。

図43-16 カスタム・ビジネス・ロール・ページの「ページの削除」オプション

3. 確認ダイアログで、「削除」をクリックします。

44 個人用ページの管理

この章では、WebCenter Portalで個人用ページを管理する方法について説明します。個人用ページのコンテンツを管理する責任は主として個人にありますが、WebCenter Portalシステム管理者もデフォルトではすべての個人用ページにアクセスできます。システム管理者は、個人用データの所有者が個人用ページに関して問題を抱えた場合や組織を去った場合に個人用データのクリーンアップや管理を行う必要がある場合があります。

この章の内容は次のとおりです。

- 個人用ページの管理について

- 個人用ページのためのアプリケーションレベルのページ作成のデフォルトの設定

- ユーザーによる個人用ページの作成の防止

- 個人用ページへのナビゲーションの提供

- 個人用ページのアクセス権限の変更

- 個人用ページの編集

- 個人用ページのソースの編集

- 個人用ページのコピー

- 個人用ページ内のすべてのユーザー・カスタマイズの削除

- 個人用ページの削除

権限

この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server: Manage AllまたはPortal Server: Manage Configuration

- Pages: Create, Edit, and Delete Pages

権限の詳細は、「アプリケーション・ロールおよび権限について」を参照してください。

44.1 個人用ページの管理について

個人用ページは、ユーザーがホーム・ポータルの個人用ビューに作成するページです。WebCenter Portalシステム管理者は、他のユーザーが作成したすべての個人用ページに対する完全なアクセス権限を持っています。完全なアクセス権限とは、任意のユーザーの個人用ページに対して編集、コピー、名前の変更、アクセス権限の設定、削除などのアクションを実行できることを意味します。

システム管理者は、すべての人の個人用ページに、WebCenter Portal管理の「個人用ページ」ページからアクセスできます。リストされた各ページに関連付けられた「アクション」メニューは、ページ・エディタでの編集、ユーザー・カスタマイズの削除、コピー、名前変更、保護、ソースの編集、削除、および個人用ページのパブリック化のためのオプションへのアクセスを提供します(図44-1)。

図44-1 個人用ページのページの「アクション」メニュー

その他のオプションには、ページへのリンクを含むメール・メッセージの送信やページに関する情報の表示があります。

44.2 個人用ページのためのアプリケーションレベルのページ作成のデフォルトの設定

認可されたユーザーが自分用に設定できるページ作成のデフォルト(『Oracle WebCenter Portalの使用』の個人用ページのページ作成デフォルトの設定に関する項を参照)に加えて、システム管理者は個人用ページのためにアプリケーションレベルのページ作成のデフォルトを設定できます。ページ作成のデフォルトを構成した後、アプリケーションレベルのページ作成のデフォルトは、すべての個人用ページの作成に影響します。この制御(「ページ・デフォルトの設定」)は、WebCenter Portal管理の「ビジネス・ロール・ページ」で使用できます(詳細は、「ビジネス・ロール・ページのためのページ作成のデフォルトの設定」を参照)。

注意:

ホーム・ポータルの「ページのパーソナライズ」ページを使用して認可されたユーザーが自分用に設定したページ作成のデフォルトは、この章で説明するアプリケーションレベルの設定より優先されます。

44.3 ユーザーによる個人用ページの作成の防止

アプリケーションレベルのPages: Create Pages権限は、ユーザーがホーム・ポータルに個人用ページを作成できます。個々のユーザーからこの権限を取り消して、ユーザーが個人用ページを作成できないようにすることができます。詳細は、次を参照してください。

ユーザーに権限を割り当てるには、ユーザーに必要な権限を含むロールを割り当てます。Pages: Create Pages権限を含む(または除外する)ロールをユーザーに割り当てるには、「アプリケーション・ロールへのユーザー(およびグループ)の割当て」を参照してください。

44.4 個人用ページへのナビゲーションの提供

ポータルのナビゲーションで個人用ページへのリンクを追加する場合、『Oracle WebCenter Portalの使用』の個人用ページの作成および管理に関する項を参照してください。ポータル・ナビゲーションでの作業の詳細は、『Oracle WebCenter Portalでのポータルの構築』のナビゲーション・タスク・フローのプロパティの使用に関する項を参照してください。

44.5 個人用ページのアクセス権限の変更

システム管理者は、すべての個人用ページを表示および管理する権限があります。通常ページの所有者は、ページを表示できる人を決定できますが、システム管理者は、他のユーザーが作成した個人用ページすべてにデフォルトでアクセスできます。

個人用ページのアクセス権限を変更するには:

1. 「設定」タブ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「個人用ページ」をクリックします。
ブラウザに次のURLを入力して直接「個人用ページ」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/personalpages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 保護するページの「アクション」アイコンをクリックし、「ページのアクセス権限の設定」を選択します(図44-1を参照)。
「ページのアクセス権限の設定」ダイアログが開きます(図44-2を参照)。

図44-2 「ページのアクセス権限の設定」ダイアログ

3. 認証されたユーザーに対してアクセス権限を設定するには、「認証済アクセス権限の追加」をクリックします。
ロールauthenticated-roleが「ロールまたはユーザー」の下に追加されます(図44-3)。これを使用して、アクセス権限をWebCenter Portalにログインしているすべてのユーザーに設定します。

図44-3 認証されたロールのアクセス権限

新しく追加されたロールには「表示」アクセス権限のみがあることに注意してください。その他の権限をユーザー・ロールに適切に設定します。

4. パブリック・ユーザーに対してアクセス権限を設定するには、「パブリック・アクセス権限の追加」をクリックします。
ロールanonymous-roleが「ロールまたはユーザー」の下に追加されます(図44-4)。これを使用して、アクセス権限をWebCenter Portalにログインしていないすべてのユーザーに設定します。

図44-4 匿名ロールのアクセス権限

新しく追加されたロールには「表示」アクセス権限のみがあることに注意してください。その他の権限をユーザー・ロールに適切に設定します。匿名ロールは「表示」アクセス権限のみのままにしておくことをお薦めします。

5. 他のユーザーおよびロールにアクセス権を付与するには、「アクセス権限の追加」をクリックし、「アクセス権限の追加」ダイアログを開きます(図44-5)。

図44-5 「アクセス権限の追加」ダイアログ

6. このページにアクセスできるユーザーを特定します。
選択可能なすべてのユーザー、グループおよびアプリケーション・ロールから選択します。検索機能を使用してアイデンティティ・ストアを検索します。

a. 「検索」フィールドで、2文字以上入力し、「検索」アイコンをクリックします。アイデンティティ・ストアの検索のヒントは、『Oracle WebCenter Portalでのポータルの構築』のアイデンティティ・ストアでのユーザーまたはグループの検索に関する項を参照してください。

ヒント:

この検索は大/小文字を区別しません。

検索条件と一致するユーザー、グループおよびロールが、「アクセス権限の追加」ダイアログに表示されます。

b. リストから1つ以上の名前を選択します。
複数のユーザーを選択するには[Ctrl]を押しながらクリックします。

c. 「選択」をクリックします。
選択したユーザーおよびグループが、「ページのアクセス権限の設定」ダイアログに表示されます。デフォルトでは、ユーザーにはページに対する「ページの表示」権限があります。その他の権限を適切に設定します。

7. 現在のユーザーまたはロールに割り当てられた権限を変更するには、1つ以上のチェック・ボックスを選択し、ページの権限を付与します。

- ページの表示 - 選択したユーザーまたはロールはページにアクセスして表示できますが、ページに対するアクションを実行できません。

- ページの編集 - 選択したユーザーまたはロールはページを編集できます。これには、コンテンツの追加、並べ替えおよび削除が含まれます。

- ページの削除 - 選択したユーザーまたはロールはページを削除できます。

- すべてのページ・アクションの実行 - 選択したユーザーまたはロールにはページに対する完全なアクセス権限があります。ユーザーは、ページの編集、ページ・レイアウトの改訂、他のユーザーに対する追加のアクセス権限の設定およびその他のすべてのページ権限の設定を実行できます。

- ページのパーソナライズ - 選択したユーザーまたはロールはページをパーソナライズできます。パーソナライズとは、表示モードでのページに対して行われた変更です。このような変更は、ページの他のユーザーのビューには影響しません。

ヒント:

同じ手順を実行し、リストされたユーザーまたはロールに対する1つ以上の権限を選択解除することによって権限を取り消すことができます。

8. ページへのアクセス権限を取り消すには、ロールまたはユーザーを選択し、「アクセス権限の削除」をクリックします。

9. 「OK」をクリックします。

44.6 個人用ページの編集

システム管理者は、ユーザーがホーム・ポータルのビューに作成した個人用ページを表示および変更する権限があります。個人用ページのコンテンツの編集は主に個人が行いますが、システム管理者がそのようなコンテンツを編集する必要がある場合があります。「個人用ページのソースの編集」も参照してください。

個人用ページを編集するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「個人用ページ」をクリックします。

ブラウザに次のURLを入力して直接「個人用ページ」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/personalpages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 編集するページの「アクション」アイコンをクリックし、「ページの編集」を選択すると(図44-1を参照)、ページ・エディタでページが開きます。

関連項目:

ページの編集の詳細は、『Oracle WebCenter Portalでのポータルの構築』のページの編集に関する項を参照してください。

3. ページを更新し、「保存」、「閉じる」の順にクリックして終了します。

44.7 個人用ページのソースの編集

ページ・エディタでページを開かずに個人用ページのソースを編集できます。

個人用ページのソースを編集するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「個人用ページ」をクリックします。

ブラウザに次のURLを入力して直接「個人用ページ」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/personalpages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. ソースを編集するページの「アクション」アイコンをクリックし、「ソースの編集」を選択すると(図44-1)、「ソースの編集」ダイアログが開きます(図44-7)。

図44-6 「ソースの編集」ダイアログ

3. 必要に応じてページのソースを編集します。

4. 「OK」をクリックします。

44.8 個人用ページのコピー

システム管理者は、Oracle WebCenter Portalの任意のページをコピーする権限があります。これには、他のユーザーが作成した個人用ページのコピーも含まれます。管理者として個人用ページをコピーするとき、これをビジネス・ロール・ページとして保存して他のユーザーにプッシュしたり、ホーム・ポータルの独自のビューに個人用ページとして保存することができます。

ヒント:

別のビジネス・ロール・ページを作成する場合、アクセス権限は元のページからコピーされないため、その新しいページについてアクセス権限を設定する必要があります。詳細は、「ビジネス・ロール・ページのターゲット・ユーザーの指定」を参照してください。

個人用ページをコピーするには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「個人用ページ」をクリックします。

ブラウザに次のURLを入力して直接「個人用ページ」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/personalpages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. コピーするページの「アクション」アイコンをクリックし、「ページのコピー」を選択すると(図44-1)、「ページのコピー」ダイアログが開きます(図44-7)。

図44-7 「ページのコピー」ダイアログ

3. 新しいページの名前を入力します。

4. 「名前を付けてコピー」の横で、コピーが個人用ページかビジネス・ロール・ページかを指定します。

- 同じジョブ機能を持つ人のグループまたは同じエンタープライズ・グループに属する人がページを使用できるようにする場合、「ビジネス・ロール・ページ」を選択します。

- 自分のビューのみにコピーを公開する場合、「個人用ページ」を選択します。

ページのコピーの詳細は、『Oracle WebCenter Portalでのポータルの構築』のページのコピーに関する項を参照してください。

5. 「OK」をクリックします。

44.9 個人用ページからのすべてのユーザー・カスタマイズの削除

選択した個人用ページからすべてのユーザー・カスタマイズを削除する制御を使用できます。この制御を使用すると、タスク・フローの並べ替え、サイズ変更、折りたたみなどの個人の変更が削除されます。この変更は、ページの各ユーザーの個人用ビューに影響します。

個人用ページのすべてのビューからすべてのユーザー・カスタマイズを削除するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「個人用ページ」をクリックします。

ブラウザに次のURLを入力して直接「個人用ページ」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/personalpages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. ターゲット・ページの「アクション」アイコンをクリックし、「パーソナライズの削除」を選択します(図44-1)。

3. 結果として表示されるダイアログで、「OK」をクリックします。

ページのユーザー独自のビューにユーザーによって追加されたすべてのユーザー・カスタマイズが削除されます。つまり、タスク・フローが元の位置およびサイズに戻ったり、折りたたまれていたタスク・フローが開いたりします。

44.10 個人用ページの削除

他のユーザーが作成した個人用ページに対する完全なアクセス権限に加えて、WebCenter Portalシステム管理者は必要に応じてこれらを削除することも可能です。

注意:

個人用ページを削除すると、これをリカバリすることはできません。

個人用ページを削除するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「個人用ページ」をクリックします。

ブラウザに次のURLを入力して直接「個人用ページ」ページに移動することも可能です。

http://host:port/webcenter/portal/admin/settings/personalpages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 削除するページの「アクション」アイコンをクリックし、「ページの削除」を選択します(図44-1)。

3. 確認ダイアログで、「削除」をクリックします。

45 デバイス設定の管理

この章では、WebCenter Portalでデバイス設定を管理する方法について説明します。デバイス設定を使用すると、デスクトップのブラウザ、スマートフォン、タブレットなど様々なデバイスでポータルがレンダリングする方法を制御できます。

この章の内容は次のとおりです。

- デバイス設定について

- デバイスの作成および管理

- デバイス・グループの作成および管理

- デバイスおよびデバイス・グループのライフ・サイクルの管理

- デバイスのプレビュー

- デバイス設定のガイドラインおよびベスト・プラクティス

- デバイス属性の検出: サンプル・タスク・フロー

権限

この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server: Manage AllまたはPortal Server: Manage Configuration

権限の詳細は、「アプリケーション・ロールおよび権限について」を参照してください。

45.1 デバイス設定について

デバイス設定を正常に管理するには、この項で説明する概念に精通している必要があります。

- デバイス設定の概要

- デバイスとは何か。

- デバイス・グループとは何か。

- その他の関連概念

- 基本的なユースケース: 新しいデバイスのサポートの追加

- デバイス設定を適用する方法の理解

45.1.1 デバイス設定の概要

エンタープライズ・ポータル・ユーザーは、スマートフォン、タブレット、デスクトップのブラウザなど様々なデバイスからポータルにアクセスします。デバイス設定および関係する機能を使用すると、ポータル・ページを様々なデバイスに正確にレンダリングする方法を制御できます。システム管理者は、新しいタイプのデバイスのサポートやポータル・ページを特定のデバイスにレンダリングする方法の変更や向上を求められる場合があります。

WebCenter Portalには、ある特定のリクエストがどのタイプのデバイスから送信されるのかを認識し、該当するデバイスにポータルを適切にレンダリングする機能があります。システム管理者は、デバイス設定を使用して、このデバイス認識を変更または調整するとともに、特定のデバイスまたはデバイス・クラスに関連付けるページ・テンプレートおよびスキンを指定します。これは、スキンとテンプレートを正確に割り当てる方法を制御するデバイス設定を通して行います。

初期設定でWebCenter Portalには、スマートフォン、タブレットまたはデスクトップのブラウザのような一般的なデバイス・クラスに合わせてレンダリングするように設計されているいくつかのページ・テンプレートが用意されています。これらのテンプレートをそのまま使用したり、必要に応じてこれらを変更したり、新しいものを作成したりできます。

システム管理者として、次の場合にデバイス設定の使用を検討します。

- 新しいデバイスまたはデバイス・クラスに対するレンダリングのサポートを追加する必要がある場合。

- デバイスまたはデバイス・クラスにポータル・ページをレンダリングする方法で問題が検出された場合。

- ポータル開発者がデバイス固有のページを作成し、これが検出されず、ターゲット・デバイスに表示されないことがわかった場合。

45.1.2 デバイスとは何か

デバイスとは、WebCenter Portalでは、スマートフォンやタブレットなどの、ユーザーがポータルとやり取りするために使用する物理的デバイスを意味します。ポータル・ページがリクエストされるたびに、WebCenter Portalはリクエスト元のデバイスのタイプを判断します。この情報によって、ポータルは、デバイスが関連付けられているデバイスのカテゴリつまり「デバイス・グループ」を判断できます。「デバイス・グループとは何か」を参照してください。

WebCenter Portalには、iPhone、iPad、iPad mini、Samsung Galaxy Nexus、Samsung Galaxy Note 10.1など、すぐに使用できる多数の事前構成済のデバイスが付属しています。必要に応じて新しいデバイスを作成することも可能です。

図45-1に、WebCenter Portal管理にリストされたいくつかのデフォルトのデバイスを示します。

図45-1 管理者用デバイスのリスト

各デバイスには、3つの主要な特性(名前、表示名およびユーザー・エージェント文字列)があります。

- 名前: デバイスの一意の名前。特定のユースケースでは、この名前を使用することにより、式言語の式を使用して開発者がこれを検出することができます。

- 表示名: この名前は、WebCenter Portalのユーザー・インタフェースに表示されます。

- ユーザー・エージェント: リクエスト元のデバイスを識別するために使用する正規表現の文字列。たとえば、.*iPhone.+3G.+OS.+2_2.*などの表現は、iPhone 3Gの様々なバージョンに対応します。

注意:

ユーザー・エージェント文字列は正規表現であり、Javaプラットフォーム(java.util.regex.Pattern)によって指定された構文に準拠しています。したがって、ある特殊文字を照合する場合、これらに対してエスケープ文字を使用する必要がある場合があります。これらの文字には[\^$.|?*+()などがあり、場合によっては中括弧文字{}も含まれます。たとえば、丸括弧には、\(iPhone; CPU iPhone OS 5_0 like Mac OS X\)のようにエスケープ文字「\」を使用する必要があります。詳細は、正規表現構文に関する優れたリファレンスを読むことをお薦めします。

システム管理者は、新しいデバイスの作成および既存のものの管理を実行できます。たとえば、ユーザー・エージェント文字列を変更し、新しいバージョンのデバイスを正しく識別することが必要になる場合があります。または、必要に応じて新しいデバイスを作成することが必要になる場合があります。詳細は、「デバイスの作成および管理」を参照してください。

45.1.3 デバイス・グループとは何か。

デバイス・グループとは、同様の表示要件を共有する一連のデバイスを意味します。初期設定のWebCenter Portalには、デスクトップのブラウザ、iOSフォン、Androidフォン、iOSタブレット、Androidタブレットなどのいくつかの事前構成済デバイス・グループが付属しています。

デバイス・グループには適切なデバイスが含まれます。たとえば、iOSフォン・デバイス・グループには、iPhone、iPhone 3G、iPhone 3GS、iPhone 4、iPhone 4Sなどが含まれます。さらにデバイスを作成するとき、これらを既存のグループに追加したり、必要に応じて新しいグループを作成したりできます。

デバイス・グループの利点は、サポートされるデバイスごとに表示アセット(ページ・テンプレートおよびスキン)を構成する必要がないことです。そうではなく、複数の関連デバイスをグループに追加して、それらのデバイスが使用するアセットを指定できます。図45-2に、デバイス・グループの「管理」ページを示します。このページを使用すると、デバイス・グループに対して、作成、編集、コピー、アップロードなどの操作を実行できます。詳細は、「デバイス・グループの作成および管理」を参照してください。

図45-2 WebCenter Portal管理: 「デバイス設定」ページ

45.1.4 その他の関連概念

次の機能はデバイス設定と関係があります。これらには、デフォルトのデバイス・グループ、ページ・バリアントおよびフォールバック・ページなどがあります。

- デフォルトのデバイス・グループ: 常に1つのデバイス・グループがデフォルトとして指定されます。初期設定では、デフォルトのデバイス・グループはデスクトップのブラウザです。つまり、デフォルトでは、新しいポータルのすべてのページはデスクトップのブラウザのデバイス・グループに関連付けられます。認識されていないデバイスからリクエストが来ると、ポータル・ページは、デフォルトのデバイス・グループ設定に従ってレンダリングされます。

注意:

ベース・ページは、常にデフォルトのデバイス・グループに属しているデバイスでレンダリングされます。

デフォルトのデバイス・グループは、ポータルのテンプレート機能と関連付けられています(ポータルのテンプレートは新しいポータルの基盤となるテンプレートです)。ポータルのテンプレートから作成されるポータルは、そのテンプレートのデフォルトのデバイス・グループを自動的に受け取ります。同様に、ポータルからポータルのテンプレートを作成する場合、そのポータルに関連付けられたデフォルトのデバイス・グループがテンプレートに配置されます。

使用するデバイス・グループをWebCenter Portalが選択する方法の詳細は、「デバイス設定を適用する方法の理解」を参照してください。

- ページ・バリアント: ページ・バリアントとは、特定のデバイスで使用するために設計された、既存または「ベース」のページの代替ビューです。バリアントの派生元のベース・ページとページ・バリアント自体は、同じURI、セキュリティ設定、パラメータなどを持っていますが、これらは、ターゲット・デバイスに対して適切な特定のレンダリング特性を使用して設計されます。ページ・バリアントを作成するとき、これに関連付けるデバイス・グループおよびページ・スタイルを指定できます。
ページ・バリアントにはいくつかの使用法があります。会社のイントラネットのポータル・ページの1つが、特定のデバイスに対してエラーを返すことがわかったとします。たとえば、そのようなエラーが、フラッシュ・ビデオを含むページをAppleのデバイスでレンダリングするときに発生するとします。この場合、ページがAppleのデバイス用にリクエストされた場合のみ使用し、その他のデバイス用には使用しないようなページのバリアントを作成できます。この場合、バリアントには、おそらくフラッシュ・ビデオのかわりにイメージが含まれ、エラーは表示されなくなります。

ページ・バリアントは、通常、アプリケーションのスペシャリストによって作成されますが、管理者のみがシステム・ページのページ・バリアントを作成できます。たとえば、スマートフォンに適したログイン・ページ・バリアントを作成できます。

システム・ページのページ・バリアントの作成の詳細は、「デバイス・グループ用システム・ページのページ・バリアントの作成」を参照してください。ポータル・ページのページ・バリアントの作成の詳細は、『Oracle WebCenter Portalでのポータルの構築』のデバイス・グループのページ・バリアントの作成に関する項を参照してください。

- フォールバック・ページ: もう一つの関連概念はフォールバック・ページです。ページにページ・バリアントがない場合には、常にベース・ページがデフォルトでレンダリングされますが、この動作をオーバーライドしてこの状況でページを表示しないようにできます。

注意:

ページのフォールバック動作が、「ページを表示しない」に設定されている場合、そのページへのナビゲーション・リンクはすべてビューで非表示になります。言い換えると、メッセージ「デバイスで使用できるページがありません」という結果になるすべてのナビゲーション・リンクは、ユーザーに表示されません。

個別ページまたはすべてのポータル・ページに対してフォールバックを設定できます。フォールバックの詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・バリアントが存在しない場合の特定ページのページ動作の設定に関する項を参照してください。

45.1.5 基本的なユースケース: 新しいデバイスのサポートの追加

ここでは、管理するポータルのデバイス設定で作業する必要がある場合に理解を助けるユースケースを説明します。

現在サポートしているタブレット・デバイスとは異なる画面解像度およびサイズを備えた新しいミニタブレットがリリースされたとします。実際に、ユーザーは、会社のイントラネット・ポータルがこのデバイスで正しくレンダリングされないことに気付きます。つまり、空白が多く、会社のロゴが正しく表示されません。この新しいデバイスのサポートを求められています。この場合、基本的な手順は次のようになります。

1. このデバイスがポータルに送信するユーザー・エージェント文字列を検出します。

2. 新しいデバイスのユーザー・エージェント文字列と一致するユーザー・エージェント文字列を持つ新しいデバイスを作成します。「新しいデバイスの作成」を参照してください。

3. 同様のレンダリング特性を新しいデバイスと共有するすべてのデバイス用のデバイス・グループを作成します。この場合、デバイス・グループは、新しいタブレットと同様の表示特性を持つデバイスを保持することになります。「デバイス・グループの作成」を参照してください。

4. 適切なスキンおよびページ・テンプレートをデバイス・グループに適用します。必要に応じて、新しいアセットを一から作成するか、または既存のものをコピーして変更します。

5. 新しいデバイスをデバイス・グループに追加します。

6. 新しいデバイスに関してポータルをテストし、正しくレンダリングされることを確認します。

7. 同様のミニタブレット・デバイスがリリースされた場合、同じグループに追加できます。

45.1.6 デバイス設定を適用する方法の理解

図45-3に、WebCenter Portalが複数の異なるデバイスからのリクエストを処理する方法のフローを説明します。

図45-3 ポータルが異なるデバイスからのリクエストを処理する方法

図45-3に示すように、リクエストがサーバーに送られると、リクエストのヘッダーにあるユーザー・エージェント文字列が調べられます。次に、WebCenter Portalは、そのユーザー・エージェント(正規表現の文字列)と一致するデバイスを探します。

ユーザー・エージェントが着信ユーザー・エージェントに潜在的にマップできるデバイスが複数定義されている場合、サーバーはリクエストを最適なデバイスにマップしようとします。最適なデバイスとは、そのユーザー・エージェントに最大限の一致が含まれるデバイスです。

デバイスが特定されると、WebCenter Portalは、これがデバイス・グループにあるかどうかを確認します。複数のグループに存在する場合、ポータルのデバイス・グループのリストの最初のものを使用します。「デバイス・グループの順序付け」も参照してください。

デバイスが特定されない場合、WebCenter Portalは「デフォルトのデバイス・グループ」を現在のリクエストに割り当てます。

最後に、そのデバイス・グループに関連付けられた適切なスキン、ページ・テンプレートおよびページ・バリアント(存在する場合)が返され、ページがデバイスでレンダリングされます。ページにページ・バリアントがない場合、デフォルトではベース・ページがレンダリングされますが、この動作をオーバーライドしてこの状況でページを表示しないようにできます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・バリアントが存在しない場合のポータルのページ動作の設定に関する項を参照してください。

45.2 デバイスの作成および管理

この項では、デバイスの作成および管理方法について説明します。

- 新しいデバイスの作成

- デバイスの編集

- デバイスのコピー

- デバイスのリストのフィルタリング

- デバイスの削除

注意:

場合によっては、「デバイス設定」ページでデバイス構成を追加または変更した後に、ページ・バリアントを表示できないことがあります。この場合、ログアウトしてからログインしてキャッシュをクリアします。その後、デバイスは正しく認識されます。

45.2.1 新しいデバイスの作成

新しいデバイスを作成するには:

1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「デバイス設定」をクリックします。

ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/device

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のプリティURLに関する項。

2. 「デバイス」タブで、「作成」をクリックします。

「デバイス」、「オプション属性」および「追加属性」の3つのセクションを含む「デバイスの作成」ページが表示されます。

3. 「デバイス」セクションで、次の詳細を指定します。

- 名前: デバイスの名前。この名前は一意である必要があり、スペースを含めることはできません。この名前を使用することにより、式言語の式を使用してこれを検出することができます。

- 表示名: デバイスの表示名を指定します。この名前は一意である必要があり、WebCenter Portalのユーザー・インタフェースに表示されます。

- ユーザー・エージェント - ユーザー・エージェント文字列を指定します。WebCenter Portalは、リクエスト・ヘッダーで渡されたユーザー・エージェント文字列(ユーザーのデバイスから送信されたもの)と、このフィールドで指定された文字列とを比較して、デバイスを識別します。このパラメータは、リクエスト・ヘッダーとリテラル一致する必要はありません。正規表現として認識されるため、このフィールドには任意の有効な正規表現を入力できます。

注意:

ユーザー・エージェント文字列は正規表現であり、Javaプラットフォーム(java.util.regex.Pattern)によって指定された構文に準拠しています。したがって、ある特殊文字を照合する場合、これらに対してエスケープ文字を使用する必要がある場合があります。これらの文字には[\^$.|?*+()などがあり、場合によっては中括弧文字{}も含まれます。たとえば、丸括弧には、\(iPhone; CPU iPhone OS 5_0 like Mac OS X\)のようにエスケープ文字「\」を使用する必要があります。詳細は、正規表現構文に関する優れたリファレンスを読むことをお薦めします。

- 説明: (オプション)デバイスの目的を識別する際に役に立つ説明を指定します。

4. 表示解像度の高さや幅などの属性を管理するには、「オプション属性」セクションを使用します。図45-4に示すように、必要に応じてデフォルト値を編集できます。

注意:

オプション属性は、ポータルがデバイスでレンダリングされる方法に影響しません。これは、ページ設計者の役に立つようにデバイスの情報を指定する方法を提供するだけです。ポータルの設計者は、式言語を使用して、デバイス属性の値にアクセスできます。

図45-4 オプション属性の指定

5. 必要に応じて、属性を追加します。「追加属性」セクションで、「属性の追加」をクリックして、名前と値を指定します。

注意:

追加属性は、ポータルがデバイスでレンダリングされる方法に影響しません。これは、ページ設計者の役に立つようにデバイスの情報を指定する方法を提供するだけです。ポータルの設計者は、式言語を使用して、デバイス属性の値にアクセスできます。

6. 「作成」をクリックしてデバイスを作成します。

45.2.2 デバイスの編集

既存のデバイスを編集するには:

注意:

場合によっては、「デバイス設定」ページでデバイス構成を追加または変更した後に、ページ・バリアントを表示できないことがあります。この場合、ログアウトしてからログインしてキャッシュをクリアします。その後、デバイスは正しく認識されます。

1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「デバイス設定」をクリックします。

ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/device

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のプリティURLに関する項。

2. 「デバイス」タブで、編集するデバイスを選択し、「アクション」メニューをクリックして、「編集」を選択します。

3. デバイス設定を編集します。編集できるデバイス設定の詳細は、「新しいデバイスの作成」を参照してください。

4. 「保存」をクリックします。

45.2.3 デバイスのコピー

デバイスのコピーの作成は次のことを行うときに便利です。

- デバイスのバックアップを作成するとき。

- デバイスを更新するが、元のものも使用できるように保持するとき。

- 新しいデバイスを作成する開始点として組込みのデバイスを使用するとき。

デバイス・グループをコピーするには:

1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「デバイス設定」をクリックします。

ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/device

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のプリティURLに関する項。

2. 「デバイス」タブで、コピーするデバイスを選択し、「アクション」メニューをクリックして、「コピー」を選択します。

3. 「コピー」ダイアログで、デバイスの名前、表示名、ユーザー・エージェントおよび説明を指定します。

4. 「OK」をクリックします。

コピーされたデバイスが「デバイス」リストに表示されます。

45.2.4 デバイスのリストのフィルタリング

「フィルタ」フィールドでは、「デバイス」表に表示されるデバイスのリストをフィルタできます。フィルタリングは、デバイス・グループ名、表示名、説明およびユーザー・エージェントに対して検索を行います。

45.2.5 デバイスの削除

作成またはコピーした任意のデバイスを削除できます。初期設定でシードされたデバイスはどれも削除できません。

デバイスを削除するには:

1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「デバイス設定」をクリックします。

ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/device

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のプリティURLに関する項。

2. 「デバイス」タブで、削除するデバイスを選択します。複数のデバイスを選択するには、[Ctrl]を押しながらクリックします。

注意:

削除できるのは、作成またはコピーしたデバイスのみです。WebCenter Portalに付属していた初期設定のデバイスは削除できません。

3. 「削除」をクリックします。

4. 「デバイスの削除」ダイアログでアクションを確認します。

45.3 デバイス・グループの作成および管理

デバイス・グループは、類似した表示要件を共有するデバイスの集合を表します。この項では、サポートするデバイス・グループの作成および管理方法について説明します。

- デバイス・グループの作成

- デバイス・グループの編集

- デバイス・グループのコピー

- デバイス・グループの表示および非表示

- デフォルト・デバイス・グループの設定

- デバイス・グループの順序付け

- デバイス・グループのフィルタリング

- デバイス・グループの削除

「基本的なユースケース: 新しいデバイスのサポートの追加」も参照してください。

注意:

場合によっては、「デバイス設定」ページでデバイス構成を追加または変更した後に、ページ・バリアントを表示できないことがあります。この場合、ログアウトしてからログインしてキャッシュをクリアします。その後、デバイスは正しく認識されます。

45.3.1 デバイス・グループの作成

デバイス・グループを作成するには:

1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「デバイス設定」をクリックします。

ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/device

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のプリティURLに関する項。

2. 「デバイス・グループ」タブで、「作成」をクリックします。

「デバイス・グループの作成」ページが表示されます(図45-5)。

図45-5 デバイス・グループの作成

3. 新しいデバイス・グループの名前と表示名を指定します。名前は一意の名前にして、内部的に使用する必要があります。表示名は、WebCenter Portalに表示される名前です。この名前も一意の名前にする必要があります。

4. 「デバイス」セクションで、矢印を使用して、追加する使用可能なデバイスを「デバイス・グループ」リストに移動します。

5. 「アセット」セクションで、このデバイス・グループが使用するページ・テンプレートおよびスキンを選択します。

注意:

アセットの横の「拡張編集オプション」矢印、「式ビルダー」を順にクリックし、EL式を「式エディタ」に入力します。ELを使用すると、スキンまたはテンプレートを動的に選択できます。ELのサポートが必要な場合は、開発者がEL式を指定できます。『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の式言語式に関する項を参照してください。

6. グループを作成するには、「作成」をクリックします。

45.3.2 デバイス・グループの編集

デバイス・グループの表示名の変更、デバイス・グループの目的を説明する説明の編集およびデバイス・グループに関連付けられたスキンおよびテンプレート(またはこれらのいずれか)の変更を実行できます。デバイス・グループを特定するために内部的に使用されるデバイス・グループの名前を変更することはできません。

デバイス・グループの基本的詳細を編集するには:

1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「デバイス設定」をクリックします。

ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/device

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のWebCenter PortalプリティURLに関する項。

2. 「デバイス・グループ」タブで、編集するデバイス・グループを選択し、「アクション」メニューをクリックして、「編集」を選択します。

3. 「デバイス・グループの編集」ページで、デバイス・グループに必須の「表示名」を指定します。

4. 「説明」ボックスで、デバイス・グループが作成された目的を指定します。

5. 「アセット」セクションで、このデバイス・グループが使用するページ・テンプレートおよびスキンを選択します。

注意:

アセットの横の「拡張編集オプション」矢印、「式ビルダー」を順にクリックし、EL式を「式エディタ」に入力します。ELを使用すると、スキンまたはテンプレートを動的に選択できます。ELのサポートが必要な場合は、開発者がEL式を指定できます。『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の式言語式に関する項を参照してください。

6. 「保存」をクリックします。

7. 「閉じる」をクリックして「デバイス・グループの編集」ページを閉じます。

45.3.3 デバイス・グループのコピー

デバイス・グループのコピーを作成できます。これは次のことを行うときに便利です。

- デバイス・グループのバックアップを作成するとき。

- デバイス・グループを更新するが、元のものも使用できるように保持するとき。

- 新しいデバイス・グループを作成する開始点として組込みのデバイス・グループを使用するとき。

デバイス・グループのコピーを作成すると、元のデバイス・グループのステータスとは関係なくコピーは非表示としてマークされます。

デバイス・グループをコピーするには:

1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「デバイス設定」をクリックします。

ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/device

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のプリティURLに関する項。

2. 「デバイス・グループ」タブで、編集するデバイス・グループを選択し、「アクション」メニューをクリックして、「コピー」を選択します。

3. 「コピー」ダイアログで、デバイス・グループの名前、表示名および説明を指定します(図45-6)。

図45-6 デバイス・グループのコピー

4. 「OK」をクリックします。

45.3.4 デバイス・グループの表示および非表示

デバイス・グループ(組込みかカスタム化は不問)はすべて、非表示または使用可能としてマークできます。デバイス・グループの名前の横のチェック・マークは、デバイス・グループが使用可能であることを示しています。チェック・ボックスが空の場合、デバイス・グループをポータルで使用できないことを示しています(図45-7)。この設定は、ページ・バリアントを作成するときに使用できる選択肢も制御します。デバイス・グループが非表示の場合、新しいページ・バリアントで使用するオプションとして表示されず、そのグループでページ・バリアントを作成できません。表示/非表示の設定は、「ポータル管理」設定から継承されますが、ポータル・マネージャによってポータル・レベルでオーバーライドできます。『Oracle WebCenter Portalでのポータルの構築』のデバイス・グループのページ・バリアントの作成に関する項も参照してください。

デフォルトでは、デバイス・グループを作成するとき、これは使用不可としてマークされます。

図45-7 使用可能なデバイス・グループおよび非表示のデバイス・グループ

デバイス・グループを表示または非表示にするには:

1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「デバイス設定」をクリックします。

ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/device

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のプリティURLに関する項。

2. 「デバイス・グループ」タブの「使用可能」列で、「使用可能」列のチェック・ボックスを選択または選択解除して、デバイス・グループを表示または非表示にします。

45.3.5 デフォルトのデバイス・グループの設定

デスクトップのブラウザという名前の組込みデバイス・グループは、WebCenter Portalのデフォルトのデバイス・グループです。作成するすべての新しいページは、デフォルトのデバイス・グループに自動的に関連付けられます。

「デバイス・グループ」タブで、Defaultは、デフォルトとして設定されているデバイス・グループの横に表示されます。

デバイス・グループをデフォルトとして設定するには:

1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「デバイス設定」をクリックします。

ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/device

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のプリティURLに関する項。

2. 「デバイス・グループ」タブで、デフォルトとして指定するデバイス・グループを選択し、「アクション」メニューをクリックして、「デフォルトとして設定」を選択します。

Defaultが選択したデバイス・グループの横に表示されるようになります。

45.3.6 デバイス・グループの順序付け

デバイスを使用してユーザーがWebCenter Portalにアクセスする場合、ポータルは、そのデバイスが属するデバイス・グループと関連付けられたページ・テンプレートやスキンなどのアセットを使用してレンダリングされます。ただし、1つのデバイスが複数のデバイス・グループに関連付けられている場合があります。そのような場合は、「デバイス・グループ」タブでのデバイス・グループの順序付けにより、デバイス・グループの優先順位が決まります。

デバイス・グループの順序を定義するには:

1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「デバイス設定」をクリックします。

ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/device

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のプリティURLに関する項。

2. 「デバイス・グループ」タブで、順序付けアイコンを使用してデバイス・グループの順序を定義します。

- 最上位に移動: クリックすると、選択したデバイス・グループが、表示されているデバイス・グループのリストの最上位に移動します。
これは、デバイスが複数のデバイス・グループに属している場合、最上位のデバイス・グループが優先されることを意味します。

- 上へ移動: クリックすると、選択したデバイス・グループが、表示されているデバイス・グループのリスト内で1レベル上に移動します。

- 下へ移動: クリックすると、選択したデバイス・グループが、表示されているデバイス・グループのリスト内で1レベル下に移動します。

- 最下位に移動: クリックすると、選択したデバイス・グループが、表示されているデバイス・グループのリストの最下位に移動します。

図45-8 デバイス・グループの並替え

45.3.7 デバイス・グループのフィルタリング

「フィルタ」フィールドでは、「デバイス・グループ」表に表示されるデバイス・グループのリストをフィルタリングできます。フィルタリングにより、デバイス・グループ名、表示名および説明での検索が行われます。

45.3.8 デバイス・グループの削除

デバイス・グループが不要になった場合、これを削除できます。ただし、削除できるのはカスタム・デバイス・グループのみで、組込みデバイス・グループは削除できません。

注意:

デバイス・グループが削除されても、そのデバイス・グループに関連付けられたページ・バリアントはそのまま存在します(これらは削除されません)。デバイス・グループの削除に関する重要なガイドラインは、「デバイス設定のガイドラインおよびベスト・プラクティス」を参照してください。

デバイス・グループを削除するには:

1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「デバイス設定」をクリックします。

ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/device

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のプリティURLに関する項。

2. 「デバイス・グループ」タブで、削除するデバイス・グループを選択し、「削除」をクリックします。

3. 「デバイス・グループの削除」ダイアログで、「削除」をクリックします。

45.4 デバイスおよびデバイス・グループのライフ・サイクルの管理

デバイス・グループおよびデバイスをファイルにダウンロードし、これらを別のWebCenter Portalインスタンスにアップロードできます。たとえば、デバイス・グループをステージング・サーバーから本番サーバーに移動する場合は、次の項で説明するライフ・サイクル・メカニズムを使用します。

- デバイス・グループまたはデバイスのダウンロード

- デバイス・グループまたはデバイスのアップロード

注意:

- ダウンロードできるのは、コピーまたは作成したデバイス・グループまたはデバイスのみです。初期設定のデバイス・グループはどれもダウンロードできません。

- デバイス・グループをアップロードまたはダウンロードする場合、そのデバイス・グループに関連付けられているすべてのアーティファクトが含まれます(そのグループに関連付けられているすべてのデバイスを含む)。たとえば、新しいデバイスを作成し、これをグループに追加してからそのグループをダウンロードしたとします。この場合、そのグループを別のサーバーにアップロードすると、その新しいデバイスはデバイスのリストに自動的に追加されます。

45.4.1 デバイス・グループまたはデバイスのダウンロード

デバイス・グループまたはデバイスをファイルにダウンロードするには:

1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「デバイス設定」をクリックします。

ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/device

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のプリティURLに関する項。

2. 「デバイス・グループ」または「デバイス」タブで、ダウンロードするデバイス・グループまたはデバイスを選択します。複数の行を選択するには、[Ctrl]を押しながらクリックします。

3. 「ダウンロード」をクリックします。

4. 「ダウンロード」ダイアログの「アーカイブ・ファイル名」フィールドに、デバイス・グループまたはデバイス・アーカイブ・ファイルの名前を入力します。アーカイブ・ファイルの拡張子は.aarであることが必要です。

5. 次を選択します。

- 「自分のコンピュータに保存」を選択すると、アーカイブ・ファイルがローカル・ファイル・システムに保存されます。「ダウンロード」ボタンをクリックすると、ファイル・システム上でファイルを保存する場所の入力を求めるプロンプトが表示されます。

- 「WebCenter Portalサーバーに保存」を選択すると、アーカイブ・ファイルがサーバーのファイル・システムに保存されます。.aarアーカイブ・ファイルはデフォルト・パスDOMAIN_HOME/WC_Archivesに保存されます(DOMAIN_HOMEは、WebCenter Portalがインストールされているドメインの場所を参照します)。
『Oracle WebCenter Portalでのポータルの構築』のアセットのダウンロードに関する項も参照してください。

6. 「ダウンロード」をクリックします。

45.4.2 デバイス・グループまたはデバイスのアップロード

前にダウンロードしたデバイスまたはデバイス・グループをポータルにアップロードするには:

1. 「設定」ページで(「WebCenter Portal管理の設定ページへのアクセス」を参照)、「デバイス設定」をクリックします。

ブラウザで次のURLを入力して、「デバイス設定」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/device

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のプリティURLに関する項。

2. 「デバイス・グループ」または「デバイス」タブで、「アップロード」をクリックします。

3. 「デバイス / デバイス・グループのアップロード」ダイアログを使用して、ファイル・システム上で.aarファイルを探します。次を選択します。

- 自分のコンピュータで表示: ローカル・ファイル・システムからアーカイブ・ファイルをアップロードする場合にクリックします。「参照」をクリックしてファイルを検索します。

- WebCenter Portalサーバーで表示: リモート・サーバーのファイル・システムからアーカイブ・ファイルがアップロードされます。フィールドに、ファイルを配置するサーバーの場所を入力します。
アーカイブ・ファイルは、ダウンロードするとデフォルト・パスDOMAIN_HOME/WC_Archivesに保存されます(DOMAIN_HOMEは、WebCenter Portalがインストールされているドメインの場所を参照します)。

『Oracle WebCenter Portalでのポータルの構築』のアセットのダウンロードに関する項も参照してください。

4. 「アップロード」をクリックします。

5. アーカイブがすでにWebCenter Portalに存在する場合は、「はい」をクリックして、デバイス・グループまたはデバイスをアーカイブ・ファイルのコンテンツで置き換えることを確認します。

6. 正常な結果を示すダイアログで、「OK」をクリックします。

45.5 デバイスのプレビュー

WebCenter Portalには、ページおよびページ・バリアントが特定のデバイスでどのようにレンダリングされるかをプレビューできるプレビュー機能が組み込まれています。詳細は、『Oracle WebCenter Portalでのポータルの構築』のページのモバイル・デバイス・バリアントのプレビューに関する項を参照してください。

45.6 デバイス設定のガイドラインおよびベスト・プラクティス

この項では、デバイス設定での作業のベスト・プラクティスについて説明します。

本番ポータルのデフォルトのデバイス・グループを変更しない

本番ポータルのデフォルトのデバイス・グループを変更すると、予期しない動作を引き起こす場合があります。ポータルを本番にしたら、デフォルトのデバイス・グループを変更しないことが適切です。

本番ポータルのカスタムのデバイス・グループを削除しない

本番またはポータルのカスタムのデバイス・グループを削除した場合、サーバーは、既存のポータルがそのデバイス・グループを使用していることを警告せず、場合によっては正しくないページ・レンダリングが発生します。

デバイス・グループを誤って削除した場合

削除したデバイス・グループと同じデバイス・グループ名の別のデバイス・グループを作成できます。デバイス・グループが削除されても、そのページ・バリアントはシステムから削除されません。これらのページ・バリアントは、デバイス・グループの名前を使用して関連付けられています。同じ名前のデバイス・グループを再作成すると、これらすべてのページが元に戻ります。

デバイスのリクエストに関する情報が必要な場合

場合によっては、ポータルへのアクセスに使用するデバイスの情報を取得し、ポータルによるデバイスのマッピング先のデバイス設定を検出すると役に立ちます。便宜を図るために、「デバイス属性の検出: サンプル・タスク・フロー」に、このデバイス情報を返すタスク・フローを作成するために開発者が使用できるコードをリストします。

45.7 デバイス属性の検出: サンプル・タスク・フロー

式言語の式を使用して、デバイス属性を返すことができます。この目的のために使用できるサンプル・コードは、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のデバイス設定に関連するEL式に関する項で示されます。開発者は、このコードを使用して、ポータルが指定のデバイスでレンダリングされる方法に関する問題のトラブルシューティングで役に立つデバイス情報を返すタスク・フローを作成できます。図45-9は、このサンプル・コードを使用して作成したタスク・フローからの出力を示しています。

図45-9 サンプル・タスク・フローからの出力

46 タスク・フローのカスタマイズ

この章では、「タスク・フロー・エディタ」システム・ページを使用して、WebCenter Portalのすべてのポータルが使用できるようにタスク・フローをカスタマイズする方法について説明します。

注意:

タスク・フローのカスタマイズは、Oracle JDeveloperを使用した設計時にも実行できます。このプロセスは、この章で説明する実行時の手順とは大きく異なります。詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』のタスク・フローへのカスタム・アクションの追加に関する項を参照してください。

この章の内容は次のとおりです。

- アプリケーションレベルでのタスク・フローのカスタマイズについて

- アプリケーションレベルでのタスク・フローのカスタマイズ

- タスク・フローのカスタマイズの削除

権限

この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは次の権限を付与されているカスタム・ロールが必要です。

- Portal Server: Manage AllまたはPortal Server-Manage Configuration

46.1 アプリケーションレベルでのタスク・フローのカスタマイズについて

タスク・フローのカスタマイズは、現在のスコープ内の特定のタスク・フローに対するすべてのインスタンスが影響を受けるような方法で、そのタスク・フローを構成する方法を提供します。たとえばすべてのポータルについて、リンクまたはアイコンを、それを必要とするタスク・フローに追加できます。

タスク・フローのカスタマイズ機能は、「タスク・フロー・エディタ」システム・ページで排他的に使用できます。「タスク・フロー・エディタ」システム・ページは、アプリケーション(すべてのポータル)と個別のポータルの両方に対して使用できます。

- すべてのポータル(ホーム・ポータルを含む)間で指定のタスク・フローのすべてのインスタンスを変更するには、この章で説明するように、アプリケーションレベルの「タスク・フロー・エディタ」システム・ページでタスク・フローをカスタマイズします。

- 指定のポータルで公開されているインスタンスのみを変更するために、ポータル・マネージャは、ポータル・レベルの「タスク・フロー・エディタ」システム・ページでタスク・フローをカスタマイズできます。『Oracle WebCenter Portalでのポータルの構築』のタスク・フローの使用に関する項を参照してください。

注意:

アプリケーションレベルでタスク・フロー要素をカスタマイズする際に、別のユーザーが同じタスク・フロー要素をポータル・レベルでカスタマイズすると、ポータル・レベルのカスタマイズがそのポータルで優先となります。

「タスク・フロー・エディタ」システム・ページは、初期設定のタスク・フローのカスタマイズを可能にするために用意されています。「アセット」ページまたは「共有アセット」ページを使用して作成されたカスタム・タスク・フローは、この方法ではカスタマイズできません。

システム・ページには「デフォルトに戻す」機能があり、権限を持つユーザーは、すべてのページ・カスタマイズを削除して、システム・ページをデフォルトの状態に戻すことができます。「デフォルトに戻す」によって、カスタマイズされたタスク・フローはデフォルトの状態に戻らないので注意してください。タスク・フローのカスタマイズを削除するには、「タスク・フローのリセット」という別のコントロールを使用します。

関連項目:

システム・ページの「デフォルトに戻す」機能および「タスク・フローのリセット」機能の詳細は、それぞれ「システム・ページからのすべてのページ・カスタマイズの削除」および「タスク・フローのカスタマイズの削除」を参照してください。

46.2 アプリケーションレベルでのタスク・フローのカスタマイズ

この項では、アプリケーションレベルで、WebCenter Portalのタスク・フローのカスタマイズを実行する方法について説明します。

「タスク・フロー・エディタ」システム・ページを使用してアプリケーション全体のタスク・フローのカスタマイズを実行するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「システム・ページ」をクリックします。

ブラウザで次のURLを入力して、「システム・ページ」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/systempages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のプリティURLに関する項。

2. 「タスク・フロー・エディタ」システム・ページの横にある「カスタマイズ」リンク(図46-1)をクリックして、ページ・エディタの「構造」ビューでこれを開きます。

図46-1 「タスク・フロー・エディタ」システム・ページの横にある「カスタマイズ」リンク

3. 編集するタスク・フローを「タスク・フロー・エディタ」ページ(図46-2)に追加します。

a. ページ上をクリックして、そのページをアクティブ化します。

b. 「選択したコンポーネントにコンテンツを追加」アイコン(右ツールバーの「追加」アイコン)をクリックします。
「コンテンツの追加」ダイアログが開きます。

ページにタスク・フローを追加する方法は、リソース・カタログの他のコンポーネントを追加する方法と同じです。詳細は、『Oracle WebCenter Portalでのポータルの構築』のページへのコンポーネントの追加に関する項を参照してください。

図46-2 Regionタグの横にある「タスク・フローの編集」リンク

4. カスタマイズするタスク・フローの横にある「タスク・フローの編集」リンクをクリックします(図46-2)。

5. 「タスク・フローの編集を確認」ダイアログで、「編集」をクリックします。

「構造」ビューが編集中のタスク・フローのソース・コード階層にズームインします(図46-3)

図46-3 タスク・フローのズームイン・ビュー

6. タスク・フロー要素のプロパティを設定するには、タスク・フロー要素を「タスク・フロー・エディタ」でクリックし、「regionのプロパティの表示」アイコンをクリックします。または、「region」を右クリックし、「編集」(図46-4)を選択します。

図46-4 「構造」ビューのページで選択したタスク・フローの要素

「コンポーネント・プロパティ」ダイアログが開きます(図46-5)。

図46-5 「コンポーネント・プロパティ」ダイアログ

7. 要素のプロパティの変更を行います。編集しているコンポーネントのパラメータの説明を表示するには、「ヘルプ」アイコンをクリックします

注意:

1つの要素の変更は、現在のスコープ内のタスク・フローにあるすべての類似の要素に影響することに注意してください。たとえば、フォルダ名で使用するフォントの変更は、選択したインスタンスのみではなくスコープ内すべてのフォルダ名に影響します。

8. 「適用」をクリックし、変更の結果を表示します。「OK」をクリックして変更を保存し、ダイアログを終了します。

現在のスコープ内にあるカスタマイズされたタスク・フローのすべてのインスタンスが、このカスタマイズでレンダリングされます。

9. 「保存」、「閉じる」の順にクリックして、Composerを終了します。

46.3 タスク・フローのカスタマイズの削除

WebCenter Portalでシードされたタスク・フローに対して行われたすべてのカスタマイズを削除できます。

注意:

この手順は、実行時に作成されたタスク・フローには適用されません。つまり、「アセット」ページまたは「共有アセット」ページを使用して作成されたタスク・フローです。実行時に作成されたタスク・フローへの変更は、レイヤー化されたタスク・フローではなくベースの編集です。したがって、「タスク・フローのリセット」をクリックするとき、削除するカスタマイズ・レイヤーはありません。

アプリケーション・レベルで行われたタスク・フローのカスタマイズを削除するには:

1. 「設定」ページ(「WebCenter Portal管理の設定ページへのアクセス」を参照)で、「システム・ページ」をクリックします。

ブラウザで次のURLを入力して、「システム・ページ」ページに直接移動することもできます。

http://host:port/webcenter/portal/admin/settings/systempages

関連項目:

『Oracle WebCenter Portalでのポータルの構築』のプリティURLに関する項。

2. 「タスク・フロー・エディタ」システム・ページの横にある「カスタマイズ」リンク(図46-6)をクリックして、ページ編集モードでこれを開きます。

図46-6 システム・ページの横にある「カスタマイズ」リンク

3. 「構造」ビュー・ツールバーで、「タスク・フローのリセット」をクリックします。

図46-7 選択した要素の「タスク・フローのリセット」オプション

4. 「タスク・フローのリセット」ダイアログで、「タスク・フローのリセット」をクリックしてアクションを確認します。

47 ポータルの使用状況の分析

分析サービスは、ポータルのリアルタイムの使用状況およびアクティビティのレポートを提供します。この章では、分析サービスを通して提供されるページおよびタスク・フローの使用方法について説明します。

この章の内容は次のとおりです。

- 分析タスク・フローおよびサービスについて

- 分析管理ページについて

- 分析タスク・フローでの作業

「分析」タスク・フローを機能させるには、「分析」スキーマ(ACTIVITIES)をインストールして構成し、WebCenter Portalと分析コレクタの間の接続を設定する必要があります。分析スキーマおよび分析サービスのバックエンドを管理する方法の詳細は、「分析の管理」を参照してください。

この章では、実行時にポータル・ページに分析タスク・フローを追加する方法について説明します。Oracle JDeveloperを使用して設計時に分析タスク・フローを追加する方法の詳細は、『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』を参照してください。

権限

この章のタスクを実行するには、WebCenter PortalのAdministratorロールまたは少なくとも次の権限を付与されているカスタム・ロールが必要です。

- Portal Server: Manage Configuration

権限の詳細は、「アプリケーション・ロールおよび権限について」を参照してください。

47.1 分析タスク・フローおよびサービスについて

分析サービスを使用すると、WebCenter Portal管理者およびポータル・マネージャは、WebCenter Portalのトラフィックおよび使用状況を追跡および分析できます。分析サービスでは、次の基本機能が提供されます。

- 使用状況トラッキング・メトリック: 分析サービスは、コミュニティ、ポートレット・トラフィックなどの一般的なWebCenter Portal機能のメトリックを収集および報告します。

- 動作トラッキング: 分析サービスを使用して、WebCenter Portalメトリックを分析し、ページ訪問期間、一定期間の使用状況などの使用パターンを特定できます。

- ユーザー・プロファイルの相関: 分析サービスを使用して、メトリック情報をユーザー・プロファイル情報と関係付けることができます。国、会社、役職などのユーザー・プロファイル・データを基準に、使用状況トラッキング・レポートを表示およびフィルタ処理できます。

注意:

プロファイル情報はキャッシュされます。つまり、ユーザー・プロファイルの変更は、キャッシュが更新されるまでレポートに表示されません。デフォルトのキャッシュ時間は60分ですが、管理者はこの値を変更できます。

47.2 分析管理ページについて

Manage Configuration権限を持っているWebCenter Portal管理者は、Oracle WebCenter Portal全体のメトリックを表示する分析コンソールを使用できます。コンソールは4つのページで構成され、次のような様々なレポートがグループ化されています。

- サマリー・メトリック - ポータル・トラフィック、ページ・ビューおよびログイン・メトリック

- ポータル・メトリック - ポータルの使用状況およびレスポンス時間

- ポートレット・メトリック - ポートレット・ビューおよびレスポンス時間

- サービス・メトリック - 検索、ドキュメント、wiki、ブログおよびディスカッションの使用状況

図47-1 管理者用分析コンソール

このコンソールはデフォルトで、「分析」というビジネス・ロール・ページからのみアクセスできます。ユーザーが「分析」ページを表示するには、WebCenter Portalの管理者が必要な権限を付与する必要があります。このページは、アクセスおよび使用状況の統計を分析する必要があるユーザーを対象としています。そのようなユーザーとして、管理者、営業部門またはマーケティング部門の部長や担当重役、ビジネス・アナリストなどが考えられます。

他のビジネス・ロール・ページと同様に、分析ページは割り当てられたすべてのユーザーにプッシュされ、ホーム・ポータルに表示されます。分析ページをホーム・ポータルで使用できるようになると、ユーザーは「ページの管理」ダイアログでページを表示または非表示にできます。

47.3 分析タスク・フローでの作業

この項では、分析タスク・フローについて説明します。これには、分析タスク・フローのポータル・ページへの追加方法、分析タスク・フローのカスタマイズ方法、分析タスク・フローのプロパティの変更方法、レポート・ビューのパーソナライズ方法が含まれます。

この項では、次の項目について説明します。

- 分析タスク・フローの理解

- 分析タスク・フローのページへの追加

- 分析レポートのカスタマイズ

- 分析レポートのパーソナライズ

- 分析タスク・フロー・プロパティの設定

47.3.1 分析タスク・フローの理解

この項では、WebCenter Portalに付属しているすべての分析タスク・フローをリストし、説明します。「管理者」とマークされているものは管理者アカウントを持っているユーザーのみが使用でき、「システム管理者」とマークされているものはシステム管理者のみが使用できます。

次のタスク・フローは、標準設定で使用できます。

アプリケーション分析:

- WebCenterトラフィック

- ページ・トラフィック(管理者)

- ログイン・メトリック(システム管理者)

ポータル分析:

- ポータル・トラフィック(システム管理者)

- ポータル・レスポンス時間(システム管理者)

ポートレット分析:

- ポートレット・トラフィック(管理者)

- ポートレット・インスタンス・トラフィック(管理者)

- ポートレット・レスポンス時間(管理者)

- ポートレット・インスタンス・レスポンス時間(管理者)

サービス分析:

- 検索のメトリック

- ドキュメント・メトリック(システム管理者)

- Wikiメトリック(システム管理者)

- ブログ・メトリック(システム管理者)

- ディスカッション・フォーラム・メトリック(システム管理者)

注意:

次の各項で示すイメージは、各レポートの1つのビューを表しています。ただし、各レポートをカスタマイズして別の方法(棒グラフ、円グラフ、折れ線グラフ、表など)でデータを表示できます。レポートのカスタマイズの詳細は、「分析レポートのカスタマイズ」 および「分析レポートのパーソナライズ」を参照してください。

47.3.1.1 WebCenterトラフィック

「WebCenterトラフィック」タスク・フローは、ポータル内の一般的なイベントのサマリー・ビューを表示します。このタスク・フローを使用して、アプリケーション全体のイベント(ポータル・ビュー、ページ・ビュー、ポートレット・ビュー、ログイン、検索数、wikiビュー、ブログ・ビュー、ディスカッション・フォーラム・ビューおよびドキュメント・ビュー)を追跡します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のWebCenterトラフィックに関する項を参照してください。

47.3.1.2 ページ・トラフィック(管理者)

「ページ・トラフィック」タスク・フローは、ページ・ヒット数および任意のポータル・ページを訪問した一意のユーザー数を表示します。このタスク・フローを使用すると、最も多く訪問されているページ(上位ページ)および訪問数が最も少ないページ(下位ページ)がすぐにわかります。詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ・トラフィック(管理者)に関する項を参照してください。

47.3.1.3 ログイン・メトリック(システム管理者)

ログイン・タスク・フロー(図47-2)は、ユーザーがWebCenter Portalにログインした回数をレポートします。

このタスク・フローを使用すると、ポータルへのログインの合計回数および一意のユーザーがWebCenter Portalにログインした回数がわかります。

図47-2 分析タスク・フロー: ログイン・メトリック

47.3.1.4 ポータル・トラフィック(システム管理者)

ポータル・トラフィック・タスク・フロー(図47-3)は、個々のポータルの使用状況情報(ページ・ヒット数、一意のユーザー数、一意の訪問数(同じWebCenter Portalセッション中の同じポータル内での複数の連続したページ・ビューは1回の訪問として処理))を表示します。

このタスク・フローを使用すると、最も人気のあるポータル(上位)および最も人気のないポータル(下位)がすぐにわかります。データをフィルタ処理して、特定のポータルのみを表示するかまたはすべてのポータルを表示できます。

図47-3 分析タスク・フロー: ポータル・トラフィック

注意:

ホーム・ポータルはデータに含まれていません。

47.3.1.5 ポータル・レスポンス時間(システム管理者)

「ポータル・レスポンス時間」タスク・フロー(図47-4)は、指定した期間の個々のポータルのページ・パフォーマンス情報(平均、最小および最大のレスポンス時間)を表示します。このタスク・フローを使用すると、最も遅いポータル(下位)および最も速いポータル(上位)がすぐにわかります。データをフィルタ処理して、特定のポータルのみを表示するかまたはすべてのポータルを表示できます。

図47-4 分析タスク・フロー: ポータル・レスポンス時間

注意:

ホーム・ポータルはデータに含まれていません。

47.3.1.6 ポートレット・トラフィック(管理者)

「ポートレット・トラフィック」タスク・フローは、ポートレットの使用状況情報(ポートレット・ヒット数(ポートレットが表示された回数)およびポートレットにアクセスした一意のユーザー数)を表示します。

このタスク・フローを使用すると、最も人気のあるポートレット(上位)および最も人気のないポートレット(下位)がすぐにわかります。データをフィルタ処理して、特定のポートレットのみを表示するかまたはすべてのポートレットを表示できます。同様に、ポータルを基準にポートレットのデータをフィルタ処理できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポートレット・トラフィック(管理者)に関する項を参照してください。

47.3.1.7 ポートレット・インスタンス・トラフィック(管理者)

「ポートレット・インスタンス・トラフィック」タスク・フローは、個々のポートレット・インスタンスの使用状況情報(ポートレット・ヒット数(ポートレットが表示された回数)およびポートレットにアクセスした一意のユーザー数)を表示します。同じポートレットが複数のページに表示される場合は、各配置がポートレット・インスタンスとして考慮されます。

このタスク・フローを使用すると、最も人気のあるポートレット・インスタンス(上位)および最も人気のないポートレット・インスタンス(下位)がすぐにわかります。データをフィルタ処理して、特定のポートレット・インスタンスのみを表示するかまたはすべてのポートレット・インスタンスを表示できます。同様に、ポータルを基準にポートレットのデータをフィルタ処理できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポートレット・インスタンス・トラフィック(管理者)に関する項を参照してください。

47.3.1.8 ポートレット・レスポンス時間(管理者)

「ポートレット・レスポンス時間」タスク・フローは、個々のポートレットのパフォーマンス情報(平均、最小および最大のレスポンス時間)を表示します。このタスク・フローを使用すると、最も遅いポートレット(下位)および最も速いポートレット(上位)がすぐにわかり、パフォーマンス・データを比較できます。ページ・パフォーマンスと最も遅いポートレットには直接の関係があることが多いため、ポートレット・レスポンス時間は重要です。ポータル内での低パフォーマンスをトラブルシューティングする際、最もパフォーマンスが悪いポートレットを特定することが重要です。データをフィルタ処理して、特定のポートレットのみを表示するかまたはすべてのポートレットを表示できます。同様に、ポータルを基準にポートレットのデータをフィルタ処理できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポートレット・レスポンス時間(管理者)に関する項を参照してください。

47.3.1.9 ポートレット・インスタンス・レスポンス時間(管理者)

「ポートレット・インスタンス・レスポンス時間」タスク・フローは、個々のポートレット・インスタンスのパフォーマンス情報(平均、最小および最大のレスポンス時間)を表示します。同じポートレットが複数のページに表示される場合は、各配置がポートレット・インスタンスとして考慮されます。

このタスク・フローを使用すると、最も遅いポートレット・インスタンス(下位)および最も速いポートレット・インスタンス(上位)がすぐにわかり、パフォーマンス・データを比較できます。データをフィルタ処理して、特定のポートレット・インスタンスのみを表示するかまたはすべてのポートレット・インスタンスを表示できます。同様に、ポータルを基準にポートレットのデータをフィルタ処理できます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のポートレット・インスタンス・レスポンス時間(管理者)に関する項を参照してください。

47.3.1.10 検索メトリック

「検索メトリック」タスク・フローは、ポータル内で実行された検索を追跡します。このタスク・フローを使用すると、最多検索語句(上位)および最少検索語句(下位)がすぐにわかります。詳細は、『Oracle WebCenter Portalでのポータルの構築』の検索のメトリックに関する項を参照してください。

47.3.1.11 ドキュメント・メトリック(システム管理者)

「ドキュメント・メトリック」タスク・フロー(図47-5)は、ドキュメントのアクセス頻度を追跡します。このタスク・フローを使用すると、最も人気のあるドキュメント(上位)および最も人気のないドキュメント(下位)がすぐにわかります。データをフィルタ処理して、特定のポータルのみを表示するかまたはすべてのポータルを表示できます。

注意:

ホーム・ポータルのドキュメントはこのレポートには含まれません。

注意:

同じ名前の異なるドキュメントが2つある場合、2つの別のドキュメントとして処理されます。このメトリックにはコンテキストの親フォルダが含まれています。

図47-5 分析タスク・フロー: ドキュメント・メトリック

47.3.1.12 Wikiメトリック(システム管理者)

「Wikiメトリック」タスク・フロー(図47-6)は、WebCenter Portal内でのwikiのアクセス頻度を追跡します。このタスク・フローを使用すると、最も人気のあるwiki(上位)および最も人気のないwiki(下位)がすぐにわかります。データをフィルタ処理して、特定のポータルのみを表示するかまたはすべてのポータルを表示できます。

図47-6 分析タスク・フロー: Wikiメトリック

47.3.1.13 ブログ・メトリック(システム管理者)

「ブログ・メトリック」タスク・フロー(図47-7)は、WebCenter Portal内でのブログのアクセス頻度を追跡します。このタスク・フローを使用すると、最も人気のあるブログ(上位)および最も人気のないブログ(下位)がすぐにわかります。データをフィルタ処理して、特定のポータルのみを表示するかまたはすべてのポータルを表示できます。

図47-7 分析タスク・フロー: ブログ・メトリック

47.3.1.14 ディスカッション・フォーラム・メトリック(システム管理者)

「ディスカッション・フォーラム・メトリック」タスク・フロー(図47-8)は、WebCenter Portal内のディスカッション・フォーラムを追跡します。このタスク・フローを使用すると、最も人気のあるディスカッション(上位)および最も人気のないディスカッション(下位)がすぐにわかります。データをフィルタ処理して、特定のポータルのみを表示するかまたはすべてのポータルを表示できます。

図47-8 分析タスク・フロー: ディスカッション・フォーラム・メトリック

47.3.2 分析タスク・フローのページへの追加

分析タスク・フローをページに追加するプロセスは、他のタスク・フローと同じです(詳細は、『Oracle WebCenter Portalでのポータルの構築』の分析のポータルへの追加に関する項を参照)。このプロセスは、リソース・カタログでこれらのタスク・フローを検索する場合のみ異なります。すべての分析タスク・フローは分析フォルダにあります。

図47-9 「リソース・カタログ」の分析フォルダ

注意:

分析タスク・フローをポータルのページに追加すると、すべてのポータルの情報ではなくそのポータルの情報のみが表示されます。

47.3.3 分析レポートのカスタマイズ

ページ編集モードでレポート設定を編集することによって、分析レポートのデフォルト設定を指定できます。編集モードの間に行った変更は、ページ表示モードのすべてのユーザーに対してデフォルトのレポート設定になります。

たとえば、分析ページを編集し、トラフィック・レポートの「サマリー・メトリック」ページで次の設定を変更できます。レポート・タイプを円グラフに設定し、時間枠を今週に設定し、表示から「ディスカッション・フォーラム」を削除します。ユーザーが分析ページに訪問すると、これらの設定がデフォルトで適用されます。ユーザーは、必要に応じてレポートを編集できます。これは、ユーザーが一般的に使用することがわかっている特定の設定がある場合や、グループ固有ページ上の分析タスク・フローの特定のインスタンスをカスタマイズする場合に便利です。

レポート設定を構成して、表示モードでユーザーが使用できる制御を指定することもできます。詳細は、『Oracle WebCenter Portalでのポータルの構築』の分析レポートのカスタマイズに関する項を参照してください。

47.3.4 分析レポートのパーソナライズ

分析タスク・フローには、レポート上部に表示オプションがあり、レポートの左側に問合せオプションがあります。これらのオプションを使用すると、必要に応じてレポートに含まれているメトリックおよびレポートの表示方法を変更することによって、レポートをパーソナライズできます。ほとんどのオプションはすべての分析タスク・フローで同じです。

この項では、次の内容について説明します。

- レポートの表示オプション

- 問合せオプション

47.3.4.1 レポートの表示オプション

レポート上部にあるレポート表示オプションを使用すると、レポートのタイプの選択、組み込むメトリックのタイプの選択、および一部のタスク・フローでは表示する上位/下位の範囲の制御を実行できます。

レポートのタイプ

選択した表示オプションおよび問合せオプションに応じて、棒グラフ、円グラフ、折れ線グラフまたは表としてレポートを表示できます。レポートのタイプを選択するには、該当するアイコンをクリックします。

表47-1に、様々な表示オプションと問合せオプションで使用可能なレポート・タイプを示します。この表には次の列があります。

- 「選択したメトリック」は、メトリックのリスト内で選択されたもの、単一のメトリックまたは複数のメトリックを指定します。

注意:

「検索メトリック」タスク・フローおよび「ドキュメント・メトリック」タスク・フローは、単一のメトリックのみを表示します。メトリックを選択するリストはありません。

- 「グループ化基準オプション」は、レポートの左にある「グループ化オプション」セクションから選択されたもの、「選択なし」または選択可能な選択肢のいずれかを指定します。

- 棒、円、折れ線および表は、指定した選択肢でそのタイプのレポートを表示できるかどうかを指定します。

図47-1 分析タスク・フローの表示オプション

選択したメトリック

グループ化基準オプション

棒

円

折れ線

表

単一のメトリックログイン・トラフィック・タスク・フロー

選択なし

いいえ

いいえ

いいえ

はい

単一のメトリックその他すべてのタスク・フロー

選択なし

はい

はい

いいえ

はい

単一のメトリック

時間間隔、ユーザー・プロパティまたはこれら両方*

はい

いいえ

はい

はい

複数のメトリックWebCenterトラフィックおよびログイン・トラフィック・タスク・フロー

選択なし

はい

はい

いいえ

はい

複数のメトリックその他すべてのタスク・フロー

選択なし

はい

いいえ

はい

はい

複数のメトリックWebCenterトラフィックおよびログイン・トラフィック・タスク・フロー

時間間隔またはユーザー・プロパティ

はい

いいえ

はい

はい

複数のメトリックその他すべてのタスク・フロー

時間間隔またはユーザー・プロパティ

いいえ

いいえ

いいえ

はい

複数のメトリックログイン・トラフィック・タスク・フロー

両方*

いいえ

いいえ

いいえ

はい

*グループ化オプションの両方はログイン・トラフィック・タスク・フローに対してのみ使用できます。

メトリック

レポートに組み込むメトリックのタイプを選択できます。メトリックのオプションは使用しているタスク・フローに応じて異なります。

- WebCenterトラフィック: 「ポータル」、「ページ」、「ポートレット」、「ログイン」、「検索」、「Wiki」、「ブログ」、「ディスカッション・フォーラム」、「ドキュメント」

- ページ・トラフィック: ヒット、ユーザー数(重複を除く)

- ログイン・メトリック: ログイン、ユーザー数(重複を除く)

- スペース・トラフィック: ヒット、ユーザー数(重複を除く)、訪問

- スペース・レスポンス時間: 平均レスポンス時間、最小レスポンス時間、最大レスポンス時間

- ポートレット・トラフィック: ヒット、ユーザー数(重複を除く)

- ポートレット・インスタンス・トラフィック: ヒット、ユーザー数(重複を除く)

- ポートレット・レスポンス時間: 平均レスポンス時間、最小レスポンス時間、最大レスポンス時間

- ポートレット・インスタンス・レスポンス時間: 平均レスポンス時間、最小レスポンス時間、最大レスポンス時間

- 検索メトリック: このタスク・フローは検索メトリックのみを表示するため、メトリックを選択するオプションはありません。

- ドキュメント・メトリック: このタスク・フローはドキュメント・メトリックのみを表示するため、メトリックを選択するオプションはありません。

- Wikiメトリック: ビュー、ユーザー数(重複を除く)

- ブログ・メトリック: ビュー、ユーザー数(重複を除く)

- ディスカッション・フォーラム・メトリック: ビュー、ユーザー数(重複を除く)

レポートに組み込むメトリックを選択するには、レポートの上にあるリストからメトリックを選択します。

図47-10 分析タスク・フロー: メトリックの選択

上位、下位またはカスタムの範囲

一部のタスク・フローでは、レポートでメトリックの上位、下位、すべてまたはカスタムの範囲の表示を指定できます。これらのオプションを使用すると、ポータルの最も人気がある項目および最も人気がない項目がわかります。

レポートでメトリックの上位または下位の範囲を表示するには、レポートの上のリストで「上」または「下」を選択し、数を選択して範囲を定義します。

カスタムの範囲を表示するには、レポートの上のリストで、「指定」を選択し、「選択」をクリックします。

上オプションおよび下オプションは、「ページ」、「ポートレット・トラフィック」、「ポートレット・インスタンス・トラフィック」、「レスポンス時間」、「ポートレット・レスポンス時間」、「ポートレット・インスタンス・レスポンス時間」で使用できます。

カスタム範囲オプションは、「ページ」、「トラフィック」、「レスポンス時間」、「ポートレット・トラフィック」、「ポートレット・インスタンス・トラフィック」、「レスポンス時間」、「ポートレット・レスポンス時間」、「ポートレット・インスタンス・レスポンス時間」、「検索メトリック」、「ドキュメント・メトリック」、「Wikiメトリック」、「ブログ・メトリック」、「ディスカッション・フォーラム・メトリック」で使用できます。

47.3.4.2 問合せオプション

分析タスク・フローには、レポートの左に次の問合せオプションが組み込まれています。

- レポート・サマリー
選択した表示オプションおよび問合せオプションのサマリーをレポートに表示します。

- 時間枠
レポートに表示するメトリックの日付の範囲を指定できます。次のオプションから選択できます。「昨日」、「今日」、「今週」、「先週」、「今月」、「先月」、「過去3か月間」、「過去6か月間」、「今年」、「昨年」または独自の日付範囲を指定できます。

- ユーザー・プロパティ
ユーザー・プロパティを基準にレポートをフィルタ処理できます。リストからプロパティを選択した後、そのプロパティに含める必要があるまたは含めてはならない値を指定できます。フィルタ処理されたプロパティに当てはまるメトリックのみがレポートに表示されます。

- プロパティ: レポートをフィルタ処理するプロパティを選択します。「市区町村」、「会社」、「国」、「部門」、「表示名」、「従業員ID」、「IMユーザー」、「マネージャ」、「電話番号」、「都道府県」、「番地」、「役職」または「郵便番号」を選択できます。

- 演算子: プロパティをフィルタ処理する方法を選択します。「次を含む」または「次を含まない」を選択できます。

- 値: プロパティをフィルタ処理する値を入力します。

注意:

ワイルドカード(たとえば、%または?)を使用して検索する場合、ワイルドカードの前にスラッシュ(\)を付ける必要があります。たとえば、giveまたはgivingを検索するには、「値」ボックスにgiv\%と入力します。

- 追加オプション
ホーム・ポータル・ページをレポートのデータに組み込むことができます。これらのオプションは、(「ページ・トラフィック」レポート内の)「ページ」タスク・フローで使用できます。

- ポータル
分析タスク・フローをホーム・ポータルまたはビジネス・ロール・ページで表示する場合、レポートに追加するポータルを選択できます。分析タスク・フローを特定のポータル内で使用する場合は、そのポータルのメトリックのみが表示され、「ポータル」オプションは使用できません(グレー表示)。

レポートに追加するポータルを指定するには、「ポータル・フィルタ」アイコンをクリックして「ポータルの指定」ポップアップを表示します。レポートに追加するポータルを選択します。複数のポータルを選択するには、[Ctrl]キーまたは[Shift]キーを押しながらクリックします。

このオプションは、「トラフィック」、「ログイン」または「検索メトリック」の各タスク・フローでは使用できません。

- グループ化オプション
レポートでメトリックをグループ化する基準のオプションを選択できます。時間間隔(時間、日付、週、月または年)、ユーザー・プロパティまたは「ログイン」タスク・フローあるいは両方でグループ化できます。

注意:

この設定は、レポートで使用可能な表示オプションに影響します(表47-10を参照)。

47.3.5 分析タスク・フローのプロパティの設定

分析サービス・タスク・フローには関連するプロパティがあり、十分な権限を持つユーザーは、タスク・フローの「処理の表示」メニューを介してアクセスできます。たとえば、「パラメータ」を選択し、「パラメータ」ダイアログを表示します(図47-11)。

図47-11 分析タスク・フロー: 「パラメータ」ダイアログ

次の各項では、分析サービス・タスク・フローのプロパティについての情報を提供し、タスク・フロー・パラメータについて説明します。

- 分析サービス・タスク・フローのプロパティについて

- 分析サービス・タスク・フローのパラメータ

47.3.5.1 分析サービス・タスク・フローのプロパティについて

ページを編集した場合、タスク・フローをクリックすると、「処理の表示」メニューが分析タスク・フローのツールバーに表示されます。「処理の表示」メニューでは、プロパティ・ダイアログ(「パラメータ」、「アクセス」、「表示オプション」、「スタイル」および「コンテンツ・スタイル」)へのアクセスを提供します。

- パラメータによって、デフォルトのタスク・フロー・コンテンツが制御されます。各パラメータの詳細は、「分析サービス・タスク・フローのパラメータ」を参照してください。パラメータをイベントに結び付けたり、パラメータを使用してタスク・フローとページ・パラメータおよびページ定義変数を簡単に結び付けることができます。詳細は、『Oracle WebCenter Portalでのポータルの構築』のページ、タスク・フロー、ポートレットおよびUIコンポーネントのワイヤリングに関する項を参照してください。

- アクセス設定で、特定のロール、ユーザーまたはグループに対してコンポーネントを表示または非表示にします。詳細は、『Oracle WebCenter Portalでのポータルの構築』のコンポーネントへのアクセスの設定に関する項を参照してください。

- 「表示オプション」、「スタイル」および「コンテンツ・スタイル」のプロパティは、すべてのユーザーのタスク・フローの外観および動作に影響を及ぼします。これらのプロパティは、すべてのタスク・フローに共通しています。詳細は、『Oracle WebCenter Portalでのポータルの構築』のコンポーネントの変更に関する項を参照してください。

「パラメータ」ダイアログと「表示オプション」ダイアログから式言語(EL)エディタにアクセスできます。ELエディタを使用すると、定数値のかわりに変数値を選択または指定できます。プロパティの横にあるアイコンをクリックし、「式ビルダー」を選択してエディタを開きます。

注意:

「表示オプション」ダイアログにELを入力する際、閉じ大カッコがないなど無効な構文が検出された場合にのみ、パーサーはエラーを報告します。検証は構文に対してのみ行われ、式の値に対しては行われません。汎用の「表示オプション」は、『Oracle WebCenter Portalでのポータルの構築』のコンポーネントの表示オプション・プロパティの設定に関する項に記載されているオプションです。

ELの検証は、汎用ではない表示オプションに対しては実行されません。

ELのサポートが必要な場合は、アプリケーション開発者がEL式を指定できます。『Oracle JDeveloperによる、WebCenter Portalアセットおよびカスタム・コンポーネントの開発』の式言語式に関する項を参照してください。

47.3.5.2 分析サービス・タスク・フローのパラメータ

表47-2では、分析サービス・タスク・フロー固有のパラメータについて説明しています。

表47-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までです。

注意: データ点の数を増やすと、レポートのレンダリングにかかる時間が増える場合があります。

付録

『Oracle WebCenter Portalの管理』のこの部では、このガイドの各章の補助的な情報が記載された付録を提供します。

- Oracle WebCenter Portalの構成

- WebCenter PortalのOracle HTTP Server構成

- サード・パーティ製品のサポート

- WebCenter PortalへのWikiコンテンツの移行

- FrameworkFoldersへのFolders_gの移行

- Oracle WebCenter Portalのトラブルシューティング

A Oracle WebCenter Portalの構成

この章では、WebCenter Portalの主な2つの構成ファイルadf-config.xmlおよびconnections.xmlについて説明します。この付録では、これらの両方のファイルとその検索方法について説明します。また、これらのファイルをいつ構成し、どのツールを使用するかについても説明します。

web.xml、webcenter-config.xmlなどの他の構成ファイルについてもここで説明します。「Oracle WebCenter Portalの構成に関する考慮事項」も参照してください。

この付録の内容は次のとおりです。

- 構成ファイル

- クラスタ構成

- 構成ツール

- コンテンツ・マネージャでのファイル・アップロード・サイズの変更

「Oracle WebCenter Portalの構成に関する問題のトラブルシューティング」を参照してください。

A.1 構成ファイル

adf-config.xml、connections.xmlおよびweb.xmlは、WebCenter Portalおよびそのバックエンド・サービスの構成に使用します。初期状態の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: アプリケーションレベルの設定(アプリケーションが現在使用しているディスカッション・サーバーやメール・サーバーなど)が格納されます。

- connections.xml: WebCenter Portalサービスの接続の詳細が格納されます。
『Oracle Application Development FrameworkによるFusion Webアプリケーションの開発』を参照してください。

WebCenter Portalを本番環境にデプロイした後で、Fusion Middleware ControlまたはWebLogic Scripting Tool (WLST)コマンドを使用して、これらのファイルのプロパティを再構成することをお薦めします。たとえば、本番サーバー・インスタンスをポイントするように接続の詳細を変更する必要がある場合があります。「構成ツール」を参照してください。

Fusion Middleware ControlおよびWLSTコマンドを使用する主な利点は、デプロイ後に加えた構成の変更が、アプリケーションのOracle Metadata Services (MDS)リポジトリにカスタマイズとして格納されることです。MDSは、デプロイされた元のバージョンのadf-config.xmlおよびconnections.xmlをベース・ドキュメントとして使用し、単一のカスタマイズ・レイヤーを使用して後続のすべてのカスタマイズを別個にMDSに格納します。将来、アプリケーションが再デプロイされる場合、以前の構成の変更がすべて保持されます。

WebCenter Portalが起動すると、MDSに格納されているアプリケーション・カスタマイズが適切なベース・ドキュメントに適用され、アプリケーションは、マージ済ドキュメント(カスタマイズが適用されたベース・ドキュメント)を構成プロパティの最終セットとして使用します。

この項では、次の内容について説明します。

- MDSのデプロイ後のカスタマイズの確認

- MDSカスタマイズが含まれている構成ファイルのエクスポート

- 構成の競合の処理

- adf-config.xmlまたはconnections.xmlのMDSカスタマイズの削除

MDSカスタマイズの詳細は、『Oracle Fusion Middlewareの管理』のMDSリポジトリの理解に関する項を参照してください。

A.1.1.1 MDSのデプロイ後のカスタマイズの確認

デプロイ後、常にFusion Middleware ControlまたはWLSTコマンドを使用して、最新の構成を確認するか、または構成を変更します。Fusion Middleware Controlでは、多くの場合、WebCenter Portal固有の構成画面を使用しますが、役立つシステムMBeanブラウザは、構成設定の確認にも使用できます。これらのツールは常に現在の構成を示すため、通常、ベース・ドキュメントのコンテンツや、adf-config.xmlおよびconnections.xmlなどのファイルのMDSカスタマイズ・データを調べたり変更したりする必要はありません。

MDSの情報を参照することは役立つ場合があります。なんらかの理由で、MDSに格納される構成ファイルのカスタマイズを抽出するか調べる必要がある場合は、WLSTコマンドexportMetadataを使用してください。

注意:

構文の詳細と例は、『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』のexportMetadataに関する項を参照してください。

たとえば、アプリケーション名がwebcenterで、WC_Portal管理対象サーバーにデプロイされるWebCenter Portalのconnections.xmlのMDSカスタマイズを決定するには、ファイル名および場所は常に/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xmlであり、次のように指定できます。

exportMetadata(application='webcenter', server='WC_Portal',
toLocation='/tmp/mydata',
docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

同様に、adf-config.xmlのMDSカスタマイズを決定するには、次のように指定できます。

exportMetadata(application='webcenter', server='WC_Portal',
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に保存されます。

要求されたファイルに対してカスタマイズが存在しない場合、指定された場所には何も保存されず、同じ場所に以前に抽出されたカスタマイズは上書きされません。

A.1.1.2 MDSカスタマイズが含まれている構成ファイルのエクスポート

システムMBeanブラウザを使用して、adf-config.xmlまたはconnections.xmlなど、構成ファイルの現在のバージョン、つまり、MDSカスタマイズとマージされたベース・ドキュメントが含まれているバージョンのファイルを取得できます。

MDSカスタマイズを含むadf-config.xmlまたはconnections.xmlをシステムMBeanブラウザからエクスポートするには:

1. Fusion Middleware Controlにログオンし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「システムMBeanブラウザ」を選択します。

3. 「アプリケーション定義のMBean」を開きます。

4. エクスポートするファイルに関連付けられていたMBeanに移動します。

たとえば、adf-config.xmlまたはconnections.xmlのMBeansに移動する手順は、次のとおりです。

- adf-config.xml: 「oracle.adf.share.config」→「サーバー: WC_Portal」→「アプリケーション: webcenter」→「ADFConfig」→「ADFConfig」

- connections.xml: 「oracle.adf.share.connections」→「サーバー: WC_Portal」→「アプリケーション: webcenter」→「ADFConnections」→「ADFConnections」をクリックします

5. 「操作」タブをクリックします。

6. 「エクスポート」をクリックします。

あるいは、「ExportToDisk」をクリックしてXMLファイルのサーバーの場所を指定します。

7. 「起動」をクリックします。

「エクスポート」操作を選択した場合、XMLファイルの内容が画面に表示されます(図A-1)。

図A-1 MDSカスタマイズが含まれている構成ファイルのエクスポート

A.1.1.3 構成の競合の処理

MDSカスタマイズは、挿入/削除/置換えが必要な要素およびその場所をコールするために、ベース・ドキュメントの要素への参照を使用します。要素が誤って今後の再デプロイから削除され、MDSにその要素への参照が含まれる場合、WebCenter Portalアプリケーションの構成は破損している可能性があります。

この問題に直面しない可能性がありますが、adf-config.xmlまたはconnections.xmlに変更を行った後で、以前にデプロイされたアプリケーションが破損している可能性がある場合は、次のオプションを使用します。

- 競合の原因となっているMDSカスタマイズを手動で削除します。

1. adf-config.xmlまたはconnections.xmlのMDSカスタマイズ情報を抽出します。
たとえば、WebCenter Portalでは次のように指定します。

exportMetadata(application='webcenter', server='WC_Portal',
toLocation='/tmp/mydata',
docs='/META-INF/mdssys/cust/adfshare/adfshare/adf-config.xml.xml')

exportMetadata(application='webcenter', server='WC_Portal',
toLocation='/tmp/mydata',
docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

2. ドキュメントから競合の原因となっているカスタマイズ手順を削除します。

3. 変更されたドキュメントをMDSにインポートします。
たとえば、WebCenter Portalでは次のように指定します。

importMetadata(application='webcenter', server='WC_Portal',
fromLocation='/tmp/mydata',
docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

importMetadata(application='webcenter', server='WC_Portal',
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を使用して、最初からアプリケーションを再構成する必要もあります。
『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』のexportMetadataに関する項とimportMetadataに関する項を参照してください。

A.1.1.4 adf-config.xmlまたはconnections.xmlのMDSカスタマイズの削除

この項では、connections.xmlまたはadf-config.xmlのすべてのデプロイ後の構成を削除する方法について説明します。この操作は元に戻せません。カスタマイズは永久に削除されます。

MDSカスタマイズを削除する場合、次に示す手順を実行する前に、exportMetadataコマンドを使用して、既存のファイルのコピーを保存することをお薦めします。構文の詳細と例は、『インフラストラクチャ・コンポーネントWLSTコマンド・リファレンス』のexportMetadataに関する項を参照してください。

1. exportMetadataコマンドを使用して、connections.xmlおよびadf-config.xmlをバックアップします。

たとえば、WebCenter Portalでは次のように指定します。

exportMetadata(application='webcenter', server='WC_Portal',
toLocation='/tmp/mydata',
docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

exportMetadata(application='webcenter', server='WC_Portal',
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_Portal',
docs='/META-INF/mdssys/cust/adfshare/adfshare/connections.xml.xml')

3. WLSTを使用して、adf-config.xmlのカスタマイズを削除します。

たとえば、WebCenter Portalでは次のように指定します。

deleteMetadata (application='webcenter', server='WC_Portal', 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プロパティは静的であるため、アプリケーションの.parファイルを生成してデプロイする前に設計時にアプリケーションに対して指定されます。デプロイされた環境で一部のプロパティを変更する必要がある場合は、「デプロイメント設定」ページの「Webモジュールの構成」画面から一部のプロパティを編集できます。

connections.xmlおよびadf-config.xmlと異なり、web.xmlはデプロイ後のカスタマイズをMDSに格納しません。また、Fusion Middleware ControlまたはWLSTコマンドを使用して、WebCenter Portalなどの既存のデプロイでweb.xmlを変更できません。

注意:

WebCenter Portalのweb.xmlは、デプロイ後に編集しないでください。インストール環境を破損するおそれがあるため、アプリケーションの.parファイルを展開することはお薦めしません。

web.xmlの変更が必要になるケースはごくわずかです。たとえば、次のものを変更する場合があります。

- コンテンツ・リポジトリ・アップロード・パラメータ: UPLOAD_MAX_MEMORY、UPLOAD_MAX_DISK_SPACEおよびUPLOAD_TEMP_DIR。
WebCenter Portalでは、webcenter-config.xmlでuploadedFileMaxDiskSpaceパラメータを使用して、ファイルの最大アップロード・サイズを構成します。詳細は、「webcenter-config.xml」を参照してください。

- HTTPセッションの失効後の経過時間。
「セッション・タイムアウト設定の指定」を参照してください。

- 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にアクセスできます。Internet Explorerでは、「ツール」メニューを選択し、「互換表示設定」を選択します。「互換表示設定」ダイアログで、すべてのオプションを選択解除し、「閉じる」をクリックします。

A.1.3 webcenter-config.xml

webcenter-config.xmlは、初期状態のアプリケーションであるWebCenter Portalの構成ファイルです。このファイルには、アプリケーション名、ロゴなどのアプリケーションレベルの設定が含まれています。このファイルのプロパティのほとんどは、WebCenter Portal管理画面から管理されるため、webcenter-config.xmlを直接編集する必要はありません。詳細は、「WebCenter Portal管理の設定ページの理解」および「ポータル間のグローバルなデフォルト設定の構成」を参照してください。

webcenter-config.xmlの設定の手動変更が必要になるケースはごくわずかです。たとえば、次のものを変更する場合があります。

- 最大ファイル・アップロード・サイズ(uploadedFileMaxDiskSpace): デフォルト設定は2GBです。この設定は、wiki、ブログ、アクティビティ・ストリームなどの機能からアップロードされるファイルの最大アップロード・サイズを指定する場合に適用できます。

注意:
コンテンツ・マネージャを使用してアップロードされるファイルの最大アップロード・サイズの指定の詳細は、「コンテンツ・マネージャでのファイル・アップロード・サイズの変更」を参照してください。

この設定を変更する場合は、次のように、MDSからwebcenter-config.xmlの最新バージョンをエクスポートし、uploadedFileMaxDiskSpace値を変更する必要があります。

1. 最新のwebcenter-config.xmlをMDSからエクスポートします。

例:

exportMetadata(application='webcenter', server='WC_Portal',
toLocation='/tmp/mydata',
docs='/oracle/webcenter/webcenterapp/metadata/mdssys/cust/site/webcenter/webcen
ter-config.xml.xml')

注意:

webcenter-config.xmlは、WebCenter Portal管理の「一般」ページでグローバルなデフォルト設定を初めて構成したときに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_Portal',
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構成の変更は、クラスタ内のすべてのノードに表示されます。動的ではない構成の変更を反映させるには、クラスタ内のすべてのノードを再起動する必要があります。「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

WebCenter Portalでは、Fusion Middleware ControlまたはWLSTを使用して行ったほとんどの構成変更は動的ではありません。たとえば、様々なツールおよびサービス(分析、お知らせ、ディスカッション、ドキュメント、イベント、メール、インスタント・メッセージおよびプレゼンス、検索、ワークリストなど)の接続詳細を追加または変更する場合は、アプリケーションの管理対象サーバーを再起動する必要があります。ただし、2つの例外があり、ポートレット・プロデューサおよび外部アプリケーションの登録は動的です。登録した新規ポートレット・プロデューサや外部アプリケーションは、アプリケーションで即座に使用可能になります。既存の接続に対して行った変更も即座に有効になります。

クラスタ環境で構成ファイルを編集する場合、クラスタ構成全体で同期を維持できるように、各クラスタ・メンバーで同一の変更が行われていることを確認する必要があります。

A.3 構成ツール

WebCenter Portalのデプロイメントを構成するための様々なツールがあります。この項では、利用可能なツールについて概説します。

注意:

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アプリケーションのデプロイ・プランを使用することです。デプロイメントで変更される一般的なプロパティには次のものがあります。

- 接続用のホスト/ポートのプロパティ

- web.xmlの標準J2EEアーティファクト

注意:

このように再構成が可能な場合は、行ったメタデータ・リポジトリおよびADF接続構成の変更は、デプロイ・プランの一部として保存されません。すなわち、デプロイされるアーカイブで保存されます。したがって、構成の変更を後続の再デプロイで繰り返す必要があります。

アプリケーションを複数回、再デプロイする場合は、Fusion Middleware ControlまたはWLSTコマンドを使用して、デプロイ後の構成を実行することをお薦めします。こうすれば、構成の変更はMDSで保存され、再デプロイ時にそのまま維持されます。

A.4 コンテンツ・マネージャでのファイル・アップロード・サイズの変更

コンテンツ・マネージャを介してアップロードされるファイルの最大サイズを設定できます。デフォルトのアップロード・サイズは50MBです。

注意:
wiki、ブログ、アクティビティ・ストリームなどの機能からアップロードされるファイルの最大アップロード・サイズの指定の詳細は、「webcenter-config.xml」を参照してください。

システムMBeanブラウザを使用して、コンテンツ・マネージャでファイルに許可される最大アップロード・サイズを指定するには、次のようにします。

1. Fusion Middleware Controlにログオンし、WebCenter Portalのホームページに移動します。詳細は、「WebCenter Portalのホームページへの移動」を参照してください。

2. 「WebCenter Portal」メニューから、「システムMBeanブラウザ」を選択します。

3. 「アプリケーション定義のMBean」のadf-config MBean下のWccAdfConfiguration属性に移動します。
「oracle.adf.share.config」→「サーバー: WC_Portal」→「アプリケーション: webcenter」→「ADFConfig」→「ADFConfig」→「ADFConfig」→「WccAdfConfiguration」

4. MaximumUploadedFileSize属性に、必要なファイル・サイズをバイト単位で指定します。

図A-2 MaximumUploadedFileSize属性の変更

5. 高可用性環境では、ファイルを格納する一時的な場所を指定するために一時ディレクトリ属性を更新する必要があります。一時ディレクトリ属性では、ノード1およびノード2の両方がこのディレクトリ下に格納されたアップロード・ファイルにアクセスできるように、ディレクトリを設定する必要があります。

6. adf-config MBeanに移動して、保存操作を起動します。
「oracle.adf.share.config」→「サーバー: WC_Portal」→「アプリケーション: webcenter」→「ADFConfig」→「ADFConfig」をクリックします

7. 「操作」タブをクリックします。

8. 「save」操作リンクをクリックします。

図A-3 MBeanの変更の保存

9. 「操作: save」ページで、「起動」をクリックして、前回の保存操作以降に行われたすべてのMBeanの変更をコミットします。

10. WC_Portal WebCenter Portal管理対象サーバーを再起動します。

B WebCenter PortalのOracle HTTP Server構成

この付録では、WebCenter Portalに必要なOracle HTTP Server構成について説明します。

B.1 Oracle HTTP Server構成

この項には次のトピックが含まれます:

- Oracle HTTP Serverを使用するシナリオ

- サンプルのmod_wl_ohs.conf

- OHSの構成

B.1.1 Oracle HTTP Serverを使用するシナリオ

Oracle WebCenter PortalコンポーネントがOracle WebLogic Server上で実行している場合、Oracle WebLogic ServerへのフロントエンドとしてOracle HTTP Server (OHS)を設定できます。フロントエンドとしてOHSが必要なシナリオの一部は、次のとおりです。

- Site StudioとOracle Content Server間でOSSOが正しく機能するため。これはOHSのmod_ossoを介して実現されます。

- Oracle WebLogic Serverクラスタ・ノード間で適切な負荷の分散を行うため。これはOHSのmod_wlを介して実現されます。

- OHSはOAMのWebGateコンポーネント用に必要です。

- OHSはリバース・プロキシとして使用されます。

これらの場合、mod_wl_ohsモジュールを構成して、リクエストをOHSからOracle WebLogic Serverへプロキシ可能にする必要があります。

B.1.2 サンプルのmod_wl_ohs.conf

mod_wl_ohs.confファイルのデフォルトの場所は、OHS_HOME/Oracle_WT1/instances/instance1/config/OHS/ohs1/mod_wl_ohs.confです。Fusion Middleware Controlを使用してmod_wl_ohsモジュールを構成した後で、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>
SetHandler weblogic-handler
WeblogicHost discuss.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>
# 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>

B.1.3 OHSの構成

SSLディレクティブ

SSLを構成している場合、次の追加のディレクティブが必要です。

- WLProxySSL ON

- WLProxySSLPassThrough ON

たとえば、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_Portal管理対象サーバーが停止している場合、ユーザーはhttp://company.com/error.htmlにリダイレクトされます。任意の管理対象サーバーがオンラインになると、ユーザーは通常どおりWebCenter Portalにアクセスできます。

『Oracle HTTP Server管理者ガイド』のmod_wl_ohsの構成に関する項も参照してください。

C サード・パーティ製品のサポート

この付録は、WebCenter Portalと併用できるサード・パーティ製品の一覧表です。

C.1 サード・パーティ製品のサポート

表C-1では、WebCenter Portalで使用できるサード・パーティ製品を一覧表示しています。

表C-1 WebCenter Portal: サード・パーティ製品のサポート

機能

製品とバージョン

詳細

データベース

Microsoft SQL Server 2005、Microsoft SQL Server 2008

Oracle Fusion Middlewareのサポートされるシステム構成ページも参照してください

アイデンティティ・ストア

サポートされているLDAPアイデンティティ・ストアのタイプ

デフォルトのアイデンティティ・ストアおよびポリシー・ストア

イベント

Microsoft Exchange Server 2007、Microsoft Exchange Server 2010、Microsoft Exchange Server 2013

イベントの個人イベントに関する前提条件

メール

Microsoft Exchange Server 2007、Microsoft Exchange Server 2010、Microsoft Exchange Server 2013

WebCenter PortalのためのMicrosoft Exchange Server 2007、2010または2013の構成

プレゼンス

Microsoft Lync 2010

インスタント・メッセージおよびプレゼンス・サーバーの前提条件

D WebCenter PortalへのWikiコンテンツの移行

この付録では、カスタムwiki抽出ツールをドキュメント移行ユーティリティと組み合せて使用することで、wikiコンテンツをConfluenceなどのwikiアプリケーションからWebCenter Portalに移行する方法について説明します。カスタムwiki抽出ツールは、ドキュメント移行ユーティリティを使用して、wikiコンテンツをWebCenter Portalコンテンツ・リポジトリにインポート可能なアーカイブ形式に抽出します。

注意:

ポータル・フォルダとポータル・テンプレート・フォルダのエクスポートまたはインポートにドキュメント移行ユーティリティを使用しないでください。

この付録にリストされているタスクを実行できるようにするには、ポータル、ポータル・テンプレート、wikiドキュメントおよびwikiページに対してContent Serverで作成したコンテンツの理解とともにドキュメント移行ユーティリティおよびそのアーカイブの形式についての詳細な理解が必要です。

この付録の内容は次のとおりです。

- WikiドキュメントおよびWikiページの理解

- ソースWikiアプリケーションからWebCenter Portalへのデータの移行

D.1 WikiドキュメントおよびWikiページの理解

この項では、WebCenter Portalでのwikiドキュメントおよびwikiページの形式とその動作方法について説明します。WebCenter Portalでのwikiドキュメントおよびwikiページの詳細は、『Oracle WebCenter Portalの使用』のWikiでの作業に関する項を参照してください。

この項では、次の項目について説明します。

- Wikiドキュメントの理解

- Wikiページの理解

D.1.1 Wikiドキュメントの理解

WebCenter Portalでは、wikiページ内で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ドキュメントとして表示します。

D.1.2 Wikiページの理解

WebCenter Portalで、Wikiページ・スタイルに基づいてページを作成することによりwikiページを作成できます。wikiページに移動すると、wikiドキュメントが表示されます。wikiページの作成方法の詳細は、『Oracle WebCenter Portalの使用』のWikiでの作業に関する項を参照してください。

wikiページがWebCenter Portalで作成される場合、次のアーティファクトがContent Serverで作成されます。

- wikiフォルダが、wikiページが作成されているポータルのフォルダに作成され、wikiフォルダの名前はwikiページ名と同じですが、特殊文字が削除されています。
/RootFolder/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で作成されます。

- フォルダ: /Enterprise Libraries/Marketing/Wiki1

- ドキュメント: /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フォルダのコンテンツが表示されます。

D.2 ソースWikiアプリケーションからWebCenter Portalへのデータの移行

既存のwikiアプリケーションからWebCenter Portalにコンテンツを移行するには、次の手順を実行します。

1. wikiコンテンツのインポート用にWebCenter Portalを準備します。

2. カスタムwiki抽出ツールを記述して実行し、Wikiアプリケーションからアーカイブ(ドキュメント移行ユーティリティで期待される正確な形式に一致している必要がある)にコンテンツを抽出します。

3. ドキュメント移行ユーティリティを使用して、Content Serverにアーカイブをインポートします。

4. WebCenter Portalでwikiページを作成し、Content Serverのコンテンツを関連付けます。

これら手順は、次の項で詳細に説明します。

- WikiコンテンツのインポートのためのWebCenter Portalの準備

- Wikiアプリケーションからコンテンツを抽出するためのカスタムWiki抽出ツールの記述と実行

- ドキュメント移行ユーティリティを使用したターゲット・ポータルへのアーカイブのインポート

- WebCenter Content Serverのコンテンツに対するWebCenter PortalのWikiページの作成

D.2.1 WikiコンテンツのインポートのためのWebCenter Portalの準備

ドキュメント・ツールがポータルまたはポータル・テンプレートで有効になっている場合、フォルダがそのポータルまたはポータル・テンプレートに対してContent Serverで作成されます。これらのフォルダのGUIDは、ドキュメント移行ユーティリティとともに使用するアーカイブを構築するために決定される必要があります。フォルダGUIDは次の手順で決定されます。

1. すべてのwikiコンテンツを単一ポータルまたは複数のポータルにインポートするかどうかを決定します。

2. WebCenter Portalにログインし、ポータルを作成して、ポータルの内部名をメモします。
ドキュメント・ツールを含むテンプレートを使用していることを確認します。そうでない場合、ドキュメント・ツールを有効にして、ポータル作成後にロール権限を設定する必要があります。

3. Content Serverにログインします。

4. ユーザーのレイアウトが「トップ・メニュー」であることを確認します。

a. ユーザー名をクリックして、ユーザーのプロファイル・ページを表示します。

b. 「ユーザーのパーソナライズの設定」の下で、「レイアウト」をTop Menuに設定していることを確認します。

5. wikiコンテンツがインポートされる各ポータルに対して、フォルダGUIDを決定します。

a. 「コンテンツの参照」をクリックします。

b. WebCenter Portalインスタンスのルート・フォルダをクリックします。
これは、Content Server接続のRoot Folder設定と同じです。

c. ポータルのフォルダをクリックします。
フォルダ名は、ポータルの内部名と同じです。

d. フォルダ情報を表示するには、ツールバーの「情報」をクリックします。

e. URLにIsSoap=1を追加します。

f. 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をメモします。

D.2.2 Wikiアプリケーションからコンテンツを抽出するためのカスタムWiki抽出ツールの記述と実行

ソースwikiアプリケーションから、ドキュメント移行ユーティリティとともに使用するのに適したアーカイブにコンテンツを抽出するには、カスタム・アプリケーションを記述する必要があります。

カスタム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コンテンツのアーカイブを作成します。

これらの各手順については、次の項で詳細に説明します。

- Wikiコンテンツの抽出と配置

- WikiドキュメントのソースHTMLのクリーンアップ

- URLのリライト

- ExportImportData.xmlドキュメントの構築

- アーカイブ・ファイルの構築

D.2.2.1 Wikiコンテンツの抽出と配置

ソース・アプリケーションのwikiドキュメントはファイル・システムの一時ディレクトリに抽出され、コンテンツがターゲットWebCenter Portalインスタンスにレイアウトされる方法をファイル・システムが模倣するように配置される必要があります。すべてのwikiドキュメントが単一ポータルにインポートされる場合、Content Serverの対応するポータル・フォルダのGUIDを使用して名付けられている単一のルート・フォルダの下にコンテンツのすべてが配置される必要があります。wikiドキュメントが複数のポータルにインポートされる場合、Content Serverの対応するフォルダのGUIDを使用して名付けられている複数のルート・フォルダの下にコンテンツが配置される必要があります。Content Serverにおけるポータル・フォルダのGUIDの決定の詳細は、「WikiコンテンツのインポートのためのWebCenter Portalの準備」を参照してください。

ファイル・システムにwikiコンテンツを配置する場合は、そのコンテンツのWebCenter Portalでの使用方法を考慮する必要があることに注意してください。例:

- wikiページが作成される場合は、wikiページのwikiドキュメントが同じ名前のフォルダの下にある必要があります。wikiページの詳細は、「WikiドキュメントおよびWikiページの理解」を参照してください。

- フォルダに多数のコンテンツが含まれている場合は、そのフォルダのコンテンツのレンダリングに障害が発生する可能性があります。

- Content Serverには、フォルダ数とフォルダ内に格納可能なファイル数を制限する2つの設定があります(「仮想フォルダ当たりの最大フォルダ数」および「仮想フォルダ当たりの最大コンテンツ数」)。wikiコンテンツを配置する場合は、フォルダ制限設定より多くのフォルダおよびドキュメント制限設定より多くのドキュメントがフォルダにないことを確認してください。

抽出したwikiコンテンツを作成するには、次のタスクを実行します。

1. wikiドキュメントをインポートする先の各ポータルのルート・フォルダを作成し、Content Serverの対応するポータル・フォルダのGUIDに基づいてフォルダに名前を付けます。

2. インポート後に、wikiページがWebCenter Portalで作成されるwikiドキュメントに対して行う操作は次のとおりです。

a. wikiドキュメントと同じ名前を持つwikiフォルダを作成します。

b. このフォルダにwikiドキュメントを配置します。

c. 必要に応じて、このフォルダに他のドキュメントを配置します。

d. 関連するイメージおよび/またはドキュメントがある場合は、同様にそれらのドキュメントをこの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)

D.2.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>

D.2.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の決定の詳細は、「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>

D.2.2.4 ExportImportData.xmlドキュメントの構築

インポートされるコンテンツを含む各ルート・フォルダで、ExportImportData.xmlドキュメントを作成する必要があります。ExportImportData.xmlドキュメントは、ルート・フォルダのコンテンツを記述し、ドキュメント移行ユーティリティを使用してWebCenter Portalにコンテンツをインポートする際にインポートを実行するために使用されます。

インポート時にドキュメントとともに作成されるメタデータは、ExportImportData.xmlドキュメントで指定する必要があります。WebCenter Portalでは、wikiドキュメントはHTMLドキュメントとして格納されますが、通常のHTMLドキュメントではなくwikiドキュメントとして識別するための追加のメタデータを持ちます。ExportImportData.xmlドキュメントが、抽出されたコンテンツのすべてのwikiドキュメントに対してこのメタデータを指定していることを確認してください。wikiドキュメントに必要なメタデータの詳細は、「WikiドキュメントおよびWikiページの理解」を参照してください。

注意:

コンテンツID (dDocName)は、ドキュメントが指定されずにチェックインされるときに、Content Serverによって自動的に生成されます。ドキュメントのコンテンツIDを固定する場合は、ExportImportData.xmlドキュメントにドキュメント・メタデータとともにdDocNameメタデータを含めてください。dDocNameは、Content Server全体で一意である必要があります。そうでない場合、ドキュメントのチェックインは失敗します。コンテンツIDに独自の接頭辞を選択し、末尾に番号を順次追加することをお薦めします。

ExportImportData.xmlドキュメントは、ルート・フォルダごとに手動で生成できます。または、カスタム・スクリプトを記述して、ルート・フォルダのコンテンツを通過し、ドキュメントを生成することができます。

ファイル・システムのコンテンツの構造が、ExportImportData.xmlドキュメントで正しく詳述されている必要があります。ExportImportData.xmlドキュメントとファイル・システムで記述されるコンテンツの階層間で不一致がある場合、ターゲットContent Serverのポータル・フォルダへのインポートは失敗します。

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>タグが必要です。他の子タグは許可されません。

次の注釈付きの例は、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>

この例では、convert_programという名前のカスタム・スクリプトが、21SD15F13B8_141D_421B_AD0e_BC54B6F16893というルート・フォルダを通過して、フォルダのコンテンツを詳述している現在作業中のディレクトリにExportImportData.xmlドキュメントを作成します。

cd 21SD15F13B8_141D_421B_AD0e_BC54B6F16893
run convert_program

D.2.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/

注意:

一部の圧縮ツールがアーカイブを上書きするのではなく、すでに存在している場合、指定されたアーカイブにコンテンツを追加するため、フォルダ・コンテンツを圧縮する前に、アーカイブが存在していないことを確認してください。

D.2.3 ドキュメント移行ユーティリティを使用したターゲット・ポータルへのアーカイブのインポート

ターゲットContent Serverにコンテンツをインポートするには、前の手順で生成されたアーカイブを指定して、ドキュメント移行ユーティリティを実行します。

WebCenter Portalにログインして、コンテンツがインポートされたポータルに移動して、コンテンツが存在することを確認します。

D.2.3.1 ドキュメント移行ユーティリティの実行に必要なプロパティ

表D-1に、ドキュメント移行ユーティリティの実行に必要なプロパティを示します。ユーティリティの実行方法の詳細は、「ドキュメント移行ユーティリティを使用したコンテンツの移行」を参照してください。

表D-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です。

エクスポートおよびインポート

D.2.3.2 ドキュメント移行ユーティリティを使用したコンテンツの移行

ドキュメント移行ユーティリティを使用した次の方法のいずれかを使用して、コンテンツを移行できます。

- プロパティ・ファイルでのドキュメント移行プロパティの指定

- コマンド行でのドキュメント移行プロパティの指定

- 求められた場合のコマンド行でのドキュメント移行プロパティの指定

D.2.3.2.1 プロパティ・ファイルでのドキュメント移行プロパティの指定

1. エクスポート/インポートに必要なすべてのプロパティを含むプロパティ・ファイルを作成します。すべてのプロパティの説明は、表D-1を参照してください。

a. 次のプロパティ・ファイルをメモ帳または別の適切なテキスト・エディタにコピーして貼り付け、環境に応じて編集します。

# 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

b. ファイルを保存します。たとえば、myMigrationProperties.propertiesとして保存します。

2. ドキュメント移行ユーティリティcontent-migration-tool.jarがあるWCP_ORACLE_HOME/webcenter/archivesディレクトリに移動します。

3. 絶対パスをコマンド行上のドキュメント移行プロパティ・ファイルに指定することにより、ドキュメント移行ユーティリティを実行します。

java -jar content-migration-tool.jar <absolute_path_to_migrationPropertiesFilename>

例:

java -jar content-migration-tool.jar /home/user1/myMigrationProperties.properties

オプションで、「追加のログを指定したドキュメント移行ユーティリティの実行」の説明に従って、java.util.logging.config.fileパラメータを使用したログ設定を指定します。

D.2.3.2.2 コマンド行でのドキュメント移行プロパティの指定

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パラメータを指定できます。指定しない場合は、これらを指定するよう求められます。

オプションで、「追加のログを指定したドキュメント移行ユーティリティの実行」の説明に従って、java.util.logging.config.fileパラメータを使用したログ設定を指定します。

D.2.3.2.3 求められた場合のコマンド行でのドキュメント移行プロパティの指定

1. ドキュメント移行ユーティリティcontent-migration-tool.jarがあるWCP_ORACLE_HOME/webcenter/archivesディレクトリに移動します。

2. 求められた場合はコマンド行上でプロパティを指定することにより、ドキュメント移行ユーティリティを実行します。

java -jar content-migration.jar

オプションで、「追加のログを指定したドキュメント移行ユーティリティの実行」の説明に従って、java.util.logging.config.fileパラメータを使用したログ設定を指定します。

D.2.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

D.2.4 WebCenter Content Serverのコンテンツに対するWebCenter PortalのWikiページの作成

WebCenter Portal wikiページを使用して、インポートされたwikiを表示するには、次の手順を実行します。

1. WebCenter Portalにログインします。

2. コンテンツがアップロードされているポータルを検索します。

3. 「ページおよびポータルのアクション」メニューから「ページの作成」を選択します。

4. 「Wiki」ページ・スタイルを選択します。

5. 「タイトル」フィールドで、wikiドキュメントの名前を入力し、「作成」をクリックします。

wikiページの名前がWebCenter Portalのポータル・フォルダのフォルダ名と一致している必要があることに注意してください。このフォルダには同じ名前のwikiページが含まれています。

たとえば、ポータル・フォルダに、MarketingWikiフォルダとMarketingWiki.htmドキュメントがある場合、wikiページの名前は、MarketingWikiである必要があります。

wikiページの詳細は、『Oracle WebCenter Portalでのポータルの構築』のポータルでのWikiの有効化に関する項を参照してください。

E FrameworkFoldersへのFolders_gの移行

この付録では、Oracle WebCenter Content ServerでOracle WebCenter PortalコンテンツをFolders_gフォルダ・サービスからFrameworkFoldersフォルダ・サービスに移行する方法について説明します。

この付録の内容は次のとおりです。

- FrameworkFoldersへのFolders_gの移行の理解

- Folders_gおよびFrameworkFoldersのディレクトリ構造の理解

- WebCenter Portalデータの移行

- 移行に関する問題のトラブルシューティング

E.1 FrameworkFoldersへのFolders_gの移行の理解

Oracle WebCenter Contentでは、Folders_gおよびFrameworkFoldersという2つのフォルダ・ソリューションが提供されます。Folders_gコンポーネント(「コントリビューション・フォルダ」インタフェースとも呼ばれます)は、Content Serverのコンテンツに対して階層フォルダ・インタフェースを提供します。FrameworkFoldersコンポーネント(「フォルダ」インタフェースとも呼ばれます)は、従来のファイル・システムと同様に、リポジトリ内の一部またはすべてのコンテンツを編成および検索するための階層フォルダ・インタフェースを提供します。ただし、「フォルダ」はスケーラブルな企業ソリューションで、Content Server用のフォルダ・サービスとして「コントリビューション・フォルダ」を置き換えます。

Oracle WebCenter Portalは、コンテンツ・サーバー上のFrameworkFoldersコンポーネントをサポートしています。Folders_gフォルダ・サービスを使用していた以前のリリースからパッチを適用したOracle WebCenter Portalインスタンスの場合、FrameworkFoldersフォルダ・サービスに移行する必要があります。

注意:

FrameworkFoldersは、以前のFolders_gコンポーネントに置き換わるコンポーネントの名前です。以前のフォルダ・インタフェースはコントリビューション・フォルダと呼ばれるようになりました。FrameworkFoldersコンポーネントによりサポートされるインタフェースはFoldersと呼ばれます。

この章では、FrameworkFoldersとFolders_gという用語を使用して移行プロセスを説明します。UIの選択またはコマンドを指す場合を除き、FrameworkFoldersという用語はFoldersと同義で使用され、Folders_gという用語はコントリビューション・フォルダと同義で使用されます。

移行手順の詳細は、『Oracle WebCenter Contentの管理』のFolders_gからFoldersへの移行に関する項を参照してください。

E.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

図E-1は、Content ServerのFolders_gおよびFrameworkFolders設定で、WebCenter Portalフォルダが整理される方法を示しています。Folders_g設定の場合、ユーザーKaren、MontyおよびSamの個人フォルダは、PersonalSpacesの下に整理され、ポータルHR PortalとPartner Portalは、WebCenter Portalルート・フォルダWebCenter0202の下に整理されています。FrameworkFolders設定の場合、個人フォルダKaren、MontyおよびSamとポータル・フォルダHR PortalおよびPartner Portalは、Enterprise Librariesの下に整理されてます。

図E-1 Content ServerのFolders_gおよびFrameworkFoldersのフォルダ構造

たとえば、KarenがFolders_g設定でホーム・ポータルに新しいフォルダを作成した場合、この新しいフォルダは、図E-2に示すように、/PersonalSpaces/Karenの下に作成されます。

図E-2 Folders_gが有効な場合のフォルダ・パス

KarenがFrameworkFolders設定でホーム・ポータルに新しいフォルダを作成した場合、この新しいフォルダは、図E-3に示すように、/Enterprise Libraries/Karenの下に作成されます。

図E-3 FrameworkFoldersが有効な場合のフォルダ・パス

Folders_gおよびFrameworkFoldersのアイテム・レベルのセキュリティ

Folders_g設定では、ファイルおよびフォルダにアイテム・レベル・セキュリティ(ILS)を設定できます。ファイルに独自のILSが定義されている場合を除き、フォルダのILS設定はファイル内のすべてのファイルに継承されます。FrameworkFolders設定では、ILSはファイルにのみ設定できます。ILSはフォルダには設定できません。

Folders_gからFrameworkFoldersに移行後は、フォルダにILSを設定することはできませんが、そのフォルダに含まれる各ファイルのILS設定は保持されます。移行後、ファイルレベルのILS設定を更新または削除できます。

E.3 WebCenter Portalデータの移行

ここでは、WebCenter PortalコンテンツをFolders_gからFrameworkFoldersに移行する手順について説明します。

この項では、次の内容について説明します。

- 移行ロードマップ

- exportFoldersGDataの実行による移行前データの生成

- FrameworkFoldersへのWebCenter Portalメタデータの移行

- migrateFoldersGDataToFrameworkFoldersの実行による移行したデータの検証

E.3.1 移行ロードマップ

この項のフロー・チャート(図E-4)と表(表E-1)で、WebCenter PortalコンテンツのFolders_gからFrameworkFoldersへの移行に必要な手順について概説します。

注意:

クラスタ環境では、1つのWebCenter Portal管理対象サーバーと1つのWebCenter Content管理対象サーバー以外のすべての管理対象サーバーを停止する必要があります。移行WLSTコマンドは、必ずWebCenter Portalが実行されているマシンから実行するようにしてください。

非クラスタ環境では、WebCenter PortalおよびWebCenter Content管理対象サーバーが別々のマシンで実行されている場合、移行WLSTコマンドはWebCenter Portalが実行されているマシンから実行してください。

図E-4 WebCenter PortalデータのFolders_gからFrameworkFoldersへの移行

表E-1 WebCenter PortalデータのFolders_gからFrameworkFoldersへの移行

タスク

説明

ドキュメント

WLSTコマンドexportFoldersGDataの実行

WLSTコマンドexportFoldersGDataをWebCenter Portal Oracleホーム・ディレクトリから実行して、移行前データを生成します。

exportFoldersGDataの実行による移行前データの生成。

WebCenter PortalのFolders_gメタデータのFrameworkFoldersへの移行

Content Serverで移行ユーティリティを実行して、WebCenter PortalデータをFolders_gからFrameworkFoldersに移行します。

FrameworkFoldersへのWebCenter Portalメタデータの移行。

WLSTコマンドmigrateFoldersGDataToFrameworkFoldersの実行

WLSTコマンドmigrateFoldersGDataToFrameworkFoldersをWebCenter Portal Oracleホーム・ディレクトリから実行して、移行したデータを検証します。

migrateFoldersGDataToFrameworkFoldersの実行による移行したデータの検証。

すべての管理対象サーバーの再起動

WebCenter PortalおよびContent Server管理対象サーバーを含むすべての管理対象サーバーを再起動します。

『Oracle Fusion Middlewareの管理』のOracle WebLogic Serverインスタンスの起動および停止に関する項を参照してください。

E.3.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/')

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのexportFoldersGDataに関する項を参照してください。このコマンドは、WebCenter Portal Oracleホーム・ディレクトリから実行する必要があります。WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

WebCenter PortalデータをFrameworkFoldersに移行した後、exportFoldersGDataで生成された移行前データを使用してデータ整合性レポートを生成し、移行したファイルおよびフォルダのサニティを確認できます。

WLSTコマンドexportFoldersGDataにより、次のタスクが実行されます。

- WebCenter Portalルート・フォルダの下にあるすべてのポータル・フォルダの移行前メタデータを生成します

- ホーム・ポータル・ルート・フォルダの下にあるすべてのユーザー・フォルダの移行前メタデータを生成します

- 生成されたメタデータをPreMigrationData.csvファイルに書き込みます。

- すべてのMDSドキュメントがエクスポートされます

PreMigrationData.csvファイルには、Folders_gデータ構造に格納されているポータル・フォルダおよびユーザー・フォルダの次のメタデータが含まれます。

- WebCenter Portalルート・フォルダまたはホーム・ポータル・ルート・フォルダのフォルダ名

- dCollectionGUID。Content Server上の該当するフォルダへのポータルのマップのためにWebCenter Portalによって使用される識別子

- dCollectionID。フォルダを一意に識別するためにFolders_gで使用される識別子

- dCollectionName。フォルダ名

- dSecurityGroup。セキュリティ・グループ

- dDocAccount。アカウント名

デフォルトでは、PreMigrationData.csvは次のパスに格納されます: WCP_ORACLE_HOME/common/wlst/FG_FF_MIGRATION。WLSTコマンドexportFoldersGDataの実行中に、ファイルに別の場所を選択できます。

図E-5に、PreMigrationData.csvファイルのサンプルを示します。各行には、ポータル・フォルダまたはユーザー・フォルダのメタデータが表示されます。

図E-5 PreMigrationData.csvファイルのサンプル

E.3.3 FrameworkFoldersへのWebCenter Portalメタデータの移行

Content Serverにあるフォルダ移行ユーティリティを使用して、WebCenter Portalメタデータおよびフォルダ構造をFolders_gからFrameworkFoldersに移行します。

WebCenter PortalメタデータをFolders_gからFrameworkFoldersに移行するには:

1. 管理者としてContent Serverにログオンします。

2. FrameworkFoldersを有効にします。Folders_gも有効化されていることを確認します。詳細は、「必須コンポーネントの有効化」を参照してください。

注意:

Folders_gからFrameworkFolders設定に移行する際は、移行プロセスでFolders_gコンポーネントとFrameworkFoldersコンポーネントの両方を有効にする必要があります。

3. 必要な属性を追加します。

a. コンテンツ・サーバーにログオンします。

b. 「管理」→「管理サーバー」→「一般構成」に移動します。

c. 「追加の構成変数」ボックスに、次のエントリを追加します。
MigrationFormatForfApplicationGUID=dCollectionName:dCollectionGUID

DisableQueryTimeoutSupport=true

d. 「保存」をクリックします。

4. Content Serverを再起動して、管理者としてログオンします。

5. 「管理」、「フォルダ移行」の順に選択して、データ移行の実行を開始します。

6. PersonalSpacesルート・フォルダを移行します。

a. 「フォルダ移行」ページの「移行の実行」セクションで、「除外されたフォルダの変更」をクリックします。

b. 「フォルダ移行: 除外されたフォルダ」ダイアログで、移行から除外すべきフォルダを指定します。PersonalSpacesルート・フォルダ以外のすべてのフォルダが「移行から除外されるレガシー・フォルダ」ボックスに表示されていることを確認します。図E-6で、WebcenterSpaces-RootはWebCenter Portalルート・フォルダを指しています。

図E-6 移行から除外されるフォルダの指定

c. 「OK」をクリックします。

d. 「Migrate Folder Data」をクリックしてデータを移行します。

7. WebCenter Portalルート・フォルダを移行します。

a. 「移行の実行」セクションで「除外されたフォルダの変更」をクリックします。

b. 「フォルダ移行: 除外されたフォルダ」ダイアログで、WebCenter Portalルート・フォルダ以外のすべてのフォルダが「移行から除外されるレガシー・フォルダ」ボックスに表示されていることを確認します。図E-7で、WebcenterSpaces-RootはWebCenter Portalルート・フォルダを指しています。

図E-7 移行から除外されるフォルダの指定

c. 「OK」をクリックします。

d. 「Migrate Folder Data」をクリックしてデータを移行します。

8. 手順3で追加したMigrationFormatForfApplicationGUID属性を削除します。

9. Content Serverを再起動します。

10. コントリビューション・フォルダにWebCenter Portalで参照されるコンテンツが含まれている場合は、「コントリビューション・フォルダ」フォルダをエンタープライズ・ライブラリとして移行する必要があります。

a. 「移行の実行」セクションで「除外されたフォルダの変更」をクリックします。

b. 「フォルダ移行: 除外されたフォルダ」ダイアログで、「コントリビューション・フォルダ」以外のすべてのフォルダが「移行から除外されるレガシー・フォルダ」ボックスに表示されていることを確認します(図E-8)。

図E-8 移行から除外されるフォルダの指定

c. 「OK」をクリックします。

d. 「フォルダ移行先」セクションで「参照」をクリックして、フォルダの移行先を指定します。

e. 「参照」ダイアログで「Enterprise Libraries」を選択し、「OK」をクリックします。

f. 「フォルダ・データの移行」をクリックします。

11. PersonalSpaces、WebCenter Portalルート・フォルダおよびコントリビューション・フォルダにWebCenter Portalで参照されているコンテンツがある場合、これら以外のフォルダを移行します。手順10で使用したのと同じ手順に従います。
「フォルダ移行: 除外されたフォルダ」ダイアログで、移行する以外のすべてのフォルダが「移行から除外されるレガシー・フォルダ」ボックスに表示されていることを確認します。

12. Folders_gを無効にします。
「拡張コンポーネント・マネージャ」ページの「有効コンポーネント」リスト・ボックスで、Folders_gを選択し、「無効化」をクリックします。

13. Content Serverを再起動します。

14. リポジトリ・マネージャ・ユーティリティを使用して、コレクションを再構築し、検索索引を更新します。コレクションを再構築する際は、「インデクサの再構築」ダイアログで「高速再構築の使用」チェック・ボックスが選択解除されていることを確認します(図E-9)。詳細は、『Oracle WebCenter Contentの管理』の検索索引の操作に関する項を参照してください。

図E-9 索引の再構築

移行プロセス中に生成されるログは、WCC_DOMAIN/servers/UCM_server1/logsに保存されます(WCC_DOMAINはOracle WebCenter Contentドメインを示しています)。

E.3.4 migrateFoldersGDataToFrameworkFoldersの実行による移行したデータの検証

WLSTコマンドmigrateFoldersGDataToFrameworkFoldersを使用してFolders_gデータをFrameworkFoldersに移行し、移行したデータの整合性を確認します。

migrateFoldersGDataToFrameworkFolders(appName,server,contentDbConnectionUrl,contentDbUserName,[connectionName,directoryPath,reportMode,applicationVersion])

次の例では、Folders_gデータを/scratch/myTemp_DirディレクトリからFrameworkFoldersに移行し、WC_Portal管理対象サーバーにデプロイされたWebCenter Portalアプリケーションの移行済データを検証します。MyContentServerConnectionという名前のContent Server接続と指定したWebCenter Contentデータベース接続およびユーザー名を使用して、移行が実行されます。

migrateFoldersGDataToFrameworkFolders(appName='webcenter',server='WC_Portal',contentDbConnectionUrl='wccdbhost.example.com:wccdbport:wccdbsid', contentDbUserName='SCHEMA_PREFIX_OCS',connectionName='MyContentServerConnection',directoryPath='/scratch/myTemp_Dir/)

directoryPath属性で指定されるパスは、exportFoldersGData WLSTコマンドの実行中に指定したパスと同じである必要があります。

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのexportFoldersGDataに関する項を参照してください。WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

migrateFoldersGDataToFrameworkFoldersコマンドにより、次のタスクが実行されます。

- 移行したWebCenter Portalコンテンツのメタデータが生成され、WLSTコマンドexportFoldersGDataで生成された移行前メタデータに対して検証されます。移行した各フォルダがエンタープライズ・ライブラリであること、およびアカウント名とセキュリティ・グループの値が移行前メタデータと同じであることが検証されます。
データの不整合があった場合は、コマンド実行後に表示されるサマリー・テキストでレポートされ、次のデフォルトの場所にあるログ・ファイルにも保存されます: WCP_ORACLE_HOME/common/wlst/POST_MIGRATION/MigrationDiagnostic.log。

- Folders_g識別子dCollectionIDをFrameworkFolders識別子fFolderGUIDにマップするマッピング・ファイルMigrationMap.csvが作成されます。マッピング・ファイルはMigration_Directory/POST_MIgration/MigrationMap.csvに保存されます。
フォルダ名が変更された場合のために、ファイルにはFolders_gパスとFrameworkFoldersパスのマッピングも含まれます。たとえば、Montyという名前のユーザー・フォルダがあり、同じ名前のポータル・フォルダもあるとします。Folders_g設定で、ユーザー・フォルダMontyはPersonalSpacesルート・フォルダの下に表示され、ポータル・フォルダMontyはWebCenter Portalルート・フォルダの下に表示されます(WebCenter0202など)。移行時、PersonalSpacesフォルダが最初に移行されます。フォルダ名の競合を解決するために、ポータル・フォルダの名前はMonty(WebCenter0202)に変更されます(図E-10を参照)。このフォルダ・パスの変更は、マッピング・ファイルに保存されます。

図E-10 移行後のFrameworkFoldersのディレクトリ構造

- マッピング・ファイルを使用し、WLSTコマンドexportFoldersGDataで生成されたMDSドキュメントで、dCollectionID値をfFolderGUID値に置き換えます。また、WebCenter Portalルート・フォルダ名またはPersonalSpacesを含む古いパス参照が新しいパスに置き換えられます。たとえば、/PersonalSpaces/weblogicが/Enterprise Libraries/weblogicに置き換えられます。
不整合があった場合は、MigrationDiagnostic.logでレポートされます。トラブルシューティング情報は、「移行に関する問題のトラブルシューティング」を参照してください。

- 更新されたすべてのMDSドキュメントをインポートします。

E.4 移行に関する問題のトラブルシューティング

この項では、Folders_g設定をFrameworkFolders設定に移行する際に発生する可能性のある問題のトラブルシューティングに役立つ情報を提供します。

問題

WLSTコマンドmigrateFoldersGToFrameworkFoldersに表示される移行サマリーに、いくつかのMDSドキュメントに既知のパターンに準拠しないFolders_gパス参照が含まれるという警告が示されます。

解決策

WCP_ORACLE_HOME/common/wlst/POST_MIGRATIONディレクトリにあるMigrationDiagnostic.logファイルを手動で確認して、警告メッセージを探します。指定したファイルについて、Content Serverパス参照が有効かどうかを確認します。必要に応じて、Folders_gパスをFrameworkFoldersパスに手動で更新して、ファイルをインポートします。

問題

WebCenter Portalのプライマリ以外のContent Server接続に対してWLSTコマンドexportFoldersGDataを実行すると、MigrationDiagnostic.logファイルで次の例外がレポートされます:

oracle.stellent.ridc.protocol.ServiceException: Unable to open folder.

解決策

複数のContent Server接続が登録されている場合、プライマリ以外のContent Server接続を使用してWLSTコマンドexportFoldersGDataを実行するには、アクティブ接続として設定し、ルート・フォルダとアプリケーション名の値を指定します。exportFoldersGDataの実行後、アクティブ接続から以前のContent Server接続に設定しなおして、移行を続行します。

問題

WebCenter Portalアプリケーションに、Folders_gサービスベースの様々な問合せを使用するカスタム・コードが含まれます。FrameworkFoldersへの移行後、問合せを使用できません。

解決策

Folders_gサービスは、FrameworkFoldersに移行したWebCenter Portalでは使用できません。アプリケーションにFolders_gサービスが含まれる場合、移行後、それらを同等のFrameworkFoldersサービスに置き換える必要があります。表E-2に、Folders_gサービスと対応するFrameworkFoldersサービスのマッピングを示します。

FrameworkFoldersサービスの詳細は、『Oracle WebCenter Contentサービス・リファレンス』のフォルダ・サービスに関する項を参照してください。

表E-2 Folders_gサービスとFrameworkFoldersサービスのマッピング

Folders_gサービス

FrameworkFoldersサービス

COLLECTION_ADD

FLD_CREATE_FOLDER

COLLECTION_BROWSE

FLD_INFO

COLLECTION_COPY_COLLECTION

FLD_COPY (item1がフォルダとして指定された)

COLLECTION_COPY_ITEM

FLD_COPY (item1がファイルとして指定された)

COLLECTION_COPY_LOT

FLD_COPY (itemsが指定された)

COLLECTION_DELETE

FLD_DELETE

COLLECTION_DELETE_COLLECTION

FLD_DELETE (item1がフォルダとして指定された)

COLLECTION_DELETE_ITEM

FLD_DELETE (item1がファイルとして指定された)

COLLECTION_DELETE_LOT

FLD_DELETE (itemsが指定された)

COLLECTION_DISPLAY

FLD_BROWSE

COLLECTION_GET_COLLECTIONS

FLD_RETRIEVE_CHILD_FOLDERS

COLLECTION_GET_CONTENTS

FLD_RETRIEVE_CHILD_FILES

COLLECTION_GET_LINKS

FLD_INFO (item1がショートカットとして指定された)

COLLECTION_GET_REFERENCE

FLD_INFO (pathが指定された、またはitem1がパスとして指定された)

COLLECTION_INFO

FLD_INFO

COLLECTION_MOVE_ALL

FLD_MOVE (itemsが指定された)

COLLECTION_MOVE_COLLECTION

FLD_MOVE (item1がフォルダとして指定された)

COLLECTION_MOVE_ITEM

FLD_MOVE (item1がファイルとして指定された)

COLLECTION_MOVE_LOT

FLD_MOVE (itemsが指定された)

COLLECTION_SEARCH_RESULTS

FLD_FOLDER_SEARCH

COLLECTION_UPDATE

FLD_EDIT_FOLDER

F Oracle WebCenter Portalのトラブルシューティング

この付録では、Oracle WebCenter Portalのトラブルシューティング情報について説明します。

この付録の内容は次のとおりです。

- My Oracle Supportを使用したその他のトラブルシューティング情報

- Oracle WebCenter Portalの構成に関する問題のトラブルシューティング

- Oracle WebCenter Portal WLSTコマンドの問題のトラブルシューティング

- Oracle WebCenter Portalのパフォーマンスに関する問題のトラブルシューティング

- WebCenter Portalワークフローのトラブルシューティング

- WebCenter Portalのインポートおよびエクスポートのトラブルシューティング

- 個別のポータルとポータル・テンプレートのインポートおよびエクスポートのトラブルシューティング

- メールに関する問題のトラブルシューティング

- お知らせおよびディスカッションに関する問題のトラブルシューティング

- イベントに関する問題のトラブルシューティング

- ユーザーおよびロールに関する問題のトラブルシューティング

- コンテンツ・リポジトリに関する問題のトラブルシューティング

- 分析に関する問題のトラブルシューティング

- Oracle SESに関する問題のトラブルシューティング

- 通知に関する問題のトラブルシューティング

- 外部アプリケーションの問題のトラブルシューティング

- セキュリティ構成に関する問題のトラブルシューティング

F.1 My Oracle Supportを使用したその他のトラブルシューティング情報

My Oracle Support(以前はMetaLink)を使用して、Oracle WebCenter Portal問題を解決することができます。My Oracle Supportには、次のような有用なトラブルシューティング・リソースが含まれています。

- ナレッジ・ベース記事

- コミュニティ・フォーラムとディスカッション

- パッチとアップグレード

- 動作保証情報

注意:

My Oracle Supportを使用してサービス・リクエストを記録することもできます。

My Oracle Supportには、https://support.oracle.comからアクセスできます。

F.2 Oracle WebCenter Portalの構成に関する問題のトラブルシューティング

この項では、次の内容について説明します。

- 使用不可の構成オプション

- ログは開いているファイルが多すぎることを示している

F.2.1 使用不可の構成オプション

問題

Fusion Middleware ControlからWebCenter Portalを構成する場合は、次のメッセージが表示されます。

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の命名規則に従います。「WebCenter Portalログの表示および構成」も参照してください。

モジュールoracle.adf.mbean.share.connectionおよびoracle.adf.mbean.share.configのメッセージを分析し、必要な作業を判断します。

F.2.2 ログは開いているファイルが多すぎることを示している

問題

WebCenter Portalにアクセスできないか、エラー・メッセージが表示されていて、開いているファイルが多すぎるという問題があることを診断ログ・ファイルが示しています。

解決策

次の操作を実行します。

- 各バックエンド・サーバー(主にデータベース)で構成されるファイル・ハンドル数を確認し、必要に応じて数を増やします。

- ファイル・ハンドル数を増加した後でも問題が解決されない場合は、/etc/sysctl.confファイルのfs.file-maxの値を確認し、必要に応じて値を増やします。

F.3 Oracle WebCenter Portal WLSTコマンドの問題のトラブルシューティング

この項には次のトピックが含まれます:

- Oracle WebCenter Portal WLSTのどのコマンドも機能しない

- WLSTコマンドが特定のツールまたはサービスに対して機能しない

- 指定された接続名がすでに存在している

- WLSTシェルがWebLogic Serverに接続されない

- 同じ名前の複数のアプリケーションがドメインにすでに存在している

- 同じ名前の複数のアプリケーションが管理対象サーバーにすでに存在している

- ドメイン・ランタイム・ツリーにすでにメッセージが表示される

「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

F.3.1 Oracle WebCenter Portal WLSTのどのコマンドも機能しない

問題

WLSTコマンドをいずれも実行できません。

解決策

次のことを確認します。

- Oracle WebCenter Portal WLSTコマンドは、常にOracleホーム・ディレクトリ(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にあります。

「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

F.3.2 WLSTコマンドが特定のツールまたはサービスに対して機能しない

問題

WLSTコマンドが特定のツールまたはサービスに対して実行できないため、そのツール/サービスを構成できません。

解決策

最初に、listApplicationsまたはdisplayMetricTableNamesなどの一般的なOracle WebCenter Portal以外のコマンドを実行して、これらのコマンドが機能するかどうかを確認します。一般的なコマンドが機能しない場合は、「Oracle WebCenter Portal WLSTのどのコマンドも機能しない」で説明される解決策を適用してください。

一般的なコマンドが機能する場合は、テスト・コマンドを実行して、Oracle WebCenter Portal固有のコマンドに構文エラーがないか確認します。適切なWSLTチェック・コマンドを実行してください(表F-1を参照)。

表F-1 Oracle WebCenter Portalツールおよびサービスのファイル名とWLSTコマンド

サービス名

ファイル名

WLSTコマンド

アクティビティ・ストリーム

ActivityStream.py

asCheck()

分析

Analytics.py

OpenUsage.py

analyticsCheck()

openusageCheck()

ディスカッションおよびお知らせ

Forum.pyJiveAdmin.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()

「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

Oracle WebCenter PortalのWLSTコマンドの詳細は、WebCenter WLSTコマンド・リファレンスのWebCenter PortalのカスタムWLSTコマンドに関する項を参照してください。

F.3.3 指定された接続名がすでに存在している

問題

Connection_Nameという名前の接続を作成できません。次のメッセージが表示されます。

A connection with name Connection_Name already exists.

たとえば、WLSTコマンドcreateExtAppConnectionを使用して外部アプリケーション接続を作成しようとしているか、createMailConnectionを使用してメール・サーバーに接続しようとしています。

解決策

接続名は、WebCenter Portalのすべての接続タイプ間で一意である必要があります。使用中の名前で接続を作成しようとするとエラーが発生します。接続に一意の名前を使用していることを確認してください。

F.3.4 WLSTシェルがWebLogic Serverに接続されない

問題

WLSTコマンドを実行する前に、Oracle WebCenter Portalの管理サーバーに接続する必要があります。接続しなければ、Oracle WebCenter Portal WLSTコマンドは機能しません。

解決策

WLSTシェルを管理対象サーバーに接続するには、次のコマンドを実行してください。

connect(username, password , serverhost:serverport)

「Oracle WebCenter Portal WLSTのどのコマンドも機能しない」および「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

F.3.5 同じ名前の複数のアプリケーションがドメインにすでに存在している

問題

サービスの接続の作成やポートレット・プロデューサの登録などの操作をWebCenter Portalで実行しようとすると、次のメッセージが表示されます。

Another application named "YourApplicationName" exists. Specify the Server on which your application is deployed. Use: server="YourServerName".

同じ名前の複数のアプリケーションがドメインに存在している場合に、このメッセージが表示されます。これは通常、同じアプリケーションが複数の管理対象サーバーにデプロイされる、クラスタ環境で発生します。

たとえば、次のWLSTコマンドを使用してWebCenter Portalのポートレット・プロデューサを登録する場合があります。

registerWSRPProducer(appName='webcenter', name='MyWSRPSamples', url='http://myhost.com:9999/ portletapp/portlets/wsrp2?WSDL')

解決策

WLSTコマンドを実行する管理対象サーバーを指定します。つまり、server引数を追加します。例:

registerWSRPProducer(appName='webcenter', name='MyWSRPSamples', url='http://myhost.com:9999/portletapp/portlets/wsrp2?WSDL', server=WC_CustomPortal2)

「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

F.3.6 同じ名前の複数のアプリケーションが管理対象サーバーにすでに存在している

問題

サービスの接続の作成やポートレット・プロデューサの登録などの操作をWebCenter Portalで実行しようとすると、次のメッセージが表示されます。

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)

「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」も参照してください。

F.3.7 ドメイン・ランタイム・ツリーにすでにメッセージが表示される

問題

WLSTコマンドの実行中に、次のメッセージが表示されます。

Already in Domain Runtime Tree

解決策

対処は不要です。これは情報のみを目的としています。

F.4 Oracle WebCenter Portalのパフォーマンスに関する問題のトラブルシューティング

この項の情報は、Oracle WebCenter Portalのパフォーマンス関連問題の診断に役立ちます。

この項には次のサブセクションが含まれます:

- パフォーマンスのモニタリングとトラブルシューティング・ツールについて

- 表示の遅いページを特定する方法

- 表示の遅いページのコンポーネントを特定する方法

- 遅いページ・リクエストをトラブルシューティングする方法

- JRockitフライト記録を使用してリクエストをトラブルシューティングする方法

F.4.1 パフォーマンスのモニタリングとトラブルシューティング・ツールについて

様々なツールを使用して、Oracle WebCenter Portal環境でのパフォーマンス問題をモニタリングおよびトラブルシューティングできます。

表F-2 パフォーマンスのモニタリングとトラブルシューティング・ツール

ツール

使用目的

参照

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 Cloud Control。

WebCenterポータル・ページ・パフォーマンス・アナライザ

WebCenter Portalのポータル・ページのパフォーマンスを分析します。WebCenter Portalでページを表示すると、このツールによって、個々のページ・コンポーネントのパフォーマンスが動的に測定および表示されます。

表示の遅いページのコンポーネントを特定する方法

JConsole

JavaアプリケーションとJava仮想マシン(JVM)をグラフィカルにモニターします。

JConsoleを使用してJVMをモニターする方法

JRockit Mission Control

メモリー、CPU使用率および他のランタイム・メトリックに関するライブ・データを取得および表示します。

JFR記録を使用した遅いリクエストのトラブルシューティング

Eclipse Memory Analyzer

メモリー・リークを見つけ、メモリー使用率を減らします。

メモリー・リークとヒープ使用量問題のトラブルシューティング

Threadlogic

スレッド・ダンプを分析します。

非常に遅いページ・パフォーマンス、多いスレッド数およびシステム・ハングの診断のためのスレッド・ダンプの生成

F.4.2 表示の遅いページを特定する方法

Fusion Middleware Controlを使用し、WebCenter Portalの最も遅いページを判断します。パフォーマンスが低下したページが頻繁に使用される(起動メトリックが高い)場合、そのようなページのパフォーマンスの向上に集中的に取り組むことは意味のあることです。

最も遅いページを見つけるには:

1. Fusion Middleware Controlにログインし、「WebCenter Portalのホームページへの移動」の説明に従って、WebCenter Portalのホームページに移動します。

2. 「WebCenter Portal」メニューから、「モニタリング」→「最近のページ・メトリック」を選択します。

pageResponseTimeしきい値よりレスポンスが遅いページ・リクエストは、ページ上部のグラフに赤色で表示されます。

3. 時間(ミリ秒)列の「降順ソート」矢印をクリックして、レスポンス時間を基準にページ・リクエストをソートします。

しきい値を超えたページ・レスポンス時間は、表内にオレンジで表示されます。

4. 最も遅いページを特定し、ページが表示されるポータルを書き留めます。

5. より詳細なメトリック(最も遅いページがリクエストされる頻度など)については、「WebCenter Portal」メニューから、「モニタリング」→「全ページ・メトリック」を選択します。

注意: ホーム・ポータルにあるページのリクエストは、「全ページ・メトリック」ページから除外されます。

「ページ・リクエスト・メトリックの理解」および「主要なパフォーマンス・メトリックのしきい値および収集のカスタマイズ」も参照してください。

F.4.3 表示の遅いページのコンポーネントを特定する方法

WebCenter PortalのPage Performance Analyzerを使用すると、ポータル・ページに個々のコンポーネントを表示するのにかかった時間、および1つのページを表示するのにかかった全体時間を簡単に確認できます。有効になっている場合、ポータル・ページを表示するたびに、このツールによって、個々のページ・コンポーネントのパフォーマンスが動的に測定および表示されます。

Portal Page Performance Analyzerは、第1レベルのパフォーマンス分析を実行する開発者、独自のページを構築する顧客、およびWebCenter Portalでページをカスタマイズするユーザーにとって有用な機能です。

この項では、次の内容について説明します。

- Portal Page Performance Analyzerについて

- ポータル・ページのパフォーマンス分析の有効化および無効化

- 現在のセッションのページ・タイミング情報の表示および非表示

- Page Performance Analyzerを使用したパフォーマンスの問題のトラブルシューティング

F.4.3.1 Portal Page Performance Analyzerについて

Portal Page Analyzerでは、表示の遅いページの診断を簡単に、かつ最小限の設定と構成で行えます。この機能が有効な場合、上位レベルのページ・コンポーネントの表示に要した時間が計算されて表示されるため、どのコンポーネントがページ表示の遅れの原因になっているかを一目で確認できます。ページの表示に要した全体時間も、ページの左上に表示されます(図F-1を参照)。

図F-1 ポータル・ページに表示されたタイミング情報

ページ・コンポーネントのタイミングについて

WebCenter Portalでは、上位レベルのページ・コンポーネントがShowDetailFrameで囲まれているため、これらのコンポーネントを移動したり、ページ上で表示または非表示にしたり、Oracle コンポーザで編集することができます。ここで表示されるのは、各ShowDetailFrameの全体時間です。

ページの全体時間について

ページの全体時間は、個々のページ・コンポーネントのタイミングの合計に、セッション・レプリケーション、ページ状態の保存およびリストア、ページ・レベルのセキュリティ・チェックなど、ページ・レベルの各操作の処理時間を加えたものです。より一貫性のある結果を得るために、Page Performance Analysisを有効化する前にテスト・ページをクリックして、ページをリフレッシュします。

色分け

問題領域への注意を喚起するため、パフォーマンス・タイミングは様々な色で表示されます。次の表を参照してください。

色

表示時間

緑

< 100ミリ秒

緑/黄

100 - 500ミリ秒

黄

500ミリ秒 - 1秒

オレンジ

1 - 3秒

赤

> 3秒

F.4.3.2 ポータル・ページのパフォーマンス分析の有効化および無効化

Portal Page Performance Analyzerは、初期状態では無効です。この機能を使用するには、管理者がその使用を明示的に有効化する必要があります。このツールを実行することによるページ・パフォーマンスへの影響は最小限ですが、いくつかの追加のページ処理が必要になります。

本番環境では、追加のパフォーマンス・データ収集と処理が行われないように、通常はAnalyzerを無効化しておいて、特定のページのパフォーマンスの問題が報告されたときに動的に有効化することをお薦めします。

Analyzerをほとんどの時間、無効にする別の理由として、本番環境のパフォーマンス・データがエンド・ユーザーに対して非表示になることがあげられます。

WebCenter PortalインスタンスのPortal Page Analyzerを有効化または無効化するには:

1. WLSTコマンドexportMetadataを使用して、MDSからwebcenter-config.xmlベース・ファイルをエクスポートします。

例:

exportMetadata(application='webcenter', server='WC_Portal', 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_Portal', fromLocation='/tmp/mydata', docs='/oracle/webcenter/webcenterapp/metadata/webcenter-config.xml')

この変更を反映するのにWebCenter Portalの再起動は不要です。

この機能を有効化しても、ページ・パフォーマンス情報は自動的には表示されません。ポータル・ページにタイミング情報を表示する場合は、その情報の表示を明示的にリクエストする必要があります。詳細は、「現在のセッションのページ・タイミング情報の表示および非表示」を参照してください。

F.4.3.3 現在のセッションのページ・タイミング情報の表示および非表示

管理者がWebCenter PortalインスタンスでPage Performance Analyzerを有効化すると、そのWebCenter Portalインスタンスにアクセスできるすべてのユーザーは、次のようにページURLにperfDebugパラメータを追加することで、現在のユーザー・セッションでページ・タイミング情報を表示するか、非表示にするかを指定できます。

目的

ページURLへのperfDebugパラメータの追加

ポータル・ページでのタイミング情報の表示

&perfDebug=on

ページ・パフォーマンス情報の表示の中止

&perfDebug=off

ポータル・ページでタイミング情報を表示するには:

1. 管理者が、WebCenter PortalインスタンスでPage Performance Analyzerを有効化していることを確認します。
「ポータル・ページのパフォーマンス分析の有効化および無効化」も参照してください。

2. WebCenter Portalにログインし、調査対象のポータル・ページに移動します。
このページがパブリック・ページである場合は、ログインする必要はありません。

3. ページURL (図F-2)の最後に&perfDebug=onを追加します。
例:

http://mycompany.com/webcenter/portal/MySalesPortal?_adf.ctrl-state=mji8314i6_4&_afrLoop=474789135539036&perfDebug=on

4. 「実行」をクリックするか、[Enter]を押して、タイミング情報ありでページを再表示します(図F-1)。
それ以降に表示するすべてのページでもタイミング情報が示されます。

図F-2 ページURLへのperfDebugパラメータの追加

ページ・タイミング情報の表示を中止するには:

1. ブラウザで、ページURL (図F-2)の最後に&perfDebug=onを追加します。

例:

http://mycompany.com/webcenter/portal/MySalesPortal?_adf.ctrl-state=mji8314i6_4&_afrLoop=474789135539036&perfDebug=off

2. 「実行」をクリックするか、[Enter]を押して、タイミング情報なしでページを再表示します。

F.4.3.4 Page Performance Analyzerを使用したパフォーマンスの問題のトラブルシューティング

この項の手順では、WebCenter Portalの各ツールを使用して、表示の遅いページをトラブルシューティングする方法について説明します。

1. ユーザーにより、特定のページのパフォーマンスの問題が報告された場合は、表示の遅いページに移動して、パフォーマンス低下がいつも発生することを確認してください。

または、Fusion Middleware Controlを使用して、アプリケーション内の表示が一番遅いページをプロアクティブに特定します。「表示の遅いページを特定する方法」を参照してください。

2. ページURLに&perfDebug=onを追加して、そのページのタイミング情報を表示します。

「現在のセッションのページ・タイミング情報の表示および非表示」も参照してください。

注意:

ページ・タイミング情報が表示されない場合は、管理者にPage Performance Analyzerの有効化を依頼してください。詳細は、「ポータル・ページのパフォーマンス分析の有効化および無効化」を参照してください。

3. 表示が一番遅いページ・コンポーネントを特定し、さらに問題をトラブルシューティングします。

たとえば、表示が遅いコンポーネントに次のものが含まれる場合、

- ドキュメント、wikiまたはコンテンツ・プレゼンタ: バックエンドContent ServerのパフォーマンスとContent Serverが使用するデータベースをチェックします。

- アクティビティ・ストリーム: AWRレポートを使用してデータベース・パフォーマンスをチェックし、アクティビティ・ストリームによって使用されているデータベース表をチューニングできるかどうかを調べます。

- コラボレーション機能: 関連付けられたバックエンド・サーバーのパフォーマンスをチェックします。たとえば、お知らせまたはディスカッションの場合、ディスカッション・サーバーのパフォーマンスをモニターします。

- ポートレット: Fusion Middleware Controlを使用して、ポートレット・リクエストのタイミング情報、エラー、ポートレット・プロデューサのパフォーマンスなどをモニターします。

4. 必要に応じて、表示の遅いページ・コンポーネントを別の空白ページに追加して、さらにプロファイリングを行います。

たとえば、JRockitフライト記録を使用してボトルネックを特定します。

F.4.4 表示の遅いページ・リクエストをトラブルシューティングする方法

この項の情報を使用して、ページ・パフォーマンスの低下に関連する問題を診断します。

- ライブ・リクエストのトラブルシューティング

- スタック・スレッドのトラブルシューティング

- JFR記録を使用した遅いリクエストのトラブルシューティング

- メモリー・リークとヒープ使用量問題のトラブルシューティング

- コンテンツに対する遅いリクエストのトラブルシューティング

F.4.4.1 ライブ・リクエストのトラブルシューティング

実行中の遅いページ・リクエストをトラブルシューティングするには、ユーザー・セッションが動作しているサーバーに対するJRockit Flight Recorder(JFR)レコードを抽出および表示します。「JRockitフライト記録を使用してリクエストをトラブルシューティングする方法」も参照してください。

スレッド・ダンプを比較すると、特定のメソッド・コールに長時間を費やしたスレッドに気付く場合があります。これは、いくつかの連続したスレッド・ダンプ内のコール・スタックが同じであるためです。たとえば、データベース、Oracle WebCenter Content Server、コラボレーション・サーバー、ポートレット・プロデューサ、LDAPサーバーなどに対するメソッド・コールが存在することがあります。この場合は、関連するバックエンド・サーバーを調査して、問題を詳細に診断することができます。

F.4.4.2 スタック・スレッドのトラブルシューティング

スタック・スレッドは、次のようないくつかの理由で発生することがあります。

- サーバーがもう少しでメモリー不足になります。サーバーがメモリー不足状態に近づくと、すべてのリクエストが遅くなります。メモリー不足問題を解決するには、「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診断イメージとスレッド・ダンプを含むファイルがあります。

インシデントの診断の詳細は、『Oracle Fusion Middlewareの管理』の問題の診断に関する項を参照してください。

2. スレッド・ダンプを確認して、スレッドのコール・スタックを見つけます。スレッドがブロックされロックを待機中の場合は、ロックを保持しているスレッドが何を実行しているかを確認します。

3. JDBCコールに長時間を要していることをコール・スタックが示す場合は、データベースにAWRレポートを生成し、問合せと検索および調整する表を見つけます。

4. JRockitフライト記録ファイルJRockitFlightRecorder.jfrで詳細を確認します。さらに、incidentディレクトリのreadme.txtファイルに記録されるリクエストのECIDと、Oracle WebLogic Serverログも必要になります。
「JRockitフライト記録を使用してリクエストをトラブルシューティングする方法」も参照してください。

スタック・スレッドの原因となったリクエストのECIDは、エラー・メッセージに記録されます。

F.4.4.3 JFR記録を使用した遅いリクエストのトラブルシューティング

「JRockitフライト記録を使用してリクエストをトラブルシューティングする方法」を参照してください。

F.4.4.4 メモリー・リークとヒープ使用量問題のトラブルシューティング

WebCenter Portalのパフォーマンスが徐々に低下し、ヒープ使用量とガベージ・コレクション・アクティビティが増加しており、さらにOutOfMemoryErrorsが表示される場合は、アプリケーション内でメモリー・リークが発生し、JVMの空きメモリー容量が連続して減少する可能性があります。

図F-3は、JConsoleに表示される一般的なメモリー・リークの傾向を示しています。

図F-3 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を設定します。詳細は、を参照してください。

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のオンライン・ヘルプを参照してください。

F.4.4.5 コンテンツに対する遅いリクエストのトラブルシューティング

ページ・パフォーマンスが遅い原因がコンテンツ/ドキュメント関連のコンポーネント、たとえばドキュメント・サービス・タスク・フロー、コンテンツ・プレゼンタ・タスク・フロー、Wikiまたはブログの場合は、バックエンドOracle WebCenter Content Server(「システム監査情報」ページ)のパフォーマンス・メトリックを参照することをお薦めします。詳細は、『Oracle WebCenter Contentの管理』のシステム監査情報の表示に関する項を参照してください。

データベースに送信される問合せごとにパフォーマンス情報を確認できるように、systemdatabaseトレース・オプションが選択されていることを確認します。詳細は、『Oracle WebCenter Contentの管理』のサーバー全体のトレースに関する項を参照してください。

F.4.5 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. 最も遅いリクエストを見つけるか、特定のリクエストを調査します。

最も遅いリクエストを特定するには:

特定のリクエストを調査するには:

a. JRockitFlightRecorder.jfrページで、「イベント」アイコンをクリックします。

b. ページ下部の「ログ」タブをクリックします。

c. 左側の「イベント・タイプ」ナビゲーション・ペインで、「ダイナミック・モニタリング・システム」とHttpRequestを見つけます。

d. 「HTTPリクエスト」をクリックして、その他すべてのイベント・タイプの選択を解除します。

e. 「ログ」タブの「イベント・ログ」セクションで、「期間」列をクリックして期間を降順でソートします。
各行はHTTPリクエストに対応し、期間列にはそのリクエストのレスポンス時間が表示されます。

f. 表内の行をクリックして、リクエストの属性を表示します。

g. 「イベント属性」セクションで、開始時間とリクエストを処理したスレッドに注目します。

a. そのリクエストの実行コンテキスト識別子(ECID)を見つけます。
リクエストが、STUCKスレッドによってトリガーされたインシデントに関連する場合は、インシデントのreadme.txtファイルにECIDが含まれます。

あるいは、Oracle WebLogic Server HTTP access.logで特定のユーザーからのリクエストを検索することができます。『Oracle Fusion Middlewareの管理』のログ・ファイルの表示と検索に関する項を参照してください。

b. JRockit Mission Control ClientのJRockitFlightRecorder.jfrページで、「WebLogic」アイコンをクリックします。
注意: 「WebLogic」アイコンを利用できない場合は、「ヘルプ」→「プラグインのインストール」を選択して、Oracle WebLogic Serverプラグインをダウンロードします。

c. ページ下部の「ECIDs」タブをクリックします。

d. 「ECIDs」セクションの「列のフィルタ処理」リストから、「ECID」をクリックします。

e. 検索ボックスにECIDを入力して、[Enter]を選択します。

f. 結果表で、一致するECIDのある行を強調表示し、右クリックしてメニューを表示します。

g. 「操作セット」→「クリア」を選択し、次に「操作セット」→一致ECIDの追加→「ECID」を選択して、ECIDを操作セットに追加します。
これにより、ユーザーは操作セットに関連付けられたイベントのみを表示できます。

h. 「イベント」アイコンをクリックします。

i. 左側の「イベント・タイプ」ナビゲーション・ペインで、「ダイナミック・モニタリング・システム」とHttpRequestを見つけます。

j. 「HTTPリクエスト」をクリックして、その他すべてのイベント・タイプの選択を解除します。 ** 「イベント・ログ」セクションで、「操作セットのみ表示」をクリックします。
各行は、一致するECIDのあるリクエストに対応します。

k. 表内の行をクリックして、リクエストの属性を表示します。

l. 開始時間とリクエストを処理したスレッドに注目します。

5. 開始時間とリクエストを処理したスレッドを特定したら、「ログ」タブに移動し、リクエストの期間の時間枠のみを含めるように、画面上部の時間セレクタをドラッグします。

6. 「イベント・ログ」セクションで、次のように検索を実行します。

a. 「操作セットのみ表示」の選択を解除します。

b. 検索ボックスにスレッド名を入力します。

c. 「列のフィルタ処理」リストから、「スレッド」を選択します。

d. [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フライト・レコーダ・ラン・タイム・ガイド』の明示的なレコードの開始に関する項を参照してください。

F.5 WebCenter Portalワークフローのトラブルシューティング

WebCenter Portalワークフローで問題が発生する場合、次の項を参照してください。

- WebCenter Portalワークフローの構成の検証

- WebCenter Portalワークフローの問題のトラブルシューティング

- 電子メール通知が動作しない

F.5.1 電子メール通知が動作しない

問題

「電子メールで送信するWebCenter Portalワークフロー通知の構成」で説明されているようには、BPM Worklistへのワークフローの通知が電子メールで送信されません。

注意:

障害の原因を特定するには、BPM Worklistプロセスをホストしている、構成した管理対象SOAサーバーのログ・ファイルを調べます。

解決策

招待プロセスが実行されたときのエラーについては、WebCenterおよびSOAサーバーのエラー・ログを確認してください。電子メール構成に問題があると考えられる場合は、まったく同じLDAP設定とユーザー・アカウントを使用して、別の電子メール・クライアントから電子メールの送受信ができるかどうかを確認してください。

注意:

障害の原因を特定するには、構成したSOA BPELサーバーのログ・ファイルを調べます。

F.5.2 WebCenter Portalワークフローの構成の検証

『Oracle WebCenter Portalのインストールおよび構成』には、WebCenter Portalワークフローのインストール方法と構成方法が記載されています。詳細は、WebCenter Portalワークフローのバックエンド要件に関する項を参照してください。ワークフローの構成は、次のように検証できます。

1. WebCenter Portalにログインします。

2. ポータルを作成し、「メンバー」タブに移動します(「管理」リンク→「セキュリティ」→「メンバー」をクリックします)。

3. 任意のロールを持つ新しいメンバー(たとえば、User2)を招待します。

4. 一度ログアウトしてからUser2としてBPM Worklistにログインします。
指定したロールのポータルに追加したワークリスト・アイテムの通知を表示できます。

5. 招待通知を開いて、「承認」ボタンをクリックします。

WebCenter Portalワークフローが正常に機能している場合は、新しく作成したポータルをUser2が使用できます。ポータルが使用できない場合やリストされていない場合は、その構成に問題があります。

F.5.3 WebCenter Portalワークフローの問題のトラブルシューティング

WebCenter Portalワークフローが正常に機能していない場合は、次の手順で問題をトラブルシューティングします。

1. 次の手順で、WebCenter PortalワークフローがOracle SOAサーバーにデプロイされていることを確認します。

a. Fusion Middleware Controlにログインします。

b. WebCenterWorklistDetailApp.earがデプロイされていることを確認します。

c. sca_CommunityWorkflows.jarがデプロイされていることを確認します。

詳細は、『Oracle WebCenter Portalのインストールおよび構成』のOracle SOA Server - ドメインの拡張に関する項を参照してください。

2. 次の手順で、Oracle SOAサーバーとWebCenter Portalアプリケーション間のWebサービス接続がセキュアであることを確認します。

a. Oracle SOAサーバーのキーストア・ファイル内の別名をチェックします。
たとえば、次のコマンドを使用して、Oracle SOAサーバーのキーストア・ファイルの内容をリストします。

keytool -list -v -keystore bpel.jks -storepass <password>

次の内容のエントリがあるはずです。

Alias name: webcenter_portals_ws

b. WebCenter PortalとOracle SOAサーバーの資格証明ストアが、両方とも正しく構成されていることを確認します。

c. 接続の両端に、次のようなキーストアが存在することを確認します。
- 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

「SOAドメイン・キーストアの作成」を参照してください。

d. 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")

『WebCenter WLSTコマンド・リファレンス』のOracle WebCenter Portal WLSTコマンド・カテゴリの概要に関する項を参照してください。

F.6 WebCenter Portalのインポートおよびエクスポートのトラブルシューティング

この項には次のサブセクションが含まれます:

- ResourceLimitExceptionの問題

- LockRefreshTaskの問題

- ポータルおよびポータル・テンプレートがインポート後に使用できない

- ソース・アプリケーションとターゲット・アプリケーションが同じContent Serverを共有している場合は、ポータルまたはドキュメントを移行できない

F.6.1 ResourceLimitExceptionの問題

問題

すべてのポータルまたはWebCenter Portalインスタンス全体をエクスポートしようとすると、次のResourceLimitExceptionエラーが表示されます。

Weblogic.common.resourcepool.ResourceLimitException

解決策

JDBC接続プールで最大容量を増加します。接続プールを再構成するには、WLS管理コンソールにログインします。「サービス」から、「データ・ソース」、「WebCenterDS」、「接続プール」タブを選択します。

F.6.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_Portal,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_Portal', docs='/oracle/webcenter/lock/applicationImport/applicationImport.xml')

WebCenter Portalアプリケーションのエクスポートに失敗した場合、次のコマンドを実行します。

deleteMetadata(application='webcenter', server='WC_Portal', docs='/oracle/webcenter/lock/applicationExport/applicationExport.xml')

ポータルのインポートに失敗した場合、次のコマンドを実行します。

deleteMetadata(application='webcenter', server='WC_Portal', docs='/oracle/webcenter/lock/scopeImport/**')

ポータルのエクスポートに失敗した場合、次のコマンドを実行します。

deleteMetadata(application='webcenter', server='WC_Portal', docs='/oracle/webcenter/lock/gsExportImport/**')

F.6.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)

WLSTコマンドの実行方法の詳細は、「Oracle WebLogic Scripting Tool (WLST)コマンドの実行」を参照してください。

F.6.4 ソース・アプリケーションとターゲット・アプリケーションが同じContent Serverを共有している場合は、ポータルまたはドキュメントを移行できない

同じContent Serverを共有している2つの異なるWebCenter Portalインスタンス間でポータルまたはポータル・テンプレートを移行できません。

F.6.5 接続の作成時にターゲット・ポータル・サーバーが使用不可として表示される

ターゲット・サーバーへのポータル・サーバー接続を作成するとき、「テスト」ボタンをクリックして、接続をテストできます。「テスト」をクリックした後、ターゲット・ポータル・サーバーの状態をその管理コンソールに表示すると、サーバーが稼働中でも使用不可として表示されます。このことは、ターゲット・ドメインまたはターゲット・サーバーの名前がソース・ドメインまたはソース・サーバーと同じである場合に発生します。これにより失われる機能はありません。

F.7 個別のポータルとポータル・テンプレートのインポートおよびエクスポートのトラブルシューティング

この項には次のサブセクションが含まれます:

- エクスポートまたはインポートの失敗後にポータルがブロックされる

- インポート後にページまたはポータルが見つからないというメッセージが表示される

- ポータル・インポート・アーカイブが最大ファイル・アップロード・サイズを超えている

- エクスポート時にポータルの最大数を超える

- リストが適切にインポートされない

- ツールとサービスが構成されているポータルのエクスポートおよびインポート

- インポート後にツールとサービスが無効化される

- サブポータル・ページからのインポート

- ソース・アプリケーションとターゲット・アプリケーションが同じContent Serverを共有している場合は、ポータルをインポートできない

- 共有ライブラリの変更がポータルのデプロイメント後に使用できない

- インポートしたポータルにメンバーが表示されない

- ブラウザ・ロケールでデプロイメント・メッセージが表示されない

F.7.1 エクスポートまたはインポートの失敗後にポータルがブロックされる

ポータルのエクスポートまたはインポート操作時にエラーが発生した場合は、一部のポータルがブロックされている可能性があります。ポータルのブロックを解除するには、一時的にポータルをオンラインの状態に戻してから、再度オフラインの状態にし、エクスポートまたはインポート操作を実行してください。オンライン・モードとオフライン・モードを切り替えることにより、ポータルのブロックが解除されます。詳細は、「任意のポータルのオフライン化」および「任意のポータルの再オンライン化」を参照してください。WebCenter WLSTコマンド・リファレンスのWLSTコマンドsetSpaceStateに関する項も参照してください。

F.7.2 インポート後にページまたはポータルが見つからないというメッセージが表示される

インポート操作後に初めてWebCenter Portalにログインするときに、最後にアクセスしたページまたはポータルが存在しない場合、「ページが見つかりません」または「ポータルが見つかりません」というメッセージが表示される場合があります。最後にアクセスしたページの情報はインポート操作中に保持されるため、このようなメッセージが表示されることがあります。

F.7.3 ポータル・インポート・アーカイブが最大ファイル・アップロード・サイズを超えている

問題

WebCenter Portalにコンテンツをアップロードするには、ファイル・サイズ制限があります。エクスポートのアーカイブが最大アップロード・サイズを超える場合、WebCenter Portal管理からのインポート操作が失敗します。

解決策

WLSTを使用してポータル・アーカイブをインポートします。詳細は、「WLSTを使用したポータルのアーカイブからのインポート」を参照してください。

または、webcenter-config.xmlの最大アップロード・サイズを変更します。デフォルトの最大アップロード・サイズは2GBです。「最大ファイル・アップロード・サイズの変更」を参照してください。

F.7.4 エクスポート時にポータルの最大数を超える

問題

エクスポートできるポータルの最大数は、MDSデータ・ソースに対して指定する接続プール・サイズの80%以下である必要があります。エクスポートしようとするポータルの数が多すぎると、次のResourceLimitExceptionエラーが表示される場合があります。

Weblogic.common.resourcepool.ResourceLimitException

解決策

エクスポートするポータルの数を減らします。または、接続プールの設定を変更します。詳細は、『パフォーマンスのチューニング』を参照してください。

F.7.5 リストが適切にインポートされない

問題

リストが、ソースおよびターゲット・システムのリスト定義の相違により、適切にインポートされていません。

解決策

リスト・データをエクスポートおよびインポートすることを検討してください。これにより、リスト・データがインポートされるリスト定義と一貫性を持つようになります。

データなしにインポートする場合は、ターゲット・システムのリスト・データはインポートされたリスト定義と一貫性を持つように移行されます。リスト列データ・タイプが変更される場合、可能な場合は、列の値はターゲット・データ・タイプからインポートされたデータ・タイプに変換されます。リスト列がインポート時に削除される場合、列の値は削除されます。

F.7.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. 新しいアーカイブをインポートします。

F.7.7 インポート後にツールとサービスが無効化される

問題

ポータルのインポート後に、ポータル管理で直接「ツールとサービス」タブに移動すると、ソース・ポータルで有効化されている場合でも、すべてのツールとサービスが無効化されます。

解決策

必要に応じて、ツールとサービス用の「有効化」チェック・ボックスを選択します。

または、インポート後にポータル管理に移動するかわりに、ポータルを開きます。ポータルに初めてアクセスするときに、ツールとサービスが自動的に有効化されます。

F.7.8 サブポータル・ページからのインポート

問題

「ポータル」ページからポータルをインポートする場合、インポートしたポータルが現在のポータルのサブポータルに自動的になることはありません。新たにインポートされたポータルは、「ポータル」スイッチャ・メニュー、ポータル・ブラウザ・タスク・フローまたは「ポータル」ページに表示されます。これらは、使用可能なすべてのポータルを表示しています。

解決策

アーカイブをインポートする前に「ポータル」ページで親ポータルを選択すると、サブポータルとしてポータルをインポートできます。

F.7.9 ソース・アプリケーションとターゲット・アプリケーションが同じContent Serverを共有している場合は、ポータルをインポートできない

同じContent Serverを共有している2つの異なるWebCenter Portalアプリケーション間でポータルまたはポータル・テンプレートをエクスポート/インポートできません。

同様に、同じContent Serverを共有している2つの異なるWebCenter Portalアプリケーション間でドキュメント移行ユーティリティを使用してポータル・ドキュメントを移行できません。

F.7.10 共有ライブラリの変更がポータルのデプロイメント後に使用できない

問題

共有ライブラリに加えた変更が、新しくデプロイしたポータルに表示されません。

解決策

共有ライブラリのデプロイメントが失敗している可能性があります。共有ライブラリのデプロイメント・ステータスを確認するには、ターゲット・インスタンスでWebLogic Server管理コンソールに移動し、デプロイした共有ライブラリの最新バージョンの状態をチェックします。新しくデプロイしたライブラリが、ターゲット上でアクティブな状態である必要があります。
共有ライブラリのデプロイメントが失敗し、かつ、ターゲット上の最新デプロイ・バージョンの状態が失敗として表示される場合は、失敗したバージョンを削除し、ポータルを再デプロイするか、ポータルを伝播して共有ライブラリの変更を含めます。

共有ライブラリのデプロイメントが失敗し、かつ、ターゲット上の共有ライブラリが失敗した状態として表示されないが、その他の中間状態(配信の実行中/デプロイの実行中/新規など)が表示される場合は、サーバーを再起動して、コンソールの「変更のアクティブ化」をクリックします(有効になっている場合)。共有ライブラリの状態が依然としてアクティブと表示されない場合は、その共有ライブラリ・バージョンをターゲット・サーバーから削除し、ポータルを再デプロイまたは伝播します。このバージョンのライブラリは1つ以上のアプリケーションから参照されているため削除できないというエラー・メッセージが表示される場合は、WebCenter Portal管理対象サーバー(WC_Portal)を停止し、ライブラリを削除した後、管理対象サーバーを再起動します。再起動すると、最新のアクティブなバージョンの共有ライブラリの使用が開始されます。

F.7.11 インポートしたポータルにメンバーが表示されない

問題

ビューアやポータル・マネージャなどのように、様々なロールのメンバーが含まれているポータル・アーカイブ(PARファイル)をインポートした後、ポータルのメンバー・ページにメンバー名が表示されません。

解決策

ソースとターゲットの両方のインスタンス上のユーザーは、同一である必要があります。共有アイデンティティ・ストアを使用していない場合、システム管理者は、synchronizeUserInformation WLSTコマンドを使用してWebCenter Portalのユーザーを同期する必要があります。このコマンドの詳細は、Oracle Supportに問い合せてください。

F.7.12 ブラウザ・ロケールでデプロイメント・メッセージが表示されない

ポータルをデプロイするとき、ターゲット・サーバーから受信するデプロイの進捗メッセージは、ブラウザのロケールではなく、ソース・サーバーの環境のロケールで表示される場合があります。これはソース・サーバーの環境ロケールが、WebCenter Portalに設定されたブラウザのロケールと異なる場合に発生します。

F.8 メールに関する問題のトラブルシューティング

この項では、次の内容について説明します。

- セキュア・モードでメールにアクセスできない

- 非セキュア・モードでメールにアクセスできない

- 非セキュア・モードで配信リストを作成できない

- セキュア・モードで配信リストを作成できない

- ポータルでメールのプロビジョニングに失敗する(デフォルトの配信リストが作成されない)

- ダウンロードしたメール・メッセージの件数を構成できない

- WebCenter Portalメールを公開およびアーカイブできない

- Microsoft Exchangeでのパスワードの変更

F.8.1 セキュア・モードでメールにアクセスできない

問題

セキュア・モードで動作するようにメールを構成しましたが、メールにアクセスできません。

解決策

次のことを確認します。

- IMAPおよびSMTPポートが正しく指定されている。「メール・サーバーの登録」を参照してください。

- メール・サーバーで次のプロパティがtrueに設定されている。

- mail.imap.secured = true

- mail.smtp.secured = true

F.8.2 非セキュア・モードでメールにアクセスできない

問題

非セキュア・モードで動作するようにメールを構成しましたが、メールにアクセスできません。

解決策

次のことを確認します。

- IMAPおよびSMTPポートが正しく指定されている。「メール・サーバーの登録」を参照してください。

- メール・サーバーで次のプロパティがfalseに設定されている。

- mail.imap.secured = false

- mail.smtp.secured = false

F.8.3 非セキュア・モードで配信リストを作成できない

問題

非セキュア・モード、つまりLDAPサーバーでSSLが構成されていない状態で、ポータル配信リストを作成できません。

解決策

メール・サーバーが再インストールされていないか、またはユーザーが削除されていないか確認します。また、LDAPサーバーで、次のパラメータが非セキュア・モードで正しく構成されていることを確認してください。

- ldapHost

- defaultUser

- ldapAdminPassword

- ldapBaseDN

- ldapPort

「メール・サーバーの登録」を参照してください。

F.8.4 セキュア・モードで配信リストを作成できない

問題

セキュア・モード、つまりLDAPサーバーでSSLが構成された状態で、WebCenter Portal配信リストを作成できません。

解決策

メール・サーバーが再インストールされていないか、またはユーザーが削除されていないか確認します。また、LDAPサーバーで、次のパラメータがセキュア・モードで正しく構成されていることを確認してください。

- ldapHost

- defaultUser

- ldapAdminPassword

- ldapBaseDN

- ldapPort

- ldap.connection.secure, 'true'

関連項目:

メール・サーバーの登録

F.8.5 ポータルでメールのプロビジョニングに失敗する(デフォルトの配信リストが作成されない)

問題

WebCenter Portalでポータルの「ツールとサービス」の「メール」ページにアクセスすると、「このポータルのメール・サービスのプロビジョニングに失敗しました」というエラー・メッセージが表示され、「配信リスト」フィールドが空白になります。

解決策

ポータルの名前が一意であることを確認します。ポータルの名前が一意でない場合は、配信リストがすでに存在しています。既存の配信リストか、別の配信リストを選択できます。

F.8.6 ダウンロードしたメール・メッセージの件数を構成できない

問題

各ユーザーの受信箱にダウンロードするメール・メッセージの件数を構成できません。

解決策

WLSTコマンドのsetMailServicePropertyを使用します。たとえば、メール・クライアントから100件のメール・メッセージをダウンロードする場合は、次の例のように、mail.messages.fetch.sizeパラメータに100を指定します。

setMailServiceProperty(appName='webcenter',  property='mail.messages.fetch.size', value='100')

コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのsetMailServicePropertyに関する項を参照してください。

F.8.7 WebCenter Portalメールを公開およびアーカイブできない

問題

WebCenter Portalメールをアーカイブできません。

解決策

アーカイブできない場合、次のことを確認してください。

- WebCenter Portalで、「管理」→「ツールとサービス」→「ディスカッション」に移動します。必要な構成が正しいかどうかを確認します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のディスカッション・フォーラムでのポータル・メールの公開に関する項を参照してください。

- ここで構成されているユーザー・アカウントが配信リストのメンバーであるかどうかを確認します。

- 特定のポータルについて、構成されているフォーラムがディスカッション・サーバーで使用できるかどうかを確認します。詳細は、『Oracle WebCenter Portalでのポータルの構築』のディスカッション・フォーラムでのポータル・メールの公開に関する項を参照してください。

- 配信リストにメールを送信するユーザーがディスカッション・サーバーで使用できるかどうか、またそのユーザーのメール・アドレスが同じかどうかを確認します。

F.8.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でログオンしても引き続きメール・メッセージを閲覧できます。

解決策

元のパスワードを使用する既存のユーザー全員がログオフすると、新しいパスワードが有効になります。それまでは、両方のパスワードを使用してログオンできます。

F.9 お知らせおよびディスカッションに関する問題のトラブルシューティング

このトラブルシューティングの項の内容は次のとおりです。

- 認証の失敗

- WebCenter Portalでディスカッションを有効化できない

- ログイン失敗

- Oracle Access Managerの構成後にログインが正しく機能しない

- カテゴリが見つからないという例外

- 監視対象トピックおよび最近のトピックに複数のディスカッション・フォーラムからのトピックが表示されない

- ディスカッションおよびお知らせの更新内容が表示されない

- 「お知らせ」ページで「ユーザーは認可されていません。」と表示される

- 「ディスカッション」ページで「ユーザーは認可されていません。」と表示される

F.9.1 認証の失敗

問題

WebCenter Portalとバックエンド・ディスカッション・サーバー間の接続に対してWS-Securityが正しく設定されていないようです。次のエラーが表示されることがあります。

failure to authenticate the user WebLogic, due to: Authentication Failed

解決策

このエラーは様々な理由で発生する可能性があります。次のことを確認します。

- ディスカッション接続とディスカッション・サーバー間でOWSM SAMLポリシー設定が正しく定義されていることを確認します。

- WebCenter Portalのディスカッション・サービスに関連するエラーと例外について、WC_Portal-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では、これが重要です。

F.9.2 WebCenter Portalでディスカッションを有効化できない

問題

WebCenter Portalのインストール環境のどのポータルでもディスカッションを有効化できません。

解決策

このエラーは様々な理由で発生する可能性があります。次のことを確認します。

- バックエンド・ディスカッション・サーバーが稼働しており、このサーバーにアクセス可能なこと。「ディスカッション・サーバー接続のテスト」を参照してください。

- アクティブな接続の管理者ユーザー名(adminUser)プロパティが正しく構成され、このプロパティがアプリケーション・ルート・カテゴリ(WebCenter Portal用に構成されたカテゴリ)に対する管理権限を所持していること。「ディスカッション・サーバーの登録」を参照してください。
このユーザーは、super adminである必要はありません。ただし、このユーザーは、WebCenter Portal用に構成されたアプリケーション・ルート・カテゴリ、つまりWebCenter Portalのすべてのディスカッションとお知らせを格納する(ディスカッション・サーバー上の)カテゴリの管理権限を所持している必要があります。

- WebCenter Portalのすべてのディスカッションとお知らせを格納するアプリケーション・ルート・カテゴリがバックエンド・ディスカッション・サーバー上に存在すること。
WebCenter Portal用に構成されたアプリケーション・ルート・カテゴリIDは、WebCenter Portalの「管理」に移動して、「ツールとサービス」→「ディスカッション」を選択することによって確認できます。「ディスカッションおよびお知らせを格納するディスカッション・サーバー上の場所の指定」を参照してください。

F.9.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を使用してユーザーのプロビジョニングを行います。詳細は、「WLSTを使用したディスカッション・サーバー管理者ロールの付与」を参照してください。

2. 適切なDISCUSSIONSスキーマとともにディスカッション・サーバーが構成されていることを確認します。このように構成されていない場合は、config.shまたはwas_config.shを使用してドメインを作成または拡張します。

F.9.4 Oracle Access Managerの構成後にログインが正しく機能しない

問題

Oracle Access Managerシングル・サインオンを構成した後に、WebCenter Portalのディスカッション・サーバーにログインすると、500 - Internal Server Errorが発生します。

解決策

1. スーパー管理者が存在しない場合は、WLSTコマンドaddDiscussionsServerAdminを使用して、WebCenter Portalのディスカッション・サーバーでユーザーをスーパー管理者として追加します。コマンドの構文と例は、WebCenter WLSTコマンド・リファレンスのaddDiscussionsServerAdminに関する項を参照してください。

2. スーパー管理者アカウントを使用してディスカッション管理コンソールにログオンし、「システム」→「システム・プロパティ」に移動します。
「ディスカッション・サーバー管理コンソールへのアクセス」を参照してください。

3. owc_discussions.sso.modeプロパティを作成または編集して、値をtrueに設定します。
詳細は、「SSO用のディスカッション・サーバーの構成」を参照してください。

4. WebCenter Portalのディスカッション・サーバーを再起動します。

F.9.5 カテゴリが見つからないという例外

問題

別のディスカッション・サーバーを使用するために接続を変更した場合や、「管理」→「ツールとサービス」→「ディスカッション」からWebCenter Portalのルート・カテゴリIDを変更した場合に、「カテゴリが見つかりません。」のような例外が表示されることがあります。

解決策

WebCenter Portalがデプロイされている管理対象サーバーを再起動します。

F.9.6 監視対象トピックおよび最近のトピックに複数のディスカッション・フォーラムからのトピックが表示されない

問題

ディスカッション・サイト・テンプレートから作成されたポータルのホームページには、最近のトピックと監視トピックのタスク・フローが組み込まれています。デフォルトでは、これらのタスクは、どちらも1つのフォーラムの情報を表示するように構成されています。複数のフォーラムをサポートするようにポータルが構成されている場合、他のフォーラムからのトピックは、これらのタスク・フローに表示されません。

解決策

監視トピックと最近のトピックのタスク・フローを編集して、「フォーラムID」フィールドからタスク・フローのパラメータを削除します。この場合、「フォーラムID」が${sessionContext['oracle.webcenter.collab.forum'].groupInfo[portalContext.currentPortalName].forumId}に設定されています。この値を削除してページを保存します。

F.9.7 ディスカッションおよびお知らせの更新内容が表示されない

問題

クラスタ化キャッシュが有効化されている環境では、ディスカッションとお知らせに対するコンテンツの更新内容が、すぐにはリフレッシュされないことがあります。

解決策

「リフレッシュ」アイコンをクリックすると、いつでも手動でリフレッシュを強制実行できます。

F.9.8 「お知らせ」ページで「ユーザーは認可されていません。」と表示される

問題

ユーザーがお知らせを作成し、その後、自分のユーザー名を変更します。新しいユーザー名でログインしてページにアクセスしようとすると、2つのユーザー名が同期化されている場合でも、ユーザーにはお知らせを表示することが認可されていないことを示すメッセージが表示されます。

解決策

このことは、WebCenter Portalとディスカッション・サーバーで同じアイデンティティ・ストアが使用されていない場合に発生することがあります。ストアが共有されていない場合、ユーザーは両方のストアに存在する必要があります。

F.9.9 「ディスカッション」ページで「ユーザーは認可されていません。」と表示される

問題

ユーザーがディスカッション・トピックを作成し、その後、自分のユーザー名を変更します。新しいユーザー名でログインしてページにアクセスしようとすると、2つのユーザー名が同期化されている場合でも、ユーザーにはディスカッション・ページを表示することが認可されていないことを示すメッセージが表示されます。

解決策

このことは、WebCenter Portalとディスカッション・サーバーで同じアイデンティティ・ストアが使用されていない場合に発生することがあります。ストアが共有されていない場合、ユーザーは両方のストアに存在する必要があります。

F.10 イベントに関する問題のトラブルシューティング

ユーザーが個人イベントを表示できない場合は、次の点を確認します。

- WebCenter Portalがデプロイされている管理対象サーバーからMicrosoft Exchange Server/IISサーバーにアクセスできますか。これらは互いにping可能ですか。

- Microsoft Exchange Server上の構成に誤りはありませんか。詳細は、「イベントの個人イベントに関する前提条件」を参照してください。

- 管理対象サーバーでのイベント・サーバー接続に誤りはありませんか。詳細は、「イベント・サーバーの登録」を参照してください。

- ユーザーはMicrosoft Exchange Server上のアカウントのユーザー名とパスワードを正しく入力しましたか。ユーザー名は通常、電子メール・アドレスです。

F.11 ユーザーおよびロールに関する問題のトラブルシューティング

Oracle 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ロールに追加されました。この動作が変更されました。

F.12 コンテンツ・リポジトリに関する問題のトラブルシューティング

この項では、次の内容について説明します。

- WebCenter Portalで使用できないドキュメント・ツール

F.12.1 WebCenter Portalで使用できないドキュメント・ツール

WebCenter Portalでドキュメント・ツールが使用できない場合、つまり、ホーム・ポータルまたはその他のポータルで「ドキュメント」タブが使用できない場合は、バックエンドWebCenter Content Serverへの接続に問題があるか、必要なWebCenter Portalデータの一部がWebCenter Content Serverに含まれていません。

問題を診断するには、次の手順を実行します。

1. WebCenter Content Serverが稼働していることを確認します。サーバーの「サーバー・ポート」(intradoc)が構成され、「サーバーIPフィルタ」でWebCenter Portalの接続を許可していることを確認します。

a. Content Serverにログインします。

b. 「管理」をクリックします。

c. 「インスタンス名の構成」をクリックします。

d. 「システム構成」で「サーバーの構成」リンクをクリックします。

e. 「サーバー・ポート」がリストにあり、「サーバーIPフィルタ」でWebCenter Portalの接続を許可していることを確認します。

2. WebCenter Portalと、バックエンド・ドキュメント・ストアとして使用されているWebCenter Content Server間の接続を確認します。

a. Fusion Middleware Controlにログインし、「コンテンツ・リポジトリ接続設定」に移動します。詳細は、「Fusion Middleware Controlを使用したOracle WebCenter Content Serverへの接続の作成」を参照してください。

b. 必要な接続を選択して編集します。

c. 「アクティブな接続」チェック・ボックスを選択していることを確認します。

d. 「コンテンツ管理者」、「ポータル・サーバー識別子」、「セキュリティ・グループ」が正しく指定されていることを確認します。

- コンテンツ管理者: コンテンツ管理者はContent Server上で管理者権限が必要です。ポータル・コンテンツ、セキュリティ・グループおよびロール用のフォルダの作成と保守、およびコンテンツへのアクセス権の管理には、このユーザーが使用されます。

- ポータル・サーバー識別子およびセキュリティ・グループ: いずれも一意で、同じWebCenter Content Serverを使用する他のWebCenter Portalインスタンスで使用されないようにする必要があります。これらの値を変更する場合は、片方のみではなく、両方の値が変更されていることを確認してください。

- セキュリティ・グループ: アイテム名の長さに制限がある、WebCenter Content Serverで作成されるアイテムの接頭辞として使用されるため、14文字以下にする必要があります。

e. 変更する場合は、「テスト」をクリックして、接続が機能することを確認します。

f. 「OK」をクリックして接続を保存します。

g. 変更する場合は、WebCenter Portalがデプロイされている管理対象サーバー(WC_Portal)を再起動する必要があります。

h. WebCenter Portalにログインし、接続の更新後にドキュメント・ツールが使用可能かどうかを確認します。

3. ドキュメント・サービスが使用できない場合は、WebCenter Portal起動に関するログ・メッセージで、WebCenter Content Serverへの接続エラーまたはWebCenter Content Serverでのデータ保存エラーがないかどうかを確認します。
詳細は、「WebCenter Portalログの表示および構成」を参照してください。

4. ログに有用なログ情報がない場合は、WebCenter Content Serverのロギング・レベルを上げ、WebCenter Portalを再起動して、メッセージを詳細に調べます。

i. Fusion Middleware Controlを使用(またはlogging.xmlファイルを編集)して、oracle.webcenter.doclib.internal.modelおよびoracle.webcenter.doclib.internal.spacesのロギングを上げます。
「WebCenter Portalログの表示および構成」も参照してください。

ii. WebCenter Portalを再起動します。

iii. 再度ログを確認します。

F.13 分析に関する問題のトラブルシューティング

問題

WebCenter Portalに分析が表示されない場合は、次のことを確認します。

解決策

- 分析コレクタの構成に誤りがないこと、特に「WebCenterイベント収集の有効化」と「アクティブな接続」の両方が設定されていることを確認します(図F-4)。「アプリケーション用の分析コレクタの登録」を参照してください。

図F-4 接続と分析収集の有効化

接続を変更する場合は、WebCenter Portalがデプロイされている管理対象サーバーを再起動する必要があります。詳細は、「WebCenter Portalアプリケーションがデプロイされる管理対象サーバーの起動および停止」を参照してください。

- WebCenter Portalが最近アップグレードされた場合は、ドメイン起動スクリプトにレガシーの分析コレクタ設定が含まれていないことを確認してください。レガシー設定が含まれていると、その値によって、Fusion Middleware ControlまたはWLSTを使用して指定したあらゆる接続詳細がオーバーライドされてしまいます。

1. WebCenter Portalがデプロイされている管理対象サーバー(WC_Portal)をシャットダウンします。

2. 次にある、ドメイン起動スクリプトsetDomainEnvを編集します。
UNIX: DOMAIN_HOME/bin/setDomainEnv.sh

Windows: DOMAIN_HOME\bin\setDomainEnv.cmd

3. 分析コレクタ設定を削除します。

4. 管理対象サーバーを再起動します。

問題

プラガブル・データベース(PDB)で構成されている場合、データベース内のカーソル数が最大制限値を超えると、分析コレクタのデプロイメントが失敗します。

解決策

プラガブル・データベース(PDB)のopen_cursorsの数を3000などに増やしてください。open_cursorsに使用可能な値は、0から65535です。

open_cursorsには、セッション当たりの使用可能な最大オープン・カーソル数を指定します。

F.14 Oracle SESに関する問題のトラブルシューティング

この項では、Oracle SESの管理に関するトラブルシューティングのヒントについて説明します。次のトピックが含まれています:

- 検索結果が見つからない

- 検索失敗のエラー

- WebCenter Portalにview権限を付与できない

- ソース・グループまたはソース・タイプによるOracle SESの結果の制限

- 検索結果に保護されたリソースが含まれない

- 検索結果にドキュメントが含まれない

- 検索結果にディスカッションとお知らせが含まれない

- 検索結果に最近追加されたリソースが含まれない

- 検索結果に認可の変更が反映されない

- 検索結果に幅広いユーザーに利用可能なリソースが含まれない

F.14.1 検索結果が見つからない

問題

検索結果が見つかりません。

解決策

次のことを確認します。

- Oracle SES接続

- ドキュメントとディスカッションの接続

- WebCenter Portalのクロール構成

- Oracle SES構成

- ユーザー認証

- Oracle SESのクロール

- Oracle SESの認可

F.14.1.1 Oracle SES接続

Oracle SES SOAP URLにアクセスできること、およびOracle SESへの接続のプロパティが正しいことを確認してください。

詳細は、「Oracle SES接続のテスト」を参照してください。

F.14.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>

F.14.1.3 WebCenter Portalのクロール構成

「Oracle SESのためのWebCenter Portalの設定」の説明に従って、Fusion Middleware ControlまたはWLSTを使用して、Oracle SESがWebCenter Portalで有効にされていることを確認します。

F.14.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つの信頼できるエンティティが必要です。詳細は、「Oracle SES - 構成」を参照してください。

Oracle SESがフェデレーション・トラステッド・エンティティ・ユーザーと接続されていることをテストするには、「Oracle SES接続のテスト」を参照してください。

F.14.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.

F.14.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管理ツール内のクロール・プロセスをモニターします。

a. 「ホーム」→「スケジュール」ページでクローラの進捗状況とステータスを確認します。(「ステータスのリフレッシュ」をクリックします。)「ステータス」ページで、クロールの統計を表示できます。

b. 「ホーム」→「スケジュール」→「クローラの進行状況のサマリー」ページおよび「ホーム」→「統計」ページでクローラの統計をモニターします。

c. 「ホーム」→「一般」ページおよび「ホーム」→「統計」ページで検索の統計をモニターします。

クロールのパフォーマンスを調整するためのヒントは、Oracle Secure Enterprise Search管理者ガイドを参照してください。

6. さらに、Content Serverインスタンス上のスナップショットとデータ・フィード、およびOracle WebCenter Portalのディスカッション・サーバー・データベースを調べてください。

F.14.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製品の領域にリストされています。)

関連項目:

- ドキュメントを検索するためのOracle SESの設定

- ディスカッションおよびお知らせを検索するためのOracle SESの設定

- ポータル、リスト、人およびページ・メタデータを検索するためのOracle SESの設定

F.14.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 Server WLSTコマンド・リファレンス』のsetSearchConfigに関する項を参照してください。

F.14.3 WebCenter Portalにview権限を付与できない

問題

「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'

解決策

このエラーは権限の付与時に表示されます。このエラーは無視してください。

F.14.4 ソース・グループまたはソース・タイプによるOracle SESの結果の制限

問題

検索結果をソース・グループまたはソース・タイプで制限する必要があります。

解決策

Oracle SES管理ツールで、「ホーム」→「ソース」→「フェデレーテッド・ソースのカスタマイズ」→「検索制限」ページに移動し、検索の制限を設定します。またはフィルタを使用します(各フィルタは検索結果の制限として機能します)。

Oracle SESの使用方法の詳細は、Oracle Fusion Middlewareドキュメント・ライブラリ(WebCenter Portal製品領域内)でOracle SESドキュメントを参照してください。

F.14.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

解決策

クロール・ソースの数を減らします。

F.14.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クロール・ソースの構成パラメータを更新します。

F.14.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(?))。インデックス付きの可能性がある列に関数を追加すると、パフォーマンスに影響する場合があります。

F.14.8 検索結果に最近追加されたリソースが含まれない

問題

新規リソースが最近作成されましたが、検索結果にその新規リソースが含まれません。

解決策

新規リソースが検索結果で返されるようにするには、まずそのリソースをクロールおよび索引付けする必要があります。新しいコンテンツを索引付けするために、クロール・スケジュールが定期的に実行されます。新規リソースが頻繁に作成される場合は、クロール・スケジュールの頻度を増やしてください。新規リソースをすぐにクロールする必要がある場合は、クロール・スケジュールを手動で開始してください。

F.14.9 検索結果に認可の変更が反映されない

問題

一部のリソースには、WebCenter Portalでの認可の変更により、より多くのユーザーがアクセス可能になります。たとえば、ポータル内のリソースには、現在すべての認証ユーザーがアクセスできます。影響を受けるユーザーはこれらのリソースを検索できません。

解決策

認可データはOracle SESにキャッシュされます。キャッシュは、Oracle SESの「セキュリティ・フィルタ有効期間(分)」グローバル設定により無効にされます。デフォルト値は1日(1440分)です。認可データへの変更の標準的な頻度に応じて、値を調整してください。

F.14.10 検索結果に幅広いユーザーに利用可能なリソースが含まれない

問題

ポータルはパブリックにアクセス可能ですが、認証されていないユーザーは、検索結果でポータルのリソースを表示できません。

解決策

デフォルトでは、ポータルがパブリックに対してアクセス可能であるとしても、リソースへの「表示」アクセス権はポータルのメンバーにのみ付与されます。リソースの「表示」アクセス権を非メンバーに明示的に付与する必要があります。ポータルの設定ページに移動し、「ロール」タブで対象のロールを選択し、リソースへの「表示」アクセス権を付与するよう選択します。

F.15 通知に関する問題のトラブルシューティング

問題

通知がまったく受信されません。

解決策

- 通知の送信者が構成されていないことをログが示している場合、使用する接続をサービスが検出できないことを意味します。

- 有効なBPEL接続またはメール接続を使用するように通知が構成されていることを確認してください。これは、WLSTコマンドのgetNotificationsConfig() (「WLSTを使用した通知チャネルの指定」を参照)またはFusion Middleware Controlのユーザー・インタフェース(「Fusion Middleware Controlを使用した通知チャネルの指定」を参照)を使用して検証できます。

問題

通知は正しく構成されていますが(BPELまたはメール)、それでも通知が受信されません。

解決策

通知は、有効なBPEL接続またはメール接続に依存しています。「メールの管理」または「WebCenter Portalメンバーシップ・ワークフローに対するSOA接続の管理」の説明に従って、それぞれの接続の検証とトラブルシューティング・シナリオを実行してください。

問題

メール接続または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つと照合できるようにしてください。

- メール・サービスの場合は、「接続チャネルについて」の説明に従って、メール接続が共有接続をポイントしていることを確認してください。

問題

(UMS構成の場合)ユーザーが一部のチャネルからは通知を受信しますが、他のチャネルからは受信しません。

解決策

これは、ユーザーのメッセージング・チャネルおよびフィルタの構成に起因する可能性が高いと考えられます。詳細は、『Oracle WebCenter Portalの使用』のメッセージング・チャネルおよびフィルタの設定と管理に関する項を参照してください。

F.16 外部アプリケーションの問題のトラブルシューティング

この項では、外部アプリケーションに関連する一般的な問題と回避策について説明します。

この項の内容は、次のとおりです。

- ユーザーのパスワードがロックアウトされる

F.16.1 ユーザーのパスワードがロックアウトされる

問題

アイデンティティ・ストアに使用しているパスワード変更ポリシーが、アイデンティティ・ストアでパスワードを直接変更する場合、コラボレーション接続のために資格証明を格納または取得する外部アプリケーションを使用すると、ユーザーのパスワードがロックアウトされることがあります。

解決策

外部アプリケーションは、アイデンティティ・ストアでパスワードが直接変更されたことを認識できないため、このようなパスワード変更には対応できません。部分的な解決策は、1つの外部アプリケーションをすべてのコラボレーション接続に対して定義することです。

F.17 セキュリティ構成に関する問題のトラブルシューティング

この項では、次の内容について説明します。

- WebCenter PortalアプリケーションでLDAPプロバイダのユーザーが見つからない

- OIDユーザーとしてログインしている場合にポータルを作成するとエラーが発生する

- Active Directoryを使用してWebCenter Portalを構成するとユーザーが自己登録できない

- 管理者に設定されたユーザーが管理者権限を使用できない

- SSO環境のOmniPortletプロデューサで認可例外が発生する

- SAML SSO固有のディスカッションEARファイルをデプロイすると例外が発生する

- SAMLシングル・サインオンを構成すると403エラーが発生する

- 偽装セッションによりOAM 11.1.2.2.0でエラーが生成される

F.17.1 WebCenter PortalアプリケーションでLDAPプロバイダのユーザーが見つからない

問題

外部LDAPプロバイダを使用してWeblogic Serverを構成しました。外部LDAPのユーザーはWebCenter Portalにログインできますが、WebCenter Portalで外部LDAPのユーザーに管理者ロールを割り当てようとすると、ユーザーが一人も見つかりません。

解決策

「アイデンティティ・ストアの構成」の手順に従って、DefaultAuthenticator認証プロバイダの制御フラグをSufficientに変更します。ドメインの管理サーバーおよび管理対象サーバーを再起動します。

F.17.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_Portalサーバーを再起動します。

F.17.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のチェック・ボックスを選択します。

F.17.4 管理者に設定されたユーザーが管理者権限を使用できない

問題

orcladminとしてログインし、ユーザーを管理者に設定した後でログアウトし、そのユーザーで再度ログインしても、管理者リンクが使用可能になりません。

解決策

この問題は、アイデンティティ・ストア内でcnエントリが重複しているために起こります。cnはユーザー名属性にマップされており、一意である必要があります。アイデンティティ・ストアから重複を削除し、そのユーザーに適切なprivileges.cnを設定してください。

F.17.5 SSO環境のOmniPortletプロデューサで認可例外が発生する

問題

SSOを使用してWebCenter Portalが構成されている場合に、OmniPortletプロデューサでCredential Store Framework (CSF)ウォレットに接続情報を格納しようとすると認可例外が発生します。

解決策

WLST (詳細は、「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="*")

F.17.6 SAML SSO固有のディスカッションEARファイルをデプロイすると例外が発生する

問題

ディスカッションEARファイルをアンデプロイしてから、SAML SSO固有のディスカッションEARファイルをデプロイし、WLS管理コンソールでアプリケーションを起動すると、管理コンソールで次の例外が発生します。

java.lang.ClassCastException:
org.apache.xerces.parsers.XIncludeAwareParserConfiguration

解決策

WC_Collaborationサーバーを再起動します。これにより問題が解決され、ディスカッション・アプリケーションがアクティブな状態になるはずです。

F.17.7 SAMLシングル・サインオンを構成すると403エラーが発生する

問題

SAML SSO構成のテスト中に403エラーが発生したため、デバッグ・ロギングを有効化(「構成のチェック」を参照)したところ、宛先サーバーで次のようなエラー・ログが表示されました。

####<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_Portalドメインから「セキュリティ・レルム」→「プロバイダ」→「資格証明マッピング」→「wcsamlcm」→「管理」→「リライイング・パーティ」に移動し、ドメインに関連するリライイング・パーティ(たとえば、SOAの場合はワークリスト詳細になります)を削除します。

3. 「宛先ドメイン」→「セキュリティ・レルム」→「プロバイダ」→「認証」→「wcsamlia」→「管理」→「アサーティング・パーティ」に移動し、対応するアサーティング・パーティを削除します。

4. 「証明書」タブを開き、証明書も削除します。

5. WebCenter Portalドメインに戻り、アサーティング・パーティとリライイング・パーティの組合せを作成するためスクリプトを再実行します。たとえば、SOAの場合は、次のように再実行する必要があります。

WCP_ORACLE_HOME/webcenter/scripts/samlsso/configureWorklistDetail.py

6. 構成を再度テストします。すべて問題なく機能すれば、SAMLロギングを無効化できます。

F.17.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です

オラクルの法律上の注意点について

コピーライトについて

Copyright © 1994-2016, 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を参照してください。