55.5 升級 Identity Applications 和支援元件

本節提供有關升級 Identity Applications 和支援軟體的資訊，其中包括更新以下元件的內容︰

  • Identity Manager 使用者應用程式

  • One SSO Provider (OSP)

  • Self-Service Password Reset (SSPR)

  • Tomcat、JDK 和 ActiveMQ

NetIQ 提供了一個升級程式來升級這些元件。此程式位於 Identity Manager 安裝套件的 products/RBPM/ 目錄中。導覽至包含以下升級檔案的目錄︰

  • Linux︰RBPM_upgrade.bin

  • Windows︰RBPM_upgrade.exe

本節提供下列資訊：

55.5.1 瞭解升級程式

升級程序會從現有元件中讀取組態值。這些資訊包括 ism-configuration.properties、server.xml、SSPRConfiguration 和其他組態檔案。升級程序會使用這些組態檔案在內部叫用各元件的升級程式。此外，此程式還會建立目前安裝的備份。

55.5.2 升級的先決條件和注意事項

執行升級前，請先檢閱以下注意事項︰

  • Identity Manager 已升級至版本 4.5.5︰ 您不能從低於 4.5.5 的版本升級或移轉至版本 4.6。如需如何升級至 Identity Manager 4.5 的詳細資訊，請參閱《NetIQ Identity Manager 安裝指南》中的「升級 Identity Manager」。

  • Role and Resource Service 驅動程式套件已升級︰ 如需詳細資訊，請參閱《NetIQ Designer for Identity Manager Administration Guide》(NetIQ Designer for Identity Manager 管理指南) 中的「Upgrading Installed Packages」(升級安裝的套件)。

  • 使用 Tomcat 做為應用程式伺服器︰ 此版本的 Identity Manager 僅支援使用 Tomcat 做為應用程式伺服器。

    附註：確認您已在 Identity Manager 4.5 安裝期間使用便捷安裝程式安裝 Tomcat 應用程式伺服器。升級程序只允許您升級使用便捷安裝程式安裝的 Tomcat。

    如果用於執行 Identity Applications 的應用程式伺服器不是 Tomcat，請將應用程式伺服器移轉至 Tomcat。如需詳細資訊，請參閱節 58.6, 從 Websphere 或 JBoss 移轉至 Tomcat Web 應用程式伺服器。

  • 資料庫平台已升級︰ 此程式不會升級 Identity Applications 的資料庫平台。請手動將目前的資料庫版本升級至受支援的版本。若要升級 PostgreSQL 資料庫，請參閱升級 PostgreSQL 資料庫。

  • 確認使用者應用程式網路位置名稱設定為預設名稱︰ 如果您已將使用者應用程式網路位置名稱設定為非預設名稱 (不是 IDMProv)，則需要變更網路位置名稱。如需詳細資訊，請參閱變更使用者應用程式的自訂網路位置名稱。

  • Self Service Password Reset: 如果要從 SSPR 4.0 升級，請確認您已更新 CATALINA_OPTS 內容，並且 -Dsspr.application.Path 設定為儲存 SSPR 組態的資料夾。

    例如，

    Linux︰ export CATALINA_OPTS="-Dsspr.applicationPath=/home/sspr_data

    Windows： set CATALINA_OPTS="-Dsspr.applicationPath=C:\sspr_data

    在升級前備份 SSPR LocalDB。若要輸出或下載 LocalDB，請執行以下步驟︰

    1. 以管理員身分登入 SSPR 入口網站。

    2. 在頁面右上角的下拉式功能表中按一下組態管理器。

    3. 按一下 LocalDB。

    4. 按一下下載 LocalDB。

升級 PostgreSQL 資料庫

若要升級 PostgreSQL 資料庫，請完成以下步驟︰

重要：升級過程可能需要一段時間，時間長短取決於資料庫大小。因此，請相應規劃您的升級。

  1. 停止伺服器上正在執行的 PostgreSQL 服務。

  2. 重新命名以下位置的 postgres 資料夾︰

    Linux︰ /opt/netiq/idm/apps

    Windows： C:\Netiq\IdentityManager\apps

    例如，將 postgres 重新命名為 postgresql_9_3。

  3. 掛接 Identity_Applications_版本_平台.iso 影像檔，導覽至包含 PostgreSQL 安裝程式的目錄。

    <iso 擷取路徑>/products/RBPM/postgre_tomcat_install

  4. 安裝 PostgreSQL 應用程式。從清單中選取 PostgreSQL︰

    • Linux (GUI)︰ 執行 ./TomcatPostgreSQL.bin

    • Linux (主控台)︰ 執行 ./TomcatPostgreSQL.bin -i console

    • Windows： 執行 TomcatPostgreSQL.exe

    安裝期間，請僅選取 PostgreSQL 選項。

    附註：在 PostgreSQL 詳細資料頁面，不要選取建立資料庫登入帳戶和建立空資料庫核取方塊。

  5. 停止伺服器上新安裝的 PostgreSQL 服務。

  6. 使用以下指令變更 PostgreSQL 目錄的擁有者︰

    chown -R postgres:postgres <postgres 目錄位置>

    例如，

    chown -R postgres:postgres /opt/netiq/idm/apps/postgres

  7. 使用以下指令切換為 postgres 使用者︰

    su - postgres

    1. 切到到 postgres/bin 目錄。

    2. 使用以下指令輸出 PostgreSQL 安裝位置︰

      export PATH=/opt/netiq/idm/apps/postgres/bin:$PATH

    3. 使用以下指令輸出 PostgreSQL 密碼︰

      export PGPASSWORD=<輸入資料庫密碼>

  8. 使用以下指令升級 PostgreSQL︰

    pg_upgrade --old-datadir <舊 postgres 位置\data> --new-datadir <新 postgres 位置\data> --old-bindir <舊 postgres 位置\bin> --new-bindir <新 postgres 位置\bin>

    例如。/pg_upgrade --old-datadir /opt/netiq/idm/apps/postgresql_9_3/data/ --new-datadir /opt/netiq/idm/apps/postgres/data/ --old-bindir /opt/netiq/idm/apps/postgresql_9_3/bin --new-bindir /opt/netiq/idm/apps/postgres/bin/

    成功升級後，該應用程式會顯示訊息以提示您執行 analyze_new_cluster.sh 和 delete_old_cluster.sh。

  9. 啟動新的或升級後的 PostgreSQL 資料庫服務。

  10. 切換為 postgres 使用者，然後執行 analyze_new_cluster.sh。

    su - postgres ./analyze_new_cluster.sh

    確認程序檔執行時未出現錯誤。

  11. 導覽至 /opt/netiq/idm/apps/postgres/bin，然後以 root 使用者身分執行 delete_old_cluster.sh。

    ./delete_old_cluster.sh

變更使用者應用程式的自訂網路位置名稱

如果您之前將使用者應用程式網路位置名稱設定為非預設名稱 (不是 IDMProv)，請完成以下步驟將網路位置名稱變更為預設網路位置名稱 IDMProv。

附註：您可以在 ism-configuration.properties 檔案的 portal.context 內容中驗證網路位置名稱。

  1. 停止 Tomcat 服務。

    /etc/init.d/idmapps_tomcat_init stop

  2. 導覽至 webapps 資料夾，並將非預設網路位置名稱的資料夾重新命名為 IDMProv。

    Linux︰ /opt/netiq/idm/apps/tomcat/webapps

    Windows： C:\Netiq\IdentityManager\apps\tomcat\webapps

    例如，如果 ism-configuration.properties 檔案中的 portal.context 名稱為 IDMDev，請將資料夾名稱從 IDMDev 變更為 IDMProv。

  3. 執行 Identity Applications 升級程式。請參閱節 55.5.4, 使用引導式程序升級 或節 55.5.5, 以靜默模式升級 Identity Manager 應用程式。

  4. 升級 Identity Applications 後，將 WAR 檔案還原為您原來的網路位置名稱。如需詳細資訊，請參閱Identity Applications。

55.5.3 系統要求

升級程序會為所安裝元件的目前組態建立備份。確認伺服器器具有足夠儲存備份的空間，另外還有可供升級的可用空間。

55.5.4 使用引導式程序升級

以下程序描述如何使用精靈升級 Identity Applications、OSP、SSPR、Tomcat 和 ActiveMQ 應用程式。

  1. 以 root 或管理使用者身分登入要用來執行升級程序的伺服器。

  2. 掛接 Identity_Applications.iso 影像檔，導覽至包含升級可執行檔的目錄 (預設位於 products/RBPM/ 目錄中)。

  3. 啟動升級程式。依據您的平台，執行以下其中一個檔案︰

    • Linux︰ RBPM_upgrade.bin

    • Windows︰ RBPM_upgrade.exe

  4. 在簡介頁面上，您可以檢視可升級的 Identity Manager 元件，然後按下一步。

  5. 閱讀並接受授權合約，然後按「下一步」。

  6. 檢閱已部署的應用程式頁面，然後按下一步。

    此頁面會列出目前已安裝的元件，還會列出 Tomcat 和 JRE 的版本和安裝目錄。如果在該伺服器上部署了其他應用程式，則升級程序會顯示警告，指出升級後這些應用程式可能會無法正常運作。

    例如，Identity Reporting 或使用者定義的 war 檔案。您必須手動從升級程序建立的備份還原它們。

  7. 若要繼續升級，請按下一步。

  8. 使用以下參數完成引導式程序。此程式會自動填入現有元件的值。確認為參數指定了正確的值。

    • One SSO Provider

      代表升級程式要在其中建立 OSP 應用程式檔案的目錄路徑。如果該路徑不正確，請瀏覽到 OSP 的安裝路徑。

    • SSPR

      代表升級程式要在其中建立 SSPR 應用程式檔案的目錄路徑。如果該路徑不正確，請瀏覽到 SSPR 的安裝路徑。

    • 使用者應用程式

      代表升級程式要在其中建立使用者應用程式的應用程式檔案的目錄路徑。如果該路徑不正確，請瀏覽到使用者應用程式的安裝路徑。

    • 資料庫連接

      代表用於連接使用者應用程式資料庫的設定，Identity Applications 也會連接到此資料庫。升級程式會將這些詳細資料包含在使用者應用程式組態檔案中。

      資料庫平台

      代表使用者應用程式資料庫的平台。

      資料庫主機

      指定代管使用者應用程式的伺服器的名稱或 IP 位址。

      資料庫連接埠

      指定資料庫伺服器用於與使用者應用程式通訊的連接埠。

      資料庫驅動程式 JAR

      指定資料庫平台的 jar 檔案。

      資料庫廠商會提供驅動程式 JAR 檔案，即資料庫伺服器的 JAR。例如，對於 PostgreSQL，可以指定預設位於 opt/netiq/idm/apps/postgres 資料夾 (Linux 上) 和 C:\netiq\idm\apps\postgres (Windows 上) 的 postgresql-9.4-1212.jdbc42.jar。同樣，指定您資料庫平台的相應 jar 檔案。

    • 資料庫身分證明

      資料庫名稱

      指定資料庫的名稱。依預設，資料庫名稱為 idmuserappdb。

      資料庫使用者名稱

      指定使用者應用程式用來存取和修改資料庫中資料的帳戶名稱。資料庫使用者名稱預設為 idmadmin。

      資料庫密碼

      提供所指定使用者名稱的密碼。

    • 升級資料庫

      立即升級資料庫

      升級程式會在升級過程中為資料庫表格更新綱要。

      在應用程式啟動時升級資料庫

      升級程式會發出在升級後使用者應用程式首次啟動時為資料庫表格更新綱要的指示。

      將 SQL 寫入檔案

      產生一個 SQL 程序檔，資料庫管理員可以執行該程序檔來更新資料庫。如果您選擇此選項，則還必須為綱要檔案指定名稱。設定位於 SQL 輸出檔案組態中。如果您無權在您的環境中建立或修改資料庫，則可選取此選項。如需使用該檔案產生表的詳細資訊，請參閱節 39.2, 手動建立資料庫綱要。

    • 資料庫管理員

      代表資料庫管理員的名稱和密碼。

      資料庫使用者名稱

      指定可建立資料庫表格、檢視和其他產出工件的資料庫管理員帳戶。

      密碼

      指定資料庫管理員的密碼。

    • 備份資料夾

      依據元件的安裝位置，安裝程序會在該位置建立備份目錄，並將時戳 (指示備份時間) 附加至備份目錄。

      例如，

      • Tomcat︰/opt/netiq/idm/apps/tomcat_backup_02262017_033634

      • OSP 和 SSPR︰/opt/netiq/idm/apps/osp_sspr_backup_02262017_033634

      • ActiveMQ︰/opt/netiq/idm/apps/activemq_backup_02262017_033634

      • 使用者應用程式︰/opt/netiq/idm/apps/UserApplication_backup_02262017_033634

  9. 檢閱升級前摘要頁面，然後按一下安裝。

    升級程序會停止 Tomcat 服務並開始升級，完成此程序可能需要一段時間。

  10. 當升級過程完成時，檢閱 /tmp/rbpm_upgrade/ 中的升級記錄檔案，您需要手動更新數個組態，請參閱節 55.5.6, 升級後任務。

55.5.5 以靜默模式升級 Identity Manager 應用程式

靜默 (非互動式) 安裝不顯示使用者介面。

  1. 以 root 使用者或管理員身分登入要升級 Identity Manager 應用程式的伺服器。

  2. 開啟一個終端機工作階段。

  3. 在內容檔案中為安裝指定相應的值。

    • Linux︰products/RBPM/RBPM_Upgrade_Linux.properties

    • Windows︰products\RBPM\RBPM_Upgrade_Win.properties

  4. 若要啟動適用於您平台的升級程式，請輸入以下指令︰

    • Linux︰RBPM_Upgrade.bin -i silent -f RBPM_Upgrade_Linux.properties

    • Windows︰RBPM_Upgrade.exe -i silent -f RBPM_Upgrade_Win.properties

    附註：如果 RBPM_Upgrade_Linux.properties 檔案與安裝程式程序檔不在同一目錄，您必須指定該檔案的絕對路徑。該程序檔會將所需的檔案解包到暫存目錄，然後啟動靜默安裝。

55.5.6 升級後任務

完成升級後，必須手動還原 Tomcat、SSPR、OSP 或 Identity Applications 的自訂設定。

針對所需元件執行升級後步驟︰

Java

對照較舊的 JRE 位置，驗證新升級 JRE 位置中的證書 jre/lib/security/cacerts。手動將缺少的證書輸入到 cacerts 中。

  1. 使用 keytool 指令輸入 java cacerts︰

    keytool -import -trustcacerts -file Cerificate_Path -alias ALIAS_NAME -keystore cacerts

    附註：升級後，JRE 儲存在 Identity Applications 安裝位置。例如︰/opt/netiq/idm/apps/jre

  2. 驗證 JRE 主目錄位置。

    Linux︰ tomcat/bin/setenv.sh

    Windows： tomcat/bin/setenv.bat

  3. 啟動組態更新公用程式，並驗證您的 cacerts 路徑。

Tomcat 應用程式伺服器

  1. (視情況而定) 從升級程序之前建立的備份還原自訂檔案。

    範例︰

    • 自訂的 https 證書。若要還原組態，請將所備份 server.xml 中的 Java Secure Socket Extension (JSSE) 內容複製到 /tomcat/conf 目錄下的新 server.xml 檔案中。

    • 不要將所備份 Tomcat 目錄中的組態檔案複製到新 Tomcat 目錄中。應視需要在新版本預設組態的基礎上進行變更。如需詳細資訊，請造訪此 Apache 網站。

    • 如果您自訂了金鑰儲存區檔案，請在新 server.xml 檔案中包括正確的路徑。

  2. (視情況而定) 導覽至 Identity Manager 使用者應用程式，然後透過讀取備份的組態手動還原自訂設定。

Identity Applications

從升級期間建立的備份還原 Identity Applications 自訂設定。

如果您在執行升級程式前已將自訂網路位置資料夾重新命名為 IDMProv，則應使用 configupdate 公用程式將該網路位置資料夾名稱變更為原來的網路位置名稱。例如，原來的自訂網路位置名稱為 IDMDev，現在它被重新命名為 IDMProv。

請完成以下步驟將網路位置名稱改回為原來的網路位置名稱︰

  1. 導覽至使用者應用程式目錄 /opt/netiq/idm/apps/UserApplication。

  2. 啟動 configupdate 公用程式。

    Linux︰ configupdate.sh

    Windows： configupdate.bat

  3. 在使用者應用程式索引標籤中按一下進階選項，然後執行以下步驟︰

    1. 核取變更 RBPM 網路位置名稱核取方塊。

    2. 將 RBPM 網路位置名稱變更為原來的網路位置名稱。

    3. 瀏覽並選取相應的角色驅動程式 DN，然後按一下確定。

    4. 使用以下指令變更 WAR 檔案的許可權和擁有權。

      chmod 755 <Original_Context_Name>.war; chown -R novlua:novlua <Original_Context_Name>.war

      例如，如果原來的自訂網路位置名稱為 IDMDev︰

      chmod 755 IDMDev.war; chown -R novlua:novlua IDMDev.war

  4. (視情況而定) 如果您已完成所有升級後任務，則請啟動 Identity Applications 的 Tomcat 服務。

One SSO Provider

如果 OSP 和使用者應用程式部署在不同的伺服器上，則請使用組態更新公用程式更新 SSO 用戶端參數。如需詳細資訊，請參閱 節 40.4, SSO 用戶端參數 中的 節 40.4.3, IDM 儀表板。

位於 /etc/logevent.conf 檔案中的 LogHost 項目預設設定為 localhost。

若要修改 LogHost 項目，請手動從升級期間建立的備份還原 OSP 自訂組態。

Self-Service Password Reset

升級 SSPR 後，使用組態更新公用程式來更新 SSO 用戶端參數。如需詳細資訊，請參閱 節 40.4, SSO 用戶端參數 中的 節 40.4.8, Self Service Password Reset。

若要更新 SSPR 組態詳細資料，請執行以下步驟︰

  1. 以管理員身分登入 SSPR 入口網站。

  2. 更新稽核伺服器詳細資料︰

    1. 導覽至組態編輯器，指定組態密碼。

    2. 選取設定 > 稽核 > 稽核轉遞 > Syslog 稽核伺服器證書。

    3. 從伺服器輸入這些證書，然後按一下儲存。

  3. 將 LocalDB 輸入 SSPR︰

    1. 在頁面右上角的下拉式功能表中按一下組態管理器。

    2. 按一下 LocalDB。

    3. 按一下輸入 (上傳) LocalDB 歸檔檔案。

  4. 設定 SSPR 的管理員許可權，請參閱節 32.3, 安裝後任務

    附註：如果您是從 SSPR 4.0 升級至 SSPR 4.1，SSPR 組態的自訂位置將會變更為 SSPR 4.1 的預設位置。在 setenv.sh 檔案中可以找到更多有關組態位置的資訊。不過，此變更不會影響元件的行為。

    例如，如果升級前 SSPR 組態的路徑為 -Dsspr.applicationPath='/home/sspr-data，則升級後該路徑會變更為 -Dsspr.applicationPath=/opt/netiq/idm/apps/osp_sspr/sspr/sspr_data，並且會還原此位置中所有關聯的組態。

若要驗證升級是否成功，請啟動升級的元件。

例如，啟動 Identity Manager 儀表板，按一下關於。檢查應用程式顯示的是否為新版本，例如 4.6.0。