ReportCaster configuration parameters are managed within the ReportCaster Console Configuration tab. For additional ReportCaster configuration information, see the ReportCaster manual.
The size of the ReportCaster log report is limited by the amount of memory available to the Java VM. When the memory of the Java VM is exceeded, a Java OutOfMemoryException error occurs.
To control the size of the log report, you can set the following ReportCaster Server Configuration tool parameters:
If the ReportCaster Distribution Server experiences a Java out of memory error, you must increase the amount of memory (heap size) available to Java on the Distribution Server. This is done by passing parameters on the Java command line, as follows:
java -Xms<initial heap size> -Xmx<maximum heap size>
For example,
java -Xms256m -Xmx512m
In addition:
You must restart the Distribution Server to enable this change.
How to: |
The Distribution Server Failover feature allows you to configure a backup Distribution Server that can resume ReportCaster operations when there is an interruption (planned or unplanned) in the primary Distribution Server service. The primary Distribution Server is monitored to verify that it is operational. If there is an interruption in service, the failover Distribution Server is triggered to take over the role of the primary server.
The Workload Distribution feature allows ReportCaster to distribute scheduled jobs across multiple Distribution Servers, providing an efficient and fast way to process large numbers of ReportCaster schedules. Multiple Distribution Servers can be installed on one or more hosts. One instance is designated as the Workload Manager, while the other are designated as Workers. The WebFOCUS Repository will be shared by the Workload Manager and the Workers. Workload Distribution is set up through the ReportCaster Configuration tool. All servers will share one set of configuration information, and the Workload Manager will push any configuration changes to the Workers.
For your application of ReportCaster, you can configure either or both Failover and Workload Distribution. The following procedure includes instructions to configure both, but notes when to skip to the appropriate steps if you are only configuring one or the other.
To configure distribution server failover:
The Secondary Distribution Server dialog box opens, as shown in the following image.
To configure workload distribution:
The Workload Distribution dialog box opens, as shown in the following image.
Repeat this step for each Worker Distribution Server instance that you want to add.
The SchedulePreferences.xml file contains the Custom and Standard template information, as well as template information for the Schedule button feature available in Developer Studio.
<SchedulePreference __cn="ibi.broker.api.data.preference.schedule.SchedulePreference">
<id>Custom</id>
<name></name>
<description></description>
.
.
.
</SchedulePreference>
Important: Do not modify the information in the SchedulePreference element containing the <id>Standard<id> tag
<SchedulePreference __cn="ibi.broker.api.data.preference.schedule.SchedulePreference">
<id>Standard</id>
.
.
.
</SchedulePreference>
The Custom template lists all available distribution methods, report output formats, task types, scheduling intervals, notification options, and some other properties of a schedule. By removing an entry from the Custom template, an administrator can limit the scheduling options available to the user of the scheduling tool.
Note that some options may already be limited by the global settings in the ReportCaster configuration tool. Therefore, even if an entry is not removed from the Custom template, the option controlled by that entry may not be available in the scheduling tool.
Note:
See the following examples for ways to modify the Custom template.
In this example, only EXL07, EXL2K, HTML, and PDF will display as available report output formats in the scheduling tool. Other formats (<formatItem>) have been deleted from the Custom template.
<taskPreference __cn="ibi.broker.api.data.preference.schedule.TaskPreference"> <show>true</show> <collapsed>false</collapsed> <formatItem>EXL07</formatItem> <formatItem>EXL2K</formatItem> <formatItem>HTML</formatItem> <formatItem>PDF</formatItem> <taskType>TaskWFServerProcedure</taskType> . . . <taskType>TaskWFServerProcedure</taskType>
In this example, only Email and Library will display as available distribution methods in the scheduling tool. Other methods (<methodItem>) have been deleted from the Custom template.
</destinationPreference> <methodItem>EMAIL</methodItem> <methodItem>LIBRARY</methodItem> <storageLibraryPreference __cn="ibi.broker.api.data.preference.schedule.StorageLibraryPreference">
In this example, only Standard Reports and My Reports will display as available tasks in the scheduling tool. Other tasks (<taskType>) have been deleted from the Custom template.
<formatItem>SVG</formatItem> <taskType>TaskStandardReport</taskType> <taskType>TaskMyReport</taskType> <alertType>AUTO</alertType>
In this example, only Daily, Weekly, Monthly, and Custom periods will display as available intervals in the scheduling tool. Other intervals (<timeInfoTypeItem>) have been deleted from the Custom template.
<timeInfoPreference __cn="ibi.broker.api.data.preference.schedule.TimeInfoPreference"> <show>true</show> <collapsed>false</collapsed> <timeInfoTypeItem>DAY</timeInfoTypeItem> <timeInfoTypeItem>WEEK</timeInfoTypeItem> <timeInfoTypeItem>MONTH</timeInfoTypeItem> <timeInfoTypeItem>CUSTOM</timeInfoTypeItem> <secondaryRunInterval>true</secondaryRunInterval> </timeInfoPreference>
Support for UTF-8 can be added to the Distribution Server by adding -Dfile.encoding=UTF8 to the Distribution Server Java command. If the Distribution Server is being run from the command line, modify the schbkr bat or script file and add -Dfile.encoding=UTF8 to the Java command. If the Distribution Server is being run as a Windows Service, modify the Windows registry by accessing
HKEY_LOCAL_MACHINE\SOFTWARE\InformationBuilders\ReportCaster\WFXXXX
\Parameters\Java
and adding the following to the Options string:
-Dfile.encoding=UTF8
where:
Is the release number in which you are working.
How to: |
ReportCaster includes a configuration utility for SFTP public and private keys.
The ssh-keygen dialog box opens, as shown in the following image.
The Password strength field indicates the strength of the password entered.
The following image displays an example of a dialog box with all necessary changes made.
WebFOCUS writes two files to the drive:ibi\WebFOCUS80\ReportCaster\cfg directory. These are sftp_private_key.txt and sftp_private_key.txt.pub. The file sftp_private_key.txt.pub contains the public key.
WebFOCUS |