edu.isi.pegasus.planner.catalog.replica.impl

Class RLI

java.lang.Object

edu.isi.pegasus.planner.catalog.replica.impl.RLI

All Implemented Interfaces:

Catalog, ReplicaCatalog

public class RLI
extends Object
implements ReplicaCatalog

This class implements the VDS replica catalog interface on top of RLI API. A thing to take care of is that all delete and remove operations are propoagated to all the Local Replica Catalogs (LRCs) reporting to the RLI. Hence, you should be careful while deleting LFNs, as deletions can cascade to multiple LRCs. If you want to delete or remove an LFN from a particular LRC, use the LRC implementation to connect to that LRC and call the corresponding delete functions on that. There is no transaction support in the implementation. The implementation is best effort. Inconsistencies can occur if one of the LRCs goes offline, or an operation fails for whatsoever reason.

Version:

$Revision$

Author:

Karan Vahi, Gaurang Mehta

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_RLI_TIMEOUT The default timeout in seconds to be used while querying the RLI.
static String	LRC_IGNORE_KEY The key that is used to designate the LRC whose results are to be ignored.
static String	LRC_NOT_CONNECTED_MSG The error message for not connected to LRC.
static int	LRC_QUERY_IGNORE The LRC query state indicating that LRC has to be ignored.
static int	LRC_QUERY_NORMAL The LRC query state indicating that LRC needs to queried fully.
static int	LRC_QUERY_RESTRICT The LRC query state indicating that LRC has to be restricted query.
static String	LRC_RESTRICT_KEY The key that is used to designate the LRC whose results are to be restricted.
private int	mBatchSize The batch size while querying the RLI in the bulk mode.
private Properties	mConnectProps The properties object containing all the properties, that are required to connect to a RLS.
private LogManager	mLogger The handle to the logging object.
private String	mLogMsg The string holding the message that is logged in the logger.
private String[]	mLRCIgnoreList A String array contains the LRC URLs that have to be ignored for querying.
private String[]	mLRCRestrictList A String array contains the LRC URLs that have to be restricted for querying.
private org.globus.replica.rls.RLSClient.RLI	mRLI The handle to the client that allows access to the LRC running at the url specified while connecting.
private String	mRLIURL The url to the RLI to which this instance implementation talks to.
private org.globus.replica.rls.RLSClient	mRLS The handle to the client that allows access to both the RLI and the LRC running at the url specified while connecting.
private int	mTimeout The timeout in seconds to be applied while querying the RLI.
static String	PROXY_KEY The key that if set, specifies the proxy to be picked up while connecting to the RLS.
static String	RLI_NOT_CONNECTED_MSG The error message for not connected to RLI.
static String	RLI_TIMEOUT_KEY The key that is used to get hold of the timeout value from the properties object.
static int	RLS_BULK_QUERY_SIZE The number of entries searched in each bulk query to RLS.
static String	RLS_TIMEOUT_KEY The key that is used to get hold of the timeout value from the properties object.
static String	SITE_ATTRIBUTE The attribute in RLS that maps to a site handle.
static String	URL_KEY The key that is used to get hold of the url from the properties object.

Fields inherited from interface edu.isi.pegasus.planner.catalog.ReplicaCatalog

BATCH_KEY, c_prefix, DB_PREFIX

Fields inherited from interface edu.isi.pegasus.planner.catalog.Catalog

DB_ALL_PREFIX

Constructor Summary

Constructors

Constructor and Description
RLI() The default constructor, that creates an object which is not linked with any RLS.

Method Summary

Methods

Modifier and Type	Method and Description
int	clear() Removes everything from all the LRCs that report to this RLI.
void	close() Explicitely free resources before the garbage collection hits.
boolean	connect(Properties props) Establishes a connection to the RLI.
boolean	connect(String url) Establishes a connection to the RLI, picking up the proxy from the default location usually /tmp/ directory.
boolean	connect(String url, String proxy) Establishes a connection to the RLI.
int	delete(Map x, boolean matchAttributes) Deletes multiple mappings into the replica catalog.
int	delete(String lfn, ReplicaCatalogEntry tuple) Deletes a very specific mapping from the replica catalog.
int	delete(String lfn, String pfn) Deletes a specific mapping from the replica catalog.
int	delete(String lfn, String name, Object value) Deletes all PFN entries for a given LFN from the replica catalog where the PFN attribute is found, and matches exactly the object value.
int	deleteByResource(String lfn, String handle) Deletes all PFN entries for a given LFN from the replica catalog where the resource handle is found.
private int	determineQueryType(String url) Returns a tri state indicating what type of query needs to be done to a particular LRC.
protected int	getBatchSize() Returns the number of lfns in each batch while querying the lrc in the bulk mode.
org.globus.replica.rls.RLSClient.LRC	getLRC() Gets a handle to the LRC that is associated with the RLS running at url.
private Map	getLRC2LFNS(Set lfns) Returns a map indexed by lrc urls.
private Set	getReportingLRC() Retrieves the URLs of all the LRCs that report to the RLI.
org.globus.replica.rls.RLSClient.RLI	getRLI() Gets a handle to the RLI that is associated with the RLS running at url.
protected String[]	getRLSLRCIgnoreURLs(Properties properties) Returns the rls LRC urls to ignore for querying (requested by LIGO).
protected String[]	getRLSLRCRestrictURLs(Properties properties) Returns the rls LRC urls to restrict for querying (requested by LIGO).
int	getTimeout(Properties properties) It returns the timeout value in seconds after which to timeout in case of no activity from the RLI.
int	insert(Map x) Inserts multiple mappings into the replica catalog.
int	insert(String lfn, ReplicaCatalogEntry tuple) Inserts a new mapping into the LRC running at the URL, where the RLI is running.
int	insert(String lfn, String pfn, String handle) Inserts a new mapping into the LRC running at the URL, where the RLI is running.
boolean	isClosed() Returns whether the connection to the RLS with which this instance is associated is closed or not.
Set	list() Lists all logical filenames in the catalog.
Set	list(String constraint) Lists a subset of all logical filenames in the catalog.
Map	lookup(Map constraints) Retrieves multiple entries for a given logical filename, up to the complete catalog.
Map	lookup(Set lfns) Retrieves multiple entries for a given logical filename, up to the complete LRC.
Map	lookup(Set lfns, String handle) Retrieves multiple entries for a given logical filenames, up to the complete catalog.
Collection	lookup(String lfn) Retrieves all entries for a given LFN from the replica catalog.
String	lookup(String lfn, String handle) Retrieves the entry for a given filename and resource handle from the RLS.
Map	lookupNoAttributes(Set lfns) Retrieves all entries for a given LFN from the replica catalog.
Map	lookupNoAttributes(Set lfns, String handle) Retrieves multiple entries for a given logical filename, up to the complete catalog.
Set	lookupNoAttributes(String lfn) Retrieves all entries for a given LFN from the replica catalog.
static void	main(String[] args) The main program, for some unit testing.
int	remove(Set lfns) Removes all mappings for a set of LFNs.
int	remove(String lfn) Removes all mappings for an LFN from the replica catalog.
int	removeByAttribute(String handle) Removes all entries associated with a particular resource handle.
int	removeByAttribute(String name, Object value) Removes all entries from the replica catalog where the PFN attribute is found, and matches exactly the object value.
protected void	setBatchSize(Properties properties) Sets the number of lfns in each batch while querying the lrc in the bulk mode.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

RLS_BULK_QUERY_SIZE

public static final int RLS_BULK_QUERY_SIZE

The number of entries searched in each bulk query to RLS.

See Also:

Constant Field Values

DEFAULT_RLI_TIMEOUT

public static final String DEFAULT_RLI_TIMEOUT

The default timeout in seconds to be used while querying the RLI.

See Also:

Constant Field Values

RLS_TIMEOUT_KEY

public static final String RLS_TIMEOUT_KEY

The key that is used to get hold of the timeout value from the properties object.

See Also:

Constant Field Values

RLI_TIMEOUT_KEY

public static final String RLI_TIMEOUT_KEY

The key that is used to get hold of the timeout value from the properties object.

See Also:

Constant Field Values

LRC_IGNORE_KEY

public static final String LRC_IGNORE_KEY

The key that is used to designate the LRC whose results are to be ignored.

See Also:

Constant Field Values

LRC_RESTRICT_KEY

public static final String LRC_RESTRICT_KEY

The key that is used to designate the LRC whose results are to be restricted.

See Also:

Constant Field Values

SITE_ATTRIBUTE

public static final String SITE_ATTRIBUTE

The attribute in RLS that maps to a site handle.

See Also:

Constant Field Values

URL_KEY

public static final String URL_KEY

The key that is used to get hold of the url from the properties object.

See Also:

Constant Field Values

PROXY_KEY

public static final String PROXY_KEY

The key that if set, specifies the proxy to be picked up while connecting to the RLS.

See Also:

Constant Field Values

RLI_NOT_CONNECTED_MSG

public static final String RLI_NOT_CONNECTED_MSG

The error message for not connected to RLI.

See Also:

Constant Field Values

LRC_NOT_CONNECTED_MSG

public static final String LRC_NOT_CONNECTED_MSG

The error message for not connected to LRC.

See Also:

Constant Field Values

LRC_QUERY_NORMAL

public static final int LRC_QUERY_NORMAL

The LRC query state indicating that LRC needs to queried fully. The LRC returns all PFNs irrespective of whether they have a site attribute or not.

See Also:

Constant Field Values

LRC_QUERY_RESTRICT

public static final int LRC_QUERY_RESTRICT

The LRC query state indicating that LRC has to be restricted query. LRC should return only PFNs with site attributes tagged.

See Also:

Constant Field Values

LRC_QUERY_IGNORE

public static final int LRC_QUERY_IGNORE

The LRC query state indicating that LRC has to be ignored.

See Also:

Constant Field Values

mRLS

private org.globus.replica.rls.RLSClient mRLS

The handle to the client that allows access to both the RLI and the LRC running at the url specified while connecting.

mRLI

private org.globus.replica.rls.RLSClient.RLI mRLI

The handle to the client that allows access to the LRC running at the url specified while connecting.

mRLIURL

private String mRLIURL

The url to the RLI to which this instance implementation talks to.

mLRCIgnoreList

private String[] mLRCIgnoreList

A String array contains the LRC URLs that have to be ignored for querying.

mLRCRestrictList

private String[] mLRCRestrictList

A String array contains the LRC URLs that have to be restricted for querying. Only those entries are returned that have a site attribute associated with them.

mLogger

private LogManager mLogger

The handle to the logging object. Should be log4j soon.

mLogMsg

private String mLogMsg

The string holding the message that is logged in the logger.

mConnectProps

private Properties mConnectProps

The properties object containing all the properties, that are required to connect to a RLS.

mBatchSize

private int mBatchSize

The batch size while querying the RLI in the bulk mode.

mTimeout

private int mTimeout

The timeout in seconds to be applied while querying the RLI.

Constructor Detail

RLI

public RLI()

The default constructor, that creates an object which is not linked with any RLS. Use the connect method to connect to the RLS.

See Also:

connect(Properties).

Method Detail

connect

public boolean connect(String url)

Establishes a connection to the RLI, picking up the proxy from the default location usually /tmp/ directory.

Parameters:

url - the url to lrc to connect to.

Returns:

true if connected now, or false to indicate a failure.

connect

public boolean connect(Properties props)

Establishes a connection to the RLI.

Specified by:

connect in interface Catalog

Parameters:

props - contains all necessary data to establish the link.

Returns:

true if connected now, or false to indicate a failure.

connect

public boolean connect(String url,
              String proxy)

Establishes a connection to the RLI.

Parameters:

url - the url to lrc to connect to.

proxy - the path to the proxy file to be picked up. null denotes default location.

Returns:

true if connected now, or false to indicate a failure.

getRLI

public org.globus.replica.rls.RLSClient.RLI getRLI()

Gets a handle to the RLI that is associated with the RLS running at url.

Returns:

RLSClient.RLI that points to the RLI that is running , or null in case connect method not being called.

See Also:

mRLIURL

getLRC

public org.globus.replica.rls.RLSClient.LRC getLRC()

Gets a handle to the LRC that is associated with the RLS running at url.

Returns:

RLSClient.LRC that points to the RLI that is running , or null in case connect method not being called.

See Also:

mRLIURL

lookup

public String lookup(String lfn,
            String handle)

Retrieves the entry for a given filename and resource handle from the RLS.

Specified by:

lookup in interface ReplicaCatalog

Parameters:

lfn - is the logical filename to obtain information for.

handle - is the resource handle to obtain entries for.

Returns:

the (first) matching physical filename, or null if no match was found.

lookup

public Collection lookup(String lfn)

Retrieves all entries for a given LFN from the replica catalog. Each entry in the result set is a tuple of a PFN and all its attributes.

Specified by:

lookup in interface ReplicaCatalog

Parameters:

lfn - is the logical filename to obtain information for.

Returns:

a collection of replica catalog entries, or null in case of unable to connect to RLS.

See Also:

ReplicaCatalogEntry

lookupNoAttributes

public Set lookupNoAttributes(String lfn)

Retrieves all entries for a given LFN from the replica catalog. Each entry in the result set is just a PFN string. Duplicates are reduced through the set paradigm.

Specified by:

lookupNoAttributes in interface ReplicaCatalog

Parameters:

lfn - is the logical filename to obtain information for.

Returns:

a set of PFN strings, or null in case of unable to connect to RLS.

lookup

public Map lookup(Set lfns)

Retrieves multiple entries for a given logical filename, up to the complete LRC. It uses the bulk query api to the LRC to query for stuff. Bulk query has been in RLS since version 2.0.8. Internally, the bulk queries are done is sizes specified by variable mBatchSize.

Specified by:

lookup in interface ReplicaCatalog

Parameters:

lfns - is a set of logical filename strings to look up.

Returns:

a map indexed by the LFN. Each value is a collection of replica catalog entries for the LFN.

See Also:

ReplicaCatalogEntry, getBatchSize()

lookupNoAttributes

public Map lookupNoAttributes(Set lfns)

Retrieves all entries for a given LFN from the replica catalog. Each entry in the result set is just a PFN string. Duplicates are reduced through the set paradigm.

Specified by:

lookupNoAttributes in interface ReplicaCatalog

Parameters:

lfns - is a set of logical filename strings to look up.

Returns:

a map indexed by the LFN. Each value is a collection of PFN's for the LFN.

lookup

public Map lookup(Set lfns,
         String handle)

Retrieves multiple entries for a given logical filenames, up to the complete catalog. Retrieving full catalogs should be harmful, but may be helpful in online display or portal.

Specified by:

lookup in interface ReplicaCatalog

Parameters:

lfns - is a set of logical filename strings to look up.

handle - is the resource handle, restricting the LFNs.

Returns:

a map indexed by the LFN. Each value is a collection of replica catalog entries (all attributes).

See Also:

ReplicaCatalogEntry

lookupNoAttributes

public Map lookupNoAttributes(Set lfns,
                     String handle)

Retrieves multiple entries for a given logical filename, up to the complete catalog. Retrieving full catalogs should be harmful, but may be helpful in online display or portal.

The noAttributes flag is missing on purpose, because due to the resource handle, attribute lookups are already required.

Specified by:

lookupNoAttributes in interface ReplicaCatalog

Parameters:

lfns - is a set of logical filename strings to look up.

handle - is the resource handle, restricting the LFNs.

Returns:

a map indexed by the LFN. Each value is a set of physical filenames.

lookup

public Map lookup(Map constraints)

Retrieves multiple entries for a given logical filename, up to the complete catalog. Retrieving full catalogs should be harmful, but may be helpful in online display or portal.

At present it DOES NOT SUPPORT ATTRIBUTE MATCHING.

Specified by:

lookup in interface ReplicaCatalog

Parameters:

constraints - is mapping of keys 'lfn', 'pfn' to a string that has some meaning to the implementing system. This can be a SQL wildcard for queries, or a regular expression for Java-based memory collections. Unknown keys are ignored. Using an empty map requests the complete catalog.

Returns:

a map indexed by the LFN. Each value is a collection of replica catalog entries.

See Also:

ReplicaCatalogEntry

list

public Set list()

Lists all logical filenames in the catalog.

Specified by:

list in interface ReplicaCatalog

Returns:

A set of all logical filenames known to the catalog.

list

public Set list(String constraint)

Lists a subset of all logical filenames in the catalog.

Specified by:

list in interface ReplicaCatalog

Parameters:

constraint - is a constraint for the logical filename only. It is a string that has some meaning to the implementing system. This can be a SQL wildcard for queries, or a regular expression for Java-based memory collections.

Returns:

A set of logical filenames that match. The set may be empty

insert

public int insert(String lfn,
         ReplicaCatalogEntry tuple)

Inserts a new mapping into the LRC running at the URL, where the RLI is running.

Specified by:

insert in interface ReplicaCatalog

Parameters:

lfn - is the logical filename under which to book the entry.

tuple - is the physical filename and associated PFN attributes.

Returns:

number of insertions, should always be 1. On failure, throws a RuntimeException.

insert

public int insert(String lfn,
         String pfn,
         String handle)

Inserts a new mapping into the LRC running at the URL, where the RLI is running. This is a convenience function exposing the resource handle. Internally, the ReplicaCatalogEntry element will be contructed, and passed to the appropriate insert function.

Specified by:

insert in interface ReplicaCatalog

Parameters:

lfn - is the logical filename under which to book the entry.

pfn - is the physical filename associated with it.

handle - is a resource handle where the PFN resides.

Returns:

number of insertions, should always be 1. On failure, throws a RuntimeException.

See Also:

insert( String, ReplicaCatalogEntry ), ReplicaCatalogEntry

insert

public int insert(Map x)

Inserts multiple mappings into the replica catalog. The input is a map indexed by the LFN. The value for each LFN key is a collection of replica catalog entries.

Specified by:

insert in interface ReplicaCatalog

Parameters:

x - is a map from logical filename string to list of replica catalog entries.

Returns:

the number of insertions.

See Also:

ReplicaCatalogEntry

delete

public int delete(String lfn,
         String pfn)

Deletes a specific mapping from the replica catalog. We don't care about the resource handle. More than one entry could theoretically be removed. Upon removal of an entry, all attributes associated with the PFN also evaporate (cascading deletion). It can result in a deletion of more than one entry, and from more than one local replica catalog that might be reporting to the RLI.

Specified by:

delete in interface ReplicaCatalog

Parameters:

lfn - is the logical filename in the tuple.

pfn - is the physical filename in the tuple.

Returns:

the number of removed entries.

delete

public int delete(String lfn,
         ReplicaCatalogEntry tuple)

Deletes a very specific mapping from the replica catalog. The LFN must be matches, the PFN, and all PFN attributes specified in the replica catalog entry. More than one entry could theoretically be removed. Upon removal of an entry, all attributes associated with the PFN also evaporate (cascading deletion). It can result in a deletion of more than one entry, and from more than one local replica catalog that might be reporting to the RLI.

Specified by:

delete in interface ReplicaCatalog

Parameters:

lfn - is the logical filename in the tuple.

tuple - is a description of the PFN and its attributes.

Returns:

the number of removed entries, either 0 or 1.

delete

public int delete(String lfn,
         String name,
         Object value)

Deletes all PFN entries for a given LFN from the replica catalog where the PFN attribute is found, and matches exactly the object value. This method may be useful to remove all replica entries that have a certain MD5 sum associated with them. It may also be harmful overkill. It can result in a deletion of more than one entry, and from more than one local replica catalog that might be reporting to the RLI.

Specified by:

delete in interface ReplicaCatalog

Parameters:

lfn - is the logical filename to look for.

name - is the PFN attribute name to look for.

value - is an exact match of the attribute value to match.

Returns:

the number of removed entries.

deleteByResource

public int deleteByResource(String lfn,
                   String handle)

Deletes all PFN entries for a given LFN from the replica catalog where the resource handle is found. Karan requested this convenience method, which can be coded like

  delete( lfn, SITE_ATTRIBUTE, handle )
 

It can result in a deletion of more than one entry, and from more than one local replica catalog that might be reporting to the RLI.

Specified by:

deleteByResource in interface ReplicaCatalog

Parameters:

lfn - is the logical filename to look for.

handle - is the resource handle

Returns:

the number of entries removed.

delete

public int delete(Map x,
         boolean matchAttributes)

Deletes multiple mappings into the replica catalog. The input is a map indexed by the LFN. The value for each LFN key is a collection of replica catalog entries. On setting matchAttributes to false, all entries having matching lfn pfn mapping to an entry in the Map are deleted. However, upon removal of an entry, all attributes associated with the pfn also evaporate (cascaded deletion). The deletes are done in batches.

Specified by:

delete in interface ReplicaCatalog

Parameters:

x - is a map from logical filename string to list of replica catalog entries.

matchAttributes - whether mapping should be deleted only if all attributes match.

Returns:

the number of deletions.

See Also:

ReplicaCatalogEntry

remove

public int remove(String lfn)

Removes all mappings for an LFN from the replica catalog. It can result in a deletion of more than one entry, and from more than one local replica catalog that might be reporting to the RLI.

Specified by:

remove in interface ReplicaCatalog

Parameters:

lfn - is the logical filename to remove all mappings for.

Returns:

the number of removed entries.

remove

public int remove(Set lfns)

Removes all mappings for a set of LFNs. It can result in a deletion of more than one entry, and from more than one local replica catalog that might be reporting to the RLI.

Specified by:

remove in interface ReplicaCatalog

Parameters:

lfns - is a set of logical filename to remove all mappings for.

Returns:

the number of removed entries.

removeByAttribute

public int removeByAttribute(String name,
                    Object value)

Removes all entries from the replica catalog where the PFN attribute is found, and matches exactly the object value. It can result in a deletion of more than one entry, and from more than one local replica catalog that might be reporting to the RLI.

Specified by:

removeByAttribute in interface ReplicaCatalog

Parameters:

name - is the PFN attribute name to look for.

value - is an exact match of the attribute value to match.

Returns:

the number of removed entries.

removeByAttribute

public int removeByAttribute(String handle)

Removes all entries associated with a particular resource handle. This is useful, if a site goes offline. It is a convenience method, which calls the generic removeByAttribute method. It can result in a deletion of more than one entry, and from more than one local replica catalog that might be reporting to the RLI.

Specified by:

removeByAttribute in interface ReplicaCatalog

Parameters:

handle - is the site handle to remove all entries for.

Returns:

the number of removed entries.

See Also:

removeByAttribute( String, Object )

clear

public int clear()

Removes everything from all the LRCs that report to this RLI. Use with caution!

Specified by:

clear in interface ReplicaCatalog

Returns:

the number of removed entries.

close

public void close()

Explicitely free resources before the garbage collection hits.

Specified by:

close in interface Catalog

isClosed

public boolean isClosed()

Returns whether the connection to the RLS with which this instance is associated is closed or not.

Specified by:

isClosed in interface Catalog

Returns:

true, if the implementation is disassociated, false otherwise.

See Also:

close()

getTimeout

public int getTimeout(Properties properties)

It returns the timeout value in seconds after which to timeout in case of no activity from the RLI. Referred to by the "rli.timeout" property.

Parameters:

properties - the properties passed in the connect method.

Returns:

the timeout value if specified else, the value specified by "rls.timeout" property, else DEFAULT_RLI_TIMEOUT.

See Also:

DEFAULT_RLI_TIMEOUT

setBatchSize

protected void setBatchSize(Properties properties)

Sets the number of lfns in each batch while querying the lrc in the bulk mode.

Parameters:

properties - the properties passed while connecting.

getBatchSize

protected int getBatchSize()

Returns the number of lfns in each batch while querying the lrc in the bulk mode.

Returns:

the batch size.

getLRC2LFNS

private Map getLRC2LFNS(Set lfns)

Returns a map indexed by lrc urls. Each value is a set of String objects referring to the logical filenames whose mappings reside at a particular lrc amongst the set of logical filenames passed.

Parameters:

lfns - the set of lfns queried to the RLI.

Returns:

Map indexed by lrc urls. Each value is a set of lfn strings. null in case the connection to RLI is closed or error.

determineQueryType

private int determineQueryType(String url)

Returns a tri state indicating what type of query needs to be done to a particular LRC.

Parameters:

url - the LRC url.

Returns:

tristate

getRLSLRCIgnoreURLs

protected String[] getRLSLRCIgnoreURLs(Properties properties)

Returns the rls LRC urls to ignore for querying (requested by LIGO). Referred to by the "pegasus.catalog.replica.lrc.ignore" property.

Parameters:

properties - the properties passed in the connect method.

Returns:

String[] if a comma separated list supplied as the property value, else null

getRLSLRCRestrictURLs

protected String[] getRLSLRCRestrictURLs(Properties properties)

Returns the rls LRC urls to restrict for querying (requested by LIGO). Referred to by the "pegasus.catalog.replica.lrc.restrict" property.

Parameters:

properties - the properties passed in the connect method.

Returns:

String[] if a comma separated list supplied as the property value, else null

getReportingLRC

private Set getReportingLRC()

Retrieves the URLs of all the LRCs that report to the RLI.

Returns:

a Set containing the URLs to all the LRCs that report to the RLI.

main

public static void main(String[] args)

The main program, for some unit testing.

Parameters:

args - String[]