Merge pull request #1844 from jrw972/monterey
[ACE_TAO.git] / TAO / tests / RTCORBA / Server_Protocol / README
blob80205653d74e54221edad04d5c671239f02cc499
3 This is a unit test for RTCORBA::ServerProtocolPolicy.
5 Scenario:
6 --------
7 The server first prints out its ORB default Server Protocol policy.
8 If the <-p> command line option was specified, a child POA is created
9 and configured with Server Protocol Policy containing a single
10 protocol specified with <-p> (see options section below).
11 The object is registered with child POA if one was created (root poa
12 otherwise) and the server waits for requests.
13 The client obtains server IOR and makes a single invocation, causing
14 server process to shut down its orb and exit.
16 To run (on Unix):
17 -------
18 $./server [-o <ior_file> -p <profile_id>]
19 $./client [-k <ior>]
22 Options:
23 --------
24          Server:
26 -o <ior_output_file>   Default: test.ior
27                        Filename for output of server's IOR.
29 -p <profile_id>        Default: none.
30                        The POA with which the object will be
31                        registered will be configured with Server
32                        Protocol Policy cotaining a single protocol -
33                        the one identified by <profile_id>.  If this
34                        option is not present, then the POA is not
35                        configured with Server Protocol Policy and ORB
36                        default is used.
38          Client:
40 -k <server_ior>        Default: file://test.ior
41                        Server's IOR
43 Expected output:
44 ----------------
45 Expected output varies with the configurations used to run the test.
46 General guidelines:
48 1) ORB default ServerProtocolPolicy must contain all the protocols
49    that were loaded in the order they were loaded.  This can be
50    manipulated through the use of service config files (see run_test.pl)
52 2) Run client with -ORBdebuglevel 1 to see which protocol is used for
53    communication.  Make sure it is the same protocol that was
54    specified with <-p> or the first available from orb default server
55    protocol policy if <-p> wasn't specified (see run_test.pl for
56    sample options)
58 3) See OMG Real-Time CORBA specification and TAO's Real-Time CORBA
59    documentation for more information.
62 Sample Run/Output (on Unix):
63 ----------------
64 * Server:
66 $./server -ORBendpoint iiop:// -ORBendpoint uiop:// -ORBendpoint \
67 shmiop:// -p 1413566210
69 ORB default for ServerProtocolPolicy contains 3 protocols:
70   Protocol 0: IOP::ProfileId = 0
71      Properties:
72       send_buffer_size = 65536
73       receive_buffer_size = 65536
74       no_delay = 1
75   Protocol 1: IOP::ProfileId = 1413566208
76      Properties:
77       send_buffer_size = 65536
78       receive_buffer_size = 65536
79   Protocol 2: IOP::ProfileId = 1413566210
81 Activated as <IOR:000000000000000d49444c3a546573743a312e30000000000000000154414f020000008000010200000000116163652e63732e777573746c2e6564750000cbef0000002314010f004e535439b59013000388560000000100000001000000000000000100000001000000000300000000000000080000000054414f000000000100000014000000000001000100000000000101090000000054414f000000000400000000>
83 Received request to shut down the ORB
84 Server ORB event loop finished
87 * Client (in a separate window):
89 $./client -ORBdebuglevel 1
90 TAO (20145|1) Loaded default protocol <IIOP_Factory>
91 TAO (20145|1) Loaded default protocol <UIOP_Factory>
92 TAO (20145|1) Loaded default protocol <SHMIOP_Factory>
93 TAO (20145|1) SHMIOP connection to server <127.0.0.1:52207> on 8