source: trunk/FACT++/dim_v19r15/README_v19.txt@ 10278

Last change on this file since 10278 was 10183, checked in by tbretz, 14 years ago
New import.
File size: 22.0 KB
Line 
1
2 DIM version 19.15 Release Notes
3
4Notes 1 and 2 for Unix Users only
5NOTE 1: In order to "make" DIM two environment variables should be set:
6 OS = one of {HP-UX, AIX, OSF1, Solaris, SunOS, LynxOS, Linux, Darwin}
7 DIMDIR = the path name of DIM's top level directory
8 The user should then go to DIM's top level directory and do:
9 > source .setup
10 > gmake all
11 Or, if there is no support for C++ on the machine:
12 > gmake CPP=no all
13
14NOTE 2: The Name Server (Dns), DID, servers and clients (if running in
15 background) should be started whith the output redirected to a
16 logfile ex:
17 Dns </dev/null >& dns.log &
18
19NOTE 3: The Version Number service provided by servers is now set to 1915.
20
2120/12/2010
22Changes for version 19.15:
23 - Still fixing dis_stop_serving():
24 - The DNS sometimes gets a remove service message from a server, after the server has
25 closed the connection, this was not handled properly - fixed.
26 - Fixed yet another detail (variable not cleared) in the thread handling at dis_stop_serving().
27 - dtq.c now clears all timer_queues at dis_stop_serving()
28 - Added some protections in case of closed connections.
29
30
3110/12/2010
32Changes for version 19.14:
33 - Still fixing dis_stop_serving():
34 - Adedd pthread_join in linux to wait for threads to die
35 - the following dis_start_serving() would not reconnect to the DNS if the DNS connection
36 was pending (i.e. the DNS was stopped or restarted)
37
38
3906/12/2010
40Changes for version 19.13:
41 - Fixed a few compiler warnings in dis.c
42 - Added #ifndef PXI around some Windows setPriority calls
43 - dis_stop_serving() did not completely clean-up DIM so that another dis_start_serving()
44 could be done properly after for example a "fork()". Fixed.
45
46
4720/09/2010
48Changes for version 19.12:
49 - Fixed a bug added when removing warnings in v19r10 (dis.c and dns.c).
50
51
5207/06/2010
53Changes for version 19.11:
54 - Added some protections in update_service() in order to try to solve a DIP issue.
55 (related to very frequent updates of the same service in different threads)
56 - Added the possibility of defining timeouts for:
57 - DimBrowser::getServices
58 - DimBrowser::getServers
59 - DimBrowser::getServerServices
60 - DimBrowser::getServerClients
61 - Added the possibility of retrieving the time a command arrived:
62 - int dis_get_timestamp(int service_id, int *secs, int *millisecs) in C
63 - int DimCommand::getTimestamp() and int DimCommand::getTimestampMillisecs() in C++
64 - Added a "const" keyword to the "char *format" parameter in the constructors of
65 - DimService and DimCommand
66 - Added a call DimCommand::hasNext(), can be used when commands are queued.
67 - Fixed a memory leak when using DimService::setData and then dynamically deleting the
68 DimService
69
70
7117/02/2010
72Changes for version 19.10:
73 - Fixed a bug in the DNS related to the latest change (browsing for a single service name)
74 The DNS could crash when killing a server.
75 - Removed some compilation warnings
76
77
7804/01/2010
79Changes for version 19.09:
80 - Created two new functions: dis_set_debug_on() and dis_set_debug_off(), these
81 enable or disable printing a message per service update
82 - Tried to protect against:
83 - a service being deleted from the server while it is being updated
84 - a client unsubscribing from a service while it is being updated.
85 - Optimized the DNS when browsing for a service search pattern without wildcards
86 (i.e. browsing for a single service name)
87
88
8913/11/2009
90Changes for version 19.08:
91 - Since version v18r4 where dim_wait() was modified, dim_wait could hang in windows if
92 the wake_up event was triggered before dim_wait was called. Could affect smi++.
93 Fixed.
94 - Fixed a compilation bug in dis.c that affected some platforms.
95
96
9730/10/2009
98Changes for version 19.07:
99 - Some more bugs related to being able to publish to more that one DNS fixed.
100
101
10228/10/2009
103Changes for version 19.06:
104 - When opening DNS connections, when the DNS is not there, from a process that is at the
105 same time a client and a server only one pending connection was used now two separate
106 ones are created.
107 - Tried to fix a few more problems related to dis_stop_serving...
108
109
11026/10/2009
111Changes for version 19.05:
112 - dis_stop_serving had stopped working in version 19.4. So all servers that undeclared
113 all services and then tried to re-declare new ones would fail (corrupted server name).
114 Affected in particular the DimBridge
115
116
11727/08/2009
118Changes for version 19.04:
119 - Added the following functions:
120 Server part:
121 C - dis_get_n_clients(int service_id)
122 C++ - int DimService::getNClients()
123 Client part (C++ only):
124 DimClient::setNoDataCopy()
125 This will prevent any data copy in the client and the user should make
126 sure that the data received from DIM is not used outside the callback
127 in order to benefir from this feature.
128 - Fixed the Java DIM Jar file, it was wrong in the previous version.
129
130
13131/07/2009
132Changes for version 19.03:
133 - Removed some more compilation warnings.
134 - Fixed a bug in the DNS. The mechanism for retrieving the "SERVER_LIST" when
135 some server names were longer that 35 characters was very slow.
136
137
13806/07/2009
139Changes for version 19.02:
140 - Fixed a bug in the server part handling of RPCs, it created a memory leak.
141 It was using a separate thread to handle timeouts and there is no safe way to
142 kill a thread from outside. Fixed.
143 - the function dim_stop_thread() is now obsolete.
144 - Added the possibility to change the send and receive buffer sizes:
145 - int dim_set_write_buffer_size(int size)
146 - int dim_get_write_buffer_size()
147 - int dim_set_read_buffer_size(int size)
148 - int dim_get_read_buffer_size()
149 The default (and minimum) is 16384 bytes.
150 These calls should be done before any other DIM calls.
151 - Fixed a bug in the Java DimBrowser class (the format was not returned correctly)
152
15304/05/2009
154Changes for version 19.01:
155 - A server can now publish to more than one DNS.
156 To use an extra DNS:
157 - in "C":
158 long dnsid;
159 char extra_dns[128];
160 ...
161 dim_get_env_var("EXTRA_DNS_NODE", extra_dns, sizeof(extra_dns));
162 dnsid = dis_add_dns(extra_dns,0);
163 sprintf(name1,"NewService%d",i);
164 dis_add_service_dns(dnsid, name1, "I", &NewData, sizeof(NewData),
165 (void *)0, 0 );
166 dis_start_serving_dns(dnsid, "xx_new");
167
168 - in C++:
169 DimServerDns *newDns;
170 char *extraDns = 0;
171 DimService *new_servint;
172 ...
173 extraDns = DimUtil::getEnvVar("EXTRA_DNS_NODE");
174 if(extraDns)
175 newDns = new DimServerDns(extraDns, 0, "new_TEST");
176 ...
177 if(extraDns)
178 new_servint = new DimService(newDns, "new_TEST/INTVAL",ival);
179
180 - Removed all warnings from DIM sources so that it can be compiled with -Wall -Wextra on Linux
181 - Changed the makefiles so that the default on Linux is now 64 bits.
182 - The flag 32BITS=yes can be added in order to generate 32 bit code
183
184
18526/02/2009
186Changes for version 18.05:
187 - Made the callback for "DIS_DNS/SERVER_LIST" uninterruptible, so that two clients subscribing
188 would not get mixed up answers.
189 - The same for "<server>/SERVICE_LIST"
190 - Tryied to fix a DNS crash, introduced in v18r4 by releasing the connection when "informing clients".
191 - removed some "//" comments in "C"
192
193
19420/02/2009
195Changes for version 18.04:
196 - Changed the dim_wait() mechanism, so that it works for several threads in parallel:
197 - On Linux it was based on POSIX semaphores now it is based on POSIX "condition
198 variables"
199 - On Windows it was based on "Auto Reset Events" now it uses "Manual Resel "Events"
200 - The DNS should now correctly update the "DIS_DNS/SERVER_LIST" service. It used to report
201 a new server, even when the services already existed and the server was killed by the DNS.
202 (And never report it killed). It also didn't report correctly when a server went out of "ERROR"
203 (this is reported as a "+" as for a new server).
204
205
20605/02/2009
207Changes for version 18.03:
208 - The list of registered services in a server could get corrupted in some rare cases
209 making the server crash - fixed.
210 - If the DNS couldn't talk to a client it could sometimes hang - fixed.
211 - Java client modifications:
212 - DimUpdatedInfo was not working correctly - fixed in dim_jni.c.
213 - Implemented DimRpcInfo
214 - Changed the DimBroser class to use DimRpcInfo.
215 - Added a jdim.jar file in the jdim/classes directory of the DIM distribution
216
217
21815/01/2009
219Changes for version 18.02:
220 - Added the following functions:
221 - C++ Client
222 - int DimClient.getServerPid()
223 - Java Client
224 - int DimClient.getServerPid()
225 - String[] DimBrowser.getServers()
226 - String DimBrowser.getServerNode(String server)
227 - int DimBrowser.getServerPid(String server)
228
229
23009/01/2009
231Changes for version 18.01:
232 - Added in the distribution the Visual Studio 8 dlls and manifest. Otherwise
233 it would not work on most PCs.
234
235
23603/12/2008
237Changes for version 18.00:
238 - The Windows execulables and libraries are now built using Visual Studio 8
239 - Some changes added by GSI mainly in the Java Native Interface
240
241
24206/11/2008
243Changes for version 17.12:
244 - Client functionality:
245 - Added a new function dic_stop(), to close anything related to DIM
246 for a client
247 - Added the function dic_get_server_pid(). Similar to dic_get_server().
248 Can be executed in a callback to retrieve the pid of the current server
249 - DimBrowser Class:
250 - DimBrowser::getServices() used to create and destroy the DimRpc connection
251 to the Dns every time it was called. This was heavy if called in a loop.
252 Now the connection is maintained until the DimBrowser itself is destroyed.
253 - A new method DimBrowser::getNextServer(char *&server, char *&node, int *pid)
254 has been created. similar to the previous one but returns also the server pid.
255 - DNS
256 - The DNS was still doing some blocking write calls to servers or clients.
257 Now all write calls have a timeout and can not block forever.
258 - Linux DID
259 - The "Subscribe" button was subscribing to services with update rate of 10 seconds.
260 This was misleading, the users could think the server was calling update_service
261 when it wasn't.
262 Now there are two Subscribe buttons ("on change" or "Update rate of 10 seconds").
263 - DimDridge
264 - Accepts an extra flag "-copy" which provokes an internal copy of the data.
265
266
26708/09/2008
268Changes for version 17.11:
269 - Some DIM Processes, servers or clients could enter a loop taking 100 % CPU
270 time in some rare occasions, fixed.
271 - Added some protections when removing services in the DimBridge.
272
273
27430/08/2008
275Changes for version 17.10:
276 - Some DIM Processes, servers or clients would not reconnect when the DNS was
277 restarted. Fixed two cause:
278 - Some processes in Linux were stuck reading from the DNS socket
279 - Some others "forgot" to set a timer under very special conditions
280 - Changed some of the DNS debug messages to be more explicit.
281
282
28321/07/2008
284Changes for version 17.09:
285 - DIM error messages were not being flushed when the output was redirected
286 to a logfile, fixed.
287
288
28918/07/2008
290Changes for version 17.08:
291 - Sometimes a server or a client could do a read on a sockect that had just
292 been closed which left them hanging forever - fixed.
293
294
29501/07/2008
296Changes for version 17.07:
297 - The DimTimer was sometimes not started when the constructor was called
298 with a time argument.
299 - Clients could not connect to more than 1024 servers - fixed.
300 (if the machine allows more than 1024 connections)
301
302
30330/06/2008
304Changes for version 17.06:
305 - Corrected the makefile for Darwin, now the number of accepted connections is
306 increased to 8192 only for Linux.
307 - Fixed a bug in the DimTimer, it used to accept to be re-started, but then crashed
308 at destruction time if not stopped the same number of times. Now it can not be
309 re-started.
310 - The Dns used to ask servers to re-register at regular intervals when they were not
311 sending their watchdog messages (i.e. they were in "ERROR", red in DID). Now the
312 DNS only asks once (unless they answer). This could cause the DNS to hang if
313 servers were in ERROR for a long time.
314 - The Dns now accepts a command line parameter: -d to print debug messages.
315 - The clients were not handling properly the case when they could contact the DNS
316 but then they could not contact the server that the DNS gave them (either because
317 of a firewall or because the server run on an inaccessible network). In this case
318 the clients would timeout trying to contact the server for each service and kept
319 asking the DNS the server coordinates over and over again. Now the clients keep
320 a list on unreacheable servers, so they don't try to contact the server for each
321 service and only ask the DNS again with an increasing interval that goes from 10
322 seconds to 2 minutes maximum.
323 - The server now issues an error message if the format string is too long.
324 - Linux DID
325 - Removed the command "Kill ALL Servers", it was too dangerous
326 - Now the list of nodes in "View Servers by Node" is in alphabetical order and
327 in lowercase.
328
329
33030/04/2008
331Changes for version 17.05:
332 - In Linux in some cases a SIGPIPE was generated. Normally the DIM library sets
333 the behaviour of SIGPIPE to ignored, but if another library or main program
334 changes the SIGPIPE behaviour, then the application could exit when the SIGPIPE
335 was generated. Fixed - on Linux now the function send with flag MSG_NOSIGNAL
336 is used in oder to avoid generating SIGPIPE.
337
338
339
3404/04/2008
341Changes for version 17.04:
342 - Sometimes processes (servers or clients) would hang when the DNS was restarted.
343 This was due to a strange (Windows?) feature, by which a connect could succeed
344 after a connection was closed (and reported) on the other side. Fixed.
345
346
347
34827/03/2008
349Changes for version 17.03:
350 - Can now make DID for 64 bits by making DIM using:
351 gmake X64=yes all
352 - Increased the size of the Hash tables for the servers and the DNS.
353
354
355
35620/02/2008
357Changes for version 17.02:
358 - Fixed the Java DimTimer - stop() didn't work
359 Required changing dim_jni.c as well as the java part
360 - Fixed DIM for Darwin - had stopped working
361
362
363
36420/01/2008
365Changes for version 17.01:
366 - The Java API now works on 64 bit machines, Thanks to Joern Adamczewski.
367 Please use:
368 gmake JDIM=yes all
369 - Linux executables are now compiled/linked on slc4 (32 bits).
370 - Big changes in the DimRpcs both client and server part. Tere were bugs
371 related to the handling of timeouts.
372 Unfortunatelly all applications using RPCs need to be re-linked.
373
374
375
376-----------------------------------------------------------------------------------------
377Previous version history:
378
37907/12/2007
380Changes for version 16.14:
381 - Now by default All DIM processes are ready to accept up to 8192 connections, both
382 in Linux and Windows. Although in Linux for this to be effective the machine system
383 limits must allow more than 1024 descriptors/open files per process.
384 - Fixed a little memory leak in tokenstring.cxx
385 - And a little compilation bug for some platforms in tcpip.c
386
387
38815/05/2007
389Changes for version 16.13:
390 - If DIM_HOST_NODE is defined when starting up a server, a DIM client will now try
391 two network interfaces in order to talk to that server and only give up if they both
392 fail. First it will try the ip name or ip address specified by the server using
393 DIM_HOST_NODE, if that fails it will try the ip address of the default interface
394 retrieved by the server using gethostname (and gethostbyname).
395 The changes basically affect the case in which the DIM_HOST_NODE given to the servers
396 is specified as IP address instad of an IP name. Otherwise this mechanism was already
397 working.
398
399
4003/05/2007
401Changes for version 16.12:
402 - The Java version did not exit properly when main() terminated - fixed.
403
404
40525/04/2007
406Changes for version 16.11:
407 - On Linux the timeout to detect a lost connections (unplugged ethernet cable
408 or machine reboot) was too long, around 15 minutes - Fixed.
409 On Linux the KEEPALIVE feature is now used instead of a regular socket write,
410 all other platforms should work as before.
411
412
41321/02/2007
414Changes for version 16.10:
415 - Found a bug in dis_stop_serving: one socket connection was not closed - fixed.
416 - Implemented a new environment variable for the DNS: DIM_DNS_ACCEPTED_NODES
417 Can receive a list on nodes or domains separated by commas.
418 If the DNS receives a connection from a node not in this list, it will
419 reject it and kill the server or client requesting it.
420 - Fixed some C++ warnings.
421
422
42319/01/2007
424Changes for version 16.9:
425 - The modifications done in version 16.8 have introduced a bug:
426 - DIM servers would not behave properly (exit) when receiving a kill command
427 from the DNS (for duplicated services, not allowed host names or manual "kill")
428 This is now fixed.
429
430
43130/10/2006
432Changes for version 16.8:
433 - Modified dis_stop_serving() and DimServer::stop() to completely stop DIM:
434 - Stop also the DIM threads.
435 - Release all allocated memory
436 - Allow a different port number when re-starting.
437
438
43911/07/2006
440Changes for version 16.7:
441 - Prepared for increasing the number of open connections per process
442 (On Linux still requires changing some parameters and recompiling the Dns)
443 - Fixed one error and several warnings for gcc 4.
444
445
44611/05/2006
447Changes for version 16.6:
448 - Sometimes a server or client would crash while exiting if the DNS was not running.
449 Fixed.
450 - Fixed the reporting of some ERROR messages on Windows (used to report error "0")
451 - Allowed dim_send_command to receive instead of -dns <node_name>
452 -dns <node_name>[:<port_number>]
453
454
45501/05/2006
456Changes for version 16.5:
457 - Big Spring Cleanup. Removed most warnings. Can now be compiled on
458 Windows with Warning Level 3 and on Linux with -Wall
459 (still not working for -ansi -pedantic...)
460 - When trying to access a server in a different network (i.e. not reacheable)
461 a client (for example DID) would take very very long to timeout - fixed.
462 - Added two new sets of functions that allow setting the DIM_DNS_NODE separately
463 for a server and a client in the same process:
464 - int dis_set_dns_node(char *node)
465 - int dis_get_dns_node(char *node)
466 - int dis_set_dns_port(int port)
467 - int dis_get_dns_port()
468
469 - int dic_set_dns_node(char *node)
470 - int dic_get_dns_node(char *node)
471 - int dic_set_dns_port(int port)
472 - int dic_get_dns_port()
473 These routines should be used instead of the equivalent ones starting with "dim_"
474 since these set the same DIM_DNS_NODE/port for both Server and client parts of a
475 process.
476 - Adapted the C++ equivalents (DimClient::setDnsNode, etc. and DimServer::setDnsNode,
477 etc.) to use the new routines, so they are now independent.
478 Adapted also the Java equivalents.
479 - Fixed DimBridge to use the new routines.
480 - Fixed a bug in DID that made it crash sometimes at startup (and also when the DNS
481 restarted)!
482 - Found some very interesting features of DIM:
483 - In a node with two ethernet interfaces (so connected to two networks):
484 - The DNS will answer to servers and client on both networks, only its server
485 part - DIS_DNS (the one that answers to DID and DimBrowser requests) would
486 in principle answer only to one of the networks (in principle the default
487 interface* but can be changed by setting the environment variable "DIM_HOST_NODE").
488 - But, in fact, if the DNS or any server is started with the environment variable
489 DIM_HOST_NODE set to the interface that is not the default* one. Than both the
490 DNS (including the server part) and the DIM servers will be accessible from both
491 networks. For example DID will work fine on both networks.
492 * The command "hostname" will return the name of the default network interface.
493
494 Note: As a result of inserting new functions the DIM shared library entry points have
495 changed, so all DIM Servers/Clients should be relinked (in particular in Linux).
496
497
49820/04/2006
499Changes for version 16.4:
500 - Optimized the DNS for providing the list or running servers dynamically
501 by subscribing to the service "DIS_DNS/SERVER_LIST"
502
503
50407/04/2006
505Changes for version 16.3:
506 - Upgraded to work on LynxOS Version 4.
507 - Updated makefile for INTEL platform
508 - Updated some ifdefs based on the existence of __Lynx__
509
510
51110/03/2006
512Changes for version 16.2:
513 - Increased the listen queue. To avoid "Connection Refused" messages from servers
514 or from the DNS.
515
516
51728/02/2006
518Changes for version 16.1:
519 - Fixed the NO_THREADS option for LINUX, it had stopped working.
520 - DimInfo::getData() could return an invalid pointer if called before connecting
521 to the server (or discovering the server did not exist). Fixed
522 (it now returns 0 in this case).
523
524
52509/11/2005
526Changes for version 16.0:
527 - Consolidated the new timer handling mechanism, should be much more precise.
528 - Fixed the RPC handling. Used to be based on timming assumptions.
529 Now uses a safe protocol to make sure the server is connected before sending
530 an RPC request.
531 - Included in the distribution some performance measurements and a benchmark
532 server and client. Sources in src/benchmark executables in /bin for windows
533 and /linux for linux.
534 Usage:
535 benchServer <message_size_in_bytes> <number_of_services>
536 benchClient
537 benchClient will run for a while and print the measurement results.
538
539Please check the Manual for more information at:
540 http://www.cern.ch/dim
Note: See TracBrowser for help on using the repository browser.