source: trunk/FACT++/dim/README_v19.txt@ 12392

Last change on this file since 12392 was 11881, checked in by tbretz, 13 years ago
Updated to DIM V19r24
File size: 24.6 KB
Line 
1
2 DIM version 19.24 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 1924.
20
2108/08/2011
22Changes for version 19.24:
23 - The funtion DimInfo::getFormat() never return the correct format of a service, if the first time
24 it was called, the service was not available, i.e. when called inside a "no_link" callback - Fixed.
25 - Deleting the last service of a server or stopping a server could generate "Invalid Service Id"
26 messages from the service that updates DID - Fixed.
27
28
2915/07/2011
30Changes for version 19.23:
31 - The new functions:
32 int DimClient::inCallback()
33 int DimServer::inCallback()
34 Can be used to find out if the function is being called in the context of a DIM callback
35 handler (they return 1 if yes, 0 if no).
36 - There was no way to "remove" an errorHandler or exitHandler in C++.
37 Now the following functions accept 0 as parameter:
38 DimClient::addErrorHandler(0)
39 DimServer::addErrorHandler(0)
40 DimServer::addExitHandler(0)
41 DimServer::addClientExitHandler(0)
42 In order to remove them.
43 - The Windows Visual Studio Manifest file distributed since version v19r19 was wrong, so the latest
44 DIM versions did not work on Windows machines without Visual Studio 8 installed - Fixed.
45
46
4721/06/2011
48Changes for version 19.22:
49 - DIM servers would hang when tring to exit due to "Services already declared", if the user
50 exitHandler() didn't directly call exit (instead tried to exit later in the main program).
51 Fixed.
52 - Servers accept now also 'B' or 'V' as format, they are both equivalent to 'C'.
53 - In Linux when a server printed "Write timeout, disconecting from XXX", it didn't always
54 disconnect properly, so the client would not always reconnect afterwards. Fixed.
55
56
5731/05/2011
58Changes for version 19.21:
59 - Fixed a bug in DimRpcInfo: the timer for the timeout was started too late and sometimes the
60 RPC data was received in the meantime, so the timer was never stopped.
61
62
6304/05/2011
64Changes for version 19.20:
65 - Fixed a bug added in v19r18: The <server_name>/SERVICE_LIST was no longer reporting correctly
66 the disappearence of services (by a "-<service_name>" ). Fixed.
67
68
6927/04/2011
70Changes for version 19.19:
71 - Fixed a very very old (horrible) bug in dis.c and dns.c: there was a hardwired malloc(8),
72 which was only ok for 32 bit machines. It's amazing this didn't bring more trouble...
73
74
7507/04/2011
76Changes for version 19.18:
77 - The standard server service <server_name>/SERVICE_LIST had problems reporting the correct
78 information when used by several clients in paralel - fixed.
79
80
8111/03/2011
82Changes for version 19.17:
83 - The TCPIP "listen" backlog for a server was increased for all servers (including the DNS)
84 from 16 to the constant SOMAXCONN (128 on Linux at the moment, 200 on Windows ?)
85 - After a "fork" the DIM initialization sequence guided by semaphores was not correctly
86 handled, this made the forked children hang and not respond to DIM anymore - fixed.
87
88
8923/02/2011
90Changes for version 19.16:
91 - DimServer::stop() did not correctly clear the ServerName - fixed.
92 - The Linux DID now prints the DNS it is connected to in the title bar.
93
94
9520/12/2010
96Changes for version 19.15:
97 - Still fixing dis_stop_serving():
98 - The DNS sometimes gets a remove service message from a server, after the server has
99 closed the connection, this was not handled properly - fixed.
100 - Fixed yet another detail (variable not cleared) in the thread handling at dis_stop_serving().
101 - dtq.c now clears all timer_queues at dis_stop_serving()
102 - Added some protections in case of closed connections.
103
104
10510/12/2010
106Changes for version 19.14:
107 - Still fixing dis_stop_serving():
108 - Adedd pthread_join in linux to wait for threads to die
109 - the following dis_start_serving() would not reconnect to the DNS if the DNS connection
110 was pending (i.e. the DNS was stopped or restarted)
111
112
11306/12/2010
114Changes for version 19.13:
115 - Fixed a few compiler warnings in dis.c
116 - Added #ifndef PXI around some Windows setPriority calls
117 - dis_stop_serving() did not completely clean-up DIM so that another dis_start_serving()
118 could be done properly after for example a "fork()". Fixed.
119
120
12120/09/2010
122Changes for version 19.12:
123 - Fixed a bug added when removing warnings in v19r10 (dis.c and dns.c).
124
125
12607/06/2010
127Changes for version 19.11:
128 - Added some protections in update_service() in order to try to solve a DIP issue.
129 (related to very frequent updates of the same service in different threads)
130 - Added the possibility of defining timeouts for:
131 - DimBrowser::getServices
132 - DimBrowser::getServers
133 - DimBrowser::getServerServices
134 - DimBrowser::getServerClients
135 - Added the possibility of retrieving the time a command arrived:
136 - int dis_get_timestamp(int service_id, int *secs, int *millisecs) in C
137 - int DimCommand::getTimestamp() and int DimCommand::getTimestampMillisecs() in C++
138 - Added a "const" keyword to the "char *format" parameter in the constructors of
139 - DimService and DimCommand
140 - Added a call DimCommand::hasNext(), can be used when commands are queued.
141 - Fixed a memory leak when using DimService::setData and then dynamically deleting the
142 DimService
143
144
14517/02/2010
146Changes for version 19.10:
147 - Fixed a bug in the DNS related to the latest change (browsing for a single service name)
148 The DNS could crash when killing a server.
149 - Removed some compilation warnings
150
151
15204/01/2010
153Changes for version 19.09:
154 - Created two new functions: dis_set_debug_on() and dis_set_debug_off(), these
155 enable or disable printing a message per service update
156 - Tried to protect against:
157 - a service being deleted from the server while it is being updated
158 - a client unsubscribing from a service while it is being updated.
159 - Optimized the DNS when browsing for a service search pattern without wildcards
160 (i.e. browsing for a single service name)
161
162
16313/11/2009
164Changes for version 19.08:
165 - Since version v18r4 where dim_wait() was modified, dim_wait could hang in windows if
166 the wake_up event was triggered before dim_wait was called. Could affect smi++.
167 Fixed.
168 - Fixed a compilation bug in dis.c that affected some platforms.
169
170
17130/10/2009
172Changes for version 19.07:
173 - Some more bugs related to being able to publish to more that one DNS fixed.
174
175
17628/10/2009
177Changes for version 19.06:
178 - When opening DNS connections, when the DNS is not there, from a process that is at the
179 same time a client and a server only one pending connection was used now two separate
180 ones are created.
181 - Tried to fix a few more problems related to dis_stop_serving...
182
183
18426/10/2009
185Changes for version 19.05:
186 - dis_stop_serving had stopped working in version 19.4. So all servers that undeclared
187 all services and then tried to re-declare new ones would fail (corrupted server name).
188 Affected in particular the DimBridge
189
190
19127/08/2009
192Changes for version 19.04:
193 - Added the following functions:
194 Server part:
195 C - dis_get_n_clients(int service_id)
196 C++ - int DimService::getNClients()
197 Client part (C++ only):
198 DimClient::setNoDataCopy()
199 This will prevent any data copy in the client and the user should make
200 sure that the data received from DIM is not used outside the callback
201 in order to benefir from this feature.
202 - Fixed the Java DIM Jar file, it was wrong in the previous version.
203
204
20531/07/2009
206Changes for version 19.03:
207 - Removed some more compilation warnings.
208 - Fixed a bug in the DNS. The mechanism for retrieving the "SERVER_LIST" when
209 some server names were longer that 35 characters was very slow.
210
211
21206/07/2009
213Changes for version 19.02:
214 - Fixed a bug in the server part handling of RPCs, it created a memory leak.
215 It was using a separate thread to handle timeouts and there is no safe way to
216 kill a thread from outside. Fixed.
217 - the function dim_stop_thread() is now obsolete.
218 - Added the possibility to change the send and receive buffer sizes:
219 - int dim_set_write_buffer_size(int size)
220 - int dim_get_write_buffer_size()
221 - int dim_set_read_buffer_size(int size)
222 - int dim_get_read_buffer_size()
223 The default (and minimum) is 16384 bytes.
224 These calls should be done before any other DIM calls.
225 - Fixed a bug in the Java DimBrowser class (the format was not returned correctly)
226
22704/05/2009
228Changes for version 19.01:
229 - A server can now publish to more than one DNS.
230 To use an extra DNS:
231 - in "C":
232 long dnsid;
233 char extra_dns[128];
234 ...
235 dim_get_env_var("EXTRA_DNS_NODE", extra_dns, sizeof(extra_dns));
236 dnsid = dis_add_dns(extra_dns,0);
237 sprintf(name1,"NewService%d",i);
238 dis_add_service_dns(dnsid, name1, "I", &NewData, sizeof(NewData),
239 (void *)0, 0 );
240 dis_start_serving_dns(dnsid, "xx_new");
241
242 - in C++:
243 DimServerDns *newDns;
244 char *extraDns = 0;
245 DimService *new_servint;
246 ...
247 extraDns = DimUtil::getEnvVar("EXTRA_DNS_NODE");
248 if(extraDns)
249 newDns = new DimServerDns(extraDns, 0, "new_TEST");
250 ...
251 if(extraDns)
252 new_servint = new DimService(newDns, "new_TEST/INTVAL",ival);
253
254 - Removed all warnings from DIM sources so that it can be compiled with -Wall -Wextra on Linux
255 - Changed the makefiles so that the default on Linux is now 64 bits.
256 - The flag 32BITS=yes can be added in order to generate 32 bit code
257
258
25926/02/2009
260Changes for version 18.05:
261 - Made the callback for "DIS_DNS/SERVER_LIST" uninterruptible, so that two clients subscribing
262 would not get mixed up answers.
263 - The same for "<server>/SERVICE_LIST"
264 - Tryied to fix a DNS crash, introduced in v18r4 by releasing the connection when "informing clients".
265 - removed some "//" comments in "C"
266
267
26820/02/2009
269Changes for version 18.04:
270 - Changed the dim_wait() mechanism, so that it works for several threads in parallel:
271 - On Linux it was based on POSIX semaphores now it is based on POSIX "condition
272 variables"
273 - On Windows it was based on "Auto Reset Events" now it uses "Manual Resel "Events"
274 - The DNS should now correctly update the "DIS_DNS/SERVER_LIST" service. It used to report
275 a new server, even when the services already existed and the server was killed by the DNS.
276 (And never report it killed). It also didn't report correctly when a server went out of "ERROR"
277 (this is reported as a "+" as for a new server).
278
279
28005/02/2009
281Changes for version 18.03:
282 - The list of registered services in a server could get corrupted in some rare cases
283 making the server crash - fixed.
284 - If the DNS couldn't talk to a client it could sometimes hang - fixed.
285 - Java client modifications:
286 - DimUpdatedInfo was not working correctly - fixed in dim_jni.c.
287 - Implemented DimRpcInfo
288 - Changed the DimBroser class to use DimRpcInfo.
289 - Added a jdim.jar file in the jdim/classes directory of the DIM distribution
290
291
29215/01/2009
293Changes for version 18.02:
294 - Added the following functions:
295 - C++ Client
296 - int DimClient.getServerPid()
297 - Java Client
298 - int DimClient.getServerPid()
299 - String[] DimBrowser.getServers()
300 - String DimBrowser.getServerNode(String server)
301 - int DimBrowser.getServerPid(String server)
302
303
30409/01/2009
305Changes for version 18.01:
306 - Added in the distribution the Visual Studio 8 dlls and manifest. Otherwise
307 it would not work on most PCs.
308
309
31003/12/2008
311Changes for version 18.00:
312 - The Windows execulables and libraries are now built using Visual Studio 8
313 - Some changes added by GSI mainly in the Java Native Interface
314
315
31606/11/2008
317Changes for version 17.12:
318 - Client functionality:
319 - Added a new function dic_stop(), to close anything related to DIM
320 for a client
321 - Added the function dic_get_server_pid(). Similar to dic_get_server().
322 Can be executed in a callback to retrieve the pid of the current server
323 - DimBrowser Class:
324 - DimBrowser::getServices() used to create and destroy the DimRpc connection
325 to the Dns every time it was called. This was heavy if called in a loop.
326 Now the connection is maintained until the DimBrowser itself is destroyed.
327 - A new method DimBrowser::getNextServer(char *&server, char *&node, int *pid)
328 has been created. similar to the previous one but returns also the server pid.
329 - DNS
330 - The DNS was still doing some blocking write calls to servers or clients.
331 Now all write calls have a timeout and can not block forever.
332 - Linux DID
333 - The "Subscribe" button was subscribing to services with update rate of 10 seconds.
334 This was misleading, the users could think the server was calling update_service
335 when it wasn't.
336 Now there are two Subscribe buttons ("on change" or "Update rate of 10 seconds").
337 - DimDridge
338 - Accepts an extra flag "-copy" which provokes an internal copy of the data.
339
340
34108/09/2008
342Changes for version 17.11:
343 - Some DIM Processes, servers or clients could enter a loop taking 100 % CPU
344 time in some rare occasions, fixed.
345 - Added some protections when removing services in the DimBridge.
346
347
34830/08/2008
349Changes for version 17.10:
350 - Some DIM Processes, servers or clients would not reconnect when the DNS was
351 restarted. Fixed two cause:
352 - Some processes in Linux were stuck reading from the DNS socket
353 - Some others "forgot" to set a timer under very special conditions
354 - Changed some of the DNS debug messages to be more explicit.
355
356
35721/07/2008
358Changes for version 17.09:
359 - DIM error messages were not being flushed when the output was redirected
360 to a logfile, fixed.
361
362
36318/07/2008
364Changes for version 17.08:
365 - Sometimes a server or a client could do a read on a sockect that had just
366 been closed which left them hanging forever - fixed.
367
368
36901/07/2008
370Changes for version 17.07:
371 - The DimTimer was sometimes not started when the constructor was called
372 with a time argument.
373 - Clients could not connect to more than 1024 servers - fixed.
374 (if the machine allows more than 1024 connections)
375
376
37730/06/2008
378Changes for version 17.06:
379 - Corrected the makefile for Darwin, now the number of accepted connections is
380 increased to 8192 only for Linux.
381 - Fixed a bug in the DimTimer, it used to accept to be re-started, but then crashed
382 at destruction time if not stopped the same number of times. Now it can not be
383 re-started.
384 - The Dns used to ask servers to re-register at regular intervals when they were not
385 sending their watchdog messages (i.e. they were in "ERROR", red in DID). Now the
386 DNS only asks once (unless they answer). This could cause the DNS to hang if
387 servers were in ERROR for a long time.
388 - The Dns now accepts a command line parameter: -d to print debug messages.
389 - The clients were not handling properly the case when they could contact the DNS
390 but then they could not contact the server that the DNS gave them (either because
391 of a firewall or because the server run on an inaccessible network). In this case
392 the clients would timeout trying to contact the server for each service and kept
393 asking the DNS the server coordinates over and over again. Now the clients keep
394 a list on unreacheable servers, so they don't try to contact the server for each
395 service and only ask the DNS again with an increasing interval that goes from 10
396 seconds to 2 minutes maximum.
397 - The server now issues an error message if the format string is too long.
398 - Linux DID
399 - Removed the command "Kill ALL Servers", it was too dangerous
400 - Now the list of nodes in "View Servers by Node" is in alphabetical order and
401 in lowercase.
402
403
40430/04/2008
405Changes for version 17.05:
406 - In Linux in some cases a SIGPIPE was generated. Normally the DIM library sets
407 the behaviour of SIGPIPE to ignored, but if another library or main program
408 changes the SIGPIPE behaviour, then the application could exit when the SIGPIPE
409 was generated. Fixed - on Linux now the function send with flag MSG_NOSIGNAL
410 is used in oder to avoid generating SIGPIPE.
411
412
413
4144/04/2008
415Changes for version 17.04:
416 - Sometimes processes (servers or clients) would hang when the DNS was restarted.
417 This was due to a strange (Windows?) feature, by which a connect could succeed
418 after a connection was closed (and reported) on the other side. Fixed.
419
420
421
42227/03/2008
423Changes for version 17.03:
424 - Can now make DID for 64 bits by making DIM using:
425 gmake X64=yes all
426 - Increased the size of the Hash tables for the servers and the DNS.
427
428
429
43020/02/2008
431Changes for version 17.02:
432 - Fixed the Java DimTimer - stop() didn't work
433 Required changing dim_jni.c as well as the java part
434 - Fixed DIM for Darwin - had stopped working
435
436
437
43820/01/2008
439Changes for version 17.01:
440 - The Java API now works on 64 bit machines, Thanks to Joern Adamczewski.
441 Please use:
442 gmake JDIM=yes all
443 - Linux executables are now compiled/linked on slc4 (32 bits).
444 - Big changes in the DimRpcs both client and server part. Tere were bugs
445 related to the handling of timeouts.
446 Unfortunatelly all applications using RPCs need to be re-linked.
447
448
449
450-----------------------------------------------------------------------------------------
451Previous version history:
452
45307/12/2007
454Changes for version 16.14:
455 - Now by default All DIM processes are ready to accept up to 8192 connections, both
456 in Linux and Windows. Although in Linux for this to be effective the machine system
457 limits must allow more than 1024 descriptors/open files per process.
458 - Fixed a little memory leak in tokenstring.cxx
459 - And a little compilation bug for some platforms in tcpip.c
460
461
46215/05/2007
463Changes for version 16.13:
464 - If DIM_HOST_NODE is defined when starting up a server, a DIM client will now try
465 two network interfaces in order to talk to that server and only give up if they both
466 fail. First it will try the ip name or ip address specified by the server using
467 DIM_HOST_NODE, if that fails it will try the ip address of the default interface
468 retrieved by the server using gethostname (and gethostbyname).
469 The changes basically affect the case in which the DIM_HOST_NODE given to the servers
470 is specified as IP address instad of an IP name. Otherwise this mechanism was already
471 working.
472
473
4743/05/2007
475Changes for version 16.12:
476 - The Java version did not exit properly when main() terminated - fixed.
477
478
47925/04/2007
480Changes for version 16.11:
481 - On Linux the timeout to detect a lost connections (unplugged ethernet cable
482 or machine reboot) was too long, around 15 minutes - Fixed.
483 On Linux the KEEPALIVE feature is now used instead of a regular socket write,
484 all other platforms should work as before.
485
486
48721/02/2007
488Changes for version 16.10:
489 - Found a bug in dis_stop_serving: one socket connection was not closed - fixed.
490 - Implemented a new environment variable for the DNS: DIM_DNS_ACCEPTED_NODES
491 Can receive a list on nodes or domains separated by commas.
492 If the DNS receives a connection from a node not in this list, it will
493 reject it and kill the server or client requesting it.
494 - Fixed some C++ warnings.
495
496
49719/01/2007
498Changes for version 16.9:
499 - The modifications done in version 16.8 have introduced a bug:
500 - DIM servers would not behave properly (exit) when receiving a kill command
501 from the DNS (for duplicated services, not allowed host names or manual "kill")
502 This is now fixed.
503
504
50530/10/2006
506Changes for version 16.8:
507 - Modified dis_stop_serving() and DimServer::stop() to completely stop DIM:
508 - Stop also the DIM threads.
509 - Release all allocated memory
510 - Allow a different port number when re-starting.
511
512
51311/07/2006
514Changes for version 16.7:
515 - Prepared for increasing the number of open connections per process
516 (On Linux still requires changing some parameters and recompiling the Dns)
517 - Fixed one error and several warnings for gcc 4.
518
519
52011/05/2006
521Changes for version 16.6:
522 - Sometimes a server or client would crash while exiting if the DNS was not running.
523 Fixed.
524 - Fixed the reporting of some ERROR messages on Windows (used to report error "0")
525 - Allowed dim_send_command to receive instead of -dns <node_name>
526 -dns <node_name>[:<port_number>]
527
528
52901/05/2006
530Changes for version 16.5:
531 - Big Spring Cleanup. Removed most warnings. Can now be compiled on
532 Windows with Warning Level 3 and on Linux with -Wall
533 (still not working for -ansi -pedantic...)
534 - When trying to access a server in a different network (i.e. not reacheable)
535 a client (for example DID) would take very very long to timeout - fixed.
536 - Added two new sets of functions that allow setting the DIM_DNS_NODE separately
537 for a server and a client in the same process:
538 - int dis_set_dns_node(char *node)
539 - int dis_get_dns_node(char *node)
540 - int dis_set_dns_port(int port)
541 - int dis_get_dns_port()
542
543 - int dic_set_dns_node(char *node)
544 - int dic_get_dns_node(char *node)
545 - int dic_set_dns_port(int port)
546 - int dic_get_dns_port()
547 These routines should be used instead of the equivalent ones starting with "dim_"
548 since these set the same DIM_DNS_NODE/port for both Server and client parts of a
549 process.
550 - Adapted the C++ equivalents (DimClient::setDnsNode, etc. and DimServer::setDnsNode,
551 etc.) to use the new routines, so they are now independent.
552 Adapted also the Java equivalents.
553 - Fixed DimBridge to use the new routines.
554 - Fixed a bug in DID that made it crash sometimes at startup (and also when the DNS
555 restarted)!
556 - Found some very interesting features of DIM:
557 - In a node with two ethernet interfaces (so connected to two networks):
558 - The DNS will answer to servers and client on both networks, only its server
559 part - DIS_DNS (the one that answers to DID and DimBrowser requests) would
560 in principle answer only to one of the networks (in principle the default
561 interface* but can be changed by setting the environment variable "DIM_HOST_NODE").
562 - But, in fact, if the DNS or any server is started with the environment variable
563 DIM_HOST_NODE set to the interface that is not the default* one. Than both the
564 DNS (including the server part) and the DIM servers will be accessible from both
565 networks. For example DID will work fine on both networks.
566 * The command "hostname" will return the name of the default network interface.
567
568 Note: As a result of inserting new functions the DIM shared library entry points have
569 changed, so all DIM Servers/Clients should be relinked (in particular in Linux).
570
571
57220/04/2006
573Changes for version 16.4:
574 - Optimized the DNS for providing the list or running servers dynamically
575 by subscribing to the service "DIS_DNS/SERVER_LIST"
576
577
57807/04/2006
579Changes for version 16.3:
580 - Upgraded to work on LynxOS Version 4.
581 - Updated makefile for INTEL platform
582 - Updated some ifdefs based on the existence of __Lynx__
583
584
58510/03/2006
586Changes for version 16.2:
587 - Increased the listen queue. To avoid "Connection Refused" messages from servers
588 or from the DNS.
589
590
59128/02/2006
592Changes for version 16.1:
593 - Fixed the NO_THREADS option for LINUX, it had stopped working.
594 - DimInfo::getData() could return an invalid pointer if called before connecting
595 to the server (or discovering the server did not exist). Fixed
596 (it now returns 0 in this case).
597
598
59909/11/2005
600Changes for version 16.0:
601 - Consolidated the new timer handling mechanism, should be much more precise.
602 - Fixed the RPC handling. Used to be based on timming assumptions.
603 Now uses a safe protocol to make sure the server is connected before sending
604 an RPC request.
605 - Included in the distribution some performance measurements and a benchmark
606 server and client. Sources in src/benchmark executables in /bin for windows
607 and /linux for linux.
608 Usage:
609 benchServer <message_size_in_bytes> <number_of_services>
610 benchClient
611 benchClient will run for a while and print the measurement results.
612
613Please check the Manual for more information at:
614 http://www.cern.ch/dim
Note: See TracBrowser for help on using the repository browser.