csbase.sga.executor

Class DefaultJobExecutor

java.lang.Object

csbase.sga.executor.DefaultJobExecutor

All Implemented Interfaces:

JobExecutor

public class DefaultJobExecutor
extends Object
implements JobExecutor

Executor padrão do SGA. Neste executor os jobs são executados via shell (ksh) na mesma máquina onde está o servidor CSBase.

Author:

Tecgraf/PUC-Rio

Constructor Summary

Constructors

Constructor and Description
DefaultJobExecutor(Properties pluginProperties) Construtor.

Method Summary

Modifier and Type	Method and Description
Map<String,String>	collectExecutionData(String execPath, String cmdId, String sandboxPath, String outputPath) Executes the script to collect command' execution data.
void	controlJob(JobData data, String child, sgaidl.JobControlAction action) Exerce uma ação sobre um job ou sobre um processo filho do job.
JobData	executeJob(String jobCommand, Map<String,String> extraParams, JobObserver observer) Executa um job no ambiente de execução.
JobInfo	getJobInfo(JobData data) Obtém as informações sobre a execução do job no ambiente de execução.
void	notifyJobFinished(String jobId) Notifica o término de um job para o observador deste job.
void	recoverJob(JobData data, JobObserver observer) Recupera um job no ambiente de execução.
void	searchAndNotifyFinishedJobs() Busca e notifica jobs finalizados.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultJobExecutor

public DefaultJobExecutor(Properties pluginProperties)
                   throws csbase.server.plugin.service.sgaservice.SGADaemonException

Construtor.

Parameters:

pluginProperties - propriedades

Throws:

csbase.server.plugin.service.sgaservice.SGADaemonException - caso ocorra um erro na criação do executor

Method Detail

executeJob

public JobData executeJob(String jobCommand,
                          Map<String,String> extraParams,
                          JobObserver observer)

Executa um job no ambiente de execução. Um job representa um comando de execução, que é um programa ou script junto com os seus argumento, no ambiente de execução. Assim que o sistema de execução tiver o JobData do job, deve retorná-lo. Este método não deve bloquear até a finalização do job. Para notificar o término e possíveis erros durante a execução, deve ser utilizado o observador.

Specified by:

executeJob in interface JobExecutor

Parameters:

jobCommand - comando do job que deve ser executado.

extraParams - parametros extras usados pelo ambiente de execução para executar o job

observer - observador do job

Returns:

os dados do job

controlJob

public void controlJob(JobData data,
                       String child,
                       sgaidl.JobControlAction action)
                throws sgaidl.ActionNotSupportedException

Exerce uma ação sobre um job ou sobre um processo filho do job. Apenas a ação TERMINATE é suportada.

Specified by:

controlJob in interface JobExecutor

Parameters:

data - os dados do job

child - o processo filho do job

action - a ação a ser exercida

Throws:

sgaidl.ActionNotSupportedException - se a áção não é suportada pelo ambiente de execução

getJobInfo

public JobInfo getJobInfo(JobData data)

Obtém as informações sobre a execução do job no ambiente de execução.

Specified by:

getJobInfo in interface JobExecutor

Parameters:

data - os dados do job

Returns:

as informações sobre o job

collectExecutionData

public Map<String,String> collectExecutionData(String execPath,
                                               String cmdId,
                                               String sandboxPath,
                                               String outputPath)

Executes the script to collect command' execution data.

Specified by:

collectExecutionData in interface JobExecutor

Parameters:

execPath - command exec path

cmdId - command id

sandboxPath - sandbox path

outputPath - output path (log, warning, exit_code)

Returns:

the execution data

recoverJob

public void recoverJob(JobData data,
                       JobObserver observer)

Recupera um job no ambiente de execução. Quando o servidor é reiniciado é necessário recuperar os jobs que estavam em execução antes da parada no ambiente de execução para dar continuidade na monitoração. Um JobData deve conter todas as informações necessárias para a recuperação do job correspondente.

Specified by:

recoverJob in interface JobExecutor

Parameters:

data - dados do job

observer - observador do job

notifyJobFinished

public void notifyJobFinished(String jobId)

Notifica o término de um job para o observador deste job.

Parameters:

jobId - o identificador do job

searchAndNotifyFinishedJobs

public void searchAndNotifyFinishedJobs()

Busca e notifica jobs finalizados. A notificação deve ser feita pelo JobObserver do job. Jobs finalizados são aqueles que tem o estado ProcessState.FINISHED.

Specified by:

searchAndNotifyFinishedJobs in interface JobExecutor