Using the WebLogic Integration Administration Console

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

System Configuration

The System Configuration module allows you to:

Note: You must be logged in as a member of the Administrators or IntegrationAdministrators group to make any changes to the system configuration. For more information, see About WebLogic Integration Users, Groups, Roles, and Security Policies in User Management in the Worklist Console Online Help.
Figure 7-1 System Configuration

System Configuration

The following topics are provided:

About System Administration

The following sections provide background information related to system administration:

Process Tracking Data

Each process instance generates events that contain information about process execution such as information about the node that is executing, timings, and associated data.

The following types of events can be tracked:

Administrators can set the tracking level for processes to optimally tune their system to meet their reporting needs and performances requirements. The tracking levels are:

The system default tracking level is set from the System Configuration module. The tracking level for each process type is set from the Process Configuration module. The administrator has the option of either:

To learn more about:

Reporting and Purging Policies for Tracking Data

Tracking data includes:

In order to optimize performance, the amount of tracking data stored in the runtime database should be kept to a minimum. To help ensure this, the purge process is configured to run at regular intervals set by the administrator.

Note: You cannot disable the purge process.

If the data is required for reporting and analysis, the administrator can enable the transfer of tracking data suitable for reporting to an offline database. If the reporting data stream is enabled, the specified database is populated by a near real-time data stream.

Note: Because the reporting database is populated by a near real-time stream, it is possible to see a snapshot of the data where some process instances contain partial data.

To provide a greater level of control, the administrator also configures the following:

The administrator can reset the purge schedule at any time and run the purge process on demand.

To learn more about:

Password Aliases and the Password Store

The password store provides for the secure storage of the passwords used by controls, event generators, and other Oracle WebLogic Integration components. Each required password is defined in the password store and associated with a password alias. This alias can then be referenced in the annotations of process definitions (*.jpd), control extensions (*.jcx), and event generator configuration files (wliconfig/*EventGen.xml).

For example, when configuring an Email event generator, rather than specifying the password required to access a user’s email account in plain text, the password would be defined and associated with a password alias in the password store. The password alias, rather than the password, can then be referenced in the event generator configuration file.

To learn how to add passwords and aliases, see Adding Passwords to the Password Store.

Overview of the System Configuration Module

The following table lists the pages you can access from the System Configuration module. The tasks and help topics associated with each are provided:

Table 7-1 System Configuration Module 
Page
Associated Tasks
Help Topics
Reporting and Tracking Policies
Current Tracking and Reporting Data Settings
View the system-level settings for the reporting data generation and purge processes. The current status of the reporting data stream (enabled or disabled), purge schedule, purge delay, reporting datastore (if the reporting data stream is enabled), default reporting data policy, and default tracking level are displayed.
Tracking Data Purge and Reporting Data Policy Settings
Enable or disable reporting data generation.
Edit the purge start time and repeat interval.
Edit the purge delay.
Edit Data Store Configuration Settings
Change the JNDI name of the offline reporting database.
Default Tracking Level and Reporting Data Policy for Processes
Change the default tracking level or default reporting data policy for processes.
Purge
Purge Tracking Data
Request an immediate purge cycle.
Interrupt a purge cycle.
View the number of records in the runtime database for completed or terminated process instances.
View the time the last purge cycle completed.
Password Store
View and Edit Password Aliases
View a list of password aliases.
Filter the list by alias name. Use ? to match any single character or * to match zero or more characters.
Delete one or more password aliases.
Add New Password Alias
Add a password by assigning a unique alias and defining the password.
Edit Password Alias
Change the password associated with a password alias.
SFTP
View the SFTP Configuration
View the SFTP configuration. SFTP Client Factory name and if the public keys sent from the server (Server Keys) are to be accepted or not.
Edit SFTP Configuration
Edit the SFTP configuration.

Viewing the Configuration for Tracking, Reporting, and Purging Data

The Current Tracking and Reporting Data Settings page allows you to view the:

  1. From the home page, select the System Configuration module. The Current Tracking and Reporting Data Settings is displayed by default.
Note: You can also click Tracking, Purging, and Reporting Policies on the left menu to access the Current Tracking and Reporting Data Settings page.

Table 8-1 describes the properties displayed on the page:

Table 7-2 Elements of Current Tracking and Reporting Data Settings page 
Property
Description
Reporting Data Datastore
Reporting Data Stream Process Is
Status of reporting data generation (enabled or disabled):

Note: Tracking data includes process instance, task instance, and trading partner message history. To learn more, see Reporting and Purging Policies for Tracking Data.

Reporting Data Datastore JNDI Name
JNDI name of the database to which reporting data is written when the reporting data stream is enabled.
Purge Schedule
Next Purge Start Time
The start date and time for the purge process.
Repeat Every
Intervals from the start time that the purge process runs.
Purge Delay
The amount of time after completion or termination before process instance, task tracking. or message history data is subject to purge.
Default Reporting Data Policy and Tracking Level for Processes
Default Tracking Level
The system default tracking level (full, node, minimum, or none). If the Tracking Level for a process is set to Default, the process inherits this setting. To learn how to set the reporting data policy for a process see Viewing and Changing Process Details
Default Reporting Data Policy
The system default reporting data policy (on or off). If the Reporting Data Policy for a process is set to Default, the process inherits this setting. Instance data for the process is, or is not, transmitted to the reporting database accordingly. To learn how to set the reporting data policy for a process see Viewing and Changing Process Details.
Default Variable Tracking Level
The default variable tracking level setting is Off.
Reliable Tracking
If this property is On, then the process tracking data is written in the same transaction of the process. If a problem is encountered during this operation, then the complete transaction including the process transaction is rolled back.
If this property is Off, then tracking data is written in a different transaction of the process. If a problem is encountered during this operation, then there will be no impact on the process transaction.
Reliable Reporting
If this property is On, then process reporting data is written in the same transaction of the process. If a problem is encountered during this operation, then the complete transaction including the process transaction is rolled back.
If this property is Off, then reporting data is written in a different transaction of the process. If a problem is encountered during this operation, then there will be no impact on the process transaction.

Related Topics

Configuring the Reporting Data and Purge Processes

The Tracking Data Purge and Reporting Data Policy Settings page allows you to enable or disable the reporting data stream and update the purge schedule and purge delay.

Figure 7-3 Tracking Data Purge and Reporting Data Policy Settings

Tracking Data Purge and Reporting Data Policy Settings

  1. From the home page, select the System Configuration module. The Current Tracking and Reporting Data Settings is displayed by default.
Note: You can also click Tracking, Purging, and Reporting Policies on the left menu to access the Current Tracking and Reporting Data Settings page.
  1. In the Purge Schedule section, click the Configure.
  2. Do one or more of the following:
    • To update the Next Purge Start Time, select the hour, minute, month, day, and year from the drop-down lists.
    • To update the repeat interval, enter a new value in the Repeat Every field, then select mins, hours, or days from the drop-down list.
    • To update the purge delay, enter a new value in the Purge Delay field, then select mins, hours, or days from the drop-down list.
  3. Click Submit to save your changes and return to the Current Tracking and Reporting Data Settings page.
Note: When you update the repeat interval without changing the Next Purge Start Time, the new interval will not be effective until after the next scheduled purge. The scheduled start time for the next purge is displayed in the Purge Schedule section of the Current Tracking and Reporting Data Settings page.

Related Topics

Configuring the Reporting Datastore

The Edit Data Store Configuration Settings page allows you to specify the database used to store reporting data.

Figure 7-4 Edit Reporting Data Configuration Settings Page

Edit Reporting Data Configuration Settings Page

  1. From the home page, select the System Configuration module. The Current Tracking and Reporting Data Settings is displayed by default.
Note: You can also click Tracking, Purging, and Reporting Policies on the left menu to access the Current Tracking and Reporting Data Settings page
  1. In the Reporting Data Datastore section, click the Configure link.
  2. To enable or disable the reporting data stream, check or uncheck the Enable Reporting Data Generation check box.
  3. In the Reporting Data Datastore JNDI Name field, enter the JNDI name for the datastore.
  4. Click Submit to save your changes and return to the Current Tracking and Reporting Data Settings page.
Note: When you set or update the Reporting Data Datastore JNDI Name, the change will not take effect until you restart the server.

Related Topics

Configuring the Default Data Policy and Tracking Level for Processes

In addition to allowing you to configure the reporting data stream and purge processes, the Current Tracking and Reporting Data Settings page allows you to configure the default tracking level and reporting data policies for processes. See Viewing the Configuration for Tracking, Reporting, and Purging Data for a description of all the properties displayed on the Current Tracking and Reporting Data Settings page.

  1. From the home page, select the System Configuration module. The Current Tracking and Reporting Data Settings is displayed by default.
Note: You can also click Tracking, Purging, and Reporting Policies on the left menu to access the Current Tracking and Reporting Data Settings page.
  1. In the Default Reporting Data Policy and Tracking Level for Processes section, click the Configure link.
  2. The Default Tracking Level and Reporting Data Policy for Processes page is displayed.

    Figure 7-5 Default Tracking Level and Reporting Data Policy for Processes

  3. Default Tracking Level and Reporting Data Policy for Processes
    Do one or both of the following:
    • From the Default Tracking Level drop-down list, select Full, Node, Minimum, or None.
    • From the Default Reporting Data Policy drop-down list, select On or Off.
    • From the Default Variable Tracking Level drop-down list, select On or Off.
    • From the Reliable Tracking drop-down list, select On or Off.
    • From the Reliable Reporting drop-down list, select On or Off.
  4. Click Submit to save your changes and return to the Current Tracking and Reporting Data Settings page.

Related Topics

Manually Starting and Stopping the Purge Process

The Purge Tracking Data page displays the:

Purge Tracking Data

If the purge process is scheduled to run regularly, tracking data, which includes process history, task history, and trading partner integration message history, is purged from the runtime datastore according to the schedule currently set. If required, you can request that the purge process run immediately, or if a purge operation is underway, you can manually stop the process, as described in the following procedure.

  1. From the home page, select the System Configuration module.
  2. From the left menu, select Purge to display the Purge Tracking Data page.
  3. Do one of the following:
    • To start a purge of the tracking data, click the Purge Tracking Data button.
    • To stop a purge operation that is currently underway, click the Stop Current Purge Operation button.
    • A confirmation dialog box is displayed.

  4. Click OK to confirm, or Cancel to dismiss the dialog and cancel the action.

Related Topics

Adding Passwords to the Password Store

The Add a New Password Alias page allows you to create a password and associate it with a password alias.

Figure 7-7 Add New Password Alias

Add New Password Alias

  1. From the home page, select the System Configuration module.
  2. From the left menu, select Password Store.
  3. From the left menu, select Create New to display the Add New Password Alias page.
  4. In the Password Alias Name field, enter a unique name.
  5. In the Password field, enter the password.
  6. In the Confirm Password field, enter the password again.
  7. Do one of the following:
    • To create the password alias, click Submit.
    • The View and Edit Password Aliases page is displayed. The new alias is included in the list. (You may need to page forward to see the new alias.)

      Note: If there is an error, the Add New Password Alias page is displayed again. A message indicating the problem is displayed above the input requiring correction.
    • To disregard the changes and return to the View and Edit Password Aliases page, click Cancel.

Related Topics

Listing and Locating Password Aliases

The View and Edit Password Aliases page lists the password aliases defined in the password store.

Figure 7-8 View and Edit Password Aliases

View and Edit Password Aliases

  1. From the home page, select the System Configuration module.
  2. In the left panel, click Password Store to display the View and Edit Password Aliases page.
  3. To locate a specific password alias, do one of the following:
    • Filter by alias name. Enter the search target, then click Search. The password aliases matching the search criteria are displayed.
    • Sort the list again. Ascending View and Edit Password Aliases and descending View and Edit Password Aliases arrow buttons indicate sortable columns. Click the button to change the sort order.
    • Scroll through the pages. Use the controls in the lower left corner. Go to a page by selecting the page number or by using the arrow buttons to go to the next View and Edit Password Aliases, previous View and Edit Password Aliases, first View and Edit Password Aliases, or last View and Edit Password Aliases page.

Related Topics

Changing the Password for a Password Alias

The Edit Password Alias page allows you to change the password associated with the password alias.

Figure 7-9 Edit Password

Edit Password

  1. Locate the password alias. See Listing and Locating Password Aliases.
  2. Click the alias name to display the Edit Password Alias page.
  3. In the Current Password field, enter the current password.
  4. In the New Password field, enter the new password.
  5. In the Confirm Password field, enter the new password again.
  6. Do one of the following:
    • To update the password, click Submit.
    • The View and Edit Password Aliases page is displayed.

      Note: If there is an error, the Edit Password Alias page is redisplayed. A message indicating the problem is displayed above the input requiring correction.
    • To reset to the last saved values, click Reset.
    • To disregard the changes and return to the View and Edit Password Aliases page, click Cancel.

Deleting Passwords from the Password Store

The View and Edit Password Aliases page allows you to locate and delete selected password aliases.

  1. Locate the password alias or aliases to be deleted. See Listing and Locating Password Aliases.
  2. Click the check box to the left of the password aliases to be deleted to select them.
  3. Click Delete Selected Aliases.

Configuring SFTP

The Current SFTP Settings page shows you the existing SFTP configuration.

Figure 7-10 Current SFTP Settings

Current SFTP Settings

  1. From the home page, select the System Configuration module.
  2. From the left panel, select Configure.
  3. Click on the Configure link to edit the current settings. You can now edit the settings on the Current SFTP Settings page.

  4. Current SFTP Settings

  5. Enter the class name of the SFTP Client factory.
  6. Specify whether the public key from the SFTP server must be accepted by default or not. The default setting is Yes. Click Submit to save changes, Reset to restore the original settings, and Cancel to return to the View mode of the Current SFTP Settings page.

  Back to Top       Previous  Next