gLite R-GMA SERVICETOOL

1. Release Description

This release contains the gLite R-GMA Servicetool 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 Servicetool, please refer to the gLite Installation and User Guides.

2. Changes in this release

This release introduces the following changes:

Functionality changes:

R-GMA uses new Glue tables for schema and registry
R-GMA server and clients can run in secure and insecure mode:

The server always runs the secure mode, the insecure mode can be enabled in addition.
Clients can connect to the server either via the secure or via the insecure port (if enabled)

This module is compatible with the LCG release 2.4.0

Deployment and configuration changes:

Command line changes for configuration script:

No option given shows help
--configure configures service (but does not start service)
--start starts service

Configuration parameters

§ rgma.secure.mode added (change between secure and insecure mode)

R-GMA servicetool can contact server on secure and insecure port
R-GMA servicetool publishing follows common standard.

Bug fixes (please refer to the complete list later in these notes)

There is a known incompatibility between gLite release 1.1 and 1.2. For details and workarounds in the R-GMA server to run 1.1 clients (e.g. the R-GMA servicetool) publishing in a 1.2 server, please see the R-GMA server release notes.

3. Release contents

The gLite R-GMA Servicetool v. 5.0.0 is composed of the following gLite components:

Component name	Description	Version	File
glite-config	gLite configuration scripts	1.2.1	../../../../../../../glite-web/egee/packages/R1.2/R20050715/bin/rhel30/noarch/RPMS/glite-config-1.2.1-1.noarch.rpm
org.glite.rgma-api-java	Java API for R.GMA	4.1.5	../../../../../../../glite-web/egee/packages/R1.2/R20050715/bin/rhel30/noarch/RPMS/glite-rgma-api-java-4.1.5-1.noarch.rpm
org.glite.rgma-base	R.GMA basic configuration and documentation	4.1.19	../../../../../../../glite-web/egee/packages/R1.2/R20050715/bin/rhel30/noarch/RPMS/glite-rgma-base-4.1.19-1.noarch.rpm
org.glite.rgma-common.config	gLite rgma common configuration items installation	5.0.0	../../../../../../../glite-web/egee/packages/R1.2/R20050715/bin/rhel30/noarch/RPMS/glite-rgma-common-config-5.0.0-1.noarch.rpm
org.glite.rgma-servicetool	R.GMA service tool	4.1.19	../../../../../../../glite-web/egee/packages/R1.2/R20050715/bin/rhel30/noarch/RPMS/glite-rgma-servicetool-4.1.19-3.noarch.rpm
org.glite.rgma-servicetool-config	gLite R.GMA servicetool installation	5.0.0	../../../../../../../glite-web/egee/packages/R1.2/R20050715/bin/rhel30/noarch/RPMS/glite-rgma-servicetool-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.2/R20050715/bin/rhel30/noarch/RPMS/glite-rgma-stubs-servlet-java-4.1.12-1.noarch.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.2/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.2/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.2/R20050715/bin/rhel30/noarch/RPMS/glite-security-utils-config-1.0.2-2.noarch.rpm

4. Dependencies

The gLite R-GMA Servicetool module v. 5.0.0 has the following dependencies:

Component name	Version	RPM file name
gLite-essentials-java	1.2.0	../../../../../../../glite-web/egee/packages/externals/bin/rhel30/RPMS/glite-essentials-java-1.2.0-2_EGEE.noarch.rpm

5. Known bugs and issues

This release has no 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
#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
#6498	Error message could be more helpful
#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
#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
#7276	Bad error message for expired proxy
#7283	Inserting '\'s
#7332	Services such as rgma-servicetool are not services.
#7384	Proxy should default to the standard location
#7398	C API check fails with centos?
#7399	API errors with expired proxy
#7452	Inconsistent use of stdout and stderr in java API
#7542	Overriding the rgma.conf
#7543	Add a comment "command"?
#7566	rgma.servicetool parameters
#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
#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
#8664	Latest producer doesn't work on JRA1 testbed
#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
#9384	R-GMA registry is not protected against careless use
#9395	Registry API causes deadlock
#9405	The rgma command line tool sets its PYTHONPATH incorrectly
#9406	The rgma python api RPM does not clean up after itself
#9523	StreamProducer doesn\'t crop VARCHARs to size defined in Schema
#9539	LatestProducer created by python API has zero min retention period
#9586	WARN Exception in ConsumerThread for table: GlueSubCluster
#9606	Python RGMA exception incorrectly mapped when using reconnect() method

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
#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
#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
#7442	Remove redundant tables
#7449	Bad behaviour with misconfigured registry
#7601	Connection not recovered after registry failure
#7622	Comments on the quickstart web page
#7838	Spell checkers are good!
#8028	method close() in java API wrapper unmapped to old api close()
#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
#8927	Registry hangs due to slow response from remote producers
#4908	servicetool needs to handle RemoteException differently
#5251	missing error message if the service tool fails to start
#7315	R-GMA Servicetool dumps stack traces to stderr
#5694	Service publisher needs to trap errors

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
#4887	allow RetentionPeriod as a parameter in the conf file of the flexi
#5293	Database producer URL in rgma.conf is wrong
#5425	Deleted items should be replicated
#5475	log4j jar location is hardwired
#5809	Inserting '\'s into latest producers
#6506	Tab completion doesn't pick up "from"
#7091	rgma-install-schema.py non-intuitive to use
#7349	glite-rgma-base-4.1.10-1 fails to install in LB installer
#7451	CTRL-C not properly trapped in python API
#7474	r-gma servicetools: publication of service instances apparently "died"
#7537	Minor problems with read command
#7541	Problems with the rgma man page
#7623	Missing documentation in command line help
#7624	Predicate doesn\'t work?
#7625	Insert gives unclear warning
#7626	YABEM (Yet Another Bad Error Message)
#7627	Missing help for show properties
#7631	No results returned from R-GMA
#7633	Would be useful to query the configured registries
#7692	How one can check whether his jobs do not start because of lack of resources, or because of problem
#8062	R-GMA servicetool doesn't propagate the environment to the services status scripts
#8100	Slow response at CERN
#8102	RGMA test 10 is dumping core
#8107	Erratic test failures
#8425	Cleanup problem when using 1 registry
#8509	The GRRP thread ignores 'connection timed out' messages
#8608	Correct version of JDK for using the R-GMA APIs
#8668	R-GMA won't accept an insert which doesn't include all the columns
#8857	Service publishers dying
#8987	Create table allows unsupported types to be created
#9378	bug in /opt/glite/libexec/rgma-system-tests/c/producer