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

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

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

# 安装介质说明和准备

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

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.解压介质

获取governor的后端介质包，解压到governor安装目录下。

# 2.执行初始化脚本

初始化ESB Governor数据库（数据库默认编码为UTF-8），执行{ESB-governor安装目录}/db-scripts/如下脚本：

eos/Mysql/eos_all.sql

esb/Mysql/2-schema-esb-mysql.sql

esb/Mysql/3-data-esb-mysql.sql

# 3.连接redis

1.在已经启动的afcenter介质，获取到redis的相关配置：host、port、password

# 4.添加驱动

1.下载MySQL数据库的驱动到${ESB-governor安装目录}/lib

数据库厂商 驱动名 版本
mysql mysql-connector-java 8.0.17
mysql mysql-connector-java 5.1.45

# 5.后端修改配置文件

1.打开${ESB-governor安装目录}/config/application.properties 修改端口、redis、jpa等配置：

server.port=8080
server.connection-timeout=60000
spring.application.name=ESB
spring.jmx.default-domain=${spring.application.name}
spring.cloud.inetutils.preferred-networks=192.168
spring.pid.file=pid
 
#spring.profiles.active=eureka
spring.profiles.active=nacos,afc,esb
management.endpoints.web.exposure.include=hystrix.stream,health,info,loggers,eos,mappings
spring.main.allow-bean-definition-overriding=true
 
server.app-server.min-spare-threads=100
server.app-server.max-threads=500
server.app-server.max-connections=1000
server.app-server.accept-count=200  
 
eos.profiles.active=dev
eos.cache.mode=redis
eos.admin.port=${server.port}
 
# redis
spring.redis.host=127.0.0.1
spring.redis.port=6379
spring.redis.password=123456
spring.redis.lettuce.pool.max-active=100
spring.redis.lettuce.pool.max-idle=100
spring.redis.lettuce.pool.max-wait=5000
 
# hibernate
spring.jpa.open-in-view=false
spring.jpa.properties.hibernate.enable_lazy_load_no_trans=true
spring.jpa.properties.hibernate.connection.handling_mode=IMMEDIATE_ACQUISITION_AND_HOLD
spring.jpa.properties.hibernate.new_generator_mappings=false
spring.jpa.properties.hibernate.ddl-auto=none
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQLDialect
spring.jpa.properties.database=MYSQL  
 
# time format
spring.mvc.dateFormat=yyyy-MM-dd HH:mm:ss
spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
spring.jackson.time-zone=GMT+8
spring.jackson.serialization.write-dates-as-timestamps=false
 
#swagger
swagger.enable=false
 
# feign
feign.client.config.default.connectTimeout =2000
feign.client.config.default.readTimeout =1000
 
#AFC\u90E8\u7F72\u65B9\u5F0F sdk || starter
console.deploy.type=sdk
参数 说明
server.port ESB-governor服务的端口，默认8080。
spring.redis.host redis的IP地址，根据实际环境修改。例如：111111。
spring.redis.port redis端口，根据实际环境修改。
spring.redis.password redis密码。
spring.jpa.properties.hibernate.dialect 数据库方言类，默认mysql数据库方言，其他数据库参考:1.1 安装须知
spring.jpa.properties.database 数据库类型，默认mysql数据库类型。
注意
如果ESB Governor配置了redis，ESB Governor会将接口资源信息缓存在redis中，如果多个ESB Governor连接不同的数据库，但使用同一个redis，会造成redis缓存的接口资源信息混乱，影响ESB Governor正常使用。
安装时请确保一个数据库对应一个redis。
如果在ESB Governor运行过程中，手动清除redis缓存，会造成ESB Governor接口资源数据不同步，需要重启ESB Governor。

2.打开${ESB-governor安装目录}/config/application-afc.properties 修改afcenter相关配置：

out.config.folder=config
eos.application.sys-code=EOS-DEMO-SYS
eos.application.sys-key=dc6baaed30e541d78bb91274803d9432
 
 
# afcenter
afc.application.name=127.0.0.1:28083
afc.application.tenant=sys_tenant
afc.application.appCode=AFC
afc.application.appSecret=secret
 
afc.schedule.logs-to-history.cron=0 0 4 1 1/1 ?
afc.schedule.logs-to-history.stay-month-number=2
 
afc.user.login.filter.enable=true
 
 
afc.attachments.persistence-mode=db
afc.attachments.local.dir=
afc.attachments.nexus.repository-url=
afc.attachments.nexus.username=
afc.attachments.nexus.password=
afc.attachments.aliyun-oss.endpoint=
afc.attachments.aliyun-oss.access-key-id=
afc.attachments.aliyun-oss.access-key-secret=
afc.attachments.aliyun-oss.bucket-name=
afc.attachments.libre-office.host=
afc.attachments.libre-office.port=
参数 说明
afc.application.name afcenter后端服务的IP和端口。
afc.application.tenant afcenter的租户编码，默认sys_tenant。
afc.application.appCode afcenter的应用编码，默认AFC。

3.打开${ESB-governor安装目录}/config/application-esb.properties 修改ESB、elasticsearch相关配置：

#esb restTemplate
esb.business=true
esb.database.init=false
esb.database.enforceInit=false
esb.rest.client.socket.timeout=20000
esb.rest.client.connect.timeout=10000
esb.rest.client.connectionRequest.timeout=10000
esb.rest.client.evictIdleConnections=60
esb.rest.client.ConnectionTimeToLive=60
 
elasticsearch.enabled=true
elasticsearch.ioThreadCount=50
elasticsearch.connectTimeout=60000
elasticsearch.maxTotal=10000
elasticsearch.maxPerRoute=1000
elasticsearch.numberOfShards=1
elasticsearch.numberOfReplicas=0
elasticsearch.refreshInterval=10s
elasticsearch.username=elastic
elasticsearch.password=primeton000000
elasticsearch.certificate=/usr/local/elasticsearch/elasticsearch-8.1.2/config/certs/http_ca.crt
elasticsearch.hosts[0].ip=127.0.0.1
elasticsearch.hosts[0].port=9200
elasticsearch.hosts[0].protocol=https
参数 说明
elasticsearch.enabled 是否启用ElasticSearch，默认为true。
elasticsearch.username ElasticSearch 的访问用户名，默认为elastic。
elasticsearch.password ElasticSearch 的访问密码，密码为安装elasticsearch时设置的密码
elasticsearch.certificate ElasticSearch的证书，该证书为elasticsearch-8.1.2/config/certs下的http_ca.crt文件，文件位置需配置绝对路径
elasticsearch.hosts[0].ip 配置成安装ElasticSearch的机器IP地址。
elasticsearch.hosts[0].port ElasticSearch 的启动端口号。默认为9200。
elasticsearch.hosts[0].protocol ElasticSearch 的http协议，默认https。

4.打开${ESB-governor安装目录}/config/ESB/config/user-config.xml 修改数据源default配置，其中数据库连接可以配置成ESB的数据库, 也可以使用AFCenter的数据库。详细配置如下：

<group name="default">
       <configValue key="Database-Type">MySql</configValue>
       <configValue key="Jdbc-Type"/>
       <configValue key="C3p0-DriverClass">com.mysql.jdbc.Driver</configValue>
       <configValue key="C3p0-Url">jdbc:mysql://127.0.0.1:3306/esb?useUnicode=true&amp;characterEncoding=UTF-8&amp;serverTimezone=GMT%2B8&amp;useSSL=false</configValue>
       <configValue key="C3p0-UserName">root</configValue>
       <configValue key="C3p0-Password">root</configValue>
       <configValue key="C3p0-PoolSize">10</configValue>
       <configValue key="C3p0-MaxPoolSize">50</configValue>
       <configValue key="C3p0-MinPoolSize">10</configValue>
       <!-- //seconds, 0 means connections never expire -->
       <configValue key="C3p0-MaxIdleTime">600</configValue>
       <!-- //idle connections never tested -->
       <configValue key="C3p0-IdleConnectionTestPeriod">900</configValue>
       <configValue key="C3p0-MaxStatements">0</configValue>
       <configValue key="C3p0-NumHelperThreads">1</configValue>
 
       <configValue key="Transaction-Isolation">ISOLATION_DEFAULT</configValue>
       <configValue key="Test-Connect-Sql">SELECT count(*) from EOS_UNIQUE_TABLE</configValue>
       <configValue key="Retry-Connect-Count">-1</configValue>
</group>
参数 说明
Database-Type 数据库类型，根据实际环境修改。
C3p0-DriverClass 数据库数据库类，根据实际环境修改。
C3p0-Url 访问数据库的JDBC URL，根据实际环境修改。
C3p0-UserName 数据库用户名，根据实际环境修改。例如：root
C3p0-Password 数据库用户密码，根据实际环境修改。例如：root
  1. 如果要使用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文件中保持一致。

# 前端配置

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.3 Windows环境哑安装 →