We heard about Blockchain technology and understand its value to business. Here we would want to share our learnings with you all, acquired during setting up a single node Hyperledger blockchain dev environment during a client engagement. This entire installation & configuration takes 120-150 minutes. This blog is co-authored with @Krishna Harsha310001AW05 and @PriyaVasudevan270004X6X4.
- If you are new to Blockchain, please visit - https://www.ibm.com/blockchain/what-is-blockchain.html and https://www.hyperledger.org/.
- If you are a developer and looking for a systematic free online self-learning course, please visit - https://developer.ibm.com/courses/all-courses/blockchain-for-developers/
- If you want to use blockchain without installing & managing it, IBM Bluemix platform as a service (PaaS) provides convenient ways to test an IBM Blockchain network on the cloud - https://www.ibm.com/blockchain/bluemix.html.
- IBM Bluemix garages for blockchain help businesses accelerate the design and development of blockchain applications, For more info - https://www.ibm.com/blockchain/garage.html.
Let’s get started. As you can see from below snapshot, I am using Ubuntu 16.04.1 LTS machine with 8 core processor and 32 GB RAM. Using Putty I am accessing it as superuser.
Make sure network is configured properly and internet is accessible. You can check /etc/hosts and /etc/resolv.conf. Try to ping any web address to make sure everything is alright.
As a next step, you should update Run apt update to updates the list of available packages and their versions. Upgrade the packages to make sure they are up to date using apt-get upgrade. If required, update /etc/apt/sources.list using vi.
Since the Hyperledger Fabric project is a ‘
Go’ project, you’ll need to install it first. Make sure its version is 1.6 or higher.
apt install golang-go
Once Go is installed. You can create necessary local folder and clone fabric from gerrit.hyperledger.org using below commands -
mkdir -p /opt/gopath/src/github.com/hyperledger
git clone http://gerrit.hyperledger.org/r/fabric
Now we need to set following environment variables in order to move forward. Alternatively you can write .bash_profile file instead of setting variables every time.
You would also need couple of libraries so run below command -
apt-get install -y cpp gccgo "build-essential" libsnappy-dev zlib1g-dev libbz2-dev docker.io curl
Next we’ll install and build RocksDB 4.1 along with its dependencies as we are not using Vagrant based setup.
git clone https://github.com/facebook/rocksdb.git
git checkout v4.1
PORTABLE=1 make shared_lib
INSTALL_PATH=/usr/local make install-shared
Also build pip, behave and docker-compose using below commands.
apt install python-pip
pip install --upgrade pip
pip install behave nose docker-compose
pip install -I flask==0.10.1 python-dateutil==2.2 pytz==2014.3 pyyaml==3.10 couchdb==1.0 flask-cors==2.0.1 requests==2.4.3
With this we are ready to build the fabric (validating peer). This is probably most problematic step. If you missed any of the above step, it would not work. Use these commands.
At stage-1, you would see your screen like this -
At stage-2, that’s how you screen looks like –
Once its successful, you are ready to setup CA server. The Certificate Authority (CA) provides a number of certificate services to users of a blockchain.
With this installation part is done. Now lets Start node service (validating peer) –
peer node start
Run Certificate Authority (CA) server by starting member services –
Once both servers are started, You can access this blockchain setup for development or testing. You may need to understand which service is running on which port. Run below command to do that –
7050 – REST service listeining port
7051 – Peer service listening port
7052 – Used by CLI for callbacks
7053 – Event service on validating node
7054 - Certificate Authority (CA) listening port (Member services)
Once services are up and running. You can use REST API calls from any machine on network.
In the next blog, we’ll configure security, privacy and logging levels for this setup (http://ibm.biz/securebc). We’ll also see how to write, deploy, invoke and query chaincode (http://ibm.biz/chaincode). Thanks.