Oracle® Fusion Middleware

WebGate for Oracle Access Managerのインストール

11gリリース2 (11.1.2.1.0)

B72795-02(原本部品番号:E38922-02)

2013年9月

Oracle Fusion Middleware WebGate for Oracle Access Managerのインストール, 11gリリース2 (11.1.2.1.0)

B72795-02

Copyright © 1999, 2013,  Oracle and/or its affiliates. All rights reserved.

原本著者:  Wortimla RS

原本協力著者: Kevin Kessler

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

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

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

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

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

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

目次

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

1 概要

2 Oracle HTTP Server 11g WebGate for OAMのインストールおよび構成

- 2.1 Oracle HTTP Server 11g WebGateのインストールの概要

- 2.2 Oracle HTTP Server 11g WebGateのインストールの前提条件

- 2.2.1 Oracle Fusion Middlewareの動作要件

- 2.2.2 JREのインストール

- 2.2.3 Oracle HTTP Server 11g Webサーバーのインストールおよび構成

- 2.2.4 Oracle Access Manager 11gのインストールおよび構成

- 2.2.5 Windows 2003およびWindows 2008 64ビット・プラットフォームにおける64ビットOracle HTTP Server 11g WebGateの前提条件

- 2.3 Oracle HTTP Server 11g WebGateのインストール

- 2.3.1 ソフトウェアの入手

- 2.3.2 Oracle HTTP Server 11g WebGateインストーラの起動

- 2.3.3 Oracle HTTP Server 11g WebGateのインストール・フローおよび手順

- 2.4 Oracle HTTP Server 11g WebGateのインストール後の手順

- 2.5 Oracle HTTP Server 11g WebGateのインストールおよび構成の検証

- 2.6 新規のOracle HTTP Server 11g WebGateスタート・ガイド

- 2.6.1 新規のOracle HTTP Server 11g WebGateの登録

- 2.6.1.1 RREGツールの設定

- 2.6.1.2 OAM11gRequest.xmlファイルの更新

- 2.6.1.3 インバンド・モードの使用方法

- 2.6.1.4 アウトオブバンド・モードの使用方法

- 2.6.1.5 RREGによって生成されるファイルおよびアーティファクト

- 2.6.2 生成済のファイルおよびアーティファクトのOracle HTTP Server WebGateインスタンスの場所へのコピー

- 2.6.3 Oracle HTTP Serverインスタンスの再起動

- 2.7 Oracle HTTP Server 11g WebGateのアンインストール

- 2.7.1 アンインストールの画面と手順

- 2.7.2 Oracleホーム・ディレクトリの手動削除

- 2.8 Oracle HTTP Server 11g WebGateのサイレント・インストール

3 IHS 11g WebGate for OAMのインストールおよび構成

- 3.1 IHS 11g WebGateのインストールの概要

- 3.2 IHS 11g WebGateのインストールの前提条件

- 3.2.1 Oracle Fusion Middlewareの動作保証

- 3.2.2 JREのインストール

- 3.2.3 IHSのインストールおよび構成

- 3.2.4 OAM 11gのインストールおよび構成

- 3.2.5 64ビット・オペレーティング・システムでの32ビットIHS WebGateのインストール

- 3.3 IHS 11g WebGateのインストール

- 3.3.1 ソフトウェアの入手

- 3.3.2 IHS 11g WebGateインストーラの起動

- 3.3.3 インストール・フローおよび手順

- 3.4 IHS 11g WebGateのインストール後の手順

- 3.4.1 IHS WebGateインスタンスのデプロイ

- 3.4.2 環境変数の設定

- 3.4.3 EditHttpConfツールの実行

- 3.5 IHS 11g WebGateのインストールおよび構成の検証

- 3.6 新規のIHS 11g WebGateスタート・ガイド

- 3.6.1 新規のIHS 11g WebGateの登録

- 3.6.1.1 RREGツールの設定

- 3.6.1.2 OAM11gRequest.xmlファイルの更新

- 3.6.1.3 インバンド・モードの使用方法

- 3.6.1.4 アウトオブバンド・モードの使用方法

- 3.6.1.5 RREGによって生成されるファイルおよびアーティファクト

- 3.6.2 生成済のファイルおよびアーティファクトのIHS WebGateインスタンスの場所へのコピー

- 3.7 IHS Webサーバーの起動およびIHSリソースへのアクセス

- 3.8 IHS 11g Webgateのアンインストール

- 3.8.1 アンインストールの画面と手順

- 3.8.2 Oracleホーム・ディレクトリの手動削除

- 3.9 IHS 11g WebGateのサイレント・インストール

4 IHS WebGateのテスト環境から本番環境への移動

- 4.1 概要

- 4.2 前提条件

- 4.2.1 IBM HTTP Serverの構成

- 4.2.2 Oracle Access Management (OAM) Serverのコピー

- 4.2.3 本番ツールへの転送の検証

- 4.2.4 JDKバージョンの確認

- 4.3 WebGateのバイナリおよび構成のテストから本番へのレプリケート

- 4.3.1 WebGateバイナリのレプリケート

- 4.3.2 WebGate構成のレプリケート

はじめに

この「はじめに」には、『Oracle Fusion Middleware WebGate for Oracle Access Managerのインストール』に関する補足情報が記載されています。内容は次のとおりです。

- 対象読者

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

- 関連ドキュメント

- 表記規則

対象読者

『Oracle Fusion Middleware WebGate for Oracle Access Managerのインストール』ガイドは、11g WebGates for Oracle Access Managerのインストールを担当する管理者を対象にしています。このドキュメントでは、読者がエンタープライズ・コンポーネントをインストールした経験があると想定しています。Oracle Access Manager、WebGatesおよびOracle Application Serverの基本的な知識を持っておくことをお薦めします。

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

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWeb サイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

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 Identity and Access Management 11gリリース2 (11.1.2)のドキュメント・ライブラリに含まれる次のドキュメントを参照してください。

- Oracle Fusion Middleware Oracle Identity and Access Managementインストレーション・プランニング・ガイド

- Oracle Fusion Middleware Oracle Access Management管理者ガイド

- Oracle Fusion Middleware Oracle Identity and Access Managementインストレーション・プランニング・ガイド

- Oracle Fusion Middlewareのリリース・ノート

Oracleドキュメントには、Oracle Technology Network( OTN) Webサイトの次のURLから、オンラインでアクセスすることもできます。

http://docs.oracle.com/

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 概要

WebGateはOracle Access Manager (OAM)のWebサーバー・プラグインで、HTTPリクエストを捕捉して、認証と認可を行うためにアクセス・サーバーに転送します。

WebGateとOracle Access Managerが搭載された環境における代表的なワークフローについては、『Oracle Fusion Middleware Oracle Access Manager with Oracle Security Token Service管理者ガイド』のOAMエージェントを使用したSSOログイン処理に関する項を参照してください。

このマニュアルは、次の章で構成されています。

- Oracle HTTP Server 11g WebGate for OAMのインストールおよび構成

- IHS 11g WebGate for OAMのインストールおよび構成

- IHS WebGateのテスト環境から本番環境への移動

2 Oracle HTTP Server 11g WebGate for OAMのインストールおよび構成

この章では、Oracle HTTP Server 11g リリース2 WebGate for Oracle Access Managerをインストールおよび構成する方法を説明します。WebGateの紹介およびWebGateのインストールの概要については、第1章を参照してください。

この章は、次の項で構成されています。

- 第2.1項「Oracle HTTP Server 11g WebGateのインストールの概要」

- 第2.2項「Oracle HTTP Server 11g WebGateのインストールの前提条件」

- 第2.3項「Oracle HTTP Server 11g WebGateのインストール」

- 第2.4項「Oracle HTTP Server 11g WebGateのインストール後の手順」

- 第2.5項「Oracle HTTP Server 11g WebGateのインストールおよび構成の検証」

- 第2.6項「新規のOracle HTTP Server 11g WebGateスタート・ガイド」

- 第2.7項「Oracle HTTP Server 11g WebGateのアンインストール」

- 第2.8項「Oracle HTTP Server 11g WebGateのサイレント・インストール」

注意:

Oracle HTTP Server 11g リリース2 WebGate for Oracle Access Managerと他のOracle Identity and Access Managementコンポーネントを統合するには、次に示すガイドのいずれかの指示に従ってください:

- Oracle Fusion Middleware Oracle Identity Management Suite統合ガイド

- Oracle Fusion Middleware Oracle Identity Managementエンタープライズ・デプロイメント・ガイド

2.1 Oracle HTTP Server 11g WebGateのインストールの概要

Oracle HTTP Server 11g WebGate for Oracle Access Managerをインストールするには、次の手順を実行します。

1. Oracle HTTP Server Webサーバーのインストール

2. Oracle HTTP Server 11g WebGate for Oracle Access Managerのインストール

3. インストール後の構成手順の実行

4. Oracle HTTP Server 11g WebGateのインストールの検証

5. 新規WebGateエージェントの登録

2.2 Oracle HTTP Server 11g WebGateのインストールの前提条件

この項では次のトピックについて説明します:

- Oracle Fusion Middlewareの動作保証

- JREのインストール

- Oracle HTTP Server 11g Webサーバーのインストールおよび構成

- Oracle Access Manager 11gのインストールおよび構成

- Windows 2003およびWindows 2008 64ビット・プラットフォームにおける64ビットOracle HTTP Server 11g WebGateの前提条件

2.2.1 Oracle Fusion Middlewareの動作要件

Oracle Fusion Middlewareサポート対象システム構成のドキュメントには、サポートされているインストール・タイプ、プラットフォーム、オペレーティング・システム、データベース、JDK、Oracle Identity and Access Management 11gリリース2 (11.1.2.1.0)に関連するサード・パーティ製品など、Oracle Fusion Middlewareの動作保証情報が記載されています。

『Oracle Fusion Middleware Supported System Configurations』ドキュメントにアクセスするには、Oracle Technology Network (OTN) Webサイトで検索してください。

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

2.2.2 JREのインストール

Java runtime environment (JRE) 1.6以上をインストールしておく必要があります。

2.2.3 Oracle HTTP Server 11g Webサーバーのインストールおよび構成

インストーラは、次の場所にあるOracle Technology Network (OTN)からダウンロードできます。

http://www.oracle.com/technology/software/products/middleware/htdocs/fmw_11_download.html

もしくは、最新のOracle Fusion Middleware 11gソフトウェアを次のWebサイトからダウンロードできます。

http://edelivery.oracle.com/

Oracle HTTP Server 11g (11.1.1.7.0)のインストールおよび構成については、『Oracle Fusion Middleware Oracle Web Tierインストレーション・ガイド』を参照してください。

注意:

Oracle HTTP Serverをインストールおよび構成すると、Oracle HTTP Serverの作業インスタンスがインスタンス・ホームに構成されます。

2.2.4 Oracle Access Manager 11gのインストールおよび構成

Oracle Access Manager (OAM)のインストールについては、『Oracle Fusion Middleware Oracle Identity and Access Managementインストレーション・ガイド』のOracle Identity and Access Management (11.1.2.1.0)のインストールおよび構成に関する項を参照してください。

新規または既存のWebLogic管理ドメインでのOracle Access Managerの構成については、『Oracle Fusion Middleware Oracle Identity and Access Managementインストレーション・ガイド』のOracle Access Managerの構成に関する項を参照してください。

さらに、Oracle Access ManagerをOPENモード、SIMPLEモードまたはCERTモードで構成する方法については、Oracle Fusion Middleware Oracle Access Manager管理者ガイドの通信の保護に関する項を参照してください。

2.2.5 Windows 2003およびWindows 2008 64ビット・プラットフォームにおける64ビットOracle HTTP Server 11g WebGateの前提条件

Windows 2003またはWindows 2008 64ビット・オペレーティング・システムを使用している場合、Oracle HTTP Server 11g WebGate for Oracle Access ManagerをホストしているマシンにMicrosoft Visual C++ 2005ライブラリをインストールする必要があります。

これらのライブラリはMicrosoft Visual C++ 2005 SP1 Redistributable Package (x64)に含まれています。次のWebサイトからダウンロードできます。

http://www.microsoft.com/DownLoads/details.aspx?familyid=EB4EBE2D-33C0-4A47-9DD4-B9A6D7BD44DA&displaylang=en

さらに、Microsoft Visual C++ 2005 Service Pack 1 Redistributable Package MFC Security Updateをインストールします。これは、次のWebサイトからダウンロードできます。

http://www.microsoft.com/downloads/en/details.aspx?familyid=fb01abe6-9099-4544-9aec-0ac13f19bc50&displaylang=en

2.3 Oracle HTTP Server 11g WebGateのインストール

この項では次のトピックについて説明します:

- ソフトウェアの入手

- Oracle HTTP Server 11g WebGateインストーラの起動

- Oracle HTTP Server 11g WebGateのインストール・フローおよび手順

2.3.1 ソフトウェアの入手

Oracle HTTP Server 11.1.2.1.0 WebGateソフトウェアの入手については、Oracle Fusion Middlewareのダウンロード、インストールおよび構成のReadMeを参照してください。

2.3.2 Oracle HTTP Server 11g WebGateインストーラの起動

Oracle HTTP Server 11g WebGate for Oracle Access ManagerのインストーラはWebGate.zipファイルに含まれています。

インストール・ウィザードを起動するには、次の手順を実行します。

- UNIXの場合

1. WebGate.zipファイルの内容をディレクトリに展開します。デフォルトでは、このディレクトリにはWebGateという名前が付けられています。

2. WebGateフォルダの下のDisk1ディレクトリに移動します。

3. 次のコマンドを実行します。
full_path_to_the_runInstaller_directory ./runInstaller -jreLoc WebTier_Home/jdk

- Windowsの場合

1. WebGate.zipファイルの内容をディレクトリに展開します。デフォルトでは、このディレクトリにはWebGateという名前が付けられています。

2. WebGateフォルダの下のDisk1ディレクトリに移動します。

3. 次のコマンドを実行します。
full_path_to_the_setup.exe_directory setup.exe -jreLoc WebTier_Home\jdk

注意:

Oracle HTTP Serverをインストールすると、WebTier_Homeディレクトリの下にjdkディレクトリが作成されます。インストーラを起動するときに、このJDKの中にあるJREフォルダの絶対パスを入力する必要があります。たとえば、Windowsで、JDKがD:\oracle\Oracle_WT1\jdkに存在する場合、次のようにしてインストーラをコマンド・プロンプトから起動します。

D:\setup.exe -jreLoc D:\oracle\Oracle_WT1\jdk

インストーラが起動したら、「ようこそ」画面が表示されます。第2.3.3項を参照してインストールを続行します。

2.3.3 Oracle HTTP Server 11g WebGateのインストール・フローおよび手順

Oracle HTTP Server 11g WebGate for Oracle Access Managerをインストールするには、表2-1の手順に従ってください。

インストール画面に関して詳細な情報が必要な場合は、「ヘルプ」をクリックしてオンライン・ヘルプを参照してください。

表2-1 インストール・フロー

番号

画面

説明と必要なアクション

1.

「ようこそ」画面

「次へ」をクリックして続行します。

2.

「前提条件のチェック」画面

「次へ」をクリックして続行します。

3.

「インストール場所の指定」画面

MiddlewareホームおよびOracleホームの場所を指定します。

ミドルウェア・ホームには、Oracle Web TierのOracleホームが含まれている必要があります。Oracle WebLogic ServerはOracle HTTP Server WebGateをインストールするための前提条件ではありません。ただし、Oracle Web TierのコンポーネントであるOracle HTTP Serverは、ミドルウェア・ホームのディレクトリ構造のみを必要とします。

これらのディレクトリの詳細は、『Oracle Fusion Middleware Oracle Identity and Access Managementインストレーション・プランニング・ガイド』のOracle Fusion Middlewareの概念とディレクトリ構造の理解に関する項を参照してください。

「次へ」をクリックして続行します。

4.

「インストール・サマリー」画面

この画面の情報を確認します。

「インストール」をクリックしてインストールを開始します。

5.

「インストールの進行状況」画面

UNIXシステムにインストールする場合、ORACLE_HOME/oracleRoot.shスクリプトを実行して適切なファイルおよびディレクトリ許可を設定するよう求められる可能性があります。

「次へ」をクリックして続行します。

6.

「インストール完了」画面

「終了」をクリックしてインストーラを終了します。

2.4 Oracle HTTP Server 11g WebGateのインストール後の手順

Oracle HTTP Server 11g WebGate for Oracle Access Managerをインストールした後、次の手順を実行する必要があります。

- UNIXの場合

1. 次のコマンドを実行して、WebGate_Home/WebGate/ohs/tools/deployWebGateディレクトリに移動します。
cd WebGate_Home/WebGate/ohs/tools/deployWebGate

2. 次のコマンドを実行し、エージェントの必要な部分をWebGate_HomeディレクトリからWebGate_Instanceの場所にコピーします。
./deployWebGateInstance.sh -w WebGate_Instance_Directory -oh WebGate_Oracle_Home

各項目の意味は次のとおりです。

- WebGate_Oracle_Homeは、Oracle HTTP Server Webgateをインストールし、WebGateのOracleホームとして作成したディレクトリです。
例:

MW_HOME/Oracle_OAMWebGate1

- WebGate_Instance_Directoryは、WebGateインスタンス・ホームの場所で、Oracle HTTP Serverのインスタンス・ホームと同じです。
例:

MW_HOME/Oracle_WT1/instances/instance1/config/OHS/ohs1

注意:

Oracle HTTP Serverのインスタンス・ホームは、Oracle HTTP Serverを構成した後に作成されます。この構成は、Oracle HTTP Server 11.1.1.7.0のインストール後、またはOracle HTTP Server 11.1.1.7.0のパッチ適用後に実行します。

3. 次のコマンドを実行し、LD_LIBRARY_PATH変数にOracle_Home_for_Oracle_HTTP_Server/libが含まれるようにします。
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:Oracle_Home_for_Oracle_HTTP_Server/lib

4. 現在の作業ディレクトリから1つ上のディレクトリに移動します。
WebGate_Home/WebGate/ohs/tools/setup/InstallTools

5. コマンドラインで次のコマンドを実行して、WebGate_HomeディレクトリからWebgateインスタンスの場所にapache_WebGate.templateをコピーし(名前がWebGate.confに変更されます)、httpd.confファイルを更新してWebGate.confの名前が含まれる1つの行を追加します。
./EditHttpConf -w WebGate_Instance_Directory [-oh WebGate_Oracle_Home] [-o output_file]

注意:

-oh WebGate_Oracle_Homeパラメータと-o output_fileパラメータはオプションです。

各項目の意味は次のとおりです。

- WebGate_Oracle_Homeは、Oracle HTTP Server WebGate for Oracle Access Managerをインストールし、WebGateのOracleホームとして作成したディレクトリです。
例:

MW_HOME/Oracle_OAMWebGate1

- WebGate_Instance_Directoryは、WebGateインスタンス・ホームの場所で、Oracle HTTP Serverのインスタンス・ホームでもあります。
例:

MW_HOME/Oracle_WT1/instances/instance1/config/OHS/ohs1

- output_fileは、ツールによって使用される一時出力ファイルの名前です。
例:

Edithttpconf.log

- Windowsの場合

1. WebGateのOracleホームの下にある次のディレクトリに移動します。
WebGate_Home\WebGate\ohs\tools\deployWebGate

2. 次のコマンドを実行し、エージェントの必要な部分をWebGate_HomeディレクトリからWebGate_Instanceの場所にコピーします。
deployWebGateInstance.bat -w WebGate_Instance_Directory -oh WebGate_Oracle_Home

各項目の意味は次のとおりです。

- WebGate_Oracle_Homeは、Oracle HTTP Server WebGate for Oracle Access Managerをインストールし、WebGateのOracleホームとして作成したディレクトリです。
例:

MW_HOME\Oracle_OAMWebGate1

- WebGate_Instance_Directoryは、WebGateインスタンス・ホームの場所で、Oracle HTTP Serverのインスタンス・ホームでもあります。
例:

MW_HOME\Oracle_WT1\instances\instance1\config\OHS\ohs1

注意:

Oracle HTTP Serverのインスタンス・ホームは、Oracle HTTP Serverを構成した後に作成されます。この構成は、Oracle HTTP Server 11.1.1.7.0のインストール後、またはOracle HTTP Server 11.1.1.7.0のパッチ適用後に実行します。

3. 次のコマンドを実行し、LD_LIBRARY_PATH変数にOracle_Home_for_Oracle_HTTP_Server/libが含まれるようにします。
WebGate_Installation_Directory\WebGate\ohs\libの場所およびOracle_Home_for_Oracle_HTTP_Server\binの場所をPATH環境変数で設定します。PATH環境変数のエントリの一番最後にセミコロン(;)を追加し、その後このパスを追加します。

4. 現在の作業ディレクトリから1つ上のディレクトリに移動します。
WebGate_Home\WebGate\ohs\tools\EditHttpConf

5. 次のコマンドを実行して、WebGate_HomeディレクトリからWebgateインスタンスの場所にapache_WebGate.templateをコピーし(名前がWebGate.confに変更されます)、httpd.confファイルを更新してWebGate.confの名前が含まれる1つの行を追加します。
EditHttpConf.exe -w WebGate_Instance_Directory [-oh WebGate_Oracle_Home] [-o output_file]

注意:

-oh WebGate_Oracle_Homeパラメータと-o output_fileパラメータはオプションです。

各項目の意味は次のとおりです。

- WebGate_Oracle_Homeは、Oracle HTTP Server WebGate for Oracle Access Managerをインストールし、WebGateのOracleホームとして作成したディレクトリです。
例:

MW_HOME\Oracle_OAMWebGate1

- WebGate_Instance_Directoryは、WebGateインスタンス・ホームの場所で、Oracle HTTP Serverのインスタンス・ホームでもあります。
例:

MW_HOME\Oracle_WT1\instances\instance1\config\OHS\ohs1

- output_fileは、ツールによって使用される一時出力ファイルの名前です。
例:

Edithttpconf.log

2.5 Oracle HTTP Server 11g WebGateのインストールおよび構成の検証

Oracle HTTP Server 11g WebGate for Oracle Access Managerをインストールしてインストール後の手順を完了したら、installDATE-TIME_STAMP.outログ・ファイルを調べてインストールを検証できます。ログのデフォルトの場所は次のとおりです。

- UNIXの場合
WebGate_Home/oraInst.loc

- Windowsの場合
C:\Program Files\Oracle\Inventory\logs

2.6 新規のOracle HTTP Server 11g WebGateスタート・ガイド

Oracle Access Manager向けに新規のOracle HTTP Server 11g WebGateエージェントを使用する前に、次のタスクを完了する必要があります。

1. 新規のOracle HTTP Server 11g WebGateの登録

2. 生成済のファイルおよびアーティファクトのOracle HTTP Server WebGateインスタンスの場所へのコピー

3. Oracle HTTP Serverインスタンスの再起動

2.6.1 新規のOracle HTTP Server 11g WebGateの登録

Oracle Access Manager管理コンソールを使用すると、Oracle Access Managerに新規のWebGateエージェントを登録できます。詳細は、『Oracle Fusion Middleware Oracle Access Management管理者ガイド』のコンソールを使用したOAMエージェントの登録に関する項を参照してください。

もしくは、RREGコマンドライン・ツールを使用して、新規WebGateエージェントを登録できます。このツールは、インバンドとアウトオブバンドという2つのモードで実行するように使用できます。

この項の内容は、次のとおりです。

- RREGツールの設定

- OAM11gRequest.xmlファイルの更新

- インバンド・モードの使用方法

- アウトオブバンド・モードの使用方法

- RREGによって生成されるファイルおよびアーティファクト

2.6.1.1 RREGツールの設定

RREGツールを設定するには、次の手順を実行します。

- UNIXの場合

1. Oracle Access Managerをインストールおよび構成した後、次のディレクトリに移動します。
Oracle_IDM2/oam/server/rreg/client

2. RREG.tar.gzファイルを解凍します。
例:

gunzip RREG.tar.gz

tar -xvf RREG.tar

エージェントを登録するためのツールは次の場所にあります。

RREG_Home/bin/oamreg.sh

注意:

RREG_Homeは、RREG.tar.gz/rregの内容を展開したディレクトリです。

- Windowsの場合

1. Oracle Access Managerをインストールおよび構成した後、次の場所に移動します。
Oracle_IDM2\oam\server\rreg\client

2. RREG.tar.zipファイルの内容を、選択した展開先に展開します。

エージェントを登録するためのツールは次の場所にあります。

RREG_Home\bin\oamreg.bat

注意:

RREG_Homeは、RREG.tar.gz/rregの内容を展開したディレクトリです。

UNIXではoamreg.shスクリプト、Windowsではoamreg.batスクリプトにある、次の環境変数を設定します。

- OAM_REG_HOME
この変数を、RREG.tar/rregの内容を展開したディレクトリへの絶対パスに設定します。

- JDK_HOME
この変数を、JavaまたはJDKがインストールされているマシン上のディレクトリへの絶対パスに設定します。

2.6.1.2 OAM11gRequest.xmlファイルの更新

RREG_Home\inputディレクトリ内(Windowsの場合)のOAM11GRequest.xmlファイルで、agentNameなどのエージェント・パラメータを更新する必要があります。UNIXでは、このファイルはRREG_Home/inputディレクトリ内にあります。

注意:

OAM11GRequest.xmlファイル、またはショート・バージョンOAM11GRequest_short.xmlは、テンプレートとして使用されます。このテンプレート・ファイルをコピーして使用できます。

OAM11GRequest.xmlファイルまたはOAM11GRequest_short.xmlファイル内の次の必須パラメータの値を変更します。

- serverAddress
OAM管理サーバーのホストとポートを指定します。

- agentName
エージェントのカスタム名を指定します。

- agentBaseUrl
Oracle HTTP Server 11g WebGateがインストールされているマシンのホストとポートを指定します。

- preferredHost
Oracle HTTP Server 11g WebGateがインストールされているマシンのホストとポートを指定します。

- security
インストールされているWebGateに基づいて、openなどのセキュリティ・モードを指定します。

- primaryServerList
Serverコンテナ要素の下にある、Oracle Access Managerプロキシに対する管理対象サーバーのホストとポートを指定します。

このファイルは、変更後に保存して閉じます。

2.6.1.3 インバンド・モードの使用方法

OAM11GRequest.xmlファイルのWebGateパラメータを更新した後、RREGツールを一度実行すると、WebGateが必要とするファイルおよびアーティファクトは、次のディレクトリに生成されます。

UNIXの場合:

RREG_Home/output/agent_name

Windowsの場合:

RREG_Home\output\agent_name

注意:

RREGは、クライアント・マシンとサーバーのいずれでも実行できます。サーバーで実行する場合、アーティファクトを元のクライアントに手動でコピーする必要があります。

次の手順を実行します。

1. OAM11GRequest.xmlファイルを開きます。このファイルは、UNIXではRREG_Home/input/、WindowsではRREG_Home\inputにあります。RREG_Homeは、RREG.tar.gz/rregの内容を展開したディレクトリです。
このXMLファイルを編集して、新規のOracle HTTP Server WebGate for Oracle Access Managerのパラメータを指定します。

2. 次のコマンドを実行します。
UNIXの場合:

./RREG_Home/bin/oamreg.sh inband input/OAM11GRequest.xml

Windowsの場合:

RREG_Home\bin\oamreg.bat inband input\OAM11GRequest.xml

2.6.1.4 アウトオブバンド・モードの使用方法

サーバーにアクセスできないエンド・ユーザーの場合、更新したOAM11GRequest.xmlファイルをシステム管理者に電子メールで送信し、アウトオブバンド・モードでRREGを実行してもらうことが可能です。生成されたAgentID_Response.xmlファイルをシステム管理者から受領し、このファイルに対してRREGを実行し、必要なWebGateファイルおよびアーティファクトを取得できます。

生成されたAgentID_Response.xmlファイルを管理者から受領した後、このファイルを手動でマシン上のinputディレクトリにコピーする必要があります。

- UNIXの場合
次の手順を実行します。

1. サーバーにアクセスできないエンド・ユーザーの場合は、OAM11GRequest.xmlファイルを開きます。このファイルは、RREG_Home/input/にあります。
RREG_Homeは、RREG.tar.gz/rregの内容を展開したディレクトリです。このXMLファイルを編集して、新規のOracle HTTP Server WebGate for Oracle Access Managerのパラメータを指定します。更新したファイルをシステム管理者に送信します。

2. 管理者は、更新されたOAM11GRequest.xmlファイルをコピーします。このファイルは、RREG_Home/input/ディレクトリにあります。
これは、エンド・ユーザーから受信したファイルです。管理者のRREG_Homeディレクトリに移動し、次のコマンドを実行します。

./RREG_Home/bin/oamreg.sh outofband input/OAM11GRequest.xml

Agent_ID_Response.xmlファイルが管理者のマシンのoutputディレクトリ(RREG_Home/output/ディレクトリ)に生成されます。更新済のOAM11GRequest.xmlファイルを最初に管理者に送信したエンド・ユーザーに、このファイルを送信します。

3. エンド・ユーザーは、生成されたAgent_ID_Response.xmlファイルをコピーします。このファイルは、RREG_Home/input/にあります。
これは、管理者から受信したファイルです。クライアントのRREGホーム・ディレクトリに移動し、コマンドラインで次のコマンドを実行します。

./RREG_Home/bin/oamreg.sh outofband input/Agent_ID_Response.xml

注意:

Oracle Fusion Middleware Oracle Access Manager管理者ガイドのコンソールを使用したOAMエージェントの登録に関する項で説明されているように、Oracle Access Manager管理コンソールを使用してWebGateエージェントを登録すると、登録後に生成されたファイルおよびアーティファクトを、サーバー(Oracle Access Manager管理コンソールが実行されているマシン)からクライアント・マシンに手動でコピーする必要があります。ファイルおよびアーティファクトはMW_HOME/user_projects/domains/name_of_the_WebLogic_domain_for_OAM/output/Agent_IDディレクトリに生成されます。

- Windowsの場合
次の手順を実行します。

1. サーバーにアクセスできないエンド・ユーザーの場合は、OAM11GRequest.xmlファイルを開きます。このファイルは、RREG_Home\input\ディレクトリにあります。
RREG_Homeは、RREG.tar.gz/rregの内容を展開したディレクトリです。このXMLファイルを編集して、新規のOracle HTTP Server WebGate for Oracle Access Managerのパラメータを指定し、更新されたファイルをシステム管理者に送信します。

2. 管理者は、更新されたOAM11GRequest.xmlファイルをコピーします。このファイルは、RREG_Home\input\にあります。これは、エンド・ユーザーから受信したファイルです。管理者のRREG_Homeディレクトリに移動し、次のコマンドを実行します。
RREG_Home\bin\oamreg.bat outofband input\OAM11GRequest.xml

Agent_ID_Response.xmlファイルが管理者のマシンのRREG_Home\output\ディレクトリに生成されます。更新済のOAM11GRequest.xmlファイルを最初に管理者に送信したエンド・ユーザーに、このファイルを送信します。

3. エンド・ユーザーは、生成されたAgent_ID_Response.xmlファイルをコピーします。このファイルは、RREG_Home/input/にあります。これは、管理者から受信したファイルです。クライアントのRREGホーム・ディレクトリに移動し、次のコマンドを実行します。
RREG_Home\bin\oamreg.bat outofband input\Agent_ID_Response.xml

注意:

Oracle Fusion Middleware Oracle Access Manager管理者ガイドのコンソールを使用したOAMエージェントの登録に関する項で説明されているように、Oracle Access Manager管理コンソールを使用してWebGateエージェントを登録すると、登録後に生成されたファイルおよびアーティファクトを、サーバー(Oracle Access Manager管理コンソールが実行されているマシン)からクライアント・マシンに手動でコピーする必要があります。ファイルおよびアーティファクトはMW_HOME/user_projects/domains/name_of_the_WebLogic_domain_for_OAM/output/Agent_IDディレクトリに生成されます。

2.6.1.5 RREGによって生成されるファイルおよびアーティファクト

新規WebGateエージェントの登録に使用する方法またはモードに関係なく、次のファイルおよびアーティファクトがRREG_Home/output/Agent_IDディレクトリに生成されます。

- cwallet.sso

- ObAccessClient.xml

- SIMPLEモードの場合、RREGによって次のものが生成されます。

- password.xml。SSLで使用される秘密鍵を暗号化するための不明瞭化されたグローバル・パスフレーズが含まれます。このパスフレーズは、サーバーで使用されているパスフレーズと同じものを使用できます。

- aaa_key.pem

- aaa_cert.pem

- CERTモードの場合、RREGによってpassword.xmlが生成されます。これには、SSLで使用される秘密鍵を暗号化するための不明瞭化されたグローバル・パスフレーズが含まれます。このパスフレーズは、サーバーで使用されているパスフレーズと異なるものを使用できます。

注意:

RREGによって生成されたこれらのファイルを使用して証明書リクエストを生成し、サードパーティの認証局に署名を求めることができます。既存の証明書をインストールするには、既存のaaa_cert.pemおよびaaa_chain.pemファイルをpassword.xmlおよびaaa_key.pemと合せて使用する必要があります。

2.6.2 生成済のファイルおよびアーティファクトのOracle HTTP Server WebGateインスタンスの場所へのコピー

RREGがこれらのファイルおよびアーティファクトを生成した後、使用しているセキュリティ・モードに基づき、手動でこれらをRREG_Home/output/Agent_IDディレクトリからWebGate_Instance_Homeディレクトリにコピーする必要があります。

使用しているセキュリティ・モードに従って、次の操作を行います。

- OPENモードの場合、次のファイルをRREG_Home/output/Agent_IDディレクトリからWebGate_Instance_Home/WebGate/configディレクトリにコピーします。

- ObAccessClient.xml

- cwallet.sso

- SIMPLEモードの場合、次のファイルをRREG_Home/output/Agent_IDディレクトリからWebGate_Instance_Home/WebGate/configディレクトリにコピーします。

- ObAccessClient.xml

- cwallet.sso

- password.xml

さらに、次のファイルをRREG_Home/output/Agent_IDディレクトリからWebGate_Instance_Home/WebGate/config/simpleディレクトリにコピーします。

- aaa_key.pem

- aaa_cert.pem

- CERTモードの場合、次のファイルをRREG_Home/output/Agent_IDディレクトリからWebGate_Instance_Home/WebGate/configディレクトリにコピーします。

- ObAccessClient.xml

- cwallet.sso

- password.xml

新規証明書の生成

次の手順で、新規証明書を生成します。

1. WebGate_Home/WebGate/ohs/tools/opensslディレクトリに移動します。

2. 次のようにして、証明書リクエストを作成します。
./openssl req -utf8 -new -nodes -config openssl_silent_ohs11g.cnf -keyout aaa_key.pem -out aaa_req.pem -rand WebGate_Home/WebGate/ohs/config/random-seed

3. 次のようにして、証明書を自己署名します。
./openssl ca -config openssl_silent_ohs11g.cnf -policy policy_anything -batch -out aaa_cert.pem -infiles aaa_req.pem

4. 次の生成された証明書をWebGate_Instance_Home/WebGate/configディレクトリにコピーします。

- aaa_key.pem

- aaa_cert.pem

- simpleCAディレクトリ内のcacert.pem

注意:

cacert.pemファイルをコピーした後、ファイルの名前をaaa_chain.pemに変更する必要があります。

既存の証明書の移行

既存の証明書(aaa_key.pem、aaa_cert.pemおよびaaa_chain.pem)を移行する場合、aaa_key.pemを暗号化する際に使用したものと同じパスフレーズを使用してください。同じパスフレーズをRREG登録処理中に入力する必要があります。同じパスフレーズを使用しないと、RREGによって生成されたpassword.xmlファイルが、鍵の暗号化に使用されたパスフレーズと一致しません。

同じパスフレーズを入力したら、これらの証明書を次のようにコピーできます。

1. WebGate_Instance_Home/WebGate/configディレクトリに移動します。

2. 次の証明書をWebGate_Instance_Home/WebGate/configディレクトリにコピーします。

- aaa_key.pem

- aaa_cert.pem

- aaa_chain.pem

2.6.3 Oracle HTTP Serverインスタンスの再起動

Oracle Process Manager and Notification Server (OPMN)コマンドライン・ツールを使用して、Oracle HTTP Serverインスタンスを起動または終了できます。インスタンスが実行中の場合、コマンドラインで次のコマンドを実行し、すべての実行中インスタンスを終了します。

Oracle_Home_for_Oracle_HTTP_Server/opmn/bin/opmnctl stopall

Oracle HTTP Serverインスタンスを再起動するには、コマンドラインで次のコマンドを実行します。

1. Oracle_Home_for_Oracle_HTTP_Server/opmn/bin/opmnctl start

2. Oracle_Home_for_Oracle_HTTP_Server/opmn/bin/opmnctl startproc ias-component=Oracle_HTTP_Server_Instance_Name

2.7 Oracle HTTP Server 11g WebGateのアンインストール

Oracle HTTP Server 11.1.2.1.0 WebGates for Oracle Access Managerを削除するときは、この項で説明する手順に必ず従ってください。ソフトウェアを手動で削除すると、後でソフトウェアを再インストールする際に問題が発生する可能性があります。この項の手順に従うことで、ソフトウェアを正しく削除できます。

WebGateエージェントをアンインストールするには、次の作業を実行します。

1. MW_HOME/Webgate_Home/oui/binディレクトリ(UNIXの場合)またはMW_HOME\Webgate_home\oui\bin (Windowsの場合)に移動します。

2. 次のコマンドを実行します。
UNIXの場合: ./runInstaller -deinstall

Windowsの場合: setup.exe -deinstall -jreLoc JRE_LOCATION

JRE_LOCATIONへの絶対パスを指定してください。相対パスはサポートされていません。

アンインストーラが起動したら、「ようこそ」画面が表示されます。第2.7.1項を参照してアンインストールを続行します。

2.7.1 アンインストールの画面と手順

表2-2の指示に従って、アンインストールを完了します。

アンインストール画面の詳細なヘルプが必要な場合は、「ヘルプ」をクリックしてオンライン・ヘルプにアクセスします。

表2-2 アンインストールのフロー

Sl. 番号

画面

説明

必要なアクション

1.

ようこそ

アンインストーラが起動するたびに、「ようこそ」画面が表示されます。

「次へ」をクリックします。

2.

Oracleホームのアンインストール

「Oracleホームのアンインストール」画面に、アンインストールするOracleホームが表示されます。

アンインストール対象のOracleホームが正しいことを確認します。

「アンインストール」をクリックします。

「警告」画面で、アンインストーラを使用してソフトウェアを削除するだけでなく、Oracleホーム・ディレクトリを削除するかどうかを選択します。

アンインストーラを使用してソフトウェアおよびOracleホームを削除するには「はい」、ソフトウェアのみを削除するには「いいえ」、前の画面に戻るには「取消」をクリックします。

「いいえ」を選択した場合、Oracleホーム・ディレクトリを手動で削除する手順は、第2.7.2項を参照してください。

3.

アンインストールの進行状況

「アンインストールの進行状況」画面には、アンインストールの進捗状況およびステータスが表示されます。

「アンインストール完了」画面が表示されるまで待ちます。

4.

アンインストール完了

アンインストールが完了すると、「アンインストール完了」画面が表示されます。

「終了」をクリックして画面を終了します。

2.7.2 Oracleホーム・ディレクトリの手動削除

アンインストール中に警告画面で「いいえ」 を選択した場合は、Webgate_Homeディレクトリとすべてのサブディレクトリを手動で削除する必要があります。たとえば、Oracle WebGateホーム・ディレクトリが/home/Oracle/Middleware/Oracle_OAMWebGate1だった場合は、次のコマンドを実行します。

cd /home/Oracle/Middleware/

rm -rf Oracle_OAMWebGate1

Windowsで、Oracle共通ホーム・ディレクトリがC:\Oracle\Middleware\Oracle_OAMWebGate1の場合は、ファイル・マネージャ・ウィンドウを使用してC:\Oracle\Middlewareディレクトリに移動し、Oracle_OAMWebGate1フォルダを右クリックして「削除」を選択します。

2.8 Oracle HTTP Server 11g WebGateのサイレント・インストール

Oracle HTTP Server 11g WebGateをサイレント・モードで実行するには、次の手順を実行します。

1. silent.rspファイルの内容を設定します。例:

[ENGINE]
#DO NOT CHANGE THIS.
Response File Version=1.0.0.0.0
[GENERIC]
ORACLE_HOME=/home/MW_HOME/ohs_Webgate_home
MIDDLEWARE_HOME=/home/MW_HOME
[SYSTEM]
[APPLICATIONS]
[RELATIONSHIPS]

前述のファイルでは、パラメータは次のとおりです。

- ORACLE_HOME: Oracleホームの場所を指定します。これは、新規のOracle HTTP Server WebGateのインストール先とするディレクトリです。この場所は、指定されたMiddlewareホームの場所の直下にあるフォルダである必要があります。Oracleホームのディレクトリ名に含めることができる文字は、英数字、ハイフン(-)、ドット(.)およびアンダースコア(_)のみです。ただし、最初の文字は英数字にする必要があります。長さの合計は128文字以下にする必要があります。たとえば、home/middleware/ohs_webgateのようにします。

- MIDDLEWARE_HOME: Middlewareホーム・ディレクトリのフルパスを指定します。

2. インストーラの内容をディレクトリに展開します。

3. 次のコマンドを実行します。
WebGate_Installer_Directory/Disk1/runInstaller -jreLoc jre_location -invPtrLoc Absolute_Path_Of_the_oraInst.loc_file -silent -response Absolute_Path_Of_the_silent.rsp_file

このコマンドの内容は次のとおりです。

- WebGate_Installer_Directoryは、WebGateインストーラの内容を展開したディレクトリへの絶対パスです。

- jre_locationは、JREディレクトリへの絶対パスです。

- Absolute_Path_Of_the_oraInst.loc_fileは、oraInst.locファイルへの絶対パスです。

- Absolute_Path_Of_the_ silent.rsp_fileは、作成したsilent.rspファイルへの絶対パスです。

3 IHS 11g WebGate for OAMのインストールおよび構成

この章では、IBM HTTP Server (IHS) 11g リリース2 WebGate for Oracle Access Managerをインストールおよび構成する方法を説明します。

この章は次の項で構成されています:

- 第3.1項「IHS 11g WebGateのインストールの概要」

- 第3.2項「IHS 11g WebGateのインストールの前提条件」

- 第3.3項「IHS 11g WebGateのインストール」

- 第3.4項「IHS 11g WebGateのインストール後の手順」

- 第3.5項「IHS 11g WebGateのインストールおよび構成の検証」

- 第3.6項「新規のIHS 11g WebGateスタート・ガイド」

- 第3.7項「IHS Webサーバーの起動およびIHSリソースへのアクセス」

- 第3.8項「IHS 11g Webgateのアンインストール」

- 第3.9項「IHS 11g WebGateのサイレント・インストール」

3.1 IHS 11g WebGateのインストールの概要

IHS 11g WebGate for Oracle Access Managerをインストールするには、次の手順を実行します。

1. IHS Webサーバーのインストール

2. IHS 11g WebGate for Oracle Access Managerのインストール

3. インストール後の構成手順の実行

4. IHS 11g WebGateのインストールの検証

5. 新規WebGateエージェントの登録

3.2 IHS 11g WebGateのインストールの前提条件

このセクションのトピックは次のとおりです:

- Oracle Fusion Middlewareの動作保証

- JREのインストール

- IHSのインストールおよび構成

- OAM 11gのインストールおよび構成

3.2.1 Oracle Fusion Middlewareの動作保証

Oracle Fusion Middlewareサポート対象システム構成のドキュメントには、サポートされているインストール・タイプ、プラットフォーム、オペレーティング・システム、データベース、JDK、Oracle Identity and Access Management 11gリリース2 (11.1.2.1.0)に関連するサード・パーティ製品など、Oracle Fusion Middlewareの動作保証情報が記載されています。

Oracle Fusion Middlewareでサポートされるシステム構成に関するドキュメントには、次の場所でアクセスできます。

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

3.2.2 JREのインストール

Java runtime environment (JRE) 1.6以上をインストールしておく必要があります。

64ビットLinuxプラットフォームまたはOracle Enterprise Linux (OEL) 6にインストールしている場合は、32ビットJREが搭載されていることを確認してください。

AIXシステムにIHSをインストールしている場合は、64ビットJREが搭載されていることを確認してください。

3.2.3 IHSのインストールおよび構成

IHSのインストールおよび構成については、IBM HTTP Serverの製品ドキュメントを参照してください。

3.2.4 OAM 11gのインストールおよび構成

Oracle Access Manager (OAM)のインストールについては、『Oracle Fusion Middleware Oracle Identity and Access Managementインストレーション・ガイド』のOracle Identity and Access Management (11.1.2.1.0)のインストールおよび構成に関する項を参照してください。

新規または既存のWebLogic管理ドメインでのOracle Access Managerの構成については、『Oracle Fusion Middleware Oracle Identity and Access Managementインストレーション・ガイド』のOracle Access Managerの構成に関する項を参照してください。

さらに、Oracle Access ManagerをOPENモード、SIMPLEモードまたはCERTモードで構成する方法については、『Oracle Fusion Middleware Oracle Access Management管理者ガイド』の通信の保護に関する項を参照してください。

3.2.5 64ビット・オペレーティング・システムでの32ビットIHS WebGateのインストール

IHS WebGateの32ビットLinux版は、32ビットJDKが搭載されているほとんどの64ビットLinuxプラットフォームにインストールできます。どのプラットフォームがサポートされているかを確認するには、Oracle Fusion Middleware Oracle Fusion Middlewareのシステム要件と仕様 11gリリース2 (11.1.2)を参照してください。このドキュメントは次のページで入手できます。

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-certification-100350.html

詳細は、Oracle Fusion Middlewareのシステム要件とサポート対象プラットフォーム 11gリリース2 (11.1.2)を参照してください。このドキュメントは次のページで入手できます。

http://www.oracle.com/technetwork/middleware/ias/downloads/fusion-requirements-100147.html

3.3 IHS 11g WebGateのインストール

この項の内容は、次のとおりです。

- ソフトウェアの入手

- IHS 11g WebGateインストーラの起動

- インストール・フローおよび手順

3.3.1 ソフトウェアの入手

IHS 11g WebGateソフトウェアの入手については、Oracle Fusion Middlewareのダウンロード、インストールおよび構成のReadMeを参照してください。

3.3.2 IHS 11g WebGateインストーラの起動

インストール・ウィザードを起動するには、次の作業を実行します。

1. インストーラの内容を展開したディレクトリに移動します。

2. 次の場所に移動します。
cd Disk1

3. 次のコマンドを実行します。

- Linux 32ビット・システムおよびAIXシステムの場合
./runInstaller

- Linux 64ビット・システムの場合
linux32 bash ./runInstaller

- Oracle Enterprise Linux (OEL) 6システムの場合
linux32 bash ./runInstaller -jreLoc JRE_Location

このインストーラは、Webgate_ihs/Disk1ディレクトリから起動するようにしてください。

4. JRE/JDKの場所を指定するように求められたら指定します。64ビットのLinuxプラットフォームにインストールする場合は、32ビットのJRE/JDKへの完全なパスを指定してください。AIXシステムにインストールする場合は、64ビットのJRE/JDKディレクトリへの完全なパスを指定します。

インストーラが起動したら、「ようこそ」画面が表示されます。第3.3.3項を参照してインストールを続行します。

3.3.3 インストール・フローおよび手順

IHS 11g WebGate for Oracle Access Managerをインストールするには、表3-1の手順に従ってください。

インストール画面に関して詳細な情報が必要な場合は、「ヘルプ」をクリックしてオンライン・ヘルプを参照してください。

表3-1 IHS WebGateのインストール・フロー

番号

画面

説明と必要なアクション

1.

「ようこそ」画面

「次へ」をクリックして続行します。

2.

「前提条件のチェック」画面

「次へ」をクリックして続行します。

3.

「インストール場所の指定」画面

MiddlewareホームおよびOracleホームの場所を指定します。

これらのディレクトリの詳細は、『Oracle Fusion Middleware Oracle Identity and Access Managementインストレーション・プランニング・ガイド』のOracle Fusion Middlewareの概念とディレクトリ構造の理解に関する項を参照してください。

「次へ」をクリックして続行します。

4.

「インストール・サマリー」画面

この画面の情報を確認します。

「インストール」をクリックしてインストールを開始します。

5.

「インストールの進行状況」画面

「次へ」をクリックして続行します。

6.

「インストール完了」画面

「終了」をクリックしてインストーラを終了します。

3.4 IHS 11g WebGateのインストール後の手順

この項の内容は次のとおりです。

- IHS WebGateインスタンスのデプロイ

- 環境変数の設定

- EditHttpConfツールの実行

3.4.1 IHS WebGateインスタンスのデプロイ

WebGateのOracleホーム・ディレクトリにあるdeployWebGateInstance.shツールを使用して、IHS WebGateインスタンスを作成します。作成している、または提供したWebGateインスタンス・ディレクトリは、空である必要があります。

WebGateインスタンスをデプロイするには、次の作業を実行します。

1. 次のコマンドを実行して、WebGate_Oracle_Home/WebGate/ihs/tools/deployWebGateディレクトリに移動します。
cd WebGate_Oracle_Home/WebGate/ihs/tools/deployWebGate

2. 次のコマンドを実行します。
./deployWebGateInstance -w WebGate_Instancedir -oh WebGate_Oracle_Home -ws WebServer

このコマンドの内容は次のとおりです。

- WebGate_Instancedirは、新規のWebGateインスタンスの作成先とするディレクトリです。

- WebGate_Oracle_Homeは、IHS 11g WebGateのインストール時に指定したWebGateのOracleホーム・ディレクトリです。

- WebServerはIHSです。

例:

./deployWebGateInstance -w /home/wg_instance4ihs/ -oh /home/Oracle_OAMWebGate1/ -ws ihs

3.4.2 環境変数の設定

Linuxでは環境変数LD_LIBRARY_PATHを、AIXでは環境変数LIBPATHを、WebGate_Oracle_Home/webgate/ihs/libに設定します。

例:

Linuxの場合

export LD_LIBRARY_PATH=/home/Oracle_OAMWebGate1/webgate/ihs/lib

AIXの場合

export LIBPATH=/home/Oracle_OAMWebGate1/webgate/ihs/lib

3.4.3 EditHttpConfツールの実行

EditHttpConfツールを実行するには、次の操作を行います。

1. 次のコマンドを実行して、WebGate_Oracle_Home/Webgate/ihs/tools/setup/InstallToolsディレクトリに移動します。
cd WebGate_Oracle_Home/Webgate/ihs/tools/setup/InstallTools

2. 次のコマンドを実行します。
./EditHttpConf -f path_to_webserver_config_file -w WebGate_Instance_Dir -oh WebGate_Oracle_Home -ws WebServer

このコマンドの内容は次のとおりです。

- path_to_webserver_config_file is the full path of the IHS instance httpd.conf file.

- WebGate_Instance_Dirは、新規のWebGateインスタンスの作成先となっているディレクトリです。

- WebGate_Oracle_Homeは、Oracleホームのフルパスです。

- WebServerはIHSです。

注意:

-ohパラメータの指定は任意であり、指定しないでこのコマンドを実行してもエラーは発生しません。

例:

cd /home/OAMWebGate1/WebGate/ihs/tools/setup/InstallTools/

./EditHttpConf -f /home/instanceHome1/net-test_ihs1/config/test_httpd.conf -oh /home/Oracle_OAMWebGate1/ -w /home/Oracle_OAMWebGate1/wg_instance4ihs/ -ws ihs

3.5 IHS 11g WebGateのインストールおよび構成の検証

IHS 11g WebGate for Oracle Access Managerをインストールしたら、installDATE-TIME_STAMP.outログ・ファイルを調べてインストールを検証できます。ログのデフォルトの場所は、次のファイルの中です。

WebGate_Home/oraInst.loc

3.6 新規のIHS 11g WebGateスタート・ガイド

Oracle Access Manager向けに新規のIHS 11g WebGateエージェントを使用する前に、次のタスクを完了する必要があります。

1. 新規のIHS 11g WebGateの登録

2. 生成済のファイルおよびアーティファクトのIHS WebGateインスタンスの場所へのコピー

3.6.1 新規のIHS 11g WebGateの登録

Oracle Access Manager管理コンソールを使用すると、Oracle Access Managerに新規のWebGateエージェントを登録できます。詳細は、『Oracle Fusion Middleware Oracle Access Management管理者ガイド』のコンソールを使用したOAMエージェントの登録に関する項を参照してください。

もしくは、RREGコマンドライン・ツールを使用して、新規WebGateエージェントを登録できます。このツールは、インバンドとアウトオブバンドという2つのモードで実行できます。

この項の内容は、次のとおりです。

- RREGツールの設定

- OAM11gRequest.xmlファイルの更新

- インバンド・モードの使用方法

- アウトオブバンド・モードの使用方法

- RREGによって生成されるファイルおよびアーティファクト

3.6.1.1 RREGツールの設定

RREGツールを設定するには、次の手順を実行します。

1. Oracle Access Managerをインストールおよび構成した後、次のディレクトリに移動します。
Oracle_IDM2/oam/server/rreg/client

2. RREG.tar.gzファイルを解凍します。
例:

gunzip RREG.tar.gz

tar -xvf RREG.tar

エージェントを登録するためのツールは次の場所にあります。

RREG_Home/bin/oamreg.sh

注意:

RREG_Homeは、RREG.tar.gz/rregの内容を展開したディレクトリです。

oamreg.shスクリプトの次の環境変数を設定します。

- OAM_REG_HOME
この変数を、RREG.tar/rregの内容を展開したディレクトリへの絶対パスに設定します。

- JDK_HOME
この変数を、JavaまたはJDKがインストールされているマシン上のディレクトリへの絶対パスに設定します。

3.6.1.2 OAM11gRequest.xmlファイルの更新

RREG_Home/inputディレクトリ内にあるOAM11GRequest.xmlファイルで、agentNameなどのエージェント・パラメータを更新する必要があります。

注意:

OAM11GRequest.xmlファイル、またはショート・バージョンOAM11GRequest_short.xmlは、テンプレートとして使用されます。このテンプレート・ファイルをコピーして使用できます。

OAM11GRequest.xmlファイルまたはOAM11GRequest_short.xmlファイル内の次の必須パラメータの値を変更します。

- serverAddress
OAM管理サーバーのホストとポートを指定します。

- agentName
エージェントのカスタム名を指定します。

- agentBaseUrl
IHS 11g WebGateがインストールされているマシンのホストとポートを指定します。

- preferredHost
IHS 11g WebGateがインストールされているマシンのホストとポートを指定します。

- security
インストールされているWebGateに基づいて、openなどのセキュリティ・モードを指定します。

- primaryServerList
Serverコンテナ要素の下にある、Oracle Access Managerプロキシに対する管理対象サーバーのホストとポートを指定します。

このファイルは、変更後に保存して閉じます。

3.6.1.3 インバンド・モードの使用方法

OAM11GRequest.xmlファイルのWebGateパラメータを更新した後、RREGツールを一度実行すると、WebGateが必要とするファイルおよびアーティファクトは、次のディレクトリに生成されます。

RREG_Home/output/agent_name

注意:

RREGは、クライアント・マシンとサーバーのいずれでも実行できます。サーバーで実行する場合、アーティファクトを元のクライアントに手動でコピーする必要があります。

次の手順を実行します。

1. OAM11GRequest.xmlファイルを開きます。このファイルは、RREG_Home/input/ディレクトリにあります。RREG_Homeは、RREG.tar.gz/rregの内容を展開したディレクトリです。
このXMLファイルを編集して、新規のIHS WebGate for Oracle Access Managerのパラメータを入力します。

2. 次のコマンドを実行します。
./RREG_Home/bin/oamreg.sh inband input/OAM11GRequest.xml

3.6.1.4 アウトオブバンド・モードの使用方法

サーバーにアクセスできないエンドユーザーの場合、更新したOAM11GRequest.xmlファイルをシステム管理者に電子メールで送信し、アウトオブバンド・モードでRREGを実行してもらうことが可能です。生成されたAgentID_Response.xmlファイルをシステム管理者から受領し、このファイルに対してRREGを実行し、必要なWebGateファイルおよびアーティファクトを取得できます。

生成されたAgentID_Response.xmlファイルを管理者から受領した後、このファイルを手動でマシン上のinputディレクトリにコピーする必要があります。

次の手順を実行します。

1. サーバーにアクセスできないエンドユーザーの場合は、OAM11GRequest.xmlファイルを開きます。このファイルは、RREG_Home/input/にあります。
RREG_Homeは、RREG.tar.gz/rregの内容を展開したディレクトリです。このXMLファイルを編集して、新規のIHS WebGate for Oracle Access Managerのパラメータを指定し、更新されたファイルをシステム管理者に送信します。

2. 管理者は、更新されたOAM11GRequest.xmlファイルをコピーします。このファイルは、RREG_Home/input/ディレクトリにあります。
これは、エンドユーザーから受信したファイルです。管理者のRREG_Homeディレクトリに移動し、次のコマンドを実行します。

./RREG_Home/bin/oamreg.sh outofband input/OAM11GRequest.xml

Agent_ID_Response.xmlファイルが管理者のマシンのoutputディレクトリ(RREG_Home/output/ディレクトリ)に生成されます。更新済のOAM11GRequest.xmlファイルを最初に管理者に送信したエンドユーザーに、このファイルを送信します。

3. エンドユーザーは、生成されたAgent_ID_Response.xmlファイルをコピーします。このファイルは、RREG_Home/input/ディレクトリにあります。
これは、管理者から受信したファイルです。クライアントのRREGホーム・ディレクトリに移動し、次のコマンドを実行します。

./RREG_Home/bin/oamreg.sh outofband input/Agent_ID_Response.xml

注意:

『Oracle Fusion Middleware Oracle Access Management管理者ガイド』のコンソールを使用したOAMエージェントの登録に関する項で説明されているように、Oracle Access Manager管理コンソールを使用して新規のWebGateエージェントを登録すると、登録後に生成されたファイルおよびアーティファクトを、サーバー(Oracle Access Manager管理コンソールが実行されているマシン)からクライアント・マシンに手動でコピーする必要があります。ファイルおよびアーティファクトはMW_HOME/user_projects/domains/name_of_the_WebLogic_domain_for_OAM/output/Agent_IDディレクトリに生成されます。

3.6.1.5 RREGによって生成されるファイルおよびアーティファクト

新規WebGateエージェントの登録に使用する方法またはモードに関係なく、次のファイルおよびアーティファクトがRREG_Home/output/Agent_IDディレクトリに生成されます。

- cwallet.sso

- ObAccessClient.xml

- SIMPLEモードの場合、RREGによって次のものが生成されます。

- password.xml。SSLで使用される秘密鍵を暗号化するための不明瞭化されたグローバル・パスフレーズが含まれます。このパスフレーズは、サーバーで使用されているパスフレーズと同じものを使用できます。

- aaa_key.pem

- aaa_cert.pem

- CERTモードの場合、RREGによってpassword.xmlが生成されます。これには、SSLで使用される秘密鍵を暗号化するための不明瞭化されたグローバル・パスフレーズが含まれます。このパスフレーズは、サーバーで使用されているパスフレーズと異なるものを使用できます。

注意:

RREGによって生成されたこれらのファイルを使用して証明書リクエストを生成し、サードパーティの認証局に署名を求めることができます。既存の証明書をインストールするには、既存のaaa_cert.pemおよびaaa_chain.pemファイルをpassword.xmlおよびaaa_key.pemと合せて使用する必要があります。

3.6.2 生成済のファイルおよびアーティファクトのIHS WebGateインスタンスの場所へのコピー

RREGがこれらのファイルおよびアーティファクトを生成した後、使用しているセキュリティ・モードに基づき、手動でこれらをRREG_Home/output/Agent_IDディレクトリからWebGate_Instance_Homeディレクトリにコピーする必要があります。

使用しているセキュリティ・モードに従って、次の操作を行います。

- OPENモードの場合、次のファイルをRREG_Home/output/Agent_IDディレクトリからWebGate_Instance_Home/WebGate/configディレクトリにコピーします。

- ObAccessClient.xml

- cwallet.sso

- SIMPLEモードの場合、次のファイルをRREG_Home/output/Agent_IDディレクトリからWebGate_Instance_Home/WebGate/configディレクトリにコピーします。

- ObAccessClient.xml

- cwallet.sso

- password.xml

さらに、次のファイルをRREG_Home/output/Agent_IDディレクトリからWebGate_Instance_Home/WebGate/config/simpleディレクトリにコピーします。

- aaa_key.pem

- aaa_cert.pem

- CERTモードの場合、次のファイルをRREG_Home/output/Agent_IDディレクトリからWebGate_Instance_Home/WebGate/configディレクトリにコピーします。

- ObAccessClient.xml

- cwallet.sso

- password.xml

新規証明書の生成

次の手順で、新規証明書を生成します。

1. WebGate_Home/WebGate/ihs/tools/opensslディレクトリに移動します。

2. 次のようにして、証明書リクエストを作成します。
./openssl req -utf8 -new -nodes -config openssl_silent_ihs11g.cnf -keyout aaa_key.pem -out aaa_req.pem -rand WebGate_Home/WebGate/ihs/config/random-seed

3. 次のようにして、証明書を自己署名します。
./openssl ca -config openssl_silent_ihs11g.cnf -policy policy_anything -batch -out aaa_cert.pem -infiles aaa_req.pem

4. 次の生成された証明書をWebGate_Instance_Home/WebGate/configディレクトリにコピーします。

- aaa_key.pem

- aaa_cert.pem

- simpleCAディレクトリ内のcacert.pem

注意:

cacert.pemファイルをコピーした後、ファイルの名前をaaa_chain.pemに変更する必要があります。

既存の証明書の移行

既存の証明書(aaa_key.pem、aaa_cert.pemおよびaaa_chain.pem)を移行する場合、aaa_key.pemを暗号化する際に使用したものと同じパスフレーズを使用してください。同じパスフレーズをRREG登録処理中に入力する必要があります。同じパスフレーズを使用しないと、RREGによって生成されたpassword.xmlファイルが、鍵の暗号化に使用されたパスフレーズと一致しません。

同じパスフレーズを入力したら、これらの証明書を次のようにコピーできます。

1. WebGate_Instance_Home/WebGate/configディレクトリに移動します。

2. 次の証明書をWebGate_Instance_Home/WebGate/configディレクトリにコピーします。

- aaa_key.pem

- aaa_cert.pem

- aaa_chain.pem

3.7 IHS Webサーバーの起動およびIHSリソースへのアクセス

このWebサーバーを起動する前に、第3.4.2項で指定されているように、環境変数を設定しておいてください。

IHS Webサーバーを起動する手順は次のとおりです。

- Linuxの場合
次のコマンドを実行します。

/IBM/HTTPServer/bin/apachectl -k start

- AIXの場合

1. /IHS/HTTPServer/conf/httpd.confにあるhttpd.confファイルに移動し、テキスト・エディタで開いて次のものを追加します。
ThreadStackSize 2097152

2. 次のコマンドを実行します。
/IBM/HTTPServer/bin/apachectl -k start

IHS Webサーバーを起動したら、次のURLを使用してログインします。

http://machine_name.my.company.com:port

WebGateにより、リクエストが捕捉され、ユーザーがOracle Access Managerコンソールにリダイレクトされます。ユーザー名とパスワードを入力します。そうすると、IBM HTTP Serverにリダイレクトされます。

3.8 IHS 11g Webgateのアンインストール

IHS 11g WebGateを削除するときは、この項で説明する手順に必ず従ってください。ソフトウェアを手動で削除すると、後でソフトウェアを再インストールする際に問題が発生する可能性があります。この章の手順に従うことで、ソフトウェアを正しく削除できます。

IHS WebGateをアンインストールするには、次の作業を実行します。

1. MW_HOME/Webgate_Home/oui/binディレクトリに移動します。

2. 次のコマンドを実行します。
./runInstaller -deinstall

インストーラが起動したら、「ようこそ」画面が表示されます。第3.8.1項を参照してアンインストールを続行します。

3.8.1 アンインストールの画面と手順

表3-2の手順に従って、IHS 11g WebGateをアンインストールしてください。

アンインストール画面の詳細なヘルプが必要な場合は、「ヘルプ」をクリックしてオンライン・ヘルプにアクセスします。

表3-2 アンインストールのフロー

Sl. 番号

画面

説明

必要なアクション

1.

ようこそ

アンインストーラが起動するたびに、「ようこそ」画面が表示されます。

「次へ」をクリックします。

2.

Oracleホームのアンインストール

「Oracleホームのアンインストール」画面に、アンインストールするOracleホームが表示されます。

アンインストール対象のOracleホームが正しいことを確認します。

「アンインストール」をクリックします。

「警告」画面で、アンインストーラでソフトウェアの削除のみでなく、Oracleホーム・ディレクトリも削除するかどうかを選択します。

アンインストーラを使用してソフトウェアおよびOracleホームを削除するには「はい」、ソフトウェアのみを削除するには「いいえ」、前の画面に戻るには「取消」をクリックします。

「いいえ」を選択した場合、Oracleホーム・ディレクトリを手動で削除する手順は、第3.8.2項を参照してください。

3.

アンインストールの進行状況

「アンインストールの進行状況」画面には、アンインストールの進捗状況およびステータスが表示されます。

「アンインストール完了」画面が表示されるまで待ちます。

4.

アンインストール完了

アンインストールが完了すると、「アンインストール完了」画面が表示されます。

「終了」をクリックして画面を終了します。

3.8.2 Oracleホーム・ディレクトリの手動削除

アンインストール中に警告画面で「いいえ」 を選択した場合は、Webgate_Homeディレクトリとすべてのサブディレクトリを手動で削除する必要があります。たとえば、Oracle WebGateホーム・ディレクトリが/home/Oracle/Middleware/Oracle_OAMWebGate1だった場合は、次のコマンドを実行します。

cd /home/Oracle/Middleware/

rm -rf Oracle_OAMWebGate1

3.9 IHS 11g WebGateのサイレント・インストール

IHS 11g WebGateをサイレント・モードで実行するには、次の手順を実行します。

1. silent.rspファイルの内容を設定します。例:

[ENGINE]
#DO NOT CHANGE THIS.
Response File Version=1.0.0.0.0
[GENERIC]
ORACLE_HOME=/home/MW_HOME/ihs_Webgate_home
MIDDLEWARE_HOME=/home/MW_HOME
[SYSTEM]
[APPLICATIONS]
[RELATIONSHIPS]

前述のファイルでは、パラメータは次のとおりです。

- ORACLE_HOME: Oracleホームの場所を指定します。これは、新規のIHS WebGateのインストール先とするディレクトリです。この場所は、指定されたMiddlewareホームの場所の直下にあるフォルダである必要があります。Oracleホームのディレクトリ名に含めることができる文字は、英数字、ハイフン(-)、ドット(.)およびアンダースコア(_)のみです。ただし、最初の文字は英数字にする必要があります。長さの合計は128文字以下にする必要があります。たとえば、home/middleware/ihs_webgateのようにします。

- MIDDLEWARE_HOME: Middlewareホーム・ディレクトリのフルパスを指定します。

2. インストーラの内容をディレクトリに展開します。

3. 次のコマンドを実行します。
WebGate_Installer_Directory/Disk1/runInstaller -jreLoc jre_location -invPtrLoc Absolute_Path_Of_the_oraInst.loc_file -silent -response Absolute_Path_Of_the_silent.rsp_file

このコマンドの内容は次のとおりです。

- WebGate_Installer_Directoryは、WebGateインストーラの内容を展開したディレクトリへの絶対パスです。

- jre_locationは、JREディレクトリへの絶対パスです。

- Absolute_Path_Of_the_oraInst.loc_fileは、oraInst.locファイルへの絶対パスです。

- Absolute_Path_Of_the_ silent.rsp_fileは、作成したsilent.rspファイルへの絶対パスです。

4 IHS WebGateのテスト環境から本番環境への移動

この章では、プロビジョニングされたIBM HTTP Server (IHS) 11g WebGate構成をテスト環境から本番環境にコピーする方法を説明します。ここで説明するものと同じ手順は、本番環境をテスト環境にコピーする際にも使用できます。この章では、次の項目について説明します。

- 第4.1項「概要」

- 第4.2項「前提条件」

- 第4.3項「WebGateのバイナリおよび構成のテストから本番へのレプリケート」

4.1 概要

テスト環境から本番環境にIHS 11g WebGate構成をコピーするには、次の手順を実行します。

1. 次のようにして、WebGateバイナリをコピーします。

1. copyBinaryコマンドを使用して、テスト・システムにWebGateバイナリをアーカイブします。

2. このアーカイブを本番システムに転送します。

3. pasteBinaryコマンドを使用して、このアーカイブを本番環境に解凍します。

2. 次のようにして、WebGate構成情報をコピーします。

1. copyConfigコマンドを使用して、テスト・システムにWebGateインスタンスをアーカイブします。

2. このアーカイブを本番システムに転送します。

3. (省略可能)次のステップでpasteConfigコマンドによって使用される構成設定を含むファイル(moveplan.xml)を編集します。

4. pasteConfigコマンドを使用して、このアーカイブを本番環境に解凍します。

4.2 前提条件

この章の手順を続行する前に、次の要件を満たしておいてください。

- IBM HTTP Serverの構成

- Oracle Access Management (OAM) Serverのコピー

- 本番ツールへの転送の検証

- JDKバージョンの確認

4.2.1 IBM HTTP Serverの構成

IBM HTTP Server Webサーバーを本番環境にインストールして構成する必要があります。バージョン番号とビルド番号が、テスト環境と本番環境で一致している必要があります。

4.2.2 Oracle Access Management (OAM) Serverのコピー

OAM Server構成をテスト環境から本番環境にコピーする必要があります。詳細は、サード・パーティ・アプリケーション・サーバー・ガイドの、IBM WebSphereでのAccess Managerのテスト環境から本番環境への移行に関する項を参照してください。

4.2.3 本番ツールへの転送の検証

本番(T2P)ツールへの転送が使用可能であることを検証します。これらのツールは次の場所にあります。

WebGate_Oracle_Home/WebGate/ihs/tools/WebGateT2P

UNIX環境で必要となるコマンド・スクリプトは次のとおりです。

- copyBinary.sh

- pasteBinary.sh

- copyConfig.sh

- pasteConfig.sh

cloningclientwg.jarファイルがあることを確認します。

4.2.4 JDKバージョンの確認

バージョン1.6以降のJDKまたはJREがインストールされていることを確認します。

JAVA_HOME環境変数を、JDK/JREパスの場所に設定します。たとえば、export JAVA_HOME=/home/software/jdk1.6.0_34のようにします。

注意:

テストから本番への移行コマンドを実行しているときには、システム上にJAVA_HOME環境変数を設定し、-javaHomeコマンド・オプションを使用できます。

4.3 WebGateのバイナリおよび構成のテストから本番へのレプリケート

テスト環境から本番環境にWebGateバイナリ・ファイルおよびWebGate構成ファイルをコピーするには、次の操作を行います。

4.3.1 WebGateバイナリのレプリケート

WebGateバイナリをレプリケートするには:

1. テスト環境でcopybinary.shコマンドを使用して、バイナリのアーカイブを作成します。使用方法を次に示します。
./copyBinary.sh [-javaHome Java_Home_Path ] -archiveLoc Archive_Dir -sourceOHomeLoc Source_WebGate_Oracle_Home

2. FTPを使用して、前のステップで作成したアーカイブを本番環境に移動します。
また、次のステップの準備として、WebGateT2Pディレクトリもテスト環境から本番環境にコピーします。

3. 本番環境でpastebinary.shコマンドを使用して、前のステップでコピーしたアーカイブを解凍します。使用方法を次に示します。
./pasteBinary.sh [-javaHome Java_Home_Path ] -archiveLoc Archive_Dir -targetOHomeLoc Target_Oracle_Home_Location

4.3.2 WebGate構成のレプリケート

Webgate構成をレプリケートするには:

1. テスト環境でcopyConfig.shコマンドを使用して、WebGateインスタンス(config)のアーカイブを作成します。
アーカイブの場所にMoveplan.xmlというファイルが作成されます。

copyConfigコマンドの使用方法は次のとおりです。

./copyConfig.sh [-javaHome Java_Home_Path ] -archiveLoc Archive_Dir -sourceInstanceHomeLoc Source_WebGate_Instance_Home

2. FTPを使用して、Moveplan.xmlと、前のステップで作成したアーカイブを本番環境に移動します。

3. (省略可能) moveplan.xmlを開いて編集し、次のパラメータを更新します。これらのパラメータは、本番環境にWebGateを構成するためにpasteConfig.shコマンドによって使用されます。

表4-1 構成パラメータおよび予想される値

パラメータ名

予想される値

primaryOAMServerHost

有効なOAMサーバーの名前

primaryOAMServerPort

有効なOAMサーバーのプロキシ・ポート

WGOracleHome

WebGate Oracleホーム

WGInstanceDir

WebGateインスタンス・ディレクトリ

WebServerConfigFile

Webサーバーの構成ファイルへのファイル・パス(たとえば、httpd.confやobj.conf)。

4. pasteConfig.shを実行する前に、本番システムで環境変数LD_LIBRARY_PATHおよびLIBPATHを設定します。

5. 本番環境でpasteConfig.shコマンドを実行して、ステップ2でコピーしたWebGateアーカイブを解凍します。pasteConfig.shコマンドには、2つの使用モードがあります。moveplan.xmlファイルで構成パラメータを定義した場合は、次のモードを使用します。
./pasteConfig.sh [-javaHome Java_Home_Path ] -archiveLoc Archive_Location -movePlanLoc Path_to_the_ moveplan.xml_file

または、コマンドラインで構成パラメータを定義する場合は、次のモードを使用します。

./pasteConfig.sh [-javaHome Java_Home_Path ] -archiveLoc Archive_Location -targetOHomeLoc Target_Oracle_home_location -targetInstanceHomeLoc An_empty_directory -webserverConfPath Web_server_configuration_path -oamHost OAM_server_host -oamPort OAM_server_port

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2013, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

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

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

ライセンス制約の保証と結果的に生じる損害の免責

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

保証免責

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

制限付権利

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

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

危険な用途への使用について

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

第三者のコンテンツ、製品、サービスに対する免責事項

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

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。