How to Update to Variations 6.1 Client and Server
This page lists explains how to upgrade from 6.0 to 6.1 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 6.0 to 6.1
Note: The upgrade process will stop your Variations server. You will also have to allow time for some hand-editing of configuration files to preserve your local customizations. And finally you will have to restart your Variations server applications.
Before installing Variations 6.1, make sure that you have cleaned up your Variations 5 installation. See the Post-Install Cleanup section on How to Migrate to Variations 6.0 - In Place
To install the server update, execute the following commands from your Variations install directory, /home/dmlserv.
- Download the Variations_6.1_Server.tar.gz file to /home/dmlserv
- First, untar the server update file:
tar xvfz Variations_6.1_Server.tar.gz
- Then change directories to the update directory:
cd Variations_6.1
- Run the bin/initVariations.sh script with the values used for existing install (See instructions here for more information)
- Copy server configuration files:
cp /home/dmlserv/Variations-6.0/conf/server/accessPolicy.xml /home/dmlserv/Variations-6.1/conf/server/
cp /home/dmlserv/Variations-6.0/conf/server/dmlscript.conf /home/dmlserv/Variations-6.1/conf/server/
cp /home/dmlserv/Variations-6.0/conf/server/dmlserver.xml /home/dmlserv/Variations-6.1/conf/server/
- Copy vocabularies to new server:
cp /home/dmlserv/Variations-6.0/data/vocab/* /home/dmlserv/Variations-6.1/data/vocab/
- Copy files used by statistics:
cp /home/dmlserv/Variations-6.0/data/statistics/*.txt /home/dmlserv/Variations-6.1/data/statistics/
- Copy or merge any other files manually edited in old installation including the user guide (~/Variations-6.0/public_html/use/)
- If using CAS authentication, copy cas jars over from old installation:
cp /home/dmlserv/Variations-6.0/lib/cas* /home/dmlserv/Variations-6.1/lib/
- If using Kerberos authentication, copy krb5.conf over from old installation:
cp /home/dmlserv/Variations-6.0/conf/server/krb5.conf /home/dmlserv/Variations-6.1/conf/server/
- Update Apache aliases to point to new install (as root):
perl -pi -e 's/dmlserv\/Variations-6.0\/public_html/dmlserv\/Variations-6.1\/public_html/g' /etc/httpd/conf/httpd.conf
- Restart Apache (as root):
/etc/init.d/httpd restart
- (Re)start the Variations server application.
Make sure to merge any added entries to your crontab before replacing it.
- Replace crontab with 6.1 crontab:
crontab /home/dmlserv/Variations-6.1/bin/crontab
- If you have the webapps installed, then do the following"
- Create the symlink to the access pages:
ln -s /home/dmlserv/content/access/audio /home/dmlserv/Variations-6.1/public_html/audio-access
- Follow the instructions here to upgrade the webapps to 6.1
- Create the symlink to the access pages:
Step 2. Upgrade Variations clients from 6.0 to 6.1
Ideally, this should be done by creating a new Variations installer based on a Variations 6.1 client Windows zip or Mac tar.
- Download and unzip (or untar) the 6.1 client distribution
- Copy over any configuration files you modified for your 6.0 client. See Configuring the Client for a list of client configuration files. See Windows Client Changes and Mac Client Changes below for files that have changed in 6.1 and should be merged with 6.0 copies.
- Follow the directions in Building the Client Installer
Server Changes
File |
Change |
---|---|
~/COPYING |
Updated copyright to include 2011 |
~/VERSION |
Changed from 6.0 to 6.1 |
~/bin/generateQTstats.pl, ~/bin/generateStats.pl |
Fix bug where statistics might never be labeled as "in library" and web player statistics now displayed alongside client statistics |
~/conf/server/versions/EXAMPLE.versions |
Added support for 6.1* client version |
~/data/ServerLegalNotices.txt, ~/data/legal_notices.html |
Changed from 6.0 to 6.1; Updated copyright to include 2011; added new licenses |
~/docs/welcome.html |
Fix for Welcome window takes really long time to open |
~/lib/icu4j.jar, ~/lib/marc4j.jar, ~/lib/sunxacml.jar, ~/lib/xerces.jar, ~/lib/xercesImpl.jar, ~/lib/xml-apis.jar |
Updated included libraries |
~/public_html/userguide/use/apple_download.html, ~/public_html/userguide/use/download.html, ~/public_html/userguide/use/microsoft_download.html |
Changed version from 6.0 to 6.1 |
~/public_html/userguide/use/includes/footer.shtml |
Changed version from 6.0 to 6.1; Updated copyright to include 2011 |
~/server.jar |
Bug fixes and and other changes: |
Windows Client Changes
File |
Change |
---|---|
Program Files/Variations/Client/COPYING |
Updated copyright to include 2011 |
Program Files/Variations/Client/djvuencoder.jar |
Jar now includes icons for default encoding profiles |
Program Files/Variations/Client/encoder.conf, Program Files/Variations/Client/djvuencoder.conf, Program Files/Variations/Client/conf/client/client_file.lcf, Program Files/Variations/Client/conf/client/encoder.lcf |
Changed default paths and default logging so they work with Windows 7 |
Program Files/Variations/Client/readme.rtf |
Added version 6.1 to Revision History |
Program Files/Variations/Client/VERSION |
Changed from 6.0 to 6.1 |
Program Files/Variations/Client/data/legal_notices.html |
Changed from 6.0 to 6.1; Updated copyright to include 2011 |
Program Files/Variations/JRE |
Updated bundled JRE to 1.6.0_24 |
Program Files/Variations/Client/client.jar |
Bug fixes and other changes |
Mac Client Changes
File |
Change |
---|---|
Variations.app/Contents/Info.plist |
Changed from 6.0 to 6.1; Updated copyright to include 2011 |
Variations.app/Contents/Resources/Java/COPYING |
Updated copyright to include 2011 |
Variations.app/Contents/Resources/Java/VERSION |
Changed from 6.0 to 6.1 |
Variations.app/Contents/Resources/Java/client.jar |
Bug fixes and other changes |
Variations.app/Contents/Resources/Java/data/legal_notices.html |
Changed from 6.0 to 6.1; Updated copyright to include 2011 |
Variations.app/Contents/Resources/English.lproj/InfoPlist.strings |
Changed from 6.0 to 6.1; Updated copyright to include 2011 |
Terms-of-Use.html |
Changed from 6.0 to 6.1; Updated copyright to include 2011 |