18.7 Identity Applicationsのアップグレード

このセクションでは、次のコンポーネントの更新を含む、Identity Applicationsおよびサポートするソフトウェアのアップグレードについて説明します。

  • OpenText Identity Managerユーザアプリケーション

  • Self-Service Password Reset (SSPR)

  • Tomcat、JDK、およびActiveMQ

  • PostgreSQLデータベース

  • OSP (One SSO Provider)

    重要:OpenText Identity Manager 4.10では、Identity ApplicationsとOSPを同じコンピュータにインストールすることが要求されます。このバージョンにアップグレードする場合は、Identity Applicationsのアップグレード時にインストールされるOSPを使用し、既存のOSPサーバから新しいOSPサーバにOSP設定をコピーします。詳細については、Identity Applicationsコンポーネントのアップグレード後のタスクを参照してください。

このセクションでは、次のトピックについて説明します。

18.7.1 アップグレードに関する考慮事項

Identity Applicationsアップグレードプロセスは、Identity Applicationsコンポーネントのアップグレード方法によって異なる場合があります。Identity Applicationsをアップグレードする前に、次の考慮事項が適用されます。

  • Identity Applicationsのアップグレードプロセスを開始する前に、OracleまたはMS SQLデータベースを使用している場合はigaworkflowdbを作成し、すべての権限をidmadminユーザに割り当ててデータベースを所有する必要があります。

  • Identity ApplicationsコンポーネントをOpenText Identity Manager 4.9から4.10にアップグレードする前に、ワークフロー移行ツールを使用してIdentity Applicationsデータベース(idmuserappdb)からワークフローエンジンデータベース(igaworkflowdb)にデータをエクスポートします。詳細については、『OpenText™ Identity Manager CE 24.4 (v4.10) - Administrator’s Guide to the Identity Applications』の「Migrating Data from Identity Applications Database into Workflow Engine Database」を参照してください。

  • Identity ApplicationsとSSPRが異なるサーバにインストールされている場合は、SSPRを個別にアップグレードすることを選択できます。

  • アップグレード中は、データベース名と他のデフォルト値を確認し、必要に応じて変更してください。

  • OpenText Identity Managerは、Identity ApplicationsサーバでのOSPのローカルインストールをサポートしています。アップグレードプログラムは、このバージョンへのOSPのスタンドアロンアップグレードをサポートせず、Identity Applicationsのアップグレード中にOSPの新しいコピーをインストールします。既存のOSP設定を新しくインストールされたOSPに復元するには、Identity Applicationsコンポーネントのアップグレード後のタスクのOne SSO Providerを参照してください。

    表 18-1 Identity Applicationsのアップグレードプロセス

    Identity Applicationsの展開

    アップグレードプロセス

    Identity Applications、SSPR、およびOSPは同じサーバにインストールされています。

    すべてのコンポーネントをアップグレードするには、Identity Applicationsのアップグレードの手順に従ってください。

    Identity ApplicationsとOSPは同じサーバにインストールされています。SSPRは別のサーバにインストールされています。

    1. Identity ApplicationsとOSPをアップグレードするには、Identity Applicationsのアップグレードの手順に従ってください。

    2. 別のサーバのSSPRをアップグレードするには、SSPRのアップグレードの手順に従ってください。

    Identity Applicationsは、SSPRおよびOSPとは異なるサーバにインストールされています。この場合、SSPRはIdentity Applicationsサーバまたは別のサーバにインストールできます。ただし、OSPはIdentity Applicationsサーバにインストールされている必要があります。

    1. Identity ApplicationsとOSPをアップグレードするには、Identity Applicationsのアップグレードの手順に従ってください。

    2. 別のサーバのSSPRをアップグレードするには、SSPRのアップグレードの手順に従ってください。

    3. 設定更新ユーティリティを起動し、OSPがインストールされている新しいサーバの詳細を指定します。この場合、新しいサーバはIdentity Applicationsがインストールされているサーバです。詳細については、SSO Clients Parameters (SSOクライアントパラメータ)を参照してください。

18.7.2 システム要件

アップグレードプロセスにより、インストールされたコンポーネントの現在の設定のバックアップが作成されます。ご使用のサーバにバックアップを格納するための十分な容量と、アップグレードに使用可能な追加の空き容量があることを確認します。詳細については、『System Requirements for OpenText™ Identity Manager CE 24.4 (v4.10)』を参照してください。

18.7.3 アップグレードプログラムについて

アップグレードプロセスは、既存のコンポーネントから設定値を読み込みます。この情報には、ism-configuration.properties、server.xml、SSPRConfiguration.xml、および他の設定ファイルが含まれます。これらの設定ファイルを使用すると、アップグレードプロセスにより、指定されたコンポーネントのアップグレードプログラムが内部的に起動します。アップグレードプログラムは現在のインストールのバックアップも作成します。

18.7.4 PostgreSQLのアップグレード

メモ:PostgreSQLを他のOpenText Identity Managerコンポーネントと一緒にアップグレードする前に(たとえば、アイデンティティボールト、NGINXサービス、およびPostgreSQLデータベースがすべて同じサーバ上にある場合など)、既存のOpenSSL RPMファイル(アップグレードされていない)が既存のPostgreSQL libディレクトリにコピーされていることを確認してください。次のコマンドを実行します。

cp -rpf /opt/netiq/common/openssl/lib64/* /opt/netiq/idm/postgres/lib

この手順の実行に失敗すると、パスワードが正しくても、次のエラーメッセージが表示される場合があります。 入力されたパスワードが間違っています。正しい資格情報を入力してください。。このエラーを解決するには、インストーラコンソールに表示されるヘルプを参照してください。

  1. Identity_Manager_4.10.0_Linux.isoをダウンロードして、抽出します。

  2. /common/scriptsディレクトリに移動します。

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

    ./pg-upgrade.sh

  4. 以下の詳細を指定して、インストールを完了します。

    既存のPostgresインストール場所: PostgreSQLがインストールされる場所を指定します。デフォルトの場所は、/opt/netiq/idm/postgresです。

    メモ:Postgresユーザに/opt/netiq/idm/postgresディレクトリに対する適切な許可があることを確認してください。

    既存のPostgresデータディレクトリ: PostgreSQLデータディレクトリの場所を指定します。デフォルトの場所は、/opt/netiq/idm/postgres/dataです。

    既存のPostgresデータベースパスワード: PostgreSQLパスワードを指定します。

    新しいPostgresデータディレクトリ: 新しいPostgreSQLデータディレクトリを指定します。たとえば、/opt/netiq/idm/postgres_new/dataを指定します。

18.7.5 Identity Applicationsのコンポーネントのアップグレード

Identity Applicationsのドライバパッケージのアップグレード

Tomcatを停止し、ユーザアプリケーションドライバ、役割およびリソースサービスドライバ、データ収集サービスドライバのパッケージを最新バージョンに更新する必要があります。パッケージを最新バージョンにアップグレードする方法については、『Designer Administration Guide for OpenText™ Identity Manager CE 24.4 (v4.10)』の「Upgrading Installed Packages」を参照してください。

ユーザアプリケーションドライバパッケージをアップグレードした後、ワークフローテンプレートパッケージを手動で追加する必要があります。

  1. Designerで、［ユーザアプリケーションドライバ］ > ［プロパティ］に移動します。

  2. ［パッケージ］をクリックして、をクリックします。

  3. Show only applicable package versions (適用可能なパッケージバージョンのみを表示する)チェックボックスを選択します。

  4. ワークフローテンプレートの作成を選択します。

  5. OKをクリックしてから、完了をクリックしてインストールを完了します。

  6. ユーザアプリケーションドライバを展開します。

重要:ユーザアプリケーションドライバのアップグレードの一環として、電子メール通知テンプレートがインストールまたはアップグレードされる場合は、デフォルトの通知コレクションオブジェクトを展開する必要があります。

Identity Applicationsのアップグレード

次の手順では、Identity Applicationsをアップグレードする方法について説明します。

  1. OpenTextダウンロードWebサイトからIdentity_Manager_4.10.0_Linux.isoをダウンロードします。

  2. ダウンロード済みの.isoをマウントします。

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

    ./install.sh

  4. 使用許諾契約を読みます。

  5. 使用許諾契約の条項を確認し、「y」と入力します。

  6. Identity Applicationsをアップグレードするかどうかを指定します。使用可能なオプションは、yおよびnです。

  7. アップグレードを続行する場合、次の詳細を指定します。

    バックアップ用のOSPインストールフォルダ

    これは、OSPとIdentity Applicationsが同じサーバ上にある場合にのみ適用されます。

    OSPバックアップデータを格納するOSPバックアップフォルダを指定します。

    SSPR Installation Folder (SSPRインストールフォルダ)

    これは、SSPRとIdentity Applicationsが同じサーバ上にある場合にのみ適用されます。

    SSPRインストールフォルダを指定します。

    SSPR not found on system.Do you want to install & configure it? (SSPRがシステムに見つかりません。インストールして設定しますか?)

    これは、Identity ApplicationsとSSPRが異なるサーバ上にある場合にのみ適用されます。

    yを選択すると、SSPRはIdentity Applicationsと同じサーバにインストールされます。既存のカスタマイズ設定を、新しいSSPRインストール済みのサーバにコピーする必要があります。

    • ［SSPR設定パスワード］: SSPR設定パスワードを指定します。

    • ［One SSO Server DNS/IPアドレス］: OSPがインストールされるサーバのIPアドレスを指定します。

    • ［One SSO Server SSLポート］: OSP SSLポートを指定します。

    nを選択すると、SSPRはインストールされず、Identity Applicationsはアップグレードされます。

    User Application Installation Folder (ユーザアプリケーションインストールフォルダ)

    ユーザアプリケーションインストールフォルダを指定します。

    Identity Applications One SSO Service Password (Identity ApplicationsのOne SSO Serviceパスワード)

    One SSOパスワードを指定します。指定されたパスワードは、設定更新ユーティリティで設定したすべてのクライアントのクライアントシークレットを更新します。必要に応じて、設定更新ユーティリティから各クライアントのパスワードをリセットできます。詳細については、SSO Clients Parameters (SSOクライアントパラメータ)を参照してください。

    Identity Applications Database JDBC jar file (Identity ApplicationsデータベースのJDBC jarファイル)

    データベースJARファイルを指定します。たとえば、PostgreSQLデータベースを使用していて、このデータベースが同じサーバにインストールされている場合、既存のデータベースjarファイルのデフォルトの場所は/opt/netiq/idm/postgres/postgresql-42.6.1.jarです。

    Create Schema for Identity Applications (Identity Applicationsのスキーマの作成)

    データベーススキーマをいつ作成するかを指定します。使用可能なオプションは、Now、Startup、およびFileです。デフォルトのオプションはNowです。

    メモ:MsSQLまたはOracleを使用してidmadminユーザにこのデータベースのすべての権限を割り当てる場合は、igaworkflowdbを作成する必要があります。

    Identity Applications Database User Password (Identity Applicationsデータベースユーザパスワード)

    データベースのユーザのパスワードを指定します。

    Identity Applications Database Administrator Password (Identity Applicationsデータベース管理者パスワード)

    データベースの管理者のパスワードを指定します。

  8. Tomcatを起動します。データベーススキーマを直ちに作成することを選ぶ場合は、Nowを選択します。

    systemctl start netiq-tomcat.service

    (オプション)アップグレード時に、データベーススキーマを作成するためにStartup (起動)またはWrite to file (ファイルに書き込み)のオプションを選択した場合、データをワークフローデータベースにインポートする必要があります。詳細については、『OpenText™ Identity Manager CE 24.4 (v4.10) - Administrator’s Guide to the Identity Applications』の「Migrating Data from Identity Applications Database into Workflow Engine Database」を参照してください。

  9. NGINXサービスを再起動します。

    systemctl restart netiq-nginx.service

SSPRのアップグレード

SSPRがAdvanced EditionのIdentity Applicationsサーバとは異なるサーバにインストールされている場合、この方法を使用します。

これは、Standard EditionでSSPRをアップグレードする唯一の方法です。

SSPRをアップグレードするには:

  1. OpenTextダウンロードWebサイトからIdentity_Manager_4.10.0_Linux.isoをダウンロードします。

  2. ダウンロード済みの.isoをマウントします。

  3. .isoファイルのルートディレクトリから、ssprディレクトリに移動します。

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

    ./install.sh

  5. 使用許諾契約を読みます。

  6. 使用許諾契約の条項を確認し、「y」と入力します。

  7. yを指定して、SSPRをアップグレードします。

  8. 識別ボールト管理者パスワードを指定して、アップグレードを完了します。

18.7.6 Identity Applicationsコンポーネントのアップグレード後のタスク

Identity Applicationsの使用を開始する前に、以下のタスクを実行します。

  • TomcatおよびActiveMQサービスの以前のバージョンを手動で削除します。たとえば、次のコマンドを実行します。

    /etc/init.d/idmapps_tomcat_init

    /etc/init.d/idmapps_activemq_init

  • Tomcat、SSPR、OSP、およびKerberosのカスタマイズされた設定を手動で復元する必要があります。

  • Identity ApplicationsとしてのCNでの証明書は、Identity Applicationsサーバのキーストア(idm.jks)に存在している必要があります。拡張Javaセキュリティの一環として、現在ではIdentity ApplicationsではOSPと通信するためのトラステッド証明書が必要です。

  • 既存のIdentity Applicationsキーストアファイルを使用して、署名済みの証明書をidm.jksにインポートします。次に例を示します。

    ./keytool -import -alias mycerts -keystore /opt/netiq/idm/apps/tomcat/conf/idm.jks -file /opt/certs/chap8.der

    メモ:この手順は4.9から4.10へのアップグレードに必要です。

  • Identity Applicationsをクラスタ環境でアップグレードしている場合は、Identity Applicationsのアップグレード後に次の手順を実行する必要があります。

    • /opt/netiq/idm/apps/tomcat/confディレクトリに移動して、context.xmlファイルのContextタグに次の行を追加します。

      <Manager notifyListenersOnReplication="true" expireSessionsOnShutdown="false" className="org.apache.catalina.ha.session.DeltaManager"/>

    • /opt/netiq/idm/apps/tomcat/confディレクトリに移動して、server.xmlファイルのClusterタグに次の行を追加します。

      <Channel className="org.apache.catalina.tribes.group.GroupChannel">
            <Membership className="org.apache.catalina.tribes.membership.McastService"
                        address="228.0.0.4"
                        port="45564"
                        frequency="500"
                        dropTime="3000"/>
            <Receiver className="org.apache.catalina.tribes.transport.nio.NioReceiver"
                      address="auto"
                      port="5000"
                      selectorTimeout="100"
                      maxThreads="6"/>

            <Sender className="org.apache.catalina.tribes.transport.ReplicationTransmitter">
              <Transport className="org.apache.catalina.tribes.transport.nio.PooledParallelSender"/>
            </Sender>
            <Interceptor className="org.apache.catalina.tribes.group.interceptors.TcpFailureDetector"/>
            <Interceptor className="org.apache.catalina.tribes.group.interceptors.MessageDispatchInterceptor"/>
            <Interceptor className="org.apache.catalina.tribes.group.interceptors.ThroughputInterceptor"/>
          </Channel>

          <Valve className="org.apache.catalina.ha.tcp.ReplicationValve"
                 filter=".*\.gif|.*\.js|.*\.jpeg|.*\.jpg|.*\.png|.*\.htm|.*\.html|.*\.css|.*\.txt"/>

          <Deployer className="org.apache.catalina.ha.deploy.FarmWarDeployer"
                    tempDir="/tmp/war-temp/"
                    deployDir="/tmp/war-deploy/"
                    watchDir="/tmp/war-listen/"
                    watchEnabled="false"/>

          <ClusterListener className="org.apache.catalina.ha.session.ClusterSessionListener"/>

    • 以下のファイルをプライマリノードからすべてのユーザアプリケーションノードにコピーします。

      • ism-sensitive.properties

      • ism-configuration.properties

      • encrypt-keys.pkcs12

  • データベースがSSL経由で設定されている場合は、/opt/netiq/idm/apps/tomcat/conf/にあるパスから取得されるserver.xmlファイルでssl=trueをsslmode=requireに置き換えます。

    たとえば、次のように変更します。

    jdbc:postgresql://<postgres db>:5432/idmuserappdb?ssl=true

    変更先:

    jdbc:postgresql://<postgres db>:5432/idmuserappdb?sslmode=require

Tomcat

  • クラスタ環境で、server.xmlのClusterタグを手動でコメント解除して、/opt/netiq/idm/apps/osp_backup_<date>にある最初のノードからすべてのノードにosp.jksをコピーします。

  • カスタマイズしたキーストアファイルがある場合は、新しいserver.xmlファイルに正しいパスを含めてください。

SSPR

Identity ApplicationsとSSPRが異なるサーバに展開されており、SSPRがインストールされている新しいサーバに既存のSSPRのカスタマイズされた設定を復元することを選択した場合、新しいSSPRサーバでConfigUpdateユーティリティを使用してSSPR設定を変更してください。詳細については、SSO Clients Parameters (SSOクライアントパラメータ)を参照してください。

One SSO Provider

アップグレード前のセットアップでIdentity ApplicationsとOSPが異なるサーバに展開されている場合、既存のOSP設定を、OSPがインストールされている新しいサーバ(Identity Applicationsサーバ)にコピーし、このサーバ上でインストールキットからmerge_jarsメソッドを実行して設定を復元します。

  1. Identity ApplicationsをアップグレードしたサーバでTomcatを停止します。(OSPはIdentity Applicationsのアップグレードでインストールされます)

  2. カスタマイズを復元します。

    1. 既存のOSPサーバのOSPインストールディレクトリに移動し、osp-custom-resource.jarファイルを見つけます。

      たとえば、/opt/netiq/backup_idm/osp/osp-extras/l10n-resources/osp-custom-resource.jarというファイルを見つけます。

    2. osp-custom-resource.jarファイルを、Identity Applicationsをアップグレードしたサーバ上の場所にコピーします。

    3. <location where you have mounted the Identity_Manager_4.10.0_Linux.iso>/osp/scripts/merge_cust_loc.shに移動します。

      このスクリプトには、既存のカスタマイズと新しくインストールされたOSPのマージを処理するmerge_jarsメソッドが含まれています。

    4. コマンドプロンプトを開き、次のコマンドを実行します。

      merge_jars ${IDM_BACKUP_FOLDER in the remote OSP server}/tomcat/lib/osp-custom-resource.jar ${IDM 4.10_OSP_INSTALLED_HOME}/osp-extras/l10n-resources/osp-custom-resource.jar)

      次に例を示します。

      merge_jars /opt/netiq/backup_idm/osp/osp-extras/l10n-resources/osp-custom-resource.jar /opt/netiq/idm/apps/osp/osp-extras/l10n-resources/osp-custom-resource.jar

      ここでbackup_idmディレクトリには、既存のOSPサーバのOSP設定が含まれます。

  3. OSPがインストールされている新しいサーバでTomcatを起動します。

その他の設定の更新については、SSO Clients Parameters (SSOクライアントパラメータ)を参照してください。

Kerberos

アップグレードユーティリティにより、コンピュータ上に新しいTomcatフォルダが作成されます。keytabやKerberos_login.configなどのKerberosファイルが古いTomcatフォルダ上にある場合は、バックアップしたフォルダから新しいTomcatフォルダにこれらのファイルをコピーします。

18.7.7 アップグレード後のバージョン番号の確認

OpenText Identity Manager 4.10にアップグレードした後、コンポーネントが以下のバージョンにアップグレードされていることを確認します。

  • Tomcat – 9.0.95.0

  • ActiveMQ – 5.18.4.0

  • Java – 11.76.21.1_222

  • One SSO Provider – 6.7.7.0

  • セルフサービスパスワードリセット – 4.8.0.1