升級公用程式
本節介紹已知的升級公用程式問題和相關的解決方案。
在 as-install/domains 目錄之外的自訂路徑中建立的網域無法直接升級 (6165528)
說明
從 Application Server Enterprise Edition 8 升級至 Application Server Enterprise Edition 8.1 時，在 as-install/domains 目錄之外的自訂路徑中建立的網域無法直接升級。
當執行升級公用程式，並將 as-install 指定為來源安裝目錄時，升級程序僅升級在 as-install/domains 目錄下建立的網域。在其他位置建立的網域不會進行升級。
解決方案
在啟動升級程序之前，將不同位置的所有網域目錄複製到 as-install/domains 目錄中。
在某些 Linux 系統上，按一下 [啟動升級精靈] 按鈕之後，執行「現地升級」的安裝程式無法啟動升級工具 (6207337)
說明
此問題已在多個 Linux 系統中出現，在 Java Desktop System 2 中最常見，但也見於 Red Hat 發行軟體中。
在最終的安裝程式螢幕上按一下 [啟動升級工具] 按鈕之後，安裝程式無法啟動升級工具以完成升級程序，且無限期當機，並且不返回指令提示符號。
解決方案
如果使用指令行安裝模式現地執行升級，則不會遇到此問題。
-
如果在 GUI 模式中現地執行升級並遇到此問題，請在啟動安裝程式的終端機視窗中按下 Ctrl+C，以退出安裝程式。
-
使用以下指令從終端機視窗中啟動升級工具：
as-install/bin/asupgrade --source as-install/domains --target as-install --adminuser adminuser --adminpassword adminpassword --masterpassword changeit
adminuser 和 adminpassword 應符合用於要升級之安裝的值。
-
當升級工具完成升級程序後，您還可以啟動瀏覽器並輸入以下 URL 以檢視 [關於] 頁面：
file://as-install/docs-ee/about.html
如果您還選取安裝選項以註冊產品，請使用產品 [關於] 頁面上的連結進入註冊頁面。
自我簽署憑證在從 8.0 Platform Edition (PE) 到 8.1 Enterprise Edition (EE) UR2 的升級期間和升級之後均不受信任 (6296105)
解決方案
從目標 domain.xml 中移除以下項目 (升級後)，然後重新啟動伺服器：
<jvm-options>-Djavax.net.ssl.keyStore=${com.sun.aas.instanceRoot}
/config/keystore.jks</jvm-options>-
<jvm-options>Djavax.net.ssl.trustStore=${com.sun.aas.instanceRoot}
/config/cacerts.jks</jvm-options>
升級工具覆寫某個實例 (叢集成員) 的已修改 index.html 之內容 (6386451)
說明
升級工具覆寫伺服器實例的現有 index.html 檔案。
解決方案
在執行升級工具之前備份現有的 index.html 檔案，接著在以後復原這些檔案。
(sbs-manual、sbs-installer) 丟出「伺服器實例，伺服器沒有名為 null 的系統連接器」的錯誤 (6545145)
說明
從 Application Server 8.0PE 升級到 9.1 Update 1 時，將丟出錯誤，指明伺服器沒有名為 null 的系統連接器，同時 sbs-manual 中顯示無效的使用者資訊。即使在變更程序內定值之後，也會出現相同的錯誤訊息。出現此錯誤是因為 8.0 中的 domain.xml 在 9.1 中已變更。
解決方案
此錯誤僅在從 8.0 PE 升級到 9.1 時會出現。解決方法是先升級到 8.1、8.2 或 9.0，然後再升級到 9.1。
使用不同的建置組合時，不同的網域會在升級期間遺失 (6546130)
說明
執行現地升級時，如果來源中具有多個網域，則即使終止程序，安裝程式也會呼叫升級工具。在 GUI 模式中進行呼叫時會出現這種狀況。
解決方案
-
以 CLI 模式進行現地安裝，在安裝程序結束時，安裝程式會提示您選取升級工具。請在此時結束。這樣便不會刪除網域目錄中的任何網域。應該從 bin 目錄手動呼叫升級工具。
-
以 GUI 模式進行現地安裝時，請對網域根目錄中的網域進行備份，防止在過程中遺失任何網域。在安裝程序結束時，安裝程式會提示您呼叫升級工具，請在此時結束。如果有任何網域遺失，請將備份網域複製到網域目錄。手動啟動升級工具以執行升級。
Solaris︰升級工具中預先填入的主密碼來自 AS9.1，而非 AS8.2 (6565825)
說明
從 AS 8.2 升級到 9.1 時，9.1 安裝不會繼承 8.2 安裝中的主密碼。這樣，會在下一次管理登入時導致認證錯誤。
解決方案
Application Server 9.1 Update 1 中的預設管理密碼為 changeit。從 8.2 升級之後，為了避免在登入 9.1 伺服器時出現問題，請執行以下三個步驟之一︰
-
在執行升級之前，將 8.2 管理密碼變更為 changeit。
-
請勿在升級程序期間接受預設管理密碼，而是明確輸入要使用的密碼。
-
使用預設密碼登入 9.1，然後立即變更密碼。
AS9.1 IFR 升級工具無法將 JES5U1 MQ 儲存區遷移至新的 var 主目錄 (6573635)
說明
升級工具不會升級資料庫或任何格式的資料庫表格，也不支援此動作。將傳輸資源參照配置，並且 Application Server 應該繼續使用原始資料庫和表格。如果要變更資料庫或傳輸資料庫表格，請使用可用於使用中的資料庫的工具。
解決方案
執行以下步驟以遷移 MQ 儲存區：
備註 –
請在關閉 AS 8.2 和執行 AS9.1 升級工具之後，並在首次啟動 AS9.1 之前，執行以下步驟。如果您已經在 IFR 安裝/升級之後啟動了 AS 9.1，請勿執行這些步驟，因為這樣可能會造成 MQ 訊息儲存區不穩定。
-
將整個 domain-dir/imq 子目錄從 AS 8.x domains 目錄複製到 AS 9.1 domains 目錄。
-
確保該目錄及其檔案的所有權歸將要執行 Application Server 的使用者所有。
執行完上述步驟之後，便可啟動 Application Server 9.1 Update 1，並且 Application Server 9.1 Update 1. domains 目錄中的 MQ 儲存區將從 JES5 U1 格式遷移至 MQ 4.1 格式。請注意，執行此程序或者在 AS 9.1 啟動 MQ4.1 時將保留 AS 8.2 下的原始 JES5 U1 MQ 儲存區，不會對其進行修改。
將 JES5 (AS 8.2) 升級到 AS 9.1。PS Community 範例無法使用，出現許多 javax.faces 錯誤 (6576700)
說明
從 JES5 (Application Server 8.2) 升級到 Application Server 9.1 Update 1 時，Portal Server Community 範例無法再使用，並丟出許多 javax.faces.application.ApplicationFactory 錯誤。
解決方案
如果 Application Server 8.2 是透過 JES5 Portal Server 安裝的，則不支援從 Application Server 8.2 升級到 9.1 Update 1。在 Application Server 升級到 9.1 Update 1 之前，需要先將 Portal Server 升級到 Java ES 5 Update 1。
AS91 IFR b58，Linux：使用安裝程式安裝新的 Java 之後，/usr/jdk/entsys-j2se 連結無法更新 (6591697)
說明
在 Linux 平台上使用 IFR 安裝程式從 Application Server 8.2 升級到 9.1 Update 1 時，選取 [安裝 JDK] 選項，但在成功完成安裝之後，大多數 JES 元件無法使用。
解決方案
此問題僅影響在 Linuxs 平台上執行的 Application Server 9.1 Update 1 IFR 安裝，並且僅在選取 [安裝 JDK] 選項之後出現。若要解決此問題，請在安裝之後立即手動將 /usr/jdk/entsys-j2se 連結到 /usr/java/jdk1.5.0_12 目錄。
AS9.1 IFR Win 現地備份無法與 asupdate.bat 表單值整合，檢查路徑錯誤 (6596412)
說明
在 Windows 上執行 Application Server 9.1 Update 1 IFR 升級時，現地備份無法與 asupdate.bat 表單值正確整合。具體而言，如果您在 ASupdate.bat GUI 螢幕中輸入錯誤資訊，然後按 [下一步]，升級安裝程式便會嘗試偵測升級是否為現地升級。如果是，domain1 便會在升級之前移至備份目錄。如果輸入的資訊有誤，會在升級繼續時顯示一則錯誤訊息。當您嘗試立即校正錯誤時，系統會丟出路徑錯誤，因為 domain1 已被移動。
解決方案
將來源目錄變更為 current-source-path/backup 中的 domain1_timestamp 目錄，或者使用 [取消] 按鈕結束安裝程式，然後再重新啟動。
AS9.1 IFR Windows，內嵌升級，在將 asupgrade.bat 與短路徑和長路徑配合使用時會刪除 Domain1 (6596394)
說明
(僅適用於 Windows) 如果在程式目錄路徑中使用特殊字元或 DOS 樣式短名稱安裝了舊版 Application Server，並且在後續現地升級到 Application Server 9.1 Update 1 時使用這些目錄路徑名稱，則升級將失敗。
例如，如果 Application Server 8.2 安裝於以下任一目錄︰
C:\Program Files (x86)\dirs\appserver c:\progra~2\dirs\appserver |
在嘗試現地升級到 9.1 Update 1 時會失敗，因為安裝程式無法將短名稱或特殊字元轉換為所需的長名稱格式。
解決方案
強烈建議不要使用包含特殊字元或 DOS 樣式短名稱截斷 (如 progra~2) 的路徑名稱安裝 Application Server，因為這樣會影響後續的升級安裝。如果存在此類安裝，請在升級之前使用長路徑名稱重新安裝，或者在全新的目錄中安裝新版 Application Server。
AS 9.1 IFR︰Web UI 認證失敗 (6569813)
說明
升級 Application Server 之後，<jsp:forward> 標記無法在 Authenticate.jsp 中按預期執行。<jsp:forward> 呼叫會在伺服器記錄中產生錯誤，並且在 Web UI 上顯示空白頁面。問題在於 Authenticate.jsp 中的 <jsp:forward> 需要一個類似 <jsp:forward page="${redirectPage}"/> 的頁面屬性，但傳送的值是類似 /registry/thin/{pagename}.jsp 的相對路徑，即使 Authenticate.jsp 是純 JSP 頁面，此相對路徑也不起作用。
解決方案
完成 Application Server 升級之後，使用 asadmin 工具執行以下指令以設定 domain.xml 中的 <auth-realm>︰
-
轉至 as-install/bin 並執行下列指令：
./asadmin delete-auth-realm --host localhost --port 6489 certificate
將移除舊的 auth-realm 憑證 (如果存在)。
-
執行以下指令︰
./asadmin create-auth-realm --terse=false --echo=true --interactive=true \ --user admin --host localhost --port 6489 --classname \ com.sun.enterprise.security.auth.realm.certificate.CertificateRealm \ --property assign-groups=have.client.cert certificate
將建立具有 assign-groups 特性的新 <auth-realm>。
-
停止並重新啟動 Application Server registry 網域。
不存在已本土化的 asupgrade GUI 線上說明 (6610170)
說明
在非英文語言中執行 asupgrade GUI 時，沒有針對所選取非英文語言的 GUI 線上說明進行本土化。
解決方案
目前尚無解決方案。已排定將線上說明本土化為所有非英文目標語言。
在具有多個網域情況下進行升級 (反向順序) 時，升級工具會刪除 nodeagents 目錄 (6636871)
說明
在同時升級含有多個網域的配置之後，只有最後處理之網域的節點代理程式會存在。此問題起因於每次升級工具處理網域時，都會移除目標中的 nodeagents 目錄，再重新建立該目錄。
解決方案：在同時升級多個網域時保留所有節點代理程式
- © 2010, Oracle Corporation and/or its affiliates