View source for Turnkey Masternode

''' 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:

<ul>
<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 BMS software (this is our sanctuary video streaming network)
<li>Managing the BMS software (restarting it, upgrading it, etc)
<li>Upgrading the Masternode software after mandatory upgrades
<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) and the BLS Keys
<li>Notifying you if we need you to issue an RPC command (for example, revivesanc)
</ul>



''' 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].

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 [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)

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:
<pre>fundsanc sanctuary_name VPS_IP<enter></pre>

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:


<pre>createsanctuary sanctuary_name 1 <enter></pre>

(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 https://globalcdn.biblepay.org:8443/BMS/Status


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):
<pre>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 be 'revived'.  If you receive an error about no funds specified at address, copy the address to the clipboard and send 2BBP to that address and then try again (this is normal when the CPK is empty).

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.

Once that option is enabled you will see the Sanctuary List page on the left menu.

Your Sanctuary will be recognized 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 contact@biblepay.org for help, or make a post 
 [https://forum.biblepay.org/index.php?topic=517.0 here].



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_ (<--Add this).

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 [http://www.example.com here].  (<-- add this too).



Thank you for using BIBLEPAY!