|
| |
| Sun Java Enterprise System 2005Q4 升級指南 | |
第 17 章
Portal Server本章描述如何將 Portal Server 升級到 Java ES 2005Q4 (發行版本 4)：Sun Java System Portal Server 6.3.1 2005Q4。本章提供 Java ES 發行版本 4 支援的不同升級路徑之升級問題和程序的一般簡介。本章涵蓋在 Solaris 和 Linux 作業系統上的升級作業：
Portal Server 升級簡介本節描述下列會影響 Portal Server 升級至 Java ES 2005Q4 (發行版本 4) 的一般層面：
關於 Java ES 發行版本 4 Portal Server
Java ES 發行版本 4 Portal Server 的功能與發行版本 3 相同，但包含發行版本 3 之後所做的錯誤修正。
Portal Server 升級資訊指南
表 17-1 顯示支援的 Portal Server 至 Java ES 發行版本 4 的升級路徑。該表適用於 Solaris 和 Linux 作業系統。
Portal Server 資料
下表顯示可能受 Portal Server 軟體升級影響的資料類型。
相容性問題
發行版本 4 Portal Server 沒有推出任何介面變更。Portal Server 元件 (包括行動存取元件) 向下相容較早的版本。
Portal Server 相依性
Portal Server 對其他 Java ES 元件的相依性可能會影響升級和重新配置 Portal Server 軟體的程序。例如，Portal Server 介面或功能上的變更可能需要 Portal Server 依賴之元件的升級版本。升級此類元件的需求取決於具體的升級路徑。
Portal Server 對下列 Java ES 元件有相依性：
- 共用元件。 Portal Server 對特定的 Java ES 共用元件有相依性 (請參閱表 1-6)。
- Web 容器。 Portal Server 依賴 Web 容器服務，它們可由 Java ES Web Server 或 Java ES Application Server (或 Weblogic 和 WebSphere 開發的協力廠商 Web 容器) 提供。
- Access Manager (或 Access Manager SDK)。 Portal Server 依賴 Access Manager 來為一般使用者提供認證和授權服務，包括單次登入。如果 Access Manager 是在遠端電腦上執行，則 Access Manager SDK 在本機上必須可用。
- Directory Server。 Portal Server 存取儲存在 Directory Server 中的使用者資料。因此，Portal Server 升級可能需要延伸目錄模式。
從 Java ES 發行版本 3 升級 Portal Server本節包括將 Portal Server 從 Java ES 2005Q1 (發行版本 3) 升級至 Java ES 2005Q4 (發行版本 4) 的相關資訊。
備註
本節不適用於以下特殊情況：Portal Server 部署在 Application Server Web 容器中，且是先從發行版本 2 升級到發行版本 3，然後再升級到發行版本 4。目前尚不支援前述的升級路徑。
本節涵蓋以下主題：
簡介
將 Java ES 發行版本 3 Portal Server 升級到發行版本 4 時，請考慮升級程序的下列層面：
- 一般升級方法。 藉由為發行版本 3 版本套用修補程式並將 Portal Server 重新部署到 Web 容器來執行升級。
- 升級相依性。 儘管 Portal Server 對許多 Java ES 共用元件有相依性 (請參閱表 1-6)，發行版本 4 Portal Server 卻與這些元件的發行版本 3 版本均相容。因此，對將 Portal Server 升級到發行版本 4 而言，升級這些共用元件 (Mobile Access Core (MA Core) 除外) 是選擇性的。
此外，發行版本 4 Portal Server 還依賴 Web 容器、Access Manager 和 Directory Server，如 Portal Server 相依性中所述。不過，這些並非是硬性的升級相依性；對將 Portal Server 升級至發行版本 4 而言，升級這些元件是選擇性的。
升級發行版本 3 Portal Server
本節描述如何在 Solaris 及 Linux 平台上將 Portal Server 從 Java ES 發行版本 3 升級到 Java ES 發行版本 4。當某個主題依賴平台特定的程序時，該主題將指出其適用的作業系統。本節涵蓋以下主題：
升級前作業
升級 Portal Server 之前，應該執行下述作業。
驗證目前版本資訊
您可使用下列指令驗證 Portal Server 的目前版本；
升級 Portal Server 相依性
一般的建議是將電腦系統 (及運算環境中) 的所有 Java ES 元件都升級到 Java ES 發行版本 4。不過，Portal Server 只對 Mobile Access Core (MA Core) 共用元件有硬性升級相依性。因此，升級 Portal Server 依賴的其他 Java ES 發行版本 3 元件是選擇性的。
不過，如果選擇升級所有 Portal Server 相依性，則應在升級 Portal Server 之前，按照以下順序升級所有相依性。可以略過可能已升級過的任何相依性。
- 共用元件。 升級 Java ES 共用元件中提供了將 Java ES 共用元件升級到發行版本 4 的指示。
- Directory Server。 第 4 章「Directory Server 和 Administration Server」中提供了將 Directory Server 升級到發行版本 4 的指示。
- Web 容器軟體。 第 6 章「Web Server」和第 9 章「Application Server」中分別提供了升級 Web Server 和 Application Server 的指示。
備註
升級協力廠商 Web 容器 (如 WebLogic 和 WebSphere 開發的容器) 可能導致 Portal Server 發生故障，因為容器升級會覆寫為支援 Portal Server 而對這些容器進行的自訂。
在這些情況下，必須為升級後的 Web 容器環境重新安裝和重新配置 Portal Server。
- Access Manager (Access Manager SDK)。 第 11 章「Access Manager」中提供了將 Access Manager 升級到發行版本 4 的指示。
備份 Portal Server 發行版本 3 配置資訊
將 Portal Server 升級到發行版本 4 不需要重新配置 Portal Server 軟體。不過，為安全起見，可以備份下列儲存配置資訊的目錄：
取得必要的配置資訊和密碼
需要以超級使用者身份登入，才能執行升級。如果使用 Web Server 作為 Web 容器，則不需要配置資訊。不過，如果使用 Application Server 作為 Web 容器，將需要 Application Server 管理員使用者 ID 和密碼。
升級發行版本 3 Portal Server (Solaris)
本節討論影響 Portal Server 升級程序的注意事項，接著提供對程序本身的說明。
升級注意事項 (Solaris)
將 Portal Server 軟體升級到 Java ES 發行版本 4 時要考慮下列注意事項：
升級程序 (Solaris)
下述程序適用於位於執行升級的電腦上的 Portal Server。
- 根據表 17-4 取得所需的修補程式。
除非指示您使用特定修訂版，請一律使用最新的修補程式修訂版。
可從下列位置將修補程式下載到 /tmp：http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access
- 請以超級使用者身份登入或成為超級使用者。
su -
- 停止 Portal Server，方法是停止它的 Web 容器。
Web Server：
WebServer-base/https-instanceName/stopApplication Server：
AppServer8-base/bin/asadmin stop-domain domainName- 若尚未升級 MA Core 共用元件和您希望升級的任何其他元件，請執行此動作。
- 套用表 17-4 中相應的 Portal Server 修補程式。
務必在套用這兩個 Portal Server 本土化修補程式之前，套用 Portal Server 核心修補程式。
patchadd patch_ID
- 確認修補程式升級成功：
showrev -p | grep patch_ID
輸出應傳回步驟 5 中套用的修補程式 ID 版本。
- 重新啟動 Portal Server，方法是重新啟動它的 Web 容器。
Web Server：
WebServer-base/https-instanceName/startApplication Server：
AppServer8-base/bin/asadmin start-domain --user admin_ID
--password password domainName- 將 Portal Server Web 應用程式重新部署到 Web 容器。
PortalServer-base/bin/deploy redeploy
redeploy 指令會將 PortalServer-base/web-src 中的內容重新部署到 /var/PortalServer-base/https-hostName/deploy-dir/web-apps。因此，若要對 Portal Server Web 應用程式進行任何自訂，應先對 /web-src 進行這些自訂，然後將它們重新部署到 /web-apps。執行 deploy 指令之前，應在 /web-src 中複製您可能會在 /web-apps 下進行的任何變更。否則，此類變更將被覆寫。
- 停止 Web 容器，然後將其重新啟動。
儘管並不需要在所有情況下都重新啟動 Web 容器，但這樣做可確保 Portal Server 在未修改的狀態下啟動。
升級發行版本 3 Portal Server (Linux)
本節討論影響 Portal Server 升級程序的注意事項，接著提供對程序本身的說明。
升級注意事項 (Linux)
除了 Linux 發行版本 4 升級修補程式與 Solaris 修補程式不同以外，其餘在 Linux 平台上將 Portal Server 軟體升級到 Java ES 發行版本 4 所要考慮的注意事項與在 Solaris 平台上升級時要考慮的注意事項相同 (請參閱升級注意事項 (Solaris))。
下表顯示適用於 Linux OS 的發行版本 4 Portal Server 升級修補程式：
表 17-5 用於在 Linux 上升級 Portal Server 的修補程式1
說明
修補程式 ID 和 RPM 名稱
Portal Server 核心
118952-12
和若干其他 Portal Desktop 與 Portal Server 行動存取的 RPM。
Portal Server 本土化版本
119426-07
以及大量適用於 Portal Server 行動存取、配置、身份識別及其他元件的其他 RPM。
Portal Server
本土化配置程式118116-08
1修補程式的修訂版號碼是升級到 Java ES 發行版本 4 的最低需求。如果有更新的修訂版可用，請使用更新的修訂版，而不要使用表中的修訂版。
升級程序 (Linux)
下述程序適用於位於執行升級的電腦上的 Portal Server。
- 使用表 17-5 中的修補程式號碼和 RPM 名稱來取得所需的修補程式。使用此資訊以取得 RPM 的版本號碼。
可從下列位置將修補程式下載到 /tmp：http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access
- 請以超級使用者身份登入或成為超級使用者。
su -
- 停止 Portal Server，方法是停止它的 Web 容器。
Web Server：
WebServer-base/https-instanceName/stopApplication Server：
AppServer8-base/bin/asadmin stop-domain domainName- 若尚未升級 MA Core 共用元件和您希望升級的任何其他元件，請執行此動作。
- 套用表 17-5 中 Portal Server 核心修補程式的 RPM。
cd /tmp
其中 /tmp 是將步驟 1 中的修補程式下載到的目錄。
./update
更新程序檔會安裝 RPM，並會確保套用修補程式後發生正確的配置變更。
- 確認修補程式升級成功：
rpm -qa | grep sun-portal-core-6.3-25
應傳回 RPM 的升級修訂版號碼。
- 套用表 17-5 中那兩個 Portal Server 本土化修補程式的 RPM。
rpm -Fvh --replacefiles sun-portal-*-Locale-6.3-24.i386.rpm
rpm -Fvh --replacefiles
sun-portal-l10n-configurator-6.3-24.i386.rpm- 確認修補程式升級成功：
rpm -qa | grep sun-portal-l10n-configurator-6.3-24
應傳回 RPM 的升級修訂版號碼。
- 重新啟動 Portal Server，方法是重新啟動它的 Web 容器。
Web Server：
WebServer-base/https-instanceName/startApplication Server：
AppServer8-base/bin/asadmin start-domain --user admin_ID
--password password domainName- 將 Portal Server Web 應用程式重新部署到 Web 容器。
PortalServer-base/bin/deploy redeploy
redeploy 指令會將 PortalServer-base/web-src 中的內容重新部署到 /var/PortalServer-base/https-hostName/deploy-dir/web-apps。因此，若要對 Portal Server Web 應用程式進行任何自訂，應先對 /web-src 進行這些自訂，然後將它們重新部署到 /web-apps。執行 deploy 指令之前，應在 /web-src 中複製您可能會在 /web-apps 下進行的任何變更。否則，此類變更將被覆寫。
- 停止 Web 容器，然後將其重新啟動。
儘管並不需要在所有情況下都重新啟動 Web 容器，但這樣做可確保 Portal Server 在未修改的狀態下啟動。
驗證升級
驗證 Portal Server 是否升級到發行版本 4 的方法是確認是否已正確套用升級修補程式。升級程序 (Solaris) 和升級程序 (Linux) 中包含此驗證的步驟。
此外，也可使用下列指令：
請參閱表 17-3 取得輸出值。
除了這些對修補程式升級的測試外，還可驗證以前正常運作的元件是否仍在正常運作及所關心的錯誤修正確已得到修正。
升級後作業
除了在升級程序 (Solaris) 和升級程序 (Linux) 中所述的步驟之外，沒有升級後的作業。
回復升級 (Solaris)
本節描述影響 Portal Server 升級回復程序的注意事項，接著提供程序本身。
回復注意事項 (Solaris)
發行版本 4 Portal Server 的升級回復程序基本上就是升級到發行版本 4 程序的逆過程。將會回復重新配置並移除修補程式。
回復程序 (Solaris)
- 請以超級使用者身份登入或成為超級使用者。
su -
- 停止 Portal Server，方法是停止它的 Web 容器。
Web Server：
WebServer-base/https-instanceName/stopApplication Server：
AppServer8-base/bin/asadmin start-domain --user admin_ID
--password password domainName- 移除表 17-4 中的修補程式。
patchrm patch_ID
- 重新啟動 Portal Server，方法是重新啟動它的 Web 容器。
Web Server：
WebServer-base/https-instanceName/startApplication Server：
AppServer8-base/bin/asadmin start-domain domainName
--user admin_ID --password password- 將 Portal Server Web 應用程式重新部署到 Web 容器。
PortalServer-base/bin/deploy redeploy
redeploy 指令會將 PortalServer-base/web-src 中的內容重新部署到 /var/PortalServer-base/https-hostName/deploy-dir/web-apps。因此，若要對 Portal Server Web 應用程式進行任何自訂，應先對 /web-src 進行這些自訂，然後將它們重新部署到 /web-apps。執行 deploy 指令之前，應在 /web-src 中複製您可能會在 /web-apps 下進行的任何變更。否則，此類變更將被覆寫。
- 停止 Web 容器，然後將其重新啟動。
儘管並不需要在所有情況下都重新啟動 Web 容器，但這樣做可確保 Portal Server 在未修改的狀態下啟動。
多重實例升級
在某些部署架構中，會將 Portal Server 部署在多個電腦系統上，以提供延展性並提高可用性。例如，可以讓 Portal Server 元件在多台電腦上執行，並透過負載平衡器來分散負載。
若 Portal Server 實例已達負載平衡，則可以執行串聯式升級，即依序升級 Portal Server 實例而不中斷服務。升級 Portal Server 的每個實例時其他實例仍可繼續執行。需要按照升級發行版本 3 Portal Server 中所述的方式升級每個實例。
從 Java ES 發行版本 2 升級 Portal Server本節包括將 Portal Server 從 Java ES 2004Q2 (發行版本 2) 升級至 Java ES 2005Q4 (發行版本 4) 的相關資訊。
由於發行版本 2 Portal Server 升級所牽涉的複雜性及可能導致的長時間停機，您可能會選擇在另一台電腦上執行平行升級，而不是在生產系統上就地升級。對只能容許有限停機時間的重要業務或複雜 Portal Server 解決方案而言，建議採用這種方法。升級程序的持續時間也和您重新實作和測試任何必要的 Portal Server 自訂所需的時間有關。
也可能需要修改或改動本節的指示，以適應您的特定升級方案。在此類情況下，建議您連絡 Sun Microsystems 支援服務，以在執行升級時獲得協助。
本節涵蓋關於從發行版本 2 升級到發行版本 4 的下列主題：
簡介
將 Java ES 發行版本 2 Portal Server 升級到發行版本 4 時，請考慮升級程序的下列層面：
- 一般升級方法。 藉由為發行版本 2 版本套用修補程序來執行升級。還需要重新配置 Portal Server，它是使用升級公用程式來執行的。
- 升級相依性。 Portal Server 對若干 Java ES 共用元件有相依性 (請參閱表 1-6)，所有這些元件都必須升級到發行版本 4，因為 Java ES 不支援在單一電腦上混合使用發行版本 2 和發行版本 4 元件。
此外，發行版本 4 Portal Server 還依賴 Web 容器、Access Manager 及 Directory Server，如 Portal Server 相依性所述。Portal Server 對 Web 容器和 Access Manager (或 Access Manager SDK) 有硬性升級相依性，因為它們位於本機上；並對 Directory Server 有非硬性升級相依性，因為它極少位於本機上。
升級發行版本 2 Portal Server
本節描述如何在 Solaris 及 Linux 平台上將 Portal Server 從 Java ES 發行版本 2 升級到 Java ES 發行版本 4。當某個主題依賴平台特定的程序時，該主題將指出其適用的作業系統。本節涵蓋以下主題：
升級前作業
升級 Portal Server 之前，應該執行下述作業。
驗證目前版本資訊
您可使用下列指令驗證 Portal Server 的目前版本；
請參閱表 17-3 取得輸出值。
升級 Portal Server 相依性
Java ES 發行版本 4 不支援單一電腦上發行版本 2 和發行版本 4 共用元件並存。
因此，必須將 Portal Server 依賴的所有本機 Java ES 發行版本 2 元件都升級到發行版本 4。升級電腦上的所有本機 Portal Server 相依性時，應按照下列順序升級它們，且都須在升級 Portal Server 之前進行。請注意，特定升級方案會有特殊需求。
- 共用元件。 升級 Java ES 共用元件中提供了將 Java ES 共用元件升級到發行版本 4 的指示。
- Directory Server。 Portal Server 極少依賴本機 Directory Server。不過，第 4 章「Directory Server 和 Administration Server」中仍提供了將 Directory Server 升級到發行版本 4 的指示。
- Web 容器軟體。 Portal Server 可在 Web Server 或 Application Server 提供的 Web 容器中執行。
- Web Server：依照從 Java ES 發行版本 2 升級 Web Server 中的程序升級到發行版本 4 Web Server。
- Application Server：藉由使用 Java ES 安裝程式執行 Application Server 的全新安裝來升級到發行版本 4 Application Server，而非使用從 Java ES 發行版本 2 升級 Application Server 中的程序來執行升級。請務必先從發行版本 2 Application Server 7 取得管理連接埠和伺服器實例連接埠，再安裝發行版本 4 Application Server 8。
- Access Manager (Access Manager SDK)。 Portal Server 可在 Access Manager 所處的 Web 容器中執行，也可在其他 Web 容器中執行。
- 若 Portal Server 是在不同於 Access Manager 所處的 Web 容器中執行，例如，若 Access Manager 是在遠端執行，請依照從 Java ES 發行版本 2 升級 Access Manager 中的程序將 Access Manager 或 Access Manager SDK 從發行版本 2 升級到發行版本 4。若只升級 Access Manager SDK，請參閱升級發行版本 3 Access Manager SDK，並設定 DEPLOY_LEVEL = 3。
- 若 Portal Server 是在 Access Manager 所處的 Web 容器中執行，且該 Web 容器是由 Web Server 提供的，請依照升級發行版本 2 Access Manager：Web Server Web 容器中的程序將 Access Manager 從發行版本 2 升級到發行版本 4。
- 若 Portal Server 是在 Access Manager 所處的 Web 容器中執行，且該 Web 容器是由 Application Server 提供的，請依照升級發行版本 2 Access Manager：Application Server Web 容器中的程序將 Access Manager 從發行版本 2 升級到發行版本 4，但請務必使用 AS 為全新安裝的方案。
備份 Portal Server 發行版本 2 配置資訊
將 Portal Server 升級到發行版本 4 不需要重新配置 Portal Server 軟體。為安全起見，可以備份下列儲存配置資訊的目錄：
取得必要的配置資訊和密碼
需要以超級使用者身份登入，才能執行升級。如果使用 Web Server 做為 Web 容器，則不需要管理員密碼。不過，如果使用 Application Server 作為 Web 容器，將需要 Application Server 管理員使用者 ID 和密碼。
升級發行版本 2 Portal Server (Solaris)
本節討論影響 Portal Server 升級程序的注意事項，接著提供對程序本身的說明。
升級注意事項 (Solaris)
將 Portal Server 軟體升級到 Java ES 發行版本 4 時要考慮下列注意事項：
- 同時升級對應於同一安裝的 Portal Server 影像的所有 Portal Server 實例。為安裝的影像套用修補程式時，應藉由關閉 Web 容器來關閉所有此類實例。
- 下表顯示適用於 Solaris OS 的發行版本 4 Portal Server 升級修補程式：
- 在 Solaris 平台上升級 Portal Server 的程序取決於 Portal Server 是部署在由 Web Server 還是 Application Server 提供的 Web 容器中。因此，下面分別針對這兩種 Web 容器提供了不同的升級指示。
升級程序 (Solaris：Web Server)
下述程序適用於位於執行升級的電腦上的 Portal Server。
- 根據表 17-6 取得所需的修補程式。
請務必下載表 17-6 中顯示的修補程式修訂版，但 Portal Server 修正除外，它可能已有更新的修補程式。
可從下列位置將修補程式下載到 /tmp：http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access
- 請以超級使用者身份登入或成為超級使用者。
su -
- 停止 Portal Server，方法是停止它的 Web 容器。
WebServer-base/https-instanceName/stop
- 如果尚未升級所有共用元件、Web 容器和 Access Manager (或 Access Manager SDK)，請執行此動作。
- 若尚未執行 Directory Server 和 Access Manager，請執行它們。
- 套用表 17-6 中相應的 Portal Server 修補程式。
請務必依修補程式在表 17-6 中的顯示順序自上而下套用修補程式。
patchadd patch_ID
- 確認修補程式升級成功：
showrev -p | grep patch_ID
輸出應傳回步驟 7 中套用的修補程式 ID 版本。
- 重新配置 Portal Server 軟體：
ksh
$ cd PortalServer-base/lib
$ ./upgradePS04Q205Q1- 重新啟動 Portal Server，方法是重新啟動它的 Web 容器。
WebServer-base/https-instanceName/start
- 將 Portal Server Web 應用程式重新部署到 Web 容器。
PortalServer-base/bin/deploy redeploy
redeploy 指令會將 PortalServer-base/web-src 中的內容重新部署到 /var/PortalServer-base/https-hostName/deploy-dir/web-apps。因此，若要對 Portal Server Web 應用程式進行任何自訂，應先對 /web-src 進行這些自訂，然後將它們重新部署到 /web-apps。執行 deploy 指令之前，應在 /web-src 中複製您可能會在 /web-apps 下進行的任何變更。否則，此類變更將被覆寫。
- 停止 Web 容器，然後將其重新啟動。
儘管並不需要在所有情況下都重新啟動 Web 容器，但這樣做可確保 Portal Server 在未修改的狀態下啟動。
升級程序 (Solaris：Application Server)
下述程序適用於位於執行升級的電腦上的 Portal Server。
- 根據表 17-6 取得所需的修補程式。
請務必下載表 17-6 中顯示的修補程式修訂版，但 Portal Server 修正除外，它可能已有更新的修補程式。
可從下列位置將修補程式下載到 /tmp：http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access
- 請以超級使用者身份登入或成為超級使用者。
su -
- 確定 Portal Server 已不再於它的發行版本 2 Application Server 實例中執行。
AppServerConfig7-base/domains/domainName/instanceName/bin/stopserv
以上指令及後續步驟中使用了下列慣例：
- 如果尚未升級所有共用元件、Web 容器和 Access Manager (或 Access Manager SDK)，請執行此動作。
- 確定升級後的 Access Manager 已不再於它的發行版本 4 Application Server 實例中執行。
AppServer8-base/bin/asadmin stop-domain domainName
- 確定 Access Manager 配置檔案，即
AccessManagerConfig-base/config/AMConfig.properties
包含下列特性值：
com.iplanet.am.notification.url=
http://hostName:port/amserver/notificationservice
com.sun.identity.webcontainer=IAS8.1
com.iplanet.am.cookie.encode=true其中 hostName:port 是託管 Access Manager 實例的電腦和連接埠。
- 套用表 17-6 中相應的 Portal Server 修補程式。
請務必依修補程式在表 17-6 中的顯示順序自上而下套用修補程式。
patchadd patch_ID
- 確認修補程式升級成功：
showrev -p | grep patch_ID
輸出應傳回步驟 7 中套用的修補程式 ID 版本。
- 確定 Portal Server 配置檔案，即
PortalServerConfig-base/PSConfig.properties
包含下列特性值，它們參照 Application Server 的 Domain Administration Server (DAS) 實例：
DEPLOY_TYPE=SUNONE8DEPLOY_INSTANCE_DIR=AppServer8Config-base/domains/domainName
DEPLOY_DOMAIN=AppServer8Config-base/domains/domainName
DEPLOY_PRODUCT_DIR=AppServer8Config-base/domains/domainName
DEPLOY_ADMIN_PROTOCOL=https
DEPLOY_ADMIN_PORT=DAS_adminPort (例如，預設值=4848)
DEPLOY_ADMIN_HOST=DAS_hostName
LOAD_BALANCER_URL=http://DAS_hostName:DAS_hostPort/portal
DEPLOY_DOCROOT=AppServer8Config-base/domains/domainName/docroot
PS_PORT=DAS_hostPort (例如，預設值=80)
DEPLOY_DIR=AppServer8-base
PS_PROTOCOL=http假設指定給全新發行版本 4 Application Server 8 安裝的連接埠值與發行版本 2 Application Server 7 安裝的連接埠值相同，且這些值是預設連接埠值，則以上所示的預設值將適用。
- 按以下所述修改 PSconfig.properties 檔案：
DEPLOY_INSTANCE=temporary_instanceName
其中 temporary_instanceName 是未使用的暫時值。
- 確定 DAS 正在執行。
AppServer8-base/bin/asadmin start-domain --user admin_ID
--password password domainName- 執行下列指令：
cd PortalServer-base/bin
./multiserverinstancemultiserverinstance 程序檔提出的若干問題使用 PSConfig.properties 檔案中設定的值，這些值在步驟 9 中顯示為預設值，以下指示假定這些預設值是正確的。
按以下所述回應 multiserverinstance 程序檔提出的問題：
1. 對於 Create a new portalserver instance (建立新的 portalserver 實例)，選取選項 1。
2. 對於 Sun Java System Application Server 8.1，選取選項 3。
3. Where is the Web Container installed? (Web 容器安裝在何處？) 按 return 鍵。
4. What is the domain name? (網域名稱為何？) 按 return 鍵。
5. What is the domain (DAS) path? (網域 (DAS) 路徑為何？) 輸入顯示為問題 #4 預設值的那個值。
6. What is the Web Container instance path? (Web 容器實例路徑為何？) 輸入為問題 #5 輸入的值。
7. What is the Web Container administrator? (Web 容器管理員為何？) 按 return 鍵。
8. What is the Web Container administration port? (Web 容器管理連接埠為何？) 按 return 鍵。
9. Is the Web Container administration port secure? (Web 容器管理連接埠是否安全？) 按 return 鍵。
10. Instance name? (實例名稱？) 輸入值 server。
11. Instance port? (實例連接埠？) 輸入在 PSConfig.properties 檔案中為 PS_PORT 值所輸入的值。
12. Is the instance port secure? (實例連接埠是否安全？) 按 return 鍵。
13. What is the Web Container document root directory? (Web 容器文件根目錄為何？) 按 return 鍵。
14. What is the Application Server administration password? (Application Server 管理密碼為何？) 輸入密碼。
15. What is the Identity Server administration password? (Identity Server 管理密碼為何？) 輸入密碼。- 按以下所述修改 PSconfig.properties 檔案：
DEPLOY_INSTANCE=server
其中值 server 是 DAS 實例的預設實例名稱。
- 重新啟動 DAS。
AppServer8-base/bin/asadmin stop-domain domainName
AppServer8-base/bin/asadmin start-domain --user admin_ID
--password password domainName- 部署 Portal Server Web 應用程式。
cd PortalServer-base/bin
./deploy redeploy忽略指示 deploy.log 中可能有錯誤的訊息。
redeploy 指令會將 PortalServer-base/web-src 中的內容重新部署到 /var/PortalServer-base/https-hostName/deploy-dir/web-apps。因此，若要對 Portal Server Web 應用程式進行任何自訂，應先對 /web-src 進行這些自訂，然後將它們重新部署到 /web-apps。執行 deploy 指令之前，應在 /web-src 中複製您可能會在 /web-apps 下進行的任何變更。否則，此類變更將被覆寫。
- 重新配置 Portal Server 軟體：
ksh
$ cd PortalServer-base/lib
$ ./postinstall_PortletSamples
$ ./upgradePS04Q205Q1忽略由 upgradePS04Q205Q1 程序檔發出的與 CLI137 及 (un)deploy 有關的錯誤。
- 重新啟動 DAS。
AppServer8-base/bin/asadmin stop-domain domainName
AppServer8-base/bin/asadmin start-domain --user admin_ID
--password password domainName儘管並不需要在所有情況下都重新啟動 Web 容器，但這樣做可確保 Portal Server 在未修改的狀態下啟動。
- 更新 Portal Server 顯示設定檔
- 執行下列指令：
PortalServer-base/bin/dpadmin list -g -u amadminDN
-w amadminPassword /tmp/GlobalDP.xml其中 amadminDN 的值可在 AccessManagerConfig-base/config/AMConfig.properties 檔案的 com.sun.identity.authentication.super.user 特性中找到。
- 開啟檔案 /tmp/GlobalDP.xml 以進行編輯
- 將以下值：
org.apache.xalan.xsltc.trax.TransformerFactoryImpl
修改為
com.sun.org.apache.xalan.internal.xsltc.trax.
TransformerFactoryImpl- 將出現的所有以下值：
Sun JavaTM System Portal Server 6 2004Q2
修改為
Sun JavaTM System Portal Server 6 2005Q4- 執行下列指令：
PortalServer-base/bin/dpadmin modify -g -u amadminDN
-w amadminPassword /tmp/GlobalDP.xml其中 amadminDN 的值與它在步驟 a 中的值相同。
升級發行版本 2 Portal Server (Linux)
本節討論影響 Portal Server 升級程序的注意事項，接著提供對程序本身的說明。
升級注意事項 (Linux)
除了 Linux 發行版本 4 升級修補程式與 Solaris 修補程式不同以外，其餘在 Linux 平台上將 Portal Server 軟體升級到 Java ES 發行版本 4 所要考慮的注意事項與在 Solaris 平台上升級時要考慮的注意事項相同 (請參閱升級注意事項 (Solaris))。
下表顯示適用於 Linux OS 的發行版本 4 Portal Server 升級修補程式：
升級程序 (Linux：Web Server)
下述程序適用於位於執行升級的電腦上的 Portal Server。
- 使用表 17-7 中的修補程式號碼和 RPM 名稱來取得所需的修補程式。使用此資訊以取得 RPM 的版本號碼。
可從下列位置將修補程式下載到 /tmp：http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access
- 請以超級使用者身份登入或成為超級使用者。
su -
- 停止 Portal Server，方法是停止它的 Web 容器。
WebServer-base/https-instanceName/stop
- 如果尚未升級所有共用元件、Web 容器和 Access Manager (或 Access Manager SDK)，請執行此動作。
- 若尚未執行 Directory Server 和 Access Manager，請執行它們。
- 套用表 17-7 中的 Portal Server RPM。
- cd /tmp
其中 /tmp 是將步驟 1 中的修補程式下載到的目錄。
- 解壓縮 118020 修補程式檔案，閱讀 README 檔案，然後執行下列程序檔：
./upgradeportalrpms
upgradeportalrpms 程序檔會安裝 RPM，並會確保套用修補程式後發生正確的配置變更。
- 解壓縮 119529 修補程式檔案，並從解壓縮修補程式時建立的目錄內執行 ./update 程序檔。
- 解壓縮 118952 修補程式檔案，並從解壓縮修補程式時建立的目錄內執行 ./update 程序檔。
- 確認修補程式升級成功：
rpm -qa | grep sun-portal
rpm -qa | grep sun-mobileaccess應傳回 RPM 的新版本編號。
- 重新配置 Portal Server 軟體：
ksh
$ cd PortalServer-base/lib
$ ./upgradePS04Q205Q1- 按以下所述編輯 PortalServer-base/export/deploy.import 檔案：
若有以下內容：
%JATO_LIB_DIR%/jato.tld %WEB_SRC_DIR%/WEB-INF/jato.tld
%JATO_LIB_DIR%/jato.jar %WEB_SRC_DIR%/WEB-INF/lib/jato.jar將其替代為：
/usr/share/lib/jato/jato.tld %WEB_SRC_DIR%/WEB-INF/jato.tld
/usr/share/lib/jato/jato.jar %WEB_SRC_DIR%/WEB-INF/lib/jato.jar也就是將 %JATO_LIB_DIR% 替代為 /usr/share/lib/jato
- 重新啟動 Portal Server，方法是重新啟動它的 Web 容器。
WebServer-base/https-instanceName/start
- 將 Portal Server Web 應用程式重新部署到 Web 容器。
PortalServer-base/bin/deploy redeploy
redeploy 指令會將 PortalServer-base/web-src 中的內容重新部署到 /var/PortalServer-base/https-hostName/deploy-dir/web-apps。因此，若要對 Portal Server Web 應用程式進行任何自訂，應先對 /web-src 進行這些自訂，然後將它們重新部署到 /web-apps。執行 deploy 指令之前，應在 /web-src 中複製您可能會在 /web-apps 下進行的任何變更。否則，此類變更將被覆寫。
- 停止 Web 容器，然後將其重新啟動。
儘管並不需要在所有情況下都重新啟動 Web 容器，但這樣做可確保 Portal Server 在未修改的狀態下啟動。
升級程序 (Linux：Application Server)
下述程序適用於位於執行升級的電腦上的 Portal Server。
- 根據表 17-7 取得所需的修補程式。
請務必下載表 17-7 中顯示的修補程式修訂版，但 Portal Server 修正除外，它可能已有更新的修補程式。
可從下列位置將修補程式下載到 /tmp：http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access
- 請以超級使用者身份登入或成為超級使用者。
su -
- 確定 Portal Server 已不再於它的發行版本 2 Application Server 實例中執行。
AppServerConfig7-base/domains/domainName/instanceName/bin/stopserv
以上指令及後續步驟中使用了下列慣例：
- 如果尚未升級所有共用元件、Web 容器和 Access Manager (或 Access Manager SDK)，請執行此動作。
- 確定升級後的 Access Manager 已不再於它的發行版本 4 Application Server 實例中執行。
AppServer8-base/bin/asadmin stop-domain domainName
- 確定 Access Manager 配置檔案，即
AccessManagerConfig-base/config/AMConfig.properties
包含下列特性值：
com.iplanet.am.notification.url=
http://hostName:port/amserver/notificationservice
com.sun.identity.webcontainer=IAS8.1
com.iplanet.am.cookie.encode=true其中 hostName:port 是託管 Access Manager 實例的電腦和連接埠。
- 套用表 17-7 中的 Portal Server RPM。
- cd /tmp
其中 /tmp 是將步驟 1 中的修補程式下載到的目錄。
- 解壓縮 118020 修補程式檔案，閱讀 README 檔案，然後執行下列程序檔：
./upgradeportalrpms
upgradeportalrpms 程序檔會安裝 RPM，並會確保套用修補程式後發生正確的配置變更。
- 解壓縮 119529 修補程式檔案，並從解壓縮修補程式時建立的目錄內執行 ./update 程序檔。
- 解壓縮 118952 修補程式檔案，並從解壓縮修補程式時建立的目錄內執行 ./update 程序檔。
- 確認修補程式升級成功：
rpm -qa | grep sun-portal
rpm -qa | grep sun-mobileaccess應傳回 RPM 的新版本編號。
- 按以下所述編輯 PortalServer-base/export/deploy.import 檔案：
若有以下內容：
%JATO_LIB_DIR%/jato.tld %WEB_SRC_DIR%/WEB-INF/jato.tld
%JATO_LIB_DIR%/jato.jar %WEB_SRC_DIR%/WEB-INF/lib/jato.jar將其替代為：
/usr/share/lib/jato/jato.tld %WEB_SRC_DIR%/WEB-INF/jato.tld
/usr/share/lib/jato/jato.jar %WEB_SRC_DIR%/WEB-INF/lib/jato.jar也就是將 %JATO_LIB_DIR% 替代為 /usr/share/lib/jato
- 遵循升級程序 (Solaris：Application Server) 下步驟 9 至步驟 18 的指示。
驗證升級
驗證 Portal Server 是否升級到發行版本 4 的方法是確認是否已正確套用升級修補程式。升級程序 (Solaris) 和升級程序 (Linux) 中包含此驗證的步驟。
此外，也可使用下列指令：
請參閱表 17-3 取得輸出值。
除了這些對修補程式升級的測試外，還可驗證以前正常運作的元件是否仍在正常運作及所關心的錯誤修正確已得到修正。
升級後作業
除了在升級程序 (Solaris：Application Server) 和升級程序 (Linux：Web Server) 中所述的步驟之外，沒有升級後的作業。
回復升級
無法回復 Portal Server 從發行版本 2 到發行版本 4 的升級。
多重實例升級
在某些部署架構中，會將 Portal Server 部署在多個電腦系統上，以提供延展性並提高可用性。例如，可以讓 Portal Server 元件在多台電腦上執行，並透過負載平衡器來分散負載。
若 Portal Server 實例已達負載平衡，則可以執行串聯式升級，即依序升級 Portal Server 實例而不中斷服務。升級 Portal Server 的每個實例時其他實例仍可繼續執行。需要按照升級發行版本 2 Portal Server 中所述的方式升級每個實例。