Zenodo

DOI

1. Content

This plugin lets you add any Java applet or Javascript application created with Easy Java Simulations (EJS) to your Moodle course.

The Java applets should have been compiled with version 4.37 (build 20120715 or later) of EJS while the Javascript applications should have been created with version 5.1 (build 20150613 or later) to work properly.

2. License

EJSApp is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

EJSApp is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

The GNU General Public License is available on http://www.gnu.org/licenses/

3. Installation

If you downloaded this plugin from github, you will need to change the folder's name to ejsapp. If you downloaded it from Moodle.org, then you are fine.

This is a module plugin for Moodle so you should place the ejsapp folder in your /mod folder, inside your Moodle installation directory.

This module enhances its functionality when used along with the ejsappbooking module and/or the ejsapp_file_browser, the ejsapp_collab_session blocks and the osp repository plugin. You can find and download them at https://moodle.org/plugins/browse.php?list=set&id=27, in the plugins section in the Moodle.org webpage or at https://github.com/UNEDLabs.

WARNING: If you are updating ejsapp from a previous version, DO NOT replace/delete your old jarfiles directory inside your old ejsapp directory.

IMPORTANT: For Unix Moodle servers (e.g., Linux and Mac systems), EJSApp requires that (i) the apache user is the owner of the "jarfiles" dir inside the "ejsapp" dir, and (ii) it has permissions to read, write and execute the jarfiles dir.

The following points describe how to do it:

1) go to the ejsapp dir:
$ cd ejsapp

2) Change the owner of the jarfiles dir to apache.
For instance,
2.a) in Linux CentOS, the apache user is "apache", so you should write
$ chown -R apache jarfiles 2.b) in Linux OpenSuse, the apache user is "wwwrun", so you should write
$ chown -R wwwrun jarfiles

3) Change the permissions of the apache user:

$ chmod -R 755 jarfiles

IMPORTANT: For Unix Moodle servers (e.g., Linux and Mac systems), if you have a trust certificate and you want to use the option to automatically sign the Java applets, you must give the apache user permissions over the jarsigner (Java installation folder) file.

The following points describe how to do it:

1) Install jarsigner alternative $ alternatives --install /usr/bin/jarsigner jarsigner /usr/java/jdk1.7.0_51/bin/jarsigner 20000 $ alternatives --set jarsigner /usr/java/jdk1.7.0_51/bin/jarsigner

2) Change the owner of the jarsigner file to apache.
For instance,
2.a) in Linux CentOS, you should write
$ chown apache /usr/java/jdk1.7.0_51/bin/jarsigner
2.b) in Linux OpenSuse,you should write

$ chown wwwrun /usr/java/jdk1.7.0_51/bin/jarsigner

4. Configuration

When installing ejsapp for the first time, you may need to set a few variables (in case you want to use applets):

certificate_path: This variable defines the absolute path to the trust certificate file.

certificate_password:This variable must contain the password of the trust certificate.

certificate_alias: This variable stores the alias given to your trust certificate.

5. Authors

EJSApp has been developed by: - Luis de la Torre: ldelatorre@dia.uned.es - Ruben Heradio: rheradio@issi.uned.es

at the Computer Science and Automatic Control Department, Spanish Open University (UNED), Madrid, Spain.