LMSBox – Paradiso LMS Documentation Portal

The LMSBox plugin for LMS is an administration tool providing a GUI to some settings and management of an LMSBox, an LMS server installed on a Raspberry Pi.

It enables an LMS administrator to monitor some hardware settings, to set the date of the LMSBox, to allow restart and shutdown of the LMSBox and changing Raspberry Pi passwords using a GUI. After the installation in LMS, some steps are required to complete on the Raspberry Pi (see below).

A Raspberry Pi model 3B or 3B+ is recommended.

1 Requirements

2 Installation

2.1 Create necessary files

2.2 Install incron package and allow root to run it

2.3 Add following lines to incrontab

2.4 Secure your LMSbox

3 Features

4 Availability

Requirements

A Raspberry Pi (Model 3B or 3B+ recommended)
Raspbian installed (or another Linux based distribution)
Package Incron installed
LMS installed (obviously)

Installation

The LMSBox plugin must be installed in the LMS tree of the LMSBox, in the tool folder. Once installed, a new option LMSBox will be available in LMS, 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 LMSBox.

Create necessary files

This step is not needed anymore

   touch .reboot-server; touch .shutdown-server; touch .set-server-datetime; touch .newpassword; touch .wifisettings
   chown -R www-data:www-data /var/www/lms/admin/tool/lmsbox

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/lms/admin/tool/lmsbox/.reboot-server IN_CLOSE_WRITE /sbin/shutdown -r now
   /var/www/lms/admin/tool/lmsbox/.shutdown-server IN_CLOSE_WRITE /sbin/shutdown -h now
   /var/www/lms/admin/tool/lmsbox/.set-server-datetime IN_CLOSE_WRITE /bin/bash /var/www/lms/admin/tool/lmsbox/.set-server-datetime
   /var/www/lms/admin/tool/lmsbox/.newpassword IN_CLOSE_WRITE /bin/bash /var/www/lms/admin/tool/lmsbox/bin/changepassword.sh
   /var/www/lms/admin/tool/lmsbox/.wifisettings IN_CLOSE_WRITE /bin/bash /var/www/lms/admin/tool/lmsbox/bin/changewifisettings.sh

Features

Info about the LMSBox (kernel version, Raspbian version, free space on SD card, CPU load, CPU temperature, CPU frequency, uptime, DHCP clients).
GUI to set the LMSBox date and time.
GUI to set the LMSBox password.
GUI to set the LMSBox Wi-Fi network password, SSID and channel.
GUI to restart and shut down the LMSBox.

Availability

The code is available at https://github.com/lmsbox/lms-tool_lmsbox.

Contents