安裝配接器

安裝概觀中的程序化概觀有指出的話, 請遵循下列其中一節的指示來安裝配接器:

請注意,在 UNIX 平台上,檔案名稱有區分大小寫。如果您變更任何檔案名稱的大小寫, 配接器就會在啟動期間失敗並記載錯誤。如果您在試圖啟動配接器時收到錯誤, 請檢查「連接器配置程式」儲存庫中的 XSD 檔案名稱。 XSD 檔案的副檔名必須是小寫的 .xsd。例如,Customer.XSD 檔案名稱會造成配接器失敗。在此狀況下,您必須將檔案名稱變更為 Customer.xsd

使用圖形式安裝程式來安裝配接器

執行下列動作以使用圖形式安裝程式來安裝配接器:

  1. 依照呼叫圖形式 WBIA 安裝程式中的說明,呼叫配接器的「安裝程式」。
  2. 在語言選擇提示畫面中,從下拉功能表中選擇所需的語言,並按一下確定
  3. 在「歡迎使用」畫面中,按下一步
    註:
    如果使用 java -jar setup.jar 指令來啟動安裝程式,則安裝程式需要 Java Runtime Environment (JRE) 1.4 或更高版本。若不符合此條件,安裝程式就會顯示錯誤訊息,指示您安裝 JRE 1.4 或更高版本,然後重新啟動安裝程式。按一下取消並安裝或升級 JRE。
  4. 在「IBM 授權合約接受畫面」中,按一下我接受授權合約中的條款, 然後按一下確定
    註:
    此時「安裝程式」會檢查系統是否有特定軟體需求。 如果找不到必備項目,「安裝程式」就會顯示畫面來通知您, 並指出必須安裝該項目,或必須輸入項目所在的目錄,才能繼續安裝配接器。安裝或瀏覽至所需軟體的位置,並重新啟動「WebSphere Business Integration Adapters 安裝程式」。
  5. 產品目錄畫面可讓您指定要安裝配接器的位置。配接器安裝程式會嘗試尋找 Adapter Framework 的安裝位置;如果找到了,就會依預設顯示此路徑。 如果找不到,就會顯示下列預設值:Windows 為 C:\IBM\WebSphereAdapters,UNIX 則為 /opt/IBM/WebSphereAdapters

    您可以指定另一個目錄,但它必須包含安裝的 Adapter Framework 相容版本。

    如需安裝 Adapter Framework 的相關資訊, 請參閱安裝配接器架構。 如需安裝 WebSphere InterChange Server 的詳細資訊,請參閱

    在產品目錄畫面中,執行下列其中一項作業:

  6. 摘要畫面列示將要安裝的功能、指定的產品目錄,及所需的磁碟空間量。 請讀取該資訊來進行驗證,然後按下一步
  7. 在分配管理系統名稱畫面上,依整合分配管理系統, 執行下列其中一個作業:
  8. 若您正於 Windows 電腦上進行安裝,「安裝程式」會顯示「選取程式資料夾」 畫面。 於程式群組欄位中,鍵入要建立 配接器捷徑的程式群組名稱,或接受預設程式群組,然後按下一步
  9. 「安裝程式」順利完成之後,按一下完成

註:
如果您的整合分配管理系統為 ICS 並且其已安裝於遠端系統上, 則您必須將配接器的配置檔移到 ICS 系統。如此做了以後, 可以使得遠端 ICS 機器上的「連接器配置程式」有可用的配接器配置檔。 若要找到配接器配置檔,請參閱您的配接器使用手冊上的安裝檔案結構表格。配置檔一般命名為 <配接器名稱> ConnectorTemplate。然後將這個檔案移到您將要於 ICS 主機上執行的「連接器配置程式」之目錄。有關 ICS 和「連接器配置程式」的安裝檔案結構資訊, 請參閱適用於您的平台之系統安裝手冊。如果您沒有使用 ICS 整合分配管理系統, 或是您的 ICS 分配管理系統與配接器安置於同一部機器, 則您不需要傳送配接器配置檔。

在 Windows 系統上自動安裝配接器

執行下列動作來在 Windows 上執行配接器自動安裝:

  1. 依照準備安裝回應檔中的說明, 使用表 3中您要使用的選項來準備安裝配接器的回應檔。
    表 3. Windows 系統之配接器的自動安裝選項
    選項名稱 選項值
    -W destination.path

    將此選項設定為要安裝 WebSphere Business Integration Adapters 產品的目錄路徑。 例如,

    -W destination.path=』C:\IBM\WebSphereAdapters』

    安裝路徑不能包含任何空格。此安裝位置必須包含配接器架構的相容版本。

    -W inputServer.name

    如果您的分配管理系統為 IBM WebSphere InterChange Server,請指定有效的 InterChange 伺服器名稱。此名稱必須符合下列準則:1. 小於 80 個字元。 2. 不能包含空格。3. 必須以英文字母字元開頭 (a-z,A-Z)。4. 必須只能包含英文字母及數值字元。

    如果您未將 WebSphere Interchange Server 作為分配管理系統,請註銷此選項。

    -W inputShortcuts.folder

    將此選項設定為針對 WBIA 產品建立的程式群組名稱,例如 IBM WebSphere Business Integration Adapters

    -W inputServer.adapterService

    如果您要將配接器登錄為 Windows 服務,請將此選項設定為 yes。 如果您不要將配接器登錄為 Windows 服務,請將此選項設定為 no

    -G createDirectoryResponse= 如果它尚未存在, 則以設定此選項 () 來指定是否要建立目標目錄。
    -G replaceExistingResponse

    將此選項設定為 yesToAllyes,取代系統上所有與 安裝程式複製之檔案同名的檔案。

    將此選項設定為 noToAllno,不取代系統上任何與安裝程式所複製 之檔案同名的檔案。

    -G replaceNewerResponses

    將此選項設定為 yesToAllyes,以取代系統上 所有比安裝程式所複製之檔案還要新的檔案。

    將此選項設定為 noToAllno,不取代系統上任何比安裝程式 所複製之檔案還要新的檔案。

    -G removeExistingResponse

    此選項可指定是否要移除系統上的回應檔。請注意,此選項僅供解除安裝。 將此選項設定為 yestoallyes,以移除現有的回應檔。 將它設為 notoallno,以保留系統上的現有檔案。

    -G removeModifiedResponse

    此選項可指定是否要移除在上次安裝之後修改的回應檔。請注意,此選項僅供解除安裝。 將此選項設定為 yestoallyes,以移除已修改的回應檔。 將它設為 notoallno,以保留系統上已修改的檔案。

  2. 依照執行自動安裝中的說明,使用1 步驟中準備的回應檔來執行自動安裝。

在 UNIX 和 Linux 系統上自動安裝配接器

執行下列動作來在 Windows 上執行配接器自動安裝:

  1. 依照準備安裝回應檔中的說明, 使用表 3中您要使用的選項來準備安裝配接器的回應檔。
    表 4. UNIX 和 Linux 的配接器的自動安裝選項
    選項名稱 選項值
    -W destination.path

    將此選項設定為要安裝 WebSphere Business Integration Adapters 產品的目錄路徑。 例如,

    -W destination.path=』C:\IBM\WebSphereAdapters』

    安裝路徑不能包含任何空格。此安裝位置必須包含配接器架構的相容版本。

    -W inputServer.name

    如果您的分配管理系統為 IBM WebSphere InterChange Server,請指定有效的 InterChange 伺服器名稱。此名稱必須符合下列準則:1. 小於 80 個字元。 2. 不能包含空格。3. 必須以英文字母字元開頭 (a-z,A-Z)。4. 必須只能包含英文字母及數值字元。

    如果您未將 WebSphere Interchange Server 作為分配管理系統,請註銷此選項。

    -G createDirectoryResponse= 如果它尚未存在, 則以設定此選項 () 來指定是否要建立目標目錄。
    -G replaceExistingResponse

    將此選項設定為 yesToAllyes,取代系統上所有與 安裝程式複製之檔案同名的檔案。

    將此選項設定為 noToAllno,不取代系統上任何與安裝程式所複製 之檔案同名的檔案。

    -G replaceNewerResponses

    將此選項設定為 yesToAllyes,以取代系統上 所有比安裝程式所複製之檔案還要新的檔案。

    將此選項設定為 noToAllno,不取代系統上任何比安裝程式 所複製之檔案還要新的檔案。

    -G removeExistingResponse

    此選項可指定是否要移除系統上的回應檔。請注意,此選項僅供解除安裝。 將此選項設定為 yestoallyes,以移除現有的回應檔。 將它設為 notoallno,以保留系統上的現有檔案。

    -G removeModifiedResponse

    此選項可指定是否要移除在上次安裝之後修改的回應檔。請注意,此選項僅供解除安裝。 將此選項設定為 yestoallyes,以移除已修改的回應檔。 將它設為 notoallno,以保留系統上已修改的檔案。

  2. 依照執行自動安裝中的說明,使用1 步驟中準備的回應檔來執行自動安裝。

記錄安裝作業選項

您可以使用從指令行呼叫安裝程式時的特殊選項,將安裝作業選項記錄到檔案中。 安裝完成時,安裝作業選項就會記錄到您在指令行中指定的檔案。 您可以將這個檔案中的記錄安裝資訊,作為安裝設定的記錄以及在其他機器上自動安裝的回應檔。

若要建立此檔案,請在指令行中輸入下列指令:

<installation launcher executable> -options-record <filename>

例如,在指令視窗中輸入下列指令,以記錄 Windows 電腦上的配接器安裝之安裝作業選項:

setupwin32.exe -options-record C:\data\settings.txt

Copyright IBM Corp. 2003, 2005