| Sun ONE Calendar Server 6.0 管理員指南 |
第 2 章
管理 Calendar Server 使用者和行事曆本章描述如何使用 Calendar Server 指令行公用程式來佈建和管理使用者與行事曆 (包括使用者行事曆和資源行事曆)。
本章包含以下各節：
若要佈建和管理 Calendar Server 使用者與行事曆，請使用以下指令行公用程式：
- csuser 公用程式可管理儲存在 LDAP 目錄伺服器和行事曆資料庫中的行事曆使用者資訊。
- cscal 公用程式可管理行事曆資料庫中的行事曆及其特性。
- csresource 公用程式可管理儲存在 LDAP 伺服器和行事曆資料庫中的資源 (如會議室或設備) 行事曆。
若要執行指令行公用程式，您必須以對 Calendar Server 執行時所在的系統具有管理權限的使用者身份登入。如需更多資訊，請參閱第 11 章「Calendar Server 指令行公用程式」。
佈建新的 Calendar Server 使用者本節提供以下有關佈建新的 Calendar Server 使用者的資訊：
目錄伺服器需求
Calendar Server 需要將行事曆使用者儲存在目錄伺服器中。然後，Calendar Server 會使用此目錄伺服器進行使用者認證以及儲存與擷取使用者偏好設定。
Calendar Server 的預設安裝支援在 LDAP 目錄 (如 Sun ONE Directory Server) 中定義的使用者。如果使用者已儲存在 LDAP 目錄中，您只需將目錄伺服器升級至 Sun ONE Directory Server 即可支援綱目延伸，以允許使用者存取 Calendar Server。
如需有關安裝和配置 Sun ONE Directory Server 的資訊，請參見以下說明文件網站：
http://docs.sun.com/coll/S1_DirectoryServer_52
您也可以手動修改目錄綱目，以允許使用者存取 Calendar Server 資料。如需相關資訊，請參閱「Sun ONE Calendar Server 6.0 安裝指南 (適用於 Solaris 作業系統)」。
Calendar Server 使用者必需的 LDAP mail 性質
Calendar Server 6.0 (及更高版本) 要求使用者具有 LDAP mail 性質，以用於使用者行事曆和資源行事曆 (例如，用於會議室或者筆記型電腦或高射投影機等設備)。每個資源行事曆必須擁有電子郵件位址，即使並不實際使用該電子郵件位址。
您可能更需要按照如下說明新增 LDAP mail 性質：
現有 5.x 安裝。執行 cs5migrate 遷移公用程式之前，請將 mail 性質新增至使用者行事曆和資源行事曆的使用者。若要新增 mail 性質，請使用 Calendar Server csattribute 公用程式或其他公用程式 (如 Directory Server ldapmodify 公用程式)。
新的 6.0 安裝。使用 Calendar Server csattribute 公用程式或其他公用程式 (如 Directory Server ldapmodify 公用程式)，為使用者行事曆和資源行事曆的現有使用者佈建 LDAP mail 性質。
如果您在安裝後建立新行事曆或使用者，請在執行以下 Calendar Server 公用程式時，使用必需的 -m email 選項來指定電子郵件位址：
- csresource 公用程式，用於新資源行事曆
- csuser 公用程式，用於新使用者
如需有關 cs5migrate 遷移公用程式的資訊，請參閱「Sun ONE Calendar Server 6.0 安裝指南 (適用於 Solaris 作業系統)」。
如需有關 ldapmodify 公用程式的資訊，請參閱「Sun ONE Directory Server Resource Kit Tools Reference」，它位於以下網站：
http://docs.sun.com/coll/S1_DirectoryServer_52
範例：將電子郵件 LDAP 性質新增至資源行事曆
以下範例會為 sesta.com 伺服器上名為「Room100」的會議室新增 LDAP mail 性質。此範例使用 Sun ONE Messaging Server。如果您使用的是其他電子郵件伺服器，請參閱該產品的說明文件，以瞭解對等程序。
範例：為資源電子郵件設定 bitbucket 通道
以下範例會為 Sun ONE Messaging Server 設定 bitbucket 通道，或為 Sendmail 設定對等通道，以用於為資源行事曆而產生的電子郵件。這些範例使用 sesta.com 伺服器上名為「Room100」的資源。如果不設定 bitbucket 通道 (或對等通道)，則需定期刪除傳送至資源行事曆的電子郵件訊息。
如果您使用的是 Sun ONE Messaging Server，請執行以下步驟：
如果您使用的是 Sendmail，請執行以下步驟：
註
若要啟用這些變更，可能還需要重建別名表或配置。請參閱 Sun ONE Messaging Server (或您的電子郵件產品) 的說明文件，以及站台自身的說明文件和有關郵件服務變更的程序。Sun ONE Messaging Server 位於以下網站：
電子郵件別名 (mailalternateaddress 性質)
如果您需要為某位行事曆使用者設定電子郵件別名，請使用 LDAP mailalternateaddress 性質。LDAP mail 性質提供主要郵件位址，而 LDAP mailalternateaddress 性質用於電子郵件別名。這兩個性質均將郵件位址對映至該使用者的行事曆 ID (calid)。
例如，若要使用以下值為名為 John Smith 的使用者新增 mailalternateaddress 性質：
請使用以下 Calendar Server 公用程式指令：
# ./csuser -g John -s Smith -y password -l en -m john.smith@sesta.com -c johnsmith create johnsmith
# ./csattribute -a mailalternateaddress=johns@sesta.com add johnsmith
# ./csattribute -a mailalternateaddress=jsmith@sesta.com add johnsmith
行事曆識別碼 (calid)
Calendar Server 資料庫中的每個行事曆均透過唯一行事曆識別碼 (ID) 或 calid 來標識。calid 的格式為：
userid[@domain][:calendar-name]
其中：
userid 是使用者 ID。
domain 是使用者的可選網域名稱。預設值由 service.defaultdomain 參數指定。
calendar-name 是可選行事曆名稱。
行事曆 ID 區分大小寫。例如，JSMITH 與 jsmith 不同。(這點與電子郵件位址不同，電子郵件位址不區分大小寫。例如，jsmith@sesta.com 相當於 JSMITH@SESTA.COM。)
行事曆 ID 不能包含空格，並限於以下字元：
以下是行事曆 ID 的範例：jsmith、jsmith@calendar.sesta.com:new-cal 和 jsmith:private_calendar。
由於使用者 ID 是 calid 的一部分，因此使用者 ID 不應包含空格 (例如，j smith)。使用者 ID 中包含空格的使用者可以登入 Calendar Server，但空格會導致後續問題。
行事曆查找資料庫 (CLD) 外掛程式
如果行事曆資料庫分佈於數台後端伺服器上，則 Calendar Server 會使用外掛程式來確定實際儲存行事曆的伺服器。Calendar Server 可使用資料庫連線協定 (DWP) 存取後端伺服器上的行事曆資料。DWP 是一個內部協定，它會以 csdwpd 服務的形式來執行，並為行事曆資料庫提供網路功能。
Calendar Server 根據 ics.conf 檔案中 caldb.cld.type 參數的值載入該外掛程式：
檢查使用者是否能使用行事曆記錄功能
若要確定特定使用者是否存在於您的目錄伺服器中，以及該使用者是否能存取 Calendar Server 資料，請使用 csuser 公用程式的 check 指令。
例如，檢查 JSmith 是否能使用行事曆記錄功能：
csuser check JSmith
如果 check 指令指示某個使用者不在 LDAP 目錄伺服器中，則您必須為該使用者建立目錄伺服器項目。
佈建新使用者
csuser 公用程式可以在 LDAP 目錄伺服器中建立項目，並讓使用者能使用行事曆記錄功能。您也可以使用 Sun ONE Directory Server 公用程式，例如 ldapsearch 和 ldapmodify。如需有關這些公用程式的資訊，請參閱以下網站上的 Sun ONE Directory Server 說明文件：
http://docs.sun.com/coll/S1_DirectoryServer_52
如果使用者已存在於 LDAP 目錄中，可為該使用者手動或自動建立新行事曆：
- 手動 - 使用 cscal 公用程式的 create 指令為使用者建立新行事曆。請參閱建立新行事曆。
- 自動 - 如果 local.autoprovision 設定為 "yes" (預設)，且網域已被指定行事曆服務，當新使用者首次登入 Calendar Server 時，Calendar Server 會自動為該使用者建立新的預設行事曆。Calendar Server 會將該使用者的使用者 ID 用作新行事曆的行事曆 ID (calid)，除非具有該名稱的行事曆已經存在。
如果某位使用者向另一位尚未啟用行事曆記錄功能的使用者 (即該使用者沒有預設行事曆) 傳送請求，則 Calendar Server 會向傳送請求的使用者傳回錯誤「找不到行事曆」。
建立新行事曆
若要建立新行事曆，請使用 cscal 公用程式的 create 指令。該使用者 (使用者 ID) 必須已存在於目錄伺服器中。
如果您的站台使用的是 LDAP 行事曆查找資料庫 (CLD) 外掛程式，則必須依該使用者的 icsDWPHost LDAP 性質的指示，在該使用者的行事曆所在 (或將在) 的後端伺服器上建立新行事曆。如果您嘗試在其他後端伺服器上建立行事曆，cscal 公用程式將傳回錯誤。如需有關 LDAP CLD 外掛程式的資訊，請參閱配置 LDAP 行事曆查找資料庫 (CLD) 外掛程式。
例如，建立行事曆 ID (calid) 為 JSmith 的新行事曆：
cscal -o JSmith -n JohnSmithCalendar create JSmith
其中：
建立可檢視名稱為 Hobbies 且由 JSmith 所有，並對群組排程使用預設存取控制設定的行事曆：
cscal -n Hobbies -o JSmith create Personal
其中：
以下範例會建立一個與上述範例類似的新行事曆，但該行事曆還會與名為 sports 的類別相關聯，該範例還啟用雙預定功能，並且指定 RJones 為另一位所有者：
cscal -n Hobbies -o JSmith -g sports -k yes -y RJones create Personal
其中：
以下範例會建立一個與上述範例類似的行事曆，但還會為群組排程設定特定的存取控制設定：
cscal -n Hobbies -o JSmith -a "@@o^a^sfr^g" create Personal
其中，-a "@@o^a^sfr^g" 授予其他所有者對該行事曆的元件和行事曆特性的排程、空閒/忙碌以及讀取等存取權限，以進行群組排程。
管理 Calendar Server 使用者佈建使用者後，請使用 csuser 公用程式執行以下管理工作：
顯示使用者資訊
若要列出所有行事曆使用者或顯示指定使用者的行事曆性質，請使用 csuser 公用程式的 list 指令。
例如，顯示所有能使用行事曆記錄功能的使用者：
csuser list
顯示單一使用者 (如 JSmith) 的所有行事曆性質：
csuser -v list JSmith
停用和啟用使用者
若要防止使用者登入 Calendar Server，請使用 csuser 公用程式的 disable 指令。disable 指令可防止使用者存取行事曆資料，但不會從目錄伺服器或 Calendar Server 資料庫中移除該使用者的資訊。
例如，停用 JSmith 存取 Calendar Server：
csuser disable JSmith
該指令會防止 JSmith 登入 Calendar Server 以存取行事曆資料，但不會從行事曆資料庫中刪除 JSmith 的資料。但是，如果 JSmith 目前已登入 Calendar Server，則 JSmith 仍可存取行事曆資料，直至登出為止。
若要讓使用者可以存取 Calendar Server 並可選擇指定特定的配置設定 (如預設行事曆)，請使用 csuser 公用程式的 enable 指令。
例如，讓 JSmith 可以存取 (登入 Calendar Server) 並為 JSmith 指定預設行事曆：
csuser jsmith enable JSmith
刪除使用者
若要刪除 Calendar Server 使用者，請使用 csuser 公用程式的 delete 指令。
小心 csuser 公用程式的 delete 指令會從 LDAP 伺服器中移除使用者的所有 Calendar Server 資訊。如果已經備份行事曆資料庫，則可回復 Calendar Server 資料庫資訊。如需更多資訊，請參閱第 6 章「備份與復原 Calendar Server 資料」。
但是，僅當您已特別備份 LDAP 伺服器資訊時，才可回復該資訊。
例如，從 Calendar Server 中刪除 JSmith：
csuser delete JSmith
重設使用者性質
若要復原特定使用者之所有行事曆 LDAP 性質的預設設定，請使用 csuser 公用程式的 reset 指令。
例如，將 JSmith 的所有行事曆性質重設為預設配置設定：
csuser reset JSmith
管理使用者行事曆建立使用者行事曆後，請使用 cscal 公用程式執行以下管理工作：
顯示行事曆
若要顯示所有行事曆、某位使用者擁有的所有行事曆或特定行事曆的特性，請使用 cscal 公用程式的 list 指令。
例如，列出行事曆資料庫中的所有行事曆：
cscal list
列出 JSmith 擁有的所有行事曆：
cscal -o JSmith list
列出行事曆 ID 為 JSmith:meetings 的行事曆的所有特性：
cscal -v list JSmith:meetings
刪除行事曆
一般使用者可以透過 Calendar Express 取消訂閱行事曆，但無法從 Calendar Server 資料庫中刪除行事曆。刪除行事曆必須由具有系統管理權限的管理員來執行。
若要從 Calendar Server 中刪除一個或多個行事曆，請使用 cscal 公用程式的 delete 指令。此公用程式會刪除行事曆，但不會從目錄伺服器中刪除使用者。
小心 delete 指令會從行事曆資料庫中移除行事曆的所有資訊，並且無法復原。刪除某個行事曆後，僅當您曾備份該行事曆資料時才可回復該資料。如需更多資訊，請參閱第 6 章「備份與復原 Calendar Server 資料」。
cscal 公用程式可讓您刪除單個或多個行事曆。
例如，刪除行事曆 ID 為 JSmith:meetings 的特定行事曆：
cscal delete JSmith:meetings
刪除主要所有者為 JSmith 的所有行事曆：
cscal -o JSmith delete
停用和啟用行事曆
若要防止使用者存取某個行事曆，請使用 cscal 公用程式的 disable 指令。disable 指令可防止使用者存取該行事曆，但不會從行事曆資料庫中移除資訊。
例如，防止使用者存取 JSmith:meetings：
cscal disable JSmith:meetings
若要啟用某個行事曆，以允許使用者進行存取，請使用 cscal 公用程式的 enable 指令。例如，使用預設配置設定來啟用行事曆 JSmith:meetings：
cscal enable JSmith:meetings
啟用行事曆 JSmith:meetings 但不允許雙預定：
cscal -k no enable JSmith:meetings
修改行事曆特性
若要修改某個行事曆的特性，請使用 cscal 公用程式的 modify 指令。
例如，變更 AllAdmins 的群組排程存取控制設定，並將 RJones 指定為另一位所有者：
cscal -a "@@o^c^wd^g" -y RJones AllAdmins
其中：
從行事曆中移除特性
若要從某個行事曆中移除某個特性值，請使用 cscal 公用程式的 modify 指令，並以兩個雙引號 ("") 指定該選項的值。
例如，從 JSmith:meetings 中移除說明：
cscal -d "" modify JSmith:meetings
從 JSmith:meetings 中移除所有類別：
cscal -g "" modify JSmith:meetings
從 JSmith:meetings 中移除「其他所有者」：
cscal -y "" modify JSmith:meetings
回復「遺失的」行事曆
如果某位使用者的預設行事曆未顯示在 Calendar Express 的「檢視」標籤或「行事曆」標籤中，但仍存在於資料庫中，您可以使用以下性質更新該使用者的 LDAP 項目，從而回復該行事曆：
其中 default_calid 是使用者的預設行事曆 ID (calid)。
建立和管理資源行事曆資源行事曆與資源 (如會議室或者筆記型電腦或高射投影機等設備) 相關聯。
若要建立和管理資源行事曆，請使用 csresource 公用程式。若要執行 csresource，您必須以對 Calendar Server 執行時所在的系統具有管理員權限的使用者身份登入。
本節描述如何建立和管理資源行事曆，包含：
設定資源行事曆配置參數
表格 2-1 列出 ics.conf 檔案中的資源行事曆配置參數。
表格 2-1 中顯示的預設值會套用於新的資源行事曆，但您可以透過編輯 ics.conf 檔案變更這些預設值。如需更多資訊，請參閱編輯 ics.conf 配置檔案。
建立資源行事曆
Calendar Server 不會自動建立資源行事曆，因此您必須使用 csresource 公用程式的 create 指令，在您的站台上手動建立每個所需的資源行事曆。此指令會在 LDAP 目錄伺服器和行事曆資料庫中建立新行事曆的項目。以下是建立行事曆時的數條注意事項：
例如，建立行事曆 ID 為 aud100、可檢視名稱為 Auditorium (LDAP cn 性質) 以及預設設定如表格 2-1 所示的資源行事曆：
csresource -c aud100 create Auditorium
以下指令所執行的動作與上述範例相同，但 -k 選項允許對行事曆使用雙預定，-o 選項將 bkamdar 指定為行事曆的所有者，而 -y 選項則將 jsmith 指定為另一位所有者：
csresource -c aud100 -k yes -o bkamdar -y jsmith create Auditorium
如果未指定資源行事曆的所有者，則該值將取自 ics.conf 檔案中的 service.admin.calmaster.userid 參數。
顯示資源行事曆和性質
若要顯示資源行事曆，請使用 csresource 公用程式的 list 指令。
例如，顯示所有 Calendar Server 資源行事曆及其相應 LDAP 性質的清單：
csresource list
顯示名為 Auditorium 的特定資源行事曆的所有 LDAP 性質清單：
csresource -v list Auditorium
修改資源行事曆
若要修改資源行事曆，請使用 cscal 公用程式的 modify 指令 (csresource 沒有 modify 指令)。
例如，將所有者設定為 tchang，並將另一位名為 mwong 的所有者新增至名為 Auditorium 的資源行事曆：
cscal -o tchang -y mwong modify aud100
在此範例中，cscal 公用程式需要 calid (aud100)，而非行事曆名稱 (Auditorium)。
停用和啟用資源行事曆
您可能需要停用某個資源行事曆，以防止使用者排程事件。例如，某間會議室在改建期間可能無法使用，或者某台高射投影機可能已送去修理。
若要停用或啟用資源行事曆，請使用 csresource 公用程式的 enable 或 disable 指令。
例如，停用名為 Auditorium 的資源行事曆：
csresource disable Auditorium
稍後啟用該資源行事曆：
csresource enable Auditorium
刪除資源行事曆
若要刪除資源行事曆，請使用 csresource 公用程式的 delete 指令。
例如，刪除 Auditorium 資源行事曆：
csresource delete Auditorium
Calendar Server 會顯示以下訊息：
您確實要刪除該資源嗎 (y/n)？
輸入「y」可刪除該行事曆，輸入「n」可取消該作業。
如果輸入「y」，則 Calendar Server 會刪除該行事曆並顯示一條訊息，指明該行事曆已被刪除。
連結至行事曆只要使用者行事曆或資源行事曆的許可權被設定為允許使用讀取權，您便可以建立指向一個或多個使用者行事曆或資源行事曆的連結。例如，您可以將行事曆連結嵌入網頁或電子郵件訊息中。這樣，其他使用者無需登入 Calendar Server，即可匿名檢視該行事曆。
若要建立指向一個或多個使用者行事曆的連結，請使用以下語法：
http://hostname:port/[command.shtml]?calid=calid-1;calid-2; ... ;calid-n&view=viewname
用分號 (;) 分隔各行事曆 ID (calid)。
viewname 可以為 overview、dayview、weekview 或 monthview。(檢視還可以為 yearview，但是很少使用。)
注意：如果您不使用 view (或其他) 選項，且僅連結至一個行事曆，請省略 command.shtml。
例如，若要連結至 jsmith 的預設行事曆，請輸入：
http://calendar.sesta.com:8080/?calid=jsmith
連結至 calid 為 overhead_projector10 的高射投影機資源行事曆：
http://calendar.sesta.com:8080/?calid=overhead_projector10
但是，若要連結至 jsmith 和 tchang 的預設行事曆，並以日檢視顯示這些行事曆，則輸入：
http://calendar.sesta.com:8080/command.shtml?calid=jsmith;tchang&view=dayview
