Servlet Install (Release 12.0 and 12.1)
Release 12.0 and 12.1 customers, please follow these steps to install the communication servlet in the mid-tier. To enable the servlet we modify the server configuration files by implementing a fully supported Autoconfig customization, as documented in Metalink Note 387859.1.
This servlet is not required in Release 11i.
Attention Windows Users: this document uses UNIX syntax when specifying directories and operating system commands. Substitute the appropriate Windows syntax where applicable.
If you have multiple mid-tier servers then you must repeat these steps on each server:
1. Copy m4aServlet.jar to $JAVA_TOP
Copy the file m4aServlet.jar to the mid-tier server and place it in $JAVA_TOP.
cp m4aServlet.jar $JAVA_TOP
If you have unzipped m4aServlet.jar as per our previous instructions please remove the unzipped files:
rm -rf $JAVA_TOP/com/more4apps/r12
2. Edit Autoconfig Templates
Navigate to the template directory.
cd $FND_TOP/admin/template
Create the "custom" directory if it does not already exist.
mkdir custom
If the file orion_web_xml_1013.tmp do not already exist in the "custom" directory then copy it from $FND_TOP/admin/template directory. Be careful not to overwrite an existing copy of these files or you may lose pre-existing customizations.
cp orion_web_xml_1013.tmp custom
Move into the custom directory and edit the custom template files.
cd custom
vi orion_web_xml_1013.tmp
Paste the following lines just before the TCF alias :
<!-- More4apps Servlet -->
<servlet>
<servlet-name>m4aServlet</servlet-name>
<servlet-class>com.more4apps.r12.servlet.XmlServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>m4aServlet</servlet-name>
<url-pattern>/m4aServlet/*</url-pattern>
</servlet-mapping>
Save the file.
• Run the below command to Copy the mentioned jar files to $JAVA_TOP
cp $ORACLE_HOME/ord/jlib/ordim.jar $JAVA_TOP
cp $ORACLE_HOME/ord/jlib/ordhttp.jar $JAVA_TOP
3. Run Autoconfig
Run Autoconfig as described in Note 387859.1
cd $ADMIN_SCRIPTS_HOME
adautocfg.sh
4. Bounce Apache
adapcctl.sh stop
adoacorectl.sh stop
adoacorectl.sh start
adapcctl.sh start
5. Test the Servlet
To test whether the servlet has been installed correctly, first get the value of profile option "Apps Servlet Agent".
Then enter the following URL in your browser:
<<value of profile option>>/m4aServlet/hello
The full URL will look something like this:
https://tornado.more4apps.com:8000/OA_HTML/m4aServlet/hello
If the servlet has been installed correctly a simple information page will render.
Update the Servlet if it has already been installed
If the servlet is already installed then a new servlet version can be updated by completing the following steps:
1. Copy m4aServlet.jar to $JAVA_TOP
Copy the file m4aServlet.jar to the mid-tier server and place it in $JAVA_TOP.
cp m4aServlet.jar $JAVA_TOP
If you have unzipped m4aServlet.jar as per our previous instructions please remove the unzipped files:
rm -rf $JAVA_TOP/com/more4apps/r12
2. Bounce Apache
adapcctl.sh stop
adoacorectl.sh stop
adoacorectl.sh start
adapcctl.sh start
