管理

本節介紹已知的管理問題以及相關的解決方案。

如果 domain1 不存在，則 package-appclient 程序檔無法使用 (6171458)

說明

依預設，在 $INSTALL/lib/package-appclient.xml 中，asenv.conf 指向的 domain1 之 AS_ACC_CONFIG 變數有一個程序內定值。如果刪除 domain1 並建立新網域，則不會使用新網域名稱更新 AS_ACC_CONFIG 變數，這將導致 package-appclient 程序檔失敗。

解決方案

執行下列動作之一：

1. 保持 domain1 不變，並在其周圍建立其他網域。

2. 移除 domain1 並使用新網域名稱替代 $INSTALL/lib/package-appclient.xml 中 domain1 的程序內定值。

如果 domain1 不存在，則每次建立新的網域時均必須執行此作業。

無法使用其他名稱復原備份的網域 (6196993)

說明

無法使用 backup-domain 和 restore-domain 指令在同一 Application Server 安裝上執行網域鏡像，因為即使 asadmin restore-domain 指令提供了重新命名網域的選項，您還是無法使用與原始名稱不同的名稱復原網域。重新命名備份的網域看似成功，但嘗試啟動已重新命名的網域卻失敗，因為網域配置中的項目並未變更，並且 startserv 和 stopserv 仍使用原始的網域名稱來設定路徑。

解決方案

用於 restore-domain 的網域名稱必須與用於原始 backup-domain 指令的網域名稱相同。Application Server 8.1 中的 backup-domain 和 restore-domain 指令僅在同一機器上備份和復原同一網域時有效。

不支援同時啟動 Application Server 和其他 JMX 代理程式 (6200011)

說明

在 Application Server 上可以配置 J2SE 1.4.x、5.0 或更高版本。啟動 JMX 代理程式是 J2SE 5.0 平台不可或缺的功能。如果您在伺服器啟動時明確設定系統特性，則會啟動此功能。

範例值包含︰

name="com.sun.management.jmxremote" value="true"
name="com.sun.management.jmxremote.port" value="9999"
name="com.sun.management.jmxremote.authenticate" value="false"
name="com.sun.management.jmxremote.ssl" value="false"

在配置 JMX 特性並啟動伺服器之後，會在 Application Server Virtual Machine 上啟動新的 jmx-connector 伺服器。這一過程的不良副作用是會對管理功能造成不利影響，並且 Application Server 管理主控台和指令行介面可能會產生未預期的結果。問題在於內建 jmx-connector 伺服器與新的 jmx-connector 伺服器之間存在衝突。

解決方案

如果使用 jconsole (或任何其他與 JMX 相容的用戶端)，請考慮重新使用在 Application Server 啟動時一起啟動的標準 JMX Connector Server。

該伺服器啟動後，server.log 中會顯示與以下所示類似的行。您可連線至其中指定的 JMXService URL，並在成功提供憑證之後執行相同的管理/配置作業；例如：

[#|2004-11-24T17:49:08.203-0800|INFO|sun-appserver-ee8.1|
javax.enterprise.system.tools.admin|_ThreadID=10;|ADM1501: 
Here is the JMXServiceURL for the JMXConnectorServer: 
[service:jmx:rmi:///jndi/rmi://hostname:8686/management/
rmi-jmx-connector]. This is where the remote administrative 
clients should connect using the JSR 160 JMX Connectors.|#]

如需更多資訊，請參閱「Sun Java System Application Server 9.1 Administration Guide」。

在 UNIX 上，對 Application Server 啟動和停止程序檔的執行權限限制性過嚴 (6206176)

說明

如果您在以使用者「A」的身份登入時執行 asadmin restore-domain 指令，程序檔會以權限 744 (rwxr--r--) 結束。如果您隨後嘗試以使用者「B」的身份 (即使「B」為超級使用者) 啟動或停止網域，則此操作會失敗，因為僅可對「A」執行這些程序檔。

解決方案

變更程序檔的權限︰

chmod 755 appserv/domains/domain-name/bin/*

負載平衡程式配置檔案不能使用任何 Web 服務的端點 URL 建立 (6236544、6275436)

說明

在使用包含可匯出 Web 服務 URL 之 EJB 模組的應用程式來設定負載平衡程式配置時，此 Web 服務的環境根目錄不包含在所產生的 loadbalancer.xml 檔案中。

解決方案

1. 編輯 loadbalancer.xml 檔案，按照以下所示增加缺少的 Web 模組：

   <web-module context-root="context-root-name" disable-timeout-in-minutes="30" enabled="true"/>

2. 使用顯示為 EJB 的 Web 服務的環境根目錄名稱替代 context-root-name 值。

Application Server 使用 sun-appserv-admin 重新啟動導致出現 LoginException 錯誤 (6288893)

解決方案

1. 將現有的 <as_install>/bin/asant 程序檔重新命名為 asant.bak。

2. 將 <as_install>/lib/install/templates/ee (對於 SE/EE 版本) 中的 asant.template 檔案複製到 <as_install>/bin/ 目錄中並重新命名 asant 檔案。

3. 編輯新複製的 <as_install>/bin/asant 程序檔，並使用 <as_install>/config 替代 %CONFIG_HOME% 記號。

4. 如果對原始的 asant.bak 檔案進行了任何手動變更，請將這些變更合併至新的 asant 程序檔。

.asadmintruststore 檔案未在 Application Server 文件中介紹 (6315957)

說明

在 Application Server 文件中未說明 .asadmintruststore 檔案。如果伺服器管理員的 home 目錄中不存在此檔案，則升級在此伺服器上代管的某些應用程式時，可能會遇到嚴重錯誤。

解決方案

• 如果可能，應由安裝此伺服器的使用者執行 asadmin start-domain domain1 指令。

• 如果未由該使用者執行，則應從安裝使用者的 home 目錄中將 .asadmintruststore 移動或複製到執行使用者的 home 目錄。

• 請注意，如果將此檔案從安裝使用者的 home 目錄移動 (而非複製) 到執行使用者的 home 目錄，您可能會遇到應用程式升級問題 (例如在錯誤 6309079、6310428 和 6312869 中說明的問題)，因為在升級/安裝使用者 (在 Java ES 中一般為 root) 的 home 目錄中將不再包含 .asadminstruststore 檔案。

叢集實例由於連接 JMS 代理程式逾時而無法啟動 (6523663)

說明

Application Server 叢集實例的預設 MQ 整合模式為 LOCAL。當 Application Server 的安裝位置 (PATH) 很長 (顯示為「not short」) 時，imqbrokerscv.exe 便會在叢集實例啟動時當機。此問題屬於 imqbrokersvc 中的記憶體分配問題。

解決方案

叢集實例的 JMS 服務類型必須從預設的 LOCAL 變更為 REMOTE。在該配置中，所有實例都指回 DAS 代理程式。請依照以下說明在 REMOTE 模式中配置叢集。

當使用 REMOTE 模式時，所有實例均使用一個代理程式 (DAS)，因此在 Application Server 叢集啟動時，不會建立任何代理程式叢集。如需更多資訊，請參閱 http://www.glassfishwiki.org/gfwiki/attach/OnePagersOrFunctionalSpecs/as-mq-integration-gfv2.txt 這一頁中第 4.1 節，第 iii 部分中的「Auto-clustering」。上述功能將無法使用！

使用指令行

開始之前

依據您的環境修改連接埠與密碼檔案。請注意，在以下說明中，叢集名稱為 racluster，DAS 管理連接埠為 5858，DAS JMS 連接埠為 7676。

1. 修改叢集配置，將 JMS 類型變更為 REMOTE。

   $AS91_HOME/bin/asadmin.bat set --port 5858 --user admin --passwordfile \ $AS91_HOME/bin/password_file racluster.jms-service.type=REMOTE

2. 建立與 DAS JMS 主機對應的 JMS 主機。

   $AS91_HOME/bin/asadmin.bat create-jms-host --port 5858 --user admin --passwordfile \ $AS91_HOME/bin/password_file --target racluster --mqhost localhost --mqport 7676 \ --mquser admin --mqpassword admin dashost

3. 將預設 JMS 主機設定為在上一步驟中建立的 DAS JMS 主機。

   $AS91_HOME/bin/asadmin.bat set --port 5858 --user admin --passwordfile \ $AS91_HOME/bin/password_file racluster.jms-service.default-jms-host=dashost

使用管理 GUI

1. 移至 [配置] -> [cluster_name-config] -> [Java 訊息服務] -> [JMS 主機]。

2. 按一下 [新增] 以建立新的 JMS 主機，將其命名為 dashost。

3. 輸入與 DAS 的 JMS 服務對應的配置設定，預設設定如下所示︰

   • 主機名稱︰localhost

   • 連接埠︰7676

   • 管理使用者︰admin

   • 密碼︰admin

   依據您 DAS JMS 服務的需要修改上述設定。

4. 瀏覽回 [Java 訊息服務] 標籤，然後將 JMS 服務類型變更為 REMOTE (預設為 LOCAL)。

5. 從 [default-jms-host] 下拉式清單中選擇 [dashost]。

6. 儲存變更，然後啟動節點代理程式或叢集。

無法在 Netscape 8.1.3、Mozilla 1.7 和 Safari 2.0.4 等瀏覽器中顯示 jmaki 圖表 (6543014)

說明

當嘗試使用某些不支援的瀏覽器顯示 [記錄統計監視] 頁面中的圖表時，可能會丟出以下錯誤︰

Error loading jmaki.widgets.jmaki.charting.line.Widget : id=form1:jmaki_chart11
Script: http://easqelx5.red.iplanet.com:4848/resources/jmaki/charting/ \
line/component.js (line:5437).
Message: area.initialize is not a function

解決方案

使用支援的瀏覽器。請參閱瀏覽器，以取得 Application Server 9.1 支援的瀏覽器清單。

預設連接埠在每個 AS 重大發行版本中都有所變更 (6566481)

說明

預設管理連接埠在過去的三個重大 Application Server 發行版本中均不相同。具體而言，7.x、8.x 和 9.x 中的預設管理連接埠分別為︰

• AS 7.x：4848

• AS 8.x：4849

• AS 9.x：4848

解決方案

這不是錯誤，但也是一個值得注意的問題。預設管理連接埠只是一個建議使用的連接埠。預期未來的 Application Server 發行版本將保留預設的 4848 連接埠。