WeBASE节点前置服务以及相关报错处理

1.部署说明

（1）前提条件

依赖软件	支持版本
Java	Oracle JDK 8至14
FISCO-BCOS	v2.0.0及以上版本

在配置节点前置服务之前可以先配置JAVA_HOME可以观看我的博客环境配置，

（2）拉取代码

执行命令

git clone https://github.com/WeBankBlockchain/WeBASE-Front.git

# 若因网络问题导致长时间下载失败，可尝试以下命令
git clone https://gitee.com/WeBank/WeBASE-Front.git

进入目录

cd WeBASE-Front

（3）编译代码

使用以下方式编译构建，如果出现问题可以查看常见问题解答：

方式一：如果服务器已安装Gradle，且版本为gradle-4.10至gradle-6.x版本

gradle build -x test

方式二：如果服务器未安装Gradle，或者版本不是gradle-4.10至gradle-6.x版本，可使用gradlew编译

chmod +x ./gradlew && ./gradlew build -x test

构建完成后，会在根目录WeBASE-Front下生成已编译的代码目录dist。

（4）修改配置

进入dist目录

cd dist

dist目录提供了一份配置模板conf_template：（如果原来没有进行过修改可以直接拷贝）

根据配置模板生成一份实际配置conf。初次部署可直接拷贝。
例如：cp -r conf_template conf

进入conf目录：

cd conf

切记：（一定要拷贝证书）

注意： 将节点所在目录nodes/${ip}/sdk下的所有文件拷贝到当前conf目录，供SDK与节点建立连接时使用（SDK会自动判断是否为国密，且是否使用国密SSL）

链的sdk目录包含了ca.crt, sdk.crt, sdk.key和gm文件夹，gm文件夹包含了国密SSL所需的证书
拷贝命令可使用cp -r nodes/${ip}/sdk/* ./conf/
注，只有在建链时手动指定了-G(大写)时节点才会使用国密SSL

修改配置（根据实际情况修改）：(如果端口没有被占用可以不修改)

如果在企业部署中使用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      //配置所连节点的绝对路径，用于监控节点配置与日志
...

（5）服务启停

返回到dist目录执行（在gradlew编译的时候自动生成的dist下有启动，停止..脚本）：

启动: bash start.sh
停止: bash stop.sh
检查: bash status.sh

备注：服务进程起来后，需通过日志确认是否正常启动，出现以下内容表示正常；如果服务出现异常，确认修改配置后，重启提示服务进程在运行，则先执行stop.sh，再执行start.sh。

如果提示 JAVA_HOME has not been configured

java环境没有配置可以看我上面的博客解决这个问题

检查日志

tail -f log/WeBASE-Front.log

启动成功截图如下

（6）访问控制台

http://{deployIP}:{frontPort}/WeBASE-Front
示例：http://localhost:5002/WeBASE-Front

进入之后为以下界面