{"id":2439,"date":"2017-12-01T01:48:49","date_gmt":"2017-12-01T01:48:49","guid":{"rendered":"http:\/\/websecuritypatterns.com\/blogs\/?p=2439"},"modified":"2018-01-08T02:00:31","modified_gmt":"2018-01-08T02:00:31","slug":"exploring-hyperledger-fabric-v1-building-first-network-byfn","status":"publish","type":"post","link":"https:\/\/websecuritypatterns.com\/blogs\/2017\/12\/01\/exploring-hyperledger-fabric-v1-building-first-network-byfn\/","title":{"rendered":"Exploring Hyperledger Fabric v1 – Building your first network (BYFN)"},"content":{"rendered":"

It was quite easy ! Building a private blockchain using Hyperledger Fabric<\/strong><\/em> looked relatively simple when I tried building a couple of demos (similar to my Private Ethereum<\/strong> <\/em>experience)! Lately, I don’t have the luxury of my big old machines at Oracle so I used my own free-tier account on AWS (Thank you AWS<\/strong><\/em>). I was able to quickly put up an Ubuntu instance with 2Gb RAM and 8Gb of storage. For doing the BYFN (Building your first network) demo (from Hyperledger Fabric Samples<\/a>), I thought it should be good enough to run few docker VMs running Fabric peers representing two organizations using a Solo orderer (not using Kafka).<\/p>\n

Putting altogether (Here is my recipe):<\/p>\n

    \n
  1. Ubuntu instance details:<\/li>\n<\/ol>\n

    \"\"<\/p>\n

    2. \u00a0Before you begin installing Hyperledger, make sure your Ubuntu instance is installed with ‘curl’, \u00a0‘docker.io’ and ‘docker-compose’<\/strong> <\/em>binaries. \u00a0To download and install the latest Hyperledger Docker VMs binaries refer to the following URL:<\/p>\n

    https:\/\/hyperledger-fabric.readthedocs.io\/en\/latest\/samples.html#binaries<\/strong><\/pre>\n
    I used the following URL:<\/p>\n
    $ curl -sSL https:\/\/goo.gl\/Q3YRTi<\/a>\u00a0| bash<\/strong><\/pre>\n
    3. To verify install, try running ‘docker images’ :<\/p>\n
    \"\"<\/p>\n
    Also, make sure your current directory and the ~\/bin directory is added to $PATH environment variable. \u00a0For example, you would add. #export PATH=\/home\/ubuntu\/hyperledger\/bin:$PATH<\/em><\/p>\n
    4.\u00a0Now download the Hyperledger Fabric samples from Github<\/em><\/strong>, by running the following commands:<\/p>\n
    $ git clone -b master https:\/\/github.com\/hyperledger\/fabric-samples.git <\/strong>\r\n$ cd fabric-samples<\/strong><\/pre>\n
    5.\u00a0Now, move to the sub-directory “first-network<\/em><\/strong>” and run the following command:<\/p>\n
    $ cd fabric-samples\/first-network<\/strong>\r\n$ .\/byfn -m generate<\/strong><\/pre>\n
    You should be seeing the following output, which will generate the Certificates for the peers, creates the Orderer genesis block, creates a single channel (mychannel) and the anchor peers representing two organization (Org1 and Org 2).<\/p>\n
    \"\"<\/p>\n
      \n
    1. Now, bring up your “first-network<\/em><\/strong>” and run the following commands:<\/li>\n<\/ol>\n
      $ .\/byfn.sh -m up<\/strong><\/pre>\n
      You should see the following output (I truncated them into multiple screenshots for ease of understanding of what is going on under the hood).<\/p>\n
      a) Creating the Orgs, Solo Orderer, Peers and the channel (mychannel)<\/p>\n
      \"\"<\/p>\n
      b) Adding Peers to the Channel<\/p>\n
      \"\"<\/p>\n
      c) Identifying the Anchor peers for each org<\/p>\n
      \"\"<\/p>\n
      d) Installation and Instantiation of Chaincode on the peers<\/p>\n
      \"\"<\/p>\n
      e) Querying chaincode and Invoking transactions.<\/p>\n
      \"\"<\/p>\n
      \"\"<\/p>\n
      7. \u00a0To shutdown your “first-network<\/em><\/strong>” and to delete all\u00a0the artifacts, including stopping the\u00a0docker VMs, <\/span>\u00a0deleting the chaincode images from the docker Registry removing the crypto material (certs) of the peers. By\u00a0<\/span>running the following command:<\/p>\n
      $ .\/byfn.sh -m down<\/strong><\/pre>\n
      \"\"<\/p>\n
      To summarize, we executed the “First Network” script, beginning with generating the certificate artifacts for the organization, created the default channel that connects the orderer with the peers, \u00a0created orderer genesis block and then brought up the private blockchain network using the Solo orderer that makes use of two organizations joining peers from both organization to a channel, deploying, and instantiating the chaincode, and execute query and invoke transactions against the chaincode.<\/p>\n
      This exercise only helps to understand the Hyperledge Fabric components and the simple steps to show how we can quickly spin up and bring down a Hyperledger Fabric network using sample chaincode (chaincode_example02)<\/strong>. \u00a0You should able to modify the scripts and tweak to run other samples (like fabcar under fabric-samples directory).<\/p>\n","protected":false},"excerpt":{"rendered":"
      It was quite easy ! Building a private blockchain using Hyperledger Fabric looked relatively simple when I tried building a couple of demos (similar to my Private Ethereum experience)! Lately, I don’t have the luxury of my big old machines at Oracle so I used my own free-tier account on AWS (Thank you AWS). I was able to quickly put… Read more »<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[3,82,89,1],"tags":[25,83,102,101],"class_list":["post-2439","post","type-post","status-publish","format-standard","hentry","category-blockchain","category-hyperledger","category-permissioned-blockchain","category-uncategorized","tag-blockchain","tag-hyperledger","tag-hyperledger-fabric","tag-private-blockchain"],"jetpack_sharing_enabled":true,"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/websecuritypatterns.com\/blogs\/wp-json\/wp\/v2\/posts\/2439","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/websecuritypatterns.com\/blogs\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/websecuritypatterns.com\/blogs\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/websecuritypatterns.com\/blogs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/websecuritypatterns.com\/blogs\/wp-json\/wp\/v2\/comments?post=2439"}],"version-history":[{"count":26,"href":"https:\/\/websecuritypatterns.com\/blogs\/wp-json\/wp\/v2\/posts\/2439\/revisions"}],"predecessor-version":[{"id":2600,"href":"https:\/\/websecuritypatterns.com\/blogs\/wp-json\/wp\/v2\/posts\/2439\/revisions\/2600"}],"wp:attachment":[{"href":"https:\/\/websecuritypatterns.com\/blogs\/wp-json\/wp\/v2\/media?parent=2439"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/websecuritypatterns.com\/blogs\/wp-json\/wp\/v2\/categories?post=2439"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/websecuritypatterns.com\/blogs\/wp-json\/wp\/v2\/tags?post=2439"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}