Linux Full License Software Fresh Installation Guide
This guide will help DIY Linux users to setup a brand new provider with their Full License to run the Xa-Miner software. To do this you will need to have purchased a Full License or a Full License Upgrade from a Basic or free XM Basic license from the Xa-Miner Store. The installer supports all major Linux distros including Ubuntu, CentOS and Alpine Linux. For this installation guide, Ubuntu Desktop 22.04.1 will be installed.
The first step is to install the Linux version of your choice (ensure it’s a supported version, for example as of writing this guide, Ubuntu 21 is no longer supported). If running the installation from the Linux Desktop UI, you can open a Terminal window and proceed from there. If you are running the installation from another computer, you may need to install openssh-server to be able to then SSH to the Linux provider. To do this open a Terminal window and enter ‘sudo apt install openssh-server’, answer Y to the prompt and then you will be able to SSH to the Linux PC from another computer and you can continue the installation from there. ‘Curl’ may also need to be installed if it’s not already installed with your Linux distro. To install, in the terminal window enter ‘sudo apt install curl’ and answer Y to the prompt. The final prerequisite is that you should physically install, partition, format and mount your storage drives. Please ensure that the storage drives will be automatically mounted each time Linux boots up, whichever method you use to set it up.
Note – the above commands to install openssh-server and curl are specific to Ubuntu and Debian based Linux distros, for other distros like CentOS or Alpine, different commands to install those packages will be required.
Full Software License Installer
Whichever method you have used above, from the command line, if you are logged in to your Linux Provider with a user account (not root), enter the following command (note this is all one command):
curl -fsSL https://releases.scpri.me/storage_appliance/diy/xm-installer.sh | sudo bash
If you are logged in as root, then enter the following command:
curl -fsSL https://releases.scpri.me/storage_appliance/diy/xm-installer.sh | bash
This will start the installation script, install any necessary components for your Linux install and finally present you with the following page:
The URL in the above text will be for the local IP address of your provider. Now copy (note do NOT use Ctrl-C to copy the URL as that will quit the installer and stop it running, in most terminal apps just highlighting the URL copies it into the clipboard) and paste this into a browser to continue the installation.
NOTE:- keep this terminal window open until it shows the message ‘Installer Finished’ which will happen after the UI installation is complete.
You will see the following page in your browser or something similar depending on the browser you use:
If the page fails to load, it might be due to a local firewall running on the Linux Provider blocking TCP port 8135, if this is the case you will need to open that port on the firewall to allow it through.
In this case for Chrome, click Advanced and then ‘Proceed to 192.168.254.115 (unsafe)’ (this will contain your Provider’s IP address). This will bring you to the following page:
Click on Next.
To perform a fresh install of a new provider, click on the Fresh Installation icon.
You can if you wish change the Application Config Folder but for most instances the default location is recommended. Click on Next.
On this page you can add your storage folders. Click on Add Storage Folder.
Click on Go to Home Folder and then click on the Up arrow until the Current Folder is /.
From here, navigate to where your drives are mounted, in this case it’s ‘/media/scprime’. Then click on Add Folder and give the folder a name like ‘data’. Click on Create.
You will be taken back to the list of storage folders. Should you wish to add multiple storage folders, repeat the above process for each one.
Once finished, click on Next.
The next page shows the Application Folder path chosen and the list of Storage Folders added, if all looks correct click on Finish.
The installer will now download and create the docker container running spd and supervisor on your provider. This typically takes 1-2 minutes.
Once complete, the installer will show the following page and you can click on the link to open the Xa-Miner UI to setup and register your new Xa-Miner.
Xa-Miner UI Setup
After opening up the Xa-Miner UI for the first time, you will be presented with the following screen where the blockchain is being downloaded and extracted. This can take a few mins depending on the speed of your internet connection and the specs of the PC.
Once this is completed the Please wait button will change to Next.
Click on Next to proceed to the following page.
Here you are shown your wallet recovery seed phrase. This can also be downloaded as a PDF. It is important to save this somewhere safe as you will need the seed to send SCP coins from the wallet to another wallet address. Once the seed has been saved, click on Next.
Enter your e-mail address used for the XNS Console and to purchase your Full or Basic to Full upgrade license to register your new Xa-Miner. Click on Register.
The next page allows you to change your ports from the default 4282 and 4283 if you want or need to. If this is your first provider then the default ports will in most cases work fine and you can click on Goto Dashboard. If you need to change the ports as this is not your first provider, click on Configure Ports.
Choose the Hosting and Relayer ports you wish to use. We recommend keeping them at least 10 apart, so typically using 4292/4923 or 4272/4273 for example. In the above example we’re going to use 4252 and 4253. Click on Set ports.
You will see the following page showing your ports were successfully set. Now click on Goto Dashboard to go to the main Xa-Miner Dashboard page.
Here you will see at the top of the page your provider ID. This is needed to register against your Full license in the XNS Console. Simply copy it from here, go to the console.xns.tech link, select Licenses from the left menu and paste the provider ID in against your license key. If you have not yet purchased your license, please visit the store to complete your purchase.
Congratulations, your new Xa-Miner is now fully setup. To learn more about the Xa-Miner UI and all its functions, please visit the Xa-Miner UI Walkthrough page.
Troubleshooting
Installer GUI Not Loading Fully
After running the installer script and opening the URL, if you see the following page in your browser, you likely need to change your browser’s language settings to English.