4 Configuring AXF Settings

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:

• Configuring Logging

• Configuring Coherence

4.1 Configuring Logging

This section covers the following topics:

• Section 4.1.1, "Configuring Logging for AXF for BPEL"

4.1.1 Configuring Logging for AXF for BPEL

You can configure logging using either of these methods:

• Section 4.1.1.1, "Using Enterprise Manager"

• Section 4.1.1.2, "Using Application Server"

4.1.1.1 Using Enterprise Manager

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.

Description of the illustration ''logging_em.gif''

4.1.1.2 Using Application Server

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.

1. 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>
   

2. 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

   
   

3. 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.

4.2 Configuring Coherence

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>