プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle Identity and Access Managementアップグレード・ガイド
11gリリース2 (11.1.2.3.0)
E69899-05
  ドキュメント・ライブラリへ移動
ライブラリ		 製品リストへ移動
製品		 目次へ移動
目次
前
前 		 次
次		  

4 単一ノードでライフ・サイクル管理(LCM)ツールを使用してデプロイされたOracle Identity and Access Management環境のアップグレード

この章では、ライフ・サイクル管理(LCM)ツールを使用して単一ノードにデプロイされたOracle Identity and Access Management 11gリリース2 (11.1.2.2.0)環境を、自動アップグレード手順を使用して11gリリース2 (11.1.2.3.0)にアップグレードする方法について説明します。

ライフ・サイクル管理(LCM)ツールを使用してデプロイされたOracle Identity and Access Management 11gリリース2 (11.1.2.2.0)高可用性(HA)環境をアップグレードする場合は、第5章「ライフ・サイクル管理(LCM)ツールを使用してデプロイされたOracle Identity and Access Management高可用性環境のアップグレード」を参照してください。


注意:

この章で説明するアップグレード手順は、Oracle Universal InstallerおよびFusion Middleware構成ウィザードを使用して手動で構成されたOracle Identity and Access Management環境のアップグレードには使用できません。

手動で構成されたOracle Identity and Access Management環境のアップグレードの詳細は、第1章「Oracle Identity and Access Managementのアップグレードの概要」を参照してください。

先に進む前に、第2章「Oracle Identity and Access Managementの自動アップグレードの理解」で説明されている自動アップグレードの概要、自動アップグレードでサポートされるデプロイメント・トポロジおよびサポートされる開始ポイントを確認してください。


注意:

最新パッチの詳細は、『Oracle Fusion Middleware Oracle Identity Managementリリース・ノート』の必須パッチのダウンロードおよび適用に関する項を参照してください。

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

4.1 この章で使用される変数

表4-1に、この章で使用される変数を示します。

表4-1 この章で使用される変数とその説明

変数 説明

SCRIPT_FILE_LOCATION

アップグレード・ツールidmUpgrade.zipをコピーし、ファイルを抽出した場所。

OIMHOST

Oracle Identity Manager (OIM)スイートのみのトポロジがデプロイされているホスト。

このホストには次のコンポーネントがインストールされています。

  • Oracle Identity Manager

  • Oracle HTTP Server

OAMHOST

Oracle Access Manager (OAM)スイートのみのトポロジがデプロイされているホスト。

このホストには次のコンポーネントがインストールされています。

  • Oracle Access Manager

  • Oracle HTTP Server

IDMHOST

Oracle Unified Directory (OUD)と統合されたOIM-OAMトポロジがデプロイされているホスト。

このホストには次のコンポーネントがインストールされています。

  • Oracle Identity Manager

  • Oracle Access Manager

  • Oracle Unified Directory

  • Oracle HTTP Server

4.2 この章で説明するアップグレード・シナリオ

この章では、ライフ・サイクル管理(LCM)ツールを使用してデプロイされた次のOracle Identity and Access Managementトポロジをアップグレードする方法を説明します。


注意:

分離アップグレードの詳細は、第2.3項「分離アップグレードの概要」を参照してください。

自動アップグレードでサポートされるシナリオのリストは、第2.2項「自動アップグレードでサポートされるデプロイメント・トポロジ」を参照してください。

4.3 単一ノード上のOracle Identity Manager (OIM)のみのトポロジのアップグレード

この項では、LCMツールを使用してデプロイされた単一ノード上のOracle Identity Manager (OIM)のみのトポロジを11gリリース2 (11.1.2.2.0)から11gリリース2 (11.1.2.3.0)にアップグレードする方法を説明します。

このトポロジには、Oracle Identity ManagerおよびOracle HTTP Server (OHS)をホストするOIMHOSTが含まれます。

Oracle Identity Managerアップグレードの一環として、埋込みOracle BI Publisher (BIP)がインストールされ、Oracle Identity Managerで構成されます。したがって、Oracle Identity Manager 11.1.2.3.0にアップグレードした後で、埋込みBI Publisherを使用するか、スタンドアロンのOracle BI Publisherの使用を継続するかを選択できます。埋込みBI Publisherを使用し、スタンドアロンBIPの使用を中止することを選択した場合は、既存のBIPレポートを埋込みBIPに移行する必要があります。

単一ノード上のOracle Identity Manager (OIM)のみのトポロジをアップグレードするには、次のタスクを実行します。

  1. 前提条件の完了

  2. ソフトウェアの入手

  3. 環境変数を設定する

  4. プロパティ・ファイルの更新

  5. OIMHOSTでの検証前チェックの実行

  6. OIMアップグレード用のBIPスキーマの作成(Solaris、IBM AIXおよびHP Itaniumプラットフォームの場合のみ)

  7. OIMHOST上のすべてのサーバーの停止

  8. データベースとWebLogicドメインのバックアップ

  9. OIMHOST上のバイナリと構成のアップグレード

  10. OIMHOSTでの検証後チェックの実行

  11. アップグレードの確認

4.3.1 前提条件の完了

アップグレード・プロセスを開始する前に、次の前提条件を満たす必要があります。

  1. システム要件および動作保証のドキュメントを読み、既存の環境が11gリリース2 (11.1.2.3.0)ソフトウェアに必要なすべてのハードウェアおよびソフトウェア要件を満たしていることを確認します。詳細は、第6.2項「システム要件および動作保証の確認」を参照してください。

  2. OIMHOSTで、/etc/hostsファイルに標準ホスト名(完全修飾ホスト名)とホスト名エントリの両方が含まれていることを確認します。詳細は、第6.5項「ホスト・ファイルでのホスト名の検証」を参照してください。

4.3.2 ソフトウェアの入手

アップグレード・スクリプトが含まれているファイルidmUpgrade.zipを入手します。zipファイルをOIMHOST上のアクセス可能な任意の場所にコピーし、zipファイルの内容を抽出します。zipファイルの入手と内容の抽出の詳細は、第6.6項「自動アップグレード・ツールの入手」を参照してください。


注意:

Oracle Identity and Access Managementの11gリリース2 (11.1.2.3.0)への自動アップグレードの実行手順では、Oracle Identity and Access Management自動アップグレード・ツール・バンドル・パッチ2 (11.1.2.3.2)を適用したことを想定しています。このパッチをダウンロードするには、次のURLにアクセスしてください。

https://updates.oracle.com/download/21419345.html

4.3.3 環境変数の設定

アップグレード・プロセスを開始する前に、Oracle Identity and Access Managementをアップグレードしているプラットフォームに応じてOIMHOSTに必要な変数を設定する必要があります。詳細は、第6.4項「アップグレードに必要な環境変数の設定」を参照してください。

4.3.4 プロパティ・ファイルの更新

OIMHOSTのSCRIPT_FILE_LOCATION/r2ps3/idmUpgrade/upgrade.propertiesにあるupgrade.propertiesファイルを、必要なプロパティの値で更新する必要があります。

Oracle Identity Manager (OIM)のみのトポロジをアップグレードするために更新する必要のあるプロパティの詳細は、第6.7項「upgrade.propertiesファイルの更新」を参照してください。

4.3.5 OIMHOSTでの検証前チェックの実行

プロパティ・ファイルを更新した後で、Oracle Identity ManagerとOracle HTTP Serverの両方についてOIMHOSTで検証前チェックを実行する必要があります。これを行うには、次の手順を実行します。

  1. 引数-nodeにOIMを指定して、Oracle Identity Managerに対してpreValidate.plスクリプトを実行します。

  2. 引数-nodeにWEBTIERを指定して、Oracle HTTP Serverに対してpreValidate.plスクリプトを実行します。

preValidate.plスクリプトの一般構文およびスクリプトの実行の詳細は、第6.8項「preValidate.plスクリプトを使用した検証前チェックの実行」を参照してください。

4.3.6 OIMアップグレード用のBIPスキーマの作成(Solaris、IBM AIXおよびHP Itaniumプラットフォームの場合のみ)

自動アップグレード・ツールを使用してSolaris、IBM AIX、HP ItaniumなどのプラットフォームでOracle Identity Managerをアップグレードする場合は、LinuxまたはWindowsオペレーティング・システムを実行しているマシンからリポジトリ作成ユーティリティ(RCU) 11.1.2.3.0を使用してOracle BI Publisher (BIPLATFORM)スキーマを手動で作成する必要があります。

RCUを使用したスキーマの作成の詳細は、第6.9項「Solaris、IBM AIXおよびHP ItaniumプラットフォームでOracle Identity ManagerをアップグレードするためのBIPスキーマの作成」を参照してください。


注意:

Linuxでは自動アップグレード・ツールによってBIPLATFORMスキーマが作成されるため、Linux上のOracle Identity Managerをアップグレードする場合はこの手順をスキップします。

4.3.7 OIMHOST上のすべてのサーバーの停止

OIMHOST上で次のサーバーを停止する必要があります。

  1. Oracle HTTP Server

  2. Oracle Identity Manager管理対象サーバー

  3. Oracle SOA Suite管理対象サーバー

  4. WebLogic管理サーバー

ホスト上のすべてのサーバーを停止するには、SHARED_CONFIG_DIR/config/scriptsから次のコマンド・スクリプトを実行します。

./stopall.sh

4.3.8 データベースとWebLogicドメインのバックアップ

アップグレード・スクリプトを実行する前に、OIMHOSTでデータベース・スキーマとWebLogicドメインをバックアップする必要があります。詳細は、第6.3項「既存の環境のバックアップ」を参照してください。

4.3.9 OIMHOST上のバイナリと構成のアップグレード

idmUpgrade.plスクリプトを使用して、OIMHOST上でOracle Identity ManagerとOracle HTTP Serverの両方のバイナリと構成をアップグレードする必要があります。

スクリプトの実行時に引数-modeに値bothを指定することで、バイナリ・アップグレードと構成アップグレードの両方を一緒に実行できます。その場合、アップグレード・スクリプトは、最初にバイナリ・アップグレードを実行してから構成アップグレードを実行します。引数-modeに値を指定しない場合、値はboth (デフォルト値)とみなされます。したがって、単一ノード上でOracle Identity Managerをアップグレードする場合、-modeはオプションの引数です。


注意:

アップグレード・スクリプトを実行する前に、データベース・サービスが稼働していることを確認します。

OIMHOST上でOracle Identity ManagerとOracle HTTP Serverのバイナリと構成をアップグレードするには、次の手順を実行します。

  1. 引数-nodeにOIMを指定し、引数-modeにbothを指定して、Oracle Identity Managerのバイナリと構成をアップグレードするOIMHOST上でidmUpgrade.plスクリプトを実行します。

  2. 引数-nodeにWEBTIERを指定し、引数-modeにbothを指定して、Oracle HTTP Serverのバイナリと構成をアップグレードするOIMHOST上でidmUpgrade.plスクリプトを実行します。

idmUpgrade.plスクリプトの一般構文およびスクリプトの実行の詳細は、第6.10項「idmUpgrade.plスクリプトを使用したOracle Identity and Access Managementバイナリおよび構成のアップグレード」を参照してください。

4.3.10 OIMHOSTでの検証後チェックの実行

バイナリと構成をアップグレードした後で、postValidate.plスクリプトを使用して、Oracle Identity ManagerとOracle HTTP Serverの両方についてOIMHOSTで検証後チェックを実行する必要があります。

OIMHOSTで検証後チェックを実行するには、次の手順を実行します。

  1. 引数-nodeにOIMを指定して、Oracle Identity Managerに対してpostValidate.plスクリプトを実行します。

  2. 引数-nodeにWEBTIERを指定して、Oracle HTTP Serverに対してpostValidate.plスクリプトを実行します。

postValidate.plスクリプトの一般構文およびスクリプトの実行の詳細は、第6.11項「postValidate.plスクリプトを使用した検証後チェックの実行」を参照してください。

4.3.11 アップグレードの確認

検証後チェックを実行した後で、OIMHOSTのログ・ファイルをチェックしてOracle Identity Managerのアップグレードを確認します。ログ・ファイルは、upgrade.propertiesファイルのLOG_DIRパラメータで指定した場所に作成されます。

4.4 単一ノード上のOracle Access Manager (OAM)スイートのみのトポロジのアップグレード

この項では、LCMツールを使用してデプロイされた単一ノード上のOracle Access Manager (OAM)スイートのみのトポロジを11gリリース2 (11.1.2.2.0)から11gリリース2 (11.1.2.3.0)にアップグレードする方法を説明します。

このトポロジには、Oracle Access ManagerおよびOracle HTTP Server (OHS)をホストするOAMHOSTが含まれます。デプロイ後にOracle Access Manager 11gリリース2 (11.1.2.2.0)ドメインをOracle Adaptive Access Managerに拡張した場合は、このトポロジにOracle Adaptive Access Managerを含めることもできます。

Oracle Access Manager 11gリリース2 (11.1.2.3.0)には、Oracle Mobile Security Suiteという新機能があります。アップグレード後にOracle Mobile Security Suiteを有効にできます。Oracle Mobile Security Suiteの概要は、『Oracle Fusion Middleware Oracle Mobile Security Suiteの管理』のOracle Mobile Security Suiteの理解に関する項を参照してください。


注意:

アップグレードは、非埋込みLDAPのあるOAMのみの環境(Oracle Unified Directory (OUD)、Oracle Internet Directory (OID)およびMicrosoft Active Directory (AD))でサポートされます。埋込みLDAPのあるOAMのみの環境のアップグレードはサポートされていません。

単一ノード上のOracle Access Manager (OAM)スイートのみのトポロジをアップグレードするには、次のタスクを実行します。

  1. 前提条件の完了

  2. ソフトウェアの入手

  3. 環境変数を設定する

  4. プロパティ・ファイルの更新

  5. OAMHOSTでの検証前チェックの実行

  6. OAMHOST上のすべてのサーバーの停止

  7. データベースとWebLogicドメインのバックアップ

  8. OAMHOST上のバイナリと構成のアップグレード

  9. OAMHOSTでの検証後チェックの実行

  10. アップグレードの確認

4.4.1 前提条件の完了

アップグレード・プロセスを開始する前に、次の前提条件を満たす必要があります。

  1. システム要件および動作保証のドキュメントを読み、既存の環境が11gリリース2 (11.1.2.3.0)ソフトウェアに必要なすべてのハードウェアおよびソフトウェア要件を満たしていることを確認します。詳細は、第6.2項「システム要件および動作保証の確認」を参照してください。

  2. OAMHOSTで、/etc/hostsファイルに標準ホスト名(完全修飾ホスト名)とホスト名エントリの両方が含まれていることを確認します。詳細は、第6.5項「ホスト・ファイルでのホスト名の検証」を参照してください。

  3. Oracle Adaptive Access Manager (OAAM)管理サーバーが次のURLでアクセス可能であることを確認します。

    http://OAM_HOST:OAAM_ADMIN_PORT/oaam_admin

    OAAM管理ユーザー名とOAAM管理パスワードを使用して、OAAM管理サーバーにアクセスします。

    次に例を示します。

    http://identity.example.com:14200/oaam_admin

    ユーザー名: oaamadminuser

    パスワード: Welcome1

4.4.2 ソフトウェアの入手

アップグレード・スクリプトが含まれているファイルidmUpgrade.zipを入手します。両方のホストでzipファイルをOAMHOST上のアクセス可能な任意の場所にコピーし、zipファイルの内容を抽出します。zipファイルの入手と内容の抽出の詳細は、第6.6項「自動アップグレード・ツールの入手」を参照してください。


注意:

Oracle Identity and Access Managementの11gリリース2 (11.1.2.3.0)への自動アップグレードの実行手順では、Oracle Identity and Access Management自動アップグレード・ツール・バンドル・パッチ2 (11.1.2.3.2)を適用したことを想定しています。このパッチをダウンロードするには、次のURLにアクセスしてください。

https://updates.oracle.com/download/21419345.html

4.4.3 環境変数の設定

アップグレード・プロセスを開始する前に、Oracle Identity and Access Managementをアップグレードしているプラットフォームに応じてOAMHOSTに必要な変数を設定する必要があります。詳細は、第6.4項「アップグレードに必要な環境変数の設定」を参照してください。

4.4.4 プロパティ・ファイルの更新

OAMHOSTのSCRIPT_FILE_LOCATION/r2ps3/idmUpgrade/upgrade.propertiesにあるupgrade.propertiesファイルを、必要なプロパティの値で更新する必要があります。

Oracle Access Manager (OAM)のみのトポロジをアップグレードするために更新する必要のあるプロパティの詳細は、第6.7項「upgrade.propertiesファイルの更新」を参照してください。

4.4.5 OAMHOSTでの検証前チェックの実行

プロパティ・ファイルを更新した後で、preValidate.plスクリプトを使用して、OAMHOSTでOracle Access ManagerとOracle HTTP Serverの両方について検証前チェックを実行する必要があります。検証前チェックを実行するには、次の手順を実行します。

  1. 引数-nodeにOAMを指定して、Oracle Access Managerに対してpreValidate.plスクリプトを実行します。

  2. 引数-nodeにWEBTIERを指定して、Oracle HTTP Serverに対してpreValidate.plスクリプトを実行します。

preValidate.plスクリプトの一般構文およびスクリプトの実行の詳細は、第6.8項「preValidate.plスクリプトを使用した検証前チェックの実行」を参照してください。

4.4.6 OAMHOST上のすべてのサーバーの停止

OAMHOST上で次のサーバーを停止する必要があります。

  1. Oracle HTTP Server

  2. Oracle Access Manager管理対象サーバー

  3. WebLogic管理サーバー

ホスト上のすべてのサーバーを停止するには、SHARED_CONFIG_DIR/config/scriptsから次のコマンド・スクリプトを実行します。

./stopall.sh

4.4.7 データベースとWebLogicドメインのバックアップ

アップグレード・スクリプトを実行する前に、OAMHOSTでデータベース・スキーマとWebLogicドメインをバックアップする必要があります。詳細は、第6.3項「既存の環境のバックアップ」を参照してください。

4.4.8 OAMHOST上のバイナリと構成のアップグレード

idmUpgrade.plスクリプトを使用して、OAMHOST上でOracle Access ManagerとOracle HTTP Serverの両方のバイナリと構成をアップグレードする必要があります。

スクリプトの実行時に引数-modeに値bothを指定することで、バイナリ・アップグレードと構成アップグレードの両方を一緒に実行できます。その場合、アップグレード・スクリプトは、最初にバイナリ・アップグレードを実行してから構成アップグレードを実行します。引数-modeに値を指定しない場合、値はboth (デフォルト値)とみなされます。したがって、単一ノード上でOracle Identity Managerをアップグレードする場合、-modeはオプションの引数です。


注意:

アップグレード・スクリプトを実行する前に、データベース・サービスが稼働していることを確認します。

OAMHOST上でOracle Access ManagerとOracle HTTP Serverのバイナリと構成をアップグレードするには、次の手順を実行します。

  1. 引数-nodeにOAMを指定し、引数-modeにbothを指定して、Oracle Access Managerのバイナリと構成をアップグレードするOAMHOST上でidmUpgrade.plスクリプトを実行します。

  2. 引数-nodeにWEBTIERを指定し、引数-modeにbothを指定して、Oracle HTTP Serverのバイナリと構成をアップグレードするOAMHOST上でidmUpgrade.plスクリプトを実行します。

idmUpgrade.plスクリプトの一般構文およびスクリプトの実行の詳細は、第6.10項「idmUpgrade.plスクリプトを使用したOracle Identity and Access Managementバイナリおよび構成のアップグレード」を参照してください。

4.4.9 OAMHOSTでの検証後チェックの実行

バイナリと構成をアップグレードした後で、postValidate.plスクリプトを使用して、Oracle Access ManagerとOracle HTTP Serverの両方についてOAMHOSTで検証後チェックを実行する必要があります。

OAMHOSTで検証後チェックを実行するには、次の手順を実行します。

  1. 引数-nodeにOAMを指定して、Oracle Access Managerに対してpostValidate.plスクリプトを実行します。

  2. 引数-nodeにWEBTIERを指定して、Oracle HTTP Serverに対してpostValidate.plスクリプトを実行します。

postValidate.plスクリプトの一般構文およびスクリプトの実行の詳細は、第6.11項「postValidate.plスクリプトを使用した検証後チェックの実行」を参照してください。

4.4.10 アップグレードの確認

検証後チェックを実行した後で、OAMHOSTのログ・ファイルをチェックしてOracle Access Managerのアップグレードを確認します。ログ・ファイルは、upgrade.propertiesファイルのLOG_DIRパラメータで指定した場所に作成されます。

4.5 単一ノード上のOracle Unified Directory (OUD)と統合されたOIM-OAMトポロジのアップグレード

この項では、LCMツールを使用してデプロイされた単一ノード上のOracle Unified Directory (OUD)と統合されたOIM-OAMトポロジを11gリリース2 (11.1.2.2.0)から11gリリース2 (11.1.2.3.0)にアップグレードする方法を説明します。

このトポロジには、Oracle Identity Manager、Oracle Access Manager、Oracle Unified DirectoryおよびOracle HTTP ServerをホストするIDMHOSTが含まれます。

Oracle Identity Managerアップグレードの一環として、埋込みOracle BI Publisher (BIP)がインストールされ、Oracle Identity Managerで構成されます。したがって、Oracle Identity Manager 11.1.2.3.0にアップグレードした後で、埋込みBI Publisherを使用するか、スタンドアロンのOracle BI Publisherの使用を継続するかを選択できます。埋込みBI Publisherを使用し、スタンドアロンBIPの使用を中止することを選択した場合は、既存のBIPレポートを埋込みBIPに移行する必要があります。

Oracle Access Manager 11gリリース2 (11.1.2.3.0)には、Oracle Mobile Security Suiteという新機能があります。アップグレード後にOracle Mobile Security Suiteを有効にできます。Oracle Mobile Security Suiteの概要は、『Oracle Fusion Middleware Oracle Mobile Security Suiteの管理』のOracle Mobile Security Suiteの理解に関する項を参照してください。


注意:

Linuxでは分離アップグレードがサポートされます。これは、Oracle Unified Directory (OUD)と統合されたOIM-OAMトポロジの1つの層のみを11.1.2.3.0にアップグレードすることを選択できることを意味します。アップグレードされた層は、まだ11gリリース2 (11.1.2.2.0)にある他の層で正常に機能します。

分離アップグレードの詳細は、第2.3項「分離アップグレードの概要」を参照してください。

分離アップグレードの実行の詳細は、第4.6項「単一ノード上のOracle Unified Directory (OUD)と統合されたOIM-OAMトポロジの分離アップグレードの実行」を参照してください。

単一ノード上のOracle Unified Directory (OUD)と統合されたOIM-OAMトポロジをアップグレードするには、次のタスクを実行します。

  1. 前提条件の完了

  2. ソフトウェアの入手

  3. 環境変数を設定する

  4. プロパティ・ファイルの更新

  5. IDMHOSTでの検証前チェックの実行

  6. OIMアップグレード用のBIPスキーマの作成(Solaris、IBM AIXおよびHP Itaniumプラットフォームの場合のみ)

  7. IDMHOST上のすべてのサーバーの停止

  8. データベースとWebLogicドメインのバックアップ

  9. IDMHOST上のバイナリと構成のアップグレード

  10. IDMHOSTでの検証後チェックの実行

  11. アップグレード後に必要なタスクの実行

  12. アップグレードの確認

4.5.1 前提条件の完了

アップグレード・プロセスを開始する前に、次の前提条件を満たす必要があります。

  1. システム要件および動作保証のドキュメントを読み、既存の環境が11gリリース2 (11.1.2.3.0)ソフトウェアに必要なすべてのハードウェアおよびソフトウェア要件を満たしていることを確認します。詳細は、第6.2項「システム要件および動作保証の確認」を参照してください。

  2. IDMHOSTで、/etc/hostsファイルに標準ホスト名(完全修飾ホスト名)とホスト名エントリの両方が含まれていることを確認します。詳細は、第6.5項「ホスト・ファイルでのホスト名の検証」を参照してください。

  3. Oracle Adaptive Access Manager (OAAM)管理サーバーが次のURLでアクセス可能であることを確認します。

    http://OAM_HOST:OAAM_ADMIN_PORT/oaam_admin

    OAAM管理ユーザー名とOAAM管理パスワードを使用して、OAAM管理サーバーにアクセスします。

    次に例を示します。

    http://identity.example.com:14200/oaam_admin

    ユーザー名: oaamadminuser

    パスワード: Welcome1

4.5.2 ソフトウェアの入手

アップグレード・スクリプトが含まれているファイルidmUpgrade.zipを入手します。zipファイルをIDMHOST上のアクセス可能な任意の場所にコピーし、zipファイルの内容を抽出します。zipファイルの入手と内容の抽出の詳細は、第6.6項「自動アップグレード・ツールの入手」を参照してください。


注意:

Oracle Identity and Access Managementの11gリリース2 (11.1.2.3.0)への自動アップグレードの実行手順では、Oracle Identity and Access Management自動アップグレード・ツール・バンドル・パッチ2 (11.1.2.3.2)を適用したことを想定しています。このパッチをダウンロードするには、次のURLにアクセスしてください。

https://updates.oracle.com/download/21419345.html

4.5.3 環境変数の設定

アップグレード・プロセスを開始する前に、Oracle Identity and Access Managementをアップグレードしているプラットフォームに応じて必要な変数を設定する必要があります。詳細は、第6.4項「アップグレードに必要な環境変数の設定」を参照してください。

4.5.4 プロパティ・ファイルの更新

IDMHOSTのSCRIPT_FILE_LOCATION/r2ps3/idmUpgrade/upgrade.propertiesにあるupgrade.propertiesファイルを、必要なプロパティの値で更新する必要があります。

Oracle Unified Directory (OUD)と統合されたOIM-OAMトポロジをアップグレードするために更新する必要のあるプロパティの詳細は、第6.7項「upgrade.propertiesファイルの更新」を参照してください。

4.5.5 IDMHOSTでの検証前チェックの実行

プロパティ・ファイルを更新した後で、preValidate.plスクリプトを使用して、Oracle Identity Manager、Oracle Access Manager、Oracle Unified DirectoryおよびOracle HTTP ServerについてIDMHOSTで検証前チェックを実行する必要があります。

検証前チェックを実行するには、IDMHOSTで次のタスクを実行します。

  1. 引数-nodeにOAMを指定して、Oracle Access Managerに対してpreValidate.plスクリプトを実行します。

  2. 引数-nodeにOIMを指定して、Oracle Identity Managerに対してpreValidate.plスクリプトを実行します。

  3. 引数-nodeにWEBTIERを指定して、Oracle HTTP Serverに対してpreValidate.plスクリプトを実行します。

  4. 引数-nodeにDIRECTORYを指定して、Oracle Unified Directoryに対してpreValidate.plスクリプトを実行します。

preValidate.plスクリプトの一般構文およびスクリプトの実行の詳細は、第6.8項「preValidate.plスクリプトを使用した検証前チェックの実行」を参照してください。


注意:

最初にOracle Unified Directoryの検証前チェックを実行する場合は、次のいずれかの場所からファイルlibnnz11.soおよびlibclntsh.so.11.1をLDAPHOST上のフォルダSCRIPT_FILE_LOCATION/r2ps3/idmUpgrade/libにコピーする必要があります。

  • IAD_WL_HOME/server/adr

  • IGD_WL_HOME/server/adr

  • Web_Tier_ORACLE_HOME/lib

IAD_WL_HOMEはIAMAccessDomainを参照し、IGD_WL_HOMEはIAMGovernanceDomainを参照します。

ファイルをコピーした後で、Oracle Unified Directoryに対して検証前チェックを実行できます。

4.5.6 OIMアップグレード用のBIPスキーマの作成(Solaris、IBM AIXおよびHP Itaniumプラットフォームの場合のみ)

自動アップグレード・ツールを使用してSolaris、IBM AIX、HP ItaniumなどのプラットフォームでOracle Identity Managerをアップグレードする場合は、LinuxまたはWindowsオペレーティング・システムを実行しているマシンからリポジトリ作成ユーティリティ(RCU) 11.1.2.3.0を使用してOracle BI Publisher (BIPLATFORM)スキーマを手動で作成する必要があります。

RCUを使用したスキーマの作成の詳細は、第6.9項「Solaris、IBM AIXおよびHP ItaniumプラットフォームでOracle Identity ManagerをアップグレードするためのBIPスキーマの作成」を参照してください。


注意:

Linuxでは自動アップグレード・ツールによってBIPLATFORMスキーマが作成されるため、Linux上のOracle Identity Managerをアップグレードする場合はこの手順をスキップします。

4.5.7 IDMHOST上のすべてのサーバーの停止

IDMHOST上で次のサーバーを停止する必要があります。

  1. Oracle HTTP Server。

  2. Oracle Access Manager管理対象サーバー

  3. Oracle Identity Manager管理対象サーバー

  4. Oracle SOA Suite管理対象サーバー

  5. WebLogic管理サーバー。

  6. Oracle Unified Directory

ホスト上のすべてのサーバーを停止するには、SHARED_CONFIG_DIR/config/scriptsから次のコマンド・スクリプトを実行します。

./stopall.sh

4.5.8 データベースとWebLogicドメインのバックアップ

アップグレード・スクリプトを実行する前に、データベース・スキーマとWebLogicドメインをバックアップする必要があります。詳細は、第6.3項「既存の環境のバックアップ」を参照してください。

4.5.9 IDMHOST上のバイナリと構成のアップグレード

idmUpgrade.plスクリプトを使用して、Oracle Identity Manager、Oracle Access Manager、Oracle Unified DirectoryおよびOracle HTTP Serverのバイナリと構成をアップグレードする必要があります。

スクリプトの実行時に引数-modeに値bothを指定することで、バイナリ・アップグレードと構成アップグレードの両方を一緒に実行できます。その場合、アップグレード・スクリプトは、最初にバイナリ・アップグレードを実行してから構成アップグレードを実行します。引数-modeに値を指定しない場合、値はboth (デフォルト値)とみなされます。したがって、単一ノード上でOracle Identity Managerをアップグレードする場合、-modeはオプションの引数です。


注意:

アップグレード・スクリプトを実行する前に、データベース・サービスが稼働していることを確認します。

IDMHOSTでバイナリと構成をアップグレードするには、次の手順を実行します。

  1. 引数-nodeにDIRECTORYを指定し、引数-modeにbothを指定してidmUpgrade.plスクリプトを実行し、Oracle Unified Directoryのバイナリと構成をアップグレードします。


    注意:

    Oracle Unified Directory (OUD)のバイナリと構成をアップグレードする前に、Oracle Identity ManagerおよびOracle Access Manager管理対象サーバーを停止したことを確認します。

  2. 引数-nodeにOAMを指定し、引数-modeにbothを指定してidmUpgrade.plスクリプトを実行し、Oracle Access Managerのバイナリと構成をアップグレードします。

  3. 引数-nodeにOIMを指定し、引数-modeにbothを指定してidmUpgrade.plスクリプトを実行し、Oracle Identity Managerのバイナリと構成をアップグレードします。


    注意:

    Oracle Identity Managerのバイナリと構成をアップグレードする前に、Oracle Access Manager管理対象サーバーを停止したことを確認します。

  4. 引数-nodeにWEBTIERを指定し、引数-modeにbothを指定してidmUpgrade.plスクリプトを実行し、Oracle HTTP Serverのバイナリと構成をアップグレードします。

idmUpgrade.plスクリプトの一般構文およびスクリプトの実行の詳細は、第6.10項「idmUpgrade.plスクリプトを使用したOracle Identity and Access Managementバイナリおよび構成のアップグレード」を参照してください。

4.5.10 IDMHOSTでの検証後チェックの実行

プロパティ・ファイルを更新した後で、postValidate.plスクリプトを使用して、Oracle Identity Manager、Oracle Access Manager、Oracle Unified DirectoryおよびOracle HTTP ServerについてIDMHOSTで検証後チェックを実行する必要があります。

検証後チェックを実行するには、IDMHOSTで次のタスクを実行します。

  1. 引数-nodeにOAMを指定して、Oracle Access Managerに対してpostValidate.plスクリプトを実行します。

  2. 引数-nodeにOIMを指定して、Oracle Identity Managerに対してpostValidate.plスクリプトを実行します。

  3. 引数-nodeにWEBTIERを指定して、Oracle HTTP Serverに対してpostValidate.plスクリプトを実行します。

  4. 引数-nodeにDIRECTORYを指定して、Oracle Unified Directoryに対してpostValidate.plスクリプトを実行します。

postValidate.plスクリプトの一般構文およびスクリプトの実行の詳細は、第6.11項「postValidate.plスクリプトを使用した検証後チェックの実行」を参照してください。

4.5.11 アップグレード後に必要なタスクの実行

この項では、アップグレード後に動作する機能の一部に必要なアップグレード後タスクを示します。要件に基づいてアップグレード後タスクを実行します。

この項には次のトピックが含まれます:

4.5.11.1 OAAMを構成した場合のJAVAシステム・プロパティの追加

Oracle Unified Directory (OUD)と統合されたOIM-OAMトポロジにOracle Adaptive Access Managerを構成した場合は、IAMAccessDomainにあるsetDomainEnv.shスクリプトにJAVAシステム・プロパティ-Djava.security.auth.login.configを追加する必要があります。詳細は、第6.13.1項「Oracle Adaptive Access ManagerのJavaシステム・プロパティの追加」を参照してください。

4.5.12 アップグレードの確認

検証後チェックを実行した後で、IDMHOSTのログ・ファイルをチェックしてアップグレードを確認します。ログ・ファイルは、upgrade.propertiesファイルのLOG_DIRパラメータで指定した場所に作成されます。

4.6 単一ノード上のOracle Unified Directory (OUD)と統合されたOIM-OAMトポロジの分離アップグレードの実行

LCMツール11gリリース2 (11.1.2.2.0)を使用してOracle Unified Directory (OUD)と統合されたOIM-OAMトポロジを単一ノードにデプロイした場合は、スイート全体をアップグレードせずにコンポーネントの1つのみアップグレードすることを選択できます。

この項では、IDMHOSTはOracle Unified Directory (OUD)と統合されたOIM-OAMトポロジがデプロイされているホストを表します。


注意:

Oracle Unified Directory (OUD)と統合されたOIM-OAMトポロジの分離アップグレードは、単一ノードのLinuxプラットフォームでのみサポートされます。

分離アップグレードの詳細は、第2.3項「分離アップグレードの概要」を参照してください。


注意:

単一ノード上のOracle Unified Directory (OUD)と統合されたOIM-OAMトポロジであるフル・スイートをアップグレードする場合は、第4.5項「単一ノード上のOracle Unified Directory (OUD)と統合されたOIM-OAMトポロジのアップグレード」で説明されている手順に従います。

単一ノード上のOracle Unified Directory (OUD)と統合されたOIM-OAMトポロジでは、次の分離アップグレード・シナリオがサポートされます。

  • Oracle Identity Manager (OIM)のみのアップグレード

  • Oracle Access Manager (OAM)のみのアップグレード

  • Oracle Unified Directory (OUD)のみのアップグレード

  • Oracle HTTP Server (OHS)のみのアップグレード

分離アップグレードの実行手順

分離アップグレードを実行するには、次の手順を実行します。

  1. 次の前提条件を実行します。

    1. システム要件および動作保証のドキュメントを読み、既存の環境が11gリリース2 (11.1.2.3.0)ソフトウェアに必要なすべてのハードウェアおよびソフトウェア要件を満たしていることを確認します。詳細は、第6.2項「システム要件および動作保証の確認」を参照してください。

    2. IDMHOSTで、/etc/hostsファイルに標準ホスト名(完全修飾ホスト名)とホスト名エントリの両方が含まれていることを確認します。詳細は、第6.5項「ホスト・ファイルでのホスト名の検証」を参照してください。

  2. アップグレード・スクリプトが含まれているファイルidmUpgrade.zipを入手します。zipファイルをIDMHOST上のアクセス可能な任意の場所にコピーし、zipファイルの内容を抽出します。zipファイルの入手と内容の抽出の詳細は、第6.6項「自動アップグレード・ツールの入手」を参照してください。


    注意:

    Oracle Identity and Access Managementの11gリリース2 (11.1.2.3.0)への自動アップグレードの実行手順では、Oracle Identity and Access Management自動アップグレード・ツール・バンドル・パッチ2 (11.1.2.3.2)を適用したことを想定しています。このパッチをダウンロードするには、次のURLにアクセスしてください。

    https://updates.oracle.com/download/21419345.html

  3. Oracle Unified Directoryをアップグレードするプラットフォームに応じて、必要な環境変数を設定します。詳細は、第6.4項「アップグレードに必要な環境変数の設定」を参照してください。

  4. IDMHOST上のSCRIPT_FILE_LOCATION/r2ps3/idmUpgrade/upgrade.propertiesにあるupgrade.propertiesファイルを、アップグレードするコンポーネントに応じて必要なパラメータの値で更新します。

    upgrade.propertiesファイルの更新の詳細およびこれらのパラメータの説明は、第6.7項「upgrade.propertiesファイルの更新」を参照してください。

  5. アップグレードするコンポーネントのpreValidate.plスクリプトを使用して、検証前チェックを実行します。

    • Oracle Identity Managerのみをアップグレードする場合は、引数-nodeにOIMを指定して、IDMHOSTでOracle Identity Managerに対して検証前チェックを実行するpreValidate.plスクリプトを実行します。

    • Oracle Access Managerのみをアップグレードする場合は、引数-nodeにOAMを指定して、IDMHOSTでOracle Access Managerに対して検証前チェックを実行するpreValidate.plスクリプトを実行します。

    • Oracle Unified Directoryのみをアップグレードする場合は、引数-nodeにDIRECTORYを指定して、IDMHOSTでOracle Unified Directoryに対して検証前チェックを実行するpreValidate.plスクリプトを実行します。

    • Oracle HTTP Serverのみをアップグレードする場合は、引数-nodeにWEBTIERを指定して、IDMHOSTでOracle HTTP Serverに対して検証前チェックを実行するpreValidate.plスクリプトを実行します。


      注意:

      Oracle Unified Directoryの検証前チェックを実行する前に、次のいずれかの場所からファイルlibnnz11.soおよびlibclntsh.so.11.1をLDAPHOST上のフォルダSCRIPT_FILE_LOCATION/r2ps3/idmUpgrade/libにコピーします。

      • IAD_WL_HOME/server/adr

      • IGD_WL_HOME/server/adr

      • Web_Tier_ORACLE_HOME/lib

      IAD_WL_HOMEはIAMAccessDomainを参照し、IGD_WL_HOMEはIAMGovernanceDomainを参照します。

      ファイルをコピーした後で、Oracle Unified Directoryに対して検証前チェックを実行できます。

    preValidate.plスクリプトの一般構文およびスクリプトの実行の詳細は、第6.8項「preValidate.plスクリプトを使用した検証前チェックの実行」を参照してください。

  6. 自動アップグレード・ツールを使用してSolaris、IBM AIX、HP ItaniumなどのプラットフォームでOracle Identity Managerのみをアップグレードする場合は、LinuxまたはWindowsオペレーティング・システムを実行しているマシンからリポジトリ作成ユーティリティ(RCU) 11.1.2.3.0を使用してOracle BI Publisher (BIPLATFORM)スキーマを手動で作成する必要があります。

    RCUを使用したスキーマの作成の詳細は、第6.9項「Solaris、IBM AIXおよびHP ItaniumプラットフォームでOracle Identity ManagerをアップグレードするためのBIPスキーマの作成」を参照してください。


    注意:

    Linuxでは自動アップグレード・ツールによってBIPLATFORMスキーマが作成されるため、Linux上のOracle Identity Managerをアップグレードする場合はこの手順をスキップします。

  7. IDMHOST上で次のサーバーを停止します。

    1. Oracle HTTP Server。

    2. Oracle Access Manager管理対象サーバー

    3. Oracle Identity Manager管理対象サーバー

    4. Oracle SOA Suite管理対象サーバー

    5. WebLogic管理サーバー。

    6. Oracle Unified Directory

    ホスト上のすべてのサーバーを停止するには、SHARED_CONFIG_DIR/config/scriptsから次のコマンド・スクリプトを実行します。

    ./stopall.sh

  8. データベース・スキーマとWebLogicドメインをバックアップします。詳細は、第6.3項「既存の環境のバックアップ」を参照してください。

  9. idmUpgrade.plスクリプトを使用して、アップグレードするコンポーネントのバイナリと構成をアップグレードします。

    • Oracle Unified Directoryのみをアップグレードする場合は、引数-nodeにDIRECTORYを指定し、引数-modeにbothを指定してidmUpgrade.plスクリプトを実行し、Oracle Unified Directoryのバイナリと構成をアップグレードします。


      注意:

      Oracle Unified Directory (OUD)のバイナリと構成をアップグレードする前に、Oracle Identity ManagerおよびOracle Access Manager管理対象サーバーを停止したことを確認します。

    • Oracle Access Managerのみをアップグレードする場合は、引数-nodeにOAMを指定し、引数-modeにbothを指定してidmUpgrade.plスクリプトを実行し、Oracle Access Managerのバイナリと構成をアップグレードします。

    • Oracle Identity Managerのみをアップグレードする場合は、引数-nodeにOIMを指定し、引数-modeにbothを指定してidmUpgrade.plスクリプトを実行し、Oracle Identity Managerのバイナリと構成をアップグレードします。


      注意:

      Oracle Identity Managerのバイナリと構成をアップグレードする前に、Oracle Access Manager管理対象サーバーを停止したことを確認します。

    • Oracle HTTP Serverのみをアップグレードする場合は、引数-nodeにWEBTIERを指定し、引数-modeにbothを指定してidmUpgrade.plスクリプトを実行し、Oracle HTTP Serverのバイナリと構成をアップグレードします。

  10. アップグレードするコンポーネントのpostValidate.plスクリプトを使用して、検証後チェックを実行します。

    • Oracle Identity Managerのみをアップグレードする場合は、引数-nodeにOIMを指定して、IDMHOSTでOracle Identity Managerに対して検証後チェックを実行するpostValidate.plスクリプトを実行します。

    • Oracle Access Managerのみをアップグレードする場合は、引数-nodeにOAMを指定して、IDMHOSTでOracle Access Managerに対して検証後チェックを実行するpostValidate.plスクリプトを実行します。

    • Oracle Unified Directoryのみをアップグレードする場合は、引数-nodeにDIRECTORYを指定して、IDMHOSTでOracle Unified Directoryに対して検証後チェックを実行するpostValidate.plスクリプトを実行します。

    • Oracle HTTP Serverのみをアップグレードする場合は、引数-nodeにWEBTIERを指定して、IDMHOSTでOracle HTTP Serverに対して検証後チェックを実行するpostValidate.plスクリプトを実行します。

    postValidate.plスクリプトの一般構文およびスクリプトの実行の詳細は、第6.11項「postValidate.plスクリプトを使用した検証後チェックの実行」を参照してください。

  11. アップグレードしたコンポーネントに応じて、第6.13項「アップグレード後タスク」で説明されている、アップグレード後に必要なタスクを実行します。

  12. IDMHOSTのログ・ファイルをチェックしてアップグレードを確認します。ログ・ファイルは、upgrade.propertiesファイルのLOG_DIRパラメータで指定した場所に作成されます。

4.7 トラブルシューティング

アップグレード・プロセス中に問題が発生した場合は、第6.14項「トラブルシューティング」で回避策を参照してください。

自動アップグレードに関連する既知の問題とその回避策のリストは、『Oracle Fusion Middleware Oracle Identity Managementリリース・ノート』のOracle Identity and Access Managementのアップグレードおよび移行の問題に関する項を参照してください。

  前
前 		 次
次
  ドキュメント・ライブラリへ移動
ライブラリ		 製品リストへ移動
製品		 目次へ移動
目次