##########
# EJSApp #
##########

https://zenodo.org/badge/latestdoi/18948/UNEDLabs/moodle-mod_ejsapp
DOI: 10.5281/zenodo.33845

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

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 will need to set a few variables:

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.

sarlab_IP: This variable defines the IP(s) address(es) of the SARLAB system(s) used for managing the access to
the remote laboratories. If left empty, the plugin understands that SARLAB is not used.

sarlab_port: This variable defines the port(s) used to communicate with the SARLAB system(s). If left empty, the
plugin understands that SARLAB is not used.

sarlab_enc_key: This 16 characters long variable must be configure to match exactly the key set in the SARLAB
system(s).

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.