How to configure Applications Manager with a remote Tomcat web server
Article ID: 236324
Updated On:
Products
Issue/Introduction
How do I configure Applications Manager to use a remote Tomcat web server to serve the Java client files?
Environment
Release : 9.4
Component : Applications Manager
Resolution
1. Copy the {AW_HOME/web} directory from the Applications Manager server and move it to a location on the Tomcat server.
2. Backup {Tomcat_home}/conf/server.xml.
3. Add xmlValidation=”false” and xmlNameSpaceware=”false” in the <Host> attribute to the server.xml file.
<Host name="{fully qualified machine name}" appBase="webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">
4. Add <Context path> attribute where path={Master} and docBase={location of AM web folder} to the server.xml file.
<Context path="/AM_DEV"
docBase="/home/tomcat/am/web/"
reloadable="true"
crossContext="true"/>
5. The URL for the Intro.html page should include the remote Tomcat host and port.
http://{Tomcat hostame}:{Tomcat port}/{MASTER}/Intro.html
6. When configuring the Java client's connections.properties file, the connection information will contain the remote Tomcat information.
{MASTER}=http://{Tomcat hostame}:{Tomcat port}/{MASTER}
An example of the full <Host> attribute from the server.xml file is below. Notice there are 2 different Applications Manager instances defined.
<Host name="test.gbd.broadcom.net" appBase="webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">
<Context path="/AMS941" <------------------------------------- This Applications Manager instance is local to Tomcat
docBase="/home/ams941/web/"
reloadable="true"
crossContext="true" />
<Context path="/USERAM" <------------------------------------- This Applications Manager instance is remote to Tomcat
docBase="/home/tomcat/am/web/"
reloadable="true"
crossContext="true" />
<!-- SingleSignOn valve, share authentication between web applications
Documentation at: /docs/config/valve.html -->
<!--
<Valve className="org.apache.catalina.authenticator.SingleSignOn" />
-->
<!-- Access log processes all example.
Documentation at: /docs/config/valve.html
Note: The pattern used is equivalent to using pattern="common" -->
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log" suffix=".txt"
pattern="%h %l %u %t "%r" %s %b" />
</Host>
Additional Information
1. If needed, please refer to your OS/Tomcat admin if assistance is needed to Install and configure Tomcat
2. Note that if there are any changes to Applications Manager's local web directory (upgrade, RA Agent install/upgrade/downgrade, etc), a copy of the web directory needs to be copied from AM's {AW_HOME} directory and replaced on the remote tomcat server
Feedback
