Skip to content

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

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

安装介质说明和准备

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

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.ymlinstall.properties文件到primeton-installer-1.2.2/config目录下。

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

properties
#带安装介质目录
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
参数说明
zipPathESB-governor后端安装包Primeton_ESB_9.0.0_Governor.tar的绝对路径。
destPathESB-governor后端的安装路径。
dbtype数据库类型。
dbDriver数据库驱动类。
dbUrl数据库的jdbc url。
dbUserName数据库用户名。
dbPassword数据库密码。
database-platform数据库方言类。参考:1.1 安装须知
redisHostredis的ip地址
redisPortredis的端口。
redisPasswordredis的密码。
afcNameafcenter后端服务的IP和端口
afcTenantafcenter的租户编码
afcAppCodeafcenter的应用编码
elasticsearchEnabled是否启动ElasticSearch。
elasticsearchUsernameElasticSearch的用户名。
elasticsearchPasswordElasticSearch的密码。
elasticsearchIPElasticSearch的IP地址。
elasticsearchPortElasticSearch的端口。
elasticsearchProtocolElasticSearch的http的类型。
elasticsearchCertificateElasticSearch的证书的绝对路径。
yaml
注意
如果ESB Governor配置了redis,ESB Governor会将接口资源信息缓存在redis中,如果多个ESB Governor连接不同的数据库,但使用同一个redis,会造成redis缓存的接口资源信息混乱,影响ESB Governor正常使用。
安装时请确保一个数据库对应一个redis。
如果在ESB Governor运行过程中,手动清除redis缓存,会造成ESB Governor接口资源数据不同步,需要重启ESB Governor。

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

shell
./install.sh

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

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

yaml
微服务环境,{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
yaml
微服务环境,如果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。

shell
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服务。

shell
./stopServer.sh

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