ScPrime Cloud Storage
  • About
    • Team
    • Project Specification
  • Resources
    • Software
    • KPIs
    • Incentives
    • What are SPF?
    • Storage Network Status
    • Coin Info
    • Whitepaper
    • Explorer
    • Consensus Mining (ASIC)
    • Logo and Style Guide
    • Source Code – (Open Only)
  • Documentation
    • Xa-Miner Documentation
    • DIY Provider Documentation
  • ScPrime Articles
    • Two Papa Bravo Event
    • Updating Software for the 222800 Hard Fork
    • Hard Fork Process and Information
    • ScPrime Mining Algorithm Change Proposal
    • What are SPF?
    • SPF-B New Token Format Details
    • The Distributed Storage Competition – Part 2
    • The Distributed Storage Competition – Part 1
  • Xa-Miner
    • Xa-Miner 64TB
    • Xa-Miner 16TB
  • Menu Menu

DIY Getting Started

  • Storage Provider Overview
  • Provider Requirements/Configs
  • Port Forwarding Guide
  • Collateral
  • Licensing FAQ

Storage Provider Setup

  • Windows Command-Line Interface Guide (CLI)
  • Linux Setup
  • Synology/Docker Setup
  • Windows Supervisor-Lite Installation Guide
  • Linux Supervisor-Lite Installation Guide
  • Post-Announce Guide
  • Provider Settings
  • Windows Update Guide
  • Linux Update Guide – Basic
  • Linux Update Guide – Advanced
  • Linux Full License Software Installation Guide
  • Linux Full License Software Fresh Installation Guide
  • Uptime Robot Guide for ScPrime Storage Providers

Software/Wallets

  • Windows WebWallet Guide
  • Linux WebWallet Guide
  • Mac WebWallet Guide
  • Cold Wallet Generator Setup
  • Command-Line Interface (CLI)/Wallet Setup – Windows
  • Command-Line Interface (CLI)/Wallet Setup – Linux
  • Wallet Sweep

Tutorials

  • Linux Folder Provisioning Guide
  • Linux Metadata Guide
  • Linux Multiple Provider Guide
  • Windows to Linux Migration Guide
  • Windows UI to CLI Migration Guide
  • Grafana Provider Status Messages

Information

  • Block 109,000 Fork Technical Issues
  • Storage Provider Earnings
  • ScPrime Community FAQ
  • SCP Supply
  • SCP Supply Precision Change
  • May 15th Fork FAQ
Table of Contents
  • Windows to Linux Migration Guide

Windows to Linux Migration Guide

This guide will help DIY Windows users to migrate their provider to a Linux OS installation while keeping their provider ID and used data. Performing this migration requires a reasonable degree of knowledge of both Windows and the Linux OS you choose along with how the ScPrime software works.

This guide assumes you are migrating from one Windows PC to another PC running Linux. If you are upgrading the same PC from running Windows to Linux, the main steps will be the same but you will need to copy the metadata off of the OS drive before installing Linux and then copy it back. The guide also won’t cover the Linux OS installation itself or which Linux distro to use, that is left for the user based on their personal preference.

The first step is to check the status of your Windows provider using the ‘spc host’ command.

Here we can see our Provider ID, make a note of this to ensure when you first start up the provider on Linux this is the same. The main action to take before starting the migration is to remove all bar the first folder on Windows should you have multiple storage folders as above. This will make changing the paths from Windows paths to Linux paths later on much easier as there’s no chance then to mix them up. This step isn’t mandatory but reduces the chances of errors. In the example above we will remove f:\Data using ‘spc host folder remove f:\Data’, this command can take a long time to complete, spd can sometimes stop responding and the host therefore goes offline while spd doesn’t respond to the scanners, this is expected and should be left to complete. All the data from the folder being removed is moved to the remaining folders. Repeat this until you have just 1 storage folder left like we have below.

While these folder operations are being carried out, the Linux PC can be setup, install the Linux distro of your choice and also install the ScPrime software from the Software page. Unzip the spd and spc files to a folder of your choice, for example ‘/home/<USER>/ScPrime‘ where USER is your Linux user.

Once the Windows folder operations have completed and you are down to a single storage folder, you will need to stop spd using ‘spc stop’. Now you can copy the metadata folder from the Windows PC to the Linux PC, that can be via a USB pen drive, FTP, Secure Copy Protocol (SCP!) or whatever method you are comfortable with. On Linux place the metadata in ‘/home/<USER>/.scprime‘ which is the default location in Linux when running spd with the user’s account. The default location for the metadata on Windows is ‘C:\Users\<USER>\AppData\local\ScPrime‘ as shown below:

For copying or moving over the storage folder there are 2 options. If you have external USB drives, these can simply be unplugged from the Windows PC, connected to the Linux PC and mounted (ensure that the drives are set to auto mount on system startup), the same can be done for internal drives if you wish. If you follow this process then the storage folder called ‘Data’ in our example above will still be present on the drive.

The alternative approach if you have spare drives is to install a new drive in the Linux PC and then copy the Data folder from the Windows PC to the Linux PC on the new drive. In this case you need to create a folder on the new drive in the Linux PC, this can be a different name from the Windows folder name, we are using a folder called ‘hostdata’ in this guide.

Whichever method you followed, you should now have your storage folder with 2 files, siahostdata.dat and siahostmetadata.dat on the Linux PC along with the metadata in /home/<USER>/.scprime as below:

For the rest of this guide we’ll assume the drive is mounted at ‘/mnt/disk1’, replace this path with the location you have mounted your drive for the following commands.

We now need to edit a file in the metadata folder to change the Windows folder path to the Linux path. This file will be in ‘/home/<USER>/.scprime/host/contractmanager/contractmanager.json‘. Use a text editor to open this file and change the Path value from ‘E:\Data‘ to ‘/mnt/disk1/hostdata‘ (vi or nano are typically pre-installed in most Linux distros). An example is shown below:

The line ‘”Path”: “E:\\Data”,’ should be changed to ‘”Path”: “/mnt/disk1/hostdata”,’.

Exit and save the file.

Now you are ready to start up the provider. Assuming the folder locations are as above, change directory to where spd and spc are located, /home/scprime/ScPrime for example if our user is ‘scprime’. Then run the following command to start spd:

nohup ./spd -M gctwh

This assumes you are running on default ports and have stored your metadata in the default location. If not, consult the following guide for how to start on non-default ports and the Linux Setup guide for how to specify a non-default metadata location. Then run:

./spc host

Check the Provider ID is the same as noted earlier on the Windows Provider and confirm the folder path is as you specified in the contractmanager.json file. Finally you’ll need to unlock your wallet using:

./spc wallet unlock

Use your wallet seed or password from the Windows provider.

To ensure over the next few days/weeks of running your provider on Linux, spd is able to read and write to the storage folders and there’s no permissions issues etc., run the following command and check failed reads and failed writes are zero:

‘curl -A "ScPrime-Agent" "localhost:4280/host/storage"’

An example output looks like:

xaminer-diy5:~# curl -A "ScPrime-Agent" "localhost:4280/host/storage"

{"folders":[{"capacity":3599182594048,"capacityremaining":3599182594048,"index":19494,"path":"/mnt/disk10/hostdata","failedreads":0,"failedwrites":0,"successfulreads":1,"successfulwrites":0,"ProgressNumerator":0,"ProgressDenominator":0}]}

Congratulations, you are now running your DIY Provider on Linux. From here, you can now upgrade to the Linux Full License Xa-Miner software using the following guide. Or if you plan to continue running with the Basic license, check the Linux Setup guide to setup things like the auto startup script and to learn how to change settings, add more storage folders etc.

 

What are your Feelings
Share This Article :
  • Facebook
  • Twitter
  • LinkedIn
  • Pinterest
Table of Contents
  • Windows to Linux Migration Guide

Developer

About
Logos
Contact

Resource

Software
Explorer
Docs/Guides
Whitepaper
Open Source

Legal

Privacy Policy
Licensed Provider Terms of Service

© Copyright - SCP, Corp. - Privacy Policy
Scroll to top

This site uses cookies. By continuing to browse the site, you are agreeing to our use of cookies.

OKLearn more

Cookie and Privacy Settings



How we use cookies

We may request cookies to be set on your device. We use cookies to let us know when you visit our websites, how you interact with us, to enrich your user experience, and to customize your relationship with our website.

Click on the different category headings to find out more. You can also change some of your preferences. Note that blocking some types of cookies may impact your experience on our websites and the services we are able to offer.

Essential Website Cookies

These cookies are strictly necessary to provide you with services available through our website and to use some of its features.

Because these cookies are strictly necessary to deliver the website, refusing them will have impact how our site functions. You always can block or delete cookies by changing your browser settings and force blocking all cookies on this website. But this will always prompt you to accept/refuse cookies when revisiting our site.

We fully respect if you want to refuse cookies but to avoid asking you again and again kindly allow us to store a cookie for that. You are free to opt out any time or opt in for other cookies to get a better experience. If you refuse cookies we will remove all set cookies in our domain.

We provide you with a list of stored cookies on your computer in our domain so you can check what we stored. Due to security reasons we are not able to show or modify cookies from other domains. You can check these in your browser security settings.

Google Analytics Cookies

These cookies collect information that is used either in aggregate form to help us understand how our website is being used or how effective our marketing campaigns are, or to help us customize our website and application for you in order to enhance your experience.

If you do not want that we track your visit to our site you can disable tracking in your browser here:

Other external services

We also use different external services like Google Webfonts, Google Maps, and external Video providers. Since these providers may collect personal data like your IP address we allow you to block them here. Please be aware that this might heavily reduce the functionality and appearance of our site. Changes will take effect once you reload the page.

Google Webfont Settings:

Google Map Settings:

Google reCaptcha Settings:

Vimeo and Youtube video embeds:

Other cookies

The following cookies are also needed - You can choose if you want to allow them:

Privacy Policy

You can read about our cookies and privacy settings in detail on our Privacy Policy Page.

Privacy
Accept settingsHide notification only