Thursday, March 7, 2013

[E-Business Suite] Error running txkrun.pl deploying a New Forms EAR File


Scenario:

You have a Shared Applications Filesystem  configuration in your E-Business Suite environment like the following:

To have this configuration you need to have your CONTEXT_FILE configured to work that way, how? (well that's will be a topic of other post, but I'll give you a brief).


On the db01 the s_opmnstatus, s_apcstatus, s_oacorestatus, s_formsstatus, s_oafmstatus should be disabled and enabled on the app01, as you see in the following CONTEXT_FILE.


<oa_service_status oa_var="s_opmnstatus">disabled</oa_service_status>
<oa_service_status oa_var="s_apcstatus">disabled</oa_service_status>
<oa_service_status oa_var="s_oacorestatus">disabled</oa_service_status>
<oa_service_status oa_var="s_formsstatus">disabled</oa_service_status>
<oa_service_status oa_var="s_oafmstatus">disabled</oa_service_status>
<oa_service_status oa_var="s_tnsstatus">enabled</oa_service_status>
<oa_service_status oa_var="s_concstatus">enabled</oa_service_status>
<oa_service_status oa_var="s_icsmstatus">disabled</oa_service_status>
<oa_service_status oa_var="s_jtffsstatus">enabled</oa_service_status>
<oa_service_status oa_var="s_formsserver_status">disabled</oa_service_status>
<oa_service_status oa_var="s_metcstatus">disabled</oa_service_status>
<oa_service_status oa_var="s_metsstatus">disabled</oa_service_status>
<oa_service_status oa_var="s_mwastatus">enabled</oa_service_status>


What happened?
I'm upgrading the OracleAS 10g Forms and Reports in my EBS installation. [ID 437878.1]
After apply all the patches (EBS and Forms and Reports) you need to deploy a new forms.ear file. 

Following Metalink Note: Deploying a New Forms .ear File in Oracle Applications Release 12 [ID 397174.1]

What you need to know:
If you have the Forms services configure to start on the shared server (app01), you will need to TEMPORALY change the variable s_formsstatus to enabled on the server that have all the installation (db01) to avoid the following error:

*****************************************************
Required values for starting OC4J instance "forms":
====================================================
s_formsstatus = enabled
s_forms_nprocs = 1 (value should be greater than 0)


Existing values from the context file:
======================================
s_formsstatus = disabled
s_forms_nprocs = 2
------------------------------------------------

*** Values for context variables are INVALID ***

------------------------------------------------

You need to follow the exact steps that the script guide you to follow:


Follow the below steps:
=======================
- Take backup of context file
     Location of Context File: /u07/test/inst/apps/DB01_test/appl/admin/DB01_test.xml
- Set the context variable s_formsstatus to "enabled"
- Run AutoConfig
- Run the re-deployment script txkCfgOC4JApp.pl
     Usage:
       txkrun.pl -script=CfgOC4JApp -applicationname=<forms/mapviewer/ascontrol>
       -oc4jpass=<Instance password> -runautoconfig=<Yes/No>
- Set the context variable s_formsstatus back to "disabled"
- Run AutoConfig
*****************************************************

After the changes I re-run the script:


Enter Application name for re-deployment ? forms
Enter Oc4j Instance  password for re-deployment ? 
Run Autoconfig <Yes/No> ? No


*****************************************************
Required values for starting OC4J instance "forms":
====================================================
s_formsstatus = enabled
s_forms_nprocs = 1 (value should be greater than 0)


Existing values from the context file:
======================================
s_formsstatus = enabled
s_forms_nprocs = 2
----------------------------------------------

*** Values for context variables are VALID ***

----------------------------------------------

*****************************************************

Stopping all OPMN processes.
OPMN stopped.
OPMN started.
Deplolying Application : "forms" onto OC4J instance: "forms"
Application deployed successfully.
Stopping and starting OC4J instances.
Started OC4J instances.
Binding webApp : "forms" with webmodule : "formsweb" for OC4J instance: "forms"
Web application bound successfully.
Stopping OPMN.
OPMN stopped.

Program : /u07/test/apps/apps_st/appl/fnd/12.0.0/patch/115/bin/txkCfgOC4JApp.pl completed @ Thu Mar  7 08:57:49 2013

End of /u07/test/apps/apps_st/appl/fnd/12.0.0/patch/115/bin/txkCfgOC4JApp.pl : No Errors encountered

After this, remember, that you need to change back the s_formsstatus to disabled and run Autoconfig on both servers (db01 and app01).