To integrate the Mumie into Moodle, you have to install two components: the activity for Moodle ("Mumie course" and/or "Mumie exercise") and the Mumie service layer.
Mumie service layer¶
Download Mumie service layer archive (aar)¶
- Prerequisite: Servlet engine (i.e. [[http:_tomcat.apache.org|Apache Tomcat]]) and [[http:_ws.apache.org/axis2|Apache Axis2]] (webservice framework).
- Download the Archive for the Mumie service layer (aar-file). FIXME URL.
- Copy the archive to the services-axis2-webapp-directory of the servlet container (i.e. Tomcat: TOMCAT_HOME/webapps/axis2/WEB-INF/services/).
- The Mumie service layer is deployed, when you restart the servlet engine. You can check it with the following URL (replace "yourserver.com" with the your real server): http://yourserver.com/axis2/services/listServices
- Now you can go on and install the Mumie activity in Moodle (installation).
Download Mumie service layer sources¶
- Alternatively you can download the source code of the Mumie service layer and build the archive by yourself with a provided ant script.
- Change to the directory with the file "build.xml", which comes together with the source code.
- To configure the script, you must customize the file "build.properties" in the same directory.
- Type "ant" in the console: this compiles the source, runs some tests and creates the archive for the Mumie service layer in the directory dist.
Secure Mumie service layer¶
You can optionally secure the Mumie service layer with HTTP authentication. By calling a webservice a username and password are sent in the HTTP header ("Authorization"). The webapplication (axis2) is responsible for the security settings. Add the following extract to the web.xml auf the axis2 webapplication (TOMCAT_HOME/webapps/axis2/WEB-INF/web.xml):
Then add the following extract to the tomcat-users.xml (TOMCAT_HOME/conf/tomcat-users.xml):
<role rolename="mumie_sync" />
<user username="sync_user" password="sync_user_pwd" roles="mumie_sync" />
"sync_user" and "sync_user_pwd" correspond to the settings for the sync-user and its password made in the administration area of Moodle (installation). With the settings above the webservice is secure and only a "sync_user" with password "sync_user_pwd" can access it. To call a secured webservice would look like that (i.e. in PHP):
$client = new SoapClient("http://yourserver.com/axis2/services/MumieServiceAdapter?wsdl", array("login" => "sync_user", "password" => "sync_user_pwd"));
$result = $client->createUser($user);
Activities in Moodle¶
- Prerequisite: [[http://www.moodle.org|Moodle]].
- Download the activity for Moodle: "Mumie course" for integrating entire Mumie courses in Moodle and "Mumie exercise" for integrating single Mumie exercises. FIXME URL.
- Unzip the downloaded file and copy it to the mod-directory of your Moodle installation (MOODLE_ROOT/mod).
- Log in to Moodle as an administrator and click on the link "Notification". Moodle checks if there are new features and installs them.
- Now you can configure the activity in Moodle (installation)
Administration in Moodle¶
- Log in to Moodle as an administrator and navigate to the configuration interface for the Mumie activites "Mumie course" or "Mumie exercise" ("Modules" > "Activities" > "Manage Activities").
- Fill out the form:\\
- URL of the abstraction layer (i.e. https://yourserver.com/axis2/services/MumieServiceAdapter?wsdl, replace "yourserver.com" with the your real server)
- URL of the Mumie server (i.e. https://yourserver.com/cocoon, replace "yourserver.com" with the your real server)
- Synchronization user and its password. This user must exist in the Mumie and has got the capability to synchronize data between the Mumie and a master LMS.
- Then you can store your entries.