Configuring the Application Server

Installing and Upgrading the LongJump Application Platform

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

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. Start the Application Server
13. 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 LongJump to run, 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. Set the JAVA_HOME environment variable.
   For example:

   export JAVA_HOME=/opt/jdk1.6.0_nn/

6. Navigate to the directory one level above the directory that contains the application server.
   If the server dir is /opt/longjump/longjump_app_server, then

   cd /opt/longjump

7. Copy the upgrade file (longjump_app_server.vx.x.x.tar.gz) to this directory.
8. 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.

9. Enter cd longjump_app_server
10. Use a text editor to open the installation.properties file, and add the system details
11. Save the file and make a copy of it.
    The settings must be the same for subsequent upgrades.
12. Run the #./configure.pl script.
13. Start the Application Platform Server