Managing WebLogic Integration Solutions

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Managing WebLogic Integration Solutions: Tools and Tasks

This section provides an overview of the tools and tasks involved in managing WebLogic Integration solutions. The following topics are provided:

Note: Throughout this section, the focus is on administrative tasks and tools that are specific to WebLogic Integration. For more details, see Introduction to WebLogic Platform™ Administration.

 


WebLogic Integration Management Tools

The following tools are available to support WebLogic Integration administration:

In addition to the above, WebLogic Server provides a number of tools with which you should be familiar. For more information, see " System Administration for BEA WebLogic Server.

Note: Items or tools on http://dev2dev.com are listed for your convenience and are not supported by BEA Customer Support.Arrow symbol

 


WebLogic Managed Beans

Resources within a domain use Java Management Extensions (JMX) Managed Beans (MBeans) to expose their management functions. An MBean is a concrete Java class that is developed per JMX specifications. It can provide getter and setter operations for each management attribute within a managed resource along with additional management operations that the resource makes available. MBeans that expose the configuration data of a managed resource are called Configuration MBeans, while MBeans that provide performance metrics and other information about the runtime state of a managed resource are called Runtime MBeans.

To learn more about WebLogic Server managed resources and MBeans, see Overview of WebLogic JMX Services in Programming WebLogic Management Services with JMX.

To learn more about the WebLogic Integration MBeans, refer to the following packages in the WebLogic Integration Javadoc:

Programmatically Accessing WebLogic Integration MBeans

The weblogic.management.MBeanHome interface is the most convenient way to access the JMX MBean Server that resides on each WebLogic Server in a domain. You can access the Administration MBeanHome interface from the JNDI tree of the Administration Server as described in "Using JNDI to Retrieve an MBeanHome Interface" in Accessing WebLogic Server MBeans at the following URL:

http://download.oracle.com/docs/cd/E13222_01/wls/docs92/jmx/accessWLS.html

The following example shows how you can access the ProcessRuntimeMBean interface:

Listing 1-1 Programmatically Accessing ProcessRuntimeMBean
Environment env = new Environment(); 
env.setSecurityPrincipal("weblogic");
env.setSecurityCredentials("weblogic");
Context ctx = env.getInitialContext();
MBeanHome home = (MBeanHome)ctx.lookup(MBeanHome.ADMIN_JNDI_NAME);
System.out.println("Got the Server-specific MBeanHome: " + home);
Set s = home.getMBeansByType("ProcessRuntime");
Iterator it = s.iterator();

try {
while (it.hasNext()){
ProcessRuntimeMBean bean = (ProcessRuntimeMBean)it.next();
ProcessInstanceQuery query = new ProcessInstanceQuery();
query.setServiceURI(context.getService().getURI());
ProcessInstanceQueryResult info = bean.getProcessInstances(query);
String[] instances = info.getInstanceIds();
System.out.println(instances[0]);
}
} catch (Exception ex) {
System.out.println(ex);
ex.printStackTrace();
}

 


WebLogic Integration Management Task Reference

This section provides references to the instructions and background information required to perform the most common WebLogic Integration administrative tasks:

Although a majority of the tasks can be performed using the WebLogic Integration Administration Console, some must be performed using other tools, and in some cases, you must directly edit a configuration file. You can use this section as a roadmap to the task-specific information that can be found in the following resources:

Document Title
URL
Managing WebLogic Integration Solutions
Using the WebLogic Integration Administration Console
Deploying WebLogic Integration Solutions
Configuring and Managing WebLogic Server
http://download.oracle.com/docs/cd/E13222_01/wls/docs92/adminguide/index.html
Creating WebLogic Configurations Using the Configuration Wizard
http://download.oracle.com/docs/cd/E13196_01/platform/docs92/confgwiz/index.html
Managing WebLogic Platform Database Resources
http://download.oracle.com/docs/cd/E13196_01/platform/docs92/db_mgmt/db_resource_mgmt.html
Security in WebLogic Platform 9.2
http://download.oracle.com/docs/cd/E13196_01/platform/docs92/secintro/index.html
Introducing Trading Partner Integration
Introducing Application Integration
Using the Worklist

Note: URLs are provided in the preceding table to assist those using a printed version of the documentation to locate the information referenced in the following sections. If you are viewing an HTML or PDF version of the documentation, the references in the following sections are active links.

Throughout this reference section, it is assumed that the WebLogic Integration Administration Console is to be used as the primary management tool. As described in WebLogic Integration Management Tools, alternative utilities, such as the SNMP Agent or WLShell, can be used to perform many tasks.

Creating or Extending Server Domains

A domain includes one or more instances of WebLogic Server and may include WebLogic Server clusters. WebLogic Integration is a collection of applications and resources—EJBs, Web applications, JDBC connection pools, and so on—that are deployed in a domain to provide a unified platform for developing and deploying comprehensive business integration solutions. A first step in the development or deployment of a WebLogic Integration solution is to create a suitable domain.

The following table provides a roadmap to the information you need to create or extend a development or production (running in "noniterativedev" mode) domain.

Table 1-1 Roadmap to Create or Extend a Domain
To. . .
Refer to. . .
The reference provides. . .
Create a basic single server or clustered domain
The following sections of Creating WebLogic Configurations Using the Configuration Wizard:
  • Overview of the WebLogic Configuration Wizard and Configuration Template Builder
  • Template Reference: Basic WebLogic Integration Domain
  • Template Reference: WebLogic Integration Extension Template
  • Tutorials: Using the Configuration Wizard
  • Creating a New WebLogic Domain
  • Configuring Managed Servers, Clusters, and Machines
  • Extending Domains
  • How Do I? . . . Creating XA Domains Using Configuration Templates
General information in the overview about WebLogic Server domains and how to use the Configuration Wizard.
The template reference sections provide information about the default WebLogic Integration templates provided by the Wizard.
The remaining sections provide procedural information.
Prepare a production domain
The following sections of Deploying WebLogic Integration Solutions:
Related tasks and references are provided in Deploying Integration Solutions and Securing WebLogic Integration Resources.
Describes key domain resources and deployment tasks in the introduction. It also provides a discussion of the roles played by system administrators, deployment specialists, and database administrators.
"Understanding WebLogic Integration Clusters" provides background and "Configuring a Clustered Deployment" provides step-by-step procedures.
Create the database tables required by WebLogic Integration
Additional references are provided in the following section, Managing Database Resources.
Describes the scripts provided to create the tables required by WebLogic Integration.

Managing Database Resources

For general information about managing database resources for WebLogic Platform, see Managing WebLogic Platform Database Resources.

For information about creating the tables required by WebLogic Integration, see Configuring a Production Database.

Deploying Integration Solutions

For information about deploying an integration application from the Workshop environment (running in iterative development mode), see Building and Deploying WebLogic Integration Applications in Building Integration Applications.

For the background information and procedures required to configure a production environment and deploy integration solutions, see Deploying WebLogic Integration Solutions.

Securing WebLogic Integration Resources

Note: This section focuses on security tasks and references that are specific to WebLogic Integration. For an overview of WebLogic Platform security see Security in WebLogic Platform 9.2.

The following table provides a roadmap to the information you need to secure WebLogic Integration resources.

Table 1-2 Roadmap to Secure WebLogic Integration Resources
To. . .
Refer to. . .
The reference provides. . .
Verify security provider requirements
Security Provider Requirements for User Management in the Worklist Console Help
Requirements.
Manage users, groups, and roles
User Management in the Worklist Console Help
Step-by-step procedures for adding, deleting, or updating users, groups, and roles.
Learn about users, groups, and roles in WebLogic Integration
WebLogic Integration Users, Groups, and Roles section in the Worklist Console Help.
A brief overview.
Default Groups, Roles, and Security Policies section in the Worklist Console Help.
Description of built in groups, roles, and security policies.
Configure the role required to invoke process operations
Process Security Policies section in the Worklist Console Help.
WebLogic Integration Administration Console procedures.
Configure the roles required to subscribe or publish to message broker channels
Setting Channel Security Policies section in the Worklist Console Help.
WebLogic Integration Administration Console procedures.
Configure the roles required to execute application view services or subscribe for events
Managing Application Integration Security section in the Worklist Console Help.
WebLogic Integration Administration Console procedures.
Configure the role authorized to create worklist tasks
Configuring the Worklist Task Creation Role section in the Worklist Console Help.
WebLogic Integration Administration Console procedures.
Manage the password store
The following sub-sections of the System Configuration section in Using the WebLogic Integration Administration Console:
  • Password Aliases and the Password Store
  • Adding Passwords to the Password Store
  • Listing and Locating Password Aliases
  • Changing the Password for a Password Alias
  • Deleting Passwords from the Password Store
WebLogic Integration Administration Console procedures.
Securing resources for trading partner integration
The following sub-sections of Trading Partner Management section in Using the WebLogic Integration Administration Console:
  • Trading Partner Integration Security
  • Example: ebXML Security Configuration
  • Example: RosettaNet Security Configuration
Trading partner security

Managing Process Types

Process types can be monitored from the WebLogic Integration Administration Console. For a description of the Process Configuration module, and step-by-step procedures for the various management tasks, see Process Configuration section in Using the WebLogic Integration Administration Console.

You can also access the graphical view of a process type from other HTTP clients. See Accessing Process Graphs from HTTP Clients.

Monitoring Process Instances

Process instances are monitored from the WebLogic Integration Administration Console. For a description of the Process Instance Monitoring module, and step-by-step procedures for the various monitoring tasks, see Process Instance Monitoring section in Using the WebLogic Integration Administration Console.

You can also access the graphical view of a process instance from other HTTP clients. See Accessing Process Graphs from HTTP Clients.

Monitoring Message Broker Channels

Message broker channels are monitored from the WebLogic Integration Administration Console. For a description of the Message Broker module, and step-by-step procedures for the monitoring tasks, see the Message Broker section at http://download.oracle.com/docs/cd/E13214_01/wli/docs92/adminhelp/msgbroker.html

Creating and Managing Event Generators

WebLogic Integration provides native event generators, including JMS, Email, File, and Timer event generators. These event generators are typically used to start a business process based on events, such as the receipt of email or a new file appearing in a directory. WebLogic Integration also works with Application View event generators, which work with J2EE-CA connectors.

The following table provides a roadmap to the information you need to manage event generators.

Table 1-3 Managing Event Generators
To. . .
Refer to. . .
The reference provides. . .
Learn about the JMS, Email, File, Timer, MQ Series, RDBMS, and HTTP event generators.
The Event Generators section in Using The WebLogic Integration Administration Console
Introduction to the event generators (which publish messages to Message Broker channels in response to system events).
"Message Broker Resources" and "Event Generator Resources" in Introduction in Deploying WebLogic Integration Solutions.
Learn about the application integration event generators
"Events" section of " Application Integration Capabilities and Clients" in Introduction in Deploying WebLogic Integration Solutions.
Information about event processing in application integration.
"Processing Event Notifications at Run-Time" in Understanding Application Integration in Introducing Application Integration
"Events" section of "Load Balancing Application Integration Functions in a Cluster" in Deploying WebLogic Integration Solutions.
Create and deploy a File, Email, JMS, Timer, MQ Series, RDBMS, or HTTP event generator
Creating and Deploying Event Generators section in Using The WebLogic Integration Administration Console
WebLogic Integration Administration Console procedures.
"Deploying Event Generators" in Understanding WebLogic Integration Clusters in Deploying WebLogic Integration Solutions.
Information about event generator targeting and error handling.
Manage the JMS, Email, File, Timer, MQ Series, RDBMS, or HTTP event generators
Event Generators section in Using The WebLogic Integration Administration Console
Procedures for updating channel rules, or deleting suspending, or resuming an event generator.
Configure JMS event generators to consume the first element under the <SOAP:Body> element.
The description of the wli.jmseg.EatSoapActionElement element in wli-config.properties Configuration File in Deploying WebLogic Integration Solutions.
Configuration property description.

Managing WebLogic Integration Tracking and Reporting Data

The following table provides a roadmap to the information you need to manage WebLogic Integration tracking and reporting data.

Table 1-4 Managing Tracking and Reporting Data
To. . .
Refer to. . .
The reference provides. . .
Learn about the tracking data
  • Process Tracking Data
  • Worklist Tracking Data
  • Reporting and Purging Policies for Tracking Data
  • Managing Process Tracking Data sections in Using The WebLogic Integration Administration Console
Descriptions of the tracking data available, the tracking levels that can be set, and the related management tasks, such as configuring a reporting database for offline storage or defining the schedule for purging the data from the runtime database.
Query the reporting data tables
Descriptions of key tables and example queries.
Set the system-level policies for purging tracking data from the runtime database.
WebLogic Integration Administration Console procedures.
Configure the Reporting Data Datastore
Configuring the Reporting Datastore section in Using The WebLogic Integration Administration Console
WebLogic Integration Administration Console procedure.
Configure the tracking level for a process
Viewing and Changing Process Details section in Using The WebLogic Integration Administration Console
WebLogic Integration Administration Console procedure.
Configure the tracking level for business messages
Configuring the Mode and Message Tracking section in Using The WebLogic Integration Administration Console
WebLogic Integration Administration Console procedure.
Set the tracking level for worklist tasks
Configuring the Default Data Policy and Tracking Level for Processes section in Using The WebLogic Integration Administration Console
WebLogic Integration Administration Console procedure.

Creating Business Calendars and Assigning Them to Users or Groups

Most of the management tasks associated with business calendars are completed from the WebLogic Integration Administration Console. For a description of the Business Calendar Configuration module, and step-by-step procedures for the various management tasks, see Business Calendar Configuration section in Using The WebLogic Integration Administration Console

Managing and Monitoring Worklist Task Plan

Most of the management tasks associated with the worklist can be completed from the WebLogic Integration Administration Console. For a description of the Worklist Administration module, and step-by-step procedures for the various management tasks, see Worklist Administration section in Using the Worklist Console.

Custom worklist interfaces can also provide administrative and management functionality. Refer to Worklist User Interface and Enterprise JavaBeans API in Using the Worklist.

Detailed information regarding worklist operations is provided in the following sections of Using the Worklist.

Managing Application Views and Adapters

Most of the application integration management tasks are from the WebLogic Integration Administration Console. For a description of the Application Integration module, and step-by-step procedures for the various management tasks, see Introduction to Application Integration. For background information, refer to the following sections of Introducing Application Integration:

Managing Trading Partner Integration

Most of the trading partner integration management tasks are completed from the WebLogic Integration Administration Console. For a description of the Trading Partner Management module, and step-by-step procedures for the various management tasks, see Trading Partner Management in Using The WebLogic Integration Administration Console.

You can also use the Bulk Loader command line utility to import and export trading partner management data. To learn more, see Using the Trading Partner Bulk Loader..

See Securing WebLogic Integration Resources for additional references on securing trading partner integration applications.

Managing XML Cache Instances

The XML Cache stores XML metadata documents. When you are designing a business process, you use the XML Cache Control to retrieve the XML documents stored in the XML Cache. You use the XML Cache module to create and maintain the XML metadata documents stored in the XML Cache. For a description of the XML Cache module, and step-by-step procedures for the various management tasks, see XML Cache section in Using The WebLogic Integration Administration Console.


  Back to Top       Previous  Next