Windows Upgrade Guide
This guide will help DIY Windows users to upgrade spd to a new version. It is written based on upgrading from 1.6.2 to 18.104.22.168 but the steps should still be relevant for future software upgrades too. Certain assumptions have been made in this guide so some steps may need tweaking to your exact setup.
The first step is to understand where you currently have spd.exe installed to. In this guide, we have spd installed in C:\Program Files\ScPrime.
The next thing we want to check while spd is still running is where is our metadata folder. This step is vital as it’s where most problems occur. To find it if you’re not sure, in File Explorer, select My PC and then search in the top right corner for ‘consensus.db’. Ideally you’ll one one copy of it, if you find multiple copies then you need to understand which is the correct one, look at the Date Modified on the consensus.db files, the one which was modified most recently should be the correct one. Below we have found just one copy in C:\Users\ScPrime\AppData\local\ScPrime (note your user folder will be different). This is the default metadata folder location for Windows which means you do not need to use the -d flag to specify the folder location, if your metadata is stored in a non-default location like C:\Metadata then you will need to use the -d flag when starting spd.
Now that we know where our metadata is located, check the output of:
spc host -v
To ensure the provider is showing ‘Host appears to be working’ as the Connectability Status. You can also see the current version is 1.6.2 below. It’s also working taking a note of the Provider ID here, this can help identify if after upgrade you’ve created a new provider or not:
Next we will stop spd using the following command:
Another important step to take at this point is to backup your metadata folder. This should be something you’re doing on a daily basis anyway but it’s good practice as part of an upgrade just in case. Where you backup to is up to you, could copy off the provider to an FTP server on your home network for example or simply by inserting a USB pen drive and dragging the C:\Users\ScPrime\AppData\local\ScPrime folder to the pen drive in File Explorer.
Once the file is downloaded, extract it to the ScPrime folder we identified above, C:\Program Files\ScPrime in our example, overwriting the files which are already there.
Now we are ready to start up spd with the new version. If you have setup the auto startup batch file as per the Windows CLI guide here, then you could simply reboot your PC and then ensure that spd is started and your wallet is unlocked automatically. Alternatively, open a command prompt and start spd manually using the same startup command you would normally use
spd [--host-addr :44282 --host-api-addr :44283] [-d C:\Metadata] -M gctwh
Optionally, specifying any non-default ports you are using and a non-default metadata folder plus of course the ‘-M gctwh’ option to not load the renter module. If you do start it manually you need to leave that command prompt window open and then open a 2nd one to run spc commands in.
Once spd is running again, we can run
spc host -vto check the host appears online (initially after first starting it will say “Host is checking status" (takes a few minutes), re-run the command after a few mins and you should see the status change to “Host appears to be working”, our Provider ID is the same as before the upgrade and that we’re now running the new version, 22.214.171.124 in the case below. Also double check that your storage folders are correctly shown at the bottom of the output.
At this point, give it 30 mins or so and then check on Grafana that your host is online.