CouchDB configuration for Hyperledger Fabric 1.2 on Multiple Hosts using Docker Swarm and Compose

Introduction

This is an update to my previous article Hyperledger Fabric 1.2 on Multiple Hosts using Docker Swarm and Compose, which focused on hosting Hyperledger Fabric 1.2 network on multiple hosts with LevelDB as state database. In this article, I will focus on configuring CouchDB as state database to Fabric 1.2. CouchDB offers richer sets of queries on chain codes and is the preferred database in the production environment.

Topology

I will be extending the topology used in Hyperledger fabric 1.2 to include 4 CouchDB docker containers. Each peer will be configured with one CouchDB container.

1. PC-1

• Orderer (orderer.example.com) -port 7050

2. PC-2

• CA1 (ca.org1.example.com) -port 7054
• Org1 Peer0 (peer0.org1.example.com) -port 7051,8051
• Org1 Peer1 (peer1.org1.example.com) -port 7053,8053
• Org1Couchdb0(couchdb0.org1.example.com) — Port 5984
• Org1Couchdb1(couchdb1.org1.example.com) — port 5986

3. PC-3

• CA2 (ca.org2.example.com) -port 7054
• Org2 Peer0 (peer0.org2.example.com) -port 7051,8051
• Org2 Peer1(peer1.org2.example.com) -port 7053,8053
• Org2Couchdb0(couchdb0.org2.example.com) — Port 5984
• Org2Couchdb1 (couchdb1.org2.example.com)— port 5986

Make sure above specified ports are not blocked with firewall. Open 2377,7946,4789 ports for docker swarm.

CouchDB configuration for Existing Hyperledger Fabric 1.2 network

You have an existing Hyperledger Fabric 1.2 network running on multiple hosts using docker swarm and compose installed using link.

• Go to fabric-samples/fabric-multi-network directory
• Switch to branch release-1.2 of the repository and pull the updated code
• Generate CouchDB yaml

./bymn generate -s couchdb -e 1 crypto-config.yaml

This generates docker-compose-org1-couchdb.yaml and docker-compose-org2-couchdb.yaml

• Launch CouchDB containers and update all peer services

./bymn up -f docker-compose-org1-couchdb.yaml

./bymn up -f docker-compose-org2-couchdb.yaml

This completes the configuration.

CouchDB configuration for new Hyperledger Fabric 1.2 network installation

My article uses levelDB as state database while setting up fabric network. To use CouchDB as state database replace step 4 with.

· ./bymn.sh generate crypto-config.yaml

With

· ./bymn.sh generate crypto-config.yaml -s couchdb

Replace step 9

· ./bymn.sh up -f docker-compose-org1.yaml

With

· ./bymn.sh up -f docker-compose-org1-couchdb.yaml

Replace step 9

· ./bymn.sh up -f docker-compose-org2.yaml

With

· ./bymn.sh up -f docker-compose-org2-couchdb.yaml

Validation

Post successful installation. Try the following urls

http://<pc-2ipadress>:5984/_utils (database of org1 peer0)

http://<pc-2ipadress>:5986/_utils (database of org1 peer1)

http://<pc-3ipadress>:5984/_utils (database of org2 peer0)

http://<pc-2ipadress>:5986/_utils (database of org2 peer1)

user name: couchdb

password: couchdb123

This completes the configuration