gLite R-GMA CLIENT

1. Release Description

This release contains the gLite R-GMA Client module v. 4.3.1. 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

This release introduces the following changes:

The GRID_PROXY_FILE and X509_USER_PROXY environment variables are not set anymore by default by the configuration script, since this creates conflicts with the job wrapper on the WN. If the variables have to be defined (for example for using the R-GMA Client in a stand-alone installation) the new system-level configuration parameter set.proxy.path can be set to true. In the gLite system, the R-GMA client is always used as part of the WN or the UI and there is not need to set this parameter
Added missing PYTHONPATH environment variable to configuration script
Bug fixes (please refer to the complete list later in these notes)

3. Release contents

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

Component name	Version	File
org.glite.deployment.rgma-client	4.3.1	../../../../../../../glite-web/egee/packages/R1.1/R20050430/installers/glite-rgma-client_installer.sh ../../../../../../../glite-web/egee/packages/R1.1/R20050430/bin/rhel30/noarch/RPMS/glite-rgma-client-config-4.3.1-1.noarch.rpm apt-get install glite-rgma-client-config
org.glite.deployment.rgma-common	4.2.0	../../../../../../../glite-web/egee/packages/R1.1/R20050430/bin/rhel30/noarch/RPMS/glite-rgma-common-config-4.2.0-1.noarch.rpm
org.glite.deployment.config	1.1.1	../../../../../../../glite-web/egee/packages/I22050225/bin/rhel30/noarch/RPMS/glite-config-1.1.1-3.noarch.rpm
org.glite.rgma.api-c	4.1.7	../../../../../../../glite-web/egee/packages/R1.1/R20050430/bin/rhel30/i386/RPMS/glite-rgma-api-c-4.1.7-1.i386.rpm
org.glite.rgma.api-cpp	4.1.11	../../../../../../../glite-web/egee/packages/R1.1/R20050430/bin/rhel30/i386/RPMS/glite-rgma-api-cpp-4.1.11-1.i386.rpm
org.glite.rgma.api-java	4.1.3	../../../../../../../glite-web/egee/packages/R1.1/R20050430/bin/rhel30/noarch/RPMS/glite-rgma-api-java-4.1.3-1.noarch.rpm
org.glite.rgma.api-python	4.1.7	../../../../../../../glite-web/egee/packages/R1.1/R20050430/bin/rhel30/i386/RPMS/glite-rgma-api-python-4.1.7-1.i386.rpm
org.glite.rgma-base	4.1.14	../../../../../../../glite-web/egee/packages/R1.1/R20050430/bin/rhel30/noarch/RPMS/glite-rgma-base-4.1.14-1.noarch.rpm
org.glite.rgma-command-line	4.1.9	../../../../../../../glite-web/egee/packages/R1.1/R20050430/bin/rhel30/noarch/RPMS/glite-rgma-command-line-4.1.9-1.noarch.rpm
org.glite.rgma-stubs-servlet-java	4.1.6	../../../../../../../glite-web/egee/packages/R1.1/R20050430/bin/rhel30/noarch/RPMS/glite-rgma-stubs-servlet-java-4.1.6-1.noarch.rpm
glite-rgma-system-tests	4.1.5	../../../../../../../glite-web/egee/packages/R1.1/R20050430/bin/rhel30/i386/RPMS/glite-rgma-system-tests-4.1.5-1.i386.rpm
glite-security-trustmanager	1.6.4	../../../../../../../glite-web/egee/packages/R1.1/R20050430/bin/rhel30/noarch/RPMS/glite-security-trustmanager-1.6.4-1.noarch.rpm
glite-security-util-java	1.0.1	../../../../../../../glite-web/egee/packages/R1.1/R20050430/bin/rhel30/noarch/RPMS/glite-security-util-java-1.0.1-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 Security Utilities	1.0.1	../../../../../../../glite-web/egee/packages/R1.1/R20050430/installers/glite-security-utils_installer.sh ../../../../../../../glite-web/egee/packages/R1.1/R20050430/bin/rhel30/noarch/RPMS/glite-security-utils-config-1.0.1-1.noarch.rpm
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 .

Many error messages are very poor. This is especially a problem with the command line tool due to messages being lost in too many layers of software. Error messages are also inconsistent between API’s.
Table and column names are currently case sensitive in RGMA. To get consistent results always respect case.
Only a subset of SQL 92 is currently supported by RGMA, and continuous queries are even more restricted.
Some operations of the command line tool try to access the schema and registry directly rather than just the local RGMA server. This access may be blocked by a firewall.
The C, C++, and Python APIs and the command line tool make a new connection to the server for each API operation. When connecting to a secure server this adds a substantial overhead, so multiple API calls (e.g. lots of inserts) will run slowly. The Java API is not affected.

No removal procedure is provided with this release apart from the removal of the RPMS. Any account, group or other resource created during the module configuration must be manually cleaned.

Known open bugs:

Bug number	Description
#4284	RGMA: error message for a non existent table is misleading
#4634	RGMA scripts from EDG still present
#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
#6568	Could log commands to a file
#7149	Formatting strings for output
#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
#7398	C API check fails with centos?
#7399	API errors with expired proxy
#7487	the rgma client and it does not use the X509_CERT_DIR to look for the certificates of the CAs
#7543	Add a comment "command"?
#7633	Would be useful to query the configured registries
#8028	method close() in java API wrapper unmapped to old api close()
#8120	rgma-client-check does not add external libs to LD_LIBRARY_PATH
#8510	lack of possibility to get/restore servlet connection in Python API

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

Bug number	Description
#4275	R-GMA needs a setup script to be run
#5306	Use GLITE_LOCATION not RGMA_HOME
#6481	Bad error message from show
#6506	Tab completion doesn't pick up "from"
#6679	The R-GMA client installer ignores rpm failures
#6828	Incorrect instructions for creating config file when installing R-GMA client
#7293	glite-rgma-client-config.py contains spurious lines
#7294	glite-wn-config.py (glite-rgma-client-config.py) crashes with NameError
#7397	r-gma command-line documentation feature request
#7451	CTRL-C not properly trapped in python API
#7452	Inconsistent use of stdout and stderr in java API
#7537	Minor problems with read command
#7623	Missing documentation in command line help
#7625	Insert gives unclear warning
#7626	YABEM (Yet Another Bad Error Message)
#7627	Missing help for show properties
#7764	Error in WN installer (glite-rgma-client_installer.sh)
#7916	"glite-rgma-client_installer.sh if -n $basedir; then"

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
#4290	Another message that could be improved
#5148	error message for non local schema and registry are misleading
#6046	Incorrect dependencies on log4j in rgma rpms
#6274	Unable to configure R-GMA replicated registry in the client
#6477	Unclear error messages
#6480	Bad error message for unknown "set"
#6507	Help for select doesn't mention "order by"
#6509	Make commands case-insensitive
#6516	Weird behaviour with -f option
#6680	Missing gLite dependencies in glite-rgma-client_installer.sh
#6980	Distribute the code examples
#6981	Missing link to manual?
#7012	Problem in C++ manual example
#7014	C++ manual does not tell you the compiler options
#7147	Response to ctrl-c could be better
#7191	RGMA client script fails if jre only is installed
#7245	Error messages should be on stderr
#7259	missing env variables for RGMA client
#7295	glite-wn-config.py (glite-rgma-client-config.py) requires host certificates
#7308	Changed behaviour with ctrl-D
#7310	Client doesn't know about multiple registries
#7409	RGMA security
#7438	rgma-client fails to see JAVA_HOME even if set
#7593	Documentation web page
#7640	Crash if create/drop is used
#7642	create_table fails
#7672	glite-rgma-base does not get installed
#8030	count() should return -1 if no producers can provide an answer

7. Previous Releases

7.1. RELEASE 4.3.0

7.1.1. Release Description

This release contains the gLite R-GMA Client module v. 4.3.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.

7.1.2. Changes in this release

This release introduces the following changes:

Added RPM-based user installation for inclusion in the gLite UI and the gLite WN
Fixes a problem with usage of delegated proxies in the C and C++ APIs
org.glite.rgma.api-c v. 4.1.6
Now loads entire proxy certificate chain
org.glite.rgma.api-cpp v 4.1.10
Bug #7409 Fixed use of delegated proxies Producers can now set the termination interval correctly

7.1.3. Release contents

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

Component name	Version	File
org.glite.deployment.rgma-client	4.3.0	../../../../../../../glite-web/egee/packages/R1.0/R20050331/installers/glite-rgma-client_installer.sh ../../../../../../../glite-web/egee/packages/R1.0/R20050331/bin/rhel30/noarch/RPMS/glite-rgma-client-config-4.3.0-1.noarch.rpm
org.glite.deployment.rgma-common	4.2.0	../../../../../../../glite-web/egee/packages/R1.0/R20050331/bin/rhel30/noarch/RPMS/glite-rgma-common-config-4.2.0-1.noarch.rpm
org.glite.deployment.config	1.0.0	../../../../../../../glite-web/egee/packages/I22050225/bin/rhel30/noarch/RPMS/glite-config-1.0.0-1.noarch.rpm
org.glite.rgma.api-c	4.1.6	../../../../../../../glite-web/egee/packages/R1.0/R20050331/bin/rhel30/i386/RPMS/glite-rgma-api-c-4.1.6-1.i386.rpm
org.glite.rgma.api-cpp	4.1.10	../../../../../../../glite-web/egee/packages/R1.0/R20050331/bin/rhel30/i386/RPMS/glite-rgma-api-cpp-4.1.10-1.i386.rpm
org.glite.rgma.api-java	4.1.3	../../../../../../../glite-web/egee/packages/R1.0/R20050331/bin/rhel30/noarch/RPMS/glite-rgma-api-java-4.1.3-1.noarch.rpm
org.glite.rgma.api-python	4.1.6	../../../../../../../glite-web/egee/packages/R1.0/R20050331/bin/rhel30/i386/RPMS/glite-rgma-api-python-4.1.6-1.i386.rpm
org.glite.rgma-base	4.1.12	../../../../../../../glite-web/egee/packages/R1.0/R20050331/bin/rhel30/noarch/RPMS/glite-rgma-base-4.1.12-1.noarch.rpm
org.glite.rgma-command-line	4.1.8	../../../../../../../glite-web/egee/packages/R1.0/R20050331/bin/rhel30/noarch/RPMS/glite-rgma-command-line-4.1.8-1.noarch.rpm
org.glite.rgma-stubs-servlet-java	4.1.6	../../../../../../../glite-web/egee/packages/R1.0/R20050331/bin/rhel30/noarch/RPMS/glite-rgma-stubs-servlet-java-4.1.6-1.noarch.rpm
glite-rgma-system-tests	4.1.5	../../../../../../../glite-web/egee/packages/R1.0/R20050331/bin/rhel30/i386/RPMS/glite-rgma-system-tests-4.1.5-1.i386.rpm
glite-security-trustmanager	1.6.4	../../../../../../../glite-web/egee/packages/R1.0/R20050331/bin/rhel30/noarch/RPMS/glite-security-trustmanager-1.6.4-1.noarch.rpm
glite-security-util-java	1.0.0	../../../../../../../glite-web/egee/packages/R1.0/R20050331/bin/rhel30/noarch/RPMS/glite-security-util-java-1.0.0-2.noarch.rpm

7.1.4. Dependencies

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

Component name	Version	RPM file name
gLite Security Utilities	1.0.0	../../../../../../../glite-web/egee/packages/R1.0/R20050331/installers/glite-security-utils_installer.sh ../../../../../../../glite-web/egee/packages/R1.0/R20050331/bin/rhel30/noarch/RPMS/glite-security-utils-config-1.0.0-1.noarch.rpm
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

7.1.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 .

Many error messages are very poor. This is especially a problem with the command line tool due to messages being lost in too many layers of software. Error messages are also inconsistent between API’s.
Table and column names are currently case sensitive in RGMA. To get consistent results always respect case.
Only a subset of SQL 92 is currently supported by RGMA, and continuous queries are even more restricted.
Some operations of the command line tool try to access the schema and registry directly rather than just the local RGMA server. This access may be blocked by a firewall.
There is a known issue with Java 1.4.2 running with the Scientific Linux 3 SMP kernel on dual processor machines, where the Java Virtual Machine can crash without warning. The current solution is to use a non-SMP kernel. We believe this will be fixed in Java 1.4.2 08, but there is no release date for this yet. The problem does not seem to occur in RH7.3 or RHEL4.
The C, C++, and Python APIs and the command line tool make a new connection to the server for each API operation. When connecting to a secure server this adds a substantial overhead, so multiple API calls (e.g. lots of inserts) will run slowly. The Java API is not affected.
All VOs share the same name space and information.

Authentication is enabled by default. To use the RGMA Browser you must load your certificate into the web browser.
No removal procedure is provided with this release apart from the removal of the RPMS. Any account, group or other resource created during the module configuration must be manually cleaned.

Known open bugs:

Bug number	Description
#7225	All client interactions should go via the local servlet box
#7226	rgma client configuration succeds, but a client test fails
#7438	rgma-client fails to see JAVA_HOME even if set
#7487	the rgma client and it does not use the X509_CERT_DIR to look for the certificates of the CAs
#7702	ClientAuthentication.props SSL values missing

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

Bug number	Description
#6046	Incorrect dependencies on log4j in rgma rpms
#6249	gLite Installation Guide - corrections for rgma
#6274	Unable to configure R-GMA replicated registry in the client
#6679	The R-GMA client installer ignores rpm failures
#6680	Missing gLite dependencies in glite-rgma-client_installer.sh
#6828	Incorrect instructions for creating config file when installing R-GMA client
#7191	RGMA client script fails if jre only is installed
#7259	missing env variables for RGMA client
#7293	glite-rgma-client-config.py contains spurious lines
#7294	glite-wn-config.py (glite-rgma-client-config.py) crashes with NameError
#7295	glite-wn-config.py (glite-rgma-client-config.py) requires host certificates
#7310	Client doesn't know about multiple registries

7.1.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
#4667	help instructions are wrong in the rgma client tool
#4668	incorrect information in the client side rgma.props file only affects certain commands
#7297	glite-rgma-client-config.py contains CVS conflicts and won't compile