MoodleBox: Difference between revisions
From MoodleDocs
| MoodleBox | |
|---|---|
| Type | Admin Tool |
| Set | N/A |
| Downloads | https://moodle.org/plugins/view.php?plugin=tool_moodlebox |
| Issues | https://tracker.moodle.org/CONTRIB-6757 |
| Discussion | N/A |
| Maintainer(s) | Nicolas Martignoni |
(Page creation) |
No edit summary |
||
| Line 7: | Line 7: | ||
|float = right | |float = right | ||
}} | }} | ||
The MoodleBox plugin for Moodle is an administration tool providing a GUI to some settings and management of a MoodleBox, a Moodle server installed on a Raspberry Pi. | |||
It enables a Moodle administrator to monitor some hardware settings, to set the date of the MoodleBox, to allow restart and shutdown of the MoodleBox and changing Raspberry Pi passwords using a GUI. After the installation in Moodle, some steps are required to complete on the Raspberry Pi (see below). | It enables a Moodle administrator to monitor some hardware settings, to set the date of the MoodleBox, to allow restart and shutdown of the MoodleBox and changing Raspberry Pi passwords using a GUI. After the installation in Moodle, some steps are required to complete on the Raspberry Pi (see below). | ||
The plugin is compatible with Moodle 3.1 or later. | The plugin is compatible with Moodle 3.1 or later. | ||
== Requirements == | |||
* A Raspberry Pi (ideally Model 3 B) | |||
* Raspbian installed (or another Linux based distribution) | |||
* Package Incron installed | |||
* Moodle installed (obviously) | |||
== Installation== | == Installation== | ||
The MoodleBox plugin must be installed in the Moodle tree of the MoodleBox, in the tool folder. Once installed, an new option MoodleBox will be available in Moodle, under Site administration > Server in the Administration block. | The MoodleBox plugin must be installed in the Moodle tree of the MoodleBox, in the tool folder. Once installed, an new option MoodleBox will be available in Moodle, under ''Site administration > Server'' in the Administration block. | ||
To complete the installation, you have to create some files in the plugin folder and configure some incron jobs on the MoodleBox. | To complete the installation, you have to create some files in the plugin folder and configure some incron jobs on the MoodleBox. | ||
# Create necessary files | |||
touch .reboot-server; touch .shutdown-server; touch .set-server-datetime; touch .newpassword; touch .wifipassword | |||
chown -R www-data:www-data /var/www/html/admin/tool/moodlebox | |||
# Install incron package and allow root to run it | |||
sudo apt-get install incron | |||
echo root | sudo tee -a /etc/incron.allow | |||
# Add following lines to incrontab | |||
/var/www/html/admin/tool/moodlebox/.reboot-server IN_CLOSE_WRITE /sbin/shutdown -r now | |||
/var/www/html/admin/tool/moodlebox/.shutdown-server IN_CLOSE_WRITE /sbin/shutdown -h now | |||
/var/www/html/admin/tool/moodlebox/.set-server-datetime IN_CLOSE_WRITE /bin/bash /var/www/html/admin/tool/moodlebox/.set-server-datetime | |||
/var/www/html/admin/tool/moodlebox/.newpassword IN_CLOSE_WRITE /bin/bash /var/www/html/admin/tool/moodlebox/bin/changepassword.sh | |||
/var/www/html/admin/tool/moodlebox/.wifipassword IN_CLOSE_WRITE /bin/bash /var/www/html/admin/tool/moodlebox/bin/setwifipassword.sh | |||
== Features == | |||
* Info about the MoodleBox (kernel version, Raspbian version, free space on SD card, CPU load, CPU temperature, CPU frequency, uptime, DHCP clients). | |||
* GUI to set the MoodleBox date and time. | |||
* GUI to set the MoodleBox password. | |||
* GUI to set the MoodleBox Wi-Fi network password. | |||
* GUI to restart and shutdown the MoodleBox. | |||
== Availability == | |||
The code is available at [https://github.com/martignoni/moodle-tool_moodlebox https://github.com/martignoni/moodle-tool_moodlebox]. | |||
[[Category:Contributed code]] | |||
Revision as of 15:38, 20 April 2017
The MoodleBox plugin for Moodle is an administration tool providing a GUI to some settings and management of a MoodleBox, a Moodle server installed on a Raspberry Pi.
It enables a Moodle administrator to monitor some hardware settings, to set the date of the MoodleBox, to allow restart and shutdown of the MoodleBox and changing Raspberry Pi passwords using a GUI. After the installation in Moodle, some steps are required to complete on the Raspberry Pi (see below).
The plugin is compatible with Moodle 3.1 or later.
Requirements
- A Raspberry Pi (ideally Model 3 B)
- Raspbian installed (or another Linux based distribution)
- Package Incron installed
- Moodle installed (obviously)
Installation
The MoodleBox plugin must be installed in the Moodle tree of the MoodleBox, in the tool folder. Once installed, an new option MoodleBox will be available in Moodle, under Site administration > Server in the Administration block.
To complete the installation, you have to create some files in the plugin folder and configure some incron jobs on the MoodleBox.
- Create necessary files
touch .reboot-server; touch .shutdown-server; touch .set-server-datetime; touch .newpassword; touch .wifipassword chown -R www-data:www-data /var/www/html/admin/tool/moodlebox
- Install incron package and allow root to run it
sudo apt-get install incron echo root | sudo tee -a /etc/incron.allow
- Add following lines to incrontab
/var/www/html/admin/tool/moodlebox/.reboot-server IN_CLOSE_WRITE /sbin/shutdown -r now /var/www/html/admin/tool/moodlebox/.shutdown-server IN_CLOSE_WRITE /sbin/shutdown -h now /var/www/html/admin/tool/moodlebox/.set-server-datetime IN_CLOSE_WRITE /bin/bash /var/www/html/admin/tool/moodlebox/.set-server-datetime /var/www/html/admin/tool/moodlebox/.newpassword IN_CLOSE_WRITE /bin/bash /var/www/html/admin/tool/moodlebox/bin/changepassword.sh /var/www/html/admin/tool/moodlebox/.wifipassword IN_CLOSE_WRITE /bin/bash /var/www/html/admin/tool/moodlebox/bin/setwifipassword.sh
Features
- Info about the MoodleBox (kernel version, Raspbian version, free space on SD card, CPU load, CPU temperature, CPU frequency, uptime, DHCP clients).
- GUI to set the MoodleBox date and time.
- GUI to set the MoodleBox password.
- GUI to set the MoodleBox Wi-Fi network password.
- GUI to restart and shutdown the MoodleBox.
Availability
The code is available at https://github.com/martignoni/moodle-tool_moodlebox.
