Difference between revisions of "Installing a New Application Server"

From AgileApps Support Wiki
imported>Aeric
imported>Aeric
Line 2: Line 2:


;Considerations:
;Considerations:
*By default, the application server is installed to this destination directory: <tt>/~dirname/longjump_app_server</tt>, where <tt>/~dirname</tt> is defined in <tt>installation.properties</tt> as the <tt>install_dir</tt> parameter
*By default, the application server is installed to this destination directory: <tt>/~dirname/longjump_app_server</tt>,<br>where <tt>/~dirname</tt> is defined in <tt>installation.properties</tt> as the <tt>install_dir</tt> parameter
*Upgrades to the application server should use the same destination directory
*Upgrades to the application server should use the same destination directory
*Unpacking the <tt>.tar.gz</tt> file overwrites the <tt>longjump_app_server</tt> file in the destination directory
*Unpacking the <tt>.tar.gz</tt> file overwrites the <tt>longjump_app_server</tt> file in the destination directory
*Optionally, specify an <tt>install_dir</tt> path in the <tt>installation.properties</tt> file
*Optionally, specify an <tt>install_dir</tt> path in the <tt>installation.properties</tt> file
:*This destination path should be used for future upgrades
:*That destination path should be used for future upgrades


====First-Time Installation====
====First-Time Installation====

Revision as of 20:35, 13 September 2013

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
  • That 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.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: 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
    (These libraries can also be added later. They are required to email a chart or report.)
  13. Start the Application Server
  14. Request a Platform License for each instance of the Application Server