Adds a documentation page about upgrading asteroid with instructions on how to use opkg over usb

master
Florent Revest 2017-12-21 20:09:36 +01:00
parent 12e0c75612
commit 3fb51a2369
2 changed files with 33 additions and 0 deletions

View File

@ -11,6 +11,7 @@ layout: documentation
<li><a href="{{rel 'wiki/porting-status'}}">Porting Status</a></li>
<li><a href="{{rel 'wiki/ssh'}}">SSH</a></li>
<li><a href="{{rel 'wiki/useful-commands'}}">Useful commands</a></li>
<li><a href="{{rel 'wiki/update-asteroidos'}}">Update AsteroidOS</a></li>
<li><a href="{{rel 'wiki/bluetooth'}}">Bluetooth</a></li>
<li><a href="{{rel 'wiki/translating-asteroidos'}}">Translating AsteroidOS</a></li>
<li><a href="{{rel 'wiki/licenses'}}">Licenses</a></li>

View File

@ -0,0 +1,32 @@
---
title: Update AsteroidOS
layout: documentation
---
<p>AsteroidOS currently doesn't offer any nice OTA experience. The main limitation being the connectivity of watches. AsteroidOS watches don't have direct access to the Internet which is very limitating when it comes to upgrades. This page tries to document how to upgrade Asteroid.</p>
<div class="page-header">
<h1 id="reflash">Reflash AsteroidOS</h1>
</div>
<p>The easiest way, as of today, is just to reflash the entire OS following the usual <a href="https://asteroidos.org/install/">installation instructions</a>.</p>
<div class="page-header">
<h1 id="opkg-usb">OPKG over USB</h1>
</div>
<p>If you don't want to loose your personal data and would prefer upgrading Asteroid without reflashing it you can use asteroid's package manager: opkg. However, your watch most likely lacks Internet connectivity so you'll need to connect your watch to the Internet somehow. The following instructions describe how to share your computer's connectivity with your watch.</p>
<p>Configure a NAT <b>on your computer</b> (note: replace eth0 with the name of the interface that connects your computer to the Internet) with:</p>
<pre><code>echo 1 > /proc/sys/net/ipv4/ip_forward
iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE</code></pre>
<p>Configure a default gateway and DNS <b>on the watch</b> with the following commands ran via <a href="https://asteroidos.org/wiki/ssh/">SSH</a>:</p>
<pre><code>route add default gw 192.168.2.1
echo "nameserver 8.8.8.8" >> /etc/resolv.conf</code></pre>
<p>You can now upgrade your distribution with opkg using the standard commands:</p>
<pre><code>opkg update
opkg ugrade</code></pre>