test

Sun Java Communications Suite 5 版本說明

第 2 章 Sun Java System Calendar Server 6.3 版本說明

版本 6.3

此版本說明包含 Sun JavaTM System Calendar Server 6.3 一般版本發行時可用的重要資訊，包括︰

備註 –

Sun Solve 提供的修補程式適用於此版本的 Calendar Server。如需更多資訊，請參閱Calendar Server 6.3 的重要升級修補程式資訊。

安裝和配置 Calendar Server 前，請先閱讀此版本說明。

Calendar Server 版本說明修訂歷程記錄

表 2–1 Sun Java System Calendar Server 版本說明修訂歷程記錄

日期 

變更說明 

2007 年 6 月 8 日 

增加了以下小節：Messaging Server 作業系統需求

2007 年 5 月 25 日 

增加了問題 6560681。從舊版升級至 Calendar Server 6.3 時，您需要執行解決方法以避免不當的運作方式。如需解決方法，請參閱Calendar Server 中已知的問題和限制。

2007 年 4 月 27 日 

此版本說明的重新發行版，增加了更多新增功能主題的資訊，說明關於 csstored 的變更。

2007 年 4 月 

此版本說明的重新發行版，新增了 configurator.sh 錯誤，問題編號為 6542989。

2007 年 3 月 

此版本說明的正式版 (版本 6.3) 

2006 年 9 月 

後期測試版版本說明 

關於 Calendar Server 6.3

Calendar Server 是用於企業和服務提供者的可縮放式網路型解決方案，提供集中的行事曆和排程。Calendar Server 支援用於事件和工作的使用者行事曆，以及用於資源 (例如，會議室與設備) 的行事曆。如需新增功能清單，請參閱以下小節：此 Calendar Server 發行版本的新增功能。

Calendar Server 提供圖形化使用者介面 Communications Express。還可讓客戶透過使用 Web 行事曆存取協定 (WCAP) 直接存取 text/calendar 或 text/xml 格式的行事曆資料。

此 Calendar Server 發行版本的新增功能

Calendar Server 6.3 包括以下變更與新增功能︰

Delegated Administrator 主控台的 Calendar Server 支援

過去，適用於 Schema 2 的 Calendar Server 佈建可以使用 Delegated Administrator 公用程式完成，但無法使用 Delegated Administrator 主控台。在此發行版本之前，主控台為 Web 圖形化使用者介面，僅可管理 Messaging Server。現在，主控台也可用來管理行事曆 LDAP 項目。您可以使用主控台增加、刪除或修改行事曆使用者、群組、資源和網域的 LDAP 項目。主控台增加了新的畫面和功能表項目，以支援 Calendar Server。如需有關使用該介面的指示，請參閱 Delegated Administrator 線上說明。「Sun Java System Calendar Server 6.3 Administration Guide」也提供了一些資訊。

Calendar Server 6.3 的 WCAP 附件支援

透過增加新的參數和值，WCAP 指令增加了附件支援。

通用 Web 用戶端 (Communications Express) 和 Connector for Microsoft Outlook 的使用者可在事件和工作中加入附件，並且能夠以邀請傳送附件。

作為附件支援，WCAP 增加了下列變更：

如需有關附件的更多資訊，請參閱「Sun Java System Calendar Server 6.3 WCAP Developer’s Guide 」。

Calendar Server 6.3 的 LDAP 群組支援

現在您可以使用 Delegated Administrator 建立 LDAP 群組。群組具有以下功能：

Calendar Server 6.3 中預設的多重網域模式

在最舊版的 Calendar Server 軟體中，沒有任何網域結構。所有的使用者和群組 LDAP 記錄都位在根目錄下。在稍後的版本中，使用者可建立一或多個網域，這類網域稱為託管網域或虛擬網域。在 Calendar Server 6.3 軟體的版本中，所有的安裝預設都必須使用多重網域模式。也就是說，您必須至少在根網域下使用一個網域作為預設網域。所有的使用者和群組 LDAP 項目都必須位在此預設網域下，您也可以選擇使用更多的網域。在多重網域模式中，各個標準網域都必須包含唯一的使用者 ID 和群組 ID。如需有關多重網域的更多資訊，請參閱「Sun Java System Calendar Server 6.3 管理指南」，尤其是「Sun Java System Calendar Server 6.3 Administration Guide」中的第 10 章「Setting Up a Multiple Domain Calendar Server 6.3 Environment」。

您必須執行才能建立執行階段環境的配置程式 csconfigurator.sh，會提示您輸入預設網域的名稱。如果這類的網域不存在，程式會為您建立一個。

如果先前的 Calendar Server 部署未使用多重網域，或甚至未使用任一網域，則您需要將使用者和群組 LDAP 記錄移至新的預設網域下。

若要在 Schema 第 2 版環境中建立額外的網域，請使用 Sun Java System Delegated Administrator 主控台或公用程式。如需有關 Delegated Administrator 的更多資訊，請參閱「Sun Java System Delegated Administrator 6.4 管理指南」。

如果您是使用 Schema 第 1 版，而您未遷移至 Schema 第 2 版，您可以使用 Calendar Server 公用程式 csdomain 建立額外的網域。

Calendar Server 6.3 配置程式增強功能

配置程式增加了以下項目的畫面：

建立預設的 LDAP 網域

此發行版本之後的版本中，根目錄下至少會有一個網域，即預設網域。現在，您可以在配置程式中指定多重網域環境的預設網域名稱。

分散式 Calendar Server 資料庫支援

現在，您可以為分散式資料庫環境 (使用 DWP 協定和 CLD 外掛程式) 指定前端和後端機器名稱，還可以將行事曆資料庫分發到一部或多部後端機器。這些機器可以關聯一部前端機器。新的配置程式畫面可供您命名後端機器，並將其與前端機器關聯。

配置精靈畫面增加了電子郵件位址欄位

在預設網域畫面中，新增了行事曆超級使用者 (calmaster) 電子郵件位址欄位。

在 Calendar Server 6.3 中電子郵件邀請包含週期性詳細資訊

現在，對於週期性事件而言，傳送給與會人員的電子郵件邀請中包含週期性詳細資訊。

csstored 現在成為 Calendar Server 6.3 中的必要程序

csstored 常駐程式現在管理多個 Calendar Server 資料庫。因為每個存取存放區的服務都仰賴這個存放區服務成功啟動，所以只要 Calendar Server 系統執行時，它應該在所有的伺服器上 (包括前端和後端) 均保持執行狀態。標準啟動和關閉指令 (start-cal 和 stop-cal) 可將 csstored 隨其他常駐程式啟動和關閉。

在舊版中，如果沒有配置自動備份，則不需執行 PERL 程序檔 (csstored.pl)。可依需求啟動或關閉此程序檔。PERL 程序檔已中止，以支持 csstored 常駐程式。不論您是否決定配置自動備份，都無法再選擇性執行此常駐程式。

先前，您可以將 ics.conf 參數 local.store.enable 設定為 "no" 來停止執行程序檔。但是現在，csstored 必須一律啟用 (預設是將 local.store.enable 設定為 "yes")。

行事曆服務的自動重新啟動使用 Watcher

Calendar Server 和 Messaging Server 現在使用相同的停止和啟動機制。start-cal 指令會啟動 watcher 程序，然後啟動其他所有程序。watcher 程序會注意其他服務的任何相依性，以及服務啟動的次序。

每一個註冊的服務 (程序) 都開啟與 Watcher 的連線。如果程序停止而未正常中斷連線，Watcher 會自動重新啟動它。如果程序在定義的間隔內停止兩次，則 Watcher 不會重新啟動它。這個逾時間隔是可配置的。

其他 Watcher 資訊：

由 Watcher 監視 Calendar Server 服務

Watcher 會監視在其中註冊的所有服務。Calendar Server 已註冊的程序為：cshttpd、csadmind、csdwpd、csnotifyd 和 csstored。

必須啟用常駐程式 csstored。務必將配置參數 local.store.enable 設定為 "y"。啟用 csstored 在舊版 Calendar Server 中是選擇性項目，但現在是必要項目。必須先成功啟動 csstored 常駐程式，才能啟動存取存放區的各個服務。如果常駐程式停止，則您必須停止並重新啟動附屬程序。

在 Calendar Server 6.3 中配置 Watcher

預設會啟用 Watcher。為管理 Watcher 程序，ics.conf 檔案新增以下參數：

Calendar Server 6.3 中的 Watcher 記錄

Watcher 會寫入 cal-svr-base/data/log/watcher.log 這個單一記錄，其中包含下列資訊：

Calendar Server 6.3 高可用性部署中的自動重新啟動

如果伺服器在逾時階段失敗兩次，則系統不再嘗試重新啟動該伺服器。在 HA 系統中，系統會關閉 Calendar Server，並容錯移轉至另一系統。

使用 csservice 的包裝程式程序檔啟動和停止 Calendar Server 6.3

csservice 的公用介面是 start-cal 和 stop-cal。本小節包含各個包裝程式程序檔的用法說明和用來解釋程序檔選項的表格，以及要啟動/停止的元件清單。

Calendar Server 6.3 的 start-cal 包裝程式程序檔

start-cal 用法如下：

./start-cal [選項...] [元件...]

其選項清單如下：

-? 或 --help

顯示此說明清單。

-d

啟用除錯模式。

-l

列出使用中服務。

-L

列出啟用的服務。

-A

列出所有服務。

其元件清單如下：

watcher

ens

store

notify

admin

http

dwp

如果未列出任何元件，start-cal 會啟動所有啟用的服務。

Calendar Server 6.3 的 stop-cal 包裝程式程序檔

stop-cal 用法如下：

./stop-cal [選項...] [元件...]

其選項清單如下：

-? 或 --help

顯示此說明清單。

-d

啟用除錯模式。

-f

使用 SIGKILL 強制停止。(僅適用於 UNIX® 平台。)

其元件清單如下：

watcher

mfagent

ens

store

notify

admin

http

dwp

如果未列出任何元件，stop-cal 會停止所有啟用的服務。

Calendar Server 6.3 的 Monitoring Framework 整合

本小節說明 Monitoring Framework 的 Calendar Server 實作，並包含以下主題：

在「Sun Java Enterprise System 5 Monitoring Guide」中，您可以找到有關 Java Enterprise System Monitoring Framework 的更多資訊。

Monitoring Framework 在 Calendar Server 中的實作方式

Calendar Server 與 Messaging Server 均以最低程度和適用於 Java Enterprise System 的 Monitoring Framework 整合。Monitoring Framework 在執行中會定期檢查 operationalStatus 屬性，該屬性的狀態可以是 OK (表示系統正在執行)，也可以是 DOWN (表示系統未執行)。

Monitoring Framework 代理程式 csmfagent (新程序) 會隨著系統啟動 (start-cal) 一併啟動。這是系統啟動的第一個程序。該程序會創設一個應用程式，並宣告應用程式的狀態為 OK。它也會擷取 SIGTERM，而且在擷取一項後立即宣告狀態為 DOWN 並結束。

同樣地，如果 Watcher 已經過配置，並且正在執行，系統的任何部分失敗或變得無回應時，Watcher 就會發出 SIGTERM 訊號停止 csmfagent。

Calendar Server 中的 Monitoring Framework 配置

編輯配置檔案 ics.conf，以包含下列參數：

local.csmfagent.enable = "y"

在 Calendar Server 中配置 Monitoring Framework

    請執行以下兩個步驟：

  1. 將 /opt/SUNWcsgar/config/com.sun.cmm.cs.xml 複製到 /opt/SUNWmfwk/xml。

  2. 停止 Manufacturing Framework 程序，然後重新啟動它。

Calendar Server 6.3 的 Monitoring Framework 安裝需求

    要使用 Monitoring Framework，必須滿足以下兩項需求：

  1. 必須安裝 Java Enterprise System Monitoring Framework (JESMF)。

    如果未安裝 JESMF，則 csmfagent 無法執行。

  2. Calendar Server 必須能夠找到必要的程式庫。

    Calendar Server 使用 /opt/SUNWics5/lib 中的符號連結找到程式庫。

JESMF 程式庫列示如下：

/opt/SUNWmfwk/lib/libMfTransaction.so 

/opt/SUNWmfwk/lib/libMfRelations.so 

/opt/SUNWmfwk/lib/libMflog4c.so 

/opt/SUNWmfwk/lib/libMfMEServer.so 

/opt/SUNWmfwk/lib/libmfBeepConnectorServer.so 

/opt/SUNWmfwk/lib/libMfRserver.so 

/opt/SUNWmfwk/lib/libMfMEInstrum.so 

/opt/SUNWmfwk/lib/libMfDiscovery.so 

/opt/SUNWmfwk/lib/libMfHashTable.so 

/opt/SUNWmfwk/lib/libMflog.so 

/opt/SUNWmfwk/lib/libasn1cebuf.so 

/opt/SUNWmfwk/lib/libbeepcore.so 

/opt/SUNWmfwk/lib/libbeepxmlutil.so 

/opt/SUNWmfwk/lib/libbptostransport.so 

/opt/SUNWmfwk/lib/libbptosutil.so 

/opt/SUNWmfwk/lib/libbptoswrapper.so 

/opt/SUNWmfwk/lib/libbputil.so 

/opt/SUNWmfwk/lib/libcmm_native.so 

/opt/SUNWmfwk/lib/libmfCserver.so 

/opt/SUNWmfwk/lib/libmfNotificationProfile.so 

/opt/SUNWmfwk/lib/libmfRequestResponseProfile.so 

/opt/SUNWmfwk/lib/libmfTimers.so 

/opt/SUNWmfwk/lib/libmfTimersJNI.so 

/opt/SUNWmfwk/lib/libmfUtils.so 

/opt/SUNWmfwk/lib/libmfber.so 

/opt/SUNWmfwk/lib/libmfberj.so 

/opt/SUNWmfwk/lib/libxmlglobal.so 

備註 –

這是所有 JESMF 程式庫的清單。有可能並非其中所有都是實作 Monitoring Framework 的 Calendar Server 部份所需的項目。

Calendar Server 通知服務轉為使用 Message Queue

此發行版本針對事件通知和警示，提供兩項通知服務：Sun Java System Message Queue (JMQ) 和 Event Notification System (ENS)。在將來的發行版本中，Communications Service 產品只使用 JMQ，並將移除 ENS。但是，此發行版本的 Communications Services 產品 (Messaging Server、Calendar Server 和 Instant Messaging) 對 ENS 仍然有內部相依性，您可以繼續使用 ENS 進行通知和警示。

若要使用 JMQ 而非 ENS，您必須安裝和配置 Sun Java System Message Queue。此外，您必須記錄您自己的通知，因為 Calendar Server 6.3 不提供任何通知。

請使用 Sun Java Enterprise System 安裝程式安裝此產品。如需有關配置 Message Queue 的資訊，請參閱 Message Queue 文件。

JMQ 的 Calendar Server 配置參數

若要在 Calendar Server 中配置 JMQ，您必須在 ics.conf 檔案中增加以下各行：

local.server.csmfagent.enable = "yes"
caldb.serveralarms.jmqlib = "/opt/SUNWics5/cal/lib/libmqcrt.so" (適用於 Solaris)

或者，

caldb.serveralarms.jmqlib = "/opt/sun/calendar/lib/libmqcrt.so" (適用於 Linux)
caldb.serveralarms.dispatchtype = "jmq"
caldb.serveralarms.jmqhost = "localhost"
caldb.serveralarms.jmqport = "7676"
caldb.serveralarms.jmqUser = "guest"
caldb.serveralarms.jmqPWD = "guest"
caldb.serveralarms.jmqTopic = "JES-CS"

Calendar Server 6.3 的 Message Queue 更新通知特性

通知必須具有以下特性：MQ_MESSAGE_TYPE_HEADER_PROPERTY。這項特性會識別通知的類型。

此外，通知可以具有其他特性，如下表所示：

action

字串特性，指示此通知產生的動作類型。這項特性可以具有以下值："EMAIL"、"AUDIO"、"DISPLAY"、"PROCEDURE" 和 "FLASHING"。

aid

字串特性，包含警示 ID。

calid

字串特性，包含行事曆 ID。

comptype

字串特性，指示元件類型。可以具有 "event" 或 "todo" 值。

rid

整數特性，包含週期性 ID。

uid

字串特性，包含元件 ID。元件 ID 是事件 ID 或待辦事項 ID (工作 ID)。

Calendar Server 6.3 的 Message Queue 更新通知值

通知分為兩種類型：警示通知及事件和待辦事項的更新通知。

對於警示通知，MQ_MESSAGE_TYPE_HEADER_PROPERTY 的值只會是 "alarm"。

對於更新通知，MQ_MESSAGE_TYPE_HEADER_PROPERTY 則需要根據觸發通知的動作類型而定。表 2–2 列出這項特性的觸發動作和相應的值。

表 2–2 更新通知值

觸發 

更新通知值 

刪除行事曆 

DELETECAL

修改事件 

MODIFYEVENT

修改待辦事項 (工作) 

MODIFYTODO

建立事件 

CREATEEVENT

建立待辦事項 (工作) 

CREATETODO

重新整理事件 

REFRESHEVENT

重新整理待辦事項 (工作) 

REFRESHTODO

回覆事件 

REPLYEVENT

回覆待辦事項 

REPLYTODO

在 Calendar Server 6.3 中事件組織者可收到回覆通知的電子郵件

現在，當與會人員回覆邀請時，系統會向組織者傳送電子郵件通知。

您可以透過設定 ics.conf 參數 ine.reply.enable 來配置這項特性。將該參數設定為 "y" 為整個系統啟用這項功能。將該參數設定為 "n" 停用這項功能。預設會啟用這項功能。

回覆有三種類型：接受、拒絕、暫時接受。通知可指示回覆是針對單一邀請還是針對週期性事件。新增了以下訊息格式檔案參數，以及相應的格式檔案：

備註 –

這項功能不屬於使用者喜好設定。也就是說，這是系統範圍的配置參數，因此會套用於所有傳送邀請的使用者。

如需有關配置 Calendar Server 進行電子郵件通知的更多資訊，請參閱「Sun Java System Calendar Server 6.3 Administration Guide」中的「To Enable Email Notifications」。

可修改事件的與會者副本

WCAP 介面已經過調整，可用來修改行事曆事件的與會者副本，包含摘要和描述等欄位。

重新命名工具增強

Calendar Server 6.3 公用程式 rename 包含重新命名行事曆資料時刪除的項目。

Calendar Server 6.3 的空閒/忙碌計算變更

已拒絕的事件不會在空閒/忙碌行事曆中再顯示為忙碌。

停用 Calendar Server 6.3 中的舊版 Calendar Express UI

在舊版 Calendar Server 中，會自動安裝和啟用 Calendar Express (舊版使用者介面)。即使您未使用此介面，也無法加以停用。如果您升級到 Calendar Server 6.3，升級程序會將 service.http.ui.enable="y" 增加到 ics.conf 檔案中。如果您仍然需要使用的舊版 UI，這會將它保持啟用，不需要其他任何動作。

若要停用 Calendar Express，請在 ics.conf 檔案中，將 service.http.ui.enable 設定為 "n"。

在 Calendar Server 6.3 中未自動安裝 Calendar Express UI

更新安裝不會再自動安裝 Calendar Express。如果您執行 Calendar Server 6.3 的更新安裝，但是需要使用 Calendar Express 作為使用者介面，您必須使用 Communications Suite 5 安裝程式另外安裝 Calendar Express。然後，您必須將 service.http.ui.enable="y" 增加到 ics.conf 檔案中，以進行 Calendar Express 的配置。(更新安裝的預設內部設定是 "n"，因此您必須確實將它設定為 "y"。)

如果您是從舊版 Calendar Server 升級，升級程序會為您將參數增加到 ics.conf 中，並且將值設定為 "y"。這樣，您無需任何變更就可以繼續使用舊版使用者介面。但是，如果您要停用使用者介面，請將這個參數設定為 "n"。

在混合硬體平台上安裝

過去，由於大尾數法/小尾數法問題，在分散式資料庫環境 (使用 DWP 和 CLD 外掛程式) 中，前端程序和後端程序必須安裝在相同的硬體平台上。現在的情況不再如此。現在您可以將前端程序和後端程序安裝在不同的硬體平台上。

例如，前端機器是 X-86 平台的機器，而後端機器是 SPARC 平台的機器。

Calendar Server 6.3 的 iTIP 相容性

現在，Calendar Server 傳送的訊息與 iTIP 相容 (適用於 Microsoft Outlook 互通操作)。

comm_dssetup.pl：密碼檔案的新選擇增強 Calendar Server 6.3 的安全性

為了增強安全性，在執行 comm_dssetup.pl 時，現在可以指定密碼檔案，而不是文字密碼。使用新的 -j <passwordfilename > 選項，您可以防護密碼，並增強安全性。此功能對程序檔尤為有用。如果您使用的程序檔目前顯露密碼，而希望變更這些程序檔，可刪除 -w < password> 選項，並且以新的程序檔取代這個程序檔。

備註 –

這是對於問題 #6392093 的修正。

Calendar Server 6.3 公用程式 csdb、cscal 和 csuser 遷移到 cal/sbin

在舊版 Calendar Server 中，csdb、cscal 和 csuser 出現在 cal/bin 目錄中，而現在則位於 cal/sbin 目錄中。

SSL 針對 Calendar Server 6.3 在 ics.conf 檔案中所做的變更

由於 Calendar Server 程式碼的變更，ics.conf 檔案發生以下變更：

已停用和移除的 Calendar Server 6.3 功能

對於 Sun Java System Calendar Server 6.3，已停用以下功能：

Calendar Server 6.3 的需求

本小節說明此發行版本的 Calendar Server 需要的硬體與軟體。

Calendar Server 6.3 的產品版本相容性需求

Calendar Server 與本小節列出的產品版本相容：

表 2–3 Calendar Server 6.3 的產品版本相容性需求

產品 

版本 

Sun Cluster 

3.1 

Sun Java System Directory Server 

5.1、5.2、6.0 

Sun Java System Message Queue 

3.7 

Sun Java System Access Manager (以前稱為 Identity Server) 

舊有 (6.x)：支援 Access Manager 6 的功能，包括 Access Manager 6 主控台和目錄資訊樹狀結構 (DIT)。如果您要將 Access Manager 與 Portal Server、Messaging Server、Calendar Server、Delegated Administrator 或 Instant Messaging 一起安裝，則必須選取 [Access Manager 相容 (6.x)] 安裝類型。

Sun Java System Web Server 

7.x 

Sun Java System Application Server 

8.2 

Calendar Server6.3 的 NSS 版本需求

Calendar Server 6.3 需要使用共用安全性元件 NSS 3.9.3 版。

如需有關產品相依性的詳細資訊，請參閱「Sun Java Enterprise System 5 Installation Guide for UNIX」和「Sun Java Enterprise System 5 Release Notes for UNIX」

Calendar Server 硬體需求和建議

Calendar Server 軟體需求和建議

本小節說明此 Calendar Server 版本的軟體需求和建議。

Calendar Server 作業系統需求

建議用戶端電腦使用的瀏覽器

請參閱第 6 章, Sun Java System Communications Express 6.3 版本說明中Communications Express 瀏覽器需求。

Calendar Server 6.3 的重要升級修補程式資訊

在 Communications Suite 5 的一般發行中，以下的 Calendar Server 6.3 產品升級修補程式已提供使用：

平台 

修補程式編號 (英文) 

修補程式編號 (本土化的語言) 

Solaris、SPARC 

121657–17 

117010-26 

x86 

121658–17 

117011-26 

Linux 

121659–17 

117852-26 

您可以在 Sun Solve 尋找最新的產品修補程式。有關如何在 Sun Solve 上尋找修補程式，請按照下列程序進行：

Procedure如何在 SunSolve 上尋找修補程式

  1. 如需目前 Sun Java System Calendar Server 需要的修補程式清單，請至︰

    http://sunsolve.sun.com

  2. 選取「修補程式」或「修補程式入口」。

  3. 開啟 Sun Java System Calendar Server 連結。

    由於作業系統修補程式需求隨時在變更且會不定時發行可用的 Java Enterprise System 元件的修補程式，更新資訊最初將以建議的修補程式叢集的形式在 SunSolve 上發佈。

Calendar Server 安裝注意事項

本小節包含安裝 Calendar Server 6.3 之前應瞭解的資訊，包括：

注意 – 注意 –

Calendar Server 不支援網路檔案系統 (NFS) 已掛載分隔區。請勿安裝或建立 Calendar Server 的任何部分；包括 NFS 已掛載分隔區上的程式檔、資料庫、配置、資料、暫存檔或記錄檔。

Calendar Server Linux 平台支援

Java Enterprise System 可在 Linux 平台上執行。使用者經歷中的主要區別將是安裝產品目錄的路徑名稱。Linux 平台會安裝至與 Solaris 平台不同的目錄。

下表顯示了 Solaris 與 Linux 的預設安裝目錄路徑︰

Solaris 預設目錄 

Linux 預設目錄 

/opt/SUNWics5/cal/ (cal-svr-base)

/opt/sun/calendar (cal-svr-base)

/etc/opt/SUNWics5/config

/etc/opt/sun/calendar/config

/var/opt/SUNWics5/

/var/opt/sun/calendar

提示 –

在文件中，Calendar Server 的預設安裝目錄為 cal-svr-base。

作業系統修補程式

您必須在安裝 Calendar Server 之前套用所需的作業系統修補程式。如需所需修補程式的清單，請參閱「Sun Java Enterprise System 5 Release Notes for UNIX」。

必要的權限

若要在 Solaris 系統上執行 Sun Java Enterprise System 安裝程式或 Calendar Server 6.3 配置程式，您必須以超級使用者登入或成為超級使用者 (root)。

Linux 套裝軟體名稱

使用 Sun Java Enterprise System 安裝程式安裝 Calendar Server 6.3。Java Enterprise System 安裝程式會安裝 Sun 元件產品套裝軟體 (包括 Calendar Server 6.3) 以及由各種產品使用的共用元件。

下表列出了各種 Calendar Server 相關元件的 Linux 套裝軟體名稱。

元件 

套裝軟體名稱 

Calendar Server 

sun_calendar-core

sun-calendar-api

本土化的套裝軟體︰ 

西班牙語 

sun-calendar-core-es

韓文 

sun-calendar-core-ko

法語 

sun-calendar-core-fr

簡體中文 

sun-calendar-core-zh_CN

德語 

sun-calendar-core-de

日文 

sun-calendar-core-ja

繁體中文 

sun-calendar-core-zh_TW

從舊版的 Calendar Server 6 升級

您無法使用 Sun Java System Communications Suite 安裝程式升級到 Calendar Server 6.3 版。您必須使用 patchadd 程序。

如需有關升級 Calendar Server 6.3 的更多資訊，請參閱「Sun Java Communications Suite 5 Upgrade Guide」。

升級行事曆資料庫

在升級到 Calendar Server 6.3 之後，您也必須使用本小節所述的各種工具升級資料庫。如需有關遷移工具的更多資訊，請參閱「Sun Java System Calendar Server 6.3 Administration Guide」。

本小節包含以下主題：

從舊版的 Calendar Server 6 升級

如果您的舊版 Calendar Server 軟體早於 5.1.1 版，請先洽詢技術支援，以協助您遷移資料庫，以便與 Calendar Server 5.1.1 相容。您無法直接遷移到 Calendar Server 第 6 版。在技術支援建議的程序中，您必須安裝 Calendar Server 5.1.1。在資料庫與 Calendar Server 5.1.1 相容之後，請安裝 Calendar Server 6.3，並且按照所列順序執行下列資料庫工具。

cs5migrate

執行此公用程式以將資料庫從 5.1.1 版升級到 6.2 版。這是在執行 csmigrate 公用程式升級到 6.3 版之前的中間步驟。在安裝 Calendar Server 6.3 之後，可以在 sbin 目錄中找到 cs5migrate 公用程式。

您必須指定 -r 選項。cs5migrate 公用程式會建立所有週期性事件和工作的主記錄和異常記錄。Calendar Server 將自動轉寄這些記錄。

此公用程式會在您的資料庫進行下列變更：

  • 遷移 Calendar Server 5.1.1 LDAP 資料庫，以便與 Calendar Server 6.2 相容。

  • 將 Berkeley Data Base 遷移到 4.2 版。

  • 將遷移狀態寫入 csmigrate.log 記錄檔。

  • 將錯誤寫入 csmigrateerror.log 記錄檔。

csmig

執行此公用程式，以便使 LDAP CLD 外掛程式正常運作。

csvdmig

執行此公用程式，將非網域的行事曆資料庫轉換為與多重網域環境相容的單一資料庫。

csmigrate

此時，Calendar Server 資料庫屬於 6.2 版模式。執行 csmigrate 公用程式，遷移 Calendar Server 6.2 資料庫，以便與 Calendar Server version 6.3 相容。

在新安裝 Calendar Server 6.3 的 sbin 目錄中，您可以找到 csmigrate 公用程式，以及其他管理工具。如需有關 csmigrate 的更多資訊，請參閱「Sun Java System Calendar Server 6.3 Administration Guide」。

注意 – 注意 –

如果您是從配置用於限制虛擬網域模式的更舊版 Calendar Server 升級，或在相同機器上具有多個 Calendar Server 實例，請連絡 Sun Microsystems, Inc. 銷售客戶代表，以獲得遷移需求評估，並確保您具有支援那些需求的特定遷移公用程式。

再次提醒，切記在遷移資料庫前，執行完整的備份。

升級 Calendar Server 6.0、6.1 或 6.2 版資料庫，以便與 Calendar Server 6.3 版相容

執行 csmigrate，將行事曆資料庫升級到 6.3 版。

在新安裝 Calendar Server 6.3 的 sbin 目錄中，您可以找到 csmigrate 公用程式，以及其他管理工具。如需有關 csmigrate 的更多資訊，請參閱「Sun Java System Calendar Server 6.3 Administration Guide」。

Calendar Server 安裝後配置

    在安裝或升級至 Calendar Server 6.3 後，您必須進行如下配置才可以使用 Calendar Server︰

  1. 執行 Directory Server 設定程序檔 (comm_dssetup.pl) 來配置 Sun Java System Directory Server 以用於 Calendar Server 模式。如需指示，請參閱「Sun Java Communications Suite 5 Installation Guide」中的第 8 章「Directory Preparation Tool (comm_dssetup.pl)」。

  2. 執行 Calendar Server 配置程式 (csconfigurator.sh) 以配置站點的特定需求。如需指示，請參閱「Sun Java System Calendar Server 6.3 Administration Guide」。

尋找 Calendar Server 資料和程式檔案的位置

下表顯示了尋找 Solaris 和 Linux 平台的文件中涉及的各種檔案與程式的位置︰

檔案名稱 

Solaris 位置 

Linux 位置 

管理員公用程式︰start-cal、stop-cal、csattribute、csbackup、cscal、cscomponents、csdb、csdomain、csexport、csimport、csmonitor、csplugin、cspurge、csrename、csresource、csrestore、csschedule、csstats、cstool 和 csuser

/opt/SUNWics5/cal/sbin

/opt/sun/calendar/sbin

遷移公用程式︰csmig 與 csvdmig

/opt/SUNWics5/cal/sbin

/opt/sun/calendar/sbin

配置檔案︰ics.conf、version.conf、counter.conf 和 sslpassword.conf

安裝後，檔案位於︰/opt/SUNWics5/cal/ config-template

配置期間，以上目錄中的各檔案都會被移至您選擇的配置選項指定的位置。預設位置是：/etc/opt/SunWics5/config

安裝後，檔案位於︰/opt/sun/calendar/ config-template

配置期間，以上目錄中的各檔案都會被移至您選擇的配置選項指定的位置。 

郵件格式 (*.fmt) 檔案

安裝後，檔案位於︰/opt/SUNWics5/cal/ config-template

配置後，檔案位於︰/etc/opt/SUNWics5/ config/language

其中語言為英文、德文、西班牙文、法文、日文、韓文、繁體中文或簡體中文。 

安裝後，檔案位於 /opt/sun/calendar/ config-template

配置後，檔案位於︰/etc/opt/sun/calendar/config/ language

其中語言為英文、德文、西班牙文、法文、日文、韓文、繁體中文或簡體中文。 

程式庫 (.so) 檔案 

SSL 公用程式︰certutil 與 modutil

/opt/SUNWics5/cal/lib

/opt/sun/calendar/lib

階段作業資料庫 

/opt/SUNWics5/cal/data/ http

/opt/sun/calendar/data/http

計數器統計檔案︰counter 與 counter.dbstat

/opt/SUNWics5/cal/lib/ counter

/opt/sun/calendar/lib/ counter

timezones.ics 檔案

/opt/SUNWics5/cal/config

/opt/sun/calendar/config

調校 Calendar Server 的目錄伺服器效能

若要提高 LDAP 目錄伺服器的效能，尤其是在使用 LDAP 目錄的行事曆搜尋時，請考慮以下項目︰

為 LDAP 目錄伺服器屬性建立索引

若要提高 Calendar Server 存取 LDAP 目錄伺服器的效能，請將索引增加至各屬性的 LDAP 配置檔案中。

配置程式 comm_dssetup.pl 將選擇性地為您建立索引。

提示 –

若要查看索引可為您提供的效能差異，請執行以下測試︰

  1. 建立索引前，請記錄執行以下 LDAP 指令的時間︰


    ldapsearch -b "base" "(&(icscalendarowned=*
user*)(objectclass=icsCalendarUser))"

    其中，base 是目錄伺服器的 LDAP 基底 DN，其中包含 Calendar Server 的使用者和資源資料，而 user 是一般使用者可以在 [行事曆搜尋] 對話方塊中輸入的值。

  2. 執行 icsCalendarOwned 的索引。

  3. 再次執行以下 LDAP 指令，並記錄時間︰


    ldapsearch -b "base"
 "(&(icscalendarowned=*user*)(objectclass=icsCalendarUser))"

    其中，base 是目錄伺服器的 LDAP 基底 DN，其中包含 Calendar Server 的使用者和資源資料，而 user 是一般使用者可以在 [行事曆搜尋] 對話方塊中輸入的值。

  4. 比較時間。應存在很大的時間差異。

檢查並設定大小限制參數和查詢限制參數

若要確定查詢限制 (nsslapd-lookthroughlimit) 和大小限制 (nsslapd-sizelimit) 參數是否設定為適當的值，請嘗試執行以下指令︰

ldapsearch -b "base" "(&(icscalendarowned=*
user ID*)
(objectclass=icsCalendarUser))"

其中，base 為目錄伺服器的 LDAP 基底 DN，其中包含 Calendar Server 的使用者和資源資料，而 user ID 為一般使用者可以在 Communications Express 行事曆搜尋對話方塊中輸入的值。

如果 LDAP 伺服器傳回錯誤，則 nsslapd-sizelimit 或 nsslapd-lookthroughlimit 參數可能不夠大。請遵循這些指導以設定這些參數︰

使用 Schema 1 的 Communications Express

Communications Express 中存在兩個 Schema 1 問題︰

Calendar Server 佈建工具

有兩種用於佈建 Calendar Server 的使用者、群組和網域的工具︰Delegated Administrator 和 Calendar Server 公用程式。Delegated Administrator 具有兩個使用者介面︰主控台 (圖形化使用者介面) 與公用程式 (指令行介面)。如需有關 Delegated Administrator 的資訊，請參閱「Sun Java System Communications Services 6 2005Q4 Delegated Administrator 指南」。主控台的使用說明可在 Delegated Administrator 主控台線上說明中找到。

如需有關 Calendar Server 公用程式的資訊，請參閱「Sun Java System Calendar Server 6.3 Administration Guide」。

注意 – 注意 –

請勿嘗試透過 Access Manager 主控台佈建使用者。儘管可以建立使用者並為使用者指定行事曆服務，但請勿使用此方法，因為結果將不可預期，並且會對您的部署產生負面影響。

Calendar Server 文件更新

Calender Server 6.3 包括以下文件。文件號碼位於括弧內。

Communications Express 線上說明位於介面上。

Delegated Administrator 主控台線上說明位於介面上。

Calendar Server 6.3 文件位於以下網站：

http://docs.sun.com/coll/1313.2 和 http://docs.sun.com/coll/1417.2

「Sun Java Enterprise System Technical Note: Sun Java System Calendar Frequently Asked Questions」 (819–2631) 此 FAQ 文件尚未針對此發行版本進行更新。

Calendar Server 相容性問題

下表列出 Calendar Server6.3 與舊版之間已知的不相容衝突。

不相容性 

影響 

說明 

Access Manager 現在有兩種安裝類型︰舊有與範圍。 

安裝時，您必須在下列面板上選擇舊有模式做為安裝類型︰ 

Access Manager: Administration (1 of 6)

如果安裝了錯誤的 Access Manager，您將無法執行 Delegated Administrator。 

/opt/SUNWics5 下的 Directory Preparation Tool (comm_dssetup.pl) 無法工作。

現在 comm_dssetup.pl 位於其自己的套裝軟體中。對於 Solaris，該套裝軟體安裝在 /opt/SUNcomds 中，而對於 Linux，則安裝在 /opt/sun/comms/dssetup 中。

需要更新指定舊路徑的現有程序檔。 

若要安裝套裝軟體，請確定已在適當的安裝程式面板中選取 Directory Preparation Tool。 

Delegated Administrator 的配置程式已變更。 

安裝 Delegated Administrator 並執行配置程式。目前程式位於︰對於 Solaris，/opt/SUNWcomm/sbin/config- commda

對於 Linux，/opt/sun/comms/config-commda

安裝此版本的 Calendar Server 時，升級至新的 Delegated Administrator。 

此發行版本的 Communications Express 與舊版的 Calendar Server 不相容。 

如果升級 Communications Express，您還必須升級 Calendar Server。 

這同樣適用於 Messaging Server。 

由於完成封裝的方式發生變更，Calendar Express 必須在運行時間進行字串取代。 

重大效能降低 

請致電技術支援人員，以取得可供您在啟動 Calendar Server 作業前執行的程序檔。程序檔會執行所有必要的字串取代。 

Calendar Express 已停用，而且不會包括在將來的 Calendar Server 版本中。這項問題將不予以修正。 

由於 SSL 處理中的程式碼變更，無法再使用以下參數： 

service.http.ssl.certdb.path

那些仍然使用這個舊參數指向 SSL 目錄的程序檔和配置檔案無法再使用。不啟用 SSL。 

ics.conf 檔案已增加新的參數：

local.ssldbpath = "/etc/opt/SUNWics5/config"

憑證資料庫的密碼不再保留在 ics.conf 參數

service.http.ssl. certdb.password 中

找不到 SSL 密碼。錯誤訊息： 

General Error: http_ssl_init(): SSL initialization failed.

現在，憑證資料庫的密碼出現在位於 config 目錄的以下檔案中：

sslpassword.conf

密碼的格式為： 

Internal (Software) Token:password

不再允許非網域環境。 

現在，修改 LDAP 項目的程序檔必須包含預設網域。 

安裝和配置 Calendar Server 之後，它會針對所有 LDAP 項目執行無訊息轉換程式，以加入您指定的預設網域。 

如果進來的請求 (WCAP 指令) 未指定網域，則會假定為用於預設網域。 

但是，您執行的任何直接修改 LDAP 項目的程序檔必須包含新的預設網域。 

無法再使用 ics.conf 檔案中的 service.admin.calmaster.userid 和 service.admin.calmaster.cred 參數。

您無法使用這些舊參數設定行事曆使用者喜好設定和憑證。 

service.admin.calmaster.userid 參數已變更為 service.siteadmin.userid，而 service.admin.calmaster.cred 參數已變更為 service.siteadmin.cred。升級時，由修補程式程序檔遷移這些參數。

不再提供 Windows 和 HP-UX 版本的 Calendar Server。 

伺服器端 Calendar Server 軟體唯一支援的作業系統平台是 Solaris 和 Linux。 

這不會影響用戶端軟體，例如 Connector for Microsoft Outlook。如需支援的作業系統清單，請參閱個別用戶端元件的版本說明。 

此發行版本的 Calendar Server 中已修正的問題

以下清單是 Calendar Server 6.3 後期測試版中已修正的問題：

4845346

csuser delete 僅刪除預設行事曆。

4962061

目錄管理員密碼在 ics.conf 檔案中儲存為純文字。

4963237

配置託管網域前佈建的使用者無法建立事件。

5060833

發出停止指令時，在行事曆配置檔案中停用的程序不會停止。

與問題編號 6216869 有關。如果您啟動程序 (例如 enpd)，然後在 ics.conf 檔案中停用該程序，則當發出 stop-cal 時，系統不會停止已停用的程序。

6179278

依據配置設定，未清除緊急備份記錄檔。

6203605、6245878 和 6246230

管理員無法從 LDAP 中刪除網域。

commadmin domain purge 無法移除將 deleted 做為 icsStatus 的項目。它們的狀態必須為 removed。建議的 Calendar Server 公用程式 csclean 無法將 icsStatus 變更為 removed。

6210830

即使到期日期超出刪除範圍，deletecomponents_by_range 仍然移除待辦事項。

6210906

deletetodos_by_range.wcap 不接受 dtstart，而將它視為 dtstart=0。

6216869

發出停止指令時，DWP 不停止。

與問題編號 5060833 有關。如果在 DWP 程序執行時停用 DWP，stop-cal 不會停止該程序。stop-cal 應停止所有服務，而不僅是啟用的服務。

6268143

RFE：在群組中，群組成員只顯示 calid，而不顯示名稱

6283756

事件通知電子郵件有長行，違反 RFC 2822。

6286886

Calendar Server 不應該隨附 certmap.conf 檔案，因為這不是必要的。這個檔案適合基於用戶端的 SSL 認證 (Calendar Server 不支援)。

6371337

在呼叫 set_calprops.wcap 時，cshttpd 傾印核心。

6377803

如果目錄伺服器是 Schema 2，而且尚未建立任何網域，則 Calendar Server 配置程式會顯示錯誤訊息，並且不允許根據這類目錄伺服器進行配置。

備註 –

只針對配置程式的 GUI 版本進行了修正。對於指令行版本，您必須在 Delegated Administrator 中建立網域，才能夠配置 Calendar Server。

6391020

易誤解的 Calendar Server 錯誤訊息。

6397674

如果目錄不存在，csmigrate 應該建立目錄。

6402557

csclean 未移除使用者的行事曆。沒有任何警告說明原因。

6404071

當使用者嘗試邀請不同網域的使用者時，在啟用跨網域搜尋的狀況下，WCAP errno 傳回值 60。

6411890

預設必須開啟 proxyauth。

6412007

修改事件鏈的一個實例時，發出兩封電子郵件通知。

6414650

如果 ENS 通知啟動，csmigrate 遷移公用程式會當機。

6424254

在呼叫 storeevents 指令時，cshttpd 程序進入無窮迴圈。

6426426

遷移工具需要在新的資料庫目錄中建立 ldap_cache 和 cld_cache。

6399756

Calendar 備份通知磁碟空間不足。記錄的計算錯誤？

計算正確，但是歸檔和緊急備份目錄必須移到 csdb 目錄之外。

4964857

csdomain 沒有特性可變更 LDAP 屬性 inetdomainstatus。此指令已停用，並且不再更新。

50755906

InetDomainBaseDN 應該增加索引。

5029444

comm-dssetup 需要增加更多索引。

6494477

進行無訊息的重新配置時，caldb.calmaster 參數變更為 "**UNKNOWN**"。

Calendar Server 中已知的問題和限制

本小節包含列出了 Calendar Server 6.3 發佈時較為重要的已知問題清單︰

Calendar Server 已知的限制

此時已知以下限制︰

從舊版 Calendar Server 升級至 Calendar Server 6.3 後發生高可用性問題

若您使用高可用性功能 (使用 Calendar Server HA 套裝軟體 SUNWcsics)，則從舊版 Calendar Server 升級至 Calendar Server 6.3 後，您需要執行以下解決方法以避免問題 6560681。

解決方法：

  1. 手動移除 Calendar Server 6.3 隨附的 SUNWscics 套裝軟體。

  2. 使用 pkgadd 指令增加 Java Enterprise System 軟體隨附的 SUNWscics 套裝軟體。

配置程式在 DWP ics.conf 參數中填入錯誤的值

如果您是使用前端和後端伺服器部署 Calendar Server，就會需要使用 DWP 協定，則配置程式會要求您新增後端伺服器的主機名稱。配置程式會在 ics.conf 的參數 caldb.dwp.server.hostname.ip 中，將此值儲存為 IP 位址，而非此處應儲存的完全合格主機名稱。這意味著系統將無法找到後端伺服器。

解決方法：將 IP 位址替換為完全合格的後端伺服器主機名稱。透過編輯 ics.conf 這個文字檔，即可進行替換。

如需正確指示，以瞭解使用此參數和其他參數配置前端和後端伺服器時應使用的值，請參閱「Sun Java System Calendar Server 6.3 Administration Guide」中的第 5 章「Configuring Calendar Database Distribution Across Multiple Machines in Calendar Server Version 6.3」。

在此版本說明的以下區段中已報告此問題，問題編號為 6542989：Calendar Server 6.3 中發現的問題。

在升級之後，無法登入 Linux 平台：「無法解析後端主機」

升級到 Calendar Server 6.3 之後，在 Linux 作業系統上執行 start-cal，http.log 檔案中出現錯誤訊息：

cshttpd[2984]: General Error: caldb: 
caldb_pvt_isLocalUrl: hostname of hostname.xyz.com is not resolvable.  
Please check that hostname is correct and that hostname resolver is correct.

同時，嘗試登入時，出現下列錯誤訊息：

Backend Host Unresolvable
Please try again

修正：此問題已經在 Calendar Server 6.3 Upgrade 1 中予以修正，修補程式編號是 121658-17。

這與以下小節中問題編號 6516438 的狀況相同：Calendar Server 6.3 中發現的問題。

配置檔案中的重複參數

配置檔案 ics.conf 允許重複的參數。這可能造成參數值混淆。若要確定系統使用哪些參數實例，請找出檔案中最後的實例。系統使用在處理檔案時找到的參數最後一個實例的值。

基本操作：將所有變更加入至 ics.conf 檔案末端以類似於 # My Parameter Changes 的文字標示的部分。若要保留變更的歷程記錄，請加入說明變更原因的註釋和日期。

定期註釋不再使用的舊變更或刪除不再使用的舊重複項目 (如果您不在意變更歷程記錄)，只在檔案中保留最新的變更。

已停用的使用者介面效能減退

這個版本中，封裝階段不再進行 XSL 檔案中的字串取代。因此，字串是即時取代的，這會降低 Calendar Express 使用者介面的效能。

解決方法：您可以在執行 Calendar Server 之前執行字串取代，方法是處理所有的 XSL 檔案，然後手動插入正確的語言字串。若要執行取代，您必須加入 perl 程序檔 (xslvarparser.pl)，這可以在 {CAL_SERVER_BASE}/tools/unsupported/bin 目錄中找到。程序檔會提供執行指示。

    方便起見，程序檔中提供的指示如下：

  1. 使用 perl 程序檔 xslvarparser.pl 取代 XSL 檔案中的變數，以加速 XSL 描繪。

  2. 將這個檔案複製到 /opt/SUNWics5/cal/html 目錄 (在 Solaris 上為預設)。

  3. 然後作為 $ perl xslvarparser.pl 執行。

  4. 產生的檔案會出現在各個語言環境的輸出目錄下。

  5. 以輸出目錄中的檔案取代各個語言環境的 XSL 檔案。

    備註 –

    建議您在取代之前儲存原始檔案。

這個問題與Calendar Server 6.3 中發現的問題中問題編號 6385495 描述的狀況相同。

移除多值使用者喜好設定的所有實例

每個 set_userprefs 指令僅移除多值喜好設定的一個實例。

解決方法：若要移除多值使用者喜好設定的所有實例，您必須對每個實例發出一個 set_userpref 指令。

例如：執行 get_userprefs 以列出所有使用者喜好設定。如果喜好設定 (例如 icsSubscribed) 有多個值，則您必須為列出的每個值發出一個 set_userprefs 指令以刪除該喜好設定。

在叢集環境中尋找已安裝的修補程式

不存在叢集特定的、可以顯示安裝在叢集個別節點上的內容的 showrev 指令。(此為一般問題，並不是 Calendar Server 特定的。任何產品安裝在全域檔案系統上時，均會遇到同樣的問題。)

想要更新 Calendar Server 時會出現此問題。您需要將修補程式套用至已安裝 Calendar Server 的每個節點上。此外，如果節點上尚未安裝 Calendar Server，則不能將修補程式套用至該節點。如果您不清楚哪些節點上安裝了 Calendar Server，哪些節點沒有安裝，則嘗試尋找安裝 Calendar Server 的節點至少會令您感到十分麻煩並耗費時間。

解決方法：執行以下指令以查看已安裝 Calendar Server 的所有節點︰pkgparam -v SUNWics5 | grep ACTIVE_PATCH

快顯阻止程式

如果您已啟用快顯阻止程式，則某些 Calendar Server 視窗將無法顯示。

解決方法：停用 Calendar URL 的快顯阻止程式，以確保顯示所有 Calendar Server 視窗。

異常︰Norton Inet Security 的 AD_BLOCKER 或 Mozilla 內建的 POP_BLOCKER 均不會影響 Calendar Server 視窗。

在 Schema 1 模式下佈建 Communications Express 的使用者

csuser 公用程式無法啟用其為通訊錄建立的使用者。

解決方法：使用 ldapmodify 啟用使用者。

多個網域 (託管網域)

配置程式 csconfigurator.sh 僅可配置單一網域。

解決方法：如果您需要多網域行事曆環境 (稱為虛擬網域或託管網域)，則必須執行兩個步驟︰

  1. 啟用託管網域。

  2. 使用 Delegated Administrator 自己增加網域，或者在仍使用 Sun LDAP Schema 1 的情況下使用 csdomain 公用程式增加網域。

請參閱「Sun Java System Calendar Server 6.3 Administration Guide」中的第 10 章「Setting Up a Multiple Domain Calendar Server 6.3 Environment」和「Sun Java System Calendar Server 6.3 Administration Guide」中的第 13 章「Administering Calendar Server Domains」。

Calendar Server 無法使 LDAP 快取資料過期

(問題編號 4777792) 快取可以填滿，從而導致錯誤。Calendar Server 無法使 LDAP 快取資料過期。

解決方法：定期移除檔案內容。然後重新啟動 Calendar Server。

必須在配置檔案中輸入完全合格的主機名稱和不完全合格的主機名稱

配置檔案要求主機名稱兩次。一次要求完全合格的主機名稱，另一次要求不完全合格的主機名稱。例如：

caldb.dwp.server.skate.red.sesta.com.ip = "skate.red.sesta.com" 
caldb.dwp.server.skate.ip = "skate" 
caldb.dwp.server.test12.red.sesta.com.ip = "test12.red.sesta.com" 
caldb.dwp.server.test12.ip = "test12"

必須為 X-Token 中的非 RFC 相容資料加引號

如果 X-Token 中存在非 RFC 相容資料，則其必須加引號。例如，X-Token 中的冒號必須顯示為 ":"。

加入為次要所有者之前不驗證使用者。

Calendar Server 公用程式 cscal 在將使用者做為次要所有者增加至所有者清單之前，不驗證使用者。

遷移公用程式不更新所有者行事曆。

Calendar Server 遷移公用程式 csmig 無法使用所有者行事曆更新 icsSubscribed。

無法自動清除無效的快取 LDAP 資料。

這必須手動完成。

迅速且同步地開啟和關閉多個連線時，enpd 程序當機。

事件通知服務已停用。我們將不修正此限制。請改用 Sun Java System Message Queue 產品。

事件遭到意外刪除。

使用者修改事件並選擇選項以修改今天的事件和所有將來事件時，所有先前的事件都會被刪除並且不會再顯示在 UI 中。

無法使用 SSLv2 用戶端。

在 SSLv2 模式中 SSL 初始化失敗。無法使用 SSLv2 用戶端。

如果不存在任何 DC 樹狀結構，行事曆公用程式會失敗。

對於 Schema 1，您必須在建立或管理行事曆之前建立 DC 樹狀結構節點。

Calendar Server 公用程式傳送不明確的錯誤訊息。

由於錯誤訊息來自數個層級之下，並且可能由多個不同環境所造成，因此錯誤訊息不明確。較高一層的程式在將錯誤訊息上浮一層之前並不解釋錯誤訊息。

描述中的前導空格在儲存時消失。

如果以前導空格開始進行描述，前導空格不會與文字一併儲存，並且不會在顯示事件時出現。

無法逐網域啟用或停用 SSL。

這是此發行版本尚未實作的 RFE。

(僅 Linux) Calendar Server 未在重新開機時重新啟動。

剩餘的鎖定檔案造成無法重新啟動。請在重新啟動之前刪除鎖定檔案。

鎖定檔案可在以下目錄中找到：

/opt/sun/calendar/lib/lock/__db.001

2007 年 3 月 11 日和 2007 年 4 月 1 日之間的事件偏移 1 小時

根據法令規定，日光節約時間的轉換日期已經變更。Calendar Server 6.3 軟體包含新的正確時區表。此後建立的所有事件和工作都會使用正確的時間。然而，位於新舊轉換日期之間的已存在事件和工作會偏移 1 小時。每年使用行事曆時，這個問題會發生兩次，一次是在春季的標準時間轉換為日光節約時間時，另一次是在秋季的日光節約時間轉換為標準時間時。

這與本文件稍後Calendar Server 6.3 中發現的問題描述的問題編號 6502376 屬於相同的問題。

修正：此問題的標準修正方式，是讓使用者在受影響的行事曆中，調整所有事件的時間。

這有一個修正程式，在提出要求之後，技術支援便會提供。

匯入的行事曆資料只能用於來自相同 calid 的資料

匯入功能無法用來移動行事曆之間的資料。資料只能匯入至原先匯出的相同行事曆 (相同 calid) 中。

此限制是本文件Calendar Server 6.3 中發現的問題小節所描述編號 6461183 的狀況。

Calendar Server 6.3 中發現的問題

以下是產品中已發現問題的清單︰

4972249

對於託管的網域環境，csexport 要求 calid 必須完全合格。例如，使用格式 uid@domain。

6244958

未建立狀態檔。

使用 -saveState 選項呼叫 csconfigurator.sh 時，指定的狀態檔案不包括未建立狀態檔的路徑。例如：

/opt/sun/calendar/sbin/csconfigurator.sh -saveState cs.state

解決方法：始終指定應建立狀態檔的完整路徑名稱。

6289810

對於資源行事曆，邀請狀態預設應該是「已接受」。

對於資源行事曆，邀請狀態預設應該是「已接受」。由於資源行事曆無法接受邀請，因此訂閱資源行事曆的使用者可能無法看到這些邀請 (如果使用者在 [Communications Express] -> [選項] -> [行事曆檢視] 中選擇只檢視已接受的邀請)。

解決方法：由 ics.conf 參數 resource.invite.autoaccept = "yes" 決定伺服器層級自動接受。這也可以在各資源層級使用 icsAutoaccept LDAP 屬性加以決定。

6312605

週期性事件的問題

傳送具有非日期欄位修改的 dtstart 和 dtend 參數 (使用 storeevents) 導致資料毀壞。

解決方法：在修改需要非日期欄位修改的儲存指令中，請勿提供 dtstart 和 dtend。

6377803

如果目錄伺服器是 Schema 2，而且尚未建立任何網域，則 Calendar Server 配置程式會顯示錯誤訊息，並且不允許根據這類目錄伺服器進行配置。

備註 –

只針對配置程式的 GUI 版本進行了修正。對於指令行版本，您必須在 Delegated Administrator 中建立網域，才能夠配置 Calendar Server。

6391883

從 Java ES 2005Q1 升級之後，使用 Access Manger 的單次登入不起作用。例如，當您登入至 Portal Server 桌面，並且嘗試存取 Calendar Server 時，系統會顯示登入頁面，而不是自動通過單次登入的認證。

解決方法：這個問題目前沒有任何解決方法。

6393241

升級包含前端和後端安裝的 Calendar Server 部署之後，使用 DWP 進行通訊時，無法啟動前端安裝，並在記錄中產生多項錯誤。由於快取目錄未複製到新的安裝，因此造成這個問題。

解決方法：將 cld_cache 和 ldap_cache 目錄從 /var/opt/SUNWics5/csdb.old 複製到 /var/opt/SUNWics5/csdb。然後，將新目錄的所有者和群組分別設定為 icsuser 和 icsgroup。

6428959

資料庫記錄檔在 csdb 中彙整。

儲存常駐程式未讀取正確的配置檔案參數。常駐程式搜尋 caldb.berkeley.*.enable (並不存在)。然後，取用已停用的循環記錄預設值。這也會造成其他問題，包括緊急備份無法進行。正確的 ics.conf 參數是 caldb.berkeleydb.*.enable。

解決方法：重新啟動服務。csstored 會移除彙整的記錄檔案，以處理記錄彙整的問題。

6461183

無法使用匯出/匯入功能移動不同 calid 的行事曆資料。匯入的資料必須具有與匯入的行事曆相同的 calid。

6470688

csrestore 不處理個人使用者行事曆。

建立個人行事曆並成功執行備份之後，手動刪除個人行事曆。然後，使用 restore 指令復原個人行事曆。從記錄檔中，您可以看到行事曆已成功復原。然而，在記錄至 UWC 或 Calendar Express 介面時，您無法看到或管理個人行事曆。問題在於 csrestore 不處理使用者 LDAP 項目行事曆、訂閱的行事曆或自身行事曆。

解決方法：手動編輯或刪除每個使用者的多值屬性 icsSubscribed (先前已刪除並使用 csrestore 復原)。

6479810

階段作業資料庫損毀導致登入失敗和過多的階段作業逾時訊息。

解決方法：

  1. 停止服務

  2. 移除階段作業資料庫

  3. 啟動服務

6494811

Calendar Server 套裝軟體未隨附任何 JMQ 用戶端。使用來自已安裝 Messaging Server 的 JMQ 用戶端。未安裝 JMQ 用戶端，會造成 JMQ 啟動時異常終止 admind 程序。

解決方法：從 Messaging Server 隨附式軟體複製 JMQ 用戶端。

6502376

2007 年 3 月 11 日和 2007 年 4 月 1 日之間的行事曆事件偏移 1 小時

這之所以會發生，是因為來回切換日光節約時間和標準時間的日期經過變更，以延長日光節約時間。與往年相比，轉換日期在春季 (三月) 較早開始，在秋季 (十一月) 則較晚開始。隨 Calendar Server 6.3 發行的時區檔案已經過更新，以反映這些變更。

對於 Communications Express，由於其中使用 JVM 時區資訊，而非 Calendar Server 時區檔案，因此您必須更新 JVM，以進行新的時區變更。Sun 建議使用最新的 Sun Java SE JDK/JRE 更新版本，以作為遞送時區資料更新和其他產品改善 (例如安全性修正) 的偏好方式。按照以下文件所述，使用 JVM 更新程式：

http://java.sun.com/javase/tzupdater_README.html

更新時區資訊之後，在時區更新之前排程的事件會顯示新舊轉換日期所造成的 1 小時差異。

這有一個修正程式的可執行檔，在提出要求之後，技術支援便會提供。

另一個方式是，只要求使用者更新位在新舊轉換日期之間的事件時間。您也可以執行自己的程序檔，處理其中少數事件需要更新的資料庫。

6503200

LDAP 工具的位置已經變更

如果您已經安裝舊版 (後期測試版) Java Enterprise System，您必須先移除 SUNWldapcsdk-tools 套裝軟體，然後再安裝 Java Enterprise System 5 的發行版本 (RR)。這是因為發行版的 SUNWldapcsdk-tools 套裝軟體位置經過變更。如果您未移除此套裝軟體，而嘗試先啟動 Calendar 或 Messaging 伺服器，然後再安裝發行版，則會出現錯誤訊息：


Could not find .../bin/ldapsearch utility
Please install the ldapcsdk-tools package

此錯誤訊息是因為 LDAP 工具位置經過變更所致。

解決方法：先移除 SUNWldapcsdk-tools 套裝軟體，然後再安裝發行版的 Java Enterprise System 5。若要檢查 SUNWldapcsdk-tools 版本，請執行 pkgparam -v SUNWldapcsdk-tools VERSION。

備註 –

您必須使用 6.00,REV=2006.12.11.00.08 或更高版本，否則會出現找不到 LDAP 搜尋公用程式的錯誤訊息。

請使用 pkgrm SUNWldapcsdk-tools 指令，移除 SUNWldapcsdk-tools 套裝軟體。

如果您已經執行 Java Enterprise System 5 安裝程式，您可以使用以下指令，手動移除 SUNWldapcsdk-tools 套裝軟體，然後再次安裝：


cd <jes5_distro>/Solaris_sparc/Product/shared_components/Packages
  pkgadd -d . SUNWldapcsdk-tools
6505032

無法在 Linux 平台上啟動 csmfagent。

行事曆二進位檔案在 Linux 版本上找不到 Monitoring Framework 的共用程式庫。正確的 Monitoring Framework 檔案路徑是：/opt/sun/mfwk/share/lib，但是 Calendar Server 以為它位在 /opt/sun/calendar/lib。

解決方法：在 Calendar Server 程式庫中，增加適當程式庫的符號連結，如以下範例所示：

# cd /opt/sun/calendar/lib 
# ln -s /opt/sun/mfwk/share/lib/*.so .

另一個方法是從 Monitoring Framework 程式庫啟動行事曆服務，例如：/opt/sun/mfwk/share/lib

6516438

在 Linux 平台上，更新到 Calendar Server 6.3 之後，無法登入。

這可以使用 Calendar Server 6.3 Upgrade 1 予以修補，修補程式編號是 121658-17。如需有關此問題的更多資訊，請參閱此版本說明的以下小節：Calendar Server 已知的限制。

6542989

當您使用配置程式設定後端伺服器時，該配置程式會錯誤地在以下參數填入 IP 位址，而非完全合格的主機名稱：

caldb.dwp.server.hostname.ip

您必須編輯 ics.conf 檔案，才能夠修正參數值，否則系統會無法找到後端伺服器。正確的值應為完全合格的後端伺服器主機名稱。

6560681

高可用性套裝軟體 SUNWcsics 需要某些更新才能正常運作。使用 Java Enterprise System 軟體隨附的套裝軟體即可。在修正此問題的修補程式可用之前，您必須使用以下解決方法：

  1. 手動移除 Calendar Server 發行軟體中的 SUNWcsics 套裝軟體。

  2. 使用 Java Enterprise System 發行軟體中的 SUNWcsics 套裝軟體執行 pkgadd。

可再分發的 Calendar Server 檔案

Sun Java System Calendar Server 6.3 包含以下檔案集，Sun Microsystems, Inc. 針對這些檔案授予您非獨家的、不可轉讓的有限授權，並能夠以二進位形式進行複製與發行。

此外，您可以單獨複製和使用 (但不能修改) 列出的標頭檔案和類別程式庫，以使產生的二進位檔可以與 Sun 的軟體 API 相接合。

範例代碼僅供建立上述二進位檔後參考。

Calendar Server 的所有可再分發的檔案均可用於外掛程式 API (稱為 CSAPI)。該 API 在位於以下網站上的「Sun Java System Calendar Server 6 2005Q4 Developer’s Guide」中有相關說明︰

http://docs.sun.com/coll/1313.2 和 http://docs.sun.com/coll/1417.2

在以下檔案中，cal-svr-base 是在其中安裝 Calendar Server 的目錄。Solaris 的預設目錄為 /opt/SUNWics5/cal，Linux 的預設目錄為 /opt/sun/calendar

可再分發檔案位於 >cal-svr-base/csapi 的不同子目錄中︰

authsdk 可再分發的檔案

以下是此子目錄 (cal-svr-base/csapi/authsdk/) 中可再分發的檔案︰

cgiauth.c

expapi.h

login.html

nsapiauth.c

bin 可再分發的檔案

以下是此子目錄 (cal-svr-base/csapi/bin/) 中可再分發的檔案︰

libcsapi_xpcom10.so

libicsexp10.so

classes 可再分發的檔案

以下是此子目錄 (cal-svr-base/csapi/classes/) 中可再分發的檔案︰

ens.jar

jms.jar

include 可再分發的檔案

以下是此子目錄 (cal-svr-base/csapi/include/) 中可再分發的檔案︰

IIDS.h

nsCom.h

nsMacRepository.h

csIAccessControl.h

nsDebug.h

nsProxyEvent.h

csIAuthentication.h

nsError.h

nsRepository.h

csICalendarDatabase.h

nsHashtable.h

nsString.h

csICalendarLookup.h

nsIAtom.h

nsTraceRefcnt.h

csICalendarServer.h

nsICaseConversion.h

nsVector.h

csIDBTranslator.h

nsICollection.h

nsUnicharUtilCIID.h

csIDataTranslator.h

nsID.h

nsXPComCIID.h

csIMalloc.hplugins

nsIEnumerator.h

nsXPComFactory.h

csIPlugin.h

nsIEventQueueService.h

nscore.h

csIQualifiedCalidLookup.h

nsIFactory.h

pasdisp.h

csIUserAttributes.h

nsIPtr.h

publisher.h

mozIClassRegistry.h

nsIServiceManager.h

subscriber.h

mozIRegistry.h

nsIServiceProvider.h

xcDll.h

nsAgg.h

nsISizeOfHandler.h

xcDllStore.h

nsCOMPtr.h

nsISupports.h

 

nsCRT.h

nsISupportsArray.h

 

plugins 可再分發的檔案

此目錄 (cal-svr-base/csapi/plugins/) 的以下子目錄中包含可再分發的檔案：

accesscontrol 可再分發的檔案

以下是此子目錄 (cal-svr-base/csapi/plugins/accesscontrol/) 中可再分發的檔案︰

csAccessControl.cpp

csAccessControl.h

csAccessControlFactory.cpp

authentication 可再分發的檔案

以下是此子目錄 (cal-svr-base/csapi/plugins/authentication/) 中可再分發的檔案︰

csAuthentication.cpp

csAuthentication.h

csAuthenticationFactory.cpp

datatranslator 可再分發的檔案

以下是此子目錄 (cal-svr-base/csapi/plugins/datatranslator/) 中可再分發的檔案︰

csDataTranslator.cpp

csDataTranslator.h

csDataTranslatorFactory.cpp

userattributes 可再分發的檔案

以下是此子目錄 (cal-svr-base/csapi/plugins/userattributes/) 中可再分發的檔案︰

csUserAttributes.cpp

csUserAttributes.h

csUserAttributesFactory.cpp

samples 可再分發的檔案

此目錄 (cal-svr-base/csapi/samples/) 的以下子目錄中包含可再分發的檔案：

samples/authentication 可再分發的檔案

以下是此子目錄 (cal-svr-base/csapi/samples/authentication/) 中可再分發的檔案︰

authlogon.c

authlogon.h

authtest.c

csAuthenticationLocal.cpp

csAuthenticationLocal.h

csAuthenticationLocalFactory.cpp

samples/datatranslator 可再分發的檔案

以下是此子目錄 (cal-svr-base/csapi/samples/datatranslator/) 中可再分發的檔案︰

csDataTranslatorCSV.cpp

csDataTranslatorCSV.h

csDataTranslatorCSVFactory.cpp

samples/ens 可再分發的檔案

以下是此子目錄 (cal-svr-base/csapi/samples/ens/) 中可再分發的檔案︰

apub.c

asub.c

rpub.c

rsub.c

samples/userattributes 可再分發的檔案

以下是此子目錄 (cal-svr-base/csapi/samples/userattributes/) 中可再分發的檔案︰

csUserAttributesDB.cpp

csUserAttributesDB.h

csUserAttributesDBFactory.cpp