View source for Installing and Configuring Apache for Use with the Platform

<includeonly>=== Installing and Configuring Apache for Use with the Platform ===</includeonly>
Apache can be installed in front of the tomcat server to serve static content like gif and jpeg images, Javascript files and stylesheets more efficiently, leaving the Application Server free to process incoming requests. This section tells you how to configure Apache to serve the platform's static content.

==== Overview ====

With this arrangement, Apache will be in front of Tomcat. Any request that comes to the platform first goes to Apache. Apache determines if the request is a valid request and, if so, will forward the request to Tomcat for processing.

Since Apache will be in front of Tomcat, it needs to be configured to listen on port 80 and port 443 for http and https traffic respectively. Apache also needs to be configured to forward traffic coming on those ports to the port on which Tomcat is listening.

==== Requirements====
The following Apache modules must be enabled when installing Apache. They can be compiled as a static binary into apache or loaded as dynamic modules.
:* mod_proxy 
:* mod_proxy_connect
:* mod_proxy_http
:* mod_ssl 
:* mod_expires 
:* mod_headers 

==== Configuration Process====

In outline, the process looks like this:
#Configure Apache Virtual host.
#Start Apache, Tomcat and <tt>memcached</tt>.

{{Important|Ensure that all database servers and web servers are configured to be in the same timezone, regardless of where they are geographically located.}}


==== Configure Apache Virtual Hosts ====

:;1. Add two virtual host entries:
::- One in <tt>httpd.conf</tt> for Apache to listen on port 80 for HTTP traffic.
::- One in <tt>httpd-ssl.conf</tt> for Apache to listen on port 443 for HTTPS traffic.

::Any traffic meant for the platform coming on these ports is forwarded to Tomcat. This request forwarding  is achieved using the mod_proxy module.

::The <tt>httpd.conf</tt> and <tt>httpd-ssl.conf</tt> configuration files can be found in the $APACHE_HOME directory. For each virtual host entry, make sure the following are set appropriately:
::{|
<pre>ServerAdmin root@localhost
DocumentRoot "/usr/local/apache/htdocs/"
ServerName example.com
ServerAlias www.example.com</pre>
|}
:;2. Configure certificates for SSL virtual host on port 443:
::Make sure the following points to your certificate and private key.
::''httpd-ssl.conf'':
::{|
<pre>SSLCertificateFile "{install_dir}/tomcat/conf/RN/<yourdomain>.cer"
SSLCertificateKeyFile "{install_dir}/tomcat/conf/RN/<yourdomain>_private_key"</pre>
|}
:;3. Enable secure communications:
::Set up a secure communications channel between Apache and Tomcat. The URLs for the Proxy are then https://, rather than http://, and all traffic is encrypted.
::{|
<pre>SSLProxyEngine on
</pre>
<pre>ProxyPreserveHost On </pre>
|}
:;4. Configure Proxy Paths in Apache:
::Proxy paths need to be configured to enable mod_proxy to recognize the request and forward it to Tomcat appropriately as shown in the following examples:

::{|
<pre><nowiki>ProxyPass /networking/* https://tomcat-host-name:8284/networking/*
ProxyPassReverse /networking/* https://tomcat-host-name:8284/networking/*</nowiki></pre>
|}
::{|
<pre><nowiki>ProxyPass /networking/* http://tomcat-host-name:8283/networking/*
ProxyPassReverse /networking/* http://tomcat-host-name:8283/networking/*</nowiki></pre>
|}

For ace-lib components, make the updates as per the following examples:
::{|
<pre><nowiki>ProxyPass /ace-lib/* https://tomcat-host-name:8284/ace-lib/*
ProxyPassReverse /ace-lib/* https://tomcat-host-name:8284/ace-lib/*</nowiki></pre>
|}
::{|
<pre><nowiki>ProxyPass /ace-lib/* http://tomcat-host-name:8283/ace-lib/*
ProxyPassReverse /ace-lib/* http://tomcat-host-name:8283/ace-lib/*</nowiki></pre>
|}
::''Note'': These instructions assume that Tomcat and Apache are running on the same server. If they are running on different servers, change the settings appropriately.

:;5.Configure virtual hosts: For each virtual host in <tt>httpd.conf</tt> and <tt>httpd-ssl.conf</tt> for ports 80 and 443, copy the settings from <tt>{install_dir}/httpd-proxy.conf</tt>, changing the standard port assignment of 8283 and 8284, if needed.

For more information on changing ports, see [[Controlling Port Access]].

In case, you are trying to access AgileApps server without an Apache server and if you use any port number other than 80 and 443, you have to access the AgileApps URLs along with the port numbers. For example: https://{hostname}:8284/networking/servicedesk/index.jsp

[[Category:Installation]]
</noinclude>