Skip Headers
Oracle® Fusion Middleware Managing Oracle WebCenter Content
11g Release 1 (11.1.1)

Part Number E26693-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

24 Managing Inbound Refinery

This chapter discusses the administrative tasks needed to manage Inbound Refinery, such as managing agents and providers, configuring web server filters, and publishing dynamic and static layout files.

This chapter discusses the following topics:

24.1 Managing Refinery Authentication and Users

As a managed server running within an Oracle WebLogic Server domain, user and group access to Inbound Refinery is controlled by Oracle WebLogic Server and system security configuration is handled through the WebLogic Server console.

If additional services are required, such as Oracle Internet Directory or single sign on using Oracle Access Manager, these can be linked to the Oracle WebLogic Server domain managing Inbound Refinery using WebLogic Server controls.

When deployed, the refineryadmin Inbound Refinery role has permissions to administer Oracle Inbound Refinery. Any user needing administration rights to Inbound Refinery must be part of the corresponding refineryadmin group in Oracle WebLogic Server.

For additional information, see the following documentation.

Table 24-1 Additional System Security Documentation

Task Where to Go For More Information

Administering Oracle WebLogic Server

Oracle Fusion Middleware Administrator's Guide

Administering Oracle WebCenter Content

Administering Oracle WebCenter Content


24.1.1 Integration with Single Sign-On

Oracle Access Manager (OAM), part of Oracle's enterprise class suite of products for identity management and security, provides a wide range of identity administration and security functions, including several single sign-on options for Fusion Middleware and custom Fusion Middleware applications. OAM is the recommended single sign-on solution for Oracle Fusion Middleware 11g installations.

For smaller scale Oracle Fusion Middleware 11g installations, where you do not have an enterprise-class single sign-on infrastructure like Oracle Access Manager, you only need to provide a single sign-on capability within your specific Fusion Middleware application, you can configure a SAML-based SSO solution. If you need to provide single sign-on with other enterprise applications, this solution is not recommended.

If your enterprise uses Microsoft desktop logins that authenticate with a Microsoft domain controller with user accounts in Active Directory, then configuring SSO with Microsoft Clients may also be an option to consider.

The setup required for each of these SSO solutions is described in the following document sections.

Table 24-2 Single Sign-On Documentation

For Information On... See The Following Guide...

Configuring OAM and OSSO

Oracle Fusion Middleware Security Guide

Using Windows Native Authentication for Single Sign-on

Oracle WebLogic Server Admin Console Help: Configure Authentication and Identify Assertion Providers

Using WebLogic SAML for Single Sign-on

Oracle Fusion Middleware Securing Oracle WebLogic Server: Configuring the SAML Authentication Provider


24.2 Managing Refinery Conversion Queues

A refinery is set up as a provider to a Content Server. When a file is checked into the Content Server, a copy of the native file is stored in the /vault directory (the native file repository). The native file is the format in which the file was originally created (for example, Microsoft Word).

If the file format is set up to be converted, the Content Server creates a conversion job in its pre-converted queue. The Content Server then attempts to deliver the conversion job to one of its active refinery providers (a refinery that is configured to accept the conversion and is not busy). The Content Server sends the conversion parameters to an active refinery.

When the refinery receives conversion parameters, it returns the following data to the Content Server:

If the refinery does not accept the job, the Content Server tries the next available refinery. The Content Server keeps attempting to transfer the job until a refinery accepts the job or the maximum transfer time is reached. If the maximum transfer time is reached, the job is removed from the Content Server's pre-converted queue and the content item remains in GenWWW status.

When a refinery accepts the job, the Content Server then uploads a ZIP file, containing the conversion data and the file to be converted, to the refinery. The Content Server also places an entry in its RefineryJobs table, which it uses to track the conversion job. The refinery places the conversion job in its pre-converted queue.

The refinery then attempts to perform the specified conversion, calling the appropriate conversion options as necessary. When the refinery finishes processing the conversion job, it places it in its post-converted queue. The Content Server polls the refinery periodically to see if conversion jobs in its RefineryJobs table have been completed. When the refinery reports that it has finished processing a conversion job, the Content Server downloads any converted files (for example, a web-viewable thumbnail file and a PDF file) from the refinery, places the conversion job in its post-converted queue, and kicks off any post-conversion functionality as needed.

Refinery queue management settings can be configured both on the Content Server and on the refinery. The following pages arre used to manage refinery queues:

The following refinery pages contain information and settings used to manage refinery queues:

24.3 Managing Agents and Providers

This section discusses the following topics:

24.3.1 Agent Management

The following tasks are performed when managing agents:

24.3.1.1 Verbose Logging

You can enable verbose logging for each refinery agent. When verbose logging is on, general agent status information, a detailed description of each conversion engine action (for example, when the conversion was started and file details, conversion step details, and conversion results), and errors are recorded in the refinery agent log. When verbose logging is off, only general agent status information and errors are recorded in the refinery agent log.

To enable verbose logging for a refinery agent:

  1. Log into the refinery.

  2. Select Refinery Administration then Agent Management.

  3. On the Agent Management page, select the Enable Verbose Logging check box for the refinery agent.

  4. To revert to the last saved settings, click Reset.

  5. Click Update to save your changes.

24.3.1.2 Deleting Agents

A refinery agent can be deleted only when there are no conversion jobs in the refinery agent's pre or post-converted queues. To delete a refinery agent:

  1. Log into the refinery.

  2. Select Refinery Administration then Agent Management.

  3. On the Agent Management page, select Delete Agent from the Actions menu for the refinery agent.

  4. On the Delete Agent page, select the Confirm deletion of agent agent_name check box to confirm that you want the agent deleted. History, logs, and any jobs in the agent queue are also deleted.

  5. Click Delete Agent.

24.3.2 Managing Refinery Providers

You should not need to configure any refinery providers. To view refinery provider information using the web-based Inbound Refinery interface:

  1. Log into the refinery.

  2. Select Refinery Administration then Providers from the navigation menu.

24.4 Viewing Refinery Information

This section discusses methods to view refinery information:

24.4.1 Refinery Configuration Information

To view the configuration information for the refinery using the web-based Inbound Refinery interface:

  1. Log into the refinery.

  2. Select Refinery Administration, Configuration Information from the navigation menu. The Configuration Information page is displayed, showing an overview of the main system settings. In addition, it lists all installed server components or custom components that are currently enabled and disabled.

The Configuration Information page is for information purposes only and cannot be edited.

24.4.2 Refinery System Audit Information

To view the system audit information for the refinery using the web-based Inbound Refinery interface:

  1. Log into the refinery.

  2. Select Refinery Administration, System Audit Information from the navigation menu. The System Audit Information page is displayed, showing information which may be useful while troubleshooting a problem or tweaking a server's performance.

    The General Information section of this page provides the following information:

    • Information regarding whether the system is receiving too many requests.

    • Information about the memory cache for the system, which is useful in troubleshooting any "out of memory" errors you may receive. This is important when running the refinery server with many users and a large quantity of data.

    • Information about which Java threads are currently running. This is useful in determining the cause of an error.

    • Listing of any audit messages.

    Tracing in a refinery can be activated on a section-by-section basis. Tracing for active sections is displayed on the Console Output page. Section tracing is useful for determining which section of the server is causing trouble, or when you want to view the details of specific sections. Sections can be added by appending extra sections to create a comma separated list.

    A listing of the sections available for tracing, with brief descriptions, is available by clicking the information icon next to the Tracing Sections Information heading. For example, activating refinery displays extended information about conversion status, activating ref-config traces changes to the current running environment, and activating refsteplogic traces the logic that determines what conversion steps are used. The wildcard character * is supported so that ref* will trace all sections that begin with the prefix ref, including refinery, ref-config, and refsteplogic.

    Some tracing sections also support verbose output. Enable Full Verbose Tracing if you wish to see in-depth tracing for any active section that supports it.

    Important:

    Any options set on this page is lost when the refinery is restarted unless you enable Save and click Update.

24.5 Configuring the Web Server Filter

To configure the web server filter for a refinery using the web-based Inbound Refinery interface:

  1. Log into the refinery.

  2. Select Refinery Administration, Filter Administration from the navigation menu. The Configure Web Server Filter page is displayed, which is used to configure and troubleshoot the web server filter communication with the refinery.

24.6 Publishing Dynamic and Static Layout Files

To publish dynamic and static layout files:

  1. Log into the refinery.

  2. To publish your dynamic layout files, choose Administration then Admin Actions and select publish dynamic layout files under the Weblayout Publishing section. The PUBLISH_WEBLAYOUT_FILES service is executed.

    All dynamic refinery layout files (.css files and .js files) are published from the refinery IntradocDir/shared/config/templates directory to the weblayout directory. This service is used when customizing the refinery. The PUBLISH_WEBLAYOUT_FILES service is also executed each time the refinery is restarted.

  3. To publish static layout files, choose Administration then Admin Actions and select publish static layout files under the Weblayout Publishing section. The PUBLISH_STATIC_FILES service is executed.

    All static layout files (graphic files) are published from the refinery IntradocDir/shared/publish directory to the weblayout directory. This service is used when customizing your refinery. The PUBLISH_STATIC_FILES service is not executed each time your refinery is restarted, as it can be very time-consuming to execute. This service must be executed manually when customizing the refinery.

For more information about other publishing options available and for customizing the content and refinery servers, see the documentation provided with Content Server.

24.7 Active Virus Scanning on Windows

When running Inbound Refinery on Windows, active virus scanning of some Inbound Refinery and Content Server directories can cause conversions to fail.

Exclude the following Content Server directories from active virus scanning:

Exclude the following Inbound Refinery directories from active virus scanning:

24.8 Changing the Date Format and Time Zones

This section discusses changing the deafult date format and the default time zone setting:

24.8.1 Changing the Date Format

The default English-US locale uses two digits to represent the year ('yy'), where the year is interpreted to be between 1969 and 2068. In other words, 65 is considered to be 2065, not 1965. If you want years prior to 1969 to be interpreted correctly in the English-US locale, you need to change the default date format for that locale to use four digits to represent years ('yyyy').

This issue does not apply to the English-UK locale, which already uses four digits for the year.

To modify the default English-US date format:

  1. Start the System Properties utility:

    • Microsoft Windows: Select Start then Programs then Oracle Content Server. Choose refinery_instance then Utilities then System Properties.

    • UNIX: Start the SystemProperties script, which is located in the /bin subdirectory of the refinery's installation directory.

  2. Open the Localization tab.

  3. Select the English-US entry in the list of locales, and click Edit.

  4. On the Configure Locale dialog, modify the date format to use four digits for the year ('yyyy') rather than two ('yy').

  5. After you are done editing, click OK to close the Configure Locale dialog.

  6. Click OK to apply the change and exit System Properties.

  7. Stop and restart the refinery.

24.8.2 Setting the Time Zone

During the installation of Inbound Refinery, you might have indicated that you wanted to use the default time zone for the selected system locale. If that is the case, the installer attempted to automatically detect the time zone of the operating system and set the refinery time zone accordingly. In certain scenarios, the time zone of the operating system might not be recognized. The time zone will then be set to the UTC time zone (Universal Time Coordinated), which is the same as Greenwich Mean Time (GMT).

You then need to set the time zone manually:

  1. Start the System Properties utility:

    • Microsoft Windows: Select Start then Programs then Oracle Content Server. Choose refinery_instance then Utilities then System Properties.

    • UNIX: Start the SystemProperties script, which is located in the /bin subdirectory of the refinery's installation directory.

  2. Open the Server tab.

  3. From the System Timezone drop-down list, choose the time zone you want to use for the refinery.

  4. Click OK to apply the change and exit System Properties.

  5. Stop and restart the refinery.

24.9 Monitoring Refinery Status

Log files are created to help monitor the refinery status. Agent are entities, such as a Content Server, that sends a job to the refinery. Conversion status information is separated and logged by agent to make it easier to view the information and find details.

Two types of log files are created for the refinery:

24.9.1 Viewing Refinery Status

Entries are added to the appropriate log file throughout the day as events occur and are listed by date and time. The time stamp placed on a refinery log entry designates when the log entry was created, not necessarily when the action took place.

Refinery agent log entries list the conversion number at the beginning of each entry because each agent can have multiple concurrent conversions running at a given time. For example: Log entry for conversion job '3513'. The following types of log entries are generated:

Log Entry Description

Info

Displays status information. For example, startup information or a description of a conversion engine action.

Error

Displays errors that occur.


Verbose logging can be enabled. When on, it records general agent status information, a detailed description of each conversion engine action (for example, when the conversion was started and file details, conversion step details, and conversion results), and errors. When verbose logging is off, only general agent status information and errors are recorded in the refinery agent log.

A log file might include Details links. Clicking the Details links expands and collapses log details. Typically, the log details are either a stack dump or a trace back to the code that generated the error.

24.9.1.1 Viewing Conversion Statuses

The refinery creates each agent when it sends its first conversion job to the refinery. Until then, information for the agent is not available in the refinery.

To view the current status of conversions for all refinery agents:

  1. Log into the refinery.

  2. Choose Home from the main menu, or choose Status then Refinery Status from the Main menu.

24.9.1.2 Viewing Refinery Logs

To view the refinery log files:

  1. Log into the refinery.

  2. Choose Home in the main menu and select the Refinery Logs tab, or choose Status then Refinery Status from the Main menu and select the Refinery Logs tab.

  3. On the Refingery Logs page, click a log link to display the refinery log.

24.9.1.3 Viewing Console Output

To view the refinery console output:

  1. Log into the refinery.

  2. Choose Home from the Main menu and select the Console Output tab, or choose Status then Refinery Status from the Main menu and select the Console Output tab.

    • Click Update to refresh the console output.

    • Click Clear to clear the console output.

24.9.1.4 Viewing Conversion History

To view the last fifty conversions in the conversion history for a specific refinery agent:

  1. Log into the refinery.

  2. Choose Status then agent_name from the menu and select the Conversion History tab, or choose View Conversion History from the Actions menu for the agent on the Refinery Status page.

  3. On the Conversion History page, click a Content ID link to display the Conversion Detail page.

24.9.2 Viewing Agent Statuses

The status of a specific agent can be viewed as well as the queues for all agents.

24.9.2.1 Viewing Specific Status

To view the current status of conversions for a specific refinery agent:

  1. Log into the refinery.

  2. Navigate to the Agent Status page in one of the following ways:

    • Click the agent name.

    • Select Status then agent_name from the navigation menu.

    • Select View Detailed Status from the Actions menu for the agent on the Refinery Status page.

24.9.2.2 Viewing Agent Queues

To view the items that are in the pre and post-converted queues for a specific refinery agent:

  1. Log into the refinery.

  2. Choose Status then agent_name from the navigation menu and select the Items in Queue tab, or choose View Items In Queue from the Actions menu for the agent on the Refinery Status page.

  3. On the Items in Queue page, click Refresh to update the information on the page.

24.9.2.3 Viewing Agent Logs

To view the log files for a specific refinery agent:

  1. Log into the refinery.

  2. Choose Status then agent_name from the navigation menu and choose the Agent Logs tab, or choose View Agent Logs from the Actions menu for the agent on the Refinery Status page.

  3. On the Agent Logs page, click a log link to display the refinery agent log.