Installing a New Application Server

From AgileApps Support Wiki
Revision as of 23:35, 17 September 2015 by imported>Aeric

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
  • All database servers and web servers must be configured to be in the same timezone, regardless of where they are geographically located.
  • By default, the application server is installed to this destination directory: /~dirname/longjump_app_server,
    where /~dirname is defined in installation.properties as the default 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.
    That destination path should be used for future upgrades, as well.

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.7.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.
  8. Edit the installation.properties file 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
    (These libraries can also be added later. They are required to email a chart or report.)
  13. Start the Application Server

Additional Steps

If you plan to enabled Java Code Governors in this installation, and you are installing on Red Hat 6, be sure to carry out the Additional Installation Step for RedHat 6.