Amazon Managed Blockchain Basic Introduction Workshop

Overview

Hyperledger Explorer is a blockchain module and one of the Hyperledger projects hosted by The Linux Foundation. Designed to create a user-friendly Web application, Hyperledger Explorer can view, invoke, deploy or query blocks, transactions and associated data, network information (name, status, list of nodes), chain codes and transaction families, as well as any other relevant information stored in the ledger.

Prerequisites

AWS Account

Step By Step

Clone This Lab

Download this Project as .zip and extract it as you will need the files in template folder

Creating your Infrastructure (CloudFormation)

On the Services menu, select CloudFormation.
On the left navigation panel, select Stacks, then select Create Stack.
Select Template is ready and Upload a template file
Choose the fabric-node-template.yaml code, attached to this project for the template source and click Next
On the next window, enter name of your cloudformation stack as Name : <your network>-Explorer-HLF-Workshop and insert your Managed Blockchain VPC Endpoint, and specify your KeyName : MB-Workshop Key file attached to this project file for the instance and click Next
On the next window leave everything as they are , scroll down and click Next,
Do the same on the next window and scroll down to click Create Stack
After that wait for 3-5 minutes for the instances to be launched, and after the stack has been completed, click your stack and pick the Outputs tab, to get the url of your instance.

Create Your Basic Network

SSH into the EC2 instance created from our Cloudformation stack earlier (Make sure you are logged-in as ec2-user)
```
$ ssh -i "MB-WorkshopKey.pem" ec2-user@ec2-xx-xx-xx-xxx.compute-1.amazonaws.com
```
** or enter your key if you specify other key on step 5*
This instance already contain Hyperledger Fabric Images and the network configuration samples that you will use, so After you logged-in to the instance, enter:
```
$ cd fabric-samples/first-network
```
```
$ ./byfn.sh generate
```
```
$ ./byfn.sh up
```
to build the your first network (roughly 3-4 minutes)

On certain cases, the network could fail, in that case just retype the ./byfn.sh up command and it would rebuild the network.
After it is done it will show a big END sign, meaning you have successfully built your first network

###OPTIONAL :

As our Hyperledger Fabric Network is built with Docker compose, you can see all the infrastructures by entering :
```
docker ps
```

Launch an explorer to explore your network

To configure Hyperledger Explorer you can clone the project through git by entering the command :
```
git clone https://github.com/hyperledger/blockchain-explorer.git
```
For ease of configurations , we will tell our fabric network configuration through first-network.json, we would modify this file to suits the configuration of our network.

First enter the command :
```
ls ~/fabric-samples/first-network/crypto-config/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp/keystore/
```
to see name of your keyfile which we would need.

Copy your key name and paste it into your own first-network.json, line 40

Replace the {REPLACE THIS WITH YOUR KEYFILE NAME} with your own keyfile name :

This file will be used on step 5
Copy the certificates and keys of your network by entering the command :
```
cp ~/fabric-samples/first-network/crypto-config ~/blockchain-explorer/examples/net1/ -r
```
and then check if your files is already copied :
```
cd ~/blockchain-explorer/examples/net1/
```
```
ls
```
Rename the files you just copied by entering command :
```
rm crypto -r
mv crypto-config crypto
```
After that , we are going to specify the keychains that would identify and authenticate our Fabric Network :
```
cd ~/blockchain-explorer/examples/net1/connection-profile
```
We are going to replace the file inside this directory called first-network.json with the one with created to specify the correct address.
```
rm first-network.json
vim first-network.json
```
After entering your vim window, type in the command
```
:set nopaste
```
And then type i to enter insert mode, copy and paste your first-network.json by entering (cmd + c, cmd + v) on mac or just right click on windows, and then type esc and enter command :wq to save and quit vim window.
Now we are ready to launch our Explorer go to the correct directory:
```
cd ~/blockchain-explorer/
```
And launch docker-compose to launch our explorer :
```
docker-compose up -d
```
It will take a few minutes to set up as it is downloading your image files and building the explorer for you, after it is done, open your browser and type in your EC2 URL on the browser and access it through port 8090.
```
 http://ec2-52-207-214-128.compute-1.amazonaws.com:8090	
```
And type in the user (admin) and password as (adminpw), your will be brought to the explorer windows.

Conclusion

CONGRATULATIONS YOU HAVE LEARNED :

Launching Hyperledger Explorer to explore your fabric networks through one node with docker-compose
Connecting to your Hyperledger 1.2 Network thru Fabric Node Client inside an EC2 Instance
Next tutorial will walk you through

Clean Up

To clean up your resources after testing purposes, delete the CloudFormation template :

In the AWS CloudFormation console delete the stack with the stack name <your network>-Explorer-HLF-Workshop

jumping-dragon/simple-hyperledger