Difference between revisions of "Upgrading the Application Server"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Β 
(25 intermediate revisions by the same user not shown)
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.}}
{{Important|<br>These are instructions are for version 10.5 and later.<br>If you are upgrading ''to'' 10.5, use the [[10.5 Upgrade Process]], instead.}}
Β 
# If you have not already done so:
;Considerations:
#* Review the [[Installable Version Release Notes]].
:* '''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>).
#* Ensure that the [[Hardware Requirements]] are met.
:* '''Prompted DB backup:''' During the upgrade, the platform prompts for a database backup.
#* Ensure that the [[Software Requirements#Required for Installation]] are met.
:* '''Installation folder:''' In a [[#First-Time Installation|First-Time Installation]], the application server is installed in <tt>longjump_app_server</tt>, by default:
#* Backup the platform databases.
::* If the application server is installed in a different directory, substitute that directory name in these instructions
# Use the standard SoftwareAG installer to install the 10.5 platform.<br>''Learn more:'' In [http://documentation.softwareag.com/webmethods/wmsuites/wmsuites_vers.htm webMethods documentation page] see the {{wM Ver}} Installation document.
::* If the <tt>install_dir</tt> parameter is specified in <tt>installation.properties</tt>, use that directory name in these instructions
# [[Start the Application Server]]
:* '''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.)
# When done, proceed to [[Configuring the Application Server]]
Β 
;To upgrade the platform:
#Check the [[Installable Version Release Notes]] for any version-specific preparation.
#Login to the server that is currently running the backend Scheduler service (Quartz).
#[[Enabling and Disabling Backend Services#To Disable a service|Disable the Service]] on that server.
#Login to the server to be upgraded.
#[[Install the Chart Handling Libraries]]
#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>

Latest revision as of 18:29, 22 September 2015

Warn.png

Important:
These are instructions are for version 10.5 and later.
If you are upgrading to 10.5, use the 10.5 Upgrade Process, instead.

  1. If you have not already done so:
  2. Use the standard SoftwareAG installer to install the 10.5 platform.
    Learn more: In webMethods documentation page see the 9.9 Installation document.
  3. Start the Application Server
  4. When done, proceed to Configuring the Application Server