4/5/2019 Document 1905593.

PowerView is Off Suryanarayanaraju (Available) (0) Contact Us Help

Dashboard Knowledge Service Requests Patches & Updates Community 1905593.1

Give Feedback... You have been directed to this document based on an ID match. Alternatively, click here to search on this phrase. Hide
Copyright (c) 2019, Oracle. All rights reserved. Oracle Confidential.

Managing Configuration of Oracle HTTP Server and Web Application Services in Oracle E-Business Suite Release To Bottom
12.2 (Doc ID 1905593.1)

This document provides an overview of configuration management of Oracle HTTP Server and web applications in Oracle E-
Was this document helpful?
Business Suite Release 12.2. It also lists the known issues in configuration management. The most current version of this
document can be obtained in My Oracle Support Knowledge Document 1905593.1, Managing Configuration of Oracle HTTP Yes
Server and Web Application Services in Release 12.2, by Oracle E-Business Suite Development. No

A change log is available at the end of this document.

Document Details
In This Document
Type:
This document is divided into the following sections: Status: WHITE PAPER
Last Major PUBLISHED
Section 1: Overview Update: 01-Aug-2016
Section 2: Tools for Configuration Synchronization Last 08-Nov-2017
Section 3: Managing Configuration of Oracle HTTP Server Update:
3.1 Updating AutoConfig-Managed Oracle HTTP Server Configurations
3.2 Updating Seeded Oracle HTTP Server Configurations
3.3 Running Oracle HTTP Server on a Privileged Port Related Products
Section 4: Managing Configuration of Oacore, Oafm, Forms and Forms-c4ws Applications Oracle E-Business Suite
4.1 Updating Configuration Parameters for Individual Applications Technology Stack
4.2 Managing Configuration Parameters for Individual Managed Servers Oracle Concurrent Processing
4.3 Additional Steps Needed on Non-Shared Multi-Node Systems
4.4 Customizing the Number of Instances of a Particular Service Type
Information Centers
Section 5: Updating the Classpath and JVM Arguments of the AdminServer
Information Center: Using EBS
Section 6: Known Issues Technology Stack OID and
SSO [1461466.2]

Information Center: Oracle E-

Section 1: Overview Business Suite Extensions for
Oracle Information Discovery
Prior to Oracle E-Business Suite Release 12.2, AutoConfig managed all Oracle HTTP Server configuration files throughout the Install & Configure
system lifecycle. In Release 12.2, AutoConfig is only involved in the initial setup of the Oracle HTTP Server configuration files. [1487000.2]
Later, it can optionally be used to manage and customize a limited set of Oracle HTTP Server configuration files. Otherwise, as Information Center: EBS
described in this document, native Oracle WebLogic Server and Fusion Middleware tools are used to manage these files. Printing - Component Tools -
Overview [1511969.2]
In Oracle E-Business Suite Release 12, the oacore, oafm, forms and forms-c4ws services were deployed as applications on OC4J Information Center: Overview
instances and were managed by Oracle Process Manager (OPMN). Because Oracle WebLogic Server has replaced OC4J in Oracle EBS Technology Stack OID
E-Business Suite Release 12.2, these services are now deployed as applications on individual managed servers. Consequently, and SSO and OAM
only part of the configuration of these applications and managed servers is still managed via AutoConfig. This document [1461465.2]
describes those areas that remain managed by AutoConfig and those that are not. E-Business Suite Product
Information Center Index
[444.2]

Note: You are strongly encouraged to be on the latest AD/TXK codelevel. Refer to My Oracle Support Knowledge Document
1583092.1, Oracle E-Business Suite Release 12.2: Suite-Wide Rollup and AD/TXK Delta Information
, and apply the most
recent delta patches. Document References
No References available for
It is important to read the release notes for those patches, since they may require other patches. Refer to My Oracle this document.
Support Knowledge Document 1617461.1, Applying the Latest AD and TXK Release Update Packs to Oracle E-Business Suite
Release 12.2 .
Recently Viewed

The instructions in this document are applicable only for AD/TXK Delta 4 codelevel and higher which is the minimum Managing Configuration of
supported codelevel for AD/TXK at this time. Oracle HTTP Server and
Web Application Services in
Oracle E-Business Suite
Release 12.2 [1905593.1]
Managing Configuration of
Oracle HTTP Server and
Section 2: Tools for Configuration Synchronization Web Application Services in
Oracle E-Business Suite
In Oracle E-Business Suite Release 12.2, some Oracle HTTP Server configurations and WebLogic configurations are managed via Release 12.2 [1905593.1]
AutoConfig while some are managed natively via Fusion Middleware Control and WebLogic Server Administration Console. A new Oracle E-Business Suite
mechanism has been introduced to keep the context variables and the OHS configuration parameters (where applicable) in Release 12.2.8 Readme
synchronization. This mechanism is called the 'feedback loop'. [2393248.1]
Oracle E-Business Suite
Following tools are used for performing this synchronization: Release 12.2: Suite-Wide
Rollup and AD/TXK Delta
Information [1583092.1]
Script Name Location Purpose Deploying Oracle E-Business
Suite AccessGate Script fails
adRegisterWLSListeners.pl On Applications in Creating EBS Managed
Tier: This script is used to listen to changes to the Server OAEA_SERVER
<AD_TOP>/bin WebLogic Server configuration parameters and [2437318.1]

https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=541406953262314&id=1905593.1&_adf.ctrl-state=1df9sxmnz5_57 1/11
4/5/2019 Document 1905593.1
update the context variables accordingly. Show More

Note: This script is not able to synchronize changes

to Oracle HTTP Server configuration.

adSyncContext.pl On Applications This script is used to explicitly pull the values of the
Tier: WebLogic Server and Oracle HTTP Server
<AD_TOP>/bin configuration parameters and synchronize the
corresponding context variable values accordingly.

2.1 Run adRegisterWLSListeners Tool on the Application Tier

As noted previously, some Oracle E-Business Suite Release 12.2 configurations are managed via AutoConfig, and some are
managed natively via Fusion Middleware Control or Oracle WebLogic Server Administration Console.

The adRegisterWLSListeners tool performs automatic synchronization of context variables with the corresponding Oracle
WebLogic Server configuration parameters.

Note: This tool does not listen for changes to the Oracle HTTP Server configuration parameters.

On UNIX instances, the tool is started automatically on the primary node whenever WebLogic Administration Server is started.

On Windows instances, the tool needs to be explicitly started up on the primary node every time WebLogic Administration Server
is started up.

Execute the following command to start adRegisterWLSListeners.pl:

$ perl <AD_TOP>/bin/adRegisterWLSListeners.pl contextfile=<CONTEXT_FILE>

Once started, adRegisterWLSListeners keeps running, listening for changes to the WebLogic Server configuration and
synchronizing the context files stored in the database. The tool automatically stops when WebLogic Administration Server is shut
down.

2.2 Run SyncContext on the Application Tier

The SyncContext tool is used for explicit synchronization of the context variables with the WebLogic Server and Oracle HTTP
Server configurations.

It differs from adRegisterWLSListeners.pl in that it is able to synchronize the context file with the Oracle HTTP Server
configuration changes as well.

Execute the following command to run adSyncContext.pl on a respective Application tier node.

$ perl <AD_TOP>/bin/adSyncContext.pl contextfile=<CONTEXT_FILE>

Note: The Node Manager and the WebLogic AdminServer must be running during execution of adSyncContext.pl.

Section 3: Managing Configuration of Oracle HTTP Server

As mentioned in Section 1, AutoConfig manages only a limited set of Oracle HTTP Server Configuration files in Release 12.2.
Most Oracle HTTP Server configuration files are now managed via native Oracle WebLogic Server and Fusion Middleware tools.

3.1 Updating AutoConfig-Managed Oracle HTTP Server Configurations

The table below shows the Oracle HTTP Server configuration templates that are managed by AutoConfig in Oracle E-Business
Suite Release 12.2. The configurations defined in these files can be customized by customizing the templates.

Template Name Configuration File

ssl_terminator_conf_FMW.tmp ssl_terminator.conf

trusted_conf_FMW.tmp trusted.conf

oracle_apache_conf_FMW.tmp oracle_apache.conf

oracle_apache_ssl_conf_FMW.tmp oracle_apache_ssl.conf

url_fw_conf_FMW.tmp url_fw.conf

url_fw_ws_conf_FMW.tmp url_fw_ws.conf

security2_dmz_conf_FMW.tmp security2_dmz.conf

security2_conf_FMW.tmp security2.conf

security2_conf_FMW_nt.tmp security2.conf

custom_conf_FMW.tmp custom.conf
https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=541406953262314&id=1905593.1&_adf.ctrl-state=1df9sxmnz5_57 2/11
4/5/2019 Document 1905593.1

webgate_conf_FMW.tmp webgate.conf

Note: For more information regarding customization of AutoConfig templates, refer to Chapter 3: Technical Configuration in
Oracle E-Business Suite Setup Guide for Release 12.2
.

3.2 Updating Seeded Oracle HTTP Server Configurations

During creation of the Oracle HTTP Server instance, AutoConfig performs the first instantiation of configuration files such as
httpd.conf and mod_wl_ohs.conf. After the installation or upgrade to Release 12.2 is complete, seeded Oracle HTTP Server
configurations are generally managed via Fusion Middleware Control. In certain specific cases, however, manual editing of the
configuration files may be needed: this will be advised separately where required.

Note: For further information, refer to Section 3.3: Getting Started Using Oracle Enterprise Manager Fusion Middleware
Control inOracle Fusion Middleware Administrator's Guide . This book can be found in the Oracle Fusion Middleware
Documentation Library.

When modifying Oracle HTTP Server protocols or port numbers, these values must be updated in both the context file as well as
in the configuration files. This is to ensure that the new values are updated in the AutoConfig-managed database profile values
as well.

To modify HTTP server protocols or port numbers, perform the following steps on the run file system:

1. Login to Oracle Fusion Middleware Control Console.

2. Select Web Tier Target under EBS Domain.

3. Select Administation > Advanced Configuration.

4. Edit the relevant file to update the respective HTTP configuration parameter value.

5. Run the following command on all application tier nodes:

$ perl <AD_TOP>/bin/adSyncContext.pl contextfile=<CONTEXT_FILE>

6. Run AutoConfig on all application tier nodes.

7. Restart HTTP services by executing the following command on the run file system:

On UNIX:

$ sh <ADMIN_SCRIPTS_HOME>/adapcctl.sh stop
$ sh <ADMIN_SCRIPTS_HOME>/adapcctl.sh start

On Windows:

C:\><ADMIN_SCRIPTS_HOME>/adapcctl.cmd stop
C:\><ADMIN_SCRIPTS_HOME>/adapcctl.cmd start

3.3 Running Oracle HTTP Server on a Privileged Port

On a UNIX system, the TCP/IP port numbers below 1024 are special in that only processes with root privileges are allowed to
listen on those ports. If you wish to configure Oracle HTTP Server to run on a privileged port, you must first edit the HTTP port
as specified in Section 3.2 and then perform the following additional steps to enable Oracle HTTP Server to run as root. These
steps are required for both SSL and non-SSL privileged ports.

1. Execute the following commands as the root user on both the run file system and the patch file system.

$ chown root <FMW_HOME>/webtier/ohs/bin/.apachectl

$ chmod 6750 <FMW_HOME>/webtier/ohs/bin/.apachectl

2. Restart HTTP services by executing the following command on the run file system:

On UNIX:

$ sh <ADMIN_SCRIPTS_HOME>/adapcctl.sh stop
$ sh <ADMIN_SCRIPTS_HOME>/adapcctl.sh start

On Windows:

C:\><ADMIN_SCRIPTS_HOME>/adapcctl.cmd stop
C:\><ADMIN_SCRIPTS_HOME>/adapcctl.cmd start

For more information, see: Starting Oracle HTTP Server on a Privileged Port, Oracle Fusion Middleware Administrator's Guide for
Oracle HTTP Server .

https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=541406953262314&id=1905593.1&_adf.ctrl-state=1df9sxmnz5_57 3/11
4/5/2019 Document 1905593.1

Section 4: Managing Configuration of Web Application services

In Oracle E-Business Suite Release 12.2, the oacore, oafm, forms, forms-c4ws and oaea services are deployed as applications on
individual managed servers. Some of the configuration parameters of these services are managed at the application level while
others are managed at individual managed server level.

4.1 Updating Configuration Parameters for Individual Applications

The basic configurations of the oacore, oafm, forms, forms-c4ws and oaea applications are maintained in their respective
deployment plans . The deployment plan for an application contains configurable parameters such as session timeout, log file
rotation size, and log file rotation time. Each deployment plan is delivered as an AutoConfig template containing a limited set of
context variables.

AutoConfig instantiates the deployment plan initially. Subsequently, AutoConfig only updates the existing deployment plan: this
is needed in case any of the context variables used in the deployment plan have been customized.

The only parameters that can be updated using AutoConfig are for the oacore application. Following is the list of parameters in
the deployment plan for oacore application that is managed via AutoConfig:

Parameter Value

help_InitParam_ohwConfigFileURL file:%s_ora_config_home%/FMW/oacore/config/ohwconfig.xml

CGIServlet_InitParam_cgiDir %s_config_home%/admin/install

CGIServlet_InitParam_*.pl %s_adperlprg%

oowa_InitParam_log_main_file %s_logs_dir%/ora/FMW/oacore/oowa.log

oowa_InitParam_log_spl2_file %s_logs_dir%/ora/FMW/oacore/oowa.log

LoopProcServlet_InitParam_ARCHIVE %s_applptmp%

TransmitServlet_InitParam_ARCHIVE %s_applptmp%

The remaining parameters for each application need to be updated through the WebLogic Server Administration Console, as
follows:

1. Log on to the WebLogic Server Administration Console.

2. Click on the 'Deployments' link in the left panel for 'Domain Structure.'
3. Examine the page that gives a summary of all deployments.
4. If the configuration is to be customized at the application level, click on the application whose configuration is to be
updated. For example, if updating oacore configuration, click on the link for 'oacore' and take the desired action.
5. If the configuration changes are to be done at the Web Application level, click on the link for the respective Web
Application in the Deployments page, and select the 'Configuration' tab to customize the configuration parameters for the
application.
6. After editing and setting the parameters, click on the 'Save' button. This updates the deployment plan for the application.
7. Once all configuration changes have been saved, click on the 'Activate Changes' button in the 'Change Center' panel to
activate the changes.

Note: For further information, refer to Section 3.4: Getting Started Using Oracle WebLogic Server Administration Console in
Oracle Fusion Middleware Administrator's Guide 11g Release 1 (11.1.1) . This book can be found in the Oracle Fusion
Middleware Documentation Library.

4.2 Managing Configuration Parameters for Individual Managed Servers

4.2.1 Customizing Managed Server Configuration via WebLogic Server Administration Console
4.2.2 Managing Classpath and JVM Arguments for the Managed Server
4.2.3 Resetting Managed Server Classpath and JVM Arguments to Default Values
4.2.4 Changing the Port Numbers of the Managed Servers

4.2.1 Customizing Managed Server Configuration via WebLogic Server Administration Console

The managed server configuration can be customized via native WebLogic tools such as the WebLogic Server Administration
Console and WLST commands.

Use the following steps to customize the managed server configuration via the WebLogic Server Administration Console.

1. Log on to the WebLogic Server Administration Console.

2. Click on the 'Servers' link. This link takes you to a page containing a summary of the WebLogic Administration Server and
all managed servers.
3. Click on the managed server whose configuration needs to be updated. A page containing various tabs for the settings of
the managed server appears.
4. Update the configuration parameters as needed.
5. Click the 'Save' button to save the configuration changes.
6. Once the customizations are complete and saved, click the 'Activate Changes' button in the 'Change Center' panel to
activate the changes.

https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=541406953262314&id=1905593.1&_adf.ctrl-state=1df9sxmnz5_57 4/11
4/5/2019 Document 1905593.1

Note: If the managed server port number is to be changed, in addition to updating the port number via the native
WebLogic tools you must also perform the additional steps in Section 4.2.4.

4.2.2 Managing Classpath and JVM Arguments for the Managed Server

The classpath and JVM arguments of a managed server can be modified from the WebLogic Server Administration Console or
through WLST commands as specified above, which is the preferred way.

In addition, in case these properties are to be set from the command line, it can be done as follows:

To set the managed server classpath, execute the following command:

$ perl <AD_TOP>/patch/115/bin/adProvisionEBS.pl ebs-set-managedsrvproperty \

-contextfile=<CONTEXT_FILE> -managedsrvname=<MANAGED SERVER NAME> \
-managedsrvclasspath="<COMPLETE MANAGED SERVER CLASSPATH>"

Note: The above command will overwrite the existing managed server's classpath to the value specified for the
argument -managedsrvclasspath.

So it should be ensured that the complete managed server classpath is provided in the above command. The
existing managed server classpath value can be obtained from the WebLogic AdminServer Console, by navigating to
the respective managed server as specified in Section 4.2.1 and then clicking on the 'Server Start
' tab.

Only in the unlikely case when the value cannot be retrieved from the WebLogic AdminServer Console, the default
value supplied for the managed server classpath in the context file can be used. Refer to Section 4.2.3 for details of
the managed server classpath context variables.

To set the managed server JVM arguments, execute the following command:

$ perl <AD_TOP>/patch/115/bin/adProvisionEBS.pl ebs-set-managedsrvproperty \

-contextfile=<CONTEXT_FILE> -managedsrvname=<MANAGED SERVER NAME> \
-serverstartargs="<COMPLETE LIST OF JVM ARGUMENTS>"

Note: The above command will overwrite the existing managed server's JVM arguments to the value specified for
the argument -serverstartargs.

So it should be ensured that the complete set of JVM arguments for the managed server is provided in the above
command. The existing JVM arguments for the managed server can be obtained from the WebLogic AdminServer
Console, by navigating to the respective managed server as specified in Section 4.2.1 and then clicking on the 'Server
Start' tab.

Only in the unlikely case when the value cannot be retrieved from the WebLogic AdminServer Console, the default
value supplied for the managed server JVM arguments in the context file can be used. Refer to Section 4.2.3 for
details of the context variables for the managed server JVM arguments.

During startup of a managed server using the adstrtal.sh/cmd script or the individual control script
admanagedsrvctl.sh/cmd, the Oracle E-Business Suite-specific library path is updated in the managed server JVM arguments.
If the JVM arguments have already been customized for the managed server, the E-Business Suite specific library path is
prepended to the list of customized library paths.

4.2.3 Resetting Managed Server Classpath and JVM Arguments to Default Values

If you need to reset the managed server classpath or JVM arguments to the default values, refer to the default values in the
context file and update these properties using either the native WebLogic tools or the adProvisionEBS.pl script used in Section
4.2.2.

The default values for the managed server classpath can be identified from the context variables listed in the following table:

Service Type Context Variable

oacore s_oacore_classpath

oafm s_oafm_classpath

forms s_forms_classpath

forms-c4ws s_forms-c4ws_classpath

The default values for the managed server JVM arguments can be identified from the context variables listed in the following
table:

Service Type Context Variable

oacore s_oacore_jvm_start_options

https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=541406953262314&id=1905593.1&_adf.ctrl-state=1df9sxmnz5_57 5/11
4/5/2019 Document 1905593.1
oafm s_oafm_jvm_start_options

forms s_forms_jvm_start_options

forms-c4ws s_forms-c4ws_jvm_start_options

4.2.4 Changing the Port Numbers of the Managed Servers

To change the port number of a managed server, you must first edit the port number by following the steps in Section 4.2.1.

Then perform the following steps on all application tier nodes participating in the same cluster that this managed server is part
of:

1. Source the run file system.

2. Execute the following command to delete references of the old managed server port in the OHS configuration files
mod_wl_ohs.conf and apps.conf:

$ perl <FND_TOP>/patch/115/bin/txkSetAppsConf.pl \
-contextfile=<CONTEXT_FILE> \
-configoption=removeMS \
-oacore=<host>.<domain>:<port> \
-oafm=<host>.<domain>:<port> \
-forms=<host>.<domain>:<port> \
-formsc4ws=<host>.<domain>:<port> \
-ekanban=<host>.<domain>:<port> \
-accessgate=<host>.<domain>:<port> \
-yms=<host>.<domain>:<port>

where
The argument contextfile accepts the complete path to the context file.
The arguments oacore, oafm, forms, formsc4ws, ekanban, accessgate and yms accept a comma-separated
list of managed server details in the following format:
<host>.<domain>:<port>
host, domain and port are the hostname, domain and port of the managed server whose reference is
to be deleted.

For example, if the port number of the managed server oacore_server3 on host 'testserver' and domain 'example.com' is
being changed from 7205 to 7305, the following command should be executed to remove references of port 7205:

$ perl <FND_TOP>/patch/115/bin/txkSetAppsConf.pl -contextfile=<CONTEXT_FILE> \

-configoption=removeMS -oacore=testserver.example.com:7205

3. Execute the following command to add back the managed server entry in the OHS configuration files with the new port:

$ perl <FND_TOP>/patch/115/bin/txkSetAppsConf.pl \
-contextfile=<CONTEXT_FILE> \
-configoption=addMS \
-oacore=<host>.<domain>:<port> \
-oafm=<host>.<domain>:<port> \
-forms=<host>.<domain>:<port> \
-formsc4ws=<host>.<domain>:<port>

where
The argument contextfile accepts the complete path to the context file.
The arguments oacore, oafm, forms, formsc4ws accept a comma-separated list of managed server details
in the following format:
<host>.<domain>:<port>
host and domain are the hostname and domain name of the newly added node
port is the port of the new managed server whose reference is to be added

For example, to add back entry of managed server oacore_server3 on host 'testserver' and domain 'example.com' with
port 7305, the following command should be executed:

$ perl <FND_TOP>/patch/115/bin/txkSetAppsConf.pl -contextfile=<CONTEXT_FILE> \

-configoption=addMS -oacore=testserver.example.com:7305

4. If Oracle HTTP Server is enabled on the node, restart it as follows:

On UNIX:

$ sh <ADMIN_SCRIPTS_HOME>/adapcctl.sh stop
$ sh <ADMIN_SCRIPTS_HOME>/adapcctl.sh start

On Windows:

C:\><ADMIN_SCRIPTS_HOME>/adapcctl.cmd stop
C:\><ADMIN_SCRIPTS_HOME>/adapcctl.cmd start

4.3 Additional Steps Needed on Non-Shared Multi-Node Systems

Configuration changes performed via Oracle WebLogic Server (WLS) Console to any of the oacore, oafm, forms and forms-c4ws
applications are reflected in the associated deployment plans. The changes are made automatically to the deployment plan on
the node where the AdminServer is running.

If you have a multi-node system, you must manually update the deployment plans on the other nodes so that the plans on all
nodes are synchronized.

https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=541406953262314&id=1905593.1&_adf.ctrl-state=1df9sxmnz5_57 6/11
4/5/2019 Document 1905593.1
The deployment plans are located as follows:

<EBS_ORACLE_HOME>/deployment_plans/oacore/plan.xml
<EBS_ORACLE_HOME>/deployment_plans/oafm/plan.xml
<EBS_ORACLE_HOME>/deployment_plans/forms/plan.xml
<EBS_ORACLE_HOME>/deployment_plans/forms-c4ws/plan.xml

If any configuration changes are made to a deployment plan via WLS Console, follow the steps below to synchronize the
deployment plans on the other nodes.

1. Edit the relevant deployment plan to enter the new configuration value in the variable-definition section.

For example, if the Session cookies max age parameter is changed via WLS console, you must make a corresponding
update to the variable WeblogicApplication_SessionDescriptor_CookieMaxAgeSecs in the variable-definition section
of the deployment plan.

2. Save the deployment plan.

3. Restart the managed server.

4.4 Customizing the Number of Instances of a Particular Service Type

By default, every application tier node contains only a single instance of the oacore, oafm, forms and forms-c4ws services. If
more instances of a particular service are required on an application tier node, new managed servers must be created. Similarly,
if the number of instances of a particular service needs to be reduced, the relevant managed server needs to be deleted.

Note: For the oacore service, Oracle recommends up to 150-200 concurrent users per JVM of size 2 GB.

4.4.1 Adding a new managed server

Addition of managed servers needs to be done on the run file system when there is no active ADOP cycle. During the next adop
prepare, the Configuration Change Detector identifies that the addition has been made and the managed servers are
automatically synced up from the run file system to the patch file system. The synchronization also gets done when fs_clone is
executed.

Note: Managed server creation should be done only through the adProvisionEBS.pl script as mentioned in this section.
Managed servers should not be created from the WebLogic Server Administration Console.

To add a new managed server of a specific service type, perform the following steps on the run file system:

1. Execute the following command to add a new managed server. This will create a managed server and add a new entry to
the context file for starting and stopping the new managed server via the adstrtal and adstpall scripts:

$ perl <AD_TOP>/patch/115/bin/adProvisionEBS.pl \
ebs-create-managedserver -contextfile=<CONTEXT_FILE> \
-managedsrvname=<MANAGED_SERVER_NAME> -servicetype=<SERVICE_TYPE> \
-managedsrvport=<MANAGED_SERVER_PORT> -logfile=<LOGFILE>

For example, to add a managed server 'oacore_server2' of type 'oacore' with port 7203, run the following command:

$ perl <AD_TOP>/patch/115/bin/adProvisionEBS.pl \
ebs-create-managedserver -contextfile=<CONTEXT_FILE> \
-managedsrvname=oacore_server2 -servicetype=oacore \
-managedsrvport=7203 -logfile=<APPLRGF>/TXK/addMS_oacoreserver2.log

Note:
The managed server name must be of the form <SERVICE_TYPE>_server<n>, where n is an integer.
As well as being free, the port number for each managed server must be unique: no two managed servers
across the run and
patch file systems can have the same port number.

2. Startup the managed server as follows:

On Unix:

$ sh <ADMIN_SCRIPTS_HOME>/admanagedsrvctl.sh start <MANAGED SERVER NAME>

On Windows:

C:\><ADMIN_SCRIPTS_HOME>\admanagedsrvctl.cmd start <MANAGED SERVER NAME>

For example, to startup the newly added managed server 'oacore_server2', execute the following command:

$ sh <ADMIN_SCRIPTS_HOME>/admanagedsrvctl.sh start oacore_server2

https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=541406953262314&id=1905593.1&_adf.ctrl-state=1df9sxmnz5_57 7/11
4/5/2019 Document 1905593.1

3. Perform the following steps on all application tier nodes participating in the same cluster where this managed server is
added:

1. Source the run file system.

2. Execute the following command to add details of the newly added managed servers into the OHS configuration
files mod_wl_ohs.conf and apps.conf on the current node:

$ perl <FND_TOP>/patch/115/bin/txkSetAppsConf.pl \
-contextfile=<CONTEXT_FILE> \
-configoption=addMS \
-oacore=<host>.<domain>:<port> \
-oafm=<host>.<domain>:<port> \
-forms=<host>.<domain>:<port> \
-formsc4ws=<host>.<domain>:<port>

where
The argument contextfile accepts the complete path to the context file.
The arguments oacore, oafm, forms, formsc4ws accept a comma-separated list of managed server
details in the following format:
<host>.<domain>:<port>
host and domain are the hostname and domain name of the newly added node
port is the port of the new managed server whose reference is to be added

For example, if the managed server oacore_server2 has been added on host 'testserver' and domain
'example.com' with port 7205, the following command should be executed:

$ perl <FND_TOP>/patch/115/bin/txkSetAppsConf.pl -contextfile=<CONTEXT_FILE> \

-configoption=addMS -oacore=testserver.example.com:7205

3. If Oracle HTTP Server is enabled on the node, restart it as follows:

On UNIX:

$ sh <ADMIN_SCRIPTS_HOME>/adapcctl.sh stop
$ sh <ADMIN_SCRIPTS_HOME>/adapcctl.sh start

On Windows:

C:\><ADMIN_SCRIPTS_HOME>\adapcctl.cmd stop
C:\><ADMIN_SCRIPTS_HOME>\adapcctl.cmd start

4.4.2 Removing a managed server

The following steps should be executed in order to delete a managed server from the domain. As in the case of managed server
addition, deletion of managed servers should be done on the run file system, with synchronization between the run and the
patch file systems subsequently being performed automatically during adop prepare execution or during fs_clone.

Note: Managed server deletion should be done only through the adProvisionEBS.pl script as mentioned in this section.
Managed servers should not be deleted from the WebLogic Server Administration Console.

To delete a managed server of a specific service type, perform the following steps on the run file system:

1. Perform the following steps on the application tier where the managed server resides.

1. If the managed server to be deleted is running, shut it down as follows:

On Unix:

$ sh <ADMIN_SCRIPTS_HOME>/admanagedsrvctl.sh stop <MANAGED SERVER NAME>

On Windows:

C:\><ADMIN_SCRIPTS_HOME>\admanagedsrvctl.cmd stop <MANAGED SERVER NAME>

For example, before deleting a managed server 'oacore_server2', execute the following command to shut it down.

$ sh <ADMIN_SCRIPTS_HOME>/admanagedsrvctl.sh stop oacore_server2

2. Run the command below on the application tier node where the managed server resides. This will delete the
managed server, and also update the respective context variables that contain references to the deleted managed
server.

$ perl <AD_TOP>/patch/115/bin/adProvisionEBS.pl \
ebs-delete-managedserver \
-contextfile=<CONTEXT_FILE> -managedsrvname=<MANAGED_SERVER_NAME> \
-servicetype=<SERVICE_TYPE> -logfile=<LOGFILE>

https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=541406953262314&id=1905593.1&_adf.ctrl-state=1df9sxmnz5_57 8/11
4/5/2019 Document 1905593.1

For example, for deleting a managed server 'oacore_server2' of type 'oacore', execute the following command:

$ perl <AD_TOP>/patch/115/bin/adProvisionEBS.pl \
ebs-delete-managedserver \
-contextfile=<CONTEXT_FILE> -managedsrvname=oacore_server2 \
-servicetype=oacore -logfile=<APPLRGF>/TXK/delMS_oacoreserver2.log

2. Perform the following steps on all application tier nodes participating in the same cluster as the deleted managed server:

1. Source the run file system.

2. If the deleted managed server is part of the cluster configuration defined on the current node, execute the
following command to delete details of the managed server from the OHS configuration files mod_wl_ohs.conf and
apps.conf on the current node:

$ perl <FND_TOP>/patch/115/bin/txkSetAppsConf.pl \
-contextfile=<CONTEXT_FILE> \
-configoption=removeMS \
-oacore=<host>.<domain>:<port> \
-oafm=<host>.<domain>:<port> \
-forms=<host>.<domain>:<port> \
-formsc4ws=<host>.<domain>:<port> \
-ekanban=<host>.<domain>:<port> \
-accessgate=<host>.<domain>:<port> \
-yms=<host>.<domain>:<port>

where
The argument contextfile accepts the complete path to the context file.
The arguments oacore, oafm, forms, formsc4ws, ekanban, accessgate and yms accept a comma-
separated list of managed server details in the following format:
<host>.<domain>:<port>
host, domain and port are the hostname, domain and port of the managed server whose
reference is to be deleted.

For example, to remove references of the deleted managed server oacore_server2 with port 7205 on host
'testserver' and domain 'example.com', the following command should be executed:

$ perl <FND_TOP>/patch/115/bin/txkSetAppsConf.pl -contextfile=<CONTEXT_FILE> \

-configoption=removeMS -oacore=testserver.example.com:7205

3. If Oracle HTTP Server is enabled on the node, restart it as follows:

On UNIX:

$ sh <ADMIN_SCRIPTS_HOME>/adapcctl.sh stop
$ sh <ADMIN_SCRIPTS_HOME>/adapcctl.sh start

On Windows:

C:\><ADMIN_SCRIPTS_HOME>\adapcctl.cmd stop
C:\><ADMIN_SCRIPTS_HOME>\adapcctl.cmd start

Section 5: Updating the Classpath and JVM Arguments of the WebLogic AdminServer
When the WebLogic AdminServer is started, the classpath and JVM arguments are picked up from the values of the context
variables s_adminserver_classpath and s_nm_jvm_startup_properties respectively.

In order to update these WebLogic AdminServer properties, perform the following steps on the run file system of the primary
node:

1. Update the respective context variable ( s_adminserver_classpath for updating the AdminServer classpath and
s_nm_jvm_startup_properties for updating the AdminServer JVM arguments).

2. Run AutoConfig on the Application tier.

3. Bounce the WebLogic AdminServer as follows:

On UNIX:

$ sh <ADMIN_SCRIPTS_HOME>/adadminsrvctl.sh stop
$ sh <ADMIN_SCRIPTS_HOME>/adadminsrvctl.sh start

On Windows:

C:\><ADMIN_SCRIPTS_HOME>\adadminsrvctl.cmd stop
C:\><ADMIN_SCRIPTS_HOME>\adadminsrvctl.cmd start

Note: Setting the WebLogic AdminServer classpath or JVM arguments from the WebLogic Administration Console or using
WLST will not enforce any changes to these properties as the values will be always picked up from the respective context
variables as mentioned above.

https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=541406953262314&id=1905593.1&_adf.ctrl-state=1df9sxmnz5_57 9/11
4/5/2019 Document 1905593.1

Section 6: Known Issues

This section lists any known issues with the AutoConfig-related configuration management of Oracle E-Business Suite Release
12.2 environments.

Issue 1

On a multi-node installation with the Forms Services and Batch Processing Services enabled on separate nodes, OAM fails to
update the context variables on the Batch Processing Services node.

Solution:

Check whether the Listener Service is up on the Forms Services node. If the service is down, start the service using one of the
following options:

Start the TNS listener service manually using the following command:

On UNIX:

$ $INST_TOP/admin/scripts/adalnctl.sh start <TWO_TASK>

On Windows:

C:\>%INST_TOP%\admin\scripts\adalnctl.cmd start <LOCAL>

Enable management of the TNS Listener Service using the adstrtal or adstpall scripts on the Forms Services node.
1. Enable the TNS Listener Service by following the steps mentioned earlier.
2. Stop all the application tier services using adstpall.sh or adstpall.cmd.
3. Start all the application tier services using adstrtal.sh or adstrtal.cmd.

Change Log

Date Description

Updated the list of AutoConfig-managed OHS templates.

01-Aug-2016
Updated the steps for changing the seeded OHS configuration.

Inserted Section 2 regarding tools for synchronization and added the section for Known Issues.
29-Jan-2015
Updated Section 3.2 and Section 3.3.

24-Sep-2014 Added new section for updating AdminServer properties and updated Section 4.2.2.

08-Aug-2014 Initial publication.

Documentation Notices
Copyright © 2014, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure
and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you
may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any
part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law
for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any
errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S.
Government, the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed
on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant
to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication,
disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs
installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the
programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed
or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If
you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe,
backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any
damages caused by use of this software or hardware in dangerous applications.

https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=541406953262314&id=1905593.1&_adf.ctrl-state=1df9sxmnz5_57 10/11
4/5/2019 Document 1905593.1
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective
owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license
and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron
logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information on content, products, and services from
third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with
respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss,
costs, or damages incurred due to your access to or use of third-party content, products, or services.

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit
http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you
are hearing impaired.

Didn't find what you are looking for? Ask in Community...

Related
Products

Oracle E-Business Suite > Applications Technology > Technology Components > Oracle E-Business Suite Technology Stack > Advanced Configurations
Oracle E-Business Suite > Applications Technology > Application Object Library > Oracle Concurrent Processing > Viewing request output > Viewing request output

Keywords
CLONE; E-BUSINESS; EBS; ORACLE

Back to Top
Copyright (c) 2019, Oracle. All rights reserved. Legal Notices and Terms of Use Privacy Statement

https://support.oracle.com/epmos/faces/DocumentDisplay?_afrLoop=541406953262314&id=1905593.1&_adf.ctrl-state=1df9sxmnz5_57 11/11