Upgrading the Application Server

From AgileApps Support Wiki
Revision as of 22:45, 2 August 2013 by imported>Aeric (Text replace - '1.6' to '1.7')

If this is the first time the platform is being installed on this server, follow the instructions at First-Time Installation. Otherwise, follow the process described here.

Warn.png

Important: Before beginning the upgrade process, copy the installation options in the existing installation.properties file. The values specified during the upgrade must be consistent with those defined for the previous version.

Considerations
  • Automatic tomcat backup: The upgrade script automatically backs up the installation's tomcat subdirectory. It does not backup applications or user data. For safety, back up the entire installation directory (e.g. longjump_app_server).
  • Prompted DB backup: During the upgrade, the platform prompts for a database backup.
  • Installation folder: In a First-Time Installation, the application server is installed in longjump_app_server, by default:
  • If the application server is installed in a different directory, substitute that directory name in these instructions
  • If the install_dir parameter is specified in installation.properties, use that directory name in these instructions
  • Quartz is enabled on every install: The Scheduler service is required for platform operations, so it is enabled on every install, whether it is a fresh install or an upgrade. In consequence, you should Disable the Service wherever it is currently running, before doing the upgrade. (If you are upgrading multiple servers, Quartz needs to be disabled on each server, in turn.)
To upgrade the platform
  1. Check the Installable Version Release Notes for any version-specific preparation.
  2. Login to the server that is currently running the backend Scheduler service (Quartz).
  3. Disable the Service on that server.
  4. Login to the server to be upgraded.
  5. Install the Chart Handling Libraries
  6. Set the JAVA_HOME environment variable.
    For example:
    export JAVA_HOME=/opt/jdk1.7.0_nn/
  7. Navigate to the directory one level above the directory that contains the application server.
    If the server dir is /opt/LongJump_platform/longjump_app_server, then
    cd /opt/LongJump_platform
  8. Copy the upgrade file (longjump_app_server.vx.x.x.tar.gz) to this directory.
  9. In a command-line interface window, enter this command:
    tar xvfz longjump_app_server.vx.x.x.tar.gz --overwrite
    The longjump_app_server/ folder is overwritten.
  10. Enter cd longjump_app_server
  11. Use a text editor to open the installation.properties file, and add the system details
  12. Save the file and make a copy of it.
    The settings must be the same for subsequent upgrades.
  13. Run the #./configure.pl script.
  14. Start the Application Platform Server