本节包含以下几部分内容。
- 安装前准备
- 许可证申请与安装
- 环境要求
- iPaaS各个子系统进程间关系
- 物理部署架构图
- 本章节所有组件针对 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 系统变量。
| 软件包名称 | 软件包描述 |
|---|---|
| Primeton_iPaaS_9.1.0_Portal_UI.tar | 企业iPaaS 管理端微应用版前端安装包 |
| Primeton_iPaaS_9.1.0_Portal_Server.tar | 企业iPaaS 管理端微应用版后端安装包 |
| Primeton_iPaaS_9.1.0_Portal_Standalone.tar | 企业iPaaS 管理端独立版安装包 |
| Primeton_iPaaS_9.1.0_ESB_Server.tar | 企业iPaaS ESB引擎安装包 |
| Primeton_iPaaS_9.1.0_APIGateway_Server.tar | 企业iPaaS Gateway引擎安装包 |
| primeton-installer-1.2.2.tar | 哑安装工具包 |
| Primeton_iPaaS_9.1.0_Developer_Windows.zip | 企业iPaaS ESB 开发环境 Windows 安装包 |
# 许可证申请与安装
# 申请
- 试用版：如果试用产品，请联系普元客服申请临时许可证文件。
- 客服邮箱：cservice@primeton.com
- 客服电话：400-820-5821
- 正式版：如果需要申请正式许可证，请联系普元销售人员，申请正式版许可证文件。
# 安装
- 将申请到的许可证“primetonlicense.xml”文件拷贝到对应产品组件的license存放位置，分别如下。
APIGateway Server：{APIGateway Server安装目录}/license，例如：“D:/primeton/APIGateway/Primeton_iPaaS_9.1.0_APIGateway_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_iPaaS_9.1.0_Server/server/EOS/_srv”。
- 安装配置对应组件， 启动应用程序即可。
# 环境要求
| 参数 | 说明 |
|---|---|
| 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 8a、Gbase 8s HighGo 5.6 KingbaseES 8 UXDB 2.1.1.3 Oscar 7 |
| 浏览器 | Chrome136 Microsoft Edge136 Firefox138 |
# iPaaS各个子系统进程间关系
假设开发人员已经通过 ESB Studio 开发完成一个 ESB 工 程，并将该工程打包成部署包(ecd)备用；生产环境下的 Server、Portal、 ES 均已启动，相关配置均按照现场需求准备就绪。
第一步：部署 ECD。登录 Portal，实施团队人员将 ECD 包部署到 ESB 服务器集群环境，Portal 会将部署(或卸载)的相关日 志信息记录到数据库，同时 Portal 会通知 ESB Server 重新加载已经部署的 ESB 工程，保证在不用重启的情况下可以正常访问。
第二步：接口注册。登录 Portal，根据事先定义好的接口调用标准规范， 将接口信息注册到系统，系统会将配置信息持久化到数据库，配置好调用关系。
第三步：外围系统调用 ESB 接口。根据接口调用标准规范查询调用系统 ID 及服务提供者接口编码即 ClientId 和 OperationCode，将其加入到请求报文头信息中，向 ESB 服务器发起服务调用请求，ESB 服务器会在整个请求及响应过程中生成业务日志，保存在网络存储器上。
第四步：日志信息收集和归档。ES 在服务请求相应过程中负责存储Server运行过程中的日志数据，以备数据统计和详细信息查询。
第五步：统计信息查询及检索。通过 Portal 提供的查询统计和接口运行检索功能查看统计信息，方便运维人员实时掌握接口运行状态、频度、调用耗时等信息。
# 物理部署架构图
下图为单实例节点物理部署架构图。
