Most AXF configuration is completed as part of Oracle WebCenter Content installation. This chapter describes how to configure additional AXF settings. It covers the following topics:
This section covers the following topics:
You can configure logging using either of these methods:
To use the web interface to set up loggers, navigate to the Log Configuration page in Enterprise Manager. For example, select the server in the side pane, right-click, and choose Logging, then Configure Logging. For more information, see the Oracle Enterprise Manager documentation.
Use the AXF logs to isolate issues in solution configuration. By default, some AXF logging automatically occurs as part of Application Server logging. Follow these steps to configure more detailed and separate AXF logging.
Add a log handler to the Application Server configuration. Add the handler inside the <log_handlers> tag in the logging.xml file, at the following location:
DOMAIN
/config/fmwconfig/servers/
SERVER
/logging.xml
An example location follows:
base_domain/config/fmwconfig/servers/IPM_Server1/logging.xml
<log_handler name='axf-handler' level='ALL' class='oracle.core.ojdl.logging.ODLHandlerFactory'> <property name='path' value='${domain.home}/servers/${weblogic.Name}/logs/axf.log'/> <property name='maxFileSize' value='5485760'/> <property name='maxLogSize' value='54857600'/> <property name='encoding' value='UTF-8'/> </log_handler>
Add a logger to the logging.xml file and set the level from the Log Levels (ODL Message Types) listed in Table 4-1. You can set the logging level in the XML file or using Enterprise Manager.
<logger name='oracle.imaging.axf' level='TRACE:32' useParentHandlers='false'> <handler name='axf-handler'/> <handler name='console-handler'/> </logger>
Note:
Remove the console-handler tag to omit logging on the terminal.Table 4-1 Available Logging Levels
Log Type | Description | Log Level (ODL Message Type) |
---|---|---|
NULL |
The logger inherits the log level set for its parent. |
n/a |
SEVERE |
Log system errors requiring attention from the system administrator. |
ERROR:1 |
WARNING |
Log actions or conditions discovered that should be reviewed and may require action before an error occurs. |
WARNING:1 |
INFO |
Log normal actions or events. This could be a user operation, such as login completed, or an automatic operation, such as a log file rotation. |
NOTIFICATION:1 |
CONFIG |
Log configuration-related messages or problems. |
NOTIFICATION:16 |
FINE |
Log trace or debug messages used for debugging or performance monitoring. Typically contains detailed event data. |
TRACE:1 |
FINER |
Log fairly detailed trace or debug messages. |
TRACE:16 |
FINEST |
Log highly detailed trace or debug messages. |
TRACE:32 |
If using Windows, restart Administration Server if it is running. The logger displays in Enterprise Manager. You can change the logging level at run time.
If your installation uses Coherence for caching (a requirement for high-availability environments), four separate caches are set up: one each for Namespaces, Property Definitions, Property Set Definitions, and Property Sets. This default caching configuration works out of the box with Coherence defaults.
To configure an optional Coherence configuration that is optimized for AXF, refer to the sample axf-cache-config.xml configuration file below, which shows how to configure simple Coherence caches. For more advanced cache types, refer to the Coherence documentation. Note that configuring Coherence as described below is recommended, but not required.
<?xml version="1.0"?> <!-- File: coherence-cache-config.xml --> <cache-config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://xmlns.oracle.com/coherence/coherence-cache-config" xsi:schemaLocation="http://xmlns.oracle.com/coherence/coherence-cache-config http://xmlns.oracle.com/coherence/coherence-cache-config/1.0/coherence-cache-config.xsd"> <!-- Prefix all service names to ensure no unintended clustering with other cache servers --> <scope-name>com.oracle.ecm.axf</scope-name> <defaults> <serializer>pof</serializer> </defaults> <caching-scheme-mapping> <!-- Specific cache mappings to avoid configuration errors --> <!-- Cache limits are set per cache per node, so the total limit is the sum of all the cache limits on this node. As there are 3 caches the storage will be a maximum of 3 x 100MB = 300MB, in addition to 3 x 5MB = 15MB of near cache for clients. --> <cache-mapping> <cache-name>AXF</cache-name> <scheme-name>CustomNearCacheScheme</scheme-name> </cache-mapping> <cache-mapping> <cache-name>AXF_CONVERSATION</cache-name> <scheme-name>CustomNearCacheScheme</scheme-name> </cache-mapping> <cache-mapping> <cache-name>AXF_EVENT</cache-name> <scheme-name>CustomNearCacheScheme</scheme-name> </cache-mapping> </caching-scheme-mapping> <caching-schemes> <near-scheme> <scheme-name>CustomNearCacheScheme</scheme-name> <front-scheme> <local-scheme> <scheme-ref>SizeLimitedLocalScheme</scheme-ref> </local-scheme> </front-scheme> <back-scheme> <distributed-scheme> <scheme-name>CustomDistributedCacheScheme</scheme-name> <backing-map-scheme> <local-scheme> <scheme-name>SizeLimitedLocalScheme</scheme-name> <eviction-policy>HYBRID</eviction-policy> <!-- 100M --> <high-units>100</high-units> <unit-calculator>BINARY</unit-calculator> <unit-factor>1048576</unit-factor> <expiry-delay>4h</expiry-delay> </local-scheme> </backing-map-scheme> <autostart>true</autostart> </distributed-scheme> </back-scheme> <invalidation-strategy>present</invalidation-strategy> </near-scheme> <local-scheme> <scheme-name>SizeLimitedLocalScheme</scheme-name> <eviction-policy>HYBRID</eviction-policy> <!-- 5M --> <high-units>5</high-units> <unit-calculator>BINARY</unit-calculator> <unit-factor>1048576</unit-factor> <expiry-delay>4h</expiry-delay> <cachestore-scheme></cachestore-scheme> </local-scheme> </caching-schemes> </cache-config>