Digistump Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Troubleshooting a First Update ======

If you arrived at this page then your Oak has likely tried to update from both the main update server, and the fallback slower but more reliable server, and neither has worked.

**First we want to be clear:** This update issue affects only the first update due to some issues with the firmware shipped on the first run of Oaks, after the first update all later updates will work on most networks without issue. We apologize for this issue and hope you will stick with us to get your Oak its first update which solves this issue from there forward.

====== Two Methods for Troubleshooting ======

We have found two methods for troubleshooting that we feel are worth the effort as the result in a very high rate of success. Thus far we are unaware of anyone who could not update after trying both of these methods and/or another WiFi network. Please try the method that seems most convenient (based on your knowledge of routers or computers) to you first, and then try the other method if that does not work.

Option 1: [[local_update#local_update_tool|Using the local update tool]]

Option 2: [[local_update#temporary_router_settings_changes|Making temporary changes to your router settings]]

===== Local Update Tool =====


==== What you will need: ====

  -  A Mac OSX, Windows, or Linux computer on the same network (via WiFi or Ethernet) as your WiFi network.
  -  A second WiFi capable device (computer, smartphone, tablet) with a modern web browser.
  -  The Oak Update Tool for your operating system:
    *    Linux 32-bit: https://github.com/digistump/OakUpdateTool/releases/download/1.0.0/oakupsrv-linux32.tar.gz
    *    Linux 64-bit: https://github.com/digistump/OakUpdateTool/releases/download/1.0.0/oakupsrv-linux64.tar.gz
    *    Mac OSX: https://github.com/digistump/OakUpdateTool/releases/download/1.0.0/oakupsrv-osx.tar.gz
    *    Windows: https://github.com/digistump/OakUpdateTool/releases/download/1.0.0/oakupsrv-win32.zip

  * Step 1: Download the Oak Update Tool to the computer (item #1) you'll be using.
  * Step 2: Unzip/Untar the download (Note: You MUST un-compress the download, it cannot be run from the archive or temporary folder.)
  * Step 3A - **Linux OR OSX**: Open a terminal window / command prompt and run the update tool as root with 
<code>sudo oakupsrv</code>
  * Step 3A - **Windows**: Double click the oakupsrv.exe to run, click allow to any firewall dialogs that come up.
  * Step 3B - You will now see messages similar to the image below, it may take a few moments to reach this point as it will download the newest firmware and config tool.
{{ :oak:tutorials:oakupsrv-start.jpg |}}
  * Step 4: On the second WiFi capable device connect to your network, open a browser, and go to the URL the oakupsrv program tells you to (in the example above http://192.168.0.106:8080 - but the address will be different for each computer).
  * Step 5: Follow the config wizard that appears at this address, while it looks the same as the main config wizard, it will connect your Oak to the local server running from the oakupsrv program on your computer and the Oak will attempt to download the update from that.

===== Temporary Router Settings Changes =====
Digistump Wiki

User Tools

Site Tools

Page Tools
