Sakai 2.5

Mneme will run in Sakai 2.5 versions. You will need to:

• Download the Mneme software from SVN, into your Sakai 2.5 source folder:
  
  sakai> svn co https://source.sakaiproject.org/contrib/etudes/ambrosia/tags/1.2m1/ ambrosia
  
  sakai> svn co https://source.sakaiproject.org/contrib/etudes/mneme/tags/1.2m1/ mneme
   
• Build Ambrosia and Mneme independently from Sakai with Maven (version 2)
  
  First, build Sakai. Because Ambrosia and Mneme are not listed in the root pom.xml, you will then need to build each one, Ambrosia first.
  
  sakai> cd ambrosia
  sakai:ambrosia> mvn install sakai:deploy
  sakai:ambrosia> cd ../mneme
  sakai: mneme> mvn install sakai:deploy
  
  The 1.2m1 tag is set to work with Sakai 2.5.3. You can edit the two pom.xml files to change the sakai version to another if you need to:
  
  - ambrosia/pom.xml
  - mneme/pom.xml
   
• To build Mneme with Sakai, you can edit Sakai's root pom.xml file to add ambroisa and mneme to a build profile that you use. After this, you can build Sakai and Mneme together.

Back to top

Sakai Portal Icons

Sakai 2.5 and later supports icons in the portal for each tool. Sakai comes with icons for the tools that are bundled, and you can make a few simple edits to add icons for other tools such as Mneme.

The icons are part of the Sakai skin. The skin files are in the "library" webapp, which is located in your deployed tomcat in the folder

webapps/library/skin

The skin has to be enhanced in two ways:

• make the new icons available
• change the skin .css file to reference them

There is a "default" skin, and perhaps, depending on your customizations of Sakai, other skins. You need to make these changes for the skins that you are using. The following instructions show how to change the "default" skin, in the "library/skin/default" folder. To change the others, apply these same changes to the other skins, located in folders under "library/skin/".

1. You can add some icons for Mneme and the Mneme Admin tools here:
   
   webapps/library/skin/default/icons/
    
2. Create this folder, and download these icons into it:

   mneme.png

   mneme-admin.png

3. The file "portal.css" is where the icons are referenced. For the default skin, this file is here:
   
   webapps/library/skin/default/portal.css
   
   There is a section in there that lists lots of tools. We want to add two more:
   
   .icon-sakai-mneme
   {
   background-image: url(icons/mneme.png);
   }
   
   .icon-sakai-mneme-admin
   {
   background-image: url(icons/mneme-admin.png);
   }

3. Download and install the TinyMCE editor webapp

Mneme requires the TinyMCE editor. You must (for now) separately download and install this into your Tomcat. We have a packaging of the 3.2.0.2 TinyMCE editor as a webapp ready to download in the Sakai Maven (1) repository:

https://source.sakaiproject.org/maven/tiny_mce/wars/tiny_mce-3.2.0.2.war

Download that file into your Tomcat webapps folder, renaming it to:

tiny_mce.war

removing the version number from the file name.

Back to top

4. 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:

mneme.manage

mneme.grade

mneme.submit

mneme.guest

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:

!site.template

!site.template.course

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:

"maintain" roles:

• maintain
• Instructor
• Teaching Assistant

"access" roles:

• access
• Student

You may have added guests, support, and others. Make sure to modify all the appropriate roles.

Back to top

5. 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:

templates@org.muse.mneme.tool.InstallTemplatesView=!site.template,!site.template.course

To list the unique set of roles you are using for "maintain" and "access", add these lines to your sakai.properties:

maintainRoless@org.muse.mneme.tool.InstallView=maintain,instructor,teaching assistant

accessRoles@org.muse.mneme.tool.InstallView=access,student

To add the Mneme Admin tool to your Administration Workspace, do the following:

1. Log in as Sakai Admin
2. Click on Sites
3. Click on !admin
4. Scroll down and click on Pages
5. Click on "New Page" at the top
6. Enter "Mneme Admin Tool" in the Title field
7. Click on Tools (not on Done!)
8. Click on "New Tool" at the top of the page
9. Scroll down - find and select "Mneme Admin (sakai.mneme.admin)"
10. Click on Done at the bottom.
11. Click on Save on the new page that appears.

That's it.

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.

• Mneme User Guide - 1.2m1  (IMS CP zip format - import into Melete)
• Mneme Overview (PowerPoint, 2MB)
• Instructor User Guide - Mneme Overview (.doc format, 76 pages)
• How to Import Assessments & Pools into Mneme (Word format)
• How to Import assignments from Assignments tool into Mneme
• Comparison Chart of Mneme versus Assignments tool
• Mneme Flyer (.pdf format)

Back to top

7. What's New in This Release

Highlights of features and enhancements of this release:
http://etudes.org/mneme/releases/mneme-upgrade1.2m1.htm