7 Concurコネクタのアップグレード

Concurコネクタのバージョン11.1.1.5.0をすでにデプロイしている場合は、Oracle Identity Managerデータベースに新しいコネクタJARファイルをアップロードして、コネクタをバージョン12.2.1.3.0にアップグレードできます。

ノート:

アップグレード手順を実行する前に、次の手順を実行します。
  • Oracle Identity Managerデータベースのバックアップを作成することを強くお薦めします。バックアップの作成の詳細は、データベースのドキュメントを参照してください。

  • ベスト・プラクティスとして、最初にテスト環境でアップグレード手順を実行します。

次の項では、コネクタをアップグレードする手順について説明します。

関連項目:

これらのステップの詳細は、『Oracle Fusion Middleware Oracle Identity Managerの管理』コネクタのアップグレードに関する項を参照してください

7.1 アップグレード前のステップ

コネクタのアップグレード前のステップでは、リコンシリエーションを実行してターゲット・システムからレコードをフェッチし、Oracle Identity Managerでソース・コネクタを定義し、コネクタのコピーを作成し(ターゲット・システムの複数のインストールでコネクタを構成する場合)、すべてのスケジュール済ジョブを無効にします。

次のアップグレード前のステップを実行します。

  1. リコンシリエーションを実行して、Oracle Identity Managerに対するすべての最新更新をフェッチします。
  2. Oracle Fusion Middleware Oracle Identity Managerの管理で、コネクタのライフサイクルの管理に記載されているアップグレード前の手順を実行します。
  3. Oracle Identity Managerで、ソース・コネクタ(アップグレードする必要がある以前のリリースのコネクタ)を定義します。ソース・コネクタを定義して、コネクタに対して行われたすべてのカスタマイズ変更でデプロイメント・マネージャXMLファイルを更新します。詳細は、Oracle Fusion Middleware Oracle Identity Managerの管理コネクタ・ライフサイクルの管理を参照してください。
  4. 必要に応じて、ソース・コネクタのクローン用のコネクタXMLファイルを作成します。
  5. すべてのスケジュール済ジョブを無効化します。

7.2 アップグレードのステップ

これは、ステージング環境と本番環境の両方のコネクタをアップグレードする手順のサマリーです。

コネクタをアップグレードする環境に応じて、次のいずれかのステップを実行します。
  • ステージング環境

    ウィザード・モードを使用してアップグレード手順を実行します。

    ノート:

    ITリソース・タイプ定義をアップグレードしないでください。デフォルト設定を保持するために、ITリソース定義を"None"にマップする必要があります。

  • 本番環境

    サイレント・モードを使用してアップグレード手順を実行します。

ウィザードおよびサイレント・モードの詳細は、Oracle Fusion Middleware Oracle Identity Managerの管理コネクタ・ライフサイクルの管理に関する項を参照してください。

7.3 アップグレード後のステップ

アップグレード後のステップでは、新しいコネクタJARのアップロード、ソース・コネクタのアップグレードされたITリソースの構成、コネクタ・サーバーJARの更新、参照定義の重複エントリの削除を行います。

次の手順を実行します。
  1. 古いコネクタJARを削除します。Oracle Identity Manager JAR削除($ORACLE_HOME/bin /DeleteJars.sh)ユーティリティを実行して、既存のICFバンドルorg.identityconnectors.genericrest-1.0.11150.jarをOracle Identity Managerデータベースから削除します。JAR削除ユーティリティを実行すると、Oracle Identity Manager管理者のログイン資格証明、Oracle Identity Managerホスト・コンピュータのURL、コンテキスト・ファクトリの値、削除するJARファイルのタイプおよび削除するJARファイルの名前を入力するように要求されます。JARタイプの値として4を指定します。
  2. 次のようにして、新しいコネクタJARをアップロードします。
    1. コネクタJARをアップロードするためのJARアップロード・ユーティリティ($ORACLE_HOME/bin/UploadJars.sh)を実行します。
    2. bundle/org.identityconnectors.genericrest-12.3.0.jarをICFBundleとしてアップロードします。
    3. Lookup.Concur.Configuration参照定義で次のCode KeyおよびDecodeエントリを削除します。Code Key: Bundle Version; Decode: 1.0.1115 Code Key: relURIs; Decode: "__ACCOUNT__.CREATEOP=/api/user/v1.0/users","__ACCOUNT__.UPDATEOP=/api/user/v1.0/users","__ACCOUNT__.__PASSWORD__.UPDATEOP=/api/user/v1.0/users/password","__ACCOUNT__.SEARCHOP=/api/v3.0/common/users/$(Filter Suffix)$"
  3. カスタム属性の属性マッピングがない場合は、Oracle Identity Governance Design Consoleにログインしてマッピングを更新します。
  4. Oracle Identity Governanceを再起動します。
  5. コネクタがコネクタ・サーバーにデプロイされている場合は、次のようにします。
    1. コネクタ・サーバーを停止します。
    2. 既存のバンドルJARファイルorg.identityconnectors.genericrest-1.0.1115.jarを新しいバンドルJARファイルorg.identityconnectors.genericrest-12.3.0.jarに置き換えます。
    3. コネクタ・サーバーを起動します。コネクタをアップグレードした後で、完全リコンシリエーションまたは制限付きリコンシリエーションを実行できます。こうすることで、最後のリコンシリエーション実行後に作成または変更されたレコードがOracle Identity Governanceに確実にフェッチされます。

関連項目: