fabric-v2.2

Running a sample network

Launch a simple network with a single orderer and two peers from different organizations.

Download

Download binaries and pull docker images for Fabric v2.2 based on this link. Make sure the downloaded binaries are accessible from $PATH.

Set Global Variable

CHANNEL_NAME=mychannel

Launch and setup

./network.sh up createChannel -ca -i 2.2 -c ${CHANNEL_NAME}

Deploy Chaincode

The exact $CC_NAME is determined by individual benchmarks.

CC_SRC_PATH="../contracts/fabric-v2.2/${CC_NAME}"
./network.sh deployCC -ccn ${CC_NAME} -ccp ${CC_SRC_PATH}

Start up the helper processes.

This part is necessary as Fabric 2.2 does not provide C++ SDK. To work around, we wrap up the Fabric's service into a json web service, implemented by NodeJS. In macro benchmarks, client drivers will contact these helpers processes to interact with Fabric network.

Note down their listening addresses and ports.

Install Dependencies and Prepare Identities

cd services/;
npm install;
node enrollAdmin.js
node registerUser.js

Launch processes

Launch one block service on port 8800 in the background, which provides the ledger information.

Since block-server is only contacted by the Status_Thread of client drivers, a single one block service is enough.

# Still in services/
node block-server.js ${CHANNEL_NAME} 8800 > block-server.log 2>&1 &

Launch two transaction services on port 8801 and 8802 respectively in the background, each listening for json requests and routes them to Fabric network. $MODE is determined by individual benchmarks. In most cases, macro benchmarks opt for MODE=open_loop and micro benchmarks opt for MODE=closed_loop.

# Still in services/
node txn-server.js ${CHANNEL_NAME} ${CC_NAME} ${MODE} 8801 > txn-server-8801.log 2>&1 &
node txn-server.js ${CHANNEL_NAME} ${CC_NAME} ${MODE} 8802 > txn-server-8802.log 2>&1 &

As txn-servers are contacted by the Client_Thread of client drivers, and there are multiple client threads, it is desirable to launch multiple txn-servers to balance the workload.

Below shows some example commands of web services.

curl http://localhost:8800/block?num=2
curl http://localhost:8800/height

curl --header "Content-Type: application/json" \
--request POST \
--data '{"function":"Write","args":["KK", "VV"]}' \
http://localhost:8801/invoke


curl "http://localhost:8801/query?function=Read&args=KK"

Clean up

Shut the network

./network.sh down

Shut the helper processes

ps aux  |  grep -i block-server  |  awk '{print $2}' | xargs kill -9
ps aux  |  grep -i txn-server  |  awk '{print $2}' | xargs kill -9

Clean the identity

## Under services/
rm wallet/*