本章在以下幾節說明 iim.conf 檔案中的 Instant Messaging 配置參數:
Instant Messaging 將配置設定儲存在配置目錄 (im-cfg-base) 的 iim.conf 檔案中。
Solaris:
/etc/opt/SUNWiim/default/config/iim.conf
Linux:
/etc/opt/sun/im/default/config/iim.conf
如果您已建立多個 Instant Messaging 實例,則 /default 目錄的名稱會根據實例而有所不同。如需詳細資訊,請參閱從單次 Instant Messaging 安裝中建立多個實例。
此檔案是 ASCII 純文字檔案,其中每一行均定義一個伺服器參數及其值:
參數及其值是由等號 (=) 分隔,等號之前或之後可以包含空格與定位字元。
數值可以用雙引號 (" ") 括起。如果參數允許多值,則必須將整個值字串用雙引號括起。
註釋行必須要以驚嘆號 (!) 作為一行的第一個字元。註釋行是作為提供資訊之用,而且會被伺服器所忽略。
如果參數出現不只一次,則列出的最後參數值將會覆蓋先前的值。
反斜線 (\) 是用於接續後面內容,並指出值的內容超過一行。
每行會終止於行終止符號 (\n、\r 或 \r\n)。
鍵由行中第一個非空格字元開始到第一個 ASCII 等號 (=) 或分號 (;) 為止的所有字元組成。 如果該鍵以分號結束,則鍵之後會接著「lang-」和指定解譯此值所使用語言的標記。語言標籤後面會接著等號 (=)。所有等號之前或之後的空白字元將會被忽略。行中所有剩餘的字元將會變為相關值字串的一部份。
值字串中的多重值以逗號 (,) 分隔。
如果值內有任何特殊字元,如逗號、空格、換行、定位字元、雙引號或反斜線,那麼整個值必須前後加上雙引號。此外,每個值中的換行鍵、返回字元、定位字元、反斜線和雙引號必須以反斜線 (\) 指定。
如果您變更了 iim.conf 檔案,則必須更新 Instant Messaging 伺服器才能使新的配置設定生效。
iim.conf 檔案會由安裝程序初始化,而且只能夠依照本手冊所述的方法加以修改。
表 A–1 列出並描述一般配置參數。
表 A–1 一般配置參數
參數 |
預設值 |
說明 |
---|---|---|
iim.comm.modules |
iim_server、iim_mux |
使用通訊模組。可能的值為 iim_server 與 iim_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 服務的服務定義時才有意義。 |
表 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 |
|
包含一般使用者佈建的電子郵件地址的 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 |
伺服器模組所需的記錄層級。可能值從最高級別到最低級別依次為:FATAL、ERROR、WARNING、INFO 和 DEBUG。如果選擇了較低的記錄層級,表示您也會取得較高的層級。例如,如果您選擇了 WARNING,則也會得到 FATAL、ERROR 和 WARNING。 |
iim.log.iim_server.url |
im-runtime-base/log/xmppd.log |
伺服器記錄檔案的位置。必須定期刪除此檔案的內容,以免佔滿磁碟空間。 |
iim.log.iim_mux.severity |
INFO |
多重訊號組合器模組所需的記錄層級。可能值從最高級別到最低級別依次為:FATAL、ERROR、WARNING、INFO 和 DEBUG。如果選擇了較低的記錄層級,表示您也會取得較高的層級。例如,如果您選擇了 WARNING,則也會得到 FATAL、ERROR 和 WARNING。 |
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 |
監視程式所需的記錄層級。可能值從最高級別到最低級別依次為:FATAL、ERROR、WARNING、INFO 和 DEBUG。如果選擇了較低的記錄層級,表示您也會取得較高的層級。例如,如果您選擇了 WARNING,則也會得到 FATAL、ERROR 和 WARNING。 |
iim.log.agent-calendar.severity |
INFO |
行事曆代理程式所需的記錄層級。可能值從最高級別到最低級別依次為:FATAL、ERROR、 WARNING、INFO 和 DEBUG。如果選擇了較低的記錄層級,表示您也會取得較高的層級。例如,如果您選擇了 WARNING,則也會得到 FATAL、ERROR 和 WARNING。 |
iim.log4j.config |
im-cfg-base |
指定 log4j 配置檔案的位置和名稱。如果此參數沒有值,則記錄程式將在 im-cfg-base 中尋找 log4j.conf 。 如果記錄程式在 im-cfg-base 中找不到 log4j.conf,則會使用參數式的記錄方法來替代 log4j。 |
表 A–4 列出並描述 Instant Messaging 伺服器配置參數。
表 A–4 一般 Instant Messaging 伺服器配置參數
參數 |
預設值 |
說明 |
|
---|---|---|---|
iim_server.autosubscribe |
FALSE |
表示伺服器是否自動授權訂閱。可能的值為 TRUE 和 FALSE。若為 TRUE,訂閱請求後面會自動跟有伺服器產生的訂閱回應。然後伺服器將已修改的值勤人傳送至訂閱者和訂閱者新增為連絡人的使用者。若要使用此功能,使用者與連絡人必須位於相同的網域。 |
|
iim_server.domainname |
主機的網域名稱 |
您希望此伺服器支援的邏輯 Instant Messaging 伺服器網域名稱。此為網路中其他伺服器用以識別此伺服器的名稱。它同時也是此伺服器用來讓其他伺服器識別其一般使用者時所使用的名稱。此名稱不一定是執行 Instant Messaging 伺服器之系統的完全合格網域名稱。 例如,如果系統 iim.xyz.com 是 xyz.com 公司唯一的 Instant Messaging 伺服器,則網域名稱有可能會是 xyz.com。 |
|
iim_server.port |
5269 |
伺服器所連結的 IP 位址和連接埠,伺服器也從此偵聽來自其他伺服務的連線。對於多址主機而言,如果您只需要使用一個特定的 IP 位址,則 IP 位址設定非常有用。如果未列出 IP 位址,它將表示 localhost 上的 INADDR_ANY 值。 |
|
iim_server.useport |
TRUE |
表示伺服器是否在伺服器對伺服器通訊埠上偵聽。可能的值為 TRUE 和 FALSE。如果為 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。 此參數的值可以是 0、1 或 -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) 的相對路徑和檔案名稱。例如:
|
|
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: port 或 IPaddress: port。 |
iim_server.coserver1 .requiressl |
False |
表示當與由 coserver1 識別的伺服器通訊時,此伺服器是否應需要 TLS。可能的值為 TRUE 和 FALSE。 |
表 A–6 列出並描述多重訊號組合器配置參數。
表 A–6 多重訊號組合器配置參數
參數 |
預設值 |
說明 |
|
---|---|---|---|
iim_mux.listenport |
多重訊號組合器名稱或 IP 位址:5222 |
IP 位址或 FQDN 與多重訊號組合器偵聽 Instant Messenger 傳入請求的偵聽連接埠。值格式為 IPaddress:port 或 multiplexorname: port。如果未列出 IP 位址或網域名稱,則參數值假設為 localhost 中的 INADDR_ANY。 如果您變更此值,應同時變更 im.html 和 im.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 |
此值應該包含其中含有金鑰資料庫密碼之檔案的相對路徑和名稱。此檔案應該包含下列指令行:
其中 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 介面的重新導向提供者名稱或類別清單,以逗號分隔。此參數的任何值都會將伺服器實例定義為重新導向伺服器。支援的值包括 db、roundrobin、regex,以及實作 com.sun.im.provider.Redirector 介面的類別名稱。 |
iim_server.redirect.to |
無 |
此重新導向伺服器會將用戶端連線重新導往的節點的清單,以逗號分隔。節點名稱可以是任何字母數字式字串。此清單可以是 iim_server.redirect.to.nodename.host 中定義的主機超集合。 |
iim_server.redirect.to.nodename.host |
無 |
其中 nodename 是 iim_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 |
此參數會包含 true 或 false。 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 |
此參數會包含 true 或 false。 true - 在「輪詢」和「會議」類型中,將不會歸檔含有明確拒絕存取權限的資料。每次當不對這些訊息進行歸檔時,會將此資訊記錄到 xmppd.log 檔案中。 false - 在「輪詢」和「會議」類型中,將不會歸檔含有明確拒絕存取權限的資料,且會將此訊息新增到 Portal Server Search 資料庫中。 備註:如果您沒有明確拒絕存取空間或新聞通道,則預設存取權限為 READ、WRITE 或 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 |
無 |
與行事曆代理程式一起使用。若為 TRUE 或 iim.conf 中沒有,則會載入專門啟用行事曆代理程式的元件。 |
agent-calendar.jid |
無 |
行事曆代理程式的 JID。 |
agent-calendar.password |
無 |
定義行事曆代理程式連線至 Instant Messaging 伺服器的密碼。 |
iim_server.components |
無 |
將行事曆代理程式描述為 Instant Messaging 伺服器的元件。此參數的值必須設定為: agent-calendar |