Exor MN Installer

v1.1.0

General Information

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

Currently, it must be run on Ubuntu Linux 16.04 and has been tested to work using VPS systems from vultr.com and lunanode.com only but should be generic enough to run anywhere (Please let @joeuhren know your experience on https://t.me/ExorOfficialSupport or @Joe [Team Exor]#5573 on https://discord.gg/dSuGm3y if you have tried with another VPS provider).

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/Exor) 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 Exor 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 Exor 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/team-exor/exor-mn-installer/master/exor-mn-installer.sh

sudo chmod +x exor-mn-installer.sh

Install 1st/default wallet using IPv6:

sudo sh exor-mn-installer.sh

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

sudo sh exor-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 exor-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 exor-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 exor-mn-installer.sh -n 3 -s -b
sudo sh exor-mn-installer.sh -n 4 -s -b
sudo sh exor-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 exor-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 exor-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 exor.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 exor-mn-installer.sh -h

• -t or --type

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

  Usage Example: sudo sh exor-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 exor-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 exor-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 exor-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 exor-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 exor-mn-installer.sh -p 4559

• -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 exor-mn-installer.sh -n 2

• -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 exor-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 exor-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 exor-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 exor-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 exor-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 exor-mn-installer.sh -S

Uninstallation Instructions

Uninstall 1st/default wallet:

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

Uninstall 2nd wallet:

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

Uninstall 3rd, 4th, 5th wallet:

sudo sh exor-mn-installer.sh -t u -n 3
sudo sh exor-mn-installer.sh -t u -n 4
sudo sh exor-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:

exor-cli stop

Stop the 2nd wallet:

exor-cli2 -datadir=$HOME/.exor2 stop

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

exor-cli3 -datadir=$HOME/.exor3 stop
exor-cli4 -datadir=$HOME/.exor4 stop
exor-cli5 -datadir=$HOME/.exor5 stop

Start the 1st/default wallet:

exord

Start the 2nd wallet:

exord2 -datadir=$HOME/.exor2

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

exord3 -datadir=$HOME/.exor3
exord4 -datadir=$HOME/.exor4
exord5 -datadir=$HOME/.exor5

View the 1st/default wallets current block:

exor-cli getblockcount

View the 2nd wallets current block:

exor-cli2 -datadir=$HOME/.exor2 getblockcount

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

exor-cli3 -datadir=$HOME/.exor3 getblockcount
exor-cli4 -datadir=$HOME/.exor4 getblockcount
exor-cli5 -datadir=$HOME/.exor5 getblockcount

Check masternode status for the 1st/default wallet:

exor-cli getmasternodestatus

Check masternode status for the 2nd wallet:

exor-cli2 -datadir=$HOME/.exor2 getmasternodestatus

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

exor-cli3 -datadir=$HOME/.exor3 getmasternodestatus
exor-cli4 -datadir=$HOME/.exor4 getmasternodestatus
exor-cli5 -datadir=$HOME/.exor5 getmasternodestatus

Shut down all running wallets:

sudo sh exor-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 exor-mn-installer.sh -S && reboot

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

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