Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Tip

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

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

Prerequisites


Expand
titleHardware 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


Note
Configuration varies depending on the work load.



Expand
titleSoftware
  • Docker, curl
  • Go 
  • Python
  • Node.js Runtime and NPM
  • Python
  • curl
  • 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 versionshttps://hyperledger-fabric.readthedocs.io/en/release-1.4/prereqs.html

                                       https://hyperledger-fabric.readthedocs.io/en/release-1.3/prereqs.html

                                       https://hyperledger-fabric.readthedocs.io/en/release-1.2/prereqs.html

     

Docker 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. cat <<EOF >/etc/apt/sources.list.d/kubernetes.list
  5. apt-get udpate
  6. apt-get install docker-ce
  7. 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:
  5. 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

                                 https://hyperledger-fabric.readthedocs.io/en/release-1.1/prereqs.html


Expand
titleRecommended 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 Fabric Network. You can select the network suitable for your environment.

Panel
titleTypes of Hyperledger Fabric Network

Different types of hyperledger fabric network


Expand
titleSOLO Orderer

Solo Orderer Content


Note
Configuration varies depending on the work load.



Expand
titleKafka Fabric Network

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. git clone of Kafka Fabric Network (git clone -b <branchname> https://github.com/<Org>/<Repo>.git)
  2. cd Kafka-Fabric-Network


Note
Configuration varies depending on the work load.



Expand
titleRaft (etcd/raft) Fabric Network

Raft (etcd/raft) Fabric Network


Note
Configuration varies depending on the work load.





...