Skip to content

Latest commit

 

History

History
64 lines (49 loc) · 2.88 KB

README.md

File metadata and controls

64 lines (49 loc) · 2.88 KB
Raw

Chari

Plugable consensus PBFT for hyperledger/fabric

Fabric Tests Date
9bf243e pass Nov 28, 2017

Install

go get -u github.com/amamina/chari

How to use

  1. Add PBFT consenters into orderer, modify fabric/orderer/main.go

    import "github.com/amamina/chari"

    add consenters["pbft"] = chari.New() after

    consenters["solo"] = solo.New()
consenters["kafka"] = kafka.New(conf.Kafka.TLS, conf.Kafka.Retry, conf.Kafka.Version)

  2. Support pbft in configtx.yaml, modify fabric/common/configtx/tool/provisional/provisional.go

    add ConsensusTypePBFT = "pbft" after

    // ConsensusTypeSolo identifies the solo consensus implementation.
ConsensusTypeSolo = "solo"
// ConsensusTypeKafka identifies the Kafka-based consensus implementation.
ConsensusTypeKafka = "kafka"

    add case ConsensusTypePBFT: //do nothing after

    switch conf.Orderer.OrdererType {
case ConsensusTypeSolo:
case ConsensusTypeKafka:
bs.ordererGroups = append(bs.ordererGroups, config.TemplateKafkaBrokers(conf.Orderer.Kafka.Brokers))

  3. Change consensus to PBFT in configtx.yaml

    OrdererType: pbft

  4. Make docker image hyperledger/fabric-orderer Cause we have modify fabric/orderer/main.go, a new image hyperledger/fabric-orderer should be remake. There is a script to in chari/make, cd chari/make and $>make, it will auto to make image hyperledger/fabric-orderer:latest.

  5. Configuration files Chari depends on tendermint, for provide some configuration files to startup tendermint, a tool called charigen in chari/charigen which will auto create configuration files. Notice: charigen should be in the same dir of configtxgen and cryptogen.

  6. Startup Orderer Chari supports PBFT instead of Kafka in orderer, so Kakfa no needs. Now, orderers must meet 3F +1, and additional configurations likes below should be added to orderer shell.

-p 3450:3450 \
-e BFT_P2P_PORT=3450 \
-e BFT_P2P_SEEDS=192.168.110.128:3450,192.168.110.128:3451,192.168.110.128:3452,192.168.110.128:3453 \
-v /etc/hyperledger/crypto-config/chari0:/etc/hyperledger/chari \
-v /etc/hyperledger/channel-artifacts/chari.genesis.json:/etc/hyperledger/chari/genesis.json \

Warning

The current version, when orderer shutdown and restart, the one will be ejected by other orderers, cause the missing blocks during down time will re-execute after orderer restart, this operation will be regarded as do evil by other orderers. To avoid this issue, the down orderer should delete and re-startup but not restart. In the next version will fix this issue.