gLite Data Management Single Catalog for Oracle (Fireman)

1. Release Description

This release contains the gLite Data Management Single Catalog (Fireman) for Oracle module v. 2.1.3. 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 Data Management Single Catalog, please refer to the gLite Installation and User Guides.

2. Changes in this release

2.1. Changes in functionality

This release introduces the following changes:

All queries including symlinks handler pattern have been changed
Error messages concerning symlink looping are more descriptive
More symlink related error obscurities fixed (getlfnforguid)
Configuration script uses new VO configuration method
Added an Oracle internal bug workaround when optimizer nullifies result of function for aliases in query when database is nearly empty

2.2. Changes in Configuration

It is not necessary anymore to define a separate Fireman instance for each VO. There is a single instance in the configuration file that is used to iterate automatically over all the VOs defined in the VO list. All VO-specific parameters have been moved to the vo-list.cfg.xml file.

No new parameters have been added to the glite-data-single-catalog-oracle.cfg.xml file:

No parameters have been changed in the glite- data-single-catalog-oracle.cfg.xml file:

All parameters used to set VO-specific values have been removed from the service configuration files and moved to a dedicated VO configuration file called vo-list.cfg.xml. A template is available in /opt/glite/etc/config/templates. This file is common to all gLite services running on this node or referenced in the same site-config file (unless locally overridden). For more information please refer to the gLite 1.5 installation guide.

The R-GMA Service Publisher (aka R-GMA servicetool) parameters are now automatically handled by the configuration script and do not need to be explicitly set anymore in the configuration file. The parameters can be set in the configuration file to override the default values.

3. Release contents

3.1. Glite sub-deployment modules

The gLite Data Management Single Catalog (Fireman) for Oracle module includes the following sub-modules:

- gLite Security Utilities

- gLite R-GMA Servicetool

The sub-modules are automatically installed with the Fireman module. For more information about these sub-modules please refer to the specific release notes and installation instructions.

3.2. Glite RPMS

The gLite Data Management Single Catalog for Oracle v. 2.1.3 is composed of the following gLite components:

Component name	Description	Version	File
glite-config	gLite configuration scripts	1.6.22	../../../../../../../glite-web/egee/packages/R1.5/R20051130/bin/rhel30/noarch/RPMS/glite-config-1.6.20-2.noarch.rpm
glite-data-catalog-service-fr	gLite Data Catalog Service (Oracle version)	2.1.15	../../../../../../../glite-web/egee/packages/R1.5/R20051130/bin/rhel30/noarch/RPMS/glite-data-catalog-service-fr-2.1.15-1.noarch.rpm
glite-data-common	common files for gLite Data Management web-services	1.2.2	../../../../../../../glite-web/egee/packages/R1.5/R20051130/bin/rhel30/noarch/RPMS/glite-data-common-1.2.2-1.noarch.rpm
glite-data-single-catalog-oracle-config	gLite Single Catalog for Oracle configuration files	2.1.3	../../../../../../../glite-web/egee/packages/R1.5/R20051130/bin/rhel30/noarch/RPMS/glite-data-single-catalog-oracle-config-2.1.3-1.noarch.rpm
glite-rgma-servicetool-config	gLite R-GMA servicetool installation	5.2.2	../../../../../../../glite-web/egee/packages/R1.5/R20051130/bin/rhel30/noarch/RPMS/glite-rgma-servicetool-config-5.2.2-1.noarch.rpm
glite-security-utils-config	gLite Security Utilities configuration files	1.2.2	../../../../../../../glite-web/egee/packages/R1.5/R20051130/bin/rhel30/noarch/RPMS/glite-security-utils-config-1.2.2-1.noarch.rpm

4. Dependencies

The gLite Data Management Single Catalog module has the following dependencies:

Component name	Description	Version	File
j2re	Java JRE	1.4.2	../../../../../../../glite-web/egee/packages/externals/bin/rhel30/RPMS/j2re-1_4_2_08-linux-i586.rpm
tomcat5	Tomcat application server	5.0.28	../../../../../../../glite-web/egee/packages/externals/bin/rhel30/RPMS/tomcat5-5.0.28-11_EGEE.noarch.rpm
Oracle InstantClient	Orcale instantclient libraries and tools	>=10.1.0.3	http://www.oracle.com/technology/software/tech/oci/instantclient/htdocs/linuxsoft.html

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 .

Dead links inside Fireman Catalog after a failed glite-put.
It’s possible to have some dead links inside the Fireman catalog if there are some glite-put that end with errors.
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
#7857	Fireman Oracle: rename() throws InternalException
#8694	Fireman: Default group in Fireman
#9033	Catalog CLI: it is not possible to submit bulk create requests
#10492	SC-ORA: after running --remove the schema cannot be re-created
#10493	SC-ORA: if two VOs use the same back-end the configuration of the second fails
#10535	Fireman Documentation: Examples in DM catalog c and c++ api do not work
#10544	SC-ORA: If the connection parameters are wrong the installation script gets stuck
#10605	Fireman Oracle: find returns wrong paths
#12186	In the 1.4 Mysql Single Catalog Release Notes the file glite-io-client.cfg.xml is wrongly mentioned
#12233	Fireman: testGetGuidLfnMethods on api-java
#13523	Fireman Oracle: Cannot change permissions on '/'
#13535	Fireman Oracle: Some users with privileges cannot create directories

The following bugs have been fixed in this or previous releases, but not yet tested:

Bug number	Description
#5581	Cannot remove files from the catalog
#5633	Fireman catalog: "java.lang.reflect.InvocationTargetException" during bulk creation of entries
#5723	Fireman catalog: "500 Internal Server Error" response to readDir call after killing a client during a bulk create call
#5923	Fireman catalog: Exceptions while creating entries (via bulks) with 10 clients simultaneously
#6468	Perl interfaces to the Fireman and Transfer loose parameters in the functions
#7256	data-catalog-api-c-2.0.0 let me create twice the same entry in the catalog
#7669	Oracle Fireman: create() sometimes fails
#7730	Fireman: glite-catalog-ls returns different message for MySQL and Oracle catalog when dir doesn't exist
#7806	oracle catalogue isntallation with apt fails
#7859	Problems with ACLs
#7993	option parsing of glite-catalog-find
#8054	Fireman: Problem with metadata commands
#8060	Problem with glite-catalog-chkperm
#10312	In the release notes of the glite data single catalog for oracle there is no mention of the new parameters
#10336	Data Single Catalog: no mention to voms in the documentation
#10470	Fireman Oracle: impossible to upgrade from R1.3 to R1.4
#10659	Fireman Oracle: fm_oracle_clean.sql does not remove the schema in some particular cases
#11649	glite-catalog crashes when using double VO voms certificate
#12642	Fireman Oracle: Cannot do / operations when DB is empty

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
#6657	Fireman Service SOAP Error
#6730	LFN normalisation needs to be done in Fireman catalogs
#6731	if inserting a file into the root directory, two slashes are used for the filename instead of one
#6861	Incorrect error message from glite-catalog-ls command
#7078	Fireman-Oracle: Wrong date for newly created file
#7166	Cannot create parent directories
#7238	glite-catalog-rmdir doesn't produce a exception when directory is not empty
#7690	problem with glite-catalog-ls
#7785	FR_TEST.PERMISSION_UTIL not found in oracle catalogue installation
#7833	Problem with glite-catalog-mv
#8056	Problem with default user / owner and basic permissions.
#8057	Problem with glite-catalog-chmod
#8416	glite-catalog-find returns all entries
#8437	Not possible to create dirs/files in Fireman catalog in secure mode
#8438	glite-catalog-chkperm (MySQL version) only checks user permissions
#8452	FireMan Oracle: Timeouts with large number of clients
#8516	Java User Guide for the Fireman Catalog
#8728	SC-ORA: database password shipped in clear in command line
#8769	Fireman Oracle: Cannot create symlinks
#8832	Failed to setPermission with Oracle database?
#8982	Unable use of Oracle Fireman catalog from UI
#9205	Fireman should not limit the length of the DN
#9535	Fireman Oracle: glite-catalog-mkdir ignores -p parameter and returns \'Invalid parent specified\'
#9678	Fireman Oracle: default group and other rights for dirs should be modified
#9679	Fireman Oracle: default rights of files should be modified.
#9727	SC Oracle deployment: 3 fixes needed
#9790	Fireman Oracle: 'fm_oracle_get-version.sql' doesn't return NULL when there is no schema
#9820	Information on schema change missing in release notes for Fireman
#10234	Can\'t reuse the LFN if in previous try the copy failed with this LFN
#10373	glite-catalog-ls fails when quering a mysql single catalog
#10472	Fireman Oracle: impossible to do a glite-put
#10501	SC-ORA: The db PASSWORD is shipped in clear in the log files
#10538	glite-catalog commands segfault without valid VOMS proxy
#10606	Can't create symlinks
#10726	Fireman Oracle: set VOMS group with create()
#10770	glite-catalog-setacl passes exisiting acl in when run with '-m' option
#10857	glite-catalog-ls crashes if no proxy init
#13323	Fireman Oracle: wrong error message using glite-catalog-mkdir
#13339	Fireman Oracle: impossible to create new directories
#13357	Fireman Oracle: cannot write in my own directory