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

Transcrição

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

2

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

4 Nota Antes de usar estas informações e o produto que ela suporta, leia as informações em Aisos na página 53. Aiso da Edição Esta edição se aplica à ersão 11.4 do IBM InfoSphere Master Data Management e a todas as liberações e modificações subsequentes até que seja indicado de outra forma em noas edições. Copyright IBM Corporation 2000, 2014.

5 Índice Tabelas Figuras ii Prefácio ix O que há de noo na ersão 11.4? ix Entrando em Contato com o IBM Software Support. x Capítulo 1. Migrando Capítulo 2. Introdução Capítulo 3. Migrando de Versões Anteriores Migrando Dados Principais do Formato Interno para o Formato XML Migrando da V9.1 para a V Migrando da V10.0 para a V Migrando da V10.1 para a V Migrando da V11.0 para a V Migrando da V11.3 para a V Capítulo 4. Migrando Scripts do InfoSphere MDM Collaboration Serer. 27 Diferenças de Script em Várias Versões Métodos com diferentes assinaturas na V6.0 e na V Métodos apenas na V9.0 transportados para a V Mudanças no comportamento de operações de script que existem a partir de V5.3.2 e V Mudanças no comportamento das operações de script da V6.0 e V Diferenças da API Jaa Entre Várias Versões Enums e Métodos API Jaa Noas Interfaces API Jaa Mudanças nos pontos de extensão do Jaa Ajustando Seu Banco de Dados Capítulo 5. Resolução de Problemas 47 Resolendo Problemas de Scripts de Migração Executando scripts de migração compilados.. 47 Erros Comuns de Compilação de Script Erros e Problemas Comuns de Tempo de Execução Resola problemas e erros de tempo de execução 49 Resolendo Problemas de Migração Aisos Índice Remissio Entrando em Contato com a IBM Copyright IBM Corp. 2000, 2014 iii

6 i InfoSphere MDM Collaboration Serer: Guia de Migração

7 Tabelas 1. Motios Possíeis para Erros e as Ações Recomendadas Arquios SQL para modificar ao usar nomes de espaço de tabela customizados Arquios SQL para modificar ao usar nomes de espaço de tabela customizados Arquios SQL para modificar ao usar nomes de espaço de tabela customizados Arquios SQL para modificar ao usar nomes de espaço de tabela customizados Arquios SQL para modificar ao usar nomes de espaço de tabela customizados Uma comparação dos métodos com diferentes assinaturas no V6.0 e V Recursos da IBM Fornecendo Feedback para a IBM Copyright IBM Corp. 2000, 2014

8 i InfoSphere MDM Collaboration Serer: Guia de Migração

9 Figuras Copyright IBM Corp. 2000, 2014 ii

10 iii InfoSphere MDM Collaboration Serer: Guia de Migração

11 Prefácio Estas informações ajudam a migrar do IBM InfoSphere Master Data Management Serer for Product Information Management Versão e IBM InfoSphere Master Data Management Collaboration Serer Versões 10.0, 10.1, 11.0 e 11.3 para o IBM InfoSphere Master Data Management Collaboration Serer Versão 11.4 atraé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-alo Este guia de migração é destinado a instaladores, administradores de sistema e à equipe de Seriç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: Centro de conhecimento do InfoSphere MDM Collaboration Serer Sua documentação do seridor de aplicatios Sua documentação do software de banco de dados Como Eniar Comentários Seu feedback é importante para ajudar a fornecer as informações mais precisas e de alta qualidade. Se ocê tier quaisquer comentários sobre este manual ou qualquer outra documentação do InfoSphere MDM Collaboration Serer, use o formulário a seguir para nos eniá-los: O que há de noo na ersão 11.4? Há muitos noos recursos e funções no IBM InfoSphere Master Data Management Collaboration Serer Versão O InfoSphere MDM Collaboration Serer foi incluído no InfoSphere MDM Enterprise Edition e no InfoSphere MDM Collaboratie Edition. O InfoSphere MDM Collaboration Serer 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 iniciatias de negócios estratégicas. As principais alterações no produto incluem: Copyright IBM Corp. 2000, 2014 ix

12 Suporte de migração para usuários do InfoSphere MDM Collaboration Serer Os tópicos a seguir documentam os noos caminhos de migração de ersões anteriores doinfosphere MDM Collaboration Serer para a ersão 11.4: Migrando da V9.1 para a V11.4 Migrando da V10.0 para a V11.4 Migrando da V10.1 para a V11.4 Migrando da V11.0 para a V11.4 Migrando da V11.3 para a V11.4 Suporte de migração para o Adanced Catalog Management (ACM) O Adanced Catalog Management (ACM) ersão 11.0 FP5 introduz ários noos recursos. A fim de usar estes noos recursos, dee-se atualizar o modelo de dados. Para obter mais informações, consulte Migrando o Adanced Catalog Management. Amostra de Solução Financeira A Amostra de Solução Financeira é um modelo de dados de amostra implementado no MDM colaboratio 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 colaboratio e no MDM físico. Para obter mais informações, consulte MDM físico do IBM InfoSphere. Aprimoramentos da API Jaa APIs InfoSphere MDM Collaboration Serer Jaa aprimoradas para o suporte xml de especificações unificadas. Para obter mais informações, consulte Documentação do IBM Jaadoc e Esquema de objeto. Upgrade de aplicatio e pilha Os noos upgrades de pilha a seguir são suportados pelo InfoSphere MDM Collaboration Serer: Atualize o Rational Architect Deeloper para a ersão 9.1 Atualize o WebSphere Portal Serer para a ersão 8.5 Atualizações da documentação Os itens a seguir são noos ou são atualizações para a documentação: Noos tópicos e conteúdo atualizado na seção IBM WebSphere Commerce. Noos tópicos e conteúdo atualizado na seção Resolução de problemas e suporte. Noos 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. x InfoSphere MDM Collaboration Serer: Guia de Migração

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íel entrar em contato com o Suporte IBM. Antes de entrar em contato com o Suporte IBM, sua empresa dee ter um contrato de manutenção IBM atio e dee estar autorizada a eniar problemas à IBM. Para obter informações sobre os tipos de suporte disponíeis, 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íel na IBM: Perguntas específicas sobre o produto: Se ocê recebeu treinamento para o produto, poderá eniar perguntas ou dúidas específicas. Suporte a defeitos: A análise e o trabalho necessários para resoler um defeito do produto ou oferecer uma solução alternatia. Operações de script: Para questões referentes a uma operação de script ou para relatar um possíel 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. Pedidos de aprimoramento: Pedidos de noa funcionalidade incluídos no produto. Pedidos que não estão dentro do escopo do IBM Software Support e requerem que ocê entre em contato com seu representante de Vendas ou de Seriços Profissionais: Trabalho dierso: Trabalho ou assistência que requer enolimento extensio da IBM durante o processo de instalação ou de implementação, que inclui instalações complexas ou instalação em árias plataformas. 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íeis. Script ou scripts customizados: Nenhum suporte é fornecido para os scripts criados ou que requerem depuração. Todos os scripts customizados criados pelos Seriços Profissionais pertencerão e serão mantidos por ocê, o cliente, quando o atendimento do Seriço for concluído. O Suporte Técnico não está disponíel para criação e depuração de scripts customizados. Recuperação de dados: é altamente recomendáel fazer backup regularmente de seus dados. 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 isualizaçã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 graidade do problema. Para obter ajuda, consulte o Before contacting IBM Software Support no Software Support Handbook. Informações Complementares Necessárias Prefácio xi

14 Todas as definições e informações de configuração. O comportamento esperado ersus o comportamento atual. Todas as mudanças ou modificações implementadas recentemente. Determine se o problema pode ser recriado. Defina as etapas que learam aos problemas que ocê está enfrentando. 4. Reúna informações de diagnóstico: Também é possíel utilizar o recurso de coleta de dados básicos do IBM Support Assistant para coletar seus arquios críticos de log e configuração; consulte para obter informações adicionais. Crie sua própria ferramenta coletora do IBM Support Assistant Lite atraé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 Eniar 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 Dee Reunir e não poderá criar um coletor do IBM Support Assistant Lite) Especifique o diretório de destino Especifique o nome do arquio 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 arquios disponíel. f. Descompacte o arquio ZIP do coletor do IBM Support Assistant Lite exportado para seu local de destino. g. Configure o JAVA_HOME ou assegure que Jaa esteja em sua instrução de caminho. h. Execute o comando runisalite.bat para o Windows ou o script runisalite.sh para 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. Reeja os arquios coletados ou os enie ao suporte IBM. 5. Enie seu problema para o IBM Software Support de uma das seguintes maneiras: On-line: (Recomendado) a. Clique em Abrir solicitação de seriço sob a seção Escolher sua tarefa na barra de naegação à esquerda do IBM InfoSphere Master Data Management Collaboration Serer Site de suporte. b. Clique em ESR/SRe siga as instruções fornecidas no website do ESR. Use as seguintes diretrizes e dicas para utilização do ESR e o enio de PMRs: Anexe documentos diretamente ao PMR para disponibilizá-los para o IBM Support Serices. O ESR gerencia uma lista de todos os PMRs que ocê isualizou para que tenha acesso imediato a eles para erificar o status. xii InfoSphere MDM Collaboration Serer: Guia de Migração

15 Use o ESR para configurar as notificações automáticas do PMR. Enie as atualizações dos PMRs que forem abertos para o IBM Support Serices diretamente do ESR. Ao eniar um PMR, indique um níel de graidade para nos ajudar a priorizar nossos recursos em relação a outros PMRs abertos: Graidade 1 Impacto de negócios crítico: Isso indica que ocê 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á desatiado e, para que o IBM Software Support trabalhe fora de seu horário comercial, ocê dee garantir que haja um contato disponíel por telefone, 24 horas por dia, 7 dias por semana, para facilitar as consultas do engenheiro erificador, a execução de testes em sua instância de produção, etc. Graidade 2 Impacto de negócios significatio: Isso indica que o programa é útil, mas seeramente limitado. Graidade 3 Algum impacto de negócios: Isso indica que o programa é útil, mas com menos recursos significatios (não crítico para operações) indisponíeis. Graidade 4 Impacto de negócios mínimo: Isso indica que o problema causa pouco impacto sobre as operações ou que uma alternatia razoáel para o problema foi implementada. Para abrir um Pedido de Aprimoramento (um pedido para noa funcionalidade geral do produto e não está relacionado a uma customização específica): - Abra um PMR com graidade 2, 3 ou 4, (dependendo do possíel ganho de negócios do pedido) e o pedido será eniado para o IBM Product Management, para reisão. Você receberá um número de Pedido de Aprimoramento para fins de rastreamento, que substitui o número do PMR. Geralmente, sua aproação é necessária para fechar o PMR. 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 eniado 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 descreerá o problema em detalhes. Quando possíel, o IBM Software Support oferecerá uma solução alternatia que ocê pode implementar até que o APAR seja resolido e uma correção seja apresentada. A IBM publica APARs resolidos no website de Suporte IBM diariamente para que outros usuários que tieram o mesmo problema possam se beneficiar da mesma resolução. Prefácio xiii

16 xi InfoSphere MDM Collaboration Serer: Guia de Migração

17 Capítulo 1. Migrando Se estier usando uma ersão anterior do IBM InfoSphere Master Data Management Collaboration Serer, ocê poderá migrar de sua ersão para a ersão mais atual. Estas informações de instalação também estão disponíeis no InfoSphere MDM Collaboration Serer Migration Guide, que está disponíel no formato de manual em um arquio PDF. Clique com o botão direito do mouse no link e selecione Salar Destino Como para efetuar download do arquio PDF em seu computador. Copyright IBM Corp. 2000,

18 2 InfoSphere MDM Collaboration Serer: Guia de Migração

19 Capítulo 2. Introdução Dee-se modificar o esquema de banco de dados de sua instalação atual usando os scripts de migração para migrar de ersões anteriores para o IBM InfoSphere Master Data Management Collaboration Serer Versão Dee-se ter permissões adequadas para criar e modificar tabelas e índices no banco de dados. Dee-se também ter permissões adequadas para criar e excluir arquios nos subdiretórios do diretório $TOP. A migração enole as seguintes etapas básicas: Verifique se há espaço suficiente disponíel na tabela de banco de dados. Pare a instância que está usando o esquema do banco de dados. Faça backup do esquema de banco de dados existente. Instale o InfoSphere MDM Collaboration Serer V11.4 e aponte para o mesmo esquema do banco de dados que a instância anterior estaa usando. Execute o script de migração apropriado para modificar o esquema do banco de dados e lee-o para o níel do InfoSphere MDM Collaboration Serer V11.4. Copyright IBM Corp. 2000,

20 4 InfoSphere MDM Collaboration Serer: Guia de Migração

21 Capítulo 3. Migrando de Versões Anteriores É possíel migrar para o IBM InfoSphere Master Data Management Collaboration Serer Versão 11.4 de ersões anteriores específicas. Os caminhos de migração a seguir são suportados para a Versão 11.4: Migrando da V9.1, Fix Pack 2 ou posterior para a V11.4 Migrando da V10.0, Fix Pack 1 ou posterior para a V11.4 Migrando da V10.1, GA e todos os níeis de Fix Pack para a V11.4 Migrando da V11.0, GA e todos os níeis de Fix Pack para a V11.4 Migrando da V11.3, GA para a V11.4 Se estier migrando para uma liberação superior, não um fix pack da mesma liberação, ocê deerá usar um noo diretório de instalação para eitar incompatibilidades de ersão do arquio JAR. Se estier migrando de uma ersã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íeis no arquio JAR POI mais recente: public String getexcelcellencoding(); public oid setencoding(string encoding); public String getexcelcellencoding(object cellobj) throws AustinException; Nota: 1. O InfoSphere MDM Collaboration Serer Excel Parser é suportado por um arquio.jar de terceiro denominado poi jar. Essa biblioteca suporta o formato Microsoft Excel 2007, que permite mais de 255 colunas por planilha de dados. Dee-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) dee ser usada para exportar itens com mais de 255 atributos. 2. É possíel exportar Resultados de Procura Detalhada para arquios no formato Excel 2003 usando 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 tierem 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, dee-se assegurar que a ersão correta do banco de dados esteja sendo usada. Consulte os requisitos do sistema para obter detalhes: dociew.wss?uid=swg Você também dee assegurar que o usuário do banco de dados do InfoSphere MDM Collaboration Serer tenha os priilégios apropriados conforme mencionado no guia de instalação. Consulte sua equipe DBA para quaisquer mudanças nos priilégios do usuário do banco de dados deido a qualquer política de segurança. Dee-se usar a ersão do banco de dados DB2 ou Oracle conforme mencionado nos requisitos do sistema. Consulte os requisitos do sistema para obter detalhes: É possíel Copyright IBM Corp. 2000,

22 consultar a documentação do DB2 ou Oracle para fazer upgrade do banco de dados DB2 e Oracle para a ersão suportada. Etapas para migrar o MDM Colaboratio com espaços de tabela customizados são usados em DB2 e Oracle Se estier usando nomes de espaços de tabelas customizados em ez de USERS ou INDX padrão, dee-se modificar manualmente os nomes dos espaços de tabela nos arquios SQL a seguir antes de iniciar a migração para o InfoSphere MDM Collaboration Serer. Dee-se erificar se há pelo menos 30% de espaço lire 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 noo 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 isualizáeis na V11.4. Assim, elas são excluídas do banco de dados durante a migração. Os logs de auditoria antigos podem ser isualizados usando a liberação da qual ocê está migrando. Dee-se executar manualmente as etapas a seguir para assegurar uma migração bem-sucedida: 1. Migre manualmente os arquios de propriedades a seguir. Como os arquios de propriedade fazem parte dos sistemas de arquios locais, o método de migração não suporta a exportação de arquios de propriedades. Modifique cada propriedade customizada de liberações anteriores para o arquio correspondente na noa ersão. Não sobrescrea os arquios de propriedade de uma ersão mais antiga para uma noa ersão porque noos parâmetros foram introduzidos na V11.4. Consulte a documentação do InfoSphere MDM Collaboration Serer para obter detalhes sobre cada arquio de propriedade. $TOP/etc/default/common.properties $TOP/etc/default/logs.xml $TOP/etc/default/docstore_mount.xml $TOP/etc/default/user_jars.list 2. Copie manualmente o conteúdo do diretório $TOP/public_html/suppliers/<cmp code>/ctg_files para a noa instância para cada empresa. Como esses arquios fazem parte do sistema de arquios local, o método de migração não suporta a exportação do diretório ctg_files. 3. Inclua manualmente os arquios JAR do usuário requeridos para a noa instância. Como esses arquios fazem parte do sistema de arquios local, o método de migração não suporta a exportação dos arquios JAR do usuário. Para obter mais informações sobre como incluir arquios JAR em sua implementação, consulte Implementando um arquio.jar do usuário customizado. 4. Refaça manualmente todas as mudanças que ocê fez no Script de Relatório de Resultados da Procura Detalhada Padrão para customizá-lo. Migrar para o InfoSphere MDM Collaboration Serer V11.4 sobrescree o script existente disponíel no diretório de armazenamento de documentos do InfoSphere MDM Collaboration Serer, /scripts/report. Esse script é usado para exportar resultados da procura do objeto do InfoSphere MDM Collaboration Serer para uma planilha do Excel. Para obter mais informações sobre esse script, consulte Exportando resultados da procura para o Excel. 6 InfoSphere MDM Collaboration Serer: Guia de Migração

23 5. Assegure que não haja opção de compilação detalhada configurada para a compilação de scripts. Verifique se no arquio common.properties ocê não usa erbose como o alor 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 erificar se a ersão de PERL instalada no computador é compatíel com a ersão do InfoSphere MDM Collaboration Serer que ocê instalou. Esse script está no diretório $TOP. Se a ersão atual de PERL não for compatíel, ocê deerá instalar uma noa ersão. 7. Se ocê instalar a noa ersão do InfoSphere MDM Collaboration Serer em um noo diretório, deerá atualizar o alor das ariáeis TOP e PERL5LIB no arquio.bash_profile. Dee-se configurar a ariáel PERL5LIB para o diretório $TOP/bin/perllib. Migrando Dados Principais do Formato Interno para o Formato XML Dee-se conerter os dados principais em XML ao migrar do IBM InfoSphere Master Data Management Serer for Product Information Management Versões ou para o IBM InfoSphere Master Data Management Collaboration Serer Versão 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 aplicatio InfoSphere MDM Collaboration Serer tenha os priilégios do banco de dados apropriados conforme mencionado no guia de instalação. 3. Pare o aplicatio InfoSphere MDM Collaboration Serer no seridor local. 4. Execute o script delete_old_ersions.sh para excluir todas as ersões antigas. Use o código de sua empresa e a data atual como alores para os parâmetros code e end_date. 5. Opcional Aprimorar a memória disponíel para o processo Jaa: Executar o script de conersão de dados é um processo intensio de memória. Recomenda-se fornecer 2 GB de memória para o processo Jaa atualizando o parâmetro custom_jaa_options no arquio $TOP/bin/conf/en_settings.ini. Execute o configureen.sh depois de modificar o parâmetro custom_jaa_options para assegurar que as configurações de noa memória atualizadas entrem em igor. custom_jaa_options=-xmx2048m -Xms256m Sobre Esta Tarefa O script de migração de dados requer duas ezes o número de conexões de BD que o número de encadeamentos de execução. Por exemplo, se ocê 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: db_maxconnection db_maxconnection_default Os dois parâmetros estão disponíeis no arquio common.properties. Se os alores desses parâmetros já forem maiores ou iguais às conexões de BD requeridas, não Capítulo 3. Migrando de Versões Anteriores 7

24 será necessário alterar os alores. Se os alores desses parâmetros forem menores que as conexões de BD requeridas, ocê deerá aumentar os alores para melhorar a elocidade. Se ocê tier mais de entradas de dados principais nos catálogos, aumente o número de encadeamentos. Por exemplo, ocê pode usar 50 ou 100 encadeamentos para concluir a migração de dados mais rápido. O número mais alto de encadeamentos que ocê pode usar depende das seguintes ariáeis no InfoSphere MDM Collaboration Serer. É possíel aaliar o número ideal de encadeamentos executando o script de migração em um ambiente de teste. Número de núcleos do processador disponíeis Número de especificações definido Memória disponíel Todas as especificações que são definidas no ambiente do InfoSphere MDM Collaboration Serer são recuperadas e usadas no processo de conersão de dados. Se ocê tier mais de 100 especificações, atualize os parâmetros de armazenamento em cache de especificação para os alores apropriados para eitar 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 Serer usando o comando a seguir. $PERL5LIB/runSQL.pl --sql_command="select count(*) from spc;" 2. Atualize esses parâmetros com os alores recuperados da consulta na Etapa 1. Esses parâmetros estão disponíeis no arquio 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 configureen.sh depois de atualizar o arquio mdm-cache-config.properties sobrescree os parâmetros com alores padrão. 3. Execute o shell script de migração de dados, migratedatatoxml.sh. Esse arquio 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 Serer. --threads Especifica o número de encadeamentos. Use um número maior de encadeamentos para melhorar a elocidade, mas assegure-se de que existam conexões de BD suficientes. O padrão é 1. É recomendado fornecer pelo menos 10 encadeamentos. Por exemplo, migratedatatoxml.sh --company=ibm --threads=50 8 InfoSphere MDM Collaboration Serer: Guia de Migração

25 O que Fazer Depois É possíel erificar se o script funcionou conforme planejado obserando os erros que são exibidos no console e registrados no arquio 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 houer um erro, o lote inteiro é retrocedido. Por isso, o número de entradas que falharam ao migrar é maior que as falhas reais. Atualize o alor do parâmetro index_regeneration_batch_size para 1 no arquio common.properties e, em seguida, execute o script de migração de dados noamente para reduzir as entradas com falhas reais. É fornecida uma tabela dos motios possíeis para os erros durante a migração de dados e as ações recomendadas: Tabela 1. Motios Possíeis para Erros e as Ações Recomendadas Motios para o erro durante a migração de dados Ação recomendada A migração de dados exibe o seguinte erro: jaa.sql.sqlexception: ORA-00600: internal error code, arguments: [KGHALP1], [0x ], [], [], [], [], [], [], [], [], [], [] A migração de dados exibe o seguinte erro: jaa.sql.sqlexception: ORA-31061: XDB error: XML eent error ORA-19202: Error occurred in XML processing In line 46 of orastream: LPX-00241: entity reference is not well formed Certifique-se de estar usando o níel 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 noamente. Um dos alores de atributo na entrada tem o caractere "&" ou um alor inálido. Atualize a entrada para remoer o alor inálido da interface de edição do item do InfoSphere MDM Collaboration Serer e, em seguida, tente a migração de dados noamente. Migrando da V9.1 para a V11.4 Para migrar para o IBM InfoSphere Master Data Management Collaboration Serer Versão 11.4 do IBM InfoSphere Master Data Management Serer for Product Information Management Versão 9.1.0, dee-se executar o script de migração apropriado. Antes de Iniciar Antes de ser possíel migrar do InfoSphere MDM Serer for PIM V9.1.0 para o InfoSphere MDM Collaboration Serer V11.4, dee-se assegurar de usar especificamente o Fix Pack 2 ou fix packs posteriores para a V Se estier utilizando o V9.1.0 com qualquer outro níel de fix pack, ocê deerá migrar para a ersã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 Capítulo 3. Migrando de Versões Anteriores 9

26 usuário do banco de dados InfoSphere MDM Collaboration Serer tenha priilégios apropriados para usar os noos espaços de tabela. É possíel configurar o local do arquio de log de erro modificando a ariáel _ERROR_LOGS no script de migração migratefrom910.sh. Esta ariáel é configurada para $TOP/logs/errfile.log por padrão. Se estier usando os nomes de espaço de tabela customizada em ez de USERS ou INDX padrão, dee-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, dee-se modificar manualmente os nomes de espaço de tabela nos arquios SQL a seguir. Esta modificação dee acontecer antes de iniciar a migração para o InfoSphere MDM Collaboration Serer V11.4. Tabela 2. Arquios SQL para modificar ao usar nomes de espaço de tabela customizados Arquios SQL a modificar quando o DB2 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 arquios SQL a seguir no diretório $TOP/src/db/schema/dbscripts/ db2: addcaestepentrydate.sql addcehentryid.sql addobhcompanyid.sql addsstshared.sql Arquios 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 seguintes arquios 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 Serer for PIM V9.1.0 para o InfoSphere MDM Collaboration Serer V11.4, e nenhum outro meio. Não é possíel 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 Serer V11.4 em um diretório diferente. 3. Configure seu banco de dados. a. Para DB2 bancos de dados, crie noos 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 dee ser igual ao espaço ocupado pelo espaço de tabela TCTG_ITD_ITEM_DETAIL. É possíel 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 ; 10 InfoSphere MDM Collaboration Serer: Guia de Migração

27 b. Para bancos de dados Oracle, crie noos 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 Serer 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 arquio en_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íel 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íel executar o script de migração noamente. 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 erificar o esquema do banco de dados, a conectiidade entre o InfoSphere MDM Collaboration Serer e os bancos de dados e para erificar o JDBC e as conexões do cliente natio. Para obter mais informações, consulte Script test_db.sh. 8. Inicie a instância do InfoSphere MDM Collaboration Serer V11.4. Resultados Todas as mensagens, como o status de componentes de migração indiiduais 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 Serer Versão está concluído. Verifique as mensagens para er se há algum erro. Gerando o relatório de erificação do banco de dados... Tabelas alteradas =========================================================== Não há nenhuma tabela alterada Tabelas Ausentes =========================================================== Não há nenhuma tabela ausente Índices Alterados Capítulo 3. Migrando de Versões Anteriores 11

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 tier falhado:!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Falha na Migração: xxxx!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Consulte o arquio para obter detalhes adicionais: /home/pimuser/mdmcs11/logs/errfile.log Essa mensagem será exibida se a migração de módulos específicos tier falhado: Resumo da migração A migração dos seguintes módulos falhou: <nomes dos módulos> Essa mensagem será exibida se houer uma discrepância nas tabelas ou índices do banco de dados. Gerando o relatório de erificação do banco de dados... Tabelas alteradas =========================================================== <nomes das tabelas> Tabelas Ausentes =========================================================== <nomes das tabelas> Índices Alterados =========================================================== <nomes dos índices> Índices Ausentes =========================================================== 12 InfoSphere MDM Collaboration Serer: Guia de Migração

29 <nomes dos índices> LOG FILE: $TOP/logs/default/default.log Reise o arquio 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 noamente. Para obter a ação recomendada nas falhas de migração, consulte Resolendo 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 Serer Versão 11.4 do IBM InfoSphere Master Data Management Serer for Product Information Management Versão , dee-se executar o script de migração apropriado. Antes de Iniciar Antes de ser possíel migrar do InfoSphere MDM Collaboration Serer V para a V11.4, dee-se assegurar de usar especificamente o Fix Pack 1 ou posterior para a V Se estier usando a V GA, ocê deerá migrar para a V Fix Pack 1 ou posterior seguindo as instruções nas notas sobre a liberação adequadas. É possíel configurar o local do arquio de log de erros modificando a ariáel _ERROR_LOGS no script de migração migratefrom1000.sh. Esta ariáel é configurada para $TOP/logs/errfile.log por padrão. Se estier usando os nomes de espaço de tabela customizada em ez de o USERS ou INDX padrão, dee-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, dee-se modificar manualmente os nomes de espaço de tabela nos arquios SQL a seguir. Esta modificação dee acontecer antes de iniciar a migração para o InfoSphere MDM Collaboration Serer V11.4. Tabela 3. Arquios SQL para modificar ao usar nomes de espaço de tabela customizados Arquios SQL a modificar quando o DB2 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 arquios SQL a seguir no diretório $TOP/src/db/schema/dbscripts/ db2: Arquios 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 seguintes arquios SQL no diretório $TOP/src/db/schema/dbscripts/ oracle: addcaestepentrydate.sql addcehentryid.sql addobhcompanyid.sql addsstshared.sql addsstshared.sql add_icm_index.sql add_lot_index.sql add_sca_index.sql add_sit_index1.sql redefine_ctg_indexes.sql modifyicm1index.sql Capítulo 3. Migrando de Versões Anteriores 13

30 Sobre Esta Tarefa As etapas a seguir são a única maneira de migrar do InfoSphere MDM Collaboration Serer V para V11.4, e nenhum outro meio. Não é possíel 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 Serer V11.4 em um diretório diferente. 3. Aponte a instância do InfoSphere MDM Collaboration Serer 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 arquio en_settings.ini. Para obter mais informações, consulte Configurando Parâmetros Comuns do Banco de Dados. 4. Execute o script de migração migratefrom1000fp.sh. Este script está disponíel 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íel executar o script de migração noamente. 5. Execute o script test_db.sh para erificar o esquema do banco de dados, a conectiidade entre o InfoSphere MDM Collaboration Serer e os bancos de dados e para erificar o JDBC e as conexões do cliente natio. Para obter mais informações, consulte Script test_db.sh. 6. Inicie a instância do InfoSphere MDM Collaboration Serer V11.4. Resultados Todas as mensagens, como o status de componentes de migração indiiduais 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 Serer Versão está concluído. Verifique as mensagens para er se há algum erro. Gerando o relatório de erificação do banco de dados... Tabelas alteradas =========================================================== Não há nenhuma tabela alterada Tabelas Ausentes =========================================================== Não há nenhuma tabela ausente 14 InfoSphere MDM Collaboration Serer: Guia de Migração

31 Índices Alterados =========================================================== 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 tier falhado:!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Falha na Migração: xxxx!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Consulte o arquio para obter detalhes adicionais: /home/pimuser/mdmcs11/logs/errfile.log Essa mensagem será exibida se a migração de módulos específicos tier falhado: Resumo da migração A migração dos seguintes módulos falhou: <nomes dos módulos> Essa mensagem será exibida se houer uma discrepância nas tabelas ou índices do banco de dados. Gerando o relatório de erificação do banco de dados... Tabelas alteradas =========================================================== <nomes das tabelas> Tabelas Ausentes =========================================================== <nomes das tabelas> Índices Alterados =========================================================== <nomes dos índices> Capítulo 3. Migrando de Versões Anteriores 15

32 Índices Ausentes =========================================================== <nomes dos índices> LOG FILE: $TOP/logs/default/default.log Reise o arquio 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 noamente. Para obter a ação recomendada nas falhas de migração, consulte Resolendo 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.1 para a V11.4 Para migrar para o IBM InfoSphere Master Data Management Collaboration Serer Versão 11.4 do IBM InfoSphere Master Data Management Collaboration Serer Versão , dee-se executar o script de migração apropriado. Antes de Iniciar Se estier usando os nomes de espaço de tabela customizada em ez de o USERS ou INDX padrão, dee-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, dee-se modificar manualmente os nomes de espaço de tabela nos arquios SQL a seguir. Esta modificação dee acontecer antes de iniciar a migração para o InfoSphere MDM Collaboration Serer V11.4. Tabela 4. Arquios SQL para modificar ao usar nomes de espaço de tabela customizados Arquios SQL a modificar quando o DB2 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 arquios SQL a seguir no diretório $TOP/src/db/schema/dbscripts/ db2: Arquios 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 seguintes arquios SQL no diretório $TOP/src/db/schema/dbscripts/ oracle: addcaestepentrydate.sql addcehentryid.sql addobhcompanyid.sql addsstshared.sql 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íel migrar para o InfoSphere MDM Collaboration Serer Versão 11.4 do InfoSphere MDM Collaboration Serer Versão GA ou qualquer fix pack (1, 6, 7, 8, 9, 10 ou 11). 16 InfoSphere MDM Collaboration Serer: Guia de Migração

33 As etapas a seguir são a única maneira de migrar do InfoSphere MDM Collaboration Serer V para a V11.4, e nenhum outro meio. Não é possíel utilizar a ferramenta de exportação e importação de ambiente. É possíel configurar o local do arquio de log de erros modificando a ariáel _ERROR_LOGS no script de migração migratefrom1010.sh. Esta ariáel é configurada para $TOP/logs/errfile.log por padrão. Procedimento 1. Faça backup do esquema de banco de dados existente. 2. Instale o InfoSphere MDM Collaboration Serer V11.4 em um diretório diferente. 3. Aponte a instância do InfoSphere MDM Collaboration Serer V11.4 para o esquema do banco de dados da V Para apontar a instância para o banco de dados, inclua os parâmetros do banco de dados no arquio en_settings.ini. Para obter mais informações, consulte Configurando Parâmetros Comuns do Banco de Dados. 4. Execute o script de migração migratefrom1010fp.sh. Este script está disponíel 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íel executar o script de migração noamente. 5. Execute o script test_db.sh para erificar o esquema do banco de dados, a conectiidade entre o InfoSphere MDM Collaboration Serer e os bancos de dados e para erificar o JDBC e as conexões do cliente natio. Para obter mais informações, consulte Script test_db.sh. 6. Inicie a instância do InfoSphere MDM Collaboration Serer V11.4. Resultados Todas as mensagens, como o status de componentes de migração indiiduais 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 Serer Versão está concluído. Verifique as mensagens para er se há algum erro. Gerando o relatório de erificação do banco de dados... Tabelas alteradas =========================================================== Não há nenhuma tabela alterada Tabelas Ausentes Capítulo 3. Migrando de Versões Anteriores 17

34 =========================================================== Não há nenhuma tabela ausente Índices Alterados =========================================================== 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 tier falhado:!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Falha na Migração: xxxx!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Consulte o arquio para obter detalhes adicionais: /home/pimuser/mdmcs11/logs/errfile.log Essa mensagem será exibida se a migração de módulos específicos tier falhado: Resumo da migração A migração dos seguintes módulos falhou: <nomes dos módulos> Essa mensagem será exibida se houer uma discrepância nas tabelas ou índices do banco de dados. Gerando o relatório de erificação do banco de dados... Tabelas alteradas =========================================================== <nomes das tabelas> Tabelas Ausentes =========================================================== <nomes das tabelas> Índices Alterados =========================================================== <nomes dos índices> 18 InfoSphere MDM Collaboration Serer: Guia de Migração

35 Índices Ausentes =========================================================== <nomes dos índices> LOG FILE: $TOP/logs/default/default.log Reise o arquio 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 noamente. Para obter a ação recomendada nas falhas de migração, consulte Resolendo problemas de migração. Entre em contato com o Suporte de Software IBM se o problema persistir depois de corrigir os erros. Migrando da V11.0 para a V11.4 Para migrar para o IBM InfoSphere Master Data Management Collaboration Serer Versão 11.4 do IBM InfoSphere Master Data Management Collaboration Serer Versão , dee-se executar o script de migração apropriado. Antes de Iniciar Se estier usando os nomes de espaço de tabela customizada em ez de o USERS ou INDX padrão, dee-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, dee-se modificar manualmente os nomes de espaço de tabela nos arquios SQL a seguir. Esta modificação dee acontecer antes de iniciar a migração para o InfoSphere MDM Collaboration Serer V11.4. Tabela 5. Arquios SQL para modificar ao usar nomes de espaço de tabela customizados Arquios SQL a modificar quando o DB2 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 arquios SQL a seguir no diretório $TOP/src/db/schema/dbscripts/ db2: Arquios 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 seguintes arquios SQL no diretório $TOP/src/db/schema/dbscripts/ oracle: addcaestepentrydate.sql addcehentryid.sql addobhcompanyid.sql addsstshared.sql 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íel migrar para o InfoSphere MDM Collaboration Serer Versão 11.4 do InfoSphere MDM Collaboration Serer Versão GA, qualquer fix pack (1 para 5). Capítulo 3. Migrando de Versões Anteriores 19