34.6 Identity Applications 和 Identity Reporting 疑難排解

下表列出了您可能會遇到的問題，以及為解決這些問題建議執行的動作。如果問題持續發生，請聯絡 OpenText 代表。

問題

建議執行的動作

如果在「證書標題」和「應用程式組態」中指定的 LDAP 伺服器名稱不同，則在升級 OpenText Identity Manager 後，Identity Applications 將無法連接到 Identity Vault。

Java 對 LDAPS 連接啟用端點識別，因此，在連接到 OpenText Identity Manager 伺服器時指定的伺服器名稱必須與證書中傳回的伺服器名稱相同。如果伺服器名稱不同，請執行以下步驟：

  1. 導覽至 /opt/netiq/idm/apps/configupdate 目錄。

  2. 執行以下指令啟動組態更新公用程式。

    ./configupdate.sh

  3. 導覽至使用者應用程式索引標籤，按一下 Identity Vault 伺服器，然後將伺服器名稱變更為 LDAP 伺服器證書標題中指定的名稱。

    此動作將更新 ism-configuration.properties 檔案中的 DirectoryService/realms/jndi/params/AUTHORITY 內容。

  4. 按一下確定。

如果將 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 <<密碼>>

  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。

您要修改安裝過程中建立的下列一或多個使用者應用程式組態設定：

  • Identity Vault 連接和證書

  • 電子郵件設定

  • OpenText Identity Manager 引擎使用者身分和使用者群組

  • Access Manager 或 iChain 設定

不依賴安裝程式來執行組態公用程式。

Linux：從安裝目錄 (預設為 /opt/netiq/idm/apps/configupdate/) 中執行以下指令：

./configupdate.sh

啟動 Tomcat 會導致以下例外：

port 8180 already in use

關閉任何可能已在執行的 Tomcat 例項 (或其他伺服器軟體)。如果將 Tomcat 重新設定為使用 8180 以外的連接埠，請編輯使用者應用程式驅動程式的 config 設定。

當 Tomcat 啟動時，應用程式報告找不到可信證書。

請務必使用安裝使用者應用程式期間指定的 JDK 來啟動 Tomcat。

無法登入入口網站管理頁面。

確保使用者應用程式管理員帳戶存在。此帳戶與 OpenText Identity Console 管理員帳戶不同。

即使使用管理員帳戶也無法建立新使用者。

使用者應用程式管理員必須是頂層容器的託管者，並且應具有「監督者」權限。您可以嘗試將使用者應用程式管理員的權限設定為與 LDAP 管理員的權限相同 (使用 OpenText Identity Console)。

啟動應用程式伺服器時拋出金鑰儲存區錯誤。

應用程式伺服器未使用安裝使用者應用程式期間指定的 JDK。

使用 keytool 指令，來輸入證書檔案：

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

  • 以您為此證書選擇的唯一名稱來取代 aliasName。

  • 以證書檔案的完整路徑和名稱來取代 certFile。

  • 預設金鑰儲存區密碼為 changeit (如果您有不同的密碼，請指定它)。

電子郵件通知無法傳送。

執行 configupdate 公用程式，以檢查您是否已提供以下使用者應用程式組態參數的值：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」的入口網站應用程式註冊不存在。com.novell.afw.portlet.exception.EboPortletRegistrationException：portletID 為「HeaderPortlet」的入口網站應用程式註冊不存在。

重新啟動 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 組態 失敗」。

從 Identity Manager 4.8.7 開始；我們可以覆寫每個例項的 IPs@NCP。使用者可以使用 NCP 覆寫的變數 IP，覆寫 -B 選項所傳遞的值，如在靜默內容中的以下內容：

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

透過標準版安裝 Identity Reporting 並執行 tomcat 服務後，可能會拋出錯誤「載入啟動程序組態內容時發生錯誤。無法從啟動程序組態取得內容。」

重新啟動 tomcat 服務。