安裝 WebSphere Partner Gateway

當您符合前幾節所說的全部必備條件後, 就可以執行資料庫載入器和 WebSphere Partner Gateway 安裝精靈。這些精靈可直接或透過啟動程式來執行。如需相關資訊,請參閱啟動程式

註:
AIX 電子產品影像 tar 檔無法順利以 AIX 中所提供的預設 tar 程式來解除保存, 這是因為影像的路徑長度超過 100 個字元。不過, IBM 會分配一個 tar 程式,可順利解除保存 AIX 電子產品影像 tar 檔。這個 tar 程式可透過下列位置中的 AIX Toolbox for Linux Applications 取得:
http://www-1.ibm.com/servers/aix/products/aixos/linux/download.html

DISPLAY 環境變數

「資料庫載入器」和「中心」安裝精靈在 UNIX 上使用 X Windows 系統來顯示圖形式使用者介面。X Windows 系統需要將 DISPLAY 環境變數匯出至系統環境。 下列指令行是從 Bourne shell 將 DISPLAY 環境變數設為 IP_Address:

DISPLAY=IP_Address:0.0

export DISPLAY

使用適合您的 Shell 的語法來設定 DISPLAY 環境變數。

註:
從指令行執行 X 用戶端程式如 xclock,來測試 DISPLAY 系統環境變數和 X Windows 系統是否適當地配置。 若 xclock 用戶端有顯示在 X Server 視窗上(本端或遠端),則精靈也應該會正確顯示。

啟動程式

WebSphere Partner Gateway 中的啟動程式提供單一窗口, 可讓您存取產品概觀、Readme 檔、產品文件、資料庫載入器, 以及 WebSphere Partner Gateway 安裝程式。另外,您可以使用系統 所提供的 setup*.* 程式來啟動資料庫載入器和安裝程式。請參閱建立資料庫使用安裝精靈來安裝元件

註:
啟動程式上的部分選項會要求您的系統路徑中必須安裝瀏覽器,且可以使用。

啟動程式的執行檔位於:

{CD_ROM/MEDIA DIR}/LaunchPad.sh

建立資料庫

WebSphere Partner Gateway 含有一個可用來安裝資料庫表格的安裝精靈。此精靈是資料庫載入器,它可為您收集資訊來建立及載入表格。 另外,它可以儲存用來建立表格的 SQL 檔。您可以使用 SQL 檔來建立及載入表格。以手動方式執行 SQL 檔可讓您在載入資料庫表格之前先行檢視。

開始之前,請驗證資料庫伺服器是否已安裝、正確配置及執行。

DBLoader 可在沒有實際資料庫的機器上執行。Oracle/DB2 應安裝在該機器上, 但實際的資料庫可位於另一部機器上。DBA 必須針對該項進行部分的配置變更, 但大概不在本書的討論範圍內。首先,您要將資料庫建立在遠端機器上。然後, 您將在要安裝 DBLoader 的機器上,以 Oracle/DB2 來配置遠端資料庫, 以指定它是在哪一部機器上執行、它要使用哪一埠等。一旦配置完成, DBLoader 即可猶如資料庫位於本端環境般執行。Oracle/DB2 會自動注意其餘的部分。所有針對此資料庫執行的 SQL 指令, 會送往正確的機器處理。SQL 可自動執行。

下列程序說明如何使用資料庫載入器 GUI 來配置資料庫。 您也可以不使用 GUI 來安裝資料庫載入器。 如需相關資訊,請參閱使用指令行來安裝元件

註:
請查看 DB2 文件,以瞭解特定作業系統的需求,例如:配置設定或所需的產品版本等。

若要安裝資料庫表格:

  1. 以 root 使用者身分登入。

    資料庫載入器需要管理者專用權才能自動執行表格空間目錄的 SQL create/change 擁有權。

  2. 從資料庫載入器目錄,執行表 9 中所列而適用於您平台的安裝執行檔:

    cd DBLoader

    表 9. 安裝程式的平台專用執行檔
    平台 執行檔

    Linux

    setupLinux

    AIX

    setupAIX

    Solaris

    setupSunOS

    資料庫載入器精靈會啟動並顯示「歡迎使用」視窗。 按下一步

  3. 在「軟體授權合約」視窗中,閱讀「軟體授權合約」。 若您同意合約中的條款,請選取我接受授權合約的條款。 按下一步
  4. 在「目錄名稱」視窗中, 輸入資料庫載入器在安裝資料庫時要使用的目錄路徑和目錄名稱。IBM 建議您建立新目錄位置, 或選取一個空目錄。目錄名稱中不可使用內含空格或特殊字元。

    選取有足夠空間存放資料庫及將儲存所有應用程式資料的位置。 按下一步

    註:
    瀏覽選取目錄時,請在選取所要的安裝路徑之後, 在輸入檔案名稱欄位中輸入一個 "."。 若未輸入 ".",選取目錄視窗不會回到當初啟動它的視窗。
  5. 在「資料庫類型選擇」視窗中, 選取您打算搭配 WebSphere Partner Gateway 使用的資料庫伺服器。您可以選取 DB2 8.2 或 Oracle 9i 9.2.0.4 或以上。按下一步
  6. 在「資料庫資訊」視窗中,輸入下列資料庫資訊,完成時按下一步

    DB2

    若您選取 DB2,則會出現「DB2 資料庫資訊」視窗。輸入下列 DB2 資料庫資訊:

    Oracle

    1. 若您選取 Oracle,則會出現「Oracle 資料庫資訊」視窗。輸入下列 Oracle 資料庫資訊:
      • 管理者登入 ID
      • 管理者密碼
      • Oracle SID
      • 綱目擁有者登入
      • 綱目擁有者密碼
    2. 會出現「Oracle 起始目錄位置」視窗。請輸入或按一下瀏覽, 輸入 Oracle 起始目錄位置。請參閱圖 2

      圖 2. 「Oracle 起始目錄位置」視窗
  7. 圖 3 (DB2) 和圖 4 (Oracle) 的「資料庫位置」視窗中, 輸入資料庫位置及其每一個表格空間在資料庫伺服器上的完整路徑。例如,DB2 資料庫目錄路徑可類似如下:DB2Home/IBM/bcgdbloader/tables
    註:
    瀏覽選取目錄時,請在選取所要的安裝路徑之後, 在輸入檔案名稱欄位中輸入一個 "."。 若未輸入 ".",選取目錄視窗不會回到當初啟動它的視窗。
    只要有變更這些值,在執行 SQL 檔之前它們必須存在。若它們不存在,則必須以手動方式建立它們。

    一旦您輸入必要的資訊之後,請按下一步

    註:
    選取具有足夠空間來存放資料庫及所有應用程式資料的檔案系統位置。 在執行 WebSphere Partner Gateway 時,資料庫大小會增加。

    DB2

    圖 3. 「DB2 資料庫位置」視窗

    Oracle

    圖 4. 「Oracle 資料庫位置」視窗
  8. 圖 5 的「元件配置」視窗中, 輸入 WebSphere Partner Gateway 元件的登入資訊及一般共用檔案的位置。完成時按下一步

    在「社群主控台」、「文件管理程式」和「接收端」的使用者名稱密碼欄位中, 輸入每一個元件的使用者名稱和密碼。若是使用 DB2, 這些使用者已在配置伺服器時建立。

    群組名稱欄位中,輸入包含 WebSphere Partner Gateway 使用者的群組名稱。

    圖 5. 「元件配置」視窗
  9. 從「共用資訊的裝載點」視窗中,輸入 WebSphere Partner Gateway 主要元件所用之共通共用檔案的位置。
    附註:
    1. 若您要在多部機器上安裝 WebSphere Partner Gateway, 則所有機器上之共用的共通資料夾必須使用相同裝載點和目錄結構。
    2. 瀏覽選取目錄時,請在選取所要的安裝路徑之後, 在輸入檔案名稱欄位中輸入一個 "."。 若未輸入 ".",選取目錄視窗不會回到當初啟動它的視窗。
  10. 精靈會顯示一個視窗, 讓您選擇只讓資料庫載入器建立 SQL 檔,或是要建立 SQL 檔並且執行。 請參閱圖 6

    當資料庫載入器執行 SQL 檔時,它會執行下列動作:

    按照慣例,資料庫載入器會重新啟動 DB2 實例, 因此請切斷任何正在使用您設有 WebSphere Partner Gateway 資料庫之 DB2 實例的應用程式。

    若想要資料庫載入器為您執行檔案,請選取 執行 SQL 檔勾選框。按下一步

    圖 6. 「執行 SQL 檔」視窗
  11. 確認資料庫載入器的安裝位置。按下一步
  12. 當已啟用時,請按一下完成
  13. 若您以手動方式執行 SQL,請參閱 bcgdbloader/scripts 子目錄中的 Instructions.txt 檔(由「資料庫載入器」安裝精靈安裝),以取得詳細資訊。

    在您安裝 WebSphere Partner Gateway 資料庫後, 就可以開始安裝 WebSphere Partner Gateway 元件。

    下一節說明如何使用 InstallShield 精靈 GUI 安裝元件。您也可以不使用 GUI 來安裝元件。 如需相關資訊,請參閱使用指令行來安裝元件

使用安裝精靈來安裝元件

WebSphere Partner Gateway 有三個主要元件:「社群主控台」、「接收端」和「文件管理程式」。這三個元件都共用共通內容。 您可以在單一伺服器上安裝元件及共通內容, 或在個別伺服器上安裝每一個元件,或使用這兩個選項的組合。 您必須在至少一個伺服器上安裝每一個元件的一個實例。 有關如何規劃不同元件在不同伺服器上的放置, 請參閱環境規劃拓蹼

註:
若您要在多部機器上安裝 WebSphere Partner Gateway, 則所有機器上的共用 common 資料夾必須使用相同裝載點和目錄結構。

開始之前,請確定已適當地安裝及配置必備軟體。 有關軟體需求,請參閱平台、硬體和軟體需求中的「所有 WebSphere Partner Gateway 伺服器的需求」表格; 有關如何配置該軟體的資訊,請參閱安裝概觀。 您也必須安裝 WebSphere Partner Gateway 資料庫。如需相關資訊,請參閱建立資料庫。 最後,必須執行資料庫伺服器和 WebSphere MQ,包括佇列管理程式和接聽器在內。

在使用非合併式拓蹼時,只需要安裝一次共通元件。

若要安裝 WebSphere Partner Gateway,請執行下列動作:

  1. 以 root 管理者登入。

    「中心」安裝程式需要 root/Administrator 專用權才能與原生的軟體登錄整合。

  2. 在 hub 目錄中,執行表 10 中所列而適用於您平台的安裝執行檔。
    表 10. 安裝程式的平台專用執行檔
    平台 執行檔

    Linux

    setupLinux

    AIX

    setupAIX

    Solaris

    setupSolaris

    精靈會啟動及顯示「歡迎使用」視窗。按下一步

  3. 在「軟體授權合約」視窗中,閱讀授權合約。 若您同意其條款,請選取我接受授權合約的條款。 按下一步
  4. 在「目錄名稱」視窗中, 輸入精靈在安裝 WebSphere Partner Gateway 時使用的目錄路徑和名稱。IBM 建議您建立新目錄位置, 或選取一個空目錄。目錄名稱中不可使用內含空格或特殊字元。按下一步
    註:
    瀏覽選取目錄時,請在選取所要的安裝路徑之後, 在輸入檔案名稱欄位中輸入一個 "."。 若未輸入 ".",選取目錄視窗不會回到當初啟動它的視窗。
  5. 圖 7 的「元件選擇」視窗中, 選取您要安裝在伺服器中的元件。您可以選取多個元件。按下一步
    圖 7. 元件選擇視窗

    此程序的其餘步驟假設您要安裝所有元件。若您不要安裝所有元件, 則本程序的其餘步驟所述的某些視窗不會出現。

  6. 指定您安裝所在機器的完整主機名稱。按下一步
  7. 選取下列一個 WebSphere Application Server, 以用來控管 WebSphere Partner Gateway。請參閱圖 8。按下一步
  8. 圖 9的「資料庫伺服器選擇」視窗中, 選取您打算使用的資料庫伺服器。您可以選取 DB2 8.2(或以上)Oracle 9i 9.2.0.4(或以上)。按下一步
    圖 9. 「資料庫選擇」視窗
  9. 會出現「資料庫資訊」視窗。若您選取 DB2 作為資料庫伺服器, 請遵循此程序中的 DB2 特定指示。 若您選取 Oracle 作為資料庫伺服器, 請遵循此程序中的 Oracle 特定指示。

    DB2

    如果您選取 DB2,則會出現「DB2 資料庫資訊」視窗。圖 10.

    如果執行 DB2 的電腦不是安裝在現行系統上,請輸入它的主機名稱, 將 localhost 換成內含 DB2 的系統名稱。

    欄位中, 輸入 DB2 實例所用的埠號。若要瞭解 DB2 實例使用哪一個埠, 請使用 DB2 控制中心 (GUI) 來判斷內容, 或在命令提示模式下輸入下列 DB2 配置指令: db2 get dbm cfg。資料庫載入器也會將此 DB2 配置資訊儲存在 system temp/bcgdbloader/logs 目錄中。預設埠是 50000。

    擁有者名稱擁有者密碼資料庫名稱綱目名稱欄位中, 分別輸入擁有者名稱、擁有者的密碼、資料庫名稱和實例名稱。這些是資料庫載入器安裝時用來定義資料庫的名稱。 請參閱建立資料庫

    下一步

    圖 10. 「DB2 資訊」視窗

    Oracle:

    如果您選取 Oracle,會出現「資料庫資訊」視窗; 相關說明請參閱圖 11

    輸入關於 Oracle 資料庫的必要資訊。 預設埠是 1521。

    JDBC 驅動程式的完整路徑和名稱必須指向此電腦上驅動程式的正確版本。 可在 Oracle 安裝目錄中找到此驅動程式。

    它也可以從 http://www.oracle.com/technology/software/tech/java/sqlj_jdbc/index.html 下載。在「JDBC 驅動程式下載」區段, 按一下 Oracle xxx 驅動程式。務必選取符合您要執行之 Oracle xx 版的驅動程式版本。

    註:
    瀏覽選取目錄時,請在選取所要的安裝路徑之後, 在輸入檔案名稱欄位中輸入一個 "."。 若未輸入 ".",選取目錄視窗不會回到當初啟動它的視窗。

    下一步

    圖 11. 「Oracle 資料庫資訊」視窗

    會出現「資料庫連線確認」視窗。請參閱圖 12。若連線成功, 請記下及確認「表格」、「概略表」、「函數」和「程序」計數資訊。 若連線失敗,請檢視資訊視窗中的指引,或參閱您的資料庫文件, 以處理錯誤碼。

    圖 12. 「資料庫連線確認」視窗
  10. 在「使用者資訊」視窗中,輸入負責安裝之管理者的使用者名稱、密碼和群組名稱。 按下一步
    註:
    此資訊必須符合「資料庫載入器」安裝中使用的資訊。
  11. 在「共通資訊目錄」視窗中,輸入元件共用的共通資訊位置。按下一步
    註:
    瀏覽選取目錄時,請在選取所要的安裝路徑之後, 在輸入檔案名稱欄位中輸入一個 "."。 若未輸入 ".",選取目錄視窗不會回到當初啟動它的視窗。
  12. 圖 13 的 WebSphere MQ Server 視窗中,輸入執行 WebSphere MQ 的電腦主機名稱(如果尚未安裝在相同電腦中的話)。若不使用預設名稱, 請務必變更佇列管理程式的名稱。

    主機名稱欄位中,如果 WebSphere MQ 不在現行機器上,請將 localhost 換成內含 WebSphere MQ 的系統名稱。

    佇列管理程式欄位中, 將預設名稱換成配置 WebSphere MQ 時使用的名稱(請參閱配置 WebSphere MQ中的步驟 2)。

    接聽器埠欄位中, 輸入接聽器使用的埠(請參閱配置 WebSphere MQ)。預設埠為 9999

    下一步

    圖 13. WebSphere MQ Server 視窗
  13. 若您已選取要安裝「社群主控台」,請使用「社群主控台」配置視窗來進行配置。請參閱圖 14

    使用者名稱欄位中,輸入「社群主控台」元件用來登入資料庫的使用者 ID。

    密碼欄位中,輸入與使用者名稱相關聯的密碼。 請確定您輸入正確的密碼,因為「社群主控台」無法在不正確的密碼下運作。

    HTTP 埠欄位中,輸入元件用來接聽訊息的埠名稱。「社群主控台」、「接收端」和「文件管理程式」必須有唯一的埠號, 且這些埠號必須是此電腦上可用的埠號。預設埠為 58080

    HTTPS 埠欄位中,輸入元件用來接聽訊息的安全埠名稱。「社群主控台」、「接收端」和「文件管理程式」必須有唯一的埠號, 且這些埠號必須是此電腦上可用的埠號。預設埠為 58443

    下一步

    註:
    若資料庫連線失敗,會出現「資料庫資訊」視窗。請檢視資訊視窗中的指引, 或參閱資料庫文件來處理錯誤碼。
    圖 14. 「社群主控台配置」視窗
  14. 若您已選取「接收端」或「文件管理程式」元件, 請使用其配置視窗來進行配置。這些視窗的欄位與「社群主控台配置」視窗相同。這三個元件(「社群主控台」、「接收端」和「文件管理程式」)都必須有不同的 HTTP 和 HTTPS 埠。請參閱第 圖 15 頁中的圖 圖 15圖 16
    註:
    若您在不同機器上安裝「接收端」和「文件管理程式」, 則「接收端」機器必須有一個可讓「文件管理程式」機器解析的主機名稱。
    圖 15. 「接收端配置」視窗
    圖 16. 「文件管理程式配置」視窗
  15. 圖 17 的「RosettaNet 配置」視窗中, 輸入 RosettaNet 訊息的聯絡資訊。若您不知道適當的值,請使用必要的預設值。 若您使用 RosettaNet,則此資訊是必要的,且建議使用於所有安裝。

    名稱欄位中,輸入有 RosettaNet 問題時要聯絡的聯絡人名稱。

    電話號碼傳真號碼欄位中, 輸入 RosettaNet 聯絡人的電話號碼和傳真號碼。

    電子郵件位址欄位中,輸入 RosettaNet 聯絡人的電子郵件位址。

    下一步

    圖 17. 「RosettaNet 配置」視窗
  16. 圖 18 的「警示通知」視窗中, 配置 WebSphere Partner Gateway,使它可以透過電子郵件傳送警示。這些值是必要的。若您不知道適當的值,請使用預設值。

    SMTP 傳遞欄位中,輸入不在此電腦上執行的 SMTP 主機名稱。

    寄件者電子郵件位址欄位中,輸入 WebSphere Partner Gateway 用來傳送電子郵件的電子郵件位址。

    收件者電子郵件位址欄位中, 輸入使用者在回應警示通知時,用來傳送回應電子郵件的目的地電子郵件位址。

    下一步

    圖 18. 「警示通知」視窗
  17. 在「摘要」視窗中檢視資訊,以瞭解所要安裝的元件。若此資訊不正確, 請按上一步回到上一視窗。當摘要視窗中的所有資訊皆無誤時, 請按下一步
  18. WebSphere Partner Gateway 安裝程式會安裝及配置已選取的元件。當安裝程式完成這項作業時, 它會啟用完成按鈕。按一下完成

在您要安裝 WebSphere Partner Gateway 元件的每一個伺服器上重複此程序。 共通內容只需要安裝一次,因為它是透過共用檔案系統供給所有電腦使用。

當您安裝所有 WebSphere Partner Gateway 元件之後, 請參閱啟動 WebSphere Partner Gateway

Copyright IBM Corp. 2003, 2005