Difference between revisions of "Configuring the Application Server"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 49: Line 49:
#[[Enabling and Disabling Backend Services#To Disable a service|Disable the Service]] on that server.
#[[Enabling and Disabling Backend Services#To Disable a service|Disable the Service]] on that server.
#Login to the server to be upgraded.
#Login to the server to be upgraded.
#[[Install the Chart Handling Libraries]]
#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>
Line 61: Line 62:
#Save the file and make a copy of it.<br/>''The settings must be the same for subsequent upgrades.''
#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.
#Run the <tt>#./configure.pl</tt> script.
#[[Install the Chart Handling Libraries]]
#[[#Start the Application Platform Server|Start the Application Platform Server]]
#[[#Start the Application Platform Server|Start the Application Platform Server]]




[[Category:Installation]]
[[Category:Installation]]

Revision as of 23:14, 18 April 2012

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:

  1. Review the Installable Version Release Notes.
  2. Login to a command shell
  3. 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/
  4. Go to the directory where the install will occur. For example:
    cd /opt/LongJump_platform
  5. Copy the archive to that directory.
  6. Unpack it: tar xvfz longjump_app_server.tar.gz
    The longjump_app_server/ folder is created.
  7. Go to the installation folder: cd longjump_app_server
  8. Edit installation.properties, to specify the settings for this instance.
  9. Save the file and make a copy of it.
    • The settings must be the same for subsequent upgrades.
  10. Run the installation script: #./configure.pl
    The application server is installed.
  11. Set up LONGJUMP_HOME
  12. Install the Chart Handling Libraries
  13. Start the Application Server
  14. 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.

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.6.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