WebSphere WebSphere Enterprise Service Bus V6.0.1 操作系统: AIX, HP-UX, Linux, Solaris, Windows

Message Service Client 入门

本『入门』指南描述了在对 IBM® WebSphere® Enterprise Service Bus(ESB) 安装 Message Service Client 时需要了解的信息。

本指南提供了有关下列 Message Service Client 的信息:

本指南默认您已经打开了 WebSphere ESB 的启动板。

WebSphere ESB 安装

在对 WebSphere ESB 安装 Message Service Client 之前,您必须:

  • 确保系统满足所有硬件和软件需求。请参阅 http://www.ibm.com/software/integration/wsesb/sysreqs
  • 确保在 Linux 系统上以 root 用户的身份登录;或在 Windows 系统上以 Administrator 组成员的身份登录。
  • 如果要从 CD 中安装 Message Service Client,则应确保具有适用于您的平台的标有 IBM WebSphere Enterprise Service Bus CD2 的光盘。如果要从其他位置安装 Message Service Client,则确保您知道 CD2 光盘内容所在的位置。

安装 Message Service Client for C/C++

提供了两个安装选项,以便您可以选择是采用完整安装还是定制安装。

在开始之前

此任务默认您已经打开了启动板并准备开始安装。

执行此任务的目的和时间

要在 Linux 或 Windows 操作系统上安装 Message Service Client for C/C++,则应完成此过程。在安装设置过程中,随时都可以单击取消来停止安装过程。但要注意的是,在真正安装产品的过程中,取消选项是不可用的。

完成此任务需要执行的步骤

  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++ 的自述文件,选择查看自述文件,然后单击下一步

  10. 单击完成以关闭安装向导。

结果

现在,您已经成功安装了 Message Service Client for C/C++

下一步做什么?

要对 Message Service Client for C/C++ 应用程序使用受管 JMS 对象,必须安装 JNDILookup Web Service,它允许非 Java 客户机访问受管 JMS 对象。有关更多信息,请参阅安装 JNDILookup Web Service 应用程序。您还必须安装和配置 Web Services Client for C++,它是将 JNDILookup Web Service 与 Message Service Client for C/C++ 配合使用的先决条件。

还必须安装并配置 Web Services Client for C++,以便在 Message Service Client for C/C++ 应用程序中使用它。

安装 Message Service Client for .NET

安装向导提供了两个安装选项,以便您可以选择是采用完整安装还是定制安装。

在开始之前

此任务默认您已经打开了启动板并准备开始安装。

执行此任务的目的和时间

要在 Windows 操作系统上安装 Message Service Client for .NET,应遵循此过程。

完成此任务需要执行的步骤

  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 Service,它允许非 Java 客户机访问受管 JMS 对象。有关更多信息,请参阅安装 JNDILookup Web Service 应用程序

安装 Web Services Client for C++

使用安装向导进行安装

当使用安装向导来安装 Web Services Client for C++ 时,提供了两个安装选项,以便您可以选择是采用完整安装还是定制安装。

在开始之前

在开始完成此任务之前,应确保已经满足了要执行安装的平台上需要的所有先决条件,以便您对要用来安装该产品的位置具有写访问权。此任务默认您已经打开了启动板并准备开始安装。

执行此任务的目的和时间

要在 Linux 或 Windows 操作系统上安装 Web Services Client for C++,应完成下列步骤。

完成此任务需要执行的步骤

  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 文件以便与您的安装相匹配。

在 Windows 上,axiscpp.conf 文件位于 <inst_dir> 中;而在 Unix 上,它位于 <inst_dir>/etc 中,它所在的位置随平台不同而不同。

以下代码显示所提供的缺省模板配置文件。注意,此文件中的路径名随平台不同而不同。

# The comment character is '#'
# Available directives are as follows
#
# ClientWSDDFilePath:  The path to the client WSDD
# SecureInfo:          The GSKit security information
#

如果您正在将处理程序与 Web Service 客户机应用程序配合使用,或者您在使用 SSL 来保护 Web Service 通信,则只需更改此文件。如果您未添加处理程序或 SSL,则不需要更改此文件。

如果您正在使用 axiscpp.conf 配置文件,则必须创建一个环境变量,用来将 axiscpp.conf 所在的位置提供给 AxisClient 库。无论在哪个平台上,此变量都称为 AXISCPP_DEPLOY

要在安装 Web Services Client for C++ 之后对它进行配置,请完成下列步骤。

完成此任务需要执行的步骤

  1. 如果您要添加处理程序或 SSL,则按开发和使用客户机端处理程序保护 Web Service 通信中所描述那样配置 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 库的完整目录路径添加至路径或库路径环境变量,如下所示:
    • LINUX platforms 在 Linux 平台上: export LD_LIBRARY_PATH=$LD_LIBRARY_PATH :<inst_dir>/lib
    • For Windows platforms 在 Windows 平台上: path=%path%;<inst_dir>\bin
  4. 根据您所使用的操作系统,将包含 XML4C 库的完整目录路径添加至路径或库路径环境变量,如下所示:
    • 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 Service 应用程序了。

静默安装 Message Service Client

除了使用安装向导来安装 Message Service Client 之外,还可以通过使用响应文件以交互方式来安装它。这是一个简单的文本文件,它包含安装程序所需要的信息。不会显示图形用户界面,安装程序将从您提供的文件中读取响应。

更新、局限性和已知问题

在 IBM 软件支持 Web 站点(网址为:http://www.ibm.com/software/integration/wsesb/support)上,以技术说明的形式记录了有关 WebSphere ESB(包括 Message Service Client)的更新、局限性和已知问题。

商标

IBM 和 WebSphere 是 IBM Corporation 的商标。

Microsoft、Windows、Windows NT 和 Windows 徽标是 Microsoft Corporation 在美国和/或其他国家或地区的商标。

Linux 是 Linus Torvalds 在美国和/或其他国家或地区的商标。

UNIX 是 The Open Group 在美国和其他国家或地区的注册商标。

其他公司、产品和服务名称可能是其他公司的商标或服务标记。


概念主题

使用条款 | 评价此页

Timestamp icon上次更新时间: 3 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, 2006. All Rights Reserved.
本信息中心基于 Eclipse 技术(http://www.eclipse.org)。