Advance-topics/sideload-snakeoil-firmware: Difference between revisions

From Snakeoil OS Reference
Jump to navigation Jump to search
No edit summary
No edit summary
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{DISPLAYTITLE:Sideload Snakeoil Firmware}}{{TopicAdvancedTopics|float:right}}Sometimes problems/bugs in system configuration, the Snakeoil WebApp or RESTful API server may cause firmware updates to fail.
{{DISPLAYTITLE:Sideload Snakeoil Firmware}}{{TopicAdvancedTopics|float:right}}Sometimes problems/bugs in system configuration, the Snakeoil WebApp or RESTful API server may cause firmware updates to fail. Here's a quick way to update your Snakeoil PC to the latest firmware in the hope it'll fix things.
{{ManualNavigation|[[advance-topics|Advanced Topics]]|[[Advance-topics/merging-technologies-ravenna-aes67-support]]}}
 
==Prerequires==
This recovery procedure will only work if you meet the following prerequisites
 
*If you are running Snakeoil Blind Testing (v1.1.0) or later
*SSH or Windows Sharing is enabled
 
==How To Sideload Your Snakeoil PC==
The steps are somewhat simple:
 
#Download the latest version of Snakeoil firmware from [https://www.snakeoil-os.net/existing-users-upgrade here].
#Note the version of the firmware
#Rename the downloaded file to: ''recover.fw''
#Transfer this file to your Snakeoil PC's ''music'' directory (i.e. Music share folder)
#Reboot the PC
#Load the Snakeoil WebApp, confirm new version is running
 
==Transferring recover.fw to your Snakeoil PC==
There are two ways to transfer the file over, via Windows Sharing or SCP.
 
===Windows Share===
This is the easiest method.
 
#Double check that "SMB Windows File Sharing" is turned on if you're using an activated edition.[[File:Snakeoil-services.png|center|thumb|806x806px|Make sure Windows Sharing is checked.]]
#From another PC, copy the recover.fw to the music share folder by following instructions outlined [[Using/adding-music-to-your-snakeoil#Music|here]].
#Reboot your Snakeoil PC
 
===Secure Copy (SCP)===
Slightly more complicated, but still easy.
 
#Double check the OpenSSH Server is turned on if you're using an activated edition.[[File:Snakeoil-services.png|center|thumb|806x806px|Make sure SSH is checked.]]
#For Windows users, download a SCP client like [https://winscp.net/eng/index.php WinSCP].
#Refer to your SCP client's document (e.g. [https://winscp.net/eng/docs/start WinSCP Documentation]) on how to connect to your Snakeoil PC
#Transfer ''recover.fw'' to /media/music
#Reboot your Snakeoil PC
{{ManualNavigation|[[advance-topics|Advanced Topics]]|[[Advance-topics/merging-technologies-ravenna-aes67-support|Merging Technologies - Ravenna/AES67 Support]]}}
[[Category:Advanced Topics]]

Latest revision as of 15:23, 9 January 2022

Sometimes problems/bugs in system configuration, the Snakeoil WebApp or RESTful API server may cause firmware updates to fail. Here's a quick way to update your Snakeoil PC to the latest firmware in the hope it'll fix things.

Prerequires

This recovery procedure will only work if you meet the following prerequisites

  • If you are running Snakeoil Blind Testing (v1.1.0) or later
  • SSH or Windows Sharing is enabled

How To Sideload Your Snakeoil PC

The steps are somewhat simple:

  1. Download the latest version of Snakeoil firmware from here.
  2. Note the version of the firmware
  3. Rename the downloaded file to: recover.fw
  4. Transfer this file to your Snakeoil PC's music directory (i.e. Music share folder)
  5. Reboot the PC
  6. Load the Snakeoil WebApp, confirm new version is running

Transferring recover.fw to your Snakeoil PC

There are two ways to transfer the file over, via Windows Sharing or SCP.

Windows Share

This is the easiest method.

  1. Double check that "SMB Windows File Sharing" is turned on if you're using an activated edition.
    Make sure Windows Sharing is checked.
  2. From another PC, copy the recover.fw to the music share folder by following instructions outlined here.
  3. Reboot your Snakeoil PC

Secure Copy (SCP)

Slightly more complicated, but still easy.

  1. Double check the OpenSSH Server is turned on if you're using an activated edition.
    Make sure SSH is checked.
  2. For Windows users, download a SCP client like WinSCP.
  3. Refer to your SCP client's document (e.g. WinSCP Documentation) on how to connect to your Snakeoil PC
  4. Transfer recover.fw to /media/music
  5. Reboot your Snakeoil PC

 Main   Advanced Topics   Merging Technologies - Ravenna/AES67 Support