imported>Aeric |
imported>Aeric |
| (27 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| If this is the first time the platform is being installed on this server, follow the instructions at [[#First-Time Installation|First-Time Installation]].
| | {{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.}} |
| Otherwise, follow the process described here.
| | # If you have not already done so: |
| | | #* Review the [[Installable Version Release Notes]]. |
| {{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.}} | | #* Ensure that the [[Hardware Requirements]] are met. |
| | | #* Ensure that the [[Software Requirements#Required for Installation]] are met. |
| ;Considerations:
| | #* Backup the platform databases. |
| :* '''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>).
| | # 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. |
| :* '''Prompted DB backup:''' During the upgrade, the platform prompts for a database backup.
| | # [[Start the Application Server]] |
| :* '''Installation folder:''' In a [[#First-Time Installation|First-Time Installation]], the application server is installed in <tt>longjump_app_server</tt>, by default:
| | # When done, proceed to [[Configuring the Application Server]] |
| ::* 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:
| |
| #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.6.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> |
