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

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

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

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

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

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

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

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

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

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

ステージング環境

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

ノート:

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

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

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

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

アップグレード後のステップには、Oracle Identity Managerデータベースへの新しいコネクタJARのアップロードが含まれます。

次の手順を実行します。

古いコネクタ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を指定します。
新しいコネクタJARをアップロードします。
1. Oracle Identity Manager JARアップロード($ORACLE_HOME/bin/UploadJars.sh)ユーティリティを実行して、コネクタJARをアップロードします。
2. org.identityconnectors.genericrest-12.3.0.jarバンドルをICFバンドルとしてアップロードします。Oracle Identity Manager JARアップロード・ユーティリティを実行して、新しいICFバンドルorg.identityconnectors.genericrest-12.3.0.jarファイルをOracle Identity Managerデータベースに投稿します。
  
  JARアップロード・ユーティリティを実行すると、Oracle Identity Manager管理者のログイン資格証明、Oracle Identity Managerホスト・コンピュータのURL、コンテキスト・ファクトリ値、アップロードするJARファイルのタイプおよびJARファイルのアップロード元となる場所を入力するように求められます。JARタイプの値として4を指定します。
3. Lookup.Box.Configuration参照定義内の次のコード・キーおよびデコードのエントリを削除します。
  - コード・キー: Bundle Version、デコード: 1.0.1115
  - コード・キー: relURIs
    
    デコード:
    "__ACCOUNT__.CREATEOP=/users","__ACCOUNT__.UPDATEOP=/users/$(__UID__)$","__ACCOUNT__.SEARCHOP=/users/$(Filter Suffix)$","__ACCOUNT__.DELETEOP=/users/$(__UID__)$","__GROUP__.SEARCHOP=/groups/$(Filter Suffix)$","__ACCOUNT__.__GROUP__.CREATEOP=/group_memberships","__ACCOUNT__.__GROUP__.UPDATEOP=/group_memberships","__ACCOUNT__.__GROUP__.SEARCHOP=/users/$(__UID__)$/memberships","__ACCOUNT__.__GROUP__.DELETEOP=/group_memberships/$(__MEMBERSHIP__.id)$","__ACCOUNT__.__MEMBERSHIP__.__GROUP__.SEARCHOP=/users/$(__UID__)$/memberships","__ACCOUNT__.email.UPDATEOP=/users/$(__UID__)$/email_aliases","__ACCOUNT__.email.SEARCHOP=/users/$(__UID__)$/email_aliases","__ACCOUNT__.email.DELETEOP=/users/$(__UID__)$/email_aliases/$(__MEMBERSHIP__.id)$","__ACCOUNT__.__MEMBERSHIP__.email.SEARCHOP=/users/$(__UID__)$/email_aliases","__ACCOUNT__.role.SEARCHOP=/users/$(__UID__)$?fields=role","__ACCOUNT__.is_sync_enabled.SEARCHOP=/users/$(__UID__)$?fields=is_sync_enabled","__ACCOUNT__.is_exempt_from_login_verification.SEARCHOP=/users/$(__UID__)$?fields=is_exempt_from_login_verification"
4. Lookup.Box.UM.ReconAttrMap.Trusted参照定義内の次のコード・キーおよびデコードのエントリを削除します。
  
  コード・キー: Usage Location、デコード: UsageLocation
Oracle Identity Managerを再起動します。
コネクタがコネクタ・サーバーにデプロイされている場合は、次のようにします。
1. コネクタ・サーバーを停止します。
2. 既存のバンドルJARファイルorg.identityconnectors.genericrest-1.0.1115.jarを新しいバンドルJARファイルorg.identityconnectors.genericrest-12.3.0.jarに置き換えます。
3. コネクタ・サーバーを起動します。
  
  ノート:
  複数のバージョンのターゲット・システム用にコネクタを構成した場合、「ターゲット・システムの複数のインストールに対するコネクタの構成」を参照してください。