Install Servlet Release 11i

Release 11i 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 165195.1.

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

2. Edit Autoconfig Templates

Create custom versions of jserv_ux_ias1022.properties and zone_ias1022.properties.

Navigate to the template directory.

cd $FND_TOP/admin/template

Create the "custom" directory if it does not already exist.

mkdir custom

If the files jserv_ux_ias1022.properties and zone_ias1022.properties do not already exist in the "custom" directory then copy them 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 jserv_ux_ias1022.properties custom
cp zone_ias1022.properties custom

Move into the custom directory and edit the custom template files.

cd custom
vi zone_ias1022.properties

Paste the following lines at the very end of the file, after the "Oracle Web Agent" settings:

#------ More4apps Servlet ------
servlet.m4aServlet.code=com.more4apps.r12.servlet.XmlServlet

Save the file.

Now edit the jserv_ux_ias1022.properties file.

vi jserv_ux_ias1022.properties

Paste the following lines at the end of the file.

#--- More4apps Servlet ---
wrapper.classpath=%s_javatop%/m4aServlet.jar

Save the file.

3. Enable Attachment Uploads

Copy oradim jar files to $JAVA_TOP.

cp $ORACLE_HOME/ord/jlib/ordim.jar $JAVA_TOP
cp $ORACLE_HOME/ord/jlib/ordhttp.jar $JAVA_TOP

4. Run Autoconfig

Run Autoconfig as described in Note 165195.1

cd $APPLCSF/scripts/<CONTEXT>
adautocfg.sh

5. Bounce Apache

adapcctl.sh stop
adapcctl.sh start

6. 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/servlets/m4aServlet/hello

If the servlet has been installed correctly a simple information page will render.

Update 11i Servlet

If the servlet is already installed then a new servlet version can be installed 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 overwriting the previous file.

cp m4aServlet.jar $JAVA_TOP

2. Bounce Apache

adapcctl.sh stop
adapcctl.sh start