QRL WSL / Ubuntu Node Guide
-
- Site Admin
- Posts: 6
- Joined: Fri Jun 18, 2021 6:27 am
- Location: TX
- Contact:
QRL WSL / Ubuntu Node Guide
QRL Node Install guide for Windows Subsystem for Linux (WSL) or Ubuntu
For non-windows users, it is recommended to use this guide on Kubuntu which you can get here.
Notes:
If you do not require windows, it is recommended to install a flavor of ubuntu, such as kubuntu or lubuntu and start at step 5.
Ubuntu boot issue: If, upon trying to boot up a flash drive of ubuntu created with rufus and it says it failed to initialize graphics on boot, simply type help and hit enter, it will continue the install as normal.
WSL FAQ (Useful info, if you need it): https://docs.microsoft.com/en-us/windows/wsl/faq
Guide:
For Windows:
1. Install WSL ( https://docs.microsoft.com/en-us/window ... -of-choice )
Run powershell as administrator and run this command (you can copy and paste -- to paste it into the command line, you can right click):
3. Download Ubuntu
https://aka.ms/wslubuntu2004
This will cause the <distro>.appx package to download, copy it over to your Documents.
You should rename it to Ubuntu, so that it goes from this: Ubuntu_2004.2020.424.0_x64.appx
to this: Ubuntu.appx
4. Install and Run Ubuntu
Once the distribution has been downloaded, renamed and copied to your documents folder: navigate via powershell to the documents folder (via command: "cd c:\Users\YourUserName\Documents") containing the download and run the following command in that directory.
We're going to install the .appx file by changing it to a zip file. https://docs.microsoft.com/en-us/window ... -on-server
So run the command:
After it extracts, open the Documents\Ubuntu folder in explorer (not powershell) and right-click run the ubuntu.exe app as an admin.
4a. Create User account for Ubuntu
After it installed, I simply hit enter and then it asked me to create a User account with pass.
Fill that information and write it down just in case.
5. Using Ubuntu: (If only using Ubuntu, start here)
First, we'll want to install python 3.8 so run this command (it will ask for your password, input it)
then
then
6. Install all required dependencies:
7. Install setuptools, service-identity and launchpadlib
Now install service identity
Now install launchpadlib if you got the error about testresources not found:
8. Install QRL
Windows users: If you haven't already restarted since installing WSL and Ubuntu, do so now then continue from this point.
9. Run QRL
or
If it says command not found, you must use the command from a terminal opened from the directory of the script (or reference the path in the command).
If all went well, it should run and sync, it will create a data folder in the root > home directory of the Ubuntu install:
(For my install, my ubuntu folder is in my Documents folder -- this is the easiest to find)
Windows Users: C:\Users\Administrator\Documents\Ubuntu\rootfs\home\*YourUbuntuUserName*\.qrl
For Ubuntu, it will be here: /home/.qrl (You will need to turn on "View hidden files")
Stop it with ctrl+c and navigate your browser to this website: https://qrl.co.in/chain/#mainnet-chain
Download the mainnet chain state file here:
https://cdn.qrl.co.in/mainnet/QRL_Mainnet_State.tar.gz
After it downloads (It is almost 12gb, give it time) you'll need 7zip or similar so download it here if you don't have it already:
https://www.7-zip.org/download.html
Navigate your explorer file browser to C:\Users\Administrator\Documents\Ubuntu\rootfs\home\*YourUbuntuUserName*\.qrl\data\state
Utilize 7zip to open the .tar.gz which will reveal another .tar inside, extract that folder to the QRL directory > data folder where the other state folder is: C:\Users\Administrator\Documents\Ubuntu\rootfs\home\*YourUbuntuUserName*\.qrl\data
For Ubuntu: /home/.qrl/data
Replace any files it asks.
Your blockchain files should now be closely synced with the LIVE chain, saving you more than a weeks worth of syncing time. These chain files are provided by a QRL team member, so they should be safe. If you prefer, you can sync the entire file.
Now go here
https://docs.theqrl.org/node/configuration/
and find this link near the top
https://docs.theqrl.org/node/config.yml
right click it and save content as, save this config file into the .qrl directory:
You'll have to edit it with notepad or notepad++ ( https://github.com/notepad-plus-plus/no ... taller.exe ), so open it with either one and edit these lines, removing the # from infront of them and adding your mining wallet address:
mining_enabled: Enabled
mining_address: 'Your Wallet Address'
mining_thread_count: 0 # 0 to auto detect thread count based on CPU/GPU number of processors
If you don't have a wallet, you can generate one with the mobile app, the desktop wallet ( viewforum.php?f=37 ), or the web wallet ( viewforum.php?f=23 ).
If you have permissions issues [Errno13], run this command:
Finally, run start_qrl and it should work!
(For Ubuntu it might be this script instead: /home/.local/bin/qrl_start)
You should now have a syncing/synced, mining QRL node!
If you would like to automatically start the node after computer reboot:
Windows: create a batch file with this command and add it to the task scheduler
Ubuntu (Kubuntu): System Settings > Startup and Shutdown > Autostart > Script File > /home/yourusername/.local/bin/start_qrl.py or qrl_start.py (either or).
If you have any issues, carefully read through this tutorial again and all of the source information and then contact #support on the discord ( https://discord.com/invite/RcR9WzX )!
For non-windows users, it is recommended to use this guide on Kubuntu which you can get here.
Notes:
If you do not require windows, it is recommended to install a flavor of ubuntu, such as kubuntu or lubuntu and start at step 5.
Ubuntu boot issue: If, upon trying to boot up a flash drive of ubuntu created with rufus and it says it failed to initialize graphics on boot, simply type help and hit enter, it will continue the install as normal.
WSL FAQ (Useful info, if you need it): https://docs.microsoft.com/en-us/windows/wsl/faq
Guide:
For Windows:
1. Install WSL ( https://docs.microsoft.com/en-us/window ... -of-choice )
Run powershell as administrator and run this command (you can copy and paste -- to paste it into the command line, you can right click):
Code: Select all
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
https://aka.ms/wslubuntu2004
This will cause the <distro>.appx package to download, copy it over to your Documents.
You should rename it to Ubuntu, so that it goes from this: Ubuntu_2004.2020.424.0_x64.appx
to this: Ubuntu.appx
4. Install and Run Ubuntu
Once the distribution has been downloaded, renamed and copied to your documents folder: navigate via powershell to the documents folder (via command: "cd c:\Users\YourUserName\Documents") containing the download and run the following command in that directory.
We're going to install the .appx file by changing it to a zip file. https://docs.microsoft.com/en-us/window ... -on-server
So run the command:
Code: Select all
Rename-Item .\Ubuntu.appx .\Ubuntu.zip
Expand-Archive .\Ubuntu.zip .\Ubuntu
4a. Create User account for Ubuntu
After it installed, I simply hit enter and then it asked me to create a User account with pass.
Fill that information and write it down just in case.
5. Using Ubuntu: (If only using Ubuntu, start here)
First, we'll want to install python 3.8 so run this command (it will ask for your password, input it)
Code: Select all
sudo apt install python3.8
Code: Select all
sudo apt update
Code: Select all
sudo apt upgrade -y
Code: Select all
sudo apt-get -y install swig3.0 python3.8-dev python3-pip build-essential pkg-config libssl-dev libffi-dev libhwloc-dev libboost-dev cmake
Code: Select all
pip install -U setuptools
Code: Select all
pip3 install -U service-identity==17.0.0
Code: Select all
pip install -U launchpadlib
Code: Select all
pip install -U qrl
9. Run QRL
Code: Select all
start_qrl
Code: Select all
qrl_start
If all went well, it should run and sync, it will create a data folder in the root > home directory of the Ubuntu install:
(For my install, my ubuntu folder is in my Documents folder -- this is the easiest to find)
Windows Users: C:\Users\Administrator\Documents\Ubuntu\rootfs\home\*YourUbuntuUserName*\.qrl
For Ubuntu, it will be here: /home/.qrl (You will need to turn on "View hidden files")
Stop it with ctrl+c and navigate your browser to this website: https://qrl.co.in/chain/#mainnet-chain
Download the mainnet chain state file here:
https://cdn.qrl.co.in/mainnet/QRL_Mainnet_State.tar.gz
After it downloads (It is almost 12gb, give it time) you'll need 7zip or similar so download it here if you don't have it already:
https://www.7-zip.org/download.html
Navigate your explorer file browser to C:\Users\Administrator\Documents\Ubuntu\rootfs\home\*YourUbuntuUserName*\.qrl\data\state
Utilize 7zip to open the .tar.gz which will reveal another .tar inside, extract that folder to the QRL directory > data folder where the other state folder is: C:\Users\Administrator\Documents\Ubuntu\rootfs\home\*YourUbuntuUserName*\.qrl\data
For Ubuntu: /home/.qrl/data
Replace any files it asks.
Your blockchain files should now be closely synced with the LIVE chain, saving you more than a weeks worth of syncing time. These chain files are provided by a QRL team member, so they should be safe. If you prefer, you can sync the entire file.
Now go here
https://docs.theqrl.org/node/configuration/
and find this link near the top
https://docs.theqrl.org/node/config.yml
right click it and save content as, save this config file into the .qrl directory:
You'll have to edit it with notepad or notepad++ ( https://github.com/notepad-plus-plus/no ... taller.exe ), so open it with either one and edit these lines, removing the # from infront of them and adding your mining wallet address:
mining_enabled: Enabled
mining_address: 'Your Wallet Address'
mining_thread_count: 0 # 0 to auto detect thread count based on CPU/GPU number of processors
If you don't have a wallet, you can generate one with the mobile app, the desktop wallet ( viewforum.php?f=37 ), or the web wallet ( viewforum.php?f=23 ).
If you have permissions issues [Errno13], run this command:
Code: Select all
sudo chmod -R a+rwx \.qrl\
(For Ubuntu it might be this script instead: /home/.local/bin/qrl_start)
You should now have a syncing/synced, mining QRL node!
If you would like to automatically start the node after computer reboot:
Windows: create a batch file with this command and add it to the task scheduler
Code: Select all
start cmd /k C:\<path to ubuntu>\ubuntu2004.exe run /home/<user>/.local/bin/start_qrl
If you have any issues, carefully read through this tutorial again and all of the source information and then contact #support on the discord ( https://discord.com/invite/RcR9WzX )!