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

注意：
数据库方言、连接URL、驱动类全限定类名、等信息可参考: 1.1 安装须知

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

  1. 安装
  2. 初始化数据库
  3. 配置
  4. 验证
  5. 卸载

# 安装

  1. 在目录/opt/primeton/ipass创建“Primeton_iPaaS_9.1.0_Portal_Standalone”目录。

  2. 解压安装包Primeton_iPaaS_9.1.0_Portal_Standalone.tar到Primeton_iPaaS_9.1.0_Portal_Standalone目录中。

    tar -xvf Primeton_iPaaS_9.1.0_Portal_Standalone.tar -C Primeton_iPaaS_9.1.0_Portal_Standalone

# 初始化数据库

  1. 以 Mysql 为例，创建编码格式为 UTF-8 的数据库 ipass。
  2. 在“${iPaaS-Portal安装目录}/db-scripts”目录下，按照以下顺序执行数据库脚本，具体顺序如下:
1. eos/Mysql/eos_all.sql
2. afcenter/Mysql/afc_all.sql
3. esb/Mysql/1-esb-afc-data.sql
4. esb/Mysql/2-schema-esb-mysql.sql
5. esb/Mysql/3-data-esb-mysql.sql
6. esb/Mysql/4-data-ipaas-connector-mysql.sql

注意：iPaaS Portal安装如果使用的是oracle数据库,需执行下{iPaaS-Portal安装目录}/db-scripts/esb/Oracle/5-api-template-date.sql脚本，初始化内置API模板数据。

# 配置

  1. 将数据库驱动jar包和方言jar包拷贝到“${iPaaS-Portal安装目录}/lib”目录下。

  2. 打开${iPaaS-Portal安装目录}\config\application.properties 修改端口、redis、jpa、数据库方言等配置：

server.port=8080
server.connection-timeout=60000
spring.pid.file=pid
spring.profiles.active=nacos,afc,esb
spring.application.name=esb
spring.jmx.default-domain=${spring.application.name}
spring.cloud.inetutils.preferred-networks=192.168

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
management.health.elasticsearch.enabled=false

spring.resources.static-locations=file:./webapp
management.endpoints.web.exposure.include=hystrix.stream,health,info,loggers,eos,mappings
spring.main.allow-bean-definition-overriding=true

out.config.folder=config
eos.profiles.active=dev
eos.cache.mode=redis
eos.admin.port=${server.port}
eos.application.sys-code=EOS-DEMO-SYS
eos.application.sys-key=dc6baaed30e541d78bb91274803d9432
spring.session.store-type=none

# redis
spring.redis.host=127.0.0.1
spring.redis.port=6379
spring.redis.password=
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

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=starter

#mock\u7AEF\u53E3
afc.console.mock.port=1080
参数 说明
server.port iPaaS-Portal服务的端口，默认8080。
eos.cache.mode 缓存方式，默认为redis。
spring.redis.host eos.cache.mode=redis时，需要配置redis的IP地址。
spring.redis.port eos.cache.mode=redis时，需要配置redis端口。
spring.redis.password eos.cache.mode=redis时，需要配置redis密码。
spring.jpa.properties.hibernate.dialect 数据库方言类，默认mysql数据库方言，其他数据库参考:1.1 安装须知 的 数据库配置 章节的 方言配置。
spring.jpa.properties.database 参考下方表格。

database类型对应关系

数据库名称 spring.jpa.properties.database
sqlserver sqlserver
mysql mysql
uxdb uxdb
postgresql postgresql
oscar oscar
oracle oracle
opengauss opengauss
KingbaseES KingbaseES
highgo highgo
GBase8s GBase8s
GBase8a GBase
DM DM
注意
如果iPaaS Portal配置了redis，iPaaS Portal会将接口资源信息缓存在redis中，如果多个iPaaS Portal连接不同的数据库，但使用同一个redis，会造成redis缓存的接口资源信息混乱，影响iPaaS Portal正常使用。
安装时请确保一个数据库对应一个redis。
如果在iPaaS Portal运行过程中，手动清除redis缓存，会造成iPaaS Portal接口资源数据不同步，需要重启iPaaS Portal。
  1. 打开${iPaaS-Portal安装目录}\config\application-esb.properties 修改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。
  1. 打开“${iPaaS-Portal安装目录}/config/ESB/config/user-config.xml”文件，修改数据库及配置。
<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/ipass?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 参考本章节的 database类型对应关系 小节
DriverClass 数据库类型，根据实际环境修改。其他数据库参考:1.1 安装须知 的 数据库配置 章节的 驱动类名称。
Url 访问数据库的JDBC URL，根据实际环境修改。其他数据库参考:1.1 安装须知 的 数据库配置 章节的 连接URL。
UserName 数据库用户名，根据实际环境修改。例如：root
Password 数据库用户密码，根据实际环境修改。例如：111111
  1. 如果要使用sap服务器，需要将sapjco.zip 中对应操作系统下的libsapjco3.so和sapjco3.jar文件复制到“${iPaaS-Portal安装目录}/lib”目录下
    iPaaS Portal安装如果使用的是oracle数据库,需执行下{iPaaS-Portal安装目录}/db-scripts/esb/Oracle/5-api-template-date.sql脚本，初始化内置API模板数据。

# 验证

  1. 在${iPaaS-Portal安装目录}下执行以下命令，启动iPaaS Portal。
nohup  ./startServer.sh &

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

  2. 启动完成后以管理员身份（manager/000000）登录iPaaS Portal， 在浏览器地址栏输入http://ip:8080” （ip地址为安装iPaaS Portal的服务器地址）进入如下界面，表示iPaaS Portal系统部署成功。

  3. 登录成功后，进入iPaaS Portal管理页面

# 卸载

  1. 在${iPaaS-Portal安装目录}下，停止iPaaS Portal服务。
./stopServer.sh
  1. 停止服务后，直接删除${iPaaS-Portal安装目录}进行卸载。

← 1.4.1.3 Windows环境哑安装 →