本章列出了您可能遇到的常見問題,以及建立與啟用錯誤記錄的步驟。
本章包含以下各節:
Communications Express 提供了整合式的網路型通訊用戶端,它依賴於許多不相關的產品。有時這就可能導致在使用過程中出現問題,需要進行疑難排解。
若要確定問題的原因,請在解決問題之前先使用下列共用疑難排解方法:
驗證配置產品時是否遵循了「Sun Java System Messaging Server 版本說明」和「Sun Java System Communications Express 管理指南」中列出的步驟。
啟用 Communications Express 記錄,以查看詳細的錯誤記錄並確定失敗原因。請參閱記錄檔一節,以取得啟用記錄的步驟。
檢查元件記錄是否報告了錯誤和異常。記錄檔可維護在安裝、配置與執行 Communications Express 過程中所遇到的錯誤清單。
本節概述了安裝、配置、啟動 Communications Express 過程中或存取 Communications Express 使用者介面用戶端元件時可能遇到的問題。
下面列出 Communications Express 元件的一些常見問題及其可能原因。
即使重新啟動 Web 容器之後,也不會反映配置變更。
確定配置變更已套用到適當配置路徑中的檔案。
完成 Communications Express 配置後,您的系統中會建立下列配置目錄:
uwc-deployed-path/staging/WEB-INF/config
uwc-basedir/SUNWuwc/WEB-INF/config
為確保在應用程式中反映變更,請對 uwc-deployed-path/WEB-INF/config 進行配置變更。
其他兩個目錄 (如 uwc-deployed-path/ staging/WEB-INF/config 和 uwc-basedir /SUNWuwc/WEB-INF/config) 均為臨時預留位置,僅由配置程式在配置過程中建立並使用。在其中進行的變更不會反映在應用程式中。
配置作業失敗。
若要找到問題,則請使用位於 uwc-basedir /SUNWuwc/install/uwc-config_TIME-STAMP.log 中的記錄檔。
其中,TIME-STAMP 是配置的時間戳記,其格式為 YYYYMMDDhhmmss。
配置程式無法正常工作。
若要識別問題,請啟用除錯選項,使用下列除錯模式呼叫配置程式:
-debug:使用此選項可產生一般除錯資訊
-debugMessage:使用此選項可產生錯誤與警告記錄
-debugWarning:使用此選項可產生警告訊息與錯誤訊息的記錄
-debugError:使用此選項可產生錯誤訊息記錄。依預設,將啟用此選項。
UWC 應用程式啟動失敗,並且 Web 容器記錄顯示異常。
可能由於配置不完整或不正確才發生此錯誤。
解決方法。
確定已完成所有後續配置步驟。如需後續配置步驟,請參閱第 1 章, Communications Express 簡介中的後續配置說明。
配置過程中,「chown」指令失敗。
解決方法。
執行配置程式,並在配置程式的「Web 容器使用者和群組」面板中輸入正確的 Web 容器使用者和群組值。
認證之後,存取啟用了 Access Manager 的 Communications Express 時,顯示訊息「執行此作業時發生錯誤」。
解決方法。
確定將 uwc-deployed-path/WEB_INF/config/uwcauth.properties 中的 uwcauth.identity.binddn 和 uwcauth.identity.bindcred 特性設定為安裝 Access Manager SDK 時提供的 amAdmin DN 之特性。請參閱在 uwcauth.properties 檔案中配置 Access Manager 參數一節。
儘管可能會向 Access Manager 單次登入的 uwcauth.identity.binddn 和 uwcauth.indentity.bindcred 提供 Directory Manager 憑證,但是 Directory Manager 並不具備獲取某些網域特定屬性所必需的 ACL,而 Communication Express 依賴這些屬性才能正常工作。
不支援修改 Access Manager SDK 整合的 Web 容器配置。
配置程式不支援修改 Access Manager SDK 整合的 Web 容器配置。
解決方法。
手動呼叫 Access Manager 隨附的工具來修改其 Web 容器配置。
在 SSL 中不支援 Messaging 單次登入。
解決方法
若要讓 SSL 支援 Messaging 單次登入,請執行下列步驟:
以 SSL 模式配置 Web Server。
針對 Web Server 的 SSL 連接埠,配置 Communications Express。
設定 uwcauth.ssl.enabled=true。
將 uwcauth.https.port 設定為 Web Server 的 SSL 連接埠。
以 SSL 模式啟用 Messaging Server。
將 uwcconfig.properties 中的 webmail.port 設定為 Messaging Server 的 SSL 連接埠。
將 messagingsso.ims.url 提供給 Messaging Server 的非 SSL 連接埠。
在 Web Server 及 Messaging Server 上,均安裝「憑證管理伺服器根憑證授權 (CMS root CA)」。
重新啟動 Web Server。
為指向 Messaging Server 非 SSL 連接埠的 local.webmail.sso.ims.verifyurl 提供一個值。
重新啟動 Messaging Server。
當您從 Communications Express 存取行事曆時,顯示訊息「執行此作業時發生錯誤」。
此錯誤可能是下列一種或多種原因導致的。
uwc-deployed-path/WEB_INF/config/uwcconfig.properties 中的 Calendar Server 配置是錯誤的。
Communications Express uwcconfig.properties 檔案中的 Calendar Server calmaster 資訊與 Calendar Server cal deploy path/bin/config/ics.conf 檔案中的值不同。
對於託管網域,Communications Express 與 Calendar Server 均未啟用。
確定已為虛擬網域同時啟用 Communications Express 與 Calendar Server,或已為其同時停用它們。請參閱在行事曆中啟用託管網域配置,以取得有關啟用 Communications Express 和 Calendar Server 虛擬網域的詳細資訊。
Calendar Server 未啟動。
此使用者未啟用行事曆服務。
當您從 Communications Express 存取行事曆時,顯示訊息「行事曆不可用。無法顯示檢視。選取的行事曆已刪除或不存在,或者您沒有檢視該行事曆的權限。請選取其他行事曆」。
在非託管網域安裝分析藍本中使用 commcli (用於模式 2) 佈建使用者時,可能會發生此錯誤。顯示此錯誤訊息是因為 commcli 錯誤地將 @domain 附加到使用者 LDAP 項目中的 icsCalendar 屬性值中。
解決方法
若要在非託管網域環境中使用 commcli 佈建使用者,則請在 commadmin 指令中使用 -k legacy 選項。對於託管網域環境,則請使用 -k hosted 選項。如果未指定 -k 選項,則假設設定了託管網域。
例如,
./commadmin user create -D admin -w password -X siroe .varrius .com -n siroe.varrius.com -p 85 -d siroe.varrius.com-F test -L user2 -l user2 -Wuser2 -S mail,cal -k legacy ok |
或者
如果無法移除與已佈建使用者相對應的項目,則請手動移除 icsCalendar、icsSubscribed 和 icsOwned 屬性中的「@domain」部分。
當您從 Communications Express 搜尋、邀請、訂閱跨網域行事曆或檢查其可用性時,顯示訊息「無法搜尋跨網域的行事曆」、「無法邀請跨網域的行事曆」、「無法訂閱跨網域的行事曆」或「無法檢查跨網域的行事曆可用性」。
解決方法
若要搜尋、邀請、訂閱行事曆或檢查行事曆的可用性,需要啟用「跨網域」搜尋功能。請參閱「Calendar Server 6 2005Q1 管理指南」第 13 章中「啟用跨網域搜尋」一節。
關於預設事件狀態篩選器的問題。
[選項行事曆] 視窗中的 [預設事件狀態篩選器] 指定以日、週及月行事曆檢視來顯示事件。可用的選項為:[已接受]、[嘗試]、[已拒絕]、[無回應]。
選取「已接受」選項做為事件狀態時,將在日、週或月的行事曆檢視中僅顯示已接受的邀請。不過,您建立的所有事件始終以日、週或月行事曆檢視來顯示。
在 [選項行事曆] 視窗中,依預設僅選取「已接受」和「嘗試」,這表示做為使用者,您看不到已拒絕的或尚未回應的事件。
解決方法
若要在 [日]、[週]、[月]、[年] 檢視中檢視所有事件,您應該選取所有選項,即 [選項行事曆] 視窗中的 [已接受]、[嘗試]、[已拒絕]、[無回應]。
上傳大於 2 MB 的檔案時,Communications Express 會顯示「伺服器錯誤」。
如果上傳的檔案大於 2 MB,則在將事件和作業匯入行事曆或將連絡人匯入通訊錄時,便會發生此錯誤。
依預設,Communications Express 最多允許匯入 2 MB 的檔案資料。不過,可以配置上傳檔案大小的限制。
解決方法
配置更大的上傳檔案大小限制。
若要配置更大的上傳檔案大小限制,請在 web.xml 中為篩選器 MultipartFormServletFilter 配置下列 init 參數:
fileSizeHardLimit。在發生錯誤以及停止處理請求之前,指定上傳檔案內容的最大位元組大小。例如,如果使用者在一個請求中上傳三個檔案,並且有一個或多個檔案超出 fileSizeHardLimit 限制,則將捨棄所有檔案,篩選器還會發出訊號指示錯誤狀況。
requestSizeLimit。指定整個內送請求的最大位元組大小。如果請求違反了此限制,會停止處理請求,並捨棄輸入串流。然後,篩選器將處理此違規,與處理內容大小違反強制限制的情況一樣。此限制的預設值是 4 MB。
fileSizeLimit。指定上傳檔案內容的最大位元組大小。例如,如果使用者在一個請求中上傳三個檔案,則每個檔案均不得超過此限制。請注意:此限制為軟式限制,這意味著如果上傳內容超過此限制,則將捨棄此內容,但請求仍會正常進行,允許應用程式處理大小違規。此限制的預設值是 1 MB。
failureRedirectURL。(可選擇。)指定當發生錯誤時將請求轉寄至的重新導向 URL。可透過 failureRedirectURL init 參數配置重新導向 URL。如果未指定重新導向 URL,篩選器會丟出異常,以立即結束請求。此限制的預設值是 2 MB。
例如,若要將上傳檔案大小增加到 10 MB,請遵循下面描述的配置步驟:
從 uwc-deployed-path/WEB-INF/web.xml 中備份現有的 web.xml。
在 uwc-deployed-path/WEB-INF/web.xml 中編輯 web.xml 檔案。
如程式碼範例 5-2 中粗體所示,在 web.xml 中提供 MultipartFormServletFilter 配置。
<web-app\> .. .. <filter\> <filter-name\>MultipartFormServletFilter</filter-name\> <filter-class\>com.sun.uwc.calclient.MultipartFormServletFilter </filter-class\> .. .. <init-param\> <param-name\>fileSizeHardLimit</param-name\> <param-value\>10485760</param-value\> <description\>Ten mega bytes</description\> </init-param\> <init-param\> <param-name\>requestSizeLimit</param-name\> <param-value\>10485760</param-value\> <description\>Ten mega bytes</description\> </init-param\> <init-param\> <param-name\>fileSizeLimit</param-name\> <param-value\>10485760</param-value\> <description\>Ten mega bytes</description\> </init-param\> <init-param\> <param-name\>failureRedirectURL</param-name\> <param-value\>put your url here</param-value\> <description\>Request is redirected to this url when uploaded file size crosses fileSizeHardLimit value</description\> </init-param\> .. .. </filter\> .. .. .. .. </web-app\> |
重新啟動 Web 容器,讓變更生效。
存取通訊錄時發生「伺服器錯誤」。Web Server 記錄檔會記錄「org.apache.xml.utils.WrappedRuntimeException:輸出格式必須具有 '{http://xml.apache.org/xslt}content-handler' 特性!」的異常資訊。
當 JDK Web Server 指向一個低於 JDK 1.4.2 的版本時,Web Server 將丟出此異常。Communications Express 使用最新的 xalan 和 xerces 版本進行 XML/XSL 剖析。在下列情況下,將發生此錯誤:
您正在使用未經 JES 安裝程式部署的 Web Server 6.1。JDK 1.4.1 通常搭配 Web Server 6.1。
Java Enterprise System 隨附的共用 xalan 和 xerces 元件不是最新的版本。
解決方法
如果是由於您尚未從 JES 安裝程式安裝 Web Server 而出現錯誤,則請手動升級 Web 容器的 JDK 版本 (在 server.xml Web Server 配置檔案中將其定義為 java 標記的 java_home 屬性)。
或者
從 Java Enterprise System 重新安裝 Web Server,並讓安裝程序自動升級 JDK。
如果已經執行此步驟,則必須重新部署所有其他 Web 應用程式。為安全起見,請備份 server.xml 檔案。
如果是由於共用的 xalan 和 xerces 元件不是最新版本而出現錯誤,則請從 uwc-deployed-path/WEB-INF/lib 中移除 xalan.jar 和 xerces.jar 的符號連結。
例如:
# cd /var/opt/SUNWuwc/WEB-INF/lib
# rm xalan.jar xercesImpl.jar
然後重新啟動 Web Server。
從 Communications Express 存取通訊錄時,顯示訊息「執行此作業時發生錯誤」。
如果個人通訊錄 (PAB) 的 LDAP 配置不正確,則會發生此錯誤。存取 [通訊錄] 標籤時,Communications Express 會連線到個人通訊錄存放區,也就是為 PAB 配置的 LDAP。如果個人通訊錄存放區無法建立連線,就會顯示錯誤。
解決方法
檢查 WEB-INF/config/ldappstore/db_config.properties 中的 LDAP 配置。
編輯不正確的配置設定。
重新啟動已部署 Communications Express 的 Web Server。
如需更多資訊,請參閱配置公司目錄參數 db_config.properties 檔案一節。
執行搜尋時,公司目錄顯示內嵌錯誤。
解決方法。
檢查 WEB-INF/config/corp-dir/db_config.properties 中的 LDAP 配置,找出其中任何錯誤配置,校正錯誤配置,然後重新啟動 Communications Express。
如需更多資訊,請參閱配置公司目錄參數 db_config.properties 檔案一節。
檢視公司目錄的連絡人時,會在 [檢視] 視窗中顯示錯誤。
如果用來存取公司目錄中連絡人項目的關鍵字不是「uid」,則會顯示此錯誤。
uid 是 Communications Express 設定的預設值。
解決方法
若要從公司目錄存取連絡人,則應該在 uwc-deployed-path/WEB-INF/config 中的 db_config.properties 和 xlate-inetorgperson.xml 配置檔案中將關鍵字值設定為所需的值。
在檔案中進行如下變更:
在 uwc-deployed-path /WEB-INF/config/WEB-INF/config/corp-dir/db_config.properties 中設定適當的關鍵字值。
在
uwc-deployed-path/WEB-INF/config/WEB-INF/config/corp-dir /xlate-inetorgperson.xml 中,使用設定適當的關鍵字替換 entryID="db:uid" 項目中的「uid」。
重新啟動已部署 Communications Express 的 Web Server。
如需更多資訊,請參閱配置公司目錄參數 db_config.properties 檔案一節。
無法設定 psRoot 的值。
使用者喜好設定中的 LDAP 屬性 psRoot 用於 Address Book Server 水平可伸縮性。如需更多詳細資訊,請參閱支援 Address Book Server 的水平可伸縮性一節。如果部署不需要 Address Book Server 水平可伸縮性,您可以忽略此錯誤。
當使用者第一次登入 Communications Express 時,系統會嘗試自動設定 psRoot,但有時可能無法自動設定該值。如果未安裝 Java Enterprise System Directory Server,或安裝 Java Enterprise System Directory Server 後未執行 Java Enterprise System 的 comm_dssetup.pl,通常會發生這種情況。這會導致無法更新 LDAP 模式。
由於未更新該模式,因此,即使水平延展 Addressbook Server 部署需要 psRoot 屬性,也無法手動設定該屬性。
解決方法
若要啟用 psRoot 屬性的設定,則請更新 Directory Server,使其包含 psRoot 屬性。若要如此,則請在
Directory ServerInstance/ config/schema/99user.ldif 中的 ipUser 物件類別定義中包含屬性 psRoot。
僅當目前部署中未安裝 Java Enterprise System Directory Server,或者安裝 Java Enterprise System Directory Server 後未執行 Java Enterprise System 的 comm_dssetup.pl 時才需要更新 Directory Server,使其包含 psRoot 屬性。
按一下 [郵件] 標籤時顯示登入頁面。
若 Communications Express 與 Messaging Server 之間的配置未正常完成,將提示此問題。若要使 Messaging Server 與 Communications Express 緊密合作,則應該啟用 Messaging 單次登入或 Access Manager 單次登入。啟動 Communications Express 之前,請遵循第 1 章, Communications Express 簡介中概述的有關單次登入配置的說明
從 Communications Express 存取郵件時,顯示訊息「執行此作業時發生錯誤」。
若在尚未部署或啟用 Communications Express 郵件元件時,登入 Communications Express 的使用者已將郵件設定成預設應用程式,則會發生此錯誤。
解決方法
管理員需要將使用者的 LDAP 項目的 sunUCDefaultApplication 屬性值變更為「calendar」或「addressbook」。
使用者在登出 Communications Express 後仍保持登入狀態。
如果 Access Manager (以前稱為 Identity Server) 和 Communications Express 安裝在不同的機器上,而 Access Manager 遠端 SDK 和 Communications Express 安裝在同一機器上,則會遇到此問題。
解決方法
在安裝 Communications Express 的機器上,在 AMConfig.properties 檔案中指定下列配置參數:
com.iplanet.am.notification.url=url-to-access-web-container-of -CommunicationsExpress/servlet/com.iplanet.services.comm .server.PLLRequestServlet
AMConfig.properties 檔案位於 IS-SDK-BASEDIR/SUNWam/lib 中
從郵件存取通訊錄功能時,可能會遇到下列問題:
無法從 [郵件] 標籤頁面存取 [行事曆]、[通訊錄] 和 [選項] 頁面。
按一下 [撰寫] 視窗中的 [收件者] 或通訊錄中的 [傳送郵件],將會顯示 javascript 錯誤。
未儲存郵件選項。
Communications Express 與 Messenger Express (MEM) 務必部署於同一部主機上,才能在瀏覽器中使用 Javascript 進行互通。
輸入有效的使用者 ID 和密碼後無法認證。
導致認證失敗的原因如下:
未使用 commcli 或 Access Manager (以前稱為 Identity Server) 佈建使用者,而使用了 Sun Java System LDAP Schema v.2。
解決方法
如果使用 Sun Java System LDAP Schema v.2,則請確定已使用 commcli 公用程式或已透過 Access Manager UI 主控台增加了使用者。
嘗試登入的使用者不在組織中。
如果 user@domain 格式中沒有網域資訊,則使用在 uwc-deployed-path /WEB_INF/config/uwcauth.properties 中定義的 defaultdomain 特性來認證使用者 ID。如果使用者不在對應網域的組織樹中,則認證失敗。
uwc-deployed-path/WEB_INF/config/uwcauth.properties 中的 Admin 憑證是錯誤的。
請參閱在 uwcauth.properties 檔案中配置 Access Manager 參數,以取得詳細資訊。
當嘗試隔離或疑難排解問題時,由各種系統元件產生的關於其作業的記錄資訊可能會非常有用。
編輯 uwc-deployed-path/WEB-INF/config 目錄中的檔案 uwclogging.properties
uwclogging.properties 檔案儲存下列參數:
模組/記錄控制檔案 |
參數 |
預設值 |
說明 |
---|---|---|---|
配置 |
在帶有時間戳記的 /opt/SUNWuwc/install /uwc-config _TIME-STAMP.log 檔案中維護記錄 |
||
Communications Express uwc-deployed-path /WEB-INF/config /uwclogging .properties |
no |
啟用或停用記錄。 若要啟用記錄,則請將 uwc.logging.enable 的特性值變更為「yes」。例如,uwc.logging.enable=yes |
|
Communications Express uwc-deployed-path /WEB-INF/config /uwclogging .properties |
uwc.log.file |
uwc-deployed-path /logs/uwc.log 例如: /var/opt/SUNWuwc /logs/uwc.log |
指定記錄檔的位置。 依需要變更記錄檔的位置。 確定 Web Server 可寫入此檔案。 |
Communications Express uwc-deployed-path /WEB-INF/config /uwclogging .properties |
uwc.log.level |
INFO |
指定應用程式的記錄層次。 將應用程式的記錄層次變更為所需層次。 可用的記錄層次值包括: WARNING、INFO、FINE 與 SEVERE。 |
模組/記錄控制檔案 |
參數 |
預設值 |
說明 |
---|---|---|---|
通訊錄 uwc-deployed-path /WEB-INF/config /uwcconfig .properties |
log.file |
/tmp/trace.log |
指定記錄檔的位置。 依需要變更記錄檔的位置。 確定 Web Server 可寫入此檔案。 |
通訊錄 uwc-deployed-path /WEB-INF/config /uwcconfig .properties |
3 |
指定應用程式的記錄層次。 若要停用此模組的記錄,請將值設定成 0。 |
|
郵件 |
請參閱「Sun Java System Messaging Server 管理指南」第 20 章「記錄和記錄分析」 |
在 uwclogging.properties 和 uwcconfig.properties 檔案中設定預設值後,請重新啟動 Web Server。
啟用記錄將影響系統的效能。