跳到主要内容

安装SolOpenMAMA组件

要使用 SolOpenMAMA，必须安装并配置以下组件：

  • Saydo PubSub+事件代理
  • 客户端系统
  • 最后值消息缓存

Saydo PubSub+事件代理​

为了让客户端应用程序能够通过 Saydo PubSub+ 发布和/或接收 OpenMAMA 消息，事件代理必须网络可达，并正确配置以处理消息客户端。

要专门使用事件代理进行 OpenMAMA 消息传递，必须满足以下额外要求：

  • 必须使用 Saydo PubSub+ 7.1 或更高版本
  • 需要 Saydo 提供的产品密钥才能使用 OpenMAMA 传输服务
  • 需要 Saydo 提供的产品密钥才能使用 PubSub+ 缓存设施 如果 Saydo 没有预先在事件代理上输入所需的产品密钥，则必须手动在事件代理上输入 Saydo 提供的有效产品密钥。有关产品密钥的帮助，请联系 Solace。

客户端系统​

为了让客户端应用程序能够通过 Solace PubSub+ 发布和/或接收 OpenMAMA 消息，必须满足以下要求：

  • 安装 Solace 中间件和负载桥接（参阅安装 Solace 中间件和负载桥接）
  • 安装 OpenMAMA 和 OpenMAMDA API（参阅安装 OpenMAMA 和 OpenMAMDA API）
  • 安装 Solace C 消息 API（参阅安装 C 消息 API）
  • （可选）安装数据字典

安装Saydo中间件和负载桥接​

必须在以下系统上安装 Solace 中间件桥接和 Solace 负载桥接：

  • 每个托管 OpenMAMA 客户端应用程序的系统
  • 当要使用最后值缓存时，每个将托管 PubSub+ 缓存实例的 Linux 服务器

Solace 中间件桥接和 Solace 负载桥接包含在可从 Solace 安全文件传输协议（SFTP）服务器下载的单一归档文件（solopenmama_bridge_<supported_environment>_<releasenumber>.tar.gz）中。

为以下支持的环境提供了归档文件：

  • Windows 7（32 位和 64 位版本）
  • Windows 8（32 位和 64 位版本）
  • Windows Server 2008（32 位和 64 位版本）
  • Linux26-i386
  • Linux26-x86_64

这些归档文件可能包含您选择的特定环境的构建工件（例如，静态/动态库、优化/调试库等）。

要在托管 OpenMAMA 客户端应用程序或 PubSub+ 缓存实例的系统上安装 Solace 中间件桥接和 Solace 负载桥接，请执行以下步骤：

  1. 下载适用于适当系统环境的 SolOpenMAMA 桥接归档文件。
  2. 解压归档文件。
  3. 将 Solace 中间件桥接和负载桥接运行时库从 lib 目录复制到可以从其静态或动态链接的安装目录。

安装OpenMAMA和OpenMAMDA API​

必须在以下系统上安装标准的 OpenMAMA 和 OpenMAMDA API：

  • OpenMAMA 客户端应用程序，以便它们能够与 Solace 中间件和负载桥接交互。 根据客户端应用程序的特定需求以及托管该应用程序的系统的需要，可以安装 OpenMAMA 和 OpenMAMDA API 的原生 C 版本，或者 C++、Java 或 C# 包装器。

  • 每个将托管 PubSub+ 缓存实例的 Linux 系统 仅必须安装 OpenMAMA 和 OpenMAMDA API 的原生 C 版本。

OpenMAMA 和 OpenMAMDA API 由 OpenMAMA 项目维护并免费分发。它们不由 Solace 提供。要下载 OpenMAMA 和 OpenMAMDA API，请访问 openmama.org。

有关支持的 OpenMAMA 和 OpenMAMDA API 版本的信息，请参阅 Solace OpenMAMA 发行说明。

要将 OpenMAMA 和 OpenMAMDA API 安装到主机系统的公共安装目录，请按照下载的 OpenMAMA 归档文件提供的说明进行操作。

然后必须将获得的 API 配置为使用 Solace 中间件和负载桥接。mama.properties 文件用于这些配置（参阅配置 Solace OpenMAMA 桥接）。

安装C消息API​

必须在每个托管 OpenMAMA 客户端应用程序的系统上安装 Solace C API。C API 以归档文件的形式提供。

如果要使用 PubSub+ 缓存，则必须在每个将托管 PubSub+ 缓存实例的 Linux 系统上安装 C API。有关更多信息，请按照 PubSub+ 缓存安装包中包含的 README 文件中的步骤操作。

要在托管 OpenMAMA 客户端应用程序的系统上安装 C API，请执行以下步骤：

  1. 下载适用于适当系统环境的 C API 归档文件。 Solace C API 将驻留在与 Solace 中间件桥接和 Solace 负载桥接相同的主机上，因此，您下载的 C API 版本必须支持与 Solace 中间件桥接和 Solace 负载桥接相同的环境。有关 Solace 中间件桥接和 Solace 负载桥接支持的环境的更多信息，请参阅安装 Solace 中间件和负载桥接。

  2. 解压下载的归档文件。 不应使用或参考 ex 目录中包含的示例 C API 应用程序，因为所有与 C API 的应用程序交互都将通过 Solace 中间件和负载桥接进行。

  3. 将 C API 运行时库从 lib 目录复制到包含 OpenMAMA 和 OpenMAMDA API 的相同安装目录。

最后值消息缓存​

如果要使用 PubSub+ 缓存最后值缓存设施，则必须在每个将托管 PubSub+ 缓存实例的 64 位 Linux 系统上安装并正确配置以下组件：

  • Solace 中间件桥接（参阅安装 Solace 中间件和负载桥接）
  • Solace C API（参阅安装 C 消息 API）
  • OpenMAMA 和 OpenMAMDA API（参阅安装 OpenMAMA 和 OpenMAMDA API）
  • OpenMAMA 数据字典
  • PubSub+ 缓存实例软件
  • OpenMAMA 特定的 SolOpenMAMA 插件（参阅安装和配置 PubSub+ 缓存实例）

安装和配置PubSub+缓存实例​

PubSub+ 缓存实例由一个必须安装在独立 Linux 系统上的单一 PubSub+ 缓存进程和通过 Solace CLI 在事件代理上创建的相应 PubSub+ 缓存实例对象组成。

  • 要在独立 Linux 系统上安装 PubSub+ 缓存实例，请按照 PubSub+ 缓存安装包中包含的 README 文件中的步骤操作。

PubSub+ 缓存安装包可供下载。如果您无法访问此下载站点，请联系 Solace。

用于 OpenMAMA 消息缓存的 PubSub+ 缓存实例只能使用 PubSub+ 缓存实例软件的调试和优化 64 位 Linux 版本。

  • 要在事件代理上配置相应的 PubSub+ 缓存实例，请参阅配置 PubSub+ 缓存实例。

安装SolOpenMAMA插件​

在 Linux 服务器上安装了 PubSub+ 缓存实例后，必须用 Solace 定制的 SolOpenMAMA 插件替换随 PubSub+ 缓存实例提供的默认 PubSub+ 缓存插件。

SolOpenMAMA 插件对于 PubSub+ 缓存实例在缓存之前根据消息类型（例如，初始消息或更新）正确处理接收到的 OpenMAMA 消息是必需的。这种特殊处理用于促进 OpenMAMA 增量/增量更新。

要为 PubSub+ 缓存实例安装 SolOpenMAMA 插件，请按照以下步骤操作：

  1. 从 Solace SFTP 服务器下载 SolOpenMAMA 插件归档文件（solopenmama_plugin_<supported_environment>_<releasenumber>.tar.gz）。
  2. 解压归档文件。
  3. 用提取包的 lib 目录中具有相同名称的 Solace 定制 SolOpenMAMA 插件库替换位于 Linux 服务器上的 PubSub+ 缓存安装目录（例如，/usr/local/solace）中的默认 PubSub+ 缓存插件库（libSolCachePlugin.so）。
  4. 将提取包中的 Solace 提供的字典或客户提供的字典复制到 Linux 服务器上的 PubSub+ 缓存安装目录。
  5. 将 Solace 提供的 SolOpenMAMA 插件配置文件（mama.properties）复制到 Linux 服务器上的 PubSub+ 缓存安装目录，并使用文本编辑器配置此文件（参阅配置消息缓存）。