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

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

  1. 安装介质说明和准备
  2. 安装与配置
  3. 前端配置
  4. 启动服务
  5. 环境登录和验证
  6. 卸载

# 安装介质说明和准备

微应用安装介质前提是已经安装AFCenter8.3.1环境。如果未安装, 请参考EOS微服务安装指南 (opens new window) 哑安装介质，目录如下：

primeton-installer-1.2.2.tar
├─ config //配置文件
├─ drivers //数据库驱动目录
├─ lib//哑安装相关jar
├─ logs //哑安装日志
├─ install.cmd //windows环境启动脚本
├─ install.sh//linux环境启动脚本
├─ README.md //使用文档

微应用安装介质有两个：前端介质、后端介质 。 前端目录如下：

Primeton_ESB_9.0.0_Console.tar
├── Developer
│   ├── assets
│   └── static
│   └── index.html
│   └── remoteEntry.js
├── DevOps
│   ├── assets
│   └── static
│   └── index.html
│   └── remoteEntry.js
├── Manager
│   ├── assets
│   └── static
│   └── index.html
│   └── remoteEntry.js
├── webide
│   ├── assets
│   └── static
│   └── index.html
│   └── remoteEntry.js

后端目录如下：

Primeton_ESB_9.0.0_Governor.tar
├── bin //启动脚本
├── config //配置文件
├── db-scripts //部署db脚本
├── governor //模板文件
├── lib //依赖的相关jar
├── com.primeton.esb.governor.boot-9.0.0 //服务jar
├── startServer.bat //windows环境启动脚本
├── startServer.sh //linux环境启动脚本
├── stopServer.bat //windows环境停止脚本
├── stopServer.sh //linux环境停止脚本

ESB微应用版, 必须同时安装AFCenter和ESB微应用版，且必须按照如下步骤安装：

1.AFCenter环境已准备好，并启动成功。

2.安装ESB Governor前，在AFCenter的数据库执行${ESB-governor安装目录}/db-scripts/esb/Mysql/1-esb-afc-data.sql。

3.初始化ESB Governor数据库(哑安装程序默认会自动初始化数据库，无需手动执行)。

4.修改配置并安装ESB Governor。

4.启动ESB Governor。

# 安装与配置

# 1.哑安装ESB Governor微应用后端

1.解压primeton-installer-1.2.2.tar到/opt/primeton/ESB/primeton-installer-1.2.2文件下。

2.将数据库驱动jar包和方言jar包拷贝到primeton-installer-1.2.2/drivers目录下。

3.复制primeton-installer-1.2.2/config/template/governor目录下的application.yml和install.properties文件到primeton-installer-1.2.2/config目录下。

4.修改primeton-installer-1.2.2/config/install.properties配置文件，其中数据库连接可以配置成ESB的数据库, 也可以使用AFCenter的数据库。详细配置如下：

#带安装介质目录
zipPath=/opt/primeton/Primeton_ESB_9.0.0_Governor.tar
#产品安装目标目录
destPath=/opt/primeton/governor
#当安装目录不存在时是否自动创建
autoCreateDir=true
#当安装目录不为空时是否强制覆盖
coverByForce=true
 
#是否数据库脚本初始化，若初始化initDB为true,强制初始化需initDB和forceInitDB同时配置为true
initDB=true
forceInitDB=true
 
# DB config
dbType=mysql
dbDriver=com.mysql.jdbc.Driver
dbUrl=jdbc:mysql://127.0.0.1:3306/esb?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2B8&useSSL=false
dbUserName=root
dbPassword=root
 
#数据库方言配置
dialect=org.hibernate.dialect.MySQLDialect
 
#Redis配置
redisHost=127.0.0.1
redisPort=6379
redisPassword=primeton
 
#AFCenter配置
afcName=127.0.0.1:28083
afcTenant=sys_tenant
afcAppCode=AFC
afcAppSecret=secret
 
#Elasticsearch配置
elasticsearchEnabled=true
 
#若elasticsearch有用户名密码，需配置以下配置
elasticsearchUsername=elastic
elasticsearchPassword=primeton000000
 
#elasticsearch server IP
elasticsearchIP=127.0.0.1
elasticsearchPort=9200
elasticsearchProtocol=https
elasticsearchCertificate=/usr/local/elasticsearch/elasticsearch-8.1.2/config/certs/http_ca.crt
参数 说明
zipPath ESB-governor后端安装包Primeton_ESB_9.0.0_Governor.tar的绝对路径。
destPath ESB-governor后端的安装路径。
dbtype 数据库类型。
dbDriver 数据库驱动类。
dbUrl 数据库的jdbc url。
dbUserName 数据库用户名。
dbPassword 数据库密码。
database-platform 数据库方言类。参考:1.1 安装须知
redisHost redis的ip地址
redisPort redis的端口。
redisPassword redis的密码。
afcName afcenter后端服务的IP和端口
afcTenant afcenter的租户编码
afcAppCode afcenter的应用编码
elasticsearchEnabled 是否启动ElasticSearch。
elasticsearchUsername ElasticSearch的用户名。
elasticsearchPassword ElasticSearch的密码。
elasticsearchIP ElasticSearch的IP地址。
elasticsearchPort ElasticSearch的端口。
elasticsearchProtocol ElasticSearch的http的类型。
elasticsearchCertificate ElasticSearch的证书的绝对路径。
注意
如果ESB Governor配置了redis，ESB Governor会将接口资源信息缓存在redis中，如果多个ESB Governor连接不同的数据库，但使用同一个redis，会造成redis缓存的接口资源信息混乱，影响ESB Governor正常使用。
安装时请确保一个数据库对应一个redis。
如果在ESB Governor运行过程中，手动清除redis缓存，会造成ESB Governor接口资源数据不同步，需要重启ESB Governor。

5.配置完成后，执行如下命令，启动哑安装。

./install.sh

说明：
为了保证密码安全，哑安装成功后，请立即删除primeton-installer-1.2.2/config/install.properties文件。

6.如果要使用sap服务器，需要将sapjco.zip 中对应操作系统下的libsapjco3.so和sapjco3.jar文件复制到“${ESB-governor安装目录}/lib”目录下

微服务环境，{ESB-governor}安装目录/config/下application-afc.properties文件中的eos.application.sys-code
和eos.application.sys-key参数需要和{afcenter}安装目录/config/下application.properties文件中保持一致。

# 2.afcenter数据库初始化ESB脚本

1.ESB-governor哑安装完成后，进入${ESB-governor安装目录}/db-scripts/esb/Mysql目录，初始化ESB的数据到AFCenter库，执行如下脚本：

1-esb-afc-data.sql

微服务环境，如果AFCenter的数据库与ESB的数据库类型不一致，请执行${ESB-governor安装目录}/db-scripts/esb/{AFCenter对应数据库类型}
下的1-esb-afc-data.sql脚本文件

# 前端配置

1.修改{AFCenter-nginx安装目录}/conf/nginx.conf配置文件，新增ESB的配置：

location ^~ /api/esb/ {# ESB配置
    proxy_pass http://IP:Port/api/esb/;# 修改为ESB-governor后端IP和端口
}

2.找到已经部署完的介质EOS_Platform_8.3.1的前端部署路径/web/afcenter

3.把介质Primeton_ESB_9.0.0_Console里所有目录，复制到介质EOS_Platform_8.3.1的前端资源/web/afcenter/esb内

如果是独立安装的afcenter，则把Primeton_ESB_9.0.0_Console里所有目录复制到afcenter前端安装目录中。

4.进入{AFCenter-nginx安装目录}/sbin下,执行./nginx -s reload命令重启nginx

# 启动服务

1.在${ESB-governor安装目录}下执行如下命令，启动ESB Governor。

nohup ./startServer.sh &

2.启动成功后，进入${ESB-governor安装目录}/logs目录，打开eos-trace.log文件 查看具体日志，如下图所示:

# 环境登录和验证

1.访问http://nginx机器IP:nginx端口Port ，使用ESB管理员登录，用户名/密码为：manager/000000，进入如下界面，表示ESB Governor系统部署成功，如下图所示:

# 卸载

1.在${ESB-governor安装目录}下，执行如下命令，停止ESB Governor服务。

./stopServer.sh

2.停止服务后，可以直接删除${ESB-governor安装目录}进行卸载。

← 1.4.2.2 Linux环境解压安装 →