Oracle® Fusion Middleware Publishing Reports to the Web with Oracle Reports Services 11g Release 1 (11.1.1) Part Number B32121-03 |
|
|
View PDF |
The network configuration settings for the Oracle Reports Bridge component of Oracle Reports Services are stored in the XML file rwnetwork.conf
.
The rwnetworkconf.xsd
contains data type definitions for rwnetwork.con
f elements and attributes. See Section 8.5.1, "Network Configuration Elements".
These files are located in the directories specified in Table 8-1.
The rwnetworkconf.xsd
file provides the following data type definitions for configuring rwnetwork.conf
elements and attributes:
The discoveryService
element is defined in rwnetwork.xsd
as follows:
<xs:element name="discoveryService"> <xs:complexType> <xs:choice> <xs:element ref="multicast"/> <xs:element ref="namingService"/> </xs:choice> </xs:complexType> </xs:element>
Required/Optional
Required. You can have a maximum of one open tag and one close tag in the discoveryService
element in a given configuration file.
Description
The discoveryService
element opens and closes the content area of the network configuration file. In terms of the file's hierarchy, all the other elements are subordinate to the discoveryService
element.
The discoveryService
element has no attributes. It includes two sub-elements:
multicast
: see Section 8.5.1.2, "multicast"
namingService
: see Section 8.5.1.3, "namingService"
The multicast
element is defined in rwnetwork.xsd
as follows:
<xs:element name="multicast"> <xs:complexType> <xs:attribute name="channel" default="228.5.6.7" type="xs:string"/> <xs:attribute name="port" default="14021"> <xs:simpleType> <xs:restriction base="xs:integer"> <xs:minInclusive value="1"/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name="timeout" use="required"> <xs:simpleType> <xs:restriction base="xs:integer"> <xs:minInclusive value="100"/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name="retry" default="3"> <xs:simpleType> <xs:restriction base="xs:integer"> <xs:minInclusive value="1"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:complexType> </xs:element>
Example
<multicast channel="228.5.6.7" port="one of the port in alotted AS ports"
timeout="1000" retry="3"/>
Required/Optional
Conditional. The namingService
and multicast
elements are mutually exclusive; that is, only one of these elements can be configured at a time.
Description
The multicast
element contains the necessary information to identify where Reports Server is running the built-in broadcast mechanism. By default, multicast
is specified in rwnetwork.conf
.
The multicast
element attributes are described in Table 8-31.
Table 8-31 Attributes of the multicast
Element
Attributes | Valid Values | Description |
---|---|---|
Broadcast channel |
The broadcast channel used by the Reports Server. |
|
Broadcast port |
The broadcast port used by the Reports Server. |
|
Time (in milliseconds) it should wait for response. The optimum value for this setting is |
The Reports Client will wait for the specified timeout period for a response from the Reports Server. |
|
Retry count |
The Reports Client will retry for the specified number of times, if there is no response from the Reports Server after the timeout period. |
Note:
It is strongly recommended that you do not change the default channel and port unless it is absolutely necessary. The default port value forrwnetwork.conf
is assigned when you install Oracle Fusion Middleware.
If you want to customize rwnetwork.conf
, you must specify a valid port range reserved for Reports Server (14021 to 14030). If you are using the Oracle Reports Bridge for discovering Reports Servers across subnets, you should set the timeout
and retry
values carefully for the bridge to function correctly. Refer to Table 8-31 for setting the timeout value.
The namingService
element is defined in rwnetwork.xsd
as follows:
<xs:element name="namingService"> <xs:complexType> <xs:attribute name="name" use="required" type="xs:string"/> <xs:attribute name="host" use="required" type="xs:string"/> <xs:attribute name="port" use="required"> <xs:simpleType> <xs:restriction base="xs:integer"> <xs:minInclusive value="1"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:complexType> </xs:element>
Example
<namingService name="Cos" host="mymachine.mydomain.com" port="14021"/>
Required/Optional
Conditional. The namingService
and multicast
elements are mutually exclusive; that is, only one of these elements can be configured at a time.
Description
The namingService
element contains the necessary information required to be able to identify the host name and the port where the COS naming service is running. Specify this element only when the built-in broadcast mechanism is not suitable for your environment, as in the following scenarios:
Oracle Reports is installed on a machine that is connected to a network using VPN.
You want to avoid broadcast traffic on your network.
For more information, see Section 2.3.4.2, "Server Discovery Using the COS Naming Service".
The namingService
element attributes are described in Table 8-32.