Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 17 Next »

Step - by - step guide on how to Install Insights Enterprise - Hyperledger Fabric Network.

Installing Hyperledger Network covers the initial setup procedures including Installation, Configurations (Hardware, Software, and Network) and various Commands. 

Prerequisites


 Hardware Configuration

Hyperledger Fabric Minimum configuration - Pilot/POC
No. of instances1
OSUbuntu 16.04 Xenial (64bit) 
Storage75 GB (Fabric Network Only)
Mem (GiB)8 GB
vCPU2

Hyperledger Fabric Minimum configuration - Production
No. of instances1
OSUbuntu 16.04 Xenial (64bit) 
Storage100 GB (Fabric Network Only)
Mem (GiB)16 GB
vCPU4
Configuration varies depending on the work load.
 Software
  • Docker 17.06.2-ce or greater, Docker Compose  1.14.0 or greater , curl
  • Go 1.11.x
  • Python 3.x
  • Node.js Runtime 8.x and NPM 5.x
  • git (git bash to clone the repo)

Refer the link to know the Software component version for latest fabric network: https://hyperledger-fabric.readthedocs.io/en/latest/prereqs.html

Fabric Version Specific. Change the version in the URL for other versions: https://hyperledger-fabric.readthedocs.io/en/release-1.4/prereqs.html

Docker, Docker Compose and curl

  1. apt-get update
  2. apt-get install apt-transport-https ca-certificates curl software-properties-common
  3. curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
  4. add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
   $(lsb_release -cs) \
   stable"
  5. apt-get udpate
  6. apt-get install docker.io
  7. apt-get install docker-ce
  8. systemctl status docker

Reference: https://docs.docker.com/install/linux/docker-ce/ubuntu/

GO

  1. Download the archive: wget https://dl.google.com/go/go1.11.10.linux-amd64.tar.gz
  2. Extract it into /usr/local, creating a Go tree in /usr/local/go. 
  3. tar -C /usr/local -xzf go1.11.10.linux-amd64.tar.gz
  4. Add /usr/local/go/bin to the PATH environment variable. You can do this by adding this line to your /etc/profile (for a system-wide installation) or $HOME/.profile:                  export PATH=$PATH:/usr/local/go/bin
    Reference - Section Linux :https://golang.org/doc/install#install

Python

As of Ubuntu 16.04 LTS (xenial),  both python 2 and python3 by default. Recommended to use python3. Check and then install if required.

  1. apt-get install python3.5
  2. apt-get install python3-pip

set alias to respectiive python version in ~/.bashrc to avoid error while installing the module.

alias pip=pip3

alias python=python3.5

Reference: https://wiki.ubuntu.com/Python

Node.js Runtime and NPM
The recommended versions for node and npm are Node 8.x.x and npm5.x.x. If you are getting lower versions using apt-get install, remove existing node setup from your machine and then run the following:

curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
apt-get install nodejs

Git

As Of Ubuntu, git is available by default. Check and then install if required.

  1. apt-get update
  2. apt-get install git
 Recommended Network Ports

Following port must be opened to access the fabric network from fabric sdk.

Source : fabric sdk instance

Destination: fabric network installed instance

Example Ports: You can change these ports based on availability and configuration in fabric network. Then, enable connectivity to those ports.

  • Orderer - 7050 
  • Peer0.Org1 - 7051
  • EventHub : 7053
  • ca.org1 : 7054

Please browse through the below sections to setup specific Fabric Network. 

Types of Hyperledger Fabric Network

Different types of hyperledger fabric network

 SOLO Orderer

Solo Orderer Content

Configuration varies depending on the work load.
 Kafka Fabric Network

Make sure you've done all the Prerequisites 

Network Architecture

  • 3 Orderers
  • 2 Organizations
  • 4 peers, 2 for each organization
  • 2 ca, 1 for each organization
  • 4 Kafka broker instances
  • 3 Zookeper instances

Clone from GitHub

  1. Set the GOPATH. You can do this by adding this line to your /etc/profile (for a system-wide installation) or $HOME/.profile : export GOPATH=/opt/gopath
  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 <branchname> https://github.com/<Org>/<Repo>.git)
  4. cd Kafka-Fabric-Network
  5. chmod 777 *.sh
  6. Generate the crypto-material : 

    ./generate.sh <channelname> <DOMAIN>

  7. Start/Restart the Network :

    ./start.sh

  8. Verify if all the docker containers are running

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

      Create: peer channel create -o orderer0.cogdevops.com:7050 -c mychannel -f /var/hyperledger/configs/channel.tx

      Join: peer channel join -o orderer0.cogdevops.com -b mychannel.block

  10. Fetch the block and join channel in other peers: 


    Fetch block: peer channel fetch 0 mychannel.block --channelID mychannel --orderer orderer0.cogdevops.com:7050

    Join: peer channel join -o orderer0.cogdevops.com -b mychannel.block

  11. Install,Instantiate the chaincode in Anchor peer - peer0. Use the below install command to install in other peers.

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

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

  12. 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"

  13. 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

 Raft (etcd/raft) Fabric Network

Raft (etcd/raft) Fabric Network

Configuration varies depending on the work load.


  • No labels

©2021 Cognizant, all rights reserved. US Patent 10,410,152