IQUIDUS EXPLORER INSTALLATION ON VPS

INTRO: switch from Bitpay Inishgt

기존의 Bitpay Insight를 사용하고 있었다. 나쁘지 않았다 하지만 bitcoin v0.16 이후에 getinfo가 삭제되었고 최신버젼에서는 Bitpay Insight를 더이상 사용할수없다. 그 대안으로 찾은것이 바로 IQUIDUS EXPLORER 이다. 다양한 기능을 제공하며 꽤 괜찮은 성능을 보여준다.

Bitpay Insight doesn't support after bitcoin v0.16

info: insight server listening on port 3000 in development mode
error: ERROR  code=-32601, message=getinfo

This call was removed in version 0.16.0. Use the appropriate fields from:
- getblockchaininfo: blocks, difficulty, chain
- getnetworkinfo: version, protocolversion, timeoffset, connections, proxy, relayfee, warnings
- getwalletinfo: balance, keypoololdest, keypoolsize, paytxfee, unlocked_until, walletversion

install VPS server

locale all to `en_US.UTF-8`

export LANGUAGE="en_US.UTF-8" && \
echo 'LANGUAGE="en_US.UTF-8"' >> /etc/default/locale && \
echo 'LC_ALL="en_US.UTF-8"' >> /etc/default/locale

timezone to `Asia/Seoul`

sudo timedatectl set-timezone Asia/Seoul

LOGOUT/IN

install coind

wallet depends

cd && \
sudo add-apt-repository ppa:bitcoin/bitcoin -y && \
sudo apt-get update -y && \
sudo apt-get install -y \
software-properties-common libdb4.8-dev libdb4.8++-dev build-essential libtool autotools-dev automake pkg-config libssl-dev libevent-dev bsdmainutils libboost-all-dev libminiupnpc-dev libzmq3-dev libqt5gui5 libqt5core5a libqt5dbus5 qttools5-dev qttools5-dev-tools libprotobuf-dev protobuf-compiler libqrencode-dev

wallet build (check branch!)

cd && \
git clone git@github.com:cryptozeny/sugarchain-v0.16.3.git && \
cd sugarchain-v0.16.3/ && \
./autogen.sh && \
./configure && \
make -j$(nproc)

if your VPS doesn't have enough memory (under 1GB)

./configure CXXFLAGS="--param ggc-min-expand=1 --param ggc-min-heapsize=32768"

if it doesn't help, use swap bitcoin/bitcoin#6624

wallet run: explorer needs `-txindex=1`

for testing log -printtoconsole instead of -daemon

/root/sugarchain-v0.16.3/src/sugarchaind -server=1 -txindex=1 -rpcuser=username -rpcpassword=password -daemon

install explorer

Nodejs (explorer needs node v0.10.28)

cd && curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.9/install.sh | bash

LOGOUT/IN

nvm ls-remote && \
nvm install v0.10.28 && \
nvm ls && \
node -v && \
nvm use v0.10.28

LOGOUT/IN

explorer depends

cd && \
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv EA312927 && \
echo "deb http://repo.mongodb.org/apt/ubuntu trusty/mongodb-org/3.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.2.list && \
sudo apt-get update && \
sudo apt-get install -y mongodb-org libkrb5-dev

upstart for starting MongoDB

sudo apt-get install upstart-sysv -y

REBOOT

explorer DB start

sudo service mongod stop && \
sudo service mongod start

explorer MongoDB create

$ mongo
> use explorerdb
> db.createUser( { user: "mongo-user", pwd: "mongo-pwd", roles: [ "readWrite" ] } )
> exit

option: drop MongoDB

$ mongo
> use explorerdb;
> db.dropDatabase();
> db.dropUser("mongo-user")
> exit

explorer install (check branch!)

cd && \
git clone git@github.com:sugarchain-project/explorer.git explorer && \
cd explorer && npm install --production

explorer settings

cp ./settings.json.sugarchain ./settings.json

edit ./settings.json

explorer test-run (use different terminals)

npm start # term-1
node scripts/sync.js index update # term-2 (run twice: take a while...)

stop both after sync completed

forever for Nodejs

npm install forever -g
npm install forever-monitor

[debug] explorer start

forever start bin/cluster

[debug] explorer update every `15s` (sync.js peer.js)

update first

node scripts/sync.js index update && \
node scripts/sync.js market && \
node scripts/peers.js

update auto

while true; 
do touch tmp/index.pid && \
rm -f ./tmp/index.pid && \
node scripts/sync.js index update && \
node scripts/sync.js market && \
node scripts/peers.js && \
sleep 5.0;
done

[production] cron

fix forever location for crontab

sudo ln -s $(which node) /usr/bin/node

make crontab

sudo crontab -e

# explorer
@reboot /root/explorer/run.sh >> /root/run.log 2>&1

run.log

#!/bin/bash

# coind daemon
$HOME/sugarchain-v0.16.3/src/sugarchaind -server=1 -rpcuser=username -rpcpassword=password -txindex -daemon

# waiting for daemon
echo "***** sleep 30 seconds for daemon *****"
sleep 30.0

# start explorer
cd $HOME/explorer/
touch ./tmp/index.pid
rm -f ./tmp/index.pid
$HOME/.nvm/v0.10.28/bin/forever start ./bin/cluster

# waiting for explorer
echo "***** sleep 30 seconds for explorer *****"
sleep 30.0

# update
while true;
do
    cd $HOME/explorer/
    touch ./tmp/index.pid
    rm -f ./tmp/index.pid
    node ./scripts/sync.js index update
    # node scripts/sync.js market
    node ./scripts/peers.js
    echo "***** sleep 5 seconds *****"
    sleep 5.0
done

(OPTION) stop and restart

cd /root/explorer/ && forever stop bin/cluster
cd /root/explorer/ && forever start bin/cluster
cd /root/explorer/ && forever restart bin/cluster

(OPTION) check forever log

forever list
tail -f /root/.forever/PwHy.log

DNS

setting up for website

firewall

22 for SSH 80 for Website 443 for Redirect 7979 for Sugarchain(Main) 17979 for Sugarchain(Testnet) 17799 for Sugarchain(Regtest)

sudo ufw status && \
sudo ufw allow 22 && \
sudo ufw allow 80 && \
sudo ufw allow 443 && \
sudo ufw allow 7979 && \
sudo ufw allow 17979 && \
sudo ufw allow 17799 && \
sudo ufw enable && \
sudo ufw status

nginx

website url is explorer.sugarchain.org

sudo apt-get install -y nginx && \
sudo rm /etc/nginx/sites-enabled/default

make file

sudo nano /etc/nginx/sites-available/explorer.sugarchain.org

paste it

server {
    listen 80;
    server_name explorer.sugarchain.org;

    location / {
        proxy_set_header   X-Forwarded-For $remote_addr;
        proxy_set_header   Host $http_host;
        proxy_pass         "http://127.0.0.1:3001";
    }
}

make ln & restart nginx

sudo ln -s \
/etc/nginx/sites-available/explorer.sugarchain.org \
/etc/nginx/sites-enabled/explorer.sugarchain.org && \
sudo service nginx restart

get a DNS name

AWS route53 recommended Adds A record with explorer. Add nameserver to route53

SSL certbot

cd && \
git clone https://github.com/certbot/certbot && \
cd certbot && \
sudo service nginx restart && \
LC_ALL=C ./certbot-auto run --nginx && \
sudo service nginx reload

cron for renew certbot

crontab -e

add it (everyday at 08:16)

# SSL renew by certbot (everyday at 08:16)
16 8 * * * $HOME/certbot/certbot-auto renew --no-self-upgrade --post-hook "/usr/sbin/service nginx reload"

REBOOT

MISC

(OPTION) change website URL

https://github.com/sugarchain-project/explorer/commit/2d29302470e1164d0aff9001bf2dbdcd486bec71

License

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of Iquidus Technology nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Name		Name	Last commit message	Last commit date
Latest commit History 358 Commits
bin		bin
lib		lib
locale		locale
models		models
public		public
routes		routes
scripts		scripts
spec		spec
test		test
tmp		tmp
views		views
.gitignore		.gitignore
CHANGELOG		CHANGELOG
LICENSE		LICENSE
README-original.md		README-original.md
README.md		README.md
UPGRADE		UPGRADE
app.js		app.js
package.json		package.json
run.sh		run.sh
settings.json		settings.json
settings.json.template		settings.json.template

License

soodal28/explorer

Folders and files

Latest commit

History

Repository files navigation

IQUIDUS EXPLORER INSTALLATION ON VPS

INTRO: switch from Bitpay Inishgt

install VPS server

locale all to en_US.UTF-8

timezone to Asia/Seoul

install coind

wallet depends

wallet build (check branch!)

wallet run: explorer needs -txindex=1

install explorer

Nodejs (explorer needs node v0.10.28)

explorer depends

upstart for starting MongoDB

explorer DB start

explorer MongoDB create

option: drop MongoDB

explorer install (check branch!)

explorer settings

explorer test-run (use different terminals)

forever for Nodejs

[debug] explorer start

[debug] explorer update every 15s (sync.js peer.js)

[production] cron

(OPTION) stop and restart

(OPTION) check forever log

DNS

firewall

nginx

get a DNS name

SSL certbot

cron for renew certbot

MISC

(OPTION) change website URL

License

About

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Languages

locale all to `en_US.UTF-8`

timezone to `Asia/Seoul`

wallet run: explorer needs `-txindex=1`

[debug] explorer update every `15s` (sync.js peer.js)

Packages