Sun Java System Instant Messaging 7.2 管理指南

第 3 部分 參考資訊

附錄 A iim.conf 中的 Instant Messaging 配置參數

本章在以下幾節說明 iim.conf 檔案中的 Instant Messaging 配置參數:

iim.conf 檔案位置

Instant Messaging 將配置設定儲存在配置目錄 (im-cfg-base) 的 iim.conf 檔案中。

如果您已建立多個 Instant Messaging 實例,則 /default 目錄的名稱會根據實例而有所不同。如需詳細資訊,請參閱從單次 Instant Messaging 安裝中建立多個實例

iim.conf 檔案語法

此檔案是 ASCII 純文字檔案,其中每一行均定義一個伺服器參數及其值:


備註 –

iim.conf 檔案會由安裝程序初始化,而且只能夠依照本手冊所述的方法加以修改。


一般配置參數

表 A–1 列出並描述一般配置參數。

表 A–1 一般配置參數

參數 

預設值 

說明 

iim.comm.modules

iim_server、iim_mux

使用通訊模組。可能的值為 iim_serveriim_mux。預設值為 iim_server, iim_mux,表示同時使用伺服器與多重訊號組合器。iim_mux 值適用於多重訊號組合器。

iim.smtpserver

localhost

將郵件傳送到一般使用者的 SMTP 伺服器,這些一般使用者已設定選項將其訊息以電子郵件轉寄或將訊息轉寄至呼叫器。

iim.instancedir

/opt

安裝目錄根。 

iim.instancevardir

Solaris:/var/opt/SUNWiim/default

Linux:/var/opt/sun/im/default

將目錄設定為包含執行階段檔案,包括一般使用者設定檔資料庫、記錄和伺服器與多重訊號組合器在執行階段建立的其他檔案。如果您建立了多個 Instant Messaging 實例,則 /default 目錄的名稱會有所不同。

iim.user

inetuser 用於 LDAP 部署。

root 用於入口網站部署。

伺服器程序執行的一般使用者名稱。 

iim.group

inetgroup 用於 LDAP 部署。

root 用於入口網站部署。

伺服器程序執行時所使用的群組。 

iim.jvm.maxmemorysize

256

允許執行伺服器的 JVM 所使用的最大堆疊大小,單位為 MB。用於建構 Java 指令的 -mx 引數。

iim.mail.charset

無 

此參數指定郵件的標頭是否為 ASCII 格式且未經過編碼。 

參數中包含用於對離線警示郵件訊息標頭進行編碼的字元集的名稱。 

例如:iim.mail.charset=iso-2022-jp

iim.jvm.command

/usr/j2se/bin/java

Java Runtime Executable (JRE) 的位置。

iim.identity.basedir

/opt

Sun JavaTM System Access Manager 的預設安裝目錄,也稱做基底目錄。

iim.identity.jre

/usr/java_1.3.1_04

JRE 的位置,Access Manager 使用此 JRE 執行其所有程序。

iim.portal.deployuri

/portal

用於在 Access Manager 中部署 Portal Server war 檔案的 URI。

iim.portal.host

imhostname

執行 Portal Server 的伺服器主機名稱。如果使用非預設的連接埠號碼時,指定連接埠號碼。 

iim.portal.protocol

http

用於存取 Portal Server 的通訊協定。 

iim.policy.cache.validity

10 

定義單一使用者訊息的快取有效間隔 (單位為分鐘)。 

Instant Messaging 伺服器儲存上次快取單一一般使用者資訊的日期。如果在由此參數決定的間隔之後存取一般使用者的資訊,伺服器將重新快取一般使用者的資訊,並重設 LocalUser 物件的快取日期。

iim.policy.modules

iim_ldap

依據預設,使用 LDAP 進行策略儲存。將值變更為 identity,則表示使用 Sun Java System Access Manager 進行策略儲存。

iim.policy.resynctime

720

定義所有一般使用者資訊的快取有效間隔 (單位為分鐘)。 

Instant Messaging 伺服器會定期清除所有快取的一般使用者資訊,以便移除舊有的一般使用者資訊。此參數指定清除所快取一般使用資訊的頻率。 

iim.userprops.store

file

依據預設,當您執行 configure 公用程式時,如果您選擇不使用 Access Manager 進行策略儲存,那麼使用者特性會儲存在使用者特性檔案中。如果您選擇使用 Access Manager 進行策略儲存,則預設值為 ldap。變更值即會變更使用者特性的儲存位置。如果您將此值從 file 變更為 ldap,則必須執行 imadmin assign_services,以將必要的物件類別增加至目錄中的使用者項目。

此參數只有在已安裝線上狀態和 Instant Messaging 服務的服務定義時才有意義。 

LDAP 和使用者註冊配置參數

表 A–2 列出並描述 Instant Messaging 在 LDAP、使用者註冊和使用者來源配置中所使用的參數。

表 A–2 LDAP、使用者註冊和來源配置參數

參數 

預設值 

說明 

iim_ldap.host

localhost:389

Instant Messaging 伺服器進行一般使用者認證所使用的 LDAP 伺服器名稱與連接埠。

iim_ldap.searchbase

o=internet

用作在 LDAP 伺服器上搜尋一般使用者和群組之基礎的字串。 

iim_ldap.usergroupbinddn

無 (伺服器執行匿名搜尋) 

指定用於連結 LDAP 伺服器以進行搜尋的 DN。

iim_ldap.usergroupbindcred

無 (伺服器執行匿名搜尋) 

指定與 iim_ldap.usergroupbinddn DN 一起使用以進行 LDAP 搜尋的密碼。

iim_ldap.loginfilter

(&(|(objectclass=inetorgperson)(objectclass=webtopuser))(uid={0}))

一般使用者登入期間使用的搜尋篩選器。整個篩選器作為一行輸入。 

iim_ldap.usergroupbyidsearchfilter

(|(&(objectclass=groupofuniquenames)(uid={0}))(&(|(objectclass=inetorgperson)(objectclass=webtopuser))(uid={0})))

用於在由 ID 指定的基礎下搜尋目錄中的一般使用者和群組的搜尋篩選器。整個篩選器作為一行輸入。 

iim_ldap.usergroupbynamesearchfilter

(|(&(objectclass=groupofuniquenames)(cn={0}))

(&(|(objectclass=inetorgperson)(objectclass=webtopuser))(cn={0})))

用於在由名稱指定的基礎下搜尋目錄中的一般使用者和群組的搜尋篩選器。 

iim_ldap.allowwildcardinuid

False

判定當執行搜尋時,是否應為 UID 啟用萬用字元。由於多數的目錄安裝都指明 UID 僅進行精確搜尋,因此預設值為 False。除非將 UID 指定為進行子字串搜尋,否則將此值設定為 True 可能會影響效能。

iim_ldap.userclass

inetOrgPerson,webtopuser

用於指定項目屬於某個一般使用者的 LDAP 類別。

iim_ldap.groupclass

groupOfUniqueNames

用於指定項目屬於某個群組的 LDAP 類別。

iim_ldap.groupbrowsefilter

(objectclass=groupofuniquenames)

用於在指定搜尋庫下瀏覽目錄中所有群組的搜尋篩選器。 

iim_ldap.searchlimit

40

搜尋所傳回的輸入項目的最大值。-1 表示搜尋已在此伺服器上停用,0 則表示未限制的搜尋。

iim_ldap.userdisplay

cn

用於顯示一般使用者名稱的 LDAP 屬性。

iim_ldap.groupdisplay

cn

用於顯示群組名稱的 LDAP 屬性。

im_ldap.useruidattr

uid

用作一般使用者的 UID 的 LDAP 屬性。

im_ldap.groupmemberattr

uniquemember

提供群組成員清單的 LDAP 屬性。

iim_ldap.usermailattr

mail

包含一般使用者佈建的電子郵件地址的 LDAP 屬性。電子郵件傳送給離線一般使用者時使用。

iim_ldap.userattributes

無 

包含 LDAP 使用者項目的自訂屬性清單的 LDAP 屬性。

iim_ldap.groupattributes

無 

包含 LDAP 群組項目的自訂屬性清單的 LDAP 屬性。

iim_ldap.groupmemberurlattr

無 

動態群組的成員身份屬性,包含 LDAP 篩選器或 LDAP URL。

iim_ldap.useidentityadmin

當您執行 configure 公用程式時,如果您選擇針對策略使用 Access Manager 部署,則預設值為 true。否則,預設值為 false

如果值為 true,則 Access Manager 管理員憑證將會用來連結 Directory Server。

iim.register.enable

無 

如果為 TRUE,則伺服器允許新的 Instant Messaging 一般使用者使用 Instant Messenger 進行註冊 (將自己增加至目錄)。

iim_ldap.register.basedn

無 

如果啟動自我註冊功能,則此參數值為 LDAP 目錄中人員項目儲存位置的 DN。例如:

"ou=people,dc=siroe,dc=com"

iim_ldap.register.domain

無 

將在其中增加新使用者的網域。例如,directory.siroe.com

記錄配置參數

表 A–3 列出並描述 log4j 式記錄和 iim.conf 參數式記錄的記錄配置參數。

表 A–3 記錄配置參數

參數 

預設值 

說明 

iim.log.iim_server.severity

INFO

伺服器模組所需的記錄層級。可能值從最高級別到最低級別依次為:FATALERRORWARNINGINFODEBUG。如果選擇了較低的記錄層級,表示您也會取得較高的層級。例如,如果您選擇了 WARNING,則也會得到 FATALERRORWARNING

iim.log.iim_server.url

im-runtime-base/log/xmppd.log

伺服器記錄檔案的位置。必須定期刪除此檔案的內容,以免佔滿磁碟空間。 

iim.log.iim_mux.severity

INFO

多重訊號組合器模組所需的記錄層級。可能值從最高級別到最低級別依次為:FATALERRORWARNINGINFODEBUG。如果選擇了較低的記錄層級,表示您也會取得較高的層級。例如,如果您選擇了 WARNING,則也會得到 FATALERRORWARNING

iim.log.iim_mux.url

im-runtime-base/log/mux.log

多重訊號組合器記錄檔的位置。必須定期刪除此檔案的內容,以免佔滿磁碟空間。 

iim.log.iim_mux.maxlogfiles

10 

儲存的多重訊號組合器記錄檔的最大檔案數。一旦超過此數字,則刪除最舊的多重訊號組合器記錄檔。 

iim.log.iim_mux.maxlogfilesize

10 MB 

此參數包含了多重訊號組合器記錄檔大小的最大值。如果記錄檔超過此參數中所指定的大小,便會建立新的記錄檔。 

iim.log.iim_server.maxlogsize

 

此參數包含了伺服器記錄檔大小的最大值。如果記錄檔超過此參數中所指定的大小,便會建立新的記錄檔。 

iim.log.iim_wd.severity

INFO

監視程式所需的記錄層級。可能值從最高級別到最低級別依次為:FATALERRORWARNINGINFODEBUG。如果選擇了較低的記錄層級,表示您也會取得較高的層級。例如,如果您選擇了 WARNING,則也會得到 FATALERRORWARNING

iim.log.agent-calendar.severity

INFO

行事曆代理程式所需的記錄層級。可能值從最高級別到最低級別依次為:FATALERROR WARNINGINFODEBUG。如果選擇了較低的記錄層級,表示您也會取得較高的層級。例如,如果您選擇了 WARNING,則也會得到 FATALERRORWARNING

iim.log4j.config

im-cfg-base

指定 log4j 配置檔案的位置和名稱。如果此參數沒有值,則記錄程式將在 im-cfg-base 中尋找 log4j.conf 。 如果記錄程式在 im-cfg-base 中找不到 log4j.conf,則會使用參數式的記錄方法來替代 log4j。

Instant Messaging 伺服器配置參數

表 A–4 列出並描述 Instant Messaging 伺服器配置參數。

表 A–4 一般 Instant Messaging 伺服器配置參數

參數 

預設值 

說明 

iim_server.autosubscribe

FALSE

表示伺服器是否自動授權訂閱。可能的值為 TRUEFALSE。若為 TRUE,訂閱請求後面會自動跟有伺服器產生的訂閱回應。然後伺服器將已修改的值勤人傳送至訂閱者和訂閱者新增為連絡人的使用者。若要使用此功能,使用者與連絡人必須位於相同的網域。

iim_server.domainname

主機的網域名稱

您希望此伺服器支援的邏輯 Instant Messaging 伺服器網域名稱。此為網路中其他伺服器用以識別此伺服器的名稱。它同時也是此伺服器用來讓其他伺服器識別其一般使用者時所使用的名稱。此名稱不一定是執行 Instant Messaging 伺服器之系統的完全合格網域名稱。 

例如,如果系統 iim.xyz.comxyz.com 公司唯一的 Instant Messaging 伺服器,則網域名稱有可能會是 xyz.com

iim_server.port

5269

伺服器所連結的 IP 位址和連接埠,伺服器也從此偵聽來自其他伺服務的連線。對於多址主機而言,如果您只需要使用一個特定的 IP 位址,則 IP 位址設定非常有用。如果未列出 IP 位址,它將表示 localhost 上的 INADDR_ANY 值。

iim_server.useport

TRUE

表示伺服器是否在伺服器對伺服器通訊埠上偵聽。可能的值為 TRUEFALSE。如果為 TRUE,則伺服器會在 iim_server.port 所定義的連接埠上進行偵聽,或是在連接埠 5269 上偵聽 (如果未明確定義)。

iim_server.clienttimeout

15

指定伺服器捨棄不在使用中的用戶端連線之前所等待的時間間隔 (單位為分鐘)。例如,當機器關閉時。可接受的最小值為 5。 

iim_server.usesso

當您執行 configure 公用程式時,如果您選擇針對 SSO 使用 Access Manager 部署,則預設值為 1。否則,預設值為 0

此參數可指示伺服器在認證期間是否依靠 SSO 提供者。SSO 提供者是伺服器用來透過 SSO 服務驗證階段作業 ID 的模組。

Instant Messaging 伺服器能夠使用 Access Manager Session API 驗證由用戶端傳送的階段作業 ID。

此參數的值可以是 01-1

0 - 不使用 SSO 提供者。

1 - 先使用 SSO 提供者,如果 SSO 驗證失敗,則預設為 LDAP。

-1 - 僅使用 SSO 提供者而不嘗試 LDAP 認證 (即使 SSO 驗證失敗)。

iim_server.usesso 參數與 iim_server.ssoprovider 參數配合使用。

iim_server.ssoprovider

無 

指定實作 com.sun.im.provider.SSOProvider 介面的類別。如果 iim_server.usesso 不等於 0,且未設定此選項,則伺服器會使用預設的基於 Access Manager 的 SSO 提供者。

iim.policy.modules

當您執行 configure 公用程式時,如果您選擇針對策略使用 Access Manager 部署,則預設值為 identity。否則,預設值為 iim_ldap

如果值為 identity,則表示使用 Sun Java System Access Manager 進行策略儲存。如果值為 iim_ldap,則表示使用目錄進行儲存。

iim.userprops.store

file

如果值為 file,則表示使用者特性會儲存在使用者特性檔案中。如果值為 ldap,則表示使用目錄進行儲存。

iim_server.msg_archive

false

此參數會指定歸檔提供者是否應該啟用或停用。將此值設定為 false 可停用所有歸檔。將此值設定為 true 則可啟用所有歸檔,包括 Portal、電子郵件和您要使用的自訂歸檔提供者。

iim_server.msg_archive.provider

無 

此參數包含歸檔提供者的清單。此參數允許多值,而每個值是以逗號 (,) 分隔。

如果您使用 Portal Server Search 式歸檔,則值應為 com.iplanet.im.server.IMPSArchive。如果您使用電子郵件歸檔,則值應為 com.iplanet.im.server.EmailIMArchive

iim_server.conversion

false

此參數會指定是否應當啟用訊息轉換。它指定「訊息轉換提供者」配置清單是否應該用於訊息轉換。 

iim_server.conversion.provider

無 

此參數包含用於訊息轉換之「訊息轉換提供者」清單。 

此參數允許多值,而每個值是以逗號 (,) 分隔。

iim_server.servertimeout

-1 

伺服器可配置為:在遠端伺服器處於非使用中狀態時自動關閉由遠端伺服器開啟的連線。這個動作可以透過定期計算遠端伺服器最後請求伺服器的時間來執行。如果遠端伺服器最後請求的時間超過 iim_server.servertimeout 參數值,與遠端伺服器的連線將會終止。

參數值以分鐘計算。 

iim_server.enable

true

此值定義是否啟用 Instant Messaging 伺服器。如果此參數設定為 false,則會啟用 Instant Messaging 多重訊號組合器。 

iim_server.conversion.external.command

無 

此參數包含用於訊息轉換的外部指令。 

iim_server.stat_frequency

1

此參數包含伺服器將活動摘要記錄至記錄檔中的頻率。只有在伺服器最低記錄嚴重性設定為 INFO 或更低,伺服器才會將活動的摘要記錄到記錄檔。此值以分鐘為單位。

iim_server.certnickname

Server-Cert

此值應該包含您在安裝憑證時所輸入的憑證名稱。 

此憑證名稱區分大小寫。 

iim_server.sslkeystore

無 

包含伺服器的 Java 金鑰庫 (JKS) 的相對路徑和檔案名稱。例如:


/im-cfg-base/server-keystore.jks

iim_server.keystorepasswordfile

sslpassword.conf

此值應該包含其中含有金鑰資料庫密碼之檔案的相對路徑和名稱。此檔案應該包含下列指令行: 

Internal (Software) Token:password

其中 password 是保護金鑰資料庫的密碼。

iim_server.requiressl

false

如果為 true,則伺服器會終止在設定初始串流階段作業後沒有請求 TLS 連線的任何連線。連線可來自用戶端、其他伺服器和伺服器元件,如 XMPP/HTTP 閘道和代理程式,但多重訊號組合器除外。

iim_server.trust_all_cert

false

如果此值為 true,則伺服器會信任所有憑證,也會將憑證資訊新增到記錄檔。 

多重伺服器配置參數

為了使網路中的多重 Instant Messaging 伺服器之間能夠彼此通訊,您需要將您的伺服器配置為使本身能夠與將會與其連線的其他伺服器、每個協同伺服器或是協作伺服器協調一致。協同伺服器可利用其 Instant Messaging 網域名稱、主機和連接埠號碼、伺服器 ID 以及密碼識別本身的身份。

將會提供每個協作伺服器一個符號名稱,而該名稱是由字母與數字組成的字串,例如 coserver1。 使用您可以指定多重伺服器的符號命名慣例。

當以此方式配置 Instant Messaging 伺服器時,您可以形成較大的 Instant Messaging 社群。因此,每個伺服器上的一般使用者可執行以下作業:

表 A–5 列出並描述多重伺服器配置參數。

表 A–5 多重伺服器配置參數

參數 

預設值 

說明 

iim_server.serverid

無 

此伺服器用來識別本身給所有其他伺服器的字串。 

iim_server.password

無 

此伺服器用來認證其本身給所有其他伺服器的密碼。 

iim_server.coservers

無 

包含可與此伺服器連線的伺服器符號名稱的清單,其中以逗號分隔。允許任何有意義的名稱,但是名稱必須符合您在 *.serverid*.password*.host 參數中所使用的名稱。 範例:

iim_server.coservers=coserver1,coserver2

或 

iim_server.coservers=abc,xyz,ntc

iim_server.coserver1 .serverid

無 

名稱 coserver1 所代表的協作伺服器用來認證此伺服器的識別字串。例如,如果您在 iim_server.coservers 清單中使用 abc,則其 serverid 的相對名稱將會是 iim_server.abc.serverid

iim_server.coserver1 .password

無 

名稱 coserver1 所代表的協作伺服器用來認證此伺服器的密碼。例如,如果您在 iim_server.coservers 清單中使用 abc,則其密碼的相對名稱將會是 iim_server.abc.password

iim_server.coserver1 .host

無 

要連線的 IP 位址與連接埠,可供此伺服器上的一般使用者與名稱 coserver1 所代表的伺服器上的一般使用者通訊。 例如,如果您在 iim_server.coservers 清單中使用 abc,則其主機的相對名稱將會是 iim_server.abc.host

格式為 name: portIPaddress: port

iim_server.coserver1 .requiressl

False

表示當與由 coserver1 識別的伺服器通訊時,此伺服器是否應需要 TLS。可能的值為 TRUEFALSE

多重訊號組合器配置參數

表 A–6 列出並描述多重訊號組合器配置參數。

表 A–6 多重訊號組合器配置參數

參數 

預設值 

說明 

iim_mux.listenport

多重訊號組合器名稱或 IP 位址:5222

IP 位址或 FQDN 與多重訊號組合器偵聽 Instant Messenger 傳入請求的偵聽連接埠。值格式為 IPaddress:port multiplexorname: port。如果未列出 IP 位址或網域名稱,則參數值假設為 localhost 中的 INADDR_ANY

如果您變更此值,應同時變更 im.htmlim.jnlp 檔案,使得它們能夠符合連接埠值。

iim_mux.serverport

45222

多重訊號組合器與之通訊的 Instant Messaging 伺服器和連接埠。值格式為 servername:port IPaddress: port

iim_mux.numinstances

1

多重訊號組合器實例的數量。此參數僅對 Solaris 平台有效。 

iim_mux.maxthreads

5

每個多重訊號組合器實例的最大執行緒數目。 

iim_mux.maxsessions

2000

每個多重訊號組合器程序的最大並行連線數。 

iim_mux.usessl

off

如果該值設定為 on,則在交換任何應用程式資料前,多重訊號組合器需要在每個它接受的連線中進行 SSL 訊號交換。

iim_mux.secconfigdir

/etc/opt/SUNWiim/default/config

此目錄包含金鑰和憑證資料庫。此外,它通常也包含安全性模組資料庫。如果您建立多個 Instant Messaging 實例,則 /default 目錄的名稱會有所不同。

iim_mux.keydbprefix

無 

此值應該包含金鑰資料庫檔名前綴。金鑰資料庫檔名必須以 key3.db 結尾。

如果金鑰資料庫包含前綴,例如,This-Database-key3.db,則此參數的值為 This-Database

iim_mux.certdbprefix

無 

此值應該包含憑證資料庫檔名前綴。憑證資料庫檔名必須以 cert7.db 結尾。

如果憑證資料庫包含前綴,例如,Secret-stuff-cert7.db,則此參數值為 Secret-stuff

iim_mux.secmodfile

secmod.db

此值應該包含安全模組檔案的名稱。 

iim_mux.certnickname

Multiplexor-Cert

此值應該包含您在安裝憑證時所輸入的憑證名稱。 

此憑證名稱區分大小寫。 

iim_mux.keystorepasswordfile

/etc/opt/SUNWiim/default/config/sslpassword.conf

此值應該包含其中含有金鑰資料庫密碼之檔案的相對路徑和名稱。此檔案應該包含下列指令行: 


Internal (Software) Token:password

其中 password 是保護金鑰資料庫的密碼。

如果您建立多個 Instant Messaging 實例,則 /default 目錄的名稱會有所不同。

iim_mux.stat_frequency

600

此值應包含多重訊號組合器將活動摘要記錄至記錄檔中的頻率。最小值為 10 秒。 

iim_mux.enable

true

如果值為 true,則多重訊號組合器將為此實例而執行。如果值為 false,則多重訊號組合器將不會為此實例而執行。

重新導向伺服器參數

表 A–7 列出您用來管理 Instant Messaging 重新導向伺服器的參數。

表 A–7 重新導向伺服器參數

參數 

預設值 

說明 

iim_server.redirect.provider

無 

實作 com.sun.im.provider.Redirector 介面的重新導向提供者名稱或類別清單,以逗號分隔。此參數的任何值都會將伺服器實例定義為重新導向伺服器。支援的值包括 dbroundrobinregex,以及實作 com.sun.im.provider.Redirector 介面的類別名稱。

iim_server.redirect.to

無 

此重新導向伺服器會將用戶端連線重新導往的節點的清單,以逗號分隔。節點名稱可以是任何字母數字式字串。此清單可以是 iim_server.redirect.to.nodename.host 中定義的主機超集合。

iim_server.redirect.to.nodename.host

無 

其中 nodenameiim_server.redirect.to 中的節點名稱。nodename 必須具有此屬性,才能供重新導向伺服器使用。

iim_server.redirect.to.nodename.usessl

False 

如果為 true,則 nodename 被配置為使用舊有 SSL。如需詳細資訊,請參閱在 Instant Messaging 中使用 TLS 與舊有 SSL 的摘要

iim_server.redirect.db.users

im-db-base/redirect.db

重新導向資料庫的名稱和位置。 

iim_server.redirect.db.partitions

im-cfg-base/redirect.partitions

重新導向分割區檔案的名稱和位置。 

iim_server.redirect.db.partitionsize

5000 

分割區中使用者的最大數。 

iim_server.redirect.roundrobin.partitions

im-cfg-base/redirect.partitions

重新導向分割區檔案的名稱和位置。 

iim_server.redirect.pollfrequency

 

重新導向伺服器與在 redirect.hosts 檔案中定義的主機所建立連線之間的問隔。重新導向伺服器會輪詢這些主機,以判定它們是否在線上,以及是否能夠接受用戶端連線。

歸檔參數

表 A–8 列出您用來管理 Instant Messaging 歸檔的參數。

表 A–8 歸檔參數

參數 

預設值 

說明 

iim_arch.title.attr

Title

此參數包含等同於 Portal Server Search 之預設模式中 Title 欄位的欄位名稱。

iim_arch.keyword.attr

Keyword

此參數包含等同於 Portal Server Search 之預設模式中 Keyword 欄位的欄位名稱。

iim_arch.readacl.attr

ReadACL

此參數包含等同於 Portal Server 搜尋之預設模式中 ReadACL 欄位的欄位名稱。

iim_arch.description.attr

說明

此參數包含等同於 Portal Server Search 之預設模式中 Description 欄位的欄位名稱。

iim_arch.fulltext.attr

Full-Text

此參數包含等同於 Portal Server Search 之預設模式中 Full-text 欄位的欄位名稱。

iim_arch.category.attr

Category

此參數包含等同於 Portal Server Search 之預設模式中 Category 欄位的欄位名稱。

iim_arch.readacl.admin

無 

此參數包含管理員 DN。以「;」分隔的多個值。

iim_arch.readacl.adminonly

false

此參數會包含 truefalse

true - 只有參數 iim_arch.readacl.admin 所指定的管理員 DN 會新增至 ReadACL 欄位,而覆寫 ReadACL 欄位的預設運作方式。

false - 參數 iim_arch.readacl.admin 所指定的管理員 DN 會新增至 ReadACL 欄位,以補充預設運作方式。

iim_arch.categories

all

此參數包含可以歸檔的訊息類型清單。 

其值可能是: 

poll

alert

chat

conference

news

指定的多重值可以逗號分隔 (,)。

iim_arch.categoryname

無 

如果沒有指定任何種類的種類名稱,則會使用此參數值作為種類名稱。 

iim_arch.alert.categoryname

無 

此參數包含含有已歸檔之警示訊息的種類名稱。 

不需要指定一個種類給警示訊息。 

iim_arch.poll.categoryname

無 

此參數包含含有已歸檔之輪詢訊息的種類名稱。 

不需要指定一個種類給輪詢訊息。 

iim_arch.conference.categoryname

無 

此參數包含含有已歸檔之會議訊息的種類名稱。 

不需要指定一個種類給會議訊息。 

iim_arch.chat.categoryname

Name 

此參數包含含有已歸檔之聊天訊息的種類名稱。 

不需要指定一個種類給聊天訊息。 

iim_arch.news.categoryname

無 

此參數包含含有已歸檔之新聞訊息的種類名稱。 

不需要指定一個種類給新聞訊息。 

iim_arch.conference.quiettime

5

此參數包含空間 (公開和私用) 中兩個連續訊息之間靜音的最長持續時間,超過此時間後 RD 會過期,並會建立一個新的 RD 來歸檔訊息。此值以分鐘為單位。 

iim_arch.poll.maxwaittime

15

此參數包含輪詢資料在伺服器中緩衝的 (最長) 時間。此值以分鐘為單位。 

iim_arch.ignoreexplicitdeny

true

此參數會包含 truefalse

true - 在「輪詢」和「會議」類型中,將不會歸檔含有明確拒絕存取權限的資料。每次當不對這些訊息進行歸檔時,會將此資訊記錄到 xmppd.log 檔案中。

false - 在「輪詢」和「會議」類型中,將不會歸檔含有明確拒絕存取權限的資料,且會將此訊息新增到 Portal Server Search 資料庫中。

備註:如果您沒有明確拒絕存取空間或新聞通道,則預設存取權限為 READWRITE MANAGE。也可授予某些一般使用者 NONE 存取權限。

iim_arch.portal.search

無 

此參數的值應為 Portal Server Search servlet 的 URL。例如:http://www.example.com/portal/search

如果此參數不存在,則「歸檔提供者」會依照存在於系統上的 AMConfig.properties 檔案,決定 Portal Server Search URL 的值。

iim_arch.portal.admindn

無 

此參數的值應為管理使用者的 DN 。例如:uid=amadmin,ou=People,o=internet

當 Portal Server Server 中文件層級安全性開啟時,則需要此參數。 

iim_arch.portal.adminpassword

無 

此參數的值應該為管理使用者的密碼 (由 iim_arch.portal.admindn 參數指定)。

當 Portal Search Server 中文件層級安全性開啟時,則需要此參數。 

iim_arch.portal.search.database

無 

此參數的值應為 Instant Messaging 伺服器儲存已歸檔訊息之資料庫的名稱。如果未定義此參數,則所有的訊息會儲存在 Portal Server Search 的預設資料庫中。 

iim_arch.admin.email

空字串 

管理員電子郵件地址的清單,以逗號分隔。 

iim_arch.alert.admin.email

無 

所有已歸檔的警示訊息將傳往的管理員電子郵件地址的清單,以逗號分隔。此參數會置換警示訊息的 iim_arch.admin.email

iim_arch.chat.admin.email

無 

所有已歸檔的聊天訊息將傳往的管理員電子郵件地址的清單,以逗號分隔。此參數會置換聊天訊息的 iim_arch.admin.email

iim_arch.conference.admin.email

無 

所有已歸檔的會議訊息將傳往的管理員電子郵件地址的清單,以逗號分隔。此參數會置換會議訊息的 iim_arch.admin.email

iim_arch.poll.admin.email

無 

所有已歸檔的輪詢訊息將傳往的管理員電子郵件地址的清單,以逗號分隔。此參數會置換輪詢訊息的 iim_arch.admin.email

iim_arch.news.admin.email

無 

所有已歸檔的新聞訊息將傳往的管理員電子郵件地址的清單,以逗號分隔。此參數會置換新聞訊息的 iim_arch.admin.email

iim_arch.email.archiveheader.name

無 

進階 RFC 822 標頭的名稱。 

iim_arch.email.archiveheader.value

all

對應於 iim_arch.email.archiveheader.name 標頭名稱的值。

監視程式參數

監視程式會監視伺服器程序,若確定伺服器未在執行,則會嘗試重新啟動伺服器。請參閱管理監視程式程序

表 A–9 列出並描述監視程式配置參數。

表 A–9 監視程式配置參數

參數 

預設值 

說明 

iim_wd.enable

true

啟用監視程式功能。若要重設此參數或停用監視程式,應將此值設為 false

若要避免衝突,如果您正在使用作業系統管理主控台監視 Instant Messaging 伺服器,則應停用該監視程式。 

iim_wd.period

300 (秒)

監視程式會定期輪詢伺服器以檢查伺服器是否正在執行。此參數設定兩個狀態輪詢之間的間隔。 

iim_wd.maxRetries

3

設定關閉或重新啟動伺服器之前監視程式嘗試聯絡 Instant Messaging 伺服器的次數。最大重試次數為十次。 

監視參數

表 A–10 中的參數可配置伺服器如何與 Sun Java Enterprise System Monitoring Framework 互動。

表 A–10 監視參數

參數 

預設值 

說明 

iim_server.monitor.enable

false

供 Sun Java Enterprise System Monitoring Framework 使用。如果為 true,則伺服器配置為允許 mfwk 使用其活動。否則,伺服器不會讓其活動可供使用。

iim_server.monitor.htmlport

無 

如果有指定,則在指定的連接埠上開啟 JMX HTML 配接卡連接埠。依照預設,此連接埠未啟用,因為開啟此連接埠會帶來安全風險。 

代理程式參數

代理程式 (如行事曆代理程式) 使 Instant Messaging 伺服器的功能得以實現,並能增強其與其他 Sun Java System 伺服器互通的功能。

表 A–11 列出並描述代理程式配置參數。

表 A–11 代理程式配置參數

參數 

預設值 

說明 

jms.consumers

無 

與行事曆代理程式一起使用。包含警示的名稱。此參數的值必須設定為: 

cal_reminder

jms.consumer.cal_reminder.destination

無 

與行事曆代理程式一起使用。警示目標。這必須和 ics.conf 檔案中 caldb.serveralarms.url 配置參數的值相同。例如,

enp:///ics/customalarm

jms.consumer.cal_reminder.provider

無 

與行事曆代理程式一起使用。提供者的名稱。一般而言,這會設定為 ens。此參數的值必須與 jms.providers 參數中的名稱相同。

jms.consumer.cal_reminder.type

無 

與行事曆代理程式一起使用。要設定的警示類型。此參數的值必須設定為: 

topic

jms.consumer.cal_reminder.param

無 

與行事曆代理程式一起使用。警示參數。此參數的值必須設定如下 (包括引號): 

"eventtype=calendar.alarm"

jms.consumer.cal_reminder.factory

無 

與行事曆代理程式一起使用。註冊其本身以使用新行事曆提醒訊息的偵聽者。此參數的值必須設定為: 

com.iplanet.im.server.JMSCalendarMessageListener

jms.providers

無 

與行事曆代理程式一起使用。提供者的名稱。一般而言,此參數的值設定為 ens。此值必須與 jms.consumer.cal_reminder.provider 參數的值相同。

jms.provider.ens.broker

無 

與行事曆代理程式一起使用。ENS 的主機名稱和 ENS 偵聽內送請求使用的連接埠號碼。設定為 ics.conf 檔案 service.ens.port 參數中指定的連接埠。預設為 57997。例如:

jms.provider.ens.broker=cal.example.com:57997

jms.provider.ens.factory

無 

與行事曆代理程式一起使用。用於建立主題連線物件的工廠類別。此參數的值必須設定如下:在單行上輸入值: 

com.iplanet.ens.jms.EnsTopicConnFactory

iim_agent.enable

False

如果為 TRUE,會啟用 Instant Messaging 代理程式。將值設定為 FALSE,或將參數從 iim.conf 中移除,可停用所有代理程式。

iim_agent.agent-calendar.enable

無 

與行事曆代理程式一起使用。若為 TRUEiim.conf 中沒有,則會載入專門啟用行事曆代理程式的元件。

agent-calendar.jid

無 

行事曆代理程式的 JID。

agent-calendar.password

無 

定義行事曆代理程式連線至 Instant Messaging 伺服器的密碼。 

iim_server.components

無 

將行事曆代理程式描述為 Instant Messaging 伺服器的元件。此參數的值必須設定為: 

agent-calendar

附錄 B httpbind.conf 中的 Instant Messaging XMPP/HTTP 閘道配置參數

Instant Messaging 將 XMPP/HTTP 閘道的配置設定儲存在 httpbind.conf 檔案中。此附錄的以下章節描述配置參數和檔案:

只要您修改 httpbind.conf 檔案,您必須使用您的 Web 容器或應用程伺服器提供的工具重新啟動 XMPP/HTTP 閘道。

httpbind.conf 檔案位置

根據預設,configure 公用程式會在預設伺服器例項的「配置目錄」(im-cfg-base) 內建立 httpbind.conf 檔案,例如:

如果您已建立多個 Instant Messaging 的實例,/default 目錄的名稱會隨著實例改變。如需詳細資訊,請參閱從單次 Instant Messaging 安裝中建立多個實例configure 公用程式只會在預設實例的 im-cfg-base 目錄中建立此檔案。

httpbind.conf 檔案語法

httpbind.conf 檔案是 ASCII 純文字檔案,其中的每一行定義了閘道參數及其值:


備註 –

httpbind.conf 檔案是由 configure 公用程式初始化,並僅應根據本指南所述修改。


Instant Messaging XMPP/HTTP 閘道配置參數

表 B–1 描述 httpbind.conf 中的配置參數。

表 B–1 httpbind.conf 中的 XMPP/HTTP 閘道配置參數

參數 

預設值 

說明 

httpbind.pool.nodeId

N/A 

如果 httpbind.pool.support 設為 true,此參數為伺服器池中的伺服器節點指定完整的 URL。此 URL 不應指向負載平衡器,而應指向 Instant Messaging 伺服器實例。

httpbind.pool.support

false

此參數定義閘道是否在伺服器池部署中。如果未指定 httpbind.pool.nodeId,則此參數值會設為 false

此參數的值可以是: 

  • true – 閘道是伺服器池部署的一部分。此外,enableon yes1 也是有效值。如果您將此參數設為 true,您必須提供 httpbind.pool.nodeId 的值。

  • false – (預設) 閘道不是伺服器池部署的一部分。將此值保留空白 (空白字串) 也是有效值。

httpbind.config

N/A 

包含閘道可做為配置鍵值的 ID 鍵值清單 (以逗號分隔),或 gwdomain-id,以決定閘道應使用哪一些網域、主機、主機密碼和元件 JID。如需 ID 鍵值的詳細資訊,請參閱表 B–2

httpbind.content_type

text/xml; charset=utf-8

content-type HTTP 標頭的預設值,當閘道將回應傳回用戶端時會使用此預設值。

httpbind.hold

N/A 

根據 JEP 124 中的定義,指定用戶端請求中 hold 屬性的最大允許值。 如果用戶端指定的值高於請求中的閘道,將使用閘道值。否則,將使用用戶端請求中的值。

httpbind.inactivity

180

用戶端非使用中的最長時間 (以秒為單位),閘道在這段時間之後會終止用戶端連線。 

httpbind.log4j.config

N/A 

閘道將用於記錄的 log4j 配置檔的位置。如果您將此值保留為空白,則會關閉閘道的記錄。記錄程式的名稱為「httpbind」(log4j.logger.httpbind)。

httpbind.polling

1 (秒)

用戶端在傳送另一個請求前必須等待的最小時間 (以秒為單位)。 

httpbind.requests

2

用戶端可向閘道同步運作請求的數目。如果此參數的值小於用戶端請求中 JEP 124 hold 屬性的值,此參數值將設為 hold+1。不要將此值設定為 1,因為如此會使效能嚴重降低。如需詳細資訊,請參? httpbind.hold

httpbind.round_trip_delay

1 (秒)

往返的逾時之外所允許視為網路延遲的額外時間長度 (以秒為單位)。此值設定過高會使效能降低。 

httpbind.wait_time

120 (秒)

預設的時間秒數,閘道會在這段時間內將回應傳送到用戶端。如果用戶端等待時間設定的值高於閘道等待時間,則使用閘道的等待時間。 

httpbind.config 的閘道網域 ID 鍵值參數

表 B–2 描述用於定義 httpbind.config 參數中每個 ID 的鍵值。表 gwdomain-id 中所述的每個鍵值為 httpbind.config 中指定的網域識別碼。

表 B–2 httpbind.config ID 鍵值

鍵值 

說明 

gwdomain-id.domains

此 ID 的網域清單,以逗號分隔。 

gwdomain-id.hosts

此 ID 的主機清單,以空格分隔。每個主機均必須能夠服務 gwdomain-id .domains 中所列的網域。此清單協助在網域之間提供容錯移轉。如果請求中未提及明確的路由主機,則此鍵值中所列的其中一個主機將用於服務該請求。

gwdomain-id.componentjid

用於連線主機的元件 JID。 

gwdomain-id.password

用於連線主機的密碼。 

附錄 C Instant Messaging imadmin 工具參考

本章在以下幾節說明用於管理 Instant Messaging 的 imadmin 指令:

imadmin 簡介

您可以使用 imadmin 公用程式來啟動、停止與更新 Instant Messaging 伺服器和多重訊號組合器。以超級使用者 root 或在配置期間指定的一般使用者身份執行 imadmin

imadmin 需求

您必須從安裝 Instant Messaging 伺服器的主機中呼叫 imadmin 公用程式。

imadmin 位置

依照預設,imadmin 會安裝於下列位置:

im-svr-base/sbin

imadmin 指令

表 C–1 列出並描述與 imadmin 指令相關的指令。

表 C–1 imadmin 指令和說明

指令 

說明 

imadmin assign_services

如果 iim.policy.modules 設定為 identity,則此指令會將 Instant Messaging 和身份認證服務指派給您所指定基底 DN 下的現有使用者。DN 應為儲存使用者項目之組織的基底 DN。

如果 iim.policy.modules 設定為 iim_ldap,且 iim.userprops.store 設定為 ldap,則此指令會將物件類別 (sunIMUsersunPresenceUser) 新增至目錄中的使用者項目。Instant Messaging 需要這些物件類別,以便在 LDAP 中儲存特性。

imadmin status

(以前為 imadmin check)

檢查元件 (servermultiplexoragent-calendarwatchdog) 是否在正常執行並顯示結果。如果您未指定元件,imadmin 公用程式會傳回所有元件的相關資訊。

imadmin start

啟動已啟用的元件。 

imadmin stop

停止已啟用的元件。 

imadmin refresh

更新已啟用的元件。 

imadmin start server

只啟動伺服器。 

imadmin stop server

只停止伺服器。 

imadmin refresh server

只更新伺服器。 

imadmin start multiplexor

只啟動多重訊號組合器。 

imadmin stop multiplexor

只停止多重訊號組合器。 

imadmin refresh multiplexor

只更新多重訊號組合器。 

imadmin start agent-calendar

僅啟動行事曆代理程式。 

imadmin stop agent-calendar

只停止行事曆代理程式。 

imadmin refresh agent-calendar

只更新行事曆代理程式。 

imadmin start watchdog

只啟動監視程式。 

imadmin stop watchdog

只停止監視程式。 

imadmin refresh watchdog

只更新監視程式。 

imadmin version

顯示版本。 

imadmin 語法

imadmin [選項] [動作] [元件]

imadmin 選項

表 C–2 列出並描述 imadmin 指令的選項。

表 C–2 imadmin 指令的選項

選項 

說明 

-c alt-config-file

startrefresh 動作搭配使用,用以指定 /etc/opt/SUNWiim/config/iim.conf 檔案以外的不同配置檔案。

-h

顯示有關 imadmin 指令的。

imadmin 動作

表 C–3 列出並描述發出各種 imadmin 指令後執行的動作。

表 C–3 imadmin 指令的動作

選項 

說明 

status

(以前為 imadmin check)

傳回關於 Instant Messaging 元件 (server multiplexoragent-calendarwatchdog) 的資訊。執行此動作無需提供 [component]

start

設定 classpath,Java 堆疊大小並啟動所有指定的元件。

stop

停止所有指定元件的常駐程式。 

refresh

停止並啟動指定的元件。用於配置變更之後。 

imadmin 元件

表 C–4 列出並描述 imadmin 指令的元件。

表 C–4 imadmin 指令的元件

選項 

說明 

agent-calendar

表示行事曆代理程式 (agent-calendar)。

multiplexor

僅表示多重訊號組合器。 

server

表示 Instant Messaging 伺服器。 

watchdog

表示監視程式。 

附錄 D Instant Messaging API

本章在以下章節中說明 Instant Messaging 使用的 API:

Instant Messaging API 簡介

Instant Messaging 所提供的 Java API 可以用來開發延伸或整合模組。安裝的 Instant Messenger 元件均有提供這些 API 的詳細文件,檔案形式為 Javadocs 產生的 HTML 檔案。Javadoc 檔案安裝於 im-svr-base/html/apidocs/ 目錄。若要檢視 API 文件,將瀏覽器指向 codebase/apidocs,其中 codebase 為 Instant Messenger 資源代碼庫。

以下為 Instant Messaging API:

Instant Messaging 服務 API

位於相同主機或遠端主機中的應用程式會使用 Instant Messaging API 來存取 Instant Messaging 服務,例如「線上狀態」、「會議」、「通知」、「輪詢」和「新聞」通道。

Instant Messaging 服務 API 可用於:

Messenger Bean

Messenger Bean 是一種動態載入模組,用於延伸 Instant Messenger 功能。Messenger Bean 會新增動作偵聽程式 (例如按鈕、功能表項目) 和項目偵聽程式 (例如現有 Instant Messenger 視窗中的核取方塊和切換按鈕)。當收到一般使用者輸入,且 Bean 特定的動作是根據一般使用者的輸入,則會呼叫項目偵聽程式。Bean 能夠新增自己的設定面板,並將 Bean 特定特性儲存在伺服器上。Instant Messenger 收到任何事件 (例如新警示訊息),Bean 都會得到通知。

使用 Messenger Bean 的應用程式包括以下功能:

服務提供者介面

服務提供者介面 API 提供了延伸 Instant Messaging 伺服器功能的能力。服務提供者介面包含以下獨立 API:

歸檔提供者 API

「歸檔提供者」是一個軟體模組,通常提供與歸檔或稽核系統的整合。每個配置的「歸檔提供者」會在每個伺服器程序中啟動。

「歸檔提供者」會在下列的伺服器程序中呼叫:

使用歸檔提供者 API 的應用程式如下:

訊息轉換 API

可以在每個訊息或每個經歷伺服器的訊息部份中呼叫「訊息轉換程式」。「訊息轉換程式」可能會將訊息部份保留不變,或修改或移除訊息部份。文字部分會視為 Java 字串物件予以處理。「訊息轉換程式」會將其他附件以位元組流的形式處理,並傳回潛在不同的位元組流。如果附件已刪除的話,則不傳回任何資料。

使用 Message Conversion API 的應用程式包括以下功能:

認證提供者 API

認證提供者 API 能夠在不使用 Access Manager 密碼式或記號式認證服務的環境中部署 Instant Messaging。只要一般使用者請求認證,便會呼叫此 API,此 API 可與 LDAP 認證結合使用

使用認證提供者 API 執行透過 Access Manager 進行的單次登入(SSO)。此 API 也可用於與其他認證系統整合。

附錄 E Instant Messaging LDAP 模式

此附錄說明對 Instant Messaging 的 LDAP 模式所做的修改。

Instant Messaging Objectclasses

下表列出為 Instant Messaging 新增至模式和該目錄中之項目的 LDAP objectclasses。

表 E–1 Instant Messaging Objectclasses

名稱 

說明 

sunIMUser

包含使用者特性。 

當您執行 imadmin assign_services 指令時,新增至所指定基底 DN 下的使用者項目。

sunPresenceUser

包含使用者線上狀態特性。 

當您執行 imadmin assign_services 指令時,新增至所指定基底 DN 下的使用者項目。

sunIMNews

包含新聞通道特性。 

如果 userprops.store 設為 ldap,當建立新的新聞通道時,會將新聞通道的項目新增至目錄。新聞通道項目將包含 sunIMNews objectclass。

sunIMConference

包含會議室特性。 

如果 userprops.store 設為 ldap,當建立新的會議室時,會將會議室的項目新增至目錄。會議室項目將包含 sunIMConference objectclass。