2 Getting Started with Administering Oracle SOA Suite

This chapter describes how to access Oracle Enterprise Manager Fusion Middleware Control Console and SOA Infrastructure configuration, monitoring, and management tasks.

This chapter includes the following topics:

• Section 2.1, "Logging into Oracle Enterprise Manager Fusion Middleware Control Console"

• Section 2.2, "Navigating to Oracle SOA Suite Administration Tasks"

• Section 2.3, "Logging Out of Oracle Enterprise Manager Fusion Middleware Control Console"

For more information about service engines, service components, binding components, and the SOA Infrastructure, see Chapter 1, "Introduction and Concepts."

2.1 Logging into Oracle Enterprise Manager Fusion Middleware Control Console

To log in to Oracle Enterprise Manager Fusion Middleware Control Console:

1. Use Internet Explorer 7, Mozilla Firefox 2.0.0.2, Safari 4.0, or Firefox 3.0.x to access the following URL:

   http://host_name:port/em
   

   where host_name is the name of the host on which Oracle Enterprise Manager Fusion Middleware Control Console is installed and port is a number that is dynamically set during installation. This port is typically 7001, but is the HTTP port associated with the Oracle HTTP Server. For environments in which the SSL port was enabled during configuration, the default port is 7002.

2. Enter weblogic/password and click Login.

   where:

   • weblogic is the default Oracle Enterprise Manager Fusion Middleware Control Console administrator user name (you can change this during installation)

   • password is the password you entered during Oracle SOA Suite installation

   The Accessibility Preference dialog appears the first time you log in. If you want, you can select to not display this option again.

3. Select an appropriate action and click Continue.

   The farm home page is displayed. From there, you can navigate to Oracle SOA Suite in several different ways, as described in the following sections.

For more information about installation, see Oracle Fusion Middleware Installation Guide for Oracle SOA Suite.

2.2 Navigating to Oracle SOA Suite Administration Tasks

This section describes methods for navigating to Oracle SOA Suite administration tasks in Oracle Enterprise Manager Fusion Middleware Control Console:

• Section 2.2.1, "Navigating Through the SOA Infrastructure Home Page and Menu"

• Section 2.2.2, "Navigating Through the SOA Composite Application Home Page and Menu"

• Section 2.2.3, "Navigating to Deployed Java EE Applications"

• Section 2.2.4, "Navigating to the Oracle WebLogic Server Administration Console and Other Pages"

• Section 2.2.5, "Navigating to the SOA Infrastructure or SOA Composite Application Home Page"

Note: Note that the Farm menu always displays at the top of the navigator. As you expand the SOA folder in the navigator and click the links displayed beneath it, the SOA Infrastructure menu becomes available at the top of the page.

2.2.1 Navigating Through the SOA Infrastructure Home Page and Menu

You can navigate to Oracle SOA Suite administration tasks through the SOA Infrastructure home page and menu. The SOA Infrastructure provides you with access to all deployed SOA composite applications, service engines, service components, business events, and other elements.

To navigate through the SOA Infrastructure home page and menu:

1. Expand SOA > soa-infra in the navigator.

   This displays all SOA composite applications running in the SOA Infrastructure for that managed server.

   
   Description of the illustration sca_soamenu2.gif
   
   

2. Click soa-infra.

   This displays the Dashboard page of the SOA Infrastructure. Click the help icon at the top of this page to access the Resource Center for the entire Oracle SOA Suite. The upper part of the page displays details about recently deployed SOA composite application instances, deployed composites, recent faults, and rejected messages. You can click a specific SOA composite application name or instance ID to access additional details. You can also click Show All at the bottom of each section to see more information about all items.

   
   Description of the illustration gs_soahomepage.gif
   
   

   The lower part of the page displays details about the service engines provided by the SOA Infrastructure and a graphical representation of the number of instances and faults for all SOA composite applications hosted in the SOA Infrastructure. You must expand these sections to see this information. Click a service engine name to access more specific details.

3. Note that the SOA Infrastructure menu appears below the soa-infra name at the top of the page.

   
   

   Note: Depending upon your current location, the context of this menu changes to provide you with the administrative options most relevant to your current location. For example, when you are within the pages of a SOA composite application, the SOA Composite menu displays instead.

   
   

4. Select the SOA Infrastructure menu.

   
   Description of the illustration sca_menu2.gif
   
   

   These administrative options enable you to perform the following tasks.

   Option	Description
   Home	This option displays the following details of the SOA Infrastructure Dashboard page: Recent SOA composite application instances. Deployed SOA composite details (status, instance, and fault counts). Recent faults and rejected messages in all SOA composite application instances, including whether the instance is recoverable. Number of components hosted by services engines and the faults in those components. Graphical representation of the number of instances and faults for all SOA composite applications hosted in the SOA Infrastructure. For more information, see Section 4.1, "Monitoring SOA Infrastructure Recent Instances and Faults."
   Monitoring	This option displays the following details: A summary of performance statistics in the SOA infrastructure. Request processing details that show the breakup of time spent in handshaking requests between the binding components, service infrastructure, and service engines. For more information, see Section 4.2, "Monitoring Processing Requests."
   Control	This option enables you to start or shut down the SOA Infrastructure.
   Logs	This option enables you to view and configure the logging levels for run-time loggers. For more information, see Section 3.4, "Configuring Log Files."
   SOA Deployment	This option enables you to deploy, undeploy, or redeploy SOA composite applications. For more information, see Section 5.1, "Deploying Applications."
   Service Engines	This option provides access to monitoring and management tasks for the BPEL process, Oracle Mediator, human workflow, and business rules service engines.
   Bindings	This option displays details about recently active document types and trading partners, and inbound and outbound endpoints for Oracle B2B.
   Services and References	This option displays message processing metrics for service and reference binding components in all SOA composite applications. For more information, see Section 4.3, "Monitoring Service and Reference Binding Components in the SOA Infrastructure."
   Business Events	This option displays available business events, current event subscribers, and fault details. For more information, see Chapter 32, "Managing Business Events."
   SOA Administration	This option provides access to the following configuration tasks for the SOA Infrastructure and each service engine: Common Properties: For setting properties that impact the entire SOA Infrastructure, such as viewing and setting the SOA Infrastructure audit level, capturing the state of the SOA composite application instance, enabling the payload validation of incoming messages, specifying the callback server and server URLs, setting UDDI registry properties, viewing the data source JNDI locations, setting the nonfatal connection retry count, setting Web service binding properties, and disabling the retrieval of instance and fault count metrics. For more information, see Section 3.1, "Configuring SOA Infrastructure Properties." BPEL Properties: For setting the audit trail size, maximum document size for a variable, payload validation for incoming and outgoing messages, audit trail level, BPEL monitor and sensor disabling status, and dispatcher thread level for invoke message threads, system threads, and engine threads. For more information, see Section 9.1, "Configuring BPEL Process Service Engine Properties." Mediator Properties: For setting the audit level, metrics level, number of parallel worker threads, number of maximum rows retrieved for parallel processing, parallel thread sleep values, error thread sleep values, container ID refresh time, and container ID lease timeout values. For more information, see Section 12.1, "Introduction to Configuring Oracle Mediator." Workflow Notification Properties: For setting the workflow service notification mode and actionable e-mail address value. For more information, see Section 18.1, "Configuring Human Workflow Notification Properties." Workflow Task Service Properties: For setting the actionable e-mail account, adding the worklist application URL, selecting the pushback assignee, adding portal realm mapping, and adding the task auto release configuration priority. For more information, see Section 18.2, "Configuring Human Workflow Task Service Properties." B2B Server Properties: For enabling Dynamic Monitoring Service (DMS) metrics. Cross References: For selecting cross-reference values.
   Security	This option displays the following selections: Application Policies: For creating application policies that an application relies upon for controlling access to resources. Application Roles: For creating application roles for applications. This option is available for all deployed Java EE applications, including the SOA Infrastructure (soa-infra) application. Note that these options do not configure security policies for SOA composites. For more information about attaching policies to composite applications, see Section 8.8, "Managing SOA Composite Application Policies."
   Administration	This option displays the following selections: MDS Connections: For managing metadata service (MDS) connections. TopLink Sessions: For managing cache for the TopLink persistence framework. System MBean Browser: For advanced configuration of properties across applications and components. For more information, see Oracle Fusion Middleware Administrator's Guide for instructions on using the System Mean Browser. In addition to configuring the System MBean Browser from Oracle Enterprise Manager Fusion Middleware Control Console, you also can invoke SOA configuration MBean operations with the Web Logic Scripting Tool (WLST). For information, see Oracle Fusion Middleware Oracle WebLogic Scripting Tool.
   General Information	This option displays general details about the SOA Infrastructure, such as the Oracle Enterprise Manager Fusion Middleware Control Console version, Oracle home, and Oracle instance.

   
   

5. Select a specific SOA composite application from the soa-infra list shown in Step 1 (for example, AutoLoanComposite).

   The SOA Infrastructure menu is now displayed above the navigator, providing you with access to the same high-level administrative options, even when you are within the pages of a SOA composite application. This menu changes positions when you select a composite application.

   
   Description of the illustration soainfra_menu2.gif
   
   

6. Right-click soa-infra in the navigator. The menu that displays provides you with access to the same administrative options that appear in the SOA Infrastructure menu.

2.2.2 Navigating Through the SOA Composite Application Home Page and Menu

You can navigate directly to Oracle SOA Suite administration tasks for a specific SOA composite application.

To navigate through the SOA composite application home page and menu:

1. Expand SOA > soa-infra in the navigator.

   This displays all SOA composite applications running in the SOA Infrastructure.

   
   Description of the illustration sca_soamenu2.gif
   
   

2. Select a specific SOA composite application (for this example, AutoLoanComposite [1.0] is selected).

   This displays the home page for the selected SOA composite application. The upper part of the page displays details about recent instances and faults and rejected messages. This part of the page also provides you with access to important administrative and configuration tasks at the composite level.

   
   Description of the illustration soaapp_upper_helloworld.gif
   
   

3. Click Show All at the bottom of each section to see more of these items. You can also click links to access more details about a specific composite instance or fault.

   The lower part of the page displays details about the service components (in this example, decision service (business rules), BPEL process, and human workflow) and binding components (services and references) included in the SOA composite application. You can click a specific service component or service or reference binding component in the Name column to access more specific details.

   
   Description of the illustration soaapp_lower_helloworld.gif
   
   

   When you are within the pages of a SOA composite application, the SOA Composite menu appears below the application name at the top of the page. This menu provides you with administrative options specific to the current composite application.

4. Select the SOA Composite menu.

   
   Description of the illustration sca_compositelist.gif
   
   

   These administrative options enable you to perform the following tasks.

   Option	Description
   Home	This option displays the following details for the SOA composite application home page. Recent instances. Recent faults and rejected messages, including whether the instance is recoverable. Service components included in the SOA composite application. Services and references included in the SOA composite application. For more information, see Section 8.2, "Managing the State of Deployed SOA Composite Applications."
   Monitoring	This option displays the performance summary statistics for the selected SOA composite application.
   SOA Deployment	This option enables you to undeploy or redeploy this SOA composite application, or deploy another SOA composite application. For more information, see Section 5.1, "Deploying Applications."
   Export	This option enables you to export a running SOA composite application to a JAR file. For more information, see Section 8.10, "Exporting a Running SOA Composite Application."
   Test Service	This option enables you to manually initiate an instance of this deployed SOA composite application through the Test Web Service page. For more information, see Section 8.1, "Initiating a SOA Composite Application Test Instance."
   Unit Tests	This option enables you to run test cases that simulate the interaction between the current SOA composite application and its Web service partners before deployment to a production environment. This generates test instances of the composite. For more information, see Section 8.7, "Automating the Testing of SOA Composite Applications."
   Policies	This option enables you to view and attach or detach policies to or from the SOA composite application. For more information, see Section 8.8, "Managing SOA Composite Application Policies."
   SOA Infrastructure	This option takes you to the SOA Infrastructure home page.
   SOA Infrastructure Common Properties	This option enables you to view and set the audit level, capture the state of the SOA composite application instance, enable the payload validation of incoming messages, set UDDI registry properties, specify the callback server and server URLs, view the data source JNDI locations, set the nonfatal connection retry counts, set Web service binding properties, and disable the retrieval of instance and fault count metrics. The SOA composite application typically inherits the settings defined at the SOA Infrastructure level. For more information, see Section 3.1, "Configuring SOA Infrastructure Properties."
   Service/ Reference Properties	This option enables you to configure WSDL file properties for the service and reference binding components included in the SOA composite application. For more information, see Section 33.1, "Configuring Service and Reference Binding Component Properties."
   General Information	This option displays general details about this SOA composite application, such as the Oracle Enterprise Manager Fusion Middleware Control Console version, Oracle home, and Oracle instance.

   
   

5. Right-click the name of a SOA composite application in the navigator. A menu is displayed that provides you with access to the same administrative options that appear in the SOA Composite menu.

2.2.3 Navigating to Deployed Java EE Applications

You can navigate to deployed Java EE applications related to Oracle SOA Suite components. These applications are Java EE applications that represent the SOA system components, such as the technology adapters, Oracle B2B, Oracle BPM Worklist, and so on. You can deploy a Web service and see it listed here. You can also click individual applications (for example, the deployed Web service) and manage and test that you can deploy WAR and EAR files from here. If you have deployed your own Java EE applications, they also display here.

1. Expand Application Deployments in the navigator.

2. Expand Internal Applications.

3. Expand Resource Adapters.

   A list of deployed Java EE applications related to Oracle SOA Suite components appears.

   
   Description of the illustration sca_deployapp.gif
   
   

   Note that Oracle B2B (b2bui) appears in the Internal Applications folder, while Oracle BPM Worklist (worklistapp) appears in the top level Application Deployments folder.

4. Click a specific application (for this example, worklistapp is selected).

   The page displays details about application performance.

   
   Description of the illustration sca_deployapp2.gif
   
   

   Note that while Oracle Enterprise Manager Fusion Middleware Control Console displays the URLs for all deployed modules, you cannot directly invoke them from this page. For example, you cannot invoke the DefaultToDoTaskFlow module from the Web Modules section.

2.2.4 Navigating to the Oracle WebLogic Server Administration Console and Other Pages

Most pages in Oracle Enterprise Manager Fusion Middleware Control Console include a Related Links menu in the upper right corner. Depending upon your current location, the context of the menu changes to provide links to relevant pages. For example, when you are on a service engine page, the Related Links menu provides links to the SOA Infrastructure home page, the BPEL process configuration properties page, the Oracle WebLogic Server Administration Console, and a page for service engine log files. Figure 2-1 provides details. You can also click soa-infra at the top of the BPEL service engine page to go directly to the SOA Infrastructure home page.

Figure 2-1 Related Links Menu for a SOA Composite Application

Description of "Figure 2-1 Related Links Menu for a SOA Composite Application"

When you are on the page of a service component of a SOA composite application, several navigational menus and links are available:

• The Related Links menu provides links to the SOA Infrastructure home page and the applicable service engine home page. Figure 2-2 provides details.

• Bread crumbs display in the upper left corner as you traverse further into a SOA composite application.

• Within any SOA composite application page (including the service component pages), links to the SOA Infrastructure pages also remain available through the SOA Infrastructure menu that displays next to the Farm menu above the navigator. For example, this enables you to go from the home page of a specific BPEL service component directly to the BPEL service engine configuration properties page.

• Names at the top of the page can be clicked to navigate to parent pages. For example, clicking the name of a composite at the very top of a service component page enables you to go to the composite that includes that component.

Figure 2-2 Related Links Menu for a Service Component of a SOA Composite Application

Description of "Figure 2-2 Related Links Menu for a Service Component of a SOA Composite Application"

The service engines, SOA administration (such as the SOA Infrastructure Common Properties page), and business event pages all provide access to Oracle WebLogic Server Administration Console from the Related Topics list. Selecting WebLogic Server Console opens a new browser page and takes you to the login prompt for the Oracle WebLogic Server Administration Console. Your current page in Oracle Enterprise Manager Fusion Middleware Control Console is not lost. After logging in, the home page is displayed. Figure 2-3 provides details.

Figure 2-3 Oracle WebLogic Server Administration Console

Description of "Figure 2-3 Oracle WebLogic Server Administration Console"

You can perform the following Oracle SOA Suite tasks from Oracle WebLogic Server Administration Console:

• Configure adapter connections for composite references

• Create and manage data sources utilized by adapters

• Create and manage JMS resources utilized by adapters

• Manage SOA Infrastructure data sources (for example, modifying connection pool settings)

• Administer security of human workflow users

• Manage Oracle WebLogic Server transaction (JTA) settings (for example, the transaction timeout value)

2.2.5 Navigating to the SOA Infrastructure or SOA Composite Application Home Page

You can access the home page of the SOA Infrastructure or a specific SOA composite application from the Farm home page.

1. In the Deployments section of the Farm home page, click soa-infra or a specific SOA composite application (for example, VacationRequest).

   
   Description of the illustration sca_menu3.gif
   
   

   The home page for your selection is displayed.

2.3 Logging Out of Oracle Enterprise Manager Fusion Middleware Control Console

To log out of Oracle Enterprise Manager Fusion Middleware Control Console:

1. Note the following details about logging out.

   • If multiple windows are open (for example, the help window, topology viewer, and flow trace), logging out of any window logs you out of the entire application in all open windows.

   • If you log out with any unsaved configuration changes, you receive no warning message and your changes are lost.

2. In the upper right corner of any page, click the Log Out link.