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

From Snakeoil OS Reference
Jump to navigation Jump to search
No edit summary
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. Here's a quick way to update your Snakeoil PC to the latest firmware in the hope it'll fix things.
{{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.


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


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


== How To Sideload Your Snakeoil PC ==
==How To Sideload Your Snakeoil PC==
The steps are somewhat simple:
The steps are somewhat simple:


# Download the latest version of Snakeoil firmware from [https://www.snakeoil-os.net/existing-users-upgrade here].
#Download the latest version of Snakeoil firmware from [https://www.snakeoil-os.net/existing-users-upgrade here].
# Note the version of the firmware
#Note the version of the firmware
# Rename the downloaded file to: ''recover.fw''
#Rename the downloaded file to: ''recover.fw''
# Transfer this file to your Snakeoil PC's ''music'' directory (i.e. Music share folder)
#Transfer this file to your Snakeoil PC's ''music'' directory (i.e. Music share folder)
# Reboot the PC
#Reboot the PC
# Load the Snakeoil WebApp, confirm new version is running
#Load the Snakeoil WebApp, confirm new version is running


== Transferring recover.fw to your Snakeoil PC ==
==Transferring recover.fw to your Snakeoil PC==
There are two ways to transfer the file over, via Windows Sharing or SCP.
There are two ways to transfer the file over, via Windows Sharing or SCP.


=== Windows Share ===
===Windows Share===
This is the easiest method.  
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|424x424px|Make sure Windows Sharing is checked.]]
#Double check that "SMB Windows File Sharing" is turned on if you're using an activated edition.[[File:Snakeoil-services.png|center|thumb|424x424px|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]].
#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) ===
===Secure Copy (SCP)===
Slightly more complicated, but still easy.
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|424x424px|Make sure SSH is checked.]]
#Double check the OpenSSH Server is turned on if you're using an activated edition.[[File:Snakeoil-services.png|center|thumb|424x424px|Make sure SSH is checked.]]
# ab
#For Windows users, download a SCP client like [https://winscp.net/eng/index.php WinSCP].
# fasf
#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]]}}
{{ManualNavigation|[[advance-topics|Advanced Topics]]|[[Advance-topics/merging-technologies-ravenna-aes67-support|Merging Technologies - Ravenna/AES67 Support]]}}

Revision as of 09:12, 11 September 2019

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