安裝與更新說明

本節提供有關安裝或更新 Identity Manager 的資訊，相關資訊編排如下：



備註	如需有關安裝與升級程序的相關已知問題，請參閱本文件的安裝與更新小節。

安裝注意事項

下列資訊與產品安裝程序相關：

安裝 PasswordSync 時，請務必使用安裝所在之作業系統適用之二進位檔案。32 位元 Windows 的二進位檔案名為 IdmPwSync_x86.msi，而 64 位元 WINDOWS 的二進位檔案名為 IdmPwSync_x64.msi。

解除安裝 PasswordSync 時，請使用 Windows [控制台] 的新增/修改程式功能，以確保正確移除。安裝錯誤的二進位檔案可能會顯示為成功，但 PasswordSync 將無法正確運作。(ID-17290)

您必須在 HP-UX 上手動安裝 Identity Manager。

Identity Manager 安裝公用程式現在可安裝或更新到任何安裝目錄名稱中。您必須先建立這個目錄，再開始安裝程序，或從安裝畫面中選擇建立目錄。

您需要使用 Microsoft Active Directory Client 延伸軟體，才能在 Windows 系統上執行 Sun Identity Manager 閘道。可在下列位置找到 DSClient：

http://support.microsoft.com/default.aspx?scid=kb;en-us;Q288358



備註	請參閱「Sun Identity Manager 安裝」出版物，以取得詳細的產品安裝說明。

升級注意事項

本節包含將 Identity Manager 6.0 版或 7.0 版升級為 8.0 版時的相關資訊與已知問題。

本節中的資訊編排如下：

開始之前

升級問題

重新整理使用者物件



備註	請參閱「Identity Manager 升級」以取得升級說明與資訊。升級 Identity Manager 時，請務必檢閱「Sun Identity Manager 安裝」中適用於您的應用程式伺服器安裝部分，瞭解應用程式伺服器特定說明。若目前的 Identity Manager 安裝需要進行大量的自訂工作，則應與 Sun 專業服務連絡，以協助您規劃與執行升級。

開始之前

開始升級程序之前，請務必注意以下資訊：



注意	若使用 Oracle 儲存庫，Identity Manager 8.0 儲存庫 DDL 會使用舊版 Oracle JDBC 驅動程式未正確處理的資料類型。ojdbc14.jar 中的 JDBC 驅動程式無法正確讀取記錄表格中的所有欄。您必須升級為 oracle11g_jdbc.jar 驅動程式，Identity Manager 才能正常作業。

Identity Manager 8.0 提供某些專門用於角色物件的新表格。您必須使用 db_scripts 目錄中所提供的範例程序檔進行模式變更、建立新表格結構，以及移動現有資料。



備註	更新儲存庫資料庫表格定義之前，請將您的儲存庫表格完整備份。請參閱 db_scripts/upgradeto8.0from71.DBMSName 程序檔，以取得更多資訊。

若要升級至 Identity Manager 8.0，且有任何呼叫 UserUIConfig#getRepoIndexAttributes() 的自訂程式碼，您必須移除程式碼或將其變更為呼叫 Type.USER#getInlineAttributeNames()。

匯入 update.xml 可針對 RepositoryConfiguration 物件內的 Type.USER，將值從 UserUIConfig RepoIndexAttrs 轉換為 TypeDataStore 元素上 XML 屬性的值。update.xml 檔案包含 UserUIConfigUpdater.xml 檔案，其中內含匯入指令，可呼叫 UserUIConfigUpdater 以轉換 RepoIndexAttrs。轉換也會在 SystemConfiguration 中設定旗標，禁止再次轉換。

對 Type.USER 的內嵌屬性所做的任何未來變更，都應透過編輯 RepositoryConfiguration 物件來完成。若變更 Type.USER 的內嵌屬性，通常必須重新整理所有 Type.USER 物件。



備註	對 RepositoryConfiguration 所做的變更在您重新啟動 Identity Manager 伺服器之前，不會影響該伺服器。

請務必只使用一部 Identity Manager 伺服器匯入 update.xml，且在升級期間只有一部 Identity Manager 伺服器正在執行中。若在升級期間啟動任何其他 Identity Manager 伺服器，則必須停止並重新啟動這些伺服器，才能再使用這些伺服器。

由於超級角色本身可能是巢式角色，因此請小心編輯 [角色] 表單中的超級角色欄位。超級角色與子角色欄位表示角色的巢式結構，以及其相關資源或資源群組。套用至使用者時，超級角色會包含與任何指定子角色相關的資源。超級角色欄位會隨即顯示，並指出包含所顯示之角色的所有角色。

在升級程序期間，Identity Manager 會分析系統上的所有角色，然後使用 RoleUpdater 類別，更新任何缺少的子角色與超級角色連結。

若要檢查及升級不在升級程序中的角色，您可以匯入 sample/forms/RoleUpdater.xml 中所提供的新 RoleUpdater 配置物件。
例如：

<?xml version='1.0' encoding='UTF-8'?>

<!DOCTYPE Waveset PUBLIC 'waveset.dtd' 'waveset.dtd'>

<Map>

</Map>

</ImportCommand>

</Waveset>

其中：

verbose：在更新角色時提供詳細輸出。指定 false 可啟用角色的無訊息更新。

noupdate：可決定是否更新角色。指定 false 可取得僅列出將進行更新之角色的報告。

nofixsubrolelinks：可決定在缺少子角色連結時是否更新超級角色。此值預設為 false，且會修復連結。

需要檢視或編輯「使用者」或「角色」之 Identity Manager 模式的管理員，必須屬於 IDM 模式配置管理員群組，且必須具有 IDM 模式配置權能。

Identity Manager 中的 SPML 2.0 實作在 Identity Manager 8.0 中已變更。在先前的版本中，SPML 訊息所使用的 SPML objectclass 屬性會直接對映至 Identity Manager 使用者物件的 objectclass 屬性。objectclass 屬性現在改從內部對映至 spml2ObjectClass 屬性，且供內部其他用途使用。

在升級程序期間，objectclass 屬性值會自動為現有的使用者重新命名。如果您的 SPML 2.0 配置包含參照 objectclass 屬性的表單，則必須手動將這些參照變更為 spml2ObjectClass。

Identity Manager 在升級期間不會取代範例 spml2.xml 配置檔案。若使用 spml2.xml 配置檔案作為起點，請注意此檔案包含參照 objectclass 的表單，您必須將此參照變更為 spml2ObjectClass。請變更表單中的 objectclass 屬性 (供內部使用)，但請勿變更目標模式中的 objectclass 屬性 (此為對外顯示的屬性)。

若是 UNIX 環境，請確定 install 目錄存在於下列其中一個位置，且您可在其中寫入：

若是 Linux/HP-UX：/var/opt/sun/install

若是 Solaris：/var/sadm/install

任何先前安裝的 Hotfix 均將歸檔至下列目錄：

$WSHOME/patches/HotfixName

升級問題

升級之後，changedFileList 與 notRestoredFileLists 將包含下列檔案。這些檔案不應顯示，也不需執行任何動作。(ID-9228)

bin/winnt/nspr4.dll

bin/winnt/jdic.dll

bin/winnt/MozEmbed.exe

bin/winnt/IeEmbed.exe

bin/winnt/AceApi.dll

bin/winnt/DominoAPIWrapper.dll

bin/winnt/DotNetWrapper.dll

bin/winnt/gateway.exe

bin/winnt/lhpwic.dll

bin/winnt/msems.inf

bin/winnt/pwicsvc.exe

bin/winnt/remedy.dll

bin/solaris/libjdic.so

bin/solaris/mozembed-solaris-gtk2

bin/linux/librfccm.so

bin/linux/libsapjcorfc.so

bin/linux/libjdic.so

bin/linux/mozembed-linux-gtk2

Identity Manager 的「使用者延伸屬性」現在完全支援多值屬性。(ID-14863)



備註	您可以將多值使用者延伸屬性加入至帳號清單表格，再由其正確的顯示清單。但是，若嘗試排序此欄則會產生下列錯誤： java.lang.ClassCastException:java.util.ArrayList

僅在重新串列化使用者物件之後，參照多值延伸屬性的屬性條件才會針對此使用者物件進行正確評估。若要此屬性條件針對所有使用者物件正確進行評估，則必須重新串列化所有使用者物件。請參閱重新整理使用者物件，以取得說明。

若您要從 Identity Manager 6.x 版安裝升級為 7.x 版至 8.0 版，並且要開始使用新的 Identity Manager 一般使用者頁面啟動，則必須將系統配置 ui.web.user.showMenu 手動變更為 true，以顯示水平瀏覽位址列。(ID-14901)

此外，若要在一般使用者首頁上顯示新的一般使用者面板，則必須手動變更表單類型「endUserMenu」的一般使用者表單對映。移至 [配置] > [表單與程序對映] > 針對表單類型「endUserMenu」，將 [與下列項目對映的表單名稱] 變更為 [一般使用者面板]。

您也應更新表單類型「endUserWorkItemListExt」的對映。將 [與下列項目對映的表單名稱] 變更為「一般使用者核准清單」。



備註	若是從 Identity Manager 7.x 版直接升級至 8.0 版，則不需要執行上述的修改。

若要從 6.0 版或 7.0 版升級為 7.1 版或 8.0 版，並使用 LocalFiles，則必須在升級前匯出您所有的資料，並於 7.1 版或 8.0 版的全新安裝完成後重新匯入資料。(ID-15366)

如果安裝包含 Remedy 資源，則必須將 Remedy API 程式庫置於安裝閘道的目錄中。這些程式庫位於 Remedy 伺服器上。

Remedy API 程式庫
Remedy 4.x 與 5.x	Remedy 6.3	Remedy 7.0
arapiXX.dll arrpcXX.dll arutlXX.dll 其中 XX 與 Remedy 的版本相符。例如，arapi45.dll 表示在 Remedy 4.5 上。	arapi63.dll arrpc63.dll arutl63.dll icudt20.dll icuin20.dll icuuc20.dll	arapi70.dll arrpc70.dll arutl70.dll icudt32.dll icuin32.dll icuuc32.dll

升級至 Identity Manager 8.0 會自動將使用者延伸屬性物件與 UserUIConfig 物件的 QueryableAttrNames 與 SummaryAttrNames 元素轉換為 IDM 模式配置物件。(ID-17784) 範例 update.xml 程序檔包含匯入指令，可呼叫 IDMSchemaConfigurationUpdater 以轉換舊有的使用者模式配置物件。若要成功轉換舊有的使用者模式配置物件，請執行下列作業：

在 IDM 模式配置內，為使用者延伸屬性的每個延伸屬性名稱建立一個 IDMObjectClassAttribute 元素。

將對應至 UserUIConfig 內 SummaryAttrNames 元素各個值的所有 IDMObjectClassAttribute 標示為「摘要」。

將對應至 UserUIConfig 內 QueryableAttrNames 元素各個值的所有 IDMObjectClassAttribute 標示為「可查詢」。

清空 UserUIConfig 內的 SummaryAttrNames 元素。

清空 UserUIConfig 內的 QueryableAttrNames 元素。

將名為 objectClass 的所有延伸屬性重新命名為 spml2ObjectClass。名為 objectClass 的舊有屬性會與 Identity Manager 8.0 模式中的核心屬性相衝突。

當您升級至 Identity Manager 8.0，且有任何呼叫 UserUIConfig#getRepoIndexAttributes() 的自訂程式碼時，您必須移除程式碼或將其變更為呼叫 Type.USER#getInlineAttributeNames()。(ID-18051)



備註	對 RepositoryConfiguration 所做的變更在您重新啟動 Identity Manager 伺服器之前，不會影響該伺服器。

請務必只使用一部 Identity Manager 伺服器匯入 update.xml，且在升級期間只有一部 Identity Manager 伺服器正在執行中。(ID-18051)

若在升級期間啟動任何其他 Identity Manager 伺服器，請停止並重新啟動該此服器，才能再使用此伺服器。

從 Identity Manager 7.1 之前的任何 Identity Manager 發行版本升級至 Identity Manager 8.0 時，由於 Identity Manager Service Provider Edition (SPE) 物件在 Identity Manager 8.0 中已重新命名為 Identity Manager 服務提供者，因此升級記錄中可能會出現 ItemNotFound 異常。(ID-18860)

已停用的功能

Identity Manager 8.0 已變更報告中圖表的顯示方式。Identity Manager 8.0 之前的版本所建立的報告，在 Identity Manger 8.0 發行版本中會依預期顯示；但這些報告在後續重大發行版本與修補程式中不會依預期顯示。例如，Identity Manager 7.1 所建立的報告在 Identity Manager 8.0 與 Identity Manager 8.0 Patch 1 中會依預期顯示，但在 Identity Manager 9.0 中不會依預期顯示。(ID-17636)

重新整理使用者物件

部分變更類型需要管理員重新整理所有使用者物件。例如，當您在 RepositoryConfiguration 中變更 Type.USER 的內嵌屬性時，必須重新整理所有使用者物件。每當您在 IDMSchemaConfiguration 物件中將任何屬性標記為可查詢或摘要時，皆須重新整理所有使用者物件，這些變更才會影響舊有且尚未修改的物件。當 Identity Manager 的新版增加新的屬性，或當 Identity Manager 的新版變更現有屬性的值時，也適用相同的邏輯，亦即升級程序或管理員必須重新整理所有使用者物件，這些變更才會影響舊有且尚未修改的物件。

重新串列化現有使用者的方式有三種：

在一般作業期間修改個別使用者物件。

例如，透過使用者介面開啟使用者帳號，然後儲存修改，或不修改便儲存。

缺點：此方法不僅耗時，且管理員必須非常謹慎，以確保重新串列化所有現有使用者。

使用 lh refreshType 公用程式重新串列化所有使用者。refreshType 公用程式會輸出重新整理後的使用者清單。

lh console

refreshType 使用者

缺點：由於 refreshType 公用程式是在前景執行而非在背景執行，因此這項程序很耗時。若有許多使用者，則重新串列化所有使用者需要很長的時間。

使用延遲作業掃描儀。



備註	您必須使用 Identity Manager 整合開發環境 (Identity Manager IDE) 或其他方法編輯系統配置物件，再執行延遲作業掃描儀程序。搜尋 refreshOfType，並移除 2005Q4M3refreshOfTypeUserIsComplete 與 2005Q4M3refreshOfTypeUserUpperBound 屬性。編輯系統配置物件之後，必須將物件匯入儲存庫，變更才會生效。

缺點：由於此方法幾乎檢查及重寫每個使用者物件，因此會造成下一個延遲作業掃描儀執行需要很長的時間。但是，後續的延遲作業掃描儀執行應會以正常的速度與持續時間執行。