Sun Java System Instant Messaging 7.2 管理指南

第 1 部分 安裝後配置

第 1 章 安裝後配置 Instant Messaging

安裝後,在使用 Sun JavaTM System Instant Messaging 前,您需要完成一些配置步驟。本章於下列章節中描述這些配置步驟:

在您配置 Instant Messaging 前,應閱讀並瞭解 「Sun Java Communications Suite 5 Deployment Planning Guide」 中的資訊,執行如 「Sun Java Communications Suite 5 Installation Guide」 中所述的安裝,完成配置檢核清單,最後配置軟體。此外,如果您正在使用 Sun Cluster 配置 Instant Messaging 以獲得高可用性,在完成本章的步驟前,您需要閱讀第 4 章, 配置 Instant Messaging 的高可用性 (僅 Solaris)

完成配置檢核清單

您應在開始前收集此資訊。視您安裝的元件而定,會提示您輸入某些或所有資訊。

列印下列表格並在提供的空格中寫入部署的值。您可以在多次 Instant Messaging 安裝中重複使用此檢核清單。此表格中包含密碼與其他敏感資訊,所以您應將此資訊儲存在安全之處。

(僅限於 Solaris) 如果您要為 Instant Messaging 配置高可用性服務,請參閱Instant Messaging HA 簡介以取得您可用於檢核清單中這些參數與附加參數之值的特定資訊。

表 1–1 Instant Messaging 的配置參數

參數 

說明 

您的值 

安裝目錄

im-svr-base

安裝 Instant Messaging 的目錄 

依預設,Instant Messaging 安裝於如下的 /opt 目錄中:

Solaris:/opt/SUNWiim

Linux:/opt/sun/im

(僅限於 Solaris) 如果您要為 Instant Messaging 配置高可用性服務,請參閱選取安裝目錄 (im-svr-base) 以取得有關選擇安裝目錄的資訊。

 

Instant Messaging 伺服器主機與網域名稱

安裝 Instant Messaging 的主機名稱和與該主機相關的網域名稱。 例如: 

主機名稱:instantmessaging.siroe.com

網域名稱:siroe.com

(僅限於 Solaris) 如果您要為 Instant Messaging 配置高可用性服務,請使用邏輯主機名稱。 

 

Instant Messaging 伺服器連接埠號碼

Instant Messaging 伺服器偵聽多重訊號組合器傳入請求的連接埠號碼。 

預設值:45222 

 

Instant Messaging 伺服器至伺服器連接埠號碼

Instant Messaging 伺服器偵聽其他 Instant Messaging 伺服器傳入請求的連接埠號碼。此外,若未安裝多重訊號組合器,伺服器會在此連接埠上偵聽 Instant Messenger 用戶端的傳入請求。 

預設值:5269 

 

多重訊號組合器連接埠號碼 

(僅限於多重訊號組合器配置)

Instant Messaging 伺服器偵聽 Instant Messenger 用戶端傳入請求的連接埠號碼。 

預設值:5222 

 

停用伺服器

如果您安裝的實例將作為多重訊號組合器而非伺服器,請選取此選項。如果您選取此選項,則必須提供遠端 Instant Messaging 伺服器主機名稱的值。 

 

遠端 Instant Messaging 伺服器主機名稱

(僅限多重訊號組合器配置) 

此多重訊號組合器為其路由訊息的 Instant Messaging 伺服器主機名稱。若多重訊號組合器與伺服器安裝在相同的主機上,請使用 localhost。(僅限於 Solaris) 如果您要為 Instant Messaging 配置高可用性服務,請使用邏輯主機名稱。

相依性:必須選取 [停用伺服器] 參數,也就是停用伺服器功能。 

 

Sun Java System Access Manager 配置 

如果 configure 公用程式偵測到您已安裝 Access Manager SDK,則會提示您提供與 Access Manager 相關之下列問題的答案:

  • [您計劃將 Access Manager 部署用於實現 SSO 嗎?]

    如果您輸入 yes,configure 會將 iim.conf 中的 iim_server.usesso 參數設定為 1。如需此參數的詳細資訊,請參閱表 A–4

  • [您計劃將 Access Manager 部署用於策略嗎?]

    如果您選擇 yes,則當您完成執行 configure 公用程式時,需要執行 imadmin assign_services 指令。如需 imadmin assign_services 指令的詳細說明,請參閱安裝後配置 Instant Messaging為一般使用者指定 Instant Messaging 與線上狀態服務

    如果您選擇 no,則會提示您是否要將使用者、會議室與新聞通道特性儲存於檔案或 LDAP 中。

  • 此外,如果 Instant Messaging 將在 Sun Java System Application Server 部署中使用 Access Manager 策略,則當您完成配置 Instant Messaging 時,需要重新啟動 Application Server。如果您不重新啟動 Application Server,Instant Messaging 服務就不會顯示於 Access Manager 主控台 (amconsole ) 中。

 

Sun Java System Calendar Server 與行事曆代理程式配置 

configure 公用程式會詢問您是否想要啟用行事曆代理程式。如果您選擇啟用行事曆代理程式,則需要提供下列資訊:

  • 通知伺服器主機名稱。

  • 通知伺服器連接埠號碼。

  • 行事曆警示 URL。

如果您選擇不啟用行事曆代理程式,則稍後還可手動配置行事曆代理程式。如需行事曆代理程式配置參數與可接受值的詳細資訊,請參閱第 16 章, 使用行事曆快顯提醒

 

啟用 Instant Messaging 歸檔 

(可選擇) 

如果已選擇,則會為 Instant Messaging 啟用 Sun Java System Portal Server 基於搜尋的歸檔。 

相依性:Sun Java System Portal Server 與 Sun Java System Access Manager。 

 

LDAP 主機名稱

在使用 LDAP 伺服器的部署中,包含 Instant Messaging 使用者與群組資訊的 LDAP 伺服器的主機名稱。例如,directory.siroe.com

相依性:LDAP 伺服器,例如 Sun Java System Directory Server。

 

LDAP 連接埠號碼

在使用 LDAP 伺服器的部署中,目錄伺服器偵聽傳入請求的連接埠號碼。例如,389

相依性:LDAP 伺服器,例如 Sun Java System Directory Server。

 

基底 DN 

在使用 LDAP 伺服器的部署中,目錄樹狀結構中包含 Instant Messaging 使用者與群組資訊的基底辨別名稱。例如,o=airius.com

相依性:LDAP 伺服器,例如 Sun Java System Directory Server。

 

連結 DN 

在使用 Sun Java System Access Manager 的部署中,您必須在安裝期間提供目錄管理員連結 DN 與密碼。此連結 DN 僅用於更新 Instant Messaging 目錄模式、線上狀態服務範本與屬性。這需要有目錄管理員存取權。除了安裝與初始配置外,不會儲存或使用目錄管理員連結 DN 與密碼。 

在使用 LDAP 伺服器但沒有 Access Manager 的部署中,Instant Messaging 會使用此連結 DN 來搜尋目錄中的使用者與群組。如果可以匿名搜尋目錄,請將此項保留空白。如有必要,您可依照配置 Instant Messaging 伺服器的連結憑證所述,稍後變更連結憑證。

相依性:LDAP 伺服器,例如 Sun Java System Directory Server。

 

連結密碼 

使用 LDAP 伺服器的部署中所用的連結 DN 密碼。

 

SMTP 伺服器主機名稱 

(可選擇) 

用於將電子郵件通知訊息傳送至離線使用者的 SMTP 伺服器主機名稱。例如,mail.siroe.com。如果 SMTP 伺服器不是使用連接埠 25,請將連接埠與主機名稱一併指定。例如,若 SMTP 伺服器使用連接埠 1025

mail.siroe.com:1025

相依性:SMTP 伺服器,例如 Sun Java System Messaging Server。 

 

資料庫、記錄與執行階段檔案路徑名稱 

儲存執行階段檔案、資料庫與記錄的位置。亦稱 im-runtime-base。執行階段檔案由伺服器在正常操作期間進行讀取、建立與修改。某些範例包含記錄檔案,以及與用戶端動作相關的持續性狀態資訊,例如警示訊息、名冊資訊、會議、新聞通道等。

如果您正在為 Instant Messaging 配置高可用性 (High Availability, HA),則此路徑必須全域可用。如需 HA 的詳細資訊,請參閱第 4 章, 配置 Instant Messaging 的高可用性 (僅 Solaris)

configure 公用程式會將目錄 (/default ) 接續在您提供給執行階段檔案的路徑後。此目錄的名稱是執行階段檔案所套用的實例。稍後,您可藉由建立其他不同名稱 (例如 /secure) 的實例目錄,並從 /default 實例執行階段目錄中複製檔案,來建立多個 Instant Messaging 實例。如需特定說明,請參閱從單次 Instant Messaging 安裝中建立多個實例

如果您在執行 configure 時接受下列預設值:

Solaris:/var/opt/SUNWiim/

Linux:/var/opt/sun/im/

configure 公用程式會為執行階段檔案建立下列目錄:

Solaris:/var/opt/SUNWiim/default

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

此外,會在執行階段目錄下建立下列兩個子目錄。 

資料庫目錄 (im-db-base) 預設值如下:

Solaris:/var/opt/SUNWiim/default/db

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

記錄目錄預設值如下: 

Solaris:/var/opt/SUNWiim/default/log

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

 

資源、說明檔案與 HTTP 閘道路徑名稱 

資源目錄

安裝資源檔案、線上說明與 XMPP/HTTP 閘道的目錄。

若您要為部署自訂資源檔案,則應執行 configure 公用程式,並自訂檔案,然後重新部署資源檔案。您需要先執行 configure,因為 configure 公用程式會建立您可自訂的某些索引與 .jnlp 檔案。如需相關資訊,請參閱重新部署資源檔案

預設值: 

im-svr-base/html

 

XMPP/HTTP 閘道部署 

決定是否要部署 XMPP/HTTP 閘道。如果您選擇部署閘道,而在預設 Instant Messaging 伺服器實例的 im-cfg-base 目錄中,尚沒有預設閘道配置檔案 (httpbind.conf),則 configure 公用程式會從中建立此檔案。如果已有 httpbind.conf,則 configure 公用程式就不會改變或覆寫此檔案。

預設值:True (已部署閘道)

 

XMPP/HTTP 閘道 URI 

定義 XMPP/HTTP 閘道 HTTP 元件的 URI。 

預設值: 

http://web-svr-host:80/httpbind

 

程式碼庫 

Instant Messenger 從中存取資源的 URL,包含 Instant Messaging 用戶端初始下載的開始頁面。 

安裝程式會將資源檔案安裝至下列位置: 

Linux:/opt/sun/im/html

Solaris:/opt/SUNWiim/html

configure 公用程式使用程式碼庫來決定要使用的 Web 容器實例。若成功,根據所提供的 URL,configure 公用程式會將 Instant Messenger 資源部署為 Web 容器中的 Web 應用程式。如果沒有偵測到支援的 Web 容器,則會提示您指定複製或連結資源的檔案系統位置。

若您正在將 Instant Messaging 與 Sun Java System Application Server 或 Sun Java System Web Server 一起使用,則 configure 公用程式會自動為您將資源檔案發佈至 Web 容器。對於 Sun Java System Application Server,configure 公用程式會使用 asadmin 指令;對於 Sun Java System Web Server 6,configure 公用程式會使用 wdeploy 指令;對於 Sun Java System Web Server 7, configure 公用程式會使用 wadm 指令。

若您正在使用不同的 Web 容器,configure 公用程式會將檔案複製到您指定的位置。其中應包括 Web 容器的文件根目錄。或者,您也可以在 Web 容器配置中增加資源檔案安裝目錄,將其做為文件根目錄。如需詳細的特定說明,請參閱 Web 容器的文件。

此外,您可使用符號連結,讓來源對 Web 容器可見。例如,在 Solaris 中,可建立下列符號連結,讓來源對 Web 容器可見: 

ln -s /opt/SUNWiim/html docroot /im

其中,docroot 是 Web 容器的文件根目錄,例如 /opt/web

若您正在對 Sun Java System Access Manager 使用 SSO,則必須配置 Access Manager 伺服器與 Instant Messaging 伺服器,讓其使用相同的 Web 容器。 

如需將資源檔案部署為 Web 應用程式的詳細資訊,請參閱您的 Web 容器文件。如果您需要在初始配置後修改資源檔案的位置,請參閱變更程式碼

 

建立 UNIX 系統使用者與群組

系統使用者執行特定的伺服器程序。必須為這些使用者指定某些權限,以確保他們具有執行這些程序的適當權限。一般而言,configure 公用程式會建立下列使用者與群組:

config 公用程式未建立 Instant Messaging 的 UNIX 使用者與群組,則需要依照本節中的描述來手動建立。在建立 Instant Messaging 的使用者與群組之後,您應為該使用者所擁有的目錄與檔案設定適當權限。

除非您將 Instant Messaging 與 Access Manager 一起部署,否則請勿選擇 root 作為伺服器使用者 ID。在一起部署了兩者的情況下,您需要使用 root 才能存取 Access Manager 配置。

Procedure建立適當的 UNIX 使用者與群組

  1. 以超級使用者身份登入。

  2. 建立您的系統使用者將屬於的群組。

    例如,若要在 Solaris 上建立名稱為 imgroup 的群組,請鍵入下列指令:


    # groupadd imgroup
    
  3. 建立系統使用者並將其與剛建立的群組相關聯。此外,為該使用者設定密碼。

    例如,若要在 Solaris 上建立名稱為 imuser 的使用者,並將其與 imgroup 群組相關聯,請鍵入下列指令:


    # useradd -g imgroup imuser
    

    如需關於新增使用者與群組的更多資訊,請參閱您的作業系統文件。

  4. 請確定使用者與群組已新增至 /etc/groups 檔案。

configure 公用程式簡介

在您安裝完軟體後,會使用 configure 公用程式配置部署的相關資訊,並產生用來管理與執行 Instant Messaging 的配置檔案。

若您要為部署自訂資源檔案,則應執行 configure 公用程式,並自訂檔案,然後重新部署資源檔案。您需要先執行 configure,因為 configure 公用程式會建立您可自訂的某些索引與 .jnlp 檔案。如需相關資訊,請參閱重新部署資源檔案。如需在配置後尋找這些檔案的資訊,亦請參閱完成配置檢核清單

公用程式會顯示提示您資訊的面板,並提供讓您配置 Instant Messaging 系統的其他說明。

安裝或升級後配置 Instant Messaging

安裝程式不會配置 Instant Messaging 軟體。您需要在安裝軟體後執行 configure 公用程式。

若您正在使用 BEA Web 容器,則需要先建立 PASSFILE 才能配置 Instant Messaging。如果您沒有使用 BEA Web 容器,請跳至安裝後配置 Instant Messaging

Procedure建立 BEA Web 容器的 PASSFILE

  1. 建立名為 installation directory /SUNWiim/lib/PASSFILE 的檔案。

  2. 將下列各行新增至您建立的檔案:


    DS_DIRMGR_DN=Directory Manager Bind DN 
    
    DS_DIRMGR_PASSWORD=Directory Manager Bind Password
    
    DS_HOST=LDAP Host Name
    
    DS_PORT=LDAP Port Number
    
    DS_BASE_DN=Base DN
    
  3. 填入每個變數的值。

Procedure安裝後配置 Instant Messaging

  1. 變更為安裝 Instant Messaging 的目錄。

    依預設,此目錄在 Solaris 上是 /opt/SUNWiim,在 Linux 上則是 /opt/sun/im

  2. 以下列方式之一執行 configure 公用程式:

    圖形化使用者介面:


    configure
    

    指令行:


    configure --nodisplay
    

    從狀態檔案:


    configure --nodisplay --noconsole --state statefile
    

    其中,statefile 是要使用的狀態檔案的路徑。若您正在使用狀態檔案配置,則不會提示您配置資訊。而是會使用狀態檔案中的值來配置軟體。如需產生狀態檔案的資訊,請參閱執行無訊息 Instant Messaging 配置

    若您正在使用圖形使用者介面或指令行配置,則會出現一系列提示,請求設定 Instant Messaging 初始配置的資訊。出現的提示視您安裝的元件而有所不同。使用 Instant Messaging 檢核清單中的值填入請求的資訊。請參閱完成配置檢核清單

  3. 如果您從 Instant Messaging 伺服器中的不同主機上安裝 Sun Java System Access Manager,在您執行 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

  4. 如果您正在使用 Access Manager 來管理 Instant Messaging 策略,請執行 imadmin assign_services 指令。


    imadmin assign_services
    

    系統會提示您輸入要儲存使用者項目的組織基底 DN。此指令會將 Instant Messaging 與線上狀態服務增加至您指定組織下的目前使用者。

  5. 重新啟動 Sun Java System Application Server。

    如果 Instant Messaging 要將 Access Manager 策略用於 Sun Java System Application Server 部署,則當您完成 Instant Messaging 配置後,需要重新啟動 Application Server。如果您不重新啟動 Application Server,Instant Messaging 服務就不會顯示於 Access Manager 主控台 (amconsole ) 中。

  6. 如果您想使用 XMPP/HTTP 閘道,在以下情況下,可能需要修改 httpbind_log4j.conf 中 XMPP/HTTP 閘道的預設記錄檔位置:

    • 在 Solaris 中,您已選擇使用預設值之外的記錄位置

    • 在 Linux 中,可以選擇任何路徑

    若要這麼做:

    1. 開啟 httpbind_log4j.conf 檔案。

      此檔案儲存於您在 httpbind.conf 檔案中所指定的位置,作為 httpbind.log4j.config 參數的值。依預設,此檔案儲存於預設 Instant Messaging 實例下的下列目錄:


      im-cfg-base/httpbind_log4j.conf
    2. log4.appender.appender_ID.file 參數值設定為記錄檔案的儲存位置。

      依預設,在 Linux 中,此值是 /var/opt/sun/im/default/log。如果當您執行 configure 時已選擇其他記錄檔案位置,則輸入此路徑作為參數值。

  7. 如果需要,可為 SSO 與策略管理配置基于 Access Manager 的服務。

    如需相關資訊,請參閱將 Instant Messaging 與線上狀態服務增加至 Access Manager 中的子組織以支援單次登入和策略管理

  8. 配置 Web 容器與用戶端系統以支援 Instant Messaging。

    如需說明,請參閱第 2 章, 設定和啟動 Instant Messenger

將 Instant Messaging 與線上狀態服務增加至 Access Manager 中的子組織以支援單次登入和策略管理

如果您正在將 Instant Messaging 與 Communications Suite 中的其他伺服器產品 (例如Messaging Server) 一起使用,且您想使用 Access Manager 來支援單次登入 (SSO) 或策略管理,則需要為 Instant Messaging 手動配置 Access Manager– 式的服務。這是因為某些 Communications Suite 產品的配置,例如 Messaging Server,會在 Access Manager 中的頂層組織下建立一個或多個網域。configure 公用程式僅會自動將這些服務增加至頂層組織,且如果您正在計劃為 SSO 或策略管理規劃調配 Access Manager 部署,則只有在提示時選擇

Procedure手動將 Instant Messaging 與線上狀態服務指定給 Access Manager 中的子組織

  1. 在 Web 瀏覽器中,登入 Access Manager 管理主控台:


    http://hostname:port/amconsole
    

    例如:


    http://amserver.company22.example.com:80/amconsole
    
  2. 從瀏覽窗格 (左邊窗格) 中的 [檢視] 下拉式清單中選取 [組織]。

    在左邊窗格中的頂層組織下會顯示網域清單。

  3. 在瀏覽窗格中,在您要增加服務的頂層組織下按一下網域名稱。

    例如:


    mydomain.example.com
  4. 在瀏覽窗格中,從 [檢視] 下拉式清單中選取 [服務]。

    在左邊窗格中會顯示指定到網域之所有服務的清單。

  5. 按一下瀏覽窗格中的 [增加]。

    資料窗格 (右邊窗格) 中會顯示您可增加至網域之服務的清單。

  6. 在資料窗格中的 [Instant Messaging 配置] 下,選取 [Instant Messaging 服務] 與 [線上狀態服務] 核取方塊,並按一下 [確定]。

    您所選取的服務會列於瀏覽窗格中,並已指定到頂層組織下的網域中。

執行無訊息 Instant Messaging 配置

若要執行無訊息配置,您要先完成假配置以建立狀態檔案。在此假配置階段作業期間,會將您對 configure 公用程式的回應擷取到狀態檔案中,但不會修改軟體。在狀態檔案中,您的回應會保留為一份參數清單,每個參數代表一個單獨提示或欄位。下一步,您需要建立適於平台的狀態檔案 ID,並修改狀態檔案以包含此 ID。

然後,可在許多使用此狀態檔案作為輸入的主機上執行 configure 公用程式。此程序能讓您將一種配置快速傳播至企業中的多個主機。如需使用狀態檔案來配置 Instant Messaging 新實例的資訊,請參閱安裝或升級後配置 Instant Messaging

Procedure產生 Instant Messaging 的配置狀態檔案與 ID

  1. 以超級使用者身份登入。

  2. 變更為安裝 Instant Messaging 的目錄。

    依預設,此目錄在 Solaris 上是 /opt/SUNWiim,在 Linux 上則是 /opt/sun/im

  3. 鍵入下列指令行以執行 configure 公用程式:


    configure -no [--nodisplay] -saveState statefile
    

    其中,statefile 是要使用的狀態檔案的名稱。

    若要使用狀態檔案配置 Instant Messaging 的不同安裝,請使用下列指令:


    configure --nodisplay --noconsole --silent -state statefile
    

    在您執行 configure 公用程式時,您的答案將被擷取在狀態檔案中。當您完成配置時,您指定位置中的狀態檔案已可用。

  4. 如果您符合下列任一條件,則可能需要產生適於平台的新狀態檔案 ID:

    • 您已有為先前 Instant Messaging 版本或修補程式所產生的狀態檔案。

    • 您已有為先前版本所產生的狀態檔案,且已套用包含新版或修正版 config.class 的修補程式。

    在任一種情況下,舊的狀態檔案 ID 都將不再有效。完成下列步驟以產生新的 ID 並取代舊的 ID:

    1. 再次執行 configure 公用程式,但這次使用如下的 --id 選項:


      configure --id
      

      該指令產生加密識別碼。

    2. 複製識別碼,並將此值貼入狀態檔案,作為 STATE_BEGINSTATE_DONE 參數的值。

      如需使用狀態檔案來配置不同 Instant Messaging 安裝的詳細資訊,請參閱安裝或升級後配置 Instant Messaging

從單次 Instant Messaging 安裝中建立多個實例

您可在單個主機的一次安裝中建立多個 Instant Messaging 實例。可能需要執行該動作以建立 Instant Messaging 的安全版本,或支援多個目錄的名稱空間。名稱空間是目錄中的節點,其下的每個 UID 都是唯一的。在單個主機上的Instant Messaging 所有實例會共用二進位檔,但執行階段與配置檔案的版本是唯一的。

Procedure從目前安裝中建立 Instant Messaging 的其他實例

此程序假設您為 im-svr-baseim-runtime-base 使用預設安裝與配置值。如果您已使用預設值安裝,則原始的執行階段目錄如下:

Solaris:/var/opt/SUNWiim/default

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

如果您已使用非預設值的路徑,則需要以此程式中所使用的路徑來取代您的路徑。

  1. 為新的實例建立執行階段目錄:

    例如,為實例 xyz 建立新的執行階段目錄:

    Solaris:mkdir /var/opt/SUNWiim/xyz

    Linux: mkdir /var/opt/sun/im/xyz

  2. 為新實例建立記錄目錄:

    例如,為實例 xyz 建立新的記錄目錄:

    Solaris: mkdir /var/opt/SUNWiim/xyz/log

    Linux:mkdir /var/opt/sun/im/xyz/log

  3. 如果您正在使用檔案式特性儲存方式來儲存使用者資料,則需要為新實例建立資料庫目錄 (im-db-base):

    例如,為實例 xyz 建立新的資料庫目錄:

    Solaris:mkdir /var/opt/SUNWiim/xyz/db

    Linux:mkdir /var/opt/sun/im/xyz/db

  4. im-svr-base 目錄及其所有子目錄的內容複製到新建立的目錄:

    例如:

    Solaris:cp -r /etc/opt/SUNWiim/default /etc/opt/SUNWiim/xyz

    Linux:cp -r /etc/opt/sun/im/default /etc/opt/sun/im/xyz

  5. 在文字編輯器中開啟新實例的 imadmin 程序檔。

    依預設,此程序檔是儲存於您剛為新實例所建立的 im-svr-base 目錄下:

    Solaris:/etc/opt/SUNWiim/xyz/imadmin

    Linux:/etc/opt/sun/im/xyz/imadmin

  6. imadmin 程序檔中,將配置檔案路徑變更為新實例的新配置檔案路徑。

    例如:

    在 Solaris 中,將 /etc/opt/SUNWiim/default/config/iim.conf 變更為 /etc/opt/SUNWiim/xyz/config/iim.conf

    在 Linux 中,將 /etc/opt/sun/im/default/config/iim.conf 變更為 /etc/opt/sun/im/xyz/config/iim.conf

  7. 儲存和關閉 imadmin 程序檔。

  8. 在文字編輯器中開啟新實例的 iim.conf 檔案。

    依預設,iim.conf 檔案是儲存於您為新實例所建立的 im-cfg-base 目錄下:

    Solaris:/etc/opt/SUNWiim/xyz/config/iim.conf

    Linux:/etc/opt/sun/im/xyz/config/iim.conf

  9. 修改 iim.conf 中的連接埠號碼,以避免與原始實例的連接埠號碼衝突。

    預設的連接埠號碼如下:

    • 伺服器連接埠 (iim_server.port) – 5269

    • 多重訊號組合器偵聽連接埠 (iim_mux.listenport) – 5222

    • 多重訊號組合器至伺服器通訊連接埠 (iim_mux.serverport ) – 45222

    如需這些參數的詳細資訊,請參閱附錄 A iim.conf 中的 Instant Messaging 配置參數

  10. 修改 iim.instancedir 參數,以指向 im-svr-base

    如需 im-svr-base 的資訊,請參閱Instant Messaging 伺服器目錄結構

  11. 修改 iim.instancevardir 參數,以指向新實例的執行階段目錄。

    例如:

    在 Solaris 中,將 /var/opt/SUNWiim/default 變更為 /var/opt/SUNWiim/xyz

    在 Linux 中,將 /var/opt/sun/im/default 變更為 /var/opt/sun/im/xyz

  12. 儲存和關閉 iim.conf

  13. 請確定所有實例的檔案與目錄的所有權與權限均相同。

  14. 複製 im-svr-base/html/locale /im.htmlim.jnlpindex.html 資源檔案後重新命名這些副本,並修改這些副本,以指向新實例的連接埠號碼。

  15. 重新部署重新命名的資源檔案。

    如需說明,請參閱重新部署資源檔案

  16. 啟動新實例:

    Solaris:/etc/opt/SUNWiim/xyz/imadmin start

    Linux:/etc/opt/sun/im/xyz/imadmin start

第 2 章 設定和啟動 Instant Messenger

本章在下列小節中將介紹關於配置 Web 容器與用戶端系統以支援 Instant Messenger 的資訊:

啟用 JavaTM Web Start

若要與 Java Web Start 一起使用 Instant Messenger,您需要安裝此軟體,然後配置您的 Web 容器,以便與 Java Web Start 共同作業。如需安裝 Java Web Start 的說明,請至 http://java.sun.com/products/javawebstart

若要在 Web 容器中啟用 Java Web Start 支援,您必須編輯 Web 容器的 mime.types 檔案來包含以下的 JNLP 定義:

內容類型:application/x-java-jnlp-file

字尾:jnlp

本節提供以下說明:

Procedure新增 MIME 類型至 Sun Java System Web Server Enterprise Edition

  1. 在瀏覽器中輸入以下 URL 來存取管理伺服器:


    http://hostname.domain-name:administration-port
    

    例如:http://budgie.siroe.com:8888

    Sun Java System Web Server 顯示視窗提示您輸入使用者名稱和密碼。

  2. 輸入在 Web 容器安裝期間指定的管理使用者名稱與密碼。

    Web 容器會顯示 [管理伺服器] 頁面。

  3. 在 [管理伺服器] 頁面上按一下 [管理]。

    Web 容器會顯示 [伺服器管理員] 頁面。

  4. 按一下 [MIME 類型] 連結。

  5. 在 MIME 檔案的下拉式清單中,選擇要編輯的 MIME 類型,並按一下 [確定]。

  6. 在 [全域 MIME 類型] 頁面中,從 [類別] 下拉式清單中選取 type

  7. 在 [內容類型] 文字方塊中,鍵入:


    application/x-java-jnlp-file
    
  8. 在 [檔案字尾] 文字方塊中,鍵入:


    jnlp
    
  9. 按一下 [新增類型] 來建立 MIME 類型。

  10. 重新啟動 Web 容器以使此變更生效。

Procedure新增 MIME 類型至 Apache Web 容器

    將下列指令行新增至 mime.types 檔案:


    application/x-java-jnlp-file jnlp
    

    此檔案預設位在 Apache Web 容器配置目錄中。

配置 Instant Messaging 的用戶端系統

如果用戶端機器已安裝適當版本的 Java,則使用 Java Plug-in 或 Java Web Start 沒有額外的需求。Netscape Navigator v7 和 Mozilla 瀏覽器的最新版本包括 Java 的最新版本,而 Internet Explorer 則沒有。如需版本需求的資訊,請參閱 Sun Java System Instant Messaging 7 2006Q4 Release Notes。

如果用戶端機器沒有安裝所需的 Java 版本,則需要安裝 Java Web Start。您可以從 http://www.java.sun.com/j2se 下載並安裝 Java。

您可以從 http://www.java.sun.com/products/javawebstart 下載並安裝 Java Web Start。

啟動 Instant Messenger

您可在 Web 瀏覽器中以 applet 執行 Instant Messenger,或作為獨立的應用程式執行 (如下列章節所描述):

從 Web 瀏覽器執行 Instant Messenger

按照這些說明將 Instant Messenger 執行為 Web 瀏覽器中的 applet。

Procedure在 Web 瀏覽器內將 Instant Messenger 執行為 Applet:

  1. 啟動 Web 瀏覽器。

    如需支援瀏覽器的資訊,請參閱「Sun Java System Instant Messaging 7 2006Q4 Release Notes」。

  2. 移至 Instant Messaging 首頁。

    依預設,首頁會儲存為 index.html。使用以下格式找到 Instant Messaging 首頁:

    http:// codebase/index.html

    其中,codebase 是 Web 容器上對應至資源檔案位置的 URL。

  3. 按一下 [使用 Java Plug-In]。

    如果您自訂了首頁且變更了連結文字,則按一下瀏覽器中對應至以 applet 執行 Instant Messenger 的連結。指向 im.jnlp (標準和 TLS 模式) 或 imssl.jnlp (舊有 SSL 模式)的連結。

    當使用 Java Plug-In 建立 Instant Messenger 階段作業時,瀏覽器視窗必須專供其使用。

    您不能使用此瀏覽器視窗找到任何其他 URL,也不能在沒有終止 Instant Messenger 階段作業的情況下關閉瀏覽器視窗。

將 Instant Messenger 執行為獨立應用程式

按照這些說明將 Instant Messenger 執行為獨立應用程式。

Procedure將 Instant Messenger 執行為獨立應用程式

  1. 啟動 Web 瀏覽器。

    如需支援瀏覽器的資訊,請參閱「Sun Java System Instant Messaging 7 2006Q4 Release Notes」。

  2. 移至 Instant Messaging 首頁。

    依預設,首頁會儲存為 index.html。使用以下格式找到 Instant Messaging 首頁:

    http:// codebase/index.html

    其中,codebase 是 Web 容器上對應至資源檔案位置的 URL。

  3. 按一下 [啟動]。

    如果您自訂了首頁且變更了連結文字,則按一下對應至以 Java Web Start 執行 Instant Messenger 的連結。指向 im.html (標準或 TLS 模式) 或 imssl.html (舊有 SSL 模式) 的連結。

    如需自訂資源頁面的指示,請參閱自訂 Instant Messenger