ESB文档库
00 概述
06 接口服务说明

本节包含以下几部分内容。

  1. 安装前准备
  2. 许可证申请与安装
  3. 环境要求
  4. ESB各个子系统进程间关系
  5. 物理部署架构图
  • 本章节所有组件针对 Windows 系统时默认安装到“D:\primeton\ESB”目录下，用户可以根据实际环境修改安装目录。
  • 本章节所有组件针对Linux 系统时默认安装到“/opt/primeton/ESB”目录下，用户可以根据实际环境修改安装目录。
  • ESB产品在安装配置时，所有组件连接的是同一个数据库，配置数据库文件之前，必须确保初始化数据库脚本已执行。创建数据库时的密码建议设置为非数字 0 开头的串，即：字母、数字组合，诸如 000111 之类的简单密码会被认为是 111 而导致数据库连不上（Spring 读 yml 时会忽略开始的数字 000）。
  • 部署ESB Studio和APIGateway Server、ESB Server时，需要申请并安装许可证。参见 许可证申请与安装。

# 安装前准备

  • 已安装Oracle JDK 1.8.0_251，并且已经设置 JAVA_HOME 以及 PATH 系统变量。
  • 已下载需要安装组件的安装包，.zip 安装包适用于 Windows 操作系统，.tar 安装包适用于 Linux 操作系统。

软件包名称 软件包描述
Primeton_ESB_9.0.0_Console.tar
Primeton_ESB_9.0.0_Console.zip		 企业ESB Governor微应用版前端安装包
Primeton_ESB_9.0.0_Governor.tar
Primeton_ESB_9.0.0_Governor.zip		 企业ESB Governor微应用版后端安装包
Primeton_ESB_9.0.0_Governor_Standalone.zip
Primeton_ESB_9.0.0_Governor_Standalone.tar		 企业ESB Governor独立版后端安装包
Primeton_ESB_9.0.0_Server.zip
Primeton_ESB_9.0.0_Server.tar		 企业ESB Server编排环境安装包
Primeton_APIGateway_9.0.0_Server.zip
Primeton_APIGateway_9.0.0_Server.tar		 企业API网关运行环境安装包
primeton-installer-1.2.2.zip
primeton-installer-1.2.2.tar		 企业ESB哑安装工具包
Primeton_ESB_9.0.0_Develope_Windows.zip 企业ESB 开发环境安装包

# 许可证申请与安装

# 申请

  • 试用版：如果试用ESB 9.0GA产品，请联系普元客服申请临时许可证文件。
  • 客服邮箱：cservice@primeton.com
  • 客服电话：400-820-5821
  • 正式版：如果需要申请正式许可证，请联系普元销售人员，申请正式版许可证文件。

# 安装

  1. 将申请到的许可证“primetonlicense.xml”文件拷贝到对应产品组件的license存放位置，分别如下。
  • APIGateway Server：{APIGateway Server安装目录}/license，例如：“D:/primeton/APIGateway/Primeton_APIGateway_9.0.0_Server/license”。
  • ESB Studio：{ESB Studio安装目录}/server/EOS/_srv，例如：D:/studio/server/EOS/_srv。
  • ESB Server：{ESB Server安装目录}/server/EOS/_srv，例如：“D:/primeton/ESB/Primeton_ESB_9.0.0_Server/server/EOS/_srv”。
  1. 安装配置对应组件， 启动应用程序即可。

# 环境要求

参数 说明
CPU 主频2.0GHz以上
内存 8GB以上
硬盘 临时目录空间：800MB以上
安装目录空间：2GB以上
网络 IPv4

IPv6
操作系统 Windows 10

CentOS 7.5

银河麒麟V10

UOS V20
数据库 MySQL 5.7.33/8.0.28

Oracle 10g/11g/12.2.0.1.0/19.3.0.0.0

PostgreSQL 9.6.2/12.4

SQLServer 2008/2016/2019

DM7、DM8

OpenGauss 3.0.0

Gbase 8s

HighGo 5.6

KingbaseES 8

UXDB 2.1.1.3

Oscar 7
浏览器 IE 11

Microsoft Edge 95

Chrome 95

Firefox 92

# ESB各个子系统进程间关系

假设开发人员已经通过 ESB Studio 开发完成一个 ESB 工 程，并将该工程打包成部署包(ecd)备用；生产环境下的 Server、Governor、 ES 均已启动，相关配置均按照现场需求准备就绪。

第一步：部署 ECD。登录 Governor，实施团队人员将 ECD 包部署到 ESB 服务器集群环境，Governor 会将部署(或卸载)的相关日 志信息记录到数据库，同时 Governor 会通知 ESB Server 重新加载已经部署的 ESB 工程，保证在不用重启的情况下可以正常访问。

第二步：接口注册。登录 Governor，根据事先定义好的接口调用标准规范， 将接口信息注册到系统，系统会将配置信息持久化到数据库，配置好调用关系。

第三步：外围系统调用 ESB 接口。根据接口调用标准规范查询调用系统 ID 及服务提供者接口编码即 ClientId 和 OperationCode，将其加入到请求报文头信息中，向 ESB 服务器发起服务调用请求，ESB 服务器会在整个请求及响应过程中生成业务日志，保存在网络存储器上。

第四步：日志信息收集和归档。ES 在服务请求相应过程中负责存储Server运行过程中的日志数据，以备数据统计和详细信息查询。

第五步：统计信息查询及检索。通过 Governor 提供的查询统计和接口运行检索功能查看统计信息，方便运维人员实时掌握接口运行状态、频度、调用耗时等信息。

# 物理部署架构图

下图为单实例节点ESB物理部署架构图。