Known_Issues

Allan Cunliffe Kirti Chennareddy

The following are a list of known issues relating to the Xena preservation software.

Cancellation of normalisation results

Xena Version

6.0.x

Area/Action

Cancelling normalisation results.

Description

Once normalisation is complete, the output files are stored in the Xena Destination Directory, set in Xena Preferences. The purpose of the Cancel button (displayed at completion of normalisation) is to return you to the item selection window and delete the output files associated with the cancelled job.

Depending on the files normalised and/or the results of normalisation, clicking the Cancel button may not remove all output files from the Xena Destination Directory.

The behaviour on clicking the Cancel button is as follows:

  • Any files which failed normalisation remain in the output directory.
  • All files which were successfully normalised are removed automatically from the output directory (except for archive files - see next dot point).
  • For any archive files successfully normalised, the Xena file corresponding to the parent file (e.g. xena.zip) is automatically removed. All other files associated with the archive remain in the output directory.

Affected Operating Systems

Behaviour confirmed on Windows 7 and Ubuntu Linux 9.10.

Workaround

This issue will have more of an impact where you are normalising archive files (such as .zip and .jar). There are generally a large number of constituent files associated with archives, so normalising and cancelling the results will quickly populate the Xena Destination Directory with unwanted files.

  • Avoid cancelling normalisation results unnecessarily.
  • Monitor the Xena Destination Directory and manually delete unwanted files as required.

Failure opening normalised office documents using LibreOffice from the viewer after normalisation step is complete.

Xena Version

6.0.x

Area/Action

Xena Viewer.

Description

After a word document is normalised,clicking on the Show in LibreOffice.org button on the viewer does not respond.

The cause is LibreOffice running in headless mode during normalisation step.

XENA uses LibreOffice to normalise office documents (such as Microsoft Word). To do this, XENA launches LibreOffice in headless mode.

Affected Operating Systems

  • Linux
  • Windows 7

Workaround

Manually end the soffice.bin process before opening normalised file in the viewer.

Normalising SVG files

Xena Version

6.0.x

Area/Action

Normalising files.

Description

Attempting to normalise certain Scalable Vector Graphics (SVG) files created with the Inkscape SVG drawing tool (version: 0.46) may fail.

This has been reported as a bug (ID 167335) in the Inkscape bug tracking system.

Symptoms depend on the operating system.

Affected Operating Systems

  • Mac OS X - During normalisation of SVG files Xena may freeze, displaying the following out of memory error in the console:

    Exception thread "Thread-6" java.lang.OutOfMemoryError: Java heap space at org.apache.batik.dom.svg.AbstractElement$NamedNodeHashMap<init>(Unknown Source)...

  • Linux and Windows - Xena completes the normalisation process but the affected SVG files fail to normalise.

Workaround

  • Do not attempt to normalise any SVG files that cause Xena to freeze. Remove them from the Items to Normalise list before normalising.
  • Edit the xena.sh script by adding a switch for maximum heap size. For example:

    java -Xmx1500M -cp plugins/audio.jar:xena.jar au.gov.naa.digipres.xena.litegui.LiteMainFrame ...

Note: The maximum allowed heap size you can set depends on your computer. See Java Tuning White Paper for more information.

Out of Memory Error

Xena Version

6.0.x

Area/Action

Normalising large files or archive formats (such as zip or mbox) containing a large number of files.

Description

During normalisation Xena may freeze, displaying the following out of memory error in the console:

Exception thread "Thread-6" java.lang.OutOfMemoryError: Java heap space at org.apache.batik.dom.svg.AbstractElement$NamedNodeHashMap&lt;init&gt;(Unknown Source)...

Affected Operating Systems

  • Mac OS X
  • Windows 7

This may also occur in Linux, depending on the default heap space allocated by the operating system.

Workaround

Edit the xena.sh script by adding a switch for maximum heap size. For example:

java **-Xmx1500M** -cp plugins/audio.jar:xena.jar au.gov.naa.digipres.xena.litegui.LiteMainFrame ...

Note: The maximum allowed heap size you can set depends on your computer. See Java Tuning White Paper for more information.


Related

Wiki: Main_Page
Wiki: Using_Xena_via_the_command_line