Servlet Install (Release 12.2)
Release 12.2 customers please follow these steps to install the communication servlet in the mid-tier.
The More4apps infrastructure is installed as per the standard procedures defined in “Deploying Customizations in Oracle E-Business Suite Release 12.2 (Doc ID 1577661.1)”. There are two components to the More4apps infrastructure: a database package and a java servlet. Installation of the database package is performed directly to the Run edition (should have already been done in an earlier step), and installation of the java servlet will be performed to the Patch edition followed by a cut-over to the Run edition.
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:
Installation
1. Prerequisite Patches
The system needs to be running a minimum of R12.2.2 with the following additional patches applied: 17217965, 17217772, R12.AD.C.Delta.4 (17766337) R12.TXK.C.Delta.4 (17893964).
2. Ensure that a patch run is not currently taking place.
adop -status
3. Install Servlet Files
• Copy the m4aServlet.jar file to the $HOME directory on the mid tier server.
• Connect to Run environment.
. EBSapps.env run
• Start a patch run cycle:
adop phase=prepare
• Connect to patch environment:
. EBSapps.env patch
• Unzip the servlet into $JAVA_TOP:
cd $JAVA_TOP
unzip $HOME/m4aServlet.jar
• Generate the customall.jar file (you will be prompted for the APPS password):
adcgnjar
• Check that it has worked by doing the following, you should see the More4apps servlet files along with any other custom java files:
unzip –l $JAVA_TOP/customall.jar
4. Add Entries to the Custom Synchronization Driver File
The changes on adop_sync.drv are according to the instructions described in MOS Note 1577661.1 (Section 1.5.4)
Add entries for the custom files to the custom synchronization driver file to ensure that the adop utility synchronizes these files between the run file system and the patch file system the next time you run the prepare phase.
vi $APPL_TOP_NE/ad/custom/adop_sync.drv
Add the following to this file after “#Begin Customization” :
rsync -zr %s_current_base%/EBSapps/comn/java/classes/com/more4apps/ %s_other_base%/EBSapps/comn/java/classes/com
5. AutoConfig Template Modification
NOTE: If you have integrated R12.2 with Oracle Webcenter Portal and the value for s_deploy_portlet is customized in the $CONTEXT_FILE then please use oacore_web_xml_FMW_portlet.tmp instead of oacore_web_xml_FMW.tmp in the following instructions.
Create custom versions of oacore_web_xml_FMW.tmp and ebs3rdpartyManifest_xml.tmp:
• 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 oacore_web_xml_FMW.tmp does 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 this file or you may lose pre-existing customizations.
cp oacore_web_xml_FMW.tmp custom
• If the file ebs3rdpartyManifest_xml.tmp does 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 this file or you may lose pre-existing customizations.
cp ebs3rdpartyManifest_xml.tmp custom
• Move into the custom directory.
cd custom
• Edit the custom template files.
vi oacore_web_xml_FMW.tmp
Put the following lines in after the “FND Servlets” servlet entries :
<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.
vi ebs3rdpartyManifest_xml.tmp
Add the following section after the last </classpath> entry and just before </classpath-contents> :
<classpath>
<absolute-path>%s_current_base%/EBSapps/10.1.2/ord/jlib</absolute-path>
<relative-path>../../../../../10.1.2/ord/jlib</relative-path>
<windows-path>@BEA_HOME@/../EBSapps/10.1.2/ord/jlib</windows-path>
<libraries>
<library>ordhttp.jar</library>
<library>ordim.jar</library>
</libraries>
</classpath>
Save the file.
6. Enable the More4apps Servlet
• Switch back to the Run edition:
. EBSapps.env run
• Once you are ready to move the More4apps servlet to the Production system run the adop cutover phase. Note that this will require a brief downtime for the users.
adop phase=cutover
• Switch to the new Run edition:
. EBSapps.env run
• Run Cleanup (optional):
adop phase=cleanup
7. Add Custom Servlet entries based on your Oracle E-Business Suite Release
è if you are on Oracle E-Business Suite Release 12.2.6 or above then perform the below steps to Add custom servlet entries to the configuration file.
è if you are on Oracle E-Business Suite Release lower than 12.2.6 and have applied any CPU patching that includes R12.AD.C.Delta.10 and R12.TXK.C.Delta.10 then you may need to do the below steps
cd $FND_TOP/secure
echo "servlet /OA_HTML/m4aServlet" >> custom_servlets.conf
echo "/OA_HTML/ServletPing" >> custom_servlets.conf
java oracle.apps.fnd.security.resource.WLDataMigration MODE=custom INPUT_FILE=custom_servlets.conf DBC=$FND_SECURE/$TWO_TASK.dbc
8. 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 using the above steps then a new servlet version can be updated directly into the Run environment. It is very quick to do it this way as there is no need to cutover between the Patch and Run environments, but this can only be performed if there is no patch run currently taking place.
• Connect to the run environment:
. EBSapps.env run
• Ensure there is no current run cycle taking place:
adop -status
• If there is no patch run taking place then copy the servlet jar file to the mid-tier server and unzip it.
cd $JAVA_TOP
unzip $HOME/m4aServlet.jar
adcgnjar
• Bounce the webserver:
cd $ADMIN_SCRIPTS_HOME
admanagedsrvctl.sh stopall oacore
adapcctl.sh stop
adapcctl.sh start
admanagedsrvctl.sh startall oacore