Difference between revisions of "Upgrading the Application Server"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 1: Line 1:
{{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. <tt>longjump_app_server</tt>).
:* '''Prompted DB backup:''' During the upgrade, the platform prompts for a database backup.
:* '''Installation folder:''' In a [[#First-Time Installation|First-Time Installation]], the application server is installed in <tt>longjump_app_server</tt>, by default:
::* If the application server is installed in a different directory, substitute that directory name in these instructions
::* If the <tt>install_dir</tt> parameter is specified in <tt>installation.properties</tt>, 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 [[Enabling and Disabling Backend Services#To Disable a service|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:
;To upgrade the platform:
#Check the [[Installable Version Release Notes]] for any version-specific preparation.
# Check the [[Installable Version Release Notes]] for any version-specific preparation.
#Login to the server that is currently running the backend Scheduler service (Quartz).
# ...SAG upgrade step...
#[[Enabling and Disabling Backend Services#To Disable a service|Disable the Service]] on that server.
# [[Install the Chart Handling Libraries]] Β 
#Login to the server to be upgraded.
# {{TBD|and anything else...}}
#[[Install the Chart Handling Libraries]]
# [[#Start the Application Platform Server|Start the Application Platform Server]]
#Set the <tt>JAVA_HOME</tt> environment variable.<br/>For example:
#:<tt>export JAVA_HOME=/opt/jdk1.7.0_nn/</tt>
#Navigate to the directory one level above the directory that contains the application server.<br/>If the server dir is <tt>/opt/{{BrandLabel}}_platform/longjump_app_server</tt>, then
#:<tt>cd /opt/{{BrandLabel}}_platform</tt>
#Copy the upgrade file (<tt>longjump_app_server.vx.x.x.tar.gz</tt>) to this directory.
#In a command-line interface window, enter this command:
#:: <tt>tar xvfz longjump_app_server.vx.x.x.tar.gz --overwrite</tt>
#: The <tt>longjump_app_server/</tt> folder is overwritten.
#Enter <tt>cd longjump_app_server</tt>
#Use a text editor to open the <tt>[[installation.properties]]</tt> file, and add the system details
#Save the file and make a copy of it.<br/>''The settings must be the same for subsequent upgrades.''
#Run the <tt>#./configure.pl</tt> script.
#[[#Start the Application Platform Server|Start the Application Platform Server]]
<noinclude>
<noinclude>


[[Category:Installation]]
[[Category:Installation]]
</noinclude>
</noinclude>

Revision as of 22:10, 18 September 2015

To upgrade the platform
  1. Check the Installable Version Release Notes for any version-specific preparation.
  2. ...SAG upgrade step...
  3. Install the Chart Handling Libraries
  4. __TBD: and anything else...__
  5. Start the Application Platform Server