This chapter includes the following sections:
You can deploy, manage, monitor, and configure applications developed with Oracle ADF in a WebLogic Server. Use Enterprise Manager Fusion Middleware Control to perform these tasks.
After you have deployed an ADF application to Oracle WebLogic Server, you can view the application performance and configure application properties on the server. You can use Enterprise Manager Fusion Middleware Control to perform these tasks.
Enterprise Manager Fusion Middleware Control offers a user interface for the performance tasks. Some configuration tasks can be performed either from a user interface or by configuring an MBean, as listed in Table 3-1.
Table 3-1 Configuration Tasks Using Fusion Middleware Control
Configuration tasks | Fusion Middleware Control UI | Fusion Middleware Control MBean Browser |
---|---|---|
ADF Business Components |
Modifying ADF Business Components Configurations Using MBeans |
|
ADF connections |
||
ADF application configuration |
||
Metadata Services (MDS) |
||
Active Data Service (ADS) |
By default, the post-deployment changes made using MBeans are stored in MDS with a layer name of adfshare
and a layer value of adfshare
. You can provide a specific layer name by specifying the adfAppUId
property in the application's adf-config.xml
.
The following example shows the adf-properties-child
code in adf-config.xml
.
<adf:adf-properties-child xmlns="http://xmlns.oracle.com/adf/config/properties"> <adf-property name="adfAppUID" value="DeptApp.myApp"/> </adf:adf-properties-child>
If you are moving data between MDS repositories (for example, from a test to a production system), use the MDS exportMetadata
and importMetadata
commands as described in the Managing the Metadata Repository of the Administering Oracle Fusion Middleware and in the Metadata Services (MDS) Custom WLST Commands of the WLST Command Reference for Infrastructure Components.
You can monitor the performance of ADF applications. Use Fusion Middleware Control to view the application performance, application module pool performance, ADF task flow performance, and the ADF runtime JAR version.
You can monitor the performance of Oracle ADF applications using the Fusion Middleware Control, as described in the following topics:
You can view performance information about application module pools and ADF task flows. Application module components can be used to support a unit of work which spans multiple browser pages.
You can:
View application module pool performance.
View task flow performance.
You can use find the version information for ADF runtime JAR files and display the results in a table or export the information to an Excel file. You can narrow down your results by specifying a filter for each column.
To finding version information of runtime JARs:
You can view performance information about application modules. Application module components can be used to support a unit of work which spans multiple browser pages.
To view application performance:
An application module pool is a collection of instances of a single application module type which are shared by multiple application clients. One application module pool is created for each root application module used by an ADF web application (ADF Business Components, ADF Controller, or ADF Faces) in each Java virtual machine where a root application module of that type is used by the ADF Controller layer.
To view application module pool performance:
You can view performance information about task flows. Task flows provide a modular and transactional approach to navigation and application control. Task flows mostly contain pages that will be viewed, but they also can contain activities that call methods on managed beans, evaluate an EL expression, or call another task flow, all without invoking a particular page.
To view task flow performance:
After you have deployed an ADF application to Oracle WebLogic Server, you can configure application properties on the server. Use Fusion Middleware Control to configure ADF application configuration parameters.
These configuration parameters are stored in ADF MBeans. Fusion Middleware Control provides a user interface to configure the ADF Business Components and ADF Connections MBeans. You can also use the System MBean Browser to directly access the underlying MBeans and configure their values. For more information about accessing the underlying MBeans, see Configuring Application Properties Using the MBean Browser.
You can use Fusion Middleware Control to configure ADF parameters, as described in the following topics:
You control the runtime behavior of an application module pool by setting appropriate configuration parameters. Fusion Middleware Control provides a UI to configure ADF Business Components, as described in this section. You can also configure the ADF Business Components MBeans directly using the generic MBean Browser, as described in Modifying ADF Business Components Configurations Using MBeans
To modify Business Components parameters:
The ADF Business Components configurations page is arranged with the following sections or tabs:
Application Modules section
Pooling and Scalability tab - Application Pool Properties
Pooling and Scalability tab - Connection Pool Properties
Core tab
Database Properties tab
Security Properties tab
A connection configuration contains information that a client application uses to identify the ADF application module's deployment scenario. You use Oracle Enterprise Manager Fusion Middleware Control to:
Register and manage back-end services such as mail, discussion forums servers, and so on
Register and manage external applications that users need access to while working with applications
Register and manage any portlet producers that the application uses or that users may need access to
Fusion Middleware Control provides a UI to configure ADF connections, as described in this section. You can also configure the ADF connections MBean directly using the System MBean Browser, as described in Modifying ADF Connections Using MBeans.
You must already have deployed an Oracle ADF application and have Enterprise Manager Fusion Middleware Control available to access the application.
You must have MDS configured in your application before you can modify the ADF application and connection configurations. ADF connection attributes are persisted to MDS.
If you deployed an application to several nodes within a cluster, any ADF connection changes to a single node will be propagated to all the other nodes. MDS will store a single set of connection information for all versions of an application.
To modify connection configurations:
Fusion Middleware Control MBean Browser is a web application used to access and modify the values of MBeans for an ADF application deployed into Oracle WebLogic Server.
You can use the Fusion Middleware Control System MBean Browser to perform configuration tasks, as described in the following topics:
You can modify ADF application configurations MBeans using the MBean Browser.
You must have MDS configured in your application before you can modify the ADF application and connection configurations. ADF application attributes are persisted to MDS.
If you deployed an application to several nodes within a cluster, any ADF application configuration changes to a single node via an MBean will be propagated to all the other nodes. MDS will store a single set of ADF application configuration information for all versions of an application.
To modify ADF application configurations using the System MBean Browser:
You can modify ADF connection configurations MBean using the MBean Browser.
You can also modify ADF connections using the Fusion Middleware UI described in Modifying Connection Configurations.
You must have MDS configured in your application before you can modify the ADF application and connection configurations. ADF application attributes are persisted to MDS.
If you deployed an application to several nodes within a cluster, any ADF connection changes to a single node via an MBean will be propagated to all the other nodes. MDS will store a single set of ADF application configuration information for all versions of an application.
To modify ADF connections configurations using the System MBean Browser:
You can modify ADF Business Components configurations MBeans using the MBean Browser. ADF Business Component configuration information are stored in MBeans that are specific for each application. Unlike ADF connections and ADF application configuration information which you can configure once for all versions of the same application, you will need to configure ADF Business Components for each version of the application.
You can also modify ADF Business Components configuration information using the Fusion Middleware UI described in Modifying ADF Business Components Parameters.
You must have MDS configured in your application before you can modify the ADF application and connection configurations. ADF application attributes are persisted to MDS.
If you deployed an application to several nodes within a cluster, any ADF Business Components changes to a single node via MBeans will be propagated to all the other nodes. MDS will store a single set of ADF application configuration information for all versions of an application.
To modify ADF Business Components configurations using the System MBean Browser:
You can use the MBean Browser to perform advanced configuration of MDS parameters. For more information about configuring MDS using MBeans, see Changing the MDS Configuration Attributes Using Fusion Middleware Control in Administering Oracle Fusion Middleware.
You must already have deployed an Oracle ADF application and have Enterprise Manager Fusion Middleware Control available to access the application.
To modify MDS configurations using the System MBean Browser:
You can use Active Data Service (ADS) framework to control the runtime behavior of an Oracle ADF application and qualifying ADF Faces components so that whenever data changes on the server, the ADF Model layer notifies the component and the component rerenders the changed data.
You must already have deployed an Oracle ADF application and have Enterprise Manager Fusion Middleware Control available to access the application.
Note that the ADF Faces components of your application must be configured to use ADS. Additionally, if your application services do not support ADS, then your application must define a service proxy so that the components can display the data as it updates in the source. For details about ADS, see Using the Active Data Service in Developing Fusion Web Applications with Oracle Application Development Framework.
To modify Active Data Service configurations using the System MBean Browser:
Credentials can be provisioned, retrieved, modified, or deleted, but only by a user in the appropriate administration role. As an administrator, you can manage credentials using Fusion Middleware Control.
You can use Enterprise Manager Fusion Middleware Control to edit credentials that were deployed with an ADF application to the credential store. You can also create new credentials and delete existing credentials.
For ADF applications, the following considerations apply:
The Map name is typically the adfAppUId
property defined in the application's adf-config.xml
file.
The Key name is typically in the format anonymous#
connection
, where connection
is the connection name.
The Credential Type is Generic and it is modeled as a hash map of key-value pairs.
For more information, see Managing Credentials with Fusion Middleware Control in Securing Applications with Oracle Platform Security Services.