Child pages
  • How to Update to Variations 6.3 Client and Server

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

How to Update to Variations 6.3 Client and Server

This page lists explains how to upgrade from 6.2 to 6.3 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.3

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 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:

No Format
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}

Note

The semanage commands may throw error messages about tomcat if you have the Variations webapps installed. These messages can be safely ignored.

Code Block
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.

  1. Download the Variations_6.3_Server.tar.gz file to /home/dmlserv
  2. First, untar the server update file: tar xvfz Variations_6.3_Server.tar.gz
  3. Then create a symbolic link to the new application directory: rm app; ln -s Variations-6.3 app
  4. Then change directories to the new application directory: cd app
  5. Run the initVariations.sh script with the values used for existing install (See instructions here for more information)
  6. Copy server configuration files:
    cp /home/dmlserv/Variations-6.2/conf/server/accessPolicy.xml /home/dmlserv/app/conf/server/
    cp /home/dmlserv/Variations-6.2/conf/server/dmlscript.conf /home/dmlserv/app/conf/server/
    cp /home/dmlserv/Variations-6.2/conf/server/dmlserver.xml /home/dmlserv/app/conf/server/

  7. Copy vocabularies to new server: cp /home/dmlserv/Variations-6.2/data/vocab/* /home/dmlserv/app/data/vocab/
  8. Copy files used by statistics: cp /home/dmlserv/Variations-6.2/data/statistics/*.txt /home/dmlserv/app/data/statistics/
  9. Copy or merge any other files manually edited in old installation including the user guide (~/Variations-6.2/public_html/use/)
  10. If using CAS authentication, copy cas jars over from old installation: cp /home/dmlserv/Variations-6.2/lib/cas* /home/dmlserv/app/lib/
  11. If using Kerberos authentication, copy krb5.conf over from old installation: cp /home/dmlserv/Variations-6.2/conf/server/krb5.conf /home/dmlserv/app/conf/server/

  12. (Re)start the Variations server application.

  13. If you have the webapps installed, then do the following:
    1. Create the symlink to the access pages: ln -s /home/dmlserv/content/access/audio /home/dmlserv/app/public_html/audio-access
    2. Follow the instructions here to upgrade the webapps to 6.3

Step 2. Upgrade Variations Windows clients from 6.* to 6.3

(Note: the Mac client has no changes, so the 6.2 client can still be used)

Ideally, this should be done by creating a new Variations installer based on a Variations 6.2 client Windows zip.

  1. Download and unzip (or untar) the 6.3 client distribution
  2. 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 below for files that have changed in 6.3 and should be merged with 6.* copies.
  3. Follow the directions in Building the Client Installer

Server Changes

File

Change

VERSION

Changed from 6.2 to 6.3

conf/server/versions/EXAMPLE.versions

Added support for 6.3* client version

data/ServerLegalNotices.txt, data/legal_notices.html

Changed from 6.2 to 6.3

public_html/userguide/use/apple_download.html, public_html/userguide/use/download.html, public_html/userguide/use/microsoft_download.html

Changed version from 6.2 to 6.3

public_html/userguide/use/includes/footer.shtml

Changed version from 6.2 to 6.3

server.jar

Bug fixes and and other changes:
See Variations Release 6.3 for more information.

Windows Client Changes

File

Change

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
See Variations Release 6.3 for more information.

Program Files/Variations/Client/lib/log4j-1.2.16.jarUpdated log4j version