summaryrefslogtreecommitdiff
path: root/TAO/orbsvcs/tests/Event/Mcast/Complex/README
blob: 54848f4c07d8f3e740d5051b7137b5abf603295d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55


Goals:
------
This is a step up from the Simple mcast test.  There are still two
Event Channels participating: one sends out its events via multicast,
while the second one listens for events on multicast.

But this test uses ECG_Mcast_Gateway configured with Complex
Address Server and Complex Mcast Handler components.  In other words,
different types of events are sent to different multicast addresses,
requiring an interested Event Channel to subscribe to all groups carrying
events of interest to its consumers.

Description:
------------
There are three executables: event supplier, event consumer,
and federation-enabled Event Channel, of which we run two instances -
one for supplier and one for consumer.  Federated Channels are
configured to use a different mcast group for each  event type.
Supplier pushes 100 events of each of the three event types to its
Event Channel while the consumer waits for events from its EC.  Once
the consumer receives 100 events of each of the three types it
expects, it destroys its EC and exits.

Command-line Options:
---------------------
Consumer: $consumer -ORBInitRef Event_Service=<ior>

Supplier: $supplier -ORBInitRef Event_Service=<ior>

Mcast-equipped EC: $gateway_ec -ORBsvcconf <conf_file> -i <ior_file>
where
<ior_file> is the name of the file to which the ior of the Event
           Channel will be printed
<conf_file> is a service conf file used to configure the Event Channel
            and the multicast components.  See consumer-ec.conf or
            supplier-ec.conf for examples, or
            $TAO_ROOT/orbsvcs/orbsvcs/Event/ECG_Mcast_Gateway.h for
            all valid multicast configuration options.

To run:
-------
Automagically (runs all executables, processes output):
$ run_test.pl

Manually:
$gateway-ec -ORBsvcconf consumer-ec.conf -i consumer-ec.ior
$consumer -ORBInitRef Event_Service=file://consumer-ec.ior
$gateway-ec -ORBsvcconf supplier-ec.conf -i supplier-ec.ior
$supplier -ORBInitRef Event_Service=file://supplier-ec.ior