Child pages
  • How to Update to Variations 5.0.1 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.1 Client and Server

This page lists explains how to upgrade from 5.0 to 5.0.1 for both the Variations server and client.

Step 1. Install the Metadata/Media update

Note: This step does not require restarting the cataloging or production servers. It does assume the servers are running during the update.
To install the metadata update with example audio content for testing, execute the following commands from your Variations install directory, /home/dmlserv.

  1. Download the metadata_update.tar.gz file to /home/dmlserv
  2. First, untar the metadata update file: tar xvfz metadata_update.tar.gz
  3. Then rename the records for your library: perl -pi -e 's/IU\//<library_name>\//g' example-metadata.xml
  4. Load the records into your Variations server: bin/loadDB.sh <library_name>_CATALOGING example-metadata.xml
  5. Finally, untar the audio content: tar xvfz example-content.tar.gz

You can test this update by starting a Variations client that connects to your cataloging server (e.g., a digitizer client), doing a basic search for composer=Mahler. By clicking on Mahler and then Symphony No. 3, you should be able to pick the test audio content and listen to it.

Step 2. Upgrade the Variations Servers from 5.0 to 5.0.1

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 restart your servers.

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

  1. Download the Variations_5.0.1_Update.tar.gz file to /home/dmlserv
  2. First, untar the server update file: tar xvfz Variations_5.0.1_Update.tar.gz
  3. Then change directories to the update directory: cd Variations_5.0.1_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.1_Update/.
  7. Apply the fix for single character searching found at Known Problems - 5.0#Searching on single characters does not work

Step 3. Upgrade Variations clients from 5.0 to 5.0.1

Ideally, this should be done by creating a new Variations installer based on a Variations 5.0.1 client zip or dmg. All that should need to be done is to copy (or merge) over the configuration files and installer builder scripts. See the changes listed in the table below, and on the following pages. for more information: Configuring the Client - 5.0.7 and Building the Client Installer - 5.0.7.

Server Changes

File

Change

~/VERSION

Changed from 5.0 to 5.0.1

~/COPYING

Changed Copyright date to include 2007

~/bin/

Removed references to Variations2 in scripts
These updates are non vital.

~/bin/crontab

Fixed incorrect path for purgeDeletedMySqlMetadata.sh
See Known Problems - 5.0#Purge deleted metadata cron job does not run for a fix.

~/bin/initVariations.sh

Changed to include automatic configuration of server's client files listed in previous line

~/bin/generateQTstats.pl

Fixed bug that caused incorrect graphs to be generated and email to be sent to dmlserv
See Known Problems - 5.0#generateQTstats.pl cron job throws errors for a fix.

~/conf/client/dml.conf, ~/conf/client/client_console.lcf, ~/conf/client/client_file.lcf

Changed to be versions that can be configured in initVariations.sh
See Configuring the Client - 5.0.7 for more information on configuring these files.

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

Added ScoreProcessing tag to dmlserver.dtd to ensure dmlserver.xml validates properly
See Known Problems - 5.0#Warnings about dmlserver.xml at Variations server startup for a fix.

~/conf/server/accessPolicy.xml

Added CREATE_METADATA, LOCK_METADATA, and DELETE_METADATA to default privileges given to Catalogers and Digitizers
See Known Problems - 5.0#Catalogers and Digitizers cannot CREATE_METADATA, LOCK_METADATA, or DELETE_METADATA with default accessPolicy.xml for a fix.

~/conf/server/dmlserver.xml

Removed AudioProcessing and ScoreProcessing tags from default production library configuration since this kind of processing should not be done on the production server
Renamed system properties dml.viewer.cataloglink.* to dml.client.cataloglink.* for View Details/Catalog Link changes throughout client
Set djvuProcessing to false for cataloging library by default since this is the expected normal operation (true would mean encoding tiffs to djvu files on the server)
Added system properties for Z39.50 lookup of MARC records for additional metadata during Access page generation
See Known Problems - 5.0#Generated Access pages will not include additional MARC metadata for a fix.

~/conf/server/versions/<library_name>_PRODUCTION.versions, ~/conf/server/versions/<library_name>_CATALOGING.versions

Added 5.0.* to list of clients that are allowed to connect

~/content/audio-objects/145585, ~/content/audio-objects/145586, metadata.tar.gz

Added a IU Jacob's School of Music performance for testing and seeding of collection
See Install the Metadata/Media update for instruction on ingesting this content.

~/data/ServerLegalNotices.txt

Changed from TRUNK to 5.0.1 and modified date to include 2007

~/lib/mail.jar

Added since it was missing in 5.0
See Known Problems - 5.0#POP and IMAP based authentication do not work for a fix.

~/public_html/use/playlist.html

Fixed path to javascript file
See Known Problems - 5.0#Playlist page in Variations User Guide does not switch to Mac or Print styles for a fix.

~/client.jar

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

~/server.jar

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

Windows Client Changes

File

Change

Program Files/Variations/Client/COPYING

Changed Copyright date to include 2007

Program Files/Variations/Client/VERSION

Changed from 5.0 to 5.0.1

Program Files/Variations/Client/client.jar

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

Program Files/Variations/Client/djvuencoder.conf

Changed default settings of ImageMagick's convert and DjVuLibre to produce cleaner images

Program Files/Variations/Client/readme.rtf

Added versions 5.0 and 5.0.1 to Revision History

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

Changed from TRUNK to 5.0.1

Program Files/Variations/Client/data/search/Search-Splash.xsl

Fixed small bug that caused problems in Java 1.5

Program Files/Variations/JRE

Changed bundled JRE to 1.5.0_11 for Windows Vista support

Mac Client Changes

File

Change

Variations.app/Content/Resources/Java/COPYING

Added this file and changed Copyright date to include 2007

Variations.app/Content/Resources/Java/VERSION

Changed from 5.0 to 5.0.1

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

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

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

Changed from TRUNK to 5.0.1

Variations.app/Content/Resources/Java/data/search/Search-Splash.xsl

Fixed small bug that caused problems in Java 1.5

Variations.app/Contents/Info.plist

Bumped version number to 5.0.1 and yer to 2007; Change JRE version used to 1.5*

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

Bumped version number to 5.0.1 and yer to 2007

Important-Installation-Instructions.html

Edited for Variations 5.0.1

Terms-of-Use.html

Edited for Variations 5.0.1

  • No labels