external/iiab
1
0
Fork 0
mirror of https://github.com/iiab/iiab.git synced 2025-03-09 15:40:17 +00:00
Code Issues Releases Wiki Activity

Update README.rst

Browse source
This commit is contained in:
A Holt 2018-08-30 20:44:32 -04:00 • committed by GitHub
parent 58a08e428a
commit 4170bee005
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 17 additions and 19 deletions
Download patch file Download diff file Expand all files Collapse all files

36
roles/kalite/README.rst
View file

@ -2,48 +2,46 @@
KA Lite README KA Lite README
============== ==============
This role installs KA Lite, an offline version of the Khan Academy (https://www.khanacademy.org/), This role installs KA Lite, an offline version of the Khan Academy (https://www.khanacademy.org), written by Learning Equality
written by Learning Equality (https://learningequality.org/ka-lite/). (https://learningequality.org/ka-lite/).
KA Lite has two servers, a light httpd server that serves Khan Academy videos, and a cron server KA Lite has two servers, a light httpd server that serves Khan Academy videos, and a cron server that sets up cron jobs to download language packs and KA videos from the internet. There are separate flags to enable these two servers.
that sets up cron jobs to download language packs and KA videos from the internet. There are
separate flags to enable these two servers.
Access Access
------ ------
If enabled and with the default settings KA Lite should be accessible at http://schoolserver:8008/ If enabled and with the default settings KA Lite should be accessible at http://box:8008 or http://box.lan:8008
To login to kalite enter To log in to KA Lite::
User Name: Admin Username: Admin
Password: changme Password: changme
Bulk Loading Videos Bulk Loading Videos
------------------- -------------------
Videos and their corresponding png images can be copied into /library/ka-lite/content and will Videos and their corresponding png images can be copied into /library/ka-lite/content and will be recognized the next time kalite is started. Please see http://FAQ.IIAB.IO ("KA Lite Administration: What tips & tricks exist?") to use BitTorrent to download compressed KA Lite videos, that are much smaller than the ones downloaded with KA Lite's administrative interface.
be recognized the next time kalite is started. The kalite website has instructions on getting
videos with bitsync. These videos are also smaller than the ones downloaded with the kalite As of August 2018, please also consider the `"Transmission" BitTorrent tool <https://github.com/iiab/iiab/tree/master/roles/transmission#transmission-readme>`_ that will automatically download thousands of KA Lite videos for you, if install and enable it and set the language(s) you want within /etc/iiab/local_vars.yml
admin interface.
Configuration Parameters Configuration Parameters
------------------------ ------------------------
Please look in defaults/main.yml for the default values of the various install parameters. Everything Look at `role/kalite/defaults/main.yml <https://github.com/iiab/iiab/blob/master/roles/kalite/defaults/main.yml>`_ for the default values of the various install parameters.
in this readme assumes the default values.
Trouble Shooting Troubleshooting
---------------- ---------------
Starting with kalite 0.15 you can run the server manually with the following commands: Starting with KA Lite 0.15 (October 2015) you can run the server manually with the following commands:
* systemctl stop kalite-serve (make sure the systemd service is not running) * systemctl stop kalite-serve (make sure the systemd service is not running)
* export KALITE_HOME=/library/ka-lite (point kalite to the right environment) * export KALITE_HOME=/library/ka-lite (point kalite to the right environment)
* kalite start (start the server; can take more than 10 minutes in some environment) * kalite start (start the server; can take more than 10 minutes in some environments)
To return to using the systemd unit: To return to using the systemd unit:
* export KALITE_HOME=/library/ka-lite (point kalite to the right environment) * export KALITE_HOME=/library/ka-lite (point kalite to the right environment)
* kalite stop * kalite stop
* systemctl start kalite-serve * systemctl start kalite-serve
*In late 2017, Internet-in-a-Box added a virtual environment (/usr/local/kalite/venv/) to keep KA Lite's Python and PHP package risks under control. As such the command* `/usr/bin/kalite <https://github.com/iiab/iiab/blob/master/roles/kalite/templates/kalite.sh.j2>`_ *is a wrapper to this virtualenv.*