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.conf 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. You can have a maximum of one open tag and one close tag in the discoveryService element in a given configuration file.
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>
<multicast channel="228.5.6.7" port="one of the port in alotted AS ports"
timeout="1000" retry="3"/>
Conditional. The namingService and multicast elements are mutually exclusive; that is, only one of these elements can be configured at a time.
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>
<namingService name="Cos" host="mymachine.mydomain.com" port="14021"/>
Conditional. The namingService and multicast elements are mutually exclusive; that is, only one of these elements can be configured at a time.
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.