升级说明

WeBASE-Node-Manager升级的兼容性说明，请结合WeBASE-Node-Manager Changelog进行阅读

WeBASE-Node-Manager升级的必须步骤：

  1. 备份已有文件或数据，下载新的安装包（可参考安装包下载）
  2. 使用新的安装包，并将旧版本yml已有配置添加到新版本yml中；可通过diff aFile bFile命令对比新旧yml的差异
  3. 查看节点管理服务升级文档中对应版本是否需要修改数据表，若不需要升级则跳过 3.1 若需要升级数据表，首先使用mysqldump命令备份数据库 3.2 按照升级文档指引，操作数据表
  4. bash stop.sh && bash start.sh重启

各个版本的具体修改可参考下文

v1.5.4

  • 优化合约仓库加载方式，通过conf/warehouse目录中的.json文件加载合约模板
  • 修复可视化部署中检测localhost的误判
  • 更新可视化部署的build_chain脚本
  • 修复查询event获取合约时重复的问题
  • 修复根据nodeId获取节点信息接口入参

v1.5.3

  • 合约仓库新增代理合约模板、溯源合约模板
  • 新增公钥用户绑定私钥功能
  • 新增导出私钥功能，导出格式为带密码的P12文件
  • 新增节点备注城市、IP与机构功能，新增群组备注群组信息功能，用于监控大屏展示
  • 优化冻结/解冻合约获取合约管理员获取
  • 优化观察节点同步区块状态显示
  • 修复游离节点设为共识节点失败问题
  • 修复重复编译合约提示“合约已存在”问题
  • 修复对v2.6.0节点的兼容问题

数据表更新

执行webase-node-mgr中script/upgrade目录中的v152_v153.sql即可更新数据表，可通过mysql -e source v152_v153.sql命令执行

  • 注：更新前提前备份mysql数据

v1.5.2

  • 优化合约IDE Java项目导出功能，支持多用户与channel端口检查
  • 合约仓库新增Asset资产合约
  • 优化免登陆鉴权模式、增加Swagger、支持开发者导出私钥、支持合约IDE绑定合约地址
  • 修复异常合约列表排序、修复获取区块头接口

数据表更新

执行webase-node-mgr中script/upgrade目录中的v151_v152.sql即可更新数据表，可通过mysql -e source v151_v152.sql命令执行

  • 注：更新前提前备份mysql数据

更新详情如下

数据表字段修改

  • tb_config配置信息表增加可视化部署的v2.8.0的配置信息
  • tb_node节点信息表增加了city字段，类型为varchar(64)，默认为空
  • tb_node节点信息表增加了agency字段，类型为varchar(64)，默认为空
  • tb_node节点信息表node_name字段长度更新为varchar(255)

v1.5.1

  • 新增导出合约Java工程脚手架
  • 新增合约仓库接口
  • 新增全量用户/合约通过地址搜索功能
  • 优化开发者模式下鉴权，修复开发者模式下删除合约目录问题
  • 优化应用管理中合约同步速度过慢问题
  • 修复交易审计中异常数据总数错误问题

数据表更新

执行webase-node-mgr中script/upgrade目录中的v150_v151.sql即可更新数据表，可通过mysql -e source v150_v151.sql命令执行

  • 注：更新前提前备份mysql数据

更新详情如下

数据表字段修改

  • tb_contract_path合约IDE目录信息表新增account字段，类型为varchar(50)，默认值为admin

数据表结构更改

  • 新增了合约仓库合约信息表tb_contract_item
  • 新增了合约仓库目录信息表tb_contract_folder
  • 新增了合约仓库信息表tb_warehouse

v1.5.0

  • 新增应用管理，支持WeIdentity模板和自定义应用接入
  • 新增节点监控的链上TPS、出块周期、块大小的统计
  • 新增合约列表中的已登记合约与链上全量合约视图、新增私钥用户列表中的已登记私钥与链上全量私钥视图
  • 支持导出Txt/Pem/P12/WeID私钥文件、支持导出前置的SDK证书
  • Web3SDK切换到JavaSDK

数据表更新

执行webase-node-mgr中script/upgrade目录中的v143_v150.sql即可更新数据表，可通过mysql -e source v143_v150.sql命令执行

  • 注：更新前提前备份mysql数据

更新详情如下

数据表字段修改

  • tb_app_info中插入WeIdentity示例应用信息
  • tb_contract表中修改contract_path字段长度为varchar(128)
  • tb_cns表中修改contract_path字段长度为varchar(128)，DEFAULT NULL
  • tb_contract_path表中修改contract_path字段长度为varchar(128)
  • tb_abi表中移除唯一约束unique_name

数据表结构更改

  • 新增了应用信息表tb_app_info
  • 新增了应用仓库信息表tb_contract_store
  • 新增了区块统计数据表tb_stat
  • 新增了外部合约信息表tb_external_contract
  • 新增了外部账户信息表tb_external_account

v1.4.3

  • 拆分可视化部署步骤为：添加主机、初始化主机、部署节点
  • 可视化部署支持同机部署节点、支持自动拉取镜像
  • 可视化部署使用ansible，并完善各个步骤的检测脚本
  • 支持注册CNS合约

数据表更新

字段更新：

  • tb_contract表中bytecodeBin的列名修改为bytecode_bin，并对应更新了conf/mapper/ContractMapper.xml文件
  • tb_host表中remark字段从varchar修改为text类型，移除了agency_id，agency_name，docker_port字段，唯一约束改为UNIQUE KEY unique_ip (ip) USING BTREE
  • tb_user表增加地址的唯一约束UNIQUE KEY unique_address (group_id,address)
  • tb_front_group_map中增加默认值为1的节点类型字段type tinyint(4) DEFAULT 1 COMMENT '节点的共识类型：1-共识节点（默认），2-观察节点'

数据表具体更新方法可根据实际情况自行制定

数据表新增：

  • 新增合约CNS信息表tb_cns
  1. CREATE TABLE IF NOT EXISTS tb_cns (
  2.   id int(11) NOT NULL AUTO_INCREMENT COMMENT '编号',
  3.   group_id int(11) NOT NULL COMMENT '群组ID',
  4.   contract_path varchar(24) binary NOT NULL COMMENT '合约所在目录',
  5.   contract_name varchar(120) binary NOT NULL COMMENT '合约名称',
  6.   cns_name varchar(120) binary NOT NULL COMMENT 'cns名称',
  7.   version varchar(120) DEFAULT NULL COMMENT 'cns版本',
  8.   contract_address varchar(64) DEFAULT NULL COMMENT '合约地址',
  9.   create_time datetime DEFAULT NULL COMMENT '创建时间',
  10.   modify_time datetime DEFAULT NULL COMMENT '修改时间',
  11.   PRIMARY KEY (id),
  12.   UNIQUE KEY uk_path_name (group_id,contract_path,contract_name)
  13. ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='cns信息表';

v1.4.2

  • 新增了合约EventLog查询功能

数据表更新

字段更新：

  • tb_contract表中bytecodeBin的列名修改为bytecode_bin，并对应更新了conf/mapper/ContractMapper.xml文件

数据表新增：

  • 新增合约路径信息表tb_contract_path
  1. CREATE TABLE IF NOT EXISTS tb_contract_path (
  2.   id int(11) NOT NULL AUTO_INCREMENT COMMENT '合约路径编号',
  3.   contract_path varchar(24) binary NOT NULL COMMENT '合约所在目录',
  4.   group_id int(11) NOT NULL COMMENT '所属群组编号',
  5.   create_time datetime DEFAULT NULL COMMENT '创建时间',
  6.   modify_time datetime DEFAULT NULL COMMENT '修改时间',
  7.   PRIMARY KEY (id),
  8.   UNIQUE KEY uk_group_path_name (group_id,contract_path)
  9. ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='合约路径表';

v1.4.1

新增FISCO BCOS v2.5.0及以上版本的基于角色的权限管理功能，新增了开发者模式

  • 新的权限管理基于角色，可参考FISCO BCOS权限控制文档
  • 开发者模式：新增了用户角色developer，可进行查询交易，合约部署调用等功能，无法使用管理员的系统管理与监控等功能。

数据表更新

登录 MySQL 后，选择数据库 use webasenodemanager; 后，按顺序执行下面的 SQL 语句进行 DB 升级。

数据表字段新增

  • 新增了tb_user, tb_contract中的account字段，并更新了唯一约束。
  • 用户角色表tb_role中新增了默认值developer
  • 合约表tb_contract中新增了deploy_address和deploy_user_name字段，记录部署的私钥用户信息
  1. -- tb_user修改
  2. alter table tb_user add column account varchar(50) binary NOT NULL COMMENT '关联账号';
  3. alter table tb_user drop index `unique_name`
  4. alter table tb_user add UNIQUE KEY `unique_name` (group_id,user_name,account);
  6. -- tb_contract修改
  7. alter table tb_contract add column account varchar(50) binary NOT NULL COMMENT '关联账号';
  8. alter table tb_contract drop index `uk_group_path_name`
  9. alter table tb_contract add UNIQUE KEY uk_group_path_name (group_id,contract_path,contract_name,account);
  10. alter table tb_contract add column deploy_address varchar(64) DEFAULT NULL COMMENT '合约部署者地址';
  11. alter table tb_contract add column deploy_user_name varchar(64) DEFAULT NULL COMMENT '合约部署者用戶名';
  12. -- tb_role修改
  13. INSERT INTO `tb_role` (role_name,role_name_zh,create_time,modify_time)VALUES ('developer', '开发者', now(), now());

数据表结构更改

  • 新增了链委员管理投票信息表tb_govern_vote
  1. CREATE TABLE IF NOT EXISTS tb_govern_vote (
  2.   id int(11) unsigned NOT NULL AUTO_INCREMENT COMMENT '链治理委员投票记录ID',
  3.   group_id int(11) NOT NULL COMMENT '群组ID',
  4.   time_limit bigint DEFAULT NULL COMMENT '投票截止块高',
  5.   from_address varchar(64) NOT NULL COMMENT '管理员地址',
  6.   type tinyint(8) NOT NULL COMMENT '投票类型，1-选举，2-去除，3-修改委员权重，4,-修改阈值',
  7.   to_address varchar(64) DEFAULT NULL COMMENT '选举/去除的地址',
  8.   detail varchar(64) DEFAULT NULL COMMENT '3-修改权重，4-修改阈值时存储具体信息',
  9.   create_time datetime NOT NULL COMMENT '创建时间',
  10.   modify_time datetime NOT NULL COMMENT '最近一次更新时间',
  11.   PRIMARY KEY (id)
  12. ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='链治理委员投票信息';

v1.4.0

v1.4.0 新增了可视化部署区块链的功能，同时支持节点的动态管理（扩容、停止、删除等）功能，同时兼容原有的手动搭链添加WeBASE-Front节点前置的模式

注：在运行WeBASE-Node-Manager前要选择在下面两种模式中二选一：

  1. 添加前置方式
  2. 可视化部署方式

提示：如果要体验完整的可视化部署，可通过可视化部署的安装指引，通过一键部署或手动部署安装子系统进行搭建

数据库结构变更

  • 登录 MySQL 后，选择数据库 use webasenodemanager; 后，按顺序执行下面的 SQL 语句进行 DB 升级。
  • 合约abi与bin相关字段的类型修改，修改 text 类型到 mediumtext
  1. ALTER TABLE `tb_abi` MODIFY COLUMN `contract_abi` mediumtext CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL COMMENT '合约ABI的内容';
  2. ALTER TABLE `tb_abi` MODIFY COLUMN `contract_bin` mediumtext CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL COMMENT '合约ABI的runtime-bin';
  4. ALTER TABLE `tb_contract` MODIFY COLUMN `contract_abi` mediumtext CHARACTER SET utf8 COLLATE utf8_general_ci NULL COMMENT '编译合约生成的abi文件内容';
  5. ALTER TABLE `tb_contract` MODIFY COLUMN `contract_bin` mediumtext CHARACTER SET utf8 COLLATE utf8_general_ci NULL COMMENT '合约binary';
  6. ALTER TABLE `tb_contract` MODIFY COLUMN `bytecodeBin` mediumtext CHARACTER SET utf8 COLLATE utf8_general_ci NULL COMMENT '合约bin';
  8. ALTER TABLE `tb_front_group_map` MODIFY COLUMN `status` int(11) NOT NULL DEFAULT 1 COMMENT '节点（前置）的群组状态，1-normal，2-invalid';
  9. ALTER TABLE `tb_group` MODIFY COLUMN `group_status` int(1) NULL DEFAULT 1 COMMENT '状态（1-正常 2-异常 3-脏数据冲突 4-创世块冲突）';
  • 新增字段
  1. ALTER TABLE `tb_group` ADD COLUMN `chain_id` int(10) UNSIGNED NULL DEFAULT 0 COMMENT '所属链 ID';
  3. ALTER TABLE `tb_group` ADD COLUMN `chain_name` varchar(64) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '' COMMENT '所属链名称，冗余字段';
  4. ALTER TABLE `tb_group` ADD UNIQUE INDEX `unique_chain_id_group_id`(`chain_id`, `group_id`) USING BTREE;
  6. ALTER TABLE `tb_front` ADD COLUMN `support_version` varchar(32) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '节点兼容版本';
  7. ALTER TABLE `tb_front` ADD COLUMN `front_version` varchar(32) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '节点前置版本号';
  8. ALTER TABLE `tb_front` ADD COLUMN `sign_version` varchar(32) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL COMMENT '节点前置对应签名服务版本号';
  10. ALTER TABLE `tb_front` MODIFY COLUMN `front_port` int(11) NOT NULL COMMENT '前置服务端口';
  11. ALTER TABLE `tb_front` MODIFY COLUMN `status` int(11) NULL DEFAULT 1 COMMENT '前置服务状态：0，初始化；1，运行；2，停止；3，启动；4，添加中；5，添加失败';
  12. ALTER TABLE `tb_front` MODIFY COLUMN `create_time` datetime(0) NOT NULL COMMENT '创建时间';
  13. ALTER TABLE `tb_front` MODIFY COLUMN `modify_time` datetime(0) NOT NULL COMMENT '修改时间';
  14. ALTER TABLE `tb_front` ADD COLUMN `run_type` tinyint(8) UNSIGNED NULL DEFAULT 0 COMMENT '运行方式：0，命令行；1，Docker';
  15. ALTER TABLE `tb_front` ADD COLUMN `agency_id` int(10) UNSIGNED NULL DEFAULT 0 COMMENT '所属机构 ID';
  16. ALTER TABLE `tb_front` ADD COLUMN `agency_name` varchar(64) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '' COMMENT '所属机构名称，冗余字段, 跟 agency 字段相同'
  17. ALTER TABLE `tb_front` ADD COLUMN `host_id` int(10) UNSIGNED NULL DEFAULT 0 COMMENT '所属主机';
  18. ALTER TABLE `tb_front` ADD COLUMN `host_index` int(6) NULL DEFAULT 0 COMMENT '一台主机可能有多个节点。表示在主机中的编号，从 0 开始编号';
  19. ALTER TABLE `tb_front` ADD COLUMN `image_tag` varchar(64) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '' COMMENT '运行的镜像版本标签';
  20. ALTER TABLE `tb_front` ADD COLUMN `container_name` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '' COMMENT 'Docker 启动的容器名称';
  21. ALTER TABLE `tb_front` ADD COLUMN `jsonrpc_port` int(6) NULL DEFAULT 8545 COMMENT 'jsonrpc 端口';
  22. ALTER TABLE `tb_front` ADD COLUMN `p2p_port` int(6) NULL DEFAULT 30303 COMMENT 'p2p 端口';
  23. ALTER TABLE `tb_front` ADD COLUMN `channel_port` int(6) NULL DEFAULT 20200 COMMENT 'channel 端口';
  24. ALTER TABLE `tb_front` ADD COLUMN `chain_id` int(10) UNSIGNED NULL DEFAULT 0 COMMENT '所属链 ID';
  25. ALTER TABLE `tb_front` ADD COLUMN `chain_name` varchar(64) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '' COMMENT '所属链名称，冗余字段';
  27. ALTER TABLE `tb_front` ADD UNIQUE INDEX `unique_agency_id_host_id_front_port`(`agency_id`, `front_ip`, `front_port`) USING BTREE;
  • 机构信息表tb_agency, 链信息表tb_chain, 系统配置信息表tb_config, 物理主机信息表tb_host
  1. CREATE TABLE `tb_agency`  (
  2.   `id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '自增长 ID',
  3.   `agency_name` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '机构名称',
  4.   `agency_desc` varchar(1024) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT '' COMMENT '机构描述信息',
  5.   `chain_id` int(10) UNSIGNED NOT NULL DEFAULT 0 COMMENT '所属链 ID',
  6.   `chain_name` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT '' COMMENT '所属链名称，冗余字段',
  7.   `create_time` datetime(0) NOT NULL COMMENT '创建时间',
  8.   `modify_time` datetime(0) NOT NULL COMMENT '最近一次更新时间',
  9.   PRIMARY KEY (`id`) USING BTREE,
  10.   UNIQUE INDEX `uniq_chain_id_agency_name`(`chain_id`, `agency_name`) USING BTREE
  11. ) ENGINE = InnoDB CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci COMMENT = '机构信息表' ROW_FORMAT = Dynamic;
  13. CREATE TABLE `tb_chain`  (
  14.   `id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '自增长 ID',
  15.   `chain_name` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '链名称',
  16.   `chain_desc` varchar(1024) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL COMMENT '链描述信息',
  17.   `version` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL DEFAULT '' COMMENT '创建链时选择的镜像版本',
  18.   `encrypt_type` tinyint(8) UNSIGNED NOT NULL DEFAULT 1 COMMENT '加密类型：1，标密；2，国密；默认 1 ',
  19.   `chain_status` tinyint(8) UNSIGNED NOT NULL DEFAULT 0 COMMENT '0: 初始化；1，部署中；2，部署失败；3，运行；4，重启中；5，升级过；6，升级失败',
  20.   `root_dir` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL DEFAULT '/opt/fisco-bcos' COMMENT '主机存放节点配置文件的根目录，可能存放多个节点配置',
  21.   `webase_sign_addr` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL DEFAULT '127.0.0.1:5004' COMMENT 'WeBASE-Sign 的访问地址',
  22.   `create_time` datetime(0) NOT NULL COMMENT '创建时间',
  23.   `modify_time` datetime(0) NOT NULL COMMENT '最近一次更新时间',
  24.   `run_type` tinyint(8) UNSIGNED NULL DEFAULT 0 COMMENT '运行方式：0，命令行；1，Docker',
  25.   PRIMARY KEY (`id`) USING BTREE,
  26.   UNIQUE INDEX `uniq_chain_name`(`chain_name`) USING BTREE
  27. ) ENGINE = InnoDB CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci COMMENT = '链信息表' ROW_FORMAT = Dynamic;
  29. CREATE TABLE `tb_config`  (
  30.   `id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '自增长 ID',
  31.   `config_name` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '配置名称',
  32.   `config_type` int(10) NOT NULL DEFAULT 0 COMMENT '配置类型',
  33.   `config_value` varchar(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL DEFAULT '' COMMENT '配置值',
  34.   `create_time` datetime(0) NOT NULL COMMENT '创建时间',
  35.   `modify_time` datetime(0) NOT NULL COMMENT '最近一次更新时间',
  36.   PRIMARY KEY (`id`) USING BTREE
  37. ) ENGINE = InnoDB CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci COMMENT = '系统配置信息表' ROW_FORMAT = Dynamic;
  39. CREATE TABLE `tb_host`  (
  40.   `id` int(10) UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '自增长 ID',
  41.   `agency_id` int(10) UNSIGNED NOT NULL DEFAULT 1 COMMENT '所属机构 ID',
  42.   `agency_name` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL COMMENT '所属机构名称，冗余字段',
  43.   `ip` varchar(16) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '主机IP',
  44.   `ssh_user` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL DEFAULT 'root' COMMENT 'SSH 登录账号',
  45.   `ssh_port` int(10) UNSIGNED NOT NULL DEFAULT 22 COMMENT 'SSH 端口',
  46.   `root_dir` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL DEFAULT '/opt/fisco-bcos' COMMENT '主机存放节点配置文件的根目录，可能存放多个节点配置',
  47.   `docker_port` int(10) UNSIGNED NOT NULL DEFAULT 2375 COMMENT 'Docker demon 的端口',
  48.   `status` tinyint(8) UNSIGNED NOT NULL DEFAULT 0 COMMENT '主机状态：0，新建；1，初始化；2，初始化成功；3，初始化失败',
  49.   `remark` varchar(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT '' COMMENT 'remark',
  50.   `create_time` datetime(0) NOT NULL COMMENT '创建时间',
  51.   `modify_time` datetime(0) NOT NULL COMMENT '最近一次更新时间',
  52.   PRIMARY KEY (`id`) USING BTREE,
  53.   UNIQUE INDEX `unq_agency_id,ip`(`agency_id`, `ip`) USING BTREE
  54. ) ENGINE = InnoDB CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci COMMENT = '物理主机信息' ROW_FORMAT = Dynamic;
  • 插入常量数据
  1. INSERT INTO `tb_config`(`config_name`, `config_type`, `config_value`, `create_time`, `modify_time`) VALUES ('docker 镜像版本', 1, 'v2.5.0', '2020-07-22 17:14:23', '2020-07-22 17:14:23');
  2. INSERT INTO `tb_config`(`config_name`, `config_type`, `config_value`, `create_time`, `modify_time`) VALUES ('docker 镜像版本', 1, 'v2.5.0-gm', '2020-07-22 17:14:23', '2020-07-22 17:14:23');

v1.3.2

移除fastjson

  • 移除Fastjson，替换为Jackson 2.11.0。
  • 升级web3sdk为2.4.1，并升级springboot等依赖项

v1.3.1

v1.3.1主要新增了动态群组接口、导入abi接口、导入私钥接口、定时任务优化等功能，详情升级说明如下：

新增动态群组接口

  • 新增动态群组接口，包含生成群组、启动/停止群组、删除/恢复群组、单个/批量查询群组状态等接口

注：节点生成新群组或加入新群组需要对节点进行三步操作：生成群组、启动群组、节点加入群组共识节点/观察节点；如何通过WeBASE页面操作可参考动态群组管理使用指南

接口详情可参考接口文档中群组管理模块的动态群组接口说明

新增导入已部署合约Abi功能、合约Abi编码器

  • 新增导入合约abi接口，可以导入已部署的合约进行管理

新增导入.p12私钥用户

  • 新增导入.p12/.pem/.txt私钥接口；其中.txt与节点前置导出私钥格式一致，.p12/.pem与控制台导出私钥格式一致；

定时任务优化

  • 定时任务并行化，可通过yml配置线程池大小，线程阻塞时长等加快拉取区块、拉取交易

数据表的字段修改

  • tb_front新增status字段，用于记录已添加的节点前置的状态，与节点状态同步，每过7.5秒更新一次；同时每请求一次节点前置会更新前置状态（每次更新至少间隔3秒）
  • 新增tb_abi数据表，用于记录导入的合约abi
  • tb_group数据表新增字段：
    • group_status字段新增两种状态，全部状态包括：1-normal, 2-maintaining, 3-dirty-data, 4-conflict-genesis
    • group_desc字段修改为description，记录群组的描述内容
    • 新增group_timestamp记录动态创建群组的创世块时间戳
    • 新增node_id_list记录动态创建群组的创世块共识节点列表
  • tb_front_group_map数据表新增status字段，记录节点前置某一群组的状态（1-可用，2-不可用）

数据表升级操作

登陆mysql后，进入到相应database中，以webasenodemanager的database为例；

  1. mysql -uroot -p123456
  3. // mysql 命令行
  4. mysql> use webasenodemanager;
  6. // tb_front表新增status字段
  7. mysql> alter table tb_front add column status int(11) DEFAULT 1 COMMENT '前置服务状态';
  9. // 新增tb_abi表
  10. mysql> CREATE TABLE IF NOT EXISTS tb_abi (
  11.   abi_id int(11) NOT NULL AUTO_INCREMENT COMMENT '合约ABI的编号',
  12.   group_id int(11) NOT NULL COMMENT '合约ABI所属群组的编号',
  13.   contract_name varchar(120) NOT NULL COMMENT '合约ABI的合约名',
  14.   contract_address varchar(64) NOT NULL COMMENT '合约ABI的合约地址',
  15.   contract_abi text NOT NULL COMMENT '合约ABI的内容',
  16.   contract_bin text NOT NULL COMMENT '合约ABI的runtime-bin',
  17.   create_time datetime DEFAULT NULL COMMENT '合约ABI的创建时间',
  18.   modify_time datetime DEFAULT NULL COMMENT '合约ABI的修改时间',
  19.   PRIMARY KEY (abi_id),
  20.   UNIQUE KEY unique_address (group_id,contract_address),
  21.   UNIQUE KEY unique_name (group_id,contract_name)
  22. ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='合约ABI表';
  24. // tb_group新增description、group_timestamp、node_id_list字段
  25. mysql> alter table tb_group add column description varchar(1024) COMMENT '群组描述';
  26. mysql> alter table tb_group add column group_timestamp varchar(64) COMMENT '群组创世块时间戳';
  27. mysql> alter table tb_group add column node_id_list text COMMENT '群组成员节点的ID';
  29. // tb_front_group_map新增status字段
  30. mysql> alter table tb_front_group_map add column status int(11) DEFAULT 1 NOT NULL COMMENT '节点（前置）的群组状态';

v1.3.0

WeBASE-Node-Manager v1.3.0后，将通过WeBASE-Sign来管理私钥和对交易签名，可查看以下升级说明进行修改：

  1. 私钥用户数据表tb_user新增字段sign_user_id和app_id
  2. 将WeBASE-Node-Manager的私钥数据移植到WeBASE-Sign数据库

生成私钥的流程 ../../_images/new_generate_pri1.png使用sign生成私钥的流程

交易签名的流程 ../../_images/new_tx_sign1.png使用sign交易签名的流程

私钥用户数据表字段新增

  • 数据库中的tb_user新增了varchar类型的字段sign_user_id和app_id，其中signUserId会在新建私钥时用随机的UUID String赋值并保存；

tb_user表字段的修改：

  1. CREATE TABLE IF NOT EXISTS tb_user (
  2.   user_id int(11) NOT NULL AUTO_INCREMENT COMMENT '用户编号',
  3.   user_name varchar(64) binary NOT NULL COMMENT '用户名',
  4.   ...
  5.   sign_user_id varchar(64) NOT NULL COMMENT '签名服务中的user的业务id',
  6.   app_id varchar(64) DEFAULT NULL COMMENT '区块链应用的编号',
  7.   ...
  8.   UNIQUE KEY unique_uuid (sign_user_id)
  9. ) ENGINE=InnoDB AUTO_INCREMENT=700001 DEFAULT CHARSET=utf8 COMMENT='用户信息表';

新增字段升级操作说明

登陆mysql后，进入到相应database中，以webasenodemanager的database为例；

  1. mysql -uroot -p123456
  3. // mysql 命令行
  4. mysql> use webasenodemanager;
  6. // 在tb_user中添加列
  7. mysql> alter table tb_user add column sign_user_id varchar(64) default null;
  8. mysql> alter table tb_user add column app_id varchar(64) not null;
  10. // 添加sign_user_id的唯一约束
  11. mysql> alter table tb_user add unique key unique_uuid (sign_user_id);
  13. // 生成唯一的sign_user_id和app_id
  14. ...
  15. // 为已存在的用户的sign_user_id和app_id赋值
  16. ...

注意，WeBASE-Node-Manager赋值的sign_user_id与app_id将在私钥数据迁移时，一同赋值给WeBASE-Sign tb_user表的对应字段

私钥数据移植到WeBASE-Sign

  • WeBASE-Node-Manager的私钥将通过WeBASE-Sign托管（新建私钥、保存私钥和交易签名），不再由WeBASE-Front生成和保存（仅保存公钥与地址）；
  • WeBASE-Node-Manager将通过WeBASE-Front的/trans/handleWithSign接口和/contract/deployWithSign接口进行合约部署与交易

如已安装WeBASE-Sign，则按照WeBASE-Sign v1.3.0升级文档更新其tb_user表，再执行私钥数据转移操作；

如未安装WeBASE-Sign，则按照WeBASE-Sign安装文档配置环境并运行WeBASE-Sign后（运行WeBASE-Sign服务后会自动创建tb_user表），再执行私钥数据转移操作；

转移WeBASE-Node-Manager私钥到WeBASE-Sign的操作说明

用户需要通过以下操作将存于节点服务数据库(如webasenodemanager数据库)的私钥数据导出，并导入到WeBASE-Sign数据库(如webasesign数据库)中

  1. 由于保存到数据库的私钥值是经过AES加密后存储的，因此，需保证WeBASE-Front和WeBASE-Sign application.yml中的constant-aesKey字段的值一样；
  2. 在WeBASE-Node-Manager数据库中的tb_user表和tb_user_key_mapping表，获取所有WeBASE-Node-Manager的私钥数据，包括tb_user表中的sign_user_id和app_id（前文所插入的值），地址address与公钥publick_key，还有tb_user_key_mapping表中的私钥private_key；
  3. 在WeBASE-Sign数据库中，将上文获得的所有私钥数据按对应字段，执行insert操作，插入到其tb_user表中；

升级操作说明

登陆mysql，进入到相应database中，以webasenodemanager和webasesign的database为例；

  1. > mysql -uroot -p123456
  3. // 选择webase-node-manager数据库
  4. mysql> use webasenodemanager;
  6. // 使用left join查询所有私钥数据(address,public_key,sign_user_id,app_id,private_key)
  7. mysql> select a.address,a.public_key,a.sign_user_id,a.app_id,b.private_key from tb_user a left join tb_user_key_mapping b on(a.user_id=b.user_id) where b.map_status=1
  9. // 选择webase-sign数据库进行插入操作
  10. mysql> use webasesign;
  12. // 将上述操作获取的(address,public_key,sign_user_id,app_id,private_key)插入到webase-sign的tb_user表
  13. // 略

v1.2.2

国密支持说明

国密版FISCO-BCOS与非国密版不可互通，同理，WeBASE组件的国密与非国密也不可互通，因此如果需要切换到国密版，需要重新建链与搭建WeBASE平台

可根据WeBASE一键部署重新搭建国密的FISCO BCOS + WeBASE平台

详细子系统的国密参数设置可参考FISCO-BCOS 国密支持、WeBASE-Node-Manager 国密支持和WeBASE-Front 国密支持

  1. 初始化数据修改：数据表的tb_method默认数据需要替换为国密版默认数据，可参考项目中scripts/gm中的webase-dml-gm.sql中的第5项进行数据初始化；

兼容性说明：中英文支持，优化部分功能

  1. 初始化数据修改：数据表tb_alert_rule默认数据支持中英文告警，可结合项目中scripts/webase-dml.sql第6项进行数据更新；
  2. 数据表字段增加：数据表tb_front增加一列client_version，用于记录节点版本与是否为国密；
  3. 数据表字段增加：动态增加的数据表tb_trans_hash_x增加一列trans_number，用于记录交易数；该更改无法与前一版本兼容；如需升级v1.2.2，可根据下文将getCountByMinMax()方法替换为原来的getCount()方法

升级中英文告警操作说明

登陆mysql后，进入到相应database中，以webasenodemanager的database为例；

  1. mysql -uroot -p123456
  3. // mysql 命令行
  4. mysql> use webasenodemanager;

可以参考WeBASE-Node-Manager v1.2.2源码中的webase-dml.sql

  • 修改tb_alert_rule的默认数据：
  1. // 删除原有数据
  2. mysql> delete * from tb_alert_rule where 1=1;
  4. // 插入新的中英文数据
  5. ---- add node status alert rule template
  6. INSERT INTO `tb_alert_rule`(`rule_name`,`enable`,`alert_type`,`alert_level`,`alert_interval_seconds`,`alert_content`,`content_param_list`,`create_time`,`modify_time`) VALUES ('节点异常告警/Node Exception', 0, 1, 1, 3600, '{nodeId}节点异常，请到“节点管理”页面查看具体信息 / Node: {nodeIdEn} node status exception，please check out in \"Node Management\"', '[\"{nodeId}\", \"{nodeIdEn}\"]', '2019-10-29 20:02:30', '2019-10-29 20:02:30');
  7. ---- add audit alert rule template
  8. INSERT INTO `tb_alert_rule`(`rule_name`,`enable`,`alert_type`,`alert_level`,`alert_interval_seconds`,`alert_content`,`content_param_list`,`create_time`,`modify_time`) VALUES ('审计异常告警/Audit Exception', 0, 2, 1, 3600, '审计异常：{auditType}，请到“交易审计”页面查看具体信息 / Audit alert: {auditTypeEn}，please check out in \"Transaction Audit\"', '[\"{auditType}\", \"{auditTypeEn}\"]', '2019-10-29 20:02:30', '2019-10-29 20:02:30');
  9. -- add cert alert rule template
  10. INSERT INTO `tb_alert_rule`(`rule_name`,`enable`,`alert_type`,`alert_level`,`alert_interval_seconds`,`alert_content`,`content_param_list`,`create_time`,`modify_time`) VALUES ('证书有效期告警/Cert Validity Exception', 0, 3, 1, 3600, '证书将在{time}过期，请到“证书管理”页面查看具体信息 / Cert validity exception：invalid at {timeEn}，please check out in \"Cert Management\"', '[\"{time}\", \"{timeEn}\"]', '2019-10-29 20:02:30', '2019-10-29 20:02:30');

数据表字段增加-tb_front

  • 获取Front的IP与端口，登陆mysql同上操作
  1. mysql> select * from tb_front;
  3. +----------+----------------------------------------------------------------------------------------------------------------------------------+------------+------------+--------+---------------------+---------------------+----------------+
  4. | front_id | node_id                                                                                                                          | front_ip   | front_port | agency | create_time         | modify_time         | client_version |
  5. +----------+----------------------------------------------------------------------------------------------------------------------------------+------------+------------+--------+---------------------+---------------------+----------------+
  6. |   500001 | b44c4f713b40b67ed2f9dae2ef208808b7f31112efe1a822de046604fe0bbdffdf46b7c0cf1ca9aa468752d514958cb603670a6d345c78faff6e69d825e851b8 | 127.0.0.1 |       5002 | agency0     | 2019-12-23 17:57:35 | 2019-12-23 17:57:35 | 2.1.0 gm       |
  7. +----------+----------------------------------------------------------------------------------------------------------------------------------+------------+------------+--------+---------------------+---------------------+----------------+
  8. 1 row in set (0.00 sec)
  • 获取相应Front的节点版本：通过访问WeBASE-Front的front_ip:front_port/{groupId}/web3/clientVersion接口获取节点版本FISCO-BCOS Version
  1. // 获取clientVersion
  2. curl http://front_ip:front_port/WeBASE-Front/1/web3/clientVersion
  4. // response:
  5. {
  6.     ...
  7.     "Chain Id": "1",
  8.     "FISCO-BCOS Version": "2.1.0 gm",
  9.     ...
  10. }
  • 在tb_front增加client_version一列
  • 更新其数据值为上面获取的FISCO-BCOS Version值，如国密节点2.1.0 gm
  1. mysql> alter table tb_front add column client_version varchar(32) NOT NULL COMMENT '节点版本（国密/非国密）';
  2. mysql> update tb_front set client_version='2.1.0 gm' where front_id='{front_id}';

数据表字段增加-tb_trans_hash_xx

  • 更新由TableService动态生成的数据表tb_trans_hash_xx的字段：该更改无法与前一版本兼容；

如需升级v1.2.2，可将代码中使用TransHashMapper/getCountByMinMax()方法替换为原来的getCount()方法

  1. package com.webank.webase.node.mgr.transaction;
  3. ...
  4. public Integer queryCountOfTranByMinus(int groupId)
  5.         throws NodeMgrException {
  6.     ...
  7.     try{
  8.       ...
  9.       // getCount(String tableName,TransParam transParam);
  10.       Integer count = transHashMapper.getCountByMinMax(tableName); 
  11.       ...
  12.     }
  13.     ...
  14.     }

v1.2.1

兼容性说明：增加邮件告警功能

  1. 数据表修改：增加了tb_mail_server_config邮箱服务器配置表（邮箱服务配置），tb_alert_rule告警规则表（告警类型配置），tb_alert_log告警日志表，可通过项目中scripts/webase-ddl.sql进行数据表初始化；
  2. 初始化数据修改：邮件告警功能的默认数据需要通过项目中scripts/webase-dml.sql的6, 7项进行数据初始化；

操作说明：

登陆mysql后，进入到相应database中，以webasenodemanager的database为例；

  1. mysql -uroot -p123456
  3. // mysql 命令行
  4. mysql> use webasenodemanager;

可以参考WeBASE-Node-Manager v1.2.1源码中的webase-ddl.sql与webase-dml.sql

  • 执行tb_alert_rule, tb_mail_server_config, tb_alert_log，建表操作
  1. // tb_alert_rule表
  2. mysql> CREATE TABLE IF NOT EXISTS tb_alert_rule (
  3.   rule_id int(11) NOT NULL AUTO_INCREMENT COMMENT '告警规则的ID',
  4.   rule_name varchar(50) NOT NULL COMMENT '告警规则的命名',
  5.   enable tinyint(4) DEFAULT 0 NOT NULL COMMENT '是否启用规则, 0:false, 1:true',
  6.   alert_type tinyint(4) NOT NULL COMMENT '告警规则的类型, 1-节点, 2-审计, 3-证书',
  7.   alert_level tinyint(4) NOT NULL COMMENT '告警规则的级别, 1-高, 2-中, 3-低',
  8.   alert_interval_seconds bigint NOT NULL COMMENT '告警规则的间隔时间(s)',
  9.   alert_content text NOT NULL COMMENT '告警邮件的内容',
  10.   content_param_list text NOT NULL COMMENT '告警邮件内容中的可替代参数，如nodeId',
  11.   description varchar(50) DEFAULT NULL COMMENT '告警规则的描述',
  12.   is_all_user tinyint(4) DEFAULT 0 COMMENT '是否选中所有用户, 0:false, 1:true',
  13.   user_list text DEFAULT NULL COMMENT '告警规则作用的用户列表',
  14.   create_time datetime DEFAULT NULL COMMENT '告警规则的创建时间',
  15.   modify_time datetime DEFAULT NULL COMMENT '告警规则的修改时间',
  16.   less_than varchar(40) DEFAULT NULL COMMENT '告警规则：小于某个值',
  17.   less_and_equal varchar(40) DEFAULT NULL COMMENT '告警规则：小于等于某个值',
  18.   larger_than varchar(40) DEFAULT NULL COMMENT '告警规则：大于某个值',
  19.   larger_and_equal varchar(40) DEFAULT NULL COMMENT '告警规则：大于等于某个值',
  20.   equal varchar(40) DEFAULT NULL COMMENT '告警规则：等于某个值',
  21.   last_alert_time datetime DEFAULT NULL COMMENT '上次告警的时间，与Interval间隔共同作用',
  22.   PRIMARY KEY (rule_id)
  23. ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='告警规则表';
  25. // tb_mail_server_config表
  26. mysql> CREATE TABLE IF NOT EXISTS tb_mail_server_config (
  27.   server_id int(11) NOT NULL AUTO_INCREMENT COMMENT '邮件服务器配置的ID',
  28.   server_name varchar(40) NOT NULL COMMENT '邮件服务器配置的命名',
  29.   host varchar(30) NOT NULL COMMENT '邮件服务器的主机',
  30.   port int(10) DEFAULT '25' NOT NULL COMMENT '邮件服务器的端口',
  31.   username varchar(40) NOT NULL COMMENT '邮件服务器的邮箱地址',
  32.   password varchar(40) NOT NULL COMMENT '邮件服务器的邮箱授权码',
  33.   protocol varchar(10) NOT NULL COMMENT '邮件服务器的协议',
  34.   default_encoding varchar(10) DEFAULT 'UTF-8' NOT NULL COMMENT '邮件服务器的默认编码(UTF-8)',
  35.   create_time datetime DEFAULT NULL COMMENT '邮件服务器配置的创建时间',
  36.   modify_time datetime DEFAULT NULL COMMENT '邮件服务器配置的修改时间',
  37.   authentication tinyint(4) DEFAULT 1 NOT NULL COMMENT '是否开启验证, 0:false, 1:true',
  38.   starttls_enable tinyint(4) DEFAULT 1 NOT NULL COMMENT '如支持，是否优先选用STARTTLS, 0:false, 1:true',
  39.   starttls_required tinyint(4) DEFAULT 0 COMMENT '是否必须使用STARTTLS, 0:false, 1:true',
  40.   socket_factory_port int(10) DEFAULT 465 COMMENT 'SSL的端口',
  41.   socket_factory_class varchar(150) DEFAULT 'javax.net.ssl.SSLSocketFactory' COMMENT 'SSL选用的JAVA类',
  42.   socket_factory_fallback tinyint(4) DEFAULT 0 COMMENT '是否启用SSL的fallback, 0:false, 1:true',
  43.   enable tinyint(4) DEFAULT 0 NOT NULL COMMENT '邮件服务器是否已配置完成，0初始，1完成',
  44.   connection_timeout int(10) DEFAULT 5000 NOT NULL COMMENT '邮件服务器的连接超时值',
  45.   timeout int(10) DEFAULT 5000 NOT NULL COMMENT '邮件服务器的通用超时值',
  46.   write_timeout int(10) DEFAULT 5000 NOT NULL COMMENT '邮件服务器的写超时值',
  47.   PRIMARY KEY (server_id)
  48. ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='邮件服务器配置表';
  50. // tb_alert_log表
  51. mysql> CREATE TABLE IF NOT EXISTS tb_alert_log (
  52.   log_id int(11) NOT NULL AUTO_INCREMENT COMMENT '告警日志的编号',
  53.   alert_type tinyint(4) NOT NULL COMMENT '告警日志的类型, 1-节点, 2-审计, 3-证书',
  54.   alert_level tinyint(4) NOT NULL COMMENT '告警日志的告警等级：1-high, 2-middle, 3-low',
  55.   alert_content text NOT NULL COMMENT '告警日志的内容',
  56.   description text DEFAULT NULL COMMENT '告警日志的描述',
  57.   status tinyint(4) NOT NULL DEFAULT '0' COMMENT '告警日志的状态：0-未处理，1-已处理',
  58.   create_time datetime DEFAULT NULL COMMENT '告警日志的创建时间',
  59.   modify_time datetime DEFAULT NULL COMMENT '告警日志的修改时间',
  60.   PRIMARY KEY (log_id)
  61. ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='告警日志表';
  • mysql下执行插入，初始化默认数据：
  1. ---- add node status alert rule template
  2. INSERT INTO `tb_alert_rule`(`rule_name`,`enable`,`alert_type`,`alert_level`,`alert_interval_seconds`,`alert_content`,`content_param_list`,`create_time`,`modify_time`) VALUES ('节点异常告警', 0, 1, 1, 3600, '{nodeId}节点异常，请到“节点管理”页面查看具体信息', '[\"{nodeId}\"]', '2019-10-29 20:02:30', '2019-10-29 20:02:30');
  3. ---- add audit alert rule template
  4. INSERT INTO `tb_alert_rule`(`rule_name`,`enable`,`alert_type`,`alert_level`,`alert_interval_seconds`,`alert_content`,`content_param_list`,`create_time`,`modify_time`) VALUES ('审计异常', 0, 2, 1, 3600, '审计异常：{auditType}，请到“交易审计”页面查看具体信息', '[\"{auditType}\"]', '2019-10-29 20:02:30', '2019-10-29 20:02:30');
  5. -- add cert alert rule template
  6. INSERT INTO `tb_alert_rule`(`rule_name`,`enable`,`alert_type`,`alert_level`,`alert_interval_seconds`,`alert_content`,`content_param_list`,`create_time`,`modify_time`) VALUES ('证书有效期告警', 0, 3, 1, 3600, '证书将在{time}过期，请到“证书管理”页面查看具体信息', '[\"{time}\"]', '2019-10-29 20:02:30', '2019-10-29 20:02:30');
  8. -- add mail_server_config template
  9. INSERT INTO `tb_mail_server_config`(`server_name`,`host`,`port`,`username`,`password`,`protocol`,`default_encoding`,`create_time`,`modify_time`,`authentication`,`starttls_enable`,`starttls_required`,`socket_factory_port`,`socket_factory_class`,`socket_factory_fallback`,`enable`) VALUES ('Default config', 'smtp.qq.com', '25', 'yourmail@qq.com', 'yourpassword','smtp', 'UTF-8','2019-10-29 20:02:30', '2019-10-29 20:02:30', 1, 1, 0, 465, 'javax.net.ssl.SSLSocketFactory', 0, 0);

v1.2.0

兼容性说明：增加证书管理功能

  1. 数据表修改：增加证书管理功能：增加了tb_cert数据表，可通过项目中scripts/webase-ddl.sql进行数据表初始化；；
  2. 数据表修改：数据表tb_method增加contract_type字段，用于判断合约方法method为普通合约或系统合约(precompiled)，同时添加了所有系统合约的method_id；可结合项目中scripts/webase-dml.sql第5项进行数据更新；

操作说明：

登陆mysql后，进入到相应database中，以webasenodemanager的database为例；

  1. mysql -uroot -p123456
  3. // mysql 命令行
  4. mysql> use webasenodemanager;
  • 执行tb_cert建表操作，
  1. mysql> CREATE TABLE IF NOT EXISTS tb_cert (
  2.   finger_print varchar(120) NOT NULL COMMENT '证书的指纹(唯一标记）',
  3.   cert_name varchar(60) NOT NULL COMMENT '证书id',
  4.   content text NOT NULL COMMENT 'cert(crt证书）的内容',
  5.   cert_type varchar(20) NOT NULL COMMENT '证书类型',
  6.   public_key varchar(150) DEFAULT NULL COMMENT '节点证书的公钥/编号(nodeid)',
  7.   address varchar(50) DEFAULT NULL COMMENT '节点证书的节点地址',
  8.   father varchar(120) NOT NULL COMMENT '父证书对应地址(fingerprint)',
  9.   validity_from datetime NOT NULL COMMENT '有效期开始',
  10.   validity_to datetime NOT NULL COMMENT '有效期截止',
  11.   modify_time datetime DEFAULT NULL COMMENT '修改时间',
  12.   create_time datetime DEFAULT NULL COMMENT '创建时间',
  13.   PRIMARY KEY (finger_print)
  14. ) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='证书信息表';
  • 在表tb_method增加contract_type列
  1. mysql> alter table tb_method add column contract_type tinyint(4) DEFAULT '0' COMMENT '合约类型(0-普通合约，1-系统合约)';
  • 在表tb_method插入系统合约的默认数据

可以参考WeBASE-Node-Manager v1.2.0源码中的webase-dml.sql

  1. -- (system config info 0x1000) setValueByKey
  2. INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0xbd291aef', 0, '{\"constant\":false,\"inputs\":[{\"name\":\"key\",\"type\":\"string\"},{\"name\":\"value\",\"type\":\"string\"}],\"name\":\"setValueByKey\",\"outputs\":[{\"name\":\"\",\"type\":\"int256\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"}', 'function', 1, '2019-09-02 16:32:30', '2019-09-02 16:32:30');
  3. -- (table factory 0x1001) createTable
  4. INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0x56004b6a', 0, '{\"constant\":false,\"inputs\":[{\"name\":\"tableName\",\"type\":\"string\"},{\"name\":\"key\",\"type\":\"string\"},{\"name\":\"valueField\",\"type\":\"string\"}],\"name\":\"createTable\",\"outputs\":[{\"name\":\"\",\"type\":\"int256\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"}', 'function', 1, '2019-09-02 16:32:30', '2019-09-02 16:32:30');
  5. -- (crud info 0x1002) update select remove insert(same as cns's insert)
  6. INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0x2dca76c1', 0, '{\"constant\":false,\"inputs\":[{\"name\":\"tableName\",\"type\":\"string\"},{\"name\":\"key\",\"type\":\"string\"},{\"name\":\"entry\",\"type\":\"string\"},{\"name\":\"condition\",\"type\":\"string\"},{\"name\":\"optional\",\"type\":\"string\"}],\"name\":\"update\",\"outputs\":[{\"name\":\"\",\"type\":\"int256\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"}', 'function', 1, '2019-09-02 16:32:30', '2019-09-02 16:32:30');
  7. INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0x983c6c4f', 0, '{\"constant\":true,\"inputs\":[{\"name\":\"tableName\",\"type\":\"string\"},{\"name\":\"key\",\"type\":\"string\"},{\"name\":\"condition\",\"type\":\"string\"},{\"name\":\"optional\",\"type\":\"string\"}],\"name\":\"select\",\"outputs\":[{\"name\":\"\",\"type\":\"string\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"}', 'function', 1, '2019-09-02 16:32:30', '2019-09-02 16:32:30');
  8. INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0xa72a1e65', 0, '{\"constant\":false,\"inputs\":[{\"name\":\"tableName\",\"type\":\"string\"},{\"name\":\"key\",\"type\":\"string\"},{\"name\":\"condition\",\"type\":\"string\"},{\"name\":\"optional\",\"type\":\"string\"}],\"name\":\"remove\",\"outputs\":[{\"name\":\"\",\"type\":\"int256\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"}', 'function', 1, '2019-09-02 16:32:30', '2019-09-02 16:32:30');
  9. INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0xa216464b', 0, '{\"constant\":false,\"inputs\":[{\"name\":\"name\",\"type\":\"string\"},{\"name\":\"version\",\"type\":\"string\"},{\"name\":\"addr\",\"type\":\"string\"},{\"name\":\"abi\",\"type\":\"string\"}],\"name\":\"insert\",\"outputs\":[{\"name\":\"\",\"type\":\"int256\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"}', 'function', 1, '2019-06-17 20:32:30', '2019-06-17 20:32:30');
  10. -- (consensus info node manage 0x1003) addObserver addSealer remove
  11. INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0x2800efc0', 0, '{\"constant\":false,\"inputs\":[{\"name\":\"nodeID\",\"type\":\"string\"}],\"name\":\"addObserver\",\"outputs\":[{\"name\":\"\",\"type\":\"int256\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"}', 'function', 1, '2019-09-02 16:32:30', '2019-09-02 16:32:30');
  12. INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0x89152d1f', 0, '{\"constant\":false,\"inputs\":[{\"name\":\"nodeID\",\"type\":\"string\"}],\"name\":\"addSealer\",\"outputs\":[{\"name\":\"\",\"type\":\"int256\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"}', 'function', 1, '2019-09-02 16:32:30', '2019-09-02 16:32:30');
  13. INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0x80599e4b', 0, '{\"constant\":false,\"inputs\":[{\"name\":\"nodeID\",\"type\":\"string\"}],\"name\":\"remove\",\"outputs\":[{\"name\":\"\",\"type\":\"int256\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"}', 'function', 1, '2019-09-02 16:32:30', '2019-09-02 16:32:30');
  14. -- (cns info 0x1004) selectByName selectByNameAndVersion // insert(ignored, same as crud's insert method: insert(string,string,string,string)
  15. INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0x819a3d62', 0, '{\"constant\":true,\"inputs\":[{\"name\":\"name\",\"type\":\"string\"}],\"name\":\"selectByName\",\"outputs\":[{\"name\":\"\",\"type\":\"string\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"}', 'function', 1, '2019-06-17 20:32:30', '2019-06-17 20:32:30');
  16. INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0x897f0251', 0, '{\"constant\":true,\"inputs\":[{\"name\":\"name\",\"type\":\"string\"},{\"name\":\"version\",\"type\":\"string\"}],\"name\":\"selectByNameAndVersion\",\"outputs\":[{\"name\":\"\",\"type\":\"string\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"}', 'function', 1, '2019-06-17 20:32:30', '2019-06-17 20:32:30');
  17. -- INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0xa216464b', 0, '{\"constant\":false,\"inputs\":[{\"name\":\"name\",\"type\":\"string\"},{\"name\":\"version\",\"type\":\"string\"},{\"name\":\"addr\",\"type\":\"string\"},{\"name\":\"abi\",\"type\":\"string\"}],\"name\":\"insert\",\"outputs\":[{\"name\":\"\",\"type\":\"int256\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"}', 'function', 1, '2019-06-17 20:32:30', '2019-06-17 20:32:30');
  18. -- (permission manage 0x1005) insert queryByName remove
  19. INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0x06e63ff8', 0, '{\"constant\":false,\"inputs\":[{\"name\":\"table_name\",\"type\":\"string\"},{\"name\":\"addr\",\"type\":\"string\"}],\"name\":\"insert\",\"outputs\":[{\"name\":\"\",\"type\":\"int256\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"}', 'function', 1, '2019-09-02 16:32:30', '2019-09-02 16:32:30');
  20. INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0x20586031', 0, '{\"constant\":true,\"inputs\":[{\"name\":\"table_name\",\"type\":\"string\"}],\"name\":\"queryByName\",\"outputs\":[{\"name\":\"\",\"type\":\"string\"}],\"payable\":false,\"stateMutability\":\"view\",\"type\":\"function\"}', 'function', 1, '2019-09-02 16:32:30', '2019-09-02 16:32:30');
  21. INSERT INTO `tb_method`(`method_id`, `group_id`, `abi_info`, `method_type`, `contract_type`, `create_time`, `modify_time`) VALUES ('0x44590a7e', 0, '{\"constant\":false,\"inputs\":[{\"name\":\"table_name\",\"type\":\"string\"},{\"name\":\"addr\",\"type\":\"string\"}],\"name\":\"remove\",\"outputs\":[{\"name\":\"\",\"type\":\"int256\"}],\"payable\":false,\"stateMutability\":\"nonpayable\",\"type\":\"function\"}', 'function', 1, '2019-09-02 16:32:30', '2019-09-02 16:32:30');

如果结果为以下则代表插入成功：

  1. // 插入成功
  2. Query OK, 1 row affected (0.01 sec)
  3. // 数据已存在
  4. ERROR 1062 (23000): Duplicate entry '0x20586031-0' for key 'PRIMARY'