Oracle® Fusion Middleware

Oracle Identity and Access Managementパッチ適用ガイド

11g リリース2 (11.1.2.2.0)

E53412-02(原本部品番号:E50311-03)

2014年4月

このドキュメントでは、Oracle Fusion Middleware Identity and Access Management 11g リリース2 (11.1.2.2.0)デプロイへのパッチ適用のプロセスについて説明します。

Oracle Fusion Middleware Oracle Identity and Access Managementパッチ適用ガイド11gリリース2 (11.1.2.2.0)

E53412-02

Copyright © 2014 Oracle and/or its affiliates. All rights reserved.

原本著者: Rekha Kamath

原本協力著者:  Gururaj B.S.

協力者:  Jeremy Banford

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

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

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

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

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

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

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

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

目次

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

1 Oracle Identity and Access Managementのパッチ適用シナリオの理解

2 パッチ適用に使用するOracle Identity and Access Management Lifecycle Toolsの概要

- 2.1 Lifecycle Toolsを使用したOracle Identity and Access Managementへのパッチ適用の概要

- 2.1.1 サポートされる製品

- 2.2 用語

- 2.3 Oracle Identity and Access Management Patch Manager

- 2.3.1 パッチ・セッション

- 2.3.2 パッチ計画

- 2.3.2.1 パッチ計画のフェーズ

- 2.3.2.2 パッチ計画の生成

- 2.4 Oracle Identity and Access Management Patcher

3 Oracle Identity and Access Managementへの手動によるパッチ適用

- 3.1 OPatchを使用したOracle Identity and Access Managementへの手動によるパッチ適用について

- 3.1.1 サポートされる製品

- 3.2 Oracle Identity and Access Managementへの手動によるパッチ適用の手順

4 Lifecycle Toolsを使用したOracle Identity and Access Managementへのパッチ適用

- 4.1 始める前に

- 4.1.1 サポートされている製品にパッチを適用するためのOracle Identity and Access Management Lifecycle Toolsのインストール

- 4.1.2 patchtop-contents.propertiesファイルの検証

- 4.1.3 common.propertiesファイルの検証

- 4.1.4 patch.propertiesファイルの検証

- 4.2 パッチ計画の作成

- 4.2.1 パッチ・トップの準備

- 4.2.2 パッチ計画の作成手順

- 4.2.3 Patch Managerのその他の機能の理解

- 4.3 パッチの適用

- 4.4 アーティファクト変更の適用

- 4.5 代替のパッチ適用シナリオ

- 4.5.1 デプロイ時のパッチ適用

- 4.5.2 切断されたホストへのパッチ適用

- 4.6 パッチ・セッションの監視と問題のトラブルシューティング

- 4.6.1 パッチ・セッションの進捗状況の追跡

- 4.6.2 失敗した手順の再試行

- 4.6.3 パッチ・セッションの中止

- 4.6.4 パッチ・セッションの終了

- 4.6.5 パッチのロールバック

A 自動パッチ適用の画面

- A.1 パッチ計画: 環境内に表示されるホスト

- A.2 パッチ計画: パッチ適用の前提条件フェーズ

- A.3 パッチ計画: パッチ適用前フェーズ

- A.4 パッチ計画: パッチ適用フェーズ

- A.5 progressコマンドのサンプル・レポート

はじめに

このドキュメントでは、Oracle Fusion Middleware Identity and Access Management 11g リリース2 (11.1.2.2.0)デプロイへのパッチ適用のプロセスについて説明します。

対象読者

このドキュメントは、Oracle Identity Managementにパッチを適用する管理者を対象としています。

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

オラクル社のアクセシビリティへの取組みの詳細は、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 Oracle Identity Managementデプロイメント・ガイド

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

表記規則

このドキュメントでは次の表記規則を使用します。

規則

意味

太字

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

イタリック体

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

固定幅フォント

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

1 Oracle Identity and Access Managementのパッチ適用シナリオの理解

この章では、Oracle Identity and Access Management環境にパッチを適用するシナリオの概要について説明します。

次のいずれかの手法を使用して、Oracle Identity and Access Management環境にパッチを適用できます。

- 手動によるパッチ適用
OPatchツールを使用して、既存のOracle Identity and Access Management環境に手動でパッチを適用できます。

Oracle Identity and Access Management環境への手動によるパッチ適用の詳細は、第3章「Oracle Identity and Access Managementへの手動によるパッチ適用」を参照してください。

- 自動パッチ適用
自動パッチ適用には、新しいIdentity and Access Management Lifecycle Toolsの使用が含まれます。このオプションが使用できるのは、Deployment Toolを使用してOracle Identity and Access Management環境を作成した場合のみです。

Deployment Toolを使用したOracle Identity and Access Management環境作成の詳細は、『Oracle Fusion Middleware Oracle Identity and Access Managementデプロイメント・ガイド』を参照してください。

自動パッチ適用の詳細について理解するには、第4章「Lifecycle Toolsを使用したOracle Identity and Access Managementへのパッチ適用」を参照してください。

2 パッチ適用に使用するOracle Identity and Access Management Lifecycle Toolsの概要

この章では、Oracle Identity and Access Management Lifecycle Toolsの一部であるパッチ適用ツールについて説明します。また、これらのツールに関連する概念および用語についても説明します。

この章には次の項が含まれます:

- 第2.1項「Lifecycle Toolsを使用したOracle Identity and Access Managementへのパッチ適用の概要」

- 第2.2項「用語」

- 第2.3項「Oracle Identity and Access Management Patch Manager」

- 第2.4項「Oracle Identity and Access Management Patcher」

2.1 Lifecycle Toolsを使用したOracle Identity and Access Managementへのパッチ適用の概要

Oracle Identity and Access Management Lifecycle Toolsを使用して、自動化されて組み込まれている手法でOracle Identity and Access Management環境にパッチを適用できます。このツールは次の機能を実行します。

- 各環境内で、パッチ・セッション時に各パッチを適用する必要がある場所とタイミングの決定

- セッションの手順を詳細に記述したパッチ計画の作成

- サーバー実行時のすべてのホストに対するパッチ前提条件の検証

- パッチを適用するためのサーバーの停止、必要なパッチの適用およびサーバーの再起動

- 変更を含むパッチの構成またはアーティファクト変更の自動適用

次のツールは、Oracle Identity and Access Management環境での自動パッチ適用に使用されます。

- Patch Manager
Oracle Identity and Access Management Patch Managerは、パッチ計画を生成して、生成されたパッチ・セッションのステータスを指定して制御します。

- Patcher
Oracle Identity and Access Management Patcherは、パッチ計画に従って、パッチ・セッションの手順を実行します。

図2-1は、Lifecycle Toolsを使用してOracle Identity and Access Management環境にパッチを適用するプロセスを示しています。

図2-1 Lifecycle Toolsを使用したOracle Identity and Access Managementへのパッチ適用

2.1.1 サポートされる製品

Oracle Identity and Access Management Patcherは、Oracle Identity and Access Management Deployment Toolがサポートするすべての製品にパッチを適用します。

サポートされる製品の詳細なリストは、『Oracle Fusion Middleware Oracle Identity and Access Managementデプロイメント・ガイド』の「Oracle Identity and Access Managementデプロイメント・ウィザードを使用してデプロイされる製品」を参照してください。

2.2 用語

このドキュメントでは次の用語を使用します。

パッチ

パッチとは、既存のインストールに適用される小型のファイル・コレクションです。パッチはOracle製品の特定のバージョンに関連付けられています。インストール済の対応バージョンの製品にパッチを適用すると、製品のバージョンが多少変更されます。

個別パッチは、特定の不具合に対して顧客が使用できる不具合の修正です。個別パッチを適用するには、特定のベース・リリースまたはパッチ・セットがインストールされている必要があります。これらのパッチはバージョン管理されず、通常将来のパッチ・セットおよび次の製品リリースにおいて、パッチを含む不具合修正が行われます。

層

環境にパッチを適用する場合、Identity and Access Managementデプロイは個別の層に分割され、それぞれの層に特定の製品、Oracle WebLogic Serverドメインおよびサーバー・インスタンスが含まれます。

これらの層には、次のものが含まれます。

- ディレクトリ

- アクセス

- ID

- Web

パッチ計画の生成時には、指定されたパッチが1つ以上の層にマップされます。大部分の製品は単一の層に属していますが、例外がある場合もあります。たとえば、Oracle WebLogic ServerパッチはアクセスとIDの両方の層に適用され、一般的なパッチはすべての層に適用されます。

トポロジ・ストア

トポロジ・ストアとは、環境の作成時にDeployment Toolによって生成されるXMLファイルです。これには、環境に関する物理的および論理的な広範囲にわたる詳細が記載されており、パッチの適用時にLifecycle Toolsによって使用されます。

IAM_TOP

IAM_TOPディレクトリには、バイナリの製品インストールが格納されています。このディレクトリは、Oracle Identity and Access Management環境の作成方法に応じて、マウントされたネットワーク共有またはローカル・ディスクのいずれかに置かれます。環境の作成の詳細は、『Oracle Fusion Middleware Oracle Identity and Access Managementデプロイメント・ガイド』を参照してください。

IAM_LCM_TOP

IAM_LCM_TOPディレクトリには、Patch ManagerおよびPatcherの実行可能ファイル、ツールの動作を制御する様々な構成ファイルを含む、Oracle Identity and Access Management Lifecycle Toolsのインストールが格納されています。

LCM_CONFIG

LCM_CONFIGディレクトリには、トポロジ・ストア、ランタイム・データ、Oracle Identity and Access Management Lifecycle Toolsのログ情報を含む、追加の構成ファイルが格納されています。これには、パッチ・セッションおよび判読可能な計画ファイルが含まれます。

パッチ・トップ

パッチ・トップ・ディレクトリ(PATCH_TOP)には、製品別に解凍済パッチが格納されています。Patch Managerは、PATCH_TOPディレクトリ内の情報をスキャンしてパッチを読み取り、ファイルを検証し、検証後にこれらのパッチを生成したパッチ計画に組み込みます。

2.3 Oracle Identity and Access Management Patch Manager

Oracle Identity and Access Management Patch Managerは、管理ツールとしてパッチ計画を生成し、パッチ・セッションを制御します。Patch Managerは、デプロイの最初のホストからのみ実行できます。Patch Managerは、サーバーの停止や起動などのアクションは実行しません。デプロイに影響を与えるアクションはすべてPatcherにより実行されます。

2.3.1 パッチ・セッション

自動パッチ適用はすべてパッチ・セッション内で実行されます。1つ以上のパッチを適用するためのパッチ・セッション、またはすでに製品に適用されているパッチをロールバックするためのパッチ・セッションを作成できます。

注意:

進行中のパッチ・セッションを停止するには、abortコマンドを実行します。

Patch Managerは、場所LCM_CONFIG/patch/session/にセッション・ファイルを保持して、Patcherによるパッチ・プロセス調整を追跡します。セッション・ファイルには、パッチ・セッションの現在のステータスが記載されています。パッチ・セッションのステータスの詳細は、表4-5を参照してください。

デプロイ内に存在できるのは常に、1つのアクティブなパッチ・セッションのみです。

2.3.2 パッチ計画

パッチ計画は、Patch Managerによって作成され、デプロイにパッチを適用する一連の包括的な手順で構成されます。

2.3.2.1 パッチ計画のフェーズ

パッチ計画は、次の3つのフェーズで構成されます。

- パッチ適用の前提条件フェーズ(すべてのサービスは実行中)
前提条件チェックは実行されますが、デプロイに対する変更は行われません。このフェーズは、システム停止時間を計画してパッチを適用する前に実行できます。問題が発生した場合は、即座に対応できます。これにより、停止時間時に円滑にパッチを適用できます。

- パッチ適用前フェーズ(すべてのサービスは停止)
パッチを適用するために停止する必要があるサーバーはすべて停止されます。このアクションはデプロイで認識されます。たとえば、パッチ・トップがOracle Access Managerパッチのみで構成されている場合、すべてのサーバー・インスタンスを停止する必要はありません。Oracle HTTP ServerとOracle Identity Managerのみ(Oracle Access Managerに応じて)、およびOracle Access Manager自身が停止されます。計画の実行中、Oracle Unified Directoryは稼働したままです。これにより、必要な停止時間が最小限になります。

- パッチ適用フェーズ(限定されたサービスが使用可能)
パッチが適用され、パッチに関連するすべてのアーティファクト変更が実行されて、サーバーが起動されます。

2.3.2.2 パッチ計画の生成

Patch Managerは、次の手順に従ってパッチ計画を生成します。

1. パッチを含み、各製品サブディレクトリ別に分類されているパッチ・トップ・ディレクトリが、ツールに指定されます。ダウンロードしたパッチがすべて解凍されており、パッチのzipファイルがすべてパッチ・トップ・ディレクトリから移動されていることを確認します。

2. パッチ・トップ・ディレクトリがスキャンされ、初期検証が実行されます。

3. デプロイメント・トポロジが読み取られて分析されます。

4. 手順2および手順3で取得された情報が結合され、OPlanユーティリティを使用してパッチ計画が生成されます。パッチ計画は、HTML、プレーン・テキストおよびバイナリ形式で生成され、実行に使用されます。

5. Patch Managerのログ・メッセージが、LCM_CONFIGのlogディレクトリに書き込まれます。

管理者は、Patch Managerを手動で実行して、パッチ適用セッションを開始する必要があります。Patch Managerの実行方法の詳細は、第4.2項を参照してください。

2.4 Oracle Identity and Access Management Patcher

Oracle Identity and Access Management Patcherは、デプロイ内の各ホスト上で、パッチ計画に示されているとおりにパッチ・セッションの手順を完了する実行エンジンです。Patcherは、デプロイ内の特定のホストに適用可能な手順のみを実行します。特定のホスト上での手順が完了したら、Patcherを実行する必要がある次のホストを示すメッセージが表示され、Patcherが終了します。

パッチ計画の別のフェーズが実行されている際に、必要に応じて、パッチ計画の実行時に特定のホスト上でPatcherを複数回実行する必要があります。

3 Oracle Identity and Access Managementへの手動によるパッチ適用

この章では、Deployment Toolを使用して作成されていないOracle Identity and Access Management環境に対して、OPatchユーティリティを使用してパッチを適用する方法について説明します。

Deployment Toolを使用して作成された環境の場合、必要に応じて、OPatchを使用してIdentity and Access Management Lifecycle Tools自身にパッチを適用します。

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

- 第3.1項「OPatchを使用したOracle Identity and Access Managementへの手動によるパッチ適用について」

- 第3.2項「Oracle Identity and Access Managementへの手動によるパッチ適用の手順」

3.1 OPatchを使用したOracle Identity and Access Managementへの手動によるパッチ適用について

OPatchは、Oracle Universal Installerのインストールを必要とするJavaベースのユーティリティです。これは、プラットフォームに依存せず、サポートされるすべてのオペレーティング・システムで実行できます。

Oracle Identity and Access Managementへの手動によるパッチ適用の最初の手順として、製品と互換性のあるOPatchツールの最新バージョンを入手します。

3.1.1 サポートされる製品

Oracle Universal Installerを使用してインストールされたOracle Identity and Access Managementスタックのすべての製品は、OPatchユーティリティを使用して手動でパッチを適用できます。

注意:

- データベースのパッチ適用要件に関連する詳細は、『Oracle Fusion Middlewareリリース・ノート』を参照してください。

- Oracle WebLogic Serverへのパッチ適用に関連する詳細は、Oracle WebLogic Serverにパッチを適用するOracle Smart Updateに関する説明を参照してください。

3.2 Oracle Identity and Access Managementへの手動によるパッチ適用の手順

次の表に、Oracle Identity and Access Managementに手動でパッチを適用するために完了する必要がある手順を示します。

注意:

Oracle Identity and Access Management (11.1.2.2)に手動でパッチを適用するには、Oracle Fusion Middleware 11gリリース1 (11.1.1.7)のドキュメント・ライブラリにある『Oracle Fusion Middlewareパッチ適用ガイド』を参照してください。

表3-1 OPatchを使用したOracle Identity and Access Managementへのパッチ適用のタスク

タスク

説明

詳細の参照先

手順1: OPatchの入手

My Oracle SupportからOPatchの最新バージョンを入手します。

「OPatchの入手」(『Oracle Fusion Middlewareパッチ適用ガイド』)

手順2: 必要なパッチの入手

My Oracle SupportでパッチIDを指定して、必要なパッチを入手します。

「OPatchで適用できるパッチの入手」(『Oracle Fusion Middlewareパッチ適用ガイド』)

手順3: システム要件、動作保証および相互運用性に関する情報の確認

システム環境および構成が、ソフトウェアにパッチを適用するための最低要件を満たしていることを確認します。

「OPatchのシステム要件」(『Oracle Fusion Middlewareパッチ適用ガイド』)

手順4: Middlewareホーム、ドメイン・ホームおよびOracleインスタンスのバックアップ

Middlewareホーム・ディレクトリ(Middlewareホーム内のOracleホーム・ディレクトリを含む)、ローカル・ドメイン・ホーム・ディレクトリ、ローカルOracleインスタンス、およびそのMiddlewareホームを使用するリモート・システム上のドメイン・ホームとOracleインスタンスをバックアップします。

「パッチ適用に関するバックアップとリカバリの考慮事項」(『Oracle Fusion Middlewareパッチ適用ガイド』)

手順5: 手動でパッチを適用する必要があるOracle Identity and Access Management環境に関しての理解

OPatchユーティリティを実行してOracle Identity and Access Managementに手動でパッチを適用する必要がある環境について理解します。

「Fusion Middleware環境でのOPatch」(『Oracle Fusion Middlewareパッチ適用ガイド』)

手順6: OPatchユーティリティを実行して必要なパッチを適用

コマンド行インタフェースで、コマンドを入力してOPatchユーティリティを実行します。

「OPatchの実行」(『Oracle Fusion Middlewareパッチ適用ガイド』)

注意:

OPatchユーティリティの実行中に発生する可能性のある問題をトラブルシューティングするには、『Oracle Fusion Middlewareパッチ適用ガイド』の「Fusion Middleware環境でのOPatchのトラブルシューティング」を参照してください。

4 Lifecycle Toolsを使用したOracle Identity and Access Managementへのパッチ適用

この章では、Lifecycle Toolsを使用してOracle Identity and Access Managementソフトウェアのコンポーネントにパッチを適用する手順について説明します。

内容は次のとおりです。

- 第4.1項「始める前に」

- 第4.2項「パッチ計画の作成」

- 第4.3項「パッチの適用」

- 第4.4項「アーティファクト変更の適用」

- 第4.5項「代替のパッチ適用シナリオ」

- 第4.6項「パッチ・セッションの監視と問題のトラブルシューティング」

4.1 始める前に

Lifecycle Toolsを使用してOracle Identity and Access Managementソフトウェアにパッチを適用する前に、次の前提条件をすべて満たしていることを確認します。

- サポートされている製品にパッチを適用するためのOracle Identity and Access Management Lifecycle Toolsのインストール

- patchtop-contents.propertiesファイルの検証

- common.propertiesファイルの検証

- patch.propertiesファイルの検証

4.1.1 サポートされている製品にパッチを適用するためのOracle Identity and Access Management Lifecycle Toolsのインストール

Oracle Identity and Access Management Lifecycle Toolsをインストールして、Oracle Identity and Access Managementデプロイにパッチを適用するためのパッチ適用関連ツールを入手します。

Oracle Identity and Access Management Lifecycle Toolsの詳細は、『Oracle Fusion Middleware Oracle Identity and Access Managementデプロイメント・ガイド』を参照してください。

Oracle Identity and Access Management Lifecycle Toolsを使用してOracle Identity and Access Management環境をデプロイすると、パッチ適用関連ディレクトリIAM_LCM_TOPおよびLCM_CONFIGが作成されます。

IAM_LCM_TOPには、構成ファイル、実行可能ファイル、スクリプト、およびパッチ適用プロセスを制御する様々な環境変数が記載されたプロパティ・ファイルが格納されています。図4-1に、IAM_LCM_TOPディレクトリの内容を示します。

LCM_CONFIGディレクトリには、いくつかのパッチ適用タスクで使用される、ログ、パッチ計画、トポロジ・ストア、資格証明ストアなどの各種ファイルが格納されています。図4-2に、LCM_CONFIGディレクトリの内容を示します。

表4-1では、IAM_LCM_TOPおよびLCM_CONFIGディレクトリのコンポーネントについて説明します。

図4-1 IAM_LCM_TOPのディレクトリ構造

図4-2 LCM_CONFIGのディレクトリ構造

表4-1 Oracle Identity and Access Managementパッチ適用デプロイのディレクトリ構造

ディレクトリ構造

説明

IAM_LCM_TOP

IAM_LCM_TOP/patch

ソフトウェアにパッチを適用するための構成ファイルおよび実行可能ファイルが格納されています。

IAM_LCM_TOP/patch/bin

UNIXおよびWindowsシステムで実行可能なOracle Identity and Access Management Patch ManagerおよびOracle Identity and Access Management Patcherツール(.sh / .bat)が格納されています。

IAM_LCM_TOP/patch/config

パッチ適用ツールを実行する前に構成可能なpatch.properties、patchtop-contents.properties、iampatchmgr-logging.properties、iampatch-logging.propertiesファイルが格納されています。第4.1.2項および第4.1.4項を参照してください。

IAM_LCM_TOP/common/config

JAVA_HOME、IAM_TOPおよびLCM_CONFIGに関する情報から構成されるcommon.propertiesファイルが格納されています。第4.1.3項を参照してください。

IAM_LCM_TOP/patch/script

サービスの開始または停止、およびアーティファクト適用の際にPatcherが必要とするスクリプトおよびプロパティ・ファイルが格納されています。

LCM_CONFIG

LCM_CONFIG/patch

パッチ・セッションの開始時にPatch Managerによって生成されるステータス・ファイル、ログ、パッチおよびパッチ計画が格納されています。

LCM_CONFIG/patch/patches

セッション時に使用するために、Patch Managerが指定したパッチ・トップから読み取ってステージングする一連のパッチが格納されています。これらのパッチは、Patch Managerがパッチ計画を生成するために使用されます。

LCM_CONFIG/patch/session

マシンが読取り可能な形式のパッチ計画、およびOracle Identity and Access Management Patcherがパッチ適用手順を実行するために使用する、進行中のセッションに関するその他の情報が格納されています。

LCM_CONFIG/patch/status

パッチ計画の各手順の実行状態を追跡する、ホストベースのファイルが格納されています。また、判読可能なHTMLおよびプレーン・テキスト形式のすべての生成済ログ・ファイルおよびパッチ計画も格納されています。

LCM_CONFIG/topology

Oracle Identity and Access Managementデプロイに関する詳細な情報が記載されたトポロジ・ストア・ファイルtopology.xmlが格納されています。さらに、いくつかのパッチ適用タスクでは、IAM_TOP/provisioning/planにあるprovisioning.planファイルも使用されます。

注意:

必要に応じて、common.propertiesファイルおよびpatchtop-contents.propertiesファイルの値を変更してください。これらのファイルを変更する前には、必ずファイルの内容をチェックして、正しい値を設定してください。

4.1.2 patchtop-contents.propertiesファイルの検証

patchtop-contents.propertiesファイルは、IAM_LCM_TOP/patch/config/にあります。指定したパッチ・トップ内の相対パスが宣言され、この下にLifecycle Toolsでサポートされる各製品のパッチを置きます。

patchtop-contents.propertiesファイルを開き、その内容を確認します。

例4-1に、patchtop-contents.propertiesファイルの内容を示します。

例4-1

common=oracle_common/patch
dir=oud/patch
oam=iamsuite/patch/oam
ohs=webtier/patch
ohswg=webgate/patch
oim=iamsuite/patch/oim
soa=soa/patch
wls=smart_update/weblogic

patchtop-contents.propertiesファイルには、すべての製品パッチに対するデフォルトのディレクトリ構造が含まれています。デフォルトのディレクトリ構造を使用せずにパッチを構成する場合は、ファイルを編集してパッチ・トップに対して正しい相対パスを宣言することにより、提供されているすべてのパッチをPatch Managerが正常に検出できるようにします。ファイルのいずれかのパラメータがコメント・アウトされているか、または削除されている場合、Patch Managerはパッチ・トップ内で該当する製品のパッチを検索しません。

IAM_LCM_TOPディレクトリには、次のプロパティ・ファイルも格納されています。

- common.properties

- patch.properties

4.1.3 common.propertiesファイルの検証

common.propertiesファイルは、IAM_LCM_TOP/common/config/にあります。このファイルには、Oracle Identity and Access Managementにパッチを適用するために必要な環境変数JAVA_HOME、IAM_TOPおよびLCM_CONFIGが含まれています。

Oracle Identity and Access Management Patch ManagerおよびOracle Identity and Access Management Patcherを実行する前に、表4-2に記載されている環境変数を設定してください。

表4-2 common.propertiesファイルに記載されている変数

変数

説明

JAVA_HOME

JDKの場所を指し示すパス。

IAM_TOP

Oracle Identity and Access Management製品がインストールされているIAM_TOPの絶対パス。

LCM_CONFIG

Lifecycle Toolsの構成が格納されている絶対パス。

4.1.4 patch.propertiesファイルの検証

patch.propertiesファイルは、IAM_LCM_TOP/patch/config/にあります。このファイルには、低レベルのパッチ適用の詳細に関する、変更可能なプリファレンスが含まれています。大部分の環境においてはこのファイル内のデフォルト値が使用できるため、このファイルを編集する必要はありません。

Oracle Identity and Access Management Patch ManagerおよびOracle Identity and Access Management Patcherツールを実行する前に、表4-3に記載されている環境変数を設定してください。

表4-3 patch.propertiesファイルに記載されている変数

変数

説明

RETURN_MESSAGE_BUFFER_SIZE

実行される各コマンドに対して格納される戻りメッセージのサイズ。このバッファ・サイズには、ログ・ファイルに格納される標準出力とエラー・メッセージが含まれます。

この変数は、コンソールおよびログに出力される出力のサイズに影響を与えます。使用できる単位は次のとおりです。

- B (バイト)

- KB (キロバイト)

- MB (メガバイト)

- GB (ギガバイト)

この変数のデフォルト値は8KBです。

COMMAND_TIMEOUT

この値は、タイムアウト値の後に単位を付けます。

コマンドの実行にこれより長い時間を要する場合は、実行が終了します。

この変数で使用できる単位は次のとおりです。

- ms (ミリ秒)

- s (秒)

- m (分)

- h (時間)

- d (日)

この変数のデフォルト値は3600秒(1時間)です。

注意:

common.propertiesおよびpatch.propertiesファイルは、デプロイ時に移入されます。ただし、単一のOracle Identity and Access Managementデプロイにパッチ適用ツールをインストールして、複数のIAM_TOPを管理している場合は、ファイルからIAM_TOPおよびLCM_CONFIG変数の値を削除して、正しい値を設定する必要があります。

また、記載されているコマンドを使用して、コマンド行インタフェースから環境変数を設定するオプションも用意されています。ただし、環境内で変数を設定する前に、ファイルから既存の値を削除してください。

たとえば、POSIX-compliantシェルを使用している場合は、次のコマンドを実行します。

export JAVA_HOME=jdk_absolute_path

4.2 パッチ計画の作成

Patcherを実行する前に、パッチを適用するホスト上でパッチ計画を生成します。パッチ計画では、デプロイにパッチを適用するための包括的な手順のリストが生成されます。

iampatchmgrユーティリティで様々なコマンドおよびオプションを使用することにより、パッチ計画の生成、パッチ・セッションのロールバック、パッチ・セッションの中断または終了、さらにセッションの進捗状況の監視を行うことができます。第2.3項を参照してください。

注意:

- IAM_TOP環境でPatch Managerを実行します。

- 既存のセッションが完了または強制終了するまで、新しいパッチ・セッションは作成できません。

この項では、パッチ計画の作成方法について説明します。

内容は次のとおりです。

- パッチ・トップの準備

- パッチ計画の作成手順

- Patch Managerのその他の機能の理解

4.2.1 パッチ・トップの準備

Lifecycle Toolsは、パッチ・トップ・ディレクトリ内に編成されたパッチを対象とします。このディレクトリには、解凍され、製品別に分類されたパッチが含まれます。Patch Managerはパッチ・トップ・ディレクトリをスキャンしてパッチを探し、その内容を検証してパッチ・セッションの一環として実行するために準備します。

My Oracle Supportからダウンロードしたパッチを適用するには、Patch Managerが検索、検証および実行できるようパッチ・トップに編成する必要があります。これを行うには、Managerを起動する前に次の手順を実行します。

- パッチ・トップ用のルート・ディレクトリを作成します。任意の名前を使用できます。このパッチ・トップ内に含まれる中身を示す名前を指定することをお薦めします。たとえば、1404-idm-r2ps2-bpです。

- パッチがある製品ごとに1つずつサブディレクトリを作成します。サポートされるすべての製品に対してディレクトリを作成する必要はありません。

注意:

patchtop-contents.propertiesファイル(第4.1.2項を参照)を開き、デフォルトで設定されたか、デプロイ用にパスを追加または変更したかに関係なく、作成したディレクトリが各製品に対して宣言したいずれかの相対パスと一致することを確認します。

- すべてのパッチを解凍し、解凍したディレクトリと各パッチの中身をその製品の正しいパッチ・トップ・ディレクトリにコピーします。たとえば、ダウンロードしたパッチがOAM用で、12345.zipという名前の場合、解凍した12345ディレクトリをPATCH_TOP/iamsuite/patch/oam/12345にコピーします。圧縮されたコピーはパッチ・トップに置くことはできません。

4.2.2 パッチ計画の作成手順

パッチ計画には、Oracle Identity and Access Management環境にパッチを適用するための手順が含まれています。第2.3.2項を参照してください。

Patch Managerを実行して生成した計画は、Oracle Identity and Access Management Patcherにより実行できます。

パッチ計画を作成するには、Oracle Identity and Access Management Patch Managerユーティリティ(iampatchmgr)でapplyコマンドを実行します。

注意:

最初のホストでOracle Identity and Access Management Patch Managerを実行します。

UNIXの場合

IAM_LCM_TOP/patch/bin/iampatchmgr.sh apply -patchtop patch_top_location

Windowsの場合

IAM_LCM_TOP\patch\bin\iampatchmgr.bat apply -patchtop patch_top_location

applyコマンドにより、次のタスクが実行されます。

- 指定したパッチ・トップの場所、およびステータスがACTIVEまたはFAILEDであるパッチ・セッションが存在するかどうかを検証します。存在する場合、新しいセッションは開始されず、現在のセッションの出力が表示されます。

- パッチ・セッションが存在しない場合は、パッチ・トップにおいてpatchtop-contents.propertiesで指定されたとおりにパッチをスキャンします。検出された一連のパッチはLCM_CONFIGディレクトリにコピーされ、パッチ・セッションで使用されます。

- ステージングされたパッチとトポロジ・ストアの情報を使用して、該当する一連のパッチをデプロイに適用する手順を含む計画が生成されます。
計画は、判読可能なHTMLおよびプレーン・テキスト形式のバージョンとして作成され、次の場所に保存されます。

LCM_CONFIG/patch/status/session_ID/manager/log/PatchInstructions.html

LCM_CONFIG/patch/status/session_ID/manager/log/PatchInstructions.text

- パッチ計画は、Oracle Identity and Access Managementデプロイの概要から開始されます。第A.1項を参照してください。
また、計画には、実行する手順、手順の総数、停止時間が必要な手順などの情報が記載されています。第A.2項、第A.3項および第A.4項を参照してください。

Patch Managerは、次の場所にログ・メッセージを書き込みます。

パッチ・セッション外の場合

LCM_CONFIG/patch/status/log/iampatchmgr.log

パッチ・セッション内の場合

LCM_CONFIG/patch/status/session_ID/manager/log/iampatchmgr-session.log

4.2.3 Patch Managerのその他の機能の理解

iampatchmgrユーティリティを次の構文で実行します。

UNIXの場合

IAM_LCM_TOP/patch/bin/iampatchmgr.sh command [-option]

たとえば、次のとおりです。

iampatchmgr.sh abort
IAM_LCM_TOP/patch/bin/iampatchmgr.sh progress -all

Windowsの場合

IAM_LCM_TOP\patch\bin\iampatchmgr.bat command [-options]

たとえば、次のとおりです。

IAM_LCM_TOP\patch\bin\iampatchmgr.sh abort
IAM_LCM_TOP\patch\bin\iampatchmgr.sh progress -all

iampatchmgrユーティリティで使用できるコマンドの詳細は、表4-4を参照してください。

表4-4 Oracle Identity and Access Management Patch Managerのコマンド

コマンド

説明

apply

選択したパッチをデプロイするためのパッチ・セッションを開始します。このコマンドでは、パッチ・トップの場所を指定する必要があります。たとえば、次のようになります。

UNIXの場合

IAM_LCM_TOP/patch/bin/iampatchmgr.sh apply -patchtop patchtop_location

Windowsの場合

IAM_LCM_TOP\patch\bin\iampatchmgr.sh apply -patchtop patchtop_location

詳細は、第4.2.2項を参照してください。

rollback

選択したパッチを削除するためのパッチ・セッションを開始します。このコマンドでは、パッチ・トップの場所を指定する必要があります。たとえば、次のようになります。

UNIXの場合

IAM_LCM_TOP/patch/bin/iampatchmgr.sh rollback -patchtop patchtop_location

Windowsの場合

IAM_LCM_TOP\patch\bin\iampatchmgr.sh rollback -patchtop patchtop_location

詳細は、4.6.5項を参照してください。

abort

計画した手順をすべて完了する前に、パッチ・セッションの実行を停止します。パッチ・セッションのステータスをINCOMPLETEに変更して、Patcherが実行を続行しないようにします。

詳細は、4.6.3項を参照してください。

end

パッチ・セッションを完全に終了して削除します。第4.6.4項を参照してください。

progress

実行中のパッチ・セッションのステータスを表示します。詳細は、4.6.1項を参照してください。

注意:

iampatchmgrコマンドに関する詳細な情報を表示するには、次の構文を使用します。

UNIXの場合

IAM_LCM_TOP/patch/bin/iampatchmgr.sh command -help

Windowsの場合

IAM_LCM_TOP\patch\bin\iampatchmgr.bat command -help

表4-5では、パッチ・セッション時にprogressコマンドを実行した際のステータスについて説明します。

表4-5 パッチ・セッションのステータス

ステータス

説明

ACTIVE

セッションが進行中です。

FAILED

ある手順の実行時に障害が発生したためセッションが停止されました。

ABORTING

管理者がある手順を中止したためセッションが停止されました。

COMPLETE

セッションが完了しました。

INCOMPLETE

手順が実行されたかどうかに関係なく障害が発生しました。

注意:

ステータスCOMPLETEとINCOMPLETEは最終的な状態ですが、FAILEDとABORTINGはリカバリ可能な状態です。

4.3 パッチの適用

Oracle Identity and Access Management Patcherは、パッチを適用する手順を実行するユーティリティです。パッチ計画に従って、パッチ・セッション時にホストに対して製品パッチを適用します。

コマンド行ユーティリティで次のコマンドを実行してPatcherを実行します。

注意:

管理者は、進行中のパッチ適用処理においてPatcherを実行し、既存のデプロイにパッチを適用します。これらのパッチは、Oracle Identity and Access Management製品の特定の不具合、セキュリティ上の問題またはステージングされたパッチに関連する個別のパッチです。

UNIXの場合

IAM_LCM_TOP/patch/bin/iampatch.sh run

Windowsの場合

IAM_LCM_TOP\patch\bin\iampatch.bat run

Oracle Identity and Access Management Patcherのrunコマンドにより、次のタスクが実行されます。

- このコマンドは、ツールが実行されているホストに対して、パッチ・セッションが存在するかどうか、およびステータスがPLANNEDである1つ以上の手順が使用できるかどうかを検証します。このような手順が存在する場合、Patcherは次のようにして引き続き各手順を実行します。

- セッション・ステータスを更新して、この手順のステータスをRUNNINGにします。

- Patcherがこの手順のコマンドを決定して起動します。

- 正常に起動された場合は、該当する手順のステータスがCOMPLETEに変わり、セッションが更新されます。

- 別のホストで次の手順が実行されるか、ある手順の実行に失敗するか、または計画内の手順がなくなるまで、引き続き手順が実行されます。

- 次回Patch Managerのprogressコマンドを実行した際の出力に対して、実行された手順の結果が反映されます。

この構文でprereqオプションを使用することにより、前提条件の検証に関連する手順のみを実行することもできます。これにより、サービスが停止または開始されたり、パッチが適用またはロールバックされることはありません。

Patcherは、次の場所にログ・メッセージを書き込みます。

パッチ・セッション外の場合

LCM_CONFIG/patch/status/log/iampatch.log

パッチ・セッション内の場合

LCM_CONFIG/patch/status/session_ID/manager/log/iampatch-session.log

4.4 アーティファクト変更の適用

Oracle Identity and Access Management Lifecycle Toolsは、構成ファイル内へのエントリの追加、製品のMBeanの起動など、パッチ適用後のアーティファクト変更のアプリケーションをサポートしています。大部分のパッチでは、このような変更は必要ありません。特定のパッチで変更が必要であるかどうかを判別するには、該当するパッチに対応するREADME.txtファイルを参照してください。

変更が必要なパッチの場合、ユーザーが単一の製品に対してバイナリ・パッチ・アプリケーションをすべて実行した後で、Patcherが自動的に変更を実行します。

アーティファクト変更の適用の前提条件

パッチ適用後のアーティファクト変更においては、データベースへの接続、sql問合せの実行などの特定のタスクを実行するために、Perlライブラリを追加する必要があります。

注意:

- システムのPATHにPerl 5バージョン5.8.8以降が存在することを確認してください。

- モジュールのロード時に、Perlが検索するリストのディレクトリ内にDB.pmモジュールが存在することを確認してください(配列@INCを使用して取得することも可能です)。
たとえば、特定のホストにおける@INCの内容は、次のコマンドを使用して取得できます。

perl -le 'print foreach @INC'

アーティファクトのログ・ファイル

アーティファクトのインストール時の出力は、次のログ・ファイルに保存されます。

LCM_CONFIG/patch/status/session_ID/hosts/host_name/log/patch_id-artifactlog

4.5 代替のパッチ適用シナリオ

Oracle Identity and Access Management Lifecycle Toolsは、パッチを適用するための次のシナリオを追加でサポートしています。

- デプロイ時のパッチ適用

- 切断されたホストへのパッチ適用

4.5.1 デプロイ時のパッチ適用

デプロイ・リポジトリ内に存在する製品パッチはすべて、対応する製品のインストールおよび構成時にOracle Identity and Access Management Deployment Toolにより自動的に適用されます。

注意:

デプロイ・リポジトリは、進行中のパッチ適用には使用できません。適用する必要のある、ダウンロードしたパッチを含む別のパッチトップ・ディレクトリを編成する必要があります。

Oracle Identity and Access Management Deployment Toolは、インストール後のパッチをインストールするために、オプションを追加してPatcherを起動します。これらのパッチは、デプロイ・プロセス時のパッチ適用に対してのみ有効です。たとえば、Deployment Toolがサーバーを起動または停止する手順をバイパスできるように、サーバー・インスタンスの構成前にパッチが適用されます。

このリリースでは、実行中のパッチ適用でこのオプションはサポートされていません。

4.5.2 切断されたホストへのパッチ適用

最初のホストを含むネットワーク・セグメントと異なるネットワーク・セグメントにWebおよびDirectory層ホストをデプロイできます。たとえば、通常Web層はネットワークDMZにデプロイされます。このデプロイ構成では、パッチ・セッションに関する情報が含まれる共有LCM_CONFIGディレクトリは、そのようなホストから使用できないことがあります。この場合、そのような切断されたホスト上でOracle Identity and Access Management Patcherを実行するには、次の手順を使用します。

Oracle Identity and Access Management Patch Managerのapplyコマンドを使用して、パッチ計画を生成します。

切断されていないホスト上でrunコマンドを使用してPatcherを実行します。

計画を実行する必要のある次のホストが切断されている場合、次の手順を実行します。

最初のホストで

1. Patch Manager createhostbundleコマンドを実行し、その特定の切断されたホストでPatcherを実行するために必要な最新のセッション情報を含むホスト・バンドルを生成します。

./iampatchmgr.sh createhostbundle

2. 進捗コマンドの実行時、ホスト・バンドルはLCM_CONFIG/patch/status/session_id/hosts/disconnected_host_name/hostbundle-disconnected_host_name.zipに生成されます。
hostbundle-disconnected_host_name.zipファイルには、切断されたホスト上でのPatcherの実行に関する情報が含まれます。

3. バンドルhostbundle-disconnected_host_name.zipを切断されたホストにコピーします。

切断されたホストで

1. Patcher readhostbundleコマンドを使用してホスト・バンドルを読み取ります。

./iampatch.sh readhostbundle -file path_to_the_host_bundle

2. runコマンドを使用してPatcherを実行します。

3. Patcherの実行後、Patcher createhoststatusコマンドを使用して、Patcherの実行結果のステータス情報を含むホスト・ステータス・ファイルを生成します。

./iampatch.sh createhoststatus

4. ホスト・ステータスは、LCM_CONFIG/patch/status/session_id/hosts/disconnected_host_name/hoststatus-disconnected_host_name.zipに生成されます。

5. 生成されたステータスを切断されたホストから最初のホストにコピーします。

最初のホストで

Patch Manager readhoststatusコマンドを使用してステータスを読み取ります。

./iampatchmgr.sh readhoststatus -file path_to_the_host_status

runコマンドを使用して、切断されていないホスト上でのPatcherの実行に進みます。Patcherを実行する次のホストが切断されていることがPatcherから示される場合、この項に示された手順を繰り返します。

4.6 パッチ・セッションの監視と問題のトラブルシューティング

この項では、パッチ・セッションの監視方法、およびPatcherを使用してOracle Identity and Access Managementにパッチを適用する際に発生する可能性がある問題のトラブルシューティング方法について説明します。

内容は次のとおりです。

- パッチ・セッションの進捗状況の追跡

- 失敗した手順の再試行

- パッチ・セッションの中止

- パッチ・セッションの終了

- パッチのロールバック

4.6.1 パッチ・セッションの進捗状況の追跡

パッチ・セッションの状態を追跡するには、progressコマンドを使用します。このコマンドは、パッチ・セッションに関する構成可能なレポートを表示します。

オプション-allを指定してprogressコマンドを実行すると、パッチ・セッションでのホストとそのステータスに関する詳細なリストを表示できます。

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

UNIXの場合

IAM_LCM_TOP/patch/bin/iampatchmgr.sh progress -all

Windowsの場合

IAM_LCM_TOP\patch\bin\iampatchmgr.bat progress -all

第A.5項では、progressコマンドを実行した際に表示されるサンプル・レポートを示しています。

パッチ・セッションのステータスを表示するには、progressコマンドを使用します。表4-6ではパッチ手順のステータスについて説明し、表4-7ではprogressコマンドを実行した際のパッチ・セッションのステータスについて説明します。

使用できるオプション

パッチ・セッションの現在のフェーズにおける個別の手順の詳細なリストを取得するには、progressコマンドでverboseオプションを使用します。パッチ計画内の各手順に関する詳細な情報と関連付けができるように、各手順に手順番号が指定されています。

パッチ・セッション内の全手順の詳細なリストを取得するには、progressコマンドでallオプションを使用します。

表4-6 progressコマンドが実行された際のパッチ手順のステータス

ステータス

説明

PLANNED

Oracle Identity and Access Management Patcherにより、手順が実行されていません。

RUNNING

手順がPatcherにより実行中です。

COMPLETED

手順は正常に実行されました。

FAILED

手順の実行に失敗しました。「失敗した手順の再試行」を参照してください。

表4-7 progressコマンドが実行された際のパッチ・セッションのステータス

ステータス

説明

ACTIVE

パッチ適用が進行中です。

FAILED

パッチ手順で障害が発生したためパッチ適用が停止されました。

ABORTING

パッチ手順が中止されたためパッチ適用が停止されました。

COMPLETE

すべての手順が実行されたことを示す最終的な状態。

INCOMPLETE

ある手順の実行が失敗したかどうかに関係なく、セッションが中止されたことによる最終的な状態。

4.6.2 失敗した手順の再試行

ある手順の実行に失敗したため、パッチ・セッションのステータスがFAILEDになった場合は、下に示すようにretryコマンドを使用して、失敗した手順からセッションの実行の再開を試行できます。

UNIXの場合

IAM_LCM_TOP/patch/bin/iampatch.sh retry

Windowsの場合

IAM_LCM_TOP\patch/bin\iampatch.bat retry

retryコマンドは次の機能を実行します。

- ステータスがFAILEDまたはRUNNINGであるパッチ・セッションが存在するかどうか検証して、ステータスがFAILEDである手順を特定します。
また、失敗した手順を現在のホストから実行する必要があるかどうかも確認します。

- セッションのステータスを更新して、この手順のステータスをRUNNINGにします。全セッション・ステータスをFAILEDからACTIVEに変更します。

- 「パッチの適用」に示されているように、再試行して正常に終了した手順が実行されます。

前提条件のみを実行するには、retryコマンドでprereqオプションを使用します。これにより、サービスが停止または開始されたり、パッチが適用またはロールバックされることはありません。

prereqオプションを指定して、次のコマンドを実行します。

UNIXの場合

IAM_LCM_TOP/patch/bin/iampatch.sh retry -prereq

Windowsの場合

IAM_LCM_TOP\patch\bin\iampatch.bat retry -prereq

4.6.3 パッチ・セッションの中止

abortコマンドにより、パッチ・セッションのステータスをINCOMPLETEに変更して、Patcherが実行を続行しないようにします。

セッションが中止された後にprogressコマンドを実行した場合は、引き続きセッションと手順の詳細が表示されます。中止されたセッションのステータスがFAILEDで、一部またはすべての製品のステータスをパッチ適用を試みる前のステータスに戻す必要がある場合は、セッションと手順の詳細を使用して、Patch Managerのrollbackコマンドに対して指定した正しいパッチ・トップ・ディレクトリをアセンブルできます。

パッチ・セッションを中止するには、次のコマンドを実行します。

UNIXの場合

IAM_LCM_TOP/patch/bin/iampatchmgr.sh abort

Windowsの場合

IAM_LCM_TOP\patch\bin\iampatchmgr.bat abort

4.6.4 パッチ・セッションの終了

パッチ・セッションを終了するには、endコマンドを実行します。このコマンドにより、パッチ・セッションが完全に削除されます。

セッションを終了した後にprogressコマンドを実行した場合は、セッションが存在しないためレポートは生成されません。セッション時に生成されたログ・ファイルはすべて保存されるため、必要な場合はそのログ・ファイルを調べて、セッションに関する情報を取得できます。実行されているセッションの現在のステータスに関係なくセッションを終了するために、管理者はendコマンドを使用できます。

パッチ・セッションを終了するには、次のコマンドを実行します。

UNIXの場合

IAM_LCM_TOP/patch/bin/iampatchmgr.sh end

Windowsの場合

IAM_LCM_TOP\patch\bin\iampatchmgr.bat end

4.6.5 パッチのロールバック

層に適用したパッチをロールバックするためのセッションを作成できます。現在の層、またはすでにパッチを適用した層でパッチをロールバックするには、新しいロールバック・セッションを開始します。

パッチをロールバックするには、次の手順を実行します。

1. rollbackコマンドを実行して、パッチ計画を作成します。
UNIXの場合

IAM_LCM_TOP/patch/bin/iampatchmgr.sh rollback -patchtop patchtop_location

Windowsの場合

IAM_LCM_TOP\patch\bin\iampatchmgr.bat rollback -patchtop patchtop_location

2. 第4.3項の説明に従って、Patcherを実行します。

rollbackコマンドにより、次のタスクが実行されます。

- 指定したパッチ・トップの場所、およびステータスがACTIVEまたはFAILEDであるパッチ・セッションが存在するかどうかを検証します。セッションが存在する場合、新しいセッションは開始されず、現在のセッションの出力が表示されます。

- パッチ・セッションが存在しない場合は、内部的にパッチ・スキャナが起動され、指定したパッチ・トップの場所でパッチが生成されて検証されます。ステージングされたこのパッチは、パッチ計画を生成するために内部的に使用されます。

- パッチをロールバックする手順において、トポロジ・ストア情報とステージングされたパッチを使用してパッチ計画が生成されます。

- rollbackコマンドにより、パッチ計画がHTMLおよびテキスト形式で次の場所に生成されます。

LCM_CONFIG/patch/status/session_ID/manager/log/PatchInstructions.html
LCM_CONFIG/patch/status/session_ID/manager/log/PatchInstructions.text

- パッチ計画の生成後、Patch ManagerはステータスがACTIVEである新しいパッチ・セッションを開始します。次に、パッチ・セッションの下位として、各ホストで実行されている手順に対してステータスPLANNEDを追加します。Patch Managerは、パッチ・セッションの詳細をログ・ファイルに保存します。

- rollbackコマンドにより、参照用のログ・ファイルが生成されます。

A 自動パッチ適用の画面

この付録では、Oracle Identity and Access Management Lifecycle Toolsの実行時の画面について、スクリーンショットとその説明を示します。

次のスクリーンショットについて説明します。

- 第A.1項「パッチ計画: 環境内に表示されるホスト」

- 第A.2項「パッチ計画: パッチ適用の前提条件フェーズ」

- 第A.3項「パッチ計画: パッチ適用前フェーズ」

- 第A.4項「パッチ計画: パッチ適用フェーズ」

- 第A.5項「progressコマンドのサンプル・レポート」

A.1 パッチ計画: 環境内に表示されるホスト

この図は、Oracle Identity and Access Management Patch Managerの実行時に生成されるパッチ計画に表示されるホストの例を示しています。この計画には、パッチが適用される順序に並べられたホスト、およびそれら各ホスト上のコンポーネントの一覧が表示されます。

A.2 パッチ計画: パッチ適用の前提条件フェーズ

この図は、パッチ計画のパッチ適用の前提条件フェーズに表示される手順の例を示しています。また、パッチ適用の最初のフェーズにおいてホストで計画されている手順の一覧も表示しています。

A.3 パッチ計画: パッチ適用前フェーズ

この図は、パッチ計画のパッチ適用前フェーズに表示される手順の例を示しています。また、パッチ適用の2番目のフェーズにおいてホストで計画されている手順の一覧も表示しています。

A.4 パッチ計画: パッチ適用フェーズ

この図は、パッチ計画のパッチ適用フェーズに表示される手順の例を示しています。また、パッチ適用の3番目のフェーズにおいてホストで計画されている手順の一覧も表示しています。

A.5 progressコマンドのサンプル・レポート

この図は、progressコマンドを-allオプションを指定して実行した際に表示されるサンプル・レポートを示しています。

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

コピーライトについて

Copyright © 1994-2015, 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）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

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

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

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

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

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