Ethereum AWS Ubuntu Miner Node Installation and Setup

For more information on Ethereum, visit ethereum.org

Description:

Ethereum is a decentralized platform that runs smart contracts using a custom built blockchain. The platform uses a cryptocurrency also called Ethereum (Ether/ETH). This tutorial will walk through all of the necessary steps, required to get a mining rig set up to mine the Ethereum cryptocurrency.

Pre-Requisites:

   COMPATABILITY NOTICE:
These instructions are only compatible with Ubuntu 15.10 or newer  
Although other OS's are supported, this tutorial is built on the Ubuntu platform. The reason that Ubuntu was chosen was simply due to the ease of finding the right ethereum PPA repositories.

1.    Perform an update:

sudo apt-get -y update
sudo apt-get -y upgrade   

2.   Install the Build Essentials:

sudo apt-get -y install build-essential

3.   Ensure we have wget, screen, git and we also need software-properties:

sudo apt-get -y install sudo wget vim screen git software-properties-common

4.    Install the Nvidia Cuda Drivers:

cd /media
sudo wget http://developer.download.nvidia.com/compute/cuda/repos/ubuntu1404/x86_64/cuda-repo-ubuntu1404_8.0.44-1_amd64.deb
sudo dpkg -i cuda-repo-ubuntu1404_8.0.44-1_amd64.deb

Install Ethereum:

1.    Install the Ethereum repos:

sudo add-apt-repository -y ppa:ethereum/ethereum-qt
sudo add-apt-repository -y ppa:ethereum/ethereum
sudo add-apt-repository -y ppa:ethereum/ethereum-dev

2.    Install Ethereum required dependancies:

sudo apt-get -y update
sudo apt-get -y install cmake libcryptopp-dev libleveldb-dev libjsoncpp-dev libjsonrpccpp-dev libboost-all-dev libgmp-dev libreadline-dev libcurl4-gnutls-dev ocl-icd-libopencl1 opencl-headers mesa-common-dev libmicrohttpd-dev cuda

3.    Install Ethereum:

sudo apt-get -y install ethereum

Install the C++ Ethereum miner:

1.    Clone the repo:

cd /media
sudo git clone https://github.com/Genoil/cpp-ethereum/"

2.    Compile the miner:

sudo mkdir /media/cpp-ethereum/build
sudo sh -c 'cd /media/cpp-ethereum/build; cmake -DBUNDLE=miner ..'
sudo sh -c 'cd /media/cpp-ethereum/build; make -j8'

3.    Export GPU settings:

sudo echo 'export GPU_FORCE_64BIT_PTR=0' | sudo tee --append /media/set_env.sh
sudo echo 'export GPU_MAX_HEAP_SIZE=100' | sudo tee --append /media/set_env.sh
sudo echo 'export GPU_USE_SYNC_OBJECTS=1' | sudo tee --append /media/set_env.sh
sudo echo 'export GPU_SINGLE_ALLOC_PERCENT=100' | sudo tee --append /media/set_env.sh
sudo echo 'export GPU_MAX_ALLOC_PERCENT=100' | sudo tee --append /media/set_env.sh

Sync the blockchain:

The next few steps we will run in a screen session, so that they will continue to run even after we close the terminal.

1.    Start a screen session:

screen

2.    Allow the blockchain to sync:

cd ~
geth --rpc console

We can tell that the synchronization is complete when the number field in the geth output, matches the LAST BLOCK value found on etherscan.io

3.    Disconnect from the screen session:

Once the blockchain has completed it's initial syncronization, you can safely detach from the screen session by hitting ctl A, ctl D. This should put you back to your original shell.

4.    Verify screen is still running:

screen -ls

root@localhost~ # screen -ls
There is a screen on:
    2637.pts-0.ip-10-179-4-150  (06/01/2017 08:37:00 AM)    (Detached)

Run the compiled miner:

1.    Start another screen session:

screen

2.    Run the miner:

cd /media/cpp-ethereum/build/ethminer
./ethminer -G

Miningpoolhub:

1.    Create a miningpoolhub.com account:

Go to https://ethereum.miningpoolhub.com, and in the left side menu choose Sign Up

Fill in your username (you will need this later), your password, email and choose a 4 digit pin. Once complete, click on the Register button.

Once registered, you will see a flash message pop up that says Account created, please login.

Login using the Login link on the left menu.

2.    Go to the Ethereum section:

Next we need to associate our wallet address with our account, we do this by clicking Ethereum, under the POOLS section on the left hand menu.

3.    Go to the Wallet section:

Next click on the Wallet link, under the MY ACCOUNT section again in the left hand menu. Clicking this link will show your wallet settings. Fill in the details in the POOL ACCOUNT DETAILS section.

Once the details have been populated, click on Update Account button. Once completed, your wallet should now be registered.

4.    Connect miner to Miningpoolhub.com:

No flags are needed for individual GPUs, ethminer will collectivly use all GPUs on the node

./ethminer -G -S us-east.ethash-hub.miningpoolhub.com:20535 -O <UserName>.<Worker_Name>:<WorkerPassword>

./ethminer -G -S us-east.ethash-hub.miningpoolhub.com:20535 -O clusterfrak.workerx:password

5.    Disconnect from the screen session:

Once the miner has been started, you can safely detach from the screen session by hitting ctl A, ctl D. This should put you back to your original shell.

6.    Verify screen is still running:

screen -ls

root@localhost~ # screen -ls
There are screens on:
    2826.pts-0.ip-10-179-4-150  (06/01/2017 10:45:50 AM)    (Detached)
    2637.pts-0.ip-10-179-4-150  (06/01/2017 08:37:00 AM)    (Detached)

7.    Verify miningpoolhub worker:

Now that your node is successfully mining, wait about 15-20 minutes and check miningpoolhub to see your worker nodes hashrate and work performed. To see your stats, click on Dashboard under the My Account section on the Ethereum Pool page menu

The URL for the miningpoolhub dashboard will be:

https://ethereum.miningpoolhub.com/index.php?page=dashboard

Nanopool:

1.    Connect to Nanopool.org:

No flags are needed for individual GPUs, ethminer will collectivly use all GPUs on the node

./ethminer -G -F http://eth1.nanopool.org:8888/<WALLET_ADDRESS>/<WORKER_NAME>/<EMAIL>

./ethminer -G -F http://eth1.nanopool.org:8888/0x1111222233334444555566667777888899990000/aws-node-1/me@me.com

2.    Disconnect from the screen session:

Once the miner has been started, you can safely detach from the screen session by hitting ctl A, ctl D. This should put you back to your original shell.

3.    Verify screen is still running:

screen -ls

root@localhost~ # screen -ls
There are screens on:
    2826.pts-0.ip-10-179-4-150  (06/01/2017 10:45:50 AM)    (Detached)
    2637.pts-0.ip-10-179-4-150  (06/01/2017 08:37:00 AM)    (Detached)

4.    Verify nanopool registration:

Now that your node is successfully mining, wait about 15-20 minutes and check nanopool to see if you node is registered. Once the account is provisioned based on your worker nodes's work, you will be able to go to your nanopool dashboard, and see all of your running nodes, along with the amount of Ethereum that you made with your worker node.

The URL for nanopool will be:

https://eth.nanopool.org/account/<WALLET_ADDRESS>

So for our example the URL will be:

https://eth.nanopool.org/account/0x1111222233334444555566667777888899990000

Packer File:

The following packer config can be used with packer to automatically provision your own AWS Ethereum Miner Node

{
  "variables": {
    "aws_access_key": "",
    "aws_secret_key": "",
    "instance_type": "g2.8xlarge",
    "region": "us-east-1",
    "use1_ami": "ami-80861296",
    "vpc_id": "",
    "subnet_id": "",
    "security_group_id": "",
    "ssh_keypair_name": "",
    "ssh_username": "ubuntu"

  },
  "builders": [{
    "type": "amazon-ebs",
    "access_key": "{{user `aws_access_key`}}",
    "secret_key": "{{user `aws_secret_key`}}",
    "region": "{{user `region`}}",
    "source_ami": "{{user `use1_ami`}}",
    "instance_type": "{{user `instance_type`}}",
    "ami_name": "Ethereum-Mining-Rig-{{timestamp}}",
    "ami_description": "Image with all of the tools required to mine Ethereum",
    "availability_zone": "us-east-1a",
    "vpc_id": "{{user `vpc_id`}}",
    "subnet_id": "{{user `subnet_id`}}",
    "security_group_id": "{{user `security_group_id`}}",
    "ssh_keypair_name": "{{user `ssh_keypair_name`}}",
    "ssh_agent_auth": true,
    "ssh_username": "{{user `ssh_username`}}",
    "associate_public_ip_address": true,
    "ssh_private_ip": false,
    "tags": {
        "Name": "Ethereum Mining Rig",
        "OS_Version": "Ubuntu 16.04"
    }
  }],

  "provisioners": [
    {
      "type": "shell",
      "inline": [
        "sudo apt-get -y update",
        "sudo apt-get -y upgrade",
        "sudo apt-get -y install build-essential",
        "sudo apt-get -y install sudo wget vim screen git",
        "cd /media",
        "sudo git clone https://github.com/Genoil/cpp-ethereum/",
        "sudo wget http://developer.download.nvidia.com/compute/cuda/repos/ubuntu1404/x86_64/cuda-repo-ubuntu1404_8.0.44-1_amd64.deb",
        "sudo dpkg -i cuda-repo-ubuntu1404_8.0.44-1_amd64.deb",
        "sudo apt-get -y install software-properties-common",
        "sudo add-apt-repository -y ppa:ethereum/ethereum-qt",
        "sudo add-apt-repository -y ppa:ethereum/ethereum",
        "sudo add-apt-repository -y ppa:ethereum/ethereum-dev",
        "sudo apt-get -y update",
        "sudo apt-get -y install cmake libcryptopp-dev libleveldb-dev libjsoncpp-dev libjsonrpccpp-dev libboost-all-dev libgmp-dev libreadline-dev libcurl4-gnutls-dev ocl-icd-libopencl1 opencl-headers mesa-common-dev libmicrohttpd-dev cuda",
        "sudo apt-get -y install ethereum",
        "sudo mkdir /media/cpp-ethereum/build",
        "sudo sh -c 'cd /media/cpp-ethereum/build; cmake -DBUNDLE=miner ..'",
        "sudo sh -c 'cd /media/cpp-ethereum/build; make -j8'",
        "sudo echo 'export GPU_FORCE_64BIT_PTR=0' | sudo tee --append /media/set_env.sh",
        "sudo echo 'export GPU_MAX_HEAP_SIZE=100' | sudo tee --append /media/set_env.sh",
        "sudo echo 'export GPU_USE_SYNC_OBJECTS=1' | sudo tee --append /media/set_env.sh",
        "sudo echo 'export GPU_SINGLE_ALLOC_PERCENT=100' | sudo tee --append /media/set_env.sh",
        "sudo echo 'export GPU_MAX_ALLOC_PERCENT=100' | sudo tee --append /media/set_env.sh",
        "sudo echo 'source /media/set_env.sh' | sudo tee --append /root/.bashrc",
        "sudo echo 'source /media/set_env.sh' | sudo tee --append /home/ubuntu/.bashrc",
        "sudo echo 'source /media/set_env.sh' | sudo tee --append /etc/skel/.bashrc"
      ]
    }
]}

Post Requisites:

None, You can sit back, relax, and collect some ETH !!

References:

Angelomilan Ethereum Guide

Genoil Ethereum Miner Fork

Etherscan.io

Nanopool

Coin Gecko Currency Converter