Difference between revisions of "Turnkey Masternode"

From BiblePay Wiki
Jump to: navigation, search
(Created page with "''' Creating a BIBLEPAY Turnkey Masternode ''' The following instructions show how easy it is to create a fully managed Turnkey Masternode on the BiblePay network. Note that...")
 
 
(16 intermediate revisions by the same user not shown)
Line 3: Line 3:
  
 
The following instructions show how easy it is to create a fully managed Turnkey Masternode on the BiblePay network.
 
The following instructions show how easy it is to create a fully managed Turnkey Masternode on the BiblePay network.
Note that our Masternodes are called Sanctuaries, so do not let that confuse you.   
+
Note that our Masternodes are also nicknamed "Sanctuaries", so do not let that confuse you.   
  
 
We will manage the following items for you:
 
We will manage the following items for you:
  
 
<ul>
 
<ul>
<li>Monitoring the Sanc; if it is down, we will restart it and keep its POSE level at zero (that means UP) so you get paid
+
<li>Monitoring the Masternode; if it is down, we will restart it and keep its POSE level at zero (that means UP) so you get paid
 
<li>Installing the Masternode software (this is the software that runs on the server side of the network)
 
<li>Installing the Masternode software (this is the software that runs on the server side of the network)
<li>Installing the BMS software (our sanctuary streaming network); this software streams videos to our users
+
<li>Installing the BMS software (this is our sanctuary video streaming network)
<li>Managing BMS
+
<li>Managing the BMS software (restarting it, upgrading it, etc)
<li>Upgrading the software after mandatory upgrades
+
<li>Upgrading the Masternode software after mandatory upgrades
<li>Restarting the VPS if it goes down because of a VPS error or Host error
+
<li>Restarting the VPS if it goes down because of Hosting Provider error(s)
<li>Configuring the configuration files on the server (bms.conf, biblepay.conf, etc)
+
<li>Configuring the configuration files on the server (bms.conf, biblepay.conf, etc) and the BLS Keys
 +
<li>Notifying you if we need you to issue an RPC command (for example, revivesanc)
 
</ul>
 
</ul>
  
  
  
''' How do I launch a Turnkey Masternode? '''
+
''' How do I launch a New Turnkey Masternode? '''
 +
 
 +
 
 +
NOTE: Launching a brand new turnkey masternode requires 4.5MM unallocated BBP.
 +
 
  
 
1.  Download the BiblePay Core Home wallet from [http://biblepay.org/Wallet Here].
 
1.  Download the BiblePay Core Home wallet from [http://biblepay.org/Wallet Here].
  
NOTE:  The purpose of this is for you to have a safe place to store your collateral, and receive payments.  This is NOT software that will run on the server side; instead this home node is called your Controller Wallet.
+
NOTE:  The purpose of this step is to give you a safe place to store your collateral, and receive payments.  This software will not run on the server side; instead this home node is called your Controller Wallet.
  
 
Install the program.
 
Install the program.
  
 +
NOTE 2:  If you want more than one turnkey masternode, you only need ONE instance of BiblePay Core Wallet at home (controller wallet).  You do not, and should never install more than one copy of the home wallet.  So, if you own 5 sanctuaries, you will have 5 cloud VPS instances, and ONE home controller wallet.  The home wallet will have 4.5MM*5=22MM BBP in collateral in it in this case, and it will receive rewards from 5 sanctuaries.
 +
 +
 +
 +
2.  Fund your home controller wallet with at least 4.5MM BBP.  You can buy BBP on [https://main.southxchange.com/Market/Book/BBP/BTC SouthXChange].  Then transfer it to the Receiving address IN the controller wallet.  You can access this by navigating to File | Receiving Addresses | Copy one to clipboard.  From SouthXChange, go to Withdraw Funds | BiblePay.  Paste your receive address in as the withdrawal address.  Send the funds from SouthXChange to your controller wallet.  (Once you click the confirmation e-mail the funds should arrive within 7 minutes in your home controller wallet).
 +
 +
 +
3.  Next, we need to rent a Cloud Server to host the BiblePay Sanctuary on.  (You may choose your own VPS hosting company if you wish, but, you must choose a VPS with at least 4 cores, 8 GB of ram, and a MINIMUM OF 400GB hard drive, otherwise your node will not be paid).
 +
 +
If you decide to go with Contabo, our recommended host, you can sign up [https://contabo.com/en/ here]. 
 +
 +
Once signed up, navigate to [https://contabo.com/en/vps/vps-m-ssd/?image=ubuntu.267&qty=1&contract=1&storage-type=vps-m-400-gb-ssd 400gb-SSD-VPS].
 +
 +
This VPS is a 6 core, 16gb, 400Gb hard drive VPS for $11.99 per month.  Be sure to choose the following options:
 +
 +
Choose a Region (Your preference)
  
2.  Fund your home controller wallet with at least 4.5MM BBP.  You can buy BBP on [https://main.southxchange.com/Market/Book/BBP/BTC SouthXChange].
+
Choose a Minimum of 400GB hard drive
  
 +
Choose Ubuntu 20.04 for the OS
  
3.  Launch the controller wallet on your home PC.  Ensure BBP is syncedDo not proceed further unless you have a balance greater than 4.5MM bbp. 
+
Choose a PASSWORD for your root account.   
(It costs 4,500,001 to create a turnkey sanctuary).
 
  
 +
NOTE: You will need to give us this password using our web portal, so choose one that will be semi-permanent and strong.
  
4. From the controller wallet, navigate to Tools | Info | Console. From the console, type:
+
Leave the defaults selected for bandwidth and IPV4.
<pre>fundsanctuary sanctuary_name <enter></pre>
 
  
This command will spend 4,500,001 BBP from your wallet TO your own wallet (IE you will not lose the funds, as they are going into Escrow). 
 
  
If successful, this command will output a long transaction ID(BiblePay will record this on your hard drive for easy installation in the next step).
+
Leave the defaults selected for Add-Ons.
 +
 
 +
 
 +
 
 +
(Optional:  You may pay contabo month-to-month or for multiple months at a time if you wish, it is your preference).
 +
 
 +
Click Next.
 +
 
 +
Purchase the VPS, and you will receive notice in e-mail that it SETUP is completedDo not proceed to step 4 until your VPS is working.
  
Wait for 3 blocks to pass (approx 30 minutes).
+
!ALERT!:  Once your VPS is provisioned, you must find the IPV4 address of the VPS.  For contabo, you can find this by logging in to your account, click on "VPS Control" and look for the Server IP address in the first column (for example 144.1.1.1).  Do not copy the VNC IP address.
  
 +
Make a note of the Sanctuary Name and Sanctuary IP in your notepad records, you will need it in the following steps.
  
5.  From the controller wallet, still from the console, type:
 
  
  
<pre>createsanctuary sanctuary_name <enter></pre>
 
  
At this point, biblepay core will create a new sanctuary transaction.
+
4.  Launch the controller wallet on your home PC.  Ensure BBP is synced.  Do not proceed further unless you have a balance greater than 4.5MM bbp. 
 +
(It costs 4,500,001 to create a new turnkey sanctuary).
  
This command will emit many lines of code.  It is highly recommended that you copy this to notepad and save it for future use.
 
  
BiblePay will also write this info to your 'deterministic.conf' file automatically.
 
  
Copy the output of this command to the clipboard; you will need it in step 7.
+
5. From the controller wallet, navigate to Tools | Info | Console.  From the console, type:
 +
<pre>exec fundsanc sanctuary_name VPS_IP<enter></pre>
  
6.  Next, we need to rent a Cloud Server to host BiblePay on(You may choose your own VPS hosting company if you wish, but, you must choose a VPS with at least 4 cores, 8 GB of ram, and a MINIMUM OF 400GB hard drive, otherwise your node will not be paid).
+
You will need to choose a sanctuary name for your sanc, such as joe1 or sanc1.  Keep it all one word without spaces.   
 +
Now replace the "sanctuary_name" in the command above with your chosen sanctuary name.
 +
Replace VPS_IP with the IP address of your new Cloud VPS.  (You found this IP in step 3).
  
If you decide to go with Contabo, you can sign up [https://contabo.com/en/ here]. 
 
  
Once signed up, navigate to [https://contabo.com/en/vps/vps-m-ssd/?image=ubuntu.267&qty=1&contract=1&storage-type=vps-m-400-gb-ssd 400gb-SSD-VPS].
+
This command will spend 4,500,001 BBP from your controller wallet TO your own controller wallet (IE you will not lose the funds, as they are going into Escrow).
  
This VPS is a 6 core, 16gb, 400Gb hard drive VPS for $11.99 per month. Be sure to choose the following options:
+
If successful, this command will output a long transaction ID.  (BiblePay will record this on your hard drive for easy installation in the next step).
  
Choose a Region (Your preference)
+
Wait for 3 blocks to pass (approx 30 minutes).
  
Choose a Minimum of 400GB hard drive
 
  
Choose Ubuntu 20.04 for the OS
 
  
Choose a PASSWORD for your root account.   
+
6From the controller wallet, still from the console, type:
  
NOTE: You will need to give us this password using our web portal, so choose one that will be semi-permanent and strong.
 
  
Leave the defaults selected for bandwidth and IPV4.
+
<pre>exec createsanctuary sanctuary_name 1 <enter></pre>
  
Leave the defaults selected for Add-Ons.
+
(Again, replace the sanctuary_name with the name you chose in step 4 for your sanctuary).
 +
(Be sure to include the 1 above.  1 means do it, 0 means test for errors but do not do it).
  
 +
At this point, biblepay core will create a new sanctuary transaction.
  
Click Next.
+
This command will emit many lines of code.  It is highly recommended that you copy this output to notepad and save it for future use.  Save it as sanctuary_name.txt for example.
  
Purchase the VPS, and you will receive notice in e-mail that it SETUP is completed.  Do not proceed to step 7 until your VPS is working.
+
BiblePay will also record this info automatically into your 'deterministic.conf' file (but it is harder for humans to read that file).
  
 +
Copy the output of this command to the clipboard; because you will need it in step 7.
  
(Optional:  You may pay contabo month-to-month or for multiple months at a time if you wish, it is your preference).
 
  
  
Line 92: Line 119:
 
7.  Set Up the Masternode as a Turnkey Masternode with BIBLEPAY Sanctuary Network:
 
7.  Set Up the Masternode as a Turnkey Masternode with BIBLEPAY Sanctuary Network:
  
Navigate to https://globalcdn.biblepay.org:8443/BMS/Status
+
 
 +
 
 +
Navigate to [https://globalcdn.biblepay.org:8443/bbp/proposallist Provisioning a Sanctuary].
 +
 
 +
 
  
 
From this page, you will be able to register your provisioning request.
 
From this page, you will be able to register your provisioning request.
  
  
Be sure you are logged in (the top right Log In status should say Logged In); if not, first ensure metamask is installed on your browser as an extension, and your BBP profile page is created and you have a nickname and E-Mail address set up (we need to e-mail you when POSE changes occur).
+
 
 +
Be sure you are logged in (the top right Log In status should say Logged In);  
 +
if not, first ensure metamask is installed on your browser as an extension, and your BBP profile page is created and you have a nickname and E-Mail address set up (we need to e-mail you when POSE changes occur).
 +
 
  
 
Paste the information you received from your biblepaycore wallet in Step 5 into the "Please enter your Sanctuary Configuration information from BiblePay Core:" text input area.
 
Paste the information you received from your biblepaycore wallet in Step 5 into the "Please enter your Sanctuary Configuration information from BiblePay Core:" text input area.
  
Populate the Host IP with your VPS IP Address. WARNING!  Be sure to paste your VPS IP address and NOT your VPS VNC address (they are different).
 
  
Populate the Root Password field with the Root Password you chose in step 6 while purchasing your VPS.
+
Populate the Host IP with your VPS IP Address (found in step 3).
 +
 
 +
Populate the Root Password field with the Root Password you chose in step 3 while purchasing your VPS.
 +
 
  
 
Save the record.
 
Save the record.
 +
 +
 +
8.  Now it's time to start the sanctuary.
 +
 +
Issue the following command from the biblepay core wallet (again from the RPC console as you did in step 6):
 +
 +
<pre>exec startsanc sanc_name</pre>
 +
 +
Replace sanc_name with the name of the sanc you created in step 6.
 +
 +
If all goes well, the response will say 'revived'.  (If you receive an error about no funds specified at address, copy the address that is on the screen in the error to the clipboard -- and send 2BBP to that address and then try this command again).
 +
 +
 +
You can confirm that your sanctuary is started by viewing the Sanctuary Page.  To enable that page, from the biblepaycore controller wallet, click Settings | Options | Wallet | Show Masternodes Tab | OK.
 +
 +
Then navigate to the left menu | Sanctuaries page.
 +
 +
 +
You will recognize your Sanctuary by its IP address.  The goal is to ensure the Sanctuary has a status of "ENABLED" in the 2nd column. 
 +
 +
If not, please e-mail us at [email protected] for help, or make a post in our [https://forum.biblepay.org/index.php?topic=517.0 Forum].
 +
 +
 +
 +
9.  Congratulations!  You have create a turnkey sanctuary.  Next, one of our teammembers will pick up the ball and finish the installation process from the server side.
 +
 +
You will usually hear from us within 24 hours via e-mail.  We will then bring your sanctuary UP and you will see the status change to "ENABLED" in the BiblePay Controller wallet, in the Sanctuaries Page.
 +
 +
 +
Once your sanctuary is ENABLED, you will start receiving DAILY mining rewards!  Our ROI figures can be found [https://globalcdn.biblepay.org:8443/bbp/proposallist here].
 +
 +
As a Registered Sanctuary, you also have voting rights to vote on our monthly Governance Issues in our DAO (Decentralized Autonomous Organization). 
 +
 +
You can find Proposals [https://globalcdn.biblepay.org:8443/bbp/proposallist here].
 +
 +
 +
 +
 +
 +
Thank you for using BIBLEPAY!

Latest revision as of 18:34, 25 May 2022

Creating a BIBLEPAY Turnkey Masternode


The following instructions show how easy it is to create a fully managed Turnkey Masternode on the BiblePay network. Note that our Masternodes are also nicknamed "Sanctuaries", so do not let that confuse you.

We will manage the following items for you:

  • Monitoring the Masternode; if it is down, we will restart it and keep its POSE level at zero (that means UP) so you get paid
  • Installing the Masternode software (this is the software that runs on the server side of the network)
  • Installing the BMS software (this is our sanctuary video streaming network)
  • Managing the BMS software (restarting it, upgrading it, etc)
  • Upgrading the Masternode software after mandatory upgrades
  • Restarting the VPS if it goes down because of Hosting Provider error(s)
  • Configuring the configuration files on the server (bms.conf, biblepay.conf, etc) and the BLS Keys
  • Notifying you if we need you to issue an RPC command (for example, revivesanc)


How do I launch a New Turnkey Masternode?


NOTE: Launching a brand new turnkey masternode requires 4.5MM unallocated BBP.


1. Download the BiblePay Core Home wallet from Here.

NOTE: The purpose of this step is to give you a safe place to store your collateral, and receive payments. This software will not run on the server side; instead this home node is called your Controller Wallet.

Install the program.

NOTE 2: If you want more than one turnkey masternode, you only need ONE instance of BiblePay Core Wallet at home (controller wallet). You do not, and should never install more than one copy of the home wallet. So, if you own 5 sanctuaries, you will have 5 cloud VPS instances, and ONE home controller wallet. The home wallet will have 4.5MM*5=22MM BBP in collateral in it in this case, and it will receive rewards from 5 sanctuaries.


2. Fund your home controller wallet with at least 4.5MM BBP. You can buy BBP on SouthXChange. Then transfer it to the Receiving address IN the controller wallet. You can access this by navigating to File | Receiving Addresses | Copy one to clipboard. From SouthXChange, go to Withdraw Funds | BiblePay. Paste your receive address in as the withdrawal address. Send the funds from SouthXChange to your controller wallet. (Once you click the confirmation e-mail the funds should arrive within 7 minutes in your home controller wallet).


3. Next, we need to rent a Cloud Server to host the BiblePay Sanctuary on. (You may choose your own VPS hosting company if you wish, but, you must choose a VPS with at least 4 cores, 8 GB of ram, and a MINIMUM OF 400GB hard drive, otherwise your node will not be paid).

If you decide to go with Contabo, our recommended host, you can sign up here.

Once signed up, navigate to 400gb-SSD-VPS.

This VPS is a 6 core, 16gb, 400Gb hard drive VPS for $11.99 per month. Be sure to choose the following options:

Choose a Region (Your preference)

Choose a Minimum of 400GB hard drive

Choose Ubuntu 20.04 for the OS

Choose a PASSWORD for your root account.

NOTE: You will need to give us this password using our web portal, so choose one that will be semi-permanent and strong.

Leave the defaults selected for bandwidth and IPV4.


Leave the defaults selected for Add-Ons.


(Optional: You may pay contabo month-to-month or for multiple months at a time if you wish, it is your preference).

Click Next.

Purchase the VPS, and you will receive notice in e-mail that it SETUP is completed. Do not proceed to step 4 until your VPS is working.

!ALERT!: Once your VPS is provisioned, you must find the IPV4 address of the VPS. For contabo, you can find this by logging in to your account, click on "VPS Control" and look for the Server IP address in the first column (for example 144.1.1.1). Do not copy the VNC IP address.

Make a note of the Sanctuary Name and Sanctuary IP in your notepad records, you will need it in the following steps.



4. Launch the controller wallet on your home PC. Ensure BBP is synced. Do not proceed further unless you have a balance greater than 4.5MM bbp. (It costs 4,500,001 to create a new turnkey sanctuary).


5. From the controller wallet, navigate to Tools | Info | Console. From the console, type:

exec fundsanc sanctuary_name VPS_IP<enter>

You will need to choose a sanctuary name for your sanc, such as joe1 or sanc1. Keep it all one word without spaces. Now replace the "sanctuary_name" in the command above with your chosen sanctuary name. Replace VPS_IP with the IP address of your new Cloud VPS. (You found this IP in step 3).


This command will spend 4,500,001 BBP from your controller wallet TO your own controller wallet (IE you will not lose the funds, as they are going into Escrow).

If successful, this command will output a long transaction ID. (BiblePay will record this on your hard drive for easy installation in the next step).

Wait for 3 blocks to pass (approx 30 minutes).


6. From the controller wallet, still from the console, type:


exec createsanctuary sanctuary_name 1 <enter>

(Again, replace the sanctuary_name with the name you chose in step 4 for your sanctuary). (Be sure to include the 1 above. 1 means do it, 0 means test for errors but do not do it).

At this point, biblepay core will create a new sanctuary transaction.

This command will emit many lines of code. It is highly recommended that you copy this output to notepad and save it for future use. Save it as sanctuary_name.txt for example.

BiblePay will also record this info automatically into your 'deterministic.conf' file (but it is harder for humans to read that file).

Copy the output of this command to the clipboard; because you will need it in step 7.



7. Set Up the Masternode as a Turnkey Masternode with BIBLEPAY Sanctuary Network:


Navigate to Provisioning a Sanctuary.


From this page, you will be able to register your provisioning request.


Be sure you are logged in (the top right Log In status should say Logged In); if not, first ensure metamask is installed on your browser as an extension, and your BBP profile page is created and you have a nickname and E-Mail address set up (we need to e-mail you when POSE changes occur).


Paste the information you received from your biblepaycore wallet in Step 5 into the "Please enter your Sanctuary Configuration information from BiblePay Core:" text input area.


Populate the Host IP with your VPS IP Address (found in step 3).

Populate the Root Password field with the Root Password you chose in step 3 while purchasing your VPS.


Save the record.


8. Now it's time to start the sanctuary.

Issue the following command from the biblepay core wallet (again from the RPC console as you did in step 6):

exec startsanc sanc_name

Replace sanc_name with the name of the sanc you created in step 6.

If all goes well, the response will say 'revived'. (If you receive an error about no funds specified at address, copy the address that is on the screen in the error to the clipboard -- and send 2BBP to that address and then try this command again).


You can confirm that your sanctuary is started by viewing the Sanctuary Page. To enable that page, from the biblepaycore controller wallet, click Settings | Options | Wallet | Show Masternodes Tab | OK.

Then navigate to the left menu | Sanctuaries page.


You will recognize your Sanctuary by its IP address. The goal is to ensure the Sanctuary has a status of "ENABLED" in the 2nd column.

If not, please e-mail us at [email protected] for help, or make a post in our Forum.


9. Congratulations! You have create a turnkey sanctuary. Next, one of our teammembers will pick up the ball and finish the installation process from the server side.

You will usually hear from us within 24 hours via e-mail. We will then bring your sanctuary UP and you will see the status change to "ENABLED" in the BiblePay Controller wallet, in the Sanctuaries Page.


Once your sanctuary is ENABLED, you will start receiving DAILY mining rewards! Our ROI figures can be found here.

As a Registered Sanctuary, you also have voting rights to vote on our monthly Governance Issues in our DAO (Decentralized Autonomous Organization).

You can find Proposals here.



Thank you for using BIBLEPAY!