部署说明

1. 前提条件

环境版本
JavaJava1.8或以上版本
数据库MySQL-5.6或以上版本

备注：安装说明请参看 附录-1。

2. 拉取代码

执行命令：

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

进入目录：

  1. cd WeBASE-Sign

3. 编译代码

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

  1. gradle build -x test

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

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

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

4. 数据库初始化

  1. #登录MySQL:
  2. mysql -u ${your_db_account} -p${your_db_password}  例如：mysql -u root -p123456
  3. #新建数据库：
  4. CREATE DATABASE IF NOT EXISTS {your_db_name} DEFAULT CHARSET utf8 COLLATE utf8_general_ci;

5. 修改配置

（1）进入dist目录

  1. cd dist

dist目录提供了一份配置模板conf_template：

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

（2）修改配置（根据实际情况修改）：

  1. vi conf/application.yml
  1. server: 
  2.   # 本工程服务端口，端口被占用则修改
  3.   port: 5004
  4.   context-path: /WeBASE-Sign
  6. spring: 
  7.   datasource: 
  8.     # 数据库连接信息
  9.     url: jdbc:mysql://127.0.0.1:3306/webasesign?serverTimezone=GMT%2B8&useUnicode=true&characterEncoding=utf8
  10.     # 数据库用户名
  11.     username: "dbUsername"
  12.     # 数据库密码
  13.     password: "dbPassword"
  14.     driver-class-name: com.mysql.cj.jdbc.Driver
  16. constant: 
  17.   # aes加密key(16位)，如启用，各互联的子系统的加密key需保持一致
  18.   aesKey: EfdsW23D23d3df43

5. 服务启停

在dist目录下执行：

  1. 启动：bash start.sh
  2. 停止：bash stop.sh
  3. 检查：bash status.sh

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

  1. ...
  2.     Application() - main run success...

6. 查看日志

在dist目录查看：

  1. 全量日志：tail -f log/WeBASE-Sign.log
  2. 错误日志：tail -f log/WeBASE-Sign-error.log