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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
|
// $Id$
The MT-Cubit example
--------------------
COMPILING
---------
Makefile is provided. Use make to compile. Except, see below for
VxWorks-specific instructions for building the client.
You can either run the server in the background in the same window as
the client or open a separate window for the client and server.
OPTIONS
-------
Options are case sensitive, e.g., "-U" has a different meaning than "-u".
(1) server:
./server [-p <port_num>] // starting port
[-h <my_hostname>] // IP address to use
[-t <number_of_servants>] // # of servant threads to create
[-s ] // Do NOT use the naming service
[-f <ior_file> ] // specify a file to output all ior's
[-m ] // Use multiple priorities for threads
[-U ] // Run the server utilization test
// use the same option on the client
[-r ] // Run the thread-per-rate test
[-p <port_num>] is the port number at which the server will start the
first (and highest priority) servant. Successive servants will be
created starting at (port_num+1). The -t parameter specifies the total
number of servants.
Default Value: ACE_DEFAULT_SERVER_PORT /* see $ACE/ace/OS.h for actual number value */
[-h <my_hostname>] indicates the IP address the ORB should bind to.
This is useful when a machine has more than one network interface.
Default Value: Whatever ACE_OS::hostname () returns, which depends on the platform.
[-t <number_of_servants>] tells the server how many servants to create.
Default Value: 2
[-s ] Disables the use of the naming service to register the servants.
Default Value: Use naming service enabled.
[-f <ior_file> ] Use to specify a file to write all the iors from the
different servants out to disk.
Default Value: nil, which means not to write the iors to disk.
[-m ] For the 1 to n low priority servants, this parameter indicates
the use of a range of priorities for the threads.
Default Value: Disabled. One priority will be used for the
low priority threads.
[-U ] Run the server utilization test. This option overrides the "-t"
option. This option sets the number threads to one. NOTE: to use
this option successfully, you should also use "-U" on the client
side.
Default Value: Disabled. To enable, specify "-U" on the
command line.
[-r] turn on the thread-per-rate tests. (Priority inversion tests)
Default Value: Disabled.
The server will print the IOR of the servants, but it is not required
by the client.
(2) client:
./client [<ORB OPTIONS>] // ORB options, e.g., "-ORBobjrefstyle url"
[-d <datatype>] // what datatype to use for calls
[-n <num_calls>] // number of CORBA calls to make.
[-t <num_of_clients>] // number of client threads to create
[-f <ior_file>] // specify a file to dump the iors
[-r] // use thread-per-rate test.
[-o] // makes client use oneway calls instead
[-x] // makes a call to servant to shutdown
[-u <seconds> ] // run the client utilization test for <seconds> seconds
[-U <seconds> ] // run the servant utilization test for <seconds> seconds
[-1] // use one to n test.
[-g <granularity>] // choose the granularity of timing calls
[-c] // obtain number of context switches.
[-s] // makes client *NOT* use the name service
[-m] // use multiple priorities for the low priority client.
[-d <datatype>] <datatype> is one of the following:
0 Octet
1 Short
2 Long
3 Struct of the above 3 types
Default Value: 0
[-n <num_calls>] is the number of CORBA twoway calls to be made
Default Value: 1000
[-t <num_of_clients>] is the total number of concurrent clients to be
created. The clients will have successively decreasing
priorities if "-m" is specified.
Default Value: 2
[-f <ior_file> ] Use to specify a file to write all the iors from the
different servants out to disk.
Default Value: nil, which means not to write the iors to disk.
[-r] turn on the thread-per-rate tests. (Priority inversion tests)
Default Value: Disabled.
[-o] enables oneway calls instead of two-way calls. The oneway call
is a noop call (for now).
Default Value: Disabled
[-x] makes the client call the shutdown() method on the servant which
invokes the shutdown() method on the ORB and causes it to exit.
Default Value: Disabled
[-u] runs the client utilization test. This option overrides the "-t"
option to specify one client.
Default Value: Disabled
[-U] runs the *servant* utilization test. This option should be used
in conjunction with the server's "-U" option.
Default Value: Disabled
[-1] runs one to n test. One servant services all low priority clients.
Default Value: Disabled
[-g <granularity>] choose the granularity of timing the CORBA calls.
This option should disappear sometime in the future, together with
all the modifications done to support this.
What happens when this options is not used, is that (1) we start a
timer, (2) invoke the CORBA call, (3) stop the timer after call
returns. Some platforms have a very coarse grain timer (e.g. 10
msec) and timing individual calls does not report very accurate
latency results.
This option enables a way to (1) start the timer, (2) invoke
<granularity> calls, and (3) stop the timer. This way, we get a
better sense of the average latency of the CORBA calls.
The downside is that the mechanism to enforce the frequency of calls
(i.e., 20 Hz, 10Hz, etc) is in conflict with this option. Such
mechanism depends on the individual time for each call to enforce
the calling frequency.
Default Value: 1 (time each CORBA call)
[-c] Obtain number of context switches.
Default Value: Disabled
[-s] Makes client *NOT* use the name service
Default Value: Disabled. Will try to use the naming service.
[-m] Use multiple priorities for the low priority client
Default Value: Disabled. Will use one priority for all low priority clients.
VXWORKS specifics
-----------------
To build the client for VxWorks, for running the server and client
on a single target:
% make BIN=client ACELIB= LDLIBS="$ACE_ROOT/ace/.obj/High_Res_Timer.o $ACE_ROOT/ace/.obj/gethrtime.o $ACE/ace/.obj/Stats.o $ACE/ace/.obj/Log_Msg.o"
To run the server and client on a single target:
-> iam "<login>"
-> ld < server
-> ld < client
-> spa server, "-s", "-f", "ior.txt", "-t", "2"
-> spa client, "-s", "-f", "ior.txt", "-t", "2", "-n", "1000"
RESULTS
-------
The client prints the latency observed by the high priority client,
and the average latency observed by the low priority clients. Jitter
(standard deviation of the latency) is also printed by the client.
|
