Sun Java System Communications Services 2005Q4 版本說明

文件更新

本小節包含了以下小節文件中的變更與錯誤資訊:

文件集

Instant Messaging 的 2005Q4 發行版本使用以下版本的管理指南:

Sun Java System Instant Messaging 7 2005Q1 管理指南

管理指南

本小節列出了對「Sun Java System Instant Messaging 7 2005Q1 管理指南」進行的以下變更。

在 HA 環境中啟動、停止與更新元件

請勿在執行 Sun Cluster 的 HA 環境中使用 imadmin startimadmin stopimadmin refresh 指令,而改為使用 Sun Cluster 管理公用程式。

用於部署 Access Manager 的其他安裝後步驟

(問題編號:6189148) 如果您將 Access Manager 安裝在 Instant Messaging 伺服器的其他主機上,則需要在執行 configure 公用程式後將 imServices_* 檔案從 Instant Messaging 伺服器主機手動複製至 Access Manager 主機。

若要執行該作業,請:

  1. 在 Instant Messaging 伺服器主機上找到 imService_*.properties 檔案。依預設,這些檔案在 Solaris 上位於 /opt/SUNWiim/lib/ 中;在 Linux 上位於 /opt/sun/im/lib/ 中。

  2. 將所有檔案複製至 Access Manager 主機上的 locale 目錄。依預設,此目錄在 Solaris 上位於 /opt/SUNWam/locale 中;在 Linux 上位於 /opt/sun/identity/locale 中。

iim_agent.enable 參數變更為預設值。

(問題編號:5102072) 在此發行版本中, iim_agent.enable 參數的預設值已變更為 false。在管理指南中不反映此變更。

配置 Instant Messenger 的行事曆快顯提示

「配置 Instant Messaging 伺服器」程序的步驟 1 是錯誤的。不存在名為 SUNWiimag 的套裝軟體。跳過此步驟。

iim.conf 中移除的參數

將不再支援 iim_server.msg_archive.auto 配置參數,儘管它已錯誤地包含於管理指南的參數清單中。

啟用用於 Java Plug-in 的 Instant Messenger 歸檔控制元件

(問題編號:6244099) 啟用用於 Java Plug-in 的 Instant Messenger 歸檔控制元件的管理指南程序是錯誤的。請使用HTML applet 頁面與 pluginLaunch.jsp 檔案的變更中說明的程序。

HTML applet 頁面與 pluginLaunch.jsp 檔案的變更

如果您要使用 Java Plug-in 啟動 Instant Messenger,請執行以下步驟,以啟用 Instant Messenger 中的 Instant Messenger 歸檔控制功能。

Procedure啟用用於 Java Plug-in 的 Instant Messenger 歸檔控制功能

步驟
  1. 請至 Instant Messenger 文件根目錄並找到 im.htmlimssl.html 檔案

    依預設,這些檔案均安裝在以下位置:

    /etc/opt/SUNWps/desktop/default/IMProvider

  2. 在文字編輯器中開啟 .html 檔案。

  3. 根據需要增加或編輯以下行:


    <PARAM NAME="archive_control" VALUE="true" />
    <EMBED archive_control=true;/>

在非預設 Portal Server 搜尋資料庫中儲存歸檔的郵件

在程序中出現錯誤。尤其是,以下目錄:

/etc/opt/SUNWps/desktop/default/IMProvider/

應為:

/etc/opt/SUNWps/desktop/default_locale/IMProvider/

例如

/etc/opt/SUNWps/desktop/default_ja/IMProvider/

配置伺服器以允許新使用者登錄

管理指南中未完整說明新使用者登錄功能。除了自訂 Instant Messenger 以外,還需要配置伺服器,以允許新使用者登錄。

若要執行該作業,需要在 iim.conf 中增加四個配置參數,然後更新伺服器配置。表 3–4 說明這些配置參數。

表 3–4 新使用者登錄伺服器配置參數

參數 

說明 

iim.register.enable

如果為 TRUE,則伺服器將允許新 Instant Messaging 一般使用者使用 Instant Messenger 自我登錄 (自行將其增加至目錄)。

iim_ldap.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

Procedure配置伺服器以允許新使用者登錄

步驟
  1. 在文字編輯器中開啟 iim.conf

  2. 增加 表 3–4 中說明的配置參數與相應的值。

  3. 儲存並關閉 iim.conf

  4. 使用 imadmin 指令行公用程式更新伺服器配置。

    imadmin refresh server


    注意 – 注意 –

    請勿在使用 Sun Cluster 的 HA 環境中使用 imadmin startimadmin stopimadmin refresh,而改為使用 Sun Cluster 管理公用程式。


用於 XMPP 通訊的附加記錄參數

(問題編號:5070998) 在此發行版本中已增加了一個記錄的附加記錄參數,以在獨立的記錄檔中收集 XMPP 郵件。

Procedure配置伺服器以建立 XMPP 郵件記錄

步驟
  1. 開啟 iim.conf

    依預設, iim.conf 檔案安裝於以下配置目錄中:

    • 在 Solaris 上:

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

    • 在 Linux 上:

      /etc/opt/sun/im/default/config/iim.conf

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

  2. 透過移除註釋字元啟用以下行:


    iim.log4j.config=log4j.conf

    如果該行不存在,則增加該行。

  3. 儲存並關閉 iim.conf

  4. 建立名為 log4j.conf 的檔案,並將其儲存至配置目錄。

  5. log4j.conf 中增加:


    log4j.logger.xmppd=INFO, A1
    
    # DEFAULT TO RollingFileAppender
    log4j.appender.A1=org.apache.log4j.RollingFileAppender
    log4j.appender.A1.file=${logdir}/xmppd.log
    log4j.appender.A1.append=true
    log4j.appender.A1.maxBackupIndex=7
    log4j.appender.A1.maxFileSize=5mb
    # More example appenders..
    # Straight to console..
    # log4j.appender.A1=org.apache.log4j.ConsoleAppender
    # log4j.appender.A1.ImmediateFlush=true
    # Rollover at midnight..
    # log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
    # log4j.appender.A1.DatePattern='.'yyyy-MM-dd
    # log4j.appender.A1.file=${logdir}/xmppd.log
    # log4j.appender.A1.ImmediateFlush=true
    # log4j.appender.A1.append=true
    # Send to SMTP..
    # log4j.appender.A1=org.apache.log4j.SMTPAppender
    
    # PATTERN LAYOUT AND OPTIONS
    
    # DEFAULT TO PatternLayout
    log4j.appender.A1.layout=org.apache.log4j.PatternLayout
    # For full dates..
    log4j.appender.A1.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n
    # IM traditional output format..
    #log4j.appender.A1.layout.ConversionPattern=%d{HH:mm:ss,SSS} %-5p %c [%t] %m%n
    # More example layouts
    # XMLLayout for chainsaw consumption
    # log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout
    # TTCCLayout for NDC information
    # log4j.appender.A1.layout=org.apache.log4j.xml.TTCCLayout
    # log4j.appender.A1.layout.DateFormat=ISO8601
    # log4j.appender.A1.layout.TimeZoneID=GMT-8:00
    # log4j.appender.A1.layout.CategoryPrefixing=false
    # log4j.appender.A1.layout.ThreadPrinting=false
    # log4j.appender.A1.layout.ContextPrinting=false
    
    # Now we list logger/appender/layout for the other default loggers, but
    # only the defaults..
    log4j.logger.iim_wd=ERROR, A2
    log4j.appender.A2=org.apache.log4j.RollingFileAppender
    log4j.appender.A2.file=${logdir}/iim_wd.log
    log4j.appender.A2.append=true
    log4j.appender.A2.maxBackupIndex=7
    log4j.appender.A2.maxFileSize=5mb
    log4j.appender.A2.layout=org.apache.log4j.PatternLayout
    log4j.appender.A2.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n
    
    # For separate xmpp traffic log, disabled by default.
    log4j.logger.xmppd.xfer=DEBUG, A3
    #log4j.appender.A3=org.apache.log4j.varia.NullAppender
    # Select next block instead of previous line to enable separate transfer log
    log4j.appender.A3=org.apache.log4j.RollingFileAppender
    # log4j.appender.A3.file=${logdir}/xfer.log
    # log4j.appender.A3.append=true
    # log4j.appender.A3.maxBackupIndex=7
    # log4j.appender.A3.maxFileSize=5mb
    # log4j.appender.A3.layout=org.apache.log4j.PatternLayout
    # # Note, simpler default output than above 3 loggers:
    # log4j.appender.A3.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n
    
    log4j.logger.agent-calendar=ERROR, A4
    log4j.appender.A4=org.apache.log4j.RollingFileAppender
    log4j.appender.A4.file=${logdir}/agent-calendar.log
    log4j.appender.A4.append=true
    log4j.appender.A4.maxBackupIndex=7
    log4j.appender.A4.maxFileSize=5mb
    log4j.appender.A4.layout=org.apache.log4j.PatternLayout
    log4j.appender.A4.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n
    
    log4j.logger.net.outer_planes.jso.BasicStream=OFF, A5
    log4j.appender.A5=org.apache.log4j.RollingFileAppender
    log4j.appender.A5.file=${logdir}/jso.log
    log4j.appender.A5.append=true
    log4j.appender.A5.maxBackupIndex=7
    log4j.appender.A5.maxFileSize=5mb
    log4j.appender.A5.layout=org.apache.log4j.PatternLayout
    log4j.appender.A5.layout.ConversionPattern=[%d{DATE}] %-5p %c [%t] %m%n
  6. 儲存並關閉 log4j.conf

  7. 更新伺服器:


    imadmin refresh server
    

    注意 – 注意 –

    請勿在使用 Sun Cluster 的 HA 環境中使用 imadmin startimadmin stopimadmin refresh,而改為使用 Sun Cluster 管理公用程式。


Procedure停用獨立的 XMPP 記錄檔建立

停用獨立的記錄檔建立不會阻止向伺服器記錄中寫入 XMPP 郵件。

步驟
  1. 開啟 log4j.conf

  2. 註釋以下行:


    log4j.logger.xmppd.xfer=DEBUG, A3

Instant Messaging 高可用性

此功能的文件位於配置 Instant Messaging 高可用性 (僅 Solaris)中。

線上說明

產品線上說明或快速參照中均未對以下資訊進行說明。

啟動螢幕

啟動螢幕可啟動 Instant Messenger 。如果您使用 Java Web Start,請按住螢幕中間的 [啟動] 按鈕。如果您使用 Java Plug-in (僅適用於 Windows 使用者),請按一下螢幕頂部的 [Java Plug-in] 按鈕。[線上說明] 和 [快速參照] 按鈕顯示一般使用者產品說明。