1.前提条件
2.拉取代码
git clone https://github.com/WeBankFinTech/WeBASE-Front.git
#若因网络问题导致长时间下载失败,可尝试以下命令
git clone https://gitee.com/WeBank/WeBASE-Front.git
进入目录
cd WeBASE-Front
如下图:
mkdir WEBASE创建空文件夹用于存放相关组件
3.编译代码
方式一:如果服务器已安装Gradle,且版本为Gradle-4.10或以上
gradle build -x test
方式二:如果服务器未安装Gradle,或者版本不是Gradle-4.10或以上,使用gradlew编译
chmod +x ./gradlew && ./gradlew build -x test
如下图:gradle --version,未查到版本,则我们还没有安装gradle ,所以选择方式二。
编译前:
构建完成后,会在根目录WeBASE-Front下生成已编译的代码目录dist。
编译后:
4.修改设置
(1)进入dist目录
cd dist
dist目录提供了一份配置模板conf_template:
根据配置模板生成一份实际配置conf。初次部署可直接拷贝。
例如:
cp -r conf_template conf
(2)进入conf目录:
cd conf
如图所示:
注意: 将节点所在目录nodes/
i
p
/
s
d
k
下
的
所
有
文
件
拷
贝
到
当
前
c
o
n
f
目
录
,
供
S
D
K
与
节
点
建
立
连
接
时
使
用
。
链
的
s
d
k
目
录
包
含
了
c
a
.
c
r
t
,
s
d
k
.
c
r
t
,
s
d
k
.
k
e
y
和
g
m
文
件
夹
,
g
m
文
件
夹
包
含
了
国
密
S
S
L
所
需
的
证
书
拷
贝
命
令
可
使
用
c
p
−
r
n
o
d
e
s
/
{ip}/sdk下的所有文件拷贝到当前conf目录,供SDK与节点建立连接时使用。 链的sdk目录包含了ca.crt, sdk.crt, sdk.key和gm文件夹,gm文件夹包含了国密SSL所需的证书 拷贝命令可使用cp -r nodes/
ip/sdk下的所有文件拷贝到当前conf目录,供SDK与节点建立连接时使用。链的sdk目录包含了ca.crt,sdk.crt,sdk.key和gm文件夹,gm文件夹包含了国密SSL所需的证书拷贝命令可使用cp−rnodes/{ip}/sdk/* ./conf/
注,只有在建链时手动指定了-G(大写)时节点才会使用国密SSL
我们另起一个终端找到我们相关配置文件,
cd /fisco/nodes/127.0.0.1/sdk
我们把这些文件复制到conf下,
sudo cp -r * /home/dlh/WEBASE/WeBASE-Front/dist/conf
(3)修改配置(根据实际情况修改):
如果在企业部署中使用WeBASE-Front,必须配置下文中的keyServer,用于连接WeBASE-Sign服务
vi application.yml
spring: datasource:
url: jdbc:h2:file:./h2/webasefront;DB_CLOSE_ON_EXIT=FALSE // 默认H2库为webasefront,建议修改数据库存放路径 … server: port: 5003
// 服务端口 context-path: /WeBASE-Front sdk: … ip: 127.0.0.1
// 连接节点的监听ip channelPort: 20200 // 连接节点的链上链下端口
certPath: conf // sdk证书的目录,默认为conf constant:
keyServer: 127.0.0.1:5004 //
密钥服务的IP和端口(WeBASE-Node-Manager服务或者WeBASE-Sign服务,不同服务支持的接口不同),如果作为独立控制台使用可以不配置
aesKey: EfdsW23D23d3df43 // aes加密key(16位)
如启用,各互联的子系统的加密key需保持一致 transMaxWait: 30 // 交易最大等待时间
monitorDisk: / // 要监控的磁盘目录,配置节点所在目录(如:/data)
monitorEnabled: true // 是否监控数据,默认true nodePath:
/fisco/nodes/127.0.0.1/node0 //配置所连节点的绝对路径,用于监控节点配置与日志 …
先查看application.yml文件
cat application.yml
5.服务启停
返回到dist目录执行:
启动: bash start.sh
停止: bash stop.sh
检查: bash status.sh
备注:服务进程起来后,需通过日志确认是否正常启动,出现以下内容表示正常;如果服务出现异常,确认修改配置后,重启提示服务进程在运行,则先执行stop.sh,再执行start.sh。
启动成功将出现如下日志:
… Application() - main run success…
6.访问控制台
http://{deployIP}:{frontPort}/WeBASE-Front
示例:http://localhost:5002/WeBASE-Front
部署服务器IP和服务端口需对应修改,网络策略需开通
基于可视化控制台,可以开发智能合约,部署合约和发送交易,并查看交易和区块详情。还可以管理私钥,对节点健康度进行监控和统计
7.查看日志
在dist目录查看:
前置服务全量日志:tail -f log/WeBASE-Front.log
前置服务错误日志:tail -f log/WeBASE-Front.log
web3连接日志:tail -f log/web3sdk.log