![Fechar [x]](http://dw1.s81c.com/i/c.gif){kind=small}
Introdução e arquitetura de solução
O IBM® Tivoli® Directory Integrator permite a sincronização, transformação e migração de dados genéricos e de identidade entre sistemas heterogêneos, ajudando as organizações a manterem os dados consistentes e confiáveis por meio de diversos recursos.
As soluções do Tivoli Asset Management for IT (TAMIT) fornecem maior visibilidade, controle e automação para oferecer suporte ao gerenciamento eficiente e rentável de ativos de TI durante todo o ciclo de vida do ativo, incluindo o planejamento, aquisição, gerenciamento e disposição do software, hardware e das licenças relacionadas.
O Tivoli Process Automation Engine (TPAE), também conhecido como Serviços de Base, é uma coleção de classes Java principais e é usado como base para desenvolver aplicativos Java. A Estrutura de Integração, um recurso do TPAE, contém objetos de integração padrão (Estruturas de Objeto e interfaces) e objetos de saída/entrada. O Conector TPAE IF se conecta ao Tivoli Directory Integrator para a Estrutura de Integração do TPAE a fim de trocar informações.
O Conector TPAE IF lê e grava na Estrutura de Integração. Ele suporta o Maximo® Business Object (MBO) e é processado por meio de um objeto de integração. Este Conector usa a camada MBO para validar objetos importados ou exportados.
Este artigo descreve como o TDI e o TAMIT são integrados por meio de conectores recém-incluídos no TDI, ou seja, o Conector TPAE IF Simples e o TPAE IF.
Ele fornece etapas detalhadas para a:
- Instalação e configuração de middleware para o TAMIT.
- Instalação e configuração do TAMIT (Maximo).
- Configuração pós-instalação do Maximo.
- Configuração do Maximo para o Conector TPAE IF do TDI.
- Verificação de teste de solução do TDI.
- Resolução de problemas.
O diagrama abaixo descreve a arquitetura básica da solução, como o Conector TPAE IF do TDI se comunicará com a Estrutura de Integração (IF) do TPAE
Figura 1. Arquitetura
Instalação de Middleware para o TAMIT
Esta seção descreve a instalação do middleware necessária antes de o TAMIT ser instalado.
- Para a instalação do middleware, extraia todas as imagens de instalação do TAMIT e Middleware.
- Copie as imagens ausentes do diretório TAMFIT_V722_2of2_Multiplatform para oTAMFIT_V722_1of2_Multiplatform.
- Ative o TAMFIT_V722_1of2_Multiplatform\Launchpad.exe.
Figura 2. Assistente de Instalação do TAMIT
- Ative o IBM Tivoli Asset Management para o assistente de instalação de TI.
- Selecione o instalador de Middleware. Clique em Next.
- Especifique o diretório apropriado como área de trabalho para armazenar as opções de implementação e os parâmetros de configuração. Clique em Next.
- Selecione para instalar os seguintes recursos a serem implementados.
- Servidor de Banco de Dados.
- Directory Server.
- Servidor J2EE.
- Selecione Proteger o Servidor J2EE usando o Servidor de Diretório. Clique em Next.
- Faça o resumo dos componentes a serem instalados. Clique em Avançar
- Substitua o nome do host local que não está selecionado.
- Selecione a caixa de opção para usar essa senha como o valor para todas as senhas subsequentes. Especifique os valores apropriados de senha. Clique em Next.
- Selecione o local de Instalação apropriado.
- Especifique o nome de usuário e a senha (eles serão preenchidos automaticamente) para a Administração do Servidor do DB2. Clique em Next.
- Especifique o nome da instância padrão, porta da instância, nome de usuário e senha (preenchidos automaticamente). Clique em Next.
- Especifique os parâmetros de configuração Nome da instância, Porta, Nome de usuário da instância para a Instância do Banco de Dados. Clique em Next.
- Especifique os parâmetros de configuração para o Grupo de Administradores e grupo de usuários do DB2. Clique em Next.
- Especifique o Local de instalação dos parâmetros de configuração, o Nome distinto do administrador e a Senha de administrador (preenchidos automaticamente) para o Tivoli Directory Server (TDS). Clique em Next.
- Especifique os parâmetros de configuração Unidade de organização, Organização e sufixo de país, Porta do servidor de diretório, Porta segura do servidor de diretório, Porta de administração e Porta segura de administração para o TDS. Clique em Next.
- Especifique os parâmetros de configuração Nome do banco de dados, Nome da instância, Porta e Senha do usuário da instância para a Instância do TDS. Clique em Next.
- Especifique os parâmetros de configuração Nome do host do LDAP, Porta do servidor de diretório, Entrada de base do LDAP, Sufixo de Usuário, Sufixo de Grupo e Sufixo de contêiner da organização para a segurança do WebSphere Application Server (WAS). Clique em Next.
- Especifique os parâmetros de configuração Nome distinto da ligação e Senha da ligação para a segurança do WAS. Clique em Next.
- Especifique os parâmetros de configuração Local de instalação, Nome de usuário e Senha do administrador para o WAS ND. Clique em Next.
- Especifique os parâmetros de configuração Nome do Perfil de Gerenciador de Implementação e Nome do perfil do servidor de aplicativos. Clique em Next.
- Especifique os parâmetros de configuração Nome da célula, Nome do nó do Gerenciador de Implementação, Nome do nó do servidor de aplicativos, Nome do servidor de aplicativos e Local de instalação do Instalador de Atualização. Clique em Next.
- Especifique os parâmetros de configuração Local de instalação, Porta HTTP e Porta de servidor Admin para o IBM HTTP Server. Clique em Next.
- Especifique o parâmetro de configuração Nome do perfil para configurar o plug-in do WAS para o servidor IBM HTTP. Clique em Next.
- Selecione Especificar uma opção de diretório. Clique em Next.
- Especifique um diretório que tenha as imagens de instalação apropriadas disponíveis. Clique em Next.
- Se você enfrentar qualquer problema, como imagens não encontradas, consulte a seção de resolução de problemas para obter mais detalhes.
- Selecione Implementar o plano.
- A página de resumo será exibida antes do início da implementação. Clique em Implementar.
- Implementação em andamento.
Figura 3. Implementação de Middleware
- Assim que a implementação estiver concluída, a página de resumo será exibida. A instalação de middleware está concluída. Clique em Finish.
Esta seção descreverá a instalação do TAMIT.
Selecione Instalar o IBM Tivoli Asset Management for IT v7.2.2.0 a partir da barra de ativação
Figura 4. Instalador do TAMIT
- Selecione Tivoli Asset Management for IT 7.2.2.0 e clique em Avançar.
- Clique em Next.
- Selecione Diretório de instalação para o TAMIT e clique em Avançar.
- Selecione Simples. Clique em Next.
- Especifique o Nome do host, ID do usuário remoto e Senha remota. Clique em Next.
- Especifique o ID do usuário do banco de dados, Senha do banco de dados, ID do usuário administrador de instância do banco de dados e Senha do administrador de instância do banco de dados. Clique em Next.
- Especifique o ID do usuário e a Senha. Clique em Next.
- Mantenha o servidor SMTP e o email do Administrador em branco. Se necessário, o servidor SMTP poderá ser configurado posteriormente. Clique em Next.
- Selecione Integração de dados a serem implementados e os serviços do menu de contexto no mesmo banco de dados que foi criado para o produto. Clique em Next.
- Selecione Em um Novo Grupo de Programa. Especifique o Tivoli Asset Management for IT. Clique em Next.
- Clique em Instalar.
Figura 5. Sucesso na Instalação do TAMIT
- Clique em Concluído para concluir a instalação.
Configuração pós-instalação do Maximo
Efetue login no console do Maximo http://localhost/maximo/ui usando os privilégios de administrador e execute as etapa a seguir.
1. Crie uma organização com Site:
- Crie Códigos de unidade monetária:
- Acesse Financeiro ->Códigos de unidade monetária.
- Clique em Nova linha.
- Insira um nome (por exemplo, US$).
- Insira uma descrição (por exemplo, dólar americano).
- Salve.
2. Crie Conjuntos de Item e Empresa
- Acesse Administração->Conjuntos.
- Clique na Nova linha.
- Insira um nome de conjunto (por exemplo, Itens de TI).
- Insira "Tipo" como "ITEM"
- Configure o padrão "status de item padrão" para ATIVO.
- Clique na Nova linha.
- Insira o nome do conjunto (por exemplo, Comps de TI).
- Insira o Tipo = "EMPRESA".
- Configure o padrão "status de item padrão" para ATIVO.
- Salve.
3. Crie a Organização
- Acesse->Administração->Organizações.
- Clique no novo ícone da organização, na barra de ferramentas.
- Insira o Nome da organização (por exemplo, "IBM").
- Selecione a Moeda Base 1 (selecione a moeda criada na etapa 1).
- Selecione o Conjunto de Itens (selecione o Conjunto de itens criado na etapa 2).
- Selecione o Conjunto da Empresa (selecione o Conjunto da empresa criado na etapa 2).
- Selecione um status de item padrão (por exemplo, "PENDENTE").
- Configure 'status de item padrão' para "ativo".
- Salve.
- Clique na guia Site.
- Clique na nova linha, na guia Site.
- Insira o nome do site (por exemplo, 'B901').
- Salve a Organização.
4. Crie o Componente do GL
- Acesse >Configuração do Sistema->Configuração da Plataforma->Configuração do Banco de Dados.
- Na caixa suspensa 'Selecionar Ação', selecione 'Configuração de Conta Contábil'.
- Selecione 'Nova Linha'.
- Insira o Nome do componente 'SSSCOMPONENT' (ou qualquer nome).
- Insira o Comprimento '5'.
- Insira o Tipo 'ALN'.
- Delimitador de Tela '-' (sinal de menos).
- Clique em OK (pode demorar um pouco para obter novamente o controle, seja paciente).
5. Crie uma Conta Contábil
- Acesse >Finanças->Plano de Contas.
- Selecione a sua organização, "IBM", a partir da lista.
- Crie um Componente do GL.
- Na caixa suspensa 'Selecionar Ação', selecione 'Manutenção de Componente do GL'
- Clique na Nova linha.
- Insira um valor do Componente do GL (o comprimento deve ser menor que 5) (por exemplo, GLA1).
- Insira uma descrição do componente do GL (por exemplo, GLComponent1).
- Selecione "OK"
- Crie uma Conta Contábil.
- Clique na Nova linha nas Contas Contábeis
- Selecione o componente GLA1 da Conta Contábil.
- Escolha um segmento como 'SSSCOMPONENT'.
- Selecione "OK".
- Save
6. Configure a Conta de Compensação na Organização
- Volte para o Aplicativo da Organização.
- Selecione sua Org., "IBM".
- Acesse o campo Conta de Compensação e selecione o valor (selecione a Conta Contábil que acabou de ser criada).
- escolha um segmento como 'SSSCOMPONENT'.
- Verifique 'Ativo?'.
- Ative o Site
- Acesse a guia Sites
- Abra os retornos da entrada do site para ver os detalhes.
- Verifique "Ativo?"
- Salve.
7. Configure o site de inserção padrão
- Acesse >Segurança->Usuários.
- Procure por maxadmin e abra o registro.
- Configure 'Site de Inserção Padrão' para 'B901' (caso tenha usado um nome de site diferente nas etapas anteriores, use-o agora).
- Configure o 'Site de Almoxarifado para Requisições de Autoatendimento' também para 'B901'.
- Salve.
- Reinicie o mxserver a partir do console de admin do WAS.
8. Confirme Mudanças no Banco de Dados
- No Websphere - Interrompa o MXServer usando o Console de Admin do WAS.
Figura 6. Interrompa o Servidor Maximo
- Abra um prompt de comandos
- Acesse c:\ibm\smp\maximo\tools\maximo
- Execute o comando: configdb.bat. A saída abaixo seria visualizada.
Figura 7. Saída ConfigDB
- Execute o comando: dropbackup.bat. A saída abaixo seria visualizada.
Figura 8. Saída dropbackup
- No Websphere - Inicie o MXServer usando o Console de Admin do WAS.
Figura 9. Inicie o Servidor Maximo
- A configuração pós-instalação do Maximo está concluída.
Configurando o Maximo para usar o Conector TPAE IF do TDI
A configuração do Maximo para o conector TPAE IF do TDI precisa de configuração do sistema externo
A configuração do sistema externo possui duas etapas
- Gerando a definição de esquema XML
- Criando o Serviço Corporativo
Gerando a definição de esquema XML
Ao usar o Conector TPAE IF pela primeira vez, execute as etapas a seguir:
- Efetue logon no Maximo como administrador para executar as tarefas de configuração do sistema.
- A partir do menu Acessar, na Barra de Ferramentas de Navegação, selecione Integração -> Estruturas de Objeto para abrir o aplicativo Estruturas de Objeto.
- Repita as etapas a seguir para cada Estrutura do Objeto que você usará:
- Na guia Lista, procure pelo nome da Estrutura de Objeto, por exemplo, MXASSET.
- Para procurar, abra o Filtro e digite o nome da Estrutura de Objeto ou um nome parcial no campo Filtro da coluna da Estrutura de Objeto. Pressione ENTER.
- Clique no nome da Estrutura de Objeto para abrir seu registro.
- A partir do menu Selecionar Ação, selecione Gerar Esquema/Visualizar XML.
Figura 10. Gerar Esquema/XML
- Clique em OK. A caixa de diálogo Visualizar XML aparece.
- Clique em OK para retornar à guia Lista.
Criando Serviço Corporativo
O Conector Tpae IF suporta Serviços de Estrutura de Objeto e Serviços Corporativos. Caso o parâmetro Sistema Externo seja especificado, será necessário fornecer os nomes dos Serviços Corporativos para os parâmetros a seguir:
- Serviços Corporativos QUERY - este parâmetro requer serviços que são limitados à Estrutura de Objeto especificada.
- Serviços Corporativos SYNC - este parâmetro requer serviços que são limitados à Estrutura de Objeto especificada.
- Serviço Corporativo MAXOBJECT/MAXATTRIBUTE QUERY - este parâmetro é usado para obter informações de metadados para a Estrutura de Objeto e requer limite de serviço para a Estrutura de Objeto que contém MAXOBJECT/MAXATTRIBUTE MBOs.
O Conector Tpae IF usa esses parâmetros para consultar ou modificar uma Estrutura de Objeto usando os Serviços Corporativos, em vez dos Serviços de Estrutura de Objeto.
Observação: No caso do Conector TPAE IF Simples, pode ser necessário criar Serviços Corporativos para Criar, Atualizar, Excluir, Consultar e sincronizar operações
Para criar um Serviço Corporativo para uma Estrutura de Objeto por meio de um sistema externo especificado:
- Efetue logon ao Maximo como administrador para executar as tarefas de configuração do sistema.
- A partir do menu Acessar, na Barra de Ferramentas de Navegação, selecione Integração -> Serviços Corporativos para abrir o aplicativo de Serviços Corporativos.
- Clique em Novo Serviço Corporativo para criar um Serviço Corporativo.
- Forneça detalhes para os parâmetros a seguir:
- Serviço Corporativo - nome exclusivo para o Serviço Corporativo.
- Adaptador - nome do adaptador, que é usado pelo Serviço Corporativo. O nome padrão é Maximo.
- Estrutura de Objeto - nome da Estrutura de Objeto associada ao Serviço Corporativo.
- Operação - indica o tipo de operação. A operação padrão é Sincronização. A opção Sincronização inclui Criar, Excluir e Atualizar a funcionalidade. Para o Conector Tpae IF, é possível criar um Serviço Corporativo apenas para as operações de Consulta ou Sincronização
Figura 11. Criando Serviço Corporativo
- Ative e salve seu Serviço Corporativo.
- A partir do menu Acessar, na Barra de Ferramentas de Navegação, selecione Integração -> Externo para abrir o aplicativo de Sistemas Externos.
- Selecione o sistema externo e a sua guia Serviços Corporativos.
- Clique na Nova linha e digite o nome do Serviço Corporativo recém-criado
Figura 12. Incluindo Serviços Corporativos
- Ative o sistema externo
Figura 13. Ative o sistema externo
A configuração do Maximo para o conector TPAE IF do TDI está concluída
Verificação de teste de solução do TDI
- A primeira etapa do teste da solução é copiar os jars necessários, conforme indicado abaixo.
- Copie <TDI_Install_Dir>/examples/ TpaeIFConnector/ TpaeIFConnector.jar para o local <TDI_Install_Dir>/jars/connectors.
- Copie <TDI_Install_Dir>/examples/SimpleTpaeIFConnector/SimpleTpaeIFConnector.jar para o local "<TDI_Install_Dir>/jars/connectors.
- Ative o TDI v7.1 (o 7.1 Fix pack 6 é recomendado)
- Crie um projeto TDI de amostra, por exemplo, "TDI-TPAEProj", conforme mostrado abaixo.
- Clique em Arquivo -> Novo -> Projeto TDI
Figura 14. Projeto TDI
- Especifique qualquer nome de projeto, nesse caso, é "TDI-TPAEProj" e clique em Concluir.
Figura 15. Nome do projeto TDI
- Importe a configuração do <TDI_71_fp6_Install_Dir>/examples/TpaeIFConnector/TpaeIFConnector_example.xml.
- Para que isso possa ser feito, basta selecionar o projeto "TDI-TPAEProj" e clicar na opção Arquivo-> "Abrir arquivo de configuração do integrador de diretório do Tivoli" e usar o caminho de arquivo de configuração acima para importar.
- O AddOnly AL lê os ativos a partir de assets.txt e inclui esses Ativos no Maximo usando o Conector TPAE IF (incluir modo).
- Modifique os parâmetros de conexão a seguir no AddOnly AL, a fim de incluir o novo ativo ao Maximo.
- Modifique o <TDI_Install_Dir>/examples/ TpaeIFConnector/assets.txt (se necessário).
- Modifique a URL de Base a partir do parâmetro de conexão do TPAE IF.
- Modifique as credenciais (ID do usuário/Senha).
- Modifique a Estrutura de Objeto.
Figura 16. Painel do Conector TPAE
- Modifique também os parâmetros sob a seção Serviços Corporativos com os serviços criados e também modifique as informações de sistemas externos, conforme mostrado abaixo.
Figura 17. Painel do Conector TPAE Adiantado
Observação: O MyMaxEnter1 e o MyMaxEnter2 são os serviços corporativos criados anteriormente.
- Execute "AddOnly" AL e a saída a seguir será visualizada.
Figura 18. Saída AL
- Depois de executar o AL com sucesso, o ASSET-3 e ASSET-4 serão incluídos ao maximo. O assets.txt foi modificado com os valores ASSET-3 e ASSET-4.
- Verifique no console Maximo se o Ativo foi incluído.
- Efetue login no console do Maximo como administrador.
- Clique em Acessar -> Ativos -> Ativos
Figura 19. Ativo do Maximo
- Estando lá, aperte a tecla Enter uma vez e aparecerá "TDI-ASSET 3" e "TDI-ASSET 4". A imagem abaixo mostra os Ativos recém-incluídos "TDI-ASSET 3" e "TDI-ASSET 4" juntamente com os ativos existentes ("TDI-ASSET1", "TDI-ASSET2") criados antes.
Figura 20. Ativo Maximo
- A verificação está concluída.
- Da mesma forma, é possível executar outra operação como Iterar, Consultar, Atualizar e Excluir usando o Conector TPAE IF e também usando o Conector TPAE IF Simples
Problema-I: Falha na instalação do Middleware do TAMIT
Descrição: A instalação do Middleware do TAMIT falha quando as imagens do middleware estão ausentes
Figura 21. Falha na instalação
Solução:
Crie o novo diretório com o nome "middleware" e extraia todos os três zips de middleware para esse diretório e especifique esse caminho.
Problema-II:Falha na instalação do TAMIT com o usuário "maximo"
Descrição: Durante a instalação do TAMIT, em que o banco de dados do DB2 é configurado para o Maximo, a instalação falha com o erro a seguir
Figura 22. Falha na instalação
Solução: É necessário criar o usuário Maximo manualmente na máquina especificada, mas às vezes, isso não ajuda na máquina Windows, portanto, o usuário precisa reiniciar a máquina e limpar o diretório C:\ibm\smp. Verifique os serviços do DB2, WAS e TDS antes de iniciar a instalação.
Problema-III: Documentação incorreta
Descrição: No TDI v7.1 Fix pack 6 - documento <TDI_Install_Dir>/examples/ TpaeIFConnector/TpaeIFConnector.pdf sob a configuração do Sistema Externo - Criando o Serviço Corporativo - a Etapa 2 está errada, em vez disso, ela deveria estar conforme segue
A partir do menu Acessar, na Barra de Ferramentas de Navegação, selecione Integração -> Serviços Corporativos para abrir o aplicativo de Serviços Corporativos.
Problema-IV: Exemplo de falha de AL
Descrição: Assim que a configuração do sistema externo estiver concluída no ConectorTPAEIF, ao executar o exemplo do TDI TpaeIFConnector_example.xml, o AL falhará com o erro a seguir.
Lista 1.
'Error 500: nested exception is: psdi.util.MXApplicationException: |
Solução:
- Ative os sistemas externos juntamente com cada serviço corporativo criado.
Figura 23. Ative o sistema externo
Problema-V: Não é possível efetuar login no Maximo
Descrição: Às vezes, ao tentar efetuar login no console do Maximo, ele falha.
Solução:
- Certifique-se de que a instância do servidor do TDS esteja funcionando.
Problema-V: Extraindo erro/exceção detalhada do Maximo.
Descrição: Se uma AssemblyLine com um Conector TPAE IF falhar, é possível recuperar informações adicionais sobre o erro, conforme segue
Solução:
- Inclua o código a seguir em "Default On Error hook" ou "Prolog- On Connection error hook"...
task.logmsg("ERROR", "An exception occurred.");
mxConn.connector. extractMaximoException(error); //Assuming mxConn is connector name
task.dumpEntry(error);
|
- IBM Tivoli Asset Management for IT Documentation.
- IBM Tivoli Directory Integrator v7.1.0.6 - Documentação leia-me, consulte a seção: "Novos Recursos".
-
Faça o download de
versões de avaliação de produtos IBM
e use de forma prática as ferramentas de desenvolvimento de aplicativo e produtos de middleware do DB2®, Lotus
®, Rational®, Tivoli e WebSphere®.
Raghavendra T A é Staff Software Engineer, trabalhando atualmente com a equipe de desenvolvimento do Tivoli Directory Integrator no IBM India Software Labs. Possui mestrado em Engenharia de Sistemas pela Banaras Hindu University. É Administrador Certificado da IBM - Tivoli Monitoring V6.2, com certificação em implementação do IBM Tivoli Netcool/Omnibus V7.2.
Nagesh é Staff Software Engineer e atualmente trabalha com a equipe de suporte ao desenvolvimento do Tivoli Directory Integrator Nível 3 no IBM India Software Labs. É bacharel em Engenharia e em Ciência da Computação. É certificado para a implementação do IBM Tivoli Access Manager for e-business V6.0, IBM Tivoli Directory Server V6.2, IBM Tivoli Directory Integrator V7.1, associado ao IBM Certified DB2 V 8.1, associado e certificado no SUN Java Professional. Tem mais de seis anos de experiência em TI.
