how to Setup Pirl (PIRL) coin mining Pool Guide step by step

Pirl (PIRL) coin mining Pool Setup Guide

This a step by step guide on how to setup your own Pirl Coin Mining Pool. This guide is going over how to setup an Open open-Pirl-coin-pool . This is meant to setup a mining pool for a SINGLE CRYPTO CURRENCY. This is not a guide for a Multipool!!!!

If you want to see what it looks like before you set it all up, head to the http://pirl.miningpond.com/#/

For this guide purpose we I will be using Pirl Coin Crypto Currency .

Requirements

• VPS with at least 1GB of Ram you can get it from any where like vultr , lenode , digitalocen
• Ubuntu 16.04 x64
• Putty (http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html)
• WinSCP (http://winscp.net/eng/download.php)

Setup

At this point you should have your VPS started, putty up and running and your logged in as root.

UPDATE UBUNTU 16

sudo apt-get update

sudo apt-get dist-upgrade

sudo reboot

Install make and build tools

sudo apt-get install build-essential make

GoLangInstall GoLang

wget https://storage.googleapis.com/golang/go1.9.2.linux-amd64.tar.gz

sudo tar -xvf go1.9.2.linux-amd64.tar.gz

sudo mv go /usr/local

export GOROOT=/usr/local/go

export PATH=$GOPATH/bin:$GOROOT/bin:$PATH

export GOPATH=$HOME/go

Type: go version

You should have a response with the version.

Installing Redis latest version

wget http://download.redis.io/redis-stable.tar.gz
tar xvzf redis-stable.tar.gz
cd redis-stable
make
sudo cp src/redis-server /usr/local/bin/

sudo cp src/redis-cli /usr/local/bin/

sudo mkdir /etc/redis

sudo mkdir /var/redis

sudo cp utils/redis_init_script /etc/init.d/redis_6379

sudo cp redis.conf /etc/redis/6379.conf

sudo nano /etc/redis/6379.conf

• Edit the configuration file, making sure to perform the following changes:
• Set daemonize to yes (by default it is set to no).
• Set the dir to /var/redis/6379 (very important step!)

sudo mkdir /var/redis/6379

sudo update-rc.d redis_6379 defaults

sudo /etc/init.d/redis_6379 start

Test Redis Install

redis-cli

Expected response

redis 127.0.0.1:6379> ping

PONG

exit

Install nginx

sudo apt-get install nginx

NGINX starts automatically on port 80. This is all that needs to be competed at this step.

NPM and NODE Install

Install using this guide provided ..

https://www.digitalocean.com/community/tutorials/how-to-install-node-js-on-ubuntu-16-04

ln -s `which nodejs` /usr/bin/node

User Setup

You never run things like your coin daemon (wallet), or pool as root!

Let’s create a user for your mining pool.

Login to ssh using putty as root.

adduser usernameyouwant

You’ll be prompted for a password, please use a password that is different from your root password.
The other info it asks for you can either fill out or just leave blank and hit enter.

Now let’s give that new user sudo access.

adduser usernameyousetup sudo

Pirl Coin Demon install

Login to server as user we have crated above this step

cd ~

mkdir pirl

cd pirl

git clone https://github.com/pirl/pirl.git

cd pirl

export GOROOT=/usr/local/go

export PATH=$GOPATH/bin:$GOROOT/bin:$PATH

export GOPATH=$HOME/go

make pirl

Run pirl For first Time

cd build/bin/

./pirl – rpc console

-add account for miner pool

personal.newAccount()

You will see like this ” 0xf0d066c928aeb570847900a1a39fde27a98d83ce ”

Save this adders in you pc somewhere as we need to use this in later stage of configuration

DON’T FORGET PASSWORD

To Exit: Control B release buttons and then press D

Pirl Coin Pool Build

cd ..

git clone https://github.com/sammy007/open-ethereum-pool.git

cd open-ethereum-pool

IF YOU NEED TO RUN MAKE AGAIN USE:

export GOROOT=/usr/local/go

export PATH=$GOPATH/bin:$GOROOT/bin:$PATH

export GOPATH=$HOME/go

make

Edit pool configs before ./build

cp ~/open-ethereum-pool/config.example.json ~/open-ethereum-pool/build/bin/config.json

edit config.json

edit www/config/environment.js

Change ApiUrl: ‘//example.net/’ to ApiUrl: ‘//youtdomain.com:8080/

Configuration

Configuration is actually simple, just read it twice and think twice before changing defaults.

Don’t copy config directly from this manual. Use the example config from the package, otherwise you will get errors on start because of JSON comments.

{
  // Set to the number of CPU cores of your server
  "threads": 2,
  // Prefix for keys in redis store
  "coin": "PIRL",
  // Give unique name to each instance
  "name": "main",

  "proxy": {
    "enabled": true,

    // Bind HTTP mining endpoint to this IP:PORT
    "listen": "0.0.0.0:8888",

    // Allow only this header and body size of HTTP request from miners
    "limitHeadersSize": 1024,
    "limitBodySize": 256,

    /* Set to true if you are behind CloudFlare (not recommended) or behind http-reverse
      proxy to enable IP detection from X-Forwarded-For header.
      Advanced users only. It's tricky to make it right and secure.
    */
    "behindReverseProxy": false,

    // Stratum mining endpoint
    "stratum": {
      "enabled": true,
      // Bind stratum mining socket to this IP:PORT
      "listen": "0.0.0.0:8008",
      "timeout": "120s",
      "maxConn": 8192
    },

    // Try to get new job from geth in this interval
    "blockRefreshInterval": "120ms",
    "stateUpdateInterval": "3s",
    // Require this share difficulty from miners
    "difficulty": 2000000000,

    /* Reply error to miner instead of job if redis is unavailable.
      Should save electricity to miners if pool is sick and they didn't set up failovers.
    */
    "healthCheck": true,
    // Mark pool sick after this number of redis failures.
    "maxFails": 100,
    // TTL for workers stats, usually should be equal to large hashrate window from API section
    "hashrateExpiration": "3h",

    "policy": {
      "workers": 8,
      "resetInterval": "60m",
      "refreshInterval": "1m",

      "banning": {
        "enabled": false,
        /* Name of ipset for banning.
        Check http://ipset.netfilter.org/ documentation.
        */
        "ipset": "blacklist",
        // Remove ban after this amount of time
        "timeout": 1800,
        // Percent of invalid shares from all shares to ban miner
        "invalidPercent": 30,
        // Check after after miner submitted this number of shares
        "checkThreshold": 30,
        // Bad miner after this number of malformed requests
        "malformedLimit": 5
      },
      // Connection rate limit
      "limits": {
        "enabled": false,
        // Number of initial connections
        "limit": 30,
        "grace": "5m",
        // Increase allowed number of connections on each valid share
        "limitJump": 10
      }
    }
  },

  // Provides JSON data for frontend which is static website
  "api": {
    "enabled": true,
    "listen": "0.0.0.0:8080",
    // Collect miners stats (hashrate, ...) in this interval
    "statsCollectInterval": "5s",
    // Purge stale stats interval
    "purgeInterval": "10m",
    // Fast hashrate estimation window for each miner from it's shares
    "hashrateWindow": "30m",
    // Long and precise hashrate from shares, 3h is cool, keep it
    "hashrateLargeWindow": "3h",
    // Collect stats for shares/diff ratio for this number of blocks
    "luckWindow": [64, 128, 256],
    // Max number of payments to display in frontend
    "payments": 50,
    // Max numbers of blocks to display in frontend
    "blocks": 50,

    /* If you are running API node on a different server where this module
      is reading data from redis writeable slave, you must run an api instance with this option enabled in order to purge hashrate stats from main redis node.
      Only redis writeable slave will work properly if you are distributing using redis slaves.
      Very advanced. Usually all modules should share same redis instance.
    */
    "purgeOnly": false
  },

  // Check health of each geth node in this interval
  "upstreamCheckInterval": "5s",

  /* List of geth nodes to poll for new jobs. Pool will try to get work from
    first alive one and check in background for failed to back up.
    Current block template of the pool is always cached in RAM indeed.
  */
  "upstream": [
    {
      "name": "main",
      "url": "http://127.0.0.1:6588",
      "timeout": "10s"
    },
    {
      "name": "backup",
      "url": "http://127.0.0.2:6588",
      "timeout": "10s"
    }
  ],

  // This is standard redis connection options
  "redis": {
    // Where your redis instance is listening for commands
    "endpoint": "127.0.0.1:6379",
    "poolSize": 10,
    "database": 0,
    "password": ""
  },

  // This module periodically remits ether to miners
  "unlocker": {
    "enabled": false,
    // Pool fee percentage
    "poolFee": 1.0,
    // Pool fees beneficiary address (leave it blank to disable fee withdrawals)
    "poolFeeAddress": "",
    // Donate 10% from pool fees to developers
    "donate": false,
    // Unlock only if this number of blocks mined back
    "depth": 120,
    // Simply don't touch this option
    "immatureDepth": 20,
    // Keep mined transaction fees as pool fees
    "keepTxFees": false,
    // Run unlocker in this interval
    "interval": "10m",
    // Geth instance node rpc endpoint for unlocking blocks
    "daemon": "http://127.0.0.1:6588",
    // Rise error if can't reach geth in this amount of time
    "timeout": "10s"
  },

  // Pay out miners using this module
  "payouts": {
    "enabled": false,
    // Require minimum number of peers on node
    "requirePeers": 25,
    // Run payouts in this interval
    "interval": "12h",
    // Geth instance node rpc endpoint for payouts processing
    "daemon": "http://127.0.0.1:6588",
    // Rise error if can't reach geth in this amount of time
    "timeout": "10s",
    // Address with pool balance
    "address": "0x0",
    // Let geth to determine gas and gasPrice
    "autoGas": true,
    // Gas amount and price for payout tx (advanced users only)
    "gas": "21000",
    "gasPrice": "50000000000",
    // Send payment only if miner's balance is >= 0.5 Ether
    "threshold": 10000000000,
    // Perform BGSAVE on Redis after successful payouts session
    "bgsave": false
  }
}

Build configuration

cd www

sudo npm install -g ember-cli@2.9.1

sudo npm install -g bower

sudo npm install

bower install

./build.sh

NGINX Config

-Change NGINX default config

sudo nano /etc/nginx/sites-available/default

The final config for NGINX should be formatted like this:

upstream api
{
server dbix.drowningpool.net:8080;
}

server {
listen 80 default_server;
listen [::]:80 default_server;
root /home/username/open-ethereum-pool/www/dist; # <- This should be the absolute path to the files
index index.html index.htm index.nginx-debian.html;

server_name _;

location / {
# First attempt to serve request as file, then
# as directory, then fall back to displaying a 404.
try_files $uri $uri/ =404;
}

location /api
{
proxy_pass http://api;
}
}

Restart NGINX

sudo service nginx reload

Firewall ports to open

Stratum: 8008

Web 80

Proxy is 8888 and can be opened for http getwork clients.

Make password file for wallet unlock in rpc

Login to server using

• WinSCP (http://winscp.net/eng/download.php)

Now go to Pirlcoin folder

Right click >> create new file >> add the password you use when you creating account in music coin demon >> save it

Start Pirl Coin demon

screen

If comand not working use

sudo apt-get install screen

cd pirl/pirl/build/bin/

./pirl –rpc –cache=128 –extradata “your-domain-name” –identity “your-domain-name” –maxpeers 500 –rpcapi “eth,net,web3,admin” –rpcport “6588” –rpcaddr “127.0.0.1” –etherbase “your-wallet-address- created above step ” –unlock “your-wallet-address- created above step” –password “location to password file” –rpccorsdomain “localhost” –mine –minerthreads 0

IT will take some hours to sync with blockchain so just close this putty session and will will run for ever in the screen

Start Pool

cd ~/open-ethereum-pool/build/bin

./open-ethereum-pool config.json

Some important command to interact with your pool wallet

— Send fund from pool wallet to another wallet ——-

eth.sendTransaction({from: ‘0xf0d066c928aeb570847900a1a39fde27a98d83ce’, to: ‘0x325e8a67db242341a2b65bf0524566c34d3c26f7’, value: web3.toWei(851.5, “ether”)})

— unlock your wallet —-

personal.unlockAccount(primary, “password”);

— Check balance —

web3.fromWei(eth.getBalance(eth.coinbase), “ether”)

Notes

• Unlocking and payouts are sequential, 1st tx go, 2nd waiting for 1st to confirm and so on. You can disable that in code. Carefully read docs/PAYOUTS.md.
• Also, keep in mind that unlocking and payouts will halt in case of backend or node RPC errors. In that case check everything and restart.
• You must restart module if you see errors with the word suspended.
• Don’t run payouts and unlocker modules as part of mining node. Create separate configs for both, launch independently and make sure you have a single instance of each module running.
• If poolFeeAddress is not specified all pool profit will remain on coinbase address. If it specified, make sure to periodically send some dust back required for payments.

I hope you enjoyed this basic how-to on the PirlCoin pool build!