34.6 Identity ApplicationsとIdentity Reportingのトラブルシューティング

次の表に、発生する可能性のある問題とそれを解決するための推奨されるアクションを示します。問題が続く場合は、OpenTextの担当者にお問い合わせください。

項目

推奨されるアクション

証明書サブジェクトで指定されたLDAPサーバ名とアプリケーション設定が異なる場合、OpenText Identity Managerのアップグレード後にIdentity Applicationsがアイデンティティボールトに接続できません。

JavaではLDAPS接続でエンドポイントを識別できるため、OpenText Identity Managerサーバへの接続時に指定したサーバ名と証明書で返されたサーバ名が同じであることが要求されます。サーバ名が異なる場合は、次の手順を実行します。

  1. /opt/netiq/idm/apps/configupdateディレクトリに移動します。

  2. 次のコマンドを実行して、設定更新ユーティリティを起動します。

    ./configupdate.sh

  3. ユーザアプリケーションタブに移動して、Identity Vault server (アイデンティティボールトサーバ)をクリックし、サーバ名をLDAPサーバ証明書サブジェクトで指定された名前に変更します。

    このアクションは、ism-configuration.propertiesファイルのDirectoryService/realms/jndi/params/AUTHORITY propertyを更新します。

  4. OKをクリックします。

Identity ApplicationsとIdentity Reportingが同じサーバにインストールされ、<reporting install folder>/binディレクトリにある設定更新ユーティリティを使用して設定変更を実行する場合は、OpenText Identity Managerダッシュボードが起動に失敗します。次のエラーがcatalina.outログファイルで報告されます。

EboPortalBootServlet [RBPM] +++++WARNING!!!! : This portal application context, IDMProv, does not match the portal.context property set in the PortalService-conf/config.xml file.Only one portal per database is allowed.Data has been loaded using the previous portal context.To correct this you must revert back to the previous portal name of, NoCacheFilter, please consult the documentation.

設定変更については、/opt/netiq/idm/apps/configupdate/ディレクトリにある設定更新ユーティリティを使用します。

設定更新ユーティリティを使用してプロパティのパスワードを変更することはできません。

次の手順を実行して、コマンドラインから、com.netiq.rpt.ssl-keystoreのようなプロパティのパスワードを変更することができます。

  1. パスワードを暗号化するには、次のユーティリティを使用します。

    /opt/netiq/common/jre/bin/java -jar tomcat/lib/obscurity-0.13.2-uber.jar com.netiq.ism.obfuscate.server.util.PasswordObfuscator <<Password>>

  2. /opt/netiq/idm/apps/tomcat/conf/ディレクトリにあるism-configuration.propertiesファイルに移動します。

  3. ism-configuration.propertiesファイルを変更して、com.netiq.rpt.ssl-keystore.pwdパラメータの手順2で指定された暗号化パスワードを追加します。

  4. ファイルを保存し、Tomcatを再起動します。

Identity Reportingがスタンドアロンサーバ上にインストールされていて、ダッシュボードからIdentity ReportingまたはIDM DCS URLを起動する場合、URLは起動に失敗します。

Identity ReportingまたはIDM DCS URLを起動した後で、次の手順を実行します。

  1. アドレスバーに移動します。

  2. URLを変更し、Identity Reportingがインストールされているサーバのホスト名とポートの詳細を手動で提供します。

それに加えて、Identity Applicationsがインストールされているサーバ上のconfigupdate.sh.propertiesファイルに移動して、sso_appsパラメータのrptと呼ばれるエントリを追加し、変更内容を保存します。例: sso_apps=ua,rpt

Identity ApplicationsとIdentity Reportingが同じサーバにインストールされ、OSPとIdentity ApplicationsのCEF監査が有効になっている場合、Reportingコンポーネントは起動に失敗します。

この問題を回避するには、次の手順を実行します。

  1. /opt/netiq/idm/apps/tomcat/confディレクトリにあるidmrptcore_logging.xmlファイルに移動します。

  2. <keystore file>パラメータを追加し、idmrptcore_logging.xmlファイルでキーストアファイルパスを指定します。たとえば、次の行を追加します。

    <keystore-file>/opt/netiq/idm/app/tomcat/conf/idm.jks</keystore-file>

  3. Tomcatを再起動します。

Identity ApplicationsおよびIdentity Reportingが同じサーバ上にインストールされている場合、データベース作成オプションとしてStartupを選択すると、いくつかの例外がログに記載されます。

これらの例外をクリアするには、Tomcatを手動で再起動します。

既存のIdentity ApplicationsまたはIdentity Reporting環境設定がポートなしで設定されている場合、OpenText Identity Managerにアップグレードしようとすると、設定更新ユーティリティの認証およびSSOクライアントタブに記載されているIPアドレスとポートに誤った値が表示されます。

Identity ApplicationsとIdentity Reportingをアップグレードしたら、以下の手順を実行します。

  1. /opt/netiq/idm/apps/configupdateディレクトリに移動します。

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

    ./configupdate.sh

  3. 認証タブで、OAuthサーバのホスト識別子およびOAuthサーバのTCPポートフィールドにそれぞれ正しいIPアドレスとポートを指定します。

  4. SSOクライアントタブで、IDM Administrator、Reporting、およびIDMデータ収集サービスのURLが正しい形式であることを確認します。

  5. Tomcatを再起動します。

インストール時に作成された次のユーザアプリケーション環境設定を1つまたは複数変更する必要がある。

  • 識別ボールトの接続および証明書

  • 電子メール設定

  • OpenText Identity Managerエンジンのユーザ識別情報とユーザグループ

  • Access ManagerまたはiChainの設定

インストーラとは別に、環境設定ユーティリティを実行します。

Linux: インストールディレクトリ(デフォルトでは/opt/netiq/idm/apps/configupdate/)から次のコマンドを実行します。

./configupdate.sh

Tomcatを起動すると次の例外が発生する。

port 8180 already in use

すでに実行されているTomcat (または他のサーバソフトウェア)のすべてのインスタンスをシャットダウンします。8180以外のポートを使用するようにTomcatを再設定する場合は、ユーザアプリケーションドライバのconfig設定を編集します。

Tomcatを起動すると、トラステッド証明書が見つからないと報告される。

ユーザアプリケーションのインストール時に指定したJDKを使用してTomcatを起動していることを確認します。

ポータル管理ページにログインできない。

ユーザアプリケーション管理者アカウントが存在することを確認します。このアカウントは、OpenText Identity Console管理者アカウントと同じではありません。

管理者アカウントを使用しても、新しいユーザを作成できない。

ユーザアプリケーション管理者は、最上位コンテナのトラスティである必要があり、スーパバイザ権が必要です。Identity Applications管理者の権利をLDAP管理者と同等の権利に設定することを試すことができます(OpenText Identity Consoleを使用)。

アプリケーションサーバを起動すると、キーストアエラーが発生する。

アプリケーションサーバが、ユーザアプリケーションのインストール時に指定したJDKを使用しない。

次のようにkeytoolコマンドを使用して、証明書ファイルをインポートします。

keytool -import -trustcacerts -alias aliasName -file certFile -keystore ..\lib\security\cacerts -storepass changeit

  • aliasNameは、この証明書に選択した一意の名前に置き換えます。

  • certFileは、証明書ファイルのフルパスおよび名前に置き換えます。

  • デフォルトのキーストアパスワードは、changeitです(別のパスワードがある場合は、それを指定します)。

電子メール通知が送信されない。

configupdateユーティリティを実行して、ユーザアプリケーション環境設定パラメータの電子メールの送信者と電子メールホストに値を指定したかどうかを確認します。

Linux: インストールディレクトリ(デフォルトでは/opt/netiq/idm/apps/configupdate/)から次のコマンドを実行します。

./configupdate.sh

IG SSOクライアントタブは、設定更新ユーティリティに表示されません

configupdate.sh.propertiesファイルで、sso_appsパラメータにigのエントリを追加し、変更内容を保存します。sso_appsパラメータにすでにIdentity ApplicationsおよびIdentity Reportingのエントリが含まれている場合、Identity Governanceのエントリをリストに追加します。たとえば、sso_apps=ua,rpt,igを追加します。

Identity Applicationsコンテナの展開中に、次の例外が表示されます。

ERROR [com.novell.afw.portlet.consumer.core.EboPortletProducerChangeListener] (main) [RBPM] Portlet registration with portletID: 'HeaderPortlet' does not exist.com.novell.afw.portlet.exception.EboPortletRegistrationException: Portlet registration with portletID: 'HeaderPortlet' does not exist.

Identity Applicationsコンテナを再起動します。

Identity Applicationsコンテナを展開した後に、新しいフォームに関連付けられている許可を要求しようとすると、フォームが期待どおりにロードされません。この問題はランダムに発生しています。

フォームレンダラサーバとポート詳細がnginx.confファイルで指定されていることを確認します。nginx.confファイルを更新するには、次の手順を実行します。

  1. フォームレンダラコンテナにログインします。

    docker exec -it <container> <command>

    次に例を示します。

    docker exec -it fr-container bash

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

  3. nginx.confファイルを編集します。

  4. フォームレンダラサーバとポート詳細を指定します。例:

    server {
listen 8600 ssl;
server_name  formrenderer.example.com;

Identity Manager 4.8.5コンテナをSLES15SP3にインストール中に発生します。2つのDockerホストが使用可能であるとします。OpenText eDirectoryツリーを作成する最初のDockerホストでのインストールは成功しました。2つ目のDockerホストでインストールが失敗し、idmconfigure.logに"EBA Configuration Failed"というエラーメッセージが記録されます。

Identity Manager 4.8.7以降では、各インスタンスのIPs@NCPを上書きできます。ユーザは、サイレントプロパティ内で次のようにIPswithNCPoverride変数を使用して、-Bオプションに渡される値を上書きできます。

IPswithNCPoverride=<IP1>@<NCP Port>, <IP2>@<NCP Port>

標準エディションを使用してIdentity Reportingをインストールし、tomcatサービスを実行すると、次のエラーが発生する可能性があります。 "Error loading bootstrap configuration properties.Unable to obtain properties from bootstrap configuration."

Tomcatサービスを再開します。