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. 导航到 User Application 选项卡，单击身份库服务器，然后将服务器名称更改为 LDAP 服务器证书主体中指定的名称。

    此操作将更新 ism-configuration.properties 文件中的 DirectoryService/realms/jndi/params/AUTHORITY 属性。

  4. 单击确定。

如果 Identity Applications 和 Identity Reporting 安装在同一台服务器上，而您使用 <Reporting 安装文件夹>/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 <<口令>>

  2. 导航到 /opt/netiq/idm/apps/tomcat/conf 目录中的 ism-configuration.properties 文件。

  3. 修改 ism-configuration.properties 文件，添加在步骤 2 中为 com.netiq.rpt.ssl-keystore.pwd 参数指定的加密口令。

  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. 在 idmrptcore_logging.xml 文件中添加 <keystore file> 参数，并指定密钥存储区文件路径。例如，添加下行：

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

  3. 重启动 Tomcat。

如果 Identity Applications 和 Identity Reporting 安装在同一台服务器上，并且您为数据库创建选项选择了启动，将会在日志中看到一些异常。

要清除这些异常，请手动重启动 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。

您要修改安装过程中创建的以下一或多个 User Application 配置设置：

  • 身份库连接和证书

  • 电子邮件设置

  • OpenText Identity Manager 引擎用户身份和用户组

  • Access Manager 或 iChain 设置

在独立于安装程序的情况下运行配置实用程序。

Linux：从安装目录（默认为 /opt/netiq/idm/apps/configupdate/）中运行以下命令：

./configupdate.sh

启动 Tomcat 会导致以下异常：

port 8180 already in use

关闭 Tomcat（或其他服务器软件）的可能已在运行的任何实例。如果将 Tomcat 重新配置为使用 8180 以外的其他端口，请编辑 User Application 驱动程序的 config 设置。

当 Tomcat 启动时，应用程序报告称找不到可信证书。

请务必使用安装 User Application 期间指定的 JDK 来启动 Tomcat。

无法登录门户管理页面。

确保存在 User Application 管理员帐户。此帐户与 OpenText Identity Console 管理员帐户不同。

即使使用管理员帐户也无法创建新用户。

User Application 管理员必须是顶层容器的受托者，并且应有主管权限。您可以尝试将 User Application 管理员的权限设置为等效于 LDAP 管理员的权限（使用 OpenText Identity Console）。

启动应用程序服务器时发生密钥存储区错误。

应用程序服务器未使用安装 User Application 期间指定的 JDK。

使用 keytool 命令导入证书文件：

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

  • 使用为该证书选择的唯一名称替换 aliasName。

  • 使用证书文件的完整路径和名称替换 certFile。

  • 默认的密钥储存区口令为 changeit（如果有其他口令，请指定）。

无法发送电子邮件通知。

运行 configupdate 实用程序以检查是否提供了以下 User Application 配置参数的值：Email From 和 Email Host。

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 容器时显示以下异常：

错误 [com.novell.afw.portlet.consumer.core.EboPortletProducerChangeListener] (main) [RBPM] portletID 为“HeaderPortlet”的 Portlet 注册不存在。com.novell.afw.portlet.exception.EboPortletRegistrationException：portletID 为“HeaderPortlet”的 Portlet 注册不存在。

重启动 Identity Applications 容器。

部署 Identity Applications 容器后，当您尝试请求与新表单关联的许可权限时，该表单不按预期装载。此问题是随机出现的。

确保已在 nginx.conf 文件中指定表单渲染器服务器和端口细节。要更新 nginx.conf 文件，请执行以下步骤：

  1. 登录到表单渲染器容器。

    docker exec -it <容器> <命令>

    例如：

    docker exec -it fr-container bash

  2. 导航到 /opt/netiq/common/nginx/ 目录。

  3. 编辑 nginx.conf 文件。

  4. 指定表单渲染器服务器和端口细节。例如：

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

在 SLES15SP3 上安装 Identity Manager 4.8.5 容器时。考虑有两台 Docker 主机可用。在创建 OpenText eDirectory 树的第一台 Docker 主机上安装成功。第二个 Docker 主机上的安装失败，idmconfigure.log 中显示错误讯息””EBA Configuration Failed”（EBA 配置失败）。

从 Identity Manager 4.8.7 开始，我们可以覆盖每个实例的 IPs@NCP。用户可以在静默属性中使用具有 NCP 覆盖的变量 IP 覆盖 -B 选项传递的值，如下所示：

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

通过 Standard Edition 安装 Identity Reporting 并运行 Tomcat 服务后，可能会抛出错误 "Error loading bootstrap configuration properties".Unable to obtain properties from bootstrap configuration.”（加载引导配置属性时出错，无法从引导配置获取属性。）

重启动 tomcat 服务。