8.5 Network Configuration File

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.

8.5.1 Network Configuration Elements

The rwnetworkconf.xsd file provides the following data type definitions for configuring rwnetwork.conf elements and attributes:

discoveryService
multicast
namingService

8.5.1.1 discoveryService

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"

8.5.1.2 multicast

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
`channel`	Broadcast channel	The broadcast channel used by the Reports Server.
`port`	Broadcast port	The broadcast port used by the Reports Server.
`timeout`	Time (in milliseconds) it should wait for response. The optimum value for this setting is `1000`.	The Reports Client will wait for the specified timeout period for a response from the Reports Server.
`retry`	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 for rwnetwork.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.

8.5.1.3 namingService

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.

Table 8-32 Attributes of the namingService Element

Attributes	Valid Values	Description
`name`	`Cos`	The descriptive name of the naming service.
`host`	Host name/IP	The host name of the machine where the naming service is running.
`port`	Port number	The port number of the machine where the naming service is running.