PRCYCoin MN Installer

v1.1.0

General Information

A custom masternode install script made from scratch specifically for installing PRCYCoin masternodes.

Currently, it supports installation on Ubuntu 16.04+ and Debian 8.x+ x64 and should be generic enough to work on any VPS provider or as a local installation at home.

Since this script has the potential to install "extra" software components such as a firewall and/or create a swap disk file, root privileges are required to install properly. Therefore, you must either run the script using the sudo command prefix or else run directly as the root user (generally not recommended for security reasons but still supported).

All wallets are installed to the /usr/local/bin directory.

To save time on 2+ installs, the wallet binaries are archived in the wallet directory (typically /usr/local/bin/PRCYCoin) after the first successful install and those locally stored files are then used to install subsequent wallet installs in much less time than the first.

Features

• Supports installing, updating or uninstalling up to 99 PRCYCoin masternode installs on the same VPS
• IPv4 and IPv6 support
• Script update feature ensures you are always installing using the most up-to-date script
• Wallet update feature ensures you do not have to wait for an updated script to be released to install the latest wallet version
• Install wallet from compiled binary files or build from source code
• Faster syncing times for 2+ installs by copying previously installed blockchain files over to new installs
• Automatic restart of installed masternodes after reboot
• Install additional setup components such as swap disk file, firewall configuration and brute-force protection
• Automatic generation of genkey value provides heightened security with less user interaction
• Visualize the blockchain sync process after installation to ensure wallet(s) are all caught up with current block counts
• Custom ascii art PRCYCoin logo

Future Features/Known Issues

• Updating a previously installed wallet needs to remove previous settings before applying new settings
• Updating a previously installed wallet needs to be smart enough to get the current configuration values instead of using 'new install' defaults
• Properly shutdown all wallets automatically when a reboot or shutdown command is issued to prevent blockchain corruption
• Automatically remove firewall rules for port(s) that pertain to a specific wallet install when the wallet is uninstalled

Recomended Installation Instructions

To begin, you must first download the initial script and give it execute permission with the following 2 commands:

wget https://raw.githubusercontent.com/PRCYCoin/PRCY-mn-installer/master/prcycoin-mn-installer.sh

sudo chmod +x prcycoin-mn-installer.sh

Install 1st/default wallet using IPv6:

sudo sh prcycoin-mn-installer.sh

Install 1st/default wallet using the default IPv4 address:

sudo sh prcycoin-mn-installer.sh -N 4

Install 2nd wallet using IPv6 (not required, but also skip the disk swap file setup and brute-force protection setup since those only need to be installed once):

sudo sh prcycoin-mn-installer.sh -n 2 -s -b

Install 2nd wallet using IPv4 (a 2nd ip address needs to be specified if you have purchased more than 1 IPv4 ip address) (not required, but also skip the disk swap file setup and brute-force protection setup since those only need to be installed once):

sudo sh prcycoin-mn-installer.sh -n 2 -N 4 -i 45.32.168.34 -s -b

NOTE: Installing the 3rd, 4th, 5th, etc wallets are identical to the 2nd wallet except that you would change the -n value to 3, 4, 5, etc

sudo sh prcycoin-mn-installer.sh -n 3 -s -b
sudo sh prcycoin-mn-installer.sh -n 4 -s -b
sudo sh prcycoin-mn-installer.sh -n 5 -s -b

NOTE: If you are installing multiple wallets, they do not need to be installed in any specific order although it is generally easier to install in numerical sequence (install 1 then 2 then 3, etc).

Update Instructions

At any point after the initial installation you can "refresh" a particular wallet install by re-running the following command:

sudo sh prcycoin-mn-installer.sh

This will "remember" all of your previously installed settings and allow you to update the installed wallet to the latest version (assuming a new version has been released since the last update/install).

If you would like to keep your wallet installed but just change one of the options, such as ip address type, you could update install using something like this:

sudo sh prcycoin-mn-installer.sh -N 4

This would allow you to change an IPv6 installed wallet into an IPv4 wallet. NOTE: Changing options like this will most likely require you to reconfigure your cold wallet prcycoin.conf and masternode.conf files. The 'Final setup instructions' are always displayed at the end of an update install the same way as they are for the initial install.

Available Command-Line Options

• -h or --help

  Displays the help menu

  Usage Example: sudo sh prcycoin-mn-installer.sh -h

• -t or --type

  Install type. There are 2 valid options: i = install (default), u = uninstall

  Usage Example: sudo sh prcycoin-mn-installer.sh -t i

• -w or --wallet

  Wallet type. There are 2 valid options: d = download (default), b = build from source

  Usage Example: sudo sh prcycoin-mn-installer.sh -w b

• -g or --genkey

  The masternode genkey value. Generate this with the masternode genkey command either automatically from the VPS wallet (recommended) or from your hot wallet in the Debug Console). If left blank the value will be autogenerated

  Usage Example: sudo sh prcycoin-mn-installer.sh -g 88pgtdc9rgiEFMarhuVAdDjeDBUiPbFPhqdafFsBUKcgS3XovPc

• -N or --net

  IP address type. There are 2 valid options: 6 = IPv6 (default), 4 = IPv4

  Usage Example: sudo sh prcycoin-mn-installer.sh -N 4

• -i or --ip

  Specify the IPv4 or IPv6 IP address to bind to the node. If left blank and -N = 4 then the main WAN IPv4 address will be used. If left blank and -N = 6 then a new IPv6 address will be registered

  Usage Example: sudo sh prcycoin-mn-installer.sh -i 46.5.102.49

• -p or --port

  Specify the port # that the wallet should listen on. If left blank the value will be auto-selected

  Usage Example: sudo sh prcycoin-mn-installer.sh -p 59682

• -n or --number

  The node install #. Default install # is 1. Increment this value to set up 2+ nodes. Only a single wallet will be installed each time the script is run. Valid inputs are 1-99

  Usage Example: sudo sh prcycoin-mn-installer.sh -n 2

• -a or --adapter

  Specify the network adapter the node should be bound to. If left blank the first available and enabled adapter will be chosen

  Usage Example: sudo sh prcycoin-mn-installer.sh -a ens38

• -s or --noswap

  Skip creating the disk swap file. The swap file only needs to be created once per computer. It is strongly recommended that you do not skip this install unless you are sure your VPS has enough memory

  Usage Example: sudo sh prcycoin-mn-installer.sh -s

• -f or --nofirewall

  Skip the firewall setup. It is strongly recommended that you do not skip this install unless you plan to do the firewall setup manually

  Usage Example: sudo sh prcycoin-mn-installer.sh -f

• -b or --nobruteprotect

  Skip the brute-force protection setup. Brute-force protection only needs to be installed once per computer

  Usage Example: sudo sh prcycoin-mn-installer.sh -b

• -c or --nochainsync

  Skip waiting for the blockchain to sync after installation. Default is to wait for the blockchain to fully sync before exiting. Only works when the block explorer web address can be reached

  Usage Example: sudo sh prcycoin-mn-installer.sh -c

• -u or --noosupgrade

  Skip applying operating system updates/upgrades before installation. Default is to run the following before doing an install:

  apt-get update
  apt-get upgrade
  apt-get dist-upgrade
  

  Usage Example: sudo sh prcycoin-mn-installer.sh -u

• -S or --stopall

  Shutdown all wallets controlled by this script and wait for all to finish shutting down before continuing

  Usage Example: sudo sh prcycoin-mn-installer.sh -S

Uninstallation Instructions

Uninstall 1st/default wallet:

sudo sh prcycoin-mn-installer.sh -t u

Uninstall 2nd wallet:

sudo sh prcycoin-mn-installer.sh -t u -n 2

Uninstall 3rd, 4th, 5th wallet:

sudo sh prcycoin-mn-installer.sh -t u -n 3
sudo sh prcycoin-mn-installer.sh -t u -n 4
sudo sh prcycoin-mn-installer.sh -t u -n 5

NOTE: You can uninstall any wallet at any time. They do not need to be uninstalled in any specific order.

Useful Commands

NOTE: To manually run commands (such as starting the wallet or running the 'stop' or 'getmasternodestatus' commands) on one of the 2+ installs you must reference the correct data directory.

Stop the 1st/default wallet:

prcycoin-cli stop

Stop the 2nd wallet:

prcycoin-cli2 -datadir=$HOME/.prcycoin2 stop

Stop the 3rd, 4th, 5th wallet:

prcycoin-cli3 -datadir=$HOME/.prcycoin3 stop
prcycoin-cli4 -datadir=$HOME/.prcycoin4 stop
prcycoin-cli5 -datadir=$HOME/.prcycoin5 stop

Start the 1st/default wallet:

prcycoind

Start the 2nd wallet:

prcycoind2 -datadir=$HOME/.prcycoin2

Start the 3rd, 4th, 5th wallet:

prcycoind3 -datadir=$HOME/.prcycoin3
prcycoind4 -datadir=$HOME/.prcycoin4
prcycoind5 -datadir=$HOME/.prcycoin5

View the 1st/default wallets current block:

prcycoin-cli getblockcount

View the 2nd wallets current block:

prcycoin-cli2 -datadir=$HOME/.prcycoin2 getblockcount

View the 3rd, 4th, 5th wallets current block:

prcycoin-cli3 -datadir=$HOME/.prcycoin3 getblockcount
prcycoin-cli4 -datadir=$HOME/.prcycoin4 getblockcount
prcycoin-cli5 -datadir=$HOME/.prcycoin5 getblockcount

Check masternode status for the 1st/default wallet:

prcycoin-cli getmasternodestatus

Check masternode status for the 2nd wallet:

prcycoin-cli2 -datadir=$HOME/.prcycoin2 getmasternodestatus

Check masternode status for the 3rd, 4th, 5th wallets:

prcycoin-cli3 -datadir=$HOME/.prcycoin3 getmasternodestatus
prcycoin-cli4 -datadir=$HOME/.prcycoin4 getmasternodestatus
prcycoin-cli5 -datadir=$HOME/.prcycoin5 getmasternodestatus

Shut down all running wallets:

sudo sh prcycoin-mn-installer.sh -S

Sample cron job to shut down all running wallets and reboot once a month:

1st allow reboot cmd to be run without root permissions:

sudo chmod u+s /sbin/reboot

Then add the following to a crontab:

0 0 1 * * sh prcycoin-mn-installer.sh -S && reboot

Alternate syntax in case you need to provide the full path to the reboot cmd:

0 0 1 * * sh prcycoin-mn-installer.sh -S && /sbin/reboot