Child pages
  • How to Update to Variations 5.0.3 Client and Server

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

How to Update to Variations 5.0.3 Client and Server

This page lists explains how to upgrade from 5.0.2 to 5.0.3 for both the Variations server and client. If you have any questions about or problems with the update process, please contact Chris Colvard (812-856-0026, cjcolvar@indiana.edu).

Step 1. Upgrade the Variations Servers from 5.0.2 to 5.0.3

Note: The upgrade process will stop your cataloging and production servers. You will also have to allow time for some hand-editing of configuration files to preserve your local customizations, as indicated by the output of the update script you will run. And finally you will have to restart your Variations server applications.

To install the server update, execute the following commands from your Variations install directory, /home/dmlserv.

  1. Download the Variations_5.0.3_Update.tar.gz file to /home/dmlserv
  2. First, untar the server update file: tar xvfz Variations_5.0.3_Update.tar.gz
  3. Then change directories to the update directory: cd Variations_5.0.3_Update
  4. Run the update script and create a log of its output: ./update.sh | tee -a update.sh.log
  5. Read through the output of the update script (also available in the log file, update.sh.log).
  6. Manually edit any files that did not patch correctly or need manual editing as noted by the update output.
    • Example versions of files that need to be manually edited can be found in /home/dmlserv/Variations_5.0.3_Update/.
  7. Fix conf/server/dmlserver.xml to be valid with new dmlserver.dtd:
    • Completely remove the Logging tags and its contents from the configuration for both <library_name>_CATALOGING and <library_name>_PRODUCTION
  8. Restart the Variations cataloging and production servers.
  9. For each multi-CD container previously ingested, open the container for editing from either the Digitizer or Admin tab and resave it
    • Saving the container will generate a new access page, fixing the offsets in the links (see Known Problems - 5.0.2 for more information)
  10. Fix the weekly statistics cronjob by editing dmlserv's crontab

Step 2. Upgrade Variations clients from 5.0.2 to 5.0.3

Ideally, this should be done by creating a new Variations installer based on a Variations 5.0.3 client Windows zip or Mac tar.

  1. Download and unzip (or untar) the 5.0.3 client distribution
  2. Copy over any configuration files you modified for your 5.0.2 client. See Configuring the Client - 5.0.7 for a list of client configuration files. See Windows Client Changes and Mac Client Changes below for files that have changed in 5.0.3 and should be merged with 5.0.2 copies.
  3. Follow the directions in Building the Client Installer - 5.0.7

Server Changes

File

Change

~/VERSION

Changed from 5.0.2 to 5.0.3

~/bin/generateQTstats.pl

Fixed bug that caused erratic behavior when processing log files during Daylight Savings Time changes; speed up improvements

~/bin/purgeDeletedMySqlMetadata.sh

Fixed bugs that caused this script to fail (see Known Problems - 5.0.2 for more information)

~/bin/v2run.sh

Removed dml.media.automaticAudioProcessing System Property since it is set elsewhere; Fixed value of java.rmi.server.codebase

~/conf/server/dmlserver.dtd (and ~/public_html/dmlserver.dtd by symbolic link)

Added optional outputDir attribute to AudioProcessing and ScoreProcessing tags

~/data/ServerLegalNotices.txt, ~/data/legal_notices.html

Changed from 5.0.2 to 5.0.3 and updated legal notices

~/data/accessPages/access.xsl, ~/data/accessPages/score-access.xsl

Generalized retrieval of cataloging id from container record

~/lib/jafer-client.jar

Updated version of jafer

~/public_html/use/apple_download.html

Fixed link to samples page; Fixed mime types

~/public_html/use/microsoft_download.html

Fixed link to samples page

~/server.jar

Bug fixes and other changes
See Variations3 Release 5.0.3 for more information.

Windows Client Changes

File

Change

Program Files/Variations/Client/djvuencoder.conf

Changed properties to work with new encoding profiles

Program Files/Variations/djvuencoder.jar

Updated version which allows encoding profiles

Program Files/Variations/Client/VERSION

Changed from 5.0.2 to 5.0.3

Program Files/Variations/Client/client.jar

Bug fixes and other changes
See Variations3 Release 5.0.3 for more information.

Program Files/Variations/Client/readme.rtf

Added versions 5.0.3 to Revision History; Added Vista to list of supported Windows versions

Program Files/Variations/Client/data/legal_notices.html

Changed from 5.0.2 to 5.0.3

Program Files/Variations/Client/data/search/ResultList-Containers.xsl, Program Files/Variations/Client/data/search/ResultList-Creators.xsl, Program Files/Variations/Client/data/search/ResultList-Instantiations.xsl, Program Files/Variations/Client/data/search/ResultList-Others.xsl, Program Files/Variations/Client/data/search/ResultList-Performers.xsl, Program Files/Variations/Client/data/search/ResultList-Works.xsl

Added ability to turn off paged searching

Program Files/Variations/Client/data/search/container_details.xsl

Fixed rendering in cases where there is zero, one, and more than one instantiation for a container

Program Files/Variations/Client/lib/jafer-client-development.jar

Updated version of jafer

Mac Client Changes

File

Change

Variations.app/Contents/Info.plist

Bumped version number to 5.0.3

Variations.app/Contents/Resources/Java/VERSION

Changed from 5.0.2 to 5.0.3

Variations.app/Contents/Resources/Java/client.jar

Bug fixes and other changes
See Variations3 Release 5.0.3 for more information.

Variations.app/Contents/Resources/Java/data/legal_notices.html

Changed from 5.0.2 to 5.0.3 and updated legal notices

Variations.app/Contents/Resources/Java/data/search/ResultList-Containers.xsl, Variations.app/Contents/Resources/Java/data/search/ResultList-Creators.xsl, Variations.app/Contents/Resources/Java/data/search/ResultList-Instantiations.xsl, Variations.app/Contents/Resources/Java/data/search/ResultList-Others.xsl, Variations.app/Contents/Resources/Java/data/search/ResultList-Performers.xsl, Variations.app/Contents/Resources/Java/data/search/ResultList-Works.xsl

Added ability to turn off paged searching

Variations.app/Contents/Resources/Java/data/search/container_details.xsl

Fixed rendering in cases where there is zero, one, and more than one instantiation for a container

Variations.app/Contents/Resources/Java/lib/jafer-client-development.jar

Modified previous version of jafer

Variations.app/Contents/Resources/English.lproj/InfoPlist.strings

Bumped version number to 5.0.3

Terms-of-Use.html

Changed from 5.0.2 to 5.0.3

Configuration Changes

Note that these configuration changes were mostly made to accommodate IU and nothing should need to be changed for test sites.

File

Change

conf/server/dmlserver.xml

Added dml.digitizer.audio.filecheck and dml.digitizer.score.filecheck SystemProperty tags to SystemProperties
For more information on this see the entry for these system properties in the list on the server configuration page.

conf/server/dmlserver.xml

An optional outputDir attribute was added to both the AudioProcessing and ScoreProcessing tags to specify the location where deliverable files will be stored at the end of the ingest processing process. The default behavior is for Variations to determine this location by looking at the file system usage statistics for each LeaseManager's ContentDir of a LeaseResource that matches the contentType needed.
If you choose to specify this location, you probably want /home/dmlserv/content/audio-objects/ for AudioProcessing and /home/dmlserv/content/score-objects/ for ScoreProcessing.

conf/server/dmlserver.xml

A SystemProperty has been added to turn off paged searching (dml.client.search.noPaging). This has been added for support of DB2 which cannot handle the SQL queries that allow for paged searching.
For more information on this see the entry for this system property in the list on the server configuration page.
We do not recommend turning off paged searching if you are using a MySql database.

  • No labels