Sun Java System Instant Messaging 7 2005Q1 管理指南 |
附錄 A
Instant Messaging 配置參數本章於下列章節中說明 Instant Messaging 配置參數:
使用 iim.conf 檔案Instant Messaging 會將 iim.conf 檔案中的配置設定儲存在配置目錄 (im_cfg_base) 中。
此檔為 ASCII 純文字檔,每行都會定義伺服器參數及其值:
- 參數及其值是由等號 (=) 分隔,等號之前或之後可以允許包含空格與標籤。
- 數值可以用雙括號 (" ") 括起。如果參數允許多值,則必須將整個值字串以雙括號括起。
- 註釋行必須要以驚嘆號 (!) 作為一行的第一個字元。註釋行是作為提供資訊之用,而且會被伺服器所忽略。
- 如果參數出現不只一次,則列出的最後參數值將會覆蓋先前的值。
- 反斜線 (\) 是用於接續後面內容,並指出值的內容超過一行。
- 每行會終止於行終止符號 (\n、\r 或 \r\n)。
- 鍵值是由以第一個非空格字元和第一個 ASCII 等號 (=) 或分號 (;) 開頭的行中所有字元所組成。如果鍵值被分號所終止,而它後面跟著 "lang-" 和一個標籤,表示將要在其中解譯此值的語言。語言標籤後面會接著等號 (=)。所有等號之前或之後的空白字元將會被忽略。行中所有剩餘的字元將會變為相關值字串的一部份。
- 值字串中的多重值會使用逗號 (,) 分隔。
- 在值中如果出現任何特殊字元 (例如逗號、空格、新行、標籤、雙括號或反斜線),則整個值都必須包含在雙括號當中。此外,每個值中的換行鍵、返回字元、標籤、反斜線和雙括號必須以反斜線 (\) 指定。
- 如果您變更了 iim.conf 檔案,您必須更新 Instant Messaging 伺服器以便使得新的配置設定能夠生效。
一般配置參數表 A-1 列出並描述一般配置參數。
使用者來源配置參數表 A-2 列出並描述使用者來源配置參數。
記錄配置參數表 A-3 列出並描述記錄配置參數。
Instant Messaging 伺服器配置參數表 A-4 列出並描述 Instant Messaging 伺服器配置參數。
多重伺服器配置參數為了網路中的多重 Instant Messaging 伺服器之間能夠彼此通訊,您需要將您的伺服器配置為使本身能夠識別將會與您的伺服器連接的其他伺服器、每個 coserver 或是合作伺服器。協同伺服器可利用其 Instant Messaging 網域名稱、主機和連接埠號碼、伺服器 ID 以及密碼識別本身的身份。
將會提供每個合作伺服器一個符號名稱,而該名稱是由字母與數字組成的字串,例如 coserver1。使用您可以指定多重伺服器的符號命名慣例。
當 Instant Messaging 伺服器是以此方式配置時,您可以形成較大的 Instant Messaging 社群。所以:
表 A-5 列出並描述多重伺服器配置參數。
多重訊號組合器配置參數表 A-6 列出並描述多重訊號組合器配置參數。
監視程式參數監視程式會監視伺服器程序,若確定伺服器未在執行,則會嘗試重新啟動伺服器。如需關於監視程式的更多資訊,請參閱管理監視程式程序。
表 A-7 列出並描述監視程式的配置參數。
代理程式參數代理程式 (如 Calendar 代理程式) 會啟用 Instant Messaging 伺服器的功能,並增強其與其他 Sun JavaTM System 伺服器的互通功能。
表 A-8 列出並描述代理程式配置參數。
表 A-8 代理程式配置參數
參數
預設值
說明
jms.consumers
無
與 Calendar 代理程式一起使用。包含警示的名稱。此參數的值必須設定為:
cal_reminder
jms.consumer.cal_reminder.destination
無
與 Calendar 代理程式一起使用。警示目標。這必須和 ics.conf 檔案中 caldb.serveralarms.url 配置參數的值相同。例如,
enp:///ics/customalarm
jms.consumer.cal_reminder.provider
無
與 Calendar 代理程式一起使用。提供者的名稱。一般而言,這會設定為 ens。此參數的值必須與 jms.providers 中的名稱相同。
jms.consumer.cal_reminder.type
無
與 Calendar 代理程式一起使用。要設定的警示類型。此參數的值必須設定為:
topic
jms.consumer.cal_reminder.param
無
與 Calendar 代理程式一起使用。警示參數。此參數的值必須設定如下 (包括引號):
"eventtype=calendar.alarm"
jms.consumer.cal_reminder.factory
無
與 Calendar 代理程式一起使用。註冊其本身以使用新行事曆提醒訊息的偵聽者。此參數的值必須設定為:
com.iplanet.im.server.JMSCalendarMessageListener
jms.providers
無
與 Calendar 代理程式一起使用。提供者的名稱。一般而言,此參數的值設定為 ens。必須與 jms.consumer.cal_reminder.provider 所列的值相同。
jms.provider.ens.broker
無
與 Calendar 代理程式一起使用。ENS 主機名稱與 ENS 偵聽傳入請求的連接埠號。設定為 ics.conf 檔案參數 service.ens.port 中指定的連接埠。預設為 57997。例如:
jms.provider.ens.broker=cal.example.com:
57997jms.provider.ens.factory
無
與 Calendar 代理程式一起使用。用於建立主題連線物件的工廠類別。此參數的值必須設定為:
com.iplanet.ens.jms.EnsTopicConnFactory
iim_agent.enable
無
若為 TRUE 或 iim.conf 中沒有,則會啟用 Instant Messaging 代理程式。將值設定為 FALSE 以停用所有代理程式。
iim_agent.agent-calendar.enable
無
與 Calendar 代理程式一起使用。若為 TRUE 或 iim.conf 中沒有,則會特別載入啟用 Calendar 代理程式的元件。
agent-calendar.jid
無
Calendar 代理程式的 JID。
agent-calendar.password
無
Calendar 代理程式密碼。
iim_server.components
無
將 Calendar 代理程式描述為 Instant Messaging 伺服器的元件。此參數的值必須設定為:
agent-calendar