BLOB Destination Configuration in Reports 11g
BLOB Destination Configuration in Reports 11g
Titleimage
Posted by Patrick Hamou on 2017:09:05 16:50:20
APPLIES TO:
Oracle Reports Developer - Version 11.1 to 11.1.1.6.0 [Release 11g]
Information in this document applies to any platform.
Checked for relevance on 13-Aug-2014
GOAL
This document explains what are the necessary steps to configure the BLOB destination in Reports 11g.
SOLUTION
Installation and Configuration
Installing BLOB Destination
Copy the file BLOBDestination11g.jar into $ORACLE_HOME/reports/jlib folder.
A new jar file is required for the BLOBDestination in Reports 11g. This new jar file (BLOBDestination11g.jar) can be downloaded here
Deploying the new destination class
You need to make the BLOB destination jar file (BLOBDestination.jar) available to Oracle Reports via the classpath.
This procedure depends on whether you are using the in-process Reports Server or a standalone Reports Server.
If you are using the in-process Reports Server, you need to modify the classpath for the WLS_REPORTS managed server.
The reason being that the in-process server inherits the classpath from its WLS_REPORTS instance.
If you are using the in-process reports server:
Edit the file setDomainEnv.sh (UNIX/Linux) / setDomainEnv.cmd (Windows) .
This file is in the directory $DOMAIN_HOME/bin.
Locate the lines :
On UNIX/Linux
if [ "${SERVER_NAME}" = "WLS_REPORTS" ] ; then
POST_CLASSPATH=" ... :${CLASSPATHSEP}${POST_CLASSPATH}"
export POST_CLASSPATH
fi
On Windows :
if "%SERVER_NAME%"=="WLS_REPORTS" (
set POST_CLASSPATH= ... ;%POST_CLASSPATH%
)
Add BLOBDestination11g.jar in POST_CLASSPATH
Example on Windows :
if "%SERVER_NAME%"=="WLS_REPORTS" (
set POST_CLASSPATH= ... ;c:\oracle\fmw11g\oracle_pfrd\reports\jlib\BLOBDestination11g.jar;%POST_CLASSPATH%
)
Restart the managed server WLS_REPORTS from the Enterprise Manager or from the WLS console.
If you are using a standalone reports server:
Add the following entry to the REPORTS_CLASSPATH environment variable:
$ORACLE_HOME/reports/jlib/BLOBDestination11g.jar
On Windows, use the registry to specify the value. On Unix/Linux, set the environment variable in reports.sh.
Register the new destination with the Oracle Reports Services
To register the new destination with the Reports Server, you need to add the new destination in the Reports Server configuration file.
To create this new destination using the "Oracle Enterprise Manager" Web Site :
Oracle Fusion Middleware Publishing Reports to the Web with Oracle Reports Services
11g Release 1 (11.1.1)
Part Number B32121-03
7.13 Registering Pluggable Destinations with Reports Server
Name: BLOBDestination
Class: oracle.reports.plugin.destination.blob.BLOBDestination
Example :
If really needed, you can modify the files rwserver.conf manually.
Beginning in Oracle Reports 11g Release 1 (11.1.1), it is recommended that configuration should be done only through Oracle Enterprise Manager.
If you are using the in-process reports server:
The configuration file is in the directory :
$DOMAIN_HOME/config/fmwconfig/servers/<WLS_SERVER_NAME>/applications/reports_<version>/configuration .
If you are using a standalone reports server:
The configuration file is in the directory :
$ORACLE_INSTANCE/config/ReportsServerComponent/<Reports Server Name> .
Specifically, add the following entry:
<destination destype="BLOBDestination" class="oracle.reports.plugin.destination.blob.BLOBDestination">
</destination>
Restart the Reports Server for your changes to take effect.
Caution
This sample code is provided for educational purposes only and not supported by Oracle Support Services. It has been tested internally, however, and works as documented. We do not guarantee that it will work for you, so be sure to test it in your environment before relying on it.
Please note also that there is no BLOBDestination.jar file in the Oracle Forms and Reports installation itself, also not in the 12c installation.
REFERENCES
NOTE:1089032.1 - DESTYPE=BLOBDestination in Reports 11g Fails With : java.lang.IllegalAccessError: tried to access class oracle.jdbc.driver.OracleResultSet
Posted by Patrick Hamou on 2017:09:05 16:50:20