4.6 配置行事曆服務 (常駐程式)

本小節包含如何配置行事曆服務 (常駐程式) 的說明。

本小節包含以下主題：

• 配置啟動及停止服務

• 配置 Calendar Server 版本 6.3 的監視程式 (程序)

• 配置管理服務 (csadmind)

• 配置 Calendar Server 版本 6.3 的 HTTP 服務 (cshttpd)

• 配置 Calendar Server 版本 6.3 的警示通知

另請參閱第 9 章, 配置自動備份。

配置啟動及停止服務

start-cal 和 stop-cal 指令是包裝程式程序檔，可輕鬆啟動和停止 Calendar Server。此公用程式定義於附錄 DCalendar Server 指令行公用程式參照 中。

1. 以擁有變更配置權限的管理員身份登入。

2. 透過發出 stop-cal 指令來停止 Calendar Server 服務。

3. 移至 /etc/opt/SUNWics5/cal/config 目錄。

4. 透過複製及重新命名，儲存舊的 ics.conf 檔案。

5. 如下表中所示編輯一個或多個參數︰

   參數	說明和預設值
   local.serveruid	執行階段使用者識別碼 (user identifier, uid)。預設為 "icsuser"。這是在不需要超級使用者權限時所使用的使用者識別碼。
   local.servergid	執行階段群組識別碼 (group identifier, gid)。預設為 "icsgroup"。這是在不需要超級使用者權限時所使用的群組識別碼。
   local.autorestart	若此參數設定為 "yes"，則當連線到 watcher 的服務因不適當地中斷連線而終止時，會自動重新啟動它。
   local.autorestart.timeout	定義自動重新啟動逾時間隔。為了避免在自動啟動時無限期嘗試重新啟動，因此當服務在特定間隔內終止兩次後，就不會再重新啟動該服務。預設設定為 10 分鐘。

6. 將檔案儲存為 ics.conf。

7. 重新啟動 Calendar Server。

   cal-svr-base /SUNWics5/cal/sbin/start-cal

配置 Calendar Server 版本 6.3 的監視程式 (程序)

監視程式 (程序) watcher 可監視失敗的通訊端連線。它可與 Calendar Server 和 Messaging Server 搭配使用。若要設定 Calendar Server 參數來配置監視程式，請執行以下步驟：

1. 以擁有變更配置權限的管理員身份登入。

2. 透過發出 stop-cal 指令來停止 Calendar Server 服務。

3. 移至 /etc/opt/SUNWics5/cal/config 目錄。

4. 透過複製及重新命名，儲存舊的 ics.conf 檔案。

5. 如下表中所示編輯一個或多個參數︰

   參數	說明和預設值
   local.watcher.enable	若此參數設為 "yes"，則啟動程式會先嘗試啟動 watcher 再啟動其他任何服務。然後常駐程式會透過通訊端連線來連線它。預設為 "no"，但配置程式會將它變更為 "yes"。
   local.watcher.port	這是 watcher 偵聽的連接埠。Messaging Server 使用連接埠 49994。Calendar Server 必須使用不同的連接埠，例如 49995。
   local.watcher.config.file	watcher 的配置檔。若為相對路徑，則是相對於 config 目錄。預設為 watcher.cnf。
   service.autorestart	如果設定為 "yes"，則監視程式會自動重新啟動因未適當地中斷連線而終止的任何已註冊服務。如果服務在 10 分鐘內終止兩次，則監視程式不會再重新啟動該服務。

6. 將檔案儲存為 ics.conf。

7. 重新啟動 Calendar Server。

   cal-svr-base /SUNWics5/cal/sbin/start-cal

另請參閱

如需監視程式 (程序) 的更多資訊，請參閱「Sun Java System Messaging Server 6.3 Administration Guide」。第 4 章和第 23 章都有相關資訊。

如果已啟用監視程式，則必須以監視程式 (程序) 註冊監視程式要監視的每個服務。Calendar Server 常駐程式會自動在內部完成此工作。或者，常駐程式會在 cal-svr-base/data/proc目錄中建立 pid 檔案，其中包含每個服務的程序 ID 及其狀態，狀態可能為 "init" 或 "ready"。

配置管理服務 (csadmind)

1. 以擁有變更配置權限的管理員身份登入。

2. 移至 /etc/opt/SUNWics5/cal/config 目錄。

3. 透過複製及重新命名，儲存舊的 ics.conf 檔案。

4. 如下表中所示編輯一個或多個參數︰

   參數	說明和預設值
   local.store.checkpoint.enable	如果為 "yes"，則啟動 csadmind 資料庫檢查點執行緒。如果為 "no"，則不建立檢查點記錄檔。預設為 "yes"。
   service.admin.dbcachesize	用於管理階段作業之 Berkeley 資料庫的最大快取記憶體大小 (以位元組為單位)。預設為 "8388608"。
   local.store.deadlock.enable	如果為 "yes"，則啟動 csadmind 資料庫死結偵測執行緒。預設為 "yes"。
   service.admin.diskusage	如果為 "yes"，則啟動 csadmind 低磁碟空間監視執行緒。預設為 "no"。依預設，不監視磁碟使用。
   service.admin.enable	如果為 "yes"，則在啟動所有服務時啟動 csadmind 服務，並在停止所有服務時停止 csadmind。預設為 “yes”。
   service.admin.maxthreads	每個管理階段作業的執行中執行緒的最大數目。預設為 “10”。
   service.admin.resourcetimeout	使管理連線逾時之前的秒數。預設為 “900”。
   service.admin.serverresponse	如果為 "yes"，則啟動 csadmind 服務的回應執行緒。預設為 “no”。
   service.admin.sessiondir.path	管理階段作業請求的暫存目錄。無預設。
   service.admin.sessiontimeout	使 HTTP 階段作業在 csadmind 中逾時之前的秒數。預設為 “1800”。
   service.admin.sleeptime	在檢查已啟動、已停止或準備好的行事曆服務之間等待的秒數。預設為 “2”。
   service.admin.starttime	任一行事曆服務啟動之前需要等待的秒數。預設為 "300"。
   service.admin.stoptime	任一行事曆服務停止之前需要等待的秒數。預設為 "300"。
   service.admin.stoptime.next	在向任一行事曆服務傳送 stop 指令之間等待的秒數。預設為 “60”。

5. 將檔案儲存為 ics.conf。

6. 重新啟動 Calendar Server。

   cal-svr-base /SUNWics5/cal/sbin/start-cal

配置 Calendar Server 版本 6.3 的 HTTP 服務 (cshttpd)

1. 以擁有變更配置權限的管理員身份登入。

2. 移至 /etc/opt/SUNWics5/cal/config 目錄。

3. 透過複製及重新命名，儲存舊的 ics.conf 檔案。

4. 如下表中所示編輯一個或多個參數︰

   參數	說明和預設值
   service.http.admins	以空格分隔的對此 Calendar Server 具有管理權限的使用者 ID 清單。預設為 "calmaster"。
   service.http.allowadminproxy	如果為 "yes" (預設值)，則允許透過代理伺服器登入。
   service.http.allowanonymouslogin	如果為 "yes"，則允許匿名 (無認證) 存取。這是特殊類型的登入，只允許指定的受限制的存取 (通常僅讀取對公開行事曆的存取)。預設為 "yes"。
   service.http.calendarhostname	用於擷取 HTML 文件的 HTTP 主機。若要允許使用者使用完全合格的主機名稱存取行事曆資料，該值必須為執行 Calendar Server 的機器之完全合格的主機名稱 (包括機器名稱、DNS 網域和字尾)，如 mycal@sesta.com。 如果未指定，則使用本機 HTTP 主機。
   service.http.commandlog	此參數僅適用於除錯。如果設定為 "yes"，則系統會將所有傳入的指令記錄到 http.commands 記錄檔。 請勿在生產執行階段使用此參數。它會很快地填入記錄檔，並可能導致效能降低。
   service.http.commandlog.all	此參數僅適用於除錯。如果設定為 "yes"，則系統會將所有 HTTP 請求記錄到 http.access 記錄檔。 請勿在生產執行階段使用此參數。它會很快地填入記錄檔，並可能導致效能降低。
   service.http.cookies	告知伺服器是否支援 cookie (yes/no)。必須設定為 "yes" 才可啟用單次登入。預設為 "yes"。
   service.http.dbcachesize	用於 HTTP 階段作業之 Berkeley 資料庫的最大快取記憶體大小。預設為 "8388308"。
   service.http.domainallowed	如果已指定且不為空白 (" ")，則會進行篩選以允許基於 TCP 網域的存取。例如，"ALL: LOCAL.sesta.com" 將允許對 sesta.com 網域中的任何人進行本機 HTTP 存取。多個篩選器由 CR-LF (換行) 分隔。預設為空白 ("")。
   service.http.domainnotallowed	如果已指定且不為空白 (" ")，則進行篩選以不允許基於 TCP 網域的存取。例如，"ALL: LOCAL.sesta.com" 將拒絕對 sesta.com 網域中的任何人進行 HTTP 存取。多個篩選器必須由 CR-LF (換行) 分隔。預設為空白 (" ")。
   service.http.attachdir.path	與 local.queuedir 相對的目錄位置 (或指定的絕對路徑)，用於暫時儲存匯入的檔案。預設為目前目錄 (".")。
   service.http.ipsecurity	如果為 "yes"，則參照現有階段作業的所有請求均被驗證為來源於同一 IP 位址。預設為 “yes”。
   service.http.enable	如果為 "yes"，則在啟動所有服務時啟動 cshttpd 服務，並在停止所有服務時停止 cshttpd。預設為 “yes”。 注意 – 使用此參數停用 HTTP 服務還將停用 HTTPS。
   service.http.idletimeout	使 HTTP 連線逾時之前的秒數。預設為 “120”。
   service.http.listenaddr	指定 HTTP 服務將為用戶端請求偵聽的 TCP 位址。預設為 "INADDR_ANY"，表示任何位址。
   service.http.logaccess	如果為 "yes"，則會完全記錄至伺服器的 HTTP 連線。預設為 “no”。
   service.http.maxsessions	cshttpd 服務中 HTTP 階段作業的最大數目。預設為 “5000”。
   service.http.maxthreads	cshttpd 服務中回應 HTTP 請求之執行緒的最大數目。預設為 “20”。
   service.http.numprocesses	應在某個伺服器上同步執行的 HTTP 服務 (cshttpd) 程序的最大數目。預設為 "1"。 有關具有多個 CPU 的伺服器，請參閱21.8 使用跨多個 CPU 的負載平衡功能。
   service.http.port	來自 Calendar Server 使用者之 HTTP 請求的連接埠。預設為 “80”。
   service.http.proxydomainallowed	如果已指定且不為 ""，則進行篩選以允許基於 TCP 網域的代理登入。語法與 service.http.domainallowed相同。預設為 ""。
   service.http.resourcetimeout	使 HTTP 階段作業逾時之前的秒數。預設為 “900”。
   service.http.sessiondir.path	HTTP 階段作業資料庫的目錄。預設為 “http”。
   service.http.sessiontimeout	使 HTTP 階段作業在 cshttpd 服務中逾時之前的秒數。 預設為 “1800”。
   service.http.sourceurl	相對於可執行檔的目錄，其中儲存檔案的所有 URL 參照。預設為 "" (空值)。
   service.http.tmpdir	HTTP 階段作業的暫存目錄。預設為 "/var/opt/SUNWics5/tmp"。

5. 將檔案儲存為 ics.conf。

6. 重新啟動 Calendar Server。

   cal-svr-base /SUNWics5/cal/sbin/start-cal

配置 Calendar Server 版本 6.3 的警示通知

1. 以擁有變更配置權限的管理員身份登入。

2. 移至 /etc/opt/SUNWics5/cal/config 目錄。

3. 透過複製及重新命名，儲存舊的 ics.conf 檔案。

4. 如下表中所示編輯以下一個或多個 ics.conf 參數︰

   參數	說明和預設值
   alarm.diskstat.msgalarmdescription	與磁碟空間不足訊息一起傳送的說明。  預設說明為： “percentage calendar partition diskspace available”。
   alarm.diskstat.msgalarmstatinterval	監視磁碟空間的間隔秒數。預設為 “3600”。
   alarm.diskstat.msgalarmthreshold	觸發傳送警告訊息的可用磁碟空間百分比。預設為 “10”。
   alarm.diskstat.msgalarmthresholddirection	alarm.diskstat.msgalarmthreshold 是高於還是低於百分比。-1 為低於，1 為高於。預設為 “-1”。
   alarm.diskstat.msgalarmwarninginterval	傳送有關磁碟空間不足警告訊息的間隔小時數。預設為 “24”。
   alarm.msgalarmnoticehost	用於傳送伺服器警示之 SMTP 伺服器的主機名稱。預設為 "localhost"。
   alarm.msgalarmnoticeport	用於傳送伺服器警示的 SMTP 連接埠。預設為 “25”。
   alarm.msgalarmnoticercpt	將伺服器警示傳送至的電子郵件位址。“Postmaster@localhost”
   alarm.msgalarmnoticesender	伺服器傳送警示時用作寄件者的電子郵件位址。預設為 “Postmaster@localhost”
   alarm.msgalarmnoticetemplate	用於傳送電子郵件警示的預設格式為︰  "From: %s\nTo: %s\nSubject: ALARM: %s of \"%s\" is n\n%s\n"
   alarm.responsestat.msgalarmdescription	與無服務回應訊息一起傳送的說明。預設為 “calendar service not responding”。
   alarm.responsestat.msgalarmstatinterval	監視服務的間隔秒數。預設為 “3600”。
   alarm.responsestat.msgalarmthreshold	預設為 “100” (如果沒有服務回應，則僅觸發傳送警告訊息。)
   alarm.responsestat. msgalarmthresholddirection	指定 alarm.responsestat.msgalarmthreshold 是高於百分比還是低於百分比。-1 為低於，1 為高於。預設為 "-1"
   alarm.responsestat. msgalarmwarninginterval	傳送發出的有關無服務回應警告訊息的間隔小時數。預設為 “24”。
   local.rfc822header.allow8bit	在此伺服器傳送的電子郵件中允許 ("y") 或不允許 ("n") 8 位元標題。
   service.admin.alarm	啟用 ("yes") 或停用 ("no") 管理工具的警示通知。預設為 “yes”。

5. 將檔案儲存為 ics.conf。

6. 重新啟動 Calendar Server。

   cal-svr-base /SUNWics5/cal/sbin/start-cal