Updating the eVOLVER Server

Process for updating code on the eVOLVER Server (Raspberry Pi)

If you have any questions or concerns not addressed here, reach out on this forum post.

You can download the latest version of the code on our GitHub release page. If you do, skip step 3 below.

Updating the RPi GUI

1. SCP File to Pi

On Mac: scp evolver-electron-2.0.0.AppImage pi@<your_evolver_ip>:.

On Windows, use WinSCP or Filezilla to drag the file to /users/pi/home/

2. Change Permissions to AppImage

First, ssh to the Pi:

ssh pi@<your_evolver_ip>

Next, make the file executable using chmod:

chmod +x evolver-electron-2.0.0.AppImage

3. Change What AppImage the Pi uses at startup

sudo nano /etc/xdg/openbox/autostart

Scroll down and change the following line to correspond with the version you are using.

# Start Electron App in Kiosk Mode
./evolver-electron-2.0.0.AppImage

4. Reboot the eVOLVER

You can either power cycle (turn off the eVOLVER completely, wait a few seconds, then turn it back on) or you can use the following command:

sudo reboot now

Updating the eVOLVER Server Code

Mac/UNIX

Windows

Mac/Unix

1. Open up a terminal of your choice (I use iTerm2).

2. Use the cd command to navigate to the eVOLVER server software.

3. Use git to pull the latest version of the code. I have my own fork, so I need to pull the code from an upstream master branch. git pull origin master should work for most setups.

4. I like to use the scp command to transfer the files over to the eVOLVER. scp stands for secure copy - it usesssh to transfer files between computers on a network. You can also use any GUI based tool - Filezilla is a popular one. I also normally only transfer the python files, and not the entire evolver directory. The server saves calibration files and other configurations which we don't want to modify by accident. To transfer only the relevant python files, run the following command:

Replace the <eVOLVER_IP> text below with the actual eVOLVER IP.

scp evolver/evolver/*.py pi@<eVOLVER_IP>:/home/pi/evolver/evolver

5. Now that the files have been updated, the last step is to restart the server so the changes will take effect. ssh over to the evolver and run sudo supervisorctl. Then enter restart evolver, and you're done!

Windows

Follow steps 1-3 as described above.

4. Use WinSCP or Filezilla to drag the .py files into the correct locations. Be careful not to overwrite other types of files.

5. Most Windows 10 computers have a Windows 10 SSH client (such as OpenSSH Client) so you can log into the Raspberry Pi from Command Prompt in order to restart the server. Simply type ssh pi@<eVOLVER_IP> (replace <eVOLVER_IP> with your actual eVOLVER IP) and log in. From here you can run sudo supervisorctl as normal.