WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 作業系統: AIX, HP-UX, Linux, Solaris, Windows

Message Service Client 入門

本入門手冊說明當 Message Service Client 隨 IBM® WebSphere® Enterprise Service Bus (ESB) 一起安裝時,您必須知道的資訊。

本手冊提供下列 Message Service Client 的相關資訊:

本手冊假設您已開啟 WebSphere ESB 的啟動程式。

WebSphere ESB 安裝

在您隨 WebSphere ESB 一起安裝 Message Service Client 時,您必須:

  • 確定您的系統符合所有的軟硬體需求。請參閱http://www.ibm.com/software/integration/wsesb/sysreqs
  • 確定您是以 root 身分(若為 Linux 系統)或管理者群組中的成員身分(若為 Windows 系統)登入。
  • 如果您是從 CD 來安裝 Message Service Client,請確定您具有適合您平台且標籤為 IBM WebSphere Enterprise Service Bus CD2 的光碟。如果您是從另一位置來安裝 Message Service Client, 請確定您知道 CD2 內容的位置。

安裝 Message Service Client for C/C++

您有兩個安裝選項可選, 因此您可選擇完整或自訂安裝。

開始之前

這項作業會假設您已開啟啟動程式,並已準備繼續進行安裝。

執行這項作業的原因和時機

若要將 Message Service Client for C/C++ 安裝在 Linux 或 Windows 上, 請按照本程序進行。在安裝程序期間,您隨時可以按一下取消,來停止安裝程序, 但要注意的是,在真正開始安裝產品期間,取消選項將無法使用。

這項作業的步驟

  1. 使用啟動程式開啟安裝精靈。您可以選取下列選項來開啟精靈:
    1. 在「歡迎使用」頁面上,按一下安裝 Message Service Client
    2. 在「安裝 Message Service Client」頁面上, 按一下 IBM Message Service Client for C/C++
    3. 在「IBM Message Service Client for C/C++ 安裝」頁面上, 按一下啟動 Message Service Client for C/C++ 安裝精靈

    可能會提示您輸入適合您平台且標籤為 CD2 之光碟的位置。如果您有光碟,請將它插入光碟機中,並按一下確定。如果您是從另一位置來安裝, 請輸入 CD2 內容的位置,並按一下確定。請注意, 如果您是從 CD1 和 CD2 內容位於同層級子目錄的位置來安裝,則不會出現這個提示畫面。

    安裝精靈會顯示下列訊息:
    歡迎使用 IBM Message Service Client for C/C++ 安裝精靈
  2. 下一步

    安裝精靈會要求您閱讀授權合約。

  3. 如果您接受授權合約中的條款,請按一下我接受授權合約中的條款, 並按下一步

    安裝精靈會詢問您 Message Service Client for C/C++ 的安裝位置。

  4. 若要將 Message Service Client for C/C++ 安裝在系統建議的目錄中, 請按下一步 如果您不想將 Message Service Client for C/C++ 安裝在系統建議的目錄中, 請選擇另一個目錄。如果您選擇將 Message Service Client for C/C++ 安裝在目前不存在的目錄中, 安裝精靈會為您建立該目錄。

    安裝精靈會要求您選擇最適合您需求的安裝類型。

  5. 選取您要的安裝類型:
    • 若要安裝所有的程式特性,請按一下完整
    • 若要選擇您想安裝的特性,請按一下自訂
  6. 下一步

    如果您選取「完整安裝」選項, 安裝精靈會顯示您所選安裝選項的詳細資料,您可按照步驟 8 中的說明來繼續進行。如果您選取「自訂安裝」選項, 安裝精靈會詢問您您想安裝的特性,您必須先完成步驟 7, 然後再繼續步驟 8

  7. 僅適用於自訂安裝:選取您想安裝的 Message Service Client for C/C++ 特性, 然後按下一步

    如果您想開發 Message Service Client for C/C++ 應用程式, 請確定您已選取開發工具和範例特性。此特性會提供範例應用程式, 以及編譯 C 和 C++ 應用程式所需的程式庫和標頭檔。如果您沒有選取這項特性, 則只會安裝執行 Message Service Client for C/C++ 應用程式所需的檔案。

    安裝精靈會顯示您所選安裝選項的詳細資料。

  8. 當您滿意所選的安裝選項時, 請按下一步,開始安裝。 請注意,一旦開始安裝,取消即無法使用。
    安裝精靈會顯示安裝進度列。請靜待進度列的完成。當安裝順利完成時,精靈會顯示下列訊息:
    安裝精靈已順利安裝 IBM Message Service
    Client for C/C++。請選取「完成」來結束精靈。
  9. 下一步

    如果您想檢視 Message Service Client for C/C++ Readme 檔, 請選取檢視 Readme,然後按下一步

  10. 按一下完成,關閉安裝精靈。

結果

您已順利安裝 Message Service Client for C/C++

下一步

若要在 Message Service Client for C/C++ 應用程式中搭配使用受管理 JMS 物件, 則必須安裝「JNDILookup Web 服務」,以便讓非 Java 用戶端能夠存取受管理 JMS 物件。如果需要進一步資訊, 請參閱安裝「JNDILookup Web 服務」應用程式。您也必須安裝和配置 Web Services Client for C++, 這是您在 Message Service Client for C/C++ 中搭配使用「JNDILookup Web 服務」時的一項必備條件。

您也必須安裝和配置 Web Services Client for C++,才能在 Message Service Client for C/C++ 應用程式中使用。

安裝 Message Service Client for .NET

安裝精靈提供兩個安裝選項, 因此您可選擇完整或自訂安裝。

開始之前

這項作業會假設您已開啟啟動程式,並已準備繼續進行安裝。

執行這項作業的原因和時機

若要將 Message Service Client for .NET 安裝在 Windows 上, 請按照本程序進行。

這項作業的步驟

  1. 使用啟動程式開啟安裝精靈。您可以選取下列選項來開啟精靈:
    1. 在「歡迎使用」頁面上,按一下安裝 Message Service Client
    2. 在「安裝 Message Service Client」頁面上, 按一下 IBM Message Service Client for .NET
    3. 在「IBM Message Service Client for .NET 安裝」頁面上, 按一下啟動 Message Service Client for .NET 安裝精靈

    可能會提示您輸入適合您平台且標籤為 CD2 之光碟的位置。如果您有光碟,請將它插入光碟機中,並按一下確定。如果您是從另一位置來安裝, 請輸入 CD2 內容的位置,並按一下確定。請注意, 如果您是從 CD1 和 CD2 內容位於同層級子目錄的位置來安裝,則不會出現這個提示畫面。

    安裝精靈會顯示下列訊息:
    歡迎使用 IBM Message Service Client for .NET 安裝精靈
  2. 下一步

    安裝精靈會要求您閱讀授權合約。

  3. 如果您接受授權合約中的條款,請按一下我接受授權合約中的條款, 並按下一步

    安裝精靈會要求您選擇最適合您需求的安裝類型。

  4. 選取您要的安裝類型:
    • 若要安裝所有的程式特性,請將它們安裝在預設安裝目錄,並按一下完整
    • 若要選擇您想安裝的特性,並指定其安裝位置,請按一下自訂
  5. 下一步

    如果您選取「完整安裝」選項, 安裝精靈會告訴您已可以按照步驟 8 中的說明開始安裝。如果您選取「自訂安裝」選項, 安裝精靈會要求您選取您想安裝的特性,而您必須先完成步驟 6 和步驟 7, 然後再繼續步驟 8

  6. 僅適用於自訂安裝:請按一下特性清單中的圖示, 以指定您要如何安裝 Message Service Client for .NET 特性的任何變更。如果您不想將 Message Service Client for .NET 安裝在系統建議的目錄中, 請選擇另一個目錄。

    如果您選擇將 Message Service Client for .NET 安裝在目前不存在的目錄中, 安裝精靈會為您建立該目錄。

    如果您想開發 XMS 應用程式, 請確定您已選取開發工具和範例特性。此特性會提供範例應用程式, 以及編譯 .NET 應用程式所需的程式庫和其他任何檔案。如果您沒有選取這項特性, 則只會安裝執行 XMS 應用程式所需的檔案。

  7. 如果您使用「自訂安裝」選項,在您按照步驟 6 中的說明選取您要的選項後, 請按下一步

    安裝精靈會告訴您已可以開始安裝。

  8. 按一下安裝,開始安裝。
    安裝精靈會顯示安裝進度列。請靜待進度列的完成。當安裝順利完成時, 視窗中會顯示下列訊息:
    安裝精靈已順利安裝 IBM Message Service
    Client for .NET。請按一下「完成」以結束精靈。
  9. 按一下完成,關閉安裝精靈。

結果

您已順利安裝 Message Service Client for .NET

下一步

若要在 Message Service Client for .NET 應用程式中搭配使用受管理 JMS 物件, 則必須安裝「JNDILookup Web 服務」,以便讓非 Java 用戶端能夠存取受管理 JMS 物件。如果需要進一步資訊, 請參閱安裝「JNDILookup Web 服務」應用程式

安裝 Web Services Client for C++

使用安裝精靈來安裝

當您使用安裝精靈來安裝 Web Services Client for C++ 時, 會提供兩個安裝選項讓您選擇要進行完整或自訂安裝。

開始之前

在您開始進行這項作業之前,請確定您已符合執行安裝所在之平台的所有必備條件, 且您對產品的安裝位置具備寫入權。這項作業會假設您已開啟啟動程式,並已準備繼續進行安裝。

執行這項作業的原因和時機

若要將 Web Services Client for C++ 安裝在 Linux 或 Windows 上, 請完成下列步驟。

這項作業的步驟

  1. 使用啟動程式開啟安裝精靈。您可以選取下列選項來開啟精靈:
    1. 在「歡迎使用」頁面上,按一下安裝 Message Service Client
    2. 在「安裝 Message Service Client」頁面上,按一下 IBM Web Services Client for C++
    3. 在「IBM Web Services Client for C++ 安裝」頁面上,按一下啟動 Web Services Client for C++ 安裝精靈

    可能會提示您輸入適合您平台且標籤為 CD2 之光碟的位置。如果您有光碟,請將它插入光碟機中,並按一下確定。如果您是從另一位置來安裝, 請輸入 CD2 內容的位置,並按一下確定。請注意, 如果您是從 CD1 和 CD2 內容位於同層級子目錄的位置來安裝,則不會出現這個提示畫面。

    此時會開啟安裝精靈,並顯示下列訊息:

    歡迎使用 Web Services Client for C++ 安裝精靈

  2. 下一步

    精靈會要求您閱讀授權合約。

  3. 如果您接受授權合約中的條款,請按一下我接受授權合約中的條款, 並按下一步

    精靈會詢問您用戶端的安裝位置。如果您不想將用戶端安裝在系統建議的目錄中, 可選擇另一個目錄。如果您選擇將用戶端安裝在目前不存在的目錄中, 精靈會為您建立該目錄。

  4. 下一步

    精靈會要求您選擇最適合您需求的安裝類型。請選擇下列選項之一:

    • 若要安裝所有的程式特性,請選取完整
    • 若要選擇您想安裝的程式特性,以及所要的安裝位置,請選取自訂
  5. 下一步
  6. 如果您選取「自訂安裝」選項,請選取您想安裝的特性,可以是下列任何或所有選項:
    • 執行時期
    • 工具
    • 文件
    • 範例
  7. 下一步

    精靈會顯示您要安裝之項目的相關詳細資料。

  8. 當您要繼續進行安裝時,請按一下安裝

    精靈會顯示安裝進度列。請靜待進度列的完成。當安裝順利完成時,精靈會顯示下列訊息:

    安裝精靈已順利安裝 IBM Web Services Client for C++。請選擇「完成」, 結束精靈。
  9. 按一下完成,關閉精靈。

結果

您已順利安裝 Web Services Client for C++。有關您下一步可能需要執行的後置安裝配置說明, 請參閱安裝後的配置

安裝後配置 Web Services Client for C++

執行這項作業的原因和時機

在安裝完成後,您可能需要配置 axiscpp.conf 檔以符合您的安裝環境。

視平台而定, axiscpp.conf 檔位於 <inst_dir>(若為 Windows)或 <inst_dir>/etc (若為 UNIX)中。

下列程式碼顯示系統提供的預設範本配置檔。請注意, 這個檔案中的路徑名稱會因平台而異。

# 備註字元為 '#'
# 可用的指引如下
#
# ClientWSDDFilePath:  用戶端 WSDD 的路徑
# SecureInfo:          GSKit 安全資訊
#

只有在您於 Web 服務用戶端應用程式中使用處理常式時, 或者您使用 SSL 來保護您的 Web 服務通訊時, 才需變更這個檔案。如果您沒有新增處理常式或 SSL,則不需變更這個檔案。

如果您使用 axiscpp.conf 配置檔, 則必須建立一個環境變數, 以提供 axiscpp.conf 位置給 AxisClient 程式庫。不論何種平台,此變數名稱都是 AXISCPP_DEPLOY

若要進行 Web Services Client for C++ 的後置安裝配置, 請完成下列步驟。

這項作業的步驟

  1. 如果您有新增處理常式或 SSL, 請按照資訊中心中的開發和使用用戶端處理常式保護 Web 服務通訊安全中的說明, 來配置 axiscpp.conf 檔。
  2. 如果您使用 axiscpp.conf,請將 AXISCPP_DEPLOY 的值設為 <inst_dir> 例如:
    • UNIX platforms UNIX® 平台: export AXISCPP_DEPLOY = <inst_dir>
    • For Windows platforms Windows 平台: set AXISCPP_DEPLOY = <inst_dir>
  3. 在建立 AXISCPP_DEPLOY 後,視作業系統而定, 按如下所示,將內含 AxisClient 程式庫的完整目錄路徑新增至 PATH 或 LIBRARY PATH 環境變數:
    • LINUX platforms Linux 平台: export LD_LIBRARY_PATH=$LD_LIBRARY_PATH :<inst_dir>/lib
    • For Windows platforms Windows 平台: path=%path%;<inst_dir>\bin
  4. 視作業系統而定, 按如下所示,將內含 XML4C 程式庫的完整目錄路徑新增至 PATH 或 LIBRARY PATH 環境變數:
    • LINUX platforms Linux 平台: export LD_LIBRARY_PATH=$LD_LIBRARY_PATH :<inst_dir>/prereqs/XML4C
    • For Windows platforms Windows 平台: path=%path%;<inst_dir>\prereqs\XML4C

下一步

現在,您已可準備開發和部署 Web 服務應用程式。

Message Service Client 的無聲自動安裝

您可以不使用安裝精靈,而改用回應檔以互動方式來安裝 Message Service Client 。這是一個簡單的文字檔, 內含安裝程式所需的資訊。安裝程式不會顯示圖形式使用者介面, 而會從您提供的檔案中讀取您的回應。

更新、限制和已知的問題

WebSphere ESB(包含 Message Service Client)的更新、 限制和已知問題,會以 TechNotes 形式記述在「IBM 軟體支援中心」網站 (http://www.ibm.com/software/integration/wsesb/support)。

商標

IBM 和 WebSphere 是 IBM Corporation 的商標。

Microsoft、Windows、Windows NT 及 Windows 標誌是 Microsoft Corporation 在美國及/或其他國家或地區的商標或註冊商標。

Linux 是 Linux Torvalds 公司在美國及/或其他國家或地區的商標。

UNIX 是 The Open Group 在美國及其他國家或地區的註冊商標。

其他公司、產品和服務名稱,可能是其他公司的商標或服務標記。


Concept topic

使用條款 | 評比此網頁

「時間戳記」圖示前次更新: 5 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.websphere.wesb.doc.nl1_6.0.1\clients\GettingStarted.html

(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)