gLite R-GMA CLIENT

1. Release Description

This release contains the gLite R-GMA Client module v. 5.0.0. The following sections provide additional information about the release content, the module dependencies, the know bugs and issues and a list of bugs closed since the previous release. For information about installing and using the gLite R-GMA Client, please refer to the gLite Installation and User Guides.

2. Changes in this release

The following features are deprecated in R-GMA. They will continue to work in gLite 1.3 but may be dropped in some future version.

The setTerminationInterval() operation is deprecated, without replacement. The termination interval is set once only, when the resource (producer/consumer) is created, and cannot be changed.

Users should no longer call setTerminationInterval()

The Consumer's popAll() operation is deprecated and calls to popAll() should be replaced by calls to pop(maxCount).

Users should change popAll() to pop(maxCount)

The Consumer's count() operation is deprecated without replacement.

Users should no longer call count()

The behaviour of the reconnect() call automatically sending a showSignOfLife() to the corresponding resource is deprecated. Just calling reconnect() should no longer be regarded as sufficient to keep a resource alive. If the user requires a showSignOfLife() to be sent after the call to reconnect(), they should do so explicitly in their own code.

Users should add a showSignOfLife() after a reconnect() unless some other call is about to be made which will keep the service alive

The behaviour of producers accepting calls to insert() with an INSERT statement that contains values that don't match the R-GMA schema for the corresponding table (e.g. strings that are too long or integers that are too big) is deprecated. The user should ensure that values match the schema and should be prepared to find that R-GMA raises an exception and fails in the insert() call if they do not.

Users should check that what they publish is consistent with the schema.

This release introduces a set of bug fixes:

Bug #9539 Add setMinRetentionPeriod to old C API for use by Python
Bug #9606 Map edg.RGMAException onto rgma.RGMAException for reconnect failures
Bug #9539 Set min retention period for all producer types
Bug #9406 Clean up .pyc files when RPM is uninstalled
Bug #9544 Only publish unchanged tuples at longer intervals
Bug #9366 Removed error output to stderr
Bug 8812 Fixed rgma-client-check to set Java security system properties correctly (related to Bug #8812).
Increase retention period for Glue tables since Gin now publishes less often.
Fixed getLocalHostName to stop streaming server hanging on firewalled remote connections.

3. Release contents

The gLite RGMA client v. 5.0.0 is composed of the following gLite components:

Component name	Description	Version	File
glite-config	gLite configuration scripts	1.2.2	../../../../../../../glite-web/egee/packages/R1.3/R20050715/bin/rhel30/noarch/RPMS/glite-config-1.2.2-1.noarch.rpm
org.glite.rgma-api-c	C API for R.GMA	4.1.12	../../../../../../../glite-web/egee/packages/R1.3/R20050715/bin/rhel30/i386/RPMS/glite-rgma-api-c-4.1.12-1.i386.rpm
org.glite.rgma-api-cpp	C++ API for R.GMA	4.1.14	../../../../../../../glite-web/egee/packages/R1.3/R20050715/bin/rhel30/i386/RPMS/glite-rgma-api-cpp-4.1.14-1.i386.rpm
org.glite.rgma-api-java	Java API for R.GMA	4.1.5	../../../../../../../glite-web/egee/packages/R1.3/R20050715/bin/rhel30/noarch/RPMS/glite-rgma-api-java-4.1.5-1.noarch.rpm
org.glite.rgma-api-python	Python API for R.GMA	4.1.14	../../../../../../../glite-web/egee/packages/R1.3/R20050715/bin/rhel30/i386/RPMS/glite-rgma-api-python-4.1.14-1.i386.rpm
org.glite.rgma-base	R.GMA basic configuration and documentation	4.1.19	../../../../../../../glite-web/egee/packages/R1.3/R20050715/bin/rhel30/noarch/RPMS/glite-rgma-base-4.1.19-1.noarch.rpm
org.glite.rgma-client-config	gLite R.GMA client installation	5.0.0	../../../../../../../glite-web/egee/packages/R1.3/R20050715/bin/rhel30/noarch/RPMS/glite-rgma-client-config-5.0.0-1.noarch.rpm
org.glite.rgma-command-line	R.GMA command line	4.1.13	../../../../../../../glite-web/egee/packages/R1.3/R20050715/bin/rhel30/noarch/RPMS/glite-rgma-command-line-4.1.13-1.noarch.rpm
org.glite.rgma-common.config	gLite rgma common configuration items installation	5.0.0	../../../../../../../glite-web/egee/packages/R1.3/R20050715/bin/rhel30/noarch/RPMS/glite-rgma-common-config-5.0.0-1.noarch.rpm
org.glite.rgma-stubs-servlet-java	Java client implementation stubs for R.GMA	4.1.12	../../../../../../../glite-web/egee/packages/R1.3/R20050715/bin/rhel30/noarch/RPMS/glite-rgma-stubs-servlet-java-4.1.12-1.noarch.rpm
org.glite.rgma-system-tests	System tests for R.GMA	4.1.8	../../../../../../../glite-web/egee/packages/R1.3/R20050715/bin/rhel30/i386/RPMS/glite-rgma-system-tests-4.1.7-1.i386.rpm
org.glite.security.trustmanager	The java certificate path checkin for proxy certs in SSL with plugins for tomcat and axis.	1.7.3	../../../../../../../glite-web/egee/packages/R1.3/R20050715/bin/rhel30/noarch/RPMS/glite-security-trustmanager-1.7.3-1.noarch.rpm
org.glite.security-util.java	The java utilities library for security	1.1.2	../../../../../../../glite-web/egee/packages/R1.3/R20050715/bin/rhel30/noarch/RPMS/glite-security-util-java-1.1.2-2.noarch.rpm
org.glite.security-utils.config	gLite Security Utilities configuration files	1.0.2	../../../../../../../glite-web/egee/packages/R1.3/R20050715/bin/rhel30/noarch/RPMS/glite-security-utils-config-1.0.2-2.noarch.rpm

4. Dependencies

The gLite R-GMA Client module v. 4.3.1 has the following dependencies:

Component name	Version	RPM file name
gLite-essentials-cpp	1.1.1	../../../../../../../glite-web/egee/packages/externals/bin/rhel30/RPMS/gLite-essentials-java-1.1.1-1_EGEE.noarch.rpm
gLite-essentials-java	1.2.0	../../../../../../../glite-web/egee/packages/externals/bin/rhel30/RPMS/gLite-essentials-java-1.2.0-2_EGEE.noarch.rpm
SWIG runtime	1.3.21	../../../../../../../glite-web/egee/packages/externals/bin/rhel30/RPMS/swig-runtime-1.3.21-1_EGEE.i386.rpm

5. Known bugs and issues

This release has the following known bugs and issues. Bug numbers refer to the gLite Bug Tracking system database hosted on the CERN Savannah system at https://savannah.cern.ch/bugs/?group=jra1mdw .

Known open bugs:

Bug number	Description
#4284	RGMA: error message for a non existent table is misleading
#4438	R-GMA doesn't check types
#4634	RGMA scripts from EDG still present
#5703	case sensitive varchar's when creating an archiver
#6287	add a predefined query to the browser to query the new log4 table
#6288	HTTP proxy support is inconsistent
#6475	Case sensitivity for table names is problematic
#6479	csv and tsv output has vanished
#6493	Bad case sensitivity for insert
#6495	insert does not check the column name
#6496	Bad/missing error messages with select
#6501	Range checking on the date stamp leaves something to be desired
#6510	Case sensitivity depends on query type
#6511	Syntax checking could be better
#6512	More parsing errors
#6514	Case sensitivity error with a secondary producer
#6568	Could log commands to a file
#6935	Install guide mentions RGMA-Server in LTS Section
#6977	Printable version of the APIs would be nice
#7024	Additions to the manuals
#7149	Formatting strings for output
#7188	Bad messages if a port isn't open
#7189	How do you know the primary key?
#7218	Finding the configured registry and schema
#7220	Bad error message with ssl error
#7225	All client interactions should go via the local servlet box
#7226	rgma client configuration succeds, but a client test fails
#7276	Bad error message for expired proxy
#7283	Inserting '\'s
#7384	Proxy should default to the standard location
#7399	API errors with expired proxy
#7452	Inconsistent use of stdout and stderr in java API
#7487	the rgma client and it does not use the X509_CERT_DIR to look for the certificates of the CAs
#7542	Overriding the rgma.conf
#7543	Add a comment "command"?
#7635	Problems with registry configuration
#7644	Need explanation of how to get info out of result sets
#7654	Detection of an error with TRUSTFILE
#7664	Bad service names?
#7704	Publication rate and LRP for site and service publishers should be configurable
#7726	Bad error message in web browser
#8099	Archivers are inconsistent
#8106	Test 12 should not check GlueHost
#8356	Test the service discovery API
#8479	Reassigned item: RGMA crashes on IA64
#8650	R-GMA dies trying to insert a record
#8872	Extra documentation in rgma.registry.hostname for using 2 registries
#8882	Predefined queries on the Browser are linked to the old schema tables
#8950	in glite 1.1 having the site configured not to use RGMA, the deployment script fails with RGMA not working
#8992	browser failed to update column definitions
#9109	API is missing a "show tables" equivalent
#9195	APEL 3.4.45 Doesn't work with Java 1.5
#9238	Replica Manager thread dies and does not recover
#9272	tomcat log4j warnings
#9303	C API fails with HTTP protocol error in some circumstances.
#9315	R-GMA components don't follow agreed naming convention for service type
#9381	NullPointerException in R-GMA StreamProducerServlet
#9384	R-GMA registry is not protected against careless use
#9395	Registry API causes deadlock
#9406	The rgma python api RPM does not clean up after itself
#9507	R-GMA BrowserServlet threw exception clicking on endpoint
#9523	StreamProducer doesn\'t crop VARCHARs to size defined in Schema
#9539	LatestProducer created by python API has zero min retention period
#9606	Python RGMA exception incorrectly mapped when using reconnect() method
#9699	ArchiverThread doesn't check column types when inserting.
#9744	fatal error reported by java api when in insecure mode
#9792	Archiver does not recreate its Consumers when they die

Bugs fixed in this or previous releases, but not yet tested:

Bug number	Description
#4646	RGMA on the SE
#4698	RGMA logging fills up /var
#4822	running start on started service is not an error.
#5143	Too many open files using MySQL
#5251	missing error message if the service tool fails to start
#5306	Use GLITE_LOCATION not RGMA_HOME
#5411	http://hepunx.rl.ac.uk/egee/jra1-uk/glite/index.html has various errors
#5412	No provision for not being port 8080
#5510	need for DB indices for DBProducer in underlying DBMS
#5694	Service publisher needs to trap errors
#6391	Wrong cron.hourly entry
#6481	Bad error message from show
#6990	Manual should refer to RC1 code
#7018	Manuals should mention case-sensitivity issues
#7156	C++ SecondaryProducer example doesn't behave as expected
#7655	declareTable fails with invalid predicate, but table is still declared
#7397	r-gma command-line documentation feature request
#7398	C API check fails with centos?
#7442	Remove redundant tables
#7449	Bad behaviour with misconfigured registry
#7600	servlet check doesn't spot time sync problem
#7601	Connection not recovered after registry failure
#7622	Comments on the quickstart web page
#7838	Spell checkers are good!
#8439	Components deadlocks when Registry down and do not resume
#8457	R-GMA does not remove illegal XML characters
#8548	R1/LCG Java API doesn't work with Java 1.5
#8552	'Out of Memory' Registries cause rgma system to run very slowly.
#8574	Issuing \'mysql -u root -p < .....\' failed
#8749	createOnDemandProducer calls the CanonicalProducer API incorrectly
#8811	Pong Servlet initialisation error running in insecure mode
#8812	ServletConnection throws exception in insecure mode
#8898	Flexible archiver init.d script returns ok when it has failed with a RGMAException
#8927	Registry hangs due to slow response from remote producers
#9405	The rgma command line tool sets its PYTHONPATH incorrectly

6. Bugs closed since last release

This release fixes the following bugs and issues. Bug numbers refer to the gLite Bug Tracking system database hosted on the CERN Savannah system at https://savannah.cern.ch/bugs/?group=jra1mdw

Bug number	Description
#7294	glite-wn-config.py (glite-rgma-client-config.py) crashes with NameError