Upgrade from 2.4.1 to latest release

Moab serial number > 50 (M2-00000050) are version Moabian 2.4.1.
Follow these steps to upgrade to v3.1 (as of Dec 2021).

Prerequisite: Connect Moab to your network via ethernet or wifi

1. Login to Moab

(Option 1) ssh into Moab

ssh [email protected]
password: raspberry

(Option 2) Connect Moab to an HDMI monitor and USB keyboard.

username: pi
password: raspberry

Your 2.4.1 image looks like this when logged in:

[email protected]'s password:
Linux moab 5.4.51-v7l+ #1333 SMP Mon Aug 10 16:51:40 BST 2020 armv7l
Last login: Mon Sep 21 22:52:35 2020 from fe80::46e:8b9a:a58b:7a79%eth0

 · IP         192.168.2.239
 · Kernel     Linux 5.4.51-v7l+ armv7l
 · Load       1.00 0.46 0.17
 · CPU        52.1° C
 · URL        https://aka.ms/moab
 ○ Moabian    2.4.1

pi@moab~ $

2. Get version 3 and update

down
cd moab

cp docker-compose.yml /tmp
git reset --hard && git clean -f -d

git fetch
git checkout $(git describe --tags $(git rev-list --tags --max-count=1))
sudo os/setup # takes about 6 minutes
sudo reboot now

3. Log back in

SSH back into Moab.

diagnose # if tests fail see troubleshooting guide

If all tests pass, the upgrade is complete.

Save log files

This saves the log to log.csv and enables the debug window

cd moab/sw
p menu.py
p menu.py -vv                   

Commands

To...	Type
Level 1 Diagnostic	diagnose
Stop brains	down
Start brains	up
Restart brains	restart
Quick firmware restart	bot reset
Bot CLI commands	bot
Shutdown Moab	Hold down power button 3 sec or sudo shutdown now

Development Tips

If you plan on developing on the Moab unit, do this section first.

1. Setup an ssh keypair to share with your moab.

cd ~/.ssh
ssh-keygen -f moabkey -t ed25519
ssh-copy-id -i moabkey [email protected]

2. Set up an ssh shortcut

On your computer (Mac):

cd ~/.ssh
cat <<EOF >> config
Host moab
    Hostname moab.local
    User pi
    IdentityFile ~/.ssh/moabkey
EOF