external/iiab
1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-02-12 19:22:24 +00:00
Code Issues Releases Wiki Activity
iiab/roles/usb_lib
History
A Holt fca9ce37bd
usb_lib/tasks/install.yml: FS_MOUNTOPTIONS in /etc/usbmount/usbmount.conf (is another way to get usbmount to work w/ Kolibri)
2021-03-21 12:24:34 -04:00
..
defaults Mostly var cleanup across ~80 files 2020-01-30 04:00:00 -05:00
tasks usb_lib/tasks/install.yml: FS_MOUNTOPTIONS in /etc/usbmount/usbmount.conf (is another way to get usbmount to work w/ Kolibri) 2021-03-21 12:24:34 -04:00
templates helper script to delete symlink in local_content 2020-04-07 11:52:05 -05:00
README.rst roles/usb_lib/README.rst: Further clarify 2021-03-20 11:33:07 -04:00

README.rst 

==============
usb_lib README
==============

**PLEASE SEE "Can teachers display their own content?" WITHIN http://FAQ.IIAB.IO FOR UP-TO-DATE DOCUMENTATION.**

This role implements functionality similar to LibraryBox, to mount "teacher content" from USB drives.

Users should have nearly immediate access to this "teacher content" (on all inserted USB drives) by browsing to http://box/usb

Automount is handled by usbmount, and scripts in this role look in the root of the mounted drive for...

* /usb
* /USB
* /share
* /Share
* /Piratebox/Share

...and if found, creates a symlink of the form /library/www/html/local_content/USBn pointing to /media/usbn.

USB drives must be formatted with one of the filesystems listed under "FILESYSTEMS=" at /etc/usbmount/usbmount.conf

Official `usbmount <https://github.com/hfuchs/usbmount>`_ documentation, from 2010:

* https://github.com/hfuchs/usbmount/blob/master/README
* https://github.com/hfuchs/usbmount/blob/master/usbmount.conf

As of March 2021, better Kolibri integration/support is being investigated: `#2713 <https://github.com/iiab/iiab/issues/2713>`_

Legacy: There is also a patch for problems with automount on Fedora 21+.
Please Note that as of 4.1.8-200.fc22.x86_64 not all USB drives will mount, even with this patch.