How to Update to Variations 5.0.6 Client and Server
This page lists explains how to upgrade from 5.0.5 to 5.0.6 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.5 to 5.0.6
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.
- Download the Variations_5.0.6_Update.tar.gz file to /home/dmlserv
- First, untar the server update file:
tar xvfz Variations_5.0.6_Update.tar.gz
- Then change directories to the update directory:
cd Variations_5.0.6_Update
- Run the update script and create a log of its output:
./update.sh | tee -a update.sh.log
- Read through the output of the update script (also available in the log file, update.sh.log).
- 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.6_Update/.
- Restart the Variations cataloging and production servers.
Step 2. Upgrade Variations clients from 5.0.5 to 5.0.6
Ideally, this should be done by creating a new Variations installer based on a Variations 5.0.6 client Windows zip or Mac tar.
- Download and unzip (or untar) the 5.0.6 client distribution
- Copy over any configuration files you modified for your 5.0.5 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.6 and should be merged with 5.0.5 copies.
- Follow the directions in Building the Client Installer - 5.0.7
Server Changes
File |
Change |
---|---|
~/COPYING, ~/public_html/use/legal.html, ~/public_html/use/includes/footer.shtml |
Changed copyright license text |
~/VERSION |
Changed from 5.0.5 to 5.0.6 |
~/bin/libapp-passwordless.sh |
Convenience script |
~/conf/server/dmlserver.dtd, ~/conf/server/dmlserver.xml |
Added user database name configuration point |
~/data/ServerLegalNotices.txt, ~/data/legal_notices.html |
Changed from 5.0.5 to 5.0.6 |
~/lib/dom.jar, ~/lib/jaxp-api.jar, ~/lib/xalan.jar |
Updated and new libraries for DRAM support |
~/server.jar |
Bug fixes and other changes:
|
Windows Client Changes
File |
Change |
---|---|
Program Files/Variations/Client/COPYING |
Changed copyright text |
Program Files/Variations/Client/VERSION |
Changed from 5.0.5 to 5.0.6 |
Program Files/Variations/Client/client.jar |
Bug fixes, MP4 encoder improvements, DRAM support, and other changes |
Program Files/Variations/Client/readme.rtf |
Added version 5.0.6 to Revision History |
Program Files/Variations/Client/data/legal_notices.html |
Changed from 5.0.5 to 5.0.6 |
Program Files/Variations/Client/data/search/ResultList-Works.xsl |
Small change to fix themes |
Program Files/Variations/Client/encoder.conf |
Added mp4creatorPath property and other example configuration properties |
Program Files/Variations/Client/lib/jsch-0.1.39.jar |
Added library for refactored mp4 encoder utility |
Program Files/Variations/Client/lib/xalan.jar |
Updated library version |
Program Files/Variations/Client/resources/admin/mp4creator.exe |
Added utility used to hint mp4 files in mp4 encoder |
Mac Client Changes
File |
Change |
---|---|
Variations.app/Contents/Info.plist |
Bumped version number to 5.0.6 |
Variations.app/Contents/Resources/English.lproj/InfoPlist.strings |
Bumped version number to 5.0.6 |
Variations.app/Contents/Resources/Java/COPYING |
Changed copyright text |
Variations.app/Contents/Resources/Java/VERSION |
Changed from 5.0.5 to 5.0.6 |
Variations.app/Contents/Resources/Java/client.jar |
Bug fixes, DRAM support and other changes |
Variations.app/Contents/Resources/Java/data/legal_notices.html |
Changed from 5.0.5 to 5.0.6 |
Variations.app/Contents/Resources/Java/data/search/ResultList-Works.xsl |
Small change to fix themes |
Variations.app/Contents/Resources/Java/lib/xalan.jar |
Updated library version |
Terms-of-Use.html |
Changed from 5.0.5 to 5.0.6 |
Configuration Changes
Note that these configuration changes were mostly made to avoid unnecessary configuration work and confusion for new installations of Variations. No action needs to be taken because of these changes.
File |
Change |
---|---|
conf/server/dmlserver.xml |
Added SchemaName tag to UserProfileManager tag to allow for user databases named differently than DMLLIB |