gLite R-GMA SERVICETOOL

1. Release Description

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

2.1. Changes in functionality

The R-GMA servicetool supports now the publishing of additional parameters for each services. The newly added parameters are:

o List of VOs that this service is considered part of.

o List of service names that this service is associated with.

o List of extra parameters for the service.

In addition it is no longer necessary to specify the common set of parameters

o rgma.servicetool.status_interval

o rgma.servicetool.publish_interval

o rgma.servicetool.url_wsdl

o rgma.servicetool.url_semantics

for each servicetool instance in each servicetool instance if you want to use the default values. See section 2.2 for details.

2.2. Changes in Configuration

The configuration of the module has changed. Please update your configuration if you upgrade from a previous version of the R-GMA servicetool.

2.2.1. New configuration parameters

The following configuration parameters have been added:

File: glite-rgma-servicetool.cfg.xml
Parameter	Default value	Description
Advanced Parameters
*The following parameters have been added to the file to be used as default parameter if they are not defined in an individual servicetool instance.*
rgma.servicetool. status_interval	60	How often to check and publish service status (running/not running). This parameter can be also specified separately per servicetool instance in your service configuration file. The value defined here is the fallback value if no value is defined in the individual servicetool instance. Example: 60 [Type: 'string'] [Unit: 'seconds']
rgma.servicetool. publish_interval	3600	How often to publish the service details like endpoint, WSDL, URL. As this information is not changing so much, the interval can be lower than 'rgma.servicetool.status_interval' to reduce the load for R-GMA and the amount of data that is archived. This parameter can be also specified separately per servicetool instance in your service configuration file. The value defined here is the fallback value if no value is defined in the individual servicetool instance. Example: 3600 [Type: 'integer'] [Unit: 'seconds']
rgma.servicetool. url_wsdl	not available	URL of a WSDL document for the service. Put 'not available' if no wsdl url is available. This parameter can be also specified separately per servicetool instance in your service configuration file. The value defined here is the fallback value if no value is defined in the individual servicetool instance. Example: http://example.rl.uk/service?WSDL [Type: 'string']
rgma.servicetool. url_semantics	not available	URL of a document containing a detailed description of the service and how it should be used. Put 'not available' if not url is available. This parameter can be also specified separately per servicetool instance in your service configuration file. The value defined here is the fallback value if no value is defined in the individual servicetool instance. Example: http://example.rl.ac.uk/service/semantics.html [Type: 'string']
*The following parameters are new configuration parameters. They* *have been also added to the file to be used as default parameter if they are not defined in an individual servicetool instance.*
rgma.servicetool.vo		List of VOs that this service is considered part of. This parameter can be also specified separately per servicetool instance in your service configuration file. Optional parameter - you can specify one or several or it can be left empty or be removed. The value defined here is the fallback value if no value is defined in the individual servicetool instance. Example: EGEE [Type: 'string']
rgma.servicetool. associatedService		List of service names that this service is associated with. This parameter can be also specified separately per servicetool instance in your service configuration file. The value defined here is the fallback value if no value is defined in the individual servicetool instance. Optional parameter - you can specify one or several or it can be left empty or be removed. Example: YOURhostname_YOURvoname_YOURservicetype [Type: 'string']">
rgma.servicetool.param		List of extra parameters for the service to be published. The structure for each entry is key=value. This parameter can be also specified separately per servicetool instance in your service configuration file. The value defined here is the fallback value if no value is defined in the individual servicetool instance. Optional parameter - you can specify one or several or it can be left empty or be removed. Example: yourkey=yourvalue [Type: 'string']

The following table contains the values that are newly supported by the R-GMA servicetool for the servicetool instances in the service specific configuration files. These values can be added to each servicetool instance, they are however optional.

File: glite-rgma-servicetool-serviceName.cfg.xml
Parameter	Default value	Description
Advanced Parameters
rgma.servicetool.vo		List of VOs that this service is considered part of. Optional parameter - you can specify one or several or it can be left empty or be removed. Example: EGEE [Type: 'string']
rgma.servicetool. associatedService		List of service names that this service is associated with. Optional parameter - you can specify one or several or it can be left empty or be removed. Example: YOURhostname_YOURvoname_YOURservicetype [Type: 'string']">
rgma.servicetool.param		List of extra parameters for the service to be published. The structure for each entry is key=value. Optional parameter - you can specify one or several or it can be left empty or be removed. Example: yourkey=yourvalue [Type: 'string']

2.2.2. Removed configuration parameters

No parameter has been removed in this release.

2.2.3. Changed configuration parameters

No parameter has changed the name or the value in this release.

2.3. Bug FIXES

This release introduces a set of bug fixes (for the full list of fixed bug see sections 5.2 and 5.3):

· org.glite.rgma.stubs-servlet-java

Bug #9792 Changed APIBase to return correct message on "object closed" - used to return "API closed".
Bug #9744 Security set-up now only attempted on first connection to HTTPS.

org.glite.rgma.services

Bug #10238 Added code to shortcut isTupleInside... if minRetentionPeriod is 0.
Bug #10238 Added code to trap "Data truncation" exceptions. Changed behaviour of LP to match DBP: do not throw exception to user on failed insert/update.

3. Release contents

3.1. Glite sub-deployment modules

The gLite R-GMA Servicetool module installs/uses the following set of gLite deployment modules:

glite-rgma-servicetool
glite-security-utils

Please see the corresponding release notes of these modules for details.

3.2. Glite RPMS

The gLite R-GMA Servicetool module is composed of the following gLite components (list includes the gLite components of the other used gLite deployment modules in section 3.1):

Component name	Description	Version	File
glite-config	gLite configuration scripts	1.4.2	../../../../../../../glite-web/egee/packages/R1.4/R20050916/bin/rhel30/noarch/RPMS/glite-config-1.4.2-1.noarch.rpm
glite-rgma-api-java	Java API for R-GMA	4.1.5	../../../../../../../glite-web/egee/packages/R1.4/R20050916/bin/rhel30/noarch/RPMS/glite-rgma-api-java-4.1.5-1.noarch.rpm
glite-rgma-base	R-GMA basic configuration and documentation	4.1.19	../../../../../../../glite-web/egee/packages/R1.4/R20050916/bin/rhel30/noarch/RPMS/glite-rgma-base-4.1.19-1.noarch.rpm
glite-rgma-common-config	gLite rgma common configuration items installation	5.0.0	../../../../../../../glite-web/egee/packages/R1.4/R20050916/bin/rhel30/noarch/RPMS/glite-rgma-common-config-5.0.0-1.noarch.rpm
glite-rgma-servicetool	R-GMA service tool	4.1.19	../../../../../../../glite-web/egee/packages/R1.4/R20050916/bin/rhel30/noarch/RPMS/glite-rgma-servicetool-4.1.19-3.noarch.rpm
glite-rgma-servicetool-config	gLite R-GMA servicetool installation	5.1.0	../../../../../../../glite-web/egee/packages/R1.4/R20050916/bin/rhel30/noarch/RPMS/glite-rgma-servicetool-config-5.1.0-1.noarch.rpm
glite-rgma-stubs-servlet-java	Java client implementation stubs for R-GMA	4.1.13	../../../../../../../glite-web/egee/packages/R1.4/R20050916/bin/rhel30/noarch/RPMS/glite-rgma-stubs-servlet-java-4.1.13-1.noarch.rpm
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.4/R20050916/bin/rhel30/noarch/RPMS/glite-security-trustmanager-1.7.3-1.noarch.rpm
glite-security-util-java	The java utilities library for security	1.1.2	../../../../../../../glite-web/egee/packages/R1.4/R20050916/bin/rhel30/noarch/RPMS/glite-security-util-java-1.1.2-2.noarch.rpm
glite-security-utils-config	gLite Security Utilities configuration files	1.0.4	../../../../../../../glite-web/egee/packages/R1.4/R20050916/bin/rhel30/noarch/RPMS/glite-security-utils-config-1.0.4-1.noarch.rpm

4. Dependencies

The gLite R-GMA Servicetool module 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

For the list of dependencies of the gLite sub-deployment modules, listed in section 3.1, please see the release notes of the corresponding modules for their list of dependencies.

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.

5.1. 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
#5412	RGMA: No provision for not being port 8080
#5703	case sensitive varchar's when creating an archiver
#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
#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?
#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
#7332	Services such as rgma-servicetool are not services.
#7399	API errors with expired proxy
#7442	Remove redundant tables
#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"?
#7566	rgma.servicetool parameters
#7574	rgmaservicetool configuration script changeme error
#7575	rgma servicetool configuration script does not exit on error
#7635	Problems with registry configuration
#7644	Need explanation of how to get info out of result sets
#7654	Detection of an error with TRUSTFILE
#7676	Need to find out server limits on parameters
#7704	Publication rate and LRP for site and service publishers should be configurable
#7726	Bad error message in web browser
#8099	Archivers are inconsistent
#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
#8992	browser failed to update column definitions
#8993	rgma-server-setup.py sets the replicate attribute to true in rgma-server.conf even though only one registry is being use
#9109	API is missing a "show tables" equivalent
#9272	tomcat log4j warnings
#9375	glite-rgma-server-installer does not create /var/log/glite/rgma-server/rgma-server.log
#9381	NullPointerException in R-GMA StreamProducerServlet
#9384	R-GMA registry is not protected against careless use
#9395	Registry API causes deadlock
#9507	R-GMA BrowserServlet threw exception clicking on endpoint
#9523	StreamProducer doesn\'t crop VARCHARs to size defined in Schema
#9589	Site publisher needs extra config items
#9665	Cpp API makes a new connection for each server call resulting in slow performance
#9699	ArchiverThread doesn't check column types when inserting.
#9836	Insecure configuration of R-GMA fails
#10066	Reassigned item: Site Archiver
#10171	Would like str() to provide the state of an object using the Python API
#10181	Gin is aborting because of a fatal error
#10182	All Exceptions in Python API are mapped to RGMAException
#10387	Servicetool does not kill hanging status scripts
#10511	User guides should contain more advice
#10555	R-GMA site publisher documentation does not contain new values
#10600	Strings that look like numbers get treated as numbers
#10604	In memory streaming code causes out of bounds exception
#10617	SP deadlock with multiple tables
#10635	R-GMA archiver installation prints error
#10636	R-GMA glue archiver prints error if id file is not there
#10797	glite-rgma-server-config.py –configure fails due to undefined $GLITE_LOCATION

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

Bug number	Description
#5143	Too many open files using MySQL
#5411	http://hepunx.rl.ac.uk/egee/jra1-uk/glite/index.html has various errors
#5510	need for DB indices for DBProducer in underlying DBMS
#6287	add a predefined query to the browser to query the new log4 table
#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
#7218	Finding the configured registry and schema
#7315	R-GMA Servicetool dumps stack traces to stderr
#7398	C API check fails with centos?
#7449	Bad behaviour with misconfigured registry
#7600	servlet check doesn't spot time sync problem
#7622	Comments on the quickstart web page
#7655	declareTable fails with invalid predicate, but table is still declared
#7664	Bad service names?
#7838	Spell checkers are good!
#8106	Test 12 should not check GlueHost
#8427	rgma-gin problem: "Gin is aborting because of a fatal error"
#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
#8551	Rgma servers should avoid selecting a Registry if one is located locally.
#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
#8765	R-GMA server: impossible to change the mysql password via the python scripts
#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
#8950	in glite 1.1 having the site configured not to use RGMA, the deployment script fails with RGMA not working
#9195	APEL 3.4.45 Doesn't work with Java 1.5
#9238	Replica Manager thread dies and does not recover
#9303	C API fails with HTTP protocol error in some circumstances.
#9315	R-GMA components don't follow agreed naming convention for service type
#9366	R-GMA gin sends logs partly to console and not to log file
#9405	The rgma command line tool sets its PYTHONPATH incorrectly
#9406	The rgma python api RPM does not clean up after itself
#9539	LatestProducer created by python API has zero min retention period
#9544	Gin publishes tuples regardless of whether they have changed or not
#9606	Python RGMA exception incorrectly mapped when using reconnect() method
#9744	fatal error reported by java api when in insecure mode
#9792	Archiver does not recreate its Consumers when they die
#10030	history retention period for Secondary Producer does not work as expected
#10036	R-GMA API has functions which need to be modified or removed
#10048	Python API socket leak
#10109	Flexy uses old API and is not flexible
#10238	Archiver producer buffer fills up
#10608	Missing TRUSTFILE initialisation for the glue-archiver

5.3. 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
#7916	"glite-rgma-client_installer.sh if –n $basedir; then"
#8794	ConnectionTimeOutExceptions are passed back to the producer client
#10207	FTS: rgma service discovery configuration fails
#10217	Bad location of the wsdl file as required by glite-rgma-servicetool-serviceName.cfg.xml ?
#10254	getting hostname on machines with two network cards
#10626	service discovery consistent rgma strategy needed