O principal objetivo deste projeto é estimular a integração da comunidade geofísica no Brasil, por meio do desenvolvimento de ferramentas que facilitem a disseminação das pesquisas na área.

Para obter mais informações, visite a página oficial do projeto: www.gebrproject.com.

Este guia refere-se à versão 0.16.0 da GêBR. As telas usadas no guia foram capturadas em um sistema Ubuntu 10.04. Por isso, podem apresentar pequenas diferenças em relação a outros sistemas operacionais. Para obter instruções de instalação específicas para cada sistema, leia o guia de instalação, disponível na página oficial do projeto.

Coordenador:

Gerente de desenvolvimento:

Desenvolvedores:

Consultores:

Ex-membros:

Muito obrigado por usar a GêBR!

Para criar um novo projeto:

Figura 3.

Na janela de propriedades do projeto você pode editar informações como título, descrição, autor e email.

Depois de criado, o projeto fica acessível no lado esquerdo da janela principal da GêBR. Na caixa Detalhes, no lado direito da janela principal, são exibidas informações sobre o projeto. Você notará que algumas dessas informações foram inseridas por você na janela Propriedades do Projeto, no momento da criação do projeto. Outras informações, como a data da criação e a data da última modificação, são geradas e atualizadas automaticamente pela GêBR.

Figura 4.

Um exemplo de um Projeto chamado "Meu primeiro projeto". À esquerda vemos a lista de Projetos e Linhas, enquanto que à direita vemos os detalhes do Projeto ou da Linha selecionada.

Agora que o projeto está criado, você deve criar linhas dentro dele. Para criar uma nova linha:

Figura 5.

Janela de Propriedades para Linha; você pode definir informações sobre a linha como descrição, autor, e-mail, o maestro da linha (veja Seção 3.5, “Alterando o maestro de uma linha”) e adicionar caminhos preferenciais no campo Caminho.

Depois de criar a primeira linha, sua janela da GêBR deve se parecer com a janela abaixo. Note que quando a linha está selecionada, as informações sobre ela são mostradas na caixa Detalhes, no lado direito da janela principal.

Figura 6.

Na aba Projetos e Linhas, teremos à direita da janela em Detalhes, as informações da Linha selecionada.

Agora que existe uma estrutura básica de projeto e linha, você já pode criar seu primeiro Fluxo.

Para excluir um projeto ou uma linha, selecione o projeto ou a linha e clique no botão .

Para editar as propriedades de um projeto ou de uma linha, selecione o projeto ou a linha e clique no botão .

Na janela Propriedades para Projeto ou Propriedades para Linha (dependendo do caso) você pode editar os campos Título, Descrição, Autor e Email. Para o caso de edição de propriedades de linha, pode-se editar o Maestro e adicionar caminhos personalizados, cujo detalhamento será abordado na Seção 3.4, “Editar caminhos preferenciais da linha”.

Na Seção 5.6, “Editar arquivos de entrada e saída do Fluxo” veremos que um Fluxo pode estar associado a alguns arquivos de dados. Veremos também que essa associação pode ser feita mais facilmente se adicionarmos os chamados caminhos preferenciais da linha.

Os caminhos preferenciais de linha são como atalhos para que os diretórios sejam acessados mais facilmente e para que se permita o acesso remoto a eles.

Os caminhos preferenciais da linha são definidos no diálogo de Propriedades para Linha. Para abrir este diálogo, tenha a linha selecionada e clique sobre o ícone , na barra de ferramentas, ou utilizando o menu de contexto, selecione a opção Propriedades. Na janela Propriedades para Linha, no campo Caminhos, digite o caminho desejado e clique no botão .

Além disso, na janela Propriedades para Linha, pode-se adicionar caminhos preferenciais de linha escolhendo-se um diretório. Para isso, deve-se clicar no botão .

Quando tiver concluído a edição dos caminhos preferenciais, clique em OK.

Não há limitação para o número de caminhos, você pode adicionar quantos quiser.

Pode-se utilizar hotkeys para adicionar caminhos (Enter), mover caminhos para cima e para baixo (Ctrl+seta para cima/para baixo), tornar um caminho topo de lista (Ctrl+Home) e tornar um caminho fim de lista (Ctrl+End).

Figura 7.

Janela de Propriedades para Linha; além de adicionar informações sobre a linha como descrição, autor e email, é possível adicionar caminhos preferenciais no campo Caminhos.

Você pode alterar o maestro de uma linha quando o maestro atualmente conectado é diferente do maestro configurado para esta linha. Siga os passos abaixo:

Este recurso está documentado na Seção 7.4, “Dicionário de Variáveis”.

A GêBR permite importar projetos ou linhas que tenham sido previamente exportados(as) na Seção 3.8, “Exportar um projeto ou linha”. Para fazer isso:

O projeto importado é adicionado aos demais projetos (se existirem) listados no lado esquerdo da janela principal. A linha importada é adicionada às demais linhas (se existirem) do projeto que estiver selecionado no momento da importação. Em ambos os casos, o elemento importado é identificado com o sufixo Importado.

Embora a GêBR preserve continuamente todos os dados, às vezes é desejável manter os projetos e linhas em arquivos (para compartilhamento ou cópia de segurança, por exemplo). Para exportar um projeto ou uma linha:

Pode-se editar comentários no relatório, atribuindo informações adicionais sobre o projeto ou sobre a linha. Para editar um comentário:

Figura 8.

Janela de edição de comentários.

Como explorado na seção anterior, pode-se criar e editar informações adicionais sobre projetos e linhas. Para visualizar o relatório que você criou, clique no botão Visualizar relatório, na parte de baixo da caixa Detalhes, no lado direito da janela principal.

Na janela que se abre após o usuário clicar em Visualizar relatório, em Arquivo, é possível:

A interface de relatórios da Linha oferece um menu adicional, o menu Opções.

No caso da visuzalização de relatórios da Linha, em Opções, é possível:

Figura 9.

Na janela de Visualização de relatório, é possivel salvar ou imprimir este relatório. Em Opções, conforme pode-se visualizar, é possível incluir comentários do usuário, incluir relatório do Fluxo, incluir tabelas de parâmetros e escolher estilos do documento.

Na Seção 4.13, “Visualizar relatório da aba Fluxos”, é detalhada a visualização de relatório para um Fluxo, que se dá de forma muito semelhante à visualização de relatório da linha, com a diferença que nesta é possível englobar o relatório do Fluxo.

Na GêBR, um Fluxo é uma sequência de operações selecionadas pelo usuário. Estas operações, também chamadas de programas do Fluxo, são separadas nas seguintes categorias, de acordo com o propósito:

Criar um Fluxo significa selecionar e ordenar programas, a partir das categorias acima. Vejamos como se faz na prática:

Não há limitação para o número de Fluxos na GêBR. Você pode criar quantos Fluxos quiser dentro de uma linha.

Depois de criados, os Fluxos ficam visíveis no lado esquerdo da janela principal, quando a aba Fluxos está selecionada. A caixa Detalhes, localizada no lado direito da janela principal, exibe informações sobre o Fluxo selecionado.

Na GêBR, um Fluxo (ou um conjunto de Fluxos) pode ser copiado para a área de transferência por meio do botão ou, mais prático, pelo conhecido atalho Ctrl+C.

Depois de ter sido selecionado e copiado (Seção 4.2, “Copiar Fluxos”), um Fluxo (ou um conjunto de Fluxos) pode ser colado por meio do botão ou, mais prático, pelo conhecido atalho Ctrl+V.

Para excluir um Fluxo (ou um conjunto de Fluxos), selecione-o e clique no botão .

Para editar as propriedades de um Fluxo, selecione-o e clique no botão .

Na janela Propriedades para Fluxo você pode editar os campos Título, Descrição, Autor e Email.

Este recurso está documentado na Seção 7.4, “Dicionário de Variáveis”.

Ao trabalhar com Fluxos na GêBR, você encontrará diversas situações em que é interessante usar um Fluxo existente como base para a criação de novos Fluxos. Por exemplo, você pode querer fazer experiências com um Fluxo sutilmente diferente de um outro que já existe, mas sem ter que descartar ou modificar o Fluxo original.

Uma forma de fazer isso é através de cópia-colagem de Fluxo (veja as seções Seção 4.2, “Copiar Fluxos” e Seção 4.3, “Colar Fluxos”), guardando o Fluxo original e editando a cópia. Outra forma é salvar o estado atual do Fluxo, para poder editá-lo e, quando desejar, retornar ao estado inicial. Para salvar o estado de um Fluxo:

Para abrir a lista de estados salvos, clique no botão , à direita do botão , e então selecione o estado para o qual quer retornar. Sempre que você selecionar um estado salvo na lista, o diálogo Fazer backup do estado atual será exibido. Se clicar em Sim, a janela Salvar estado do Fluxo se abrirá, e você poderá salvar um novo estado. Se clicar em Não, a GêBR apenas reverterá para o estado escolhido, sem salvar o atual.

A GêBR permite importar Fluxos que tenham sido exportados Seção 4.9, “Exportar um Fluxo”. Para fazer isso:

O Fluxo importado é adicionado aos demais Fluxos (se existirem) da linha que estiver selecionada no momento da importação.

Embora a GêBR preserve continuamente todos os dados, às vezes é desejável manter os Fluxos em arquivos (para compartilhamento ou cópia de segurança, por exemplo). Para exportar um Fluxo:

O botão é utilizado para executar Fluxos, e está presente tanto na aba Fluxos quanto na aba Editor de Fluxo.

Figura 12.

Na aba Fluxos você possível selecionar vários Fluxos para execução.

Na GêBR é possível executar um conjunto de Fluxos. Esta operação é chamada execução múltipla e pode ocorrer de dois modos:

A velocidade de execução dos Fluxos é determinada pelo número de processadores e prioridade da execução. É possível configurar estes parâmetros, como detalhado em Seção 5.8, “Multiplos processadores” e Seção 5.9, “Prioridade de execução”.

Através desta opção, o usuário pode adicionar comentários à linha ou ao Fluxo criados. Veja Seção 3.9, “Editar comentários”.

Este comando aparece repetidamente nas abas Projetos e Linhas e em Fluxos. Através dele, em ambas abas, pode-se gerar/visualizar o relatório da linha ou do Fluxo em questão, com a pequena diferença de que é possível englobar o relatório do Fluxo no relatório da linha. As demais funcionalidades são descritas na Seção 3.10, “Visualizar relatório”.

A funcionalidade é análoga a da Seção 4.2, “Copiar Fluxos”, através do botão ou, mais prático, pelo conhecido atalho Ctrl+C.

A funcionalidade é análoga a da Seção 4.3, “Colar Fluxos”, porém os programas serão colados dentro do Fluxo selecionado.

Para excluir um programa (ou um conjunto de programas), selecione-o e clique no botão .

Os parâmetros de um programa são as configurações iniciais do mesmo, definidas pelo usuário.

Para editar os parâmetros de um programa:

Após realizar o procedimento da Seção 5.4, “Editar os parâmetros de um programa”, note que o programa passa a ser sinalizado por em vez de . Isso indica que o programa passou do estado Não configurado para o estado Configurado. Além desses dois estados, um programa pode assumir ainda o estado Desabilitado (). Você pode alternar entre estes estados de duas maneiras, clique com botão direito sobre o programa e selecione o estado desejado a partir do menu de contexto ou use o atalho Espaço para trocar entre os possíveis estados dos programas selecionados.

Na Seção 4.1, “Criando Fluxos”, mostramos como criar um Fluxo. Há situações em que o Fluxo precisa extrair dados de um arquivo de entrada, gerar como resultado um arquivo de saída ou um arquivo de registro de erro.

Para associar algum destes tipos de arquivo a um Fluxo:

Figura 13.

Na aba Editor de Fluxo, você pode editar os arquivos de entrada, saída e log de um fluxo.

Ao sair da janela Entrada/Saída do Fluxo, note que os arquivos de entrada e saída que você associou ao Fluxo aparecem na caixa Sequência de Fluxo, sinalizados com os ícones e , abaixo e acima dos programas do Fluxo (se houver algum).

Para executar o Fluxo atual, clique no botão . A execução de um fluxo também pode ser executada através da aba Fluxos (veja Seção 4.10, “Executando Fluxos”).

Na aba Editor de Fluxo, você pode executar um Fluxo após outro Fluxo, criando uma fila de execução. Para executar após um Fluxo em específico, ao invés de escolher Imediatamente, vá para a aba Editor de Fluxos e escolha Após FluxoX . Por padrão, os fluxos são executados no grupo do Maestro. Veja em Seção 7.2, “Configurações de servidores” como definir e editar os servidores/grupos que podem ser utilizados na execução.

Figura 14.

Na segundo campo de Executar, você pode selecionar após qual Fluxo deseja executar.

No momento em que o Fluxo começa a ser executado, a GêBR alterna imediatamente para a aba Tarefas, que mostra o relatório (log) da execução.

GêBR otimiza a execução de laços em máquina com múltiplos processadores (cores). A execução de fluxos paralelizáveis pode ser otimizado por este recurso. Se o Fluxo é paralelizável (i.e., satisfaz os critérios abaixo) então você pode ajustar o número de processadores a serem utilizados.

Para ser paralelizável, além de ter um laço, o Fluxo precisa satisfazer um destes critérios:

Você pode ajustar o número de processadores a ser utilizado através da barra de ajuste .

Cada nível da barra de ajuste corresponde a um número de núcleos utilizado pela tarefa.

Computadores são multitarefas, o que significa que podem executar várias tarefas concorrentemente. Quando muitas tarefas são executadas ao mesmo tempo, o computador se sobrecarrega e diminui seu desempenho. Fluxos de processamento sísmico, em particular, exigem muitos recursos das máquinas.

Para prevenir o sobrecarregamento das máquinas, a GêBR oferece a possibilidade de executar um Fluxo em estado de Baixa prioridade.

Há duas opções:

Tecnicamente, rodar em modo de "Baixa prioridade" significa reduzir a prioridade de execução da tarefa, algo como dizer ao computador para "esperar outras coisas mais importantes serem executadas primeiro". Este é o caso quando o usuário faz outras coisas enquanto processa seus Fluxos na GêBR. O modo de "Alta Prioridade" significa que a GêBR terá maior prioridade sobre os outros processos, algo como "Eu quero este processamento da GêBR pronto o mais rápido possível".

Se a GêBR é o único programa sendo executado nos servidores, i.e., não há competidores por recursos do sistema, então ambos estados correspodem ao mesmo modo.

O programa Loop (que pertence a categoria Loops) é tratado de uma maneira especial comparado aos outros programas da GêBR. Vamos ver a seguir algumas destas diferenças.

Ao adicionarmos o programa Loop, nota-se que ele sempre aparece no topo do Fluxo, isso ocorre para representar que aquele Fluxo será executado repetidamente, de acordo com o preenchimento dos parâmetros do programa (visto na seção Seção 5.4, “Editar os parâmetros de um programa”).

Na aba Editor de Fluxo, após o programa Loop ser adicionado e configurado.

Após o Loop ser adicionado, teremos acesso a uma nova variável, chamada iter (veja Seção 7.4, “Dicionário de Variáveis”), que tem seu valor alterado a cada iteração, de acordo com o preenchimento de seus parâmetros.

Janela de edição de parâmetros do programa Loop, com um exemplo simples do preenchimento.

Se a GêBR estiver conectada a várias máquinas (configuração através do Seção 7.2, “Configurações de servidores”), e o Fluxo for paralelizável (veja abaixo os critérios para um Fluxo ser paralelizável), então o usuário tem a opção de executar o Fluxo de forma distribuída.

Para ser paralelizável, o Fluxo precisa satisfazer um destes critérios:

No caso de o Fluxo não ser paralelizável, a GêBR irá executar o Fluxo na melhor melhor máquina no memomento de execução (GêBR ordena as máquinas baseado na disponibilidade e na velocidade). Numa execução distribuída, é importante distinguir os modos de Prioridade. Quando o Fluxo é paralelizável, o Fluxo é dividido e distribuído entre as máquinas disponíveis de acordo com sua ordenação).

Se você deseja executar um Fluxo (paralelizado ou não) em um servidor em específico, você pode forçar sua execução indo à aba Editor de Fluxo e escolhendo o servidor desejado.

Barra de ferramentas da aba Tarefas

Nesta aba você pode acompanhar e, se desejar, interromper a execução da tarefa. Os comandos disponíveis são:

6.1.4. Filtro

A GêBR oferece a opção de ver apenas os resultados desejados.

Você pode filtrar os resultados por dois critérios:

• Grupo/Servidor
• Estado

No painel esquerdo, a GêBR apresenta a lista de tarefas executadas pelo usuário, ordenada pelo momento de execução. Cada tarefa pode ser exibida em um dos três estados:

Na parte superior, são exibidas informações da tarefa selecionada. Mais informações são exibidas clicando em Detalhes. Entre as informações exibidas estão:

Você ainda pode consultar quais maquina foram efetivamente usadadas do grupo e como foi feita a distribuição do trabalho, clicando em .

Os resultados (saída padrão) da tarefa são mostrados. A saída redirecionada não é exibida. Clicando com o botão direito do mouse nesta janela, um menu de opção é exibido, onde você pode habilitar/desabilitar quebra de linha automática e rolagem automática da janela conforme a saída é gerada.

Você pode também consultar as linhas de comando executadas pela GêBR. As linhas de comando são portáveis e podem ser copiadas-coladas em um terminal. Para isso, vá à aba Linha de Comando, na parte inferior da janela da aba Tarefas e consultar as linhas de comando dos fluxo. No caso de fluxos paralelizáveis, as linhas de comando estarão separadas de acordo com a divisão de tarefas realizada pela GêBR.

A partir do menu Ações você acessa as janelas Preferências e Servidores. Se você leu todo o manual, provavelmente já usou quase todos os recursos disponíveis nessas duas janelas. De qualquer forma, segue a documentação.

7.1.1. Preferências

As definições que você faz na janela Preferências são adotadas como padrão pela GêBR. Vejamos os detalhes:

• Nome do Usuário: Padrão adotado no campo Autor: durante a criação de Projetos, Linhas e Fluxos.

• Email: Padrão adotado no campo Email durante a criação de Projetos, Linhas e Fluxos.

• Diretório de menus do usuário: Pasta padrão usada para manutenção de Menus GêBR (arquivos mnu).

Figura 15.

Em Preferências, abre-se uma janela em que é possível editar informações como nome de usuário, e-mail, diretório de menus do usuário e editor HTML.

Configurações Avançadas

Ao clicar sobre Configurações avançadas, a janela é expandida para uma janela para Edição do Maestro e do Editor HTML.

Configurações avançadas do menu de Preferências

• Maestro: maestro conectado a GêBR. Na primeira vez que se inicia a GêBR, o maestro vem por padrão a máquina de onde se abre a GêBR.

• Editor HTML: Editor de textos padrão adotado pela GêBR para criação de relatórios de informações de projetos, linhas e fluxos.

GêBR utiliza o recurso disponível pelas máquinas que você tem acesso. Para tanto, a GêBR tem três componentes:

Componentes da GêBR

A GêBR pode estar conectada a um maestro por vez. Cada maestro, por sua vez, pode estar conectado a vários servidores. Um requisito é que os servidores estejam no mesmo sistema de arquivos (NFS).

A janela de Configurações de servidores é dividida em três partes:

7.2.1. Caixa de edição do maestro

Caixa de edição do maestro

Na parte superior da janela das Configurações de Servidores, há uma caixa para edição da máquina a ser utilizada como maestro. Para que a máquina possa ser utilizada como maestro, ela deve ter o pacote GêBR-maestro instalado. O estado do maestro é indicado pela ícone ao lado direito:

• conectado ( )

• desconectado ()

• erro ()

7.2.2. Servidores

Janela de Servidores

Uma vez escolhido a máquina que irá coordenar as tarefas (GêBR-maestro), você poderá associar máquinas àquele maestro.

Cada entrada representa um servidor associado a aquele maestro. Cada linha tem duas colunas: a primeira coluna exibe a opção de Auto-Conexão e a segunda coluna exibe a nome (hostname) do servidor. O usuário pode adicionar uma nova máquina clicando sobre Novo.

7.2.3. Configurações de grupos

Você pode optar por utilizar apenas um subconjunto das máquinas do maestro conectado. A criação/edição de grupos é feita através da janela de Configurações de Grupos e possibilita este recurso.

A funcionalidade é através do Arrastar-e-soltar do mouse.

Criação de um grupo

Para criar um grupo, o usuário precisa clicar sobre um servidor que esteja vinculado ao Maestro e arrastar para o ícone + da janela Grupo/Servidores. Você poderá adicionar um nome para o novo grupo. Grupos com o mesmo nome não são aceitos.

A infra-estrutura GêBR compreende comunicação entre máquinas:

Todas conexões são feitas utilizando o protocolo de Shell Seguro (SSH). O programa SSH tem como propósito estabelecer uma comunicação segura numa rede.

A autenticação por chave pública é baseada na criptografia por chave pública, onde encriptação e decriptação utilizam pares de chaves publica/privada para autenticação. O Maestro conhece a chave pública e o Cliente conhece a chave privada associada.

Se você optar por "Utilizar chaves criptográficas para autenticar a próxima sessão.", a GêBR vai criar (se ainda não existente) um par de chaves público/privada e vai guardar a chave privada e vai copiar a chave pública ao maestro. Se esta operação for concluída com sucesso, a autenticação no Maestro sera feita pelo modo de chave pública. Em termos práticos, isto significa que você não necessitará inserir sua senha para conectar-se a GêBR-Maestro. Um mesmo comportamento se você optar utilizar o sistema de chave pública ao tentar acessar o GêBR-servidor.

Diagrama da autenticação da GêBR por chave pública. Suponha que um cliente queira estabelecer uma conexão. Então o cliente é solicitado por uma chave (sua chave privada). O maestro tenta fazer verificação o casamento da chave fornecida pelo cliente com alguma das chaves públicas que ele (Maestro) possui. Em caso de sucesso, o cliente é permitido a comunicar-se com o Maestro. Caso contrário, ele deve informar sua senha.

Alternativamente, você mesmo pode criar a par de chaves privada/pública (consulte aqui para mais informações).

A GêBR estende o conceito de variavéis da programação computacional à manipulação de projetos, linhas e fluxos. A utilização de variáveis pode auxiliar na legibilidade do código, portabilidade e na edição dinâmica de propriedades dentro de seu processamento.

A GêBR grava grande parte das ações executadas pelo usuário, bem como os resultados dessas ações, no chamado log de execução. Este log é mostrado na parte inferior da janela principal. Pode ser apresentado na forma contraída (padrão) ou expandida (como na janela abaixo).

Figura 29.

No canto inferior das janelas principais da GêBR, encontra-se o log de execução, que carrega as informações dos processamentos da GêBR.

Na seção Ajuda, além da seção de Ajuda geral, podemos importar exemplos já existentes:

Figura 30.

Captura de tela do menu Exemplos