JD Chain

JD Chain是京东数科开源的区块链平台,目标是实现一个面向企业应用场景的通用区块链框架系统,能够作为企业级基础设施,为业务创新提供高效、灵活和安全的解决方案。

JD Chain通过节点实现信息之间的交互,不同类型的节点可以在同一物理服务器上部署运行。JD Chain 中定义了三种不同类型的节点:

1、客户端节点(Client):通过 JD Chain 的 SDK 进行区块链操作的上层应用;2、网关节点(Gateway):提供网关服务的节点,用于连接客户端和共识节点;3、共识节点(Peer):共识协议参与方,会产生一致性账本。

一个简单的部署模型如下:

本文对于JD Chain测试网络的部署进行了记录,希望能帮到需要的朋友,本文基于jdchain1.6.5。
jdchain从1.6.3版本起,已支持的共识协议包括:BFTSMART,RAFT,MQ。本文对于这三种共识协议的测试网络分别进行说明。更为详细的安装步骤参考 官方安装文档

准备

软件下载

访问 软件下载地址,下载如下安装包

解压文件 jdchain-peer-1.6.5.RELEASE.zip ,进入解压后文件bin目录下,对脚本文件添加可执行权限:

chmod 777 ./*

初始化配置参数说明

要搭建一个区块链网络,首先要对其初始化参数进行设置,初始化参数说明如下图所示,后面的所有部署都要用到初始化配置。初始化参数生成后才能进行初始化,进而才能启动各个节点。

不管使用哪种共识协议,部署的总体流程如下:

采用BFT-SMaRt共识协议

配置生成

BFT-SMaRt共识协议最少需要4个共识节点,我们就以4个共识节点为例。在上面提到的bin目录下执行如下命令,生成初始化配置:

./jdchain-cli.sh testnet config --algorithm ED25519 --ledger-name mytestnet --password 123456 --peer-zip ../../jdchain-peer-1.6.5.RELEASE.zip --gw-zip ../../jdchain-gateway-1.6.5.RELEASE.zip --consensus BFTSMART --peer-size 4 --init-hosts 127.0.0.1 --peer-hosts 127.0.0.1 --peer-consensus-ports 10080,10082,10084,10086 --peer-manage-ports 7080,7081,7082,7083 --init-ports 8809,8819,8829,8839 --gw-port 8086 --output /home/jdchain/nodes/

执行上述指令,输出如下:

成功创建账本初始化配置文件,会在/home/jdchain/nodes/目录下生成4个peer文件夹(peer0、peer1、peer2、peer3),一个网关gw文件夹。后续操作请确保上诉地址端口未被占用。

初始化

这里的初始化,主要是共识节点的初始化。初始化配置生成后,分别进入/home/jdchain/nodes中4个peer*/bin目录下(最好分别开四个客户端),修改shell脚本可执行权限,依次执行初始化脚本:

ledger-init.sh

按照提示操作(等待所有初始化脚本启动之后,有一个按任意键继续的提示,所有节点都需要点击一下确认键),如下图:

节点间在初始化过程中会尝试相互连接,指令执行有先后,所以可忽略初始化过程中的连接错误日志。
要注意,忽略不等于关掉客户端(比如xshell客户端)或者Crtl+C杀掉当前的执行程序,而是保持当前客户端不动,任由其报错,然后新开一个客户端(比如xshell客户端),再进入下一个peer目录进行上面的初始化过程。有多少个peer节点,就重新开启多少个客户端,待所有节点都初始化完成后,每个客户端都会输出如下:

成功执行后会在peer*/config目录下生成ledger-binding.conf文件,表示账本初始化完成。

启动

依次进入peer*/bin目录下,修改shell脚本可执行权限,执行

peer-startup.sh

启动peer节点。
进入gw/bin目录下,修改shell脚本可执行权限,执行

startup.sh

启动网关。

访问 服务器IP地址:8086 查看区块链浏览器。输入用户名:jdchain,密码:jdchain,会看到区块链浏览器首页:

至此,采用BFT-SMaRt共识协议的JD Chain部署运行完成。

采用Raft共识协议

采用Raft共识协议部署JD Chain测试网络,只有在初始化配置生成的时候有所不同,后面两步,即初始化和启动的过程,与上面完全一样。这里只给出配置生成的命令。由于采用Raft共识协议支持单节点,我们以单节点模式为例:

./jdchain-cli.sh testnet config --algorithm ED25519 --ledger-name rafttestnet --password 123456 --peer-zip ../../jdchain-peer-1.6.5.RELEASE.zip --gw-zip ../../jdchain-gateway-1.6.5.RELEASE.zip --consensus RAFT --peer-size 1 --init-hosts 127.0.0.1 --peer-consensus-ports 10080 --peer-manage-ports 7080 --init-ports 8809 --gw-port 8086 --output /home/jdchain/raftnodes/

采用MQ共识协议

采用MQ共识协议,首先要保证MQ服务可用,这里以RabbitMQ为例,单节点的配置生成的命令如下:

./jdchain-cli.sh testnet config --algorithm ED25519 --ledger-name mqtestnet --password 123456 --peer-zip ../../jdchain-peer-1.6.5.RELEASE.zip --gw-zip ../../jdchain-gateway-1.6.5.RELEASE.zip --mq rabbitmq://amqp://127.0.0.1:5672 --consensus MQ --peer-size 1 --init-hosts 127.0.0.1 --peer-consensus-ports 10080 --peer-manage-ports 7080 --init-ports 8809 --gw-port 8086 --output /home/jdchain/mqnodes/

后面的初始化和启动过程跟上面两小节的步骤完全相同,这里就不再赘述。

作者这水平有限,有不足之处欢迎留言指正