File: README

package info (click to toggle)
tango 9.3.4%2Bdfsg1-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 95,792 kB
  • sloc: cpp: 138,382; sh: 8,009; ansic: 1,083; makefile: 996; java: 800; python: 264; xml: 54
file content (913 lines) | stat: -rw-r--r-- 35,418 bytes parent folder | download | duplicates (2)
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
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
		TANGO source code release version 9.3.4 - README (5/2020)
		==========================================================



TABLE OF CONTENTS
-----------------

 1 - Introduction
 2 - What's inside
 3 - Prerequisites
 4 - Installing
 5 - Compiling
 6 - Running
 7 - Updating from previous Tango releases
 8 - Documentation
 9 - Remarks
10 - Questions
11 - URL
12 - Changes


1 - INTRODUCTION
----------------
This is the README for the TANGO source code release. TANGO is a
toolkit for building object oriented control systems based on CORBA ans ZMQ. 
TANGO is a joint effort of the several European research institutes.

This source code release is based on the latest version of TANGO 9 (9.3.4)
and is intended for Unix platforms. A binary version for Windows of TANGO 
is available. The source code contained in this package 
runs on Windows but the Makefile don't.

Tango 9 and above is compliant to the 64 bit architecture.

This package is foreseen (and was tested) to run with :
- omniORB4.2.1 patched (even if it should work as well with omniORB 4.1.6, 4.1.7, 4.2.0, 4.2.2, 4.2.3)
- zmq 4.0.5 (it should work with more recent zmq versions too)
- Java 1.8

The default Pogo application in this package can generate source code
for C++, Python and Java device servers.

The database server delivered with this package do not force the database
user to be root. You have to use the my.cnf configuration files
or the MYSQL_USER and MYSQL_PASSWORD environment variables to specify
the database account to be used by the database server.

The TangoTest device server delivered with this package is an example 
implementation of all possible Tango data types. 
The displayed data is animated what creates some CPU load 
when running the server. Starting an atkpanel (generic Tango client)
on a device of this server is CPU and memory consuming, because
all possible data are read and displayed.

In the case of upgrading an alreay running Tango system, please follow
the instructions in the chapter UPGRADING FROM PREVIOUS TANGO RELEASES.


2 - WHAT'S INSIDE
-----------------

This source code release contains :

(1) Tango C++ library source files and java library and application jar files

(2) The Tango database device server source files.

(3) The Jive application. 

(4) The Astor application and its associated Starter device server source files.

(5) The Pogo application.

(6) The tg_devtest application

(7) A test device server called TangoTest with its source files

(8) The atk graphical toolkit for writing tango applications in java

(9) The atkpanel application as a generic test client

(10 The atktuning application for tuning attributes in a device

(11) The logviewer application for visualising logging messages

(12) The DeviceTree application to display tango device attribute and/or command

(13) The atkmoni application to monitor scalar attribute values in time

(14) The jdraw synoptic editor to create synoptic applications

(15) The synopticAppli to run and test synoptics created with jdraw

(16) The Tango controlled access device server source file
     It is used if you want to run Tango with its controlled access feature
     
(17) A Tango Rest server implementation

The Jive application is a Tango database browsing tool written in Java. It also
allows device testing. Its documentation is at

	https://jive.readthedocs.io
	
The Astor application is also a Java application. With the help of the Tango
starter device server, it allows full remote Tango control system administration.
Its documentation is at :

	https://tango-controls.readthedocs.io/en/latest/tools-and-extensions/built-in/astor/index.html
	
The Pogo application is a graphical Tango device server code generator.
Its documentation is at :

	https://tango-controls.github.io/pogo
	
tg_devtest is a device testing application for device server. 
It is a sub-part of Jive. 

3 - PREREQUISITES
-----------------

Before compiling and installing TANGO you need to install :

(1) omniORB available from http://sourceforge.net/projects/omniorb 
    (Preferably version 4.2.2 or 4.2.3 but older versions 
    4.2.1/4.2.0/4.1.7/4.1.6 are fine). 
    A patch is necessary for versions 4.2.0 and 4.2.1.
    Please refer to:
    https://tango-controls.readthedocs.io/en/latest/installation/patches.html#version-9-3-3-and-9-2-5-source-patches
    to get the patch and informations on how to apply it.
	 OmniORB is mandatory to build the Tango libraries and the delivered Tango 
	 device servers.

(2) zmq available from http://www.zeromq.org (version >= 4.0.5).
	 Zmq is mandatory to build the Tango libraries and the delivered Tango 
	 device servers.

(3) mysql available from http://mysql.org (version >= 5.5) or MariaDB from https://mariadb.org (version >= 10.0)
	One of these two databases is mandatory to install a Tango database. The default database is still mysql.
    If you want to use MariaDB, use the --enable-mariadb configure option.
	     
(4) doxygen available from http://www.doxygen.org

    Remark : doxygen is not mandatory to run Tango. It is just used by our code
             generator (called Pogo) to automatically generate some parts of 
	     the Tango device server documentation. If you don't install it,
	     this part of the documentation will simply not be generated.
	     But in all cases, some HTML pages documenting Tango device server
	     will allways be generated.

Also check the tools you are using

(1) If you are using gcc, you need to have gcc release 3.2.0 or above. You can
    download gcc from http://gcc/gnu.org

(2) Only java release 1.8.0 or above is supported, you can download java from
    http://java.sun.com/j2se.
	Java is mandatory to install and run Tango tools like Pogo, Astor and Jive for instance.


4 - INSTALLING
--------------

Once you have installed the packages in prerequisites you can think
about configuring and compiling TANGO. 

To configure TANGO you need to tell it where to find omniORB, ZMQ and
mysql (if it is in a non-standard place) and where to install
TANGO.

The main options for configure are:
--prefix=PREFIX         install architecture-independent files in PREFIX
                        [/usr/local]
--enable-static[=PKGS]
                        build static libraries [default=no]
--enable-mariadb		MariaDb database instead of mysql. 
						Build database server using mariadb instead of mysql

--disable-java          disable installation of Java applications
--disable-dbserver      disable installation of Tango database server.
--disable-dbcreate      enable an creation of the Tango database schema
--disable-jpegmmx		disable jpeg mmx optimization
  
--with-java             path to java interpreter
--with-doxygen          path to doxygen utility
--with-lyx				path to LyX utility
--with-zlib=DIR         root directory path of zlib installation defaults to
                        /usr/local or /usr if not found in /usr/local
--with-omni             prefix to omniORB installation (default: $OMNI_ROOT)
--with-zmq				prefix to ZMQLIB installation

--with-tango-db-name	Name of the database created in mysql (default: tango)
--with-tango-rc-file	Location/name of the tango rc file (default: /etc/tangorc)

--with-mysqlclient-prefix=PFX
                        Prefix where mysqlclient is installed
--with-mysqlclient-include=DIR
                        Directory pointing to mysqlclient include files
--with-mysqlclient-lib=LIB
                        Directory pointing to mysqlclient library (Note:
                        -include and -lib do override paths found with
                        -prefix)

--with-mysql-ho         the host of the database (mysql or mariadb) (default: <blank>)
--with-mysql-admin      super user of your database (mysql or mariadb) (default: <blank>)
--with-mysql-admin-passwd
                        super user password of your database (mysql or mariadb) (default:
                        <blank>)

						  --with-mariadbclient-prefix=PFX
                          Prefix where mariadbclient is installed
--with-mariadbclient-include=DIR
                        Directory pointing to mariadbclient include files
--with-mariadbclient-lib=LIB
                        Directory pointing to mariadbclient library (Note:
                        -include and -lib do override paths found with
                        -prefix)
		
The last three options can be replaced with a .my.cnf file in your home 
directory with the following content:

			[client]
			user      = [db login name]
            password  = [password]
			host      = [host name]

At the end of the configure script, a status is displayed indicating pathes
and versions of found software and the parts of the Tango package which are
ready to be installed.
Example (using mysql):								
        
		Source code location:   ../..
        Version:                9.3.4
        Compiler:               gcc,g++

        OMNIORB PATH:           /segfs/tango/ORB/omniORB4.2.1/ubuntu1404
        OMNIORB VERSION:        "4.2.1"

        ZMQ PATH:               /segfs/tango/transport/zmq4.0.5/ubuntu1404
        ZMQ VERSION:            4.0.5

        JAVA PATH:              /usr/bin/java
        JAVA VERSION:           1.8.0_222

        MYSQL CLIENT LIB:       -L/usr/local/mysql/lib/mysql -lmysqlclient
        MYSQL VERSION:          5.7.13
        MYSQL CONNECTION:       OK

build:
        libraries:              yes
        java application:       yes
		event java interface:   yes
		access control server:	yes
        database server:        yes
        database schema create: yes


Hints to configure:

The Tango database server
-------------------------
To disable the compilation and installation of the database server, 
use --disable-dbserver. 

Create the Tango database
-------------------------
To allow the configure script to create the Tango database in
your database, make sure that the mysql version is > 5.5 (or 10.0 for mariadb) and
the mysqld is running before doing configure.
Also check that the mysql client (called mysql) is in your path.

If you are not running the configure script on the same host
where the mysql server is running, use the "--with-mysql-ho" configure
option or the host entry in the my.cnf file. 

The configure script will try to connect to the
database. Make sure that privileges are granted to
the user used by configure running on the host where you
run configure. 

The configure options "--with-mysql-admin" and "--with-mysql-admin-passwd"
allow you to select which database user configure will use.
You can also use the user and password entries of the my.cnf file
to set-up your connection to the database.

Note: It is recommended to setup the database to use latin1 character set.
Especially, any other character set with characters longer than 3 bytes
will not work. Character set can be specified in my.cnf configuration file:

[mysqld]
character_set_server=latin1
collation_server=latin1_swedish_ci

To disable any access to the database use the --disable-dbcreate option.

Database server, mysql and libz
-------------------------------
Depending on how MySql has been installed, the Tango database
server may need the compress/uncompress library (called "libz").
By default, configure try to find this compress/uncompress stuff.
If you don't need it, use the configure "--without-zlib".								  

Java applications
-----------------
Tango arrives with many Java applications. Each java applications has
its own script (in $prefix/bin) where the CLASSPATH is set before 
starting the java interpreter. These scripts will be modified by the
configure script to set a correct path to the java interpreter found in
your PATH when configure was run. You can also use the "--with-java=xxx"
to define a path to the java interpreter.

It is not mandatory to find the java interpreter in your PATH. You can use 
the "--disable-java" configure option to build Tango. 
When java was not found, disabled, or found with an unsufficient version, 
the installation of the java applications is disabled.

doxygen
-------
Doxygen is a documentation generator from C++ source files. It is used by the
Tango code generator (called Pogo) to generate Tango device server documentation.
The script used to start Pogo will be modified by the configure script to set
a correct path to the doxygen command found in your PATH when configure was
run. You can also used the "--with-doxygen=xxx" to define a path to the
doxygen command.
It is not mandatory to find the doxygen command in your PATH or to use the
"--with-doxygen" configure option to build and run Tango. This will only prevent
some part of Tango device server documentation to be generated by Pogo.


You can type "configure --help" to get a print of all the options
supported by the configure script.

Here is an example of running configure for TANGO telling it where
to install (--prefix) TANGO and where omniORB and ZMQ are installed:

cd $directory_where_tango_has_been_installed
mkdir build
cd build
export CC=gcc
export CXX=g++
../configure --prefix=/home/tango/release/install_dir_linux \
	--with-omni=/segfs/tango/ORB/omniORB4.2.1/ubuntu1404 \
    --with-zmq=/segfs/tango/transport/zmq4.0.5/ubuntu1404

	
During the configure procedure the access to the database is tested. Please prepare
your my.cnf (database configuration file) or use the configure options
               --with-mysql-admin
               --with-mysql-admin-passwd
               --with-mysql-ho
to specify the access to the database.
	

5 - COMPILING
-------------

Once configure has run successfully you can compile and install the
executables, include files, libraries and scripts. Do this by typing :

make all

make install

If you get some compilation errors like:
error: cannot convert ‘zmq::socket_t’ to ‘void*’ in assignment
this is due to an incompatible zmq.hpp file (probably provided with your Linux distribution).
As a work-around, you will need to install cppzmq via:

git clone https://github.com/zeromq/cppzmq
cd cppzmq
mkdir build
cd build
cmake -DENABLE_DRAFTS=OFF -DCPPZMQ_BUILD_TESTS=OFF ..
sudo make install

and recompile Tango again.

6 - RUNNING
-----------

To test wether the TANGO build worked do the following :

(1) start the database on port 10000 by typing :

    TANGO_INSTALL_DIR/bin/DataBaseds 2 -ORBendPoint giop:tcp::10000
    
	 Specify the database account to be used by the database server.
	 Two possibilities are available:
	 	- set the following environment variables to the account and 
		  password to be used
    
			MYSQL_USER to specify the database login name
			MYSQL_PASSWORD to specify the password
			MYSQL_HOST if required
			  
		- configure the database client with the database configuration 
		  file my.cnf
		  		
			[client]
			user      = [database login name]
            password  = [password]

(2) Configure the TANGO_HOST environment variable with the hostname the
    database server is running on and the port number used.

    setenv TANGO_HOST hostname:10000

(3) start the test device server tangoTest :

    TANGO_INSTALL_DIR/bin/TangoTest test

(4) start jive by typing for example :

    TANGO_INSTALL_DIR/bin/jive
    
    (See chapter 4 java sub-chapter to check the jive script) 

(5) test your device using the test device in jive

(6) write new device servers using pogo :

    TANGO_INSTALL_DIR/bin/pogo

    (See chapter 4 java sub-chapter to check the pogo script) 


7 - UPDATING FROM PREVIOUS TANGO RELEASES
-----------------------------------------

WARNINGS:

To update the Tango database, the distribution provides some scripts.
The "make install" command will create these database related scripts in
<install_dir>/share/tango/db ONLY if the database connection test
done at configure time is successfull ("database schema create" reported
as yes at the end of the configure script execution)


7-1 - UPDATING FROM A TANGO 9.2.5 DATABASE
--------------------------------------

Tango 9.3.4 includes an update of the database:
(1) new DServer always allowed command: EventConfirmSubscription,
(2) new entry for TangoRestServer in device table.

To update your database, follow these instructions:

a - Stop your control system and your database server(s)

b - Backup your database (Recommended, not mandatory)

c - Cd to the <install_dir>/share/tango/db directory

d - Run the update script:
	mysql -u[user] -p[password] < ./update_db_from_9.2.5_to_9.3.4.sql

e - Restart your database server(s)


7-2 - UPDATING FROM A TANGO 9 (< 9.2.5) DATABASE
--------------------------------------

Tango 9.3.4 includes an update of the database:
(1) new DServer always allowed command: EventConfirmSubscription,
(2) new entry for TangoRestServer in device table.
(3) update of the stored procedure (release 1.13).

To update your database, follow these instructions:

a - Stop your control system and your database server(s)

b - Backup your database (Recommended, not mandatory)

c - Cd to the <install_dir>/share/tango/db directory

d - Run the update script to update the stored procedure:
	./update_db.sh
	
e - Run the update script for the new entries (1) and (2) in the DB:
	mysql -u[user] -p[password] < ./update_db_from_9.2.5_to_9.3.4.sql
	
f - Restart your database server(s)

7-3 - UPDATING FROM A TANGO 8 DATABASE
--------------------------------------

Tango 9.3.4 includes an update of the database:
(1) new DServer always allowed command: EventConfirmSubscription.
(2) new entry for TangoRestServer in device table.
(3) update of the stored procedure (release 1.13).
(4) some new commands in the list of allowed commands for the Database class (for Tango Access Control system)
(5) some new tables related to the new pipe feature.

To update your database, follow these instructions:

a - Stop your control system and your database server(s)

b - Backup your database (Recommended, not mandatory)

c - Cd to the <install_dir>/share/tango/db directory

d - Run the update script:
	mysql -u[user] -p[password] < ./update_db_from_8_to_9.3.4.sql
	
e - Restart your database server(s)


7-4 - UPDATING FROM A TANGO 7 DATABASE
--------------------------------------

Tango 9.3.3 includes an update of the database:
(1) new DServer always allowed command: EventConfirmSubscription.
(2) new entry for TangoRestServer in device table.
(3) update of the stored procedure (release 1.13).
(4) some new commands in the list of allowed commands for the Database class (for Tango Access Control system)
(5) some new tables related to the new pipe feature.

To update your database, follow these instructions:

a - Stop your control system and your database server(s)

b - Backup your database (Recommended, not mandatory)

c - Cd to the <install_dir>/share/tango/db directory

d - Run the update script:
	mysql -u[user] -p[password] < ./update_db_from_7_to_9.3.4.sql
	
e - Restart your database server(s)


8 - DOCUMENTATION
-----------------

The full documentation for Tango is available at https://tango-controls.readthedocs.io
If Tango is properly installed at your site, a copy of the documentation should be available in
<install_prefix>/share/doc/tango
You can also look at the Tango web site at https://www.tango-controls.org

Sphinx is used to generate the tango documentation html pages.
Nevertheless, if you want to re-generate the documentation, you can use 
the command "make html" in doc/src directory.
This requires Sphinx and IPython to be installed on your host.
On a Debian-like system, you can install these tools using the following 
commands:
sudo apt install -y python python-pip
pip install sphinx ipython

9 - REMARKS
-----------

TANGO 9.0:
Tango 9.0 is a major release. Recompiling a device server with Tango 8.0 
means recompiling ALL classes of the device server. You need to work with
coherent include files.

TANGO 8.0:
Tango 8.0 is a major release. Recompiling a device server with Tango 8.0 
means recompiling ALL classes of the device server. You need to work with
coherent include files.

TANGO 7.0:
Tango 7.0 is a major release. Recompiling a device server with Tango 7.0 
means recompiling ALL classes of the device server. You need to work with
coherent include files.

TANGO 6.1:
The database server in this package uses stored procedures. To make it reliably 
work the MySQL version must be >5.0.
To exploit the full performance of the new database server, on an already 
installed Tango system, the the chapter UPDATING FROM PREVIOUS TANGO RELEASES.

TANGO 6.0:
Tango 6.0 is a major release, because it uses omniORB 4.1 which is
a major release of omniORB. The code generated from the with the IDL
compiler is not compatible with the code gernerated with omniORB 4.0.x!
To avoid any confusion with new and old libraries we decided to
make also a major Tango release.

Recompiling a device server with Tango 6.0 and omniORB 4.1 means 
recompiling ALL classes of the device server. You need to work with
coherent include files.


10 - QUESTIONS
--------------

You will definitely have some ! Send questions to info@tango-controls.org or on the 
forum: http://www.tango-controls.org/community/forum

11 - URL
--------

Visit the TANGO website http://www.tango-controls.org for online 
documentation, news and to download add-on packages.


12 - CHANGES
------------

See the file TANGO_CHANGES to get an overview of all modification
between the different Tango library versions.

Changes between Tango distribution 9.2.5a and 9.3.4
--------------------------------------------------

- Updated C++ library to                        Release 9.3.4
- Updated JTango to                             Release 9.5.18
- Updated Jive to                               Release 7.23
- Updated ATK to                                Release 9.3.14
- Updated AtkPanel to                           Release 5.8
- Updated atktuning to                          Release 4.7
- Updated Astor to                              Release 7.2.10
- Added dbbench                                 Release 1.3
- Updated JSSHTerminal to                       Release 1.16
- Updated LogViewer to                          Release 2.0.5
- Updated Pogo to                               Release 9.6.27
- Added rest-server                             Release 1.17
- Updated TangoTest to                          Release 2.1
- Updated TangoDatabase to                      Release 5.14
- Updated TangoAccessControl to                 Release 2.14
- Updated Starter to                            Release 7.3
- Updated tango_admin to                        Release 1.15
- Removed Pogo 6

Changes between Tango distribution 9.2.5 and 9.2.5a
--------------------------------------------------

- Updated Jive to                               Release 7.10
- Updated JSSHTerminal to                       Release 1.10
- Updated Astor to                              Release 7.0.9
- Added DBBench                                 Release 1.3

Changes between Tango distribution 9.2.2 and 9.2.5
--------------------------------------------------

- Updated C++ library to						Release 9.2.5
- Updated Jive to								Release 7.8
- Updated atkpanel to							Release 5.5
- Updated Pogo to								Release 9.4.5
- Updated DbServer to							Release 5.6 (stored procedure release 1.13)
- Updated JTango to								Release 9.1.2
- Updated ATK to 								Release 9.1.22
- Updated Astor to								Release 7.0.7
- Updated Starter to							Release 6.9
- Updated LogViewer to							Release 2.0.4
- Updated TangoAccessControl to					Release 2.13

Changes between Tango distribution 9.1.0 and 9.2.2
--------------------------------------------------

- Updated C++ library to						Release 9.2.2
- Updated Jive to								Release 6.9
- Updated atkpanel to							Release 5.4
- Updated Pogo to								Release 9.2.4
- Updated DbServer to							Release 5.4 (stored procedure release 1.11)
- Updated JTango to								Release 9.0.7
- Updated ATK to 								Release 9.1.13
- Updated Astor to								Release 6.7.0
- Updated Starter to							Release 6.8
- Updated TangoTest to							Release 2.1
- Updated TangoAccessControl to					Release 2.12

- SourceForge bug 755 : DBserver and TAC : Passing database name at run time
- SourceForge bug 762 : TangoTest : SegFault writing to long_spectrum attribute
- SourceForge bug 763 : DBserver : NULL insertion in NOT NULL columns
- SourceForge bug 766 : Starter : memory leak
- SourceForge bug 772 : Makefile dependencies to prevent unnecessary rebuilt
- SourceForge bug 778 : tango.opt defines wrong LDFLAGS
- SourceForge bug 782 : Bug in common_target.opt file

- TangoTest : Memory not freed in delete_device() method
- DBserver : Add command DbGetForwardedAttributeForDevice
- DBserver : Change default value for accessed columns in 2 tables
- DBserver : Change variable data type in Stored procedure


Changes between Tango distribution 8.1.2 and 9.1.0
--------------------------------------------------

- Updated C++ library to						Release 9.1.0
- Updated Log4Tango to 							Release 5.0.1
- Updated Jive to								Release 6.7
- Updated atkpanel to							Release 5.2
- Updated Pogo to								Release 9.1.7
- Updated Astor to								Release 6.6.6
- Updated DbServer to							Release 5.2
- Replacing TangORB with JTango					Release 9.0.5
- Updated ATK to 								Release 9.1.3
- Updated LogViewer to						    Release 2.0.1
- Updated Starter to							Release 6.6
- Updated TangoTest to							Release 2.0
- Updated TangoAccessControl to					Release 2.11
- Updated tango_admin to						Release 1.13
- Updated AccessControl abstract class to		Release 2.7

- notifd2db removed from distribution
- jzmq removed from distribution
- removed notify_daemon script

- SourceForge bug 661: DbServer : Wrong initialization of device table int and date columns (created_db script)
- SourceForge bug 669: Jive : File written with escaped " character
- SourceForge bug 670: TangoTest : Crash with value < 1 given to attribute float_scalar
- SourceForge bug 671: DbServer : Attribute alias not deleted during delete_device
- SourceForge bug 713: DbServer : History ID on 64 bits value
- DbServer: Characters / and " " forbidden in alias name
- DbServer: Small memory leak in DbGetInstanceNameList command
- DbServer: Memory leak when trying to get event from it
- DbServer: Change the way memorized attribute property (__value) is managed
- DbServer: Remove history memorization for memorized attribute (including already stored history)
- DbServer: Replace NULL insertion in not null table colums by actual date (now())
- Tango_admin: Add options --server-list and --server-instance-list (FR 99)
- Distribution: Doc images source files (.fig) added to distribution
- Distribution: Idl file compiled during the package compilation 


Changes between Tango distribution 8.0.5 and 8.1.2
---------------------------------------------------

- Updated C++ library to						Release 8.1.2
- Updated Log4Tango to 							Release 4.0.8
- Updated Jive to								Release 4.31
- Updated atkpanel to							Release 4.8
- Updated Pogo to								Release 8.1.14
- Updated Astor to								Release 6.3.6
- Updated DbServer to							Release 4.23
- Updated TangORB to							Release 8.3.0
- Updated ATK to 								Release 4.5.3
- Updated Starter to							Release 5.12
- Updated TangoTest to							Release 1.9
- Updated TangoAccessControl to					Release 2.9
- Updated DeviceTree to							Release 1.9.6
- Updated notifd2db to							Release 1.14
- Updated tango_admin to						Release 1.11
- Updated AccessControl abstract class to		Release 2.6

- SourceForge bug 88  (1497526) - Updating property with character \
- SourceForge bug 520 (3543407) - Bug in DbGetDeviceAttributeProperty2
- SourceForge bug 525 (3559224) - Missing -lzmq for libtango
- SourceForge bug 555 - Not possible to launch atkpanel from Jdraw

- New attribute alias related commands in Database server
- New DbRenameServer command in database server
- The DbDeleteServer command now also delete device properties
- Improvement in TAC device filter (sr/v-*/* allowed)
- Add jzmq in source distribution
- "make pdf" command now generates the Tango book with a new
  --with-lyx configure command line option


Changes between Tango distribution 7.2.6a and 8.0.5
---------------------------------------------------

- Updated C++ library to						Release 8.0.5
- Updated Log4Tango to 							Release 4.0.7
- Updated Jive to								Release 4.24
- Updated atkpanel to							Release 4.5
- Updated Pogo to								Release 8.0.7
- Updated Astor to								Release 6.0.4
- Updated notifd2db to							Release 1.13
- Updated tango_admin to 						Release 1.10
- Updated DbServer to							Release 4.17
- Updated TangORB to							Release 8.0.0 
- Updated ATK to 								Release 4.3.9
- Updated Starter to							Release 5.5
- Updated TangoTest to							Release 1.7.0
- Updated TangoAccessControl to					Release 2.5
- Updated AccessControl to						Release 2.5

- SourceForge bug 3308848: Fix build on kfreebsd system
- SourceForge bug 3383197: Jpeg mmx option to configure
- SourceForge bug 3409434: Memory leaks in Database server
- SourceForge bug 3515206: Bug in PutServerInfo command (Database server)

- Add command DbGetCSDbServerList to database server
- The database server now unregister itself from database when it is killed
- Add 3 db commands (DbImportEvent, DbGetDeviceAlias and DbGetCSDbServerList) in allowed command list (For TAC)
- The database server and TAC server supports a MYSQL_HOST environment variable
- Add messages around MySQL connection in database server (to ease debugging)
- New and faster algorithm in database command DbGetDeviceAttributeProperty2
- Fix two bugs in database stored procedure (release 1.8)
- Try to prevent SQL injection in command DbMySqlSelect
- All database class commands now have their arguments description field initialized
- Database server, TAC server and Tango Test are now compiled with Debian hardenning flags

Changes between Tango distribution 7.2.1 and 7.2.6a
---------------------------------------------------

- SourceForge bug 3312284: Could not start jive, astor,...

Changes between Tango distribution 7.2.1 and 7.2.6
---------------------------------------------------

- Updated C++ library to						Release 7.2.6
- Updated Jive to								Release 4.19
- Updated LogViewer	to							Release 1.2.3
- Updated Pogo to								Release 7.2.1
- Updated Astor to							    Release 5.4.1
- Updated notifd2db to							Release 1.12
- Updated tango_admin to 						Release 1.8
- Updated DbServer to							Release 4.12
- Updated TangORB to							Release 7.4.3
- Updated ATK to 								Release 4.2.10
- Updated Starter to							Release 5.2
- Updated TangoTest to							Release 1.4.5
- Updated TangoAccessControl to					Release 2.4
- Updated AccessControl to						Release 2.4

- SourceForge bug 3158150: Architecture issue in configure.in
- SourceForge bug 3152384: Db Server crash when reading timing attributes
- SourceForge bug 3138228: A new parameter in tango_admin when pinging database
- SourceForge bug 3137921: Pogo 7 does not create some output arguments
- SourceForge bug 3129852: Fix SQL script to update a Tango database from release 6 to 7.2

- Update crate_db_tables.sql script to support MySQL >= 5.1 CREATE TABLE sql statement
- Implement a retry to MySQl connection in DB server. Needed for binary install

Changes between Tango distribution 7.2.0 and 7.2.1
--------------------------------------------------

- Updated C++ library 							Release 7.2.1

- Fix SourceForge bugs number 3092110 and 3092764
- Split lib/cpp/server/jpeg directory in order to optimize compilation options

Changes between Tango distribution 7.1.1 and 7.2.0
--------------------------------------------------

- Added tango_admin								Release 1.0
- Updated database device server				Release 4.8
- Updated TangoAccessControl device server		Release 1.5
- Updated TangoTest to 							Release 1.4.4
- Updated ATKCore and ATKWidget to				Release 4.2.3
- Updated atkpanel to							Release 4.3
- Updated Jive to								Release 4.12
- Updated Pogo									Release 7.0
- Updated Astor to								Release 5.2.9
- Updated TangORB to							Release 7.3.5
- Updated Jdraw to 								Release 1.13
- Updated Starter to							Release 4.14

- Fix SourceForge bugs number 3000308 - 3000310 - 3000329
- After installation, the doc and man folders are now under the "share" folder
- A new doc/src folder added in the source package. This folder contains all the
necessary files (lyx format) to generate the Tango bible (tango.pdf).
If lyx is installed on your computer, to re-generate the bible, go to doc/src
and type " lyx -e pdf tango.lyx"
- Pogo release 6 and 7 are available in this release. If you want to start
pogo release 6, simply use the pogo-6 script available in the bin directory after
the install
- After installation, all Pogo code generation related files are in a pogo directory
- Java jar files are now in <install_dir>/share/java
- Include files are now in <install_dir>/include/tango


Changes between Tango distribution 7.0.2 and 7.1.1
--------------------------------------------------

- Updated database device server				Release 4.5
- Updated TangoAccessControl device server		Release 1.4
- Updated ATKCore and ATKWidget to				Release 4.0.6
- Updated atkpanel to							Release 4.2
- Updated Jive to								Release 4.0
- Updated Pogo									Release 6.2.0
- Updated Astor to								Release 5.2.3
- Updated TangORB to							release 7.1.0

- A new option --with-tango-rc-file allowing the user to select the Tango rc file location has been
added to the configure script
- The value passed to the configure script option --with-tango-db-name is now also taken into account
by the database server and the controlled access server
- Man pages for binaries have been added
- omniORB detection done using pkg-config
- Pictures used in the Tango pdf documentation has been changed in order to clarify their licences
- In case TANGO_HOST is not defined as a variable environment, scripts to start the provided tools use the rc file if defined

- Fix bug in MySQL detection
- Fix bug in case doxygen is not available on the host where the installation is performed


Changes between Tango distribution 6.1.1.b and 7.0.2
----------------------------------------------------

- Added the Tango controlled access server		Release 1.3
- Updated Notifd2db.cpp file					Release 1.7
- Updated database device server				Release 4.3
- Updated starter device server					Release 4.8
- Updated TangoTest device server				Release 1.3
- Updated Astor to								Release 5.2
- Updated ATKCore and ATKWidget to				Release 4.0.2
- Updated Jive									Release	3.21
- Updated Pogo									Release 6.0.0
- Updated TangoORB								Release 7.0.2
- Updated atkpanel to							Release 4.1
Added a tango_wca script to start/stop a Tango control system when used with its controlled access

Changes between Tango distribution 6.1.1.a and 6.1.1.b
------------------------------------------------------

- Updated ATKPanel to release 3.5
- Added the log4j jar file (used by LogViewer and Java device server)

Changes between Tango distribution 6.1.1 and 6.1.1.a
----------------------------------------------------

- Notifd2db.cpp file updated to release 1.6
- Fix bug in the database update script in the history ids tables update
- Add TangORB.jar file to the CLASSPATH in the jdraw script file
- Updated TangoORB.jar file to release 6.0.2
- Added the tool_panels jar file
- Update TangoTest device server (slower data refresh frequency)