How to Update to Variations 6.2 Client and Server
This page lists explains how to upgrade from 6.* to 6.2 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.* to 6.2
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.2, 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
Before starting the installation process, create the VARIATIONS_HOME environment variable and make sure it is set properly:
As root, create /etc/profile.d/variations.sh with this content:
export VARIATIONS_HOME=/home/dmlserv export PATH=$VARIATIONS_HOME/app/bin:$PATH
Once VARIATIONS_HOME has been set (logout, log back in, and check with echo $VARIATIONS_HOME
), run the following as root to let SELinux know the proper file contexts for Variations files. Whenever the system performs a relabeling SELinux will use these rules to set the contexts instead of using a default context which would make Variations be blocked by the SELinux policy. You can manually force a relabel using the restorecon command: restorecon -R -v ${VARIATIONS_HOME
}
The semanage commands may throw error messages about tomcat if you have the Variations webapps installed. These messages can be safely ignored.
semanage fcontext -a -t httpd_sys_content_t "${VARIATIONS_HOME}" semanage fcontext -a -t httpd_sys_content_t "${VARIATIONS_HOME}/content(/.*)?" semanage fcontext -a -t httpd_sys_content_t "${VARIATIONS_HOME}/Variations-[^/]*/conf(/.*)?" semanage fcontext -a -t httpd_sys_content_t "${VARIATIONS_HOME}/Variations-[^/]*/data(/.*)?" semanage fcontext -a -t httpd_sys_content_t "${VARIATIONS_HOME}/Variations-[^/]*/public_html(/.*)?" semanage fcontext -a -t httpd_sys_script_exec_t "${VARIATIONS_HOME}/Variations-[^/]*/public_html/cgi-bin(/.*)?"
Now log back in as dmlserv and check that your VARIATIONS_HOME matches your install location: echo $VARIATIONS_HOME
To install the server update, execute the following commands from your Variations install directory, /home/dmlserv.
- Download the Variations_6.2_Server.tar.gz file to /home/dmlserv
- First, untar the server update file:
tar xvfz Variations_6.2_Server.tar.gz
- Then create a symbolic link to the new application directory:
ln -s Variations-6.2 app
- Then change directories to the new application directory:
cd app
- Run the 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.1/conf/server/accessPolicy.xml /home/dmlserv/app/conf/server/
cp /home/dmlserv/Variations-6.1/conf/server/dmlscript.conf /home/dmlserv/app/conf/server/
cp /home/dmlserv/Variations-6.1/conf/server/dmlserver.xml /home/dmlserv/app/conf/server/
- Update paths in configuration files to use new symlink:
perl -pi -e 's@/home/dmlserv/Variations-[^/]*@/home/dmlserv/app@' /home/dmlserv/app/conf/server/*.*
- Copy vocabularies to new server:
cp /home/dmlserv/Variations-6.1/data/vocab/* /home/dmlserv/app/data/vocab/
- Copy files used by statistics:
cp /home/dmlserv/Variations-6.1/data/statistics/*.txt /home/dmlserv/app/data/statistics/
- Copy or merge any other files manually edited in old installation including the user guide (~/Variations-6.1/public_html/use/)
- If using CAS authentication, copy cas jars over from old installation:
cp /home/dmlserv/Variations-6.1/lib/cas* /home/dmlserv/app/lib/
- If using Kerberos authentication, copy krb5.conf over from old installation:
cp /home/dmlserv/Variations-6.1/conf/server/krb5.conf /home/dmlserv/app/conf/server/
- Replace the Variations configuration block in /etc/httpd/conf/httpd.conf with the following (as root):
# # Variations specific configuration # ScriptAlias /variations/cgi-bin/ "${VARIATIONS_HOME}/app/public_html/cgi-bin/" <Directory "${VARIATIONS_HOME}/app/public_html/cgi-bin"> AllowOverride All Options FollowSymLinks Order allow,deny Allow from all SetEnv VARIATIONS_HOME ${VARIATIONS_HOME} </Directory> Alias /variations/ "${VARIATIONS_HOME}/app/public_html/" <Directory "${VARIATIONS_HOME}/app/public_html"> AllowOverride All Options FollowSymLinks Order allow,deny Allow from all SetEnv VARIATIONS_HOME ${VARIATIONS_HOME} </Directory>
- (As root) Edit /etc/sysconfig/httpd by adding the following line: source /etc/profile.d/variations.sh
Make sure that the $VARIATIONS_HOME environment variable is set for root when restarting Apache.
- 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.2 crontab:
crontab /home/dmlserv/app/bin/variations.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/app/public_html/audio-access
- Follow the instructions here to upgrade the webapps to 6.2
- Create the symlink to the access pages:
Step 2. Upgrade Variations clients from 6.* to 6.2
Ideally, this should be done by creating a new Variations installer based on a Variations 6.2 client Windows zip or Mac tar.
- Download and unzip (or untar) the 6.2 client distribution
- Copy over any configuration files you modified for your 6.* 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.2 and should be merged with 6.* copies.
- Follow the directions in Building the Client Installer
Server Changes
File |
Change |
---|---|
VERSION |
Changed from 6.1 to 6.2 |
bin/*, conf/*, data/*, public_html/* |
Many changes to scripts and configuration files allowing Variations to be installed anywhere on the filesystem as well as other bug fixes and changes. |
conf/server/versions/EXAMPLE.versions |
Added support for 6.2* client version |
data/ServerLegalNotices.txt, data/legal_notices.html |
Changed from 6.1 to 6.2 |
public_html/userguide/use/apple_download.html, public_html/userguide/use/download.html, public_html/userguide/use/microsoft_download.html |
Changed version from 6.1 to 6.2 |
public_html/userguide/use/includes/footer.shtml |
Changed version from 6.1 to 6.2 |
server.jar |
Bug fixes and and other changes: |
Windows Client Changes
File |
Change |
---|---|
Program Files/Variations/Variations.cmd, Program Files/Variations/Variations-debug.cmd, Program Files/Variations/Variations-encoder.cmd |
Changing default logging path to be more Windows version independent |
Program Files/Variations/Client/conf/client/dml.conf |
Commented out default wav and tiff directories |
Program Files/Variations/Client/conf/client/client-file.lcf, Program Files/Variations/Client/conf/client/encoder.lcf |
Changing default logging path to be more Windows version independent |
Program Files/Variations/Client/readme.rtf |
Added version 6.2 to Revision History |
Program Files/Variations/Client/VERSION |
Changed from 6.1 to 6.2 |
Program Files/Variations/Client/data/legal_notices.html |
Changed from 6.1 to 6.2 |
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/Resources/Java/conf/client/dml.conf |
Commented out default wav and tiff directories |
Variations.app/Contents/Info.plist |
Changed from 6.1 to 6.2, Changing default logging path |
Variations.app/Contents/Resources/Java/VERSION |
Changed from 6.1 to 6.2 |
Variations.app/Contents/Resources/Java/client.jar |
Bug fixes and other changes |
Variations.app/Contents/Resources/Java/data/legal_notices.html |
Changed from 6.1 to 6.2 |
Variations.app/Contents/Resources/English.lproj/InfoPlist.strings |
Changed from 6.1 to 6.2 |
Terms-of-Use.html |
Changed from 6.1 to 6.2 |