2017-05-27 18:09:50 +00:00
==============
2020-02-01 22:25:58 +00:00
usb_lib README
2017-05-27 18:09:50 +00:00
==============
2019-02-11 02:29:24 +00:00
**PLEASE SEE "Can teachers display their own content?" WITHIN http://FAQ.IIAB.IO FOR UP-TO-DATE DOCUMENTATION.**
2018-02-11 15:41:35 +00:00
2018-02-11 17:58:15 +00:00
This role implements functionality similar to LibraryBox, to mount "teacher content" from USB drives.
2018-02-11 15:41:35 +00:00
2018-02-11 16:02:08 +00:00
Users should have nearly immediate access to this "teacher content" (on all inserted USB drives) by browsing to http://box/usb
2017-05-27 18:09:50 +00:00
2018-02-11 16:02:08 +00:00
Automount is handled by usbmount, and scripts in this role look in the root of the mounted drive for...
2017-05-27 18:09:50 +00:00
2018-02-11 15:41:35 +00:00
* /usb
* /USB
2017-05-27 18:09:50 +00:00
* /share
* /Share
2018-02-11 15:41:35 +00:00
* /Piratebox/Share
2017-05-27 18:09:50 +00:00
2018-02-11 16:06:33 +00:00
...and if found, creates a symlink of the form /library/www/html/local_content/USBn pointing to /media/usbn.
2017-05-27 18:09:50 +00:00
2021-03-21 16:45:53 +00:00
USB drives must be formatted with one of the filesystems listed under "FILESYSTEMS=" at `` /etc/usbmount/usbmount.conf `` — these are specified on/around Line 67 of: `/opt/iiab/iiab/roles/usb_lib/tasks/install.yml <https://github.com/iiab/iiab/blob/master/roles/usb_lib/tasks/install.yml#L67> `_
2018-02-12 17:29:50 +00:00
2021-03-20 15:33:07 +00:00
Official `usbmount <https://github.com/hfuchs/usbmount> `_ documentation, from 2010:
2017-05-27 18:09:50 +00:00
2021-03-20 15:07:03 +00:00
* https://github.com/hfuchs/usbmount/blob/master/README
* https://github.com/hfuchs/usbmount/blob/master/usbmount.conf
2021-03-21 16:45:53 +00:00
In March 2021, Kolibri exports were enabled, using `` umask=0000 `` (also within /etc/usbmount/usbmount.conf) to override what was `` umask=0022 `` by default: `PR #2715 <https://github.com/iiab/iiab/issues/2715> `_
2021-03-20 15:07:03 +00:00
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.
