diff --git a/docs/motion_install_from_script.md b/docs/motion_install_from_script.md index 35c17be..46e0d27 100644 --- a/docs/motion_install_from_script.md +++ b/docs/motion_install_from_script.md @@ -1,131 +1,149 @@ -**Preparation** +Motion MasterNode Install from script (Recommended) +------- -Get a VPS from a provider like DigitalOcean, Vultr, Linode, etc. -Recommended VPS size: 2GB RAM (if less its ok, we can make swap) -It must be Ubuntu 16.04 (Xenial) -Make sure you have a transaction of exactly 1000 MTN in your desktop cold wallet. -motion.conf file on LOCAL wallet MUST BE EMPTY! -masternode.conf file on VPS wallet MUST BE EMPTY! -NOTES: PRE_ENABLED status is NOT an issue, just restart local wallet and wait a few minutes. -You need a different IP for each masternode you plan to host +## Preparation -**Wallet Setup Part 1** -Open your wallet on your desktop. -Click Receive, then click Request and put your Label such as “MN1” -Copy the Address and Send EXACTLY 1000 MTN to this Address +Get a VPS from a provider like [DigitalOcean](https://www.digitalocean.com), [Vultr](https://www.vultr.com/), [Linode](https://www.linode.com/), etc. -Go to the tab at the bottom that says "Tools" -Go to the tab at the top that says "Console" +- **Recommended VPS size:** 2GB RAM (if less its ok, we can make swap partition) +- **It must be Ubuntu 16.04 (Xenial)** +- Make sure you have a transaction of **exactly 1000 MTN** in your desktop wallet (If you dont, you can auto-make that transaction from you to you). +- motion.conf file on LOCAL wallet MUST BE EMPTY! (if you haven't touched this file it's OK) +- masternode.conf file on VPS wallet MUST BE EMPTY! (if you haven't touched this file it's OK) -Wait for 15 confirmations, then run following command: -masternode outputs +**NOTES:** `PRE_ENABLED` status is NOT an issue, just restart local wallet and wait a few minutes. + +You need a different IP for each masternode you plan to host. + +## Wallet Setup Part 1 + +- Open your Motion wallet on your desktop. +- Click **Receive** tab, then click Request and put your Label such as “MN1” +- Copy the Address and Send **EXACTLY** 1000 XMN to this Address, wait for 15 confirmations. +- Go to the tab at the bottom that says `Tools` +- Go to the tab at the top that says `Console` +- Then run following command: + +`masternode outputs` You should see one line corresponding to the transaction id (tx_id) of your 1000 coins with a digit identifier (digit). Save these two strings in a text file. Example: +``` { "6a66ad6011ee363c2d97da0b55b73584fef376dc0ef43137b478aa73b4b906b0": "0" } +``` Note that if you get more than 1 line, it’s because you made multiple 1000 coins transactions, with the tx_id and digit associated. Run the following command: -masternode genkey +`masternode genkey` You should see a long key: (masternodeprivkey) -EXAMPLE: 7xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx -This is your masternode private key, record it to text file, keep it safe, do not share with anyone. This will be called “masternodeprivkey” +EXAMPLE: `7xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` -Next, you have to go to the data directory of your wallet -Go to wallet settings=> and click “Open masternode configuration file” -You should see 2 lines both with a # to comment them out. +This is your masternode private key, record it to text file, keep it safe, do not share with anyone. This will be called `masternodeprivkey` + +Next, you have to go to the data directory of your wallet: + +- Go to wallet settings tab and click `Open masternode configuration file` +- You should see 2 lines both with a # to comment them out. Please make a new line and add: -MN1 (YOUR VPS IP):7979 masternodeprivkey tx_id digit +`MN1 (YOUR VPS IP):7979 masternodeprivkey tx_id digit` + +Example: + +`MN1 148.124.58.33:7979 7xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 6a66ad6011ee363c2d97da0b55b73584fef376dc0ef43137b478aa73b4b906b0 0` + +Put your data correctly, **save it** and close. -Put your data correctly, save it and close. -Go to Motion Wallet, Click Settings, Check “Show Masternodes Tab” -Save and Restart your wallet. +Go to Motion Wallet, Click `Settings`, Check `Show Masternodes Tab`. -Note that each line of the masternode.conf file corresponds to one masternode if you want to run more than one node from the same wallet, just make a new line and repeat steps. +Save and restart your Motion wallet. + +Note that each line of the `masternode.conf` file corresponds to one masternode if you want to run more than one node from the same wallet, just make a new line and repeat steps. **VPS Setup** **Preparation:** -Windows users will need a program called putty to connect to the VPS +Windows users will need a program called [putty](https://www.putty.org/) to connect to the VPS Use SSH to Log into your VPS +**Please note:** We will run everything on root user, if you are using any other user will fail. + We need to install some dependencies. Please copy, paste and hit enter: -apt-get update;apt-get upgrade; apt-get install nano software-properties-common git wget -y; +`apt-get update;apt-get upgrade; apt-get install nano software-properties-common git wget -y;` Now Copy command into the VPS command line and hit enter: -wget https://raw.githubusercontent.com/motioncrypto/motion-docs/master/scripts/masternode.sh && chmod +x masternode.sh && ./masternode.sh +`wget https://raw.githubusercontent.com/motioncrypto/motion-docs/master/scripts/masternode.sh && chmod +x masternode.sh && ./masternode.sh` -When prompted, enter your “masternodeprivkey” from before. +When prompted, enter your `masternodeprivkey` from before. You will be asked for your VPS IP and a few other questions. -The installation should finish successfully. Ask for help in discord if it doesn't. +The installation should finish successfully. Ask for help in [discord](https://discord.gg/pTDAaMa) if it doesn't. + +## Troubleshooting and testing: -Troubleshooting and testing: After the script finishes, you will want to check that it is running properly. Please type in: -cd /root/motion/src +`cd /root/motion/src` -./motion-cli masternode status +`./motion-cli masternode status` If you get an error about permissions, you just need to kill the process and restart with: -killall motiond +`pkill -f -9 motiond` and restart with: -./motiond -daemon +`./motiond -daemon` now test with: -./motion-cli masternode status +`./motion-cli masternode status` or -./motion-cli getblockcount - -If you get an error that file does not exist, it may be that the script failed to build and we need to trace back the problem. Contact devs in discord. +`./motion-cli getblockcount` +If you get an error that file does not exist, it may be that the script failed to build and we need to trace back the problem. Contact devs in [discord](https://discord.gg/pTDAaMa). -**Starting Your Masternode** +## Starting Your Masternode Go back to your desktop wallet, to the Masternode tab. You need to wait for 15 confirmations in order to start the masternode- you can also check on your VPS by: -cd /root/motion/src +`cd /root/motion/src` -./motion-cli getblockcount +`./motion-cli getblockcount` -(needs to be more than 0 to be in sync) +(needs to be more than 0 to be in sync, at the moment of writing this guide we are at block 4883) -NOTE: If the Masternode tab isn’t showing, you need to click settings, check “Show Masternodes Tab” save, and restart the wallet -If your Masternode does not show, restart the wallet +**NOTE:** If the Masternode tab isn’t showing, you need to click settings, check `Show Masternodes Tab` save, and restart the wallet. + +If your Masternode does not show, restart the wallet. -Now Click “start-all”. Your masternode should be now up and running! +Now Click `start-all`. Your masternode should be now up and running! -**Checking Your Masternode** +## Checking Your Masternode You can check the masternode status by going to the masternode wallet and typing: -masternode status +`masternode status` -If your masternode is running it should print “Masternode successfully started”. +If your masternode is running it should print `Masternode successfully started`. -You can also check your MN status by local wallet - tools - console, just type: +You can also check your MN status by local wallet - `tools -> console`, just type: -masternode list full XXXXX +`masternode list full XXXXX` (Where XXXXX is yours first 5 character of TX_ID). -CONGRATULATIONS! - +**CONGRATULATIONS!** \ No newline at end of file