This chapter includes the following sections:
System administrators use Oracle Enterprise Manager functions for:
Making changes to the Capture system configuration. See Modifying System Configuration Settings.
Monitoring the overall Capture system on the Performance Summary page. See Viewing Performance Metrics.
Starting and stopping the Capture server. See Starting and Stopping Oracle WebCenter Enterprise Capture.
Changing logging levels. See Configuring Settings for Log Files for Capture.
Searching and viewing logs. See Viewing Log Files for Capture.
Receiving and viewing notification of critical issues. See Managing Capture Settings in Enterprise Manager for more information on how to configure an email account to send error messages when an error occurs during batch processing.
Managing client bundles. See Managing Client Bundles.
Managing Capture users and security. See Managing Users and Security.
Browsing Capture MBeans. See Browsing Capture MBeans.
By default, errors, warnings, and major application lifecycle events are logged. You can progressively increase the log level to cause configuration messages, debug messages, and trace messages to be logged. See Configuring and Viewing Capture Log Files for more information on how to configure log files.
The system administrator can make changes to the Capture system configuration from the System Configuration page in Oracle Enterprise Manager Fusion Middleware Control. The system administrator can change the following settings from the System Configuration page:
System Properties
Import Processor Settings
SMTP Settings for E-mail broadcasts
To modify the system configuration:
Table 4-1 System Configuration Parameters
Group | Parameter | Description |
---|---|---|
System Properties |
This group contains configuration settings for batches and client bundles. |
|
Capture System ID |
A value that uniquely identifies the Capture system. Enter a value that uniquely identifies the Capture system on the network. Value: Any string, for example, Capture_01. Default value: Capture_01 |
|
Maximum batches to return per search |
Specify the maximum number of batches to return per search. Value: Any integer, for example, 100. Default value: 100 |
|
Days to maintain cache on client workstations |
Specify the number of days a batch will remain cached on client workstations. If a batch is locked, it will not be deleted from the client workstation's cache. No warning is given when a batch is deleted from the cache. Value: Any integer, for example, 3. Default value: 5 |
|
Frequency to poll for client bundles (seconds) |
Specify the frequency that the Capture server checks its client bundles directory for updates. This is measured in seconds. Default value: 30 |
|
GD Font Path |
For Unix systems, specify the location of the Unix font directory. This path is used by the PDF Image Only document output format driver to render the fonts for PDF documents. Value: A valid directory path, for example, /usr/share/X11/fonts. |
|
Import Processor Settings |
This group contains configuration settings for the Import Processor. |
|
Frequency to check for new or updated jobs (seconds) |
Specify how often an internal timer will fire to check for Import Processor jobs that need to be processed. This is measured in seconds. Value: Any integer, for example, 60. Default value: 60 |
|
Import HA token expiration (minutes) |
Specify the duration for which an Import HA Token is valid. This is measured in minutes. An Import HA Token uniquely identifies and maintains processing state of an object being imported such as an email, file, or list file. Value: Any integer, for example, 60. Default value: 5 |
|
SMTP Settings for E-mail broadcasts |
This group contains settings for configuring an email account to use when sending error messages if an error occurs during batch processing. |
|
SMTP Host |
Specify an SMTP Server Host. Value: Any string, for example, test.example.com. |
|
SMTP Port |
Specify the SMTP Server Port. Value: Any valid port number, for example, 25. |
|
SMTP User ID |
Specify a user ID for the SMTP server. Value: Any string, for example, TEST01. |
|
Change SMTP Password |
Specify a value for the SMTP password. Value: Any string |
|
Confirm SMTP Password |
Re-enter the new SMTP password. Value: Any string |
|
SMTP SSL |
Specify if the SMTP server should use SSL security. |
|
SMTP STARTTLS |
Specify if the SMTP server should use start TLS. |
|
SMTP Message From |
Specify a value for the From field for SMTP messages. Value: Any string |
This section covers the following topics:
Capture includes the following roles:
The system administrator is a super user that has complete control over the Capture system's configuration and administration. This user can give permissions to access the system to others. The system administrator can perform the following tasks:
Access the Enterprise Manager application to configure system parameters, assign roles to Capture users and groups, view performance data, and manage system logs.
Apply system updates.
Grant the workspace manager role to individuals or groups of individual users.
A workspace manager is allowed to create Capture workspaces, and create client profiles and batch processing jobs for processes that act upon batches within the workspace. In addition, the workspace manager also grants other users permission to access the workspace in the workspace manager, workspace viewer, or user roles.
A workspace viewer is granted read-only permission to the workspace for the purpose of reviewing the workspace configuration, which includes client profiles and batch processor job configurations.
You can create Capture users in Oracle WebLogic Server Administration Console, and then assign roles to them in Oracle Enterprise Manager.
To create an Oracle WebCenter Enterprise Capture user:
Log into the WebLogic Server Administration Console using the steps listed in Starting Capture Functions in the WebLogic Server Console.
Navigate to the capture_domain within WebLogic Server, and then click Security Realms.
In the table under the Summary of Security Realms section, click myrealm, the built-in realm that works with the integrated LDAP.
Select the Users and Groups tab and then the Users subtab.
Under the Users section, click New to display the Create a New User section.
In the Name field, specify a name, for example, Workspace Manager
.
In the Password field, specify a password.
In the Confirm Password field, enter the password again, and then click OK.
You can assign LDAP users and groups to Capture roles in Oracle Enterprise Manager.
To assign a Capture role to users and groups:
Authentication is handled by the application server. Capture's user login, access, and authentication are integrated with Oracle WebLogic Server and Oracle Platform Security Services (OPSS). Once authenticated, users' permissions are dictated by application role membership and the workspaces and Capture resources to which they have been granted permission. Within Capture, workspace managers grant access to users or groups. For example, a workspace manager assigns a user group granted the Capture user role to a client profile within the workspace.
Capture supports communication between the client and server using HTTP or HTTPS application protocols. If the Capture client is accessed outside the protection of an organization's firewall, the application server's web container should be configured to require HTTPS connections to ensure that all sensitive information is properly secured. SSL applies to the managed server and encompasses both the client and workspace console. Therefore, configuring the server to use SSL affects both the client and workspace console web applications. See Configuring SSL in Oracle Fusion Middleware in Administering Oracle Fusion Middleware.
Java Management Beans, called MBeans, are part of the greater Java Management eXtensions (JMX) standard which defines ways for administration applications to configure and control Java applications externally. At installation, Capture registers its MBeans with the hosting application server's MBean server. This allows other applications to interact with Capture's configuration data. This includes WebLogic Scripting Tool (WLST) and Oracle Enterprise Manager MBean browser.
If you use Oracle Enterprise Manager to monitor server performance, you may want to also use the Enterprise Manager System MBean Browser to view Oracle WebCenter Enterprise Capture MBean values.
To view Capture MBeans using the System MBean Browser:
The Capture MBeans can be configured from the System Configuration page in Oracle Enterprise Manager. See Managing Capture Settings in Enterprise Manager.
You can also use WLST to view Capture MBeans. See Oracle WebCenter Enterprise Capture Custom WLST Commands in WebCenter WLST Command Reference.