Middleware
Real-Time Decisions
RTD Platform 3.0.0.1.12 PSU (Patch set update) is a 3.0.0.1 update with full set of install files and replaces 3.0.0.1 as well as 3.0.0.1.11 PSU. The installation files are available through support.oracle.com:
Download file from https://support.oracle.com
Navigate to the “ Patches & Updates” tab enter in bug number 16418530 and hit search.
Readme: https://updates.oracle.com/Orion/Services/download?type=readme&aru=16040813
Below is a list of defects addressed by this patch, for installation information and additional information, consult the readme file provided above and bundled with the patch file
New fixes in 3.0.0.1.12:
1. 16046477 – New Inline Service CrossSellR, sample integration with ORE
2. 14694502 – Performance improvements in the scoring code for date attributes
3. 14461859 – XML Response from advisor invalid with special characters
4. 14059181 – Decision Center internal server error seen for application > Definition > Overview report
5. 14300740 – New API to remove external rules from the server cache
6. 14283538 – Performance improvements in the external rules evaluation code
7. 14169133 - Performance improvements in the external rules compilation code with the addition of a new batch compilation API
8. 14020465 - Update weblogic-application.xml for commons logging issue
9. 13709480 - Learning Service – performance degradation may occur as result of automatic database server tuning processes
Previously fixed in 3.0.0.1.11:
1. Learning Server performance improvements – see section “Learning Server Architectural Changes Introduced in This Patch” below.
2. 13610972 - Data Source not found error in certain race conditions
3. 13080205 - Inline Service Application parameters not visible in Decision Center
4. 12985556 - RTD need to recover gracefully from data source interruption
5. 12962684 - Batch jobs should be forwarded to least-loaded batch agent in cluster
6. 12831443 - Unable to load model due to counter reaching int limit (2^31)
7. 12798391 - Unable to deploy Inline Service using command line deploy too if inline service uses "Days Since Last Event" function
Previously fixed in 3.0.0.1.10:
1. 12353084 Model snapshot data (correlation, predictiveness) for completed time windows is offset by one period.
2. 11837000 <session-timeout> parameter removed from UI.war’s web.xml. [For Decision Manager].
3. 11832629 Batchagent fails to register with batchmanager in cluster due to race condition. Retry (3 attempts) code implemented.
4. 11804529 External rule editor - double quotes (") entered for the parameter TitleMessage leads rendering error.
5. 11742973 Decision center – “Internal server error” seen for choicegroup-level Analysis > Trends reports where children choices are a mix of static and dynamic choices.
6. 11739285 Decision center – “Internal server error” seen for choicegroup-level Analysis > Drivers report due to jsp page exceeding size limitation.
7. 11668572 JBoss – Request forwarding channel reset error fix using Jgroups 2.8.
8. 10411524 RTD decision service java client to support JUL logging, automatically generate session key in header, support user-defined header.
9. 10390665 Add system property to bypass ILS test loading during ILS deployment
10. 10387803 Decision Service performance log (ds_perf.csv) - additional request forwarding metrics
11. 10383794 Decision Center - increased precision shown in report data.
12. 10323594 Temporary data storage (TDS) – Add session key name to TDS key value.
13. 10279493 Upgrade RTD-bundled Oracle JDBC driver to 10.2.0.5.
14. 10259859 Model runtime apis return parent choicegroup data instead of choice data if choice event model defined with only one positive event.
15. 10254585 Add javadocs for getchoiceeventlikelihoodswhy() method
16. 10211905 Decision Center – when in https, need to suppress popup warning “This page contains both secure and nonsecure items”. [For Decision Manager].
17. 10178734 External Rule Editor - add option to hide inherited rules. [For Decision Manager].
18. 10170068 Decision Center – IE 8 support needed.
19. 10122030 Decision Service - allow negative choice score values.
20. 10035297 Sticky control group assignment when there are multiple session keys.
21. 10035277 Sequential selection values result in sequential control group assignment.
22. 10034931 Entity cache code generation improvement to reduce SQL queries.
23. 10031983 Weblogic/Websphere - Request forwarding channel reset error fix using Jgroups 2.8.
24. 10013868 Java smart client retains open file handles on sdclient.properties.
25. 9959417 External Rule Editor - add option to override default title value. [For Decision Manager].
26. 9927978 Java smart client forgets cookies when used asynchronously.
27. 9924191 DC_Demo sample ILS - external rules deployment helper. Update to allow editing/saving of long external rule xml strings.
28. 9893907 Prevent rare infinite loop symptom when a model's "Randomize Likelihood" option is selected.
29. 9866824 Decision Service WS response may include duplicate copies of attributes which had values set in several parent choicegroup levels
30. 9726419 External Rule Editor - add option to display rule editor in read-only mode. [For Decision Manager].
31. 9553431 Rule editor - javascript error disables save feature.
32. 9340440 Decision Center - incorrect reports when "Value Domain" of partitioning attributes of a model definition is non-empty.
33. 9310288 Studio - remove temporary data storage option for generic models.
34. 9306670 Decision Center - when positive counts exceed total counts, show model quality as 0 and hide cumulative gains graph.
35. 9302009 Studio - remove temporary data storage option for choice models.
36. 9286155 Model quality - integer overflow causes model quality to appear as 0.
37. 9267227 Model quality - internal data check (ismonotonicallyincreasing) at times incorrectly shows model quality as 0.
38. 9096379 Decision Service performance counters - add request forwarding metrics.
39. 8977280 Temporary data storage (TDS) – fix feature.
This section lists additional information for select defects.
16046477 – New Inline Service CrossSellR, sample integration with ORE
A new sample inline service is included in 3.0.0.1.12 PSU to demonstrate using external R models in Oracle RTD. You will find the inline service in OracleBI\RTD\examples\CrossSellR and documentation for it in OracleBI\RTD\docs\ORE Integration.pdf.
14461859 – XML Response from advisor invalid with special characters
Special chars (like & or <) are not properly escaped in the response from an advisor (for example "&" is not transformed to "&"). This regression was first introduced in 3.0.0.1.10 PSU and is fixed in 3.0.0.1.12 PSU. If you implemented a workaround of escaping the response in the inline service, you should remove this workaround as part of your 3.0.0.1.12 PSU.
14300740 – New API to remove external rules from the server cache
External rules are cached in the server. The cache is cleared if the inline service is undeployed. If you want to remove a specific rule from the server cache without undeploying the whole inline service you can use the new ‘remove(RuleDefinition def)’ method in theRuleCache interface. This method is used in the Base Marketing RTD Application Inline Service, refer to this for an example on how to use this new method.
14169133 - Performance improvements in the external rules compilation code with the addition of a new batch compilation API
If your Inline Service(s) has a lot of external rules, you can use new APIs to compile rules in batch in order to improve the initial load time of these external rules by using the new ‘validateAndCache(@NonNull List<RuleDefinitionContextPair> ruleDefContextList,RuleCache cache)’ method in the RuleEvaluator interface. This method is used in the Base Marketing RTD Application Inline Service,refer to this for an example on how to use this new method.
11668572 JBoss – Request forwarding channel reset error fix using Jgroups 2.8.
10031983 Weblogic/Websphere - Request forwarding channel reset error fix using Jgroups 2.8.
The resolution of these two defects affects the RTD installation process, especially for cluster setups. See the Applying This Patch in this document for details.
10411524 RTD decision service java client to support JUL logging, automatically generate session key in header, support user-defined header.
The 3.0.0.1.10 PSU and later RTD decision service client (rtd-ds-client.jar) supports the following:
1. A new RTDSESSIONKEY http header is automatically generated for IP requests which include session key/keys. The value is hex(hash(first session key)), which follows RegEx pattern [0-9, a-f]{8}.
2. A new method void setHttpHeader(String name, String value); has been added to IntegrationPointRequestInterface for users to set arbitrary http headers.
3. Logging has been changed to Java Utility Logging (JUL). Log4j is not used or required. Configuration can be done in java source code as follows:
java.util.logging.Logger rtdLogger = java.util.logging.Logger.getLogger("oracle.rtd.logger");
rtdLogger.setLevel(java.util.logging.Level.WARNING);
rtdLogger.addHandler(new java.util.logging.FileHandler("rtd.log"));
10390665 Add system property to bypass ILS test loading during ILS deployment
A new system property, rtd.skipIlsTestLoad, has been added to bypass test loading of an Inline Service during ILS deployment. If unspecified in the JVM start parameters, the property has a default value of false, which means ILS test loading will be performed during ILS deployment. If the logging level is set to DEBUG, the following message can be seen in the server.log:
2011-04-10 11:04:10,142 DEBUG [DeployAppCommand] Performing test load on CrossSell with deployment state 5.
Set the property to true, e.g. -Drtd.skipIlsTestLoad=true to bypass ILS test loading. This may be helpful in ILS redeployments from Decision Center in a clustered environment.
10387803 Decision Service performance log (ds_perf.csv) - additional request forwarding metrics
9096379 Decision Service performance counters - add request forwarding metrics.
The following metrics have been added to the Decision Service mbeans (OracleRTD > Server > DecisionService) and Decision Service performance log:
1. Requests Forwarded, Peak
2. Requests Forwarded, Total
3. Received Requests Forwarded, Current
4. Received Requests Forwarded, Peak
5. Received Requests Forwarded, Total
10383794 Decision Center - increased precision shown in report data.
Decision Center reports where percentages are shown now display at least one decimal place instead of rounding to nearest integer.
10178734 External Rule Editor - add option to hide inherited rules. [For Decision Manager].
9959417 External Rule Editor - add option to override default title value. [For Decision Manager].
9726419 External Rule Editor - add option to display rule editor in read-only mode. [For Decision Manager].
The new external rule editor rendering optional properties can be set as follows:
<input type=hidden name="hideInheritedRules" value="true"/>
<input type=hidden name="title" value="My title"/>
<input type=hidden name="readOnly" value="true"/>