Configurar extração - CAFe website - Backup - Confluence http://wiki.rnp.br/pages/viewpage.action?

pageId=41190439

Configurar extração Tools

Added by Alex Galhano Robertson, last edited by Lidia A. de Oliveira Alixandrina on Apr 03, 2012

Configurar extrações para popular o metadiretório

Após instalação da ferramenta Eid e Eid2ldap é preciso configurá-la para realizar a extração dos dados das bases
institucionais para o Metadiretório que será utilizado para alimentar o diretório LDAP.

Configurando os Repositórios de Dados

Este passo configura a conexão às bases institucionais que servirão de fonte dos dados para criação do Diretório.

1. Identificar as fontes de dados. Identificar as bases de dados que serão utilizados para alimentar o sistema
(base de alunos de graduação, bases de alunos de pós-graduação, base de recursos humanos, etc.)
2. Verificar as classes e atributos necessários para o esquema brEduPerson (Classes EID recomendadas
para brEduPerson)
3. Cadastrar as fontes de origem. Cadastrar cada uma das fontes (repositórios) de origem, utilizando o
seguinte procedimento:
a. Acessar o EID no endereço http://servidor:8080/eid
b. Informar o login eid e a senha cadastrada durante a instalação
c. Acessar o menu Configuração /Repositório de Dados
d. Acionar o comando Novo para definir um novo repositório
e. Fornecer os campos necessários
Tipo: Banco de Dados Relacional, para bancos relacionais como Oracle, MySQL, PostgreSQL,
Sybase, etc.); Arquivos CSV para arquivos texto.
Nome: Nome para identificar facilmente o repositório
Descrição: Descrição textual do repositório
Url: consulte seu fornecedor de banco de dados para saber a url de conexão. O formato de
algumas urls é apresentado a seguir e também no ícone de lupa do lado do campo url.
MySQL: jdbc:mysql://servidor:porta/banco
PostgreSQL: jdbc:postgresql://servidor:porta/banco
Oracle: jdbc:oracle:thin:@servidor:porta:nome_instancia
Driver: consulte o seu fornecedor de banco de dados para conseguir o driver. O arquivo jar
contendo as classes usadas pelo driver JDBC deve ser colocado no diretório /usr/share
/java/, com links para /usr/share/tomcat6/lib/ e /var/lib/tomcat6/lib/. No roteiro de
Instalação padrão já são incluídos os drivers do MySQl e PostgreSQL. O valor a ser informado
nesse campo para alguns fornecedores de bancos de dados são informados a seguir:
MySQL: com.mysql.jdbc.Driver
PostgreSQL: org.postgresql.Driver
Oracle: oracle.jdbc.driver.OracleDriver
Usuário: usuário para estabelecimento da conexão com o banco
Senha: senha do usuário
Versão do banco de dados
Para tipo de repositório igual a Arquivos CSV informe o diretório que deve conter o caminho do
diretório (no servidor) que contém os arquivos a serem importados
f. Acionar o comando Testar Repositório
g. Em caso de sucesso no teste, acionar o comando Salvar. Em caso de insucesso, observar a mensagem
indicativa de erro e providencie a correção.

Configurando as Extrações:
Este passo irá criar as extrações (Mapeamentos de qual campo de qual tabela será enviado para qual atributo das
classes do brEduPerson) para alimentar as classes definidas.

1. A primeira classe a ser carregada deve ser a classe Identificacao. As demais classes devem sempre resolver a
qual objeto estão relacionadas, pelo campo eid_object_guid. Para que o diretório seja alimentado é necessário

1 de 4 20/05/2013 13:20
Configurar extração - CAFe website - Backup - Confluence http://wiki.rnp.br/pages/viewpage.action?pageId=41190439

que a classe Conta seja também alimentada. Apenas registros que possuam login associados serão
exportados para o LDAP.
a. Acessar o menu Configuração / ETC
b. Acionar o comando Novo
c. Na guia Geral, especifique:
Nome: Nome para a extração
Descrição: Descrição textual da extração
d. Na guia Leiaute de Origem
Repositório: Repositório do qual serão extraídos os dados
SQL: Consulta que define os registros a serem carregados
Acionar o comando Leiaute
Selecionar os campos que representam chave primária no repositório de origem como
identificador único (IU)
e. Na guia Leiaute de Destino
i. Tipo de Script: Java Nativo
ii. Classe: Classe que será alimentada
iii. Acionar o comando Leiaute
iv. Atualizar Registros Existentes: marcar a caixa
v. No painel Leiaute de Destino dos Dados
Mapear os campos de origem para o destino
Criar scripts de conversão para os campos que devem ser convertidos
Marcar para remoção os campos que não serão mapeados
f. Acionar o comando Salvar
2. Criar os processos de extração
a. Acessar o menu Configuração / Processos
b. Acionar o comando Novo
c. Preencher os campos
i. Nome: Nome para identificação do processo
ii. Descrição: Descrição textual do processo
Modo: selecione Interromper Processamento
Número de tentativas: 1
Intervalo entre tentativas: 1
iii. No painel Itens de processo
Acione o botão Novo e selecione marcando o checkbox à esquerda cada uma das
extrações na janela popup que irá abrir, depois de selecionadas acione o botão selecionar
Intervalo commit: 500
Número erros: 0
d. Acionar Salvar
3. Agendar as extrações
a. Acessar o menu Processamento / Agendamento
b. Acionar o comando Novo
c. Selecionar:
Processo: Processo definido anteriormente
Tipo de repetição: Frequência de execução do processo
Item de Início: Informar qual ETC o processo irá executar primeiro
Finalizar no Item: Informar qual ETC ele irá terminar
Próxima execução: Informar a data da próxima execução ou marcar o checkbox para processar
agora
d. Acionar o comando Salvar

Conciliação Manual de Registros:

Após as importações feitas através dos agendamentos no EID, o sistema inicia o processo de conciliação e unificação
dos registros, buscando em toda a base por pessoas duplicadas.

As pessoas que o EID não consegue identificar automaticamente como conciliáveis são exibidas na interface de
Conciliação Manual , através de agrupamentos de registros que são considerados pelo EID teoricamente como a
mesma pessoa.

2 de 4 20/05/2013 13:20
Configurar extração - CAFe website - Backup - Confluence http://wiki.rnp.br/pages/viewpage.action?pageId=41190439

Cabe ao administrador do sistema acessar esta interface e decidir se os registros são ou não conciliáveis. São
exemplos comuns de registros que o EID fica em dúvida no momento de conciliação, jogando os registros para a lista
de conciliação manual:

Irmãos gêmeos: Possuem nomes geralmente bem parecidos como Alice e Aline, sobrenomes iguais, data de
nascimento igual, e apenas documentos diferentes.
Alunos/Funcionários que possuem 2 ou mais registros distintos um com nome de solteiro e outro com nome de
casado.

Esta interface é acessível através do Menu EID/Conciliação .

Para fazer a conciliação dos dados:

1. Marque os atributos que devem ser exibidos, para isso clique na opção "Atributos Visíveis", selecione alguns
dos atributos que você importou escolhendo os que melhor identificam uma pessoa como: nome, data
nascimento,nome mãe,nome pai cpf, rg, cuso, login, email.
2. Você deverá analisar cada grupo de registros e verificar se correspondem a mesma pessoa ou não, há três
possibilidades:
a. Caso sejam a mesma pessoa clicar no botão 'Conciliar". Quando você seleciona a opção "Conciliar" o
EID faz um 'merge' dos registros criando uma só pessoa com os atributos escolhidos aleatoriamente,
dando preferência por atributos não nulos. (Outras regras de precedência de atributos podem ser
implementadas através de algoritmos de Unificação personalizados para cada classe do EID).
b. No caso dos registros agrupados não corresponderem à mesma pessoa deve-se marcar o check box à
esquerda do registro e clicar em "Excluir", esta ação exclui os registros da conciliação e gera um novo
registro para cada uma das pessoas do agrupamento.
c. Uma outra alternativa é quando existe um agrupamento com 3 ou mais pessoas e apenas algumas
pessoas do grupo são conciliáveis e outras não são, neste caso deve-se clicar no botão "Alterar" e editar
o grupo excluindo as pessoa que não conciliam, e depois conciliar as restantes que correspondem à
mesma pessoa.
3. É importante saber que os registros que estão nesta lista de conciliação manual não são exibidas na pesquisa
de pessoas do EID e não são enviadas para o LDAP, portanto é necessário conciliar os registros pendentes
antes de executar a ferramenta EID2LDAP.

Exportando os registros do Metadiretório para o LDAP através do

Eid2Ldap
1 --Iniciar o Agente escalonador de processos

a. Acessar através do browser a ferramenta Eid2Ldap através da url: http://<SERVIDOR>:8080/eid2ldap.

b. Acesse o menu Agendamento/Agente Gerenciador de Agendamento e certifique-se que o agente

escalonador de processos está ATIVO, caso não esteja acione o botão INICIAR para iniciá-lo. Enquanto o Agente
estiver INATIVO nenhum agendamento é executado no EID2LDAP.

2 – Configuração da conexão com o servidor LDAP

a. Acesse o menu Configuração/Servidor LDAP.

b. Acione o comando Alterar do LDAP Local.
c. Altere os dados de conexão para seu servidor LDAP local :
Endereço Servidor: IP ou nome do servidor
Número Porta: 389
Login: cn=admin,dc=<instituição>,dc=br (ex. cn=admin,dc=ufmg,dc=br)
Senha: A senha do usuário admin configurado no LDAP
Versão Protocolo: 3
Número de série: -1
d. Acione o comando Salvar.

3 – Configuração de uma transformação

Configure uma transformação e associe-a ao servidor LDAP local. Para tanto:

3 de 4 20/05/2013 13:20
Configurar extração - CAFe website - Backup - Confluence http://wiki.rnp.br/pages/viewpage.action?pageId=41190439

a. Acione o menu Configuração/Transformação.

b. Acione o comando Alterar para modificar a transformação brEduPerson já cadastrada.

c. No campo Conteúdo do XSLT, no arquivo exibido substitua $ ?RAIZ_BASE_LDAP pelo DN da raiz do

diretório (dc=<instituição,dc=br)

d. No detalhe Servidor LDAP, o servidor LDAP configurado na atividade 2 deve estar selecionado.
e. Acione o comando Salvar.

5 – Definição de um agendamento

Agende a atualização do diretório LDAP.

a. Acesse o menu Agendamento/Agendamento Servidor LDAP.

b. Acione o comando Novo e configure os parâmetros do agendamento, de forma que o LDAP seja atualizado:
Informe uma Descrição para o agendamento.
Informe o Tipo de Repetição como NENHUM.
No campo Intervalo em minutos deixe em branco.
No campo Próxima Execução informe data e hora atual, no formato: dd/mm/aaaa hh:mm.
No campo Máximo de erros informe 0.
No campo Nome do Servidor LDAP informe o Ldap cadastrado.
c. Acione o comando Salvar.
d. Aguarde alguns minutos até a importação ser realizada com sucesso, para verificar acesse o menu
Agendamento/Resultado Agendamento.
e. Observe os dados no LDAP através do Apache DirectoryStudio ou utilizando o seguinte comando no Linux :

# ldapsearch -x -D "cn=admin,dc=<nome_da_instituição>,dc=br" -W

Labels None

4 de 4 20/05/2013 13:20