worldpossible/rachelpios

all raspberry pi configuration files for RACHEL os

rachelpiOS

NOTE: This install is tested to work with 2016-05-27-raspbian-jessie and is known to have problems with newer versions

To install is easy:

Expand your microSD card partition sudo raspi-config sudo reboot

NOTE: for WIFI to ever work on the unit, you must have the WIFI USB dongle inserted during installation so that the install script can configure it properly.

paste in the following command after reboot.

curl -fsS https://raw.githubusercontent.com/rachelproject/rachelpiOS/master/installer.py | python

Please note that this will change the 'pi' user's password to: rachel

All default username and passwords will be rachel/rachel unless noted differently.

Additional Details

Please check out the Wiki: https://github.com/rachelproject/rachelpiOS/wiki

rachelpios's Issues

Spanish videos missing from kalite 0.15.1

As discussed here, kalite 0.15.1 doesn't have a complete spanish video collection - that is: there are missing videos when browsing topics, but you can't download those videos through the kalite interface. Even if you download them yourself and put them in the content directory, they still don't work.

This seems to be missing info in /root/.kalite/locale/dubbed_video_mappings.json

With this corrected there are still problems with caching and a sparse topic tree (lots of topics have not been translated into Spanish). We need to trim the topic tree and get caching working.

installer on latest raspian lite

Error: Unable to upgrade Raspberry Pi firmware

if I try it manually I get

root@raspberrypi:~# rpi-update
-su: rpi-update: command not found

download of sample zim file too large

during installation a sample zim file is downloaded so that kiwix can start and be verified - but we were using the portable ray charles file which clocks in at almost 200MB, which takes too long on slow connections and is error prone.

stem module stops install after connection failure

Connection went down during install, causing installation of the stem module to fail with no releases for package pecl/stem - even after the connection came back retrying would still fail until I ran: pear clear-cache -- perhaps add this to install, or perhaps download the tarball and install from that.

Move LOCAL_CONTENT to a module

This was done in two parts

1. we included the _h5ai indexing script in contentshell
2. we created a file_share module

install.py needs to reboot after system updates

After updating the system (apt-get dist-upgrade -y and rpi-update) the system needs to reboot. Otherwise the iptables commands can fail because of a kernel version mismatch.

This problem isn't always there, depending on how recent your version of the raspbian image is - but if dist-upgrade gets far enough ahead that the kernel version changes, it can cause problems.

As it is, if you get an error like Error: Unable to set iptables MASQUERADE on eth0., you can just reboot manually and restart the installer (no harm in just running it again).

Cannot access KA-Lite via http://localhost:8008/ in all situations

If you boot RACHEL 64EN 4.0 on a Pi 2 without an ethernet cable or wifi dongle attached, you will find that you cannot access KA-Lite using http://localhost:8008/. The address http://127.0.0.1:8008/ works fine. There appears to be a networking configuration issue as simply running:

sudo systemctl restart networking

fixes the problem. I have temporarily fixed the issue in my own images by adding the above command (without sudo) to /etc/rc.local. However, this is a hack and does not address the underlying cause so I do not recommend it for an official distribution. Unfortunately, I do not understand the root cause of the problem yet, so I do not have a proper fix.

Note, the problem goes away if your Pi connects to a network at any time since it was powered up. I have not tested the Pi 3, but it may behave differently due the presence of the builtin Wi-Fi support.

dhcp not working on startup

The udhcp server does not keep running after startup:

pi@rachel:~ $ service udhcpd status
  ● udhcpd.service - LSB: Start busybox udhcpd at boot time
    Loaded: loaded (/etc/init.d/udhcpd)
    Active: active (exited) since Wed 2016-03-09 19:30:03 UTC; 21h ago
    Process: 365 ExecStart=/etc/init.d/udhcpd start (code=exited, status=0/SUCCESS)

It should be "active (running)". The result is that clients connecting to the wifi hang forever waiting for an IP address. You can fix it with the following:

pi@rachel:~ $ sudo service udhcpd stop
pi@rachel:~ $ sudo service udhcpd start

Which will get it running again, but the same problem will appear on reboot.

Create an empty RACHEL-Pi image

When we make the next RACHEL-Pi build, we should create an empty one (no content) in addition to the English, Spanish, French versions. This will allow people to download a much smaller file when building their own custom version.

Default user names and passwords

Are these listed anywhere? Trying to log in to KA-Lite and having trouble discovering the default here

re-runnable install script

The install script should have logic so that if it fails (which it does during connectivity disruptions) that re-running it will safely pick up where it left off.

more dependencies for _h5ai

The h5ai thumbnail previews require a few extra packages:

• apt-get install php5-gd - for image thumbs
• apt-get install imagemagick - for pdf thumbs
• apt-get install libav-tools - for movie thumbs
• apt-get install zip - for... zip thumbs?
• chmod 777 /var/www/_h5ai/cache

Admin login page not working on CHIP

I cloned the repo https://[email protected]/promiseowolabi/rachelchip.git and made slight adjustments to install on CHIP. The Admin login page user root/rachel won't login. Please what username/password should we use.

Installer

@mattneel

from a straight install of raspbian jessie, not much happens when running:

curl https://github.com/mattneel/rachelpios/tree/master/rachel.py | python

Can we shift items from the /mattneed/ subdomain to rachelproject?

Thank you!

Add Kiwix to Default Installation Script

install_kiwix():
die("KiwiX installation is not yet supported by this installation script.")

Web based safe shutdown

https://www.element14.com/community/community/raspberry-pi/raspberrypi_projects/blog/2014/04/02/pi-webpage-reboot

IP table persistence

From @promiseowolabi of the rachel-chip project

I also noticed that the "iptables" are not persistent after rebooting. Made some changes to the /etc/rc.local command.
sudo("sh -c 'echo ifconfig wlan1 10.10.10.10 >> /etc/rc.local; echo service udhcpd restart >> /etc/rc.local; echo "iptables-restore < /etc/iptables.ipv4.nat" >> /etc/rc.local'") or die("Unable to setup udhcpd reset at boot.")

Look into this whether this is a RPi issue as well

Script Failure on Attempt 1

The above image is the last messages I received while running the script on a clean Jessie install. Upon reboot, RACHEL was not yet installed. Further diagnostics coming

Need to include a few more modules in the base install - see comments

Script Error: Unable to upgrade Raspbian

Started with a clean Jessie install. Ran raspi-config and received the following error on two different tries.

revert ka-lite to last known good version

documented on our rachelplus page - the version we're shipping out right now has strange errors.

I don't know how to reference an issue, but if you're reading this, you know where to look! worldpossible/rachelplus#56

KA-Lite not booting at start

somewhere in the setup process, KA-lite should offer an option to boot at start. May be a KA-Lite issue.

rachelpi_64EN_3.4_RDP - Preship

 sudo rsync -avzy [email protected]://home/jeremy/PICO/* /home/pi/.

 sudo python picofu.py -v -f UPS_PIco_V1.0_04_09_2015_code_0x38.hex
 #sudo i2cset -y 1 0x6b 0x00 0xff && sudo python /home/pi/picofu.py -f UPS_PIco_V1.0_04_09_2015_code_0x38.hex
 sudo i2cset -y 1 0x6B 9 0xff
 sudo chmod 0777 /var/www/local

  sudo sed -i  '/^sudo/ s/$/ \&/' /etc/rc.local
   sudo hwclock -r
 sudo hwclock -w

sudo cd /var
wget https://github.com/weaved/installer/raw/master/binaries/weaved-nixinstaller_1.2.13.bin
chmod +x weaved-nixinstaller_1.2.13.bin
./weaved-nixinstaller_1.2.13.bin 
1
[email protected]

Script to Install WiFi Dongle

The WiFi dongle should install regardless of WiFi present at time of running script.

File Share does not seem to work out of the box

I installed the Raspberry Pi image rachel-pi-10_01_2022.zip. I tried the File Share function.

Tried uploading a file.

But the file is not actually uploaded.

Install kolibri-server which should give better performance

According to Kolibri docs using kolibri-server should give better performance on Raspberry.

https://kolibri.readthedocs.io/en/latest/install/ubuntu-debian.html#higher-performance-with-the-kolibri-server-package

rachelpiOS versioning of script

We're going to add to content shell a versioning page that lists all meaningful versions for Raspbian, the install process, and all content sets. One piece of this, the install process, will require us to date stamp somewhere the script as edits are made. @spatiald does this for rachelplusOS fairly effectively (ie, current version is v.20160210.0552)

Unable to access "Soluciones Prácticas" module Rachel ES 3.0

Everytime you hit "Soluciones Prácticas" module, it gets you to this link with a Not Found screen:

http://192.168.1.210/modules/soluciones_es/soluciones/index.html

So instead you need to change part of "index.htmlf" at "/var/www/modules/soluciones_es" the same as this:

<a href="<?php echo $dir ?>/index.html">   #CHANGE URL FROM /soluciones/index.html TO /index.html
<img src="<?php echo $dir ?>/logo.png" alt="">
</a>

<!-- Title and link to your module's index.html - same as above. -->
<h2><a href="<?php echo $dir ?>/index.html">Soluciones Pr&aacute;cticas</a></h2>  #SAME AS ABOVE

Access the admin page

how do you get to the admin page when installing the rachel os on the pi with the https://github.com/rachelproject/rachelpiOS instructions. It is installled, I can access the pi with the ssh as expected, i can see the main web page, but i cannot see any admin page.

Security issues

rsegal identified some security issues in recent additions to installer.py - suggested fixes in the comments for these commits:

424bc62

8b0fa66

kalite does not have caching enabled

The current kalite startup is missing the settings argument that enables caching - very important for the rpi as it reduces startup time from ~10 minutes to ~30 seconds. The correct startup for kalite is:

kalite start --settings=kalite.project.settings.raspberry_pi

We should make this the default settings file (not sure how, but I saw mention of it in the code somewhere). That would be better, because then even people manually starting/restarting wouldn't have to worry about this setting. (If they skip it, the cache gets blown away and we're back to a 10 minute startup)

The raspi settings file is in:

/usr/local/lib/python2.7/dist-packages/kalite/project/settings/raspberry_pi.py

Layout not mobile friendly

I am using RACHEL on smaller devices to quickly access stuff. I discovered that the layout is not mobile friendly.