Page Comparison

Make sure you've done all the Prerequisites 

Network Architecture

• 1 Orderer
• 1 Organization
• 3 peers
• 3 couchdb for each peer
• 1 ca
• 1 cli (Optional)

Clone from GitHub

1. git clone of Solo Orderer Network:    git clone -b SoloOrdererNetwork https://github.com/TheCognizantFoundry/Insights.git
2. cd hyperledger-fabric-basic-network
3. Configuration: Values like DOMAIN, CHANNEL_NAME, FABRIC_VERSION, TIME_ZONE,etc ... can be modified in .env file based on your requirement.
4. Start network for the first time. 

   network.sh - Generate the crypto-material, start/stop/restart the network.

   ./network.sh -m download

   ./network.sh -m up

5. Start for the first time:

6. Start/Stop the Network :

    ./network.sh -m start./network.sh -m stop

7. Recreate the containers without losing the data.

    ./network.sh -m recreate

8. Clean and Remove the Network.

    ./network.sh -m down

9. Verify if all the docker containers are running

   docker ps
10. Create and Join channel in Anchor peer - peer0.org1:  

      Get into peer0.org1 container: docker exec -it peer0.org1.<DOMAIN> bash

      Create: peer channel create -o orderer0.<DOMAIN>:7050 -c mychannel -f /var/hyperledger/configs/channel.tx

    
    

      Join: peer channel join -o orderer0.<DOMAIN> -b mychannel.block
11. Fetch the block and join channel in other peers: 

    Get into peer0.org1 container: docker exec -it peer0.org1.<DOMAIN> bash

    
    

    Fetch block: peer channel fetch 0 mychannel.block --channelID mychannel --orderer orderer0.<DOMAIN>:7050

    Join channel: peer channel join -o orderer0.<DOMAIN> -b mychannel.block

12. Install,Instantiate the chaincode in Anchor peer - peer0. Get into respective peer containers and use the below install command to install chaincode in other peers.

      Get into peer0.org1 container: docker exec -it peer0.org1.<DOMAIN> bash

      Install: peer chaincode install -n insightsAuditing -p /chaincode/src/node/js -l node -v 1.0

      Instantiate: peer chaincode instantiate -n insightsAuditing -v 1.0 -c '{"Args":["init"]}' -C mychannel

13. Get into ca container. Create user to connect from fabric sdk by using admin. Fabric sdk network connection requires the user's cert details to get connected to the fabric network.

    docker exec -it ca.org1.<DOMAIN> bash

    fabric-ca-client enroll -u http://Admin:<password>@localhost:7054

    fabric-ca-client register -u "http://localhost:7054" --id.name "newusername" --id.secret "password" --id.type "client" --id.affiliation "org1.department1"

    fabric-ca-client enroll -u "http://newusername:password@localhost:7054"

14. Test the Chaincode. Either insert record manually or let the data gets inserted via PlatformAuditEngine. Then, query as shown below. Modify ASSET-ID with your Asset ID value.
    

      Query: peer chaincode query -n insightsAuditing -c '{"Args":["GetAssetDetails","ASSET-ID"]}' -C mychannel

Make sure you've done all the Prerequisites 

Network Architecture

• 3 Orderers
• 2 Organizations
• 4 peers, 2 for each organization
• 4 couchdb for each peer
• 2 ca, 1 for each organization
• 4 Kafka broker instances
• 3 Zookeper instances
• 1 cli (Optional)

Clone from GitHub

1. Set the GOPATH. You can do this by adding this line to your /etc/environment (for a system-wide installation) or $HOME/.bashprofile : export GOPATH=/opt/gopath Source if you set this in the same linux sesison then, source /etc/environment (OR)  source $HOME/.bashprofile
2. Keep the hyperledger fabric source under GOPATH. 

   cd $GOPATH/src/github.com/
   mkdir hyperledger
   cd hyperledger
   git clone https://github.com/hyperledger/fabric.git
   
   

3. git clone of Kafka Fabric Network:   git clone -b KafkaFabricNetwork https://github.com/TheCognizantFoundry/Insights.git
4. cd Hyperledger_fabric_kafka

5. Configuration: Values like DOMAIN, CORE_PEER configs,etc ... can be modified in .env file based on your requirement.

   Code Block
   language bash theme Emacs title .env
   COMPOSE_PROJECT_NAME=<name_of_your_network> CONFIGTX_ORDERER_BATCHSIZE_MAXMESSAGECOUNT=10 CONFIGTX_ORDERER_BATCHTIMEOUT=2s KAFKA_DEFAULT_REPLICATION_FACTOR=3 CORE_LOGGING_GOSSIP=WARNING ORDERER_GENERAL_TLS_ENABLED=false ORDERER_GENERAL_TLS_PRIVATEKEY=/var/hyperledger/tls/server.key ORDERER_GENERAL_TLS_CERTIFICATE=/var/hyperledger/tls/server.crt ORDERER_TLS_CLIENTAUTHREQUIRED=false CORE_PEER_TLS_ENABLED=false CORE_PEER_TLS_CERT_FILE=/var/hyperledger/tls/server.crt CORE_PEER_TLS_KEY_FILE=/var/hyperledger/tls/server.key CORE_PEER_TLS_CLIENTAUTHREQUIRED=false CORE_PEER_GOSSIP_ORGLEADER_PEER0_ORG1=false CORE_PEER_GOSSIP_USELEADERELECTION_PEER0_ORG1=true CORE_PEER_GOSSIP_ORGLEADER_PEER0_ORG2=false CORE_PEER_GOSSIP_USELEADERELECTION_PEER0_ORG2=true CORE_PEER_GOSSIP_ORGLEADER_PEER0_ORG3=false CORE_PEER_GOSSIP_USELEADERELECTION_PEER0_ORG3=true CORE_PEER_GOSSIP_ORGLEADER_PEER1_ORG1=false CORE_PEER_GOSSIP_USELEADERELECTION_PEER1_ORG1=true CORE_PEER_GOSSIP_ORGLEADER_PEER1_ORG2=false CORE_PEER_GOSSIP_USELEADERELECTION_PEER1_ORG2=true CORE_PEER_GOSSIP_ORGLEADER_PEER1_ORG3=false CORE_PEER_GOSSIP_USELEADERELECTION_PEER1_ORG3=true ORDERER_ABSOLUTEMAXBYTES=10 MB ORDERER_PREFERREDMAXBYTES=512 KB KAFKA_MESSAGE_MAX_BYTES=1000012 B KAFKA_REPLICA_FETCH_MAX_BYTES=1048576 B KAFKA_REPLICA_FETCH_RESPONSE_MAX_BYTES=10485760 B CORE_PEER_NETWORKID=net DOMAIN=<your_company_domain> FABRIC_CA_SERVER_TLS_ENABLED=false

   
   

6. chmod 777 *.sh
7. Generate the crypto-material. Input arguments to generate.sh are channelname and domain name : 

   ./generate.sh <channelname> <DOMAIN>

   For Example: ./generate.sh mychannel cogdevops.com

8. Start/Restart the Network :

   ./start.sh

9. Verify if all the docker containers are running

   docker ps
10. Create and Join channel in Anchor peer - peer0.org1:  

      Get into peer0.org1 container: docker exec -it peer0.org1.<DOMAIN> bash

      Create: peer channel create -o orderer0.<DOMAIN>:7050 -c mychannel -f /var/hyperledger/configs/channel.tx

    
    

      Join channel: peer channel join -o orderer0.<DOMAIN> -b mychannel.block
11. Fetch the block and join channel in other peers: 

    Get into peer0.org1 container: docker exec -it peer0.org1.<DOMAIN> bash

    
    

    Fetch block: peer channel fetch 0 mychannel.block --channelID mychannel --orderer orderer0.<DOMAIN>:7050

    Join: peer channel join -o orderer0.<DOMAIN> -b mychannel.block

12. Install,Instantiate the chaincode in Anchor peer - peer0. Get into respective peer containers and use the below install command to install chaincode in other peers.

      Get into peer0.org1 container: docker exec -it peer0.org1.<DOMAIN> bash

      Install: peer chaincode install -n insightsAuditing -p /chaincode/src/nodejs -l node -v 1.0

      Instantiate: peer chaincode instantiate -n insightsAuditing -v 1.0 -c '{"Args":["init"]}' -C mychannel

13. Get into ca container. Create user to connect from fabric sdk by using admin. Fabric sdk network connection requires the user's cert details to get connected to the fabric network.

    docker exec -it ca.org1.<DOMAIN> bash

    fabric-ca-client enroll -u http://Admin:<password>@localhost:7054

    fabric-ca-client register -u "http://localhost:7054" --id.name "newusername" --id.secret "password" --id.type "client" --id.affiliation "org1.department1"

    fabric-ca-client enroll -u "http://newusername:password@localhost:7054"

14. Test the Chaincode. Either insert record manually or let the data gets inserted via PlatformAuditEngine. Then, query as shown below. Modify ASSET-ID with your Asset ID value.
    

      Query: peer chaincode query -n insightsAuditing -c '{"Args":["GetAssetDetails","ASSET-ID"]}' -C mychannel

Make sure you've done all the Prerequisites 

Network Architecture

• 5 Orderers
• 2 Organizations
• 4 peers, 2 for each organization
• 4 couchdb, one for each peer
• 2 certificate authority(CA), one for each organization
• 1 cli (Optional)

Setup the Network

1. Set the GOPATH. You can do this by adding this line to your /etc/environment (for a system-wide installation) or $HOME/.bashprofile : export GOPATH=/opt/gopath Source if you set this in the same linux sesison then, source /etc/environment (OR)  source $HOME/.bashprofile

2. Keep the hyperledger fabric source under GOPATH with the steps mentioned below:

   No Format
   cd $GOPATH/src/github.com/mkdir hyperledger cd hyperledger git clone https://github.com/hyperledger/fabric.git

   
   

3. Clone the Hyperledger_Raft branch from our repo: git clone -b Hyperledger_Raft https://github.com/TheCognizantFoundry/Insights2.0.git
4. Navigate into the raft-with-ca folder: cd Insights2.0/raft-with-ca

5. Give permissions to all the executables and shell files which will easily bring up/down the network:
   chmod 777 *.sh
   chmod -R 755 bin

6. Generate the crypto-material. Input arguments to generate.sh are channelname and domain name : 

   ./generate.sh <channelname> <DOMAIN>

   For Example: ./generate.sh mychannel cogdevops.com

7. Edit the values(DOMAIN, CA_ORG*_KEYFILE etc.) inside the .env file. Refer the list below to know more about the variables of .env:

   Code Block
   language bash theme Emacs title .env
   COMPOSE_PROJECT_NAME=<name_of_your_network> IMAGE_TAG=<docker_image_tag_to_be_used_for_spawning_containers> DOMAIN=<yourCompany_domain_name> ORDERER_GENERAL_TLS_ENABLED=true CORE_PEER_TLS_ENABLED=true FABRIC_CA_SERVER_TLS_ENABLED=true ORDERER_TLS_CLIENTAUTHREQUIRED=true CA_ORG1_KEYFILE=<name of the keyfile residing inside crypto-config/peerOrganizations/org1.cogdevops.com/ca/> CA_ORG2_KEYFILE=<name of the keyfile residing inside crypto-config/peerOrganizations/org2.cogdevops.com/ca/>

   
   

   Warning
   The tls variables must be set to true as Hyperledger-fabric Raft mandates enabling TLS for better security in network communication. Failing to do so will result in crashing of the orderers. Some of the fields are pre-populated with default values. you may change the values as per requirement. The IMAGE_TAG must be > 1.4.1 or latest to have raft setup.

   
   

8. Start the Network :

   ./start.sh <channelname> <DOMAIN>

   Note
   You must use the same  channelname and DOMAIN which you used in step 6.

   If you want to learn more about how the network is setup, then do not execute the start.sh. In stead, run the below commands manually from your terminal:

   Code Block
   language applescript title Learn more about the steps performed inside start.sh linenumbers true collapse true
   #Replace $CHANNEL_NAME and $DOMAIN with your channelname and domain respectively. #setup the network docker-compose -f docker-compose-cli.yaml -f docker-compose-couch.yaml -f docker-compose-etcdraft2.yaml up -d sleep 15 #create the channel docker exec -it peer0.org1.$DOMAIN peer channel create -o orderer.$DOMAIN:7050 -c $CHANNEL_NAME -f ./channel-artifacts/channel.tx --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/$DOMAIN/orderers/orderer.$DOMAIN/msp/tlscacerts/tlsca.$DOMAIN-cert.pem #join org1 anchor peer peer0.org1 docker exec -it peer0.org1.$DOMAIN peer channel join -b $CHANNEL_NAME.block #join org2 anchor peer0.org2 docker exec -it peer0.org2.$DOMAIN peer channel fetch 0 $CHANNEL_NAME.block -c $CHANNEL_NAME -o orderer.$DOMAIN:7050 --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/$DOMAIN/orderers/orderer.$DOMAIN/msp/tlscacerts/tlsca.$DOMAIN-cert.pem docker exec -it peer0.org2.$DOMAIN peer channel join -b $CHANNEL_NAME.block #join org1 & org2 docker exec -it peer0.org1.$DOMAIN peer channel update -o orderer.$DOMAIN:7050 -c $CHANNEL_NAME -f ./channel-artifacts/Org1MSPanchors.tx --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/$DOMAIN/orderers/orderer.$DOMAIN/msp/tlscacerts/tlsca.$DOMAIN-cert.pem docker exec -it peer0.org2.$DOMAIN peer channel update -o orderer.$DOMAIN:7050 -c $CHANNEL_NAME -f ./channel-artifacts/Org2MSPanchors.tx --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/$DOMAIN/orderers/orderer.$DOMAIN/msp/tlscacerts/tlsca.$DOMAIN-cert.pem #join the other peers to the channel docker exec -it peer1.org1.$DOMAIN peer channel fetch 0 $CHANNEL_NAME.block -c $CHANNEL_NAME -o orderer.$DOMAIN:7050 --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/$DOMAIN/orderers/orderer.$DOMAIN/msp/tlscacerts/tlsca.$DOMAIN-cert.pem docker exec -it peer1.org1.$DOMAIN peer channel join -b $CHANNEL_NAME.block docker exec -it peer1.org2.$DOMAIN peer channel fetch 0 $CHANNEL_NAME.block -c $CHANNEL_NAME -o orderer.$DOMAIN:7050 --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/$DOMAIN/orderers/orderer.$DOMAIN/msp/tlscacerts/tlsca.$DOMAIN-cert.pem docker exec -it peer1.org2.$DOMAIN peer channel join -b $CHANNEL_NAME.block #install the chaincode into the anchor peers docker exec -it peer0.org1.$DOMAIN peer chaincode install -n insightsAudit -v 1.0 -l node -p /chaincode/src/node/ docker exec -it peer0.org2.$DOMAIN peer chaincode install -n insightsAudit -v 1.0 -l node -p /chaincode/src/node/ #install into the other peers docker exec -it peer1.org1.$DOMAIN peer chaincode install -n insightsAudit -v 1.0 -l node -p /chaincode/src/node/ docker exec -it peer1.org2.$DOMAIN peer chaincode install -n insightsAudit -v 1.0 -l node -p /chaincode/src/node/ #instantiate the chaincode inside one of the anchor (here we are doing for peer0.org1) docker exec -it peer0.org1.$DOMAIN peer chaincode instantiate -o orderer.$DOMAIN:7050 --tls --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/$DOMAIN/orderers/orderer.$DOMAIN/msp/tlscacerts/tlsca.$DOMAIN-cert.pem -C $CHANNEL_NAME -n insightsAudit -l node -v 1.0 -c '{"Args":["Init"]}'

   
   

9. Verify if all the docker containers are running:

   docker ps -a

   Info

   You will notice some extra containers running other than the ones mentioned in the network architecture with names like this: dev-peer0.org1.cogdevops.com-insightsAudit-1.0. It is an expected behaviour for the fabric-network. These containers will get spawned whenever chaincode is instantiated in a peer. Since the start.sh script will instantiated the chaincode inside peer0 by default, therefore this container will get spawned.

   At this point your raft setup is complete. Steps mentioned hereafter are for registration and enrollment of a user to be used with SDK.

10. Login into the CA container: docker exec -it ca.org1.<DOMAIN> bash
11. Run the following inside the container:

• Enroll the admin: fabric-ca-client enroll -u https://Admin:adminpw@localhost:7054 --tls.certfiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.<DOMAIN>/ca/ca.org1.<DOMAIN>-cert.pem
• Now register a new user: fabric-ca-client register -u https://localhost:7054 --id.name "newusername" --id.secret "password" --id.type "client" --id.affiliation "org1.department1" --tls.certfiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.<DOMAIN>/ca/ca.org1.<DOMAIN>-cert.pem
• Verify the registration by listing the available users: fabric-ca-client identity list -u https://localhost:7054 --tls.certfiles /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/peerOrganizations/org1.<DOMAIN>/ca/ca.org1.<DOMAIN>-cert.pem

You should see the new user inside this list if registration is successful.

     12. Test the Chaincode. Either insert record manually or let the data gets inserted via PlatformAuditEngine. Then

run the below query inside any of the peers. Modify assetID with your Asset ID

value                     and channelname should be the same one used in step 8.

           Query: peer chaincode query -n insightsAuditing -c '{"Args":["GetAssetDetails","

<assetID>"]}' -C

Raft (etcd/raft) Fabric Network