部署说明

1. 前提条件

2. 注意事项

• Java推荐使用OracleJDK，JDK配置指引
• 安装mysql可以参考 mysql安装示例
• 在服务搭建的过程中，如碰到问题，请查看 常见问题解答
• 安全温馨提示： 强烈建议设置复杂的数据库登录密码，且严格控制数据操作的权限和网络策略

3. 拉取代码

执行命令：

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

进入目录：

cd WeBASE-Chain-Manager

4. 编译代码

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

• 安装gradle可以参考 gradle安装示例

gradle build -x test

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

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

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

5. 数据库初始化

5.1 新建数据库

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

5.2 修改脚本配置

进入数据库脚本目录

cd  dist/script

修改数据库连接信息：

修改数据库名称：sed -i "s/webasechainmanager/${your_db_name}/g" webase.sh
修改数据库用户名：sed -i "s/defaultAccount/${your_db_account}/g" webase.sh
修改数据库密码：sed -i "s/defaultPassword/${your_db_password}/g" webase.sh

例如：将数据库用户名修改为root，则执行：

sed -i "s/defaultAccount/root/g" webase.sh

5.3 运行数据库脚本

执行命令：bash webase.sh ${dbIP} ${dbPort} 如：

bash webase.sh 127.0.0.1 3306

6. 服务配置及启停

6.1 服务配置修改

（1）回到dist目录，dist目录提供了一份配置模板conf_template：

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

（2）修改服务配置，完整配置项说明请查看 配置说明

修改服务端口：sed -i "s/5005/${your_server_port}/g" conf/application.yml
修改数据库IP：sed -i "s/127.0.0.1/${your_db_ip}/g" conf/application.yml
修改数据库端口：sed -i "s/3306/${your_db_port}/g" conf/application.yml
修改数据库名称：sed -i "s/webasechainmanager/${your_db_name}/g" conf/application.yml
修改数据库用户：sed -i "s/defaultAccount/${your_db_account}/g" conf/application.yml
修改数据库密码：sed -i "s/defaultPassword/${your_db_password}/g" conf/application.yml

6.2 服务启停

在dist目录下执行：

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

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

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

注意：使用接口搭链后，需要妥善保存项目目录（如/dist）中的NODES_ROOT目录，其中保存了链的相关证书与证书私钥。

7 访问

WeBASE链管理平台示例页面：

http://{deployIP}:{deployPort}/WeBASE-Chain-Manager
示例：http://localhost:5005/WeBASE-Chain-Manager

如果只调用接口，可以通过swagger查看调用接口：

http://{deployIP}:{deployPort}/WeBASE-Chain-Manager/swagger-ui.html
示例：http://localhost:5005/WeBASE-Chain-Manager/swagger-ui.html

备注：

• 部署服务器IP和服务端口需对应修改，网络策略需开通

8 查看日志

在dist目录查看：

全量日志：tail -f log/WeBASE-Chain-Manager.log
错误日志：tail -f log/WeBASE-Chain-Manager-error.log