To configure the networking functionality required to support a distributed application, include the following entries in the configuration file of Table 12‑1.
MODEL (Required) MP. This parameter enables all other networking parameters. It is used only for networked machines. SHM is used for a single-machine configuration, even if the machine is a multiprocessor. OPTIONS (Required) LAN (Local Area Network) to indicate that communication will take place between separate machines, rather than between separate processes on the same machine. MAXNETGROUPS (Optional) Designate a limit on the number of NETGROUPS that can be defined. The default is 8; the upper limit, 8192. Determine whether encoding is required when messages are exchanged by two machines. The TYPE parameter specifies the data representation being used on each machine being defined. If a message is being sent from a machine on which one type of data representation is being used to a machine on which a different type of data representation is being used, the message to be sent must be encoded before transmission and decoded upon arrival.You do not need to set this parameter if the same type of data representation is used on all machines that will exchange messages. The parameter must be set only for a machine on which a different type is used. For example, if you have nine SPARC machines and one HP machine, you must specify TYPE=string only for the HP. For the SPARC machines, the default null string identifies them as the same type. Specify the compression threshold, that is, the minimum byte size for a message to be compressed before being sent to a remote and/or local destination. The value of both remote and local is a number between 0 and MAXLONG. If CMPLIMIT is set to only one value, it is assumed that the specified value is the remote argument and that messages sent to local destinations are never compressed.For example, if you set CMPLIMIT=1024, than any message greater than 1024 bytes bound for a remote location is compressed.Compression thresholds can also be specified with the variable TMCMPLIMIT. See the discussion, in tuxenv(5), about the variable TMCMPPRFM, which sets the degree of compression in a range of 1 to 9. Add an application-specific number to the value of LOAD for a remote service. The result is used by the system to evaluate whether a request should be processed locally or sent to a remote machine. A higher NETLOAD results in less traffic being sent to a remote machine. NETGROUPS (Optional) NETGROUP (Required) Specify a number by which the system can identify a group of machines. The value can be any number between 1 and 8192. For DEFAULTNET, the value of NETGRPNO must be 0. Assign a priority to a NETGROUP. This parameter helps the system determine which network connection to use. The number must be between 0 and 8192. Assign a higher priority to your faster circuits; give your lowest priority to DEFAULTNET. NETWORK (Optional) LMID (Required) Map the specified machine to one of the entries in the MACHINES section. Specify the listening address for the BRIDGE process on this LMID. There are four valid formats for specifying this network address. See the NETWORK section of UBBCONFIG(5) for details. Specify the network address for the tlisten process on this LMID. Valid formats are the same as the valid formats for NADDR. Specify a NETWORK group name. The value of string must be a group name specified in the NETGROUPS section. The default is DEFAULTNET.
• At the sending end—the BRIDGE sends a message to destination_machine by writing the message to a virtual circuit and delegating, to the operating system, responsibility for sending it. The operating system retains a copy of every pending message. If a network error occurs, however, pending messages are lost.
• At the receiving end—the BRIDGE process listens on a particular network address for incoming messages.
• By listening at more than one address, the BRIDGE achieves higher availability.
• By sending data simultaneously on parallel data circuits, the BRIDGE can achieve a higher throughput, if the network was the limiting factor before.
• When you configure parallel data circuits, the software does not necessarily fail to deliver a message if the original destination circuit is busy. The system attempts to schedule traffic over the circuit with the highest network group number (NETGRPNO). If this circuit is busy, the traffic is automatically scheduled over the circuit with the next (that is, the second highest) network group number. When all circuits are busy, data is queued until a circuit is available.Figure 12‑1 describes how data flows when one machine tries to contact another. The figure is based on a sample scenario involving two machines: machine A and machine B. First, the BRIDGE identifies the network groups that are common to both machines: the MAGENTA_GROUP, the GREEN_GROUP, and the DEFAULTNET.Data flows in parallel on network groups with the same priority (that is, groups for which the same value is assigned to the NETPRIO parameter). Network groups with different priorities are used for failover.Figure 12‑1 Flow of Data over the BRIDGEData flows over the highest available priority circuit. If all network groups have the same priority, data travels over all networks simultaneously. If all circuits at the current priority fail, data is sent over the next lower priority circuit. This process is called failover. When failover occurs, the failed connections are retried periodically.When higher priority network connections are reestablished, failback occurs and no further data is scheduled for the lower priority connection. The lower priority connection is disconnected in an orderly fashion.
Note: The hardware and system software prerequisites for configuring multiple network groups (NETGROUPS) are beyond the scope of this document. For example, machines are frequently required to belong to more than one physical network. Each TCP/IP symbolic address must be identified in the /etc/hosts file or in the DNS (Domain Name Services).In the following example, it is assumed that in addresses written in the form //A_CORPORATE:5345, the string A_CORPORATE is specified in the /etc/hosts file or in DNS.
• DEFAULTNET (the default network, which is the corporate WAN)
• MAGENTA_GROUP (a LAN)
• BLUE_GROUP (a LAN)
• GREEN_GROUP (a private LAN that provides high-speed, fiber, point-to-point links between member machines)All machines belong to DEFAULTNET (the corporate WAN). In addition, each machine is associated with either the MAGENTA_GROUP or the BLUE_GROUP. Finally, some machines in the MAGENTA_GROUP also belong to the GREEN_GROUP. Figure 12‑2 illustrates group assignments for the network.Figure 12‑2 Example Network Groups
• DEFAULTNET (the corporate WAN)
• MAGENTA_GROUP (LAN)
• GREEN_GROUP (LAN)
• DEFAULTNET (the corporate WAN)
• MAGENTA_GROUP (LAN)
• DEFAULTNET (the corporate WAN)
• BLUE_GROUP (LAN)Because the local area networks are not routed to all locations, machine D (in the BLUE_GROUP LAN) may contact machine A (in the GREEN_GROUP LAN) only by using the single address they have in common: the corporate WAN network address.To set up the configuration described in the preceding section, the First State Bank administrator defines each group in the NETGROUPS and NETWORK sections of the UBBCONFIG file as follows:*NETGROUPS
DEFAULTNET NETGRPNO = 0 NETPRIO = 100 #default
BLUE_GROUP NETGRPNO = 9 NETPRIO = 200
MAGENTA_GROUP NETGRPNO = 125 NETPRIO = 200
GREEN_GROUP NETGRPNO = 13 NETPRIO = 300
*NETWORK
A NETGROUP=DEFAULTNET NADDR="//A_CORPORATE:5723”
A NETGROUP=MAGENTA_GROUP NADDR="//A_MAGENTA:5724"
A NETGROUP=GREEN_GROUP NADDR="//A_GREEN:5725"B NETGROUP=DEFAULTNET NADDR="//B_CORPORATE:5723"
B NETGROUP=MAGENTA_GROUP NADDR="//B_MAGENTA:5724"
B NETGROUP=GREEN_GROUP NADDR="//B_GREEN:5725"C NETGROUP=DEFAULTNET NADDR="//C_CORPORATE:5723"
C NETGROUP=MAGENTA_GROUP NADDR="//C_MAGENTA:5724"
D NETGROUP=DEFAULTNET NADDR="//D_CORPORATE:5723"
D NETGROUP=BLUE_GROUP NADDR="//D_BLUE:5726"Assigning priorities appropriately for each NETGROUP enables you to maximize the capability of network BRIDGE processes. When determining NETGROUP priorities, keep in mind the following considerations:
• If all circuits at the current priority fail, data is sent over the next lower priority circuit.
• The default value of NETPRIO is 100.Figure 12‑3 shows how the First State Bank administrator assigns priorities to the available network groups.Figure 12‑3 Assigning Priorities to Network Groups
• BLUE_GROUP=200
• DEFAULTNET=100
• GREEN_GROUP=300
• MAGENTA_GROUP=200You can assign a network priority to the default network group by setting the NETPRIO parameter for DEFAULTNET just as you do for any other group. If you do not specify a priority for DEFAULTNET, a default of 100 is used, as shown in the following example:For DEFAULTNET, the value of the network group number (NETGRPNO) must be zero; any other number is invalid. The value of NETGRPNO must be unique for each entry.On the other hand, the same value of NETPRIO may be assigned to multiple network groups. For example, in the First State Bank configuration file, the same network priority (NETPRIO=200) is assigned to both the MAGENTA_GROUP and the GREEN_GROUP.Each network address (NETWORK) is associated by default with the DEFAULTNET network group. This parameter may be specified explicitly for either of two reasons: to maintain uniformity among entries, or to associate the network address being defined with a second network group.