test

Sun Java System Communications Express 6 2005Q4 管理指南

第 2 章 安裝並配置 Communications Express

本章描述如何安裝及配置 Communications Express。

本章包含以下主題：

備註

備註 –

從 Java Enterprise System 安裝程式安裝 Communications Express

若要安裝 Communications Express，請依照以下步驟：

備註 –

解除安裝先前安裝的任何 Communications Express。

如果您從舊版建置的 Java Enterprise System 安裝程序安裝 Communications Express，就必須使用 Java Enterprise System 解除安裝程式來解除安裝。在 Solaris 上，Sun Java™ Enterprise System 解除安裝程式位於：/var/sadm/prod/entsys/uninstall

Procedure安裝 Communications Express

步驟

  1. 從 Sun Java™ Enterprise System 安裝精靈中顯示的元件清單中選取 Sun Java™ System Communications Express。

    備註 –

    選取 Sun Java System Communications Express 之後，就會自動選取 Communications Express 所依賴的產品。但是，如果系統中已經安裝這些產品，會停用此選項。

  2. 顯示 [安裝目錄] 面板。瀏覽以便指定給每個元件產品的目標安裝目錄名稱。

    請按 [下一步]。

  3. 幾個面板過去後會顯示 [配置類型] 面板。

    1. 決定您要的配置類型。可用的選項為：

      • 立即配置。讓您配置元件產品，允許在安裝時進行配置。

      • 以後配置。安裝程式會把套裝軟體安裝到指定的目錄路徑中，並且不配置就繼續。如需更多詳細資訊，請參閱「Sun Java Enterprise System 安裝指南」第 2 章中的「選擇配置類型」一節。

      備註 –

      無法從 Sun Java™ Enterprise System 安裝精靈配置 Communications Express。您需要執行 Communications Express 配置程式來配置 Communications Express。

    2. 選取配置類型，然後按 [下一步]。

  4. 出現 [自訂配置] 面板。

    按 [下一步] 配置其他元件產品 (如果有的話)。

  5. 完成安裝程序。

配置 Communications Express 的先決條件

執行 Communications Express 配置設定程式之前，先確定執行下列工作：

Procedure先決條件

步驟

  1. 選取模式。請參閱模式的選擇一節，以取得有關可用模式選項的資訊。

  2. 在 Solaris 系統上，確定 /etc/hosts 檔案包含以下項目：

    ip-of system FQHN hostname

    例如，

    129.158.230.64 budgie.siroe.varrius.com budgie

  3. 在配置 Communications Express 之前，請確認啟動並執行下列元件。並確認下列依序提到的 Communications Express 產品的配置已經完成：

    1. Directory Server

      1. Directory Server 的管理主控台

      2. Application Server (如果已經選取) 或 Web Server (如果已經選取)

        備註 –

        這個步驟之後，請執行「目錄準備程序檔」(comm_dssetup.pl)，更新「使用者/群組」Directory Server 中的模式詳細資訊。

        如果您已經順利配置 Messaging Server 及 Calendar Server，請略過本步驟。

        若要執行「目錄準備程序檔」(comm_dssetup.pl) 請輸入：

        cd /root -of -the -directory -preparatory-script/SUNWcomds/sbin

        perl comm_dssetup.pl

      3. 如果您選擇 Sun Java System LDAP Schema, v.2，則是 Access Manager。

      4. Messaging Server

      5. Calendar Server

      6. 如果您選擇 Sun Java System LDAP Schema, v.2，則是 Delegated Administrator。

        如需有關產品配置程序的詳細資訊，請參閱「Sun Java Enterprise System 安裝指南」第 10 章。

    2. 請驗證使用者是否能正確登入下列伺服器。

      • Messaging Server

        • Calendar Server

        • 如果您選擇 Sun Java System LDAP Schema, v.2，則為 Access Manager (原名為 Identity Server)

模式的選擇

在安裝和配置之前，您需要決定想採用的模式模型。部署 Communications Express 時，您有兩個模式及 Web 容器選項。

針對每組模式和 Web 容器顯示的配置程式面板根據所選模式和 Web 容器而異。附錄 B配置面板序列 中列出了針對每組模式和 Web 容器顯示的面板。

呼叫配置工具

這一節描述如何呼叫配置工具。

Procedure呼叫配置工具

步驟

  1. 以 Administrator (UNIX 或 Linux 的根目錄) 身分登入。

  2. 呼叫配置精靈之前設定顯示設定。

  3. 請至 uwc-basedir/SUNWuwc/sbin 目錄。

  4. 然後鍵入

    ./config-uwc，以在 GUI 模式下呼叫配置工具。

    ./config-uwc -nodisplay，以在主控台模式下呼叫配置工具。

    備註 –

    本版本不支援無訊息安裝模式。

  5. 出現配置精靈。

配置 Communications Express

下列步驟會引導您配置 Communications Express。

備註 –

如果您以英文以外的語言呼叫配置精靈，請調整配置面板大小，以檢視其內容。

Procedure配置 Communications Express

步驟

  1. [歡迎] 面板。

    配置程式的第一個面板是版權頁面。選取 [下一步] 以繼續或選取 [取消] 以結束。

  2. 會出現 [選取儲存配置檔和資料檔的目錄] 面板。

    選取部署 Communications Express 的配置及資料檔案的目錄。例如，/var/opt/SUNWuwc。

    在本指南中，將該目錄稱為 uwc-deployed-path。

    請按 [下一步]。

  3. 會出現 [選取要配置的元件] 面板。

    請選取要配置的元件，並取消選取不想配置的那些元件。

    • 郵件元件

    • 行事曆元件

    備註 –

    您至少要從 [選取要配置的元件] 面板選取一個元件。

    雖然元件的大小顯示為零，但是已安裝 [郵件] 及 [行事曆] 這兩個元件。

    請按 [下一步]。

  4. 會出現 [網路連線] 面板。

    配置程式使用本面板顯示的主機名稱及 DNS 網域名稱，嘗試建立網路連線。

    主機名稱。顯示將配置 Communication Express 的主機名稱。

    DNS 網域名稱。顯示 DNS 伺服器維護的 DNS 網域名稱。

    請按 [下一步]。

  5. 會出現 [選取 Web 容器] 面板。

    從顯示的選項選取您要使用的 Web 容器。可用的選項為：

    • Web Server。如需 Web Server 面板的詳細資訊，請參閱配置 Communications Express。

      Web Server

      如果您選取 Web Server 作為 Web 容器，則會出現下列面板：

      • [Web Server 配置詳細資訊] 面板。

        指定本機 Web Server 實例的詳細資訊。此處指定的 Web Server 詳細資訊被安裝程式用於在 Web Server 上部署 Communications Express。

        伺服器根目錄。瀏覽以選取 Web Server 的安裝根目錄。預設位置為 /opt/SUNWwbsvr/。

        伺服器實例識別碼。輸入要部署 Communications Express 的 Web Server 實例。例如，budgie.siroe.varrius.com。

        虛擬伺服器識別碼。輸入要部署 Communications Express 的虛擬伺服器識別碼。例如，https-budgie.siroe.varrius.com。

        HTTP 連接埠。輸入 Web Server 監聽的 HTTP 連接埠號碼。這是存取 Communications Express 的 HTTP 連接埠。

        備註 –

        如果您要配置安全的 HTTP 連接埠號碼，請在配置 Communications Express 後指定。若要配置安全連接埠號碼，請參閱本指南第 3 章中配置安全套接層 (SSL)一節提供的後續配置步驟。

        請按 [下一步]。

        您會看到一個小快顯式視窗，指示正在驗證 Web Server 實例。這個過程可能需要幾分鐘。

        如果配置工具無法連線到 Web Server 實例，就會顯示錯誤訊息。按一下 [接受] 繼續安裝程序，或按一下 [選擇新增] 指定不同的 Web Server 配置詳細資訊。

      • [Web 容器使用者及群組] 面板。

        指定 Web 容器用來執行服務的身份。

        Web 容器使用者 ID。顯示使用者資料庫中的 Web 容器使用者識別碼。

        Web 容器群組 ID。顯示群組資料庫中的 Web 容器群組識別碼。

        請按 [下一步]。

        配置設定程式會安裝某些檔案及目錄，內含機密資料，例如密碼。這些檔案及目錄的所有權都給了本面板所提及的 Web 容器使用者及群組。只有 Web 容器使用者，才有包含機密資料的檔案及目錄的讀寫權限。

        備註 –

        確定您在本面板中輸入正確的 Web 容器使用者 ID 及群組 ID 值。輸入錯誤的值可能導致 Communications Express 啟動失敗。

        將 Web Server 配置為您的 Web 容器後，請至配置 Communications Express。

    • Application Server。如需 Application Server 面板的詳細資訊，請參閱配置 Communications Express。

      Application Server

      如果您選取 Application Server 作為 Web 容器，則會出現下列面板：

      • [Application Server 配置詳細資訊] 面板。

        在 [Application Server 配置詳細資訊] 面板中，指定下列詳細資訊：

        安裝目錄。瀏覽以選取安裝 Application Server 的本機目錄。

        網域目錄。瀏覽以選取 Application Server 的網域目錄。

        文件根目錄。瀏覽以選取 Application Server 的文件根目錄。

        伺服器目標名稱。輸入給將配置 Communications Express 的 Application Server 目標的名稱。Communications Express 配置設定程式僅支援 Application Server 8.1 的 Domain Administration Server (DAS) 部署。

        虛擬伺服器識別碼。輸入將配置 Communications Express 的虛擬伺服器識別碼。

        伺服器實例 HTTP 連接埠。輸入可使用 HTTP 服務的 Application Server 連接埠號碼。這是存取 Communications Express 應用程式的 HTTP 連接埠。

        請按 [下一步]。

        備註 –

        在此指定 HTTP 連接埠號碼。如果您要配置安全的 HTTP 連接埠號碼，請在配置 Communications Express 後指定。若要配置安全連接埠號碼，請參閱本指南配置安全套接層 (SSL)一節提供的後續配置步驟。

        您會看到一個小警示快顯式視窗，指示正在驗證 Application Server 實例。這個過程可能需要幾分鐘。

        如果配置工具無法連線到 Application Server 實例，就會顯示錯誤訊息。按一下 [接受] 繼續安裝程序，或按一下 [選擇新增] 再指定 [Application Server 配置詳細資訊] 一次。

      • [Application Server 管理實例詳細資訊] 面板。

        指定 Application Server 的管理實例詳細資訊。管理實例詳細資訊被配置設定程式用於在 Application Server 上部署 Communications Express。

        Administration Server 連接埠。輸入 Administration Server 連接埠號碼。

        備註 –

        Application Server 的管理連接埠必須可以使用，才能在 Application Server 上配置 Communications Express。

        管理員使用者 ID。輸入管理員的使用者識別碼。

        管理員密碼。輸入管理員的使用者密碼。

        安全 Administration Server 實例。選取該核取方塊，以指定 Application Server 的管理實例在安全模式下執行。

        取消選取該核取方塊，以指定 Application Server 的管理實例在一般模式下執行。

        請按 [下一步]。

        依據選擇，會出現快顯式視窗，確認 Application Server 的管理實例之執行模式。按一下 [確定] 結束快顯式視窗。

        備註 –

        在 Application Server 上部署 Communications Express 時，會修改 server.xml 和 server.policy 兩個檔案。

        修改 server.xml 和 server.policy 檔案之前，配置程式會保留這些檔案的備份。備份檔案會儲存在下列目錄

        DOMAIN-DIRECTORY/ SERVER-INSTANCE-NAME/config/.CommsExpress_YYYYMMDDhhmmss

        其中，

        DOMAIN-DIRECTORY 是 Application Server 的網域目錄。

        SERVER-INSTANCE-NAME 是將配置 Communications Express 的 Application Server 實例名稱。

        YYYYMMDDhhmmss 是備份目錄的時間戳記。

      • [此 Web 應用程式的模組名稱] 面板。

        輸入在 Application Server 上部署 Communications Express 應該使用的模組名稱。

        請按 [下一步]。

        將 Application Server 配置為您的 Web 容器後，請至配置 Communications Express。

    請按 [下一步]。

  6. 會出現 [URI 路徑] 設定面板。

    輸入應該部署 Communications Express 的 URI。例如，/uwc。

    注意 – 注意 –

    如果您使用現有的 URI 部署 Communications Express，配置工具會先移除任何先前的應用程式資料，才會在那個 URI 上部署 Communications Express。例如，如果您要在已部署了 Web 應用程式的 URI (例如 /uwc) 上部署 Communications Express，Communications Express 配置程式會先移除 /uwc 中現有的 Web 應用程式，然後再部署 Communications Express。這可能會導致遺失之前的應用程式資料，並且無法再存取該應用程式。

    請按 [下一步]。

  7. 螢幕上顯示 [是否需要託管網域支援？] 面板。

    選取選項，啟用 Communications Express 的託管網域支援功能。如果您已啟用 Calendar Server 的託管網域支援功能，請只選取本選項。

    請按 [下一步]。

  8. 會出現 [使用者/群組 Directory (LDAP) Server 詳細資訊] 面板。

    輸入以下詳細資訊：

    LdapURL。指定使用者/群組 LDAP URL，其格式為 ldap://UG-LDAP-HOST:UG-LDAP-PORT。

    連結 DN。輸入使用者/群組管理員的 LDAP 辨別名稱。

    連結密碼。輸入使用者/群組管理員的連結密碼。

    請按 [下一步]。

  9. 會出現 [DC 樹字尾] 面板。

    輸入 DC 樹字尾的基本辨別名稱。本字尾會被 Communications Express 用來搜尋網域查詢。

    請按 [下一步]。

  10. 會出現 [預設網域名稱] 面板。

    輸入預設網域名稱。

    每個網域具有某些的特性。當使用者登入沒有所需特性的網域時，會從預設網域名稱中挑選特性。

  11. 會出現 [啟用 Access Manager 進行單次登入] 面板。

    若要設定 Access Manager 單次登入，請為 Sun Java System Communications Express 選取 [啟用識別碼支援]。

    僅當您為 Sun Java System Communications Express 啟用了識別碼支援後，才會顯示 [Access Manager 喜好設定] 面板。

    輸入 Access Manager 喜好設定，例如此面板中的登入 URL、Access Manager 管理員 DN 和密碼。

    登入 URL。指定 Access Manager 登入 URL，其格式為 protocol://Access Managerhostname:Access Manager port/context -path-of-amserver/UI/Login。

    管理員 DN。輸入 Access Manager 管理員完整的 LDAP DN (辨別名稱)，例如 DN=uid=amAdmin, ou=people, Access Manager- 根尾碼。

    管理員密碼。輸入 Access Manager 管理員密碼。

    請按 [下一步]。

  12. 會出現 [Messaging Express 連接埠] 面板。

    只有在 [選取要配置的元件] 面板中選取郵件元件時，本面板才會出現。

    輸入可使用 Messenger Express 服務的連接埠號碼。

    備註 –

    確定在部署 Messenger Express 的相同機器上部署 Communications Express。

    請按 [下一步]。

  13. 會出現 [Calendar Server 主機和連接埠配置] 面板。

    只有在 [選取要配置的元件] 面板中選取郵件元件時，本面板才會出現。

    Calendar Server 主機名稱。輸入 Calendar Server 的主機名稱。

    Calendar Server HTTP 連接埠號碼。輸入 Calendar Server 的 HTTP 連接埠號碼。

    請按 [下一步]。

  14. 會出現 [Calendar Server 管理詳細資訊] 面板。

    只有在 [選取要配置的元件] 面板中選取郵件元件時，本面板才會出現。

    管理員使用者 ID。輸入 Calendar Server 的管理員名稱。例如，calmaster。

    管理員使用者密碼。輸入 Calendar Server 的管理員密碼。

    備註 –

    確定此處輸入的行事曆管理員使用者 ID 值與 Calendar Server ics.conf 檔案中列出的 service.admin.calmaster.userid 值相同。

    請按 [下一步]。

  15. 會出現 [PAB Directory Server 詳細資訊] 面板。

    個人通訊錄 LDAP Server 是使用者個人通訊錄所在位置的存放區。在這個面板中輸入下列詳細資訊：

    LDAP URL。指定給 PAB 存放區的 LDAP 主機及連接埠。URL 的格式應為：ldap://PAB-ldap-hostname:PAB-ldap-portnumber

    連結 DN。輸入用於連結至 PAB 存放區的 LDAP DN。此處指定的連結 DN 應該具有相應的權限，以管理 o=PiServerDB 根字尾下的資料。

    密碼。輸入連結密碼。

    請按 [下一步]。

  16. 會出現 [準備配置] 面板。

    配置程式將檢查機器上是否有足夠的磁碟空間，然後會列出準備配置的元件。

    按一下 [立即配置] 以配置 Communications Express。

    按一下 [上一步] 變更任何配置變數。

    按一下 [取消] 結束配置程式。

  17. 顯示作業摘要及序列狀態。

    請按 [下一步]。

  18. [配置摘要] 面板列出配置程式的狀態。按一下 [詳細資訊] 按鈕檢視日誌。

  19. 當配置順利完成後，才會出現 [後續配置說明] 面板。如果沒有安裝需要的共用元件，這個面板可能會顯示警告訊息。

    為了完成配置程序，請遵循此處提供的後續配置說明。

後續配置說明

備註 –

確定您熟悉 Communications Express 檔案的位置。

請參閱本指南「前言」中預設路徑和檔案名稱一節。

請參閱第 1 章, Communications Express 簡介配置參數。

在執行後續配置步驟之前，請先確定已經執行下列步驟：

Procedure後續配置說明

步驟

  1. 假設已經安裝 Communications Express 套裝軟體，確定已經為使用 Access Manager 單次登入的設定，增加了核心服務及 LDAP 服務。如需更多資訊，請參閱本指南第 8 章中調校 Directory Server一節。

  2. 配置了 Communications Express 後，請執行下列步驟：

    1. 若要啟用 Communications Express 中的 [郵件] 元件，請配置 [單次登入]。請參閱第 1 章, Communications Express 簡介，以取得有關配置 Messenger Express 和 Communications Express 的資訊。

    2. 請至 calendar-server-install-directory/SUNWics5/cal/bin/config (例如 /opt/SUNWics5/cal/bin/config)。

      編輯 ics.conf 檔案並設定以下值：

      • service.http.allowadminproxy = "yes"

        • service.http.admins = proxy-admin-for-calendar-http-service

          • service.admin.calmaster.userid = the-value-specified-for- calendar.wcap.adminid-in-uwcconfig.properties

          • service.admin.calmaster.cred = the-value-specified-for- calendar.wcap.passwd-in-uwcconfig.properties

          • service.wcap.anonymous.allowpubliccalendarwrite = "yes"

          • service.http.allowanonymouslogin = "yes"

          • service.calendarsearch.ldap = "no"

            編輯 ics.conf 檔案完成後，請重新啟動 Calendar Server，以使變更生效。

  3. 依據您所選擇作為 Web 容器的伺服器，決定要重新啟動 Web Server 或 Application Server。

  4. Communications Express 現在已經就緒，您可以存取應用程式，位置在：

    http://Web-Container-host: Web-Container-port/URI path

    其中

    Web-Container-host 是配置了 Communications Express 應用程式的 Web 容器實例的主機名稱。

    Web-Container-port 是配置了 Communications Express 的 Web 容器實例的連接埠號碼。

    URI path 是在 [URI 路徑設定] 面板中指定的路徑。

取消配置 Communications Express

如果您已經在 Web Server 或 Application Server 上配置 Communications Express，但覺得應該取消配置 Communications Express，請執行下列步驟：

Communications Express 檔案目錄配置

在您安裝及配置 Communications Express 之後，它的目錄及檔案會以表 2-1 中的組織方式來編排。這張表格並不完全詳盡；它只顯示典型伺服器管理作業中最感興趣的目錄及檔案。

表 2–1 Communications Express 的目錄及檔案

目錄及圖示 

預設位置及描述 

Communications Express 基底 

uwc-basedir

預設位置： 

Solaris：/opt/SUNWuwc/

Linux：/opt/sun/uwc/

這個目錄是安裝 Communications Express 的位置。 

備註：每台機器只允許一個 Communications Express 基底目錄。 

部署的目錄 

uwc-deployed-dir

預設位置： 

Solaris：/var/opt/SUNWuwc/

Linux：/var/opt/sun/uwc/

Communications Express 部署在這個目錄中。Web 容器載入 Communications Express 時，會從這個位置取出檔案。 

Web 應用程式根目錄 

web-inf

uwc-deployed-dir/WEB-INF

Communications Express Web 應用程式的 WEB-INF 目錄。 

Web 應用程式根目錄 

web-inf

uwc-deployed-dir/WEB-INF

Communications Express Web 應用程式的 WEB-INF 目錄。 

配置 

config

uwc-deployed-dir/WEB-INF/config/

包含所有的 Communication Express 配置檔案。 

網域 

domain

uwc-deployed-dir/WEB-INF/domain/

包含每個網域本地化和自訂檔案。 

外觀 

skin

uwc-deployed-dir/WEB-INF/skin/

包含每個網域主題。 

記錄 

logs

uwc-deployed-dir/logs/

包含 Communications Express 的記錄檔。 

系統管理員程式 

sbin

uwc-basedir/sbin/

包含 Communications Express 系統管理員可執行的程式及程序檔。 

說明 

help

uwc-deployed-dir/help

包含 Communications Express 說明檔。