Difference between revisions of "Install BMS"

From BiblePay Wiki
Jump to: navigation, search
Line 38: Line 38:
 
#You will see: ERROR: missing bms.conf file: This is OK
 
#You will see: ERROR: missing bms.conf file: This is OK
  
#Now we need to create a config file
+
#Now we need to create BMS config file, we do this by executing:
  
 
nano /inetpub/wwwroot/bms/bms.conf
 
nano /inetpub/wwwroot/bms/bms.conf
 +
 
bindurl=https://your.sanc.ip:8443
 
bindurl=https://your.sanc.ip:8443
#Additional items as of May 29th, 2022 to lock in the sidechain with the sanc
+
 
 +
 
 +
''' PHASE II:  Additional Items added to BMS.conf as of of May 29th, 2022 to lock in the sidechain with the sanc'''
 +
 
 +
nano /inetpub/wwwroot/bms/bms.conf
 +
 
 +
#Add these items:
 
testnetrpchost=your_testnet_sanc_ip:20001
 
testnetrpchost=your_testnet_sanc_ip:20001
 
testnetrpcuser=your_testnet_rpc_user
 
testnetrpcuser=your_testnet_rpc_user
Line 51: Line 58:
  
  
#Also, as of May 29th, 2022, we need to add settings to our testnet biblepay.conf file (you can find this at ~/biblepay/biblepaytest.conf):
+
 
 +
#Additionally, Phase II changes requires us to add more settings to our testnet biblepaycore SANCTUARY biblepay.conf file (you can find this at ~/biblepay/biblepaytest.conf):
 +
 
 
testnet=1
 
testnet=1
 
masternodeblsprivkey=your_bls_priv_key #this is already set since you set up your testnet sanc
 
masternodeblsprivkey=your_bls_priv_key #this is already set since you set up your testnet sanc
Line 65: Line 74:
 
rpcport=20001
 
rpcport=20001
  
#Now we need to add some config settings to BiblePay.conf Mainnet: You can find this at ~/.biblepay/biblepay.conf:
+
#Additionally, Phase II changes requires us to add more settings to our MAINNET biblepaycore SANCTUARY config settings to the BiblePay.conf Mainnet file: You can find this at ~/.biblepay/biblepay.conf:
 +
 
 
masternodeblsprivkey=your_mainnet_bls_priv_key #(already set)
 
masternodeblsprivkey=your_mainnet_bls_priv_key #(already set)
 
rpcuser=your_mainnet_rpc_username
 
rpcuser=your_mainnet_rpc_username
Line 76: Line 86:
 
rpcallowip=your_home_ip
 
rpcallowip=your_home_ip
 
rpcport=20000
 
rpcport=20000
#end of changes for May 29th, 2022
+
 
 +
#END OF Phase II changes for May 29th, 2022
 +
 
 +
 
  
  

Revision as of 17:56, 29 May 2022

Install BMS on Ubuntu 20.04

cd /

mkdir bms

cd bms

#Install dotnet 20.04:
wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb 

sudo dpkg -i packages-microsoft-prod.deb

sudo apt-get install -y apt-transport-https

sudo apt-get update 

sudo apt-get install -y dotnet-sdk-3.1

#optional: To see if its OK type "dotnet --info"

dotnet dev-certs https

#It may say "certificate already present", but still necessary.

#retrieve the node software

rm bms.zip  #will say no such file, thats OK

wget https://social.biblepay.org/bms/bms.zip

unzip bms.zip

#prime the node
dotnet BiblePay.BMSD.dll

#You will see: ERROR: missing bms.conf file: This is OK

#Now we need to create BMS config file, we do this by executing:

nano /inetpub/wwwroot/bms/bms.conf

bindurl=https://your.sanc.ip:8443


''' PHASE II:  Additional Items added to BMS.conf as of of May 29th, 2022 to lock in the sidechain with the sanc'''

nano /inetpub/wwwroot/bms/bms.conf

#Add these items:
testnetrpchost=your_testnet_sanc_ip:20001
testnetrpcuser=your_testnet_rpc_user
tesnetrpcpassword=your_testnet_rpc_password
rpchost=your_mainnet_sanc_ip:20000
rpcuser=your_mainnet_rpc_user
rpcpassword=your_mainnet_rpc_password



#Additionally, Phase II changes requires us to add more settings to our testnet biblepaycore SANCTUARY biblepay.conf file (you can find this at ~/biblepay/biblepaytest.conf):

testnet=1
masternodeblsprivkey=your_bls_priv_key #this is already set since you set up your testnet sanc
[test]
rpcuser=your_testnet_rpc_username
rpcpassword=your_testnet_rpc_password
server=1
listen=1
daemon=1
rpcbind=0.0.0.0
rpcallowip=127.0.0.1
rpcallowip=your_home_ip
rpcport=20001

#Additionally, Phase II changes requires us to add more settings to our MAINNET biblepaycore SANCTUARY config settings to the BiblePay.conf Mainnet file: You can find this at ~/.biblepay/biblepay.conf:

masternodeblsprivkey=your_mainnet_bls_priv_key #(already set)
rpcuser=your_mainnet_rpc_username
rpcpassword=your_mainnet_rpc_password
server=1
listen=1
daemon=1
rpcbind=0.0.0.0
rpcallowip=127.0.0.1
rpcallowip=your_home_ip
rpcport=20000

#END OF Phase II changes for May 29th, 2022










sudo ufw allow 8443/tcp
sudo ufw allow 40000/tcp
sudo ufw allow 40001/tcp
sudo ufw enable
sudo ufw allow from your_home_ip
#If you plan to run a randomx pool on ports 3001 (mainnet) and 3002 (testnet):
sudo ufw allow 3001/tcp
sudo ufw allow 3002/tcp

''' Installing Local MySQL database '''

(MySQL is used to store the internal sidechain transactions and blocks).


 sudo apt install mysql-server


 sudo systemctl start mysql.service


#now you have mysql running, and by default you are superuser but we need to secure the node

 sudo mysql_secure_installation


#Would you like to enable validate password component?

 Answer NO

#Set root password:  Set a password that you will remember, and re-enter it  (this is for you, store it somewhere in case you need to manage the node).


#Remove anonymous users?  
 YES

#Disallow root login remotely? 
 NO

#Remove test database? 
 NO

#Reload privilege tables? 
 Y


#now we need to go in and create the bms user:

 mysql

#Ubuntu responds with mysql>

 create database bms;


#responds with OK

 create user bmslocal@'%' identified by 'bms';
 GRANT ALL PRIVILEGES ON bms.* to 'bmslocal'@'%' WITH GRANT OPTION;
 FLUSH privileges;
 quit;

#this puts you back at command prompt



''' Continue with final steps of installation '''





#now start the node
dotnet BiblePay.BMSD.dll

#The node should respond with a top level menu and continue running.


To test the node, point a web browser at:

https://your_sanc_ip:8443/BMS/Status
#You will see WARNING: SSL Certificate invalid.  Just click Details, Proceed anyway (this is OK for the local machine).  In mainnet, the node will use our wildcard SSL cert.



How to Manually Upgrade BMS


#Click ctrl-c a few times to close the old copy of BMS and this gives you the command prompt again.

cd /bms
rm bms.zip
wget https://social.biblepay.org/bms/bms.zip
unzip bms.zip
#When it asks should we overwrite files, answer [A] for ALL and press enter.
#At this point the old files are overwritten.
#Now you can start the node again:
dotnet BiblePay.BMSD.dll
#The node should start