Child pages
  • How to Update to Variations Webapps 6.2

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 Webapps 6.2

This page explains how to upgrade from 6.1 to 6.2 for the Variations web applications (Web Services, Web UI, and Access Manager). If you have any questions about or problems with the update process, please contact Chris Colvard (812-856-0026, cjcolvar@indiana.edu).

To see a list of changes, see the 6.2 changelog in our JIRA bug tracker:
https://bugs.dlib.indiana.edu/secure/ReleaseNote.jspa?projectId=10170&version=10627

Step 1. Upgrade the Variations Webapps from 6.1 to 6.2

Note: The upgrade process will stop your Variations web applications. 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 web applications.

To install the new webapps, execute the following commands from your tomcat directory, /usr/local/tomcat, as the user tomcat.

  1. Download the 6.2 version of variations-ws-server.war, variations-ui-web.war, and variation-mgmt-web.war.
  2. First, undeploy the existing webapps and back them up:
    mv /usr/local/tomcat/webapps/variations-ws-server.war /usr/local/tomcat/webapps/variations-ws-server.war.6.1
    mv /usr/local/tomcat/webapps/variations-ui-web.war /usr/local/tomcat/webapps/variations-ui-web.war.6.1
    mv /usr/local/tomcat/webapps/variations-mgmt-web.war /usr/local/tomcat/webapps/variations-mgmt-web.war.6.1
  3. Check that the webapps have been undeployed by seeing if the directories of the same name are gone: ls /usr/local/tomcat/webapps
  4. Deploy the downloaded webapps by copying them into tomcat's webapp directory
  5. Edit /usr/local/tomcat/conf/variations-ws-server/config.xml:
    1. Change the accessPolicy.xml path from /home/dmlserv/Variations-6.*/conf/server/accessPolicy.xml to /home/dmlserv/app/conf/server/accessPolicy.xml.
  6. Edit /usr/local/tomcat/conf/variations-ui-web/config.xml:
    1. Change the lease WS url and metadata WS url from http to https.
    2. Move and change the uiLoggingRemoteHost to be a system property instead of a servlet context attribute:
      -		<attribute>
      -			<name>uiLoggingRemoteHost</name>
      -			<value>example.example.edu</value>
      -		</attribute>
       	</servletcontext>
      +        <systemproperties>
      +                <systemproperty>
      +                        <name>uiLoggingRemoteHost</name>
      +                        <value>example.example.edu</value>
      +                </systemproperty>
      +        </systemproperties>
      
  7. Edit /usr/local/tomcat/conf/variations-mgmt-web/config.xml:
    1. Change the bibinfo WS url from http to https.
  8. Restart tomcat: bin/shutdown.sh; bin/startup.sh
  9. That's it! Check that the newly deployed webapps are functioning properly.
  • No labels