Oracle® Fusion Middleware 管理者ガイド

11g リリース1(11.1.1)

B60984-06(原本部品番号:E10105-14)

目次

図一覧

表一覧

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

このガイドの最新情報

- Oracle Fusion Middleware 11g リリース1(11.1.1.7)の新機能と変更機能

第I部 Oracle Fusion Middlewareの概要

1 Oracle Fusion Middlewareの概要

- 1.1 Oracle Fusion Middlewareの概要

- 1.2 Oracle Fusion Middlewareコンポーネント

2 Oracle Fusion Middlewareの概念の概要

- 2.1 Oracle Fusion Middlewareの主要概要の理解

- 2.2 Oracle WebLogic Serverドメインとは

- 2.2.1 管理サーバーとは

- 2.2.2 管理対象サーバーおよび管理対象サーバー・クラスタの概要

- 2.2.3 ノード・マネージャとは

- 2.3 Oracleインスタンスとは

- 2.4 Middlewareホームとは

- 2.5 WebLogic Serverホームとは

- 2.6 OracleホームおよびOracle共通ホームとは

- 2.7 Oracleメタデータ・リポジトリとは

第II部 基本的な管理

3 Oracle Fusion Middlewareの管理の概要

- 3.1 環境変数の設定

- 3.2 Oracle Fusion Middlewareの管理ツールの概要

- 3.3 Oracle Enterprise Manager Fusion Middleware Controlの使用の概要

- 3.3.1 Fusion Middleware Controlの表示

- 3.3.2 Fusion Middleware Controlヘルプの使用

- 3.3.3 Fusion Middleware Controlでのナビゲート

- 3.3.4 Fusion Middleware Controlのユーザーおよびロールの概要

- 3.3.5 ファームの表示と管理

- 3.3.6 コンポーネントの表示と管理

- 3.3.7 アプリケーションのステータスの表示

- 3.4 Oracle WebLogic Server管理コンソールの概要

- 3.4.1 Oracle WebLogic Server管理コンソールの表示

- 3.4.2 WebLogic Serverの構成のロック

- 3.5 コマンドライン・ツールの使用の概要

- 3.5.1 WebLogic Scripting Tool(WLST)の使用の概要

- 3.5.1.1 カスタムWLSTコマンドの使用

- 3.5.1.2 システム・コンポーネントでのWLSTコマンドの使用

- 3.5.2 Oracle Process Manager and Notification Serverの使用の概要

- 3.6 Fusion Middleware Control MBeanブラウザの使用の概要

- 3.6.1 システムMBeanブラウザの使用

- 3.6.2 選択したアプリケーションのMBeanの使用

- 3.7 コンポーネントの管理

- 3.8 管理ユーザーのパスワードの変更

- 3.8.1 コマンドラインを使用した管理ユーザーのパスワードの変更

- 3.8.2 管理コンソールを使用した管理ユーザーのパスワードの変更

- 3.9 Oracle Fusion Middlewareの構成および管理の基本的なタスク

4 Oracle Fusion Middlewareの起動と停止

- 4.1 起動および停止手順の概要

- 4.2 Oracle WebLogic Serverインスタンスの起動と停止

- 4.2.1 ノード・マネージャでの管理対象サーバーの起動の構成

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

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

- 4.2.3.1 Fusion Middleware Controlを使用した管理対象サーバーの起動と停止

- 4.2.3.2 WLSTを使用した管理対象サーバーの起動と停止

- 4.2.4 資格証明を入力しないサーバーの起動の有効化

- 4.2.5 WindowsサービスとしてのOracle WebLogic Serverの設定

- 4.3 コンポーネントの起動と停止

- 4.3.1 Fusion Middleware Controlを使用したコンポーネントの起動と停止

- 4.3.2 コマンドラインを使用したコンポーネントの起動と停止

- 4.4 Fusion Middleware Controlの起動と停止

- 4.5 Oracle Management Agentの起動と停止

- 4.6 アプリケーションの起動と停止

- 4.6.1 Fusion Middleware Controlを使用したJava EEアプリケーションの起動と停止

- 4.6.2 WLSTを使用したJava EEアプリケーションの起動と停止

- 4.7 Oracle Fusion Middleware環境の起動と停止

- 4.7.1 Oracle Fusion Middleware環境の起動

- 4.7.2 Oracle Fusion Middleware環境の停止

- 4.8 起動と停止: 特殊なトピック

- 4.8.1 高可用性環境での起動と停止

- 4.8.2 Oracle Databaseの強制停止

5 ポートの管理

- 5.1 ポートの管理について

- 5.2 ポート番号の表示

- 5.2.1 コマンドラインを使用したポート番号の表示

- 5.2.2 Fusion Middleware Controlを使用したポート番号の表示

- 5.3 Oracle Fusion Middlewareで使用するポート番号の変更

- 5.3.1 Oracle WebLogic Serverリスニング・ポートの変更

- 5.3.1.1 管理コンソールを使用したOracle WebLogic Serverリスニング・ポートの変更

- 5.3.1.2 WLSTを使用したOracle WebLogic Serverリスニング・ポートの変更

- 5.3.2 Oracle HTTP Serverリスニング・ポートの変更

- 5.3.2.1 1024未満に設定されたポート使用時のOracle HTTP Serverのroot実行の有効化(UNIXのみ)

- 5.3.2.2 Oracle HTTP Serverの非SSLリスニング・ポートの変更

- 5.3.2.3 Oracle HTTP ServerのSSLリスニング・ポートの変更

- 5.3.3 Oracle Web Cacheポートの変更

- 5.3.4 OPMNポート(ONS Local、Request、Remote)の変更

- 5.3.5 Oracle Portalポートの変更

- 5.3.5.1 Oracle Portal中間層ポートの変更

- 5.3.5.2 Oracle PortalのOracle Web Cache無効化ポートの変更

- 5.3.5.3 Oracle PortalのOracle Internet Directoryポートの変更

- 5.3.5.4 PPEループバック・ポートの変更

- 5.3.5.5 Oracle Portal SQL*Netリスナー・ポートの変更

- 5.3.5.6 WLS_PORTAL管理対象サーバーの再起動

- 5.3.6 Oracle Database Netリスナー・ポートの変更

- 5.3.6.1 IPCリスナーのKEY値の変更

第III部 Secure Sockets Layer

6 Oracle Fusion MiddlewareでのSSLの構成

- 6.1 SSLのしくみ

- 6.1.1 SSLの機能

- 6.1.2 秘密鍵と公開鍵の暗号化について

- 6.1.3 キーストアおよびウォレット

- 6.1.4 SSLセッションのしくみ

- 6.2 Oracle Fusion MiddlewareにおけるSSLについて

- 6.2.1 Oracle Fusion MiddlewareアーキテクチャにおけるSSL

- 6.2.2 キーストアおよびOracleウォレット

- 6.2.3 認証モード

- 6.2.4 SSL構成用ツール

- 6.3 構成ツールでのSSLの構成

- 6.3.1 Oracle Enterprise Manager Fusion Middleware Control

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

- 6.3.3 WLSTコマンドライン・ツール

- 6.4 Web層でのSSLの構成

- 6.4.1 ロード・バランサの構成

- 6.4.2 Oracle Web CacheエンドポイントでのSSLの有効化

- 6.4.2.1 Fusion Middleware Controlを使用したOracle Web CacheでのインバウンドSSLの有効化

- 6.4.2.2 WLSTを使用したOracle Web CacheでのインバウンドSSLの有効化

- 6.4.2.3 Fusion Middleware Controlを使用したOracle Web CacheでのアウトバウンドSSLの有効化

- 6.4.2.4 WLSTを使用したOracle Web CacheからのアウトバウンドSSLのウォレットの指定

- 6.4.3 Oracle HTTP Server仮想ホストでのSSLの有効化

- 6.4.3.1 Fusion Middleware Controlを使用したOracle HTTP Server仮想ホストへのインバウンド・リクエストでのSSLの有効化

- 6.4.3.2 WLSTを使用したOracle HTTP Server仮想ホストへのインバウンド・リクエストでのSSLの有効化

- 6.4.3.3 Oracle HTTP Serverからのアウトバウンド・リクエストでのSSLの有効化

- 6.5 中間層でのSSLの構成

- 6.5.1 Oracle WebLogic ServerでのSSLの構成

- 6.5.1.1 Oracle WebLogic ServerへのインバウンドSSL

- 6.5.1.2 Oracle WebLogic ServerからのアウトバウンドSSL

- 6.5.1.2.1 Oracle Platform Security ServicesからのLDAPへのアウトバウンドSSL

- 6.5.1.2.2 Oracle Platform Security ServicesからのOracleデータベースへのアウトバウンドSSL

- 6.5.1.2.3 LDAP認証プロバイダからのLDAPへのアウトバウンドSSL

- 6.5.1.2.4 データベースへのアウトバウンドSSL

- 6.5.2 Oracle SOA SuiteでのSSLの構成

- 6.5.3 Oracle WebCenter PortalのSSLの構成

- 6.5.4 Oracle IdentityおよびAccess ManagementでのSSLの構成

- 6.5.4.1 Oracle Directory Integration PlatformでのSSLの構成

- 6.5.4.2 Oracle Identity FederationでのSSLの構成

- 6.5.4.3 Oracle Directory Services ManagerでのSSLの構成

- 6.5.5 Oracle Reports、Forms、DiscovererおよびPortalでのSSLの有効化

- 6.5.5.1 Oracle ReportsでのSSL

- 6.5.5.2 Oracle FormsでのSSL

- 6.5.5.3 Oracle DiscovererでのSSL

- 6.5.5.4 Oracle PortalでのSSL

- 6.5.6 アプリケーションのクライアント側のSSL

- 6.6 データ層でのSSLの構成

- 6.6.1 Oracle Internet DirectoryリスナーでのSSLの有効化

- 6.6.1.1 Fusion Middleware Controlを使用したOracle Internet DirectoryリスナーでのインバウンドSSLの有効化

- 6.6.1.2 WLSTを使用したOracle Internet DirectoryリスナーでのインバウンドSSLの有効化

- 6.6.1.3 Oracle Internet DirectoryからOracle DatabaseへのアウトバウンドSSLの有効化

- 6.6.2 Oracle Virtual DirectoryリスナーでのSSLの有効化

- 6.6.2.1 Fusion Middleware Controlを使用したOracle Virtual DirectoryでのSSLの有効化

- 6.6.2.2 WLSTを使用したOracle Virtual DirectoryリスナーでのSSLの有効化

- 6.6.3 データベースでのSSLの構成

- 6.6.3.1 Oracle DatabaseでのSSLの有効化

- 6.6.3.2 データソースでのSSLの有効化

- 6.7 高度なSSLの使用事例

- 6.7.1 ハードウェア・セキュリティ・モジュールとアクセラレータ

- 6.7.2 CRLとSSLとの統合

- 6.7.2.1 コンポーネントのCRL検証の構成

- 6.7.2.2 ファイル・システムでのCRLの管理

- 6.7.2.3 CRL検証が構成されたコンポーネントのテスト

- 6.7.3 Oracle Fusion MiddlewareのFIPS 140-2の設定

- 6.7.3.1 FIPSで構成可能な製品

- 6.7.3.2 SSLFIPS_140パラメータの設定

- 6.7.3.3 暗号スイートの選択

- 6.7.3.4 その他の構成パラメータ

- 6.8 SSLのベスト・プラクティス

- 6.8.1 管理者のベスト・プラクティス

- 6.8.2 アプリケーション開発者のベスト・プラクティス

- 6.9 SSL関連のWLSTリファレンス

- 6.9.1 addCertificateRequest

- 6.9.1.1 説明

- 6.9.1.2 構文

- 6.9.1.3 例

- 6.9.2 addSelfSignedCertificate

- 6.9.2.1 説明

- 6.9.2.2 構文

- 6.9.2.3 例

- 6.9.3 changeKeyStorePassword

- 6.9.3.1 説明

- 6.9.3.2 構文

- 6.9.3.3 例

- 6.9.4 changeWalletPassword

- 6.9.4.1 説明

- 6.9.4.2 構文

- 6.9.4.3 例

- 6.9.5 configureSSL

- 6.9.5.1 説明

- 6.9.5.2 構文

- 6.9.5.3 例

- 6.9.6 createKeyStore

- 6.9.6.1 説明

- 6.9.6.2 構文

- 6.9.6.3 例

- 6.9.7 createWallet

- 6.9.7.1 説明

- 6.9.7.2 構文

- 6.9.7.3 例

- 6.9.8 deleteKeyStore

- 6.9.8.1 説明

- 6.9.8.2 構文

- 6.9.8.3 例

- 6.9.9 deleteWallet

- 6.9.9.1 説明

- 6.9.9.2 構文

- 6.9.9.3 例

- 6.9.10 exportKeyStore

- 6.9.10.1 説明

- 6.9.10.2 構文

- 6.9.10.3 例

- 6.9.11 exportKeyStoreObject

- 6.9.11.1 説明

- 6.9.11.2 構文

- 6.9.11.3 例

- 6.9.12 exportWallet

- 6.9.12.1 説明

- 6.9.12.2 構文

- 6.9.12.3 例

- 6.9.13 exportWalletObject

- 6.9.13.1 説明

- 6.9.13.2 構文

- 6.9.13.3 例

- 6.9.14 generateKey

- 6.9.14.1 説明

- 6.9.14.2 構文

- 6.9.14.3 例

- 6.9.15 getKeyStoreObject

- 6.9.15.1 説明

- 6.9.15.2 構文

- 6.9.15.3 例

- 6.9.16 getSSL

- 6.9.16.1 説明

- 6.9.16.2 構文

- 6.9.16.3 例

- 6.9.17 getWalletObject

- 6.9.17.1 説明

- 6.9.17.2 構文

- 6.9.17.3 例

- 6.9.18 importKeyStore

- 6.9.18.1 説明

- 6.9.18.2 構文

- 6.9.18.3 例

- 6.9.19 importKeyStoreObject

- 6.9.19.1 説明

- 6.9.19.2 構文

- 6.9.19.3 例

- 6.9.20 importWallet

- 6.9.20.1 説明

- 6.9.20.2 構文

- 6.9.20.3 例

- 6.9.21 importWalletObject

- 6.9.21.1 説明

- 6.9.21.2 構文

- 6.9.21.3 例

- 6.9.22 listKeyStoreObjects

- 6.9.22.1 説明

- 6.9.22.2 構文

- 6.9.22.3 例

- 6.9.23 listKeyStores

- 6.9.23.1 説明

- 6.9.23.2 構文

- 6.9.23.3 例

- 6.9.24 listWalletObjects

- 6.9.24.1 説明

- 6.9.24.2 構文

- 6.9.24.3 例

- 6.9.25 listWallets

- 6.9.25.1 説明

- 6.9.25.2 構文

- 6.9.25.3 例

- 6.9.26 removeKeyStoreObject

- 6.9.26.1 説明

- 6.9.26.2 構文

- 6.9.26.3 例

- 6.9.27 removeWalletObject

- 6.9.27.1 説明

- 6.9.27.2 構文

- 6.9.27.3 例

- 6.9.28 SSL用プロパティ・ファイル

- 6.9.28.1 プロパティ・ファイルの構造

- 6.9.28.2 プロパティ・ファイルの例

7 SSL自動化ツールの使用

- 7.1 SSL自動化ツールの概要

- 7.2 前提条件

- 7.2.1 Oracle Fusion Middleware環境の設定

- 7.2.2 必要な情報のアセンブル

- 7.3 CA証明書の生成

- 7.3.1 例: 証明書の生成

- 7.4 コンポーネント・サーバーの構成

- 7.4.1 例: WebLogic ServerおよびJava EEのコンポーネントの構成

- 7.4.2 例: Oracle Internet Directoryサーバー・コンポーネントの構成

- 7.4.3 例: Oracle Virtual Directoryサーバー・コンポーネントの構成

- 7.4.4 例: Oracle Access Manager 10gサーバー・コンポーネントの構成

- 7.5 クライアントの構成

- 7.5.1 例: SSLクライアント用のCA証明書のダウンロード

- 7.5.2 例: 証明書のダウンロードおよびWebLogicクライアントの構成

- 7.5.3 例: 証明書のダウンロードおよびWebGateクライアントの構成

8 キーストア、ウォレットおよび証明書の管理

- 8.1 Oracle Fusion Middlewareでの鍵および証明書の保存

- 8.1.1 キーストアのタイプ

- 8.1.1.1 JKSキーストアとトラストストア

- 8.1.1.2 Oracleウォレット

- 8.1.2 キーストア管理ツール

- 8.1.2.1 DERでエンコードされた証明書のインポートについて

- 8.1.2.2 WLSTまたはFusion Middleware Controlで作成されていないキーストアの使用

- 8.1.2.3 ファイル・システムへのキーストアのコピーはサポート対象外

- 8.1.2.4 スタンドアロン環境でのOracle Wallet Managerの使用について

- 8.1.2.5 キーストア管理に関する追加情報

- 8.2 キーストアおよびウォレット用コマンドライン・インタフェース

- 8.3 JKSキーストアの管理

- 8.3.1 キーストアおよび証明書について

- 8.3.1.1 インスタンス間のキーストアの共有

- 8.3.1.2 キーストアのネーミング規則

- 8.3.2 キーストアのライフサイクルの管理

- 8.3.3 一般的なキーストアの操作

- 8.3.3.1 Fusion Middleware Controlを使用したキーストアの作成

- 8.3.3.2 WLSTを使用したキーストアの作成

- 8.3.3.3 Fusion Middleware Controlを使用したキーストアのエクスポート

- 8.3.3.4 WLSTを使用したキーストアのエクスポート

- 8.3.3.5 Fusion Middleware Controlを使用したキーストアの削除

- 8.3.3.6 WLSTを使用したキーストアの削除

- 8.3.3.7 Fusion Middleware Controlを使用したキーストアのインポート

- 8.3.3.8 WLSTを使用したキーストアのインポート

- 8.3.3.9 Fusion Middleware Controlを使用したキーストア・パスワードの変更

- 8.3.3.10 WLSTを使用したキーストア・パスワードの変更

- 8.3.4 証明書のライフサイクルの管理

- 8.3.5 一般的な証明書の操作

- 8.3.5.1 Fusion Middleware Controlを使用したキーストアの新しい鍵の生成

- 8.3.5.2 WLSTを使用したキーストアの新しい鍵の生成

- 8.3.5.3 Fusion Middleware Controlを使用した証明書署名リクエストの生成

- 8.3.5.4 WLSTを使用した証明書署名リクエストの生成

- 8.3.5.5 Fusion Middleware Controlを使用したキーストアへの証明書または信頼できる証明書のインポート

- 8.3.5.6 WLSTを使用したキーストアへの証明書または信頼できる証明書のインポート

- 8.3.5.7 Fusion Middleware Controlを使用したキーストアからの証明書または信頼できる証明書のエクスポート

- 8.3.5.8 WLSTを使用したキーストアからの証明書または信頼できる証明書のエクスポート

- 8.3.5.9 Fusion Middleware Controlを使用したキーストアからの証明書または信頼できる証明書の削除

- 8.3.5.10 WLSTを使用したキーストアからの証明書または信頼できる証明書の削除

- 8.3.5.11 Fusion Middleware Controlを使用したサード・パーティ証明書への自己署名証明書の変換

- 8.3.5.12 WLSTを使用したサード・パーティ証明書への自己署名証明書の変換

- 8.3.6 キーストアおよび証明書の保守

- 8.3.6.1 キーストアの場所

- 8.3.6.2 期限が切れそうな証明書の置換え

- 8.3.6.3 ホスト名変更のキーストアへの影響

- 8.4 ウォレットの管理

- 8.4.1 ウォレットおよび証明書について

- 8.4.1.1 パスワードで保護されたウォレットと自動ログイン・ウォレット

- 8.4.1.2 自己署名付きウォレットとサード・パーティのウォレット

- 8.4.1.3 インスタンス間でのウォレットの共有

- 8.4.1.4 ウォレットのネーミング規則

- 8.4.2 Fusion Middleware Controlのウォレット管理ページへのアクセス

- 8.4.3 ウォレットのライフサイクルの管理

- 8.4.4 一般的なウォレットの操作

- 8.4.4.1 Fusion Middleware Controlを使用したウォレットの作成

- 8.4.4.2 WLSTを使用したウォレットの作成

- 8.4.4.3 Fusion Middleware Controlを使用した自己署名付きウォレットの作成

- 8.4.4.4 WLSTを使用した自己署名付きウォレットの作成

- 8.4.4.5 Fusion Middleware Controlを使用した自己署名付きウォレットのサード・パーティのウォレットへの変更

- 8.4.4.6 WLSTを使用した自己署名付きウォレットのサード・パーティのウォレットへの変更

- 8.4.4.7 Fusion Middleware Controlを使用したウォレットのエクスポート

- 8.4.4.8 WLSTを使用したウォレットのエクスポート

- 8.4.4.9 Fusion Middleware Controlを使用したウォレットのインポート

- 8.4.4.10 WLSTを使用したウォレットのインポート

- 8.4.4.11 Fusion Middleware Controlを使用したウォレットの削除

- 8.4.4.12 WLSTを使用したウォレットの削除

- 8.4.5 証明書のライフサイクルの管理

- 8.4.6 Fusion Middleware Controlのウォレットの証明書管理ページへのアクセス

- 8.4.7 一般的な証明書の操作

- 8.4.7.1 Fusion Middleware Controlを使用した証明書リクエストの追加

- 8.4.7.2 WLSTを使用した証明書リクエストの追加

- 8.4.7.3 Fusion Middleware Controlを使用した証明書、証明書リクエストまたは信頼できる証明書のエクスポート

- 8.4.7.4 WLSTを使用した証明書、証明書リクエストまたは信頼できる証明書のエクスポート

- 8.4.7.5 Fusion Middleware Controlを使用した証明書または信頼できる証明書のインポート

- 8.4.7.6 WLSTを使用した証明書または信頼できる証明書のインポート

- 8.4.7.7 Fusion Middleware Controlを使用した証明書リクエスト、証明書または信頼できる証明書の削除

- 8.4.7.8 WLSTを使用した証明書リクエスト、証明書または信頼できる証明書の削除

- 8.4.7.9 Fusion Middleware Controlを使用したサード・パーティ証明書への自己署名証明書の変換

- 8.4.7.10 WLSTを使用したサード・パーティ証明書への自己署名証明書の変換

- 8.4.8 ウォレットおよび証明書の保守

- 8.4.8.1 ウォレットの場所

- 8.4.8.2 ホスト名変更のウォレットへの影響

- 8.4.8.3 自己署名付きウォレットのサード・パーティのウォレットへの変更

- 8.4.8.4 ウォレット内の期限が切れそうな証明書の置換え

第IV部 アプリケーションのデプロイ

9 デプロイ・プロセスの概要

- 9.1 デプロイヤとは

- 9.2 アプリケーション設計から本番デプロイへの一般的な移行手順

- 9.2.1 アプリケーションの設計および開発

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

- 9.2.3 他の環境へのアプリケーションの移行の自動化

- 9.3 一般的な問題の診断

10 アプリケーションのデプロイ

- 10.1 アプリケーションのデプロイの概要

- 10.1.1 デプロイ可能なアプリケーションのタイプ

- 10.1.2 デプロイ、再デプロイおよびアンデプロイの概要

- 10.2 データソースの概要と管理

- 10.2.1 データソースの概要

- 10.2.2 JDBCデータソースの作成と管理

- 10.2.2.1 Fusion Middleware Controlを使用したJDBCデータソースの作成

- 10.2.2.2 Fusion Middleware Controlを使用したJDBCデータソースの編集

- 10.2.2.3 Fusion Middleware Controlを使用したJDBCデータソースの監視

- 10.2.2.4 Fusion Middleware Controlを使用したJDBCデータソースの管理

- 10.2.2.5 Fusion Middleware Controlを使用したGridLinkデータソースの作成

- 10.3 Java EEアプリケーションのデプロイ、アンデプロイおよび再デプロイ

- 10.3.1 Java EEアプリケーションのデプロイ

- 10.3.1.1 Fusion Middleware Controlを使用したJava EEアプリケーションのデプロイ

- 10.3.1.2 WLSTを使用したJava EEアプリケーションのデプロイ

- 10.3.2 Java EEアプリケーションのアンデプロイ

- 10.3.2.1 Fusion Middleware Controlを使用したJava EEアプリケーションのアンデプロイ

- 10.3.2.2 WLSTを使用したJava EEアプリケーションのアンデプロイ

- 10.3.3 Java EEアプリケーションの再デプロイ

- 10.3.3.1 Fusion Middleware Controlを使用したJava EEアプリケーションの再デプロイ

- 10.3.3.2 WLSTを使用したJava EEアプリケーションの再デプロイ

- 10.4 Oracle ADFアプリケーションのデプロイ、アンデプロイおよび再デプロイ

- 10.4.1 Oracle ADFアプリケーションのデプロイ

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

- 10.4.1.2 WLSTまたは管理コンソールを使用したADFアプリケーションのデプロイ

- 10.4.2 Oracle ADFアプリケーションのアンデプロイ

- 10.4.3 Oracle ADFアプリケーションの再デプロイ

- 10.5 SOAコンポジット・アプリケーションのデプロイ、アンデプロイおよび再デプロイ

- 10.5.1 SOAコンポジット・アプリケーションのデプロイ

- 10.5.2 SOAコンポジット・アプリケーションのアンデプロイ

- 10.5.3 SOAコンポジット・アプリケーションの再デプロイ

- 10.6 WebCenter Portalアプリケーションのデプロイ、アンデプロイおよび再デプロイ

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

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

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

- 10.7 デプロイ・プランの管理

- 10.8 Fusion Middleware Controlでの一般的なデプロイ・タスクについて

- 10.9 デプロイされたアプリケーションでのMDS構成属性の変更

- 10.9.1 Fusion Middleware Controlを使用したMDS構成属性の変更

- 10.9.2 WLSTを使用したMDS構成の変更

- 10.9.3 アプリケーションの元のMDS構成のリストア

第V部 Oracle Fusion Middlewareの監視

11 Oracle Fusion Middlewareの監視

- 11.1 Oracle Fusion Middlewareのステータスの監視

- 11.1.1 一般情報の表示

- 11.1.2 Oracle WebLogic Serverドメインの監視

- 11.1.3 Oracle WebLogic Serverの管理サーバーや管理対象サーバーの監視

- 11.1.4 クラスタの監視

- 11.1.5 Javaコンポーネントの監視

- 11.1.6 システム・コンポーネントの監視

- 11.1.7 Java EEアプリケーションの監視

- 11.1.8 ADFアプリケーションの監視

- 11.1.9 SOAコンポジット・アプリケーションの監視

- 11.1.10 Oracle WebCenter Portalアプリケーションの監視

- 11.1.11 クラスタにデプロイされたアプリケーションの監視

- 11.2 Oracle Fusion Middlewareのパフォーマンスの表示

- 11.3 ルーティング・トポロジの表示

12 ログ・ファイルと診断データの管理

- 12.1 Oracle Fusion Middlewareのロギングの概要

- 12.2 ODLメッセージおよびODLログ・ファイルについて

- 12.3 ログ・ファイルの表示と検索

- 12.3.1 ログ・ファイルおよびそのメッセージの表示

- 12.3.1.1 Fusion Middleware Controlを使用したログ・ファイルおよびそのメッセージの表示

- 12.3.1.2 WLSTを使用したログ・ファイルおよびそのメッセージの表示

- 12.3.2 ログ・ファイルの検索

- 12.3.2.1 Fusion Middleware Controlを使用したログ・ファイルの検索

- 12.3.2.1.1 ログ・ファイルの検索: 基本検索

- 12.3.2.1.2 ログ・ファイルの検索: 拡張検索

- 12.3.2.2 WLSTを使用したログ・ファイルの検索

- 12.3.3 ログ・ファイルのダウンロード

- 12.3.3.1 Fusion Middleware Controlを使用したログ・ファイルのダウンロード

- 12.3.3.2 WLSTを使用したログ・ファイルのダウンロード

- 12.4 ログ・ファイルの設定の構成

- 12.4.1 ログ・ファイルの場所の変更

- 12.4.1.1 Fusion Middleware Controlを使用したログ・ファイルの場所の変更

- 12.4.1.2 WLSTを使用したログ・ファイルの場所の変更

- 12.4.2 ログ・ファイルのローテーションの構成

- 12.4.2.1 Fusion Middleware Controlを使用したログ・ファイル・ローテーションの指定

- 12.4.2.2 WLSTを使用したログ・ファイル・ローテーションの指定

- 12.4.3 ログ・ファイルに書き込まれる情報レベルの設定

- 12.4.3.1 Fusion Middleware Controlを使用したメッセージ・レベルの構成

- 12.4.3.2 WLSTを使用したメッセージ・レベルの構成

- 12.4.4 ログ・ファイル形式の指定

- 12.4.4.1 Fusion Middleware Controlを使用したログ・ファイル形式の指定

- 12.4.4.2 WLSTを使用したログ・ファイル形式の指定

- 12.4.5 ログ・ファイルのロケールの指定

- 12.4.5.1 WLSTを使用したログ・ファイルのエンコーディングの指定

- 12.4.5.2 logging.xmlでのログ・ファイルのエンコーディングの指定

- 12.5 ログ・ファイルおよびコンポーネント間のメッセージの関連付け

- 12.6 トレースの構成

- 12.6.1 QuickTraceの構成と使用

- 12.6.1.1 Fusion Middleware Controlを使用したQuickTraceの構成

- 12.6.1.1.1 Fusion Middleware Controlを使用したQuickTraceの構成

- 12.6.1.1.2 Fusion Middleware Controlを使用したトレース・メッセージのファイルへの書き込み

- 12.6.1.2 WLSTを使用したQuickTraceの構成

- 12.6.1.2.1 WLSTを使用したQuickTraceの構成

- 12.6.1.2.2 WLSTを使用したトレース・メッセージのファイルへの書き込み

- 12.6.1.2.3 WLSTを使用したQuickTraceの無効化

- 12.6.2 選択的トレースの構成と使用

- 12.6.2.1 Fusion Middleware Controlを使用した選択的トレースの構成

- 12.6.2.1.1 Fusion Middleware Controlを使用した選択的トレースの構成

- 12.6.2.1.2 Fusion Middleware Controlを使用した選択的トレースの表示

- 12.6.2.1.3 Fusion Middleware Controlを使用した選択的トレースの無効化

- 12.6.2.2 WLSTを使用した選択的トレースの構成

- 12.6.2.2.1 WLSTを使用した選択的トレースの構成

- 12.6.2.2.2 WLSTを使用した選択的トレースの表示

- 12.6.2.2.3 WLSTを使用した選択的トレースの無効化

13 問題の診断

- 13.1 診断フレームワークの概要

- 13.1.1 インシデントと問題について

- 13.1.1.1 インシデントのフラッド制御

- 13.1.2 診断フレームワークのコンポーネント

- 13.1.2.1 自動診断リポジトリ

- 13.1.2.2 診断ダンプ

- 13.1.2.3 管理MBean

- 13.1.2.4 診断フレームワーク用WLSTコマンド

- 13.1.2.5 ADRCIコマンドライン・ユーティリティ

- 13.2 診断フレームワークの動作

- 13.3 診断フレームワークの構成

- 13.3.1 診断フレームワークの設定の構成

- 13.3.2 カスタム診断ルールの構成

- 13.3.3 問題抑制の構成

- 13.3.4 診断フレームワーク用のWLDF監視および通知の構成

- 13.4 問題の調査、報告および解決

- 13.4.1 ロードマップ—問題の調査、報告および解決

- 13.4.2 問題およびインシデントの確認

- 13.4.2.1 問題の確認

- 13.4.2.2 インシデントの確認

- 13.4.3 特定の問題キーの分析

- 13.4.4 診断ダンプの処理

- 13.4.4.1 診断ダンプの一覧表示

- 13.4.4.2 診断ダンプの説明の表示

- 13.4.4.3 ダンプの実行

- 13.4.5 診断ダンプ・サンプリングの構成と使用

- 13.4.5.1 診断ダンプ・サンプリングについて

- 13.4.5.2 ダンプ・サンプリングの構成

- 13.4.5.2.1 ダンプ・サンプリングの作成

- 13.4.5.2.2 ダンプ・サンプリング設定の変更

- 13.4.5.2.3 ダンプ・サンプリングの削除

- 13.4.5.2.4 すべてのダンプ・サンプリングの有効化または無効化

- 13.4.5.3 ダンプ・サンプリングのリスト

- 13.4.5.4 ダンプ・サンプリング出力の取得

- 13.4.5.4.1 executeDumpコマンドを使用したダンプ・サンプルの取得

- 13.4.5.4.2 getSamplingArchivesコマンドを使用したダンプ・サンプルの取得

- 13.4.6 インシデントの管理

- 13.4.6.1 インシデントの手動作成

- 13.4.6.2 インシデントのパッケージ化

- 13.4.6.3 インシデントのパージ

- 13.4.7 RDAレポートの生成

- 13.5 ヘルス・テスト・フレームワークの管理および実行

- 13.5.1 ヘルス・テスト・フレームワークについて

- 13.5.2 ヘルス・テスト・フレームワークのファイル・リポジトリについて

- 13.5.3 ヘルス・テスト・フレームワークのコマンドラインの使用方法

- 13.5.3.1 dfwhealthtestadminctl.shコマンドライン

- 13.5.3.1.1 help

- 13.5.3.1.2 register

- 13.5.3.1.3 index

- 13.5.3.2 dfwhealthtestctl.shコマンドライン

- 13.5.3.2.1 desctest

- 13.5.3.2.2 help

- 13.5.3.2.3 listrun

- 13.5.3.2.4 listtest

- 13.5.3.2.5 report

- 13.5.3.2.6 run

- 13.5.3.2.7 status

- 13.5.4 ヘルス・テスト・フレームワークの管理

- 13.5.4.1 リポジトリの作成およびヘルス・テスト・フレームワーク・テストの登録

- 13.5.4.2 ヘルス・テスト・フレームワークの索引の再構築

- 13.5.5 ヘルス・テスト・フレームワークの診断テストの実行

- 13.5.6 ヘルス・テスト・フレームワークの診断テストの検索

- 13.5.7 ヘルス・テスト・フレームワーク・テストの説明の取得

- 13.5.8 ヘルス・テスト・フレームワークのテスト・ランのリスト

- 13.5.9 ヘルス・テスト・フレームワークのレポートの生成

第VI部 高度な管理

14 メタデータ・リポジトリの管理

- 14.1 メタデータ・リポジトリの概要

- 14.2 データベース・ベース・メタデータ・リポジトリの作成

- 14.3 MDSリポジトリの管理

- 14.3.1 MDSリポジトリの概要

- 14.3.1.1 MDSでサポートされるデータベース

- 14.3.1.2 MDS操作の概要

- 14.3.2 データベース・ベースのMDSリポジトリの登録および登録解除

- 14.3.2.1 データベース・ベースのMDSリポジトリの登録

- 14.3.2.1.1 Fusion Middleware Controlを使用したデータベース・ベースのMDSリポジトリの登録

- 14.3.2.1.2 WLSTを使用したデータベース・ベースのMDSリポジトリの登録

- 14.3.2.2 MDSリポジトリをターゲットとするサーバーの追加または削除

- 14.3.2.3 データベース・ベースのMDSリポジトリの登録解除

- 14.3.2.3.1 Fusion Middleware Controlを使用したデータベース・ベースのMDSリポジトリの登録解除

- 14.3.2.3.2 WLSTを使用したデータベース・ベースのMDSリポジトリの登録解除

- 14.3.3 ファイルベースのMDSリポジトリの登録および登録解除

- 14.3.3.1 ファイルベースのMDSリポジトリの作成および登録

- 14.3.3.2 ファイルベースのMDSリポジトリの登録解除

- 14.3.4 システム・データソースの変更

- 14.3.5 システムMBeanを使用したMDSリポジトリの管理

- 14.3.6 MDSリポジトリに関する情報の表示

- 14.3.6.1 Fusion Middleware Controlを使用したMDSリポジトリに関する情報の表示

- 14.3.6.2 システムMBeanを使用したMDSリポジトリに関する情報の表示

- 14.3.7 アプリケーションでの別のMDSリポジトリまたはパーティションの使用の構成

- 14.3.7.1 パーティションのクローニング

- 14.3.7.2 新しいパーティションの作成とアプリケーションの再関連付け

- 14.3.8 ソース・システムからターゲット・システムへのメタデータの移動

- 14.3.8.1 Fusion Middleware Controlを使用したメタデータの転送

- 14.3.8.2 WLSTを使用したメタデータの転送

- 14.3.9 ファイルベース・リポジトリからデータベース・ベース・リポジトリへの移動

- 14.3.10 リポジトリからのメタデータ・パーティションの削除

- 14.3.10.1 Fusion Middleware Controlによるメタデータ・パーティションの削除

- 14.3.10.2 WLSTによるメタデータ・パーティションの削除

- 14.3.11 メタデータ・バージョン履歴のパージ

- 14.3.11.1 Fusion Middleware Controlによるメタデータ・バージョン履歴のパージ

- 14.3.11.2 WLSTによるメタデータ・バージョン履歴のパージ

- 14.3.11.3 自動パージの有効化

- 14.3.12 MDSリポジトリでのメタデータ・ラベルの管理

- 14.3.12.1 メタデータ・ラベルの作成

- 14.3.12.2 メタデータ・ラベルの一覧表示

- 14.3.12.3 メタデータ・ラベルの昇格

- 14.3.12.4 メタデータ・ラベルのパージ

- 14.3.12.4.1 Fusion Middleware Controlを使用したメタデータ・ラベルのパージ

- 14.3.12.4.2 WLSTを使用したメタデータ・ラベルのパージ

- 14.3.12.5 メタデータ・ラベルの削除

- 14.4 メタデータ・リポジトリ・スキーマの管理

- 14.4.1 メタデータ・リポジトリ・スキーマ・パスワードの変更

- 14.4.2 メタデータ・リポジトリのキャラクタ・セットの変更

- 14.5 データのパージ

- 14.5.1 Oracle Infrastructure Webサービスのデータのパージ

- 14.5.2 Oracle WebCenter Portalデータのパージ

- 14.5.2.1 Oracle WebCenter Portalのアクティビティ・ストリーム・データのパージ

- 14.5.2.2 Oracle WebCenter Portalの分析データのパージ

- 14.5.2.2.1 Oracle WebCenter Portalのパージ・パッケージのロード

- 14.5.2.2.2 Oracle WebCenter Portalのパージ・スクリプトの実行

- 14.5.2.3 Oracle WebCenter Portalの分析データのパーティショニング

15 ネットワーク構成の変更

- 15.1 Oracle Fusion Middlewareのネットワーク構成の変更

- 15.1.1 管理サーバーのネットワーク構成の変更

- 15.1.2 管理対象サーバーのネットワーク構成の変更

- 15.1.3 Web層コンポーネントのネットワーク構成の変更

- 15.2 データベースのネットワーク構成の変更

- 15.3 ネットワーク接続のオン/オフの切替え

- 15.3.1 ネットワーク接続のオフからオンへの変更(静的IPアドレス)

- 15.3.2 ネットワーク接続のオフからオンへの変更(DHCP)

- 15.3.3 ネットワーク接続のオンからオフへの変更(静的IPアドレス)

- 15.4 静的IPアドレスとDHCPの切替え

- 15.4.1 静的IPアドレスからDHCPへの切替え

- 15.4.2 DHCPから静的IPアドレスへの切替え

- 15.5 IPv6の使用

- 15.5.1 IPv6ネットワーク・プロトコルでサポートされるトポロジ

- 15.5.2 Oracle HTTP ServerでIPv6を使用する場合の構成

- 15.5.3 Oracle SOA SuiteおよびFusion Middleware Controlでのデュアル・スタックの使用

- 15.5.4 Oracle Web CacheでのIPv6サポートの無効化

- 15.5.5 Oracle HTTP ServerでIPv6を使用する場合のOracle Single Sign-Onの構成

- 15.5.6 Oracle Access Manager 11gでのIPv6サポートの構成

- 15.5.6.1 前提条件

- 15.5.6.2 Oracle Access ManagerおよびIPv6の概要

- 15.5.6.2.1 Oracle Access Managerとチャレンジ・リダイレクトを使用したIPv6の構成

- 15.5.6.2.2 考慮事項

- 15.5.6.3 IPv6の構成: Oracle Access ManagerおよびWebgate用の別個のプロキシ

- 15.5.7 Oracle Access Manager 10gでのIPv6サポートの構成

- 15.5.7.1 IPv6による簡易認証

- 15.5.7.2 認証Webゲートとチャレンジ・リダイレクトを使用したIPv6の構成

- 15.5.7.3 考慮事項

- 15.5.7.4 前提条件

- 15.5.7.5 簡易認証を使用したIPv6の構成

- 15.5.7.6 認証Webゲートとチャレンジ・リダイレクトを使用したIPv6の構成

- 15.5.7.7 IPv6の構成: 認証Webゲート用とリソースWebゲート用で別々のプロキシ

第VII部 高度な管理: バックアップとリカバリ

16 バックアップとリカバリの概要

- 16.1 Oracle Fusion Middlewareのバックアップとリカバリの概要

- 16.1.1 管理サーバーで発生した障害の影響

- 16.1.2管理対象サーバーの独立(MSI)モード

- 16.1.3 管理対象サーバーでの構成の変更

- 16.2 Oracle Fusion Middlewareのディレクトリ構造

- 16.3 バックアップ計画の概要

- 16.3.1 バックアップのタイプ

- 16.3.2 バックアップ・アーティファクト

- 16.3.3 推奨されるバックアップ計画

- 16.4 リカバリ計画の概要

- 16.4.1 リカバリのタイプ

- 16.4.2 推奨されるリカバリ計画

- 16.5 Oracle Fusion Middlewareコンポーネントのバックアップおよびリカバリに関する推奨事項

- 16.5.1 Oracle WebLogic Serverのバックアップおよびリカバリに関する推奨事項

- 16.5.1.1 Oracle WebLogic Serverのバックアップおよびリカバリに関する推奨事項

- 16.5.1.2 Oracle WebLogic Server JMSのバックアップおよびリカバリに関する推奨事項

- 16.5.2 Oracle Identity Managementのバックアップおよびリカバリに関する推奨事項

- 16.5.2.1 Oracle Internet Directoryのバックアップおよびリカバリに関する推奨事項

- 16.5.2.2 Oracle Virtual Directoryのバックアップおよびリカバリに関する推奨事項

- 16.5.2.3 Oracle Directory Integration Platformのバックアップおよびリカバリに関する推奨事項

- 16.5.2.4 Oracle Directory Services Managerのバックアップおよびリカバリに関する推奨事項

- 16.5.2.5 Oracle Identity Federationのバックアップおよびリカバリに関する推奨事項

- 16.5.2.6 Oracle Access Managerのバックアップおよびリカバリに関する推奨事項

- 16.5.2.7 Oracle Adaptive Access Managerのバックアップおよびリカバリに関する推奨事項

- 16.5.2.8 Oracle Identity Managerのバックアップおよびリカバリに関する推奨事項

- 16.5.2.9 Oracle Identity Navigatorのバックアップおよびリカバリに関する推奨事項

- 16.5.3 Oracle SOA Suiteのバックアップおよびリカバリに関する推奨事項

- 16.5.3.1 Oracle BPEL Process Managerのバックアップおよびリカバリに関する推奨事項

- 16.5.3.2 Oracle Business Activity Monitoringのバックアップおよびリカバリに関する推奨事項

- 16.5.3.3 Oracle B2Bのバックアップおよびリカバリに関する推奨事項

- 16.5.3.4 Oracle Service Busのバックアップおよびリカバリに関する推奨事項

- 16.5.3.5 Oracle Mediatorのバックアップおよびリカバリに関する推奨事項

- 16.5.3.6 Oracle Business Rulesのバックアップおよびリカバリに関する推奨事項

- 16.5.3.7 Oracle Business Process Managementのバックアップおよびリカバリに関する推奨事項

- 16.5.4 Oracle WebCenter Portalのバックアップおよびリカバリに関する推奨事項

- 16.5.4.1 Oracle WebCenter Portalのバックアップおよびリカバリに関する推奨事項

- 16.5.4.2 Oracle WebCenter Portalのポートレット・プロデューサのバックアップおよびリカバリに関する推奨事項

- 16.5.4.3 Oracle WebCenter Portalのディスカッション・サーバーのバックアップおよびリカバリに関する推奨事項

- 16.5.4.4 Oracle WebCenter Portalのアクティビティ・グラフのバックアップおよびリカバリに関する推奨事項

- 16.5.4.5 Oracle WebCenter Portal分析のバックアップおよびリカバリに関する推奨事項

- 16.5.4.6 Oracle Content Serverのバックアップおよびリカバリに関する推奨事項

- 16.5.5 Oracle JRFインストールのバックアップおよびリカバリに関する推奨事項

- 16.5.5.1 Oracle Web Services Managerのバックアップおよびリカバリに関する推奨事項

- 16.5.5.2 Oracle Platform Security Servicesのバックアップおよびリカバリに関する推奨事項

- 16.5.6 Web層インストールのバックアップおよびリカバリに関する推奨事項

- 16.5.6.1 Oracle HTTP Serverのバックアップおよびリカバリに関する推奨事項

- 16.5.6.2 Oracle Web Cacheのバックアップおよびリカバリに関する推奨事項

- 16.5.7 Oracle Portal、Oracle Forms Services、Oracle Reports、Oracle BI Discovererの各インストールのバックアップおよびリカバリに関する推奨事項

- 16.5.7.1 Oracle Portalのバックアップおよびリカバリに関する推奨事項

- 16.5.7.2 Oracle Forms Servicesのバックアップおよびリカバリに関する推奨事項

- 16.5.7.3 Oracle Reportsのバックアップおよびリカバリに関する推奨事項

- 16.5.7.4 Oracle Business Intelligence Discovererのバックアップおよびリカバリに関する推奨事項

- 16.5.8 Oracle Business Intelligenceのバックアップおよびリカバリに関する推奨事項

- 16.5.8.1 Oracle BI Enterprise Editionのバックアップおよびリカバリに関する推奨事項

- 16.5.8.2 Oracle Business Intelligence Publisherのバックアップおよびリカバリに関する推奨事項

- 16.5.8.3 Oracle Real-Time Decisionsのバックアップおよびリカバリに関する推奨事項

- 16.5.9 Oracle Hyperion Enterprise Performance Management Systemのバックアップおよびリカバリに関する推奨事項

- 16.5.9.1 Oracle Essbaseのバックアップおよびリカバリに関する推奨事項

- 16.5.9.2 Oracle Hyperion Calculation Managerのバックアップおよびリカバリに関する推奨事項

- 16.5.9.3 Oracle Hyperion Financial Reportingのバックアップおよびリカバリに関する推奨事項

- 16.5.9.4 Oracle Hyperion Smart Viewのバックアップおよびリカバリに関する推奨事項

- 16.5.10 Oracle Data Integratorのバックアップおよびリカバリに関する推奨事項

- 16.5.11 Oracle WebCenter Contentのバックアップおよびリカバリに関する推奨事項

- 16.5.11.1 Oracle Information Rights Managementのバックアップおよびリカバリに関する推奨事項

- 16.5.11.2 Oracle WebCenter Content: Imagingのバックアップおよびリカバリに関する推奨事項

- 16.5.11.3 Oracle WebCenter Contentのバックアップおよびリカバリに関する推奨事項

- 16.5.11.4 Oracle WebCenter Content: Recordsのバックアップおよびリカバリに関する推奨事項

- 16.6 前提と制限

17 環境のバックアップ

- 17.1 環境のバックアップの概要

- 17.2 データのバックアップに関する制限事項

- 17.3 バックアップの実行

- 17.3.1 全体オフライン・バックアップの実行

- 17.3.2 ランタイム・アーティファクトのオンライン・バックアップの実行

- 17.3.3 Windowsレジストリ・エントリのバックアップ

- 17.4 Oracle Fusion Middleware構成の記録の作成

18 環境のリカバリ

- 18.1 環境のリカバリの概要

- 18.2 データの損失、破損、メディア障害またはアプリケーションの機能不全後のリカバリ

- 18.2.1 Middlewareホームのリカバリ

- 18.2.2 Oracle WebLogic Serverドメインのリカバリ

- 18.2.3 Oracleホームのリカバリ

- 18.2.4 Oracleインスタンス・ホームのリカバリ

- 18.2.4.1 ファイル・システムからOracleインスタンス・ホームが削除された後のリカバリ

- 18.2.4.2 Oracleインスタンス・ホームが登録解除された後のリカバリ

- 18.2.5 管理サーバー構成のリカバリ

- 18.2.6 管理対象サーバーのリカバリ

- 18.2.6.1 管理対象サーバーのリカバリ(起動できない場合)

- 18.2.6.2 管理対象サーバーのリカバリ(適切に機能しない場合)

- 18.2.6.3 ディレクトリが異なるOracle SOA Suite管理対象サーバーのリカバリ

- 18.2.7 コンポーネントのリカバリ

- 18.2.7.1 適切に機能してないコンポーネントのリカバリ

- 18.2.7.2 クラスタ構成変更後のコンポーネントのリカバリ

- 18.2.7.3 Oracle Identity Managerのリカバリ

- 18.2.7.4 Oracle Identity Navigatorのリカバリ

- 18.2.7.5 Oracle Access Managerのリカバリ

- 18.2.7.6 Oracle Adaptive Access Managerのリカバリ

- 18.2.7.7 Oracle Business Process Managementのリカバリ

- 18.2.7.8 Oracle WebCenter Portalアクティビティ・グラフのリカバリ

- 18.2.7.9 Oracle WebCenter Portal分析のリカバリ

- 18.2.7.10 Oracle BI Enterprise Editionのリカバリ

- 18.2.7.10.1 非クラスタ環境でのOracle BI Enterprise Editionのリカバリ

- 18.2.7.10.2 クラスタ環境でのOracle BI Enterprise Editionのリカバリ

- 18.2.7.10.3 LDAPデータベースとRPDの調整

- 18.2.7.10.4 LDAPデータベースとOracle BI Presentation Catalogの調整

- 18.2.7.11 Oracle Business Intelligence Publisherのリカバリ

- 18.2.7.12 Oracle Real-Time Decisionsのリカバリ

- 18.2.7.13 Oracle Essbaseのリカバリ

- 18.2.7.14 Oracle Hyperion Calculation Managerのリカバリ

- 18.2.7.15 Oracle Hyperion Financial Reportingのリカバリ

- 18.2.7.16 Oracle Hyperion Smart Viewのリカバリ

- 18.2.7.17 Oracle Data Integratorのリカバリ

- 18.2.7.18 Oracle Information Rights Managementのリカバリ

- 18.2.7.19 Oracle WebCenter Content: Imagingのリカバリ

- 18.2.7.20 Oracle WebCenter Contentのリカバリ

- 18.2.7.21 Oracle WebCenter Content: Recordsのリカバリ

- 18.2.8 クラスタのリカバリ

- 18.2.8.1 削除またはクラスタレベルの構成変更後のクラスタのリカバリ

- 18.2.8.2 メンバーシップを誤って変更した後のクラスタのリカバリ

- 18.2.9 アプリケーションのリカバリ

- 18.2.9.1 アプリケーション・アーティファクトのリカバリ

- 18.2.9.2 機能しなくなった再デプロイされたアプリケーションのリカバリ

- 18.2.9.3 アンデプロイされたアプリケーションのリカバリ

- 18.2.9.4 コンポジット・アプリケーションのリカバリ

- 18.2.10 データベースのリカバリ

- 18.3 ホスト破損後のリカバリ

- 18.3.1 Oracle WebLogic Serverドメイン・ホストの破損後のリカバリ

- 18.3.2 管理サーバー・ホストの破損後のリカバリ

- 18.3.2.1 同じホストへの管理サーバーのリカバリ

- 18.3.2.2 別のホストへの管理サーバーのリカバリ

- 18.3.3 管理対象サーバー・ホストの破損後のリカバリ

- 18.3.3.1 同じホストへの管理対象サーバーのリカバリ

- 18.3.3.2 別のホストへの管理対象サーバーのリカバリ

- 18.3.3.3 ディレクトリが異なるOracle SOA Suite管理対象サーバーのリカバリ

- 18.3.4 コンポーネント・ホスト破損後のリカバリ

- 18.3.4.1 同じホストへのJavaコンポーネントのリカバリ

- 18.3.4.2 別のホストへのJavaコンポーネントのリカバリ

- 18.3.4.3 同じホストへのシステム・コンポーネントのリカバリ

- 18.3.4.4 別のホストへのシステム・コンポーネントのリカバリ

- 18.3.4.5 別のホストへのアイデンティティ管理コンポーネントのリカバリ

- 18.3.4.5.1 別のホストへのOracle Internet Directoryのリカバリ

- 18.3.4.5.2 別のホストへのOracle Virtual Directoryのリカバリ

- 18.3.4.5.3 別のホストへのOracle Directory Integration Platformのリカバリ

- 18.3.4.5.4 別のホストへのOracle Identity Federationのリカバリ

- 18.3.4.5.5 別のホストへのOracle Identity Managerのリカバリ

- 18.3.4.5.6 別のホストへのOracle Identity Navigatorのリカバリ

- 18.3.4.5.7 別のホストへのOracle Access Managerのリカバリ

- 18.3.4.5.8 別のホストへのOracle Adaptive Access Managerのリカバリ

- 18.3.4.6 ホスト破損後のOracle SOA Suiteのリカバリ

- 18.3.4.7 別のホストへのWeb層コンポーネントのリカバリ

- 18.3.4.7.1 別のホストへのOracle HTTP Serverのリカバリ

- 18.3.4.7.2 別のホストへのOracle Web Cacheのリカバリ

- 18.3.4.8 別のホストへのOracle Portal、Oracle Reports、Oracle Forms ServicesおよびOracle Business Intelligence Discovererのリカバリ

- 18.3.4.8.1 別のホストへのOracle Portalのリカバリ

- 18.3.4.8.2 別のホストへのOracle Forms Servicesのリカバリ

- 18.3.4.8.3 別のホストへのOracle Reportsのリカバリ

- 18.3.4.8.4 別のホストへのOracle Business Intelligence Discovererのリカバリ

- 18.3.4.9 別のホストへのOracle BI Enterprise Editionのリカバリ

- 18.3.4.9.1 非クラスタ環境での別のホストへのOracle BI EEのリカバリ

- 18.3.4.9.2 クラスタ環境での別のホストへのOracle BI EEのリカバリ

- 18.3.4.9.3 Oracle BI EEのリカバリの追加手順

- 18.3.4.9.4 Oracle BI EEレジストリ・エントリのインポート

- 18.3.4.10 別のホストへのOracle Business Intelligence Publisherのリカバリ

- 18.3.4.11 別のホストへのOracle Real-Time Decisionsのリカバリ

- 18.3.4.12 ホスト破損後のOracle Essbaseのリカバリ

- 18.3.4.13 ホスト破損後のOracle Hyperion Calculation Managerのリカバリ

- 18.3.4.14 ホスト破損後のOracle Hyperion Financial Reportingのリカバリ

- 18.3.4.15 別のホストへのOracle Data Integratorのリカバリ

- 18.3.4.16 別のホストへのOracle WebCenter Contentのリカバリ

- 18.3.4.16.1 別のホストへのOracle WebCenter Contentのリカバリ

- 18.3.4.16.2 ホスト破損後のOracle WebCenter Content: Recordのリカバリ

- 18.3.5 ホストの破損後にエンティティをリカバリするための追加の操作

- 18.3.5.1 別のホストへのFusion Middleware Controlのリカバリ

- 18.3.5.2 Fusion Middleware Controlのtargets.xmlファイル内のホスト名の変更

- 18.3.5.3 コンポーネントを別のホストにリカバリした場合のOracle Management Agentのリカバリ

- 18.3.5.4 mod_wl_ohs.confファイルの変更

- 18.3.5.5 特定のコンポーネントの新しいマシンの作成

- 18.3.5.6 特定のアイデンティティ管理コンポーネントの、ユーザーのグループへの再関連付け

- 18.3.5.7 Oracleインベントリの更新

- 18.3.5.8 Windowsレジストリのリカバリ

- 18.3.6 データベース・ホストの破損後のリカバリ

第VIII部 高度な管理: 環境の拡張

19 環境のスケーリング

- 19.1 環境のスケーリングの概要

- 19.2 ドメインの拡張による追加コンポーネントのサポート

- 19.3 ドメインへの管理対象サーバーの追加

- 19.3.1 管理対象サーバーまたはクラスタへのOracle JRFテンプレートの適用

- 19.4 追加のOracleインスタンスとシステム・コンポーネントの作成

- 19.4.1 セキュアでないポートを使用してのOracleインスタンスの作成

- 19.4.2 セキュアなポートを使用してのOracleインスタンスの作成

- 19.4.3 システム・コンポーネントの無効化

- 19.5 クラスタの作成

- 19.6 Middlewareホームまたはコンポーネントのコピー

20 移行スクリプトの使用

- 20.1 移行スクリプトの概要

- 20.2 移行スクリプト

- 20.2.1 移行スクリプトの構文

- 20.2.1.1 copyBinaryスクリプト

- 20.2.1.2 pasteBinaryスクリプト

- 20.2.1.3 Javaコンポーネント用のcopyConfigスクリプト

- 20.2.1.4 Oracleインスタンス用のcopyConfigスクリプト

- 20.2.1.5 システム・コンポーネント用のcopyConfigスクリプト

- 20.2.1.6 ノード・マネージャ用のcopyConfigスクリプト

- 20.2.1.7 extractMovePlanスクリプト

- 20.2.1.8 Javaコンポーネント用のpasteConfigスクリプト

- 20.2.1.9 Oracleインスタンス用のpasteConfigスクリプト

- 20.2.1.10 システム・コンポーネント用のpasteConfigスクリプト

- 20.2.1.11 ノード・マネージャ用のpasteConfigスクリプト

- 20.2.1.12 obfuscatePasswordスクリプト

- 20.3 移動計画の変更

- 20.3.1 configGroup要素の場所

- 20.3.2 移動計画のプロパティ

21 テスト環境から本番環境への移行

- 21.1 Oracle Fusion Middlewareコンポーネントの移行の概要

- 21.2 ソース環境からターゲット環境への移行手順の概要

- 21.3 ターゲット環境への移行の一般的な手順

- 21.3.1 ソース環境の準備

- 21.3.2 ターゲット環境の準備

- 21.3.3 ターゲット環境でのデータベースのインストール

- 21.3.4 Middlewareホームおよびバイナリ・ファイルの移行

- 21.3.5 Javaコンポーネントの構成の移行

- 21.3.6 Oracleインスタンスおよびシステム・コンポーネントの構成の移行

- 21.3.6.1 Oracleインスタンスおよびそのすべてのシステム・コンポーネントの移行

- 21.3.6.2 個別のシステム・コンポーネントの移行

- 21.3.7 ユーザーおよびグループの構成

- 21.4 Oracle Fusion Middlewareコンポーネントの移行

- 21.4.1 アイデンティティ管理コンポーネントのターゲット環境への移行

- 21.4.1.1 アイデンティティ管理の新しいターゲット環境への移行

- 21.4.1.2 アイデンティティ管理の既存のターゲット環境への移行

- 21.4.2 Oracle SOA Suiteのターゲット環境への移行

- 21.4.2.1 Oracle SOA Suiteの新しいターゲット環境への移行

- 21.4.2.2 Oracle SOA Suiteの既存のターゲット環境への移行

- 21.4.3 Oracle WebCenter Portalのターゲット環境への移行

- 21.4.3.1 Oracle WebCenter Portalの新しいターゲット環境への移行

- 21.4.3.2 Oracle WebCenter Portalの既存のターゲット環境への移行

- 21.4.4 Oracle WebCenter Contentのターゲット環境への移行

- 21.4.4.1 Oracle WebCenter Contentの新しいターゲット環境への移行

- 21.4.4.2 Oracle WebCenter Contentの既存のターゲット環境への移行

- 21.4.5 Oracle Hyperion Enterprise Performance Management Systemのターゲット環境への移行

- 21.4.6 Web層のターゲット環境への移行

- 21.4.6.1 Web層の新しいターゲット環境への移行

- 21.4.6.1.1 Oracle HTTP Serverの新しいターゲット環境への移行

- 21.4.6.1.2 Oracle Web Cacheの新しいターゲット環境への移行

- 21.4.6.2 Web層の既存のターゲット環境への移行

- 21.4.6.2.1 Oracle HTTP Serverの既存のターゲット環境への移行

- 21.4.7 Oracle Business Intelligenceのターゲット環境への移行

- 21.4.7.1 Oracle Business Intelligenceの新しいターゲット環境への移行

- 21.4.7.2 適用するパッチが少ない場合のOracle Business Intelligenceの既存のターゲット環境への移行

- 21.4.7.3 適用するパッチが多数ある場合のOracle Business Intelligenceコンポーネントの既存のターゲット環境への移行

- 21.4.7.3.1 新しいハードウェアが使用可能な場合のOracle BI EEの既存のターゲット環境への移行

- 21.4.7.3.2 新しいハードウェアが使用できない場合のOracle BI EEの既存のターゲット環境への移行

- 21.4.8 Oracle Real-Time Decisionsのターゲット環境への移行

- 21.4.8.1 Oracle Real-Time Decisionsの新しいターゲット環境への移行

- 21.4.8.2 Oracle Real-Time Decisionsの既存のターゲット環境への移行

- 21.4.9 Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle BI Discovererのターゲット環境への移行

- 21.4.9.1 Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle Business Intelligence Discovererの新しいターゲット環境への移行

- 21.4.9.2 Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle Business Intelligence Discovererの既存のターゲット環境への移行

- 21.4.10 Oracle Data Integratorのターゲット環境への移行

- 21.4.10.1 Oracle Data Integratorの新しいターゲット環境への移行

- 21.4.10.2 Oracle Data Integratorの既存のターゲット環境への移行

- 21.5 マルチホスト環境への移行またはマルチホスト環境からの移行に関する考慮事項

- 21.6 Oracle RAC環境への移行またはOracle RAC環境からの移行に関する考慮事項

- 21.7 ソースからターゲットへの移行に関する制限事項

- 21.8 テストから本番への移行におけるエラーのリカバリ

- 21.9 事例: Oracle SOA SuiteおよびFusion Order Demoの新しいターゲット環境への移行

第IX部 付録

A Oracle Fusion Middlewareのコマンドライン・ツール

B コンポーネントのURL

C ポート番号

- C.1 コンポーネント別のポート番号

- C.2 ポート番号(番号順)

D メタデータ・リポジトリ・スキーマ

- D.1 メタデータ・リポジトリ・スキーマの説明

- D.2 メタデータ・リポジトリのスキーマ、表領域およびデータファイル

E Oracle Fusion Middlewareのアクセシビリティ・オプションの使用

- E.1 Java Access Bridgeのインストールおよび構成(Windowsのみ)

- E.2 Fusion Middleware Controlアクセシビリティ・モードの有効化

- E.2.1 HTMLページに対するアクセスのしやすさの強化

- E.2.2 Fusion Middleware Controlグラフのテキスト説明の表示

- E.3 Fusion Middleware Controlのキーボード・ナビゲーション

F 管理上の変更の例

- F.1 この付録の使い方

- F.2 管理上の変更の例(コンポーネント別)

G リリース番号の確認

- G.1 リリース番号の書式

- G.2 ソフトウェア・インベントリおよびリリース番号の確認

- G.2.1 Oracle Fusion Middlewareインストールのリリース番号の確認

- G.2.2 Oracle WebLogic Serverのリリース番号の確認

- G.2.3 コンポーネント・リリース番号の確認

- G.2.4 Oracle Internet Directoryのリリース番号の確認

- G.2.5 メタデータ・リポジトリのリリース番号の確認

- G.2.6 スキーマのリリース番号の確認

H Oracle Wallet Managerおよびorapki

- H.1 新しいorapki機能

- H.1.1 orapkiの使用例

- H.1.2 新しいCRL管理機能

- H.1.3 新しいバージョン3の証明書サポート

- H.1.4 トラスト・チェーンのエクスポート

- H.1.5 ウォレット・パスワードの変更

- H.1.6 OracleウォレットとJKSキーストア間の変換

- H.2 証明書の検証とCRL管理にorapkiユーティリティを使用する方法

- H.2.1 orapkiの概要

- H.2.1.1 orapkiの構文

- H.2.1.2 orapkiの環境設定

- H.2.2 orapkiヘルプの表示

- H.2.3 テスト用の署名付き証明書の作成

- H.2.4 orapkiユーティリティを使用したOracleウォレットの管理

- H.2.4.1 orapkiを使用したOracleウォレットの作成と表示

- H.2.4.2 orapkiを使用した証明書と証明書リクエストのOracleウォレットへの追加

- H.2.4.3 orapkiを使用した証明書と証明書リクエストのOracleウォレットからのエクスポート

- H.2.5 orapkiユーティリティを使用した証明書失効リスト(CRL)の管理

- H.2.5.1 証明書失効リストを使用した証明書の検証について

- H.2.5.1.1 使用するCRL

- H.2.5.1.2 CRLチェックのしくみ

- H.2.5.2 証明書失効リストの管理

- H.2.5.2.1 証明書検証用ハッシュ値によるCRLの名前変更

- H.2.5.2.2 Oracle Internet DirectoryへのCRLのアップロード

- H.2.5.2.3 Oracle Internet Directoryに格納されているCRLの一覧表示

- H.2.5.2.4 Oracle Internet DirectoryでのCRLの表示

- H.2.5.2.5 Oracle Internet DirectoryからのCRLの削除

- H.2.6 orapkiユーティリティ・コマンドのサマリー

- H.2.6.1 orapki cert create

- H.2.6.1.1 目的

- H.2.6.1.2 構文

- H.2.6.2 orapki cert display

- H.2.6.2.1 目的

- H.2.6.2.2 構文

- H.2.6.3 orapki crl create

- H.2.6.3.1 目的

- H.2.6.3.2 構文

- H.2.6.4 orapki crl delete

- H.2.6.4.1 目的

- H.2.6.4.2 構文

- H.2.6.5 orapki crl display

- H.2.6.5.1 目的

- H.2.6.5.2 構文

- H.2.6.6 orapki crl hash

- H.2.6.6.1 目的

- H.2.6.6.2 構文

- H.2.6.7 orapki crl list

- H.2.6.7.1 目的

- H.2.6.7.2 構文

- H.2.6.8 orapki crl revoke

- H.2.6.8.1 目的

- H.2.6.8.2 構文

- H.2.6.9 orapki crl status

- H.2.6.9.1 目的

- H.2.6.9.2 構文

- H.2.6.10 orapki crl upload

- H.2.6.10.1 目的

- H.2.6.10.2 構文

- H.2.6.11 orapki crl verify

- H.2.6.11.1 目的

- H.2.6.11.2 構文

- H.2.6.12 orapki wallet add

- H.2.6.12.1 目的

- H.2.6.12.2 構文

- H.2.6.13 orapki wallet change_pwd

- H.2.6.13.1 目的

- H.2.6.13.2 構文

- H.2.6.14 orapki wallet create

- H.2.6.14.1 目的

- H.2.6.14.2 構文

- H.2.6.15 orapki wallet display

- H.2.6.15.1 目的

- H.2.6.15.2 構文

- H.2.6.16 orapki wallet export

- H.2.6.16.1 目的

- H.2.6.16.2 構文

- H.2.6.17 orapki wallet export_trust_chain

- H.2.6.17.1 目的

- H.2.6.17.2 構文

- H.3 Oracle Wallet Managerと同等の機能

- H.4 orapkiと同等の機能

- H.5 SSL構成ツールと同等の機能

I Oracle Fusion Middlewareのトラブルシューティング

- I.1 Oracle Fusion Middlewareの障害の診断

- I.2 一般的な障害と解決策

- I.2.1 データソース接続の不足

- I.2.2 異なるバージョンのSpringの使用

- I.2.3 管理対象サーバー起動時のClassNotFoundエラー

- I.3 Fusion Middleware Controlのトラブルシューティング

- I.3.1 Fusion Middleware Controlのパフォーマンス・メトリックおよびグラフの表示のトラブルシューティング

- I.3.1.1 エージェントの監視中のターゲットとは

- I.3.1.2 ファームにおけるすべてのエージェントの監視中のターゲットの監視資格証明の設定

- I.3.1.3 特定のエージェントの監視中のターゲットの監視資格証明の変更

- I.3.1.4 Oracle Management AgentのURLの確認または変更

- I.3.2 Fusion Middleware ControlからOracle WebLogic Server管理コンソールへの接続の保護

- I.3.3 Windowsのネイティブ認証用のFusion Middleware Controlの構成

- I.4 SSLのトラブルシューティング

- I.4.1 コンポーネントですべてのサポートされている暗号が有効になる場合がある

- I.4.2 Oracleウォレットのかわりのユーザー証明書

- I.5 他のヘルプが必要な場合

- I.5.1 Remote Diagnostic Agentの使用

索引

図一覧

- 2-1 Oracle Fusion Middleware環境

- 2-2 Oracle WebLogic Serverドメイン

- 6-1 SSLハンドシェイク

- 6-2 Oracle Fusion MiddlewareにおけるSSL

- 13-1 Oracle Fusion MiddlewareのADRディレクトリ構造

- 13-2 インシデント・ログ検出で生成されるインシデント作成

- 13-3 WLDF監視および通知で生成されるインシデント作成

- 13-4 問題調査のフロー

- 15-1 Oracle Access Managerとチャレンジ・リダイレクトを使用したIPv6

- 15-2 IPv6/IPv4プロキシによる簡易認証

- 15-3 認証Webゲートとチャレンジ・リダイレクトを使用したIPv6

- 17-1 バックアップのタイプを判断するためのフロー・チャート

- G-1 Oracle Fusion Middlewareのリリース番号の例

表一覧

- 3-1 環境変数(LinuxおよびUNIX用)

- 3-2 環境変数(Windows用)

- 3-3 Fusion Middleware ControlとWebLogic Server管理コンソールの比較

- 3-4 Fusion Middleware Controlでのナビゲート

- 6-1 SSL構成用WLSTコマンド

- 6-2 Oracleウォレット管理用WLSTコマンド

- 6-3 Javaキーストア(JKS)管理用WLSTコマンド

- 6-4 プロパティ・ファイルのパラメータ

- 6-5 パラメータのデフォルト値

- 7-1 メイン・スクリプト

- 7-2 SSL自動化ツールのドメイン・レベルの情報変数

- 7-3 SSL自動化ツールのコンポーネント固有の情報変数

- 7-4 SSLServerConfig.shのコンポーネント・オプション

- 7-5 SSLClientConfig.shのコンポーネント・オプション

- 9-1 Oracle JDeveloperの拡張機能

- 10-1 アプリケーションをデプロイするツール

- 10-2 デプロイされたアプリケーションでのMDS構成属性

- 12-1 ODL形式メッセージのフィールド

- 12-2 ログ・ファイルの場所

- 12-3 診断メッセージのタイプとレベル

- 12-4 ODL、Oracle WebLogic ServerおよびJava間のログ・レベルのマッピング

- 13-1 診断フレームワークのDiagnosticConfig MBeanの属性

- 13-2 LogDetectionConditions要素の条件

- 13-3 defaultActions要素に対するオプションの引数

- 13-4 ruleCondition要素の属性

- 13-5 問題抑制フィルタのDiagnosticConfig MBeanの操作および属性

- 13-6 捕えられていない例外の問題キー

- 13-7 診断ダンプ操作

- 13-8 デフォルトの診断ダンプ・サンプリング構成

- 13-9 ヘルス・テスト・フレームワークのdfwhealthtestadminctl.shコマンド

- 13-10 ヘルス・テスト・フレームワークのdfwhealthtestctl.shコマンド

- 14-1 MDSの操作と必要なロール

- 14-2 データのパージに関する情報

- 15-1 IPv6のサポート

- 18-1 特定のコンポーネントのリカバリ手順

- 18-2 特定コンポーネントのホスト破損の際のリカバリ手順

- 19-1 サポート対象のドメインの拡張

- 20-1 移行スクリプトのサポート

- 20-2 移行スクリプト

- 20-3 copyBinaryスクリプトのオプション

- 20-4 pasteBinaryスクリプトのオプション

- 20-5 Javaコンポーネント用のcopyConfigスクリプトのオプション

- 20-6 Oracleインスタンスおよびシステム・コンポーネント用のcopyConfigスクリプトのオプション

- 20-7 ノード・マネージャ用のcopyConfigスクリプトのオプション

- 20-8 extractMovePlanスクリプトのオプション

- 20-9 Javaコンポーネント用のpasteConfigスクリプトのオプション

- 20-10 Oracleインスタンス用のpasteConfigスクリプトのオプション

- 20-11 ノード・マネージャ用のpasteConfigスクリプトのオプション

- 20-12 コンポーネントの移動計画のプロパティ

- 20-13 ノード・マネージャの移動計画のプロパティ

- 20-14 Javaコンポーネントの移動計画の共通プロパティ

- 20-15 Oracle ADF接続の移動計画のプロパティ

- 20-16 Oracle SOA Suiteの移動計画のプロパティ

- 20-17 Oracle Business Activity Monitoringに対する移動計画プロパティ

- 20-18 Oracle Service Busに対する移動計画プロパティ

- 20-19 Oracle User Messaging Serviceに対する移動計画プロパティ

- 20-20 Oracle B2Bの移動計画のプロパティ

- 20-21 Oracle HTTP Serverの移動計画のプロパティ

- 20-22 Oracle Internet Directoryの移動計画のプロパティ

- 20-23 Oracle Virtual Directoryの移動計画のプロパティ

- 20-24 Oracle Identity Federationの移動計画のプロパティ

- 20-25 Oracle BI EEおよびOracle BI Publisherの移動計画のプロパティ

- 20-26 Oracle BI EEデータ・ウェアハウス管理コンソール(DAC)の移動計画のプロパティ

- 20-27 Oracle Essbaseの移動計画のプロパティ

- 20-28 EPMレジストリの移動計画のプロパティ

- 20-29 Oracle BI Action Frameworkの移動計画のプロパティ

- 20-30 WebCenter Content Server、RecordsおよびInbound Refineryの移動計画のプロパティ

- 20-31 Oracle WebCenter Content: Imagingの移動計画のプロパティ

- 20-32 Oracle Data Integratorの移動計画のプロパティ

- 20-33 Oracle Access Manager、Oracle Security Token ServiceおよびOracle Identity Connectに対する移動計画プロパティ

- 20-34 Oracle Adaptive Access Manager用の移動計画プロパティ

- A-1 Oracle Fusion Middlewareのコマンドライン・ツール

- B-1 コンポーネントのURL

- C-1 ポート番号(コンポーネント順)

- C-2 ポート番号(番号順)

- D-1 リポジトリ作成ユーティリティで作成されたメタデータ・スキーマ

- D-2 メタデータ・リポジトリの表領域およびデータファイル

- E-1 共通タスクのキーボード・ナビゲーション

- E-2 トポロジ・ビューアのキーボード・ナビゲーション

- F-1 管理上の変更の例

- H-1 ウォレット用のOracle Wallet Manager機能のマッピング

- H-2 証明書用のOracle Wallet Manager機能のマッピング

- H-3 ウォレットおよびCRL用のorapki機能のマッピング

- H-4 証明書用のorapki機能のマッピング

- H-5 SSL構成ツールと同等の機能

Oracle® Fusion Middleware

管理者ガイド

11g リリース1(11.1.1)

B60984-06(原本部品番号:E10105-14)

2013年3月

Oracle Fusion Middlewareの管理方法、たとえば、Oracle Fusion Middlewareの起動および停止方法、コンポーネントの構成方法、環境のバックアップおよびリカバリの方法について説明します。

Oracle Fusion Middleware管理者ガイド, 11g リリース1(11.1.1)

B60984-06

Copyright © 2009, 2013, Oracle and/or its affiliates.All rights reserved.

原本著者:  Helen Grembowicz

原本協力著者:  Vinaye Misra

原本協力者:  Mike Blevins、Nick Fry、Greg Cook、Harry Hsu、Christine Jacobs、Srini Indla、Pavana Jain、Gopal Kirsur、Kenneth Ma、Dan MacKinnon、Manoj Nayak、Mark Nelson、Praveen Sampath、Sunita Sharma

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

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

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

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

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

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

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

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

はじめに

このガイドでは、Oracle Fusion Middlewareの起動および停止方法、ポートの変更およびアプリケーションのデプロイ方法、Oracle Fusion Middlewareのバックアップおよびリカバリ方法など、Oracle Fusion Middlewareの管理方法について説明します。

対象読者

このガイドは、Oracle Fusion Middlewareの管理者を対象としています。

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

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

お客様は、My Oracle Supportを使用して電子サポートにアクセスできます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs (聴覚障害者向け)を参照してください。

関連ドキュメント

詳細は、Oracle Fusion Middleware 11g リリース1(11.1.1)のドキュメント・セットにある次のドキュメントを参照してください。

- 『Oracle Fusion Middleware 2日で管理者ガイド』

- 『Oracle Fusion Middleware概要』

- 『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』

- 『Oracle Fusion Middleware高可用性ガイド』

- 『Oracle Fusion Middleware Oracle WebLogic Serverの紹介』

- 『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』

- 『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』

- 『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』

- 『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』

- 『Oracle Fusion Middleware Oracle Web Cache管理者ガイド』

- 『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』

- 『Oracle Fusion Middleware Oracle Internet Directory管理者ガイド』

- 『Oracle Fusion Middleware Oracle Virtual Directory管理者ガイド』

- 『Oracle Fusion Middleware Oracle Identity Federation管理者ガイド』

- 『Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイド』

表記規則

本文では、次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するグラフィカル・ユーザー・インタフェース要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック

イタリックは、特定の値を指定するプレースホルダ変数を示します。

固定幅

固定幅フォントは、パラグラフ内のコマンド、URL、例に記載されているコード、画面に表示されるテキスト、または入力するテキストを示します。

このガイドの最新情報

ここでは、このガイドで説明するOracle Fusion Middlewareの新しい管理機能と変更された管理機能について説明し、追加情報の参照先を示します。

Oracle Fusion Middleware 11g リリース1(11.1.1.7)の新機能と変更機能

Oracle Fusion Middleware 11g リリース1(11.1.1.7)には、次の新しい管理機能と変更された管理機能が含まれます。

- カスタム診断ルールの追加。第13.3.2項を参照してください。

- 指定された間隔で診断ダンプの出力を取得する、診断ダンプ・サンプリングの追加。第13.4.5項を参照してください。

- 特に、次のコンポーネントにおけるテスト環境から本番環境への移行手順の改訂。

- Oracle BAM。第21.4.2.1項、作業6を参照してください。

- Oracle User Messaging Service。第21.4.2.1項、作業8を参照してください。

- Oracle Service Bus。第21.4.2.1項、作業9を参照してください。

- オペレーティング・システムが64ビットの場合に移行スクリプトによりそのことが検出され、コマンドラインでスクリプトに-d64オプションが渡されます。

- copyConfigスクリプトで、additionalParameter引数の使用がサポートされます。第20.2.1.3項を参照してください。

第I部

Oracle Fusion Middlewareの概要

この部では、Oracle Fusion Middlewareの概要、およびOracle Fusion Middlewareの管理と関連する概念について説明します。

第I部は、次の章で構成されています。

- 第1章「Oracle Fusion Middlewareの概要」

- 第2章「Oracle Fusion Middlewareの概念の概要」

1 Oracle Fusion Middlewareの概要

Oracle Fusion Middlewareは、アプリケーション開発ツールや統合ソリューションから、ID管理、コラボレーションおよびビジネス・インテリジェンス・レポートに至るまでの幅広い製品群を含む包括的なファミリです。この章では、Oracle Fusion Middlewareの概要について説明します。

次の項目が含まれます。

- Oracle Fusion Middlewareとは

- Oracle Fusion Middlewareコンポーネント

1.1 Oracle Fusion Middlewareとは

Oracle Fusion Middlewareは、標準ベースのソフトウェア製品の集合であり、その範囲は、Java EEや開発者向けツールから、統合サービス、アイデンティティ管理、ビジネス・インテリジェンスおよびコラボレーションといったツールやサービスにまで及びます。Oracle Fusion Middlewareは、開発、デプロイおよび管理において完全なサポートを提供します。

1.2 Oracle Fusion Middlewareコンポーネント

Oracle Fusion Middlewareには、次のようなコンポーネントが用意されています。

- Oracle WebLogic Serverは、エンタープライズ対応のJavaアプリケーション・サーバーです。堅牢、セキュア、高可用でスケーラブルな環境におけるミッション・クリティカルなアプリケーションのデプロイメントをサポートします。Oracle WebLogic Serverは、サービス指向アーキテクチャ(SOA)に基づいたアプリケーションを構築する上で理想的な基盤です。

関連項目:

『Oracle Fusion Middleware Oracle WebLogic Serverの紹介』

- Oracle SOA Suiteは、コンポジット・アプリケーションの設計、デプロイおよび管理用のサービス指向アーキテクチャのサービス・インフラストラクチャ・コンポーネントの完全なセットです。Oracle SOA Suiteにより、サービスの作成と管理を行って、複合アプリケーションとビジネス・プロセスに編成できます。コンポジットにより、複数のテクノロジ・コンポーネントを1つのSOAコンポジット・アプリケーションに容易にアセンブルできます。

関連項目:

『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』

- Oracle WebCenter Portalは、標準ベースのサービス指向アーキテクチャで構築された、ソーシャル・アプリケーション、エンタープライズ・ポータル、コラボレート・コミュニティ、コンポジット・アプリケーションを作成できるコンポーネントの統合セットです。Oracle WebCenter Portalでは、高度なインターネット・アプリケーションを開発するための動的なユーザー・インタフェース・テクノロジ、統合されたマルチチャネル・ポータル・フレームワークの柔軟性および機能、コンテンツ、コラボレーション、プレゼンス、およびソーシャル・ネットワーク機能を提供するサービスとして配信される水平的なEnterprise 2.0の機能のセットを組み合せています。これらのコンポーネントに基づいて、Oracle WebCenter Portalは追加設定が不要な、エンタープライズ対応のカスタマイズ可能なアプリケーションであるWebCenter Portal: Spacesを、個人およびグループがさらに効率的に作業および協力できる構成可能な作業環境とともに提供します。

関連項目:

『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』

- Oracle WebCenter Contentは、コンテンツの管理のために設計された製品の統合スイートです。このエンタープライズ・コンテンツ管理プラットフォームにより、業界最先端のドキュメント管理、Webコンテンツ管理、デジタル資産管理およびレコード管理機能を利用して、ビジネス・アプリケーションを構築できます。コンテンツおよびアプリケーションの戦略的なエンタープライズ・コンテンツ管理インフラストラクチャを構築すると、コストの削減、エンタープライズ間のコンテンツ共有の容易化、リスクの最小化、高価で時間のかかる手動プロセスの自動化、および複数のWebサイトにおける単一プラットフォームへの統合化を促進します。

関連項目:

Oracle WebCenter Content Content Serverシステム管理者ガイド

- Oracle HTTP Serverは、Java EEアプリケーション用Webリスナー、またWeb上の静的および動的なページやアプリケーションをホスティングするフレームワークを提供します。Apache HTTPサーバーの実績あるテクノロジに基づき、Oracle HTTPサーバーには、ロード・バランシング、管理および構成を容易にする重要な拡張が含まれます。

関連項目:

『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』

- Oracle Web Cacheは、コンテンツ対応のサーバー・アクセラレータ(リバース・プロキシ)で、Oracle Fusion Middleware上で稼働するWebサイトのパフォーマンス、スケーラビリティおよび可用性を向上させます。

関連項目:

『Oracle Fusion Middleware Oracle Web Cache管理者ガイド』

- Oracle Identity Managementは、すべてのOracleアプリケーションに共有インフラストラクチャを提供します。また、サード・パーティによるエンタープライズ・アプリケーション開発を容易にするサービスやインタフェースも提供します。これらのインタフェースは、アプリケーションにID管理を組み込む必要のあるアプリケーション開発者にとって有用です。

関連項目:

Oracle Fusion Middleware Oracle Identity Management Suite統合の概要

- Oracle Internet Directoryは、分散するユーザーおよびネットワーク・リソースに関する情報の迅速な取得と一元管理を可能にする汎用ディレクトリ・サービスです。これは、Lightweight Directory Access Protocol(LDAP)バージョン3とOracle Databaseの高度なパフォーマンス、スケーラビリティ、堅牢性、可用性を組み合せています。

関連項目:

『Oracle Fusion Middleware Oracle Internet Directory管理者ガイド』

- Oracle Virtual Directoryは、1つ以上のエンタープライズ・データソースを単一のディレクトリに仮想化して抽象的に表示するLDAPバージョン3対応のサービスです。Oracle Virtual Directoryでは、インフラストラクチャまたはアプリケーションを変更することなく、またはその必要性を最小限に抑えながら、LDAP対応のアプリケーションを様々なディレクトリ環境に統合できます。これは、Webアプリケーションやポータルなど、クライアントの様々なセットをサポートして、ディレクトリ、データベース、Webサービスに接続できます。

関連項目:

『Oracle Fusion Middleware Oracle Virtual Directory管理者ガイド』

- Oracle Identity Federationは、IDとそれに関する資格情報をセキュリティ・ドメイン間で伝播できるインフラストラクチャを提供する自己完結型フェデレーション・ソリューションです。これは、組織内および組織間に存在するドメインに適用されます。

関連項目:

『Oracle Fusion Middleware Oracle Identity Federation管理者ガイド』

- Oracle Access Managerは、Webシングル・サインオン、認証と認可、ポリシー管理、監査など、全面的なWeb周辺のセキュリティ機能を提供します。シングル・サインオン(SSO)は、ユーザーやユーザーのグループが、認証後に複数のアプリケーションにアクセスできるようにします。SSOにより、サインオンを何度も要求されるということがなくなります。Oracle Access Managerは、Oracle Fusion Middlewareのシングル・サインオン・ソリューションです。

- Oracle Web Services Managerは、アクセス制御(認証と認可)、信頼できるメッセージング、メッセージ送信の最適化メカニズム(MTOM)、WSアドレス、Webサービス管理など、Webサービスの各操作を管理するポリシーを集中的に定義および管理する方法を提供します。ポリシーは、複数のWebサービスに添付できるため、既存のWebサービスへの変更が不要になります。

関連項目:

『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』

- Oracle Platform Securityは、エンタープライズ製品開発チーム、システム・インテグレータおよび独立ソフトウェア・ベンダー(ISV)に、Java Standard Edition(Java SE)およびJava Enterprise Edition(Java EE)アプリケーションに対して、標準ベースでポータブルなエンタープライズ級統合セキュリティ・フレームワークを提供します。
Oracle Platform Securityは、セキュリティおよびID管理の実装の煩雑さから開発者を解放する、標準ベースのアプリケーション・プログラミング・インタフェース(API)形式の抽象化レイヤーを提供します。Oracle Platform Securityにより、開発者は暗号化鍵管理、ユーザー・リポジトリのインタフェース、またはその他のID管理インフラストラクチャの詳細を認識する必要はなくなります。Oracle Platform Securityを使用する場合、社内開発アプリケーション、サード・パーティのアプリケーションおよび統合されたアプリケーションは、エンタープライズ間で同じ均一セキュリティ、ID管理および監査サービスから恩恵を受けます。

関連項目:

『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』

- Oracle Portalは、E-Businessポータルの構築とデプロイを目的としたWebベースのツールです。これにより、エンタープライズ・ソフトウェア・サービスや情報リソースへのアクセス、および対話を目的としたセキュアで管理可能な環境が実現します。ポータル・ページは、複数ソースからのデータを単一ロケーションからアクセス可能にします。

関連項目:

『Oracle Fusion Middleware Oracle Portal管理者ガイド』

- Oracle Business Intelligenceは、ビジネス・インテリジェンス要件に対応する完全な統合ソリューションです。Oracle Business Intelligenceには、Oracle BI Enterprise Edition、Oracle Business Intelligence DiscovererおよびOracle Business Intelligence Publisher、およびOracle Real-Time Decisionsが含まれます。

関連項目:

Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド

注意:

Oracle Fusion MiddlewareをIBM WebSphereとともに使用できます。詳細は、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドを参照してください。

2 Oracle Fusion Middlewareの概念の概要

この章では、Middlewareホーム、Oracleホーム、メタデータ・リポジトリなど、Oracle Fusion Middlewareの管理に関する概念について説明します。

- Oracle Fusion Middlewareの主要概念の概要

- Oracle WebLogic Serverドメインとは

- Oracleインスタンスとは

- Middlewareホームとは

- WebLogic Serverホームとは

- OracleホームおよびOracle共通ホームとは

- Oracleメタデータ・リポジトリとは

2.1 Oracle Fusion Middlewareの主要概念の概要

Oracle Fusion Middlewareでは、2種類のコンポーネントが用意されています。

- Javaコンポーネント。これは、1つ以上のJava EEアプリケーションおよびリソースのセットとしてデプロイされるOracle Fusion Middlewareコンポーネントです。Javaコンポーネントは、Oracle WebLogic Serverドメインにドメイン・テンプレートの一部としてデプロイされます。Javaコンポーネントの例としては、Oracle SOA Suite、Oracle WebCenter Portal、Oracle WebCenter Contentコンポーネントなどがあります。

- システム・コンポーネント。Javaアプリケーションとしてデプロイされない管理可能なプロセスです。システム・コンポーネントは、Oracle Process Manager and Notification(OPMN)で管理されます。システム・コンポーネントには、次が含まれます。

- Oracle HTTP Server

- Oracle Web Cache

- Oracle Internet Directory

- Oracle Virtual Directory

- Oracle Forms Services

- Oracle Reports

- Oracle Business Intelligence Discoverer

- Oracle Business Intelligence

Javaコンポーネントとシステム・コンポーネントはピアです。

Oracle Fusion Middlewareをインストールして構成すると、Oracle Fusion Middleware環境には、次が含まれます。

- Oracle WebLogic Serverドメイン。1つの管理サーバーと1つまたは複数の管理対象サーバーが含まれます。管理サーバーには、Oracle WebLogic Server管理コンソールとFusion Middleware Controlが含まれます。管理対象サーバーには、Oracle WebCenter Portal、Oracle SOA Suiteなどのコンポーネントが含まれます。
Oracle WebLogic Serverドメインの詳細は、第2.2項を参照してください。

- 1つ以上のOracleインスタンス。環境にシステム・コンポーネントが含まれる場合。Oracleインスタンスの詳細は、第2.3項を参照してください。

- メタデータ・リポジトリとして使用されるデータベース。インストールしたコンポーネントで必要とされる場合。たとえば、Oracle SOA Suiteにはメタデータ・リポジトリが必要です。メタデータ・リポジトリの詳細は、第2.7項を参照してください。

図2-1に、Oracle Fusion Middleware環境を示します。この環境のOracle WebLogic Serverドメインには、1つの管理サーバー、2つの管理対象サーバーおよび1つのOracleインスタンスが含まれます。この環境にはメタデータ・リポジトリも含まれます。

図2-1 Oracle Fusion Middleware環境

「図2-1 Oracle Fusion Middleware環境」の説明

また、環境にはMiddlewareホームも含まれます。これは、Oracle WebLogic Serverホーム、および必要に応じてOracle共通ホームと1つ以上のOracleホームで構成されます。詳細は、第2.4項を参照してください。

注意:

Oracle Fusion MiddlewareをIBM WebSphereとともに使用できます。詳細は、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドを参照してください。

2.2 Oracle WebLogic Serverドメインとは

Oracle WebLogic Server管理ドメインは、論理的に関連付けられたJavaコンポーネントのグループです。ドメインには、管理サーバーと呼ばれる特別なWebLogic Serverインスタンスが含まれます。これは、ドメインのすべてのリソースを構成して管理する中核部分です。通常、管理対象サーバーと呼ばれるWebLogic Serverの追加インスタンスを含めて、ドメインを構成します。Webアプリケーション、EJB、Webサービスやその他のリソースなどのJavaコンポーネントを管理対象サーバーにデプロイし、構成および管理の目的にのみ管理サーバーを使用します。

ドメインの管理対象サーバーは、クラスタへのグループ化が可能です。

ドメインのディレクトリ構造は、WebLogic Serverホームのディレクトリ構造とは異なります。これは、どこにでも配置できます。Middlewareホームのディレクトリ内に配置する必要はありません。ドメインの最上位ディレクトリは、ドメイン・ホームと呼ばれます。

ドメインはOracleインスタンスのピアです。両方には、Oracleホームの外部にある特定の構成が格納されます。

図2-2に、1つの管理サーバー、3つのスタンドアロンの管理対象サーバー、およびクラスタ内に3つの管理対象サーバーが配置されているドメインを示します。

図2-2 Oracle WebLogic Serverドメイン

「図2-2 Oracle WebLogic Serverドメイン」の説明

関連項目:

ドメイン構成の詳細は、Oracle Fusion Middleware Oracle WebLogic Serverドメイン構成の理解を参照してください。

次の項では、ドメインのエンティティについて説明します。

- 管理サーバーとは

- 管理対象サーバーおよび管理対象サーバー・クラスタの理解

- ノード・マネージャとは

2.2.1 管理サーバーとは

管理サーバーは、ドメイン全体の構成に対して中央制御エンティティとして機能します。ドメインの構成ドキュメントを保持し、構成ドキュメント内の変更を管理対象サーバーに配布します。管理サーバーは、ドメイン内のすべてのリソースを管理および監視する中央の場所として機能します。

各ドメインには、管理サーバーとして機能する1つのサーバー・インスタンスが必要です。

管理サーバーと対話するには、Oracle WebLogic Server管理コンソールやOracle WebLogic Scripting Tool(WLST)を使用するか、独自のJMXクライアントを作成します。さらに、一部のタスクには、Fusion Middleware Controlを使用できます。

Oracle WebLogic Server管理コンソールおよびFusion Middleware Controlは、管理サーバーで動作します。Oracle WebLogic Server管理コンソールは、管理サーバーや管理対象サーバーなど、Oracle WebLogic Serverドメインのリソース管理に使用するWebベースの管理コンソールです。Fusion Middleware Controlは、Oracle HTTP Server、Oracle SOA Suite、Oracle WebCenter Portal、Oracle Portal、Oracle Identity Managementなどのコンポーネントを含めて、Oracle Fusion Middlewareの管理に使用するWebベースの管理コンソールです。

関連項目:

- Fusion Middleware Controlの詳細は、第3.3項を参照してください。

- Oracle WebLogic Server管理コンソールの詳細は、このマニュアルの第3.4項、『Oracle Fusion Middleware Oracle WebLogic Serverの紹介』およびOracle WebLogic Server管理コンソールのオンライン・ヘルプを参照してください。

2.2.2 管理対象サーバーおよび管理対象サーバー・クラスタの概要

管理対象サーバーは、ビジネス・アプリケーション、アプリケーション・コンポーネント、Webサービスおよびそれらに関連付けられたリソースをホストします。パフォーマンスを最適化するために、管理対象サーバーは、ドメインの構成ドキュメントの読取り専用コピーを保持しています。管理対象サーバーは、起動時にドメインの管理サーバーに接続し、その構成ドキュメントを管理サーバーが保持するドキュメントに同期します。

ドメインを作成する場合、特定のドメイン・テンプレートを使用します。そのテンプレートは、Oracle SOA Suiteのような特定のコンポーネントまたはコンポーネントのグループをサポートします。ドメイン内の管理対象サーバーは、これらの特定のOracle Fusion Middlewareコンポーネントをホストするために作成されます。

Oracle Fusion MiddlewareのJavaコンポーネント(Oracle SOA Suite、Oracle WebCenter Portal、一部のIdentity Managementコンポーネントなど)、および顧客が開発したアプリケーションがドメイン内の管理対象サーバーにデプロイされます。

別のコンポーネントをサポートするテンプレートを使用して作成されたドメインに、Oracle WebCenter Portalなどの他のコンポーネントを追加する場合、ドメイン内に追加の管理対象サーバーを作成し、追加するコンポーネントのドメイン・テンプレートを使用してそのドメインを拡張できます。詳細は第19.2項を参照してください。

アプリケーション・パフォーマンスとスループットの向上、または高可用性が求められる本番環境では、2つ以上の管理対象サーバーを構成し、クラスタとして機能させることができます。クラスタとは、スケーラビリティや信頼性を向上させるために同時に稼働および連携する、複数のWebLogic Serverインスタンスの集合です。クラスタ内では、ほとんどのリソースおよびサービスは(単一の管理対象サーバーとは対照的に)、各管理対象サーバーに同様にデプロイされ、フェイルオーバーやロード・バランシングを有効化します。1つのドメインには、複数のOracle WebLogic Serverクラスタや、クラスタとして構成されていない複数の管理対象サーバーを配置できます。管理対象サーバーのクラスタ化と非クラスタ化の重要な違いは、フェイルオーバーおよびロード・バランシングのサポートにあります。これらの機能は、管理対象サーバーのクラスタ内でのみ使用可能です。

関連項目:

『Oracle Fusion Middleware Oracle WebLogic Serverクラスタの使用』のWebLogic Serverクラスタリングの理解に関する項

2.2.3 ノード・マネージャとは

ノード・マネージャは、Oracle WebLogic Serverと別個のプロセスとして実行されるJavaユーティリティです。これにより、管理サーバーとの位置関係にかかわらず、管理対象サーバーの一般的な操作を実行できます。ノード・マネージャの使用はオプションですが、Oracle WebLogic Server環境で高可用性が必要なアプリケーションをホストする場合、メリットがあります。

管理対象サーバーをホストするコンピュータでノード・マネージャを実行する場合には、管理コンソール、Fusion Middleware Controlコンソールまたはコマンドラインを使用して、管理対象サーバーをリモートで起動および停止できます。ノード・マネージャを使用して、予期しない障害が発生した後に、管理対象サーバーを自動的に再起動することもできます。

関連項目:

『Oracle Fusion Middleware Oracle WebLogic Serverノード・マネージャ管理者ガイド』

2.3 Oracleインスタンスとは

Oracleインスタンスには、Oracle Web Cache、Oracle HTTP Server、Oracle Internet Directoryなど、1つまたは複数のシステム・コンポーネントが含まれます。Oracleインスタンスのシステム・コンポーネントは、同じコンピュータ内に存在する必要があります。Oracleインスタンスのディレクトリには、構成ファイル、ログ・ファイル、一時ファイルなど、更新可能なファイルが配置されます。

Oracleインスタンスは、Oracle WebLogic Serverドメインのピアです。両方には、Oracleホームの外部にある特定の構成が格納されます。

Oracleインスタンスのディレクトリ構造は、Oracleホームのディレクトリ構造とは異なります。これは、どこにでも配置できます。Middlewareホームのディレクトリ内に配置する必要はありません。

2.4 Middlewareホームとは

Middlewareホームは、Oracle WebLogic Serverホーム、および必要に応じてOracle共通ホームと1つ以上のOracleホームのコンテナです。

Middlewareホームは、ローカル・ファイル・システム上、またはNFS経由でアクセスできるリモート共有ディスク上に配置できます。

Oracle WebLogic Serverホームの詳細は、第2.5項を参照してください。Oracleホームの詳細は、第2.6項を参照してください。

2.5 WebLogic Serverホームとは

WebLogic Serverホームには、WebLogic Serverをホストするために必要なインストール済ファイルが含まれます。WebLogic Serverホームのディレクトリは、Oracleホームのディレクトリのピアであり、Middlewareホームのディレクトリ構造の中に存在します。

2.6 OracleホームおよびOracle共通ホームとは

Oracleホームには、特定のコンポーネントまたはソフトウェア・スイートをホストするために必要なインストール済ファイルが含まれます。たとえば、SOA Oracleホームには、Oracle SOA Suiteのバイナリとライブラリ・ファイルを含むディレクトリが配置されます。

Oracleホームは、Middlewareホームのディレクトリ構造内にあります。各Oracleホームは、複数のOracleインスタンスまたはOracle WebLogic Serverドメインと関連付けることができます。各Middlewareホームに複数のOracleホームを配置できます。

Oracle共通ホームには、Fusion Middleware ControlおよびJava Required Files(JRF)に必要なバイナリおよびライブラリ・ファイルが含まれます。各Middlewareホームには、Oracle共通ホームは1つのみ配置できます。

2.7 Oracleメタデータ・リポジトリとは

Oracleメタデータ・リポジトリには、Oracle BPEL Process Manager、Oracle B2BおよびOracle PortalなどのOracle Fusion Middlewareコンポーネントのメタデータが格納されます。また、Oracle Fusion Middlewareの構成に関するメタデータおよびアプリケーションのメタデータも格納できます。

メタデータ・リポジトリは、データベース・ベースにも、ファイルベースにもできます。データベース・ベースの場合、リポジトリ作成ユーティリティ(RCU)を使用して既存のデータベースにメタデータ・リポジトリを作成できます。

Oracle Fusion Middlewareでは、複数のリポジトリ・タイプがサポートされています。リポジトリ・タイプは特定のOracle Fusion Middlewareコンポーネント(Oracle SOA Suite、Oracle Internet Directoryなど)に属する個別または一連のスキーマを示します。

特殊なタイプのリポジトリであるOracle Metadata Services(MDS)リポジトリには、Oracle B2Bや特定のタイプのアプリケーションなど、ほとんどのOracle Fusion Middlewareコンポーネントのメタデータが格納されます。

関連項目:

メタデータ・リポジトリの詳細は、第14章を参照してください。

第II部

基本的な管理

この部では、Oracle Fusion Middlewareの基本的な管理タスクについて説明します。

第II部は、次の章で構成されています。

- 第3章「Oracle Fusion Middlewareの管理の概要」

- 第4章「Oracle Fusion Middlewareの起動と停止」

- 第5章「ポートの管理」

3 Oracle Fusion Middlewareの管理の概要

Oracle Fusion Middlewareをインストールする場合、実行可能ファイル、jarファイル、ライブラリなどのバイナリ・ファイルをインストールします。次に、構成ツールを使用してソフトウェアを構成します。この章では、Oracle Fusion Middlewareの管理を開始する際に、使用するツールなどの必要な情報について説明します。

この章の項目は次のとおりです。

- 環境変数の設定

- Oracle Fusion Middlewareの管理ツールの概要

- Oracle Enterprise Manager Fusion Middleware Controlの使用の概要

- Oracle WebLogic Server管理コンソールの概要

- コマンドライン・ツールの使用の概要

- Fusion Middleware Control MBeanブラウザの使用の概要

- コンポーネントの管理

- 管理ユーザーのパスワードの変更

- Oracle Fusion Middlewareの構成および管理の基本的なタスク

3.1 環境変数の設定

インストール作業を行った担当者は、Oracle Fusion Middlewareのインストール時に特定のユーザーとしてオペレーティング・システムにログインしていました。このユーザーがインストールのOracleホームにあるファイルを表示および変更する権限を持つため、インストールを管理するには、常にこのユーザーとしてログインする必要があります。

Oracle Fusion Middlewareを使用するには、次の表に示すように、環境変数を設定する必要があります。

- 表3-1「環境変数(LinuxおよびUNIX用)」

- 表3-2「環境変数(Windows用)」

表3-1 環境変数(LinuxおよびUNIX用)

環境変数

値

DISPLAY

hostname:display_number.screen_number

DISPLAY変数が必要なのは、oidadminなどのごくわずかなツールのみです。

LD_LIBRARY_PATH

Solarisの場合は、この値に次のディレクトリが含まれていることを確認します。

$ORACLE_HOME/lib32

LinuxおよびHP-UXの場合は、この値に次のディレクトリが含まれていることを確認します。

$ORACLE_HOME/lib

IBM AIXの場合は、この環境変数の設定がないことを確認します。

(IBM AIXのみ)
LIBPATH

コール元のアプリケーションが32ビット・アプリケーションの場合は、この値に次のディレクトリが含まれていることを確認します。

$ORACLE_HOME/lib32

コール元のアプリケーションが64ビット・アプリケーションの場合は、この値に次のディレクトリが含まれていることを確認します。

$ORACLE_HOME/lib

(Solarisのみ)
LD_LIBRARY_PATH_64

この値に次のディレクトリが含まれていることを確認します。

$ORACLE_HOME/lib

(HP-UXのみ)
SHLIB_PATH

この値に次のディレクトリが含まれていることを確認します。

$ORACLE_HOME/lib32

MW_HOME

インストールのMiddlewareホームのフルパスに値を設定します。定義の最後にスラッシュを使用しないでください。フルパス例を次に示します。

/scratch/Oracle/Middleware

ORACLE_HOME

1つのOracleホームのみで作業している場合、これを設定すると便利です。Oracleホームのフルパスに設定します。定義の最後にスラッシュを使用しないでください。フルパス例を次に示します。

/scratch/Oracle/Middleware/ORACLE_HOME_SOA1

ORACLE_INSTANCE

オプション。環境内にOracleインスタンスが1つしかなく、その1つのインスタンスのみで作業をしている場合に、これを設定すると便利です。Oracleインスタンスのフルパスに設定します。定義の最後にスラッシュを使用しないでください。Web層インストールのフルパス例を次に示します。

/scratch/Oracle/Middleware/WebTier/instances/instance1

PATH

この値に次のディレクトリが含まれていることを確認します。このディレクトリには、すべてのインストールで使用される基本的なコマンドがあります。

$ORACLE_COMMON_HOME/bin
$ORACLE_COMMON_HOME/common/bin

特定のコンポーネントで作業を開始するときは、コンポーネントのドキュメントで推奨されているように、必要に応じてさらにディレクトリを追加します。

JAVA_HOME

この値に次のディレクトリが含まれていることを確認します。

MW_HOME/jdkn

CLASSPATH

この値に次のディレクトリが含まれていることを確認します。

$ORACLE_HOME/lib:MW_HOME/jdkn/lib

表3-2に、Windowsの環境変数を示します。

表3-2 環境変数(Windows用)

環境変数

値

MW_HOME

インストールのMiddlewareホームのフルパスに値を設定します。定義の最後にバックスラッシュを使用しないでください。フルパス例を次に示します。

C:\oracle\Middleware

ORACLE_HOME

1つのOracleホームのみで作業している場合、これを設定すると便利です。この値をOracleホームのフルパスに設定します。定義の最後にバックスラッシュを使用しないでください。フルパス例を次に示します。

C:\oracle\Middleware\ORACLE_SOA1

ORACLE_INSTANCE

オプション。環境内にOracleインスタンスが1つしかなく、その1つのインスタンスのみで作業をしている場合に、これを設定すると便利です。この値をOracleインスタンスのフルパスに設定します。定義の最後にバックスラッシュを使用しないでください。Web層インストールのフルパス例を次に示します。

C:\oracle\Middleware\WebTier\instances\instance1

PATH

この値に次のディレクトリが含まれていることを確認します。このディレクトリには、すべてのインストールで使用される基本的なコマンドがあります。

ORACLE_COMMON_HOME\bin
ORACLE_COMMON_HOME\common\bin

JAVA_HOME

この値に次のディレクトリが含まれていることを確認します。

MW_HOME\jdkn

CLASSPATH

この値に次のディレクトリが含まれていることを確認します。

ORACLE_HOME\lib:MW_HOME\jdkn\lib

TEMP

値を一時ディレクトリに設定します(例、C:\temp)。

TMP

値を一時ディレクトリに設定します(例、C:\temp)。

UNIXホストに複数のインストールがある場合の最適な設定例

UNIXホストにOracle Fusion Middlewareの複数のインストールがある場合は、特定のインストールの管理を開始するときに、環境を完全に設定することが重要です。

一部のOracle Fusion Middlewareコマンドは、MW_HOMEおよびORACLE_HOME環境変数を使用して、操作対象のインストールを決定します。また、一部のコマンドは、そのコマンドのあるディレクトリを使用します。そのため、複数のインストール間を移動するときは、そのユーザーの環境変数を再設定したり、ディレクトリを変更して別のOracleホームに移動するだけでは不十分です。次の手順に従って、新しいインストールに完全に変更する必要があります。

1. Oracle Fusion Middlewareをインストールしたユーザーとしてログインします。
UNIXホストでは、suコマンドを使用して目的のユーザーに切り替えることもできますが、実際にそのユーザーとしてログインしたときと同じ環境に設定されるようにダッシュ(-)オプションを必ず使用する必要があります。次に例を示します。

su - user

2. 表3-1の説明に従って、操作対象のインストールに適した環境変数を設定します。

3. 操作対象のインストールのMiddlewareホームおよびOracleホームでコマンドを実行します。

同じユーザーによる複数インストール 同じユーザーで複数インストールしている場合は、特定のインストールで作業するときに、正しいMiddlewareホームおよびOracleホームに移動し、正しい環境変数を設定していることを確認してください。スクリプトを設定して、インストール間を簡単に変更できるようにすると便利です。

3.2 Oracle Fusion Middlewareの管理ツールの概要

Oracle Fusion Middlewareをインストールして構成すると、グラフィカル・ユーザー・インタフェースまたはコマンドライン・ツールを使用して、環境を管理できるようになります。

Oracle Fusion Middlewareインストールを管理するために、次の主要なツールが用意されています。

- Oracle Enterprise Manager Fusion Middleware Control。第3.3項を参照してください。

- Oracle WebLogic Server管理コンソール。第3.4項を参照してください。

- Oracle Fusion Middlewareのコマンドライン・ツール。第3.5項を参照してください。

- Fusion Middleware Control MBeanブラウザ。第3.6項を参照してください。

特にファイルの編集を必要とする手順がないかぎり、すべての管理タスクを実行する際には、構成ファイルを直接編集するより、これらのツールを使用してください。ファイルを編集すると、設定に不整合が生じて問題が発生する場合があります。

注意:

IBM WebSphereの管理ツールの使用の詳細は、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドのIBM WebSphereでのOracle Fusion Middleware管理ツールのサマリーに関する項を参照してください。

Fusion Middleware ControlもOracle WebLogic Server管理コンソールもグラフィカル・ユーザー・インタフェースであり、これらを使用してOracle Fusion Middleware環境を監視および管理できます。Fusion Middleware Controlおよび管理コンソールは、ほとんどのFusion Middlewareコンポーネントのインストール時にインストールできます。

次の点に注意してください。

- スタンドアロンのOracle WebLogic Serverをインストールする場合は、Fusion Middleware Controlはインストールされません。管理コンソールのみがインストールされます。

- Oracle JDeveloperをインストールする場合は、Fusion Middleware Controlも管理コンソールもインストールされません。これらは、Oracle Fusion Middleware Application Developerのインストール時にインストールできます。

一部のタスクではどちらのツールを使用しても実行できますが、いずれか一方のツールしか使用できないタスクもあります。表3-3は、一般的なタスクとその推奨ツールの一覧です。

表3-3 Fusion Middleware ControlとWebLogic Server管理コンソールの比較

タスク

使用するツール

Oracle WebLogic Serverの管理

使用:

追加管理対象サーバーの作成

WebLogic Server管理コンソール

管理対象サーバーのクローニング

WebLogic Server管理コンソール

管理対象サーバーのクラスタ化

WebLogic Server管理コンソール

Oracle WebLogic Serverの起動と停止

Fusion Middleware ControlまたはWebLogic Server管理コンソール

ユーザーおよびグループの追加

WebLogic Server管理コンソール(デフォルトの組込みのLDAPを使用する場合)。別のLDAPサーバーを使用する場合はそのLDAPサーバーのツールを使用します。

データソースの管理

使用:

データソースの作成

WebLogic Server管理コンソール

接続プールの作成

WebLogic Server管理コンソール

JMSリソースの管理

使用:

JMSキューの作成

WebLogic Server管理コンソール

アドバンスト・キューイングの構成

WebLogic Server管理コンソール

SOA環境の管理

使用:

SOAコンポジット・アプリケーションのデプロイ

Fusion Middleware Control

SOAコンポジット・アプリケーションの監視

Fusion Middleware Control

Oracle BPEL Process ManagerのMBeanプロパティの変更

Fusion Middleware Control

Oracle BPEL Process Managerアプリケーションなどのデバッグ・アプリケーション

Fusion Middleware Control

ADFアプリケーション

使用:

ADFアプリケーションのデプロイ

Fusion Middleware Control

Java EEアプリケーション

使用:

Java EEアプリケーションのデプロイ

WebLogic Server管理コンソールまたはFusion Middleware Control

セキュリティ

使用:

監査の構成および管理

Fusion Middleware Control

SSLの構成

WebLogic Server管理コンソール(Oracle WebLogic Server)

Fusion Middleware Control(Javaコンポーネントおよびシステム・コンポーネント)。第6章を参照してください。

パスワードの変更

WebLogic Server管理コンソール

コンポーネントの管理

使用:

ログ・ファイルの表示および管理

Fusion Middleware Control(ほとんどのログ・ファイル)

次のログに対しては、WebLogic Server管理コンソール

DOMAIN_HOME/servers/server_name/logs/access.log
DOMAIN_HOME/servers/server_name/data/ldap/log/EmbeddedLDAP.log
DOMAIN_HOME/servers/server_name/data/ldap/log/EmbeddedLDAPAccess.log

ポートの変更

WebLogic Server管理コンソール(Oracle WebLogic ServerおよびJavaコンポーネント)

一部のシステム・コンポーネントに対しては、Fusion Middleware Control。コンポーネントの詳細は、管理ガイドを参照してください。

Oracle HTTP Serverの管理

Fusion Middleware Control

Oracle Web Cacheの管理

Fusion Middleware Control

コンポーネントの起動と停止

Fusion Middleware Control

アプリケーションの起動と停止

Fusion Middleware Control

3.3 Oracle Enterprise Manager Fusion Middleware Controlの使用の概要

Fusion Middleware Controlは、ファームの監視および管理に使用できるWebブラウザベースのグラフィカル・ユーザー・インタフェースです。

ファームは、Fusion Middleware Controlが管理するコンポーネントの集合です。これには、1つのOracle WebLogic Serverドメイン、1つの管理サーバー、1つ以上の管理対象サーバー、複数のクラスタ、1つ以上のOracleインスタンス、およびドメインまたはOracleインスタンスにインストールされ、構成され、実行されているOracle Fusion Middlewareコンポーネントを含めることができます。

Fusion Middleware Controlでは、豊富な種類のパフォーマンス・データと管理機能が、ファーム、ドメイン、サーバー、コンポーネントおよびアプリケーションのWebベースの個別ホーム・ページとして編成されます。Fusion Middleware Controlホーム・ページを使用すると、最も重要な監視データと最もよく使用される管理機能のすべてに、Webブラウザから容易にアクセスできます。

この項で説明する項目は、次のとおりです。

- Fusion Middleware Controlの表示

- Fusion Middleware Controlヘルプの使用

- Fusion Middleware Controlでのナビゲート

- Fusion Middleware Controlのユーザーおよびロールの概要

- ファームの表示と管理

- コンポーネントの表示と管理

- アプリケーションのステータスの表示

3.3.1 Fusion Middleware Controlの表示

Fusion Middleware Controlを表示するには、Fusion Middleware ControlのURLを入力します。このURLには、インストール時に割り当てられたホスト名と管理ポート番号が含まれます。このURLの形式は次のとおりです。

http://hostname.domain:port/em

ポート番号は管理サーバーのポート番号です。デフォルトのポート番号は、7001です。ポート番号は、次のファイルにリストされています。

DOMAIN_HOME/config/config.xml

SOAやWeb層などの一部のインストール・タイプでは、最後のインストール画面で「保存」をクリックしてインストール情報を保存した場合、Fusion Middleware ControlのURLはディスクに書き込まれたファイルの中に含まれます(デフォルトではホーム・ディレクトリ)。その他のインストール・タイプの場合、構成が完了すると構成ウィザードの「ドメインの作成」画面に情報が表示されます。

Fusion Middleware Controlを表示する手順は次のとおりです。

1. WebブラウザにURLを入力します。次に例を示します。

http://host1.example.com:7001/em

次に、ログイン・ページを示します。

図welcome.gifの説明

2. Oracle Fusion Middleware管理ユーザー名とパスワードを入力して「ログイン」をクリックします。
管理ユーザーのデフォルト・ユーザー名は、weblogicです。これは、Fusion Middleware Controlに初回ログインするときに使用できるアカウントです。パスワードは、Oracle Fusion Middlewareのインストール時に指定したものです。

3.3.2 Fusion Middleware Controlヘルプの使用

Fusion Middleware Controlコンソールの使用中であれば、いつでもページの一番上にある「ヘルプ」をクリックして、詳細を参照できます。ほとんどの場合、「ヘルプ」ウィンドウが表示され、現在のページに関するヘルプ・トピックが表示されます。「ヘルプ」ウィンドウの「目次」をクリックしてヘルプ・トピックのリストを参照したり、「検索」をクリックして特定の語や句を検索できます。

3.3.3 Fusion Middleware Controlでのナビゲート

Fusion Middleware Controlの左側にはターゲット・ナビゲーション・ペインが、右側にはコンテンツ・ペインが表示されます。たとえば、初めてFusion Middleware Controlにログインするときは、右側にファームのホーム・ページが表示されます。

ターゲット・ナビゲーション・ペインでツリーを開き、Oracle WebLogic Serverドメイン、Oracle WebLogic Server管理対象サーバー、コンポーネント、アプリケーションまたはメタデータ・リポジトリを選択できます。

管理対象サーバー、コンポーネントなどのターゲットを選択する場合、ターゲットのホーム・ページはコンテンツ・ペインに表示されます。また、そのターゲットのメニューは、コンテキスト・ペインのページ上部に表示されます。たとえば、「管理対象サーバー」を選択した場合、「WebLogic Server」メニューが表示されます。ナビゲーション・ペインのターゲットで右クリックすることにより、ターゲットのメニューを表示することも可能です。

次の図は、ターゲット・ナビゲーション・ペインと管理対象サーバーのホーム・ページを示しています。管理対象サーバーが選択されているので、コンテキスト・ペインにリストされる動的ターゲット・メニューは「WebLogic Server」メニューになります。

図nav.gifの説明

この図のコールアウト・テキストの説明は、次のとおりです。

- ターゲット・ナビゲーション・ペイン: ナビゲーション・ツリーのファームにあるすべてのターゲットのリストが表示されます。

- コンテンツ・ペイン: ターゲットの現在のページが表示されます。最初にターゲットを選択する場合、そのターゲットのホーム・ページが表示されます。

- 「ファーム」メニュー: ファームで実行可能な操作のリストが表示されます。「ファーム」メニューは、常に使用可能です。

- 動的ターゲット・メニュー: 現在選択されているターゲットで実行可能な操作のリストが表示されます。表示されるメニューは、選択するターゲットによって異なります。特定のターゲットのメニューには、右クリック・ターゲット・メニューと同様の操作が含まれます。

- 右クリック・ターゲット・メニュー: 現在選択されているターゲットで実行可能な操作のリストが表示されます。このメニューは、ターゲット・ナビゲーション・ペインでターゲットの名前を右クリックすると表示されます。この図は、WebLogic Serverを選択してそのホーム・ページを表示した後の時点を示すものですが、ユーザーがメタデータ・リポジトリを右クリックしたので、右クリック・ターゲット・メニューには、メタデータ・リポジトリの操作が表示されています。
特定のターゲットのメニューには、動的ターゲット・メニューと同様の操作が含まれます。

- トポロジ・ビューア: ファームのトポロジが表示されます。

- ターゲット名: 現在選択されているターゲットの名前が表示されます。

- 「ターゲット」情報アイコン: ターゲットの情報が表示されます。たとえば、ドメインの場合、ターゲット名、バージョン、およびドメイン・ホームが表示されます。

- コンテキスト・ペイン: ターゲットの名前、現行ユーザーの名前、ホスト名、最終ページ・リフレッシュ時間、およびリフレッシュ・アイコンが表示されます。

- すべてを開く/すべて閉じる: ナビゲーション・ツリーを開いたり閉じたりできます。

- リフレッシュ: ページがリフレッシュされているときに表示されます。これをクリックすると、新しいデータでページがリフレッシュされます(ブラウザ・ウィンドウをリフレッシュするとページ自体はリフレッシュされるが、新しいデータは取得されない)。

- ログインに戻る: Oracle Enterprise Managerのロゴをクリックすると、ログイン・ページに移動します。

また、Fusion Middleware Controlからは、管理サーバーや管理対象サーバーなどのターゲットのホーム・ページから、WebLogic Server管理コンソールにアクセスできます。Fusion Middleware ControlとWebLogic Server管理コンソールの間でシングル・サインオンを構成する方法の詳細は、『Oracle Fusion Middleware Oracle Identity Managementエンタープライズ・デプロイメント・ガイド』の管理コンソールに対するシングル・サインオンの構成に関する項を参照してください。

表3-4では、Fusion Middleware Controlでの一般的なナビゲーション操作のいくつかを説明します。

図3-4 Fusion Middleware Controlでのナビゲート

目的:

操作方法

ファーム内のすべてのターゲットを表示する

ターゲット・ナビゲーション・ペインの上部の「すべてを開く」アイコンをクリックします。

ファームへナビゲートする

ターゲット・ナビゲーション・ペインからファームを選択します。コンテンツ・ペインに、ファームのホーム・ページが表示されます。

ファームで操作する

「ファーム」メニューを選択します。このメニューは、Fusion Middleware Controlの左上にあって常に使用可能です。

ターゲットで操作する

ターゲット・ナビゲーション・ペインで、ターゲットを右クリックします。「ターゲット」メニューが表示されます。

または、ターゲットを選択してコンテキスト・ペインの動的ターゲット・メニューを使用できます。

ターゲットのホーム・ページに戻る

コンテキスト・ペインの左上隅のターゲット名をクリックします。

新しいデータでページをリフレッシュする

コンテキスト・ペインの右上のリフレッシュ・アイコンをクリックします。

前のページに戻る

コンテキスト・ペインの下に表示されるブレッドクラムをクリックします。ターゲットでドリルダウンするとブレッドクラムが表示されます。たとえば、「WebLogic Server」メニューから「ログ」→「ログ・メッセージの表示」を選択します。ログ・ファイルを選択して、「ログ・ファイルの表示」をクリックします。ブレッドクラムは次のように表示されます。

ログ・メッセージ→ログ・ファイル→>ログ・ファイルの表示: logfile_name

ターゲットが稼働中のホストを表示する

ターゲット・ナビゲーション・ペインでターゲットを選択し、ターゲットのコンテキスト・ペインにホスト名を表示します。「ターゲット情報」アイコンをクリックして、ホスト名を表示することもできます。

ログイン・ページに戻る

ページの左上で、Oracle Enterprise Managerのロゴをクリックします。

トポロジを表示する

「トポロジ」をクリックします。

サーバー・ログ・ファイルを表示する

ターゲット・ナビゲーション・ペインで、サーバー名を右クリックします。「ログ」→「ログ・メッセージの表示」を選択して、ログ・メッセージのサマリーの確認およびログ・ファイルの検索を実行します。

3.3.4 Fusion Middleware Controlのユーザーおよびロールの概要

Fusion Middleware Controlにアクセスしてタスクを実行するには、適切なロールが必要です。Fusion Middleware Controlでは、Oracle WebLogic Serverセキュリティ・レルムとそのレルムで定義されたロールを使用します。ユーザーにそれらのロールのいずれかが付与されていないと、そのユーザーはFusion Middleware Controlにアクセスできません。

それぞれのロールでユーザーが持つアクセスのタイプを定義します。たとえば、ロールAdminを持つユーザーは完全な権限を持ちます。ロールOperatorを持つユーザーは、必要不可欠な日常業務を実行する権限を持ちます。ロールMonitorを持つユーザーは、構成を表示する権限のみを持ちます。

関連項目:

Oracle Fusion Middleware Oracle WebLogic Serverのロールとポリシーを使用したリソースの保護のユーザー・ロール、グループ・ロール、およびセキュリティ・ロールに関する項

3.3.5 ファームの表示と管理

Fusion Middleware Controlにログインすると、まずファームのホーム・ページが表示されます。このページは、ターゲット・ナビゲーション・ペインでファームを選択すると、いつでも表示できます。

次の図はファームのホーム・ページを示しています。

図farmhome.gifの説明

「ファーム」メニューは、ページ上部に表示されます。「ファーム」メニューから、次の処理を実行できます。

- コンポーネントの作成と削除、およびクラスタの作成

- ログ・メッセージの表示

- 監視する資格証明情報の指定

「ファーム」メニューは、別のエンティティを選択した場合でも常に表示されます。

「トポロジ」を選択すると、ファーム・トポロジを表示できます。この「トポロジ・ビューア」には、管理対象サーバー、デプロイ済アプリケーション、ルーティング構成などのトポロジの詳細なビューが表示されます。「トポロジ・ビューア」の使用法の詳細は、第11.3項を参照してください。

3.3.6 コンポーネントの表示と管理

ターゲット・ナビゲーション・ペインでは、ドリルダウンしてファームのコンポーネントを表示および管理できます。

たとえば、Oracle SOA Suiteを表示および管理する場合、次の手順を実行します。

1. ターゲット・ナビゲーション・ペインで、ファームを開いてから、「SOA」を開きます。

2. SOAインスタンスを選択します。
SOAインスタンスのホーム・ページは、次の図のように表示されます。

図soa_home.gifの説明

3. 「SOAインフラストラクチャ」メニューから、Oracle SOA Suiteの開始、停止および監視、SOAコンポジット・アプリケーションのデプロイなどの多くの管理タスクを実行できます。

また、Oracle HTTP Serverを表示および管理する場合は、次の手順を実行します。

1. ターゲット・ナビゲーション・ペインで、ファームを開いてから、「Web層」を開きます。

2. ohs1などのOracle HTTP Serverインスタンスを選択します。
Oracle HTTP Serverのohs1のホーム・ページは、次の図のように表示されます。

図ohs_home.gifの説明

3. 「HTTP Server」メニューから、Oracle HTTP Serverの開始、停止、監視などの多くの管理タスクを実行できます。

関連項目:

コンポーネントの監視の詳細は、第11.1.5項を参照してください。

3.3.7 アプリケーションのステータスの表示

ターゲット・ナビゲーション・ペインでは、ドリルダウンしてファームのアプリケーションを表示および管理できます。

Java EEアプリケーションを表示するには:

1. ターゲット・ナビゲーション・ペインで、ファームを開いてから、「アプリケーションのデプロイ」を開きます。

2. 表示するアプリケーションを選択します。
アプリケーションのホーム・ページが表示されます。このページで、アプリケーションのステータスのサマリー、アプリケーションのエントリ・ポイント、アプリケーションに関連付けられているWebサービスおよびモジュール、レスポンスと負荷を確認できます。

SOAコンポジット・アプリケーションを表示するには:

1. ターゲット・ナビゲーション・ペインで、ファームを開いてから、「SOA」を開いて「SOAインフラ」を開きます。

2. 表示するアプリケーションを選択します。
アプリケーションのホーム・ページが表示されます。ここには、アプリケーションの最新のインスタンス、フォルト・メッセージと拒否メッセージ、ポリシーなどのアプリケーションに関する情報が表示されます。

3.4 Oracle WebLogic Server管理コンソールの概要

Oracle WebLogic Server管理コンソールは、Oracle WebLogic Serverドメインの管理に使用する、Webブラウザ・ベースのグラフィカル・ユーザー・インタフェースです。これは、管理サーバーへのネットワーク・アクセスでサポートされるWebブラウザからアクセスできます。

管理コンソールでは、次の操作を行います。

- WebLogic Serverインスタンスを構成、起動および停止します。

- WebLogic Serverクラスタを構成します。

- データベース接続(JDBC)やメッセージング(JMS)などの、WebLogic Serverサービスを構成します。

- ユーザー、グループおよびロールの作成、管理などの、セキュリティ・パラメータを構成します。

- Java EEアプリケーションの構成とデプロイを行います。

- サーバーおよびアプリケーションのパフォーマンスを監視します。

- サーバーおよびドメインのログ・ファイルを表示します。

- アプリケーション・デプロイメント記述子を表示します。

- 選択したランタイム・アプリケーション・デプロイメント記述子の各要素を編集します。

3.4.1 Oracle WebLogic Server管理コンソールの表示

管理コンソールを表示する手順は次のとおりです。

1. ブラウザに次のURLを入力します。

http://hostname:port_number/console

ポート番号は管理サーバーのポート番号です。デフォルトのポート番号は、7001です。

ログイン・ページが表示されます。

2. インストール時に指定したユーザー名とパスワード、作成した別の管理ユーザーのユーザー名とパスワードを使用してログインします。
Oracle WebLogic Server管理コンソールは、次の図のように表示されます。

図wls_admin.gifの説明

また、Fusion Middleware Controlで、管理サーバーや管理対象サーバーなどのターゲットのホーム・ページから、管理コンソールにアクセスすることもできます。

3.4.2 WebLogic Serverの構成のロック

構成の変更を行う前に、編集セッション中に他のアカウントで変更が行われずに構成を変更できるように、ドメイン構成をロックします。ドメイン構成をロックする手順は次のとおりです。

1. 管理コンソール画面の左上のチェンジ・センターを検索します。

2. ロックして編集をクリックして、ドメイン構成の編集階層をロックします。

管理コンソールを使用して構成を変更したら、適切なページで「保存」(場合によっては「終了」)をクリックします。この変更は即座には反映されません。この変更は、チェンジ・センターで「変更のアクティブ化」をクリックすると反映されます。その時点で、構成の変更はドメイン内の各サーバーに配信されます。変更が各サーバーに受け入れられると、変更が反映されます。いずれかのサーバーで変更が受け入れられない場合、ドメイン内のすべてのサーバーからすべての変更がロールバックされます。変更は保留状態になるので、保留中の変更を編集して問題を解決するか、前の構成に戻すことができます。

次のようにWLSTコマンドstartEditを使用して構成をロックすることもできます。

startEdit()

startEditコマンドおよびロックを解除するstopEditコマンドの詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のstartEditに関する説明およびstopEditに関する説明を参照してください。

3.5 コマンドライン・ツールの使用の概要

次の各項では、ほとんどのOracle Fusion Middlewareコンポーネントの管理に使用できる、主要なコマンドライン・ツールについて説明します。

- Oracle WebLogic Scripting Tool(WLST)の使用の概要

- Oracle Process Manager and Notification Serverの使用の概要

3.5.1 WebLogic Scripting Tool(WLST)の使用の概要

Oracle WebLogic Scripting Tool(WLST)は、Oracle WebLogic Serverドメインの作成、管理および監視に使用するコマンドライン・スクリプト環境です。これは、Javaのスクリプト・インタプリタであるJythonがベースとなっています。ローカル変数、条件変数、フロー制御文などのJythonの標準機能のサポートのほかに、WLSTには、Oracle WebLogic Serverに固有のスクリプト関数(コマンド)セットが用意されています。Jythonの言語構文に従うことで、必要に応じてWebLogicのスクリプト言語を拡張できます。

WLSTコマンドは、次のように使用できます。

- コマンドラインで対話的に実行する

- スクリプト・モードでファイルに指定する

- Javaコードに組み込む

たとえば、WLSTを対話的に起動してWebLogic Serverに接続するには、次のコマンドを使用します。

WL_HOME/server/bin/setWLSEnv.sh
WL_HOME/common/bin/wlst.sh
connect('username', 'password', 'localhost:7001')

WLSTコマンドや変数の詳細を表示するには、ヘルプ・コマンドを入力します。たとえば、オンライン・コマンドのカテゴリ一覧を表示するには、次のように入力します。

wls:/base_domain/serverConfig>  help('online')
help('activate')            Activate the changes.
help('addListener')         Add a JMX listener to the specified MBean.
help('adminHome')           Administration MBeanHome.
help('cancelEdit')          Cancel an edit session.
help('cd')                  Navigate the hierarchy of beans.
help('cmo')                 Current Management Object.
.
.
.

ステータスを監視するには、次の形式でWLSTのstateコマンドを使用します。

state(name, type)

たとえば、管理対象サーバーsoa_server1のステータスを取得するには、次のコマンドを使用します。

wls:/SOA_domain/serverConfig> state('soa_server1', 'Server')
Current state of 'soa_server1' : RUNNING

関連項目:

『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』

3.5.1.1 カスタムWLSTコマンドの使用

Oracle SOA Suite、Oracle Platform Security Services(OPSS)、Oracle Fusion Middleware監査フレームワーク、MDSなどの多くのコンポーネント、およびSSLやロギングなどのサービスでは、カスタムWLSTコマンドが用意されています。

これらのカスタム・コマンドを使用するには、適切なOracleホームからWLSTスクリプトを起動する必要があります。WLSTスクリプトをWebLogic Serverホームで使用しないでください。

- 次のコンポーネントおよびサービスでは、Oracle共通ホームからWLSTを起動します。

- Oracle Application Development Framework

- Oracle Fusion Middlewareの監査フレームワーク

- Oracle Access Manager

- Oracle Platform Security Services

- Oracle Metadata Services

- 診断フレームワーク

- Dynamic Monitoring Service(DMS)

- ロギング

- Secure Sockets Layer(SSL)

- Oracle JRF

- Oracle Webサービス

- Oracle Web Services Manager

このスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/common/bin/wlst.sh
(Windows) ORACLE_COMMON_HOME\common\bin\wlst.cmd

- Oracle HTTP Server、Oracle SOA Suite、Oracle WebCenter Portalなど、他のコンポーネントの場合は、そのコンポーネントがインストールされているOracleホームからWLSTを起動します。このスクリプトは、次の場所にあります。

(UNIX) ORACLE_HOME_for_component/common/bin/wlst.sh
(Windows) ORACLE_HOME_for_component\common\bin\wlst.cmd

たとえば、LinuxシステムのOracle SOA SuiteでカスタムWLSTコマンドを実行するには、次のコマンドを使用します。

cd ORACLE_HOME_for_SOA/common/bin
./wlst.sh

3.5.1.2 システム・コンポーネントでのWLSTコマンドの使用

WLSTのOracle WebLogic Server用に提供されているコマンドの他に、システム・コンポーネントの管理コマンドのサブセットも提供されています。これらのコマンドは次のとおりです。

- startproc(componentName [, componentType] [, componentSet): 指定したコンポーネントを起動します。

- stopproc(componentName [, componentType] [, componentSet): 指定したコンポーネントを停止します。

- status(componentName [, componentType] [, componentSet): 指定したコンポーネントのステータスを取得します。

- proclist(): コンポーネントの一覧を取得します。

これらのカスタム・コマンドを使用するには、コンポーネントがインストールされたOracleホームからWLSTスクリプトを起動する必要があります。WLSTスクリプトをWebLogic Serverホームで使用しないでください。このスクリプトは、次の場所にあります。

(UNIX) ORACLE_HOME_for_component/common/bin/wlst.sh
(Windows) ORACLE_HOME_for_component\common\bin\wlst.cmd

3.5.2 Oracle Process Manager and Notification Serverの使用の概要

Oracle Process Manager and Notification Server(OPMN)は、次に示すシステム・コンポーネントと呼ばれるOracle Fusion Middlewareコンポーネントを管理および監視します。

- Oracle HTTP Server

- Oracle Web Cache

- Oracle Internet Directory

- Oracle Virtual Directory

- Oracle Forms Services

- Oracle Reports

- Oracle Business Intelligence Discoverer

- Oracle Business Intelligence

OPMNにはopmnctlコマンドがあります。実行可能ファイルは、次の場所にあります。

- ORACLE_HOME/opmn/bin/opmnctl: この場所のopmnctlコマンドは、Oracleインスタンスやローカル・システム上のOracleインスタンスのコンポーネントを作成する場合にのみ使用されます。この場所で生成されたopmnctlコマンドを使用して、システム・プロセスの管理やOPMNの起動を行うことはできません。
Windowsでは、この場所のopmnctl startコマンドを使用してOPMNを起動すると、Windowsユーザーがログアウトした際にOPMNとそのプロセスは終了します。

- ORACLE_INSTANCE/bin/opmnctl: この場所のopmnctlコマンドは、Oracleインスタンスごとにopmnctlをインスタンス化します。この場所のopmnctlコマンドを使用して、このOracleインスタンスのプロセスを管理します。このopmnctlは、Oracleインスタンスのコンポーネントを作成する際にも使用できます。
Windowsでは、この場所のopmnctl startコマンドを使用してOPMNを起動すると、OPMNはWindowsサービスとして起動されます。したがって、OPMNの親プロセスとそのプロセスが管理するプロセスは、Microsoft Windowsユーザーがログアウトした後でも維持されます。

Oracleインスタンスのすべてのシステム・コンポーネントのステータスを表示するには、次のコマンドを使用します。

opmnctl status
Processes in Instance: webtier_inst
---------------------------------+--------------------+---------+---------
ias-component                    | process-type       |     pid | status
---------------------------------+--------------------+---------+---------
webcache1                        | WebCache-admin     |   19556 | Alive
webcache1                        | WebCache           |   19555 | Alive
ohs1                             | OHS                |    7249 | Alive

特定のコンポーネントまたはコンポーネント・タイプのステータスを表示するには、次のコマンドを使用します。

opmnctl status componentName [, componentType] [, componentSet]

たとえば、ovd1という名前のOracle Virtual Directoryインスタンスのステータスを表示する場合は、次のコマンドを使用します。

opmnctl status ias-component=ovd1

システム・コンポーネントの起動と停止、システム・コンポーネントの監視、およびプロセス管理に関連するその他の多くのタスクの実行にOPMNを使用できます。たとえば、次のコマンドを使用すると、OPMNやすべてのOPMN管理対象プロセス(Oracle HTTP ServerやOracle Web Cacheなど)を起動および停止できます。

opmnctl startall
opmnctl stopall

コンポーネントを起動するには、次のコマンドを使用します。

opmnctl startproc componentName [, componentType] [, componentSet

たとえば、ohs1という名前のOracle HTTP Serverインスタンスを起動するには、次のコマンドを使用します。

opmnctl startproc ias-component=ohs1

関連項目:

- Oracle Fusion Middleware環境の起動と停止の詳細は、第4章を参照してください。

- Oracle Fusion Middleware環境の監視の詳細は、第11章を参照してください。

- 『Oracle Fusion Middleware Oracle Process Manager and Notification Server管理者ガイド』

3.6 Fusion Middleware Control MBeanブラウザの使用の概要

管理対象Bean(MBean)とは、分散環境内のJMXで管理されるリソースを表すJavaオブジェクトです。MBeanには、アプリケーション、サービス、コンポーネント、デバイスなどがあります。

MBeanは、Java EE環境のアプリケーションの管理に使用する標準インタフェースを作成するための一連の仕様、すなわちJava Management Extension(JMX)の一部である、Java EE管理仕様(JSR-77)で定義されています。JSR-77の詳細は、次のURLを参照してください。

http://java.sun.com/j2ee/tools/management/

MBeanを作成してアプリケーションとともにOracle WebLogic Serverにデプロイすると、アプリケーションまたはアプリケーションのコンポーネントを、Fusion Middleware Controlを使用して管理および監視できるようになります。

関連項目:

『Oracle Fusion Middleware Oracle WebLogic Server JMXによるカスタム管理ユーティリティの開発』のWebLogic Server MBeanの理解に関する項

Fusion Middleware Controlには、Oracle WebLogic Serverまたは選択したアプリケーションのMBeanを参照できる、一連のMBeanブラウザが用意されています。MBeanブラウザでは、特定の監視タスクや構成タスクも実行できます。

MBeanは、構成MBean、ランタイムMBean、およびアプリケーション定義MBeanの3つのグループに編成されます。

次の各項では、MBeanの表示方法や構成方法について説明します。

- システムMBeanブラウザの使用

- 選択したアプリケーションのMBeanの使用

3.6.1 システムMBeanブラウザの使用

Oracle WebLogic Serverドメイン、管理サーバー、管理対象サーバーやアプリケーションなど多くのエンティティのためにシステムMbeanブラウザを表示できます。MBeanナビゲーション・ツリーで、MBeanの検索、MBeanのリストのフィルタ、およびMBeanのリストのリフレッシュを実行できます。

特定のOracle WebLogic Server管理対象サーバーに固有のシステムMBeanブラウザを表示して、MBeansを構成および使用する手順は次のとおりです。

1. ターゲット・ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開き、そのドメインを開きます。

2. 管理対象サーバーを選択します。

3. 「WebLogicサーバー」メニューから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」ページが表示されます。

4. MBeanナビゲーション・ツリーでノードを開いて、アクセスするMBeanにドリルダウンします。MBeanインスタンスを選択します。
MBeanの場所がわからない場合、そのMBeanを検索できます。

1. MBeanナビゲーション・ツリーの上部にある「検索」アイコンをクリックします。

2. 検索するには、「MBean名」を選択します。
「属性」、「操作」、または「JMX構文」も選択できます。

3. MBeanの名前を入力し、矢印をクリックします。

5. MBeanの属性を表示するには、「属性」タブを選択します。一部の属性では値を変更できます。そのためには、値を「値」列に入力します。

6. 使用可能な操作を表示するには、「操作」タブを選択します。操作を実行するには、操作をクリックします。「操作」ページが表示されます。適切な値を入力し、「起動」をクリックします。

関連項目:

Fusion Middleware Controlのオンライン・ヘルプ

3.6.2 選択したアプリケーションのMBeanの使用

第3.6.1項で説明されている手順を実行し、アプリケーションに関してドリルダウンすると、特定のアプリケーションのMBeanを表示、構成および使用できます。また、次の手順を使用してもアプリケーションのMBeanにナビゲートできます。

1. ターゲット・ナビゲーション・ペインで、ファームを開いてから、「アプリケーションのデプロイ」を開きます。

2. アプリケーションを選択します。

3. 「アプリケーションのデプロイ」メニューから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」ページに、アプリケーションのMBean情報が表示されます。

4. MBeanの属性を表示するには、「属性」タブを選択します。一部の属性では値を変更できます。そのためには、値を「値」列に入力します。

5. 使用可能な操作を表示するには、「操作」タブを選択します。操作を実行するには、操作をクリックします。「操作」ページが表示されます。適切な値を入力し、「起動」をクリックします。

3.7 コンポーネントの管理

Oracle Fusion Middlewareコンポーネントには、Oracle WebLogic Server、Oracle SOA SuiteおよびWebCenter Portalの一部となるJavaコンポーネント(Oracle BPEL Process Manager、Oracle Business Activity Monitoringなど)、およびOracle Web Cacheなどのシステム・コンポーネントが含まれます。

Oracle WebLogic ServerおよびJavaコンポーネントを管理すると、WLST、Oracle WebLogic Server管理コンソールまたはFusion Middleware Controlを使用できます。

システム・コンポーネントを管理すると、OPMN、WLSTまたはFusion Middleware Controlを使用できます。

関連項目:

- コンポーネントのインストールおよび構成の詳細は、『Oracle Fusion Middlewareインストレーション・プランニング・ガイド』および個々のインストレーション・ガイドを参照してください。

- Oracle WebLogic Serverのインストールおよび構成の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverインストレーション・ガイド』を参照してください。

- これらのコンポーネントの管理の詳細は、各コンポーネントまたはスイートの管理ガイドを参照してください。

3.8 管理ユーザーのパスワードの変更

Oracle Fusion Middlewareのインストール時に、管理アカウントのパスワードを指定する必要があります。このアカウントは、Fusion Middleware ControlおよびOracle WebLogic Server管理コンソールへの初回ログイン時に使用できます。追加の管理アカウントを作成するには、WLSTコマンドラインまたはOracle WebLogic Server管理コンソールを使用します。

関連項目:

『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』のユーザーおよびロールの理解に関する項

管理ユーザーのパスワードを変更するには、Oracle WebLogic Server管理コンソールまたはWLSTコマンドラインを使用します。

3.8.1 コマンドラインを使用した管理ユーザーのパスワードの変更

コマンドラインを使用して管理ユーザーのパスワードまたはその他のユーザーのパスワードを変更するには、UserPasswordEditorMBean.changeUserPasswordメソッドを呼び出します。このメソッドはセキュリティ・レルムのAuthenticationProvider MBeanで拡張されます。

詳細は、Oracle Fusion Middleware Oracle WebLogic Server MBeanリファレンスのchangeUserPasswordの方法に関する項を参照してください。

3.8.2 管理コンソールを使用した管理ユーザーのパスワードの変更

Oracle WebLogic Server管理コンソールを使用して管理ユーザーのパスワードを変更するには:

1. Oracle WebLogic Server管理コンソールにナビゲートします。(たとえば、Fusion Middleware Controlのドメインのホーム・ページから、「このWebLogicドメインを構成および管理するには、Oracle WebLogic Server管理コンソールを使用します。」を選択します。)

2. 「ドメイン構造」ペインで、「セキュリティ・レルム」を選択します。
セキュリティ・レルムのサマリーページが表示されます。

3. 「myrealm」などのレルムを選択します。
そのレルムの「設定」ページが表示されます。

4. 「ユーザーとグループ」タブ→「ユーザー」タブを選択します。ユーザーを選択します。
ユーザーの設定ページが表示されます。

5. 「パスワード」タブを選択します。

6. 新しいパスワードを入力した後、確認のために再度それを入力します。

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

8. 環境にOracle Management Agentの管理対象となるコンポーネントが含まれる場合、targets.xmlファイルを更新する必要があります。このファイルは次の場所にあります。

ORACLE_INSTANCE/EMAGENT/emagent_<instanceName>/sysman/emd/targets.xml

次の手順を実行します。

1. targets.xmlファイルをバックアップします。

2. 新しいパスワードで更新が必要なターゲットをすべて特定します。そして、target.xmlファイルにおいて各ターゲットで、WeblogicPasswordプロパティを次に設定します。

<Property NAME="WeblogicPassword" VALUE="new_password"ENCRYPTED="FALSE"/>

3. 第4.5項の説明に従って、Oracle Management Agentを再起動します。

3.9 Oracle Fusion Middlewareの構成および管理の基本的なタスク

次に、ソフトウェアをインストールした後に基本的なOracle Fusion Middleware環境を構成および管理するために必要な手順の概要を示します。

1. Oracle WebLogic ServerおよびOracle SOA Suite、Oracle HTTP Server、Oracle Web Cacheなどのコンポーネントを構成します。『Oracle Fusion Middlewareインストレーション・プランニング・ガイド』を参照してください。

2. SSLを構成します。第6章を参照してください。

3. MDSリポジトリなどのメタデータ・リポジトリを作成および管理します。第14.2項を参照してください。

4. アプリケーションをデプロイします。第10章を参照してください。

5. ロード・バランシングを構成します。様々なコンポーネントまたはアプリケーション間のロード・バランシングを構成できます。『Oracle Fusion Middleware高可用性ガイド』を参照してください。

6. 環境をバックアップします。第16章を参照してください。

7. 環境を監視し、ログ・ファイルを管理します。第11章および第12章を参照してください。

8. 環境を拡張します。第19章を参照してください。

このガイドでは、Oracle Fusion Middleware環境に応じて、実行する必要がある場合があるその他のタスクについても説明します。

4 Oracle Fusion Middlewareの起動と停止

この章では、Oracle Fusion Middlewareの起動と停止の手順(管理サーバー、管理対象サーバーおよびコンポーネントを含む)について説明します。

次の項目が含まれます。

- 起動および停止手順の概要

- Oracle WebLogic Serverインスタンスの起動と停止

- コンポーネントの起動と停止

- Fusion Middleware Controlの起動と停止

- Oracle Management Agentの起動と停止

- アプリケーションの起動と停止

- Oracle Fusion Middleware環境の起動と停止

- 起動と停止: 特殊なトピック

4.1 起動および停止手順の概要

Oracle Fusion Middlewareは、使用者の要件に応じて、様々な方法で起動および停止できる柔軟性のある製品です。多くの場合、Fusion Middleware Control、Oracle WebLogic Server管理コンソール、WLSTまたはOPMNコマンドを使用してOracle Fusion Middlewareコンポーネントを起動または停止できます。

これらのツールは完全に互換性があり、ほとんどの場合、相互に使用できます。たとえば、WLSTを使用してJ2EEコンポーネントを起動し、Fusion Middleware Controlを使用して停止できます。

注意:

IBM WebSphereでサーバーを起動および停止する方法の詳細は、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドのIBM WebSphereでのサーバーの起動と停止に関する項を参照してください。

4.2 Oracle WebLogic Serverインスタンスの起動と停止

Oracle WebLogic Server管理サーバーは、WLSTコマンドラインを使用して起動できます。管理対象サーバーは、スクリプト、WLSTコマンドライン、WebLogic Server管理コンソールまたはFusion Middleware Controlを使用して起動または停止できます。次の項では、WLSTコマンドライン、Fusion Middleware Control、またはその両方を使用してWebLogic Serverを起動および停止する方法について説明します。

- ノード・マネージャでの管理対象サーバーの起動の構成

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

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

- 資格証明を入力しないサーバーの起動の有効化

- WindowsサービスとしてのOracle WebLogic Serverの設定

4.2.1 ノード・マネージャでの管理対象サーバーの起動の構成

Oracle SOA Suite、Oracle WebCenter Portal、Oracle JRFなどの他のOracle Fusion Middleware製品が管理対象サーバーにインストールされている場合は、正しいクラスパスとパラメータが設定されるように管理対象サーバーの環境を構成する必要があります。この環境情報は、startWebLogicやsetDomainEnvなどの起動スクリプトにより渡されます。これらは、次のディレクトリにあります。

DOMAIN_HOME/bin

管理対象サーバーがノード・マネージャによって起動される場合(サーバーがOracle WebLogic Server管理コンソールまたはFusion Middleware Controlによって起動される場合と同様)、サーバー環境が正しく構成されるようにこれらの起動スクリプトを使用するように管理対象サーバーを設定する必要があります。特に、ノード・マネージャは、プロパティStartScriptEnabled=trueを指定して起動する必要があります。

このプロパティを有効にしてノード・マネージャを起動する方法はいくつかあります。Oracle Fusion Middlewareでは便宜上、次のスクリプトを提供しています。このスクリプトではプロパティStartScriptEnabled=trueをnodemanager.propertiesファイルに追加しています。

(UNIX) ORACLE_COMMON_HOME/common/bin/setNMProps.sh.
(Windows) ORACLE_COMMON_HOME\common\bin\setNMProps.cmd

たとえば、Linux上でsetNMPropsスクリプトを実行してノード・マネージャを起動します。

ORACLE_COMMON_HOME/common/bin/setNMProps.sh
MW_HOME/wlserver_n/server/bin/startNodeManager.sh

ノード・マネージャを起動すると、nodemanager.propertiesファイルのStartScriptEnabled=trueプロパティが読み取られ、それ以降に管理対象サーバーを起動するときに起動スクリプトが使用されます。setNMPropsスクリプトは1回のみ実行する必要があります。

また、StartScriptEnableプロパティがtrueに設定されていると、ノード・マネージャによりstartWebLogicスクリプトを読み取り、続いてsetDomainEnvスクリプトを読み取ります。その結果、setDomainEnvスクリプトを編集することでチューニング変更を行う必要があります。ノード・マネージャによりサーバーが起動されると、コマンドラインや管理コンソールを使用して行われた変更は実装されません。たとえば、管理コンソールを使用してサーバー起動引数を変更すると、これらの変更はconfig.xmlに書き込まれますが、ノード・マネージャではこれらの設定は無視され、これらをsetDomainEnvで使用します。

関連項目:

ノード・マネージャの構成および起動の他の方法については、『Oracle Fusion Middleware Oracle WebLogic Serverノード・マネージャ管理者ガイド』のノード・マネージャの使用に関する項を参照してください。

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

Oracle WebLogic Server管理サーバーは、WLSTコマンドラインまたはスクリプトを使用して起動および停止できます。管理サーバーを起動または停止する場合、管理サーバーで稼働しているWebLogic Server管理コンソールやFusion Middleware Controlなどのプロセスも起動または停止します。

たとえば、管理サーバーを起動するには、次のスクリプトを使用します。

DOMAIN_HOME/bin/startWebLogic.sh
-Dweblogic.management.username=weblogic
-Dweblogic.management.password=password
-Dweblogic.system.StoreBootIdentity=true

管理サーバーを停止するには、次のスクリプトを使用します。

DOMAIN_HOME/bin/bin/stopWebLogic.sh
username password [admin_url]

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

次の各項で説明するように、Fusion Middleware ControlまたはWLSTコマンドおよびスクリプトを使用して、管理対象サーバーを起動および停止できます。

- Fusion Middleware Controlを使用した管理対象サーバーの起動と停止

- WLSTを使用した管理対象サーバーの起動と停止

4.2.3.1 Fusion Middleware Controlを使用した管理対象サーバーの起動と停止

Fusion Middleware ControlおよびOracle WebLogic Server管理コンソールでは、ノード・マネージャを使用して管理対象サーバーを起動します。Oracle WebLogic Server以外のOracle Fusion Middleware製品が含まれない管理対象サーバーを起動する場合、この項の手順を使用してサーバーを起動できます。

ただし、管理対象サーバーにOracle SOA Suite、Oracle WebCenter Portal、Oracle JRFなどの別のOracle Fusion Middleware製品が含まれている場合、第4.2.1項で説明されているように、まずノード・マネージャを構成する必要があります。

Fusion Middleware Controlを使用してWebLogic Server管理対象サーバーを起動および停止するには:

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開き、そのドメインを開きます。

2. 管理対象サーバーを選択します。

3. 「WebLogic Server」メニューから、「コントロール」を選択してから、「起動」または「停止」を選択します。

また、サーバーを右クリックして、「コントロール」を選択してから、「起動」または「停止」も選択できます。

4.2.3.2 WLSTを使用した管理対象サーバーの起動と停止

スクリプトまたはWLSTを使用して、WebLogic Server管理対象サーバーを起動および停止できます。

たとえば、WebLogic Server管理対象サーバーを起動するには、次のスクリプトを使用します。

(UNIX) DOMAIN_HOME/bin/startManagedWebLogic.sh
managed_server_name admin_url
(Windows) DOMAIN_HOME\bin\startManagedWebLogic.cmd
managed_server_name admin_url

プロンプトが表示されたらユーザー名とパスワードを入力します。

WebLogic Server管理対象サーバーを停止するには、次のスクリプトを使用します。

(UNIX) DOMAIN_HOME/bin/stopManagedWebLogic.sh
managed_server_name admin_url username password
(Windows) DOMAIN_HOME\bin\stopManagedWebLogic.cmd
managed_server_name admin_url username password

4.2.4 資格証明を入力しないサーバーの起動の有効化

管理者のユーザー名とパスワードの入力を求められることなく、管理サーバーおよび管理対象サーバーを起動できます。

1. 管理サーバーの場合、boot.propertiesファイルを作成します。

1. 次のディレクトリを作成します。

MW_HOME/user_
projects/domains/domain_name/servers/AdminServer/security

2. テキスト・エディタを使用して、前の手順で作成したセキュリティ・ディレクトリにboot.propertiesというファイルを作成し、そのファイルに次の行を入力します。

username=adminuser
password=password

2. 各管理対象サーバーの場合は、次のとおりです。

1. 次のディレクトリを作成します。

MW_HOME/user_
projects/domains/domain_name/servers/server_name/security

2. 管理サーバー用に作成したboot.propertiesファイルを前の手順で作成したセキュリティ・ディレクトリにコピーします。

3. 第4.2.2項および第4.2.3項の説明に従って、管理サーバーおよび管理対象サーバーを再起動します。

注意:

管理サーバーまたは管理対象サーバーの起動時には、このファイルのユーザー名とパスワードのエントリは暗号化されています。

セキュリティ上の理由から、ファイルのエントリが暗号化されていない状態の時間は最小限に抑えてください。ファイルの編集後は、速やかにサーバーを起動してエントリを暗号化します。

関連項目:

詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverサーバーの起動と停止の管理』の起動時アイデンティティ・ファイルに関する項を参照してください。

4.2.5 WindowsサービスとしてのOracle WebLogic Serverの設定

Windowsホスト・コンピュータの起動時にWebLogic Serverインスタンスを自動的に起動する場合、サーバーをWindowsサービスとして設定できます。詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverサーバーの起動と停止の管理』のWindowsサービスとしてのWebLogic Serverインスタンスの起動に関する項を参照してください。

ただし、その章ではスタンドアロンOracle WebLogic Serverインストールのプロセスについて説明しています。Oracle WebLogic ServerがOracle Fusion Middleware環境の一部の場合、環境を設定してORACLE_COMMONへの参照を含める必要があります。これを行うためには、作成するスクリプトは、"サーバーをWindowsサービスとして設定するためのスクリプト例に関する項のスクリプトとは若干異なります。次に、正しいスクリプトを示します。

echo off
SETLOCAL
set DOMAIN_NAME=myWLSdomain
set USERDOMAIN_HOME=d:\Oracle\config\domains\myWLSdomain
set SERVER_NAME=myWLSserver
set PRODUCTION_MODE=true
set
JAVA_OPTIONS=-Dweblogic.Stdout="d:\Oracle\config\domains\myWLSdomain\
stdout.txt" -Dweblogic.Stderr="d:\Oracle\config\domains\myWLSdomain\stderr.txt"
set ADMIN_URL=http://adminserver:7501
set MEM_ARGS=-Xms40m -Xmx250m
call %USERDOMAIN_HOME%\bin\setDomainEnv.cmd
call "d:\Oracle\Middleware\wlserver_10.3\server\bin\installSvc.cmd"
ENDLOCAL

4.3 コンポーネントの起動と停止

コンポーネントを起動および停止するには、そのコンポーネントに応じて、コマンドライン、WebLogic Server管理コンソール、またはFusion Middleware Controlを使用します。次の各項では、Fusion Middleware Controlおよびコマンドラインを使用してコンポーネントを起動および停止する方法について説明します。

- Fusion Middleware Controlを使用したコンポーネントの起動と停止

- コマンドラインを使用したコンポーネントの起動と停止

4.3.1 Fusion Middleware Controlを使用したコンポーネントの起動と停止

コンポーネントを起動または停止するには:

1. ナビゲーション・ペインで、ファームを開いてから、コンポーネントにナビゲートします。

2. 「SoaInfra」などのコンポーネントを選択します。

3. 動的ターゲット・メニューから、「コントロール」を選択してから、「起動」または「停止」を選択します。

注意:

OPMNが起動されていないと、Fusion Middleware Controlを使用して、Oracle HTTP ServerやOracle Internet Directoryなどのシステム・コンポーネントを起動できません。OPMNを起動するには、次のコマンドを使用します。

opmnctl start

4.3.2 コマンドラインを使用したコンポーネントの起動と停止

コンポーネントがJavaコンポーネントの場合、WLSTコマンドを使用してコンポーネントを起動および停止します。コンポーネントがシステム・コンポーネントの場合、opmnctlコマンドを使用してコンポーネントを起動および停止します。

- Javaコンポーネントを起動および停止するには、WLSTのstartApplicationおよびstopApplicationコマンドを使用します。

startApplication(appName, [options])
stopApplication(appName, [options])

たとえば、Oracle Directory Integration Platformを起動するには、次のコマンドを使用します。

startApplication("DIP")

- システム・コンポーネントを起動および停止するには、opmnctlコマンドライン・ツールを使用します。これは次のディレクトリにあります。

(UNIX) ORACLE_INSTANCE/bin
(Windows) ORACLE_INSTANCE\bin

OPMNおよびOracle HTTP Serverなどのすべてのシステム・プロセスを起動または停止するには、次のコマンドを実行します。

opmnctl startall
opmnctl stopall

コンポーネントを起動、停止または再起動する場合のopmnctlコマンドは次のとおりです。

opmnctl startproc ias-component=component_name
opmnctl stopproc ias-component=component_name
opmnctl restartproc ias-component=component_name

たとえば、Oracle HTTP Serverのohs1を起動するには、次のコマンドを使用します。

opmnctl startproc ias-component=ohs1

コンポーネントのサブプロセスを起動、停止または再起動するコマンドは次のとおりです。

opmnctl stopproc process-type=process
opmnctl startproc process-type=process
opmnctl restartproc process-type=process

4.4 Fusion Middleware Controlの起動と停止

ドメインでFusion Middleware Controlが構成されていると、第4.2.2項で説明されているように、Oracle WebLogic Server管理サーバーを起動または停止するときに自動的に起動または停止されます。

4.5 Oracle Management Agentの起動と停止

Oracle Management Agentは、特に特定のOracle Fusion Middlewareコンポーネントを監視するために設計されています。

Oracle Management Agentを起動するには、次のコマンドを使用します。

opmnctl startproc ias-component=EMAGENT

Oracle Management Agentを停止するには、次のコマンドを使用します。

opmnctl stopproc ias-component=EMAGENT

4.6 アプリケーションの起動と停止

アプリケーションは、Fusion Middleware Control、WebLogic Server管理コンソール、またはWLSTコマンドラインを使用して起動および停止できます。次の各項では、Fusion Middleware Controlおよびコマンドラインを使用してアプリケーションを起動および停止する方法について説明します。

- Fusion Middleware Controlを使用したJava EEアプリケーションの起動と停止

- WLSTを使用したJava EEアプリケーションの起動と停止

4.6.1 Fusion Middleware Controlを使用したJava EEアプリケーションの起動と停止

Fusion Middleware Controlを使用してJava EEアプリケーションを起動および停止するには:

1. ナビゲーション・ペインで、「アプリケーションのデプロイ」を開きます。

2. アプリケーションを選択します。

3. 「アプリケーションのデプロイ」メニューから、「コントロール」を選択してから、「起動」または「停止」を選択します。

Fusion Middleware Controlを使用してSOAコンポジット・アプリケーションを起動および停止するには:

1. ナビゲーション・ペインで、ファームを開いてから、「SOA」を開いて「SOAインフラ」を開きます。

2. アプリケーションを選択します。

3. 「SOAコンポジット」ページで、「起動」または「停止」をクリックします。

4.6.2 WLSTを使用したJava EEアプリケーションの起動と停止

WLSTコマンドラインを使用してJava EEアプリケーションを起動および停止するには、次のコマンドを使用します。

startApplication(appName, [options])
stopApplication(appName, [options])

アプリケーションは、ドメイン内で完全に構成されて使用可能である必要があります。startApplicationコマンドは、WLSTProgressオブジェクトを返します。このオブジェクトにアクセスすると、コマンドのステータスを確認できます。エラーが発生した場合、コマンドはWLSTExceptionを返します。WLSTProgressオブジェクトの詳細は、『Oracle Fusion Middleware Oracle WebLogic Scripting Tool』のWLSTProgressオブジェクトに関する項を参照してください。

4.7 Oracle Fusion Middleware環境の起動と停止

この項では、Oracle Fusion Middleware環境を起動および停止する手順について説明します。環境は、Oracle WebLogic Serverドメイン、管理サーバー、複数の管理対象サーバー、Javaコンポーネント、アイデンティティ管理コンポーネントなどのシステム・コンポーネント、およびメタデータのリポジトリに使用されるデータベースで構成できます。これらのコンポーネントは相互に依存する場合があります。したがって、正しい順序で起動および停止することが重要です。

Oracle Fusion Middleware環境を完全に停止する必要がある場合は、次の手順を使用できます。環境を完全にバックアップする場合や、パッチを適用する場合などは、この手順を使用します。

4.7.1 Oracle Fusion Middleware環境の起動

Oracle Fusion Middleware環境を起動する手順は次のとおりです。

1. 任意のデータベースベースのリポジトリを起動します。

1. ORACLE_HOME環境変数をデータベースのOracleホームに設定します。

2. ORACLE_SID環境変数をデータベースのSID(デフォルトはorcl)に設定します。

3. Netリスナーを起動します。

ORACLE_HOME/bin/lsnrctl start

4. データベース・インスタンスを起動します。

ORACLE_HOME/bin/sqlplus /nolog
SQL> connect SYS as SYSDBA
SQL> startup
SQL> quit

2. 第4.2.2項の説明に従って、Oracle WebLogic Server管理サーバーを起動します。

3. ノード・マネージャがまだ構成されていない場合は、第4.2.1項の説明に従ってノード・マネージャを構成します。

4. ノード・マネージャが実行されていることを確認します。ノード・マネージャが実行されていない場合、次のコマンドを実行してこれを起動します。

(UNIX) DOMAIN_HOME/bin/startNodeManager.sh
(Windows) DOMAIN_HOME\bin\startNodeManager.sh

5. Oracle Identity Managementシステム・コンポーネントを起動します。

1. ORACLE_HOME環境変数をアイデンティティ管理コンポーネントのOracleホームおよびORACLE_INSTANCE環境変数に設定します。

2. OPMNおよびすべてのシステム・コンポーネントを起動します。

(UNIX) ORACLE_INSTANCE/bin/opmnctl startall
(Windows) ORACLE_INSTANCE\bin\opmnctl startall

6. 第4.2.3.2項の説明に従って、Oracle WebLogic Server管理対象サーバーを起動します。サーバーにデプロイされているすべてのアプリケーションも起動されます。

7. OPMNおよびOracle HTTP Serverなどその他のシステム・コンポーネントを起動します。

1. ORACLE_HOMEとORACLE_INSTANCEの環境変数をシステム・コンポーネントのOracleホームとOracleインスタンスに設定します。

2. OPMNとそのOracleインスタンスのすべてのシステム・コンポーネントを起動します。

(UNIX) ORACLE_INSTANCE/bin/opmnctl startall
(Windows) ORACLE_INSTANCE\bin\opmnctl startall

8. 環境にOracle Management Agentの監視対象となるコンポーネントが含まれる場合、第4.5項の説明に従ってOracle Management Agentを起動します。

4.7.2 Oracle Fusion Middleware環境の停止

Oracle Fusion Middleware環境を停止する手順は次のとおりです。

1. Oracle HTTP Serverなどのシステム・コンポーネントを停止します。これらは、任意の順序で停止できます。

1. ORACLE_HOMEとORACLE_INSTANCEの環境変数をシステム・コンポーネントのOracleホームとOracleインスタンスに設定します。

2. OPMNとそのOracleインスタンスのすべてのシステム・コンポーネントを停止します。

(UNIX) ORACLE_INSTANCE/bin/opmnctl stopall
(Windows) ORACLE_INSTANCE\bin\opmnctl stoptall

2. 環境にOracle Management Agentの監視対象となるコンポーネントが含まれる場合、第4.5項の説明に従ってOracle Management Agentを停止します。

3. 第4.2項の説明に従って、Oracle WebLogic Server管理対象サーバーを停止します。サーバーにデプロイされているすべてのアプリケーションも停止されます。

4. Oracle Identity Managementコンポーネントを停止します。

1. ORACLE_HOME環境変数をアイデンティティ管理コンポーネントのOracleホームに設定します。

2. OPMNおよびすべてのシステム・コンポーネントを停止します。

(UNIX) ORACLE_INSTANCE/bin/opmnctl stopall
(Windows) ORACLE_INSTANCE\bin\opmnctl stoptall

5. 第4.2.2項の説明に従って管理サーバーを停止します。

6. ノード・マネージャを停止するには、killコマンドを使用します。

kill -9 PID

7. 任意のデータベースベースのリポジトリを停止します。

1. ORACLE_HOME環境変数をデータベースのOracleホームに設定します。

2. ORACLE_SID環境変数をデータベースのSID(デフォルトはorcl)に設定します。

3. データベース・インスタンスを停止します。

ORACLE_HOME/bin/sqlplus /nolog
SQL> connect SYS as SYSDBA
SQL> shutdown
SQL> quit

4. Netリスナーを停止します。

ORACLE_HOME/bin/lsnrctl stop

4.8 起動と停止: 特殊なトピック

この項では、Oracle Fusion Middlewareの起動および停止に関する特殊なトピックについて説明します。この項の項目は次のとおりです。

- 高可用性環境での起動と停止

- Oracle Databaseの強制停止

4.8.1 高可用性環境での起動と停止

次に示す高可用性環境では、起動および停止について特別な検討と手順が必要です。

- Oracle Fusion Middlewareのコールド・フェイルオーバー・クラスタ

- Oracle Application Serverの障害時リカバリ

関連項目:

高可用性環境での起動と停止の詳細は、『Oracle Fusion Middleware高可用性ガイド』を参照してください。

4.8.2 Oracle Databaseの強制停止

Oracle Databaseインスタンスの停止に時間がかかる場合、次のコマンドを使用してただちに強制停止できます。

ORACLE_HOME/bin/sqlplus /nolog
SQL> connect SYS as SYSDBA
SQL> SHUTDOWN IMMEDIATE;

データベースの即時停止は、次の条件で処理されます。

- 文が発行されると、新しい接続は許可されず、新しいトランザクションは開始できません。

- すべての未コミットのトランザクションは、ロールバックされます。(長くかかる未コミットのトランザクションが存在する場合、この停止方法ではその名前に反して即座に終了しない場合があります。)

- 現在データベースに接続しているユーザーが切断するのを待つことはありません。アクティブなトランザクションは暗黙的にロールバックして、接続しているすべてのユーザーを切断します。

データベースを次に起動したときに、インスタンスのリカバリ手順を実行する必要はありません。

関連項目:

Oracle Database 11gドキュメント・ライブラリの『Oracle Database管理者ガイド』

5 ポートの管理

この章では、Oracle WebLogic ServerまたはOracle HTTP Serverによって使用されるポート番号などの、Oracle Fusion Middlewareポート番号の確認および変更方法について説明します。

次の項目が含まれます。

- ポートの管理について

- ポート番号の表示

- Oracle Fusion Middlewareで使用するポート番号の変更

5.1 ポートの管理について

Oracle Fusion Middlewareの多くのコンポーネントやサービスはポートを使用します。ほとんどのポート番号はインストール時に割り当てられます。それらのサービスで使用されるポート番号を認識し、同じポート番号をホスト上の2つのサービスで使用されないようにすることは、管理者として重要です。

一部のポートは、インストール時にポート番号割当てを指定できます。

関連項目:

ポート番号のリストは、付録Cを参照してください。インストール時のポートの割当てを無効にする方法の詳細は、インストレーション・ガイドを参照してください。

5.2 ポート番号の表示

次の項で説明されているように、コマンドラインまたはFusion Middleware Controlを使用して、現在使用中のポート番号を表示できます。

- コマンドラインを使用したポート番号の表示

- Fusion Middleware Controlを使用したポート番号の表示

5.2.1 コマンドラインを使用したポート番号の表示

システム・コンポーネントの現行のポート番号を表示するには、次のコマンドを使用します。

(UNIX) ORACLE_INSTANCE/bin/opmnctl status -l
(Windows) ORACLE_INSTANCE\bin\opmnctl status -l

Oracle WebLogic Serverのポート番号を表示するには、属性を指定してWLSTのgetコマンドを使用します。たとえば、管理ポートを取得するには、次のコマンドを使用します。

wls:/SOA_domain/serverConfig> get('AdministrationPort')
9002

5.2.2 Fusion Middleware Controlを使用したポート番号の表示

Fusion Middleware Controlを使用して、ドメイン、管理サーバー、管理対象サーバー、またはSOAインフラストラクチャやOracle Web Cacheなどのコンポーネントのポート番号を表示できます。

たとえば、ドメインのポートを表示するには、次の手順を実行します。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューで「ポートの使用状況」を選択します。
次の図に示すように、「ポートの使用状況」ページが表示されます。

図ports.gifの説明

オプションで、「表示」から管理対象サーバーを選択することで、表示するポートをフィルタできます。

「ポートの使用状況の詳細」表に、使用されているポート、IPアドレス、コンポーネント、チャネルおよびプロトコルが表示されます。

また、ターゲットにナビゲートしてターゲットのメニューから「ポートの使用状況」を選択すると、管理サーバー、管理対象サーバー、およびSOAインフラストラクチャやOracle Web Cacheなどのコンポーネントについても同様のページを表示できます。

5.3 Oracle Fusion Middlewareで使用するポート番号の変更

Fusion Middleware Control、Oracle WebLogic Server管理コンソールまたはコマンドラインを使用して、一部のOracle Fusion Middlewareコンポーネントのポート番号を変更できます。

注意:

ポート番号は、未使用であるポートの任意のポート番号に変更できます。コンポーネントに割り当てられているポート範囲内のポート番号を使用する必要はありません。割当て済のポート範囲の詳細は、付録Cを参照してください。

この項の項目は次のとおりです。

- Oracle WebLogic Serverリスニング・ポートの変更

- Oracle HTTP Serverリスニング・ポートの変更

- Oracle Web Cacheポートの変更

- OPMNポート(ONS Local、Request、Remote)の変更

- Oracle Portalポートの変更

- Oracle Database Netリスナー・ポートの変更

その他のポートの変更の詳細は、次を参照してください。

- Oracle Internet Directoryのポートの変更に関する詳細は、Oracle Fusion Middleware Oracle Internet Directory管理者ガイドのサーバー・プロパティの構成に関する項またはldapmodifyを使用したシステム構成属性の設定に関する項を参照してください。

- ノード・マネージャ・ポートの変更の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverノード・マネージャ管理者ガイド』のノード・マネージャ構成の概要に関する項を参照してください。

- Oracle Fusion Middleware Oracle Virtual Directory管理者ガイドのOracle Virtual Directoryを構成して権限ポートでリスニングする方法に関する項

関連項目:

ファイアウォールで開くべきポートの詳細は、使用している環境に対する『エンタープライズ・デプロイメント・ガイド』を参照してください。たとえば、『Oracle Fusion Middleware Oracle SOA Suiteエンタープライズ・デプロイメント・ガイド』のファイアウォールとポートに関する項を参照してください。

5.3.1 Oracle WebLogic Serverリスニング・ポートの変更

次の項で説明するように、Oracle WebLogic Server管理コンソールまたはWLSTを使用して、WebLogic Server管理サーバーまたは管理対象サーバーの非SSL(HTTP)リスニング・ポートおよびSSL(HTTPS)リスニング・ポートを変更できます。

- 管理コンソールを使用したOracle WebLogic Serverリスニング・ポートの変更

- WLSTを使用したOracle WebLogic Serverリスニング・ポートの変更

関連項目:

Oracle WebLogic Serverポートの変更の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverサーバー環境の構成』を参照してください。

5.3.1.1 管理コンソールを使用したOracle WebLogic Serverリスニング・ポートの変更

Oracle WebLogic Server管理コンソールを使用して、WebLogic Server管理サーバーまたは管理対象サーバーの非SSL(HTTP)リスニング・ポートおよびSSL(HTTPS)リスニング・ポートを変更する手順は次のとおりです。

1. サーバーにナビゲートします。
「server_nameの設定」ページが表示されます。

2. 「一般」タブで、「リスニング・ポート」または「SSLリスニング・ポート」の数値を変更します。

3. サーバーが稼働中であれば、サーバーを再起動します。

4. 別のコンポーネントがOracle WebLogic Serverリスニング・ポートに依存している場合、これらのコンポーネントを再構成する必要があります。たとえばOracle Portalで、WLS_PORTALとして構成されたOracle WebLogic Serverのリスニング・ポートが変更される場合、Oracle HTTP Serverの構成に応じて従来のポートを指すように変更する必要があります。ポート番号は、次のファイルで変更します。

ORACLE_INSTANCE/OHS/ohs_name/moduleconf/portal.conf

5.3.1.2 WLSTを使用したOracle WebLogic Serverリスニング・ポートの変更

WLSTコマンドラインを使用して、WebLogic Server管理サーバーまたは管理対象サーバーの非SSL(HTTP)リスニング・ポートおよびSSL(HTTPS)リスニング・ポートを変更する手順は次のとおりです。コマンドはオフライン・モードで(サーバーに接続せずに)実行する必要があります。

たとえば、管理サーバーのHTTPリスニング・ポートをポート8001に変更するには、次のWLSTコマンドを使用します。

readDomain("oracle/config/domains/domain_name")
cd("servers/AdminServer")
cmo.setListenPort(8001)
updateDomain()

5.3.2 Oracle HTTP Serverリスニング・ポートの変更

Oracle HTTP Serverリスニング・ポート(非SSLまたはSSL)を変更する場合、通常、設定する必要がある依存関係が存在します。たとえば、Oracle Web Cacheを使用してOracle Fusion Middleware環境のパフォーマンスを向上させている場合は、Oracle HTTP Serverリスニング・ポートを変更すると、Oracle Web Cacheのオリジナル・サーバーの設定も変更する必要があります。

次の各項では、Oracle HTTP ServerのHTTPまたはHTTPSリスニング・ポートを変更する方法について説明します。

- 1024未満に設定されたポート使用時のOracle HTTP Serverのroot実行の有効化(UNIXのみ)

- Oracle HTTP Serverの非SSLリスニング・ポートの変更

- Oracle HTTP ServerのSSLリスニング・ポートの変更

5.3.2.1 1024未満に設定されたポート使用時のOracle HTTP Serverのroot実行の有効化(UNIXのみ)

UNIXシステムでリスニング・ポートを1024未満の番号に変更する場合は、Oracle HTTP Serverのリスニング・ポート番号を変更する前に、次の手順を実行します。

デフォルトでは、Oracle HTTP Serverは非rootユーザー(Oracle Fusion Middlewareをインストールしたユーザー)として実行されます。UNIXシステムでは、Oracle HTTP Serverのリスニング・ポート番号を1024未満の値に変更する場合は、次のようにrootとして実行するようにOracle HTTP Serverを有効にする必要があります。

1. rootとしてログインします。

2. Oracleホームで次のコマンドを実行します。

cd ORACLE_HOME/ohs/bin
chown root .apachectl
chmod 6750 .apachectl

5.3.2.2 Oracle HTTP Serverの非SSLリスニング・ポートの変更

Oracle HTTP Serverの非SSL(HTTP)リスニング・ポートを変更するには、次の作業を実行します。UNIXシステムでリスニング・ポートを1024未満の番号に変更する場合は、最初に第5.3.2.1項の手順を実行する必要があります。

- 作業1:「Oracle HTTP Serverリスニング・ポートの変更」

- 作業2「Oracle Web Cacheの更新」

- 作業3:「システム・コンポーネントの再起動」

作業1   Oracle HTTP Serverリスニング・ポートの変更

Fusion Middleware Controlを使用してOracle HTTP Serverリスニング・ポートを変更するには:

1. ナビゲーション・ペインで、ファームを開き、「Web層」を開いてから、Oracle HTTP Serverインスタンスを選択します。

2. 「Oracle HTTP Server」メニューで、「管理」→「ポート構成」を選択します。

3. HTTPプロトコルを使用するリスニング・ポートを選択して、「編集」をクリックします。

4. ポート番号を変更して、「OK」をクリックします。

5. Oracle HTTP Serverを再起動します。「Oracle HTTP Server」メニューで、「コントロール」→「再起動」を選択します。

作業2   Oracle Web Cacheの更新

Oracle Web Cacheをリバース・プロキシとして使用している場合、Oracle Web Cacheを更新する必要があります。

1. Fusion Middleware Controlのナビゲーション・ペインで、ファームを開いてから、「Web層」を開きます。Oracle Web Cacheインスタンスを選択します。

2. 「Webキャッシュ」メニューで、「管理」→「オリジナル・サーバー」を選択します。

3. ポートが変更されたオリジナル・サーバーを選択し、「編集」をクリックします。
「オリジナル・サーバーの編集」ページが表示されます。

4. 「ポート」フィールドでポート番号を変更します。

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

6. Oracle Web Cacheを再起動します。「Webキャッシュ」メニューで、「コントロール」→「再起動」を選択します。

作業3   システム・コンポーネントの再起動

OPMNとそのOracleインスタンスのすべてのシステム・コンポーネントを再起動します。

opmnctl stopall
opmnctl startall

5.3.2.3 Oracle HTTP ServerのSSLリスニング・ポートの変更

Oracle HTTP ServerのSSL(HTTPS)リスニング・ポートを変更するには、次の作業を実行します。UNIXシステムでリスニング・ポートを1024未満の番号に変更する場合は、第5.3.2.1項の手順を実行する必要があります。

- 作業1:「Oracle HTTP Server SSLリスニング・ポートの変更」

- 作業2「Oracle Web Cacheの更新」

- 作業3:「mod_ossoの再登録」

- 作業4:「システム・コンポーネントの再起動」

作業1   Oracle HTTP Server SSLリスニング・ポートの変更

Fusion Middleware Controlを使用してOracle HTTP Server SSLリスニング・ポートを変更するには:

1. ナビゲーション・ペインで、ファームを開き、「Web層」を開いてから、Oracle HTTP Serverインスタンスを選択します。

2. 「Oracle HTTP Server」メニューで、「管理」→「ポート構成」を選択します。

3. HTTPSプロトコルを使用するリスニング・ポートを選択して、「編集」をクリックします。

4. ポート番号を変更して、「OK」をクリックします。

5. Oracle HTTP Serverを再起動します。「Oracle HTTP Server」メニューで、「コントロール」→「再起動」を選択します。

作業2   Oracle Web Cacheの更新

Oracle Web Cacheをリバース・プロキシとして使用している場合、Oracle Web Cacheを更新する必要があります。

1. Fusion Middleware Controlのナビゲーション・ペインで、ファームを開いてから、「Web層」を開きます。Oracle Web Cacheインスタンスを選択します。

2. 「Webキャッシュ」メニューで、「管理」→「オリジナル・サーバー」を選択します。

3. ポートが変更されたオリジナル・サーバーを選択し、「編集」をクリックします。
「オリジナル・サーバーの編集」ページが表示されます。

4. 「ポート」フィールドでポート番号を変更します。

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

6. Oracle Web Cacheを再起動します。「Webキャッシュ」メニューで、「コントロール」→「再起動」を選択します。

作業3:   mod_ossoの再登録

Oracle Single Sign-Onを使用している場合、リリース10.1.4.3を使用する必要があります。Oracle Single Sign-On認証を有効にした場合(つまり、mod_ossoを登録した場合)、mod_ossoを再登録する手順は次のとおりです。

1. Oracle Single Sign-Onホストで、ORACLE_HOMEおよびORACLE_SID環境変数を設定します。

2. Oracle Single Sign-Onホストで、-remote_midtierオプションを使用してssoregスクリプトを実行します。このスクリプトは、次の場所にあります。

(UNIX) ORACLE_HOME/sso/bin/ssoreg.sh
(Windows)ORACLE_HOME\sso\bin\ssoreg.bat

たとえばLinuxでは、次のように指定します。

$ORACLE_HOME/sso/bin/ssoreg.sh -oracle_home_path $ORACLE_HOME
-config_mod_osso TRUE
-site_name example.com:7778
-remote_midtier
-config_file $ORACLE_HOME/Apache/Apache/conf/osso/myosso.conf
-mod_osso_url http://example.com:7778

作成される構成ファイル(この例ではmyosso.conf)は、不明瞭化されたosso構成ファイルです。

3. 不明瞭化されたosso構成ファイルをOracle HTTP Serverホストのmoduleconfディレクトリにコピーして、編集します。

ORACLE_INSTANCE/config/OHS/ohs_name/moduleconf

作業4   システム・コンポーネントの再起動

OPMNとそのOracleインスタンスのシステム・コンポーネントを再起動します。

opmnctl stopall
opmnctl startall

5.3.3 Oracle Web Cacheポートの変更

Fusion Middleware Controlを使用して、Oracle Web CacheのHTTPおよびHTTPSリスニング・ポート、管理ポート、統計ポートおよび無効化ポートを変更できます。

ポート番号を変更する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開き、「Web層」を開いてから、Oracle Web Cacheインスタンスを選択します。

2. 「Webキャッシュ」メニューで、「管理」→「ポート構成」を選択します。

3. ポートを選択し、「編集」をクリックします。

4. ポート番号を変更して、「OK」をクリックします。

5. Oracle Web Cacheを再起動します。「Webキャッシュ」メニューで、「コントロール」→「再起動」を選択します。

6. Web Cache無効化ポートを再構成してOracle Portalを使用する場合、第5.3.5.2項で説明しているように、Oracle Portalで保守されているポート情報を更新する必要があります。

注意:

Oracle Web Cacheをrootとして起動するように構成するには、『Oracle Fusion Middleware for Oracle Web Cache管理者ガイド』のルート権限でのwebcachedの実行に関する説明を参照してください。

5.3.4 OPMNポート(ONS Local、Request、Remote)の変更

この項では、次のポート番号を変更する方法について説明します。

- ONS Localポート

- ONS Requestポート

- ONS Remoteポート

これらのポートを変更する手順は次のとおりです。

1. OPMNおよびOPMNが管理するすべてのプロセスを停止します。

(UNIX) ORACLE_INSTANCE/bin/opmnctl stopall
(Windows)ORACLE_INSTANCE\bin\opmnctl stopall

2. opmn.xmlファイルを開きます。

(UNIX) ORACLE_INSTANCE/config/OPMN/opmn
(Windows) ORACLE_INSTANCE\config\OPMN\opmn

3. <notification-server>要素で、変更するポートに応じて<port>要素のlocal、remoteまたはrequestパラメータを変更し、ファイルを保存します。
次に例を示します。

<port local="6101" remote="6201" request="6004"/>

4. OPMNおよびOPMNが管理するすべてのプロセスを起動します。

(UNIX) ORACLE_INSTANCE/bin/opmnctl startall
(Windows) ORACLE_INSTANCE\bin\opmnctl startall

5. Fusion Middleware Controlを使用して管理できるように、Oracle WebLogic Server管理サーバーにこのインスタンスが登録されている場合、ONSポートを変更すると、Fusion Middleware Controlを使用してインスタンスの起動や停止ができません。管理サーバーでインスタンスの登録を解除してから再登録する必要があります。

1. インスタンスの登録を解除します。

ORACLE_INSTANCE/bin/opmnctl unregisterinstance -instanceName instance_name
-adminHost hostname
-adminPort weblogic_port
-adminUsername weblogic_admin

2. インスタンスを登録します。

ORACLE_INSTANCE/bin/opmnctl registerinstance -instanceName instance_name
-adminHost hostname
-adminPort weblogic_port
-adminUsername weblogic_admin
-adminPasswordFile 'file_with_weblogic_admin_password'

「Fusion Middleware Control」ページをリフレッシュして、インスタンスの起動や停止ができます。

5.3.5 Oracle Portalポートの変更

Oracle Portalでは、その基礎となるコンポーネントで使用される一部のポートに関する情報を保守します。この項では、Oracle Portalポートを管理する方法について説明します。次の項目が含まれます。

- Oracle Portal中間層ポートの変更

- Oracle PortalのOracle Web Cache無効化ポートの変更

- Oracle PortalのOracle Internet Directoryポートの変更

- PPEループバック・ポートの変更

- Oracle Portal SQL*Netリスナー・ポートの変更

- WLS_PORTAL管理対象サーバーの再起動

注意:

この項で説明されているようにこれらのポートを変更する場合、Oracle Portal構成のみが更新されます。Oracle Web CacheやOracle Internet Directoryなどの基礎となるコンポーネントのポート番号を更新または変更する場合、それぞれのコンポーネントのドキュメントを参照してポートの管理について調べてください。

この項で説明されている構成手順では、WLS_PORTAL管理対象サーバーを再起動する必要があります。

5.3.5.1 Oracle Portal中間層ポートの変更

デフォルトのインストールの場合、8090などのOracle Web Cacheポートを介してOracle Portalにアクセスします。このポートをOracle Portal中間層ポートといいます。Oracle Web Cacheを別のポートでリスニングするように構成する場合、またはOracle Web Cacheのフロントエンドにプロキシまたはロード・バランシング・ルーター(LBR)を配置する場合、このポートを更新する必要があります。

Fusion Middleware Controlを使用してOracle Portal中間層ポートを変更するには:

1. ナビゲーション・ペインでファームを開いてから、「ポータル」を選択し、Portalインスタンスを選択します。

2. 「ポータル」メニューから、「設定」→「ワイヤ構成」を選択します。

3. 「portal」などのデータベース・アクセス記述子を選択します。

4. 「ポータル中間層」セクションを開きます。

5. ポート番号を変更して、「適用」をクリックします。

6. WLS_PORTAL管理対象サーバーを再起動します。詳細は、第5.3.5.6項を参照してください。

5.3.5.2 Oracle PortalのOracle Web Cache無効化ポートの変更

Oracle Portalでは、Oracle Web Cacheでコンテンツをキャッシュしています。コンテンツが変更されると、Oracle Portalはそのようなキャッシュされたコンテンツを無効化してOracle Web Cache無効化ポートを保持します。Web Cache無効化ポートを再構成する場合、Oracle Portalで保持されるポート情報を更新する必要があります。

Fusion Middleware Controlを使用してOracle Portal無効化ポートを変更するには:

1. ナビゲーション・ペインでファームを開いてから、「ポータル」を選択し、Portalインスタンスを選択します。

2. 「ポータル」メニューから、「設定」→「ワイヤ構成」を選択します。

3. 「portal」などのデータベース・アクセス記述子を選択します。

4. 「Webキャッシュ」セクションを開きます。

5. 無効化ポート番号を変更します。無効化のユーザー名とパスワードが空白の場合、ユーザー名とパスワードを入力します。

注意:

ここで入力するポート番号、無効化ユーザー名、無効化パスワードは、Oracle Portalで使用されるOracle Web Cacheインスタンスの対応する値と一致させる必要があります。これらの値のリセットの詳細は、Oracle Fusion Middleware Oracle Web Cache管理者ガイドを参照してください。

6. 「適用」をクリックします。

7. WLS_PORTAL管理対象サーバーを再起動します。詳細は、第5.3.5.6項を参照してください。

5.3.5.3 Oracle PortalのOracle Internet Directoryポートの変更

Oracle Portalでは、Oracle Internet Directoryポートに関する情報を保守します。

Fusion Middleware Controlを使用してOracle Portal Oracle Internet Directory(OID)ポートを変更するには:

1. ナビゲーション・ペインでファームを開いてから、「ポータル」を選択します。Portalインスタンスを選択します。

2. 「ポータル」メニューから、「設定」→「ワイヤ構成」を選択します。

3. 「portal」などのデータベース・アクセス記述子を選択します。

4. 「OID」セクションを開きます。

5. ポート番号を変更します。

6. Oracle Internet Directoryのユーザー名とパスワードを入力します。

7. 「適用」をクリックします。

8. WLS_PORTAL管理対象サーバーを再起動します。詳細は、第5.3.5.6項を参照してください。

5.3.5.4 PPEループバック・ポートの変更

「ポータル」ページのサービス時に、Oracle Portalはデフォルト・サイト・ポートを使用してループバック・コールを行います。外部SSLなどの一部の構成では、デフォルト・サイト・ポート以外のポートにループバック・コールを構成する必要があります。

Fusion Middleware Controlを使用してPPEループバック・ポートを変更する手順は次のとおりです。

1. ナビゲーション・ペインでファームを開いてから、「ポータル」を選択し、Portalインスタンスを選択します。

2. 「ポータル」メニューから、「設定」→「ページ・エンジン」を選択します。

3. 「拡張プロパティ」セクションを開きます。

4. 「ポートの使用」でポート番号を変更します。

5. プロトコルの使用フィールドでプロトコルを指定します。

6. 「適用」をクリックします。

7. WLS_PORTAL管理対象サーバーを再起動します。詳細は、第5.3.5.6項を参照してください。

5.3.5.5 Oracle Portal SQL*Netリスナー・ポートの変更

Oracle Portalでは、(portal_dads.confという名前のファイルにある)データベース・アクセス記述子内のhost:port:servicename形式のリポジトリ接続に関する情報を保守します。SQL*Netリスナーを別のポートでリスニングするように構成する場合、Oracle Portalでこのポート値を再構成する必要があります。Fusion Middleware ControlでOracle Portal SQL*Netリスナー・ポートを変更する手順は次のとおりです。

1. ナビゲーション・ペインでファームを開いてから、「ポータル」を選択し、Portalインスタンスを選択します。

2. 「ポータル」メニューから、「設定」→「データベース・アクセス記述子」を選択します。

3. 「/pls/portal」などのデータベース・アクセス記述子を選択します。

4. 「編集」をクリックします。

5. 「ポータル・データベース・アクセス詳細」セクションを開きます。

6. 「データベース接続文字列」フィールドを更新して、新しいポートを反映させます。

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

8. WLS_PORTAL管理対象サーバーを再起動します。詳細は、第5.3.5.6項を参照してください。

5.3.5.6 WLS_PORTAL管理対象サーバーの再起動

Fusion Middleware ControlでWLS_PORTAL管理対象サーバーを再起動するには:

1. 「Farm_ClassicDomain」などのFarmドメインを開きます。

2. WebLogicドメインを開きます。

3. 「Classic Domain」などのドメインを開きます。

4. 必要に応じて「cluster_portal」を開きます。

5. 「WLS_PORTAL」を選択します。

6. WLS_PORTALの「WebLogic Server」メニューで「制御」→「停止」を選択します。WLS_PORTALのステータスが「停止中」であることを確認します。

7. WLS_PORTALの「WebLogic Server」メニューで「制御」→「起動」を選択します。WLS_PORTALのステータスが「稼働中」であることを確認します。

5.3.6 Oracle Database Netリスナー・ポートの変更

環境にメタデータ・リポジトリとして機能するOracle Databaseが含まれるときに、そのデータベースのリスナー・ポート番号を変更する場合は、この項で説明する手順を実行します。

最初に、リスナー・ポート番号の変更が必要かどうかを判断します。ホスト上に同じポートを使用する別のデータベースがある場合でも、両方のデータベースで同じポートを使用できます。

複数のOracle Database 10gおよびOracle Database 11gデータベースで、同じOracle Netリスナー・ポートを共有できます。メタデータ・リポジトリとしてOracle Databaseを使用しているホストに別のOracle Database 10gまたはOracle Database 11gデータベースが含まれる場合、それらはすべてポート1521を使用できます。リスナー・ポート番号を変更する必要はありません。

注意:

ホスト上で同じキー値を使用する2つのリスナーを実行する場合は、第5.3.6.1項「IPCリスナーのKEY値の変更」を参照してください。

メタデータ・リポジトリには、様々な使用方法があります。次の表を参照して、各自の使用方法に応じた変更手順を実行してください。

Metadata Repositoryの使用方法

Oracle Netリスナー・ポートの変更に必要な作業

ID管理リポジトリおよび製品メタデータ・リポジトリ

作業1:「コンポーネントの停止」

作業2:「メタデータ・リポジトリのOracle Netリスナー・ポートの変更」

作業3:「システム・データソースの変更」

作業4:「Oracle Internet Directoryの更新」

作業5:「Oracle Single Sign-On 10gの更新」

作業6:「Oracle Portalの更新」

作業7:「その他のコンポーネントの更新」

ID管理リポジトリのみ

作業1:「コンポーネントの停止」

作業2:「メタデータ・リポジトリのOracle Netリスナー・ポートの変更」

作業4:「Oracle Internet Directoryの更新」

作業5:「Oracle Single Sign-On 10gの更新」

製品メタデータ・リポジトリ

作業1:「コンポーネントの停止」

作業2:「メタデータ・リポジトリのOracle Netリスナー・ポートの変更」

作業3:「システム・データソースの変更」

作業4:「Oracle Internet Directoryの更新」

作業6:「Oracle Portalの更新」

作業7:「その他のコンポーネントの更新」

この手順は、次のタスクで構成されます。

- 作業1:「コンポーネントの停止」

- 作業2:「メタデータ・リポジトリのOracle Netリスナー・ポートの変更」

- 作業3:「システム・データソースの変更」

- 作業4:「Oracle Internet Directoryの更新」

- 作業5:「Oracle Single Sign-On 10gの更新」

- 作業6:「Oracle Portalの更新」

- 作業7:「その他のコンポーネントの更新」

作業1:   コンポーネントの停止

Metadata Repositoryを使用するすべてのコンポーネントを停止します。手順は、第4章を参照してください。

作業2:   メタデータ・リポジトリのOracle Netリスナー・ポートの変更

メタデータ・リポジトリ・ホストで、次の手順を実行します。

1. ORACLE_HOMEおよびORACLE_SID環境変数が設定されていることを確認します。

2. メタデータ・リポジトリ・リスナーを停止します。

lsnrctl stop

3. 次の場所にあるlistener.oraファイルを編集します。

(UNIX) ORACLE_HOME/network/admin/listener.ora
(Windows) ORACLE_HOME\network\admin\listener.ora

LISTENERエントリの下にあるPORTの値を更新します。ファイルを保存します。

4. tnsnames.oraファイルを編集します。デフォルトの場所は次のとおりです。

(UNIX) ORACLE_HOME/network/admin/tnsnames.ora
(Windows) ORACLE_HOME\network\admin\tnsnames.ora

ファイルに次の変更を加えます。

1. MDSリポジトリに適用する各エントリでPORT値を更新します。

2. 次のようなエントリを追加します。

newnetport =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = tcp) (HOST = hostname) (PORT = port)))

この例で、hostnameは完全修飾のホスト名、portは新しいポート番号です。

5. メタデータ・リポジトリ・リスナーを起動します。

lsnrctl start

6. SQL*Plusを使用して、SYSDBA権限を持つSYSTEMユーザーとしてメタデータ・リポジトリにログインし、次のコマンドを実行します。

SQL> ALTER SYSTEM SET local_listener='newnetport' scope=spfile;

7. SQL*Plusを使用して、メタデータ・リポジトリを再起動します。

SQL> SHUTDOWN
SQL> STARTUP

8. Oracle Internet Directoryを起動します。

opmnctl start
opmnctl startproc ias-component=OID

作業3:   システム・データソースの変更

メタデータ・リポジトリに新しいポート番号を使用するようにシステム・データソースを変更します。そのためには、Oracle WebLogic Server管理コンソールを使用します。

1. チェンジ・センターで、「ロックして編集」をクリックします。

2. 「ドメイン構造」セクションで、「サービス」を開き、「データソース」を選択します。
「JDBCデータ・ソースのサマリー」ページが表示されます。

3. 変更するデータソースを選択します。
「設定」ページが表示されます。

4. 「接続プール」タブを選択します。

5. データベース・ポートを変更するには、「URL」フィールドを変更します。次に例を示します。

jdbc:oracle:thin:@hostname.domainname.com:1522/orcl

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

7. このデータソースを使用するサーバーを再起動します。(「ターゲット」タブをクリックし、このデータソースを使用するサーバーを表示します)。

作業4:   Oracle Internet Directoryの更新

Identity Managementホストで、Oracle Internet Directoryを新しいOracle Netリスナー・ポート番号によって更新します。

1. tnsnames.oraファイル内のポート番号を更新します。このファイルは、次のディレクトリにあります。

(UNIX) ORACLE_INSTANCE/config
(Windows) ORACLE_INSTANCE\config

2. 次の例に示すように、opmnctl updatecomponentregistrationコマンドで新しいポート番号を指定して、管理サーバーでコンポーネントの登録を更新します。

opmnctl updatecomponentregistration -Db_info DBHostName:TNSPORT:DBSERVICENAME
-componentName oid1 -componentType OID

3. Oracle Internet DirectoryのOracleホームでOPMNとOracleインスタンスのすべてのプロセスを起動します。

opmnctl startall

作業5:   Oracle Single Sign-On 10gの更新

Oracle Single Sign-On 10gを使用している場合、Oracle Single Sign-OnのOracleホームから次の手順を実行します。

1. UNIXシステムの場合は、LD_LIBRARY_PATH、LD_LIBRARY_PATH_64、LIB_PATH、またはSHLIB_PATH環境変数を、表3-1に示されている適切な値に設定します。実際に設定が必要な環境変数および値は、UNIXオペレーティング・システムのタイプによって異なります。

2. 次のコマンドを実行して、新しいリポジトリ・ポート番号でOracle Single Sign-Onを更新します。

- UNIXの場合:

$ORACLE_HOME/jdk/bin/java -jar $ORACLE_HOME/sso/lib/ossoca.jar reassoc -repos $ORACLE_HOME

- Windowsの場合:

%ORACLE_HOME%\jdk\bin\java -jar %ORACLE_HOME%\sso\lib\ossoca.jar reassoc -repos %ORACLE_HOME%

作業6:   Oracle Portalの更新

Oracle Portalを更新するには、第5.3.5.5項の手順を実行します。

作業7:   その他のコンポーネントの更新

メタデータ・リポジトリを使用している各Oracleインスタンスで、次の手順を実行します。

1. 次のファイルを新しいOracle Netリスナー・ポート番号で更新します。

(UNIX) ORACLE_INSTANCE/config/tnsnames.ora
(Windows) ORACLE_INSTANCE\config\tnsnames.ora

2. 次のファイルを確認します。

(UNIX) ORACLE_HOME/ohs/conf/dads.conf
(Windows) ORACLE_HOME\ohs\modplsql\conf\dads.conf

PlsqlDatabaseConnectStringで始まる行を探します。

- その行がServiceNameFormatまたはSIDFormatで終わる場合は、その行を新しいMDSリポジトリのポート番号で更新し、ファイルを保存してOracle HTTP Serverを再起動します。

- その行がNetServiceNameFormatで終わる場合は、何もする必要ありません。

3. 第4.3項で説明されているように、メタデータ・リポジトリを使用するコンポーネントを起動します。

5.3.6.1 IPCリスナーのKEY値の変更

2つのリスナーのIPCプロトコル・アドレスに同じKEY値の使用が構成されている場合は、それらを同時に実行できません。デフォルトでは、メタデータ・リポジトリ・リスナーのIPC KEY値はEXTPROCに設定されます。したがって、EXTPROCキーを使用するIPCリスナーが他にもある場合は、EXTPROC1などの別のキー値を使用するようにメタデータ・リポジトリ・リスナーを構成する必要があります。

IPCリスナーのKEY値を変更する手順は次のとおりです。

1. リスナーを停止します(ORACLE_HOME環境変数が最初に設定されていることを確認します)。

lsnrctl stop

2. listener.oraおよびtnsnames.oraファイルを編集します。各ファイルで、次の行を探します。

(ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC))

この行を次のように変更します。

(ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1))

3. リスナーを再起動します。

lsnrctl start

第III部

Secure Sockets Layer

この部では、Secure Sockets Layer (SSL)を使用してOracle Fusion Middlewareコンポーネント間の通信を保護する方法、およびOracle Fusion Middlewareセキュリティ機能を使用してキーストア、ウォレットおよび証明書を管理する方法について説明します。

第III部は、次の章で構成されています。

- 第6章「Oracle Fusion MiddlewareでのSSLの構成」

- 第7章「SSL自動化ツールの使用」

- 第8章「キーストア、ウォレットおよび証明書の管理」

6 Oracle Fusion MiddlewareでのSSLの構成

SSLを使用してOracle Fusion Middlewareコンポーネント間の通信を保護するように、Oracle Fusion Middlewareを構成できます。SSLは、通信を保護するための業界標準です。Oracle Fusion MiddlewareではSSLバージョン3に加えて、TLSバージョン1をサポートしています。

注意:

SSLバージョン2は、セキュリティ上の問題があるため、11g リリース1(11.1.1)ではサポートされていません。11g リリース1(11.1.1)より前にSSLバージョン2を使用していたコンポーネントまたはアプリケーションは、他のSSLバージョン(SSLバージョン3およびTLSバージョン1)を使用するように自動的にアップグレードされます。

関連項目:

第7章「SSL自動化ツールの使用」。SSL自動化ツールを使用すると、ドメイン固有のCAを使用して複数のコンポーネントにSSLを構成できます。

この章では、SSLの概要と、Oracle Fusion MiddlewareコンポーネントおよびアプリケーションでSSLを使用する方法について説明します。これらの項目が含まれます。

- SSLのしくみ

- Oracle Fusion MiddlewareにおけるSSLについて

- 構成ツールでのSSLの構成

- Web層でのSSLの構成

- 中間層でのSSLの構成

- データ層でのSSLの構成

- 高度なSSLの使用事例

- SSLのベスト・プラクティス

- SSL関連のWLSTリファレンス

注意:

Oracle WebLogic Server内でSSL接続を構成する場合、ここでの手順を実行するかわりに、この章で紹介しているOracle WebLogic Serverの関連ドキュメントを参照してください。

6.1 SSLのしくみ

この項では、基本的なSSLの概念について説明します。これらの項目が含まれます。

- SSLの機能

- 秘密鍵と公開鍵の暗号化について

- キーストアおよびウォレット

- SSLセッションのしくみ

6.1.1 SSLの機能

SSLは、メッセージの暗号化、整合性および認証を提供することで、通信を保護します。SSL標準により、関係するコンポーネント(ブラウザやHTTPサーバーなど)は、どの暗号化、認証および整合性メカニズムを使用するかのネゴシエーションができます。

- 暗号化を行うと、正当な受信者のみがメッセージを読むことができ機密が保持されます。SSLでは、様々な暗号化アルゴリズムを使用してメッセージを暗号化できます。各SSLセッションの開始時に行われるSSLハンドシェイク中、クライアントとサーバーは、どのアルゴリズムを使用するかのネゴシエーションを行います。SSLがサポートしている暗号化アルゴリズムには、AES、RC4、3DESなどがあります。

- 整合性により、クライアントが送信したメッセージが改ざんされずに正当なサーバーに届きます。メッセージの整合性を確保するために、クライアントはハッシュ機能を使用してメッセージをダイジェストにハッシュし、このメッセージ・ダイジェストをサーバーに送信します。サーバーは、さらにこのメッセージをダイジェストにハッシュし、これらのダイジェストを比較します。SSLでは、2つの異なるメッセージから同じダイジェストをコンピュータで生成するのが不可能なハッシュ機能を使用しているため、サーバーでは2つのダイジェストが一致しない場合には、何者かによりメッセージが改ざんされたと見なすことができます。SSLがサポートしているハッシュ機能の1つに、SHA1があります。

- 認証を使用すると、サーバーとクライアントは互いに相手の身元を確認できます。クライアントがSSLセッションを開始すると、サーバーは通常、サーバー自身の証明書をクライアントに送信します。証明書とは、VeriSignなどの信頼できる認証局によって発行されるデジタルIDです。第8章「キーストア、ウォレットおよび証明書の管理」では、証明書について詳細に説明しています。
クライアントは、サーバー証明書内の証明連鎖を検証することで、サーバーが本物であることを確認します。サーバー証明書は、サーバー証明書に署名した認証局(CA)により保証されています。

また、サーバーがクライアントの識別を認証する必要がある場合には、サーバーがクライアントに証明書の所持を要求することもできます。

6.1.2 秘密鍵と公開鍵の暗号化について

メッセージの整合性、認証および暗号化を提供するために、SSLでは秘密鍵と公開鍵の両方の暗号化を使用します。

秘密鍵の暗号化

対称鍵の暗号化では、通信を保護する目的で2者以上が共有する1つの秘密鍵が必要です。この鍵は、当事者間で送信された安全なメッセージを暗号化および復号化するために使用します。これを行うには、安全な方法で各当事者に鍵を事前に配布しておく必要があります。この方法における問題点は、鍵を安全に転送し、格納することが困難なことです。

SSLでは、各当事者は互いに認識している乱数を使用して秘密鍵を個別に計算します。次に、その秘密鍵を使用して暗号化したメッセージを送信します。

公開鍵の暗号化

公開鍵の暗号化による公開鍵/秘密鍵のペアおよび鍵配布のための安全な方法を採用することで、この問題は解決します。対応する秘密鍵の所有者のみが復号化できるメッセージは、自由に使用できる公開鍵によって暗号化できます。秘密鍵は、その他のセキュリティ資格証明とともに、Oracleウォレットなどの暗号化されたコンテナに安全に格納されます。

公開鍵のアルゴリズムでは、メッセージの秘密は保証されますが、安全な通信は必ずしも保証されません。その理由は、通信者間の識別が検証されないためです。安全な通信を確立するには、メッセージの暗号化に使用される公開鍵が相手の受信者に実際に属していることを確認することが重要です。そうしないと、第三者が通信を傍受し、公開鍵のリクエストに割り込み、正当な鍵を独自の公開鍵に置き換えることが可能になります(介在者攻撃)。

このような攻撃を避けるためには、公開鍵の所有者を確認する必要があります。これは認証と呼ばれるプロセスです。認証は、認証局(CA)を介して行うことができます。CAは、両通信者間によって信頼されている第三者です。

CAは、エンティティの名前、公開鍵および他のセキュリティ資格証明を含む公開鍵証明書を発行します。通常、このような資格証明には、CA名、CAの署名および証明書の有効日(開始日、終了日)が含まれています。

CAでは独自の秘密鍵を使用してメッセージを暗号化します。一方、そのメッセージの復号化には公開鍵が使用されるため、メッセージがCAによって暗号化されたものであるかどうかが確認されます。CA公開鍵は広く一般に知られているため、アクセスするたびに認証する必要はありません。このようなCA公開鍵はウォレットに格納されます。

6.1.3 キーストアおよびウォレット

Oracle Fusion Middlewareでは、ほとんどのコンポーネントで記憶域メカニズムとしてOracleウォレットが使用されます。Oracleウォレットは、証明書、信頼できる証明書、証明書リクエスト、秘密鍵などの資格証明を格納するコンテナです。Oracle Internet DirectoryなどのLDAPディレクトリやファイル・システムにOracleウォレットを格納できます。Oracleウォレットは、パスワードで保護することも自動ログインにもできます。

Oracleウォレットを使用するコンポーネントは次のとおりです。

- Oracle HTTP Server

- Oracle Web Cache

- Oracle Internet Directory

これらのコンポーネントでのSSLの構成では、Oracleウォレットを設定および使用する必要があります。

Oracle Virtual Directoryなどのコンポーネントでは、JKSキーストアを使用して鍵および証明書を保存します。そのためOracle Virtual DirectoryでのSSLの構成では、JKSキーストアを設定および使用する必要があります。

キーストアおよびウォレットの構成の詳細は、次を参照してください。

- Oracle Fusion Middlewareでのキーストアおよびウォレットの詳細は、第6.2項「Oracle Fusion MiddlewareにおけるSSLについて」を参照してください。

- これらの用語および管理作業の詳細は、第8章「キーストア、ウォレットおよび証明書の管理」を参照してください。

6.1.4 SSLセッションのしくみ

SSLプロトコルには、ハンドシェイク・フェーズとデータ転送フェーズという2つのフェーズがあります。ハンドシェイク・フェーズでは、サーバーおよびオプションでクライアントを認証し、データ転送フェーズで転送されるデータを保護するための暗号化鍵を設定します。

クライアントがサーバーへのSSL接続を要求すると、クライアントとサーバーはまずハンドシェイク・フェーズでメッセージを交換します(一般的なシナリオとしては、http://ではなくhttps://プロトコルを使用して、サーバーからページを要求するブラウザがあります。HTTPSプロトコルは、HTTPでSSLを使用することを示します)。

図6-1に、Webサーバーとブラウザ間の一般的なSSL接続用ハンドシェイク・メッセージを示します。この図では次の手順を示しています。

1. クライアントは、サーバーにハロー・メッセージを送信します。
メッセージには、クライアントがサポートしているアルゴリズムの一覧および鍵を生成するための乱数が含まれています。

2. サーバーは、クライアントにハロー・メッセージを送信してレスポンスを返します。このメッセージには、次の内容が含まれています。

- 使用するアルゴリズム。これは、クライアントが送信した一覧から、サーバーによって選択されます。

- 鍵の生成に使用する乱数。

3. サーバーは、クライアントに証明書を送信します。

4. クライアントは、サーバーの証明書の妥当性、発行者CAおよびオプションでサーバーのホスト名がサブジェクトDNと一致するかどうかをチェックして、サーバーを認証します。クライアントはセッション・キャッシュのセッションIDを送信します。

5. クライアントが乱数(プリマスタ・シークレット)を生成し、サーバーの公開鍵を使用して暗号化し、サーバーに送信します。

6. サーバーは、秘密鍵を使用してメッセージを復号化し、プリマスタ・シークレットを取得します。

7. クライアントとサーバーは、SSLセッションで使用される鍵を個別に計算します。
これらの鍵は、互いに認識しているプリマスタ・シークレットと乱数に基づいて計算されるため、それぞれの相手には送信されません。鍵には次の内容が含まれています。

- クライアントがサーバーへの送信前にデータを暗号化するために使用する暗号化鍵

- サーバーがクライアントへの送信前にデータを暗号化するために使用する暗号化鍵

- クライアントがデータのメッセージ・ダイジェストを作成するために使用する鍵

- サーバーがデータのメッセージ・ダイジェストを作成するために使用する鍵

暗号化鍵は、対称的です。つまり、データの暗号化と復号化には同じ鍵が使用されます。

8. クライアントとサーバーは、相互にFinishedメッセージを送信します。これらは前の手順で生成した鍵を使用して送信される最初のメッセージ(最初の安全なメッセージ)です。
Finishedメッセージには、各当事者が送信した以前のハンドシェイク・メッセージがすべて含まれています。各当事者は、受信した以前のメッセージが、Finishedメッセージに含まれているメッセージに一致するかどうかを確認します。これは、ハンドシェイク・メッセージが改ざんされていないことを確認するためです。

9. クライアントとサーバーは、暗号化鍵とハッシュ鍵およびアルゴリズムを使用してデータを転送します。

図6-1 SSLハンドシェイク

「図6-1 SSLハンドシェイク」の説明

6.2 Oracle Fusion MiddlewareにおけるSSLについて

この項では、Oracle Fusion MiddlewareにおけるSSLについて説明します。これらの項目が含まれます。

- Oracle Fusion MiddlewareアーキテクチャにおけるSSL

- キーストアおよびOracleウォレット

- 認証モード

- SSL構成用ツール

6.2.1 Oracle Fusion MiddlewareアーキテクチャにおけるSSL

図6-2 Oracle Fusion MiddlewareにおけるSSL

「図6-2 Oracle Fusion MiddlewareにおけるSSL」の説明

注意:

- 図6-2の「Oracle Enterprise Manager」は、Fusion Middleware Controlのユーザー・インタフェースを指します。

- opmnなどのその他の管理ツールは、特定のタスクで使用できます。

図6-2で示されるOracle Fusion Middlewareアーキテクチャにおいて、丸付きの番号はSSLを有効にできるエンドポイントを表します。それぞれのエンドポイントの構成の詳細は、次の項目を参照してください。

1. 第6.4.2.1項「Fusion Middleware Controlを使用したOracle Web CacheでのインバウンドSSLの有効化」および第6.4.2.2項「WLSTを使用したOracle Web CacheでのインバウンドSSLの有効化」

2. 第6.4.2.3項「Fusion Middleware Controlを使用したOracle Web CacheでのアウトバウンドSSLの有効化」および第6.4.2.4項「WLSTを使用したOracle Web CacheからのアウトバウンドSSLのウォレットの指定」

3. 第6.4.3.1項「Fusion Middleware Controlを使用したOracle HTTP Server仮想ホストへのインバウンド・リクエストでのSSLの有効化」および第6.4.3.2項「WLSTを使用したOracle HTTP Server仮想ホストへのインバウンド・リクエストでのSSLの有効化」

4. 第6.4.3.3項「Oracle HTTP Serverからのアウトバウンド・リクエストでのSSLの有効化」

5. 第6.5.1.1項「Oracle WebLogic ServerへのインバウンドSSL」

6. LDAPサーバーへのアウトバウンド接続は、Oracle Platform Security ServicesまたはOracle WebLogic Serverから発生します。

1. 第6.5.1.2.1項「Oracle Platform Security ServicesからのLDAPへのアウトバウンドSSL」

2. 第6.5.1.2.3項「LDAP認証プロバイダからのLDAPへのアウトバウンドSSL」

7. 第6.6.1.1項「Fusion Middleware Controlを使用したOracle Internet DirectoryリスナーでのインバウンドSSLの有効化」および第6.6.1.2項「WLSTを使用したOracle Internet DirectoryリスナーでのインバウンドSSLの有効化」

8. 第6.6.3.2項「データソースでのSSLの有効化」

9. 第6.6.3.1項「Oracle DatabaseでのSSLの有効化」

10. 第6.5.6項「アプリケーションのクライアント側のSSL」

11. 第6.5.2項「Oracle SOA SuiteでのSSLの構成」

12. 第6.5.3項「Oracle WebCenter PortalのSSLの構成」

13. 第6.3.3項「WLSTコマンドライン・ツール」

14. 第6.6.1.3項「Oracle Internet DirectoryからOracle DatabaseへのアウトバウンドSSLの有効化」

15. 第6.6.3.1項「Oracle DatabaseでのSSLの有効化」

また、アイデンティティ管理コンポーネントでSSLを構成することもできます。詳細は、次の項目を参照してください。

- 第6.5.4.1項「Oracle Directory Integration PlatformでのSSLの構成」

- 第6.5.4.2項「Oracle Identity FederationでのSSLの構成」

- 第6.5.4.3項「Oracle Directory Services ManagerでのSSLの構成」

キーストアおよびウォレット

キーストアおよびウォレットはSSL構成の中心となり、これらを使用して証明書および鍵を保存します。

詳細は、第6.2.2項「キーストアおよびOracleウォレット」を参照してください。

6.2.2 キーストアおよびOracleウォレット

Oracle Fusion Middlewareでは、鍵と証明書の2つのタイプのキーストアをサポートしています。

- JKSベースのキーストアとトラストストア

- Oracleウォレット

11g リリース1(11.1.1)では、すべてのJavaコンポーネントおよびアプリケーションはJKSキーストアを使用します。このように、Oracle WebLogic Server上で稼働するすべてのJavaコンポーネントおよびアプリケーションは、JKSベースのキーストアおよびトラストストアを使用します。

次のシステム・コンポーネントでは、引き続きOracleウォレットを使用します。

- Oracle HTTP Server

- Oracle Web Cache

- Oracle Internet Directory

Fusion Middleware ControlまたはコマンドラインWLSTおよびorapkiインタフェースを使用して、これらのシステム・コンポーネントのウォレットとその証明書を管理できます。Fusion Middleware ControlまたはWLSTのいずれかを使用して、これらのコンポーネントのリスナーでSSLを有効化できます。

Oracle Virtual DirectoryはJKSベースのキーストアを使用します。Fusion Middleware ControlまたはWLSTを使用して、Oracle Virtual DirectoryのJKSキーストアとその証明書を管理できます。Fusion Middleware ControlまたはWLSTのいずれかを使用して、Oracle Virtual DirectoryのリスナーでSSLを有効化できます。

JDKのkeytoolユーティリティでは、Java EEアプリケーションのOracle WebLogic Serverリスナーが使用するキーストアを管理します。このユーティリティがこれらのキーストアを管理する唯一のキーストア・ツールになります。これを実行するためのグラフィカル・ユーザー・インタフェースはありません。

これらのストアのタイプ、およびどのストアのタイプをいつ使用するかについては、第6.1.3項「キーストアおよびウォレット」を参照してください。

関連項目:

キーストアの管理は、Oracle Fusion Middlewareにおける鍵と証明書の格納に関する項を参照してください。

6.2.3 認証モード

サポートされている認証モードは、次のとおりです。

- 認証なしモードでは、サーバーもクライアントも認証は不要です。
このモードは、匿名SSL/認証なし/Diffie-Hellmanなどと呼ばれています。このモードはセキュアではないと見なされます。

- サーバー認証モードでは、クライアントに対してサーバー自身の認証が行われます。
このモードは、一方向SSL/サーバー認証とも呼ばれています。

- 相互認証モードでは、サーバーに対してクライアント自身の認証が行われ、クライアントに対してサーバー自身の認証が行われます。
このモードは、双方向SSL/クライアント認証とも呼ばれています。

- オプションのクライアント認証モードでは、クライアントに対してサーバー自身の認証が行われますが、サーバーに対してはクライアント自身の認証を行うことも行わないこともできます。クライアント自身の認証を行わなくても、SSLセッションは機能します。

6.2.4 SSL構成用ツール

Oracle Fusion Middlewareでは、一般的なツールと拡張ツールの2種類の構成ツールを使用します。

一般的なツール

- Fusion Middleware Control

- WLSTコマンドライン・インタフェース

- Oracle WebLogic Server管理コンソール

- keytoolコマンドライン・ツール

これらのツールを使用して、Oracle Fusion Middlewareの任意のリスナーまたはコンポーネントでSSLを構成したり、Oracle WalletやJKSキーストアを管理できます。

このリストの最初の3つのツールは、コンポーネントがアプリケーション・サーバー・ドメインに関連付けられている場合(コンポーネントがスタンドアロン・インストールではない場合)に使用できます。

拡張ツール

- Oracle Wallet Managerグラフィカル・ユーザー・インタフェース

- orapkiコマンドライン・インタフェース

これらのツールは、スタンドアロンWeb層およびスタンドアロンOracle Internet Directoryインストールのウォレットの管理に必要です。

また、これらのツールを使用して、ファイルベースのCRL、PKCS11ベースのウォレットの管理などの高度な機能を構成できます。

関連項目:

キーストアの管理は、Oracle Fusion Middlewareにおける鍵と証明書の格納に関する項を参照してください。

6.3 構成ツールでのSSLの構成

Oracle Fusion Middleware構成ではいくつかのツールを使用できます。この項では、これらのツールでSSLを構成して、それをSSLが有効なOracle WebLogic Serverに接続できるようにする方法について説明します。

関連項目:

Oracle WebLogic ServerでのインバウンドSSLの有効化の詳細は、第6.5.1.1項を参照してください。

すべての構成ツールの一覧は、第6.2.4項「SSL構成用ツール」を参照してください。

この項の項目は次のとおりです。

- Oracle Enterprise Manager Fusion Middleware Control

- Oracle WebLogic Server管理コンソール

- WLSTコマンドライン・ツール

6.3.1 Oracle Enterprise Manager Fusion Middleware Control

次の手順に従います。

- Fusion Middleware ControlがデプロイされているOracle WebLogic ServerインスタンスでSSLポートが有効なことを確認し、(Fusion Middleware Controlを起動する)ブラウザがサーバー証明書を信頼していることを確認します。

- ここで、「https://host:port」形式でSSLベースのURLを使用してFusion Middleware Controlを起動します。

6.3.2 Oracle WebLogic Server管理コンソール

Oracle WebLogic ServerインスタンスでSSLポートが有効なことを確認します。ここで、URLにSSLポートを指定して管理コンソールを起動します。証明書が信頼できないという警告が表示される場合がありますが、この証明書を受け入れて続行します。

6.3.3 WLSTコマンドライン・ツール

WLSTでのSSLの構成の詳細は、次の手順を実行します。

1. WLSTシェルを起動します。

2. WLSTコマンドを実行します。

help('connect')

ヘルプ・テキストの説明にある手順に従って、SSLモードでWLSTシェルを設定します。

関連項目:

WLSTの使用の詳細は、第6.9項および第3.5.1項を参照してください。

6.4 Web層でのSSLの構成

この項の項目は次のとおりです。

- ロード・バランサの構成

- Oracle Web CacheエンドポイントでのSSLの有効化

- Oracle HTTP Server仮想ホストでのSSLの有効化

注意:

- この項の内容は、Oracle WebLogic Serverドメインに関連したWeb層に適用されます。スタンドアロンWeb層インストールの詳細は、『Oracle Fusion Middleware Oracle Web Cache管理者ガイド』のHTTPSリクエストに対するOracle Web Cacheの構成に関する説明を参照してください。

- これらの項目の表示順は、SSLが有効化される順序ではありません(この順序はトポロジによって異なります)。これらの項目は、フロントエンドのコンポーネントから開始するように配置されています。

6.4.1 ロード・バランサの構成

ロード・バランシング・デバイスに固有の手順を使用して、Oracle Fusion Middleware環境のロード・バランサを構成します。

6.4.2 Oracle Web CacheエンドポイントでのSSLの有効化

この項では、Fusion Middleware ControlおよびWLSTを使用してOracle Web Cacheのリスニング・エンドポイントでSSLを有効にする方法について説明します。

6.4.2.1 Fusion Middleware Controlを使用したOracle Web CacheでのインバウンドSSLの有効化

次の手順を実行して、Oracle Web Cacheリスニング・エンドポイントへのインバウンド・トラフィックでSSLを有効にすることができます。

注意:

この情報は、インバウンド通信にのみ適用されます。Oracle Web CacheからOracle HTTP Serverへのアウトバウンド・トラフィックでのSSLの有効化については、第6.4.2.3項「Fusion Middleware Controlを使用したOracle Web CacheでのアウトバウンドSSLの有効化」を参照してください。

1. 左側のナビゲーション・ペインでOracle Web Cacheインスタンスを選択します。

2. 必要に応じて、「Oracle Web Cache」→「セキュリティ」→「ウォレット」にナビゲートして、ウォレットを作成します。
ウォレットの作成とメンテナンスは、第8章「キーストア、ウォレットおよび証明書の管理」を参照してください。

3. 「Oracle Web Cache」→「セキュリティ」→「SSL構成」にナビゲートします。
「SSL構成」ページには、2つの情報が表示されます。

図wcssl1.gifの説明

上の表には、リスニング・エンドポイントのインバウンド設定のリストが表示されます。「SSL有効」列のチェックは、エンドポイントがSSLに構成されていることを示します。

ページの下部は、アウトバウンドSSL構成を示します。アウトバウンドSSLの詳細は、第6.4.2.3項「Fusion Middleware Controlを使用したOracle Web CacheでのアウトバウンドSSLの有効化」を参照してください。

4. エンドポイントを選択して、「編集」をクリックします。
図wcssl2.gifの説明

「ポートの編集」ページが表示されます。このページには、2つのセクションが含まれます。ポートやIPアドレスなどの一般的な詳細情報が表示される上のセクションと、SSLパラメータを構成する下のセクションになっています。

5. SSLを無効にするには、「SSLの有効化」の選択を解除し、「Oracle Web Cache」→「コントロール」→「再起動」にナビゲートしてコンポーネント・インスタンスを再起動します。

6. このエンドポイントでSSLを有効にするには、「SSLの有効化」を選択します。次に、SSL構成パラメータを入力します。

- ドロップダウン・リストからOracleウォレットを選択します。

注意:

ウォレットにサーバー証明書とそれに対応するCA証明書が含まれていることを確認してください。

- SSL認証のタイプを選択します。

- プロトコルのバージョンを選択します(認証の選択により、選択可能なオプションが決まります)。

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

8. Windowsプラットフォームの場合にのみ、Windowsエクスプローラを開いて、cwallet.ssoファイルの場所に移動します。「プロパティ」→「セキュリティ」で、「グループ名またはユーザー名」にSYSTEMを追加します。

9. 「Oracle Web Cache」→「コントロール」→「再起動」にナビゲートして、Oracle Web Cacheインスタンスを再起動します。

関連項目:

第8.4.1.3項「インスタンス間のウォレットの共有」

6.4.2.2 WLSTを使用したOracle Web CacheでのインバウンドSSLの有効化

関連項目:

WLSTの使用方法の詳細は、第6.3.3項を参照してください。

WLSTコマンドライン・ツールを使用して、Oracle Web Cacheへのインバウンド・トラフィックでSSLを有効にすることができます。

WLSTを使用したサーバー認証モードでのOracle Web CacheインバウンドのSSLの有効化

次の手順に従います。

関連項目:

この手順で示されている各コマンド・パラメータの定義など、WLSTコマンドの使用の詳細は、第6.9項を参照してください。

1. 次のコマンドを実行して、このOracle Web Cacheインスタンスのリスニング・エンドポイントを確認します。

listListeners('inst1','wc1')

このコマンドにより、このインスタンスのすべてのリスニング・エンドポイントがリストされます。SSLを構成する必要があるエンドポイントを1つ選択します。たとえば、CACHE.index1.LISTEN.index1という名前のエンドポイントを選択します。

関連項目:

WLSTの使用の詳細は、第6.9項を参照してください。

2. SSLプロパティでリスニング・エンドポイントを構成します。

configureSSL('inst1',
'wc1',
'webcache',
'CACHE.index1.LISTEN.index1')

注意:

- configureSSLでは、すべてのSSL属性のデフォルトを使用します。詳細は、表6-5を参照してください。

- パラメータとしてプロパティ・ファイルをconfigureSSLに指定することもできます。詳細は、表6-4を参照してください。

- プロパティ・ファイルの使用の詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

3. Windowsプラットフォームの場合にのみ、Windowsエクスプローラを開いて、cwallet.ssoファイルの場所に移動します。「プロパティ」→「セキュリティ」で、「グループ名またはユーザー名」にSYSTEMを追加します。

6.4.2.3 Fusion Middleware Controlを使用したOracle Web CacheでのアウトバウンドSSLの有効化

アウトバウンドOracle Web Cacheとは、Oracle Web CacheからOracle HTTP Serverへのトラフィックを表します。

Oracle Web Cacheからのアウトバウンド・トラフィックのSSLを設定するには、アウトバウンドSSLのウォレットの選択とSSLの構成という、2つの側面があります。

ウォレットの選択

次の手順に従います。

1. 「Oracle Web Cache」→「セキュリティ」→「SSL構成」にナビゲートします。
図wcssl1.gifの説明

2. ページの下部で、「ウォレットの変更」をクリックすると、このリスナーで使用可能なウォレットが表示されます。
図wcssl3.gifの説明

注意: 証明書に署名したルートCA証明書(Webキャッシュが接続するOHSなどのコンポーネント用)は、このウォレットにロードされる必要があります。詳細は8.4.7.5項を参照してください。

3. アウトバウンドSSLの目的のウォレットを選択して、「OK」をクリックします。

SSLの構成

次の手順に従います。

1. Oracle Web Cacheインスタンスにナビゲートしてから、「管理」→「オリジナル・サーバー」にナビゲートします。
このページには、このOracle Web Cacheインスタンスと通信可能なOracle HTTP Serverが表示されます。たとえば、Oracle Web Cacheが2つの異なるOracle HTTP Serverと対話できる場合、表には2つの行が表示されます。

図wcssl4.gifの説明

この例では、Oracle Web Cacheインスタンスはこのホストおよびポート上でオリジナル・サーバーとの通信に現在非SSLが構成されています。

2. このオリジナル・サーバーへのアウトバウンド・トラフィックでSSLを有効にするには、行を選択して「編集」をクリックします。

3. 「オリジナル・サーバーの編集」ページが表示されます。
図wcssl5.gifの説明

4. 「プロトコル」ドロップダウン・ボックスを使用して、プロトコルを「https」に変更します。

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

6. Windowsプラットフォームの場合にのみ、Windowsエクスプローラを開いて、cwallet.ssoファイルの場所に移動します。「プロパティ」→「セキュリティ」で、「グループ名またはユーザー名」にSYSTEMを追加します。

7. 「Oracle Web Cache」→「コントロール」→「再起動」にナビゲートして、Oracle Web Cacheインスタンスを再起動します。
これで、Oracle Web Cacheはオリジナル・サーバーとSSLで通信するように構成されました。

注意:

このページでオリジナル・サーバー設定を編集する場合、Oracle HTTP ServerがこのポートにおいてSSLモードでリスニングしていることを確認します。

6.4.2.4 WLSTを使用したOracle Web CacheからのアウトバウンドSSLのウォレットの指定

関連項目:

この手順で示されている各コマンド・パラメータの定義など、WLSTコマンドの使用の詳細は、第6.9項を参照してください。

Oracle Web CacheからアウトバウンドSSL接続で使用されるウォレットを変更するには、このコマンドを次のように使用します。

configureSSL('inst1',
'wc1',
'webcache',
'CACHE.index0.CLIENTSSL',
'property-file.prop')

説明:

- inst1はアプリケーション・サーバー・インスタンスの名前です。

- wc1はOracle Web Cacheインスタンスの名前です。

- webcacheはコンポーネント・タイプです。

- CACHE.index0.CLIENTSSLはクライアントSSLのリスナー名です。

- property-file.propには、次が含まれます。

KeyStore=wallet-path

6.4.3 Oracle HTTP Server仮想ホストでのSSLの有効化

この項では、Oracle WebLogic Server環境で動作しているOracle HTTP Server仮想ホストのSSL構成の管理方法について説明します。

注意:

スタンドアロン・モードのOracle HTTP Serverの詳細は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』を参照してください。

インバウンド・トラフィック:

- 第6.4.3.1項 (Fusion Middleware Controlを使用)

- 第6.4.3.2項 (WLSTを使用)

アウトバウンド・トラフィック:

- 第6.4.3.3項(Fusion Middleware ControlまたはWLSTを使用)

6.4.3.1 Fusion Middleware Controlを使用したOracle HTTP Server仮想ホストへのインバウンド・リクエストでのSSLの有効化

次の手順を実行して、Oracle HTTP Server仮想ホストへのインバウンド・トラフィックでSSLを有効にすることができます。

1. 左側のナビゲーション・ペインでOracle HTTP Serverインスタンスを選択します。

2. 必要に応じて、「Oracle HTTP Server」→「セキュリティ」→「ウォレット」にナビゲートします。
ウォレットの作成とメンテナンスは、第8章「キーストア、ウォレットおよび証明書の管理」を参照してください。

3. 「HTTP Server」→「管理」→「仮想ホスト」にナビゲートします。
このページには、現在構成されているホスト、およびそれらがhttpまたはhttpsに構成されているかが表示されます。

図ohsssl1.gifの説明

4. 更新する仮想ホストを選択して、「構成」→「SSL構成」をクリックします。(注意: 新規仮想ホストを作成する場合は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』を参照してください。)
図ohsssl2.gifの説明

「SSL構成」ページが表示されます。

5. 「SSLの有効化」の選択を解除すると、httpsポートをhttpポートに変換できます。
現在httpを使用している仮想ホストでSSLを構成するには:

- 「SSLの有効化」ボックスを選択します。

- ドロップダウン・リストからウォレットを選択します。
図ohsssl3.gifの説明

- 「サーバーSSLプロパティ」から、SSL認証タイプ、使用する暗号スイートおよびSSLプロトコル・バージョンを選択します。

注意:

ほとんどの状況ではデフォルト値が最適です。

注意:

- ここでは、Fusion Middleware Controlに証明書があることを想定しています。証明書がorapkiまたはOracle Wallet Managerで作成された場合は、最初に証明書をインポートします(第8.4.4.9項を参照)。

- 選択した認証タイプにより使用可能な暗号スイートが決まり、選択した暗号スイートにより使用可能なプロトコル・バージョンが決まります。暗号およびプロトコル・バージョンの詳細は、第6.9.28項を参照してください。

6. 「OK」をクリックして変更内容を適用します。

7. Windowsプラットフォームの場合にのみ、Windowsエクスプローラを開いて、cwallet.ssoファイルの場所に移動します。「プロパティ」→「セキュリティ」で、「グループ名またはユーザー名」にSYSTEMを追加します。

8. 「Oracle HTTP Server」→「コントロール」→「再起動」にナビゲートして、Oracle HTTP Serverインスタンスを再起動します。

9. ブラウザ・セッションを開き、SSLを有効にしたポート番号に接続します。

6.4.3.2 WLSTを使用したOracle HTTP Server仮想ホストへのインバウンド・リクエストでのSSLの有効化

関連項目:

WLSTの使用方法の詳細は、第6.3.3項を参照してください。

次の手順に従います。

1. 次のコマンドを実行して、このOracle HTTP Serverインスタンスの仮想ホストを確認します。

listListeners('inst1','ohs1' )

このコマンドにより、このインスタンスのすべての仮想ホストがリストされます。SSLを構成する必要がある仮想ホストを1つ選択します。たとえば、「vhost1」を選択できます。このコマンドの詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

2. SSLプロパティで仮想ホストを構成します。

configureSSL('inst1',
'ohs1',
'ohs',
'vhost1')

注意:

- configureSSLでは、すべてのSSL属性のデフォルトを使用します。詳細は、表6-5を参照してください。

- パラメータとしてプロパティ・ファイルをconfigureSSLに指定することもできます。パラメータの詳細は、表6-4を参照してください。プロパティ・ファイルの使用例は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のconfigureSSLを参照してください。

- このコマンドの詳細は、第6.9項を参照してください。

3. Windowsプラットフォームの場合にのみ、Windowsエクスプローラを開いて、cwallet.ssoファイルの場所に移動します。「プロパティ」→「セキュリティ」で、「グループ名またはユーザー名」にSYSTEMを追加します。

6.4.3.3 Oracle HTTP Serverからのアウトバウンド・リクエストでのSSLの有効化

mod_wl_ohsを構成してOracle HTTP Serverからのアウトバウンド・リクエストでのSSLを有効化します。

関連項目:

www.oracle.com/technetworkで提供されている、ナレッジ・データベースの記事1268723.1。

一方向SSL

手順は次のとおりです。

1. 証明書を含むOracle WebLogic Serverのカスタム・キーストアを生成します(第6.5.1項「Oracle WebLogic ServerでのSSLの構成」を参照してください)。

2. ステップ1のOracle WebLogic Serverで使用される証明書をOracle HTTP Serverウォレットに、信頼できる証明書としてインポートします。このタスクには、WLSTやFusion Middleware Controlなどの使用可能なユーティリティを使用できます。(注意: ここで説明するウォレットは、Oracle HTTP Serverリスニング・ポートがSSL用に使用するウォレットです。Oracle WebLogic Server証明書に署名した信頼性できる(ルート)CA証明書は、このウォレットに格納されている必要があります。信頼性できる証明書のインポートの詳細は、第8.3.5項を参照してください。)

3. Oracle HTTP Server構成ファイルのINSTANCE_HOME/config/OHS/ohs1/ssl.confを編集して、mod_weblogicの下のSSL構成に次の行を追加します。

WlSSLWallet  "${ORACLE_INSTANCE}/config/{COMPONENT_TYPE}/{COMPONENT_NAME}/keystores/default"

このdefaultは、ステップ2のOracle HTTP Serverウォレットの名前です。

次にその構成の例を示します。

<IfModule mod_weblogic.c>
WebLogicHost myweblogic.server.com
WebLogicPort 7002
MatchExpression *.jsp
SecureProxy On
WlSSLWallet "${ORACLE_INSTANCE}/config/OHS/ohs1/keystores/default"
</IfModule>

ファイルを保存して終了します。

4. Windowsプラットフォームの場合にのみ、Windowsエクスプローラを開いて、cwallet.ssoファイルの場所に移動します。「プロパティ」→「セキュリティ」で、「グループ名またはユーザー名」にSYSTEMを追加します。

5. Oracle HTTP Serverを再起動して変更を有効にします。詳細は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』を参照してください。

6. ステップ1で生成されたカスタム・キーストアを使用するようにOracle WebLogic Serverインスタンスが構成され、別名が証明書の生成に使用される別名値を指していることを確認します。Oracle WebLogic Serverインスタンスを再起動します。

双方向SSL

mod_wl_ohsでは、双方向SSL通信もサポートします。双方向SSLを構成する手順は次のとおりです。

1. 前の一方向SSLのステップ1から4を実行します。

2. Oracle WebLogic Serverのトラストストアtrust.jksを生成します。詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』を参照してください。
(前の手順のステップ1で)一方向SSL用に作成されたキーストアは、信頼できる証明書を保存するために使用できますが、この手順で個別のトラストストアを作成することをお薦めします。

3. Oracle HTTP Serverウォレットからユーザー証明書をエクスポートして、それをステップ2で作成したトラストストアにインポートします。
エクスポートには、WLSTやFusion Middleware Controlなどの使用可能なユーティリティを使用できます。インポートにはkeytoolユーティリティを使用できます。詳細は8.4.7項を参照してください。

4. Oracle WebLogic Server管理コンソールから、構成するサーバーの「キーストア」タブを選択します。

5. ステップ2で作成したトラストストアのtrust.jksファイルの場所によりカスタム・トラストストアを設定します(完全な名前を使用します)。

6. キーストア・タイプをJKSに設定し、キーストアの作成に使用されるパスフレーズを設定します。

7. 「SSL」タブで、「信頼性のある認証局」が「カスタム信頼キーストアから」に設定されていることを確認します。

8. Oracle WebLogic Serverが双方向SSL用に構成されていることを確認します。詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のSSLの構成に関する説明を参照してください。

6.5 中間層でのSSLの構成

中間層では、次のようにSSLを使用します。

- アプリケーション・サーバーでのSSLの有効化

- アプリケーション・サーバー上で稼働するコンポーネントおよびアプリケーションでのSSLの有効化

この項では、中間層でのSSLの構成について説明します。この項の項目は次のとおりです。

- Oracle WebLogic ServerでのSSLの構成

- Oracle SOA SuiteでのSSLの構成

- Oracle WebCenter PortalのSSLの構成

- Oracle IdentityおよびAccess ManagementでのSSLの構成

- Oracle Reports、Forms、DiscovererおよびPortalでのSSLの有効化

- アプリケーションのクライアント側のSSL

6.5.1 Oracle WebLogic ServerでのSSLの構成

この項では、アプリケーション・サーバーの構成について説明します。

6.5.1.1 Oracle WebLogic ServerへのインバウンドSSL

SSLを実装してOracle WebLogic Serverを保護する方法の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』を参照してください。

6.5.1.2 Oracle WebLogic ServerからのアウトバウンドSSL

この項では、Oracle WebLogic Serverからのアウトバウンド接続でSSLを有効にする方法について説明します。

- Oracle Platform Security ServicesからのLDAPへのアウトバウンドSSL

- Oracle Platform Security ServicesからのOracleデータベースへのアウトバウンドSSL

- LDAP認証プロバイダからのLDAPへのアウトバウンドSSL

- データベースへのアウトバウンドSSL

6.5.1.2.1 Oracle Platform Security ServicesからのLDAPへのアウトバウンドSSL

この項では、LDAPディレクトリへのポリシー・ストア接続および資格証明ストア接続用にSSLを構成する方法について説明します(サーバー側とクライアント側が必要)。匿名および一方向SSLがサポートされます。

この項で参照するjps-config.xmlファイルの詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』を参照してください。

匿名SSL(サーバー側)

匿名認証モードでLDAPサーバーを起動します。

Oracle Internet Directoryの詳細は、第6.6.1.1項「Fusion Middleware Controlを使用したOracle Internet DirectoryリスナーでのインバウンドSSLの有効化」を参照してください。

別のディレクトリを使用している場合、LDAPサーバーのドキュメントを参照してこのタスクに関する情報を調べてください。

匿名SSL(クライアント側)

jps-config.xmlファイルでは、プロトコルをldapsに設定し、プロパティldap.urlに適切なポートを指定する必要があります。この情報は、ポリシー・ストア、資格証明ストア、キーストア、およびldap.urlを使用するその他のサービスに対して更新する必要があります。

一方向SSL(サーバー側)

前提条件: LDAPサーバーがSSLサーバー認証モードであること。

この手順の詳細は、Oracle Fusion Middleware Oracle Internet Directory管理者ガイドを参照してください。

一方向SSL(クライアント側)

クライアント側の構成が次のようになっている必要があります。

1. LDAPの証明書を信頼するには、使用するトラスト・ストアを検索する場所をJVMが認識している必要があります。これを行うには、次のように設定します。

-Djavax.net.ssl.trustStore=path_to_jks_file

このプロパティは、JavaSEプログラム、またはJavaEE環境のサーバー起動プロパティに追加されます。これを行う方法の例は、Java Technical Documentationサイトのhttp://docs.oracle.com/javase/(JavaSE)およびhttp://docs.oracle.com/javaee/(JavaEE)を参照してください。

2. jps-config.xmlファイルでは、プロトコルをldapsに設定し、プロパティldap.urlに適切なポートを指定する必要があります。この情報は、ポリシー・ストア、資格証明ストア、キーストア、およびldap.urlを使用するその他のサービスに対して更新する必要があります。

3. keytoolを使用して、LDAPサーバーの証明書をステップ1で指定したトラスト・ストアにインポートします。keytoolの使用例は、第I.3.2項を参照してください。

6.5.1.2.2 Oracle Platform Security ServicesからのOracleデータベースへのアウトバウンドSSL

一方向または双方向のSSL接続をデータベース・ベースのOPSSセキュリティ・ストアに設定できます。

データベース・サーバーとクライアントの構成の詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』を参照してください。

6.5.1.2.3 LDAP認証プロバイダからのLDAPへのアウトバウンドSSL

Oracle WebLogic ServerでLDAP認証プロバイダを構成する場合、LDAPストアへの接続でSSLを使用するように指定できます。

次の手順を実行して、この認証プロバイダを構成します。

1. Oracle WebLogic Server管理コンソールにログインします。

2. 左ペインで、「セキュリティ・レルム」を選択して、構成するレルムの名前をクリックします。

3. 「プロバイダ」→「認証」を選択して、「新規」をクリックします。

4. 「名前」フィールドで、認証プロバイダの名前を入力します。

5. 「タイプ」ドロップダウン・リストから、認証プロバイダのタイプを選択して「OK」をクリックします。
たとえば、Oracle Internet Directoryを使用する場合、「OracleInternetDirectoryAuthenticator」を選択します。

6. 「プロバイダ」→「認証」を選択して、その構成を行う新しい認証プロバイダの名前をクリックします。

7. 認証プロバイダの「構成」ページの「共通」および「プロバイダ固有」タブで、目的の値を設定します。

1. 「共通」タブ
DefaultAuthenticatorを含むすべての認証プロバイダで、「制御フラグ」を「SUFFICIENT」に設定します。

2. 「プロバイダ固有」タブ
ホスト: ホスト名

ポート: ポート番号

プリンシパル: cn=orcladmin

「資格証明」/「確認」: パスワード

ユーザー・ベースDN: cn=Users,dc=us,dc=oracle,dc=com

グループ・ベースDN: cn=Groups,dc=us,dc=oracle,dc=com

8. 変更を保存してサーバーを再起動します。

6.5.1.2.4 データベースへのアウトバウンドSSL

Oracle WebLogic Serverとデータベースとの間でSSLを構成するには、次の2つの手順のセットが必要です。

- データベースでのSSLリスナーの構成

- Oracle WebLogic ServerのデータソースでのSSLの構成

Oracle DatabaseでのSSLリスナーの構成

データベースをSSLリスナーで構成するには、クライアント・ネットワーク構成ファイルで、サーバーのDNマッチングおよびTCP/IPをSSL接続できるように、プロトコルとしてサーバーの識別名(DN)とTCPSを指定する必要があります。サーバーDNマッチングでは、サーバー証明書からDNに対してサーバーのグローバル・データベース名をマッチングすることで、データベース・サーバーが接続時にクライアントに対するIDの偽装が防止されます。

クライアント・ネットワーク構成ファイルのtnsnames.oraおよびlistener.oraを手動で編集して、サーバーのDNとTCP/IPをSSLプロトコルに指定する必要があります。

詳細は、第6.6.3.1項「Oracle DatabaseでのSSLの有効化」を参照してください。

関連項目:

データベース・リスナー用のSSLの構成の詳細は、http://download.oracle.com/docs/cd/E11882_01/network.112/e10746/toc.htmにある『Oracle Database Advanced Security管理者ガイド』のSecure Sockets Layer認証の構成に関する説明を参照してください。

Oracle WebLogic ServerのデータソースでのSSLの有効化

第6.6.3.2項「データソースでのSSLの有効化」を参照してください。

6.5.2 Oracle SOA SuiteでのSSLの構成

Oracle SOA SuiteでのSSLの構成は、保護する接続のタイプによって異なります。

Oracle WebLogic ServerでのSSL

Oracle WebLogic Serverには次のようなSSL機能が含まれます。

- コア・サーバーでのSSLの設定方法。
詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』を参照してください。

- WebLogic WebサービスでのSSLの有効化方法。
詳細は、『Oracle Fusion Middleware Oracle WebLogic Server WebLogic Webサービスの保護』を参照してください。

SOAコンポジットでのSSL

次のタスクでは、Oracle SOA Suiteアプリケーションも保護する必要があります。

- SSLによるSOAコンポジットの保護

- SOAコンポジット内におけるSSLで保護されたWebサービスへのアクセス

これらおよび関連項目については、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』を参照してください。

6.5.3 Oracle WebCenter PortalのSSLの構成

Oracle WebCenter PortalでのSSL接続の実装方法の詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』の次の項目を参照してください。

- SSLによるContent Serverへのスペース接続の保護

- SSLによるスペースへのブラウザ接続の保護

6.5.4 Oracle IdentityおよびAccess ManagementでのSSLの構成

中間層に配置されているOracle IdentityおよびAccess ManagementコンポーネントでSSLを構成できます。

- Oracle Directory Integration PlatformでのSSLの構成

- Oracle Identity FederationでのSSLの構成

- Oracle Directory Services ManagerでのSSLの構成

6.5.4.1 Oracle Directory Integration PlatformでのSSLの構成

Oracle Directory Integration Platformを構成して、接続されたディレクトリとの通信にSSLを使用できます。Oracle Directory Integration Platformの次のSSLタスクの詳細は、Oracle Fusion Middleware Oracle Directory Integration Platform管理者ガイドに記載されています。

- SSLモードの2サーバー専用認証用のOracle Directory Integration Platformの構成

- Oracle Internet Directoryおよび接続されたディレクトリのSSL証明書の管理

- SSLモードでのブートストラップ

- SSLモードで同期するためのサードパーティのディレクトリ・コネクタの構成

- SSLサーバー側認証によるOracle Internet Directoryの構成およびテスト

- Oracle Internet DirectoryとMicrosoft Active Directoryとの間のSSL通信のテスト

6.5.4.2 Oracle Identity FederationでのSSLの構成

詳細は、Oracle Fusion Middleware Oracle Identity Federation管理者ガイドのOracle Identity Federationに対するSSLの構成に関する項を参照してください。

注意:

Sun Microsystemsのkeytoolユーティリティを使用して、Oracle Identity FederationのSSL構成に必要なキーストアおよび証明書を管理します。

6.5.4.3 Oracle Directory Services ManagerでのSSLの構成

Oracle Directory Services Managerを構成して、接続されたディレクトリとの通信にSSLを使用できます。Oracle Directory Services Managerの次のSSLタスクの詳細は、Oracle Fusion Middleware Oracle Virtual Directory管理者ガイドに記載されています。

- SSLを使用したOracle Directory Services Managerからのディレクトリ・サーバーへのログイン

- Oracle Directory Services Managerのキーストアの管理

- Oracle Virtual DirectoryにおけるOracle Directory Services Managerの証明書の保存

6.5.5 Oracle Reports、Forms、DiscovererおよびPortalでのSSLの有効化

この項の項目は次のとおりです。

- Oracle ReportsでのSSL

- Oracle FormsでのSSL

- Oracle DiscovererでのSSL

- Oracle PortalでのSSL

6.5.5.1 Oracle ReportsでのSSL

Oracle ReportsでSSLを有効にするには、Oracle WebLogic ServerのフロントエンドとなるコンポーネントでSSLを有効にする必要があります。

たとえば、Oracle ReportsをホストするOracle WebLogic ServerのフロントエンドとなるOracle HTTP ServerとOracle Web Cacheがある場合、次を構成する必要があります。

- Oracle Web CacheのインバウンドSSL
第6.4.2.1項「Fusion Middleware Controlを使用したOracle Web CacheでのインバウンドSSLの有効」を参照してください。

- Oracle HTTP ServerのインバウンドSSL
第6.4.3.1項「Fusion Middleware Controlを使用したOracle HTTP Server仮想ホストへのインバウンド・リクエストでのSSLの有効化」を参照してください。

- Oracle WebLogic ServerのインバウンドSSL
第6.5.1.1項「Oracle WebLogic ServerへのインバウンドSSL」を参照してください。

- Oracle Web CacheとOracle HTTP Serverとの間におけるSSL
第6.4.2.3項「Fusion Middleware Controlを使用したOracle Web CacheでのアウトバウンドSSLの有効化」を参照してください。

- Oracle HTTP ServerとOracle WebLogic Serverとの間におけるSSL
第6.4.3.3項「Oracle HTTP Serverからのアウトバウンド・リクエストでのSSLの有効化」を参照してください。

注意:

エンドツーエンドSSLを設定する場合のみ、これらの手順が必要です。ほとんどの場合、リクエストを取得する最初のコンポーネントにのみSSLを有効にするだけで十分です。他のコンポーネントは通常、イントラネット内にあるからです。

たとえば、リクエストをOracle Web Cacheに送信する場合、最初の手順のみ実行が必要です。リクエストをOracle HTTP Serverに送信する場合、2番目の手順のみ実行が必要です。使用するトポロジに応じて手順を選択します。

また、Fusion Middleware ControlのOracle Reportsは、Reports Servletにアクセスしてデータを検索します。この通信をSSLを介して行う必要がある場合、『Oracle Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイド』で説明されている手動手順を完了する必要があります。

6.5.5.2 Oracle FormsでのSSL

Oracle FormsでSSLを有効にするには、Oracle WebLogic ServerのフロントエンドとなるコンポーネントでSSLを有効にする必要があります。

たとえば、Oracle FormsをホストするOracle WebLogic ServerのフロントエンドとなるOracle HTTP ServerとOracle Web Cacheがある場合、次を構成する必要があります。

- Oracle Web CacheのインバウンドSSL
第6.4.2.1項「Fusion Middleware Controlを使用したOracle Web CacheでのインバウンドSSLの有効」を参照してください。

- Oracle HTTP ServerのインバウンドSSL
第6.4.3.1項「Fusion Middleware Controlを使用したOracle HTTP Server仮想ホストへのインバウンド・リクエストでのSSLの有効化」を参照してください。

- Oracle WebLogic ServerのインバウンドSSL
第6.5.1.1項「Oracle WebLogic ServerへのインバウンドSSL」を参照してください。

- Oracle Web CacheとOracle HTTP Serverとの間におけるSSL
第6.4.2.3項「Fusion Middleware Controlを使用したOracle Web CacheでのアウトバウンドSSLの有効化」を参照してください。

- Oracle HTTP ServerとOracle WebLogic Serverとの間におけるSSL
第6.4.3.3項「Oracle HTTP Serverからのアウトバウンド・リクエストでのSSLの有効化」を参照してください。

注意:

エンドツーエンドSSLを設定する場合のみ、これらの手順が必要です。ほとんどの場合、リクエストを取得する最初のコンポーネントにのみSSLを有効にするだけで十分です。他のコンポーネントは通常、イントラネット内にあるからです。

たとえば、リクエストをOracle Web Cacheに送信する場合、最初の手順のみ実行が必要です。リクエストをOracle HTTP Serverに送信する場合、2番目の手順のみ実行が必要です。使用するトポロジに応じて手順を選択します。

6.5.5.3 Oracle DiscovererでのSSL

httpsを介してOracle Discovererを実行するには特定のタスクが必要です。これには、Oracle BI DiscovererをホストするOracle WebLogic ServerのフロントエンドとなるOracle HTTP Server仮想ホストやOracle Web CacheでSSLを有効化することなどが含まれます。

詳細は、Oracle Fusion Middleware Oracle Business Intelligence Discoverer構成ガイドのDiscovererでのエンドツーエンドSecure Sockets Layerの構成に関する項を参照してください。

6.5.5.4 Oracle PortalでのSSL

Oracle Portalでは、多数の様々なコンポーネント(Parallel Page Engine、Oracle HTTP Server、Oracle Web Cacheなど)を使用します。それぞれのコンポーネントは、HTTP通信においてクライアントまたはサーバーとして機能する場合があります。そのため、中間層のOracle Portalを含む各コンポーネントは、個々にHTTPSで構成されます。

詳細は、『Oracle Fusion Middleware Oracle Portal管理者ガイド』を参照してください。

6.5.6 アプリケーションのクライアント側のSSL

SSL対応のアプリケーションの記述方法については、『Oracle Fusion Middleware Oracle WebLogic Serverセキュリティのプログラミング』のJavaクライアントでのSSL認証の使用に関する項を参照してください。

ベスト・プラクティスは、第6.8.2項「アプリケーション開発者のベスト・プラクティス」を参照してください。

6.6 データ層でのSSLの構成

この項の項目は次のとおりです。

- Oracle Internet DirectoryリスナーでのSSLの有効化

- Oracle Virtual DirectoryリスナーでのSSLの有効化

- データベースでのSSLの構成

6.6.1 Oracle Internet DirectoryリスナーでのSSLの有効化

インストール時には、Oracle Internet Directoryノードは認証なしモードでSSLが有効に設定されています。

この項では、Fusion Middleware ControlおよびWLSTコマンドライン・ツールを使用して、Oracle Internet DirectoryリスナーでSSLを有効にする方法について説明します。

関連項目:

Oracle Internet Directory SSL相互認証クライアントおよびサーバー認証の設定の詳細は、https://support.oracle.com/のMy Oracle Supportにあるノート1311791.1を参照してください。

6.6.1.1 Fusion Middleware Controlを使用したOracle Internet DirectoryリスナーでのインバウンドSSLの有効化

この例では次の手順により、Fusion Middleware Controlを使用してOracle Internet Directoryのインスタンスに対して認証なしモードでSSLを有効化します。

1. 左側のナビゲーション・ペインでOracle Internet Directoryインスタンスを選択します。

2. 「Oracle Internet Directory」→「管理」→「サーバー・プロパティ」にナビゲートします。
図oid2a.gifの説明

3. 「SSL設定の変更」をクリックします。

4. 「SSL設定」ダイアログで、次の操作を実行します。
図oid3a.gifの説明

- 「SSLの有効化」を選択します。

- 「SSL認証」を「認証なし」に設定します。

- 「暗号スイート」を「すべて」に設定します。

- 「SSLプロトコル・バージョン」を「v3」に設定します。

- 「OK」をクリックします。

5. 「Oracle Internet Directory」→「コントロール」→「再起動」にナビゲートして、Oracle Internet Directoryインスタンスを再起動します。

6. インスタンスが正しくSSL有効に設定されていることを確認するには、次の形式でldapbindコマンドを実行します。

ldapbind -D cn=orcladmin
-U 1
-h host
-p SSL_port

注意:

-U 1は、認証なしモードを表します。

スタンドアロン環境のOracle Internet Directoryリスナーの詳細は、『Oracle Fusion Middleware Oracle Internet Directory管理者ガイド』を参照してください。

その他の認証モードでのSSLの有効化

その他の認証モードでSSLを有効にする手順も同様です。異なる点は、「SSL設定」ダイアログで適切な認証タイプを設定することです。

注意:

その他の認証タイプでは、Oracleウォレットが必要です。

6.6.1.2 WLSTを使用したOracle Internet DirectoryリスナーでのインバウンドSSLの有効化

関連項目:

WLSTの使用方法の詳細は、第6.3.3項を参照してください。

次のようにリスナーをSSLプロパティでno-authモードに構成します。

注意:

Oracle Internet Directoryのポート名は、常にsslport1です。

configureSSL('inst1',
'oid1',
'oid',
'sslport1')

注意:

- configureSSLでは、すべてのSSL属性のデフォルトを使用できます。詳細は、表6-5を参照してください。

- パラメータとしてプロパティ・ファイルをconfigureSSLに指定することもできます。詳細は、表6-4を参照してください。

- 第6.9項も参照してください。

その他の認証モードでのSSLの有効化

これは、パラメータにプロパティ・ファイルを使用して、適切な認証タイプ・パラメータ値を指定し、configureSSLコマンドを実行して行います。詳細は、Oracle Fusion Middleware Oracle Internet Directory管理者ガイドを参照してください。

6.6.1.3 Oracle Internet DirectoryからOracle DatabaseへのアウトバウンドSSLの有効化

Oracle Internet DirectoryからOracle DatabaseへのSSL接続を構成するには、2つの手順のセットが必要です。

- データベースでのSSLの構成

- アウトバウンドOracle Internet Directoryの構成

データベースでのSSLの構成

Oracle DatabaseをSSLで構成する手順は、第6.6.3.1項「Oracle DatabaseでのSSLの有効化」で説明されています。

アウトバウンドOracle Internet Directoryの構成

次の手順を実行して、Oracle Internet DirectoryからOracle Databaseへのアウトバウンド・トラフィックでSSLを構成します。

1. opmnctl構文を使用して、データベースへのアウトバウンド・トラフィックをSSLで構成するOracle Internet Directoryサーバー・インスタンスを停止します。

$ORACLE_INSTANCE/bin/opmnctl stopproc ias-component=componentName

次に例を示します。

$ORACLE_INSTANCE/bin/opmnctl stopproc ias-component=oid1

2. Oracle Internet Directoryサーバー・インスタンスに接続するデータベースのSecurity Socket Layer認証を構成します。
詳細は、『Oracle Database Advanced Security管理者ガイド』を参照してください。

3. 必要に応じて、データベースやリスナーを再起動します。

4. このopmnctl構文を使用して、Oracle Internet Directoryサーバー・インスタンスを起動します。

$ORACLE_INSTANCE/bin/opmnctl startproc ias-component=componentName

次に例を示します。

$ORACLE_INSTANCE/bin/opmnctl startproc ias-component=oid1

注意:

認証なしモードのみがサポートされます。

6.6.2 Oracle Virtual DirectoryリスナーでのSSLの有効化

この項では、Oracle Virtual DirectoryのインスタンスでSSLを有効にする方法について説明します。

これらの項目に関する追加情報は、Oracle Fusion Middleware Oracle Virtual Directory管理者ガイドに記載されています。

- Fusion Middleware Controlを使用したリスナーでのSSLの構成

- WLSTを使用したリスナーでのSSLの構成

- Oracle Virtual DirectoryとOracle Internet Directoryとの間の相互認証SSL接続の構成

6.6.2.1 Fusion Middleware Controlを使用したOracle Virtual DirectoryでのSSLの有効化

SSLを有効にする手順は次のとおりです(例は、server-authモードの説明です)。

1. 左側のナビゲーション・ペインでOracle Virtual Directoryインスタンスを選択します。

2. 「Oracle Virtual Directory」→「セキュリティ」→「キーストア」にナビゲートしてこの操作で使用するキーストアを選択します。
表示されたキーストアのリストから選択します。新しいキーストアを生成する必要がある場合、Fusion Middleware Controlを使用したキーストアの作成に関する項を参照してください。

3. リスナーでSSLを有効にするには、「Oracle Virtual Directory」→「管理」→「リスナー」にナビゲートします。

4. LDAP SSLエンドポイントのリスナーを選択して、「編集」をクリックします。
図ovd2a.gifの説明

「リスナーの編集」ページが表示されます。

図ovd3a.gifの説明

5. 「SSL設定の変更」をクリックします。

6. 「SSL設定」ダイアログで、次の操作を実行します。
図ovd4a.gifの説明

- 「SSLの有効化」を選択します。

- 「サーバー・キーストア名」で、ステップ2で作成したキーストアを選択します(OVDtestJksなど)。

- 「サーバー・キーストアのパスワード」で、ステップ2で指定したキーストア・パスワードを入力します。

- 「サーバーTruststore名」で、ステップ2で作成したキーストアを選択します(OVDtestJksなど)。

- 「サーバー・トラストストアのパスワード」で、ステップ2で指定したキーストア・パスワードを入力します。

- 「拡張SSL設定」を開きます。

- 「SSL認証」で、「サーバー認証」を選択します。これはデフォルト設定です。

- 「暗号スイート」で、適切な暗号スイートを選択します(この例では、「すべて」)。

- プロトコル・バージョンを選択します。

- 「OK」をクリックします。

7. 「Oracle Virtual Directory」→「コントロール」→「停止」にナビゲートしてから「起動」を選択して、Oracle Virtual Directoryインスタンスを停止して起動します。

8. インスタンスが正しくSSL有効に設定されていることを確認するには、次の形式でldapbindコマンドを実行します。

ldapbind -D cn=orcladmin
-U 2
-h host
-p SSL_port
-W "file:// DIRECTORY_SSL_WALLET"

注意:

- -U 2は、サーバー認証モードを表します。

- DIRECTORY_SSL_WALLETは、ウォレット・ファイルのパスです(ウォレット・ファイル名は含めません)。

- このウォレットが存在し、このウォレットに、サーバー証明書を発行したCAの信頼できる証明書が格納されている必要があります。

その他の認証モードでのSSLの有効化

その他の認証モードでSSLを有効にする手順も同様です。異なる点は、「SSL設定」ダイアログで適切な認証タイプを設定することです。

注意:

LDAPリスナーでSSLを構成する場合、SSL通信はldapbindを使用して検証します。httpリスナーの場合は、ブラウザを使用して検証します。

6.6.2.2 WLSTを使用したOracle Virtual DirectoryリスナーでのSSLの有効化

関連項目:

WLSTの使用方法の詳細は、第6.3.3項を参照してください。

次の手順を実行して、サーバー認証モードでリスナーを構成します。

1. 次のコマンドを実行して、このOracle Virtual Directoryインスタンスのリスナーを確認します。

listListeners('inst1','ovd1' )

このコマンドにより、インスタンスinst1およびコンポーネント名ovd1のすべてのリスナーがリストされたら、SSLを構成する必要があるリスナーを1つ選択します。たとえば、「LDAP SSL Endpoint」を選択します。

2. Oracle Virtual DirectoryリスナーのSSL MBeanの名前を取得します。

getSSLMBeanName('inst1',
'ovd1',
'ovd',
'LDAP SSL Endpoint')

このコマンドにより、指定されたインスタンス、コンポーネント名、コンポーネント・タイプおよびリスナーのSSL MBean名が返されます。

3. 次のコマンドでMBeanのキーストアおよびトラストストアのパスワードを設定します。

cd ('SSL_MBean_Name')
set('KeyStorePassword',java.lang.String('password').toCharArray())
set('TrustStorePassword',java.lang.String('password').toCharArray())

4. SSLプロパティでリスナーを構成します。

configureSSL('inst1',
'ovd1',
'ovd',
'LDAP SSL Endpoint')

注意:

ステップ2とステップ3は、サーバー認証モードおよび相互認証モードでのみ必要です。

その他の認証モードでのSSLの有効化

これは、パラメータにプロパティ・ファイルを使用して、適切な認証タイプ・パラメータ値を指定し、configureSSLコマンドを使用して行います。詳細は、Oracle Fusion Middleware Oracle Virtual Directory管理者ガイドのOracle Virtual Directoryリスナーの作成と管理に関する項を参照してください。

6.6.3 データベースでのSSLの構成

この項の項目は次のとおりです。

- Oracle DatabaseでのSSLの有効化

- データソースでのSSLの有効化

6.6.3.1 Oracle DatabaseでのSSLの有効化

次の手順を実行して、OracleデータベースでSSLを有効にします。

1. ルートCAとDBの証明書を作成します。次に例を示します。

注意:

本番で使用する場合、自己署名証明書はお薦めしません。本番ウォレットの取得の詳細は、自己署名付きウォレットのサード・パーティのウォレットへの変更に関する項を参照してください。

mkdir root
mkdir server

# Create root wallet, add self-signed certificate and export
orapki wallet create -wallet ./root -pwd password
orapki wallet add -wallet ./root -dn CN=root_test,C=US -keysize 2048 -self_signed -validity 3650 -pwd password
orapki wallet display -wallet ./root -pwd password
orapki wallet export -wallet ./root -dn CN=root_test,C=US -cert ./root/b64certificate.txt -pwd password

#Create server wallet, add self-signed certificate and export
orapki wallet create -wallet ./server -pwd password
orapki wallet add -wallet ./server -dn CN=server_test,C=US -keysize 2048 -pwd password
orapki wallet display -wallet ./server -pwd password
orapki wallet export -wallet ./server -dn CN=server_test,C=US -request ./server/creq.txt -pwd password

# Import trusted certificates
orapki cert create -wallet ./root -request ./server/creq.txt -cert ./server/cert.txt -validity 3650 -pwd password
orapki cert display -cert ./server/cert.txt -complete
orapki wallet add -wallet ./server -trusted_cert -cert ./root/b64certificate.txt -pwd password
orapki wallet add -wallet ./server -user_cert -cert ./server/cert.txt -pwd password
orapki wallet create -wallet ./server -auto_login -pwd password}}

2. データベースのlistener.ora、sqlnet.oraおよびtnsnames.oraを更新します。tnsnames.oraファイルは$ORACLE_BASE/network/adminにあります。その他のファイルは$ORACLE_HOME/network/adminにあります。

1. 次の例は、デフォルトのlistener.oraを示します。

SID_LIST_LISTENER =
(SID_LIST =(SID_DESC =(SID_NAME = PLSExtProc)(ORACLE_HOME = /path_to_O_H)(PROGRAM = extproc)))
LISTENER =(DESCRIPTION_LIST =(DESCRIPTION =
(ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1))
(ADDRESS = (PROTOCOL = TCP)(HOST = mynode.mycorp.com)(PORT = 1521))
(ADDRESS = (PROTOCOL = TCPS)(HOST = mynode.mycorp.com)(PORT = 2490))
))

WALLET_LOCATION=(SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=/wallet_location)))

SSL_CLIENT_AUTHENTICATION=FALSE}}

次に、更新されたlistener.oraファイルを示します。このシナリオではクライアント認証なしに指定しています。

SID_LIST_LISTENER =
(SID_LIST =
(SID_DESC =
(GLOBAL_DBNAME = dbname)
(ORACLE_HOME = /path_to_O_H)
(SID_NAME = sid)
)
)

SSL_CLIENT_AUTHENTICATION = FALSE

WALLET_LOCATION =
(SOURCE =
(METHOD = FILE)
(METHOD_DATA =
(DIRECTORY = /wallet_path)
)
)

LISTENER =
(DESCRIPTION_LIST =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1521))
)
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = mynode.mycorp.com)(PORT = 1521))
)
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCPS)(HOST = mycorp.com)(PORT = 2490))
)
)

SSLポートが追加されています。

2. 同様に、変更されたsqlnet.oraファイルは次のようになります。

NAMES.DIRECTORY_PATH= (TNSNAMES, EZCONNECT)
SQLNET.AUTHENTICATION_SERVICES=(BEQ,TCPS,NTS)
WALLET_LOCATION=(SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=/directory)))
SSL_CLIENT_AUTHENTICATION=FALSE

3. 変更されたtnsnames.oraファイルは次のようになります。

OID =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = mynode.mycorp.com)(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SERVICE_NAME = mynode.mycorp.com)
)
)

SSL =
(DESCRIPTION =
(ADDRESS_LIST =
(ADDRESS = (PROTOCOL = TCPS)(HOST = mynode.mycorp.com)(PORT = 2490))
)
(CONNECT_DATA =
(SERVICE_NAME = mynode.mycorp.com)
or
(SID = mynode.mycorp.com)
)
(SECURITY=(SSL_SERVER_CERT_DN=\"CN=server_test,C=US\"))
)

3. 新しい接続文字列を使用してデータベースへの接続をテストします。次に例を示します。

$ tnsping ssl
$ sqlplus username/password@ssl

関連項目:

Oracle Advanced Security管理者ガイドのSecure Sockets Layer認証の構成に関する項を参照してください。

6.6.3.2 データソースでのSSLの有効化

次の手順を実行して、SSLを使用するようにOracle WebLogic Server上のデータソースを構成します。

1. トラストストアを作成して、(データベースでSSLを有効にしたときに作成した)ルート証明書を、信頼できる証明書としてトラストストアに追加します。詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』を参照してください。

2. Oracle WebLogic Server管理コンソールで、使用しているデータソースの「接続プール」タブにナビゲートします。

注意:

Oracle WebCenter Portalデータソースなどの既存ソースや新しいデータソースをデータソースにできます。詳細は、『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』のJDBCデータ・ソースの作成に関する説明を参照してください。

「JDBCプロパティ」テキスト・ボックスで指定する必要があるプロパティは、構成する認証のタイプにより異なります。

- クライアント認証(双方向認証)が必要な場合:

javax.net.ssl.keyStore=..(password of the keystore)
javax.net.ssl.keyStoreType=JKS
javax.net.ssl.keyStorePassword=...(password of the keystore)
javax.net.ssl.trustStore=...(the truststore location on the disk)
javax.net.ssl.trustStoreType=JKS
javax.net.ssl.trustStorePassword=...(password of the truststore)

- クライアント認証が不要な場合:

javax.net.ssl.trustStore=...(the truststore location on the disk)
javax.net.ssl.trustStoreType=JKS
javax.net.ssl.trustStorePassword=...(password of the truststore)

3. 「URL」テキスト・ボックスにJDBC接続文字列を入力します。プロトコルがTCPSで、SSL_SERVER_CERT_DNにデータベース証明書の完全なDNが含まれていることを確認します。
tnsnames.oraが「SERVICE_NAME」を使用する場合は、次の構文を使用します。

jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCPS)(HOST=host-name)(PORT=port-number)))(CONNECT_DATA=(SERVICE_NAME=service))(SECURITY=(SSL_SERVER_CERT_DN="CN=server_test,C=US")))

tnsnames.oraが「SID」を使用する場合は、次の構文を使用します。

jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCPS)(HOST=host-name)(PORT=port-number)))(CONNECT_DATA=(SID=service))(SECURITY=(SSL_SERVER_CERT_DN="CN=server_test,C=US")))

4. 接続をテストおよび検証します。この時点で、データソースはSSLを使用するように構成されています。

6.7 高度なSSLの使用事例

この項では、前述の基本的なトポロジを超えた高度なSSL構成のシナリオを処理する方法について説明します。

- ハードウェア・セキュリティ・モジュールとアクセラレータ

- CRLとSSLとの統合

- Oracle Fusion MiddlewareのFIPS 140-2の設定

この項で使用されているコマンドの詳細および例は、第6.9項を参照してください。

6.7.1 ハードウェア・セキュリティ・モジュールとアクセラレータ

ハードウェア・セキュリティ・モジュール(HSM)は、コンピュータに組み込むことができる物理的なプラグイン・カードまたは外部セキュリティ・デバイスで、セキュアなストレージ環境を提供し機密コンテンツを扱うことができます。

注意:

この説明は、Oracle HTTP Server、Oracle Web CacheおよびOracle Internet Directoryにのみ適用されます。これらは、HSMをサポートするシステム・コンポーネントです。

Oracle Fusion Middlewareでは、PKCS#11規格に準拠したHSMデバイスをサポートし、秘密鍵を使用したセキュアなストレージ環境を提供します。

次の手順を実行し、PKCS#11ウォレットを使用してコンポーネントでSSLを実装します。

1. コンポーネントが稼働しているマシンにHSMライブラリをインストールします。これは、1回かぎりのタスクでデバイスに依存します。

2. 次に、Oracle Wallet Manager(OWM)またはorapkiコマンドライン・ツールを使用してウォレットを作成します。次の点に注意してください。

1. ウォレット・タイプとして「PKCS11」を選択します。

2. デバイスとの通信に使用されるデバイス固有のPKCS#11ライブラリを指定します。このライブラリは、HSMソフトウェアの一部です。
Linuxでは、ライブラリは次の場所にあります。

For LunaSA (Safenet):  /usr/lunasa/lib/libCryptoki2.so
For nCipher:  /opt/nfast/toolkits/pkcs11/libcknfast.so

Windowsでは、ライブラリは次の場所にあります。

For LunaSA (Safenet): C:\Program Files\LunaSA\cryptoki.dll

3. ここで、第三者の証明書を取得するための標準的な手順を実行します。つまり、証明書リクエストを作成し、認証局(CA)で承認されたリクエストを取得して、そのCAで署名された証明書をインストールします。
設定したウォレットは、他のウォレットと同様に使用されます。

4. orapkiユーティリティでウォレットを確認します。次のコマンド構文を使用します。

orapki wallet p11_verify [-wallet [wallet]] [-pwd password]

関連項目:

orapkiの詳細は、付録H「Oracle Wallet Managerおよびorapki」を参照してください。

5. configureSSL WLSTコマンドを使用して、コンポーネントのリスナーでSSLを構成します。このコマンドは入力にプロパティ・ファイルを指定します。プロパティ・ファイルでは、コンポーネントが稼働しているマシンのPKCS#11ウォレット・ディレクトリのフルパスを指定する必要があります。(注意: PKCS#11ウォレットをインスタンス・ホーム・ディレクトリに保存しないでください。Fusion Middleware ControlまたはWLSTを介して作成および管理されるウォレットのみがインスタンス・ホームに存在する必要があります。)
サンプルのプロパティ・ファイルは、次のようになります。

SSLEnabled=true
AuthenticationType=Server
PKCS11Wallet=/tmp/lunasa/wallet

注意:

WLSTコマンドのconfigureSSLを使用して、PKCS11ウォレットを構成する必要があります。Fusion Middleware Controlまたはその他のツールを使用してこのタスクを実行することはできません。

6.7.2 CRLとSSLとの統合

Oracle HTTP Server(OHS)、Oracle Internet Directory(OID)またはWebCacheに対するSSL構成の管理時には、ファイルまたはファイル・システム・フォルダ名を指定することにより、使用するCRLを指定できます。SSL構成自体はこのファイルまたはフォルダ名を解釈しません。この構成をコンポーネントに渡すだけです。

注意:

- この項の内容は、Oracle WebLogic Server環境におけるOracle HTTP ServerおよびOracle Web Cacheにのみ適用されます。スタンドアロン・コンポーネントでのSSL構成の詳細は、『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』および『Oracle Fusion Middleware Oracle Web Cache管理者ガイド』を参照してください。

- CRL検証の構成は、WLSTを使用して行います。Fusion Middleware Controlを使用して、このタスクを実行することはできません。

- この項では、CRLを実際に管理する方法については説明しません。CRLはorapkiユーティリティを使用して管理します。

SSLを使用するコンポーネントは、オプションで証明書失効リスト(CRL)を使用した証明書の検証を有効にできます。これによりそのコンポーネントでは、SSLハンドシェイクでピア証明書を検証して、認証局(CA)で発行された失効済証明書のリストにそれがないか確認できます。

この項では、CRLベースの検証を使用するようにコンポーネントを構成する方法、およびファイル・システム上にCRLを作成および設定する方法を説明します。

6.7.2.1 コンポーネントのCRL検証の構成

configureSSL WLSTコマンドを使用して、コンポーネントのリスナーでSSLを構成します。このコマンドは入力にプロパティ・ファイルを指定します。

プロパティ・ファイルは、次のように設定する必要があります。

1. 「CertValidation」属性は「url」に設定する必要があります。

2. 「CertValidationPath」属性は、「file://file_path」または「dir://directory_path」という形式にする必要があります。

- 証明書の検証に単一のCRLファイルを使用している場合、最初の形式を使用します。このCRLファイルは、すべてのCRLファイルを結合する必要があります。

- 複数のCRLファイルがハッシュ形式で格納されているディレクトリ・パスを指定する場合、2番目の形式を使用します。
ハッシュ形式でCRLを作成する方法の詳細は、第6.7.2.2項「ファイル・システムでのCRLの管理」を参照してください。

次の例では、プロパティ・ファイルは単一のCRLファイルを指定します。

SSLEnabled=true
AuthenticationType=Server
CertValidation=crl
KeyStore=ohs1
CertValidationPath=file:///tmp/file.crl

次の例では、プロパティ・ファイルは複数のCRLファイルへのディレクトリ・パスを指定しています。

SSLEnabled=true
AuthenticationType=Server
KeyStore=ohs1
CertValidation=crl
CertValidationPath=dir:///tmp

6.7.2.2 ファイル・システムでのCRLの管理

orapkiコマンドライン・ツールを使用して、ファイル・システム上でCRLを管理します。このトピックの詳細は、第H.2.5項「orapkiユーティリティを使用した証明書失効リスト(CRL)の管理」を参照してください。

ハッシュ形式へのCRLの名前変更

CRL格納場所を指定する場合は、CRLの名前を変更する必要があります。これにより、実行時に効率的にCRLをロードできます。この操作では、実際のCRLファイルへのシンボリック・リンクを作成します。Windowsでは、CRLは新しい名前のファイルにコピーされます。

CRLの名前を変更するには:

orapki crl hash
[-crl [url|filename]] [-wallet wallet] [-symlink directory]
[-copy directory] [-summary] [-pwd password]

次に例を示します。

orapki crl hash -crl nzcrl.txt -symlink wltdir -pwd password

CRLファイル名を実行時に指定すると、複数のCRLをそのファイルに結合できます。この例で作成されるCRLはBase64形式なので、テキスト・エディタを使用してCRLを結合できます。

CRLの作成

注意:

CRLの作成および証明書の失効はテスト目的で行い、必ず自己署名証明書とともに使用します。本番で使用する場合、本番の証明書を有名なCAから取得して、CRLをそれらの認証局から取得します。

CRLを作成するには:

orapki crl create
[-crl [url|filename]] [-wallet [cawallet]] [-nextupdate [days]] [-pwd password]

次に例を示します。

orapki crl create
-crl nzcrl.crl -wallet rootwlt -nextupdate 3650 -pwd password

証明書の失効

証明書が失効すると、証明書のシリアル番号がCRLに追加されます。

証明書を失効させるには:

orapki crl revoke
[-crl [url|filename]] [-wallet [cawallet]] [-cert   [revokecert]] [-pwd password]

次に例を示します。

orapki crl revoke
-crl nzcrl.txt -wallet rootwlt -cert cert.txt -pwd password

6.7.2.3 CRL検証が構成されたコンポーネントのテスト

コンポーネントでCRL検証が正しく構成されていることをテストするには、次の手順を実行します。

1. コンポーネントで使用される証明書をウォレットに設定します。

2. この証明書を含むCRLを失効済証明書リストの中に生成します。第6.7.2.2項「ファイル・システムでのCRLの管理」で説明されている手順を実行します。

3. このCRLを使用するようにコンポーネントを構成します。第6.7.2.1項「コンポーネントのCRL検証の構成」で説明されている手順を実行します。

4. この失効済証明書を使用すると、SSLハンドシェイクは失敗します。

6.7.3 Oracle Fusion MiddlewareのFIPS 140-2の設定

この項では、FIPS 140-2の高度なセキュリティ規格に適合するようにOracle Fusion Middlewareコンポーネントを構成する方法について説明します。この項の項目は次のとおりです。

- FIPSで構成可能な製品

- SSLFIPS_140パラメータの設定

- 暗号スイートの選択

- その他の構成パラメータ

関連項目:

この規格の詳細は、次の暗号化モジュール検証プログラムのWebサイトを参照してください。

http://csrc.nist.gov/groups/STM/index.html

6.7.3.1 FIPSで構成可能な製品

Oracle SSL SDKを使用する製品は、FIPSモードで実行するように構成できます。特に、次のOracle Fusion Middlewareコンポーネントを構成できます。

- Oracle HTTP Server

- Oracle Web Cache

- Oracle Internet Directory

6.7.3.2 SSLFIPS_140パラメータの設定

これらのコンポーネントをFIPSモードで実行するように構成するには、fips.oraファイルでSSLFIPS_140パラメータをTRUEに設定します。

SSLFIPS_140=TRUE

このファイルは標準装備ではないので、作成する必要があります。fips.oraは、$ORACLE_HOME/ldap/adminディレクトリ、またはFIPS_HOME環境変数で指定されたディレクトリに配置します。

SSLFIPS_140パラメータは、デフォルトではFALSEに設定されます。FIPSモードで操作するには、これをTRUEに設定する必要があります。

6.7.3.3 暗号スイートの選択

暗号スイートは、ネットワーク・ノード間のメッセージ交換に使用される認証、暗号化およびデータ整合性アルゴリズムのセットです。たとえば、SSLハンドシェイク時に、2つのノードでネゴシエーションを行い、メッセージを交換するときにどの暗号スイートを使用するかを確認します。

FIPSモードで使用する場合、次の暗号スイートのみが承認されます。

SSL_RSA_WITH_3DES_EDE_CBC_SHA
SSL_DH_anon_WITH_3DES_EDE_CBC_SHA
TLS_RSA_WITH_AES_128_CBC_SHA
TLS_RSA_WITH_AES_256_CBC_SHA

FIPSモードで稼働中に別の暗号を使用しないでください。

カンマ区切りの値を使用してこれらの1つ以上の暗号を構成できます。これらは、WLST configureSSLコマンドのキー「Ciphers」のSSLプロパティ・ファイルまたはFusion Middleware Controlで指定する必要があります。

configureSSLコマンドでのSSLプロパティ・ファイルの指定の詳細は、第6.9.28項「SSL用プロパティ・ファイル」を参照してください。

6.7.3.4 その他の構成パラメータ

FIPSモードを有効にするための最小キー・サイズは、1024ビットです。FIPSモードで使用されるキーのサイズが1024ビット以上であることを確認する必要があります。これは、Oracle HTTP Server、Oracle Web Cache、Oracle Internet Directoryなどのコンポーネントで使用されるウォレットの証明書の公開鍵が最小サイズの1024ビットである必要があるためです。

SSLConfig、Oracle Wallet Manager、orapkiなどのOracleツールを使用して作成されたウォレットのみを使用できます。サードパーティのPKCS#12ウォレット・ファイルは、FIPSモードでは使用できません。

6.8 SSLのベスト・プラクティス

この項では、Oracle Fusion Middlewareコンポーネント管理者およびアプリケーション開発者のいくつかのベスト・プラクティスの概要を説明します。これらの項目が含まれます。

- 管理者のベスト・プラクティス

- アプリケーション開発者のベスト・プラクティス

6.8.1 管理者のベスト・プラクティス

システム管理者のベスト・プラクティスには、次のようなものがあります。

- 自己署名付きウォレットはテスト環境でのみ使用します。本番環境に移行する前にウォレットにCAで署名された証明書を取得する必要があります。詳細は、第8章「キーストア、ウォレットおよび証明書の管理」を参照してください。

- (少なくともWeb層の)コンポーネントでは、DNとしてシステム・ホスト名あるいは仮想ホストまたはサイト名を持つ証明書を使用することをお薦めします。そうすることにより、混乱させる警告メッセージが表示されることなく、ブラウザはSSLモードで接続できます。

- SSLで使用される証明書では、最小キー・サイズの1024ビットを使用することをお薦めします。キー・サイズを大きくすると、セキュリティは高くなりますが、パフォーマンスが低下します。セキュリティおよびパフォーマンス要件に応じて、適切なキー・サイズ値を選択します。

- SSLハンドシェイクが失敗する主な原因の1つに信頼性が欠落していることがあります。SSLハンドシェイクを開始する前に、(サーバーCA証明書をクライアント・キーストアにインポートして)クライアントがサーバーを信頼していることを確認してください。クライアント認証も必要な場合は、その逆も確認する必要があります。

6.8.2 アプリケーション開発者のベスト・プラクティス

次のプラクティスをお薦めします。

- Javaキーストア(JKS)を使用してJava EEアプリケーションの証明書を保存します。

- キーストア・パス、トラストストア・パス、構成ファイルの認証タイプなどのSSL構成パラメータは、アプリケーション・コードのそれぞれの値に埋め込まず、外部に配置します。そうすることで、アプリケーション自体を変更せずに柔軟にSSL構成を変更できます。

6.9 SSL関連のWLSTリファレンス

11g リリース1(11.1.1)以降、OracleウォレットおよびJKSキーストアを管理するためのWLSTコマンド、およびOracle Fusion MiddlewareコンポーネントでSSLを構成するためのWLSTコマンドが追加されました。

このタスクでは、表6-1、表6-2および表6-3にリストされているコマンドを使用します。

関連項目:

WLSTシェルを起動してSSL関連コマンドを実行する方法の詳細は、キーストアおよびウォレット用コマンドライン・インタフェースに関する項を参照してください。その他の場所からはWLSTインタフェースを起動しないでください。

注意:

SSL構成用のすべてのWLSTコマンドは、オンライン・モードで実行する必要があります。

各コマンドは、次のように指定してヘルプを表示できます。

help('command_name')

特定のコマンドには、インスタンス名、iasコンポーネント、プロセス・タイプなどのパラメータが必要です。この情報は、次のコマンドで取得できます。

$ORACLE_INSTANCE/bin/opmnctl status

表6-1 SSL構成用WLSTコマンド

使用するコマンド

使用目的

WLSTによる使用

configureSSL

コンポーネント・リスナーのSSL属性を設定します。

オンライン

getSSL

コンポーネント・リスナーのSSL属性を表示します。

オンライン

表6-2 Oracleウォレット管理用WLSTコマンド

使用するコマンド

使用目的

WLSTによる使用

addCertificateRequest

Oracleウォレットに証明書署名リクエストを生成します。

オンライン

addSelfSignedCertificate

自己署名証明書をOracleウォレットに追加します。

オンライン

changeWalletPassword

Oracleウォレットのパスワードを変更します。

オンライン

createWallet

Oracleウォレットを作成します。

オンライン

deleteWallet

Oracleウォレットを削除します。

オンライン

exportWallet

Oracleウォレットをファイルにエクスポートします。

オンライン

exportWalletObject

オブジェクト(証明書など)をOracleウォレットからファイルにエクスポートします。

オンライン

getWalletObject

Oracleウォレットに存在する証明書またはその他のオブジェクトを表示します。

オンライン

importWallet

Oracleウォレットをファイルからインポートします。

オンライン

importWalletObject

証明書またはその他のオブジェクトをファイルからOracleウォレットにインポートします。

オンライン

listWalletObjects

Oracleウォレットに存在するすべてのオブジェクト(証明書など)を表示します。

オンライン

listWallets

コンポーネント・インスタンスで構成されるすべてのOracleウォレットを表示します。

オンライン

removeWalletObject

証明書またはその他のオブジェクトをコンポーネント・インスタンスのOracleウォレットから削除します。

オンライン

表6-3 Javaキーストア(JKS)管理用WLSTコマンド

使用するコマンド

使用目的

WLSTによる使用

changeKeyStorePassword

JKSキーストアのパスワードを変更します。

オンライン

createKeyStore

JKSキーストアを作成します。

オンライン

deleteKeyStore

JKSキーストアを削除します。

オンライン

exportKeyStore

JKSキーストアをファイルにエクスポートします。

オンライン

exportKeyStoreObject

オブジェクト(証明書など)をJKSキーストアからファイルにエクスポートします。

オンライン

generateKey

JKSキーストアの鍵のペアを生成します。

オンライン

getKeyStoreObject

JKSキーストアに存在する証明書またはその他のオブジェクトを表示します。

オンライン

importKeyStore

JKSキーストアをファイルからインポートします。

オンライン

importKeyStoreObject

証明書またはその他のオブジェクトをファイルからJKSキーストアにインポートします。

オンライン

listKeyStoreObjects

JKSキーストアに存在するすべてのオブジェクト(証明書など)をリストします。

オンライン

listKeyStores

コンポーネント・インスタンスで構成されるすべてのJKSキーストアをリストします。

オンライン

removeKeyStoreObject

証明書またはその他のオブジェクトをコンポーネント・インスタンスのJKSキーストアから削除します。

オンライン

注意:

WLSTを使用する場合、証明書はPEMフォーマットのみでインポートできます。

6.9.1 addCertificateRequest

Oracleウォレットに証明書署名リクエストを生成するオンライン・コマンドです。

6.9.1.1 説明

このコマンドにより、コンポーネント・インスタンス(Oracle HTTP Server、Oracle WebCacheまたはOracle Internet Directory)のOracleウォレットにBase64でエンコードされたPKCS#10形式の証明書署名リクエストを生成します。認証局(CA)で署名された証明書を取得するには、証明書署名リクエストをCAに送信します。

6.9.1.2 構文

addCertificateRequest('instName', 'compName', 'compType', 'walletName', 'password', 'DN', 'keySize')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「oid」、「ohs」および「webcache」です。

walletName

ウォレット・ファイルの名前を指定します。

password

ウォレットのパスワードを指定します。

DN

鍵ペアのエントリの識別名を指定します。

keySize

鍵サイズをビット単位で指定します。

6.9.1.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1で、DNがcn=www.acme.comでキー・サイズが1024の証明書署名リクエストがwallet1に生成されます。

wls:/mydomain/serverConfig> addCertificateRequest('inst1', 'oid1', 'oid','wallet1', 'password', 'cn=www.acme.com', '1024',)

6.9.2 addSelfSignedCertificate

自己署名証明書を追加するオンライン・コマンドです。

6.9.2.1 説明

このコマンドにより、鍵ペアを作成して、指定されたコンポーネント・インスタンス(Oracle HTTP Server、Oracle WebCacheまたはOracle Internet Directory)のOracleウォレットの自己署名証明書でラップします。RSAアルゴリズムに基づいた鍵のみが生成されます。

6.9.2.2 構文

addSelfSignedCertificate('instName', 'compName', 'compType', 'walletName',                         'password', 'DN', 'keySize')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「oid」、「ohs」および「webcache」です。

walletName

ウォレット・ファイルの名前を指定します。

password

ウォレットのパスワードを指定します。

DN

鍵ペアのエントリの識別名を指定します。

keySize

鍵サイズをビット単位で指定します。

6.9.2.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1で、DNがcn=www.acme.comでキー・サイズが1024の自己署名証明書がwallet1に追加されます。

wls:/mydomain/serverConfig> addSelfSignedCertificate('inst1', 'oid1', 'oid','wallet1', 'password', 'cn=www.acme.com', '1024')

6.9.3 changeKeyStorePassword

キーストアのパスワードを変更するオンライン・コマンドです。

6.9.3.1 説明

このコマンドにより、Oracle Virtual DirectoryインスタンスのJavaキーストア(JKS)ファイルのパスワードを変更します。

6.9.3.2 構文

changeKeyStorePassword('instName', 'compName', 'compType', 'keystoreName', 'currPassword', 'newPassword')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「ovd」です。

keystoreName

キーストアのファイル名を指定します。

currPassword

現在のキーストア・パスワードを指定します。

newPassword

新しいキーストア・パスワードを指定します。

6.9.3.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1のファイルkeys.jksのパスワードが変更されます。

wls:/mydomain/serverConfig> changeKeyStorePassword('inst1', 'ovd1', 'ovd','keys.jks', 'currpassword', 'newpassword')

6.9.4 changeWalletPassword

Oracleウォレットのパスワードを変更するオンライン・コマンドです。

6.9.4.1 説明

このコマンドにより、指定されたコンポーネント・インスタンス(Oracle HTTP Server、Oracle WebCacheまたはOracle Internet Directory)のOracleウォレットのパスワードを変更します。このコマンドは、パスワードで保護されたウォレットにのみ適用されます。

6.9.4.2 構文

changeWalletPassword('instName', 'compName', 'compType', 'walletName','currPassword', 'newPassword')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「oid」、「ohs」および「webcache」です。

walletName

ウォレットのファイル名を指定します。

currPassword

現在のウォレット・パスワードを指定します。

newPassword

新しいウォレット・パスワードを指定します。

6.9.4.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle HTTP Serverインスタンスohs1のwallet1のパスワードがcurrpasswordからnewpasswordに変更されます。

wls:/mydomain/serverConfig> changeWalletPassword('inst1', 'ohs1', 'ohs','wallet1', 'currpassword', 'newpassword')

6.9.5 configureSSL

SSL属性を設定するオンライン・コマンドです。

6.9.5.1 説明

このコマンドにより、コンポーネント・リスナーのSSL属性を設定します。属性はプロパティ・ファイル形式(name=value)で指定します。このファイルが指定されない場合、またはそのファイルにSSL属性が含まれていない場合、デフォルトの属性値が使用されます。

プロパティ・ファイルの形式の詳細は、第6.9.28項「SSL用プロパティ・ファイル」を参照してください。

6.9.5.2 構文

configureSSL('instName', 'compName', 'compType', 'listener', 'filePath')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「oid」、「ovd」、「ohs」および「webcache」です。

listener

SSLで構成するコンポーネント・リスナーの名前を指定します。

filePath

設定するSSL属性を含むプロパティ・ファイルの絶対パスを指定します。

6.9.5.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1のリスナーlistener1に対して、プロパティ・ファイル/tmp/ssl.propertiesで指定されたSSL属性が構成されます。

wls:/mydomain/serverConfig> configureSSL('inst1', 'ovd1', 'ovd', 'listener1','/tmp/ssl.properties')

次のコマンドでは、プロパティ・ファイルを指定せずにSSL属性を構成します。ファイルが指定されないので、デフォルトのSSL属性値が使用されます。

wls:/mydomain/serverConfig> configureSSL('inst1', 'ovd1', 'ovd', 'listener2')

6.9.6 createKeyStore

JKSキーストアを作成するオンライン・コマンドです。

6.9.6.1 説明

このコマンドにより、指定されたOracle Virtual DirectoryインスタンスのJavaキーストア(JKS)を作成します。キーストア・ファイルの場所およびその他の情報の詳細は、キーストアの場所に関する項を参照してください。

6.9.6.2 構文

createKeyStore('instName', 'compName', 'compType', 'keystoreName', 'password')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「ovd」です。

keystoreName

作成するキーストア・ファイルのファイル名を指定します。

password

キーストア・パスワードを指定します。

6.9.6.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1のJKSファイルkeys.jksが、パスワードpassword で作成されます。

wls:/mydomain/serverConfig> createKeyStore('inst1', 'ovd1', 'ovd','keys.jks', 'password')

6.9.7 createWallet

Oracleウォレットを作成するオンライン・コマンドです。

6.9.7.1 説明

このコマンドにより、指定されたコンポーネント・インスタンス(Oracle HTTP Server、Oracle WebCacheまたはOracle Internet Directory)のOracleウォレットを作成します。ウォレットは、パスワードで保護することも自動ログイン・タイプにすることもできます。ウォレットの詳細は、第8章「キーストア、ウォレットおよび証明書の管理」を参照してください。

6.9.7.2 構文

createWallet('instName', 'compName', 'compType', 'walletName', 'password')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「oid」、「ohs」および「webcache」です。

walletName

作成するウォレット・ファイルの名前を指定します。

password

ウォレットのパスワードを指定します。

6.9.7.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle HTTP Serverインスタンスohs1のwallet1というウォレットが、パスワードpasswordで作成されます。

wls:/mydomain/serverConfig> createWallet('inst1', 'ohs1', 'ohs','wallet1', 'password')

次のコマンドにより、アプリケーション・サーバー・インスタンスinst1のOracle WebCacheインスタンスwc1に対して、wallet2という自動ログイン・ウォレットが作成されます。

wls:/mydomain/serverConfig> createWallet('inst1', 'wc1', 'webcache','wallet2', '')

6.9.8 deleteKeyStore

キーストアを削除するオンライン・コマンドです。

6.9.8.1 説明

このコマンドにより、指定されたOracle Virtual Directoryインスタンスのキーストアを削除します。

6.9.8.2 構文

deleteKeyStore('instName', 'compName', 'compType', 'keystoreName')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「ovd」です。

keystoreName

削除するキーストア・ファイルの名前を指定します。

6.9.8.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1のJKSファイルkeys.jksが削除されます。

wls:/mydomain/serverConfig> deleteKeyStore('inst1', 'ovd1', 'ovd','keys.jks')

6.9.9 deleteWallet

Oracleウォレットを削除するオンライン・コマンドです。

6.9.9.1 説明

このコマンドにより、指定されたコンポーネント・インスタンス(Oracle HTTP Server、Oracle WebCacheまたはOracle Internet Directory)のOracleウォレットを削除します。

6.9.9.2 構文

deleteWallet('instName', 'compName', 'compType', 'walletName')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「oid」、「ohs」および「webcache」です。

walletName

削除するウォレット・ファイルの名前を指定します。

6.9.9.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle HTTP Serverインスタンスohs1のwallet1というウォレットが削除されます。

wls:/mydomain/serverConfig> deleteWallet('inst1', 'ohs1', 'ohs','wallet1')

6.9.10 exportKeyStore

キーストアをファイルにエクスポートするオンライン・コマンドです。

6.9.10.1 説明

このコマンドでは、指定されたOracle Virtual Directoryインスタンスで構成されたキーストアを、指定されたディレクトリの下のファイルにエクスポートします。エクスポートされたファイルの名前は、キーストア名と同じになります。

6.9.10.2 構文

exportKeyStore('instName', 'compName', 'compType', 'keystoreName',               'password', 'path')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「ovd」です。

keystoreName

キーストア・ファイルの名前を指定します。

password

キーストアのパスワードを指定します。

path

キーストアのエクスポート先ディレクトリの絶対パスを指定します。

6.9.10.3 例

次のコマンドでは、Oracle Virtual Directoryインスタンスovd1のキーストアkeys.jksが/tmpの下のファイルkeys.jksにエクスポートされます。

wls:/mydomain/serverConfig> exportKeyStore('inst1', 'ovd1', 'ovd', 'keys.jks', 'password', '/tmp')

6.9.11 exportKeyStoreObject

オブジェクトをキーストアからファイルにエクスポートするオンライン・コマンドです。

6.9.11.1 説明

このコマンドでは、Javaキーストア(JKS)に存在する証明書署名リクエスト、証明書や証明書チェーン、または信頼できる証明書を、指定されたOracle Virtual Directoryインスタンスのファイルにエクスポートします。証明書署名リクエストは、オブジェクトをエクスポートする前に生成されます。エクスポートするオブジェクトを別名で指定します。

6.9.11.2 構文

exportKeyStoreObject('instName', 'compName', 'compType', 'keystoreName', 'password', 'type', 'path', 'alias')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「ovd」です。

keystoreName

キーストア・ファイルの名前を指定します。

password

キーストアのパスワードを指定します。

type

エクスポートするキーストア・オブジェクトのタイプを指定します。有効な値は、「CertificateRequest」、「Certificate」、「TrustedCertificate」および「TrustedChain」です。

path

base64.txtという名前のファイルとしてオブジェクトをエクスポートする先のディレクトリの絶対パスを指定します。

alias

エクスポートするキーストア・オブジェクトの別名を指定します。

6.9.11.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1で、keys.jksに別名mykeyで示される鍵のペアから証明書署名リクエストが生成されてエクスポートされます。証明書署名リクエストは、ディレクトリ/tmpの下にエクスポートされます。

wls:/mydomain/serverConfig> exportKeyStoreObject('inst1', 'ovd1', 'ovd','keys.jks', 'password', 'CertificateRequest', '/tmp','mykey')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1で、keys.jksに別名mykeyで示される証明書または証明書チェーンがエクスポートされます。証明書または証明書チェーンは、ディレクトリ/tmpの下にエクスポートされます。

wls:/mydomain/serverConfig> exportKeyStoreObject('inst1', 'ovd1', 'ovd','keys.jks', 'password', 'Certificate', '/tmp','mykey')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1で、keys.jksに別名mykeyで示される信頼できる証明書がエクスポートされます。信頼できる証明書は、ディレクトリ/tmpの下にエクスポートされます。

wls:/mydomain/serverConfig> exportKeyStoreObject('inst1', 'ovd1', 'ovd','keys.jks', 'password', 'TrustedCertificate', '/tmp','mykey')

6.9.12 exportWallet

Oracleウォレットをエクスポートするオンライン・コマンドです。

6.9.12.1 説明

このコマンドにより、指定されたコンポーネント・インスタンス(Oracle HTTP Server、Oracle WebCacheまたはOracle Internet Directory)で構成されたOracleウォレットを、指定されたディレクトリの下のファイルにエクスポートします。エクスポートされたファイルが自動ログインのみのウォレットの場合、そのファイル名はcwallet.ssoになります。それがパスワードで保護されたウォレットの場合、ewallet.p12とcwallet.ssoという2つのファイルが作成されます。

6.9.12.2 構文

exportWallet('instName', 'compName', 'compType', 'walletName','password', 'path')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「oid」、「ohs」および「webcache」です。

walletName

ウォレット・ファイルの名前を指定します。

password

ウォレットのパスワードを指定します。

path

オブジェクトのエクスポート先ディレクトリの絶対パスを指定します。

6.9.12.3 例

次のコマンドでは、Oracle Internet Directoryインスタンスoid1の自動ログイン・ウォレットwallet1が/tmpの下のファイルcwallet.ssoにエクスポートされます。

wls:/mydomain/serverConfig> exportWallet('inst1', 'oid1', 'oid', 'wallet1','','/tmp')

次のコマンドでは、Oracle Internet Directoryインスタンスoid1のパスワードで保護されたウォレットwallet2が、/tmpの下のewallet.p12とcwallet.ssoの2つのファイルにエクスポートされます。

wls:/mydomain/serverConfig> exportWallet('inst1', 'oid1', 'oid', 'wallet2', 'password', '/tmp')

6.9.13 exportWalletObject

証明書またはその他のウォレット・オブジェクトをファイルにエクスポートするオンライン・コマンドです。

6.9.13.1 説明

このコマンドにより、Oracleウォレットに存在する証明書署名リクエスト、証明書、証明書チェーンまたは信頼できる証明書を、指定されたコンポーネント・インスタンス(Oracle HTTP Server、Oracle WebCacheまたはOracle Internet Directory)のファイルにエクスポートします。DNは、エクスポートするオブジェクトを示します。

6.9.13.2 構文

exportWalletObject('instName', 'compName', 'compType', 'walletName', 'password', 'type', 'path', 'DN')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「oid」、「ohs」および「webcache」です。

walletName

ウォレット・ファイルの名前を指定します。

password

ウォレットのパスワードを指定します。

type

エクスポートするウォレット・オブジェクトのタイプを指定します。有効な値は、「CertificateRequest」、「Certificate」、「TrustedCertificate」または「TrustedChain」です。

path

ファイルbase64.txtとしてオブジェクトをエクスポートする先のディレクトリの絶対パスを指定します。

DN

エクスポートするウォレット・オブジェクトの識別名を指定します。

6.9.13.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1の、wallet1内のDN cn=www.acme.comの証明書署名リクエストがエクスポートされます。証明書署名リクエストは、ディレクトリ/tmpの下にエクスポートされます。

wls:/mydomain/serverConfig> exportWalletObject('inst1', 'oid1', 'oid','wallet1', 'password', 'CertificateRequest', '/tmp','cn=www.acme.com')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1の、wallet1内のDN cn=www.acme.comの証明書がエクスポートされます。証明書または証明書チェーンは、ディレクトリ/tmpの下にエクスポートされます。

wls:/mydomain/serverConfig> exportWalletObject('inst1', 'oid1', 'oid','wallet1', 'password', 'Certificate', '/tmp','cn=www.acme.com')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1の、wallet1内のDN cn=www.acme.comの信頼できる証明書がエクスポートされます。信頼できる証明書は、ディレクトリ/tmpの下にエクスポートされます。

wls:/mydomain/serverConfig> exportWalletObject('inst1', 'oid1', 'oid','wallet1', 'password', 'TrustedCertificate', '/tmp','cn=www.acme.com')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1の、wallet1内のDN cn=www.acme.comの証明書チェーンがエクスポートされます。証明書または証明書チェーンは、ディレクトリ/tmpの下にエクスポートされます。

wls:/mydomain/serverConfig> exportWalletObject('inst1', 'oid1', 'oid','wallet1', 'password', 'TrustedChain', '/tmp','cn=www.acme.com')

6.9.14 generateKey

Javaキーストアの鍵のペアを生成するオンライン・コマンドです。

6.9.14.1 説明

このコマンドでは、Oracle Virtual DirectoryのJavaキーストア(JKS)の鍵のペアを生成します。これにより、自己署名証明書の鍵のペアもラップします。RSAアルゴリズムに基づいた鍵のみが生成されます。

6.9.14.2 構文

generateKey('instName', 'compName', 'compType', 'keystoreName', 'password', 'DN', 'keySize', 'alias', 'algorithm')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「ovd」です。

keystoreName

キーストアの名前を指定します。

password

キーストアのパスワードを指定します。

DN

鍵ペアのエントリの識別名を指定します。

keySize

鍵サイズをビット単位で指定します。

alias

キーストアの鍵ペアのエントリの別名を指定します。

algorithm

鍵のアルゴリズムを指定します。有効な値は、「RSA」です。

6.9.14.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1で、DNがcn=www.acme.com、キー・サイズが1024、アルゴリズムがRSA、およびkeys.jksの別名mykeyで、鍵のペアが生成されます。

wls:/mydomain/serverConfig> generateKey('inst1', 'ovd1', 'ovd','keys.jks', 'password', 'cn=www.acme.com', '1024', 'mykey', 'RSA')

次のコマンドは、鍵のアルゴリズムを明示的に指定していないこと以外は前述と同じです。

wls:/mydomain/serverConfig> generateKey('inst1', 'ovd1', 'ovd','keys.jks', 'password', 'cn=www.acme.com', '1024', 'mykey')

6.9.15 getKeyStoreObject

キーストア・オブジェクトの詳細を表示するオンライン・コマンドです。

6.9.15.1 説明

このコマンドでは、Oracle Virtual DirectoryのJavaキーストア(JKS)に存在する特定の証明書または信頼できる証明書を表示します。キーストア・オブジェクトは、listKeyStoreObjectsコマンドで指定される索引番号で示されます。DN、キー・サイズ、アルゴリズムなどの証明書詳細情報が表示されます。

6.9.15.2 構文

getKeyStoreObject('instName', 'compName', 'compType', 'keystoreName', 'password', 'type', 'index')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「ovd」です。

keystoreName

キーストア・ファイルの名前を指定します。

password

キーストアのパスワードを指定します。

type

一覧表示するキーストア・オブジェクトのタイプを指定します。有効な値は、「Certificate」および「TrustedCertificate」です。

index

listKeyStoreObjectsコマンドで返されるキーストア・オブジェクトの索引番号を指定します。

6.9.15.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1で、keys.jksに存在する索引1の信頼できる証明書が表示されます。

wls:/mydomain/serverConfig> getKeyStoreObject('inst1', 'ovd1', 'ovd','keys.jks', 'password', 'TrustedCertificate', '1')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1で、keys.jksに存在する索引1の証明書が表示されます。

wls:/mydomain/serverConfig> getKeyStoreObject('inst1', 'ovd1', 'ovd','keys.jks', 'password', 'Certificate', '1')

6.9.16 getSSL

構成されたSSL属性を一覧表示するオンライン・コマンドです。

6.9.16.1 説明

このコマンドにより、指定されたコンポーネント・リスナーに構成されたSSL属性を一覧表示します。Oracle Internet Directoryでは、リスナー名は常に「sslport1」です。

6.9.16.2 構文

getSSL('instName', 'compName', 'compType', 'listener')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「ovd」、「oid」、「ohs」および「webcache」です。

listener

コンポーネント・リスナーの名前を指定します。

6.9.16.3 例

次のコマンドにより、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1のリスナーsslport1で構成されるSSL属性が表示されます。

wls:/mydomain/serverConfig> getSSL('inst1', 'oid1', 'oid', 'sslport1')

6.9.17 getWalletObject

Oracleウォレットの証明書やその他のオブジェクトに関する情報を表示するオンライン・コマンドです。

6.9.17.1 説明

このコマンドにより、指定されたコンポーネント・インスタンス(Oracle HTTP Server、Oracle WebCacheまたはOracle Internet Directory)のOracleウォレットに存在する特定の証明書署名リクエスト、証明書または信頼できる証明書を表示します。ウォレット・オブジェクトは、listWalletObjectsコマンドで指定される索引番号で示されます。証明書または信頼できる証明書のDN、キー・サイズ、アルゴリズムなどの詳細データが表示されます。証明書署名リクエストの場合、サブジェクトDN、キー・サイズおよびアルゴリズムが表示されます。

6.9.17.2 構文

getWalletObject('instName', 'compName', 'compType', 'walletName', 'password', 'type', 'index')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「oid」、「ohs」および「webcache」です。

walletName

ウォレット・ファイルの名前を指定します。

password

ウォレットのパスワードを指定します。

type

エクスポートするウォレット・オブジェクトのタイプを指定します。有効な値は、「CertificateRequest」、「Certificate」および「TrustedCertificate」です。

index

listWalletObjectsコマンドで返されるウォレット・オブジェクトの索引番号を指定します。

6.9.17.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1で、wallet1に存在する索引0のオブジェクトの証明書署名リクエスト詳細が表示されます。

wls:/mydomain/serverConfig> getKeyStoreObject('inst1', 'oid1', 'oid','wallet1','password', 'CertificateRequest', '0')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1で、wallet1に存在する索引0のオブジェクトの証明書詳細が表示されます。

wls:/mydomain/serverConfig> getKeyStoreObject('inst1', 'oid1', 'oid','wallet1','password', 'Certificate', '0')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1で、wallet1に存在する索引0のオブジェクトの信頼できる証明書の詳細が表示されます。

wls:/mydomain/serverConfig> getKeyStoreObject('inst1', 'oid1', 'oid','wallet1','password', 'TrustedCertificate', '0')

6.9.18 importKeyStore

キーストアをファイルからインポートするオンライン・コマンドです。

6.9.18.1 説明

このコマンドにより、管理用に指定されたOracle Virtual DirectoryインスタンスにJavaキーストア(JKS)をファイルからインポートします。コンポーネント・インスタンス名は一意にする必要があります。

6.9.18.2 構文

importKeyStore('instName', 'compName', 'compType', 'keystoreName','password', 'filePath')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「ovd」です。

keystoreName

インポートするキーストアの名前を指定します。この名前はこのコンポーネント・インスタンスで一意にする必要があります。

password

キーストアのパスワードを指定します。

filePath

インポートするキーストア・ファイルの絶対パスを指定します。

6.9.18.3 例

次のコマンドでは、キーストア/tmp/keys.jksがfile.jksとしてOracle Virtual Directoryインスタンスovd1にエクスポートされます。それ以降、そのキーストアはfile.jksという名前で管理されます。

wls:/mydomain/serverConfig> importKeyStore('inst1', 'ovd1', 'ovd', 'file.jks','password', '/tmp/keys.jks')

6.9.19 importKeyStoreObject

オブジェクトをファイルからキーストアにインポートするオンライン・コマンドです。

6.9.19.1 説明

このコマンドにより、証明書、証明書チェーンまたは信頼できる証明書をOracle Virtual DirectoryのJavaキーストア(JKS)にインポートして、指定された別名にそれを割り当てます。その別名はキーストアで一意にする必要があります。証明書または証明書チェーンをインポートする場合、別名は対応する鍵ペアの別名と一致する必要があります。

6.9.19.2 構文

importKeyStoreObject('instName', 'compName', 'compType', 'keystoreName', 'password', 'type', 'filePath', 'alias')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「ovd」です。

keystoreName

キーストアの名前を指定します。

password

キーストアのパスワードを指定します。

type

インポートするキーストア・オブジェクトのタイプを指定します。有効な値は、「Certificate」および「TrustedCertificate」です。

filePath

キーストア・オブジェクトを含むファイルの絶対パスを指定します。

alias

インポートするキーストア・オブジェクトに割り当てる別名を指定します。

6.9.19.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインタンスovd1で、別名mykeyを使用して、ファイルcert.txtからkeys.jksに証明書または証明書チェーンがインポートされます。ファイルkeys.jksは、インポートされる証明書の公開鍵に適合する鍵のペアの別名mykeyを持っている必要があります。

wls:/mydomain/serverConfig> > importKeyStoreObject('inst1', 'ovd1', 'ovd','keys.jks', 'password', 'Certificate','/tmp/cert.txt', 'mykey')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインタンスovd1で、別名mykey1を使用して、ファイルtrust.txtからkeys.jksに信頼できる証明書がインポートされます。

wls:/mydomain/serverConfig> importKeyStoreObject('inst1', 'ovd1', 'ovd','keys.jks', 'password', 'TrustedCertificate','/tmp/trust.txt', 'mykey1')

6.9.20 importWallet

Oracleウォレットをファイルからインポートするオンライン・コマンドです。

6.9.20.1 説明

このコマンドにより、管理用に指定されたコンポーネント・インスタンス(Oracle HTTP Server、Oracle WebCacheまたはOracle Internet Directory)にOracleウォレットをファイルからインポートします。インポートされるウォレットが自動ログイン・ウォレットの場合、ファイル・パスはcwallet.ssoを指す必要があります。ウォレットがパスワードで保護される場合は、ewallet.p12を指す必要があります。このウォレット名はこのコンポーネント・インスタンスで一意にする必要があります。

6.9.20.2 構文

importWallet('instName', 'compName', 'compType', 'walletName', 'password', 'filePath')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「oid」、「ohs」および「webcache」です。

walletName

インポートするウォレットの名前を指定します。名前はコンポーネント・インスタンスで一意にする必要があります。

password

ウォレットのパスワードを指定します。

filePath

インポートするウォレット・ファイルの絶対パスを指定します。

6.9.20.3 例

次のコマンドでは、自動ログイン・ウォレット・ファイル/tmp/cwallet.ssoがwallet1としてOracle Internet Directoryインスタンスoid1にインポートされます。それ以降、そのウォレットはwallet1という名前で管理されます。これは自動ログイン・ウォレットのため、パスワードは渡しません。

wls:/mydomain/serverConfig> importWallet('inst1', 'oid1', 'oid', 'wallet1', '', '/tmp/cwallet.sso')

次のコマンドでは、パスワードで保護されたウォレット/tmp/ewallet.p12がwallet2としてOracle Internet Directoryインスタンスoid1にインポートされます。それ以降、そのウォレットはwallet2という名前で管理されます。ウォレット・パスワードは、パラメータとして渡されます。

wls:/mydomain/serverConfig> importWallet('inst1', 'oid1', 'oid', 'wallet2', 'password', '/tmp/ewallet.p12')

6.9.21 importWalletObject

証明書やその他のオブジェクトをOracleウォレットにインポートするオンライン・コマンドです。

6.9.21.1 説明

このコマンドにより、証明書、信頼できる証明書または証明書チェーンを、指定されたコンポーネント・インスタンス(Oracle HTTP Server、Oracle WebCacheコンポーネントまたはOracle Internet Directory)のOracleウォレットにインポートします。証明書をインポートする場合、証明書署名リクエストが生成されたウォレット・ファイルと同じファイルを使用します。

6.9.21.2 構文

importWalletObject('instName', 'compName', 'compType', 'walletName', 'password', 'type', 'filePath')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「oid」、「ohs」および「webcache」です。

walletName

ウォレット・ファイルの名前を指定します。

password

ウォレットのパスワードを指定します。

type

インポートするウォレット・オブジェクトのタイプを指定します。有効な値は、「Certificate」、「TrustedCertificate」および「TrustedChain」です。

filePath

ウォレット・オブジェクトを含むファイルの絶対パスを指定します。

6.9.21.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1で、証明書チェーンがPKCS#7形式でファイルchain.txtからwallet1にインポートされます。

wls:/mydomain/serverConfig> importWalletObject('inst1', 'oid1', 'oid','wallet1', 'password', 'TrustedChain','/tmp/chain.txt')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1で、証明書がファイルcert.txtからwallet1にインポートされます。

wls:/mydomain/serverConfig> > importWalletObject('inst1', 'oid1', 'oid','wallet1', 'password', 'Certificate','/tmp/cert.txt')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1で、信頼できる証明書がファイルtrust.txtからwallet1にインポートされます。

wls:/mydomain/serverConfig> importWalletObject('inst1', 'oid1', 'oid','wallet1', 'password', 'TrustedCertificate','/tmp/trust.txt')

6.9.22 listKeyStoreObjects

キーストアの内容を一覧表示するオンライン・コマンドです。

6.9.22.1 説明

このコマンドでは、Oracle Virtual DirectoryのJavaキーストア(JKS)に存在するすべての証明書または信頼できる証明書を一覧表示します。

6.9.22.2 構文

listKeyStoreObjects('instName', 'compName', 'compType', 'keystoreName','password', 'type')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「ovd」です。

keystoreName

キーストア・ファイルの名前を指定します。

password

キーストアのパスワードを指定します。

type

一覧表示するキーストア・オブジェクトのタイプを指定します。有効な値は、「Certificate」および「TrustedCertificate」です。

6.9.22.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1のkeys.jksに存在するすべての信頼できる証明書が一覧表示されます。

wls:/mydomain/serverConfig> listKeyStoreObjects('inst1', 'ovd1', 'ovd','keys.jks', 'password', 'TrustedCertificate')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1のkeys.jksに存在するすべての証明書が一覧表示されます。

wls:/mydomain/serverConfig> listKeyStoreObjects('inst1', 'ovd1', 'ovd','keys.jks', 'password', 'Certificate')

6.9.23 listKeyStores

コンポーネントのすべてのキーストアを一覧表示するオンライン・コマンドです。

6.9.23.1 説明

このコマンドにより、指定されたOracle Virtual Directoryインスタンスで構成されたすべてのJavaキーストア(JKS)を一覧表示します。

6.9.23.2 構文

listKeyStores('instName', 'compName', 'compType')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「ovd」です。

6.9.23.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1のすべてのキーストアが一覧表示されます。

wls:/mydomain/serverConfig> listKeyStores('inst1', 'ovd1', 'ovd')

6.9.24 listWalletObjects

Oracleウォレットのすべてのオブジェクトを一覧表示するオンライン・コマンドです。

6.9.24.1 説明

このコマンドにより、指定されたコンポーネント・インスタンス(Oracle HTTP Server、Oracle WebCacheまたはOracle Internet Directory)のOracleウォレットに存在するすべての証明書署名リクエスト、証明書または信頼できる証明書を一覧表示します。

6.9.24.2 構文

listWalletObjects('instName', 'compName', 'compType', 'walletName', password', 'type')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「oid」、「ohs」および「webcache」です。

walletName

ウォレット・ファイルの名前を指定します。

password

ウォレットのパスワードを指定します。

type

一覧表示するウォレット・オブジェクトのタイプを指定します。有効な値は、「CertificateRequest」、「Certificate」および「TrustedCertificate」です。

6.9.24.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1の、wallet1内のすべての証明書署名リクエストが一覧表示されます。

wls:/mydomain/serverConfig> > listWalletObjects('inst1', 'oid1', 'oid','wallet1','password', 'CertificateRequest')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1の、wallet1内のすべての証明書が一覧表示されます。

wls:/mydomain/serverConfig> listWalletObjects('inst1', 'oid1', 'oid','wallet1','password', 'Certificate')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1の、wallet1内のすべての信頼できる証明書が一覧表示されます。

wls:/mydomain/serverConfig> listWalletObjects('inst1', 'oid1', 'oid','wallet1','password', 'TrustedCertificate')

6.9.25 listWallets

コンポーネント・インスタンスで構成されたすべてのウォレットを一覧表示するオンライン・コマンドです。

6.9.25.1 説明

このコマンドにより、指定されたコンポーネント・インスタンス(Oracle HTTP Server、Oracle WebCacheまたはOracle Internet Directory)で構成されたすべてのウォレットを表示して、自動ログイン・ウォレットを特定します。

6.9.25.2 構文

listWallets('instName', 'compName', 'compType')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「oid」、「ohs」および「webcache」です。

6.9.25.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1のすべてのウォレットが一覧表示されます。

wls:/mydomain/serverConfig> > listWallets('inst1', 'oid1', 'oid')

6.9.26 removeKeyStoreObject

キーストアからオブジェクトを削除するオンライン・コマンドです。

6.9.26.1 説明

このコマンドでは、Oracle Virtual DirectoryのJavaキーストア(JKS)から1つの証明書リクエスト、証明書、信頼できる証明書またはすべての信頼できる証明書を削除します。別名を使用して特定のオブジェクトを削除します。すべての信頼できる証明書を削除する場合は別名は不要です。

6.9.26.2 構文

removeKeyStoreObject('instName', 'compName', 'compType', 'keystoreName','password', 'type', 'alias')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「ovd」です。

keystoreName

キーストア・ファイルの名前を指定します。

password

キーストアのパスワードを指定します。

type

削除するキーストア・オブジェクトのタイプを指定します。有効な値は、「Certificate」、「TrustedCertificate」および「TrustedAll」です。

alias

削除するキーストア・オブジェクトの別名を指定します。

6.9.26.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1で、keys.jksに別名mykeyで示される証明書または証明書チェーンが削除されます。

wls:/mydomain/serverConfig> removeKeyStoreObject('inst1', 'ovd1', 'ovd','keys.jks', 'password', 'Certificate','mykey')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1で、keys.jksに別名mykeyで示される、信頼できる証明書が削除されます。

wls:/mydomain/serverConfig> removeKeyStoreObject('inst1', 'ovd1', 'ovd','keys.jks', 'password', 'TrustedCertificate','mykey')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Virtual Directoryインスタンスovd1のkeys.jksに存在するすべての信頼できる証明書が削除されます。別名は不要なので、そのパラメータには値Noneを渡します。

wls:/mydomain/serverConfig> removeKeyStoreObject('inst1', 'ovd1', 'ovd','keys.jks', 'password', 'TrustedAll',None)

6.9.27 removeWalletObject

証明書やその他のオブジェクトをOracleウォレットから削除するオンライン・コマンドです。

6.9.27.1 説明

このコマンドにより、指定されたコンポーネント・インスタンス(Oracle HTTP Server、Oracle WebCacheまたはOracle Internet Directory)のOracleウォレットから1つの証明書署名リクエスト、証明書、信頼できる証明書またはすべての信頼できる証明書を削除します。DNは、削除するオブジェクトを示すために使用されます。

6.9.27.2 構文

removeWalletObject('instName', 'compName', 'compType', 'walletName', 'password', 'type', 'DN')

引数

定義

instName

アプリケーション・サーバー・インスタンスの名前を指定します。

compName

コンポーネント・インスタンスの名前を指定します。

compType

コンポーネントのタイプを指定します。有効な値は、「oid」、「ohs」および「webcache」です。

walletName

ウォレット・ファイルの名前を指定します。

password

ウォレットのパスワードを指定します。

type

削除するキーストア・オブジェクトのタイプを指定します。有効な値は、「CertificateRequest」、「Certificate」、「TrustedCertificate」または「TrustedAll」です。

DN

削除するウォレット・オブジェクトの識別名を指定します。

6.9.27.3 例

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1の、wallet1からすべての信頼できる証明書が削除されます。DNを指定する必要はありません。DNパラメータにはnullを渡します(Noneと指定します)。

wls:/mydomain/serverConfig> removeWalletObject('inst1', 'oid1', 'oid','wallet1', 'password', 'TrustedAll',None)

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1の、wallet1からDN cn=www.acme.comで示される証明書署名リクエストが削除されます。

wls:/mydomain/serverConfig> removeWalletObject('inst1', 'oid1', 'oid','wallet1', 'password', 'CertificateRequest','cn=www.acme.com')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1の、wallet1からDN cn=www.acme.comで示される証明書が削除されます。

wls:/mydomain/serverConfig> removeWalletObject('inst1', 'oid1', 'oid','wallet1', 'password', 'Certificate','cn=www.acme.com')

次のコマンドでは、アプリケーション・サーバー・インスタンスinst1のOracle Internet Directoryインスタンスoid1の、wallet1からDN cn=www.acme.comで示される、信頼できる証明書が削除されます。

wls:/mydomain/serverConfig> removeWalletObject('inst1', 'oid1', 'oid','wallet1', 'password', 'TrustedCertificate','cn=www.acme.com')

6.9.28 SSL用プロパティ・ファイル

SSL構成では、WLSTのconfigureSSLコマンドで使用する特定のプロパティ・ファイルを使用します。このファイルには、認証タイプ、暗号値、SSLバージョンなどの目的のSSL構成を指定するためのパラメータが含まれます。

異なるコンポーネントで複数のプロパティ・ファイルを管理する必要がある場合、わかりやすい名前を使用できます。たとえば、プロパティ・ファイルにohs-ssl-properties.propやovd-ssl-properties.propなどの名前を付けることができます。

6.9.28.1 プロパティ・ファイルの構造

すべてのSSLプロパティ・ファイルは、一貫した構造を持ちます。

表6-4では、鍵の値の構造およびこれらのファイルの使用に関する詳細について説明しています。

表6-4 プロパティ・ファイルのパラメータ

鍵

必須?

Oracle HTTP Server、Oracle Internet DirectoryおよびOracle Web Cacheで許可される値

Oracle Virtual Directoryで許可される値

用途

SSLEnabled

いいえ

true

false

true

false

いずれかの値

Ciphers

いいえ

SSL_RSA_WITH_RC4_128_MD5

SSL_RSA_WITH_RC4_128_SHA

SSL_RSA_WITH_3DES_EDE_CBC_SHA

SSL_RSA_WITH_DES_CBC_SHA

SSL_DH_anon_WITH_RC4_128_MD5

SSL_DH_anon_WITH_DES_CBC_SHA

SSL_DH_anon_WITH_3DES_EDE_CBC_SHA

TLS_RSA_WITH_AES_128_CBC_SHA

TLS_RSA_WITH_AES_256_CBC_SHA

JSSEプロバイダで許可される1つまたは複数の暗号JDK 1.5で許可される暗号の完全なリストは、次のガイドの付録Aを参照してください。http://java.sun.com/j2se/1.5.0/docs/guide/security/jsse/JSSERefGuide.html

1つまたは複数のカンマ区切りの値

SSLVersions

いいえ

nzos_Version_3_0

nzos_Version_3_0_With_2_0_Hello

nzos_Version_1_0

SSLv3

SSLv2Hello(単独では指定できません。少なくとも別のバージョンを1つ指定する必要があります)

TLSv1

1つまたは複数のカンマ区切りの値

CertValidation

いいえ

なし

crl

該当なし

いずれかの値

CertValidation
Path

いいえ

file://crl_file_path

dir://crl_dir_path

該当なし

CRLファイルのパス、またはCRLファイルを含むディレクトリ

KeyStore

いいえ

有効なウォレット名

有効なキーストア名

TrustStore

いいえ

該当なし

有効なトラストストア名

AuthenticationType

いいえ

なし

サーバー

オプション

Mutual

なし

サーバー

オプション

Mutual

任意の1つの値

表6-5に、デフォルト値を示します。

表6-5 パラメータのデフォルト値

鍵

Oracle HTTP Serverのデフォルト値

Oracle Web Cacheのデフォルト値

Oracle Internet Directoryのデフォルト値

Oracle Virtual Directoryのデフォルト値

SSLEnabled

true

true

true

true

Ciphers

null

null

null

null

SSLVersions

null

null

null

null

CertValidation

なし

なし

-

-

CertValidation
Path

null

null

-

-

KeyStore

デフォルト

デフォルト

null

keys.jks

TrustStore

-

-

-

keys.jks

Authentication
Type

サーバー

サーバー

なし

サーバー

注意:

- 少なくとも1つのDH_anon暗号は、SSL認証なしモードで使用する必要があります。その他すべてのモードでは、少なくとも1つのRSA暗号を使用する必要があります。

- サーバー認証、相互認証またはオプションのクライアント認証でSSLを構成する場合、KeyStoreパラメータの値を指定する必要があります。

- AES暗号のみが指定されている場合、SSLVersionsパラメータにはTLSv1またはnzos_Version_1_0を含める必要があります。

- CRLベースの検証を実行する場合、CertValidationパラメータの値にはcrlを指定し、CertValidationPathパラメータの値はCRLファイルやディレクトリを指す必要があります。

6.9.28.2 プロパティ・ファイルの例

いくつかの例を使用して、プロパティの使用方法について説明します。

例1: 基本的なプロパティ・ファイル

SSLEnabled=true
AuthenticationType=None
CertValidation=none

このプロパティ・ファイルでは、認証なしモードが指定され、暗号およびSSLバージョンにはSSL構成時のデフォルト値が使用されます。認証タイプがNoneであるため、キーストア・プロパティおよびトラストストア・プロパティは指定しません。他の認証タイプでは、キーストアを指定する必要があります。

例2: 基本的なプロパティ・ファイル

SSLEnabled=
AuthenticationType=None
CertValidation=none

このプロパティ・ファイルは前述の例と同様ですが、SSLEnabledを値なしで明示的に指定している点が異なります。これは、キーを指定しないのと同じことです。どちらのケースも、デフォルト値が使用されます。

そのため、次の3つ設定は同じ意味になります。

- 設定:

SSLEnabled=true

ここでは、値trueを明示的に指定しています。

- 設定:

SSLEnabled=

ここでは値を指定していないので、SSLEnabledのデフォルト値(true)が使用されます。

- SSLEnabledがプロパティ・ファイルに存在しない
キーが存在しないので、デフォルト値(true)が使用されます。

例3: OHSのバージョンを含むプロパティ・ファイル

SSLEnabled=true
AuthenticationType=Mutual
SSLVersion=nzos_Version_3_0
CertValidation=crl
CertValidationPath=file:///tmp/file.crl
KeyStore=ohs1

このプロパティ・ファイルの内容は、次のとおりです。

- 暗号のデフォルト値

- キーストア

- SSLバージョンv3

- CRL検証が有効

- 相互認証モード

例4: Oracle Virtual Directoryの暗号を含むプロパティ・ファイル

AuthenticationType=Server
Ciphers=SSL_RSA_WITH_RC4_128_MD5
SSLVersion=SSLv3,SSLv2Hello
KeyStore=ovdidentity.jks
TrustStore=ovdtrust.jks
SSLEnabled=true

このプロパティ・ファイルの内容は、次のとおりです。

- 特定の暗号値

- SSLバージョン

- サーバー認証モード

7 SSL自動化ツールの使用

この項の内容は次のとおりです。

- SSL自動化ツールの概要

- 前提条件

- CA証明書の生成

- コンポーネント・サーバーの構成

- クライアントの構成

7.1 SSL自動化ツールの概要

Oracle SSL自動化ツールを使用すると、ドメイン固有のCA証明書を使用して、1つのドメイン内に複数のコンポーネントを構成できます。

デプロイメントにおいてSSLを有効にするタスクは、管理者にとって恐ろしく、厄介である場合があります。SSLを手動構成するには、一般的に管理者は、次のようないくつかの領域で専門知識がある必要があります。

- テクノロジとしてのSSL

- SSL構成および管理を実行するために使用可能な高度でないツール

- セキュリティに関するベスト・プラクティス

Oracle SSL自動化ツールは、手動で行う手順の代替手段で、SSL構成を簡略化します。これにより、中央の自己署名付きCA証明書を生成できます。サーバー証明書に署名することによりCA署名付きの証明書を使用してコンポーネント・サーバーを設定し、複数のクライアントに対して信頼できる証明書としてCA証明書を提供できます。これにより、信頼できるネットワークがすべてのクライアントおよびサーバーに対して一貫した方法で確立され、外向きの接続とDMZ内の接続の両方でそれを使用できます。

SSL自動化ツールは、トラスト・モデルに基づいています。トラスト・モデルは、SSLドメインの概念を導入します。SSLドメインは、すべてのSSLコンポーネントが同じCAにより署名された証明書でデプロイされるセキュリティ環境です。各SSLドメインには、自己署名ドメインCAが関連付けられています。このSSLドメイン内のすべてのコンポーネントは、ドメインCAを暗黙的に信頼します。また、このドメインCAは、そのSSLドメイン内にデプロイされたサーバー・コンポーネント用にSSLサーバー証明書を生成できます。あるSSLドメイン(A)のサーバー・コンポーネントが別のSSLドメイン(B)のクライアント・コンポーネントに信頼される必要がある場合、SSLドメイン(B)のクライアント・コンポーネントは、(A)からのドメインCA証明書のみをインポートして信頼する必要があります。

このツールは、一連のシェル・スクリプト(3つのメインSSLスクリプトといくつかのコンポーネント固有のスクリプト)から構成されています。

表7-1に、メイン・スクリプトをリストします。

表7-1 メイン・スクリプト

スクリプト

機能

SSLGenCA.sh

CA証明書を生成し、これをLDAPディレクトリに格納します。

SSLServerConfig.sh

サーバーを構成します。

SSLClientConfig.sh

クライアントを構成します。

サーバー構成スクリプトおよびクライアント構成スクリプトは、メイン・スクリプトを起動するときにコマンドラインで指定したオプションの値に応じて、コンポーネント固有のスクリプトを起動します。

これらのスクリプトは、デプロイメントにあるLDAPポリシー・ストアを使用して、SSLドメインCAウォレットを集中的に格納します。これらのSSLドメインCAウォレットは、LDAPアクセス・コントロールによって保護されます。アクセス権は、SSL管理者グループのメンバーのみに付与されます。スクリプトを実行するには、このグループのメンバーである必要があります。

SSL自動化ツールには、次の利点があります。

- これを使用すると、管理者が使用する一貫性のあるインタフェース・セットが提供されます。

- これを使用すると、トラスト・ポイントのデプロイメントおよび証明書のライフサイクルの管理が簡素化されます。

- これを使用すると、適切に認証されたSSL管理者のみがSSL関連の管理タスクを実行できるようになります。

- これを使用すると、トラスト・デプロイメントに基本的な変更を行う必要なく、コンポーネントを徐々に追加する機能がサポートされます。

7.2 前提条件

このツールを使用する前に、この項で説明するタスクを実行したことを確認します。

7.2.1 Oracle Fusion Middleware環境の設定

スクリプトを起動してOracle Fusion Middleware環境のSSLターゲット・コンポーネントでSSLを構成するには、その前にOracle Fusion Middleware環境のすべてのコンポーネントが稼働中である必要があります。

コンポーネントがWindowsプラットフォームで稼働中の場合、スクリプトを使用する前にhttp://www.cygwin.comからCygwinを取得し、インストールする必要があります。CygwinシェルでORACLE_HOME環境変数を設定します。次に例を示します。

export ORACLE_HOME='C:/rc8/fmwhome/Oracle_Home/'

7.2.2 必要な情報のアセンブル

SSLスクリプトを起動する前に、表7-2および表7-3にリストされている次に変数の値があることを確認します。

表7-2 SSL自動化ツールのドメイン・レベルの情報変数

変数

HOSTNAME

ORACLE_HOME(Fusion Middleware)

ORACLE_COMMON

MIDDLEWARE_HOME

DOMAIN_NAME

DOMAIN_HOME

DOMAIN_ADMINISTRATOR_USERNAME

DOMAIN_ADMINISTRATION_PASSWORD

DOMAIN_HOST_NAME

ADMINSERVER_PORT

DOMAIN_ADMINISTRATOR_USERNAME

DOMAIN_ADMINISTRATION_PASSWORD

INSTANCE_HOME

INSTANCE_NAME

表7-3 SSL自動化ツールのコンポーネント固有の情報変数

変数

OVD_NAME

OVD_PORT

OID_NAME

OID_PORT

OID_SSL_PORT

OID_ADMIN

OID_ADMIN_PASSWORD

DB_HOST

DB_PORT

DB_SERVICE_NAME

DB_SID

7.3 CA証明書の生成

CA証明書生成スクリプトSSLGenCA.shを起動して、SSLドメインを初期化して作成し、SSLドメインCAを生成します。SSLドメイン全体に対して、スクリプトを1回だけ実行します。これを再び実行すると、新しく生成されるCAウォレットを使用してすべてのサーバーおよびクライアントを構成する必要があります。SSLドメインは、すべてのSSLコンポーネントが同じCA署名証明書を使用してデプロイされるセキュリティ環境です。

Oracle Fusion Middlewareインストール用のデフォルト環境で設定されたシェルを入力します。

このスクリプトを実行するには、次の情報が必要です。

- デプロイメントで使用するLDAPディレクトリの接続情報(ホストとポート)

- そのLDAPディレクトリへのアクセスを可能にする管理者資格証明

- SSLドメインの名前

次のコマンドを実行します。

$ORACLE_COMMON_HOME/oracle_common/bin/SSLGenCA.sh

プロンプトが表示されたら情報を入力します。

このスクリプトでは、次のタスクが実行されます。

- ドメインで使用するデモの署名CAウォレットを作成します。

- CAウォレットからデモの公開CA証明書を抽出します。

- ウォレットおよび証明書をLDAPにアップロードし、これらをエントリcn=demoCA、Deployment_SSL_Domainに格納します。

- LDAPにアクセス・グループcn=sslAdmins, cn=demoCA,Deployment_SSL_Domainを作成し、そのグループ管理権限を親コンテナに付与します。他のすべてのエンティティは、アクセスを拒否されます。(アクセスを付与するには、ユーザーをこのグループに追加します。)
これでデモのCA証明書は、匿名のユーザーまたは認証済ユーザーによってダウンロードできます。

- デモのCAウォレットのパスワードは、今後の使用のためにわかりにくいウォレットにローカルに格納されます。このパスは、$ORACLE_HOME/credCA/castoreです。
管理者は、このウォレットを保護し、SSL管理者のみがこれを読み込むことができるようにする必要があります。

7.3.1 例: 証明書の生成

この例は、SSLGenCA.shを実行し、新しいCAウォレットを生成し、これをポリシー・ストア(LDAPサーバー)に格納する方法を示します。

$ SSLGenCA.sh

SSL Certificate Authority Generation Script: Release 11.1.1.4.0 - Production
Copyright (c) 2010 Oracle.  All rights reserved.

************************************************************************
*********** This tool will generate a self-signed CA wallet ************
*********** and store it in a central LDAP directory        ************
*********** for IDM and FA SSL setup and provisioning       ************
************************************************************************
>>>Enter the LDAP hostname [adc2100651.example.com]:
>>>Enter the LDAP port [3060]: 20040
>>>Enter the admin user [cn=orcladmin]
>>>Enter password for cn=orcladmin:
>>>Enter the LDAP sslDomain where your CA will be stored [idm]:
>>>Enter a password to protect your CA wallet:
>>>Enter confirmed password for your CA wallet:

Generate a new CA Wallet...
Create SSL Domains Container for cn=idm,cn=sslDomains...
Storing the newly generated CA to the LDAP...
Setup ACL to protect the CA wallet...
The newly generated CA is stored in LDAP entry cn=demoCA,cn=idm,cn=sslDomains successfully

7.4 コンポーネント・サーバーの構成

SSLServerConfig.shスクリプトを起動してサーバーを構成します。このスクリプトは、SSLドメインCAを使用し、サーバー証明書を生成します。次に、このスクリプトは、制御をコンポーネント固有の構成スクリプトに渡します。この構成スクリプトは、生成されたサーバー証明書を取得し、SSL接続を受け入れるようにコンポーネントを構成します。

このスクリプトを実行するには、次の情報が必要です。

- デプロイメントで使用するLDAPディレクトリの接続情報(ホストとポート)

- そのLDAPディレクトリへのアクセスを可能にする管理者資格証明

- サーバー名。これは、WebLogic管理サーバーまたは管理対象サーバーのいずれかです。

このスクリプトを起動する前に、Oracle Fusion Middlewareインストール用のデフォルト環境で設定されたシェルを入力します。このスクリプトの場所は、$ORACLE_COMMON_HOME/oracle_common/bin/SSLServerConfig.shです。このスクリプトの構文を次に示します。

SSLServerConfig.sh -component [oid|ovd|oam|wls] [-v]

唯一のコンポーネントを指定します。指定したコンポーネントに応じて、SSLServerConfig.shはコンポーネント固有のスクリプトを起動します。コンポーネント固有サーバーのスクリプトの名前の形式は、COMPONENT_NAME_SSL_Server_Config.shです。

コンポーネント・オプションwlsを指定した場合、スクリプトは、名前付きのサーバーのすべてのJava EEコンポーネントを構成します。Java EEコンポーネントには、Oracle Identity Navigator、Oracle Access Manager 11g、Oracle Identity Manager、およびOracle Identity Federationが含まれます。

Oracle Internet Directory、Oracle Virtual Directory、またはOracle Access Manager 10gを構成するには、表7-4に示す適切なコンポーネント・オプションを使用します。

表7-4 SSLServerConfig.shのコンポーネント・オプション

コンポーネント・オプション

起動されるスクリプト

構成されるコンポーネント

wls

WLS_SSL_Server_Config.sh

Oracle WebLogic ServerおよびJava EEのコンポーネント

oid

OID_SSL_Server_Config.sh

Oracle Internet Directoryサーバー

ovd

OVD_SSL_Server_Config.sh

Oracle Virtual Directoryサーバー

oam

OAM_SSL_Server_Config.sh

Oracle Access Manager 10gサーバー

プロンプトが表示されたら情報を入力します。

oidオプションまたはovdオプションを使用するときに、Oracle Internet DirectoryホストまたはOracle Virtual DirectoryホストがWebLogic Serverホストと異なる場合(高可用性環境など)は、Oracle Internet DirectoryホストまたはOracle Virtual Directoryホストでサーバー・スクリプトを実行する必要があります。

このスクリプトでは、次のタスクが実行されます。

- 第7.3項で生成されたデモの署名CAをダウンロードし、これを$ORACLE_HOME/rootCAに格納します。

- 必要に応じて、コンポーネント固有スクリプトCOMPONENT_NAME_SSL_Server_Config.shを実行します。

このコンポーネント固有スクリプトは、次のタスクを実行します。

- デモの署名CAウォレットに基づいて、サーバー証明書を生成します。

- 証明書をコンポーネント固有のウォレット/キーストアにインポートします。

- コンポーネント固有のウォレット/キーストアにある新しいサーバー証明書に基づいて、SSLサーバー認証のコンポーネント・インスタンスを構成します。

7.4.1 例: WebLogic ServerおよびJava EEのコンポーネントの構成

$ ./SSLServerConfig.sh -component wls

Server SSL Automation Script: Release 11.1.1.4.0 - Production
Copyright (c) 2010 Oracle.  All rights reserved.

Downloading the CA wallet from the central LDAP location...
>>>Enter the LDAP Hostname [adc2100651.example.com]:
>>>Enter the LDAP port [3060]: 16468
>>>Enter an admin user DN [cn=orcladmin]
>>>Enter password for cn=orcladmin:
>>>Enter the sslDomain for the CA [idm]:
>>>Enter a password to protect your SSL wallet/keystore:
>>>Enter confirmed password for your SSL wallet/keystore:
>>>Enter password for the CA wallet:
>>>Searching the LDAP for the CA usercertificate ...
Importing the CA certifcate into trust stores...
>>>Searching the LDAP for the CA userpkcs12 ...

Invoking Weblogic SSL Server Configuration Script...
Enter attribute values for your certificate DN
>>>Country Name 2 letter code [US]:
>>>State or Province Name [California]:
>>>Locality Name(eg, city) []:Belmont
>>>Organization Name (eg, company) [mycompany]:Oracle
>>>Organizational Unit Name (eg, section) [wls-20101123115644]:wls-admin
>>>Common Name (eg, hostName.domainName.com) [adc2100651.example.com]:
The subject DN is
cn=adc2100651.example.com,ou=wls-admin,O=Oracle,l=Belmont,st=California,c=US
>>>Import the existing CA at /mw784/im7335/rootCA/cacert.der into keystore...
>>>Import the server certificate at /mw784/im7335/rootCA/keystores/wls/cert.txt into kstore...
Configuring SSL for your WLS server instance...
>>>Enter your WLS domain home directory: /mw784/user_projects/domains/imdomain8017
>>>Enter your WLS server instance name [AdminServer]
Enter SSL Listen Port: [7002] 7778
>>>Enter weblogic admin port: [7001] 19249
>>>Enter weblogic admin user: [weblogic]
>>>Enter password for weblogic:
>>>Enter your keystore name [identity.jks]: id.jks /mw784/im7335/rootCA/keystores/wls/mw784/user_projects/domains/imdomain8017/keystores/id.jks
Configuring WLS AdminServer ...
Running /mw784/im7335/common/bin/wlst.sh /mw784/im7335/rootCA/keystores/wls/wlssvr.py...
Your WLS server has been set up successfully

7.4.2 例: Oracle Internet Directoryサーバー・コンポーネントの構成

$ ./SSLServerConfig.sh -component oid
Server SSL Automation Script: Release 11.1.1.4.0 - Production
Copyright (c) 2010 Oracle.  All rights reserved.

Downloading the CA wallet from the central LDAP location...
>>> Enter the LDAP Hostname [adc2100651.example.com]:
>>> Enter the LDAP port [3060]: 16468
>>> Enter an admin user DN [cn=orcladmin]
>>> Enter password for cn=orcladmin:
>>> Enter the sslDomain for the CA [idm]:
>>> Enter a password to protect your SSL wallet/keystore:
>>> Enter confirmed password for your SSL wallet/keystore:
>>> Enter password for the CA wallet:
>>> Searching the LDAP for the CA usercertificate ...
Importing the CA certifcate into trust stores...
>>> Searching the LDAP for the CA userpkcs12 ...

Invoking OID SSL Server Configuration Script...
Enter attribute values for your certificate DN
>>> Country Name 2 letter code [US]:
>>> State or Province Name [California]:
>>> Locality Name(eg, city) []:Belmont
>> Organization Name (eg, company) [mycompany]:Example
>>> Organizational Unit Name (eg, section) [oid-20101118211946]:
>>> Common Name (eg, hostName.domainName.com) [adc2100651.example.com]:
The subject DN is cn=adc2100651.example.com,ou=oid-20101118211946,O=Example,l=Belmont,st=California,c=US

Creating an Oracle SSL Wallet for oid instance...
/mw784/im7335/../oracle_common/bin
>>> Enter your OID component name: [oid1] Enter the weblogic admin port: [7001] 19249
>>> Enter the weblogic admin server host [adc2100658.example.com]  adc2100658.example.com
>>> Enter the weblogic admin user: [weblogic]
>>> Enter weblogic password:
>>> Enter your AS instance name:[asinst_1] iminst8017
>>> Enter an SSL wallet name for OID component [oid_wallet1]
Checking the existence of oid_wallet1 in the OID server...
Configuring the newly generated Oracle Wallet with your OID component...
Do you want to restart your OID component?[y/n]y

Do you want to test your SSL set up?[y/n]y
>>> Please enter your OID ssl port:[3131] 16180
Please enter the oid hostname:[adc2100651] adc2100651.example.com
>>> Invoking /mw784/im7335/bin/ldapbind -h adc2100651.example.com -p 16180 -U 2 -D cn=orcladmin ...
Bind successful

Your oid1 SSL server has been set up successfully

7.4.3 例: Oracle Virtual Directoryサーバー・コンポーネントの構成

$ ./SSLServerConfig.sh -component ovd
Server SSL Automation Script: Release 11.1.1.4.0 - Production
Copyright (c) 2010 Oracle.  All rights reserved.

Downloading the CA wallet from the central LDAP location...
>>> Enter the LDAP Hostname [adc2100651.example.com]:
>>> Enter the LDAP port [3060]: 16468
>>> Enter an admin user DN [cn=orcladmin]
>>> Enter password for cn=orcladmin:
>>> Enter the sslDomain for the CA [idm]:
>>> Enter a password to protect your SSL wallet/keystore:
>>> Enter confirmed password for your SSL wallet/keystore:
>>> Enter password for the CA wallet:
Searching the LDAP for the CA usercertificate ...
Importing the CA certifcate into trust stores...
>>> Searching the LDAP for the CA userpkcs12 ...

Invoking OVD SSL Server Configuration Script...
Enter attribute values for your certificate DN
>>> Country Name 2 letter code [US]:
>>> State or Province Name [California]:
>>> Locality Name(eg, city) []:redwood
>>> Organization Name (eg, company) [mycompany]:
>>> Organizational Unit Name (eg, section) [ovd-20101118212540]:
>>> Common Name (eg, hostName.domainName.com) [adc2100651.example.com]:
The subject DN is cn=adc2100651.example.com,ou=ovd-20101118212540,l=redwood,st=California,c=US
>>> Import the existing CA at /mw784/im7335/rootCA/cacert.der into keystore...
>>> Import the server certificate at /mw784/im7335/rootCA/keystores/ovd/cert.txt into kstore...
>>> Enter your OVD instance name [ovd1]
>>> Enter your Oracle instance [asinst_1]: iminst8017
>>> Enter the weblogic admin server host [adc2100658.example.com]  adc2100658.example.com
>>> Enter weblogic admin port: [7001] 19249
>>> Enter weblogic admin user: [weblogic]
>>> Enter password for weblogic:
>>> Enter your keystore name [ovdks1.jks]:

Checking the existence of ovdks1.jks in the OVD...
Configuring ovdks1.jks for ovd1 listener...
Do you want to restart your OVD instance?[y/n]y

Do you want to test your OVD SSL set up?[y/n]y

Please enter your OVD ssl port:[3131] 24888
Please enter the OVD hostname:[adc2100651] adc2100651.example.com

/mw784/im7335/bin/ldapbind -h adc2100651.example.com -p 24888 -U 2 -D =orcladmin ...
Bind successfully to OVD SSL port 24888
Your  SSL server has been set up successfully

7.4.4 例: Oracle Access Manager 10gサーバー・コンポーネントの構成

$ SSLServerConfig.sh -component oam

Server SSL Automation Script: Release 11.1.1.4.0 - ProductionCopyright (c) 2010 Oracle.  All rights reserved.

Downloading the CA wallet from the central LDAP location...
>>>Enter the LDAP Hostname [adc123.example.com]:
>>>Enter the LDAP port [3060]: 16625
>>>Enter an admin user DN [cn=orcladmin]
>>>Enter password for cn=orcladmin:
>>>Enter the ssl domain name [idm]:
>>>Searching the LDAP for the CA usercertificate ...
>>>Searching the LDAP for the CA userpkcs12 ...

Invoking OAM SSL Server Configuration Script...
>>>Enter your OAM10 Access Server install location: [e.g. /scratch/aime/OAM10/access] /scratch/install/OAM10/access
****************************************************************
*** CA root cert has been converted from DER to PEM format.  ***
****************************************************************
****************************************************************
*** This script will first invoke configureAAAServer tool to ***
*** reconfig AAA server in cert mode, and then generate a    ***
*** certificate request. Please select 3(Cert), 1(request a  ***
*** certificate), and enter pass phrase for the first 3      ***
*** prompts. Otherwise, this script is not guaranteed to     ***
*** work properly.                                           ***
****************************************************************

Please enter the Mode in which you want the Access Server to run : 1(Open) 2(Simple) 3(Cert) : 3

Do you want to request a certificate (1) or install a certificate (2) ? : 1

Please enter the Pass phrase for this Access Server :

Do you want to store the password in the file ? : 1(Y) 2(N) : 1

Preparing to generate certificate.  This may take up to 60 seconds.  Please wait.
Generating a 1024 bit RSA private key
.++++++
...................++++++
writing new private key to '/scratch/install/OAM10/access/oblix/config/aaa_key.pem'
-----
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [US]:US
State or Province Name (full name) [Some-State]:California
Locality Name (eg, city) []:Redwood Shores
Organization Name (eg, company) [Some-Organization Pty Ltd]:Example
Organizational Unit Name (eg, section) []:OAM
Common Name (eg, hostName.domainName.com) []:adc123.example.com
Email Address []:
writing RSA key

Your certificate request is in file : /scratch/install/OAM10/access/oblix/config/aaa_req.pem
Please get your certificate request signed by the Certificate Authority.
On obtaining your certificate, please place your certificate in '/scratch/install/OAM10/access/oblix/config/aaa_cert.pem' file and the certificate authority's certificate for the corresponding component (for example: WebGate, AXML Server) in '/scratch/install/OAM10/access/oblix/config/aaa_chain.pem' file.
Once you have your certificate placed at the above mentioned location, please follow the instructions on how to start the Access Server.

More Information on setting up Access Server in Certificate mode can be obtained from the Setup Installation Guide.
Access Server mode has been re-configured successfully.

Please note that new security mode will take effect only after the security mode for this Access Server is changed to 'cert' from the Access Manager System Console.
Do you want to specify or update the failover information ? : 1(Y) 2(N) :

Please restart your Access Server by executing the '/scratch/install/OAM10/access/oblix/apps/common/bin/restart_access_server' program from command line once you have placed your certificates at the above mentioned location.

Press enter key to continue ...

****************************************************************
*** Now we will sign the certificate request using CA cert.  ***
****************************************************************

>>>Enter the CA wallet password:

Certificate request (aaa_req.pem) has been converted to orapki acceptable format in /scratch/install/WT/Oracle_WT1/rootCA/OAM

The certificate has been signed by the root CA

****************************************************************
*** OAM server certificate have been installed into Access   ***
*** Server config directory.                                 ***
****************************************************************

****************************************************************
*** Restarting AAA Server ...                                ***
****************************************************************

Do you want to restart your Access Server? [y/n] y

Access Server has been started/restarted

****************************************************************
*** Your OAM10 Access Server has been setup successfully in  ***
*** cert mode.                                               ***
****************************************************************

7.5 クライアントの構成

スクリプトSSLClientConfig.shを起動してクライアントを構成します。このスクリプトは、SSLドメインCAを取得し、次に制御をコンポーネント固有のスクリプトに渡してこれをインポートし、必要な追加の構成手順を実行します。

このスクリプトを実行するには、次の情報が必要です。

- デプロイメントで使用するLDAPディレクトリの接続情報(ホストとポート)

- そのLDAPディレクトリへのアクセスを可能にする管理者資格証明

- SSLデプロイメントの名前(idm、fmwなど)

このスクリプトを起動する前に、Oracle Fusion Middlewareインストール用のデフォルト環境で設定されたシェルを入力します。このスクリプトの場所は、$ORACLE_COMMON_HOME/oracle_common/bin/SSLClientConfig.shです。このスクリプトの構文を次に示します。

SSLClientConfig.sh -component [cacert|wls|webgate] [-v]

指定した-componentオプションに応じて、SSLClientConfig.shは、表7-5にリストされているコンポーネント・スクリプトを起動する場合があります。コンポーネント固有クライアントの名前の形式は、COMPONENT_NAME_SSL_Client_Config.shです。

表7-5 SSLClientConfig.shのコンポーネント・オプション

コンポーネント・オプション

起動されるスクリプト

構成されるコンポーネント

cacert

なし

その他のSSLクライアント

wls

WLS_SSL_Client_Config.sh

Oracle WebLogicクライアントおよびJava EEのコンポーネント

webgate

OAMWG_SSL_Client_Config.sh

Oracle Access Manager WebGate

プロンプトが表示されたら情報を入力します。

このクライアント・スクリプトは、次のタスクを実行します。

- SSLドメインのLDAPサーバーからCA証明書またはウォレットをダウンロードします。

- Oracle Identity ManagerクライアントまたはOracle Access Managerクライアント用に、関連するJavaトラスト・ストア、Oracleウォレット、またはJavaキーストアを作成します。

- 関連するトラスト・ストア、ウォレット、またはキーストアに、信頼できる証明書として署名CA証明書をインポートします。
WebGateクライアントの場合、秘密証明書、クライアント証明書、およびCA署名証明書によって完全なJavaキーストアが作成されます。

共通のトラスト・ストアまたはウォレットのみが必要なその他のクライアント・コンポーネントの場合、このスクリプトは、CA証明書を新しく生成されたトラスト・ストアにインポートします。

7.5.1 例: SSLクライアント用のCA証明書のダウンロード

$ ./SSLClientConfig.sh -component cacert

SSL Automation Script: Release 11.1.1.4.0 - Production
Copyright (c) 2010 Oracle.  All rights reserved.

Downloading the CA certificate from a central LDAP location
Creating a common trust store in JKS and Oracle Wallet formats ...
Configuring SSL clients with the common trust store...
Make sure that your LDAP server is currently up and running.

Downloading the CA certificate from the LDAP server...
>>> Enter the LDAP hostname [adc2100651.example.com]: Enter the LDAP port: [3060]? 16468
>>> Enter your LDAP user [cn=orcladmin]:
>>> Enter password for cn=orcladmin:
>>> Enter the sslDomain for the CA [idm]:
Searching the LDAP for the CA usercertificate ...
Importing the CA certifcate into trust stores...
>>> The common trust store in JKS format is located at /mw784/im7335/rootCA/keystores/tmp/trust.jks
>>> The common trust store in Oracle wallet format is located at /mw784/im7335/rootCA/keystores/tmp/ewallet.p12
Generate trust store for the CA cert at cn=idm,cn=sslDomains
>>> Enter a password to protect your truststore:
>>> Enter confirmed password for your truststore:

Updating the existing /mw784/im7335/rootCA/keystores/common/trust.jks...
Importing the CA certifcate into trust stores...
>>> The common trust store in JKS format is located at /mw784/im7335/rootCA/keystores/common/trust.jks
>>> The common trust store in Oracle wallet format is located at /mw784/im7335/rootCA/keystores/common/ewallet.p12

7.5.2 例: 証明書のダウンロードおよびWebLogicクライアントの構成

$ ./SSLClientConfig.sh -component wls

SSL Automation Script: Release 11.1.1.4.0 - Production
Copyright (c) 2010 Oracle.  All rights reserved.

Downloading the CA certificate from a central LDAP location
Creating a common trust store in JKS and Oracle Wallet formats ...
Configuring SSL clients with the common trust store...
Make sure that your LDAP server is currently up and running.

Downloading the CA certificate from the LDAP server...
>>> Enter the LDAP hostname [adc2100651.example.com]:
>>> Enter the LDAP port: [3060]? 16468
>>> Enter your LDAP user [cn=orcladmin]:
>>> Enter password for cn=orcladmin:
>>> Enter the sslDomain for the CA [idm]:
>>> Searching the LDAP for the CA usercertificate ...
Importing the CA certifcate into trust stores...
>>> The common trust store in JKS format is located at /mw784/im7335/rootCA/keystores/tmp/trust.jks
>>> The common trust store in Oracle wallet format is located at /mw784/im7335/rootCA/keystores/tmp/ewallet.p12
Invoking Weblogic SSL Client Configuration Script...
>>> Enter a password to protect your truststore:
>>> Enter confirmed password for your truststore:

Updating the existing /mw784/im7335/rootCA/keystores/wls/trust.jks...
Importing the CA certifcate into trust stores...
>>> The common trust store in JKS format is located at /mw784/im7335/rootCA/keystores/wls/trust.jks
>>> The common trust store in Oracle wallet format is located at /mw784/im7335/rootCA/keystores/wls/ewallet.p12
cat: /mw784/im7335/rootCA/cacert_tmp.txt: No such file or directory
Configuring SSL Trust for your WLS server instance...
>>> Enter your trust store name: [trust.jks]mytrust.jkds
>>> Enter your WLS domain home directory: /mw784/user_projects/domains/imdomain8017
>>> Enter your WLS server instance name [AdminServer]
>>> Enter weblogic admin port: [7001] 19249
>>> Enter weblogic admin user: [weblogic]
>>> Enter password for weblogic:
>>> Copy /mw784/im7335/rootCA/keystores/wls/trust.jks to /mw784/user_projects/domains/imdomain8017/servers/AdminServer/keystores/mytrust.jkds...
Configuring WLS AdminServer ...
Running /mw784/im7335/common/bin/wlst.sh /mw784/im7335/rootCA/keystores/wls/wlscln.py...
Your WLS server has been set up successfully

7.5.3 例: 証明書のダウンロードおよびWebGateクライアントの構成

$ SSLClientConfig.sh -component webgate
Script started on Thu 28 Oct 2010 10:23:38 AM PDT

SSL Automation Script: Release 11.1.1.4.0 - Production
Copyright (c) 2010 Oracle.  All rights reserved.

Downloading the CA certificate from a central LDAP location
Creating a common trus store in JKS and Oracle Wallet formats ...
Configuring SSL clients with the common trust store...
Make sure that your LDAP server is currently up and running.

Downloading the CA certificate from the LDAP server...
>>>Enter the LDAP hostname [adc123.example.com]:
>>>Enter the LDAP port: [3060]? 16625
>>>Enter your LDAP user [cn=orcladmin]:
>>>Enter password for cn=orcladmin:
>>>Enter the sslDomain for the CA [idm]:
>>>Searching the LDAP for the CA usercertificate ...
Invoking Webgate SSL Client Configuration Script...
>>>Searching the LDAP for the CA userpkcs12 ...
>>>Enter your 10g WebGate install location: [e.g. /scratch/aime/wg10/access] /scratch/install/OAM10/cwg/access

****************************************************************
*** CA root cert has been converted from DER to PEM format.  ***
****************************************************************

>>>Enter WebGate ID: wg7777

>>>Enter WebGate Password:

>>>Enter the Access Server Host Name [adc123.example.com]:

>>>Enter the Access Server Port [6021]:

>>>Enter Access Server ID: aaa1

>>>Enter WebGate Pass Phrase:

****************************************************************
*** This script will first invoke configureWebGate tool to   ***
*** reconfig webgate in cert mode, and then generate a       ***
*** certificate request.                                     ***
****************************************************************

Preparing to generate certificate.  This may take up to 60 seconds.  Please wait.
Generating a 1024 bit RSA private key
...............++++++
....................++++++
writing new private key to '/scratch/install/OAM10/cwg/access/oblix/config/aaa_key.pem'
-----
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [US]:US
State or Province Name (full name) [Some-State]:California
Locality Name (eg, city) []:Redwood Shores
Organization Name (eg, company) [Some-Organization Pty Ltd]:Example
Organizational Unit Name (eg, section) []:OAM
Common Name (eg, hostName.domainName.com) []:adc123.example.com
Email Address []:
writing RSA key

Your certificate request is in file : /scratch/install/OAM10/cwg/access/oblix/config/aaa_req.pem

Please get your certificate request signed by the Certificate Authority

On obtaining your certificate, please place your certificate in '/scratch/install/OAM10/cwg/access/oblix/config/aaa_cert.pem' file and Access Server's CA certificate in '/scratch/install/OAM10/cwg/access/oblix/config/aaa_chain.pem' file

Once you have your certificate placed at the above mentioned location, please run '/scratch/install/OAM10/cwg/access/oblix/tools/configureWebGate/configureWebGate' program

More Information on setting up Web Gate in Certificate mode can be obtained from the Setup Installation Guide

Press enter key to continue ...

****************************************************************
*** Now we will sign the certificate request using CA cert.  ***
****************************************************************

>>>Enter the CA wallet password:

Certificate request (aaa_req.pem) has been converted to orapki acceptable format in /scratch/install/WT/Oracle_WT1/rootCA/WEBGATE

The certificate has been signed by the root CA

****************************************************************
*** WebGate certificate have been installed into WebGate     ***
*** config directory.                                        ***
****************************************************************

****************************************************************
*** Testing connection to AAA Server ...                     ***
*** (Make sure AAA Server is up and running.)                ***
****************************************************************

Preparing to connect to Access Server.  Please wait.

Web Gate installed Successfully.

****************************************************************
*** Restarting OHS ...                                       ***
****************************************************************

Do you want to restart your OHS webserver? [y/n] y

>>>Enter ORACLE_HOME for your OHS webtier install [e.g. /scratch/aime/WT/Oracle_WT1]: /scratch/install/WT/Oracle_WT1

>>>Enter ORACLE_INSTANCE for your OHS webtier instance [e.g. /scratch/aime/WT/Oracle_WT1/instances/instance1]: /scratch/install/WT/Oracle_WT1/instances/instance1

>>>Enter OHS component id [ohs1]:

OHS instance has been started/restarted

****************************************************************
*** Your 10g WebGate has been setup successfully in cert     ***
*** mode.                                                    ***
****************************************************************

8 キーストア、ウォレットおよび証明書の管理

この章では、Oracle Fusion Middlewareのセキュリティ機能を使用してキーストア、ウォレットおよび証明書を管理する方法について説明します。これらの項目が含まれます。

- Oracle Fusion Middlewareでの鍵および証明書の保存

- キーストアおよびウォレット用コマンドライン・インタフェース

- JKSキーストアの管理

- ウォレットの管理

8.1 Oracle Fusion Middlewareでの鍵および証明書の保存

秘密鍵、デジタル証明書および信頼できるCA証明書は、キーストアに格納されます。この項では、Oracle Fusion Middlewareで使用可能なキーストアについて説明します。この項の項目は次のとおりです。

- キーストアのタイプ

- キーストア管理ツール

8.1.1 キーストアのタイプ

Oracle Fusion Middlewareには、鍵と証明書の2つのタイプのキーストアが用意されています。

- JKSキーストアとトラストストア

- Oracleウォレット

8.1.1.1 JKSキーストアとトラストストア

JKSキーストアは、Sun Microsystemsが提供するJavaキーストアのデフォルトのJDK実装です。11g リリース1(11.1.1)では、すべてのJavaコンポーネントおよびJava EEアプリケーションは、JKSベースのキーストアおよびトラストストアを使用します。

JKSベースのキーストアは次に対して使用します。

- Oracle WebLogic Server

- Oracle Virtual Directory

- 次を含むOracle WebLogic Serverでデプロイされるアプリケーション

- Oracle SOA Suite

- Oracle WebCenter Portal

Oracle Fusion Middlewareでは、グラフィカル・ユーザー・インタフェース・ツールまたはコマンドライン・ツールを使用して、Javaキーストアおよびそれに含まれる証明書を作成、インポート、エクスポートおよび削除できます。詳細は、キーストア管理ツールに関する項を参照してください。

キーストアの作成時に、自己署名証明書でラップされた鍵のペアをあらかじめキーストアに移入しておくことができます。このようなキーストアは、一般的には開発またはテスト・フェーズで使用されます。

また、認証局(CA)から署名された証明書を返送してもらえるように、鍵のペアの証明書署名リクエストを生成することもできます。証明書は、CAから返送されると、キーストアにインポートされます。これは信頼できるサード・パーティから取得したものなので、キーストアには信頼できる証明書が格納されたことになります。このようなキーストアは、一般的に本番環境で使用されます。

キーストアは、常にパスワードで保護されます。

8.1.1.2 Oracleウォレット

Oracleウォレットは、証明書、信頼できる証明書、証明書リクエスト、秘密鍵などの資格証明を格納するコンテナです。Oracle Internet DirectoryなどのLDAPディレクトリやファイル・システムにOracleウォレットを格納できます。Oracleウォレットは、パスワードで保護することも自動ログインにもできます。

Oracleウォレットは次のコンポーネントで使用します。

- Oracle HTTP Server

- Oracle Web Cache

- Oracle Internet Directory

注意:

Oracle Internet Directory用に構成されたウォレットは、自動ログインが有効になっている必要があります。

Oracle Fusion Middlewareでは、グラフィカル・ユーザー・インタフェース・ツールまたはコマンドライン・ツールを使用して、ウォレットおよびそれに含まれる証明書を作成、インポート、エクスポートおよび削除できます。詳細は、キーストア管理ツールに関する項を参照してください。

ウォレットの作成時に、自己署名証明書をあらかじめ移入しておくことができます。このようなウォレットはテスト・ウォレットと呼ばれ、一般的には開発およびテスト・フェーズで使用されます。

また、認証局(CA)から署名された証明書を返送してもらえるように、証明書リクエストを生成することもできます。証明書は、CAから返送されると、ウォレットにインポートされます。このようなウォレットをサード・パーティのウォレットといいます。

テスト・ウォレットまたはサード・パーティのウォレットはパスワードで保護することも、パスワードが不要なように構成することもできます。後者は、自動ログイン・ウォレットと呼ばれています。

8.1.2 キーストア管理ツール

Oracle Fusion Middlewareでは、次のようなキーストア操作のオプションが用意されています。

- WLST: JKSキーストアおよびウォレット用のコマンドライン・インタフェース

- orapki: ウォレット用のコマンドライン・ツール

- Fusion Middleware Control: グラフィカル・ユーザー・インタフェース

- Oracle Wallet Manager: ウォレット用のスタンドアロンのグラフィカル・ユーザー・インタフェース(PKCS#11ウォレットの管理に推奨)。この項の最後の「スタンドアロン環境でのOracle Wallet Managerの使用」も参照してください。

次の表は、各コンポーネントで使用されるキーストアのタイプ、およびキーストアの管理に使用できるツールを示します。

コンポーネント/アプリケーション

キーストアのタイプ

タスク

ツール

Oracle HTTP Server

Oracle Web Cache

Oracle Internet Directory

Oracleウォレット

ウォレットの作成、証明書リクエストの作成、ウォレットの削除、証明書のインポート、証明書のエクスポート、SSLの有効化

Fusion Middleware Control、WLST

PKCS#11、PKCS#12およびハードウェア・セキュリティ・モジュール(HSM)ベースのウォレットには、Oracle Wallet Managerおよびorapki。また、Fusion Middleware ControlおよびWLSTが使用できない環境(ドメインのないこれらのコンポーネントのスタンドアロンのアップグレードなど)でも使用されます。

Oracle Virtual Directory

JKSベースのキーストア

キーストアの作成、証明書リクエストの作成、キーストアの削除、証明書のインポート、証明書のエクスポート、SSLの有効化

Fusion Middleware Control、WLST

Oracle SOA Suite

JKSベースのキーストア

キーストアのすべての操作

JDK Keytool

Oracle WebCenter Portal

JKSベースのキーストア

キーストアのすべての操作

JDK Keytool

Oracle WebLogic Server

JKSベースのキーストア

キーストアのすべての操作

JDK Keytool

Oracle WebLogic Server

JKSベースのキーストア

SSLの有効化

Oracle WebLogic Server管理コンソール

すべてのJava EEアプリケーション(Oracle Directory Integration Platform、Oracle Directory Services Managerなど)

JKSベースのキーストア

キーストアのすべての操作

JDK Keytool

関連項目:

- keytoolの使用法の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』を参照してください。

- ウォレットの管理に関する詳細は、次のサポート・ノートを参照してください。1225107.1、1242014.1および1237143.1。

注意:

11gより前のウォレット(10g リリース10.1.2および10.1.3の形式に対応)も、11g リリース1(11.1.1)でサポートされています。

8.1.2.1 DERでエンコードされた証明書のインポートについて

DERでエンコードされた証明書または信頼できる証明書をOracleウォレットまたはJKSキーストアにインポートするときには、Fusion Middleware ControlもWLSTコマンドライン・ツールも使用できません。かわりに使用するツールは次のとおりです。

- DERでエンコードされた証明書または信頼できる証明書をOracleウォレットにインポートするには、次のツールを使用します。

- Oracle Wallet Manager

- orapkiコマンドライン・ツール

- DERでエンコードされた証明書または信頼できる証明書をJKSキーストアにインポートするには、keytoolユーティリティを使用します。詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のIDと信頼の構成に関する項を参照してください。

BASE64でエンコードされている証明書をCAから入手するか、Internet Explorerまたは別のツールを使用して証明書をインポートしてBASE64形式でエクスポートすることもできます。

8.1.2.2 WLSTまたはFusion Middleware Controlで作成されていないキーストアの使用

OracleウォレットまたはJKSキーストアがorapkiやkeytoolなどのツールで作成されている場合には、使用する前にインポートする必要があります。具体的には次のような場合です。

- Oracle HTTP Server、Oracle Web CacheおよびOracle Internet Directoryでは、orapkiまたはOracle Wallet Managerを使用して作成されたウォレットをFusion Middleware Controlで表示または管理するには、まずFusion Middleware ControlまたはWLSTのimportWalletコマンドを使用してウォレットをインポートする必要があります。詳細は、第8.4.4.9項および第8.4.4.10項を参照してください。

- Oracle Virtual Directoryでは、keytoolを使用して作成されたキーストアをFusion Middleware Controlで表示または管理するには、まずFusion Middleware ControlまたはWLSTのimportKeyStoreコマンドを使用してキーストアをインポートする必要があります。

8.1.2.3 ファイル・システムへのキーストアのコピーはサポート対象外

ファイル・システム上の任意のディレクトリにキーストアを直接作成、名前変更、またはコピーすることはサポートされていません。使用を希望する11gより前の既存のキーストアまたはウォレットは、Fusion Middleware ControlまたはWLSTユーティリティを使用してインポートする必要があります。

8.1.2.4 スタンドアロン環境でのOracle Wallet Managerの使用について

スタンドアロンWeb層インストールなどのスタンドアロン環境では、Oracle Wallet Managerを使用して、ウォレットを作成および管理できます。

PKCS#12ウォレット、ウォレットと証明書のライフサイクルなど、Oracle Wallet Managerの詳細は、Oracle Advanced Security管理者ガイドの「Oracle Wallet Managerの使用」を参照してください。

http://download.oracle.com/docs/cd/E11882_01/network.112/e10746/asowalet.htm

8.1.2.5 キーストア管理に関する追加情報

これらのツールの詳細は、次の各項を参照してください。

- キーストアおよびウォレット用コマンドライン・インタフェース

- JKSキーストアの管理

- ウォレットの管理

- 付録H「Oracle Wallet Managerおよびorapki」

8.2 キーストアおよびウォレット用コマンドライン・インタフェース

Oracle Fusion Middlewareでは、JKSキーストアおよびOracleウォレットを作成および管理したり、そこに格納されたオブジェクトを操作するwlstスクリプトのセットを提供します。

WLSTコマンドライン・インタフェースの起動方法

SSL用のWLSTコマンドを実行する場合は、Oracle共通ホームからWLSTスクリプトを起動する必要があります。詳細は、第3.5.1.1項を参照してください。

注意:

SSL関連のすべてのWLSTコマンドでは、前述の場所でのみスクリプトを起動する必要があります。

これにより、WLSTシェルが起動します。ユーザー名、パスワードおよび接続URLを指定して、実行中のOracle WebLogic Serverインスタンスに接続します。接続すると、次の項で説明するようにSSL関連のWLSTコマンドを実行できるようになります。

8.3 JKSキーストアの管理

この項では、キーストアおよび証明書の一般的なライフサイクル、およびOracle Fusion Middlewareツールを使用してキーストアおよび証明書を作成および保守する方法について説明します。これらの項目が含まれます。

- キーストアおよび証明書について

- キーストアのライフサイクルの管理

- 一般的なキーストアの操作

- 証明書のライフサイクルの管理

- 一般的な証明書の操作

- キーストアおよび証明書の保守

8.3.1 キーストアおよび証明書について

鍵と証明書はデータのデジタル署名および検証に使用され、ネットワーク接続において認証、整合性およびプライバシを実現できます。

Javaキーストア(JKS)は、組織の鍵と証明書を保持する保護されたデータベースです。Oracle Fusion Middlewareは、Oracle Virtual Directory、Oracle WebLogic ServerにデプロイされたアプリケーションおよびOracle WebLogic Server自体に対して、JKSキーストアを使用します。

キーストアへのアクセスには、キーストアの作成者がキーストアの作成時に定義したパスワードが必要です。このパスワードを変更するには現在のパスワードを入力する必要があります。

また、キーストア内の秘密鍵は、それぞれ独自のパスワードで保護できます。

この項の項目は次のとおりです。

- インスタンス間のキーストアの共有

- キーストアのネーミング規則

8.3.1.1 インスタンス間のキーストアの共有

キーストアはそれぞれ一意のアイデンティティを示すため、コンポーネント・インスタンス間またはOracleインスタンス間ではキーストアを共有しないことをお薦めします。

ただし、コンポーネント・インスタンスのクラスタを含む環境は例外です。この場合はキーストアを共有してかまいません。

キーストアを簡単に共有するための管理ツールまたはインタフェースは用意されていません。ただし、あるインスタンスからキーストアをエクスポートして別のインスタンスにインポートすることはできます。詳細は8.3.3.4項を参照してください。

8.3.1.2 キーストアのネーミング規則

JKSキーストアの場合は、次のネーミング規則に従います。

- 256文字を超える名前は使用しないでください。

- キーストア名には、次のいずれの文字も使用しないでください。

| ; , ! @ # $ ( ) < > / \ " ' ` ~ { } [ ] = + & ^ space tab

注意:

オペレーティング・システムでこれらの文字をサポートしていても、このルールは守ってください。

- キーストア名には、ASCII以外の文字は使用しないでください。

- また、ディレクトリ名およびファイル名に関するオペレーティング・システム固有のルールにも従ってください。

8.3.2 キーストアのライフサイクルの管理

JKSキーストアの一般的なライフサイクル・イベントは、次のとおりです。

- キーストアが作成されます。キーストアは直接作成するか、ファイル・システムからキーストア・ファイルをインポートすることによって作成できます。

- 使用可能なキーストアのリストが表示され、特定のキーストアが選択されて更新されます。

- キーストアが更新または削除されます。更新操作では、キーストア・パスワードを入力する必要があります。

- キーストア・パスワードは変更できます。

- キーストアは削除できます。

- キーストアはエクスポートおよびインポートできます。

8.3.3 一般的なキーストアの操作

この項では、次のキーストアの操作について説明します。

- Fusion Middleware Controlを使用したキーストアの作成

- WLSTを使用したキーストアの作成

- Fusion Middleware Controlを使用したキーストアのエクスポート

- WLSTを使用したキーストアのエクスポート

- Fusion Middleware Controlを使用したキーストアの削除

- WLSTを使用したキーストアの削除

- Fusion Middleware Controlを使用したキーストアのインポート

- WLSTを使用したキーストアのインポート

- Fusion Middleware Controlを使用したキーストア・パスワードの変更

- WLSTを使用したキーストア・パスワードの変更

8.3.3.1 Fusion Middleware Controlを使用したキーストアの作成

次の手順を実行して、キーストアを作成します。

1. Fusion Middleware Controlを使用して目的のドメインにログインします。

2. ナビゲーション・ペインからコンポーネント・インスタンスを見つけます。

3. 「component_name」→「セキュリティ」→「キーストア」にナビゲートします。たとえば、「Oracle Virtual Directory」→「セキュリティ」→「キーストア」にナビゲートします。

注意:

コンポーネント・タイプは、このページの上部の「トポロジ」アイコンの横にあります。

4. 「Javaキーストア」ページが表示されます。このページで、キーストアを作成、更新および削除したり、他のキーストア管理タスクを実行することができます。

5. 「作成」をクリックします。「キーストアの作成」ダイアログが表示されます。

6. 名前やパスワードなどのキーストアの詳細情報を入力します。
このダイアログでは自己署名証明書をリクエストしたり、別名およびDN情報を入力することもできます。

図ks22.gifの説明

注意:

このキーストアを信頼できる証明書の格納にのみ使用する場合は、自己署名付き証明書の作成チェックボックスを選択解除できます。こうすると、鍵のペアを含まないキーストアが作成されます。

7. 「発行」をクリックします。Javaキーストアのリストに新しいキーストアが表示されます。

8.3.3.2 WLSTを使用したキーストアの作成

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用してキーストアを作成します。

createKeyStore('inst1', 'ovd5', 'ovd', 'newKeyStore', 'password')

passwordは、このキーストアのパスワードです。

関連項目:

- 第6.9.6項「createKeyStore」。

- 第6.9項の最初のコマンドの実行に必要なパラメータ値の取得方法に関する箇所。

8.3.3.3 Fusion Middleware Controlを使用したキーストアのエクスポート

複数のOracle Virtual Directoryインスタンスで同じキーストア・ファイルを共有するには、キーストアをあるインスタンスからエクスポートして別のインスタンスにインポートします。

次の手順を実行して、キーストアをエクスポートします。

1. 第8.3.3.1項「Fusion Middleware Controlを使用したキーストアの作成」の説明に従って、コンポーネント・インスタンスの「Javaキーストア」ページにナビゲートします。

2. ストアのリストから目的のキーストアを選択します。

3. 「エクスポート」をクリックします。

4. 表示されるダイアログ・ボックスにキーストアのパスワードを入力して続行します。

5. ファイル・システムの場所を指定して、「OK」をクリックします。
図ks33.gifの説明

関連項目:

第8.3.3.7項「Fusion Middleware Controlを使用したキーストアのインポート」

8.3.3.4 WLSTを使用したキーストアのエクスポート

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用してキーストアをエクスポートします。

exportKeyStore('inst1', 'ovd5', 'ovd', 'test', 'password', '/tmp')

passwordは、このキーストアのパスワードです。

このコマンドにより、ディレクトリ/tmpの下のtestという名前のファイルにキーストアがエクスポートされます。

関連項目:

第6.9.10項「exportKeyStore」。

8.3.3.5 Fusion Middleware Controlを使用したキーストアの削除

次の手順を実行して、キーストアを削除します。

1. 第8.3.3.1項「Fusion Middleware Controlを使用したキーストアの作成」の説明に従って、コンポーネント・インスタンスの「Javaキーストア」ページにナビゲートします。

2. ストアのリストから目的のキーストアを選択します。

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

4. 削除要求の確認を求めるダイアログ・ボックスが表示されます。
図ks44.gifの説明

5. 「削除」をクリックします。

8.3.3.6 WLSTを使用したキーストアの削除

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

アプリケーション・サーバー・インスタンス名をinst1とすると、次のコマンドを使用してキーストアを削除します。

deleteKeyStore('inst1', 'ovd5', 'ovd', 'demo')

ovdはコンポーネント・タイプ、ovd5はコンポーネント・インスタンス、demoはキーストア名です。

関連項目:

第6.9.8項「deleteKeyStore」。

8.3.3.7 Fusion Middleware Controlを使用したキーストアのインポート

1. 第8.3.3.1項「Fusion Middleware Controlを使用したキーストアの作成」の説明に従って、コンポーネント・インスタンスの「Javaキーストア」ページにナビゲートします。

2. 「インポート」をクリックします。

3. 「キーストアのインポート」ダイアログ・ボックスが表示されます。

4. ファイル・システムを参照して、キーストア・ファイルを見つけます。

5. キーストアの名前を入力します。キーストア・パスワードを入力します。
図ks40.gifの説明

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

7. インポートされたキーストアがJavaキーストアのリストに表示されます。
図ks42.gifの説明

8.3.3.8 WLSTを使用したキーストアのインポート

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用してキーストアをインポートします。

importKeyStore('inst1', 'ovd5', 'ovd', 'demojks', 'password', '/tmp/demojks.jks')

passwordは、このキーストアのパスワードです。

関連項目:

第6.9.18項「importKeyStore」。

8.3.3.9 Fusion Middleware Controlを使用したキーストア・パスワードの変更

次の手順を実行して、キーストア・パスワードを変更します。

1. 第8.3.3.1項「Fusion Middleware Controlを使用したキーストアの作成」の説明に従って、コンポーネント・インスタンスの「Javaキーストア」ページにナビゲートします。

2. キーストアを選択して、「パスワードの変更」をクリックします。

3. 表示されるダイアログ・ボックスに、現在のパスワードと新しいパスワードを入力します。新しいパスワードは、確認のため2回入力します。
図ks43.gifの説明

4. 「OK」をクリックして、パスワードを変更します。以降、このキーストアまたはその証明書を操作するには、この新しいパスワードを使用する必要があります。

8.3.3.10 WLSTを使用したキーストア・パスワードの変更

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用してキーストア・パスワードを変更します。

changeKeyStorePassword('inst1', 'ovd5', 'ovd', 'demojks', 'current_password', 'new_password')

current_passwordはこのキーストアの現在のパスワードで、new_passwordは新しいパスワードです。

関連項目:

第6.9.3項「changeKeyStorePassword」。

8.3.4 証明書のライフサイクルの管理

キーストアに存在する証明書の一般的なライフサイクル・イベントは、次のとおりです。

- 鍵のペアの自己署名証明書が自動的に作成されます。

- 証明書署名リクエスト(CSR)が生成され、ファイルにエクスポートできます。

- 証明書がキーストアにインポートされます。証明書はテキスト・ボックスに貼り付けることも、ファイル・システムからインポートすることもできます。ユーザー証明書も信頼できる証明書(CA証明書ともいいます)も、このようにインポートできます。

- 証明書または信頼できる証明書が、キーストアからファイルにエクスポートされます。

- 証明書または信頼できる証明書が、キーストアから削除されます。

8.3.5 一般的な証明書の操作

この項では、次のような一般的な証明書の操作について説明します。

- Fusion Middleware Controlを使用したキーストアの新しい鍵の生成

- WLSTを使用したキーストアの新しい鍵の生成

- Fusion Middleware Controlを使用した証明書署名リクエストの生成

- WLSTを使用した証明書署名リクエストの生成

- Fusion Middleware Controlを使用したキーストアへの証明書または信頼できる証明書のインポート

- WLSTを使用したキーストアへの証明書または信頼できる証明書のインポート

- Fusion Middleware Controlを使用したキーストアからの証明書または信頼できる証明書のエクスポート

- WLSTを使用したキーストアからの証明書または信頼できる証明書のエクスポート

- Fusion Middleware Controlを使用したキーストアからの証明書または信頼できる証明書の削除

- WLSTを使用したキーストアからの証明書または信頼できる証明書の削除

- Fusion Middleware Controlを使用したサード・パーティ証明書への自己署名証明書の変換

- WLSTを使用したサード・パーティ証明書への自己署名証明書の変換

8.3.5.1 Fusion Middleware Controlを使用したキーストアの新しい鍵の生成

キーストアの新しい鍵(新しい自己署名証明書)を生成する手順は次のとおりです。

1. 第8.3.3.1項「Fusion Middleware Controlを使用したキーストアの作成」の説明に従って、コンポーネント・インスタンスの「Javaキーストア」ページにナビゲートします。

2. ストアのリストからキーストアを選択します。

3. 表示されるダイアログ・ボックスにキーストアのパスワードを入力して続行します。

4. 「証明書の管理」ページが表示されます。ここでは、キーストア・エントリの両方のタイプ(証明書および信頼できる証明書)を管理できます。

5. 「鍵ペアの生成」ボタンをクリックします。

6. 「鍵ペアの生成」ダイアログで、新しい鍵の詳細を入力して「OK」をクリックします。

例: 新しい鍵ペアの生成

図ks27.gifの説明

この手順を実行すると、キーストアに新しい公開鍵と秘密鍵のペアが生成され、公開鍵は自己署名証明書でラップされます。

この手順では既存のキーストアに新しい鍵のペアを作成していますが、キーストア自体を作成するときに新しい鍵のペアを生成することもできます。詳細は、Fusion Middleware Controlを使用したキーストアの作成に関する項を参照してください。

8.3.5.2 WLSTを使用したキーストアの新しい鍵の生成

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用してキーストアの新しい鍵を生成します。

generateKey('inst1', 'ovd5', 'ovd', 'newKeystore', 'password', 'subject_dn', 'key_size', 'alias')

passwordはこのキーストアのパスワード、subject_dnは鍵ペアを生成する際に使用される識別名、key_sizeはキー・サイズ(ビット単位)、aliasは鍵の別名です。

関連項目:

WLSTコマンドの使用の詳細は、第6.9項を参照してください。

8.3.5.3 Fusion Middleware Controlを使用した証明書署名リクエストの生成

次の手順を実行して、証明書署名リクエスト(CSR)を作成します。

1. ナビゲーション・ペインからコンポーネント・インスタンスを見つけます。

2. 「component_name」→「セキュリティ」→「キーストア」にナビゲートします。

3. ストアのリストから目的のキーストアを選択します。

4. 表示されるダイアログ・ボックスにキーストアのパスワードを入力して続行します。

5. 「証明書の管理」ページが表示されます。CSRを生成する自己署名証明書を選択して、「CSRの生成」をクリックします。
図ks29.gifの説明

6. ダイアログ・ボックスが開き、生成された署名リクエストが表示されます。次のいずれかを実行できます。

- ダイアログ・ボックスからCSRをコピーして、ファイルに貼り付けます。

- 「CSRのエクスポート」ボタンをクリックして、ファイルに直接保存します。

図ks30.gifの説明

CSRのエクスポート後に、認証局(CA)に送信して、証明書を生成できます。

8.3.5.4 WLSTを使用した証明書署名リクエストの生成

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用してCSRを生成およびエクスポートします。

exportKeyStoreObject('inst1', 'ovd5', 'ovd', 'newKeystore', 'password', 'CertificateRequest', '/tmp', 'alias')

passwordはこのキーストアのパスワード、/tmpはBASE64形式で証明書リクエストが生成されるファイルbase64.txtを含むディレクトリのパス、aliasは証明書リクエストの生成に使用される鍵ペアの別名です。

関連項目:

WLSTコマンドの使用の詳細は、第6.9項を参照してください。

8.3.5.5 Fusion Middleware Controlを使用したキーストアへの証明書または信頼できる証明書のインポート

注意:

DERでエンコードされた証明書または信頼できる証明書をJKSキーストアにインポートするには、Fusion Middleware Controlは使用できません。このタスクには、keytoolユーティリティを使用します。詳細は8.1.2.1項を参照してください。

次の手順を実行して、証明書または信頼できる証明書をキーストアにインポートします。

1. ナビゲーション・ペインからコンポーネント・インスタンスを見つけます。

2. 「component_name」→「セキュリティ」→「キーストア」にナビゲートします。

3. ストアのリストから目的のキーストアを選択します。

4. 表示されるダイアログ・ボックスにキーストアのパスワードを入力して続行します。

5. 「証明書の管理」ページが表示されます。「インポート」ボタンをクリックします。

6. ダイアログ・ボックスが表示され、次のいずれかを実行できます。

- 証明書または信頼できる証明書のBase-64でエンコードされたコンテンツをキーストアに直接貼り付けます。

- 証明書または信頼できる証明書ファイルをファイル・システムから選択します。

図ks34.gifの説明

証明書をインポートする際に別名を指定する必要があります。

証明書をインポートする場合、別名は対応する鍵のペアの別名と一致する必要があります。

信頼できる証明書をインポートする場合、別名はキーストア内で一意である必要があります。

7. 「OK」をクリックします。「証明書の管理」ページが開き、新しくインポートされた証明書または信頼できる証明書が表示されます。
図ks35.gifの説明

8.3.5.6 WLSTを使用したキーストアへの証明書または信頼できる証明書のインポート

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

注意:

DERでエンコードされた証明書または信頼できる証明書をJKSキーストアにインポートするには、WLSTコマンドライン・ツールは使用できません。このためには、keytoolユーティリティを使用します。第8.1.2.1項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用してキーストアに証明書をインポートします。

importKeyStoreObject('inst1', 'ovd5', 'ovd', 'newKeystore', 'password', 'Certificate', '/tmp/cert.txt', 'alias')

passwordはこのキーストアのパスワード、/tmp/cert.txtはBASE64でエンコードされた証明書を含むファイル、aliasはこの証明書をインポートする際に使用される別名です。この別名は、この証明書リクエストの生成に使用された鍵ペアの別名と同じにする必要があります。

関連項目:

WLSTコマンドの使用の詳細は、第6.9項を参照してください。

8.3.5.7 Fusion Middleware Controlを使用したキーストアからの証明書または信頼できる証明書のエクスポート

次の手順を実行して、証明書または信頼できる証明書をキーストアからエクスポートします。

1. ナビゲーション・ペインからコンポーネント・インスタンスを見つけます。

2. 「component_name」→「セキュリティ」→「キーストア」にナビゲートします。

3. ストアのリストから目的のキーストアを選択します。

4. 表示されるダイアログ・ボックスにキーストアのパスワードを入力して続行します。

5. 「証明書の管理」ページが表示されます。「エクスポート」をクリックします。

6. ダイアログ・ボックスが開き、Base64でエンコードされた証明書または信頼できる証明書が表示されます。コンテンツをテキスト・ボックスからコピーしてファイルに貼り付けるか、「エクスポート」ボタンを選択してファイルに直接貼り付けます。
図ks32.gifの説明

8.3.5.8 WLSTを使用したキーストアからの証明書または信頼できる証明書のエクスポート

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用して証明書をエクスポートします。

exportKeyStoreObject('inst1', 'ovd5', 'ovd', 'newKeystore', 'password', 'Certificate', '/tmp', 'alias')

passwordはこのキーストアのパスワード、/tmpはBASE64形式で証明書が生成されるファイルbase64.txtを含むディレクトリのパス、aliasはエクスポートされる証明書の別名です。

関連項目:

WLSTコマンドの使用の詳細は、第6.9項を参照してください。

8.3.5.9 Fusion Middleware Controlを使用したキーストアからの証明書または信頼できる証明書の削除

次の手順を実行して、証明書または信頼できる証明書をキーストアから削除します。

1. ナビゲーション・ペインからコンポーネント・インスタンスを見つけます。

2. 「component_name」→「セキュリティ」→「キーストア」にナビゲートします。

3. ストアのリストから目的のキーストアを選択します。

4. 表示されるダイアログ・ボックスにキーストアのパスワードを入力して続行します。

5. 「証明書の管理」ページが表示されます。削除する証明書または信頼できる証明書を選択して、「削除」をクリックします。

6. 選択を確認するダイアログ・ボックスが表示されます。「OK」を選択して確認します。
図ks50.gifの説明

8.3.5.10 WLSTを使用したキーストアからの証明書または信頼できる証明書の削除

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

アプリケーション・サーバー・インスタンス名をinst1とすると、次のコマンドを使用して証明書を削除します。

removeKeyStoreObject('inst1', 'ovd5', 'ovd', 'newKeystore', 'password', 'Certificate', 'alias')

passwordはこのキーストアのパスワードで、aliasは削除する証明書の別名です。

関連項目:

WLSTコマンドの使用の詳細は、第6.9項を参照してください。

8.3.5.11 Fusion Middleware Controlを使用したサード・パーティ証明書への自己署名証明書の変換

次の手順を実行して、キーストアに存在する自己署名証明書をサード・パーティ証明書に変換します。

1. ナビゲーション・ペインからコンポーネント・インスタンスを見つけます。

2. 「component_name」→「セキュリティ」→「キーストア」にナビゲートします。

3. ストアのリストから自己署名証明書が格納されているキーストアを選択します。

4. 表示されるダイアログ・ボックスにキーストアのパスワードを入力し、「OK」をクリックして続行します。

5. 「証明書の管理」ページが表示されます。

6. 変換対象の自己署名証明書用に新しい証明書リクエストを生成する必要があります。証明書を選択して、「CSRの生成」をクリックします。この例では、別名がdemoである自己署名証明書のリクエストが作成されます。
図jksconv3.gifの説明

証明書リクエストが表示されます。

7. 次のいずれかを実行できます。

- Base64でエンコードされた証明書リクエストをコピーしてファイルに貼り付けます。

- 「CSRのエクスポート」ボタンを使用して、ファイルに直接エクスポートします。

8. 証明書リクエスト・ファイルを認証局(CA)に送信します。

9. CAは証明書リクエストに署名して、証明書を生成します。CAは、次のいずれかを返送します。

- 1個のファイル。新しく生成された証明書と独自のCA証明書の両方がpkcs7形式で含まれます。

- 2個のファイル。一方には新しく生成された証明書、もう一方には独自のCA証明書が含まれます。

10. 「インポート」を使用して、これらのファイルをキーストアにインポートします。

- CAから1個のファイルを受信した場合は、置き換える自己署名証明書の別名(ステップ6を参照)と一致する別名を使用して、証明書としてインポートします。

- 2個のファイルを受信した場合は、次の手順を実行します。

- CA証明書が含まれるファイルを信頼できる証明書としてインポートします(キーストア内で一意の別名を使用)。

- 証明書ファイルを証明書としてインポートします(置き換える自己署名証明書の別名と一致する別名を使用)。

注意:

順序は重要です。信頼できる証明書、証明書の順にインポートする必要があります。

CAから1個のファイルが返され、これを証明書としてインポートします。

図jksconv4.gifの説明

11. インポート後に、CAが発行した証明書で自己署名証明書が置き換えられます。

8.3.5.12 WLSTを使用したサード・パーティ証明書への自己署名証明書の変換

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

次の手順を実行して、自己署名証明書をサード・パーティ証明書(認証局によって署名された証明書)に変換します。

1. CSRを生成およびエクスポートします。

exportKeyStoreObject('inst1', 'ovd5', 'ovd', 'jks1', '<password>', 'CertificateRequest', '/tmp', 'mykey')

2. CSR /tmp/base64.txtを認証局に送信します。CAは、PKCS#7形式の1つのファイルまたは2つの別々のファイルとして、新しく生成された証明書と独自の証明書を返送します。

3. CAから1個のファイルを受信した場合は、次のコマンドを実行します。

importKeyStoreObject('inst1', 'ovd5', 'ovd', 'jks1', 'password', 'Certificate', '/tmp/cert.txt', 'alias')

passwordはこのキーストアのパスワード、/tmp/cert.txtはCAから返され、BASE64でエンコードされたPKCS#7を含むファイル、aliasはこの証明書をインポートする際に使用される別名です。この別名は、この証明書リクエストの生成に使用された鍵ペアの別名と一致している必要があります。

CAから2個のファイルを受信した場合は、信頼できる証明書としてCA証明書を最初にインポートし、次に新しく生成された証明書をインポートします。

importKeyStoreObject('inst1', 'ovd5', 'ovd', 'jks1', 'password', 'TrustedCertificate', '/tmp/cacert.txt', 'unique_alias')

unique_aliasは、信頼できる証明書をインポートする際に使用される一意の別名です。

importKeyStoreObject('inst1', 'ovd5', 'ovd', 'jks1', 'password', 'Certificate', '/tmp/cert.txt', 'alias')

passwordはこのキーストアのパスワード、/tmp/cert.txtはCAから返され、BASE64でエンコードされた証明書を含むファイル、/tmp/cacert.txtはBASE64でエンコードされたCA証明書を含むファイル、aliasはこの証明書をインポートする際に使用される別名です。この別名は、この証明書リクエストの生成に使用された鍵ペアの別名と一致している必要があります。

関連項目:

WLSTコマンドの使用の詳細は、第6.9項を参照してください。

8.3.6 キーストアおよび証明書の保守

この項は次の管理に関する項目で構成されています。

- キーストアの場所

- 期限が切れそうな証明書の置換え

- ホスト名変更のキーストアへの影響

8.3.6.1 キーストアの場所

Oracle Virtual Directoryキーストアのルート・ディレクトリは、$ORACLE_INSTANCE/config/OVD/ovd_instance_name/keystoresです。

このルート・ディレクトリには、すべてのJKSファイルが含まれます。

keys.jksとtrust.jksという2つのキーストアがあるとすると、サンプル構造は次のようになります。

ORACLE_INSTANCE/config/OVD/ovd_instance_name/keystores/keys.jks
ORACLE_INSTANCE/config/OVD/ovd_instance_name/keystores/trust.jks

8.3.6.2 期限が切れそうな証明書の置換え

期限が切れそうな証明書は、実際に期限が切れる前に置き換えて、アプリケーションの停止時間を回避または短縮する必要があります。

期限が切れそうな証明書を置き換える手順は次のとおりです。

1. キーストアから証明書リクエストを生成します(現在期限が切れそうな証明書の発行時と同じ鍵ペアを使用します)。

2. 証明書発行のために、この証明書リクエストをサード・パーティの認証局(CA)に送信します。新しい証明書の発効日は、現在の証明書の失効日より早くしてください。停止時間を短縮するために、このような重複期間を設けることをお薦めします。

注意:

サード・パーティのCAがすでにリポジトリの証明書リクエストを保守している場合、ステップ1と2は不要です。その場合は、単純にその証明書リクエストの新しい証明書の発行をCAに依頼します。

3. 新しく発行された証明書を、鍵ペアの別名と同じ別名を使用してキーストアにインポートします。

4. 新しい証明書が元の証明書の発行元以外のCAで発行された場合は、新しく発行された証明書をインポートする前に、新しいCAの信頼できる証明書をインポートする必要があります。

8.3.6.3 ホスト名変更のキーストアへの影響

一般的には、証明書のDNはキーストアが使用されるサーバーのホスト名に基づいています。

たとえば、キーストアがOracle Virtual Directoryサーバーのホストmy.example.comで作成されている場合、このOracle Virtual Directoryキーストアの証明書のDNは次のようになります。

"CN=my.example.com,O=organization name"

ほとんどのクライアントはSSLハンドシェイク時にホスト名を検証するため、この同期は必須です。

ホスト名の検証を実行するクライアントには、WebブラウザやOracle HTTP Clientなどがあります。サーバーのホスト名が証明書のDNと一致しない場合、次のように処理されます。

- 明確な警告が表示されます(ブラウザ・クライアントの場合)。

- SSLハンドシェイクが失敗する場合があります(その他のクライアントの場合)。

クライアントからリクエストを受信しているサーバー上にキーストアがある場合、このサーバーのホスト名が変更されるたびに、キーストア内の証明書も更新する必要があります。

これは、新しいDN(新しいホスト名に基づく)で新しい証明書をリクエストすることで実行できます。

本番のキーストアの場合

手順は次のとおりです。

1. 新しいDN(新しいホスト名に基づく)で新しいリクエストを生成します。詳細は8.3.5.3項を参照してください。

2. このリクエストを認証局(CA)に送信します。

3. CAから新しい証明書が返送されます。

4. 証明書リクエストが生成された鍵ペアと同じ別名で新しい証明書をインポートします。詳細は8.3.5.5項を参照してください。

自己署名付きキーストアの場合

手順は次のとおりです。

1. 既存のキーストアを削除します。詳細は8.3.3.5項を参照してください。

2. 新しいDN(新しいホスト名に基づく)を使用して鍵ペアを含む新しいキーストアを作成します。詳細は8.3.3.1項を参照してください。

両方のタイプのキーストアでは

本番キーストアの場合も自己署名付きキーストアの場合も、新しい証明書がキーストアで使用可能になったら、信頼する必要があるすべてのコンポーネントのキーストアにその証明書を確実にインポートします。たとえば、Oracle Virtual DirectoryのHTTPリスナーでSSLが有効な場合、ホスト名の変更によって証明書が変更されたら、新しい証明書をクライアント・キーストアまたはブラウザ・リポジトリにインポートして、新しいピアを信頼できるようにする必要があります。

8.4 ウォレットの管理

この項の項目は次のとおりです。

- ウォレットおよび証明書について

- Fusion Middleware Controlのウォレット管理ページへのアクセス

- ウォレットのライフサイクルの管理

- 一般的なウォレットの操作

- 証明書のライフサイクルの管理

- Fusion Middleware Controlのウォレットの証明書管理ページへのアクセス

- 一般的な証明書の操作

- ウォレットおよび証明書の保守

8.4.1 ウォレットおよび証明書について

この項の項目は次のとおりです。

- パスワードで保護されたウォレットと自動ログイン・ウォレット

- 自己署名付きウォレットとサード・パーティのウォレット

- インスタンス間でのウォレットの共有

- ウォレットのネーミング規則

8.4.1.1 パスワードで保護されたウォレットと自動ログイン・ウォレット

作成できるウォレットは次の2種類です。

- 自動ログイン・ウォレット
これは、PKCS#12ウォレットの不明瞭化された形式です。実行時にパスワードを入力せずに、サービスおよびアプリケーションにPKIベースでアクセスできます。ウォレットへの追加、変更、削除の際にも、パスワードは不要です。ファイル・システム権限では、ウォレットの自動ログインに必要なセキュリティが提供されます。

注意:

以前のリリースでは、パスワード付きのウォレットを作成してから自動ログインを有効にして不明瞭化されたウォレットを作成できました。11g リリース1(11.1.1)では、自動ログイン・ウォレットはパスワードなしで作成されます。そのようなウォレットを使用する場合、パスワードを指定する必要はありません。

パスワードのない自動ログインのウォレットを使用している場合、ldapbindコマンドで空値のパスワード("")を指定します。

古いタイプのウォレット(リリース10gのウォレットなど)は、引き続き以前と同様に機能します。

- パスワードで保護されたウォレット
名前のとおり、このタイプのウォレットはパスワードで保護されます。ウォレットのコンテンツに対する追加、変更または削除には、パスワードが必要です。

パスワードで保護されたウォレットが作成されるたびに、自動ログイン・ウォレットが自動的に生成されます。ただし、この自動ログイン・ウォレットは、前の項目で説明した、ユーザーが作成した自動ログイン・ウォレットとは異なります。ユーザーが作成したウォレットは構成時にパスワードなしで更新することができますが、自動的に生成される自動ログイン・ウォレットは直接更新できない読取り専用のウォレットです。ウォレットへの変更は、自動ログイン・ウォレットを再度生成するときに、パスワードで保護されたファイルを使用して(パスワードを入力して)行う必要があります。

このシステム生成の自動ログイン・ウォレットの目的は、実行時にパスワードなしでサービスおよびアプリケーションにPKIベースのアクセスを提供することですが、構成時にはパスワードが必要です。

注意:

Oracle Internet Directory用に構成されたウォレットは、自動ログインが有効になっている必要があります。

8.4.1.2 自己署名付きウォレットとサード・パーティのウォレット

自己署名付きウォレットには、発行者がサブジェクトと同じである証明書が格納されます。これらの証明書は、一般的には信頼性がさほど優先されないイントラネット環境内で作成されます。自己署名付きウォレットの発行者はそれぞれ一意であるため、複数のコンポーネントおよびウォレットを含む環境では信頼性管理タスクはn倍に増加します。

Fusion Middleware Controlを使用して作成した場合、自己署名付きウォレットは5年間有効です。

サード・パーティのウォレットには、よく知られているCAで発行された証明書が格納されます。機能およびセキュリティは自己署名付きウォレットと同じですが、サード・パーティの証明書は、発行者がよく知られており、多くのクライアントから信頼されているので、信頼性が向上します。

自己署名付きウォレットとサード・パーティのウォレットの違い

機能およびセキュリティの観点からは、自己署名証明書はサード・パーティで発行された証明書と同等です。唯一の異なる点は、自己署名証明書は信頼性がないことです。

8.4.1.3 インスタンス間でのウォレットの共有

ウォレットはそれぞれ一意のアイデンティティを示すため、コンポーネント・インスタンス間またはOracleインスタンス間ではウォレットを共有しないことをお薦めします。

ただし、コンポーネント・インスタンスのクラスタを含む環境は例外です。この場合はウォレットを共有してかまいません。

ウォレットを簡単に共有するための管理ツールまたはインタフェースは用意されていません。ただし、あるインスタンスからウォレットをエクスポートして別のインスタンスにインポートすることはできます。ウォレットのエクスポートおよびインポートの詳細は、第8.4.4項を参照してください。

8.4.1.4 ウォレットのネーミング規則

Oracleウォレットの場合は、次のネーミング規則に従います。

- 256文字を超える名前は使用しないでください。

- ウォレット名には、次のいずれの文字も使用しないでください。

| ; , ! @ # $ ( ) < > / \ " ' ` ~ { } [ ] = + & ^ space tab

注意:

オペレーティング・システムでこれらの文字をサポートしていても、このルールは守ってください。

- ウォレット名には、ASCII以外の文字は使用しないでください。

- また、ディレクトリ名およびファイル名に関するオペレーティング・システム固有のルールにも従ってください。

Oracle Internet DirectoryなどのLDAPディレクトリでのデータの処理方法により、ウォレット名では大文字と小文字が区別されません。

そのため、ウォレット名は大文字/小文字を区別せずに使用することをお薦めします(可能であれば、すべて小文字を使用します)。たとえば、UPPERという名前のウォレットを作成した場合、upperという名前のウォレットを別に作成しないでください。作成すると、ウォレットの管理作業時に混乱を引き起こす可能性があります。

8.4.2 Fusion Middleware Controlのウォレット管理ページへのアクセス

Oracleウォレットは、使用先のコンポーネントに関連付けられます。コンポーネント・インスタンスを探す手順は次のとおりです。

1. 管理者の資格証明を使用してFusion Middleware Controlにログインします。

2. 目的のドメインを選択します。

注意:

「設定」を使用すると、作業対象の特定のOracle WebLogic Serverドメインを見つけることができます。

3. ナビゲーション・ペインで、ウォレットを使用するインスタンス(OHSインスタンスなど)を探します。インスタンスをクリックします。
ページの左上の「ファーム」ドロップダウンの横にコンポーネント・タイプが表示されます。

4. コンポーネント・タイプのドロップダウンから選択します(Oracle HTTP Serverなど)。
コンポーネントが起動していない場合、右クリックして「コンポーネント」メニューを開き、「コントロール」→「起動」を押して、コンポーネントを起動します。

5. 「セキュリティ」→「ウォレット」にナビゲートします。

6. 「ウォレット」ページが表示されます。

「ウォレット」ページで、次の処理を実行できます。

- ウォレットの作成

- ウォレットの削除

- ウォレットのインポート

- ウォレットのエクスポート

8.4.3 ウォレットのライフサイクルの管理

Oracleウォレットの一般的なライフサイクル・イベントは、次のとおりです。

- ウォレットが作成されます。ウォレットは直接作成するか、ファイル・システムからウォレット・ファイルをインポートすることによって作成できます。

注意:

マルチバイト・キャラクタ・セット(MBCS)に基づくウォレット名はサポートされていません。MBCSを使用してウォレットを作成しないでください。

- 使用可能なウォレットのリストが表示され、特定のウォレットが選択されて更新されます。

- ウォレットが更新または削除されます。パスワードで保護されたウォレットの更新操作では、ウォレット・パスワードを入力する必要があります。

- パスワードで保護されたウォレットでは、ウォレット・パスワードは変更できます。

- ウォレットは削除できます。

- ウォレットはエクスポートおよびインポートできます。

8.4.4 一般的なウォレットの操作

この項では、次のような様々なウォレット管理機能を実行するために必要な手順について説明します。

- Fusion Middleware Controlを使用したウォレットの作成

- WLSTを使用したウォレットの作成

- Fusion Middleware Controlを使用した自己署名付きウォレットの作成

- WLSTを使用した自己署名付きウォレットの作成

- Fusion Middleware Controlを使用した自己署名付きウォレットのサード・パーティのウォレットへの変更

- WLSTを使用した自己署名付きウォレットのサード・パーティのウォレットへの変更

- Fusion Middleware Controlを使用したウォレットのエクスポート

- WLSTを使用したウォレットのエクスポート

- Fusion Middleware Controlを使用したウォレットのインポート

- WLSTを使用したウォレットのインポート

- Fusion Middleware Controlを使用したウォレットの削除

- WLSTを使用したウォレットの削除

注意:

マルチバイト・キャラクタ・セット(MBCS)に基づくウォレット名はサポートされていません。MBCSを使用してウォレットを作成しないでください。

8.4.4.1 Fusion Middleware Controlを使用したウォレットの作成

次の手順を実行して、ウォレットを作成します。

1. コンポーネント・インスタンスの「ウォレット」ページにナビゲートします。Fusion Middleware Controlのウォレット管理ページへのアクセスに関する項を参照してください。

2. 「作成」をクリックします。

3. 「ウォレットの作成」ページが表示されます。

4. ウォレットの名前を入力します。

5. ウォレットを自動ログイン・ウォレットにするかどうかによって、「自動ログイン」ボックスを選択または選択解除します。デフォルトでは、自動ログイン・ウォレットになります。
詳細は、パスワードで保護されたウォレットと自動ログイン・ウォレットに関する項を参照してください。

注意:

Oracle Internet Directory用に構成されたウォレットは、自動ログインが有効になっている必要があります。

図wal3.gifの説明

6. 「発行」をクリックします。

7. この時点で、証明書リクエスト(CR)を追加するかどうかを選択する必要があります。ここで追加しなくとも、CRは後でいつでも追加できます。詳細は、Fusion Middleware Controlを使用した証明書リクエストの追加に関する項を参照してください。
この例では、CRを追加します。

図wal5.gifの説明

注意:

ここに入力する共通名は、クライアントが接続するOracle HTTP Serverのホスト名と一致する必要があります。これにより、第8.4.8.2項で説明されている問題を回避できます。

8. 「終了」をクリックします。

9. CRには、次の2つのオプションがあります。

- Base64でエンコードされた証明書リクエストを、テキスト・ボックスからコピーしてファイルに貼り付けます。

- 「証明書リクエストのエクスポート」ボタンを使用して、ファイルに直接エクスポートします。

10. ウォレットの作成を確認するメッセージが表示されます。

8.4.4.2 WLSTを使用したウォレットの作成

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

注意:

この章で説明するWLSTコマンドでは、コンポーネントの例としてOracle Internet Directoryを使用します。Oracle HTTP ServerまたはOracle Web Cacheに対して同じコマンドを実行するには、3番目のパラメータをoidからそれぞれohsまたはwebcacheに変更します。

インスタンス名をinst1とすると、次のコマンドを使用してウォレットを作成します。

createWallet('inst1', 'oid1', 'oid', 'oid2', 'password')

oid2はこのウォレットの名前で、passwordはこのウォレットのパスワードです。自動ログイン・ウォレットを作成する必要がある場合、パスワードは''と指定する必要があります(引用符の間にテキストは入れません)。

関連項目:

第6.9.7項「createWallet」。

注意:

Oracle Internet Directory用に構成されたウォレットは、自動ログインが有効になっている必要があります。

8.4.4.3 Fusion Middleware Controlを使用した自己署名付きウォレットの作成

次の手順を実行して、自己署名付きウォレットを作成します。

関連項目:

第8.4.1.2項「自己署名付きウォレットとサード・パーティのウォレット」

1. コンポーネント・インスタンスの「ウォレット」ページにナビゲートします。Fusion Middleware Controlのウォレット管理ページへのアクセスに関する項を参照してください。

2. 「自己署名付きウォレットの作成」をクリックします。

3. 「自己署名付きウォレットの作成」ページで、次のデータを入力してウォレットを作成します。次のものが含まれます。

- ウォレット名

- 自動ログイン・ウォレットかどうか

関連項目:

第8.4.1.1項「パスワードで保護されたウォレットと自動ログイン・ウォレット」

- DN情報

- キー・サイズ
図wal8.gifの説明

4. 「発行」をクリックします。

5. 確認メッセージが表示され、新しいウォレットがウォレットのリストに表示されます。
図wal9.gifの説明

注意:

Oracle Internet Directory用に構成されたウォレットは、自動ログインが有効になっている必要があります。

8.4.4.4 WLSTを使用した自己署名付きウォレットの作成

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用して自己署名付きウォレットを作成します。

createWallet('inst1', 'oid1', 'oid', 'oid2', 'password')
addSelfSignedCertificate('inst1', 'oid1', 'oid', 'oid2', 'password', 'subject_dn', 'key_size')

oid2はウォレット名、subject_dnは自己署名証明書の識別名、key_sizeはキー・サイズ(ビット単位)、passwordはこのウォレットのパスワードです。自動ログイン・ウォレットを作成する必要がある場合、パスワードは''と指定する必要があります(引用符の間にテキストは入れません)。

関連項目:

- 第6.9.7項「createWallet」

- 第6.9.2項「addSelfSignedCertificate」

注意:

Oracle Internet Directory用に構成されたウォレットは、自動ログインが有効になっている必要があります。

8.4.4.5 Fusion Middleware Controlを使用した自己署名付きウォレットのサード・パーティのウォレットへの変更

自己署名付きウォレットをサード・パーティのウォレットに変換する手順は、自己署名付きウォレットのサード・パーティのウォレットへの変更に関する項を参照してください。

8.4.4.6 WLSTを使用した自己署名付きウォレットのサード・パーティのウォレットへの変更

自己署名付きウォレットをサード・パーティのウォレットに変換する手順は、自己署名付きウォレットのサード・パーティのウォレットへの変更に関する項を参照してください。

8.4.4.7 Fusion Middleware Controlを使用したウォレットのエクスポート

次の手順を実行して、ウォレットをエクスポートします。

1. コンポーネント・インスタンスの「ウォレット」ページにナビゲートします。Fusion Middleware Controlのウォレット管理ページへのアクセスに関する項を参照してください。

2. 目的のウォレットに対応する行を選択します。

注意:

ウォレットの名前自体をクリックしないでください。名前をクリックすると、証明書管理操作用のウォレットが開きます。

3. 「エクスポート」をクリックします。

4. 「ウォレットのエクスポート」ページが表示されます。

5. ファイル名とウォレットのエクスポート先を入力します。

6. 「OK」をクリックします。
図wal20.gifの説明

8.4.4.8 WLSTを使用したウォレットのエクスポート

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用してウォレットをエクスポートします。

exportWallet('inst1', 'oid1', 'oid', 'selfsigned', 'password', '/tmp')

passwordはこのウォレットのパスワードです(自動ログイン・ウォレットの場合、パスワードは''と指定する必要があります)。

自動ログイン・ウォレットの場合、このコマンドにより、ウォレットはディレクトリ/tmpの下のcwallet.ssoという名前のファイルにエクスポートされます。パスワードで保護されたウォレットの場合、/tmpの下にewallet.p12とcwallet.ssoという2つのファイルが作成されます。

関連項目:

第6.9.12項「exportWallet」。

8.4.4.9 Fusion Middleware Controlを使用したウォレットのインポート

次の手順を実行して、ウォレットをインポートします。

1. コンポーネント・インスタンスの「ウォレット」ページにナビゲートします。Fusion Middleware Controlのウォレット管理ページへのアクセスに関する項を参照してください。

2. 「インポート」をクリックします。

3. 「ウォレットのインポート」ページが表示されます。

4. これが自動ログイン・ウォレットの場合は、ボックスを選択してウォレット名を入力します。パスワードは不要です。
図wal10.gifの説明

5. これが自動ログイン・ウォレットでない場合は、自動ログイン・ボックスを選択解除します。ウォレット名とパスワードを指定します。
図wal11.gifの説明

6. 「OK」をクリックします。ウォレットがリポジトリにインポートされます。

8.4.4.10 WLSTを使用したウォレットのインポート

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用してウォレットをインポートします。

importWallet('inst1', 'oid1', 'oid', 'oid5', 'password', '/tmp/ewallet.p12')

passwordはインポートされるウォレットのパスワードで、/tmp/ewallet.p12にはウォレット・ファイルが含まれます(ewallet.p12とcwallet.ssoという2つのウォレット・ファイルがある場合は、ewallet.p12を指します)。cwallet.ssoを指すのは、自動ログイン・ウォレットの場合のみです。またこの場合、パスワードは''と指定する必要があります。

関連項目:

第6.9.20項「importWallet」。

8.4.4.11 Fusion Middleware Controlを使用したウォレットの削除

次の手順を実行して、ウォレットを削除します。

1. コンポーネント・インスタンスの「ウォレット」ページにナビゲートします。Fusion Middleware Controlのウォレット管理ページへのアクセスに関する項を参照してください。

2. 目的のウォレットに対応する行を選択します。

3. 「削除」をクリックします。
図ks19.gifの説明

4. このウォレットは削除され、ウォレットのリストに表示されなくなります。

8.4.4.12 WLSTを使用したウォレットの削除

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用してウォレットを削除します。

deleteWallet('inst1', 'oid1', 'oid', 'selfsigned')

関連項目:

第6.9.9項「deleteWallet」。

8.4.5 証明書のライフサイクルの管理

完全な証明書のライフサイクルは、ウォレットの作成から始まり、次のような処理が含まれます。

1. 空のウォレット(証明書リクエストが格納されていないウォレット)を作成します。

2. 証明書リクエストをウォレットに追加します。

3. 証明書リクエストをエクスポートします。

4. 証明書リクエストを使用して、対応する証明書を取得します。

5. 信頼できる証明書をインポートします。

6. 証明書をインポートします。

これらの手順は、サード・パーティの信頼できる証明書を含むウォレットの生成に必要です。このタスクの詳細は、Fusion Middleware Controlを使用したサード・パーティ証明書への自己署名証明書の変換に関する項を参照してください。

関連項目:

第8.4.6項「Fusion Middleware Controlのウォレットの証明書管理ページへのアクセス」

8.4.6 Fusion Middleware Controlのウォレットの証明書管理ページへのアクセス

Oracleウォレットは、使用先のコンポーネントに関連付けられます。

コンポーネント・インスタンスを探す手順は次のとおりです。

1. 管理者の資格証明を使用してFusion Middleware Controlにログインします。

2. 目的のドメインを選択します。

注意:

「設定」を使用すると、作業対象の特定のOracle WebLogic Serverドメインを見つけることができます。

3. ナビゲーション・ペインを使用して、ウォレットを使用するインスタンス(Oracle HTTP Serverインスタンスなど)を探します。注意: 後続の手順が機能するように、Oracle HTTP Serverが実行中である必要があります。

- ナビゲーション・ペインを使用して、ウォレットを使用するインスタンス(Oracle HTTP Serverインスタンスなど)を探します。注意: 後続の手順が機能するように、Oracle HTTP Serverが実行中である必要があります。

コンポーネント・インスタンスを見つけた後、Fusion Middleware Controlのウォレットの証明書管理ページにアクセスするには、次の2つの方法があります。

- 「ウォレット」ページに移動し、目的のウォレットの行を選択して、「管理」をクリックします。

- 「ウォレット」ページに移動し、目的のウォレットを見つけて、ウォレット名をクリックします。

証明書管理ページでは、次の処理を実行できます。

- 証明書リクエストの追加

- 証明書リクエスト、証明書または信頼できる証明書のエクスポート

- 証明書または信頼できる証明書のインポート

- 証明書リクエスト、証明書または信頼できる証明書の削除

8.4.7 一般的な証明書の操作

この項では、次のような一般的な証明書の操作について説明します。

- Fusion Middleware Controlを使用した証明書リクエストの追加

- WLSTを使用した証明書リクエストの追加

- Fusion Middleware Controlを使用した証明書、証明書リクエストまたは信頼できる証明書のエクスポート

- WLSTを使用した証明書、証明書リクエストまたは信頼できる証明書のエクスポート

- Fusion Middleware Controlを使用した証明書または信頼できる証明書のインポート

- WLSTを使用した証明書または信頼できる証明書のインポート

- Fusion Middleware Controlを使用した証明書リクエスト、証明書または信頼できる証明書の削除

- WLSTを使用した証明書リクエスト、証明書または信頼できる証明書の削除

- Fusion Middleware Controlを使用したサード・パーティ証明書への自己署名証明書の変換

- WLSTを使用したサード・パーティ証明書への自己署名証明書の変換

8.4.7.1 Fusion Middleware Controlを使用した証明書リクエストの追加

ウォレットを作成するときに証明書リクエストを追加できますが、そのときに追加していない場合は、次の手順を使用して追加できます。

1. 証明書管理ページにナビゲートします。Fusion Middleware Controlのウォレットの証明書管理ページへのアクセスに関する項を参照してください。

2. 「証明書リクエストの追加」をクリックします。

3. CRのDN値を入力するダイアログ・ボックスが表示されます。
図cer2.gifの説明

アスタリスク(*)のマークが付いたフィールドは必須です。注意: 共通名は、クライアントがコンポーネントへのアクセスに使用するホスト名である必要があります。

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

5. 新しいCRが生成されて、ダイアログ・ボックスが開き、テキスト・ボックスにそのCRが表示されます。次のいずれかを実行できます。

- Base64でエンコードされた証明書リクエストをコピーしてファイルに貼り付けます。

- 「証明書リクエストのエクスポート」ボタンを使用して、ファイルに直接エクスポートします。

図cer3.gifの説明

8.4.7.2 WLSTを使用した証明書リクエストの追加

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用してウォレットの証明書リクエストを追加します。

addCertificateRequest('inst1', 'oid1', 'oid', 'selfsigned', 'password', 'subject_dn', 'key_size')

passwordはこのウォレットのパスワード、subject_dnは証明書リクエストを生成する際に使用される識別名、key_sizeはキー・サイズ(ビット単位)です。

関連項目:

第6.9.1項

8.4.7.3 Fusion Middleware Controlを使用した証明書、証明書リクエストまたは信頼できる証明書のエクスポート

次の手順を実行して、証明書、証明書リクエスト(CR)または信頼できる証明書をエクスポートします。

1. 証明書管理ページにナビゲートします。Fusion Middleware Controlのウォレットの証明書管理ページへのアクセスに関する項を参照してください。

2. 証明書、CRまたは信頼できる証明書を選択して、「エクスポート」をクリックします。

3. ダイアログ・ボックスが開き、証明書、CRまたは信頼できる証明書がテキスト・ボックスに表示されます。次のいずれかを実行できます。

- Base64でエンコードされた証明書をコピーしてファイルに貼り付けます。

- 「証明書のエクスポート」または「信頼できる証明書のエクスポート」ボタンを使用して、ファイルに直接エクスポートします。

8.4.7.4 WLSTを使用した証明書、証明書リクエストまたは信頼できる証明書のエクスポート

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用して証明書リクエストをエクスポートします。

exportWalletObject('inst1', 'oid1', 'oid', 'selfsigned', 'password', 'CertificateRequest', '/tmp', 'subject_dn')

passwordはこのウォレットのパスワード、/tmpはBASE64形式で証明書リクエストがエクスポートされるファイルbase64.txtを含むディレクトリのパス、subject_dnはエクスポートされる証明書リクエストの識別名です。

証明書または信頼できる証明書をエクスポートするには、前述のコマンドの中のCertificateRequestをCertificateまたはTrustedCertificateに置き換えます。

関連項目:

第6.9.13項

8.4.7.5 Fusion Middleware Controlを使用した証明書または信頼できる証明書のインポート

注意:

DERでエンコードされた証明書または信頼できる証明書をOracleウォレットにインポートするには、Fusion Middleware Controlは使用できません。かわりに、次のツールのいずれかを使用します。

- Oracle Wallet Manager(第8.1.2.4項を参照)または

- orapkiコマンドライン・ツールまたは

- keytool(第8.1.2.1項を参照)

次の手順を実行して、証明書または信頼できる証明書をインポートします。

1. 証明書管理ページにナビゲートします。Fusion Middleware Controlのウォレットの証明書管理ページへのアクセスに関する項を参照してください。

2. 「インポート」をクリックします。

3. 「証明書のインポート」ダイアログで、証明書または信頼できる証明書のいずれかを選択できます。

4. インポートには、次の2つの方法があります。

- Base64でエンコードされた証明書または信頼できる証明書をテキスト・ボックスに貼り付けます。

- ファイル・セレクタを使用してファイル・システムを参照し、Base64でエンコードされた証明書または信頼できる証明書を含むファイルを見つけます。

図cer4.gifの説明

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

8.4.7.6 WLSTを使用した証明書または信頼できる証明書のインポート

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

注意:

DERでエンコードされた証明書または信頼できる証明書をOracleウォレットにインポートするには、WLSTコマンドライン・ツールは使用できません。かわりに、次のツールのいずれかを使用します。

- Oracle Wallet Manager(第8.1.2.4項を参照)または

- orapkiコマンドライン・ツール(付録Hを参照)または

- keytool(第8.1.2.1項を参照)

インスタンス名をinst1とすると、次のコマンドを使用してウォレットに証明書をインポートします。

importWalletObject('inst1', 'oid1', 'oid', 'selfsigned', 'password', 'Certificate', '/tmp/cert.txt')

passwordはこのウォレットのパスワードで、/tmp/cert.txtはBASE64でエンコードされた証明書を含むファイルです。

信頼できる証明書をインポートするには、前述のコマンドの中のCertificateをTrustedCertificateに置き換えます。

関連項目:

第6.9.21項

8.4.7.7 Fusion Middleware Controlを使用した証明書リクエスト、証明書または信頼できる証明書の削除

次の手順を実行して、CR、証明書または信頼できる証明書を削除します。

1. 証明書管理ページにナビゲートします。Fusion Middleware Controlのウォレットの証明書管理ページへのアクセスに関する項を参照してください。

2. 証明書リクエスト、証明書または信頼できる証明書を含む行を選択します。

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

4. 確認を求めるダイアログ・ボックスが表示されます。
図cer5.gifの説明

5. 「はい」をクリックします。

6. そのオブジェクトは「証明書の管理」リストに表示されなくなります。

8.4.7.8 WLSTを使用した証明書リクエスト、証明書または信頼できる証明書の削除

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

インスタンス名をinst1とすると、次のコマンドを使用して証明書を削除します。

removeWalletObject('inst1', 'oid1', 'oid', 'selfsigned', 'password', 'Certificate', 'subject_dn')

passwordはこのウォレットのパスワードで、subject_dnは削除する証明書の識別名です。

証明書リクエストまたは信頼できる証明書を削除するには、前述のコマンドの中のCertificateをCertificateRequestまたはTrustedCertificateに置き換えます。

関連項目:

第6.9項

8.4.7.9 Fusion Middleware Controlを使用したサード・パーティ証明書への自己署名証明書の変換

ウォレットに存在する自己署名証明書は、認証局(CA)で署名されたサード・パーティ証明書に変換できます。次の手順を実行して、このタスクを実行します。

注意:

この手順はOracle Internet Directoryで使用するものですが、Oracle HTTP ServerおよびOracle Web Cacheで使用するウォレットの生成にも同様の手順を適用できます。

1. ナビゲーション・ペインからコンポーネント・インスタンスを見つけます。

2. 「component_name」→「セキュリティ」→「ウォレット」にナビゲートします。

3. ウォレットのリストから自己署名証明書が格納されているウォレットを選択します。

4. 「証明書の管理」ページが表示されます。ウォレット内の証明書の一覧が含まれます。

5. 変換対象の自己署名証明書用に新しい証明書リクエストを生成する必要があります。自己署名証明書を選択して、「証明書リクエストの追加」をクリックします。ダイアログ・ボックスが表示されます。
図cer2.gifの説明

注意:

ここに入力する共通名は、クライアントが接続するサーバーのホスト名と一致する必要があります。これにより、第8.4.8.2項で説明されている問題を回避できます。

6. 証明書リクエスト(CR)の詳細を入力して、「OK」をクリックします。
CRが生成されます。次のいずれかを実行できます。

- Base64でエンコードされた証明書リクエストをコピーしてファイルに貼り付けます。

- 「証明書リクエストのエクスポート」ボタンを使用して、ファイルに直接エクスポートします。

7. 証明書リクエスト・ファイルを認証局に送信して、証明書を生成します。これは、証明書取得のローカル・ポリシーに従って実行できるオフラインの手順です。

8. CAは証明書リクエストに署名して、証明書を生成します。CAは、次のいずれかを返送します。

- 1個のファイル。新しく生成された証明書と独自のCA証明書の両方がpkcs7形式で含まれます。

- 一方には新しく生成された証明書、もう一方には独自のCA証明書(チェーンがある場合は複数のCA証明書)が含まれた2個のファイル。

9. 「インポート」を使用して、これらのファイルをウォレットにインポートします。

- CAから1個のファイルを受信した場合は、置き換える自己署名証明書の別名(ステップ3を参照)と一致する別名を使用して、信頼できる証明書としてインポートします。

- 2個のファイルを受信した場合は、次の手順を実行します。

- CA証明書が含まれるファイルを信頼できる証明書としてインポートします(ウォレット内で一意の別名を使用)。

- 証明書ファイルを証明書としてインポートします(置き換える自己署名証明書の別名と一致する別名を使用)。

注意:

順序は重要です。信頼できる証明書、証明書の順にインポートする必要があります。

CAから1個のファイルが返され、これを信頼できる証明書としてインポートします。

図cer4.gifの説明

10. インポート後に、CAが発行した証明書で自己署名証明書が置き換えられます。

8.4.7.10 WLSTを使用したサード・パーティ証明書への自己署名証明書の変換

関連項目:

WLSTの起動および使用方法の詳細は、第8.2項を参照してください。

関連項目:

第6.9項

次の手順を実行し、WLSTを使用して自己署名証明書をサード・パーティ証明書に変換します。

1. 証明書リクエストを追加します。たとえば、次のように指定します。

addCertificateRequest('inst1', 'oid1', 'oid', 'selfsigned', 'password', 'subject_dn', 'key_size')

2. 証明書リクエストをエクスポートします。

exportWalletObject('inst1', 'oid1', 'oid', 'selfsigned', 'password', 'CertificateRequest', '/tmp', 'subject_dn')

3. 証明書リクエスト/tmp/base64.txtを認証局に送信します。CAは、PKCS#7形式の1つのファイルまたは2つの別々のファイルとして、新しく生成された証明書と独自の証明書を返送します。

4. CAから1個のファイルを受信した場合は、次のコマンドを実行します。

importWalletObject('inst1', 'oid1', 'oid', 'selfsigned', 'password', 'TrustedChain', '/tmp/cert.txt')

passwordはこのウォレットのパスワード、/tmp/cert.txtはCAから返され、BASE64でエンコードされたPKCS#7を含むファイルです。

CAから2個のファイルを受信した場合は、信頼できる証明書としてCA証明書を最初にインポートし、次に新しく生成された証明書をインポートします。

importWalletObject('inst1', 'oid1', 'oid', 'selfsigned', 'password', 'TrustedCertificate', '/tmp/cacert.txt')

importWalletObject('inst1', 'oid1', 'oid', 'selfsigned', 'password', 'Certificate', '/tmp/cert.txt')

passwordはこのウォレットのパスワード、/tmp/cert.txtはCAから返され、BASE64でエンコードされた証明書を含むファイル、/tmp/cacert.txtはBASE64でエンコードされたCA証明書を含むファイルです。

8.4.8 ウォレットおよび証明書の保守

この項は次の管理に関する項目で構成されています。

- ウォレットの場所

- ホスト名変更のウォレットへの影響

- 自己署名付きウォレットのサード・パーティのウォレットへの変更

- ウォレット内の期限が切れそうな証明書の置換え

8.4.8.1 ウォレットの場所

この項では、様々なコンポーネントのウォレットの場所について説明します。

Oracle Internet Directoryウォレットのルート・ディレクトリ

ウォレットのルート・ディレクトリは、$ORACLE_INSTANCE/OID/adminです。

このルート・ディレクトリには、ウォレットの名前がついたサブディレクトリが入ります。それぞれのサブディレクトリには実際のウォレット・ファイルが格納されます。

たとえば、oid1およびoid2という名前の2つのウォレットがあり、oid1はパスワードで保護されたウォレットで、oid2は自動ログインのみのウォレットであるとします。サンプルの構造は、次のようになります。

$ORACLE_INSTANCE/OID/admin/oid1/cwallet.sso
$ORACLE_INSTANCE/OID/admin/oid1/ewallet.p12
$ORACLE_INSTANCE/OID/admin/oid2/cwallet.sso

Oracle HTTP Serverウォレットのルート・ディレクトリ

ウォレットのルート・ディレクトリは、$ORACLE_INSTANCE/config/OHS/ohs_instance_name/keystoresです。

このルート・ディレクトリには、ウォレットの名前がついたサブディレクトリが入ります。それぞれのサブディレクトリには実際のウォレット・ファイルが格納されます。

たとえば、ohs1およびohs2という名前の2つのウォレットがあり、ohs1はパスワードで保護されたウォレットで、ohs2は自動ログインのみのウォレットであるとします。サンプルの構造は、次のようになります。

$ORACLE_INSTANCE/config/OHS/ohs_instance1/keystores/ohs1/cwallet.sso
$ORACLE_INSTANCE/config/OHS/ohs_instance1/keystores/ohs1/ewallet.p12
$ORACLE_INSTANCE/config/OHS/ohs_instance1/keystores/ohs2/cwallet.sso

Oracle Web Cacheウォレットのルート・ディレクトリ

ウォレットのルート・ディレクトリは、$ORACLE_INSTANCE/config/WebCache/webcache_instance_name/keystoresです。

このルート・ディレクトリには、ウォレットの名前がついたサブディレクトリが入ります。それぞれのサブディレクトリには実際のウォレット・ファイルが格納されます。

たとえば、wc1およびwc2という名前の2つのウォレットがあり、wc1はパスワードで保護されたウォレットで、wc2は自動ログインのみのウォレットであるとします。サンプルの構造は、次のようになります。

$ORACLE_INSTANCE/config/WebCache/webcache_instance1/keystores/wc1/cwallet.sso
$ORACLE_INSTANCE/config/WebCache/webcache_instance1/keystores/wc1/ewallet.p12
$ORACLE_INSTANCE/config/WebCache/webcache_instance1/keystores/wc2/cwallet.sso

8.4.8.2 ホスト名変更のウォレットへの影響

一般的には、ウォレットのDNはウォレットが使用されるサーバーのホスト名に基づいています。

たとえば、ウォレットがOracle HTTP Serverのmy.example.comで作成されている場合、このOracle HTTP Serverウォレットの証明書のDNは「CN=my.example.com,O=organization name」のようになります。

ほとんどのクライアントはSSLハンドシェイク時にホスト名を検証するため、この同期は必須です。

ホスト名の検証を実行するクライアントには、WebブラウザやOracle HTTPClientなどがあります。サーバーのホスト名が証明書のDNと一致しない場合、次のように処理されます。

- 明確な警告が表示されます(ブラウザ・クライアントの場合)。

- SSLハンドシェイクが失敗する場合があります(その他のクライアントの場合)。

クライアントからリクエストを受信しているサーバー上にウォレットがある場合、このサーバーのホスト名が変更されるたびに、ウォレット内の証明書も更新する必要があります。

これは、新しいDN(新しいホスト名に基づく)で新しい証明書をリクエストすることで実行できます。

本番のウォレットの場合

手順は次のとおりです。

- 新しいDN(新しいホスト名に基づく)で新しいリクエストを生成します。

- このリクエストを認証局(CA)に送信します。

- CAから新しい証明書が返送されます。

- ウォレットから古い証明書および証明書リクエストを削除します。

- 新しい証明書をインポートします。

これらの操作の詳細は、第8.4.4項を参照してください。

自己署名付きウォレットの場合

手順は次のとおりです。

- 既存のウォレットを削除します。

- 新しいDN(新しいホスト名に基づく)を使用して自己署名証明書を含む新しいウォレットを作成します。

これらの操作の詳細は、第8.4.4項を参照してください。

本番ウォレットの場合も自己署名付きウォレットの場合も、新しい証明書がウォレットで使用可能になったら、その証明書を信頼する必要があるすべてのコンポーネントのウォレットに確実にインポートする必要があります。たとえば、Oracle WebLogic ServerでSSLが有効な場合、ホスト名の変更によってOracle WebLogic Serverの証明書が変更されたら、新しい証明書をOracle HTTP Serverウォレットにインポートして、新しいピアを信頼できるようにする必要があります。

8.4.8.3 自己署名付きウォレットのサード・パーティのウォレットへの変更

自己署名付きウォレットをサード・パーティのウォレットに変換できます。サード・パーティのウォレットには、信頼できる認証局(CA)が署名した証明書が含まれます。

「CN=my.example.com,O=example」というDNの証明書が格納された、MYWalletという自己署名付きウォレットがあるとすると、次の手順を実行して、これをサード・パーティのウォレットに変換します。

1. ウォレットからユーザー証明書「CN=my.example.com,O=example」を削除します。

2. ウォレットから信頼できる証明書「CN=my.example.com,O=example」を削除します(これは、ユーザー証明書と同じDNですが、別のエンティティです)。

3. ウォレットから証明書リクエスト「CN=my.example.com,O=example」をエクスポートして、ファイルに保存します。

4. この証明書リクエスト・ファイルをVeriSignなどのサード・パーティの認証局(CA)に送信します。

5. CAは、次のいずれかを返送します。

- ユーザー証明書ファイルと独自の証明書ファイル

- ユーザー証明書と独自の証明書で構成された証明連鎖を含む単一のファイル

6. これらのファイルをウォレットにインポートします。

これらの操作の詳細は、第8.4.4項を参照してください。

8.4.8.4 ウォレット内の期限が切れそうな証明書の置換え

期限が切れそうな証明書は、実際に期限が切れる前に置き換えて、アプリケーションの停止時間を回避または短縮する必要があります。

期限が切れそうな証明書を置き換える手順は次のとおりです。

1. ウォレットから証明書リクエストをエクスポートします(これは、現在期限が切れそうな証明書の発行時と同じリクエストです)。

2. 証明書発行のために、この証明書リクエストをサード・パーティの認証局(CA)に送信します。新しい証明書の発効日は、現在の証明書の失効日より早くしてください。停止時間を短縮するために、このような重複期間を設けることをお薦めします。

注意:

サード・パーティのCAがすでにリポジトリの証明書リクエストを保守している場合、ステップ1と2は不要です。その場合は、単純にその証明書リクエストの新しい証明書の発行をCAにリクエストします。

3. ウォレットから既存の証明書(期限が切れそうな証明書)を削除します。

4. 新しく発行された証明書をウォレットにインポートします。
停止時間を短縮するために、新しい証明書が有効になり古い証明書が失効していない重複期間に、前の証明書を削除して新しい証明書をインポートします。

5. 新しい証明書が元の証明書の発行元以外のCAで発行された場合は、新しく発行された証明書をインポートする前に、新しいCAの信頼できる証明書をインポートする必要があります。

これらの操作の詳細は、第8.4.4項を参照してください。

第IV部

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

この部では、デプロイ・プロセス、Oracle Fusion Middlewareにアプリケーションをデプロイする方法について説明します。

第IV部は、次の章で構成されています。

- 第9章「デプロイ・プロセスの概要」

- 第10章「アプリケーションのデプロイ」

9 デプロイ・プロセスの概要

Oracle Fusion Middlewareアプリケーション(Java EEアプリケーションまたはSOA Compositeアプリケーションなど)をデプロイする前に、デプロイ・プロセス(アプリケーションの設計および開発、これらのアプリケーションの管理対象サーバーへのデプロイなど)を理解する必要があります。

この章の項目は次のとおりです。

- デプロイヤとは

- アプリケーション設計から本番デプロイへの一般的な移行手順

- 一般的な問題の診断

9.1 デプロイヤとは

デプロイヤは、Java EEアプリケーション、ADFアプリケーション、SOAコンポジット・アプリケーション、WebCenter Portalアプリケーションなどのアプリケーションを、WebLogic Serverのインスタンスまたはクラスタにデプロイする作業を担当します。

デプロイヤとして作業するユーザーには、Oracle WebLogic Serverのデプロイヤ・セキュリティ・ロールを付与する必要があります。デプロイヤ・セキュリティ・ロールが付与されていると、デプロイ操作の他に、サーバー構成の表示や起動クラスと停止クラスの変更などが可能になります。このロールをユーザーに付与するには、Oracle WebLogic Server管理コンソールを使用します。詳細は、Oracle WebLogic Server管理コンソールのヘルプの、セキュリティ・ロールの管理に関する項を参照してください。

9.2 アプリケーション設計から本番デプロイへの一般的な移行手順

この項では、アプリケーションの設計および開発から本番環境へのデプロイに移行する際の一般的な手順について説明します。次の項目が含まれます。

- アプリケーションの設計および開発

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

- 他の環境へのアプリケーションの移行の自動化

9.2.1 アプリケーションの設計および開発

多くの場合、開発者はアプリケーションの作成にOracle JDeveloperを使用します。Oracle JDeveloperは、Java、XML、Webサービス、ポートレット、SQLの最新業界標準を使用してサービス指向アプリケーションを構築するための統合開発環境(IDE)です。JDeveloperは、アプリケーションのモデリング、コーディング、デバッグ、テスト、プロファイル、チューニング、デプロイの各機能が統合されており、ソフトウェア開発のライフサイクル全体をサポートしています。

この環境では、統合型のOracle WebLogic Serverを使用します。これは、アプリケーションのテストを目的として、Oracle JDeveloperとともにパッケージ化されています。

アプリケーションのデプロイの詳細は、次を参照してください。

- 『Oracle Fusion Middleware Oracle WebLogic Serverアプリケーションの開発』

- 『Oracle Fusion Middleware Oracle Application Development FrameworkのためのFusion開発者ガイド』

- Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド

- 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』

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

統合型のOracle WebLogic Serverで設計とテストの済んだアプリケーションは、管理対象サーバー・インスタンスにデプロイできます。たとえば、本番環境にOracle WebLogic Serverをインストールして、管理対象サーバーを含めたドメインを構成し、その管理対象サーバーにアプリケーションをデプロイするとします。

次の各ドキュメントでは、様々なタイプのアプリケーションのデプロイについて具体的な情報が記述されています。

- Java EEアプリケーションについては、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』を参照してください。

- Oracle ADFについては、Oracle Fusion Middleware Oracle Application Development Framework管理者ガイドを参照してください。

- Oracle WebCenter Portalについては、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』を参照してください。

- Oracle SOA Suiteについては、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』を参照してください。

この項では、統合型のOracle WebLogic Serverからデプロイ環境とは別の環境にアプリケーションを移行する場合に必要な、主な手順の概要について説明します。一般的な手順は次のとおりです。

1. アプリケーションをパッケージ化します。Java EE、ADFおよびWebCenter Portalアプリケーションでは、アプリケーションをEARファイルにパッケージ化します。Oracle SOA Suiteでは、アプリケーションをJARまたはZIPファイルにパッケージ化します。
アプリケーションのパッケージ化の詳細は、次を参照してください。

- Java EEアプリケーション: 『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』のデプロイのためのアプリケーションおよびモジュールの準備に関する説明

- Oracle ADF: Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイドのEARファイルおよびパッケージ化に関して知っている必要があることに関する項

- Oracle WebCenter Portal: Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイドのWebCenter Portalアプリケーションのパッケージ化に関する説明

- Oracle SOA Suite: 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のパッケージ化の影響の理解に関する項

2. 環境を設定します。次のものが含まれます。

- ドメイン、およびその正しいドメイン・テンプレートで構成された管理対象サーバーのインストールおよび構成。たとえば、Oracle SOA Suiteアプリケーションをデプロイする場合、管理対象サーバーではOracle SOA Suiteドメイン・テンプレートを使用する必要があります。構成ウィザードを使用してドメインを作成すると、適切なドメイン・テンプレートが適用されます。また、第19.2項で説明するように、ドメインを拡張して別のドメイン・テンプレートを使用することもできます。
具体的なコンポーネントのインストールおよび構成の詳細は、次を参照してください。

- Oracle ADF:『Oracle Fusion Middleware Oracle Application Development Framework管理者ガイド』のADF RuntimeをWebLogicインストレーションにインストールする方法に関する項

- Oracle WebCenter Portal: Oracle Fusion Middleware Oracle WebCenter Portalインストレーション・ガイドのOracle WebCenter Portalのインストールに関する説明およびOracle WebCenter Portalの構成に関する説明

- Oracle SOA Suite: 『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suiteインストレーション・ガイド』のOracle SOA SuiteおよびOracle Business Process Management Suiteのインストールに関する説明およびOracle SOA SuiteおよびOracle Business Process Management Suiteの構成に関する説明

- 必要なすべてのスキーマの既存のデータベースでの作成。『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

- Oracle WebLogic ServerドメインへのMDSリポジトリの登録(アプリケーションでMDSリポジトリを使用する場合)。たとえば、Oracle SOA SuiteとOracle WebCenter Portalの各アプリケーションにはMDSが必要です。一部のADFアプリケーションでは、MDSを使用してカスタマイズを行います。MDSリポジトリの登録の詳細は、第14.3.2.1.1項を参照してください。

3. アプリケーションでデータベースを使用する場合は、JDBCデータソースを設定します。

JDBCデータソースの設定の詳細は、次を参照してください。

- ピュアJava EEアプリケーション: 『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』

- Oracle ADF:『Oracle Fusion Middleware Oracle Application Development Framework管理者ガイド』のOracle WebLogic ServerにJDBCデータソースを作成する方法に関する項

- Oracle WebCenter Portal: 『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のデータソースの選択に関する説明

- Oracle SOA Suite: 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のデータソースおよびキューの作成に関する項

4. Oracle SOA Suiteの場合、接続ファクトリおよび接続プールを作成します。詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の接続ファクトリおよび接続プールの作成に関する項を参照してください。

5. ターゲットとなる管理対象サーバーへの接続を作成します。

Oracle JDeveloperから、JDeveloperの外部にある管理対象サーバー・インスタンスにアプリケーションをデプロイできます。そのためには、まずアプリケーションのデプロイ先となるサーバー・インスタンスへの接続を作成する必要があります。

詳細は、次を参照してください。

- Oracle ADF: Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイドのターゲットのアプリケーション・サーバーへの接続を作成する方法に関する項

- Oracle WebCenter Portal: Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイドのWebLogic管理対象サーバー接続の作成に関する説明

- Oracle SOA Suite: 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のアプリケーション・サーバー接続の作成に関する項

6. Oracle SOA Suiteの場合、SOAコンポジット・アプリケーションが他のコンポジットとメタデータを共有している場合、SOA-MDS接続を作成します。『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のSOA-MDS接続の作成に関する項を参照してください。

7. JDBC接続文字列や各種サーバーのホスト名など、環境に固有の値の情報を含む構成プランまたはデプロイ・プランを作成します。詳細は、次を参照してください。

- ピュアJava EEアプリケーション: 『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』の新しいデプロイ・プランの作成によるアプリケーションの構成に関する項

- Oracle SOA Suite: 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の構成プランの概要に関する項

8. 資格証明、アイデンティティ、ポリシーなどのアプリケーション・セキュリティを移行します。詳細は、次を参照してください。

- ピュアJava EEアプリケーション:『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のセキュリティ・データの移行に関する項

- Oracle ADF: Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイドのデプロイメントのためのセキュア・アプリケーションの準備に関する項

- Oracle WebCenter Portal: 『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のWebCenter Portalアプリケーション・セキュリティの管理に関する説明

- Oracle SOA Suite: 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のセキュリティの有効化に関する項

9. デプロイメント・プロファイルを作成します。デプロイメント・プロファイルは、カスタムADF、WebCenter Portal、SOAの各アプリケーションおよび関連付けられたファイルをパッケージ化またはアーカイブして、Oracle WebLogic Server管理対象サーバー・インスタンスにアプリケーションをデプロイできるようにします。デプロイ・プロファイルは、プロジェクト・レベルおよびアプリケーション・レベルで作成されます。
詳細は、次を参照してください。

- Oracle ADF: Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイドのデプロイメント・プロファイルの作成方法に関する項

- Oracle WebCenter Portal: Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイドのデプロイメント・プロファイルの作成に関する説明

- Oracle SOA Suite: 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のプロジェクト・デプロイメント・プロファイルの作成(オプション)に関する項

10. Oracle SOA SuiteおよびOracle WebCenter Portal用のOracle JDeveloperの拡張機能を移行します。表9-1に、拡張機能とそれを説明しているドキュメントを示します。

表9-1 Oracle JDeveloperの拡張機能

コンポーネント

拡張機能

参照先

Oracle WebCenter Portal

WebCenter Portalの拡張機能

Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイドのWebLogic管理対象サーバー・インスタンスの作成とプロビジョニングに関する説明

Oracle SOA Suite

SOAの拡張機能

『Oracle Fusion Middleware Oracle JDeveloperインストレーション・ガイド』のOracle Fusion Middlewareのデザインタイム・コンポーネントの追加インストールに関する項

11. アプリケーションを管理対象サーバーにデプロイします。
詳細は、次を参照してください。

- ピュアJava EEアプリケーション: 『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』のデプロイメント用アプリケーションの新しい環境へのエクスポートに関する項

- Oracle ADF: Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイドのアプリケーションのデプロイに関する項

- Oracle WebCenter Portal: 『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のWebLogic管理対象サーバーに対するアプリケーションのデプロイに関する説明

- Oracle SOA Suite: 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のSOAコンポジット・アプリケーションのデプロイに関する項

9.2.3 他の環境へのアプリケーションの移行の自動化

アプリケーションの移行は、WLSTスクリプトまたはantスクリプトを使用して自動化できます。これにより、複数の環境または管理対象サーバーへのアプリケーションのデプロイ、および更新されたバージョンのアプリケーションのデプロイが容易になります。

スクリプトの使用によってアプリケーションを他の環境に移行する操作の詳細は、次を参照してください。

- ピュアJava EEアプリケーション:『Oracle Fusion Middleware Oracle WebLogic Scripting Tool』のWebLogic Scripting Toolの使用に関する項

- Oracle ADF: Oracle Fusion Middleware Oracle Application Development Framework管理者ガイドのスクリプトおよびAntを使用したデプロイに関する項

- Oracle WebCenter Portal: Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイドのWebLogic管理対象サーバー・インスタンスの作成とプロビジョニングに関する説明

- Oracle SOA Suite: 『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の次の項を参照してください。

- スクリプトを使用したSOAコンポジット・アプリケーションの管理に関する項

- antスクリプトを使用したSOAコンポジット・アプリケーションの管理に関する項

9.3 一般的な問題の診断

次に、アプリケーションを管理対象サーバーにデプロイする際に直面する可能性のある一般的な問題についていくつか説明します。

- 接続情報。ターゲットとなる管理対象サーバーへの接続を正しく構成していることを確認します。第9.2.2項のステップ4、5および6を参照してください。

- Oracle JDeveloperの拡張機能。Oracle JDeveloperの任意の拡張機能を移行していることを確認します。表9-1を参照してください。

- データソース。JDBCデータソースを正しく構成していることを確認します。第9.2.2項のステップ3を参照してください。

- セキュリティ構成。資格証明、アイデンティティ、ポリシーなどのアプリケーション・セキュリティを移行していることを確認します。第9.2.2項のステップ8を参照してください。

また、SOAアプリケーションのトラブルシューティングの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の一般的なデプロイ・エラーのトラブルシューティングに関する項を参照してください。

10 アプリケーションのデプロイ

デプロイとは、アプリケーションのファイルをアーカイブ・ファイルとしてパッケージ化し、ターゲットのアプリケーション・サーバーに転送するプロセスです。この章では、Java EEやSOAなどのアプリケーションをOracle Fusion Middlewareにデプロイする方法を説明します。

次の項目が含まれます。

- アプリケーションのデプロイの概要

- データソースの概要と管理

- Java EEアプリケーションのデプロイ、アンデプロイおよび再デプロイ

- Oracle ADFアプリケーションのデプロイ、アンデプロイおよび再デプロイ

- SOAコンポジット・アプリケーションのデプロイ、アンデプロイおよび再デプロイ

- WebCenter Portalアプリケーションのデプロイ、アンデプロイおよび再デプロイ

- デプロイ・プランの管理

- Fusion Middleware Controlでの一般的なデプロイ・タスクについて

- デプロイされたアプリケーションでのMDS構成属性の変更

10.1 アプリケーションのデプロイの概要

Oracle WebLogic Serverには、Java EEに準拠したインフラストラクチャが用意されており、Java EEに準拠したアプリケーションやモジュールのデプロイ、アンデプロイおよび再デプロイが可能です。

次の項目について説明します。

- デプロイ可能なアプリケーションのタイプ

- デプロイ、再デプロイおよびアンデプロイの概要

10.1.1 デプロイ可能なアプリケーションのタイプ

Oracle WebLogic Serverにデプロイできるコンポーネントは次のとおりです。

- Enterprise Archive(EAR)ファイルとしてパッケージ化された完全なJava EEアプリケーション。

- Webサービス、Enterprise JavaBeans(EJB)、アプリケーション・クライアント(CAR)またはリソース・アダプタ(RAR)を含む、Java Archive(JAR)ファイルとしてパッケージ化されたスタンドアロン・モジュール。

- ADFアプリケーション。Oracle Application Development Framework(Oracle ADF)は、Java Platform、Enterprise Edition(Java EE)標準やオープンソース・テクノロジに基づいて、サービス指向アプリケーションの実装を簡略化および高速化するエンドツーエンド・アプリケーション・フレームワークです。

- Oracle SOA Suiteコンポジット・アプリケーション。SOAコンポジット・アプリケーションは単一のデプロイ単位で、SOAアプリケーションの管理やライフサイクルを大幅に簡素化します。

- Oracle WebCenter Portalアプリケーション。WebCenter Portalアプリケーションが従来のJava EEアプリケーションと異なる点は、アプリケーションのページ、これらのページに含まれるポートレット、ドキュメント・ライブラリなどのランタイム・カスタマイズをサポートすることです。

メタデータ・アーカイブ(MAR)は、アプリケーションレベルのデプロイメント・プロファイルなど、アプリケーション用に選択されたメタデータを圧縮したアーカイブです。MARは、メタデータ・コンテンツをメタデータ・サービス(MDS)リポジトリにデプロイする際に使用します。次のアプリケーションのタイプでは、MDSリポジトリにデプロイされるコンテンツ(ADFアプリケーション、SOAコンポジット・アプリケーション、Oracle WebCenter Portalアプリケーション)のコンテナとしてMARを使用します。

注意:

アプリケーションレベルのデータソースで間接パスワードを使用している場合、Fusion Middleware Controlを使用してアプリケーションをデプロイすることはできません。Fusion Middleware Controlを使用してアプリケーションをデプロイできるように、アプリケーションの設定を変更する方法については、Oracle JDeveloperのヘルプにある、Oracle WebLogic Serverで実行されているEARファイルにアプリケーションをデプロイする方法に関する項を参照してください。

アプリケーションのデプロイ、アンデプロイ、および再デプロイには、Fusion Middleware Control、Oracle WebLogic Server管理コンソール、Oracle JDeveloper、またはコマンド・ラインを使用できます。使用する方法は、アプリケーションのタイプによって異なります(表10-1を参照)。

表10-1 アプリケーションをデプロイするツール

アプリケーションのタイプ

使用するツール

ピュアJava EEアプリケーション

Oracle WebLogic Server管理コンソール

Fusion Middleware Control: デプロイ・ウィザード

Oracle JDeveloper

WLSTコマンドライン

ADFアプリケーション

Fusion Middleware Control: デプロイ・ウィザード

Oracle JDeveloper

WLSTコマンドライン

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

Fusion Middleware Control: SOAコンポジット・デプロイ・ウィザード

Oracle JDeveloper

WLSTコマンドライン

WebCenter Portalアプリケーション

Fusion Middleware Control: デプロイ・ウィザード

Oracle JDeveloper

WLSTコマンドライン

アプリケーションでMDSリポジトリを使用している場合、アプリケーションをデプロイする前にリポジトリをOracle WebLogic Serverドメインに登録する必要があります。組織で独自に開発したカスタムJava EEアプリケーション、Oracle B2BやOracle Web Services Managerなどの一部のOracle Fusion Middlewareコンポーネント・アプリケーションなどは、MDSリポジトリを使用します。MDSリポジトリおよびリポジトリの登録の詳細は、第14.3項を参照してください。

注意:

アプリケーションにアプリケーションレベルの資格証明ストアが含まれており、アプリケーションをテスト環境から本番環境に移動する場合は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』のドメイン・ポリシー・ストアの再関連付けに関する項で説明されているように、資格証明ストアを再度関連付けする必要があります。

10.1.2 デプロイ、再デプロイおよびアンデプロイの概要

アプリケーションをデプロイする場合は、アプリケーション・サーバーに初めてデプロイします。

アプリケーションを再デプロイする場合は、次を実行できます。

- 新しいバージョンのアプリケーションの再デプロイ。以前のバージョンも引き続き使用できますが、状態は「リタイア」に設定されます。
これは、本番の再デプロイ計画と呼ばれています。Oracle WebLogic Serverでは、クライアントの接続が自動的に管理され、新しいクライアント・リクエストのみが新しいバージョンに転送されるようになります。再デプロイ時にアプリケーションに接続していたクライアントは、その処理が完了するまで古いバージョンのアプリケーションを使用し続けます。その処理が完了した時点でOracle WebLogic Serverは自動的に古いアプリケーションをリタイアさせます。

- 同じバージョンのアプリケーションの再デプロイまたはバージョンが割り当てられていないアプリケーションの再デプロイ。選択したアプリケーションのバージョンは新しいデプロイに置き換えられます。

- 以前のバージョンのアプリケーションの再デプロイ。リタイアした古いほうのバージョンは「アクティブ」に設定され、新しいほうのバージョンは「リタイア」に設定されます。

アプリケーションをアンデプロイする場合、Oracle WebLogic Serverはアプリケーションを停止して、ステージング済のファイルをターゲット・サーバーから削除します。デプロイに使用された元のソース・ファイルは削除しません。

10.2 データソースの概要と管理

次の各項では、データソースとそれらの管理方法について説明します。

- データソースの概要

- JDBCデータソースの作成と管理

10.2.1 データソースの概要

データソースは、アプリケーション・コンポーネントがリレーショナル・データベースに接続する際に使用するJavaオブジェクトです。URLやユーザー名とパスワードなどの特定の接続情報は、データソース・オブジェクトでプロパティとして設定されるため、アプリケーション・コードで明示的に定義する必要はありません。この抽象化により、アプリケーションが特定のバックエンド・データベースに関連付けらなくなるため、アプリケーションをポータブルな方法で構築できます。データベースを変更しても、アプリケーション・コードに影響はありません。

アプリケーションは、Java Naming and Directory Interface(JNDI)APIを使用してデータソース・オブジェクトにアクセスします。アプリケーションは、データソース・オブジェクトにバインドされたJNDI名を使用します。JNDI名は論理名であるため、すべてのデータソース・オブジェクトにマップできます。データソース・プロパティと同様に、データソース・オブジェクトを変更してもアプリケーション・コードを変更する必要がないため、JNDIを使用すると抽象レベルが上がります。結果として、データベースへのアクセスの詳細が、アプリケーションに対して透過的になります。

関連項目:

データソースの詳細は、『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』を参照してください。

Oracle SOA Suite、Oracle WebCenter Portalなど、特定のOracle Fusion Middlewareコンポーネントを構成する場合、Oracle WebLogic Server構成ウィザードを使用して、データソースの接続情報を指定します。コンポーネントでMDSリポジトリを使用している場合、構成ウィザードではデータソース名の先頭に「mds-」を付加して、そのデータソースがMDSリポジトリで使用されるシステム・データソースであることを示します。

関連項目:

構成ウィザードを使用してデータソースを指定する方法の詳細は、『Oracle Fusion Middleware構成ウィザードによるドメインの作成』を参照してください。

Oracle Real Application Clusters(Oracle RAC)またはOracle Fusion Middlewareのコールド・フェイルオーバー・クラスタを使用している場合、次のデータソース・タイプのいずれかを構成する必要があります。

- マルチ・データソース
マルチ・データソースを使用するには、Oracle WebLogic Server管理コンソールを使用する必要があります。複数のデータソースを作成し、それに既存のMDSデータソースを追加した場合、追加したデータソースは有効なMDSリポジトリとみなされなくなるので注意してください。リポジトリは、Fusion Middleware ControlにもOracle WebLogic Server管理コンソールにも表示されません。たとえば、MDSリポジトリはFusion Middleware Controlのナビゲーション・ペインには一覧表示されず、アプリケーションをデプロイするときにターゲットのメタデータ・リポジトリの選択肢として表示されません。

- GridLinkデータソース
GridLinkデータソースを使用するために、第10.2.2.5項の説明に従って、Oracle WebLogic Server管理コンソールまたはFusion Middleware Controlを使用できます。

関連項目:

マルチ・データソースおよびGridLinkデータソースの構成に関する詳細は、『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』を参照してください。

10.2.2 JDBCデータソースの作成と管理

JDBCデータソースの作成と管理には、次の管理ツールを使用できます。

- Oracle WebLogic Server管理コンソール

- WebLogic Scripting Tool(WLST)

- Fusion Middleware Control

MDSデータソースを手動で作成するには、Fusion Middleware ControlまたはWLSTを使用して、データソースの正しい属性を設定する必要があります。MDSデータソースは、Fusion Middleware Controlではナビゲーション・ペインに表示され、管理コンソールではドメイン構造に表示されます。アプリケーションでMDSリポジトリを使用している場合、アプリケーションをデプロイする前にリポジトリをOracle WebLogic Serverドメインに登録する必要があります。MDSリポジトリおよびリポジトリの登録の詳細は、第14.3項を参照してください。

注意:

データソースを作成する場合、リポジトリ作成ユーティリティ(RCU)で作成されたMDSスキーマを使用する必要があります。それ以外のスキーマは使用しないでください。

お薦めはできませんが、Oracle WebLogic Server管理コンソールを使用して、MDSデータソースを作成することもできます。その場合は、次の点に注意してください。

- MDSリポジトリでの使用を目的とする場合、データソース名に接頭辞として「mds-」を付ける必要があります。

- データソースの対象は、管理サーバー、およびデータソースが必要なアプリケーションをデプロイするすべての管理対象サーバーとする必要があります。

- グローバル・トランザクションをオフにする必要があります。

関連項目:

- Oracle WebLogic Server管理コンソールまたはWLSTを使用したデータソースの作成および管理の詳細は、『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』を参照してください。

- マルチ・データソースの構成に関する詳細は、『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』を参照してください。

Fusion Middleware Controlを使用したJDBCデータソースの作成および管理の詳細は、次の各項を参照してください。

- Fusion Middleware Controlを使用したJDBCデータソースの作成

- Fusion Middleware Controlを使用したJDBCデータソースの編集

- Fusion Middleware Controlを使用したJDBCデータソースの監視

- Fusion Middleware Controlを使用したJDBCデータソースの管理

- Fusion Middleware Controlを使用したGridLinkデータソースの作成

10.2.2.1 Fusion Middleware Controlを使用したJDBCデータソースの作成

Fusion Middleware Controlを使用してJDBCデータソースを作成する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメイン・ホーム・ページを表示するドメインを選択します。

3. 「WebLogicドメイン」メニューで「JDBCデータソース」を選択します。
次の図のように「JDBCデータソース」ページが表示されます。

図jdbc.gifの説明

4. 「作成」から、「汎用データ・ソース」を選択します。

5. ウィザードの指示に従って、データソースのプロパティを設定し、ドメイン内の1つ以上の管理対象サーバーのデータソースを対象に指定します。
個々のフィールドおよびプロパティに関するヘルプを表示するには、マウスを使用してフィールドをフォーカスします。Fusion Middleware Controlでは、フィールドの定義がポップアップで表示されます。

Fusion Middleware Controlで定義するデータソース・プロパティは、Oracle WebLogic Server管理コンソールでデータソースを作成するときに定義するデータソース・プロパティと似ています。このため、データソース・プロパティの詳細は、『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』のJDBCデータソースの作成に関する説明を参照することもできます。

10.2.2.2 Fusion Middleware Controlを使用したJDBCデータソースの編集

Fusion Middleware Controlを使用して既存のJDBCデータソースを編集する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメイン・ホーム・ページを表示するドメインを選択します。

3. 「WebLogicドメイン」メニューで「JDBCデータソース」を選択します。
「JDBCデータソース」ページが表示されます。

4. 編集するデータソースを選択します。

5. 「編集」をクリックして、「JDBCデータソースの編集」ページを表示します。

6. このページのタブを使用して、選択したデータソースのプロパティを変更します。
個々のフィールドおよびプロパティに関するヘルプを表示するには、マウスを使用してフィールドをフォーカスします。Fusion Middleware Controlでは、フィールドの定義がポップアップで表示されます。

Fusion Middleware Controlで編集するデータソース・プロパティは、Oracle WebLogic Server管理コンソールでデータソースを編集するときに編集するデータソース・プロパティと似ています。このため、データソース・プロパティの詳細は、『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』のJDBCデータソースの作成に関する説明を参照することもできます。

10.2.2.3 Fusion Middleware Controlを使用したJDBCデータソースの監視

Fusion Middleware Controlを使用してJDBCデータソースを監視する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメイン・ホーム・ページを表示するドメインを選択します。

3. 「WebLogicドメイン」メニューで「JDBCデータソース」を選択します。
「JDBCデータソース」ページが表示されます。

4. 監視するデータソースを選択します。

5. 「監視」をクリックして、「JDBCデータソースの監視」ページを表示します。
このページには、選択したデータソースの現在のインスタンスが表示されます。

このページに表示されるのは、実行中の管理対象サーバーを対象にしたデータソースのみです。監視ページに特定のデータソースが表示されていない場合は、データソースを編集して、実行中の管理対象サーバーを対象にするようにします。

6. データソースのインスタンスごとに、パフォーマンス・メトリックを確認します。
個々のパフォーマンス・メトリックに関するヘルプを参照する方法は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のFusion Middleware Controlを使用したパフォーマンス・メトリックの表示に関する項を参照してください。

10.2.2.4 Fusion Middleware Controlを使用したJDBCデータソースの管理

Fusion Middleware Controlを使用して、JDBCデータソースの文キャッシュを開始、停止、中断、再開またはクリアするには:

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメイン・ホーム・ページを表示するドメインを選択します。

3. 「WebLogicドメイン」メニューで「JDBCデータソース」を選択します。
「JDBCデータソース」ページが表示されます。

4. 編集するデータソースを選択します。

5. 「制御」をクリックして、「JDBCデータソースの管理」ページを表示します。
このページに表示されるのは、実行中の管理対象サーバーを対象にしたデータソースのみです。管理ページに特定のデータソースが表示されていない場合は、データソースを編集して、実行中の管理対象サーバーを対象にするようにします。

6. 文キャッシュの「開始」、「停止」、「強制停止」、「再開」、「中断」、「強制中断」、「縮小」、「リセット」、または「クリア」をクリックして、選択したJDBCデータソースの状態を制御または変更します。
このページで選択するコマンドは、Oracle WebLogic Server管理コンソールでデータソースを管理するときに使用可能なコマンドと似ています。JDBCデータソース制御オプションの詳細は、『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』のWebLogic JDBCリソースの管理に関する説明を参照してください。

10.2.2.5 Fusion Middleware Controlを使用したGridLinkデータソースの作成

単一のGridLinkデータソースは、Oracle RACクラスタにターゲット指定されたOracle WebLogic ServerとOracle Databaseサービス間の接続を提供します。GridLinkデータソースの詳細は、『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』のGridLinkデータソースの作成に関する説明を参照してください。

Fusion Middleware Controlを使用してGrid Linkデータソースを作成する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメイン・ホーム・ページを表示するドメインを選択します。

3. 「WebLogicドメイン」メニューで「JDBCデータソース」を選択します。
「JDBCデータソース」ページが表示されます。

4. 「作成」から、「GridLinkデータ・ソース」を選択します。

5. ウィザードの指示に従って、データソースのプロパティを設定し、ドメイン内の1つ以上の管理対象サーバーのデータソースを対象に指定します。
個々のフィールドおよびプロパティに関するヘルプを表示するには、マウスを使用してフィールドをフォーカスします。Fusion Middleware Controlでは、フィールドの定義がポップアップで表示されます。

Fusion Middleware Controlで定義するデータソース・プロパティは、Oracle WebLogic Server管理コンソールでデータソースを作成するときに定義するデータソース・プロパティと似ています。このため、データソース・プロパティの詳細は、『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』のGridLinkデータソースの作成に関する説明を参照することもできます。

10.3 Java EEアプリケーションのデプロイ、アンデプロイおよび再デプロイ

Java EEアプリケーションのデプロイ、アンデプロイおよび再デプロイには、Fusion Middleware Control、Oracle WebLogic Server管理コンソール、Oracle JDeveloperまたはコマンドラインを使用できます。次の各項では、Fusion Middleware Controlおよびコマンドラインを使用して、これらの作業を行う手順を説明します。

- Java EEアプリケーションのデプロイ

- Java EEアプリケーションのアンデプロイ

- Java EEアプリケーションの再デプロイ

関連項目:

Oracle WebLogic Server管理コンソールを使用してデプロイする方法およびWLSTコマンドラインを使用する方法の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』を参照してください。

10.3.1 Java EEアプリケーションのデプロイ

WebLogic Serverの管理対象サーバー・インスタンスまたはクラスタへ、アプリケーションをデプロイできます。この項では、管理対象サーバーにアプリケーションをデプロイする方法について説明します。

10.3.1.1 Fusion Middleware Controlを使用したJava EEアプリケーションのデプロイ

Fusion Middleware Controlを使用してJava EEアプリケーションを管理対象サーバーにデプロイする手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開き、そのドメインを開きます。

2. アプリケーションをデプロイするサーバーを選択します。
サーバーのホーム・ページが表示されます。

3. 「WebLogic Server」メニューから、「アプリケーションのデプロイ」→「デプロイ」を選択します。
次の図のように、デプロイ・ウィザードの「アーカイブの選択」ページが表示されます。

図j2ee_deploy.gifの説明

4. 「アーカイブまたは展開済ディレクトリ」セクションで、次のいずれかを選択します。

- アーカイブはこのWebブラウザが稼働しているマシンに存在します。アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを検索します。

- アーカイブまたは展開済ディレクトリはEnterprise Managerが稼働しているサーバーに存在します。アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを検索します。

5. 「デプロイ・プラン」セクションで、次のいずれかを選択します。

- デプロイ構成が行われるとき、新規デプロイ・プランを作成します。

- デプロイ・プランはこのWebブラウザが稼働しているマシンに存在します。このオプションを選択した場合は、デプロイ・プランへのパスを入力します。

- デプロイ・プランはEnterprise Managerが稼働しているサーバーに存在します。このオプションを選択した場合は、デプロイ・プランへのパスを入力します。

6. 「次へ」をクリックします。
「ターゲットの選択」ページが表示されます。

7. アプリケーションのデプロイ先を選択します。管理サーバー、管理対象サーバーおよびクラスタが一覧表示されます。クラスタ、クラスタ内の1つ以上の管理対象サーバー、またはクラスタに属していない管理対象サーバーを選択できます。管理サーバーもターゲットのリストに表示されていますが、管理サーバーにはアプリケーションをデプロイしないでください。管理サーバーは、Oracle WebLogic Server管理コンソールなど、管理アプリケーションのみを対象としています。

8. 「次へ」をクリックします。
「アプリケーション属性」ページが表示されます。

9. 「アプリケーション属性」セクションの「アプリケーション名」に、アプリケーション名を入力します。

10. 「Webモジュールのコンテキスト・ルート」セクションでは、Webモジュールのコンテキスト・ルートがapplication.xmlで構成されていない場合に、アプリケーションのコンテキスト・ルートを指定できます。コンテキスト・ルートは、WebモジュールのURIです。Webモジュール、またはWebサービスを含むEJBモジュールごとに、コンテキスト・ルートを指定できます。

11. 「配布」セクションで、次のいずれかを選択します。

- アプリケーションの配布と起動(すべてのリクエストの処理)

- 管理モードでのアプリケーションの配布と起動(管理リクエストのみ処理)

- 配布のみ

12. 「その他のオプション」を開くと、次のオプションが表示されます。

- デプロイメントのターゲットに定義されるデフォルトを使用 :推奨選択です。

- このアプリケーションを各ターゲットにコピーします。デプロイ時に、アプリケーションを管理するサーバーにファイルが自動的にコピーされます。

13. 「次へ」をクリックします。
デプロイ・ウィザードの「デプロイ設定」ページが表示されます。

14. このページでは、アプリケーションをデプロイする前の一般的なタスクを実行できます。また、デプロイ・プランの編集またはディスクへの保存もできます。
これらのタスクの詳細は、第10.8項を参照してください。

アプリケーションのタイプに応じて、「デプロイ・タスク」セクションで次の操作ができます。

- Webモジュールの構成: 「Webモジュールの構成」行で、「タスクに移動」をクリックします。「Webモジュールの構成」ページが表示されます。「一般プロパティの構成」をクリックして、Webモジュールの一般構成を表示および編集するか、または「リソース参照のマップ」をクリックして、リソース参照をマップします。
たとえば、セッション無効化間隔、またはセッションCookieの最大保持時間を変更できます。

- EJBモジュールの構成: EJBモジュールの構成行で、「タスクに移動」をクリックして、EJBデプロイメント記述子の標準的なプロパティを設定します。EJBモジュールの構成ページが表示されます。EJBプロパティの構成をクリックして、EJBの一般構成を表示および編集するか、または「リソース参照のマップ」をクリックして、リソース参照をマップします。
たとえば、空きプール内のBeanの最大数、またはネットワーク・アクセス・ポイントを構成できます。

- アプリケーション・セキュリティの構成: 「アプリケーション・セキュリティの構成」行で、「タスクに移動」をクリックします。第10.8項で説明しているように、使用しているセキュリティのタイプに応じて、様々なページが表示されます。

- 永続性の構成: 「永続性の構成」行で、「タスクに移動」をクリックして、Java Persistent API(JPA)の永続性単位を構成します。

15. 「デプロイ・プラン」を開きます。
デプロイ・プランを選択した場合、編集と保存ができます。デプロイ・プランを編集してディスクリプタの値を変更した場合、その変更内容がデプロイ・プランに保存されます。また、デプロイ・プランには、次の構成も保存されます。

- アプリケーション属性

- Webモジュール構成

- EJB構成

MDSに関連するアプリケーション属性は、ファイルadf-config.xmlに格納されます。アプリケーション・セキュリティ属性は、weblogic-application.xmlに格納されます。

Fusion Middleware Controlでは、該当するファイルが更新され、.earファイルが再パッケージ化されます。

16. 「デプロイ」をクリックします。
Fusion Middleware Controlに処理中のメッセージが表示されます。

17. デプロイが完了したら、「閉じる」をクリックします。

アプリケーションを複数のサーバーに同時にデプロイするには、ドメインにナビゲートします。次に、「WebLogicドメイン」メニューから「アプリケーション・デプロイメント」→「デプロイ」を選択します。デプロイメント・ウィザードにサーバーを選択できるページが表示されます。

アプリケーションをクラスタにデプロイするには、クラスタを選択します。次に「クラスタ」メニューから、「アプリケーション・デプロイメント」→「デプロイ」を選択します。

10.3.1.2 WLSTを使用したJava EEアプリケーションのデプロイ

WLSTコマンドラインを使用して、アプリケーションをデプロイできます。WLSTが管理サーバーに接続されている際にJava EEアプリケーションをデプロイするには、WLSTコマンドdeployを次の形式で使用します。

deploy(app_name, path [,targets] [,stageMode] [,planPath] [,options])

deployコマンドは、管理サーバーをホストするコンピュータ上で起動する必要があります。

たとえば、アプリケーションmainWebAppをデプロイするには、次のように指定します。

deploy("myApp","/scratch/applications/wlserver_10.3/samples/server/examples/build/mainWebApp")

次の例に示すように、weblogic.deployerを使用してアプリケーションをデプロイすることもできます。

java weblogic.Deployer -adminurl http://localhost:7001
-user username -password password -deploy
-name myApp c:\localfiles\mainWebApp
-plan c:\localfiles\productionEnvPlan.xml

関連項目:

- WLSTを使用してアプリケーションをデプロイする方法の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』のデプロイ・ツールに関する項を参照してください。

- 『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』

10.3.2 Java EEアプリケーションのアンデプロイ

WebLogic Serverの管理対象サーバー・インスタンスまたはクラスタから、アプリケーションまたは特定のバージョンのアプリケーションをアンデプロイできます。この項では、管理対象サーバーからアプリケーションをアンデプロイする方法について説明します。アプリケーションが複数のサーバーにデプロイされている場合、Fusion Middleware Controlを使用してアプリケーションをアンデプロイすると、そのアプリケーションはすべてのサーバーからアンデプロイされます。

10.3.2.1 Fusion Middleware Controlを使用したJava EEアプリケーションのアンデプロイ

Fusion Middleware Controlを使用して管理対象サーバーからJava EEアプリケーションをアンデプロイする手順は次のとおりです。

1. ナビゲーション・ペインで、「アプリケーションのデプロイ」を開きます。

2. アンデプロイするアプリケーションを選択します。
アプリケーションのホーム・ページが表示されます。

3. 「アプリケーションのデプロイ」メニューから、「アプリケーションのデプロイ」→「アンデプロイ」を選択します。
確認ページが表示されます。

4. 「アンデプロイ」をクリックします。
処理中のメッセージが表示されます。

5. 操作が完了したら、「閉じる」をクリックします。

また、ドメイン、管理対象サーバーまたはクラスタにナビゲートすることもできます。ターゲット・メニューから「アプリケーションのデプロイ」→「アンデプロイ」を選択します。「アプリケーションの選択」ページで、アンデプロイするアプリケーションを選択します。

10.3.2.2 WLSTを使用したJava EEアプリケーションのアンデプロイ

WLSTコマンドラインを使用して、アプリケーションをアンデプロイできます。WLSTが管理サーバーに接続されている際にJava EEアプリケーションをアンデプロイするには、WLSTコマンドundeployを次の形式で使用します。

undeploy(app_name, path [,targets] [,options])

undeployコマンドは、管理サーバーをホストするコンピュータ上で起動する必要があります。

たとえば、すべてのターゲット・サーバーからアプリケーションbusinessAppをアンデプロイし、WLSTでプロセスが完了するまで60,000ミリ秒待機するように指定するには、次のように指定します。

wls:/mydomain/serverConfig> undeploy('businessApp', timeout=60000)

10.3.3 Java EEアプリケーションの再デプロイ

更新した新しいバージョンのアプリケーション、同じバージョンのアプリケーション、またはバージョンのないアプリケーションを再デプロイすることができます。アプリケーションは、クラスタまたは管理対象サーバーに再デプロイできます。この項では、管理対象サーバーにアプリケーションを再デプロイする方法について説明します。

10.3.3.1 Fusion Middleware Controlを使用したJava EEアプリケーションの再デプロイ

Fusion Middleware Controlを使用してJava EEアプリケーションを管理対象サーバーに再デプロイする手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「アプリケーションのデプロイ」を開きます。

2. アプリケーションを選択します。
アプリケーションのホーム・ページが表示されます。

3. 「アプリケーションのデプロイ」メニューから、「アプリケーションのデプロイ」→「再デプロイ」を選択します。
「アプリケーションの選択」ページが表示されます。

4. 「次へ」をクリックします。

5. 「アーカイブまたは展開済ディレクトリ」セクションで、次のいずれかを選択します。

- アーカイブはこのWebブラウザが稼働しているマシンに存在します。アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを検索します。

- アーカイブまたは展開済ディレクトリはEnterprise Managerが稼働しているサーバーに存在します。アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを検索します。

6. 「デプロイ・プラン」セクションで、次のいずれかを選択します。

- デプロイ構成が行われるとき、新規デプロイ・プランを作成します。

- デプロイ・プランはこのWebブラウザが稼働しているマシンに存在します。プランへのパスを入力するか、「参照」をクリックしてプラン・ファイルを検索します。

- デプロイ・プランはEnterprise Managerが稼働しているサーバーに存在します。プランへのパスを入力するか、「参照」をクリックしてプラン・ファイルを検索します。

7. 「次へ」をクリックします。
「アプリケーション属性」ページが表示されます。

8. 「次へ」をクリックします。
デプロイ・ウィザードの「デプロイ設定」ページが表示されます。

9. このページでは、アプリケーションをデプロイする前の一般的なタスクを実行できます。また、デプロイ・プランの編集またはディスクへの保存もできます。アプリケーションのタイプに応じて、「デプロイ・タスク」セクションで次の操作ができます。

- Webモジュールの構成

- アプリケーション・セキュリティの構成

- EJBモジュールの構成

- 永続性の構成

これらのタスクの詳細は、第10.8項を参照してください。

10. 「デプロイ・プラン」を開きます。
デプロイ・プランを選択した場合、編集と保存ができます。デプロイ・プランを編集してディスクリプタの値を変更した場合、その変更内容がデプロイ・プランに保存されます。また、デプロイ・プランには、次の構成も保存されます。

- アプリケーション属性

- Webモジュール構成

- EJB構成

MDSに関連するアプリケーション属性は、ファイルadf-config.xmlに格納されます。アプリケーション・セキュリティ属性は、weblogic-application.xmlに格納されます。

Fusion Middleware Controlでは、該当するファイルが更新され、.earファイルが再パッケージ化されます。

11. 「再デプロイ」をクリックします。
処理中のメッセージが表示されます。

12. 操作が完了したら、「閉じる」をクリックします。

アプリケーションをクラスタに再デプロイするには、クラスタを選択します。次にターゲットのメニューから、「アプリケーション・デプロイメント」→「再デプロイ」を選択します。

10.3.3.2 WLSTを使用したJava EEアプリケーションの再デプロイ

WLSTコマンドラインを使用して、アプリケーションを再デプロイできます。WLSTが管理サーバーに接続されている際にJava EEアプリケーションを再デプロイするには、WLSTコマンドredeployを次の形式で使用します。

redeploy(app_name [,planpath] [,options])

redeployコマンドは、管理サーバーをホストするコンピュータ上で起動する必要があります。

たとえば、アプリケーションbusinessAppをすべてのターゲット・サーバーに再デプロイするには、次のように指定します。

redeploy('businessApp')

10.4 Oracle ADFアプリケーションのデプロイ、アンデプロイおよび再デプロイ

Oracle ADFは、Java Platform, Enterprise Edition(Java EE)標準やオープンソース・テクノロジに基づいて、サービス指向アプリケーションの実装を簡略化および高速化するエンドツーエンド・アプリケーション・フレームワークです。

Oracle ADFアプリケーションのデプロイ、アンデプロイおよび再デプロイには、Fusion Middleware Control、Oracle WebLogic Server管理コンソール、Oracle JDeveloperまたはコマンドラインを使用できます。次の各項では、Fusion Middleware Control、管理コンソールおよびコマンドラインを使用して、これらの作業を行う手順を説明します。

- Oracle ADFアプリケーションのデプロイ

- Oracle ADFアプリケーションのアンデプロイ

- Oracle ADFアプリケーションの再デプロイ

関連項目:

ADFアプリケーションのデプロイおよびOracle JDeveloperを使用したADFアプリケーションのデプロイの詳細は、Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイドを参照してください。

10.4.1 Oracle ADFアプリケーションのデプロイ

WebLogic Serverの管理対象サーバー・インスタンスまたはクラスタへ、アプリケーションをデプロイできます。この項では、管理対象サーバーにアプリケーションをデプロイする方法について説明します。この例では、ADFアプリケーションが格納された.earファイルを作成済であることを想定しています。

10.4.1.1 Fusion Middleware Controlを使用したADFアプリケーションのデプロイ

Fusion Middleware Controlを使用してOracle ADFアプリケーションをデプロイする手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開き、そのドメインを開きます。

2. アプリケーションをデプロイするサーバーを選択します。
サーバーのホーム・ページが表示されます。

3. 「WebLogic Server」メニューから、「アプリケーションのデプロイ」→「デプロイ」を選択します。
デプロイ・ウィザードの「アーカイブの選択」ページが表示されます。

4. 「アーカイブまたは展開済ディレクトリ」セクションで、次のいずれかを選択します。

- アーカイブはこのWebブラウザが稼働しているマシンに存在します。アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを検索します。

- アーカイブまたは展開済ディレクトリはEnterprise Managerが稼働しているサーバーに存在します。アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを検索します。

5. 「デプロイ・プラン」セクションで、次のいずれかを選択します。

- デプロイ構成が行われるとき、新規デプロイ・プランを作成します。

- デプロイ・プランはこのWebブラウザが稼働しているマシンに存在します。プランへのパスを入力します。

- デプロイ・プランはEnterprise Managerが稼働しているサーバーに存在します。プランへのパスを入力します。

6. 「次へ」をクリックします。
「ターゲットの選択」ページが表示されます。

7. アプリケーションのデプロイ先を選択します。
クラスタ、クラスタ内の1つ以上の管理対象サーバー、またはクラスタに属していない管理対象サーバーを選択できます。

8. 「次へ」をクリックします。
次の図のように「アプリケーション属性」ページが表示されます。

図deploy_attr.gifの説明

9. 「アプリケーション属性」セクションの「アプリケーション名」に、アプリケーション名を入力します。

10. 「Webモジュールのコンテキスト・ルート」セクションでは、Webモジュールのコンテキスト・ルートがapplication.xmlで構成されていない場合に、アプリケーションのコンテキスト・ルートを指定できます。コンテキスト・ルートは、WebモジュールのURIです。Webモジュール、またはWebサービスを含むEJBモジュールごとに、コンテキスト・ルートを指定できます。

11. 「ターゲット・メタデータ・リポジトリ」セクションで、このアプリケーションのリポジトリおよびパーティションを選択できます。パーティション名がadf-config.xmlファイルで指定されていない場合には、デフォルトのパーティション名としてアプリケーション名にバージョンを付加したものが使用されます。これにより、使用されるパーティションはドメイン内で一意になり、異なるアプリケーションのメタデータが同じリポジトリ・パーティションに誤ってインポートされて相互に上書きされることはなくなります。通常は、アプリケーションのメタデータは、それぞれ専用のパーティションにデプロイされます。

- リポジトリを変更するには、「リポジトリ名」の横にあるアイコンをクリックします。「メタデータ・リポジトリ」ダイアログ・ボックスでリポジトリを選択し、「OK」をクリックします。

- パーティションを変更するには、「パーティション名」にパーティション名を入力します。アプリケーションごとに新しいパーティションを作成することをお薦めします。存在していないパーティションの名前を入力した場合は、そのパーティションが作成されます。

.earファイル内のadf-config.xmlファイルは、新しい情報で更新されます。

アプリケーションで指定したパーティションまたはリポジトリがドメイン内で有効でない場合は、Fusion Middleware Controlによってメッセージが表示されます。

12. MDS共有リポジトリのMDS構成がアプリケーションのadf-config.xmlファイル・アーカイブに含まれている場合には、「共有メタデータ・リポジトリ」セクションが表示されます。このセクションで、このアプリケーションのリポジトリおよびパーティションを選択できます。アプリケーションで指定したパーティションまたはリポジトリがドメイン内で有効でない場合は、Fusion Middleware Controlによってメッセージが表示されます。
リポジトリまたはパーティションを変更した場合、.earファイル内のadf-config.xmlファイルは、新しい情報で更新されます。

13. 「配布」セクションで、次のいずれかを選択します。

- アプリケーションの配布と起動(すべてのリクエストの処理)

- 管理モードでのアプリケーションの配布と起動(管理リクエストのみ処理)

- 配布のみ

14. 「次へ」をクリックします。
デプロイ・ウィザードの「デプロイ設定」ページが表示されます。

15. このページでは、アプリケーションをデプロイする前の一般的なタスクを実行できます。また、デプロイ・プランの編集またはディスクへの保存もできます。アプリケーションのタイプに応じて、「デプロイ・タスク」セクションで次の操作ができます。

- Webモジュールの構成: 「Webモジュールの構成」行で、「タスクに移動」をクリックします。「Webモジュールの構成」ページが表示されます。「一般プロパティの構成」をクリックして、Webモジュールの一般構成を表示および編集するか、または「リソース参照のマップ」をクリックして、リソース参照をマップします。
たとえば、セッション無効化間隔、またはセッションCookieの最大保持時間を変更できます。

- EJBモジュールの構成: EJBモジュールの構成行で、「タスクに移動」をクリックして、EJBデプロイメント記述子の標準的なプロパティを設定します。EJBモジュールの構成ページが表示されます。EJBプロパティの構成をクリックして、EJBの一般構成を表示および編集するか、または「リソース参照のマップ」をクリックして、リソース参照をマップします。
たとえば、空きプール内のBeanの最大数、またはネットワーク・アクセス・ポイントを構成できます。

- アプリケーション・セキュリティの構成: 「アプリケーション・セキュリティの構成」行で、「タスクに移動」をクリックします。第10.8項で説明しているように、使用しているセキュリティのタイプに応じて、様々なページが表示されます。

- 永続性の構成: 「永続性の構成」行で、「タスクに移動」をクリックして、Java Persistent API(JPA)の永続性単位を構成します。

- ADF接続の構成: ADF接続を変更するには、「ADF接続の構成」行で「タスクに移動」をクリックします。「ADF接続の構成」ページが開き、現在の接続情報が表示されます。接続タイプを変更するには、目的の行の「編集」アイコンをクリックします。たとえば、外部アプリケーションの接続情報を変更できます。ADF接続の詳細は、Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイドを参照してください。

これらのオプションの詳細は、第10.8項を参照してください。

16. 「デプロイ・プラン」を開きます。
デプロイ・プランを選択した場合、編集と保存ができます。

17. 「デプロイ」をクリックします。
Fusion Middleware Controlに処理中のメッセージが表示されます。

18. デプロイが完了したら、「閉じる」をクリックします。

10.4.1.2 WLSTまたは管理コンソールを使用したADFアプリケーションのデプロイ

ADFアプリケーションは、WLSTコマンドラインまたはOracle WebLogic Server管理コンソールを使用してデプロイできます。

次の手順を実行します。

1. アプリケーションでMDSリポジトリを使用している場合、アプリケーションをデプロイする前にアプリケーション・アーカイブ(.ear)ファイルを構成する必要があります。デプロイ・ターゲット・リポジトリまたは任意の共有メタデータ・リポジトリのリポジトリ情報は、WLSTのgetMDSArchiveConfigコマンドを使用して指定する必要があります。アプリケーションをデプロイする前に、指定されたリポジトリをドメインに登録しておく必要があります。次の例では、このコマンドを使用してMDSArchiveConfigを取得し、setAppMetadataRepositoryメソッドをコールしてデプロイ・ターゲット・リポジトリを設定する方法を示します。この操作を行わないと、アプリケーションが起動しません。

wls:/offline> archive = getMDSArchiveConfig(fromLocation='/tmp/App1.ear')
wls:/offline> archive.setAppMetadataRepository(repository='AppRepos1',
partition='partition1', type='DB', jndi='mds-jndi1')

この操作では、アーカイブ・ファイル内のadf-config.xmlファイルのMDS構成部分に変更が配置されます。

2. 次のコマンドを使用して、変更を元の.earファイルに保存します。

wls:/offline> archive.save()

3. アプリケーションをデプロイします。
WLSTが管理サーバーに接続されている際にアプリケーションをデプロイするには、WLSTコマンドdeployを次の形式で使用します。

deploy(app_name, path [,targets] [,stageMode] [,planPath] [,options])

deployコマンドは、管理サーバーをホストするコンピュータ上で起動する必要があります。

たとえば、アプリケーションmyAppをデプロイするには、次のように指定します。

deploy("myApp","/scratch/applications/myApp", targets='myserver', timeout=120000))

関連項目:

- WLSTを使用してアプリケーションをデプロイする方法の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』のデプロイ・ツールに関する項を参照してください。

- 『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』

Oracle WebLogic Server管理コンソールを使用してアプリケーションをデプロイする手順は次のとおりです。

1. まだ行っていない場合は、管理コンソールのチェンジ・センターで「ロックして編集」をクリックします。

2. 管理コンソールの左ペインで、「デプロイメント」を選択します。

3. 右ペインで、「インストール」をクリックします。

関連項目:

Oracle WebLogic Server管理コンソールのヘルプ

10.4.2 Oracle ADFアプリケーションのアンデプロイ

Fusion Middleware Controlを使用してOracle ADFアプリケーションをアンデプロイする手順は次のとおりです。

1. ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、アンデプロイするアプリケーションを選択します。
アプリケーションのホーム・ページが表示されます。

2. 「アプリケーションのデプロイ」メニューから、「アプリケーションのデプロイ」→「アンデプロイ」を選択します。
確認ページが表示されます。

3. 「アンデプロイ」をクリックします。
処理中のメッセージが表示されます。

4. 操作が完了したら、「閉じる」をクリックします。

また、ドメイン、管理対象サーバーまたはクラスタにナビゲートすることもできます。ターゲット・メニューから「アプリケーションのデプロイ」→「アンデプロイ」を選択します。「アプリケーションの選択」ページで、アンデプロイするアプリケーションを選択します。

アプリケーションをアンデプロイしても、MDSパーティションに格納されているドキュメントは削除されません。

10.4.3 Oracle ADFアプリケーションの再デプロイ

アプリケーションを再デプロイする際に、アプリケーションにメタデータ・アーカイブ(MAR)が含まれていると、MARの内容は、MARが変更されている場合にのみ、アプリケーションのメタデータ・リポジトリにインポートされます。MARがアプリケーションの前回のデプロイから変更されていない場合は無視されます。

Fusion Middleware Controlを使用してOracle ADFアプリケーションを再デプロイする手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「アプリケーションのデプロイ」を開きます。

2. アプリケーションを選択します。
アプリケーションのホーム・ページが表示されます。

3. 「アプリケーションのデプロイ」メニューから、「アプリケーションのデプロイ」→「再デプロイ」を選択します。
「アプリケーションの選択」ページが表示されます。

4. 「次へ」をクリックします。
「アーカイブの選択」ページが表示されます。

5. 「アーカイブまたは展開済ディレクトリ」セクションで、次のいずれかを選択します。

- アーカイブはこのWebブラウザが稼働しているマシンに存在します。アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを検索します。

- アーカイブまたは展開済ディレクトリはEnterprise Managerが稼働しているサーバーに存在します。アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを検索します。

6. 「デプロイ・プラン」セクションで、次のいずれかを選択します。

- デプロイ構成が行われるとき、新規デプロイ・プランを作成します。

- デプロイ・プランはこのWebブラウザが稼働しているマシンに存在します。プランへのパスを入力します。

- デプロイ・プランはEnterprise Managerが稼働しているサーバーに存在します。プランへのパスを入力します。

7. 「次へ」をクリックします。
「アプリケーション属性」ページが表示されます。

8. 「アプリケーション属性」セクションの「アプリケーション名」に、アプリケーション名を入力します。

9. 「Webモジュールのコンテキスト・ルート」セクションでは、Webモジュールのコンテキスト・ルートがapplication.xmlで構成されていない場合に、アプリケーションのコンテキスト・ルートを指定できます。コンテキスト・ルートは、WebモジュールのURIです。Webモジュール、またはWebサービスを含むEJBモジュールごとに、コンテキスト・ルートを指定できます。

10. 「ターゲット・メタデータ・リポジトリ」セクションが表示されます。このセクションで、このアプリケーションのリポジトリおよびパーティションを選択できます。

- リポジトリを変更するには、「リポジトリ名」の横にあるアイコンをクリックします。「メタデータ・リポジトリ」ダイアログ・ボックスでリポジトリを選択し、「OK」をクリックします。

- パーティションを変更するには、「パーティション名」にパーティション名を入力します。アプリケーションごとに新しいパーティションを作成することをお薦めします。存在していないパーティションの名前を入力した場合は、そのパーティションが作成されます。

11. MDS共有リポジトリのMDS構成がアプリケーションのadf-config.xmlファイル・アーカイブに含まれている場合には、「共有メタデータ・リポジトリ」セクションが表示されます。このセクションで、このアプリケーションのリポジトリおよびパーティションを選択できます。

12. 「次へ」をクリックします。
「デプロイ設定」ページが表示されます。

13. このページでは、アプリケーションをデプロイする前の一般的なタスクを実行できます。また、デプロイ・プランの編集またはディスクへの保存もできます。「デプロイ・タスク」セクションで次の操作ができます。

- Webモジュールの構成

- アプリケーション・セキュリティの構成

- 永続性の構成

これらのオプションの詳細は、第10.8項を参照してください。

14. 「デプロイ・プラン」を開きます。
デプロイ・プランを選択した場合、編集と保存ができます。

15. 「デプロイ」をクリックします。
Fusion Middleware Controlに処理中のメッセージが表示されます。

16. デプロイが完了したら、「閉じる」をクリックします。

17. 確認ページで、「再デプロイ」をクリックします。

10.5 SOAコンポジット・アプリケーションのデプロイ、アンデプロイおよび再デプロイ

SOAコンポジット・アプリケーションは、次のコンポーネントで構成されます。

- ルーティングを処理するOracle Mediator、全体を統括するBPELプロセス、ワークフローを承認する人間のタスク、ビジネスの意思決定を設計するビジネス・ルール、イベント・ストリームを問い合せる複合イベント処理などのサービス・コンポーネント

- 外部のサービス、アプリケーションおよびテクノロジに対してSOAコンポジット・アプリケーションを接続するバインディング・コンポーネント(サービスと参照)

これらのコンポーネントを集合させたものがSOAコンポジット・アプリケーションです。このアプリケーションは単一のデプロイ単位で、SOAアプリケーションの管理やライフサイクルを大幅に簡素化します。

SOAアプリケーションのデプロイ、アンデプロイおよび再デプロイには、Fusion Middleware Control、Oracle JDeveloperまたはコマンドラインを使用できます。次の各項では、Fusion Middleware Controlを使用して、これらの作業を行う手順を説明します。

- SOAコンポジット・アプリケーションのデプロイ

- SOAコンポジット・アプリケーションのアンデプロイ

- SOAコンポジット・アプリケーションの再デプロイ

関連項目:

『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』

10.5.1 SOAコンポジット・アプリケーションのデプロイ

SOAコンポジット・アプリケーションをデプロイする場合、デプロイによってSOAインフラストラクチャのコンポジット・アプリケーションが抽出されてアクティブ化されます。

SOAコンポジット・アプリケーションは、Fusion Middleware ControlからSOAコンポジットのデプロイ・ウィザードを使用してデプロイできます。

1. ナビゲーション・ペインで、ファームを開いてから、「SOA」を開いて「SOAインフラ」を開きます。
SOAインフラストラクチャのホーム・ページが表示されます。

2. 「SOAインフラストラクチャ」メニューから、「SOAデプロイ」→「デプロイ」を選択します。
次の図のように、デプロイ・ウィザードの「アーカイブの選択」ページが表示されます。

図soa_deploy.gifの説明

3. 「アーカイブまたは展開済ディレクトリ」セクションで、デプロイするSOAコンポジット・アプリケーションのアーカイブを指定します。アーカイブには、デプロイするアプリケーションのプロジェクト・ファイルが含まれています(単一アーカイブ用のHelloWorld_rev1.0.jarや複数アーカイブ用のOrderBooking_rev1.0.zipなど)。

4. 「構成プラン」セクションで、アーカイブに含める構成プランを指定します(オプション)。構成プランには、異なる環境で使用するURLとプロパティ値を定義できます。構成プランは、プロセスのデプロイメント時に、プロジェクトを別のターゲット環境に適合させるために置換する必要のある値に関するSOAプロジェクトを検索する際に使用されます。

5. 「次へ」をクリックします。
「ターゲットの選択」ページが表示されます。

6. SOAパーティション・セクションで、このSOAコンポジット・アプリケーションをデプロイする先のパーティションを選択します。パーティションを使用すると、SOAコンポジット・アプリケーションを異なるセクションに論理的にグループ化できます。使用可能なパーティションが1つのみである場合も、そのパーティションを明示的に選択する必要があります。デプロイした後は、コンポジットを別のパーティションに転送できなくなります。

7. 「次へ」をクリックします。
確認ページが表示されます。

8. 選択内容を確認します。

9. SOAコンポジット・アプリケーションをデフォルト・リビジョンとしてデプロイするかどうかを選択します。デフォルト・リビジョンは、新しいリクエストを受信する際にインスタンス化されます。

10. 「デプロイ」をクリックします。
処理中のメッセージが表示されます。

11. デプロイが完了したら、「確認」ボックスを閉じます。

関連項目:

SOAコンポジット・アプリケーションのデプロイに関する詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』のアプリケーションのデプロイに関する説明を参照してください。

10.5.2 SOAコンポジット・アプリケーションのアンデプロイ

SOAコンポジット・アプリケーションは、Fusion Middleware ControlからSOAコンポジットのアンデプロイ・ウィザードを使用してアンデプロイできます。

1. ナビゲーション・ペインで、ファームを開いてから、「SOA」を開いて「SOAインフラ」を開きます。
SOAインフラストラクチャのホーム・ページが表示されます。

2. 「SOAインフラストラクチャ」メニューから、「SOAデプロイ」→「アンデプロイ」を選択します。

3. アンデプロイするコンポジットを選択して、次へをクリックします。

4. 選択内容を確認します。問題ない場合、アンデプロイをクリックします。
処理中のメッセージが表示されます。

5. アンデプロイが完了したら、「確認」ウィンドウを閉じます。

関連項目:

SOAコンポジット・アプリケーションのアンデプロイに関する詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』のアプリケーションのアンデプロイに関する説明を参照してください。

10.5.3 SOAコンポジット・アプリケーションの再デプロイ

SOAコンポジット・アプリケーションは、Fusion Middleware ControlからSOAコンポジットの再デプロイ・ウィザードを使用して再デプロイできます。

1. ナビゲーション・ペインで、ファームを開いてから、「SOA」を開いて「SOAインフラ」を開きます。
SOAインフラストラクチャのホーム・ページが表示されます。

2. 「SOAインフラストラクチャ」メニューから、「SOAデプロイ」→「再デプロイ」を選択します。
「コンポジットの選択」ページが表示されます。

3. 再デプロイするコンポジットを選択します。

4. 「次へ」をクリックします。
「アーカイブの選択」ページが表示されます。

5. 「アーカイブまたは展開済ディレクトリ」セクションで、再デプロイするSOAコンポジット・アプリケーション・リビジョンの場所を選択します。

6. 「構成プラン」セクションで、アーカイブに含める構成プランを指定します(オプション)。

7. 「次へ」をクリックします。
確認ページが表示されます。

8. SOAコンポジット・アプリケーションをデフォルト・リビジョンとして再デプロイするかどうかを選択します。

9. 「再デプロイ」をクリックします。
処理中のメッセージが表示されます。

10. 再デプロイが完了したら、「閉じる」をクリックします。

関連項目:

SOAコンポジット・アプリケーションの再デプロイに関する詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』のアプリケーションの再デプロイに関する説明を参照してください。

10.6 WebCenter Portalアプリケーションのデプロイ、アンデプロイおよび再デプロイ

Oracle WebCenter Portalアプリケーションが従来のJava EEアプリケーションと異なる点は、アプリケーションのページ、これらのページに含まれるポートレット、ドキュメント・ライブラリなどのランタイム・カスタマイズをサポートすることです。カスタマイズは次のように保存されます。

- WebCenter Portalアプリケーションのカスタマイズは、データベースにインストールされたOracle Metadata Services(MDS)に保存されます。

- ポートレット・プロデューサのカスタマイズ(プリファレンス)は、通常はデータベース・プリファレンス・ストアに保存されます。

WebCenter Portalアプリケーションのデプロイ、アンデプロイまたは再デプロイには、Fusion Middleware Control、Oracle JDeveloperまたはコマンドラインを使用できます。次の各項では、Fusion Middleware Controlを使用して、これらの作業を行う手順を説明します。

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

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

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

関連項目:

『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』

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

アプリケーションをJDeveloperの外部にある管理対象サーバーにデプロイするには、まずアプリケーションのデプロイ・プランを作成する必要があります。Oracle JDeveloperで、プロジェクトレベルのデプロイメント・プロファイルを作成してから、アプリケーションレベルのデプロイメント・プロファイルを作成します。プロジェクトレベルのデプロイメント・プロファイルは、Web Application Archive(WAR)ファイルとしてパッケージ化されます。アプリケーションレベルのデプロイメント・プロファイルは、Metadata Archive(MAR)としてパッケージ化されます。1つのMARに、複数のプロジェクトのメタデータ・コンテンツを格納できます。MARファイルは、メタデータ・コンテンツをMDSリポジトリにデプロイする際に使用します。Oracle JDeveloperによるデプロイ・プランの作成の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイドを参照してください。

Oracle WebCenter Portalアプリケーションのデプロイの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のWebCenter Portalフレームワーク・アプリケーションのデプロイに関する説明を参照してください。

Fusion Middleware Controlを使用してOracle WebCenter Portalアプリケーションを管理対象サーバーにデプロイする手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. アプリケーションをデプロイするドメインを選択します。
サーバーのホーム・ページが表示されます。

3. 「WebLogicドメイン」メニューから、「アプリケーション・デプロイメント」→「デプロイ」を選択します。
デプロイ・ウィザードの「アーカイブの選択」ページが表示されます。

4. 「アーカイブまたは展開済ディレクトリ」セクションで、次のいずれかを選択します。

- アーカイブはこのWebブラウザが稼働しているマシンに存在します。アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを検索します。

- アーカイブまたは展開済ディレクトリはEnterprise Managerが稼働しているサーバーに存在します。アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを検索します。

5. 「デプロイ・プラン」セクションで、次のいずれかを選択します。

- デプロイ構成が行われるとき、新規デプロイ・プランを作成します。

- デプロイ・プランはこのWebブラウザが稼働しているマシンに存在します。プランへのパスを入力します。

- デプロイ・プランはEnterprise Managerが稼働しているサーバーに存在します。プランへのパスを入力します。

6. 「次へ」をクリックします。
「ターゲットの選択」ページが表示されます。

7. アプリケーションのデプロイ先を選択します。
クラスタ、クラスタ内の1つ以上の管理対象サーバー、またはクラスタに属していない管理対象サーバーを選択できます。

8. 「次へ」をクリックします。
「アプリケーション属性」ページが表示されます。

9. 「アプリケーション属性」セクションの「アプリケーション名」に、アプリケーション名を入力します。

10. 「Webモジュールのコンテキスト・ルート」セクションで、アプリケーションのコンテキスト・ルートをapplication.xmlで指定済でない場合は指定します。コンテキスト・ルートは、WebモジュールのURIです。Webモジュール、またはWebサービスを含むEJBモジュールごとに、コンテキスト・ルートを指定できます。

11. 「ターゲット・メタデータ・リポジトリ」セクションで、このアプリケーションのリポジトリおよびパーティションを選択できます。アプリケーションで指定したパーティションまたはリポジトリがドメイン内で有効でない場合は、Fusion Middleware Controlによってメッセージが表示されます。

- リポジトリを変更するには、「リポジトリ名」の横にあるアイコンをクリックします。「メタデータ・リポジトリ」ダイアログ・ボックスでリポジトリを選択し、「OK」をクリックします。

- パーティションを変更するには、「パーティション名」にパーティション名を入力します。アプリケーションごとに新しいパーティションを作成することをお薦めします。存在していないパーティションの名前を入力した場合は、そのパーティションが作成されます。
各アプリケーションには、リポジトリ内で一意のパーティションを指定する必要があります。

12. 「次へ」をクリックします。
デプロイ・ウィザードの「デプロイ設定」ページが表示されます。

13. このページでは、アプリケーションをデプロイする前の一般的なタスクを実行できます。また、デプロイ・プランの編集またはディスクへの保存もできます。アプリケーションのタイプに応じて、「デプロイ・タスク」セクションで次の操作ができます。

- Webモジュールの構成: 「Webモジュールの構成」行で、「タスクに移動」をクリックします。「Webモジュールの構成」ページが表示されます。「一般プロパティの構成」をクリックして、Webモジュールの一般構成を表示および編集するか、または「リソース参照のマップ」をクリックして、リソース参照をマップします。
たとえば、セッション無効化間隔、またはセッションCookieの最大保持時間を変更できます。

- EJBモジュールの構成: EJBモジュールの構成行で、「タスクに移動」をクリックして、EJBデプロイメント記述子の標準的なプロパティを設定します。EJBモジュールの構成ページが表示されます。EJBプロパティの構成をクリックして、EJBの一般構成を表示および編集するか、または「リソース参照のマップ」をクリックして、リソース参照をマップします。
たとえば、空きプール内のBeanの最大数、またはネットワーク・アクセス・ポイントを構成できます。

- アプリケーション・セキュリティの構成: 「アプリケーション・セキュリティの構成」行で、「タスクに移動」をクリックします。第10.8項で説明しているように、使用しているセキュリティのタイプに応じて、様々なページが表示されます。

- 永続性の構成: 「永続性の構成」行で、「タスクに移動」をクリックして、Java Persistent API(JPA)の永続性単位を構成します。

- ADF接続の構成: ADF接続を変更するには、「ADF接続の構成」行で「タスクに移動」をクリックします。「ADF接続の構成」ページが開き、現在の接続情報が表示されます。接続タイプを変更するには、目的の行の「編集」アイコンをクリックします。

これらのオプションの詳細は、第10.8項を参照してください。

14. 「デプロイ・プラン」を開きます。
デプロイ・プランを選択した場合、編集と保存ができます。

15. 「デプロイ」をクリックします。
Fusion Middleware Controlに処理中のメッセージが表示されます。

16. デプロイが完了したら、「閉じる」をクリックします。

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

WebCenter Portalアプリケーションをアンデプロイする手順は次のとおりです。

1. ナビゲーション・ペインで、「アプリケーションのデプロイ」を開き、アンデプロイするアプリケーションを選択します。
アプリケーションのホーム・ページが表示されます。

2. 「アプリケーションのデプロイ」メニューから、「アプリケーションのデプロイ」→「アンデプロイ」を選択します。
確認ページが表示されます。

3. 「アンデプロイ」をクリックします。
処理中のメッセージが表示されます。

4. 操作が完了したら、「閉じる」をクリックします。

また、ドメイン、管理対象サーバーまたはクラスタにナビゲートすることもできます。ターゲット・メニューから「アプリケーションのデプロイ」→「アンデプロイ」を選択します。「アプリケーションの選択」ページで、アンデプロイするアプリケーションを選択します。

10.6.3 WebCenter Portalアプリケーションの再デプロイ

WebCenter Portalアプリケーションを再デプロイする手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開き、そのドメインを開きます。

2. アプリケーションを再デプロイするサーバーを選択します。
サーバーのホーム・ページが表示されます。

3. 「WebLogic Server」メニューから、「アプリケーションのデプロイ」→「再デプロイ」を選択します。
「アプリケーションの選択」ページが表示されます。再デプロイできるのは、バージョニング済のアプリケーションのみです。バージョニングされていないアプリケーションの場合は、アンデプロイしてから再デプロイする必要があります。

4. 再デプロイするアプリケーションを選択します。

5. 「次へ」をクリックします。
「アーカイブの選択」ページが表示されます。

6. 「アーカイブまたは展開済ディレクトリ」セクションで、次のいずれかを選択します。

- アーカイブはこのWebブラウザが稼働しているマシンに存在します。アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを検索します。

- アーカイブまたは展開済ディレクトリはEnterprise Managerが稼働しているサーバーに存在します。アーカイブの場所を入力するか、「参照」をクリックしてアーカイブ・ファイルを検索します。

7. 「デプロイ・プラン」セクションで、次のいずれかを選択します。

- デプロイ構成が行われるとき、新規デプロイ・プランを作成します。

- デプロイ・プランはこのWebブラウザが稼働しているマシンに存在します。プランへのパスを入力します。

- デプロイ・プランはEnterprise Managerが稼働しているサーバーに存在します。プランへのパスを入力します。

8. 「次へ」をクリックします。
「アプリケーション属性」ページが表示されます。

9. 「アプリケーション属性」セクションの「アプリケーション名」に、アプリケーション名を入力します。

10. 「Webモジュールのコンテキスト・ルート」セクションで、アプリケーションのコンテキスト・ルートをapplication.xmlで指定済でない場合は指定します。コンテキスト・ルートは、WebモジュールのURIです。Webモジュール、またはWebサービスを含むEJBモジュールごとに、コンテキスト・ルートを指定できます。

11. 「ターゲット・メタデータ・リポジトリ」セクションで「MDSリポジトリ」を選択し、「パーティション名」にパーティション名を入力します。アプリケーションを最初にデプロイしたときに使用したものと同じリポジトリ接続およびパーティション名を使用してください。そうしなければ、すべてのカスタマイズが失われます。

12. 「次へ」をクリックします。
「デプロイ設定」ページが表示されます。

13. このページでは、アプリケーションをデプロイする前の一般的なタスクを実行できます。また、デプロイ・プランの編集またはディスクへの保存もできます。「デプロイ・タスク」セクションで次の操作ができます。

- Webモジュールの構成

- アプリケーション・セキュリティの構成

- 永続性の構成

これらのオプションの詳細は、第10.8項を参照してください。

14. 「デプロイ・プラン」を開きます。
デプロイ・プランを選択した場合、編集と保存ができます。

15. 「再デプロイ」をクリックします。
Fusion Middleware Controlに処理中のメッセージが表示されます。

16. デプロイが完了したら、「閉じる」をクリックします。

10.7 デプロイ・プランの管理

デプロイ・プランとは、Oracle WebLogic Serverにアーカイブをデプロイするために必要なすべての構成データをクライアント側で集約したものです。デプロイ・プランにより、構成設定の保存済セットを使用して、アプリケーションを容易にデプロイまたは再デプロイできます。

第10.3.1項で説明されているように、デプロイ時に既存のデプロイ・プランをアプリケーションに適用しない場合、デフォルトでは新しいデプロイ・プランが作成されます。作成されたデプロイ・プランはファイルとして保存し、そのアプリケーションの再デプロイや他のアプリケーションのデプロイに再利用できます。

ただし、アプリケーションのデプロイ後にその構成を変更する場合(たとえば、アプリケーションのMDS構成を変更する場合)、保存した既存のデプロイ・プランは、デプロイされたアプリケーションの構成設定を表さなくなります。

そのような場合、デプロイされたアプリケーションの構成をより綿密に表す新しいデプロイ・プランをフェッチできます。

現在デプロイされているアプリケーションのデプロイ・プランをフェッチする手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメインを選択します。
「WebLogicドメイン」ページが表示されます。

3. 「WebLogicドメイン」メニューから、「アプリケーションのデプロイ」→「デプロイ・プランのフェッチ」を選択します。
「デプロイ・プランのフェッチ」ページが表示されます。

4. 現在デプロイされているアプリケーションのリストからアプリケーションを選択します。

5. デプロイ・プランの保存先を選択して、「フェッチ」をクリックします。
デプロイ・プランは、Webブラウザが実行されているコンピュータまたはFusion Middleware Controlが実行されているコンピュータに保存できます。

6. 表示されたダイアログ・ボックスで、デプロイ・プランが保存されたディレクトリの場所を指定します。
これで、このデプロイ・プランを使用し、現在アプリケーションで使用中の構成で、後でアプリケーションをデプロイまたは再デプロイできるようになりました。

また、アプリケーションのデプロイ・ウィザードの「デプロイ設定」ページでデプロイ・プランを編集することもできます。

10.8 Fusion Middleware Controlでの一般的なデプロイ・タスクについて

Fusion Middleware Controlを使用してアプリケーションをデプロイする場合、アプリケーションをデプロイする前に、デプロイ・ウィザードの「デプロイ設定」ページを使用して、具体的なデプロイ構成タスクを実行できます。

デプロイするアプリケーションのタイプに応じて「デプロイ設定」ページに表示できるデプロイ・タスクについて、次に説明します。

Webモジュールの構成

このデプロイ・タスクは、Webモジュールを含むアプリケーションをデプロイする場合に使用できます。これは、ほとんどの場合、アプリケーションにWebアプリケーション・デプロイメント記述子(web.xmlまたはweblogic.xml)が含まれることを意味します。ただし、Webモジュールは、アプリケーションのJavaコードのアノテーションで識別することもできます。

このデプロイ・タスクを使用して、Webアプリケーション・デプロイメント記述子の標準的なプロパティを設定できます。このプロパティには、次のようなものがあります。

- セッション検証間隔

- セッションCookieの最大保持時間

EJBの構成

このデプロイ・タスクは、EJBモジュールを含むアプリケーションで使用できます。これは、ほとんどの場合、アプリケーションにEJBデプロイメント記述子(ejb-jar.xmlまたはweblogic-ejb-jar.xml)が含まれることを意味します。ただし、EJBモジュールは、アプリケーションのJavaコードのアノテーションで識別することもできます。

このデプロイ・タスクを使用して、EJBデプロイメント記述子の標準的なプロパティを設定できます。このプロパティには、次のようなものがあります。

- 空きプール内のBeanの最大数

- EJBネットワーク・アクセス・ポイント

アプリケーション・セキュリティの構成

このデプロイ・タスクは、すべてのアプリケーション・タイプで使用できます。ただし、このタスクを選択したときに使用できるオプションは、アプリケーションに次のファイルがあるかどうかによって異なります。

- jazn-data.xml
アプリケーションにjazn-data.xmlファイルが存在する場合は、次の操作ができます。

- ポリシー移行の追加、上書きまたは無視。

- 初めてアプリケーションをデプロイする場合は、「追加」を選択します。

- アプリケーションが以前にデプロイされており、アプリケーション認可ポリシーが存在する場合は、「追加」または「無視」を選択して、アプリケーション認可ポリシーを保持します。

- 前のポリシーを上書きするには、「上書き」を選択します。

- アプリケーション・ストライプIDの指定(ストライプIDが、移行オプションで定義されているストライプIDと一致しない場合)。

- アプリケーションをアンデプロイするときにポリシーを削除するように指定。

- cwallet.sso
アプリケーションにcwallet.ssoファイルが存在する場合は、追加のアプリケーション資格証明移行オプションを設定できます。

アプリケーションに両方のファイルが含まれている場合、このページには両方のセクションが表示されます。

「アプリケーション・セキュリティの構成」デプロイ・タスクを選択するときに使用可能な設定に関する詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』のFusion Middleware Controlを使用したJava EEとOracle ADFのアプリケーションのデプロイに関する項を参照してください。

アプリケーションにどちらのファイルも存在しない場合は、このタスクを使用して、アプリケーションをデプロイするときのユーザー・ロールおよびポリシーの定義方法を決定できます。たとえば、デプロイメント記述子で定義されたロールおよびポリシーのみを使用することも、サーバーで定義されたロールおよびポリシーのみを使用することもできます。「アプリケーション・セキュリティの構成」ページには、次のオプションが表示されます。

- デプロイメント記述子のみ: デプロイメント記述子で定義されているロールおよびポリシーのみを使用します。

- カスタム・ロール: 管理コンソールで定義されているロールを使用し、デプロイメント記述子で定義されているポリシーを使用します。

- カスタム・ロールおよびポリシー: 管理コンソールで定義されているロールおよびポリシーのみを使用します。

- 拡張: レルムの構成ページで構成したカスタム・モデルを使用します。

永続性の構成

このデプロイ・タスクは、1つ以上のpersistence.xmlファイルを含むアプリケーションで使用できます。このタスクを使用して、アプリケーションのJava Persistent API(JPA)の永続性単位を構成できます。

それぞれの永続性単位の詳細を表示して、それぞれの永続性単位のJava Transaction API(JTA)データソースまたは非JTAデータソースを定義することができます。

永続性単位にデータソースを構成すると、Oracle TopLinkを使用するアプリケーションで便利な場合があります。詳細は、Oracle Fusion Middleware Oracle TopLinkソリューション・ガイドを参照してください。

Java EEアプリケーションでの永続性単位およびpersistence.xmlファイルの使用方法の詳細は、次のWebサイトにあるJava EE 5チュートリアルの、永続性単位の定義に関する項を参照してください。

http://download.oracle.com/javaee/5/tutorial/doc/bnbqw.html#bnbrj

ADF接続の構成

このデプロイ・タスクは、ADF接続を使用するアプリケーションで使用できます。外部アプリケーションの接続情報を変更できます。ADF接続の詳細は、Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイドを参照してください。

10.9 デプロイされたアプリケーションでのMDS構成属性の変更

アプリケーションでMDSリポジトリを使用している場合、アプリケーションをデプロイした後に構成属性を変更できます。属性を表示または変更するには、システムMBeanブラウザまたはWLSTを使用できます。

注意:

この構成の変更は、カスタマイズとしてMDSに保持されます。これらがカスタマイズとして保持される理由は次のとおりです。

- この構成の変更は、アプリケーション・デプロイメント全体で保持されます。たとえば、アプリケーションのExternalChangeDetectionInterval構成属性の値がOracle JDeveloper全体で40秒に設定されているとします。ExternalChangeDetectionInterval構成属性を50秒に変更し、このアプリケーションを再デプロイすると、この属性の値は50秒のままになります。

- クラスタでは、デプロイされたアプリケーションのすべてのインスタンスが同じMDSリポジトリ・パーティションを指すため、このアプリケーションのすべてのインスタンスは同じ値を使用します。構成属性が1つのアプリケーション・インスタンスに対して変更されると、クラスタ内でそのアプリケーションのすべてのインスタンスが変更された値を使用します。

次の各項では、MDS構成属性を変更する方法について説明します。

- Fusion Middleware Controlを使用したMDS構成属性の変更

- WLSTを使用したMDS構成の変更

- アプリケーションの元のMDS構成のリストア

10.9.1 Fusion Middleware Controlを使用したMDS構成属性の変更

アプリケーションのMDS構成属性を変更するには、次の手順を実行します。

1. ファームを開いてから「アプリケーションのデプロイ」を開いて、アプリケーションのホーム・ページにナビゲートします。そこで、アプリケーションを選択します。
アプリケーションのホーム・ページが表示されます。

2. 「アプリケーションのデプロイ」メニューから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」ページが表示されます。

3. 「アプリケーション定義のMBean」→「oracle.adf.share.config」→「サーバー: 名前」→「アプリケーション: 名前」→「ADFConfig」→「ADFConfig」→「ADFConfig」を開きます。

4. 「MDSAppConfig」を選択します。
次の図のように「アプリケーション定義のMBean」ページが表示されます。

図mds_sysmbean.gifの説明

5. 属性の説明および値を表示できます。
表10-2では、MDS固有の構成属性について説明します。ConfigMBeanなど、他の属性もブラウザに表示されますが、それらはすべてのMBeanの汎用属性です。

表10-2 デプロイされたアプリケーションでのMDS構成属性

属性

説明

AppMetadataRepositoryInfo

読取り専用。アプリケーションがデプロイされているメタデータ・リポジトリ・パーティションについての説明です。

AutoPurgeTimeToLive

秒単位で指定された特定の時間間隔より古いメタデータ・ドキュメントのバージョンを自動的にパージします。この時間間隔より古い、ラベルのないバージョンはいずれも、このアプリケーションから後続の更新が行われるたびに自動的にパージされます。値が設定されていない場合、バージョンは自動的にパージされません。

DeployTargetRepository

アプリケーション用に構成されたターゲット・リポジトリの名前。

ExternalChangeDetection

いずれかのメタデータの変更が他のクラスタ・ノードで実行されているか、または別のアプリケーションで実行されているかを判断するために、MDSリポジトリをポーリングするように指定します。変更が検出されると、リポジトリを共有するアプリケーションに通知が送信されます。

複数のアプリケーションで、共有リポジトリにデプロイされるメタデータを共有できます。あるアプリケーションでこの共有メタデータに対して変更を行うと、他のアプリケーションでその変更を検出できます。そのためには、両方のアプリケーションで、アプリケーション構成の一環として共有リポジトリを構成する必要があります。

MDSリポジトリが同じJVMの複数のアプリケーションで使用されている場合、いずれかのアプリケーションでExternalChangeDetectionがtrueに設定されていると、MDSは変更がないかポーリングします。

このアプリケーション・メタデータを更新することがない場合、または単一のサーバー上でこのアプリケーションでのみ使用される場合、この属性はfalseに設定します。

この属性は、データベース・ベースのリポジトリにのみ適用されます。デフォルトはtrueです。

ExternalChangeDetectionInterval

外部メタデータの変更があるかどうかを判断するために、MDSリポジトリのポーリングを行う最大時間間隔(秒)。この属性は、ExternalChangeDetectionが有効な場合にのみ有効です。

MDSリポジトリが同じJVMの複数のアプリケーションで共有され、使用されている場合、MDSは各アプリケーションでこの属性に指定されている値のうち、最低のものを使用します。そのため、あるアプリケーションでこのパラメータの値を変更しても、変更の影響が発生するのは、新しい値が他のアプリケーションで指定されたいずれの値より小さい場合のみです。

デフォルトは30秒です。

MaximumCacheSize

最大メタデータ・キャッシュ・サイズ制限(KB)。値が0の場合、キャッシュは無効です。値が指定されていない場合、キャッシュは無制限になります。その場合、キャッシュ・データは無制限に格納されます。

ReadOnlyMode

アプリケーションを読取り専用モードに変更します。これによって、構成やアプリケーションのメタデータなど、アプリケーションのリポジトリ・パーティションを更新できないようにします。

RetryConnection

接続に失敗した後、アプリケーションがメタデータ・リポジトリへの接続を再試行できるようにします。

SharedMetadataRepositoryInfo

読取り専用。アプリケーションで使用されるMDSリポジトリ・パーティションを指定します。1つのアプリケーションで、複数の共有メタデータ・リポジトリを使用できます。

6. 属性を表示または変更するには、属性を選択します。
属性ページが表示されます。

7. 属性が読取り専用でない場合は、値を変更できます。たとえば、AutoPurgeTimeToLiveでは、「値」に新しい値を入力して間隔を変更できます。

8. 「適用」をクリックします。

9. 「ADFConfig」(MDSAppConfigの親)にナビゲートして選択します。

10. 「操作」タブで、「保存」をクリックします。

11. 「起動」をクリックします。

10.9.2 WLSTを使用したMDS構成の変更

WLSTを使用して、アプリケーションのMDS構成を変更できます。次の例は、ReadOnlyMode属性を読み込んで設定するWLSTスクリプトを示しています。

"""
Getting ReadOnlyMode Attribute from MBean
"""
connect('username','password','hostname:port')
application = 'application_name'
attribute = 'ReadOnlyMode'
beanName = 'oracle.adf.share.config:ApplicationName='+ application +',name=MDSAppConfig,type=ADFConfig,Application='+ application +',ADFConfig=ADFConfig,*'

beanObjectName = ObjectName(beanName)
beans = mbs.queryMBeans(beanObjectName, None)
bean = beans.iterator().next().getObjectName()
custom()
value = mbs.getAttribute(bean, attribute)
print value

"""
Setting ReadOnlyMode Attribute from MBean
"""
attr = Attribute(attribute, Boolean(0))
mbs.setAttribute(bean,attr)
value = mbs.getAttribute(bean, attribute)
print value

"""
Saving the Changes. This is required to persist the changes.
"""

adfConfigName = 'oracle.adf.share.config:ApplicationName='+ application + ',name=ADFConfig,type=ADFConfig,Application='+ application + ',*'
adfConfigObjectName = ObjectName(adfConfigName)
adfConfigMBeans = mbs.queryMBeans(adfConfigObjectName, None)
adfConfigMBean = adfConfigMBeans.iterator().next().getObjectName()
mbs.invoke(adfConfigMBean, 'save', None, None)

10.9.3 アプリケーションの元のMDS構成のリストア

アプリケーションの元のMDS構成をリストアするには:

1. ファームを開いてから「アプリケーションのデプロイ」を開いて、アプリケーションのホーム・ページにナビゲートします。そこで、アプリケーションを選択します。
アプリケーションのホーム・ページが表示されます。

2. 「アプリケーションのデプロイ」メニューから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」ページが表示されます。

3. 「アプリケーション定義のMBean」→「oracle.adf.share.config」→「サーバー: 名前」→「アプリケーション: 名前」→「ADFConfig」→「ADFConfig」を開きます。

4. 「操作」タブを選択します。

5. RestoreToOriginalConfigurationを選択します。
操作: restoreToOriginalConfigurationページが表示されます。

6. 「起動」をクリックします。
この操作は注意して行ってください。これにより、元のadf-config.xmlファイルに行われたすべての変更が破棄されます。adf-config.xmlはベース・ドキュメントにリストアされます。

第V部

Oracle Fusion Middlewareの監視

この部では、エラー原因と修正アクションに関する情報の検索方法、システム・アクティビティの監視に役立つログ・ファイルの表示と管理の方法、問題の診断方法、およびOracle Fusion Middlewareの監視方法について説明します。

第V部は、次の章で構成されています。

- 第11章「Oracle Fusion Middlewareの監視」

- 第12章「ログ・ファイルと診断データの管理」

- 第13章「問題の診断」

11 Oracle Fusion Middlewareの監視

この章では、Fusion Middleware Control、Oracle WebLogic Server管理コンソールおよびコマンドラインを使用したOracle Fusion Middlewareの監視方法について説明します。次の項目について説明します。

- Oracle Fusion Middlewareのステータスの監視

- Oracle Fusion Middlewareのパフォーマンスの表示

- ルーティング・トポロジの表示

注意:

IBM Websphereでサーバーを管理する方法の詳細は、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドのIBM WebsphereでのOracle Fusion Middlewareの管理に関する項を参照してください。

11.1 Oracle Fusion Middlewareのステータスの監視

Oracle Fusion Middleware環境の状態の監視、およびパフォーマンスが最適であることの確認は、管理者の重要な作業です。

Oracle Fusion Middlewareでは、次の方法で環境のステータスを監視できます。

- Oracle WebLogic Server管理コンソール: Oracle WebLogic Serverドメイン、クラスタ、サーバー、Javaコンポーネント、およびアプリケーションのステータスを監視できます。管理コンソールからエンティティのページにナビゲートします。管理コンソールを使用して監視する方法の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの紹介』の管理コンソールの概要に関する項を参照してください。

- Fusion Middleware Control: Oracle WebLogic Serverドメイン、クラスタ、サーバー、Javaコンポーネント、システム・コンポーネントおよびアプリケーションのステータスを監視できます。Oracle HTTP Serverインスタンスのホーム・ページなどのエンティティのホーム・ページにナビゲートします。

- コマンドライン: WLSTまたはopmnctlコマンドラインを使用して環境のステータスを監視できます。
Javaコンポーネントのステータスを監視するには、次の形式でWLSTのstateコマンドを使用します。

state(name, type)

たとえば、管理対象サーバーserver1のステータスを確認する場合は、次のコマンドを使用します。

wls:/mydomain/serverConfig> state('server1','Server')
Current state of "server1": SUSPENDED

システム・コンポーネントのステータスを監視するには、次の形式でopmnctl statusコマンドを使用します。

opmnctl status [scope] [options]

たとえば、OPMNによって監視されるすべてのプロセスのステータスを表示する場合は、次のコマンドを使用します。

opmnctl status

この章のほとんどの監視タスクでは、Fusion Middleware Controlまたはコマンドラインを使用して監視する方法を説明します。

次の各項で、詳細を説明します。

- 一般情報の表示

- Oracle WebLogic Serverドメインの監視

- Oracle WebLogic Serverの管理サーバーや管理対象サーバーの監視

- クラスタの監視

- Javaコンポーネントの監視

- システム・コンポーネントの監視

- Java EEアプリケーションの監視

- ADFアプリケーションの監視

- SOAコンポジット・アプリケーションの監視

- Oracle WebCenter Portalアプリケーションの監視

- クラスタにデプロイされたアプリケーションの監視

11.1.1 一般情報の表示

Oracle Fusion Middleware環境の全体的なステータスは、Fusion Middleware Controlを使用して、ファームのホーム・ページから表示できます。このページには、すべてのコンポーネントの可用性とアプリケーション・デプロイのサマリーがリスト表示されます。SOAコンポジット・アプリケーションがデプロイされていれば、サマリーにはSOAコンポジットも表示されます。

全体的なステータスを表示するには、ナビゲーション・ペインでファームを選択します。

次の図のようにファームのホーム・ページが表示されます。

図status.gifの説明

このページには次の内容が表示されます。

- デプロイされたアプリケーションのリストおよびそれぞれのステータス

- ドメインのリスト、そのドメイン内のサーバー、メタデータ・リポジトリ、その他のOracle Fusion Middlewareエンティティ、およびそれぞれのステータス

- 関連ドキュメントへのリンクが表示されたリソース・センター

11.1.2 Oracle WebLogic Serverドメインの監視

また、Fusion Middleware Controlのドメインのホーム・ページでも、サーバー、クラスタ、ドメイン内のデプロイなどのドメインのステータスを表示できます。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメインを選択します。
次の図のようにドメインのホーム・ページが表示されます。

図domainpage.gifの説明

このページには次の内容が表示されます。

- ドメインの一般的なサマリーおよびOracle WebLogic Server管理コンソールへのリンク

- ドメイン内の管理サーバーと管理対象サーバーの両方に関する情報

- ドメイン内のクラスタに関する情報

- ドメイン内のデプロイに関する情報

- 詳細情報へのリンクが組み込まれたリソース・センター

関連項目:

Oracle WebLogic Server管理コンソールを使用したOracle WebLogic Serverドメインの監視の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの紹介』の管理コンソールの概要に関する項を参照してください。管理コンソールは、ドメインの健全性とパフォーマンスの詳細を提供します。

11.1.3 Oracle WebLogic Serverの管理サーバーや管理対象サーバーの監視

Fusion Middleware Controlで、WebLogic Serverの管理サーバーや管理対象サーバーのステータスを表示できます。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開き、そのドメインを開きます。

2. サーバーを選択します。
サーバーのホーム・ページが表示されます。

次の図は、管理対象サーバーのホーム・ページを示しています。

図serverpage.gifの説明

このページには次の内容が表示されます。

- サーバーのステータス、サーバーで実行されているサーブレット、JSPおよびEJBに関する情報を含む、サーバーの一般的なサマリー

- レスポンスと負荷

- サーバーにデプロイされているアプリケーションに関する情報

関連項目:

Oracle WebLogic Server管理コンソールを使用したサーバーの監視の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの紹介』の管理コンソールの概要に関する項を参照してください。管理コンソールは、サーバーの健全性とパフォーマンスの詳細を提供します。

11.1.4 クラスタの監視

Fusion Middleware Controlを使用して、クラスタ内のサーバーやデプロイメントを含めて、クラスタのステータスを表示できます。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開き、そのドメインを開きます。

2. クラスタを選択します。
次の図のようにクラスタ・ページが表示されます。

図cluster.gifの説明

このページには次の内容が表示されます。

- ブロードキャスト・チャネル、(必要に応じて)ロード・アルゴリズム、メッセージング・モードなど、クラスタの一般的なサマリー

- 1分当たりのリクエスト数とリクエスト処理時間を示すレスポンスと負荷セクション

- クラスタにデプロイされているアプリケーションに関する情報を示すデプロイ・セクション

- クラスタの一部となるサーバーを表で一覧表示するサーバー・セクション

関連項目:

Oracle WebLogic Server管理コンソールを使用したクラスタの監視の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの紹介』の管理コンソールの概要に関する項を参照してください。管理コンソールは、クラスタの健全性とパフォーマンスの詳細を提供します。

11.1.5 Javaコンポーネントの監視

Fusion Middleware Controlのコンポーネントのホーム・ページでは、コンポーネントが起動されているかどうかといったJavaコンポーネントのステータスを表示できます。

WebCenter Portal: SpacesなどのJavaコンポーネントを監視する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開き、コンポーネント・タイプで「WebCenter」を選択してから、たとえばポータル、スペースの順に開きます。

2. コンポーネントを選択します。たとえば、WebCenterスペースのインスタンスを選択します。
次の図のように、コンポーネントのホーム・ページが表示されます。

図comppage.gifの説明

このページには次の内容が表示されます。

- WebCenterポータル: スペースのメトリック

- CPUとメモリーの使用状況を示すグラフ

- WebLogic Serverのメトリックを示すグラフ

- セキュリティのメトリックを示すグラフ

- WebCenterポータル: スペース・サービスを示すグラフ

- 関連コンポーネント・セクション

- 関連ドキュメントへのリンクが表示されたリソース・センター

関連項目:

Oracle WebLogic Server管理コンソールを使用してJavaコンポーネントを監視する方法の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの紹介』の管理コンソールの概要に関する項を参照してください。

11.1.6 システム・コンポーネントの監視

Oracle HTTP Serverなどのシステム・コンポーネントを監視するには:

1. ナビゲーション・ペインで、ファームを開いてから、「Web層」を開きます。

2. ohs1などのコンポーネントを選択します。
次の図のように、コンポーネントのホーム・ページが表示されます。

図opmn_comppage.gifの説明

このページには次の内容が表示されます。

- 1秒当たりのリクエスト数とリクエスト処理時間が表示されたレスポンスと負荷のセクション

- CPU使用率およびメモリー使用量

- 仮想ホストと、その名前、リクエスト・スループットおよびレスポンス・サイズ

- モジュール・リクエスト統計と、モジュール一覧およびそれぞれのスループット(各モジュールの処理時間が表示された表)

- 関連ドキュメントへのリンクが表示されたリソース・センター

11.1.7 Java EEアプリケーションの監視

Fusion Middleware Controlを使用してJava EEアプリケーションを監視する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開き、「アプリケーションのデプロイ」を開いてから、監視するアプリケーションを選択します。
アプリケーションのホーム・ページが表示されます。

2. このページで、アプリケーションのステータスのサマリー、アプリケーションのエントリ・ポイント、アプリケーションに関連付けられているWebサービスおよびモジュール、レスポンスと負荷を確認できます。
次の図は、アプリケーションのホーム・ページの一部を示しています。

図app_home.gifの説明

このページには次の内容が表示されます。

- アプリケーションの状態、デプロイされている管理対象サーバーや、アクティブ・セッション、アクティブ・リクエスト、リクエストの処理時間の情報などのアプリケーションのサマリー

- WebモジュールおよびWebサービスなどのエントリ・ポイント

- モジュールとそれぞれのモジュール・タイプの一覧

- 1分当たりのリクエスト数とリクエスト処理時間を示すレスポンスと負荷

- 最も頻繁にリクエストされるサーブレット、JSPおよびWebサービスのリスト

11.1.8 ADFアプリケーションの監視

ADFアプリケーションを監視する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開き、「アプリケーションのデプロイ」を開いてから、監視するアプリケーションを選択します。
アプリケーションのホーム・ページが表示されます。

次の図は、アプリケーションのホーム・ページの一部を示しています。

adfapp.gifの説明

- アプリケーションの状態、デプロイされている管理対象サーバーや、アクティブ・セッション、アクティブ・リクエスト、リクエストの処理時間の情報などのアプリケーションのサマリー

- WebモジュールおよびWebサービスなどのエントリ・ポイント

- モジュールとそれぞれのモジュール・タイプの一覧

- 1分当たりのリクエスト数とリクエスト処理時間を示すレスポンスと負荷

- 最も頻繁にリクエストされるサーブレットおよびJSPのリスト

2. このページで、アプリケーションのステータスのサマリー、アプリケーションのエントリ・ポイント、アプリケーションに関連付けられているWebサービスおよびモジュール、レスポンスと負荷を確認できます。

3. アプリケーション・モジュール、アプリケーション・モジュール・プールおよびタスク・フローに関するパフォーマンス情報を表示するには、「アプリケーションのデプロイ」から「ADF」→「ADFパフォーマンス」を選択します。「ADFパフォーマンス」ページが表示されます。
アプリケーション・モジュール・プールのタブがあり、リクエスト、平均作成時間および空きインスタンスが表示されます。タスク・フローのタブもあり、リクエスト処理時間とアクティブなタスク・フローが表示されます。

11.1.9 SOAコンポジット・アプリケーションの監視

SOAコンポジット・アプリケーションを監視する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開き、「SOA」→「SOAインフラ」を開きます。監視するアプリケーションを選択します。
アプリケーションのホーム・ページが表示されます。

2. このページでは、実行中のインスタンス、フォルト・メッセージと拒否メッセージ、およびコンポーネント・メトリックを監視できます。
次の図は、SOAコンポジットのホーム・ページの一部を示しています。

図soa_app.gifの説明

この図では、ページ内の「ダッシュボード」タブが選択され、次の項目が示されています。

- 最新のインスタンス

- 最新のフォルト・メッセージと拒否メッセージ

- コンポーネント・メトリック

11.1.10 Oracle WebCenter Portalアプリケーションの監視

Oracle WebCenter Portal: Frameworkアプリケーションを監視する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開き、「アプリケーションのデプロイ」を開いてから、監視するアプリケーションを選択します。
アプリケーションのホーム・ページが表示されます。

2. このページで、アプリケーションのステータスのサマリー、アプリケーションのエントリ・ポイント、アプリケーションに関連付けられているWebサービスおよびモジュール、レスポンスと負荷を確認できます。
図webctr_app.gifの説明

3. 一部のアプリケーションでは、サービス・メトリックを表示できます。「アプリケーション・デプロイメント」メニューで、「WebCenterポータル」→「サービス・メトリック」を選択します。
次の図は「サービス・メトリック」ページを示しています。

図webcenter_app.gifの説明

このページには、各サービスのステータスおよび呼出しとともに、WebCenterサービス・メトリックのサマリーが表示されます。

関連項目:

- Spacesアプリケーションの監視の詳細は、Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイドのSpacesアプリケーションのホーム・ページへの移動に関する項を参照してください。

- サービス・メトリックの詳細は、『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のWebCenter Portalパフォーマンス・メトリックの理解に関する説明を参照してください。

11.1.11 クラスタにデプロイされたアプリケーションの監視

アプリケーションをクラスタにデプロイする場合、Oracle Fusion Middlewareでは、アプリケーションがクラスタ内の各管理対象サーバーに自動的にデプロイされます。そのため、各サーバーにはアプリケーションのインスタンスがあります。

個々のサーバーのアプリケーションのパフォーマンスを監視したり、クラスタ内のすべてのサーバーにわたってアプリケーションの全体的なパフォーマンスを監視することが必要になる場合があります。

たとえば、通常は、アプリケーションの全体的なパフォーマンスを管理して、ユーザーがどのインスタンスにアクセスしているかに関係なく、アプリケーションのすべてのユーザーに影響するパフォーマンスの問題が発生していないかどうかを確認します。パフォーマンスの問題に気付いたら、アプリケーションの具体的なインスタンスを掘り下げて、その問題の影響を受けているのが、クラスタ内のアプリケーション・インスタンスの1つなのかすべてなのかを確認します。

Fusion Middleware Controlでは、その両方のシナリオに対して監視ページが用意されています。

1. ナビゲーション・ペインで、ファームを開いて、「アプリケーションのデプロイ」を開きます。
Fusion Middlewareでは、現在のドメインにデプロイされているアプリケーションが一覧表示されます。

アプリケーションがクラスタにデプロイされている場合、Fusion Middleware Controlではアプリケーションの横に、クラスタにアプリケーションのインスタンスが複数あることを示すプラス記号(+)が表示されます。

2. クラスタ・アプリケーションを開くと、次の図のように、アプリケーションの各インスタンスが表示されます。
図fmc_nav_cluster_app.gifの説明

3. クラスタ・アプリケーションをクリックしてクラスタ上のアプリケーションの全体的なパフォーマンスを監視するか、またはアプリケーション・デプロイ・インスタンスのいずれかをクリックして1つのサーバー上のアプリケーションのパフォーマンスを監視します。

11.2 Oracle Fusion Middlewareのパフォーマンスの表示

アプリケーションの実行速度の低下やハングなどの問題が発生した場合は、特定のターゲットのパフォーマンス・メトリックなど、パフォーマンスの詳細情報を表示して、問題の詳細を調べることができます。

Oracle Fusion Middlewareは、ランタイム・パフォーマンスを継続的に自動測定します。パフォーマンス・メトリックは自動的に有効化されるため、メトリックの収集のためにオプションを設定したり、追加の構成を実行する必要はありません。

Fusion Middleware Controlでは、リアルタイムのデータが表示されます。履歴データの表示が必要な場合は、Oracle Enterprise Manager Grid Controlの使用を検討してください。

たとえば、Oracle WebLogic Serverの管理対象サーバーのパフォーマンスを表示する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開き、そのドメインを開きます。

2. 監視するサーバーを選択します。
管理対象サーバーのホーム・ページが表示されます。

3. 「WebLogic Server」メニューで、「パフォーマンス・サマリー」を選択します。
「パフォーマンス・サマリー」ページが表示されます。Oracle WebLogic Serverにデプロイされているアプリケーションのパフォーマンス・メトリックと、レスポンス時間およびリクエスト処理時間に関する情報が表示されます。

4. 追加メトリックを表示するには、「メトリック・パレットの表示」をクリックして、メトリック・カテゴリを開きます。
次の図は、メトリック・パレットが表示された「パフォーマンス・サマリー」ページです。

図metrics.gifの説明

5. メトリックを選択して、パフォーマンス・サマリーに追加します。

6. 別のターゲットをオーバーレイするには、「オーバーレイ」をクリックして、そのターゲットを選択します。このターゲットはチャートに追加され、複数のターゲットのパフォーマンスを一度に表示して比較できるようになります。

7. チャートごとに表示される時間フレームをカスタマイズするには、次の処理を実行します。

- 「スライダ」をクリックして、スライダ・ツールを表示します。これを使用すると、チャートに表示される時間を伸縮できます。たとえば、表示範囲を直前の15分から10分に変更する場合、左側のスライダ・コントロールを、直前の10分間が表示されるようになるまで右にスライドさせます。

- カレンダと時計アイコンを選択します。次に、「開始時間」と「終了時間」を入力します。このような時間に関して利用可能なデータがない場合、確認メッセージが表示され、このデータが利用可能な期間へと時系列が自動的に調整されることが説明されます。

Oracle HTTP ServerやOracle SOA Suiteなどのコンポーネントのパフォーマンスも表示できます。目的のコンポーネントにナビゲートして「監視」を選択し、動的ターゲット・メニューから「パフォーマンス・サマリー」を選択します。

11.3 ルーティング・トポロジの表示

Fusion Middleware Controlには、ファームのトポロジ・ビューアが用意されています。トポロジ・ビューアは、コンポーネント間およびファームの要素間のルーティング関係をグラフィカルに表したものです。リクエストがコンポーネント間でどのようにルーティングされているかを容易に確認できます。たとえば、Oracle Web CacheからOracle HTTP Server、管理対象サーバー、データソースに、リクエストがどのようにルーティングされるかがわかります。

注意:

Oracle WebLogic Server、Oracle Web Cache、Oracle HTTP Serverの関係を表示するには、各ターゲットが稼働中で、ステータスが「稼働中」と表示されている必要があります。

トポロジ・ビューアを使用すると、Oracle Fusion Middleware環境の監視が容易になります。どのエンティティが稼働中でどのエンティティが停止しているかを確認できます。

トポロジを印刷することもできます。

トポロジを表示する手順は次のとおりです。

1. 次の図のように、「トポロジ」をクリックします。
図topo_link.gifの説明

別のウィンドウに「トポロジ・ビューア」が表示されます。

2. 特定のターゲットに関する情報を表示するには、そのターゲットにマウスを合せます。追加情報を表示するには、「詳細」をクリックします。
次の図は、「トポロジ・ビューア」ウィンドウを示すもので、管理対象サーバーsoa_server1に関する情報が表示されています。

図topoview.gifの説明

トポロジ・ビューアでは、次の処理を実行することもできます。

- ルーティングをグループ化する方法を選択します。「表示」メニューで、Middlewareによって、またはアプリケーションによってグループ化することを選択できます。

- 表示するノード・タイプを選択します。「ノードの表示」メニューから、ノード・タイプ(データソースなど)を選択します。

- ステータスごとのターゲットの表示。ページの上部にある、緑の上矢印キーまたは赤の下矢印キーをクリックします。指定のステータスが示されたターゲットのリストが表示されます。

- トポロジ内でターゲットを検索します。これにより、ターゲット数が多い場合でもターゲットを簡単に見つけることができます。「検索」ボックスに名前を入力し、「検索」をクリックします。
「検索結果」ボックスが表示されます。ターゲットを強調表示するには、ターゲット名をクリックします。トポロジが再配置され、以前は表示領域内に表示されていなかったターゲットを確認できるようになります。

また、検索の条件を指定することもできます。「検索」から、1つ以上の「ステータス」のタイプ、または1つ以上の「ターゲット・タイプ」、あるいはその両方を選択します。

- ステータスまたはメトリックを非表示または表示にします。「注釈」で、「ステータス」または「メトリック」をクリックします。
「メトリック」を選択した場合は、コンポーネントの主要なパフォーマンス・メトリックが1つ表示されます(表示されるメトリックは変更できません)。

- トポロジを再配置し、その向きを変更します。

- 向きを変更するには、「オプション」メニューから、「レイアウト」→「左から右」または「トップ・ダウン」を選択します。

- トポロジを再配置するには、トポロジをクリックします。ただし、ターゲットまたはルート以外の場所をクリックしてください。トポロジをドラッグして配置します。

- トポロジ・ビューアに表示される内容を変更するには、「オプション」メニューから、「ナビゲータの表示/非表示」を選択します。その後、ナビゲータ・ウィンドウで、右下にある影付きセクションをドラッグします。

- ターゲットのホーム・ページへのナビゲート。ターゲットを右クリックして、「ホーム」を選択します。

- 操作は、ターゲット上で右クリックして直接実行します。右クリック・ターゲット・メニューが表示されます。たとえば、このメニューから、Oracle WebLogic Serverを起動または停止したり、追加のパフォーマンス・メトリックを表示できます。

- コンポーネント間のルーティング関係の表示。たとえば、Oracle Web CacheからOracle HTTP Server、Oracle WebLogic Serverへのルーティングを表示できます。2つのターゲットの間にある線をクリックすると、使用されるURLが表示されます。

- 「リフレッシュ」ドロップダウンから、ステータスおよびメトリックを、手動でリフレッシュすることも、毎分、5分ごと、または30分ごとに自動的にリフレッシュすることもできます。デフォルトでは、メトリックは5分ごとにリフレッシュされます。

注意:

- Mozilla Firefoxを使用している場合は、トポロジ・ビューア内のリンクまたはメニュー・アイテムをクリックすると、動作はFusion Middleware Controlのメイン・ウィンドウに戻りますが、フォーカスがメイン・ウィンドウに戻るとはかぎりません。たとえば、ターゲット・ノードを右クリックしてターゲット・メニューから「ログ・メッセージの表示」を選択しても、フォーカスはトポロジ・ビューアのウィンドウに残ったままになります(メイン・ウィンドウに戻ると、「ログ・メッセージ」ページが正しく表示されます)。
この問題が発生しないようにするには、Firefoxで次の変更を行います。

「ツール」メニューから、「オプション」→「コンテンツ」を選択します。「詳細設定」をクリックします。「JavaScriptの詳細設定」ダイアログ・ボックスで、「ウィンドウのフォーカス(前面か背面か)を切り替える」を選択します。

- Internet Explorerを使用する場合、「常に新しいタブでポップアップを開く」オプションをオフにします。

12 ログ・ファイルと診断データの管理

Oracle Fusion Middlewareコンポーネントは、起動および停止情報、エラー、警告メッセージ、HTTPリクエスト時のアクセス情報など、すべての種類のイベントを記録するメッセージが格納されたログ・ファイルを生成します。この章では、エラー原因と修正アクションに関する情報の検索方法、システム・アクティビティの監視および問題の診断に役立つログ・ファイルの表示と管理の方法について説明します。

次の項目が含まれます。

- Oracle Fusion Middlewareのロギングの概要

- ODLメッセージとODLログ・ファイルについて

- ログ・ファイルの表示と検索

- ログ・ファイルの設定の構成

- ログ・ファイルおよびコンポーネント間のメッセージの関連付け

- トレースの構成

注意:

IBM Websphereでロギングする方法の詳細は、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドのIBM WebsphereでのOracle Fusion Middlewareのロギングの構成に関する項を参照してください。

12.1 Oracle Fusion Middlewareのロギングの概要

大部分のOracle Fusion Middlewareコンポーネントでは、Oracle Diagnostic Logging(ODL)形式で診断ログ・ファイルが作成されます。ログ・ファイルの名前とログ・ファイルの内容の形式は、Oracle標準に準拠します。デフォルトでは、診断メッセージはテキスト形式で書き込まれます。

ODLには次の利点があります。

- 保存される診断情報の合計サイズを制限します。保存される情報のレベルを設定したり、ログ・ファイルおよびログ・ファイル・ディレクトリの最大サイズを指定できます。

- 指定サイズに達すると、古いセグメント・ファイルが削除され、新しいセグメント・ファイルが時系列で保存されます。

- コンポーネントがアクティブな状態で古い診断ログ・ファイルを削除でき、停止する必要がありません。

ログ・ファイルは、Fusion Middleware ControlまたはWLST displayLogsコマンドを使用して表示できます。また、ログ・ファイルをローカル・クライアントにダウンロードして、他のツール(テキスト・エディタおよびその他のファイル表示ユーティリティ)を使用して表示することもできます。

注意:

Oracle WebLogic Serverは、ODL形式を使用しません。Oracle WebLogic Serverのログ形式については、『Oracle Fusion Middleware Oracle WebLogic Serverログ・ファイルの構成とログ・メッセージのフィルタ処理』を参照してください。

12.2 ODLメッセージおよびODLログ・ファイルについて

ODLを使用すると、診断メッセージがログ・ファイルに書き込まれ、メッセージのそれぞれに、時間、コンポーネントID、ユーザーなどの情報が組み込まれます。

次の例は、Oracle SOA SuiteでのODL形式のエラー・メッセージを示しています。

[2010-09-23T10:54:00.206-07:00] [soa_server1] [NOTIFICATION] [] [oracle.mds]
[tid: [STANDBY].ExecuteThread: '1' for queue: 'weblogic.kernel.Default
(self-tuning)'] [userId: <anonymous>] [ecid: 0000I3K7DCnAhKB5JZ4Eyf19wAgN000001,0]
[APP: wsm-pm] "Metadata Services: Metadata archive (MAR) not found."

このメッセージでは、フィールドが次の属性にマップされています。これらについては表12-1で説明します。

- タイムスタンプ、開始: 2010-09-23T10:54:00.206-07:00

- 組織ID: soa_server1

- メッセージ・タイプ: NOTIFICATION

- コンポーネントID: oracle.mds

- スレッドID: tid: [STANDBY].ExecuteThread: '1' for queue: 'weblogic.kernel.Default (self-tuning)'

- ユーザーID: userId: <anonymous>

- 実行コンテキストID: ecid: 0000I3K7DCnAhKB5JZ4Eyf19wAgN000001,0

- サプリメンタル属性: APP: wsm-pm

- メッセージ・テキスト: "Metadata Services: Metadata archive (MAR) not found."

デフォルトでは、情報はログ・ファイルにODLテキスト形式で書き込まれます。この形式は、第12.4.4項で説明するように、ODL XML形式に変更できます。

表12-1は、ODLメッセージの内容の説明です。コンポーネントによっては、生成された診断メッセージにオプションの属性が存在しない場合があります。

表12-1 ODL形式メッセージのフィールド

属性名

説明

必須

タイムスタンプ、開始(TIME)

メッセージが生成された日時。ローカル・タイムゾーンが反映されます。

はい

タイムスタンプ、正規化済(time_norm)

ホスト間のクロックのずれの調整用に標準化されたタイムスタンプ。診断メッセージが別のホスト上のリポジトリにコピーされる場合に使用します。

いいえ

組織ID(org_id)

作成元のコンポーネントの組織ID。

いいえ

INSTANCE_ID
(INST_ID)

メッセージを生成したコンポーネントが属するOracleインスタンスの名前。

いいえ

COMPONENT ID (COMP_ID)

メッセージを生成したコンポーネントのID。

はい

MESSAGE_ID(MSG_ID)

コンポーネント内でメッセージを一意に識別するID。IDは、コンポーネントを示す接頭辞、およびそれに続くダッシュと5桁の数値で構成されます。次に例を示します。

OHS-51009

はい

MESSAGE_TYPE
(MSG_TYPE)

メッセージのタイプ。使用可能な値は、INCIDENT_ERROR、ERROR、WARNING、NOTIFICATION、TRACEおよびUNKNOWNです。メッセージ・タイプの詳細は、表12-3を参照してください。

はい

MESSAGE_LEVEL(MSG_LEVEL)

メッセージ・レベル。メッセージ・タイプを限定する整数値で示されます。使用可能な値は1(最高重大度)から32(最低重大度)です。メッセージ・レベルの詳細は、表12-3を参照してください。

はい

HOST_ID(HOST_ID)

メッセージを生成したホストの名前。

いいえ

HOST_NW_ADDR(HOST_ADDR)

メッセージを生成したホストのネットワーク・アドレス。

いいえ

MODULE_ID(MODULE)

メッセージを生成したモジュールのID。コンポーネントが単独のモジュールの場合は、この属性にコンポーネントIDが表示されます。

はい

PROCESS_ID(PID)

メッセージに関連付けられたプロセスまたは実行単位のプロセスID。

いいえ

THREAD_ID(TID)

メッセージを生成したスレッドのID。

いいえ

USER_ID(USER)

メッセージを生成した実行コンテキストを所有するユーザーの名前。

いいえ

ECID

実行コンテキストID(ECID)。生成コンポーネントが関与する特定のリクエストの実行のグローバル一意識別子。ECIDは、別のコンポーネントで発生したエラー・メッセージの関連付けに使用できます。ECIDの詳細は、第12.5項を参照してください。

はい

RID

関係ID(RID)。1つのリクエストにおいて、特定のプロセス上の特定スレッドで実行された作業と、同じプロセスの別のスレッドおよび別プロセス上で実行された作業を区別します。RIDの詳細は、第12.5項を参照してください。

いいえ

SUPPL_ATTRS

イベントに関するコンポーネント固有の属性を格納する名前/値のペアが記載された追加リスト。

Oracle Fusion Middlewareでは、サプリメンタル属性DSID(診断セッションID)が提供されています。DSIDはユーザー・セッションのIDであり、一連のログ・メッセージ、インシデントおよびその他の診断データをユーザー・セッションにマップするために使用されます。たとえば、ユーザー・セッションで生成された特定のインシデントの前に同じセッション内で別のインシデントが生成されていたかどうか、またそれらが後に続いたインシデントの原因であったかどうかを確認できます。

いいえ

MESSAGE TEXT(TEXT)

メッセージのテキスト。

はい

メッセージ引数(arg)

メッセージ・テキストにバインドされた引数のリスト。

いいえ

追加詳細

イベントの追加情報で、メッセージ・テキストより詳細な情報が含まれます。

いいえ

ログ・ファイルの場所は、コンポーネントのタイプによって異なります。

- ほとんどのJavaコンポーネントのログ・ファイルは、次の場所にあります。

(UNIX) DOMAIN_HOME/servers/server_name/logs
(Windows) DOMAIN_HOME\servers\server_name\logs

ログ・ファイルのデフォルト名は、server-name-diagnostic.logです。

- システム・コンポーネントのログ・ファイルは、デフォルトでは次の場所にあります。

(UNIX) ORACLE_INSTANCE/diagnostics/logs
(Windows) ORACLE_INSTANCE\diagnostics\logs

表12-2に、Oracle Fusion Middlewareのコンポーネントのログ・ファイルの場所を示します。

この表では、DOMAIN_HOMEはドメイン・ホームを表しています。

この表で、ORACLE_INSTANCEは次のディレクトリを表しています。これは、Oracleインスタンス・ホームです。

MW_HOME/instance_name

表12-2 ログ・ファイルの場所

コンポーネント

ログ・ファイルの場所

Fusion Middleware Control

DOMAIN_HOME/sysman/log/emoms.log
DOMAIN_HOME/sysman/log/emoms.trc

Oracle Application Development Framework

DOMAIN_HOME/servers/server_name/logs/server-name-diagnostic.log

Oracle Business Activity Monitoring

DOMAIN_HOME/servers/server_name/logs/bam-diagnostic.log

Oracle Business Intelligence Discoverer

DOMAIN_HOME/servers/server_name/logs/discoverer/server/diagnostic.log
DOMAIN_HOME/servers/server_name/logs/discoverer/server_name-diagnostic.log
DOMAIN_HOME/servers/server_name/logs/discoverer/diagnostic.log

Oracle Business Process Management

DOMAIN_HOME/servers/server_name/logs/server-name-diagnostic.log

Oracle Directory Integration Platform

DOMAIN_HOME/servers/server_name/logs/server-name-diagnostic.log

Oracle Forms Services

DOMAIN_HOME/servers/server_name/logs/server-name-diagnostic.log
ORACLE_HOME/j2ee/DevSuite/application-deployments/forms/application.log
ORACLE_INSTANCE/diagnostics/logs/FormsComponent/forms/*
ORACLE_INSTANCE/diagnostics/logs/FRComponent/dejvm/*

Oracle Fusion Middleware監査フレームワーク

DOMAIN_HOME/servers/server_name/logs/server-name-diagnostic.log

Oracle HTTP Server

ORACLE_INSTANCE/diagnostics/logs/OHS/component_name/*.log

Oracle Identity Federation

DOMAIN_HOME/servers/server_name/logs/server-name-diagnostic.log

Oracle WebCenter Content: Imaging

DOMAIN_HOME/servers/server_name/logs/server-name-diagnostic.log

Oracle Information Rights Management

DOMAIN_HOME/servers/server_name/logs/server-name-diagnostic.log

Oracle Internet Directory

ORACLE_INSTANCE/diagnostics/logs/OID/component_name/oid*.log
ORACLE_INSTANCE/diagnostics/logs/OID/tools/*.log

Oracle Platform Security Services

DOMAIN_HOME/servers/server_name/logs/server-name-diagnostic.log

Oracle Portal

DOMAIN_HOME/servers/server_name/logs/server-name-diagnostic.log
ORACLE_INSTANCE/diagnostics/logs/portal

Oracle Reports

ORACLE_INSTANCE/diagnostics/logs/ReportsServerComponent/component_name/*
ORACLE_INSTANCE/diagnostics/logs/ReportsBridgeComponent/component_name/*
ORACLE_INSTANCE/diagnostics/logs/ReportsToolsComponent/component_name/*

Oracle SOA Suite

DOMAIN_HOME/servers/server_name/logs/server-name-diagnostic.log

Oracle TopLink

DOMAIN_HOME/servers/server_name/logs/server-name-diagnostic.log

Oracle Virtual Directory

ORACLE_INSTANCE/diagnostics/logs/OVD/component_name/diagnostic.log

Oracle Web Cache

ORACLE_INSTANCE/diagnostics/logs/WebCache/component_name*.log

Oracle Web Services Manager

DOMAIN_HOME/servers/server_name/logs/owsm/msglogging
DOMAIN_HOME/servers/server_name/logs/owsm-diagnostic.log

Oracle WebCenter Portal

DOMAIN_HOME/servers/server_name/logs/server-name-diagnostic.log

Oracle WebLogic Server

DOMAIN_HOME/servers/server_name/logs/server-name-diagnostic.log

リポジトリ作成ユーティリティ

デフォルトでは、RCU_LOG_LOCATIONで指定されたファイルに書き込みます。指定されていない場合は、次の場所に書き込もうとします。

1. ORACLE_HOME/rcu/log/timestamp

2. /tmp/logdir.timestamp

12.3 ログ・ファイルの表示と検索

Oracle Fusion Middlewareコンポーネントをまたがって、ログ・ファイルの表示、リスト表示、および検索ができます。Fusion Middleware Controlを使用してログ・ファイルの表示や検索を行い、ログ・ファイルをローカル・クライアントにダウンロードし、別のツールを使用して表示することができます。また、WLSTコマンドライン・ツールを使用してログ・ファイルをリスト表示、表示および検索することもできます。

この項の項目は次のとおりです。

- ログ・ファイルおよびそのメッセージの表示

- ログ・ファイルの検索

- ログ・ファイルのダウンロード

WLSTコマンドを使用してログ・ファイルを表示する場合は、次の点に注意してください。

- カスタムWLSTロギング・コマンドを使用するには、Oracle共通ホームからWLSTスクリプトを起動する必要があります。詳細は、第3.5.1.1項を参照してください。

- ログ表示コマンドは、Weblogic Serverに接続していても接続していなくても機能します。接続していない場合は、oracleInstanceパラメータでパスを指定する必要があります。WebLogicドメイン・ホームとOracleインスタンスのいずれかを指定します。

- WLSTロギング・コマンドは、多くの場合、domainRuntimeツリーで実行する必要があります。たとえば、domainRuntimeツリーに接続して実行する場合は、次のWLSTコマンドを使用します。

connect('username', 'password', 'localhost:port_number')
domainRuntime()

関連項目:

Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスのカスタムWLSTコマンドのロギングに関する項

12.3.1 ログ・ファイルおよびそのメッセージの表示

次の各項で説明するように、Fusion Middleware ControlまたはWLSTコマンドを使用して、ログ・ファイルを表示できます。

- Fusion Middleware Controlを使用したログ・ファイルおよびそのメッセージの表示

- WLSTを使用したログ・ファイルおよびそのメッセージの表示

12.3.1.1 Fusion Middleware Controlを使用したログ・ファイルおよびそのメッセージの表示

特定のドメイン、Oracle WebLogic Server、コンポーネントまたはアプリケーションのすべてのエンティティのメッセージを表示できます。

たとえば、管理対象サーバーのログ・ファイルおよびメッセージを表示する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開き、そのドメインを開きます。管理対象サーバーの名前を右クリックし、「ログ」→「ログ・メッセージの表示」を選択します。
「ログ・メッセージ」ページが表示されます。

2. 「選択したターゲット」を開き、特定のコンポーネントまたはアプリケーションの行で「ターゲット・ログ・ファイル」をクリックします。
「ログ・ファイル」ページが表示されます。このページには、次の図に示すように管理対象サーバーに関連するログ・ファイルのリストが表示されます。

図viewlog.gifの説明

3. ファイルを選択して、「ログ・ファイルの表示」をクリックします。
「ログ・ファイルの表示」ページが表示されます。このページに、メッセージのリストが表示されます。

4. メッセージの詳細を表示するには、該当するメッセージを選択します。
次の図のように、リストの下のペインに詳細が表示されます。

図viewlog2.gifの説明

デフォルトでは、メッセージは時間を基準として昇順でソートされます。メッセージは、列名をクリックすることにより、メッセージ・タイプなどの任意の列を基準としてソートできます。

5. 時間またはECIDを基準にして関連メッセージを表示するには、「関連メッセージの表示」をクリックして、「時間ごと」または「ECID(実行コンテキストID)ごと」を選択します。
「関連メッセージ」ページが表示されます。

12.3.1.2 WLSTを使用したログ・ファイルおよびそのメッセージの表示

WLST listLogsコマンドを使用して、Oracle WebLogic Serverドメイン、サーバー、Oracleインスタンスまたはコンポーネントのログ・ファイルをリスト表示できます。

このコマンドは、接続中も切断中も使用できます。接続時のデフォルトのターゲットは、Oracle WebLogic Serverドメインです。

ログ・ファイルをリスト表示するには、第12.3項の説明に従って、まずdomainRuntimeコマンドを使用します。次に、ログ・ファイルのリスト表示方法および表示方法について説明します。

- Oracle WebLogic Server soa_server1のすべてのログ・ファイルをリスト表示する場合は、次のコマンドを使用します。

listLogs(target='server_soa')

file://host/scratch/Oracle/config/domains/SOA_domain/servers/soa_server1/logs/soa_server1.log
2010-09-17 16:40:45                    4.9M soa_server1.log00001
2010-09-17 18:35:35                    4.9M soa_server1.log00002
2010-09-17 20:30:25                    4.9M soa_server1.log00003
...
file://host/scratch/Oracle/config/domains/SOA_domain/servers/soa_server1/logs/soa_server1-diagnostic.log
2010-09-22 13:53:32                     10M soa_server1-diagnostic-22.log
2010-09-22 19:18:32                     10M soa_server1-diagnostic-23.log
2010-09-23 00:42:32                     10M soa_server1-diagnostic-24.log
2010-09-23 06:07:32                     10M soa_server1-diagnostic-25.log
2010-09-23 11:31:32                     10M soa_server1-diagnostic-26.log
2010-09-23 16:56:32                     10M soa_server1-diagnostic-27.log
2010-09-23 22:20:32                     10M soa_server1-diagnostic-28.log
2010-09-24 03:45:32                     10M soa_server1-diagnostic-29.log
2010-09-24 09:11:32                     10M soa_server1-diagnostic-30.log
2010-09-24 14:08:32                    9.2M soa_server1-diagnostic.log
...

- Oracleインスタンスasinst_1のOracle HTTP Server ohs1のログをリスト表示するには、次のコマンドを使用します。

listLogs(target='opmn:asinst_1/ohs1')

- 切断時にログをリスト表示するには、oracleInstanceパラメータを指定し、これをOracle WebLogic Serverドメインか、システム・コンポーネントのOracleインスタンス・ホームのいずれかのパスに渡す必要があります。たとえば、管理対象サーバーsoa_server1のログ・ファイルをリスト表示するには、次のコマンドを使用します。

listLogs(oracleInstance='/scratch/Oracle/config/domains/SOA_domain',
target='soa_server1')

- ログ・ファイルの診断メッセージを表示するには、WLST displayLogsコマンドを使用します。このコマンドは、接続時も切断時も機能します。
たとえば、Oracle WebLogic Serverドメインで直前の10分以内にログ・ファイルに生成されたメッセージを表示するには、次のコマンドを使用します。

displayLogs(last=10)

[2010-09-05T08:05:29.652-07:00] [soa_server1] [NOTIFICATION] [BEA-000628]
[Common] [host: hostname] [nwaddr: 10.229.149.27] [tid:
[ACTIVE].ExecuteThread: '10' for queue: 'weblogic.kernel.Default
(self-tuning)'] [userId: <WLS Kernel>] [TARGET: /SOA_domain/soa_server1]
[LOG_FILE: /scratch//Oracle/config/domains/SOA_
domain/servers/soa_server1/logs/soa_server1.log] Created "1" resources for
pool "SOADataSource", out of which "1" are available and "0" are unavailable.
[2010-09-05T08:05:29.673-07:00] [soa_server1] [NOTIFICATION] [BEA-000628]
[Common] [host: hostname] [nwaddr: 10.229.149.27] [tid: oracle.integration.platform.blocks.executor.WorkManagerExecutor$1@17f5105]
[userId: <anonymous>] [TARGET: /SOA_domain/soa_server1] [LOG_FILE:
/scratch/Oracle/config/domains/SOA
_domain/servers/soa_server1/logs/soa_server1.log] Created "1" resources for
pool "SOADataSource", out of which "1" are available and "0" are unavailable.
[2010-09-05T08:05:30.448-07:00] [soa_server1] [NOTIFICATION] [BEA-001128]
[JDBC] [host: hostname] [nwaddr: 10.229.149.27] [tid:
oracle.integration.platform.blocks.executor.WorkManagerExecutor$1@17f5105]
[userId: <anonymous>] [TARGET: /SOA_domain/soa_server1] [LOG_FILE:
/scratch/Oracle/config/domains/SOA
_domain/servers/soa_server1/logs/soa_server1.log] Connection for pool
"SOADataSource" closed.

このコマンドでは、時間を基準に昇順でソートされたメッセージが返されます。

- Oracleインスタンスasinst_1のOracle HTTP Server ohs1のログ・ファイルを表示するには、次のコマンドを使用します。

displayLogs(target='opmn:asinst_1/ohs1')

メッセージは、第12.3.2項で説明されているように、特定の基準を指定して検索し、出力をソートできます。

関連項目:

listLogsコマンドおよびdisplayLogsコマンドの詳細は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスのカスタムWLSTコマンドのロギングに関する項を参照してください。

12.3.2 ログ・ファイルの検索

次の各項で説明するように、Fusion Middleware ControlまたはWLSTコマンドを使用すると、時間、メッセージのタイプおよび特定のログ・ファイル属性を基準にして診断メッセージを検索できます。

- Fusion Middleware Controlを使用したログ・ファイルの検索

- WLSTを使用したログ・ファイルの検索

12.3.2.1 Fusion Middleware Controlを使用したログ・ファイルの検索

Fusion Middleware Controlの「ログ・メッセージ」ページでは、標準および追加のODL属性を使用して診断メッセージを検索できます。デフォルトで、このページには、直前1時間にログに記録された問題のサマリーが表示されます。

検索基準は、適合度の高いメッセージが特定されるように変更できます。検索結果を別のモードで表示すると、大量のデータを簡単にナビゲーションできます。

次の各項では、ログ・ファイルの検索方法を説明します。

- ログ・ファイルの検索: 基本検索

- ログ・ファイルの検索: 拡張検索

12.3.2.1.1 ログ・ファイルの検索: 基本検索

この項では、ログ・メッセージの基本検索の方法について説明します。

特定のドメイン、Oracle WebLogic Server、コンポーネントまたはアプリケーションのすべてのエンティティのすべてのメッセージを検索できます。

たとえば、特定のドメインのメッセージを検索する手順は次のとおりです。

1. 「WebLogicドメイン」メニューで、「ログ」→「ログ・メッセージの表示」を選択します。
特定のコンポーネントまたはアプリケーションのメッセージを検索するには、目的のコンポーネントまたはアプリケーションを選択します。そのターゲットのメニューで、「ログ」→「ログ・メッセージの表示」を選択します。

「ログ・メッセージ」ページに、次の図のように「検索」セクションと直前1時間のメッセージのサマリーが記載された表が表示されます。

図logsearch.gifの説明

2. 「日付範囲」セクションでは、次のいずれかを選択できます。

- 最新: このオプションを選択した場合は、3時間などの時間を選択します。デフォルトは1時間です。

- 時間間隔: このオプションを選択した場合は、「開始日」のカレンダ・アイコンを選択します。日付および時刻を選択します。次に、「終了日」のカレンダ・アイコンを選択します。日付および時刻を選択します。

3. 「メッセージ・タイプ」セクションで、1つ以上のメッセージ・タイプを選択します。タイプについては、表12-3を参照してください。

4. 第12.3.2.1.2項の説明に従って、詳細な検索条件を指定できます。

5. 「検索」をクリックします。

6. 適合性の高いメッセージを特定しやすくするため、表内の「表示」で次のモードのいずれかを選択します。

- メッセージ: 一致するメッセージを表示します。
特定のメッセージの詳細を表示するには、該当するメッセージをクリックします。メッセージの表の下に詳細が表示されます。

関連するメッセージを表示するには、メッセージを選択して「関連メッセージの表示」をクリックし、「時間ごと」または「ECID(実行コンテキストID)ごと」を選択します。

- メッセージ・タイプ別グループ: ターゲット・レベルのメッセージ・タイプを基準としてメッセージをグループ化し、一致するメッセージのサマリーを表示します。これはデフォルトのモードです。
メッセージを表示するには、いずれかのメッセージ・タイプの列の件数をクリックします。「メッセージ、タイプ別」ページが表示されます。特定のメッセージの詳細を表示するには、該当するメッセージをクリックします。メッセージの表の下に詳細が表示されます。

- メッセージID別グループ: ターゲット・レベルのメッセージID、メッセージ・タイプおよびモジュールIDを基準としてメッセージをグループ化し、一致するメッセージのサマリーを表示します。
関連するメッセージを表示するには、「発生」列の件数をクリックします。メッセージ、メッセージID別ページが表示されます。特定のメッセージの詳細を表示するには、該当するメッセージをクリックします。メッセージの表の下に詳細が表示されます。

12.3.2.1.2 ログ・ファイルの検索: 拡張検索

この項では、利用できる拡張検索メカニズムの一部について説明します。

検索基準は、「ログ・メッセージ」ページの次のコントロールを使用して絞り込むことができます。

- メッセージ: 「次を含む」などの演算子を選択し、比較する値を入力できます。

- フィールドの追加: クリックすると、ホストなどの追加の基準を指定して、検索範囲を特定のホストに絞り込むことができます。次に、「追加」をクリックします。
追加したフィールドのそれぞれに、「次を含む」などの演算子を選択し、比較する値を入力します。

- 広範囲のターゲット・スコープ: クリックすると、ターゲットの親のすべてのメンバーに関連付けられたログに検索範囲が拡張されます。たとえば、特定のアプリケーションのログを検索する際に、アプリケーションのデプロイ先の管理対象サーバーも含まれるように検索範囲を拡張できます。

- 選択したターゲット: これを開くと、検索に関与するターゲットが表示されます。ターゲットを追加するには、「追加」をクリックして、ダイアログ・ボックスに情報を入力します。ターゲットを削除するには、ターゲットを選択して「削除」をクリックします。

12.3.2.2 WLSTを使用したログ・ファイルの検索

WLST displayLogsコマンドを使用してログ・ファイルを検索できます。時間、コンポーネントID、メッセージ・タイプ、ECIDなどの基準を指定して検索範囲を絞り込むことができます。次に例を示します。

- Oracle HTTP Server ohs1で直前の5分以内に生成されたエラー・メッセージを検索するには、次のコマンドを使用します。

displayLogs(target='opmn:asinst_1/ohs1', last=5)

- 管理対象サーバーsoa_server1で直前の10分以内に生成されたエラー・メッセージを検索するには、次のコマンドを使用します。

displayLogs(oracleInstance='/scratch/Oracle/config/domains/soa_domain', target='soa_server1', last=10)

queryパラメータを使用してコンポーネントID、メッセージ・タイプ、ECIDなどの基準を指定して、検索範囲を絞り込むことができます。query句では、表12-1にある任意の属性を使用して問合せ式を指定できます。次のような基準を使用できます。

- メッセージのタイプ。たとえば、管理対象サーバーsoa_server1のERRORおよびINCIDENT_ERRORのメッセージを検索するには、次のコマンドを使用します。

displayLogs(oracleInstance='/scratch/Oracle/config/domains/soa_domain',
target='soa_server1',
query='MSG_TYPE eq ERROR or MSG_TYPE eq INCIDENT_ERROR')

- 特定のECID。たとえば、管理対象サーバーsoa_server1の特定のECID(0000I3K7DCnAhKB5JZ4Eyf19wAgN000001,0')のエラー・メッセージを検索するには、次のコマンドを使用します。

displayLogs(oracleInstance='/scratch/Oracle/config/domains/soa_domain',
target='soa_server1',
query='ecid eq 0000I3K7DCnAhKB5JZ4Eyf19wAgN000001,0')

- コンポーネント・タイプ。たとえば、Oracle HTTP Serverインスタンスのメッセージを検索するには、次の問合せを使用します。

displayLogs(query='COMPONENT_ID eq ohs')

- 時間範囲。特定の時間範囲内に発生したエラー・メッセージを検索するには、次の形式で属性TSTZ_ORIGINATINGを、fromとtoの両演算子とともに指定します。

displayLogs(query='TSTZ_ORIGINATING from start_time and
TSTZ_ORIGINATING to end_time')

日付は次のISO 8601時間形式で指定します。

YYYY-MM-DDThh:mm:ss-hh:mm_offset_from_UTC

次に例を示します。

2010-09-30T12:00:00:0000-08:00

たとえば、2010年4月17日の午前8時から11時のエラー・メッセージを表示するには、次のコマンドを使用します。

displayLogs(query='TSTZ_ORIGINATING from 2010-04-17T08:00:00-07:00
and TSTZ_ORIGINATING to 2010-04-17T11:00:00-07:00')

- グループ・メッセージ。特定の属性でグループ化したメッセージの件数を表示するには、WLSTコマンドdisplayLogsで、groupByパラメータを使用します。たとえば、コンポーネント別にWARNINGメッセージの件数を表示する場合は、次のコマンドを使用します。

displayLogs(groupBy=['COMPONENT_ID'], query='MSG_TYPE eq WARNING')

12.3.3 ログ・ファイルのダウンロード

次の各項で説明するように、Fusion Middleware ControlまたはWLSTコマンドを使用して、メッセージをダウンロードできます。

- Fusion Middleware Controlを使用したログ・ファイルのダウンロード

- WLSTを使用したログ・ファイルのダウンロード

12.3.3.1 Fusion Middleware Controlを使用したログ・ファイルのダウンロード

ログ・メッセージをファイルにダウンロードできます。検索で一致したメッセージまたは特定のログ・ファイル内のメッセージをダウンロードできます。

Fusion Middleware Controlを使用して、検索で一致したメッセージをダウンロードする手順は次のとおりです。

1. ナビゲーション・ペインから、ファームを開いて、ドメインをクリックするなどしてターゲットを選択します。

2. 「WebLogicドメイン」メニューなどの動的ターゲット・メニューから、「ログ」→「ログ・メッセージの表示」を選択します。
「ログ・メッセージ」ページが表示されます。

3. 第12.3.2.1項の説明に従って、特定のタイプのメッセージを検索します。

4. 「メッセージをファイルにエクスポート」をクリックしてファイル・タイプを選択し、次のいずれかを選択します。

- Oracle診断ログ・テキスト(.txt)として

- Oracle診断ログXML (.xml)として

- カンマ区切りリスト(.csv)として

「オープン中」ダイアログ・ボックスが表示されます。

5. 次を使用してオープンまたはディスクに保存を選択します。「OK」をクリックします。

特定のタイプのメッセージ、または特定のメッセージIDのメッセージをファイルにエクスポートする手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開き、そのドメインを開きます。管理対象サーバーを選択します。

2. 動的ターゲット・メニューで、「ログ」→「ログ・メッセージの表示」を選択します。
「ログ・メッセージ」ページが表示されます。

3. 第12.3.2.1項の説明に従って、特定のタイプのメッセージを検索します。

4. 「表示」で「メッセージ・タイプ別グループ」または「メッセージID別グループ」を選択します。

5. メッセージをファイルにダウンロードするには、「メッセージ・タイプ別グループ」を選択した場合、列のいずれか(「エラー」列など)で、メッセージ数をリスト表示するリンクを選択します。「メッセージID別グループ」を選択した場合、「発生」列のリンクのいずれかを選択します。
「メッセージ、タイプ別」ページまたはメッセージID別のメッセージが表示されます。

6. 「すべてをファイルにエクスポート」の近くの矢印をクリックしてファイル・タイプを選択します。
次のいずれかを選択できます。

- Oracle診断ログ・テキスト(.txt)として

- Oracle診断ログXML (.xml)として

- カンマ区切りリスト(.csv)として

「オープン中」ダイアログ・ボックスが表示されます。

7. 次を使用してオープンまたはディスクに保存を選択します。「OK」をクリックします。

Fusion Middleware Controlを使用して、特定のコンポーネントのログ・ファイルをダウンロードする手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開きます。システム・コンポーネントの場合は、「Web層」などのインストール・タイプを開いて、コンポーネントを選択します。Javaコンポーネントの場合は、ファームを開いてからコンポーネント・タイプを開き、コンポーネントを選択します。

2. 動的ターゲット・メニューで、「ログ」→「ログ・メッセージの表示」を選択します。
「ログ・メッセージ」ページが表示されます。

3. 「ターゲット・ログ・ファイル」をクリックします。
「ログ・ファイル」ページが表示されます。このページに、コンポーネントまたはアプリケーションに関連するログ・ファイルのリストが表示されます。

4. ログ・ファイルを選択して、「ダウンロード」をクリックします。

5. 「オープン中」ダイアログ・ボックスが表示されます。

6. 次を使用してオープンまたはディスクに保存を選択します。「OK」をクリックします。

12.3.3.2 WLSTを使用したログ・ファイルのダウンロード

WLST displayLogsコマンドを使用し、出力をファイルにリダイレクトすることによって、ログ・ファイルをダウンロードできます。次に例を示します。

displayLogs(type=['ERROR','INCIDENT_ERROR'], exportFile='/scratch/tmp/download_log.txt')

メッセージは、指定されたディレクトリのファイルdownload_log.txtに書き込まれます。デフォルトでは、標準出力に書き込まれます。

12.4 ログ・ファイルの設定の構成

Fusion Middleware ControlまたはWLSTを使用して、管理対象サーバーおよびJavaコンポーネントのログ設定を変更できます。

注意:

第3.5.2項に記載されている多くのシステム・コンポーネントについては、Fusion Middleware Controlを使用してログ・ファイルの設定を構成できません。システム・コンポーネントのログ・ファイルに対するオプションの構成方法の詳細は、対象のコンポーネントの管理者ガイドを参照してください。

Javaコンポーネントの場合、次の各項で説明するように、ログ・ファイルの名前と場所、ログ・ファイルのサイズ、ログ・ファイルに書き込まれる情報レベル、形式、ロケール・エンコーディングを構成できます。

- ログ・ファイルの場所の変更

- ログ・ファイル・ローテーションの構成

- ログ・ファイルに書き込まれる情報レベルの設定

- ログ・ファイル形式の指定

- ログ・ファイルのロケールの指定

WLSTコマンドを使用してログ設定を構成する場合は、次の点に注意してください。

- カスタムWLSTロギング・コマンドを使用するには、Oracle共通ホームからWLSTスクリプトを起動する必要があります。詳細は、第3.5.1.1項を参照してください。

- setLogLevelなどの構成コマンドは、接続モードでのみ機能します。このため、コマンドを起動する際は、あらかじめ実行中のWebLogic Serverインスタンスに接続しておく必要があります。
構成コマンドは、WebLogic Server内で稼働するJavaコンポーネントではサポートされますが、Oracle WebLogic Serverではサポートされません。構成コマンドは、システム・コンポーネントではサポートされません。

- WLSTロギング・コマンドは、多くの場合、domainRuntimeツリーで実行する必要があります。たとえば、domainRuntimeツリーに接続して実行する場合は、次のコマンドを使用します。

connect('username', 'password', 'localhost:port_number')
domainRuntime()

- listLoggers、getLogLevelおよびsetLogLevelの各コマンドは、configおよびruntimeモードで機能します。configモードの場合、コマンドは構成ファイルで定義されたログ出力に作用します。runtimeモードの場合、コマンドはサーバーJVMで定義されたログ出力と直接連動します。デフォルトの場合、setLogLevelコマンドで、ランタイム・ログ出力のレベルが設定され、構成ファイルのログ出力定義が更新されます。デフォルトの場合、listLoggersおよびgetLogLevelコマンドではランタイム・ログ出力が返されます。

関連項目:

Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスのカスタムWLSTコマンドのロギングに関する項

12.4.1 ログ・ファイルの場所の変更

次の各項で説明するように、Fusion Middleware ControlまたはWLSTコマンドを使用して、ログ・ファイルの名前および場所を変更できます。

- Fusion Middleware Controlを使用したログ・ファイルの場所の変更

- WLSTを使用したログ・ファイルの場所の変更

12.4.1.1 Fusion Middleware Controlを使用したログ・ファイルの場所の変更

Fusion Middleware Controlを使用してコンポーネント・ログ・ファイルの名前および場所を変更するには:

1. ナビゲーション・ペインからコンポーネントを選択します。

2. 動的ターゲット・メニューで、「ログ」→「ログ構成」を選択します。
「ログ構成」ページが表示されます。

いくつかのコンポーネントでは、ナビゲーションが異なる場合があります。たとえば、Oracle HTTP Serverでは、「管理」→「ログ構成」を選択します。

3. 「ログ・ファイル」タブを選択します。

4. 表内で、ログ・ハンドラを選択して「構成の編集」をクリックします。
次の図のように「ログ・ファイルの編集」ダイアログ・ボックスが表示されます。

図logedit3.gifの説明

5. 「ログ・パス」に新しいパスを入力します。

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

7. 確認ウィンドウで、「閉じる」をクリックします。

Oracle HTTP Serverログ・ファイルの場所を変更すると、access_logとohsn.logのファイルの場所は変更されますが、console~OHS~1.logの場所は変更されません。

12.4.1.2 WLSTを使用したログ・ファイルの場所の変更

WLSTを使用してログ・ファイルの場所を変更するには、 configureLogHandlerコマンドを使用します。たとえば、odl-handlerという名前のログ出力のパスを変更するには、次のコマンドを使用します。

configureLogHandler(name='odl-handler', path='/scratch/Oracle/logs')

12.4.2 ログ・ファイルのローテーションの構成

ODLログ は、現在のODLログ・ファイルと古いメッセージを格納するODLアーカイブ(セグメント・ファイル)で構成される一連のログ・ファイルです。このアーカイブはまだ存在していない場合もあります。ログ・ファイルが拡大すると、新しい情報がログ・ファイルserver_name-diagnostic.logの最後に追加されます。ログ・ファイルがローテーション・ポイントに達すると、名前が変更されて、新しいログ・ファイルserver_name-diagnostic.logが作成されます。ローテーション・ポイントを指定するには、最大ODLセグメント・サイズまたはローテーション時間およびローテーション頻度を指定します。

ODLログ・ファイルserver_name-diagnostic.logがローテーション・ポイントに達すると、セグメント・ファイルが作成されます。このため、ファイル名server_name-diagnostic.logがserver_name-diagnostic-n.logに変更され(nは整数)、コンポーネントで新たな診断メッセージが生成されると、server_name-diagnostic.logファイルが新たに作成されます。

ODLログのサイズは、次の指定によって制限できます。

- ロギング・ディレクトリの最大サイズ。ディレクトリ内の全ファイルの合計サイズが最大値に達すると、合計サイズが指定された制限を超えないように一番古いアーカイブが削除されます。
デフォルトでは、10MBに達するとログ・ファイルはローテーションされます。特定のコンポーネントの全ログ・ファイルの最大サイズは100MBです。

- ログ・ファイルの最大サイズ。特定の時点または頻度に達したときに新しいログ・ファイルが作成されるように指定します。

注意:

ログ・ファイルのローテーションを変更すると、構成が動的にリロードされます。構成のリロードには1から2秒かかります。

次の各項目で、ローテーションを変更する方法を説明します。

- Fusion Middleware Controlを使用したログ・ファイル・ローテーションの指定

- WLSTを使用したログ・ファイル・ローテーションの指定

12.4.2.1 Fusion Middleware Controlを使用したログ・ファイル・ローテーションの指定

Fusion Middleware Controlを使用してログ・ファイルのローテーションを構成する手順は次のとおりです。

1. ナビゲーション・ペインからコンポーネントを選択します。

2. 動的ターゲット・メニューで、「ログ」→「ログ構成」を選択します。
「ログ構成」ページが表示されます。

いくつかのコンポーネントでは、ナビゲーションが異なる場合があります。たとえば、Oracle HTTP Serverでは、「管理」→「ログ構成」を選択します。

3. 「ログ・ファイル」タブを選択します。

4. 表内で、ログ出力を選択して「構成の編集」をクリックします。
「ログ・ファイルの編集」ダイアログ・ボックスが表示されます。

5. 「ローテーション・ポリシー」セクションで、次のいずれかを選択します。

- サイズ・ベース: これを選択した場合は、次を入力します。

- 「最大ログ・ファイル・サイズ」に、MB単位でサイズを入力します(例: 15)。

- 「すべてのログ・ファイルの最大サイズ」に、MB単位でサイズを入力します(例: 150)。

- 時間ベース: これを選択した場合は、次を入力します。

- 「開始時間」では、「カレンダ」をクリックし、ローテーションを開始する「日付と時間」を選択します。たとえば、September 8, 2010 6:00 AMを選択します。

- 「頻度」では、「分」を選択して何分かを入力できます。また、「時間」「日次」または「週」を選択することもできます。

- 「保存期間」では、ログ・ファイルの保存期間を指定できます。「分」を選択して何分かを入力できます。また、「日」「週」、「月」または「年」を選択することもできます。
指定する期間が短いと、使用ディスク領域が少なくなりますが、古い情報を取得できなくなります。

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

7. 確認ウィンドウで、「閉じる」をクリックします。

12.4.2.2 WLSTを使用したログ・ファイル・ローテーションの指定

WLSTを使用してログ・ファイル・ローテーションを指定するには、configureLogHandlerコマンドを使用します。サイズベース、または時間ベースのローテーションを指定できます。

たとえば、ログ・ファイルのローテーションを毎日実行し、1週間保存する場合は、次のコマンドを使用します。

configureLogHandler(name='odl-handler', rotationFrequency='daily',
retentionPeriod='week')

ログ・ファイルのサイズが5 MBを超えないこと、およびこのサイズに達するとローテーションすることを指定するには、次のコマンドを使用します。

configureLogHandler(name='odl-handler', maxFileSize='5M')

12.4.3 ログ・ファイルに書き込まれる情報レベルの設定

メッセージのタイプおよびレベルを指定して、ログ・ファイルに書き込まれる情報の量とタイプを構成できます。各メッセージ・タイプで、メッセージ・レベルに使用可能な値は1(最低重大度)から32(最高重大度)です。コンポーネントによっては、各メッセージ・タイプ別にサポートされるレベルが一部に限定されています。詳細は、ご使用のコンポーネント用の管理ガイドを参照してください。一般的には、指定が必要なのはタイプのみで、レベルの指定は必要ありません。

タイプを指定すると、Oracle Fusion Middlewareではそのタイプのすべてのメッセージと、指定したタイプ以上の重大度のメッセージが返されます。たとえば、メッセージ・タイプをWARNINGに設定した場合、Oracle Fusion MiddlewareからINCIDENT_ERRORおよびERRORのタイプのメッセージも返されます。

表12-3は、メッセージ・タイプと各タイプで最も一般的なレベルを説明しています。

表12-3 診断メッセージのタイプとレベル

メッセージ・タイプ

レベル

説明

INCIDENT_ERROR

1

製品のバグが原因の可能性があり、Oracleサポートに報告する必要がある重大な問題。

この例としては、回復不能なエラーや重大な問題があります。

ERROR

1

管理者がただちに対処する必要があり、製品のバグ以外が原因の重大な問題。

この例としては、Oracle Fusion Middlewareがログ・ファイルを処理できないものの、ドキュメントに対する権限の調整によって問題の修正が可能な場合などがあります。

WARNING

1

管理者による確認を要する、潜在的な問題。

この例としては、パラメータ値が無効な場合や指定したファイルが存在しない場合などがあります。

NOTIFICATION

1

プライマリ・サブコンポーネントや機能のアクティブ化や非アクティブ化などの主要なライフサイクル・イベント。

これはNOTIFICATIONのデフォルト・レベルです。

NOTIFICATION

16

通常のイベントをレポートする粒度の詳細なレベル。

TRACE

1

パブリックAPIエントリや終了ポイントなど、管理者に重要なイベントに関するトレースまたはデバッグ情報。

TRACE

16

詳細なトレースまたはデバッグ情報で、Oracleサポートによる特定のサブシステムの問題診断に有益なもの。

TRACE

32

非常に詳細なトレースまたはデバッグ情報で、Oracleサポートによる特定のサブシステムの問題診断に有益なもの。

デフォルトは、NOTIFICATION、レベル1です。

レベル1のINCIDENT_ERROR、ERROR、WARNINGおよびNOTIFICATIONは、パフォーマンスに影響しません。その他のタイプおよびレベルについては、次の点に注意してください。

- NOTIFICATION、レベル16: パフォーマンスに対する影響は最小。

- TRACE、レベル1: パフォーマンスに対する影響は小。このレベルは、ときどき本番環境で有効化して、問題のデバッグに利用できます。

- TRACE、レベル16: パフォーマンスに対する影響は大。このレベルは、問題のデバッグなどの特殊な状況を除いて本番環境では有効にしないでください。

- TRACE、レベル32: パフォーマンスに対する影響は特大。このレベルは、本番環境で有効にしないでください。これは、テストまたは開発環境における製品のデバッグでの使用を目的としています。

表12-4は、ODL形式、Oracle WebLogic ServerおよびJava間のログ・レベルのマッピングを示しています。

表12-4 ODL、Oracle WebLogic ServerおよびJava間のログ・レベルのマッピング

ODL

WebLogic Server

Java

OFF

OFF

2147483647 - OFF

INCIDENT_ERROR:1

(EMERGENCY)

1100

INCIDENT_ERROR:4

EMERGENCY

1090

INCIDENT_ERROR:14

ALERT

1060

INCIDENT_ERROR:24

CRITICAL

1030

ERROR:1

(ERROR)

1000 - SEVERE

ERROR:7

ERROR

980

WARNING:1

WARNING

900 - WARNING

WARNING:7

NOTICE

880

NOTIFICATION:1

INFO

800 - INFO

NOTIFICATION:16

(DEBUG)

700 - CONFIG

TRACE:1

(DEBUG)

500 - FINE

TRACE:1

DEBUG

495

TRACE:16

(TRACE)

400 - FINER

TRACE:32

(TRACE)

300 - FINEST

TRACE:32

TRACE

295

次の各項で説明するように、Fusion Middleware ControlまたはWLSTコマンドを使用して、メッセージ・レベルを構成できます。

- Fusion Middleware Controlを使用したメッセージ・レベルの構成

- WLSTを使用したメッセージ・レベルの構成

12.4.3.1 Fusion Middleware Controlを使用したメッセージ・レベルの構成

特定のログ・ファイルまたはログ出力のメッセージ・レベルを設定できます。

コンポーネント・ログ・ファイルのメッセージ・レベルを設定する手順は次のとおりです。

1. ナビゲーション・ペインからコンポーネントを選択します。

2. 動的ターゲット・メニューで、「ログ」→「ログ構成」を選択します。
「ログ構成」ページが表示されます。

いくつかのコンポーネントでは、ナビゲーションが異なる場合があります。たとえば、Oracle HTTP Serverでは、「管理」→「ログ構成」を選択します。

3. 「ログ・ファイル」タブを選択します。

4. 表内で、ログ・ファイルを選択して「構成の編集」をクリックします。
次の図のように「ログ・ファイルの編集」ダイアログ・ボックスが表示されます。

図logedit.gifの説明

5. 「ログ・レベル」でロギング・レベルを選択します。たとえば、「WARNING:1 (WARNING)」を選択します。

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

7. 確認ウィンドウで、「閉じる」をクリックします。

特定のコンポーネントの1つ以上のログ出力にメッセージ・レベルを設定する手順は次のとおりです。

1. ナビゲーション・ペインからコンポーネントを選択します。

2. 動的ターゲット・メニューで、「ログ」→「ログ構成」を選択します。
「ログ構成」ページが表示されます。

いくつかのコンポーネントでは、ナビゲーションが異なる場合があります。たとえば、Oracle HTTP Serverでは、「管理」→「ログ構成」を選択します。

3. 「ログ・レベル」タブを選択します。

4. 「表示」で「ランタイム・ログ出力」または「永続ログ・レベル状態のログ出力」を選択します。
ランタイム・ログ出力とは、現在アクティブなログ出力です。永続ログ出力とは、構成ファイルに保存されたログ出力で、このログ出力のログ・レベルはコンポーネントを再起動しても持続されます。ランタイム・ログ出力は永続ログ出力でもある場合がありますが、すべてのランタイム・ログ出力が永続ログ出力であるとはかぎりません。

5. 表内で、すべてのログ出力に同一のレベルを指定するには、トップレベル・ログ出力にこのロギング・レベルを選択します。次に、ロギング・レベルを親から継承しないことを指定する子ログ出力に、「親から継承」を指定します。多くの場合は、これで十分です。
図loglevel.gifの説明

ただし、特定のログ出力のレベルを指定する必要がある場合は、ログ出力を開き、変更するログ出力にロギング・レベルを選択します。たとえば、ログ出力oracle.wsm.management.loggingに、「WARNING:1 (WARNING)」を選択します。

6. 「適用」をクリックします。

12.4.3.2 WLSTを使用したメッセージ・レベルの構成

WLSTを使用してメッセージ・レベルを設定するには、setLoglevelコマンドを使用します。現在のメッセージ・レベルを確認するには、getLogLevelコマンドを使用します。構成コマンドを使用する際は、あらかじめWebLogic Serverに接続しておく必要があります。

Oracle WebLogic Serverのログ出力のログ・レベルを表示できます。たとえば、Oracle WebLogic Server soa_server1のログ・レベルを表示する場合は、次のコマンドを使用します。

getLogLevel(logger='oracle',  target='soa_server1')
NOTIFICATION:1

特定のログ出力のログ・レベルを設定できます。次の例では、ログ出力oracle.soaのメッセージ・タイプをWARNINGに設定しています。

setLogLevel(target='soa_server1', logger='oracle.soa', level='WARNING')

Oracle WebLogic Server soa_server1のログ出力のリストを表示するには、listLoggersコマンドを使用します。

listLoggers(target='soa_server1')
.
.
.
oracle.soa                               |  WARNING:1
oracle.soa.adapter                       | <Inherited>
orac                                     | <Inherited>
oracle.soa.b2b.apptransport              | <Inherited>
oracle.soa.b2b.engine                    | <Inherited>
oracle.soa.b2b.repository                | <Inherited>
oracle.soa.b2b.transport                 | <Inherited>
oracle.soa.b2b.ui                        | <Inherited>
.
.
.

また、パターン・パラメータと正規表現を使用して、ログ出力名をフィルタ処理することもできます。たとえば、Oracle WebLogic Server soa_server1内で名前がoracleで始まるすべてのログ出力を取得するには、次のコマンドを使用します。

listLoggers(target='soa_server1', pattern='oracle.*')
oracle                                   | NOTIFICATION:1
oracle.adapter                           | <Inherited>
oracle.adapter.jms.logger                | <Inherited>
oracle.adf                               | <Inherited>

12.4.4 ログ・ファイル形式の指定

デフォルトでは、情報はログ・ファイルにODLテキスト形式で書き込まれます。この形式は、次の各項で説明するように、Fusion Middleware ControlまたはWLSTコマンドを使用してODL XML形式に変更できます。

- Fusion Middleware Controlを使用したログ・ファイル形式の指定

- WLSTを使用したログ・ファイル形式の指定

12.4.4.1 Fusion Middleware Controlを使用したログ・ファイル形式の指定

Fusion Middleware Controlを使用して形式を変更する手順は次のとおりです。

1. ナビゲーション・ペインからコンポーネントを選択します。

2. 動的ターゲット・メニューで、「ログ」→「ログ構成」を選択します。
「ログ構成」ページが表示されます。

いくつかのコンポーネントでは、ナビゲーションが異なる場合があります。たとえば、Oracle HTTP Serverでは、「管理」→「ログ構成」を選択します。

3. 「ログ・ファイル」タブを選択します。

4. 表内で、ログ・ファイルを選択して「構成の編集」をクリックします。
「ログ・ファイルの編集」ダイアログ・ボックスが表示されます。

5. 「ログ・ファイル形式」で、「Oracle Diagnostics Logging - テキスト」または「Oracle Diagnostics Logging - XML」を選択します。

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

7. 確認ウィンドウで、「閉じる」をクリックします。

12.4.4.2 WLSTを使用したログ・ファイル形式の指定

WLSTを使用してログ・ファイル形式を指定するには、configureLogHandlerコマンドを使用します(formatパラメータを使用し、ODL-TextまたはODL-XMLを指定します)。デフォルトはODL-Textです。

たとえば、ODL-XML形式を指定するには、次のコマンドを使用します。

configureLogHandler(name='odl-handler', format='ODL-XML')

12.4.5 ログ・ファイルのロケールの指定

ログ・ファイルで使用される言語形式およびデータ形式は、サーバーJava仮想マシン(JVM)のデフォルトのロケールで決定されます。これを変更するには、Windowsの場合は「コントロール パネル」の「言語と地域のオプション」を使用し、UNIXプラットフォームの場合は環境変数のLANGおよびLC_ALLを使用します。

ログ・ファイルの文字エンコーディングは、サーバーJVMのデフォルトの文字エンコーディングまたはオプションの構成設定によって決定されます。ユーザーが使用するすべての言語をサポートするエンコーディングを選択する必要があります。選択しないと、ログ・ファイルが破損する可能性があります。デフォルトでは、ログはサーバーJVMのデフォルトのキャラクタ・エンコーディングを使用します。エンコーディングを変更する場合、別のエンコーディングで追加された新しいログによって破損しないように、古いログを削除するか、またはその名前を変更します。

どのような言語でもサポートできるようにするには、Unicode UTF-8エンコーディングを使用することをお薦めします。UNIXオペレーティング・システムでは、環境変数LANGおよびLC_AllをUTF-8キャラクタ・セットのロケールに設定すると、UTF-8ロギングが可能になります(たとえば、UTF-8エンコーディングのUSロケールは、en_US.UTF-8)。

次の各項で説明するように、ログ・ファイルのロケールを指定するには、WLSTコマンドを使用するか、またはファイルを編集します。

- WLSTを使用したログ・ファイルのエンコーディングの指定

- logging.xmlでのログ・ファイルのエンコーディングの指定

12.4.5.1 WLSTを使用したログ・ファイルのエンコーディングの指定

WLSTを使用してログ・ファイルのエンコーディングを指定するには、configureLogHandlerコマンドを使用します。エンコーディング・パラメータを使用して、キャラクタ・セットのエンコーディングを指定できます。

たとえば、UTF-8を指定するには、次のコマンドを使用します。

configureLogHandler(name="odl-handler", encoding="UTF-8")

12.4.5.2 logging.xmlでのログ・ファイルのエンコーディングの指定

logging.xmlファイルでログ・ファイルのエンコーディングを指定するには、オプションのエンコーディング・プロパティを使用して、キャラクタ・セットのエンコーディングを指定します。

logging.xmlファイルは、次のディレクトリにあります。

DOMAIN_HOME/config/fmwconfig/servers/server_name/

たとえば、UTF-8を指定するには、log_handler要素に次のエンコーディング・プロパティを追加します。

<property name='encoding' value='UTF-8'/>

12.5 ログ・ファイルおよびコンポーネント間のメッセージの関連付け

Oracle Fusion Middlewareコンポーネントは、診断メッセージにメッセージ相関情報を提供します。メッセージ相関情報は、診断メッセージを表示したユーザーがコンポーネント間のメッセージの関係を判定する際に役立ちます。診断メッセージのそれぞれに、実行コンテキストID(ECID)と関係ID(RID)が組み込まれています。

- ECIDは、特定リクエストの実行に関連付けられたグローバル一意識別子です。ECIDは、リクエストを最初に処理したときに生成されます。

- RIDは、1つのリクエストにおいて、特定のプロセス上の特定スレッドで実行された作業と、同じプロセス上の別スレッドおよび別プロセス上で実行された作業を区別します。

ECIDとRIDを利用すると、ログ・ファイル・エントリを使用して、特定のアプリケーションとOracle Fusion Middlewareコンポーネント間のメッセージを関連付けることができます。メッセージ相関情報を使用して関連メッセージを検索すると、複数のメッセージを調べることができ、最初に問題が発生したコンポーネントを特定できます(この方法は、最初に障害が発生したコンポーネントの切分けと呼ばれます)。メッセージ相関データを使用すると、コンポーネント全体における診断メッセージのパスが明確になり、エラーや関連する動作を把握できます。

ECIDおよびRIDを使用して、Oracle Fusion Middleware内を移動するリクエストをトラッキングできます。

次に、ECIDの例を示します。

0000I3K7DCnAhKB5JZ4Eyf19wAgN000001,0

RIDはコロン(:)で区切られた1つ以上の数字で示されます。特定のリクエストに対して最初に作成されるRIDは0です。ECIDが関連付けられているスレッドから別のスレッドまたはプロセスに作業が渡されるたびに、作成者との関係をエンコードする新たなRIDが生成されます。つまり、新しい世代が生成されます。世代が推移するたびに、コロンと数値が追加されます。たとえば、リクエストの作成者の3番目の子の7番目の子は、次のように示されます。

0:3:7

WLSTのdisplayLogsコマンドを使用して、同一のECIDのメッセージをすべて表示できます。次の例は、ドメインでECIDを検索します。

displayLogs(ecid='0000Hl9TwKUCslT6uBi8UH18lkWX000002')

ターゲット・オプションで指定することにより、WebLogic Serverインスタンスやシステム・コンポーネントでECIDを検索することも可能です。

Fusion Middleware Controlの「ログ・メッセージ」ページで特定のECIDを持つメッセージを検索できます。

1. 「WebLogicドメイン」メニューで、「ログ」→「ログ・メッセージの表示」を選択します。
特定のコンポーネントまたはアプリケーションのメッセージを検索する際は、該当するコンポーネントまたはアプリケーションを選択し、そのターゲットのメニューから「ログ」→「ログ・メッセージの表示」を選択します。

2. 第12.3.2.1.2項の説明に従って、検索条件を指定します。

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

4. メッセージを選択して「関連メッセージの表示」をクリックし、「ECID(実行コンテキストID)ごと」を選択します。
次の図のように、ECIDが同じメッセージが表示されます。

図ecid.gifの説明

5. 最も古いメッセージまでECIDをトレースします最も古いメッセージまでECIDをトレースします(そのECIDを持つ最初のメッセージが表示されるまで、範囲を拡大できます)。

12.6 トレースの構成

場合によっては、問題を解決するために、通常のログに記録されるよりも多くの情報が必要になることがあります。これを実現する方法の一つは、1つまたは複数のコンポーネントで記録されるログのメッセージ・レベルを上げることです。たとえば、第12.4.3項で説明されているように、ロギング・レベルをTRACE:1やTRACE:32に設定できます。これにより、より詳細なメッセージがログ・ファイルに書き込まれるようになります。これをトレースと呼びます。

ただし、多くの場合、これによってログ・ファイルに大量のログ・メッセージが書き込まれるようになります。Oracle Fusion Middlewareでは、トレース対象のメッセージを細かく調整するために次のメカニズムを使用できます。

- QuickTrace。メモリーに対してきめ細かなロギングを行います。

- 選択的トレース。リクエスト内の特定のユーザーまたは他のプロパティについて、きめ細かなロギングを行います。

次の各項では、これらのメカニズムの使用方法について説明します。

- QuickTraceの構成と使用

- 選択的トレースの構成と使用

12.6.1 QuickTraceの構成と使用

QuickTraceを使用すると、特定のログ出力のメッセージをトレースして、そのメッセージをメモリーに格納できます。QuickTraceではメッセージがメモリーに記録されるため、フォーマット設定、文字列操作および入出力操作に伴うコストが回避されます。そのため、パフォーマンスのオーバーヘッドを気にすることなく、特定のログ出力に対して詳細レベルでのアプリケーション・ロギングを有効化できます。

デフォルトでは、QuickTraceは1つの共通バッファにメッセージを書き込みます。一方で、特定のユーザーのメッセージが個別のバッファに書き込まれるように指定できます。

メモリーに格納されたメッセージは、Fusion Middleware ControlでQuickTraceダンプを起動する(第12.6.1.1.2項を参照)か、WLSTを使用する(第12.6.1.2.2項を参照)ことによってファイルに保存できます。

QuickTraceを有効にするには、QuickTraceハンドラを作成してログ出力に関連付けます。ハンドラには、バッファ・サイズなどの属性を指定できます。続いて、ログ出力がメモリーに書き込む情報の量およびタイプのレベルを設定します。

次の各項では、QuickTraceの有効化と使用方法について説明します。

- Fusion Middleware Controlを使用したQuickTraceの構成

- WLSTを使用したQuickTraceの構成

12.6.1.1 Fusion Middleware Controlを使用したQuickTraceの構成

次の各項で説明するように、Fusion Middleware Controlを使用して、QuickTraceを構成および使用できます。

- Fusion Middleware Controlを使用したQuickTraceの構成

- Fusion Middleware Controlを使用したトレース・メッセージのファイルへの書き込み

12.6.1.1.1 Fusion Middleware Controlを使用したQuickTraceの構成

Fusion Middleware Controlを使用してQuickTraceを構成する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開き、そのドメインを開きます。管理対象サーバー名を右クリックして、「ログ」→「ログ構成」を選択します。
「ログ構成」ページが表示されます。

2. 「QuickTrace」タブを選択します。

3. 「作成」をクリックします。
次の図に示すように、「QuickTraceハンドラの作成」ダイアログ・ボックスが表示されます。

quicktrace.gifの説明

4. 「名前」に、ハンドラの名前を入力します。

5. 「バッファ・サイズ」に、ログ・メッセージをメモリーに格納するためのバッファ・サイズ(バイト)を入力します。デフォルトは5242880です。

6. 「最大フィールド長」に、メッセージの各フィールドの長さ(バイト)を入力します。フィールドには、メッセージ・テキスト、サプリメンタル属性およびスレッド名を含めることができます。デフォルトは240です。
各メッセージのフィールドが長すぎると、バッファ内に格納できるログ・レコードの量が少なくなります。

7. 「ハンドラ・レベル」で、ハンドラのログ・レベルを選択します。レベルについては、第12.4.3項を参照してください。

8. 「関連付けるログ出力」で、このQuickTraceハンドラに関連付けるログ出力を選択します。これらのハンドラに指定されたレベルのメッセージはすべて、メモリーに書き込まれます。
様々なログ出力が他のハンドラに関連付けられています。たとえば、oracle.adfログ出力は、ハンドラodl-handler、wls-domainおよびconsole-handlerに関連付けられています。ログ出力のレベルを設定すると、これらのハンドラはログ出力(oracle.adfなど)に対して同一のレベル(TRACE:1など)を使用します。そのため、ログ・ファイルに大量の情報が書き込まれ、リソースが消費されます。リソースの消費を回避するには、ハンドラのレベルを低いレベル(WARNINGやINFORMATIONなど)に設定します。

9. ユーザー・バッファを有効にする場合は、「ユーザー・バッファを有効化しますか。」を選択します。これを有効にすると、ハンドラは、指定された各ユーザーに対して個別のバッファを保持します。
続いて、「予備バッファのユーザー名」に、カンマ区切りのユーザー名を入力します。

10. 残りのオプションについては、デフォルト値を受け入れます。オプションについては、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスのConfigureLogHandlerに関する項を参照してください。

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

12. 構成処理が完了したら、「OK」をクリックします。

これで、指定したログ出力の指定したレベルのメッセージが、メモリーに書き込まれるようになりました。

12.6.1.1.2 Fusion Middleware Controlを使用したトレース・メッセージのファイルへの書き込み

Fusion Middleware ControlでQuickTraceダンプを起動して、メモリーに格納されたメッセージをファイルに保存できます。

1. 「ログ構成」ページの「QuickTrace」タブで、ハンドラを選択し、「QuickTraceダンプの起動」をクリックします。
「QuickTraceダンプの起動」ダイアログ・ボックスが表示されます。

2. QuickTraceハンドラの構成時にユーザー・バッファを指定した場合は、「バッファ名」でユーザーを選択するか、指定しなかったユーザーに対して「共通バッファ」を選択します。いずれのユーザー・バッファも選択しなかった場合には、「共通バッファ」のみを選択できます。

3. 「OK」をクリックします。
処理が完了すると、「ログ・メッセージの表示」ページが表示されます。

4. 第12.3.2項の説明に従って、メッセージを検索できます。また、第12.5項の説明に従って、メッセージを関連付けることができます。
さらに、第12.3.3.1項.の説明に従って、メッセージをファイルにダウンロードすることもできます。

12.6.1.2 WLSTを使用したQuickTraceの構成

次の各項で説明するように、WLSTを使用して、QuickTraceを構成および使用できます。

- WLSTを使用したQuickTraceの構成

- WLSTを使用したトレース・メッセージのファイルへの書き込み

- WLSTを使用したQuickTraceの無効化

12.6.1.2.1 WLSTを使用したQuickTraceの構成

WLSTを使用してQuickTraceを構成するには、configureLogHandlerコマンドを使用して、ログ出力をQuickTraceハンドラに関連付けます。

たとえば、oracle.adfログ出力をQuickTraceハンドラに関連付けて、TRACE:1のメッセージをすべてメモリーに書き込む手順は次のとおりです。

1. configureLogHandlerコマンドを使用して、ログ出力をQuickTraceハンドラに関連付けます。

configureLogHandler(name="quicktrace-handler", addToLogger="oracle.adf")

Handler Name: quicktrace-handler
type:   oracle.core.ojdl.logging.QuickraceHandlerFactory
useLoggingContext:      false
bufferSize:     5242880
.
.
.
enableUserBuffer:       false

ハンドラのメッセージが共通バッファに書き込まれます。

QuickTraceハンドラに追加のプロパティを設定できます。たとえば、user1およびuser2のユーザー・バッファを有効にするには次のようにします。

configureLogHandler(name="quicktrace-handler", addToLogger="oracle.adf.faces",
propertyName="enableUserBuffer", propertyValue="true",
propertyName="reserveBufferUserID", propertyValue="user1, user2")
...
Handler Name: quicktrace-handler
type:   oracle.core.ojdl.logging.QuickTraceHandlerFactory
useLoggingContext:      false
bufferSize:     5242880
.
.
.
reserveBufferUserID:    user1, user2
enableUserBuffer:       true

user1およびuser2のメッセージは別々のバッファに書き込まれます。また、他のユーザーに関連するメッセージは共通バッファに書き込まれます。

ハンドラの設定を確認するには、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のlistLogHandlersに関する説明の説明に従って、listLogHandlersコマンドを使用します。

2. setLogLevelコマンドを使用して、ログ出力のレベルを設定します。

setLogLevel(logger='oracle.adf', level='TRACE:1')

ログ出力の設定を確認するには、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のlistLoggersに関する説明に従って、listLoggersコマンドを使用します。

3. 様々なログ出力が他のハンドラに関連付けられています。たとえば、oracle.adfログ出力は、ハンドラodl-handler、wls-domainおよびconsole-handlerに関連付けられています。ログ出力のレベルを設定すると、これらのハンドラはログ出力oracle.adfに対して同一のレベル(TRACE:1)を使用します。そのため、ログ・ファイルに大量の情報が書き込まれ、リソースが消費されます。リソースの消費を回避するには、ハンドラのレベルを低いレベル(WARNINGやINFORMATIONなど)に設定します。
次の例では、3つのハンドラのレベルをWARNING:1に設定します。

configureLogHandler(name="odl-handler", level="WARNING:1")
configureLogHandler(name="wls-domain", level="WARNING:1")
configureLogHandler(name="console-handler", level="WARNING:1")

QuickTraceハンドラのレベルは、ALL(デフォルト)のままにしておいてください。

関連項目:

Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスのコマンド「configureLogHandler」

このハンドラのレベルを確認するには、第12.4.3.2項の説明に従ってgetLogLevelコマンドを使用します。

12.6.1.2.2 WLSTを使用したトレース・メッセージのファイルへの書き込み

メッセージをファイルに保存するには、executeDumpコマンドを使用します。

次に例を示します。

executeDump(name="odl.quicktrace", outputFile="/scratch/oracle1/qt1.dmp")

コマンドにより、指定したファイルにダンプが書き込まれます。

executeDumpコマンドの詳細は、第13.4.4.3項.を参照してください。

また、インシデントが(自動または手動で)作成されると、インシデント・ディレクトリのダンプ・ファイルにQuickTraceメッセージが書き込まれます。ユーザー・バッファを有効にしている場合、各ユーザーは1つのファイルを使用します。また、共通バッファでも1つのファイルを使用します。

ファイル名のフォーマットは次のとおりです。

odl_quicktraceN_iincident_number.username.dmp

次に例を示します。

odl_quicktrace6_i1.weblogic.dmp

インシデントの作成については、第13.4.6.1項を参照してください。

12.6.1.2.3 WLSTを使用したQuickTraceの無効化

QuickTraceを無効化するには、configureLogHandlerコマンドを使用して、levelにOFFを指定します。

configureLogHandler(name="quicktrace-handler", level="OFF")

Handler Name: quicktrace-handler
type:   oracle.core.ojdl.logging.QuickraceHandlerFactory
.
.
.
reserveBufferUserID:    user1, user2
enableUserBuffer:       true

QuickTraceハンドラの関連付けから特定のログ出力を削除するには、configureLogHandlerコマンドを使用してremoveFromLoggerパラメータを指定します。

configureLogHandler(name="quicktrace-handler", removeFromLogger="oracle.adf.faces")

Handler Name: quicktrace-handler
type:   oracle.core.ojdl.logging.QuickraceHandlerFactory
reserveBufferUserID:    user1, user2
enableUserBuffer:       true

関連項目:

Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスのコマンド「configureLogHandler」

12.6.2 選択的トレースの構成と使用

選択的トレースは、リクエスト内の指定したユーザーまたは他の属性について、きめ細かなロギングを行います。

たとえば、セキュリティ権限が原因で、あるユーザーが一部の機能を実行できない場合に、どの操作に問題があるのか、あるいはどの操作の権限が不足しているのか、わからないことがあります。

このような場合、システム全体を通じてトレースを有効にすることもできますが、そうすることで問題のあるユーザーのみならず、システム内のすべてのユーザーに対してログ・メッセージが大量に生成されることになります。選択的トレースを使用すると、問題のあるユーザーのみに対してトレースを有効化できます。また、機能を再試行するかどうか、そのユーザーに尋ねることができます。そして、そのユーザーが行った特定のリクエストに該当するトレース・メッセージを調べることができます。

ログ出力を指定して、ログに記録されるメッセージの範囲を絞り込むこともできます。

選択的トレースを使用する前に、次の手順を実行します。

1. 次のファイルを変更します。

(UNIX) DOMAIN_HOME/bin/setDomainEnv.sh
(Windows) DOMAIN_HOME\bin\setDomainEnv.cmd

2. ファイルに次の行を追加します。

- UNIXの場合:

JAVA_OPTIONS="-Djava.util.logging.manager=oracle.core.ojdl.logging.ODLLogManager ${JAVA_OPTIONS}"
export JAVA_OPTIONS
FMWCONFIG_CLASSPATH=${FMWCONFIG_CLASSPATH}${CLASSPATHSEP}${COMMON_COMPONENTS_HOME}/modules/oracle.odl_11.1.1/ojdl.jar
export FMWCONFIG_CLASSPATH

- Windowsの場合:

set JAVA_OPTIONS=-Djava.util.logging.manager=oracle.core.ojdl.logging.ODLLogManager %JAVA_OPTIONS%
set FMWCONFIG_CLASSPATH=%FMWCONFIG_CLASSPATH%;%COMMON_COMPONENTS_HOME%\modules\oracle.odl_11.1.1\ojdl.jar

3. 第4.2項の説明に従って、管理サーバーおよび管理対象サーバーを再起動します。

前のバージョンから11.1.1.5にドメインをアップグレードしている場合は、次の手順を実行する必要があります。

1. 次のファイルをバックアップします。

(Unix) DOMAIN_HOME/config/fmwconfig/mbeans/odl_mbeans.xml
(Windows) DOMAIN_HOME\config\fmwconfig\mbeans\odl_mbeans.xml

2. すべての管理対象サーバーの次のファイルをバックアップします。

(Unix) DOMAIN_HOME/config/fmwconfig/servers/server_name/mbeans/odl_mbeans.xml

(Windows) ORACLE_COMMON_HOME\modules\oracle.odl_11.1.1\server_name]\mbeans\odl_mbeans.xml

3. 次のファイルをコピーします。

(UNIX) ORACLE_COMMON_HOME/modules/oracle.odl_11.1.1/domain_config/mbeans/odl_mbeans.xml
(Windows) ORACLE_COMMON_HOME\modules\oracle.odl_11.1.1\domain_config\mbeans\odl_mbeans.xml

次の場所にファイルをコピーします。

(UNIX) DOMAIN_HOME/config/fmwconfig/mbeans/odl_mbeans.xml
(Windows) DOMAIN_HOME\config\fmwconfig\mbeans\odl_mbeans.xml

4. 次のファイルをコピーします。

(UNIX) ORACLE_COMMON_HOME/modules/oracle.odl_11.1.1/server_config/mbeans/odl_mbeans.xml
(Windows) ORACLE_COMMON_HOME\modules\oracle.odl_11.1.1\server_config\mbeans\odl_mbeans.xml

次の場所にファイルをコピーします。

(UNIX)DOMAIN_HOME/config/fmwconfig/servers/server_name/mbeans/odl_mbeans.xml
(Windows) ORACLE_COMMON_HOME\modules\oracle.odl_11.1.1\server_name\mbeans\odl_mbeans.xml

複数のサーバーを使用している場合は、各サーバーの場所にファイルをコピーする必要があります。

次の各項で説明するように、Fusion Middleware ControlまたはWLSTコマンドを使用して、選択的トレースを使用できます。

- Fusion Middleware Controlを使用した選択的トレースの構成

- WLSTを使用した選択的トレースの構成

12.6.2.1 Fusion Middleware Controlを使用した選択的トレースの構成

次の各項で説明するように、Fusion Middleware Controlを使用して、選択的トレースの構成、トレースの表示および選択的トレースの無効化を行うことができます。

- Fusion Middleware Controlを使用した選択的トレースの構成

- Fusion Middleware Controlを使用した選択的トレースの表示

- Fusion Middleware Controlを使用した選択的トレースの無効化

12.6.2.1.1 Fusion Middleware Controlを使用した選択的トレースの構成

Fusion Middleware Controlを使用して選択的トレースを構成する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。ドメイン名を右クリックして、「ログ」→「選択的トレース」を選択します。
次の図に示すように、「選択的トレース」ページが表示されます。

selecttrace.gifの説明

2. 「オプション名」で、「ユーザー名」、「アプリケーション名」、「クライアント・ホスト」などのオプションを選択します。続いて、名前(user1など)を入力します。

3. 「レベル」で、ロギング・レベルを選択します。表12-3にロギング・レベルを示します。

4. 「説明」に、説明を入力します。

5. 「期間」に、選択的トレースの実行時間を分単位で入力します。
指定した時間を過ぎると、選択的トレースは無効化されます。

6. 「トレースID」で、「一意の新規トレースIDの生成」または「カスタム・トレースIDの使用」のいずれかを選択します。「カスタム・トレースIDの使用」を選択する場合は、任意の選択IDを入力しますが、それが一意のIDであることを確認してください。Fusion Middleware Controlは、IDの一意性を検証しません。

7. デフォルトでは、「ログ出力」セクションで、すべてのログ出力が選択されています。
トレースする特定のログ出力を選択できます。特定のログ出力を検索するには、表の上部にあるフィールドに文字列を入力して、[Return]キーを押します。たとえば、「oracle.security」で始まるログ出力をすべて検索するには、「oracle.security」と入力します。

続いて、表の「すべてのサーバーで有効化しますか。」列でログ出力を選択します。

ログ出力を選択すると、それらのログ出力は、現在アクティブなすべてのトレースに適用されます。また、ログ出力を無効にした場合でも、すべてのログ出力で一般的なロギング・レベル(Notificationなど)が使用されているため、メッセージが表示される場合があります。これらのメッセージは、引き続き書き込まれます。

8. 「適用」をクリックします。

9. 「トレースを開始」をクリックします。

これで、トレースが開始されました。第12.6.2.1.2項の説明に従って、アクティブなトレースと以前のトレースを表示できます。

12.6.2.1.2 Fusion Middleware Controlを使用した選択的トレースの表示

現在アクティブな選択的トレースおよび選択的トレースの履歴を表示できます。

選択的トレースを表示する手順は次のとおりです。

1. 「選択的トレース」ページで、「アクティブなトレースとトレース履歴」タブを選択します。
次の図に示すように、アクティブなトレースの表とトレース履歴の表がタブに表示されます。

activetrace.gifの説明

2. トレースを表示するには、該当する表からトレースを選択します。
「ログ・メッセージ」ページが表示され、選択的トレースで収集されたメッセージが表示されます。第12.3.2項の説明に従って、メッセージを検索できます。また、第12.5項の説明に従って、メッセージを関連付けることができます。

さらに、第12.3.3.1項.の説明に従って、メッセージをファイルにダウンロードすることもできます。

12.6.2.1.3 Fusion Middleware Controlを使用した選択的トレースの無効化

Fusion Middleware Controlを使用して選択的トレースを無効化する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。ドメイン名を右クリックして、「ログ」→「選択的トレース」を選択します。

2. 「アクティブなトレースとトレース履歴」タブを選択します。

3. 「アクティブなトレース」表で、トレースを選択して「無効化」をクリックします。

12.6.2.2 WLSTを使用した選択的トレースの構成

次の各項で説明するように、WLSTを使用して、選択的トレースの構成、トレースの表示および選択的トレースの無効化を行うことができます。

- WLSTを使用した選択的トレースの構成

- WLSTを使用した選択的トレースの表示

- WLSTを使用した選択的トレースの無効化

12.6.2.2.1 WLSTを使用した選択的トレースの構成

WLSTのconfigureTracingLoggersコマンドとstartTracingコマンドを使用して、選択的トレースのログ出力を構成し、トレースを開始できます。

最も簡単に行うには、startTracingコマンドを使用してトレースを構成および開始します。これを行うと、選択的トレースが有効化されているすべてのログ出力が選択的トレースに含まれます。

たとえば、user1は特定の操作を実行しようとするとエラーを受け取ります。user1に関連するメッセージのトレースを開始して、ロギング・レベルをFINEに設定するには、次のコマンドを使用します。

startTracing(user="user1",level="FINE")
Started tracing with ID: 885649f7-8efd-4a7a-9898-accbfc0bbba3

startTracingコマンドには、特定のログ出力を含めるまたは除外するためのオプションはありません。そのような場合には、configureTracingLoggersコマンドを使用します。このコマンドを使用すると、特定のログ出力と特定のOracle WebLogic Serverインスタンスのみを含むように選択的トレースを構成できます。指定するオプションは、現在アクティブなすべてのトレースに適用されます。

たとえば、セキュリティ関連のログ出力のみを含むように選択的トレースを構成する手順は次のとおりです。

1. 次の例に示すように、トレースに関するすべてのログ出力が無効化されるように指定します。

configureTracingLoggers(action="disable")
Configured 1244 loggers

2. 正規表現でパターン・オプションを指定して、セキュリティ関連のログ出力を有効化します。

configureTracingLoggers(pattern='oracle.security.*', action="enable")
Configured 62 loggers

選択的トレースをサポートするログ出力のリストを表示するには、次の例に示すように、WLSTのlistTracingLoggersコマンドを使用します。

listTracingLoggers(pattern="oracle.security.*")
------------------------------------------------------------------+--------
Logger                                                            | Status
------------------------------------------------------------------+--------
oracle.security                                                   | enabled
oracle.security.audit.logger                                      | enabled
oracle.security.jps.az.common.util.JpsLock                        | enabled
.
.
.

3. startTracingコマンドを使用して、ユーザーとレベルを指定します。次に例を示します。

startTracing(user="user1",level="FINE")
Started tracing with ID: a9580e65-13c4-420b-977e-5ba7dd88ca7f

関連項目:

完全な構文は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスの次のコマンドを参照してください。

- configureTracingLoggers

- startTracing

- listTracingLoggers

12.6.2.2.2 WLSTを使用した選択的トレースの表示

トレースを開始した後で、次の例に示すように、listActiveTracesコマンドを使用してアクティブなトレースを表示できます。

listActiveTraces()
-------------------------------------+----------+-----------+------+-----------+-----------
Trace ID                             |Attr. Name|Attr. Value| Level| Exp. Time |Description
-------------------------------------+----------+-----------+------+-----------+-----------
a9580e65-13c4-420b-977e-5ba7dd88ca7f |USER_ID   |user1      | FINE |           |
a04b47f7-2830-4d80-92ee-ba160cdacf6b |USER_ID   |user2      | FINE |           |

トレースの内容を表示するには、displayLogsコマンドを使用してトレースIDを渡します。停止されたトレースを表示することもできます。次に例を示します。

displayLogs("a9580e65-13c4-420b-977e-5ba7dd88ca7f")

関連項目:

完全な構文は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスのlistActiveTracesコマンドを参照してください。

12.6.2.2.3 WLSTを使用した選択的トレースの無効化

システムで過度のロギングが行われないようにするには、必要な情報を取得した後で選択的トレースを無効化します。選択的トレースを無効化するには、WLSTのstopTracingコマンドを使用して、トレースIDまたはユーザーを渡します。次に例を示します。

stopTracing(traceId="885649f7-8efd-4a7a-9898-accbfc0bbba3")
Stopped 1 traces

stopAllオプションを使用して、すべてのトレースを無効化することもできます。次に例を示します。

stopTracing(stopAll=1)

関連項目:

完全な構文は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスのstopTracingコマンドを参照してください。

13 問題の診断

この章では、問題を解決したり、解決のためにOracleサポートに送信したりできるように、Oracle Fusion Middleware診断フレームワークを使用して問題に関する情報の収集および管理をする方法について説明します。

この章の項目は次のとおりです。

- 診断フレームワークの概要

- 診断フレームワークの動作

- 診断フレームワークの構成

- 問題の調査、報告および解決

- ヘルス・テスト・フレームワークの管理および実行

13.1 診断フレームワークの概要

Oracle Fusion Middlewareには、問題の検出、診断および解決を支援する診断フレームワークが含まれています。特に対象としている問題は、コードのバグ、メタデータの破損、顧客データの破損、スレッドのデッドロック、一貫性のない状態に起因する障害などのクリティカル・エラーです。

クリティカル・エラーが発生すると、そのエラーにはインシデント番号が割り当てられ、エラーの診断ログ(ログ・ファイルなど)が即座に取得され、その番号でタグ付けされます。データは、自動診断リポジトリ(ADR)に格納されます。ADRでは、後でデータをインシデント番号によって取得し、分析することができます。

診断フレームワークの目標は、次のとおりです。

- 初期障害の診断

- 問題が検出された後の損害および中断の抑制

- 問題の診断時間の短縮

- 問題の解決時間の短縮

- 顧客とOracleサポートのやり取りの簡略化

診断フレームワークに組み込まれているテクノロジは次のとおりです。

- 初期障害時の診断データの自動取得: クリティカルなエラーの場合、初期障害の段階でエラー情報を取得できると、問題が早期に解決され停止時間が短縮される可能性が大幅に増加します。診断フレームワークでは、スレッド・ダンプ、DMSメトリック・ダンプ、WebLogic診断フレームワーク(WLDF)のサーバー・イメージ・ダンプなどの診断情報を自動的に収集します。このような診断データは、飛行機のフライト・レコーダ「ブラック・ボックス」で収集されるデータに似ています。問題が検出されると、アラートが生成されて、障害診断インフラストラクチャがアクティブになり、診断データが取得されて格納されます。データはファイルベース・リポジトリに格納され、コマンドライン・ユーティリティでアクセスできます。

- 標準化されたログ形式: (ODLログ・ファイル形式を使用して)Oracle Fusion Middlewareのすべてのコンポーネントにわたってログ形式が標準化されていると、管理者およびOracleサポートのスタッフが、問題を分析するためのツールの単一セットを使用できます。問題の診断はさらに容易となり、停止時間は短縮されます。

- 診断ルール: それぞれのコンポーネントでは、特定のログ・メッセージによりインシデントを作成するかどうか、およびどのダンプを実行するかを評価する際に使用する診断ルールを定義します。診断ルールでは、個々のダンプの作成を同期で行うか非同期で行うかということも示します。
また、ドメイン、サーバーあるいはドメインまたはサーバー内のアプリケーションに適用されるカスタム・ルールを定義できます。

- インシデント検出ログ・フィルタ: インシデント検出ログ・フィルタには、java.util.loggingフィルタが実装されています。これにより、それぞれのログ・メッセージを検証し、コンポーネントおよびアプリケーションの診断ルールに基づいて、インシデントを作成するかどうかを判断します。

- インシデント・パッケージ化サービス(IPS)およびインシデント・パッケージ: IPSを使用すると、対応するインシデントのあるクリティカル・エラーに関する診断データ(ログ・ファイル、ダンプ、レポートなど)を自動的かつ容易に収集し、それらのデータをzipファイルにパッケージ化してOracleサポートに転送できます。診断フレームワークで検出されたクリティカル・エラーに関連する診断データはすべて、インシデントとして取得され、ADRに格納されます。インシデント・パッケージ化サービスでは、必要なファイルを自動的に特定してzipファイルに追加します。
zipファイルを作成する前に、IPSはまず、インシデント・パッケージという中間論理構造に診断データを収集します。パッケージは自動診断リポジトリに格納されます。必要に応じて、この中間論理構造にアクセスして、その内容を表示および修正したり、詳細な診断データをいつでも追加または削除できます。さらに、準備ができたらパッケージからzipファイルを作成し、Oracleサポートにアップロードできます。

- WebLogic診断フレームワーク(WLDF)との統合: Oracle Fusion Middleware診断フレームワークでは、クリティカル・エラー検出時にWebLogic Serverのイメージを取得するなど、WebLogic診断フレームワーク(WLDF)の一部の機能を統合しています。WLDFは、監視と診断を行うフレームワークであり、WebLogic Serverプロセス内で稼働してサーバーの標準的なライフサイクルの一部となる一連のサービスを定義および実装します。WLDFを使用して、稼働中のサーバー、およびコンテナ内にデプロイされたアプリケーションで生成された診断データを作成、収集、分析、アーカイブし、そのデータにアクセスできます。このデータにより、サーバーおよびアプリケーションの実行時のパフォーマンスに関する指標が提供され、障害発生時に失敗を隔離して診断することができます。
Oracle Fusion Middleware診断フレームワークは、次のようなWLDFのコンポーネントと統合しています。

- WLDF監視および通知。指定された条件の特定のログおよびメトリックを監視し、条件が満たされると通知を送信します。通知には、JMX通知や診断イメージを作成する通知など、いくつかの種類があります。Oracle Fusion Middleware診断フレームワークは、WLDF監視および通知コンポーネントと統合してインシデントを作成します。

- 診断イメージ・キャプチャ。問題の診断に使用される、サーバーの主要な状態の最も一般的なソースを収集します。これは、その状態を単一のアーティファクト、診断イメージにパッケージ化します。Oracle Fusion Middleware診断フレームワークにより、アーティファクトはADRに書き込まれます。

WLDFの詳細は、『Oracle Fusion Middleware Oracle WebLogic Server診断フレームワークの構成と使用』を参照してください。

13.1.1 インシデントと問題について

クリティカル・エラーを円滑に診断および解決するために、診断フレームワークには、問題とインシデントという、Oracle Fusion Middlewareの2つの概念が導入されています。

問題とは、クリティカル・エラーです。クリティカル・エラーは、内部エラーなどのサーバー・エラーとして発生します。問題はADRで追跡されます。それぞれの問題には問題キーがあります。これは、問題を記述したテキスト文字列です。これには、エラー・コード(XXX-nnnnnという形式)と、場合によってはエラー固有の他の値が含まれます。

インシデントとは、1回の問題発生情報です。問題(クリティカル・エラー)が複数回発生すると、インシデントはそれぞれの発生分に対して作成されます。インシデントにはタイムスタンプが付与され、ADRで追跡されます。それぞれのインシデントは数字のインシデントIDで識別されます。このインシデントIDは、ADRホーム内で一意です。インシデントが発生すると、診断フレームワークでは次の処理を実行します。

- インシデントに関する初期障害診断データをダンプ・ファイルの形式(インシデント・ダンプ)で収集します。

- そのインシデント用に作成されたADRサブディレクトリにインシデント・ダンプを格納します。

- インシデント・ダンプをインシデントとともにADRに登録します。

13.1.1.1 インシデントのフラッド制御

問題によって、短期間の間に数十、場合によっては数百ものインシデントが生成されることも考えられます。その場合、生成される診断データが多すぎて、ADRの領域が大量に消費され、問題の診断および解決に手間がかかることにもなります。そのため、診断フレームワークでは、特定のしきい値に達したときにインシデントの生成に対してフラッド制御を適用します。フラッド制御インシデントは、ADRに記録されないインシデントです。かわりに、診断フレームワークによって、WARNINGレベルのメッセージがログ・ファイルに書き込まれ、oracle.dfw.incident.Incidentオブジェクトが返されます。フラッド制御インシデントは、診断データによりシステムに過大な負荷をかけることなく、クリティカル・エラーが継続的に発生していることを知らせる手段となります。

デフォルトでは、問題キーが同じインシデントが60分以内に6件以上発生すると、それ以降、問題キーが同じインシデントはフラッド制御されます。この値はMBeanを使用して変更できます(第13.3項を参照)。

13.1.2 診断フレームワークのコンポーネント

次の各項目で、診断フレームワークの主要コンポーネントについて説明します。

- 自動診断リポジトリ

- 診断ダンプ

- 管理MBean

- 診断フレームワーク用WLSTコマンド

- ADRCIコマンドライン・ユーティリティ

注意:

診断フレームワーク、特に自動診断リポジトリを使用するには、管理対象サーバーにOracle JRFが適用されている必要があります。Oracle JRFが適用されていれば、各管理対象サーバーに対して次のディレクトリが存在します。

DOMAIN_HOME/SERVERS/server_name/adr

ディレクトリが存在しない場合は、次のいずれかの手順を実行します。

- 第19.3.1項の説明に従って、Oracle JRFを適用します。

- Oracle JRFが適用されている場合は、第4.2.1項で説明しているように、ノード・マネージャのプロパティstartScriptEnabledがtrueに設定されていることを確認して、サーバーを再起動します。

13.1.2.1 自動診断リポジトリ

自動診断リポジトリ(ADR)は、追跡データやダンプなどのOracle Fusion Middleware診断データ用のファイルベースの階層リポジトリです。Oracle Fusion Middlewareのコンポーネントでは、インシデント・データはすべてADRに格納されます。それぞれのOracle WebLogic Serverでは、ADR内の自身のホーム・ディレクトリのサブディレクトリに診断データが格納されます。たとえば、それぞれの管理対象サーバーおよび管理サーバーにはADRホーム・ディレクトリがあります。

ADRのルート・ディレクトリは、ADRベースと呼ばれています。デフォルトでは、ADRベースは次のディレクトリにあります。

DOMAIN_HOME/servers/server_name/adr

ADRベースの中に、複数のADRホームがある場合があります。それぞれのADRホームは、Oracle WebLogic Serverの特定のインスタンスに対し、すべてのインシデント・データのルート・ディレクトリになります。次のパスは、ADRホームの場所を示します。

ADR_BASE/diag/ofm/domain_name/server_name

図13-1は、Oracle WebLogic ServerインスタンスのADRホームのディレクトリ階層を示しています。

図13-1 Oracle Fusion MiddlewareのADRディレクトリ構造

「図13-1 Oracle Fusion MiddlewareのADRディレクトリ構造」の説明

ADRホームのサブディレクトリには、次の情報が含まれています。

- alert: XML形式のアラート・ログ。

- incident: 複数のサブディレクトリを格納できるディレクトリ。それぞれのサブディレクトリには、当該のインシデントの名前が付けられます。サブディレクトリの名前はincdir_nで、このnはインシデントの番号を表しています。それぞれのサブディレクトリには、そのインシデントのみに関する情報および診断ダンプが格納されます。

- (others): ADRホームのその他のサブディレクトリ。インシデント・パッケージなどの情報が格納されます。

注意:

ADRでは、インシデントをパッケージ化する際に、製品IDとしてドメイン名を使用し、インスタンスIDとしてサーバー名を使用します。ただし、いずれかの名前が30文字を超える場合は、ADRは名前の一部を切り捨てます。また、ドル記号($)と空白文字はアンダースコアに置き換えられます。

13.1.2.2 診断ダンプ

診断ダンプは、特定の診断情報を取得およびダンプします。この処理は、インシデントが作成された時点では自動で、管理者が要求した時点では手動で行われます。インシデント作成の一環として実行される場合、ダンプは一連のインシデント診断データに含まれます。診断ダンプには、JVMスレッド・ダンプ、JVMクラス・ヒストグラム・ダンプ、DMSメトリック・ダンプなどがあります。診断ダンプのリストについては、表13-7を参照してください。

13.1.2.3 管理MBean

診断フレームワークには、診断フレームワークの構成に使用できるMBeanが用意されています。たとえば、フラッド制御を有効化または無効化したり、指定された期間内に問題キーが同じインシデントが何回発生できるかを構成できます。管理MBeanを使用して診断フレームワークを構成する方法の詳細は、第13.3項を参照してください。

また、MBeanを使用すると、インシデントの問合せおよび作成を行ったり、使用可能な診断ダンプ・タイプのリストを検索したり、個々の診断ダンプを実行することができます。

13.1.2.4 診断フレームワーク用WLSTコマンド

診断フレームワークには、問題およびインシデントに関する情報の表示、インシデントの作成、特定のダンプの実行および一連の診断ダンプ・タイプの問合せに使用できるWLSTコマンドが用意されています。詳細は、次を参照してください。

- 第13.4.2.1項「問題の確認」

- 第13.4.2.2項「インシデントの確認」

- 第13.4.4.1項「診断ダンプの一覧表示」

- 第13.4.4.2項「診断ダンプの説明の表示」

- 第13.4.4.3項「ダンプの実行」

- 第13.4.6.1項「インシデントの手動作成」

- Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスの診断フレームワークのカスタムWLSTコマンドに関する項
診断フレームワークのカスタムWLSTコマンドを使用するには、Oracle共通ホームからWLSTスクリプトを起動する必要があります。詳細は、第3.5.1.1項を参照してください。

13.1.2.5 ADRCIコマンドライン・ユーティリティ

ADRコマンド・インタプリタ(ADRCI)は、問題を調査し、初期障害診断データをパッケージ化してOracleサポートにアップロードするという処理を、コマンドライン環境ですべて実行できるユーティリティです。またADRCIを使用して、ADR内のダンプ・ファイルの名前を表示したり、コンテンツ・フィルタを指定して(または未指定で)XMLタグが取り除かれた状態でアラート・ログを表示することもできます。

ADRCIは次のディレクトリにインストールされています。

(UNIX) MW_HOME/wlserver_10.3/server/adr
(Windows) MW_HOME\wlserver_10.3\server\adr

ADRCIコマンドライン・ユーティリティの使用の詳細は、次の各項を参照してください。

- インシデントのパッケージ化

- インシデントのパージ

関連項目:

- 『Oracle Databaseユーティリティ』の「ADRCI: ADRコマンド・インタプリタ」

- 『Oracle Database管理者ガイド』の「診断データの管理」

13.2 診断フレームワークの動作

診断フレームワークは、それぞれのサーバーでアクティブであり、構成された事前定義のルールに基づいてエラーを自動的に検出します。Oracle Fusion Middlewareのコンポーネントおよびアプリケーションは、常に監視対象となるため、自動的に診断フレームワークの恩恵を受けることになります。

インシデントは、次の2つの方法で自動的に検出されます。

- インシデント検出ログ・フィルタ。クリティカル・エラーを検出するように自動的に構成されます。

- WLDF監視および通知コンポーネント。診断フレームワークでは、事前定義された通知タイプをリスニングし、そのような通知を受信したときにインシデントを作成します。
WLDF監視および通知の構成の詳細は、第13.3.4項を参照してください。

- プログラムによるインシデント作成。一部のコンポーネントでは、インシデントを直接作成します。

図13-2は、インシデント・ログ検出でインシデントが検出された際の情報のやり取りを示しています。ここでは、インシデント・ログ検出でインシデントが検出されたときの、インシデント・ログ検出、WLDF診断イメージMBean、ADR、およびコンポーネントまたはアプリケーションのダンプの間のやり取りを示しています。

図13-2 インシデント・ログ検出で生成されるインシデント作成

図13-2「インシデント・ログ検出で生成されるインシデント作成」の説明

図13-2で示されている手順は、次のとおりです。

1. インシデント検出ログ・フィルタは、コンポーネントおよびアプリケーションの診断ルールで初期化されます。

2. アプリケーションまたはコンポーネント(ここではOracle WebCenter Portal)は、java.util.logging APIを使用して、メッセージをログに記録します。

3. ODLログ・ハンドラは、メッセージをインシデント検出ログ・フィルタに渡します。

4. インシデント・ログ検出フィルタは、ログ・メッセージを検証し、コンポーネントの診断ルールに基づいて、インシデントを作成するかどうかを判断します。診断ルールによりインシデントを作成する必要があると示された場合、ADRにインシデントが作成されます。

5. ODLログ・ハンドラは、ログ・メッセージをログ・ファイルに書き込み、制御をOracle WebCenter Portalに戻します。
インシデントが作成されると、次のようなメッセージがログ・ファイルに書き込まれます。

[2010-09-16T06:37:59.264-07:00] [dfw] [NOTIFICATION] [DFW-40104] [oracle.dfw]
[tid: 10] [ecid: 0000IF34gtMC8xT6uBf9EH1AgEck000000,0] [errid: 6]
[detailLoc: /oracle/config/base_domain/servers/AdminServer/adr/diag/ofm/base_domain/AdminServer]
[probKey: MDS-123456 [testComponent][testModule]] incident 6 created with
problem key "MDS-123456 [testComponent][testModule]", in directory
/oracle/config/base_domain/servers/AdminServer/adr/diag/ofm/base_domain/AdminServer/incident/incdir_6

6. 診断フレームワークは、コンポーネントの診断ルールで示される診断ダンプを実行します。

7. 診断フレームワークは、ADRの中の、インシデント用に作成されたディレクトリにダンプを書き込みます。

8. 診断フレームワークは、ADRに診断イメージを作成することを要求するWLDF診断イメージMBeanを呼び出します。

9. WLDFは、ADRに診断イメージを書き込みます。

図13-3は、WLDF監視および通知システムでインシデントが検出された際の情報のやり取りを示しています。ここでは、インシデント通知リスナー、WLDF監視および通知システム、WLDF診断イメージMBeanの間の情報のやり取りを示しています。

図13-3 WLDF監視および通知で生成されるインシデント作成

図13-3「WLDF監視および通知で生成されるインシデント作成」の説明

図13-3で示されている手順は、次のとおりです。

1. インシデント通知リスナーは、コンポーネントおよびアプリケーションの診断ルールで初期化されます。

2. Oracle Fusion Middleware診断フレームワークは、WLDFにJMX通知リスナーを登録します。リスナーは、WLDF監視および通知システムからのイベントをリスニングします。ここで処理される通知は、oracle.dfw.wldfnotificationタイプのみです。

3. システム内のなんらかが原因となって、構成されたWLDF監視がトリガーされ、インシデント通知リスナーに通知が送信されます。通知には、監視をトリガーする原因となったデータについて記述したイベント情報が含まれます。

4. 診断フレームワークにより、ADRにインシデントが作成されます。

5. 診断フレームワークは、診断ルールで示される診断ダンプを実行します。

6. 診断フレームワークは、ADRの中の、インシデント用に作成されたディレクトリにダンプを書き込みます。

7. 診断フレームワークは、ADRに診断イメージを作成することを要求するWLDF診断イメージMBeanを呼び出します。

8. WLDFは、ADRに診断イメージを書き込みます。

13.3 診断フレームワークの構成

診断フレームワークの一部の設定を構成できます。また、インシデントを作成するようにWLDF監視および通知を構成することもできます。次の各項目で、診断フレームワークを構成する方法を説明します。

- 診断フレームワークの設定の構成

- カスタム診断ルールの構成

- 問題抑制の構成

- 診断フレームワーク用のWLDF監視および通知の構成

13.3.1 診断フレームワークの設定の構成

次の設定を構成できます。

- ログ・ファイルを使用したインシデントの検出の有効化または無効化

- フラッド制御およびフラッド制御のパラメータ設定の有効化または無効化

これらの設定を構成するには、診断フレームワークMBean DiagnosticConfigを使用します。次に、MBeanのObjectNameを示します。

oracle.dfw:type=oracle.dfw.jmx.DiagnosticsConfigMBean,name=DiagnosticsConfig

表13-1は、DiagnosticConfig MBeanの属性と各パラメータの説明を示しています。

表13-1 診断フレームワークのDiagnosticConfig MBeanの属性

属性

説明

floodControlEnabled

フラッド制御を有効化または無効化します。有効化する場合はtrue、無効化する場合はfalseと指定します。デフォルトはtrueです。

フラッド制御は、手動で作成されたインシデントには適用されません。

floodControlIncidentCount

フラッド制御で制御されるまでに、floodControlIncidentTimeoutPeriodで指定された期間内に作成できる、問題キーが同じインシデントの数を設定します。デフォルトは5です。

フラッド制御が有効になっていて、同じ問題キーのインシデントの数がこのカウントを超えると、インシデントが作成されなくなります。ただし、診断フレームワークは、WARNINGレベルのメッセージをログ・ファイルに書き込みます。

floodControlIncidentTimeoutPeriod

フラッド制御で制御されるまでに、floodControlIncidentCountで指定された数の、問題キーが同じインシデントを作成できる期間を設定します。デフォルトは60分です。

incidentCreationEnabled

インシデント作成を有効化または無効化します。有効化する場合はtrue、無効化する場合はfalseと指定します。デフォルトはtrueです。

logDetectionEnabled

ログ・ファイルを使用したインシデントの検出を有効化または無効化します。有効化する場合はtrue、無効化する場合はfalseと指定します。デフォルトはtrueです。

maxTotalIncidentSize

すべてのインシデントに割り当てられる最大合計サイズを設定します。この制限に達すると、すべてのインシデントで使用される領域がこのパラメータで指定される量より小さくなるまで、最も古いインシデントから順にパージされます。

デフォルトは500MBです。インシデントの作成時にこの制限を超えた場合は、インシデントの作成が完了したときに、最も古いインシデントからパージされていきます。

reservedMemoryKB

OutOfMemoryErrorが検出されたときに解放される予約済メモリーの量。

診断フレームワークの起動時に、プライベートで使用されるメモリーが512 KB割り当てられます。診断フレームワークにより、サーバーにOutOfMemoryErrorが発生したことが検出されると、そのメモリーのブロックを解放して、インシデントの作成に進みます。

デフォルトは512KBです。

uncaughtExceptionDetectionEnabled

Javaベースの捕えられていない例外ハンドラを有効にします。これが有効のときに捕えられていない例外が検出されると、インシデントが作成されます。有効化する場合はtrue、無効化する場合はfalseと指定します。

デフォルトはtrueです。

useExternalCommands

スレッド・ダンプの実行に外部JVMコマンドを使用するかどうかを示します。有効化する場合はtrue、無効化する場合はfalseと指定します。デフォルトはtrueです。

次の例は、Fusion Middleware ControlシステムMBeanブラウザを使用してこれらの設定を構成する方法を示しています。

1. ターゲット・ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」ページが表示されます。

4. アプリケーション定義のBean→「oracle.dfw」→「domain.domain_name」→「dfw.jmx.DiagnosticsConfigMBean」を開きます。

5. DiagnosticConfigエントリのいずれかを選択します。DiagnosticConfigエントリは、各サーバーに1つずつあります。

6. 「アプリケーション定義のMBean」ペインで「MBean情報の表示」を開くと、サーバー名が表示されます。
次に、「システムMBeanブラウザ」ページを示します。

図dfw_config.gifの説明

7. 表13-1に一覧表示されている属性の値を変更するには、「値」フィールドで値を入力または選択します。

8. 「適用」をクリックします。

13.3.2 カスタム診断ルールの構成

ドメイン、サーバーあるいはドメインまたはサーバー内のアプリケーションに適用されるカスタム診断ルールを構成できます。

カスタム診断ルールは、特定の形式の.xmlファイル(この項の後半の例を参照)を作成することにより作成します。ファイルは次のいずれかの場所に保存する必要があります。

- ドメイン全体に適用されるルールの場合

DOMAIN_HOME/config/fmwconfig/dfw

- 特定のサーバーに適用されるルールの場合

DOMAIN_HOME/config/fmwconfig/servers/server_name/dfw

ファイル名には次の形式を使用する必要があります。

name.xml
appname#name.xml

この形式では、appnameは、ルールが適用されるアプリケーションの名前です。appnameは、デプロイされたアプリケーションの正確な名前である必要があります。nameは、指定するルールの名前です。appnameを指定しないと、ルールはサーバー全体に適用されます。たとえば、次のルールはmyAppアプリケーションに適用されます。

myApp#custom_rule.xml

カスタム診断ルール・ファイルには、ルールを定義するために次のような要素を含めることができます。

- ログ検出条件(オプション)
ルールが登録されているサーバーまたは指定されたアプリケーションに適用される診断ログ内でチェックする条件のセットを、logDetectionConditions要素内に定義できます。条件に一致するログ・メッセージが検出されると、インシデントが作成され、問題の特定に役立つ診断情報が取得されます。デフォルトでは、すべてのINCIDENT_ERRORメッセージが検出され、それらに対してインシデントが作成されます。また、特定のコンポーネントに対して、特定のメッセージを検出するルールを構成することもできます。

次の例は、4つのログ検出条件を定義するカスタム診断ルール・ファイルの一部を示しています。1つ以上の条件がtrueの場合、インシデントが作成されます。

<?xml version="1.0" encoding="UTF-8"?>
<diagnosticRules xmlns="http://www.oracle.com/DFW/DiagnosticsFrameworkRules" xmlns:xs="http://www.w3.org/2001/XMLSchema-instance">
<logDetectionConditions>
<condition messageSeverity="INCIDENT_ERROR"/>
<condition messageSeverity="ERROR" component="jrfServer_admin"/>
<condition messageSeverity="ERROR" module="test.servletA"/>
<condition messageId="FMW-40300"/>
</logDetectionConditions>

使用できる条件の説明は、表13-2を参照してください。

- 処理ルール
インシデントの作成にサーバー・ルールまたはアプリケーション・ルールが関わっている場合に評価される処理ルールを定義できます。たとえば、インシデントの作成にMyAppアプリケーションが関わっている場合、MyAppアプリケーションに関連付けられたすべてのルールが評価されます。どの場合にも、アプリケーションにかかわらず、サーバー全体に対するルールは常に評価されます。

処理ルールは次の2つの部分から構成されます。

- デフォルト・アクション(オプション)。指定されている場合は、インシデントの作成中に常に実行されます。アクションとは、実行する診断ダンプとオプションの引数のリストです。
次に、デフォルト・アクション・セットの例を示します。

<defaultActions>
<dumpAction name="odl.logs">
<argument name="timestamp" value="INCIDENT_TIME" valueType="fact"/>
</dumpAction>
<dumpAction name="dms.metrics"/>
</defaultActions>

使用できるオプションの引数の説明は、表13-3を参照してください。

- 条件ベースのアクション。これは、条件がtrueと評価された場合にのみ実行されます。各<rule>要素は、名前属性および子<ruleCondition>要素と子<ruleActions>要素から構成されます。<ruleActions>要素には、1つ以上のdumpAction要素が含まれます。<ruleCondition>要素属性のリストは、表13-4を参照してください。
1つの<rule>要素内に複数の<ruleCondition>要素が指定されている場合、すべての条件がtrueに評価される場合にのみdumpActionが実行されます。

次に、条件ベースのアクション・ルールの例を示します。MESSAGE_IDがDFW-99997の場合、条件がtrueと評価され、jvm.classhistogramダンプが実行されます。

<processingRules>
<rule name="OOME">
<ruleCondition>
<condition name="MESSAGE_ID" value="DFW-99997"/>
</ruleCondition>
<ruleActions>
<dumpAction name="jvm.classhistogram"/>
</ruleActions>
</rule>
</processingRules>

表13-2に、ログ検出条件を作成するために使用できる属性を示します。

表13-2 LogDetectionConditions要素の条件

条件

説明

messageSeverity

メッセージが記録されたログ・レベル。(これはODLログ・ファイルでのMESSAGE_LEVELフィールドです。)例: INCIDENT_ERROR、ERROR

messageId

メッセージのID。(これはODLログ・ファイルでのMESSAGE_IDフィールドです。)例: DFW-99997

component

コンポーネント名。(これはODLログ・ファイルでのCOMPONENT_IDフィールドです。)例: oracle.mds

module

メッセージを生成したモジュールの名前。(これはODLログ・ファイルでのMODULE_IDフィールドです。)

ODLログ・ファイル・フィールドの説明は、表12-1を参照してください。

表13-3に、<defaultActions>要素に対して使用できるオプションの引数を示します。

表13-3 defaultActions要素に対するオプションの引数

引数

説明

name

引数の名前。

value

引数の値。

type

引数のタイプ。有効な値は、次のとおりです。

- literal: このタイプを指定した場合は、引数のリテラル値が使用されます。これはデフォルトです。

- fact: このタイプを指定した場合は、値はINCIDENT_TIMEまたはECIDである必要があります。

- context: このタイプを指定した場合は、値はDMS実行コンテキストでの値の名前である必要があります。DMS実行コンテキストの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のDMS実行コンテキストに関する項を参照してください。

表13-4に、<ruleCondition>要素属性を示します。

表13-4 ruleCondition要素の属性

要素

説明

name

属性の名前を指定します。有効な値はvalueTypeに依存します。

- valueTypeがfactの場合は、有効な値はCOMPONENT_ID、MODULE_IDまたはMESSAGE_IDです。

- valueTypeがcontextの場合は、値はDMS実行コンテキストでの値の名前である必要があります。DMS実行コンテキストの詳細は、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のDMS実行コンテキストに関する項を参照してください。

operator

演算子。有効な値は、EQ、EQNoCase、NE、Contains、StartsWith、EndsWith、LT、GT、LE、GEです。デフォルトはEQです。

値では大/小文字が区別されます。

value

比較するリテラル値。

datatype

データ型。有効な値はStringまたはIntegerです。デフォルトはStringです。

値では大/小文字が区別されます。

valueType

引数のタイプ。

- fact

- context

カスタム診断ルールを作成してロードする手順は次のとおりです。

1. カスタム・ルールを含むファイルを作成します。
サンプル・カスタム・ルール・ファイルを次に示します。

<?xml version="1.0" encoding="UTF-8"?>
<diagnosticRules xmlns="http://www.oracle.com/DFW/DiagnosticsFrameworkRules" xmlns:xs="http://www.w3.org/2001/XMLSchema-instance">

<logDetectionConditions>
<condition messageSeverity="INCIDENT_ERROR"/>
// detect all message logged at level INCIDENT_ERROR
<condition messageSeverity="ERROR" component="jrfServer_admin"/>
// detect all "jrfServer_admin" component messages logged at level ERROR
<condition messageSeverity="ERROR" module="test.servletA"/>
// detect all "test.servlet" module messages logged at level ERROR
<condition messageId="FMW-40300"/>
// detect message "FMW-40300"
</logDetectionConditions>

<defaultActions>
<dumpAction name="odl.logs">
<argument name="timestamp" value="INCIDENT_TIME" valueType="fact"/>
</dumpAction>
<dumpAction name="dms.metrics"/>
</defaultActions>

<processingRules>
<rule name="OOME">
<ruleCondition>
<condition name="MESSAGE_ID" value="DFW-99997"/>
</ruleCondition>
<ruleActions>
<dumpAction name="jvm.classhistogram"/>
</ruleActions>
</rule>
</processingRules>

</diagnosticRules>

2. 拡張子.xmlを含む名前を付けて、ファイルを保存します。ルールがアプリケーションに適用される場合は、ファイル名の前にapp_name#を付けます。ファイルを次のいずれかの場所に保存します。

DOMAIN_HOME/config/fmwconfig/dfw
DOMAIN_HOME/config/fmwconfig/servers/server_name/dfw

3. WLSTコマンドreloadCustomRulesを使用して、ルールをロードします。次の例は、myAppアプリケーションに適用されるcustomrules.xmlルールをロードします。

reloadCustomRules(name='myApp#customrules.xml')

ドメイン内のすべてのルール、または特定のサーバーに関連するすべてのルールを再ロードできます。次の例は、soa_server1サーバーに対するすべてのルールを再ロードします。

reloadCustomRules(server='soaserver1')

reloadCustomRulesコマンドの詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の「reloadCustomRules」を参照してください。

13.3.3 問題抑制の構成

一定の状況では、特定の問題キーに基づいてインシデントの作成を抑制する必要がある場合があります。たとえば、開発環境で、サーブレットを開発しているときに、コードを調整すると捕えられていない例外が多数生成されることがあります。これにより、不要なインシデントが作成されます。

診断フレームワークによって、フィルタ条件と一致する問題でインシデントが作成されないように問題抑制フィルタを構成できます。

問題抑制フィルタを構成する場合は、マッチするパターンを表す正規表現を使用します。java.util.regexクラスを使用して、正規表現とのマッチが行われます。次に例を示します。

- 次の正規表現では、インシデントがMDS-5000で始まる問題キーとマッチされます。

MDS-5000.*

- 次の正規表現は、テキストOutOfMemoryを含む問題とマッチします。正規表現では大/小文字が区別されるため、テキストoutofmemoryを含む問題とはマッチしません。

.*OutOfMemory.*

DiagnosticConfig MBeanを使用すると、フィルタを追加および削除したり、フィルタ・リストまたは1つのフィルタの詳細を取得できます。

表13-5は、構成中の問題抑制フィルタの操作および属性とそれぞれの説明を示しています。

表13-5 問題抑制フィルタのDiagnosticConfig MBeanの操作および属性

操作および属性

説明

操作:

addProblemKeyFilter(filter_pattern)

新しい問題抑制フィルタを追加します。マッチするパターンを表す正規表現に渡します。次に例を示します。

addProblemKeyFilter(".*OutOfMemory.*)

属性:

getProblemKeyFilters()

構成済の問題抑制フィルタのリストを返します。次に例を示します。

getProblemKeyFilters()

操作:

getProblemKeyFilter(filterID)

特定IDに関連するフィルタ・パターンを返します。次に例を示します。

getProblemKeyFilter(id)

IDを検索するには、getProblemKeyFilters()操作を使用します。

操作:

removeProblemKeyFilter(filterID)

任意のフィルタIDに関連するフィルタ・パターンを削除します。次に例を示します。

removeProblemKeyFilter(id)

問題抑制フィルタを構成する手順は次のとおりです。

1. Fusion Middleware Controlのターゲット・ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」ページが表示されます。

4. アプリケーション定義のBean→「oracle.dfw」→「domain.domain_name」→「dfw.jmx.DiagnosticsConfigMBean」を開きます。

5. DiagnosticConfigエントリのいずれかを選択します。DiagnosticConfigエントリは、各サーバーに1つずつあります。

6. 「アプリケーション定義のMBean」ペインで、「操作」タブを選択します。

7. addProblemKeyFilterをクリックします。操作: addProblemKeyFilterページが、次の図のように表示されます。
図problemkeyfilter.gifの説明

8. 「値」に、マッチするパターンを表す正規表現を入力します。たとえば、開発環境では、java.lang.IllegalStateExceptionというJava例外が報告されたときにインシデントが作成されないようにフィルタを追加する必要がある場合があります。この場合、次のように入力します。

".*[java.lang.IllegalStateException].*"

9. 「起動」をクリックします。

10. 「戻る」をクリックし、「アプリケーション定義のMBean」ページに戻ります。

removeProblemKeyFilter操作を使用すると、フィルタを削除できます。

getProblemKeyFilter操作にフィルタIDを渡すと、特定のフィルタを取得できます。

また、次のようにgetProblemKeyFilters属性を使用すると、フィルタのリストを取得できます。

1. ターゲット・ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」ページが表示されます。

4. アプリケーション定義のBean→「oracle.dfw」→「domain.domain_name」→「dfw.jmx.DiagnosticsConfigMBean」を開きます。

5. DiagnosticConfigエントリのいずれかを選択します。DiagnosticConfigエントリは、各サーバーに1つずつあります。

6. 「アプリケーション定義のMBean」ペインで、「属性」タブを選択します。

7. ProblemKeyFiltersをクリックします。
問題抑制フィルタのリストが表示されます。

13.3.4 診断フレームワーク用のWLDF監視および通知の構成

Fusion Middlewareでは、監視および通知の一連のルールが含まれているWLDF診断モジュールを構成します。そのルールは、特定の一連のクリティカル・エラーを検出し、それらのエラーが発生するたびにインシデントを作成するためのものです。このモジュールはモジュールFMWDFWと呼ばれ、次の一連の監視条件が含まれます。

名前

説明

Deadlock

複数のJavaスレッドで、Java Monitorオブジェクトを使用する際に循環ロック・チェーンがあります。

StuckThread

Oracle WebLogic ServerのExecuteThread。Oracle WebLogic ServerのStuckThreadMaxTimeパラメータで指定された時間より多くの期間、ブロックされているかビジー状態です。

UncheckedException

このカテゴリには、未チェックの例外、実行時の例外、およびNullPointerException、StackOverflowError、OutOfMemoryErrorなどのOracle WebLogic ServerのExecuteThreadで捕捉されたエラーがすべて含まれます。

診断モジュールには、oracle.dfw.wldfnotificationタイプの、構成されたWLDF JMX通知FMWDFW-notificationも含まれます。このWLDF JMX通知は、インシデントを作成するために、独自のWLDF監視条件で再利用することもできます。

1. 第3.4.1項の説明に従って、管理コンソールを表示します。

2. 左ペインで、「診断」を開き、「診断モジュール」を選択します。
「診断モジュールのサマリー」ページが表示されます。

3. 「Module-FMWDFW」をクリックします。
「Module-FMWDFWの設定」ページが表示されます。

4. 次の図に示す「監視と通知」タブを選択します。
図dfw_notif.gifの説明

5. 「監視」タブを選択し、「新規」をクリックします。
「監視の作成」ページが表示されます。

6. 「名前」に、監視の名前を入力します。
任意の名前を入力できます。または、次の形式を使用し、診断フレームワークでカスタム・メッセージIDが使用されるようにすることができます。

message-id#[application_name]#any_text

メッセージIDは、1から6文字の接頭辞と1から6桁の数字で構成されます。アプリケーション名はオプションです。次に例を示します。

SOA-40500#My_Watch_Name

次の例では、アプリケーション名soa_infraを使用しています。

SOA-40501#soa-infra#My_Watch_Name

診断フレームワークでは、インシデント問題キーの構成時にメッセージIDをインシデント・メッセージIDとして使用します。

7. 「監視のタイプ」で、タイプを選択します(「サーバー・ログ」など)。

8. 「次へ」をクリックします。

9. 「現在の監視ルール」で式を作成します。たとえば、式(SEVERITY = 'Error') AND (MSGID = 'BEA-000337')を作成する手順は、次のとおりです。

1. 「式の追加」をクリックします。

2. 「メッセージ属性」で、「重大度」を選択します。

3. 「演算子」で、=を選択します。

4. 「値」に、ERRORと入力します。

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

6. 「式の追加」をクリックします。

7. 「メッセージ属性」で、MSGIDを選択します。

8. 「演算子」で、=を選択します。

9. 「値」に、BEA-000337と入力します。

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

11. 「監視の作成」ページで、選択されている演算子がANDであることを確認します。

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

10. 「次へ」をクリックします。

11. アラーム・タイプを選択して、「次へ」をクリックします。

12. 「通知」で、FMWDFW-notificationを選択し、これを「選択済み」ボックスに移動します。

13. 「終了」をクリックします。

監視の作成の詳細は、管理コンソールのオンライン・ヘルプの監視ルールの式の作成に関する項を参照してください。

13.4 問題の調査、報告および解決

この項では、WLSTコマンドおよびADRCIコマンドとRemote Diagnostic Agent(RDA)を使用して、問題(クリティカル・エラー)を調査および報告し、場合によっては問題を解決する方法について説明します。初めに、実行する必要がある典型的な一連の作業をまとめたロードマップを示します。次の項目について説明します。

- ロードマップ—問題の調査、報告および解決

- 問題およびインシデントの確認

- 特定の問題キーの分析

- 診断ダンプの処理

- 診断ダンプ・サンプリングの構成と使用

- インシデントの管理

- RDAレポートの生成

13.4.1 ロードマップ—問題の調査、報告および解決

一般的に、問題の調査、報告および解決は、クリティカル・エラーの発生から始まります。この項では、そのワークフローの概要について説明します。

図13-4は、問題を調査、報告および解決するためのタスクを示しています。

図13-4 問題調査のフロー

「図13-4 問題調査のフロー」の説明

次に、図13-4に示しているワークフローについて説明します。

1. システム、コンポーネントまたはアプリケーションが想定どおりに機能していないことがわかります。たとえば、パフォーマンスに問題があることがわかったり、アクセスしようとしているアプリケーションでエラーが報告されているとユーザーから報告があった場合などです。

2. 観察された症状に関連する可能性のある問題およびインシデントが作成されているかどうかを確認します。

1. 一連の問題を確認するには、第13.4.2.1項の説明に従って、WLSTのlistProblemsコマンドを使用します。

2. 問題が作成されている場合、第13.4.2.2項の説明に従って、listIncidentsコマンドを使用して、特定の問題に関連するインシデントを一覧表示します。

3. インシデントが作成されていない場合は、ステップ4に進みます。インシデントが作成されている場合は、ステップ5に進みます。

4. 問題に関連しているインシデントを確認できない場合は、createIncidentコマンドを使用してインシデントを手動で作成し、問題の診断情報を取得することができます。

ソフトウェアの障害やパフォーマンスの問題などに直面して詳細な診断データを収集する必要がある場合は、インシデントを作成することを検討してください。ログ・ファイルとその中のメッセージを表示できます。直面している問題に関連すると思われるメッセージがあったら、createIncidentコマンドでそのメッセージIDを使用できます。

インシデントの作成の詳細は、第13.4.6.1項を参照してください。

5. 特定のインシデントの詳細を確認するには、第13.4.2.2項の説明に従って、showIncidentコマンドを使用します。このコマンドを実行すると、関連するメッセージID、インシデントの時刻、ECID、インシデントで生成されたファイルなど、インシデントに関する情報が一覧表示されます。

6. 第13.4.2.2項の説明に従って、getIncidentFileコマンドを使用して、インシデントのファイルの内容を表示します。その内容には、問題の原因を導き出し、その解決に役立つ情報が含まれる可能性があります。

7. インシデントのファイルの内容が問題の解決に役立たなかった場合、追加のダンプを実行して詳細な診断情報を確認できます。たとえば、パフォーマンスの問題に直面した場合は、dms.metricsダンプを実行します。使用可能なダンプおよびその実行方法の詳細は、第13.4.4項を参照してください。

8. それでも問題が解決できない場合は、RDAレポートとともにインシデントをパッケージ化して、Oracleサポートにお送りください。インシデントのパッケージ化およびRDAレポートの生成の詳細は、第13.4.6.2項および第13.4.7項を参照してください。

13.4.2 問題およびインシデントの確認

次の各項で説明するように、WLSTコマンドライン・ユーティリティを使用して、一連の問題、インシデントのリスト、および特定のインシデントの詳細を確認できます。

- 問題の確認

- インシデントの確認

13.4.2.1 問題の確認

一連の問題を確認するには、次の形式でWLSTのlistProblemsコマンドを実行します。

listProblems([adrHome] [,server])

listProblemsコマンドを実行すると、ADRホームの問題が一覧表示されます。それぞれの問題では、IDが一意です。

listProblems()
Problem Id      Problem Key
1       BEA-101020 [HTTP]

13.4.2.2 インシデントの確認

次の形式でWLSTのlistIncidentsコマンドを実行して、すべての使用可能なインシデントまたは特定の問題に関連するインシデントをリストできます。

listIncidents([id], [ADRHome])

たとえば、すべてのインシデントのリストを表示するには、次のコマンドを使用します。

listIncidents()
Incident Id     Problem Key              Incident Time
2       BEA-101020 [HTTP]        Fri Feb 26 13:42:01 PDT 2010
1       BEA-101020 [HTTP]        Tue Feb 23 06:17:39 PDT 2010

特定の問題に関連するインシデントを確認するには、次のコマンドを使用します。

listIncidents(id='1')
Incident Id     Problem Key              Incident Time
2       BEA-101020 [HTTP]        Fri Feb 26 13:42:01 PDT 2010
1       BEA-101020 [HTTP]        Tue Feb 23 06:17:39 PDT 2010

特定のインシデントの詳細を確認するには、次の形式でWLSTのshowIncidentコマンドを使用します。

showIncident(id, [adrHome] [,server])

たとえば、インシデント1の詳細を確認するには、次のコマンドを使用します。

showIncident(id='1')
Incident Id: 1
Problem Id: 1
Problem Key: BEA-101020 [HTTP]
Incident Time: Tue  Feb 23 06:17:39 PDT 2010
Error Message Id:  BEA-101020
Execution Context: 0000IExqUvyAhKB5JZ4Eyf1Afdj600009i
Flood Controlled: false
Dump Files :
dms_ecidctx1_i1.dmp
jvm_threads2_i1.dmp
dms_metrics3_i1.dmp
odl_logs4_i1.dmp
odl_logs5_i1.dmp
diagnostic_image_AdminServer_2010_02_23_06_17_42.zip
readme.txt

インシデントのファイルの内容を確認するには、次の形式でWLSTのgetIncidentFileコマンドを使用します。

getIncidentFile(id, name [,outputFile] [,adrHome] [,server])

たとえば、ファイルodl_logs4_i1.dmpの内容を確認するには、次のコマンドを使用します。

getIncidentFile(id='1', name='odl_logs4_i1.dmp', outputFile='/tmp/odl_logs4_i1_dmp.output')

このコマンドは、出力をファイルodl_logs4_i1_dmp.outputに書き込みます。

13.4.3特定の問題キーの分析

診断フレームワークは、未処理の例外について明確に定義された一連の問題キーを提供します。これらの例外は、既存のWLDF監視のUncheckedException、または診断フレームワークのjava.lang.Thread.UncaughtExceptionHandlerという捕えられていない例外ハンドラのいずれかによって検出されます。これまで、診断フレームワークは、同一タイプの問題に様々な形式で問題キーを生成していました。表13-6は、これらの問題キーとそれらを使用して問題を調査する方法について説明しています。

表13-6 捕えられていない例外の問題キー

例外

問題キー

説明

java.land.OutOfMemoryError

DFW-99997 [java.land.OutOfMemoryError]

すべてのjava.lang.OUtOfMemoryErrorインシデントで使用されます。このタイプの各インシデントによって、jvm.classhistogramダンプが実行されます。ダンプは、ロードされたクラスのインスタンスと関連オブジェクトの数に関する統計を取得します。

このダンプの内容を確認し、JVMメモリーに何がロードされたかを理解するための効率的な手がかりとなる情報を見つけてください。また、dms.metricsダンプは、全体的なJVMメモリーに関する統計を記録します。

java.sql.SQLException

DFW-99996 [ora-code|java.sql.SQLException]][package.class.method][app-name]

サブクラスを含むjava.sql.SQLExceptionタイプのすべての例外に使用されます。診断フレームワークは、例外エラー・メッセージからOracleエラー・コードの抽出を試み、成功した場合はそのコードを問題キーに使用します。失敗した場合は、例外名を使用します。

例外に関連するテキストを確認し、データベースで実行されなかった操作などの詳細を取得します。さらに、SQLエラー・コードの詳細で追加情報を確認できます。

その他すべて

DFW-99998 [exception-name][package.class.name][app-name]

固有の方法では処理されないその他すべての例外タイプ(java.lang.NullPointerException、java.io.IOException、java.lang.StringIndexOutOfBoundsExceptionなど)で使用されます。

例外に関連付けられたテキストを確認し、障害の理由などの詳細を取得します。問題キーのソース行で障害の場所が示されている可能性があります。

13.4.4 診断ダンプの処理

問題が疑われる場合、組込みの診断ダンプを利用して、問題の診断に役立つ詳細な診断結果を報告できます。診断ダンプは、診断データを出力および記録する手段を提供します。診断データは、Oracle Fusion Middlewareのコンポーネント、アプリケーションおよびインフラストラクチャに関する問題を診断する際に有益な情報になります。これらのダンプからの出力は、Oracle Fusion Middlewareに関する問題を診断するために、顧客およびOracleサポートが使用することを想定しています。

診断ダンプは、次のように実行します。

- 手動。次の各項で説明するように、WLSTコマンドを使用します。
たとえば、Java EEアプリケーションがハングしてデッドロックが疑われる場合には、jvm.threadsダンプを使用して一連のスレッドを取得できます。

- 自動。診断フレームワークがクリティカル・エラーを検出してインシデントを作成した場合、または管理者がインシデントを作成した場合。

13.4.4.1 診断ダンプの一覧表示

管理対象サーバーで使用可能な診断ダンプのリストを検索するには、次の形式でWLSTのlistDumpsコマンドを実行します。

listDumps([appName] [,server])

たとえば、soa_server1で使用可能なダンプを一覧表示するには、次のコマンドを使用します。

listDumps(server='soa_server1')
Location changed to domainRuntime tree. This is a read-only tree with DomainMBean as the root.
For more help, use help(domainRuntime)

odl.activeLogConfig
jvm.classhistogram
dms.ecidctx
wls.image
odl.logs
dms.metrics
odl.quicktrace
http.requests
jvm.threads

Use the command describeDump(name=<dumpName>) for help on a specific dump.

表13-7は、Oracle Fusion Middlewareで定義される診断ダンプ操作とその説明を記載したものです。

表13-7 診断ダンプ操作

ダンプ操作

説明

dms.ecidctx

特定の実行コンテキストID(ECID)が指定されている場合は、それに関連付けられたデータ。指定されていない場合は、使用可能なすべてのECIDに関連付けられたデータ。

dms.metrics

ダイナミック・モニタリング・サービス(DMS)メトリック。これらのメトリックについては、『Oracle Fusion Middlewareパフォーマンスおよびチューニング・ガイド』のダイナミック・モニタリング・サービス(DMS)に関する項を参照してください。

http.requests

現在アクティブなHTTPリクエストのサマリー。

jvm.classhistogram

JVMクラス・ヒストグラム。その出力内容は、JVMベンダーによって異なります。

jvm.flightRecording

アクティブなJRockitフライト・レコーダの記録。

jvm.threads

JVMで実行中のスレッド、および完全なスレッド・ダンプを実行中のスレッドに関する統計サマリー。

odl.activeLogConfig

アクティブなJavaロギング構成。

odl.logs

ECIDまたは時間範囲で関連付けられる診断ログの内容。

odl.quicktrace

クイック・トレース・メッセージ

wls.image

WLDFサーバー・イメージ・ダンプ。

また、Oracle SOA Suiteでは、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』のSOAコンポジット・アプリケーションを使用した問題の診断に関する説明の説明に従って、診断ダンプが提供されます。

13.4.4.2 診断ダンプの説明の表示

WLSTのdescribeDumpコマンドを使用して、ダンプを実行する際の構文など、特定のダンプの説明を表示できます。目的のダンプの名前を指定します。たとえば、dms.metricsダンプの説明を表示するには、次のコマンドを使用します。

describeDump(name='dms.metrics')
Name: dms.metrics
Description: Dumps DMS (Dynamic Monitoring Service) metrics.
Mandatory Arguments:
Optional Arguments:
Name        Type     Description
format      STRING   Format of the dump output; raw or xml

13.4.4.3 ダンプの実行

問題を検出して追加の診断データを収集する場合、指定したダンプに対してexecuteDumpコマンドを起動します。それぞれのダンプには、必須またはオプション、あるいはその両方の引数があります。特定のダンプの引数やその指定方法を確認するには、第13.4.4.2項の説明に従って、describeDumpコマンドを使用します。

次の例では、名前がdms.metricsでインシデントIDが1のダンプを実行し、それをファイルdumpout.txtに書き込んでいます。

executeDump(name='dms.metrics', outputFile='/tmp/dumpout.txt', id='1')
Dump file dms_metrics1_i1.dmp added to incident 1

このコマンドは、ダンプ出力をインシデント1に関する情報に書き込みます。インシデント1に対してshowIncidentコマンドを実行すると、出力結果にはdms_metrics1_i1.dmpが含まれます。

13.4.5 診断ダンプ・サンプリングの構成と使用

診断ダンプ・サンプリングは、指定された間隔で診断ダンプの出力を取得します。定期的な間隔でサンプルを取得する診断ダンプ・サンプリングにより、低速なWebリクエストなどの問題や、これらのリクエストのどこで処理が実行されているなどを特定できます。

この項の内容は、次のとおりです。

- 診断ダンプ・サンプリングについて

- ダンプ・サンプリングの構成

- ダンプ・サンプリングのリスト

- ダンプ・サンプリング出力の取得

13.4.5.1 診断ダンプ・サンプリングについて

すべての診断ダンプ・サンプリングは、指定した間隔で、バックグラウンドで実行されます。デフォルトでは、jvm.threadsおよびjvm.classhistogramダンプがサンプリング用に構成されています。デフォルト・ダンプ・サンプリングに対する設定を変更し、また表13-7に示したダンプ操作およびアプリケーション固有のダンプに対して新しいサンプリング定義を作成できます。サンプリング間隔やサーバーなどについて異なる設定を指定して、同じ診断ダンプに対して複数のサンプリング定義を構成できます。

各診断ダンプ・サンプリングに対して、診断フレームワークにより、指定された数のサンプルが保存されます。上限に達すると、最も古いサンプルからパージされます。サーバーの停止時にはすべてのサンプルがパージされます。

表13-8に、デフォルトで構成されているダンプ・サンプリングの設定を示します。

表13-8 デフォルトの診断ダンプ・サンプリング構成

ダンプ名

サンプリング間隔

保存される最大サンプル数

jvm.threads

60秒

10

jvm.classhistogram

30分

5

診断フレームワークにより、インシデントが作成されるたびに(エラー検出またはインシデントの手動作成により)、ダンプ・サンプルの取得がトリガーされます。また、ダンプ・サンプルの内容を取得することもできます(第13.4.5.4項を参照)。

ダンプ・サンプル・アーカイブは、テキストまたはzipファイルとして取得できます。

- テキスト: デフォルトでは、診断ダンプ・サンプルはテキスト形式で1つのアーカイブ・ファイルに連結されます。アーカイブ・ファイル内では、各サンプルはASCIIヘッダーとフッターによりラップされます。ヘッダーには、サンプルを生成した診断ダンプのタイムスタンプと名前が含まれます。ヘッダーとフッターの両方に、アーカイブ内のサンプルの数と、その特定のサンプルの番号が含まれます。次に例を示します。

$$$=== BEGIN OF Diagnostic Dump - jvm.classhistogram (Archive #0 1_of_2) ===$$$
Fri Sep 07 07:00:00 PDT 2012

<text of dump sampling>

$$$=== END OF Diagnostic Dump - jvm.classhistogram (Archive #0 1_of_2) ===$$$

- Zip: 連結ファイルのかわりにzipファイルを返すように、診断ダンプ・サンプリングを構成できます。zipファイルには、使用可能なすべてのダンプ・サンプル・ファイルが含まれます。この形式では、出力が連結に適していないバイナリ形式である診断ダンプや、テキスト形式で出力を生成するダンプがサポートされます。またこの形式では、サンプルを含むアーカイブのサイズも縮小できます。
次の例は、zipファイルの内容を示しています。

unzip -l jvm_dump.zip
Archive:  jvm_dump.zip
Length     Date   Time    Name
--------    ----   ----    ----
508780  08-21-12 07:25   dfw_samplingArchive1065570966467923683.JVMThreadDump.dmp
840  08-21-12 07:25   dfw_samplingArchive7749640004639161119.readme.txt
--------                   -------
509620                   2 files

ダンプ・サンプルの取得時には、テキストまたはzipファイルに加え、診断フレームワークによりREADMEファイルが生成されます。READMEファイルには、アーカイブ内の各ダンプ・サンプルの行番号(テキスト形式の場合)または個々のファイル名(zip形式の場合)のリストが含まれます。また、各サンプルのタイムスタンプおよびアーカイブに対する索引も含まれます。

ダンプ・サンプル・ファイルには次の形式で名前が付けられます。

dfw_dumpArchivennn.Sampling_Name.{txt]|zip}

ここで、nnnは、診断フレームワークにより割り当てられる一意の番号です。

たとえば、次はJVMThreadDumpに対するダンプ・サンプル・ファイルの例です。

dfw_dumpArchive17394218037.JVMThreadDump.txt

READMEファイルには次の形式で名前が付けられます。

dfw_dumpArchivennn.readme.txt

ここで、nnnは、診断フレームワークにより割り当てられる一意の番号です。

すべてのサンプリングは、頻度に対応する、次の間隔で開始するようにスケジュールされます。たとえば、サンプリングが午後12:05:13に構成され、頻度が5秒の場合、サンプルは午後12:05:15に収集されます。これにより、同じ頻度の一連のサンプリングが同時に実行されるようになります。また、システム・クロックが同期化されていれば、異なるマシン上でもすべてのサンプルが同時に取得されます。

注意:

WLSTダンプ・サンプリング・コマンドを実行するには、管理サーバーに接続している必要があります。

13.4.5.2 ダンプ・サンプリングの構成

次の各項で説明しているように、追加のダンプ・サンプリングを作成し、既存のダンプ・サンプリングを更新し、ダンプ・サンプリングを削除し、ダンプ・サンプリングを有効化または無効化できます。

- ダンプ・サンプリングの作成

- ダンプ・サンプリング設定の変更

- ダンプ・サンプリングの削除

- すべてのダンプ・サンプリングの有効化または無効化

13.4.5.2.1 ダンプ・サンプリングの作成

表13-7に示したダンプおよびアプリケーション固有のダンプに対して、ダンプ・サンプリングを作成できます。ダンプ・サンプリングを作成するには、WLSTコマンドaddDumpSampleを使用します。addDumpSampleコマンドでは、次の構文を使用します。

addDumpSample(sampleName="sample_name", diagnosticDumpName="dump_name",
[appName="application_name",] samplingInterval=num_seconds,
rotationCount=num_samples, [dumpedImplicitly={true|false},]
[toAppend={true|false},] [args={"arg_name" : "value"},]
[server="server_name"])

たとえば、soa_server1サーバーに対して、http.requestsダンプに対するダンプ・サンプリングを作成し、サンプリング間隔を300秒、繰返し回数を10サンプルに設定するには、次のように指定します。

addDumpSample(sampleName="HTTPSampling", diagnosticDumpName="http.requests", samplingInterval=300, rotationCount=10, server="soa_server1")

HTTPSampling is added

完全な構文は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の「addDumpSample」を参照してください。

13.4.5.2.2 ダンプ・サンプリング設定の変更

WLSTコマンドupdateDumpSampleを使用することにより、既存のダンプ・サンプリングの設定を変更できます。updateDumpSampleコマンドでは、次の構文を使用します。

updateDumpSample(sampleName="sample_name",
[        appName="application_name",] samplingInterval=num_seconds,
rotationCount=num_samplings, [dumpedImplicitly={true|false},]
[        toAppend={true|false},] [args={"arg_name" : "value"},]
[        server="server_name"])

たとえば、サンプリング間隔を200に、繰返し回数を5に変更して、ダンプ・サンプリングHTTPSamplingを変更するには、次のように指定します。

updateDumpSample(sampleName="HTTPSampling", samplingInterval=200,
rotationCount=5, server="soa_server1")

HTTPSampling is updated

完全な構文は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の「updateDumpSample」を参照してください。

13.4.5.2.3 ダンプ・サンプリングの削除

WLSTコマンドremoveDumpSampleを使用することにより、既存のダンプ・サンプリングを削除できます。removeDumpSampleコマンドでは、次の構文を使用します。

removeDumpSample(sampleName="sample_name", [server="server_name"])

たとえば、ダンプ・サンプリングHTTPSamplingを削除するには、次のように指定します。

removeDumpSample(sampleName="HTTPSampling", server="soa_server1")

Removed HTTPSampling

完全な構文は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の「removeDumpSample」を参照してください。

13.4.5.2.4 すべてのダンプ・サンプリングの有効化または無効化

WLSTコマンドenableDumpSamplingを使用することにより、すべてのダンプ・サンプリングを有効化または無効化できます。このコマンドは、構成済のすべてのダンプ・サンプリングに影響します。enalbeDumpSamplingコマンドでは、次の構文を使用します。

enableDumpSampling(enable={true|false}, [server="server_name"])

serverパラメータは、管理サーバーに接続している場合にのみ有効です。serverパラメータを指定しないと、管理サーバーに対してダンプ・サンプリングが無効化されます。

たとえば、管理サーバーに対してダンプ・サンプリングを無効化するには、次のように指定します。

enableDumpSampling(enable=false)

ダンプ・サンプリングが有効化されているのかどうかを確認するには、WLSTコマンドisDumpSamplingEnabledを使用します。isDumpSamplingEnabledコマンドでは、次の構文を使用します。

isDumpSamplingEnabled([server="server_name"])

完全な構文は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の「enableDumpSampling」および「isDumpSamplingEnabled」を参照してください。

13.4.5.3 ダンプ・サンプリングのリスト

WLSTコマンドlistDumpSamplesを使用することにより、ダンプ・サンプリングをリストできます。すべてのダンプ・サンプリング、指定したダンプ・サンプリングまたは特定のサーバーに関連付けられているすべてのダンプ・サンプリングをリストできます。listDumpSamplesコマンドでは、次の構文を使用します。

listDumpSample([sampleName="sample_name",] [server="server_name"])

たとえば、soa_server1サーバーに関連付けられているすべてのダンプ・サンプリングをリストするには、次のように指定します。

listDumpSamples(server="soa_server1")
Location changed to domainRuntime tree. This is a read-only tree with DomainMBean as the root.
For more help, use help(domainRuntime)

Name              : JavaClassHistogram
Dump Name         : jvm.classhistogram
Application Name  :
Sampling Interval : 1800
Rotation Count    : 5
Dump Implicitly   : false
Append Samples    : true
Dump Arguments    :

Name              : JVMThreadDump
Dump Name         : jvm.threads
Application Name  :
Sampling Interval : 60
Rotation Count    : 10
Dump Implicitly   : true
Append Samples    : true
Dump Arguments    : context=true, timing=true

完全な構文は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』のlistDumpSamplesに関する項を参照してください。

13.4.5.4 ダンプ・サンプリング出力の取得

ダンプ・サンプルの出力を取得するには、次の各項で説明するように、WLSTコマンドexecuteDumpまたはgetSamplingArchivesを使用します。

- executeDumpコマンドを使用したダンプ・サンプルの取得

- getSamplingArchivesコマンドを使用したダンプ・サンプルの取得

13.4.5.4.1 executeDumpコマンドを使用したダンプ・サンプルの取得

WLSTコマンドexecuteDumpを使用し、dfw.samplingArchiveダンプを指定することにより、ダンプ・サンプルを取得できます。このコマンドは、すべてのデフォルト・サンプル・アーカイブ、および一時的な場所にあり、dumpImplicitly=trueパラメータが指定されているダンプ・サンプルを収集し、1つのファイルに連結します。このコマンドは、ダンプ・サンプルの詳細を含むREADMEファイルも返します。

executeDumpコマンドでは、次の構文を使用します。

executeDump(name="dfw.samplingArchive",outputFile="filename"

outputFileパラメータに対しては、テキスト・ファイルまたはzipファイルを指定できます。zipファイルを指定する場合は、引数zipOutput=trueを使用する必要があります。

dumpImplicitly=falseパラメータが構成されているダンプ・サンプリングについては、その内容を収集するには、オプションのdfw.samplingArchive引数sampleNameを指定する必要があります。次に例を示します。

executeDump(name='dfw.samplingArchive', args={'sampleName' : 'JavaClassHistogram'})

詳細は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の「executeDump」を参照してください。

13.4.5.4.2 getSamplingArchivesコマンドを使用したダンプ・サンプルの取得

WLSTコマンドgetSamplingArchivesを使用することにより、ダンプ・サンプリングを取得できます。このコマンドはすべてのダンプ・サンプルを、個々のダンプ・サンプル・ファイルとREADMEファイルを含むzipファイルに収集します。この方法は、バイナリ形式のダンプを扱う場合に特に有用です。

getSamplingArchivesコマンドでは、次の構文を使用します。

getSamplingArchives([sampleName="sample_name"] [,outputFile="filename" [,server="server_name"])

たとえば、サンプリングJavaClassHistogramに対するダンプ・サンプルを取得するには、次のコマンドを使用します。

getSamplingArchives(sampleName="JavaClassHistogram", outputFile="/tmp/sampling.zip")

次の例は、zipファイルの内容を示しています。

unzip -l /tmp/sampling.zip
Archive:  /tmp/sampling.zip
Length     Date   Time    Name
--------    ----   ----    ----
6241768  07-27-12 11:19   dfw_samplingArchive8680976839106379444.JavaClassHistogram.dmp
552  07-27-12 11:19   dfw_samplingArchive7861027727509995202.readme.txt
--------                   -------
6242320                   2 files

完全な構文は、『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』の「getSamplingArchives」を参照してください。

13.4.6 インシデントの管理

診断フレームワークでは、自動で作成されるか手動で作成されるかに関係なく、インシデントが格納されます。Oracle Fusion Middlewareには、インシデントのレポートの処理に役立ち、それらのインシデントをパッケージ化してOracleサポートに送信するツールが用意されています。各項目で説明する内容は次のとおりです。

- インシデントの手動作成

- インシデントのパッケージ化

- RDAレポートの生成

- インシデントのパージ

13.4.6.1 インシデントの手動作成

システムで生成された問題(内部で生成されたクリティカル・エラー)は、自動診断リポジトリ(ADR)に自動的に追加されます。それらの問題に関する追加の診断データを収集し、それをOracleサポートにアップロードできます。また場合によっては、問題を解決することもできます。これらはすべて、第13.4項で説明されているワークフローに記載されています。

ソフトウェアの障害やパフォーマンスの問題などに直面して詳細な診断データを収集する必要があるものの、診断フレームワークでインシデントが自動的に作成されていない場合は、インシデントを手動で作成することを検討してください。

インシデントを手動で作成するには、WLSTコマンドのcreateIncidentを使用します。インシデントは、時間、メッセージID、影響領域またはECIDを基準に指定できます。ここで、インシデントの内容を調べたり、Oracleサポートに送信してさらなる分析を依頼することができます。

次に、メッセージIDを基準としてインシデントを手動で作成する方法について説明します。

1. 第12.3.2項の説明に従って、ログ・ファイルを検索します。直面している問題に関連すると疑われるメッセージがあったら、インシデントを作成するときにそのメッセージIDを使用できます。

2. 次のコマンドを使用してWLSTを起動し、管理対象サーバーに接続して、管理対象サーバー・インスタンスにナビゲートします。

java weblogic.WLST
connect('username', 'password', 'localhost:7001')
cd('servers/server_name')

3. 次の形式でcreateIncidentコマンドを使用して、インシデントを作成します。

createIncident([adrHome] [,incidentTime] [,messageId] [,ecid] [,appName]
[,description] [,server])

たとえば、メッセージIDがMDS-50500のエラーを基準としてインシデントを作成するには、次のコマンドを使用してメッセージIDを指定し、ユーザーおよびOracleサポートがインシデントを追跡しやすいように、インシデントの説明を入力します。

createIncident(messageId='MDS-50500', description='sample incident')
Incident Id: 55
Problem Id: 4
Problem Key: MDS-50500 [MANUAL]
Incident Time: 23rd February 2010 11:55:45 GMT
Error Message Id: MDS-50500
Flood Controlled: false

サーバーを指定しないと、インシデントは接続されているサーバーから情報を収集します。サーバーを指定するには、次の例に示すようにserverオプションを使用します。

createIncident(messageId='MDS-50500', description='sample incident', server='soa_server1')
)

adrHomeオプションを指定しないと、インシデントは接続されているサーバーに作成されます。たとえば、管理サーバーに接続している場合、インシデントは管理サーバーのadrHomeに作成されます。

診断フレームワークはコマンドを評価して、適切な診断ダンプを起動します。インシデントおよび診断ダンプはADRに書き込まれます。それぞれの診断ダンプは、その出力結果をインシデントに書き込みます。

第13.4.2.2項で説明するように、インシデントに関する情報を表示できます。

第13.4.4項で説明するように、ダンプに情報を表示できます。

13.4.6.2 インシデントのパッケージ化

インシデントをパッケージ化して、その情報を容易にOracleサポートに送信できるようにするには、ADRコマンド・インタプリタ(ADRCI)を使用します。ADRCIユーティリティを使用すると、コマンドライン環境で問題を調査および報告できます。ADRCIにより、インシデントおよび問題の情報をzipファイルにパッケージ化して、Oracleサポートに送信できます。

ADRCIコマンドライン・ユーティリティは次のディレクトリにあります。

(UNIX) MW_HOME/wlserver_10.3/server/adr
(Windows) MW_HOME\wlserver_10.3\server\adr

インシデントのパッケージ化は、次の3つのプロセスに分かれています。

1. 論理パッケージを作成します。
このパッケージは、ADRではメタデータとしてのみ存在するため、論理的なものと示されます。論理パッケージから物理パッケージを生成するまで、その中身はありません。論理パッケージにはパッケージ番号が割り当てられ、以降のコマンドではその番号でそのパッケージを参照します。

論理パッケージは、空のパッケージとして、あるいはインシデント番号、問題番号、問題キーまたは時間間隔を基準としたパッケージとして作成することができます。空のパッケージとしてパッケージを作成した場合は、ステップ2で診断情報を追加できます。

インシデントを基準にパッケージを作成すると、ダンプなど、そのインシデントの診断データが含まれることになります。問題番号または問題キーを基準にパッケージを作成すると、その問題番号または問題キーを参照するインシデントのパッケージ診断データが含まれることになります。時間間隔を基準にパッケージを作成すると、その時間間隔内に発生したインシデントの診断データが含まれることになります。

2. 診断情報をパッケージに追加します。
インシデント番号、問題番号、問題キーまたは時間間隔を基準として論理パッケージを作成した場合は、この手順は省略できます。追加のインシデントをパッケージに追加したり、ADR内の任意のファイルをパッケージに追加することができます。空のパッケージを作成した場合は、ADRCIコマンドを使用して、インシデントまたはファイルをパッケージに追加する必要があります。

3. 物理パッケージを生成します。
物理パッケージを生成するコマンドを発行すると、ADRCIでは必要な診断ファイルをすべて収集し、目的のディレクトリ内のzipファイルに追加します。完全なzipファイルまたは増分zipファイルを生成できます。増分ファイルには、同じ論理パッケージでzipファイルが前回作成されてから追加または変更された診断ファイルがすべて含まれます。増分ファイルは、完全ファイルを作成した後にのみ作成可能で、いくつでも作成できます。それぞれのzipファイルには、正しい順序で分析できるように、順序番号が割り当てられます。

zipファイルは、次の形式に従って名前が付けられます。

packageName_mode_sequence.zip

この形式の各項目について説明します。

- packageNameは、問題キーの一部にタイムスタンプが続きます。

- modeは、COM(完全)またはINC(増分)です。

- sequenceは整数です。

たとえば、インシデントをパッケージ化するには、次の手順を実行します。

1. 次の例に示すように、ORACLE_HOMEおよびLD_LIBRARY_PATH環境変数を設定します。

ORACLE_HOME=MW_HOME/oracle_common
LD_LIBRARY_PATH=MW_HOME/wlserver_10.3/server/adr

2. ADRCIを起動します。次に例を示します。

MW_HOME/wlserver_10.3/server/adr/adrci

3. SET BASEコマンドを使用してADRベースを指定し、SET HOMEPATHコマンドを使用してインシデントを含むADRホームを指定します。HOMEPATHのパスは、ADRベースを基準に指定します。

SET BASE /scratch/oracle/config/domains/soa_domain/servers/soa_server1/adr
SET HOMEPATH diag/ofm/soa_domain/soa_server1

4. 論理パッケージを生成します。

IPS CREATE PACKAGE INCIDENT incident_number

たとえば、次のコマンドを実行すると、インシデント1を基準にパッケージが作成されます。

IPS CREATE PACKAGE INCIDENT 1
Created package 1 based on incident id 1, correlation level typical

ADRCIにより、論理パッケージに番号が割り当てられます。

5. オプションで、論理パッケージに診断情報を追加できます。次のタイプの情報を追加できます。

- 特定のインシデントのすべての診断情報。たとえば、次のコマンドを使用して、パッケージ化したインシデントに関連すると思われる別のインシデントを追加できます。

IPS ADD INCIDENT incident_number PACKAGE package_number

- ADR内にある、名前が付けられたファイル。たとえば、インシデントがアプリケーションに関連する場合、そのアプリケーションに対する.earファイルを追加できます。また、ユーザーがOracleサポートに通知するメモを記したreadmeファイルを追加することもできます。たとえば、パッケージにファイルを追加するには、次のコマンドを使用します。

IPS ADD FILE filespec PACKAGE package_number

6. 次のコマンドを使用して、物理パッケージを生成します。

IPS GENERATE PACKAGE package_number IN path

たとえば、番号1のパッケージを生成するには、次のコマンドを使用します。

IPS GENERATE PACKAGE 1 in /tmp
Generated package 1 in file /tmp/BEA337Web_20100223132315_COM_1.zip, mode complete

これにより、指定されたパスに完全な物理パッケージ(zipファイル)が生成されます。

関連項目:

『Oracle Databaseユーティリティ』の「ADRCI: ADRコマンド・インタプリタ」

13.4.6.3 インシデントのパージ

デフォルトでは、すべてのインシデントの合計サイズが500 MBを超えると、インシデントはパージされます。この値は、第13.3.1項で説明されているように、maxTotalIncidentSize MBeanパラメータを使用して変更できます。

ADRCIコマンドを使用して、インシデントを手動でパージできます。パージは、IDまたはIDの範囲、インシデントの経過時間、またはインシデントのタイプを基準にして行えます。たとえば、経過時間が60分を超えたインシデントをパージするには、次のコマンドを使用します。

purge -age 60

『Oracle Databaseユーティリティ』の「ADRCI: ADRコマンド・インタプリタ」を参照してください。

13.4.7 RDAレポートの生成

コマンドライン診断ツールのRemote Diagnostic Agent(RDA)を使用して、ご使用の環境の全体像を把握することができます。また、RDAでは、構成やセキュリティなど、様々な項目に関する推奨事項が提供されています。これは、ユーザーとOracleサポートの問題解決を支援します。

RDAは、できるだけ控えめであるように設計されており、システムを変更することはありません。必要に応じて、セキュリティ・フィルタが提供されます。

RDAの詳細は、次の場所にあるreadmeファイルを参照してください。

(UNIX) ORACLE_HOME/rda/README_Unix.txt
(Windows) ORACLE_HOME\rda\README_Windows.txt

13.5 ヘルス・テスト・フレームワークの管理および実行

Oracle Fusion Middlewareでは、ヘルス・テスト・フレームワークが提供されています。これには、Oracle Fusion Middlewareおよびそのアプリケーションが正しく動作しているかどうかを判断し、問題があれば特定して解決するために、Oracle Fusion Middlewareおよびそのアプリケーションの特定の部分を動作させる診断テストが含まれます。

この項の内容は、次のとおりです。

- ヘルス・テスト・フレームワークについて

- ヘルス・テスト・フレームワークのファイル・リポジトリについて

- ヘルス・テスト・フレームワークのコマンドラインの使用方法

- ヘルス・テスト・フレームワークの管理

- ヘルス・テスト・フレームワークの診断テストの実行

- ヘルス・テスト・フレームワークの診断テストの検索

- ヘルス・テスト・フレームワーク・テストの説明の取得

- ヘルス・テスト・フレームワークのテスト・ランのリスト

- ヘルス・テスト・フレームワークのレポートの生成

13.5.1 ヘルス・テスト・フレームワークについて

ヘルス・テスト・フレームワークでは、診断テストを実行し、結果を収集して、詳細な診断レポートを生成できます。診断テストは、Oracle Fusion Middlewareのインストールまたはパッチ適用時にインストールされます。

ヘルス・テスト・フレームワークを使用して、通常のシステム状態をチェックし、システムの問題をトラブルシューティングできます。ヘルス・テスト・フレームワークのコマンドライン・インタフェースを使用して診断テストを実行するように、Oracle Fusion Middleware環境を構成できます。

診断テストを特定のエラー・メッセージと関連付けることができます。Oracle Fusion Middlewareアプリケーションが特定のエラーを、インシデントの作成をトリガーするような方法で処理する場合、そのインシデントに対するエラー・メッセージに関連付けられている診断テストが自動的に実行されます。テスト結果はインシデントに関連付けられ、エラー・メッセージを受信したユーザーが誰であるかが記録されます。診断テストは、第13.5.2項で説明するように、ファイルベース・リポジトリに保存されます。

13.5.2 ヘルス・テスト・フレームワークのファイル・リポジトリについて

ヘルス・テスト・フレームワークは、テストおよびテスト結果をファイルベースのリポジトリに保存します。リポジトリには次の2つのプライマリ・ストアがあります。

- TestDef: テスト定義、テスト・メタデータ、テスト・パラメータに関連するデータ、言語データファイルおよび索引ファイルが含まれます。

- TestRun: テスト・ランと実行、レポート・ファイルおよび索引ファイルに関連するデータが含まれます。

索引ファイルは、検索および問合せ速度を向上させるために使用されます。

リポジトリは、テストの登録または実行時に指定した場所にリポジトリが存在しない場合に作成されます。

リポジトリの場所は、構成プロパティ・ファイルdiagfsconfig.propertiesで指定できます。このファイルは次の場所にあります。

MW_HOME/diagbase/dtf_filestore

デフォルトでは、ファイル・ストアは次の場所にあります。

MW_HOME/diagbase/dtf_filestore/testdef
MW_HOME/diagbase/dtf_filestore/testrun

13.5.3 ヘルス・テスト・フレームワークのコマンドラインの使用方法

次の各項で説明するように、ヘルス・テスト・フレームワークには、管理コマンド用のdfwhealthtestadminctl.shと、実行コマンド用のdfwhealthtestctl.shという2つのコマンドライン・インタフェースがあります。

- dfwhealthtestadminctl.shコマンドライン

- dfwhealthtestctl.shコマンドライン

13.5.3.1 dfwhealthtestadminctl.shコマンドライン

ヘルス・テスト・フレームワークには、ヘルス・テストを管理するためのdfwhealthtestadminctl.shコマンドラインがあります。これを使用して、テストを登録し、索引を再構築できます。

dfwhealthtestadmin.ctlコマンドを実行する前に、次の環境変数を設定する必要があります。

- MW_HOME: Middlewareホーム

- JAVA_HOME: Javaホーム

- dtf_fs_diagbase: リポジトリの場所

dfwhealthtestadminctl.shコマンドラインは次の場所にあります。

ORACLE_COMMON_HOME/common/bin

コマンドライン・インタフェースの構文は、次のとおりです。

/dfwhealthtestadminctl.sh command [options]

表13-9に、ヘルス・テスト・フレームワークの管理コマンドを示します。

表13-9 ヘルス・テスト・フレームワークのdfwhealthtestadminctl.shコマンド

コマンド

説明

help

コマンドライン・ヘルプを表示します。

register

1つ以上のヘルス・テスト・フレームワーク・テストをリポジトリに登録します。

index

既存のデータ・ファイルで索引を再構築します。

13.5.3.1.1 help

コマンドのヘルプを表示します。

構文は次のとおりです。

help command

次の表に、helpコマンドのパラメータを示します。

パラメータ

説明

command

コマンドの名前。

13.5.3.1.2 register

1つ以上のテストをリポジトリに登録します。

構文は次のとおりです。

register testfile=test_xml_files | dir=test_dirs
[validateonly={Y|N]]
testjar=jar_file_location

次の表に、registerコマンドのパラメータを示します。

パラメータ

説明

testfile

登録する1つ以上のXMLテスト・ファイル。ファイルへのパスを指定します。複数のファイルを指定する場合は、カンマ区切りリストを使用します。

dir

登録する1つ以上のディレクトリ。ディレクトリへのパスを指定します。複数のディレクトリを指定する場合は、カンマ区切りリストを使用します。このオプションは、同じディレクトリからの複数のテストを登録する場合に使用します。

validateonly

オプション。テストを検証するだけなのか、またはテストをリポジトリにアップロードするのかを指定するブール値。有効な値は、Y(テストの検証のみ)またはN(テストのアップロード)です。

testjar

テストjarファイルの場所。

13.5.3.1.3 index

リポジトリ内のデータ・ファイルを使用して、testdefまたはtestrunリポジトリに対する索引を再構築します。

構文は次のとおりです。

index [refresh={testdef|testrun}

次の表に、indexコマンドのパラメータを示します。

パラメータ

説明

refresh=testdef

testdefリポジトリの索引をリフレッシュします。

refresh=testrun

testrunリポジトリの索引をリフレッシュします。

13.5.3.2 dfwhealthtestctl.shコマンドライン

ヘルス・テスト・フレームワークには、ヘルス・テストを実行するためのdfwhealthtestctl.shコマンドラインがあります。このコマンドラインでは、テストの実行、ランとテストのリスト、テストの説明の表示、テストのステータスの取得、およびテストまたはテスト・ランのレポートの取得を行えます。

dfwhealthtestctl.shコマンドラインは次の場所にあります。

ORACLE_COMMON_HOME/common/bin

コマンドライン・インタフェースの構文は、次のとおりです。

/dfwhealthtestctl.sh command [options]

表13-10に、ヘルス・テスト・フレームワークのdfwhealthtestctl.shコマンドを示します。

表13-10 ヘルス・テスト・フレームワークのdfwhealthtestctl.shコマンド

コマンド

説明

desctest

指定されたテストの詳細な説明を表示します。

listrun

テスト・ランをリストします。

listtest

1つ以上のテストの説明をリストします。

report

テスト・ランのレポートを抽出します。

run

1つ以上のテストを実行します。

status

テスト・ランまたは実行のステータスを取得します。

13.5.3.2.1 desctest

指定されたテストの詳細な説明を表示します。

構文は次のとおりです。

desctest {testid=testid | testname=testname}]
[showparam={Y|N}]

次の表に、desctestコマンドのパラメータを示します。

パラメータ

説明

testid

テストのID。IDを取得するには、listtestコマンドを使用します。このパラメータまたはtestnameパラメータのいずれかを指定する必要があります。

testname

テストの名前。このパラメータまたはtestidパラメータのいずれかを指定する必要があります。

showparam

オプション。テストのパラメータを取得するかどうかを指定するブール値。有効な値はYまたはNです。

13.5.3.2.2 help

コマンドのヘルプを表示します。

構文は次のとおりです。

help command

次の表に、helpコマンドのパラメータを示します。

パラメータ

説明

command

コマンドの名前。

13.5.3.2.3 listrun

テスト・ランに対するサマリー情報を取得します。ラン名、ラン・ステータス、開始時間またはテスト名に基づいて情報を取得できます。

構文は次のとおりです。

listrun { runname=runname | testname=testname | status=status | lasthours=hours }
[showexec={Y|N]]

次の表に、listrunコマンドのパラメータを示します。

パラメータ

説明

runname

結果を取得するランの名前。runnameを取得するには、パラメータを指定せずにlistrunコマンドを実行します。

testname

結果を取得するテストの名前。

ステータス

結果を取得するランのステータス。有効な値は、running、warningおよびsuccessです。

lasthours

結果を取得する時間数。

showexec

オプション。テストの実行を取得するかどうかを指定するブール値。有効な値はYまたはNです。

13.5.3.2.4 listtest

1つ以上のテストをリストします。ワイルドカードを使用してテストの名前を指定できます。

構文は次のとおりです。

listtest [testname=testname]
[productcode=productcode

次の表に、helpコマンドのパラメータを示します。

パラメータ

説明

testname

1つ以上のテストの名前のカンマ区切りリスト。ワイルドカードを使用してテストの名前に一致するパターンを指定できます。

productcode

製品の名前。ワイルドカードを使用して製品の名前に一致するパターンを指定できます。

13.5.3.2.5 report

特定のテスト・ランまたは実行に対するテスト・レポートを抽出します。

構文は次のとおりです。

report { runname=runname | runid=run_id | execid=execution_id }
[destdir=destination_directory}
[format=HTML | XML]
[translate={Y | N}

次の表に、reportコマンドのパラメータを示します。

パラメータ

説明

runname

ランの名前。名前を取得するには、listrunコマンドを使用します。このパラメータ、runidまたはexecidのいずれかを指定する必要があります。

runid

ランのID。IDを取得するには、listrunコマンドを使用します。このパラメータ、runnameまたはexecidのいずれかを指定する必要があります。

execid

ランの実行ID。IDを取得するには、listrunコマンドを使用します。このパラメータ、runnameまたはrunidのいずれかを指定する必要があります。

destdir

オプション。レポート・ファイルが書き込まれる宛先ディレクトリ。指定しないと、レポート・ファイルはjava.io.tmpdir/user.name/diagfwkディレクトリに抽出されます。ここで、java.io.tmpdirとuser.nameはJavaシステム・プロパティです。

format

生成されるレポートの形式。有効な値はHTMLおよびXMLです。

translate

レポートを翻訳するかどうかを指定するブール値。有効な値はYまたはNです。

13.5.3.2.6 run

指定されたテストを実行します。

run {test=testnames | productcode=codes }
[runname=name
[runoption=asynch]
[input:param1=value1 param2=value2 ...
[inputfile=filename]
[contextfile=context_file]
[moninterval=monitoring_interval]
[nthreads=number_of_threads]
[reportshowparam=show_param]

次の表に、runコマンドのパラメータを示します。

パラメータ

説明

test

1つ以上のテストの名前のカンマ区切りリスト。

単一のテスト名を指定する場合は、inputパラメータを使用して1つ以上の入力パラメータ名および値も指定できます。

このパラメータまたはproductcodeパラメータのいずれかを指定する必要があります。

productcode

実行するテストを含む1つ以上の製品に対するコード。複数の製品コードを指定するには、カンマ区切りリストを使用します。

runname

オプション。現在のランの名前。指定しないと、コマンドによりデフォルトのラン名が生成されます。

moninterval

ランのステータスがテスト・リポジトリにアップロードされる間隔(秒単位)。デフォルト値は30秒です。

nthreads

このラン内のテストを実行するために生成するパラレル・スレッドの数。デフォルト値は5です。このパラメータに対して値1を指定すると、テストはシリアルに実行されます。

runoption

オプション。テストを実行するためのオプション。有効な値はasynchであり、テストをバックグラウンドで非同期に実行します。

input

オプション。このパラメータを使用する場合は、1つ以上のパラメータ名/値ペアを指定します。次に例を示します。

domainhome=/scratch/oracle/domains/basedomain

このパラメータは、1つのテストだけを実行する場合にのみ使用できます。

inputfile

入力パラメータを含むファイルへのパス。各入力名/値ペアを、ファイル内の別々の行に指定します。各行の形式は次のとおりです。

input_param_name:input_param_value

contextfile

実行時に使用するユーザー・システム・プロパティを含むファイルへのパス。

reportshowparam

入力および出力パラメータの表示を設定します。デフォルトでは、すべてのパラメータは実行時には表示されません。パラメータを表示することを指定するには、inputまたはoutputを指定するか、両方をカンマで区切って指定します。次に例を示します。

reportshowparam=input,output

13.5.3.2.7 status

ラン名、ランIDまたは実行IDを指定して、テスト・ランのステータスを取得します。

構文は次のとおりです。

status { runname=runname | runid=run_id | execid=execution_id }
[printtree={Y|N}

次の表に、statusコマンドのパラメータを示します。

パラメータ

説明

runname

ランの名前。ラン名を取得するには、listrunコマンドを使用します。

runid

ランのID。IDを取得するには、listrunコマンドを使用します。

execid

ランの実行ID。IDを取得するには、listrunコマンドを使用します。

printtree

ネストされているすべての条件のステータスを出力するかどうかを指定します。有効な値はYまたはNです。

13.5.4 ヘルス・テスト・フレームワークの管理

次の各項で説明するように、テストを登録し、索引を再構築できます。

- リポジトリの作成およびヘルス・テスト・フレームワーク・テストの登録

- ヘルス・テスト・フレームワークの索引の再構築

13.5.4.1 リポジトリの作成およびヘルス・テスト・フレームワーク・テストの登録

リポジトリを作成するには、dfwhealthtestadminctl.sh registerコマンドを使用してテストを登録します。コマンドによりリポジトリが作成され、1つ以上のテストがリポジトリに登録されます。

リポジトリを作成してテストを登録する手順は次のとおりです。

1. リポジトリの場所を指定するようにdtf_fs_diagbase環境変数を設定します。次に例を示します。

setenv  dtf_fs_diagbase /scratch/Oracle/Middleware/diag

2. リポジトリを作成し、1つのテストをリポジトリに登録する次のコマンドを実行します。

dfwhealthtestadminctl.sh register testfile=/scratch/tests/sampleTest.xml
testjar=/scratch/tests/testjar

testfileまたはdirパラメータを使用することにより、一度に複数のテストを登録することもできます。

- testfileパラメータを使用して複数のテストを登録するには、カンマ区切りリストまたはワイルドカードを使用できます。
次の例は、カンマ区切りリストを使用して、2つのテストを登録します。

dfwhealthtestadminctl.sh register testfile=/scratch/tests/sampleTest.xml,
/scratch/moretests/sampleTest.xml
testjar=/scratch/tests/testjar

次の例は、ワイルドカードを使用して、複数のテストを登録します。

dfwhealthtestadminctl.sh register testfile=/scratch/tests/%Test.xml,
testjar=/scratch/tests/testjar

- dirパラメータを使用して複数のテストを登録するには、カンマ区切りリストで1つ以上のディレクトリを指定します。
次の例は、指定されたディレクトリ内のすべてのテストを登録します。

dfwhealthtestadminctl.sh register dir=/scratch/dtf_tests

13.5.4.2 ヘルス・テスト・フレームワークの索引の再構築

索引により、ヘルス・テスト・フレームワーク・リポジトリでの検索および問合せの速度が向上します。テスト定義に関連する索引は、testdefファイル・ストアに格納されています。テスト・ランおよび実行に関連する索引は、testrunファイル・ストアに格納されています。

状況によっては、索引のリフレッシュが必要になることがあります。この場合、testdefまたはtestrunファイル・ストアを指定して、dfwhealthtestadminctl.sh indexコマンドを実行します。次の例は、testdefファイル・ストアをリフレッシュします。

dfwhealthtestadminctl.sh index refresh=testdef

13.5.5 ヘルス・テスト・フレームワークの診断テストの実行

ヘルス・テスト・フレームワークの診断テストは、次の場所にあるdfwhealthtestctl.shコマンドライン・インタフェースを使用して実行します。

ORACLE_COMMON_HOME/common/bin

テストを実行するには、第13.5.3.2.6項で説明している形式で、runコマンドを使用します。たとえば、SampleTestテストを実行するには、次のコマンドを使用します。

./dfwhealthtestctl.sh command
[testfile=SampleTest.xml]

一度に1つまたは複数のテストを実行できます。

- カンマ区切りリストでテスト名を指定して1つ以上のテストを実行する例

./dfwhealthtestctl.sh run test=oracle.dfw.healthtest.test.sample.SampleTest2
Processing "run" command ...

Executing run ID "1340125981427" with name "TestRun_1340125981427" ...
sampleTest2 sleep for a while....
sampleTest2 done

Run ID "1340125981427" with name "TestRun_1340125981427" started at 06/21/2012
10:13:01 AM and completed at 06/21/2012 10:13:04 AM. No diagnostic issues were detected.

- テスト名にワイルドカードを使用して1つ以上のテストを実行する例

./dfwhealthtestctl.sh run test=oracle.dfw.healthtest.test.sample.SampleTest*

- 特定の製品に関連付けられているすべてのテストを実行する例

./dfwhealthtestctl.sh run productcode=idm

1つのテストのみを実行する場合は、コマンドラインまたは入力ファイルのいずれかで入力オプションを指定できます。

- コマンドラインで入力オプションを指定するには、input:パラメータを使用します。

./dfwhealthtestctl.sh run test=oracle.dfw.healthtest.test.sample.SampleTest,oracle.dfw.healthtest.test.sample.SampleTest2
input:userid=11 input:roleid=22

- 入力ファイルで入力オプションを指定するには、ファイルを作成し、inputfileパラメータを使用して、コマンドラインでそのファイルを指定します。入力ファイルの形式は次のとおりです。

input_parameter1:parameter_value1
input_parameter2:parameter_value2

次に例を示します。

userid:11
roleid:22

次に、コマンドラインでファイルを指定します。

./dfwhealthtestctl.sh run test=oracle.dfw.healthtest.test.sample.SampleTest
inputfile=/tmp/inputfile

13.5.6 ヘルス・テスト・フレームワークの診断テストの検索

dfwhealthtestctl.sh listtestコマンドを使用することにより、テストまたはランを検索できます。オプションで、テストの名前または製品コードを指定できます。

- すべてのテストを検索するには、次のように指定します。

./dfwhealthtestctl.sh listtest

- SampleTestという名前のテストを検索するには、次のように指定します。

./dfwhealthtestctl.sh listtest testname=SampleTest

- ワイルドカードを使用して複数のテストを検索するには、次のように入力します。

./dfwhealthtestctl.sh listtest testname="S*"

- 特定の製品に関連するすべてのテストを検索するには、次のように入力します。

dfwhealthtestctl.sh listtest productcode=idm

13.5.7 ヘルス・テスト・フレームワーク・テストの説明の取得

dfwhealthtestctl.sh desctestコマンドを使用することにより、指定したテストの説明を取得できます。たとえば、SampleTestテストの説明とそのパラメータを取得するには、次のコマンドを使用します。

./dfwhealthtestctl.sh desctest testname="SampleTest" showparam=Y

13.5.8 ヘルス・テスト・フレームワークのテスト・ランのリスト

dfwhealthtestctl.sh listrunコマンドを使用することにより、テスト名、ラン名、ステータスまたは時間に基づいて、テスト・ランの結果を問い合せることができます。

- テスト名を指定してテスト・ランの結果を問い合せるには、次のように指定します。

./dfwhealthtestctl.sh listrun testname="SampleTest"

- ラン名を指定してテスト・ランの結果を問い合せるには、次のように指定します。

./dfwhealthtestctl.sh listrun runname="run_1"

- ステータスを指定してテスト・ランの結果を問い合せることができます。たとえば、ステータスがrunningであるすべてのテストの結果を取得するには、次のように指定します。

./dfwhealthtestctl.sh listrun status=r

- 過去2時間に開始されたテスト・ランの結果を問い合せるには、次のように指定します。

./dfwhealthtestctl.sh listrun lasthours=2

13.5.9 ヘルス・テスト・フレームワークのレポートの生成

dfwhealthtestctl.sh reportコマンドを使用することにより、ヘルス・テスト・フレームワークに対するテスト・ランのレポートを生成できます。HTMLまたはXMLレポートを生成できます。

ラン名、ランIDまたは実行IDを指定できます。

たとえば、ランIDが1330128064268のランに対するレポートをHTML形式で生成するには、次のように指定します。

dfwhealthtestctl.sh report runid=1330128064268 format=HTML

第VI部

高度な管理

この部では、Oracle Fusion Middlewareの再構成を伴う、メタデータ・リポジトリの管理、ネットワーク構成の変更などの高度な管理タスクについて説明します。

第VI部は、次の章で構成されています。

- 第14章「メタデータ・リポジトリの管理」

- 第15章「ネットワーク構成の変更」

14 メタデータ・リポジトリの管理

多くのOracle Fusion Middlewareコンポーネントでは、メタデータ・リポジトリを使用してアプリケーションのコンポーネントおよびメタデータの構成情報を保持しています。この章では、Oracle Fusion Middlewareで使用するメタデータ・リポジトリの管理について説明します。

次の項目が含まれます。

- メタデータ・リポジトリの概要

- データベース・ベース・メタデータ・リポジトリの作成

- MDSリポジトリの管理

- メタデータ・リポジトリ・スキーマの管理

- データのパージ

注意:

IBM Websphereでメタデータ・リポジトリを管理する方法の詳細は、Oracle Fusion Middlewareサード・パーティ・アプリケーション・サーバー・ガイドのIBM Websphereでのメタデータ・サービス(MDS)の構成に関する項を参照してください。

14.1 メタデータ・リポジトリの概要

メタデータ・リポジトリには、Oracle BPEL Process Manager、Oracle B2BおよびOracle WebCenter PortalなどのOracle Fusion Middlewareコンポーネントのメタデータが格納されます。また、Oracle Fusion Middlewareの構成に関するメタデータおよびアプリケーションのメタデータも格納できます。

Oracle Fusion Middlewareでは、複数のリポジトリ・タイプがサポートされています。リポジトリ・タイプとは特定のOracle Fusion Middlewareコンポーネント(Oracle BPEL Process Manager、Oracle Internet Directoryなど)に属する個別または一連のスキーマを示します。Oracle Fusion Middlewareでは、エディションベースの再定義(EBR)がサポートされており、エディションベースの再定義を使用すると、アプリケーションの使用中にそのデータベース・コンポーネントをアップグレードでき、停止時間を最小化あるいは排除することができます。リポジトリのスキーマは、EBR対応スキーマであることがあります。

特殊なタイプのリポジトリであるOracle Metadata Services(MDS)リポジトリには、特定タイプのデプロイ済アプリケーションのメタデータが格納されます。これには、ユーザーの組織で独自に開発されたカスタムのJava EEアプリケーションや、Oracle B2Bなどの一部のOracle Fusion Middlewareコンポーネント・アプリケーションが含まれます。MDSリポジトリ・タイプに固有の関連情報については、第14.3項を参照してください。

MDSには、データベース・ベースおよびファイルベースのリポジトリを作成できます。本番環境では、データベース・ベース・リポジトリを使用します。Oracle BPEL Process Managerなどのほとんどのコンポーネントでは、データベースにスキーマをインストールする必要があるため、データベース・ベース・リポジトリを使用する必要があります。MDSでは、エディションベースの再定義(EBR)対応のスキーマがサポートされています。

注意:

メタデータ・リポジトリのデータベースがOracle Fusion Middlewareインストールで使用された後、データベース、サービス名またはSIDは変更できません。

14.2 データベース・ベース・メタデータ・リポジトリの作成

Oracle Fusion Middlewareメタデータ・リポジトリ作成ユーティリティ(RCU)を使用して、既存のデータベースにメタデータ・リポジトリを作成します。

RCUを使用すると、単一データベース内に複数のリポジトリを作成できます。MDSリポジトリや、Oracle WebCenter Portalなどの特定のコンポーネントのメタデータのリポジトリを作成できます。RCUはコンポーネントに必要なスキーマを作成します。スキーマとその表領域およびデータファイルについては、付録Dを参照してください。

RCUでは、コンポーネントのスキーマを削除することもできます。

サポートされるデータベース・プラットフォームのバージョン、およびデータベースに関するその他の前提条件については、次のサイトを参照してください。

http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html

注意:

ネットワーク待機時間を短縮するには、すべてのメタデータ・リポジトリを同一サイトのデータベースにコンポーネントとして配置することをお薦めします。

MDSリポジトリの管理については、第14.3項を参照してください。

関連項目:

RCUを使用してデータベース・ベースのメタデータ・リポジトリを作成する方法の詳細は、『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

14.3 MDSリポジトリの管理

Oracle Metadata Services(MDS)リポジトリには、特定タイプのデプロイ済アプリケーションのメタデータが格納されます。このデプロイ済アプリケーションには、ユーザーの組織で独自に開発されたカスタムのJava EEアプリケーションや、Oracle B2B、Oracle Web Services Managerなど、一部のOracle Fusion Middlewareコンポーネント・アプリケーションがあります。アプリケーションのメタデータを格納するMDSリポジトリにメタデータのコンテンツをデプロイする際には、選択したメタデータの圧縮アーカイブであるメタデータ・アーカイブ(MAR)が使用されます。

次の状況では、アプリケーションをMDSにデプロイして、デプロイ後のメタデータの管理を可能にする必要があります。

- MARの形式でパッケージ化され、シードされたメタデータがアプリケーションに組み込まれている場合

- 実行時にユーザーのパーソナライズを有効にする必要がある場合

- カスタムOracle WebCenter Portalアプリケーションがある場合

- SOAコンポジットアプリケーション(SCA)がある場合

次の各項では、MDSリポジトリについて説明します。

- MDSリポジトリの概要

- データベース・ベースのMDSリポジトリの登録および登録解除

- ファイルベースのMDSリポジトリの登録および登録解除

- システム・データソースの変更

- システムMBeanを使用したMDSリポジトリの管理

- MDSリポジトリに関する情報の表示

- アプリケーションでの別のMDSリポジトリまたはパーティションの使用の構成

- ソース・システムからターゲット・システムへのメタデータの移動

- ファイルベース・リポジトリからデータベース・ベース・リポジトリへの移動

- リポジトリからのメタデータ・パーティションの削除

- メタデータ・バージョン履歴のパージ

- MDSリポジトリでのメタデータ・ラベルの管理

関連項目:

Oracle Real Application Cluster(Oracle RAC)でMDSリポジトリを使用する方法の詳細は、『Oracle Fusion Middleware高可用性ガイド』を参照してください。

14.3.1 MDSリポジトリの概要

MDSフレームワークを使用すると、カスタマイズ可能なアプリケーションを作成できます。カスタマイズ済アプリケーションは、ベース・アプリケーション(ベース・ドキュメント)と、カスタマイズを含む1つ以上のレイヤーで構成されます。MDSは、カスタマイズをメタデータ・リポジトリに格納します。実行時にはこのカスタマイズを取得してベース・メタデータにマージし、カスタマイズ済アプリケーションを公開します。カスタマイズはベースとは別個に保存されるため、アップグレードの際にカスタマイズが保護されます。つまり、新しいパッチをベースに適用する場合でも、カスタマイズに影響を与えずに行えるということです。カスタマイズ済アプリケーションが起動されると、カスタマイズの内容がベース・アプリケーションに適用されます。

カスタマイズ可能なアプリケーションでは、複数のカスタマイズ・レイヤーを使用できます。カスタマイズ・レイヤーには、業種やサイトなどがあります。各レイヤーで複数のカスタマイズ・レイヤー値を使用できますが、実行時には、通常そのようなレイヤー値は各レイヤーから1つのみ適用されます。たとえば、カスタマイズ可能なアプリケーションの業種レイヤーには、医療や金融などの業種の値を格納できます。一方、デプロイ対象のカスタマイズ済アプリケーションで一度に使用されるのは、このレイヤー値のいずれか一つのみです。ベース・ドキュメントおよびカスタマイズ・レイヤーの詳細は、Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイドのMDSを使用したアプリケーションのカスタマイズに関する項を参照してください。

MDSリポジトリは、ファイルベースにも、データベース・ベースにもできます。本番環境では、データベース・ベース・リポジトリを使用します。1つのドメイン内に複数のMDSリポジトリを作成できます。

データベース・ベースのMDSリポジトリには、次の機能があり、これらはファイルベースのMDSリポジトリではサポートされません。

- 効率的な問合せ機能: データベース・ベースのMDSリポジトリは、セットベースの問合せ用に最適化されています。このため、データベース・リポジトリの検索などのパフォーマンスに優れています。
MDSリポジトリの問合せAPIには、問合せ操作を定義し、メタデータ・オブジェクトに対する条件を指定する構成メンバーがあります。これらの条件は、検索結果を特定の属性のタイプと値のセット、コンポーネント・タイプ、テキスト・コンテンツおよびメタデータ・パスに限定する一連の基準です。このAPIでは、複数の条件を組み合せ、ORおよびAND構成メンバーを使用することによって、動的な再帰的合成を実現できます。

- アトミックなトランザクション・セマンティック: データベース・ベースのMDSリポジトリは、データベース・トランザクション・セマンティックを使用し、トランザクションの失敗(インポートやデプロイの失敗など)をロールバックする機能があります。

- バージョニング: MDSリポジトリでは、ドキュメントのバージョンがデータベース・ベース・リポジトリで保持されます。バージョニングを使用すると、メタデータ・オブジェクトに対する変更は、メタデータ・リポジトリの既存データを単に上書きするのではなく、別のバージョンとして保存されます。バージョンのラベル付けだけではなくバージョン履歴の機能もあるため、特定時点におけるメタデータのセットを取得できます。

- メタデータの変更の分離: データベース・ベースのMDSリポジトリでは、実行環境でメタデータの変更を分離して、すべてのユーザーに渡す前に一部のユーザー・グループでテストできます。

- ポーリングに基づいた外部変更検出のサポート: あるアプリケーションで行った共有メタデータに対する変更を別のアプリケーションで検出できます。たとえば、クラスタ内の管理対象サーバーAおよびBにアプリケーションをデプロイし、管理対象サーバーAにデプロイされたアプリケーションのカスタマイズを変更した場合、そのデータはデータベース・ベース・リポジトリに書き込まれます。管理対象サーバーBにデプロイされたアプリケーションでは、更新されたカスタマイズが使用されます。これにより、高可用性がサポートされます(特に、アクティブ/アクティブ・シナリオの場合)。

- 更新のクラスタ化: データベース・ベースのMDSリポジトリでは、複数のホストからメタデータを更新できます。ファイルベースのMDSリポジトリでは、更新できるのは一度に1つのホストからのみです。

共有メタデータ・リポジトリを構成すると、複数のアプリケーションでメタデータを共有できます。メタデータを共有すると、アプリケーションの外部変更検出を構成することにより、あるアプリケーションがこのリポジトリのメタデータに対して行った変更を、共有リポジトリを使用している別のアプリケーションで確認できます。

MDSリポジトリでは、Oracle Fusion Middlewareコンポーネントなどのアプリケーションは、それぞれ専用のパーティションにデプロイされます。データベース・ベースであるか、ファイルベースであるかにかかわらず、パーティションは、1つの物理的なMDSリポジトリ内の独立した論理リポジトリです。

アプリケーションをデプロイして、MDSリポジトリに関連付ける方法は、第10章を参照してください。

MDSリポジトリへのパッチ適用に関しては、次の点に注意してください。

- パッチを適用する前に、MDSリポジトリをドメインに登録する必要があります。そうしないと適用したパッチがロールバックできず、追加のパッチを適用できません。

- パッチの適用対象は次のとおりです。

- MDSのメタデータ

- MDSのjarファイル

- MDSの共有ライブラリ

- データベース・ベースのメタデータ・リポジトリ内のMDSスキーマ。パッチには、新たな列の追加や列のサイズの拡大など、付加的な変更が含まれる場合があります。このタイプのパッチは、ロールバックできません。

- データベース・ベースのメタデータ・リポジトリ内のMDSデータベースPL/SQL。パッチには、PL/SQLパッケージの変更や、新たなPL/SQLパッケージおよび手順が含まれる場合があります。

- 対応するMDS JARファイル・パッチを必要とする、データベース・ベースのメタデータ・リポジトリ内のMDSスキーマまたはPL/SQL

14.3.1.1 MDSでサポートされるデータベース

MDSリポジトリでは、Oracleデータベースだけではなく、SQL Server、DB2、MySQLなど、Oracle以外のデータベースもサポートされます。これらのデータベースのサポート対象バージョンについては、次のサイトを参照してください。

http://www.oracle.com/technology/software/products/ias/files/fusion_certification.html

MDSリポジトリでのこれらのデータベースの使用の詳細は、Oracle Fusion Middlewareのシステム要件と仕様のMDSスキーマ用にサポートされているデータベースに関する説明を参照してください。

14.3.1.2 MDS操作の概要

Fusion Middleware ControlまたはWLSTコマンドを使用して、MDSリポジトリのほとんどの操作を実行できます。ただし、Fusion Middleware Controlのカスタム・ユーザー・インタフェースまたはWLSTコマンドが使用できない一部の操作では、システムMBeanを使用する必要があります。

次の各項では、システムMBeanのみがサポートされている場合を除き、Fusion Middleware ControlとWLSTコマンドを使用して、操作を実行する方法を説明します。システムMBeanのみがサポートされている場合、その項ではシステムMBeanを使用して操作を実行する方法を説明します。

パーティション、各パーティションにデプロイされたアプリケーションなど、リポジトリの詳細を表示できます。また、パーティションに対して、パージ、削除、メタデータのインポートやエクスポートなどの操作も実行できます。

後続の各項目で説明するMDS操作を使用する場合は次の点に注意してください。

- エクスポート操作では、MDSリポジトリ・パーティションからファイル・システムのディレクトリまたはアーカイブに、メタデータ・ドキュメントのバージョニング済のストライプ(最先端バージョンか、ラベルに基づくもの)がエクスポートされます。ディレクトリにエクスポートする場合、このディレクトリは、アプリケーションを実行しているホストからアクセス可能である必要があります。アーカイブにエクスポートする場合、このアーカイブは、コマンドを実行するシステム上に配置できます。
メタデータのバージョニングはファイルベース・リポジトリではサポートされないため、ファイルベース・リポジトリからは、最先端バージョン(唯一のバージョンでもあります)がエクスポートされます。

- インポート操作では、ファイル・システム・ディレクトリまたはアーカイブからMDSリポジトリ・パーティションにメタデータ・ドキュメントがインポートされます。ディレクトリにエクスポートした場合、このディレクトリは、アプリケーションを実行しているホストからアクセス可能である必要があります。アーカイブにエクスポートした場合、このアーカイブは、コマンドを実行するシステム上に配置できます。
ターゲット・リポジトリがデータベース・ベース・リポジトリの場合、メタデータ・ドキュメントは新しい最先端バージョンとしてインポートされます。ターゲット・リポジトリがファイルベース・リポジトリの場合、メタデータ・ドキュメントは上書きされます。

注意:

- カスタムWLST MDSコマンドを使用するには、Oracle共通ホームからWLSTスクリプトを起動する必要があります。詳細は、第3.5.1.1項を参照してください。

- カスタムWLST MDSコマンドの詳細は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスのメタデータ・サービス(MDS)カスタムWLSTコマンドに関する項を参照してください。

表14-1は、各操作に必要な論理ロールを示しています。ロールは、その操作の実行にWLSTコマンド、Fusion Middleware Control、およびMBeanのどれを使用する場合でも適用されます。

表14-1 MDSの操作と必要なロール

操作

論理ロール

キャッシュのクリア

アプリケーションのオペレータ・ロール

メタデータ・パーティションのクローニング

ドメインのAdminロール

メタデータ・ラベルの作成

アプリケーションのAdminロール

メタデータ・パーティションの作成

ドメインのAdminロール

メタデータの削除

アプリケーションのAdminロール

メタデータ・ラベルの削除

アプリケーションのAdminロール

メタデータ・パーティションの削除

ドメインのAdminロール

メタデータ・データベース・リポジトリの登録解除

ドメインのAdminロール

メタデータ・ファイル・リポジトリの登録解除

ドメインのAdminロール

メタデータのエクスポート

アプリケーションのオペレータ・ロール

MARのインポート

アプリケーションのAdminロール

メタデータのインポート

アプリケーションのAdminロール

メタデータ・ラベルの一覧表示

アプリケーションのMonitorロール

メタデータ・ラベルの昇格

アプリケーションのAdminロール

メタデータのパージ

アプリケーションのAdminロール

メタデータ・ラベルのパージ

アプリケーションのAdminロール

メタデータ・データベース・リポジトリの登録

ドメインのAdminロール

メタデータ・ファイル・リポジトリの登録

ドメインのAdminロール

これらのロールをWebLogic Serverロールにマップする方法の詳細は『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』の論理ロールのWebLogicロールへのマッピングに関する項を参照してください。

14.3.2 データベース・ベースのMDSリポジトリの登録および登録解除

次の各項では、データベース・ベースのMDSリポジトリを登録および登録解除する方法を説明します。

- Fusion Middleware Controlを使用したデータベース・ベースのMDSリポジトリの登録

- データベース・ベースのMDSリポジトリの登録解除

14.3.2.1 データベース・ベースのMDSリポジトリの登録

アプリケーションをMDSリポジトリにデプロイする前に、Oracle WebLogic Serverドメインにリポジトリを登録する必要があります。次の各項で説明するように、Fusion Middleware ControlまたはWLSTを使用して、データベース・ベースのMDSリポジトリを登録できます。

- Fusion Middleware Controlを使用したデータベース・ベースのMDSリポジトリの登録

- WLSTを使用したデータベース・ベースのMDSリポジトリの登録

14.3.2.1.1 Fusion Middleware Controlを使用したデータベース・ベースのMDSリポジトリの登録

第14.2項の説明に従って、RCUを使用してデータベース・ベースのMDSリポジトリを作成します。

Fusion Middleware Controlを使用してデータベース・ベースのMDSリポジトリを登録する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューから、「メタデータ・リポジトリ」を選択します。
次の図のように、「メタデータ・リポジトリ」ページが表示されます。

図mr_home.gifの説明

4. 「データベース・ベース・リポジトリ」セクションで、「登録」をクリックします。
「データベース・ベースのメタデータ・リポジトリの登録」ページが表示されます。

5. 「データベース接続」セクションに、次の情報を入力します。

- 「データベース・タイプ」で、データベースのタイプを選択します。

- 「ホスト名」に、ホストの名前を入力します。

- 「ポート」に、データベースのポート番号を入力します(例: 1521)。

- 「サービス名」に、データベースのサービス名を入力します。データベースのデフォルトのサービス名は、グローバル・データベース名です。これはorclなどのデータベース名とドメイン名で構成されます。この例のサービス名はorcl.domain_name.comになります。

- 「ユーザー名」に、SYSなどの、SYSDBAロールが割り当てられたデータベース・ユーザー名を入力します。

- 「パスワード」に、このユーザーのパスワードを入力します。

- 「ロール」で、SYSDBAなどのデータベース・ロールを選択します。

6. 「問合せ」をクリックします。
次の図のように、データベース内にメタデータ・リポジトリがある表が表示されます。

図mds_reg.gifの説明

7. リポジトリを選択して、次の情報を入力します。

- 「リポジトリ名」に名前を入力します。

- 「スキーマ・パスワード」に、スキーマ作成時に指定したパスワードを入力します。

8. 「OK」をクリックします。
リポジトリは、Oracle WebLogic Serverドメインに登録され、管理サーバーに対してターゲット設定されます。リポジトリのターゲット設定を他のサーバーにする方法は、第14.3.2.2項を参照してください。

また、mds-repository_nameという名前のシステム・データソースが作成されます。このデータソースに対するグローバル・トランザクション・サポートは無効になっています。

14.3.2.1.2 WLSTを使用したデータベース・ベースのMDSリポジトリの登録

コマンドラインを使用してデータベース・ベースのMDSリポジトリを登録するには、WLSTのregisterMetadataDBRepositoryコマンドを使用します。たとえば、MDSリポジトリmds-repos1を登録するには、次のコマンドを使用します。

registerMetadataDBRepository(name='mds-repos1', dbVendor='ORACLE',
host='hostname', port='1521', dbName='ora11',
user='username', password='password', targetServers='server1')

14.3.2.2 MDSリポジトリをターゲットとするサーバーの追加または削除

Fusion Middleware Controlを使用してMDSリポジトリを登録すると、リポジトリは管理サーバーに対してターゲット指定されます。リポジトリのターゲット設定を追加のサーバーにすることや、ターゲット設定からサーバーを削除することができます。

MDSリポジトリを追加のサーバーにターゲット設定するには:

1. ナビゲーション・ペインで、ファームを開いてから、「メタデータ・リポジトリ」を開きます。

2. リポジトリを選択します。
次の図のようにリポジトリのホーム・ページが表示されます。

図mr_home1.gifの説明

3. 「ターゲット・サーバー」セクションで、「追加」をクリックします。
「リポジトリをターゲット設定します」ダイアログ・ボックスが表示されます。

4. サーバーまたはクラスタを選択して、「ターゲット」をクリックします。
クラスタを開いて、クラスタ内のサーバーを表示できます。ただし、クラスタを選択した場合、リポジトリはクラスタ内のすべてのサーバーにターゲット設定されます。

5. 操作が完了したら、「閉じる」をクリックします。
サーバーが「ターゲット・サーバー」セクションにリストされます。

リポジトリのターゲット設定からサーバーを削除するには:

1. ナビゲーション・ペインで、ファームを開いてから、「メタデータ・リポジトリ」を開きます。

2. リポジトリを選択します。
リポジトリのホーム・ページが表示されます。

3. 「ターゲット・サーバー」セクションで、ターゲット・サーバーを選択し、「削除」をクリックします。
「リポジトリをターゲット設定解除します」ダイアログ・ボックスが表示されます。

4. サーバーまたはクラスタを選択して、「ターゲット設定解除」をクリックします。
クラスタを開いて、クラスタ内のサーバーを表示できます。ただし、クラスタを選択した場合、リポジトリはクラスタ内のすべてのサーバーのターゲット設定から削除されます。

5. 操作が完了したら、「閉じる」をクリックします。

14.3.2.3 データベース・ベースのMDSリポジトリの登録解除

登録解除をしても、リポジトリに格納されているデータが失われることはありません。ただし、登録解除されたリポジトリを使用しているアプリケーションはすべて、リポジトリの登録解除後に機能しなくなります。リポジトリの登録解除前には、必ずそのリポジトリを使用しているアプリケーションがないことを確認してください。

次の各項で説明するように、Fusion Middleware ControlまたはWLSTを使用して、データベース・ベースのMDSリポジトリを登録解除できます。

- Fusion Middleware Controlを使用したデータベース・ベースのMDSリポジトリの登録解除

- WLSTを使用したデータベース・ベースのMDSリポジトリの登録解除

14.3.2.3.1 Fusion Middleware Controlを使用したデータベース・ベースのMDSリポジトリの登録解除

Fusion Middleware Controlを使用してMDSリポジトリの登録を解除する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューから、「メタデータ・リポジトリ」を選択します。
「メタデータ・リポジトリ」ページが表示されます。

また、メタデータ・リポジトリのホーム・ページの「メタデータ・リポジトリ」メニューから、「管理」→「登録/登録解除」を選択して、「メタデータ・リポジトリの登録」ページにナビゲートすることもできます。

4. 表からリポジトリを選択します。

5. 「登録解除」を選択します。

6. 「確認」ダイアログ・ボックスで、「はい」をクリックします。

14.3.2.3.2 WLSTを使用したデータベース・ベースのMDSリポジトリの登録解除

コマンドラインを使用してデータベース・ベースのMDSリポジトリの登録を解除するには、WLSTのderegisterMetadataDBRepositoryコマンドを使用します。たとえば、MDSリポジトリmds-repos1を登録解除するには、次のコマンドを使用します。

deregisterMetadataDBRepository(name='mds-repos1')

14.3.3 ファイルベースのMDSリポジトリの登録および登録解除

次の各項目では、ファイルベース・メタデータ・リポジトリの登録および登録解除の方法を説明します。

- ファイルベースのMDSリポジトリの作成および登録

- ファイルベースのMDSリポジトリの登録解除

14.3.3.1 ファイルベースのMDSリポジトリの作成および登録

Fusion Middleware Controlを使用して、ファイルベースMDSリポジトリを作成し、Oracle WebLogic Serverドメインに登録できます。

Fusion Middleware Controlを使用して、ファイルベース・リポジトリを作成および登録する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューから、「メタデータ・リポジトリ」を選択します。
「メタデータ・リポジトリ」ページが表示されます。

4. 「ファイルベース・リポジトリ」セクションで、「登録」をクリックします。
「メタデータ・リポジトリの登録」ページが表示されます。

5. 次の情報を入力します。

- 「名前」に名前を入力します。たとえば、repos1と入力します。名前に接頭辞mds-が追加され、mds-repos1という名前のリポジトリが登録されます。mds-で始まる名前を入力した場合は、指定した名前のリポジトリが登録されます。

- 「ディレクトリ」で、ディレクトリを指定します。このリポジトリを使用するアプリケーションが実行される管理サーバーと管理対象サーバーには、このディレクトリに対する書込み権限が必要です。
次の点に注意してください。

- 指定したパスがファイル・システム上に存在する場合は、メタデータ・ファイル・リポジトリが登録されます。このパスの下にあるすべてのサブディレクトリは、このファイルベース・リポジトリのパーティションとして自動的にロードされます。

- 指定したパスが存在しない場合は、登録中にこの名前のディレクトリがファイル・システム上に作成されます。まだパーティションが作成されていないため、ロードされるサブディレクトリはありません。

- 指定したパスが無効またはなんらかの理由(権限が拒否されるなど)で作成できない場合は、エラーが表示され、登録は失敗します。

- 指定したパスがディレクトリではなくファイルとして存在する場合は、エラーは表示されず、登録は成功します。

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

リポジトリが作成および登録され、 「メタデータ・リポジトリ」ページに表示されます。

これでパーティションの作成と削除ができるようになりました。これらの変更は、ファイル・システム上のディレクトリに反映されます。

ファイルベース・リポジトリは、システムMBeanを使用して作成することもできます。システムMBeanブラウザの使用方法の詳細は、第14.3.5項を参照してください。

14.3.3.2 ファイルベースのMDSリポジトリの登録解除

Fusion Middleware Controlを使用して、ファイルベースMDSリポジトリの登録を解除できます。

Fusion Middleware Controlを使用してファイルベース・リポジトリの登録を解除する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューから、「メタデータ・リポジトリ」を選択します。
「メタデータ・リポジトリ」ページが表示されます。

4. 「ファイルベース・リポジトリ」セクションで、リポジトリを選択し「登録解除」をクリックします。

5. 「確認」ダイアログ・ボックスで「OK」をクリックします。
ファイルベース・リポジトリが有効の場合は、リポジトリ・リストから削除されます。有効でない場合は、エラーが表示されます。

ファイルベース・リポジトリは、システムMBeanを使用して登録解除することもできます。システムMBeanブラウザの使用方法の詳細は、第14.3.5項を参照してください。

14.3.4 システム・データソースの変更

アプリケーションを新しいリポジトリに再関連付けするように、システム・データソースを変更できます。データソースを含むデータベースまたはスキーマを変更できます。この変更を行うために、Oracle WebLogic Server管理コンソールまたはFusion Middleware Controlを使用できます。Fusion Middleware Controlを使用するには、次の手順を実行します。

1. ナビゲーション・ペインで、ファームを開いてから、「WebLogicドメイン」を開きます。

2. ドメインを選択します。

3. 「WebLogicドメイン」メニューで「JDBCデータソース」を選択します。
「JDBCデータソース」ページが表示されます。

4. 変更するデータソースを選択して、「編集」をクリックします。
「JDBCデータソースの編集」ページが表示されます。

5. 「接続プロパティ」タブを選択します。

6. データベースを変更するには、「データベースURL」フィールドを変更します。次に例を示します。

jdbc:oracle:thin:@hostname.domainname.com:1522/orcl

7. 「パスワード」で、データベースのパスワードを入力します。

8. スキーマを変更するには、「プロパティ」セクションを変更し、「ユーザー」の値を変更します。

9. データベースがDB2データベースの場合、プロパティsendStreamAsBlobを値をtrueにして追加します。

10. 「適用」をクリックします。

11. 第4.2.3項の説明に従って、このデータ・ストアを使用するサーバーを再起動します。

14.3.5 システムMBeanを使用したMDSリポジトリの管理

この章のほとんどの手順は、Fusion Middleware ControlまたはWLSTを使用してMDSリポジトリを管理する方法を説明していますが、システムMBeanも使用できます。

1. Fusion Middleware Controlのナビゲーション・ペインから、ドメインにナビゲートして選択します。「WebLogicドメイン」メニューから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」ページが表示されます。

2. このページのナビゲーション・ペインで、「アプリケーション定義のMBean」→「oracle.mds.lcm」を開きます。ドメインを開いてから「MDSDomainRuntime」を開き、「MDSDomainRuntime」を選択します。

3. 「アプリケーション定義のMBean」ペインで、「操作」タブを選択します。

4. registerMetadataFileRepositoryなど「操作」の1つをクリックします。
「操作」ページが表示されます。

5. 「値」列で、操作の値を入力します。

6. 「起動」をクリックします。

14.3.6 MDSリポジトリに関する情報の表示

次の各項で説明するように、Fusion Middleware ControlまたはシステムMBeanを使用して、MDSリポジトリに関する情報を表示できます。

- Fusion Middleware Controlを使用したMDSリポジトリに関する情報の表示

- システムMBeanを使用したMDSリポジトリに関する情報の表示

14.3.6.1 Fusion Middleware Controlを使用したMDSリポジトリに関する情報の表示

Fusion Middleware Controlを使用してMDSリポジトリに関する情報を表示するには:

1. ナビゲーション・ペインで、ファームを開いてから、「メタデータ・リポジトリ」を開きます。

2. リポジトリを選択します。
次の図は、MDSリポジトリのホーム・ページを示しています。

図mds_home.gifの説明

3. どのアプリケーションがリポジトリを使用しているかを表示するには、「アプリケーション」列のアイコンをクリックします。「パーティションを使用するアプリケーション」ダイアログ・ボックスが、「デプロイ済アプリケーション」タブおよび「参照元アプリケーション」タブとともに表示されます。

- 「デプロイ済アプリケーション」タブに、メタデータがリポジトリ・パーティションにデプロイされたアプリケーションのリストが表示されます。

- 「参照元アプリケーション」タブに、リポジトリ・パーティションに格納されているメタデータを参照するアプリケーションのリストが表示されます。

このページでは、次の操作も実行できます。

- 第14.3.10.1項で説明するように、パーティションを削除します。

- 第14.3.12.5項で説明するように、ラベルを削除します。

- 第14.3.2.2項で説明するように、ターゲット・サーバーを追加または削除します。

14.3.6.2 システムMBeanを使用したMDSリポジトリに関する情報の表示

システムMBeanのlistPartitions、listRepositories、およびlistRepositoryDetailsの各操作を使用すると、リポジトリ内のパーティションの一覧、リポジトリの一覧、ドメインに登録されているリポジトリの詳細を取得できます。

1. Fusion Middleware Controlのナビゲーション・ペインから、ドメインにナビゲートして選択します。「WebLogicドメイン」メニューから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」ページが表示されます。

2. このページのナビゲーション・ペインで、「アプリケーション定義のMBean」→「oracle.mds.lcm」を開きます。ドメインを開いてから「MDSDomainRuntime」を開き、「MDSDomainRuntime」を選択します。

3. 「アプリケーション定義のMBean」ペインで、「操作」タブを選択します。

4. listPartitions、listRepositories、listRepositoryDetailsなど「操作」の1つをクリックします。
「操作」ページが表示されます。

5. 「起動」をクリックします。
「戻り値」表に情報が表示されます。

アプリケーションのMDS構成属性を変更する方法の詳細は、第10.9項を参照してください。

14.3.7 アプリケーションでの別のMDSリポジトリまたはパーティションの使用の構成

アプリケーションはデプロイ時にMDSリポジトリに関連付けできます。その後、WLSTまたはFusion Middleware Controlを使用して、アプリケーションが関連付けられているMDSリポジトリまたはパーティションを変更できます。たとえば、特定のアプリケーションに使用する必要がある別のメタデータが、異なるリポジトリに格納されている場合などです。

アプリケーションを新しいMDSリポジトリまたはパーティションに関連付けるには、次のいずれかを実行します。

- 新しいリポジトリまたはパーティションを指定して、アプリケーションを再デプロイします。
新しいパーティションを作成するには、次のいずれかを実行します。

- パーティションを別のリポジトリにクローニングします。パーティションのクローニングは、タイプとバージョンが同じであるデータベースのデータベース・ベース・リポジトリでのみ有効です。パーティションをクローニングするときは、すべてのカスタマイズおよびラベルも含めて、メタデータのバージョン履歴を保持します。
パーティションのクローニング方法、およびクローニングしたパーティションを指定してアプリケーションを再デプロイする方法は、第14.3.7.1項で説明します。

- 新しいパーティションを作成し、次に現在のパーティションからメタデータをエクスポートして、新しいパーティションにこのメタデータをインポートします。
パーティションの作成方法、データのエクスポートおよびインポート方法、およびアプリケーションを再デプロイして新しいリポジトリまたはパーティションを指定する方法は、第14.3.7.2項で説明します。

- システム・データソースを変更します。システム・データソースを変更すると、そのデータソースが格納されるデータベースまたはスキーマを変更できます。
システム・データソースの変更方法は、第14.3.4項で説明します。

14.3.7.1 パーティションのクローニング

システムMBeanのcloneMetadataPartitionを使用すると、同じリポジトリまたは別のリポジトリにパーティションをクローニングできます。元のリポジトリもターゲット・リポジトリも、データベース・ベース・リポジトリを使用する必要があります。

パーティションをクローニングして、新しいリポジトリまたは同じリポジトリにアプリケーションを再デプロイするには:

1. システムMBeanのcloneMetadataPartition操作を使用して、パーティションをクローニングします。次の例では、partition1を元のリポジトリから新しいリポジトリにクローニングします。

1. Fusion Middleware Controlのナビゲーション・ペインから、アプリケーションがデプロイされている管理対象サーバーにナビゲートします。「WebLogicサーバー」メニューから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」ページが表示されます。

2. 「システムMBeanブラウザ」のナビゲーション・ペインで、「アプリケーション定義のMBean」→「oracle.mds.lcm」を開きます。ドメインを開いてから「MDSDomainRuntime.」を開きます。「MDSDomainRuntime」を選択します。

3. 「アプリケーション定義のMBean」ペインで、「操作」タブを選択します。
次の図では、「システムMBeanブラウザ」に「アプリケーション定義のMBeans」ペインが表示されています。

図mds_mbean.gifの説明

4. 「cloneMetadataPartiton」を選択します。
「操作: cloneMetadataPartiton」ページが表示されます。

5. 「パラメータ」の表に次の値を入力します。

- 「fromRepository」に、メタデータ・ドキュメントのクローニング元のメタデータ・パーティションが格納されているメタデータ・リポジトリの名前を入力します。

- 「fromPartition」に、メタデータ・ドキュメントのクローニング元のパーティションの名前を入力します。

- 「toRepository」に、ソース・リポジトリ・パーティションのドキュメントのクローニング先とするメタデータ・リポジトリの名前を入力します。

- 「toPartition」に、ターゲット・パーティションとして使用するメタデータ・リポジトリ・パーティションの名前を入力します。この名前はリポジトリ内で一意にする必要があります。このパラメータに値を指定しない場合、ソース・パーティションの名前がターゲット・パーティションに使用されます。
「toRepository」の名前が元のリポジトリと同じ場合は、パーティション名を入力する必要があります。この名前はリポジトリ内で一意である必要があります。

6. 「起動」をクリックします。

7. ナビゲーション・ペインでリポジトリを選択して、パーティションが作成されていることを確認します。このパーティションは「メタデータ・リポジトリ」ホーム・ページの「パーティション」表に記載されています。

2. 第10.4.3項、第10.5.3項または第10.6.3項の説明に従って、アプリケーションのタイプに応じてアプリケーションを再デプロイします。この操作の際には、「アプリケーション属性」ページで新しいパーティションおよびリポジトリを指定します。

1. リポジトリを変更するには、「リポジトリ名」の横にあるアイコンをクリックします。「メタデータ・リポジトリ」ダイアログ・ボックスでリポジトリを選択し、「OK」をクリックします。

2. パーティションを変更するには、「パーティション名」にパーティション名を入力します。

14.3.7.2 新しいパーティションの作成とアプリケーションの再関連付け

アプリケーションを再デプロイして、新しいパーティションを指定することで、同じリポジトリまたは別のリポジトリに新しいパーティションを作成できます。続いて、WLSTを使用して、メタデータを新しいパーティションに転送します。

この手順を使用すると、タイプの異なる2つのリポジトリ間で(ファイルベースからデータベース・ベースへ、またはOracle Databaseから別のデータベースへ)メタデータを転送できます。

新しいパーティションを作成して、アプリケーションを再関連付けする手順は次のとおりです。

1. WLSTのexportMetadataコマンドを使用して、ソース・パーティションからファイル・システム上のディレクトリにメタデータをエクスポートします。

exportMetadata(application='sampleApp', server='server1',
toLocation='/tmp/myrepos/mypartition', docs='/**')

2. 第10.4.3項、第10.5.3項または第10.6.3項の説明に従って、アプリケーションのタイプに応じてアプリケーションを再デプロイします。この操作の際には、「アプリケーション属性」ページで新しいパーティションおよびリポジトリを指定します。

1. リポジトリを変更するには、「リポジトリ名」の横にあるアイコンをクリックします。「メタデータ・リポジトリ」ダイアログ・ボックスでリポジトリを選択し、「OK」をクリックします。

2. パーティションを変更するには、「パーティション名」にパーティション名を入力します。

3. WLSTのimportMetadataコマンドを使用して、ファイル・システムから新しいパーティションにメタデータをインポートします。

importMetadata(application='sampleApp', server='server1',
fromLocation='/tmp/myrepos/mypartiton', docs='/**')

4. また、第14.3.3.2項または第14.3.2.3項の説明に従って、元のリポジトリの登録を解除することもできます。

または、WLSTコマンドcreateMetadataPartitionを使用して、新しいパーティションを作成することもできます。パーティション名はリポジトリ内で一意にする必要があります。このパーティション・パラメータがない場合は、ソース・パーティションの名前がターゲット・パーティションに使用されます。次の例では、パーティションpartition1を作成します。

createMetadataPartition(repository='mds-repos1', partition='partition1')

14.3.8 ソース・システムからターゲット・システムへのメタデータの移動

MDSのメタデータは、別のドメインのパーティションに転送できます。例に示すように、テスト・システムから本番システムにアプリケーションを移行します。テスト・システムのドメインにデプロイされているテスト・アプリケーションと、本番システムのドメインにデプロイされている本番アプリケーションがあります。テスト・システムから本番システムにカスタマイズを転送します。これを実行するには、テスト・システムのパーティションから本番システムのパーティションにメタデータを転送します。

パーティション間でメタデータを転送するには、パーティションからメタデータをエクスポートして、別のパーティションにインポートします。次の各項で説明するように、メタデータの転送にはFusion Middleware ControlまたはWLSTを使用できます。

- Fusion Middleware Controlを使用したメタデータの転送

- WLSTを使用したメタデータの転送

14.3.8.1 Fusion Middleware Controlを使用したメタデータの転送

Fusion Middleware Controlを使用してメタデータを転送する手順は次のとおりです。

1. ナビゲーション・ペインで、ソースのファームを開き、「アプリケーションのデプロイ」を開いてから、アプリケーションを選択します。

2. 「アプリケーションのデプロイ」メニューで、「MDS構成」を選択します。
次の図のように「MDS構成」ページが表示されます。

図mds_config.gifの説明

3. 「エクスポート」セクションで、次のいずれかを選択します。

- 「このWebブラウザが稼働しているマシンにあるアーカイブにメタデータ・ドキュメントをエクスポートします。」
「エクスポート」をクリックします。

エクスポート操作では、zipファイルがエクスポートされます。オペレーティング・システムおよびブラウザに応じて、ファイルを保存するかまたはファイルを開くかを質問するダイアログ・ボックスが表示されます。

- 「このアプリケーションが稼働しているマシンにあるディレクトリまたはアーカイブにメタデータ・ドキュメントをエクスポートします。」
ディレクトリの場所またはメタデータをエクスポートできるアーカイブを入力します。

ドキュメントの転送先のターゲット・ディレクトリまたはアーカイブ・ファイル(.jar、.JAR、.zipまたは.ZIP)は、ソース・パーティションから選択されます。ディレクトリにエクスポートする場合、このディレクトリは、ローカル・ディレクトリまたはネットワーク・ディレクトリ、あるいはアプリケーションが物理的にデプロイされているファイルである必要があります。アーカイブにエクスポートする場合、このアーカイブをローカル・ディレクトリまたはネットワーク・ディレクトリ、あるいはアプリケーションが物理的にデプロイされるファイルにすることができます。または、コマンドを実行しているシステム上にすることもできます。

該当する場所がファイル・システム上に存在しない場合、.jar、.JAR、.zipまたは.ZIPで名前が終わるときにアーカイブ・ファイルが作成される場合を除いて、ディレクトリが作成されます。アーカイブ・ファイルがすでに存在する場合、exportMetadata操作によってファイルが上書きされます。

「エクスポート」をクリックします。次に「確認」ダイアログ・ボックスで、「閉じる」をクリックします。

「ベース・ドキュメントの除外」を選択すると、カスタマイズのみがエクスポートされ、ベース・ドキュメントはエクスポートされません。ベース・ドキュメントおよびカスタマイズについては、第14.3.1項を参照してください。

4. ターゲット・アプリケーションが別のシステムにある場合は、エクスポートされたメタデータをそのシステムにコピーします。

5. ターゲット・システムのナビゲーション・ペインで、ファームを開き、「アプリケーションのデプロイ」を開いてから、アプリケーションを選択します。

6. 「アプリケーションのデプロイ」メニューで、「MDS構成」を選択します。
「MDS構成」ページが表示されます。

7. 「インポート」セクションで、次のいずれかを選択します。

- 「このWebブラウザが稼働しているマシンにあるアーカイブからメタデータ・ドキュメントをインポートします。」

- 「このアプリケーションが稼働しているマシンにあるディレクトリまたはアーカイブからメタデータ・ドキュメントをインポートします。」

エクスポートされたメタデータが格納されているディレクトリまたはアーカイブの場所を入力します。ディレクトリを指定する場合は、パーティション名が付けられているサブディレクトリも含めます。このディレクトリまたはアーカイブは、ローカルまたはネットワークのディレクトリ、あるいはアプリケーションが物理的にデプロイされているファイルである必要があります。

8. 「インポート」をクリックします。

9. 「確認」ダイアログ・ボックスで「Close」をクリックします。

14.3.8.2 WLSTを使用したメタデータの転送

WLSTを使用してメタデータを転送する手順は次のとおりです。

1. exportMetadataコマンドを使用して、元のパーティションからメタデータをエクスポートします。

exportMetadata(application='sampleApp', server='server1',
toLocation='/tmp/myrepos/mypartition', docs='/**')

このコマンドでは、メタデータ・パーティションからファイル・システム・ディレクトリにメタデータ・ドキュメントのバージョニング済のストライプがエクスポートされます。adf-config.xmlのcust-config要素で宣言されたカスタマイズ・クラスのみがエクスポートされます。adf-config.xmlに宣言されたcust-config要素がない場合、すべてのカスタマイズ・クラスがエクスポートされます。

すべてのカスタマイズをエクスポートするには、オプションrestrictCustTo="%"を使用します。

2. 本番アプリケーションが別のシステムにある場合は、エクスポートされたメタデータをそのシステムにコピーします。

3. WLSTのimportMetadataコマンドを使用して、メタデータを別のパーティションにインポートします。

importMetadata(application='sampleApp', server='server1',
fromLocation='/tmp/myrepos/mypartiton', docs='/**')

fromLocationパラメータの値は、WLSTを実行しているシステムと同一システム上の場所にするか、またはマップ済のネットワーク・ドライブまたはディレクトリ・マウント上の場所にする必要があります。ネットワーク参照を直接使用することはできません(\\mymachine\repositories\など)。

adf-config.xmlのcust-config要素で宣言されたカスタマイズ・クラスのみがエクスポートされます。adf-config.xmlに宣言されたcust-config要素がない場合、すべてのカスタマイズ・クラスがエクスポートされます。

すべてのカスタマイズをインポートするには、オプションrestrictCustTo="%"を使用します。

14.3.9 ファイルベース・リポジトリからデータベース・ベース・リポジトリへの移動

ファイルベース・リポジトリをデータベース・ベース・リポジトリに移動できます(データベース・ベース・リポジトリからファイルベース・リポジトリへの移動はできません)。

停止時間を最短にするため、ファイルベース・リポジトリからデータベース・ベース・リポジトリにアプリケーションのメタデータを移動するには、次の手順を使用します。

1. 第14.2項の説明に従い、RCUを使用して新しいリポジトリにスキーマを作成します。

2. ソース・パーティションと一致する名前を使用して、WLSTコマンドcreateMetadataPartitionで新しいパーティションを作成します。

createMetadataPartition(repository='mds-repos1', partition='partition1')

3. ソース・パーティションからファイル・システム上のディレクトリにメタデータをエクスポートします。

exportMetadata(application='sampleApp', server='server1',
toLocation='/tmp/myrepos/partition1', docs='/**')

4. ファイル・システムから新しいパーティションにメタデータをインポートします。

importMetadata(application='sampleApp', server='server1',
fromLocation='/tmp/myrepos/partition1', docs='/**')

5. 第10.4.3項、第10.5.3項または第10.6.3項の説明に従って、アプリケーションのタイプに応じてアプリケーションを再デプロイします。この操作の際には、「アプリケーション属性」ページで新しいパーティションおよびリポジトリを指定します。

1. リポジトリを変更するには、「リポジトリ名」の横にあるアイコンをクリックします。「メタデータ・リポジトリ」ダイアログ・ボックスでリポジトリを選択し、「OK」をクリックします。

2. パーティションを変更するには、「パーティション名」にパーティション名を入力します。

6. 第14.3.3.2項の説明に従って、ファイルベース・リポジトリの登録を解除します。

14.3.10 リポジトリからのメタデータ・パーティションの削除

アプリケーションのデプロイもアプリケーションによる参照も存在しないメタデータ・パーティションは削除できます。リポジトリからのメタデータ・パーティションの削除が必要な場合には、次の状況が考えられます。

- アプリケーションのアンデプロイ時。パーティション内のユーザー・カスタマイズなどのメタデータが引き続き必要な場合があるため、Oracle Fusion Middlewareではメタデータ・パーティションが残されます。メタデータが不要な場合は、パーティションを削除できます。

- メタデータを別のパーティションに転送し、新しいパーティションを使用するようにアプリケーションを構成した場合。

- パーティションをクローニングし、新しいパーティションを使用するようにアプリケーションを構成した場合。

パーティションを削除すると、そのパーティションに含まれるデータはすべて削除されます。

次の各項の説明に従って、WLSTまたはFusion Middleware Controlを使用し、メタデータのパーティションを削除できます。

- Fusion Middleware Controlによるメタデータ・パーティションの削除

- WLSTによるメタデータ・パーティションの削除

14.3.10.1 Fusion Middleware Controlによるメタデータ・パーティションの削除

Fusion Middleware Controlを使用してリポジトリ・パーティションからメタデータ・パーティションを削除する手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開いてから、「メタデータ・リポジトリ」を開きます。

2. リポジトリを選択します。
リポジトリのホーム・ページが表示されます。

3. 「リポジトリ・パーティション」セクションで、パーティションを選択し、「削除」を選択します。

4. 「確認」ダイアログ・ボックスで「OK」をクリックします。

14.3.10.2 WLSTによるメタデータ・パーティションの削除

メタデータ・パーティションをリポジトリから削除するには、WLSTコマンドdeleteMetadataPartitionを使用できます。たとえば、ファイルベース・リポジトリmds-repos1からメタデータ・パーティションを削除するには、次のコマンドを使用します。

deleteMetadataPartition(repository='mds-repos1', partition='partition1')

14.3.11 メタデータ・バージョン履歴のパージ

データベース・ベースのMDSリポジトリでは、メタデータ・バージョン履歴をパーティションからパージできます(ファイルベースのMDSリポジトリではバージョン履歴が保持されません)。この操作では、ラベルのないドキュメントのバージョン履歴がアプリケーションのリポジトリ・パーティションからパージされます。最新バージョンはラベルがない場合もパージされません。

メタデータ・ラベルをパージするには、第14.3.12.4項の説明に従って、purgeMetadataLabelsコマンドを使用します。次に、メタデータ・バージョン履歴をパージできます。

データベースのスペース不足またはパフォーマンスの劣化が疑われる場合は、MDSリポジトリのメンテナンスの一環として、メタデータ・バージョン履歴を定期的にパージすることを検討してください。この操作はパフォーマンス集約型であるため、メンテナンス・ウィンドウ内またはシステム使用量の少ないときに実行するようにしてください。

特定のタイプのアプリケーションに固有の推奨事項については、個々のコンポーネントのドキュメントを参照してください。

次の項の説明にあるように、WLSTまたはFusion Middleware Controlを使用して、メタデータ・バージョン履歴をパージできます。

- Fusion Middleware Controlによるメタデータ・バージョン履歴のパージ

- WLSTによるメタデータ・バージョン履歴のパージ

- 自動パージの有効化

14.3.11.1 Fusion Middleware Controlによるメタデータ・バージョン履歴のパージ

Fusion Middleware Controlを使用してメタデータ・バージョン履歴をパージする手順は次のとおりです。

1. ナビゲーション・ペインで、ファームを開き、「アプリケーションのデプロイ」を開いてから、アプリケーションを選択します。

2. 「アプリケーションのデプロイ」メニューで、「MDS構成」を選択します。
Oracle SOA Suiteの場合、ナビゲーション・ツリーで、「SOA」を開き、「soa-infra」を選択します。「SOAインフラストラクチャ」メニューから、「管理」→「MDS構成」を選択します。

「MDS構成」ページが表示されます。

3. 「パージ」セクションで、「次より古い過去のラベルのない全バージョンをパージ」フィールドに時間の数字を入力し、時間の単位を選択します。たとえば、「3」と入力し、「月」を選択します。

4. 「パージ」をクリックします。

5. 「確認」ダイアログ・ボックスで「Close」をクリックします。

14.3.11.2 WLSTによるメタデータ・バージョン履歴のパージ

WLSTを使用して、メタデータ・バージョン履歴をパージするには、purgeMetadataコマンドを使用します。olderThanパラメータで秒数を指定して、パージするドキュメントを指定します。次の例では、100秒以上経過しているすべてのドキュメントがパージされます。

purgeMetadata(application='sampleApp', server='server1', olderThan=100)

14.3.11.3 自動パージの有効化

MDSAppConfig MBeanを使用して、自動パージを有効化できます。

1. Fusion Middleware Controlのナビゲーション・ペインから、ドメインにナビゲートして選択します。「WebLogicドメイン」メニューから、「システムMBeanブラウザ」を選択します。
「システムMBeanブラウザ」ページが表示されます。

2. 「アプリケーション定義のMBean」→「oracle.adf.share.config」→「サーバー: 名前」→「アプリケーション: 名前」→「ADFConfig」→「ADFConfig」→「ADFConfig」を開きます。

3. 「MDSAppConfig」を選択します。
「アプリケーション定義のMBean」ページが表示されます。

4. AutoPurgeTimeToLiveに、値を秒単位で入力します。

5. 「ADFConfig」(MDSAppConfigの親)にナビゲートして選択します。

6. 「操作」タブで、「保存」をクリックします。

14.3.12 MDSリポジトリでのメタデータ・ラベルの管理

メタデータ・ラベルは、メタデータ・リポジトリ・パーティションから各オブジェクトの特定のバージョンを選択する手段です。概念的に、これは一連のドキュメント・バージョン(ドキュメントごとに1バージョン)で、様々なドキュメント・バージョンの水平のストライプを表します。このストライプは、ラベルが作成された時点におけるドキュメントの最先端バージョン(最新のバージョン)で構成されます。

ラベルを使用すると、ラベル作成時点におけるメタデータを表示できます。パーティションに含まれるアプリケーションのメタデータの論理バックアップとリカバリをサポートするWLSTコマンドを使用できます。

ラベルは、データベース・ベース・リポジトリでのみサポートされます。

ラベルに含まれるドキュメント・バージョンは、ラベルを明示的に削除しないかぎり、自動パージでは削除されません。このように、ラベルを作成することによって、ラベルの作成時点におけるメタデータのビューは、ラベルが削除されるまで使用可能です。

MARが含まれるアプリケーションがデプロイされると、接頭辞postDeployLabel_が付いたラベルが作成されます。たとえば、postDeployLabel_mdsappdb_mdsappdb.mar_2556916398です。

MARにパッチを適用するたびに、新しいデプロイメント・ラベルが作成されますが、以前のデプロイメント・ラベルは削除されません。同様に、MARが含まれるアプリケーションをアンデプロイすると、そのアプリケーションはアンデプロイされますが、ラベルはメタデータ・リポジトリ・パーティションに残ります。

デプロイメント・ラベルを削除する場合、アプリケーションを再起動するとMARは自動的に再デプロイされ、デプロイメント・ラベルも再作成されます。

次の各項目で、ラベルの管理方法について説明します。

- メタデータ・ラベルの作成

- メタデータ・ラベルの一覧表示

- メタデータ・ラベルの昇格

- メタデータ・ラベルのパージ

- メタデータ・ラベルの削除

14.3.12.1 メタデータ・ラベルの作成

MDSリポジトリのパーティション内で、オブジェクトの特定バージョンにラベルを作成するには、WLSTコマンドcreateMetadataLabelを使用します。たとえば、アプリケーションmy_mds_appにprod1という名前のラベルを作成するには、次のコマンドを使用します。

createMetadataLabel(application='my_mds_app', server='server1', name='prod1')
Executing operation: createMetadataLabel.

Created metadata label "prod1".

バージョンが複数あるアプリケーションの場合は、applicationVersionパラメータを使用してバージョンを指定する必要があります。

14.3.12.2 メタデータ・ラベルの一覧表示

特定のアプリケーションのメタデータ・ラベルを一覧表示できます。一覧表示には、WLSTコマンドlistMetadataLabelを使用します。たとえば、アプリケーションmy_mds_appのラベルを一覧表示するには、次のコマンドを使用します。

listMetadataLabels(application='my_mds_app', server='server1')
Executing operation: listMetadataLabels.

Database Repository partition contains the following labels:
prod1
prod2
postDeployLabel_mdsappdb_mdsappdb.mar_2556916398

バージョンが複数あるアプリケーションの場合は、applicationVersionパラメータを使用してバージョンを指定する必要があります。

14.3.12.3 メタデータ・ラベルの昇格

メタデータ・ラベルが関連付けられたドキュメントを昇格して、最終バージョンにすることができます。つまり、最新への昇格が可能です。ラベルによって取得されたすべてのドキュメントを以前のバージョンにロールバックする場合にラベルを昇格します。

ラベルを最新に昇格するには、WLSTコマンドpromoteMetadataLabelを使用します。たとえば、ラベルprod1を昇格する場合は、次のコマンドを使用します。

promoteMetadataLabel(application='my_mds_app', server='server1', name='prod1')
Location changed to domainRuntime tree. This is a read-only tree with DomainMBean as the root.
For more help, use help(domainRuntime)

Executing operation: promoteMetadataLabel.

Promoted metadata label "prod1" to tip.

バージョンが複数あるアプリケーションの場合は、applicationVersionパラメータを使用してバージョンを指定する必要があります。

14.3.12.4 メタデータ・ラベルのパージ

指定した名前のパターンまたは経過時間と一致するメタデータ・ラベルをパージし、使用しなくなったラベルをパージできます。こうすることにより、データベースのサイズが減り、パフォーマンスが向上します。リポジトリからドキュメントやリビジョン履歴をパージする前に、使用しなくなったメタデータ・ドキュメントに関連付けられているラベルを削除する必要があります。

アンデプロイした古いアプリケーションのラベルを削除することが適切と思われる場合もありますが、これらのラベルは削除されていません。MARにパッチを適用するたびに、新しいラベルが作成されますが、以前のラベルは削除されません。

次の各項で説明するように、Fusion Middleware ControlまたはWLSTを使用して、メタデータ・ラベルをパージできます。

- Fusion Middleware Controlを使用したメタデータ・ラベルのパージ

- WLSTを使用したメタデータ・ラベルのパージ

14.3.12.4.1 Fusion Middleware Controlを使用したメタデータ・ラベルのパージ

Fusion Middleware Controlを使用してメタデータ・ラベルをパージする手順は次のとおりです。

1. ファームを開いてから、「メタデータ・リポジトリ」を開きます。

2. リポジトリを選択します。
リポジトリのホーム・ページが表示されます。

3. 「パーティション」を選択し、「ラベルの管理」をクリックします。
次の図のように「ラベルの管理」ページが表示されます。

図mds_labels.gifの説明

デフォルトでは、選択したパーティションで1年より長く経過し、デプロイされていないまたはサンドボックスに関連付けられていないすべてのメタデータ・ラベルが表にリストされます。

4. 特定のラベルまたは複数のラベルを検索する手順は次のとおりです。

- 「ラベル名」で演算子を選択し、フィルタ基準を入力します。文字には大/小文字区別があります。次のワイルドカードを使用できます。

- パーセント(%): 任意の数の文字に一致します。

- アンダースコア(_): 1文字に一致します。

- バックスラッシュ(\): ワイルドカードのエスケープ文字として使用します。

たとえば、文字列postDeployLabel%では、postDeployLabelで始まる任意のラベルが返されます。この結果、デプロイ済のMARに関連付けられたラベルが表示されます。

- 「期間」に2などの数値を入力します。使用可能な演算子は「次より古い」のみです。

- 「期間(単位)」で、「時間」、「日」、「週」、「月」、「年」などの単位を選択します。使用可能な演算子は「次と等しい」のみです。

5. 「検索」をクリックします。

6. デフォルトでは、サンドボックスに関連付けられているラベルおよびアプリケーションにデプロイ済のラベルは表示されません。これらのラベルを表示するには、「サンドボックス」または「デプロイメント」、あるいは両方を選択します。次の点に注意してください。

- サンドボックスに関連付けられたラベルは削除できません。

- 「デプロイメント」を選択すると、MARデプロイメントに関連付けられたラベルが表示されます。

7. ラベルを選択し、「選択項目の削除」をクリックします。

8. 「確認」ボックスで、「OK」をクリックします。

特定のデプロイ済アプリケーションで未使用のラベルをすべてパージするには、次の手順を実行します。

1. 「デプロイメント」を選択します。

2. 文字列postDeployLabel_application_name%を使用して、名前でフィルタ処理します。

3. 最新(使用中)以外をすべて選択して削除します。(現在使用中の最新のラベルは最初にリストされます。)

4. 「選択項目の削除」をクリックします。

14.3.12.4.2 WLSTを使用したメタデータ・ラベルのパージ

WLSTコマンドのpurgeMetadataLabelsを使用して、指定したパターンまたは経過時間と一致するメタデータ・ラベルをパージできます。このコマンドでは、指定した基準と一致するラベルがパージされますが、そのラベルによって指定されていたメタデータ・ドキュメントは削除されません。

たとえば、指定した名前のパターンと一致し30分よりも長く経過したメタデータ・ラベルすべてをパージするには、次のようにします。

purgeMetadataLabels(repository='mds-myRepos', partition='partition1',
namePattern='prod*', olderThanInMin='30')
Location changed to domainRuntime tree. This is a read-only tree with DomainMBean as the root.
For more help, use help(domainRuntime)

Executing operation: purgeMetadataLabels.

The following metadata labels were purged: repository=mds-soa,parititon=partition1,namePattern=prod*,olderThanInMin=30:

14.3.12.5 メタデータ・ラベルの削除

指定したメタデータ・ラベルを削除するには、WLSTコマンドdeleteMetadataLabelを使用します。たとえば、アプリケーションmy_mds_appのprod1という名前のラベルを削除するには、次のコマンドを使用します。

deleteMetadataLabel(application='my_mds_app', server='server1', name='prod1')

バージョンが複数あるアプリケーションの場合は、applicationVersionパラメータを使用してバージョンを指定する必要があります。

アプリケーションに関連付けられたラベルを検索するには、第14.3.12.2項の説明に従って、listMetadataLabelsコマンドを使用します。

14.4 メタデータ・リポジトリ・スキーマの管理

次の各項目で、メタデータ・リポジトリ・スキーマの管理方法について説明します。

- メタデータ・リポジトリ・スキーマ・パスワードの変更

- メタデータ・リポジトリのキャラクタ・セットの変更

14.4.1 メタデータ・リポジトリ・スキーマ・パスワードの変更

スキーマのパスワードはデータベースに保存されています。

たとえば、スキーマOFM_MDSのパスワードを変更する手順は次のとおりです。

1. SQL*Plusを使用して、データベースに接続します。SYSDBA権限のあるユーザーとして接続します。

2. 次のコマンドを発行します。

SQL> ALTER USER schema IDENTIFIED BY new_password;

たとえば、OFM_MDSのパスワードをabc123に変更するには、次のコマンドを使用します。

SQL> ALTER USER OFM_MDS IDENTIFIED BY abc123;

3. MDSリポジトリ・スキーマ・パスワードを変更する場合は、Oracle WebLogic Server管理コンソールを使用して、対応するMDSリポジトリ・データソースのパスワードを変更する必要があります。

1. 「ドメイン構造」で、「サービス」→「データ・ソース」を選択します。

2. MDSリポジトリに関連するデータソースをクリックします。

3. 「構成」タブをクリックして、「接続プール」タブをクリックします。

4. 「パスワード」に新しいパスワードを入力します。

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

6. 第4.2.3項の説明に従って、このデータ・ストアを使用する管理対象サーバーを再起動します。

14.4.2 メタデータ・リポジトリのキャラクタ・セットの変更

Oracle Databaseに格納されるメタデータ・リポジトリのキャラクタ・セットを変更する方法については、次のサイトにアクセスして、『Oracle Databaseグローバリゼーション・サポート・ガイド』を参照してください。

http://www.oracle.com/technetwork/database/enterprise-edition/documentation/index.html

新しいシステムのデプロイメントには、すべてUnicodeを使用することをお薦めします。システムをUnicodeでデプロイすることにより、操作性、互換性、拡張性の面で多くの利点が得られます。Oracle Databaseを使用すると、Unicodeの利点を利用しながら、高パフォーマンスのシステムをより迅速かつより容易にデプロイすることができます。現在、多言語データのサポートが必要ない場合やUnicodeをまったく必要としていない場合でも、これは新しいシステムにとって長期的には最善の選択となる可能性が高く、最終的に、時間と資金が節約されるとともに、長期にわたって競争上の優位性が確立されます。

SQL Serverデータベースにメタデータを格納する場合で、ロケールを考慮したキャラクタ・セットが大/小文字を区別しない場合は、データベース・インスタンスの作成時に、大/小文字区別の照合順序を選択する必要があります。RCUを使用してSQL ServerにMDSスキーマを作成する場合は、Unicodeサポートがデフォルトになります。使用要件に応じて、このデフォルト設定はUnicode以外のスキーマを使用するように上書きできます。

14.5 データのパージ

Oracle Fusion Middlewareデータベース内のデータの量が非常に多くなった場合、データベースの保守が困難になり、パフォーマンスに影響を及ぼす可能性があります。場合によっては、Oracle Fusion Middlewareは、データを自動的にパージします。また、Oracle Fusion Middlewareがデータの増加を管理する方法(時間とともに蓄積し、パフォーマンスに影響を及ぼす可能性のあるデータをパージするスクリプトなど)を提供する場合もあります。

Oracle Fusion Middlewareのコンポーネントの多くは、データをパージするためにPL/SQL手順として書き込まれたスクリプトを提供します。このスクリプトは、次の場所にあります。

ORACLE_HOME/common/sql/component-name_purge_purgetype.sql

たとえば、Oracle Business Process Managementのログをパージするスクリプトは、次の場所にあります。

ORACLE_HOME/common/sql/bpm_purge_logs.sql

表14-2 にOracle Fusion Middlewareのコンポーネントのデータのパージに関する情報へのポインタを示します。

表14-2 データのパージに関する情報

コンポーネント

説明

Oracle Application Development Framework

Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイドの一時的なストレージ表のクリーンアップに関する項を参照してください。

Oracle Application Development Frameworkビジネス・コンポーネント

次のスクリプトを使用して、Oracle ADFビジネス・コンポーネントでユーザー・セッションの状態および一時的な永続コレクションの格納に使用されるデータベース内の行をパージします。

ORACLE_COMMON_HOME/common/sql/adfbc_purge_statesnapshots.sql

PS_TXN表は、自動的にパージされます。

Oracle SOA Suite

『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』のデータベースの成長の管理に関する項を参照してください。

Oracle WebLogic Server: Oracle Infrastructure Webサービス

WS-RMがデータベース・ストアを使用している場合、次のスクリプトを使用してデータをパージします。

ORACLE_COMMON_HOME/common/sql/ows_purge_wsrm_msgs.sql

Oracle WebLogic Server: JAXWS Webサービス

『Oracle Fusion Middleware Oracle WebLogic Server JAX-WS Webサービスの高度な機能のプログラミング』のWebサービス永続性のクリーンアップに関する説明に従って、Webサービス永続ストアをクリーンアップします。

WebServicePersistenceMBeanのdefaultMaximumObjectLifetimeフィールドを使用して、オブジェクトの最大ライフタイムを設定します。『Oracle Fusion Middleware Oracle WebLogic Server JMXによるカスタム管理ユーティリティの開発』のWebLogic Server MBeanの理解に関する項を参照してください。

Oracle WebLogic Server: ステートフルEJB

構成の必要はありません。データは自動的にパージされます。

Oracle WebLogic Server: JMS

『Oracle Fusion Middleware Oracle WebLogic Server JMSの構成と管理』の基本的なJMSシステム・リソースの構成に関する項およびJMSメッセージの管理に関する項を参照してください。

『Oracle Fusion Middleware Oracle WebLogic Serverパフォーマンスおよびチューニング』のWebLogic JMSのチューニングに関する項も参照してください。

Oracle WebLogic Server: JDBCデータソースまたはファイルベース・データソースのセッション永続性

構成の必要はありません。データは自動的にパージされます。

MDSリポジトリ

データの自動パージおよび手動パージの詳細は、第14.3.11項を参照してください。

Oracle Web Services Manager

構成の必要はありません。データは自動的にパージされます。

Oracle WebCenter Content

アーカイブのデータのエクスポートに関する説明に従って、データをエクスポートし、削除します。次に、コレクションの削除に関する説明に従って、コレクションを削除します。これらの項は両方とも、Oracle WebCenter Contentシステムのコンテンツ・サーバーに関する管理者ガイドにあります。

Oracle WebCenter Portalスペースおよびリスト

第14.3.11項の説明に従って、MDSメタデータをパージします。

Oracle WebCenter Portalのアクティビティ・ストリーム

第14.5.2.1項を参照してください。

Oracle WebCenter Portalの分析

第14.5.2.2項を参照してください。

Oracle Real-Time Decisions

構成の必要はありません。データは自動的にパージされます。

Oracle BI Enterprise Edition

構成の必要はありません。データは自動的にパージされます。

Oracle Business Intelligence Publisher

Oracle Fusion Middleware Oracle Business Intelligence Publisherレポート設計者ガイドのジョブ履歴の削除に関する項の説明に従って、ジョブ履歴を削除します。

Oracle Internet Directory

構成の必要はありません。データは自動的にパージされます。

Oracle Identity Manager

構成の必要はありません。データは自動的にパージされます。

Oracle Identity Federation

構成の必要はありません。データは自動的にパージされます。

特定の状況では、Oracle Schedulerを使用して、スクリプトの実行を自動化することを検討できます。たとえば、スケジュール済ジョブを設定して、Oracle SOA Suiteの完了インスタンスについて14日前までをパージすることができます。

Oracle Scheduler(エンタープライズ・ジョブ・スケジューラ)は、Oracle Databaseの一部です。Oracle Schedulerは、DBMS_SCHEDULER PL/SQLパッケージ内の手順および機能によって実装されます。

Oracle Schedulerの詳細は、Oracle Database管理者ガイドのOracle Schedulerの概念に関する項およびジョブの作成、実行、および管理に関する項を参照してください。

14.5.1 Oracle Infrastructure Webサービスのデータのパージ

WS-RMがデータベース・ストアを使用している場合、次のスクリプトを使用してデータをパージします。

ORACLE_COMMON_HOME/common/sql/ows_purge_wsrm_msgs.sql

14.5.2 Oracle WebCenter Portalデータのパージ

次の各項では、Oracle WebCenter Portalデータのパージについて説明します。

- Oracle WebCenter Portalのアクティビティ・ストリーム・データのパージ

- Oracle WebCenter Portalの分析データのパージ

- Oracle WebCenter Portalの分析データのパーティショニング

14.5.2.1 Oracle WebCenter Portalのアクティビティ・ストリーム・データのパージ

Oracle WebCenter Portalのアクティビティ・ストリームは、パーティション化されていない環境でデータベースのレコードをパージする一連のWLSTコマンドを提供します。レポート内での分析に必要のないレコードがデータベースに含まれている場合や、大量のデータのためOracle WebCenter Portalのパフォーマンスが低下する場合にパージが必要になります。

Oracle WebCenter Portalのアクティビティ・ストリーム・データをパージするには、次のWLSTコマンドを使用します。

- archiveASByDate: 指定した日付より前のアクティビティ・ストリーム・データをアーカイブします。

- archiveASByDeletedObjects: 削除されたオブジェクトに関連付けられたアクティビティ・ストリーム・データをアーカイブします。

- archiveASByClosedSpaces: 現在閉じられているSpacesに関連付けられたアクティビティ・ストリーム・データをアーカイブします。

- archiveASByInactiveSpaces: 指定した日付以降非アクティブになっているSpacesに関連付けられたアクティビティ・ストリーム・データをアーカイブします。

- restoreASByDate: アーカイブされているアクティビティ・ストリーム・データを指定した日付から本番表にリストアします。

WLSTスクリプトは、Oracle WebCenter Portalアクティビティ・ストリームが含まれるOracleホームから起動する必要があります。WLSTスクリプトをWebLogic Serverホームで使用しないでください。

これらのコマンドの詳細は、Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスのActivity Streamに関する項を参照してください。

14.5.2.2 Oracle WebCenter Portalの分析データのパージ

Oracle WebCenter Portalの分析は、パーティション化されていない環境でデータベースのレコードをパージするスクリプトを提供します。レポート内での分析に必要のないレコードがデータベースに含まれている場合や、大量のデータのためOracle WebCenter Portalのパフォーマンスが低下する場合にパージが必要になります。

スクリプトanalytics_purge_facts.sqlは、指定した基準を満たすすべてのファクト表を削除します。

Oracle WebCenter Portalの分析がパーティション化された環境で稼働している場合、これらのスクリプトを実行する前に、データベースのパーティション削除機能を使用する必要があります。

14.5.2.2.1 Oracle WebCenter Portalのパージ・パッケージのロード

初めてスクリプトを実行する前に、analytics_purge_packageスクリプトを実行して、パージ・パッケージをデータベースにインストールする必要があります。

1. ACTIVITIESスキーマのスキーマ・ユーザーとしてデータベースにログインします。

2. analytics_purge_packageスクリプトを実行します。たとえば、Oracle Databaseの場合、次のようにします。

@ORACLE_HOME/oracle_common/common/sql/oracle/analytics_purge_package.sql

DB2データベースでは、次のコマンドを使用します。

db2 -td@ -f analytics_purge_package.sql

14.5.2.2.2 Oracle WebCenter Portalのパージ・スクリプトの実行

analytics_purge_facts.sqlスクリプトの場所は、使用するデータベースのタイプによって異なります。

- Oracle Database:

ORACLE_HOME/oracle_common/common/sql/oracle/analytics_purge_facts.sql

- SQL Server:

ORACLE_HOME/oracle_common/common/sql/sqlserver/analytics_purge_facts.sql

- DB2:

ORACLE_HOME/oracle_common/common/sql/db2/analytics_purge_facts.sql

analytics_purge_facts.sqlスクリプトは、次のパラメータを取ります。

- Month From: スクリプトによって、指定した月の初めより後に作成されたデータがパージされます。月をMMの形式で入力します。たとえば、8月を指定するには08と入力します。

- Year From: Month Fromパラメータとともに使用します。スクリプトによって、指定した年の指定した月の初めより後に作成されたデータがパージされます。年をYYYYの形式で入力します。たとえば、2010と入力します。

- Month To: スクリプトによって、指定した月の終わりまでに作成されたデータがパージされます。月をMMの形式で入力します。たとえば、09を入力して9月を指定すると、スクリプトによって9月末より前に作成されたすべてのデータがパージされます。

- Year To: Month Toパラメータとともに使用します。スクリプトによって、指定した年の指定した月の終わりまでに作成されたデータがパージされます。年をYYYYの形式で入力します。たとえば、2010と入力します。

- Record Batch Size: 一度にコミットするレコードの最大サイズ。

- Max Run Time: プロセスを実行する最大時間(分単位)。プロセスは、この時間に到達すると、パージの進行状況に関係なく停止します。

注意:

現在の月は削除できません。現在の月を指定すると、スクリプトによってエラーが返されます。

Oracle DatabaseまたはDB2データベースを使用している場合、スクリプトによって各パラメータの入力を求めるプロンプトが表示されます。

SQL Serverデータベースを使用している場合、analytics_purge_facts.sqlスクリプトを編集して、データのパージの基準を指定する必要があります。

次に、2010年8月1日から2010年11月30日までのAnalyticsファクト・データベース・レコードすべてを削除するSQL Serverのスクリプトの例を示します。

CALL ANALYTICS_PURGE
(
8, --from month
2010, --from year
11, --to month
2010, --to_year
1000, --commit batch size
60 --max run time minutes
);

このスクリプトを使用するには:

1. SQL Serverデータベースを使用している場合、このスクリプトを編集して、基準を指定します。

2. スクリプトを実行します。たとえば、Oracle Database上でスクリプトを実行するには、次のようにします。

sqlplus analytics_user/analytics_user_pwd @analytics_purge_facts.sql
Enter value for month_from: 8
old   4: ANALYTICS_PURGE.PURGE_ANALYTICS_INSTANCES ( &month_from,
-- MM format
new   4: ANALYTICS_PURGE.PURGE_ANALYTICS_INSTANCES ( 8,     -- MM format
Enter value for year_from: 2010
old   5:                          &year_from,               -- YYYY format
new   5:                          2010,                     -- YYYY format
Enter value for month_to: 11
old   6:                          &month_to,                -- MM format
new   6:                          11,                       -- MM format
Enter value for year_to: 2010
old   7:                          &year_to,                 -- YYYY format
new   7:                          2010,                     -- YYYY format
Enter value for record_commit_batch_size: 1000
old   8:                          &record_commit_batch_size,
new   8:                          1000,
Enter value for max_minutes_run: 60
old  10:                          &max_minutes_run) ;
new  10:                            60) ;
Log (09-12-2010 08:27:49) Purge Process Started
.
.
.
Log (09-12-2010 08:27:49)
Log (09-12-2010 08:27:49) Purge Process Finished

PL/SQL procedure successfully completed.

14.5.2.3 Oracle WebCenter Portalの分析データのパーティショニング

Oracle Fusion Middleware Metadata Repository Creation Utility (RCU)を使用してスキーマを作成する場合、アクティビティ・グラフとAnalytics表をパーティション化することを指定できます(RCUのカスタム変数スクリーンに関する項を参照)。表をパーティション化することを選択した場合、Oracle WebCenter Portalは、データベースのネイティブ・パーティショニングを使用して、パーティションを自動的に作成します。

Oracle WebCenter Portalは、別スレッドとして24時間ごとに1回実行されるパーティション・マネージャ・プロセスを提供します。これは、データベースのAnalyticsファクト表(ASFACT_*)それぞれにパーティションを作成します。最初に、このプロセスはあらかじめ6個のパーティションを生成します。このパーティションそれぞれが今後の月と対応しています。新しい月が始まるたびに、パーティション・マネージャは新しいパーティションを作成します。

データをパーティション化すると、パーティション・マネージャが作成した古いパーティションを削除することによりデータをパージできるため、データのパージが簡単になります。したがって、パーティション化された環境でデータをパージするには、単に不要となった月ベースのパーティションを削除することをお薦めします。

注意:

WC_Utilities管理対象サーバーを起動して、パーティション・マネージャ・プロセスを実行する必要があります。

たとえば、表の古いパーティションを削除するには、次のSQLコマンドを使用します。

alter table table_name drop partition partition_name;

15 ネットワーク構成の変更

この章では、Oracle Fusion Middlewareで使用するOracle Fusion MiddlewareのホストとOracleデータベースのホスト名、ドメイン名、IPアドレスなどのネットワーク構成を変更する手順について説明します。また、Oracle Fusion MiddlewareでIPv6プロトコルを使用する方法についても説明します。

この章の項目は次のとおりです。

- Oracle Fusion Middlewareのネットワーク構成の変更

- データベースのネットワーク構成の変更

- ネットワーク接続のオン/オフの切替え

- 静的IPアドレスとDHCPの切替え

- IPv6の使用

15.1 Oracle Fusion Middlewareのネットワーク構成の変更

この項では、次のインストール・タイプが含まれるホストのホスト名、ドメイン名、IPアドレスまたはこれらの組合せを変更する方法について説明します。

- Oracle WebLogic ServerおよびJavaコンポーネント。Oracle WebLogic Serverのホスト名、ドメイン名またはIPアドレスを変更する場合、Oracle WebLogic ServerにデプロイされるOracle SOA SuiteやOracle WebCenter Portalコンポーネントなど、Javaコンポーネントに関する情報も自動的に変更されます。

- Oracle Fusion Middleware Web Tierコンポーネント、Oracle Web CacheおよびOracle HTTP Server。ホスト名またはIPアドレスを変更できます。

これらの手順を使用して、Oracle Web CacheおよびOracle HTTP Server以外のシステム・コンポーネントのネットワーク構成を変更することはできません。他のシステム・コンポーネントのネットワーク構成を変更することはできません。

別のシステムへの環境の移行については、第21章を参照してください。

次の各項目では、ホスト名、ドメイン名、またはIPアドレスの変更方法を説明します。

- 管理サーバーのネットワーク構成の変更

- 管理対象サーバーのネットワーク構成の変更

- Web層コンポーネントのネットワーク構成の変更

15.1.1 管理サーバーのネットワーク構成の変更

WLSTコマンドを使用して、管理サーバーのネットワーク構成を変更できます。

1. 管理サーバーを停止します。

2. 管理サーバーの場合、次のWLSTコマンドをオフライン・モードで使用して、新しいホスト名でマシンを設定します。

wls:/offline> readDomain('DOMAIN_HOME')
wls:/offline/sampledomain> cd ('/Machine/newhostname')
wls:/offline/sampledomain> machine = cmo
wls:/offline/sampledomain> cd ('/Server/AdminServer')
wls:/offline/sampledomain> set('Machine', machine)
wls:/offline/sampledomain> updateDomain()
wls:/offline/sampledomain> exit()

3. 管理サーバーのリスニング・ポートを設定します。

wls:/offline/sampledomain> readDomain('DOMAIN_HOME')
wls:/offline/sampledomain> cd('/Server/AdminServer')
wls:/offline/sampledomain> cmo.setListenPort(8001)
wls:/offline/sampledomain> updateDomain()
wls:/offline/sampledomain> exit()

4. 第4.2.2項の説明に従って管理サーバーを起動します。

15.1.2 管理対象サーバーのネットワーク構成の変更

Oracle WebLogic Server管理コンソールを使用して、管理対象サーバーのネットワーク構成を変更します。

管理対象サーバーのホスト名、ドメイン名またはIPアドレスを変更する手順は次のとおりです。

1. 第3.4.1項の説明に従って、管理コンソールを表示します。

2. チェンジ・センターで、「ロックして編集」をクリックします。

3. 1つ以上のWebLogic Serverをホストするコンピュータの論理的な表現であるマシンを作成し、新しいホストを指すように指定します(「ホーム」ページで、「マシン」を選択します。続いて、「新規」をクリックします)。管理コンソール・ヘルプの指示に従います。
『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のホスト名検証の使用方法に関する項に従って、ノード・マネージャにアクセスする管理サーバーのホスト名検証を無効にする必要があります。

4. 管理対象サーバーの構成を、新しいマシンを指すように変更します

1. コンソールの左ペインから、「環境」→「サーバー」を開いて、サーバーの名前を選択します。続いて、サーバーの名前を選択します。

2. 「構成」タブを選択して、「一般」タブを選択します。「マシン」フィールドで、サーバーの割当て先のマシンを選択します。

3. 「リスニング・アドレス」を新しいホストに変更します。
「保存」をクリックします。

5. 管理対象サーバーを起動します。Oracle WebLogic Server管理コンソール、WLST、または次のコマンドを使用できます。

DOMAIN_NAME/bin/startManagedWebLogic.sh managed_server_name
admin_url

管理対象サーバーが管理サーバーに接続し、構成の変更を更新します。

15.1.3 Web層コンポーネントのネットワーク構成の変更

複数のOracleインスタンスが含まれるホストのホスト名、ドメイン名またはIPアドレスを変更するには、そのホストに配置された各Oracleインスタンスのネットワーク構成を変更する必要があります。別のホストに配置されたシステム・コンポーネントを変更する必要はありません。

次のコマンドを使用して、Oracle HTTP ServerおよびOracle Web Cacheのネットワーク構成を変更できます。

(UNIX) ORACLE_HOME/chgip/scripts/chpiphost.sh
(Windows) ORACLE_HOME\chgip\scripts\chpiphost.bat

このコマンドのフォーマットは、次のとおりです。

chgiphost.sh | chgiphost.bat
[-noconfig] [-version] [-help]
[ -oldhost old_host_name -newhost new_host_name]
[-oldip old_IP_address -newip new_IP_address]
-instanceHome Instance_path

各パラメータの意味は、次のとおりです。

- noconfig: ネットワーク・パラメータを変更する場合のデフォルトです。

- version: chgiphostツールのバージョンを表示します。

- help: コマンドのヘルプを表示します。

- oldhost: 前のホストの完全修飾名です。ホスト名またはドメイン名、あるいはその両方を変更するには、このパラメータとnewhostを使用します。

- newhost: 新しいホストの完全修飾名です。ホスト名またはドメイン名、あるいはその両方を変更するには、このパラメータとoldhostを使用します。

- oldip: 前のIPアドレスです。

- newip: 新しいIPアドレスです。

- instanceHome: Oracleインスタンスのフルパスです。

たとえば、Oracle HTTP ServerまたはOracle Web Cacheのいずれか、あるいはその両方が含まれるホストのホスト名、ドメイン名、およびIPアドレスを変更するには、次の作業を実行します。

- 作業1「ホストの準備」

- 作業2「ホスト名、ドメイン名、またはIPアドレスの変更」

- 作業3「chgiphostコマンドの実行」

- 作業4「Oracleインスタンスの再デプロイ」

- 作業5「プロセスの再起動」

作業1   ホストの準備

ホストの変更準備をします。

1. この手順を開始する前に、環境のバックアップを実行します。第17章を参照してください。

2. Oracle Fusion Middlewareのすべてのプロセスを停止します。第4章を参照してください。

作業2   ホスト名、ドメイン名、またはIPアドレスの変更

オペレーティング・システムで、ホスト名、ドメイン名、IPアドレス、またはこれらの組合せを更新します。ここでの手順を実行する方法の詳細は、該当するオペレーティング・システムのドキュメントを参照してください。

1. オペレーティング・システムの更新により、ホスト名、ドメイン名またはIPアドレスが適切に変更されることを確認します。

2. オペレーティング・システムで再起動が必要な場合は、ホストを再起動します。

3. ネットワークの別のホストから、このホストにpingが実行できることを確認します。必ず新しいホスト名を使用してpingを実行し、すべてが正しく解決されていることを確認してください。

作業3   chgiphostコマンドの実行

Oracle HTTP ServerまたはOracle Web Cacheがホスト上にあるOracleインスタンスごとに、次の手順を実行します。必ず1つのOracleインスタンスに対してすべての手順を完了してから次のインスタンスに移ってください。

1. Oracle Fusion Middlewareをインストールしたユーザーとしてホストにログインします。

2. chgiphostコマンドを実行します。
次の例では、inst_aというOracleインスタンスのホスト名をhost_aからhost_bに、ドメイン名をdom_1からdom_2に変更しています。

chgiphost.sh  -noconfig
-oldhost host_a.dom_1 -newhost host_b.dom_2
-instanceHome /scratch/Oracle/Middleware/inst_a

作業4   Oracleインスタンスの再デプロイ

Oracleインスタンスを再デプロイする手順は次のとおりです。

1. 管理サーバーが起動していることを確認します。

2. opmnctl unregisterinstanceコマンドを使用して、インスタンスを登録解除します。

ORACLE_INSTANCE/bin/opmnctl unregisterinstance -instanceName instance_name
-adminHost hostname -adminPort port_number

3. opmnctl redeployコマンドを使用して、インスタンスを再デプロイします。

ORACLE_INSTANCE/bin/opmnctl redeploy
-adminHost hostname -adminPort port_number

コマンドにより要求されたら、ユーザー名とパスワードを入力します。

4. Oracleインスタンスを登録します。

ORACLE_INSTANCE/bin/opmnctl registerinstance -adminHost admin_server_host
-adminPort admin_server_port

作業5   プロセスの再起動

Oracle Fusion Middlewareのすべてのプロセスを再起動します。第4章を参照してください。

15.2 データベースのネットワーク構成の変更

この項では、Oracle Fusion Middlewareコンポーネントのメタデータを格納するためのデータベースが含まれるホストのホスト名、ドメイン名、またはIPアドレスの変更方法について説明します。

次の各作業では、この手順について説明します。

- 作業1「すべてのOracle Fusion Middlewareコンポーネントの停止」

- 作業2「データベースの停止」

- 作業3「ネットワーク構成の変更」

- 作業4「ネットワーク構成への参照の変更」

- 作業5「データベースの起動」

- 作業6「システム・データソースの変更」

- 作業7「環境の再起動」

作業1   すべてのOracle Fusion Middlewareコンポーネントの停止

他のホスト上にあるものも含めて、データベースを使用するすべてのコンポーネントを停止します。第4章の説明に従って管理サーバー、管理対象サーバー、およびすべてのコンポーネントを停止します。

作業2   データベースの停止

データベースを停止して、ホストの変更準備をします。

1. ORACLE_HOMEおよびORACLE_SID環境変数を設定します。

2. リスナーとデータベースを停止します。

lsnrctl stop

sqlplus /nolog
SQL> connect SYS as SYSDBA
SQL> shutdown
SQL> quit

3. すべてのOracle Fusion Middlewareプロセスが停止したことを確認します。

4. ホストの再起動後にOracle Fusion Middlewareプロセスが自動的に起動しないように、/etc/init.dスクリプトなどの自動起動スクリプトを設定している場合はすべて無効にします。

作業3   ネットワーク構成の変更

ホスト名、ドメイン名、またはIPアドレスを変更する場合は、新しい名前またはIPアドレスでオペレーティング・システムを更新してホストを再起動し、そのホストがネットワーク上で正しく機能していることを確認します。ここでの手順を実行する方法の詳細は、該当するオペレーティング・システムのドキュメントを参照してください。

1. オペレーティング・システムの更新により、ホスト名、ドメイン名またはIPアドレスが適切に変更されることを確認します。

2. オペレーティング・システムで再起動が必要な場合は、ホストを再起動します。

3. ネットワークの別のホストから、このホストにpingが実行できることを確認します。必ず新しいホスト名、ドメイン名、またはIPアドレスを使用してpingを実行し、すべてが正しく解決されていることを確認してください。

作業4   ネットワーク構成への参照の変更

使用しているコンポーネントによっては、ホスト名、ドメイン名、またはIPアドレスが含まれるファイルを変更する必要があります。新しいホスト名、ドメイン名またはIPアドレスへの参照を変更する場合に、変更が必要になると考えられるファイルの一部を次に示します。

- tnsnames.ora。これは、次の場所にあります。

ORACLE_HOME/network/admin/tnsnames.ora

- listener.ora。これは、次の場所にあります。

(UNIX) ORACLE_HOME/network/admin/listener.ora
(Windows) ORACLE_HOME\network\admin\listener.ora

- Oracle HTTP Serverでは、httpd.confファイルを編集して次の変更を行います。

- 新しいホスト名またはIPアドレスおよびポートを使用して、リスニング・ディレクティブを更新します(本番環境のOracle HTTP Serverが別のポートを使用している場合)。

- ホスト名、IPアドレスまたはポート番号が定義されている場合、本番環境用の新しい値を使用してVirtualHostディレクティブを更新します。

- テスト環境で構成されており、トポロジ(ホスト名、IPアドレス、ポート番号)情報またはその他のマシン固有の情報を持つ、デフォルトでない他のディレクティブを更新します。

- Oracle HTTP Serverでは、dads.confファイルのPlsqlDatabaseConnectString

- Oracle HTTP Serverでは、mod_oradavを使用している場合、mod_oradav.confファイルのORACONNECTSNパラメータ

- Oracle HTTP Serverでmod_plsqlを使用する場合は、dads.confファイル内のPlsqlDatabaseConnectString属性。

- Oracle HTTP Serverでは、mod_wl_ohsを使用している場合、mod_wl_ohs.confファイルを更新します。
WebLogicHost、WebLogicPort、またはWebLogicClusterディレクティブでホスト名、IPアドレス、ポート番号を更新します。

- Oracle Portalでデータベースを使用する場合は、portal_dads.confおよびsqlnet.ora。

- Oracle Forms Servicesでデータベースを使用する場合は、sqlnet.ora。

- Oracle Business Intelligence Discovererでデータベースを使用する場合は、module_disco.conf。

前述のリストは、すべてを網羅したものではありません。各コンポーネントで使用するファイルの詳細は、第21章を参照してください。その章では、データベースなどのコンポーネントをテスト・システムから本番システムに移動して、ホスト名の変更を反映する方法について説明しています。

作業5   データベースの起動

データベースを起動する手順は次のとおりです。

1. データベースをインストールしたユーザーとしてホストにログインします。

2. ORACLE_HOMEおよびORACLE_SID環境変数を設定します。

3. UNIXシステムの場合は、LD_LIBRARY_PATH、LD_LIBRARY_PATH_64、LIB_PATH、またはSHLIB_PATH環境変数を、表3-1に示されている適切な値に設定します。実際に設定が必要な環境変数および値は、UNIXオペレーティング・システムのタイプによって異なります。

4. データベースとリスナーを起動します。

sqlplus /nolog
SQL> connect SYS as SYSDBA
SQL> startup
SQL> quit

lsnrctl start

作業6   システム・データソースの変更

データベースの新しいホスト名、ドメイン名、またはIPアドレスを使用するようにシステム・データソースを変更します。そのためには、Oracle WebLogic Server管理コンソールを使用します。

1. 第4.2.2項の説明に従って管理サーバーを起動します。

2. 管理コンソールに移動します。

3. チェンジ・センターで、「ロックして編集」をクリックします。

4. 「ドメイン構造」セクションで、「サービス」→「データ・ソース」を開きます。
「JDBCデータ・ソースのサマリー」ページが表示されます。

5. 変更するデータソースを選択します。
「設定」ページが表示されます。

6. 「接続プール」タブを選択します。

7. 本番環境のデータベースの情報を反映するように、次のエントリを変更します。

- URL: データベース・ホストおよびポートの詳細。次に例を示します。

jdbc:oracle:thin:@newhostname.domainname:port/sid
jdbc:sqlserver://newhostname.domainname:port;database=database

- ドライバ・クラス : これはデータベースのタイプに固有です。次に例を示します。

oracle.jdbc.OracleDrivercom.microsoft.sqlserver.jdbc.SQLServerDriver

- プロパティ: データベース・ユーザー名

- パスワード: データベースのパスワード

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

9. このデータソースを使用するサーバーを再起動します。(「ターゲット」タブをクリックし、このデータソースを使用するサーバーを表示します)。

作業7   環境の再起動

データベースを使用するコンポーネントを起動します。

1. 他のホスト上にあるものも含めて、データベースを使用するすべてのコンポーネントを起動します。第4章の説明に従って管理サーバー、管理対象サーバー、およびすべてのコンポーネントを起動します。

2. この手順の最初で、Oracle Fusion Middlewareを自動的に起動するプロセスを無効化していた場合は、有効化します。

15.3 ネットワーク接続のオン/オフの切替え

この項では、Oracle Fusion Middlewareホストのネットワーク接続のオン/オフを切り替える方法について説明します。前提および制限は次のとおりです。

- ホストには、Infrastructureを使用しないインスタンスが含まれている必要があります。または、中間層インスタンスおよびInfrastructureが同じホスト内にある必要があります。

- DHCPは、ループバック・モードで使用する必要があります。詳細は、Oracle Fusion Middlewareのシステム要件と仕様のドキュメントを参照してください。

- IPアドレスの変更のみがサポートされています。ホスト名は変更できません。

- DHCPモードでは、デフォルトのホスト名(localhost.localdomain)は使用しないでください。標準のホスト名を使用するようにホストを設定します。ループバックIPアドレスからそのホスト名に解決する必要があります。

- ループバック・アダプタはすべてのオフ状態のネットワークのインストール(DHCPまたは静的IP)で必要です。詳細は、『Oracle Fusion Middlewareインストレーション・プランニング・ガイド』を参照してください。

15.3.1 ネットワーク接続のオフからオンへの変更(静的IPアドレス)

この手順は、ネットワーク接続されていないホストに標準のホスト名(localhostではない)を使用してOracle Fusion Middlewareをインストールした後で、ネットワークに接続し、静的IPアドレスを使用する場合を想定しています。IPアドレスは、デフォルトのループバックIPまたは任意の標準的なIPアドレスです。

ネットワークに接続された状態に変更するには、ホストをネットワークに接続します。Oracle Fusion Middlewareの更新は必要ありません。

15.3.2 ネットワーク接続のオフからオンへの変更(DHCP)

この手順は、ネットワーク接続されていないホストに標準のホスト名(localhostではない)を使用してインストールした後で、ネットワークに接続し、DHCPを使用する場合を想定しています。ホストのIPアドレスは、任意の静的IPアドレスまたはループバックIPアドレスのいずれでもかまいません。また、このアドレスはホスト名に対して設定されている必要があります。

ネットワークに接続をオンにする手順は次のとおりです。

1. DHCPを使用してホストをネットワークに接続します。

2. ループバックIPアドレスに対してのみ、ホスト名を構成します。

15.3.3 ネットワーク接続のオンからオフへの変更(静的IPアドレス)

この手順は、ホストがネットワークに接続され、静的IPアドレスを使用している状態を、ネットワークに接続されていない状態に変更する場合に実行します。

1. /etc/hostsファイルを構成して、IPアドレスとホスト名がローカルで解決できるようにします。

2. ホストを、ネットワークから切断します。
ホスト名やIPアドレスを変更する必要はありません。

15.4 静的IPアドレスとDHCPの切替え

この項では、静的IPアドレスとDHCPを切り替える方法を説明します。前提および制限は次のとおりです。

- このホストには、アイデンティティ管理コンポーネントなどのすべてのOracle Fusion Middlewareコンポーネント、およびこれらのコンポーネントに関連付けられたデータベースが含まれている必要があります。つまり、Oracle Fusion Middleware環境全体が、このホスト上に存在している必要があります。

- DHCPは、ループバック・モードで使用する必要があります。詳細は、『Oracle Fusion Middlewareインストレーション・プランニング・ガイド』を参照してください。

- IPアドレスの変更のみがサポートされています。ホスト名は変更できません。

- DHCPモードでは、デフォルトのホスト名(localhost.localdomain)は使用しないでください。標準のホスト名を使用するようにホストを設定します。ループバックIPアドレスからそのホスト名に解決する必要があります。

15.4.1 静的IPアドレスからDHCPへの切替え

ホストの設定を静的IPアドレスからDHCPに変更する手順は次のとおりです。

1. ホストをDHCPに変更する前に、ホスト名とループバックIPアドレスを関連付けてホストを構成します。

2. ホストをDHCPに変更します。Oracle Fusion Middlewareを更新する必要はありません。

15.4.2 DHCPから静的IPアドレスへの切替え

ホストの設定をDHCPから静的IPアドレスに変更する手順は次のとおりです。

1. ホストが静的IPアドレスを使用するように変更します。

2. Oracle Fusion Middlewareを更新する必要はありません。

15.5 IPv6の使用

Oracle Fusion Middlewareでは、インターネット・プロトコル・バージョン4(IPv4)およびインターネット・プロトコル・バージョン6(IPv6)がサポートされます。特にIPv6(128ビット)では、IPv4(32ビット)と比較してサポートされるアドレス空間が大きいため、Web上でアドレス指定可能なコンピュータの数が幾何級数的に増加しています。

IPv6のアドレスは、8つに区切られた4桁の16進数で表します。次に例を示します。

2001:0db8:85a3:08d3:1319:8a2e:0370:7334

表15-1は、Oracle Fusion MiddlewareコンポーネントがサポートするIPv6について説明しています。この表の各項目は、次のとおりです。

- IPv6 Onlyの列は、すべての通信においてコンポーネントがIPv6 onlyの使用をサポートするかどうかを示します。

- デュアル・スタックの列は、通信でコンポーネントがIPv6とIPv4の両方をサポートするかどうかを示します。たとえば、一部のコンポーネントではIPv6 onlyをサポートしていません。これは、一部のOracle Databaseとの通信で、IPv6ではなくIPv4がサポートされているためです。このようなコンポーネントでは、デュアル・スタックがサポートされているため、他のコンポーネントとはIPv6による通信が可能です。

表15-1 IPv6のサポート

コンポーネント

IPv6 Only

デュアル・スタック

注意

Oracle Access Manager 10g

いいえ

はい

IPv6の構成方法については、第15.5.7項を参照してください。

Oracle Access Manager 11g

いいえ

はい

IPv6の構成方法については、第15.5.6項を参照してください。

Oracle Application Development Framework

はい

はい

Oracle Business Intelligence

いいえ

はい

デュアル・スタックおよびOracle WebLogic ServerサーバーがIPv4アドレスをリスニングするように構成されていることが必要です。ただし、クライアント(ブラウザ)は、IPv6用に構成されたホスト上にあってもかまいません。

Oracle Business Intelligence Discoverer

いいえ

いいえ

Oracle Web CacheまたはOracle HTTP Serverとの通信には、IPv6用に構成可能なリバース・プロキシを使用します。

Oracle Data Integrator

いいえ

はい

Oracle DatabaseにはIPv4アドレスが必要であるため、デュアル・スタックが必須です。エージェントにはIPv4アドレスが必要です。Oracle Data Integratorサーバーは、デュアル・スタック・ホストに配置できます。ブラウザ・クライアントは、IPv4またはIPv6ホストのいずれかに配置できます。

Oracle Directory Integration Platform

はい

はい

LDAPサーバーとの通信にはJNDIを使用し、データベースとの通信にはデータソースを使用します。JNDIおよびデータソース(JDBC)はIPV6をサポートしています。追加構成は不要です。

Oracle Directory Services Manager

はい

はい

LDAPサーバーとの通信にはJNDIを使用し、データベースとの通信にはデータソースを使用します。JNDIおよびデータソース(JDBC)はIPV6をサポートしています。追加構成は不要です。

Oracle Forms Services

いいえ

いいえ

Oracle Web CacheまたはOracle HTTP Serverとの通信には、IPv6用に構成可能なリバース・プロキシを使用します。

Oracle HTTP Server

はい

はい

IPv6の構成方法については、第15.5.2項を参照してください。

Oracle Identity Federation

いいえ

はい

Oracle DatabaseにはIPv4アドレスが必要であるため、デュアル・スタックが必須です。

Oracle Identity Manager

いいえ

はい

Oracle DatabaseにはIPv4アドレスが必要であるため、デュアル・スタックが必須です。Design ConsoleおよびRemote ManagerにもIPv4アドレスが必要です。Oracle Identity Managerサーバーは、デュアル・スタック・ホストに配置できます。ブラウザ・クライアントは、IPv4またはIPv6ホストのいずれかに配置できます。

Oracle Information Rights Management

いいえ

はい

デュアル・スタックが必須ですが、クライアント(ブラウザ)は、IPv6用に構成されたホスト上にあってもかまいません。

Oracle Internet Directory

いいえ

はい

Oracle DatabaseにはIPv4アドレスが必要であるため、デュアル・スタックが必須です。『Oracle Fusion Middleware Oracle Internet Directory管理者ガイド』のIPアドレスの管理に関する項を参照してください。

Oracle Platform Security Services

いいえ

はい

Oracle DatabaseにはIPv4アドレスが必要であるため、デュアル・スタックが必須です。

Oracle Portal

いいえ

いいえ

Oracle Web CacheまたはOracle HTTP Serverとの通信には、IPv6用に構成可能なOracle HTTP Serverリバース・プロキシを使用します。詳細は、『Oracle Fusion Middleware Oracle Portal管理者ガイド』のプロキシ・サーバーの構成に関する項を参照してください。

Oracle Reports

いいえ

いいえ

Oracle Web CacheまたはOracle HTTP Serverとの通信には、IPv6用に構成可能なリバース・プロキシを使用します。

Oracle Single Sign-On Server

いいえ

いいえ

IPv6用に構成可能なOracle HTTP Serverプロキシを使用します。Oracle Single Sign-Onは、リリース10.1.4.3を使用する必要があります。第15.5.5項を参照してください。

Oracle SOA Suite

いいえ

はい

Oracle DatabaseにはIPv4アドレスが必要であるため、デュアル・スタックが必須です。Oracle SOA SuiteをFusion Middleware Controlとともに使用する場合の詳細は、第15.5.3項を参照してください。

Oracle Virtual Directory

いいえ

はい

Oracle DatabaseにはIPv4アドレスが必要であるため、デュアル・スタックが必須です。『Oracle Fusion Middleware Oracle Virtual Directory管理者ガイド』を参照してください。

Oracle Web Cache

はい

はい

デフォルトで使用可能。無効化する方法については、第15.5.4項を参照してください。

Oracle WebCenter Content: Imaging

いいえ

はい

デュアル・スタックが必須ですが、クライアント(ブラウザ)は、IPv6用に構成されたホスト上にあってもかまいません。

Oracle WebCenter Portal

いいえ

はい

Oracle DatabaseにはIPv4アドレスが必要であるため、デュアル・スタックが必須です。

Oracle WebLogic Server

はい

はい

Oracle WebLogic Server Webサーバー・プラグインでは、11gリリース以降、IPV6がサポートされています。

Oracle Fusion MiddlewareにおけるIPv6のサポートに関する詳細は、次の各項を参照してください。

- IPv6ネットワーク・プロトコルでサポートされるトポロジ

- Oracle HTTP ServerでIPv6を使用する場合の構成

- Oracle Web CacheでのIPv6サポートの無効化

- Oracle HTTP ServerでIPv6を使用する場合のOracle Single Sign-Onの構成

- Oracle Access Manager 10gでのIPv6サポートの構成

- Oracle Access Manager 10gでのIPv6サポートの構成

15.5.1 IPv6ネットワーク・プロトコルでサポートされるトポロジ

IPv4およびIPv6では次のトポロジがサポートされます(デュアル・スタックとは、ホストがIPv4とIPv6の両方で構成されていることを意味します)。

- トポロジA:

- Oracle Database(IPv4プロトコル・ホスト上)

- Oracle WebLogic Server(デュアル・スタック・ホスト上)

- クライアント(IPv4プロトコル・ホスト上)

- クライアント(IPv6プロトコル・ホスト上)

- トポロジB:

- Oracle Database(IPv4プロトコル・ホスト上)

- 1つ以上のOracle WebLogic Server、Oracle SOA Suite、Oracle WebCenter Portal、Oracle Business Activity Monitoring、Fusion Middleware Control(デュアル・スタック・ホスト上)

- mod_wl_ohsを含むOracle HTTP Server(IPv6プロトコル・ホスト上)

- トポロジC:

- IPv6をサポートするMySQLなどのデータベース(IPv6プロトコル・ホスト上)

- Oracle WebLogic Server(IPv6プロトコル・ホスト上)

- クライアント(IPv6プロトコル・ホスト上)

- トポロジD:

- Oracle Database(IPv4プロトコル・ホスト上)

- 1つ以上のIdentity Management、Oracle SOA Suite、Oracle WebCenter Portal、Oracle Business Activity Monitoring、Fusion Middleware Control(デュアル・スタック・ホスト上)

- クライアント(IPv4プロトコル・ホスト上)

- クライアント(IPv6プロトコル・ホスト上)

- トポロジE:

- Oracle Database(IPv4プロトコル・ホスト上)

- 1つ以上のOracle Portal、Oracle Forms Services、Oracle Reports、Oracle Business Intelligence Discoverer、およびOracle Single Sign-Onリリース10.1.4.3(IPv4プロトコル・ホスト上)

- mod_proxyを使用するOracle HTTP Server(デュアル・スタック・ホスト上)

- クライアント(IPv6プロトコル・ホスト上)

- トポロジF:

- Oracle Access Managerリリース10.1.4.3、およびSOAコンポジット・アプリケーションなどのアプリケーション(IPv4プロトコル・ホスト上)

- mod_proxyを使用するOracle HTTP Server(デュアル・スタック・ホスト上)

- クライアント(IPv6プロトコル・ホスト上)

- トポロジG:

- Oracle Database(IPv4プロトコル・ホスト上)

- 1つ以上のOracle SOA Suite、Oracle WebCenter Portal、Oracle Business Activity MonitoringおよびFusion Middleware Controlコンポーネント(IPv4プロトコル・ホスト上)

- mod_wl_ohsを含むOracle HTTP Server(デュアル・スタック・ホスト上)

- クライアント(IPv6プロトコル・ホスト上)

15.5.2 Oracle HTTP ServerでIPv6を使用する場合の構成

IPv6を使用して通信を行うようにOracle HTTP Serverを構成するには、次のディレクトリにある構成ファイルを変更します。

ORACLE_INSTANCE/config/OHS/ohs_name

たとえば、IPv6を使用しているホスト上のOracle WebLogic Serverと、Oracle HTTP Serverが通信するように構成するには、mod_wl_ohsを構成します。次のディレクトリにある構成ファイルを編集します。

ORACLE_INSTANCE/config/OHS/ohs_name

これらの構成ファイルで、次のいずれかのパラメータを使用して、解決可能なホスト名またはIPv6アドレスを指定します。

WebLogicHost hostname | [IPaddress]
WebCluster [IPaddress_1]:portnum1, [IPaddress_2]:portnum2, [IPaddress_3]:portnum3, ...

IPv6アドレスは大カッコで囲む必要があります。

エラーはすべてOracle HTTP Serverのログに記録されます。詳細情報を生成するには、mod_weblogicディレクティブにDebug AllおよびWLLogFileパスを設定します。Oracle HTTP Serverはモジュール固有のメッセージを記録します。

注意:

Oracle HTTP Serverの以前のバージョンでは、IPv6ノードが含まれる動的クラスタを使用する場合に制限がありました。たとえば、Oracle WebLogic Server用のOracle HTTP Serverプラグインでは、IPv6サポートが制限されていました。この制限により、プラグインのDSL(動的サーバー・リスト)機能がサポートされていませんでした。つまり、サーバー・リストの静的構成(DynamicServerList=OFF)のみがサポートされていました。今回のリリースでは、このような制限は解消されています。

15.5.3 Oracle SOA SuiteおよびFusion Middleware Controlでのデュアル・スタックの使用

Oracle SOA Suiteでは、デュアル・スタック構成がサポートされています。ただし、Fusion Middleware ControlをOracle SOA Suiteとともに使用する場合は、次のファイル内でプロトコルを指定する必要があります。指定しないと、Fusion Middleware Controlが正しく機能しないことがあります。

DSOMAIN_HOME/bin/startWebLogic.sh

ファイル内の${DOMAIN_HOME}/bin/setDomainEnv.sh行の後ろに、IPプロトコルを指定して次の行を追加します。

$DOMAIN_HOME/bin  JAVA_OPTIONS="${JAVA_OPTIONS} -Djava.net.preferIPv4Stack=true"

15.5.4 Oracle Web CacheでのIPv6サポートの無効化

Oracle Web CacheのIPv6サポートは、デフォルトで有効化されています。次のディレクトリにあるwebcache.xmlファイルを使用して、この設定を無効化します。

(UNIX) ORACLE_INSTANCE/config/WebCache/webcache_name
(Windows) ORACLE_INSTANCE\config\WebCache\webcache_name

ファイルのIPV6要素の値を「NO」に変更します。次に例を示します。

<IPV6 ENABLED="NO"/>

IPV6要素がwebcache.xmlファイル内にない場合は、この要素をファイルに追加できます。次の例に示すように、MULTIPORT要素の後に追加します。

...
<LISTEN IPADDR="ANY" PORT="7786" PORTTYPE="ADMINISTRATION"/>
<LISTEN IPADDR="ANY" PORT="7788" PORTTYPE="INVALIDATION"/>
<LISTEN IPADDR="ANY" PORT="7787" PORTTYPE="STATISTICS"/>
</MULTIPORT>
<IPV6 ENABLED="NO"/>

15.5.5 Oracle HTTP ServerでIPv6を使用する場合のOracle Single Sign-Onの構成

Oracle Single Sign-On ServerはIPv4をサポートしています。ただし、プロキシ・サーバーとリバース・プロキシを設定することにより、IPv6をサポートするクライアントを操作するようにOracle Single Sign-On Serverを構成できます。

この項の手順では、Oracle Single Sign-On Serverリリース10.1.4.3、およびOracle Single Sign-On Serverへのフロントエンドとして機能するOracle HTTP Serverなどのプロキシ・サーバーがインストールされていることを前提としています。

IPv6をサポートするクライアントを操作するようにOracle Single Sign-Onを構成するには、次の手順に従います。

1. プロキシ・サーバーを有効にします。

1. シングル・サインオン中間層でssocfgスクリプトを実行します。このスクリプトによって、シングル・サインオン・サーバーに格納されているホスト名がプロキシ・ホスト名に変更されます。次のコマンドの構文を使用して、プロキシ・サーバーのプロトコル、ホスト名、およびポートの値を入力します。

(UNIX) $ORACLE_HOME/sso/bin/ssocfg.sh http proxy_server_name proxy_port
(Windows) %ORACLE_HOME%\sso\bin\ssocfg.bat http proxy_server_name proxy_port

2. シングル・サインオン中間層でtargets.xmlファイルを更新します。このファイルは次の場所にあります。

(UNIX) ORACLE_HOME/sysman/emd
(Windows) ORACLE_HOME\sysman\emd

ファイルを開いて、ターゲット・タイプoracle_sso_serverを検索します。このターゲット・タイプ内で、ssocfgに渡した3つの属性を見つけて編集します。

- HTTPMachine: HTTPサーバー・ホスト名

- HTTPPort: Oracle HTTPサーバーのSSLポート番号

- HTTPProtocol: サーバー・プロトコル

3. シングル・サインオン中間層のhttpd.confファイルに以降の行を追加します。このファイルはORACLE_HOME/Apache/Apache/confディレクトリにあります。これらの行によって、ディレクティブServerNameが実際のサーバー名からプロキシ名に変更されます。

KeepAlive off
ServerName proxy_host_name
Port proxy_port

SSLを使用している場合は、ポートに4443などのSSLポートを指定する必要があります。

4. (SSLのみ)ブラウザとプロキシ・サーバー間でSSL通信を構成している場合は、中間層にmod_certheadersを構成します。このモジュールによって、Oracle HTTP Serverでは、SSLリクエストとして受信するHTTPプロキシ・リクエストを処理できるようになります。次の行をhttpd.confに追加します。この行は、ファイルの最後に追加できます。ファイル内での行の場所は重要ではありません。
次の行を入力し、モジュールをロードします。

(UNIX) LoadModule certheaders_module libexec/mod_certheaders.so
(Windows) LoadModule certheaders_module modules/ApacheModuleCertHeaders.dll

Oracle Web Cacheをプロキシとして使用している場合は、次の行を入力します。

AddCertHeader HTTPS

Oracle Web Cache以外のプロキシを使用している場合は、次の行を入力します。

SimulateHttps on

5. シングル・サインオン中間層でmod_ossoを登録します。この手順によって、実際のホスト名のかわりにプロキシのホスト名を使用するようにmod_ossoを構成します。たとえばLinuxでは、次のように指定します。

$ORACLE_HOME/sso/bin/ssoreg.sh
-oracle_home_path ORACLE_HOME
-site_name example.mydomain.com
-config_mod_osso TRUE
-mod_osso_url http://example.mydomain.com

6. Distributed Configuration Managementスキーマを更新します。

ORACLE_HOME/dcm/bin/dcmctl updateconfig

7. シングル・サインオン中間層を再起動します。

ORACLE_INSTANCE/opmn/bin/opmnctl restartproc process-type=HTTP_Server
ORACLE_INSTANCE/opmn/bin/opmnctl restartproc process-type=OC4J_SECURITY

8. 次のシングル・サインオン・ログインURLを使用して、Single Sign-On Serverにログインします。

http://proxy_host_name:proxy_port/sso/

このURLによって、Single Sign-Onホームページが表示されます。ログインできる場合は、プロキシが正しく構成されています。

2. (まだ実行していない場合は)Oracle HTTP Server 11g リリース1(11.1.1)をインストールして、IPv6用のリバース・プロキシとして使用します。

3. Oracle HTTP Server 11g リリース(11.1.1)の構成を変更して、リバース・プロキシを有効にします。

1. Oracle HTTP Serverを停止します。

opmnctl stopproc ias-component=component_name

2. 次のファイルを編集します。

(UNIX) ORACLE_INSTANCE/config/OHS/ohs_name/httpd.conf
(Windows) ORACLE_INSTANCE\config\OHS\ohs_name\httpd.conf

httpd.confファイルに次の情報を付加します。

#---Added for Mod Proxy
ProxyRequests Off

<Proxy *>
Order deny,allow
Allow from all
</Proxy>

ProxyPass /sso http://OHS_host:OHS_port/sso
ProxyPass / http://OHS_host:OHS_port/
ProxyPassReverse / http://OHS_host:OHS_port/
ProxyPreserveHost On

この例にある、OHS_hostおよびOHS_portは、ステップ1で説明されている、Oracle Single Sign-Onのフロントエンド・サーバーのホスト名とポートです。

3. Oracle HTTP Serverを再起動します。たとえば、ohs1を再起動するには、次のようにします。

opmnctl startproc ias-component=ohs1

15.5.6 Oracle Access Manager 11gでのIPv6サポートの構成

Oracle Access Managerは、インターネット・プロトコル・バージョン4(IPv4)をサポートしています。リバース・プロキシ・サーバーを設定することにより、IPv6をサポートするクライアントに対応したAccess Managerを構成できます。IPv6は、mod_wl_ohsプラグインを使用したOracle HTTP Serverで使用できます。これには複数のシナリオが用意されています。使用環境にあわせて適切な構成を選択してください。

この項の項目は次のとおりです。

- 前提条件

- Oracle Access ManagerおよびIPv6の概要

- IPv6の構成: Oracle Access ManagerおよびWebgate用の別個のプロキシ

15.5.6.1 前提条件

Oracle Identity ConnectをIPv6クライアントとどのように使用する予定であるかにかかわらず、Webサーバーに対するリバース・プロキシとして機能するように、Oracle HTTP Serverインスタンスをインストールする必要があります(10gおよび11g Webgateに必要)。

15.5.6.2 Oracle Access ManagerおよびIPv6の概要

IPv4/IPv6のOracle Access Managerでサポートされるトポロジを次に示します。

- Webgate 11gとIPv4プロトコル・ホスト上の保護されたアプリケーション

- 二重スタック・ホスト上のOHS逆プロキシ

- IPv6プロトコル・ホスト上のクライアント

- OAMサーバー・プロキシ

注意:

アイデンティティ・ストア用のIPv6はまだサポートされていません。

15.5.6.2.1 Oracle Access Managerとチャレンジ・リダイレクトを使用したIPv6の構成

図15-1は、1つのIPv6からIPv4へのプロキシ(構成されたホストmyssohostおよびmyapphostは、別個のプロキシを使用できる)を使用した構成を示します。

Oracle Access Managerでは、仮想ホスト名はIPアドレスではなくホスト名として指定する必要があります(myapphost.foo.comなど)。リダイレクト・ホスト名(例: myssohost.foo.com)も、IPアドレスではなく、ホスト名として指定する必要があります。IPv6アドレスはWebgate登録には指定できません。

注意:

Oracle Access Managerでは、WebgateまたはリソースWebgateの認証の概念は存在しません。そのかわりに、11g Webgateまたは10g Webgateのいずれであっても、リダイレクト先は常にOAMサーバーです。

図15-1 Oracle Access Managerとチャレンジ・リダイレクトを使用したIPv6

「図15-1 Oracle Access Managerとチャレンジ・リダイレクトを使用したIPv6」の説明

図15-1に示すように、IPv6ネットワークはIPv6/IPv4プロキシと通信し、プロキシはIPv4を使用してOracle HTTP Serverと通信します。Webgate、OAMサーバーおよびOracle WebLogic Serverとアイデンティティ・アサータは、すべてIPV4を使用して互いに通信します。

IPv6ネットワーク上のブラウザからIPv6サーバー・ホスト(myapphost.foo.com)へのアプリケーションにアクセスし、IPv6 myssohost.foo.comへのリダイレクトによりログインできるようにする必要があります。

15.5.6.2.2 考慮事項

次の考慮事項が目的の使用シナリオに適用されます。

- IP検証はデフォルトでは機能しません。IP検証を有効にするには、Oracle Access Managerコンソールで、プロキシ・サーバーのIPアドレスをWebgateのIPValidationExceptionパラメータの値として追加する必要があります。

- IPアドレスベースの認証は機能しません。これは、すべてのリクエストが1つのIP(プロキシIP)を通過するため、認証の目的を果さないためです。

- ipValidationExceptionはIPValidationがOnの場合(パラメータipValidation=1)に必要です。しかし、このパラメータはOracle Access Managerコンソールまたはリモート登録ツールのいずれを使用しても追加できません。そのかわりに、プロキシのIPをoam-config.xmlファイル内のプロキシの単一値のユーザー定義パラメータとして追加する必要があります。

15.5.6.3 IPv6の構成: Oracle Access ManagerおよびWebgate用の別個のプロキシ

OAM 10gでは、リソースWebgate構成(リダイレクトする)と認証Webgate構成が提供されました。Oracle Access Manager資格証明コレクタは10g認証Webgateの機能を置き換えて実行します。

注意:

Oracle Access Managerでは、10g Webgateは常に、以前の「認証」Webgateのように機能する、Oracle Access Manager資格証明コレクタにリダイレクトされます。

この構成では複数のプロキシがあります。たとえば、OAMサーバーに個別のプロキシがあり、Webgateには別のプロキシがあります。

関連項目:

図15-1「Oracle Access Managerとチャレンジ・リダイレクトを使用したIPv6」

アプリケーションにアクセスするには、IPv4ネットワーク上のブラウザから、IPv6ホストへのログイン・リダイレクトを含むIPv4サーバーのホスト名を直接指定できます。次に例を示します。

Webgateはhttp://myapphostv4.foo.com/にあります
OAMサーバーはhttp://myssohostv4.foo.comにあります

myapphostv4.foo.comに使用するプロキシはmyapphost.foo.comにする必要があります
myssohostv4.foo.comに使用するプロキシはmyssohost.comにする必要があります

注意:

IPv6プロキシ名をWebgate登録の優先HTTPホストとして使用することはできません。

Access Managerでは、Webgate(11gまたは10g)は常にobrareq.cgiにリダイレクトするため、ProxyRequestsパラメータはOnであることが必要です。このディレクティブによりプロキシはフォワード・プロキシとして動作します。

優先HTTPホストはWebgateをホストしているWebサーバーのhost:portに設定される必要があります(またはWebgateをホストしているWebサーバーが仮想ホスト用に構成されている場合はSERVER_NAME)。

IPValidationがONの場合、IPValidationExceptionがプロキシに対し追加される必要があります。

逆プロキシが構成されてSSL終了を実行する場合、ユーザー定義のWebgate proxySSLHeaderVarパラメータがリモート登録中に定義される必要があります。Webgateがリバース・プロキシの背後にある場合、このパラメータが使用されます。proxySSLHeaderVarパラメータの値はプロキシが設定する必要のあるヘッダー変数の名前を定義します。ヘッダー変数の値はsslまたはnonsslであることが必要です。ヘッダー変数が設定されていない場合、SSL状態は現在のWebサーバーのSSL状態によって決まります。構文は次のとおりです。

<name>proxySSLHeaderVar</name>
<value>IS_SSL</value>

ロード・バランシング・ルーター(逆プロキシWebサーバー)の設定を変更し、IS_SSL値をsslに設定するHTTPヘッダー文字列を挿入します。たとえば、F5ロード・バランサ、拡張プロキシ設定で、HTTPヘッダー文字列IS_SSL:sslを追加します。

次の手順で、OHS_hostおよびOHS_portはWebgate用に構成された実際のOracle HTTP Serverのホスト名およびポートです。ご使用の環境に適した値を使用するようにしてください。実際の値はこれとは異なります。

Access ManagerおよびWebgate用に別個のプロキシを使用するIPv6を構成する手順

1. 逆プロキシ用のOracle HTTP Serverをインストールおよび構成します。各プロキシで個別のOracle HTTP Serverインスタンスがあることを確認します。

2. OAMサーバーおよびWebgateへのmod_proxyの有効化: Oracle HTTP Server 11gリリース1(11.1.1)または複数のプロキシ用の別のサーバーを次のように構成します。

1. 次のコマンドを使用して、対応するプロキシ・インスタンス用のOracle HTTP Serverを停止します。

opmnctl stopproc ias-component=OHS instance name

2. 対応するプロキシのOracle HTTP Serverインスタンス用に次のファイルを編集します。

(UNIX) ORACLE_INSTANCE/config/OHS/ohs_name1/httpd.conf
(Windows) ORACLE_INSTANCE\config\OHS\ohs_name1\httpd.conf

3. OAMサーバーへのプロキシを構成するには、環境に応じて次の情報をhttpd.confファイルに追加してmod_proxyを有効にします。次に例を示します。

<IfModule mod_proxy.c>
ProxyRequests On
ProxyPreserveHost On

ProxyPass / http://oam_server_host:port/
ProxyPassReverse / http://oam_server_host:port/
</IfModule>

4. 11g Webgateへの逆プロキシを構成するには、次のように環境に応じた情報をhttpd.confファイルに追加してmod_proxyを有効にします。

<IfModule mod_proxy.c>
ProxyRequests On
ProxyPreserveHost On

ProxyPass / http://webgate_OHS_host:port/
ProxyPassReverse / http://webgate_OHS_host:port/
</IfModule>

5. 次のコマンドを使用してOracle HTTP Serverを再起動します。

opmnctl startproc ias-component=OHS instance name

3. 認証スキームで、チャレンジ・リダイレクトURLをhttp://oam_server_proxy_host:port/oam/serverに変更します。

4. 各Webgateの優先HTTPホストを、WebgateをホストしているWebサーバーのhost:portに(またはWebgateをホストしているWebサーバーが仮想ホスティング用に構成されている場合はSERVER_NAMEに)設定してください。

1. Oracle Access Managementコンソールにログインします。次に例を示します。

http://hostname:port/oamconsole

2. 「システム構成」、「Access Managerの設定」、「SSOエージェント」、「OAMエージェント」をクリックします。

3. 「検索結果」表でエージェントを見つけてその名前をクリックして、登録ページを表示します。

4. 「優先HTTPホスト」で、このWebgate用に構成されたOracle HTTP Server Webサーバーの名前を入力します。たとえば、Webgateがmyapphostv4.foo.comにデプロイされている場合、myapphostv4.foo.comを優先HTTPホストとして使用する必要があります。

5. 「適用」をクリックします。

5. 各Webgateに対して手順を繰り返し、このWebgate用に構成されているOracle HTTP Server Webサーバーの名前を指定します。

6. IPValidationException: IPValidationがOn(パラメータ"ipValidation"=1)の場合、プロキシのIPをoam-config.xmlファイル内のプロキシの単一値のユーザー定義パラメータとして追加する必要があります。

1. すべてのOAMサーバーおよびAdminServerを停止します。

2. 次のパスでoam-config.xmlを見つけます。

WLS_DOMAIN_HOME/config/fmwconfig/oamconfig.xm

3. 次の情報を入力します。

<Setting Name="ipValidationExceptions"Type="xsd:string"> 10.1.1.1</Setting>

4. ファイルを保存します。

5. OAMサーバーおよびAdminServerを再起動します。

6. リバース・プロキシがSSL終端を実行するように構成される場合、Webgateのユーザー定義のproxySSLHeaderVarパラメータが設定される必要があります(デフォルトはIS_SSL)。ロード・バランシング・ルーター(逆プロキシWebサーバー)の設定を変更し、IS_SSL値をsslに設定するHTTPヘッダー文字列を挿入します。たとえば、F5ロード・バランサ、拡張プロキシ設定で、HTTPヘッダー文字列IS_SSL:sslを追加します。

15.5.7 Oracle Access Manager 10gでのIPv6サポートの構成

Oracle Access Manager 10gは、インターネット・プロトコル・バージョン4(IPv4)をサポートしています。Oracle Fusion Middlewareは、インターネット・プロトコル・バージョン4(IPv4)およびインターネット・プロトコル・バージョン6(IPv6)をサポートしています。IPv6は、mod_wl_ohsプラグインを使用したOracle HTTP Serverで使用できます。

リバース・プロキシ・サーバーを設定することにより、IPv6をサポートするクライアントに対応したOracle Access Managerを構成できます。これには複数のシナリオが用意されています。使用環境にあわせて適切な構成を選択してください。

15.5.7.1 IPv6による簡易認証

図15-2は、IPv6/IPv4プロキシを使用するように構成されたOracle Access Managerによる簡易認証を示しています。

注意:

Webゲート・プロファイルにはIPv6アドレスは指定できません。Webゲート・プロファイルでは、仮想ホスト名(たとえばmyapphost.foo.com)は、IPアドレスではなくホスト名として指定する必要があります。

図15-2 IPv6/IPv4プロキシによる簡易認証

「図15-2 IPv6/IPv4プロキシによる簡易認証」の説明

図15-2に示すように、IPv6ネットワークはIPv6/IPv4プロキシと通信し、続いてIPv4を使用してOracle HTTP ServerおよびWebゲートと通信します。Webゲート、Oracle Access Managerサーバーおよび認証プロバイダを使用するOracle WebLogic Serverはすべて、IPV4を使用して相互通信します。

15.5.7.2 認証Webゲートとチャレンジ・リダイレクトを使用したIPv6の構成

図15-3は、IPv6からIPv4への単一プロキシを使用した構成(ただし、myssohostとmyapphostは、それぞれ個別のプロキシを使用できます)を示しています。

注意:

Webゲート・プロファイルでは、仮想ホスト名(たとえばmyapphost.foo.com)は、IPアドレスではなくホスト名として指定する必要があります。リダイレクト・ホスト名(例: myssohost.foo.com)も、IPアドレスではなく、ホスト名として指定する必要があります。Webゲート・プロファイルにはIPv6アドレスは指定できません。

図15-3 認証Webゲートとチャレンジ・リダイレクトを使用したIPv6

「図15-3 認証Webゲートとチャレンジ・リダイレクトを使用したIPv6」の説明

図15-3に示すように、IPv6ネットワークはIPv6/IPv4プロキシと通信し、続いてIPv4を使用してOracle HTTP Serverと通信します。Webゲート、Oracle Access ManagerサーバーおよびIDアサーション・プロバイダを使用するOracle WebLogic Serverはすべて、IPV4を使用して相互通信します。

アプリケーションにアクセスするには、IPv4ネットワーク上のブラウザからIPv4サーバーのホスト名を直接指定すると、IPv6のmyssohost.foo.comにリダイレクトされログインできます。

15.5.7.3 考慮事項

対象となる使用シナリオごとに、次の点を考慮する必要があります。

- IP検証はデフォルトでは機能しません。IP検証を有効にするには、アクセス・システム・コンソールで、プロキシ・サーバーのIPアドレスをWebゲートのIPValidationExceptionパラメータの値として追加する必要があります。

- IPアドレスベースの認証は機能しません。これは、すべてのリクエストが1つのIP(プロキシIP)を通過するため、認証の目的を果さないためです。

15.5.7.4 前提条件

Oracle Access ManagerをIPv6クライアントとともに使用する方法に関係なく、開始する前には次のタスクを完了しておく必要があります。

- Oracle HTTP Serverインスタンスを、Webサーバーに対するリバース・プロキシとして動作するようにインストールする必要があります(Webゲートに必要)。

- 『Oracle Access Managerアクセス管理ガイド』の説明に従って、Oracle Access Managerをインストールして初期設定(アイデンティティ・サーバー、Webパス、ポリシー・マネージャ、アクセス・サーバー、Webゲート)を行う必要があります。

関連項目:

- 『Oracle Fusion Middleware Oracle Web Tierインストレーション・ガイド』

- 『Oracle Fusion Middleware Oracle HTTP Server管理者ガイド』

15.5.7.5 簡易認証を使用したIPv6の構成

この項の手順では、IPv6/IPv4を使用してOracle Access Managerで簡易認証を行うように使用環境を構成します。このシナリオの図は図15-2を参照してください。

この手順に含まれる構成は単なる例にすぎません。例の中のOHS_hostとOHS_portは、Webゲートを含む実際のOracle HTTP Serverのホスト名とポートです。使用環境にあわせた値を使用してください。

注意:

この構成では、Webゲート・プロファイルで優先HTTPホストとしてWebゲートがデプロイされているWebサーバーを使用してください。IPv6プロキシ名は使用できません。

簡易認証を使用してIPv6を構成するには、次の手順に従います。

1. リバース・プロキシが有効になるように、Oracle HTTP Server 11g リリース1(11.1.1)またはその他のサーバーを構成します。

1. 次のコマンドを使用して、Oracle HTTP Serverを停止します。

opmnctl stopproc ias-component=component_name

2. 次のファイルを編集します。

(UNIX) ORACLE_INSTANCE/config/OHS/ohs_name/httpd.conf
(Windows) ORACLE_INSTANCE\config\OHS\ohs_name\httpd.conf

3. httpd.confファイルに次の情報を付加します。

#---Added for Mod Proxy
<IfModule mod_proxy.c>

ProxyRequests Off
ProxyPreserveHost On

ProxyPass /http://OHS_host:OHS_port/
ProxyPassReverse /http://OHS_host:OHS_port/

</IfModule>

4. 次のコマンドを使用して、Oracle HTTP Serverを再起動します。

opmnctl startproc ias-component=component_name

2. アクセス・システム・コンソールにログインします。次に例を示します。

http://hostname:port/access/oblix

この例で、hostnameはWebパスのWebサーバーをホストするコンピュータ、portはWebパスのWebサーバー・インスタンスのHTTPポート番号を指します。また、/access/oblixはアクセス・システム・コンソールに接続します。

アクセス・システムのメイン・ページが表示されます。

3. 「アクセス・システム構成」をクリックし、「アクセス・ゲート構成」をクリックします。
「アクセス・ゲートの検索」ページが表示されます。「検索」リストには、検索可能な属性が表示されます。残りのフィールドでは、選択した属性に適した検索条件を指定できます。

4. リストから検索属性と検索条件を選択(または「すべて」をクリックしてアクセス・ゲートをすべて検索)して、「実行」をクリックします。

5. アクセス・ゲートの名前をクリックして、その詳細を表示します。

6. 「変更」をクリックします。

7. 「優先HTTPホスト」で、WebゲートをデプロイするWebサーバー名を指定し、これがすべてのHTTPリクエストに表示されるようにします。HTTPリクエスト内のホスト名は、ユーザーのHTTPリクエストでの定義に関係なく、このフィールドに入力した値に変換されます。

8. IP検証を有効にするには、プロキシ・サーバーのIPアドレスをIPValidationExceptionパラメータの値として追加します。

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

15.5.7.6 認証Webゲートとチャレンジ・リダイレクトを使用したIPv6の構成

この項の手順では、IPv6/IPv4プロキシを含むOracle Access Manager、および認証Webゲートとチャレンジ・リダイレクトを使用するように使用環境を構成します。このシナリオの図は図15-3にあります。

次の手順では、フォーム・ベース認証とリソースWebゲートの両方に共通のプロキシを使用することを前提としています。たとえば、次のような構成であると仮定します。

- リソースWebゲートのインストール先: http://myapphostv4.foo.com/

- リソースの場所: http://myapphostv4.foo.com/testing.html

- 認証Webゲートの場所: http://myssohostv4.foo.com/

- ログイン・フォーム: http://myssohostv4.foo.com/oamsso/login.html

- リバース・プロキシURL: http://myapphost.foo.com/

注意:

この構成では、優先HTTPホストは、このWebゲート用に構成されているOracle HTTP Server Webサーバー名にする必要があります。たとえば、Webゲートがmyapphost4.foo.comにデプロイされている場合、優先HTTPホストにはmyapphost4.foo.comを使用する必要があります。IPv6プロキシ名は使用できません。

次の手順では、Oracle HTTP Serverを構成し、対応するOracle HTTP Serverを優先HTTPホストとして使用するようにWebゲート・プロファイルを構成し、リバース・プロキシ・サーバーURL(この例ではhttp://myapphost.foo.com/)のチャレンジ・リダイレクト値を使用してフォーム・ベース認証スキームを構成します。

ご使用の環境に適した値を使用するようにしてください。

認証Webゲートとチャレンジ・リダイレクトを使用してIPv6を構成するには、次の手順に従います。

1. 次の手順に従って、Oracle HTTP Server 11g リリース1(11.1.1)またはその他の任意のサーバーを構成します。

1. 次のコマンドを使用して、Oracle HTTP Serverを停止します。

opmnctl stopproc ias-component=component_name

2. 次のファイルを編集します。

(UNIX) ORACLE_INSTANCE/config/OHS/ohs_name/httpd.conf
(Windows) ORACLE_INSTANCE\config\OHS\ohs_name\httpd.conf

3. httpd.confファイルに、使用環境に応じて次の情報を付加します。次に例を示します。

<IfModule mod_proxy.c>
ProxyRequests On
ProxyPreserveHost On
#Redirect login form requests and redirection requests to Authentication
WebGate

ProxyPass /obrareq.cgi   http://myssohostv4.foo.com/obrareq.cgi
ProxyPassReverse /obrareq.cgi  http://myssohostv4.foo.com/obrareq.cgi

ProxyPass /oamsso/login.html http://myssohostv4.foo.com/oamsso/login.html
ProxyPassReverse /oamsso/login.html http://myssohostv4.foo.com/oamsso/login
.html

ProxyPass /access/sso   http://myssohostv4.foo.com/ /access/sso
ProxyPassReverse /access/sso http://myssohostv4.foo.com/access/sso

# Redirect resource requests to Resource WG
ProxyPass /http://myapphostv4.foo.com /
ProxyPassReverse /http://myapphostv4.foo.com /

</IfModule>

4. 次のコマンドを使用して、Oracle HTTP Serverを再起動します。

opmnctl startproc ias-component=component_name

2. アクセス・システム・コンソールで、次のようにしてWebゲートごとに優先HTTPホストを設定します。

1. アクセス・システム・コンソールにログインします。次に例を示します。

http://hostname:port/access/oblix

この例で、hostnameはWebパスのWebサーバーをホストするコンピュータ、portはWebパスのWebサーバー・インスタンスのHTTPポート番号を指します。また、/access/oblixはアクセス・システム・コンソールに接続します。

アクセス・システムのメイン・ページが表示されます。

2. 「アクセス・システム構成」をクリックし、「アクセス・ゲート構成」をクリックします。
「アクセス・ゲートの検索」ページが表示されます。「検索」リストには、検索可能な属性が表示されます。残りのフィールドでは、選択した属性に適した検索条件を指定できます。

3. リストから検索属性と検索条件を選択(または「すべて」をクリックしてアクセス・ゲートをすべて検索)して、「実行」をクリックします。

4. アクセス・ゲートの名前をクリックして、その詳細を表示します。

5. 「変更」をクリックします。

6. 「優先HTTPホスト」で、このWebゲート用に構成されたOracle HTTP Server Webサーバーの名前を指定します。たとえば、Webゲートがmyapphostv4.foo.comにデプロイされている場合、優先HTTPホストにはmyapphostv4.foo.comを使用する必要があります。

7. IP検証を有効にするには、プロキシ・サーバーのIPアドレスをIPValidationExceptionパラメータの値として追加します。

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

9. 各Webゲートに対して手順を繰り返し、このWebゲート用に構成されているOracle HTTP Server Webサーバーの名前を指定します。

3. アクセス・システム・コンソールから、次のようにフォーム認証スキームを変更して、プロキシ・サーバーに対するチャレンジ・リダイレクトを含めます。

1. 「アクセス・システム構成」をクリックし、「認証管理」をクリックします。

2. 変更するスキームの名前をクリックして、「変更」をクリックします。

3. チャレンジ・リダイレクト値をプロキシ・サーバーURLに構成します。この例では、プロキシ・サーバーURLはhttp://myapphost.foo.com/です。

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

15.5.7.7 IPv6の構成: 認証Webゲート用とリソースWebゲート用で別々のプロキシ

この項の手順では、認証Webゲート用とリソースWebゲート用に別々のプロキシを構成します。この構成には、複数のプロキシが含まれます(認証Webゲート用のプロキシとリソースWebゲート用のプロキシなど)。アプリケーションにアクセスするには、IPv4ネットワーク上のブラウザから、IPv6ホストへのログイン・リダイレクトを含むIPv4サーバーのホスト名を直接指定できます。次に例を示します。

- リソースWebゲートの場所: http://myapphostv4.foo.com/

- 認証Webゲートの場所: http://myssohostv4.foo.com

- myapphostv4.foo.comで使用するプロキシ: myapphostv4.foo.com

- myssohostv4.foo.comで使用するプロキシ: myssohostv4.com

注意:

Webゲート・プロファイルでは、IPv6のプロキシ名を優先HTTPホストとして使用できません。

例の中のOHS_hostとOHS_portは、Webゲート用に構成されているOracle HTTP Serverのホスト名とポートです。ご使用の環境に適した値を使用するようにしてください。

認証用とリソースWebゲート用に個別のプロキシを使用したIPv6を構成するには、次の手順に従います。

1. 次の手順に従って、Oracle HTTP Server 11g リリース1(11.1.1)またはその他の複数プロキシを含むサーバーを構成します。

1. 次のコマンドを使用して、Oracle HTTP Serverを停止します。

opmnctl stopproc ias-component=component_name

2. 次のファイルを編集します。

(UNIX) ORACLE_INSTANCE/config/OHS/ohs_name/httpd.conf
(Windows) ORACLE_INSTANCE\config\OHS\ohs_name\httpd.conf

3. httpd.confファイルに、使用環境に応じて次の情報を付加します。次に例を示します。

<IfModule mod_proxy.c>
ProxyRequests Off
ProxyPreserveHost On

ProxyPass /http://OHS_host:OHS_port
ProxyPassReverse /http://OHS_host:OHS_port

</IfModule>

4. 次のコマンドを使用して、Oracle HTTP Serverを再起動します。

opmnctl startproc ias-component=component_name

2. アクセス・システム・コンソールで、次のようにしてWebゲートごとに優先HTTPホストを設定します。

1. アクセス・システム・コンソールにログインします。次に例を示します。

http://hostname:port/access/oblix

この例で、hostnameはWebパスのWebサーバーをホストするコンピュータ、portはWebパスのWebサーバー・インスタンスのHTTPポート番号を指します。また、/access/oblixはアクセス・システム・コンソールに接続します。

アクセス・システムのメイン・ページが表示されます。

2. 「アクセス・システム構成」をクリックし、「アクセス・ゲート構成」をクリックします。
「アクセス・ゲートの検索」ページが表示されます。「検索」リストには、検索可能な属性が表示されます。残りのフィールドでは、選択した属性に適した検索条件を指定できます。

3. リストから検索属性と検索条件を選択(または「すべて」をクリックしてアクセス・ゲートをすべて検索)して、「実行」をクリックします。

4. アクセス・ゲートの名前をクリックして、その詳細を表示します。

5. 「変更」をクリックします。

6. 「優先HTTPホスト」で、このWebゲート用に構成されたOracle HTTP Server Webサーバーの名前を指定します。たとえば、Webゲートがmyapphostv4.foo.comにデプロイされている場合、優先HTTPホストにはmyapphostv4.foo.comを使用する必要があります。

7. IP検証を有効にするには、プロキシ・サーバーのIPアドレスをIPValidationExceptionパラメータの値として追加します。

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

9. 各Webゲートに対して手順を繰り返し、このWebゲート用に構成されているOracle HTTP Server Webサーバーの名前を指定します。

3. アクセス・システム・コンソールから、次のようにフォーム認証スキームを変更して、プロキシ・サーバーに対するチャレンジ・リダイレクトを含めます。

1. 「アクセス・システム構成」をクリックし、「認証管理」をクリックします。

2. 変更するスキームの名前をクリックして、「変更」をクリックします。

3. チャレンジ・リダイレクト値を、認証Webゲートのリバース・プロキシとして動作するプロキシ・サーバーURLに構成します。この例では、プロキシ・サーバーURLはhttp://myssohost.foo.com/です。

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

第VII部

高度な管理: バックアップとリカバリ

バックアップとリカバリとは、ハードウェア障害およびデータの損失に備え、損失が発生した場合にデータを再構成するための様々な計画および手順を意味します。この部では、Oracle Fusion Middlewareのバックアップおよびリカバリ方法について説明します。

次の章が含まれます。

- 第16章「バックアップとリカバリの概要」

- 第17章「環境のバックアップ」

- 第18章「環境のリカバリ」

16 バックアップとリカバリの概要

この章では、Oracle Fusion Middlewareのバックアップおよびリカバリの概要(Oracle Fusion Middlewareコンポーネントに関するバックアップおよびリカバリの推奨事項を含む)について説明します。

この章の項目は次のとおりです。

- Oracle Fusion Middlewareのバックアップとリカバリの概要

- Oracle Fusion Middlewareのディレクトリ構造

- バックアップ計画の概要

- リカバリ計画の概要

- Oracle Fusion Middlewareコンポーネントのバックアップおよびリカバリに関する推奨事項

- 前提と制限

16.1 Oracle Fusion Middlewareのバックアップとリカバリの概要

Oracle Fusion Middleware環境には、様々なコンポーネントや構成を含めることができます。通常のOracle Fusion Middleware環境は、Oracle SOA SuiteなどのJavaコンポーネントが含まれるOracle WebLogic Serverドメイン、およびIdentity Managementコンポーネントが含まれるWebLogic Serverドメインで構成されます。また、Oracle HTTP Server、Oracle Web Cache、Oracle Internet Directory、Oracle Virtual Directoryなどのシステム・コンポーネントを含むOracleインスタンスを含めることもできます。

Oracle Fusion Middleware環境内のインストールでは、構成情報、アプリケーションおよびデータの同期が保たれ、相互に依存します。たとえば、構成を変更すると、構成ファイル内の情報が更新されます。アプリケーションをデプロイすると、ドメインまたはクラスタ内のすべての管理対象サーバーへのデプロイが必要な場合があります。

したがって、バックアップおよびリカバリを実行するときは、Oracle Fusion Middleware全体の環境を考慮することが重要になります。Oracle Fusion Middleware環境全体を一度に、その後定期的にバックアップしてください。そうすれば、ファイルやデータなどが失われた場合でも、環境を一貫性のある状態にリストアできます。

次の各項目では、バックアップとリカバリを理解するために重要な概念について説明します。

- 管理サーバーで発生した障害の影響

- 管理対象サーバーの独立(MSI)モード

- 管理対象サーバーでの構成の変更

関連項目:

- Oracle WebLogic Serverドメインの概念に関する情報は、第2.2項を参照してください。

- 管理サーバーの概念に関する情報は、第2.2.1項を参照してください。

- 管理対象サーバーおよびクラスタの概念に関する情報は、第2.2.2項を参照してください。

- ノード・マネージャの概念に関する情報は、第2.2.3を参照してください。

16.1.1 管理サーバーで発生した障害の影響

管理サーバーで発生した障害が、ドメイン内の管理対象サーバーの操作に影響を与えることはありませんが、管理者がドメインの構成を変更できなくなります。管理サーバーのホスト・コンピュータ上のハードウェアまたはソフトウェアの障害が原因で管理サーバーに障害が発生した場合は、同じコンピュータ上のその他のサーバー・インスタンスが同様に影響を受けることがあります。

管理対象サーバー・インスタンス(クラスタ化されているものも、そうでないものも)が実行されている場合に、そのドメインの管理サーバーが使用できなくなっても、管理対象サーバーは継続して実行されます。周期的に、これらの管理対象サーバーは管理サーバーへの再接続を試みます。クラスタ化された管理対象サーバー・インスタンスでは、ドメイン構成でサポートされているロード・バランシングおよびフェイルオーバーの機能を引き続き使用できます。

管理対象サーバーを初めて起動する場合は、管理サーバーに接続して構成のコピーを取得する必要があります。これで、管理サーバーが実行されていない場合でも、管理対象サーバーを起動できます。この場合、管理対象サーバーでは、起動構成用にドメインの構成ファイルのローカル・コピーが使用され、周期的に管理サーバーとの接続が試行されます。管理サーバーに接続されると、管理対象サーバーの構成状態が管理サーバーの構成状態に同期されます。

16.1.2 管理対象サーバーの独立(MSI)モード

管理対象サーバーでは、ドメイン構成のローカル・コピーが保持されます。管理対象サーバーは、起動時に管理サーバーに接続し、管理対象サーバーが前回停止してからドメイン構成に変更が行われた場合は、その変更を取得します。管理対象サーバーが起動時に管理サーバーに接続できない場合は、ローカルにキャッシュされている構成情報を使用できます。これは、管理対象サーバーが前回停止した時点での構成です。管理サーバーに接続して構成の更新を確認できずに起動した管理対象サーバーは、管理対象サーバーの独立(MSI)モードで実行されます。デフォルトでは、MSIモードが有効になっています。ただし、初めて起動する場合は、管理サーバーが停止しているとキャッシュされた構成を使用できないため、管理対象サーバーはMSIモードでも起動できません。

16.1.3 管理対象サーバーでの構成の変更

構成の変更は、次の場合に管理対象サーバーで更新されます。

- 管理対象サーバーが再起動するたびに、管理サーバーから最新の構成が取得されます。これは、その管理対象サーバーが実行されているノードのノード・マネージャが停止している場合でも行われます。管理対象サーバーの再起動時に管理サーバーが使用できない場合、およびMSI(管理対象サーバーの独立)モードが管理対象サーバーで有効になっている場合は、管理対象サーバーは構成のローカル・コピーを読み取って起動し、管理サーバーが使用可能になったときに管理サーバーと同期します。デフォルトでは、MSIモードが有効になっています。

- 構成の変更、アプリケーションのデプロイまたは再デプロイ、トポロジの変更など、管理上の変更がアクティブ化されるたびに、管理サーバーから管理対象サーバーに最新の構成がプッシュされます。管理対象サーバーが実行されていない場合は、管理対象サーバーが起動したときに、管理サーバーから管理対象サーバーに最新バージョンの構成がプッシュされます。

16.2 Oracle Fusion Middlewareのディレクトリ構造

Oracle Fusion Middlewareのディレクトリ構造の簡単な図を次に示します。

図dir.gifの説明

16.3 バックアップ計画の概要

Oracle Fusion Middleware環境のバックアップに使用できるものは次のとおりです。

- copy、xcopy、tar、jarなどのファイル・コピー用ユーティリティ。ユーティリティでは、次のことを確認してください。

- シンボリック・リンクが保持されること

- 長いファイル名がサポートされること

- ファイルの権限と所有権が保持されること

次に例を示します。

- Windowsでは、オンライン・バックアップにはcopy、オフライン・バックアップにはcopy、xcopyまたはjarを使用します。長いファイル名や拡張子には対応していないため、Winzipは使用しないでください。
一部のバージョンのWindowsでは、ファイル名が256文字を超えていると失敗します。この問題が発生しないようにするには、次のスイッチを指定したxcopyコマンドを使用できます。

xcopy /s/e  "C:\Temp\*.*"  "C:\copy"

構文と制限の詳細は、xcopyのヘルプを参照してください。

- LinuxおよびUNIXでは、オンラインおよびオフラインのバックアップにtarを使用します。

- Oracle Fusion Middlewareで使用されるデータベース・ベースのメタデータ・リポジトリとすべてのデータベースのバックアップに使用するOracle Recovery Manager(RMAN)。RMANでは、全体バックアップまたは増分バックアップを実行できます。RMANを使用したデータベースのバックアップについては、『Oracle Databaseバックアップおよびリカバリ・ユーザーズ・ガイド』を参照してください。

長期間バックアップを保持する場合は、たとえばOracle Secure Backupを使用して、テープにバックアップできます。

構成ファイルのバックアップ・コピーを作成するようにOracle WebLogic Serverを構成することもできます。これによって、構成の変更を元に戻す必要がある場合や、ほとんど可能性はなくとも構成ファイルが破損した場合のリカバリが簡単になります。管理サーバーの起動時に、構成ファイルを格納したconfig-booted.jarという名前の.jarファイルが保存されます。構成ファイルを変更した場合、変更前のファイルは、ドメイン・ディレクトリの下のconfigArchiveディレクトリに、config-1.jarなどの続き番号が付けられた.jarファイルとして保存されます。ただし、構成アーカイブは常に、管理サーバー・ホストのローカルとして保存されます。アーカイブは外部の場所にバックアップすることをお薦めします。

16.3.1 バックアップのタイプ

Oracle Fusion Middleware環境は、オフラインまたはオンラインでバックアップできます。

- オフライン・バックアップでは、ファイルのバックアップを行う前に環境を停止する必要があります。オフライン・バックアップを行う場合は、管理サーバー、ドメイン内のすべての管理対象サーバーおよびOracleインスタンス内のすべてのシステム・コンポーネントを停止する必要があります。
インストール後およびパッチやアップグレードの適用後はすぐに、オフラインで環境をバックアップしてください。

- オンライン・バックアップでは、ファイルのバックアップを行う前に環境を停止しません。バックアップの矛盾を防ぐために、バックアップが完了するまでは、いずれの構成も変更しないでください。WebLogic Serverドメインで変更が行われないようにするには、第3.4.2項で説明しているようにWebLogic Serverの構成をロックします。

Oracle Fusion Middleware環境全体をバックアップすることも、頻繁に変更されるファイルであるランタイム・アーティファクトをバックアップすることもできます。

全体バックアップを実行するには、静的ファイルおよび静的ディレクトリとともに、ランタイム・アーティファクトをバックアップする必要があります。これらについては、第16.3.2項で説明します。

16.3.2 バックアップ・アーティファクト

バックアップ・アーティファクトには、静的ファイルや静的ディレクトリ、およびランタイム・アーティファクトが含まれます。

静的ファイルや静的ディレクトリは、頻繁に変更されるものではありません。これには次のものがあります。

- Middlewareホーム(MW_HOME)。Middlewareホームは、WebLogic Serverホーム(Oracle WebLogic Server製品ディレクトリが含まれます)、Oracle共通ホーム、およびオプションでOracleホームで構成されます。また、Oracle WebLogic Serverドメインを格納したuser_projectsディレクトリや、静的ファイルではないOracleインスタンス・ホームが含まれる場合もあります。

- OraInventory

- LinuxおよびUNIXの場合はoraInst.locファイル。これは、次のディレクトリにあります。

(Linux and IBM AIX) /etc
(Other UNIX systems) /var/opt/oracle

- LinuxおよびUNIXの場合はoratabファイル。これは、次のディレクトリにあります。

/etc

- beahomelistファイル。これは、次の場所にあります。

(UNIX) user_home/bea/beahomelist
(Windows) C:\bea\beahomelist

- Windowsの場合は次のレジストリ・キー。

HKEY_LOCAL_MACHINE\Software\oracle

また、Oracle Web Cacheなどのシステム・コンポーネント用に、次のWindowsレジストリ・キーをバックアップする必要があります。

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services

ランタイム・アーティファクトは頻繁に変更されるファイルです。これらのファイルは、全体バックアップの実行時、および定期的にバックアップします。ランタイム・アーティファクトには次のものがあります。

- 管理サーバーおよび管理対象サーバーのドメイン・ディレクトリ(デフォルトでは、ドメイン・ディレクトリはMW_HOMEの中にありますが、別の場所を指すようにユーザーが構成できます)
ほとんどの場合、管理対象サーバーのディレクトリを個別にバックアップする必要はありません。管理サーバーのドメインには管理対象サーバーすべてに関する情報が格納されているためです。

- すべてのOracleインスタンス・ホーム。これはデフォルトでMW_HOMEの中にありますが、別の場所に置くように構成できます。

- .earファイルや.warファイルなど、ドメインの外にあるアプリケーション・アーティファクト。
管理対象サーバーのディレクトリ構造のアプリケーション・アーティファクトは、管理対象サーバーの起動時に管理サーバーから取得できるため、バックアップする必要はありません。

- MDSリポジトリなどのデータベース・アーティファクト。

- Oracle Fusion Middlewareが使用する、データベース・ベースのメタデータ・リポジトリ。Oracleのデータベースをバックアップするには、Oracle Recovery Manager(RMAN)を使用します。

- JMSプロバイダやトランザクション・ログなどの永続性ストア。これはデフォルトでuser_projectsディレクトリにありますが、別の場所に置くように構成できます。

16.3.3 推奨されるバックアップ計画

この項では、バックアップの実行に際し推奨される計画について説明します。この計画に従って、このマニュアルで説明するリカバリ手順を実行することができます。

- オフラインの全体バックアップの実行: これには、第16.3.1項で説明しているエンティティのバックアップも含まれます。オフラインの全体バックアップは、次の時点で実行します。

- Oracle Fusion Middlewareのインストール直後

- Oracle Fusion Middleware環境のアップグレードの直前

- オペレーティング・システム・ソフトウェアのアップグレード直後

- Oracle Fusion Middlewareのアップグレードまたはパッチ適用直後

- ランタイム・アーティファクトのオンライン・バックアップの実行: これには、第16.3.1項で説明しているランタイム・アーティファクトのバックアップも含まれます。ランタイム・アーティファクトをバックアップすることにより、構成とメタデータを最後にバックアップした時点の一貫性のある状態に環境をリストアすることができます。バックアップの矛盾を防ぐために、バックアップが完了するまでは、いずれの構成も変更しないでください。ランタイム・アーティファクトのオンライン・バックアップは、次の時点で実行します。

- 定期的。ランタイム・アーティファクトのバックアップは夜間に行うことをお薦めします。

- コンポーネントに対して構成の変更を行う前。

- コンポーネントに対して構成の変更を行った後。

- 管理対象サーバーまたはクラスタにカスタムのJava EEアプリケーションをデプロイする前。

- サーバーやクラスタの作成など、デプロイメント・アーキテクチャに対して大きな変更が行われた後。

- データベースの全体バックアップまたは増分バックアップの実行: RMANを使用してデータベースをバックアップします。RMANの使用方法および推奨されるデータベースのバックアップ方法については、『Oracle Databaseバックアップおよびリカバリ・ユーザーズ・ガイド』を参照してください。

16.4 リカバリ計画の概要

リカバリ計画により、実データの損失などの重大な障害からのリカバリが可能になります。損失のタイプにもよりますが、次のファイル・タイプのどのような組合せでもリカバリできます。

- Oracleソフトウェア・ファイル

- 構成ファイル

- Oracleシステム・ファイル

- Windowsレジストリ・キー

- アプリケーション・アーティファクト

Oracle Fusion Middleware環境のリカバリは、Oracle Fusion Middlewareがオフラインのときに実行できます。

Oracle Fusion Middleware環境のリカバリに使用できるものは次のとおりです。

- copy、xcopy、tarなどのファイル・コピー用ユーティリティ
ファイルのリストア時、圧縮ファイルの解凍には、それに適したツールを使用します。

- Windowsでのオンライン・リカバリには、copyを使用します。オフライン・リカバリには、copy、xcopyまたはjarを使用します。
一部のバージョンのWindowsでは、ファイル名が256文字を超えていると失敗します。この問題が発生しないようにするには、次のスイッチを指定したxcopyコマンドを使用できます。

xcopy /s/e  "C:\Temp\*.*"  "C:\copy"

構文と制限の詳細は、xcopyのヘルプを参照してください。

長いファイル名や拡張子には対応していないため、Winzipは使用しないでください。

- LinuxおよびUNIXの場合はtarを使用します。

使用しているツールが、ファイルの権限とタイムスタンプを保持することを確認してください。

- データベース・ベースのメタデータ・リポジトリのリカバリにはOracle Recovery Manager(RMAN)

16.4.1 リカバリのタイプ

Oracle Fusion Middleware環境は、部分的にまたは全体をリカバリできます。次のリカバリが可能です。

- Middlewareホーム

- WebLogic Serverドメイン

- WebLogic Server管理サーバー

- WebLogic Server管理対象サーバー

- Oracleホーム

- Oracleインスタンス・ホーム

- Oracle SOA SuiteやOracle HTTP Serverなどのコンポーネント

- WebLogic Serverクラスタ

- デプロイ済アプリケーション

16.4.2 推奨されるリカバリ計画

リカバリに関しては次の重要な点に注意してください。

- Oracle Fusion Middleware環境は、リカバリの実行中はオフラインにする必要があります。

- 必要なファイルを間違って上書きしないよう、バックアップからファイルをリストアする前に既存の重要なファイルおよびディレクトリの名前を変更してください。

- 1、2個のファイルのみが消失または破損しているように見える場合もありますが、1、2個のファイルのみをリストアするのではなく、Oracleインスタンス・ホームやドメインなど要素全体のディレクトリ構造をリストアする必要があります。そうすることで、リカバリが成功する可能性が高くなります。

- ポイント・イン・タイム・リカバリを使用して、データベースを最新の状態にリカバリします(データベースがアーカイブ・ログ・モードで構成されている場合)。これは通常、データベースに障害が発生する直前の状態です。

16.5 Oracle Fusion Middlewareコンポーネントのバックアップおよびリカバリに関する推奨事項

次の各項では、具体的なOracle Fusion Middlewareコンポーネントのバックアップおよびリカバリに関する推奨事項について説明します。

- Oracle WebLogic Serverのバックアップおよびリカバリに関する推奨事項

- Oracle Identity Managementのバックアップおよびリカバリに関する推奨事項

- Oracle SOA Suiteのバックアップおよびリカバリに関する推奨事項

- Oracle WebCenter Portalのバックアップおよびリカバリに関する推奨事項

- Oracle JRFインストールのバックアップおよびリカバリに関する推奨事項

- Web層インストールのバックアップおよびリカバリに関する推奨事項

- Oracle Portal、Oracle Forms Services、Oracle Reports、Oracle BI Discovererの各インストールのバックアップおよびリカバリに関する推奨事項

- Oracle Business Intelligenceのバックアップおよびリカバリに関する推奨事項

- Oracle Hyperion Enterprise Performance Management Systemのバックアップおよびリカバリに関する推奨事項

- Oracle Data Integratorのバックアップおよびリカバリに関する推奨事項

- Oracle WebCenter Contentのバックアップおよびリカバリに関する推奨事項

これらの項目には、特定のコンポーネントの構成ファイルに関する情報が含まれています。ファイルのリストが包括的なリストではないことに注意してください。個々のファイルをバックアップしたりリカバリするわけではありません。一般的に、バックアップまたはリカバリするのは、Middlewareホーム、ドメイン、OracleホームまたはOracleインスタンスです。

環境のバックアップ手順は、第17.3項を参照してください。コンポーネントのリカバリ手順は、第18章を参照してください。

16.5.1 Oracle WebLogic Serverのバックアップおよびリカバリに関する推奨事項

次の各項では、Oracle WebLogic Serverのバックアップおよびリカバリに関する推奨事項について説明します。

- Oracle WebLogic Serverのバックアップおよびリカバリに関する推奨事項

- Oracle WebLogic Server JMSのバックアップおよびリカバリに関する推奨事項

16.5.1.1 Oracle WebLogic Serverのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle WebLogic Serverのデータについて説明します。

構成ファイル

構成ファイルおよびアプリケーションは、ドメイン・ホームに格納されています。

データベース・リポジトリに依存するもの

デフォルトでは、Oracle WebLogic Serverは、いずれのデータベース・リポジトリにも依存しません。ただし、Oracle WebLogic Serverにデプロイされたアプリケーションでは、データソースとしてデータベースが使用される場合があります。データベースをバックアップするには、『Oracle Databaseバックアップおよびリカバリ・ユーザーズ・ガイド』を参照してください。

バックアップに関する推奨事項

Middlewareホームおよびドメインをバックアップします。

リカバリに関する推奨事項

障害が発生したものによっては、次のリカバリが必要になることがあります。

- ドメイン: 第18.2.2項を参照

- 管理サーバーの構成: 第18.2.5項を参照

- 管理対象サーバー: 第18.2.6項を参照

- クラスタ: 第18.2.8項を参照

- アプリケーション: 第18.2.9項を参照

サーバー全体の移行機能を使用する場合、リース情報はデータベースの表に格納されます。Oracle WebLogic Serverをリカバリする場合は、リース表の情報を破棄する必要があります(サーバー全体の移行の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverクラスタの使用』のサーバー全体の移行に関する項を参照)。

ホストの破損後には、次のリカバリが必要になることがあります。

- 管理サーバー・ホスト: 第18.3.2項を参照

- 管理対象サーバー・ホスト: 第18.3.3項を参照

16.5.1.2 Oracle WebLogic Server JMSのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle WebLogic Server JMSのデータについて説明します。

構成ファイル

DOMAIN_HOME/config/jms

ファイルシステムでアクセス可能なストアがJMSで使用されている場合、デフォルトのファイルシステム・ストアは、config.xmlで指定されているユーザー構成の場所か、または次の場所にあります。

DOMAIN_HOME/servers/server_name/data/store/default

データベース・リポジトリに依存するもの

JMSがデータベース・ベースの場合のみ

バックアップに関する推奨事項

ドメインをバックアップします。

データベース・ベースのJMSを使用している場合は、RMANを使用してデータベースをバックアップします。

ファイル・ベースのJMSを使用している場合は、ストレージのスナップショット技術を使用して一貫性のあるオンライン・バックアップを取ります。または、ファイル・システムのコピーを使用してオフライン・バックアップを実行することもできます。

リカバリに関する推奨事項

ドメインをリカバリします。

JMS永続ストアがファイルベースの場合は、バックアップからリカバリします。JMS永続ストアがデータベース・ベースの場合は、必要に応じて、データベースを直近の時点にリカバリします。次の点に注意してください。

- JMSデータは常に、できるだけ最新に保つようにします。これを実現するには、データベース・ベースの永続性を確保する場合はOracle Databaseのポイント・イン・タイム・リカバリ機能を使用して直近の時間にリカバリするか、またはSAN/NASなど可用性の高いRAID対応ストレージ・デバイスを使用します。

- ファイル・ベースのJMSを使用している場合は、ストレージのスナップショットを使用してリカバリできます。

- どのような理由であれ、JMSデータを前の時点にリストアする必要がある場合、リストアによって影響が及ぶ可能性があります。システムの状態を前の時点にリストアすると、メッセージを複製する可能性だけでなく、メッセージを失う可能性もあります。この場合に失われたメッセージは、システムのリストア時点の前または後にエンキューされていた未処理のメッセージです。
重複メッセージを処理しないようにするには、リカバリの前に次の手順を実行して、永続ストアのリカバリ後にJMSキュー内のメッセージを排出する必要があります。

注意:

メッセージを排出および破棄する前に、保存の必要なデータがメッセージに含まれていないことを確認してください。リカバリしたメッセージには、処理済の重複メッセージの他に、重要なアプリケーション・データが含まれる未処理のメッセージが含まれている可能性があります。

1. Oracle WebLogic Server管理コンソールにログインします。

2. 新しいメッセージが生成されたり宛先に挿入されたりしないように、また失効したメッセージを排出する前に宛先から消費されないようにするため、リカバリの前に、起動時の生成、挿入、消費の各操作を休止するようにJMSサーバーを構成します。その手順は次のとおりです。

1. 「サービス」を開いてから「メッセージング」を開き、「JMSサーバー」をクリックします。

2. 「JMSサーバー」ページの「サマリー」で、メッセージを休止するように構成するJMSサーバーをクリックします。

3. 「構成: 全般」ページで「詳細」をクリックして、メッセージの休止オプションを定義します。「起動時に挿入を休止」、「起動時に生成を休止」および「起動時に消費を休止」を選択します。

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

リカバリ後に実行する手順は次のとおりです。

1. 永続ストアのリカバリ後に、管理対象サーバーを起動します。

2. 次の手順を実行して、失効したメッセージをJMS宛先から排出します。

1. 「サービス」を開いてから「メッセージング」を開き、「JMSモジュール」を開きます。

2. JMSモジュールを選択して、ターゲットを選択します。

3. 「監視」を選択して、「メッセージの表示」を選択します。

3. 「すべて削除」をクリックします。

4. 次の手順を実行して、操作を再開します。

1. 「サービス」を開いてから「メッセージング」を開き、「JMSサーバー」を開きます。

2. 「JMSサーバー」ページの「サマリー」で、メッセージを休止するように構成するJMSサーバーをクリックします。

3. 「構成: 全般」ページで「詳細」をクリックします。「起動時に挿入を休止」、「起動時に生成を休止」および「起動時に消費を休止」を選択解除します。

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

永続ストアがJMS専用でない場合は、Oracle WebLogic Server JMSメッセージ管理ツールを使用します。このツールでは、操作のインポート、エクスポート、移動および削除を、管理コンソール、MBeanおよびWLSTから実行できます。

キューイングの他に、パブリッシュおよびサブスクライブも使用するアプリケーションの場合は、キューに加えてトピック・サブスクリプションを操作する必要があります。

ドメインのリカバリ手順は、第18.2.2項および第18.3.1項を参照してください。

16.5.2 Oracle Identity Managementのバックアップおよびリカバリに関する推奨事項

次の各項では、Oracle Identity Managementのバックアップおよびリカバリに関する推奨事項について説明します。

- Oracle Internet Directoryのバックアップおよびリカバリに関する推奨事項

- Oracle Virtual Directoryのバックアップおよびリカバリに関する推奨事項

- Oracle Directory Integration Platformのバックアップおよびリカバリに関する推奨事項

- Oracle Directory Services Managerのバックアップおよびリカバリに関する推奨事項

- Oracle Identity Federationのバックアップおよびリカバリに関する推奨事項

- Oracle Access Managerのバックアップおよびリカバリに関する推奨事項

- Oracle Adaptive Access Managerのバックアップおよびリカバリに関する推奨事項

- Oracle Identity Managerのバックアップおよびリカバリに関する推奨事項

- Oracle Identity Navigatorのバックアップおよびリカバリに関する推奨事項

16.5.2.1 Oracle Internet Directoryのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Internet Directoryのデータについて説明します。

構成ファイル

ORACLE_INSTANCE/config/tnsnames.ora
ORACLE_INSTANCE/OID/admin
ORACLE_INSTANCE/OID/ldap/server/plugin
ORACLE_INSTANCE/OID/component_name
ORACLE_INSTANCE/config/OID/component_name

データベース・リポジトリに依存するもの

ODSスキーマおよびODSSMスキーマ

バックアップに関する推奨事項

Oracle Internet Directoryコンポーネント・ディレクトリ、およびOracle Internet Directoryが含まれるOracleインスタンス・ホームをバックアップします。ODSスキーマおよびODSSMスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

Oracle Internet Directoryが含まれるOracleインスタンス・ホームをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

Oracle Internet Directoryを含むOracleインスタンス・ホームのリカバリ手順は、第18.2.4項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.5.1項を参照してください。

16.5.2.2 Oracle Virtual Directoryのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Virtual Directoryのデータについて説明します。

構成ファイル

ORACLE_INSTANCE/OVD/component_name
ORACLE_INSTANCE/config/OVD/component_name
ORACLE_INSTANCE/diagnostics/logs/OVD/component_name

データベース・リポジトリに依存するもの

なし

バックアップに関する推奨事項

Oracle Virtual Directoryが含まれるOracleインスタンス・ホームをバックアップします。ODSSMスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

Oracle Virtual Directoryが含まれるOracleインスタンス・ホームをリストアします。

Oracle Virtual Directoryを含むOracleインスタンス・ホームのリカバリ手順は、第18.2.4項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.5.2項を参照してください。

16.5.2.3 Oracle Directory Integration Platformのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Directory Integration Platformのデータについて説明します。

構成ファイル

DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/dip_version_number/configuration/dip-config.xml

ファイルdip-config.xmlは、Oracle Directory Integration Platformアプリケーションの一部です。これは、管理サーバーのドメインのバックアップ時にバックアップされます。

データベース・リポジトリに依存するもの

Oracle Internet Directoryで使用されるODSSMスキーマ

バックアップに関する推奨事項

管理サーバーのドメインのディレクトリ、管理対象サーバーのディレクトリ、およびOracle Internet Directoryとそれに依存するものをバックアップします。

リカバリに関する推奨事項

Oracle Directory Integration Platformアプリケーションがデプロイされている管理対象サーバーをリカバリします。

Oracle Internet Directoryをリカバリします。

管理対象サーバーのリカバリ手順は、第18.2.6項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.5.3項を参照してください。

16.5.2.4 Oracle Directory Services Managerのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Directory Services Managerのデータについて説明します。

構成ファイル

Oracle Directory Services Managerは、Oracle Internet DirectoryおよびOracle Virtual Directoryのグラフィカル・ユーザー・インタフェースであり、構成ファイルはありませんが、アプリケーションの.earファイルに含まれるserverlist.txtで、Oracle Internet DirectoryおよびOracle Virtual Directoryのホストおよびポート情報を追跡します。

DOMAIN_HOME/servers/server_name/tmp/_WL_user/odsm_version/nx1i7i/war/WEB-INF/serverlist.txt

データベース・リポジトリに依存するもの

なし

バックアップに関する推奨事項

ドメインをバックアップします。

リカバリに関する推奨事項

Oracle Directory Services Managerをリストアするには、Oracle Internet DirectoryまたはOracle Virtual Directoryに接続するためのユーザー名およびパスワードを入力します。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4項を参照してください。

16.5.2.5 Oracle Identity Federationのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Identity Federationのデータについて説明します。

構成ファイル

DOMAIN_HOME/servers/server_name/stage/OIF/version/OIF/configuration

データベース・リポジトリに依存するもの

OIFスキーマ

バックアップに関する推奨事項

管理サーバーのドメイン、管理対象サーバー、およびOIFスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

Oracle Identity Federationアプリケーションがデプロイされている管理対象サーバーをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

管理対象サーバーのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.5.4項を参照してください。

16.5.2.6 Oracle Access Managerのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Access Managerのデータについて説明します。

構成ファイル

DOMAIN_HOME/config/fmwconfig/oam-config.xml

データベース・リポジトリに依存するもの

Oracle Access Managerポリシー・ストアで使用されるスキーマ

バックアップに関する推奨事項

Middlewareホーム、およびOracle Access Managerサーバーのドメイン・ホームをバックアップします。Webゲートが含まれるOracle HTTP ServerのOracleホームとOracleインスタンス、およびOracle Access Managerポリシー・ストアで使用されるスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

Middlewareホーム、およびOracle Access Managerサーバーのドメイン・ホームをリカバリします。必要に応じて、Webgateが含まれるOracle HTTP ServerのOracleホームおよびOracleインスタンスをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

Oracle Access Managerのリカバリ手順は、第18.2.7.5項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.5.7項を参照してください。

16.5.2.7 Oracle Adaptive Access Managerのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Adaptive Access Managerのデータについて説明します。

構成ファイル

構成ファイルは、ドメイン・ホームに格納されています。

データベース・リポジトリに依存するもの

OAAM、OAAM_PARTN、OAAM_OFFLINEの各スキーマ

バックアップに関する推奨事項

ドメイン、Oracleホーム、およびスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

障害の程度に応じて、ドメインまたはOracleホームをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

Oracle Adaptive Access Managerのリカバリ手順は、第18.2.7.6項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.5.8項を参照してください。

16.5.2.8 Oracle Identity Managerのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Identity Managerのデータについて説明します。

構成ファイル

Oracle WebLogic Serverに固有の構成ファイルは、ドメイン・ホームに格納されています。Oracle Identity Managerの構成ファイルoim-config.xmlおよびその他の構成ファイルは、MDSに格納されています。

Oracle Identity Managerでは、ワークフローにOracle SOA Suiteが使用されるため、Oracle SOA Suiteの構成ファイルを参照してください。これは、第16.5.3項で説明しています。

データベース・リポジトリに依存するもの

OIM、MDS、Oracle SOA Suiteの各スキーマ、およびオプションでOIDスキーマ

バックアップに関する推奨事項

ドメイン、Oracleホーム、およびスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

障害の程度に応じて、ドメインまたはOracleホームをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

Oracle Identity Managerのリカバリ手順は、第18.2.7.3項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.5.5項を参照してください。

16.5.2.9 Oracle Identity Navigatorのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Identity Navigatorのデータについて説明します。

構成ファイル

構成ファイルは、ファイルベースのMDSリポジトリに格納されています。

データベース・リポジトリに依存するもの

MDSスキーマ

バックアップに関する推奨事項

ドメインおよびOracleホームをバックアップします。WLST exportMetadataコマンドを使用して、ファイルベースのMDSリポジトリをバックアップします。次に例を示します。

exportMetadata(application='oinav',server='server_name',toLocation='export_directory')

リカバリに関する推奨事項

ドメイン、OracleホームおよびファイルベースのMDSリポジトリをリカバリします。

Oracle Identity Navigatorのリカバリ手順は、第18.2.7.4項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.5.6項を参照してください。

16.5.3 Oracle SOA Suiteのバックアップおよびリカバリに関する推奨事項

次の各項では、Oracle SOA Suiteのバックアップおよびリカバリに関する推奨事項について説明します。

- Oracle BPEL Process Managerのバックアップおよびリカバリに関する推奨事項

- Oracle Business Activity Monitoringのバックアップおよびリカバリに関する推奨事項

- Oracle B2Bのバックアップおよびリカバリに関する推奨事項

- Oracle Service Busのバックアップおよびリカバリに関する推奨事項

- Oracle Mediatorのバックアップおよびリカバリに関する推奨事項

- Oracle Business Rulesのバックアップおよびリカバリに関する推奨事項

- Oracle Business Process Managementのバックアップおよびリカバリに関する推奨事項

コンポーネントのリカバリに必要な手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.6項を参照してください。

16.5.3.1 Oracle BPEL Process Managerのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle BPEL Process Managerのデータについて説明します。

構成ファイル

構成ファイルは、データベースに格納されています。

データベース・リポジトリに依存するもの

プロセス定義と構成ファイルは、MDSスキーマに格納されています。デハイドレーション・ストアは、BPELスキーマに格納されています。

バックアップに関する推奨事項

管理サーバーのドメインのディレクトリをバックアップします。グローバル・フォルト・ポリシー、ワークフローのコールバック・クラス、スーツケースの外部にある可能性のあるリソース・バンドルに対する変更など、構成に変更があった場合はその変更後にデータベースをバックアップします。また、データベースは、新しいコンポジットのデプロイまたはコンポジットの再デプロイの後にもバックアップします。

リカバリに関する推奨事項

必要に応じて、データベースを直近の時点にリカバリします。ポイント・イン・タイム・リカバリを使用すると、最新のプロセス定義および進行中のインスタンスがリストアされます。ただし、これによってプロセスの手順が再実行される場合があります。できるかぎり、Oracle BPEL Process Managerの冪等プロセスを使用することをお薦めします。冪等以外のプロセスがシステムに含まれている場合は、それらをデハイドレーション・ストアからクリーンアップしてからOracle Fusion Middlewareを起動する必要があります。詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』を参照してください。

インスタンスでは、プロセス定義とアーティファクトがすべてデータベースから取得されるため、データベースを最新の状態にリカバリした後で構成をリカバリする必要はありません。インスタンスは、引き続き正常に機能します。

再デプロイしたコンポジットの場合、データベースのリカバリによって、デハイドレーションされた進行中のプロセスとそれに対応する定義との整合性が確保されます。これは、デハイドレーションされたインスタンスも格納されているデータベース・リポジトリにプロセス定義が格納されているためです。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.6項を参照してください。

16.5.3.2 Oracle Business Activity Monitoringのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Business Activity Monitoringのデータについて説明します。

構成ファイル

SOA_ORACLE_HOME/bam
DOMAIN_HOME/config/fmwconfig/servers/AdminServer/adml/server-oracle_bamweb-11.0.xml
DOMAIN_HOME/config/fmwconfig/servers/AdminServer/adml/server-oracle_bamserver-11.0.xml
DOMAIN_HOME/config/fmwconfig/servers/bam-server-name/adml/server-oracle_bamweb-11.0.xml
DOMAIN_HOME/config/fmwconfig/servers/bam-server-name/adml/server-oracle_bamserver-11.0.xml

データベース・リポジトリに依存するもの

ORABAMスキーマ

バックアップに関する推奨事項

Middlewareホーム、管理サーバーのドメイン、管理対象サーバーのディレクトリ、およびORABAMスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

障害の程度に応じて、管理対象サーバーとMiddlewareホームのいずれかまたは両方をリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.6項を参照してください。

16.5.3.3 Oracle B2Bのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle B2Bのデータについて説明します。

構成ファイル

DOMAIN_HOME/config/soa-infra/configuration/b2b-config.xml

データベース・リポジトリに依存するもの

MDSスキーマ

バックアップに関する推奨事項

管理サーバーのドメイン、Oracleホーム(Oracle B2Bの構成ファイルが変更された場合)、およびMDSスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

soa-infraアプリケーションがデプロイされている管理対象サーバーをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

リカバリ後、ファイルXengine.tar.gzが解凍されていない場合は解凍します。次に例を示します。

cd B2B_ORACLE_HOME/soa/thirdparty/edifecs
tar xzvf XEngine.tar.gz

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.6項を参照してください。

16.5.3.4 Oracle Service Busのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリカバリが必要なOracle Service Busのデータについて説明します。

構成ファイル

DOMAIN_HOME/osb/config/core

データベース・リポジトリに依存するもの

Oracle Service Busでは、レポート機能が有効になっている場合にはデータベースが必要です。ユーザー指定のスキーマに、WLI_QS_REPORT_DATAとWLI_QS_REPORT_ATTRIBUTEという2つの表が作成されます。

バックアップに関する推奨事項

管理サーバーのドメイン、およびOracle Service Busの表が含まれるデータベースをバックアップします。

リカバリに関する推奨事項

管理対象サーバーをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

コンポーネントのリカバリに必要な手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.6項を参照してください。

16.5.3.5 Oracle Mediatorのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Mediatorのデータについて説明します。

構成ファイル

DOMAIN_HOME/config/soa-infra/configuration/mediator-config.xml
DOMAIN_HOME/config/soa-infra/configuration/mediator-xpath-functions-config.xml

データベース・リポジトリに依存するもの

MDSスキーマおよびSOAINFRAスキーマ。

バックアップに関する推奨事項

管理サーバーのドメインと、MDSスキーマおよびSOAINFRAスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

soa-infraアプリケーションがデプロイされている管理対象サーバーをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

コンポーネントのリカバリに必要な手順は、第18.2.7項および第18.3.4項を参照してください。

ホストの破損からのリカバリに固有の推奨事項は、第18.3.4.6項を参照してください。

16.5.3.6 Oracle Business Rulesのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Business Rulesのデータについて説明します。

構成ファイル

DOMAIN_HOME/config/soa-infra/configuration/businessrules-config.xml

データベース・リポジトリに依存するもの

MDSスキーマ

バックアップに関する推奨事項

管理サーバーのドメイン、およびMDSスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

soa-infraアプリケーションがデプロイされている管理対象サーバーをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.6項を参照してください。

16.5.3.7 Oracle Business Process Managementのバックアップおよびリカバリに関する推奨事項

Oracle Business Process Managementの場合、第16.5.3.1項で説明しているOracle BPEL Process Managerの場合と同じデータをバックアップおよびリストアします。この項では、Oracle Business Process Managementに固有のデータについて説明します。

構成ファイル

DOMAIN_HOME/config/fmwconfig/logging/oracle.bpm-logging.xml
DOMAIN_HOME/config/jms/bpmjmsmodule-jms.xml

データベース・リポジトリに依存するもの

プロセス定義と構成ファイルは、MDSスキーマに格納されています。

バックアップに関する推奨事項

第16.5.3.1項で説明しているOracle BPEL Process Managerの場合の推奨事項に加えて、クラスタ内のすべてのOracleホームを含め、Oracleホームをバックアップする必要があります。SOAのドメインをOracle Business Process Managementに拡張してOracle Business Process Managementを構成する場合、このプロセスによってOracle Business Process ManagementのOracleホームにファイルが追加されます。ただし、クラスタ内のその他のOracleホームには、これらのファイルはコピーされません。Oracle Business Process Managementの構成後に、クラスタ内の他のOracleホームにファイルをコピーしておく必要がありました。結果として、クラスタ内のOracleホームをすべてバックアップする必要があります。

リカバリに関する推奨事項

第16.5.3.1項で説明しているOracle BPEL Process Managerの場合の推奨事項に加えて、クラスタ内のOracleホームをすべてリカバリする必要があります。

Oracle Business Process Managementのリカバリ手順は、第18.2.7.7項を参照してください。

16.5.4 Oracle WebCenter Portalのバックアップおよびリカバリに関する推奨事項

次の各項では、Oracle WebCenter Portalのバックアップおよびリカバリに関する推奨事項について説明します。

- Oracle WebCenter Portalのバックアップおよびリカバリに関する推奨事項

- Oracle WebCenter Portalのポートレット・プロデューサのバックアップおよびリカバリに関する推奨事項

- Oracle WebCenter Portalのディスカッション・サーバーのバックアップおよびリカバリに関する推奨事項

- Oracle WebCenter Portalのアクティビティ・グラフのバックアップおよびリカバリに関する推奨事項

- Oracle WebCenter Portal分析のバックアップおよびリカバリに関する推奨事項

- Oracle Content Serverのバックアップおよびリカバリに関する推奨事項

16.5.4.1 Oracle WebCenter Portalのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle WebCenter Portalデータについて説明します。

構成ファイル

構成ファイルはすべて、ドメイン内に格納されているEARファイルにバンドルされています。

データベース・リポジトリに依存するもの

WEBCENTERスキーマおよびMDSスキーマ

バックアップに関する推奨事項

管理サーバーのドメインと、WEBCENTERスキーマおよびMDSスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

Oracle WebCenter Portalドメインをリカバリします。

必要に応じて、WEBCENTERスキーマおよびMDSスキーマが含まれるデータベースを直近の時点にリカバリします。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4項を参照してください。

16.5.4.2 Oracle WebCenter Portalのポートレット・プロデューサのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle WebCenter Portalのポートレット・プロデューサのデータについて説明します。

構成ファイル

構成ファイルはすべて、ドメイン内に格納されているEARファイルにバンドルされています。

データベース・リポジトリに依存するもの

PORTLETスキーマ

バックアップに関する推奨事項

管理サーバーのドメイン、およびPORTLETスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

Oracle WebCenter Portalドメインをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4項を参照してください。

16.5.4.3 Oracle WebCenter Portalのディスカッション・サーバーのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle WebCenter Portalのディスカッション・サーバーのデータについて説明します。

構成ファイル

一部の構成ファイルは、ドメイン内に格納されているEARファイルにバンドルされているか、またはドメイン内の他の場所に格納されています。その他の構成ファイルの格納場所は次のとおりです。

DOMAIN_HOME/fmwconfig/server/server_name/owc_discussions

データベース・リポジトリに依存するもの

DISCUSSIONSスキーマ

バックアップに関する推奨事項

管理サーバーのドメイン、およびDISCUSSIONSスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

Oracle WebCenter Portalドメインをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4項を参照してください。

16.5.4.4 Oracle WebCenter Portalのアクティビティ・グラフのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle WebCenter Portalのアクティビティ・グラフのデータについて説明します。

構成ファイル

構成情報は、ACTIVITIESスキーマに格納されます。

データベース・リポジトリに依存するもの

ACTIVITIESスキーマ

バックアップに関する推奨事項

Oracleホーム、ドメイン・ホーム、およびACTIVITIESスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

Oracleホームおよびドメイン・ホームをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

Oracle WebCenter Portalのアクティビティ・グラフのリカバリ手順は、第18.2.7.8項を参照してください。

16.5.4.5 Oracle WebCenter Portal分析のバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle WebCenter Portal分析データについて説明します。

構成ファイル

構成情報は、AnalyticsスキーマのACTIVITIESに格納されます。

データベース・リポジトリに依存するもの

ACTIVITIESスキーマおよびMDSスキーマ

バックアップに関する推奨事項

Oracleホーム、ドメイン・ホーム、およびACTIVITIESスキーマとMDSスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

Oracleホームおよびドメイン・ホームをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

Oracle WebCenter Portal分析のリカバリ手順は、第18.2.7.9項を参照してください。

16.5.4.6 Oracle Content Serverのバックアップおよびリカバリに関する推奨事項

Oracle Content Serverのバックアップおよびリカバリの詳細は、Content Serverスタート・ガイドを参照してください。次のリンクから入手可能です。

http://download.oracle.com/docs/cd/E10316_01/owc.htm

Oracle WebCenter Contentのバックアップおよびリカバリについては、第16.5.11.3項を参照してください。

データベース・リポジトリに依存するもの

OCSスキーマ

16.5.5 Oracle JRFインストールのバックアップおよびリカバリに関する推奨事項

次の各項では、複数のタイプのインストールを使用してインストールされているコンポーネントのバックアップとリカバリに関する推奨事項について説明します。

- Oracle Web Services Managerのバックアップおよびリカバリに関する推奨事項

- Oracle Platform Security Servicesのバックアップおよびリカバリに関する推奨事項

16.5.5.1 Oracle Web Services Managerのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Web Services Managerのデータについて説明します。

構成ファイル

DOMAIN_HOME/config/fmwconfig/policy-accessor-config.xml

データベース・リポジトリに依存するもの

データベース・ベースのMDSリポジトリを使用する場合、Oracle Web Services Managerでは、MDSスキーマでパーティションが使用されます。

バックアップに関する推奨事項

Oracle Web Services Managerドメインをバックアップします。

Oracle Web Services ManagerでファイルベースのMDSリポジトリが使用されている場合は、ファイル・コピー・メカニズムを使用してバックアップします。データベース・ベースのMDSリポジトリが使用されている場合は、RMANを使用してデータベースをバックアップします。

リカバリに関する推奨事項

Oracle Web Services Managerの管理対象サーバーをリストアします。

Oracle Web Services ManagerでファイルベースのMDSリポジトリが使用されている場合は、バックアップからリストアします。データベース・ベースのMDSリポジトリが使用されている場合は、必要に応じて、データベースを直近の時点にリカバリします。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4項を参照してください。

16.5.5.2 Oracle Platform Security Servicesのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Platform Security Servicesのデータについて説明します。

構成ファイル

DOMAIN_HOME/config/fmwconfig/jps-config.xml

データベース・リポジトリに依存するもの

データベース・ベースのOracle Platform Securityリポジトリを使用する場合、Oracle Platform SecurityではOPSSスキーマでパーティションが使用されます。

Oracle Internet DirectoryベースのOracle Platform Securityリポジトリを使用する場合、Oracle Platform SecurityではOracle Internet Directoryが使用されます。

バックアップに関する推奨事項

管理サーバーのドメインをバックアップします。Oracle Platform SecurityでOracle Internet Directoryベースのリポジトリを使用する場合は、Oracle Internet Directoryをバックアップします。

Oracle Platform Securityでデータベース・ベースのリポジトリを使用する場合は、OPSSスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

jps-config.xmlファイルをリストアします。

Oracle Platform Securityでデータベース・ベースのリポジトリを使用する場合は、データベースを直近の時点にリカバリします。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4項および第18.3.4.5.1項を参照してください。

16.5.6 Web層インストールのバックアップおよびリカバリに関する推奨事項

次の各項では、Web層インストールのバックアップおよびリカバリに関する推奨事項について説明します。

- Oracle HTTP Serverのバックアップおよびリカバリに関する推奨事項

- Oracle Web Cacheのバックアップおよびリカバリに関する推奨事項

16.5.6.1 Oracle HTTP Serverのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle HTTP Serverのデータについて説明します。

構成ファイル

ORACLE_INSTANCE/config/OHS/component_name
ORACLE_INSTANCE/diagnostics/logs/OHS/component_name

データベース・リポジトリに依存するもの

なし

バックアップに関する推奨事項

Oracle HTTP Serverが含まれるOracleインスタンスをバックアップします。

リカバリに関する推奨事項

Oracle HTTP Serverが含まれるOracleインスタンスをリストアします。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4項および第18.3.4.7.1項を参照してください。

16.5.6.2 Oracle Web Cacheのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Web Cacheのデータについて説明します。

構成ファイル

ORACLE_INSTANCE/config/WebCache/component_name
ORACLE_INSTANCE/diagnostics/logs/WebCache/component_name

データベース・リポジトリに依存するもの

なし

バックアップに関する推奨事項

Oracle Web Cacheが含まれるOracleインスタンスをバックアップします。

リカバリに関する推奨事項

Oracle Web Cacheが含まれるOracleインスタンスをリストアします。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4項および第18.3.4.7.2項を参照してください。

16.5.7 Oracle Portal、Oracle Forms Services、Oracle Reports、Oracle BI Discovererの各インストールのバックアップおよびリカバリに関する推奨事項

次の各項では、これらのコンポーネントのバックアップおよびリカバリに関する推奨事項について説明します。

- Oracle Portalのバックアップおよびリカバリに関する推奨事項

- Oracle Forms Servicesのバックアップおよびリカバリに関する推奨事項

- Oracle Reportsのバックアップおよびリカバリに関する推奨事項

- Oracle Business Intelligence Discovererのバックアップおよびリカバリに関する推奨事項

16.5.7.1 Oracle Portalのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Portalのデータについて説明します。

構成ファイル

DOMAIN_HOME/config/fmwconfig/servers/WLS_PORTAL/applications/portal/configuration/appConfig.xml
DOMAIN_HOME/config/fmwconfig/servers/WLS_PORTAL/applications/portal/configuration/portal_dads.conf
DOMAIN_HOME/config/fmwconfig/servers/WLS_PORTAL/applications/portal/configuration/portal_plsql.conf
DOMAIN_HOME/config/fmwconfig/servers/WLS_PORTAL/applications/portal/configuration/portal_cache.conf

データベース・リポジトリに依存するもの

PORTAL、PORTAL_DEMO、PORTAL_APP、PORTAL_PUBLIC、PORTAL_APPROVALの各スキーマ

バックアップに関する推奨事項

管理サーバーのドメイン、管理対象サーバーのディレクトリ、Oracle Portalが含まれるOracleインスタンスおよび前述のスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

WebLogic Serverドメイン、およびOracle Portalが含まれるOracleインスタンスをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4項および第18.3.4.8.1項を参照してください。

16.5.7.2 Oracle Forms Servicesのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Forms Servicesのデータについて説明します。

構成ファイル

Formsのコンポーネント:

ORACLE_INSTANCE/config/FormsComponent/forms
ORACLE_INSTANCE/Forms/forms

Formsの共通コンポーネント:

ORACLE_INSTANCE/config/FRComponent/frcommon
ORACLE_INSTANCE/Forms/frcommon

Forms EEアプリケーションおよびその構成ファイル:

DOMAIN_HOME/forms_managed_server/tmp/_WL_user/formsapp_version
DOMAIN_HOME/config/fmwconfig/servers/forms_managed_server/applications/formsapp_version/config

データベース・リポジトリに依存するもの

Oracle Forms Servicesアプリケーション用にユーザーが構成したデータベース。

バックアップに関する推奨事項

管理サーバーのドメイン、管理対象サーバーのディレクトリ、およびOracle Forms Servicesが存在するOracleインスタンス・ホームをバックアップします。

リカバリに関する推奨事項

Oracle Forms Servicesが配置されているOracleインスタンス・ホームをリストアします。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4項および第18.3.4.8.2項を参照してください。

16.5.7.3 Oracle Reportsのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Reportsのデータについて説明します。

構成ファイル

Reports Serverの場合:

ORACLE_INSTANCE/config/ReportsServerComponent/server_name/rwserver.conf
ORACLE_INSTANCE/config/ReportsServerComponent/server_name/jdbcpds.conf
ORACLE_INSTANCE/config/ReportsServerComponent/server_name/xmlpds.conf
ORACLE_INSTANCE/config/ReportsServerComponent/server_name/textpds.conf
ORACLE_INSTANCE/config/ReportsServerComponent/server_name/rwnetwork.conf
ORACLE_INSTANCE/config/ReportsServerComponent/server_name/pcscomponent.conf
ORACLE_INSTANCE/config/ReportsServerComponent/server_name/component-logs.xml
ORACLE_INSTANCE/config/ReportsServerComponent/server_name/logging.xml

Oracle Reportsサーブレットの場合:

次のパスで、server_nameは通常、WLS_REPORTSまたはWLS_REPORTSnで、versionはソフトウェアのバージョン(例、11.1.1.4.0)です。

DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/cgicmd.dat
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/rwservlet.properties
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/rwserver.conf
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/jdbcpds.conf
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/xmlpds.conf
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/textpds.conf
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/rwnetwork.conf
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/logging.xml
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/logmetadata.xml

Oracle Reports Bridgeの場合:

ORACLE_INSTANCE/config/ReportsBridge/bridge_name/rwbridge.conf
ORACLE_INSTANCE/config/ReportsBridge/bridge_name/rwnetwork.conf
ORACLE_INSTANCE/config/ReportsBridge/bridge_name/component-logs.xml
ORACLE_INSTANCE/config/ReportsBridge/bridge_name/logging.xml
ORACLE_INSTANCE/config/ReportsBridge/bridge_name/pcscomponent.xml

Oracle Reportsツールの場合:

ORACLE_INSTANCE/config/ReportsToolsComponent/rwbuilder.conf
ORACLE_INSTANCE/config/ReportsToolsComponent/rwnetwork.conf
ORACLE_INSTANCE/config/ReportsToolsComponent/jdbcpds.conf
ORACLE_INSTANCE/config/ReportsToolsComponent/xmlpds.conf
ORACLE_INSTANCE/config/ReportsToolsComponent/textpds.conf
ORACLE_INSTANCE/config/ReportsToolsComponent/pcscomponent.xml
ORACLE_INSTANCE/config/ReportsToolsComponent/rwservlet.properties
ORACLE_INSTANCE/config/ReportsToolsComponent/cgicmd.dat
ORACLE_INSTANCE/config/ReportsToolsComponent/component-logs.xml
ORACLE_INSTANCE/config/ReportsToolsComponent/logging.xml

その他のディレクトリおよびファイル:

ORACLE_INSTANCE/reports/server/*.dat
ORACLE_INSTANCE/reports/cache/
ORACLE_INSTANCE/reports/fonts/
ORACLE_INSTANCE/reports/plugins/resource
ORACLE_INSTANCE/diagnostics/logs/reports/ReportsServer
ORACLE_INSTANCE/diagnostics/logs/reports/ReportsBridge
ORACLE_INSTANCE/diagnostics/logs/reports/ReportsTools
(UNIX) ORACLE_INSTANCE/config/reports/bin/rw*.sh
(Windows) ORACLE_INSTANCE\config\reports\bin\rw*.bat
(UNIX) ORACLE_INSTANCE/config/reports/bin/reports.sh
(Windows) ORACLE_INSTANCE\config\reports\bin\reports.bat
(UNIX) ORACLE_INSTANCE/config/reports/bin/namingservice.sh
(Windows) ORACLE_INSTANCE\config\reports\bin\namingservice.bat

データベース・リポジトリに依存するもの

Oracle Reportsは、スケジュール済ジョブのデータ、過去のジョブのデータ、ジョブ・ステータスのデータなど、ジョブ関連情報をデータベースに格納するように構成できます。

バックアップに関する推奨事項

管理サーバーのドメイン、管理対象サーバーのディレクトリ、およびOracle Reportsが存在するOracleインスタンス・ホームをバックアップします。

データベースがOracle Reports用に構成されている場合は、データベースをバックアップします。

リカバリに関する推奨事項

Oracle Reportsが配置されているOracleインスタンス・ホームをリストアします。

データベースがOracle Reports用に構成されている場合は、必要に応じて、データベースを直近の時点にリカバリします。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4項および第18.3.4.8.3項を参照してください。

16.5.7.4 Oracle Business Intelligence Discovererのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Business Intelligence Discovererのデータについて説明します。

構成ファイル

ORACLE_INSTANCE/config/PreferenceServer/disco-comp-name/pref.txt
ORACLE_INSTANCE/config/PreferenceServer/disco-comp-name/.reg_key.dc
DOMAIN_HOME/config/fmwconfig/servers/WLS_DISCO/applications/discoverer_version/configuration/configuration.xml
DOMAIN_HOME/config/config.xml
DOMAIN_HOME/config/fmwconfig/servers/server_name/logging.xml

ログ・ファイル

ORACLE_INSTANCE/diagnostics/logs/PreferenceServer/Discoverer_instance_name/console*
ORACLE_INSTANCE/diagnostics/logs/PreferenceServer/Discoverer_instance_name/log*
DOMAIN_HOME/servers/server_name/logs/discoverer/diagnostic-*.xml
DOMAIN_HOME/servers/server_name/logs/discoverer/diagnostics*.xml
DOMAIN_HOME/servers/server_name/logs/WLS_DISCO-diagnostic-*.xml

データベース・リポジトリに依存するもの

DISCOVERERスキーマおよびDISCOVERER_PSスキーマ

バックアップに関する推奨事項

管理サーバーのドメイン、管理対象サーバーのディレクトリ、およびOracle BI DiscovererのOracleインスタンス・ホームをバックアップします。

DISCOVERERおよびDISCOVERER_PSスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

Oracle BI Discovererが含まれるOracleインスタンスをリストアします。

必要に応じて、データベースを直近の時点にリカバリします。

コンポーネントのリカバリ手順は、第18.2.7項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4項および第18.3.4.8.4項を参照してください。

16.5.8 Oracle Business Intelligenceのバックアップおよびリカバリに関する推奨事項

次の各項では、Oracle Business Intelligenceのバックアップおよびリカバリに関する推奨事項について説明します。

- Oracle BI Enterprise Editionのバックアップおよびリカバリに関する推奨事項

- Oracle Business Intelligence Publisherのバックアップおよびリカバリに関する推奨事項

- Oracle Real-Time Decisionsのバックアップおよびリカバリに関する推奨事項

16.5.8.1 Oracle BI Enterprise Editionのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle BI EEのデータについて説明します。

構成ファイル

ORACLE_INSTANCE/bifoundation/OracleBIApplication
ORACLE_INSTANCE/bifoundation/OracleBIClusterControllerComponent
ORACLE_INSTANCE/bifoundation/OracleBIJavaHostComponent
ORACLE_INSTANCE/bifoundation/OracleBIPresentationServicesComponent
ORACLE_INSTANCE/bifoundation/OracleBISchedulerComponent
ORACLE_INSTANCE/bifoundation/OracleBIServerComponent
ORACLE_INSTANCE/bifoundation/OracleBIODBCComponent
ORACLE_INSTANCE/config/OracleBIApplication
ORACLE_INSTANCE/config/OracleBIClusterControllerComponent
ORACLE_INSTANCE/config/OracleBIJavaHostComponent
ORACLE_INSTANCE/config/OracleBIPresentationServicesComponent
ORACLE_INSTANCE/config/OracleBISchedulerComponent
ORACLE_INSTANCE/config/OracleBIServerComponent
ORACLE_INSTANCE/config/OracleBIODBCComponent
ORACLE_INSTANCE/diagnostics/logs/OracleBIApplication
ORACLE_INSTANCE/diagnostics/logs/OracleBIClusterControllerComponent
ORACLE_INSTANCE/diagnostics/logs/OracleBIJavaHostComponent
ORACLE_INSTANCE/diagnostics/logs/OracleBIPresentationServicesComponent
ORACLE_INSTANCE/diagnostics/logs/OracleBISchedulerComponent
ORACLE_INSTANCE/diagnostics/logs/OracleBIServerComponent
ORACLE_INSTANCE/diagnostics/logs/OracleBIODBCComponent

加えて、ファイルベースのリポジトリ内の次のファイル:

ORACLE_INSTANCE/bifoundation/OracleBIServerComponent/comp_instance name/repository/*.rpd
ORACLE_INSTANCE/bifoundation/OracleBIPresentationServicesComponent/comp_instance name/catalog/catalog-name

NQSConfig.INI構成ファイルは、RPD名を指します。NQSConfig.INIファイルは、次の場所に存在する必要があります。

ORACLE_INSTANCE/bifoundation/OracleBIServerComponent/comp_instance name/repository/

データベース・リポジトリに依存するもの

MDSスキーマおよびBIPLATFORMスキーマ

バックアップに関する推奨事項

Middlewareホーム、ドメイン・ホーム、およびOracle BI EEコンポーネントが含まれるOracleインスタンスをバックアップします。Windowsでは、第17.3.3項の説明に従って、Oracle BI EEのレジストリ・エントリをエクスポートします。

Oracle BI EEのスキーマが含まれるデータベースをバックアップします。

注意:

バックアップを実行する前に、Oracle BI Presentation Catalogをロックして、カタログとRPDの同期が確保されるようにする必要があります。次のスクリプトを実行します。

ORACLE_INSTANCE/bifoundation/OracleBIPresentationServicesComponent/coreapplication_obips1/catalogmanager/runcat.sh

次のコマンドを使用します。

./runcat.sh -cmd maintenanceMode -on -online OBIPS_URL
-credentials credentials_properties_file

バックアップが完了したら、runcatコマンドを使用してメンテナンス・モードをオフにします。このコマンドの詳細は、次のようにヘルプを参照してください。

./runcat.sh -cmd maintenanceMode -help

リカバリに関する推奨事項

障害の程度に応じて、Middlewareホーム、ドメイン、およびOracle BI EEコンポーネントが含まれるOracleインスタンスをリカバリします。Windowsでは、Oracle BI EEのレジストリ・エントリをインポートします。

必要に応じて、データベースを直近の時点にリカバリします。

Oracle BI EEのリカバリ手順は、第18.2.7.10項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.9項を参照してください。

16.5.8.2 Oracle Business Intelligence Publisherのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Business Intelligence Publisher(Oracle BI Publisher)のデータについて説明します。

構成ファイル

構成ファイルは、Middlewareホーム、ドメイン・ホームおよびOracle Business Intelligence Publisherリポジトリに格納されています。

データベース・リポジトリに依存するもの

BIPLATFORMスキーマ

バックアップに関する推奨事項

Middlewareホーム、ドメイン、およびBI Publisherリポジトリをバックアップします。

BI Publisherリポジトリは、ファイルベースの場合もデータベース・ベースの場合もあります。

リカバリに関する推奨事項

Oracle BI Publisherコンポーネントが含まれる管理対象サーバーをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

Oracle BI Publisherのリカバリ手順は、第18.2.7.11項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.10項を参照してください。

16.5.8.3 Oracle Real-Time Decisionsのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Real-Time Decisionsのデータについて説明します。

構成ファイル

構成ファイルは、Middlewareホームおよびドメイン・ホームに格納されています。

データベース・リポジトリに依存するもの

分析モデルおよびRTDスキーマが含まれるデータベース

バックアップに関する推奨事項

Middlewareホーム、ドメイン・ホーム、および分析モデルが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

Oracle Real-Time Decisionsコンポーネントが含まれる管理対象サーバーをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

Oracle Real-Time Decisionsのリカバリ手順は、第18.2.7.12項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.11項を参照してください。

16.5.9 Oracle Hyperion Enterprise Performance Management Systemのバックアップおよびリカバリに関する推奨事項

次の各項では、Oracle Hyperion Enterprise Performance Management Systemのバックアップおよびリカバリに関する推奨事項について説明します。

- Oracle Essbaseのバックアップおよびリカバリに関する推奨事項

- Oracle Hyperion Calculation Managerのバックアップおよびリカバリに関する推奨事項

- Oracle Hyperion Financial Reportingのバックアップおよびリカバリに関する推奨事項

- Oracle Hyperion Smart Viewのバックアップおよびリカバリに関する推奨事項

16.5.9.1 Oracle Essbaseのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Essbaseのデータについて説明します。

構成ファイル

構成ファイルは次の場所にあります。

ORACLE_HOME
HYPERION_HOME
ESSBASEPATH
ARBORPATH
ARBORPATH/bin/essbase.sec

Oracle Fusion Middlewareコンポーネントに依存するもの

Oracle Internet Directory、Oracle Fusion Middleware Extensions for Applicationsおよび資格証明ストア

サード・パーティ製品に依存するもの

なし

データベース・リポジトリに依存するもの

Oracle Essbaseスキーマ

バックアップに関する推奨事項

ストレージのスナップショット技術を使用して一貫性のあるオンライン・バックアップを取ることで、Oracle Essbaseをバックアップします。または、ファイル・システムのコピーを使用してオフライン・バックアップを実行することもできます。

リカバリに関する推奨事項

次のファイルをリカバリします。

ARBORPATH/app/appname/*.otl
ARBORPATH/app/appname/*.csc
ARBORPATH/app/appname/*.rul
ARBORPATH/app/appname/*.eqd
ARBORPATH/app/appname/*.sel
ARBORPATH/bin/essbase.sec

必要に応じて、データベースを直近の時点にリカバリします。

障害の度合いに応じて、必要な粒度でリカバリを実行する必要があります。Oracle Essbaseのリカバリ手順は、第18.2.7.13項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.12項を参照してください。

16.5.9.2 Oracle Hyperion Calculation Managerのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Hyperion Calculation Managerのデータについて説明します。

構成ファイル

構成ファイルは、データベースに格納されています。

Oracle Fusion Middlewareコンポーネントに依存するもの

なし

サード・パーティ製品に依存するもの

なし

データベース・リポジトリに依存するもの

アーティファクトは、データベースに格納されています。

バックアップに関する推奨事項

Oracle Hyperion Calculation Managerがデプロイされている管理対象サーバーをバックアップします。Oracle Hyperion Calculation Managerエクスポート・ツールを使用してデータベース内のアーティファクトをバックアップします(Calculation Managerで、「ファイル」→「エクスポート」を選択します)。

リカバリに関する推奨事項

Oracle Hyperion Calculation Managerがデプロイされている管理対象サーバーをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。Oracle Hyperion Calculation Managerインポート・ツールを使用してアーティファクトをインポートします。

障害の度合いに応じて、必要な粒度でリカバリを実行する必要があります。Oracle Hyperion Calculation Managerのリカバリ手順は、第18.2.7.14項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.13項を参照してください。

16.5.9.3 Oracle Hyperion Financial Reportingのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Hyperion Financial Reportingのデータについて説明します。

構成ファイル

ORACLE_HOME/Oracle_BI1/common (HIT common files)
ORACLE_HOME/Oracle_BI1/products/biplus
ORACLE_INSTANCE/products/biplus

他のOracle Fusion Middlewareコンポーネントに依存するもの

Oracle JRF、Oracle Enterprise Scheduler(ESS)およびOracle Platform Security Services

サード・パーティ製品に依存するもの

なし

データベース・リポジトリに依存するもの

データベースに格納されているHyperion RegistryのEPMスキーマ

バックアップに関する推奨事項

OracleホームとOracleインスタンスをバックアップします。

EPMスキーマが含まれるデータベースをバックアップします。

Oracle BI EEのリポジトリとアノテーション・データベース(jndi:raframework_database)の同期を維持する必要があります。両方とも同じ時点からバックアップします。

リカバリに関する推奨事項

OracleホームとOracleインスタンスをリカバリします。

必要に応じて、データベースを直近の時点にリカバリします。

Oracle BI EEのリポジトリとアノテーション・データベース(jndi:raframework_database)の同期を維持する必要があります。この2つを同じ時点からリカバリします。

障害の度合いに応じて、必要な粒度でリカバリを実行する必要があります。Oracle Hyperion Financial Reportingのリカバリ手順は、第18.2.7.15項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.14項を参照してください。

16.5.9.4 Oracle Hyperion Smart Viewのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Hyperion Smart Viewのデータについて説明します。

構成ファイル

構成ファイルは、ユーザーが指定したOracle Hyperion Smart Viewのインストール場所にあります。Oracleホームやこの場所にインストールされているコンポーネントへの依存性はありません。

Oracle Fusion Middlewareコンポーネントに依存するもの

なし

サード・パーティ製品に依存するもの

なし

データベース・リポジトリに依存するもの

なし

バックアップに関する推奨事項

Oracle Hyperion Smart Viewのデータをバックアップします。これらのデータは、次のタイプのファイルに格納されています。ファイルの場所は、Oracle Hyperion Smart Viewのインストール時に決まります。

- Microsoft Excelファイル(XLSおよびXLSX)

- Microsoft Wordファイル(DOCおよびDOCX)

- Microsoft Powerpointファイル(PPTおよびPPTX)

リカバリに関する推奨事項

Oracle Hyperion Smart Viewのデータをリカバリします。

障害の度合いに応じて、必要な粒度でリカバリを実行する必要があります。Oracle Hyperion Smart Viewのリカバリ手順は、第18.2.7.16項を参照してください。

16.5.10 Oracle Data Integratorのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Data Integrator(ODI)のデータについて説明します。

構成ファイル

ODI_Oracle_Home/oracledi/agent/web.xml

データベース・リポジトリに依存するもの

ODI_REPOスキーマ

バックアップに関する推奨事項

ドメイン、Oracleホーム、およびスタンドアロン・エージェントがインストールされている各マシンのODI_Oracle_Home/oracledi/agentフォルダをバックアップします。

Oracle Data Integratorスキーマを含むデータベースをバックアップします。

リカバリに関する推奨事項

障害の程度に応じて、ドメインとOracleホームのいずれかまたは両方をリストアします。

必要に応じて、データベースを直近の時点にリカバリします。

Oracle Data Integratorのリカバリ手順は、第18.2.7.17項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.5項を参照してください。

16.5.11 Oracle WebCenter Contentのバックアップおよびリカバリに関する推奨事項

次の各項では、Oracle WebCenter Contentのバックアップおよびリカバリに関する推奨事項について説明します。

- Oracle Information Rights Managementのバックアップおよびリカバリに関する推奨事項

- Oracle WebCenter Content: Imagingのバックアップおよびリカバリに関する推奨事項

- Oracle WebCenter Contentのバックアップおよびリカバリに関する推奨事項

- Oracle WebCenter Content: Recordsのバックアップおよびリカバリに関する推奨事項

16.5.11.1 Oracle Information Rights Managementのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle Information Rights Managementのデータについて説明します。

構成ファイル

構成ファイルは、ドメイン・ホームに格納されています。

データベース・リポジトリに依存するもの

ORAIRMスキーマ(DB2およびSQL Serverのデータベースの場合はIRM。名前がIRMであることを確認する必要があります)

バックアップに関する推奨事項

ドメイン、Oracleホーム、およびORAIRMスキーマが含まれるデータベースをバックアップします。また、LDAPディレクトリおよびキーストアもバックアップします。キーストアの名前は通常、irm.jksまたはirm.jceksです。

データベースとキーストアの同期を維持する必要があります。両方とも同じ時点からバックアップします。

リカバリに関する推奨事項

障害の重大度に応じて、ドメイン、Oracleホームおよび共有ファイル・システムをリストアします。

必要に応じて、ORAIRMスキーマが含まれるデータベースを直近の時点にリカバリします。

データベースとキーストアの同期を維持する必要があります。一方をリストアしたら、もう一方も同じ時点にリストアします。

Oracle Information Rights Managementのリカバリ手順は、第18.2.7.18項を参照してください。ホストの破損からのリカバリにも、同じ手順を使用します。

16.5.11.2 Oracle WebCenter Content: Imagingのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle WebCenter Content: Imagingのデータについて説明します。

構成ファイル

構成ファイルは、ドメイン・ホームに格納されています。

データベース・リポジトリに依存するもの

IPMスキーマおよびOCSスキーマ

バックアップに関する推奨事項

ドメイン、Oracleホーム、およびスキーマが含まれるデータベースをバックアップします。

リカバリに関する推奨事項

障害の重大度に応じて、ドメインおよびOracleホームをリストアします。

必要に応じて、前述のスキーマが含まれるデータベースを直近の時点にリカバリします。

Oracle WebCenter Content: Imagingのリカバリ手順は、第18.2.7.19項を参照してください。ホストの破損からのリカバリにも、同じ手順を使用します。

16.5.11.3 Oracle WebCenter Contentのバックアップおよびリカバリに関する推奨事項

この項では、バックアップおよびリストアが必要なOracle WebCenter Contentのデータについて説明します。

構成ファイル

DOMAIN_HOME/ucm/CONTEXT-ROOT/bin/intradoc.cfg
DOMAIN_HOME/ucm/CONTEXT-ROOT/config/config.cfg

データベース・リポジトリに依存するもの

OCSスキーマ

バックアップに関する推奨事項

ドメイン、Oracleホーム、およびOCSスキーマが含まれるデータベースをバックアップします。ドメイン・ディレクトリにVaultディレクトリもWebLayoutディレクトリも配置されていない場合は、次のファイルで指定されているそれらのディレクトリをバックアップします。

DOMAIN_HOME/ucm/CONTEXT-ROOT/config/config.cfg

次のディレクトリもバックアップします。これは、共有ファイル・システムに配置されています。

DOMAIN_HOME/ucm/CONTEXT-ROOT/config

リカバリに関する推奨事項

障害の重大度に応じて、ドメインと、VaultディレクトリおよびWebLayoutディレクトリが含まれる共有ファイル・システムをリストアします。

必要に応じて、OCSスキーマが含まれるデータベースを直近の時点にリカバリします。

Oracle WebCenter Contentのリカバリ手順は、第18.2.7.20項を参照してください。ホストの破損からのリカバリに固有の手順は、第18.3.4.16.1項を参照してください。

16.5.11.4 Oracle WebCenter Content: Recordsのバックアップおよびリカバリに関する推奨事項

Oracle WebCenter Content: Recordsは、Oracle WebCenter Contentに依存しており、追加でバックアップまたはリカバリするアーティファクトがないため、Oracle WebCenter Contentのバックアップおよびリカバリに関する推奨事項(第16.5.11.3項)を参照してください。

16.6 前提と制限

次の前提と制限は、このマニュアルに記載されているバックアップおよびリカバリ手順に適用されます。第17.2項に一覧表示されている制限も参照してください。

- バックアップおよびリカバリの操作は、製品をインストールするユーザーまたはOracle Fusion Middlewareがインストールされているディレクトリへのアクセス権限を持つユーザーのみが実行可能である必要があります。

- 1つの管理対象サーバーと管理サーバーが別々のホスト上で実行されていて、その管理対象サーバーがクラスタに属していない場合、管理対象サーバーでpackコマンドおよびunpackコマンドを使用して、適切な構成を取得する必要があります。

関連項目:

Cold Failover ClusterまたはDisaster Recoveryを使用している場合、詳細は『Oracle Fusion Middleware高可用性ガイド』を参照してください。

17 環境のバックアップ

この章では、Oracle Fusion Middlewareの推奨されるバックアップ計画およびその手順について説明します。

この章の項目は次のとおりです。

- 環境のバックアップの概要

- データのバックアップに関する制限事項

- バックアップの実行

- Oracle Fusion Middleware構成の記録の作成

17.1 環境のバックアップの概要

第16.3.3項で説明するように、Oracle Fusion Middleware環境のバックアップでは次の推奨される計画を使用する必要があります。

- オンライン・バックアップを実行する場合、バックアップが完了するまでは、いずれの構成も変更しないでください。WebLogic Serverドメインで変更が行われないようにするには、第3.4.2項で説明しているようにWebLogic Serverの構成をロックします。

- Oracle Fusion Middlewareをインストールしたらすぐに、全体オフライン・バックアップを行います。全体バックアップの実行の詳細は、第17.3.1項を参照してください。

- 管理上の変更を行った後、および定期的に、ランタイム・アーティファクトのバックアップを実行します。ランタイム・アーティファクトのバックアップは夜間に行うことをお薦めします。ランタイム・アーティファクトのバックアップの実行の詳細は、第17.3.2項を参照してください。

- アップグレードやパッチの適用、次のいずれかのファイルの変更など、大きな変更を行った後には、新たな全体バックアップを実行します。

MW_HOME/wlserver_n/common/nodemanager/nodemanager.properties
MW_HOME/wlserver_n/common/bin/wlsifconfig.sh
MW_HOME/wlserver_n/common/bin/setPatchEnv.sh
MW_HOME/wlserver_n/common/bin/commEnv.sh

全体バックアップの実行の詳細は、第17.3.1項を参照してください。

- Oracle Fusion Middleware環境の記録を作成します。第17.4項を参照してください。

- バックアップを作成したら、そのアーカイブ・ファイルに一意の名前を付けます。名前に日時を付加することを検討してください。たとえば、Middlewareホームのバックアップを2012年4月20日に作成した場合は、そのバックアップに次の名前を付けます。

mw_home_backup_042012.tar

図17-1のフロー・チャートは、特定の状況に適したバックアップのタイプを判断する方法の概要を示しています。

図17-1 バックアップのタイプを判断するためのフロー・チャート

「図17-1 バックアップのタイプを判断するためのフロー・チャート」の説明

17.2 データのバックアップに関する制限事項

次の点に注意してください。

- LDAPバックアップ: 組込みのLDAPを使用する場合、LDAPデータのバックアップ中にセキュリティ・プロバイダの構成を更新しないでください。ldapディレクトリ・ツリーのバックアップ中に変更があると(たとえば、管理者がユーザーを追加するなど)、ldapfilesサブディレクトリのバックアップは一貫性が損なわれる場合があります。LDAPのバックアップ手順の詳細は、「WebLogic Server管理サーバーの起動と停止」を参照してください。

- Java Transaction API (JTA): JTAトランザクション・ログのバックアップおよびリストアはお薦めしません。

- Audit Framework: Oracle Fusion Middleware Audit Frameworkを、データベースにデータを書き込むように構成している場合は、バス・ストップ内のローカル・ファイルはバックアップしないでください(各コンポーネントから発生する監査対象イベントは、バス・ストップと呼ばれるリポジトリに格納されます。Oracle WebLogic Serverには、それぞれ独自のバス・ストップがあります。データはこのファイル内に永続的に置くか集中リポジトリにアップロードでき、集中リポジトリからは、レコードを表示したりレポート作成に使用したりできます)。
ローカル・ファイルをバックアップする場合、重複レコードがデータベースにアップロードされます。つまり、バス・ストップの作成時にデータベースにアップロードされ、その後ファイルをリストアしたときに再度アップロードされます。

バス・ストップのローカル・ファイルのデフォルトの場所は次のとおりです。

- Javaコンポーネントの場合:

DOMAIN_HOME/servers/server_name/logs/auditlogs/component_type

- システム・コンポーネントの場合(Oracle HTTP ServerやOracle Internet Directoryなど):

ORACLE_INSTANCE/auditlogs/component_type/component_name

Oracle Fusion Middleware監査フレームワークおよびバス・ストップの詳細は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』の監査の構成と管理に関する項を参照してください。

17.3 バックアップの実行

次の各項の説明に従って、全体オフライン・バックアップまたはランタイム・アーティファクトのオンラインまたはオフライン・バックアップを実行できます。

- 全体オフライン・バックアップの実行

- ランタイム・アーティファクトのオンライン・バックアップの実行

- Windowsレジストリ・エントリのバックアップ

17.3.1 全体オフライン・バックアップの実行

全体オフライン・バックアップを行うには、Oracle Fusion Middlewareのファイルが含まれているディレクトリをコピーします。

第16.3項の説明に従って、アーカイブ用のツールを使用して、ソースMiddlewareホームをアーカイブおよび圧縮します。

次の手順を実行します。

1. Middlewareホームのプロセスをすべて停止します。たとえば、管理対象サーバー、管理サーバー、およびMiddlewareホームで実行されているOracleインスタンスを停止します。

2. すべてのホスト上のMiddlewareホーム(MW_HOME)をバックアップします。次に例を示します。

(UNIX) tar -cf mw_home_backup_042012.tar MW_HOME/*
(Windows) jar cf mw_home_backup_042012.jar MW_HOME\*

3. ドメインがMiddlewareホーム内に見つからない場合は、管理サーバーのドメインを個別にバックアップします。これによって、Oracle SOA SuiteやOracle WebCenter PortalなどのJavaコンポーネントがバックアップされます。
次に例を示します。

(UNIX) tar -cf domain_home_backup_042012.tar DOMAIN_HOME/*
(Windows) jar cf domain_home_backup_042012.jar DOMAIN_HOME\*

ほとんどの場合、管理対象サーバーのディレクトリを個別にバックアップする必要はありません。管理サーバーのドメインには管理対象サーバーに関する情報が格納されているためです。管理対象サーバーの環境をカスタマイズしている場合は、管理対象サーバーのディレクトリをバックアップします。バックアップが必要なものの詳細は、第16.5項を参照してください。

4. Oracleインスタンス・ホームがMiddlewareホーム内に見つからない場合は、Oracleインスタンス・ホームをバックアップします。Oracleインスタンス・ホームには、Oracle HTTP ServerやOracle Internet Directoryなどのシステム・コンポーネントに関する構成情報が含まれています(システム・コンポーネントの一覧は、第3.5.2項を参照)。
次に例を示します。

(UNIX) tar -cf sc_home_backup_042012.tar ORACLE_INSTANCE/*
(Windows) jar cf sc_home_backup_042012.jar ORACLE_INSTANCE\*

5. 管理対象サーバーがドメイン内に見つからない場合は、管理対象サーバーのディレクトリをバックアップします。次に例を示します。

(UNIX) tar -cf mg1_home_backup_042012.tar server_name/*
(Windows) jar cf mgl_home_backup_042012.jar server_name\*

6. OraInventoryディレクトリをバックアップします。次に例を示します。

tar -cf Inven_home_backup_042012.tar /scratch/oracle/OraInventory

7. LinuxおよびUNIXの場合は、oraInst.locファイルをバックアップします。これは、次のディレクトリにあります。

(Linux and IBM AIX) /etc
(Other UNIX systems) /var/opt/oracle

8. LinuxおよびUNIXの場合は、oratabファイルをバックアップします。これは、次のディレクトリにあります。

/etc

9. Oracle Recovery Manager(RMAN)を使用して、データベース・リポジトリをバックアップします。詳細な手順は、『Oracle Databaseバックアップおよびリカバリ・ユーザーズ・ガイド』を参照してください。

10. Windowsの場合は、第17.3.3項の説明に従って、Windowsレジストリ・エントリをエクスポートする必要があります。

11. 「構成の解放」をWebLogic Server管理コンソールでクリックして、WebLogic Server構成のロックを解除します。

12. Oracle Fusion Middleware環境の記録を作成します。第17.4項を参照してください。

17.3.2 ランタイム・アーティファクトのオンライン・バックアップの実行

ランタイム・アーティファクト(第16.3.2項を参照)のバックアップは、定期的に、また第16.3.3項で説明している時点で実行する必要があります。

ランタイム・アーティファクトをバックアップする手順は次のとおりです。

1. バックアップの矛盾を防ぐために、バックアップが完了するまでは、いずれの構成も変更しないでください。WebLogic Serverドメインで変更が行われないようにするには、第3.4.2項で説明しているようにWebLogic Serverの構成をロックします。

2. 管理サーバーのドメイン・ディレクトリをバックアップします。これによって、Oracle SOA SuiteやOracle WebCenter PortalなどのJavaコンポーネントがバックアップされます。次に例を示します。

(UNIX) tar -cf domain_home_backup_042012.tar DOMAIN_HOME/*
(Windows) jar cf domain_home_backup_042012.jar DOMAIN_HOME\*

Oracle Portal、Oracle Reports、Oracle Forms ServicesおよびOracle Business Intelligence Discovererの場合は、管理サーバーのドメイン・ディレクトリ以外にも、管理対象サーバーのディレクトリをバックアップする必要があります。

3. Oracleインスタンス・ホームをバックアップします。これによって、Oracle HTTP Serverなどのシステム・コンポーネントがバックアップされます。次に例を示します。

(UNIX) tar -cf sc_home_backup_042012.tar ORACLE_INSTANCE/*
(Windows) jar cf sc_home_backup_042012.jar ORACLE_INSTANCE\*

4. Oracle Recovery Manager(RMAN)を使用して、データベース・リポジトリをバックアップします。詳細な手順は、『Oracle Databaseバックアップおよびリカバリ・ユーザーズ・ガイド』を参照してください。

5. 「構成の解放」をWebLogic Server管理コンソールでクリックして、Oracle WebLogic Server構成のロックを解除します。

6. Oracle Fusion Middleware環境の記録を作成します。第17.4項を参照してください。

17.3.3 Windowsレジストリ・エントリのバックアップ

Windowsの場合、Oracle Fusion Middlewareに関連するWindowsレジストリ・キーをバックアップする必要があります。バックアップするキーは、インストールされているコンポーネントによって異なります。

キーをエクスポートするには、次のコマンドを使用します。

regedit /E  FileName Key

次のエントリをエクスポートします。

- すべてのコンポーネント向けに、次のレジストリ・キーをエクスポートします。

HKEY_LOCAL_MACHINE\Software\Oracle

- Oracle Web Cacheなどのシステム・コンポーネント、およびOracle BI Enterprise Editionがインストールされている場合は、次のレジストリ・キー内のOracleで始まる各ノードをエクスポートします。

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services
HKEY_LOCAL_MACHINE\SYSTEM\ControlSet002\Services

次に例を示します。

regedit /E C:\oracleSMP.reg HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services\Oracleagent10gAgentSNMPPeerEncapsulator

各キーには一意のファイル名を使用します。

- Oracle BI EEがインストールされている場合は、次のレジストリ・キーをエクスポートします。

HKEY_LOCAL_MACHINE\SOFTWARE\ODBC

次に例を示します。

regedit /E C:\oracleregistry.reg HKEY_LOCAL_MACHINE\SOFTWARE\ODBC

キーのエクスポートにはレジストリ・エディタを使用することもできます。詳細は、レジストリ・エディタのヘルプを参照してください。

17.4 Oracle Fusion Middleware構成の記録の作成

Oracle Fusion Middleware環境のリストアおよびリカバリが必要な場合は、必要なすべての情報を入手し、対処することが重要です。これは、特にOracle Fusion Middleware環境全体(またはその一部)を新しいディスクまたはホストに再構成する必要があるような、ハードウェアの損失が発生した場合に当てはまります。

この項で説明されている情報を含む、Oracle Fusion Middleware環境の最新記録を維持管理する必要があります。この情報は、印刷物と電子形式の両方で保管してください。電子形式のデータは、Oracle Fusion Middleware環境とはまったく別のホストまたは電子メール・システム上に格納する必要があります。

Oracle Fusion Middlewareのハードウェアおよびソフトウェア構成の記録には、次のものが含まれます。

- 環境内のホストごとに次の情報が必要です。

- ホスト名

- 仮想ホスト名(存在する場合)

- ドメイン名

- IPアドレス

- ハードウェア・プラットフォーム

- オペレーティング・システムのリリース・レベルおよびパッチ情報

- 環境内のOracle Fusion Middlewareインストールごとに次の情報が必要です。

- インストールのタイプ(Oracle SOA Suiteなど)

- インストールが常駐するホスト

- Oracleホームを所有するオペレーティング・システム・ユーザーのユーザー名、ユーザーID番号、グループ名、グループID番号、環境プロファイルおよびシェル・タイプ(/etc/passwdおよび/etc/groupエントリ)

- ディレクトリ構造、マウント・ポイントと、Middlewareホーム、Oracle共通ホーム、Oracleホーム、Oracle WebLogic Serverドメイン・ホーム(Middlewareホームのuser_projectsディレクトリに配置されていない場合)およびOracleインスタンス・ホームのフルパス

- インストールで使用されるディスク領域の量

- インストールで使用されるポート番号

- コンポーネントのメタデータを格納しているデータベースに関して、次の情報が必要です。

- ホスト名

- データベースのバージョンとパッチ・レベル

- 基本言語

- キャラクタ・セット

- グローバル・データベース名

- SID

- リスニング・ポート

18 環境のリカバリ

この章では、Oracle Fusion Middlewareを様々なタイプの障害および停止(メディア障害またはホストの破損など)からリカバリするための推奨されるリカバリ計画および手順について説明します。

この章の項目は次のとおりです。

- 環境のリカバリの概要

- データの損失、破損、メディア障害またはアプリケーションの機能不全後のリカバリ

- ホストの破損後のリカバリ

18.1 環境のリカバリの概要

この項では、ホストまたはディスクが再起動できず、永久に失われるような、実データの損失や破損、ホスト障害またはメディア障害などが関係する停止に対するリカバリ計画の概要を示します。このタイプの障害では、Oracle Fusion Middleware環境を再起動し、通常の処理を続行する前に、ある種のデータ・リストアが必要です。

注意:

この章に記載されている手順では、最後のバックアップ以降、管理上の変更は加えられていないことを前提としています。最後のバックアップ以降、管理上の変更が加えられている場合は、リカバリの完了後にそれらの変更を再適用する必要があります。

ファイルのリストア時に圧縮ファイルを解凍するには、第16.4項の説明に従って、それに適したツールを使用します。

使用しているツールが、ファイルの権限とタイムスタンプを保持することを確認してください。

必要なファイルを間違って上書きしないよう、バックアップからファイルをリストアする前に既存のファイルおよびディレクトリの名前を変更してください。

18.2 データの損失、破損、メディア障害またはアプリケーションの機能不全後のリカバリ

この項では、ディスクをリストアできないような、実データの損失や破損、またはメディア障害などが関係する停止に対するリカバリ計画について説明します。適切に機能しなくなったアプリケーションに対するリカバリ計画についても説明します。このタイプの障害では、Oracle Fusion Middleware環境を再起動し、通常の処理を続行する前に、ある種のデータ・リストアが必要です。次の項目が含まれます。

- Middlewareホームのリカバリ

- Oracle WebLogic Serverドメインのリカバリ

- Oracleホームのリカバリ

- Oracleインスタンス・ホームのリカバリ

- 管理サーバーの構成のリカバリ

- 管理対象サーバーのリカバリ

- コンポーネントのリカバリ

- クラスタのリカバリ

- アプリケーションのリカバリ

- データベースのリカバリ

注意:

エンティティは、元のエンティティと同じパスにのみリストアできます。そのパスは、同じホスト上であっても、異なるホスト上であってもかまいません。

18.2.1 Middlewareホームのリカバリ

破損したりファイルが削除されたMiddlewareホームをリカバリできます。

Middlewareホームをリカバリする手順は次のとおりです。

1. 関連するすべてのプロセスを停止します。つまり、管理サーバー、ノード・マネージャ、管理対象サーバーなど、ドメインに関連するすべてのプロセスを停止します。たとえば、Linux上で管理サーバーを停止するには、次のように指定します。

DOMAIN_HOME/bin/stopWebLogic.sh username password [admin_url]

Oracle Fusion Middlewareプロセスの停止の詳細は、第4.1項を参照してください。

2. バックアップからMiddlewareホーム・ディレクトリをリカバリします。次に例を示します。

cd MW_HOME
(UNIX) tar -xf mw_home_backup_042012.tar
(Windows) jar xtf mw_home_backup_042012.jar

3. 関連するすべてのプロセスを起動します。つまり、Middlewareホームで実行するすべてのプロセスを起動します。たとえば、管理サーバーを起動します。

DOMAIN_HOME/bin/startWebLogic.sh -Dweblogic.management.username=username
-Dweblogic.management.password=password
-Dweblogic.system.StoreBootIdentity=true

Oracle Fusion Middlewareプロセスの起動の詳細は、第4.1項を参照してください。

18.2.2 Oracle WebLogic Serverドメインのリカバリ

ファイル・システムから削除されたり破損したOracle WebLogic Serverドメインをリカバリすることができます。

注意:

ドメイン・レベルのリカバリを実行すると、実行中のシステムに他の面で影響が出て、バックアップ後に行われた構成変更がすべて失われる場合があります。

ファイル・システムから削除されたり破損したOracle WebLogic Serverドメインをリカバリする手順は次のとおりです。

1. 関連するすべてのプロセスを停止します。つまり、管理サーバーや管理対象サーバーなど、ドメインに関連するすべてのプロセスを停止します。たとえば、管理サーバーを停止します。

DOMAIN_HOME/bin/stopWebLogic.sh username password [admin_url]

Oracle Fusion Middlewareプロセスの停止の詳細は、第4.1項を参照してください。

2. バックアップからドメイン・ディレクトリをリカバリします。

cd DOMAIN_HOME
(UNIX) tar -xf domain_backup_042012.tar
(Windows) jar xtf domain_backup_042012.jar

3. 関連するすべてのプロセスを起動します。つまり、このドメインに関連するすべてのプロセスを起動します。たとえば、管理サーバーを起動します。

DOMAIN_HOME/bin/startWebLogic.sh -Dweblogic.management.username=username
-Dweblogic.management.password=password
-Dweblogic.system.StoreBootIdentity=true

Oracle Fusion Middlewareプロセスの起動の詳細は、第4.1項を参照してください。

4. 管理サーバーを起動できない場合は、第18.2.5項の説明に従って、管理サーバーをリカバリします。

5. 管理対象サーバーを起動できない場合は、第18.2.6項の説明に従って、管理対象サーバーをリカバリします。

18.2.3 Oracleホームのリカバリ

特定のコンポーネントのOracleホームをリカバリする手順は次のとおりです。

1. バックアップ・ファイルからOracleホームを元のディレクトリにリカバリします。次に例を示します。

cd ORACLE_HOME
tar -xf Oracle_home_backup_042012.tar

2. WLSTのstartコマンドを使用して、アプリケーションのデプロイ先の管理対象サーバーを再起動します。次に例を示します。

connect('username', 'password', 'localhost:7001')
cd('servers/server_name')
start('server_name','Server')

18.2.4 Oracleインスタンス・ホームのリカバリ

Oracleインスタンス・ホームには、Oracle HTTP ServerやOracle Internet Directoryなどのシステム・コンポーネントに関する構成情報が含まれています(システム・コンポーネントの一覧は、第3.5.2項を参照)。次の各項目で、Oracleインスタンス・ホームをリカバリする方法について説明します。

- ファイル・システムからOracleインスタンス・ホームが削除された後のリカバリ

- Oracleインスタンス・ホームが登録解除された後のリカバリ

18.2.4.1 ファイル・システムからOracleインスタンス・ホームが削除された後のリカバリ

ファイル・システムから削除されたり破損したOracleインスタンス・ホームをリカバリする手順は次のとおりです。

1. 関連するすべてのプロセスを停止します。つまり、Oracleインスタンスに関連するすべてのプロセスを強制終了します。

2. バックアップ・ファイルからOracleインスタンス・ホーム・ディレクトリをリカバリします。次に例を示します。

cd ORACLE_INSTANCE
(UNIX) tar -xf Instance_home_backup_042012.tar
(Windows) jar xtf Instance_home_backup_042012.jar

3. 関連するすべてのプロセスを起動します。つまり、Oracleインスタンスに関連するすべてのプロセスを起動します。

opmnctl startall

18.2.4.2 Oracleインスタンス・ホームが登録解除された後のリカバリ

ドメインから登録解除されたOracleインスタンス・ホームをリカバリする手順は次のとおりです。

1. バックアップ・ファイルからOracleインスタンス・ホーム・ディレクトリをリカバリします。たとえばLinuxでは、次のように指定します。

cd ORACLE_INSTANCE
tar -xf Instance_home_backup_042012.tar

2. opmnctl registerinstanceコマンドを使用して、Oracleインスタンスをそのすべてのコンポーネントとともに、管理サーバーに登録します。次に例を示します。

opmnctl registerinstance -adminHost admin_server_host
-adminPort admin_server_port -adminUsername username
-adminPasswordFile 'file_with_weblogic_admin_password'
-oracleInstance ORACLE_INSTANCE_dir -oracleHome ORACLE_HOME_dir
-instanceName Instance_name -wlserverHome Middleware_Home

18.2.5 管理サーバー構成のリカバリ

ファイルの削除またはファイル・システムの破損が原因で、管理サーバーの構成が失われた場合でも、問題の発生時に管理サーバーのコンソールがすでに起動しているときには、このコンソールは引き続き機能します。管理サーバー・ディレクトリは、セキュリティ情報を除き、自動的に再生成されます。その結果、管理サーバーを起動するたびに、ユーザー名とパスワードの入力を求めるプロンプトが表示されます。これを避けるには、構成をリカバリします。

注意:

ドメイン・レベルのリカバリを実行すると、実行中のシステムに他の面で影響が出て、バックアップ後に行われた構成変更がすべて失われる場合があります。

管理サーバーの構成をリカバリする手順は次のとおりです。

1. 管理サーバー、管理対象サーバーおよびノード・マネージャが起動している場合はこれらも含めて、すべてのプロセスを停止します。たとえば、管理サーバーを停止するには、次のように指定します。

DOMAIN_HOME/bin/stopWebLogic.sh username password [admin_url]

Oracle Fusion Middlewareプロセスの停止の詳細は、第4.1項を参照してください。

2. ドメイン・ホームのバックアップを一時的な場所にリカバリすることで、管理サーバーの構成をリカバリします。次に、configディレクトリを次の場所にリストアします。

DOMAIN_HOME/config

3. 管理サーバーを起動します。次に例を示します。

DOMAIN_HOME/bin/startWebLogic.sh -Dweblogic.management.username=username
-Dweblogic.management.password=password
-Dweblogic.system.StoreBootIdentity=true

4. 管理サーバーが正常に起動しており、アクセス可能であることを確認します。

構成が次回変更されるときに、管理サーバーの構成が、管理対象サーバーにプッシュされます。管理対象サーバーが再起動するたびに、管理サーバーから構成が取得されます。

18.2.6 管理対象サーバーのリカバリ

管理対象サーバーのファイルが削除されたり破損した場合、その構成ファイルを含めて、それらのファイルをリカバリできます。

次の各項目で、管理対象サーバーのファイルをリカバリする方法について説明します。

- 管理対象サーバーのリカバリ(起動できない場合)

- 管理対象サーバーのリカバリ(適切に機能しない場合)

- ディレクトリが異なるOracle SOA Suite管理対象サーバーのリカバリ
この項は、Oracle SOA Suiteがドメイン内で構成されており、どの管理対象サーバーもドメイン・ディレクトリを管理サーバーと共有していない場合に関連します。

18.2.6.1 管理対象サーバーのリカバリ(起動できない場合)

このシナリオでは、管理対象サーバーの構成が削除されたり破損したために、あるいは構成が誤って変更され変更内容を確認できないために、管理対象サーバーが適切に動作しなかったり起動できない場合を考えます。

管理対象サーバーを起動できない場合のリカバリの手順は次のとおりです。

1. 管理サーバーにアクセスできない場合は、第18.2.5項の説明に従って、管理サーバーをリカバリします。

2. 管理サーバーが起動しない場合、必要に応じて、Middlewareホームをバックアップからリカバリします。次に例を示します。

tar -xf mw_home_backup_042012.tar

3. ファイル・システムが損失した場合、次の手順を実行します。

1. packユーティリティを使用して、管理サーバーのドメイン・テンプレートjarファイルを作成します。次に例を示します。

pack.sh -domain=/scratch/oracle/config/domains/domain_name
-template=/scratch/temp.jar -template_name=test_install
-template_author=myname -log=/scratch/logs/my.log -managed=true

-managed=trueオプションを指定すると、管理対象サーバーのみがパックされます。ドメイン全体をパックする場合は、このオプションを省略します。

2. unpackユーティリティを使用して、ドメイン・テンプレートjarファイルを解凍します。

unpack.sh -template=/scratch/temp.jar
-domain=/scratch/oracle/config/domains/domain_name
-log=/scratch/logs/new.log -log_priority=info

注意:

unpackコマンドの-overwrite_domainオプションを使用すると、管理対象サーバーのテンプレートを、既存のドメインおよび既存のアプリケーション・ディレクトリに解凍できます。上書きされるファイルがあれば、上書き前のファイルのバックアップ・コピーが作成されます。環境で必要な場合は、-overwrite_domainオプションを使用してください。

3. 管理対象サーバー・ホストからアプリケーション・アーティファクトにアクセス可能であることを確認します。つまり、アプリケーション・アーティファクトが管理対象サーバーと同じサーバー上にない場合、それらは管理対象サーバーがアクセスできる場所に存在する必要があるということです。

注意:

- ステージング・モードのアプリケーションの場合は、管理サーバーが、管理対象サーバー・ホストのステージング済ディレクトリにアプリケーション・ビットをコピーします。

- ステージングなしまたは外部ステージング・モード・アプリケーションでは、管理対象サーバーのステージング・ディレクトリでアプリケーション・ファイルが使用可能であることを確認してください。

ステージング、ステージングなし、または外部ステージング・モードの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』を参照してください。

4. 第4.2.3項の説明に従って、管理対象サーバーを起動します。次に例を示します。

DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name
admin_url

管理対象サーバーが管理サーバーに接続し、構成の変更を更新します。

18.2.6.2 管理対象サーバーのリカバリ(適切に機能しない場合)

このシナリオでは、管理対象サーバーが実行されていて、管理対象サーバーのファイル・システムが損失または破損している場合を考えます。

管理対象サーバーをリカバリする手順は次のとおりです。

1. 管理対象サーバーを停止します。次に例を示します。

DOMAIN_HOME/bin/stopManagedWebLogic.sh managed_server_name admin_url
username password

2. 必要に応じて、Middlewareホームをバックアップからリカバリします。

tar -xf mw_home_backup_042012.tar

3. packユーティリティを使用して、管理サーバーのドメイン・テンプレートjarファイルを作成します。次に例を示します。

pack.sh -domain=/scratch/oracle/config/domains/WLS_SOAWC
-template=/scratch/temp.jar -template_name=test_install
-template_author=myname -log=/scratch/logs/my.log -managed=true

-managed=trueオプションを指定すると、管理対象サーバーのみがパックされます。ドメイン全体をパックする場合は、このオプションを省略します。

4. unpackユーティリティを使用して、ドメイン・テンプレートjarファイルを解凍します。

unpack.sh -template=/scratch/temp.jar
-domain=/scratch/oracle/config/domains/WLS_SOAWC
-log=/scratch/logs/new.log -log_priority=info

注意:

unpackコマンドには、-overwrite_domainオプションが用意されており、管理対象サーバーのテンプレートを、既存のドメインおよび既存のアプリケーション・ディレクトリに解凍できます。上書きされるファイルがあれば、上書き前のファイルのバックアップ・コピーが作成されます。デプロイメントの際に、必要であれば-overwrite_domainオプションを使用してください。

5. 管理対象サーバー・ホストからアプリケーション・アーティファクトにアクセス可能であることを確認します。つまり、アプリケーション・アーティファクトが管理対象サーバーと同じサーバー上にない場合、それらは管理対象サーバーがアクセスできる場所に存在する必要があるということです。

注意:

- ステージング・モードのアプリケーションの場合は、管理サーバーが、管理対象サーバー・ホストのステージング済ディレクトリにアプリケーション・ビットをコピーします。

- ステージングなしまたは外部ステージング・モード・アプリケーションでは、管理対象サーバーのステージング・ディレクトリでアプリケーション・ファイルが使用可能であることを確認してください。

アプリケーションのデプロイの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』を参照してください。

6. 第4.2.3項の説明に従って、管理対象サーバーを再起動します。次に例を示します。

DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name admin_url

18.2.6.3 ディレクトリが異なるOracle SOA Suite管理対象サーバーのリカバリ

Oracle SOA Suiteがドメイン内で構成されており、どの管理対象サーバーもドメイン・ディレクトリを管理サーバーと共有していない場合は、管理対象サーバー・ディレクトリをリストアする必要があります。たとえば、ドメインに2つの管理対象サーバーがあり(その1つにOracle SOA Suiteが含まれています)、いずれの管理対象サーバーのディレクトリも管理サーバーと同じディレクトリ構造内には存在しないとします。

この場合、管理対象サーバーをバックアップからリストアする必要があります。

1. バックアップから管理対象サーバーをリストアします。

cd ManagedServer_Home
tar -xf managed_server_backup_042012.tar

2. 第4.2.3項の説明に従って、管理対象サーバーを再起動します。

DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name
admin_url

18.2.7 コンポーネントのリカバリ

次の各項目で、ほとんどのコンポーネントについてリカバリする方法を説明します。

- 適切に機能していないコンポーネントのリカバリ

- クラスタ構成変更後のコンポーネントのリカバリ

一部のコンポーネントについては、別の手順に従う必要があります。表18-1に、そのようなコンポーネントと、そのリカバリ手順を説明している項を示します。

表18-1 特定のコンポーネントのリカバリ手順

コンポーネント

手順

Oracle Access Manager

18.2.7.5項

Oracle Adaptive Access Manager

18.2.7.6項

Oracle BI Enterprise Edition

18.2.7.10項

Oracle Business Intelligence Publisher

18.2.7.11項

Oracle Business Process Management

18.2.7.7項

Oracle Essbase

18.2.7.13項

Oracle Data Integrator

18.2.7.17項

Oracle Hyperion Calculation Manager

18.2.7.14項

Oracle Hyperion Financial Reporting

18.2.7.15項

Oracle Hyperion Smart View

18.2.7.16項

Oracle Identity Manager

18.2.7.3項

Oracle Identity Navigator

18.2.7.4項

Oracle WebCenter Content: Imaging

18.2.7.19項

Oracle Information Rights Management

18.2.7.18項

Oracle Real-Time Decisions

18.2.7.12項

Oracle WebCenter Content

18.2.7.20項

Oracle WebCenter Content: Records

18.2.7.21項

Oracle WebCenter Portalのアクティビティ・グラフ

18.2.7.8項

Oracle WebCenter Portal分析

18.2.7.9項

18.2.7.1 適切に機能してないコンポーネントのリカバリ

コンポーネントのファイルが削除されたり破損した場合、またはコンポーネントの構成が変更されコミットされたためにコンポーネントが起動できないまたは適切に機能しない場合、コンポーネントをリカバリできます。どの変更が問題の原因となっているかを確認できない場合は、以前のバージョンに戻します。

- Oracle SOA SuiteなどのJavaコンポーネントの場合は、第18.2.6項の説明に従って、管理対象サーバーをリカバリします。

- システム・コンポーネントの場合(Oracle HTTP ServerやWeb Cacheなど):

1. コンポーネントを停止します。たとえば、Oracle HTTP Serverを停止するには、次のコマンドを使用します。

opmnctl stopproc ias-component=component_name

コンポーネントの停止方法の詳細は、第4.3項を参照してください。

2. バックアップからコンポーネント固有のファイルをリカバリします。第16.5項に、各コンポーネントに必要なディレクトリとファイルを示します。たとえば、Oracle HTTP Serverのファイルをリカバリするには、次のディレクトリをリカバリします。

ORACLE_INSTANCE/config/OHS/component_name
ORACLE_INSTANCE/diagnostics/logs/OHS/component_name

3. コンポーネントを起動します。たとえば、Oracle HTTP Serverを起動するには、次のコマンドを使用します。

opmnctl startproc ias-component=component_name

コンポーネントの起動方法の詳細は、第4.3項を参照してください。

18.2.7.2 クラスタ構成変更後のコンポーネントのリカバリ

クラスタ・レベルで構成が変更されコミットされたために、クラスタ内のコンポーネントが適切に機能しないまたは起動できない場合、それらのコンポーネントをリカバリできます。どの変更が問題の原因となっているかを確認できない場合は、以前のバージョンに戻します。

注意:

ドメイン・レベルのリカバリを実行すると、実行中のシステムに他の面で影響が出て、バックアップ後に行われた構成変更がすべて失われる場合があります。

コンポーネントをリカバリする手順は次のとおりです。

1. クラスタを停止します。

stop('cluster_name', 'Cluster')

2. 管理対象サーバーや管理サーバーなど、すべてのプロセスを停止します。たとえば、Linux上で管理サーバーを停止するには、次のように指定します。

DOMAIN_HOME/bin/stopWebLogic.sh username password [admin_url]

Oracle Fusion Middlewareプロセスの停止の詳細は、第4.1項を参照してください。

3. ドメイン・ホームのバックアップを一時的な場所にリカバリすることで、管理サーバーの構成をリカバリします。次に、configディレクトリを次の場所にリストアします。

DOMAIN_HOME/config

4. 管理サーバーを起動します。次に例を示します。

DOMAIN_HOME/bin/startWebLogic.sh -Dweblogic.management.username=username
-Dweblogic.management.password=password
-Dweblogic.system.StoreBootIdentity=true

5. クラスタを起動します。Oracle WebLogic Server管理コンソールまたはWLSTを使用できます。たとえば、WLSTのstartコマンドを次のように使用します。

start('clusterName', 'Cluster')

最新の構成が管理サーバーからクラスタのすべてのメンバーに取得されます。

18.2.7.3 Oracle Identity Managerのリカバリ

Oracle Identity Managerをリカバリする手順は次のとおりです。

1. 第18.2.2項の説明に従って、ドメインをリストアします。

2. 第18.2.3項の説明に従って、Oracleホームをリストアします。

3. OIM、MDS、SOAINFRAおよびOIDスキーマが含まれるデータベースを同じ時点にリストアします。第18.2.10項を参照してください。
Oracle Identity Managerでは、ユーザーおよびロールをLDAPストアに格納します。データベースをLDAPストアと異なる時点にリストアする場合、リコンシリエーション・エンジンでは変更ログをチェックして、LDAPストアとデータベースのリストアの間に発生したすべての変更を再度適用します。たとえば、データベースをLDAPストアの10時間後の時点にリストアする場合、リコンシリエーション・エンジンは変更ログをチェックしてLDAPストアで直前の10時間以内に発生したすべての変更をデータベースに再度適用します。

リコンシリエーションを明示的にトリガーする必要はありません。LDAP同期は定期的なスケジュール済タスクとして設定され、定期的にリコンシリエーション・イベントを発行します。また、リコンシリエーション・プロセスを手動で起動して、Oracle Identity Managerコンソールからリコンシリエーション・イベントを監視することもできます。『Oracle Fusion Middleware Oracle Identity Managerユーザーズ・ガイド』のリコンシリエーションの構成に関する項を参照してください。

注意:

前述のリカバリ・シナリオでバルク・リコンシリエーションが発生する場合、エンド・ユーザーによるOracle Identity Managerアプリケーションの使用を停止することをお薦めします。バルク・リコンシリエーションが完了したら、エンド・ユーザーによるOracle Identity Managerアプリケーションの使用を再開してください。リコンシリエーションは、Oracle Identity Managerコンソールで監視できます。

18.2.7.4 Oracle Identity Navigatorのリカバリ

Oracle Identity Navigatorをリカバリする手順は次のとおりです。

1. 第18.2.2項の説明に従って、ドメインをリストアします。

2. 第18.2.3項の説明に従って、Oracleホームをリストアします。

3. WLST importMetadataコマンドを使用して、ファイルベースのMDSリポジトリをリストアします。次に例を示します。

importMetadata(application='oinav', server='server_name', fromLocation='export_directory')

18.2.7.5 Oracle Access Managerのリカバリ

Oracle Access Managerをリカバリする手順は次のとおりです。

1. 第18.2.1項の説明に従って、Middlewareホーム、およびOracle Access Manager管理対象サーバーのドメイン・ホームをリストアします。

2. 第18.2.2項の説明に従って、ドメインをリストアします。

3. 必要に応じて、第18.2.3項の説明に従って、Webゲートが含まれるOracle HTTP ServerのOracleホームをリストアします。

4. 必要に応じて、第18.2.4項の説明に従って、Webゲートが含まれるOracle HTTP ServerのOracleインスタンスをリストアします。

5. 必要に応じて、Oracle Access Managerポリシー・ストア用にOESで使用されるスキーマが含まれるデータベースをリストアします。第18.2.10項を参照してください。

18.2.7.6 Oracle Adaptive Access Managerのリカバリ

Oracle Adaptive Access Managerをリカバリする手順は次のとおりです。

1. 第18.2.2項の説明に従って、ドメインをリストアします。

2. 第18.2.3項の説明に従って、Oracleホームをリストアします。

3. 必要に応じて、OAAMスキーマが含まれるデータベースをリストアします。第18.2.10項を参照してください。

18.2.7.7 Oracle Business Process Managementのリカバリ

Oracle Business Process Managementをリカバリする手順は次のとおりです。

1. 第18.2.6項の説明に従って、管理対象サーバーをリストアします。

2. 第18.2.3項の説明に従って、Oracleホームをリストアします。

18.2.7.8 Oracle WebCenter Portalのアクティビティ・グラフのリカバリ

Oracle WebCenter Portalのアクティビティ・グラフをリカバリする手順は次のとおりです。

1. 第18.2.2項の説明に従って、ドメインをリストアします。

2. 第18.2.3項の説明に従って、Oracleホームをリストアします。

3. 必要に応じて、ACTIVITIESスキーマが含まれるデータベースをリストアします。

18.2.7.9 Oracle WebCenter Portal分析のリカバリ

Oracle WebCenter Portal分析をリカバリする手順は次のとおりです。

1. 第18.2.2項の説明に従って、ドメインをリストアします。

2. 第18.2.3項の説明に従って、Oracleホームをリストアします。

3. 必要に応じて、ACTIVITIESスキーマおよびMDSスキーマが含まれるデータベースをリストアします。

18.2.7.10 Oracle BI Enterprise Editionのリカバリ

次の各項目で、Oracle Business Intelligence Enterprise Edition(Oracle BI EE)をリカバリする方法について説明します。

- 非クラスタ環境でのOracle BI Enterprise Editionのリカバリ

- クラスタ環境でのOracle BI Enterprise Editionのリカバリ

注意:

Oracle BI EEをリカバリする場合、Oracle BI Presentation CatalogとOracle BI EEリポジトリ(RPD)は、同じバックアップ・セットを使用して、同じ時点にリストアされるようにする必要があります。

18.2.7.10.1 非クラスタ環境でのOracle BI Enterprise Editionのリカバリ

このシナリオでは、Oracle BI Enterprise Editionが非クラスタ環境で実行されていると想定します。

1. 障害の程度に応じて、次のものをリストアします。

- Middlewareホーム全体が失われている場合は、第18.2.1項の説明に従って、Middlewareホームをリストアします。

- Oracleインスタンス・ホームが失われている場合は、第18.2.4項の説明に従って、Oracleインスタンス・ホームをリストアします。

- 管理サーバー・ノードでドメイン・ホームが失われている場合は、第18.2.5項の説明に従って、ドメイン・ホームをリストアします。

- 管理対象サーバー・ノードでドメイン・ホームが失われている場合は、第18.2.6項の説明に従って、ドメイン・ホームをリストアします。

2. 第18.2.5項の説明に従って、管理サーバーをリカバリします。

3. 第18.2.6項の説明に従って、管理対象サーバーをリカバリします。

4. 必要に応じて、Oracle BI EEのスキーマが含まれるデータベースをリストアします。第18.2.10項を参照してください。

5. 第18.2.7.10.3項の説明に従って、LDAPデータベースとOracle BI EEリポジトリ(RPD)を、第18.2.7.10.4項の説明に従って、LDAPデータベースとOracle BI Presentation Catalogを調整します。

18.2.7.10.2 クラスタ環境でのOracle BI Enterprise Editionのリカバリ

このシナリオでは、Oracle BI Enterprise Editionがクラスタ環境で実行されていると想定します。

クラスタ環境でOracle BI EEをリカバリする手順は次のとおりです。

1. 障害の程度に応じて、次のものをリストアします。

- Middlewareホーム全体が失われている場合は、第18.2.1項の説明に従って、Middlewareホームをリストアします。

- Oracleインスタンス・ホームが失われている場合は、第18.2.4項の説明に従って、Oracleインスタンス・ホームをリストアします。

- 管理サーバー・ノードでドメイン・ホームが失われている場合は、第18.2.5項の説明に従って、ドメイン・ホームをリストアします。

- 管理対象サーバー・ノードでドメイン・ホームが失われている場合は、第18.2.6項の説明に従って、ドメイン・ホームをリストアします。

2. 第18.2.5項の説明に従って、管理サーバーをリカバリします。

3. 第18.2.6項の説明に従って、すべての管理対象サーバーをリカバリします。

4. 必要に応じて、第18.2.10項の説明に従って、Oracle BI EEスキーマが含まれるデータベースをリストアします。

5. 第18.2.7.10.3項の説明に従って、LDAPデータベースとOracle BI EEリポジトリ(RPD)を、第18.2.7.10.4項の説明に従って、LDAPデータベースとOracle BI Presentation Catalogを調整します。

18.2.7.10.3 LDAPデータベースとRPDの調整

LDAPデータベースは、Oracle BI EEリポジトリ(RPD)と調整する必要があります。

Oracle BI Enterprise Editionを使用して、同期を実行できます。常に自動同期を有効にすることも一時的に同期を実行することもできます。(NQSConfig.iniファイルの編集の詳細は、『Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイド』のNQSConfig.INIファイルの構成設定に関する説明を参照してください。)

- 同期を有効にする手順は次のとおりです。

1. 次のファイルを編集します。

INSTANCE_HOME/config/OracleBIServerComponent/coreapplication_obis1/NQSConfig.INI

フラグFMW_UPDATE_ROLE_AND_USER_REF_GUIDSをyesに設定します。

2. サーバーを再起動します。LDAPデータベースの情報とRPDが同期化されます。

- 同期を無効にする手順は次のとおりです。

1. 同期を無効にするには、次のファイルを編集します。

INSTANCE_HOME/config/OracleBIServerComponent/coreapplication_obis1/NQSConfig.INI

フラグFMW_UPDATE_ROLE_AND_USER_REF_GUIDSをnoに設定します。

2. サーバーを再起動します。

Windows上のOracle BI管理ツールには、リポジトリの妥当性をチェックして不整合を修正できるConsistency Check Managerが用意されています。詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ・ビルダーズ・ガイドのリポジトリ・オブジェクトの一貫性のチェックに関する項を参照してください。

18.2.7.10.4 LDAPデータベースとOracle BI Presentation Catalogの調整

LDAPデータベースがOracle BI Presentation Catalogの背後にあるよりも以前の時点にLDAPデータベースをリストアする場合は、次のコマンドを使用してLDAPデータベースとOracle BI Presentation Catalogを調整します。

runcat.cmd -cmd forgetAccounts

runcatコマンドの詳細は、次のようにヘルプを参照してください。

./runcat.sh -cmd maintenanceMode -help

18.2.7.11 Oracle Business Intelligence Publisherのリカバリ

Oracle Business Intelligence Publisherをリカバリする手順は次のとおりです。

1. 第18.2.6項の説明に従って、Oracle Business Intelligence Publisherコンポーネントが含まれる管理対象サーバーをリカバリします。

2. 必要に応じて、第18.2.10項の説明に従って、Oracle Business Intelligence Publisherスキーマが含まれるデータベースをリストアします。

バックアップ・アーティファクトが別の時点からリストアされると、ユーザー・アカウント、ユーザー・レポートおよび権限は、リストアされたバージョンに戻ります。すべてのアーティファクトを同じ時点からリストアします。

18.2.7.12 Oracle Real-Time Decisionsのリカバリ

Oracle Real-Time Decisionsをリカバリする手順は次のとおりです。

1. 第18.2.6項の説明に従って、Oracle Real-Time Decisionsコンポーネントが含まれる管理対象サーバーをリカバリします。

バックアップ・アーティファクトが別の時点からリストアされると、分析モデルで学習期間が失われますが、インテリジェント機能には影響しません。

18.2.7.13 Oracle Essbaseのリカバリ

Oracle Essbaseをリカバリする手順は次のとおりです。

1. 第18.2.1項の説明に従って、Middlewareホームをリカバリします。

2. MiddlewareホームにOracleインスタンスが存在しない場合は、第18.2.4項の説明に従って、Oracleインスタンスをリカバリします。

18.2.7.14 Oracle Hyperion Calculation Managerのリカバリ

Oracle Hyperion Calculation Managerをリカバリする手順は次のとおりです。

1. 第18.2.6項の説明に従って、Oracle Hyperion Calculation Managerがデプロイされている管理対象サーバーをリカバリします。

2. 必要に応じて、データベースを直近の時点にリカバリするか、Oracle Hyperion Calculation Managerインポート・ツールを使用してアーティファクトをインポートします。

18.2.7.15 Oracle Hyperion Financial Reportingのリカバリ

Oracle Hyperion Financial Reportingをリカバリする手順は次のとおりです。

1. 第18.2.3項の説明に従って、Oracle Hyperion Financial ReportingのOracleホームをリカバリします。

2. 第18.2.4項の説明に従って、Oracleインスタンスをリカバリします。

3. 必要に応じて、データベースを直近の時点にリカバリします。

18.2.7.16 Oracle Hyperion Smart Viewのリカバリ

Oracle Hyperion Smart Viewをリカバリする手順は次のとおりです。

1. 第16.5.9.4項の説明に従って、バックアップしたOracle Hyperion Smart Viewのデータ・ファイルを元の場所にリストアします。

18.2.7.17 Oracle Data Integratorのリカバリ

Oracle Data Integratorをリカバリする手順は次のとおりです。

1. 必要に応じて、第18.3.6項の説明に従って、データベースをリストアします。

2. 第18.2.3項の説明に従って、バックアップからOracle Data IntegratorのOracleホームをリカバリします。

cd ORACLE_HOME
tar -xf oracle_home_backup_042012.tar

3. バックアップからドメイン・ディレクトリをリカバリします。

cd DOMAIN_HOME
tar -xf domain_backup_042012.tar

18.2.7.18 Oracle Information Rights Managementのリカバリ

Oracle Information Rights Managementをリカバリする手順は次のとおりです。

1. 第18.2.2項の説明に従って、ドメインをリストアします。

2. 共有ファイル・システムをリストアします。

3. 必要に応じて、第18.2.10項の説明に従って、データベースをリストアします。
データベースとキーストアの同期を維持する必要があります。一方をリストアしたら、もう一方も同じ時点にリストアします。

4. キーストアをリストアします。

18.2.7.19 Oracle WebCenter Content: Imagingのリカバリ

Oracle WebCenter Content: Imagingでは、データが次の場所に格納されています。

- Imagingの構成データのデータベース

- ドキュメント・リポジトリとして機能するデータベース

- JMS永続キュー

Imagingをリカバリする場合、すべてのデータが同じ時点からリストアされるようにする必要があります。

Imagingをリカバリする手順は次のとおりです。

1. 第18.2.2項の説明に従って、ドメインをリストアします。

2. 必要に応じて、IPMおよびOCSスキーマが含まれるデータベースをリストアします。第18.2.10項を参照してください。

18.2.7.20 Oracle WebCenter Contentのリカバリ

Oracle WebCenter Contentをリカバリする手順は次のとおりです。

1. 必要に応じて、第18.3.6項の説明に従って、データベースをリストアします。

2. 第18.2.2項の説明に従って、ドメインをリストアします。

3. ドメイン・ディレクトリにVault、WebLayoutまたはSearchディレクトリが配置されていない場合は、必要に応じてそれらのディレクトリをリストアします。たとえば、Vaultディレクトリが/net/home/vault内の共有ドライブに配置されている場合は、バックアップからVaultディレクトリをリストアします。

cd /net/home/vault
tar -xf vault_backup_042012.tar

データベースと共有ファイル・システムは同時にリストアしてください。同時にリストアできない場合は、IDCAnalyseユーティリティを使用して、データベースと共有ファイル・システム間に不一致があるかどうかを特定できます。不一致がある場合は、IDCAnalyseを使用して、手動でリカバリを実行できます。

18.2.7.21 Oracle WebCenter Content: Recordsのリカバリ

Oracle WebCenter Content: Recordsは、Oracle WebCenter Contentに依存しており、追加でバックアップまたはリカバリするアーティファクトがないため、Oracle WebCenter Contentのリカバリ手順(第18.2.7.20項)を参照してください。

18.2.8 クラスタのリカバリ

次の各項目で、クラスタをリカバリする方法について説明します。

- 削除またはクラスタレベルの構成変更後のクラスタのリカバリ

- メンバーシップを誤って変更した後のクラスタのリカバリ

18.2.8.1 削除またはクラスタレベルの構成変更後のクラスタのリカバリ

このシナリオでは、クラスタが間違って削除されたり、JMS構成またはコンテナレベルのデータ・ソースなどのクラスタレベルの構成が誤って変更されコミットされた場合を考えます。サーバーが起動できないか適切に動作しない、あるいはサーバー内部で実行されるサービスが開始されていません。変更内容は確認できません。

注意:

ドメイン・レベルのリカバリを実行すると、実行中のシステムに他の面で影響が出て、バックアップ後に行われた構成変更がすべて失われる場合があります。

構成の変更が少ない場合、最も簡単な方法は、構成の変更を再実行することです。この方法を実行できない場合は、次の手順に従って構成をリカバリします。

1. クラスタを停止します。Oracle WebLogic Server管理コンソールまたはWLSTを使用できます。たとえば、WLSTを次のように使用します。

stop('clusterName', 'Cluster')

2. 管理サーバーを停止します。次に例を示します。

DOMAIN_HOME/bin/stopWebLogic.sh username password [admin_url]

3. ドメイン・ホームのバックアップを一時的な場所にリカバリすることで、管理サーバーの構成をリカバリします。次に、configディレクトリを次の場所にリストアします。

DOMAIN_HOME/config

4. 管理サーバーを起動します。次に例を示します。

DOMAIN_HOME/bin/startWebLogic.sh -Dweblogic.management.username=username
-Dweblogic.management.password=password
-Dweblogic.system.StoreBootIdentity=true

5. クラスタを起動します。Oracle WebLogic Server管理コンソールまたはWLSTを使用できます。たとえば、WLSTを次のように使用します。

start('clusterName', 'Cluster')

18.2.8.2 メンバーシップを誤って変更した後のクラスタのリカバリ

クラスタのメンバーシップを誤って変更した場合に、クラスタをリカバリできます。たとえば、クラスタからメンバーを誤って削除した場合、メンバーをクラスタにリストアできます。

注意:

ドメイン・レベルのリカバリを実行すると、実行中のシステムに他の面で影響が出て、バックアップ後に行われた構成変更がすべて失われる場合があります。

クラスタのメンバーシップをリカバリする手順は次のとおりです。

1. 管理対象サーバーや管理サーバーなど、すべてのプロセスを停止します。たとえば、Linux上で管理サーバーを停止するには、次のように指定します。

DOMAIN_HOME/bin/stopWebLogic.sh username password [admin_url]

Oracle Fusion Middlewareプロセスの停止の詳細は、第4.1項を参照してください。

2. ドメイン・ホームのバックアップを一時的な場所にリカバリすることで、管理サーバーの構成をリカバリします。次に、configディレクトリを次の場所にリストアします。

DOMAIN_HOME/config

3. 管理サーバーを起動します。次に例を示します。

DOMAIN_HOME/bin/startWebLogic.sh -Dweblogic.management.username=username
-Dweblogic.management.password=password
-Dweblogic.system.StoreBootIdentity=true

削除されたメンバーがクラスタに戻ります。

4. 管理対象サーバーなど、すべてのプロセスを起動します。たとえば、Linux上で管理対象サーバーを起動するには、次のスクリプトを使用します。

DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name
admin_url

5. クラスタを起動します。Oracle WebLogic Server管理コンソールまたはWLSTを使用できます。たとえば、WLSTを次のように使用します。

start('clusterName', 'Cluster')

これで、削除されたメンバーがクラスタの一部となります。

6. クラスタのすべてのメンバーを起動します(起動していない場合)。

DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name admin_url

18.2.9 アプリケーションのリカバリ

次の各項目で、アプリケーションをリカバリする方法について説明します。

- アプリケーション・アーティファクトのリカバリ

- 機能しなくなった再デプロイされたアプリケーションのリカバリ

- アンデプロイされたアプリケーションのリカバリ

- コンポジット・アプリケーションのリカバリ

アプリケーションのリカバリについては、次の点に注意してください。

- アプリケーションがステージングされている場合、管理サーバーは、管理対象サーバー・ホストのステージング済ディレクトリにアプリケーションのビットをコピーします。

- デプロイメント・モードがステージングなしまたは外部ステージングの場合、追加のアプリケーション・アーティファクトが使用可能であることを確認してください。たとえば、アプリケーションがドメイン・ディレクトリの外部のディレクトリに存在する可能性があります。アプリケーション・ファイルを、バックアップからコピーするか共有ディスクを使用して、新しい管理サーバーで使用できるようにします。アプリケーション・ファイルは、新しいファイル・システム上でも、元の管理サーバーのファイル・システムの場合と相対的に同じ位置にある必要があります。

関連項目:

アプリケーションのデプロイの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』を参照してください。

18.2.9.1 アプリケーション・アーティファクトのリカバリ

.earファイルなどのアプリケーションのアーティファクトが損失または破損した場合、そのアプリケーションをリカバリできます。

アプリケーションをリカバリする手順は次のとおりです。

1. アプリケーションのデプロイ先の管理対象サーバーを起動します。次に例を示します。

DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name admin_url

このコマンドを実行すると、構成が管理サーバーと同期されます。

管理対象サーバーが再起動するたびに、構成およびアプリケーション・アーティファクトが管理サーバーから取得されます。

18.2.9.2 機能しなくなった再デプロイされたアプリケーションのリカバリ

Java EEアプリケーションが管理対象サーバーに再デプロイされ(管理対象サーバーがクラスタの一部であるかどうかは関係ない)、アプリケーションが機能しなくなった場合、そのアプリケーションをリカバリできます。

アプリケーションをリカバリする手順は次のとおりです。

1. 必要に応じて、アプリケーション・ファイルをバックアップからリカバリします。

2. バックアップから古いバージョンのアプリケーションを再デプロイします。
元のearファイルを単純にコピーすることはできません。元のearファイルをバックアップから管理対象サーバーのステージング・ディレクトリにコピーして管理対象サーバーを再起動しても、アプリケーションはリカバリされません。元のバージョンを再デプロイする必要があります。

18.2.9.3 アンデプロイされたアプリケーションのリカバリ

デプロイ済アプリケーションがOracle WebLogic Serverからアンデプロイされた場合、そのアプリケーションをリカバリできます。

アプリケーションをリカバリする手順は次のとおりです。

1. 必要に応じて、アプリケーション・ファイルをバックアップからリカバリします。

2. バックアップから古いバージョンのアプリケーションを再デプロイします。アプリケーションがクラスタにデプロイされた場合、同じクラスタにアプリケーションを再デプロイします。
元のearファイルを単純にコピーすることはできません。元のearファイルをバックアップから管理対象サーバーのステージング・ディレクトリにコピーして管理対象サーバーを再起動しても、アプリケーションはリカバリされません。元のバージョンを再デプロイする必要があります。

18.2.9.4 コンポジット・アプリケーションのリカバリ

コンポジット・アプリケーション(SOAアプリケーション)の新規バージョンが管理対象サーバーまたはクラスタに再デプロイされました。このアプリケーションが機能しなくなったとします。

アプリケーションをリカバリする手順は次のとおりです。

1. 必要に応じて、アプリケーション・ファイルをバックアップからリカバリします。

2. アプリケーションの古いバージョンを再デプロイします。アプリケーションがクラスタにデプロイされた場合、同じクラスタにアプリケーションを再デプロイします。

18.2.10 データベースのリカバリ

MDSリポジトリなどのメタデータ・リポジトリが含まれるデータベースが破損している場合、RMANを使用してそのデータベースをリカバリできます。データベースは、完全リカバリまたは表領域リカバリのいずれかの必要な粒度でリカバリできます。

最善の結果を得るには、ポイント・イン・タイム・リカバリを使用して、データベースを最新の状態にリカバリします(データベースがアーカイブ・ログ・モードで構成されている場合)。これにより、確実に最新のデータがリカバリされます。次に例を示します。

rman> restore database;
rman> recover database;

各コンポーネントで使用するスキーマについては、付録Dを参照してください。

詳細な手順は、『Oracle Databaseバックアップおよびリカバリ・ユーザーズ・ガイド』を参照してください。

18.3 ホスト破損後のリカバリ

この項では、Oracle Fusion Middlewareの元の動作環境が損なわれた後、その環境をリカバリする方法について説明します。たとえば、システムの深刻な機能不全やメディアの損失が発生した場合などです。この項の項目は次のとおりです。

- Oracle WebLogic Serverドメイン・ホストの破損後のリカバリ

- 管理サーバー・ホストの破損後のリカバリ

- 管理対象サーバー・ホストの破損後のリカバリ

- コンポーネント・ホストの破損後のリカバリ

- ホストの破損後にエンティティをリカバリするための追加の操作

- データベース・ホストの破損後のリカバリ

注意:

ホストの破損からリカバリする場合、元のホストで使用していたものと同じパスを使用してファイルをリストアする必要があります。

18.3.1 Oracle WebLogic Serverドメイン・ホストの破損後のリカバリ

Oracle WebLogic Serverドメインをリカバリする手順は次のとおりです。

1. 関連するすべてのプロセスを停止します。つまり、管理サーバーや管理対象サーバーなど、ドメインに関連するすべてのプロセスを停止します。たとえば、管理サーバーを停止します。

DOMAIN_HOME/bin/stopWebLogic.sh username password [admin_url]

Oracle Fusion Middlewareプロセスの停止の詳細は、第4.1項を参照してください。

2. バックアップからドメイン・ディレクトリをリカバリします。

cd DOMAIN_HOME
(UNIX) tar -xf domain_backup_042012.tar
(Windows) jar xtf domain_backup_042012.jar

3. 関連するすべてのプロセスを起動します。つまり、このドメインに関連するすべてのプロセスを起動します。たとえば、管理サーバーを起動します。

DOMAIN_HOME/bin/startWebLogic.sh -Dweblogic.management.username=username
-Dweblogic.management.password=password
-Dweblogic.system.StoreBootIdentity=true

4. 管理サーバーを起動できない場合は、第18.3.2項の説明に従って、管理サーバーをリカバリします。

5. 管理対象サーバーを起動できない場合は、第18.3.3項の説明に従って、管理対象サーバーをリカバリします。

18.3.2 管理サーバー・ホストの破損後のリカバリ

管理サーバーを含むホストが破損した場合、次の各項目で説明するように、同じホストまたは別のホストにリカバリできます。

- 同じホストへの管理サーバーのリカバリ

- 別のホストへの管理サーバーのリカバリ

18.3.2.1 同じホストへの管理サーバーのリカバリ

このシナリオでは、管理サーバーを、オペレーティング・システムの再インストール後に同じホストにリカバリするか、同じホスト名を持つ新しいホストにリカバリします。たとえば、ホストAで管理サーバーが実行されており、ホストBで管理対象サーバーが実行されているとします。なんらかの理由により、ホストAで障害が発生したため、管理サーバーをリカバリする必要があります。

同じホストに管理サーバーをリカバリする手順は次のとおりです。

1. ファイル・システムをリカバリします。たとえば、第18.3.1項の説明に従って、この管理サーバーが含まれるドメインをリカバリします。

2. 管理サーバーを起動してみます。次に例を示します。

DOMAIN_HOME/bin/startWebLogic.sh -Dweblogic.management.username=username
-Dweblogic.management.password=password
-Dweblogic.system.StoreBootIdentity=true

管理サーバーが起動する場合は、これ以上の手順は必要ありません。

3. 管理サーバーが起動しない場合は、ホストAで次の手順を実行します。

1. 関連するすべてのプロセスを停止します。つまり、管理サーバーや管理対象サーバーなど、ドメインに関連するすべてのプロセスを停止します。たとえば、Linux上で管理サーバーを停止するには、次のように指定します。

DOMAIN_HOME/bin/stopWebLogic.sh username password [admin_url]

Oracle Fusion Middlewareプロセスの停止の詳細は、第4.1項を参照してください。

2. 必要に応じて、Middlewareホームをリカバリします。

tar -xf mw_home_backup_042012.tar

3. ドメイン・ディレクトリがMiddlewareホーム内に見つからない場合は、ドメイン・ディレクトリバックアップからリカバリします。

cd DOMAIN_HOME
tar -xf domain_backup_042012.tar

4. 管理サーバーを起動します。次に例を示します。

DOMAIN_HOME/bin/startWebLogic.sh -Dweblogic.management.username=username
-Dweblogic.management.password=password
-Dweblogic.system.StoreBootIdentity=true

5. ホストの管理用URLを指定して、管理対象サーバーを起動します。

DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name admin_url

6. ノード・マネージャを起動します。

cd WL_HOME/server/bin
./startNodeManager.sh

18.3.2.2 別のホストへの管理サーバーのリカバリ

このシナリオでは、ホストAで管理サーバーが実行されており、ホストBで管理対象サーバーが実行されています。なんらかの理由により、ホストAで障害が発生したため、管理サーバーをホストCに移行する必要があります。

別のホストに管理サーバーをリカバリする手順は次のとおりです。

1. MiddlewareホームをホストC(新しいホスト)にリカバリします。

cd MW_HOME
tar -xf mw_home_backup_042012.tar

2. ドメイン・ディレクトリがMiddlewareホーム内に見つからない場合は、ドメイン・ディレクトリバックアップからリカバリします。

cd DOMAIN_HOME
tar -xf domain_backup_042012.tar

3. 管理サーバーにリスニング・アドレスが指定されている場合は、第18.3.5.5項の説明に従って、新しいホスト名で新しいマシンを作成します。

4. 元のホストでノード・マネージャが構成されていた場合は、ホストCでノード・マネージャを起動します。

cd WL_HOME/server/bin
./startNodeManager

5. 管理サーバーを起動します。次に例を示します。

DOMAIN_HOME/bin/startWebLogic.sh -Dweblogic.management.username=username
-Dweblogic.management.password=password
-Dweblogic.system.StoreBootIdentity=true

6. 管理対象サーバーを起動します。『Oracle Fusion Middleware Oracle WebLogic Serverでの管理サーバーの起動と停止』の障害が発生した管理サーバーの再起動に関する項には、構成方法に応じて様々な再起動の方法が説明されています。
オプションの1つとして、次のスクリプトの使用があります。このコマンドでは、新しいホストの管理用URLを指定します。

DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name admin_url

7. 追加のアプリケーション・アーティファクトが使用可能であることを確認します。たとえば、デプロイメント・モードがステージングなしまたは外部ステージングの場合、アプリケーションはドメイン・ディレクトリの外部のディレクトリに存在する可能性があります。アプリケーション・ファイルを、バックアップからコピーするか共有ディスクを使用して、新しい管理サーバーで使用できるようにします。アプリケーション・ファイルは、新しいファイル・システム上でも、元の管理サーバーのファイル・システムの場合と相対的に同じ位置にある必要があります。
アプリケーションがステージングされている場合、管理サーバーは、管理対象サーバー・ホストのステージング済ディレクトリにアプリケーションのビットをコピーします。

8. 第18.3.5.7項の説明に従って、Oracle Inventoryを更新します。

9. 環境にOracle HTTP Serverが含まれる場合、第18.3.5.4項の説明に従って、mod_wl_ohs.confファイルを修正します。

10. 第18.3.5.2項の説明に従って、Fusion Middleware Controlのtargets.xmlファイルを編集します。

11. Oracle Management Service(Fusion Middleware Controlに含まれる)は、元のホスト上に配置されており、管理サーバーのリストア時に新しいホストにリカバリされます。Oracle Management Agentは、Oracle Management Serviceに接続して、特定のコンポーネントを監視します。使用している環境に、Oracle Internet DirectoryやOracle Virtual Directoryなど、Oracle Management Agentを使用するコンポーネントが含まれるが、それらが別のホストに配置されている場合、これらのコンポーネントが含まれる各ホストで次の手順を実行する必要があります。たとえば、ホストAにあった管理サーバーを、Oracle Management ServiceとともにホストBにリストアするとします。Oracle Internet DirectoryはホストCに、Oracle Virtual DirectoryはホストDに配置されているとします。この場合、ホストCとホストDの両方で、次の手順を実行する必要があります。

1. 次のファイルを編集します。

(UNIX) ORACLE_INSTANCE/EMAGENT/emagent_name/sysman/config/emd.properties
(Windows) ORACLE_INSTANCE\EMAGENT\emagent_name\sysman\config\emd.properties

ホスト名を管理サーバーの新しいホストに置き換えて、次のエントリを更新します。

emdWalletSrcUrl=http://newhost.domain.com:port/em/wallets/emd
REPOSITORY_URL=http://newhost.domain.com:port/em/upload/
EMD_URL=http://newhost.domain.com:port/emd/main/

2. EMエージェント・プロセスを停止して、再起動します。

cd ORACLE_INSTANCE/EMAGENT/emagent_dir
./emctl stop agent
./emctl start agent
./emctl status agent

ステータス・コマンドに、新しいホストを指すREPOSITORY_URLが示されます。

これで、ホストCで実行されている管理コンソールを使用して、ホストBの管理対象サーバーを起動および停止できます。

Web層インストール用に管理サーバーをリカバリする場合、必要な追加操作の詳細は、第18.3.5項を参照してください。

18.3.3 管理対象サーバー・ホストの破損後のリカバリ

管理対象サーバーを含むホストが破損した場合、次の各項目で説明するように、同じホストまたは別のホストにリカバリできます。

- 同じホストへの管理対象サーバーのリカバリ

- 別のホストへの管理対象サーバーのリカバリ

- ディレクトリが異なるOracle SOA Suite管理対象サーバーのリカバリ
この項は、Oracle SOA Suiteがドメイン内で構成されており、どの管理対象サーバーもドメイン・ディレクトリを管理サーバーと共有していない場合に関連します。

18.3.3.1 同じホストへの管理対象サーバーのリカバリ

このシナリオでは、管理対象サーバーを、オペレーティング・システムの再インストール後に同じホストにリカバリするか、同じホスト名を持つ新しいホストにリカバリします。ホストAで管理サーバーが実行されており、ホストBで管理対象サーバーが実行されています。なんかの理由により、ホストBで障害が発生したため、管理対象サーバーをホストBにリカバリする必要があります。

同じホストに管理対象サーバーをリカバリする手順は次のとおりです。

1. ホストBでノード・マネージャを起動します。

cd WL_HOME/server/bin
./startNodeManager.sh

2. 管理対象サーバーを起動します。次に例を示します。

DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name admin_url

管理対象サーバーが起動した場合、管理対象サーバーは管理サーバーに接続し、構成の変更を更新します。これ以上の手順は必要ありません。

3. 管理対象サーバーが起動しない場合、またはファイル・システムが損失した場合は、次の手順を実行します。

1. WLSTを使用して、ノード・マネージャを停止します。

java weblogic.WLST
wls:/offline> stopNodeManager()

2. 必要に応じて、MiddlewareホームをバックアップからホストBにリカバリします。

tar -xf mw_home_backup_042012.tar

3. 管理対象サーバーにOracle Portal、Oracle Reports、Oracle Forms ServicesまたはOracle Business Intelligence Discovererが含まれており、管理対象サーバーのドメイン・ディレクトリがMiddlewareホームの外部に存在する場合、Middlewareホームに加えてドメインをリストアします。次に例を示します。

cd Domain_Home
tar -xf domain_home_backup_042012.tar

ステップeに進みます。

4. ステップcに示されているコンポーネントが管理対象サーバーに含まれていない場合は、次の手順に従います。

- packユーティリティを使用して、ホストAで実行されている管理サーバーのドメイン・テンプレートjarファイルを作成します。次に例を示します。

pack.sh -domain=/scratch/oracle/config/domains/domain_name
-template=/scratch/temp.jar -template_name=test_install
-template_author=myname -log=/scratch/logs/my.log -managed=true

-managed=trueオプションを指定すると、管理対象サーバーのみがパックされます。ドメイン全体をパックする場合は、このオプションを省略します。

- ホストBでunpackユーティリティを使用して、ドメイン・テンプレートjarファイルを解凍します。

unpack.sh -template=/scratch/temp.jar
-domain=/scratch/oracle/config/domains/domain_name
-log=/scratch/logs/new.log -log_priority=info

5. 管理対象サーバー・ホストからアプリケーション・アーティファクトにアクセス可能であることを確認します。つまり、アプリケーション・アーティファクトが管理対象サーバーと同じサーバー上にない場合、それらは管理対象サーバーがアクセスできる場所に存在する必要があるということです。

注意:

- ステージングなしおよび外部ステージング・モードでデプロイされているアプリケーションの場合は、管理サーバー・ホスト・ディレクトリからアプリケーション・アーティファクトをコピーします。

- ステージング・モードでデプロイされているアプリケーションの場合は、管理サーバーが、管理対象サーバー・ホストのステージング済ディレクトリにアプリケーション・ビットをコピーします。

アプリケーションのデプロイの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』を参照してください。

6. ノード・マネージャが起動していない場合は、起動します。

cd WL_HOME/server/bin
./startNodeManager.sh

7. 管理対象サーバーを起動します。次に例を示します。

DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name admin_url

管理対象サーバーが管理サーバーに接続し、構成の変更を更新します。

18.3.3.2 別のホストへの管理対象サーバーのリカバリ

このシナリオでは、ホストAで管理サーバーが実行されており、ホストBで管理対象サーバーが実行されています。なんらかの理由により、ホストBで障害が発生したため、管理対象サーバーをホストCにリカバリする必要があります。

重要:

元と同じ場所にMiddlewareホームをリカバリします。

別のホストに管理対象サーバーをリカバリする手順は次のとおりです。

1. 管理対象サーバーのMiddlewareホームをホストCにリカバリします。

tar -xf mw_home_backup_042012.tar

2. 管理対象サーバーにOracle Portal、Oracle Reports、Oracle Forms ServicesまたはOracle Business Intelligence Discovererが含まれており、管理対象サーバーのドメイン・ディレクトリがMiddlewareホームの外部に存在する場合、Middlewareホームに加えてドメインをリストアします。次に例を示します。

cd Domain_Home
tar -xf domain_home_backup_042012.tar

ステップ4に進みます。

3. ステップ2に示されているコンポーネントが管理対象サーバーに含まれていない場合は、次の手順に従います。

1. packユーティリティを使用して、ホストAで実行されている管理サーバーからドメイン・テンプレートjarファイルを作成します。次に例を示します。

pack.sh -domain=/scratch/oracle/config/domains/domain_name
-template=/scratch/temp.jar -template_name=test_install
-template_author=myname -log=/scratch/logs/my.log -managed=true

-managed=trueオプションを指定すると、管理対象サーバーのみがパックされます。ドメイン全体をパックする場合は、このオプションを省略します。

2. ホストCでunpackユーティリティを使用して、ドメイン・テンプレートjarファイルを解凍します。

unpack.sh -template=/scratch/temp.jar
-domain=/scratch/oracle/config/domains/domain_name
-log=/scratch/logs/new.log -log_priority=info

別のドメイン・ホームにリカバリする場合は、unpackコマンドで-app_dirスイッチを使用します。

4. 管理対象サーバー・ホストからアプリケーション・アーティファクトにアクセス可能であることを確認します。つまり、アプリケーション・アーティファクトが管理対象サーバーと同じサーバー上にない場合、それらは管理対象サーバーがアクセスできる場所に存在する必要があるということです。

注意:

- ステージングなしおよび外部ステージング・モードでデプロイされているアプリケーションの場合は、管理サーバー・ホスト・ディレクトリからアプリケーション・アーティファクトをコピーします。

- ステージング・モードでデプロイされているアプリケーションの場合は、管理サーバーが、管理対象サーバー・ホストのステージング済ディレクトリにアプリケーション・ビットをコピーします。

アプリケーションのデプロイの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverへのアプリケーションのデプロイ』を参照してください。

5. ホストCでノード・マネージャが起動していない場合は、起動します。

cd WL_HOME/server/bin
./startNodeManager.sh

6. WLSTを使用して管理サーバーに接続し、新しいホストで実行されているノード・マネージャを管理サーバーに登録します。

connect('username','password','t3://host:port')
nmEnroll('/scratch/oracle/config/domains/domain_name',
'MW_HOME/wlserver_n/common/nodemanager')

7. 管理対象サーバーの構成を、新しいホストを指すように変更します。

1. WebLogic Server管理コンソールで、1つ以上のWebLogic Serverをホストするコンピュータの論理的な表現であるマシンを作成し、新しいホストを指すように指定します(「ホーム」ページで、「マシン」を選択します。続いて、「新規」をクリックします)。管理コンソール・ヘルプの指示に従います。
リスニング・アドレスをIPアドレスで定義する場合は、ノード・マネージャにアクセスする管理サーバーのホスト名検証を無効にする必要があります。詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のホスト名検証の使用方法に関する項を参照してください。

2. 管理対象サーバーの構成を、新しいマシンを指すように変更します(コンソールの左ペインから、「環境」→「サーバー」を展開します。続いて、サーバーの名前を選択します。「構成」タブ、続いて「一般」タブを選択します。「マシン」フィールドで、サーバーの割当て先のマシンを選択します。)
「リスニング・アドレス」を新しいホストに変更します。リスニング・アドレスが空白に設定されている場合は、それを変更する必要はありません。

8. 管理対象サーバーを起動します。次に例を示します。

DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name admin_url

管理対象サーバーが管理サーバーに接続し、構成の変更を更新します。

9. 第18.3.5.7項の説明に従って、Oracle Inventoryを更新します。

10. 環境にOracle HTTP Serverが含まれる場合、第18.3.5.4項の説明に従って、mod_wl_ohs.confファイルを修正します。

11. 第18.3.5.2項の説明に従って、Fusion Middleware Controlのtargets.xmlファイルを編集します。

これで、ホストAで実行されている管理サーバーを使用して、ホストCの管理対象サーバーを起動および停止できます。

18.3.3.3 ディレクトリが異なるOracle SOA Suite管理対象サーバーのリカバリ

Oracle SOA Suiteがドメイン内で構成されており、どの管理対象サーバーもドメイン・ディレクトリを管理サーバーと共有していない場合は、管理対象サーバー・ディレクトリをリストアする必要があります。たとえば、ドメインに2つの管理対象サーバーがあり(その1つにOracle SOA Suiteが含まれています)、いずれの管理対象サーバーのディレクトリも管理サーバーと同じディレクトリ構造内には存在しないとします。

同じホストまたは別のホストにリカバリするには、第18.2.6.3項で説明している手順を使用します。

18.3.4 コンポーネント・ホスト破損後のリカバリ

コンポーネント(およびその管理対象サーバー(該当する場合))を含むホストが破損した場合、次の各項目で説明する手順を使用して、ほとんどのコンポーネントを同じホストまたは別のホストにリカバリできます。

- 同じホストへのJavaコンポーネントのリカバリ

- 別のホストへのJavaコンポーネントのリカバリ

- 同じホストへのシステム・コンポーネントのリカバリ

- 別のホストへのシステム・コンポーネントのリカバリ

コンポーネントによっては追加操作が必要なものがあります。それらは、表18-2で示した項で説明しています。

表18-2 特定コンポーネントのホスト破損の際のリカバリ手順

コンポーネント

手順

Oracle Access Manager

18.3.4.5.7項

Oracle Adaptive Access Manager

18.3.4.5.8項

Oracle BI Discoverer

18.3.4.8.4項

Oracle BI Enterprise Edition

18.3.4.9項

Oracle BI Publisher

18.3.4.10項

Oracle Business Process Management

ホストの破損については、追加手順は必要ありません。第18.2.7.7項の手順に従ってください。

Oracle Data Integrator

18.3.4.15項

Oracle Directory Integration Platform

18.3.4.5.3項

Oracle Essbase

18.3.4.12項

Oracle Forms Services

18.3.4.8.2項

Oracle Hyperion Calculation Manager

18.3.4.13項

Oracle Hyperion Financial Reporting

18.3.4.14項

Oracle Hyperion Smart View

ホストの破損については、追加手順は必要ありません。第18.2.7.16項の手順に従ってください。

Oracle HTTP Server

18.3.4.7.1項

Oracle Identity Federation

18.3.4.5.4項

Oracle Identity Manager

18.3.4.5.5項

Oracle Identity Navigator

18.3.4.5.6項

Oracle WebCenter Content: Imaging

ホストの破損については、追加手順は必要ありません。第18.2.7.19項の手順に従ってください。

Oracle Information Rights Management

ホストの破損については、追加手順は必要ありません。第18.2.7.18項の手順に従ってください。

Oracle Internet Directory

18.3.4.5.1項

Oracle Portal

18.3.4.8.1項

Oracle Real-Time Decisions

18.3.4.11項

Oracle Reports

18.3.4.8.3項

Oracle SOA Suite

同じホストにリカバリする場合は、追加手順は必要ありません。第18.3.4.6項の手順に従ってください。

Oracle WebCenter Content

18.3.4.16.1項

Oracle WebCenter Content: Records

18.3.4.16.2項

Oracle Virtual Directory

18.3.4.5.2項

Oracle Web Cache

18.3.4.7.2項

Oracle WebCenter Portalのアクティビティ・グラフ

ホストの破損については、追加手順は必要ありません。第18.2.7.8項の手順に従ってください。

Oracle WebCenter Portal分析

ホストの破損については、追加手順は必要ありません。第18.2.7.9項の手順に従ってください。

18.3.4.1 同じホストへのJavaコンポーネントのリカバリ

Oracle SOA SuiteなどのJavaコンポーネントを同じホストにリカバリする手順は次のとおりです。

1. 第18.2.6.1項の説明に従って、管理対象サーバーをリカバリします。

2. 表18-2に示すように、コンポーネントに追加手順が必要な場合は、それらの手順を実行します。

18.3.4.2 別のホストへのJavaコンポーネントのリカバリ

Oracle SOA SuiteなどのJavaコンポーネントを別のホストにリカバリする手順は次のとおりです。

1. 第18.3.3.2項の説明に従って、管理対象サーバーをリカバリします。

2. 第18.3.5.2項の説明に従って、Fusion Middleware Controlのtargets.xmlファイルを編集します。

ただし、表18-2に示すように、一部のコンポーネントでは追加手順が必要です。

18.3.4.3 同じホストへのシステム・コンポーネントのリカバリ

Oracle HTTP Serverなどのシステム・コンポーネントを同じホストにリカバリするには、次の一般的な手順に従います。ただし、表18-2に示すように、一部のコンポーネントでは追加手順が必要です。

1. 関連するすべてのプロセスを停止します。つまり、このコンポーネントに関連するすべてのプロセスを停止します。たとえば、Oracle HTTP Serverを停止するには、次のコマンドを使用します。

opmnctl stopproc ias-component=component_name

コンポーネントの停止方法の詳細は、第4.3項を参照してください。

2. バックアップからコンポーネント固有のファイルをリカバリします。第16.5項に、各コンポーネントに必要なディレクトリとファイルを示します。たとえば、Oracle HTTP Serverのファイルをリカバリするには、次のディレクトリをリカバリします。

ORACLE_INSTANCE/config/OHS/component_name
ORACLE_INSTANCE/diagnostics/logs/OHS/component_name

3. Oracleインスタンス・ホームが管理サーバーから登録解除されている場合は、Oracleインスタンスを登録します。

opmnctl registerinstance -adminHost admin_server_host
-adminPort admin_server_port -adminUsername username
-adminPasswordFile 'file_with_weblogic_admin_password'
-wlserverHome wlserver_home_location

ファイル・システムのみをリカバリする場合は、Oracleインスタンスを登録する必要はありません。

4. 第4.3項の説明に従って、関連するすべてのプロセスを起動します。

18.3.4.4 別のホストへのシステム・コンポーネントのリカバリ

Oracle HTTP Serverなどのシステム・コンポーネントを別のホストにリカバリするには、次の一般的な手順に従います。ただし、表18-2に示すように、ほとんどのコンポーネントでは追加手順が必要です。

1. 第18.2.1項の説明に従って、Middlewareホームをリカバリします。

2. 関連するすべてのプロセスを起動します。第4.3項に、コンポーネントの起動方法の説明があります。

3. 新しいホストでopmnctl updateinstanceregistrationコマンドを使用して、管理サーバーへのOracleインスタンスの登録を更新します。次に例を示します。

opmnctl updateinstanceregistration -adminHost admin_server_host

このコマンドは、OPMNのinstance.propertiesファイルを更新します。

4. 新しいホストでopmnctl updatecomponentregistrationコマンドを使用して、管理サーバーへのコンポーネントの登録を更新します。たとえば、Oracle Virtual Directoryの登録を更新するには、次のコマンドを使用します。

opmnctl updatecomponentregistration -Host new_host
-componentName ovd1 -componentType OVD

5. 第18.3.5.2項の説明に従って、Fusion Middleware Controlのtargets.xmlファイルを編集します。

18.3.4.5 別のホストへのアイデンティティ管理コンポーネントのリカバリ

ほとんどのアイデンティティ管理コンポーネントでは、第18.3.3.2項の説明に従って、管理対象サーバーをリカバリします。

一部のコンポーネントでは、次の各項で説明しているように、別のホストへのリカバリに追加手順が必要です。

- 別のホストへのOracle Internet Directoryのリカバリ

- 別のホストへのOracle Virtual Directoryのリカバリ

- 別のホストへのOracle Directory Integration Platformのリカバリ

- 別のホストへのOracle Identity Federationのリカバリ

- 別のホストへのOracle Identity Managerのリカバリ

- 別のホストへのOracle Identity Navigatorのリカバリ

- 別のホストへのOracle Access Managerのリカバリ

- 別のホストへのOracle Adaptive Access Managerのリカバリ

18.3.4.5.1 別のホストへのOracle Internet Directoryのリカバリ

別のホストにOracle Internet Directoryをリカバリする手順は次のとおりです。

1. 第18.3.4.4項の説明に従って、コンポーネントをリカバリします。

2. UNIXシステムおよびLinuxシステムでは、Oracle Internet Directoryの起動を試行する前に、次のファイルを、root権限を持つように設定します。

ORACLE_HOME/bin/oidldapd

次に例を示します。

chown root oidldapd
chmod 4710 oidldapd

3. 第18.3.5.3項の説明に従って、Oracle Management Agentをリカバリします。

4. Oracle Directory Services Managerがデプロイされている管理対象サーバーを別のサーバーに移動し、SSLを有効にする場合は、新しいホスト上の次のファイルを削除する必要があります。

DOMAIN_HOME/servers/wls_ods1/tmp/_WL_user/odsm_version/randomid/war/conf/odsm.cer

Oracle Directory Services Managerでは、このファイルがキーストアおよびトラスト・ストアとして使用され、パスワードがJKSに格納されます。ただし、Oracle Directory Services Managerが別のホストにコピーされ、起動された場合は、別のパスワードが生成されます。このファイルを削除すると、Oracle Directory Services Managerの起動時に、新しいパスワードとともに新しいファイルが作成されます。

18.3.4.5.2 別のホストへのOracle Virtual Directoryのリカバリ

別のホストにOracle Virtual Directoryをリカバリする手順は次のとおりです。

1. 第18.3.4.4項の説明に従って、コンポーネントをリカバリします。

2. 第18.3.5.3項の説明に従って、Oracle Management Agentをリカバリします。

18.3.4.5.3 別のホストへのOracle Directory Integration Platformのリカバリ

別のホストにOracle Directory Integration Platformをリカバリする手順は次のとおりです。

1. 第18.3.3.2項の説明に従って、管理対象サーバーをリカバリします。

2. 管理対象サーバーを起動する前に、次のディレクトリにあるファイルをリストアします。

DOMAIN_HOME/servers/wls_ods1/stage/DIP/11.1.1.1.0/

3. 管理対象サーバーおよびOracleインスタンスを起動します。

4. Oracle Internet Directoryも別のホストに移動する場合は、管理対象サーバーとOracleインスタンスの起動直後に次のコマンドを実行します。

set ORACLE_HOME Oracle_home_path
set WLS_HOME WLS_Home_path
cd ORACLE_HOME/bin
./manageDIPServerConfig set -h dip_server_host -p dip_server_port
-D weblogic_user -attribute oidhostport -value oid_host:oid_ssl_port

manageDIPServerConfigコマンドから、パスワードの入力を求められます。

次に例を示します。

./manageDIPServerConfig set -h hostname -p 19523 -D weblogic
-attribute oidhostport -value hostname.domain.com:24163

5. 新しいホストでopmnctl registerinstanceコマンドを使用して、Oracleインスタンスをそのすべてのコンポーネントとともに、管理サーバーに登録します。次に例を示します。

opmnctl registerinstance -adminHost admin_server_host
-adminPort admin_server_port -adminUsername username
-adminPasswordFile 'file_with_weblogic_admin_password'
-wlserverHome wlserver_home_location

18.3.4.5.4 別のホストへのOracle Identity Federationのリカバリ

Oracle Identity FederationではSSO機能が提供されるため、ホスト破損からのリカバリの一環としてOracle Identity Federationを実行しているホストの名前を変更すると、リモート・パートナが影響を受けます。この場合、リモート・パートナで操作を続行するには、リモート・パートナでホスト名に関する変更を加える必要があります。リモート・パートナでデータを更新するには数日かかる場合があり、これは許容できない生産性の低下を招くことにもなりかねません。スタンドアロンのOracle Identity Federationサーバーのホスト名は変更しないことを強くお薦めします。

ロード・バランサが環境の一部であり、Oracle Identity FederationをリカバリしているホストがVIPのリストに含まれている場合は、ホスト名の変更は必要ありません。

Oracle Identity Federationのスタンドアロン・インストールの場合は、影響を最小限に抑えるために、同じ名前の新しいホストを使用することをお薦めします。ただし、どのような理由であれ、リカバリしているOracle Identity Federationに別のホスト名を使用する必要がある場合は、Oracle Identity Federationおよびリモート・パートナに対してホスト名を手動で更新する必要があります。

別のホストにOracle Identity Federationをリカバリする手順は次のとおりです。

1. 第18.3.3.2項の説明に従って、管理対象サーバーをリカバリします。

2. 第18.3.5.3項の説明に従って、Oracle Management Agentをリカバリします。

3. 新しいホストでopmnctl registerinstanceコマンドを使用して、Oracleインスタンスをそのすべてのコンポーネントとともに、管理サーバーに登録します。次に例を示します。

opmnctl registerinstance -adminHost admin_server_host
-adminPort admin_server_port -adminUsername username
-adminPasswordFile 'file_with_weblogic_admin_password'
-wlserverHome wlserver_home_location

4. 更新されたデータをリモート・パートナに提供します。

5. Fusion Middleware Controlを使用して、ホスト名を変更します。

1. ナビゲーション・ペインで、ファームを開いてから、「Identity and Access」を開きます。

2. Oracle Identity Federationインスタンスを選択します。

3. 「Oracle Identity Federation」メニューで、「管理」→「サーバー・プロパティ」を選択します。
「サーバー・プロパティ」ページが表示されます。

4. 「ホスト」で、以前のホスト名を新しいホスト名に置き換えます。

5. ポート番号が変更されている場合は、「ポート」のポート番号を置き換えます。

6. SOAPポート番号が変更されている場合は、「SOAPポート」のポート番号を置き換えます。

7. 「アイデンティティ・プロバイダ」→「共通」を選択します。「プロバイダID」を新しいホスト名に変更します。

8. 「サービス・プロバイダ」→「共通」を選択します。「プロバイダID」を新しいホスト名に変更します。

9. LDAPがデータ・ストアの場合は、「データ・ストア」を選択します。ユーザー・データ・ストアおよびフェデレーション・データ・ストアに対する接続URLの値を、新しいホスト名に変更します。

10. 「認証エンジン」→「LDAPディレクトリ」を選択します。「接続URL」を新しいホスト名に設定します。

11. 「適用」をクリックします。

12. Oracle Identity Federationのデプロイ先の管理対象サーバーを再起動します。

DOMAIN_HOME/bin/startManagedWebLogic.sh managed_server_name
admin_url

6. Oracle Identity FederationがSSLサーバーとして機能している場合は、Oracle Identity Federationからクライアントに示されているSSL証明書を、新しいホスト名を持つ新しい証明書に置き換える必要があります。そうしないと、クライアントによるホスト名の検証が失敗する場合があります。

18.3.4.5.5 別のホストへのOracle Identity Managerのリカバリ

別のホストにOracle Identity Managerをリカバリする手順は次のとおりです。

1. 第18.3.2項の説明に従って、ドメインをリストアします。

2. 第18.2.3項の説明に従って、Oracleホームをリストアします。

3. 必要に応じて、OIM、OID、MDSおよびSOAINFRAスキーマが含まれるデータベースをリストアします。第18.2.10項を参照してください。

4. Oracle Identity ManagerデータベースとLDAPプロバイダを同期します。詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverコマンド・リファレンス』を参照してください。

5. weblogicExportMetadata.shスクリプトを使用して、oim-config.xmlファイルをエクスポートします。SOA URLのホスト名またはIPアドレスを変更することによって、エクスポートしたファイルを編集します。weblogicImportMetadata.shスクリプトを使用して、このファイルをMDSにインポートします。

6. 第18.3.5.5項の説明に従って、新しいホスト名で新しいマシンを作成します。

7. 第18.3.5.6項の説明に従って、WebLogicユーザーを任意のグループに再関連付けします。

18.3.4.5.6 別のホストへのOracle Identity Navigatorのリカバリ

別のホストにOracle Identity Navigatorをリカバリする手順は次のとおりです。

1. 第18.3.5.5項の説明に従って、新しいホスト名で新しいマシンを作成します。

2. 第18.3.5.6項の説明に従って、WebLogicユーザーを任意のグループに再関連付けします。

18.3.4.5.7 別のホストへのOracle Access Managerのリカバリ

別のホストにOracle Access Managerをリカバリする手順は次のとおりです。

1. 第18.2.7.5項の手順に従います。

2. WLSエージェントをリストアするには、第18.3.3.2項の説明に従って、管理対象サーバーをリストアします。

3. Oracle Access Managerコンソールにログインします。

4. ホスト名を変更して、Oracle Access Managerプロキシ・サーバーの新しいホスト名を指定します。Oracle Fusion Middleware Oracle Access ManagerおよびOracle Security Token Service管理者ガイドの個々のOAMサーバーおよびプロキシ設定の表示または編集に関する項を参照してください。

5. オプションで、ロード・バランサがある場合、ホスト名を変更します。Oracle Fusion Middleware Oracle Access ManagerおよびOracle Security Token Service管理者ガイドのAccess Managerのロード・バランシングおよびセキュア・エラー・モードの管理に関する項を参照してください。

6. 保護されているページがある場合、 Oracle Single Sign-OnまたはWebGateをOracle Access Managerでのパートナとして再び登録する必要があります。

1. Oracle Access Managerコンソールにログインします。

2. 「システム構成」タブを選択し、「Access Manager」を選択します。

3. すべての構成済SSOエージェントの場合、新しいホストの名前ですべてのホスト名を更新します。

- 設定されている場合、「サーバー・リスト」は新しいホスト名を参照します。

- 設定されている場合、ユーザー定義パラメータは新しいホスト名を参照します。

- 設定されている場合、ログアウトのリダイレクトURLは新しいホスト名を参照します。

または、Oracle Fusion Middleware Oracle Access ManagerおよびOracle Security Token Service管理者ガイドのリモート登録ツールに関する項の説明に従って、oamregツールを使用できます。同じマニュアルのOSSOリモート登録リクエストに関する項も参照してください。

7. 第18.3.5.5項の説明に従って、新しいホスト名で新しいマシンを作成します。

8. Webゲート構成ファイルのObAccessClient.xmlを編集して、Oracle Access Managerサーバーのホスト名を更新します。このファイルは、次のディレクトリにあります。

DOMAIN_HOME/output/agentName/

9. 第18.3.5.6項の説明に従って、WebLogicユーザーを任意のグループに再関連付けします。

18.3.4.5.8 別のホストへのOracle Adaptive Access Managerのリカバリ

別のホストにOracle Adaptive Access Managerをリカバリする手順は次のとおりです。

1. 第18.2.7.6項の手順に従います。

2. 第18.3.5.5項の説明に従って、新しいホスト名で新しいマシンを作成します。

3. 第18.3.5.6項の説明に従って、WebLogicユーザーを任意のグループに再関連付けします。

18.3.4.6 ホスト破損後のOracle SOA Suiteのリカバリ

Oracle SOA Suiteがドメイン内で構成されており、どの管理対象サーバーもドメイン・ディレクトリを管理サーバーと共有していない場合は、第18.3.3.3項で説明している手順に従ってください。それ以外の場合は、この項の手順に従ってください。

同じホストにOracle SOA Suite管理対象サーバーをリカバリするには、第18.3.3.1項の説明に従って、管理対象サーバーをリカバリします。

ホストの破損後に別のホストにOracle SOA Suite管理対象サーバーをリカバリする手順は次のとおりです。

1. リカバリを実行する前に、新しいホスト名とポートを指すようにWSDLファイルを更新します。

2. 第18.3.3.2項の説明に従って、管理対象サーバーをリカバリします。

3. Oracle SOA Suite管理対象サーバーのリカバリ後に、次の操作を実行します。

- antコマンドを使用してコンポジットをデプロイする場合は、deploy-sar.xmlファイルを編集します。このファイルは次の場所にあります。

(UNIX) ORACLE_HOME/bin
(Windows) ORACLE_HOME\bin

次の行で、以前のホスト名を新しいホスト名に置き換えます。

<property name="wlsHost" value="newhostname"/>

ロード・バランサを使用する場合は、このプロパティは変更しないでください。かわりに、新しいホストをロード・バランサに登録します。

- SOAインフラMBeanでホスト名を変更します。

1. Fusion Middleware Controlで、管理対象サーバーにナビゲートします。

2. 「WebLogicサーバー」メニューから、「システムMBeanブラウザ」を選択します。

3. 「アプリケーション定義のMBean」→「oracle.as.soainfra.config」→「サーバー: server_name」→「SoaInfraConfig」を開きます。「soa-infra」を選択します。

4. 「属性」タブで、「ServerURL」をクリックします。ServerURL属性に値が含まれている場合は、ホスト名を新しいホスト名に変更します。

5. 「適用」をクリックします。

- WSDLファイルが新しいホスト名に更新されたアプリケーションをすべて再デプロイします。

注意:

環境にロード・バランサが構成されておらず、Oracle SOA Suiteを別のホストにリカバリする必要がある場合、タスク・フローからのレスポンスおよび非同期レスポンスを保留している進行中のインスタンスはリカバリされません。ロード・バランサを使用して、別のホストにリカバリできるようにすることをお薦めします。

環境にロード・バランサが構成されている場合は、次の追加手順を実行します。

1. Oracle WebLogic Server管理サーバーにログインします。

2. ドメイン構造で、「サーバー」にナビゲートします。管理対象サーバーごとに「プロトコル」タブ→「HTTP」タブを選択します。

3. 「フロントエンド・ホスト」に、新しいホスト名を入力します。

4. 「フロントエンドHTTPポート」および「フロントエンドHTTPSポート」(該当する場合)に、新しいポート番号を入力します。

5. 管理対象サーバーをそれぞれ再起動します。

18.3.4.7 別のホストへのWeb層コンポーネントのリカバリ

Web層は、Oracle HTTP ServerとOracle Web Cacheで構成されています。次の各項目で、これらのコンポーネントを別のホストにリカバリする方法について説明します。

- 別のホストへのOracle HTTP Serverのリカバリ

- 別ホストへのOracle Web Cacheのリカバリ

18.3.4.7.1 別のホストへのOracle HTTP Serverのリカバリ

別のホストにOracle HTTP Serverをリカバリする手順は次のとおりです。

1. 第18.3.4.4項の説明に従って、コンポーネントをリカバリします。

2. 第18.3.5.3項の説明に従って、Oracle Management Agentをリカバリします。

3. 次のファイルにあるServerNameエントリを、新しいホスト名を持つように変更します。

(UNIX) ORACLE_INSTANCE/config/OHS/ohs_name/httpd.conf
(Windows) ORACLE_INSTANCE\config\OHS\ohs_name\httpd.conf

4. Oracle HTTP Serverを再起動します。

opmnctl startproc ias-component=component_name

18.3.4.7.2 別のホストへのOracle Web Cacheのリカバリ

別のホストにOracle Web Cacheをリカバリする手順は次のとおりです。

1. 第18.3.4.4項の説明に従って、コンポーネントをリカバリします。

2. 第18.3.5.3項の説明に従って、Oracle Management Agentをリカバリします。

3. webcache.xmlファイルを編集して、以前のホスト名を新しいホスト名に置き換えます。このファイルは次の場所にあります。

(UNIX) ORACLE_INSTANCE/config/WebCache/webcache_name
(Windows) ORACLE_INSTANCE\config\WebCache\webcache_name

4. Oracle Web Cacheを再起動します。

opmnctl startproc ias-component=component_name

18.3.4.8 別のホストへのOracle Portal、Oracle Reports、Oracle Forms ServicesおよびOracle Business Intelligence Discovererのリカバリ

次の各項目で、これらのコンポーネントを別のホストにリカバリする方法について説明します。

- 別のホストへのOracle Portalのリカバリ

- 別のホストへのOracle Forms Servicesのリカバリ

- 別のホストへのOracle Reportsのリカバリ

- 別のホストへのOracle Business Intelligence Discovererのリカバリ

18.3.4.8.1 別のホストへのOracle Portalのリカバリ

別のホストにOracle Portalをリカバリする手順は次のとおりです。

1. Middlewareホーム、ドメイン・ディレクトリおよびOracleインスタンス・ディレクトリを新しいホストにリストアします。詳細は、第18.3.3.2項を参照してください。

2. 第18.3.5.3項の説明に従って、Oracle Management Agentをリカバリします。

3. Oracleインスタンスが登録解除されている場合は、新しいホストでopmnctl registerinstanceコマンドを使用して、Oracleインスタンスをそのすべてのコンポーネントとともに、管理サーバーに登録します。次に例を示します。

opmnctl registerinstance -adminHost admin_server_host
-adminPort admin_server_port -adminUsername username
-adminPasswordFile 'file_with_weblogic_admin_password'
-wlserverHome wlserver_home_location

4. 新しいホストでopmnctl updateinstanceregistrationコマンドを使用して、管理サーバーへのOracleインスタンスの登録を更新します。次に例を示します。

opmnctl updateinstanceregistration -adminHost admin_server_host

このコマンドは、OPMNのinstance.propertiesファイルを更新します。

5. 次のファイルを変更して、以前のホスト名を新しいホスト名に置き換えます。

ORACLE_INSTANCE/config/OHS/ohs_name/httpd.conf
ORACLE_INSTANCE/config/OHS/ohs_name/moduleconf/portal.conf

6. ssoregスクリプトを実行します。これは次の場所にあります。

Identity_Management_ORACLE_HOME/sso/bin

次のコマンドを使用します。

ssoreg.sh -site_name newhost:http_listen_port
-mod_osso_url http://newhost:http_listen_port -config_mod_osso TRUE
-oracle_home_path $ORACLE_HOME -config_file any_new_file_path
-admin_info cn=orcladmin -virtualhost -remote_midtier

次に例を示します。

ssoreg.sh -site_name example.com:8090
-mod_osso_url http://example.com:8090 -config_mod_osso TRUE
-oracle_home_path $ORACLE_HOME -config_file /tmp/loh_osso.conf
-admin_info cn=orcladmin -virtualhost -remote_midtier

7. 前の手順のファイルを新しいホストにコピーします。

8. 新しいホストで、次のファイルのOssoConfigFileセクションを変更し、ステップ6のファイルのパスが含まれるようにします。

ORACLE_INSTANCE/config/OHS/ohs1/moduleconf/mod_osso.conf

次に例を示します。

<IfModule mod_osso.c>
OssoIpCheck off
OssoSecureCookies off
OssoIdleTimeout off
OssoConfigFile /tmp/path_of_file_created

9. 次のファイルを編集して、以前のホスト名を新しいホスト名に置き換えます。

- webcache.xml。このファイルは次の場所にあります。

(UNIX) ORACLE_INSTANCE/config/WebCache/webcache_name
(Windows) ORACLE_INSTANCE\config\WebCache\webcache_name

以前のホスト名をすべて新しいホスト名に置き換えます。

- instance.properties。このファイルは次の場所にあります。

(UNIX) ORACLE_INSTANCE/config/OPMN/opmn
(Windows) ORACLE_INSTANCE\config\OPMN\opmn

管理サーバーのホスト名が変更されている場合は、次の行で、以前のホスト名を新しいホスト名に置き換えます。

adminHost=host_name

10. Oracle Portalへのアクセスに使用する公開ホストを変更する場合は、次の手順に従います。これは、Oracle Web CacheとWLS_PORTALの両方が含まれる単一ノード・インストールを使用している場合に発生する可能性があり、これらのプロセスを別のホストに移動する必要があります。別のシナリオは、Oracle Web CacheをノードでWLS_PORTALからリモートで実行しており、Oracle Web Cacheを別のホストに移動する必要がある場合です。いずれの場合も、Oracle Portal内の公開ホスト情報を更新するには次の手順を実行します。(注意: ロード・バランサまたはリバース・プロキシ構成を使用している場合は、これらの手順は必要ありません。)

1. 次のディレクトリからすべてのコンテンツを再帰的に削除します。ただし、ディレクトリ自体を削除しないでください。

ORACLE_INSTANCE/portal/cache

2. Fusion Middleware Controlにログインします。ファームを開き、「Portal」を右クリックします。「設定」→「ワイヤ構成」を選択します。

3. 「ポータル中間層」セクションで、「公開ホスト」を新しいホスト名で更新します。

4. 「Oracle Web Cache」セクションで、「ホスト」を新しいホスト名で更新します。

11. WLS_PORTALインスタンスを再起動します。

18.3.4.8.2 別のホストへのOracle Forms Servicesのリカバリ

別のホストにOracle Forms Servicesをリカバリする手順は次のとおりです。

1. 第18.3.3.2項の説明に従って、管理対象サーバーをリカバリします。

2. 第18.3.5.3項の説明に従って、Oracle Management Agentをリカバリします。

3. 新しいホストでopmnctl registerinstanceコマンドを使用して、Oracleインスタンスをそのすべてのコンポーネントとともに、管理サーバーに登録します。次に例を示します。

opmnctl registerinstance -adminHost admin_server_host
-adminPort admin_server_port -adminUsername username
-adminPasswordFile 'file_with_weblogic_admin_password'
-wlserverHome wlserver_home_location

4. 次のファイルを編集して、以前のホスト名を新しいホスト名に置き換えます。

- webcache.xml。このファイルは次の場所にあります。

(UNIX) ORACLE_INSTANCE/config/WebCache/webcache_name
(Windows) ORACLE_INSTANCE\config\WebCache\webcache_name

以前のホスト名をすべて新しいホスト名に置き換えます。

- instance.properties。このファイルは次の場所にあります。

(UNIX) ORACLE_INSTANCE/config/OPMN/opmn
(Windows) ORACLE_INSTANCE\config\OPMN\opmn

管理サーバーのホスト名が変更されている場合は、次の行で、以前のホスト名を新しいホスト名に置き換えます。

adminHost=host_name

- forms.conf。このファイルは次の場所にあります。

(UNIX) ORACLE_INSTANCE/config/OHS/ohs_name/moduleconf
(Windows) ORACLE_INSTANCE\config\OHS\ohs_name\moduleconf

WebLogicHostパラメータ内のホスト名を新しいホスト名に置き換えます。

5. 管理サーバーのホストで、次のファイルを編集します。

DOMAIN_HOME/opmn/topology.xml

Oracle Forms Servicesの<ias-component id>要素のプロパティを追加します。次の例は、変更後の要素を示しています。

</ias-component>
<ias-component id="forms" type="FormsComponent" >
<em-properties>
<property name="OracleHome" value="/path_to_oracle_home" />
<property name="instName" value="instance_name" />
<property name="EMTargetType" value="oracle_forms" />
<property name="version" value="11.1.1" />
</em-properties>
</ias-component>

6. Oracleインスタンスをリカバリした新しいホストで、opmnctl updatecomponentregistrationコマンドを使用して、管理サーバーへのコンポーネントの登録を更新します。
次に例を示します。

opmnctl updatecomponentregistration -Host new_host -Port nonSSLPort
-componentName forms -componentType FormsComponent

7. ssoregスクリプトを実行します。これは次の場所にあります。

Identity_Management_ORACLE_HOME/sso/bin

次のコマンドを使用します。

ssoreg.sh -site_name newhost:http_listen_port
-mod_osso_url http://newhost:http_listen_port -config_mod_osso TRUE
-oracle_home_path $ORACLE_HOME -config_file any_new_file_path
-admin_info cn=orcladmin -virtualhost -remote_midtier

次に例を示します。

ssoreg.sh -site_name example.com:8090
-mod_osso_url http://example.com:8090 -config_mod_osso TRUE
-oracle_home_path $ORACLE_HOME -config_file /tmp/loh_osso.conf
-admin_info cn=orcladmin -virtualhost -remote_midtier

8. 前の手順のファイルを新しいホストにコピーします。

9. 新しいホストで、次のファイルのOssoConfigFileセクションを変更し、ステップ7のファイルのパスが含まれるようにします。

ORACLE_INSTANCE/config/OHS/ohs1/moduleconf/mod_osso.conf

次に例を示します。

<IfModule mod_osso.c>
OssoIpCheck off
OssoSecureCookies off
OssoIdleTimeout off
OssoConfigFile /tmp/path_of_file_created

18.3.4.8.3 別のホストへのOracle Reportsのリカバリ

別のホストにOracle Reportsをリカバリする手順は次のとおりです。

1. 第18.3.3.2項の説明に従って、管理対象サーバーをリカバリします。

2. 第18.3.5.3項の説明に従って、Oracle Management Agentをリカバリします。

3. 新しいホストでopmnctl registerinstanceコマンドを使用して、Oracleインスタンスをそのすべてのコンポーネントとともに、管理サーバーに登録します。次に例を示します。

opmnctl registerinstance -adminHost admin_server_host
-adminPort admin_server_port -adminUsername username
-adminPasswordFile 'file_with_weblogic_admin_password'
-wlserverHome wlserver_home_location

4. 次のファイルを編集して、以前のホスト名を新しいホスト名に置き換えます。

- reports_install.properties。このファイルは次の場所にあります。

(UNIX) ORACLE_INSTANCE/reports
(Windows) ORACLE_INSTANCE\reports

SERVER_NAME、OHS_HOSTおよびREPORTS_MANAGED_WLS_HOSTの各パラメータを編集します。

- webcache.xml。このファイルは次の場所にあります。

(UNIX) ORACLE_INSTANCE/config/WebCache/webcache_name
(Windows) ORACLE_INSTANCE\config\WebCache\webcache_name

以前のホスト名をすべて新しいホスト名に置き換えます。

- instance.properties。このファイルは次の場所にあります。

(UNIX) ORACLE_INSTANCE/config/OPMN/opmn
(Windows) ORACLE_INSTANCE\config\OPMN\opmn

管理サーバーのホスト名が変更されている場合は、次の行で、以前のホスト名を新しいホスト名に置き換えます。

adminHost=host_name

- reports_ohs.conf。このファイルは次の場所にあります。

(UNIX) ORACLE_INSTANCE/config/OHS/ohs_name/moduleconf
(Windows) ORACLE_INSTANCE\config\OHS\ohs_name\moduleconf

- rwservlet.properties。このファイルは次の場所にあります。

(UNIX) DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration
(Windows) DOMAIN_HOME\config\fmwconfig\servers\server_name\applications\reports_version\configuration

ファイル内で、<server>要素を変更して、新しいホスト名を使用します。

5. 次のディレクトリで、新しいホスト名を含むようにサブディレクトリの名前を変更します。

(UNIX) ORACLE_INSTANCE/diagnostics/logs/ReportsServer
(Windows) ORACLE_INSTANCE\diagnostics\logs\ReportsServer

6. 次のディレクトリで、old_host_name.datファイルの名前を新しいホスト名に変更します。

(UNIX) ORACLE_INSTANCE/reports/server
(Windows) ORACLE_INSTANCE\reports\server

7. 次のディレクトリで、新しいホスト名を含むようにサブディレクトリの名前を変更します。

(UNIX) ORACLE_INSTANCE/config/ReportsServer
(Windows) ORACLE_INSTANCE\config\ReportsServer

8. ssoregスクリプトを実行します。これは次の場所にあります。

Identity_Management_ORACLE_HOME/sso/bin

次のコマンドを使用します。

ssoreg.sh -site_name newhost:http_listen_port
-mod_osso_url http://newhost:http_listen_port -config_mod_osso TRUE
-oracle_home_path $ORACLE_HOME -config_file any_new_file_path
-admin_info cn=orcladmin -virtualhost -remote_midtier

次に例を示します。

ssoreg.sh -site_name example.com:8090
-mod_osso_url http://example.com:8090 -config_mod_osso TRUE
-oracle_home_path $ORACLE_HOME -config_file /tmp/loh_osso.conf
-admin_info cn=orcladmin -virtualhost -remote_midtier

9. 前の手順のファイルを新しいホストにコピーします。

10. 新しいホストで、次のファイルのOssoConfigFileセクションを変更し、ステップ8のファイルのパスが含まれるようにします。

ORACLE_INSTANCE/config/OHS/ohs1/moduleconf/mod_osso.conf

次に例を示します。

<IfModule mod_osso.c>
OssoIpCheck off
OssoSecureCookies off
OssoIdleTimeout off
OssoConfigFile /tmp/path_of_file_created

11. 次のファイルで、ホスト名を新しいホスト名に置き換えます。

(UNIX) DOMAIN_HOME/servers/server_name/tmp/_WL_user/reports_version/random_string/META-INF/mbeans.xml
(Windows) DOMAIN_HOME\servers\server_name\tmp\_WL_user\reports_version\random_string\META-INF\mbeans.xml

12. 次のファイルで、ホスト名を新しいホスト名に置き換えます。

(UNIX) DOMAIN_HOME/sysman/state/targets.xml
(Windows) DOMAIN_HOME\sysman\state\targets.xml

次のような文字列で始まる要素内のホスト名を変更します。

<Target TYPE="oracle_repapp" ..>
<Target TYPE="oracle_repserv" ..>

18.3.4.8.4 別のホストへのOracle Business Intelligence Discovererのリカバリ

別のホストにOracle Business Intelligence Discovererをリカバリする手順は次のとおりです。

1. 第18.3.3.2項の説明に従って、管理対象サーバーをリカバリします。

2. 第18.3.5.3項の説明に従って、Oracle Management Agentをリカバリします。

3. 新しいホストでopmnctl registerinstanceコマンドを使用して、Oracleインスタンスをそのすべてのコンポーネントとともに、管理サーバーに登録します。次に例を示します。

opmnctl registerinstance -adminHost admin_server_host
-adminPort admin_server_port -adminUsername username
-adminPasswordFile 'file_with_weblogic_admin_password'
-wlserverHome wlserver_home_location

4. 次のファイルを編集して、以前のホスト名を新しいホスト名に置き換えます。

- module_disco.conf。このファイルは次の場所にあります。

(UNIX) ORACLE_INSTANCE/config/OHS/ohs_name//moduleconf
(Windows) ORACLE_INSTANCE\config\OHS\ohs_name\moduleconf

- webcache.xml。このファイルは次の場所にあります。

(UNIX) ORACLE_INSTANCE/config/WebCache/webcache_name
(Windows) ORACLE_INSTANCE\config\WebCache\webcache_name

以前のホスト名をすべて新しいホスト名に置き換えます。

5. ssoregスクリプトを実行します。これは次の場所にあります。

Identity_Management_ORACLE_HOME/sso/bin

次のコマンドを使用します。

ssoreg.sh -site_name newhost:http_listen_port
-mod_osso_url http://newhost:http_listen_port -config_mod_osso TRUE
-oracle_home_path $ORACLE_HOME -config_file any_new_file_path
-admin_info cn=orcladmin -virtualhost -remote_midtier

次に例を示します。

ssoreg.sh -site_name example.com:8090
-mod_osso_url http://example.com:8090 -config_mod_osso TRUE
-oracle_home_path $ORACLE_HOME -config_file /tmp/loh_osso.conf
-admin_info cn=orcladmin -virtualhost -remote_midtier

6. 前の手順のファイルを新しいホストにコピーします。

7. 新しいホストで、次のファイルのOssoConfigFileセクションを変更し、ステップ5のファイルのパスが含まれるようにします。

ORACLE_INSTANCE/config/OHS/ohs1/moduleconf/mod_osso.conf

次に例を示します。

<IfModule mod_osso.c>
OssoIpCheck off
OssoSecureCookies off
OssoIdleTimeout off
OssoConfigFile /tmp/path_of_file_created

18.3.4.9 別のホストへのOracle BI Enterprise Editionのリカバリ

Oracle BI EEを別のホストにリカバリできます。

次の各項目で、Oracle BI EEを同じ名前の別のホストに移動する方法について説明します。

- 非クラスタ環境での別のホストへのOracle BI EEのリカバリ

- クラスタ環境での別のホストへのOracle BI EEのリカバリ

18.3.4.9.1 非クラスタ環境での別のホストへのOracle BI EEのリカバリ

別のホストにOracle BI EEをリカバリする手順は、オペレーティング・システムによって異なります。ホスト名は元のホストと同じ名前にする必要があります。

- UNIXでは、次の手順に従います。

1. 第18.2.1項の説明に従って、Middlewareホームをバックアップからリストアします。

2. 必要に応じて、Oracle BI EEスキーマが含まれるデータベースをリストアします。第18.3.6項を参照してください。

- Windowsでは、次の手順に従います。

1. 第18.2.1項の説明に従って、Middlewareホームをバックアップからリストアし、作成したMiddlewareホームを新しいインストールで上書きします。

2. 必要に応じて、Oracle BI EEスキーマが含まれるデータベースをリストアします。第18.3.6項を参照してください。

3. 次のファイルを実行して、MicrosoftのC++ライブラリをインストールします。

Oracle_BI\bifoundation\install\vc80\vcredist_x86.exe

4. 第18.3.4.9.4項の説明に従って、新しいホストにエクスポートしたレジストリ・エントリをインポートします。

18.3.4.9.2 クラスタ環境での別のホストへのOracle BI EEのリカバリ

このシナリオでは、ホストAとホストBの2つのホストにOracle BI EEクラスタがある場合を考えます。ホストAにはinstance1が含まれ、ホストBにはinstance2が含まれています。なんらかの理由(ホストのクラッシュなど)により、ホストAが置き換えられたため、ホストCにリカバリし、ホストCにinstance3が含まれるようにシステムをスケールアウトする必要があります。

次の手順を実行します。

1. 第18.2.1項の説明に従って、MiddlewareホームをバックアップからホストCにリストアします。

2. 必要に応じて、Oracle BI EEスキーマが含まれるデータベースをリストアします。第18.3.6項を参照してください。

3. Windowsでは、次のファイルを実行して、MicrosoftのC++ライブラリをインストールします。

Oracle_BI\bifoundation\install\vc80\vcredist_x86.exe

4. Windowsでは、第18.3.4.9.4項の説明に従って、新しいホストにエクスポートしたレジストリ・エントリをインポートします。

5. 障害が発生したノードに管理サーバーが含まれている場合、第18.3.2.2項のステップ1から5の説明に従ってリカバリします。

6. Oracle Fusion Middleware Oracle Business Intelligenceエンタープライズ・デプロイメント・ガイドのAPPHOST2上のBIシステムのスケールアウトに関する項の説明に従って、Oracle BI EEシステムをスケールアウトします。

次の点に注意してください。

- ドメイン・ホームおよびアプリケーション・ホームのディレクトリの指定を入力する場合、存在していないディレクトリまたは空のディレクトリの指定を入力します。

- ドメイン・ホーム・フィールドが空の場合は、ドメイン・ディレクトリを含むように次のファイルを更新します。

MW_HOME/wlserver_10.3/common/nodemanager/nodemanager.domains

ノード・マネージャを起動する前に、次の手順を実行します。

1. ノード・マネージャが実行されている場合は、停止します。

2. ノード・マネージャを起動する前に、ORACLE_COMMON_HOME/common/binディレクトリにあるsetNMProps.shスクリプトを実行し、StartScriptEnabledプロパティをtrueに設定します。

cd ORACLE_COMMON_HOME/common/bin
./setNMProps.sh

3. ノード・マネージャを再起動し、次のコマンドを使用して動的登録を有効にします。

cd WL_HOME/server/bin
export JAVA_OPTIONS=-DDomainRegistrationEnabled=true
./startNodeManager.sh

注意:

管理サーバーを管理するノード・マネージャの起動時には、-DDomainRegistrationEnabled=trueを設定することが重要です。コンピュータ上に管理サーバーがなく、このコンピュータが管理サーバーのフェイルオーバー・ノードでない場合、ノード・マネージャは次のように起動できます。

./startNodeManager.sh

7. Oracle Fusion Middleware Oracle Business Intelligenceエンタープライズ・デプロイメント・ガイドのシステム・コンポーネントのスケールアウトに関する項の説明に従って、システム・コンポーネントをスケールアウトします。それらの構成を変更すると、Fusion Middleware Controlに、各インスタンスの再起動を求めるプロンプトが表示されます。インスタンスを再起動します。

ホストAのinstance1は使用できないので、BIサーバー、プレゼンテーション・サービス、およびJavaHostの数を0に変更する必要があります。それらの構成を変更すると、Fusion Middleware Controlに、各インスタンスの再起動を求めるプロンプトが表示されます。インスタンスを再起動します。

8. Fusion Middleware Controlを使用して、instance2をプライマリ・インスタンスに、instance3をセカンダリ・インスタンスにします。

1. instance 2をプライマリ・インスタンスにし、セカンダリ・インスタンスにはなにも指定しません。Fusion Middleware Controlのプロンプトに表示されたとおりにインスタンスをアクティブ化し、再起動します。

2. instance3をセカンダリ・インスタンスにします。Fusion Middleware Controlのプロンプトに表示されたとおりにインスタンスをアクティブ化し、再起動します。

詳細は、Oracle Fusion Middleware Oracle Business Intelligenceエンタープライズ・デプロイメント・ガイドのシングルトン・システム・コンポーネントのセカンダリ・インスタンスの構成に関する項を参照してください。

9. Oracle Fusion Middleware Oracle Business Intelligenceエンタープライズ・デプロイメント・ガイドのbi_server2管理対象サーバーのリスニング・アドレスの設定に関する項の説明に従って、bi_servern管理対象サーバーのリスニング・アドレスを設定します。

10. Oracle Fusion Middleware Oracle Business Intelligenceエンタープライズ・デプロイメント・ガイドのbi_server2管理対象サーバーのホスト名検証の無効化に関する項の説明に従って、bi_servern管理対象サーバーのホスト名検証を無効にします。

11. 環境に応じて、Oracle Fusion Middleware Oracle Business Intelligenceエンタープライズ・デプロイメント・ガイドのOracle Business Intelligenceの可用性のための追加構成の実行に関する項の説明に従って、追加構成を実行します。

12. Oracle HTTP Serverがインストールされている場合は、『Oracle Fusion Middleware Oracle Business Intelligenceエンタープライズ・デプロイメント・ガイド』の管理コンソールのフロントエンドURLに関する項の説明に従って、Oracle BI SearchのURLが正しく設定されるようにOracle WebLogic ServerクラスタのフロントエンドHTTPホストおよびポートを設定します。

13. Oracle Fusion Middleware Oracle Business Intelligenceエンタープライズ・デプロイメント・ガイドの管理対象サーバーのノード・マネージャの構成に関する項の説明に従って、管理対象サーバーのノード・マネージャを構成します。

14. Oracle BI EE管理対象サーバーおよびすべてのOPMNの管理対象コンポーネントを起動します。

18.3.4.9.3 Oracle BI EEのリカバリの追加手順

環境に応じて、第18.3.4.9.2項の手順を実行した後に、追加手順を実行する必要がある場合があります。

- ホストにマスターBIサーバー、プライマリ・クラスタ・コントローラ、およびプライマリOracle BIスケジューラが含まれている環境で障害が発生したときに、新しいインスタンスをマスターBIサーバーにする必要がある場合、必要に応じて次の手順を実行します。インスタンス2を引き続きマスターBIサーバーにする場合は、この追加手順を実行する必要はありません。

- マスターBIサーバーが失われた場合、次の手順を実行します。

1. すべてのノードでOracle WebLogic ServerおよびOPMNプロセスを停止します。

2. 新しいマスターBIサーバーを指定するように次の構成ファイルを更新します。

DOAMIN_HOME/config/fmwconfig/biee-domain.xml

<AvailabilityOptions>セクションで、次のように編集します。

masterBIServerOracleInstanceId="instance_name"
masterBIServerComponentId="component_id"

また、次の設定も更新します。

<OracleInstance id="instance1" host="hostname"
instanceHome="path_to_instance_home" opmnLocalPort="9500" opmnRemotePort="number">
<SchedulerOptions dataSource="(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=hostname(PORT=number)))

3. 他のホストにファイルをコピーします。

4. 管理サーバーおよび管理対象サーバーを再起動します。

- プライマリ・クラスタ・コントローラまたはスケジューラが失われた場合、スタンバイ・クラスタ・コントローラまたはスケジューラにフェイルオーバーされます。これはプライマリ・クラスタ・コントローラになるように再構成するか、プライマリ・コンポーネントに障害が発生しているために有効にされているセカンダリのままにするかを決定する必要があります。Oracle Fusion Middleware Oracle Business Intelligenceエンタープライズ・デプロイメント・ガイドのシングルトン・システム・コンポーネントのセカンダリ・インスタンスの構成に関する項を参照してください。

- 障害が発生したホストにBIサーバー、セカンダリ・クラスタ・コントローラ、およびセカンダリOracle BIスケジューラが含まれる場合、セカンダリ・クラスタ・コントローラまたはスケジューラとして新しいホストを指定します。

- 障害が発生したホストにBIサーバーおよびBIプレゼンテーション・サービスやBI Javaホストなどのシステム・コンポーネントが含まれる場合、追加手順は不要です。

- 障害が発生したホストに次の関連するコンポーネントが含まれる場合、それらをリカバリします。

- Oracle Business Intelligence Publisher: 第18.3.4.10項を参照

- Oracle Real-Time Decisions: 第18.3.4.11項を参照

- Oracle Essbase: 第18.3.4.12項を参照

- Oracle Hyperion Calculation Manager: 第18.3.4.13項を参照

- Oracle Hyperion Financial Reporting: 第18.3.4.14項を参照

- Oracle Hyperion Smart View: 第18.2.7.16項を参照

18.3.4.9.4 Oracle BI EEレジストリ・エントリのインポート

Windowsでは、Oracle BI EEレジストリ・エントリを新しいホストにインポートする必要があります。第17.3.3項には元のホストからそれらをエクスポートする方法が説明されています。

1. 元のホストからエクスポートされたすべてのファイルを新しいホストにコピーします。

2. 元のホストからコピーした各ファイルをダブルクリックします。入力を求められたら「はい」をクリックして、ファイルをレジストリにインポートします。

18.3.4.10 別のホストへのOracle Business Intelligence Publisherのリカバリ

別のホストにOracle Business Intelligence Publisherをリカバリする手順は次のとおりです。

1. 第18.3.3項の説明に従って、Oracle Business Intelligence Publisherコンポーネントが含まれる管理対象サーバーをリカバリします。

2. 必要に応じて、Oracle Business Intelligence Publisherスキーマが含まれるデータベースをリストアします。第18.2.10項を参照してください。

3. Oracle BIプレゼンテーション・サービスに対するサーバー値を変更します。

1. http://hostname:port/xmlpserverでBI Publisherアプリケーションを開いてログインします。

2. 「管理」→「統合」→「Oracle BIプレゼンテーション・サービス」をクリックします。

3. 「サーバー」を新しいホスト名に変更します。

4. 「適用」をクリックします。

4. コールド・フェイルオーバー・クラスタ環境で動作するようにOracle BI Publisherを変換するには、BI SchedulerのJMS構成を変更する必要があります。

1. BI Publisherアプリケーションで、「管理」をクリックします。

2. システム管理セクションで、スケジューラ構成をクリックします。

3. 「Weblogic JNDI URL」を新しいホストURLに変更します。たとえば、t3://hostname:portと指定します。

4. 「適用」をクリックします。

5. コールド・フェイルオーバー・クラスタを使用している場合は、仮想IPアドレスをリスニングするように管理対象サーバーを構成します。『Oracle Fusion Middleware高可用性ガイド』のOracle WebLogic管理対象サーバーの変換に関する項を参照してください。次に、管理コンソールまたはWLSTコマンドラインを使用して、管理対象サーバーを再起動します。

6. BI Publisherでは、BI Enterprise Editionのインスタンスを参照するデータ・ソースを変更するか、作成する必要があります(新規作成する場合は新しい仮想ホストを使用)。データソースを変更する手順は次のとおりです。

1. BI Publisherアプリケーションで、次の手順を実行します。

2. 「データソース」の下にある「JDBC接続」をクリックします。

3. このインスタンスのBI Enterprise Editionのデータ・ソースをすべて編集して、新しいホストに対する値を反映するようにします。

バックアップ・アーティファクトが別の時点からリストアされると、ユーザー・アカウント、ユーザー・レポートおよび権限は、リストアされたバージョンに戻ります。すべてのアーティファクトを同じ時点からリストアします。

18.3.4.11 別のホストへのOracle Real-Time Decisionsのリカバリ

別のホストにOracle Real-Time Decisionsをリカバリする手順は次のとおりです。

1. 第18.3.3項の説明に従って、Oracle Real-Time Decisionsコンポーネントが含まれる管理対象サーバーをリカバリします。

バックアップ・アーティファクトが別の時点からリストアされると、分析モデルで学習期間が失われますが、インテリジェント機能には影響しません。

18.3.4.12 ホスト破損後のOracle Essbaseのリカバリ

Oracle Essbaseがクラスタ環境に配置されており、障害が発生したホストにEssbaseシステム・コンポーネントのクラスタリングが含まれている場合には、OPMNを使用して次の追加手順を実行し、Oracle Essbaseをリカバリします。このシナリオでは、ノードAとノードBにOracle Essbaseのクラスタリングが設定されており、ノードAが破損します。新しいEssbaseコンポーネントをノードCに作成し、Essbaseコンポーネントを含む新しいクラスタをノードCとノードBに作成します。以前のクラスタは使用できないため、決してリカバリしないでください。

1. 第18.3.4.9項の手順6および7の説明に従って、新しいホスト(ノードC)でOracle BI EEシステムとシステム・コンポーネントをスケールアウトします。

2. 共有化されているARBORPATHディレクトリを、ノードBとノードCの両方で、同じパスにマウントします。たとえば、Windowsの場合、ノードBとノードCの両方でYドライブにディレクトリをマップします。

3. ノードBおよびノードCで次のファイルを編集して、adminHostプロパティを更新します。

ORACLE_INSTANCE/config/OPMN/opmn/instance.properties

次に例を示します。

adminHost=ADMINVHN

4. ノードCでウォレットをコピーして、管理サーバーにプッシュします。

1. ノードBからノードCにウォレットをコピーします。ウォレットは次の場所にあります。

ORACLE_INSTANCE/config/OPMN/opmn/wallet

2. opmn.xmlファイルで、ssl enabled="true"になっていることを確認します。

3. 次のコマンドを使用して、管理サーバーにウォレットをプッシュします。

./opmnctl updateinstanceregistration

このコマンドによって、Oracle WebLogic Serverの管理者パスワードの入力を求めるプロンプトが表示されます。updateinstanceregistrationコマンドは、管理サーバーに登録された、Oracleインスタンスの情報を更新します。特に、updateinstanceregistrationコマンドは、登録されたOPMNリモート・ポート、リモート・ホストおよびウォレットを現在のOPMN設定から更新します。

4. すべてのノードでOPMNを再起動します。

opmnctl startall

5. 新しいクラスタにノードBのOracle Essbaseインスタンスを含めるために停止します。

opmnctl stopproc ias-component=essbaseserver1 process-type=Essbase

6. Fusion Middleware Controlにログインし、「Business Intelligence」を開きます。その後、「Business Intelligenceインスタンス」を選択します。

7. 「可用性」タブを選択して、「フェイルオーバー」タブを選択します。「Essbaseエージェント」セクションで、「共有フォルダ・パス」の値を指定します。

8. 「適用」をクリックして、「変更のアクティブ化」をクリックします。

9. 同じタブの「プライマリ/セカンダリ構成」セクションの「セカンダリ・ホスト / インスタンス」で、ノードCのセカンダリOracle Essbaseインスタンスを選択します。

10. 「適用」をクリックして、「変更のアクティブ化」をクリックします。
Oracle Essbaseインスタンスが作成され、両方のサーバーがクラスタの一部になります。

11. ノードBおよびノードCで、すべてのOPMNコンポーネントを停止し、再起動します。

opmnctl stopall
opmnctl startall

18.3.4.13 ホスト破損後のOracle Hyperion Calculation Managerのリカバリ

ホスト破損後に、Oracle Hyperion Calculation Managerをリカバリするには、第18.2.7.14項の手順に従います。

データベースのリストアが必要な場合は、データベースをリストアし、エクスポートしたファイルからCalculation Managerのルールおよびルール・セットをインポートします。

Calculation Managerで、「ファイル」→「インポート」を選択します。

18.3.4.14 ホスト破損後のOracle Hyperion Financial Reportingのリカバリ

Oracle Hyperion Financial Reportingを含むホストが破損した場合は、同じホストまたは異なるホストにリカバリできます。Oracle Hyperion Financial Reportingをリカバリするには、第18.2.3項の説明に従って、Oracleホームをリカバリし、第18.2.4項の説明に従って、Oracleインスタンスをリカバリします。

データベース・ホストが変更されている場合は、次のコマンドを使用してホスト名を更新します。

Epmsys_registry updateproperty financial_reporting_product/@host new_host
Epmsys_registry updateproperty financial_reporting_product/logical_web_app/@host new_host
Epmsys_registry updateproperty financial_reporting_product/logical_web_app/financial_reporting_web_app@host new_host

18.3.4.15 別のホストへのOracle Data Integratorのリカバリ

別のホストにOracle Data Integratorをリカバリする手順は次のとおりです。

1. データベースを別のホストにリストアする必要がある場合は、第18.3.6項の説明に従って、データベースをリストアします。

2. 第18.2.3項の説明に従って、バックアップからOracle Data IntegratorのOracleホームをリカバリします。

3. 第18.3.2項の説明に従って、ドメインをリストアします。

4. 各スタンドアロン・エージェント、およびOracle WebLogic ServerにデプロイされているOracle Data Integratorアプリケーションを停止します。

5. データベースが別のホストにある場合は、トポロジ内のリポジトリ接続情報を変更します。

1. ODI Studioを使用して、リストアされたOracle Data Integratorリポジトリに接続します。『Oracle Fusion Middleware Oracle Data Integratorのための開発者ガイド』のマスター・リポジトリへの接続に関する項の説明に従って、新しいデータベース・ホストへのマスター・リポジトリの新しい接続を作成します。

2. 作業リポジトリをそれぞれ編集します。「接続」をクリックして、作業リポジトリが含まれる新しいデータベース・ホストを指すJDBC URLが含まれるように接続情報を編集します。

3. 各物理エージェントの構成を編集し、更新したホスト名の値を指定して、ポートの値を変更した場合はポートの値も指定します。

4. スタンドアロン・エージェントのスクリプトが生成されていて、それらに-PORTプロパティが含まれる場合は、-PORTの値を新しいポートの値に変更します。スクリプトの名前は、agentName_agent.shまたはagentName_agent.batです。

6. スタンドアロン・エージェントごとに次のファイルを編集し、データベースが別のホストにある場合は、新しいデータベース・ホストの場所に一致するようにODI_MASTER_URLパラメータを変更します。

oracledi/agent/bin/odiparams.*

7. 次のファイルを編集して、データベース接続情報とポート番号を変更します。

oracledi/agent/bin/odi_opmn_standaloneagent_template.xml

8. Oracle WebLogic Server構成で、新しいデータベース・ホストの場所に一致するようにデータソースを編集します。

9. スタンドアロン・エージェント、およびOracle WebLogic ServerにデプロイされているOracle Data Integratorアプリケーションを再起動します。

18.3.4.16 別のホストへのOracle WebCenter Contentのリカバリ

次の各項で、Oracle WebCenter ContentおよびOracle WebCenter Content: Recordsを別のホストにリカバリする方法について説明します。

- 別のホストへのOracle WebCenter Contentのリカバリ

- ホスト破損後のOracle WebCenter Content: Recordsのリカバリ

18.3.4.16.1 別のホストへのOracle WebCenter Contentのリカバリ

別のホストにOracle WebCenter Contentをリカバリする手順は次のとおりです。

1. データベースを別のホストにリストアする必要がある場合は、第18.3.6項の説明に従って、データベースをリストアします。

2. 第18.3.2項の説明に従って、ドメインをリストアします。

3. ドメイン・ディレクトリにVault、WebLayoutまたはSearchディレクトリが配置されていない場合は、必要に応じてそれらのディレクトリをリストアします。たとえば、Vaultディレクトリが/net/home/vault内の共有ドライブに配置されている場合は、バックアップからVaultディレクトリをリストアします。

cd /net/home/vault
tar -xf vault_backup_042012.tar

4. 次のファイルを編集します。

DOMAIN_HOME/ucm_domain/ucm/cs/config/config.cfg

このファイルで、新しいホストを指定するようにHttpServerAddressの設定を変更します。次に例を示します。

HttpServerAddress=hostname:port_number

データベースと共有ファイル・システムは同時にリストアしてください。同時にリストアできない場合は、IDCAnalyseユーティリティを使用して、データベースと共有ファイル・システム間に不一致があるかどうかを特定できます。不一致がある場合は、IDCAnalyseを使用して、手動でリカバリを実行できます。

18.3.4.16.2 ホスト破損後のOracle WebCenter Content: Recordsのリカバリ

Oracle WebCenter Content: Recordsは、Oracle WebCenter Contentに依存しており、追加でバックアップまたはリカバリするアーティファクトがないため、Oracle WebCenter Contentのリカバリ手順(第18.3.4.16.1項)を参照してください。

18.3.5 ホストの破損後にエンティティをリカバリするための追加の操作

リカバリするエンティティによっては、ホストの破損後に追加操作の実行が必要な場合があります。各エンティティに関する項では、示される手順のうち1つ以上を実行する必要がある場合があります。そのような場合は、エンティティをリカバリする方法を説明している項に明記されています。

次の各項目で、実行することが必要な可能性のある操作について説明します。

- 別のホストへのFusion Middleware Controlのリカバリ

- Fusion Middleware Controlのtargets.xmlファイル内のホスト名の変更

- コンポーネントを別のホストにリカバリした場合のOracle Management Agentのリカバリ

- mod_wl_ohs.confファイルの変更

- 特定のコンポーネントの新しいマシンの作成

- Oracleインベントリの更新

- Windowsレジストリのリカバリ

18.3.5.1 別のホストへのFusion Middleware Controlのリカバリ

別のホストにFusion Middleware Controlをリカバリするには、次の手順に従います。

1. 次のファイル内のホスト名を更新します。

DOMAIN_HOME/config/fmwconfig/servers/AdminServer/applications/em/META-INF/emoms.properties

このファイルで、次のプロパティのホスト名を変更します。

oracle.sysman.emSDK.svlt.ConsoleServerHost
oracle.sysman.emSDK.svlt.ConsoleServerName

2. 次のファイルを編集します。

(UNIX) ORACLE_INSTANCE/EMAGENT/emagent_name/sysman/config/emd.properties
(Windows) ORACLE_INSTANCE\EMAGENT\emagent_name\sysman\config\emd.properties

このファイルで、Oracle Management Agentによって監視されている各コンポーネントの次のエントリを編集し、ホスト名を置き換えます。

REPOSITORY_URL=http://newhost.domain.com:port/em/upload/
EMD_URL=http://newhost.domain.com:port/emd/main/
emdWalletSrcUrl=http://newhost.domain.com:%EM_UPLOAD_PORT%/em/wallets/emd

18.3.5.2 Fusion Middleware Controlのtargets.xmlファイル内のホスト名の変更

別のホストにコンポーネントをリカバリする場合、Fusion Middleware Controlのtargets.xmlファイルを更新する必要があります。このファイルは次の場所にあります。

(UNIX) DOMAIN_HOME/sysman/state/targets.xml
(Windows) DOMAIN_HOME\sysman\state\targets.xml

このファイルで、別のホストにリカバリするコンポーネントのホスト名を新しいホスト名に変更します。

18.3.5.3 コンポーネントを別のホストにリカバリした場合のOracle Management Agentのリカバリ

多くのコンポーネントでは、別のホストにリカバリするときに、ホストの破損の場合と同様に、Fusion Middleware Controlがコンポーネントを管理できるように、Oracle Management Agentをリカバリする操作を実行する必要があります。これは、次のインストール・タイプやコンポーネントに関連しています。

- アイデンティティ管理コンポーネント

- Oracle Identity Federation

- Oracle Portal

- Oracle Business Intelligence Discoverer

- Oracle Forms Services

- Oracle Reports

Oracle Management Agentをリカバリするには、次の手順を実行します。

1. 次のファイルを編集します。

(UNIX) DOMAIN_HOME/sysman/state/targets.xml
(Windows) DOMAIN_HOME\sysman\state\targets.xml

ファイル内で、次の要素を編集し、ホスト名を置き換えます。

<Target TYPE="host" NAME="newhost.domain.com"
DISPLAY_NAME="newhost.domain.com"/>

2. 次のファイルを編集します。

(UNIX) ORACLE_INSTANCE/EMAGENT/emagent_name/sysman/config/emd.properties
(Windows) ORACLE_INSTANCE\EMAGENT\emagent_name\sysman\config\emd.properties

次のエントリを更新して、ホスト名を置き換えます。

REPOSITORY_URL=http://newhost.domain.com:port/em/upload/
EMD_URL=http://newhost.domain.com:port/emd/main/

3. 次のコマンドを使用して、Oracle Management Agentを起動します。

opmnctl startproc ias-component=EMAGENT

4. 管理サーバーを起動します。

DOMAIN_HOME/bin/startWebLogic.sh -Dweblogic.management.username=username
-Dweblogic.management.password=password
-Dweblogic.system.StoreBootIdentity=true

管理サーバーを起動すると、Fusion Middleware Controlも起動されます。

18.3.5.4 mod_wl_ohs.confファイルの変更

管理サーバーまたは管理対象サーバーを別のホストにリカバリする場合、環境にOracle HTTP Serverが含まれていると、新しいホスト上で次のファイルを変更する必要があります。

(UNIX) ORACLE_INSTANCE/config/OHS/ohs_name/mod_wl_ohs.conf
(Windows) ORACLE_INSTANCE\config\OHS\ohs_name\mod_wl_ohs.conf

そのファイルで、ホスト名、ポート、およびクラスタのエントリのすべてのインスタンス(WebLogicHost、WebLogicPort、WebLogicClusterなどの要素)を変更します。次に例を示します。

<Location /console>
SetHandler weblogic-handler
WebLogicHost Admin_Host
WeblogicPort Admin_Port
WLProxySSL ON
WLProxySSLPassThrough ON
</Location>
.
.
.
<Location /soa-infra>
SetHandler weblogic-handler
WebLogicCluster SOAHOST1VHN2:8001,*SOAHOST2VHN1*:*8001*
WLProxySSL ON
WLProxySSLPassThrough ON
</Location>

18.3.5.5 特定のコンポーネントの新しいマシンの作成

次のアイデンティティ管理コンポーネント(およびリスニング・アドレスを使用している場合は管理サーバー)の場合、管理サーバーを起動する前に、新しいホスト名で新しいマシンを作成する必要があります。

- Oracle Access Manager

- Oracle Adaptive Access Manager

- Oracle Identity Manager

- Oracle Identity Navigator

次の手順を実行します。

1. 新しいホスト名で新しいマシンを作成します。次のWLSTコマンドをオフライン・モードで使用します。

wls:/offline> readDomain('DOMAIN_HOME')
wls:/offline/sampledomain> machine = create('newhostname', 'Machine')
wls:/offline/sampledomain> cd('/Machine/newhostname')
wls:/offline/sampledomain> nm = create('newhostname', 'NodeManager')
wls:/offline/sampledomain> cd('/Machine/newhostname/NodeManager/newhostname')
wls:/offline/sampledomain> set('ListenAddress', 'newhostname')
wls:/offline/sampledomain> updateDomain()
wls:/offline/sampledomain> exit()

2. 管理サーバーの場合、次のWLSTコマンドをオフライン・モードで使用して、新しいホスト名でマシンを設定します。

wls:/offline> readDomain('DOMAIN_HOME')
wls:/offline/sampledomain> cd ('/Machine/newhostname')
wls:/offline/sampledomain> machine = cmo
wls:/offline/sampledomain> cd ('/Server/AdminServer')
wls:/offline/sampledomain> set('Machine', machine)
wls:/offline/sampledomain> updateDomain()
wls:/offline/sampledomain> exit()

3. 管理サーバーのリスニング・ポートを設定します。

wls:/offline/sampledomain> readDomain('DOMAIN_HOME')
wls:/offline/sampledomain> cd('/Server/AdminServer')
wls:/offline/sampledomain> cmo.setListenPort(8001)
wls:/offline/sampledomain> updateDomain()
wls:/offline/sampledomain> exit()

18.3.5.6 特定のアイデンティティ管理コンポーネントの、ユーザーのグループへの再関連付け

次のアイデンティティ管理コンポーネントのバックアップをリストアすると、Weblogicユーザーは、前に関連付けられていたグループとは関連付けられなくなります。

- Oracle Access Manager

- Oracle Adaptive Access Manager

- Oracle Identity Manager

- Oracle Identity Navigator

Weblogicユーザーをグループに再関連付けする必要があります。

ユーザーのグループへの関連付けの詳細は、Oracle Fusion Middleware Oracle WebLogic Server管理コンソール・ヘルプのユーザーのグループへの追加に関する項を参照してください。

18.3.5.7 Oracleインベントリの更新

多くのコンポーネントで、別のホストにリカバリするときは、ホストの破損の場合と同様に、Oracleインベントリを更新する必要があります。そのためには、次のスクリプトを実行します。

ORACLE_HOME/oui/bin/attachHome.sh

また、beahomelistを更新して、Middlewareホームの場所を編集する必要があります。次のファイルを編集して、Middlewareホームの情報を更新します。

(UNIX) user_home/bea/beahomelist
(Windows) C:\bea\beahomelist

18.3.5.8 Windowsレジストリのリカバリ

Windows上で別のホストにコンポーネントをリカバリするときは、ホストの破損の場合と同様に、Oracle Fusion Middlewareに関連するすべてのWindowsレジストリ・キーを新しいホストにインポートする必要があります。(レジストリ・キーは、第17.3.3項でエクスポートしたものです。)

次のレジストリ・キーをリカバリします。

HKEY_LOCAL_MACHINE\Software\Oracle

さらに、次のレジストリ・キー内のOracleで始まる各ノードをリカバリします。

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
HKEY_LOCAL_MACHINE\SYSTEM\ControlSet001\Services
HKEY_LOCAL_MACHINE\SYSTEM\ControlSet002\Services

前にエクスポートしたキーをインポートするには、次のコマンドを使用します。

regedit  /I  FileName

次に例を示します。

regedit /I C:\oracleregistry.reg

キーのインポートにはレジストリ・エディタを使用することもできます。詳細は、レジストリ・エディタのヘルプを参照してください。

18.3.6 データベース・ホストの破損後のリカバリ

データベースを含むホストが破損した場合、RMANを使用してリカバリできます。

次に例を示します。

rman> restore database;
rman> recover database;

最善の結果を得るには、ポイント・イン・タイム・リカバリを使用して、データベースを最新の状態にリカバリします(データベースがアーカイブ・ログ・モードで構成されている場合)。これにより、確実に最新のデータがリカバリされます。また、データベースに同じ名前を使用します。次の点に注意してください。

- 各コンポーネントで使用するスキーマについては、付録Dを参照してください。

- Oracle BPEL Process Managerのポイント・イン・タイム・リカバリを使用すると、最新のプロセス定義および進行中のインスタンスがリストアされます。ただし、これによってプロセスの手順が再実行される場合があります。できるかぎり、Oracle BPEL Process Managerの冪等プロセスを使用することをお薦めします。冪等以外のプロセスがシステムに含まれている場合は、それらをデハイドレーション・ストアからクリーンアップしてからOracle Fusion Middlewareを起動する必要があります。詳細は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』を参照してください。

データベースのリカバリおよびRMANの使用の詳細な手順は、『Oracle Databaseバックアップおよびリカバリ・ユーザーズ・ガイド』を参照してください。

第VIII部

高度な管理: 環境の拡張

この部では、Oracle Fusion Middleware環境を拡張する方法について説明します。

次の章が含まれます。

- 第19章「環境のスケーリング」

- 第20章「移行スクリプトの使用」

- 第21章「テスト環境から本番環境への移行」

19 環境のスケーリング

次の各項では、管理対象サーバーの追加、他の製品の組込みによるドメインの拡張、管理対象サーバーのクラスタの作成、既存のMiddlewareホームまたはOracle SOA SuiteやOracle HTTP Serverなどの既存のOracle Fusion Middlewareコンポーネントのコピーによって環境を拡張する方法について説明します。

- 環境のスケーリングの概要

- ドメインの拡張による追加コンポーネントのサポート

- ドメインへの管理対象サーバーの追加

- 追加のOracleインスタンスとシステム・コンポーネントの作成

- クラスタの作成

- Middlewareホームまたはコンポーネントのコピー

19.1 環境のスケーリングの概要

スケーラビリティとはスループットを提供するシステムの能力で、使用可能なハードウェア・リソースに比例し、またこのリソースによってのみ制限されます。スケーラブルなシステムとは、リクエストが増加してもレスポンス時間およびスループットに悪影響をもたらすことなく処理できるシステムです。

1つの操作環境において計算力を増加することを、垂直スケーリングといいます。水平スケーリングとは、複数のシステムを連動させて共通の問題をパラレル処理することです。

Oracle Fusion Middlewareは、垂直および水平の両方のスケーリングを行います。Oracle Fusion Middlewareでは、複数の管理対象サーバーをグループ化してワークロードを共有することによって、水平スループットが増加します。また、Oracle Fusion Middlewareでは、管理対象サーバーまたはコンポーネントを同一ホストに追加でき、垂直的なスケーラビリティも優れています。

高可用性とは、ユーザーによるシステムへのアクセス機能を指します。高可用性システムのデプロイによって、システムのダウン(使用不可の時間)を最小限に抑え、実行(使用可能な時間)を最大化できます。Oracle Fusion Middlewareは、ロード・バランシングや基本的なクラスタ化から、ハードウェアおよびソフトウェアの壊滅的な障害発生時にシステムの可用性を最大限にすることまで、非常に広範囲な高可用性ソリューションを提供するように設計されています。

高可用性ソリューションは、ローカルの高可用性と障害時リカバリの2つの基本的なカテゴリに分類できます。

関連項目:

- 高可用性の詳細は、『Oracle Fusion Middleware高可用性ガイド』を参照してください。

- 『Oracle Fusion Middlewareディザスタ・リカバリ・ガイド』

19.2 ドメインの拡張による追加コンポーネントのサポート

Oracle WebLogic Serverドメインを作成する場合、特定のドメイン・テンプレートを使用します。そのテンプレートは、Oracle SOA Suiteのような特定のコンポーネントまたはコンポーネントのグループをサポートします。このドメインにOracle WebCenter Portalなどの他のコンポーネントを追加する場合は、追加するコンポーネントのドメイン・テンプレートを使用してドメインに追加の管理対象サーバーを作成することによってドメインを拡張できます。

ドメインを拡張する際は、ドメインをオフラインにする必要があります。

ドメインを拡張するには、目的のコンポーネントがインストールされているOracleホームからOracle WebLogic Server構成ウィザードを使用します。そこで、拡張するドメインと追加するコンポーネントを選択します。

表19-1は、既存のドメインに追加できるコンポーネントと必要なドメイン・テンプレートを示しています。

表19-1 サポート対象のドメインの拡張

既存のドメイン・テンプレート

追加可能なコンポーネント

Oracle SOA Suite

任意のOracle SOA Suiteコンポーネント。

任意のOracle WebCenter Portalコンポーネント。Oracle WebCenter Portalドメイン・テンプレートを使用して拡張。

任意のWeb層コンポーネント。Web層ドメイン・テンプレートを使用して拡張。

Oracle Identity Management

任意のアイデンティティ管理コンポーネント。

任意のWeb層コンポーネント。Web層ドメイン・テンプレートを使用して拡張。

Oracle Portal、Oracle Reports、Oracle Forms Services、Oracle Business Intelligence Discoverer

これらのうちの任意のコンポーネント。

任意のWeb層コンポーネント。Web層ドメイン・テンプレートを使用して拡張。

注意:

アイデンティティ管理コンポーネント、Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle Business Intelligence Discovererの場合、ドメインに追加するコンポーネントがリモート・ホスト上にあるときは、WebLogic Serverホームのフルパスを、元のコンポーネントのWebLogic Serverホームのものと同じにする必要があります。

たとえば、最初はアイデンティティ管理コンポーネントをサポートするために作成したドメインを、Web層コンポーネントもサポートするように拡張しようとしており、Web層コンポーネントをリモート・ホストにインストールする場合があります。この場合、アイデンティティ管理のWebLogic Serverホームが/scratch/oracle/Middleware/wlserver_10.3にある場合、Web層のWebLogic Serverホームも/scratch/oracle/Middleware/wlserver_10.3に配置する必要があります。

たとえば、最初はOracle SOA Suiteをサポートするために作成したドメインを、Oracle WebCenter Portalもサポートするように拡張する手順は次のとおりです。

1. 『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』の説明に従って、RCUを使用してコンポーネントに必要な任意のスキーマを追加します。

2. Oracle Fusion Middleware WebCenter Portalインストレーション・ガイドの説明に従って、Oracle WebCenter Portalをインストールします。

3. 追加するコンポーネント(たとえば、Oracle WebCenter Portal)に対してインストールされているOracleホームから、次のコマンドを使用して、構成ウィザードを起動します。

(UNIX) ORACLE_HOME/common/bin/config.sh
(Windows) ORACLE_HOME\common\bin\config.cmd

構成ウィザードの「ようこそ」画面が表示されます。

4. 「既存のWebLogicドメインの拡張」を選択します。

5. 「次へ」をクリックします。
「WebLogicドメイン・ディレクトリの選択」画面が表示されます。

6. コンポーネントの追加先ドメインのディレクトリを選択します。

7. 「次へ」をクリックします。
「拡張ソースの選択」画面が表示されます。

8. 「以下の追加製品をサポートするために、自動的にドメインを拡張する」を選択して、このドメインを拡張する元になるソースを選択します。たとえば、「Oracle WebCenter Spaces」を選択します。

9. 「次へ」をクリックします。
「JDBCデータ・ソースの構成」画面が表示されます。

10. 次の情報を入力して、追加した新しいコンポーネントのスキーマを選択します。

- 「ベンダー」で、「Oracle」を選択します。

- 「ドライバ」で、「*Oracleのサービス接続用ドライバ(Thin)、バージョン:9.0.1、9.2.0、10、11」を選択します。

- 「スキーマ所有者」には何も入力しません。各データ・ソースで、表で指定されているユーザー名が使用されます。

- 各スキーマの作成時に同一のパスワードを使用した場合は、すべてのスキーマを選択し、「スキーマ・パスワード」にパスワードを入力します。
または、各スキーマを個別に選択し、パスワードを入力することによって、データ・ソースごとに異なるパスワードを指定することができます。

- すべてのスキーマを選択した状態で、「DBMS/サービス」に、データベースのSIDを入力します。

- すべてのスキーマを選択した状態で、「ホスト名」に、データベースのホスト名を入力します。

- すべてのスキーマを選択した状態で、「ポート」に、データベースのリスニング・ポートを入力します。

11. 「次へ」をクリックします。
「コンポーネント・スキーマのテスト」画面が表示されます。

12. テストが成功したら、「次へ」をクリックします。
「オプションの構成を選択」画面が表示されます。

13. この画面および以降の画面では、設定をカスタマイズすることを選択できます。設定をカスタマイズするには、カスタマイズのタイプを選択します。設定をカスタマイズしない場合は、「次へ」をクリックします。
「構成のサマリー」画面が表示されます。

14. この画面に表示されている情報を確認して、正しければ「拡張」をクリックします。

15. 操作が完了したら、「完了」をクリックします。

19.3 ドメインへの管理対象サーバーの追加

ドメインに管理対象サーバーを追加して、システムの容量を拡大できます。管理対象サーバーは、クラスタに追加することができます。

管理対象サーバーをクラスタに追加すると、管理対象サーバーは、そのクラスタが対象となっているアプリケーションおよびサービスを継承されます。管理対象サーバーをクラスタの一部として追加するのではない場合、管理対象サーバーは、テンプレートからアプリケーションとサービスを自動的には継承しません。

管理対象サーバーをドメインに追加する際は、Oracle WebLogic Server管理コンソールまたはWLSTを使用できます。

関連項目:

管理対象サーバーの追加の詳細は、管理コンソールのオンライン・ヘルプおよび『Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス』を参照してください。

管理コンソールを使用してドメインに管理対象サーバーを追加する手順は次のとおりです。

1. 第3.4.1項の説明に従って、管理コンソールを表示します。

2. 第3.4.2項の説明に従って、Oracle WebLogic Server構成をロックします。

3. 左ペインで、「環境」を開き、「サーバー」を選択します。
「サーバーのサマリー」ページが表示されます。

4. 「サーバー」表で、「新規」をクリックします。
「新しいサーバーの作成: サーバーのプロパティ」ページが表示されます。

5. 次の情報を入力します。

- 「名前」に、サーバーの名前を入力します。
ドメイン内の各サーバーには、ドメイン内のすべての構成オブジェクトに対して一意の名前が必要です。ドメイン内では、各サーバー、コンピュータ、クラスタ、JDBC接続プール、仮想ホストおよびその他すべてのリソース・タイプに、一意の名前を付ける必要があり、ドメインと同じ名前を使用することはできません。

- 「リスニング・アドレス」には、サーバー・インスタンスの有効なアドレスを限定するために、IPアドレスまたはDNS名を入力します。そうしないと、サーバーへのURLによって、ホスト・コンピュータのIPアドレス、いずれかのIPアドレスにマップされているDNS名、またはlocalhost文字列が指定される可能性があります。

- 「リスニング・ポート」に、サーバー・インスタンスへのアクセス元のポート番号を入力します。
1つのコンピュータで複数のサーバー・インスタンスを実行している場合は、各サーバーで固有のリスニング・ポートを使用する必要があります。

- このサーバーをスタンドアロン・サーバーにするのか、それとも既存のクラスタまたは新しいクラスタのメンバーにするのかを指定します。

- このサーバーをスタンドアロン・サーバーにする場合は、「いいえ、これはスタンドアロン・サーバーです。」を選択します。

- このサーバーを既存のクラスタの一部にする場合は、「はい、このサーバーを既存のクラスタのメンバーにします。」を選択します。そして、クラスタを選択します。
既存のクラスタがない場合、このオプションは表示されません。

- このサーバーを新しいクラスタの一部にする場合は、「はい、このサーバー用に新しいクラスタを作成します。」を選択します。

6. 「次へ」をクリックします。
「選択内容の確認」ページが表示されます。

7. 表示される情報を確認します。情報が正しい場合は、「終了」をクリックします。

8. 第19.3.1項の説明に従って、JRFを管理対象サーバーまたはクラスタに適用します。

Fusion Middleware Controlを使用して、管理対象サーバーをドメインに追加することもできます。「ファーム」メニューで、「コンポーネントの作成/削除」を選択します。「Fusion Middlewareコンポーネント」ページで、「作成」→「WebLogic Server」を選択します。

19.3.1 管理対象サーバーまたはクラスタへのOracle JRFテンプレートの適用

Oracle JRF(Java Required Files)は、Oracle WebLogic Serverインストールに含まれておらず、Oracleビジネス・アプリケーションおよびアプリケーション・フレームワークに共通の機能を提供するコンポーネントで構成されています。

JRFには、共通の場所にデプロイされる、いくつかの個別に開発されたライブラリおよびアプリケーションが含まれています。Java Required Filesの一部と見なされるコンポーネントには、Oracle Application Development Framework共有ライブラリやODLロギング・ハンドラがあります。

特定の状況では、JRFテンプレートを管理対象サーバーまたはクラスタに適用する必要があります。JRFが構成されているドメイン内の管理対象サーバーにのみJRFを適用できます。つまり、ドメインを作成または拡張した場合は、構成ウィザードでOracle JRFを選択しておく必要があります。

JRFの適用については、次の点に注意してください。

- すでにJRFで構成されている既存のクラスタに管理対象サーバーを追加する場合は、その管理対象サーバーにJRFを適用する必要はありません。

- 管理対象サーバーをドメインに追加する際、その管理対象サーバーにJRFサービスが必要だが、管理対象サービスがクラスタに属していない場合、その管理対象サーバーにJRFを適用する必要があります。

- クラスタを新規作成し、そのクラスタにJRFが必要な場合、クラスタにJRFを適用する必要があります。

- テンプレート拡張プロセスで製品テンプレートによって追加される管理対象サーバーにJRFを適用する必要はありません(ただし、構成ウィザードでJRFを選択する必要があります)。

- JRFの適用後は、サーバーまたはクラスタを再起動する必要があります。
ノード・マネージャを使用してサーバーまたはクラスタを起動する場合は(たとえば、ノード・マネージャを使用する管理コンソールを通して)、ノード・マネージャのプロパティstartScriptEnabledをtrueに設定する必要があります。詳細は、第4.2.1項を参照してください。

- Fusion Middleware Controlを使用してサーバーを作成すると、JRFテンプレートが自動的に適用されます。

管理対象サーバーまたはクラスタをJRFで構成するには、カスタムWLSTコマンドapplyJRFを使用します。カスタムWLSTコマンドを使用するには、Oracle共通ホームからWLSTスクリプトを起動する必要があります。詳細は、第3.5.1.1項を参照してください。

applyJRFコマンドの形式は次のとおりです。

applyJRF(target={server_name | cluster_name | *}, domainDir=domain_path,
[shouldUpdateDomain= {true | false}])

applyJRFコマンドは、オンラインまたはオフラインで使用できます。

- オンライン・モードでは、shouldUpdateDomainオプションを値true(デフォルト)で使用した場合、JRFの変更は暗黙的にアクティブになります。オンライン・モードでは、このオプションによって、オンラインWLST save()コマンドおよびactivate()コマンドがコールされます。

- オフライン・モードでは、管理サーバーおよび管理対象サーバーまたはクラスタを再起動する必要があります(オフライン・モードでは、shouldUpdateDomainオプションを値trueで指定した場合、このオプションによってWLST updateDomain()コマンドがコールされます)。

たとえば、JRFで管理対象サーバーserver1を構成するには、次のコマンドを使用します。

applyJRF(target='server1', domainDir='DOMAIN_HOME')

ドメイン内のすべての管理対象サーバーをJRFで構成するには、targetオプションの値としてアスタリスク(*)を指定します。

クラスタをJRFで構成するには、次のコマンドを使用します。

applyJRF(target='cluster1', domainDir='DOMAIN_HOME')

関連項目:

- Oracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンスのJava Required FilesカスタムWLSTコマンドに関する項

- 第I.2.2項(JRFとともに提供されるものとは別のバージョンのSpringを使用する場合)

19.4 追加のOracleインスタンスとシステム・コンポーネントの作成

システム・コンポーネントのあるOracle Fusion Middleware環境をインストールして構成すると、Oracleインスタンスがこれらのシステム・コンポーネント用に作成されます。さらに別のOracleインスタンスが必要な場合、次の項で示すように、OPMN createinstanceコマンドを使用してOracleインスタンスを作成でき、OPMN createcomponentコマンドを使用してシステム・コンポーネントを作成できます。

- セキュアでないポートを使用してのOracleインスタンスの作成

- セキュアなポートを使用してのOracleインスタンスの作成

- システム・コンポーネントの無効化

19.4.1 セキュアでないポートを使用してのOracleインスタンスの作成

セキュアなポートを使用していないOracleインスタンスを作成して、管理サーバーと通信できます。OPMN createinstanceコマンドを使用します。たとえば、OracleインスタンスとOracle HTTP Serverコンポーネント・インスタンスを作成するには:

1. OracleインスタンスとOracle HTTP Serverインスタンスを作成します。

1. コマンドラインから、次のディレクトリに移動します。

(UNIX) ORACLE_HOME/opmn/bin
(Windows) ORACLE_HOME\opmn\bin

2. opmnctl createinstanceコマンドを使用して、Oracleインスタンスを作成します。次に例を示します。

opmnctl createinstance -oracleInstance /scratch/Oracle/Middleware/inst1
-adminHost hostname -adminPort 7001

このコマンドは、Oracleインスタンスを作成し、デフォルトで、それらのインスタンスをOracle WebLogic Server管理サーバーに登録します。

3. opmnctl createcomponentコマンドを使用して、Oracle HTTP Serverインスタンスを作成します。次に例を示します。

opmnctl createcomponent -componentType OHS
-oracleInstance /scratch/Oracle/Middleware/inst1
-componentName webcache1

2. opmnctl registerinstanceコマンドを使用して、Oracleインスタンスをそのすべてのコンポーネントとともに、管理サーバーに登録します。次に例を示します。

opmnctl registerinstance -adminHost admin_server_host
-adminPort admin_server_port -adminUsername username
-adminPassword password
-oracleInstance ORACLE_INSTANCE_dir -oracleHome ORACLE_HOME_dir
-instanceName Instance_name -wlserverHome Middleware_Home

19.4.2 セキュアなポートを使用してのOracleインスタンスの作成

セキュアなポートを使用するOracleインスタンスを作成して、管理サーバーと通信できます。OPMN createinstanceコマンドを使用します。たとえば、セキュアなポートを使用するOracle HTTP Serverコンポーネント・インスタンスとOracleインスタンスを作成するには:

1. 管理サーバーに登録されていないインスタンスとしてOracleインスタンスを作成します。(その後の手順で登録します。)

opmnctl createinstance -oracleInstance /scratch/Oracle/Middleware/inst1
-adminRegistration OFF

2. セキュアなポートを使用して管理サーバーにアクセスするには、パスフレーズや信頼できる場所など関連するセキュリティ設定を指定する必要があります。接続に必要なシステム・プロパティのリストは、実行しているSSL接続のタイプによって異なります。設定を指定するには、wls.connect.propertiesの名前でファイルを作成します。wls.connect.propertiesファイルの例を次に示します。

# Example wls.connect.properties file for using the default DemoTrust store

# These are jsse system property settings used for accessing mbeans
javax.net.ssl.trustStore=/scratch/aime1/middleware/wlserver_10.3/server/lib/DemoTrust.jks
javax.net.ssl.trustStorePassword=DemoTrustKeyStorePassPhrase

# These are weblogic system property settings used for app deployment
weblogic.home=/scratch/aime1/middleware/wlserver_10.3/server
weblogic.security.TrustKeyStore=DemoTrust
weblogic.security.JavaStandardTrustKeystorePassPhrase=DemoTrustKeyStorePassPhrase

# Other commonly used weblogic property settings for app deployment
# Comment next line for a more verbose deployment
weblogic.log.StdoutSeverity=off
# Comment next line to enable host name verification
weblogic.security.SSL.ignoreHostnameVerification=true

3. 次の場所にファイルをコピーします。

ORACLE_INSTANCE/config/OPMN/opmn/wls.connect.properties

セキュアな接続が作成されるたびに、プロパティはシステム・プロパティとしてロードされます。

注意:

- OPMNではこれらのプロパティをJVMに検証せずに渡すので、設定が有効で完全であり構文が有効なことを確認する必要があります。

- Windowsでは、wls.connect.propertiesファイルでバックスラッシュ(\)が適切にエスケープ処理されていることを確認する必要があります。次に例を示します。

javax.net.ssl.trustStore=c:\\oracle\\mw2238\\wlserver_10.3\\server\\lib\\DemoTrust.jks

4. opmnctl createcomponentコマンドを使用して、Oracle HTTP Serverインスタンスを作成します。次に例を示します。

opmnctl createcomponent -componentType OHS
-oracleInstance /scratch/Oracle/Middleware/inst1
-componentName webcache1

5. セキュアなプロトコルを使用して、Oracleインスタンスを登録します。

ORACLE_INSTANCE/bin/opmnctl registerinstance -adminProtocol t3s
-adminHost admin_server_host
-adminPort admin_server_port -adminUsername username
-adminPassword password
-oracleInstance ORACLE_INSTANCE_dir -oracleHome ORACLE_HOME_dir
-instanceName Instance_name -wlserverHome Middleware_Home

19.4.3 システム・コンポーネントの無効化

システム・コンポーネントを削除したくはないが、無効にしたい場合があります。システム・コンポーネントを無効にする手順は次のとおりです。

1. 次のファイルを編集します。

ORACLE_INSTANCE/OPMN/opmn/config/opmn.xml

<ias-component>要素にパラメータstatus="disabled"を追加します。次に例を示します。

<ias-component id="webcache1" type="WebCache" status="disabled">

2. ファイルを保存します。

3. 次のコマンドを実行します。

opmnctl validate
opmnctl stopall
opmnctl startall

19.5 クラスタの作成

WebLogic Serverクラスタは、同時に実行され、連動してスケーラビリティと信頼性の向上を実現する複数のWebLogic Serverサーバー・インスタンスで構成されます。クライアントでは、1つのクラスタが、1つのWebLogic Serverインスタンスのように認識されます。1つのクラスタを構成するサーバー・インスタンスを同一のコンピュータで実行することも、複数のコンピュータに配置することもできます。既存のコンピュータ上のクラスタにサーバー・インスタンスを追加して、クラスタの容量を拡大したり、クラスタにコンピュータを追加して、追加のサーバー・インスタンスをホストしたりできます。クラスタ内の各サーバー・インスタンスでは、同一バージョンのWebLogic Serverを実行する必要があります。

WLST、Oracle WebLogic Server管理コンソールまたはFusion Middleware Controlを使用して、管理対象サーバーのクラスタを作成できます。この項では、Fusion Middleware Controlを使用してクラスタを作成する方法について説明します。

注意:

アイデンティティ管理コンポーネント、Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle Business Intelligence Discovererの場合、クラスタに含める1つ以上の管理対象サーバーがリモート・ホスト上にあるときは、WebLogic Serverホームのフルパスを、その他の管理対象サーバーのWebLogic Serverホームのものと同じにする必要があります。

たとえば、ホストAとホストBにそれぞれ1つずつ管理対象サーバーがあり、これらを1つのクラスタに追加する場合があります。ホストAのWebLogic Serverホームが/scratch/oracle/Middleware/wlserver_10.3にある場合は、ホストBのWebLogic Serverホームも/scratch/oracle/Middleware/wlserver_10.3に配置する必要があります。

soa_server1およびsoa_server2の2つの管理対象サーバーのクラスタを作成するには、次の手順に従います。

1. 「ファーム」メニューで、「コンポーネントの作成/削除」を選択します。
「Fusion Middlewareコンポーネント」ページが表示されます。

2. 「作成」→「WebLogicクラスタ」を選択します。
「WebLogicクラスタの作成」ページが表示されます。

3. 「名前」に、クラスタの名前を入力します。

4. 「クラスタ・メッセージング・モード」セクションで、次のいずれかを選択します。

- ユニキャスト。「ユニキャスト・ブロードキャスト・チャネル」にチャネルを入力します。このチャネルは、クラスタ内でのメッセージの伝送に使用されます。

- マルチキャスト。マルチキャスト・ブロードキャスト・チャネルにチャネルを入力します。マルチキャスト・アドレスは、224.0.0.0から239.255.255.255の範囲内のIPアドレスです。「マルチキャスト・ポート」にポート番号を入力します。

注意:

入力するマルチキャスト・アドレスが使用されていないことを確認する必要があります。

5. 「サーバー」セクションで、クラスタに追加する1つ以上のサーバーを選択します。このシナリオでは、soa_server1とsoa_server2を選択します。

6. 「作成」をクリックします。

これで、クラスタにsoa_server1とsoa_server2の2つのメンバーが追加されました。

関連項目:

クラスタの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverクラスタの使用』を参照してください。

19.6 Middlewareホームまたはコンポーネントのコピー

Middlewareホームまたは複数のOracle Fusion Middlewareコンポーネントは、その構成を維持しながら、別の場所にコピーできます。Oracle Fusion Middlewareのコピーは、次のような場合に有用です。

- 作成するMiddlewareホームが本番、テストまたは開発環境のコピーである場合。コピーによって、すべてのパッチが適用された新しいMiddlewareホームまたはコンポーネントを1回の手順で作成できます。これは、個々のMiddlewareホームまたはコンポーネントのインストール、構成、パッチの適用を個別に行うこととはまったく異なる方法です。

- パッチを適用したホームの「ゴールド」イメージを作成し、それを多数のホストに配置する場合。

Middlewareホームまたはコンポーネントのコピーで使用するスクリプトの詳細は、第20章を参照してください。

20 移行スクリプトの使用

Oracle Fusion Middlewareには、テスト環境を本番環境にレプリケート(クローン)する場合など、環境の移行に使用可能な一連のスクリプトが用意されています。このスクリプトを使用して、MiddlewareホームやOracleホーム、Oracle WebLogic Serverドメインの他に、Oracle SOA Suite、Oracle HTTP Server、Oracle Internet Directory、Oracle Virtual Directoryなどの特定のOracle Fusion Middlewareコンポーネントの構成をコピーできます。この章では、これらのエンティティの移行に使用可能なスクリプトについて説明します。

この章の項目は次のとおりです。

- 移行スクリプトの概要

- 移行スクリプト

- 移動計画の変更

注意:

すべてのコンポーネントで移行スクリプトがサポートされているわけではありません。ある環境から別の環境にOracle Fusion Middlewareを移行するための詳細な手順は、第21章を参照してください。この章では、これらのスクリプトを使用する方法と、ソース環境からターゲット環境に移行する他の手順について説明します。

20.1 移行スクリプトの概要

移行スクリプトを使用しない場合、移行元の環境で行ったカスタマイズや構成変更は、移行先の環境にすべて再適用する必要がありますが、移行スクリプトを使用することにより、このような作業が最小化されます。これらのスクリプトを使用することにより、次のことが可能になります。

- 本番、テストまたは開発環境のコピーであるMiddlewareホームを作成します。スクリプトによって、1回の手順で新しいMiddlewareホームを作成し、すべてのOracleホームおよびWebLogic Serverホームにすべてのパッチを適用します。これは、WebLogic Serverホームおよび個々のOracleホームのインストールおよびパッチの適用を個別に行うこととはまったく異なる方法です。

- パッチを適用したMiddlewareホームの「ゴールド」イメージを作成し、それを多数のホストに配置します。

- ドメインまたはOracleインスタンスの構成(ドメインまたはOracleインスタンスのコンポーネントを含む)を、ある環境から別の環境に移行します。

同一ホスト上または別のホスト上に移行できるものは、次のとおりです。ソース環境とターゲット環境では、同じオペレーティング・システムおよび同じプラットフォーム・アーキテクチャ(ビット数に関して)を使用している必要があります。

- Middlewareホーム: Middlewareホーム、Oracle WebLogic Serverホーム、およびMiddlewareホーム内のすべてのOracleホームをコピーできます。(Oracleホームが含まれないMiddlewareホームをコピーすることはできますが、コピーするMiddlewareホームのバージョンと互換性のあるcloningclient.jarファイルおよび移行スクリプトを使用する必要があります。)

- Javaコンポーネント: Oracle SOA SuiteやOracle Business Activity MonitoringなどのJavaコンポーネントが含まれるドメインの構成を、同一のMiddlewareホームまたは別のMiddlewareホームにコピーできます。

- Oracleインスタンス: Oracleインスタンスの構成を、同一のMiddlewareホームまたは別のMiddlewareホームにコピーできます。Oracleインスタンスを移行する場合は、Oracleインスタンスのすべてのシステム・コンポーネントについて、そのインスタンスのすべての構成ファイルを移行します。
または、Oracleインスタンス内のシステム・コンポーネントの1つ(Oracle HTTP Serverなど)を移行できます。この場合、Oracleインスタンスの構成と指定されたコンポーネントが移行されます。この方法で、次のシステム・コンポーネントを移行できます。

- Oracle HTTP Server

- Oracle Virtual Directory

- Oracle Internet Directory

- Oracle BI Enterprise Edition

注意:

移行スクリプトは大部分のOracle Fusion Middlewareコンポーネントの移行をサポートしていますが、いくつかのコンポーネントについては、スクリプトに加えて手動手順を実行するか、またはスクリプトを使用するかわりに手動手順を実行する必要があります。Oracle Fusion Middlewareコンポーネントをソース環境からターゲット環境に移行する手順と、いつスクリプトを使用するのかについては、第21章を参照してください。

表20-1は、移行スクリプトをサポートするOracle Fusion Middlewareコンポーネントを示し、各コンポーネントを移行する手順の参照先を示します。

表20-1 移行スクリプトのサポート

コンポーネント

サポートの有無

ドキュメントに記載されている手順

Oracle Access Manager

はい

第21.4.1.1項

Oracle Adaptive Access Manager

はい

第21.4.1.1項

Oracle B2B

はい

第21.4.2.1項

Oracle Business Activity Monitoring

はい

第21.4.2.1項、作業6

Oracle Business Intelligence

はい

第21.4.7.1項

Oracle Business Intelligence Discoverer

いいえ

第21.4.9.1項

Oracle Business Process Management

はい

第21.4.2.1項

Oracle Data Integrator

はい

第21.4.10.1項

Oracle Directory Integration Platform

はい

第21.4.1.1項

Oracle Enterprise Performance Management Workspace

いいえ

第21.4.5項

Oracle Essbase

はい

第21.4.5項

Oracle Forms Services

いいえ

第21.4.9.1項

Oracle HTTP Server

はい

第21.4.6.1.1項

Oracle Human Workflow

はい

第21.4.2.1項

Oracle Hyperion Calculation Manager

いいえ

第21.4.5項

Oracle Hyperion Financial Reporting

いいえ

第21.4.5項

Oracle Hyperion Provider Service

いいえ

第21.4.5項

Oracle Hyperion Smart View for Office

いいえ

第21.4.5項

Oracle Identity Federation

はい

第21.4.1.1項

Oracle Identity Manager

いいえ

サポートされている手順はありません。また、Oracle Identity Managerが他のコンポーネントのソース環境の一部である場合は、移行スクリプトは失敗します。

Oracle Identity Navigator

はい

第21.4.1.1項

Oracle Information Rights Management

いいえ

第21.4.3.1項、作業3

Oracle Internet Directory

はい

第21.4.1.1項

Oracle Platform Security Services

はい

第21.4.1.1項

Oracle Portal

いいえ

第21.4.9.1項

Oracle Real-Time Decisions

はい

第21.4.8.1項

Oracle Reports

いいえ

第21.4.9.1項

Oracle Security Token Service

はい

第21.4.1.1項

Oracle Service Bus

はい

第21.4.2.1項

Oracle SOA Suite

はい

第21.4.2.1項

Oracle User Messaging Service

はい

第21.4.2.1項、作業8

Oracle Virtual Directory

はい

第21.4.1.1項

Oracle Web Cache

いいえ

第21.4.6.1.2項

Oracle Web Services Manager

はい

第21.4.1.1項

Oracle WebCenter Content

はい

第21.4.4.1項

Oracle WebCenter Content: Imaging

はい

第21.4.3.1項

Oracle WebCenter Content: Inbound Refinery

はい

第21.4.3.1項

Oracle WebCenter Content: Records

はい

第21.4.3.1項

Oracle WebCenter Portal

はい

第21.4.3.1項

20.2 移行スクリプト

Oracle Fusion Middlewareでは、次のjarファイルを使用して、バイナリ・ファイルおよび構成ファイルの移行に必要なスクリプトを実行します。

(UNIX) ORACLE_COMMON_HOME/jlib/cloningclient.jar
(Windows) ORACLE_COMMON_HOME\jlib\cloningclient.jar

表20-2に、Middlewareホームまたはコンポーネントの移行に使用するスクリプトを示します。

表20-2 移行スクリプト

目的:

スクリプト

関連項目:

ソースMiddlewareホームのバイナリ・ファイルをコピーする

(UNIX) ORACLE_COMMON_HOME/bin/copyBinary.sh
(Windows) ORACLE_COMMON_HOME\bin\copyBinary.cmd

第20.2.1.1項

コピーされたMiddlewareホームをターゲットに適用する

(UNIX) ORACLE_COMMON_HOME/bin/pasteBinary.sh
(Windows) ORACLE_COMMON_HOME\bin\pasteBinary.cmd

第20.2.1.2項

ドメインおよびJavaコンポーネントの構成をコピーする

(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd

第20.2.1.3項

Oracleインスタンスの構成をコピーする

(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd

第20.2.1.4項

システム・コンポーネントの構成をコピーする

(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd

第20.2.1.5項

ノード・マネージャの構成をコピーする

(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd

第20.2.1.6項

ドメインまたはコンポーネントから移動計画を抽出する

(UNIX) ORACLE_COMMON_HOME/bin/extractMovePlan.sh
(Windows) ORACLE_COMMON_HOME\bin\extractMovePlan.cmd

第20.2.1.7項

コピーされたドメインおよびJavaコンポーネントの構成をターゲットに適用する

(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd

第20.2.1.8項

コピーされたOracleインスタンスの構成をターゲットに適用する

(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd

第20.2.1.9項

コピーされたシステム・コンポーネントの構成をターゲットに適用する

(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd

第20.2.1.10項

コピーされたノード・マネージャの構成をターゲットに適用する

(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd

第20.2.1.11項

不明瞭化されたパスワードが含まれるファイルを生成する

(UNIX) ORACLE_COMMON_HOME/bin/obfuscatePassword.sh
(Windows) ORACLE_COMMON_HOME\bin\obfuscatePassword.cmd

第20.2.1.12項

これらのスクリプトのヘルプを参照するには、-helpオプションを使用します。次に例を示します。

./pasteConfig.sh -javaHome /scratch/Oracle/Middleware/jdk160_21 -help

ヘルプには、UNIX版のパラメータ値が示されます。Windowsなど他のプラットフォームでは、そのプラットフォームのパラメータ値に変更してください。

追加のJavaオプションを指定するには、T2P_JAVA_OPTIONS環境変数を定義し、その変数定義にオプションを指定します。次の例では、Java一時ディレクトリの値を設定しています。

- LinuxまたはUNIXの場合:

setenv T2P_JAVA_OPTIONS "-Djava.io.tmpdir=/home/t2p/temp"
export T2P_JAVA_OPTIONS

- Windowsの場合:

set T2P_JAVA_OPTIONS="-Djava.io.tmpdir=c:\home\t2p\temp"

注意:

Universal Uniform Naming Convention(UNC)パスは、Windowsではサポートされません。たとえば、次の例はサポートされていません。

\\host_name\oracle\java\win64\jdk6\jre\bin\java

注意:

Oracle Fusion MiddlewareがインストールされていないホストにMiddlewareホームのアーカイブを適用する場合、次の点に注意してください。

- ホストには、JDK 1.6.04以上がインストールされている必要があります。また、PATH、CLASSPATH、およびJAVA_HOME環境変数がJDKを指していることを確認してください。

- ソース・ホストの次の場所からpasteBinaryスクリプトをターゲット・ホストにコピーします。

(UNIX) ORACLE_COMMON_HOME/bin/pasteBinary.sh
(Windows) ORACLE_COMMON_HOME\bin\pasteBinary.cmd

- ソース・ホストの次の場所から次のファイルをターゲット・ホストにコピーします。

(UNIX) ORACLE_COMMON_HOME/jlib/cloningclient.jar
(Windows) ORACLE_COMMON_HOME\jlib\cloningclient.jar

- pasteBinaryスクリプトをORACLE_COMMON_HOME/bin以外の場所から実行する場合、pasteBinaryスクリプトとcloningclient.jarファイルは同じディレクトリに存在する必要があります。
前のOracle Fusion MiddlewareインストールがないホストでpasteBinaryが実行する場合、pasteBinaryを実行する前にORACLE_COMMON_home/binは存在していないため、pasteBinaryスクリプトとcloningclient.jarは同じディレクトリに存在する必要があります。

- ファイルに実行権限があることを確認してください。

20.2.1 移行スクリプトの構文

次の各項では、移行スクリプトの構文について説明します。構文の後の表で、そのオプションについて説明します。

- copyBinaryスクリプト

- pasteBinaryスクリプト

- Javaコンポーネント用のcopyConfigスクリプト

- Oracleインスタンス用のcopyConfigスクリプト

- システム・コンポーネント用のcopyConfigスクリプト

- ノード・マネージャ用のcopyConfigスクリプト

- extractMovePlanスクリプト

- Javaコンポーネント用のpasteConfigスクリプト

- Oracleインスタンス用のpasteConfigスクリプト

- システム・コンポーネント用のpasteConfigスクリプト

- ノード・マネージャ用のpasteConfigスクリプト

- obfuscatePasswordスクリプト

注意:

- 各移行スクリプトでは、-silent trueオプションを指定していない場合は常に、続行するかどうかを確認するメッセージが表示されます。続行するには、yesと入力します(大/小文字は区別されません)。yes以外の語句を入力すると、スクリプトからエラーが返されます。また、silentモードでは、必要な箇所にパスワードを入力しないと、スクリプトによってエラーが生成されます。

- この章のこれ以降の表に示すように、ほとんどのオプションにはショートカット名があります。

- オプションの値に空白を入れることはできません。たとえば、Windowsでは、-javaHomeオプションの値として次のような文字列を渡すことはできません。

C:\Program Files\jdk

- 移行スクリプトに渡された引数に等号(=)が含まれている場合、その値を二重引用符(")で囲む必要があります。次に例を示します。

-additionalParams "search.encrypt.key=C:\T2P\encrypt.txt"

- javaHomeオプションの値には、次のファイルで定義されているJavaホームを使用する必要があります(ファイル名の前のピリオド(.)に注意してください)。

MW_HOME/wlserver_n/.product.properties

20.2.1.1 copyBinaryスクリプト

ソースMiddlewareホームのすべてのOracleホームおよびWebLogic Serverホームを含めて、ソースMiddlewareホームのバイナリ・ファイルをアーカイブ・ファイルにコピーすることによって、ソースMiddlewareホームのアーカイブ・ファイルを作成します。

copyBinaryスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/copyBinary.sh
(Windows) ORACLE_COMMON_HOME\bin\copyBinary.cmd

構文は次のとおりです。

copyBinary -javaHome path_of_jdk
-archiveLoc archive_location
-sourceMWHomeLoc MW_HOME
[-invPtrLoc Oracle_InventoryLocation]
[-logDirLoc log_dir_path]
[-silent {true | false}]
[-ignoreDiskWarning {true | false}]

次の例は、LinuxでMiddlewareホームのアーカイブを作成する方法を示しています。

copyBinary.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/mw_copy.jar
-sourceMWHomeLoc /scratch/Oracle/Middleware1
-invPtrLoc /scratch/oracle/oraInst.loc

注意:

copyBinaryスクリプトを実行する前に、Middlewareホームの中のすべてのOracleホームがすべて32ビットまたはすべて64ビットのいずれかであることを確認します。この操作は、32ビットと64ビットのOracleホームが混在する環境をサポートしません。

スクリプトを実行するときに、対応するJavaホームを指定する必要があります。つまり、Oracleホームが64ビットの場合、64ビットのJavaホームを指定する必要があります。Oracleホームが32ビットの場合、32ビットのJavaホームを指定する必要があります。

表20-3は、copyBinaryスクリプトのオプションを説明しています。

表20-3 copyBinaryスクリプトのオプション

オプション

ショートカット

説明

必須かオプションか

-javaHome

該当なし

JDKの絶対パス。

オペレーティング・システムが64ビットの場合にスクリプトによりそのことが検出され、コマンドラインでスクリプトに-d64オプションが渡されます。

必須

-archiveLoc

-al

アーカイブの場所の絶対パス。このオプションは、copyBinaryスクリプトを使用して作成するアーカイブ・ファイルの場所の指定に使用します。

アーカイブの場所は存在している必要はありません。親ディレクトリが存在しない場合は、スクリプトにより作成されます。親ディレクトリに書込み権限が必要です。

アーカイブの場所がMiddlewareホーム構造内に存在しないことを確認してください。

必須

-sourceMWHomeLoc

-smw

アーカイブを作成するMiddlewareホームの絶対パス。指定できるのは、1つのMiddlewareホームのみです。

必須

-invPtrLoc

-ipl

UNIXおよびLinuxでは、Oracleインベントリ・ポインタへの絶対パス。このオプションは、インベントリの場所がデフォルトの場所ではない場合に使用します。これによって、インベントリで指定されたOracleホームを操作で読み取れるようになります。

oraInst.locファイルが存在する必要があります。これが存在しない場合、rootユーザーまたは通常の権限を持つユーザーとして作成します。次では、このファイルのコンテンツの例を示しています。

inventory_loc=/scratch/oraInventory

インベントリの場所への書込み権限が必要です。

UNIXおよびLinuxでは、デフォルトの場所は/etc/oraInst.locです。

Windowsでは、このパラメータを指定しても無視されます。

以前のリリースではショートカットは-invLocでしたが、現在は非推奨です。

インベントリがデフォルトの場所にある場合は、オプション。それ以外の場合は、Linuxでは必須。

-logDirLoc

-ldl

ディレクトリの絶対パス。存在しない場合は、スクリプトにより作成されます。クローンおよびエラー・ログ・ファイルがこのディレクトリに作成されます。デフォルトは、システムの一時ディレクトリです。

オプション

-silent

該当なし

操作をサイレントで実行するかどうかを指定します。サイレントの場合は、確認のためのプロンプトを表示しません。デフォルトでは、確認のためのプロンプトが表示されます。続行するには、yesと入力します(大/小文字は区別されません)。yes以外を入力すると、スクリプトからエラーが返されます。

確認のためのプロンプトを表示しないことを指定するには、このオプションを値trueで指定します。

オプション

-ignoreDiskWarning

-idw

この操作で空き容量が不十分という警告を無視するかどうかを指定します。デフォルトはfalseです。

ターゲットがNFSでマウントされている場合、またはData ONTAPなどの異なるファイル・システムにある場合、このフラグを使用する必要がある場合があります。

オプション

20.2.1.2 pasteBinaryスクリプト

ソースのMiddlewareホームのバイナリ・ファイルをターゲット環境に貼り付けることによって、アーカイブをターゲットの宛先に適用します。アーカイブは同一ホストに適用することも別のホストに適用することもできます。

pasteBinaryスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/pasteBinary.sh
(Windows) ORACLE_COMMON_HOME\bin\pasteBinary.cmd

構文は次のとおりです。

pasteBinary -javaHome path_of_jdk
-archiveLoc archive_location
-targetMWHomeLoc target_MW_Home_location
[-executeSysPrereqs {true | false}]
[-invPtrLoc Oracle_InventoryLocation]
[-logDirLoc log_dir_path]
[-silent {true | false}]
[-ignoreDiskWarning {true | false}]

次の例は、Linux上のディレクトリ/scratch/oracle/MW_Home_prodにアーカイブを適用する方法を示しています。

pasteBinary.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc  /tmp/mw_copy.jar
-targetMWHomeLoc /scratch/oracle/MW_Home_prod

表20-4は、pasteBinaryスクリプトのオプションを説明しています。

表20-4 pasteBinaryスクリプトのオプション

オプション

ショートカット

説明

必須かオプションか

-javaHome

該当なし

JDKの絶対パス。

ソースMiddlewareホームが、JDKとOracle JRockitがMiddlewareホームの外部にある状態でインストールされた場合、指定するパスがMiddlewareホームの構成に使用されます。

スクリプトによりオペレーティング・システムが64ビットかどうかが検出され、コマンドラインでスクリプトに-d64オプションが渡されます。

必須

-archiveLoc

-al

アーカイブの場所の絶対パス。このオプションは、copyBinaryスクリプトを使用して作成するアーカイブ・ファイルの場所の指定に使用します。

既存の場所である必要があります。

以前のリリースではこのオプションはarchiveLocationという名前でしたが、この名前は現在は非推奨です。

必須

-targetMWHomeLoc

-tmw

ターゲットのMiddlewareホームの絶対パス。

これによって指定される場所に、Middlewareホームのディレクトリが存在しないことを確認してください。存在している場合、このスクリプトを実行するとエラー・メッセージが発生します。

targetMWHomeLocを別のMiddlewareホーム内に指定することはできません。

以前のリリースではこのオプションはtargetLocationという名前で、ショートカットは-tlでしたが、これらは現在は非推奨です。

必須

-executeSysPrereqs

-esp

pasteBinary操作でOracleホームの前提条件を確認するかどうかを指定します。デフォルトでは、前提条件が確認されます。前提条件を確認しないことを指定するには、このオプションを値falseで指定します。

以前のリリースではショートカットは-exsysprereqsでしたが、現在は非推奨です。

オプション

-invPtrLoc

-ipl

UNIXおよびLinuxでは、Oracleインベントリ・ポインタへの絶対パス。このオプションは、インベントリの場所がデフォルトの場所(/etc/oraInst.loc)ではない場合に使用します。これによって、操作は、Oracleインベントリ・ポインタ・ファイルで指定された中央OracleインベントリにOracleホームを登録できるようになります。

oraInst.locがデフォルトの場所にない場合は、このファイルを、ルート・ユーザーとしてデフォルトの場所に、あるいはルート・ユーザーまたは通常ユーザーとしてその他の任意の場所に作成する必要があります。次では、このファイルのコンテンツの例を示しています。

inventory_loc=/scratch/oraInventory

inventory_locとして指定されたディレクトリが存在しない場合は、操作により作成されます。

インベントリの場所への書込み権限が必要です。

UNIXおよびLinuxでは、デフォルトの場所は/etc/oraInst.locです。

Windowsでは、このパラメータを指定しても無視されます。

以前のリリースではショートカットは-invLocでしたが、現在は非推奨です。

インベントリがデフォルトの場所にある場合は、オプション。それ以外の場合は、Linuxでは必須。

-logDirLoc

-ldl

ディレクトリの絶対パス。存在しない場合は、スクリプトにより作成されます。クローンおよびエラー・ログ・ファイルがこのディレクトリに作成されます。デフォルトは、システムの一時ディレクトリです。

オプション

-silent

該当なし

操作をサイレントで実行するかどうかを指定します。サイレントの場合は、確認のためのプロンプトを表示しません。デフォルトでは、確認のためのプロンプトが表示されます。続行するには、yesと入力します(大/小文字は区別されません)。yes以外を入力すると、スクリプトからエラーが返されます。

確認のためのプロンプトを表示しないことを指定するには、このオプションを値trueで指定します。

オプション

-ignoreDiskWarning

-idw

この操作で空き容量が不十分という警告を無視するかどうかを指定します。デフォルトはfalseです。

ターゲットがNFSでマウントされている場合、またはData ONTAPなどの異なるファイル・システムにある場合、このフラグを使用する必要がある場合があります。

オプション

20.2.1.3 Javaコンポーネント用のcopyConfigスクリプト

Oracle WebLogic Serverドメインの構成のスナップショットが含まれる構成アーカイブを作成します。Oracle WebLogic Serverドメインの元になるコンポーネントは、ファイル・システム、Oracle Metadata Service(MDS)、LDAP、データベースなどの様々なデータ・ストアに構成情報を保持します。

copyConfigスクリプトは、ソース環境のそれぞれのOracle WebLogic Serverドメインで実行する必要があります。構成アーカイブは、それぞれのソース・ドメインに対して作成されます。

スクリプトを実行するときに、管理サーバーとドメイン内のすべての管理対象サーバーが起動している必要があります。

copyConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd

構文は次のとおりです。

copyConfig  -javaHome path_of_jdk
-archiveLoc archive_location
-sourceDomainLoc domain_location
-sourceMWHomeLoc Middleware_home_location
-domainHostName domain_host_name
-domainPortNum  domain_port_number
-domainAdminUserName domain_admin_username
-domainAdminPasswordFile domain_admin_password_file
[-mdsDataExport {true | false}]
[-opssDataExport {true | false}]
[-additionalParams property1=value1[, property2=value2]
[-logDirLoc log_dir_path]
[-silent {true | false}]

次の例では、Javaコンポーネントが含まれるドメインの構成をコピーしています。

copyConfig.sh -javaHome /scratch/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/a.jar
-sourceDomainLoc /scratch/oracle/config/domains/WLS_SOAWC
-sourceMWHomeLoc /scratch/work/mw_home1/
-domainHostName myhost.example.com
-domainPortNum 7001
-domainAdminUserName weblogic
-domainAdminPasswordFile /home/oracle/password
-silent true

表20-5は、Javaコンポーネント用のcopyConfigスクリプトのオプションを説明しています。

表20-5 Javaコンポーネント用のcopyConfigスクリプトのオプション

オプション

ショートカット

説明

必須かオプションか

-javaHome

該当なし

JDKの絶対パス。

スクリプトによりオペレーティング・システムが64ビットかどうかが検出され、コマンドラインでスクリプトに-d64オプションが渡されます。

必須

-archiveLoc

-al

アーカイブの場所の絶対パス。このオプションは、copyConfigスクリプトを使用して作成するアーカイブ・ファイルの場所の指定に使用します。

必須

-sourceDomainLoc

-sdl

Javaコンポーネントが含まれるソース・ドメインの絶対パス。

Windowsでは、バックスラッシュをパスの末尾に含めないでください。

必須

-sourceMWHomeLoc

-smw

ソースのMiddlewareホームの絶対パス。

必須

-domainHostName

-dhn

ドメインが構成されているホストの名前。

必須

-domainPortNum

-dpn

ドメインの管理サーバーのポート番号。

以前のリリースではこのオプションはdomainPortNoという名前で、ショートカットは-domainportでしたが、これらは現在は非推奨です。

必須

-domainAdminUserName

-dau

ドメインの管理ユーザーの名前。

以前のリリースではショートカットは-domainuserでしたが、現在は非推奨です。

必須

-domainAdminPasswordFile

-dap

ソース環境のドメインの管理ユーザーのパスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

以前のリリースではショートカットは-domainpassでしたが、現在は非推奨です。

必須

-mdsDataExport

-mdi

アプリケーションMDSメタデータをターゲットにインポートできるように、アーカイブにエクスポートするかどうかを指定します。デフォルトはtrueです。

アプリケーションMDSメタデータにエクスポートしない場合は、falseを指定します。

このオプションがtrueに設定されると、コンポーネントをターゲットにコピーするpasteConfigスクリプトは、それ以降アプリケーションMDSメタデータをターゲットにインポートします。

オプション

-opssDataExport

-opss

Oracle Platform Security Servicesデータをエクスポートするかどうかを指定します。デフォルトはtrueです。

このオプションがtrueに設定されると、コンポーネントをターゲットにコピーするそれ以降のpasteConfigスクリプトは、Oracle Platform Security Servicesデータをターゲットにインポートします。

注意: このオプションをtrueに設定した場合、pasteConfigスクリプトを実行する前に次の環境変数を設定する必要があります。

CONFIG_JVM_ARGS "-Xmx2048M -Xms2048M"

オプション

-logDirLoc

-ldl

ディレクトリの絶対パス。存在しない場合は、スクリプトにより作成されます。クローンおよびエラー・ログ・ファイルがこのディレクトリに作成されます。デフォルトは、システムの一時ディレクトリです。

オプション

-additionalParams

-ap

追加パラメータと、スクリプトに渡されるその値。

オプション

-silent

該当なし

操作をサイレントで実行するかどうかを指定します。サイレントの場合は、確認のためのプロンプトを表示しません。デフォルトでは、確認のためのプロンプトが表示されます。続行するには、yesと入力します(大/小文字は区別されません)。yes以外を入力すると、スクリプトからエラーが返されます。

確認のためのプロンプトを表示しないことを指定するには、このオプションを値trueで指定します。

オプション

20.2.1.4 Oracleインスタンス用のcopyConfigスクリプト

Oracleインスタンスの構成のスナップショットが含まれる構成アーカイブを作成します。copyConfigスクリプトは、Oracleインスタンスと、Oracleインスタンスのすべてのシステム・コンポーネントの構成を移行します。

copyConfigスクリプトは、ソース環境のそれぞれのOracleインスタンスで実行する必要があります。構成アーカイブは、それぞれのOracleインスタンスに対して作成されます。

スクリプトを実行するときに、管理サーバーとドメイン内のすべての管理対象サーバーが起動している必要があります。

copyConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd

構文は次のとおりです。

copyConfig  -javaHome path_of_jdk
-archiveLoc archive_location
-sourceInstanceHomeLoc src_instance_path
[-additionalParams property1=value1[, property2=value2]
[-logDirLoc log_dir_path]
[-silent {true | false}]

次の例は、Linuxの/scratch/Oracle/Middleware/im_1にあるOracleインスタンスのアーカイブを作成する方法を示しています。

copyConfig.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/ovd1.jar
-sourceInstanceHomeLoc /scratch/Oracle/Middleware1/im_1

表20-6は、Oracleインスタンス用のcopyConfigスクリプトのオプションを説明しています。また、個々のシステム・コンポーネント用のcopyConfigスクリプトのオプションも説明していますが、唯一の違いは、-sourceComponentNameオプションを使用して個々のシステム・コンポーネントを移行することです。

表20-6 Oracleインスタンスおよびシステム・コンポーネント用のcopyConfigスクリプトのオプション

オプション

ショートカット

説明

必須かオプションか

-javaHome

該当なし

JDKの絶対パス。

スクリプトによりオペレーティング・システムが64ビットかどうかが検出され、コマンドラインでスクリプトに-d64オプションが渡されます。

必須

-archiveLoc

-al

アーカイブの場所の絶対パス。このオプションは、copyConfigスクリプトを使用して作成するアーカイブ・ファイルの場所の指定に使用します。

以前のリリースではこのオプションはarchiveLocationという名前でしたが、この名前は現在は非推奨です。

必須

-sourceInstanceHomeLoc

-sih

ソース・コンポーネントのOracleインスタンスの絶対パス。

必須

-additionalParams

-ap

追加パラメータと、スクリプトに渡されるその値。

オプション

-logDirLoc

-ldl

ディレクトリの絶対パス。存在しない場合は、スクリプトにより作成されます。クローンおよびエラー・ログ・ファイルがこのディレクトリに作成されます。デフォルトは、システムの一時ディレクトリです。

オプション

-silent

該当なし

操作をサイレントで実行するかどうかを指定します。サイレントの場合は、確認のためのプロンプトを表示しません。デフォルトでは、確認のためのプロンプトが表示されます。続行するには、yesと入力します(大/小文字は区別されません)。yes以外を入力すると、スクリプトからエラーが返されます。

確認のためのプロンプトを表示しないことを指定するには、このオプションを値trueで指定します。

オプション

-sourceComponentName

-scn

コピー対象のコンポーネントの名前。たとえば、Oracle Internet Directoryがコンポーネントoid1という名前である場合、oid1と指定します。

オプション。第20.2.1.5項で説明するように、システム・コンポーネントを1つのみ移行する場合に使用します。

20.2.1.5 システム・コンポーネント用のcopyConfigスクリプト

Oracleインスタンスおよび指定された個々のシステム・コンポーネントの構成のスナップショットが含まれる構成アーカイブを作成し、ファイル・システム、Oracle Metadata Service(MDS)、LDAP、データベースなどの様々なデータ・ストアに構成情報を保持します。

Oracleインスタンスとともにシステム・コンポーネントを1つのみターゲット環境に移行する場合は、Oracleインスタンス用のcopyConfigではなくこのスクリプトを使用します。

copyConfigスクリプトは、次のシステム・コンポーネントの移行をサポートします。

- Oracle HTTP Server

- Oracle Internet Directory

- Oracle Virtual Directory

- Oracle BI EE

スクリプトを実行するときに、管理サーバーとドメイン内のすべての管理対象サーバーが起動している必要があります。

copyConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd

構文は次のとおりです。

copyConfig  -javaHome path_of_jdk
-archiveLoc archive_location
-sourceInstanceHomeLoc src_instance_path
-sourceComponentName src_component_name
[-logDirLoc log_dir_path]
[-silent {true | false}]

次の例は、Linuxの/scratch/Oracle/Middleware/im_1にあるOracleインスタンス内のovd1という名前のOracle Virtual Directoryインスタンスのアーカイブを作成する方法を示しています。

copyConfig.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/ovd1.jar
-sourceInstanceHomeLoc /scratch/Oracle/Middleware1/im_1
-sourceComponentName ovd1

システム・コンポーネント用のcopyConfigスクリプトのオプションの説明は、表20-6を参照してください。

20.2.1.6 ノード・マネージャ用のcopyConfigスクリプト

ノード・マネージャの構成のスナップショットが含まれる構成アーカイブを作成します。

copyConfigスクリプトは、ソース環境のそれぞれのノード・マネージャで実行する必要があります。構成アーカイブは、それぞれのソース・ノード・マネージャに対して作成されます。

copyConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd

構文は次のとおりです。

copyConfig  -javaHome path_of_jdk
-archiveLoc archive_location
-sourceNMHomeLoc source_Node_Manager_Home_location
[-logDirLoc log_dir_path]
[-silent {true | false}]

次の例は、/scratch/Oracle/Middleware/wlserver_10.3/common/nodemanagerにあるソース・ノード・マネージャの構成のコピーを作成する方法を示しています。

copyConfig.sh -javaHome USER_HOME/jrockit_160_17_R28.0.0-679/
-archiveLoc /tmp/nm.jar
-sourceNMHomeLoc /scratch/Oracle/Middleware/wlserver_10.3/common/nodemanager
-silent true

表20-7は、ノード・マネージャ用のcopyConfigスクリプトのオプションを説明しています。

表20-7 ノード・マネージャ用のcopyConfigスクリプトのオプション

オプション

ショートカット

説明

必須かオプションか

-javaHome

なし

JDKの絶対パス。

スクリプトによりオペレーティング・システムが64ビットかどうかが検出され、コマンドラインでスクリプトに-d64オプションが渡されます。

必須

-archiveLoc

-al

アーカイブの場所の絶対パス。このオプションは、copyConfigスクリプトを使用して作成するアーカイブ・ファイルの場所の指定に使用します。

必須

-sourceNMHomeLoc

-snh

ソースのノード・マネージャ・ホームの絶対パス。

必須

-logDirLoc

-ldl

ディレクトリの絶対パス。存在しない場合は、スクリプトにより作成されます。クローンおよびエラー・ログ・ファイルがこのディレクトリに作成されます。デフォルトは、システムの一時ディレクトリです。

オプション

-silent

なし

操作をサイレントで実行するかどうかを指定します。サイレントの場合は、確認のためのプロンプトを表示しません。デフォルトでは、確認のためのプロンプトが表示されます。続行するには、yesと入力します(大/小文字は区別されません)。yes以外を入力すると、スクリプトからエラーが返されます。

確認のためのプロンプトを表示しないことを指定するには、このオプションを値trueで指定します。

オプション

20.2.1.7 extractMovePlanスクリプト

構成情報をアーカイブから移動計画に抽出します。また、必要な構成計画もすべて抽出します。抽出した移動計画を編集して、ターゲット環境のプロパティを指定します。

extractMovePlanスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/extractMovePlan.sh
(Windows) ORACLE_COMMON_HOME\bin\extractMovePlan.cmd

構文は次のとおりです。

extractMovePlan -javaHome path_of_jdk
-archiveLoc archive_location
-planDirLoc move_plan_directory
[-optimizationHints fusionApps,sameSchemaNameSinglePassword, rpdDataSource}
[-logDirLoc log_dir_path]

次の例では、アーカイブj2ee.jarから計画を抽出します。

extractMovePlan.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/j2ee.jar
-planDirLoc /scratch/Oracle/t2p_plans

extractMovePlanスクリプトでは、移動計画を指定されたディレクトリに抽出します。移行するコンポーネントのタイプに応じて、extractMovePlanスクリプトは他の構成計画を抽出する場合もあります。

- Oracle SOA SuiteなどのJavaコンポーネントでは、次のファイルを抽出します。

/scratch/Oracle/t2p_plans/moveplan.xml
/scratch/Oracle/t2p_plans/composites/configplan1.xml
/scratch/Oracle/t2p_plans/composites/configplan2.xml
/scratch/Oracle/t2p_plans/adapters/deploymentplan1.xml
/scratch/Oracle/t2p_plans/adapters/deploymentplan2.xml

- Oracle Internet DirectoryやOracle Virtual Directoryなどのシステム・コンポーネントでは、次のファイルを抽出します。

/scratch/Oracle/t2p_plans/moveplan.xml

表20-8は、extractMovePlanスクリプトのオプションを説明しています。

表20-8 extractMovePlanスクリプトのオプション

オプション

ショートカット

説明

必須かオプションか

-javaHome

該当なし

JDKの絶対パス。

スクリプトによりオペレーティング・システムが64ビットかどうかが検出され、コマンドラインでスクリプトに-d64オプションが渡されます。

必須

-archiveLoc

-al

アーカイブの場所の絶対パス。このオプションは、copyConfigスクリプトを使用して作成するアーカイブ・ファイルの場所の指定に使用します。

必須

-planDirLoc

-pdl

移動計画と必要な構成計画の抽出先ディレクトリの絶対パス。

存在していないディレクトリを指定する必要があります。

必須

-optimizationHints

opth

ターゲット環境のトポロジに基づいて自動移入する構成値を指定します。これらの値は移動計画に含まれません。環境に当てはまる場合は、ヒントを使用することをお薦めします。

このオプションは、次の引数をとります。

- fusionapps(fa)。-optimzationHintsオプションを使用する場合は、このヒントを指定する必要があります。

- sameSchemaNameSinglePassword(ssnsp)。特定のデータベースに関連付けられているすべてのスキーマに対して同じパスワードが使用されます。

- rpdDataSource(rpdds)。移動計画のRPD_CONFIGセクションで指定されている特定のデータベースに関連付けられているすべてのスキーマに対して同じパスワードが使用されます。
sameSchemaNameSinglePasswordフラグが指定されている場合、このフラグも自動的にtrueに設定されます。

オプション

-logDirLoc

-ldl

ディレクトリの絶対パス。存在しない場合は、スクリプトにより作成されます。クローンおよびエラー・ログ・ファイルがこのディレクトリに作成されます。デフォルトは、システムの一時ディレクトリです。

オプション

移動計画のプロパティおよび編集する必要があるプロパティの詳細は、第20.3項を参照してください。

20.2.1.8 Javaコンポーネント用のpasteConfigスクリプト

ソース環境からコピーされた構成をターゲット環境に適用します。スクリプトの入力には、Javaコンポーネント用のcopyConfigスクリプトで作成された構成アーカイブの場所と変更された移動計画の場所が含まれます。pasteConfigスクリプトでは、ターゲット環境のOracle WebLogic Serverドメインの構成情報を再作成します。また、ターゲット環境の移動計画のプロパティ値もマージします。

pasteConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd

構文は次のとおりです。

pasteConfig  -javaHome path_of_jdk
-archiveLoc archive_location
-targetDomainLoc trgt_domain_path
-targetMWHomeLoc trgt_Middleware_Home_path
-movePlanLoc move_plan_path
-domainAdminPasswordFile domain_admin_password_file
[-appDir WLS_application_directory]
[-logDirLoc log_dir_path]
[-silent {true | false}]

次の例は、ドメインのアーカイブをMiddlewareホームのMW_home1に適用する方法を示しています。

pasteConfig.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/java_ee_cl.jar
-targetDomainLoc /scratch/oracle/config/domains/dom_cl
-targetMWHomeLoc /scratch/oracle/MW_home1
-movePlanLoc /scratch/oracle/java_ee/move_plan.xml
-domainAdminPasswordFile /scratch/pwd_dir/pass
-logDirLoc /tmp/log

表20-9は、Javaコンポーネント用のpasteConfigスクリプトのオプションを説明しています。

表20-9 Javaコンポーネント用のpasteConfigスクリプトのオプション

オプション

ショートカット

説明

必須かオプションか

-javaHome

該当なし

JDKの絶対パス。

スクリプトによりオペレーティング・システムが64ビットかどうかが検出され、コマンドラインでスクリプトに-d64オプションが渡されます。

必須

-archiveLoc

-al

アーカイブの場所の絶対パス。このオプションは、copyConfigスクリプトを使用して作成するアーカイブ・ファイルの場所の指定に使用します。

必須

-targetDomainLoc

-tdl

ターゲット・ドメインの絶対パス。ドメインの場所は存在している必要はありません。

ドメイン・ディレクトリは、Middlewareホームのディレクトリ構造の外部に配置できます。

必須

-targetMWHomeLoc

-tmw

ターゲットのMiddlewareホームの絶対パス。

必須

-movePlanLoc

-mpl

ソースから抽出する移動計画の絶対パス。

必須

-domainAdminPasswordFile

-dap

ターゲット環境のドメインの管理ユーザーのパスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

パスワードはドメインの認証プロバイダに基づいています。たとえば、認証プロバイダには組込みLDAPや外部LDAPなどがあります。

以前のリリースではショートカットは-domainpassでしたが、現在は非推奨です。

必須

-appDir

-ad

ターゲットのOracle WebLogic Serverアプリケーション・ディレクトリの絶対パス。

オプション

-logDirLoc

-ldl

ディレクトリの絶対パス。存在しない場合は、スクリプトにより作成されます。クローンおよびエラー・ログ・ファイルがこのディレクトリに作成されます。デフォルトは、システムの一時ディレクトリです。

オプション

-silent

該当なし

操作をサイレントで実行するかどうかを指定します。サイレントの場合は、確認のためのプロンプトを表示しません。デフォルトでは、確認のためのプロンプトが表示されます。続行するには、yesと入力します(大/小文字は区別されません)。yes以外を入力すると、スクリプトからエラーが返されます。

確認のためのプロンプトを表示しないことを指定するには、このオプションを値trueで指定します。

オプション

いずれかのデータソース名にスラッシュ(/)が含まれる場合、pasteConfigによりそのデータソースは移行されません。

20.2.1.9 Oracleインスタンス用のpasteConfigスクリプト

ソース環境からコピーされた構成をターゲット環境に適用します。スクリプトの入力には、Oracleインスタンス用のcopyConfigスクリプトで作成された構成アーカイブの場所と変更された移動計画の場所が含まれます。pasteConfigスクリプトでは、ターゲット環境のOracleインスタンスおよびそのすべてのシステム・コンポーネントの構成情報を反復および再作成します。また、ターゲット環境の移動計画のプロパティ値もマージします。

構文は次のとおりです。

pasteConfig  -javaHome path_of_jdk
-archiveLoc archive_location
-movePlanLoc move_plan_path
-targetInstanceHomeLoc trgt_Instance_path
[-targetInstanceName trgt_Instance_name]
[-targetOracleHomeLoc trgt_ORACLE_HOME_path]
[-logDirLoc log_dir_path]
[-silent {true | false}]
[ <Domain Detail> ]

<Domain Detail> =
-domainHostName domain_host_name
-domainPortNum  domain_port_number
-domainAdminUserName domain_admin_username
-domainAdminPasswordFile domain_admin_password_file

次の例は、ターゲットにアーカイブを適用し、Oracleインスタンスをim_2と命名する方法を示しています。

pasteConfig.sh -javaHome /scratch/Oracle/Middleware/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/ovd1.jar
-movePlanLoc /scratch/oracle/ovd/move_plan.xml
-targetOracleHomeLoc /scratch/Oracle/Middleware/Oracle_IM2
-targetInstanceHomeLoc /scratch/Oracle/Middleware/im_2
-targetInstanceName im_2
-domainHostName myhost
-domainPortNum 7001
-domainAdminUserName domain_admin_username
-domainAdminPasswordFile domain_admin_password_file

表20-10は、システム・コンポーネント用のpasteConfigスクリプトのオプションを説明しています。また、個々のシステム・コンポーネント用のpasteConfigスクリプトのオプションも説明しています。唯一の違いは、-sourceComponentNameオプションを使用して個々のシステム・コンポーネントを移動することです。

表20-10 Oracleインスタンス用のpasteConfigスクリプトのオプション

オプション

ショートカット

説明

必須かオプションか

-javaHome

該当なし

JDKの絶対パス。

スクリプトによりオペレーティング・システムが64ビットかどうかが検出され、コマンドラインでスクリプトに-d64オプションが渡されます。

必須

-archiveLoc

-al

アーカイブの場所の絶対パス。このオプションは、copyConfigスクリプトを使用して作成するアーカイブ・ファイルの場所の指定に使用します。

必須

-movePlanLoc

-mpl

ソースから抽出する移動計画の絶対パス。

必須

-targetInstanceHomeLoc

-tih

ターゲットのOracleインスタンスの絶対パス。

Oracleインスタンス・ディレクトリがその場所に存在していない場合、スクリプトによってディレクトリが作成されます。

必須

-targetInstanceName

-tin

ターゲットのOracleインスタンスの名前で、ドメインにインスタンスを登録するために使用されます。

この名前はドメイン内で一意にする必要があります。

targetInstanceHomeLocディレクトリが存在している場合は、オプション。この場合、構成から名前が取得されます。

-targetComponentName

-tcn

コピーするターゲット・コンポーネントの名前。名前はインスタンスで一意にする必要があります。

オプション。第20.2.1.5項で説明するように、システム・コンポーネントを1つのみ移行する場合に使用します。

-targetOracleHomeLoc

-toh

ターゲットのOracleホームの絶対パス。

ターゲットOracleホームが存在し、その中にコピーするコンポーネントのバイナリが含まれている必要があります。

targetInstanceHomeLocが存在している場合は、オプション。この場合、構成から値が取得されます。

-logDirLoc

-ldl

ディレクトリの絶対パス。存在しない場合は、スクリプトにより作成されます。クローンおよびエラー・ログ・ファイルがこのディレクトリに作成されます。デフォルトは、システムの一時ディレクトリです。

オプション

-silent

該当なし

操作をサイレントで実行するかどうかを指定します。サイレントの場合は、確認のためのプロンプトを表示しません。デフォルトでは、確認のためのプロンプトが表示されます。続行するには、yesと入力します(大/小文字は区別されません)。yes以外を入力すると、スクリプトからエラーが返されます。

確認のためのプロンプトを表示しないことを指定するには、このオプションを値trueで指定します。

オプション

ドメイン詳細オプション

-domainHostName

-dhn

ドメインが構成されているホストの名前。

コンポーネントをドメインに登録する場合、このオプションを使用します。

以前のリリースではショートカットは-domainhostでしたが、現在は非推奨です。

ドメインにコンポーネントを登録しない場合は、オプション。

-domainPortNum

-dpn

ドメインのポート番号。

コンポーネントをドメインに登録する場合、このオプションを使用します。

ドメインのポート番号は、次のファイル内にadminPortとして記載されています。

ORACLE_INSTANCE/config/OPMN/opmn/instance.properties

例: adminPort=7001

ドメインにコンポーネントを登録しない場合は、オプション。

-domainAdminUserName

-dau

ドメインの管理ユーザーの名前。

コンポーネントをドメインに登録する場合、このオプションを使用します。

ドメインにコンポーネントを登録しない場合は、オプション。

-domainAdminPasswordFile

-dap

ドメインの管理ユーザーのパスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

コンポーネントをドメインに登録する場合、このオプションを使用します。

ドメインにコンポーネントを登録しない場合は、オプション。

いずれかのデータソース名にスラッシュ(/)が含まれる場合、pasteConfigによりそのデータソースは移行されません。

20.2.1.10 システム・コンポーネント用のpasteConfigスクリプト

ソース環境からコピーされた個々のシステム・コンポーネントの構成をターゲット環境に適用します。スクリプトの入力には、Oracleインスタンス用のcopyConfigスクリプトで作成された構成アーカイブの場所と変更された移動計画の場所が含まれます。pasteConfigスクリプトでは、ターゲット環境のOracleインスタンスおよび指定されたシステム・コンポーネントの構成情報を再作成します。また、ターゲット環境の移動計画のプロパティ値もマージします。

pasteConfigスクリプトは、次のシステム・コンポーネントの移行をサポートします。

- Oracle HTTP Server

- Oracle Internet Directory

- Oracle Virtual Directory

- Oracle BI EE

構文は次のとおりです。

pasteConfig  -javaHome path_of_jdk
-archiveLoc archive_location
-movePlanLoc move_plan_path
-targetComponentName trgt_component_name
-targetInstanceHomeLoc trgt_Instance_path
[-targetInstanceName trgt_Instance_name]
[-targetOracleHomeLoc trgt_ORACLE_HOME_path]
[-logDirLoc log_dir_path]
[-silent {true | false}]
[ <Domain Detail> ]

<Domain Detail> =
-domainHostName domain_host_name
-domainPortNum  domain_port_number
-domainAdminUserName domain_admin_username
-domainAdminPasswordFile domain_admin_password_file

次の例は、Oracleインスタンスim_2にアーカイブを適用し、ターゲットのOracle Virtual Directoryインスタンスにovd_clという名前を付ける方法を示しています。

pasteConfig.sh -javaHome /scratch/Oracle/Middleware/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/ovd1.jar
-movePlanLoc /scratch/oracle/ovd/move_plan.xml
-targetOracleHomeLoc /scratch/Oracle/Middleware/Oracle_IM2
-targetInstanceHomeLoc /scratch/Oracle/Middleware/im_2
-targetInstanceName im_2
-targetComponentName ovd_cl
-domainHostName myhost
-domainPortNum 7001
-domainAdminUserName domain_admin_username
-domainAdminPasswordFile domain_admin_password_file

システム・コンポーネント用のpasteConfigスクリプトのオプションの説明は、表20-10を参照してください。

20.2.1.11 ノード・マネージャ用のpasteConfigスクリプト

ソース環境からコピーされたノード・マネージャの構成をターゲット環境に適用します。スクリプトの入力には、Oracle WebLogic Serverノード・マネージャ用のcopyConfigスクリプトで作成された構成アーカイブの場所と変更された移動計画の場所が含まれます。pasteConfigスクリプトでは、ターゲット環境のノード・マネージャの構成情報を再作成します。また、ターゲット環境の移動計画のプロパティ値もマージします。

注意:

ノード・マネージャのコピーをターゲット環境に適用する前に、ノード・マネージャで管理されるすべてのドメインを移行する必要があります。また、管理サーバーが実行されている必要があります。

ソース・ノード・マネージャにおいて、管理サーバーとノード・マネージャ間の接続がSSLで構成されている場合でも、ノード・マネージャのコピーをターゲット環境に適用した後は、管理サーバーおよびノード・マネージャの両方でプレーンなソケット接続タイプに変更されます。

pasteConfigスクリプトは、ソース環境のそれぞれのノード・マネージャで実行する必要があります。

構文は次のとおりです。

pasteConfig  -javaHome path_of_jdk
-archiveLoc archive_location
-targetNMHomeLoc trgt_Node_Manager_Home_path
-targetMWHomeLoc trgt_Middleware_Home_path
-movePlanLoc move_plan_path
[-logDirLoc log_dir_path]
[-silent {true | false}]

次の例は、/scratch/Oracle/Middleware1/wlserver_10.3/common/nodemanagerにあるノード・マネージャ・ホームにノード・マネージャのコピーを適用する方法を示しています。

pasteConfig -javaHome USER_HOME/jrockit_160_17_R28.0.0-679/
-archiveLoc /tmp/nm.jar
-targetNMHomeLoc /scratch/Oracle/Middleware1/wlserver_10.3/common/nodemanager
-targetMWHomeLoc /scratch/Oracle/Middleware1
-movePlanLoc /scratch/oracle/t2pplans/nm/moveplan.xml
-silent true

表20-11は、ノード・マネージャ用のpasteConfigスクリプトのオプションを説明しています。

表20-11 ノード・マネージャ用のpasteConfigスクリプトのオプション

オプション

ショートカット

説明

必須かオプションか

-javaHome

なし

JDKの絶対パス。

スクリプトによりオペレーティング・システムが64ビットかどうかが検出され、コマンドラインでスクリプトに-d64オプションが渡されます。

必須

-archiveLoc

-al

アーカイブの場所の絶対パス。このオプションは、copyConfigスクリプトを使用して作成するアーカイブ・ファイルの場所の指定に使用します。

必須

-targetNMHomeLoc

-tnh

ターゲットのノード・マネージャの絶対パス。

必須

-targetMWHomeLoc

-tmw

ノード・マネージャのコピーが適用されるターゲットMiddlewareホームの絶対パス。

必須

-movePlanLoc

-mpl

変更された移動計画のターゲット環境での絶対パス。

必須

-logDirLoc

-ldl

ディレクトリの絶対パス。存在しない場合は、スクリプトにより作成されます。クローンおよびエラー・ログ・ファイルがこのディレクトリに作成されます。デフォルトは、システムの一時ディレクトリです。

オプション

-silent

なし

操作をサイレントで実行するかどうかを指定します。サイレントの場合は、確認のためのプロンプトを表示しません。デフォルトでは、確認のためのプロンプトが表示されます。続行するには、yesと入力します(大/小文字は区別されません)。yes以外を入力すると、スクリプトからエラーが返されます。

確認のためのプロンプトを表示しないことを指定するには、このオプションを値trueで指定します。

オプション

20.2.1.12 obfuscatePasswordスクリプト

不明瞭化されたパスワードが含まれるファイルを生成します。スクリプトおよび移動計画では、しばしばパスワードが含まれるファイルを指定する必要があります。スクリプトによって、パスワードおよびパスワード・ファイルが書き込まれる場所の入力を求めるプロンプトが表示されます。

構文は次のとおりです。

(UNIX) ORACLE_COMMON_HOME/bin/obfuscatePassword.sh
(Windows) ORACLE_COMMON_HOME\bin\obfuscatePassword.cmd

20.3 移動計画の変更

Oracle Fusion Middlewareコンポーネントを移行する際には、extractMovePlanスクリプトを実行して、移行するエンティティの移動計画を作成します。extractMovePlanスクリプトは、構成情報をアーカイブから移動計画に抽出します。また、必要な構成計画もすべて抽出します。アーカイブをターゲットに適用する前に、ターゲット環境の値を反映するように、移動計画を編集する必要があります。

READ_WRITEのスコープのプロパティを変更できます。READ_ONLYのスコープのプロパティは変更しないでください。

注意:

- 移動計画のセクションの追加、コメント化または削除はしないでください。

- 移動計画に変更を加えていなくても、アーカイブを作成するたびに、extractMovePlanスクリプトを使用して移動計画を生成する必要があります。別のアーカイブで作成された移動計画を使用すると、アーカイブは受け入れられず、pasteConfigスクリプトは失敗します。

この項の項目は次のとおりです。

- configGroup要素の場所

- 移動計画のプロパティ

20.3.1 configGroup要素の場所

ほとんどの移動計画には複数のconfigGroup要素が含まれます。特定のconfigGroup要素に関連付けられるプロパティについて、一覧表にconfigGroup要素ごとのプロパティがまとめています。たとえば、表20-14は、Javaコンポーネントの移動計画のプロパティの説明ですが、ここではSERVER_CONFIGやMACHINE_CONFIGなどの複数のconfigGroup要素が示されています。

次の例では、SERVER_CONFIGおよびMACHINE_CONFIG configGroup要素を使用したJavaコンポーネントの移動計画の一部を示しています。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<movePlan>
<movableComponent>
<componentType>J2EEDomain</componentType>
<moveDescriptor>
<StartupMode>PRODUCTION</StartupMode>
<configGroup>
<type>SERVER_CONFIG</type>
<configProperty id="Server1">
<configProperty>
<name>Server Name</name>
<value>AdminServer</value>
<itemMetadata>
<dataType>STRING</dataType>
<scope>READ_ONLY</scope>
</itemMetadata>
</configProperty>
.
.
.
</configGroup>
<configGroup>
<type>MACHINE_CONFIG</type>
<configProperty id="Machine1">
<configProperty>
<name>Machine Name</name>
<value>LocalMachine</value>
<itemMetadata>
<dataType>STRING</dataType>
<scope>READ_WRITE</scope>
</itemMetadata>
</configProperty>
<configProperty>
<name>Node Manager Listen Address</name>
<value>example.com</value>
<itemMetadata>
<dataType>STRING</dataType>
<scope>READ_WRITE</scope>
</itemMetadata>
</configProperty>
.
.
.
</configGroup>

20.3.2 移動計画のプロパティ

この項の表で、Oracle Fusion Middlewareエンティティおよびコンポーネント用にカスタマイズできる移動計画のプロパティについて説明します。

注意:

多くの移動計画のプロパティでは、パスワードが含まれるファイルの場所を指定する必要があります。不明瞭化されたパスワードを使用する場合は、第20.2.1.12項の説明に従って、obfuscatePasswordスクリプトを使用できます。

編集するプロパティは、コンポーネントのタイプによって異なります。表20-12に各コンポーネントに応じたプロパティの一覧の場所を示します。

表20-12 コンポーネントの移動計画のプロパティ

コンポーネント

プロパティの一覧の場所:

ノード・マネージャ

表20-13

すべてのJavaコンポーネント

表20-14

Oracle Access Manager

表20-14、表20-33

Oracle Adaptive Access Manager

表20-14、表20-34

Oracle ADF接続

表20-15

Oracle B2B

表20-20

Oracle BI EE

表20-14、表20-15、表20-25、オプションで表20-26、表20-27、表20-28、表20-29

Oracle BI Publisher

表20-14、表20-15、表20-25

Oracle Business Activity Monitoring

表20-17

Oracle Data Integrator

表20-32

Oracle Essbase

表20-26

Oracle HTTP Server

表20-21

Oracle Identity Federation

表20-14、表20-24

Oracle Internet Directory

表20-22

Oracle Service Bus

表20-18

Oracle SOA Suite

表20-14、表20-15、表20-16

Oracle User Messaging Service

表20-14、表20-15、表20-16、表20-19

Oracle Virtual Directory

表20-23

Oracle WebCenter Contentサーバー

表20-14、表20-15、表20-30

Oracle WebCenter Content: Imaging

表20-14、表20-15、表20-31

Oracle WebCenter Content: Inbound Refinery:

表20-14、表20-15、表20-30

Oracle WebCenter Content: Records

表20-14、表20-15、表20-30

表20-13は、ノード・マネージャ用に変更できる移動計画のプロパティを説明しています。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-13 ノード・マネージャの移動計画のプロパティ

プロパティ

説明

サンプル値

NODE_MANAGER_PROPERTIES configGroupのプロパティ:

ノード・マネージャの構成

Listen Address

ノード・マネージャのリスニング・アドレス。

example.com

Listen Port

ノード・マネージャのリスニング・ポートの番号。

5557

Custom Identity KeyStore File

カスタムIDキーストア・ファイルの場所の絶対パス

このプロパティは、ソース環境がSSLで構成されている場合にのみ、移動計画に存在します。

/scratch/Oracle/Middleware/wlserver_10.3/server/lib/example_identity.jks

Custom Identity Private Key Alias

IDキー・ストアの別名の値

このプロパティは、ソース環境がSSLで構成されている場合にのみ、移動計画に存在します。

mykey

Custom Identity Private Key Passphrase File

証明書の作成時に使用される秘密鍵が含まれるセキュア・ファイルへの絶対パス

このプロパティは、ソース環境がSSLで構成されている場合にのみ、移動計画に存在します。

/scratch/oracle/key_passwd

DOMAINS configGroupのプロパティ:

Oracle WebLogic Serverのドメイン構成

Domain Name

ドメインの名前。

SOA_domain

Domain Location

ドメインの場所の絶対パス。

/scratch/oracle/config/domains/SOA_domain

AdminServer Listen Address

管理サーバーのリスニング・アドレス。

example.com

AdminServer Listen Port

管理サーバーのリスニング・ポートの番号。

7001

AdminServer User Name

管理者のユーザー名

weblogic

AdminServer Password

管理ユーザーのパスワードが含まれるセキュア・ファイルへの絶対パス。

/scratch/oracle/admin_passwd

Node Manager User Name

ノード・マネージャのユーザー名。

weblogic

Node Manager Password

ノード・マネージャ・ユーザーのパスワードが含まれるセキュア・ファイルへの絶対パス。

/scratch/oracle/nm_passwd

表20-14は、Javaコンポーネント用に変更できる移動計画のプロパティを説明しています。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-14 Javaコンポーネントの移動計画の共通プロパティ

プロパティ

説明

サンプル値

Startup Mode

Oracle WebLogic Serverドメインの起動モード。

有効な値は、次のとおりです。

- DEVELOPMENT。アプリケーションの開発時はこのモードを使用します。開発モードでは、ゆるやかなセキュリティ構成が使用され、アプリケーションを自動デプロイすることができます。

- PRODUCTION。アプリケーションを完成形で実行する場合、このモードを使用します。本番ドメインでは、完全なセキュリティが使用され、クラスタやその他の先進的な機能を使用できます。

デフォルトはPRODUCTIONです。

PRODUCTION

SERVER_CONFIG configGroupのプロパティ:

共通のJavaプロパティ

Listen Address

WebLogic Serverのリスニング・アドレス。これはホスト名に設定するか、ホスト上のすべてのアドレスでリスニングするようにAll Local Addressesに設定します。

All Local Addresses

Listen Port

リスニング・ポートの番号。

ポート番号を指定しない場合、または指定したポート番号が使用可能でない場合、エラーが返されます。

8001

SSL Listen Port

SSLリスニング・ポートの番号。このプロパティは、SSLが有効な場合に移動計画に存在します。

7002

Frontend Host

HTTPサーバーのホスト名。

このプロパティは、HTTPサーバーがサーバーに対するフロントエンドとして設定されている場合にのみ、移動計画に存在します。

example.com

Frontend HTTP Port

HTTPサーバー・ポートの番号。

このプロパティは、HTTPサーバーがサーバーに対するフロントエンドとして設定されている場合にのみ、移動計画に存在します。

10605

Custom Identity Keystore File

カスタムIDキーストア・ファイルの場所の絶対パス。

Startup ModeがDEVELOPMENTであり、ソース環境がキーストアとしてDemoTrustを使用する場合、このパラメータは空のままにできます。同じタイプのストアがターゲット環境に作成されます。

Startup ModeがDEVELOPMENTであり、ソース環境がキーストアとしてCustomTrustを使用する場合、このパラメータに対して値を指定する必要があります。同じタイプのストアがターゲット環境に作成されます。

Startup ModeがPRODUCTIONであり、ソース環境でSSLが有効になっている場合(DemoTrustまたはCustomTrustのいずれを使用するかにかかわらず)、このパラメータに対して値を指定する必要があります。

/scratch/Oracle/Middleware/wlserver_10.3/server/lib/example_identity.jks

Custom Identity Keystore Passphrase File

カスタムIDキーストアのパスワードが含まれるセキュア・ファイルへの絶対パス。

Startup ModeがDEVELOPMENTであり、ソース環境がキーストアとしてDemoTrustを使用する場合、このパラメータは空のままにできます。同じタイプのストアがターゲット環境に作成されます。

Startup ModeがDEVELOPMENTであり、ソース環境がキーストアとしてCustomTrustを使用する場合、このパラメータに対して値を指定する必要があります。

Startup ModeがPRODUCTIONであり、ソース環境でSSLが有効になっている場合(DemoTrustまたはCustomTrustのいずれを使用するかにかかわらず)、このパラメータに対して値を指定する必要があります。

/scratch/oracle/i_passwd

Custom Trust Keystore File

カスタム信頼キーストア・ファイルの場所の絶対パス。

Startup ModeがDEVELOPMENTであり、ソース環境がキーストアとしてDemoTrustを使用する場合、このパラメータは空のままにできます。同じタイプのストアがターゲット環境に作成されます。

Startup ModeがDEVELOPMENTであり、ソース環境がキーストアとしてCustomTrustを使用する場合、このパラメータに対して値を指定する必要があります。

Startup ModeがPRODUCTIONであり、ソース環境でSSLが有効になっている場合(DemoTrustまたはCustomTrustのいずれを使用するかにかかわらず)、このパラメータに対して値を指定する必要があります。

/scratch/Oracle/Middleware/wlserver_10.3/server/lib/example_trust.jks

Custom Trust Keystore Passphrase File

カスタム信頼キーストアのパスワードが含まれるセキュア・ファイルへの絶対パス。

Startup ModeがDEVELOPMENTであり、ソース環境がキーストアとしてDemoTrustを使用する場合、このパラメータは空のままにできます。同じタイプのストアがターゲット環境に作成されます。

Startup ModeがDEVELOPMENTであり、ソース環境がキーストアとしてCustomTrustを使用する場合、このパラメータに対して値を指定する必要があります。

Startup ModeがPRODUCTIONであり、ソース環境でSSLが有効になっている場合(DemoTrustまたはCustomTrustのいずれを使用するかにかかわらず)、このパラメータに対して値を指定する必要があります。

/scratch/oracle/key_passwd

Custom Identity Private Key Alias

秘密鍵の別名。

Startup ModeがDEVELOPMENTであり、ソース環境がキーストアとしてDemoTrustを使用する場合、このパラメータは空のままにできます。同じタイプのストアがターゲット環境に作成されます。

Startup ModeがDEVELOPMENTであり、ソース環境がキーストアとしてCustomTrustを使用する場合、このパラメータに対して値を指定する必要があります。

Startup ModeがPRODUCTIONであり、ソース環境でSSLが有効になっている場合(DemoTrustまたはCustomTrustのいずれを使用するかにかかわらず)、このパラメータに対して値を指定する必要があります。

fmw_key

Custom Identity Private Key Passphrase File

カスタムID秘密鍵のパスワードが含まれるセキュア・ファイルへの絶対パス。

Startup ModeがDEVELOPMENTであり、ソース環境がキーストアとしてDemoTrustを使用する場合、このパラメータは空のままにできます。同じタイプのストアがターゲット環境に作成されます。

Startup ModeがDEVELOPMENTであり、ソース環境がキーストアとしてCustomTrustを使用する場合、このパラメータに対して値を指定する必要があります。

/scratch/oracle/i_passwd

KeyStore Type

キーストアのタイプ。この値が空の場合、移行スクリプトによりCustomIdentityとCustomTrust KeyStore Typeでこの値は空に設定され、Oracle WebLogic Serverはキーストア・タイプがjksであるとみなします。有効な値は、jks、jceksおよびPKC#12です。

jks

CLUSTER_CONFIG configGroupのプロパティ:

Oracle WebLogic Serverクラスタ構成プロパティ

Messaging Mode

クラスタ・メッセージング・モード。有効な値は、unicastとmulticastです。

multicast

Cluster Address

クラスタ・アドレス。

localhost

Unicast Channel

ユニキャスト・チャンネルの名前。

MyMulticastChannel

Multicast Address

マルチキャスト・アドレス。

239.192.0.0

Multicast Port

マルチキャスト・アドレスのポート番号。

8899

Frontend Host

クラスタのフロントエンド・ホストの名前またはIPアドレス。

example.com

Frontend HTTP Port

クラスタのフロントエンド・ホストのHTTPポート番号。

7008

MACHINE_CONFIG configGroupのプロパティ:

マシン構成プロパティ

Machine Name

マシンの名前。

example.com

Node Manager Listen Address

ノード・マネージャが稼働するマシンのリスニング・アドレス。

example.com

Node Manager Listen Port

ノード・マネージャが稼働するマシンのリスニング・アドレスのポート番号。

5556

DEPLOYMENT_PLAN_CONFIG configGroupのプロパティ:

デプロイメント・プラン

Application Name

アプリケーションの名前。

helloWorldEar

Deployment Plan

アプリケーションのデプロイ・プランが抽出される場所。この場所は、移動計画の場所を基準とした場所です。

deploy_plans/helloWorldEar_plan.xml

AUTHENTICATORS configGroupのプロパティ:

認証プロバイダの構成

Host Name

LDAPサーバー・ホスト名。

example.com

Port

LDAPサーバーのポート番号。

3060

Principal

LDAPサーバーの管理ユーザー。

cn=orcladmin

Password File

LDAPユーザーのパスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/oracle/ldap_passwd

User Base DN

ユーザー・ベース識別名(DN)。

cn=users,dc=us,dc=oracle,dc=com

User Object Class

ユーザー・オブジェクト・クラス。

person

Group Base DN

グループ・ベース識別名(DN)。

cn=groups,dc=us,dc=oracle,dc=com

GUID Attribute

グローバルな一意の識別子。

orclguid

DATASOURCE configGroupのプロパティ:

データソースの構成。

Driver Class

データソースのドライバ・クラス。『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』のWebLogic ServerでのJDBCドライバの使用に関する説明を参照して、適切なクラスを選択してください。

oracle.jdbc.OracleDriver

Url

データソースのデータベースのURL。これには、ホスト名、データベース・サービス名またはSID、およびデータベース・ポート番号が含まれます。

jdbc:oracle:thin:@orcl.examplecom:1521/orcl.example.com

User

データソースのスキーマ名。

OFM_MDS

Password File

データベース・スキーマのパスワードが含まれるセキュア・ファイルの絶対パス。データソースの構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/oracle/ds_passwd

ONS Node List

次の形式で指定される、Oracle Notification Service(ONS)ホストとポートのリスト。

ons_host1:port1,ons_host2:port2

myhost1:6100,myhost2:6101

ONS Wallet File

キーおよび証明書が含まれる資格証明ストア・ファイルの絶対パス。このプロパティは、SSLが有効になっている場合にのみ構成します。

/scratch/wallet

ONS Wallet Password File

ウォレットのパスワードを含むファイルの絶対パス。

/scratch/ons_pass.txt

OPSS_SECURITY configGroupのプロパティ、LDAPのIDを持つconfigProperty内:

LDAPベース・ポリシーおよび資格証明ストアの構成。

ソースがファイルベースのストアの場合、これらのプロパティ(LDAPベースのストアに対する)およびデータベース・ベースのストアに対するプロパティも移動計画に存在します。移動計画を構成する場合、ファイルベースからLDAPベースまたはデータベースベース・ストアに変更できます。

いずれかのタイプのストアのみを使用できます。いずれかを使用するには、移動計画の当該のセクションのコメントを外し、その他の箇所はコメントされるようにします。

ソースがLDAPベースの場合、LDAPプロパティのみが移動計画に存在します。これを別のタイプに変更することはできませんが、LDAPエンドポイントを変更することはできます。

ソースがデータベース・ベースの場合、データベース・プロパティのみが移動計画に存在します。これを別のタイプに変更することはできませんが、データベースベースのエンドポイントを変更することはできます。

Password File

LDAPサーバー管理ユーザーのパスワードが含まれるセキュア・ファイルの絶対パス。LDAPサーバーの構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/oracle/ldap_passwd

LDAP User

LDAPサーバー管理ユーザー名。

cn=orcladmin

Jps Root

LDAPサーバー・コンテキスト・ルート。このプロパティは、ソースがファイルベースのストアの場合に、移動計画に存在します。ソースがLDAPベースの場合は、スクリプトにより、ソースと同じ名前でターゲットにJPSルートが作成されます。

cn=jpsRoot

Domain

ドメインの名前。このプロパティは、ソースがファイルベースのストアの場合に、移動計画に存在します。ソースがLDAPベースの場合は、スクリプトにより、ターゲットでもソースと同じ名前がドメインに使用されます。

SOA_domain

LDAP Url

LDAP接続のURL。これには、LDAPストアのホスト名およびポート番号が含まれます。

ldap://example.com:3060

OPSS_SECURITY configGroupのプロパティ、DBのIDを持つconfigProperty内:

データベース・ベースのポリシーおよび資格証明ストアの構成。

ソースがファイルベースのストアの場合、これらのプロパティ(データベース・ベースのストアに対する)およびLDAPベースのストアに対するプロパティも移動計画に存在します。移動計画を構成する場合、ファイルベースからLDAPベースまたはデータベースベース・ストアに変更できます。

いずれかのタイプのストアのみを使用できます。いずれかを使用するには、移動計画の当該のセクションのコメントを外し、その他の箇所はコメントされるようにします。

ソースがLDAPベースの場合、LDAPプロパティのみが移動計画に存在します。これを別のタイプに変更することはできませんが、LDAPエンドポイントを変更することはできます。

ソースがデータベース・ベースの場合、データベース・プロパティのみが移動計画に存在します。これを別のタイプに変更することはできませんが、DATASOURCE configGroupのプロパティを変更することにより、データベース・ベースのエンドポイントを変更することはできます。

Password File

OPSSスキーマ所有者のパスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/oracle/ldap_passwd

DataSource Name

データソース名。

opssds

DataSource Jndi Name

データ・ソースのJNDI名。

jdbc/opss

Jps Root

LDAPサーバー・コンテキスト・ルート。

cn=jpsRoot

Domain

ドメインの名前。

SOA_domain

Driver Class

データソースのドライバ・クラス。『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』のJDBCドライバの選択に関する説明を参照して、適切なクラスを選択してください。

oracle.jdbc.OracleDriver

Url

データソースのデータベースのURL。これには、ホスト名、データベース・ポート番号、およびデータベース・サービス名またはSIDが含まれます。

jdbc:oracle:thin:@hostname.com:1521:orcl

User

データソースのOPSSスキーマ所有者の名前

DEV_OPSS

RDBMS Security Store configGroupのプロパティ:

データベース・ベース・セキュリティ・ストアの構成。

URL

セキュリティ・ストア接続のデータベースのURL。これには、ホスト名、データベース・ポート番号、およびデータベース・サービス名またはSIDが含まれます。

jdbc:oracle:thin:@hostname.com:1521/example.com

Driver Class

RDBMSセキュリティ・ストア接続のドライバ・クラス。『Oracle Fusion Middleware Oracle WebLogic Server JDBCデータ・ソースの構成と管理』のWebLogic ServerでのJDBCドライバの使用に関する説明を参照して、適切なクラスを選択してください。

oracle.jdbc.OracleDriver

User

スキーマ所有者の名前

admin

Password File

セキュリティ・ストア・スキーマ所有者のパスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/oracle/rbms_passwd

ADAPTER configGroupのプロパティ:

リソース・アダプタ構成

Deployment Plan

ターゲットへの移行時に使用されるデプロイ・プランへのパス。絶対パスを指定することも、移動計画の場所に対する相対パスを指定することもできます。

デプロイ・プランは、extractMovePlanスクリプトで抽出されます。

/scratch/adapters/adapters.xml

表20-15は、Oracle ADF接続を使用している場合に変更できる移動計画のプロパティを説明しています。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。表はコンポーネントごとに分かれています。一部のコンポーネントについては、説明列にOBJECT_NAME_PROPERTYタイプが示されています。このタイプを検索して、関連するセクションを見つけることができます。

表20-15 Oracle ADF接続の移動計画のプロパティ

プロパティ

説明

サンプル値

Oracle ADF URL接続

OBJECT_NAME_PROPERTYタイプはURLConnProviderです。

Port

URL接続に使用されるポート番号。

7000

URL

接続に使用されるURL。

example.com

Oracle ADFビジネス・コンポーネント・サービス接続

OBJECT_NAME_PROPERTYタイプはADFBCServiceConnectionです。

ServiceEndpointProvider

ビジネス・コンポーネント・サービス・エンドポイント・プロバイダ。

ADFBC

JndiFactoryInitial

JNDI初期ファクトリ・クラス。

com.sun.java.jndi.InitialFactory

JndiProviderUrl

JNDIプロバイダのURL。

t3://example.com:7101

JndiSecurityPrincipal

JNDIセキュリティ・プリンシパル名。

weblogic

WebServiceConnectionName

Webサービス接続名。

test

Oracle Enterprise Scheduler

OBJECT_NAME_PROPERTYタイプはEssConnectionです。

NotificationServiceURL

Oracle Enterprise Scheduler通知サービスURL。

http://localhost:8001

RequestFileDirectory

OES ConcurrentProcessor(CP)拡張のジョブに対するリクエスト・ログが作成されるディレクトリのパス。

/tmp/ess/requestFileDirectory

SAMLTokenPolicyURI

CP拡張で使用されるSAML Policy URI

oracle/wss11_saml_token_with_message_protection_service_policy

EssCallbackClientSecurityPolicyURI

Webサービスのコールバック時に、Oracle Enterprise SchedulerからWebサービスを起動する際にWS-Securityヘッダーで使用されるセキュリティ・ポリシー。

oracle/wss11_saml_token_with_message_protection_client_policy

Oracle Business Activity Monitoring

WEBTIER_SERVER

Oracle BAM Webサーバー・ホスト。

example.com

USER_NAME

Oracle BAMユーザーの名前。

user

PASSWORD

Oracle BAMユーザーのパスワード。

bam_password

WEBTIER_SERVER_PORT

Webサーバーのポート番号。

9001

BAM_SERVER_PORT

JNDIポート番号。

8001

BAM_WEBTIER_PROTOCOL

ネットワーク・プロトコル。有効値は、HTTPおよびHTTPSです。

HTTP

BIプレゼンテーション・サービス接続

OBJECT_NAME_PROPERTYタイプはBISoapConnectionです。

StaticResourcesLocation

ブラウザがOracle BI EEの静的リソースをフェッチする場所

http://example.com:7001/analytics

WSDLContext

Webサービスのコール時に使用するOracle BI EEコンテキスト。

analytics-ws

Host

Oracle BI EEが配置されているホスト

example.com

Port

BIプレゼンテーション・サービス・サーバーをホストするポート

10621

ShouldPerformImpersonation

Oracle BI EEで偽装を行う必要があるかどうか。これは、常にtrueに設定しておく必要があります。

true

Context

コンテンツをフェッチする際に使用するOracle BI EEコンテキスト。

analytics

Protocol

使用するプロトコル。WebサービスがSSLで構成されているかどうかによって異なります。

http or https

IsStaticResourcesLocationAutomatic

Host、PortおよびContextのフィールドからStaticResourcesLocationを自動生成するかどうかを示すフラグ。

true or false

Oracle Essbase

OBJECT_NAME_PROPERTYタイプはEssbaseConnProviderです。

Host

Oracle Essbaseサーバーのホスト名。

example.com

Cluster

Oracle Essbaseサーバーがメンバーとなるクラスタの名前。

esbCluster

Port

Oracle Essbaseサーバーのリスニング・ポート番号。

1423

Username

ユーザー名。

user3

Oracle WebCenter PortalのOracle Secure Enterprise Search

OBJECT_NAME_PROPERTYタイプはSesConnectionProviderです。

SoapURL

Oracle SESが検索リクエストを有効にするために公開するWebサービスURL。

http:/example.com:port/search/query/OracleSearch

Oracle WebCenter Portalコンテンツ・リポジトリ

OBJECT_NAME_PROPERTYタイプはJCRです。

ServerHost

Content Serverが稼働しているマシンのホスト名。

example.com

ServerPort

Content Serverがリスニングしているポート番号。

4444

ServerWebUrl

Content ServerのWebサーバーURL。

http://example.com/cms/idcplg

Oracle WebCenter Portalのお知らせおよびディスカッション

OBJECT_NAME_PROPERTYタイプはForumConnectionProviderです。

AdminUser

ディスカッション・サーバー管理者の名前。ディスカッションおよびお知らせサービスは、WebCenter Portalのユーザーにかわってこのアカウントを使用して管理操作を実行します。

admin

Url

ディスカッション・フォーラムおよびお知らせをホストしているディスカッション・サーバーのURL。

http://example.com:8890/owc_discussions

Oracle WebCenter Portal外部アプリケーション

OBJECT_NAME_PROPERTYタイプはExtAppConnectionProviderです。

Url

外部アプリケーションのログインURL。

https://example.com/config/login?

Oracle WebCenter Portalインスタント・メッセージおよびプレゼンス

OBJECT_NAME_PROPERTYタイプはRtcConnectionProviderです。

BaseConnectionURL

インスタント・メッセージおよびプレゼンス・サービスをホストしているサーバーのURL。

http://example.com:8888

Domain

ネットワーク・ドメイン。

example.com

ExternalAppId

プレゼンス・サーバー接続に関連付けられる外部アプリケーションID。これがある場合、外部アプリケーションの資格証明情報は、インスタント・メッセージおよびプレゼンス・サーバーに対するユーザーの認証に使用します。

extApp

Oracle WebCenter Portalメール・サーバー

OBJECT_NAME_PROPERTYはMailConnectionProviderです。

ExternalAppId

メール・サーバーに関連付けられる外部アプリケーションID

extApp_Mail

ImapHost

IMAPサーバーのホスト名。

example.com

ImapPort

IMAPサーバーのポート番号。

993

ImapSecured

IMAPサーバーへのメール・サーバー接続でSSLが有効かどうかを示すフラグ。有効値はtrueとfalseです。デフォルトはfalseです。

true

SmtpHost

SMTP(Simple Mail Transfer Protocol)サービスが稼働しているコンピュータのホスト名。

example.com

SmtpPort

SMTPホストのポート番号。

587

SmtpSecured

SMTPサーバーが保護されているかどうかを示すフラグ。有効値はtrueとfalseです。デフォルトはfalseです。

true

Oracle WebCenter Portalのパーソナル・イベント

OBJECT_NAME_PROPERTYタイプはWebCenterPersonalEventConnectionProviderです。

ExternalAppId

パーソナル・イベント・サービスを提供する、Microsoft Exchange Serverに関連付けられる外部アプリケーション。これを指定すると、外部アプリケーションの資格証明情報が、Microsoft Exchange Serverに対するユーザーの認証に使用されます。

ExtPEApp

WebServiceURL

イベント・アプリケーションを公開するWebサービスのURL。

http://example.com:80/ExchangeWS/PersonalEventsWebService.asmx

Oracle WebCenter Portal WSRPプロデューサ

OBJECT_NAME_PROPERTYタイプはWSRPProducerConnectionです。

ProxyHost

プロキシ・サーバーのホスト名またはIPアドレス。

example.com

ProxyPort

プロキシ・サーバーのポート番号。

80

Oracle WebCenter Portal PDK-Javaプロデューサ

OBJECT_NAME_PROPERTYタイプはWebProducerConnectionです。

Host

PDK-Javaプロデューサ接続に使用されるプロキシ・サーバーのホスト名。

example.com

Port

PDK-Javaプロデューサ接続に使用されるポート番号。

80

URL

PDK-Javaプロデューサ接続用のURL。

http:/example.com:port

Oracle WebCenter Portalワークリスト

OBJECT_NAME_PROPERTYタイプはBPELです。

URL

BPELサーバーへのアクセスに必要なURL。BPELサーバーURLは、WebCenterアプリケーション内で一意である必要があります。

protocol://example:port

Oracle Webサービス

OBJECT_NAME_PROPERTYタイプはWebServiceConnectionです。

WsdlUrl

WSDLのURL。

http://example.com:port/MyWebService1?WSDL

Oracle Webサービス

OBJECT_NAME_PROPERTYタイプはPortです。

AddressUrl

サービス・エンドポイントURL。

http://example.com:port/MyWebService1

ProxyHost

プロキシ・サーバーが稼働するホストの名前。

example.com

ProxyPort

プロキシ・サーバーがリスニングしているポート番号。

80

表20-16は、Oracle SOA Suite用に変更できる移動計画のプロパティを説明しています。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-16 Oracle SOA Suiteの移動計画のプロパティ

プロパティ

説明

サンプル値

Composite configGroupのプロパティ:

SOAコンポジットの構成

Config Plan Location

ターゲットへの移行時にコンポジット・アプリケーションの再デプロイに使用される構成計画の場所。絶対パスを指定することも、移動計画の場所に対する相対パスを指定することもできます。

構成計画は、extractMovePlanスクリプトの実行時に抽出されます。

/scratch/app/config_plan.xml

表20-17に、Oracle Business Activity Monitoringに対して変更可能な移動計画プロパティを示します。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-17 Oracle Business Activity Monitoringに対する移動計画プロパティ

プロパティ

説明

サンプル値

ApplicationURL

Oracle BAM WebアプリケーションおよびOracle BAM Serverに対するURL。

Oracle BAM WebアプリケーションおよびOracle BAM Serverが別々のホストにデプロイされていないかぎり、この値を更新する必要はありません。

http://DEFAULT:0000

DURABLE_SUBSCRIBER_NAME

EMSサンプル値に使用する永続サブスクライバ名。

myDURABLE_SUBSCRIBER_NAME

INITIAL_CONTEXT_FACTORY

EMSサンプル値に使用する初期コンテキスト・ファクトリ名。

weblogic.jndi.WLInitialContextFactory

JNDI_URL

EMSのJNDI URL。

t3://example.com:7001

JNDI_USERNAME

JNDIユーザー名。

myJMSUserName

JNDI_PASSWORD_FILE

パスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/pass/jndi_pass.txt

JMS_USERNAME

JMSユーザー名。

user1

JMS_PASSWORD_FILE

パスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/pass/jms_pass.txt

表20-18に、Oracle Service Busに対して変更可能な移動計画プロパティを示します。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-18 Oracle Service Busに対する移動計画プロパティ

プロパティ

説明

サンプル値

osb.configuration.passphrase.file

パスフレーズ・ファイルの絶対パス。ファイルはターゲット環境でアクセス可能である必要があります。

このプロパティは、-additionalParamsオプションを使用してcopyConfigスクリプトにosb.configuration.passphrase.fileを渡した場合に必要です。

パスフレーズは、ソース環境に対するものと同じである必要があります。

/scratch/passwd/osb_passwd

表20-19に、Oracle User Messaging Serviceに対して変更可能な移動計画プロパティを示します。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-19 Oracle User Messaging Serviceに対する移動計画プロパティ

プロパティ

説明

サンプル値

componentType UMSのプロパティ:

これらのプロパティは、すべてのドライバ・タイプに適用されます。

DefaultSenderAddress

送信者のデフォルトのアドレス。

SMS:1234

SenderAddresses

ドライバがサポートしている送信者アドレスのリスト。

SMS:1234

EmailDriver componentTypeのプロパティ:

これらのプロパティは、電子メール・ドライバに適用されます。

IncomingMailServer

受信メール・サーバーのホスト名。

umsdemo.example.com

IncomingMailServerPort

IMAP4サーバーのポート番号(143または993)、またはPOP3サーバーのポート番号(110または995)。

110

IncomingUserIDs

ドライバ・インスタンスがポーリングするメール・アカウントのユーザー名のリスト。各名前はカンマで区切られている必要があります(例: user1,user2)。

username.pop3@umsdemo.example.com

IncomingMailIDs

ユーザー名に対応する電子メール・アドレス。各電子メール・アドレスはカンマで区切られ、対応するユーザー名がユーザー名リストに表示されているとおりに、リスト内で同じ位置に配置されている必要があります。

username.pop3@umsdemo.example.com

IncomingUserPasswords

パスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

ファイルには、ユーザー名に対応するパスワードのリストが含まれます。各パスワードはカンマで区切られ、対応するユーザー名がユーザー名リストに表示されているとおりに、リスト内で同じ位置に配置されている必要があります。

/scratch/oracle/ums_in_passwd.txt

OutgoingMailServer

SMTPサーバーの名前。

umsdemo.example.com

OutgoingMailServerPort

SMTPサーバーのポート番号。

25

OutgoingDefaultFromAddr

デフォルトの送信者アドレス(送信メッセージで指定されていない場合)。

username.pop3@umsdemo.example.com

OutgoingUsername

SMTP認証に使用するユーザー名。

username.pop3@umsdemo.example.com

OutgoingPassword

SMTP認証に使用されるパスワードが含まれるセキュア・ファイルの絶対パス。SMTP認証がSMTPサーバーでサポートされている場合のみ必要です。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/oracle/ums_out_passwd.txt

ExtensionEndpoint configGroupのプロパティ:

これらのプロパティは、拡張ドライバに適用されます。

EndpointURL

リモート・エンドポイント・リスナーURL。

http://hostname:7001/myapp-war/extension

mappedDomain

受信者URIのドメイン部分がこの値と一致した場合に、メッセージの配信に使用される拡張エンドポイント。

test

SMPPDriver componentTypeのプロパティ:

これらのプロパティは、SMPPドライバに適用されます。

SmsAccountId

SMS-CのアカウントID。

myusername

SmsServerHost

SMS-Cサーバーの名前(またはIPアドレス)。

example_host

TransmitterSystemId

メッセージの送信に使用するアカウントID。

myusername

ReceiverSystemId

メッセージの受信に使用するアカウントID。

myusername

TransmitterSystemType

送信側システムのタイプ。

Logica

ReceiverSystemType

受信側システムのタイプ。

Logica

ServerTransmitterPort

送信側サーバーのTCPポート番号。

9001

ServerReceiverPort

受信側サーバーのTCPポート番号。

9001

TransmitterSystemPassword

送信側システムのパスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/oracle/ums_trans_passwd.txt

ReceiverSystemPassword

受信側システムのパスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/oracle/ums_rec_passwd.txt

WorklistDriver componentTypeのプロパティ:

このプロパティは、ワークリスト・ドライバに適用されます。

BPELConnectionURL

接続先のBPELサーバーのURL。フォーマットは'http://bpel-host:bpel-port'です。このプロパティが設定されていない場合のデフォルトの動作では、ローカル・コンテナのHTTP接続URLが使用されます。

http://host.example.com:port

XMPPDriver componentTypeのプロパティ:

これらのプロパティは、XMPPドライバに適用されます。

IMServerHost

Jabber/XMPPサーバーのホスト名。

example.domain.com

IMServerPort

対応するJabber/XMPPサーバー・ポート。デフォルトは5222です。

5222

IMServerUsername

ログインに使用するJabber/XMPPユーザー名。ドメイン名がJabber/XMPPサーバー・ホスト名と異なる場合は、完全なJabber IDを入力することもできます。

myUserName@xmpp-domain

IMServerPassword

IMServerUsernameに対応するパスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/oracle/ums_im_passwd.txt

表20-20は、Oracle B2B用に変更できる移動計画のプロパティを説明しています。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-20 Oracle B2Bの移動計画のプロパティ

プロパティ

説明

サンプル値

File.DeliveryChannel configGroupのプロパティ:

ファイル配信チャネルの構成。

file-param-folder

フォルダの絶対パス。

/tmp/file_deliv

File.ListeningChannel configGroupのプロパティ:

ファイル・リスニング・チャネルの構成。

file-param-folder

フォルダの絶対パス。

/tmp/file_listen

JMS configGroupのプロパティ:

JMSの構成。チャネルごとに独自のプロパティ値セットがあります。

jms-param-password

パスワードが含まれるセキュア・ファイルの絶対パス。パスワード・ファイルを用意しないと、値はターゲットで設定されません。ソース構成が維持されます。

/tmp/password/pass.txt

jms-param-is_topic

構成済の宛先トピックかどうかを指定するフラグ。有効な値は、trueとfalseです。

false

jms-param-queue_name

キューまたはトピックのJNDI名。

jms/b2b/B2B_IN_QUEUE

jms-param-DestinationProviderProperties

JMS接続先プロバイダのプロパティ。キー/値ペアのセパレータとしてセミコロン(;)を使用します。

java.naming.provider.url=t3://example.com:7001;java.naming.factory.initial=weblogic.jndi.WLInitialContextFactory;java.naming.security.principal=weblogic;java.naming.security.credentials=weblogic

jms-param-user

JMSユーザー名。

user1

FTP configGroupのプロパティ:

FTPの構成。チャネルごとに独自のプロパティ値セットがあります。

ftp-param-password

パスワードが含まれるセキュア・ファイルの絶対パス。パスワード・ファイルを用意しないと、値はターゲットで設定されません。ソース構成が維持されます。

/tmp/password/pass.txt

ftp-param-folder

フォルダの絶対パス。

/tmp/test1

ftp-param-host

FTPホスト名。

example

ftp-param-preserve_filename

ファイル名を保存するかどうかを指定するフラグ。有効な値は、trueとfalseです。

false

ftp-param-user

FTPユーザー名。

User

HTTP configGroupのプロパティ:

HTTPの構成。チャネルごとに独自のプロパティ値セットがあります。

http-param-password

パスワードが含まれるセキュア・ファイルの絶対パス。パスワード・ファイルを用意しないと、値はターゲットで設定されません。ソース構成が維持されます。

/tmp/password/pass.txt

http-param-use_proxy

プロキシ・サーバーを使用するかどうかを指定するフラグ。有効な値は、trueとfalseです。

false

http-param-additional_headers

追加のトランスポート・ヘッダー(Digest認証用のヘッダーなど)。

http-param-url

完全修飾されたHTTP URL。

http://example:8001/b2b/httpReceiver

SFTPトランスポート・プロトコルのプロパティ:

SFTPの構成。

sftp-param-password

パスワードが含まれるセキュア・ファイルの絶対パス。パスワード・ファイルを用意しないと、値はターゲットで設定されません。ソース構成が維持されます。

/tmp/password/pass.txt

sftp-param-host

SFTPホスト名。

example

sftp-param-port

SFTPポート番号。

22

sftp-param-folder

フォルダの絶対パス。

/scratch/b2b/sftp

sftp-param-user

SFTPユーザー名。

user1

電子メール・トランスポート・プロトコルのプロパティ:

電子メールの構成。

email-param-password

パスワードが含まれるセキュア・ファイルの絶対パス。パスワード・ファイルを用意しないと、値はターゲットで設定されません。ソース構成が維持されます。

/tmp/password/pass.txt

email-param-host

電子メール・ホスト名。

example

email-param-user

電子メール・ユーザー名。

user1

email-param-email-id

メッセージ配信先の電子メール・アドレス(AQまたはJMSでのファイル・チャネルやキューのパスの指定と同じ)。

user1@exampleb2b.com

AQトランスポート・プロトコルのプロパティ:

AQの構成。

aq-param-password

パスワードが含まれるセキュア・ファイルの絶対パス。パスワード・ファイルを用意しないと、値はターゲットで設定されません。ソース構成が維持されます。

/tmp/password/pass.txt

aq-param-datasource

AQキューにアクセスするためのJDBCデータソースのJNDI名。

jdbc/SOADataSource

aq-param-recipient

AQキューへのメッセージの配信時に使用する値。

testuser

aq-param-queue_name

AQキュー名。

IP_OUT_QUEUE

aq-param-consumer

メッセージを受信するクライアント。

b2buser

TCPトランスポート・プロトコルのプロパティ:

TCPの構成。

tcp-param-host

TCPホスト名。

example

tcp-param-port

TCPポート番号。

23456

tcp-param-PermanentConnectionType

キャッシュされた接続がすべてのメッセージの交換に使用されるかどうかを示すフラグ。有効な値は、trueとfalseです。

false

tcp-param-timeout

TCPタイムアウト(秒)。

300

表20-21は、Oracle HTTP Server用に変更できる移動計画のプロパティを説明しています。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

Oracle HTTP Serverでは、移動計画に多数のconfigGroup要素があります。それぞれのconfigGroup要素は1つのOracle HTTP Server構成ファイルに関連付けられます。そのため、Userなどの特定のプロパティのインスタンスは複数存在する場合があります。

表20-21 Oracle HTTP Serverの移動計画のプロパティ

プロパティ

説明

サンプル値

Listen

リスニング・アドレス。これには、ホスト名とポートを含めることも、ポートのみを含めることもできます。

orcl3.example.com:8888 or 8888

User

Oracle HTTP Server管理ユーザー。

admin_user

Group

ユーザーのグループ。

admin_group1

ServerAdmin

管理者の電子メール・アドレス。

Webmaster@example.com

ServerName

Oracle HTTP Serverのサーバー名。ホストに登録されたDNS名がない場合、IPアドレスを使用します。

orcl1.example.com

WebLogicHost

Oracle WebLogic Serverがリクエストをリスニングするホストの名前。

orcl2.example.com

WebLogicPort

Oracle WebLogic Serverがリクエストのリスニングに使用するポート番号。

9002

WebLogicCluster

Oracle WebLogic Serverクラスタが稼働するホストの名前とそのポート番号。

orcl3.example.com:9003

VirtualHost

仮想ホストの名前。リストされたポート番号は、リスニング・ディレクティブにもリストされている必要があります。

*.8888

PlsqlDatabasePassword

PLSQLモジュールに固有の、パスワードが含まれるセキュア・ファイルの名前。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/orcl/plsql_passwd

PlsqlDatabaseConnectString

PLSQLモジュールに固有のデータベースのサービス名。

orcl.example.com:1521:orcl1

PlsqlNLSLanguage

PLSQLモジュールに固有のデータベース・アクセス記述子(DAD)のNLS_LANG変数。

America_America.UTF8

ORAConnectSN

oradavモジュールに固有の接続先のOracleデータベース。

db_host:db_port:db_service_name

ORAUser

ORAConnectSNプロパティで指定されたサービスへの接続時に使用される、oradavモジュールに固有のデータベース・ユーザー(スキーマ)。

db6175_PORTAL

ORACRYPTPASSWORD

oradavモジュールに固有の、oradavのパスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/oracle/dav_passwd

SSLWallet

ウォレットがデフォルトの場所に存在しない場合のSSLウォレットの場所。

/scratch/oracle/mw_home/ORACLE_INSTANCE/config/OHS/ohs1/keystores/mywallets

DocumentRoot

Webサイトのメイン・コンテンツを格納するディレクトリ。

/scratch/oracle/mw_home/ORACLE_INSTANCE/config/ohs/ohs1/htdocs

Alias

別名がデフォルトの場所に存在しない場合の別名の場所。二重引用符内の値を変更してください。

/icons/"/scratch/orcl/icons/"

ScriptAlias

スクリプトの別名がデフォルトの場所に存在しない場合のその場所。二重引用符内の値を変更してください。

/cgi-bin/"/scratch/oraclcgi-bin/"

WebGateInstalldir

webgate.confファイルで指定されたWebGateインストール・ディレクトリの場所。

/scratch/oracle/mw_home/Oracle_OAMWebGate1/webgate/ohs

primaryOAMServerHost

プライマリOracle Access Managerサーバー・ホスト。

初めてWebGateがプライマリ・サーバーと通信すると、セカンダリOracle Access Managerサーバー・ホストの構成は自動的に更新されます。

primary_oam_server_host.example.com

primaryOAMServerPort

Oracle Access Managerプライマリ・ホストのポート番号。

5575

表20-22は、Oracle Internet Directory用に変更できる移動計画のプロパティを説明しています。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-22 Oracle Internet Directoryの移動計画のプロパティ

プロパティ

説明

サンプル値

OID Non SSL Port

Oracle Internet Directoryの非SSLポート。

ポート番号を指定しない場合、または指定したポート番号が使用可能でない場合、使用可能なポートが使用されます。

3060

OID SSL Port

Oracle Internet DirectoryのSSLポート。

ポート番号を指定しない場合、または指定したポート番号が使用可能でない場合、使用可能なポートが使用されます。

3131

Namespace

Oracle Internet Directoryネームスペース。

dc=us,dc=oracle,dc=com

OID Admin Password

Oracle Internet Directory管理者のパスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/oracle/oid_passwd

ODS Schema Password

ODSスキーマ(Oracle Internet Directoryのメタデータが含まれるスキーマ)のパスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/oracle/ods_passwd

ODSSM Schema Password

(データベースからOracle Internet Directoryのサーバー管理情報へのアクセスに使用される) ODSSMスキーマのパスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/oracle/odssm_passwd

DB Host Name

データベースが実行されているホストの名前で、tnsnames.oraファイルに記載されています。

example.com

DB Port

データベース・リスナーのポート番号。tnsnames.oraファイルに記載されています。

1521

DB Service Name

データベースのサービス名。tnsnames.oraファイルに記載されています。

orcl.example.com

表20-23は、Oracle Virtual Directory用に変更できる移動計画のプロパティを説明しています。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-23 Oracle Virtual Directoryの移動計画のプロパティ

プロパティ

説明

サンプル値

OVD Non SSL Port

Oracle Virtual DirectoryのLDAP非SSLポート番号。

ポート番号を指定しない場合、または指定したポート番号が使用可能でない場合、次の使用可能なポートが使用されます。

6501

OVD SSL Port

Oracle Virtual DirectoryのLDAP SSLポート番号。

ポート番号を指定しない場合、または指定したポート番号が使用可能でない場合、次の使用可能なポートが使用されます。

7501

OVD Admin Port

Oracle Virtual Directoryの管理ポート番号。

ポート番号を指定しない場合、または指定したポート番号が使用可能でない場合、次の使用可能なポートが使用されます。

8899

OVD Http Port

Oracle Virtual DirectoryのHTTPリスナー・ポート番号。

8080

host.port

Oracle Virtual Directoryアダプタのホスト名とポート。

example.com:3060

username

Oracle Virtual Directoryアダプタのユーザー名。

cn=orcladmin

root

Oracle Virtual Directoryアダプタのルート。

dc=us,dc=oracle,dc=com

remotebase

Oracle Virtual Directoryアダプタのリモート・ベース。

dc=us,dc=oracle,dc=com

password

Oracle Virtual Directoryアダプタ・ユーザーのパスワードが含まれるセキュア・ファイルの絶対パス。

/scratch/oracle/ovd_passwd

表20-24に、Oracle Identity Federationに対して変更可能な移動計画プロパティを示します。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-24 Oracle Identity Federationの移動計画のプロパティ

プロパティ

説明

サンプル値

ServerConfig configPropertyのプロパティ:

サーバーの構成

Load Balancer Hostname

ロード・バランサのホスト名。

example.com

Load Balancer Port

ロード・バランサのポート番号。

7500

SOAP Port

SOAPポート番号。

7500

SSL Enabled

SSLが有効かどうかを示すフラグ。有効な値は、trueとfalseです。

true

SOAP SSL Enabled

SSLがSOAPに対して有効かどうかを示すフラグ。有効な値は、trueとfalseです。

true

User Data Store configPropertyのプロパティ:

ユーザー・データ・ストアの構成。これらのプロパティは、ユーザー・データ・ストアにLDAPが使用される場合は移動計画に存在します。

LDAP Server URL

LDAP接続のURL。LDAPストアのホスト名およびポート番号が含まれるプロパティ。

ldap://example.com:389

LDAP Username

LDAPサーバー管理ユーザー名。

cn=orcladmin

LDAP Password File

管理ユーザーのパスワードが含まれるセキュア・ファイルの絶対パス。

/scratch/oracle/oif_ds_passwd

Federation Data Store configPropertyのプロパティ:

フェデレーション・データ・ストアの構成。これらのプロパティは、フェデレーション・データ・ストアにLDAPが使用される場合は移動計画に存在しません。

LDAP Server URL

フェデレーションLDAP接続のURL。これには、フェデレーションLDAPストアのホスト名およびポート番号が含まれます。

ldap://example.com:389

LDAP Username

フェデレーションLDAPサーバー管理ユーザー名。

cn=orcladmin

LDAP Password File

フェデレーションLDAP管理ユーザーのパスワードが含まれるセキュア・ファイルの絶対パス。

/scratch/oracle/oif_fed_passwd

AuthnEngine configPropertyのプロパティ:

認証エンジンの構成。相互に独立した複数の認証エンジンがある場合があります。

LDAP Connection URL

LDAP接続のURL。これには、LDAPストアのホスト名およびポート番号が含まれます。このプロパティは、LDAPが認証エンジンとして有効な場合に移動計画に存在します。

ldap://example.com:389

LDAP Username

LDAP管理ユーザー名。このプロパティは、LDAPが認証エンジンとして有効な場合に移動計画に存在します。

cn=orcladmin

LDAP Password File

管理ユーザーのパスワードが含まれるセキュア・ファイルの絶対パス。このプロパティは、LDAPが認証エンジンとして有効な場合に移動計画に存在します。

/scratch/oracle/oif_ae_pwd_passwd

OAM11g Logout URL

Oracle Access Manager 11gからログアウトするためのURL。これには、Oracle Access Manager 11gのホスト名およびポート番号が含まれます。このプロパティは、Oracle Access Manager 11gが認証エンジンとして有効な場合に移動計画に存在します。

http://oam11g_host:oam11g_port/logout.jsp

HTTP Header Logout Redirect URL

ログアウト用のURL。これには、Oracle HTTP Serverのホスト名およびポート番号が含まれます。このプロパティは、HTTPヘッダーが認証エンジンとして有効な場合に移動計画に存在します。

http://example.com:port/logout.jsp

SPEngine configGroupのプロパティ:

SPエンジンの構成。相互に独立した複数のSPエンジンがある場合があります。

OAM11g Login URL

Oracle Access Manager 11gにログインするためのURL。これには、Oracle Access Manager 11gのホスト名およびポート番号が含まれます。このプロパティは、SPエンジンにOracle Access Manager 11gが使用される場合に移動計画に存在します。

http://oam11g_hostname:oam11g_port/login

OAM11g Logout URL

Oracle Access Manager 11gからログアウトするためのURL。これには、Oracle Access Manager 11gのホスト名およびポート番号が含まれます。このプロパティは、SPエンジンにOracle Access Manager 11gが使用される場合に移動計画に存在します。

http://oam11g_host:oam11g_port/logout.jsp

表20-25は、Oracle BI EEおよびOracle BI Publisher用に変更できる移動計画のプロパティを示します。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-25 Oracle BI EEおよびOracle BI Publisherの移動計画のプロパティ

プロパティ

説明

サンプル値

XMLP-SERVER-CONFIG configGroupのプロパティ:

Oracle BI Publisherの構成

SAW_SERVER

接続する必要があるOracle BIプレゼンテーション・サービスが実行されているホストの名前。

example_host

SAW_PORT

Oracle BIプレゼンテーション・サービスに接続するためのポート番号。

10217

SAW_PASSWORD

Oracle BIプレゼンテーション・サービスのパスワードが含まれるセキュア・ファイルの絶対パス。

/scratch/oracle/bip_passwd

SAW_USERNAME

Oracle BIプレゼンテーション・サービスのユーザー名。

user1

XMLP-DATASOURCES configGroupのプロパティ:

データソースの構成。

connection configPropertyのプロパティ:

dataSourceのサブプロパティ。データソースを接続タイプに指定します。

データソースは、接続タイプまたはファイル・タイプのいずれかになります。

url

接続のURL。

jdbc:oracle:thin:@host:port:sid

driver

接続に使用するドライバ

oracle.jdbc.OracleDriver

username

接続用ユーザー名。

user1

password

接続用のパスワードが含まれるセキュア・ファイルの絶対パス。

/scratch/oracle/ds_conn_passwd

file configPropertyのプロパティ:

dataSourceのサブプロパティ。データソースをファイル・タイプに指定します。

path

関連データソース・ファイルを示すファイル・システム・パス。

//scratch/oracle/config/domains/BIDomain/config/bipublisher/repository/DemoFiles

XDO-CLIENT_CONFIG configGroupのプロパティ:

Oracle BI Publisherクライアント

XMLPClientDirPath

Oracle BI Publisherクライアント・ディレクトリへの絶対パス。

/scratch/instance/domains/example.com/CommonDomain/config

* (任意の名前)

Oracle BI Publisherの構成済エンドポイント接続URL。移動計画にはエンドポイントが複数ある場合があります。

http://example.com:10621/xmlpserver

XMLP-SCHEDULER-JMS-CONFIG configGroupのプロパティ:

スケジューラの構成

JMS_WEBLOGIC_JNDI_URL

Oracle BI EE管理対象サーバーのOracle WebLogic Server JNDI URL。

cluster:t3://bi_cluster

JMS_Shared_Temp_Directory

Oracle BI EEクラスタ環境で使用されるJMS共有一時ディレクトリ。

/scratch/oracle/instance/instance1/BIPublisher/biptemp

provider configProperty内にあるXMLP-PROVIDER-CONFIG configGroupのプロパティ:

Oracle BI Publisherプロバイダ

構成済のBI PublisherプロバイダごとにconfigPropertyは異なります。

uri

Oracle BI PublisherプロバイダのURI。

http://example.com:10603/bip

nonSSOUri

Oracle BI Publisherプロバイダの非SSO URI。

bip

XDO-SERVER_CONFIG configGroupのプロパティ:

Oracle BI Publisherサーバー

XMLPServerConfigDirPath

Oracle BI Publisherサーバー構成ディレクトリへの絶対パス。

/scratch/oracle/config/domains/BIDomain/config/bipublisher

RepositoryDirPath configPropertyのプロパティ:

Oracle BI Publisherサーバー・リポジトリのディレクトリ・パス。

path

Oracle BI Publisherサーバー構成リポジトリのディレクトリ。(サーバーxdo.server.config.dirのシステム・プロパティとして指定されるBIDomainの以外の場所にある場合があります。)デフォルト値は、${xdo.server.config.dir}/repositoryです。

/scratch/oracle/instance/instance1/BIPublisher/repository

SawSourcePath configPropertyのプロパティ:

Oracle BI EEプレゼンテーション・サーバーのOracle BI Publisherサーバー接続リソースの詳細

source

Oracle BI Publisherリポジトリ・ディレクトリのパス。

/scratch/oracle/config/domains/BIDomain/config/bipublisher/repository

OracleInstances configGroupのプロパティ:

Oracle BI EEのドメイン構成

instanceHome

Oracle BI EEがデプロイされるOracleインスタンスのパス。

scratch/oracle/Middleware/instances/instance1

host

Oracle BI EEのOracleインスタンスが構成されるホスト。

example.com

BIInstanceDeployment configPropertyのプロパティ:

インスタンス構成の詳細。

listenAddress

ホストのリスニング・アドレス。マルチホーム・コンピュータで仮想IPアドレスまたはサブセットに設定できます。アスタリスクを指定すると、ホストに複数のネットワーク・アドレスを指定できます。

example.com
*

portRangeStart

Oracle BI EEのシステム・コンポーネントで使用されるポート範囲の最初。

10206

portRangeEnd

Oracle BI EEのシステム・コンポーネントで使用されるポート範囲の最後。

10214

EmailOptions configProperty内にあるBIInstance configGroupのプロパティ:

Oracle BI EEのインスタンス構成

smtpServerName

SMTPサーバーのホスト名。

example.com

port

SMTPサーバーのポート番号。

25

fromDisplayName

電子メールの送信時に、Oracle BI EEシステムで表示名として使用される送信者名。

Oracle Business Intelligence

emailAddressOfSender

電子メールの送信時に、Oracle BI EEシステムで使用される電子メール・アドレス。

defaultuser@defaultmailserver.com

MarketingOptions configProperty内にあるBIInstance configGroupのプロパティ:

Oracle BI EEのインスタンス構成

url

電子メールにURLが組み込まれている場合に、Oracle BI EEシステムで使用されるベースURL。

http://example.com:7012/_dav/cs/idcplg

PresentationServerOptions configProperty内にあるBIInstance configGroupのプロパティ:

プレゼンテーション・サーバーの構成。

webCatalogLocation

Oracle BI Presentation Catalogの場所の絶対パス。

/scratch/oracle/instance/instance1/OracleBIPresentationServicesComponent/coreapplication_obips1/catalog/OracleBIApps

スケジューラのconfigProperty内にあるBIInstance configGroupのプロパティ:

スケジューラの構成

dataSource

Oracle BIスケジューラ・データソースの接続の詳細。

(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=example.com)(PORT=1565)))(CONNECT_DATA=(SERVICE_NAME=d8b4lfc1))

ServerOptions configProperty内にあるBIInstance configGroupのプロパティ:

サーバー・オプションの構成

repositoryDataSourceName

Oracle BIリポジトリ(RPD)ファイルのデータソース名。

Star

repositoryName

RPDの名前。

OracleBI_BI0002

repositorySharedLocation

RPDの共有場所。

/scratch/oracle/instance/BIShared/OracleBIServerComponent/coreapplication_obis1/repository

PerformanceOptions configProperty内にあるBIInstance configGroupのプロパティ:

パフォーマンス・オプションの構成

globalCacheStoragePath

Oracle BI EEサーバー・キャッシュのグローバルな場所。

/scratch/oracle/instance/instance1/OracleBIServerComponent/coreapplication_obis1/cache

DEPLOY_USER_CREDENTIALS configGroupのプロパティ:

Oracle RTDインライン・サービス(BI_RTD_SPE_ILS_DEPLOY_CONFIG)。

username

RTD SPEインライン・サービスをデプロイするために使用されるユーザー名。

weblogic

password

接続用のパスワードが含まれるセキュア・ファイルの絶対パス。

/scratch/oracle/rtd_passwd

CONNECTIONPOOLS configGroupのプロパティ:

RPDの構成

user

接続プール・ユーザー名(データベース・スキーマ名)。名前は、VALUE_OF(varname)という形式の変数で、VARIABLES configGroupに表示されます。

VALUEOF(ORACLE_INITBLOCK_USER)

datasource

RPD接続プールのデータソース名または定義。名前は、VALUE_OF(varname)という形式の変数で、VARIABLES configGroupに表示されます。

VALUEOF(ORACLE_INITBLOCK_DSN)

appServerName

これがADF接続の場合は、ビジネス・コンポーネントURLです。

http://example.com:10603/fscmAnalytics/obieebroker

password

RPDデータソースに接続するためのパスワードが含まれるセキュア・ファイルの絶対パス。

/scratch/oracle/rpd_ds_conn_passwd

VARIABLES configGroupのプロパティ:

変数の定義

name

RPD接続プールの定義に使用される変数の名前。複数の名前/値ペアがある場合があります。

ORACLE_INITBLOCK_USER

value

RPD接続プールの定義に使用される変数の値。複数の名前/値ペアがあります。

'ORA_INIT_USER'

表20-26は、Oracle BI EEデータ・ウェアハウス管理コンソール用に変更できる移動計画のプロパティを示します。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-26 Oracle BI EEデータ・ウェアハウス管理コンソール(DAC)の移動計画のプロパティ

プロパティ

説明

例

DAC-SERVER-CONFIGURATION configGroupのプロパティ:

DACの構成

jdbc.url

DACリポジトリに接続するためのURL。

jdbc:oracle:thin:@example.com:1521/example.com

jdbc.driver

JDBCドライバの名前。

oracle.jdbc.driver.OracleDriver

Username

DACリポジトリに接続するためのユーザー名。

IMPORT_DAC

Password File

DACリポジトリに接続するためのユーザー・パスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/biplatform/cloning/dac_passwd

EMAIL-CONFIGURATION configGroupのプロパティ:

電子メールの構成

email_host

電子メール・サーバーのホスト名。

example

email_protocol

電子メール・サーバーのプロトコル。

smtp

email_address

ユーザーの電子メール・アドレス。

test@test.te

needs_authentication

企業の電子メール・サーバーで認証が必要かどうかを示すフラグ。有効な値は、trueまたはfalseです。

true

needs_ssl

SSL接続が必要かどうかを示すフラグ。有効な値は、trueまたはfalseです。

false

email_host_port

電子メール・サーバーがリスニングするポート。

5555

email_user

電子メール・アカウントのユーザー名。

test

email_password

電子メール・サーバーのユーザー・パスワードが含まれるセキュア・ファイルの絶対パス。(needs_authenticationがtrueの場合にのみ必要です。)

/scratch/biplatform/cloning/email_passwd

DATAWAREHOUSE-CONFIGURATION configGroupのプロパティ:

データ・ウェアハウスの構成

jdbc.url

データ・ウェアハウスに接続するためのURL。

jdbc:oracle:thin:@example.com:1521/example.com

jdbc.driver

JDBCドライバの名前。

oracle.jdbc.driver.OracleDriver

Username

データ・ウェアハウスに接続するためのユーザー名。

IMPORT_DW

Password File

データ・ウェアハウスに接続するためのユーザー・パスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/biplatform/cloning/DW_passwd

INFORMATICA-CONFIGURATION configGroupのプロパティ:

Informaticaの構成

Informatica server home

Informaticaサーバー・ホーム。

/scratch/infahome/

Domains infa file location

ドメインのinfaファイルの場所。

/scratch/infahome/domains.info

InformaticaParameterFileLocation

Informaticaパラメータ・ファイルが格納されているディレクトリ(またはDEFAULT)。

DEFAULT

DATASOURCES-CONNECTION-DETAILS configGroupのプロパティ:

データソースの接続情報

type

物理データソース・タイプ。可能な値は、Source、Warehouse、Informatica Repository、DAC Repository、Otherです。

Source

Connection Type

データベース接続のタイプ。可能な値は、BI Server、Oracle(OCI8)、Oracle(Thin)、DB2、DB2-390、MSSQL、Teradata、Flat Fileです。

Oracle (Thin)

Connection String

データソースの接続文字列。次のように使用します。

- Oracle(OCI8): tnsnamesエントリを使用します。

- Oracle(Thin): インスタンス名を使用します。SQL Server: データベース名を使用します。

- DB2-UDB/DB2-390: DB2構成に定義された接続文字列を使用します。

- Teradata: データベース名を使用します。

orcl.example.com

Table Owner

表所有者のユーザー名。

DB_USER

Host

データベースが存在するサーバーのホスト名。

example.com

Port

データベースがリクエストを受信するポート番号。

1521

JDBC Driver(オプション)

データソース接続用のJDBCドライバ。このフィールドの値は、データベースの仕様に準拠している必要があります。

oracle.jdbc.driver.OracleDriver

URL(オプション)

データソース接続用のJDBC URL。このフィールドの値は、データベースの仕様に準拠している必要があります。

jdbc:oracle:thin:@example.com:1521/orcl.example.com

Password File

データソースに接続するためのユーザー・パスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/biplatform/cloning/ds_passwd

Connection Pool Name(BIPool)

接続プール名。

FSCM_OLTP."Connection Pool"

Database Type(BIPool)

トランザクション・データソースのデータベース・タイプ。

Oracle

EXTERNAL-EXECUTORS configGroupのプロパティ:

外部実行者の構成

Execution type

外部実行者が実行するタスクの実行タイプ。

ODI 11g Embedded Agent

name

DACと、その他の抽出、変換およびロード(ETL)ツールを統合するために構成する必要があるプロパティの名前。外部実行者のプロパティは複数あります。名前はプロパティ名です。値は、プロパティを定義する値です。

<name>ODIUser</name>
<value>TestUser</value>

表20-27は、Oracle Essbase用に変更できる移動計画のプロパティを示します。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-27 Oracle Essbaseの移動計画のプロパティ

プロパティ

説明

例

EssbaseAgentConfig configGroupのプロパティ:

Oracle Essbaseの構成

ARBORPATH

ARBORPATHの絶対パス。

/scratch/oracle/shared_essbase

PortRange

Oracle Essbaseのポート範囲。

9000-9499

agent-port

Oracle Essbaseエージェントのポート番号。

9799

EssbaseAdminUserName

Oracle Essbaseの管理ユーザー名。

weblogic

EssbaseAdminPassword

Oracle Essbase管理ユーザーのパスワードが含まれるセキュア・ファイルの絶対パス。

/scratch/oracle/essbase_passwd

ASOAppsTableSpaceCustomizations configGroupのプロパティ:

集計ストレージ(ASO)アプリケーションの構成。

各集計ストレージ(ASO)アプリケーションには名前および表領域のプロパティがあり、その後にconfigGroupのプロパティが続きます。

file_location

アプリケーション・ファイルの絶対パス。

/scratch/oracle/aso

max_file_size

最大ファイル・サイズ(バイト)。

1.34217727E8

max_disk_size

最大ディスク・サイズ(バイト)。

4.294967295E9

BSOAppsDiskVolumeCustomizations configGroupのプロパティ:

ブロック・ストレージ(BSO)アプリケーションの構成。

各Essbaseブロック・ストレージ(BSO)アプリケーションには名前およびデータベース名のプロパティがあり、その後にconfigGroupのプロパティが続きます。

volume

ディスク・ボリュームの場所。

/scratch/biplatform

file_type

ディスク・ボリュームのファイル・タイプ(index、data、index_dataなど)。

index_data

file_size

ボリューム・サイズ(バイト)。

2.147483648E9

partition_size

パーティション・サイズ(バイト)。

9.007199254739968E15

表20-28は、EPMレジストリ用に変更できる移動計画のプロパティを説明しています。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-28 EPMレジストリの移動計画のプロパティ

プロパティ

説明

例

reg.properties configGroupのプロパティ:

EPMレジストリ

jdbc.url

EPMレジストリ・データベースに接続するためのURL。

jdbc:oracle:thin:@example.com:17328/example.com

jdbc.driver

JDBCドライバの名前。

oracle.jdbc.OracleDriver

username

EPMデータベースに接続するためのユーザー名。

USER_BIPLATFORM

password

EPMデータベースに接続するためのユーザー・パスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/biplatform/epm_jdbc_passwd

DATABASE_CONN configProperty内にあるEPM_COMPONENTS configGroupのプロパティ:

EPMコンポーネントの構成

host

データベース・サーバー・ホスト名。

example.com

dbUserName

データベース・ユーザー名。

FUSION_BIPLATFORM

dbJdbcUrl

データベースに接続するためのJDBC URL。

jdbc:oracle:thin:@example.com:1570/db20258

dbName

データベース名。Oracle Databaseでは、サービス名またはSIDを使用します。

db20258

dbPort

データベースのポート番号。

1570

dbPassword

データベースに接続するためのユーザー・パスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルを用意する必要があります。

/scratch/biplatform/epm_db_passwd

Default configProperty内にあるEPM_COMPONENTS configGroupのプロパティ:

EPMコンポーネントの構成

host

フロントエンドWebサーバーまたはロード・バランサのホスト名。

example2.com

port

フロントエンドWebサーバーまたはロード・バランサのポート番号。これは、デフォルト・プロパティに対するサブエントリです。

10621

isSSL

フロントエンドがSSLモードかどうかを示すフラグ。有効な値は、trueとfalseです。

false

SSLPort

フロントエンドWebサーバーまたはロード・バランサのSSLポート番号。

10218

WORKSPACE_APP configPropertyのプロパティ:

ワークスペースの構成。

host

Workspace Webアプリケーションをホストしているサーバーのホスト名。

example.com

port

Workspace Webアプリケーションが実行されているポート。

10217

SSLPort

Workspace Webアプリケーションが実行されているSSLポート(SSL用に構成されている場合)。

10218

WEB_SERVER configProperty内にあるEPM_COMPONENTS configGroupのプロパティ:

Webサーバーの構成

host

Webアプリケーションが使用するように構成されているWebサーバーのホスト名。

example.com

port

Webアプリケーションが実行されているポート。

10217

isSSL

フロントエンドがSSLモードかどうかを示すフラグ。有効な値は、trueとfalseです。

false

CALC_WEBAPP configProperty内にあるEPM_COMPONENTS configGroupのプロパティ:

EPMコンポーネントの構成

host

Oracle Calculation Manager Webアプリケーションをホストしているサーバーのホスト名。

example.com

port

Oracle Calculation Manager Webアプリケーションが実行されているポート。

10217

SSL_Port

Oracle Calculation Manager Webアプリケーションが実行されているSSLポート(SSL用に構成されている場合)。

10218

name

Oracle Essbaseクラスタの名前。複数のクラスタがある場合があります。

EssbaseCluster-1

essbaseservern configPropertyのプロパティ:

Oracle Essbaseサーバー

host

Oracle Essbaseサーバーのホスト名。

example.com

arborPath

Oracle EssbaseサーバーのARBORPATH。

/scratch/oracle/shared_essbase

ess_AppLocation

Oracle Essbaseアプリケーションの場所。

/scratch/biplatform/instances/instance1/Essbase/essbaseserver1

agent_PortNumber

Oracle Essbaseサーバーのエージェント・ポート番号。

9511

agent_StartPort

Oracle Essbaseサーバーのエージェントで使用されるポート範囲の最初。

9000

agent_StopPort

Oracle Essbaseサーバーのエージェントで使用されるポート範囲の最後。

9499

BIEE_WEBAPP configPropertyのプロパティ:

Oracle BI EE Webアプリケーションの構成

host

Oracle BI EE Webアプリケーションをホストしているサーバーのホスト名。

example.com

port

Oracle BI EE Webアプリケーションが実行されているポート。

10217

SSL_Port

Oracle BI EE Webアプリケーションが実行されているSSLポート(SSL用に構成されている場合)。

10218

PROVIDER_SERVICES_WEB_APP configPropertyのプロパティ:

Oracle Essbase APS Webアプリケーションの構成

host

Oracle Essbase APS Webアプリケーションをホストしているサーバーのホスト名。

example.com

port

Oracle Essbase APS Webアプリケーションが実行されているポート。

10217

SSL_Port

Oracle Essbase APS Webアプリケーションが実行されているSSLポート(SSL用に構成されている場合)。

10218

PFINANCIAL_REPORTING_WEB_APP configPropertyのプロパティ:

Financial Reporting Webアプリケーションの構成

host

Financial Reporting Webアプリケーションをホストしているサーバーのホスト名。

example.com

port

Financial Reporting Webアプリケーションが実行されているポート。

10217

SSL_Port

Webアプリケーションが実行されているSSLポート(SSL用に構成されている場合)。

10218

表20-29は、Oracle BI Action Framework用に変更できる移動計画のプロパティを説明しています。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-29 Oracle BI Action Frameworkの移動計画のプロパティ

プロパティ

説明

サンプル値

location-alias configGroupのプロパティ:

Action Frameworkの構成

alias_name

アクション名に対応するURL。

複数の名前/値ペアがある場合があります。

http://example.com:9704/analytics

表20-30は、Oracle WebCenter Content Server、Oracle WebCenter Content: RecordsおよびOracle WebCenter Content: Inbound Refinery用に変更できる移動計画のプロパティを説明しています。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

適切なコンポーネント・タイプの下で各コンポーネントのプロパティを編集する必要があります。

表20-30 WebCenter Content Server、RecordsおよびInbound Refineryの移動計画のプロパティ

プロパティ

説明

サンプル値

componentTypeのプロパティ

componentTypeは、Webcenter Content - Records、Content ServerまたはInbound Refineryです。

MoveType

構成およびデータを含むテスト・システム・インスタンス全体をコピーするか、またはテスト・システム構成に基づいて新しいコンテンツ・サーバー・インスタンスを作成するかどうかを示すフラグ。

有効な値はcopyおよびinitです。

このプロパティは、Inbound Refineryには適用できません。

copy

copy configGroupのプロパティ:

構成およびデータをコピーします。

IntradocDir

Intradocディレクトリへのパス。ディレクトリ値は、ターゲット・システムのドメイン・ホーム・ディレクトリのパスに置き換えられる文字列{domainHome}で始まります。

/scratch/oracle/config/domains/domain_name/ucm/cs
or
{domainHome}/ucm/cs

WeblayoutDir

Weblayoutディレクトリへのパス。ディレクトリ値は、ターゲット・システムのドメイン・ホーム・ディレクトリのパスに置き換えられる文字列{domainHome}で始まります。

このプロパティは、WebLayoutDirがIntradocディレクトリ下のデフォルトの場所にある場合は、存在しないことがあります。

/scratch/oracle/config/domains/domain_name/ucm/cs/weblayout
or
{domainHome}/ucm/cs/weblayout

VaultDir

Vaultディレクトリへの絶対パス。ディレクトリ値は、ターゲット・システムのドメイン・ホーム・ディレクトリのパスに置き換えられる文字列{domainHome}で始まります。

このプロパティは、VaultDirがIntradocディレクトリ下のデフォルトの場所にある場合は、存在しないことがあります。

/scratch/oracle/config/domains/domain_name/ucm/cs/vault
or
{domainHome}/ucm/cs/vault

UserProfilesDir

ユーザー・プロファイル・ディレクトリへの絶対パス。ディレクトリ値は、ターゲット・システムのドメイン・ホーム・ディレクトリのパスに置き換えられる文字列{domainHome}で始まります。

このプロパティは、これがIntradocディレクトリ下のデフォルトの場所にある場合は、存在しないことがあります。

/scratch/oracle/config/domains/domain_name/ucm/cs/data/users/profiles
or
{domainHome}/ucm/cs/users/profiles

SocketHostAddressSecurityFilter

サーバー・ポートに直接アクセスできるホストを示すセキュリティ・フィルタ。縦棒(|)で区切って複数の値を指定できます。

127.0.0.1|0.0.0.0.0.0.0.1

init configGroupのプロパティ:

ソースの構成で新しいインスタンスを作成します。

SocketHostAddressSecurityFilter

サーバー・ポートに直接アクセスできるホストを示すセキュリティ・フィルタ。縦棒(|)で区切って複数の値を指定できます。

127.0.0.1|0.0.0.0.0.0.0.1

表20-31は、Oracle WebCenter Content: Imaging用に変更できる移動計画のプロパティを説明しています。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-31 Oracle WebCenter Content: Imagingの移動計画のプロパティ

プロパティ

説明

サンプル値

AdminUser

シード・システム・セキュリティに対するpasteConfig操作中に使用される管理ユーザーID。空白のままの場合は、pasteConfigコマンドラインで提供されるドメイン管理者ユーザーが使用されます。このプロパティは、Imaging管理ユーザーをドメイン管理者以外のユーザーにする必要がある場合に使用されます。

Admin2

MBean Settings configGroupのプロパティ:

MBeansの構成

InputAgentInputDirectories

入力ソースが作業を検索するディレクトリのカンマ区切りリスト。

IPM/InputAgent/Input

InputSampleDirectory

入力UIのサンプル・データを保持するディレクトリ。

IPM/InputAgent/Input/Sample

RenderGDFontPath

OITレンダリング・パッケージで使用されるTrueType(TTF)フォント・ファイル。

/usr/share/X11/fonts/TTF

UCM Connection configGroupのプロパティ:

WebCenter Contentの接続構成

repository.machine

リポジトリの場所。接続を「ローカルContent Serverの使用」に構成する場合は、値をlocalhostにする必要があります。

localhost

repository.port

ローカル・コンテンツ・サーバーの使用時に使用されるWebCenter Contentサーバー・ポート。ローカル・コンテンツ・サーバー接続を使用しない場合は、構成プロパティを削除します。

4444

repository.useSSL

WebCenter Contentシステムへの接続でSSLを使用するかどうかを指定するフラグ。有効な値は、trueまたはfalseです。

false

WORKFLOW Connection configGroupのプロパティ:

ワークフローの接続構成

bpel.front.address

Imaging SOA: 接続設定UIで使用されるHTTPフロントエンド・アドレス。

http://example.com:8001

表20-32は、Oracle Data Integrator用に変更できる移動計画のプロパティを説明しています。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-32 Oracle Data Integratorの移動計画のプロパティ

プロパティ

説明

サンプル値

JPS configuration file

JSEコンポーネントに対するJPS構成ファイルの相対または絶対パス。

config/fmwconfig/jps-config-jse.xml

Master Repository configGroupのプロパティ:

マスター・リポジトリの構成

Master Repository Id

Oracle Data Integratorのマスター・リポジトリID。ソース・マスター・リポジトリのIDとは異なる必要があります。

502

SUPERVISOR password file

ODIユーザーSUPERVISORのパスワードが含まれるセキュア・ファイルの絶対パス。

/scratch/oracle/odi_passwd

Url

データ・サーバーに接続するためのJDBC URL。

jdbc:oracle:thin:@hostname:1521:db2720

Schema name

ターゲットODIリポジトリが作成されるターゲット・データベースにあるスキーマの名前。

odi_master

Schema password file

スキーマのパスワードが含まれるセキュア・ファイルの絶対パス。

/scratch/oracle/odi_schema_passwd

Physical Data Servers configPropertyのプロパティ:

データ・サーバーの構成

Schema name

データベース・データ・サーバーのスキーマ名またはファイル・タイプ・データ・サーバーのディレクトリの場所。

FG_Dir_Schema

Work Schema

データベース・データ・サーバーの作業スキーマの名前またはファイル・タイプ・データ・サーバーのディレクトリの場所。

/tmp/FG_Dir_Schema

Url

データ・サーバーに接続するためのJDBC URL。

jdbc:oracle:thin:@localhost:1521/example.com

User

物理データ・サーバー接続用のユーザー名。

username

Password File

物理データ・サーバー接続用のユーザー・パスワードが含まれるセキュア・ファイルの絶対パス。

/scratch/oracle/rpd_ds_conn_passwd

Agents configPropertyのプロパティ:

エージェントの構成

Host name

エージェントのホスト名。

localhost

Host port

エージェントのホスト・ポート番号。

12311

Work repositories configPropertyのプロパティ:

作業リポジトリの構成

Work Repository Id

作業リポジトリのID。ソース作業リポジトリのIDとは異なる必要があります。

2

Url

作業リポジトリに接続するためのJDBC URL。

jdbc:oracle:thin:@host.example.com:7089/DB7089

User

作業リポジトリに接続するためのユーザー名。

username

Password File

物理データ・サーバー接続用のユーザー・パスワードが含まれるセキュア・ファイルの絶対パス。

/scratch/oracle/odi_pds_passwd

表20-33に、Oracle Access Manager、Oracle Security Token ServiceおよびOracle Identity Connectに対して変更可能な移動計画プロパティを示します。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-33 Oracle Access Manager、Oracle Security Token ServiceおよびOracle Identity Connectに対する移動計画プロパティ

プロパティ

説明

サンプル値

Load Balancer configPropertyのプロパティ:

ロード・バランサ関連の構成プロパティ。

hostname

ロード・バランサのホスト名。

example.com

port

ロード・バランサのポート番号。

368

ManagedServer configGroupのプロパティ:

管理対象サーバー関連の構成プロパティ移動計画ですべての管理対象サーバーの次のプロパティを更新します。

ProxyPort

プロキシ・サーバーのポート番号。

5555

OIM Connection Information configPropertyのプロパティ:

Oracle Identity Manager関連の構成プロパティOracle Access ManagerとOracle Identity Managerが統合されている場合、このプロパティは移動計画に存在します。

Host/Port

Oracle Identity Managerのホスト名およびポート番号のあるURL。

http://example.com:7010

LDAP configPropertyのプロパティ:

LDAPの構成。組込みLDAPが使用されていない場合のみ、これらのプロパティは移動計画に存在します。

LDAP Url

LDAP接続のURL。これには、LDAPストアのホスト名およびポート番号が含まれます。

ldap://example.com:3060

LDAP User

LDAPサーバーの管理ユーザー。

cn=orcladmin

Password File

管理LDAPユーザーのパスワードが含まれるセキュア・ファイルの絶対パス。構成を変更しない場合でも、パスワード・ファイルの場所を用意する必要があります。

/scratch/oam/ldap_passwd

ServiceProviders configPropertyのプロパティ:

サービス・プロバイダのプロパティ。Oracle Access ManagerがOracle Identity Connectに対するサービス・プロバイダの1つとして機能する場合、移動計画のこのセクションが存在します。

OAM_server_name

Oracle Access Managerサーバーのホスト名とポート番号を含むURL。

http://example.com:14101

Applications configPropertyのプロパティ:

アプリケーション関連プロパティ。Oracle Access ManagerがOracle Identity Connectに対するアプリケーションの1つとして存在する場合、移動計画のこのセクションが存在します。

ReturnURL

ターゲットOracle Access ManagerサーバーのURLが反映されている戻りURL。

example.com:5575

MultiDataCenter configPropertyのプロパティ:

複数のデータ・センターのプロパティ。

ClusterID

クラスタのID。これは一意の値にする必要があります。ソース・クラスタのIDと同じIDにできません。移動計画の値は空白です。

MyProdCluster

表20-34は、Oracle Adaptive Access Manager用に変更できる移動計画プロパティを説明しています。ホスト名、ポート番号、リスニング・アドレスなどのすべてのプロパティを編集して、ターゲット環境で異なる値にします。

表20-34 Oracle Adaptive Access Manager用の移動計画プロパティ

プロパティ

説明

サンプル値

ServerConfig configPropertyのプロパティ:

Oracle Adaptive Access Managerの構成プロパティ。

OAM PrimaryServerHost/Port

Oracle Access Managerのプライマリ・サーバーのホスト名およびポート番号。Oracle Adaptive Access ManagerがOracle Access Managerインスタンスと統合されている場合、このプロパティは存在します。

example.com:5575

OAMセカンダリ・サーバーのホスト/ポート

Oracle Access Managerのセカンダリ・サーバーのホスト名およびポート番号。Oracle Adaptive Access ManagerがOracle Access Managerインスタンスと統合されている場合、このプロパティは存在します。

example.com:5560

OIM管理対象サーバーのホスト/ポート

Oracle Identity Managerの管理対象サーバーのホスト名およびポート番号。Oracle Adaptive Access ManagerがOracle Identity Managerインスタンスと統合されている場合、このプロパティは存在します。

example.com:5000

OIM用のOAAMログインURL

Oracle HTTP Serverのホスト名およびポート番号。Oracle Adaptive Access ManagerがOracle Identity Managerインスタンスと統合されている場合、このプロパティは存在します。

example.com:ohsport

OTP UMSサービス用のWebサービスURL

WebサービスのURL。OTPユーザー・メッセージング・サービスが有効でParlayXの使用が無効な場合、このプロパティは移動計画に存在します。

http://WebserviceURL/endpoint

OTP UMSサービス用のParlayx URL

ParlayX URL。OTPユーザー・メッセージング・サービスとParlayXの使用の両方が有効な場合、このプロパティは移動計画に存在します。

http://ParlayxURL/endpoint

SOAPキーストア・ファイルの場所

SOAPキーストアの場所。SOAP認証が有効にされ構成済SOAPキーストアがドメイン・ホームの下にはない場合、このプロパティは存在します。

注意: SOAPキーストアがドメイン・ホームの下にある場合、SOAPキーストアはターゲットでドメイン・ホームの下において対応する場所に移行されています。

/scratch/oaam/soapks.ks

OAAMイメージ・フォルダの場所(ネイティブ統合)

Oracle Adaptive Access Managerのイメージ・フォルダの場所。SOAP Trackerが有効にされ構成済OAAMイメージ・フォルダがドメイン・ホームの下にはない場合、このプロパティは移動計画に存在します。

注意: OAAMイメージ・フォルダがドメイン・ホームの下にある場合、イメージ・フォルダはターゲットでドメイン・ホームの下において対応する場所に移行されています。

/scratch/oaam/oaam_images

システム構成キーストア・ファイルの場所

システム構成キーストアの場所。システム構成キーストアの場所は構成されているがドメイン・ホームの下にはない場合、このプロパティは移動計画に存在します。

注意: システム構成キーストアがドメイン・ホームの下にある場合、システム構成キーストアはターゲットでドメイン・ホームの下において対応する場所に移行されています。

scratch/KS_loc2

システムDBキーストア・ファイルの場所

データベースで構成値を保護するキーのあるキーストアの場所。システムDBキーストアの場所は構成されているがドメイン・ホームの下にはない場合、このプロパティは移動計画に存在します。

注意: システムDBキーストアがドメイン・ホームの下にある場合、システムDBキーストアはターゲットでドメイン・ホームの下において対応する場所に移行されています。

/scratch/KS_loc3

21 テスト環境から本番環境への移行

この章では、Oracle Fusion Middlewareをテスト環境などのソース環境から本番環境などのターゲット環境に移行する方法について説明します。ソース環境内でアプリケーションの開発とテストを行い、最終的にはテスト・アプリケーション、また、必要に応じてテスト・データをターゲット環境にロール・アウトできます。このアプローチは、アップグレードのテストおよびロール・アウトにも使用できます。

この章の項目は次のとおりです。

- Oracle Fusion Middlewareコンポーネントの移行の概要

- ソース環境からターゲット環境への移行手順の概要

- ターゲット環境への移行の一般的な手順

- Oracle Fusion Middlewareコンポーネントの移行

- マルチホスト環境への移行またはマルチホスト環境からの移行に関する考慮事項

- Oracle RAC環境への移行またはOracle RAC環境からの移行に関する考慮事項

- ソース環境からターゲット環境への移行に関する制限事項

- テストから本番への移行におけるエラーのリカバリ

- 事例: Oracle SOA SuiteおよびFusion Order Demoの新しいターゲット環境への移行

21.1 Oracle Fusion Middlewareコンポーネントの移行の概要

Oracle Fusion Middlewareコンポーネントをソース環境からターゲット環境に移行できます。

Oracle Fusion Middlewareコンポーネントを移行しない場合、移行元の環境で行ったカスタマイズや構成変更は、移行先の環境にすべて再適用する必要がありますが、コンポーネントを移行することにより、このような作業が最小化されます。ソース環境では、Oracle Fusion Middlewareのインストール、構成、カスタマイズおよび検証を行うことができます。システムが安定し、必要に応じて機能するようになったら、ターゲット環境を作成しますが、このとき、ソース環境に取り込んだすべての変更内容を再実行するかわりに、コンポーネントとその構成のコピーをソース環境から移行することでターゲット環境を作成できます。

既存のターゲット環境がある場合は、カスタマイズなど、ソース環境のすべての変更内容をターゲット環境に移行できます。

21.2 ソース環境からターゲット環境への移行手順の概要

この項では、インストールをソース環境からターゲット環境に移行する一般的な手順について説明します。

一般的な手順は次のとおりです。

1. ソース環境を準備します。第21.3.1項を参照してください。

2. ターゲット環境を準備します。第21.3.2項を参照してください。

3. ご使用の環境でデータベースを使用する場合は、新しいデータベースを作成するか、またはソース環境のデータベースをターゲット環境にコピーします。第21.3.3項を参照してください。

4. Oracle Identity Managementをターゲット環境に移行します。第21.4.1項を参照してください。

5. 第21.3.4項の説明に従って、copyBinaryおよびpasteBinaryスクリプトを使用して、コンポーネントまたはスイートのMiddlewareホームのコピーをソース環境からターゲット環境に移行します。

6. 第21.3.5項または第21.3.6項の説明に従って、コンポーネントの構成のコピーを移行します。ほとんどの場合、copyConfig、extractMovePlanおよびpasteConfigスクリプトを使用します。

7. その他のデータ(Oracle WebCenter PortalアプリケーションのデータやOracle Web Cache構成ファイルなど)を移行します。新しい環境に固有の情報(ホスト名、ポートなど)を変更します。各コンポーネントに固有の情報については、第21.4項を参照してください。

21.3 ターゲット環境への移行の一般的な手順

Oracle Fusion Middlewareコンポーネントの多くで、ソース環境からターゲット環境に移行する際に、共通の手順を使用します。ただし、すべてのコンポーネントがこれらの手順のすべてまたはそれらの一部を使用するわけではありません。特定のコンポーネントの場合、第21.4項の手順に従う必要があります。

この項では、共通の手順について、次のとおり説明します。

- ソース環境の準備

- ターゲット環境の準備

- ターゲット環境でのデータベースのインストール

- Middlewareホームおよびバイナリ・ファイルの移行

- Javaコンポーネントの構成の移行

- Oracleインスタンスおよびシステム・コンポーネントの構成の移行

- ユーザーおよびグループの構成

注意:

これらの手順および移動計画で使用するスクリプトでは、通常、パスワードを含むファイルを指定する必要があります。不明瞭化したパスワードを含むファイルを生成するには、第20.2.1.12項で説明されているobfuscatePasswordスクリプトを使用します。

21.3.1 ソース環境の準備

この章の手順では、次の一部またはすべてが含まれる、Oracle Fusion Middlewareのインストールおよび構成がソース環境で行われていることを想定しています。

- Oracle Fusion Middlewareコンポーネント(アイデンティティ管理、Oracle SOA Suite、Oracle WebCenter Portalなど)で使用される1つ以上のデータベースをインストールしました。

- RCUを使用してソース環境で必要なスキーマを作成しました。『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

- Oracle WebLogic Serverをインストールし、Middlewareホームを作成しました。

- Identity Managementをインストールし、構成しました。
これには、目的のLDAPツリーおよびエントリ(特にユーザーおよびグループ)の作成(Oracle Internet Directoryの場合)、データソースに対するアダプタの作成(Oracle Virtual Directoryの場合)、ポリシーの作成(Oracle Web Services Managerの場合)が含まれます。また、SSL用の自己署名証明書の構成も含まれます。(ターゲット環境では、信頼できるCA署名付き証明書を使用します。)

- Oracle Fusion Middlewareコンポーネント(Oracle SOA Suite、Oracle WebCenter Portalなど)をインストールし、構成しました。

- セキュリティ・ポリシーを構成しました。

- 1つ以上のアプリケーションまたはSOAコンポジット・アプリケーションをデプロイしました。これらのアプリケーションには、内部参照および外部参照が含まれる場合があります。

ソース環境のMiddlewareホームのすべてのOracleホームは、同じOracleインベントリに登録されている必要があります。複数のコンポーネントを1つのMiddlewareホームにインストールしているが、使用しているOracleインベントリの場所が様々である場合は、スクリプトで一部のOracleホームを検出できません。

21.3.2 ターゲット環境の準備

この章の手順を使用するには、ターゲット環境が次の前提条件を満たしている必要があります。

- コピーするMiddlewareホームおよびコンポーネントのバージョンと互換性のあるcloningclient.jarファイルおよび移行スクリプトを使用する必要があります。この章の手順では、現行バージョンのcloningclient.jarファイルおよび移行スクリプトを使用することを前提としています。

- ターゲット環境は、ソース環境と同じオペレーティング・システム上にある必要があります。また、オペレーティング・システム・アーキテクチャは、両方の環境で同じでなければなりません。たとえば、両方の環境で32ビットのオペレーティング・システムまたは64ビットのオペレーティング・システムを実行している必要があります。
MiddlewareホームのすべてのOracleホームは、すべてが32ビットまたはすべてが64ビットである必要があります。この操作は、32ビットと64ビットのOracleホームが混在する環境をサポートしません。

スクリプトを実行するときに、対応するJavaホームを指定する必要があります。つまり、Oracleホームが64ビットの場合、64ビットのJavaホームを指定する必要があります。Oracleホームが32ビットの場合、32ビットのJavaホームを指定する必要があります。

- ターゲット環境では、ソース環境のユーザーと同じスーパーユーザーまたは管理ユーザーが必要です。ユーザーのパスワードは、外部のLDAPを使用する場合に別々にでき、pasteConfigスクリプトを使用する際にコマンドラインで指定できます。インストールの移行が完了したら、ターゲット環境でユーザーを変更できます。

- ターゲット環境のデータベースは、ソース環境のデータベースと同じタイプである必要があります。たとえば、ソース環境のデータベースがOracle Databaseである場合、ターゲット環境のデータベースもOracle Databaseである必要があります。ターゲット環境のデータベースは、ソース環境のデータベースと同じバージョンである必要があります。

- データベースが適切に調整されていない場合、copyConfig操作およびpasteConfig操作でパフォーマンスの問題が発生することがあります。このようなパフォーマンスの問題を回避するには、次の標準データベース・パフォーマンス調整ガイドラインに加えて、MDS表のインポート用に、データベースに十分なRAMが割り当てられていることを確認します。また、次のプロシージャを実行して、ターゲット・データベースに対する統計を実行します。

BEGIN
dbms_stats.gather_schema_stats(ownname => 'prefix_MDS',
METHOD_OPT => 'FOR ALL COLUMNS SIZE AUTO',
CASCADE => TRUE, ESTIMATE_PERCENT => NULL);
END;

このプロシージャでは、prefix_MDSは、インストールのMDSスキーマ名です。

21.3.3 ターゲット環境でのデータベースのインストール

様々なコンポーネント(Oracle Internet Directory、Oracle SOA SuiteおよびOracle WebCenter Portalなど)でデータベースが必要となります。

ターゲット環境のデータベースは、ソース環境のデータベースと同じタイプである必要があります。たとえば、ソース環境のデータベースがOracle Databaseである場合、ターゲット環境のデータベースもOracle Databaseである必要があります。ターゲット環境のデータベースは、ソース環境のデータベースと同じバージョンである必要があります。

新しいデータベースをインストールするか、またはソース環境からデータベースをコピーできます。

- 新しいデータベースをインストールします。これは、Oracle Internet Directory以外のほとんどのコンポーネントに使用できます。次の手順を実行します。

1. データベース・ソフトウェアをインストールして構成します。

2. RCUを使用してターゲット・データベースで必要なスキーマを作成します。『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

3. アプリケーションで使用するカスタム・スキーマを作成します。たとえば、アプリケーションがソース環境でカスタム・スキーマを使用する場合、ターゲット環境でそのスキーマを作成します。

- Oracle Database RMANのduplicateコマンドを使用して、複製データベースを作成します。Oracle Internet Directoryを移行する場合には、この方法を使用します。複製データベースは、完全に独立して動作するように、ソース・データベースと異なるDBIDを使用して作成する必要があります。
Oracle Databaseリリース11gの複製をターゲット環境に作成する手順は次のとおりです。

1. ソース環境で、Identity Managementプロセスを停止します。

2. ターゲット環境でOracle Databaseソフトウェアをインストールしますが、その際、データベースは作成しません。これを行うには、「構成オプションの選択」画面で「データベース・ソフトウェアのみインストール」を選択します。

3. ソース環境でtnsnames.oraファイルを編集し、ターゲット環境のデータベースにエントリを追加します。
tnsnames.oraファイルの例を次に示します。この例では、testDBはソース環境のデータベースで、prodDBはターゲット環境のデータベースです。

testDB =
(DESCRIPTION =
(ADDRESS =
(PROTOCOL = TCP)
(HOST = 192.168.1.1)
(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SID = testDB)
)
)
prodDB=
(DESCRIPTION =
(ADDRESS =
(PROTOCOL = TCP)
(HOST = 192.168.2.4)
(PORT = 1521))
(CONNECT_DATA =
(SERVER = DEDICATED)
(SID = prodDB)
)
)

4. ソース環境でlistener.oraファイルを編集し、ターゲット環境のデータベースにエントリを追加します。
追加するエントリを次に示します。

LISTENER_mts =
(DESCRIPTION_LIST =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)
(HOST = 192.168.2.4)
(PORT = 1521)(IP = FIRST))
)
)
SID_LIST_LISTENER_mts =
(SID_LIST =
(SID_DESC =
(SID_NAME = prodDB)
(ORACLE_HOME = /scratch/oracle/test)
)
)

5. ターゲット環境で、ORACLE_HOME/dbsディレクトリにパスワード・ファイルを作成します。SYSパスワードは、ソース環境のデータベースにおけるSYSアカウント用のパスワードと同じである必要があります。次のコマンドを使用すると、パスワード・ファイルが作成されます。

orapwd password=password file=ORACLE_HOME/dbs/orapwproddb

6. ターゲット環境で、ORACLE_HOME/dbsディレクトリにパラメータ・ファイル(pfile)を作成します。このファイルには、DB_NAMEパラメータのみが含まれている必要があります。次に例を示します。

DB_NAME=prodDB

7. ターゲット環境で、ターゲット・データベースを指すようにORACLE_SID環境変数を設定します(まだ設定されていない場合)。

8. Windowsで、oradimコマンドを使用してインスタンスを作成します。次に例を示します。

oradim -new -sid sid -intpwd password -startmode auto -pfile 'ORACLE_HOME\database\pfile'

9. データベースをNOMOUNTモードで起動します。次に例を示します。

SQL> STARTUP NOMOUNT PFILE='ORACLE_HOME/dbs/pfile'

10. ソース環境のデータベースをターゲット環境に移行するには、ターゲット環境でRMANを使用します。
RMANを使用してデータベースを複製する例を次に示します。

RMAN
DUPLICATE TARGET DATABASE
TO prodDB
FROM ACTIVE DATABASE
SPFILE
NOFILENAMECHECK;

RMANは、サーバー・パラメータ・ファイルを接続先ホストに自動的にコピーし、サーバー・パラメータ・ファイルを使用して補助インスタンスを起動して、必要なすべてのデータベース・ファイルおよびアーカイブREDOログをネットワークを介して接続先ホストにコピーし、データベースをリカバリします。最後に、RMANは、RESETLOGSオプションを指定してデータベースを開き、オンラインREDOログを作成します。

詳細な手順は、『Oracle Databaseバックアップおよびリカバリ・ユーザーズ・ガイド』を参照してください。

21.3.4 Middlewareホームおよびバイナリ・ファイルの移行

Middlewareホームのコピーをターゲット環境に移行するには、copyBinaryおよびpasteBinaryスクリプトを使用します。

- copyBinaryスクリプトによって、ソースの準備が実行され、アーカイブが作成されます。また、Middlewareホームと、Middlewareホーム内のOracleホームのファイル権限が記録されます。
アーカイブには、Oracle WebLogic ServerホームおよびMiddlewareホーム内のすべてのOracleホームが含まれます。

- pasteBinaryスクリプトによって、クローニング先で前提条件が満たされているかどうかが確認されます。アーカイブ・ファイルからファイルが抽出され、OracleホームがOracleインベントリに登録されて、WebLogic ServerホームがMiddlewareホームに登録されます。
次に、スクリプトによってファイル権限がリストアされ、必要に応じてリンクが再設定されます。

次の点に注意してください。

- copyBinaryおよびpasteBinaryスクリプトを実行しても、ソースMiddlewareホーム、WebLogic ServerホームおよびOracleホームの、ロード可能なモジュールやアプリケーション固有のライブラリなどのすべての依存状態がターゲット・ホームに継承されるわけではありません。スクリプトによって、Middlewareホーム、およびソースのWebLogic ServerホームとOracleホーム全体がコピー先Middlewareホームにコピーされるためです。ソースのWebLogic ServerまたはOracleホームの外部にあるファイルは、自動的にはコピーされません。そのため、ソースのWebLogic ServerまたはOracleホームの外部にあるファイルを参照するアプリケーションは、ターゲット・ホームで正しく機能しない場合があります。
Middlewareホームの一部としてコピーされたOracleホームには、バイナリ・ファイルのみが含まれます。

- ミドルウェア・ホームをコピーする場合は、ミドルウェア・ホームの読取り専用部分のみがコピーされます。user_projectsディレクトリなどのユーザー構成ファイルは、アーカイブから除外されます。WebLogic Serverドメインはコピーされません。(copyConfigおよびpasteConfigスクリプトを使用して、ドメインをコピーします。)

- パスがシンボリック・リンクの場合、Middlewareホームを移行することはできません。

Middlewareホームを移行する手順は次のとおりです。

1. Windowsの場合は、ソースで、管理サーバーおよびMiddlewareホームで実行されている管理対象サーバーをすべて停止します。さらに、JavaやWebLogicのプロセスを停止します。(UNIXの場合は、サーバーを停止する必要はありません。)

2. ソースでcopyBinaryスクリプトを実行し、Middlewareホーム、WebLogic ServerホームおよびMiddlewareホーム内に含まれるOracleホームをコピーします。ソースのMiddlewareホーム内にOracleホームがない場合、アーカイブにOracleホームは含まれなくなります。
copyBinaryスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/copyBinary.sh
(Windows) ORACLE_COMMON_HOME\bin\copyBinary.cmd

copyBinaryスクリプトの構文の詳細は、第20.2.1.1項を参照してください。

たとえば、/scratch/Oracle /Middleware1のMiddlewareホームをコピーするには、次のコマンドを使用します。

copyBinary.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/mw_copy.jar
-sourceMWHomeLoc /scratch/Oracle/Middleware1
-invPtrLoc /scratch/oracle/oraInst.loc

3. Middlewareホームを別のホストにコピーする場合は、そのシステムにアーカイブ・ファイルをコピーします。

4. pasteBinaryスクリプトとcloningclient.jarファイルをターゲット・システムにコピーし、実行権限があることを確認します。ファイルの場所については、第20.2項を参照してください。
pasteBinaryスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/pasteBinary.sh
(Windows) ORACLE_COMMON_HOME\bin\pasteBinary.cmd

cloningclient.jarファイルは次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/jlib/cloningclient.jar
(Windows) ORACLE_COMMON_HOME\jlib\cloningclient.jar

pasteConfigなど他のスクリプトをコピーしないでください。これらのスクリプトは、ステップ6で説明しているように、ファイルの抽出時に生成されます。

5. LinuxとUNIXでは、インストールされているOracle製品がターゲット・システムにない場合、oraInst.locファイルを作成し、Oracleインベントリ(oraInventory)に対する書込みアクセス権が付与されているメンバーの所属グループとOracleインベントリの格納先を指定する必要があります。たとえば、oraInst.locファイルには次を含めることができます。

inst_group=dba
inventory_loc=/scratch/oracle1/oraInventory

そして、その場所がデフォルトの場所(/etc/oraInst.loc.)ではない場合、-invPtrLocオプションをpasteBinaryスクリプトに使用して、oraInst.locファイルの場所を指定します。

6. ターゲットで、pasteBinaryスクリプトを使用して、アーカイブからファイルを抽出します(pasteBinaryスクリプトの構文の詳細は、第20.2.1.2項を参照)。

注意:

Middlewareホームに対する親ディレクトリが存在しない場合は、pasteBinaryスクリプトによりディレクトリが作成されます。

Middlewareホームの実際のディレクトリ(MW_Home_prodなど)は存在できません。

たとえば、/scratch/oracle/MW_Home_prodディレクトリにアーカイブを適用するには、次のコマンドを使用します。

pasteBinary.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc  /tmp/mw_copy.jar
-targetMWHomeLoc /scratch/oracle/MW_Home_prod

Middlewareホームが/scratch/oracle/MW_Home_prodに抽出され、その下にWebLogic Serverホーム、およびソースOracleホーム名と同じ名前ですべてのOracleホームが抽出されます。

7. pasteBinaryスクリプトでカスタム・インベントリの場所を使用した場合(invPtrLocパラメータを使用して)、pasteBinary操作の最後にルートとして次のスクリプトを実行する必要があります。

ORACLE_HOME/oracleRoot.sh

8. ターゲットで、ノード・マネージャ・ディレクトリおよびこのディレクトリ内のファイルを削除します。このディレクトリのデフォルトの場所:

WL_hOME/common/nodemanager

ノード・マネージャ構成は、第21.3.5項のステップ10で移行します。

21.3.5 Javaコンポーネントの構成の移行

Javaコンポーネント(Oracle SOA Suiteなど)のドメイン構成のコピーを移行するには、copyConfig、extractMovePlanおよびpasteConfigスクリプトを使用します。この手順により、ドメイン、管理サーバーおよび管理対象サーバーを含む構成がコピーされます。続いて、管理サーバーが起動されます。ノード・マネージャ構成のコピーも移行できます。

通常、ユーザーに固有のデータはターゲット環境とソース環境で同じではないため、この処理では、ユーザー固有のデータは移行されません。

注意:

- コンポーネントの構成を移行すると、スクリプトによりソースのトポロジがレプリケートされます。たとえば、ソース・ドメインにホストAの管理対象サーバーserver_1とserver_2、およびホストBの管理対象サーバーserver_3とserver_4が含まれる場合、ターゲットにも同様の管理対象サーバーとホストの関係を指定する必要があります。(移動計画のそれぞれの管理対象サーバーに対してホストを指定します。)

- ドメイン・ディレクトリは各マシンに対してローカルです。pasteConfigスクリプトは管理サーバー・ドメイン・ディレクトリでのみ実行されます。その後、管理対象サーバーのディレクトリが管理サーバーと異なる場合は、Oracle WebLogic Serverのpackおよびunpackコマンドを使用して、管理対象サーバーのドメイン・ディレクトリを再作成する必要があります。第21.5項を参照してください。

ドメイン構成およびノード・マネージャ構成のコピーを移行する手順は次のとおりです。

1. ソースで、管理サーバーおよびすべての管理対象サーバーが起動されていることを確認します。

2. ソースでcopyConfigスクリプトを実行して、ドメイン構成をコピーします。

copyConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd

copyConfigスクリプトの構文の詳細は、第20.2.1.3項を参照してください。

たとえば、Middlewareホーム/scratch/Oracle/Middleware1にあるSOA_domain1というOracle SOA Suiteドメインの構成をコピーするには、次のコマンドを使用します。

copyConfig.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/soa.jar
-sourceDomainLoc //scratch/oracle/config/domains/SOA_domain1
-sourceMWHomeLoc /scratch/Oracle/Middleware1
-domainHostName example.com
-domainPortNum 8001
-domainAdminUserName domain_admin_username
-domainAdminPasswordFile /scratch/admin/passwd.txt
-logDirLoc /tmp/logs

3. ドメイン構成を別のホストにコピーする場合は、そのシステムにアーカイブ・ファイルをコピーします。

4. ソースでextractMovePlanスクリプトを使用して、アーカイブから移動計画を抽出します。
extractMovePlanスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/extractMovePlan.sh
(Windows) ORACLE_COMMON_HOME\bin\extractMovePlan.cmd

extractMovePlanスクリプトの構文の詳細は、第20.2.1.7項を参照してください。

次に例を示します。

extractMovePlan.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/soa.jar
-planDirLoc /tmp/Oracle/t2p_plans/soa

注意:

ソース環境に変更を加えていなくても、copyConfigスクリプトを使用するたびに、新しい移動計画を抽出する必要があります。pasteConfigスクリプトによって、移動計画とアーカイブが一致することが確認されます。一致しない場合は、スクリプトによりエラーが返されます。

5. ターゲット環境の値にあわせてプロパティを変更するために、移動計画を編集します。移行するコンポーネント・タイプごとのプロパティのリストについては、表20-12を参照してください。
複数のドメインを含む環境のドメインを1つのみ移行する場合は、移動計画で移行しないドメインのエントリを削除します。

6. 編集した移動計画をターゲットにコピーします。(pasteConfig操作の間、-movePlanLocオプションを使用して場所を指定します。)

7. ターゲットで次のスクリプトを実行して、移動計画に必要な不明瞭化したパスワード・ファイルを生成します。パスワード・ファイルごとにスクリプトを実行します。

(UNIX) ORACLE_COMMON_HOME/bin/obfuscatePassword.sh
(Windows) ORACLE_COMMON_HOME\bin\obfuscatePassword.cmd

スクリプトによって、パスワードおよびパスワード・ファイルが書き込まれる場所の入力を求めるプロンプトが表示されます。

8. ターゲットで、copyConfig操作中に-opssDataExportパラメータがtrueに設定された場合(デフォルトでtrueに設定されます)、次の環境変数を設定する必要があります。

CONFIG_JVM_ARGS "-Xmx2048M -Xms2048M"

9. ターゲットで、pasteConfigスクリプトを使用してアーカイブからファイルを抽出します。

pasteConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd

スクリプトの構文の詳細は、第20.2.1.8項を参照してください。

たとえば、Middlewareホーム/scratch/Oracle/Middleware1にアーカイブを適用するには、次のコマンドを使用します。

pasteConfig.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/soa.jar
-movePlanLoc /tmp/Oracle/t2p_plans/soa/moveplan.xml
-targetDomainLoc //scratch/oracle/config/domains/SOA_domain1
-targetMWHomeLoc /scratch/Oracle/Middleware1/
-domainAdminPasswordFile /scratch/pwd_dir/pass.txt

10. ソースでcopyConfigスクリプトを実行して、ノード・マネージャ構成をコピーします。

copyConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd

スクリプトの構文の詳細は、第20.2.1.6項を参照してください。たとえば、次のコマンドを使用します。

copyConfig.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/nm.jar
-sourceNMHomeLoc /scratch/Oracle/Middleware/wlserver_10.3/common/nodemanager
-logDirLoc /tmp/logs

11. ノード・マネージャを別のホストにコピーする場合は、そのシステムにアーカイブ・ファイルをコピーします。

12. ソースでextractMovePlanスクリプトを使用して、アーカイブから移動計画を抽出します。
extractMovePlanスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/extractMovePlan.sh
(Windows) ORACLE_COMMON_HOME\bin\extractMovePlan.cmd

extractMovePlanスクリプトの構文の詳細は、第20.2.1.7項を参照してください。

次に例を示します。

extractMovePlan.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/nm.jar
-planDirLoc /tmp/Oracle/t2p_plans/nm

13. ターゲット環境の値にあわせてプロパティを変更するために、移動計画を編集します。ノード・マネージャのプロパティのリストについては、表20-13を参照してください。

14. 編集した移動計画をターゲットにコピーします。(pasteConfig操作の間、-movePlanLocオプションを使用して場所を指定します。)

15. ターゲットで次のスクリプトを実行して、移動計画に必要な不明瞭化したパスワード・ファイルを生成します。パスワード・ファイルごとにスクリプトを実行します。

(UNIX) ORACLE_COMMON_HOME/bin/obfuscatePassword.sh
(Windows) ORACLE_COMMON_HOME\bin\obfuscatePassword.cmd

スクリプトによって、パスワードおよびパスワード・ファイルが書き込まれる場所の入力を求めるプロンプトが表示されます。

16. ターゲットでは、pasteConfigスクリプトを使用してアーカイブからファイルを抽出します。
pasteConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd

スクリプトの構文の詳細は、第20.2.1.11項を参照してください。

たとえば、次のコマンドを使用します。

pasteConfig -javaHome USER_HOME/jrockit_160_17_R28.0.0-679/
-archiveLoc /tmp/nm.jar
-targetNMHomeLoc /scratch/Oracle/Middleware1/wlserver_10.3/common/nodemanager
-targetMWHomeLoc /scratch/Oracle/Middleware1
-movePlanLoc /tmp/Oracle/t2p_plans/nm/moveplan.xml
-silent true

この作業が完了したら、第21.4項の説明に従って、コンポーネントごとに追加手順を実行する必要があります。

21.3.6 Oracleインスタンスおよびシステム・コンポーネントの構成の移行

OracleインスタンスおよびOracle HTTP Server、Oracle Internet Directory、Oracle Virtual Directory、Oracle BI EEなどのシステム・コンポーネントは、次のいずれかの方法で移行できます

- Oracleインスタンスおよびそのすべてのシステム・コンポーネントの移行

- 個別のシステム・コンポーネントの移行

いずれの場合も、copyConfig、extractMovePlanおよびpasteConfigスクリプトを使用します。スクリプトに渡すオプションのみが異なります。

21.3.6.1 Oracleインスタンスおよびそのすべてのシステム・コンポーネントの移行

インスタンス内のすべてのシステム・コンポーネントの構成を含む、Oracleインスタンス全体を移行できます。

次の手順を実行します。

1. ソースで、copyConfigスクリプトを実行します。
copyConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd

スクリプトの構文の詳細は、第20.2.1.4項を参照してください。

たとえば、/scratch/Oracle/Middleware1/webtier_1に配置されているOracleインスタンスをコピーするには、次のコマンドを使用します。

copyConfig.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/ohs1.jar
-sourceInstanceHomeLoc /scratch/Oracle/Middleware1/webtier_1

2. コンポーネントを別のホストにコピーする場合は、そのシステムにアーカイブ・ファイルをコピーします。

3. ソースでextractMovePlanスクリプトを使用して、アーカイブから移動計画を抽出します。
extractMovePlanスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/extractMovePlan.sh
(Windows) ORACLE_COMMON_HOME\bin\extractMovePlan.cmd

extractMovePlanスクリプトの構文の詳細は、第20.2.1.7項を参照してください。

次に例を示します。

extractMovePlan.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/ohs1.jar
-planDirLoc /tmp/Oracle/t2p_plans/ohs

4. 移動計画を編集して、ターゲット環境の値を反映するように特定のコンポーネントのプロパティを変更します。

- Oracle HTTP Serverについては、表20-21を参照してください。

- Oracle Internet Directoryについては、表20-22を参照してください。

- Oracle Virtual Directoryについては、表20-23を参照してください。

- Oracle BI EEの詳細は、表20-25を参照してください。

5. 編集した移動計画をターゲットにコピーします。(pasteConfig操作の間、-movePlanLocオプションを使用して場所を指定します。)

6. ターゲットで次のスクリプトを実行して、移動計画に必要な不明瞭化したパスワード・ファイルを生成します。パスワード・ファイルごとにスクリプトを実行します。

(UNIX) ORACLE_COMMON_HOME/bin/obfuscatePassword.sh
(Windows) ORACLE_COMMON_HOME\bin\obfuscatePassword.cmd

スクリプトによって、パスワードおよびパスワード・ファイルが書き込まれる場所の入力を求めるプロンプトが表示されます。

7. ターゲットでは、pasteConfigスクリプトを使用してアーカイブからファイルを抽出します。
pasteConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd

スクリプトの構文の詳細は、第20.2.1.9項を参照してください。

たとえば、Oracleインスタンスwebtier_2にアーカイブを適用するには、次のコマンドを使用します。

pasteConfig.sh -javaHome /scratch/Oracle/Middleware/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/ohs1.jar
-movePlanLoc /tmp/Oracle/t2p_plans/ohs/moveplan.xml
-targetOracleHomeLoc /scratch/Oracle/Middleware/Oracle_WebTier
-targetInstanceHomeLoc /scratch/Oracle/Middleware/webtier_2
-targetInstanceName webtier_2
-domainHostName myhost
-domainPortNum 7001
-domainAdminUserName domain_admin_username
-domainAdminPasswordFile domain_admin_password_file

Oracleインスタンス名はドメイン内で一意である必要があります。Oracleインスタンスのアーカイブを同一ドメインに適用する場合は、-targetInstanceNameオプションを使用してインスタンスに別の名前を指定します。

この作業が完了したら、第21.4項の説明に従って、コンポーネントごとに追加手順を実行する必要があります。

21.3.6.2 個別のシステム・コンポーネントの移行

Oracleインスタンス内の個別のシステム・コンポーネントの構成を移行できます。

次の手順を実行します。

1. ソースで、copyConfigスクリプトを実行します。個別のコンポーネントのコピーは、Oracleインスタンスのコピーと同様ですが、-sourceComponentNameオプションを追加する点が異なります。
copyConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd

スクリプトの構文の詳細は、第20.2.1.5項を参照してください。

たとえば、/scratch/Oracle/Middleware1/webtier_1に配置されているOracleインスタンス内のohs1というOracle HTTP Serverインスタンスをコピーするには、次のコマンドを使用します。

copyConfig.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/ohs1.jar
-sourceInstanceHomeLoc /scratch/Oracle/Middleware1/webtier_1
-sourceComponentName ohs1

2. コンポーネントを別のホストにコピーする場合は、そのシステムにアーカイブ・ファイルをコピーします。

3. ソースでextractMovePlanスクリプトを使用して、アーカイブから移動計画を抽出します。
extractMovePlanスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/extractMovePlan.sh
(Windows) ORACLE_COMMON_HOME\bin\extractMovePlan.cmd

extractMovePlanスクリプトの構文の詳細は、第20.2.1.7項を参照してください。

次に例を示します。

extractMovePlan.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/ohs1.jar
-planDirLoc /tmp/Oracle/t2p_plans/ohs

4. 移動計画を編集して、ターゲット環境の値を反映するように特定のコンポーネントのプロパティを変更します。

- Oracle HTTP Serverについては、表20-21を参照してください。

- Oracle Internet Directoryについては、表20-22を参照してください。

- Oracle Virtual Directoryについては、表20-23を参照してください。

- Oracle BI EEの詳細は、表20-25を参照してください。

5. 編集した移動計画をターゲットにコピーします。(pasteConfig操作の間、-movePlanLocオプションを使用して場所を指定します。)

6. ターゲットで次のスクリプトを実行して、移動計画に必要な不明瞭化したパスワード・ファイルを生成します。パスワード・ファイルごとにスクリプトを実行します。

(UNIX) ORACLE_COMMON_HOME/bin/obfuscatePassword.sh
(Windows) ORACLE_COMMON_HOME\bin\obfuscatePassword.cmd

スクリプトによって、パスワードおよびパスワード・ファイルが書き込まれる場所の入力を求めるプロンプトが表示されます。

7. ターゲットでは、pasteConfigスクリプトを使用してアーカイブからファイルを抽出します。個別のコンポーネントのアーカイブを適用するには、-targetComponentNameオプションを追加します。
pasteConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd

スクリプトの構文の詳細は、第20.2.1.10項を参照してください。

たとえば、Oracleインスタンスwebtier_2にアーカイブを適用し、ターゲットのOracle HTTP Serverインスタンスにohs_clという名前を付けるには、次のコマンドを使用します。

pasteConfig.sh -javaHome /scratch/Oracle/Middleware/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/ohs1.jar
-movePlanLoc /tmp/Oracle/t2p_plans/ohs/moveplan.xml
-targetOracleHomeLoc /scratch/Oracle/Middleware/Oracle_WebTier
-targetInstanceHomeLoc /scratch/Oracle/Middleware/webtier_2
-targetInstanceName webtier_2
-targetComponentName ohs_cl
-domainHostName myhost
-domainPortNum 7001
-domainAdminUserName domain_admin_username
-domainAdminPasswordFile domain_admin_password_file

Oracleインスタンス名はドメインで一意である必要があり、コンポーネント名はOracleインスタンスで一意である必要があります。Oracleインスタンスのアーカイブを同一ドメインに適用する場合、-targetInstanceNameおよび-targetComponentNameオプションを使用してインスタンスおよびコンポーネントに別の名前を指定します。

この作業が完了したら、第21.4項の説明に従って、コンポーネントごとに追加手順を実行する必要があります。

21.3.7 ユーザーおよびグループの構成

新しいターゲット環境でセキュリティを構成する必要があります。手順は、環境およびアプリケーションの構成によって異なります。

ターゲット環境のLDAPアイデンティティ・ストアでは、ソース環境と同じユーザーおよびグループを使用しない可能性や、すでにユーザーおよびグループが移入されている可能性があります。ソース環境のユーザー、グループおよびパスワードをターゲット環境に移行する必要がある場合のみ、次の手順を実行します。

1. ldapsearchコマンドを使用して、ソース環境のLDAPアイデンティティ・ストアからユーザーおよびグループをエクスポートします。これにより、後でターゲット環境のLDAPアイデンティティ・ストアにインポートするldifファイルが作成されます。ldapsearchコマンドは、アイデンティティ管理コンポーネントのORACLE_HOME/binディレクトリにあります。次に例を示します。

ORACLE_HOME/bin/ldapsearch -h test_oid_host -p test_oid_port
-D "cn=orcladmin" -w "test_orcladmin_passwd" -b "cn=Users,dc=us"

2. 次の例で示すように、ldapaddmtコマンドを使用して、ソース環境からエクスポートしたldifファイルをターゲット環境にインポートします(ORACLE_HOMEはアイデンティティ管理のOracleホームです)。

ORACLE_HOME/bin/ldapaddmt -h production_oid_host
-p production_oid_port -D "cn=orcladmin"
-w "production_orcladmin_passwd" -r -f ldif_filename

21.4 Oracle Fusion Middlewareコンポーネントの移行

次の各項では、Oracle Fusion Middlewareコンポーネントを移行する場合に実行する必要のある手順について説明します。多くの場合、これらの手順では第21.3項で説明されている一般的な手順を使用します。すべてのコンポーネントで、次の各項で説明する追加手順を実行する必要があります。

- アイデンティティ管理コンポーネントのターゲット環境への移行

- Oracle SOA Suiteのターゲット環境への移行

- Oracle WebCenter Portalのターゲット環境への移行

- Oracle WebCenter Contentのターゲット環境への移行

- Oracle Hyperion Enterprise Performance Management Systemのターゲット環境への移行

- Web層のターゲット環境への移行

- Oracle Business Intelligenceのターゲット環境への移行

- Oracle Real-Time Decisionsのターゲット環境への移行

- Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle BI Discovererのターゲット環境への移行

- Oracle Data Integratorのターゲット環境への移行

21.4.1 アイデンティティ管理コンポーネントのターゲット環境への移行

次の各項目では、アイデンティティ管理をソース環境からターゲット環境に移行する方法について説明します。

- アイデンティティ管理の新しいターゲット環境への移行

- アイデンティティ管理の既存のターゲット環境への移行

いずれの場合も、ソース環境で次の操作を実行済です。

- アイデンティティ管理コンポーネント(Oracle Internet Directory、Oracle Directory Integration Platform (Oracle Internet Directoryに依存)、Oracle Identity Federationなど)に使用されるデータベースをインストールしました。

- RCUを使用してソース環境で必要なスキーマを作成しました。『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

- アイデンティティ管理(Oracle Internet Directory、Oracle Virtual Directory、Oracle Web Services Manager、Oracle Adaptive Access Managerの一部またはすべてを含む)をインストールして構成しました。

- Oracle Internet Directoryの場合、目的のLDAPツリーおよびエントリ(特にユーザーおよびグループ)を作成しました。

- Oracle Virtual Directoryの場合、様々なデータソース(LDAP、データベースなど)に対するアダプタを作成し、場合によっては、ローカル・ストア・アダプタ(LSA)を構成してローカル・ファイルシステムにあるローカルのLDAPデータを作成しました。

- Oracle Directory Integration Platformの場合、様々なターゲットに対する同期プロファイルを作成しました。これらのプロファイルは、Oracle Internet DirectoryにあるLDAPエントリの形式です。

- Oracle Identity Federationの場合、様々な信頼できるアイデンティティ・プロバイダおよびサービス・プロバイダを構成しました。

- Oracle Access Manager 11gの場合、保護されたアプリケーションのWeb層で構成されている対応Webゲートによる認証を設定しました。Oracle Fusion Middleware Oracle Access ManagerおよびOracle Security Token Service管理者ガイドで説明されているように、Oracle Access Manager構成データはファイル内に存在し、ポリシーおよび構成データはデータベース内に存在します。

- Oracle Platform Securityの場合、セキュリティ・ポリシーおよび格納済の資格証明を資格証明ストア・フレームワーク(CSF)に作成しました。

- Oracle Web Services Managerの場合、Oracle Web Services Managerのポリシーを作成しました。これらのポリシーは、Webサービスおよびクライアントにも組み込まれます。

- SSLの場合、自己署名証明書を構成しました(ターゲット環境では、信頼できるCA署名付き証明書を使用します。)

21.4.1.1 アイデンティティ管理の新しいターゲット環境への移行

この手順では、アイデンティティ管理コンポーネント(Oracle Internet Directory、Oracle Virtual Directory、Oracle Directory Integration Platformなど)がソース環境にインストール済で、これらを存在していないターゲット環境に移行する必要があると想定します。

注意:

Oracleでは、移行スクリプトを使用した、または手動でのOracle Identity Managerの移行はサポートしていません。また、Oracle Identity Managerが他のコンポーネントのソース環境の一部である場合は、その環境に対する移行スクリプトは失敗します。

使用するコンポーネントに応じて次の作業を実行します。作業1は、すべてのコンポーネントで必要です。

- 作業1「データベース、Middlewareホームおよびドメイン構成の新しいターゲット環境への移行」

- 作業2「Oracle Access Manager用の前提条件作業の実行」

- 作業3「Oracle Internet Directoryの新しいターゲット環境への移行」

- 作業4「Oracle Virtual Directoryの新しいターゲット環境への移行」

- 作業5「Oracle Directory Integration Platformの新しいターゲット環境への移行」

- 作業6「Oracle Access Manager 11gの新しいターゲット環境への移行」

- 作業7「Oracle Access Manager 10gの新しいターゲット環境への移行」

- 作業8「Oracle Identity Federationの新しいターゲット環境への移行」

- 作業9「Oracle Adaptive Access Managerの新しいターゲット環境への移行」

- 作業10「Oracle Identity Navigatorの新しいターゲット環境への移行」

- 作業11「監査ポリシーの新しいターゲット環境への移行」

- 作業12「Oracle Web Services Managerの新しいターゲット環境への移行」

作業1   データベース、Middlewareホームおよびドメイン構成の新しいターゲット環境への移行

次の手順を使用して、データベース、すべてのアイデンティティ管理のMiddlewareホームのコピーおよびドメイン構成をターゲット環境に移行します。

1. 第21.3.3項の説明に従って、データベースとスキーマを移行または作成します。

2. 第21.3.4項の説明に従って、copyBinaryおよびpasteBinaryスクリプトを使用して、アイデンティティ管理コンポーネントを含むMiddlewareホームのコピーをソース環境からターゲット環境に移行します。

3. Oracle Access Managerの場合、必要に応じて、作業2「Oracle Access Manager用の前提条件作業の実行」の説明に従って、前提条件作業を実行します。

4. 第21.3.5項の説明に従って、アイデンティティ管理構成を含む各ドメインの構成のコピーを移行します。この手順により、ドメイン、管理サーバーおよび管理対象サーバーを含む構成が移行されます。構成の移行では、次のことも行われます。

- 移行計画で提供された値に基づく、LDAPまたはデータベース・ベース・ストアへのセキュリティ・ストアの再関連付け

- Oracle Identity Federationを構成します。特定の状況で実行する可能性があるオプションの作業の詳細は、作業4「Oracle Identity Federationの既存のターゲット環境への移行」を参照してください。

- Oracle Platform Security Servicesを移行します。ポリシー・ストアと資格証明ストアは、copyConfigおよびpasteConfig操作の一環として移行されます。
Oracle Web Services Managerを使用している場合は、作業11「監査ポリシーの新しいターゲット環境への移行」の説明に従って、監査ポリシーを移行します。

- Oracle Web Services Manager、MDSリポジトリまたはデプロイ・プランに格納されているすべてのポリシー、およびDOMAIN_HOME/libに格納されているすべてのカスタム・ポリシーの移行MDSリポジトリに格納されていないポリシーを移行する場合は、作業12「Oracle Web Services Managerの新しいターゲット環境への移行」を参照してください。

- データソースの構成

- JMSリソースの構成

- 管理サーバーの起動

作業2   Oracle Access Manager用の前提条件作業の実行

Oracle Access Managerコンソールを使用してOracle Access Managerサーバーのポート番号を変更した場合、ポート番号はconfig.xmlで変更されません。この問題を回避するには、次のファイルを編集して、ポート番号を変更します。

DOMAIN_HOME/config/config.xml

作業3 Oracle Internet Directoryの新しいターゲット環境への移行

Oracle Internet Directoryを新しいターゲット環境に移行する手順を次のとおりです。

1. 第21.3.6項の説明に従い、Oracleインスタンスの構成を移行することによってOracle Internet Directory構成を移行します。
次の点に注意してください。

- Oracle Internet Directoryコンポーネントを、ソース・コンポーネントと同じデータベース資格証明を使用してコピーする場合は、OIDスキーマでの競合を避けるために、ターゲットOIDコンポーネントの名前をソース・コンポーネントとは異なるものにする必要があります。

- Oracle Internet Directoryコンポーネントを、ソース・コンポーネントとは異なるデータベース資格証明を使用してコピーする場合は、ターゲットOracle Internet Directoryコンポーネントの名前をソース・コンポーネントと同じものにする必要があります。

2. 特定の条件下で、copyConfigおよびpasteConfigスクリプトを実行すると、次のようなエラーが発生する場合があります。

OID Cloning: Error cleaning replication agreements
OID Cloning: Error deleting replication dn
OID Cloning: Error updating orclreplicaid

このようなエラーが表示された場合は、次の手順を実行します。

1. 次のコマンドを実行します。

ORACLE_HOME/ldap/bin/remtool -pcleanup

プロンプトが表示されたら、Oracle Internet Directoryホスト、非SSLポートおよびODSスキーマ・パスワードを入力します。

2. ルートDNでldapsearchを実行し、orclreplicaid値を検索します。次のコマンドを使用します。

ORACLE_HOME/bin/ldapsearch -p port -h host
-b "" -s base "(objectclass=*)" orclreplicaid

3. ステップbで取得した値を使用して、ldapdeleteを実行し、Oracle Internet Directoryから次のDNを削除します。

cn=replication dn, orclreplicaid=<replicaid>, cn=replication configuration
orclreplicaid=<replicaid>, cn=replication configuration

次に例を示します。

ldapdelete -p port -h host "cn=replication dn,
orclreplicaid=replicaid, cn=replication configuration"

4. ルート・エントリのorclreplicaidの値を0に設定します。次に例を示します。

ORACLE_HOME/bin/ldapmodify -p port -h host -f file.ldif

ldifファイルには次の内容が含まれます。

dn:
changetype: modify
replace: orclreplicaid
orclreplicaid: 0

5. Oracle Internet Directoryを再起動します。

3. ソース環境でOracle Internet Directoryのレプリケーションを構成済の場合、移行後にターゲット環境で再構成する必要があります。レプリケーションの構成は、ソース環境からターゲット環境に移行されません。Oracle Fusion Middleware Oracle Internet Directory管理者ガイドのレプリケーションの設定に関する項を参照してください。

作業4 Oracle Virtual Directoryの新しいターゲット環境への移行

Oracle Virtual Directoryを新しいターゲット環境に移行する手順は次のとおりです。

1. 第21.3.6項の説明に従い、Oracleインスタンスの構成を移行することによってOracle Virtual Directory構成を移行します。
Oracle Virtual Directoryを含むOracleインスタンスをすでに移行している場合は、この手順を実行する必要がありません。

pasteConfigの操作で、Oracle Virtual Directoryアダプタのパスワード・ファイルを指定しなかった場合や、移動計画のパスワード・ファイルの場所を間違えて指定した場合には、アダプタ構成は変更されず、スクリプトによって次のメッセージが返されます。

Password file is either not provided or invalid for adapter adapter_name. Nothing will be changed for this adapter configuration.

作業5 Oracle Directory Integration Platformの新しいターゲット環境への移行

Oracle Directory Integration Platformを新しいターゲット環境に移行する手順は次のとおりです。

1. 作業3の説明に従って、Oracle Internet Directoryを移行します。
Oracle Directory Integration Platformのプロファイルは、Oracle Internet Directoryにあります。Oracle Internet Directoryを正しくターゲット環境に移行した場合、プロファイルはターゲット環境に引き継がれます。

2. ソース環境でSSLを構成した場合、この構成はターゲット環境には移行されません。ターゲット環境でSSLを構成する必要があります。第6.5.4.3項を参照してください。

作業6 Oracle Access Manager 11gの新しいターゲット環境への移行

ドメインの構成を移行する際、表20-33の移動計画プロパティを更新し、ターゲット環境の値を使用します。ただし、次のことに注意してください。

- 本番のホストとポートを移動計画で指定できますが、手動でパートナを再登録する必要があります。

- Webゲートについては、スクリプトによりobAccessclient.xmlファイルが生成されますが、このファイルを次の場所にあるエージェントに手動でコピーする必要があります。

WebGate_instance_dir/webgate/config

- mod_ossoの場合、Oracle HTTP ServerがインストールされているMiddlewareホームの次の場所にosso.confファイルをコピーする必要があります。

MW_HOME/instances/instance1/config/OHS/ohs1/osso/

- Oracle Access ManagerがOracle Adaptive Access Managerに統合されている場合、手動でパートナ・キーを再生成する必要があります。

- Oracle Access ManagerがOracle Identity Federationに統合されている場合、手動でパートナ・キーを再生成する必要があります。

- Oracle Access ManagerがOracle Adaptive Access Managerに統合されている場合、Oracle Access Manager構成において認証スキームのchallengeURLを更新します。Oracle Fusion Middleware Oracle Access ManagerおよびOracle Security Token Service管理者ガイドの認証スキームの表示または編集に関する項を参照してください。

- パスワード(CSF内)とサーバー・キーはソースとターゲットで同じままになります。Oracle Access Managerで、ターゲットのサーバー・キーをソースとは別にする必要がある場合、ドメイン構成を移行した後で再生成する必要があります。

ドメインの構成を移行すると、Oracle Access Manager構成がターゲット環境に移行されます。

作業7 Oracle Access Manager 10gの新しいターゲット環境への移行

Oracle Access Manager 10gを新しいターゲット環境に移行する手順は次のとおりです。

1. ディレクトリ・サーバーをソース環境からターゲット環境に移行します。つまり、o=oblixノードを移行します。『Oracle Access Managerインストレーション・ガイド』の新しいディレクトリ・サーバー・インスタンスの準備に関する項を参照してください。

2. アイデンティティ・サーバー、ポリシー・マネージャおよびアクセス・サーバーと関連付けられているエンティティを削除します。該当のエンティティは、次のコマンドの下にあります。

obcontainerId=DBAgents,<Configuration DN>

コンテナ(obcontainerId=DBAgents)は削除しないでください。

3. 『Oracle Access Managerインストレーション・ガイド』の情報を参照し、Oracle Access Managerをインストールおよび設定して、ターゲット環境にLDAP情報を指定します。
Oracle Access Managerは、ポリシーおよび構成データをLDAPディレクトリに格納します。LDAPディレクトリが正しく構成されている場合(たとえば、Oracle Internet Directoryをソース環境からターゲット環境に正しく移行済の場合)、Oracle Access Managerは、ポリシーおよび構成データをLDAPディレクトリから継承します。

4. ターゲット環境で、新しい識別子を使用してアイデンティティ・サーバーおよびWebパスをインストールします。詳細は、次を参照してください。

- 『Oracle Access Managerインストレーション・ガイド』のアイデンティティ・サーバーのインストールに関する項

- 『Oracle Access Managerインストレーション・ガイド』のWebパスのインストールに関する項

インストール後、次の手順に従います。

1. サーバーを起動します。

2. アイデンティティ・システム・ブラウザの設定を完了します。『Oracle Access Managerインストレーション・ガイド』のアイデンティティ・システムの設定に関する項を参照してください。

5. Oracle Access Managerインストレーション・ガイドのポリシー・マネージャのインストールに関する項の説明に従って、ポリシー・マネージャをインストールします。ただし、ディレクトリ・サーバーを移行したときにすでにスキーマを更新しているので、スキーマは更新しないでください。認証スキームはすでにディレクトリ・サーバーに存在しているため、これを構成しないでください。

注意:

ターゲットのポリシー・マネージャを設定した後、Oracle Access Managerの管理者としてログインすると、次のエラーが発生する場合があります。

There was a problem obtaining the user ID. One possible reason for this is a time difference between the Identity System and Access Systems (Policy Manager and Access System Console).

これを修正するには、LDAPからo=oblixノードの下のcookie暗号化鍵を削除し(CPResponseEncryptionKeyは変更しない)、アイデンティティ・サーバーを再起動します。削除する前に、cookie暗号化エントリのバックアップをldifファイルに作成する必要があることに注意してください。

6. アクセス・システム・コンソールからブラウザ設定を完了し、新しい識別子を使用してアクセス・サーバーを追加します。詳細は、『Oracle Access Managerインストレーション・ガイド』のシステム・コンソールでのアクセス・サーバー・インスタンスの作成に関する項を参照してください。
また、その他の情報は、『Oracle Access Managerインストレーション・ガイド』のアクセス・サーバーとインストールに関する項を参照してください。

7. このシナリオでは、ターゲットのWebゲート用に既存のWebゲート識別子を再使用します。次の手順を実行します。

1. アクセス・システム・コンソールに移動し、「アクセス・システム構成」タブを選択します。

2. 「ホスト識別子」を選択します。「すべてのホスト識別子をリスト」ページで、ソース環境が使用するホスト識別子を選択します。

3. 「変更」をクリックします。次に、ターゲットのWebサーバー用のホスト名およびポートを「ホスト名のバリエーション」フィールドに追加します。

注意:

複数のホスト識別子に同じホストおよびポートがあると、リソースが保護されなくなる場合があります。

ポリシー・ドメインで使用されるホスト識別子のみがその定義のhost:portを持つようにしてください。その他のホスト識別子からhost:portを削除します。

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

5. 「アクセス・システム構成」タブから「アクセス・ゲート構成」を選択します。次に、関連するアクセス・ゲートを選択します。

6. 「アクセス・ゲートの詳細」ページで「変更します。」を選択します。

7. 「ホスト名」および「ポート」を変更し、ターゲットのWebサーバーのホスト名およびポートを指定します。

8. 優先HTTPホストを変更し、ステップcで追加したホスト名のバリエーションを指定します。

9. 『Oracle Access Managerアクセス管理ガイド』のアクセス・サーバーへのアクセス・ゲートとWebゲートの関連付けに関する説明に従って、Webゲートを新しく追加したターゲットのアクセス・サーバーに関連付けます。

10. Webゲートを一時的に無効にします。アクセス・システム・コンソールから「アクセス・システム構成」タブを選択し、「アクセス・ゲート構成」を選択します。「実行」をクリックして、検索します。検索結果から、「アクセス・ゲート」を選択します。次に、「変更します。」を選択します。「無効」をクリックします。次に、「保存」をクリックします。
アクセス・サーバーをインストールした後、それを有効にします。

8. Webゲート作成中に使用した新しい識別子を使用して、アクセス・サーバーをインストールします。『Oracle Access Managerインストレーション・ガイド』のアクセス・サーバーのインストールに関する項を参照してください。

9. 新しいWebゲートをインストールします。『Oracle Access Managerインストレーション・ガイド』のWebゲートのインストールに関する項を参照してください。

10. エントリを確認し、ソース環境に関連するエントリを削除します。

1. アイデンティティ・システム・コンソールから「システム構成」タブを選択し、「ディレクトリ・プロファイル」を選択します。それぞれのディレクトリ・プロファイルが新しいアイデンティティ・サーバー、アクセス・サーバーおよびポリシー・マネージャに関連付けられていることを確認します。

2. アイデンティティ・システム・コンソールから「システム構成」タブを選択し、「Webパス」を選択して、ソースのWebパスのエントリを削除します。

3. アイデンティティ・システム・コンソールから「システム構成」タブを選択し、「アイデンティティ・サーバー」を選択して、ソースのアイデンティティ・サーバーのエントリを削除します。

4. アクセス・システム・コンソールから「アクセス・システム構成」タブを選択し、「アクセス・サーバー構成」を選択します。ソース環境のアクセス・サーバーのエントリを削除します。

11. アイデンティティ・システム・コンソールから「システム構成」タブを選択し、「パスワード・ポリシー」を選択します。ホストおよびポートが「パスワード変更のリダイレクトURL」に設定されている場合は、新しいアイデンティティ・サーバーを指すように変更します。

12. アクセス・システム・コンソールから「アクセス・システム構成」タブを選択し、「認証管理」を選択します。チャレンジ・リダイレクトが設定されている認証スキームを選択します。新しい認証Webゲートがインストールされている場合は、新しいWebサーバーのホストおよびポートを指定するように「チャレンジ・リダイレクト」を変更します。

13. アクセス・システム・コンソールから「アクセス・システム構成」タブを選択し、「認証管理」を選択します。パスワード・ポリシーが構成されている認証スキームを選択します。WebパスとWebゲートが異なるWebサーバーにある場合、WebパスがインストールされているターゲットのWebサーバーの新しいホストおよびポートに適応するようにobWebPassURLprefix(ある場合)を変更します。
詳細は、『Oracle Access Manager IDおよび共通管理ガイド』のパスワード・ポリシーの構成に関する項を参照してください。

作業8 Oracle Identity Federationの新しいターゲット環境への移行

作業1のステップ4で説明されているcopyConfigおよびpasteConfigスクリプトを使用し、表20-24で説明されているとおりに移動計画を変更した場合、次の項目がターゲット環境の値で構成されます。

- ロード・バランサのホストとポートおよびSOAPポート

- サービス・プロバイダID URL

- アイデンティティ・プロバイダID URL

- データ・ストア

- 認証エンジン

- サービス・プロバイダ統合モジュール

Oracle Identity Federationの移行を完了する手順は次のとおりです。

1. 管理対象サーバーを起動します。

2. Fusion Middleware Controlを使用している際、Oracle Identity Federationが実際に実行されているにもかかわらず実行されていないことを示すメッセージを受信した場合、監視ユーザー名を更新して、Fusion Middleware Controlを使用した構成変更を可能にする必要があります。

1. 第I.3.1.3項で説明されているように、「エージェントの監視中のターゲット」構成ページに移動します。

2. Oracle Identity Federationアイコンを選択します。

3. 「構成」ページで、「WebLogic監視ユーザー名」と「WebLogic監視パスワード」を更新します。

3. 古い信頼できるパートナを削除します。

1. Fusion Middleware Controlで、Oracle Identity Federationインスタンスに移動します。

2. 「管理」→「フェデレーション」を選択します。

3. プロバイダを選択して、「削除」をクリックします。

4. 『Oracle Fusion Middleware Oracle Access Manager統合ガイド』のプロバイダ・メタデータの生成に関する項とプロバイダの登録に関する項の説明に従って、メタデータを再生成しプロバイダを再登録します。

5. オプションでサーバー・キーを再生成します。キーを再生成する方法の詳細は、Oracle Fusion Middleware Oracle Identity Federation管理者ガイドを参照してください。

ほとんどの場合、追加の手順の必要はありません。「セキュリティおよび信頼」または「認証メカニズム」を変更する必要がある場合は、次の手順を実行します。

1. パートナを変更または追加する必要がある場合は、Oracle Fusion Middleware Oracle Identity Federation管理者ガイドの信頼できるプロバイダの追加に関する項および信頼できるプロバイダの削除に関する項を参照してください。

2. HTTP Basic認証を変更する必要がある場合は、ユーザー名とパスワードを更新します。

1. Fusion Middleware Controlで、OIFページのターゲット・メニューから、「管理」→「フェデレーション」を選択します。

2. 任意の信頼できるプロバイダを選択して、「編集」をクリックします。HTTP認証ユーザー名およびHTTP認証パスワードを更新します。続いて、パスワードを確認します。

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

3. 第4.2.3項の説明に従って、管理対象サーバーを起動します。

作業9 Oracle Adaptive Access Managerの新しいターゲット環境への移行

ドメインの構成を移行する際、表20-34の移動計画プロパティを更新し、ターゲット環境の値を使用します。

1. Oracle Adaptive Access ManagerがOracle Access Managerに統合されている場合、Oracle Adaptive Access Managerの構成を移行した後、リダイレクトURLを更新します。

1. Oracle Access Managerコンソールにログインします。

https://hostname.com:7001/oamconsole

2. 「ポリシー構成」タブで、「認証スキーム」を選択します。

3. チャレンジ・リダイレクトURLをターゲット・システムの値に変更します。

2. 資格証明ストア・フレームワークにあるパスワードは、ソース環境と同様にターゲット環境と同じままになります。パスワードをターゲット環境で別にする場合、ターゲット環境で再生成する必要があります。

作業10 Oracle Identity Navigatorの新しいターゲット環境への移行

Oracle Identity Navigatorを新しいターゲット環境に移行する手順は次のとおりです。

1. ターゲット・システムで、Oracle Fusion Middleware Oracle Identity Navigator管理者ガイドのニュース・フィードにアクセスするためのプロキシの構成に関する説明に従って、プロキシを構成します。

作業11    監査ポリシーの新しいターゲット環境への移行

監査ポリシーを新しいターゲット環境に移行するには、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』の次の項目を参照してください。

- 「監査ポリシーの移行」

- 「監査ポリシーの管理」

作業12   Oracle Web Services Managerの新しいターゲット環境への移行

Oracle Web Services Managerを新しいターゲット環境に移行する手順は次のとおりです。

1. 『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』の監査ポリシーの移行に関する項の説明に従って、監査ポリシーを移行します。

2. MDSリポジトリに格納されていないポリシーを移行します。ADF BCおよびOracle WebCenter Portalのポリシー添付ファイルの場合は、『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』の環境間でのアプリケーション移行の管理に関する説明に従ってそれらを移行します。
その他のポリシー添付ファイルは、Oracle WebLogic Serverのクローニング機能を使用している場合、アプリケーションとともに移行されます。

関連項目:

『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のポリシーの水平移行の管理に関する項

21.4.1.2 アイデンティティ管理の既存のターゲット環境への移行

この手順では、アイデンティティ管理コンポーネント(Oracle Internet Directory、Oracle Directory Integration Platform、Oracle Web Services Managerなど)がソース環境にインストール済で、これらをすでに存在しているターゲット環境に移行する必要があると想定します。

既存のターゲット環境では、コンポーネントをインストールおよび構成済です。アプリケーションを、セキュリティ関連の構成を保持したままソース環境からターゲット環境に移行する必要があります。この作業では、アプリケーション固有のデータをソースのアイデンティティ管理環境からターゲットのアイデンティティ管理環境に移行する必要があります。

アイデンティティ管理を既存のターゲット環境に移行するには、次の作業を実行します。

- 作業1「Oracle Internet Directoryの既存のターゲット環境への移行」

- 作業2「Oracle Access Manager 11gの既存のターゲット環境への移行」

- 作業3「Oracle Access Manager 10gの既存のターゲット環境への移行」

- 作業4「Oracle Identity Federationの既存のターゲット環境への移行」

- 作業5「Oracle Adaptive Access Managerの既存のターゲット環境への移行」

- 作業6「Oracle Identity Navigatorの既存のターゲット環境への移行」

- 作業7「Oracle Platform Securityの既存のターゲット環境への移行」

- 作業8「Oracle Web Services Managerの既存のターゲット環境への移行」

作業1   Oracle Internet Directoryの既存のターゲット環境への移行

Oracle Internet Directoryを既存のターゲット環境に移行する手順は次のとおりです。

1. ソース環境でユーザーおよびグループを使用するように、Oracle Platform Securityを構成済の場合があります。ソース環境からユーザーおよびグループを移行するには、次の手順に従います。

1. ソースのOracleホームから次のコマンドを実行して、ソースのOracle Internet Directoryインスタンスのデフォルト・サブスクライバを特定します。

ORACLE_HOME/bin/ldapsearch -h test_oid_host -p test_oid_port
-D "cn=orcladmin" -w "test_orcladmin_passwd"
-b "cn=Common,cn=Products,cn=OracleContext"
-s base "objectclass=*"  orcldefaultsubscriber

この問合せを実行すると、属性orcldefaultSubscriberの値が返されます。この値は、次の手順でdefault_subscriberとして使用されます。

2. ソースのOracleホームから次のコマンドを実行して、ソースのOracle Internet Directoryインスタンスのユーザーを取得します。

ORACLE_HOME/bin/ldapsearch -h test_oid_host -p test_oid_port
-D "cn=orcladmin" -w "test_orcladmin_passwd"
-L -b "cn=users, default_subscriber"
-s sub "objectclass=*" * orclguid > ldif_filename

3. ターゲットのOracleホームから次のコマンドを実行して、ターゲットのOracle Internet Directoryインスタンスにユーザーを移行します。

ORACLE_HOME/bin/ldapaddmt -h production_oid_host
-p production_oid_port -D "cn=orcladmin"
-w "production_orcladmin_passwd" -r -f ldif_filename

-r引数を指定して、データを移行し、競合を解決します。ldif_filenameは、前の手順で取得したファイルです。

2. ソース環境がステージング環境に設定されていてターゲット環境を模倣している場合、ターゲットのOracle Internet DirectoryからソースのOracle Internet Directoryへの一方向レプリケーションを設定して、ターゲット環境に存在しているすべてのユーザーおよびグループが、アプリケーションのテストに使用できるファンアウト・レプリカで使用できるようにすることをお薦めします。ファンアウト・レプリケーションは、ターゲットと同期するソースのOracle Internet Directoryを保持し、リアルタイムでターゲットに追加されるすべてのユーザーおよびグループをレプリケートする機能も提供します。
ファンアウト・レプリケーションの詳細は、『Oracle Fusion Middleware Oracle Internet Directory管理者ガイド』の次の項を参照してください。

- Oracle Internet Directoryレプリケーションの概要に関する項

- Fusion Middleware Controlのレプリケーション・ウィザードを使用した一方向、双方向、またはマルチマスターのLDAPベース・レプリケーション承諾の設定に関する項

3. Oracle Forms ServicesまたはOracle Reportsを使用している場合、リソース・アクセス記述子(RAD)を移行します。この手順は、ステップ1の説明に従って、デフォルト・サブスクライバをソース環境からターゲット環境に移行済であることを想定しています。また、ソースのOracle Internet DirectoryのユーザーのorclGUIDがターゲットのOracle Internet Directoryと同じであることも想定しています。

次の手順を実行します。

1. ステップ1aの説明に従って、デフォルト・サブスクライバを特定します。

2. 次のコマンドを使用して、ソースのOracle Internet DirectoryインスタンスからRADを取得します。

ORACLE_HOME/bin/ldapsearch -h test_oid_host -w test_orcladmin_passwd
-p test_oid_port -D "cn=orcladmin"
-L -b "cn=Extended Properties,cn=OracleContext, default_subscriber"
-s sub "objectclass=*" * orclguid > ldif_filename

3. 次のコマンドを使用して、ターゲットのOracle Internet DirectoryインスタンスにRADを移行します。

ORACLE_HOME/bin/ldapaddmt -h production_oid_host
-p production_oid_port -D "cn=orcladmin"
-w "production_orcladmin_passwd" -r -f ldif_filename

-r引数を指定して、データを移行し、競合を解決します。ldif_filenameは、前の手順で取得したファイルです。

このコマンドを実行すると、ファイルadd.logが、このコマンドを実行したディレクトリに生成されることに注意してください。add.logファイルで、RADの移行中に発生したエラーを確認します。エラーがある場合、エラーを修正し、コマンドを再実行してください。

作業2   Oracle Access Manager 11gの既存のターゲット環境への移行

この手順では、ソース環境で行った増分変更をターゲット環境に移行します。

注意:

ソース環境とターゲット環境の両方で管理サーバーを起動する必要があります。

ポリシー構成情報をソース環境からターゲット環境にレプリケートする手順は次のとおりです。

1. 環境変数JAVA_HOMEを設定し、JAVA_HOMEをPATHに追加します。

2. 次のWLSTコマンドを使用して、ソース環境からポリシーをエクスポートします。

exportPolicy(pathTempOAMPolicyFile='path_of_Temp_PolicyFile')

この作業では、WLSTコマンドを次のディレクトリから実行する必要があります。

Identity_Mgmt_ORACLE_HOME/common/bin

たとえば、次のコマンドはファイルoam_policy.xmlを生成します。

exportPolicy(pathTempOAMPolicyFile='/tmp/oam_policy.xml')

3. oam_policy.xmlポリシー・ファイルを編集して、ホストおよびポートのIDをターゲット環境の値に変更します。これらの値は、ファイルの<host-identifiers>セクションに指定されます。

4. ポリシー・ファイルをターゲット環境にコピーします。

5. 次のWLSTコマンドを使用して、ターゲット環境にポリシーをインポートします。

importPolicy(pathTempOAMPolicyFile='path_of_Temp_PolicyFile')

次に例を示します。

importPolicy(pathTempOAMPolicyFile='/tmp/oam_policy.xml')

6. 次のWLSTコマンドを使用して、ソース環境からパートナ情報をエクスポートします。

exportPartners(pathTempOAMPartnerFile='path_of_Temp_PartnerFile')

たとえば、次のコマンドはファイルoam_partner.xmlを生成します。

exportPartners(pathTempOAMPartnerFile='/tmp/oam_partner.xml')

7. パートナ・ファイルをターゲット環境にコピーします。

8. 次のWLSTコマンドを使用して、ターゲット環境にパートナ情報をインポートします。

importPartners(pathTempOAMPartnerFile='path_of_Temp_PartnerFile')

次に例を示します。

importPartners(pathTempOAMPartnerFile='/tmp/oam_partner.xml')

9. ターゲット・システムの次のディレクトリには、移行されたパートナに対して生成されたパートナ・アーティファクトが含まれています。

DOMAIN_HOME/output

必要に応じて、パートナ・アーティファクトObAccessClient.xmlおよびlogout.htmlをパートナのOracle HTTP Serverにコピーし、ターゲット環境の値に更新します。

10. mod_wl_ohs.confファイルを、アプリケーションがデプロイされるWebLogic ServerのURI、ホストおよびポートに更新します。次に例を示します。

WebLogicHost=example.com|WebLogicPort=18357

11. パートナのOracle HTTP Serverを再起動します。

関連項目:

Oracle Fusion Middleware Oracle Access ManagerおよびOracle Security Token Service管理者ガイドのデルタ・レプリケーションに関する項

作業3   Oracle Access Manager 10gの既存のターゲット環境への移行

Oracle Access Manager 10gを既存のターゲット環境に移行する手順は次のとおりです。

1. ターゲット環境で、Oracle Access ManagerのOAMCfgToolを使用して、アプリケーションに対して同じポリシー・ドメインを作成します。次のコマンドがターゲット環境の値を指定していることを確認します。

web_domain (The Host identifier is derived from this entry)
protected_uris="uri1,uri2,uri3"
app_agent_password=password to be provisioned for the WebGate
ldap_host=hostname_of_LDAP_server
ldap_port=port_of_LDAP_server
ldap_userdn=DN_of_LDAP_Admin_User
ldap_userpassword=password_of_LDAP_Admin_User
oam_aaa_host=host_of_OAM_server
oam_aaa_port=port_of_OAM_server

uris_fileを使用してファイルにある保護されたURIおよび公開URIを指定している場合、ファイルを確認して正しいURIがリストされていることを確認します。

2. ソース環境のOracle Access Managerのエンティティ(ポリシー・ドメインなど)に対してその他の変更を行った場合、ターゲット環境で同じタイプの変更を行います。

作業4   Oracle Identity Federationの既存のターゲット環境への移行

Oracle Identity Federationを既存のターゲット環境に移行する手順は次のとおりです。

1. 『Oracle Fusion Middleware Oracle Identity Federation管理者ガイド』のWLST環境の設定に関する説明に従って、ソース環境とターゲット環境の両方にWLST環境を設定します。

2. ソース環境で、次のスクリプトを実行して、パートナ・メタデータと構成プロパティを抽出します。

java weblogic.WLST extractPartnerMetadataAndProperties.py providerID
outputFilePrefix

2つのファイル、outputFilePrefix_metadata.xmlとoutputFilePrefix_properties.txtが作成されます。

3. エクスポートしたファイルをターゲット・システムにコピーします。

4. ターゲット環境で、次のスクリプトを実行して、パートナ・メタデータと構成プロパティをインポートします。

java weblogic.WLST setPartnerMetadataAndProperties.py outputFilePrefix_metadata.xml
outputFilePrefix_properties.txt description

5. ソース環境からパートナを削除している場合は、『Oracle Fusion Middleware Oracle Identity Federation管理者ガイド』の信頼できるプロバイダの削除に関する説明に従って、そのパートナをターゲット環境から削除します。

6. この他にも、ターゲット環境にレプリケートする構成のうち、ソース環境で変更しているものがあれば、その変更を行います。詳細は、Oracle Fusion Middleware Oracle Identity Federation管理者ガイドを参照してください。

作業5   Oracle Adaptive Access Managerの既存のターゲット環境への移行

Oracle Adaptive Access Managerを既存のターゲット環境に移行する手順は次のとおりです。

1. ソース環境からスナップショットをエクスポートします。Oracle Adaptive Access Manager管理コンソールを使用して、構成をzipファイルにエクスポートします。詳細は、Oracle Fusion Middleware Oracle Adaptive Access Manager管理者ガイドのシステム・スナップショットのインポート/エクスポートに関する項を参照してください。

次のタイプの項目をエクスポートできます。

- ポリシー

- ルールの条件

- パターン

- 構成可能アクション

- トランザクション定義

- エンティティ

- KBAの質問

- KBAの検証

- ルールで使用されるすべてのグループ・タイプ(アラート・グループ、アクション・グループ、ブラック・リスト・グループ、ホワイト・リスト・グループなど)

2. ターゲット環境にスナップショットをインポートします。Oracle Adaptive Access Manager管理コンソールを使用して、ステップ1で保存したzipファイルの内容をインポートします。詳細は、Oracle Fusion Middleware Oracle Adaptive Access Manager管理者ガイドのシステム・スナップショットのインポート/エクスポートに関する項を参照してください。

3. 次の項目について、必要に応じてターゲット環境を手動で更新します。

1. スナップショットのエクスポートおよびインポートはアクション・グループおよびアラート・グループ・タイプをコピーするだけなので、グループ・メンバーをソース環境からエクスポートし、ターゲット環境にインポートする必要があります。
グループをエクスポートするには、Oracle Fusion Middleware Oracle Adaptive Access Manager管理者ガイドのグループのエクスポートに関する項を参照してください。

グループをターゲット環境にインポートするには、Oracle Fusion Middleware Oracle Adaptive Access Manager管理者ガイドのグループのインポートに関する説明を参照してください。

2. oaam_extensions共有ライブラリを使用して、構成可能アクションのjarをパッケージ化します。

3. ヘッダー、フッター、カスケード・スタイル・シート(CSS)、JavaScriptなどの、OAAMサーバーでカスタマイズされた項目を、ソース環境からターゲット環境に手動でコピーします。これらの項目は、oaam_extensions共有ライブラリにあります。

4. Oracle Adaptive Access Manager管理コンソールを使用して、KBAロジック、OTPロジックおよびポリシー・セットのオーバーライドを手動で再作成します。Oracle Fusion Middleware Oracle Adaptive Access Manager管理者ガイドを参照してください。

5. プロパティ・ファイル、リソース・バンドルおよびエンド・ユーザーJSP画面をソース環境からターゲット環境にコピーします。これらの項目は、oaam_extensions共有ライブラリにあります。

6. ソース環境のVADイメージ(カスタムjar)をターゲット環境にコピーします。

7. プロパティ・ファイル、リソース・バンドル、VADイメージおよびエンド・ユーザーJSP画面をソース環境からターゲット環境にコピーします。

作業6 Oracle Identity Navigatorの既存のターゲット環境への移行

Oracle Identity Navigatorを既存のターゲット環境に移行する手順は次のとおりです。

1. テスト環境で、WLSTコマンドexportMetadataを使用して、Oracle Identity Navigatorのメタデータをテスト環境からエクスポートします。

connect('username','password',JNDI-URL')
exportMetadata(application='oinav', server='server_name',
toLocation='directory'

JNDI URLの形式は、t3://admin_server_host:admin_server_portです。

2. 本番環境で、WLSTコマンドimportMetadataを使用して、Oracle Identity Navigatorのメタデータを本番環境にインポートします。

connect('username','password',JNDI-URL')
importMetadata(application='oinav', server='server_name',
fromLocation='directory'

3. 第4.2項の説明に従って、管理サーバーおよび管理対象サーバーを再起動します。

アイデンティティ・ストアおよびポリシー・ストアをすでに構成している場合は、それらを構成する必要はありません。

作業7 Oracle Platform Securityの既存のターゲット環境への移行

ポリシー・ストア、資格証明ストア、ユーザーおよびグループを変更しており、これらをソース環境から既存のターゲット環境に移行する場合:

1. ソース環境のポリシー・ストアがファイルベースではない場合、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』のコマンドmigrateSecurityStoreを使用したポリシーの移行に関する説明に従って、WLSTコマンドmigrateSecurityStoreを使用してポリシー・ストアを移行します。

2. ソース環境の資格証明ストアがファイルベースではない場合、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』の手動での資格証明の移行に関する説明に従って、スクリプトmigrateSecurityStoreを使用して資格証明ストアを移行します。

3. ターゲットのLDAPにあるユーザーおよびグループは、LDAPにあるユーザーおよびグループと異なる場合があります。Oracle Platform SecurityアプリケーションのロールとLDAPのロールの間にマッピングがあります。アプリケーションのロールは同じままの場合がありますが、LDAPグループへのマッピングは、ターゲット環境の対応するLDAPグループに対してマップするように変更される可能性があります。『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』のアプリケーション・ロールの管理に関する項を参照してください。

4. Oracle Web Services Managerを使用している場合は、『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』の監査ポリシーの移行に関する項の説明に従って、監査ポリシーを移行します。

作業8 Oracle Web Services Managerの既存のターゲット環境への移行

Oracle Web Services Managerを既存のターゲット環境に移行する手順は次のとおりです。

1. MDSリポジトリに格納されているSOAコンポジット・アプリケーション、WebCenter PortalまたはADFアプリケーションのポリシーを移行します。
Fusion Middleware Controlを使用してこれを実行する手順は次のとおりです。

1. ソース環境で、ドメインを選択します。次に、「WebLogicドメイン」メニューで、「Webサービス」→「ポリシー」を選択します。

2. ポリシーを選択し、「ファイルにエクスポート」をクリックします。
ポリシーがソース環境上のファイルにコピーされます。

3. 「ファイルの保存」→「OK」をクリックします。

4. ファイルの保存先のローカル・ディレクトリの場所に移動し、必要に応じてファイル名を更新します。「保存」をクリックします。

5. ファイルをターゲット環境にコピーします。

6. ターゲット環境で、ドメインを選択します。次に、「WebLogicドメイン」メニューで、「Webサービス」→「ポリシー」を選択します。

7. 「ファイルからインポート」をクリックします。ファイルを参照して選択し、「OK」をクリックします。

8. ソース環境で、ドメインを選択します。次に、「WebLogicドメイン」メニューで、「Webサービス」→「ポリシー」を選択します。

9. ページの右上にある「Webサービス・アサーション・テンプレート」をクリックします。

10. 「ファイルにエクスポート」をクリックします。

11. 「ファイルの保存」→「OK」をクリックします。

12. ファイルの保存先のローカル・ディレクトリの場所に移動し、必要に応じてファイル名を更新します。「保存」をクリックします。

13. ターゲット環境で、ドメインを選択します。次に、「WebLogicドメイン」メニューで、「Webサービス」→「ポリシー」を選択します。

14. 「ファイルからインポート」をクリックします。ファイルを参照して選択し、「OK」をクリックします。

15. ページの右上にある「Webサービス・アサーション・テンプレート」をクリックします。

16. 「ファイルからインポート」をクリックします。ファイルを参照して選択し、「OK」をクリックします。

WLSTを使用してポリシーを移行するには:

1. ソース環境から、次のWLSTコマンドを実行します。

exportMetadata(application='wsm-pm',server='server_name',
docs='/assertiontemplates/assert_template_name',
toLocation='/tmp/owsmexport/')
exportMetadata(application='wsm-pm',server='server_name',
docs='/policies/policy_name',toLocation='/tmp/owsmexport/')

2. /tmp/owsmexportディレクトリをソース環境からターゲット環境にコピーします。

3. ターゲット環境で、次のWLSTコマンドを実行します。

importMetadata(application='wsm-pm',server='server_name',
docs='/assertiontemplates/assert_template_name'',
fromLocation='/tmp/owsmexport/')
importMetadata(application='wsm-pm',server='server_name',
docs='/policies/policy_name',fromLocation='/tmp/owsmexport/')

4. カスタムビルド・ポリシーがある場合は、jarファイルをソース環境からターゲット環境にコピーすることで、それらのポリシーを移行します。jarファイルは、次のディレクトリにあります。

DOMAIN_HOME/lib

関連項目:

『Oracle Fusion Middleware Web Servicesセキュリティおよび管理者ガイド』のポリシーの水平移行の管理に関する項

2. Oracle WebLogic Server JAX-WSアプリケーションでは、MDSではなく、wsm-seed-policies.jarに格納されたポリシーが使用されます。次のファイルをソース環境からターゲット環境にコピーすることで、それらのポリシーを移行します。

ORACLE_HOME/modules/oracle.wsm.policies_11.1.1/wsm-seed-policies.jar

Oracle WebLogic Server管理コンソールを使用して、これらのポリシーを移行することもできます。

3. SOA、ADFまたはWebCenter Portalアプリケーションが最初にターゲット環境にデプロイされて以降、このアプリケーションのポリシー添付ファイルが変更されている場合は、これらの添付ファイルを移行します。たとえば、ポリシーAは当初、BASIC 128アルゴリズムを使用してソース環境で構成され、HelloWorldアプリケーションに添付されたとします。アプリケーションはターゲット環境にデプロイされています。続いて、ソース環境で、Basic 129アルゴリズムを使用するようにポリシーAを変更しました。

4. JAX-WSのアプリケーションが最初にデプロイされて以降、このアプリケーションのポリシー添付ファイルが変更されている場合は、これらの添付ファイルを移行します。

21.4.2 Oracle SOA Suiteのターゲット環境への移行

次の各項目では、Oracle SOA Suiteをソース環境からターゲット環境に移行する方法について説明します。

- Oracle SOA Suiteの新しいターゲット環境への移行

- Oracle SOA Suiteの既存のターゲット環境への移行

いずれの場合も、ソース環境で次の操作を実行済です。

- Oracle WebLogic Serverをインストールし、Middlewareホームを作成しました。

- RCUを使用してソース環境で必要なスキーマを作成しました。『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

- Oracle SOA Suiteをインストールしました。

- 構成ウィザードを使用してOracle SOA Suiteを構成しました。

- 環境で必要な場合は、Oracle Internet Directory、Oracle Platform Security、Oracle Web Services Managerなどのアイデンティティ管理コンポーネントをインストールして構成しました。

- セキュリティ・ポリシーを構成しました。

- 1つ以上のアプリケーションまたはSOAコンポジット・アプリケーションをデプロイしました。これらのアプリケーションには、内部参照および外部参照があります。

- 構成設定の一部を変更しました。たとえば、MDSの構成ディレクトリまたは別のデータソースのなんらかの設定を変更した可能性があります。

- オプションで、Oracle Business Activity Monitoring用の、Oracle WebLogic Serverに依存する次のようなアーティファクトを構成しました。

- BAMアダプタ

- データベースまたはJMS用のデータソース

- Oracle Business Activity Monitoringユーザー用のアイデンティティ・ストアを構成および移入しました。

- ソース環境で、UMSおよび必要なすべてのサブコンポーネントを設定し、UMSドライバとユーザー・プリファレンスを構成しました。

21.4.2.1 Oracle SOA Suiteの新しいターゲット環境への移行

関連項目:

Oracle SOA Suite用のエンタープライズ・デプロイメントの設定の詳細は、『Oracle Fusion Middleware Oracle SOA Suiteエンタープライズ・デプロイメント・ガイド』

Oracle SOA Suiteを新しいターゲット環境に移行するには、次の作業を実行します。

- 作業1「データベース、Middlewareホームの移行および初期構成の実行」

- 作業2「ディレクトリ構造の作成」

- 作業3「JKS証明書のエクスポート」

- 作業4「ヒューマン・ワークフローの新しいターゲット環境への移行」

- 作業5「B2Bアグリーメントの新しいターゲット環境へのデプロイ」

- 作業6「Oracle Business Activity Monitoringデータの新しいターゲット環境への移行」

- 作業7「Oracle Business Process Managementの新しいターゲット環境への移行」

- 作業8「Oracle User Messaging Serviceの新しいターゲット環境への移行」

- 作業9「Oracle Service Busの新しいターゲット環境への移行」

作業1   データベース、Middlewareホームの移行および初期構成の実行

データベースおよびMiddlewareホームを移行して初期構成を実行するには:

1. 第21.3.3項の説明に従って、データベースとスキーマを移行または作成します。
Oracle Service Busについては、ソース・データベースはOracle Service Busによりサポートされているいずれのデータベースでもかまいません。ただし、ターゲット・データベースはRCUによりサポートされているデータベースである必要があります。

2. 第21.4.1項の説明に従って、アイデンティティ管理コンポーネントを移行します。

3. 第21.3.4項の説明に従って、Middlewareホームとバイナリ・ファイルを移行します。

4. SOAクラスタ移行がデータベースのデータソースとして定義されていると、『Oracle Fusion Middleware Oracle SOA Suiteエンタープライズ・デプロイメント・ガイド』のサーバー移行リース表用のユーザーと表領域の設定に関する項に従って、リース・スキーマを作成する必要があります。

5. Oracle User Messaging Serviceについては、テスト環境内にリモート・サーバーがあり、共有ディスクを使用していない場合は、Oracle User Messaging Service構成を含む各リモート・サーバー上で次の手順を実行します。

1. 次のコマンドを実行します。

cd DOMAIN_HOME/config/fmwconfig/servers
tar cvf umsconfig_server_name.tar server_name/applications/usermessaging*

2. 管理サーバーを含むホストにtarファイルをコピーします。

3. 管理サーバーを含むホスト上の対応する場所にtarファイルを解凍します。
次のpasteConfig操作時に、これらのディレクトリがターゲット・システム上の管理サーバー・ホストにコピーされます。

6. 第21.3.5項の説明に従って、構成を移行します。

Oracle Service Busについては、次の点に注意してください。

- copyConfigスクリプトの使用時には、キーosb.configuration.passphrase.fileおよびパスフレーズを含むファイルの絶対パスを指定するキー値とともに-additionalParamsオプションを渡す必要があります。次に例を示します。

-additionalParams osb.configuration.passphrase.file=/scratch/passwd/osb_passwd

このオプションを指定しないと、エクスポートされた構成はパスワードで保護されません。

- pasteConfigスクリプトを実行する前に、ターゲット環境の値を変更する場合は、Oracle Fusion Middleware Oracle Service Bus管理者ガイドの「カスタマイズ」の章の説明に従って、Oracle Service Bus構成ファイルを更新します。

- pasteConfigスクリプトの使用時には、デフォルトでデフォルトのJVMオプションが使用されます。Oracle Service Busについては、メモリー不足エラーを防ぐために、他のJVMオプションを渡す必要があります。オプションを渡すには、USER_MEM_ARGS環境変数を使用します。次に例を示します。

export USER_MEM_ARGS="-Xms512m -Xmx1536m -XX:CompileThreshold=8000 -XX:PermSize=512m  -XX:MaxPermSize=512m"

構成を移行すると、pasteConfigスクリプトによって、管理サーバーおよび管理対象サーバーを含むドメインの構成がコピーされます。また、その手順では次のことも行われます。

- SOAコンポジット・アプリケーションの移行

- Oracle Business Activity Monitoringの移行

- Oracle Human Workflowの属性ラベル、フレックス・フィールド・マッピング、承認グループおよび標準ビューの移行

- Oracle B2Bの移行

- Oracle Service Busの移行

- 移行計画で提供された値に基づく、LDAPまたはデータベース・ベース・ストアへのセキュリティ・ストアの再関連付け

- Oracle Platform Securityの移行

- Oracle Web Services Manager、MDSリポジトリまたはデプロイ・プランに格納されているすべてのポリシー、およびDOMAIN_HOME/libに格納されているすべてのカスタム・ポリシーの移行

- ターゲット環境へのアプリケーションのデプロイ

- アダプタ(データベース・アダプタ、AQアダプタ、JMSアダプタなど)の構成。ただし、pasteConfigスクリプトを使用する前に、アダプタのデプロイ・プランを編集する必要があることに注意してください。

- データソースの構成

- JMSリソースの構成

- 管理サーバーの起動

7. 第21.3.7項の説明に従って、ユーザーおよびグループを構成します。

作業2   ディレクトリ構造の作成

関連項目:

Oracle SOA Suite用のエンタープライズ・デプロイメントの設定の詳細は、『Oracle Fusion Middleware Oracle SOA Suiteエンタープライズ・デプロイメント・ガイド』

インバウンド・ファイルまたはアウトバウンド・ファイルのディレクトリ構造を作成します。たとえば、/tmp/inbound_msgディレクトリからインバウンド・ファイルを読み取り、/tmp/outbound_msgディレクトリにアウトバウンド・ファイルを書き込むファイル・アダプタを使用している場合、これらのディレクトリをターゲット環境に作成します。同様に、Oracle B2Bが/tmp/inboundディレクトリからインバウンド・メッセージを読み取り、/tmp/outboundディレクトリにアウトバウンド・メッセージを書き込むリスナー・チャネルを使用している場合、これらのディレクトリを作成します。

作業3   JKS証明書のエクスポート

B2BエンドポイントのすべてのJKS証明書をソース環境からターゲット環境にエクスポートします。その後、ターゲット環境にインポートします。JKS証明書のエクスポートおよびインポートの詳細は、第8.3.3項を参照してください。

作業4   ヒューマン・ワークフローの新しいターゲット環境への移行

ソース環境からターゲット環境にドメインのコピーを移行した場合は、スクリプトにより次のヒューマン・ワークフロー・エンティティが移行されています。

- 属性ラベル

- フレックス・フィールド・マッピング

- 承認グループ

- 標準ビュー

移行スクリプトによってユーザー固有のアーティファクトが移行されない場合は、次の項目も移行されません。

- ユーザー・ビュー

- ユーザー・ルールとグループ・ワークフロー・ルール

通常、ユーザーに固有のデータはターゲット環境とソース環境で同じではありません。ただし、ユーザー・ビューおよびユーザー・ルールをソース環境からターゲット環境に移行する場合は、『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』のヒューマン・ワークフロー・データのテスト環境から本番環境への移行に関する説明を参照してください。

作業5   B2Bアグリーメントの新しいターゲット環境へのデプロイ

移行スクリプトを実行すると、Oracle B2Bがターゲット環境に移行されます。ただし、次の追加の手順を実行する必要があります。

1. 移行スクリプトの実行中にB2Bアグリーメントはデプロイされません。『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のアグリーメントのデプロイに関する項の説明に従って、B2Bアグリーメントをデプロイします。

2. リスニング・チャネルを有効化します。

1. B2Bコンソールにログインし、「管理」タブ→リスニング・チャネルを選択します。

2. リスニング・チャネルを選択します。

3. チャネル属性タブを選択します。次に、チャネルの有効化を選択します。

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

作業6 Oracle Business Activity Monitoringデータの新しいターゲット環境への移行

copyConfigおよびpasteConfigスクリプトは、Oracle Business Activity Monitoringを新しいターゲット環境に移行します。

レポート、アラート、データ定義などのOracle BAMオブジェクトをORACLEBAMデータベース・スキーマから移行する場合は、次の手順を実行します。

1. ソースで、次のコマンドを使用してORACLEBAMデータベース・スキーマをエクスポートします(ORACLE_HOMEは、Oracle DatabaseのOracleホームです)。

ORACLE_HOME/bin/sqlplus "sys/password as sysdba"
create or replace directory directory as 'path';
grant read,write on DIRECTORY directory to oraclebam;
exit;

ORACLE_HOME/bin/expdp userid=oraclebam/bam@connect_id
directory=directory dumpfile=orabam.dmp
schemas=oraclebam logfile=oraclebam_date.log

関連項目:

『Oracle Databaseユーティリティ』のOracleデータ・ポンプの概要に関する説明およびOracleデータ・ポンプに関するその他の章

ソース環境からOracle BAMオブジェクト(レポート、アラート、データ定義など)がエクスポートされます。

2. ターゲットで、次のコマンドを使用して、ソース環境からエクスポートしたORACLEBAMデータベース・スキーマをインポートします(ORACLE_HOMEはOracle DatabaseのOracleホームです)。

ORACLE_HOME/bin/impdp userid=system/password dumpfile=ORACLEBAM.DMP
remap_schema=oraclebam:oraclebam TABLE_EXISTS_ACTION=replace
ORACLE_HOME/bin/sqlplus "sys/password as sysdba"
alter user oraclebam account unlock;
alter user oraclebam identified by bam;

impdpが次のエラーをレポートする場合があることに注意してください。

- ORA-00959: 表領域<source tablespace>は存在しません
このエラーは、インポートする前にインポート・データベースに表領域を作成するか、またはREMAP_TABLESPACESを使用して、表定義で参照される表領域をインポート・データベースの表領域に変更することにより修正できます。

- 11.2.0.2以前のバージョンのOracle Databaseを使用すると、索引統計のリストアで障害が発生する場合があります。この問題は、インポート後に索引統計を再作成することにより回避できます。

作業7 Oracle Business Process Managementの新しいターゲット環境への移行

Oracle Business Process Managementを新しいターゲット環境に移行する手順は次のとおりです。

- 組織単位を作成するには、『Oracle Fusion Middleware Oracle WebLogic Serverインストレーション・スタート・ガイド』のプロセス・ワークスペースでの組織単位の管理に関する説明を参照してください。

- ダッシュボードを移行するには、ant-t2p-workspace.xml移行ツールを使用します。移行ツールは、コマンドラインで実行できるantターゲットとして使用できます。これは、この作業で説明されているとおり、データの移行用の入力パラメータを指定して作成される構成ファイルをコールします。
このスクリプトでは、BPMUserApplicationData表内の、データ型がBAM_WIDGETであるダッシュボード・データがターゲット環境に移行されます。

ソース環境内とターゲット環境内のユーザーは同じではないため、移行ツールでは、ユーザー固有の構成は移行されないことに注意してください。

次のスクリプトを使用します。

ORACLE_HOME/bin/ant-t2p-workspace.xml

コマンドの形式は次のとおりです。

ant -f ant-t2p-workspace.xml
-Dbea.home=BEA_HOME
-Dbpm.home=BPM_HOME
-Dbpm.t2p.migration.config=MIGRATION_CONFIG_FILE

次の手順を実行します。

1. PATH環境変数に、必要なJAVA_HOMEおよびANT_HOME環境変数が含まれており、それらがOracle SOA Suiteインストール内の場所を指していることを確認してください。

2. ダッシュボードをエクスポートします。

1. 構成ファイルを作成してダッシュボードをエクスポートします。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<testToProductionMigrationConfiguration
xmlns="http://xmlns.oracle.com/bpm/t2p/migration/config"
xmlns:ns2="http://xmlns.oracle.com/bpm/common"
override="true" skip="true">
<sourceEndPoint>
<serverEndPoint>
<serverURL>t3://host:port</serverURL>
<adminUserLogin>admin_username</adminUserLogin>
<adminUserPassword>admin_password</adminUserPassword>
<realm>jazn.com</realm>
</serverEndPoint>
</sourceEndPoint>
<targetEndPoint>
<fileEndPoint>
<migrationFile>/tmp/bpm_dashboard.xml</migrationFile>
</fileEndPoint>
</targetEndPoint>
<operation>EXPORT</operation>
<object>DASHBOARD</object>
<objectDetails>
<login>username</login>
<password>password</password>
<identityContext>jazn.com</identityContext>
<userApplicationData>
<ownerId>username/ownerId>
<option>CUSTOMLAYOUT</option>
</userApplicationData>
</objectDetails>
</testToProductionMigrationConfiguration>

構成ファイルでは、次の要素でソース環境用の値を指定する必要があります。

- serverURL: SOAサーバーのURL

- adminUserLogin: 管理者のユーザー名

- adminUserPassword: 管理ユーザーのパスワード

- migrationFile: エクスポート操作によって生成されたファイル

- objectDetails: ログインおよびパスワード要素

- userApplicationData: 所有者ID要素

2. 次のコマンドを使用して、ダッシュボードをエクスポートします。

ant -f ant-t2p-workspace.xml
-Dbea.home=BEA_HOME
-Dbpm.home=BPM_HOME
-Dbpm.t2p.migration.config=Dashboard_MIGRATION_CONFIG_FILE

3. ダッシュボードをインポートします。

1. 構成ファイルを作成してダッシュボードをインポートします。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<testToProductionMigrationConfiguration
xmlns="http://xmlns.oracle.com/bpm/t2p/migration/config"
xmlns:ns2="http://xmlns.oracle.com/bpm/common"
override="true" skip="true">
<sourceEndPoint>
<fileEndPoint>
<migrationFile>/tmp/bpm_dashboard.xml</migrationFile>
</fileEndPoint>
</sourceEndPoint>
<targetEndPoint>
<serverEndPoint>
<serverURL>t3://host:port</serverURL>
<adminUserLogin>admin_username</adminUserLogin>
<adminUserPassword>admin_password</adminUserPassword>
<realm>jazn.com</realm>
</serverEndPoint>
</targetEndPoint>
<operation>IMPORT</operation>
<object>DASHBOARD</object>
<objectDetails>
<login>username</login>
<password>password</password>
<identityContext>jazn.com</identityContext>
<userApplicationData>
<ownerId>username/ownerId>
<option>CUSTOMLAYOUT</option>
</userApplicationData>
</objectDetails>
</testToProductionMigrationConfiguration>

構成ファイルでは、次の要素をターゲット環境用の値で更新する必要があります。

- serverURL: SOAサーバーのURL

- adminUserLogin: 管理者のユーザー名

- adminUserPassword: 管理ユーザーのパスワード
パスワードは、ant-t2p-workspace.xmlツールを初めて実行する際に暗号化されます。

- migrationFile: エクスポート操作によって生成されたファイル

- objectDetails: ログインおよびパスワード要素
パスワードは、ant-t2p-workspace.xmlツールを初めて実行する際に暗号化されます。

- userApplicationData: 所有者ID要素

2. 次のコマンドを使用して、ダッシュボードをインポートします。

ant -f ant-t2p-workspace.xml
-Dbea.home=BEA_HOME
-Dbpm.home=BPM_HOME
-Dbpm.t2p.migration.config=Dashboard_MIGRATION_CONFIG_FILE

作業8   Oracle User Messaging Serviceの新しいターゲット環境への移行

copyConfigおよびpasteConfigスクリプトは、Oracle User Messaging Serviceを新しいターゲット環境に移行します。

ただし、ターゲット環境内にリモート・サーバーがあり、共有ディスクを使用していない場合は、作業1、ステップ5で説明したように、UMSディレクトリを管理サーバー・ホストに移動しています。リモート・サーバーにターゲット環境をリストアするには、次の手順を実行する必要があります。

ただし、ターゲット環境内にリモート・サーバーがあり、共有ディスクを使用していない場合は、作業1、ステップ5で、ソース管理サーバー・ホストに移動したUMSディレクトリを、ここでターゲット管理サーバーから削除する必要があります。このクリーンアップは、リモート・サーバーにインストールするためにドメインをパックした後に行う必要があることに注意してください。

1. Oracle WebLogic Serverのpackとunpackコマンドを使用して、リモートの管理対象サーバーに対するドメイン・ディレクトリを再作成します。詳細は、『Oracle Fusion Middleware PackおよびUnpackコマンドによるテンプレートとドメインの作成』を参照してください。

2. 各リモート・サーバーについて、管理サーバー・ホスト上の次のディレクトリを削除します。

MW_HOME/user_projects/domains/domain_name/config/fmwconfig/servers/server_name/applications/usermessaging*

リモート・サーバーとは、管理サーバーと同じホスト上にはないサーバーです。

作業9 Oracle Service Busの新しいターゲット環境への移行

Oracle Service Busについては、作業1「データベース、Middlewareホームの移行および初期構成の実行」のステップ6で説明したように、特定のオプションを指定している必要があります。次の手順を実行したことを確認します。

Oracle Service Busの新しいターゲット環境への移行を完了する手順は次のとおりです。

1. pasteConfigスクリプトを実行する前にOracle Service Bus構成ファイルで値を変更しなかった場合は、Oracle Fusion Middleware Oracle Service Bus管理者ガイドの「カスタマイズ」の説明に従って、Oracle Service Busコンソールを使用して値を変更できます。

2. 『Oracle Fusion Middleware Oracle SOA Suiteエンタープライズ・デプロイメント・ガイド』のOracle Service Busの結果キャッシュに対するOracle Coherenceの構成に関する項の説明に従って、Oracle Coherenceの構成を更新します。

21.4.2.2 Oracle SOA Suiteの既存のターゲット環境への移行

この手順では、稼働中のターゲット環境があり、アプリケーションまたは構成の変更を、ターゲット環境への適用前にテストする必要があると想定します。ソース環境に、第21.4.2項で説明した環境と同じ環境があるものとします。

Oracle SOA Suiteを既存のターゲット環境に移行する手順は次のとおりです。

- 作業1「Oracle SOA Suiteの変更の既存のターゲット環境への移行」

- 作業2「Oracle B2Bの変更の既存のターゲット環境への移行」

- 作業3「Oracle Business Process Managementの変更の既存のターゲット環境への移行」

- 作業4「Oracle Business Activity Monitoringデータの既存のターゲット環境への移行」

- 作業5「Oracle User Messaging Serviceデータの既存のターゲット環境への移行」

- 作業6「Oracle Service Busの既存のターゲット環境への移行」

作業1   Oracle SOA Suiteの変更の既存のターゲット環境への移行

Oracle SOA Suiteに加えたすべての変更を移行する手順は次のとおりです。

1. ソース環境でユーザーおよびグループを追加した場合は、第21.3.7項の手順に従って、これらをターゲット環境に移行します。

2. コンポジット参照をサポートするソース環境でEJBまたはPlain Old Java Object(POJO)を変更した場合、これらをターゲット環境に移行します。

1. EJBモジュールをデプロイするには、Oracle WebLogic Server管理コンソールのオンライン・ヘルプのEJBモジュールのデプロイに関する項を参照してください。

2. エンタープライズ・アプリケーションをデプロイするには、Oracle WebLogic Server管理コンソールのオンライン・ヘルプのエンタープライズ・アプリケーションの使用に関する項を参照してください。

3. ソース環境でヒューマン・ワークフローに変更を加えた場合は、それらの変更をターゲット環境に移行します。『Oracle Fusion Middleware Oracle SOA SuiteおよびOracle Business Process Management Suite管理者ガイド』のヒューマン・ワークフロー・データのテスト環境から本番環境への移動に関する項を参照してください。

3. 構成プランの情報を変更した場合、これらの変更をターゲット環境にコピーします。構成プランの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の開発、テストおよび本番環境間のSOAコンポジット・アプリケーションの移動に関する項を参照してください。

作業2   Oracle B2Bの変更の既存のターゲット環境への移行

ソース環境でOracle B2Bに変更を加えた場合は、それらの変更をターゲット環境に移行します。

tpanamesパラメータを使用して選択的にアグリーメントをエクスポートする場合、各zipファイルを個別にインポートする必要があることに注意してください。

Oracle B2Bシステムの変更を移行する手順は次のとおりです。

1. Oracle B2Bインタフェースを使用してプロパティを構成することにより、Oracle B2Bシステム構成パラメータを移行します。詳細は、Oracle Fusion Middleware Oracle B2Bに関するユーザーズ・ガイドのB2Bシステム・パラメータの構成に関する説明を参照してください。

2. B2Bアグリーメントおよび取引パートナをターゲット環境に移行します。

1. ソース環境からデータをエクスポートします。次の例では、デプロイされた複数のアクティブなアグリーメントがエクスポートされます。

ant -f ant-b2b-util.xml b2bexport -Dtpanames="Acme_GC_Agreement1,
GC_Acme_Agreement1" -Dactive=true -Dexportfile="/tmp/export.zip"

2. データをターゲット環境にインポートします。次の例では、ファイル/tmp/export.zip内の要素がインポートされます。

ant -f ant-b2b-util.xml b2bimport -Dlocalfile=true
-Dexportfile="/tmp/export.zip"

これらのコマンドの詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のB2Bコマンドライン・ツールに関する項を参照してください。

3. 『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のチャネルの構成に関する説明に従って、ターゲットのロケーションおよび資格証明を使用してB2Bアグリーメントの外部エンドポイントを構成します。

4. Oracle B2B環境がJavaコールアウトを使用して構成されている場合、コールアウト・ライブラリを手動で移行します。『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のコールアウトの管理に関する項を参照してください。

5. 『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のアグリーメントのデプロイに関する項の説明に従って、B2Bアグリーメントをデプロイします。

作業3   Oracle Business Process Managementの変更の既存のターゲット環境への移行

ソース環境でOracle Business Process Managementに変更を加えた場合は、それらの変更をターゲット環境に再作成するか、または移行します。

- 組織単位を作成するには、『Oracle Fusion Middleware Oracle WebLogic Serverインストレーション・スタート・ガイド』のプロセス・ワークスペースでの組織単位の管理に関する説明を参照してください。

- ダッシュボードの移行の詳細は、第21.4.2.1項の作業7「Oracle Business Process Managementの新しいターゲット環境への移行」を参照してください。

作業4   Oracle Business Activity Monitoringデータの既存のターゲット環境への移行

BAMへの変更には次のものがあります(ただし、これらに限定されません)。

- データ・オブジェクト定義

- データ・オブジェクト内の実際のデータ

- レポート定義

- 外部データソース定義

これらはICommandユーティリティを使用してエクスポートできます。icommandを使用してアーティファクトをエクスポートする方法の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のICommandの使用方法に関する項を参照してください。

作業5   Oracle User Messaging Serviceデータの既存のターゲット環境への移行

Oracle User Messaging Serviceデータを移行する手順は次のとおりです。

1. ターゲット環境で必要なUMSドライバを構成します。

注意:

Oracle User Messaging ServiceをLDAPストアに対して構成された既存のターゲット環境に移行する間、Userprefs-UIオプションのみを使用してユーザー・プリファレンスを変更してください。WLSTコマンド(manageUserMessagingPrefs)の使用は、ソース・インスタンスから削除されたアイデンティティ・ストアのデバイス・プリファレンスを正しく移行しない場合があるため、お薦めしません。

1. Fusion Middleware Controlで、ターゲット環境のドライバ情報を使用してUser Messaging Serviceを構成します。

2. WLSTコマンドdeployUserMessagingDriverを使用して、ソース環境と同様に複数のドライバをデプロイします。

注意:

その他のドライバをデプロイする別のオプションを確認するには、wls:/offline>プロンプトでhelp('deployUserMessagingDriver')を実行してください。

3. ターゲット環境で、カスタム作成済のビジネス条件を再作成します。この手順は、ターゲット環境で一連の同じユーザー・プリファレンス・フィルタ設定が使用されるようにし、カスタムのビジネス条件が指定されているフィルタが確実に機能するようにするためには必須です。

4. ターゲット環境を再起動して変更を適用します。

2. ユーザー・メッセージング・プリファレンスをソース環境からターゲット環境に移行します。フィルタを更新したり、既存のフィルタ・セットに追加したりすることはできません。次のいずれかを実行する必要があります。

- ソース環境でフィルタへの変更を行う場合、フィルタ・セット全体を削除し、新しいセットをアップロードします。『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のフィルタの削除に関する項を参照してください。

- ターゲット環境で次のURLを使用して、ソース環境内のユーザー・デバイスおよびフィルタを作成または変更します。

http://host:port/sdpmessaging/userprefs-ui

3. UMSドライバで、サポートされているドライバに対する送受信機能をテストします。

4. http://host:port/sdpmessaging/userprefs-ui URLを呼び出して、ユーザー・メッセージング・プリファレンスが正常にアップロードされるかどうかをテストします。目的のユーザーとしてログインし、メッセージング・チャネルとフィルタがテスト環境におけるものと同じであるかどうかを検証します。または、ユーザー・メッセージング・プリファレンスに基づいて配信されると予想されるメッセージの送受信を行います。

作業6   Oracle Service Busの既存のターゲット環境への移行

Oracle Service Busの既存のターゲット環境への移行の詳細は、Oracle Fusion Middleware Oracle Service Bus管理者ガイドのカスタマイズに関する説明を参照してください。この章では、ドメインによって異なる環境値の変更方法について説明します。環境値とは、多くの場合ドメイン間での構成の移動(テスト環境から運用環境への移行など)に伴って変化する値で、構成データに含まれる特定の事前定義されたフィールドです。

21.4.3 Oracle WebCenter Portalのターゲット環境への移行

次の各項目では、Oracle WebCenter Portalをソース環境からターゲット環境に移行する方法について説明します。

- Oracle WebCenter Portalの新しいターゲット環境への移行

- Oracle WebCenter Portalの既存のターゲット環境への移行

いずれの場合も、ソース環境で次の操作を実行済です。

- Oracle WebLogicサーバーをインストールしました。

- Oracle WebCenter Portalをインストールしました。

- RCUを使用してソース環境で必要なスキーマを作成しました。『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

- Oracle SOA Suiteをインストールして構成しました。

- 構成ウィザードを使用してOracle WebCenter Portalを構成しました。WebCenter Portal製品のドメインおよび管理対象サーバーを作成しました。

- Oracle WebCenter Contentをインストールして構成しました。

- アイデンティティ管理コンポーネント(Oracle Internet Directory、Oracle Identity Federation、Oracle Access Managerなど)をインストールしました。

- LDAPを使用するようにOracle WebCenter Portalを構成し、組込みのLDAPまたはLDAPストアに一部のユーザーおよびグループを作成しました。

- Oracle Platform Security Servicesの必須のポリシーをポリシー・ストアに作成しました。

- 必須のユーザー証明書を資格証明ストアに作成しました。

- WebCenterスペースを使用して1つ以上のスペースを構築することによって、またはJDeveloperを使用してユーザー独自のポータル・アプリケーションを作成およびデプロイすることによって、あるいはこれらの両方によって、WebCenter Portalのアプリケーションを作成しました。

21.4.3.1 Oracle WebCenter Portalの新しいターゲット環境への移行

Oracle WebCenter Portalを新しいターゲット環境に移行するには、次の作業を実行します。

- 作業1「データベース、Middlewareホームの移行および初期構成の実行」

- 作業2「ターゲット環境へのディスカッション・サーバーのデータの移行(オプション)」

- 作業3「Oracle WebCenter Portal: Spacesデータのターゲット環境への移行(オプション)」

- 作業4「スペースに関連するOracle WebCenter Contentのドキュメントおよびフォルダのターゲット環境への移行(オプション)」

作業1   データベース、Middlewareホームの移行および初期構成の実行

使用されていないポートレット・プロデューサがソース環境に含まれる場合、ポートレット・プロデューサ接続の詳細は、関連登録なしで移行され、このためターゲットにおいてこのようなポートレット・プロデューサを手動で登録する必要があることに留意してください。ターゲットにポートレット・プロデューサを登録する際に、ソース接続名を使用しないでください(この手順で移行される接続と競合するため)。

データベースおよびMiddlewareホームを移行して初期構成を実行する手順は次のとおりです。

1. 第21.3.3項の説明に従って、データベースを移行または作成します。

2. 第21.4.1項の説明に従って、アイデンティティ管理コンポーネントを移行します。

3. 第21.3.4項の説明に従って、Middlewareホームとバイナリ・ファイルを移行します。

4. 第21.4.6.1.1項の説明に従って、Oracle HTTP Serverを移行します(Oracle WebCenter Contentの要件)。

5. 第21.3.5項の説明に従って、構成を移行します。
構成を移行すると、pasteConfigスクリプトによって、管理サーバーおよび管理対象サーバーを含むドメインの構成がコピーされます。また、その手順では次のことも行われます。

- Oracle WebLogic Serverにおけるアイデンティティ管理用の認証プロバイダの作成。

- ポリシーおよび資格証明ストアの再関連付け。

- ソース環境からターゲット環境へのWebCenter Portalのアプリケーション・メタデータの移行。

- 管理サーバーの起動

作業2   ターゲット環境へのディスカッション・サーバーのデータの移行(オプション)

WebCenter Portalアプリケーションがディスカッション・サービスを使用している場合、ソース環境のディスカッション・サーバーのデータをターゲット環境に移行します。

1. ORACLE_HOME/bin(UNIX)およびORACLE_HOME\bin(Windows)のディレクトリからOracle Databaseエクスポート・ユーティリティを使用して、ディスカッション・サーバーのデータをエクスポートします(ORACLE_HOMEはOracle DatabaseのOracleホームです)。

expdp "sys/password@connect_id as sysdba"
OWNER=src_prefix_DISCUSSIONS DUMPFILE=dumpFileName.dmp STATISTICS=none
schemas=src_prefix_DISCUSSIONS directory=directory dumpfile=filename

2. ディスカッション・サーバー・データをインポートします。

1. ターゲット・ディスカッション・サーバーを停止します。

2. WebCenter Portalのディスカッション・サーバー・スキーマがインストールされているデータベースのORACLE_HOME/binディレクトリに移動し、sqlplusを使用してsysdbaとしてデータベースに接続します。

ORACLE_HOME/bin/sqlplus "sys/password@serviceid as sysdba"

3. ターゲット・ユーザーを削除して、新しいユーザーを作成します。

drop user trgt_prefix_DISCUSSIONS cascade;
create user trgt_prefix_DISCUSSIONS identified by password
default tablespace trgt_prefix_IAS_DISCUSSIONS temporary
tablespace name_IAS_TEMP;

4. ユーザーにconnectとresource権限を付与します。

grant connect,resource, create view to trgt_prefix_DISCUSSIONS;

5. SQLPlusを終了します。

exit;

6. ORACLE_HOME/bin(UNIX)およびORACLE_HOME\bin(Windows)のディレクトリからOracle Databaseインポート・ユーティリティを使用して、ディスカッション・サーバーのデータをインポートします(ORACLE_HOMEはOracle DatabaseのOracleホームです)。

impdp \"sys/password@serviceid as sysdba\"
remap_schema=src_prefix_DISCUSSIONS:trgt_prefix_DISCUSSIONS
remap_schema=src_prefix_DISCUSSIONS_CRAWLER:trgt_prefix_DISCUSSIONS_CRAWLER
remap_tablespace=source_tablespace:target_tablespace exclude=user
DUMPFILE=dumpFileName STATISTICS=none

作業3   Oracle WebCenter Portal: Spacesデータのターゲット環境への移行(オプション)

スペースのアプリケーション・データ(スペース、スペース・テンプレート、リストについてのサービス関連のデータ、リンク、タグ、ピープル・コネクションなど)をターゲット環境に移行する場合、次の手順に従います。

1. ORACLE_HOME/bin(UNIX)およびORACLE_HOME\bin(Windows)のディレクトリから次のコマンドを使用して、スペースのアプリケーション・データをソース・データベースからエクスポートします(ORACLE_HOMEはOracle DatabaseのOracleホームです)。

sqlplus "sys/password as sysdba"
create or replace directory directory as 'path';
exit;

expdp "sys/password@connect_id as sysdba"
schemas=prefix_WEBCENTER directory=directory dumpfile=filename

2. ステップ1でエクスポートしたファイルを使用して、スペースのアプリケーション・データをターゲット・データベースにインポートします。次のコマンドを実行します(ORACLE_HOMEは、Oracle DatabaseのOracleホームです)。

ORACLE_HOME/bin/sqlplus "sys/password as sysdba"
create or replace directory directory as 'path';
exit;

ORACLE_HOME/bin/impdb "sys/password@connect_id as sysdba"
DIRECTORY=directory dumpfile=filename
TABLE_EXISTS_ACTION=REPLACE

作業4   スペースに関連するOracle WebCenter Contentのドキュメントおよびフォルダのターゲット環境への移行(オプション)

作業3の説明に従ってスペースのアプリケーション・データを移行した場合、あるいはドキュメント・サービスのタスク・フローで以前にアップロードされたドキュメントを、ターゲット環境へ移行しようとする場合、第21.4.4項の説明に従ってOracle WebCenter Contentデータを移行します。

21.4.3.2 Oracle WebCenter Portalの既存のターゲット環境への移行

この手順では、Oracle WebCenter Portalがインストールおよび構成されている、稼働中のターゲット環境があり、アプリケーションまたは構成の変更を、ターゲット環境への適用前にテストする必要があると想定します。

次の手順を実行します。

1. 個々のスペースまたはスペース・テンプレートへの変更を、既存のターゲット環境へ移行するには、次を参照してください。

- 『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』の個々のスペースの移行に関する説明。

- 『Oracle Fusion Middleware Oracle WebCenter Portal管理者ガイド』のスペース・テンプレートの移行に関する説明。

2. WebCenter Portal: フレームワークを使用して構築されたWebCenter Portalのアプリケーションへの変更を、既存のターゲット環境に移入するには、『Oracle Fusion Middleware Oracle WebCenter Portal開発者ガイド』のステージングから本番に移入するためのUsing the Propagation Toolの使用に関する説明を参照してください。

21.4.4 Oracle WebCenter Contentのターゲット環境への移行

次の各項目では、Oracle WebCenter Contentをターゲット環境に移行する方法について説明します。

- Oracle WebCenter Contentの新しいターゲット環境への移行

- Oracle WebCenter Contentの既存のターゲット環境への移行

いずれの場合も、ソース環境で次の操作を実行済です。

- 必要なスキーマに使用するデータベースをインストールしました。

- RCUを使用してソース環境で必要なスキーマを作成しました。『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

- Oracle WebLogic Serverをインストールし、Middlewareホームを作成しました。

- Oracle WebCenter Contentをインストールして構成しました。

- Oracle WebCenter Contentを構成しました。

- Oracle WebCenter Content: Imagingを構成しました。
ImagingがOracle Universal Content Management 10gリポジトリを使用する場合、このリポジトリをImagingに対して手動で構成しました。

- Oracle WebCenter Content: ImagingがワークフローまたはOracle Application Extension Framework(AXF)を使用する場合、Oracle SOA Suiteをインストールして構成しました。

- Oracle WebCenter Content: Recordsを構成しました。

- Imagingのいくつかの定義(接続、アプリケーション、検索、入力など)を定義しました。

- アイデンティティ管理コンポーネント(Oracle Internet Directoryなど)をインストールして構成しました。

21.4.4.1 Oracle WebCenter Contentの新しいターゲット環境への移行

Oracle WebCenter Contentを新しいターゲット環境に移行するには、次の作業を実行します。

- 作業1「データベース、Middlewareホームの移行および初期構成の実行」

- 作業2「Oracle Universal Content Management 10gのフルテキストの構成」

- 作業3「Oracle Information Rights Management設定の変更」

- 作業4「Oracle WebCenter Contentの新しいターゲット環境への移行」

- 作業5「Oracle WebCenter Content: Imagingの新しいターゲット環境への移行」

- 作業6「Oracle WebCenter Content: Recordsの新しいターゲット環境への移行」

- 作業7「Oracle WebCenter Content: Inbound Refineryの新しいターゲット環境への移行」

ターゲット環境では、Oracle WebCenter Contentアプリケーションは、デフォルト構成の一部であるOracle WebLogic Server組込みのLDAPサーバーではなく、外部Lightweight Directory Application Protocol(LDAP)認証プロバイダを使用する必要があることに注意してください。ご使用のアプリケーションのアイデンティティ・ストアを次の外部LDAP認証プロバイダのいずれかと再度関連付けた後、管理対象サーバーの構成を完了し、それから管理対象サーバーをリポジトリに接続して、アプリケーションに最初にログインします。

- Oracle Internet Directory

- Oracle Virtual Directory

- サード・パーティのLDAPサーバー

作業1   データベース、Middlewareホームの移行および初期構成の実行

データベースおよびMiddlewareホームを移行して初期構成を実行する手順は次のとおりです。

1. 第21.3.3項の説明に従って、データベースを移行または作成します。

2. 第21.4.1項の説明に従って、アイデンティティ管理コンポーネントを移行します。
Oracle WebCenter Content: ImagingはOracle Internet Directoryを使用するため、ユーザーおよびグループをターゲット・システムのLDAPアイデンティティ・ストアに移行する必要があります。

3. 第21.3.4項の説明に従って、Middlewareホームとバイナリ・ファイルを移行します。

4. 第21.3.5項の説明に従って、構成を移行します。
次の点に注意してください。

- Oracle WebCenter ContentサーバーまたはOracle WebCenter Content: Recordsの場合、コンポーネントを移行するには次の2つのオプションがあります。

- copy: このオプションは、構成およびデータを含むソース・システム全体をターゲット・システムにコピーします。

- init: このオプションは、ターゲット・システムの新しいContentサーバーまたはRecordsインスタンスを初期化します。

表20-30の説明に従って、移動計画のMoveType configPropertyでcopyまたはinitオプションを指定します。その後、configGroupにリストされているプロパティを変更します。

- 管理サーバーおよびコンポーネント・サーバー(WebCenter Contentサーバー、RecordsサーバーおよびInbound Refineryサーバー)が個別のホストにあり、ドメイン・ホームが共有ディスクにない場合は、次の手順を実行します。

1. copyConfigスクリプトを実行する前に、次のそれぞれに対してソフト・リンクを作成します。

Admin_Server_domain_home/ucm/cs
to
Content_Server_domain_home/ucm/cs

Admin_Server_domain_home/ucm/urm
to
URM_Server_domain_home/ucm/urm

Admin_Server_domain_home/ucm/ibr
to
IBR_Server_domain_home/ucm/ibr

次のファイルのIntradocDirの値をチェックして、パスがマウントされており、管理サーバー・ホストからアクセス可能であることを確認します。

Admin_Server_domain_home/ucm/cs/bin/intradoc.cfg
Admin_Server_domain_home/ucm/urm/bin/intradoc.cfg
Admin_Server_domain_home/ucm/ibr/bin/intradoc.cfg

WebCenter Contentホストが複数ある高可用性設定では、任意のWebCenter Contentホストへのソフト・リンクを作成できます。

2. copyオプションを使用しており、IntradocDirがAdmin_Server_domain_home/ucmディレクトリのサブディレクトリではない場合は、ターゲット・システムで次の手順を実行してからpasteConfigスクリプトを実行します。
IntradocDirを管理サーバー・ホストにマウントします。移動計画を変更して、WebCenter Contentサーバー、RecordsおよびInbound RefineryのIntradocDirのパスを管理サーバー・ホストに指定します。

pasteConfigスクリプトの実行後に、次のファイルを更新して、WebCenter Contentサーバー・ホストのIntradocDirの場所を指定します。

Admin_Server_domain_home/ucm/cs/bin/intradoc.cfg
Admin_Server_domain_home/ucm/urm/bin/intradoc.cfg
Admin_Server_domain_home/ucm/ibr/bin/intradoc.cfg

WebCenter Contentホストが複数ある高可用性設定で、各ホストのファイルを編集します。

- copyオプションを使用すると、pasteConfigスクリプトによって、管理サーバーおよび管理対象サーバーを含むドメインの構成がコピーされます。また、その手順では次のことも行われます。

- Oracle WebCenter Contentおよびそのコンポーネントの変更された設定などの構成のコピー

- Imagingサンプル入力ファイルのコピー(これらがドメイン・ディレクトリにある場合)

- BPEL資格証明のコピー

- Oracle Web Services Managerポリシーの移行

- Oracle Application Extension Framework (AXF)を含む管理対象サーバーのリスニング・アドレスの設定

- 管理サーバーおよび管理対象サーバーの起動

- Oracle WebCenter ContentサーバーおよびOracle WebCenter Content: Recordsの場合、initオプションによって、ソース・システムの次の初期化プロパティがコピーされます。

IDC_Name
IDC_Id
InstanceMenuLabel
InstanceDescription
IntradocServerPort
IdcCommandServerHost
SocketHostAddressSecurityFilter
HttpServerAddress
HttpRelativeWebRoot
UseSSL
MailServer
SysAdminAddress
IsAutoNumber
AutoNumberPrefix
AdditionalRegisteredComponents
AdditionalEnabledComponents

5. 第21.3.7項の説明に従って、ユーザーおよびグループを構成します。

作業2   Oracle Universal Content Management 10gのフルテキストの構成

Oracle Universal Content Management 10gリポジトリを使用している場合は、ソースのOracle Universal Content Management 10gシステムでフルテキストが構成されている場合にターゲットのOracle UCMシステムでフルテキストが適切に構成されていることを確認します。

Oracle Universal Content Management 10gサーバーを使用している場合、これはOracle WebCenter Contentの移行時には構成されないことに注意してください。次のサイトにあるOracle Universal Content Managementページで説明されている手順を使用して、ソース環境にインストールしたときと同様の方法でこれをインストールする必要があります。

http://www.oracle.com/technetwork/middleware/content-management/overview/index.html

作業3   Oracle Information Rights Management設定の変更

Oracle IRMを移行するには、新しいターゲット環境で一部のOracle IRM設定を変更する必要があります。

1. SSLを設定します。Oracle IRMの場合、管理対象サーバーに接続したときに証明書の受入れを求めるプロンプトをOracle IRM Desktopが表示しないようにSSLを有効にする必要があります。使用される証明書は、Oracle IRM Desktopを実行しているコンピュータ上でMicrosoft Internet Explorerによって信頼される必要があります。『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のSSLの構成に関する項の説明に従って、Oracle WebLogic Serverの標準のSSL設定手順を実行します。

2. Oracle IRMの各インストールでは、インストール固有の鍵を使用してキーストアにアクセスする必要があります。解凍されたドメインには、キーストアがある場合があります。キーストアがあり、かつContent Trackerコンポーネントが有効化されていてソース環境で使用されている場合は、このキーストアを削除し、パスワードの詳細をクリアして、新しいキーストアを作成します。

1. キーストア・ファイルを削除します。デフォルトでは、キーストアは次のディレクトリにあります。

DOMAIN_HOME/config/fmwconfig

デフォルトのファイル名はirm.jksです。使用されるテンプレートによっては、別の名前が付けられている場合や、別のタイプが使用されている場合があります。

2. キーストアのパスワードは、資格証明ストアに格納されています。パスワードがテンプレート・ドメインに設定されている場合、次のWLSTコマンドを使用してパスワードをクリアします。

connect('username', 'password', 'localhost:7001')
deleteCred('IRM', 'keystore:keystore_filename')
deleteCred('IRM', 'key:irm.jks:oracle.irm.wrap')

この鍵に対して、テンプレートに保存されているキーストア・ファイル名を使用します。

3. Oracle WebCenter Contentインストレーション・ガイドのOracle IRMのキーストアの構成に関する説明に従って、新しいキーストアを作成します。

3. ターゲット環境でソース環境と同じLDAPストアを使用していない場合は、ソース環境のユーザーをターゲット環境に移行します。Oracle WebCenter Contentインストレーション・ガイドのアイデンティティ・ストアの外部LDAP認証プロバイダとの再関連付けに関する説明を参照してください。

作業4   Oracle WebCenter Contentの新しいターゲット環境への移行

移動計画でinitオプションを選択した場合、実行する必要がある手順はステップ3のみですが、これは、ご使用の環境に外部データベースを使用するフルテキスト検索ソリューションがある場合にのみ実行する必要があります。

移動計画でcopyオプションを選択した場合は、次の手順を実行します。

1. 次のコマンドを使用して、OCSデータベース・スキーマをソース環境からエクスポートします(ORACLE_HOMEはOracle DatabaseのOracleホームです)。

ORACLE_HOME/bin/expdp \"sys/password as sysdba\"
schemas=test_env_schema_name
directory=directory dumpfile=ucm.dmp

ダンプ・ファイルが、ターゲット・データベースがアクセスできる場所にあることを確認します。

2. 次のコマンドを使用して、ソース環境からエクスポートしたOCSデータベース・スキーマをインポートします(ORACLE_HOMEはOracle DatabaseのOracleホームです)。

ORACLE_HOME/bin/impdp \"sys/password as sysdba\"
remap_schema=test_env_schema_name:prod_env_schema_name
directory=directory dumpfile=ucm.dmp
TABLE_EXISTS_ACTION=REPLACE

3. 外部データベースを使用するフルテキスト検索ソリューションがあるシステムの場合は、ターゲット・システムでOracle Secure Enterprise Searchを設定し、WebCenter Content用に構成します。

1. Oracle Secure Enterprise Searchインストレーションおよびアップグレード・ガイドの説明に従って、Oracle Secure Enterprise Searchをインストールします。

2. 移動計画でinitを選択した場合は、Oracle WebCenter Contentの構成後処理ページで、外部全文検索を選択し、データソース名を入力します。Oracle WebCenter Contentシステム管理者ガイドのOracle SESとOracle UCMの構成に関する説明を参照してください。

4. IntradocDir、WeblayoutDir、VaultDirおよびUserProfilesDirディレクトリを、ドメイン構造の外部に存在するように構成した場合は、これらのディレクトリをターゲット環境にコピーします。

5. 第4.2項の説明に従って、管理サーバーおよび管理対象サーバーを再起動します。

作業5   Oracle WebCenter Content: Imagingの新しいターゲット環境への移行

Oracle WebCenter Contentでコピー・モードを使用すると、Imagingデータが移行されます。ただし、SOA内でインスタンスを作成した場合、Oracle SOA Suiteの手順ではこのデータを移行しないため、これらのインスタンスは移行されません。

ワークフローの統合またはOracle Application Extension Framework(AXF)を使用している場合、この手順を始める前に、次の作業が実行されていることを確認してください。

- 第21.4.2.1項の説明に従って、Oracle SOA Suiteをインストールして構成し、このソース環境をターゲット環境に移行しました。

- Oracle WebCenter Contentインストレーション・ガイドの既存のドメインの拡張に関する説明に従って、Imagingを構成し、SOAドメインを拡張しました。

Imagingの新しいターゲット環境への移行を完了する手順は次のとおりです。

1. 管理サーバーおよびImaging管理対象サーバーを起動します。

2. Oracle Application Extension Framework(AXF)の構成データベースを移行します。

1. AXFの一部としてEBSアダプタをインストールしている場合は、次の表をソースEBSデータベース・スキーマからエクスポートし、ターゲット・データベース・スキーマに挿入します。

- AXF_COMMAND_PARAMETERS

- AXF_COMMANDS

- AXF_CONFIGS

- AXF_FND_MAP

- AXF_PROPERTIES

2. 次のコマンドを使用して、ターゲットAXFシステムのソリューション・エンドポイントを指すように、EBSスキーマのAXF_CONFIGS表を変更します。

UPDATE AXF_CONFIGS SET SOLUTIONENDPOINT = 'AXFConnectionURL'

作業6 Oracle WebCenter Content: Recordsの新しいターゲット環境への移行

移動計画でinitオプションを選択した場合は、追加手順を実行する必要がありません。

移動計画でcopyオプションを選択した場合は、次の手順を実行します。

1. 次のコマンドを使用して、Recordsデータベース・スキーマ(prefix_urmserver)をソース環境からエクスポートします(ORACLE_HOMEはOracle DatabaseのOracleホームです)。

ORACLE_HOME/bin/expdp \"sys/password as sysdba\"
schemas=test_env_schema_name
directory=directory dumpfile=urm.dmp

ダンプ・ファイルが、ターゲット・データベースがアクセスできる場所にあることを確認します。

2. 次のコマンドを使用して、ソース環境からエクスポートしたRecordsデータベース・スキーマをインポートします(ORACLE_HOMEはOracle DatabaseのOracleホームです)。

ORACLE_HOME/bin/impdp \"sys/password as sysdba\"
remap_schema=test_env_schema_name:prod_env_schema_name
directory=directory dumpfile=urm.dmp
TABLE_EXISTS_ACTION=REPLACE

3. IntradocDir、WeblayoutDir、VaultDirおよびUserProfilesDirディレクトリを、ドメイン構造の外部に存在するように構成した場合は、これらのディレクトリをターゲット環境にコピーします。

4. 第4.2.3項の説明に従って、管理サーバーおよび管理対象サーバーを再起動します。

作業7 Oracle WebCenter Content: Inbound Refineryの新しいターゲット環境への移行

Oracle WebCenter Content: Inbound Refineryの新しいターゲット環境への移行を完了する手順は次のとおりです。

1. IntradocDir、WeblayoutDir、VaultDirおよびUserProfilesDirディレクトリを、ドメイン構造の外部に存在するように構成した場合は、これらのディレクトリをターゲット環境にコピーします。

2. 特定のタイプのコンテンツを変換するようにサード・パーティ・ソフトウェアを設定した場合は、追加の手順が必要となる場合があります。サード・パーティ・ソフトウェアには、ビデオを変換するFlipFactory、Officeドキュメントのネイティブ変換を実行するMicrosoft Office、PDFファイルを変換するAdobe Distillerなどがあります。このようなソフトウェアをインストールした場合は、次の点に注意してください。

- ソフトウェアは、ターゲット・システムにインストールする必要があります。

- ターゲット・システムでは、サード・パーティ・ソフトウェアおよびフォントを、ソース・システムとまったく同じ絶対パスにインストールすることをお薦めします。これにより、ターゲット・システムの起動時にInbound Refineryが適切に構成されます。

- サード・パーティ・ソフトウェアおよびフォントをまったく同じ絶対パスにインストールしない場合は、ターゲット・システムで、ソース・システムと同じソフトウェアを構成する手動手順を実行する必要があります。

- 構成を完了する前にソフトウェアを必要とするジョブを発行しないでください。発行すると、変換は失敗します。

3. 第4.2.3項の説明に従って、管理対象サーバーを起動します。

21.4.4.2 Oracle WebCenter Contentの既存のターゲット環境への移行

この手順では、Oracle WebCenter Contentコンポーネントがソース環境にインストール済で、これらをすでに存在しているターゲット環境に移行する必要があると想定します。

Oracle WebCenter Contentを既存のターゲット環境に移行するには、次の作業を実行します。

- 作業1「Oracle Information Rights Managementの既存のターゲット環境への移行」

- 作業2「Oracle WebCenter Contentの既存のターゲット環境への移行」

- 作業3「Oracle WebCenter Content: Imagingの既存のターゲット環境への移行」

- 作業4「Oracle WebCenter Content: Recordsの既存のターゲット環境への移行」

作業1   Oracle Information Rights Managementの既存のターゲット環境への移行

概念の証明またはパイロット(ソース)・デプロイメントを実行する組織は、運用サービスをターゲット環境にコピーし、既存のすべてのソース・コンテンツ、コンテキストおよび権限を引き続き使用できます。

IRMサーバーURL(たとえば、protocol_schema:\\hostname:port\irm_desktop)は、ソース・コンテンツにシールされます。このため、この値は、ソースからターゲットへの移行時に変更しないでください。このため、ソース・デプロイメントをインストールする際は、次の点を考慮してください。

- ソース環境のHTTPプロトコルからターゲット環境のHTTPSプロトコルへの切替えによって、ソースでシールされたコンテンツがターゲット環境で処理されなくなるため、ソース・デプロイメントでSSLを構成します。

- マシン固有のホスト名(mytestdeploymachine.example.comなど)ではなく、汎用ホスト名(irm.example.comなど)をソース・デプロイメント用に使用します。

ソースからターゲットへのインストールの完了後に、ドメイン名のDNSエントリがソース・サーバーからターゲット環境に切り替えられることがあります。必要に応じて、ポート・リダイレクションを使用して、ソース・デプロイメントIRMサーバーURLがターゲット環境デプロイメントを指していることを確認できます。

ソース・デプロイメントをターゲット環境に移行する手順は次のとおりです。

1. ターゲット・データベースがソース・データベースと異なる場合は、Oracle IRMスキーマをバックアップする必要があります。バックアップはターゲット・データベースでリストアします。

2. ソース・インストール中にOracle IRMキーストア設定をターゲット環境にコピーします。これは通常、irm.jksと呼ばれます。このファイルは通常、次のディレクトリにあります。

DOMAIN_HOME/config/fmwconfig

3. Oracle IRM Java EEアプリケーションでは、前の手順でコピーしたキーストアのパスワードと、そのキーストアに格納されている各鍵が必要です。パスワードを指定しないと、Oracle IRM Java EEアプリケーションは鍵を取得できません。
ソース環境で使用したパスワードよりもセキュアなパスワードを使用するように切り替えるには、続行する前にkeytoolコマンドラインを使用してパスワードを変更します。構文については、keytoolヘルプを参照してください。

4. セキュアなパスワードを準備し、WLSTコマンドを使用してこのパスワードをOracle IRM Java EEアプリケーションに指定します。次の例では、管理サーバーに接続し、キーストア資格証明を設定します。

connect("username", "password", "t3://adminServerHost:adminServerPort")
createCred("IRM", "keystore:irm.jks", "dummy", "secureproductionpassword")
createCred("IRM", "key:irm.jks:oracle.irm.wrap", "dummy", "secureproductionpassword")

詳細は、『Oracle WebCenter Contentインストレーション・ガイド』のキーストアのパスワードの追加に関する説明を参照してください。

5. 通常次のディレクトリにあるOracle IRM構成ファイル(irm-config.xml)をソース環境からターゲット環境にコピーします。

DOMAIN_HOME/config/fmwconfig

6. ソース環境の構成にはソース固有の設定が含まれている場合があるため、ファイルの内容を確認する必要があります。Fusion Middleware ControlまたはWLSTを使用できます。または、構成ファイルirm-config.xmlを編集することもできます。Fusion Middleware Controlを使用するには、ナビゲーション・ツリーを開き、「IRM」をクリックします。「IRM」メニューで、「管理」→「一般設定」を選択します。次の設定を変更する必要がある場合があります。

- プライバシURL: インストール用のOracle IRM使用状況プライバシ・ポリシーをホストするページへのURL。デフォルト値はありません。したがって、通常、ドメインの解凍後にこの設定を変更する必要はありません。デフォルトでは、組込みのプライバシ・ページが表示されます。

- ステータス・ページのリダイレクト: 代替のOracle IRM Desktopステータス・ページをホストするページへのオプションのURL。デフォルト値はありません。したがって、通常、ドメインの解凍後にこの設定を変更する必要はありません。デフォルトでは、組込みのステータス・ページが使用されます。

- キーストアの場所: パスは、リストアされたソース環境のキーストアの場所を反映する必要があります。次にファイルの場所の例を示します。

DOMAIN_HOME/config/fmwconfig

7. ターゲット環境でソース環境と同じユーザー・ストアを使用していない場合は、ソース環境のユーザーをターゲット環境に移行します。Oracle WebCenter Contentインストレーション・ガイドのアイデンティティ・ストアの外部LDAP認証プロバイダとの再関連付けに関する説明を参照してください。

作業2   Oracle WebCenter Contentの既存のターゲット環境への移行

Oracle WebCenter Contentを既存のターゲット環境に移行する手順は次のとおりです。

1. 移行オプションまたは移行画面の上部のメニューから「構成テンプレート」オプションを選択します。

2. 「アクション」から「新規テンプレートの作成」を選択します。

3. 「サーバーの構成」で、SearchIndexEngineNameを選択します。

4. 「コンテンツ・メタデータ」で、エクスポートするテキスト・フィールドを選択します。

5. 「コンテンツ・プロファイル・ルール」で、エクスポートするルールを選択します。

6. 「個人情報データ」で、エクスポートするプロファイルを選択します。

7. 「アクション」から「保存」を選択します。

8. 「アクション」から「エクスポート」を選択します。

9. 「構成のバンドル」をクリックします。

10. 「構成のバンドル」ページで、データをエクスポートしたときに作成したバンドルを選択します。「アクション」から「ダウンロード」を選択します。

11. UCMでレコード・マネージャを使用しており、ソース環境からターゲット環境への増分移行を実行する場合は、Oracle WebCenter Content Records管理者ガイドのインポートおよびエクスポートの管理に関する説明に従って、ソース環境からアーカイブをエクスポートし、ターゲット環境にインポートします。

作業3   Oracle WebCenter Content: Imagingの既存のターゲット環境への移行

Oracle WebCenter Content: Imagingをソース環境から既存のターゲット環境に移行するには、作業5「Oracle WebCenter Content: Imagingの新しいターゲット環境への移行」の説明と同じ手順を実行します。ただし、ターゲット環境での定義の更新に関して、次の点に注意してください。

- ある定義をソース環境から既存のターゲット環境にインポートした場合、その定義が既存の定義と同じ名前であると、元の定義は上書きされます。インポートする既存の定義には、次のルールが適用されます。

- アプリケーションであるフィールドが削除される場合、既存の検索定義または入力定義が、削除されたフィールドを参照していると、そのフィールドはインポートされません。

- 検索定義または入力定義が、アプリケーションで現在定義されていないフィールドを参照する場合、その定義はインポートされません。

- エクスポート・プロセスおよびインポート・プロセスでは定義を削除できません。ソース環境で検索を削除した場合、検索管理機能を使用して、ターゲット環境で手動でこの検索を削除する必要があります。

- 同じ名前の既存の入力定義があり、かつその入力定義がオンラインの場合、入力定義をインポートできません。その定義をインポートするには、まずそれをオフラインにする必要があります。

1. ターゲット環境で、管理対象入力フォルダを開き、インポートする入力を選択します。

2. 「オンラインで切替」を選択します。

作業4   Oracle WebCenter Content: Recordsの既存のターゲット環境への移行

Recordsを既存のターゲット環境に移行する手順は次のとおりです。

1. ソース環境で、Oracle WebCenter Content Records管理者ガイドのアーカイブのエクスポートに関する説明に従って、変更された構成設定をエクスポートします。

2. アーカイブをターゲット環境にコピーします。

3. Oracle WebCenter Content Records管理者ガイドのアーカイブのインポートに関する説明に従って、アーカイブをターゲット環境にインポートします。

21.4.5 Oracle Hyperion Enterprise Performance Management Systemのターゲット環境への移行

この項では、Oracle Hyperion Enterprise Performance Management Systemコンポーネントをターゲット環境に移行する方法について説明します。

この手順では、ソース環境で次の操作を実行済です。

- 必要なスキーマに使用するデータベースをインストールしました。

- RCUを使用してソース環境で必要なスキーマを作成しました。『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

- Oracle WebLogic Serverをインストールし、Middlewareホームを作成しました。

- Oracle Hyperion Enterprise Performance Managementコンポーネントをインストールして構成しました。

Oracle Hyperion Enterprise Performance Managementをターゲット環境に移行するには、次の作業を実行します。

- 作業1「データベース、Middlewareホームの移行および初期構成の実行」

- 作業2「Oracle Essbaseのターゲット環境への移行」

- 作業3「Oracle Hyperion Calculation Managerのターゲット環境への移行」

- 作業4「Oracle Hyperion Financial Reportingのターゲット環境への移行」

- 作業5「Oracle Hyperion Provider Servicesのターゲット環境への移行」

- 作業6「Oracle Hyperion Smart Viewのターゲット環境への移行」

- 作業7「Oracle EPM Workspaceのターゲット環境への移行」

作業1   データベース、Middlewareホームの移行および初期構成の実行

データベースおよびMiddlewareホームを移行して初期構成を実行する手順は次のとおりです。

1. 第21.3.3項の説明に従って、データベースを移行または作成します。

2. 第21.4.1項の説明に従って、アイデンティティ管理コンポーネントを移行します。

3. 第21.3.4項の説明に従って、Middlewareホームとバイナリ・ファイルを移行します。

4. 第21.3.5項の説明に従って、構成を移行します。

5. 第21.3.7項の説明に従って、ユーザーおよびグループを構成します。

作業2   Oracle Essbaseのターゲット環境への移行

Oracle Essbaseでは、ソース環境からターゲット環境に移行する必要があるのは構成設定のみです。たとえば、ソース環境のessbase.cfgをターゲット環境にコピーします。

ORACLE_INSTANCE/Essbase/essbaseserver1/bin/essbase.cfg

作業3   Oracle Hyperion Calculation Managerのターゲット環境への移行

Oracle Hyperion Calculation Managerをソース環境からターゲット環境に移行するには、次のいずれかを実行します。

- リポジトリのバックアップ
Calculation Managerスキーマは変更されないため、新しいCalculation Manager環境で同じリポジトリを使用できます。事前に存在しているCalculation Managerのオブジェクトおよび関連する情報は、すべて新しい環境で使用できます。

- 割当てルールおよびルール・セットのエクスポート/インポート
Calculation Managerのルールおよびルール・セットをソース環境からエクスポートして(Calculation Managerで、「ファイル」→「エクスポート」を選択)、それらをターゲット環境にインポートします(Calculation Managerで、「ファイル」→「インポート」を選択)。

注意:

- 前述のオプションのいずれか1つ(両方ではない)を使用して、ソース環境からターゲット環境に移行します。使用環境に最適なオプションを使用してください。エクスポート/インポートのほうが簡単ですが、リポジトリをバックアップすると、データベースの詳細な情報が保存されます。

- 事前にFusion GLにデプロイされ、その後、Calculation Managerで変更されているルールは、Calculation Managerでは処理されません(Calculation Managerはルールのバージョンを保持しません)。

作業4   Oracle Hyperion Financial Reportingのターゲット環境への移行

Oracle Hyperion Financial Reportingのコンテンツをソース環境からエクスポートして、ターゲット環境にインポートできます。

1. Financial Reportingのレポート・コンテンツをソース環境からエクスポートします。

1. ソース環境にログインします。

2. 「ファイル」→「エクスポート」を選択します。

3. ターゲット環境に移行するコンテンツまたはディレクトリに移動して、そのコンテンツまたはディレクトリを選択します。

4. 選択したコンテンツまたはディレクトリをローカル・ファイル・システムにエクスポートします。

2. Financial Reportingのレポート・コンテンツをターゲット環境にインポートします。

1. ターゲット環境にログインして、「ファイル」→「インポート」を選択し、「Financial Reporting」を選択します。

2. Financial Reportingのレポート・コンテンツをインポートするターゲットの場所を参照し、エクスポート・コンテンツが保存されているローカル・ファイルを選択します。

注意:

Oracle Hyperion Financial Reportingのアノテーションおよびスケジューラの出力は、ソース環境からターゲット環境に移行できません。

作業5   Oracle Hyperion Provider Servicesのターゲット環境への移行

Oracle Hyperion Provider Servicesのアーティファクトをソース環境からターゲット環境にコピーする必要があります。

- Provider ServicesをSmart Viewで使用する場合の移行方法:

1. Smart Viewクライアントを使用して、ソース環境で作成したOracle Essbaseサーバーをターゲット・サーバーに手動で追加します。

2. 次のファイルをターゲット環境にコピーします。

ORACLE_INSTANCE/products/Essbase/aps/bin/essbase.properties

3. Smart Viewから、ソース環境で作成したキューブ・ビューをターゲット環境で再作成します。

- Provider ServicesをOracle Essbase Java APIで使用する場合の移行方法:
Java APIクライアント・プログラム構成のessbase.propertiesファイルで、デフォルトのJava APIプリファレンスが変更されている場合は、essbase.propertiesをターゲット環境にコピーします。

作業6   Oracle Hyperion Smart Viewのターゲット環境への移行

Oracle Hyperion Smart View for Officeは、クライアント・サイド・アプリケーションであるため、ソース・サーバーで作成したスプレッドシートなどのMicrosoft Officeドキュメントをターゲット・サーバー接続に関連付ける必要があります。メタデータに変更がなければ、既存のレポートをソースからターゲットに指定できます。

共有接続を関連付けるには:

1. 既存のレポートを開きます。
既存のレポートの場所は、そのレポートを最初に作成したときに保存した場所によって異なります。

2. Smart ViewがインストールされているExcelで、「Smart View」→「オプション」→「拡張」を選択します。

3. 共有接続URLを新しい接続URLに変更します。例:

https://host.example.com/workspace/SmartViewProviders

4. 「Smart View」→「開く」→「Smart Viewパネル」→「共有接続」を選択して、次のいずれかを実行します。

- Essbaseサーバーが一覧に表示されていない場合は、「新規接続の作成」をクリックします。

- Essbaseサーバーが一覧に表示されている場合は、ユーザー名とパスワードを入力して、「接続」をクリックします。

5. ドロップダウン・リストから、「Essbaseサーバー」を選択します。

1. ドロップダウン・リストから、「ワークシート接続の検索」を選択します。
接続がキューブの下に作成されます。

2. その接続を選択し、右クリックして接続します。

6. 「リフレッシュ」をクリックします。

7. アドホック分析の場合は、新しいサーバーに接続して、POVを保持するように選択する必要があります。この操作を行うには、プロンプトが表示されたら、「シートのコンテンツおよびPOVを再利用」を選択します。

プライベート接続を関連付けるには:

1. 「Smart View」→「開く」→「Smart Viewパネル」を選択します。

2. 「プライベート接続」を選択します。

3. Provider ServicesのURLを入力します。例:

https://host.example.com/aps/SmartView

4. Oracle Hyperion Provider Servicesにログインします。

5. Oracle Essbaseアプリケーションを選択してログインします。

6. Oracle Essbaseアプリケーションを選択して右クリックし、「プライベート接続への追加」を選択します。

7. 接続名を入力するか、デフォルトの名前を使用して、「OK」をクリックします。

8. 接続を関連付けてから(「SVC」→「開く」→「アクティブな接続」)、その接続を選択します。「OK」をクリックして、メッセージを確認します。

9. 「リフレッシュ」をクリックします。

10. アドホック分析の場合は、新しいサーバーに接続して、POVを保持するように選択する必要があります。プロンプトが表示されたら、「シートのコンテンツおよびPOVを再利用」を選択します。

作業7   Oracle EPM Workspaceのターゲット環境への移行

Oracle Enterprise Performance Management Workspaceの情報をソース環境からターゲット環境に移行する場合は、システム設定とユーザー・プリファレンスを手動で移行する必要があります。サーバー設定およびユーザー・プリファレンスに行った変更はすべて、ターゲット・システムで行う必要があります。Oracle Enterprise Performance Management Workspace, Fusion Edition管理者ガイドのEPMワークスペースの管理に関する項を参照してください。

21.4.6 Web層のターゲット環境への移行

この手順では、Oracle HTTP ServerおよびOracle Web Cacheがソース環境にインストール済で、これらをターゲット環境に移行する必要があると想定します。

次の各項目では、Web層をソース環境からターゲット環境に移行する方法について説明します。

- Web層の新しいターゲット環境への移行

- Web層の既存のターゲット環境への移行

21.4.6.1 Web層の新しいターゲット環境への移行

次の各項目では、Web層を新しいターゲット環境に移行する方法について説明します。

- Oracle HTTP Serverの新しいターゲット環境への移行

- Oracle Web Cacheの新しいターゲット環境への移行

21.4.6.1.1 Oracle HTTP Serverの新しいターゲット環境への移行

この手順では、Oracle HTTP Serverがソース環境にインストール済で、これをまだ存在しないターゲット環境に移行する必要があると想定します。ソース環境で、次を実行しておきます。

- Oracle HTTP Serverをインストールしました。

- Oracleインスタンスおよび1つ以上のOracle HTTP Serverのコンポーネント・インスタンスを作成しました。

- コンポーネントをFusion Middleware Controlを使用して管理する場合、既存のJRF対応のOracle WebLogic Server管理サーバーにOracleインスタンスおよびOracle HTTP Serverのコンポーネント・インスタンスを登録しました。

- リクエストを1つ以上の仮想ホストにルーティングするように、mod_wl_ohsを構成しました。

- SSLを1つ以上の仮想ホストに対して構成しました。

- Oracle Single Sign-Onを構成しました。

- mod_plsqlを構成しました。

- mod_oradavを構成しました。

- また、Oracle Access Managerを使用している場合があります。この手順では、Oracle Access Managerのアクセス・サーバーは、ソース環境にはありません。これらのサーバーは、別のターゲット環境にあります。ただし、Webゲートはソース環境で実行されています。

この環境を新しいターゲット環境に移行するには、次の作業を実行します。

- 作業1「Oracle HTTP Serverを使用するOracle Access Managerの移行」

- 作業2「Middlewareホームの移行および初期構成の実行」

- 作業3「プロセスの起動」

作業1   Oracle HTTP Serverを使用するOracle Access Managerの移行

WebゲートでOracle HTTP Serverが使用されている場合は、第21.4.1項の作業6または作業7(Oracle Access Managerのバージョンによって異なります)の説明に従って、まずOracle Access Managerをターゲット環境に移行する必要があります。

次の点に注意してください。

- WebGateInstalldirプロパティとそのパスへの参照は、webgate.confファイルに更新されます。

- WebGateディレクトリは、次のディレクトリに存在する必要があります。

Oracle_Instance/config/OHS/ohs_component_name

作業2 Middlewareホームの移行および初期構成の実行

Middlewareホームを移行して初期構成を実行するには:

1. 第21.3.4項の説明に従って、Middlewareホームとバイナリ・ファイルを移行します。

2. 構成を移行します。次のいずれかを選択できます。

- 第21.3.6.1項の説明に従って、OracleインスタンスおよびこのOracleインスタンスのすべてのコンポーネントを移行します。

- 第21.3.6.2項の説明に従って、OracleインスタンスおよびこのOracleインスタンスの1つのコンポーネントのみを移行します。

この手順では、構成を移行します。さらに、次のことも行われます。

- リスニング・アドレスおよび仮想ホストの名前の更新

- ソース環境でSSLが構成されていた場合は、SSLの構成

- 環境およびトポロジ・ディレクティブ(ホスト名やIPアドレスなど)の新しい値を使用した、httpd.confファイルの更新

- ターゲット環境用のホスト名、IPアドレスおよびポート番号を使用した、mod_wl_ohs.confファイル内のWebLogicHost、WebLogicPortまたはWebLogicClusterディレクティブの更新

- SSLがmod_wl_ohs用に構成されている場合は、mod_wl_ohs用のSSLの構成

- ソース環境でmod_ossoが構成されていた場合は、mod_ossoの構成

- ソース環境でPL/SQLが構成されていた場合は、PL/SQLの構成

- ソース環境でmod_ossoが構成されていた場合は、mod_ossoの構成

- ソース環境でaudit.config.xmlに変更が加えられていた場合は、audit.config.xmlの更新

- ソース環境でcomponent-log.xmlに変更が加えられていた場合は、component-log.xmlの更新

- Oracle Access Managerを使用している場合は、Webゲートの構成

作業3 プロセスの起動

Oracleインスタンスのプロセスを起動します。

ORACLE_INSTANCE/bin/opmnctl stopall
ORACLE_INSTANCE/bin/opmnctl startall

21.4.6.1.2 Oracle Web Cacheの新しいターゲット環境への移行

この手順では、Oracle Web Cacheがソース環境にインストール済で、これをまだ存在しないターゲット環境に移行する必要があると想定します。ソース環境で、次を実行しておきます。

- Oracle Web Cacheをインストールしました。

- 2つ以上のOracleインスタンス(それぞれがOracle Web Cacheインスタンスを含む)を構成しました。

- コンポーネントをFusion Middleware Controlを使用して管理する場合、既存のJRF対応のOracle WebLogic Server管理サーバーにOracleインスタンスおよびOracle Web Cacheインスタンスを登録しました。

- Oracle Web CacheインスタンスをOracle Web Cacheクラスタとして構成しました。

- サイトを作成し、サイト・サーバー間マッピングを構成しました。

- Oracle Web CacheをSSL対応リスニング・アドレスを持つように構成しました。

- キャッシュ・ルールを構成し、リクエスト・フィルタリング用のフィルタを定義しました。

注意:

第21.3.6.1項の説明に従って、すべてのOracleインスタンスをすでに移行している場合は、Oracle Web Cacheインスタンスもすでに移行されています。たとえば、Oracle HTTP Serverを移行し、Oracle Web Cacheを含むOracleインスタンス全体の移行を選択した場合は、Oracle Web CacheがOracle HTTP Serverとともに移行されます。

この場合は、作業1を省略できます。

この環境を新しいターゲット環境に移行するには、次の作業を実行します。

- 作業1「OracleインスタンスおよびOracle Web Cacheインスタンスの作成」

- 作業2「Oracle Web Cacheの更新」

作業1   OracleインスタンスおよびOracle Web Cacheインスタンスの作成

ターゲット環境で、バイナリ・ファイルを移行し、OracleインスタンスおよびOracle Web Cacheインスタンスを作成します。

1. 第21.3.4項の説明に従って、Middlewareホームとバイナリ・ファイルを移行します。

2. OracleインスタンスおよびOracle Web Cacheインスタンスを作成します。

1. コマンドラインから、次のディレクトリに移動します。

(UNIX) ORACLE_HOME/opmn/bin
(Windows) ORACLE_HOME\opmn\bin

2. opmnctl createinstanceコマンドを使用して、Oracleインスタンスを作成します。次に例を示します。

opmnctl createinstance -oracleInstance /scratch/Oracle/Middleware/inst1
-adminHost hostname -adminPort 7001

このコマンドは、Oracleインスタンスを作成し、デフォルトで、それらのインスタンスをOracle WebLogic Server管理サーバーに登録します。

3. opmnctl createcomponentコマンドを使用して、Oracle Web Cacheインスタンスを作成します。次に例を示します。

opmnctl createcomponent -componentType WebCache
-oracleInstance /scratch/Oracle/Middleware/inst1
-componentName webcache1

3. opmnctl registerinstanceコマンドを使用して、Oracleインスタンスをそのコンポーネントすべてとともに、管理サーバーに登録します。次に例を示します。

opmnctl registerinstance -adminHost admin_server_host
-adminPort admin_server_port -adminUsername username
-adminPasswordFile 'file_with_weblogic_admin_password'
-oracleInstance ORACLE_INSTANCE_dir -oracleHome ORACLE_HOME_dir
-instanceName Instance_name -wlserverHome Middleware_Home

作業2   Oracle Web Cacheの更新

各Oracle Web Cacheインスタンスに対して、次の手順を実行します。

1. 次のディレクトリにあるwebcache.xmlファイルをソース環境から一時的な場所にコピーします。

(UNIX) ORACLE_INSTANCE/config/WebCache/webcache_name
(Windows) ORACLE_INSTANCE\config\WebCache\webcache_name

2. 一時的な場所のwebcache.xmlに次の変更を行います。

- ターゲット環境のWeb Cache管理パスワードがソース環境のパスワードと異なる場合は、次の手順を実行します。

- ターゲット環境のWeb Cacheインスタンスのwebcache.xmlファイルから<USER TYPE="INVALIDATION">要素のPASSWORDHASH属性の値をコピーし、この一時webcache.xmlの対応するPASSWORDHASH属性の現在の値を置き換えます。

- ターゲット環境のWeb Cacheインスタンスのwebcache.xmlファイルから<USER TYPE="MONITORING">要素のPASSWORDHASH属性の値をコピーし、この一時webcache.xmlの対応するPASSWORDHASH属性の現在の値を置き換えます。

- ターゲット環境において、元のサーバーの新しいホスト名またはIPアドレスとポート番号を使用して、各<HOST>要素および<VIRTUALHOSTMAP>要素のNAME属性およびPORT属性を更新します。

- webcache.xmlの各<CACHE>要素に対して、次の項目を変更してターゲット環境のOracle Web Cacheインスタンスがあるホストに対応する値を置き換えます。

- NAME、ORACLE_HOMEおよびHOSTNAME属性を更新します。

- Oracleインスタンスのパスを検索し、置き換えます。
注意: この情報は一度に1つのOracle Web Cacheインスタンスについて更新してください。他のOracle Web Cacheインスタンスが別のパスで実行されている別のOracleインスタンスで構成されている場合があるため、グローバル検索および置換えは行わないでください。

- 各<LISTEN>要素に対して、IPADDR(ANY以外で構成されている場合)およびPORT(Oracle Web Cacheがターゲット環境で異なるポートを使用している場合)を更新します。

- SSL対応のリスニング・アドレスのウォレット・ロケーションを更新します(異なる場合)。ウォレット・ロケーションは、各SSLリスニング・ポートの<WALLET>要素内で指定されます。

- <IDENTITY>要素のUSERID属性およびGROUPID属性を更新します。

- <OSWALLET>要素で、元のサーバーのウォレット・ロケーションを更新します(ターゲット環境で異なる場合)。これは、Oracle Web Cacheによって使用され、SSL対応のオリジナル・サーバーと対話するウォレットです。

3. 編集したwebcache.xmlをターゲット環境の次の場所にコピーします。

(UNIX) ORACLE_INSTANCE/config/WebCache/webcache_name
(Windows) ORACLE_INSTANCE\config\WebCache\webcache_name

4. auditconfig.xmlに変更が行われた場合、次のファイルをソース環境から対応するターゲット環境にコピーします。

(UNIX) ORACLE_INSTANCE/config/WebCache/webcache_name/auditconfig.xml
(Windows) ORACLE_INSTANCE\config\WebCache\webcache_name\auditconfig.xml

5. component-log.xmlに変更が行われた場合、最初にこのファイルを編集してログ・パスを更新し、それからファイルをソース環境から対応するターゲット環境にコピーします。

6. 次のディレクトリにあるOracle Web Cacheエラー・ページへの変更を行った場合、エラー・ページをソース環境からターゲット環境の場所にコピーします。

(UNIX) ORACLE_INSTANCE/config/WebCache/webcache_name/files
(Windows) ORACLE_INSTANCE\config\WebCache\webcache_name\files

7. ソース環境でSSL対応のリスニング・アドレスまたはOSwalletに対してデフォルトでないウォレットが使用された場合、ソース環境からウォレットをエクスポートし、それらをターゲット環境にインポートします。ウォレットのエクスポートおよびインポートの詳細は、第8.4.4項を参照してください。

21.4.6.2 Web層の既存のターゲット環境への移行

この手順では、稼働中のターゲット環境があり、アプリケーションまたは構成の変更を、ターゲット環境への適用前にテストする必要があると想定します。

- Oracle HTTP Serverの場合は、第21.4.6.2.1項を参照してください。

- Oracle Web Cacheの場合は、第21.4.6.1.2項の作業2を実行します。

21.4.6.2.1 Oracle HTTP Serverの既存のターゲット環境への移行

Oracle HTTP Serverを既存のターゲット環境に移行するには、構成を更新します。

1. 任意のカスタム・コンテンツ(変更されたコンテンツ、htdocsディレクトリに追加されたコンテンツなど)をターゲット環境のOracle HTTP Serverにコピーします。

2. 次のディレクトリにあるauditconfig.xmlへの変更を行った場合、ターゲット環境でこのファイルのバックアップ・コピーを作成します。その後、auditconfig.xmlをソース環境から対応するターゲット環境にコピーします。

ORACLE_INSTANCE/config/OHS/ohs_component_name/auditconfig.xml

3. component-log.xmlへの変更を行った場合、ターゲット環境でこのファイルのバックアップ・コピーを作成します。その後、ソース環境の次のディレクトリにあるファイルをターゲット環境にコピーします。

ORACLE_INSTANCE/diagnostics/logs/OHS/ohs_component_name

21.4.7 Oracle Business Intelligenceのターゲット環境への移行

この項では、Oracle Business Intelligenceをソース環境からターゲット環境に移行する手順について説明します。

関連項目:

リポジトリをソース環境からターゲット環境に移行する際の考慮事項など、Oracle Business Intelligenceリポジトリのライフサイクルの詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ・ビルダーズ・ガイドのマルチユーザー開発環境でのリポジトリ・ライフサイクルの管理に関する説明を参照してください。

次の手順では、Oracle Business Intelligenceコンポーネントをソース環境にすでにインストール済かつ構成済で、これらを新しいターゲット環境または既存のターゲット環境のいずれかに移行する必要があると想定します。

- Oracle Business Intelligenceの新しいターゲット環境への移行

- 適用するパッチが少ない場合のOracle Business Intelligenceの既存のターゲット環境への移行

- 適用するパッチが多数ある場合のOracle Business Intelligenceコンポーネントの既存のターゲット環境への移行

既存のターゲット環境にパッチを適用している場合、実行する手順は、適用する必要のあるパッチの数によって異なります。少数のパッチを適用する場合は、第21.4.7.2項の手順(環境内のマスター・ホストとすべてのクラスタ・ホストにパッチを適用します)に従います。適用するパッチが多数ある場合は、第21.4.7.3項の手順に従います。この手順では、パッチを1つのホストに適用し、新しいハードウェアが使用可能であるかどうかに応じて異なる方法を使用して、それらのパッチを他のホストに移入します。

21.4.7.1 Oracle Business Intelligenceの新しいターゲット環境への移行

この項では、Oracle Business Intelligenceをソース環境から新しいターゲット環境に移行する手順について説明します。

この手順では、Oracle Business Intelligenceコンポーネントをソース環境にすでにインストール済かつ構成済で、ソース環境にパッチを適用しており、必要に応じて環境をテストしていると想定します。また、これらを新しいターゲット環境に移動する必要があると想定します。

Oracle Business Intelligenceコンポーネントを新しいターゲット環境に移行するには、次の作業を実行します。

- 作業1「データベース、Middlewareホームの移行および初期構成の実行」

- 作業2「リポジトリ・ファイルのパッチ・マージ」

- 作業3「新しいターゲット環境でのセキュリティの構成」

- 作業4「Oracle BI Enterprise Editionコンポーネントの構成の移行」

- 作業5「ターゲット環境の新しいクラスタ・ホストへのコピーおよびスケールアウト」

- 作業6「新規エージェントおよびOracle BI Publisherのスケジュール済ジョブの有効化」

- 作業7「外部システムへのリンクの更新」

- 作業8「(オプション) Oracle Business Intelligence関連アプリケーションの移行」

作業1   データベース、Middlewareホームの移行および初期構成の実行

データベースおよびMiddlewareホームを移行して初期構成を実行する手順は次のとおりです。

1. 第21.3.3項の説明に従って、データベースを移行または作成します。

2. 第21.4.1項の説明に従って、アイデンティティ管理コンポーネントを移行します。

3. 第21.3.4項の説明に従って、Middlewareホームとバイナリ・ファイルを移行します。

4. 第21.3.5項の説明に従って、ドメインおよびノード・マネージャの構成を移行します。
ドメインの構成を移行すると、pasteConfigスクリプトによって、管理サーバーおよび管理対象サーバーを含むドメインの構成がコピーされます。

5. 第21.3.7項の説明に従って、ユーザーおよびグループを構成します。

作業2   リポジトリ・ファイルのパッチ・マージ

ソース環境で管理ツールおよびOracle BIサーバーXML APIを使用して、ソース・リポジトリ・ファイル(.rpd)とターゲット・ファイルのパッチ・マージを実行します。

詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ・ビルダーズ・ガイドのパッチ・マージの実行に関する項を参照してください。

作業3   新しいターゲット環境でのセキュリティの構成

デフォルトのOracle WebLogic Server LDAP以外のものを使用する場合は、セキュリティを構成します。詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionセキュリティ・ガイドを参照してください。

セキュリティ・データ(ユーザー、グループ、ロールなど)の移行の詳細は、それぞれの認証プロバイダの該当ドキュメントを参照してください。次に、様々なコンポーネントに関する参照先を示します。

- Oracle Internet Directory: 第21.4.1.1項の作業3「Oracle Internet Directoryの新しいターゲット環境への移行」を参照してください。

- Oracle WebLogic Server: 『Oracle Fusion Middleware Oracle WebLogic Serverの保護』のセキュリティ・データの移行に関する項を参照してください。

- Oracle Platform Security Services: 『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』を参照してください。

作業4   Oracle BI Enterprise Editionコンポーネントの構成の移行

copyConfig、extractMovePlanおよびpasteConfigスクリプトを使用して、次のOracle BI EEコンポーネントの構成を移行します。

- Oracle BIサーバー

- Oracle BI Presentation Services

- Oracle BI Cluster Controller

- Oracle BIスケジューラ

- JavaHost

- Oracle Essbaseサーバー(ご使用の環境にインストールされている場合)

コンポーネントの構成を移行する手順は次のとおりです。

1. ソースMiddlewareホームで、Oracle BI EE Oracleインスタンスに対してcopyConfigスクリプトを実行します。
copyConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/copyConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\copyConfig.cmd

スクリプトの構文の詳細は、第20.2.1.5項を参照してください。

Oracle BI EEコンポーネントを含むOracleインスタンスを移行するためのcopyConfigコマンドを次に示します。Oracle Essbaseに必要なadditionalParamsオプションに注目してください。

copyConfig.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-logDirLoc /tmp/logs
-archiveLoc /tmp/bi_archive/biconfig.jar
-sourceInstanceHomeLoc /scratch/Oracle/Middleware1/instances/instance1
-additionalParams essbaseServerUserName=Administrator,essbaseServerPassword=/scratch/arc_loc/pwd.txt

2. コンポーネントを別のホストにコピーする場合は、そのシステムにアーカイブ・ファイルをコピーします。

3. extractMovePlanスクリプトを使用して、Oracleインスタンスのアーカイブから移動計画を抽出します。
extractMovePlanスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/extractMovePlan.sh
(Windows) ORACLE_COMMON_HOME\bin\extractMovePlan.cmd

extractMovePlanスクリプトの構文の詳細は、第20.2.1.7項を参照してください。

次に例を示します。

extractMovePlan.cmd -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/bi_archive/biconfig.jar
-planDirLoc /tmp/Oracle/t2p_plans/bi

4. ターゲット環境の値にあわせてプロパティを変更するために、移動計画を編集します。変更するプロパティの詳細は、表20-25を参照してください。
Oracle Essbaseの場合は、有効なファイルの場所、ディスク・ボリュームのカスタマイズの場所、およびOracle Essbaseの管理ユーザー名とパスワードを指定する必要があります。そうしない場合、エラーを受信します。

5. 編集した移動計画をターゲットにコピーします。(pasteConfig操作の間、-movePlanLocオプションを使用して場所を指定します。)

6. ターゲットでは、pasteConfigスクリプトを使用してアーカイブからファイルを抽出します。
pasteConfigスクリプトは、次の場所にあります。

(UNIX) ORACLE_COMMON_HOME/bin/pasteConfig.sh
(Windows) ORACLE_COMMON_HOME\bin\pasteConfig.cmd

スクリプトの構文の詳細は、第20.2.1.10項を参照してください。

Oracle BI EEコンポーネントを含むOracleインスタンスを移行するためのpasteConfigコマンドを次に示します。

pasteConfig.cmd -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/bi_archive/biconfig.jar
-targetOracleHomeLoc /scratch/Oracle/Middleware/Oracle_BI1
-targetInstanceHomeLoc /scratch/Oracle/Middleware/instances/instance1
-targetInstanceName  instance1
-movePlanLoc  /tmp/Oracle/t2p_plans/bi_plan.xml
-domainHostName example.com
-domainPortNum 7001
-domainAdminUserName domain_admin_username
-domainAdminPasswordFile /tmp/pass/bi_password.txt

ターゲット環境のOracleインスタンス名は、ソース環境と同じ名前である必要があります。

作業5   ターゲット環境の新しいクラスタ・ホストへのコピーおよびスケールアウト

1. アーカイブ・ファイル(作業1「データベース、Middlewareホームの移行および初期構成の実行」で作成済)を新しいクラスタ・ホストにコピーします。

2. 次のファイルを新しいクラスタ・ホストにコピーします。

- UNIXの場合:

ORACLE_COMMON_HOME/bin/pasteBinary.sh
ORACLE_HOME/jlib/cloningclient.jar

- Windowsの場合:

ORACLE_COMMON_HOME\bin\pasteBinary.cmd
ORACLE_HOME\jlib\cloningclient.jar

3. 第20.2.1.2項の説明に従って、pasteBinaryスクリプトを使用して、新しいクラスタ・ホストにMiddlewareホームをコピーします。
注意: マスター・ホストで使用したMiddlewareホーム名と正確に同じ名前を新しいクラスタ・ホストで使用する必要があります。

4. Fusion Middleware Controlを使用して、新しいクラスタ・ホストにスケール・アウトします。
詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイドのFusion Middleware Controlを使用した、システム・コンポーネントのスケール・アウトに関する項を参照してください。

5. 新しいクラスタ・ホストそれぞれに対して、前述の手順を繰り返します。

作業6 新規エージェントおよびOracle BI Publisherのスケジュール済ジョブの有効化

新規エージェントがソース環境で作成された場合、(ターゲット環境の)Oracle BIプレゼンテーション・サービスのカタログ・マネージャで各エージェントをクリックして有効化します。

Oracle BI Publisherのレポートは、Oracle BI Presentation Catalogに格納されているため、既存のレポート、およびソース環境で作成された新しいレポートを使用できるようにする必要があります。

ターゲット環境で、Oracle WebLogic Server管理者は、ソース環境と同じ名前を使用して、(Oracle BI Publisherのレポートが使用する)JNDI接続を作成する必要があります。この接続は、ソース・データベースではなくターゲット・データベースを指す必要があります。この方法により、すべてのレポートは自動的に、ソース環境のデータベースではなくターゲット環境のデータベースを指すようになり、設定を変更する必要はありません。

作業7 外部システムへのリンクの更新

外部システムに関連した静的コンテンツをターゲット環境に移行するには、Action Framework構成ファイルを編集して、エンドポイントがターゲット・システムの関連リソースを参照するようにします。

様々なアクション・タイプ用の構成の詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionインテグレーターズ・ガイドのアクション・フレームワークの構成に関する項を参照してください。

作業8 (オプション) Oracle Business Intelligence関連アプリケーションの移行

Oracle Business Intelligence関連アプリケーション(Calculation Manager、Financial ReportingおよびOracle BI for Microsoft Officeなど)を新しいターゲット環境に移行します。詳細は、第21.4.5項を参照してください。

21.4.7.2 適用するパッチが少ない場合のOracle Business Intelligenceの既存のターゲット環境への移行

この項では、適用するパッチが少ない場合にOracle Business Intelligenceをソース環境から既存のターゲット環境に移行する手順について説明します。(多数のパッチを適用する場合は、第21.4.7.3項を参照してください)。

次の各手順では、Oracle Business Intelligenceコンポーネントをソース環境にすでにインストール済かつ構成済で、これらを既存のターゲット環境に移行する必要があると想定します。

適用するパッチが少ない場合にOracle Business Intelligenceコンポーネントを既存のターゲット環境に移行するには、次の作業を実行します。

- 作業1「ソース環境および既存のターゲット環境へのパッチ適用」

- 作業2「ソース・リポジトリ・ファイルの既存のターゲット環境へのデプロイ」

- 作業3「ソースのOracle BI Presentation Catalogの既存のターゲット環境へのデプロイ」

- 作業4「(オプション)グローバル一意識別子(GUID)のリフレッシュ」

- 作業5「新規エージェントおよびOracle BI Publisherのスケジュール済ジョブの有効化」

- 作業6「外部システムへのリンクの更新」

- 作業7「(オプション) Oracle Business Intelligence関連アプリケーションの移行」

作業1   ソース環境および既存のターゲット環境へのパッチ適用

パッチは、一連のバグ修正を既存の本番環境に適用します。また、新しいバイナリ・ファイルおよびメタデータの更新も含まれます。

1. 準備完了になるまで、必要に応じてソース環境にパッチを適用し、テストします。

2. マスター・ホスト上およびすべてのクラスタ・ホスト上で既存のターゲット環境にパッチを適用し、ソース環境と同じレベルにします。
注意: パッチ適用には、Oracle Business Intelligence以外のパッチおよび個別パッチも含まれます。

詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイドのOracle Business Intelligenceシステムのパッチ適用に関する項を参照してください。

作業2   ソース・リポジトリ・ファイルの既存のターゲット環境へのデプロイ

1. ソース環境で管理ツールおよびOracle BIサーバーXML APIを使用して、ソース・リポジトリ・ファイル(.rpd)とターゲット・ファイルのパッチ・マージを実行します。
既存のターゲット環境に移行中で、ソース環境でRPDファイルの変更を行った場合のみ、この作業を完了する必要があります。

詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ・ビルダーズ・ガイドのパッチ・マージの実行に関する項を参照してください。

2. ターゲット環境でFusion Middleware Controlを使用して、RPDファイルをアップロードします。
詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイドのFusion Middleware Controlを使用した、リポジトリのアップロードとOracle BI Presentation Catalogの場所の設定に関する項を参照してください。

3. 必要に応じて、管理ツールまたはOracle BIサーバーXML APIを使用して、リポジトリの接続プールおよびデータベース設定を更新します。RPDファイルには、ソース環境のデータソース接続情報が含まれていることがあり、その場合、それらをターゲット環境の接続設定に変更する必要があります。
Oracle BIサーバーXML APIを使用してこの手順を実行する方法の詳細は、Oracle Fusion Middleware XMLスキーマOracle Business Intelligence Enterprise Editionリファレンスのテスト環境から本番環境への移行に関する説明を参照してください。

注意:

BIServerT2PProvisioner.jarユーティリティを使用しても、リポジトリ内の接続プール・パスワードを変更して暗号化できます。詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionメタデータ・リポジトリ作成者ガイドのBIServerT2PProvisioner.jarユーティリティを使用した接続プールのパスワードの変更に関する項を参照してください。

4. (オプション)Fusion Middleware Controlの「容量管理」ページで「パフォーマンス」タブの「オンラインRPD更新の無効化」を選択して、ターゲット・リポジトリ・ファイルを読取り専用にします。

作業3   ソースのOracle BI Presentation Catalogの既存のターゲット環境へのデプロイ

1. 次のように、新規または更新されたフォルダをソース・カタログからターゲット・カタログにドラッグ・アンド・ドロップします。

1. 2つのカタログ・マネージャ・ウィンドウ(一方はソース・カタログ、他方はターゲット・カタログ)を開きます。

2. 必要なフォルダをソース・カタログから選択してコピーし、ターゲット・カタログに貼り付けます。
注意: ソース環境またはターゲット環境で同じコンテンツが変更されているフォルダをコピーして貼り付ける場合は、ソースのコンテンツによってターゲットのコンテンツが上書きされます。

詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイドを参照してください。

2. 既存のターゲット環境でFusion Middleware Controlを使用して、新しいカタログの場所を指定します。
詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイドのFusion Middleware Controlを使用した、リポジトリのアップロードとOracle BI Presentation Catalogの場所の設定に関する項を参照してください。

作業4   (オプション)グローバル一意識別子(GUID)のリフレッシュ

ソース環境およびターゲット環境のGUIDを含むLDAPディレクトリはファンアウト・レプリカである必要があるため、通常、ソース環境とターゲット環境の間でLDAPディレクトリのGUID(アイデンティティ・ストア・ユーザー)はリフレッシュしません。考えられるリフレッシュのシナリオには次のようなものがあります。

- Oracle Business Intelligenceソース・サーバーおよびターゲット・サーバーが両方とも、企業LDAPディレクトリに対して構成されています。
LDAP GUIDをリフレッシュする必要はありません。

- Oracle Business Intelligenceソース・サーバーはソースLDAPに対して構成されていて、かつターゲット・サーバーは企業LDAPに対して構成されていますが、ソースLDAPは企業LDAPのファンアウト・レプリカです。
LDAP GUIDをリフレッシュする必要はありません。

- Oracle Business Intelligenceソース・サーバーはソースLDAPに対して構成されていて、かつターゲット・サーバーは企業LDAPに対して構成されていますが、ソースLDAPは企業LDAPのファンアウト・コピーではありません。
LDAP GUIDのリフレッシュが必要です。この項の手順に従います。

認証プロバイダのデータソースとして使用されるディレクトリ・サーバーを変更した後にユーザーGUIDを更新することをお薦めします。両方のディレクトリ・サーバー(元のサーバーと新しいサーバー)に同じユーザー名が存在する場合、元のユーザーGUIDが、新しいディレクトリ・サーバーに含まれているユーザーGUIDと競合する場合があります。リフレッシュすると、システムは、新しいディレクトリ・サーバーに含まれているユーザーGUIDを参照するようになります。GUIDがリフレッシュされず、システムがユーザーGUIDの不一致を検出すると、認証エラーが発生する場合があります。

次の手順の説明に従って、Oracle BI Presentation CatalogまたはRPDファイルに格納されているGUIDを再同期およびリフレッシュすることができます。この手順を開始する前に、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイドの通常はFusion Middleware Controlによって管理されないOracle Business Intelligence構成設定の手動での更新に関する項の情報をよく確認してください。

この手順では、Oracle BIサーバーおよびOracle BIプレゼンテーション・サービスに対して再起動時にGUIDをリフレッシュすることを指示するように、構成ファイルを手動で編集する必要があります。処理が完了したら、これらのファイルを編集して変更内容を削除します。Oracle Business Intelligence構成ファイルの場所の詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイドで、構成ファイルの場所について説明している項を参照してください。

ユーザーGUIDをリフレッシュするには:

1. 編集するNQSConfig.INIファイルを開きます。詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイドの構成ファイルの場所に関する項を参照してください。

2. 設定FMW_UPDATE_ROLE_AND_USER_REF_GUIDS = NOを検索し、この値をYESに変更します。

3. プレゼンテーション・サービスが再起動時にGUIDをリフレッシュするように、instanceconfig.xmlファイルを変更します。ファイルを編集し、次のセクションを見つけてください。

<Catalog>
<UpgradeAndExit>false</UpgradeAndExit>
</Catalog>

次の例に示すように、<UpgradeAndExit>要素をコメント・アウトし、同じセクションに<UpdateAccountGUIDs>要素を追加します。

<Catalog>
<!--UpgradeAndExit>false</UpgradeAndExit-->
<UpdateAccountGUIDs>UpdateAndExit</UpdateAccountGUIDs>
</Catalog>

4. opmnctlコマンドをパラメータstopallおよびstartallとともに使用して、管理対象プロセスを停止して再起動します。パラメータstatusを使用して、プロセス・ステータス全体を確認できます。
含まれるコンポーネントは、プレゼンテーション・サービス、Oracle BIサーバー、Oracle BIスケジューラ、Oracle BIクラスタ・コントローラおよびOracle BI JavaHostです。

opmnctlコマンドの使用方法の詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイドのOPMNコマンドを使用した、Oracle Business Intelligenceシステム・コンポーネントの起動と停止に関する項を参照してください。

5. NQSConfig.INIファイルを編集して、FMW_UPDATE_ROLE_AND_USER_REF_GUIDS = YESをNOにリセットし、Oracle BIサーバーを再起動します。

6. 手順3で追加した行をコメント・アウトし、次の例のように、元の行からコメントを削除します。

<Catalog>

<UpgradeAndExit>false</UpgradeAndExit>

<!--UpdateAccountGUIDs>UpdateAndExit</UpdateAccountGUIDs-->
</Catalog>

7. 更新したinstanceconfig.xmlファイルのためにプレゼンテーション・サービスを再起動します。

8. Oracle WebLogic Serverおよびシステム・コンポーネントも実行中であることを確認します。実行中でない場合、これらを再起動します。
詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionシステム管理者ガイドのOracle Business Intelligenceコンポーネントの起動と停止に関する項を参照してください。

作業5   新規エージェントおよびOracle BI Publisherのスケジュール済ジョブの有効化

新規エージェントがソース環境で作成された場合、(ターゲット環境の)Oracle BIプレゼンテーション・サービスのカタログ・マネージャで各エージェントをクリックして有効化します。

Oracle BI Publisherのレポートは、Oracle BI Presentation Catalogに格納されているため、既存のレポート、およびソース環境で作成された新しいレポートを使用できるようにする必要があります。

ターゲット環境で、Oracle WebLogic Server管理者は、ソース環境と同じ名前を使用して、(Oracle BI Publisherのレポートが使用する)JNDI接続を作成する必要があります。この接続は、ソース・データベースではなくターゲット・データベースを指す必要があります。この方法により、すべてのレポートは自動的に、ソース環境のデータベースではなくターゲット環境のデータベースを指すようになり、設定を変更する必要はありません。

作業6   外部システムへのリンクの更新

次の手順の説明に従って、外部システムに関連する静的コンテンツがターゲット環境に移行されるようにします。

1. Action Framework構成ファイルをソース・システムからターゲット・システムの同じ場所にコピーします。また、ActionFramework構成ファイルには、構成ファイルと同じディレクトリにあるファイルを参照するポリシー要素が含まれている場合があります。それらのファイルをターゲット・システムの同じ場所にコピーします。

2. Action Framework構成ファイルを編集して、エンドポイントがターゲット・システムの関連するリソースを参照するようにします。

様々なアクション・タイプ用の構成の詳細は、Oracle Fusion Middleware Oracle Business Intelligence Enterprise Editionインテグレーターズ・ガイドのアクション・フレームワークの構成に関する項を参照してください。

作業7   (オプション) Oracle Business Intelligence関連アプリケーションの移行

Oracle Business Intelligence関連アプリケーション(Calculation Manager、Financial ReportingおよびOracle BI for Microsoft Officeなど)を既存のターゲット環境に移行します。詳細は、第21.4.5項を参照してください。

21.4.7.3 適用するパッチが多数ある場合のOracle Business Intelligenceコンポーネントの既存のターゲット環境への移行

この項では、適用するパッチが多数ある場合にOracle Business Intelligenceをソース環境から既存のターゲット環境に移行する手順について説明します。

次の手順では、Oracle Business Intelligenceコンポーネントをソース環境にすでにインストール済かつ構成済で、これらを既存のターゲット環境に移行する必要があると想定します。

適用するパッチが多数ある場合にOracle Business Intelligenceコンポーネントを既存のターゲット環境に移行するには、次の方法のいずれかを実行します。

- 新しいハードウェアが使用可能な場合のOracle BI EEの既存のターゲット環境への移行

- 新しいハードウェアが使用できない場合のOracle BI EEの既存のターゲット環境への移行

21.4.7.3.1 新しいハードウェアが使用可能な場合のOracle BI EEの既存のターゲット環境への移行

適用するパッチが多数あり、新しいハードウェアが使用可能な場合にOracle Business Intelligenceコンポーネントを既存のターゲット環境に移行するには、次の作業を実行します。

- 作業1「新しいターゲット環境への移行の手順の実行」

- 作業2「ユーザーの既存のターゲット環境から新しいターゲット環境への切替え」

- 作業3「既存のターゲット環境の削除および次のパッチ用のターゲット環境の準備」

作業1   新しいターゲット環境への移行の手順の実行

新しいターゲット環境への移行のため、第21.4.7.1項の手順を実行します。

これらの手順には、新しいソースRPDファイルおよびカタログと既存のターゲット環境のRPD/カタログのマージが含まれます。ユーザーが既存の環境を使用し続けながら、一度マージを実行して問題を解決することが理想的です。ファイルが正しい場合、ターゲット環境をロックし、マージを繰り返して、最新の変更を取得します。

作業2   ユーザーの既存のターゲット環境から新しいターゲット環境への切替え

Oracle Web Cacheなどのロード・バランサを使用して、ユーザーを標準URLから新しいターゲット環境にリダイレクトします。

作業3   既存のターゲット環境の削除および次のパッチ用のターゲット環境の準備

既存の環境を停止し、すべてのソフトウェアをアンインストールします。必要に応じて、次のパッチ・セットをこのホストに適用し、手順を最初から再開できます。

21.4.7.3.2 新しいハードウェアが使用できない場合のOracle BI EEの既存のターゲット環境への移行

適用するパッチが多数あり、新しいハードウェアが使用できない場合にOracle Business Intelligenceコンポーネントを既存のターゲット環境に移行するには、次の作業を実行します。

- 作業1「ターゲット環境の1つのホストへのスケールバック」

- 作業2「ターゲット環境のホストへのパッチ適用」

- 作業3「クラスタ・ホストの既存のソフトウェアの削除」

- 作業4「ターゲット環境の移行およびクラスタ・ホストへのコピー」

作業1   ターゲット環境の1つのホストへのスケールバック

ターゲット環境で、Fusion Middleware Controlの「スケーラビリティ」ページの「容量管理」タブを使用して、システム・コンポーネントをリストの最初のホストのみに適用するようにスケールバックします。こうすることにより、既存のターゲット環境へのパッチ適用が非常に簡単になります。

詳細は、Fusion Middleware Controlのヘルプ・システムを参照してください。

作業2   ターゲット環境のホストへのパッチ適用

ターゲット環境のホストにパッチを適用します。こうすることで、複数のクラスタ・ホストにパッチを適用する場合よりも、ユーザーの停止時間を減らすことができます。

詳細は、『Oracle Fusion Middlewareパッチ適用ガイド』を参照してください。

作業3   クラスタ・ホストの既存のソフトウェアの削除

クラスタ・ホストのすべてのOracle Business Intelligenceソフトウェアをアンインストールします。詳細は、Oracle Fusion Middleware Oracle Business Intelligenceインストレーション・ガイドを参照してください。

作業4   ターゲット環境の移行およびクラスタ・ホストへのコピー

第21.4.7.1項の作業5「ターゲット環境の新しいクラスタ・ホストへのコピーおよびスケールアウト」からの各作業を完了します。

21.4.8 Oracle Real-Time Decisionsのターゲット環境への移行

次の各項目では、Oracle Real-Time Decisions(Oracle RTD)をソース環境から新しいターゲット環境に移行する方法について説明します。

- Oracle Real-Time Decisionsの新しいターゲット環境への移行

- Oracle Real-Time Decisionsの既存のターゲット環境への移行

21.4.8.1 Oracle Real-Time Decisionsの新しいターゲット環境への移行

環境をターゲット環境に移行するには、次の作業を実行します。

- 作業1「データベース、Middlewareホームの移行および初期構成の実行」

- 作業2「Oracle RTDクライアント(使用する場合)のターゲット環境へのインストール」

- 作業3「Oracle RTD Inline Servicesの移行」

- 作業4「ターゲットの追加のOracle RTDコンポーネントの編集」

作業1   データベース、Middlewareホームの移行および初期構成の実行

データベース、MiddlewareホームおよびOracle RTDソフトウェアを移行して初期構成を実行するには:

1. 第21.3.1項の説明に従って、データベースと必要なスキーマを移行または作成します。

2. 第21.4.1項の説明に従って、Middlewareホームとバイナリ・ファイルのコピーを移行します。
環境にOracle BI EEが含まれており、第21.4.7.1項の説明に従ってOracle BI EEをすでにターゲット環境に移行済の場合、Oracle BI EEのバイナリ・ファイルだけでなく、Oracle RTDのバイナリ・ファイルも移行されているので、この手順を実行する必要はありません。

3. 第21.3.5項の説明に従って、構成を移行します。
構成を移行すると、pasteConfigスクリプトによって、管理サーバーおよび管理対象サーバーを含むドメインの構成がコピーされます。

作業2   Oracle RTDクライアント(使用する場合)のターゲット環境へのインストール

Oracle RTDクライアントを顧客のフロントエンド・アプリケーションとのOracle RTDの統合に使用する場合、Oracle Fusion Middleware Oracle Real-Time Decisions管理者ガイドで概説されている設定手順に従って、Oracle RTDクライアントをターゲット環境にインストールする必要があります。

クライアント・パラメータの構成は、ターゲット・アーキテクチャ固有の値を反映する必要があります。

作業3   Oracle RTD Inline Servicesの移行

ソース環境のOracle RTDインライン・サービスをターゲット環境に移行します。

1. インライン・サービスのターゲット環境への移行は、次の2つの方法で実行できます。

- コマンドライン・デプロイメント: 詳細は、Oracle Fusion Middleware Oracle Real-Time Decisions管理者ガイドのインライン・サービスのコマンドライン・デプロイメントに関する説明を参照してください。

- Decision Studioデプロイメント: Decision StudioでのOracle RTDデプロイメントの詳細は、Oracle Fusion Middleware Oracle Real-Time Decisionsプラットフォーム開発者ガイドのインライン・サービスのデプロイ、テストおよびデバッグに関する説明を参照してください。

注意:

インライン・サービスを移行する前に、Oracle RTDサーバーが使用するインライン・サービスに変更が行われた場合(たとえば、Decision Centerを介して)、まず、最新バージョンのインライン・サービスをDecision Studioにダウンロードし、それから本番環境に再デプロイする必要があります。

2. インライン・サービスをある環境から別の環境に移行する場合、インライン・サービス内でも編集する必要がある場合がある次の領域に注意してください。

- サード・パーティAPIおよびサード・パーティJARファイルのコール
追加した新しいjarファイルは、新しい環境の対応する場所に配置する必要があります。

- サード・パーティWebサービスのコール
ロケーション・パス、Webサービス・パラメータなどは、新しい環境で異なる場合、変更する必要があります。

- インライン・サービス内のカスタム表への参照(場所、ユーザー名、パスワードなど)は、本番環境で異なる場合、編集してから再デプロイする必要があります。

- データソースへの参照は、ターゲット環境で異なる場合、編集してからデプロイする必要があります。これには、動的選択肢のデータソースの変更も含まれます(使用する場合)。

- 新しい環境では望ましくない可能性があるデバッグ・コード(logInfo文、logTrace文など)への参照は、コメント・アウトするかインライン・サービスから削除し、それから再デプロイする必要があります。

3. 外部オブジェクト(動的選択肢、外部ルールなど)を含むインライン・サービスには、次の考慮事項が適用されます。

- 動的選択肢の場合:
インライン・サービス構成の一部に動的選択肢がある場合、ソース環境とターゲット環境が同じソースを共有しないときは、動的選択肢を格納しているデータと表の両方を再作成する必要があります。

インライン・サービスのデータソース要素も適切に変更する必要があります。

- 外部ルールの場合:
インライン・サービス構成の一部に外部ルールがある場合、ソース環境とターゲット環境が同じソースを共有しないときは、ルール・データを格納しているデータと表の両方を再作成する必要があります。

インライン・サービスのデータソース要素も適切に変更する必要があります。

また、ターゲット環境で使用される外部ルール・エディタを、ターゲット・データベースを指すように構成する必要があります。

作業4   ターゲットの追加のOracle RTDコンポーネントの編集

Oracle RTDで行う必要がある場合がある追加作業には、次の作業が含まれます。

1. モデル・スナップショット表の作成および構成

1. Oracle RTDモデル・スナップショット表は、RCUとツールsdexec/SDDBTool(インストール時に提供される)を使用する2つの方法でターゲット環境に作成できます。
RCUは、Oracle RTDプラットフォーム表と同じスキーマに必要なスナップショット表を作成します。一方、sdexec/SDDBToolを使用すると、別の場所に表を作成できます。

2. モデル・スナップショット表を作成した後、Enterprise Managerコンソールを使用して、表にデータを移入するために必要な設定を構成します。詳細は、Oracle Fusion Middleware Oracle Real-Time Decisions管理者ガイドの「モデル・スナップショットの設定と使用方法」を参照してください。

2. loadgenファイルの変更。
ターゲット環境でも使用されるloadgenファイルを作成済の場合、新しい環境に応じて次のパラメータを変更する必要があります(それぞれを特定のloadgen構成ファイル内で変更する必要があります)。

- ClientHttpEndpoints.propertiesファイル

- インライン・サービス名(変更された場合)

- loadgenスクリプトへの入力として使用する場合のデータファイルへのパス参照

- loadgenログ・ファイルへのパス

3. バッチ・プロセス・ファイルの変更。
RTDバッチ・モジュールを使用する場合、環境固有のバッチ・ファイルで参照されるデータソースに注意を払い、必要に応じてファイルを変更する必要があります。

21.4.8.2 Oracle Real-Time Decisionsの既存のターゲット環境への移行

ターゲット環境が作成された後、一般的なOracle RTDの増分変更には次の作業が含まれます。

- 作業1「Oracle RTDのパッチの更新」

- 作業2「インライン・サービスの更新」

- 作業3「データソースの更新」

作業1   Oracle RTDのパッチの更新

特定のパッチそれぞれが一意の機能拡張および既知のバグに対処しているため、パッチの適用方法に関する固有の指示について、各パッチに付属のリリース・ノートを常に参照する必要があります。

作業2   インライン・サービスの更新

増分インライン・サービスの変更の場合、インライン・サービスのターゲットへの移行では、完全製品のソース環境のターゲット環境への移行と同じ手順を実行します。

作業3 データソースの更新

追加のデータソースがインライン・サービスに増分追加される場合、Oracle Fusion Middleware Oracle Real-Time Decisions管理者ガイドの「データ・アクセスの構成」を参照してください。

21.4.9 Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle BI Discovererのターゲット環境への移行

この手順では、Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle Business Intelligence Discovererをソース環境にインストール済で、それをターゲット環境に移行する必要があると想定します。

次の各項目では、これらのコンポーネントをソース環境からターゲット環境に移行する方法について説明します。

- Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle Business Intelligence Discovererの新しいターゲット環境への移行

- Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle Business Intelligence Discovererの既存のターゲット環境への移行

いずれの場合も、ソース環境で次の操作を実行済です。

- これらのコンポーネントに使用するデータベースをインストールしました。

- RCUを使用してソース環境で必要なスキーマを作成しました。『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

- Oracle BI Discovererの場合、End User Layer(EUL)、DiscovererカタログおよびOLAPカタログに使用される追加のデータベースをインストールしました。

- Oracle WebLogic Serverをインストールし、Middlewareホームを作成しました。

- アイデンティティ管理(Oracle Internet Directory、Oracle Single Sign-Onおよびアイデンティティ管理データ用データベースを含む)をインストールして構成しました。

- Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle BI Discovererをインストールして構成しました。

- Oracle Portalの場合:

- ユーザーとグループを作成し、グループにページ・アクセス権限を割り当てました。

- 新しいページ・グループ、新しいテンプレートおよび新しいページを作成し、項目、ポートレットなどのコンテンツをページに追加しました。

- ページ、レイアウト、項目およびポートレットをカスタマイズしました。

- プロデューサ(データベース、WebおよびWSRP)を登録し、プロデューサからポートレットをカスタマイズしました。

- 外部アプリケーションを登録しました。

- Formsアプリケーションを設定しました。

- Oracle Reportsインスタンスを構成し、データベースへの接続を作成しました。

- Oracle BI Discovererの場合:

- Discoverer Plusの場合、パラメータ、計算、条件および合計を使用して新しいワークブックを作成しました。ワークブックを保存しました。

- Discoverer Viewerの場合、Discoverer Plusに作成されたワークブックを開き、フォーマット、並べ替え、エクスポートおよびドリルを実行しました。

- Discoverer Plus OLAPの場合、カスタム・メンバー、カスタム式および保存済の選択を使用してDiscoverer Plus OLAPに新しいワークブックを作成しました。ワークブックを保存しました。

- Viewer OLAPの場合、Discoverer Plus OLAPに作成されたワークブックを開き、エクスポート、レイアウトのリンクやリンク解除などの操作を実行しました。

21.4.9.1 Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle Business Intelligence Discovererの新しいターゲット環境への移行

この手順では、Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle Business Intelligence Discovererをソース環境にインストール済で、これらのコンポーネントを存在しないターゲット環境に移行する必要があると想定します。

この項ではコンポーネントすべてをターゲット環境に移行する方法について説明しますが、コンポーネントの一部のみを移行することも選択できます。

この環境を新しいターゲット環境に移行するには、次の作業を実行します。

- 作業1「データベース、Middlewareホームの移行および初期構成の実行」

- 作業2「Oracle Portalの新しいターゲット環境への移行」

- 作業3「Oracle Forms Servicesの新しいターゲット環境への移行」

- 作業4「Oracle Reportsの新しいターゲット環境への移行」

- 作業5「Oracle Business Intelligence Discovererの新しいターゲット環境への移行」

作業1   データベース、Middlewareホームの移行および初期構成の実行

データベースおよびMiddlewareホームを移行して初期構成を実行する手順は次のとおりです。

1. 第21.3.3項の説明に従って、データベースとスキーマを移行または作成します。

2. 第21.3.4項の説明に従って、Middlewareホームとバイナリ・ファイルを移行します。

3. Oracle Fusion Middleware Oracle Portal, Forms, Reports and Discovererインストレーション・ガイドの説明に従って、コンポーネントを構成します。Oracle Portalの場合、これには、Oracle Internet DirectoryおよびOracle Single Sign-Onリリース10.1.4.3のインストールが含まれます。
Oracle Portalの場合、「コンポーネントの構成」画面でOracle Internet Directoryへの接続の資格証明を指定します。

作業2   Oracle Portalの新しいターゲット環境への移行

Oracle Portalの構成を新しいターゲット環境に移行する手順は次のとおりです。

1. ソース・インスタンスに、移行するページ・グループのリストを含むトランスポート・セットを作成します。トランスポート・セットの作成の詳細は、『Oracle Fusion Middleware Oracle Portal管理者ガイド』のトランスポート・セットの作成に関する項を参照してください。

2. 『Oracle Fusion Middleware Oracle Portal管理者ガイド』のデータのエクスポートに関する説明に従って、ソース環境からデータをエクスポートします。

3. 『Oracle Fusion Middleware Oracle Portal管理者ガイド』のデータベース・リンクの作成に関する説明に従って、ターゲット環境で、ソース環境へのデータベース・リンクを作成します。

4. ソース・ポータルからデータを移行する前に、ポータルを登録する必要があります。登録すると、ソース・ポータルを選択し、トランスポート・セット内でデータソースを指定するために使用できるようになります。『Oracle Fusion Middleware Oracle Portal管理者ガイド』のソース・ポータルの登録に関する項を参照してください。

5. オブジェクトをインポートする前に、トランスポート・セットのコンテンツをターゲット・システムのトランスポート・セット表に移行する必要があります。これは、ステップ1で説明した登録済のデータベース・リンクを使用して、ソース環境からトランスポート・セットを取得することで実行します。トランスポート・セットの取得の詳細は、『Oracle Fusion Middleware Oracle Portal管理者ガイド』のデータのターゲット・システムへの移行に関する項を参照してください。

6. 『Oracle Fusion Middleware Oracle Portal管理者ガイド』のデータのインポートに関する項の説明に従って、データをインポートします。

7. 『Oracle Fusion Middleware Oracle Portal管理者ガイド』のユーザーとグループの移行に関する説明に従って、ソース環境のLDAPディレクトリからターゲット環境のLDAPディレクトリにユーザーとグループを移行します。

8. SSOMigユーティリティを使用して外部アプリケーション・リストをインポートします。

1. ソース環境においてエクスポート・モードでssomigを実行します。このコマンドは、ダンプ・ファイルを作成します。次に例を示します。

ssomig -export -s orasso -p orasso_schema_password
-c tns_alias_for_sso_schema
-log_d directory_where_dump_needs_to_be_created
-log_f ssomig.log -d ssomig.dmp

2. 前の手順で作成したダンプ・ファイルを指定して、ターゲット環境においてインポート・モードでssomigを実行します。次に例を示します。

ssomig -import -overwrite -s orasso -p orasso_schema_password
-c tns_alias_for_sso_schema -d ssomig.dmp
-log_d directory_where_dump_is_located -discoforce

9. 次の各ファイルについて、保持する必要があるすべてのカスタマイズをソース環境のファイルからターゲット環境のファイルにコピーします。

DOMAIN_HOME/config/fmwconfig/servers/WLS_PORTAL/applications/portal/configuration/portal_plsql.conf
DOMAIN_HOME/config/fmwconfig/servers/WLS_PORTAL/applications/portal/configuration/portal_dads.conf
DOMAIN_HOME/config/fmwconfig/servers/WLS_PORTAL/applications/portal/configuration/appConfig.xml

10. 構成ファイルを変更した場合、管理対象サーバーWLS_PORTALを再起動します。

Oracle Portalがエクスポートおよびインポートを使用してソースからターゲットに移行されると、ポートレットのカスタマイズがトランスポート・セットに含まれることに注意してください。追加の手順の必要はありません。

作業3   Oracle Forms Servicesの新しいターゲット環境への移行

Oracle Forms Servicesを新しいターゲット環境に移行する手順は次のとおりです。

1. 次のコマンドを使用して、Oracleインスタンス・プロセスとOracle Forms Services管理対象サーバーをターゲット環境で停止します。

ORACLE_INSTANCE/bin/opmnctl stopall
DOMAIN_NAME/bin/stopManagedWebLogic.sh
managed_server_name admin_url username password

2. Oracle Forms Servicesアプリケーション・ファイル(fmx、mmx、obxおよびplx)をソース環境からターゲット環境にコピーします。これらのファイルの場所は、Formsの環境構成ファイルであるdefault.envに指定されている場合があります。
ファイルが共有のネットワークの場所にある場合は、それらをターゲット環境にコピーする必要はありません。ネットワーク・パスが存在してターゲット環境にアクセスできることを確認します。

3. データベース移行ツールを使用して、アプリケーション関連データをソース環境からターゲット環境のデータベースに移行します。

4. 関連するターゲット・データベース・エントリをSQL*Net構成ファイルのtnsnames.oraで作成します。

5. Formsアプリケーションは、シングル・サインオン・ユーザー名およびパスワードをデータベース接続文字列にマップします。この情報は、Oracle Internet Directoryに格納されます。Forms RADデータをソース環境のOracle Internet Directoryからターゲット環境のOracle Internet Directoryに移行します。第21.4.1項の作業1「Oracle Internet Directoryの既存のターゲット環境への移行」のステップ3を参照してください。

6. 保持する必要がある次のファイルのすべてのカスタマイズをソース環境のファイルからターゲット環境のファイルにコピーします。

ファイルのタイプ

場所

Formsアプリケーション構成

DOMAIN_HOME/config/fmwconfig/servers/WLS_FORMS/applications/formsapp_version/config/formsweb.cfg

Formsサーバー構成

DOMAIN_HOME/config/fmwconfig/servers/WLS_FORMS/applications/formsapp_version/config/default.env

Forms HTMLテンプレート

ORACLE_INSTANCE/config/FormsComponent/forms/server/base.htm
ORACLE_INSTANCE/config/FormsComponent/forms/server/basejpi.htm

WebUtil構成

ORACLE_INSTANCE/config/FormsComponent/forms/server/webutil.cfg

WebUtil HTMLテンプレート

ORACLE_INSTANCE/config/FormsComponent/forms/server/webutiljpi.htm
ORACLE_INSTANCE/config/FormsComponent/forms/server/webutilbase.htm

Forms OHSディレクティブ構成

ORACLE_INSTANCE/config/OHS/OHS_name/moduleconf/forms.conf

7. Oracle HTTP Serverのforms.confファイルを変更した場合、Oracle HTTP Serverを再起動します。

ORACLE_INSTANCE/bin/opmnctl restartproc ias-component=ohs_name

8. 次のファイルをソース環境からターゲット環境にコピーします。

ファイルのタイプ

場所

Formsアプリケーション構成のクライアント側のダウンロード可能なプラガブル・コンテンツ

これらのファイルは、イメージなどのユーザー・カスタマイズであり、Webブラウザでアクセス可能な場所にあります。

Formsトレース構成

ORACLE_INSTANCE/config/FormsComponent/forms/server/ftrace.cfg

カスタマイズされたForms Java EEアプリケーションの.earファイル

ORACLE_HOME/forms/j2ee

JVMコントローラ構成

ORACLE_INSTANCE/config/FRComponent/frcommon/tools/jvm/jvmcontrollers.cfg

FMA構成

ORACLE_INSTANCE/config/FormsComponent/forms/search_replace.properties
ORACLE_INSTANCE/config/FormsComponent/forms/converter.properties

Formsユーティリティ固有構成ラッパー・シェル・スクリプト

UNIX:
ORACLE_INSTANCE/bin/frmbld.sh
ORACLE_INSTANCE/bin/frmcmp.sh
ORACLE_INSTANCE/bin/frmplsqlconv.sh
ORACLE_INSTANCE/bin/frmxmlsg.sh
ORACLE_INSTANCE/bin/frmcmp_batch.sh
ORACLE_INSTANCE/bin/frmf2xml.sh
ORACLE_INSTANCE/bin/frmxml2f.sh
ORACLE_INSTANCE/bin/frmxmlv.sh
Windows:
ORACLE_INSTANCE\bin\frmplsqlconv.bat
ORACLE_INSTANCE\bin\frmxmlsg.bat
ORACLE_INSTANCE\bin\frmf2xml.bat
ORACLE_INSTANCE\bin\frmxml2f.bat
ORACLE_INSTANCE\bin\frmxmlv.bat

Formsユーティリティ固有構成ラッパー・シェル・スクリプトの場合、OracleホームおよびOracleインスタンスをすべてターゲット環境用の詳細に置き換えます。

9. 次のコマンドを使用して、インスタンス内のコンポーネントを起動し、管理対象サーバーを起動します。

ORACLE_INSTANCE/bin/opmnctl startall
DOMAIN_NAME/bin/startManagedWebLogic.sh
managed_server_name admin_url

10. デフォルトのコンテキスト・ルートまたはFormsサーブレット別名をソース環境でオーバーライドした場合、カスタマイズされたForms EEアプリケーションのearファイルをターゲット環境にコピーして再デプロイします。Forms Java EEアプリケーションのカスタム・デプロイの詳細は、『Oracle Fusion Middleware Forms Servicesデプロイメント・ガイド』のHTTPリスナーとOracle WebLogic ServerによるOracle Forms Servicesの使用方法に関する項を参照してください。

作業4   Oracle Reportsの新しいターゲット環境への移行

Oracle Reportsをターゲット環境に移行する手順は次のとおりです。

1. 次のOracle Reports Server構成ファイルで、ソース環境で行われた変更をターゲット環境のファイルにマージします。ファイルには、OracleホームとOracleインスタンスの名前や場所、ポート番号など、環境固有の情報が含まれている可能性があるため、それらのファイルをソース環境からターゲット環境に単純にコピーすることはできないことに注意してください。

ファイルのタイプ

場所

Reportsスタンドアロン・サーバー構成

ORACLE_INSTANCE/config/ReportsServerComponent/server_name/rwserver.conf
ORACLE_INSTANCE/config/ReportsServerComponent/server_name/jdbcpds.conf
ORACLE_INSTANCE/config/ReportsServerComponent/server_name/xmlpds.conf
ORACLE_INSTANCE/config/ReportsServerComponent/server_name/textpds.conf
ORACLE_INSTANCE/config/ReportsServerComponent/server_name/rwnetwork.conf
ORACLE_INSTANCE/config/ReportsServerComponent/server_name/component-logs.xml
ORACLE_INSTANCE/config/ReportsServerComponent/server_name/logging.xml

Reportsインプロセス・サーバーおよびサーブレット構成

DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/cgicmd.dat
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/rwservlet.properties
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/rwserver.conf
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/jdbcpds.conf
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/xmlpds.conf
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/textpds.conf
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/rwnetwork.conf
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/logging.xml
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/logmetadata.xml
DOMAIN_HOME/config/fmwconfig/servers/server_name/applications/reports_version/configuration/jazn-data.xml

Reportsツール構成

ORACLE_INSTANCE/config/ReportsToolsComponent/ReportsTools/rwbuilder.conf
ORACLE_INSTANCE/config/ReportsToolsComponent/ReportsTools/rwnetwork.conf
ORACLE_INSTANCE/config/ReportsToolsComponent/ReportsTools/jdbcpds.conf
ORACLE_INSTANCE/config/ReportsToolsComponent/ReportsTools/xmlpds.conf
ORACLE_INSTANCE/config/ReportsToolsComponent/ReportsTools/textpds.conf
ORACLE_INSTANCE/config/ReportsToolsComponent/ReportsTools/component-logs.xml
ORACLE_INSTANCE/config/ReportsToolsComponent/ReportsTools/logging.xml

Reportsブリッジ構成

ORACLE_INSTANCE/config/ReportsBridgeComponent/bridge_name/rwbridge.conf
ORACLE_INSTANCE/config/ReportsBridgeComponent/bridge_name/rwnetwork.conf
ORACLE_INSTANCE/config/ReportsBridgeComponent/bridge_name/component-logs.xml
ORACLE_INSTANCE/config/ReportsBridgeComponent/bridge_name/logging.xml

Reportsシェル・スクリプト

(UNIX) ORACLE_INSTANCE/config/reports/bin/rw*.sh
(Windows) ORACLE_INSTANCE\config\reports\bin\rw*.bat
(UNIX) ORACLE_INSTANCE/config/reports/bin/reports.sh
(Windows) ORACLE_INSTANCE\config\reports\bin\reports.bat
(UNIX) ORACLE_INSTANCE/config/reports/bin/namingservice.sh
(Windows) ORACLE_INSTANCE\config\reports\bin\namingservice.bat

2. Oracle Reports Server構成ファイルに関連する次のOracle Fusion Middleware構成ファイルで、ソース環境で行われた変更をターゲット環境のファイルにマージします。ファイルには、OracleホームとOracleインスタンスの名前や場所、ポート番号など、環境固有の情報が含まれている可能性があるため、それらのファイルをソース環境からターゲット環境に単純にコピーすることはできないことに注意してください。

ファイルのタイプ

場所

JPS構成

DOMAIN_HOME/config/fmwconfig/jps-config.xml
DOMAIN_HOME/config/fmwconfig/jps-config-jse.xml
DOMAIN_HOME/config/fmwconfig/system-jazn-data.xml

Forms構成ファイルおよびReports構成ファイル

Font setup, aliasing, subsetting, embedding:
ORACLE_INSTANCE/config/FRComponent/frcommon/guicommon/tk/admin/uifont.ali
Printer configuration (UNIX only):
ORACLE_INSTANCE/config/FRComponent/frcommon/guicommon/tk/admin/uiprint.txt
Toolkit configuration, encoding (UNIX only):
ORACLE_INSTANCE/config/FRComponent/frcommon/guicommon/tk/admin/Tk2Motif.rgb
PPD files (UNIX only):
ORACLE_INSTANCE/config/FRComponent/frcommon/guicommon//tk/admin/PPD/*
AFM files (UNIX only):
ORACLE_INSTANCE/config/FRComponent/frcommon/guicommon/tk/admin/AFM/*

3. ソース環境に追加のOracle Reports Serverコンポーネント・インスタンスを作成した場合、opmnctlを使用してそれらをターゲット環境に作成します。

4. Oracle Reports Serverに関連するリソースに対して、次のアクションを実行します。

- ソース環境で使用するすべてのフォントを環境変数REPORTS_FONT_DIRECTORYで指定されたディレクトリからターゲット環境にコピーします。デフォルトでは、フォントはORACLE_INSTANCE/reports/fontsにあります。

- Common UNIX Printing System(CUPS)印刷構成をターゲット環境に移行します(該当する場合)。
Oracle ReportsでのCUPSの使用方法の詳細は、『Oracle Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイド』のCUPSを使用したLinuxでの拡張印刷に関する項を参照してください。

5. Reports定義ファイルおよびデータ表に対して、次のアクションを実行します。

- ソース環境で使用されるレポート・ファイル(RDFファイル、JSPファイル、REPファイル、XMLファイルなど)をターゲット環境にコピーします。

- JSP Webレポートをターゲット環境の次の場所にデプロイします。

DOMAIN_HOME/servers/WLS_REPORTS/tmp/_WL_user/reports_version/uxabaw/web.war

- データベース移行ツール(Oracle Databaseのエクスポート・ユーティリティやインポート・ユーティリティなど)を使用して、RDFファイル内で参照されるReports固有のデータ表をターゲット環境のデータベースに移行します。

6. Reportsのジョブ関連の構成ファイルに対して、次のアクションを実行します。

- Reportsサーバーのキャッシュ・ファイルをターゲット環境の次の場所にコピーします。

ORACLE_INSTANCE/reports/cache

- Reportsのスケジュール済ジョブ情報に関して、サーバー・データ(server_name.dat)ファイルをターゲット環境の次の場所にコピーします。

ORACLE_INSTANCE/reports/server

サーバー名は作成時に自動的に生成され、.datファイルにはサーバー名付きの名前を付けられるため、.datファイルの名前は、ソース環境とターゲット環境で異なることに注意してください。スタンドアロン・サーバーかインプロセス・サーバーかに応じて、ファイル名は次の形式のいずれかになります。

ReportsServer_hostname_instanceName
rep_wls_reports_hostname_instanceName

ターゲット環境のホスト名およびOracleインスタンス名を反映するようにファイル名を変更します。

7. ジョブ・リポジトリまたはジョブ・ステータス・リポジトリがデータベースで構成されている場合、ターゲット環境のデータベースに同じスキーマを作成し、データを移行する必要があります。

1. 次のスクリプトを使用します。

ORACLE_HOME/reports/admin/sql/rw_job_repos.sql

2. データベース移行ツール(Oracle Databaseのエクスポート・ユーティリティやインポート・ユーティリティなど)を使用して、スキーマRW_JOBS、RW_SERVER_JOB_QUEUEおよびRW_SERVER_QUEUEのソース・データベースのデータをターゲット・データベースに移行します。

8. ユーザーおよびレポート・サーバーのセキュリティ・ポリシー情報を移行します。『Oracle Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイド』のOracle Reportsの保護に関する項を参照してください。

9. アイデンティティ・ストアおよびポリシー・ストアとしてOracle Internet Directoryを使用する場合は、Forms RADデータをソース環境のOracle Internet Directoryからターゲット環境のOracle Internet Directoryに移行します。第21.4.1項の作業1「Oracle Internet Directoryの既存のターゲット環境への移行」のステップ3を参照してください。

10. ソース環境でJAZN-XMLベースのアイデンティティおよびポリシー・ストアを使用している場合は、それらをターゲット環境のLDAPに移行します。『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』のコマンドmigrateSecurityStoreを使用したポリシーの移行に関する項に説明されているとおり、WLSTコマンドmigrateSecurityStoreを使用することができます。

11. 『Oracle Fusion Middlewareアプリケーション・セキュリティ・ガイド』の資格証明の手動移行に関する説明に従って、スクリプトmigrateSecurityStoreを使用して資格証明ストアを移行します。

12. データベース・クローニング・ツールを使用して、任意のデータベース・プロキシ・ユーザーをターゲット・データベースに移行します。

13. Reportsプラグインが登録されている場合、対応する.jarファイルをターゲット環境にコピーし、これらのファイルへのパスを環境変数REPORTS_CLASSPATHに追加します。

作業5   Oracle Business Intelligence Discovererの新しいターゲット環境への移行

Oracle BI Discovererを新しいターゲット環境に移行する手順は次のとおりです。

1. デフォルトのユーザー・プリファレンスを変更した場合、次のファイルをソース環境からターゲット環境にコピーします。

ORACLE_INSTANCE/config/PreferenceServer/disco-comp-name/.reg_key.dc
ORACLE_INSTANCE/config/PreferenceServer/disco-comp-name/pref.txt
ORACLE_INSTANCE/config/PreferenceServer/disco-comp-name/defaults.txt

2. Oracle BI Discovererの設定を変更した場合、次のファイルをソース環境からターゲット環境にコピーします。

DOMAIN_HOME/config/fmwconfig/servers/WLS_DISCO/applications/discoverer_version/configuration/configuration.xml
DOMAIN_HOMEconfig/fmwconfig/servers/WLS_DISCO/applications/discoverer_version/configuration/configuration-preview.xml

configuration.xmlファイルで、次の要素の値をターゲット環境を反映するように変更します。

- applicationURL

- oracleInstance

- discovererComponentName

3. サーバー構成ファイルを変更した場合、次のファイルをソース環境からターゲット環境にコピーします。

ORACLE_INSTANCE/config/OPMN/opmn/opmn.xml

4. 次のファイルをソース環境からターゲット環境にコピーします。

ORACLE_INSTANCE/config/OHS/ohs_name/moduleconf/module_disco.conf

ファイルで、次の要素の値をターゲット環境を反映するように変更します。

- WebLogicCluster。クラスタが存在する場合のみ有効です。

- WebLogicHost

- WebLogicPort

5. 次のファイルをソース環境からターゲット環境にコピーします。

DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/f6k79t/configuration/styles/base-descktop.xss
DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/f6k79t/configuration/styles/blstyles.xss
DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/f6k79t/configuration/styles/blaf.xss
DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/f6k79t/configuration/styles/dc-blaf-preview.xsd
DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/f6k79t/configuration/styles/dc-blaf-preview.xss
DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/f6k79t/configuration/styles/dc-blaf.xsd
DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/f6k79t/configuration/styles/dc-blaf.xss
minimal-desktop.xss
DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/f6k79t/configuration/styles/minimal-pda.xss
DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/f6k79t/configuration/styles/oracle-desktop.xss
DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/f6k79t/configuration/styles/oracle-pda.xss
DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/f6k79t/configuration/styles/pocketPC.xss
DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/f6k79t/configuration/styles/simple-desktop.xss
DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/f6k79t/configuration/styles/swan-desktop.xss
DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/f6k79t/configuration/styles/version.txt

6. 使用するファイルに応じて、次のディレクトリのファイルの一部またはすべてをコピーします。

DOMAIN_HOME/servers/WLS_DISCO/tmp/_WL_user/discoverer_version/51oeh7/war/custom_logos

使用されるファイルは、configuration.xmlファイルにリストされます。

7. 同じデータベース・サービスのエントリを使用するには、次のファイルをソース環境からターゲット環境にコピーします。

ORACLE_HOME/network/admin/tnsnames.ora

8. DISCOVERERスキーマをソース環境からターゲット環境に移行します。Oracle Databaseのエクスポート・ユーティリティおよびインポート・ユーティリティを使用してスキーマを移行できます。
ソースとターゲットで同じデータベースを使用する場合は、データを移行する必要はありません。

9. EULデータをソース環境からターゲット環境に移行します。

1. ターゲット・データベースでEULユーザーおよび空のEULを作成します。Oracle Fusion Middleware Oracle Business Intelligence Discoverer管理者ガイドの新しいデータベース・ユーザーにおけるEnd User Layerの作成方法に関する項を参照してください。

2. Discoverer Administratorを使用してEULスキーマをソース・データベースからエクスポートしてターゲット環境のデータベースにインポートすることにより、EULスキーマをソース・データベースから移行します。詳細は、Oracle Fusion Middleware Oracle Business Intelligence Discoverer管理者ガイドのDiscovererのエクスポート・ウィザードおよびインポート・ウィザードの使用に関する項を参照してください。

3. eul5_id.sqlスクリプトを実行して新しいEULに一意の参照番号を付けます。その後、Discovererのエンド・ユーザー・コミュニティ全体にEULへのアクセス権を付与します。このスクリプトは、次の場所にあります。

ORACLE_ HOME/discoverer/util/eul5_id.sql

詳細は、Oracle Fusion Middleware Oracle Business Intelligence Discoverer管理者ガイドのEnd User Layerの作成と保守に関する項を参照してください。

10. カタログ・データをソース環境からターゲット環境に移行します。

1. 次のコマンドを使用して、カタログをターゲットのOLAPデータベースにインストールします。

java -classpath d4o.jar oracle.dss.d4o.administration.D4OCommand install
-h hostname -po port -sid sid -su "sys as sysdba"
-sp password -p d4osys-password -t users

2. 次のコマンドを使用して、ターゲットのOLAPデータベースのユーザーを承認します。

java -classpath d4o.jar oracle.dss.d4o.administration.D4OCommand
authorize -h hostname -po port -sid sid -p d4osys-password -u user

3. OLAPコマンド・ユーティリティを使用して、Discovererカタログをソース・データベースからエクスポートし、ターゲット環境のデータベースにインポートします。詳細は、Oracle Fusion Middleware Oracle Business Intelligence Discoverer構成ガイドのDiscoverer Plus OLAPコマンドライン・ユーティリティを使用したDiscovererカタログの管理に関する項を参照してください。

11. ポートレット・データをソースのDiscovererメタデータ・リポジトリからターゲットのDiscovererメタデータ・リポジトリに移行します。

1. Oracle Databaseのエクスポート・ユーティリティおよびインポート・ユーティリティを使用します。
インポートを複数回実行して、親表が子表の前に移入されるようにする必要がある場合があります。SQLエラーを回避するには、PTM5_PARTITION、PTM5_PORTLET、PTM5_VERSION、PTM5_INSTANCE、PTM5_SCHEDULE、PTM5_CACHE、PTM5_CUSTOMINFOという順序で実行する必要があります。

2. 新しいターゲット設定を指すように、PortalのPortlet Provider URLを変更します。

12. PStoreデータを移行します。

1. デフォルトの暗号化鍵を表WWSSO_PS_CONFIGURATION_INFO_Tから削除します。

2. Oracle Databaseのエクスポート・ユーティリティおよびインポート・ユーティリティを使用して、Discovererメタデータ・リポジトリのPStoreデータを移行します。
ターゲット環境のユーザー名およびスキーマ名は、ソース環境と同じである必要があります。

21.4.9.2 Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle Business Intelligence Discovererの既存のターゲット環境への移行

この手順では、Oracle Portal、Oracle Forms Services、Oracle ReportsおよびOracle Business Intelligence Discovererをソース環境にインストール済で、これらのコンポーネントを既存のターゲット環境に移行する必要があると想定します。

既存のターゲット環境に移行するには、次の作業を実行します。

- 作業1「Oracle Portalの既存のターゲット環境への移行」

- 作業2「Oracle Forms Servicesの既存のターゲット環境への移行」

- 作業3「Oracle Reportsの既存のターゲット環境への移行」

- 作業4「Oracle Business Intelligence Discovererの既存のターゲット環境への移行」

作業1   Oracle Portalの既存のターゲット環境への移行

この手順では、ソース環境でOracle Portalに対して変更(ページの追加、ページへのコンテンツの追加、新しいユーザーおよびグループの作成、新しいユーザーおよびグループへの新しく作成したページへのページ・アクセス権限の割当てなど)を行ったことを想定します。

Oracle Portalを既存のターゲット環境に移行するには、第21.4.9.1項の作業2「Oracle Portalの新しいターゲット環境への移行」の説明に従って、各手順を実行します。

作業2   Oracle Forms Servicesの既存のターゲット環境への移行

Oracle Forms Servicesを既存のターゲット環境に移行する手順は次のとおりです。

1. Oracle Forms Servicesアプリケーション・ファイル(FMX、MMXおよびPLX)をソース環境からターゲット環境にコピーします。これらのファイルの場所は、Formsの環境構成ファイルであるdefault.envに指定されている場合があります。
ファイルが共有のネットワークの場所にある場合は、それらをターゲット環境にコピーする必要はありません。かわりに、その場所をdefault.envファイルに追加します。

2. 『Oracle Fusion Middleware Forms Servicesデプロイメント・ガイド』のアプリケーションのデプロイに関する項の説明に従って、必要な構成変更を行います。

3. コンポーネントを再起動します。

ORACLE_INSTANCE/bin/opmnctl stopall
ORACLE_INSTANCE/bin/opmnctl startall

作業3   Oracle Reportsの既存のターゲット環境への移行

Oracle Reportsを既存のターゲット環境に移行するには、第21.4.9.1項の作業4「Oracle Reportsの新しいターゲット環境への移行」の説明に従って、同様に手順を実行します。

作業4   Oracle Business Intelligence Discovererの既存のターゲット環境への移行

この手順では、ターゲット環境のパフォーマンスを悪化させずに、最初にソース環境を使用してビジネス領域を開発するためのEULを作成することを想定しています。

Oracle BI Discovererを既存のターゲット環境に移行する手順は次のとおりです。

1. 第21.4.9.1項の作業5「Oracle Business Intelligence Discovererの新しいターゲット環境への移行」のステップ1および5に示されている構成ファイルを移行します。

2. DISCOVERERスキーマをソース環境からターゲット環境に移行します。Oracle Databaseのエクスポート・ユーティリティおよびインポート・ユーティリティを使用してスキーマを移行できます。
ソースとターゲットで同じデータベースを使用する場合は、データを移行する必要はありません。

3. Oracle Databaseのエクスポート・ユーティリティおよびインポート・ユーティリティを使用してEULスキーマをソース・データベースからエクスポートしてターゲット環境のデータベースにインポートすることにより、EULスキーマをソース環境からターゲット環境に移行します。
ターゲット環境のユーザー名およびスキーマ名は、ソース環境と同じである必要があります。

21.4.10 Oracle Data Integratorのターゲット環境への移行

次の各項目では、Oracle Data Integratorをソース環境からターゲット環境に移行する方法について説明します。

- Oracle Data Integratorの新しいターゲット環境への移行

- Oracle Data Integratorの既存のターゲット環境への移行

いずれの場合も、ソース環境で次の操作を実行済です。

- Oracle WebLogic Serverをインストールし、JavaコンポーネントのMiddlewareホームを作成しました。

- RCUを使用してソース環境で必要なスキーマを作成しました。『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。

- Oracle Data Integratorをインストールしました。

- 構成ウィザードを使用して、Oracle Data Integrator Javaコンポーネントを構成してデプロイしました。Javaコンポーネントは、ソース・リポジトリに接続し、ソース・リポジトリを使用できます。

- ソース環境は、Oracle WebLogic ServerのOracle Data Integratorエージェントに関して完全に動作し、作業リポジトリがある必要があります。

21.4.10.1 Oracle Data Integratorの新しいターゲット環境への移行

この手順では、Oracle Data Integratorがソース環境にインストール済で、これをまだ存在しないターゲット環境に移行する必要があると想定します。

Oracle Data Integratorを新しいターゲット環境に移行するには、次の作業を実行します。

- 作業1「データベース、Middlewareホームの移行および初期構成の実行」

- 作業2「ターゲット環境の設定の確認」

- 作業3「ターゲット環境でのJava EEエージェントの再起動」

作業1   データベース、Middlewareホームの移行および初期構成の実行

データベースおよびMiddlewareホームを移行して、ターゲット環境で初期構成を実行する手順は次のとおりです。

1. RCUを使用して、ターゲット・データベースで必要なマスター・リポジトリおよび作業リポジトリのスキーマを作成します。『Oracle Fusion Middleware Repository Creation Utilityユーザーズ・ガイド』を参照してください。
ターゲット環境の作業リポジトリとマスター・リポジトリの両方が、それぞれ組織全体で一意のIDで作成されていることを確認します(これには、開発リポジトリとソース・リポジトリも含まれます)。さらに、ターゲットの作業リポジトリが、ソース・リポジトリと同じタイプで作成されていることを確認します(たとえば、ソースの作業リポジトリが開発リポジトリとして作成されている場合、ターゲットの作業リポジトリも開発リポジトリとして作成される必要があります)。

2. 第21.3.5項の説明に従って、copyConfigおよびpasteConfigスクリプトを使用して、Oracle Data Integratorの構成およびそのリポジトリをソース環境からターゲット環境に移行します。
copyConfigスクリプトを実行する場合は、次に注意してください。

- copyConfigスクリプトに構成ファイルを渡す必要があります。これを渡すには、-additionalParamsオプションを使用します。次に例を示します。

./copyConfig.sh -javaHome /private/Middleware/jrockit_160_26_D1.2.0-5
-archiveLocation /tmp/ar.jar
-sourceMWHomeLoc /private/Middleware
-sourceDomainLoc /scratch/oracle/config/domains/base_domain
-domainHostName host1.example.com
-domainPortNo 7001
-domainAdminUserName weblogic
-domainAdminPasswordFile /tmp/wls_pswd.txt
-additionalParams odiCustomArg=/private/t2p/odiCustomArg.xml

ファイルodiCustomArg.xmlは構成ファイルです。サンプル・ファイルが次の場所にあります。

MW_HOME/ODI_Oracle_Home/clone/provision/odiCustomArg.xml

- スクリプトに渡す構成ファイルには、すべてのOracle Data Integratorマスター・リポジトリの接続情報が含まれています。構成ファイルのサンプルを次に示します。

<?xml version="1.0" encoding="UTF-8" ?>
<config>
<jps-config-path>/ODI_HOMEoracledi/client/odi/bin/odi-jps-config-jse.xml</jps-config-path>
<masterRepositories>
<masterRepository>
<driver>oracle.jdbc.OracleDriver</driver>
<url>jdbc:oracle:thin:@localhost:1521:sid/example.com</url>
<schema>odi_master_11g</schema>
<schema_password_file>/tmp/all_pswd.txt</schema_password_file>
<supervisor>SUPERVISOR</supervisor>
<supervisor_password_file>/tmp/sup_pswd.txt</supervisor_password_file>
</masterRepository>
<masterRepository>
.....content for 2nd master repository
</masterRepository>
</masterRepositories>
</config>

前述の例はjps-configファイルのデフォルトの場所を示しています。ODI Studioに接続するために使用するファイルのバージョンがある場合は、そのファイルの場所を使用できます。または、次の場所にあるjps-configファイルを使用することもできますが、この場合、LDAPエントリを構成し、ファイルのデフォルト・セクションを非コメント化する必要があります。

ODI_DOMAIN_HOME/config/fmwconfig/jps-config-jse.xml

構成を移行すると、pasteConfigスクリプトによって、管理サーバーおよび管理対象サーバーを含むドメインの構成がコピーされます。

作業2   ターゲット環境の設定の確認

移行スクリプトによって、移動計画で指定した情報に基づき、ターゲット環境の物理アーキテクチャが更新されます。ターゲット環境の物理アーキテクチャの次の項目を確認してから、次に進みます。

- 物理エージェント: ホスト、ポートおよびWebアプリケーション・コンテキスト(Java EEエージェント用)を、ターゲット環境の構成と一致するように変更します。

- データ・サーバー: データ・サーバーの接続に関する情報(JDBC、JNDI、データソース名)を、ターゲット環境の構成と一致するように変更します。

- 物理スキーマ: データ・サーバー用に定義されたスキーマ(ファイル・フォルダの場所を含みます)は、ターゲット環境の構成と一致している必要があります。

作業3   ターゲット環境でのJava EEエージェントの再起動

ターゲット環境のJava EEエージェントを再起動します。これらのエージェントは、スケジュール済シナリオの処理を開始します。

21.4.10.2 Oracle Data Integratorの既存のターゲット環境への移行

この手順では、ソース環境に多数の新しいシナリオまたは再生成されたシナリオがあり、これらをすでに存在しているターゲット環境に移行する必要があると想定します。

移行スクリプトは、ターゲット環境に対する繰返し実行をサポートします。ターゲット環境を最新のソース環境で上書きするには、第21.4.10.1項の処理を実行しますが、次のいずれかのアクションを実行します。

- リポジトリが内部認証モードの場合は、移動計画にスーパーバイザ・パスワードを指定してからpasteConfigスクリプトを実行します。

- リポジトリが外部認証モードの場合は、内部認証モードに変更し、移動計画にスーパーバイザ・パスワードを指定してからpasteConfigスクリプトを実行します。

21.5 マルチホスト環境への移行またはマルチホスト環境からの移行に関する考慮事項

ドメイン・ディレクトリは各マシンに対してローカルです。pasteConfigスクリプトは管理サーバー・ドメイン・ディレクトリでのみ実行されます。その後、管理対象サーバーのディレクトリが管理サーバーと異なる場合は、Oracle WebLogic Serverのpackおよびunpackコマンドを使用して、管理対象サーバーのドメイン・ディレクトリを再作成する必要があります。次の手順を実行します。

1. 第21.3.1項から第21.3.4項までの手順を実行します。

2. 第21.3.5項の説明に従って、管理サーバーが含まれるホスト上でcopyConfigおよびextractMovePlanスクリプトを実行します。

3. 第21.3.5項の説明に従って、管理サーバーのターゲット・ホスト上でpasteConfigスクリプトを実行します。

4. ターゲット管理サーバー・ホスト上で、別のホスト上にある管理対象サーバーに対して、packコマンドを起動します(管理モードで)。

5. 管理対象サーバーに対するターゲット・ホスト上で、unpackコマンドを起動します。

packとunpackの詳細は、『Oracle Fusion Middleware PackおよびUnpackコマンドによるテンプレートとドメインの作成』を参照してください。

21.6 Oracle RAC環境への移行またはOracle RAC環境からの移行に関する考慮事項

Oracle Real Application Cluster (Oracle RAC)環境に、またはOracle Real Application Cluster (Oracle RAC)環境から環境を移行している場合は、次の点に注意してください。

- Oracle RAC環境ではないソース環境から、Oracle RACを使用するターゲット環境に移行している場合、移行計画には、汎用データソースの1つのエントリ(mds-soaなど)があります。Oracle RACインスタンスの1つを指すように移行計画を更新し、ソース環境からターゲット環境への移行を完了します。
そして、『Oracle Fusion Middleware高可用性ガイド』(特に可用性の高いOracleデータベース・アクセスの考慮事項に関する説明)に従って、Oracle RAC用にターゲット環境を構成します。

- 移行計画にリストされていない場合でも、複数のデータソースがターゲット環境に移行されます。

- Oracle RAC環境を使用するソース環境から、Oracle RACを使用しないターゲット環境に移行している場合、移行計画には、汎用データソースの複数のエントリがあります。たとえば、4つのOracle RACインスタンスがある場合、mds-soa-rac1からmds-soa-rac4までの名前を持つ4つの汎用データソースがあります。すべての汎用データソースがターゲット環境のRAC以外の単一インスタンスを指すように、移行計画を更新します。

- Oracle RACを使用するソース環境から、Oracle RACを使用するターゲット環境に移行しているが、ターゲット環境にそれ以外のOracle RACインスタンスがある場合、移行計画には、汎用データソースで複数のエントリがあります。たとえば、ソース環境に3つのOracle RACインスタンスがある場合、mds-soa-rac1からmds-soa-rac3までの名前を持つ3つの汎用データソースがあります。ターゲット環境に、4つのOracle RACインスタンスがあります。汎用データソースがターゲット環境の最初の3つのデータソースを指すように、移行計画を更新します。

- Oracle RACを使用するソース環境から、Oracle RACを使用するターゲット環境に移行しているが、ターゲット環境にそれ以外のOracle RACインスタンスが少ない場合、移行計画には、汎用データソースで複数のエントリがあります。たとえば、ソース環境に4つのOracle RACインスタンスがある場合、mds-soa-rac1からmds-soa-rac4までの名前を持つ4つの汎用データソースがあります。ターゲット環境に、3つのOracle RACインスタンスがあります。最初の3つの汎用データソースがターゲット環境の3つのデータソースを指すように、移動計画を更新します。最後の汎用データソースは、3つ目の汎用データソースを指すようにします。(3つ目のOracle RACインスタンスにはmds-soa-rac3およびmds-soa-rac4が含まれます)。
第10.2.2.1項の説明に従って、データソースを追加できます。

21.7 ソース環境からターゲット環境への移行に関する制限事項

次の制限事項に注意してください。

- ターゲット環境は、ソース環境と同じオペレーティング・システム上にある必要があります。また、オペレーティング・システム・アーキテクチャは、両方の環境で同じでなければなりません。たとえば、両方の環境で32ビットのオペレーティング・システムまたは64ビットのオペレーティング・システムを実行している必要があります。

- ターゲット環境では、ソース環境のユーザーと同じスーパーユーザーまたは管理ユーザーが必要です。ユーザーのパスワードは、外部のLDAPを使用する場合に別々にでき、pasteConfigスクリプトを使用する際にコマンドラインで指定できます。インストールの移行が完了したら、ターゲット環境でユーザーを変更できます。

- ソース環境とターゲット環境は、同じエンコーディングを使用している必要があります。たとえば、ソース環境がja_JP.utf8ロケール・エンコーディングを使用しており、ターゲット環境がja_JPロケール・エンコーディングを使用している場合、ターゲットで一部のファイル名が正しく処理されない可能性があります。

- コンポーネントの構成を移行すると、スクリプトによりソースのトポロジがレプリケートされます。たとえば、ソース・ドメインにホストAの管理対象サーバーserver_1とserver_2、およびホストBの管理対象サーバーserver_3とserver_4が含まれる場合、ターゲットにも同様の管理対象サーバーとホストの関係を指定する必要があります。(移動計画のそれぞれの管理対象サーバーに対してホストを指定します。)

- MiddlewareホームのすべてのOracleホームは、同じOracleインベントリに登録されている必要があります。複数のコンポーネントを1つのMiddlewareホームにインストールしているが、使用しているOracleインベントリの場所が様々である場合は、スクリプトで一部のOracleホームを検出できません。

- config.xmlファイルで、ソースOracle WebLogic Serverマシンがunix-machineTypeとして指定されていると、copyConfigスクリプトはエラーCLONE-20408で失敗します。この問題に対処する手順は、次のとおりです。

1. 管理サーバーを停止します。

2. ソース環境の次のファイルでマシン・タイプを変更します。

DOMAIN_HOME/config/config.xml

ファイルの次の行で、「xsi:type="unix-machineType"」を削除します。

<machine xsi:type="unix-machineType">
<name>machine_name</name>

次に例を示します。

<machine>
<name>machine_name</name>

3. 第4.2.2項の説明に従って、管理サーバーを再起動します。

- カスタム・アプリケーションで内部データソースを使用する場合(たとえば、JDeveloperを使用してアプリケーションが作成され、内部データソースとともにデプロイされている場合など)、pasteConfig操作では内部データソースは移行されません。
この問題を解決するには、ドメインに外部データソースを作成し、アプリケーションでそのデータソースを使用するように変更して、アプリケーションを再度デプロイします。

- Oracle Fusion MiddlewareがインストールされていないホストにMiddlewareホームのアーカイブを適用する場合は、そのホストにJDK 1.6.04以降がインストールされている必要があります。さらに、PATH、CLASSPATHおよびJAVA_HOME環境変数がJDKを指している必要があります。

- ソースMiddlewareホームで、Middlewareホームの外部にあるJDKを使用する場合、pasteBinary操作でも外部のJDKを使用する必要があります。

- ソースとターゲットで使用されているJDKが同じである必要があります。たとえば、ソースでJRockitを使用している場合は、ターゲットでもJRockitを使用する必要があります。

- エンティティを移行する際に一時ディレクトリに十分な領域がない場合は、その旨を示すエラーが返されます。この問題が発生しないようにするには、第20.2項で説明しているように、T2P_JAVA_OPTIONS環境変数を使用して、一時ディレクトリとして別の場所を指定します。

- pasteBinaryスクリプトを使用してWeb層インストールを移行すると、次のエラーが表示される場合があります。

SEVERE : Jun 14, 2011 12:35:27 AM - SEVERE - CLONE-20901  Unable to restorepermission of a few files of the Oracle home

ファイルが必要ないため、このメッセージは無視できます。

- 環境を移行し、カスタム・インベントリの場所を使用して(invPtrLocパラメータを指定して)pasteBinaryスクリプトを実行した場合に、ターゲット環境をアップグレードするには、次のいずれかの引数を指定してrunInstallerを起動する必要があります。

-invPtrLoc custom_inventory_pointer_location
-invPtrLoc oracle_common/oraInst.loc

- Oracleでは、移行スクリプトを使用した、または手動でのOracle Identity Managerの移行はサポートしていません。また、Oracle Identity Managerが他のコンポーネントのソース環境の一部である場合は、その環境に対する移行スクリプトは失敗します。

21.8 テストから本番への移行におけるエラーのリカバリ

pasteBinaryまたはpasteConfigスクリプトを実行して移動計画に不正な情報を入力すると、スクリプトはエラーを返します。場合によっては、貼付け操作が部分的に実行されていることもあります。リカバリするには、エラーを返したスクリプトに応じて、次の処理を実行します。

- Windowsで、Sun JDKを使用すると、copyBinary、pasteBinary、copyConfigまたはpasteConfigの操作が次のエラーで失敗する場合があります。

java.nio.channels.OverlappingFileLockException

この場合、T2P_JAVA_OPTIONSを使用して、システム・プロパティのsun.nio.ch.disableSystemWideOverlappingFileLockCheckを設定します。次に例を示します。

set T2P_JAVA_OPTIONS=
-Dsun.nio.ch.disableSystemWideOverlappingFileLockCheck=true

操作を再試行してください。

- ターゲットで、Middlewareホーム・ディレクトリの移行中に、pasteBinaryスクリプトでエラーが返された場合は、次の手順を実行します。

1. ターゲットのMiddlewareホームを削除します。

2. OracleインベントリにOracleホーム・エントリが存在する場合、それを削除します。

3. Windowsでは、MiddlewareホームおよびOracleホームのショートカットを削除します。

- copyConfigスクリプトでは、ディレクトリが変更されないように、すべてのサーバーが実行中であり、アイドルである必要があります。サーバーがアイドルではない場合、copyConfigスクリプトはクローニング操作が正常に完了したことを報告し、copyConfigエラー・ログ・ファイルが0バイトのままとなります。ただし、copyConfig標準ログ・ファイルには、packed_domain.jarへの書込みに関するエラーが含まれます。このエラーによって、pasteConfigプロセスが失敗します。
この問題を回避するには、少しの間待機して、copyConfig操作を再試行します。

- Javaコンポーネントの移行中に、pasteConfigスクリプトでエラーが返された場合は、次の手順を実行します。

1. ドメインに関連するすべてのプロセスを停止します。

2. 次のディレクトリを削除します。

MW_HOME/user_projects/domains/domain_name
MW_HOME/user_projects/applications/domain_name

3. スキーマを削除して、RCUを使用してそれらを再作成します。

また、Oracle Platform Securityの再割当てが失敗した場合、次の処理を実行します。

- LDAPストアでは、ドメイン・ノードを削除するか移動計画で別の値を指定します。

- データベースベース・ストアでは、スキーマを削除しRCUを使用してそれを再作成します。

- システム・コンポーネントの移行中に、pasteConfigスクリプトでエラーが返された場合は、次の手順を実行します。

1. インスタンスを削除します。

2. インスタンスを削除できない場合、そのインスタンスに関連するすべてのプロセスを停止してOracleインスタンスを削除します。

- config.xmlファイルで、マシンがunix-machineTypeとして指定されていると、pasteConfigスクリプトはエラーCLONE-20408で失敗します。この問題を回避するには、次のファイルでマシン・タイプを変更します。

DOMAIN_HOME/config/config.xml

ファイルの次の行で、「xsi:type="unix-machineType"」を削除します。

<machine xsi:type="unix-machineType">
<name>machine_name</name>

次に例を示します。

<machine>
<name>machine_name</name>

- pasteConfigスクリプトを使用しているときにメモリー不足エラーが発生した場合は、次のいずれかの方法でこのエラーを回避できます。

- JVMヒープ・サイズを拡張します。最大ヒープ・サイズにオプション-Xmxを、初期ヒープ・サイズに-Xmsを使用します。次に例を示します。

CONFIG_JVM_ARGS="-Xms512m -Xmx1024m"

- 多くの場合、Oracle WebLogic Serverドメインのディレクトリ構造には、不要な大容量ファイル(大容量の古いログ・ファイルなど)が含まれています。これらのファイルを削除してから、copyConfigおよびpasteConfigスクリプトを再度実行します。

- Oracle SOA SuiteインストールでcopyConfigスクリプトを使用した際に次のエラーが表示された場合、T2P_JAVA_OPTIONS環境変数を使用して、メッセージのサイズを大きくします。

weblogic.socket.MaxMessageSizeExceededException: Incoming message of size:
'10000080' bytes exceeds the configured maximum of: '10000000' bytes for
protocol: 't3'.

第20.2項に従ってT2P_JAVA_OPTIONS環境変数を使用し、-Dweblogic.MaxMessageSize=20000000プロパティをcopyConfigとpasteConfigの両方のスクリプトに渡します。

- pasteConfig操作を使用する際に、Oracle B2Bインバウンド/アウトバウンド・ディスパッチャが構成されていると、次のエラーが表示される場合があります。

oracle.mds.exception.MDSRuntimeException: java.sql.SQLException: Data Source
mds-soa does not exist.
Data Source mds-soa does not exist.

この状況では、失敗後に管理対象サーバーのプロセスを強制終了し、手動で管理対象サーバーを再起動します。

- Oracle SOA Suite管理対象サーバーを起動しようとしてエラーが発生した場合は、pasteConfigスクリプトの実行後に管理コンソールを使用して、システム・パラメータを変更する必要があります。(これらのシステム・パラメータには、pasteConfigスクリプトによって一時的な値が設定されます。)

1. Oracle WebLogic Server管理コンソールにログインします。

2. 「ドメイン構造」ウィンドウで、「環境」を開きます。

3. 「サーバー」をクリックします。「サーバーのサマリー」ページが表示されます。

4. サーバーを選択します。

5. 「サーバーの起動」タブを選択します。

6. 「引数」フィールドで、次のパラメータを入力します。

-Dtangosol.coherence.wkan=hostname
-Dtangosol.coherence.localhost=hostname
-Dtangosol.coherence.localport=localport_number
-Dtangosol.coherence.wka1.port=port_number_for_Coherence

7. 「保存」をクリックして、「変更のアクティブ化」をクリックします。

8. サーバーを起動します。

21.9 事例: Oracle SOA SuiteおよびFusion Order Demoの新しいターゲット環境への移行

この事例では、Oracle SOA SuiteをデプロイされたSOAコンポジット・アプリケーションFusion Order Demoとともにターゲット環境に移行します。

この手順では、ソース環境で次の操作を実行済です。

- Oracle WebLogic Serverをインストールし、Middlewareホームを作成しました。

- RCUを使用して、ソース・データベースで必要なスキーマを作成しました。

- Oracle SOA Suiteをインストールしました。

- 構成ウィザードを使用してOracle SOA Suiteを構成しました。

- 環境で必要な場合は、Oracle Internet Directory、Oracle Platform Security、Oracle Web Services Managerなどのアイデンティティ管理コンポーネントをインストールして構成しました。

- セキュリティ・ポリシーを構成しました。

- Fusion Order Demoサンプル・アプリケーションをデプロイしました。
アプリケーションのzipファイルをダウンロードし、デプロイする方法の詳細は、Oracle Fusion Middleware Oracle SOA Suite管理者ガイドのSOAサンプル・アプリケーションの概要に関する説明を参照してください。

Oracle SOA Suiteを新しいターゲット環境に移行するには、次の作業を実行します。

- 作業1「データベースおよびMiddlewareホームの移行」

- 作業2「ドメイン構成の移行」

- 作業3「Oracle B2Bアグリーメントのデプロイおよびリスニング・チャネルの有効化」

- 作業4「Fusion Order Demoの検証」

作業1   データベースおよびMiddlewareホームの移行

Middlewareホームおよびバイナリ・ファイルを移行する手順は次のとおりです。

1. 第21.3.3項の説明に従って、データベースとスキーマを移行または作成します。

2. 第21.4.1項の説明に従って、アイデンティティ管理コンポーネントを移行します。

3. Middlewareホームおよびバイナリ・ファイルを移行します。

1. Windowsの場合は、ソースMiddlewareホームで、管理サーバーおよびMiddlewareホームで実行されている管理対象サーバーをすべて停止します。(UNIXの場合は、サーバーを停止する必要はありません。)

2. ソースMiddlewareホームで、copyBinaryスクリプトを実行します。これによって、WebLogic ServerホームおよびMiddlewareホーム内に含まれるOracleホームがコピーされます。ソースのMiddlewareホーム内にOracleホームがない場合、アーカイブにOracleホームは含まれなくなります。
たとえば、/scratch/Oracle /Middleware1のMiddlewareホームをコピーするには、次のコマンドを使用します。

copyBinary.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/mw_copy.jar
-sourceMWHomeLoc /scratch/Oracle/Middleware1
-invPtrLoc /scratch/oracle/oraInst.loc

3. Middlewareホームを別のホストにコピーする場合は、そのシステムにアーカイブ・ファイルをコピーします。

4. pasteBinaryスクリプトとcloningclient.jarファイルをターゲット・システムにコピーし、実行権限があることを確認します。ファイルの場所については、第20.2項を参照してください。
pasteConfigなど他のスクリプトをコピーしないでください。これらのスクリプトは、ステップeで説明しているように、ファイルの抽出時に生成されます。

5. クローニング先で、pasteBinaryスクリプトを使用して、アーカイブからファイルを抽出します。

たとえば、/scratch/oracle/MW_Home_prodディレクトリにアーカイブを適用するには、次のコマンドを使用します。

pasteBinary.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc  /tmp/mw_copy.jar
-targetMWHomeLoc  /scratch/oracle/MW_Home_prod

Middlewareホームが/scratch/oracle/MW_Home_prodに抽出され、その下にWebLogic Serverホーム、およびソースOracleホーム名と同じ名前ですべてのOracleホームが抽出されます。

6. pasteBinaryスクリプトでカスタムのインベントリの場所を使用(invPtrLocパラメータを使用)した場合、pasteBinary操作の最後に、rootとして次のスクリプトを実行する必要があります。

ORACLE_HOME/oracleRoot.sh

作業2   ドメイン構成の移行

ドメイン構成およびノード・マネージャ構成のコピーを移行する手順は次のとおりです。

1. ソースのMiddlewareホームで、管理サーバーおよびすべての管理対象サーバーが起動されていることを確認します。

2. ソースで、copyConfigスクリプトを実行してドメイン構成をコピーします。
copyConfigスクリプトの構文の詳細は、第20.2.1.3項を参照してください。

たとえば、Middlewareホーム/scratch/Oracle/Middleware1にあるSOA_domain1というOracle SOA Suiteドメインの構成をコピーするには、次のコマンドを使用します。

copyConfig.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/soa.jar
-sourceDomainLoc /scratch/oracle/config/domains/SOA_domain1
-sourceMWHomeLoc /scratch/Oracle/Middleware1
-domainHostName example.com
-domainPortNum 8001
-domainAdminUserName domain_admin_username
-domainAdminPasswordFile /scratch/admin/passwd.txt
-logDirLoc /tmp/logs

3. コンポーネントを別のホストにコピーする場合は、そのシステムにアーカイブ・ファイルをコピーします。

4. extractMovePlanスクリプトを使用して、アーカイブから移動計画を抽出します。
extractMovePlanスクリプトの構文の詳細は、第20.2.1.7項を参照してください。

次に例を示します。

extractMovePlan.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/soa.jar
-planDirLoc /tmp/Oracle/t2p_plans/soa

5. ターゲット環境の値にあわせてプロパティを変更するために、移動計画を編集します。Oracle SOA Suiteのプロパティのリストは、表20-14、表20-15、表20-16および表20-20を参照してください。
たとえば、すべてのプロパティのホストおよびポート番号を編集して、ターゲット環境の適切な値でプロパティを更新します。

6. 次のディレクトリにあるアダプタ・デプロイメント計画ファイルを編集します。

move_plan_dir/adapters

(この場所は移動計画でconfigGroupアダプタの下に指定されています。)

Fusion Order Demoのみを構成した場合、ファイルは次のようになります。

- FileAdapter_plan.xml

- JmsAdapter_plan.xml

- OracleBamAdapter_plan.xml

その他のアダプタも更新した場合、これらのファイルはアダプタ・ディレクトリに配置されます。

各ファイルで、<config-root>要素を編集して、ターゲットのアダプタ構成プランの場所を指定します。たとえば、次の行を変更して、ターゲットのアダプタ構成プラン・ファイルの場所を指定します。

<config-root>/scratch/Oracle/Middleware/Oracle_SOA1/soa/connectors/plan</config-root>

7. 次のディレクトリにあるコンポジット構成プラン・ファイルを編集します。

move_plan_dir/composites

この場所は移動計画で、configPropertyの構成プランの場所の下に指定されています。コンポジット構成プラン・ファイルの詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』の構成プラン・ファイルの概要に関する説明を参照してください。

ファイルは次のとおりです。

- B2BX12OrderGateway_1.0_soaFusionOrderDemo.xml
このファイルでは、場所属性のURLのホストおよび管理対象サーバー・ポートを更新して、ターゲットの値を指定します。次に例を示します。

<attribute name="location">
<replace>
http://example.com:18937/soa-infra/services/soaFusionOrderDemo/OrderSDOComposite!1.0/StoreFrontService?wsdl</replace>
</attribute>

- PartnerSupplierComposite_1.0_soaFusionOrderDemo.xml
このファイルでは、各<wsdlAndSchema>要素で、必要に応じて場所を変更して、ターゲットの別の場所を指定します。(この場所は<replace>要素で指定されています。)

- OrderBookingComposite_1.0_soaFusionOrderDemo.xml
このファイルでは、場所属性のURLのホストおよび管理対象サーバー・ポートを更新します。次に例を示します。

<attribute name="location">
<replace>http://example.com:18937/WebServices_WebLogicFusionOrderDemo_CreditCardAuthorization/CreditAuthorizationPort?wsdl</replace>
</attribute>

- OrderSDOComposite_1.0_soaFusionOrderDemo.xml
このファイルは変更する必要がありません。

8. 編集された移動計画、アダプタ・デプロイメント計画ファイルおよびコンポジット構成プラン・ファイルをターゲットにコピーします。(pasteConfig操作の間、-movePlanLocオプションを使用して移動計画の場所を指定します。)

9. ターゲットで、第20.2.1.8項で説明されているpasteConfigスクリプトを使用して、アーカイブからファイルを抽出します。pasteConfigスクリプトは、ドメインを作成し、すべての構成およびコンポジットをデプロイします。
たとえば、Middlewareホーム/scratch/Oracle/Middleware1にアーカイブを適用するには、次のコマンドを使用します。

pasteConfig.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/soa.jar
-movePlanLoc /tmp/Oracle/t2p_plans/soa/moveplan.xml
-targetDomainLoc /scratch/oracle/config/domains/SOA_domain1
-targetMWHomeLoc /scratch/Oracle/Middleware1/
-domainAdminPasswordFile /scratch/pwd_dir/pass.txt

スクリプトの完了後に、管理サーバーが実行されますが、管理対象サーバーは実行されません。

10. ソースで、copyConfigスクリプトを実行してノード・マネージャ構成をコピーします。
copyConfigスクリプトの構文の詳細は、第20.2.1.6項を参照してください。たとえば、次のコマンドを使用します。

copyConfig.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/nm.jar
-sourceNMHomeLoc /scratch/Oracle/Middleware/wlserver_10.3/common/nodemanager
-logDirLoc /tmp/logs

11. ノード・マネージャを別のホストにコピーする場合は、そのシステムにアーカイブ・ファイルをコピーします。

12. extractMovePlanスクリプトを使用して、アーカイブから移動計画を抽出します。
extractMovePlanスクリプトの構文の詳細は、第20.2.1.7項を参照してください。

次に例を示します。

extractMovePlan.sh -javaHome /scratch/Oracle/Middleware1/jrockit_160_20_D1.1.0-18
-archiveLoc /tmp/nm.jar
-planDirLoc /tmp/Oracle/t2p_plans/nm

13. ターゲット環境の値にあわせてプロパティを変更するために、移動計画を編集します。ノード・マネージャのプロパティのリストについては、表20-13を参照してください。

14. 編集した移動計画をターゲットにコピーします。(pasteConfig操作の間、-movePlanLocオプションを使用して場所を指定します。)

15. ターゲットでは、pasteConfigスクリプトを使用してアーカイブからファイルを抽出します。次を参照してください。
スクリプトの構文: 第20.2.1.11項

たとえば、次のコマンドを使用します。

pasteConfig -javaHome USER_HOME/jrockit_160_17_R28.0.0-679/
-archiveLoc /tmp/nm.jar
-targetNMHomeLoc /scratch/Oracle/Middleware1/wlserver_10.3/common/nodemanager
-targetMWHomeLoc /scratch/Oracle/Middleware1
-movePlanLoc /tmp/Oracle/t2p_plans/nm/moveplan.xml
-silent true

スクリプトの完了後に、管理サーバーが実行されますが、管理対象サーバーは実行されません。

16. 第4.2.3項の説明に従って、すべての管理対象サーバーを起動します。

作業3   Oracle B2Bアグリーメントのデプロイおよびリスニング・チャネルの有効化

Oracle B2Bアグリーメントを明示的にデプロイする必要があります。(詳細は、『Oracle Fusion Middleware Oracle B2Bユーザーズ・ガイド』のアグリーメントのデプロイに関する説明を参照してください。)

Oracle B2Bアグリーメントをデプロイし、リスニング・チャネルを有効化する手順は次のとおりです。

1. 次のURLを入力し、ユーザー名とパスワードを指定して、Oracle B2Bコンソールにログインします。

http://host:8001/b2bconsole

2. Oracle B2Bアグリーメントをデプロイします。

1. 「管理」タブを選択し、次に「デプロイ」タブを選択します。

2. デプロイするアグリーメントを検索するには、検索パラメータを使用して「検索」をクリックします。

3. 1つ以上のアグリーメントを強調表示して、「デプロイ」をクリックします。

3. リスニング・チャネルを有効化します。

1. 「管理」タブ、「リスニング・チャネル」タブ、「チャネル属性」タブの順に選択します。

2. チャネルを選択し、「有効化」をクリックします。

作業4   Fusion Order Demoの検証

Fusion Order Demoを検証する手順は次のとおりです。

Fusion Order Demoの実行の詳細は、『Oracle Fusion Middleware Oracle SOA Suite開発者ガイド』のFusion Order Demoの実行に関する説明を参照してください。

1. 次のURLからストアフロントにアクセスします。

http://hostname:port/StoreFrontModule/faces/home.jspx

この例では、hostnameは、Oracle SOA Suite用のOracle WebLogic ServerのDNS名またはIPアドレスで、portはストアフロント・モジュールがデプロイされるポートのアドレス(ポート8001など)です。

注文プロセスを開始するには、製品カタログを参照します。製品の横にある「追加」をクリックすると、サイトのショッピング・カート・リージョンが更新され、品目が表示されます。

2. 注文プロセスを開始するには、製品カタログを参照します。$299.99のTre 650 Phone/PDAの下の「追加」をクリックします。

3. 「チェックアウト」をクリックし、「ユーザー名」および「パスワード」でngreenbeおよびwelcome1を使用してログインします。

4. 出荷および請求の詳細を指定します。

5. 「ログアウト」をクリックします。

第IX部

付録

この部は、次の付録で構成されています。

- 付録A「Oracle Fusion Middlewareのコマンドライン・ツール」

- 付録B「コンポーネントのURL」

- 付録C「ポート番号」

- 付録D「メタデータ・リポジトリ・スキーマ」

- 付録E「Oracle Fusion Middlewareのアクセシビリティ・オプションの使用」

- 付録F「管理上の変更の例」

- 付録G「リリース番号の確認」

- 付録H「Oracle Wallet Managerおよびorapki」

- 付録I「Oracle Fusion Middlewareのトラブルシューティング」

A Oracle Fusion Middlewareのコマンドライン・ツール

この付録では、Oracle Fusion Middlewareで使用可能なコマンドライン・ツールについてまとめます。

表A-1 Oracle Fusion Middlewareのコマンドライン・ツール

コマンド

パス

説明

adrci

UNIX: MW_HOME/wlserver_n/server/adr

Windows: MW_HOME\wlserver_n\server\adr

Oracleサポートへ送信するために、インシデントや問題の情報をZIPファイルにパッケージ化します。

bulkdelete

UNIX: ORACLE_HOME/ldap/bin/bulkdelete.sh

Windows: ORACLE_HOME\ldap\bin\bulkdelete.bat

Oracle Internet Directory内でサブツリーを効率的に削除します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

bulkload

UNIX: ORACLE_HOME/ldap/bin/bulkload.sh

Windows: ORACLE_HOME\ldap\bin\bulkload.bat

Oracle Internet Directoryエントリを、別のアプリケーションにあるデータから、または別のアプリケーションによって作成されたデータから作成します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

bulkmodify

UNIX: ORACLE_HOME/ldap/ bin/bulkmodify

Windows: ORACLE_HOME\ldap\bin\bulkmodify

多数の既存のOracle Internet Directoryエントリを効率的な方法で変更します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

catalog

UNIX: ORACLE_HOME/ldap/bin/catalog.sh

Windows: ORACLE_HOME\ldap\bin\catalog.bat

Oracle Internet Directory内のカタログ・エントリを追加および削除します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

chgiphost

UNIX: ORACLE_HOME/chgip/scripts/chpiphost.sh

Windows: ORACLE_HOME\chgip\scripts\chpiphost.bat

Oracle HTTP ServerとOracle Web Cacheのネットワーク構成を変更します。

関連項目: 第15.1.3項

config

UNIX: ORACLE_HOME/common/bin/config.sh Windows: ORACLE_HOME\common\bin\config.cmd

構成ウィザードを起動して、ドメインの作成や構成、またはドメインの拡張を行います。

関連項目: 該当コンポーネントのインストレーション・ガイド

eulbuilder.jar

UNIX: ORACLE_HOME/bin/eulbuilder.jar

Windows: ORACLE_HOME\bin\eulbuilder.jar

Discoverer EUL Javaコマンドライン・インタフェース。Oracle Discoverer AdministratorをインストールせずにDiscoverer EULの作成と操作を行います。

関連項目: Oracle Business Intelligence Discoverer EUL Command Line for Javaユーザーズ・ガイド

iasua

UNIX: ORACLE_HOME/upgrade/iasua.sh

Windows: ORACLE_HOME\upgrade\iasua.bat

Oracle Fusion Middlewareのアップグレード・アシスタント。

関連項目: Oracle Fusion Middlewareアップグレード・プランニング・ガイド

frmcmp

UNIX: ORACLE_HOME/bin/frmcmp.sh

Windows: ORACLE_HOME\bin\frmcmp.exe

Form Compilerを起動してフォームを生成します。

関連項目: Oracle Forms Servicesオンライン・ヘルプ

ldapadd

UNIX: ORACLE_HOME/bin/ldapadd

Windows: ORACLE_HOME\bin\ldapadd

エントリ、そのオブジェクト・クラス、属性および値をOracle Internet Directoryに追加します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

ldapaddmt

UNIX: ORACLE_HOME/bin/ldapaddmt

Windows: ORACLE_HOME\bin\ldapaddmt

エントリ、そのオブジェクト・クラス、属性および値をOracle Internet Directoryに追加します。エントリを同時に追加するために複数スレッドをサポートする以外は、ldapaddと同様です。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

ldapbind

UNIX: ORACLE_HOME/bin/ldapbind

Windows: ORACLE_HOME\bin\ldapbind

サーバーに対してクライアントを認証可能かどうかを判断します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

ldapcompare

UNIX: ORACLE_HOME/bin/ldapcompare

Windows: ORACLE_HOME\bin\ldapcompare

コマンドラインで指定する属性値を、Oracle Internet Directoryエントリ内の属性値と比較します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

ldapdelete

UNIX: ORACLE_HOME/bin/ldapdelete

Windows: ORACLE_HOME\bin\ldapdelete

Oracle Internet Directoryからエントリ全体を削除します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

ldapmoddn

UNIX: ORACLE_HOME/bin/ldapmoddn

Windows: ORACLE_HOME\bin\ldapmoddn

Oracle Internet DirectoryエントリのDNまたはRDNを変更します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

ldapmodify

UNIX: ORACLE_HOME/bin/ldapmodify

Windows: ORACLE_HOME\ bin\ldapmodify

Oracle Internet Directory内の属性上で操作を実行します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

ldapmodifymt

UNIX: ORACLE_HOME/bin/ldapmodifymt

Windows: ORACLE_HOME\bin\ldapmodifymt

複数のOracle Internet Directoryエントリを同時に変更します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

ldapsearch

UNIX: ORACLE_HOME/bin/ldapsearch

Windows: ORACLE_HOME\bin\ldapsearch

Oracle Internet Directory内の特定のエントリを検索して取得します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

ldifmigrator

UNIX: ORACLE_HOME/ bin/ldifmigrator

Windows: ORACLE_HOME\bin\ldifmigrator.bat

アプリケーション固有のリポジトリから、データをOracle Internet Directoryに移行します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

ldifwrite

UNIX: ORACLE_HOME/ldap/ bin/ldifwrite

Windows: ORACLE_HOME\ldap\bin\ldifwrite.bat

Oracle Internet Directoryにある情報の全部または一部をLDIFに変換します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

oidcmprec

UNIX: ORACLE_HOME/ldap/bin/oidcmprec

Windows: ORACLE_HOME\ldap\bin\oidcmprec

あるOracle Internet Directoryを別のOracle Internet Directoryと比較し、競合または不一致を検出して、オプションでこれらを解決します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

oidcred

UNIX: ORACLE_HOME/ldap/bin/oidcred

Windows: ORACLE_HOME\ldap\ bin\oidcred

資格証明ストア・フレームワークで作成された資格証明を追加、更新または削除します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

oidctl

UNIX: ORACLE_HOME/bin/oidctl

Windows: ORACLE_HOME\ bin\oidctl

Oracle Internet Directoryを起動および停止します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

oiddiag

UNIX: ORACLE_HOME/ldap/bin/oiddiag

Windows: ORACLE_HOME\ldap\ bin\oiddiag

Oracle Internet Directoryの診断情報を収集します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

oidmon

UNIX: ORACLE_HOME/ bin/oidmon

Windows: ORACLE_HOME\bin\oidmon

Oracle Internet Directoryのプロセスを監視します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

oidpasswd

UNIX: ORACLE_HOME/ldap/ bin/oidpasswd

Windows: ORACLE_HOME\ldap\bin\oidpasswd

Oracle Internet Directoryのパスワードを変更します。変更しないと、Oracle Internet Directoryへのアクセスが制約されます。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

oidprovtool

UNIX: ORACLE_HOME/bin/oidprovtool

Windows: ORACLE_HOME\bin\oidprovtool.bat

Oracle Internet Directory内のプロビジョニング・プロファイル・エントリを管理します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

oidrealm

UNIX: ORACLE_HOME/ldap/bin/oidrealm

Windows: ORACLE_HOME\ldap\bin\oidrealm.bat

Oracle Internet Directoryに複数のレルムを作成します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

oidstats

UNIX: SQLコマンド、oidstats.sql

Windows: SQLコマンド、oidstats.sql

様々なデータベースのodsスキーマ・オブジェクトを解析して統計を推定します。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

opmnctl

UNIX: ORACLE_INSTANCE/bin/opmnctl.exe

Windows: ORACLE_INSTANCE\bin\opmnctl.exe

OPMNが管理するプロセスを起動および停止し、それらのプロセスのステータスを取得します。

関連項目: Oracle Fusion Middleware Oracle Process Manager and Notification Server管理者ガイド

orapki

UNIX: ORACLE_HOME/bin/orapki

Windows: ORACLE_HOME\bin\orapki.bat

ウォレットおよび証明書を管理します。付録Hを参照してください。

remtool

UNIX: ORACLE_HOME/ldap/bin/remtool

Windows: ORACLE_HOME\ldap\bin\remtool

Oracle Internet Directoryのレプリケーションの失敗時に、問題を検出し、修正を試みます。

関連項目: Oracle Fusion Middleware Oracle Identity Managementリファレンス

rwbuilder

UNIX: ORACLE_HOME/bin/rwbuilder

Windows: ORACLE_HOME\bin\rwbuilder

Reports Builderを起動します。

関連項目: Oracle Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイド

rwclient

UNIX: ORACLE_HOME/ bin/rwclient

Windows: ORACLE_HOME\bin\rwclient

コマンドラインを解析して、指定した(またはデフォルトの)Reports Serverに転送します。

関連項目: Oracle Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイド

rwconverter

UNIX: ORACLE_HOME/bin/rwconverter

Windows: ORACLE_HOME\bin\rwconverter

1つ以上のレポート定義またはPL/SQLライブラリを、ある記憶域形式から別の形式に変換します。

関連項目: Oracle Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイド

rwrun

UNIX: ORACLE_HOME/bin/rwrun

Windows: ORACLE_HOME\bin\rwrun

Oracle Reports Servicesのインプロセス・サーバーを使用して、レポートを実行します。

関連項目: Oracle Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイド

rwserver

UNIX: ORACLE_HOME/bin/rwserver

Windows: ORACLE_HOME\bin\rwserver.bat

Reports Serverを起動します。

関連項目: Oracle Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイド

ssocfg

(UNIX)sso/bin/ssocfg.sh

(Windows)sso\bin\ssocfg.bat

Oracle Single Sign-On URLのホスト、ポートおよびプロトコルを更新します。

See: Oracle Fusion Middleware Oracle Single Sign-On管理者ガイド、リリース10.1.3.4

ssooconf.sql

UNIX: ORACLE_HOME/portal/admin/plsql/sso/ssooconf.sql

Windows: ORACLE_HOME\portal\admin\plsql\sso\ssooconf.sql

Oracle Single Sign-Onサーバーが別のOracle Internet Directoryを指すように指定するスクリプト。

See: Oracle Fusion Middleware Oracle Single Sign-On管理者ガイド、リリース10.1.3.4

wlst

UNIX: WLS_HOME/common/bin/wlst.sh

Windows: WLS_HOME\common\bin\wlst.cmd

UNIX: ORACLE_HOME_for_component/common/bin/wlst.sh

Windows: ORACLE_HOME_for_component\common\bin\wlst.cmd

(WebLogic Scripting Tool) Oracle WebLogic Server、およびOracle WebLogic Serverドメイン内のコンポーネントを管理します。

関連項目: 第3.5.1項およびOracle Fusion Middleware WebLogic Scripting Toolコマンド・リファレンス

B コンポーネントのURL

この付録では、Oracle Fusion Middlewareの各コンポーネントへのアクセスに必要なURLを記載します。

表B-1にURLと、インストール後にコンポーネントへアクセスするデフォルトのユーザーを示します。

表には、URLとともにデフォルト・ポートが示されています。環境によっては、コンポーネントで異なるポートが使用される場合があります。ポート番号を決定するには、Fusion Middleware Controlの「WebLogicドメイン」メニューで「ポートの使用状況」を選択します。

別途注記されている場合を除き、各ユーザーのパスワードは、インストール時に指定されたパスワードか、ユーザーの作成時またはユーザーのパスワード変更時にユーザーに割り当てたパスワードです。

表B-1 コンポーネントのURL

コンポーネント

URL(およびデフォルトのポート番号)

デフォルトのユーザーおよびパスワード

Oracle B2B

http://host:8001/b2b

weblogic

Oracle Business Activity Monitoring

http://host:9001/oracleBAM

weblogic

Oracle Business Intelligence Discoverer Plus

http://host:7777/discoverer/plus

該当なし

Oracle Business Intelligence Discoverer Portlet Provider

http://host:7777/discoverer/portletprovider

該当なし

Oracle Business Intelligence Discoverer Viewer

http://host:7777/discoverer/viewer

該当なし

Oracle Directory Services Manager

https://host:7001/odsm

「cn=orcladmin」などのスーパーユーザー

Oracle Enterprise Manager Fusion Middleware Control

http://host:7001/em

weblogic

Oracle Forms Services

http://host:http_listen_port/forms/frmservlet

該当なし

Oracle HTTP Server

http://host:7777

該当なし

Oracle WebCenter Content: Imaging

http://host:16000/imaging

Imagingにログインする最初のユーザー

Oracle Portal

http://host:http_listen_port/pls/portal

orcladmin

インストール中に指定したパスワードを使用します。

Oracle Reports Services

http://host:http_listen_port/reports/rwservlet

orcladmin

デフォルトのパスワードは、Oracle Reportsが使用するInfrastructureインスタンスのweblogicパスワードと同じです。

Oracle WebCenter Portalのディスカッション・サーバー

http://host:8890/owc_discussions

weblogic

Oracle WebCenter Portal: Spaces

http://host:8888/webcenter

weblogic

Oracle WebCenter PortalのPersonalization

http://host:port/wcps/api/property/resourceIndex

weblogic

Oracle WebCenter Portalのアクティビティ・グラフ

http://host:8891/activitygraph-engines

weblogic

Oracle WebCenter Portalのポートレット・プロデューサ

http://host:8889/wsrp-tools/info

http://host:8889/portalTools

http://host:8889/pagelets

weblogic

Oracle WebLogic Server管理コンソール

http://host:7001/console

weblogic

C ポート番号

この付録では、Oracle Fusion Middlewareのポート番号について説明します。

次の項目が含まれます。

- コンポーネント別のポート番号

- ポート番号(番号別)

C.1 コンポーネント別のポート番号

この項では、ポートを使用する各Oracle Fusion Middlewareコンポーネントまたはサービスに関する次の情報について説明します。

- コンポーネントまたはサービス: コンポーネントおよびサービスの名前。

- デフォルトのポート番号: Oracle Fusion Middlewareがコンポーネントに割り当てる最初のポート番号。これは通常、割り当てられているポート範囲内の最小の数値です。このポートが使用されている場合、割り当てられているポート範囲内で次に使用可能なポート番号が割り当てられます。

- 割り当てられているポート範囲: Oracle Fusion Middlewareがポートを割り当てるときに使用する一連のポート番号。

Oracle WebLogic Serverサーバーのポート番号は、作成される各サーバーに対して順次割り当てられます。たとえば、最初の管理サーバーにポート7001が割り当てられた場合、2番目のサーバーには7002が割り当てられます。特定のコンポーネントのインストールおよび構成中に作成される管理対象サーバーは、特定のデフォルトのポート番号を持つ場合があります。

表C-1は、コンポーネントのデフォルトのポート番号およびポート番号範囲を、コンポーネントのアルファベット順で記載したものです。

表C-1 ポート番号(コンポーネント順)

コンポーネントまたはサービス

デフォルトのポート番号

割り当てられているポート範囲

Oracle Business Activity Monitoring

9001

9000-9080

Oracle Data Integrator

15000

15500

Oracle Directory Integration Platform

7005

7005-9000

Oracle Directory Services Manager

7005

7005-9000

Oracle Forms Servicesの管理対象サーバー

9001

9001-9100

Oracle HTTP Serverの非SSLリスニング・ポート

7777または8888

7777-7877, 8888

Oracle HTTP ServerのSSLリスニング・ポート

4443

4443-4543

Oracle Identity Federation Serverの管理対象サーバー

7499

7499-9000

Oracle Information Rights Management

16100

16100-16199

Oracle Internet Directory(非SSL)

3060

3061から3070、
13060から13070

Oracle Internet Directory(SSL)

3131

3132から3141、
13131から13141

Oracle Management Agent(Fusion Middleware Controlで使用)

5162

5162-6162

Oracle Notification Serverローカル・ポート

6100

6100 - 6199

Oracle Notification Serverリモート・ポート

6200

6200 - 6299

Oracle Notification Serverリクエスト・ポート

6003

6003 - 6099

Oracle Portalの管理対象サーバー

9001

9001-9100

Oracle Reportsの管理対象サーバー

9001

9001-9100

Oracle Virtual Directory(非SSL)

6501

6501-6510

Oracle Virtual Directory(SSL)

7501

7501-7510

Oracle Web Cache管理ポート

7786

7781-7790

Oracle Web Cache無効化ポート

7788

7781-7790

Oracle Web Cacheのリスニング・ポート

7785

7781-7790

Oracle Web CacheのSSLリスニング・ポート

7789

7781-7790

Oracle Web Cache統計ポート

7787

7781-7790

Oracle WebCenter Contentコンテンツ・サーバー

16200

16200-16299

Oracle WebCenter Content: Imaging

16000

16000-16099

Oracle WebCenter Content: Records

16300

16300-16399

Oracle WebCenterパーソナライズ

8891

8891

Oracle WebCenter Portalのカスタム・ポータルの管理対象サーバー

8793

8793

Oracle WebCenter Portalのカスタム・ポータルの管理対象サーバー

8892

8892

Oracle WebCenter Portal: Spaces

8888

8881-8890

Oracle WebCenter Portalのアクティビティ・グラフ・エンジン

8891

8891

Oracle WebCenter Portalのページレット・プロデューサ

8889

8881-8890

Oracle WebCenter Portalのポートレット・プロデューサ

8889

8881-8890

Oracle WebCenter Portalのディスカッション・サーバー

8890

8881-8890

管理サーバーのOracle WebLogic Serverリスニング・ポート

7001

7001-9000

管理対象サーバーのOracle WebLogic Serverリスニング・ポート

8001

8000 - 8080

Oracle WebLogic Serverのノード・マネージャ・ポート

5556

5556

管理サーバーのOracle WebLogic Server SSLリスニング・ポート

7002

7002-9000

C.2 ポート番号(番号順)

表C-2は、Oracle Fusion Middlewareのポート番号およびコンポーネントを、ポート番号の昇順で記載したものです。

表C-2 ポート番号(番号順)

デフォルトのポート番号

コンポーネントまたはサービス

3060

Oracle Internet Directory(非SSL)

3131

Oracle Internet Directory(SSL)

4443

Oracle HTTP Server(SSL)

5162

Oracle Management Agent

5556

Oracle WebLogic Serverのノード・マネージャ・ポート

6003

Oracle Notification Serverリクエスト・ポート

6100

Oracle Notification Serverローカル・ポート

6200

Oracle Notification Serverリモート・ポート

6501

Oracle Virtual Directory(非SSL)

7001

管理サーバーのOracle WebLogic Serverリスニング・ポート

7002

管理サーバーのOracle WebLogic Server SSLリスニング・ポート

7005

Oracle Directory Integration Platform

7005

Oracle Directory Services Manager

7499

Oracle Identity Federation Serverの管理対象サーバー

7501

Oracle Virtual Directory(SSL)

7777

Oracle HTTP Server(非SSL)

7785

Oracle Web Cache(非SSL)

7786

Oracle Web Cache管理ポート

7787

Oracle Web Cache統計ポート

7788

Oracle Web Cache無効化ポート

7789

Oracle Web Cache(SSL)

8001

管理対象サーバーのOracle WebLogic Serverリスニング・ポート

8793

Oracle WebCenter Portalのカスタム・サービス・プロデューサの管理対象サーバー

8888

Oracle HTTP Server、Oracle WebCenter Portal: 領域

8889

Oracle WebCenter Portalのページレット・プロデューサ

8889

Oracle WebCenter Portalのポートレット・プロデューサ

8890

Oracle WebCenter Portalのディスカッション・サーバー

8891

Oracle WebCenter Analyticsコレクタ

8891

Oracle WebCenterパーソナライズ

8891

Oracle WebCenter Portalのアクティビティ・グラフ・エンジン

8892

Oracle WebCenter Portalのカスタム・ポータルの管理対象サーバー

9001

Oracle Business Activity Monitoringの管理対象サーバー

9001

Oracle Forms Servicesの管理対象サーバー

9001

Oracle Portalの管理対象サーバー

9001

Oracle Reportsの管理対象サーバー

15000

Oracle Data Integrator

16000

Oracle WebCenter Content: Imaging

16100

Oracle Information Rights Management

16200

Oracle WebCenter Content

16300

Oracle WebCenter Content: Records

D メタデータ・リポジトリ・スキーマ

Oracle Fusion Middlewareコンポーネントは、メタデータをリポジトリに格納します。多くのコンポーネントでは、スキーマを格納してコンポーネントをサポートするために、データベース・リポジトリが必要です。この付録では、それらのスキーマについて説明します。

この付録の項目は次のとおりです。

- メタデータ・リポジトリ・スキーマの説明

- メタデータ・リポジトリのスキーマ、表領域およびデータファイル

D.1 メタデータ・リポジトリ・スキーマの説明

表D-1は、Oracle Fusion Middlewareコンポーネントで使用するスキーマを、コンポーネントのアルファベット順で記載したものです。スキーマ名の前には、リポジトリ作成ユーティリティの実行時に指定した接頭辞が付くことに注意してください。

表D-1 リポジトリ作成ユーティリティで作成されたメタデータ・スキーマ

コンポーネント

スキーマ

説明

Oracle Access Manager

OAM

Oracle Access Managerの情報が含まれています。

Oracle Adaptive Access Manager

OAAM

OAAM_PARTN

Oracle Adaptive Access Managerの情報が含まれています。

Oracle B2B

SOAINFRA

設計リポジトリとランタイム・リポジトリが含まれています。設計リポジトリには、統合用のモデリング・メタデータとプロファイル・データがあります。これらのデータにより、統合の動作とビジネス・プロセスの実行に必要な手順が記述されます。モデリング・メタデータとプロファイル・メタデータは、デプロイメントおよび実行前の統合の設計です。統合がデプロイされると、ランタイム・リポジトリには統合の実行に必要なメタデータに加えて、ビジネス・プロセス・インスタンス、イベント・インスタンス、ロール・インスタンスなどの実行時に作成されたデータが含まれます。

Oracle BPEL Process Manager

MDS

SOAINFRA

MDSには、プロセス定義および構成情報が含まれています。

SOAINFRAには、Oracle Business Activity MonitoringおよびOracle BPEL Process Manager用のインスタンスとメタデータのデータベース・オブジェクトが含まれています。

Oracle Business Activity Monitoring

ORABAM

MDS

Oracle Business Activity Monitoring用のインスタンスとメタデータのデータベース・オブジェクトが含まれています。

Oracle Business Intelligence

BIPLATFORM

Business Intelligence Serverのメタデータが含まれています。

Oracle Business Intelligence Discoverer

DISCOVERER

DISCOVERER_PS

Discoverer Portlet Provider用のメタデータ、ユーザー・ポートレット用のポートレット定義およびDiscovererのスケジュール済問合せの実行により取得されたキャッシュ・データが含まれています。RESOURCEおよびCONNECTの権限を持ちます。

Oracle Business Process Management

SOAINFRA

Oracle Business Process Managementおよびその他のSOAコンポーネントに関連するメタデータが含まれています。

Oracle Business Rules

MDS

Oracle Business Rulesの構成情報が含まれています。

Oracle Content Server

OCS

Oracle Content Server 11gのメタデータ情報が含まれています。

Oracle Data Integrator

ODI_REPO

Oracle Data Integratorの情報が含まれています。

Oracle Deployment Server

ODSSERVER

Oracle Deployment Serverのメタデータ情報が含まれています。

Oracle Directory Integration Platform

ODSSM

Oracle Directory Integration Platformの構成データが含まれています。

Oracle Event Processing

MDS

MDSには.MARファイルが格納され、MARファイルにはOracle Event Processingの.cqlsxファイルが格納されます。

Oracle Hyperion Enterprise Performance Management

EPM

Oracle Hyperion Enterprise Performance Managementのメタデータが含まれています。

Oracle Identity Federation

OIF

Oracle Identity Federationのメタデータが含まれています。

Oracle Identity Manager

OIM

Oracle Identity Managerを使用するアプリケーションのメタデータが含まれています。

Oracle Information Rights Management

ORAIRM

Oracle Information Rights Managementのメタデータが含まれています。

Oracle Internet Directory

ODS

ODSSM

内部使用。

Oracle Mediator

MDS

SOAINFRA

Oracle Mediatorのメタデータが含まれています。

Oracle Metadata Services

MDS

MDSを使用するアプリケーションのメタデータが含まれています。

Oracle Portal

PORTAL

Oracle Portalのデータベースとコードが含まれています。

Oracle Real-Time Decisions

RTD

内部使用。

Oracle Single Sign-On

ORASSO

内部使用。

Oracle SOA Suite Infrastructure

SOAINFRA

Oracle B2B、Oracle BPEL Process Manager、Oracle Business Process Management、Workflow、Sensor、MediatorおよびCEPに関連するメタデータが含まれています。

Oracle User Messaging

ORASDPM

User Messagingに関連するメタデータが含まれています。

Oracle Web Services Manager

MDS

構成情報が含まれています。

Oracle WebCenter Content

OCS

OCSSEARCH

Oracle WebCenter Contentのメタデータが含まれています。

Oracle WebCenter Content: Imaging

IPM

Oracle WebCenter Content: Imagingのメタデータが含まれています。

Oracle WebCenter Content: Records

URMSERVER

Oracle WebCenter Content: Recordsのメタデータが含まれています。

Oracle WebCenter Portal

WEBCENTER

MDS

Oracle WebCenter Portalの情報が含まれています。

Oracle WebCenter Portal: Spaces

WEBCENTER

MDS

WebCenter Portalサービスに関する情報(リンク、リスト、タグおよびイベントなど)が含まれています。

Oracle WebCenter Portalのアクティビティ・グラフおよび分析

ACTIVITIES

Oracle WebCenter Portalのアクティビティ・グラフおよび分析サービスの情報が含まれています。

Oracle WebCenter Portalのポートレット・プロデューサ

PORTLET

WebCenter Portalポートレット・プロデューサの情報が含まれています。

Oracle WebCenter Portalのディスカッション・サーバー

DISCUSSIONS

DISCUSSIONS_CRAWLER

Oracle WebCenter Portalのディスカッション・サーバーについての情報が含まれます。

D.2 メタデータ・リポジトリのスキーマ、表領域およびデータファイル

Table D-2に、各メタデータ・リポジトリ・スキーマ用の表領域およびデフォルトのデータファイルを示します。スキーマ名のアルファベット順に記載されています。デフォルトのデータファイルには、RCU内でスキーマに割り当てた接頭辞が付くことに注意してください。

示されている表領域の他に、スキーマをRCUで作成すると、必ず表領域IAS_TEMPが作成されます。そのデータファイルはiastemp.dbfです。

表D-2 メタデータ・リポジトリの表領域およびデータファイル

スキーマ

表領域

デフォルトのデータファイル

ACTIVITIES

IAS_ACTIVITIES

activities.dbf

BIPLATFORM

BIPLATFORM

biplatform.dbf

DISCOVERER

DISCO_PTM5_META

DISCO_PTMS_CACHE

DISCO_PSTORE

discoptm5meta.dbf

discoptm5cache.dbf

discopstore.dbf

DISCUSSIONS

IAS_DISCUSS

iasjive.dbf

DISCUSSIONS_CRAWLER

IAS_DSCRAWL

iasjivecrawl.dbf

EPM

EPM

epm.dbf

IPM

IPM

ipm.dbf

MDS

MDS

iasmds.dbf

OAAM

BRSADATA

brsdatan.dbf

OAAM_PARTN

OAAM_DATA

partn_brsadatan.dbf

OAM

OAM

oam.dbf

OAM

OAM

oam.dbf

OCS

OCS

ocs.dbf

OCSSEARCH

OCSSEARCH

ocssearch.dbf

ODI_REPO

ODI_USER

prefix_odi_user_n.dbf

ODS

OLTS_DEFAULT

default1_oid.dbf

ODSERVER

ODSERVER

odserver.dbf

ODSSM

ODSSM

odssm.dbf

OIF

IAS_OIF

iasoif.dbf

OIM

OIM

oim.dbf

ORABAM

ORABAM

orabam.dbf

ORAIRM

ORAIRM

orairm.dbf

ORASDPLS

IAS_ORASDPLS

orasdpls.dbf

ORASDPM

IAS_ORASDPM

IAS_ORASDPM_AQ

iassdpm.dbf

iassdpmaq.dbf

ORASDPSDS

IAS_ORASDPSDS

orasdpsds.dbf

ORASDPSXDMS

IAS_ORASDPSXDMS

orasdpsxdms.dbf

ORASSO

IAS_ORASSO

iasorasso.dbf

PORTAL

PORTAL

PORTAL_IDX

PORTAL_LOG

PORTAL_DOC

portal.dbf

portalidx.dbf

portallog.dbf

portaldoc.dbf

PORTLET

IAS_PORTLET

webcenter_portlet.dbf

RTD

IAS_RTD

iasrtd.dbf

SOAINFRA

SOAINFRA

soainfra.dbf

URMSERVER

URMSERVER

urmserver.dbf

WEBCENTER

IAS_WEBCENTER

iaswebcenter.dbf

E Oracle Fusion Middlewareのアクセシビリティ・オプションの使用

この付録では、Oracle Fusion Middlewareのアクセシビリティ・オプションの使用方法について説明します。次が含まれます。

- Java Access Bridgeのインストールおよび構成(Windowsのみ)

- Fusion Middleware Controlアクセシビリティ・モードの有効化

- Fusion Middleware Controlのキーボード・ナビゲーション

E.1 Java Access Bridgeのインストールおよび構成(Windowsのみ)

Windowsコンピュータの場合、Java Access Bridgeをインストールおよび構成して第508条のアクセシビリティを使用できます。

1. Java Access Bridgeを次のURLからダウンロードします。

http://www.oracle.com/technetwork/java/javase/tech/index-jsp-136191.html

2. Java Access Bridgeをインストールします。

3. access-bridge.jarファイルおよびjaccess-1_4.jarファイルをインストール場所からjre/lib/extディレクトリにコピーします。

4. WindowsAccessBridge.dllファイル、JavaAccessBridge.dllファイルおよびJAWTAccessBridge.dllファイルをインストール場所からjre/binディレクトリにコピーします。

5. accessibility.propertiesファイルをjre/libディレクトリにコピーします。

E.2 Fusion Middleware Controlアクセシビリティ・モードの有効化

次の各項では、Fusion Middleware Controlをアクセシビリティ・モードで実行する利点およびアクセシビリティ・モードを有効化する手順について説明します。

- HTMLページに対するアクセスのしやすさの強化

- Fusion Middleware Controlグラフのテキスト説明の表示

E.2.1 HTMLページに対するアクセスのしやすさの強化

Fusion Middleware Controlでは、スクリーン・リーダーのサポートを有効にすることができます。スクリーン・リーダーのサポートによりスクリーン・リーダーの動作が向上します。これは、アクセシビリティ固有の構成をHTMLに追加し、ページ上のナビゲーション要素の一部を変更することにより実現します。

Fusion Middleware Controlでスクリーン・リーダー・モードを有効化するには:

1. 「設定」→「プリファレンス」→「アクセシビリティ」を選択します。
「アクセシビリティ・プリファレンス」ページが表示されます。

2. 次のオプションのいずれかまたは両方を選択します。

- スクリーン・リーダーを使用する: アクセシビリティ固有の構成が追加されて、スクリーン・リーダーの動作が向上します。

- ログイン時に「アクセシビリティ・プリファレンス」ダイアログを表示: ログイン時に「アクセシビリティ・プリファレンス」ダイアログが次のオプションとともに表示されます。

- スクリーン・リーダーを使用する

- これらのオプションを再度表示しない

スクリーン・リーダーのサポートを選択すると、Fusion Middleware Controlは、スクリーン・リーダーで読むことができるようにWebページをレンダリングします。たとえば、ナビゲーション・ツリーの各ノードに「選択」ボタンが含まれるようになります。

次の図は、スクリーン・リーダーのサポートを有効化した後のナビゲーション・ペインおよび管理サーバーのパフォーマンス・サマリーを示します。

図accessible.gifの説明

E.2.2 Fusion Middleware Controlグラフのテキスト説明の表示

Fusion Middleware Control全体で、パフォーマンス・データの表示にはグラフが使用されます。ほとんどのユーザーにとって、これらのグラフは、トレンドを理解し、パフォーマンス・メトリックの最小値および最大値の特定に役立つ、データのグラフィック表示となります。

ただし、グラフでは、スクリーン・リーダーで読めるような方法で情報を表示することはできません。この問題を改善するために、各パフォーマンス・グラフの完全なテキスト表現を提供するようにFusion Middleware Controlを構成できます。スクリーン・リーダー・モードを有効にすると、Fusion Middleware Controlは、情報をグラフではなく表で表示します。

スクリーン・リーダー・モードを有効にせずに、データをグラフではなく表で表現するには、グラフの下の「表ビュー」をクリックします。

E.3 Fusion Middleware Controlのキーボード・ナビゲーション

この項では、Fusion Middleware Controlのキーボード・ナビゲーションについて説明します。

キーボード・ナビゲーションの多くは、スクリーン・リーダー・モードを使用していても使用していなくても同じです。

一般的に、次のキーを使用してナビゲートします。

- [Tab]キー: ページ内で次のコントロール(動的ターゲット・メニュー、ナビゲーション・ツリー、コンテンツ・ペイン、タブなど)に移動します。[Tab]キーを押すと、ページの左から右、上から下へと移動します。前のコントロールに移動するには、[Shift]+[Tab]キーを押します。

- 上矢印キーおよび下矢印キー: ナビゲーション・ツリー、メニューまたは表内で前の項目または次の項目に移動します。下矢印キーを押してメニューを開くこともできます。

- 左矢印キーおよび右矢印キー: ナビゲーション・ツリーまたはサブメニューで項目を閉じたり開いたりします。

- [Esc]キー: メニューを閉じます。

- [Space]キー: コントロールをアクティブ化します。たとえば、チェック・ボックスで[Space]キーを押すと、状態が切り替わります(ボックスの選択または選択解除)。リンクで[Space]キーを押すと、リンクのターゲットにナビゲートします。

- [Enter]キー: ボタンをアクティブ化します。

表E-1は、共通タスクの一部と、それに使用されるキーボード・ナビゲーションを示します。

表E-1 共通タスクのキーボード・ナビゲーション

タスク

ナビゲーション

次のコントロール(ナビゲーション・ツリー、メニューなど)に移動する

[Tab]キー

前のコントロール(ナビゲーション・ツリー、メニューなど)に移動する

[Shift]+[Tab]キー

ナビゲーション・ペインに移動する

[Tab]キー(ナビゲーション・ツリーに入力フォーカスが移動するまで)

ナビゲーション・ツリーを下に移動する

下矢印キー

ナビゲーション・ツリーを上に移動する

上矢印キー

フォルダを開く

右矢印キー

フォルダを閉じる

左矢印キー

メニューを開く

下矢印キー

メニュー内の次の項目に移動する

下矢印キー

メニュー内の前の項目に移動する

上矢印キー

メニュー項目を選択する

[Enter]キー

サブメニューを開く

右矢印キー

サブメニューを閉じる

左矢印キー

メニューの外に移動する

[Esc]キー

ボタンをアクティブ化する

[Enter]キー

コンテンツ・ペインのタブを開く

コンテンツ・ペインで[Tab]キーを押し、入力フォーカスを取得するタブで[Tab]キーを押してから、[Enter]キーを押してそのタブを選択する

項目(「ログ・メッセージ」画面におけるメッセージ・タイプなど)を選択する

[Space]キー

表内の行を選択する

表のヘッダーで[Tab]キーを押し、下矢印を押して行に移動する

表内のセルを選択する

表のヘッダーで[Tab]キーを押し、選択するセルに到達するまで[Tab]キーを押してから、[Enter]キーを押す

表E-2は、トポロジ・ビューアのキーボード・ナビゲーションを示します。ノード間のナビゲーションは、トポロジのジオメトリに基づきます。

表E-2 トポロジ・ビューアのキーボード・ナビゲーション

タスク

ナビゲーション

トポロジにナビゲートする。

[Tab]キー(ノードに到達するまで)

ジオメトリに基づいてノードをナビゲートする。

矢印キー

上から下に向かって、宛先リンクにナビゲートする。

[Ctrl]+[Shift]+下矢印キー

上から下に向かって、ソース・リンクにナビゲートする。

[Ctrl]+[Shift]+上矢印キー

左から右に向かって、宛先リンクにナビゲートする。

[Ctrl]+[Shift]+右矢印キー

左から右に向かって、ソース・リンクにナビゲートする。

[Ctrl]+[Shift]+左矢印キー

上から下に向かって、あるリンクから別のリンクにナビゲートする。フォーカスは、ジオメトリに基づいて別のリンクに移動します。

右矢印キーまたは左矢印キー

左から右に向かって、あるリンクから別のリンクにナビゲートする。フォーカスは、ジオメトリに基づいて別のリンクに移動します。

[↑]または[↓]

グループ・ノードに移動する、またはグループ・ノードから移動する。

[Shift]+矢印キー

ノードでクリックをシミュレートする。ポップアップを表示したり別のページにナビゲートできます。

[Enter]キー

マウスを合せる操作をシミュレートする。通常、ポップアップが表示されます。

[Shift]+[Enter]キー

右クリックをシミュレートする。通常、コンテキスト・メニューが表示されます。

[m]キー

ノードのサブツリーを開くか、または閉じる。

[e]キー

グループを開くか、または閉じる。[Shift]+矢印キーを使用してグループに移動すると、グループが自動的に開きます。

[g]キー

上下または左右にパンする。

[Ctrl]+矢印キー

ズームインする。

[Ctrl]+[Alt]+[+]キー

ズームアウトする。

[Ctrl]+[Alt]+[-]キー

メニューの外に移動する。

[Esc]キー

F 管理上の変更の例

この付録では、Oracle Fusion Middleware環境で行われる可能性のある管理上の変更の例を示します。これは、このマニュアルの第VII部「高度な管理: バックアップとリカバリ」、および『Oracle Fusion Middleware高可用性ガイド』の障害時リカバリに関する項に対応するものです。

次の項目が含まれます。

- この付録の使い方

- 管理上の変更の例(コンポーネント別)

F.1 この付録の使い方

一部の管理操作は、Oracle Fusion Middleware環境の構成の変更を伴います。これらの変更を管理上の変更と呼びます。管理上の変更には、アプリケーションのデプロイとアンデプロイ、管理対象サーバーまたはコンポーネントの追加または削除、ポートの変更、ユーザーの作成と削除、パスワードの変更などがあります。環境のバックアップやなんらかの同期処理が必要となる場合があるため、管理者は管理上の変更が生じるタイミングについて認識しておく必要があります。

この付録では、管理上の変更の例をコンポーネント別に一覧表示します。この一覧は、次の各手順を実行する際の手引きとして利用できます。

- バックアップとリカバリ
環境に対して管理上の変更を行った場合は、バックアップを実行することをお薦めします。この付録を使用すると、環境のバックアップが必要な管理上の変更のタイプを確認できます。

関連項目:

第VII部「高度な管理: バックアップとリカバリ」

- プライマリ・サイトとスタンバイ・サイトの障害時リカバリの同期
Disaster Recoveryを実装する場合は、環境に対する管理上の変更を行うときにスタンバイ・サイトを更新する必要があります。この付録を使用すると、スタンバイ・サイトの更新が必要な管理上の変更のタイプを確認できます。

関連項目:

『Oracle Fusion Middleware高可用性ガイド』

F.2 管理上の変更の例(コンポーネント別)

表F-1に、管理上の変更の例をコンポーネント別に示します。これらの操作の詳細は、各コンポーネントのドキュメントを参照してください。

表F-1 管理上の変更の例

コンポーネント

管理上の変更の例

Directory Integration and Provisioning

Directory Integration and Provisioningの管理操作および構成操作(ldapsearchユーティリティの実行など)

Dynamic Monitoring Service(DMS)

DMS構成ファイル(dms.confなど)の手動による編集

Fusion Middleware Control

Fusion Middleware Controlで実行する、ドメイン全体またはコンポーネント固有の管理操作および構成操作(ポート番号の変更、アプリケーションのデプロイとアンデプロイ、構成ファイルの変更を伴う操作など)

Oracle HTTP Server

Fusion Middleware Controlで実行するOracle HTTP Serverの管理操作および構成操作(mod_wl_ohsなどのモジュールの構成、仮想ホストの作成など)

Oracle HTTP Server構成ファイルの手動による編集

opmnctlユーティリティを使用した、Oracle HTTP Serverの管理操作および構成操作(ドメインへのコンポーネントの登録など)

Oracle Internet Directory

Oracle Internet Directoryの管理操作および構成操作(oidpasswdユーティリティ(パスワード管理)の実行、コンポーネントのインストールと削除など)

Oracle Forms Services

Fusion Middleware Controlで実行するOracle Forms Servicesの管理操作および構成操作

Oracle Portal

Fusion Middleware Controlで実行するOracle Portalの管理操作および構成操作

ポータル・ユーザー・インタフェースの管理画面を使用したOracle Portalの管理操作および構成操作

Oracle Portal構成ファイルの手動による編集

ptlconfigスクリプトの実行

Portalのデータベース側の構成を変更するPortal固有のスクリプトの実行(Oracle Web Cacheの無効化や、Portal内のなんらかのバックグラウンド・ジョブの頻度変更など)

Oracle BPEL Process Analytics

Fusion Middleware Controlで実行するOracle BPEL Process Analyticsの管理操作および構成操作

Oracle Reports Services

Fusion Middleware Controlで実行するOracle Reports Servicesの管理操作および構成操作(「Reports/Configuration」ページ上での操作など)

Oracle Reports Services構成ファイルの手動による編集

Reportsサーバーがジョブの挿入や更新を受信した場合(新規ジョブの追加時や、ジョブをあるキューから別のキューへ移動する際など)。注意: Oracle Reports Servicesの実行中は、バックアップとファイル同期化の頻度を高めることをお薦めします。

Oracle Web Cache

Fusion Middleware Controlで実行するOracle Web Cache構成プロパティ(「Webキャッシュ」メニュー→「管理」)

Oracle WebLogic Server管理コンソール

管理コンソールで実行する、ドメイン全体またはコンポーネント固有の管理操作および構成操作(パスワードの変更、アプリケーションのデプロイとアンデプロイ、構成ファイルの変更を伴う操作など)

G リリース番号の確認

この付録では、Oracle Fusion Middlewareのリリース番号の確認方法について説明します。

この付録の項目は次のとおりです。

- リリース番号の書式

- ソフトウェア・インベントリおよびリリース番号の確認

G.1 リリース番号の書式

Oracleで使用されるリリース・レベルの命名体系を理解するには、図G-1に示したOracle Fusion Middlewareのリリース番号の例を確認してください。

図G-1 Oracle Fusion Middlewareのリリース番号の例

「図G-1 Oracle Fusion Middlewareのリリース番号の例」の説明

図G-1の各数字のラベルの意味は次のとおりです。

- Oracleプラットフォームのバージョン番号
これは最も一般的な識別子です。これは、Oracleデータベース・サーバーやOracle Fusion Middlewareなどのアプリケーションの主要な新規版(バージョン)を表すものであり、そのリリースに重要な新機能が含まれることを表します。

- データベース・メンテナンス・リリース番号
この数字は、メンテナンス・リリース・レベルを表します。新機能がいくつか含まれている場合もあります。

- Oracle Fusion Middlewareのリリース番号
この数字は、Oracle Fusion Middlewareのリリース・レベルを表します。

- コンポーネント固有のリリース番号
この数字によって、コンポーネント固有のリリース・レベルが識別されます。コンポーネントが異なると、ここに表示される数値も異なることがあります。これは、コンポーネントのパッチ・セットや仮リリースなどに基づきます。

- プラットフォーム固有のリリース番号
この数字は、プラットフォーム固有のリリースを表します。

G.2 ソフトウェア・インベントリおよびリリース番号の確認

次の各項で、Oracle Fusion Middlewareのリリース番号の取得方法を説明します。

- Oracle Fusion Middlewareインストールのリリース番号の確認

- コンポーネント・リリース番号の確認

- Oracle Internet Directoryのリリース番号の確認

- メタデータ・リポジトリのリリース番号の確認

G.2.1 Oracle Fusion Middlewareインストールのリリース番号の確認

すべてのOracle Fusion Middlewareインストールにはリリース番号があります。この番号は、パッチ・セット・リリースの適用時やインストールのアップグレード時に更新されます。

Oracle Fusion Middlewareインストールのリリース番号は、Opatchを使用して確認できます。次のコマンドを実行します。

(UNIX) ORACLE_HOME/Opatch/opatch lsinventory
(Windows) ORACLE_HOME\Opatch\opatch lsinventory

UNIXの場合の例:

./opatch lsinventory
Invoking OPatch 11.1.0.8.3

Oracle Interim Patch Installer version 11.1.0.8.3
Copyright (c) 2010, Oracle Corporation.  All rights reserved.

Oracle Home       : /scratch/oracle1/Oracle/Middleware/Oracle_SOA1
Central Inventory : /scratch/oracle1/oraInventory
from           : /etc/oraInst.loc
OPatch version    : 11.1.0.8.3
OUI version       : 11.1.0.9.0
OUI location      : /scratch/oracle1/Oracle/Middleware/Oracle_SOA1/oui
Log file location : /scratch/oracle1/Oracle/Middleware/Oracle_SOA1/cfgtoollogs/opatch/opatch2011-07-18_13-55-10PM.log

Patch history file: /scratch/oracle1/Oracle/Middleware/Oracle_SOA1/cfgtoollogs/opatch/opatch_history.txt

OPatch detects the Middleware Home as "/scratch/oracle1/Oracle/Middleware"

Lsinventory Output file location : /scratch/oracle1/Oracle/Middleware/Oracle_SOA1/cfgtoollogs/opatch/lsinv/lsinventory2011-07-18_13-55-10PM.txt

--------------------------------------------------------------------------------
Installed Top-level Products (1):

Oracle SOA Suite 11g                                                 11.1.1.5.0
There are 1 products installed in this Oracle Home.

There are no Interim patches installed in this Oracle Home.

--------------------------------------------------------------------------------

OPatch succeeded.

G.2.2 Oracle WebLogic Serverのリリース番号の確認

Oracle WebLogic Serverのリリース番号は、次のコマンドを使用して確認できます。

(UNIX) cat $MW_HOME/wlserver_10.3/.product.properties | grep WLS_PRODUCT_VERSION
(Windows) type %MW_HOME%\wlserver_10.3\.product.properties | findstr WLS_PRODUCT_VERSION

UNIXの場合の例:

cat $MW_HOME/wlserver_10.3/.product.properties | grep WLS_PRODUCT_VERSION
WLS_PRODUCT_VERSION=10.3.6.0

G.2.3 コンポーネント・リリース番号の確認

Oracle Fusion Middlewareのすべてのコンポーネントにはリリース番号があり、コンポーネントの多くはリリース番号を持つサービスを備えています。これらの番号は、パッチ・セット・リリースの適用時またはインストールのアップグレード時に更新される可能性があります。

コンポーネントとそのサービスのリリース番号は、次のコマンドを使用して確認できます。

- UNIXの場合:

cd ORACLE_HOME/inventory
ls -d Components*/*/*

- Windowsの場合:

cd ORACLE_HOME/inventory/Componentsn
dir /S /A:D

G.2.4 Oracle Internet Directoryのリリース番号の確認

Oracle Internet Directoryにはサーバー・リリース番号があり、それはバイナリのバージョンです。また、スキーマおよびコンテキストのバージョンもあります。これらの番号はすべて、3桁目までOracle Fusion Middlewareインストールのリリース番号に対応しています。これらの番号は、パッチ・セット・リリースの適用時またはインストールのアップグレード時に更新される可能性があります。

Oracle Internet Directoryのサーバー・リリース番号の確認

Oracle Internet Directoryのサーバー・リリース番号は、バイナリのバージョンです。Oracle Internet Directoryのサーバー・リリース番号は、次の方法で確認できます。

1. ORACLE_HOME環境変数が設定されていることを確認します。

2. 次のコマンドを実行します。

(UNIX) ORACLE_HOME/bin/oidldapd -version
(Windows) ORACLE_HOME\bin\oidldapd -version

Oracle Internet Directoryのスキーマおよびコンテキストのバージョンの確認

Oracle Internet Directoryのスキーマおよびコンテキストのバージョンは、次のファイルで確認できます。

(UNIX) ORACLE_HOME/ldap/schema/versions.txt
(Windows) ORACLE_HOME\ldap\schema\versions.txt

このファイルのコンテンツは最新の状態に保たれていますが、確認のためにOracle Internet Directoryからスキーマおよびコンテキストのリリースを問い合せることもできます。

スキーマのバージョンを表示する手順は次のとおりです。

1. ORACLE_HOME環境変数が設定されていることを確認します。

2. 次のコマンドを実行します。

ldapsearch -h oid_host -p oid_port -D "cn=orcladmin"
-q -b "cn=base,cn=oracleschemaversion"
-s base "objectclass=*" orclproductversion

-qオプションを使用しているため、パスワードの入力が求められます。

出力結果は次のような形式になります。

cn=BASE,cn=OracleSchemaVersion
orclproductversion=90500

コンテキストのバージョンを表示する手順は次のとおりです。

1. ORACLE_HOME環境変数が設定されていることを確認します。

2. 次のコマンドを実行します。

ldapsearch -h oid_host -p oid_port -D "cn=orcladmin"
-q -b "cn=oraclecontext" -s base "objectclass=*" orclversion

-qオプションを使用しているため、パスワードの入力が求められます。

出力結果は次のような形式になります。

cn=oraclecontext
orclversion=101200

G.2.5 メタデータ・リポジトリのリリース番号の確認

メタデータ・リポジトリにOracle Databaseインスタンスを使用している場合、データベースのリリース番号は、SQL*Plusを使用して次のように確認できます(どのようなユーザーとしてデータベースに接続していても、これらのコマンドは発行できます)。

SQL> COL PRODUCT FORMAT A40
SQL> COL VERSION FORMAT A15
SQL> COL STATUS FORMAT A15
SQL> SELECT * FROM PRODUCT_COMPONENT_VERSION;

PRODUCT                                    VERSION         STATUS
----------------------------------         --------------  ----------------
NLSRTL                                     11.2.0.1.0      Production
Oracle Database 11g Enterprise Edition     11.2.0.1.0      Production
PL/SQL                                     11.2.0.1.0      Production
TNS for Linux:                             11.2.0.1.0      Production

G.2.6 スキーマのリリース番号の確認

メタデータ・リポジトリにOracle Databaseインスタンスを使用している場合、スキーマのリリース番号は、SQL*Plusを使用して次のように確認できます。

SQL> COL COMP_ID FORMAT A20
SQL> COL COMP_NAME A30
SQL> COL VERSION FORMAT A20
SQL> SELECT COMP_ID, COMP_NAME, VERSION FROM SCHEMA_VERSION_REGISTRY;

COMP_ID              COMP_NAME                     VERSION
-------------------- ----------------------------- --------------------
APM                  Authorization Policy Manager  11.1.1.3.0

BAM                  BAM Services                  11.1.1.5.0

BIPLATFORM           OracleBI and EPM              11.1.1.4.0
.
.
.

H Oracle Wallet Managerおよびorapki

Oracle Application Server 10gには、ウォレットおよび証明書の管理用の次のユーティリティがありました。

- PKI証明書を管理するグラフィカル・ユーザー・インタフェース・ツールであるOracle Wallet Manager

- 証明書失効リスト(CRL)の管理、Oracleウォレットの作成と管理、およびテスト用の署名付き証明書の作成のためのコマンドライン・ツールであるorapkiユーティリティ

また、Oracle Application Server 10gでは、SSL構成ツールが提供されていました。

Oracle Fusion Middleware 11g リリース1(11.1.1)には、次の機能があります。

- 追加のorapki機能

- Fusion Middleware Controlを使用した、JKSベースのキーストア、ウォレットおよび証明書の管理機能

- SSLを構成するコマンドライン・ツールとグラフィカル・ユーザー・インタフェースの両方。詳細は、第6章を参照してください。

この付録でorapkiの更新について学習するとともに、11g リリース1(11.1.1)で提供される新たな証明書、ウォレットの管理、およびSSL構成ツールへの移行の参考としてください。この付録の項目は次のとおりです。

- 新しいorapki機能

- 証明書の検証とCRL管理にorapkiユーティリティを使用する方法

- Oracle Wallet Managerと同等の機能

- orapkiと同等の機能

- SSL構成ツールと同等の機能

関連項目:

Oracle Wallet Managerおよびorapkiの使用の詳細は、Oracle Advanced Security管理者ガイドを参照してください。

http://docs.oracle.com/cd/E11882_01/network.112/e10746/toc.htm

注意:

orapkiユーティリティは、Oracle共通ホームのバイナリ・ディレクトリ$MIDDLEWARE_HOME/oracle_common/binにあります。

注意:

マルチバイト・キャラクタ・セット(MBCS)に基づくウォレット名はサポートされていません。MBCSを使用してウォレットを作成しないでください。

H.1 新しいorapki機能

orapkiコマンドライン・ユーティリティには、Oracle Fusion Middleware 11gリリース1(11.1.1)における次の新機能が含まれています。

- orapkiの使用例

- 新しいCRL管理機能

- 新しいバージョン3の証明書サポート

- トラスト・チェーンのエクスポート

- ウォレット・パスワードの変更

- OracleウォレットとJKSキーストア間の変換

H.1.1 orapkiの使用例

関連項目:

ドキュメントID 1226654.1 FMW 11gにおけるORAPKIを使用したウォレットの作成方法(OTNナレッジ・ベースにあります)

orapkiの使用例は次のとおりです。

# Create root wallet (for example, CA wallet)
orapki wallet create -wallet ./root -pwd mypasswd

# Add a self-signed certificate (CA certificate) to the root wallet
orapki wallet add -wallet ./root -dn 'CN=root_test,C=US' -keysize 1024 -self_signed -validity 3650 -pwd mypasswd

# Export self-signed certificate from the wallet
orapki wallet export -wallet ./root -dn 'CN=root_test,C=US' -cert ./root/b64certificate.txt -pwd mypasswd

# Create a user wallet (for example, a customer wallet)
orapki wallet create -wallet ./user -pwd mypasswd

# Add a certificate request
orapki wallet add -wallet ./user -dn 'CN=user_test,C=US' -keysize 1024 -pwd mypasswd

# Export the certificate request
orapki wallet export -wallet ./user -dn 'CN=user_test,C=US' -request ./user/creq.txt -pwd mypasswd

# Create a certificate (issued by CA)
orapki cert create -wallet ./root -request ./user/creq.txt -cert ./user/cert.txt -validity 3650 -pwd mypasswd

# Add a trusted certificate (CA certificate) to the wallet
orapki wallet add -wallet ./user -trusted_cert -cert ./root/b64certificate.txt -pwd mypasswd

# Add a user certificate
orapki wallet add -wallet ./user -user_cert -cert ./user/cert.txt -pwd mypasswd

# Display contents of wallet
orapki wallet display -wallet ./root -pwd mypasswd

H.1.2 新しいCRL管理機能

orapkiでは、CRLの操作のために複数の新たなコマンド・オプションをサポートしています。

CRLの作成

CRLを作成するには、orapki crl createを使用します。

第H.2.6.3項「orapki crl create」を参照してください。

証明書の取消し

証明書を取り消すには、orapki crl revokeを使用します。

第H.2.6.8項「orapki crl revoke」を参照してください。

CRL署名の確認

CRL署名を確認するには、orapki crl verifyを使用します。

第H.2.6.11項「orapki crl verify」を参照してください。

証明書がCRL内で取り消されているかどうかのチェック

証明書が取り消されているかどうかを確認するには、orapki crl statusを使用します。

第H.2.6.9項「orapki crl status」を参照してください。

H.1.3 新しいバージョン3の証明書サポート

orapkiには次の機能があります。

- 証明書リクエストにサブジェクト・キー識別子の拡張子を追加する機能

- バージョン3の自己署名証明書をウォレットに追加する機能

これらの機能の詳細は、第H.2.6.12項「orapki wallet add」を参照してください。

H.1.4 トラスト・チェーンのエクスポート

ユーザーのトラストのチェーン(証明書チェーン)をエクスポートするには、orapki wallet export_trust_chainを使用します。

第H.2.6.17項「orapki wallet export_trust_chain」を参照してください。

H.1.5 ウォレット・パスワードの変更

ウォレット・パスワードを変更するには、orapki wallet change_pwdを使用します。

第H.2.6.13項「orapki wallet change_pwd」を参照してください。

H.1.6 OracleウォレットとJKSキーストア間の変換

JKSキーストアからOracleウォレットへの変換およびOracleウォレットからJKSへの変換を実行できます。

JKSからOracleウォレットへの変換

エントリをJKSストアからp12ウォレットに移行するには、次のコマンドを使用します。

jks_to_pkcs12 -wallet wallet -pwd pwd -keystore keystore
-jkspwd jkspwd [-aliases [alias:alias..]]

このコマンドのパラメータは次のとおりです。

- walletはウォレット・ロケーションです。エントリがJKSキーストアからこのウォレットに移行されます。

- pwdはウォレット・パスワードです。

- keystoreはキーストアの場所です。このJKSはp12ウォレットに移行されます。

- jkspwdはJKSパスワードです。

- aliasesはオプションです。これを指定すると、指定した別名に対応するエントリのみが移行されます。指定しないと、すべてのエントリが移行されます。

このコマンドについて説明するために、自己署名JKSキーストアの作成から始めます。

keytool -genkey -alias myalias -keyalg RSA -keysize 1024 -dname CN=root,C=US -validity 3650 -keystore ./ewallet.jks -storetype jks -storepass password
-keypass password

次に、Oracleウォレットを作成します。

orapki wallet create -wallet ./ -pwd password

JKSキーストアのエントリをウォレットに移行します。

orapki wallet jks_to_pkcs12 -wallet ./ -pwd password -keystore ./ewallet.jks -jkspwd password

注意:

この例では、ウォレットは新しく作成されたため空です。しかし実際には、このコマンドを使用するときにウォレットが空である必要はありません。事前に存在しているエントリは保持されます。

OracleウォレットからJKSへの変換

エントリをp12ウォレットからJKSキーストアに移行するには、次のコマンドを使用します。

pkcs12_to_jks -wallet p12wrl -pwd p12pwd
[-jksKeyStoreLoc jksKSloc -jksKeyStorepwd jksKS_pwd][-jksTrustStoreLoc loc -jksTrustStorepwd pwd]

このコマンドのパラメータは次のとおりです。

- walletはp12ウォレット・ロケーションです。

- pwdはウォレット・パスワードです。

- jksKeyStoreLocはJKSキーストアの場所です。

- jksKeyStorepwdはJKSキーストア・パスワードです。

- jksTrustStoreLocはJKSトラストストアの場所です。

- jksTrustStorepwdはJKSトラストストア・パスワードです。

注意:

パスワードは、8文字以上で、アルファベットと、数字または特殊文字の組合せを含んでいる必要があります。

次の例では、すべてのウォレットのエントリが同じJKSキーストアに移行されます。

orapki wallet pkcs12_to_jks -wallet ./ -pwd mypasswd -jksKeyStoreLoc ./ewallet.jks -jksKeyStorepwd mypasswd2

次の例では、キーおよび信頼できる証明書のエントリが別々のJKSキーストアに移行されます。

orapki wallet pkcs12_to_jks -wallet ./ -pwd mypasswd
-jksKeyStoreLoc ./ewalletK.jks -jksKeyStorepwd mypasswd2
-jksTrustStoreLoc ./ewalletT.jks -jksTrustStorepwd mypasswd2

H.2 証明書の検証とCRL管理にorapkiユーティリティを使用する方法

この項の項目は次のとおりです。

- orapkiの概要

- orapkiヘルプの表示

- テスト用の署名付き証明書の作成

- orapkiユーティリティを使用したOracleウォレットの管理

- orapkiユーティリティを使用した証明書失効リスト(CRL)の管理

- orapkiユーティリティ・コマンドのサマリー

H.2.1 orapkiの概要

orapkiユーティリティは、公開鍵インフラストラクチャ(PKI)要素(ウォレット、証明書失効リストなど)をコマンドラインで管理できるようにするために提供されています。これにより、実行するタスクをスクリプトに組み込むことができます。これを使用して、PKIを保守するルーチン・タスクの多くを自動化できます。

このコマンドライン・ユーティリティを使用して、次のタスクを実行できます。

- テスト用の署名付き証明書の作成

- Oracleウォレットの管理

- Oracleウォレットの作成と表示

- 証明書リクエストの追加と削除

- 証明書の追加と削除

- 信頼できる証明書の追加と削除

- 証明書失効リスト(CRL)の管理

- 証明書検証用ハッシュ値によるCRLの名前変更

- Oracle Internet DirectoryでのCRLのアップロード、一覧表示、表示および削除

orapkiを使用すると、証明書をDERフォーマットとPEMフォーマットの両方でインポートできます。

H.2.1.1 orapkiの構文

orapkiコマンドライン・ユーティリティの基本的な構文を次に示します。

orapki module command -parameter value

このコマンドでは、moduleをwallet(Oracleウォレット)、crl(証明書失効リスト)またはcert(PKIデジタル証明書)にできます。使用可能なコマンドは、使用するmoduleによって異なります。たとえば、walletを使用している場合、addコマンドを使用して証明書またはキーをウォレットに追加できます。次の例では、/private/lhale/cert.txtにあるユーザー証明書が、ORACLE_HOME/wallet/ewallet.p12にあるウォレットに追加されます。

orapki wallet add -wallet ORACLE_HOME/wallet/ewallet.p12
-user_cert -cert /private/lhale/cert.txt

H.2.1.2 orapkiの環境設定

orapkiを実行するとき、次のいずれかの環境設定になっていることを確認してください。

- アイデンティティ管理、Web層またはClassicのインストール環境のコンテキストで実行している場合、ORACLE_HOMEを、製品のインストール場所を指すように設定します。

- Oracle SOA SuiteまたはOracle WebCenter Portalのインストール環境のコンテキストで実行している場合、JAVA_HOMEを、Java 1.5以降を含む有効なJDKの場所を指すように設定します。

H.2.2 orapkiヘルプの表示

コマンドラインで次のコマンドを入力することにより、特定のモードで使用可能なorapkiコマンドをすべて表示できます。

orapki mode help

たとえば、証明書失効リスト(CRL)を管理するために使用可能なコマンドをすべて表示するには、コマンドラインに次のように入力します。

orapki crl help

注意:

-summary、-completeまたは-walletコマンド・オプションの使用は、常にオプションです。これらのコマンド・オプションが指定されていなくても、コマンドは実行されます。

H.2.3 テスト用の署名付き証明書の作成

このコマンドライン・ユーティリティは、テスト用の署名付き証明書を作成する便利で手軽な方法を提供します。次の構文を使用して、署名付き証明書を作成し、証明書を表示できます。

テスト用の署名付き証明書を作成するには:

orapki cert create [-wallet wallet_location] -request
certificate_request_location
-cert certificate_location -validity number_of_days [-summary]

このコマンドにより、証明書リクエストから署名付き証明書が作成されます。-walletパラメータは、証明書リクエストへの署名に使用されるユーザー証明書と秘密鍵を含むウォレットを指定します。-validityパラメータは、現在の日付から数えてこの証明書が有効である日数を指定します。証明書と証明書リクエストの指定は、このコマンドでは必須です。

証明書を表示するには:

orapki cert display -cert certificate_location [-summary | -complete]

このコマンドを使用すると、orapkiを使用して作成したテスト証明書を表示できます。-summaryまたは-completeのいずれかを選択できます。これによりコマンドが表示するデータの詳細さが決まります。-summaryを選択すると、証明書とその有効期限が表示されます。-completeを選択すると、シリアル番号、公開鍵などの追加の証明書情報が表示されます。

H.2.4 orapkiユーティリティを使用したOracleウォレットの管理

次の各項では、orapkiコマンドライン・ユーティリティを使用してOracleウォレットの作成および管理を行うために使用される構文について説明します。これらのorapkiユーティリティのwalletモジュール・コマンドをスクリプトで使用して、ウォレット作成プロセスを自動化できます。

- orapkiを使用したOracleウォレットの作成と表示

- orapkiを使用した証明書と証明書リクエストのOracleウォレットへの追加

- orapkiを使用した証明書と証明書リクエストのOracleウォレットからのエクスポート

注意:

-walletパラメータは、すべてのwalletモジュール・コマンドで必須です。

関連項目:

パスワードで保護されたウォレットまたは自動ログイン・ウォレットの作成方法の例は、ドキュメントID 1226654.1 FMW 11gにおけるORAPKIを使用したウォレットの作成方法(OTNナレッジ・ベースにあります)を参照してください。

H.2.4.1 orapkiを使用したOracleウォレットの作成と表示

Oracleウォレットを作成するには:

orapki wallet create -wallet wallet_location

このコマンドを使用すると、ウォレット・パスワードの入力と再入力を求めるプロンプトが表示されます。-walletで指定された場所にウォレットが作成されます。

自動ログインが有効なOracleウォレットを作成するには:

orapki wallet create -wallet wallet_location -auto_login

このコマンドを使用すると、自動ログインが有効なウォレットが作成されます。また、このコマンドは、既存のウォレットの自動ログインを有効にするためにも使用できます。wallet_locationにすでにウォレットが含まれている場合、そのウォレットの自動ログインが有効になります。自動ログイン機能を無効にするには、cwallet.ssoを削除します。

注意:

自動ログイン機能を有効にしたウォレットでは、addなど、ウォレットを変更する操作に対してのみパスワードの入力を求めるプロンプトが表示されます。

Oracleウォレットを表示するには:

orapki wallet display -wallet wallet_location

このコマンドを使用すると、ウォレットに含まれている証明書リクエスト、ユーザー証明書および信頼できる証明書が表示されます。

H.2.4.2 orapkiを使用した証明書と証明書リクエストのOracleウォレットへの追加

証明書リクエストをOracleウォレットに追加するには:

orapki wallet add -wallet wallet_location -dn user_dn -keysize 512|1024|2048|4096

このコマンドを使用すると、指定した識別名(user_dn)を持つユーザーのウォレットに証明書リクエストが追加されます。このリクエストでは、リクエストされた証明書のキー・サイズ(512、1024または2048ビット)も指定します。リクエストに署名するには、エクスポート・オプションを使用してそのリクエストをエクスポートします。第H.2.4.3項「orapkiを使用した証明書と証明書リクエストのOracleウォレットからのエクスポート」を参照してください。

信頼できる証明書をOracleウォレットに追加するには:

orapki wallet add -wallet wallet_location -trusted_cert -cert
certificate_location

このコマンドを使用すると、指定した場所(-cert certificate_location)にある信頼できる証明書がウォレットに追加されます。ユーザー証明書を追加する前に、ユーザー証明書の証明書チェーンにあるすべての信頼できる証明書を追加する必要があります。そうしないと、ユーザー証明書を追加するコマンドは失敗します。

ルート証明書をOracleウォレットに追加するには:

orapki wallet add -wallet wallet_location -dn
certificate_dn -keysize 512|1024|2048 -self_signed -validity number_of_days

このコマンドを使用すると、新しい自己署名(ルート)証明書が作成され、ウォレットに追加されます。-validityパラメータ(必須)は、現在の日付から数えてこの証明書が有効である日数を指定します。このルート証明書のキー・サイズ(-keysize)は、512、1024、2048または4096ビットに指定できます。

ユーザー証明書をOracleウォレットに追加するには:

orapki wallet add -wallet wallet_location -user_cert -cert certificate_location

このコマンドを使用すると、-certパラメータで指定された場所にあるユーザー証明書が、wallet_locationにあるOracleウォレットに追加されます。ユーザー証明書をウォレットに追加する前に、証明書チェーンを構成するすべての信頼できる証明書を追加する必要があります。ユーザー証明書を追加する前に、すべての信頼できる証明書がウォレットに追加されていない場合、ユーザー証明書の追加は失敗します。

H.2.4.3 orapkiを使用した証明書と証明書リクエストのOracleウォレットからのエクスポート

証明書をOracleウォレットからエクスポートするには:

orapki wallet export -wallet wallet_location -dn
certificate_dn -cert certificate_filename

このコマンドを使用すると、サブジェクトの識別名(-dn)を持つ証明書が、ウォレットから-certで指定されたファイルにエクスポートされます。

証明書リクエストをOracleウォレットからエクスポートするには:

orapki wallet export -wallet wallet_location -dn
certificate_request_dn -request certificate_request_filename

このコマンドを使用すると、サブジェクトの識別名(-dn)を持つ証明書リクエストが、ウォレットから-requestで指定されたファイルにエクスポートされます。

H.2.5 orapkiユーティリティを使用した証明書失効リスト(CRL)の管理

CRLは、orapkiを使用して管理する必要があります。このユーティリティは、CRL発行者名のハッシュ値を作成して、システム内でCRLの場所を特定します。orapkiを使用しないと、Oracleサーバーは、CRLを探してPKIデジタル証明書を検証することができません。次の各項では、CRLについて、CRLの使用方法、およびorapkiを使用してCRLを管理する方法について説明します。

- 第H.2.5.1項「証明書失効リストを使用した証明書の検証について」

- 第H.2.5.2項「証明書失効リストの管理」

関連項目:

orapkiでのCRLの管理の詳細は、Oracle Advanced Security管理者ガイドの証明書失効リストの管理に関する説明を参照してください。

http://docs.oracle.com/cd/E11882_01/network.112/e10746/asossl.htm

H.2.5.1 証明書失効リストを使用した証明書の検証について

指定の証明書を指定のコンテキストで使用できるかどうかを判定するプロセスは、証明書の検証と呼ばれます。証明書の検証には、次の項目の判定が含まれます。

- 信頼できる認証局(CA)にデジタル署名された証明書があるかどうか。

- 証明書のデジタル署名が、証明書自体の別個に計算されたハッシュ値および証明書の署名者の(CAの)公開鍵に対応しているかどうか。

- 証明書が期限切れになっていないかどうか。

- 証明書が失効していないかどうか。

SSLネットワーク・レイヤーは、自動的に最初の3つの検証チェックを実行しますが、証明書が失効していないことを確認するには、証明書失効リスト(CRL)のチェックを構成する必要があります。CRLは、失効した証明書のリストを含む署名付きデータ構造体です。これは通常、元の証明書を発行したエンティティと同じエンティティによって発行され署名されます。

H.2.5.1.1 使用するCRL

使用するトラスト・ポイントすべてについてCRLが必要です。トラスト・ポイントは、一定の信頼レベルで資格を与えられたサード・パーティ・アイデンティティからの信頼できる証明書です。通常、信頼する認証局はトラスト・ポイントと呼ばれます。

H.2.5.1.2 CRLチェックのしくみ

証明書失効ステータスは、ファイル・システム・ディレクトリ(Oracle Internet Directory)にあるCRL、または証明書のCRL配布ポイント(CRL DP)の拡張子で指定された場所からダウンロードしたCRLに対してチェックされます。CRLをローカル・ファイル・システムまたはディレクトリに格納する場合、CRLを定期的に更新する必要があります。CRL DPを使用する場合、CRLは、対応する証明書が最初に使用されるときにダウンロードされます。

サーバーは、次の場所で(ここに示されている順番で)CRLを検索します。システムは、証明書のCAのDNと一致するCRLを検出すると、検索を停止します。

1. ローカル・ファイル・システム
システムは、まずsqlnet.oraファイルのSSL_CRL_FILEパラメータを確認し、それからSSL_CRL_PATHパラメータを確認します。システムは、これらの2つのパラメータが指定されていない場合、ウォレット・ロケーションで任意のCRLをチェックします。

注意: CRLをローカル・ファイル・システムに格納する場合、orapkiユーティリティを使用してCRLを定期的に更新する必要があります。第H.2.5.2.1項「証明書検証用ハッシュ値によるCRLの名前変更」を参照してください。

2. Oracle Internet Directory
サーバーは、ローカル・ファイル・システムでCRLを検出できず、ORACLE_HOME/ldap/admin/ldap.oraファイルでディレクトリ接続情報が構成されている場合、このディレクトリを検索します。これは、CAの識別名(DN)およびCRLサブツリーのDNを使用してCRLサブツリーを検索します。

ディレクトリでCRLを検索するためには、サーバーに、適切に構成されたldap.oraファイルが存在している必要があります。Oracle Internet Directoryのドメイン・ネーム・システム(DNS)検出機能は使用できません。また、CRLをディレクトリに格納する場合、orapkiユーティリティを使用してCRLを定期的に更新する必要があることに注意してください。第H.2.5.2.2項「Oracle Internet DirectoryへのCRLのアップロード」を参照してください。

3. CRL DP
CAが、証明書が発行されたときのCRL DP X.509、バージョン3、証明書拡張子内の位置を指定すると、その証明書用の失効情報を含む適切なCRLがダウンロードされます。現在、Oracle Advanced Securityは、HTTPおよびLDAPを介したCRLのダウンロードをサポートしています。

注意:

- パフォーマンス上の理由から、ユーザー証明書のみがチェックされます。

- CRLをローカル・ファイル・システムではなくディレクトリに格納することをお薦めします。

H.2.5.2 証明書失効リストの管理

証明書失効ステータスのチェックを有効にするには、まず、使用するCAから受信したCRLがシステムで使用できるフォームである(ハッシュ値で名前変更されている)こと、またはシステムで使用できる場所にある(ディレクトリにアップロードされている)ことを確認してください。Oracle Advanced Securityには、次のタスクを実行するために使用できるコマンドライン・ユーティリティ(orapki)があります。

- 証明書検証用ハッシュ値によるCRLの名前変更

- Oracle Internet DirectoryへのCRLのアップロード

- Oracle Internet Directoryに格納されているCRLの一覧表示

- Oracle Internet DirectoryでのCRLの表示

- Oracle Internet DirectoryからのCRLの削除

注意:

CRLは、正常な検証を行うために、(期限切れになる前に)定期的に更新する必要があります。このタスクは、スクリプトでorapkiコマンドを使用して自動化できます。

LDAPコマンドライン・ツールを使用して、Oracle Internet DirectoryでCRLを管理することもできます。

関連項目:

LDAPコマンドライン・ツールおよびその構文については、Oracle Fusion Middleware Oracle Identity Managementリファレンスのコマンドライン・ツールの概要に関する項を参照してください。

H.2.5.2.1 証明書検証用ハッシュ値によるCRLの名前変更

システムは、証明書を検証するとき、証明書を作成したCAが発行するCRLを見つける必要があります。システムは、証明書の発行者名とCRLにある発行者名を照合して適切なCRLを検出します。

Oracle Net Managerの「証明書失効リスト・パス」フィールドにCRL格納場所を指定する(sqlnet.oraファイルのSSL_CRL_PATHパラメータを設定する)場合、orapkiユーティリティを使用して発行者名を表すハッシュ値を使用してCRLを名前変更します。ハッシュ値を作成すると、サーバーでCRLをロードできます。

UNIXシステムでは、orapkiによってCRLへのシンボリック・リンクが作成されます。Windowsシステムでは、CRLファイルのコピーが作成されます。どちらの場合も、orapkiによって作成されたシンボリック・リンクまたはコピーは、発行者名のハッシュ値を使用して名前が付けられます。その後、システムが証明書を検証するとき、同じハッシュ関数が使用されて、適切なCRLをロードできるようにリンク(またはコピー)の名前が計算されます。

ご使用のオペレーティング・システムに応じて、次のコマンドのいずれかを入力して、ファイル・システムに格納されているCRLの名前を変更します。

UNIXファイル・システムに格納されているCRLの名前を変更するには:

orapki crl hash -crl crl_filename [-wallet wallet_location]
-symlink crl_directory [-summary]

Windowsファイル・システムに格納されているCRLの名前を変更するには:

orapki crl hash -crl crl_filename
[-wallet wallet_location] -copy crl_directory [-summary]

このコマンドで、crl_filenameはCRLファイルの名前、wallet_locationはCRLを発行したCAの証明書を含むウォレットの場所、crl_directoryはCRLがあるディレクトリです。

-walletおよび-summaryの使用はオプションです。-walletを指定すると、CRLの名前を変更する前に、ツールによってCAの証明書に対するCRLの有効性が確認されます。-summaryオプションを指定すると、ツールによってCRL発行者名が表示されます。

H.2.5.2.2 Oracle Internet DirectoryへのCRLのアップロード

ディレクトリでCRLを発行すると、企業全体でのCRL検証が可能になり、個々のアプリケーションに固有のCRLを構成する必要がなくなります。すべてのアプリケーションで、一元的に管理可能なディレクトリに格納されたCRLを使用できるので、CRL管理および使用の管理オーバーヘッドが大幅に減ります。

orapkiを使用してディレクトリにCRLをアップロードするユーザーは、ディレクトリ・グループCRLAdmins(cn=CRLAdmins,cn=groups,%s_OracleContextDN%)のメンバーである必要があります。これらのCRLには企業全体でアクセスできるため、これは特権操作です。この管理ディレクトリ・グループに追加するには、ディレクトリ管理者に連絡してください。

CRLをディレクトリにアップロードするには:

orapki crl upload -crl crl_location
-ldap hostname:ssl_port -user username [-wallet wallet_location] [-summary]

このコマンドで、crl_locationはCRLがあるファイル名またはURL、hostnameおよびssl_port(認証なしのSSLポート)はディレクトリがインストールされているシステムに対するもの、usernameはCRLをCRLサブツリーに追加する権限があるディレクトリ・ユーザー、wallet_locationはCRLを発行したCAの証明書を含むウォレットの場所です。

-walletおよび-summaryの使用はオプションです。-walletを指定すると、CRLをディレクトリにアップロードする前に、ツールによってCAの証明書に対するCRLの有効性が確認されます。-summaryオプションを指定すると、CRL発行者名、およびCRLがディレクトリに格納されているLDAPエントリがツールによって印刷されます。

注意:

- orapkiユーティリティを使用すると、この操作の実行時にディレクトリ・パスワードの入力を求めるプロンプトが表示されます。

- Diffie-HellmanベースのSSLサーバーが実行されているディレクトリのSSLポートを指定していることを確認してください。これは、認証を実行しないSSLポートです。サーバー認証も相互認証SSLポートも、orapkiユーティリティではサポートされていません。

H.2.5.2.3 Oracle Internet Directoryに格納されているCRLの一覧表示

orapkiを使用してディレクトリに格納されているすべてのCRLのリストを表示できます。特定のCRLを検出してローカル・システムで表示またはダウンロードする際に、このリストを参照すると便利です。このコマンドを使用すると、CRLを発行したCA(発行者)およびディレクトリのCRLサブツリー内の場所(DN)が表示されます。

Oracle Internet DirectoryでCRLを一覧表示するには:

orapki crl list -ldap hostname:ssl_port

このコマンドで、hostnameおよびssl_portは、ディレクトリがインストールされているシステムに対するものです。これは、前の項で説明した認証なしのディレクトリのSSLポートであることに注意してください。

H.2.5.2.4 Oracle Internet DirectoryでのCRLの表示

Oracle Internet Directoryに格納されている特定のCRLを要約された形式で表示するか、特定のCRLについて失効した証明書の完全なリストを要求できます。サマリー・リストには、CRL発行者名およびその有効期間が記載されています。完全なリストには、そのCRLに含まれるすべての失効した証明書のリストが記載されています。

Oracle Internet DirectoryでCRLのサマリー・リストを表示するには:

orapki crl display -crl crl_location [-wallet wallet_location] -summary

このコマンドで、crl_locationはディレクトリ内のCRLの場所です。orapki crl listコマンドを使用すると表示されるリストからCRLの位置を貼り付けると便利です。第H.2.5.2.3項「Oracle Internet Directoryに格納されているCRLの一覧表示」を参照してください。

Oracle Internet Directoryに格納されている指定したCRLに含まれているすべての失効した証明書のリストを表示するには:

orapki crl display -crl crl_location [-wallet wallet_location] -complete

たとえば、orapkiコマンドを次のように入力します。

orapki crl display -crl $T_WORK/pki/wlt_crl/nzcrl.txt -wallet $T_WORK/pki/wlt_crl -complete

次の出力が生成されます。これには、CRL発行者のDN、発行日、次の更新日、および含まれる失効した証明書が示されます。

issuer = CN=root,C=us, thisUpdate = Sun Nov 16 10:56:58 PST 2003,
nextUpdate = Mon Sep 30 11:56:58 PDT 2013, revokedCertificates =
{(serialNo = 153328337133459399575438325845117876415,
revocationDate - Sun Nov 16 10:56:58 PST 2003)}
CRL is valid

-walletオプションを使用すると、orapki crl displayコマンドにより、CAの証明書に対してCRLが検証されます。

-completeオプションを選択すると、CRLのサイズによっては、表示に時間がかかる場合があります。

Oracle Directory Manager(Oracle Internet Directoryに付属するグラフィカル・ユーザー・インタフェース)を使用して、ディレクトリ内のCRLを表示することもできます。CRLは、次のディレクトリの場所に格納されます。

cn=CRLValidation,cn=Validation,cn=PKI,cn=Products,cn=OracleContext

H.2.5.2.5 Oracle Internet DirectoryからのCRLの削除

orapkiを使用してディレクトリからCRLを削除するユーザーは、ディレクトリ・グループCRLAdminsのメンバーである必要があります。このディレクトリ管理グループの詳細は、第H.2.5.2.2項「Oracle Internet DirectoryへのCRLのアップロード」を参照してください。

CRLをディレクトリから削除するには:

orapki crl delete -issuer issuer_name -ldap hostname:ssl_port
-user username [-summary]

このコマンドで、issuer_nameはCRLを発行したCAの名前、hostnameおよびssl_portはディレクトリがインストールされているシステムに対するもの、usernameはCRLをCRLサブツリーから削除する権限があるディレクトリ・ユーザーです。このポートは、認証を使用しないディレクトリのSSLポートであることが必要です。このポートの詳細は、第H.2.5.2.2項「Oracle Internet DirectoryへのCRLのアップロード」を参照してください。

-summaryオプションを使用すると、削除されたCRL LDAPエントリがツールによって印刷されます。

たとえば、orapkiコマンドを次のように入力します。

orapki crl delete -issuer "CN=root,C=us"
-ldap machine1:3500 -user cn=orcladmin -summary

次の出力が生成されます。これには、ディレクトリ内の削除されたCRLの場所が示されます。

Deleted CRL at cn=root
cd45860c.rN,cn=CRLValidation,cn=Validation,cn=PKI,cn=Products,cn=OracleContext

H.2.6 orapkiユーティリティ・コマンドのサマリー

この項では、次のorapkiコマンドについて説明します。

- orapki cert create

- orapki cert display

- orapki crl create

- orapki crl delete

- orapki crl display

- orapki crl hash

- orapki crl list

- orapki crl revoke

- orapki crl status

- orapki crl upload

- orapki crl verify

- orapki wallet add

- orapki wallet change_pwd

- orapki wallet create

- orapki wallet display

- orapki wallet export

- orapki wallet export_trust_chain

H.2.6.1 orapki cert create

次の各項では、このコマンドについて説明します。

H.2.6.1.1 目的

このコマンドは、テスト用の署名付き証明書を作成するために使用します。

H.2.6.1.2 構文

orapki cert create [-wallet wallet_location]
-request certificate_request_location
-cert certificate_location -validity number_of_days [-summary]

- -walletパラメータは、証明書リクエストへの署名に使用されるユーザー証明書と秘密鍵を含むウォレットを指定します。

- -requestパラメータ(必須)は、作成する証明書の証明書リクエストの場所を指定します。

- -certパラメータ(必須)は、ツールが新しい署名付き証明書を配置するディレクトリの場所を指定します。

- -validityパラメータ(必須)は、現在の日付から数えてこの証明書が有効である日数を指定します。

H.2.6.2 orapki cert display

次の各項では、このコマンドについて説明します。

H.2.6.2.1 目的

このコマンドは、特定の証明書の詳細を表示するために使用します。

H.2.6.2.2 構文

orapki cert display -cert certificate_location [-summary|-complete]

- -certパラメータは、表示する証明書の場所を指定します。

- -summaryパラメータまたは-completeパラメータのいずれかを使用して、次の情報を表示できます。

- -summaryを使用すると、証明書およびその有効期限が表示されます。

- -completeを使用すると、シリアル番号、公開鍵などの追加の証明書情報が表示されます。

H.2.6.3 orapki crl create

次の各項では、このコマンドについて説明します。

H.2.6.3.1 目的

このコマンドは、CRLを作成するために使用します。

H.2.6.3.2 構文

orapki crl create [-crl [url|filename]]
[-wallet [cawallet]]
[-nextupdate [days]]
[-pwd pwd]

- -crlは、CRLが作成される場所です(たとえば、./nzcrl.txt)。

- -walletは、自己署名証明書と対応する秘密鍵を含むCAウォレットです。

- -nextupdateは、次回更新までの日数です。

- -pwdは、CAウォレットのパスワードです。

H.2.6.4 orapki crl delete

次の各項では、このコマンドについて説明します。

H.2.6.4.1 目的

このコマンドは、CRLをOracle Internet Directoryから削除するために使用します。orapkiを使用してディレクトリからCRLを削除するユーザーは、CRLAdmins(cn=CRLAdmins,cn=groups,%s_OracleContextDN%)ディレクトリ・グループのメンバーである必要があることに注意してください。

H.2.6.4.2 構文

orapki crl delete -issuer issuer_name
-ldap hostname:ssl_port -user username [-summary]

- -issuerパラメータは、CRLを発行した認証局(CA)の名前を指定します。

- -ldapパラメータは、CRLが削除されるディレクトリのホスト名およびSSLポートを指定します。このポートは、認証を使用しないディレクトリのSSLポートであることが必要です。このポートの詳細は、第H.2.5.2.2項「Oracle Internet DirectoryへのCRLのアップロード」を参照してください。

- -userパラメータは、ディレクトリのCRLサブツリーからCRLを削除する権限のあるディレクトリ・ユーザーのユーザー名を指定します。

- -summaryパラメータはオプションです。これを使用すると、削除されたCRL LDAPエントリがツールによって印刷されます。

H.2.6.5 orapki crl display

次の各項では、このコマンドについて説明します。

H.2.6.5.1 目的

このコマンドは、Oracle Internet Directoryに格納されている特定のCRLを表示するために使用します。

H.2.6.5.2 構文

orapki crl display -crl crl_location
[-wallet wallet_location] [-summary|-complete]

- -crlパラメータは、ディレクトリ内のCRLの場所を指定します。orapki crl listコマンドを使用すると表示されるリストからCRLの位置を貼り付けると便利です。第H.2.6.7項「orapki crl list」を参照してください。

- -walletパラメータ(オプション)は、CRLを発行した認証局(CA)の証明書を含むウォレットの場所を指定します。これを使用すると、CRLを表示する前に、ツールによってCAの証明書に対するCRLの有効性が確認されます。

- -summaryパラメータまたは-completeパラメータのいずれかを選択すると、次の情報が表示されます。

- -summaryを選択すると、CRL発行者名およびCRLの有効期間を含むリストが表示されます。

- -completeを選択すると、そのCRLに含まれるすべての失効した証明書のリストが表示されます。このオプションを選択すると、CRLのサイズによっては、表示に時間がかかる場合があることに注意してください。

H.2.6.6 orapki crl hash

次の各項では、このコマンドについて説明します。

H.2.6.6.1 目的

このコマンドは、証明書失効リスト(CRL)発行者のハッシュ値を生成して、証明書検証用にファイル・システム内のCRLの場所を特定するために使用します。

H.2.6.6.2 構文

orapki crl hash -crl crl_filename|URL
[-wallet wallet_location] [-symlink|-copy] crl_directory [-summary]

- -crlパラメータは、CRLまたはCRLがあるURLを含むファイル名を指定します。

- -walletパラメータ(オプション)は、CRLを発行した認証局(CA)の証明書を含むウォレットの場所を指定します。これを使用すると、CRLをディレクトリにアップロードする前に、ツールによってCAの証明書に対するCRLの有効性が確認されます。

- オペレーティング・システムに応じて、-symlinkパラメータまたは-copyパラメータのいずれかを使用します。

- UNIX: -symlinkを使用してcrl_directoryにCRLへのシンボリック・リンクを作成します。

- Windows: -copyを使用してcrl_directoryにCRLのコピーを作成します。

- -summaryパラメータ(オプション)を使用すると、ツールによってCRL発行者名が表示されます。

H.2.6.7 orapki crl list

次の各項では、このコマンドについて説明します。

H.2.6.7.1 目的

このコマンドは、Oracle Internet Directoryに格納されているCRLのリストを表示するために使用します。特定のCRLを検出してローカル・システムで表示またはダウンロードする際に、このリストを参照すると便利です。

H.2.6.7.2 構文

orapki crl list -ldap hostname:ssl_port

-ldapパラメータは、CRLリストの作成対象のディレクトリ・サーバーのホスト名およびSSLポートを指定します。このポートは、認証を使用しないディレクトリのSSLポートであることが必要です。このポートの詳細は、第H.2.5.2.2項「Oracle Internet DirectoryへのCRLのアップロード」を参照してください。

H.2.6.8 orapki crl revoke

次の各項では、このコマンドについて説明します。

H.2.6.8.1 目的

このコマンドは、証明書を取り消すために使用します。

H.2.6.8.2 構文

orapki crl revoke [-crl [url|filename]]
[-wallet [cawallet]]
[-cert [revokecert]]
[-pwd pwd]

説明:

- -crlは、URLまたはファイル名としてCRLを指定します。

- -walletは、自己署名証明書と対応する秘密鍵を含むCAウォレットです。

- -cert : 取り消す証明書

- -pwdは、CAウォレットのパスワードです。

H.2.6.9 orapki crl status

次の各項では、このコマンドについて説明します。

H.2.6.9.1 目的

このコマンドは、証明書がCRLで失効しているかどうかをチェックするために使用します。

H.2.6.9.2 構文

orapki crl status [-crl [url|filename]]
[-cert [cert]]

- -crlは、URLまたはファイル名としてCRLを指定します。

- -certはCAの証明書です。

H.2.6.10 orapki crl upload

次の各項では、このコマンドについて説明します。

H.2.6.10.1 目的

このコマンドは、証明書失効リスト(CRL)をOracle Internet DirectoryのCRLサブツリーにアップロードするために使用します。CRLをディレクトリにアップロードするには、ディレクトリ管理グループCRLAdmins(cn=CRLAdmins,cn=groups,%s_OracleContextDN%)のメンバーである必要があることに注意してください。

H.2.6.10.2 構文

orapki crl upload -crl crl_location
-ldap hostname:ssl_port -user username
[-wallet wallet_location] [-summary]

- -crlパラメータは、ディレクトリの場所またはディレクトリにアップロードするCRLのURLを指定します。

- -ldapパラメータは、CRLのアップロード先のディレクトリのホスト名およびSSLポートを指定します。このポートは、認証を使用しないディレクトリのSSLポートであることが必要です。このポートの詳細は、第H.2.5.2.2項「Oracle Internet DirectoryへのCRLのアップロード」を参照してください。

- -userパラメータは、ディレクトリのCRLサブツリーにCRLを追加する権限のあるディレクトリ・ユーザーのユーザー名を指定します。

- -walletパラメータは、CRLを発行した認証局(CA)の証明書を含むウォレットの場所を指定します。これはオプションのパラメータです。これを使用すると、CRLをディレクトリにアップロードする前に、ツールによってCAの証明書に対するCRLの有効性が確認されます。

- -summaryパラメータもオプションです。これを使用すると、CRL発行者名、およびCRLがディレクトリに格納されているLDAPエントリがツールによって表示されます。

H.2.6.11 orapki crl verify

次の各項では、このコマンドについて説明します。

H.2.6.11.1 目的

このコマンドは、CRL署名を確認するために使用します。

H.2.6.11.2 構文

orapki crl verify [-crl [url|filename]]
[-cert [cacert]]

説明:

- -crlは、URLまたはファイル名としてCRLを指定します。

- -certは、チェックする証明書を指定します。

H.2.6.12 orapki wallet add

次の各項では、このコマンドについて説明します。

H.2.6.12.1 目的

このコマンドは、証明書リクエストおよび証明書をOracleウォレットに追加するために使用します。

H.2.6.12.2 構文

証明書リクエストを追加するには:

orapki wallet add -wallet wallet_location -dn user_dn -keysize 512|1024|2048

- -walletパラメータは、証明書リクエストの追加先のウォレットの場所を指定します。

- -dnパラメータは、証明書の所有者の識別名を指定します。

- -keysizeパラメータは、証明書のキー・サイズを指定します。

- リクエストに署名するには、エクスポート・オプションを使用してそのリクエストをエクスポートします。第H.2.6.16項「orapki wallet export」を参照してください。

信頼できる証明書を追加するには:

orapki wallet add -wallet wallet_location -trusted_cert -cert certificate_location

- -trusted_certパラメータを使用すると、ツールによって、-certで指定された場所にある信頼できる証明書がウォレットに追加されます。

ルート証明書を追加するには:

orapki wallet add -wallet wallet_location -dn
certificate_dn -keysize 512|1024|2048 -self_signed
-valid_from [mm/dd/yyyy] -valid_until [mm/dd/yyyy]
-validity number_of_days

- -self_signedパラメータを使用すると、ツールによってルート証明書が作成されます。

- -validityパラメータを使用して、現在の日付から数えてこのルート証明書が有効である日数を指定できます。

- -valid_fromパラメータおよびvalid_untilパラメータを使用して、このルート証明書が有効である正確な日付範囲を指定できます。-validity number_of_daysのかわりに、この方法で有効期間を指定できます。

ユーザー証明書を追加するには:

orapki wallet add -wallet wallet_location -user_cert -cert certificate_location

- -user_certパラメータを使用すると、ツールによって、-certパラメータで指定された場所にあるユーザー証明書がウォレットに追加されます。ユーザー証明書をウォレットに追加する前に、証明書チェーンを構成するすべての信頼できる証明書を追加する必要があります。ユーザー証明書を追加する前に、すべての信頼できる証明書がウォレットに追加されていない場合、ユーザー証明書の追加は失敗します。

証明書リクエストにサブジェクト・キー識別子の拡張子を追加するには:

orapki wallet add -wallet wallet_location -dn user_dn -keysize 512|1024|2048 -addext_ski

バージョン3の自己署名証明書をウォレットに追加するには:

orapki wallet add -wallet wallet_location -dn certificate_dn -keysize 512|1024|2048 -self_signed -validity number_of_days -addext_ski

H.2.6.13 orapki wallet change_pwd

次の各項では、このコマンドについて説明します。

H.2.6.13.1 目的

このコマンドは、Oracleウォレットのパスワードを変更するために使用します。

H.2.6.13.2 構文

orapki wallet change_pwd [-wallet [wallet_location]] [-oldpwd oldpassword] [-newpwd newpassword]

- -walletパラメータは、パスワードを変更するウォレットの場所を指定します。

- -oldpwdパラメータは、既存のウォレット・パスワードを指定します。

- -newpwdパラメータは、新しいウォレット・パスワードを指定します。

H.2.6.14 orapki wallet create

次の各項では、このコマンドについて説明します。

H.2.6.14.1 目的

このコマンドは、Oracleウォレットを作成またはOracleウォレットの自動ログインを設定するために使用します。

H.2.6.14.2 構文

orapki wallet create -wallet wallet_location [-auto_login]

- -walletパラメータは、新しいウォレットの場所または自動ログインを有効にするウォレットの場所を指定します。

- -auto_loginパラメータにより、自動ログイン・ウォレットが作成されます。または、-walletオプションで指定されたウォレットの自動ログインが有効になります。

H.2.6.15 orapki wallet display

次の各項では、このコマンドについて説明します。

H.2.6.15.1 目的

このコマンドは、Oracleウォレット内の証明書リクエスト、ユーザー証明書および信頼できる証明書を表示するために使用します。

H.2.6.15.2 構文

orapki wallet display -wallet wallet_location

- -walletパラメータは、開くウォレットの場所を指定します(そのウォレットが現在の作業ディレクトリにない場合)。

H.2.6.16 orapki wallet export

次の各項では、このコマンドについて説明します。

H.2.6.16.1 目的

このコマンドは、証明書リクエストおよび証明書をOracleウォレットからエクスポートするために使用します。

H.2.6.16.2 構文

orapki wallet export -wallet wallet_location -dn
certificate_dn -cert certificate_filename

- -walletパラメータは、証明書のエクスポート元のウォレットがあるディレクトリを指定します。

- -dnパラメータは、証明書の識別名を指定します。

- -certパラメータは、エクスポートされる証明書を含むファイルのパスおよびファイル名を指定します。

証明書リクエストをOracleウォレットからエクスポートするには:

orapki wallet export -wallet wallet_location -dn
certificate_request_dn -request certificate_request_filename

- -requestパラメータは、エクスポートされる証明書リクエストを含むファイルのパスおよびファイル名を指定します。

H.2.6.17 orapki wallet export_trust_chain

次の各項では、このコマンドについて説明します。

H.2.6.17.1 目的

このコマンドは、ユーザーのトラストのチェーン(証明書チェーン)をエクスポートするために使用します。

H.2.6.17.2 構文

orapki wallet export_trust_chain [-wallet [wallet]]
[-certchain [filename]]
[-dn [user_cert_dn] ]
[-pwd pwd]

- -walletパラメータは、証明書チェーンのエクスポート元のウォレットの場所を指定します。

- -certchainパラメータは、エクスポートされる証明書チェーンを含むファイルの名前を指定します。

- -dnパラメータは、エクスポートされるエントリの識別名を指定します。

- -pwdは、ウォレット・パスワードを指定します。

H.3 Oracle Wallet Managerと同等の機能

表H-1に、Oracle Wallet Managerが提供するウォレット管理機能と、11g リリース1(11.1.1)で同等の機能が得られるコマンドまたはオプションを示します。

表H-1 ウォレット用のOracle Wallet Manager機能のマッピング

Oracle Wallet Manager機能

11gR1のFusion Middleware Controlにおける実装方法

注意

標準PKCS #12ウォレットの作成

「セキュリティ」→「ウォレット」

PKCS#11ウォレットの作成

サポート対象外

Oracle Wallet Managerまたはorapkiコマンドライン・ツールを使用します。

ウォレットを開く

「セキュリティ」→「ウォレット」

ウォレットをクリックし、自動ログイン・ウォレットでなければパスワードを入力します。

ウォレットを閉じる

ウォレット・ページに移動するか、別のウォレットを開くと、既存のウォレットが自動的に閉じられます。

LDAPディレクトリへのウォレットのアップロード

サポート対象外

orapkiコマンドライン・ツールを使用します。

LDAPディレクトリからのウォレットのダウンロード

サポート対象外

orapkiコマンドライン・ツールを使用します。

開いているウォレットに対する変更を保存

「注意」を参照

「証明書の管理」ページに対する変更は、操作の完了時に自動的に保存されます。

開いているウォレットの新しい場所への保存

「セキュリティ」→「ウォレット」→「エクスポート」

システムのデフォルトへの保存

「セキュリティ」→「ウォレット」→「エクスポート」

ウォレットの削除

「セキュリティ」→「ウォレット」→「削除」

パスワードの変更

サポート対象外

WLSTまたはorapkiのコマンドライン・ツールを使用します。

自動ログインの有効化

「注意」を参照

自動ログイン・ウォレットは、パスワードで保護されたウォレットではすべて自動的に作成されます。

自動ログインの無効化

サポート対象外

自動ログイン・ウォレットは、実行時には常に必要なため、生成を無効にすることはできません。

表H-2に、Oracle Wallet Managerが提供する証明書管理機能と、11g リリース1(11.1.1)における同等のコマンドまたはオプションを示します。

表H-2 証明書用のOracle Wallet Manager機能のマッピング

Oracle Wallet Manager機能

11gR1のFusion Middleware Controlにおける実装方法

注意

証明書リクエストの追加

「セキュリティ」→「ウォレット」。任意のウォレットを選択→「証明書リクエストの追加」。

ユーザー証明書のインポート

「セキュリティ」→「ウォレット」→任意のウォレットを選択→「インポート」

ドロップダウン・ボックスで、ユーザー証明書を選択します。

信頼できる証明書のインポート

「セキュリティ」→「ウォレット」→任意のウォレットを選択→「インポート」

ドロップダウン・ボックスで、信頼できる証明書を選択します。

証明書リクエストの削除

「セキュリティ」→「ウォレット」→任意のウォレットを選択→任意の証明書リクエストを選択→「削除」

ユーザー証明書の削除

「セキュリティ」→「ウォレット」→任意のウォレットを選択→任意のユーザー証明書を選択→「削除」

信頼できる証明書の削除

「セキュリティ」→「ウォレット」→任意のウォレットを選択→任意の信頼できる証明書を選択→「削除」

ユーザー証明書のエクスポート

「セキュリティ」→「ウォレット」→任意のウォレットを選択→任意のユーザー証明書を選択→「エクスポート」

証明書リクエストのエクスポート

「セキュリティ」→「ウォレット」→任意のウォレットを選択→任意の証明書リクエストを選択→「エクスポート」

信頼できる証明書のエクスポート

「セキュリティ」→「ウォレット」→任意のウォレットを選択→任意の信頼できる証明書を選択→「エクスポート」

すべての信頼できる証明書のエクスポート

サポート対象外

WLSTまたはorapkiコマンドライン・ツールを使用します。

ウォレットへのPKCS#7証明書チェーンのインポート

サポート対象外

WLSTまたはorapkiコマンドライン・ツールを使用します。

ウォレットからのPKCS#7証明書チェーンのエクスポート

サポート対象外

WLSTまたはorapkiコマンドライン・ツールを使用します。

デフォルトのウォレットの場所

ウォレットのデフォルトの場所は、ORACLE_HOME設定によって異なります。

- ORACLE_HOMEが設定されている場合、デフォルトのウォレットの場所は、$ORACLE_HOME/owm/wallets/usernameです。

- ORACLE_HOMEが設定されていない場合、デフォルトのウォレットの場所は、CurrentDir/owm/wallets/usernameです。

H.4 orapkiと同等の機能

表H-3に、OracleウォレットおよびCRL用にorapkiユーティリティが提供する機能と、11g リリース1(11.1.1)における同等のコマンドおよびオプションを示します。

表H-3 ウォレットおよびCRL用のorapki機能のマッピング

orapki機能

11gR1における実装方法

注意

標準PKCS#12ウォレットの作成

WLST createWallet()

パスワードで保護される自動ログイン・ウォレットを管理するには、空でないパスワード値を指定します。単なる自動ログイン・ウォレットを管理するには、空のパスワード値(つまり'')を指定します。

PKCS#11ウォレットの作成

サポート対象外

orapkiコマンドライン・ツールを使用します。

LDAPディレクトリへのウォレットのアップロード

サポート対象外

orapkiコマンドライン・ツールを使用します。

LDAPディレクトリからのウォレットのダウンロード

サポート対象外

orapkiコマンドライン・ツールを使用します。

ウォレットの削除

WLST deleteWallet()

ウォレット・パスワードの変更

WLST changeWalletPassword()

当然のことですが、パスワードは、パスワードで保護されたウォレットに対してのみ変更できます。

自動ログインの有効化

自動ログイン・ウォレットは、パスワードで保護されたウォレットではすべて自動的に作成されます。

ローカル・マシン上でのみ動作する自動ログイン・ウォレットの有効化

サポート対象外

orapkiコマンドライン・ツールを使用します。

CRLの作成、取消し、ハッシュ、検証、アップロード、一覧表示、表示および削除

サポート対象外

orapkiコマンドライン・ツールを使用します。

表H-4に、証明書用にorapkiユーティリティが提供する機能と、11g リリース1(11.1.1)における同等のコマンドまたはオプションを示します。

表H-4 証明書用のorapki機能のマッピング

orapki機能

11gR1のWLSTにおける実装方法

注意

証明書リクエストの追加

addCertificateRequest()

自己署名証明書の追加

addSelfSignedCertificate()

ウォレットのすべてのエントリの一覧表示

listWalletObjects()

有効なタイプ値を指定します(「CertificateRequest」、「Certificate」または「TrustedCertificate」)。

ユーザー証明書のインポート

importWalletObject()

タイプとして「Certificate」と入力します。

信頼できる証明書のインポート

importWalletObject()

タイプとして「TrustedCertificate」と入力します。

証明書リクエストの削除

removeWalletObject()

タイプとして「CertificateRequest」と入力します。

ユーザー証明書の削除

removeWalletObject()

タイプとして「Certificate」と入力します。

信頼できる証明書の削除

removeWalletObject()

タイプとして「TrustedCertificate」と入力します。

すべての信頼できる証明書の削除

removeWalletObject()

タイプとして「TrustedAll」と入力します。

ユーザー証明書のエクスポート

exportKeyStoreObject()

タイプとして「Certificate」と入力します。

証明書リクエストのエクスポート

exportWalletObject()

タイプとして「CertificateRequest」と入力します。

信頼できる証明書のエクスポート

exportWalletObject()

タイプとして「TrustedCertificate」と入力します。

証明書チェーンのエクスポート

exportWalletObject()

タイプとして「CertificateChain」と入力します。

ウォレットへのPKCS#7証明書チェーンのインポート

importWalletObject()

タイプとして「TrustedChain」と入力します。

H.5 SSL構成ツールと同等の機能

表H-5に、11g リリース1(11.1.1)以前のSSL構成ツールが提供する機能と、11g リリース1(11.1.1)における同等のコマンドまたはオプションを示します。

表H-5 SSL構成ツールと同等の機能

SSL構成ツール

11g リリース1(11.1.1)におけるSSL構成

ウォレット管理ではサポートされていません。

SSL構成の他に、OracleウォレットおよびJavaキーストアの管理をサポートします。

SSLでサポートされるスタンドアロン・タイプは、Oracle Web Cacheのみです。

スタンドアロンSSL構成に対しては、Oracle HTTP Server、Oracle Web Cache、Oracle Internet DirectoryおよびOracle Virtual Directoryがサポートされます。

コマンドライン・インタフェースのみ提供されます。

コマンドライン・インタフェース(WLST)とグラフィカル・インタフェース(Fusion Middleware Control)の両方が提供されます。

このツールの実行には構成ファイルが必要です。ファイルが提供されないと、ツールは、値の入力を求めるプロンプトを表示します。

構成ファイルは、WLSTコマンドではオプションです。ファイルが提供されない場合、SSL属性についてはデフォルト値が使用されます。

Web層のみに対してSSL構成がサポートされます。

Web層とデータ層の両方に対してSSL構成がサポートされます。

ツールは、コンポーネントがインストールされた同じ物理ホスト上で実行する必要があります。

コンポーネントのリモート管理が可能です。

I Oracle Fusion Middlewareのトラブルシューティング

この付録では、Oracle Fusion Middlewareを使用しているときに発生する可能性のある障害のトラブルシューティング方法について説明します。次の項目が含まれます。

- Oracle Fusion Middlewareの障害の診断

- 一般的な障害と解決策

- Fusion Middleware Controlのトラブルシューティング

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

- 他のヘルプが必要な場合

I.1 Oracle Fusion Middlewareの障害の診断

Oracle Fusion Middlewareコンポーネントは、起動および停止情報、エラー、警告メッセージ、HTTPリクエスト時のアクセス情報など、すべての種類のイベントを記録するメッセージが格納されたログ・ファイルを生成します。このログ・ファイルを、障害の特定と診断に使用できます。ログ・ファイルの使用と読取りの詳細は、第12章「ログ・ファイルと診断データの管理」を参照してください。

Oracle Fusion Middlewareには、問題の検出、診断および解決を支援する診断フレームワークが含まれています。特に対象としている障害は、コードのバグ、メタデータの破損、顧客データの破損に起因する障害、スレッドのデッドロック、一貫性のない状態などのクリティカル・エラーです。

クリティカル・エラーが発生すると、そのエラーにはインシデント番号が割り当てられ、エラーの診断ログ(ログ・ファイルなど)が即座に取得され、その番号でタグ付けされます。データは、自動診断リポジトリ(ADR)に格納されます。ADRでは、後でデータをインシデント番号によって取得し、分析することができます。診断フレームワークの詳細は、第13章「問題の診断」を参照してください。

I.2 一般的な障害と解決策

この項では、一般的な障害と解決策について説明します。次の項目が含まれます。

- データソース接続の不足

- 異なるバージョンのSpringの使用

- 管理対象サーバー起動時のClassNotFoundエラー

I.2.1 データソース接続の不足

データベースのパフォーマンスが低下している場合や、Oracle WebLogic Serverのログ・ファイルに次のメッセージが出力された場合は、データソース接続がリークしている可能性があります。

No resources currently available in pool datasource name

Any product functionality that depend on the datasource will not function as it can't connect database to get required data.

このメッセージが出力された場合は、管理コンソールのデータソース監視ページから接続使用量を監視します。

1. 「ドメイン構造」で、「サービス」→「データ・ソース」を選択します。

2. 監視するデータソースをクリックします。

3. 「監視」タブ→「統計」タブを選択します。

4. 表に「現在アクティブな接続の数」が表示されない場合は、「この表のカスタマイズ」をクリックします。

5. 「列の表示」で、「現在アクティブな接続の数」を選択して、それを「使用可能」ボックスから「選択済み」ボックスに移動します。「適用」をクリックします。

6. 表内の「現在アクティブな接続の数」列の数に注目します。

現在アクティブなデータソースの数が増え続け、減少しないようであれば、このデータソースで接続がリークしています。Oracleサポートに連絡してください。

I.2.2 異なるバージョンのSpringの使用

JRFを使用して管理対象サーバーを構成すると、Spring 2.0.6がインストールされ、Oracle WebLogic Serverのシステム・クラスパスに配置されます。JRF環境で実行されているカスタム・アプリケーションが、異なるバージョンのSpringを必要とする場合、FilteringClassLoaderメカニズムを使用して、Springのバージョンを指定する必要があります。

Oracle WebLogic Serverは、デプロイメント記述を構成して特定のパッケージが常に(システム・クラス・ローダーによってではなく)アプリケーションからロードされることを明示的に指定できるように、FilteringClassLoaderメカニズムを提供します。この機能により、SpringやAntなど、アプリケーションの代替のバージョンを使用できます。

FilteringClassLoaderメカニズムの使用方法の詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverアプリケーションの開発』のFilteringClassLoaderの使用方法に関する項を参照してください。

I.2.3 管理対象サーバー起動時のClassNotFoundエラー

管理対象サーバーがノード・マネージャによって起動される場合(サーバーがOracle WebLogic Server管理コンソールまたはFusion Middleware Controlによって起動される場合)、管理対象サーバーを起動するときに起動スクリプトを使用するようにノード・マネージャが構成されていないと、ClassNotFoundエラーが発生する場合があります。この障害の解決方法の詳細は、第4.2.1項を参照してください。

I.3 Fusion Middleware Controlのトラブルシューティング

次の各項では、Fusion Middleware Controlを使用したときに発生する問題について説明します。

- Fusion Middleware Controlのパフォーマンス・メトリックおよびグラフの表示のトラブルシューティング

- Fusion Middleware ControlからOracle WebLogic Server管理コンソールへの接続の保護

- Windowsのネイティブ認証用のFusion Middleware Controlの構成

I.3.1 Fusion Middleware Controlのパフォーマンス・メトリックおよびグラフの表示のトラブルシューティング

Fusion Middleware Controlを使用してシステム・コンポーネントを管理している場合、特定の管理対象ターゲットに関してパフォーマンス・メトリックおよびグラフが正しく表示されないという状況が発生する場合があります。

次の各項では、管理対象ターゲットに関する情報を示し、レスポンス時間やロード・メトリックなどのパフォーマンス・メトリックを表示しようとしたときにFusion Middleware Controlがエラーを表示する場合に実行する一般的なトラブルシューティング・タスクについて説明します。

- エージェントの監視中のターゲットとは

- ファームにおけるすべてのエージェントの監視中のターゲットの監視資格証明の設定

- 特定のエージェントの監視中のターゲットの監視資格証明の変更

- Oracle Management AgentのURLの確認または変更

I.3.1.1 エージェントの監視中のターゲットとは

Fusion Middleware Controlで次のコンポーネントを検出し、表示するには、Oracle Management Agentが使用可能で実行中である必要があります。

- Oracle Internet Directory

- Oracle Virtual Directory

- Oracle Directory Integration Platform

- Oracle Identity Federation

- Oracle Reportsアプリケーション、Oracle Reports Server

これらのコンポーネントは、エージェントの監視中のターゲットと呼ばれます。

これらのコンポーネントを含むOracle Fusion Middleware環境をインストールして構成すると、管理エージェント(Oracle Management Agent)もOracleインスタンスにインストールされ実行されます。

対照的に、Javaコンポーネントおよび一部のシステム・コンポーネントは、管理エージェントなしでFusion Middleware Controlによって管理できます。

Oracle Management Agentの詳細は、Oracle Technology Network(OTN)でOracle Enterprise Managerのドキュメントを参照してください。

http://www.oracle.com/technetwork/oem/grid-control/documentation/index.html

I.3.1.2 ファームにおけるすべてのエージェントの監視中のターゲットの監視資格証明の設定

すべてのエージェントの監視中のターゲットの監視資格証明の管理を容易にするために、「監視資格証明」ページを使用して、ファームにおけるすべてのエージェントの監視中のターゲットの監視資格証明を設定できます。

1. 「ファーム」メニューから、「監視資格証明」を選択します。

2. 最低でもmonitoringレベルの権限があるOracle WebLogic Serverのユーザー・アカウントのユーザー名とパスワードを入力します。

このページで監視資格証明を設定すると、ファームにおけるエージェントの監視中のターゲットの監視資格証明がすべてオーバーライドされます。ただし、すべてのターゲットの監視資格証明を設定した後は、第I.3.1.3項の説明のとおり、「エージェントの監視中のターゲット」ページを使用して、特定のターゲットの証明書をオーバーライドできます。

I.3.1.3 特定のエージェントの監視中のターゲットの監視資格証明の変更

ターゲット(Oracle Fusion Middlewareコンポーネント)を管理するために、Oracle Management Agentは、Oracle WebLogic Server管理アカウントを使用してターゲットに接続します。Oracle Management Agentは、ターゲットに接続した後、パフォーマンス・メトリックを収集し、それをFusion Middleware Controlに戻し、そこで監視ページおよびパフォーマンス・グラフにパフォーマンス・メトリックを表示できます。

この管理アカウントおよびそのパスワードは、エージェントの監視中のターゲットの監視資格証明と呼ばれます。

特定のターゲットの監視資格証明がOracle WebLogic Serverで変更されると、Oracle Management Agentは、パフォーマンス・メトリックを取得できなくなります。その結果、ターゲットのメトリックはFusion Middleware Controlページに表示されず、パフォーマンス・グラフはレンダリングされません。

この障害を修正するために、Fusion Middleware Controlでエージェントの監視中のターゲットの監視資格証明を変更できます。

1. 「ファーム」メニューから、「監視資格証明」を選択します。
「監視資格証明」ページが表示されます。

2. 「エージェントの監視中のターゲット」をクリックします。
「エージェントの監視中のターゲット」ページが表示されます。

3. 変更するターゲットの「構成」アイコンをクリックします。

4. 「構成」ページで、「監視資格証明」フィールドを検索し、最低でもmonitoringレベルの権限があるOracle WebLogic Serverのユーザー・アカウントの証明書と一致するように証明書を変更します。

I.3.1.4 Oracle Management AgentのURLの確認または変更

ファームにおけるすべてのエージェントの監視中のターゲットのパフォーマンス・メトリックを使用できないが、エージェントの監視中のターゲットの監視資格証明が正しいことを検証済の場合、Fusion Middleware Controlと通信するためにOracle Management Agentが使用するURLを変更する必要がある場合があります。

この状況は、使用環境のバックアップを作成し、これを別のホストにリストアした場合、またはテスト環境を本番環境に移行した場合に発生する可能性があります。どちらの場合も、Oracle Management Agentを再びFusion Middleware Controlと通信できるようにするには、その前にOracle Management AgentのURLで必要なホスト名を変更する必要があります。

Oracle Management AgentのURLを変更するには:

1. 「ファーム」メニューから、「監視資格証明」を選択します。
「監視資格証明」ページが表示されます。

2. 「エージェントの監視中のターゲット」をクリックします。
「エージェントの監視中のターゲット」ページが表示されます。

3. このページに一覧表示されているエージェントの監視中のターゲットのいずれかの「構成」アイコンをクリックします。

4. Oracle Management AgentのURLを変更します。

I.3.2 Fusion Middleware ControlからOracle WebLogic Server管理コンソールへの接続の保護

デフォルトでは、Fusion Middleware ControlからOracle WebLogic Server管理コンソールにアクセスする場合、その接続は非SSL接続です。SSL接続を使用してOracle WebLogic Server管理コンソールにアクセスするには、SSLポートを使用して手動でアクセスする必要があります。または、セキュアな管理ポートを有効にできます。

管理チャネルに関する情報、およびチャネルの確立方法については、『Oracle Fusion Middleware Oracle WebLogic Serverサーバー環境の構成』のネットワーク・チャネルについての項を参照してください。

管理サーバー・ドメインとの通信のセキュア・モードを有効にし、その他すべての非セキュア・モードを無効にするには、次の明示的な手順を実行して、Oracle Management AgentによるFusion Middleware Controlのエージェントの監視中のターゲットの監視を有効にする必要がある場合があります(エージェントの監視中のターゲットの詳細は、第I.3.1.1項を参照してください)。次の手順は、管理サーバーのインスタンスでデフォルトの自己署名証明書、またはOracle Management Agentが使用しているJVMのデフォルトのトラストストアで使用できない認証局(CA)を持つその他の署名付き証明書を使用している場合にのみ必要です。

この場合、次の手順に従います。

1. 次のコマンドを使用して、Oracle Management Agentを停止します。

ORACLE_HOME/bin/emctl stop agent

2. 証明書をOracle WebLogic Serverからエクスポートします。

JAVA_HOME/jdk/bin/keytool -export -alias demoidentity -file /tmp/wlcert -keystore MW_HOME/wlserver_10.3/server/lib/DemoIdentity.jks

プロンプトが表示されたら、パスワードを入力します。

3. 証明書を使用してJDKのデフォルトのトラストストア(JAVA_HOME/jre/lib/security/cacerts)を更新します(これはOracle Management Agentが使用するJDKです)。

keytool -import -alias demoidentity -trustcacerts -file /temp/wlcert -keystore  JAVA_HOME/jre/lib/security/cacerts -storepass password

この証明書を信頼するかどうか質問されたら、「yes」と入力します。

4. 次のコマンドを使用して、Oracle Management Agentを起動します。

ORACLE_HOME/bin/emctl start agent

I.3.3 Windowsのネイティブ認証用のFusion Middleware Controlの構成

Fusion Middleware ControlとOracle WebLogic Server管理コンソール間のシングル・サインオン・メカニズムとしてWindowsのネイティブ認証(WNA)を使用する場合、次のファイルを変更する必要があります。

- web.xml

- weblogic.xml

これらのファイルは、em.earファイルに含まれます。em.earファイルを展開して各ファイルを編集してから、em.earファイルに再アーカイブします。次の手順を実行してください(フロントエンドがWindows上にあり、em.earファイルがUNIX上にあると仮定します)。

1. JAVA_HOME環境変数を設定します。次に例を示します。

setenv JAVA_HOME /scratch/Oracle/Middleware/jrockit_160_05_R27.6.2-20

2. em.earが含まれるディレクトリに移動し、ファイルを展開します。次に例を示します。

cd /scratch/Oracle/Middleware/user_projects/applications/domain_name
JAVA_HOME/bin/jar xvf em.ear em.war
JAVA_HOME/bin/jar xvf em.war WEB-INF/web.xml
JAVA_HOME/bin/jar xvf em.war WEB-INF/weblogic.xml

3. web.xmlを編集し、最初のlogin-configブロックをコメントアウトし、WNAのlogin-configを非コメントアウトします。(どのブロックをコメント化または非コメント化するかはファイルに含まれています。)次に、ファイルの一部が次のように表示されます。

<!--<login-config>
<auth-method>CLIENT-CERT</auth-method>
</login-config>
-->
<!--
the following block is for Windows Native Authentication, if you are using
WNA, do the following:
1. uncomment the following block
2. comment out the previous <login-config> section.
3. you also need to uncomment a block in weblogic.xml
-->
<login-config>
<auth-method>CLIENT-CERT,FORM</auth-method>
<form-login-config>
<form-login-page>/faces/targetauth/emasLogin</form-login-page>
<form-error-page>/login/LoginError.jsp</form-error-page>
</form-login-config>
</login-config>
<security-constraint>
.
.
.
<security-role>
<role-name>Monitor</role-name>
</security-role>

4. weblogic.xmlを編集し、次のブロックを非コメント化します。(どのブロックを非コメントかするかはファイルに含まれています。)次に、ファイルの一部が次のように表示されます。

<!--
the following block is for Windows Native Authentication, if you are using
WNA, uncomment the following block.
-->
<security-role-assignment>
<role-name>Admin</role-name>
<externally-defined/>
</security-role-assignment>
.
.
.
<security-role-assignment>
<role-name>Deployer</role-name>
<externally-defined/>
</security-role-assignment>

5. em.earファイルに再アーカイブします。次に例を示します。

JAVA_HOME/bin/jar uvf em.war WEB-INF/web.xml
JAVA_HOME/bin/jar uvf em.war WEB-INF/weblogic.xml
JAVA_HOME/bin/jar uvf em.ear em.war

I.4 SSLのトラブルシューティング

この項では、SSL構成を使用する場合の一般的な問題および解決策について説明します。次の項目が含まれます。

- コンポーネントですべてのサポートされている暗号が有効になる場合がある

- Oracleウォレットのかわりのユーザー証明書

I.4.1 コンポーネントですべてのサポートされている暗号が有効になる場合がある

暗号が明示的に構成されていない場合、11g リリース1(11.1.1)の一部のコンポーネントでDH_Anon(Diffie-Hellman匿名)暗号を含む、サポートされているすべてのSSL暗号が有効になることに注意してください。

この時点では、次のように暗号を設定することがわかっているコンポーネントはOracle HTTP Serverのみです。

DH_Anonが希望でない場合、希望する暗号でコンポーネントを構成します。

I.4.2 Oracleウォレットのかわりのユーザー証明書

Oracle HTTP Server、Oracle Web CacheおよびOracle Internet Directoryで使用されるOracleウォレットおよびOracle Virtual Directoryで使用されるキーストアには、2010年1月7日15:59:59(PST)に期限満了するVerisignルート・キー(シリアル#: 02:ad:66:7e:4e:45:fe:5e:57:6f:3c:98:19:5e:dd:c0)が含まれています。

このルート・キーで署名されたユーザー証明書を使用している場合、認証局(CA)によって署名されたかわりのユーザー証明書を取得し、CAのルート・キーをOracleウォレットにインポートする必要があります。

Oracleウォレットへのキーのインポート手順は、第8.4.7項を参照してください。

I.5 他のヘルプが必要な場合

この他の解決策は、My Oracle Support(http://support.oracle.com)で公開されています。発生した障害の解決策が見つからない場合は、サービス・リクエストを発行してください。

第I.5.1項で説明するように、Remote Diagnostic Agentを使用することもできます。

関連項目:

『Oracle Fusion Middlewareリリース・ノート』(Oracle Technology Networkで参照できます)

http://docs.oracle.com/index.html#middleware

I.5.1 Remote Diagnostic Agentの使用

Remote Diagnostic Agent(RDA)は、ご使用の環境の全体像を提供するコマンドライン診断ツールです。また、RDAでは、構成やセキュリティなど、様々な項目に関する推奨事項が提供されています。これは、ユーザーとOracleサポートの問題解決を支援します。

RDAは、できるだけ控えめであるように設計されており、システムを変更することはありません。必要に応じて、セキュリティ・フィルタが提供されます。

RDAの詳細は、次の場所にあるreadmeファイルを参照してください。

(UNIX) ORACLE_HOME/rda/README_Unix.txt
(Windows) ORACLE_HOME\rda\README_Windows.txt

索引

A  B  C  D  E  F  G  H  I  J  K  L  M  N  O  P  Q  R  S  T  U  V  W

A

ACTIVITIESスキーマ, D.1

addCertificateRequest, 6.9.1

addSelfSignedCertificate, 6.9.2

管理サーバー, 2.2.1, 4.2.2

リカバリ, 18.2.5, 18.3.2.1, 18.3.2.2

ホストのリカバリ, 18.3

起動と停止, 4.2

資格証明を入力しない, 4.2.4

管理ユーザー, 3.3.1, 3.8 管理上の変更, F.1 ADRコマンド・インタプリタ(ADRCI), 13.1.2.5, 13.4.6.2 adrciユーティリティ, 13.4.6.2 エージェントの監視中のターゲット, I.3.1.1

資格証明の設定, I.3.1.2

割り当てられているポート範囲, C.1 アプリケーション

ベース・ドキュメント, 14.3.1

カスタマイズ, 14.3.1

デプロイ, 10.1, 10.3

リカバリ, 18.2.9, 18.2.9

再デプロイ, 10.3.3

起動と停止, 4.6

新しいリポジトリへの転送, 14.3.7.2

アンデプロイ, 10.3.2

applyJRFコマンド, 19.3.1 監査ポリシー

テストから本番への移行, 21.4.1.1

認証

SSL, 6.1.1

自動ログイン・ウォレット, 8.4.1.1 自動診断リポジトリ(ADR), 13.1.2.1

B

ファイルのバックアップ, 17.2

バックアップとリカバリ

バックアップ計画, 16.3

環境の記録の作成, 17.4

概要, 16.1

制限事項, 16.6

バックアップとリカバリの推奨事項, 16.5 バックアップ

監査フレームワーク, 17.2

データベース, 17.3.2

ドメイン, 17.3.1, 17.3.2

全体, 16.3.1, 17.3.1

Javaコンポーネント, 17.3.1, 17.3.2

LDAPデータ, 17.2

制限事項, 17.2

管理対象サーバー, 17.3.1

Middlewareホーム, 17.3.1

Oracleインスタンス・ホーム, 17.3.1, 17.3.2

OraInventory, 17.3.1

推奨事項, 17.1

ランタイム・アーティファクト, 16.3.2

システム・コンポーネント, 17.3.1, 17.3.2

タイプ, 16.3.1, 17.3

WebLogic Server構成ファイル, 16.3

BIPLATFORMスキーマ

データファイル, D.2

説明, D.1

表領域, D.2

bulkdeleteコマンド, A bulkloadコマンド, A bulkmodifyコマンド, A ビジネス・インテリジェンス

スキーマ, D.1

C

catalogコマンド, A

証明書

サード・パーティへの変換, 8.4.7.9

削除, 8.4.7.7

エクスポート, 8.4.7.3

インポート, 8.4.7.5

ライフサイクル, 8.3.4, 8.4.5

Fusion Middleware Controlを使用した管理, 8.4.6

操作, 8.3.5

置換, 8.3.6.2

リクエスト, 8.4.7.1

認証局, 6.1.2 証明書の操作, 8.4.7 証明書の失効, 6.7.2.2 証明書失効リスト, H.2.5.1.1

削除, H.2.5.2.5

一覧表示, H.2.5.2.3

orapkiを使用した管理, H.2.5

名前変更, H.2.5.2.1

アップロード, H.2.5.2.2

LDAPディレクトリへのアップロード, H.2.5.2

検証, H.2.5.1

表示, H.2.5.2.4

証明書署名リクエスト, 8.3.5.3 changeKeyStorePasswordコマンド, 6.9.3 changeWalletPasswordコマンド, 6.9.4 IPアドレスの変更, 15.4 キャラクタ・セット

メタデータ・リポジトリでの変更, 14.4.2

chgiphostコマンド, 15.1.3, A ClassNotFoundエラー

管理対象サーバーの起動時, I.2.3

CLASSPATH環境変数, 3.1, 3.1 cloneMetadataPartitionシステムMBean, 14.3.7.1 クローニング

テスト環境から本番環境への移行に関する説明を参照

MDSリポジトリ・パーティションのクローニング, 14.3.7.1 クラスタ, 2.2.2

作成, 19.5

監視, 11.1.4

リカバリ, 18.2.8, 18.2.8.1, 18.2.8.2

コマンドライン・ツール, 3.5, A コンポーネント

リカバリ, 18.2.7, 18.2.7.1, 18.2.7.2

ホストのリカバリ, 18.3.4

起動, 4.3.2

起動と停止, 4.3、4.3.1

停止, 4.3.2

ステータスの表示, 11.1.5

configコマンド

構成ウィザードの起動, A

configureLogHandlerコマンド, 12.4.1.2, 12.4.2.2, 12.4.4.2, 12.4.5.1, 12.6.1.2.1 configureSSLコマンド, 6.9.5 configureTracingLoggersコマンド, 12.6.2.2.1 コンテンツ・ペイン

Fusion Middleware Control, 3.3.3

コンテキスト・ペイン

Fusion Middleware Control, 3.3.3

コンテキスト・ルート, 10.3.1.1 copyBinaryスクリプト, 20.2.1.1, 21.3.4, 21.9 copyConfigスクリプト, 21.3.5, 21.3.5, 21.3.6.1, 21.3.6.2, 21.4.7.1, 21.9, 21.9

Javaコンポーネント, 20.2.1.3

ノード・マネージャ, 20.2.1.6

システム・コンポーネント, 20.2.1.4, 20.2.1.5

createIncidentコマンド, 13.4.6.1 createKeyStoreコマンド, 6.9.6 createMetadataLabelコマンド, 14.3.12.1 createMetadataPartitionコマンド, 14.3.7.2, 14.3.9 createWalletコマンド, 6.9.7 CRL

検証の構成, 6.7.2.3

作成, 6.7.2.2

ハッシュ形式への名前変更, 6.7.2.2

CRLの統合, 6.7.2 CRLAdminsディレクトリ管理グループ, H.2.6.10.1 暗号化

秘密鍵, 6.1.2

公開鍵, 6.1.2

D

dads.confファイル, 5.3.6

データソース

構成,10.2.1

作成, 10.2.2

管理, 10.2.2.1, 10.2.2.2

監視, 10.2.2.3

データベース・ベース・リポジトリ

作成, 14.2

起動, 4.7.1、4.7.2

データベース

バックアップ, 17.3.2

リカバリ, 18.2.10, 18.3.6, 18.3.6

デフォルトのポート番号, C.1 deleteKeyStoreコマンド, 6.9.8 deleteMetadataLabelコマンド, 14.3.12.5 deleteMetadataPartitonコマンド, 14.3.10.2 deleteWalletコマンド, 6.9.9 deployコマンド, 10.3.1.2, 10.4.1.2 アプリケーションのデプロイ, 10.3

アプリケーション・セキュリティ, 10.8

EJBの構成, 10.8

永続性の構成, 10.8

Webモジュールの構成, 10.8

概要, 10.1

デプロイメント計画

フェッチ, 10.7

デプロイメント計画

自動的に作成, 10.3.1.1, 10.3.3.1, 10.4.1.1, 10.4.3, 10.6.1, 10.6.3

管理, 10.7

デプロイメント・プロファイル, 9.2.2 deregisterMetadataDBRepositoryコマンド, 14.3.2.3.2 DERでエンコードされた証明書, 8.1.2.1 describeDumpコマンド, 13.4.4.2 DHCPアドレス

変更, 15.4

移動, 15.3.2

診断ダンプ, 13.1.2.2 診断フレームワーク, 13.1, 13.1.1.1, I.1

構成, 13.3

診断ルール, 13.1

最初の障害の取得, 13.1

インシデント検出ログ・フィルタ, 13.1

インシデントのフラッド制御, 13.1.1.1

インシデント, 13.1.1

WLSTの呼び出し, 3.5.1.1

MBean, 13.3.1

問題キー, 13.1.1

問題, 13.1.1

診断イメージ, 13.1 診断メッセージ

レベル, 12.4.3

タイプ, 12.4.3

診断

早期検出, I.1

最初の障害の取得, 13.1, I.1

インシデント検出ログ・フィルタ, 13.1

メッセージ, 12.5

トラブルシューティング, I

切断モード

ステータスの監視, 11.1

Discoverer

「Oracle Business Intelligence Discoverer」を参照

DISCOVERERスキーマ

データファイル, D.2

説明, D.1

表領域, D.2

DISPLAY環境変数, 3.1 displayLogsコマンド, 12.3.1.2, 12.3.2.2 ドメイン・ホーム, 2.2 ドメイン名

変更, 15.1

ドメイン・テンプレート

ドメインの拡張, 19.2

ドメイン

管理対象サーバーの追加, 19.3

拡張, 19.2

リカバリ, 18.2.2

WebLogic Server, 2.2

ダンプ

診断, 13.1.2.2

実行, 13.4.4.3

リストの表示, 13.4.4.1

Dynamic Monitoring Service(DMS)

WLSTの呼び出し, 3.5.1.1

動的ターゲット・メニュー

Fusion Middleware Control, 3.3.3

E

ECID

「実行コンテキストID (ECID)」を参照

エディションベースの再定義(EBR)スキーマ, 14.1, 14.1 暗号化, 6.1.1 環境変数

設定, 3.1

ERRORメッセージ・タイプ, 12.4.3 エラー・メッセージ

「診断」を参照

eulbuilder.jarコマンドライン・ツール, A executeDumpコマンド, 13.4.4.3 実行コンテキストID (ECID), 12.5

ログ・ファイルの検索, 12.3.2.2

ツリーを開く

Fusion Middleware Control, 3.3.3

exportKeyStoreコマンド, 6.9.10 exportKeyStoreObjectコマンド, 6.9.11 exportMetadataコマンド, 14.3.7.2, 14.3.8.2, 14.3.9 exportWalletコマンド, 6.9.12 exportWalletObjectコマンド, 6.9.13 extractMovePlanスクリプト, 20.2.1.7

F

ファーム・メニュー

Fusion Middleware Control, 3.3.3

ファーム, 3.3 最初に障害が発生したコンポーネントの切分け, 12.5 フラッド制御

インシデントに対して有効化, 13.3.1

フラッド制御されたインシデント

診断フレームワーク, 13.1.1.1

frmcmpコマンド

Oracle Forms Services, A

Fusion Middleware Control

コンテンツ・ペイン, 3.3.3

コンテキスト・ペイン, 3.3.3

動的ターゲット・メニュー, 3.3.3

ツリーを開く, 3.3.3

ファーム・メニュー, 3.3.3

リカバリ, 18.3.5.1

ページのリフレッシュ, 3.3.3

右クリック・ターゲット・メニュー, 3.3.3

保護, I.3.2

起動と停止, 4.4

ターゲット情報アイコン, 3.3.3

ターゲット名, 3.3.3

ターゲット・ナビゲーション・ペイン, 3.3.3

トポロジ・ビューア, 3.3.3

トラブルシューティング, I.3

URL, 3.3.1, B

使用, 3.3

G

generateKeyコマンド, 6.9.14

getIncidentFileコマンド, 13.4.1, 13.4.2.2

getKeyStoreObjectコマンド, 6.9.15

getLogLevelコマンド, 12.4.3.2

getMDSArchiveConfigコマンド, 10.4.1.2

getSSLコマンド, 6.9.16

getWalletObjectコマンド, 6.9.17

GridLinkデータソース, 10.2.1

H

ヘッダー変数

ProxySSLStateHeader, 15.5.6.3

WebGateがリバース・プロキシの背後にある場合に使用, 15.5.6.3

高可用性環境

起動と停止, 4.8.1

ホーム・ページ, 3.3 ホスト名

変更, 15.1

HTTPポート

変更, 5.3.2.2

HTTPSポート

変更, 5.3.2.3

ヒューマン・ワークフロー

テストから本番への移行, 21.4.2.1

I

iasuaコマンド, A

IMMEDIATEオプション(Oracle Databaseの停止用), 4.8.2

importKeyStoreコマンド, 6.9.18

importKeyStoreObjectコマンド, 6.9.19

importMetadataコマンド, 14.3.7.2, 14.3.8.2

importWalletコマンド, 6.9.20

importWalletObjectコマンド, 6.9.21

インシデントのフラッド制御, 13.1.1.1

INCIDENT_ERRORメッセージ・タイプ, 12.4.3

インシデント

診断フレームワーク, 13.1.1

作成の有効化, 13.3.1

表示, 13.4.2.2

管理, 13.4.6

パッケージ化, 13.4.6.2, 13.4.6.2

パージ, 13.4.6.3

詳細の表示, 13.4.2.2

IPアドレス

変更, 15.1, 15.4

メタデータ・リポジトリ, 15.2

ネットワーク接続のオフへの変更, 15.3.3 静的アドレスへの切替え, 15.3.1 IPCリスナー

KEY値, 5.3.6.1

IPMスキーマ, D.1 IPv4プロトコル

サポート, 15.5

IPv6プロトコル

Oracle Access Manager, 15.5.7

Oracle HTTP Server, 15.5.2

Oracle Single Sign-On, 15.5.5

Oracle Web Cache

IPv6の無効化, 15.5.4

サポート, 15.5 サポートされているトポロジ, 15.5.1

J

Javaコンポーネント, 2.1

リカバリ, 18.3.4.1

Java EEアプリケーション, 10.1.1 Java EEアプリケーション

デプロイ, 10.3

再デプロイ, 10.3.3

起動と停止, 4.6

アンデプロイ, 10.3.2

Javaキーストア, 8.3.1 Java Naming and Directory Interface (JNDI), 10.2.1 Java Required Files(JRF)

管理対象サーバーの構成, 19.3.1

JAVA_HOME環境変数, 3.1, 3.1 JKS, 8.3.1 JKSキーストア, 8.1.1.1

コンポーネント, 6.2.2

ライフサイクル, 8.3.2

K

キーストア

パスワードの変更, 8.3.3.9

自己署名証明書の変換, 8.3.5.11

作成, 8.3.3.1

削除, 8.3.3.5

証明書の削除, 8.3.5.9

エクスポート, 8.3.3.3

証明書のエクスポート, 8.3.5.7

新しい鍵の作成, 8.3.5.1

インポート, 8.3.3.7

証明書のインポート, 8.3.5.5

JKSとOracleウォレット, 6.1.3

場所, 8.3.6.1

タイプ, 6.2.2, 8.1.1

Fusion Middleware Controlの使用, 8.3.2

キーストアおよび証明書の保守, 8.3.6 キーストア管理ツール, 8.1.2

L

ラベル

作成, 14.3.12.1

削除, 14.3.12.5

表示, 14.3.12.2

メタデータ

管理, 14.3.12

昇格, 14.3.12.3 ロールバック, 14.3.12.3 LD_LIBRARY_PATH環境変数, 3.1 LD_LIBRARY_PATH_64環境変数, 3.1 ldapaddコマンド, A, A ldapaddmtコマンド, A ldapcompareコマンド, A ldapdeleteコマンド, A ldapmoddnコマンド, A ldapmodifyコマンド, A ldapmodifymtコマンド, A ldap.oraファイル

認証なしのディレクトリSSLポート, H.2.5.2.2

ldapsearchコマンド, A

コンテキスト・バージョンの表示, G.2.4

スキーマ・バージョンの表示, G.2.4

ldifmigratorコマンド, A, A LIBPATH環境変数, 3.1 listActiveTracesコマンド, 12.6.2.2.2 listDumpsコマンド, 13.4.4.1 リスニング・ポート

変更, 5.3.2.2

listIncidentsコマンド, 13.4.2.2 listKeyStoreObjectsコマンド, 6.9.22 listKeyStoresコマンド, 6.9.23 listLoggersコマンド, 12.4.3.2 listLogsコマンド, 12.3.1.2 listMetadataLabelコマンド, 14.3.12.2 listProblemsコマンド, 13.4.1, 13.4.2.1 listWalletObjectsコマンド, 6.9.24 listWalletsコマンド, 6.9.25 構成のロック

WebLogic Server, 3.4.2

ログ検出

有効化, 13.3.1

ログ・ファイル

メッセージ数の表示, 12.3.2.2

ダウンロード, 12.3.3

形式

設定, 12.4.4

レベル, 12.4.3

取得, 12.4.3.2

設定, 12.4.3.2

表示, 12.3.1 ロケール

設定, 12.4.5

場所, 12.4.1 ネーミング, 12.4.1 概要, 12.1 保存期間, 12.4.2.1 ローテーション, 12.4.2

サイズベース, 12.4.2.1

検索, 12.3.2, 12.3.2.1, 12.3.2.2

コンポーネント・タイプ別, 12.3.2.2

ECID別, 12.3.2.2

時間別, 12.3.2.2, 12.3.2.2

メッセージのタイプ別, 12.3.2.2

サイズを指定, 12.4.2.1 時間ベースのローテーション, 12.4.2.1 表示, 12.3.1 ロギング・コマンド

WLSTの呼び出し, 3.5.1.1

ホストの破損

リカバリ, 18.3

制限事項, 18.3.5

M

管理対象Bean

「MBean」を参照

管理対象サーバー, 2.2.2, 4.2.3.2

ドメインに追加, 19.3

バックアップ, 17.3.1

リカバリ, 18.2.6, 18.2.6.1, 18.2.6.2

ホストのリカバリ, 18.3.3, 18.3.3.1, 18.3.3.2

起動と停止, 4.2, 4.2.3.2

起動の問題のトラブルシューティング, I.2.3

MBean

診断フレームワーク, 13.1.2.3

検索, 3.6.1

表示, 3.6.1

アプリケーションに対する表示, 3.6.2

MDSリポジトリ, 14.1, 14.3.1

データベース・ベース・リポジトリの利点, 14.3.1

構成属性の変更, 10.9.1

アプリケーションの構成

異なるリポジトリを使用, 14.3.7

データベース・ベースの作成, 14.2 ラベルの作成, 14.3.12.1 ラベルの削除, 14.3.12.5 ファイルベースの登録解除, 14.3.3.2 ファイルベース

登録, 14.3.3

ラベルの一覧表示, 14.3.12.2 管理, 14.3, 14.3.1.2 データベース・ベースへの移動, 14.3.9 ラベルの昇格, 14.3.12.3 ラベルのパージ, 14.3.12.4 メタデータ・バージョンのパージ, 14.3.11 データベース・ベースの登録, 14.3.2.1.1 ファイルベースの登録, 14.3.3.1 サポート対象のデータベース, 14.3.1.1 メタデータの転送, 14.3.8 バージョン, 14.3.1 表示, 14.3.6 MDSスキーマ

データファイル, D.2

説明, D.1

表領域, D.2

メッセージ相関, 12.5 メッセージ・レベル, 12.4.3 メッセージ・タイプ, 12.4.3 メタデータ

パーティションからのエクスポート, 14.3.7.2

パーティションへのインポート, 14.3.7.2

新しいパーティションへの転送, 14.3.8

メタデータ・アーカイブ(MAR), 10.1.1, 14.3 メタデータ・ラベル

作成, 14.3.12.1

削除, 14.3.12.5

表示, 14.3.12.2

管理, 14.3.12

昇格, 14.3.12.3

パージ, 14.3.12.4

ロールバック, 14.3.12.3

メタデータ・リポジトリ, 2.7, 14.1

キャラクタ・セットの変更, 14.4.2

ポート、変更, 5.3.6

リリース番号, G.2.5

スキーマ

パスワードの変更, 14.4.1

コンポーネントのスキーマ, D 起動, 4.7.1, 4.7.1, 4.7.2 停止, 4.7.2 バージョン番号, G.2.5 メトリック

トラブルシューティング, I.3.1

Middlewareホーム, 2.4

バックアップ, 17.3.1

リカバリ, 18.2.1

本番環境への移行, 21 mod_osso

ポート番号, 5.3.2.3

ステータスの監視, 11.1, 11.1 移動計画

カスタマイズ, 20.3

ADF接続, 20.3.2

Oracle B2B, 20.3.2

Oracle HTTP Server, 20.3.2

Oracle Internet Directory, 20.3.2

Oracle Service Bus, 20.3.2, 20.3.2

Oracle SOA Suite用, 20.3.2

Oracle Virtual Directory, 20.3.2

コンポーネントのカスタマイズ, 20.3.2 configGroup要素の場所, 20.3.1 移行

エラーのリカバリ, 21.8

移行スクリプト, 20, 20.2, 20.2.1

エラーCLONE-20408, 21.7, 21.8

copyBinary, 20.2.1.1, 21.3.4, 21.9

copyConfig, 21.3.5, 21.3.5, 21.3.6.1, 21.3.6.2, 21.4.7.1, 21.9, 21.9

Javaコンポーネント, 20.2.1.3

ノード・マネージャ, 20.2.1.6

システム・コンポーネント, 20.2.1.4, 20.2.1.5

extractMovePlan, 20.2.1.7 ヘルプ, 20.2 概要, 20.1 Javaオプション, 20.2 JDK, 20.2, 20.2.1 pasteBinary, 20.2.1.2, 21.3.4, 21.9 pasteConfig, 21.3.5, 21.3.5, 21.3.6.1, 21.3.6.2, 21.4.7.1, 21.9, 21.9

Javaコンポーネント, 20.2.1.8

ノード・マネージャ, 20.2.1.11

システム・コンポーネント, 20.2.1.9, 20.2.1.10

サポート対象エンティティ, 20.1 テスト環境から本番環境へ移行, 21

監査ポリシー, 21.4.1.1

Oracle RACの考慮事項, 21.6

ヒューマン・ワークフロー, 21.4.2.1

Inbound Refinery, 21.4.4.1

Oracle Access Manager, 21.4.1.1

Oracle Adaptive Access Manager, 21.4.1.1

Oracle BI Discoverer, 21.4.9.1

Oracle Business Activity Monitoring, 21.4.2.1

Oracle Business Process Management, 21.4.2.1

Oracle Data Integrator, 21.4.10

Oracle Directory Integration Platform, 21.4.1.1

Oracle EPM Workspace, 21.4.5

Oracle Essbase, 21.4.5

Oracle Forms Services, 21.4.9.1

Oracle HTTP Server, 21.4.6.1.1

Oracle Hyperion Calculation Manager, 21.4.5

Oracle Hyperion Enterprise Performance Management, 21.4.5

Oracle Hyperion Financial Reporting, 21.4.5

Oracle Hyperion Provider Services, 21.4.5

Oracle Hyperion Smart View, 21.4.5

Oracle Identity Federation, 21.4.1.1

Oracle Identity Management, 21.4.1.1

Oracle Identity Navigator, 21.4.1.1

Oracle Information Rights Management, 21.4.4.1, 21.4.4.2

Oracle Internet Directory, 21.4.1.1

Oracle Portal, 21.4.9.1

Oracle Real-time Decisions, 21.4.8

Oracle Reports, 21.4.9.1

Oracle SOA Suite, 21.4.2

Oracle Virtual Directory, 21.4.1.1

Oracle Web Cache, 21.4.6.1.2

Oracle Web Services Manager, 21.4.1.1

Oracle WebCenter Content, 21.4.4, 21.4.4.1, 21.4.4.2

Oracle WebCenter Content Imaging, 21.4.4.1, 21.4.4.2

Oracle WebCenter Content Records, 21.4.4.1, 21.4.4.2

Oracle WebCenter Portal, 21.4.3

1つのホストに複数のインストール, 3.1 MW_HOME環境変数, 3.1, 3.1

N

ナビゲーション・ペイン

Fusion Middleware Control, 3.3.3

Netリスナー

起動, 4.7.1

ネットワーク構成

変更, 15.1

Oracle HTTP Server, 15.1.3

Oracle Web Cache, 15.1.3

Oracle WebLogic Server, 15.1.2

ノード・マネージャ, 2.2.3

スクリプトを有効化するように構成, 4.2.1

NOTIFICATIONメッセージ・タイプ, 12.4.3

O

OAAMスキーマ, D.1

OAAM_OFFLINEスキーマ, D.1

OAAM_PARTNスキーマ, D.1

OCSスキーマ, D.1

ODI_REPOスキーマ, D.1

ODL

「Oracle Diagnostic Logging (ODL)」を参照

ODLアーカイブ, 12.4.2 ODLログ, 12.4.2 オフライン・バックアップ, 16.3.1 ネットワークに接続されていない状態

ネットワーク接続のオンへの変更

DHCPアドレス, 15.3.2

静的IPアドレス, 15.3.1

OIDスキーマ

データファイル, D.2

説明, D.1

表領域, D.2

oidcmprecコマンド, A oidctlコマンド, A, A oiddiagコマンド, A oidmonコマンド, A oidprovtoolコマンド, A, A oidstatsコマンド, A OIMスキーマ

データファイル, D.2

表領域, D.2

オンライン・バックアップ, 16.3.1 ネットワークに接続された状態

ネットワーク接続のオフへの変更

IPアドレス, 15.3.3

ONS localポート

変更, 5.3.4

ONS remoteポート

変更, 5.3.4

ONS requestポート

変更, 5.3.4

OPMN

「Oracle Process Manager and Notification Server (OPMN)」を参照

opmnctlコマンド, 3.5.2, A

registerinstance, 18.2.4.2, 18.3.4.5.3, 18.3.4.5.4, 18.3.4.8.1, 18.3.4.8.2, 18.3.4.8.3, 18.3.4.8.4, 19.4.1, 21.4.6.1.2

restartproc, 4.3.2

startall, 4.3.2, 4.3.2

startproc, 4.3.2

status, 3.5.2, 11.1

stopall, 4.3.2, 4.3.2

stopproc, 4.3.2

updatecomponentregistration, 5.3.6, 18.3.4.4, 18.3.4.8.2

updateinstanceregistration, 18.3.4.4, 18.3.4.4, 18.3.4.8.1, 18.3.4.8.2

opmn.xmlファイル

ポート, 5.3.4

ORABAMスキーマ

データファイル, D.2

説明, D.1

表領域, D.2

Oracle Access Manager, 1.2

バックアップとリカバリの推奨事項, 16.5.2.6

IPV6のサポート, 15.5.7

テストから本番への移行, 21.4.1.1

リカバリ, 18.2.7.5, 18.3.4.5.7

Oracle Adaptive Access Manager

バックアップとリカバリの推奨事項, 16.5.2.7

テストから本番への移行, 21.4.1.1

リカバリ, 18.2.7.6, 18.3.4.5.8

スキーマ, D.1

Oracle Application Development Framework

アプリケーション, 10.1.1

WLSTの呼び出し, 3.5.1.1

Oracle B2B

バックアップとリカバリの推奨事項, 16.5.3.3

テストから本番への移行, 21.4.2.1

スキーマ, D.1

Oracle BI Intelligence Enterprise Edition

「Oracle Business Intelligence」を参照

Oracle BPEL Process Manager

バックアップとリカバリの推奨事項, 16.5.3.1

スキーマ, D.1

Oracle Business Activity Monitoring

バックアップとリカバリの推奨事項, 16.5.3.2

テストから本番への移行, 21.4.2.1

スキーマ, D.1

Oracle Business Intelligence, 1.2

バックアップとリカバリの推奨事項, 16.5.8.1

テストから本番への移行, 21.4.7

リカバリ, 18.2.7.10, 18.3.4.9

Oracle Business Intelligence Discoverer

バックアップとリカバリの推奨事項, 16.5.7.4

コマンドライン・ツール, A

テストから本番への移行, 21.4.9, 21.4.9.1

リカバリ, 18.3.4.8.4

スキーマ, D.1

Oracle Business Intelligence Publisher

バックアップとリカバリの推奨事項, 16.5.8.2

テストから本番への移行, 21.4.7

リカバリ, 18.2.7.11, 18.3.4.10

Oracle Business Process Management

バックアップとリカバリの推奨事項, 16.5.3.7

テストから本番への移行, 21.4.2.1

リカバリ, 18.2.7.7

スキーマ, D.1

Oracle Business Rules

バックアップとリカバリの推奨事項, 16.5.3.6

スキーマ, D.1

Oracle共通ホーム, 2.6 Oracle Content Server

バックアップとリカバリの推奨事項, 16.5.4.6

スキーマ, D.1

Oracle Data Integrator

バックアップとリカバリの推奨事項, 16.5.10

テストから本番への移行, 21.4.10

リカバリ, 18.2.7.17, 18.3.4.15

スキーマ, D.1

Oracle Database

即時停止, 4.8.2

リカバリ, 18.3.6

Oracle Diagnostic Logging (ODL), 12.1

メッセージ形式, 12.2

メッセージのヘッダー・フィールド, 12.2

Oracle Directory Integration Platform

バックアップとリカバリの推奨事項, 16.5.2.3

テストから本番への移行, 21.4.1, 21.4.1.1

リカバリ, 18.3.4.5.3

スキーマ, D.1

Oracle Directory Services Manager

バックアップとリカバリの推奨事項, 16.5.2.4

Oracle Enterprise Manager Fusion Middleware Control

「Fusion Middleware Control」を参照

Oracle EPM Workspace

テスト環境から本番環境へ移行, 21.4.5

Oracle Essbase

バックアップとリカバリの推奨事項, 16.5.9.1

テスト環境から本番環境へ移行, 21.4.5

リカバリ, 18.2.7.13, 18.3.4.12

Oracle Event Processing

スキーマ, D.1

Oracle Forms Services

バックアップとリカバリの推奨事項, 16.5.7.2

テストから本番への移行, 21.4.9, 21.4.9.1

リカバリ, 18.3.4.8.2

Oracle Fusion Middleware

概要, 2

Oracle Fusion Middleware監査フレームワーク, 17.2

WLSTの呼び出し, 3.5.1.1

Oracle Fusion Middleware環境

起動, 4.7.1

停止, 4.7.2

Oracle Fusion Middlewareアップグレード・アシスタント, A Oracleホーム, 2.6

リカバリ, 18.2.3

Oracle HTTP Server, 1.2

バックアップとリカバリの推奨事項, 16.5.6.1

ネットワーク構成の変更, 15.1.3

IPV6のサポート, 15.5.2

テストから本番への移行, 21.4.6.1.1

ポート

リスニングの変更, 5.3.2、5.3.2.2

SSLリスニングの変更, 5.3.2.3

1024未満, 5.3.2.1

リカバリ, 18.3.4.7.1 URL, B Oracle Hyperion Calculation Manager

バックアップとリカバリの推奨事項, 16.5.9.2

テスト環境から本番環境へ移行, 21.4.5

リカバリ, 18.2.7.14, 18.3.4.13

Oracle Hyperion Enterprise Performance Management

テストから本番への移行, 21.4.5

スキーマ, D.1

Oracle Hyperion Financial Reporting

バックアップとリカバリの推奨事項, 16.5.9.3

テスト環境から本番環境へ移行, 21.4.5

リカバリ, 18.2.7.15, 18.3.4.14

Oracle Hyperion Provider Services

テスト環境から本番環境へ移行, 21.4.5

Oracle Hyperion Smart View

バックアップとリカバリの推奨事項, 16.5.9.4

テスト環境から本番環境へ移行, 21.4.5

リカバリ, 18.2.7.16

Oracle Identity Federation, 1.2

バックアップとリカバリの推奨事項, 16.5.2.5

テストから本番への移行, 21.4.1.1

リカバリ, 18.3.4.5.4

スキーマ, D.1

Oracle Identity Management, 1.2

バックアップとリカバリの推奨事項, 16.5.2

テストから本番への移行, 21.4.1.1

起動, 4.7.1

Oracle Identity Manager

バックアップとリカバリの推奨事項, 16.5.2.8

リカバリ, 18.2.7.3, 18.3.4.5.5

スキーマ, D.1

Oracle Identity Navigator

バックアップとリカバリの推奨事項, 16.5.2.9

テストから本番への移行, 21.4.1.1

リカバリ, 18.2.7.4, 18.3.4.5.6

Oracle Information Rights Management

バックアップとリカバリの推奨事項, 16.5.11.1

テストから本番への移行, 21.4.4.1, 21.4.4.2

リカバリ, 18.2.7.18

スキーマ, D.1

Oracleインスタンス, 2.3

環境変数, 3.1, 3.1

リカバリ, 18.2.4

ログ・ファイルの表示, 12.3.1.2

ステータスの表示, 3.5.2

Oracle Internet Directory, 1.2

エントリの追加, A、A

プロビジョニング・エントリの管理, A, A

クライアントの認証, A

バックアップとリカバリの推奨事項, 16.5.2.1

カタログ・エントリ, A

比較, A

属性値の比較, A

エントリの作成, A

エントリの削除, A

サブツリーの削除, A

診断ツール, A

Diffie-Hellman SSLポート, H.2.5.2.2

統計の推定, A

データの移行, A, A

エントリの変更, A, A, A, A

監視, A

テストから本番への移行, 21.4.1, 21.4.1.1

ポート

更新, 5.3.6

リカバリ, 18.3.4.5.1 リリース番号, G.2.4 レプリケーション・ツール, A スキーマ, D.1 エントリの検索, A 起動と停止, A、A バージョン番号, G.2.4 Oracle Inventory

リカバリのための更新, 18.3.5.7

Oracle JRF, 19.3.1

適用, 19.3.1

バックアップとリカバリの推奨事項, 16.5.5

JRFの起動, 3.5.1.1

Oracle Management Agent

URLの変更, I.3.1.4

リカバリ, 18.3.5.3

Oracle Mediator

スキーマ, D.1

Oracle Metadata Services

WLSTの呼び出し, 3.5.1.1

スキーマ, D.1

Oracle Platform Security Services, 1.2

バックアップとリカバリの推奨事項, 16.5.5.2

WLSTの呼び出し, 3.5.1.1

Oracle Portal, 1.2

バックアップとリカバリの推奨事項, 16.5.7.1

テストから本番への移行, 21.4.9, 21.4.9.1

ポート

変更, 5.3.5

リカバリ, 18.3.4.8.1 スキーマ, D.1 Oracle Process Manager and Notification Server (OPMN), 3.5.2, 3.5.2, A

ポート

変更, 5.3.4

Oracle Real-Time Decisions

バックアップとリカバリの推奨事項, 16.5.8.3

テストから本番への移行, 21.4.8

リカバリ, 18.2.7.12, 18.3.4.11

スキーマ, D.1

Oracle Reports

バックアップとリカバリの推奨事項, 16.5.7.3

テストから本番への移行, 21.4.9, 21.4.9.1

リカバリ, 18.3.4.8.3

Oracle Service Bus

バックアップとリカバリの推奨事項, 16.5.3.4

Oracle Single Sign-On

Oracle Internet Directoryの変更, A

IPV6のサポート, 15.5.5

ポート、更新, 5.3.6

スキーマ, D.1

URLの更新, A

Oracle SOA Suite, 1.2

バックアップとリカバリの推奨事項, 16.5.3

コンポジット・アプリケーション, 10.1.1

テストから本番への移行, 21.4.2

リカバリ, 18.3.3.3, 18.3.4.6

スキーマ, D.1

Oracle User Messaging Service

スキーマ, D.1

Oracle Virtual Directory, 1.2

バックアップとリカバリの推奨事項, 16.5.2.2

テストから本番への移行, 21.4.1, 21.4.1.1

リカバリ, 18.3.4.5.2

Oracleウォレット, 8.1.1.2

JKSキーストア, H.1.6

自動ログイン, 8.4.1.1

サード・パーティへの変更, 8.4.4.5, 8.4.8.3

コンポーネント, 6.1.3

作成, 8.4.4.1

削除, 8.4.4.8, 8.4.4.11

エクスポート, 8.4.4.8, 8.4.4.8

インポート, 8.4.4.9

ライフサイクル, 8.4.3

保守, 8.4.8

Fusion Middleware Controlにおける管理, 8.4.2

ネーミング規則, 8.4.1.4

操作, 8.4.4

タイプ, 8.4.1.1

Oracle Wallet Manager, H

同等の機能, H.3

Oracle Web Cache, 1.2

バックアップとリカバリの推奨事項, 16.5.6.2

ネットワーク構成の変更, 15.1.3

IPV6の無効化, 15.5.4

テストから本番への移行, 21.4.6.1.2

ポート

変更, 5.3.3

リカバリ, 18.3.4.7.2 Oracle Web Services

WLSTの呼び出し, 3.5.1.1

Oracle Web Services Manager, 1.2

バックアップとリカバリの推奨事項, 16.5.5.1

WLSTの呼び出し, 3.5.1.1

テストから本番への移行, 21.4.1.1

スキーマ, D.1

Oracle WebCenter Content, 1.2

バックアップとリカバリの推奨事項, 16.5.11, 16.5.11.3

テストから本番への移行, 21.4.4, 21.4.4.2

リカバリ, 18.2.7.20, 18.3.4.16.1

スキーマ, D.1

Oracle WebCenter Content Imaging

バックアップとリカバリの推奨事項, 16.5.11.2

テストから本番への移行, 21.4.4.1, 21.4.4.2

リカバリ, 18.2.7.19

スキーマ, D.1

Oracle WebCenter Content Inbound Refinery

テストから本番への移行, 21.4.4.1

Oracle WebCenter Content Records

バックアップとリカバリの推奨事項, 16.5.11.4

テストから本番への移行, 21.4.4.1, 21.4.4.2

リカバリ, 18.2.7.21, 18.3.4.16.2

Oracle WebCenter Portal, 1.2

アプリケーション, 10.1.1

バックアップとリカバリの推奨事項, 16.5.4

アプリケーションのデプロイ, 10.6

テストから本番への移行, 21.4.3

スキーマ, D.1、D.1

スキーマ, D.1

Oracle WebCenter Portalのアクティビティ・グラフ

バックアップとリカバリの推奨事項, 16.5.4.4

リカバリ, 18.2.7.8

スキーマ, D.1

Oracle WebCenter Portal分析

バックアップとリカバリの推奨事項, 16.5.4.5

リカバリ, 18.2.7.9

スキーマ, D.1

Oracle WebCenter Portalのディスカッション・サーバー

バックアップとリカバリの推奨事項, 16.5.4.3

スキーマ, D.1

Oracle WebCenter Portalのポートレット・プロデューサ

バックアップとリカバリの推奨事項, 16.5.4.2

Oracle WebLogic Scripting Tool(WLST)

システム・コンポーネントのコマンド, 3.5.1.2

カスタム・コマンド, 3.5.1.1

「WLSTコマンド」も参照

Oracle WebLogic Server, 1.2

バックアップ, 16.3

バックアップとリカバリの推奨事項, 16.5.1

ネットワーク構成の変更, 15.1.2

ポート番号の変更, 5.3.1

JMS

バックアップとリカバリの推奨事項, 16.5.1.2

Oracle WebLogic Server管理コンソール, 3.4 ORACLE_HOME環境変数, 3.1、3.1 ORACLE_INSTANCE環境変数, 3.1, 3.1 ORAIRMスキーマ, D.1

データファイル, D.2

表領域, D.2

orapkiユーティリティ, H, H.2.5.2

証明書リクエストの追加, H.2.4.2, H.2.6.12

証明書の追加, H.2.6.12

ルート証明書の追加, H.2.4.2

信頼できる証明書の追加, H.2.4.2

ユーザー証明書の追加, H.2.4.2

証明書の作成, H.2.6.1

ウォレット・パスワードの変更, H.2.6.13

コマンド, H.2.6

自動ログイン・ウォレットの作成, H.2.4.1

署名付き証明書の作成, H.2.3, H.2.6.1

ウォレットの作成, H.2.4.1, H.2.6.14

証明書失効リストの削除, H.2.6.3, H.2.6.4

証明書失効リストの表示, H.2.6.5

証明書の表示, H.2.6.2

ヘルプの表示, H.2.2

同等の機能, H.4

証明書リクエストのエクスポート, H.2.4.3

証明書のエクスポート, H.2.4.3, H.2.6.16

トラスト・チェーンのエクスポート, H.2.6.17

CRLハッシュ値の生成, H.2.6.6

証明書失効リストの一覧表示, H.2.6.7, H.2.6.8, H.2.6.9, H.2.6.11

証明書失効リストの管理, H.2.5

ウォレットの管理, H.2.4

新しい機能, H.1

証明書ステータスの取得, H.2.6.9

概要, H.2.1

構文, H.2.1.1

証明書失効リストのアップロード, H.2.6.10

使用方法, H.1.1

CRL署名の確認, H.2.6.11

証明書の表示, H.2.3, H.2.6.15

ウォレットの表示, H.2.4.1

ORASDPMスキーマ, D.1

データファイル, D.2

表領域, D.2

ORASSO表領域

データファイル, D.2

説明, D.1

表領域, D.2

P

パーティション

概要, 14.3.1

クローニング, 14.3.7.1

作成, 14.3.7.2, 14.3.7.2, 14.3.9

削除, 14.3.10.1, 14.3.10.2

メタデータのエクスポート, 14.3.7.2, 14.3.8.2, 14.3.9

メタデータのインポート, 14.3.7.2, 14.3.8.2

メタデータの転送, 14.3.8

パスワードで保護されたウォレット, 8.4.1.1 パスワード

管理ユーザー向けの変更, 3.8

pasteBinaryスクリプト, 20.2.1.2, 21.3.4, 21.9 pasteConfigスクリプト, 21.3.5, 21.3.5, 21.3.6.1, 21.3.6.2, 21.4.7.1, 21.9, 21.9

Javaコンポーネント, 20.2.1.8

ノード・マネージャ, 20.2.1.11

システム・コンポーネント, 20.2.1.9, 20.2.1.10

PATH環境変数, 3.1、3.1 PKI, 6.1.2 ポート番号

変更, 5.3

管理, 5

表示, 5.2

コマンドライン, 5.2.1

Fusion Middleware Control, 5.2.2

PORTALスキーマ

データファイル, D.2

説明, D.1

表領域, D.2

PORTLETスキーマ

データファイル, D.2

説明, D.1

表領域, D.2

ポート

変更, 5.3

メタデータ・リポジトリ, 5.3.6

OPMN, 5.3.4

Oracle HTTP Server, 5.3.2, 5.3.2.2, 5.3.2.3

Oracle Portal, 5.3.5

Oracle Web Cache, 5.3.3

WebLogic Server, 5.3.1

管理, 5 更新

Oracle Internet Directory, 5.3.6

Oracle Single Sign-On, 5.3.6

「ポート番号」も参照 秘密鍵の暗号化, 6.1.2 問題キー

診断フレームワーク, 13.1.1

問題

診断フレームワーク, 13.1.1

手順

IPv6

認証用とリソースWebGate用に個別のプロキシを使用したIPv6を構成する手順, 15.5.6.3

promoteMetadataLabelコマンド, 14.3.12.3 公開鍵の暗号化, 6.1.2 purgeMetadataコマンド, 14.3.11, 14.3.11.2 purgeMetadataLabelsコマンド, 14.3.12.4.2 データのパージ, 14.5

MDSリポジトリ, 14.5

Oracle Application Development Framework, 14.5

Oracle Business Intelligence Publisher, 14.5

Oracle SOA Suite, 14.5

Oracle Web Services

JRFデータ, 14.5.1

Oracle Web Services Manager, 14.5 Oracle WebCenter Content, 14.5 Oracle WebCenter Portal, 14.5, 14.5.2 Oracle WebCenter Portalのアクティビティ・ストリーム, 14.5.2.1 Oracle WebCenter Portalの分析, 14.5.2.2, 14.5.2.3 Oracle WebLogic Server, 14.5 Oracle WebLogic Services, 14.5, 14.5.1 Webサービス, 14.5, 14.5.1 メタデータ・バージョン履歴のパージ

MDS, 14.3.11

Q

QuickTrace, 12.6.1

構成, 12.6.1.1

WLSTを使用した構成, 12.6.1.2

使用禁止, 12.6.1.2.3

インシデント, 12.6.1.2.2

メッセージのファイルへの書き込み, 12.6.1.2.2

ファイルへの書き込み, 12.6.1.1.2

R

リカバリ

Oracle Hyperion Calculation Manager, 18.2.7.14, 18.3.4.13

リカバリ, 18

管理サーバー, 18.2.5

管理サーバー・ホスト, 18.3

アプリケーション, 18.2.9

クラスタ, 18.2.8

コンポーネント, 18.2.7

コンポーネント・ホスト, 18.3.4

データベース, 18.3.6

データベース(複数), 18.2.10, 18.3.6

ドメイン, 18.2.2

Fusion Middleware Control, 18.3.5.1

Javaコンポーネント, 18.3.4.1

ホストの破損, 18.3

制限事項, 18.3.5

管理対象サーバー, 18.2.6 管理対象サーバー・ホスト, 18.3.3 Middlewareホーム, 18.2.1 Oracle Access Manager, 18.2.7.5, 18.3.4.5.7 Oracle Adaptive Access Manager, 18.2.7.6, 18.3.4.5.8 Oracle BI Enterprise Edition, 18.2.7.10, 18.3.4.9 Oracle Business Intelligence Discoverer, 18.3.4.8.4 Oracle Business Intelligence Publisher, 18.2.7.11, 18.3.4.10 Oracle Business Process Management, 18.2.7.7 Oracle Data Integrator, 18.2.7.17, 18.3.4.15 Oracle Directory Integration Platform, 18.3.4.5.3 Oracle Essbase, 18.2.7.13 Oracle Forms Services, 18.3.4.8.2 Oracleホーム, 18.2.3 Oracle HTTP Server, 18.3.4.7.1 Oracle Hyperion Financial Reporting, 18.2.7.15, 18.3.4.14 Oracle Hyperion Smart View, 18.2.7.16 Oracle Identity Federation, 18.3.4.5.4 Oracle Identity Manager, 18.2.7.3, 18.3.4.5.5 Oracle Identity Navigator, 18.2.7.4, 18.3.4.5.6 Oracle Information Rights Management, 18.2.7.18 Oracleインスタンス・ホーム, 18.2.4 Oracle Internet Directory, 18.3.4.5.1 Oracle Management Agent, 18.3.5.3 Oracle Portal, 18.3.4.8.1 Oracle Real-Time Decisions, 18.2.7.12, 18.3.4.11 Oracle Reports, 18.3.4.8.3 Oracle SOA Suite, 18.3.4.6 Oracle Virtual Directory, 18.3.4.5.2 Oracle Web Cache, 18.3.4.7.2 Oracle WebCenter Content, 18.2.7.20, 18.3.4.16.1 Oracle WebCenter Content Imaging, 18.2.7.19 Oracle WebCenter Content Records, 18.2.7.21, 18.3.4.16.2 Oracle WebCenter Portalのアクティビティ・グラフ, 18.2.7.8 Oracle WebCenter Portalの分析, 18.2.7.9 推奨事項, 18.1 計画, 16.4.2 システム・コンポーネント, 18.3.4.3 Windowsレジストリ, 18.3.5.8 redeployコマンド, 10.3.3.2 アプリケーションの再デプロイ, 10.3.3 ページのリフレッシュ

Fusion Middleware Control, 3.3.3

コンポーネントの登録

更新, 5.3.6, 18.3.4.4, 18.3.4.8.2

インスタンスの登録

更新, 18.3.4.4, 18.3.4.8.1

registerinstanceコマンド, 18.2.4.2, 18.3.4.5.3, 18.3.4.5.4, 18.3.4.8.1, 18.3.4.8.2, 18.3.4.8.3, 18.3.4.8.4, 19.4.1, 21.4.6.1.2 registerMetadataDBRepositoryコマンド, 14.3.2.1.2 関係ID (RID), 12.5 リリース番号

アプリケーション・サーバー, G.2.1

コンポーネント, G.2.3

書式, G.1, G.1

メタデータ・リポジトリ, G.2.5

Oracle Internet Directory, G.2.4

表示, G.2, G.2.1

Remote Diagnostic Agent (RDA), 13.4.7, I.5.1 removeKeyStoreObjectコマンド, 6.9.26 removeWalletObjectコマンド, 6.9.27 remtoolコマンド, A 環境のレプリケート, 21 リポジトリ作成ユーティリティ(RCU)

使用, 14.2

右クリック・ターゲット・メニュー

Fusion Middleware Control, 3.3.3

ロール, 3.3.4

MDSリポジトリ, 14.3.1.2

RTDスキーマ

データファイル, D.2

説明, D.1

表領域, D.2

S

スケーラビリティ, 19.1

スキーマ

データベース・ベース・リポジトリ

管理, 14.4

コンポーネント, D Secure Socket Layer

「SSL」を参照

セキュリティ, 6 選択的トレース, 12.6.2

構成, 12.6.2.2.1

無効化, 12.6.2.1.3, 12.6.2.2.3

メッセージの表示, 12.6.2.2.2

トレースの表示, 12.6.2.1.2

自己署名証明書, 8.3.5.11 setAppMetadataRepositoryコマンド, 10.4.1.2 setLogLevelコマンド, 12.4.3.2 setNMPropsスクリプト, 4.2.1 SHLIB_PATH環境変数, 3.1 showIncidentコマンド, 13.4.2.2, 13.4.2.2 SHUTDOWN IMMEDIATE, 4.8.2 SOAINFRAスキーマ

データファイル, D.2

説明, D.1, D.1

表領域, D.2

ソフトウェア・インベントリ

表示, G.2

Spring

異なるバージョンの使用, I.2.2

SSL, 6

認証モード, 6.2.3

ベスト・プラクティス, 6.8

証明書のライフサイクル, 8.3.4

クライアント側, 6.5.6

概念, 6.1

構成, 6

スクリプトを使用, 7.1

CRLの統合, 6.7.2 Oracle WebLogic Server上のデータ・ソース, 6.6.3.2 データ層, 6.6 PKCS#11ウォレットを使用するコンポーネント, 6.7.1 構成ツール, 6.3 Web層, 6.4 HSMデバイス, 6.7.1 中間層, 6.5 Oracle Fusion Middleware, 6, 6.2.1 WLSTの呼び出し, 3.5.1.1 LDAP認証プロバイダ

アウトバウンド, 6.5.1.2.3

OPSS

アウトバウンド, 6.5.1.2.1

Oracle Database, 6.6.3.1 Oracle Directory Integration Platform, 6.5.4.1 Oracle Directory Services Manager, 6.5.4.3 Oracle Discoverer, 6.5.5.3 Oracle Forms, 6.5.5.2 Oracle HTTP Server, 6.4.3 Oracle IdentityおよびAccess Management, 6.5.4 Oracle Identity Federation, 6.5.4.2 Oracle Internet Directory, 6.6.1 Oracle Portal, 6.5.5.4 Oracle Reports, 6.5.5.1 Oracle SOA Suite, 6.5.2 Oracle Virtual Directory, 6.6.2 Oracle Web Cache, 6.4.2 Oracle WebCenter Portal, 6.5.3 Oracle WebLogic Server, 6.5.1.1

アウトバウンド, 6.5.1.2

Oracle WebLogic ServerからOracleのデータベースへ, 6.5.1.2.4 概要, 6.1.1 プロパティ・ファイル, 6.9.28 ツール, 6.2.2, 6.2.4, 8.1.2

キーストア管理, 8.1

keytool, 6.5.4.2

Oracle Wallet Manager, H

orapki, H

SSL構成ツール, H.5

WLST, 6.9, 8.1.2

WLSTコマンド, 6.9 SSL自動化ツール, 7.1 SSL構成ツール

同等の機能, H.5

SSLリスニング・ポート

変更, 5.3.2.3

SSLプロトコル, 6.1.4 ssocfgコマンド, A ssooconf.sqlコマンド, A startApplicationコマンド, 4.3.2, 4.6.2 起動

管理サーバー, 4.2.2

資格証明を入力しない, 4.2.4

アプリケーション, 4.3.2 コンポーネント, 4.3, 4.3, 4.3.2, 4.3.2 管理対象サーバー, 4.2.3.1, 4.2.3.2

資格証明を入力しない, 4.2.4

メタデータ・リポジトリ, 4.7.1 Netリスナー, 4.7.1 Oracle Identity Management, 4.7.1 サブプロセス, 4.3.2 起動と停止, 4 startTracingコマンド, 12.6.2.2.1 stateコマンド, 11.1 静的IPアドレス

ネットワーク接続のオフへの変更, 15.3.3

移動, 15.3.1

ステータス

表示, 11.1, 11.1

コンポーネント, 11.1.5

statusコマンド, 11.1 stopApplicationコマンド, 4.3.2, 4.6.2 停止, 4.2.2, 4.2.3.2, 4.2.4

アプリケーション, 4.3.2

コンポーネント, 4.3, 4.3, 4.3.2, 4.3.2

管理対象サーバー, 4.2.3.1

資格証明を入力しない, 4.2.4

サブプロセス, 4.3.2 停止と起動, 4 stopTracingコマンド, 12.6.2.2.3 システム・コンポーネント, 2.1, 3.5.2

リカバリ, 18.3.4.3

システムMBeanブラウザ, 3.6.1

MDSパーティションのクローニング, 14.3.7.1

システムMBean

cloneMetadataPartition, 14.3.7.1

T

T2P_JAVA_OPTIONS環境変数, 20.2

ターゲット情報アイコン

Fusion Middleware Control, 3.3.3

ターゲット・メニュー

Fusion Middleware Control, 3.3.3, 3.3.3

ターゲット名

Fusion Middleware Control, 3.3.3

ターゲット・ナビゲーション・ペイン

Fusion Middleware Control, 3.3.3

TEMP環境変数, 3.1 テストから本番へ, 21

監査ポリシーの移行, 21.4.1.1

ヒューマン・ワークフローの移行, 21.4.2.1

Oracle Access Managerの移行, 21.4.1.1

Oracle Adaptive Access Managerの移行, 21.4.1.1

Oracle BI Discovererの移行, 21.4.9.1

Oracle Business Intelligence Discovererの移行, 21.4.9

Oracle Business Process Managementの移行, 21.4.2.1

Oracle Data Integratorの移行, 21.4.10

Oracle Directory Integration Platformの移行, 21.4.1, 21.4.1.1

Oracle Directory Services Managerの移行, 21.4.1

Oracle Forms Servicesの移行, 21.4.9, 21.4.9.1

Oracle HTTP Serverの移行, 21.4.6.1.1

Oracle Identity Federationの移行, 21.4.1.1

Oracle Identity Managementの移行, 21.4.1.1

Oracle Identity Navigatorの移行, 21.4.1.1

Oracle Information Rights Managementの移行, 21.4.4.1, 21.4.4.2

Oracle Internet Directoryの移行, 21.4.1, 21.4.1.1

Oracle Portalの移行, 21.4.9, 21.4.9.1

Oracle Reportsの移行, 21.4.9, 21.4.9.1

Oracle Single Sign-On Serverの移行, 21.4.1

Oracle SOA Suiteの移行, 21.4.2

Oracle Virtual Directoryの移行, 21.4.1, 21.4.1.1

Oracle Web Cacheの移行, 21.4.6.1.2

Oracle Web Services Managerの移行, 21.4.1.1

Oracle WebCenter Contentの移行, 21.4.4, 21.4.4.1, 21.4.4.2

Oracle WebCenter Content Imagingの移行, 21.4.4.1, 21.4.4.2

Oracle WebCenter Content Inbound Refineryの移行, 21.4.4.1

Oracle WebCenter Content Recordsの移行, 21.4.4.1, 21.4.4.2

Oracle WebCenter Portalの移行, 21.4.3

Oracle BI Publisher, 21.4.7

Oracle Business Activity Monitoring, 21.4.2.1

Oracle Business Intelligence, 21.4.7

Oracle Essbase, 21.4.5

Oracle Hyperion Calculation Manager, 21.4.5

Oracle Hyperion Enterprise Performance Management, 21.4.5

Oracle Hyperion Financial Reporting, 21.4.5

Oracle Hyperion Provider Services, 21.4.5

Oracle Hyperion Smart View, 21.4.5

Oracle Real-Time Decisions, 21.4.8

概要, 21.2

TMP環境関数, 3.1 トポロジ・ビューア, 11.3

Fusion Middleware Control, 3.3.3

TRACEメッセージ・タイプ, 12.4.3 トレース, 12.6

QuickTrace, 12.6.1

選択的, 12.6.2

トラブルシューティング, I

Fusion Middleware Control, I.3

U

UCMスキーマ, D.1

undeployコマンド, 10.3.2.2

アプリケーションのアンデプロイ, 10.3.2

updatecomponentregistrationコマンド, 5.3.6, 18.3.4.4, 18.3.4.4, 18.3.4.8.2, 18.3.4.8.2

updateinstanceregistrationコマンド, 18.3.4.4, 18.3.4.8.1

ユーザー名

管理者, 3.3.1

ユーザー, 3.3.4

V

バージョン番号

アプリケーション・サーバー, G.2.1

コンポーネント, G.2.3

書式, G.1

メタデータ・リポジトリ, G.2.5

Oracle Internet Directory, G.2.4

表示, G.2.1

バージョン

MDSリポジトリ, 14.3.1

W

ウォレット

orapkiを使用した管理, H.2.4

WARNINGメッセージ・タイプ, 12.4.3 WEBCENTERスキーマ

データファイル, D.2

説明, D.1

表領域, D.2

WebLogic診断フレームワーク(WLDF), 13.1 WebLogic Serverホーム, 2.5 Windowsレジストリ

リカバリ, 18.3.5.8

wlstコマンド, A WLSTコマンド

applyJRF, 19.3.1

configureLogHandler, 12.4.1.2, 12.4.2.2, 12.4.4.2, 12.4.5.1, 12.6.1.2.1

configureTracingLoggers, 12.6.2.2.1

createIncident, 13.4.6.1

createMetadataLabel, 14.3.12.1

createMetadataPartition, 14.3.7.2, 14.3.9

deleteMetadataLabel, 14.3.12.5

deleteMetadataPartition, 14.3.10.2

deploy, 10.3.1.2, 10.4.1.2

deregisterMetadataDBRepository, 14.3.2.3.2

describeDump, 13.4.4.2

displayLogs, 12.3.1.2, 12.3.2.2

executeDump, 13.4.4.3

exportMetadata, 14.3.7.2, 14.3.8.2, 14.3.9

SSL, 6.9

getIncidentFile, 13.4.1, 13.4.2.2

getMDSArchiveConfig, 10.4.1.2

importMetadata, 14.3.7.2, 14.3.8.2

listActiveTraces, 12.6.2.2.2

listDumps, 13.4.4.1

listIncidents, 13.4.2.2

listLogs, 12.3.1.2

listMetadataLabel, 14.3.12.2

listProblems, 13.4.1, 13.4.2.1

promoteMetadataLabel, 14.3.12.3

purgeMetadata, 14.3.11, 14.3.11.2

purgeMetadataLabels, 14.3.12.4.2

redeploy, 10.3.3.2

registerMetadataDBRepository, 14.3.2.1.2

setAppMetadataRepository, 10.4.1.2

showIncident, 13.4.2.2, 13.4.2.2

startApplication, 4.3.2, 4.6.2

startTracing, 12.6.2.2.1

state, 11.1

stopApplication, 4.3.2, 4.6.2

stopTracing, 12.6.2.2.3

undeploy, 10.3.2.2

Copyright © 2009, 2013, Oracle and/or its affiliates. All rights reserved.