Welcome to the Mneme 2.1.29 release!
For a list of resolved Jira issues, see "What's new or fixed in Mneme 2.1.29 (and earlier versions)."
Mneme is a comprehensive assessment engine that consists of an authoring module for creating questions and managing pools; a module for publishing assignments, tasks, tests and surveys; a grading module for evaluating assessments, optionally integrated with the Gradebook; and a delivery module for administering assessments to students. Additionally, a test-drive component allows instructors to take assessments as students.
Download Mneme 2.1.29
Mneme is distributed as source only, and is configured for Sakai 2.9.3.
1. Install the Mneme Database
Before you start up your Sakai instance with Mneme, you must install Mneme's tables in your database. Mneme supports Oracle and MySQL - HSQL is not supported.
The easiest way to install Mneme's tables is to let Sakai's auto.ddl feature do it for you as your first app server starts up. Make sure that auto.ddl is enabled for the app server, and make sure you start up just a single app server. auto.ddl will run Mneme's ddl.
Most production environments will prefer to manually run the Mneme ddl, possibly modified for tablespace and other local concerns. There are 4 ddl files to run - the order does not matter. These are found in the source code under mneme/mneme-impl/impl/src/sql/<vendor>, where "<vendor>" is either "mysql" or "oracle". The 4 files that contain Mneme's ddl are:
To update from a previous version of Mneme, notice the other sql files distributed with Mneme. These take your database up to the current version. You need to run all the updates that you have not yet run, to take your particular version of the database up to the latest. You may need to examine your current Mnene database definition, compare it to the latest Mneme DDL files, and note these update sql files to craft the particular update that works for you.
2. Download Mneme Source And Modify Your Sakai Distribution
To add Mneme to your Sakai 2.9.3, you will need to:
This version is configured to build with Sakai 2.9.3. If you are using another Sakai version, you need to make a few changes.
The "2.9.3" version number is in a few Mneme files, used as the version number for the Sakai base pom. You need to edit these files to change this to match the version of Sakai you are using:
3. Configure Mneme
To finalize the integration of Mneme into your Sakai installation, you need to make some changes to the Authz Groups that are used as templates when new Sites are created, to enable the proper Mneme permissions. You can do this manually, by using the Admin Realm (Authz Group) editor in Sakai to edit the template authz groups, or use the Mneme Admin tool to do this.
There are three permissions in Mneme:
You must give the first two permissions (mneme.manage and mneme.grade) to your instructors, teaching assistants, and other "maintain" sorts of roles. NOTE: Do NOT give 'maintain' types of roles the mneme.submit permission; they will be able to try out assessments in Mneme using Test Drive without submit permission.
Your students need only the third, mneme.submit permission.
To allow users (typically 'guest' roles) to view the assessments defined in a site but not make changes or submissions, use the mneme.guest permission.
In a stock Sakai distribution, there are two Authz Group templates used as new site templates:
You may have additional ones, especially if you have other than "project" and "course" site types. Make sure you modify all the appropriate templates.
The templates in a stock Sakai distribution have the following 5 roles:
You may have added guests, support, and others. Make sure to modify all the appropriate roles.
Mneme entries in sakai.properties
4. Use the Mneme Admin to Install Permissions
You can use the Mneme admin tool to install the Mneme permissions. The tool also allows you to add Mneme (permissions and tool) to a single site or a batch of sites.
To use the Mneme Admin tool, you must access the tool in your production Sakai instance. If you have the Mercury portal enabled, you can use that to access "sakai.mneme.admin". Otherwise you can add the tool to your !admin site and use it from there. You must be an admin user to use the tool.
The tool will work with the standard templates and roles. You can configure the tool to use additional or different templates and roles.
To list the unique set of templates used in your Sakai installation for site Authz Group templates, add this to your sakai.properties:
To list the unique set of roles you are using for "maintain" and "access", add these lines to your sakai.properties:
To add the Mneme Admin tool to your Administration Workspace, do the following:
When you click on "Administration Workspace," you will now see Mneme Admin Tool where you can perform a variety of functions, such as adding Mneme permissions or Mneme to sites, etc.
Working with Assignments, Tests and Surveys
6. What's New in This Release
See issues addressed in this release and earlier versions / releases.