Child pages
  • Known Problems - 5.0

This space has moved to IU's Confluence.
It is located at https://uisapp2.iu.edu/confluence-prd/display/iulV3/

Skip to end of metadata
Go to start of metadata

Known Problems in Variations Phase 1 Release (5.0)

This page will contain a list of known problems and workarounds, if they exist. Problems will remain on this page until a Variations release or update containing a fix for the problem is released.

Developers: This page does not replace JIRA. Still file a bug in JIRA and if the bug affects test site operation also add it to this page. When updating a bug in JIRA, don't forget to also update this page.

Catalogers and Digitizers cannot CREATE_METADATA, LOCK_METADATA, or DELETE_METADATA with default accessPolicy.xml

Fix:
Add the following Action XML blocks to Actions under the CatalogerDigitizer rule in conf/server/accessPolicy.xml:

<Action>
	<ActionMatch MatchId="urn:oasis:names:tc:xacml:1.0:function:string-equal">
		<AttributeValue DataType="http://www.w3.org/2001/XMLSchema#string">CREATE_METADATA</AttributeValue>
		<ActionAttributeDesignator DataType="http://www.w3.org/2001/XMLSchema#string" AttributeId="urn:oasis:names:tc:xacml:1.0:action:action-id"/>
	</ActionMatch>
</Action>
<Action>
	<ActionMatch MatchId="urn:oasis:names:tc:xacml:1.0:function:string-equal">
		<AttributeValue DataType="http://www.w3.org/2001/XMLSchema#string">LOCK_METADATA</AttributeValue>
		<ActionAttributeDesignator DataType="http://www.w3.org/2001/XMLSchema#string" AttributeId="urn:oasis:names:tc:xacml:1.0:action:action-id"/>
	</ActionMatch>
</Action>
<Action>
	<ActionMatch MatchId="urn:oasis:names:tc:xacml:1.0:function:string-equal">
		<AttributeValue DataType="http://www.w3.org/2001/XMLSchema#string">DELETE_METADATA</AttributeValue>
		<ActionAttributeDesignator DataType="http://www.w3.org/2001/XMLSchema#string" AttributeId="urn:oasis:names:tc:xacml:1.0:action:action-id"/>
	</ActionMatch>
</Action>

Derivative audio files need to have a lowercase filename

Fix:
Name derivative audio files based upon the Filenaming Scheme set in dmlserver.xml, but with the id part of the filename in lowercase.

Server's client config files not being setup automatically in initVariations.sh

In order to run scripts on the server that connect as a client, you will need to manually configure dml.conf in conf/client/dml.conf on the server. Also conf/client/client_console.lcf and conf/client/client_file.lcf should be configured to point to your Variations logging servers. This is fixed for those installing from the next update of the server.

Truncated wav files are not caught during ingest process

Wav files whose headers report a length different than the actual file length are not caught during the ingest process. This can result in unplayable Containers and buggy playback. This is fixed in the next update of the digitizer client.

Generated Access pages will not include additional MARC metadata

The Variations server cannot do Z39.50 lookup of MARC records for additional metadata during Access pages generation.

Fix:
Include some of the dml.z3950.Container properties in the SystemProperties tag for the cataloging server in dmlserver.xml.
Example settings for IU would be the following:

		<SystemProperty name="dml.z3950.Container.enabled">true</SystemProperty>
		<SystemProperty name="dml.z3950.Container.host">es33.uits.indiana.edu</SystemProperty>
		<SystemProperty name="dml.z3950.Container.port">2200</SystemProperty>
		<SystemProperty name="dml.z3950.Container.database">Unicorn</SystemProperty>
		<SystemProperty name="dml.z3950.Container.field.id.name">any</SystemProperty>

Warnings about dmlserver.xml at Variations server startup

When starting the Variations servers, you might get errors like the following:

Starting Variations Server ZINK_CATALOGING ... 
Warning: validation was turned on but an org.xml.sax.ErrorHandler was not
set, which is probably not what is desired.  Parser will use a default
ErrorHandler to print the first 10 errors.  Please call
the 'setErrorHandler' method to fix this.
Error: URI=file:/home/dmlserv/conf/server/dmlserver.xml Line=79: The content of element type "Library" must match "(SQLRepository,
UserProfileManager?,AuthenticationSchemes?,CronUsername?,ContentRepository+,FilenameScheme?,AudioProcessing?,ConnectionRules?,
ThemeBaseURL?,ScoreFileHandlerURL?,AccessPageDirectory?,SystemProperties?)".

Fix:
Modify the Library element tag in dmlserver.dtd to be the following:

<!ELEMENT Library ( SQLRepository, UserProfileManager?, AuthenticationSchemes?, CronUsername?, ContentRepository+ , FilenameScheme?,
AudioProcessing?, ScoreProcessing?, ConnectionRules?, ThemeBaseURL?, ScoreFileHandlerURL?, AccessPageDirectory?, SystemProperties? ) >

Playlist page in Variations User Guide does not switch to Mac or Print styles

Clicking on the Mac Version or Print Version links on the Playlist page in the Variations User Guide does nothing.

Fix:
Change the name of the included javascript file to js/styleswitch.js from javascript.js in public_html/use/playlist.html:

<script src="js/styleswitch.js" type="text/javascript">

Purge deleted metadata cron job does not run

The cron job for purgeDeletedMySqlMetadata.sh does not run.

Fix:
Fix the path by removing the nonexistent dml directory:

15 3 * * * ~/bin/cronRun.sh /home/dmlserv/bin/purgeDeletedMySqlMetadata.sh EXAMPLE_CATALOGING EXAMPLE_PRODUCTION > /home/dmlserv/log/purgeDeletedMetadata.EXAMPLE_PRODUCTION.log

Then update the installed crontab by running: crontab crontab

generateQTstats.pl cron job throws errors

Incorrect graphs are be generated and email is being sent to dmlserv containing errors like the following:

Use of uninitialized value in integer multiplication (*) at /home/dmlserv/bin/generateQTstats.pl line 213, <INPUT> line 78.
Use of uninitialized value in integer addition (+) at /home/dmlserv/bin/generateQTstats.pl line 213, <INPUT> line 78.

Fix:
Edit line 213 of ~/bin/generateQTstats.pl to be:

    my @currentTimes = split (/:/,$currentDateParts[4]);

POP and IMAP based authentication do not work

POP and IMAP based authentication does not work due to a missing library (mail.jar).

Fix:
Download mail.jar from the following link and place it in the lib directory (/home/dmlserv/lib/).
https://www.slashtmp.iu.edu/public/download.php?FILE=cjcolvar/17857eL64nm

Searching on single characters does not work

Searches like "sym 3" do not return "Symphony 3".

Fix:
As root, edit /etc/my.cnf by changing the ft_min_word_len value to 1 under both mysqld and mysqld_safe:

ft_min_word_len=1

Make sure Variations is stopped and restart mysql (as root): /etc/init.d/mysql restart
Then, as dmlserv run the following commands:

mysql -u dmlserv <library_name>_CATALOGING << SQL_END
    drop index textsearch on TextIndex;
    drop index keywordsearch on KeywordIndex;
    create fulltext index textsearch on TextIndex (text);
    create fulltext index keywordsearch on KeywordIndex (keywords);
SQL_END

mysql -u dmlserv <library_name>_PRODUCTION << SQL_END
    drop index textsearch on TextIndex;
    drop index keywordsearch on KeywordIndex;
    create fulltext index textsearch on TextIndex (text);
    create fulltext index keywordsearch on KeywordIndex (keywords);
SQL_END

You may now, restart your Variations servers.

  • No labels