IBM InfoSphere Master Data Management Collaboration Server Versão 11 Release 4. Guia de Migração SC

(1)

IBM InfoSphere Master Data Management Collaboration

Server

Versão 11 Release 4

Guia de Migração

SC19-4014-02

(2)

(3)

IBM InfoSphere Master Data Management Collaboration

Server

Versão 11 Release 4

Guia de Migração

SC19-4014-02

(4)

Nota

Antes de usar estas informações e o produto que ela suporta, leia as informações em “Avisos” na página 53.

Aviso da Edição

(5)

Índice

Tabelas . . . v

Figuras

. . . vii

Prefácio

. . . ix

O que há de novo na versão 11.4? . . . ix

Entrando em Contato com o IBM Software Support . x

Capítulo 1. Migrando . . . 1

Capítulo 2. Introdução. . . 3

Capítulo 3. Migrando de Versões

Anteriores . . . 5

Migrando Dados Principais do Formato Interno para o Formato XML . . . 7 Migrando da V9.1 para a V11.4 . . . 9 Migrando da V10.0 para a V11.4 . . . 13 Migrando da V10.1 para a V11.4 . . . 16 Migrando da V11.0 para a V11.4 . . . 19 Migrando da V11.3 para a V11.4 . . . 22

Capítulo 4. Migrando Scripts do

InfoSphere MDM Collaboration Server . 27

Diferenças de Script em Várias Versões . . . 27

Métodos com diferentes assinaturas na V6.0 e na V11.4 . . . 28

Métodos apenas na V9.0 transportados para a V11.4 . . . 28

Mudanças no comportamento de operações de script que existem a partir de V5.3.2 e V11.4 . . 37

Mudanças no comportamento das operações de script da V6.0 e V11.4 . . . 41

Diferenças da API Java Entre Várias Versões . . . 42

Enums e Métodos API Java . . . 42

Novas Interfaces API Java . . . 45

Mudanças nos pontos de extensão do Java . . . 46

Ajustando Seu Banco de Dados. . . 46

Capítulo 5. Resolução de Problemas

47

Resolvendo Problemas de Scripts de Migração. . . 47

Executando scripts de migração compilados . . 47

Erros Comuns de Compilação de Script . . . . 47

Erros e Problemas Comuns de Tempo de Execução . . . 48

Resolva problemas e erros de tempo de execução 49 Resolvendo Problemas de Migração . . . 50

Avisos . . . 53

Índice Remissivo . . . 59

Entrando em Contato com a IBM . . . 61

(6)

(7)

Tabelas

1. Motivos Possíveis para Erros e as Ações

Recomendadas . . . 9 2. Arquivos SQL para modificar ao usar nomes

de espaço de tabela customizados . . . 10 3. Arquivos SQL para modificar ao usar nomes

de espaço de tabela customizados . . . 13 4. Arquivos SQL para modificar ao usar nomes

de espaço de tabela customizados . . . 16

5. Arquivos SQL para modificar ao usar nomes de espaço de tabela customizados . . . 19 6. Arquivos SQL para modificar ao usar nomes

de espaço de tabela customizados . . . 22 7. Uma comparação dos métodos com diferentes

assinaturas no V6.0 e V11.4 . . . 28 8. Recursos da IBM . . . 61 9. Fornecendo Feedback para a IBM . . . 62

(8)

(9)

Figuras

(10)

(11)

Prefácio

Estas informações ajudam a migrar do IBM®InfoSphere Master Data Management Server for Product Information Management Versão 9.1.0 e IBM InfoSphere Master Data Management Collaboration Server Versões 10.0, 10.1, 11.0 e 11.3 para o IBM InfoSphere Master Data Management Collaboration Server Versão 11.4 através de um número de subetapas e migrações.

Sobre esta Publicação

As informações a seguir abrangem instruções passo-a-passo, melhores práticas, ajuste de desempenho e resolução de problemas comuns.

Público-alvo

Este guia de migração é destinado a instaladores, administradores de sistema e à equipe de Serviços Profissionais IBM para implementar com sucesso o produto em seu ambiente.

Informações de Pré-requisito e Relacionadas

Antes de usar este guia de migração, familiarize-se com as seguintes informações: v _{Centro de conhecimento do InfoSphere MDM Collaboration Server}

v _{Sua documentação do servidor de aplicativos} v _{Sua documentação do software de banco de dados}

Como Enviar Comentários

Seu feedback é importante para ajudar a fornecer as informações mais precisas e de alta qualidade. Se você tiver quaisquer comentários sobre este manual ou qualquer outra documentação do InfoSphere MDM Collaboration Server, use o formulário a seguir para nos enviá-los:

http://www.ibm.com/software/data/rcf/

O que há de novo na versão 11.4?

Há muitos novos recursos e funções no IBM InfoSphere Master Data Management Collaboration Server Versão 11.4.

O InfoSphere MDM Collaboration Server foi incluído no InfoSphere MDM Enterprise Edition e no InfoSphere MDM Collaborative Edition.

O InfoSphere MDM Collaboration Server permite que as empresas criem um único repositório atualizado de informações do produto que pode ser usado em toda a organização para iniciativas de negócios estratégicas.

As principais alterações no produto incluem:

(12)

Suporte de migração para usuários do InfoSphere MDM Collaboration Server

Os tópicos a seguir documentam os novos caminhos de migração de versões anteriores doInfoSphere MDM Collaboration Server para a versão 11.4: v _{Migrando da V9.1 para a V11.4} v _{Migrando da V10.0 para a V11.4} v _{Migrando da V10.1 para a V11.4} v _{Migrando da V11.0 para a V11.4} v _{Migrando da V11.3 para a V11.4}

Suporte de migração para o Advanced Catalog Management (ACM)

O Advanced Catalog Management (ACM) versão 11.0 FP5 introduz vários novos recursos. A fim de usar estes novos recursos, deve-se atualizar o modelo de dados. Para obter mais informações, consulte Migrando o Advanced Catalog Management.

Amostra de Solução Financeira

A Amostra de Solução Financeira é um modelo de dados de amostra implementado no MDM colaborativo para gerenciamento de dados de oferta de produto financeiro. Para obter mais informações, consulte Solução de Amostra Financeira.

Kit de Ferramentas de Solução Financeira

O Kit de Ferramentas de Solução Financeira é usado para publicar metadados de solução (por exemplo, Especificações) e dados de produto (por exemplo, Categoria e Produto) no MDM colaborativo e no MDM físico. Para obter mais informações, consulte MDM físico do IBM InfoSphere.

Aprimoramentos da API Java

APIs InfoSphere MDM Collaboration Server Java aprimoradas para o suporte xml de especificações unificadas. Para obter mais informações, consulte Documentação do IBM Javadoc e Esquema de objeto.

Upgrade de aplicativo e pilha

Os novos upgrades de pilha a seguir são suportados pelo InfoSphere MDM Collaboration Server:

v _{Atualize o Rational Architect Developer para a versão 9.1} v _{Atualize o WebSphere Portal Server para a versão 8.5}

Atualizações da documentação

Os itens a seguir são novos ou são atualizações para a documentação: v _{Novos tópicos e conteúdo atualizado na seção IBM WebSphere}

Commerce.

v _{Novos tópicos e conteúdo atualizado na seção Resolução de problemas e} suporte.

v _{Novos tópicos e conteúdo atualizado na seção Assegurando bom} desempenho.

Entrando em Contato com o IBM Software Support

O Suporte de Software IBM fornece assistência para defeitos de produto, responde a FAQs e executa a redescoberta.

(13)

Antes de Iniciar

Após tentar localizar sua resposta ou solução utilizando outras opções de

auto-ajuda como notas técnicas, é possível entrar em contato com o Suporte IBM. Antes de entrar em contato com o Suporte IBM, sua empresa deve ter um contrato de manutenção IBM ativo e deve estar autorizada a enviar problemas à IBM. Para obter informações sobre os tipos de suporte disponíveis, consulte o tópico Support portfolio no Software Support Handbook.

Ao entrar em contato com o IBM Software Support, é importante saber qual suporte está disponível na IBM:

v _{Perguntas específicas sobre o produto: Se você recebeu treinamento para o} produto, poderá enviar perguntas ou dúvidas específicas.

v _{Suporte a defeitos: A análise e o trabalho necessários para resolver um defeito} do produto ou oferecer uma solução alternativa.

v _{Operações de script: Para questões referentes a uma operação de script ou para} relatar um possível defeito em uma operação de script, é necessário simplificar sua questão ou problema para aproximadamente 5 linhas de código ou menos. – A IBM não oferece suporte para depuração e análise de scripts customizados. v _{Pedidos de aprimoramento: Pedidos de nova funcionalidade incluídos no}

produto.

Pedidos que não estão dentro do escopo do IBM Software Support e requerem que você entre em contato com seu representante de Vendas ou de Serviços

Profissionais:

v _{Trabalho diverso: Trabalho ou assistência que requer envolvimento extensivo da} IBM durante o processo de instalação ou de implementação, que inclui

instalações complexas ou instalação em várias plataformas.

v _{Suporte para clientes sem treinamento: Pedidos para ajuda passo-a-passo da} IBM, mas que não receberam treinamento necessário para o produto IBM. O IBM Education oferece treinamento ao cliente, se for necessário treinamento adicional pela equipe. Verifique o website da IBM para obter informações específicas sobre cursos disponíveis.

v _{Script ou scripts customizados: Nenhum suporte é fornecido para os scripts} criados ou que requerem depuração. Todos os scripts customizados criados pelos Serviços Profissionais pertencerão e serão mantidos por você, o cliente, quando o atendimento do Serviço for concluído. O Suporte Técnico não está disponível para criação e depuração de scripts customizados.

v _{Recuperação de dados: é altamente recomendável fazer backup regularmente de} seus dados.

v _{Assistência ou recomendações de desempenho ou ajuste que requerem dados do} cliente.

Procedimento

1. Verifique se já existe uma nota técnica referente ao seu problema. Para obter informações adicionais sobre a visualização de notas técnicas.

2. Determine se um contato ou sua equipe de suporte interno pode fornecer assistência.

3. Defina o problema, reúna informações complementares e determine a gravidade do problema. Para obter ajuda, consulte o “Before contacting IBM Software Support” no Software Support Handbook.

Informações Complementares Necessárias

(14)

v _{Todas as definições e informações de configuração.}

v _{O comportamento esperado versus o comportamento atual.} v _{Todas as mudanças ou modificações implementadas recentemente.} v _{Determine se o problema pode ser recriado.}

v _{Defina as etapas que levaram aos problemas que você está} enfrentando.

4. Reúna informações de diagnóstico:

v _{Também é possível utilizar o recurso de coleta de dados básicos do IBM} Support Assistant para coletar seus arquivos críticos de log e configuração; consulte www.ibm.com/software/support/isa/ para obter informações adicionais.

v _{Crie sua própria ferramenta coletora do IBM Support Assistant Lite através} do ambiente de trabalho.

a. Faça o download do complemento de produto no ambiente de trabalho do IBM Support Assistant.

b. Clique em Coletar e Enviar Dados. Três opções exibidas à esquerda. c. Escolha ...Utilizando o IBM Support Assistant Lite.

d. Crie o coletor gerado pela conclusão de cada uma das opções do coletor: – Selecione um coletor (Se o complemento de produto instalado não for exibido, ele não tem um documento Deve Reunir e não poderá criar um coletor do IBM Support Assistant Lite)

– Especifique o diretório de destino – Especifique o nome do arquivo – Clique no botão Exportar

e. Transfira o coletor do IBM Support Assistant Lite para um sistema remoto utilizando ftp ou qualquer outro protocolo de transferência de arquivos disponível.

f. Descompacte o arquivo ZIP do coletor do IBM Support Assistant Lite exportado para seu local de destino.

g. Configure o JAVA_HOME ou assegure que Java™esteja em sua instrução de caminho.

h. Execute o comando runISALite.bat para o Windows ou o script

runISALite.shpara UNIX e LINUX a partir das ferramentas do diretório do IBM Support Assistant Lite no sistema remoto.

i. Forneça as respostas adequadas para todos os prompts de coleta. j. Reveja os arquivos coletados ou os envie ao suporte IBM.

5. Envie seu problema para o IBM Software Support de uma das seguintes maneiras:

v _{On-line: (Recomendado)}

a. Clique em Abrir solicitação de serviço sob a seção Escolher sua tarefa na barra de navegação à esquerda do IBM InfoSphere Master Data

Management Collaboration Server Site de suporte.

b. Clique em ESR / SR e siga as instruções fornecidas no website do ESR. Use as seguintes diretrizes e dicas para utilização do ESR e o envio de PMRs:

– Anexe documentos diretamente ao PMR para disponibilizá-los para o IBM Support Services.

– O ESR gerencia uma lista de todos os PMRs que você visualizou para que tenha acesso imediato a eles para verificar o status.

(15)

– Use o ESR para configurar as notificações automáticas do PMR.

– Envie as atualizações dos PMRs que forem abertos para o IBM Support Services diretamente do ESR.

– Ao enviar um PMR, indique um nível de gravidade para nos ajudar a priorizar nossos recursos em relação a outros PMRs abertos:

Gravidade 1

Impacto de negócios crítico: Isso indica que você não pode usar o programa, o que resultará em um impacto de negócios sobre as operações. Essa condição requer uma solução

imediata.

Nota: Geralmente, impacto de negócios crítico significa que seu sistema de produção está desativado e, para que o IBM Software Support trabalhe fora de seu horário comercial, você deve garantir que haja um contato disponível por telefone, 24 horas por dia, 7 dias por semana, para facilitar as consultas do engenheiro verificador, a execução de testes em sua instância de produção, etc.

Gravidade 2

Impacto de negócios significativo: Isso indica que o programa é útil, mas severamente limitado.

Gravidade 3

Algum impacto de negócios: Isso indica que o programa é útil, mas com menos recursos significativos (não crítico para operações) indisponíveis.

Gravidade 4

Impacto de negócios mínimo: Isso indica que o problema causa pouco impacto sobre as operações ou que uma alternativa razoável para o problema foi implementada.

– Para abrir um Pedido de Aprimoramento (um pedido para nova funcionalidade geral do produto e não está relacionado a uma customização específica):

- Abra um PMR com gravidade 2, 3 ou 4, (dependendo do possível ganho de negócios do pedido) e o pedido será enviado para o IBM Product Management, para revisão. Você receberá um número de Pedido de Aprimoramento para fins de rastreamento, que substitui o número do PMR. Geralmente, sua aprovação é necessária para fechar o PMR.

v _{Por telefone: Para obter o número do telefone para o qual ligar em seu país,} acesse a Página Contacts do Software Support Handbook.

O que Fazer Depois

Se o problema enviado for relacionado a um defeito de software ou a uma documentação ausente ou inadequada, o IBM Software Support criará um APAR (Authorized Program Analysis Report). O APAR descreverá o problema em detalhes. Quando possível, o IBM Software Support oferecerá uma solução alternativa que você pode implementar até que o APAR seja resolvido e uma correção seja apresentada. A IBM publica APARs resolvidos no website de Suporte IBM diariamente para que outros usuários que tiveram o mesmo problema possam se beneficiar da mesma resolução.

(16)

(17)

Capítulo 1. Migrando

Se estiver usando uma versão anterior do IBM InfoSphere Master Data

Management Collaboration Server, você poderá migrar de sua versão para a versão mais atual.

Estas informações de instalação também estão disponíveis no InfoSphere MDM Collaboration Server Migration Guide, que está disponível no formato de manual em um arquivo PDF. Clique com o botão direito do mouse no link e selecione

Salvar Destino Comopara efetuar download do arquivo PDF em seu computador.

(18)

(19)

Capítulo 2. Introdução

Deve-se modificar o esquema de banco de dados de sua instalação atual usando os scripts de migração para migrar de versões anteriores para o IBM InfoSphere Master Data Management Collaboration Server Versão 11.4.

Deve-se ter permissões adequadas para criar e modificar tabelas e índices no banco de dados. Deve-se também ter permissões adequadas para criar e excluir arquivos nos subdiretórios do diretório $TOP.

A migração envolve as seguintes etapas básicas:

v _{Verifique se há espaço suficiente disponível na tabela de banco de dados.} v _{Pare a instância que está usando o esquema do banco de dados.}

v _{Faça backup do esquema de banco de dados existente.}

v _{Instale o InfoSphere MDM Collaboration Server V11.4 e aponte para o mesmo} esquema do banco de dados que a instância anterior estava usando.

v _{Execute o script de migração apropriado para modificar o esquema do banco de} dados e leve-o para o nível do InfoSphere MDM Collaboration Server V11.4.

(20)

(21)

Capítulo 3. Migrando de Versões Anteriores

É possível migrar para o IBM InfoSphere Master Data Management Collaboration Server Versão 11.4 de versões anteriores específicas.

Os caminhos de migração a seguir são suportados para a Versão 11.4: v _{Migrando da V9.1, Fix Pack 2 ou posterior para a V11.4}

v _{Migrando da V10.0, Fix Pack 1 ou posterior para a V11.4}

v _{Migrando da V10.1, GA e todos os níveis de Fix Pack para a V11.4} v _{Migrando da V11.0, GA e todos os níveis de Fix Pack para a V11.4} v _{Migrando da V11.3, GA para a V11.4}

Se estiver migrando para uma liberação superior, não um fix pack da mesma liberação, você deverá usar um novo diretório de instalação para evitar incompatibilidades de versão do arquivo JAR.

Se estiver migrando de uma versão de fix pack mais antiga, certifique-se de não estar usando nenhuma API excluída em seus scripts do Excel. As seguintes APIs não estão disponíveis no arquivo JAR POI mais recente:

v _{public String getExcelCellEncoding();} v _{public void setEncoding(String encoding);}

v _{public String getExcelCellEncoding(Object cellObj) throws} AustinException;

Nota:

1. O InfoSphere MDM Collaboration Server Excel Parser é suportado por um arquivo .jar de terceiro denominado poi-3.7-20101029.jar. Essa biblioteca suporta o formato Microsoft Excel 2007, que permite mais de 255 colunas por planilha de dados. Deve-se executar o script de Relatório de Resultado de Procura Detalhada. Ao executar esse script, a opção Script de Relatório de Resultado de Procura Detalhada (Excel 2007 – formato xlsx) deve ser usada para exportar itens com mais de 255 atributos.

2. É possível exportar Resultados de Procura Detalhada para arquivos no formato

Excel 2003usando a opção Script de Relatório de Resultados de Procura Detalhada Padrão. No entanto, com este formato, o relatório falhará se os itens tiverem mais de 255 atributos.

3. O .xlsx do Excel 2010 não é suportado por este JAR.

Importante: Antes de executar os scripts de migração, deve-se assegurar que a versão correta do banco de dados esteja sendo usada. Consulte os requisitos do sistema para obter detalhes: http://www-01.ibm.com/support/

docview.wss?uid=swg27035486. Você também deve assegurar que o usuário do banco de dados do InfoSphere MDM Collaboration Server tenha os privilégios apropriados conforme mencionado no guia de instalação. Consulte sua equipe DBA para quaisquer mudanças nos privilégios do usuário do banco de dados devido a qualquer política de segurança.

Deve-se usar a versão do banco de dados DB2 ou Oracle conforme mencionado nos requisitos do sistema. Consulte os requisitos do sistema para obter detalhes: http://www-01.ibm.com/support/docview.wss?uid=swg27035486. É possível

(22)

consultar a documentação do DB2 ou Oracle para fazer upgrade do banco de dados DB2 e Oracle para a versão suportada.

Etapas para migrar o MDM Colaborativo com espaços de tabela customizados são usados em DB2 e Oracle

Se estiver usando nomes de espaços de tabelas customizados em vez de USERS ou INDX padrão, deve-se modificar manualmente os nomes dos espaços de tabela nos arquivos SQL a seguir antes de iniciar a migração para o InfoSphere MDM

Collaboration Server.

Deve-se verificar se há pelo menos 30% de espaço livre no banco de dados antes de iniciar a migração.

Logs de auditoria não são migrados para a V11.4. Por causa de um novo formato de descrições de log de auditoria introduzido na V9.1.0, as descrições de log de auditoria presentes nas liberações anteriores à V9.1.0 não são visualizáveis na V11.4. Assim, elas são excluídas do banco de dados durante a migração. Os logs de auditoria antigos podem ser visualizados usando a liberação da qual você está migrando.

Deve-se executar manualmente as etapas a seguir para assegurar uma migração bem-sucedida:

1. Migre manualmente os arquivos de propriedades a seguir. Como os arquivos de propriedade fazem parte dos sistemas de arquivos locais, o método de migração não suporta a exportação de arquivos de propriedades. Modifique cada propriedade customizada de liberações anteriores para o arquivo

correspondente na nova versão. Não sobrescreva os arquivos de propriedade de uma versão mais antiga para uma nova versão porque novos parâmetros foram introduzidos na V11.4. Consulte a documentação do InfoSphere MDM

Collaboration Server para obter detalhes sobre cada arquivo de propriedade. v _{$TOP/etc/default/common.properties}

v _{$TOP/etc/default/logs.xml}

v _{$TOP/etc/default/docstore_mount.xml} v _{$TOP/etc/default/user_jars.list}

2. Copie manualmente o conteúdo do diretório $TOP/public_html/suppliers/<cmp code>/ctg_filespara a nova instância para cada empresa. Como esses

arquivos fazem parte do sistema de arquivos local, o método de migração não suporta a exportação do diretório ctg_files.

3. Inclua manualmente os arquivos JAR do usuário requeridos para a nova instância. Como esses arquivos fazem parte do sistema de arquivos local, o método de migração não suporta a exportação dos arquivos JAR do usuário. Para obter mais informações sobre como incluir arquivos JAR em sua implementação, consulte Implementando um arquivo .jar do usuário customizado.

4. Refaça manualmente todas as mudanças que você fez no Script de Relatório de Resultados da Procura Detalhada Padrão para customizá-lo. Migrar para o InfoSphere MDM Collaboration Server V11.4 sobrescreve o script existente disponível no diretório de armazenamento de documentos do InfoSphere MDM Collaboration Server, /scripts/report. Esse script é usado para exportar resultados da procura do objeto do InfoSphere MDM Collaboration Server para uma planilha do Excel. Para obter mais informações sobre esse script, consulte Exportando resultados da procura para o Excel.

(23)

5. Assegure que não haja opção de compilação detalhada configurada para a compilação de scripts. Verifique se no arquivo common.properties você não usa

verbose como o valor para o parâmetro script_compiler_options. Para obter

mais informações sobre esse parâmetro, consulte script_compiler_options parameters.

6. Execute o script setup.sh para verificar se a versão de PERL instalada no computador é compatível com a versão do InfoSphere MDM Collaboration Server que você instalou. Esse script está no diretório $TOP. Se a versão atual de PERL não for compatível, você deverá instalar uma nova versão.

7. Se você instalar a nova versão do InfoSphere MDM Collaboration Server em um novo diretório, deverá atualizar o valor das variáveis TOP e PERL5LIB no arquivo .bash_profile. Deve-se configurar a variável PERL5LIB para o diretório $TOP/bin/perllib.

Migrando Dados Principais do Formato Interno para o Formato XML

Deve-se converter os dados principais em XML ao migrar do IBM InfoSphere Master Data Management Server for Product Information Management Versões 6.0.0 ou 9.0.0 para o IBM InfoSphere Master Data Management Collaboration Server Versão 11.4.

Antes de Iniciar

1. Crie espaços de tabela XML e buffer pools conforme descrito no guia de instalação.

2. Certifique-se de que o usuário do banco de dados para o aplicativo InfoSphere MDM Collaboration Server tenha os privilégios do banco de dados apropriados conforme mencionado no guia de instalação.

3. Pare o aplicativo InfoSphere MDM Collaboration Server no servidor local. 4. Execute o script delete_old_versions.sh para excluir todas as versões antigas.

Use o código de sua empresa e a data atual como valores para os parâmetros

codee end_date.

5. Opcional – Aprimorar a memória disponível para o processo Java: Executar o script de conversão de dados é um processo intensivo de memória.

Recomenda-se fornecer 2 GB de memória para o processo Java atualizando o parâmetro custom_java_options no arquivo $TOP/bin/conf/env_settings.ini. Execute o configureEnv.sh depois de modificar o parâmetro

custom_java_optionspara assegurar que as configurações de nova memória atualizadas entrem em vigor.

custom_java_options=-Xmx2048m -Xms256m

Sobre Esta Tarefa

O script de migração de dados requer duas vezes o número de conexões de BD que o número de encadeamentos de execução. Por exemplo, se você usar 10 encadeamentos na opção de prompt de comandos, ele exigirá 20 conexões de BD. Você precisa configurar o número de conexões de BD usando esses dois

parâmetros de configuração: v _{db_maxConnection}

v _{db_maxConnection_default}

Os dois parâmetros estão disponíveis no arquivo common.properties. Se os valores desses parâmetros já forem maiores ou iguais às conexões de BD requeridas, não

(24)

será necessário alterar os valores. Se os valores desses parâmetros forem menores que as conexões de BD requeridas, você deverá aumentar os valores para melhorar a velocidade.

Se você tiver mais de 100.000 entradas de dados principais nos catálogos, aumente o número de encadeamentos. Por exemplo, você pode usar 50 ou 100

encadeamentos para concluir a migração de dados mais rápido. O número mais alto de encadeamentos que você pode usar depende das seguintes variáveis no InfoSphere MDM Collaboration Server. É possível avaliar o número ideal de encadeamentos executando o script de migração em um ambiente de teste. v _{Número de núcleos do processador disponíveis}

v _{Número de especificações definido} v _{Memória disponível}

Todas as especificações que são definidas no ambiente do InfoSphere MDM

Collaboration Server são recuperadas e usadas no processo de conversão de dados. Se você tiver mais de 100 especificações, atualize os parâmetros de armazenamento em cache de especificação para os valores apropriados para evitar trips frequentes do banco de dados e melhorar o desempenho geral do script.

Procedimento

1. Obtenha a contagem de especificação no InfoSphere MDM Collaboration Server usando o comando a seguir.

$PERL5LIB/runSQL.pl --sql_command="select count(*) from spc;"

2. Atualize esses parâmetros com os valores recuperados da consulta na Etapa 1. Esses parâmetros estão disponíveis no arquivo mdm-cache-config.properties no diretório $TOP/etc/default.

specCache_KEY_START_VERSION_TO_VALUE.maxElementsInMemory=<spec count> specCache_KEY_TO_CURRENT_START_VERSION.maxElementsInMemory=<spec count> specCache_KEY_VERSION_TO_START_VERSION.maxElementsInMemory=<spec count>

Nota: Executar o script configureEnv.sh depois de atualizar o arquivo mdm-cache-config.propertiessobrescreve os parâmetros com valores padrão. 3. Execute o shell script de migração de dados, migrateDataToXml.sh. Esse

arquivo está no diretório $TOP/bin/migration.

migrateDataToXml.sh --company=<company name> --threads=<number of threads> Em que

--company

Especifica o código da empresa que é usado para efetuar logon no InfoSphere MDM Collaboration Server.

--threads

Especifica o número de encadeamentos. Use um número maior de encadeamentos para melhorar a velocidade, mas assegure-se de que existam conexões de BD suficientes. O padrão é 1. É recomendado fornecer pelo menos 10 encadeamentos.

Por exemplo,

(25)

O que Fazer Depois

É possível verificar se o script funcionou conforme planejado observando os erros que são exibidos no console e registrados no arquivo default.log no diretório $TOP/logs/default. Uma lista de entradas que falharam ao migrar é exibida no final da execução.

O script de migração de dados atualiza o banco de dados em lotes. Se houver um erro, o lote inteiro é retrocedido. Por isso, o número de entradas que falharam ao migrar é maior que as falhas reais. Atualize o valor do parâmetro

index_regeneration_batch_sizepara 1 no arquivo common.properties e, em seguida, execute o script de migração de dados novamente para reduzir as entradas com falhas reais. É fornecida uma tabela dos motivos possíveis para os erros durante a migração de dados e as ações recomendadas:

Tabela 1. Motivos Possíveis para Erros e as Ações Recomendadas

Motivos para o erro durante

a migração de dados Ação recomendada

A migração de dados exibe o seguinte erro:

java.sql.SQLException: ORA-00600: internal error code, arguments: [KGHALP1], [0x000000000], [], [], [],

[], [], [], [], [], [], []

Certifique-se de estar usando o nível de correção correto para o banco de dados. Se necessário, atualize o banco de dados e, em seguida, execute o script de migração de dados novamente.

A migração de dados exibe o seguinte erro:

java.sql.SQLException: ORA-31061: XDB error: XML event error

ORA-19202: Error occurred in XML processing

In line 46 of orastream: LPX-00241: entity reference

is not well formed

Um dos valores de atributo na entrada tem o caractere "&" ou um valor inválido. Atualize a entrada para remover o valor inválido da interface de edição do item do InfoSphere MDM Collaboration Server e, em seguida, tente a migração de dados novamente.

Migrando da V9.1 para a V11.4

Para migrar para o IBM InfoSphere Master Data Management Collaboration Server Versão 11.4 do IBM InfoSphere Master Data Management Server for Product Information Management Versão 9.1.0, deve-se executar o script de migração apropriado.

Antes de Iniciar

Antes de ser possível migrar do InfoSphere MDM Server for PIM V9.1.0 para o InfoSphere MDM Collaboration Server V11.4, deve-se assegurar de usar

especificamente o Fix Pack 2 ou fix packs posteriores para a V9.1.0. Se estiver utilizando o V9.1.0 com qualquer outro nível de fix pack, você deverá migrar para a versão V9.1.0 Fix Pack 2 ou fix packs mais recentes. Conclua as instruções nas notas sobre a liberação adequadas.

Também é necessário assegurar que todos os espaços de tabela relacionados ao XML sejam criados conforme descrito no guia de instalação. Assegure-se de que o

(26)

usuário do banco de dados InfoSphere MDM Collaboration Server tenha privilégios apropriados para usar os novos espaços de tabela.

É possível configurar o local do arquivo de log de erro modificando a variável

_ERROR_LOGS no script de migração migrateFrom910.sh. Esta variável é

configurada para $TOP/logs/errfile.log por padrão.

Se estiver usando os nomes de espaço de tabela customizada em vez de USERS ou INDX padrão, deve-se modificar manualmente os nomes de espaço de tabela em create_pimdb.sh e create_pimdb_for_zLinux.sh na pasta $TOP/bin/db_creation. Além disso, deve-se modificar manualmente os nomes de espaço de tabela nos arquivos SQL a seguir. Esta modificação deve acontecer antes de iniciar a migração para o InfoSphere MDM Collaboration Server V11.4.

Tabela 2. Arquivos SQL para modificar ao usar nomes de espaço de tabela customizados

Arquivos SQL a modificar quando o DB2 for o banco de dados de backend

Arquivos SQL a modificar quando o Oracle for o banco de dados de backend

Modifique os nomes de espaço de tabela de USERS, INDX e BLOB_TBL_DATA para os nomes de espaço de tabela customizados apropriados nos arquivos SQL a seguir no diretório $TOP/src/db/schema/dbscripts/ db2_: addCaeStepEntryDate.sql addCehEntryId.sql addObhCompanyId.sql addSstShared.sql

Modifique os nomes de espaço de tabela de USERS, INDX e BLOB_TBL_DATA para os nomes de espaço de tabela customizados apropriados nos seguintes arquivos SQL no diretório $TOP/src/db/schema/dbscripts/ oracle: addSstShared.sql add_icm_index.sql add_lot_index.sql add_sca_index.sql add_sit_index1.sql redefine_ctg_indexes.sql modifyIcm1Index.sql

Sobre Esta Tarefa

As etapas a seguir são a única maneira de migrar do InfoSphere MDM Server for PIM V9.1.0 para o InfoSphere MDM Collaboration Server V11.4, e nenhum outro meio. Não é possível utilizar a ferramenta de exportação e importação de ambiente.

Procedimento

1. Faça backup do esquema de banco de dados existente.

2. Instale o InfoSphere MDM Collaboration Server V11.4 em um diretório diferente.

3. Configure seu banco de dados.

a. Para DB2 bancos de dados, crie novos buffer pools e espaços de tabela conforme mencionado em Configurando o backup de seu banco de dados DB2 no guia de instalação.

Nota: O tamanho do espaço de tabela XML_DATA deve ser igual ao espaço ocupado pelo espaço de tabela TCTG_ITD_ITEM_DETAIL. É possível localizar o tamanho aproximado da tabela usando a seguinte consulta: select (fpages * 16) / 1024 megabytes from syscat.tables

em que tabschema = esquema atual e tabname como ’TCTG_ITD_ITEM_DETAIL’;

(27)

b. Para bancos de dados Oracle, crie novos espaços de tabela e, em seguida, instale o componente Oracle XML DB conforme mencionado em

Configurando seu banco de dados Oracle no guia de instalação. 4. Aponte a instância do InfoSphere MDM Collaboration Server V11.4 para o

esquema do banco de dados da V9.1.0, Fix Pack 2 ou posterior. Para apontar a instância para o banco de dados, inclua os parâmetros do banco de dados no arquivo env_settings.ini. Para obter mais informações, consulte Configurando Parâmetros Comuns do Banco de Dados.

5. Execute o script de migração migrateFrom910FP.sh. Este script está disponível no diretório $TOP/bin/migration. Consulte a seção Resultados do resumo de migração. Se a migração não foi bem-sucedida, é possível executar o script de migração novamente.

6. Migre seus dados conforme mencionado em Migrando dados principais do formato interno para o formato XML.

7. Execute o script test_db.sh para verificar o esquema do banco de dados, a conectividade entre o InfoSphere MDM Collaboration Server e os bancos de dados e para verificar o JDBC e as conexões do cliente nativo. Para obter mais informações, consulte Script test_db.sh.

8. Inicie a instância do InfoSphere MDM Collaboration Server V11.4.

Resultados

Todas as mensagens, como o status de componentes de migração individuais e o resumo geral da migração, são exibidas no console.

Depois de executar o script de migração, as mensagens são exibidas no console que indica se a migração foi bem-sucedida ou falhou.

Essa mensagem será exibida se a migração foi bem-sucedida: ---Resumo da migração

---A migração para o IBM InfoSphere Master Data Management

O Collaboration Server Versão 11.4.0 está concluído. Verifique as mensagens para ver se há algum erro.

Gerando o relatório de verificação do banco de dados... ___________________________________________________________ Tabelas alteradas

=========================================================== Não há nenhuma tabela alterada

___________________________________________________________

___________________________________________________________ Tabelas Ausentes

=========================================================== Não há nenhuma tabela ausente

___________________________________________________________

___________________________________________________________ Índices Alterados

(28)

=========================================================== Não há nenhum índice alterado

___________________________________________________________

___________________________________________________________ Índices Ausentes

=========================================================== Não há nenhum índice ausente

___________________________________________________________ LOG FILE: $TOP/logs/default/default.log

Essa mensagem será exibida se a migração tiver falhado: !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Falha na Migração: xxxx

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

Consulte o arquivo para obter detalhes adicionais: /home/pimuser/mdmcs11/logs/errfile.log Essa mensagem será exibida se a migração de módulos específicos tiver falhado:

---Resumo da migração

---A migração dos seguintes módulos falhou:

Essa mensagem será exibida se houver uma discrepância nas tabelas ou índices do banco de dados.

=========================================================== <nomes das tabelas>

___________________________________________________________

=========================================================== <nomes dos índices>

___________________________________________________________

(29)

Revise o arquivo errfile.log para obter mais mensagens. Para erros de SQL, localize a mensagem de erro detalhada a partir do código de erro SQL, corrija o erro e execute o script de migração novamente. Para obter a ação recomendada nas falhas de migração, consulte Resolvendo problemas de migração. Entre em contato com o Suporte de Software IBM se o problema persistir depois de corrigir os erros.

Migrando da V10.0 para a V11.4

Para migrar para o IBM InfoSphere Master Data Management Collaboration Server Versão 11.4 do IBM InfoSphere Master Data Management Server for Product Information Management Versão 10.0.0, deve-se executar o script de migração apropriado.

Antes de Iniciar

Antes de ser possível migrar do InfoSphere MDM Collaboration Server V10.0.0 para a V11.4, deve-se assegurar de usar especificamente o Fix Pack 1 ou posterior para a V10.0.0. Se estiver usando a V10.0.0 GA, você deverá migrar para a V10.0.0 Fix Pack 1 ou posterior seguindo as instruções nas notas sobre a liberação

adequadas.

É possível configurar o local do arquivo de log de erros modificando a variável

Se estiver usando os nomes de espaço de tabela customizada em vez de o USERS ou INDX padrão, deve-se modificar manualmente os nomes de espaço de tabela em create_pimdb.sh e create_pimdb_for_zLinux.sh na pasta $TOP/bin/

db_creation. Além disso, deve-se modificar manualmente os nomes de espaço de tabela nos arquivos SQL a seguir. Esta modificação deve acontecer antes de iniciar a migração para o InfoSphere MDM Collaboration Server V11.4.

Modifique os nomes de espaço de tabela de USERS, INDX e BLOB_TBL_DATA para os nomes de espaço de tabela customizados apropriados nos seguintes arquivos SQL no diretório $TOP/src/db/schema/dbscripts/ oracle_: addSstShared.sql add_icm_index.sql add_lot_index.sql add_sca_index.sql add_sit_index1.sql redefine_ctg_indexes.sql modifyIcm1Index.sql

(30)

Sobre Esta Tarefa

As etapas a seguir são a única maneira de migrar do InfoSphere MDM

Collaboration Server V10.0.0 para V11.4, e nenhum outro meio. Não é possível utilizar a ferramenta de exportação e importação de ambiente.

Procedimento

3. Aponte a instância do InfoSphere MDM Collaboration Server V11.4 para o esquema do banco de dados da V10.0.0, Fix Pack 1 ou posterior. Para apontar a instância para o banco de dados, inclua os parâmetros do banco de dados no arquivo env_settings.ini. Para obter mais informações, consulte Configurando Parâmetros Comuns do Banco de Dados.

Resultados

___________________________________________________________

(31)

___________________________________________________________

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

___________________________________________________________

(32)

Migrando da V10.1 para a V11.4

Para migrar para o IBM InfoSphere Master Data Management Collaboration Server Versão 11.4 do IBM InfoSphere Master Data Management Collaboration Server Versão 10.1.0, deve-se executar o script de migração apropriado.

Antes de Iniciar

Modifique os nomes de espaço de tabela de USERS, INDX e BLOB_TBL_DATA para os nomes de espaço de tabela customizados apropriados nos arquivos SQL a seguir no diretório $TOP/src/db/schema/dbscripts/ db2: addCaeStepEntryDate.sql addCehEntryId.sql addObhCompanyId.sql addSstShared.sql

Sobre Esta Tarefa

É possível migrar para o InfoSphere MDM Collaboration Server Versão 11.4 do InfoSphere MDM Collaboration Server Versão 10.1.0 GA ou qualquer fix pack (1, 6, 7, 8, 9, 10 ou 11).

(33)

Collaboration Server V10.1.0 para a V11.4, e nenhum outro meio. Não é possível utilizar a ferramenta de exportação e importação de ambiente.

Procedimento

3. Aponte a instância do InfoSphere MDM Collaboration Server V11.4 para o esquema do banco de dados da V10.1.0. Para apontar a instância para o banco de dados, inclua os parâmetros do banco de dados no arquivo

env_settings.ini. Para obter mais informações, consulte Configurando Parâmetros Comuns do Banco de Dados.

Resultados

___________________________________________________________

(34)

___________________________________________________________

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

___________________________________________________________

(35)

___________________________________________________________

Migrando da V11.0 para a V11.4

Para migrar para o IBM InfoSphere Master Data Management Collaboration Server Versão 11.4 do IBM InfoSphere Master Data Management Collaboration Server Versão 11.0.0, deve-se executar o script de migração apropriado.

Antes de Iniciar

Modifique os nomes de espaço de tabela de USERS, INDX e BLOB_TBL_DATA para os nomes de espaço de tabela customizados apropriados nos arquivos SQL a seguir no diretório $TOP/src/db/schema/dbscripts/ db2: addCaeStepEntryDate.sql addCehEntryId.sql addObhCompanyId.sql addSstShared.sql

Sobre Esta Tarefa

É possível migrar para o InfoSphere MDM Collaboration Server Versão 11.4 do InfoSphere MDM Collaboration Server Versão 11.0.0 GA, qualquer fix pack (1 para 5).

(36)

As etapas a seguir são a única maneira de migrar do InfoSphere MDM Collaboration Server V11.0.0 para V11.4, e nenhum outro meio. Não é possível utilizar a ferramenta de exportação e importação de ambiente.

Procedimento

1. Pare a instância em execução do InfoSphere MDM Collaboration Server V11.0.0. 2. Faça backup do esquema de banco de dados existente.

4. Aponte a instância do InfoSphere MDM Collaboration Server V11.4 para o esquema do banco de dados da V11.0.0. Para apontar a instância para o banco de dados, inclua os parâmetros do banco de dados no arquivo

env_settings.ini. Para obter mais informações, consulte Configurando Parâmetros Comuns do Banco de Dados.

Resultados

___________________________________________________________

(37)

Tabelas Ausentes

___________________________________________________________

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

___________________________________________________________

(38)

___________________________________________________________

Migrando da V11.3 para a V11.4

Para migrar para o IBM InfoSphere Master Data Management Collaboration Server Versão 11.4 do IBM InfoSphere Master Data Management Collaboration Server Versão 11.3, deve-se executar o script de migração apropriado.

Antes de Iniciar

Modifique os nomes de espaço de tabela de USERS, INDX e BLOB_TBL_DATA para os nomes de espaço de tabela customizados apropriados nos seguintes arquivos SQL no diretório $TOP/src/db/schema/dbscripts/ oracle_: addSstShared.sql add_icm_index.sql add_lot_index.sql add_sca_index.sql add_sit_index1.sql redefine_ctg_indexes.sql modifyIcm1Index.sql

Sobre Esta Tarefa

É possível migrar para o InfoSphere MDM Collaboration Server Versão 11.4 do InfoSphere MDM Collaboration Server Versão 11.3 GA.

(39)

Collaboration Server V11.3 para a V11.4, e nenhum outro meio. Não é possível utilizar a ferramenta de exportação e importação de ambiente.

É possível configurar o local do arquivo do log de erros modificando a variável

Procedimento

1. Pare a execução da instância do InfoSphere MDM Collaboration Server V11.3. 2. Faça backup do esquema de banco de dados existente.

4. Aponte a instância do InfoSphere MDM Collaboration Server V11.4 para o esquema do banco de dados da V11.3. Para apontar a instância para o banco de dados, inclua os parâmetros do banco de dados no arquivo env_settings.ini. Para obter mais informações, consulte Configurando Parâmetros Comuns do Banco de Dados.

5. Execute o script de migração do migrateFrom1130FP.sh. Este script está disponível no diretório $TOP/bin/migration. Consulte a seção Resultados do resumo de migração. Se a migração não foi bem-sucedida, é possível executar o script de migração novamente.

Resultados

___________________________________________________________

(40)

Tabelas Ausentes

___________________________________________________________

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

___________________________________________________________

(41)

___________________________________________________________

(42)

(43)

Capítulo 4. Migrando Scripts do InfoSphere MDM

Collaboration Server

É possível usar scripts para executar várias funções dentro do IBM InfoSphere Master Data Management Collaboration Server. Os scripts fornecem um alto grau de flexibilidade sem comprometer a eficiência da operação ou a facilidade do desenvolvimento.

Diferenças de Script em Várias Versões

A versão base que é usada para o IBM InfoSphere Master Data Management Collaboration Server Versão 11.4 é WebSphere Product Center Versão 5.0.1; portanto, há diferenças funcionais e comportamentais entre a V5.2.1 e a V11.4. Os atributos de tipo de dados Flag retornam valores diferentes na V11.4. Em V5.2.1, o tipo de dados Flag retornou uma sequência TRUE/FALSE. Em V11.4, o tipo de dados Flag retorna um equivalente de um valor booleano Java, que pode ter os valores true/false/null. Portanto, quando você compara um atributo de sinalizador, a comparação deve ser como a seguir:

if (flagValue==null)

Se o valor de um Flag for impresso, por exemplo, out.write(flagValue);, os valores impressos serão null, false ou true.

Como o código é compilado em Java ao usar compiled_only_mode, ele lançará uma exceção se os scripts IBM InfoSphere Master Data Management Collaboration Server contiverem palavras-chave Java como variáveis. Além disso, scripts não compilam se contiverem variáveis que já estejam sendo usadas pelo InfoSphere MDM Collaboration Server no código gerado. Por exemplo, logger e hmContext. Outra diferença chave existe nos métodos que retornam um ItemSet ou um

CategorySet: Na V5.2.1, se o método não buscou nenhum resultado, ele retornou null. Em V5.3.2, e, portanto, em V11.4, esses métodos retornam um conjunto vazio

v _{Aqui estão os métodos que retornam um ItemSet:}

– getCtgItemByAttributeValue(String sNodePath, String sValue) – getItemSetForCategory(Catalog ctg [, Boolean ordered]) – getItemSetForCatalog()

– getItemSetForUnassigned(CategoryTree ctr, boolean readOnly) – getItemSetForPrimaryKeys(Array pkeys, Boolean bOptimize) – getItemSetForSelection()

– getSubset(IItemSet items, Integer start_point [, Integer end_point]) v _{Aqui estão os métodos que retornam um CategorySet:}

– getCategorySet([Boolean bReadonly])

– getDescendentCategorySetForCategory([Boolean bReadonly])

– getCategorySetByAttributeValue(String attribPath, Object attribValue, [Boolean bReadOnly])

– getCategorySetByPrimaryKey(String primaryKey, [Boolean bReadOnly]) – getCategorySetByLevel(Integer level, [Boolean bReadOnly])