Skip to content

Commit

Permalink
Cello setup using AWS EC2 instances
Browse files Browse the repository at this point in the history
Added setup instructions for creating AWS instances required for setting Cello.

Added documents docs/awsinstall.md and docs/imgs/AWS-setup/

Fixed issue CE-24

Change-Id: I0015f5fbf282f40e26029c35a16d33b8e3d303cd
Signed-off-by: vishwass <vishwas.shanbhog@outlook.com>
  • Loading branch information
vishwass committed Mar 29, 2017
1 parent 5569f0f commit 3a6c9a3
Show file tree
Hide file tree
Showing 9 changed files with 53 additions and 2 deletions.
4 changes: 2 additions & 2 deletions .env
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
STATIC_FOLDER=
TEMPLATE_FOLDER=
STATIC_FOLDER=themes/basic/static
TEMPLATE_FOLDER=themes/basic/templates
51 changes: 51 additions & 0 deletions docs/awsinstall.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
#Setup of Hyperledger Cello using AWS EC2 Ubuntu 14.04 instances

##Steps for creating an AWS instance and Cello setup.

1. If you dont have an Amazon AWS account, create one.

2. After logging into AWS console, in the services section, select EC2.

3. Create atleast 2 instances.One for master node and one for host. Click launch instance. Select Ubuntu 14.04 image as shown in figure ![Select Image](docs/imgs/AWS-setup/1-selectimage.JPG).

4. Select the instance type depending on requirements as shown in figure ![select Instance Type](docs/imgs/AWS-setup/2-ChooseInstanceType.JPG).

5. Add more configuration details as needed. Make sure that Auto-assign public IP is enabled. For your reference ![IP setup](docs/imgs/AWS-setup/3-morecongfigurations-enablePublicIP.JPG).

6. Add necessary storage. ![Image](docs/imgs/AWS-setup/4-addStorage.JPG).

7. Add tags as needed. ![Image](docs/imgs/AWS-setup/5-Addtags.JPG).

8. Create a security group and define rules for instances.I have kept minimum security by allowing http,tcp and ssh available to internet. Try to make it as secure as possible.![Example settings for security rules](docs/imgs/AWS-setup/6-Security-rules.JPG).

9. Download private key for ssh into the instances and launch instance. ![Image](docs/imgs/AWS-setup/7-launchinstance.JPG).

10. From terminal, you can ssh into the AWS Ubuntu instance using command- *sudo ssh -i yourprivatekey.pem ubuntu@IP*.

11. Install docker and docker-compose. Follow the Cello master node setup as given in following document ![here](docs/install.md). In the host, follow the worker node setup as given in link ![here](docs/install.md). Other steps are the same for both master and worker node.

12. Once done, in the master node, you should be able to run the command *docker -H Worker_Node_IP:2375 version*.

Example: You should get something like this-

ubuntu@ip-172-31-34-249:~$ docker -H 54.87.59.141:2375 version
Client:
Version: 17.03.0-ce
API version: 1.26
Go version: go1.7.5
Git commit: 3a232c8
Built: Tue Feb 28 07:57:58 2017
OS/Arch: linux/amd64

Server:
Version: 17.03.0-ce
API version: 1.26 (minimum version 1.12)
Go version: go1.7.5
Git commit: 3a232c8
Built: Tue Feb 28 07:57:58 2017
OS/Arch: linux/amd64
Experimental: false

13. You should be able to open the link *http://MasternodeIP:8080* .You can login and add hosts. Once the hosts are added, you can create blockchains.


Binary file added docs/imgs/AWS-setup/1-selectimage.JPG
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/imgs/AWS-setup/2-ChooseInstanceType.JPG
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/imgs/AWS-setup/4-addStorage.JPG
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/imgs/AWS-setup/5-Addtags.JPG
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/imgs/AWS-setup/6-Security-rules.JPG
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/imgs/AWS-setup/7-launchinstance.JPG
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 3a6c9a3

Please sign in to comment.