Difference between revisions of "Installing and Upgrading the Application Server"
From LongJump Support Wiki
imported>Aeric |
imported>Aeric |
||
| Line 17: | Line 17: | ||
#:<tt>export JAVA_HOME=/opt/jdk1.6.0_nn/</tt> | #:<tt>export JAVA_HOME=/opt/jdk1.6.0_nn/</tt> | ||
#Go to the directory where the install will occur. For example: | #Go to the directory where the install will occur. For example: | ||
#:<tt>cd /opt/ | #:<tt>cd /opt/{{BrandLabel}}_platform</tt> | ||
#Copy the archive to that directory. | #Copy the archive to that directory. | ||
#Unpack it: <tt>tar xvfz longjump_app_server.tar.gz</tt><br/>The <tt>longjump_app_server/</tt> folder is created. | #Unpack it: <tt>tar xvfz longjump_app_server.tar.gz</tt><br/>The <tt>longjump_app_server/</tt> folder is created. | ||
| Line 41: | Line 41: | ||
::* If the application server is installed in a different directory, substitute that directory name in these instructions | ::* 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 | ::* 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 | :* '''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: | ||
| Line 50: | Line 50: | ||
#Set the <tt>JAVA_HOME</tt> environment variable.<br/>For example: | #Set the <tt>JAVA_HOME</tt> environment variable.<br/>For example: | ||
#:<tt>export JAVA_HOME=/opt/jdk1.6.0_nn/</tt> | #:<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/ | #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/ | #:<tt>cd /opt/{{BrandLabel}}_platform</tt> | ||
#Copy the upgrade file (<tt>longjump_app_server.vx.x.x.tar.gz</tt>) to this directory. | #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: | #In a command-line interface window, enter this command: | ||
Revision as of 17:21, 7 June 2011
Installing and Upgrading the Application Server
The Application Server is provided as a compressed Linux file: longjump_app_server.tar.gz. The file must be unpacked (uncompressed). Instructions are provided for First-Time Installation and Upgrades.
- Considerations
- By default, the application server is installed to this destination directory: /~dirname/longjump_app_server, where /~dirname is defined in installation.properties as the install_dir parameter
- Upgrades to the application server should use the same destination directory
- Unpacking the .tar.gz file overwrites the longjump_app_server file in the destination directory
- Optionally, specify an install_dir path in the installation.properties file
- This destination path should be used for future upgrades
First-Time Installation
If the platform has been previously installed on this server, follow the instructions at Upgrades. Otherwise:
- Review the Installable Version Release Notes.
- Login to a command shell
- Set the JAVA_HOME environment variable used by the installation/upgrade script to create configuration settings. For example:
- export JAVA_HOME=/opt/jdk1.6.0_nn/
- Go to the directory where the install will occur. For example:
- cd /opt/LongJump_platform
- Copy the archive to that directory.
- Unpack it: tar xvfz longjump_app_server.tar.gz
The longjump_app_server/ folder is created. - Go to the installation folder: cd longjump_app_server
- Edit installation.properties, to specify the settings for this instance.
- Save the file and make a copy of it.
- The settings must be the same for subsequent upgrades.
- Run the installation script: #./configure.pl
The application server is installed. - Set up LONGJUMP_HOME
- Start the Application Server
- Request a Platform License for each instance of the Application Server
Upgrades
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.
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
- Check the Installable Version Release Notes for any version-specific preparation.
- Login to the server that is currently running the backend Scheduler service (Quartz).
- Disable the Service on that server.
- Login to the server to be upgraded.
- Set the JAVA_HOME environment variable.
For example:- export JAVA_HOME=/opt/jdk1.6.0_nn/
- 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
- Copy the upgrade file (longjump_app_server.vx.x.x.tar.gz) to this directory.
- 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.
- Enter cd longjump_app_server
- Use a text editor to open the installation.properties file, and add the system details
- Save the file and make a copy of it.
The settings must be the same for subsequent upgrades. - Run the #./configure.pl script.
- Start the Application Platform Server