Tip |
---|
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
Expand |
---|
title | Hardware Configuration |
---|
|
Hyperledger Fabric Minimum configuration - Pilot/POCNo. of instances | 1 |
OS | Ubuntu 16.04 Xenial (64bit) |
Storage | 75 GB (Fabric Network Only) |
Mem (GiB) | 8 GB |
vCPU | 2 |
Hyperledger Fabric Minimum configuration - ProductionNo. of instances | 1 |
OS | Ubuntu 16.04 Xenial (64bit) |
Storage | 100 GB (Fabric Network Only) |
Mem (GiB) | 16 GB |
vCPU | 4 |
Note |
---|
Configuration varies depending on the work load. |
Expand |
---|
|
- 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
apt-get update
apt-get install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
add-apt-repository \
"deb [arch=amd64] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) \
stable"
- apt-get udpate
apt-get install docker.io
apt-get install docker-ce
systemctl status docker
Reference: https://docs.docker.com/install/linux/docker-ce/ubuntu/
GO
- Download the archive: wget https://dl.google.com/go/go1.11.10.linux-amd64.tar.gz
- Extract it into
/usr/local
, creating a Go tree in /usr/local/go
. - tar -C /usr/local -xzf go1.11.10.linux-amd64.tar.gz
- 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/.bashprofile
: 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.
- apt-get install python3.5
- 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 nodejsGit
As Of Ubuntu, git is available by default. Check and then install if required.
- apt-get update
- apt-get install git
Expand |
---|
title | 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.
Panel |
---|
title | Types of Hyperledger Fabric Network |
---|
|
Different types of hyperledger fabric network
Expand |
---|
|
Solo Orderer Content
Note |
Configuration varies depending on the work load.
Tip |
---|
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
Expand |
---|
title | Hardware Configuration |
---|
|
Hyperledger Fabric Minimum configuration - Pilot/POC |
---|
No. of instances | 1 | OS | Ubuntu 16.04 Xenial (64bit) | Storage | 75 GB (Fabric Network Only) | Mem (GiB) | 8 GB | vCPU | 2 |
Hyperledger Fabric Minimum configuration - Production |
---|
No. of instances | 1 | OS | Ubuntu 16.04 Xenial (64bit) | Storage | 100 GB (Fabric Network Only) | Mem (GiB) | 16 GB | vCPU | 4 |
Note |
---|
Configuration varies depending on the work load. |
|
Expand |
---|
|
- 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 curlapt-get update apt-get install apt-transport-https ca-certificates curl software-properties-common curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
add-apt-repository \
"deb [arch=amd64] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) \
stable"
- apt-get udpate
apt-get install docker.io apt-get install docker-ce systemctl status docker
Reference: https://docs.docker.com/install/linux/docker-ce/ubuntu/ GO- Download the archive: wget https://dl.google.com/go/go1.11.10.linux-amd64.tar.gz
- Extract it into
/usr/local , creating a Go tree in /usr/local/go . - tar -C /usr/local -xzf go1.11.10.linux-amd64.tar.gz
- 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/.bashprofile : export PATH=$PATH:/usr/local/go/bin Reference - Section Linux :https://golang.org/doc/install#install
PythonAs of Ubuntu 16.04 LTS (xenial), both python 2 and python3 by default. Recommended to use python3. Check and then install if required. - apt-get install python3.5
- 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
GitAs Of Ubuntu, git is available by default. Check and then install if required. - apt-get update
- apt-get install git
|
Expand |
---|
title | 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.
Panel |
---|
title | Types of Hyperledger Fabric Network |
---|
|
Different types of hyperledger fabric network
Expand |
---|
| 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 - git clone of Kafka Fabric Network (git clone -b <branchname> https://github.com/<Org>/<Repo>.git)
- cd hyperledger-fabric-basic-network
- Configuration: Values like DOMAIN, CHANNEL_NAME, FABRIC_VERSION, TIME_ZONE,etc ... should be modified in .env file based on your requirement.
- 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 Start for the first time: Start/Stop the Network : ./network.sh -m start./network.sh -m stopRecreate the containers without losing the data. ./network.sh -m recreateClean and Remove the Network. ./network.sh -m downVerify if all the docker containers are running docker ps- 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 - 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>:7050Join: peer channel join -o orderer0.<DOMAIN> -b mychannel.block - 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 -l node -v 1.0 Instantiate: peer chaincode instantiate -n insightsAuditing -v 1.0 -c '{"Args":["init"]}' -C mychannel - 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" - 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
|
Expand |
---|
title | Kafka Fabric Network |
---|
| 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 - Set the GOPATH. You can do this by adding this line to your
/etc/profile (for a system-wide installation) or $HOME/.bashprofile : export GOPATH=/opt/gopath - Keep the hyperledger fabric source under GOPATH.
cd $GOPATH/src/github.com/
mkdir hyperledger
cd hyperledger
git clone https://github.com/hyperledger/fabric.git
- git clone of Kafka Fabric Network (git clone -b <branchname> https://github.com/<Org>/<Repo>.git)
- cd Kafka-Fabric-Network
chmod 777 *.sh - Generate the crypto-material :
./generate.sh <channelname> <DOMAIN> Start/Restart the Network : ./start.shVerify if all the docker containers are running docker ps- 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 - 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>:7050Join: peer channel join -o orderer0.<DOMAIN> -b mychannel.block - 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 -l node -v 1.0 Instantiate: peer chaincode instantiate -n insightsAuditing -v 1.0 -c '{"Args":["init"]}' -C mychannel - 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" - 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
|
Expand |
---|
title | Raft (etcd/raft) Fabric Network |
---|
| Raft (etcd/raft) Fabric Network
Note |
---|
Configuration varies depending on the work load. |
|
|
...