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 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 windows 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 | sudo bash
If you are logged in as root, then enter the following command:
curl -fsSL | 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 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 (unsafe)’ (this will contain your Provider’s IP address). This will bring you to the following page:
Click on Next. You’ll now be presented with the following options:
To perform a fresh install of a new provider, click on the Fresh Installation icon. This will take you to the following screen:
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 Goto 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 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.


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.

Xa-Miner Maintenance Tasks

Some typical maintenance tasks which a user needs to perform on their provider will now be slightly different with the UI. These are documented below.

Adding new storage folders

To add a new storage folder to your provider, you will first need to create a partition, format and mount the drive in Linux as you would normally and ensure the drive auto mounts on reboot in the /etc/fstab file. Also create a single folder on the drive which will be the storage folder. In Linux there is no need to create multiple folders on a single drive, except if your drive is larger than 16TB and you are using ext4 format as ext4 can only support up to 16TB file sizes. In the case of 18TB and greater drives, you will need to create 2 folders, one 16TB and one for the rest of the drive space or 2 equal sized folders.
Once you have the folder created, run the installer script again using the same curl command in the installation section of this guide, then open a browser to the installer GUI with the 4 options as below:
When the installer is run and it detects an existing installation, the Configure Existing button is active and note the Fresh Installation and Migrate from DIY are deactivated now.
After clicking on Configure Existing, you’ll be presented with the following screen showing all the existing provider’s storage folders.
Click on Add Storage Folder
Create Folder will create the new folder at the default path shown. Most likely you will want to create the folder on a newly mounted drive, click Goto Home Folder.
From here you can navigate to the mounted drive and folder you previously setup either by typing in the path in the Current Folder box or by clicking the Up arrow to get to the root folder and then choose your path from there, for example /mnt/disk7/hostdata. Note folders can also be created at this step using the Add Folder button.
Once you have your new folder selected, click Select Folder.
Then you will see your new folder added to the list of storage folders.
Click on Finish. This GUI will show it configuring your Xa-Miner and then will present you with the following screen at which point you can close the browser tab.
Now return to the main Xa-Miner UI, go to the Storage page and you’ll see the added storage folder there.
Enter the size in GB you want to set the folder size to and click Assign. Note, be careful not to over provision the folders here, the units are in GB which don’t equate to the drive sizes you see in Linux when running lsblk for example. In the above example, the /mnt/disk5/hostdata folder is on a 6TB drive, lsblk reports this as 5.5T (which is 5.5TiB), using spd from the CLI this folder was created as a 5.4TB folder but the UI reports it as 5029GB. So if disk7 was a 6TB drive, you would want to configure 5029GB in the UI as the capacity.

Removing Storage Folders

A similar process can be used in reverse to remove storage folders in a similar way to using ‘spc host folder remove <PATH>’ from the CLI. First navigate to the Storage page on the Xa-Miner UI, find the folder from the first column you wish to remove and click on the Remove button to the right.
Any data stored in the folder being removed will be moved by spd to other folders. This process may take some time depending on how much data needs moving so it’s recommended to remove just one folder at a time.
Once the folder is removed from the Xa-Miner UI, run the installer script again and choose Configure Existing:
The following screen will show all the drives which have been added to the Xa-Miner, note if you have more than 10 drives/folders then you may need to go to the next page or change the rows per page value to All to see the one(s) you want to remove.
Simply click on the red icon in the Action column against the folder you wish to remove and then click Finish. Now the drive can be safely unmounted in Linux and removed.

Changing Wallet Password

Process still tbd.