class TransformationPlugin( PluginBase ):
""" A TransformationPlugin object should be instantiated by every transformation.
"""
def __init__( self, plugin, transClient = None, dataManager = None ):
""" plugin name has to be passed in: it will then be executed as one of the functions below, e.g.
plugin = 'BySize' will execute TransformationPlugin('BySize')._BySize()
"""
super( TransformationPlugin, self ).__init__( plugin )
self.data = {}
self.files = False
self.startTime = time.time()
if transClient is None:
transClient = TransformationClient()
if dataManager is None:
dataManager = DataManager()
self.util = PluginUtilities( plugin, transClient, dataManager )
def __del__( self ):
self.util.logInfo( "Execution finished, timing: %.3f seconds" % ( time.time() - self.startTime ) )
def isOK( self ):
self.valid = True
if ( not self.data ) or ( not self.params ):
self.valid = False
return self.valid
def setParameters( self, params ):
""" Need to pass parameters also to self.util
"""
self.params = params
self.util.setParameters(params)
def setInputData( self, data ):
self.data = data
self.util.logDebug( "Set data: %s" % self.data )
def setTransformationFiles( self, files ): # TODO ADDED
self.files = files
def _Standard( self ):
""" Simply group by replica location (if any)
"""
return self.util.groupByReplicas( self.data, self.params['Status'] )
def _BySize( self ):
""" Alias for groupBySize
"""
return self._groupBySize()
def _groupBySize( self, files = None ):
"""
Generate a task for a given amount of data at a (set of) SE
"""
if not files:
files = self.data
else:
files = dict( zip( files, [self.data[lfn] for lfn in files] ) )
return self.util.groupBySize( files, self.params['Status'] )
def _Broadcast( self ):
""" This plug-in takes files found at the sourceSE and broadcasts to all (or a selection of) targetSEs.
"""
if not self.params:
return S_ERROR( "TransformationPlugin._Broadcast: The 'Broadcast' plugin requires additional parameters." )
targetseParam = self.params['TargetSE']
targetSEs = []
sourceSEs = eval( self.params['SourceSE'] )
if targetseParam.count( '[' ):
targetSEs = eval( targetseParam )
elif isinstance( targetseParam, list ):
targetSEs = targetseParam
else:
targetSEs = [targetseParam]
# sourceSEs = eval(self.params['SourceSE'])
# targetSEs = eval(self.params['TargetSE'])
destinations = int( self.params.get( 'Destinations', 0 ) )
if destinations and ( destinations >= len( targetSEs ) ):
destinations = 0
status = self.params['Status']
groupSize = self.params['GroupSize'] # Number of files per tasks
fileGroups = getFileGroups( self.data ) # groups by SE
targetSELfns = {}
for replicaSE, lfns in fileGroups.items():
ses = replicaSE.split( ',' )
# sourceSites = self._getSitesForSEs(ses)
atSource = False
for se in ses:
if se in sourceSEs:
atSource = True
if not atSource:
continue
for lfn in lfns:
targets = []
sources = self._getSitesForSEs( ses )
random.shuffle( targetSEs )
for targetSE in targetSEs:
site = self._getSiteForSE( targetSE )['Value']
if not site in sources:
if ( destinations ) and ( len( targets ) >= destinations ):
continue
sources.append( site )
targets.append( targetSE ) # after all, if someone wants to copy to the source, it's his choice
strTargetSEs = str.join( ',', sorted( targets ) )
if not targetSELfns.has_key( strTargetSEs ):
targetSELfns[strTargetSEs] = []
targetSELfns[strTargetSEs].append( lfn )
tasks = []
for ses, lfns in targetSELfns.items():
tasksLfns = breakListIntoChunks( lfns, groupSize )
for taskLfns in tasksLfns:
if ( status == 'Flush' ) or ( len( taskLfns ) >= int( groupSize ) ):
# do not allow groups smaller than the groupSize, except if transformation is in flush state
tasks.append( ( ses, taskLfns ) )
return S_OK( tasks )
def _ByShare( self, shareType = 'CPU' ):
""" first get the shares from the CS, and then makes the grouping looking at the history
"""
res = self._getShares( shareType, normalise = True )
if not res['OK']:
return res
cpuShares = res['Value']
self.util.logInfo( "Obtained the following target shares (%):" )
for site in sorted( cpuShares.keys() ):
self.util.logInfo( "%s: %.1f" % ( site.ljust( 15 ), cpuShares[site] ) )
# Get the existing destinations from the transformationDB
res = self.util.getExistingCounters( requestedSites = cpuShares.keys() )
if not res['OK']:
self.util.logError( "Failed to get existing file share", res['Message'] )
return res
existingCount = res['Value']
if existingCount:
self.util.logInfo( "Existing site utilization (%):" )
normalisedExistingCount = self.util._normaliseShares( existingCount.copy() )
for se in sorted( normalisedExistingCount.keys() ):
self.util.logInfo( "%s: %.1f" % ( se.ljust( 15 ), normalisedExistingCount[se] ) )
# Group the input files by their existing replicas
res = self.util.groupByReplicas( self.data, self.params['Status'] )
if not res['OK']:
return res
replicaGroups = res['Value']
tasks = []
# For the replica groups
for replicaSE, lfns in replicaGroups:
possibleSEs = replicaSE.split( ',' )
# Determine the next site based on requested shares, existing usage and candidate sites
res = self._getNextSite( existingCount, cpuShares, candidates = self._getSitesForSEs( possibleSEs ) )
if not res['OK']:
self.util.logError( "Failed to get next destination SE", res['Message'] )
continue
targetSite = res['Value']
# Resolve the ses for the target site
res = getSEsForSite( targetSite )
if not res['OK']:
continue
ses = res['Value']
# Determine the selected SE and create the task
for chosenSE in ses:
if chosenSE in possibleSEs:
tasks.append( ( chosenSE, lfns ) )
if not existingCount.has_key( targetSite ):
existingCount[targetSite] = 0
existingCount[targetSite] += len( lfns )
return S_OK( tasks )
def _getShares( self, shareType, normalise = False ):
""" Takes share from the CS, eventually normalize them
"""
res = gConfig.getOptionsDict( '/Resources/Shares/%s' % shareType )
if not res['OK']:
return res
if not res['Value']:
return S_ERROR( "/Resources/Shares/%s option contains no shares" % shareType )
shares = res['Value']
for site, value in shares.items():
shares[site] = float( value )
if normalise:
shares = self.util._normaliseShares( shares )
if not shares:
return S_ERROR( "No non-zero shares defined" )
return S_OK( shares )
def _getNextSite( self, existingCount, targetShares, candidates = None ):
if candidates is None:
candidates = targetShares
# normalise the existing counts
existingShares = self.util._normaliseShares( existingCount )
# then fill the missing share values to 0
for site in targetShares:
existingShares.setdefault( site, 0.0 )
# determine which site is farthest from its share
chosenSite = ''
minShareShortFall = -float( "inf" )
for site, targetShare in targetShares.items():
if site not in candidates or not targetShare:
continue
existingShare = existingShares[site]
shareShortFall = targetShare - existingShare
if shareShortFall > minShareShortFall:
minShareShortFall = shareShortFall
chosenSite = site
return S_OK( chosenSite )
@classmethod
def _getSiteForSE( cls, se ):
""" Get site name for the given SE
"""
result = getSitesForSE( se )
if not result['OK']:
return result
if result['Value']:
return S_OK( result['Value'][0] )
return S_OK( '' )
@classmethod
def _getSitesForSEs( cls, seList ):
""" Get all the sites for the given SE list
"""
sites = []
for se in seList:
result = getSitesForSE( se )
if result['OK']:
sites += result['Value']
return sites
class TransformationPlugin(PluginBase):
""" A TransformationPlugin object should be instantiated by every transformation.
:param str plugin: A plugin name has to be passed in: it will then be executed as one of the functions below, e.g.
plugin = 'BySize' will execute TransformationPlugin('BySize')._BySize()
:param transClient: TransformationManagerClient instance
:param dataManager: DataManager instance
:param fc: FileCatalog instance
"""
def __init__(self, plugin, transClient=None, dataManager=None, fc=None):
"""Constructor of the TransformationPlugin.
Instantiate clients, if not given, and set up the PluginUtilities.
"""
super(TransformationPlugin, self).__init__(plugin)
self.data = {}
self.files = False
self.startTime = time.time()
self.valid = False
if transClient is None:
transClient = TransformationClient()
if dataManager is None:
dataManager = DataManager()
if fc is None:
fc = FileCatalog()
self.util = PluginUtilities(plugin,
transClient=transClient,
dataManager=dataManager,
fc=fc)
def __del__(self):
""" Destructor: print the elapsed time """
self.util.logInfo("Execution finished, timing: %.3f seconds" %
(time.time() - self.startTime))
def isOK(self):
""" Check if all information is present """
self.valid = True
if (not self.data) or (not self.params):
self.valid = False
return self.valid
def setParameters(self, params):
""" Need to pass parameters also to self.util
"""
self.params = params
self.util.setParameters(params)
def setInputData(self, data):
""" Set the replica information as data member """
self.data = data
def setTransformationFiles(self, files):
""" Set the TS files as data member """
self.files = files
def _Standard(self):
""" Simply group by replica location (if any)
"""
return self.util.groupByReplicas(self.data, self.params['Status'])
def _BySize(self):
""" Alias for groupBySize
"""
return self._groupBySize()
def _groupBySize(self, files=None):
"""
Generate a task for a given amount of data at a (set of) SE
"""
if not files:
files = self.data
else:
files = dict(zip(files, [self.data[lfn] for lfn in files]))
return self.util.groupBySize(files, self.params['Status'])
def _Broadcast(self):
""" This plug-in takes files found at the sourceSE and broadcasts to all (or a selection of) targetSEs.
"""
if not self.params:
return S_ERROR(
"TransformationPlugin._Broadcast: The 'Broadcast' plugin requires additional parameters."
)
targetseParam = self.params['TargetSE']
targetSEs = []
sourceSEs = eval(self.params['SourceSE']) # pylint: disable=eval-used
if targetseParam.count('['):
targetSEs = eval(targetseParam) # pylint: disable=eval-used
elif isinstance(targetseParam, list):
targetSEs = targetseParam
else:
targetSEs = [targetseParam]
# sourceSEs = eval(self.params['SourceSE'])
# targetSEs = eval(self.params['TargetSE'])
destinations = int(self.params.get('Destinations', 0))
if destinations and (destinations >= len(targetSEs)):
destinations = 0
status = self.params['Status']
groupSize = self.params['GroupSize'] # Number of files per tasks
fileGroups = getFileGroups(self.data) # groups by SE
targetSELfns = {}
for replicaSE, lfns in fileGroups.items():
ses = replicaSE.split(',')
# sourceSites = self._getSitesForSEs(ses)
atSource = False
for se in ses:
if se in sourceSEs:
atSource = True
if not atSource:
continue
for lfn in lfns:
targets = []
sources = self._getSitesForSEs(ses)
random.shuffle(targetSEs)
for targetSE in targetSEs:
site = self._getSiteForSE(targetSE)['Value']
if not site in sources:
if (destinations) and (len(targets) >= destinations):
continue
sources.append(site)
targets.append(
targetSE
) # after all, if someone wants to copy to the source, it's his choice
strTargetSEs = str.join(',', sorted(targets))
targetSELfns.setdefault(strTargetSEs, []).append(lfn)
tasks = []
for ses, lfns in targetSELfns.items():
tasksLfns = breakListIntoChunks(lfns, groupSize)
for taskLfns in tasksLfns:
if (status == 'Flush') or (len(taskLfns) >= int(groupSize)):
# do not allow groups smaller than the groupSize, except if transformation is in flush state
tasks.append((ses, taskLfns))
return S_OK(tasks)
def _ByShare(self, shareType='CPU'):
""" first get the shares from the CS, and then makes the grouping looking at the history
"""
res = self._getShares(shareType, normalise=True)
if not res['OK']:
return res
cpuShares = res['Value']
self.util.logInfo("Obtained the following target shares (%):")
for site in sorted(cpuShares.keys()):
self.util.logInfo("%s: %.1f" % (site.ljust(15), cpuShares[site]))
# Get the existing destinations from the transformationDB
res = self.util.getExistingCounters(requestedSites=cpuShares.keys())
if not res['OK']:
self.util.logError("Failed to get existing file share",
res['Message'])
return res
existingCount = res['Value']
if existingCount:
self.util.logInfo("Existing site utilization (%):")
normalisedExistingCount = self.util._normaliseShares(
existingCount.copy()) # pylint: disable=protected-access
for se in sorted(normalisedExistingCount.keys()):
self.util.logInfo("%s: %.1f" %
(se.ljust(15), normalisedExistingCount[se]))
# Group the input files by their existing replicas
res = self.util.groupByReplicas(self.data, self.params['Status'])
if not res['OK']:
return res
replicaGroups = res['Value']
tasks = []
# For the replica groups
for replicaSE, lfns in replicaGroups:
possibleSEs = replicaSE.split(',')
# Determine the next site based on requested shares, existing usage and candidate sites
res = self._getNextSite(
existingCount,
cpuShares,
candidates=self._getSitesForSEs(possibleSEs))
if not res['OK']:
self.util.logError("Failed to get next destination SE",
res['Message'])
continue
targetSite = res['Value']
# Resolve the ses for the target site
res = getSEsForSite(targetSite)
if not res['OK']:
continue
ses = res['Value']
# Determine the selected SE and create the task
for chosenSE in ses:
if chosenSE in possibleSEs:
tasks.append((chosenSE, lfns))
existingCount[targetSite] = existingCount.setdefault(
targetSite, 0) + len(lfns)
return S_OK(tasks)
def _getShares(self, shareType, normalise=False):
""" Takes share from the CS, eventually normalize them
"""
res = gConfig.getOptionsDict('/Resources/Shares/%s' % shareType)
if not res['OK']:
return res
if not res['Value']:
return S_ERROR("/Resources/Shares/%s option contains no shares" %
shareType)
shares = res['Value']
for site, value in shares.items():
shares[site] = float(value)
if normalise:
shares = self.util._normaliseShares(shares) # pylint: disable=protected-access
if not shares:
return S_ERROR("No non-zero shares defined")
return S_OK(shares)
def _getNextSite(self, existingCount, targetShares, candidates=None):
"""
Selects the most suitable site, i.e. further to targetShares in existingCount
"""
if candidates is None:
candidates = targetShares
# normalise the existing counts
existingShares = self.util._normaliseShares(existingCount) # pylint: disable=protected-access
# then fill the missing share values to 0
for site in targetShares:
existingShares.setdefault(site, 0.0)
# determine which site is farthest from its share
chosenSite = ''
minShareShortFall = -float("inf")
for site, targetShare in targetShares.items():
if site not in candidates or not targetShare:
continue
existingShare = existingShares[site]
shareShortFall = targetShare - existingShare
if shareShortFall > minShareShortFall:
minShareShortFall = shareShortFall
chosenSite = site
return S_OK(chosenSite)
@classmethod
def _getSiteForSE(cls, se):
""" Get site name for the given SE
"""
result = getSitesForSE(se)
if not result['OK']:
return result
if result['Value']:
return S_OK(result['Value'][0])
return S_OK('')
@classmethod
def _getSitesForSEs(cls, seList):
""" Get all the sites for the given SE list
"""
sites = []
for se in seList:
result = getSitesForSE(se)
if result['OK']:
sites += result['Value']
return sites