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

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

Step 1. Upgrade the Variations Servers from 5.0.1 to 5.0.2

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.2_Update.tar.gz file to /home/dmlserv
  2. First, untar the server update file: tar xvfz Variations_5.0.2_Update.tar.gz
  3. Then change directories to the update directory: cd Variations_5.0.2_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.2_Update/.
  7. Install the DateTime perl module (as root) needed for bug fix: cpan -i DateTime

Step 2. Upgrade Variations clients from 5.0.1 to 5.0.2

Ideally, this should be done by creating a new Variations installer based on a Variations 5.0.2 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

~/COPYING

Small formatting change

~/VERSION

Changed from 5.0.1 to 5.0.2

~/bin/checkVariations.sh, ~/bin/startVariations.sh, ~/bin/stopVariations.sh

Commented out references to deprecated score file handler
These updates are non vital.

~/bin/generateAccessPage.sh, ~/bin/dumpUsers.sh

Fixed broken client login which caused infinite loop

~/bin/generateQTstats.pl

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

~/bin/run_RMIRegistry.sh, ~/bin/v2run.sh

Removed common.jar and client.jar from classpath since all server client code is now in server.jar

~/bin/sfmapp.sh

Removed score file handler start script because this feature is deprecated

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

Added suffixFormat attribute to FilenameScheme tag and optional label attribute to AuthenticationScheme tag
Examples of these can be found in dmlserver.xml

~/conf/server/dmlserver.xml

Added examples of new suffixFormat attribute in FilenameScheme tag, label attribute in AuthenticationScheme tag, and dml.digitizer.csws.url system property
See Authentication, Filenaming Schemes, and System Properties respectively for more details on usage.

~/conf/server/net-sf-jpam

Added example JPam pam configuration file
See Pam Authentication through JPam on how to use pam with Variations.

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

Changed from 5.0.1 to 5.0.2 and updated legal notices

~/lib/casproxy_iu.jar, ~/lib/casproxy_umd.jar

Moved CAS login proxy implementations to site specific jars. Remove any of these that are not needed by your institution. When using CAS authentication, only one of these jars should be present in the lib directory!

~/lib/commons-codec-1.3.jar, ~/lib/commons-httpclient-3.0.1.jar

New libraries added for updated CAS authentication code

~/lib/commons-logging-1.1.jar, ~/lib/JPam-1.1.jar

New libraries to support authentication through pam
See Pam Authentication through JPam on how to use pam with Variations.

~/lib/log4j-1.2.3.jar, ~/lib/log4j-1.2.14.jar

Updated version of log4j to 1.2.14 and removed older version (1.2.3)

~/lib/jafer-client.jar, ~/lib/zebulun.jar

Updated version of jafer

~/lib/saxon.jar

Updated version of saxon

~/public_html/use/legal.html

Updated legal notices

~/public_html/use/search.html, ~/public_html/use/mac_noresults.gif, ~/public_html/use/mac_search.gif, ~/public_html/use/search-noresults.gif, ~/public_html/use/search-screen.gif, ~/public_html/search-toomanyresults.gif

Updated search page of user guide

~/public_html/use/playlist.html, ~/public_html/use/editplaylist.gif, ~/public_html/use/mac-editplaylist.gif, ~/public_html/use/mac-playlist.gif

Updated playlist page of user guide

~/client.jar

Removed this jar from the release. All client code needed by the server is now bundled in server.jar

~/server.jar

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

Windows Client Changes

File

Change

Program Files/Variations/Variations-diagnostic.cmd

Removed since this tool is no longer supported
See Known Problems - 5.0.1#Variations-diagnostic tool does not find streaming resource for more information.

Program Files/Variations/djvuencoder.jar

Updated version which allows color djvu encoding

Program Files/Variations/Client/COPYING

Small formatting change

Program Files/Variations/Client/VERSION

Changed from 5.0.1 to 5.0.2

Program Files/Variations/Client/client.jar

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

Program Files/Variations/Client/readme.rtf

Added versions 5.0.2 to Revision History

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

Changed from 5.0.1 to 5.0.2 and updated legal notices

Program Files/Variations/Client/lib/commons-httpclient-3.0.1.jar,
Program Files/Variations/Client/lib/commons-codec-1.3.jar,
Program Files/Variations/Client/lib/swing-worker-1.1.jar,
Program Files/Variations/Client/lib/external_metadata/*

Added libraries to support the improved Import Tracks dialog

Program Files/Variations/Client/lib/jni/Windows/DMLDjVu.dll

Updated version of the DjVu decoding library

Program Files/Variations/Client/lib/jafer-client.jar, Program Files/Variations/Client/lib/zebulun.jar

Updated version of jafer

Program Files/Variations/Client/lib/log4j-1.2.14.jar

Updated version of log4j

Program Files/Variations/Client/lib/saxon.jar

Updated version of saxon

Program Files/Variations/Client/resources/admin/itemRenderer.xsl

Added XSLT that is used in updated Import Tracks dialog

Program Files/Variations/JRE

Changed bundled JRE to 1.5.0_12

Mac Client Changes

File

Change

Variations.app/Contents/Resources/Java/COPYING

Small formatting change

Variations.app/Contents/Resources/Java/VERSION

Changed from 5.0.1 to 5.0.2

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

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

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

Changed from 5.0.1 to 5.0.2 and updated legal notices

Variations.app/Contents/Resources/Java/lib/log4j-1.2.14.jar

Updated version of log4j

Variations.app/Contents/Resources/Java/lib/saxon.jar

Updated version of saxon

Variations.app/Contents/Resources/Java/lib/jni/Mac/libDMLDjVu.jnilib

Updated version of the DjVu decoding library

Variations.app/Contents/Info.plist

Bumped version number to 5.0.2

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

Bumped version number to 5.0.2

Terms-of-Use.html

Edited for Variations 5.0.2

  • No labels