1. GoToMeetingアプリケーションの構成
  2. GoToMeetingコネクタの実装
  3. GoToMeetingコネクタのアップグレード

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

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

ノート:

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

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

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

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

関連項目:

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

3.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. すべてのスケジュール済ジョブを無効化します。

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

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

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

  • ステージング環境

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

    ノート:

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

  • 本番環境

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

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

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

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

次の手順を実行します。

  1. 次のようにして、新しいコネクタJARをアップロードします。
    1. コネクタJARをアップロードするためのJARアップロード・ユーティリティ($ORACLE_HOME/bin/UploadJars.sh)を実行します。
    2. bundle/org.identityconnectors.genericrest-12.3.0.jarをICFBundleとしてアップロードします。
    3. lib/gtm-update-accesstoken.jarをスケジュール済タスクとしてアップロードします。
  2. 新しいUIフォームに、Design Consoleのフォーム・デザイナに対して行われたすべての変更を次のように複製します。
    1. Oracle Identity System Administrationにログインします。
    2. サンドボックスを作成し、アクティブにします。
    3. アップグレードされたフィールドを表示するためのUIフォームを新規作成します。
    4. 新たに作成したUIフォームをターゲット・システムのアプリケーション・インスタンスに関連付けます。そのためには、リソースに対する既存のアプリケーション・インスタンスを開いて、「フォーム」フィールドからフォーム(ステップ2.cで作成済)を選択し、アプリケーション・インスタンスを保存します。
    5. サンドボックスを公開します。
  3. ソース・コネクタのアップグレード済ITリソースを構成します。
  4. コネクタ・サーバーを使用している場合は、次のようにコネクタ・サーバーJARを更新します。
    1. コネクタ・サーバー・ディレクトリのbundlesディレクトリに移動し、既存のコネクタ・サーバー・バンドルJARを新しいJARで置換します。
    2. コネクタ・サーバーを再起動します。
  5. アップグレード操作の成功後に前のコネクタ・アーティファクトのいずれかが保持されている場合は、Oracle Identity Manager Design Consoleにログインし、次の重複エントリを削除します。

    • Lookup.GoToMeeting.Configuration参照定義の場合:

      コード・キー デコード

      relURIs

      "__ACCOUNT__.licenseKeys.UPDATEOP=/admin/rest/v1/accounts/$(account_key)$/licenses/$(licenseKeys)$/users/$(__UID__)$",

      "__ACCOUNT__.CREATEOP=/admin/rest/v1/accounts/$(account_key)$/users", "__ACCOUNT__.UPDATEOP=/admin/rest/v1/accounts/$(account_key)$/users/$(__UID__)$",

      "__ACCOUNT__.SEARCHOP=/admin/rest/v1/accounts/$(account_key)$/users/$(Filter Suffix)$", "__ACCOUNT__.DELETEOP=/admin/rest/v1/accounts/$(account_key)$/users/$(__UID__)$", "__LICENSE__.SEARCHOP=/admin/rest/v1/accounts/$(account_key)$/licenses",

      "__GROUP__.SEARCHOP=/admin/rest/v1/accounts/$(account_key)$/groups", "__ACCOUNT__.__LICENSE__.ADDATTRIBUTE=/admin/rest/v1/accounts/$(account_key)$/licenses/$(__LICENSE__.key)$/users/$(__UID__)$",

      "__ACCOUNT__.__LICENSE__.REMOVEATTRIBUTE=/admin/rest/v1/accounts/$(account_key)$/licenses/$(__LICENSE__.key)$/users/$(__UID__)$",

      "__ACCOUNT__.groupKey.UPDATEOP=/admin/rest/v1/accounts/$(account_key)$/groups/$(groupKey)$/users/$(__UID__)$"

    • Lookup.GTM.UM.ReconAttrMap参照定義の場合:

      コード・キー デコード

      PrimaryLicense[LOOKUP]

      PARENT.licenseKeys

      Licenses~License Name[LOOKUP]

      CHILD.licenseKeys
  6. カスタム属性のいずれかの属性マッピングがない場合は、Oracle Identity Manager Design Consoleにログインしてマッピングを更新します。
コネクタをアップグレードした後で、完全リコンシリエーションまたは制限付きリコンシリエーションを実行できます。これにより、前回のリコンシリエーションの実行後に作成または変更されたレコードが、Oracle Identity Managerにフェッチされます。

関連項目: