このドキュメントでは、Oracle Unified Directoryのバンドル・パッチ12.2.1.4.200204について説明します。

このReadmeドキュメントでは、Oracle Unified Directory 12c (12.2.1.4.0)のベース・インストールが必要です。内容は次のとおりです。

ノート:

OUDバンドル・パッチ12.2.1.4.200204のリリース後にドキュメント化された問題については、My Oracle Supportにログインしてください。「ナレッジ・ベースの検索」フィールドに2602696.1を入力します。これは、Oracle Fusion Middleware 12.2.1.4.0の既知の問題について説明しているドキュメントのIDです。

1.1 バンドル・パッチについて

この項では、バンドル・パッチについて説明し、またバンドル・パッチ、個別パッチ(別名、パッチ・セット例外)、およびパッチ・セットの違いについて説明します。

1.1.1 バンドル・パッチ

バンドル・パッチは、Oracle Unified Directoryに対するOracleの公式パッチです。バンドル・パッチ・リリース文字列の5桁目は、バンドル・パッチ番号を示していました。2015年11月、バージョン番号の形式が変更されました。新しい形式では、バンドル・バージョンの5桁目の数値は、「YYMMDD」形式のリリース日付に置換されます。

  • YYは西暦年の下2桁です。

  • MMは数値形式の月です(2桁)。

  • DDは数値形式の日付です(2桁)。

各バンドル・パッチには、1つ以上のフィックスを実装するために再構築されたライブラリおよびファイルが含まれます。バンドル・パッチ内のフィックスはすべてテストされ、相互の動作が保証されています。各バンドルは累積されます。つまり、最新のバンドル・パッチには、同じリリース用の以前のバンドル・パッチのすべてのフィックスが含まれます。

1.1.2 個別パッチ

バンドル・パッチとは異なり、個別パッチは、単一のコンポーネントの1つの問題にのみ対処していました。各個別パッチは、正式なOracleパッチですが、完全な製品ディストリビューションではなく、すべてのコンポーネント用のパッケージは含まれていませんでした。個別パッチには、特定のコンポーネントの特定の修正を実装するために再構築されたライブラリおよびファイルのみが含まれていました。

個別セキュリティ、例外リリース、x-fix、PSE、MLRまたはホットフィックスとして個別パッチを理解する必要もあります。

1.1.3 パッチ・セット

パッチ・セットは、十分にテストされ統合された製品の修正を提供するメカニズムです。パッチ・セットには、新機能が含まれる場合があります。各パッチ・セットには、不具合の修正(および存在する場合は新機能)を実装して再構築されたライブラリおよびファイルが含まれます。ただし、パッチ・セットは完全なソフトウェア配布ではない場合もあり、すべてのプラットフォームのすべてのコンポーネント用のパッケージが含まれていないことがあります。パッチ・セットのすべての修正はテスト済であり、指定されたプラットフォームで互いに機能することが動作保証されています。

1.2 バンドル・パッチの推奨事項

オラクル社では、アイデンティティ管理製品の依存ミドルウェア・コンポーネントのパッチを動作保証しており、お客様はこれらの動作保証済パッチを適用するようお薦めします。これらのパッチの詳細は、https://support.oracle.comのノートCertification of Underlying or Shared Component Patches for Identity Management Products (Doc ID 2627261.1)を参照してください。

1.3 バンドル・パッチの要件

この項では、今回のリリースのOUDバンドル・パッチ要件について説明します。

バンドル・パッチを適用または削除する前に、次のステップを完了します:

  • OPatchバージョンが13.9.4.2.2以上であることを確認します。

    1. 次の場所のMy Oracle Supportにアクセスして、ログインします。

      https://support.oracle.com/

    2. 「ナレッジ・ベースの検索」フィールドに1587524.1を入力します。これは、Oracle Fusion Middleware 12cでのOUI NextGen OPatch 13の使用について説明しているドキュメントのIDです。

    3. 検索結果から、ドキュメントID 1587524.1に対応するリンクをクリックします。

    4. ドキュメントで、パッチ28186730リンクをクリックすると、OPatch 13.9.4.2.2を入手できる画面が表示されます。

  • OUIインベントリを確認します:

    OPatchは、パッチを適用するために有効なOUIインベントリにアクセスする必要があります。次のコマンドで、OUIインベントリを確認してください。

    UNIX

    $ opatch lsinventory

    Windows

    opatch.bat lsinventory

    コマンドでエラーが発生した場合は、続行する前にOracleサポートに連絡してインベントリ設定を検証および確認します。

  • 実行可能ファイルがシステムPATHに表示されることを確認してください。

    UNIX

    $ which opatch

    $ which unzip

    Windows

    where opatch.bat

    where unzip

    コマンドでエラーが発生した場合は、続行する前にOracleサポートに連絡してインベントリ設定を検証および確認します。これらの実行可能ファイルのどちらもPATHに表示されない場合、続行する前に問題を修正してください。

  • 解凍されたパッチを格納する場所を作成します。この場所は、この後ドキュメント内でPATCH_TOPと示されます。

1.4 バンドル・パッチの適用前

この項では、バンドル・パッチを適用する前の要件について説明します。

このバンドル・パッチを適用する前の前提条件は次のとおりです:

  1. OUDSMにパッチを適用するため、アプリケーション・サーバー・インスタンスを準備します。

    管理サーバー(OUDSM用のWebLogicドメイン)を停止します。

    ノート:

    このバンドル・パッチを適用する前に、「ドキュメントの更新」の「OUDSMの自動再デプロイメントの手順」を確認しておく必要があります。

  2. ORACLE_HOME環境変数をOracle Middlewareホームの場所(OUDのインストール先)に設定します。

    次に例を示します。

    UNIX

    $ <bash> export ORACLE_HOME="Oracle Middleware Home Location"

    Windows

    <prompt> set ORACLE_HOME="Oracle Middleware Home Location"

  3. 次のコマンドを実行して、ORACLE_HOMEが正しく設定されていることを確認します。

    UNIX
    ls $ORACLE_HOME/OPatch/opatch

    Windows

    dir %ORACLE_HOME%\OPatch\opatch.bat

  4. ドメイン構成に応じて、Oracle Unified Directory Services Manager (OUDSM)がインストールされているすべてのディレクトリ・サーバー・インスタンスおよびドメインを停止します。

    スタンドアロンOracle Unified Directoryサーバーの停止

    Oracle Unified Directoryを「スタンドアロンOracle Unified Directory Server (WebLogic Serverとは切り離して管理)」モードでインストールした場合、start-dsコマンドを使用してすべてのディレクトリ・サーバー・インスタンスを停止します。

    UNIX
    ORACLE_HOME/INSTANCE_NAME/OUD/bin/stop-ds

    Windows

    ORACLE_HOME\INSTANCE_NAME\OUD\bat\stop-ds.bat

    同じ場所に配置されたOracle Unified Directoryサーバーの停止

    Oracle Unified Directoryを「同じ場所に配置されたOracle Unified Directory Server (WebLogic Server経由で管理)」モードでインストールした場合、次のステップを完了します:

    1. コマンドライン・インタフェースから次のコマンドを実行して、OUDインスタンスを停止します。

      UNIX

      DOMAIN_HOME/bin/stopComponent.sh INSTANCE_NAME

      Windows

      DOMAIN_HOME\bin\stopComponent.bat INSTANCE_NAME
    2. ノード・マネージャを停止します。

      UNIX

      DOMAIN_HOME/bin/stopNodeManager.sh

      Windows

      DOMAIN_HOME\bin\stopNodeManager.cmd
    3. Oracle WebLogic管理サーバーを停止します。

      UNIX

      DOMAIN_HOME/bin/stopWebLogic.sh

      Windows

      DOMAIN_HOME\bin\stopWebLogic.cmd

    単一ドメインで構成されたOracle Directory Integration PlatformおよびOUDSMの停止

    単一ドメインでOUDSMおよびOracle Directory Integration Platformを追加した場合、管理サーバーと管理対象サーバーを停止する必要があります。

    1. Oracle Directory Integration Platform管理対象サーバーを停止します:

      UNIX
      DOMAIN_HOME/bin/stopManagedWebLogic.sh

      Windows

      DOMAIN_HOME\bin\stopManagedWebLogic.cmd

    2. Oracle WebLogic管理サーバーを停止します:

      UNIX
      DOMAIN_HOME/bin/stopWebLogic.sh

      Windows

      DOMAIN_HOME\bin\stopWebLogic.cmd

ノート:

OUDのインストール・ディレクトリの詳細は、Oracle Unified Directoryのインストール・ディレクトリの理解に関する項を参照してください。

1.5 Oracleパッチ・メカニズム(Opatch)の使用

ノート:

My Oracle SupportからOPatchの最新バージョン(バージョン13.9.4.2.2)を入手する必要があります。OPatchでパッチを適用するには、有効なOracle Universal Installer (OUI)インベントリへのアクセス権が必要です。

パッチ適用プロセスでは、unzipとOpatchの両方の実行可能ファイルが使用されます。ORACLE_HOME環境をソースにした後、パッチ適用前にこれらの両方が存在していることを確認することをお薦めします。Opatchには、次でアクセスできます: 

$ORACLE_HOME/OPatch/opatch

OPatchが起動すると、パッチを検証して、$ORACLE_HOMEにすでにインストールされているソフトウェアとの競合がないことを確認します。

  • $ORACLE_HOMEにすでに適用されているパッチとの競合が見つかった場合、パッチのインストールを停止して、Oracleサポート・サービスまで連絡してください。
  • $ORACLE_HOMEにすでに適用されているサブセット・パッチとの競合が見つかった場合は、バンドル・パッチの適用を続行します。新しいパッチのインストールが開始される前に、サブセット・パッチが自動的にロールバックされます。最新のバンドル・パッチには、$ORACLE_HOME内の以前のバンドル・パッチのすべてのフィックスが含まれます。

このバンドル・パッチでは、-autoフラグは有効化されていません。-autoフラグなしの場合、サーバーが実行中である必要はありません。デフォルトのインストールでは、マシン名とリスニング・アドレスは空白でかまいません。

関連項目:

OPatchによるパッチ適用

OPatchのバージョンの識別

一般に、Oracle Universal Installerソフトウェアのバージョンごとに利用可能なOPatchのバージョンがあります。

OPatchのバージョンを識別するには:
  1. ディレクトリを次のディレクトリに変更します。:
    cd ORACLE_HOME/OPatch/
  2. 次のコマンドを実行します。
    ./opatch version

    次に例を示します。

    ./opatch version
OPatch Version: 13.9.4.2.2

OPatch succeeded.

1.6 バンドル・パッチの適用

  1. パッチのzipファイルをPATCH_TOPに解凍します( PATCH_TOPはインストール用にパッチが一時的に格納されるディレクトリ・パスです)。

    UNIX

    $ unzip -d PATCH_TOP p30851280_122140_Generic.zip

    Windows

    unzip -d PATCH_TOP p30851280_122140_Generic.zip

    ノート:

    Windowsのunzipコマンドには、パス名に256文字しか使用できないという制限があります。これが発生した場合、7-Zipなどの代替ZIPユーティリティを使用して、パッチを解凍します。たとえば、次のコマンドを実行して、7-Zipを使用して解凍します:
    "c:\Program Files\7-Zip\7z.exe" x p30851280_122140_Generic.zip
  2. 現行ディレクトリを、パッチがあるディレクトリに設定します。たとえば、次のようにします。

    UNIX

    $ cd PATCH_TOP/30851280

    Windows

    cd PATCH_TOP\30851280
  3. OPatchを実行してパッチを適用します。

    UNIX

    $ [ORACLE_HOME]/OPatch/opatch apply

    Windows

    [ORACLE_HOME]\OPatch\opatch.bat apply
OPatchが起動すると、パッチを検証して、ORACLE_HOMEにすでにインストールされているソフトウェアとの競合がないことを確認します。

  • ORACLE_HOMEにすでに適用されているパッチとの競合。

    この場合、パッチのインストールを中止して、Oracleサポート・サービスにお問い合せください。

  • ORACLE_HOMEにすでに適用されているサブセット・パッチとの競合。

    この場合、新しいパッチにはORACLE_HOMEの既存のパッチの修正がすべて含まれているので、インストールを続行してください。

1.7 バンドル・パッチの適用後

バンドル・パッチの適用後、特定のタスクを実行する必要があります

  1. Oracle Unified Directoryインストールにパッチが適用されていることを確認します。たとえば、次のようにします。
    UNIX
    $ [ORACLE_HOME]/<dsInstanceName>/OUD/bin/start-ds -F
    Windows
    [ORACLE_HOME]\<dsInstanceName>\OUD\bat\start-ds.bat -F

    ノート:

    OUDパッチ・バージョンは、ビルドID、プラットフォームのバージョンおよびラベル識別子フィールドの値に基づいて、出力から決定されます。
  2. ドメイン構成に応じて、すべてのディレクトリ・サーバー・インスタンスを再起動します。

    スタンドアロンOracle Unified Directoryサーバーの再起動

    Oracle Unified Directoryを「スタンドアロンOracle Unified Directory Server (WebLogic Serverとは切り離して管理)」モードでインストールした場合、start-dsコマンドを使用してすべてのディレクトリ・サーバー・インスタンスを再起動します。次に例を示します。

    UNIX

    $ [ORACLE_HOME]/<dsInstanceName>/OUD/bin/start-ds

    Windows

    [ORACLE_HOME]\<dsInstanceName>\OUD\bat\start-ds.bat

    同じ場所に配置されたOracle Unified Directoryサーバーの再起動

    Oracle Unified Directoryを「同じ場所に配置されたOracle Unified Directory Server (WebLogic Server経由で管理)」モードでインストールした場合、次のステップを完了します:

    1. Oracle WebLogic管理サーバーを再起動します。

      UNIX

      DOMAIN_NAME/bin/startWebLogic.sh

      Windows

      DOMAIN_HOME\bin\startWebLogic.cmd
    2. ノード・マネージャを起動します。

      UNIX

      $DOMAIN_NAME/bin/startNodeManager.sh

      Windows

      DOMAIN_HOME\bin\startNodeManager.cmd
    3. コマンドライン・インタフェースから次のコマンドを実行して、OUDインスタンスを起動します。

      UNIX

      startComponent.sh INSTANCE_NAME

      次に例を示します。

      $DOMAIN_HOME/bin/startComponent.sh oud1

      oud1は、WLSTを使用して作成されたインスタンス名/サーバー名です

      Windows

      startComponent.bat INSTANCE_NAME

      次に例を示します。

      DOMAIN_HOME\bin\startComponent.bat oud1

      oud1は、WLSTを使用して作成されたインスタンス名/サーバー名です

  3. OUDSM用のWeblogicドメインを作成および構成した場合、管理サーバーを再起動する必要があります。アプリケーション・サーバー・インスタンスにパッチの新しいoudsm.earファイルの再デプロイを許可します。

    ノート:

    WebLogicで、管理サーバー(OUDSM用のWebLogicドメイン)を起動します。

    「ドキュメントの更新」の「OUDSMの自動再デプロイメントの手順」を参照してください。

  4. 単一ドメインでOUDSMおよびOracle Directory Integration Platformを追加した場合、管理サーバーと管理対象サーバーを起動する必要があります。

    1. Oracle WebLogic管理サーバーを再起動します。

      UNIX
      DOMAIN_HOME/bin/startWebLogic.sh

      Windows

      DOMAIN_HOME\bin\startWebLogic.cmd

    2. Oracle Directory Integration Platform管理対象サーバーを起動します:

      UNIX
      DOMAIN_HOME/bin/startManagedWebLogic.sh <wls_ods1> <ADMIN_SERVER_URL>

      Windows

      DOMAIN_HOME\bin\startManagedWebLogic.cmd <wls_ods1> <ADMIN_SERVER_URL>

      ここで、managed_server_nameは管理対象サーバーの名前(デフォルト値はwls_ods1)、admin_urlはドメインの管理サーバーのリスニング・アドレス(ホスト名、IPアドレスまたはDNS名)およびポート番号です。

1.8 ファイル・ベース・アクセス制御ログ・パブリッシャの作成

このステップは省略可能です。ACI評価を診断するためにファイル・ベース・アクセス制御ログ・パブリッシャを作成できます。このパブリッシャはサーバー・パフォーマンスに影響を与えるため、診断が終了したらただちに無効化する必要があります。

ノート:

このパブリッシャが作成されると、サーバーは起動できなくなるため、このパッチのアンインストールは不可となります。

ファイル・ベースのアクセス制御ログ・パブリッシャを作成するには、サーバー管理者が、すでに稼働中であるサーバー・インスタンスに対して次のdsconfigコマンドを呼び出す必要があります。 

dsconfig create-log-publisher \
         --publisher-name "ACI logger" \
         --type file-based-access-control \
         --set enabled:true \
         --set log-file:logs/acilog \
         --hostname serverHostName --port 4444 \
         --trustAll --bindDN cn=Directory\ Manager \
         --bindPasswordFile passwordFile \
         --no-prompt

次のエントリは、config.ldif:サーバー構成ファイルで作成されます: 

dn: cn=ACI logger,cn=Loggers,cn=config
         objectClass: ds-cfg-log-publisher
         objectClass: ds-cfg-access-control-log-publisher
         objectClass: ds-cfg-file-based-access-control-log-publisher
         objectClass: top
         ds-cfg-enabled: true
         ds-cfg-java-class: org.opends.server.loggers.accesscontrol.TextAccessControlLogPublisher
         ds-cfg-asynchronous: true
         cn: ACI logger
         ds-cfg-log-file-permissions: 640
         ds-cfg-log-file: logs/acilog

1.9 バンドル・パッチの削除

バンドル・パッチのインストール後に問題が発生した場合は、バンドル・パッチを削除できます。

次のコマンドを実行してバンドル・パッチを削除します。

  1. ORACLE_HOME環境変数をOracle Middlewareホームの場所(Oracle Unified Directoryがインストールされている場所)に設定します。

    UNIX

    $ <bash> export ORACLE_HOME="Oracle Middleware Home Location"

    Windows

    <prompt> set ORACLE_HOME="Oracle Middleware Home Location"
  2. 次のコマンドを実行して、OUIインベントリを確認します:

    UNIX

    $ [ORACLE_HOME]/OPatch/opatch lsinventory

    Windows

    [ORACLE_HOME]\OPatch\opatch.bat lsinventory
  3. OPatchを実行してパッチをアンインストールします:

    UNIX

    $ [ORACLE_HOME]/OPatch/opatch rollback -id 30851280
    Windows
    [ORACLE_HOME]\OPatch\opatch.bat rollback -id 30851280
  4. このパッチの適用後に作成されたディレクトリ・サーバー・インスタンスの場合、パッチが削除されると、インスタンスbuildinfoは次のようになります。
    $ cat [ORACLE_HOME]/<dsInstanceName>/OUD/config/buildinfo 12.2.1.4.200204.2002040508
  5. インスタンスbuildinfoを手動で変更し元に戻す必要があります。
    $ cp [ORACLE_HOME]/oud/config/buildinfo [ORACLE_HOME]/<dsInstanceName>/OUD/config/buildinfo
    次に例を示します。 
    $ cat [ORACLE_HOME]/<dsInstanceName>/OUD/config/buildinfo 12.2.1.4.xxxxxx.xxxxxxxxxx
  6. バンドル・パッチを削除した後、次のコマンドを実行してOUDインスタンスを起動します:
    UNIX
    $ [ORACLE_HOME]/<dsInstanceName>/OUD/bin/start-ds
    Windows
    [ORACLE_HOME]\<dsInstanceName>\OUD\bat\start-ds.bat

1.10 解決された問題

この項では、12cリリースで解決された問題を示します。

1.10.1 OUDバンドル・パッチ12.2.1.4.200204で解決された問題

次の表はOUDバンドル・パッチ12.2.1.4.200204で解決された問題を示しています:

表1-1 OUDバンドル・パッチ12.2.1.4.200204で解決された問題:

バグ番号 説明
30645038 OUD 12.2.1.3 JAN'20 BP - 新規追加されたCORE-ENTRYCACHEテストのいくつかがファーム実行で失敗する
30265103 OUD11G - BP前のDS-RLIM-IDLE-TIME-LIMIT属性は秒単位だが、BP後はミリ秒単位
30367492 ホストを0.0.0.0に解決するためアンインストールが失敗する
29885985 RIが有効な場合、ユーザーが存在していなくてもOUDによってグループへのユーザーの追加が許可される
29661762 カスタム・パスワード・ポリシーには個別の"PASSWORDSTORAGESCHEME"が必要
30074000 バグ30074000のフィックス
29682036 LEFT-OUTER-JOIN付きのFORKJOIN WFEが機能しない
28135591 数値で始まるDENIED-CLIENTホスト名を指定できない
29945677 ISMEMBEROF部分文字列検索フィルタによってエントリが何も返されない
30094884 バグ29724794のリグレッション
29418242 (JE 7.0.7)次が原因で環境を閉じる必要がある: COM.SLEEPYCAT.JE.THREADINTERRU

1.11 既知の問題と回避策

この項では、現在のリリースでの既知の問題について説明します。

Oracle Unified Directoryリリース12c (12.2.1.4.0)の既知の問題およびその回避策は、『Oracle Identity Managementリリース・ノート』ドキュメントのOracle Unified Directoryの章に記載されています。このリリース・ノート・ドキュメントには、次のURLのOracle Identity Managementドキュメント・ライブラリからアクセスできます。

https://docs.oracle.com/en/middleware/idm/suite/12.2.1.4/idmrn/index.html

このOUDバンドル・パッチ・リリース(12.2.1.4.200204)のリリース後にドキュメント化された問題については、https://support.oracle.comにあるMy Oracle Supportドキュメント2602696.1を参照してください。

OPatchの問題の詳細は、My Oracle Supportを参照し、製品に提供されているOPatchバージョンを使用してください。

1.12 ドキュメントの更新

この項では、このリリースのドキュメントの更新について説明します。

ノート:

次のURLで『Oracle Unified Directory SCIM REST API』および『Oracle Unified Directory Data Management REST API』を参照してください: https://docs.oracle.com/en/middleware/idm/unified-directory/12.2.1.4/oudsr/index.htmlおよびhttps://docs.oracle.com/en/middleware/idm/unified-directory/12.2.1.4/ouddr/index.html

OUDSMの自動再デプロイメントの手順

次のoudsm.earファイルは、OUDバンドル・パッチ12.2.1.4.200204に付属しています:

bppatchnumber/files/oracle.idm.oud.odsm/12.2.1.4.0/oracle.idm.oud.odsm.symbol/odsm/oudsm.ear

これは、次の場所でパッチが適用されます:

ORACLE_HOME/oud/odsm/oudsm.ear

パッチの適用後サーバーを初めて再起動すると、新しいoudsm.earファイルが自動的に再デプロイされます。このため、サーバーの再起動が遅くなる場合があります。oudsm.earファイルのデプロイメントに関連するログを確認する必要があります。

何らかの理由で、サーバーの最初の再起動中にoudsm.earファイルのデプロイメントが失敗した場合、ファイルを手動で再デプロイする必要があります。

1.13 関連ドキュメント

詳細は、次のリソースを参照してください。

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

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

Oracle Supportへのアクセス

サポートを購入したオラクル社のお客様は、My Oracle Supportを介して電子的なサポートにアクセスできます。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info)か、聴覚に障害のあるお客様は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。