gLite RGMA CLIENT

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.

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

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

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

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

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

7. Previous Releases

7.1. RELEASE 4.1.2

7.1.1. Release Description

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

glite-rgma-api-c v4.1.3
Fixed Database producer servlet name in reconnect().
glite-rgma-api-python v 4.1.4
Fixed bug when properties file has comments or blank lines
glite-rgma-base v4.1.9
Fixed: Postinstall script only runs when installing user is root
Fixed: Added option in setup script to not use security
Fixed relocatability of rgma user
glite-rgma-flexible-archiver v4.0.8
Fixed error when upgrading RPM with RGMA_HOME incorrectly set
glite-rgma-gin v4.1.6
Fixed error when upgrading RPM with RGMA_HOME incorrectly set
glite-rgma-publish-site v4.1.9
Fixed error when upgrading RPM with RGMA_HOME incorrectly set
glite-rgma-services v4.1.6
Fixed null socket channel error in InsertableInstance
Added more firewall handling/diagnostic code
Downgraded RegistryMediator's "Unable to find any valid registries to update" to "info".
glite-rgma-servicetool v4.1.10
Moved system tests to more standard directory
Made producer thread log a warning and continue after receiving a runtime exception
glite-rgma-stubs-servlet-java v4.1.5
Added more firewall handling/diagnostic code (ConnectionTimedOutException).
glite-rgma-system-tests v4.1.4
Updated rgma-client-check to correctly use GRID_PROXY_FILE vs. TRUSTFILE

7.1.3. Release contents

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

Component name	Version	File
org.glite.deployment.rgma-client	4.1.2	../../../../../../../glite-web/egee/packages/I20050225/installers/glite-rgma-client_installer.sh ../../../../../../../glite-web/egee/packages/I20050225/bin/rhel30/noarch/RPMS/glite-rgma-client-config-4.1.2-1.noarch.rpm
org.glite.deployment.rgma-common	4.1.0	../../../../../../../glite-web/egee/packages/I20050225/bin/rhel30/noarch/RPMS/glite-rgma-common-config-4.1.0-1.noarch.rpm
org.glite.deployment.config	0.8.2	../../../../../../../glite-web/egee/packages/I22050225/bin/rhel30/noarch/RPMS/glite-config-0.8.2-1.noarch.rpm
org.glite.rgma.api-c	4.1.3	../../../../../../../glite-web/egee/packages/I20050225/bin/rhel30/i386/RPMS/glite-rgma-api-c-4.1.3-1.i386.rpm
org.glite.rgma.api-cpp	4.1.5	../../../../../../../glite-web/egee/packages/I20050225/bin/rhel30/i386/RPMS/glite-rgma-api-cpp-4.1.5-1.i386.rpm
org.glite.rgma.api-java	4.1.2	../../../../../../../glite-web/egee/packages/I20050225/bin/rhel30/noarch/RPMS/glite-rgma-api-java-4.1.2-1.noarch.rpm
org.glite.rgma.api-python	4.1.4	../../../../../../../glite-web/egee/packages/I20050225/bin/rhel30/i386/RPMS/glite-rgma-api-python-4.1.4-1.i386.rpm
org.glite.rgma-base	4.1.9	../../../../../../../glite-web/egee/packages/I20050225/bin/rhel30/noarch/RPMS/glite-rgma-base-4.1.9-1.noarch.rpm
org.glite.rgma-command-line	4.1.4	../../../../../../../glite-web/egee/packages/I20050225/bin/rhel30/noarch/RPMS/glite-rgma-command-line-4.1.4-1.noarch.rpm
org.glite.rgma-stubs-servlet-java	4.1.5	../../../../../../../glite-web/egee/packages/I20050225/bin/rhel30/noarch/RPMS/glite-rgma-stubs-servlet-java-4.1.5-1.noarch.rpm
glite-rgma-system-tests	4.1.4	../../../../../../../glite-web/egee/packages/I20050225/bin/rhel30/i386/RPMS/glite-rgma-system-tests-4.1.4-1.i386.rpm
glite-security-trustmanager	1.6.4	../../../../../../../glite-web/egee/packages/I20050225/bin/rhel30/noarch/RPMS/glite-security-trustmanager-1.6.4-1.noarch.rpm
glite-security-util-java	1.0.0	../../../../../../../glite-web/egee/packages/I20050225/bin/rhel30/noarch/RPMS/glite-security-util-java-1.0.0-2.noarch.rpm

7.1.4. Dependencies

The gLite RGMA client module has the following dependencies:

Component name	Version	RPM file name
gLite Security Utilities	0.6.1	../../../../../../../glite-web/egee/packages/I20050218/installers/glite-security-utils_installer.sh ../../../../../../../glite-web/egee/packages/I20050218/bin/rhel30/noarch/RPMS/glite-security-utils-config-0.6.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

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

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.
This release doesn’t give the possibility of configuring the client automatically to use multiple registries. This will be fixed in a future release. This is an issue in the configuration script, not in the client itself, which can be manually configured to use multiple registries

Known open bugs:

Bug number	Description
#4668	incorrect information in the client side rgma.props file only affects certain commands
#5306	Use GLITE_LOCATION not RGMA_HOME
#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
#6845	There are no test reports provided for the R-GMA Client in gLite v1.0.6 RC1 (Integration Build I20050204)
#7147	Response to ctrl-c could be better
#7149	Formatting strings for output
#7179	RGMA depl mod. : flex archiver pid file to be removed before restart attempt
#7188	Bad messages if a port isn't open
#7189	How do you know the primary key?
#7191	RGMA client script fails if jre only is installed
#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
#7234	glite-rgma-server-conf.py --start does not read the R-GMA configuration
#7235	glite-rgma-server-config.py does not modify tomcat5.conf
#7236	glite-rgma-servicetool_installer.sh does not install the glite-rgma-servicetool RPMs
#7245	Error messages should be on stderr
#7259	missing env variables for RGMA client
#7268	RGMA unable to read proxy certificate file
#7276	Bad error message for expired proxy

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

Bug number	Description
#5475	log4j jar location is hardwired
#6046	Incorrect dependencies on log4j in rgma rpms
#7178	RGMA deployment module fails. (tomcat5.py)

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
#6443	problem with rgma init.d scripts
#6754	glite-rgma-server-config.py failed