imported>Aeric |
|
| (33 intermediate revisions by one other user not shown) |
| Line 1: |
Line 1: |
| === Installing and Upgrading the LongJump Application Platform === | | <includeonly>=== Configuring the Application Server ===</includeonly> |
| | | # As described in [[Software Requirements#Required for Basic Platform Functionality]]: |
| The Application Server is provided as a compressed Linux file: <tt>longjump_app_server.tar.gz</tt>. The file must be unpacked (uncompressed). Instructions are provided for [[#First-Time Installation|First-Time Installation]] and [[#Upgrades|Upgrades]].
| | #* Configure an email server to enable email-based collaboration. |
| | | #* To improve performance, install and memcached for caching. (You will configure it in a moment). |
| ;Considerations:
| | #* Add the Apache HTTP server to further improve performance. |
| *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 | | #: |
| *Upgrades to the application server should use the same destination directory | | # All backend services are enabled by default. But they will cause performance problems if they are running on the customer-facing application server, and errors can result if they are running on multiple servers. After installing the platform, therefore, it is important to ''disable all backend services that are not required on the current server''. |
| *Unpacking the <tt>.tar.gz</tt> file overwrites the <tt>longjump_app_server</tt> file in the destination directory
| | #:''Learn more:'' [[Managing Backend Services]] |
| *Optionally, specify an <tt>install_dir</tt> path in the <tt>installation.properties</tt> file
| | #: |
| :*This destination path should be used for future upgrades
| | # As described in [[Software Requirements#Required for Additional Functionality]]: |
| | | #* To allow PDFs to be generated from documents, install OpenOffice. |
| ====First-Time Installation====
| | #* To allow for <!--Twitter searches and (hiding due to LJP-8904)--> [[Collision Detection and Prevention]], install HornetQ. |
| If the platform has been previously installed on this server, follow the instructions at [[#Upgrades|Upgrades]]. Otherwise:
| | #* To be able to email a chart or report, [[Install the Chart Handling Libraries]]. |
| # Review the [[Installable Version Release Notes]]. | | #: |
| #Login to a command shell | | #Additionally: |
| #Set the <tt>JAVA_HOME</tt> environment variable used by the installation/upgrade script to create configuration settings. For example:
| | #* [[Enabling One-Click Document Viewing|Enable One-Click Document Viewing]]. |
| #:<tt>export JAVA_HOME=/opt/jdk1.6.0_nn/</tt>
| | #* [[Adding Multibyte Character Set Fonts for PDF Printing|Add Multibyte Character Fonts]] for PDF printing. |
| #Go to the directory where the install will occur. For example:
| | #* To enable [[Java Code Governors]] on Red Hat 6, perform the steps mentioned in the [[Additional Step for RedHat]] article. |
| #:<tt>cd /opt/longjump</tt>
| | {{Note|<br>When making changes to an existing server, [[Restart after a Configuration Change|restart the server]] to read in the new values.}} |
| #Copy the archive to that directory.
| | <noinclude> |
| #Unpack it: <tt>tar xvfz longjump_app_server.tar.gz</tt><br/>The <tt>longjump_app_server/</tt> folder is created.
| |
| # Go to the installation folder: <tt>cd longjump_app_server</tt>
| |
| #Edit <tt>[[installation.properties]]</tt>, 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: <tt>#./configure.pl</tt><br/>The application server is installed.
| |
| #Set up [[LONGJUMP_HOME]]
| |
| #[[#Start the Application Server|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|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. <tt>longjump_app_server</tt>). | |
| :* '''Prompted DB backup:''' During the upgrade, the platform prompts for a database backup.
| |
| :* '''Installation folder:''' In a [[#First-Time Installation|First-Time Installation]], the application server is installed in <tt>longjump_app_server</tt>, by default:
| |
| ::* 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
| |
| :* '''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 [[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:
| |
| #Check the [[Installable Version Release Notes]] for any version-specific preparation.
| |
| #Login to the server that is currently running the backend Scheduler service (Quartz).
| |
| #[[Enabling and Disabling Backend Services#To Disable a service|Disable the Service]] on that server.
| |
| #Login to the server to be upgraded.
| |
| #Set the <tt>JAVA_HOME</tt> environment variable.<br/>For example:
| |
| #:<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/longjump/longjump_app_server</tt>, then
| |
| #:<tt>cd /opt/longjump</tt>
| |
| #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:
| |
| #:: <tt>tar xvfz longjump_app_server.vx.x.x.tar.gz --overwrite</tt>
| |
| #: The <tt>longjump_app_server/</tt> folder is overwritten.
| |
| #Enter <tt>cd longjump_app_server</tt>
| |
| #Use a text editor to open the <tt>[[installation.properties]]</tt> file, and add the system details
| |
| #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.
| |
| #[[#Start the Application Platform Server|Start the Application Platform Server]]
| |
| | |
|
| |
|
| [[Category:Installation]] | | [[Category:Installation]] |
| | </noinclude> |
