This is information about the the most recent prototype of CompendiumLD, the Open University's learning design software.

Important Installation Information for CompendiumLD

Table of Contents:

I. Welcome!

Welcome to CompendiumLD

CompendiumLD is a software tool for designing learning activities using a flexible visual interface. It provides a set of icons to represent the components of learning activities; these icons may be dragged and dropped, then connected to form a map representing a learning activity. CompendiumLD is a specialised version of Compendium, the mind mapping or argumentation software that provides a default set of icons for creating maps to visualise the connections between ideas. All the facilities provided by Compendium are included within CompendiumLD.

This prototype has been released to allow users to explore CompendiumLD and influence and inform its development. Please provide feedback about the installation process and CompendiumLD itself on the to the Compendium feature request and bug tracking site. If you have any questions about CompendiumLD please contact the lead developer Andrew Brasher.

Back to top

II. Install CompendiumLD

General

If you already have the standard version of Compendium installed, we recommend that you install this prototype into another directory.

CompendiumLD is a Java application, so it requires a Java Runtime Environment (JRE) to be installed.

If you have a previous version of CompendiumLD installed we recommend that you copy your previous installation to a new folder (e.g. ComendiumLD-backup) before updating the original with this new version.

Windows

As stated above CompendiumLD reuires the a Java Runtime Environment (JRE) to be installed. If Java is not detected on your system you will be prompted to install the JRE at the end of the CompendiumLD installation process.

The simplest way to install CompendiumLD on either Windows XP, Vista, 7 or 8 is with an account with ADMINISTRATIVE rights. To ensure the installer is run with the necessary privileges in Windows Vista, 7 or 8 you should right-click on the installer and select 'Run as administrator'.

If you do not have administrator privileges (administrator rights) you can still install and run CompendiumLD. Just install CompendiumLD in your 'My Documents' or 'Documents' folder, then install the Java Runtime Environment in to the JRE sub-folder within the CompendiumLD folder.

If you are installing onto Windows Vista, 7 or 8 you may get an error message indicating that the Java Runtime Environment has not been installed correctly (e.g. this javaw message). If this occurs you will need to install the Java Runtime Environment separately. To do so, download the latest release of the Java Runtime Environment from the Java site and follow the installation instructions provided

Mac OS X

CompendiumLD version 1.2 for Mac OS X has been tested on 10.5 (Leopard), 10.6 (Snow Leopard), 10.7 (Lion) and 10.9 (Mavericks). It requires Java J2SE 5.0 Release 4 (aka 1.5.0_4) or later, which will be present if you are running Mac OS 10.6 and below. If you are running Mac OS 10.7 (Lion) or above you will need to install Java: see Mac OS X Java 7 Information for installing and using Java. CompendiumLD should also run on for 10.4 (Tiger) but has not been tested.

Once you have downloaded the relevant .dmg file from the CompendiumLD web site you need to double click the .dmg file to mount the disk image. This will open a window showing you the CompendiumLD .mpkg file. Double click the package file and this will run the installer. Follow the installer instructions.

If you are unsure which version of Java you have installed, open a terminal window (inside Applications/Utilities/Terminal) and type:

java -version

The output from running that command will look something like:

java version "1.5.0_07"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_07-164)
Java HotSpot(TM) Client VM (build 1.5.0_07-87, mixed mode, sharing)

The text above shows that Java 1.5.0_07 is installed in this example which is fine as it is greater than the required 1.5.0_04

NOTE: Currently, due to unresolved file permission issues, only the user installing CompendiumLD will be able to run it, unless CompendiumLD subfolders have their permissions changed appropriately.

USER INTERFACE TIP: Depending on your mouse or trackpad settings, you may have to use combinations such as

TECH TIP: You might like to be aware that Compendium sets the Memory allocation for the JRE up to 256mb (the default is 64mb). If you need to change this value for any reason, you will need to open the contents of the Compendium Application file using the 'Show Package Contents' option on the right-click menu, then open the Contents' folder and edit the VMOptions property in the info.plist file. Please only attempt this if you are a confident user.

TECH TIP: In order to automatically open external files and links on the Mac, Compendium stores file extension and application associations in a file in

<Compendium home folder>/System/resources called LaunchApplications.properties.

This file is added to as the user tries to launch various file types for the first time and picks an application to use. We have preloaded this file with three type, 'www', 'http' and 'https', and we have associated them with the path '/Applications/Safari'. If you do not have this application or have it in another location, you will need to edit this file appropriately.

Linux

Once you have downloaded the relevant .tar.gz file from the CompendiumLD web site, simply unpack it. You can run CompendiumLD by navigating to the CompendiumLD directory and typing:

./compendiumLD.sh

Compendium is a Java application, so it requires a Java Runtime Environment (1.5+) to be installed before you can run it.

Back to top

III. Known Issues

CompendiumLD

CompendiumLD is under ongoing development and there are some aspects of functionality that we know are missing from this version:

There are other aspects of learning design functionality that we plan to add to future prototypes of CompendiumLD. Further information about these will be available from the CompendiumLD website.

Java

If, when starting CompendiumLD (e.g. by double clicking the CompendiumLD icon) you get a message like

Windows cannot find `javaw`

you should try reinstalling Java from the Java site (http://java.com/).

General (issues concerning standard Compendium functionality)

When you import a map from QuestMap with Pros and Cons, they come out as Arguments in CompendiumLD (even though they are linked to other nodes).

Exporting to an XML file in an off-line directory can cause the file to be corrupted. (This is a known Windows problem).

Windows

There is a general bug with Java running on machines with some versions of NVidia video drivers. If you have a graphics card which uses these drivers, and experience problems running CompendiumLD, you should make sure that you have the latest drivers installed.

There is a problem with some Tablet PCs and graphics drivers. A workaround is to switch off Java 2D graphics. This can be done by editing the CompendiumLD.bat file. The final line in the batch file should resemble:

start /b javaw -Dsun.java2d.noddraw=true -Xmx256m -classpath etc.. etc..

Best wishes

The CompendiumLD Team, Open University Learning Design Initiative.

Contact: Andrew Brasher (lead developer), a.j.brasher@open.ac.uk.

Back to top