IBM Control Desk Versão 7 Release 6 Guia de Upgrade BA21-8475-00 Observação Antes de usar essas informações e o produto suportado, leia as informações em Avisos. Índice Capítulo 1. Visão geral do upgrade . . . 1 Capítulo 2. Recursos de upgrade . . . . 3 Capítulo 3. O que é suportado no processo de upgrade . . . . . . . . . 5 Capítulo 4. O que não é suportado no processo de upgrade . . . . . . . . . 7 Capítulo 5. Produtos e liberações suportados . . . . . . . . . . . . . 9 Capítulo 6. Considerações sobre o Oracle WebLogic Server . . . . . . . 11 Capítulo 7. Fazendo upgrade para o IBM Control Desk versão 7.6 . . . . . 13 Conceitos de upgrade . . . . Roteiros do cenário de upgrade. . . . . . . . . . . . . . 13 . 15 Capítulo 8. Planejando o processo de upgrade do Control Desk versão 7.6 . . 17 Desempenho do processo de upgrade . . . . . Planejamento para o Control Desk versão 7.6 . . . Planejando o upgrade do fluxo de trabalho . . . . Planejando o upgrade do hardware e do software Requisito do WebSphere Application Server Network Deployment v8.5.5 . . . . . . . . . Requisito do Oracle WebLogic Server 12c . . . . Opções de relatório . . . . . . . . . . . . Upgrade da Estrutura de Integração do Maximo . . Serviços da web . . . . . . . . . . . . filas JMS . . . . . . . . . . . . . . Processamento de terminais de tabelas de interface . . . . . . . . . . . . . . Processamento do Canal de Publicação para objetos que são visualizações . . . . . . . Uso do sistema de arquivos e do diretório global Upgrade manual de mensagens . . . . . Desinstalando o IBM Maximo Adapter for Primavera antes do upgrade. . . . . . . . . Mudanças no middleware suportado . . . . . . 18 18 19 19 19 19 19 20 20 21 22 22 23 26 26 28 Capítulo 9. Tarefas de pré-upgrade. . . 29 Criando uma cópia de teste do banco de dados . . Desativação de acionadores customizados . . . . Fazendo backup do banco de dados . . . . . . Preservação de atributos para portlets customizados Requisitos do comando tar do AIX . . . . . . Modo de compatibilidade do Internet Explorer . . Permissões de usuário administrativo . . . . . © Copyright IBM Corp. 1994, 2015 29 29 29 29 30 30 30 Capítulo 10. Fazendo upgrade por meio da instalação do WebSphere Application Server Network Deployment Versão 8.5.5 em um novo servidor (Cenário I) . . . . . . . . . 31 Execução do verificador de integridade do 7.5.x . Estabeleça um middleware suportado . . . . Instalando o WebSphere Application Server Network Deployment v8.5.5 usando o programa de instalação do Control Desk versão 7.6 . . Preparando o WebSphere Application Server Network Deployment v8.5.5 usando o programa de configuração do Control Desk . . . . . Migre os dados do banco de dados ou do servidor de diretórios (opcional) . . . . . Executando o programa de instalação do Control Desk 7.6 . . . . . . . . . . . . . . Migração de customizações . . . . . . . . Configurando Control Desk versão 7.6 usando o programa de configuração do Control Desk versão 7.6 . . . . . . . . . . . . . . . . Execução do verificador de integridade do 7.6 . . . 34 . 35 . 36 . 37 . 38 . 39 . 41 . 42 . 43 Capítulo 11. Fazendo upgrade por meio da migração das informações do WebSphere Application Server para o WebSphere Application Server v8.5.5 (Cenário 2) . . . . . . . . . . . . . 45 Execução do verificador de integridade do 7.5.x . Estabeleça um middleware suportado . . . . Instalando o WebSphere Application Server Network Deployment v8.5.5 usando o programa de instalação do Control Desk versão 7.6 . . Migração de informações de configuração do IBM WebSphere Application Server Network Deployment . . . . . . . . . . . . Migrando dados do banco de dados ou do servidor de diretórios (opcional) . . . . . Executando o programa de instalação do Control Desk 7.6 . . . . . . . . . . . . . . Migração de customizações . . . . . . . . Configurando Control Desk versão 7.6 usando o programa de configuração do Control Desk versão 7.6 . . . . . . . . . . . . . . . . Execução do verificador de integridade do 7.6 . . . 47 . 48 . 49 . 51 . 54 . 54 . 56 . 57 . 59 Capítulo 12. Upgrade no Oracle WebLogic Server (Cenário 3) . . . . . 61 Execução do verificador de integridade do 7.5.x . Estabeleça um middleware suportado . . . . Configuração do WebLogic . . . . . . . . Migre os dados do banco de dados ou do servidor de diretórios (opcional) . . . . . . . . . . 63 . 64 . 65 . 65 iii Executando o programa de instalação do Control Desk 7.6 . . . . . . . . . . . . . . Migração de customizações . . . . . . . . Configurando Control Desk versão 7.6 usando o programa de configuração do Control Desk versão 7.6 . . . . . . . . . . . . . . . . Execução do verificador de integridade do 7.6 . . Implementação de arquivos de aplicativo no Oracle WebLogic Server. . . . . . . . . . . . . 66 . 68 . 69 . 70 . 70 Capítulo 13. Atualizando o Integration Composer . . . . . . . . . . . . . 73 Atualizando o Integration Composer Usando a Barra de Ativação . . . . . . . . . . Fazendo upgrade do Integration Composer no modo do console . . . . . . . . . . Fazendo upgrade dos adaptadores de integração Melhorando o desempenho do Integration Composer . . . . . . . . . . . . . . . 73 . . . 74 . 76 . . 77 Capítulo 15. Tarefas pós-upgrade . . . 81 Lista de verificação para as tarefas de pós-upgrade 81 Verificando Programaticamente se a Instalação Foi Bem-sucedida . . . . . . . . . . . . . 81 Revisando as telas atualizadas . . . . . . . . 85 IBM Control Desk: Guia de Upgrade Capítulo 16. Tópicos diversos . . . . . 87 Fazendo integração de OSLC . . . . . . . . Configurando a integração de OSLC sobre SSL Importando o certificado SSL em um servidor WebSphere . . . . . . . . . . . . Importando o certificado SSL em um servidor WebLogic . . . . . . . . . . . . . Fazendo upgrade dos fluxos de trabalho padrão para o Catálogo de Serviços . . . . . . . . . Capítulo 17. Resolução de Problemas Capítulo 14. Fazendo upgrade do Ambiente de Trabalho do Implementador . . . . . . . . . . . 79 iv Revisão de domínios de tabela e domínios cruzados 86 Atualização de relatórios BIRT . . . . . . . . 86 Atualização de estatísticas . . . . . . . . . 86 87 89 89 89 90 91 Mensagens do verificador de integridade . . . . 91 Mensagens informativas do verificador de integridade . . . . . . . . . . . . . 91 Mensagens de aviso do verificador de integridade . . . . . . . . . . . . . 91 Mensagens de erro do verificador de integridade 94 Efetuando bypass de requisito de DNS do Control Desk versão 7.6 durante a instalação. . . . . . 110 Reinicialização de updatedb . . . . . . . . 110 Erro de validação CTGIN5398E . . . . . . . 111 Incluindo a fila intjmsacterr para IBM Control Desk 111 Índice Remissivo . . . . . . . . . . 113 Capítulo 1. Visão geral do upgrade Fazer upgrade do Control Desk 7.5.x para a versão 7.6 é um processo de vários estágios. Utilize o programa de instalação do Control Desk versão 7.6 para instalar novos arquivos e, em seguida, use o programa de configuração do Control Desk versão 7.6 para atualizar a configuração. O processo de upgrade completo inclui tarefas que são executadas antes e depois da execução dos programas de instalação e configuração. O processo de upgrade suporta diversas configurações de produto, incluindo Control Desk e componentes relacionados e produtos. O processo de upgrade envolve a execução de uma nova instalação do Control Desk versão 7.6 e sua posterior configuração para a utilização do banco de dados do Control Desk versão 7.5.x. O banco de dados é atualizado durante o processo de configuração. Não execute o upgrade de uma estação de trabalho administrativa do Control Desk versão 7.5.x existente. As plataformas que foram suportadas para estações de trabalho administrativas nas versões anteriores do Control Desk não são suportadas no Control Desk versão 7.6. As seguintes etapas resumem o processo que é seguido para o upgrade: 1. Preparar a infraestrutura do middleware. É possível consultar a Matriz de configuração do produto para determinar quais versões do middleware são suportadas. 2. Execute o instalador para instalar o Control Desk versão 7.6. Se você já tiver instalado o middleware que é suportado para essa liberação, é possível instalá-lo em um novo diretório na estação de trabalho administrativa existente. Não instale a versão 7.6 no mesmo diretório usado por você para uma versão anterior. 3. Migre quaisquer customizações necessárias para a nova estação de trabalho administrativa, por exemplo, customizações web.xml ou Java. 4. Use a ferramenta de configuração para apontar e fazer upgrade o banco de dados do Control Desk. Algumas seções deste guia aplicam-se apenas a configurações ou produtos específicos. Se a configuração ou o produto especificado não se aplicar à sua instalação, ignore essa seção e continue com a próxima. Para obter informações sobre os caminhos de upgrade que são suportados, consulte a página Recursos de Upgrade na wiki do IBM Control Desk. © Copyright IBM Corp. 1994, 2015 1 2 IBM Control Desk: Guia de Upgrade Capítulo 2. Recursos de upgrade Ao fazer upgrade, certifique-se de possuir a versão mais recente da documentação de upgrade do IBM Control Desk. Os links a seguir oferecem recursos adicionais. A página Recursos de Upgrade na wiki do IBM Control Desk Este site é atualizado frequentemente com dicas úteis e melhores práticas para upgrades. Matriz de configuração do produto Esta planilha descreve o suporte de software para o IBM Control Desk e os vários produtos e componentes que são baseados no mecanismo de automação de processo da Tivoli. IBM Control Desk Support Resources Selecione a guia Ajuda de Arquitetura/Configuração para localizar o link para as informações de upgrade para os produtos baseados no mecanismo de automação de processo da Tivoli. WebSphere Application Server V8.5.5 Fix Pack 3 Este site fornece informações sobre como fazer download do WebSphere Application Server versão 8.5.5. Coleção de Conhecimentos: Migrando para (ou de) WebSphere Application Server V7.0 Esse site fornece uma coleção de informações úteis para migrar do WebSphere Application Server versão 7. Migrando perfis usando o assistente de migração Essa página na documentação do IBM® WebSphere Application Server Network Deployment no IBM Knowledge Center fornece informações úteis para migrar os perfis para a versão 8.5.5. Instalando e desinstalando o SDK Java Technology Edition Versão 7.0 ou 7.1 nos sistemas operacionais distribuídos Ao migrar das versões anteriores do WebSphere Application Server, você deve instalar o IBM WebSphere SDK Java Technology Edition Versão 7.0 e torná-lo o Java padrão para WebSphere Application Server. Esse documento descreve como fazer isso com o Installation Manager. Instalando o Java 7.x opcional no WebSphere Application Server 8.5 Essa entrada de blog oferece informações úteis sobre como tornar o IBM JDK 7 o JDK padrão para WebSphere Application Server. Recursos de Upgrade do Maximo Esse documento fornece informações úteis para fazer upgrade dos produtos com base no mecanismo de automação de processo da Tivoli. Portal de Upgrade do DB2 Este documento fornece uma lista de todos os roteiros, documentação de upgrade e informações e recursos disponíveis relacionados ao upgrade de uma nova liberação de produtos do IBM DB2. Documentação do IBM DB2 no IBM Knowledge Center © Copyright IBM Corp. 1994, 2015 3 4 IBM Control Desk: Guia de Upgrade Capítulo 3. O que é suportado no processo de upgrade O processo de upgrade do Control Desk versão 7.6 suporta o upgrade dos seguintes elementos do sistema do Control Desk: v Todos os dados v Quaisquer configurações executadas por você com as ferramentas de configuração do Control Desk v Modelo de dados v Interface com o usuário e camada de apresentação v Processos do fluxo de trabalho v Validações e padrões de dados v Definições de integração v Escalações © Copyright IBM Corp. 1994, 2015 5 6 IBM Control Desk: Guia de Upgrade Capítulo 4. O que não é suportado no processo de upgrade Os programas de instalação e configuração do Control Desk versão 7.6 não fazem o upgrade automático de alguns aspectos de uma implementação do Control Desk versão 7.5.x. Os itens a seguir não são atualizados automaticamente pelos programas de instalação e configuração do Control Desk versão 7.6. No entanto, esses itens não são removidos durante o upgrade. v O processo de upgrade não suporta o upgrade diretamente a partir do Control Desk versão 7.1. Deve-se fazer upgrade do Control Desk versão 7.1 para o Control Desk versão 7.5.x para que seja possível fazer upgrade para o Control Desk versão 7.6. v Todas as soluções para segmentos do mercado, os adaptadores e complementos devem ser reinstalados como parte do processo de upgrade. Esses produtos devem ser instalados após a instalação do Control Desk versão 7.6, mas antes de configurá-lo. v Quaisquer mudanças para o esquema do banco de dados do Control Desk ou objetos do banco de dados (tabelas, colunas, índices e assim por diante) que não foram feitas com o aplicativo de Configuração do Banco de Dados Control Desk. v Os objetos de banco de dados criados (incluindo procedimentos armazenados, acionadores, visualizações e sinônimos) que dependem de objetos de bancos de dados do Control Desk. O upgrade não recria esses objetos. Os acionadores customizados devem ser reaplicados após a conclusão do processo de upgrade do Control Desk versão 7.6. v As extensões customizadas do código do Control Desk, tais como adições no código Java, nos applets Java, no JavaScript e no HTML. Essas customizações devem ser migradas manualmente para o Control Desk versão 7.6. v O upgrade de uma plataforma de banco de dados para outra. Por exemplo, não é possível fazer upgrade de uma implementação do Control Desk versão 7.5.x que usa um banco de dados Oracle para um Control Desk versão 7.6 que usa um banco de dados IBM DB2. Caso deseje fazer a movimentação de uma plataforma de banco de dados para outra, instale uma nova instância do Control Desk versão 7.6. A instalação de ofertas de produtos adicionais do Maximo pode afetar a instalação do Control Desk em várias áreas, incluindo o código fonte da instalação, a estrutura do banco de dados, o conteúdo do banco de dados e as chaves de licença. Para as ofertas de produtos cuja instalação afeta a estrutura ou o conteúdo do banco de dados, consulte a página da web de Recursos de Upgrade do Maximo, em https://www.ibm.com/support/docview.wss?uid=swg21266217, para obter informações sobre quais desses produtos são suportados pelo upgrade. O processo de upgrade do Control Desk versão 7.6 não concede autorizações de segurança para novos aplicativos ou para novas opções em aplicativos existentes. Deve-se designar a autorização por meio de aplicativos de segurança do Control Desk após a conclusão do upgrade para os novos aplicativos Control Desk 7.6. Consulte as informações da ajuda do aplicativo de segurança para obter detalhes. © Copyright IBM Corp. 1994, 2015 7 Importante: Se você não usar os aplicativos ou ferramentas do Control Desk para modificar a versão Control Desk do banco de dados do 7.5.x, essas mudanças podem produzir erros durante o upgrade. Remova essas customizações antes de iniciar o processo de upgrade. Quaisquer mudanças ao esquema do banco de dados ou objetos de banco de dados devem ser feitas usando os aplicativos do Control Desk. É possível usar aplicativos Control Desk para reaplicar essas customizações após o upgrade para o Control Desk versão 7.6. A falha ao executar as tarefas de pré-upgrade também podem produzir erros durante o upgrade. Para que o upgrade possa ser concluído, trate os erros ocorridos durante a execução do programa de upgrade. 8 IBM Control Desk: Guia de Upgrade Capítulo 5. Produtos e liberações suportados É possível fazer upgrade para o Control Desk versão 7.6 a partir de vários pontos de início diferentes. Alguns desses pontos de início requerem etapas adicionais. Control Desk versão 7.5 combina recursos e funções desses produtos anteriores: v IBM Tivoli Change and Configuration Management Database (CCMDB) v IBM Tivoli Service Request Manager v IBM Tivoli Asset Management for IT Seu caminho de upgrade é determinado pela versão do produto que está instalada atualmente. Para verificar a versão que está instalada, clique em Ajuda > Informações do Sistema. Para obter informações sobre caminhos de upgrade específicos, consulte a página Recursos de Upgrade na wiki do IBM Control Desk. © Copyright IBM Corp. 1994, 2015 9 10 IBM Control Desk: Guia de Upgrade Capítulo 6. Considerações sobre o Oracle WebLogic Server Existem algumas considerações especiais sobre o Oracle WebLogic Server para os upgrades para o Control Desk versão 7.6. A partir de 23 de abril de 2011, a IBM não fornece mais imagens de instalação do Oracle WebLogic Server para os clientes existentes e os que fazem upgrade. Se você implementou uma versão anterior do Control Desk no Oracle WebLogic Server e está considerando fazer o upgrade para a versão 7.6, é possível implementá-la usando o WebSphere Application Server Network Deployment versão 8.5.5, que é fornecido sem custo adicional. Como alternativa, é possível obter a mídia de instalação do Oracle WebLogic Server com a Oracle ou com um fornecedor de software Oracle aprovado. As versões do Oracle WebLogic Server que foram fornecidas com versões anteriores do Control Desk não são suportadas para uso com o Control Desk versão 7.6. Para obter mais informações sobre o suporte ao servidor de aplicativos, consulte a página Requisitos do Sistema para a versão 7.6 na wiki do Control Desk. © Copyright IBM Corp. 1994, 2015 11 12 IBM Control Desk: Guia de Upgrade Capítulo 7. Fazendo upgrade para o IBM Control Desk versão 7.6 É possível fazer upgrade da versão atual do IBM Control Desk para o Control Desk versão 7.6. Os seguintes cenários de upgrade são suportados: Tabela 1. Cenários de upgrade suportados Implementação Atual Implementação de Destino Método Control Desk versão 7.5.x, incluindo fix pack 7.5.0.6. Control Desk versão 7.6 Utilizando os programas de instalação e configuração do Control Desk versão 7.6. Após a conclusão de um upgrade, certifique-se de executar as tarefas de pós-instalação Conceitos de upgrade Pré-requisitos para fazer o upgrade da implementação atual do Control Desk versão 7.5.x para o Control Desk versão 7.6 Ante de iniciar o processo de upgrade, certifique-se de que os seguintes pré-requisitos tenham sido considerados ou concluídos. v Pare todos os Servidores de Aplicativos que executam o aplicativo Control Desk, por exemplo, MXServer. v Faça o backup da versão Control Desk do banco de dados do 7.5.x existente. Se ocorrer uma falha durante o upgrade, pode ser necessário restaurar o banco de dados do Control Desk versão 7.5.x. Algumas tarefas de upgrade não podem ser revertidas depois de serem confirmadas no banco de dados. Se houver um backup do banco de dados, é possível restaurar o ambiente. Como exemplo, suponha que, durante o upgrade, você escolha implementar um conteúdo opcional para gerenciadores de processo e uma falha ocorra. É possível decidir não implementar o conteúdo opcional ao reiniciar o processo de upgrade. Nesse caso, deve-se restaurar o banco de dados a partir do backup antes de iniciar o processo de upgrade novamente. Os arquivos encontram-se em C:\ibm\smp, por padrão. Essa prática pode ser útil se for necessário reconstruir os arquivos EAR do Control Desk, por exemplo. Faça backup do registro do mecanismo de implementação, conforme descrito nas informações de instalação do Control Desk versão 7.5.x. v Antes de fazer upgrade do Control Desk versão 7.6, deve-se executar as tarefas de pós-instalação do Control Desk versão 7.5.x, conforme descrito nas informações de instalação do Control Desk versão 7.5.x. As mudanças na configuração devem ser confirmadas para o banco de dados do Control Desk na conclusão da implementação do Control Desk original como uma tarefa de instalação posterior. É necessário fazer essa confirmação antes de iniciar o processo de upgrade. É possível encontrar detalhes no guia de instalação do Control Desk versão 7.5.x, no tópico intitulado Aplicando mudanças no banco de dados. © Copyright IBM Corp. 1994, 2015 13 Para confirmar que todas as mudanças foram confirmadas, execute a seguinte consulta SQL com relação ao banco de dados do Control Desk. SELECT count(*) from maxobjectcfg where changed != ’N’ SELECT count(*) from maxsysindexes where changed != ’N’ 'N' indica que uma mudança foi confirmada Para essa consulta, se forem retornados valores de contagem de linha positivos, deve-se Aplicar Mudanças de Configuração ou Descartar Mudanças de Configuração usando a opção de menu adequada, no aplicativo Configuração do Banco de Dados. Como alternativa, é possível usar configdb.bat para confirmar as mudanças na configuração, conforme descrito abaixo. Depois disso, é possível prosseguir com o processo de upgrade. Além disso, as tabelas que começam com XX são tabelas temporárias, que devem ser eliminadas antes da execução do processo de upgrade. Se essas tabelas existirem, elas causam a falha do processo de upgrade do Control Desk versão 7.6. Execute as seguintes etapas para remover essas tabelas: 1. Verifique se existem tabelas temporárias no banco de dados: DB2 select count(*) from sysibm.systables where name like ’XX%’ and creator = ’MAXIMO’ Microsoft SQL Server SELECT count(*) FROM sysobjects WHERE xtype = ’U’ AND name like ’XX%’ Oracle SELECT count(*) from all_tables where table_name like ’XX%’ 2. Se estiverem em execução, pare todos os Servidores de Aplicativos que executam o aplicativo Control Desk, por exemplo, MXServer. 3. Abra um prompt de comandos na estação de trabalho administrativa do Control Desk e emita os seguintes comandos: cd install_home\tools\maximo configdb.bat restorefrombackup.bat dropbackup.bat A execução de configdb.bat e restorefrombackup.bat executa a mesma função de escolher a opção de menu Aplicar Mudanças de Configuração do aplicativo Configuração do Banco de Dados no Control Desk. configdb.bat e restorefrombackup.bat requerem que todos os servidores de aplicativos que atendem o aplicativo Maximo sejam interrompidos. O comando dropbackup.bat não requer a interrupção dos servidores de aplicativos. Agora é possível continuar o preparo para o processo de upgrade Se as tabelas temporárias causarem um erro durante o uso do programa de configuração do Control Desk, é possível remover essas tabelas usando estas etapas e continuar em seguida. v Pare todos os servidores de aplicativos do Control Desk versão 7.5.x, por exemplo, MXServer, antes de iniciar o processo de upgrade. Todos os outros serviços de middleware, como o servidor de banco de dados, devem estar ativos, a menos que seja especificado de outra maneira nos procedimentos de upgrade. v Certifique-se de que você tenha acesso ao sistema administrativo do Control Desk. A maioria das tarefas de upgrade é executada neste sistema ou a partir dele. v Se você modificar algum aplicativo, exporte-os usando o Designer de Aplicativos antes de iniciar qualquer processo de upgrade. Consulte a ajuda do aplicativo do Control Desk 7.5.x para obter detalhes. 14 IBM Control Desk: Guia de Upgrade Roteiros do cenário de upgrade Diversos cenários estão disponíveis para fazer upgrade para o IBM Control Desk versão 7.6. O roteiro resume as opções de upgrade. IBM Control Desk 7.6 requer WebSphere Application Server Network Deployment v8.5.5 . Também é possível fazer upgrade para Control Desk 7.6 fazendo upgrade de sua instância de WebSphere Application Server Network Deployment existente para 8.5.5 ou é possível instalar um novo ambiente 8.5.5. Revise os seguintes cenários para determinar como fazer upgrade para Control Desk 7.6: Upgrade por meio da instalação e configuração do WebSphere Application Server Network Deployment v8.5.5 em um novo servidor (Cenário 1) O cenário 1 se aplicará a você se você atender a todos os seguintes critérios: v Você está instalando uma nova instância do WebSphere Application Server Network Deployment v8.5.5. v Sua instalação anterior do WebSphere Application Server Network Deployment está em um servidor diferente. v Você planeja usar o programa de configuração para configurar automaticamente o WebSphere Application Server Network Deployment v8.5.5. Esse cenário é útil se você deseja preservar a implementação do Control Desk versão 7.5.x ao fazer upgrade para o Control Desk 7.6. Nesse cenário, uma nova instância do WebSphere Application Server Network Deployment v8.5.5 é instalada e configurada. Nenhuma das informações de configuração do WebSphere Application Server Network Deployment v7 da implementação existente do Control Desk versão 7.5.x é reutilizada. O WebSphere Application Server Network Deployment v8.5.5 é estabelecido no ambiente da mesma maneira que seria utilizada para uma nova instalação do Control Desk versão 7.6. Upgrade por meio da migração das informações de configuração do WebSphere Application Server Network Deployment v7.x para o WebSphere Application Server Network Deployment v8.5.5 (Cenário 2) O cenário 2 se aplicará a você se você atender a todos os seguintes critérios: v Você está instalando uma nova instância do WebSphere Application Server Network Deployment v8.5.5. v Sua instalação anterior do WebSphere Application Server Network Deployment está no mesmo sistema como a instância do WebSphere Application Server Network Deployment v7 usada por você em sua implementação anterior do Control Desk. v Você planeja migrar as informações de configuração de WebSphere Application Server Network Deployment v7 para WebSphere Application Server Network Deployment v8.5.5. Para esse cenário, o WebSphere Application Server Network Deployment v8.5.5 é instalado no mesmo sistema que está hospedando o WebSphere Application Server Network Deployment v7. Em seguida, utiliza-se a ferramenta de migração do WebSphere Application Server Network Deployment v8.5.5 para mover os dados de configuração do WebSphere Capítulo 7. Upgrade do IBM Control Desk versão 7.6 15 Application Server Network Deployment v71 para o WebSphere Application Server Network Deployment v8.5.5. Nota: Ao serem migradas do WebSphere Application Server Network Deployment v7 para o WebSphere Application Server Network Deployment v8.5.5, as informações de configuração não são mais hospedadas no WebSphere Application Server Network Deployment v7. Upgrade no Oracle WebLogic Server (Cenário 3) Use esse cenário se desejar fazer upgrade Control Desk no Oracle WebLogic Server. Esse cenário descreve o upgrade em ambientes do Oracle WebLogic Server. Consulte a documentação do Oracle WebLogic Server para obter informações de migração do servidor de aplicativos. Após revisar as opções de cenário de upgrade, selecione o cenário apropriado para seu upgrade e siga as instruções que são fornecidas para esse cenário. 16 IBM Control Desk: Guia de Upgrade Capítulo 8. Planejando o processo de upgrade do Control Desk versão 7.6 Como todas as implementações do Control Desk são exclusivas, o processo de upgrade é diferente para cada implementação. No entanto, algumas considerações sobre o processo devem ser comuns a todos os upgrades. Informações de planejamento do Control Desk versão 7.6 Antes de iniciar o processo de upgrade, consulte o planejamento do Control Desk versão 7.6 para obter informações de implementação. O conteúdo de planejamento inclui informações importantes sobre mudanças feitas nesta liberação mais recente e que podem prepará-lo para diferenças inesperadas. Por exemplo, a aparência padrão do Control Desk versão 7.6 foi atualizada, o que pode levar a mudanças inesperadas na aparência das visualizações do aplicativo. As informações de planejamento podem ser encontradas na seção Planejamento da implementação da documentação do Control Desk em IBM Knowledge Center. Planejamento da programação de upgrade Ao fazer a programação do upgrade, é necessário planejar um tempo adequado para a conclusão de cada uma das diferentes fases do processo de upgrade: v Determinar quando é possível fazer o upgrade v Planejar o upgrade v Executar tarefas de pré-upgrade v Fazer o upgrade em um ambiente de teste v Solucionar os problemas do upgrade de teste v Fazer upgrade do ambiente de produção Nessa programação, deve-se definir um tempo para fazer o upgrade em um ambiente de teste. A execução de um upgrade de teste permite testar e solucionar os problemas do upgrade, sem que haja paradas adicionais no ambiente de produção. Você também deve planejar um tempo suficiente para treinar os administradores e usuários do Control Desk para que eles usem o novo software. Os membros da equipe devem entender os recursos do Control Desk 7.6 para que possam participar do processo de planejamento do upgrade. Nota: A IBM oferece serviços adicionais para auxiliar na avaliação ou execução do upgrade. Revise as configurações atuais do banco de dados Para assegurar que o upgrade seja bem-sucedido, compare as definições de configuração do banco de dados existente com as definições de configuração padrão usadas pelo programa de instalação atual. Esses detalhes podem ser encontrados nas informações de instalação do Control Desk versão 7.6, dentro das instruções de configuração manual para o tipo de banco de dados. Se os valores atuais forem insuficientes, isso pode causar problemas durante o processo de © Copyright IBM Corp. 1994, 2015 17 upgrade. Configure parâmetros de configuração iguais ou superiores aos definidos nas informações de instalação do Control Desk versão 7.6. Desempenho do processo de upgrade A velocidade da rede e o local físico dos servidores do Control Desk podem afetar o período de tempo necessário para a conclusão do upgrade. Durante o processo de upgrade, os scripts que são executados na estação de trabalho administrativa do Control Desk são usados para o processamento de comandos SQL individuais no banco de dados por meio de JDBC. Se a estação de trabalho administrativa do Control Desk e o servidor de banco de dados não estiverem na mesma rede local física, o desempenho do upgrade será afetado negativamente. A latência de rede excessiva entre os dois sistemas host também pode afetar o desempenho do processo de upgrade. Certifique-se de que sua conexão seja rápida e confiável, com latência de rede mínima entre a estação de trabalho administrativa do Control Desk e o servidor de banco de dados. Planejamento para o Control Desk versão 7.6 Antes de fazer o upgrade para o Control Desk versão 7.6, avalie suas operações e processos de negócios atuais e os novos recursos disponíveis no Control Desk versão 7.6, descritos neste guia. O upgrade fornece uma oportunidade de fazer mudanças não apenas no software do Control Desk, mas também na implementação do Control Desk. Treinamento para administradores do Control Desk Como administrador do Control Desk versão 7.6 você deve ter as habilidades e o conhecimento descritos a seguir ou deve ser capaz de executar as seguintes tarefas: v Instalar e configurar o software v Entenda as tarefas de Control Desk, tais como criar e modificar registros v Entender os conceitos do banco de dados relacional, como visualizações e junções v Entenda o banco de dados do Control Desk e os relacionados de dados v Construir instruções de linguagem de consulta estruturada (SQL) v Entender a sintaxe SQL necessária para seu banco de dados v Configure as propriedades do Control Desk para a configuração adequada v Definir privilégios de segurança para usuários e grupos Treinamento de usuários finais Você deve incluir o treinamento para todos os seus usuários do Control Desk como uma parte de sua versão do Control Desk do processo de implementação do 7.6, conforme precisam saber como os aplicativos existentes foram modificados. Além disso, se você fizer melhorias ou mudanças nos processos de negócios, é necessário fornecer treinamento aos funcionários sobre esses novos processos. 18 IBM Control Desk: Guia de Upgrade Planejando o upgrade do fluxo de trabalho Muitos aplicativos do Control Desk versão 7.6 passaram por mudanças. Essas mudanças podem afetar a implementação do fluxo de trabalho. O Control Desk versão 7.6 permite a criação de processos de fluxo de trabalho para qualquer aplicativo. Os aplicativos podem ter vários processos de fluxo de trabalho ativos. Após um upgrade bem-sucedido, avalie seus processos de negócios para determinar se você deseja criar novos processos de fluxo de trabalho. É possível optar por utilizar uma abordagem em fases para introduzir novos processos de fluxo de trabalho. É possível fazer upgrade dos processos de fluxo de trabalho existentes e, depois, gradualmente, apresentar novos processos, quando os usuários estiverem confortáveis para utilizar o Control Desk versão 7.6. Após a conclusão do upgrade, consulte os arquivos de ajuda dos aplicativos de fluxo de trabalho. Planejando o upgrade do hardware e do software Pode ser necessário atualizar vários componentes de hardware e software ao fazer upgrade para o Control Desk versão 7.6. Consulte a página Requisitos do Sistema na wiki do Control Desk para visualizar os requisitos atuais de hardware e de software para a versão 7.6. Requisito do WebSphere Application Server Network Deployment v8.5.5 Se o Control Desk versão 7.5.x foi implementado no WebSphere Application Server Network Deployment, o upgrade do Control Desk versão 7.6 requer o WebSphere Application Server Network Deployment v8.5.5. As instruções sobre como estabelecer o WebSphere Application Server Network Deployment v8.5.5 no ambiente para ser utilizado pelo Control Desk versão 7.6 são incluídas nos cenários de upgrade fornecidos neste guia. Além disso, se a instalação atual do Control Desk versão 7.5.x for implementada no WebSphere Application Server Network Deployment v8.5.5, é possível reutilizar esse servidor ao fazer upgrade para o Control Desk versão 7.6 Requisito do Oracle WebLogic Server 12c Se o Control Desk versão 7.5.x foi implementado no Oracle WebLogic Server, o upgrade do Control Desk versão 7.6 requer o Oracle WebLogic Server 12c Liberação 1 (12.1.2). As informações sobre como estabelecer o Oracle WebLogic Server 12c Liberação 1 (12.1.2) no ambiente para ser utilizado pelo Control Desk versão 7.6 são incluídas nos cenários de upgrade fornecidos neste guia. Opções de relatório O Control Desk versão 7.6 altera suas opções de relatório. Os usuários existentes do Actuate Reporting e do Business Objects Crystal Reports devem avaliar suas opções de relatório na liberação do Control Desk. Capítulo 8. Planejando o processo de upgrade do Control Desk versão 7.6 19 Para obter mais detalhes, consulte o Guia de Planejamento de Relatórios para a Liberação 7.6, disponível no site de suporte da IBM. Upgrade da Estrutura de Integração do Maximo A Estrutura de Integração do Maximo permite a sincronização e integração de dados e aplicativos entre o Control Desk e sistemas externos. Serviços da web A Estrutura de Integração do Maximo permite a sincronização e a integração de dados e aplicativos entre o Control Desk e sistemas externos, usando serviços da web. Há alterações de como os serviços da web são implementados noControl Desk versão 7.6. Apesar dessas mudanças, os serviços da web do Control Desk versão 7.5.x que são executados no Control Desk versão 7.6 não afetam os clientes SOAP existentes. As versões anteriores do Control Desk suportam as APIs de serviços da web AXIS2 e JAX-WS Java. O Control Desk versão 7.6 suporta apenas a API JAX-WS. Ao fazer upgrade para o Control Desk versão 7.6, os serviços da web existentes são convertidos para utilizarem a implementação baseada em JAX-WS. Contêineres de implementação de serviço da web Com a implementação de serviços da web no contêiner do produto, o serviço da web fica imediatamente disponível depois de ser implementado a partir do aplicativo da Biblioteca de Serviços da Web. Foi implementada uma mudança técnica que permite sair da implementação do serviço da web usando a API do Axis. Agora o contêiner do produto usa JAX-WS para a implementação. Funcionalmente, o serviço ainda está disponível na implementação. Essa opção de implementação de serviço da web depende da execução com o WebSphere Application Server versão 8.5.5.3 ou superior. Durante o upgrade, o registro dos serviços da web que estão implementados no contêiner de produto é atualizado com um novo arquivo de classe de implementação do JAX-WS e a classe de implementação do Axis é removida. Em novas instalações do Control Desk versão 7.6, o valor padrão para a propriedade de sistema mxe.int.containerdeploy é configurado com um valor 0 (false). Isso indica que o contêiner do produto usa um modelo de implementação padrão. Propagação de Erros do Serviço da Web Por padrão, quando um cliente chama um serviço da web do Control Desk e encontra um erro de lógica de negócios como Site Inválido, a mensagem de erro do Control Desk não é propagada de volta para o cliente. O cliente recebe uma exceção, mas a exceção não inclui os detalhes do erro do Control Desk. Se preferir receber o texto do erro do Control Desk na resposta do serviço da web, é necessário incluir a propriedade webservices.unify.faults por meio do Console Administrativo do WebSphere Application Server. 1. Efetue login no Console Administrativo do WebSphere Application Server e navegue para Servidores > Tipos de Servidor > servidores do Websphere Application . 20 IBM Control Desk: Guia de Upgrade 2. Selecione o nome do servidor. 3. Na seção de infraestrutura do servidor, selecione Gerenciamento de Processo e Java. 4. Selecione Definição de Processo. 5. Na seção Propriedades Adicionais, selecione Java virtual machine e, em seguida, Propriedades Customizadas. 6. Crie a propriedade webservices.unify.faults. a. Clique em New. b. Configure o nome como webservices.unify.faults. c. Configure o valor como false. Isso permite a propagação do texto do erro a partir da condição de erro encontrada pela integração. 7. Salve suas mudanças. Manipuladores de terminais de serviço da web No aplicativo de Terminal, não são fornecidos terminais de serviço da web predefinidos. No entanto, são fornecidos dois manipuladores de terminal predefinidos, WEBSERVICE e WEBSERVICE-JAXWS. O manipulador WEBSERVICE agora usa JAX-WS em vez de AXIS. Esta é uma mudança interna que não deve afetar o uso desses manipuladores nas implementações existentes. Para o Control Desk versão 7.6 e posteriores, use o manipulador WEBSERVICE-JAXWS, que incluirá os aprimoramentos futuros. O manipulador WEBSERVICE continua a ser suportado para as implementações existentes e implementações de integração, mas não será aprimorado futuramente. Uma nova propriedade HTTPHEADERS, foi incluída no manipulador WEBSERVICE-JAXWS. Essa propriedade opcional suporta a inclusão de HTTP HEADERS em uma transação de integração. Os valores do cabeçalho podem ser codificados permanentemente em uma lista separada por vírgula, por exemplo, Headername1:Headervalue1, Headername2:Headervalue2. Caso nenhum valor seja fornecido, apenas o nome do Cabeçalho será fornecido na propriedade. O código customizado de um canal de chamada pode injetar valores no contexto de transação. Esse mesmo recurso de propriedade, utilizando o nome HEADERS, foi incluído também no manipulador de HTTP. Versão de SOAP Para o Control Desk versão 7.6, a implementação de serviço suporta SOAP 1.1 ou 1.2. Todos os serviços são implementados usando uma única versão (não uma combinação). A versão do SOAP é configurada na propriedade de sistema, mxe.int.soapversion. Os valores válidos são SOAP11 ou SOAP12. filas JMS O WebSphere Application Server inclui uma nova propriedade, a ser usada para a persistência de mensagem. O WebSphere Application Server inclui uma sinalização para persistir a condição de nova entrega para mensagens de erro. A reinicialização do servidor de aplicativos não reconfigura essa sinalização, portanto, as mensagens de erro não serão processadas novamente após uma reinicialização do servidor. Capítulo 8. Planejando o processo de upgrade do Control Desk versão 7.6 21 Ative a opção Manter a contagem das entregas com falha por mensagem do Console Administrativo do WebSphere Application Server para todos os destinos de barramento de integração. Efetue login no Console Administrativo do WebSphere Application Server e navegue para Integração de Serviços > Barramentos > intjmsbus > Destinos > Destino do Barramento para configurar essa opção. Processamento de terminais de tabelas de interface O suporte de tabelas de interface depende da criação da tabela com base na configuração de colunas e objetos incluídos (e excluídos) na estrutura de objeto relacionada. Se um novo atributo persistente for incluído em um objeto e esse objeto estiver em uma estrutura de objeto que está associada a uma tabela de interface, o processamento de terminal pode encontrar um erro ao gravar na tabela de interface, se a tabela não for recriada de forma a refletir a estrutura de objeto atualizada. Portanto, quando uma nova coluna é incluída, por meio de uma customização ou pela instalação de uma solução para segmentos do mercado ou solução de um parceiro, a tabela de interface relacionada deve ser recriada. Isso deve ser feito mesmo que não haja intenção de integrar a nova coluna com outros aplicativos. Com o uso de uma nova propriedade de sistema, mxe.int.usedbinfoforifacetb, o processamento de tabelas de interface não requer mais que haja uma correspondência exata entre a estrutura de objeto e a tabela de interface. Quando a propriedade de sistema é configurada como 1 (true), o processo de interface se refere à tabela existente para determinar o que deve ser inserido na tabela, em vez de usar a definição de estrutura de objeto. Esse processo evita a existência de erros de nomes de coluna inválidos quando o terminal estiver gravando na tabela de interface. Para que haja suporte para os atributos recém-incluídos em uma tabela de interface, a tabela deve ser gerada novamente, para alinhar-se à definição da estrutura de objeto. Com respeito a essa mudança, há um utilitário disponível na IBM Integrated Service Management Library que pode verificar uma tabela de interface e sua estrutura de objeto relacionada, para identificar condições de falta de sincronização. Esse utilitário também pode atualizar a estrutura de objeto para excluir colunas, quando essas colunas não existem na interface. Consulte esse link para obter mais informações: http://www-304.ibm.com/software/brandcatalog/ ismlibrary/details?catalog.label=1TW10MA58. Processamento do Canal de Publicação para objetos que são visualizações Um novo sinalizador, Ignorar Diferentes Tipos de Objetos, foi incluído no aplicativo Canal de Publicação, para oferecer suporte ao processamento de mensagens de canal baseadas em Visualizações, por exemplo, o objeto WOACTIVITY, que é uma visualização da tabela WORKORDER. Atualmente, quando um evento é iniciado para um canal de publicação que utiliza WOACTIVITY em sua estrutura de objeto, o objeto do evento pode ser WOACTIVITY ou WORKORDER. Isso pode causar erros no processamento de regras ou arquivos de classe customizados baseados na transmissão do objeto 22 IBM Control Desk: Guia de Upgrade WOACTIVITY para o canal. Ao ativar Ignorar Diferentes Tipos de Objetos, apenas os eventos para o objeto que é o objeto raiz da estrutura de objeto são transmitidos para o canal de publicação. Neste exemplo, os eventos para WORKORDER não seriam enviados para o canal que utiliza WOACTIVITY. Uso do sistema de arquivos e do diretório global No Control Desk versão 7.6, foram feitas mudanças para reduzir o uso do sistema de arquivos e oferecer suporte à estrutura de integração. Nas liberações anteriores, o local do diretório comum (global), especificado na propriedade de sistema mxe.int.globaldir, suporta o armazenamento de arquivos relacionados ao processamento de integração. Quando essa propriedade não é configurada, o aplicativo usa o local da pasta padrão do servidor de aplicativos. No Control Desk versão 7.6, foram feitas várias mudanças que reduzem ou eliminam o uso do sistema de arquivos pela estrutura de integração. Dependendo do uso dos componentes de integração, a implementação pode não mais exigir uma pasta comum para os arquivos relacionados à integração. Mantenha o local do diretório comum durante o processo de upgrade e confirme o uso do sistema de arquivos pela implementação de integração. Talvez seja possível eliminar a configuração do diretório comum, dependendo do uso de vários componentes de integração. Com relação a essa mudança, outras áreas são afetadas: Arquivos de esquema e WSDL Os arquivos de esquema e WSDL não são mais criados no sistema de arquivos. É possível acessar os arquivos de esquema e WSDL por meio de uma URL. WSDL http://hostname: port/meaweb/wsdl/ Web Service Name?wsdl Esquema para o Serviço da Web Corporativo e o Serviço da Web da Estrutura de Objeto http://hostname: port/meaweb/schema/service/ Object Structure NameService.xsd Esquema para o Serviço da Web Padrão http://hostname: port/meaweb/schema/service/ss/Web Service NameService.xsd Esquema para a Estrutura de Objeto http://hostname: port/meaweb/schema/service/Object Structure Name A propriedade mxe.int.dynamicwsdlandschema não funciona mais e será removida durante o processo de upgrade. Arquivos temporários Os arquivos temporários são criados por processos particulares e permanecem no sistema de arquivos até a conclusão do processo, quando são excluídos. Os seguintes processos geram arquivos temporários: v Exportação baseada em aplicativos v Exportação de Dados v Extrações de Erros baseados em Arquivos v Recurso Visualizar Fila/Excluir Fila Capítulo 8. Planejando o processo de upgrade do Control Desk versão 7.6 23 Embora utilizem o sistema de arquivos, esses processos não requerem um diretório de pasta comum que suporte todos os servidores do Control Desk. Gerenciamento de Erro Baseado em Arquivo Anteriormente, o gerenciamento de erro baseado em arquivo suportava uma opção para fazer download de um arquivo de extração que já tinha sido criado e transferido por download. Essa opção não está mais disponível. Se a extração não for excluída do aplicativo de Reprocessamento de Mensagens, o arquivo de download pode ser recriado e novamente transferido por download, conforme necessário. Se necessário, salve as versões antigas dos arquivos de extração. Terminais baseados em arquivos (XML e simples) Para terminais baseados em arquivos (simples e XML), o processamento pode variar, dependendo da configuração dos parâmetros do terminal e de como os canais (de publicação ou chamada) são iniciados. O processamento utilizará o local de arquivo especificado no parâmetro do terminal para gravar o arquivo, mas, quando não preenchido, ele utilizará um diretório padrão existente no diretório global configurado (mxe.int.globaldir). O servidor que está processando a mensagem deve ter acesso ao diretório no qual o arquivo está sendo criado. Para uma mensagem do canal de publicação, o servidor que está processando a mensagem é o servidor no qual a tarefa CRON JMS de saída está sendo executada. Dependendo da configuração da implementação, essa tarefa CRON pode ser executada em diferentes servidores em momentos diferentes. Para os canais de chamada configurados com um terminal baseado em arquivo, o processamento ocorre no servidor no qual a chamada foi iniciada. É possível usar um diretório global comum para assegurar que todos os arquivos sejam criados em um único local. Sem um diretório global comum, os arquivos podem ser criados em vários servidores. Implementação do serviço da web para o contêiner do servidor de aplicativos A implementação de serviços da web no contêiner do servidor de aplicativos envolve a criação de um arquivo .dar que é salvo em uma pasta chamada jaxws, existente no diretório global. Se o diretório global não for configurado, ela estará localizada no diretório padrão dos servidores de aplicativos em que a etapa de implementação foi executada. Arquivos XSL para customização Se você usar XSL para a customização de integração e implementar esses arquivos usando o sistema de arquivos, em vez do arquivo EAR do Maximo, os arquivos devem estar localizados em uma pasta comum, na qual todos os servidores que estão processando canais e serviços podem acessar esses arquivos. Tarefas CRON de importação de arquivos XML e simples As tarefas CRON de importação de arquivos XML e simples requerem acesso ao local dos arquivos a serem importados. Esse local é definido no parâmetro SOURCEDIRECTORY. Se as tarefas CRON não forem configuradas para serem 24 IBM Control Desk: Guia de Upgrade executadas sempre em um servidor específico, o uso de um diretório de pastas comum é adequado. Terminal MXCOGNOS O valor do parâmetro de terminal MXCOGNOS, proj_base_dir, é necessário e utilizado para identificar o local do diretório do arquivo a ser gerado. Reprocessamento de mensagens - mensagens de erro baseadas em fila As mensagens de erro baseadas em fila agora são salvas no banco de dados, em vez de no sistema de arquivos. Funcionalmente, o gerenciamento das mensagens de erro permanece igual. No entanto, o formato da mensagem foi alterado. As seções de Registro Externo (conhecido como <ER>) e Registro Interno (conhecido como <IR>) de uma mensagem de erro são visualizadas separadamente no aplicativo de Reprocessamento de Mensagens. Os administradores ainda podem corrigir os dados do <ER> e reprocessar a mensagem. Rastreamento de mensagens - Mensagens persistidas É possível configurar o Rastreamento de Mensagens para persistir as mensagens no sistema de arquivos, além de usar os metadados que controlam o fluxo de uma mensagem ao entrar e sair de uma fila de integração. No Control Desk versão 7.6, quando essa opção é configurada, a mensagem é armazenada na tabela de banco de dados, juntamente com os metadados relacionados da transição. Upgrade de mensagens - Reprocessamento de mensagens e rastreamento de mensagens Ao instalar o Control Desk versão 7.6, todas as mensagens de reprocessamento de mensagens e rastreamento de mensagens que estão atualmente no sistema de arquivos são atualizadas. O processo de upgrade move os dados contidos nos arquivos para a linha adequada nas tabelas de banco de dados que suportam o reprocessamento de mensagens e o rastreamento de mensagens. O upgrade deixa os arquivos no sistema de arquivos, mas o processamento de integração não utiliza mais esses arquivos para nada. Caso um grande volume de mensagens de erro seja mantido no sistema de arquivos, é possível limpar e remover as mensagens que você não tem mais intenção de reprocessar. Recomendamos que a limpeza de mensagens de erro antigas seja feita usando o aplicativo de Reprocessamento de Mensagens, antes da execução do upgrade. Você será solicitado a fazer upgrade das mensagens ao instalar o Control Desk versão 7.6. A estação de trabalho administrativa do Control Desk versão 7.6 deve ter acesso ao diretório global durante o upgrade. Se você optar por não fazer upgrade das mensagens durante o processo de instalação, será possível iniciar o upgrade manualmente, após a conclusão da instalação. As mensagens relacionadas ao Reprocessamento de Mensagens DEVEM ser atualizadas. Se as mensagens de Reprocessamento de Mensagens não forem atualizadas, não será possível reprocessar ou excluir essas mensagens usando o aplicativo de Reprocessamento de Mensagens. Capítulo 8. Planejando o processo de upgrade do Control Desk versão 7.6 25 O volume das mensagens de Rastreamento de Mensagens movidas para o banco de dados pode ser significativo, portanto, isso deve ser considerado como parte da configuração de dimensionamento do banco de dados. Se as mensagens forem atualizadas manualmente, após a instalação do Control Desk versão 7.6, você terá a opção de não fazer upgrade das mensagens de Rastreamento de Mensagens. Para obter informações sobre o utilitário de Arquivamento de Rastreamento de Mensagem, consulte a wiki do Maximo. Upgrade manual de mensagens Com um upgrade manual é possível optar por não fazer upgrade das mensagens do Rastreamento de Mensagens. Sobre Esta Tarefa Ao decidir não fazer upgrade das mensagens de Rastreamento de Mensagens, não é possível visualizar essas mensagens no aplicativo de Rastreamento de Mensagens. Antes do upgrade, é possível excluir um subconjunto de arquivos e fazer upgrade apenas das mensagens selecionadas. Por exemplo, você talvez queira fazer upgrade dos arquivos que têm menos de 6 meses de idade. Nesse caso, é possível excluir manualmente os arquivos mais antigos, antes de executar o utilitário de upgrade. Os arquivos de rastreamento de mensagens estão localizados na pasta c:\temp\txndata, em que c:\temp é o diretório global configurado. Para fazer upgrade das mensagens baseadas em arquivos para o banco de dados após a instalação do Control Desk versão 7.6, execute as seguintes etapas. Procedimento 1. Efetue logon na estação de trabalho administrativa Control Desk. 2. Edite o arquivo maximo.properties. 3. Para o Rastreamento de Mensagens, configure a propriedade mxe.int.convmsgdir como c:\\temp. 4. Para o Reprocessamento de Mensagens, configure a propriedade mxe.int.convmsgtrkdir como c:\\temp. 5. Altere o diretório para MAXIMO_HOME/tools/maximo/internal. 6. Execute o script para o Rastreamento de Mensagens. runscriptfile -cmif -fV7600_12 for message tracking 7. Execute o script para o Reprocessamento de Mensagens. runscriptfile -cmif -fV7600_11 for message re-processing Desinstalando o IBM Maximo Adapter for Primavera antes do upgrade O adaptador do IBM Maximo Adapter for Primavera não é compatível com o Control Desk versão 7.6. Se sua implementação atual do Control Desk versão 7.5.x incluir o adaptador do IBM Maximo Adapter for Primavera, remova seus dados do banco de dados para poder fazer upgrade para o Control Desk versão 7.6. Antes de Iniciar Antes de iniciar, encerre o servidor de aplicativos do Control Desk versão 7.5.x. Assegure-se de que não haja mudanças de configuração do banco de dados pendentes e, em seguida, crie um backup do banco de dados. Crie um backup do diretório de instalação do Control Desk na estação de trabalho administrativa. 26 IBM Control Desk: Guia de Upgrade Sobre Esta Tarefa É possível remover automaticamente as informações do adaptador do Maximo Adapter for Primavera do banco de dados do Control Desk versão 7.5.x, utilizando os scripts desenvolvidos pela IBM fornecidos no website Fix Central. É possível editar o script antes de executá-lo para remover componentes adicionais. Por exemplo, caso você deseje remover também os aplicativos do Control Desk que contêm dados do Primavera, como Rastreamento de Ordens de Serviço (PV) e Planos de Tarefa (PV), é possível remover o comentário das instruções de remoção no script. Ao executar o script, todas as instruções que não estão comentadas são executadas. Procedimento 1. Efetue login na estação de trabalho administrativa do Control Desk versão 7.5.x e faça o download do script de remoção do adaptador do IBM Maximo Adapter for Primavera, UNINSTALL_PrimaveraAdapter_7X.zip, a partir do Fix Central. 2. Extraia o conteúdo do arquivo UNINSTALL_PrimaveraAdapter_7X.zip para a pasta install_home/maximo, selecionando as opções Sobrescrever arquivos existentes e Usar nomes de pastas. 3. Exclua o arquivo primavera.xml da pasta install_home\maximo\applications\ maximo\properties\product. 4. Opcional: Edite o script UNIST_PA_7X.dbc antes de executá-lo para remover componentes adicionais. Por exemplo, caso queira remover também os aplicativos do Control Desk que contêm dados do Primavera. <!-- Uncomment lines below to drop Maximo Applications that contains Primavera data, such as Work Order Tracking (PV) and Job Plans (PV) --> <drop_app app="PLUSVJP"/> <drop_app app="PLUSVWO"/> <!-- END OF Dropping Primavera applications --> 5. Altere o diretório para install_home\maximo\tools\maximo\internal e execute o script UNIST_PA_7X.dbc usando o utilitário runscriptfile. runscriptfile -cprimavera -fUNIST_PA_7X 6. Altere o diretório para install_home\maximo\tools\maximo e execute o comando updatedb. updatedb 7. Altere o diretório para install_home\bin e execute o comando solutioninstaller para visualizar uma lista de todos os aplicativos em execução. solutioninstaller.bat -action showinstalled -type all 8. Anote o valor do Identificador Exclusivo mostrado no IBM Maximo Adapter for Primavera. 9. Altere o diretório para install_home\CTG_DE\acsi\bin\ e execute o comando deleteRootIU. deleteRootIU.cmd Primavera_Unique_identifier PSI 10. Altere o diretório para install_home\bin e execute novamente o comando solutioninstaller, para assegurar-se de que o IBM Maximo Adapter for Primavera foi removido. solutioninstaller.bat -action showinstalled -type all Capítulo 8. Planejando o processo de upgrade do Control Desk versão 7.6 27 Mudanças no middleware suportado Esteja ciente de que pode haver mudanças no comportamento do software de middleware ou nos sistemas operacionais de plataforma suportados pelo Control Desk versão 7.6. Por exemplo, ao fazer upgrade do SQL Server 2008 para o SQL Server 2012, a porta padrão usada pelo Control Desk, que é a porta 1433, permanecerá aberta caso estivesse disponível e em uso para a implementação do Control Desk versão 7.5.x. No entanto, ao instalar uma nova instância do SQL Server 2012, por padrão a porta 1433 fica fechada. 28 IBM Control Desk: Guia de Upgrade Capítulo 9. Tarefas de pré-upgrade Antes de iniciar o upgrade, conclua as seguintes tarefas. Criando uma cópia de teste do banco de dados O processo de upgrade deve ser executado primeiro em uma cópia de teste do banco de dados do Control Desk. Durante o upgrade de teste, anote as etapas especiais ou modificações do banco de dados a serem executadas. É uma boa ideia executar o upgrade de teste mais de uma vez, a cada vez utilizando uma cópia do banco de dados de produção mais recente. O processo de upgrade pode demorar dois dias ou mais, dependendo do tamanho do banco de dados. Após o upgrade bem-sucedido de uma ou mais cópias de teste, repita o processo com uma cópia do banco de dados de produção atual. Esse banco de dados atualizado torna-se o novo banco de dados de produção. Consulte a documentação fornecida com o banco de dados para obter detalhes sobre a criação de backups do banco de dados. Desativação de acionadores customizados Desative todos os acionadores customizados que existem em todas as tabelas no banco de dados existente do Control Desk. O Control Desk versão 7.6 não suporta objetos de banco de dados criados (incluindo procedimentos armazenados, acionadores, visualizações e sinônimos) que dependem de objetos de banco de dados do Control Desk. O upgrade não recria esses objetos, mas também não os remove. Os acionadores customizados devem ser reaplicados após a conclusão do upgrade do Control Desk versão 7.6. Fazendo backup do banco de dados Independentemente de seu ponto de início, faça backup do banco de dados do Control Desk recém-preparado. Preservação de atributos para portlets customizados Depois de fazer upgrade para o Control Desk versão 7.6, é possível descobrir que há uma diferença no número de atributos disponíveis para um portlet que foi definido no Control Desk versão 7.5.x. Se você criou um portlet no Control Desk versão 7.5.x e excluiu atributos de um relatório que foi desenvolvido para o portlet, depois do upgrade para o Control Desk versão 7.6, os atributos não estarão mais disponíveis para o portlet. Caso deseje preservar todos os atributos de um portlet, desmarque os atributos que foram excluídos do Control Desk versão 7.5.x antes de fazer o upgrade. © Copyright IBM Corp. 1994, 2015 29 Requisitos do comando tar do AIX O comando UNIX tar nativo e a versão GNU do comando tar são necessários pelo programa de instalação de middleware. Como o utilitário nativo não suporta nomes de arquivo longos, certifique-se de que GNU tar versão 1.14 ou superior esteja instalado. GNU tar versão 1.14 assegura que os arquivos de instalação podem ser extraídos. Verifique se a variável do caminho do sistema contém caminhos GNU tar e UNIX tar nativo. O caminho GNU tar deve ser definido antes do caminho UNIX tar nativo. Por exemplo, o utilitário tar ativo é instalado no /usr/bin e o utilitário GNU tar é instalado no /opt/freeware/bin/tar. Se você tiver configurado um link simbólico para sobrescrever o comando UNIX tar nativo pelo comando GNU tar, ocorrerá um erro. http://www.ibm.com/systems/p/os/aix/linux/toolbox/download.html Modo de compatibilidade do Internet Explorer O Control Desk não suporta navegadores Microsoft Internet Explorer com o modo de compatibilidade ativado. Os navegadores nos quais o modo de compatibilidade está ativado apresentarão erros e problemas de desempenho. Se o modo de compatibilidade estiver ativado no navegador, desative-o. Permissões de usuário administrativo O Control Desk requer que você efetue login em um sistema como administrador para executar as atividades de instalação e configuração. Esses usuários administrativos devem ser os membros primários do grupo raiz ou Administradores para o Linux ou Windows, respectivamente. Não inicie o programa de instalação e configuração do Control Desk com um ID de usuário pertencente a um grupo secundário que, por sua vez, está associado ao grupo administrativo. O usuário administrativo deve ser um membro direto dos grupos raiz ou Administradores. Além disso, você deve executar as atividades de instalação e configuração como um administrador real. Não é possível executar os programas de instalação e configuração no Windows clicando com o botão direito e usando a opção Executar como administrador. 30 IBM Control Desk: Guia de Upgrade Capítulo 10. Fazendo upgrade por meio da instalação do WebSphere Application Server Network Deployment Versão 8.5.5 em um novo servidor (Cenário I) A lista de verificação a seguir é um roteiro de alto nível das tarefas que devem ser executadas para fazer upgrade para instalar e configurar automaticamente o WebSphere Application Server Network Deployment v8.5.5 para o Control Desk 7.6. Antes de iniciar, certifique-se de revisar as seguintes informações: v “Roteiros do cenário de upgrade” na página 15 Observe também que as configurações customizadas executadas no servidor do WebSphere Application Server Network Deployment v7 para o Control Desk 7.5.x devem ser executadas novamente para o WebSphere Application Server Network Deployment v8.5.5. Nesse cenário, use o programa de instalação do Control Desk versão 7.6 para instalar o WebSphere Application Server Network Deployment v8.5.5 e, em seguida, use o programa de instalação do Control Desk versão 7.6 para configurá-lo automaticamente. Nenhuma das informações de configuração do WebSphere Application Server Network Deployment v7 da implementação existente do Control Desk versão 7.5.x são reutilizadas. O WebSphere Application Server Network Deployment v8.5.5 é estabelecido no ambiente da mesma maneira que seria utilizada para uma nova instalação do Control Desk versão 7.6. O WebSphere Application Server Network Deployment v8.5.5 deve ser instalado em um sistema diferente do servidor que hospeda o WebSphere Application Server Network Deployment v7 para a implementação do Control Desk versão 7.5.x. O benefício da utilização deste cenário de upgrade é que ele fornece a instalação e configuração automáticas do WebSphere Application Server Network Deployment v8.5.5, mantendo a configuração existente do WebSphere Application Server Network Deployment v7 em que o Control Desk 7.5.x foi implementado. Durante o processo de upgrade o banco de dados é atualizado da versão 7.5.x para a versão 7.6. O banco de dados atualizado não pode continuar a ser usado pelo Control Desk versão 7.5.x. Caso você deseje manter o ambiente do Control Desk versão 7.5.x, o upgrade do Control Desk versão 7.6 deve ser executado em uma instância separada do banco de dados do Control Desk versão 7.5.x. O processo de upgrade envolve a execução de uma nova instalação do Control Desk versão 7.6 e sua posterior configuração para a utilização do banco de dados do Control Desk versão 7.5.x. O banco de dados é atualizado durante o processo de configuração. O upgrade não deve ser executado a partir da estação de trabalho administrativa do Control Desk versão 7.5.x. As plataformas suportadas para estações de trabalho administrativas do Control Desk versão 7.5.x não são suportadas no Control Desk versão 7.6. © Copyright IBM Corp. 1994, 2015 31 Lista de verificação para a instalação do WebSphere Application Server Network Deployment v8.5.5 Use a lista de verificação a seguir como uma diretriz ao fazer upgrade para a versão 7.6, instalando o WebSphere Application Server Network Deployment em um novo servidor. Tabela 2. Lista de verificação do WebSphere Application Server Network Deployment versão 8.5.5 Etapa Ação Descrição 1 Revise e execute os pré-requisitos de upgrade. Revise e execute os pré-requisitos de upgrade descritos em Capítulo 9, “Tarefas de pré-upgrade”, na página 29. 2 Execute o Verificador de Integridade no modo de Relatório no ambiente existente. Para obter instruções detalhadas, consulte “Execução do verificador de integridade do 7.5.x” na página 34. Para obter informações sobre as mensagens de erro, consulte a documentação a seguir: v “Mensagens informativas do verificador de integridade” na página 91 v “Mensagens de aviso do verificador de integridade” na página 91 v “Mensagens de erro do verificador de integridade” na página 94 3 32 Certifique-se de que tenha o sistema operacional apropriado. IBM Control Desk: Guia de Upgrade Para obter uma lista de sistemas operacionais suportados, consulte a página Requisitos do Sistema na wiki IBM Control Desk. Tabela 2. Lista de verificação do WebSphere Application Server Network Deployment versão 8.5.5 (continuação) Etapa 4 Ação Descrição Estabeleça o middleware suportado. Use o programa de instalação do Control Desk versão 7.6 para instalar o WebSphere Application Server Network Deployment v8.5.5 e use o programa de configuração do Control Desk 7.6 para preparar-se para o Control Desk 7.6. Revise as informações sobre como estabelecer um middleware suportado em “Estabeleça um middleware suportado” na página 35. Execute as tarefas a seguir para estabelecer um middleware suportado: v Se necessário, faça upgrade do software de banco de dados para uma versão suportada, usando o programa de instalação desse software. Antes de fazer upgrade do software de banco de dados, verifique a Matriz de Configuração do Produto para determinar se o software é suportado por esta liberação. A Matriz de Configuração do Produto está disponível aqui. v Se necessário, faça upgrade do software do servidor de diretório para uma versão suportada, usando o programa de instalação desse software. Consulte a documentação fornecida com o produto para obter informações sobre upgrade. v Use o programa de instalação para instalar o WebSphere Application Server Network Deployment v8.5.5, conforme descrito em “Instalando o WebSphere Application Server Network Deployment v8.5.5 usando o programa de instalação do Control Desk versão 7.6” na página 36. v Após a conclusão da instalação, use o programa de configuração do Control Desk versão 7.6 para preparar o WebSphere Application Server Network Deployment v8.5.5 para o Control Desk 5 Opcional: Se necessário, migre os dados do banco de dados ou do servidor de diretórios. Para obter mais informações, consulte o “Migre os dados do banco de dados ou do servidor de diretórios (opcional)” na página 38. 6 Execute o programa de instalação do Execute o programa de instalação do Control Desk versão Control Desk 7.6 para instalar o Control Desk na estação de trabalho administrativaPara fazer o upgrade, execute as etapas descritas em “Executando o programa de instalação do Control Desk 7.6” na página 39. 7 Migre as customizações da implementação anterior. Migre as customizações feitas na estação de trabalho administrativa do Control Desk versão 7.6. A migração deve ser executada para todos os produtos instalados na estação de trabalho. Para obter mais informações, consulte o “Migração de customizações” na página 41. Capítulo 10. Fazendo upgrade por meio da instalação do WebSphere Application Server Network Deployment v8.5.5 em um novo servidor (Cenário 1) 33 Tabela 2. Lista de verificação do WebSphere Application Server Network Deployment versão 8.5.5 (continuação) Etapa 8 Ação Descrição Execute o programa de configuração do Control Desk Execute o programa de configuração do Control Desk versão 7.6. As mudanças são gravadas no banco de dados e, se você optar por isso, os arquivos EAR do aplicativo serão implementados no WebSphere Application Server Network Deployment. Para obter mais informações, consulte o “Configurando Control Desk versão 7.6 usando o programa de configuração do Control Desk versão 7.6” na página 42. 9 Execute o Verificador de Integridade do Control Desk 7.6. Execute a ferramenta Verificador de Integridade no modo de Relatório. Se o Verificador de Integridade relatar um erro, resolva-o. Para obter informações sobre as mensagens de erro, consulte a documentação a seguir: v “Mensagens informativas do verificador de integridade” na página 91 v “Mensagens de aviso do verificador de integridade” na página 91 v “Mensagens de erro do verificador de integridade” na página 94 10 Execute as tarefas de pós-upgrade. Revise informações importantes sobre tarefas de pós-upgrade em Capítulo 15, “Tarefas pós-upgrade”, na página 81. São fornecidas uma lista de verificação e instruções detalhadas para a conclusão das tarefas de pós-upgrade. Execução do verificador de integridade do 7.5.x Execute o utilitário verificador de integridade do Control Desk versão 7.5.x. Sobre Esta Tarefa Antes de prosseguir com o processo de upgrade do Control Desk versão 7.6, execute o utilitário Verificador de Integridade do Control Desk versão 7.5.x. Esse utilitário é usado com o banco de dados do Control Desk versão 7.5.x para assegurar que ele esteja pronto para o upgrade. Quando executado no modo de Relatório, o utilitário verificador de integridade verifica a ocorrência de erros comuns no banco de dados e nos relatórios atuais. Se o Verificador de Integridade relatar um erro, resolva-o executando o Verificador de Integridade no modo de Reparo. Se não for possível usar a interface gráfica com o usuário, também é possível executar um dos seguintes scripts para validação: v Windows: validate_integ.bat v UNIX: validate_integ.sh Procedimento 1. Na estação de trabalho administrativa do Control Desk versão 7.5.x, abra um prompt de comandos e altere o diretório para o diretório de ferramentas. Por exemplo, install_home\maximo\tools\maximo 2. Inicie a ferramenta do Verificador de Integridade. 34 IBM Control Desk: Guia de Upgrade v Nos sistemas operacionais Windows integrityui.bat v Em outros sistemas operacionais suportados integrityui.sh 3. Selecione a guia Verificação de Integridade. 4. Execute o Verificador de Integridade no modo de Relatório. a. Certifique-se de que a caixa de seleção Modo de Reparo? esteja desmarcada e, em seguida, clique em Executar Verificador de Integridade. b. Quando a caixa de diálogo de relatório aparecer, clique em OK. Os resultados podem ser encontrados no diretório install_home\maximo\tools\ maximo\log no arquivo definido no campo Nome do Arquivo de Log do painel Verificação da Integridade. 5. Opcional: Se algum erro for relatado, execute o Verificador de Integridade no modo de Reparo. a. Marque a caixa de seleção Modo de Reparo? e, em seguida, clique em Executar Verificador de Integridade. b. Quando a caixa de diálogo de relatório aparecer, clique em OK. c. Altere o diretório para install_home\maximo\tools\maximo\ e, em seguida, execute o comando dbconfig. 6. Opcional: Se o Verificador de Integridade foi executado no modo de Reparo, verifique o arquivo de log para assegurar-se de que todos os itens relatados foram reparados. Se for necessário fazer outras intervenções manuais, resolva os erros e, em seguida, execute novamente o Verificador de Integridade no modo de Relatório. Repita o processo até que não haja mais erros. Resultados Embora o Verificador de Integridade possa reparar muitos erros, talvez seja necessário resolver alguns erros manualmente, consultando os arquivos de log. Estabeleça um middleware suportado Estabeleça no ambiente um middleware que seja compatível com o Control Desk versão 7.6. A primeira etapa em um upgrade do Control Desk versão 7.6 é estabelecer no ambiente um middleware que seja suportado pelo Control Desk versão 7.6. Em alguns casos, o middleware usado na implementação do Control Desk versão 7.5.x, por exemplo, o software de banco de dados ou de servidor de diretórios, pode ser reutilizado para o upgrade do Control Desk versão 7.6. Em outros casos, talvez seja necessário usar novos servidores de middleware, que não faziam parte da implementação original do Control Desk versão 7.5.x. O programa de instalação do Control Desk versão 7.6 é usado para instalar o WebSphere Application Server Network Deployment v8.5.5. A ferramenta de configuração prepara o Control Desk para a versão 7.6. Se necessário, faça upgrade do software de banco de dados para uma versão suportada pelo Control Desk versão 7.6. O upgrade do software de banco de dados existente usado com o Control Desk versão 7.5.x é o método preferencial para o estabelecimento de um banco de dados suportado pelo Control Desk versão 7.6. Este método permite a reutilização de elementos existentes da implementação do Control Desk versão 7.5.x, como o ID do usuário e instâncias de banco de Capítulo 10. Fazendo upgrade por meio da instalação do WebSphere Application Server Network Deployment v8.5.5 em um novo servidor (Cenário 1) 35 dados. Em alguns casos, você pode ser forçado a instalar uma nova instância do software de banco de dados. Por exemplo, a implementação do Control Desk versão 7.5.x pode incluir um servidor de banco de dados estabelecido em uma plataforma que não é mais suportada no Control Desk versão 7.6, como pode ser o caso com plataformas de 32 bits. Nesse cenário, deve-se instalar uma nova instância do software de banco de dados que seja compatível com o Control Desk versão 7.6. Para o DB2, é possível instalar esse software usando o programa de instalação do Control Desk versão 7.6. Se você instalar novas instâncias de software de banco de dados fora do programa de instalação do Control Desk versão 7.6, será necessário executar tarefas adicionais de configuração manual, descritas nas informações de instalação do Control Desk 7.6. Além disso, será necessário migrar o banco de dados do servidor antigo para o novo servidor. Se necessário, faça upgrade do software do servidor de diretório para uma versão suportada pelo Control Desk versão 7.6. Consulte a documentação fornecida com o produto do servidor de diretório para obter informações sobre upgrade. Instalando o WebSphere Application Server Network Deployment v8.5.5 usando o programa de instalação do Control Desk versão 7.6 Este procedimento explica como usar o programa de instalação do Control Desk versão 7.6 para instalar o WebSphere Application Server Network Deployment v8.5.5. Sobre Esta Tarefa Estas instruções são para a instalação do WebSphere Application Server Network Deployment v8.5.5 em um único sistema, usando o programa de instalação do Control Desk versão 7.6. Para instalar o WebSphere Application Server Network Deployment v8.5.5 para IBM Control Desk versão 7.6 usando o programa de instalação do IBM Control Desk versão 7.6, siga estas etapas. Procedimento 1. Efetue login no sistema de destino como um usuário com autoridade administrativa. Se estiver executando o programa de instalação do IBM Control Desk versão 7.6 a partir de um Linux ou janela do terminal do UNIX, você deverá efetuar login como usuário raiz. 2. Ative o programa de instalação do IBM Control Desk versão 7.6 a partir da barra de ativação. a. Inicie o painel de ativação. Windows Na imagem de instalação transferida por download, navegue para o diretório-raiz e execute o seguinte comando: launchpad64.exe. Linux e UNIX A partir da imagem de instalação transferida por download, navegue para o diretório raiz e execute o seguinte comando: launchpad64.sh. b. Selecione um idioma para a instalação e clique em OK. c. Na área de janela de navegação da barra de ativação, clique em Instalar Produto. 36 IBM Control Desk: Guia de Upgrade d. No painel Instalar Produto, selecione IBM WebSphere Application Server Network Deployment v8.5.5 e, em seguida, clique em Instalar IBM Control Desk componentes. 3. No painel de seleção de pacote, clique em Avançar. 4. No painel de validação de pré-requisito de pacote, revise os resultados da verificação de pré-requisito e clique em Avançar. Se algum erro for relatado neste painel, resolva o problema e clique em Verificar Status Novamente antes de continuar. 5. No painel de contrato de licença, revise as informações de licença para cada pacote que está sendo instalado, selecione Aceito os termos nos contratos de licença se você concordar com os termos e, em seguida, clique em Avançar. 6. No painel do local de instalação do Installation Manager, especifique informações de caminho para o diretório de recursos compartilhados e o diretório de instalação do Installation Manager e clique em Avançar. O Installation Manager é uma estrutura de instalação que é usada para instalar a versão Control Desk dos componentes do 7.6. O diretório de recursos compartilhados é um diretório da área de trabalho comum usado pelo Installation Manager ao instalar pacotes. 7. No painel do local de instalação do pacote, selecione um grupo de pacotes, especifique informações de caminho para seu diretório de instalação e, em seguida, clique em Avançar. Repita este processo para cada grupo de pacotes listado. 8. No painel de traduções do pacote, especifique o suporte ao idioma para WebSphere Application Server Network Deployment e clique em Avançar. 9. No painel de recursos do pacote, deixe todas as opções padrão marcadas e clique em Avançar. 10. No painel de configuração do pacote, especifique as informações de configuração para IBM HTTP Server e clique em Avançar. 11. No painel de resumo de pacote, revise as informações para a instalação planejada e clique em Instalar. 12. Após a conclusão da instalação, clique em Concluir. Preparando o WebSphere Application Server Network Deployment v8.5.5 usando o programa de configuração do Control Desk Este procedimento explica como usar o programa de configuração do Control Desk versão 7.6 para preparar o WebSphere Application Server Network Deployment v8.5.5 para a configuração do Control Desk. Procedimento 1. Se o programa de configuração do Control Desk não estiver aberto, inicie-o a partir da barra de ativação do Control Desk. Na área de janela de navegação da barra de ativação, clique em Configurar Produto e em Ativar o programa de configuração Process Automation Suite do Tivoli. 2. Na página de operações de configuração do IBM Control Desk versão 7.6, clique em Preparar o WebSphere Application Server Network Deployment para configuração. 3. No painel Configurar o aplicativo para WebSphere, especifique o local de instalação e as informações de configuração para o WebSphere Application Server Network Deployment e os componentes associados. Capítulo 10. Fazendo upgrade por meio da instalação do WebSphere Application Server Network Deployment v8.5.5 em um novo servidor (Cenário 1) 37 4. No painel Configurar os perfis do servidor de aplicativos, especifique as informações a serem usadas para criar os perfis do servidor de aplicativos e do gerenciador de implementação do WebSphere Application Server Network Deployment. 5. Especifique informações de configuração adicionais no painel Configurar Opções Avançadas de Servidor de Aplicativo se for necessário. 6. Se você optou por usar um servidor de diretório para segurança administrativa do WebSphere Application Server Network Deployment, especifique informações sobre o host do servidor de diretório, credenciais e estrutura de diretório a partir do painel Configurar Segurança Administrativa. 7. No painel Aplicar Operações de Implementação, selecione todas as opções de operação de implementação e clique em Concluir. Resultados O WebSphere Application Server Network Deployment v8.5.5 está pronto para o Control Desk. Migre os dados do banco de dados ou do servidor de diretórios (opcional) Dependendo do ambiente, pode ser necessário migrar os dados do banco de dados ou do servidor de diretórios dos servidores de middleware do Control Desk 7.5.x para os servidores de middleware do Control Desk 7.6. Nos casos em que o middleware utilizado para implementar o Control Desk 7.5.x for incompatível com o Control Desk 7.6, é possível migrar as informações do Control Desk 7.5.x para um servidor suportado pelo Control Desk 7.6. Ao fazer um upgrade, não é possível fazer o upgrade do middleware do IBM DB2 a partir da barra de ativação. Você deve fazer o upgrade do middleware do banco de dados separadamente. Para obter informações sobre o upgrade do IBM DB2, consulte o Portal de Upgrade do DB2. As informações também estão disponíveis na documentação do IBM DB2 no IBM Knowledge Center. Se o software de banco de dados do Control Desk 7.5.x for compatível com o Control Desk 7.6, é possível usar o banco de dados existente. Se o banco de dados existente não for compatível, consulte a documentação fornecida com o software para obter instruções sobre como migrar objetos de bancos de dados. Para o DB2, essas informações podem ser localizadas em na Documentação do IBM DB2 no IBM Knowledge Center. Lembre-se de que, caso o software de banco de dados tenha sido atualizado, é necessário migrar apenas a instância de banco de dados (ctginst1) e o banco de dados (maxdb75) do Control Desk 7.5.x. Se você instalou uma nova instância do software de banco de dados, execute as tarefas de configuração adicionais, conforme descrito nas informações de instalação do Control Desk 7.6. Se você optou por usar um servidor de diretório para a segurança na implementação do Control Desk 7.5.x e tiver que migrar informações do servidor de diretórios para cumprir os pré-requisitos do Control Desk 7.6, consulte a documentação fornecida com o software para obter instruções sobre migração. Se tiver usado o IBM Security Directory Server para a implementação do Control Desk 7.5.x, nenhuma migração é necessária, porque a mesma versão do IBM Security Directory Server é suportada em ambos os produtos. 38 IBM Control Desk: Guia de Upgrade Executando o programa de instalação do Control Desk 7.6 Esse procedimento explica como usar o programa de instalação doControl Desk versão 7.6 para instalar o Control Desk versão 7.6. Sobre Esta Tarefa O programa de instalação do Control Desk versão 7.6 é executado no sistema que for designado como a estação de trabalho administrativa do Control Desk versão 7.6. O upgrade não deve ser executado a partir da estação de trabalho administrativa do Control Desk versão 7.5.x. As plataformas suportadas para as estações de trabalho administrativas do Control Desk versão 7.5.x, por exemplo, Windows 2008, não são suportadas no Control Desk versão 7.6. O processo de upgrade envolve a execução de uma nova instalação do Control Desk versão 7.6 e sua posterior configuração para a utilização do banco de dados do Control Desk versão 7.5.x. Procedimento 1. Efetue login no sistema que for designado como a estação de trabalho administrativa do Control Desk versão 7.6. Se você executar o programa de instalação do IBM Control Desk versão 7.6 a partir de uma janela do terminal do Linux ou do UNIX, deverá estar com login efetuado como o usuário raiz. 2. Ative o programa de instalação do IBM Control Desk versão 7.6 a partir da barra de ativação. a. Inicie o painel de ativação. Windows A partir da imagem de instalação transferida por download, navegue para o diretório-raiz e execute o seguinte comando: launchpad64.exe. Linux e UNIX A partir da imagem de instalação transferida por download, navegue até o diretório-raiz e execute o seguinte comando: launchpad.sh. b. Selecione um idioma para a instalação e clique em OK. c. Na área de janela de navegação da barra de ativação, clique em Instalar Produto. d. No painel Instalar Produto, selecione IBM Control Desk v7.6 e, em seguida, clique em Instalar componentes do IBM Control Desk. 3. No painel de seleção de pacote, clique em Avançar. Não desmarque a caixa de seleção para IBM Maximo for Service Providers. Fornece recursos que são usados no IBM Control Desk. 4. No painel de validação de pré-requisito de pacote, revise os resultados da verificação de pré-requisito e clique em Avançar. Se algum erro for relatado neste painel, resolva o problema e clique em Verificar Status Novamente antes de continuar. 5. No painel de contrato de licença, revise as informações de licença para cada pacote que está sendo instalado, selecione Aceito os termos nos contratos de licença se você concordar com os termos e, em seguida, clique em Avançar. Capítulo 10. Fazendo upgrade por meio da instalação do WebSphere Application Server Network Deployment v8.5.5 em um novo servidor (Cenário 1) 39 6. No painel de localização, para especificar as informações de caminho para o diretório de instalação do IBM Control Desk, selecione uma das seguintes opções e, em seguida, clique em Avançar. Opção Descrição Se a instalação estiver sendo executada em uma estação de trabalho administrativa com uma instalação anterior 1. Selecione Criar um novo grupo de pacotes. Se a instalação estiver sendo executada em uma nova estação de trabalho administrativa sem instalação anterior 1. Selecione Criar um novo grupo de pacotes. 2. No campo Diretório de Instalação, certifique-se de especificar um nome de diretório que seja diferente do diretório de instalação anterior. 2. No campo Diretório de Instalação, especifique um nome de diretório para o diretório de instalação. 7. No painel de local de instalação do pacote, use os valores padrão ou especifique um novo diretório para o diretório de Recursos Compartilhados e para o diretório do Installation Manager. Em seguida, clique em Avançar. O Installation Manager é uma estrutura de instalação que é usada para instalar a versão Control Desk dos componentes do 7.6. O diretório de recursos compartilhados é um diretório da área de trabalho comum usado pelo Installation Manager ao instalar pacotes. Se o Installation Manager já estiver instalado, a opção para selecionar um caminho de instalação para o Installation Manager não será exibida. 8. No painel de recursos do pacote, deixe todas as opções padrão marcadas e clique em Avançar. 9. No painel de resumo de pacote, revise as informações para a instalação planejada e clique em Instalar. 10. Após a conclusão da instalação, se não houver soluções para segmentos de mercado e complementos para serem instalados, é possível selecionar a opção para iniciar o programa de configuração do Control Desk versão 7.6 e, em seguida, clicar em Concluir. O programa de instalação do Control Desk versão 7.6 sai e o programa de configuração do Control Desk versão 7.6 é iniciado automaticamente. Se for necessário instalar soluções para segmentos de mercado e complementos, saia do programa de configuração do Control Desk versão 7.6 e instale esses itens antes de continuar. O que Fazer Depois As soluções para segmentos de mercado e os complementos da versão 7.5 devem ser instalados nesse momento. As soluções para segmentos de mercado e os complementos da versão 7.5 podem ser instalados no Control Desk 7.6 a partir da linha de comandos. A instalação silenciosa também é suportada. Assegure-se de fazer o download da versão e de correções mais recentes disponíveis para a solução para segmentos do mercado ou do complemento antes de instalá-la. Consulte a Matriz de Requisitos de Upgrade do Maximo para obter as informações mais recentes sobre os requisitos para soluções para segmentos de mercado e complementos. Após a instalação, use o programa de configuração do Control Desk versão 7.6 para configurar o Control Desk versão 7.6. 40 IBM Control Desk: Guia de Upgrade Migração de customizações Migre as customizações feitas na implementação do Control Desk 7.5.x para a estação de trabalho administrativa do Control Desk 7.6. Procedimento 1. Compile o código Java customizado usando o compilador JDK 1.7. As classes Java customizadas que foram criadas para a implementação do Control Desk 7.5.x provavelmente foram compiladas usando o JDK 1.5, que foi fornecido com o Control Desk 7.5.x. O código Java customizado deve ser recompilado usando o compilador JDK 1.7, fornecido com o Control Desk 7.6 na pasta C:\IBM\SMP\sdk\bin. a. Copie os arquivos de origem Java customizados da estação de trabalho administrativa do Control Desk7.5.x para a estação de trabalho administrativa do Control Desk7.6. b. Compile a origem para os arquivos de classe Java usando o JDK 1.7. c. Mova os arquivos de classe recompilados para o diretório adequado do Control Desk 7.6. Geralmente, este diretório do Control Desk 7.6 é o mesmo diretório encontrado em Control Desk 7.5.x. 2. Identifique as customizações que foram feitas nos arquivos JSP, XML, HTML, CSS ou XSLT padrão do Control Desk 7.5.x. Essas customizações de arquivos padrão devem ser recriadas nas versões do Control Desk 7.6 desses arquivos. Não é possível sobrescrever arquivos do Control Desk 7.6 com versões modificadas de arquivos padrão do Control Desk 7.5.x da estação de trabalho administrativa do Control Desk7.5.x. As customizações devem ser reaplicadas nas versões do Control Desk 7.6 desses arquivos padrão. 3. Copie ou mova todos os arquivos JSP, XML, HTML, CSS ou XSLT customizados que foram criados para funcionar com o Control Desk 7.5.x. 4. Para obter as mudanças feitas nas extensões do Applet, mova o código compilado para as pastas adequadas no diretório de instalação do Control Desk 7.6. Assegure-se de construir os Jars Applet a partir das pastas do Control Desk 7.6. 5. Copie ou mova os arquivos de relatório do Control Desk 7.5.x que foram customizadospara a pasta adequada do Control Desk 7.6. Esses arquivos de relatório precisam ser importados para o banco de dados após a conclusão do processo de upgrade, conforme descrito nas informações de pós-upgrade. 6. Mova os arquivos de configuração customizados (.properties e .xml) que contêm extensões definidas para o Control Desk 7.6. Produza arquivos XML que possam ser localizados na pasta \maximo\applications\maximo\properties\ product. Caso os arquivos de configuração padrão do Control Desk 7.5.x tenham sido customizados, replique essas mudanças nas versões do Control Desk 7.6 desses arquivos. 7. Copie ou mova o arquivo webclient.properties para a pasta \maximo\applications\maximo\properties\product da instalação do Control Desk 7.6. 8. Copie ou mova as bibliotecas de terceiros usadas com a liberação anterior do para a pasta adequada do Control Desk 7.6. Consulte as informações fornecidas com as bibliotecas de terceiros para certificar-se de que não sejam necessárias outras tarefas de configuração. Capítulo 10. Fazendo upgrade por meio da instalação do WebSphere Application Server Network Deployment v8.5.5 em um novo servidor (Cenário 1) 41 Configurando Control Desk versão 7.6 usando o programa de configuração do Control Desk versão 7.6 Este procedimento explica como usar o programa de configuração do Control Desk versão 7.6 para configurar o Control Desk versão 7.6. Antes de Iniciar Antes da configuração, desinstale do Control Desk versão 7.6 todas as soluções para segmentos de mercado e os complementos não suportados. Consulte a página de suporte de Recursos de Upgrade do Maximo para obter mais informações. No site de suporte do Fix Central é possível fazer download de scripts para a desinstalação de soluções para segmentos de mercado e complementos não suportados. Este procedimento faz referência ao DB2 como o banco de dados a ser configurado para o Control Desk versão 7.6. As referências feitas ao DB2 são simples exemplos. As informações necessárias para o Oracle ou o SQL Server são semelhantes. A ajuda é fornecida na interface com o usuário do programa de configuração do Control Desk versão 7.6 e pode ser usada para determinar as informações que devem ser especificadas para o upgrade. Procedimento 1. Se o programa de configuração do Control Desk versão 7.6 não estiver aberto, inicie-o a partir da barra de ativação do Control Desk. Na área de janela de navegação da barra de ativação, clique em Configurar Produto, especifique o local de instalação do Control Desk e clique em Ativar o programa de configuração Process Automation Suite do Tivoli. 2. Na página de operações de configuração do IBM Control Desk, clique em Configurar uma Nova Implementação. 3. No painel Definir Ambiente de Implementação, especifique informações sobre o host do Control Desk versão 7.5.x DB2. Selecione a opção Concluir a configuração do WebSphere para o produto. Após definir seu ambiente de implementação, clique em Concluir. 4. No painel Configurar Informações Gerais do Produto, revise os detalhes do resumo sobre os componentes do produto que está instalando. Especifique a aparência e os recursos de navegação para seu produto, inclua um endereço de email para receber mensagens de fluxo de trabalho e escolha se deseja ou não implementar dados de amostra. 5. No painel Configurar a Instância do DB2, especifique informações sobre a instância do Control Desk versão 7.5.x DB2. 6. No painel Configurar o Banco de Dados DB2, especifique informações sobre o banco de dados do Control Desk versão 7.5.x DB2. 7. No painel Configurar o Servidor de Aplicativos, especifique informações para o servidor WebSphere Application Server Network Deployment que você instalou. Indique se deseja armazenar mensagens JMS originárias do adaptador de integração. 8. No painel Configurar Segurança do Aplicativo, escolha um modelo de segurança para o Control Desk. Se você escolher um modelo de segurança que inclua um servidor de diretório, especifique informações sobre o diretório para o gerenciador de membro virtual. Insira os nomes de usuários e senhas para usuários que devem ser criados para o Control Desk. 9. Escolha o idioma de base e qualquer idioma adicional que você deseja instalar. 42 IBM Control Desk: Guia de Upgrade 10. No painel Aplicar Operações de Implementação, especifique preferências da interface com o usuário, selecione todas as operações de implementação disponíveis e clique em Concluir. Ao selecionar Aplicar as mudanças ao banco de dados, o programa updatedb grava as informações no banco de dados. Resultados Agora, o Control Desk versão 7.6 está instalado e configurado para usar o WebSphere Application Server Network Deployment v8.5.5. As mudanças são gravadas no banco de dados e, se você optar por isso, os arquivos EAR do aplicativo serão implementados no WebSphere Application Server Network Deployment. Informações relacionadas: http://www-01.ibm.com/support/docview.wss?uid=swg21266217 Execução do verificador de integridade do 7.6 Execute o utilitário verificador de integridade do Control Desk 7.6. Sobre Esta Tarefa Antes de prosseguir com o processo de upgrade do Control Desk 7.6, é necessário executar o utilitário Verificador de Integridade do Control Desk 7.6 para confirmar a integridade do banco de dados do Control Desk 7.6 após a conclusão das etapas de upgrade. Quando executado no modo de Relatório, o utilitário verificador de integridade verifica a ocorrência de erros comuns no banco de dados e nos relatórios atuais. Se o Verificador de Integridade relatar um erro, resolva-o executando o Verificador de Integridade no modo de Reparo. Se não for possível usar a interface gráfica com o usuário, também é possível executar um dos seguintes scripts para validação: v Windows: validate_integ.bat v UNIX: validate_integ.sh Procedimento 1. Pare o servidor de aplicativos. Por exemplo, MXServer. 2. Na estação de trabalho administrativa da implementação existente, abra um prompt de comandos e altere o diretório para o diretório de ferramentas do Maximo. Por exemplo, c:\ibm\SMP\maximo\tools\maximo 3. Inicie a ferramenta do Verificador de Integridade. v Nos sistemas operacionais Windows integrityui.bat v Em outros sistemas operacionais suportados integrityui.sh 4. Selecione a guia Verificação de Integridade. 5. Execute o Verificador de Integridade no modo de Relatório. a. Certifique-se de que a caixa de seleção Modo de Reparo? esteja desmarcada e, em seguida, clique em Executar Verificador de Integridade. b. Quando a caixa de diálogo de relatório aparecer, clique em OK. Capítulo 10. Fazendo upgrade por meio da instalação do WebSphere Application Server Network Deployment v8.5.5 em um novo servidor (Cenário 1) 43 Os resultados podem ser encontrados no diretório install_home\maximo\tools\ maximo\log no arquivo definido no campo Nome do Arquivo de Log do painel Verificação da Integridade. 6. Opcional: Se algum erro for relatado, execute o Verificador de Integridade no modo de Reparo. a. Marque a caixa de seleção Modo de Reparo? e, em seguida, clique em Executar Verificador de Integridade. b. Quando a caixa de diálogo de relatório aparecer, clique em OK. 7. Opcional: Se o Verificador de Integridade foi executado no modo de Reparo, verifique o arquivo de log para assegurar-se de que todos os itens relatados foram reparados. Se for necessário fazer outras intervenções manuais, resolva os erros e, em seguida, execute novamente o Verificador de Integridade no modo de Relatório. Repita o processo até que não haja mais erros. Resultados Embora o Verificador de Integridade possa reparar muitos erros, talvez seja necessário resolver alguns erros manualmente, consultando os arquivos de log. 44 IBM Control Desk: Guia de Upgrade Capítulo 11. Fazendo upgrade por meio da migração das informações do WebSphere Application Server para o WebSphere Application Server v8.5.5 (Cenário 2) A lista de verificação a seguir é um roteiro de alto nível das tarefas que devem ser executadas para fazer a migração das informações de configuração da instalação existente do WebSphere Application Server Network Deployment v7.x para uma nova instalação do WebSphere Application Server Network Deployment v8.5.5. Antes de iniciar, certifique-se de revisar as seguintes informações: v “Roteiros do cenário de upgrade” na página 15 Essas informações fornecem uma visão geral resumida ou um roteiro de tarefas que devem ser executadas para fazer o upgrade para o IBM Control Desk versão 7.6 por meio da migração da configuração do WebSphere Application Server Network Deployment v7.x usado com o IBM Control Desk versão 7.5.x para WebSphere Application Server Network Deployment v8.5.5. Neste cenário, use o assistente de migração do WebSphere Application Server Network Deployment v8.5.5 para transferir as informações de configuração existentes do IBM Control Desk versão 7.5.x do WebSphere Application Server Network Deployment v7.x para o WebSphere Application Server Network Deployment v8.5.5. Esse cenário aplica-se apenas às implementações que usam o WebSphere Application Server Network Deployment hospedado em sistemas Linux. O benefício da utilização desse cenário de upgrade é que não é necessário configurar o WebSphere Application Server Network Deployment v8.5.5. É possível reutilizar a configuração executada para o WebSphere Application Server Network Deployment v7.x. Lista de verificação para a migração dos dados de configuração do WebSphere Application Server Network Deployment Use esta lista de verificação como uma diretriz ao fazer upgrade para a versão 7.6 por meio da migração dos dados de configuração do WebSphere Application Server Network Deployment. Tabela 3. Lista de verificação para a migração dos dados de configuração do WebSphere Application Server Network Deployment Etapa 1 Ação Description Revise e execute os pré-requisitos de upgrade. Revise e execute os pré-requisitos de upgrade descritos em Capítulo 9, “Tarefas de pré-upgrade”, na página 29. © Copyright IBM Corp. 1994, 2015 45 Tabela 3. Lista de verificação para a migração dos dados de configuração do WebSphere Application Server Network Deployment (continuação) Etapa 2 Ação Description Execute o Verificador de Integridade no modo de Relatório no ambiente existente. Para obter instruções detalhadas, consulte “Execução do verificador de integridade do 7.5.x” na página 34. Para obter informações sobre as mensagens de erro, consulte a documentação a seguir: v “Mensagens informativas do verificador de integridade” na página 91 v “Mensagens de aviso do verificador de integridade” na página 91 v “Mensagens de erro do verificador de integridade” na página 94 3 Certifique-se de que tenha o sistema operacional apropriado. Para obter uma lista de sistemas operacionais suportados, consulte a página Requisitos do Sistema na wiki IBM Control Desk. 4 Estabeleça o middleware suportado. Nesse cenário, use o programa de instalação do Control Desk versão 7.6 para instalar o WebSphere Application Server Network Deployment v8.5.5 e migrar as informações de configuração. A intenção é migrar as informações de perfil existentes do WebSphere Application Server Network Deployment v7.x criadas para o Control Desk versão 7.5 para o WebSphere Application Server Network Deployment v8.5.5. Revise as informações sobre como estabelecer um middleware suportado em “Estabeleça um middleware suportado” na página 35. Execute as tarefas a seguir para estabelecer um middleware suportado: v Se necessário, faça upgrade do software de banco de dados para uma versão suportada, usando o programa de instalação desse software. Antes de fazer upgrade do software de banco de dados, verifique a Matriz de Configuração do Produto para determinar se o software é suportado por esta liberação. A Matriz de Configuração do Produto está disponível aqui. v Se necessário, faça upgrade do software do servidor de diretório para uma versão suportada, usando o programa de instalação desse software. Consulte a documentação fornecida com o produto para obter informações sobre upgrade. v Use o programa de instalação para instalar o WebSphere Application Server Network Deployment v8.5.5, conforme descrito em “Instalando o WebSphere Application Server Network Deployment v8.5.5 usando o programa de instalação do Control Desk versão 7.6” na página 36. v Após a conclusão da instalação, use o programa de configuração do Control Desk versão 7.6 para preparar o WebSphere Application Server Network Deployment v8.5.5 para o Control Desk 46 IBM Control Desk: Guia de Upgrade Tabela 3. Lista de verificação para a migração dos dados de configuração do WebSphere Application Server Network Deployment (continuação) Etapa Ação Description 5 Opcional: Se necessário, migre os dados do banco de dados ou do servidor de diretórios. Para obter mais informações, consulte o “Migre os dados do banco de dados ou do servidor de diretórios (opcional)” na página 38. 6 Execute o programa de instalação do Execute o programa de instalação do Control Desk versão Control Desk 7.6 para instalar o Control Desk na estação de trabalho administrativaPara fazer o upgrade, execute as etapas descritas em “Executando o programa de instalação do Control Desk 7.6” na página 39. 7 Migre as customizações da implementação anterior. Migre as customizações feitas na estação de trabalho administrativa do Control Desk versão 7.6. A migração deve ser executada para todos os produtos instalados na estação de trabalho. Para obter mais informações, consulte o “Migração de customizações” na página 41. 8 Execute o programa de configuração do Control Desk Execute o programa de configuração do Control Desk versão 7.6. As mudanças são gravadas no banco de dados e, se você optar por isso, os arquivos EAR do aplicativo serão implementados no WebSphere Application Server Network Deployment. Para obter mais informações, consulte o “Configurando Control Desk versão 7.6 usando o programa de configuração do Control Desk versão 7.6” na página 42. 9 Execute o Verificador de Integridade do Control Desk 7.6. Execute a ferramenta Verificador de Integridade no modo de Relatório. Se o Verificador de Integridade relatar um erro, resolva-o. Para obter instruções detalhadas, consulte “Execução do verificador de integridade do 7.6” na página 43. Para obter informações sobre as mensagens de erro, consulte a documentação a seguir: v “Mensagens informativas do verificador de integridade” na página 91 v “Mensagens de aviso do verificador de integridade” na página 91 v “Mensagens de erro do verificador de integridade” na página 94 10 Execute as tarefas de pós-upgrade. Revise informações importantes sobre tarefas de pós-upgrade em Capítulo 15, “Tarefas pós-upgrade”, na página 81. São fornecidas uma lista de verificação e instruções detalhadas para a conclusão das tarefas de pós-upgrade. Execução do verificador de integridade do 7.5.x Execute o utilitário verificador de integridade do Control Desk versão 7.5.x. Capítulo 11. Fazendo upgrade por meio da migração das informações do WebSphere Application Server para o WebSphere Application Server v8.5.5 (Cenário 2) 47 Sobre Esta Tarefa Antes de prosseguir com o processo de upgrade do Control Desk versão 7.6, execute o utilitário Verificador de Integridade do Control Desk versão 7.5.x. Esse utilitário é usado com o banco de dados do Control Desk versão 7.5.x para assegurar que ele esteja pronto para o upgrade. Quando executado no modo de Relatório, o utilitário verificador de integridade verifica a ocorrência de erros comuns no banco de dados e nos relatórios atuais. Se o Verificador de Integridade relatar um erro, resolva-o executando o Verificador de Integridade no modo de Reparo. Procedimento 1. Na estação de trabalho administrativa do Control Desk versão 7.5.x, abra um prompt de comandos e altere o diretório para o diretório de ferramentas. Por exemplo, install_home\maximo\tools\maximo 2. Inicie a ferramenta do Verificador de Integridade. v Nos sistemas operacionais Windows integrityui.bat v Em outros sistemas operacionais suportados integrityui.sh 3. Selecione a guia Verificação de Integridade. 4. Execute o Verificador de Integridade no modo de Relatório. a. Certifique-se de que a caixa de seleção Modo de Reparo? esteja desmarcada e, em seguida, clique em Executar Verificador de Integridade. b. Quando a caixa de diálogo de relatório aparecer, clique em OK. Os resultados podem ser encontrados no diretório install_home\maximo\tools\ maximo\log no arquivo definido no campo Nome do Arquivo de Log do painel Verificação da Integridade. 5. Opcional: Se algum erro for relatado, execute o Verificador de Integridade no modo de Reparo. a. Marque a caixa de seleção Modo de Reparo? e, em seguida, clique em Executar Verificador de Integridade. b. Quando a caixa de diálogo de relatório aparecer, clique em OK. 6. Opcional: Se o Verificador de Integridade foi executado no modo de Reparo, verifique o arquivo de log para assegurar-se de que todos os itens relatados foram reparados. Se for necessário fazer outras intervenções manuais, resolva os erros e, em seguida, execute novamente o Verificador de Integridade no modo de Relatório. Repita o processo até que não haja mais erros. Resultados Embora o Verificador de Integridade possa reparar muitos erros, talvez seja necessário resolver alguns erros manualmente, consultando os arquivos de log. Estabeleça um middleware suportado Estabeleça no ambiente um middleware que seja compatível com o Control Desk versão 7.6. A primeira etapa em um upgrade do Control Desk versão 7.6 é estabelecer no ambiente um middleware que seja suportado pelo Control Desk versão 7.6. Em alguns casos, o middleware usado na implementação do Control Desk versão 7.5.x, 48 IBM Control Desk: Guia de Upgrade por exemplo, o software de banco de dados ou de servidor de diretórios, pode ser reutilizado para o upgrade do Control Desk versão 7.6. Em outros casos, talvez seja necessário usar novos servidores de middleware, que não faziam parte da implementação original do Control Desk versão 7.5.x. O programa de instalação do Control Desk versão 7.6 é usado para instalar o WebSphere Application Server Network Deployment v8.5.5. As ferramentas de migração do WebSphere Application Server Network Deployment v8.5.5 são usadas para migrar as informações do perfil do WebSphere Application Server Network Deployment. Se necessário, faça upgrade do software de banco de dados para uma versão suportada pelo Control Desk versão 7.6. O upgrade do software de banco de dados existente usado com o Control Desk versão 7.5.x é o método preferencial para o estabelecimento de um banco de dados suportado pelo Control Desk versão 7.6. Este método permite a reutilização de elementos existentes da implementação do Control Desk versão 7.5.x, como o ID do usuário e instâncias de banco de dados. Em alguns casos, você pode ser forçado a instalar uma nova instância do software de banco de dados. Por exemplo, a implementação do Control Desk versão 7.5.x pode incluir um servidor de banco de dados estabelecido em uma plataforma que não é mais suportada no Control Desk versão 7.6, como pode ser o caso com plataformas de 32 bits. Nesse cenário, deve-se instalar uma nova instância do software de banco de dados que seja compatível com o Control Desk versão 7.6. Para o DB2, é possível instalar esse software usando o programa de instalação do Control Desk versão 7.6. Se você instalar novas instâncias de software de banco de dados fora do programa de instalação do Control Desk versão 7.6, será necessário executar tarefas adicionais de configuração manual, descritas nas informações de instalação do Control Desk 7.6. Além disso, será necessário migrar o banco de dados do servidor antigo para o novo servidor. Se necessário, faça upgrade do software do servidor de diretório para uma versão suportada pelo Control Desk versão 7.6. Consulte a documentação fornecida com o produto para obter informações sobre upgrade. Instalando o WebSphere Application Server Network Deployment v8.5.5 usando o programa de instalação do Control Desk versão 7.6 Este procedimento explica como usar o programa de instalação do Control Desk versão 7.6 para instalar o WebSphere Application Server Network Deployment v8.5.5. Sobre Esta Tarefa Estas instruções são para a instalação do WebSphere Application Server Network Deployment v8.5.5 em um único sistema, usando o programa de instalação do Control Desk versão 7.6. Para instalar o WebSphere Application Server Network Deployment v8.5.5 para IBM Control Desk versão 7.6 usando o programa de instalação do IBM Control Desk versão 7.6, siga estas etapas. Procedimento 1. Efetue login no sistema de destino como um usuário com autoridade administrativa. Se estiver executando o programa de instalação do IBM Capítulo 11. Fazendo upgrade por meio da migração das informações do WebSphere Application Server para o WebSphere Application Server v8.5.5 (Cenário 2) 49 Control Desk versão 7.6 a partir de um Linux ou janela do terminal do UNIX, você deverá efetuar login como usuário raiz. 2. Ative o programa de instalação do IBM Control Desk versão 7.6 a partir da barra de ativação. a. Inicie o painel de ativação. Windows Na imagem de instalação transferida por download, navegue para o diretório-raiz e execute o seguinte comando: launchpad64.exe. Linux e UNIX A partir da imagem de instalação transferida por download, navegue para o diretório raiz e execute o seguinte comando: launchpad64.sh. b. Selecione um idioma para a instalação e clique em OK. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 50 c. Na área de janela de navegação da barra de ativação, clique em Instalar Produto. d. No painel Instalar Produto, selecione IBM WebSphere Application Server Network Deployment v8.5.5 e, em seguida, clique em Instalar IBM Control Desk componentes. No painel de seleção de pacote, clique em Avançar. No painel de validação de pré-requisito de pacote, revise os resultados da verificação de pré-requisito e clique em Avançar. Se algum erro for relatado neste painel, resolva o problema e clique em Verificar Status Novamente antes de continuar. No painel de contrato de licença, revise as informações de licença para cada pacote que está sendo instalado, selecione Aceito os termos nos contratos de licença se você concordar com os termos e, em seguida, clique em Avançar. No painel do local de instalação do Installation Manager, especifique informações de caminho para o diretório de recursos compartilhados e o diretório de instalação do Installation Manager e clique em Avançar. O Installation Manager é uma estrutura de instalação que é usada para instalar a versão Control Desk dos componentes do 7.6. O diretório de recursos compartilhados é um diretório da área de trabalho comum usado pelo Installation Manager ao instalar pacotes. No painel do local de instalação do pacote, selecione um grupo de pacotes, especifique informações de caminho para seu diretório de instalação e, em seguida, clique em Avançar. Repita este processo para cada grupo de pacotes listado. No painel de traduções do pacote, especifique o suporte ao idioma para WebSphere Application Server Network Deployment e clique em Avançar. No painel de recursos do pacote, deixe todas as opções padrão marcadas e clique em Avançar. No painel de configuração do pacote, especifique as informações de configuração para IBM HTTP Server e clique em Avançar. No painel de resumo de pacote, revise as informações para a instalação planejada e clique em Instalar. Após a conclusão da instalação, clique em Concluir. IBM Control Desk: Guia de Upgrade Migração de informações de configuração do IBM WebSphere Application Server Network Deployment Use o assistente de migração do IBM WebSphere Application Server Network Deployment v8.5.5 para migrar perfis do IBM WebSphere Application Server Network Deployment v7.x para o IBM WebSphere Application Server Network Deployment v8.5.5. Sobre Esta Tarefa É possível transferir as informações de perfil existentes usadas com o Control Desk versão 7.5.x, em vez de criar novos perfis para o Control Desk versão 7.6. Você deve ter instalado o IBM WebSphere Application Server Network Deployment v8.5.5 no mesmo sistema que o servidor do IBM WebSphere Application Server Network Deployment v7.x que era usado para o Control Desk versão 7.5.x. Nota: A migração de perfis usados com o Control Desk versão 7.5.x desativa a implementação do Control Desk versão 7.5.x. Após a migração, não é possível acessar ou usar o Control Desk versão 7.5.x. Não migre as informações de perfil conforme descrito aqui a menos que não seja mais necessário acessar o Control Desk versão 7.5.x. Para obter informações adicionais sobre o processo de migração do IBM WebSphere Application Server Network Deployment, consulte os seguintes recursos: v Coleção de Conhecimentos: Migrando para (ou de) WebSphere Application Server V7.0 v Migrando perfis usando o assistente de migração na documentação do IBM WebSphere Application Server Network Deployment em IBM Knowledge Center Procedimento 1. Crie um novo perfil do Deployment Manager (Dmgr). Por exemplo, ctgDmgr02. a. Efetue logon no sistema que hospeda o WebSphere Application Server v8.5.5. b. Inicie a ferramenta de gerenciamento de perfil do WebSphere Application Server. Windows Iniciar > IBM WebSphere > IBM WebSphere Application Server 8.5 > Ferramentas > Ferramenta de Gerenciamento de Perfil (ou execute pmt.bat de uma linha de comandos) Unix ou Linux WAS_HOME/bin/ProfileManagement/pmt.sh c. Clique em Criar, selecione Perfil Customizado e, em seguida, clique em Avançar. d. Selecione Criação de perfil avançado e clique em Avançar. e. Insira um valor para o novo perfil, por exemplo, ctgDmgr02 e, em seguida, clique em Avançar. O nome do novo perfil do Deployment Manager não deve ser o mesmo nome do perfil do WebSphere Application Server v7.0. f. Verifique o nome do host e, em seguida, insira um valor para o novo nó, por exemplo, ctgNode02. Clique em Avançar. O nome do novo nó não deve ser igual ao do nó do WebSphere Application Server v7.0. Capítulo 11. Fazendo upgrade por meio da migração das informações do WebSphere Application Server para o WebSphere Application Server v8.5.5 (Cenário 2) 51 g. Selecione a opção para Federar este nó posteriormente e, em seguida, clique em Avançar. h. Aceite os valores padrão para os certificados de segurança e clique em Avançar. i. Insira e confirme a senha do keystore padrão e, em seguida, clique em Avançar. j. Na tela de resumo, clique em Criar. k. Cancele a seleção da opção Ativar do console do First Steps e feche a ferramenta de gerenciamento de perfil e o WebSphere Customization Toolbox 8.5. 2. Pare os serviços do WebSphere Application Server v7.x, se estiverem em execução. a. Efetue logon no sistema que está hospedando o WebSphere Application Server v7.x. Pare o IBM HTTP Server e a Administração IBM HTTP. Pare o gerenciador de implementação do WebSphere Application Server. Pare o nó. Pare todos os servidores de aplicativos do Control Desk. Por exemplo, MXServer. 3. Migre o perfil de gerenciador de implementação. a. Efetue logon no sistema que hospeda o WebSphere Application Server v8.5.5. b. c. d. e. b. Inicie o Assistente de Migração do WebSphere Application Server. Windows Iniciar > IBM WebSphere > IBM WebSphere Application Server v8.5 > Ferramentas > Ferramenta de Migração de Configuração (ou execute o utilitário de uma linha de comandos) Unix ou Linux app_server_root/bin/migration.sh c. Defina uma origem de migração. No painel Origens de Migração, clique em Novo. d. Selecione as instalações a serem migradas. Especifique a instalação do WebSphere Application Server v7.x. Clique em Avançar. e. Selecione ctgDmgr01 como o perfil de origem. Escolha a opção para criar um backup do perfil. Clique em Avançar. f. Opcional: Se a segurança administrativa estiver ativada para o perfil, insira o ID e a senha do usuário administrativo do WebSphere Application Server. Clique em Avançar. g. Mantenha selecionada a opção para desativar o gerenciador de implementação de origem e clique em Avançar. h. Especifique o local para o resultado da migração e os arquivos de log. Clique em Avançar. Ao aceitar os padrões, observe que o novo WebSphere Application Server v8.5.5 Deployment Manager terá o mesmo nome que o WebSphere Application Server v7.0 Deployment Manager. O novo perfil do Deployment Manager, criado anteriormente, é necessário para a execução da ferramenta de migração, mas não é usado no produto final. i. Mantenha a seleção de Migrar para um Novo Perfil e clique em Avançar. É possível migrar para um perfil existente, mas ele deve ter sido criado anteriormente. Lembre-se de que quando o perfil ctgDmgr02 foi criado, ele não foi federado (pareado com um Application Server). 52 IBM Control Desk: Guia de Upgrade j. Verifique o host, nomeie o perfil como ctgDmgr01 e, em seguida, clique em Avançar. k. Mantenha selecionadas as opções padrão para as informações de instalação do aplicativo. Clique em Avançar. l. Mantenha selecionadas as opções padrão para as informações de valor de porta. Clique em Avançar. m. Mantenha selecionadas as opções padrão para as informações de migração adicionais. Clique em Avançar. n. Revise os dados de resumo da migração. Clique em Migrar. O processo de migração é composto por 2 a 6 sub-processos, dependendo das opções feitas nas etapas anteriores. Caso o processo exija entradas do usuário, você será automaticamente enviado para a guia adequada. o. Revise a página de resultados. Para retornar para a lista de origens de migração, clique em Concluir. 4. Migre o perfil do servidor de aplicativos. a. Inicie o gerenciador de implementação. O novo gerenciador de implementação está localizado em WAS_HOME\AppServer\profiles\ ctgDmgr01\bin. b. Inicie o Assistente de Migração do WebSphere Application Server. Windows Iniciar > IBM WebSphere > IBM WebSphere Application Server v8.5 > Ferramentas > Ferramenta de Migração de Configuração (ou execute o utilitário de uma linha de comandos) Unix ou Linux app_server_root/bin/migration.sh c. Na guia Origens de Migração, clique em Novo. d. Na página Versões Detectadas do WebSphere Application Server, selecione ou especifique o local da instalação existente e clique em Avançar. e. Na página Perfil de Origem, especifique ctgAppSrv01, selecione a caixa de seleção para fazer o backup do perfil de origem e especifique um diretório de backup. Em seguida, clique em Avançar. f. Insira o nome (wasadmin) e a senha do usuário administrativo do WebSphere Application Server e, em seguida, clique em Testar Conexão com o Deployment Manager. Clique em Avançar. g. Na página Saída de Migração de Perfil, clique em Avançar. h. Na página Perfil de Destino, clique em Avançar. i. Na página Parâmetros de Criação de Perfil, insira ctgAppSrv01 como o nome do perfil e, então, clique em Avançar. j. Insira as informações de valor de porta e, em seguida, clique em Avançar. Caso planeje desativar o WebSphere Application Server v7.0, use os valores de porta designados para o perfil de origem. k. Revise os dados de resumo da migração. Clique em Migrar. O processo de migração é composto por 2 a 6 sub-processos, dependendo das opções feitas nas etapas anteriores. Caso o processo exija entradas do usuário, você será automaticamente enviado para a guia adequada. l. Revise a página de resultados. Para retornar para a lista de origens de migração, clique em Concluir. Capítulo 11. Fazendo upgrade por meio da migração das informações do WebSphere Application Server para o WebSphere Application Server v8.5.5 (Cenário 2) 53 5. Depois de migrar do WebSphere Application Server para a versão 8.5.5, faça o upgrade do IBM HTTP Server. Para obter mais informações, consulte Migrando de uma versão anterior do IBM HTTP Server na documentação do WebSphere Application Server. O que Fazer Depois Depois de migrar e configurar o WebSphere Application Server, migre a configuração do IBM HTTP Server. Embora o IBM HTTP Server antigo e as novas versões possam coexistir no mesmo servidor, recomenda-se que migre para a nova versão e desinstale a versão mais antiga. Migrando dados do banco de dados ou do servidor de diretórios (opcional) Dependendo do ambiente, pode ser necessário migrar os dados do banco de dados ou do servidor de diretórios dos servidores de middleware do Control Desk 7.5.x para os servidores de middleware do Control Desk 7.6. Nos casos em que o middleware utilizado para implementar o Control Desk 7.5.x for incompatível com o Control Desk 7.6, é possível migrar as informações do Control Desk 7.5.x para um servidor suportado pelo Control Desk 7.6. Ao fazer um upgrade, não é possível fazer o upgrade do middleware do IBM DB2 a partir da barra de ativação. Você deve fazer o upgrade do middleware do banco de dados separadamente. Para obter informações sobre o upgrade do IBM DB2, consulte o Portal de Upgrade do DB2. As informações também estão disponíveis na documentação do IBM DB2 no IBM Knowledge Center. Se o software de banco de dados do Control Desk 7.5.x for compatível com o Control Desk 7.6, é possível usar o banco de dados existente. Se o banco de dados existente não for compatível, consulte a documentação fornecida com o software para obter instruções sobre como migrar objetos de bancos de dados. Para o DB2, essas informações podem ser localizadas em na Documentação do IBM DB2 no IBM Knowledge Center. Lembre-se de que, caso o software de banco de dados tenha sido atualizado, é necessário migrar apenas a instância de banco de dados (ctginst1) e o banco de dados (maxdb75) do Control Desk 7.5.x. Se você instalou uma nova instância do software de banco de dados, execute as tarefas de configuração adicionais, conforme descrito nas informações de instalação do Control Desk 7.6. Se você optou por usar um servidor de diretório para a segurança na implementação do Control Desk 7.5.x e tiver que migrar informações do servidor de diretórios para cumprir os pré-requisitos do Control Desk 7.6, consulte a documentação fornecida com o software para obter instruções sobre migração. Se tiver usado o IBM Security Directory Server para a implementação do Control Desk 7.5.x, nenhuma migração é necessária, porque a mesma versão do IBM Security Directory Server é suportada em ambos os produtos. Executando o programa de instalação do Control Desk 7.6 Esse procedimento explica como usar o programa de instalação doControl Desk versão 7.6 para instalar o Control Desk versão 7.6. 54 IBM Control Desk: Guia de Upgrade Sobre Esta Tarefa O programa de instalação do Control Desk versão 7.6 é executado no sistema que for designado como a estação de trabalho administrativa do Control Desk versão 7.6. O upgrade não deve ser executado a partir da estação de trabalho administrativa do Control Desk versão 7.5.x. As plataformas suportadas para estações de trabalho administrativas do Control Desk versão 7.5.x, por exemplo, Windows 2008, não são suportadas no Control Desk versão 7.6. O processo de upgrade envolve a execução de uma nova instalação do Control Desk versão 7.6 e sua posterior configuração para a utilização do banco de dados do Control Desk versão 7.5.x. Procedimento 1. Efetue login no sistema que for designado como a estação de trabalho administrativa do Control Desk versão 7.6. Se você executar o programa de instalação do IBM Control Desk versão 7.6 a partir de uma janela do terminal do Linux ou do UNIX, deverá estar com login efetuado como o usuário raiz. 2. Ative o programa de instalação do IBM Control Desk versão 7.6 a partir da barra de ativação. a. Inicie o painel de ativação. Windows Na imagem de instalação transferida por download, navegue para o diretório-raiz e execute o seguinte comando: launchpad64.exe. Linux e UNIX A partir da imagem de instalação transferida por download, navegue até o diretório-raiz e execute o seguinte comando: launchpad.sh. b. Selecione um idioma para a instalação e clique em OK. c. Na área de janela de navegação da barra de ativação, clique em Instalar Produto. d. No painel Instalar Produto, selecione IBM Control Desk v7.6 e, em seguida, clique em Instalar componentes do IBM Control Desk. 3. No painel de seleção de pacote, clique em Avançar. Não desmarque a caixa de seleção para IBM Maximo for Service Providers. Fornece recursos que são usados no IBM Control Desk. 4. No painel de validação de pré-requisito de pacote, revise os resultados da verificação de pré-requisito e clique em Avançar. Se algum erro for relatado neste painel, resolva o problema e clique em Verificar Status Novamente antes de continuar. 5. No painel de contrato de licença, revise as informações de licença para cada pacote que está sendo instalado, selecione Aceito os termos nos contratos de licença se você concordar com os termos e, em seguida, clique em Avançar. 6. No painel de localização, para especificar as informações de caminho para o diretório de instalação do IBM Control Desk, selecione uma das seguintes opções e, em seguida, clique em Avançar. Capítulo 11. Fazendo upgrade por meio da migração das informações do WebSphere Application Server para o WebSphere Application Server v8.5.5 (Cenário 2) 55 Opção Descrição Se a instalação estiver sendo executada em uma estação de trabalho administrativa com uma instalação anterior 1. Selecione Criar um novo grupo de pacotes. Se a instalação estiver sendo executada em uma nova estação de trabalho administrativa sem instalação anterior 1. Selecione Criar um novo grupo de pacotes. 2. No campo Diretório de Instalação, certifique-se de especificar um nome de diretório que seja diferente do diretório de instalação anterior. 2. No campo Diretório de Instalação, especifique um nome de diretório para o diretório de instalação. 7. No painel de local de instalação do pacote, use os valores padrão ou especifique um novo diretório para o diretório de Recursos Compartilhados e para o diretório do Installation Manager. Em seguida, clique em Avançar. O Installation Manager é uma estrutura de instalação que é usada para instalar a versão Control Desk dos componentes do 7.6. O diretório de recursos compartilhados é um diretório da área de trabalho comum usado pelo Installation Manager ao instalar pacotes. Se o Installation Manager já estiver instalado, a opção para selecionar um caminho de instalação para o Installation Manager não será exibida. 8. No painel de recursos do pacote, deixe todas as opções padrão marcadas e clique em Avançar. 9. No painel de resumo de pacote, revise as informações para a instalação planejada e clique em Instalar. 10. Após a conclusão da instalação, se não houver soluções para segmentos de mercado e complementos para serem instalados, é possível selecionar a opção para iniciar o programa de configuração do Control Desk versão 7.6 e, em seguida, clicar em Concluir. O programa de instalação do Control Desk versão 7.6 sai e o programa de configuração do Control Desk versão 7.6 é iniciado automaticamente. Se for necessário instalar soluções para segmentos de mercado e complementos, saia do programa de configuração do Control Desk versão 7.6 e instale esses itens antes de continuar. O que Fazer Depois As soluções para segmentos de mercado e os complementos da versão 7.5 devem ser instalados nesse momento. As soluções para segmentos de mercado e os complementos da versão 7.5 podem ser instalados no Control Desk 7.6 a partir da linha de comandos. A instalação silenciosa também é suportada. Assegure-se de fazer o download da versão e de correções mais recentes disponíveis para a solução para segmentos do mercado ou do complemento antes de instalá-la. Consulte a Matriz de Requisitos de Upgrade do Maximo para obter as informações mais recentes sobre os requisitos para soluções para segmentos de mercado e complementos. Após a instalação, use o programa de configuração do Control Desk versão 7.6 para configurar o Control Desk versão 7.6. Migração de customizações Migre as customizações feitas na implementação do Control Desk 7.5.x. 56 IBM Control Desk: Guia de Upgrade Procedimento 1. Compile o código Java customizado usando o compilador JDK 1.7. As classes Java customizadas que foram criadas para a implementação do Control Desk 7.5.x provavelmente foram compiladas usando o JDK 1.5, que foi fornecido com o Control Desk 7.5.x. O código Java customizado deve ser recompilado usando o compilador JDK 1.7, fornecido com o Control Desk 7.6 na pasta C:\IBM\SMP\sdk\bin. a. Copie os arquivos de origem Java customizados da estação de trabalho administrativa do Control Desk7.5.x para a estação de trabalho administrativa do Control Desk7.6. b. Compile a fonte para os arquivos de classe Java usando o JDK 1.7. c. Mova os arquivos de classe recompilados para o diretório adequado do Control Desk 7.6. Geralmente, este diretório do Control Desk 7.6 é o mesmo diretório encontrado em Control Desk 7.5.x. 2. Identifique as customizações que foram feitas nos arquivos JSP, XML, HTML, CSS ou XSLT padrão do Control Desk 7.5.x. Essas customizações de arquivos padrão devem ser recriadas nas versões do Control Desk 7.6 desses arquivos. Não é possível sobrescrever os arquivos do Control Desk 7.6 com versões modificadas dos arquivos padrão do Control Desk 7.5.x existentes no diretório pre_75_maximo. As customizações devem ser reaplicadas nas versões do Control Desk 7.6 desses arquivos padrão. 3. Copie ou mova todos os arquivos JSP, XML, HTML, CSS ou XSLT customizados que foram criados para funcionar com o Control Desk 7.5.x. 4. Para obter as mudanças feitas nas extensões do Applet, mova o código compilado para as pastas adequadas no diretório de instalação do Control Desk 7.6. Assegure-se de construir os Jars Applet a partir das pastas do Control Desk 7.6. 5. Copie ou mova os arquivos de relatório do Control Desk 7.5.x que foram customizadospara a pasta adequada do Control Desk 7.6. Esses arquivos de relatório precisam ser importados para o banco de dados após a conclusão do processo de upgrade, conforme descrito nas informações de pós-upgrade. 6. Mova os arquivos de configuração customizados (.properties e .xml) que contêm extensões definidas para o Control Desk 7.6. Produza arquivos XML que possam ser localizados na pasta \maximo\applications\maximo\properties\ product. Caso os arquivos de configuração padrão do Control Desk 7.5.x tenham sido customizados, replique essas mudanças nas versões do Control Desk 7.6 desses arquivos. 7. Copie ou mova o arquivo webclient.properties para a pasta \maximo\applications\maximo\properties\product da instalação do Control Desk 7.6. 8. Copie ou mova as bibliotecas de terceiros usadas com a liberação anterior do para a pasta adequada do Control Desk 7.6. Consulte as informações fornecidas com as bibliotecas de terceiros para certificar-se de que não sejam necessárias outras tarefas de configuração. Configurando Control Desk versão 7.6 usando o programa de configuração do Control Desk versão 7.6 Este procedimento explica como usar o programa de configuração do Control Desk versão 7.6 para configurar o Control Desk versão 7.6. Capítulo 11. Fazendo upgrade por meio da migração das informações do WebSphere Application Server para o WebSphere Application Server v8.5.5 (Cenário 2) 57 Antes de Iniciar Antes da configuração, desinstale do Control Desk versão 7.6 todas as soluções para segmentos de mercado e os complementos não suportados. Consulte a página de suporte de Recursos de Upgrade do Maximo para obter mais informações. No site de suporte do Fix Central é possível fazer download de scripts para a desinstalação de soluções para segmentos de mercado e complementos não suportados. Este procedimento faz referência ao DB2 como o banco de dados a ser configurado para o Control Desk versão 7.6. As referências feitas ao DB2 são simples exemplos. As informações necessárias para o Oracle ou o SQL Server são semelhantes. A ajuda é fornecida na interface com o usuário do programa de configuração do Control Desk versão 7.6 e pode ser usada para determinar as informações que devem ser especificadas para o upgrade. Procedimento 1. Se o programa de configuração do Control Desk versão 7.6 não estiver aberto, inicie-o a partir da barra de ativação do Control Desk. Na área de janela de navegação da barra de ativação, clique em Configurar Produto, especifique o local de instalação do Control Desk e clique em Ativar o programa de configuração Process Automation Suite do Tivoli. 2. Na página de operações de configuração do IBM Control Desk, clique em Configurar uma Nova Implementação. 3. No painel Definir Ambiente de Implementação, especifique informações sobre o host do Control Desk versão 7.5.x DB2. Selecione o WebSphere como o tipo de servidor de aplicativos e, em seguida, selecione a opção Concluir a configuração do WebSphere para o produto. Após definir seu ambiente de implementação, clique em Concluir. 4. No painel Configurar Informações Gerais do Produto, revise os detalhes do resumo sobre os componentes do produto que está instalando. Especifique a aparência e os recursos de navegação para seu produto, inclua um endereço de email para receber mensagens de fluxo de trabalho e escolha se deseja ou não implementar dados de amostra. 5. No painel Configurar a Instância do DB2, especifique informações sobre a instância do Control Desk versão 7.5.x DB2. 6. No painel Configurar o Banco de Dados DB2, especifique informações sobre o banco de dados do Control Desk versão 7.5.x DB2. 7. No painel Configurar o Servidor de Aplicativos, especifique informações sobre a conexão e o servidor de aplicativos para o servidor do WebSphere Application Server Network Deployment que foi instalado. 8. No painel Configurar Segurança do Aplicativo, escolha um modelo de segurança para o Control Desk. Se você escolher um modelo de segurança que inclua um servidor de diretório, especifique informações sobre o diretório para o gerenciador de membro virtual. Insira os nomes de usuários e senhas para usuários que devem ser criados para o Control Desk. 9. Escolha o idioma de base e qualquer idioma adicional que você deseja instalar. 10. No painel Aplicar Operações de Implementação, especifique preferências da interface com o usuário, selecione todas as operações de implementação disponíveis e clique em Concluir. Ao selecionar Aplicar as mudanças ao banco de dados, o programa updatedb grava as informações no banco de dados. 58 IBM Control Desk: Guia de Upgrade Resultados Agora, o Control Desk versão 7.6 está instalado e configurado para usar o WebSphere Application Server Network Deployment v8.5.5. As mudanças são gravadas no banco de dados e, se você optar por isso, os arquivos EAR do aplicativo serão implementados no WebSphere Application Server Network Deployment. Informações relacionadas: http://www-01.ibm.com/support/docview.wss?uid=swg21266217 Execução do verificador de integridade do 7.6 Execute o utilitário verificador de integridade do Control Desk versão 7.6. Sobre Esta Tarefa Antes de prosseguir com o processo de upgrade do Control Desk versão 7.6, é necessário executar o utilitário Verificador de Integridade do Control Desk versão 7.6 para confirmar a integridade do banco de dados do Control Desk versão 7.6 após a conclusão das etapas de upgrade. Quando executado no modo de Relatório, o utilitário verificador de integridade verifica a ocorrência de erros comuns no banco de dados e nos relatórios atuais. Se o Verificador de Integridade relatar um erro, resolva-o executando o Verificador de Integridade no modo de Reparo. Procedimento 1. Pare o servidor de aplicativos. Por exemplo, MXServer. 2. Na estação de trabalho administrativa da implementação existente, abra um prompt de comandos e altere o diretório para o diretório de ferramentas do Maximo. Por exemplo, c:\ibm\SMP\maximo\tools\maximo 3. Inicie a ferramenta do Verificador de Integridade. v Nos sistemas operacionais Windows integrityui.bat v Em outros sistemas operacionais suportados integrityui.sh 4. Selecione a guia Verificação de Integridade. 5. Execute o Verificador de Integridade no modo de Relatório. a. Certifique-se de que a caixa de seleção Modo de Reparo? esteja desmarcada e, em seguida, clique em Executar Verificador de Integridade. b. Quando a caixa de diálogo de relatório aparecer, clique em OK. Os resultados podem ser encontrados no diretório install_home\maximo\tools\ maximo\log no arquivo definido no campo Nome do Arquivo de Log do painel Verificação da Integridade. 6. Opcional: Se algum erro for relatado, execute o Verificador de Integridade no modo de Reparo. a. Marque a caixa de seleção Modo de Reparo? e, em seguida, clique em Executar Verificador de Integridade. b. Quando a caixa de diálogo de relatório aparecer, clique em OK. 7. Opcional: Se o Verificador de Integridade foi executado no modo de Reparo, verifique o arquivo de log para assegurar-se de que todos os itens relatados foram reparados. Se for necessário fazer outras intervenções manuais, resolva Capítulo 11. Fazendo upgrade por meio da migração das informações do WebSphere Application Server para o WebSphere Application Server v8.5.5 (Cenário 2) 59 os erros e, em seguida, execute novamente o Verificador de Integridade no modo de Relatório. Repita o processo até que não haja mais erros. Resultados Embora o Verificador de Integridade possa reparar muitos erros, talvez seja necessário resolver alguns erros manualmente, consultando os arquivos de log. 60 IBM Control Desk: Guia de Upgrade Capítulo 12. Upgrade no Oracle WebLogic Server (Cenário 3) A lista de verificação a seguir é um roteiro de alto nível das tarefas que devem ser executadas para fazer upgrade de produtos que foram implementados no Oracle WebLogic Server. Estas informações descrevem como fazer upgrade para o Control Desk 7.6 em um ambiente do Oracle WebLogic Server. Nesse cenário, serão atualizados os produtos existentes em um ambiente do Oracle WebLogic Server. Esse cenário supõe a existência de das customizações do sua implementação anterior necessárias para a migração para o Control Desk 7.6. Lista de verificação para fazer upgrade no Oracle WebLogic Server Use esta lista de verificação como um guia ao fazer upgrade do Oracle WebLogic Server para a versão 7.6. Tabela 4. Lista de verificação do Oracle WebLogic Server Etapa Ação Descrição 1 Revise e execute os pré-requisitos de upgrade. Revise e execute os pré-requisitos de upgrade descritos em Capítulo 9, “Tarefas de pré-upgrade”, na página 29. 2 Execute o Verificador de Integridade no modo de Relatório no ambiente existente. Para obter instruções detalhadas, consulte “Execução do verificador de integridade do 7.5.x” na página 34. Para obter informações sobre as mensagens de erro, consulte a documentação a seguir: v “Mensagens informativas do verificador de integridade” na página 91 v “Mensagens de aviso do verificador de integridade” na página 91 v “Mensagens de erro do verificador de integridade” na página 94 3 Certifique-se de que tenha o sistema operacional apropriado. © Copyright IBM Corp. 1994, 2015 Para obter uma lista de sistemas operacionais suportados, consulte a página Requisitos do Sistema na wiki IBM Control Desk. 61 Tabela 4. Lista de verificação do Oracle WebLogic Server (continuação) Etapa 4 Ação Descrição Estabeleça o middleware suportado. Estabeleça no ambiente uma versão do Oracle WebLogic Server que seja suportada pelo Control Desk 7.6. As versões do Oracle WebLogic Server que eram suportadas pelo sua implementação anterior não são compatíveis com o Control Desk 7.6. Revise as informações sobre como estabelecer um middleware suportado em “Estabeleça um middleware suportado” na página 64. Se necessário, faça upgrade do software de banco de dados para uma versão suportada, usando o programa de instalação desse software. Antes de fazer upgrade do software de banco de dados, verifique a Matriz de Configuração do Produto para determinar se o software é suportado por esta liberação. A Matriz de Configuração do Produto está disponível aqui. Se necessário, faça upgrade do software do servidor de diretório para uma versão suportada, usando o programa de instalação desse software. Consulte a documentação fornecida com o produto para obter informações sobre upgrade. 5 Configure manualmente o Oracle WebLogic Server. As tarefas de configuração do Oracle WebLogic Server são descritas nas informações de instalação do Control Desk7.6. Instale e configure manualmente o middleware, conforme descrito em Instalar em Oracle WebLogic Server. 6 Opcional: Se necessário, migre os dados do banco de dados ou do servidor de diretórios. Para obter mais informações, consulte o “Migre os dados do banco de dados ou do servidor de diretórios (opcional)” na página 38. 7 Execute o programa de instalação do Execute o programa de instalação do Control Desk versão Control Desk 7.6 para instalar o Control Desk na estação de trabalho administrativa. Para fazer o upgrade, execute as etapas descritas em “Executando o programa de instalação do Control Desk 7.6” na página 39. 8 Migre as customizações da implementação anterior. Migre as customizações feitas na estação de trabalho administrativa do Control Desk versão 7.6. A migração deve ser executada para todos os produtos instalados na estação de trabalho. Para obter mais informações, consulte o “Migração de customizações” na página 41. 9 Execute o programa de configuração do Control Desk Execute o programa de configuração do Control Desk versão 7.6. As mudanças são gravadas no banco de dados e, se você optar por isso, os arquivos EAR do aplicativo serão implementados no WebSphere Application Server Network Deployment. Para obter mais informações, consulte o “Configurando Control Desk versão 7.6 usando o programa de configuração do Control Desk versão 7.6” na página 42. 62 IBM Control Desk: Guia de Upgrade Tabela 4. Lista de verificação do Oracle WebLogic Server (continuação) Etapa 10 Ação Descrição Execute o Verificador de Integridade do Control Desk 7.6. Execute a ferramenta Verificador de Integridade no modo de Relatório. Se o Verificador de Integridade relatar um erro, resolva-o. Para obter instruções detalhadas, consulte “Execução do verificador de integridade do 7.6” na página 43. Para obter informações sobre as mensagens de erro, consulte a documentação a seguir: v “Mensagens informativas do verificador de integridade” na página 91 v “Mensagens de aviso do verificador de integridade” na página 91 v “Mensagens de erro do verificador de integridade” na página 94 11 Implemente manualmente o aplicativo e os arquivos de ajuda do Control Desk. Ao implementar o Control Desk 7.6 no Oracle WebLogic Server, implemente os arquivos EAR do aplicativo manualmente. Para obter instruções detalhadas, consulte “Implementação de arquivos de aplicativo no Oracle WebLogic Server” na página 70. 12 Execute as tarefas de pós-upgrade. Revise informações importantes sobre tarefas de pós-upgrade em Capítulo 15, “Tarefas pós-upgrade”, na página 81. São fornecidas uma lista de verificação e instruções detalhadas para a conclusão das tarefas de pós-upgrade. Execução do verificador de integridade do 7.5.x Execute o utilitário verificador de integridade do Control Desk versão 7.5.x. Sobre Esta Tarefa Antes de prosseguir com o processo de upgrade do Control Desk versão 7.6, execute o utilitário Verificador de Integridade do Control Desk versão 7.5.x. Esse utilitário é usado com o banco de dados do Control Desk versão 7.5.x para assegurar que ele esteja pronto para o upgrade. Quando executado no modo de Relatório, o utilitário verificador de integridade verifica a ocorrência de erros comuns no banco de dados e nos relatórios atuais. Se o Verificador de Integridade relatar um erro, resolva-o executando o Verificador de Integridade no modo de Reparo. Procedimento 1. Na estação de trabalho administrativa do Control Desk versão 7.5.x, abra um prompt de comandos e altere o diretório para o diretório de ferramentas. Por exemplo, c:\ibm\SMP\maximo\tools\maximo 2. Inicie a ferramenta do Verificador de Integridade. v Nos sistemas operacionais Windows integrityui.bat v Em outros sistemas operacionais suportados integrityui.sh Capítulo 12. Upgrade no Oracle WebLogic Server (Cenário 3) 63 3. Selecione a guia Verificação de Integridade. 4. Execute o Verificador de Integridade no modo de Relatório. a. Certifique-se de que a caixa de seleção Modo de Reparo? esteja desmarcada e, em seguida, clique em Executar Verificador de Integridade. b. Quando a caixa de diálogo de relatório aparecer, clique em OK. Os resultados podem ser encontrados no diretório install_home\maximo\tools\ maximo\log no arquivo definido no campo Nome do Arquivo de Log do painel Verificação da Integridade. 5. Opcional: Se algum erro for relatado, execute o Verificador de Integridade no modo de Reparo. a. Marque a caixa de seleção Modo de Reparo? e, em seguida, clique em Executar Verificador de Integridade. b. Quando a caixa de diálogo de relatório aparecer, clique em OK. 6. Opcional: Se o Verificador de Integridade foi executado no modo de Reparo, verifique o arquivo de log para assegurar-se de que todos os itens relatados foram reparados. Se for necessário fazer outras intervenções manuais, resolva os erros e, em seguida, execute novamente o Verificador de Integridade no modo de Relatório. Repita o processo até que não haja mais erros. Resultados Embora o Verificador de Integridade possa reparar muitos erros, talvez seja necessário resolver alguns erros manualmente, consultando os arquivos de log. Estabeleça um middleware suportado Estabeleça no ambiente um middleware que seja compatível com o Control Desk 7.6. A primeira etapa em um upgrade do Control Desk 7.6 é estabelecer no ambiente um middleware que seja suportado pelo Control Desk 7.6. Em alguns casos, o middleware usado na implementação do Control Desk 7.5.x pode ser reutilizado para o upgrade do Control Desk 7.6. Em outros casos, talvez seja necessário usar novos servidores de middleware, que não faziam parte da implementação original do Control Desk 7.5.x. É necessário instalar ou estabelecer uma versão suportada do Oracle WebLogic Server. As versões do Oracle WebLogic Server que eram suportadas no Control Desk 7.5.x não são suportadas no Control Desk 7.6. Consulte a documentação fornecida com o Oracle WebLogic Server para obter informações sobre instalação e upgrade. Se necessário, faça upgrade do software de banco de dados para uma versão suportada pelo Control Desk 7.6. O upgrade do software de banco de dados existente usado com o Control Desk 7.5.x é o método preferencial para o estabelecimento de um banco de dados suportado pelo Control Desk 7.6. Este método permite a reutilização de elementos existentes da implementação do Control Desk 7.5.x, como o ID do usuário e instâncias de banco de dados. Em alguns casos, você pode ser forçado a instalar uma nova instância do software de banco de dados. Por exemplo, a implementação do Control Desk 7.5.x pode incluir um servidor de banco de dados estabelecido em uma plataforma que não é mais suportada no Control Desk 7.6, como pode ser o caso com plataformas de 32 bits. Nesse cenário, deve-se instalar uma nova instância do software de banco de dados que seja compatível com o Control Desk 7.6. Para o DB2, é possível instalar esse 64 IBM Control Desk: Guia de Upgrade software usando o programa de instalação de middleware do Control Desk 7.6. Se você instalar novas instâncias de software de banco de dados fora do programa de instalação de middleware, será necessário executar tarefas adicionais de configuração manual, descritas nas informações de instalação do Control Desk 7.6. Além disso, será necessário migrar o banco de dados do servidor antigo para o novo servidor. Se necessário, faça upgrade do software do servidor de diretório para uma versão suportada pelo Control Desk 7.6. Consulte a documentação fornecida com o produto para obter informações sobre upgrade. Configuração do WebLogic Configure uma versão suportada do Oracle WebLogic Server para o Control Desk versão 7.6. As tarefas de configuração do Oracle WebLogic Server são descritas nas informações de instalação do Control Desk versão 7.6. Execute as tarefas de configuração do Oracle WebLogic Server descritas para o Control Desk versão 7.6. Migre os dados do banco de dados ou do servidor de diretórios (opcional) Dependendo do ambiente, pode ser necessário migrar os dados do banco de dados ou do servidor de diretórios dos servidores de middleware do Control Desk 7.5.x para os servidores de middleware do Control Desk 7.6. Nos casos em que o middleware utilizado para implementar o Control Desk 7.5.x for incompatível com o Control Desk 7.6, é possível migrar as informações do Control Desk 7.5.x para um servidor suportado pelo Control Desk 7.6. Ao fazer um upgrade, não é possível fazer o upgrade do middleware do IBM DB2 a partir da barra de ativação. Você deve fazer o upgrade do middleware do banco de dados separadamente. Para obter informações sobre o upgrade do IBM DB2, consulte o Portal de Upgrade do DB2. As informações também estão disponíveis na documentação do IBM DB2 no IBM Knowledge Center. Se o software de banco de dados do Control Desk 7.5.x for compatível com o Control Desk 7.6, é possível usar o banco de dados existente. Se o banco de dados existente não for compatível, consulte a documentação fornecida com o software para obter instruções sobre como migrar objetos de bancos de dados. Para o DB2, essas informações podem ser localizadas em na Documentação do IBM DB2 no IBM Knowledge Center. Lembre-se de que, caso o software de banco de dados tenha sido atualizado, é necessário migrar apenas a instância de banco de dados (ctginst1) e o banco de dados (maxdb75) do Control Desk 7.5.x. Se você instalou uma nova instância do software de banco de dados, execute as tarefas de configuração adicionais, conforme descrito nas informações de instalação do Control Desk 7.6. Se você optou por usar um servidor de diretório para a segurança na implementação do Control Desk 7.5.x e tiver que migrar informações do servidor de diretórios para cumprir os pré-requisitos do Control Desk 7.6, consulte a documentação fornecida com o software para obter instruções sobre migração. Se tiver usado o IBM Security Directory Server para a implementação do Control Capítulo 12. Upgrade no Oracle WebLogic Server (Cenário 3) 65 Desk 7.5.x, nenhuma migração é necessária, porque a mesma versão do IBM Security Directory Server é suportada em ambos os produtos. Executando o programa de instalação do Control Desk 7.6 Esse procedimento explica como usar o programa de instalação doControl Desk versão 7.6 para instalar o Control Desk versão 7.6. Sobre Esta Tarefa Para fazer o upgrade de uma implementação existente do Control Desk versão 7.5.x para o Control Desk versão 7.6, execute o programa de instalação do Control Desk versão 7.6 no sistema administrativo original do Control Desk versão 7.5.x. Procedimento 1. Efetue login no sistema que for designado como a estação de trabalho administrativa do Control Desk versão 7.6. Se você executar o programa de instalação do IBM Control Desk versão 7.6 a partir de uma janela do terminal do Linux ou do UNIX, deverá estar com login efetuado como o usuário raiz. 2. Ative o programa de instalação do IBM Control Desk versão 7.6 a partir da barra de ativação. a. Inicie o painel de ativação. Windows Na imagem de instalação transferida por download, navegue para o diretório-raiz e execute o seguinte comando: launchpad64.exe. Linux e UNIX A partir da imagem de instalação transferida por download, navegue até o diretório-raiz e execute o seguinte comando: launchpad.sh. b. Selecione um idioma para a instalação e clique em OK. c. Na área de janela de navegação da barra de ativação, clique em Instalar Produto. d. No painel Instalar Produto, selecione IBM Control Desk v7.6 e, em seguida, clique em Instalar componentes do IBM Control Desk. 3. No painel de seleção de pacote, clique em Avançar. Não desmarque a caixa de seleção para IBM Maximo for Service Providers. Fornece recursos que são usados no IBM Control Desk. 4. No painel de validação de pré-requisito de pacote, revise os resultados da verificação de pré-requisito e clique em Avançar. Se algum erro for relatado neste painel, resolva o problema e clique em Verificar Status Novamente antes de continuar. 5. No painel de contrato de licença, revise as informações de licença para cada pacote que está sendo instalado, selecione Aceito os termos nos contratos de licença se você concordar com os termos e, em seguida, clique em Avançar. 6. No painel de localização, para especificar as informações de caminho para o diretório de instalação do IBM Control Desk, selecione uma das seguintes opções e, em seguida, clique em Avançar. 66 IBM Control Desk: Guia de Upgrade Opção Descrição Se a instalação estiver sendo executada em uma estação de trabalho administrativa com uma instalação anterior 1. Selecione Criar um novo grupo de pacotes. Se a instalação estiver sendo executada em uma nova estação de trabalho administrativa sem instalação anterior 1. Selecione Criar um novo grupo de pacotes. 2. No campo Diretório de Instalação, certifique-se de especificar um nome de diretório que seja diferente do diretório de instalação anterior. 2. No campo Diretório de Instalação, especifique um nome de diretório para o diretório de instalação. 7. No painel de local de instalação do pacote, use os valores padrão ou especifique um novo diretório para o diretório de Recursos Compartilhados e para o diretório do Installation Manager. Em seguida, clique em Avançar. O Installation Manager é uma estrutura de instalação que é usada para instalar a versão Control Desk dos componentes do 7.6. O diretório de recursos compartilhados é um diretório da área de trabalho comum usado pelo Installation Manager ao instalar pacotes. Se o Installation Manager já estiver instalado, a opção para selecionar um caminho de instalação para o Installation Manager não será exibida. 8. No painel de recursos do pacote, deixe todas as opções padrão marcadas e clique em Avançar. 9. No painel de resumo de pacote, revise as informações para a instalação planejada e clique em Instalar. 10. Após a conclusão da instalação, se não houver soluções para segmentos de mercado e complementos para serem instalados, é possível selecionar a opção para iniciar o programa de configuração do Control Desk versão 7.6 e, em seguida, clicar em Concluir. O programa de instalação do Control Desk versão 7.6 sai e o programa de configuração do Control Desk versão 7.6 é iniciado automaticamente. Se for necessário instalar soluções para segmentos de mercado e complementos, saia do programa de configuração do Control Desk versão 7.6 e instale esses itens antes de continuar. O que Fazer Depois As soluções para segmentos de mercado e os complementos da versão 7.5 devem ser instalados nesse momento. As soluções para segmentos de mercado e os complementos da versão 7.5 podem ser instalados no Control Desk 7.6 a partir da linha de comandos. A instalação silenciosa também é suportada. Assegure-se de fazer o download da versão e de correções mais recentes disponíveis para a solução para segmentos do mercado ou do complemento antes de instalá-la. Consulte a Matriz de Requisitos de Upgrade do Maximo para obter as informações mais recentes sobre os requisitos para soluções para segmentos de mercado e complementos. Após a instalação, use o programa de configuração do Control Desk versão 7.6 para configurar o Control Desk versão 7.6. Capítulo 12. Upgrade no Oracle WebLogic Server (Cenário 3) 67 Migração de customizações Migre as customizações feitas na implementação do Control Desk 7.5.x para a estação de trabalho administrativa do Control Desk 7.6. Procedimento 1. Compile o código Java customizado usando o compilador JDK 1.7. As classes Java customizadas que foram criadas para a implementação do Control Desk 7.5.x provavelmente foram compiladas usando o JDK 1.5, que foi fornecido com o Control Desk 7.5.x. O código Java customizado deve ser recompilado usando o compilador JDK 1.7, fornecido com o Control Desk 7.6 na pasta C:\IBM\SMP\sdk\bin. a. Copie os arquivos de origem Java customizados da estação de trabalho administrativa do Control Desk7.5.x para a estação de trabalho administrativa do Control Desk7.6. b. Compile a origem para os arquivos de classe Java usando o JDK 1.7. c. Mova os arquivos de classe recompilados para o diretório adequado do Control Desk 7.6. Geralmente, este diretório do Control Desk 7.6 é o mesmo diretório encontrado em Control Desk 7.5.x. 2. Identifique as customizações que foram feitas nos arquivos JSP, XML, HTML, CSS ou XSLT padrão do Control Desk 7.5.x. Essas customizações de arquivos padrão devem ser recriadas nas versões do Control Desk 7.6 desses arquivos. Não é possível sobrescrever arquivos do Control Desk 7.6 com versões modificadas de arquivos padrão do Control Desk 7.5.x da estação de trabalho administrativa do Control Desk7.5.x. As customizações devem ser reaplicadas nas versões do Control Desk 7.6 desses arquivos padrão. 3. Copie ou mova todos os arquivos JSP, XML, HTML, CSS ou XSLT customizados que foram criados para funcionar com o Control Desk 7.5.x. 4. Para obter as mudanças feitas nas extensões do Applet, mova o código compilado para as pastas adequadas no diretório de instalação do Control Desk 7.6. Assegure-se de construir os Jars Applet a partir das pastas do Control Desk 7.6. 5. Copie ou mova os arquivos de relatório do Control Desk 7.5.x que foram customizadospara a pasta adequada do Control Desk 7.6. Esses arquivos de relatório precisam ser importados para o banco de dados após a conclusão do processo de upgrade, conforme descrito nas informações de pós-upgrade. 6. Mova os arquivos de configuração customizados (.properties e .xml) que contêm extensões definidas para o Control Desk 7.6. Produza arquivos XML que possam ser localizados na pasta \maximo\applications\maximo\properties\ product. Caso os arquivos de configuração padrão do Control Desk 7.5.x tenham sido customizados, replique essas mudanças nas versões do Control Desk 7.6 desses arquivos. 7. Copie ou mova o arquivo webclient.properties para a pasta \maximo\applications\maximo\properties\product da instalação do Control Desk 7.6. 8. Copie ou mova as bibliotecas de terceiros usadas com a liberação anterior do para a pasta adequada do Control Desk 7.6. Consulte as informações fornecidas com as bibliotecas de terceiros para certificar-se de que não sejam necessárias outras tarefas de configuração. 68 IBM Control Desk: Guia de Upgrade Configurando Control Desk versão 7.6 usando o programa de configuração do Control Desk versão 7.6 Este procedimento explica como usar o programa de configuração do Control Desk versão 7.6 para configurar o Control Desk versão 7.6. Antes de Iniciar Este procedimento faz referência ao DB2 como o banco de dados a ser configurado para o Control Desk versão 7.6. As referências feitas ao DB2 são simples exemplos. As informações necessárias para o Oracle ou o SQL Server são semelhantes. A ajuda é fornecida na interface com o usuário do programa de configuração do Control Desk versão 7.6 e pode ser usada para determinar as informações que devem ser especificadas para o upgrade. Procedimento 1. Se o programa de configuração do Control Desk versão 7.6 não estiver aberto, inicie-o a partir da barra de ativação do Control Desk. Na área de janela de navegação da barra de ativação, clique em Configurar Produto, especifique o local de instalação do Control Desk e clique em Ativar o programa de configuração Process Automation Suite do Tivoli. 2. Na página de operações de configuração do IBM Control Desk, clique em Configurar uma Nova Implementação. 3. No painel Definir Ambiente de Implementação, especifique informações sobre o host do Control Desk versão 7.5.x DB2. Selecione a opção WebLogic. Após definir seu ambiente de implementação, clique em Concluir. 4. No painel Configurar Informações Gerais do Produto, revise os detalhes do resumo sobre os componentes do produto que está instalando. Especifique a aparência e os recursos de navegação para seu produto, inclua um endereço de email para receber mensagens de fluxo de trabalho e escolha se deseja ou não implementar dados de amostra. 5. No painel Configurar a Instância do DB2, especifique informações sobre a instância do Control Desk versão 7.5.x DB2. 6. No painel Configurar o Banco de Dados DB2, especifique informações sobre o banco de dados do Control Desk versão 7.5.x DB2. 7. No painel Configurar Segurança do Aplicativo, insira os nomes de usuários e senhas dos usuários que devem ser criados para o Control Desk. 8. Escolha o idioma de base e qualquer idioma adicional que você deseja instalar. 9. No painel Aplicar Operações de Implementação, especifique preferências da interface com o usuário, selecione todas as operações de implementação disponíveis e clique em Concluir. Ao selecionar Aplicar as mudanças ao banco de dados, o programa updatedb grava as informações no banco de dados. Resultados Agora, o Control Desk versão 7.6 está instalado, as mudanças foram gravadas no banco de dados e os arquivos EAR do aplicativo foram construídos. O que Fazer Depois Implemente manualmente os arquivos EAR do aplicativo no servidor do Oracle WebLogic Server. Capítulo 12. Upgrade no Oracle WebLogic Server (Cenário 3) 69 Execução do verificador de integridade do 7.6 Execute o utilitário verificador de integridade do Control Desk versão 7.6. Sobre Esta Tarefa Antes de prosseguir com o processo de upgrade do Control Desk versão 7.6, é necessário executar o utilitário Verificador de Integridade do Control Desk 7.6 para confirmar a integridade do banco de dados do Control Desk versão 7.6 após a conclusão das etapas de upgrade. Quando executado no modo de Relatório, o utilitário verificador de integridade verifica a ocorrência de erros comuns no banco de dados e nos relatórios atuais. Se o Verificador de Integridade relatar um erro, resolva-o executando o Verificador de Integridade no modo de Reparo. Procedimento 1. Pare o servidor de aplicativos. Por exemplo, MXServer. 2. Na estação de trabalho administrativa da implementação existente, abra um prompt de comandos e altere o diretório para o diretório de ferramentas do Maximo. Por exemplo, c:\ibm\SMP\maximo\tools\maximo 3. Inicie a ferramenta do Verificador de Integridade. v Nos sistemas operacionais Windows integrityui.bat v Em outros sistemas operacionais suportados integrityui.sh 4. Selecione a guia Verificação de Integridade. 5. Execute o Verificador de Integridade no modo de Relatório. a. Certifique-se de que a caixa de seleção Modo de Reparo? esteja desmarcada e, em seguida, clique em Executar Verificador de Integridade. b. Quando a caixa de diálogo de relatório aparecer, clique em OK. Os resultados podem ser encontrados no diretório install_home\maximo\tools\ maximo\log no arquivo definido no campo Nome do Arquivo de Log do painel Verificação da Integridade. 6. Opcional: Se algum erro for relatado, execute o Verificador de Integridade no modo de Reparo. a. Marque a caixa de seleção Modo de Reparo? e, em seguida, clique em Executar Verificador de Integridade. b. Quando a caixa de diálogo de relatório aparecer, clique em OK. 7. Opcional: Se o Verificador de Integridade foi executado no modo de Reparo, verifique o arquivo de log para assegurar-se de que todos os itens relatados foram reparados. Se for necessário fazer outras intervenções manuais, resolva os erros e, em seguida, execute novamente o Verificador de Integridade no modo de Relatório. Repita o processo até que não haja mais erros. Resultados Embora o Verificador de Integridade possa reparar muitos erros, talvez seja necessário resolver alguns erros manualmente, consultando os arquivos de log. Implementação de arquivos de aplicativo no Oracle WebLogic Server Ao implementar o Control Desk versão 7.6 no Oracle WebLogic Server, os arquivos EAR do aplicativo devem ser implementados manualmente. 70 IBM Control Desk: Guia de Upgrade Sobre Esta Tarefa Implemente os aplicativos de ajuda Maximo e o Maximo no Oracle WebLogic Server. Procedimento 1. Inicie o Console de Administração do Oracle WebLogic Server. 2. Efetue login no console administrativo com o nome de usuário administrativo e senha. 3. Na área de janela à esquerda, clique no botão Bloquear e Editar na seção Centro de Mudanças para configurar o servidor para o modo de edição. 4. Na área de janela à esquerda, clique no link Implementações na seção Estrutura de Domínio. 5. Na seção Resumo de Implementações, clique no botão Instalar. A janela Instalar Assistente do Aplicativo é aberta. 6. Clique no link fazer upload de arquivo(s). 7. Clique no botão Pesquisar junto ao campo Arquivo de Implementação. Navegue para o local em que o arquivo maximo.ear está instalado, selecione o arquivo e clique em Abrir. 8. Clique em Avançar para atualizar o arquivo no servidor Oracle WebLogic Server. 9. Clique no botão de opção ao lado do arquivo maximo.ear e em Avançar para continuar a implementação. 10. Aceite o valor padrão “Instalar essa implementação como um aplicativo” e clique em Avançar para continuar a implementação. 11. Aceite todos os outros valores padrão e clique em Concluir para iniciar o processo de implementação. 12. Quando o processo de implementação estiver concluído, clique no botão Ativar Mudanças no Centro de Mudanças para aplicar as mudanças. A seguinte mensagem será exibida: Todas as mudanças foram ativadas. Nenhum reinício é necessário. 13. Clique no link fazer upload de arquivo(s). 14. Clique no botão Pesquisar junto ao campo Arquivo de Implementação. Navegue para o local em que o arquivo maximoiehs.ear está instalado, selecione o arquivo e clique em Abrir. 15. Clique em Avançar para atualizar o arquivo no servidor Oracle WebLogic Server. 16. Clique no botão de opções ao lado do arquivo maximoiehs.ear e em Avançar para continuar a implementação. 17. Aceite o valor padrão “Instalar essa implementação como um aplicativo” e clique em Avançar para continuar a implementação. 18. Aceite todos os outros valores padrão e clique em Concluir para iniciar o processo de implementação. 19. Quando o processo de implementação estiver concluído, clique no botão Ativar Mudanças no Centro de Mudanças para aplicar as mudanças. A seguinte mensagem será exibida: Todas as mudanças foram ativadas. Nenhum reinício é necessário. 20. Clique nas caixas de seleção ao lado dos aplicativos do Maximo e de ajuda do Maximo. 21. Clique na seta suspensa do botão Iniciar e selecione Atendendo a Todas as Solicitações. A janela Iniciar Assistente de Aplicativos é exibida. Capítulo 12. Upgrade no Oracle WebLogic Server (Cenário 3) 71 22. Clique em Sim para iniciar o sistema. 72 IBM Control Desk: Guia de Upgrade Capítulo 13. Atualizando o Integration Composer As instalações IBM Control Desk que desejam atualizar o Integration Composer devem fazê-lo a partir da Barra de Ativação, como descrito aqui. Se precisar atualizar o Integration Composer em um sistema operacional UNIX no modo console, as instruções também estão descritas. Sobre Esta Tarefa Esta atualização é para qualquer Integration Composer 7.2.1 ou liberação posterior, incluindo Integration Composer 7.2.1, 7.2.2, e 7.2.2.1. O programa de instalação não permite atualizações de liberações anteriores. Nos sistemas operacionais Windows, o programa de instalação verifica automaticamente uma liberação atual válida antes de atualizar. Resultados Ao concluir a atualização com êxito, é possível acessar o Integration Composer como a seguir: No Windows A partir do menu Iniciar ou inserindo o comando: itic_installation_dir\ bin\startFusion.bat O diretório de instalação padrão do Integration Composer para os sistemas operacionais Windows é C:\Integration Composer. No outros sistemas operacionais suportados Inserindo o comando: itic_installation_dir/bin/startFusion.sh O diretório de instalação padrão do Integration Composer para esses sistemas operacionais é /home/user/Integration_Composer. Atualizando o Integration Composer Usando a Barra de Ativação Para as instalações do Control Desk, a maneira recomendada para fazer upgrade do Integration Composer é a partir da Barra de Ativação. Use a Barra de Ativação para fazer upgrade do Integration Composer em qualquer sistema operacional. Antes de Iniciar Para evitar perder quaisquer dados atuais, faça backup de seus diretórios Integration Composer data\dataschema e data\mappings antes de atualizar. Atenção: Durante o upgrade, uma nova versão do arquivo data\properties\nrs\ cleansingRules.xml é criada. A versão desse arquivo anterior ao upgrade é salva e renomeada como data\properties\nrs\CleansingRules.old. As customizações feitas na versão do arquivo data\properties\nrs\cleansingRules.xml anterior ao upgrade devem ser mescladas com a nova versão do arquivo antes do início do processo de mapeamento. © Copyright IBM Corp. 1994, 2015 73 Antes de fazer upgrade para esta liberação do Integration Composer, anote as informações de customização atuais se desejar reutilizar qualquer uma dessas informações no novo arquivo dis.logging.properties. Certifique-se de que você tenha até 70 MB de espaço livre para o diretório de instalação. Nota: Confirme que o comando java -version retorna 1.7 antes de iniciar o upgrade. IBM Java™ SDK 7.0 com JRE 1.7 é fornecido nas imagens do produto. Procedimento 1. A partir da Barra de Ativação, ative o programa de atualização do Integration Composer clicando no link Instalar o IBM Tivoli Integration Composer. 2. Na janela do IBM Tivoli Integration Composer, selecione o idioma na lista suspensa e no final clique em OK. 3. Leia as informações na janela Introdução e clique em OK. 4. [Apenas em sistemas operacionais não Windows] Na janela Selecionar Tipo de Instalação, selecione Atualizar e clique em Avançar. 5. Na janela Escolher Pasta de Instalação, aceite o local padrão ou digite um caminho de arquivo para especificar onde você deseja atualizar o produto. (Ou é possível clicar em Escolher para procurar e selecionar o local desejado.) Em seguida, clique em Avançar. 6. Na janela Escolher Local do IBM SDK, digite o diretório onde o IBM Java SDK 7.0 está localizado, ou clique em Escolher para navegar e selecionar o diretório. Em seguida, clique em Avançar. 7. Na janela Resumo de Pré-instalação, revise os detalhes de atualização. (Se necessário, use os botões Anterior para voltar e fazer correções e use os botões Avançar para retornar a essa janela.) Quando satisfeito com os dados de resumo, clique em Instalar. A janela de progresso Instalando o Integration Composer exibe durante a atualização. Quando a atualização é concluída, a janela Instalação Concluída é exibida. 8. Na janela Instalação Concluída, clique em Concluído. Fazendo upgrade do Integration Composer no modo do console Use o procedimento descrito aqui caso seja necessário fazer upgrade do Integration Composer em um computador não Windows no modo do console (linha de comandos). Antes de Iniciar Instalar o Integration Composer 7.6.0, conforme descrito nesta seção, atualizará a versão anterior do Integration Composer. Você não precisa remover a versão anterior primeiro. Para evitar perder quaisquer dados atuais, faça backup de seus diretórios Integration Composer data\dataschema e data\mappings antes de atualizar. 74 IBM Control Desk: Guia de Upgrade Atenção: Durante o upgrade, uma nova versão do arquivo data\properties\nrs\ cleansingRules.xml é criada. A versão desse arquivo anterior ao upgrade é salva e renomeada como data\properties\nrs\CleansingRules.old. As customizações feitas na versão do arquivo data\properties\nrs\cleansingRules.xml anterior ao upgrade devem ser mescladas com a nova versão do arquivo antes do início do processo de mapeamento. Certifique-se de ter mais de 70 MB de espaço livre para o diretório de instalação. Sobre Esta Tarefa Os arquivos do Integration Composer estão localizados no diretório \ITIC ou \Install\ITIC na versão de imagens do produto 7.6. Use o comando setup.bin para iniciar o processo de upgrade: setup.bin ← setup.exe A seguir, as etapas para fazer upgrade do Integration Composer em um sistema operacional não Windows. Procedimento 1. Conecte-se ao servidor como um administrador (por exemplo, como raiz). 2. Salve o arquivo de instalação binário do Integration Composer, setup.bin, no servidor onde pretende instalar o Integration Composer. 3. Certifique-se que o JRE 1.7 esteja em seu caminho do sistema. Para incluir JRE 1.7 para o caminho, insira os seguintes comandos (em que JRE_location é o caminho para seu IBM JRE; por exemplo, /opt/ibm/java-i386-60/jre/bin:$PATH): JAVA_HOME=JRE_location export JAVA_HOME PATH=$JAVA_HOME:$PATH export PATH 4. Navegue até o local onde você salvou o arquivo setup.bin. 5. Digite o seguinte comando para tornar executável o arquivo de instalação binário: chmod +x setup.bin 6. Execute o programa de instalação do Integration Composer no modo do console inserindo o seguinte comando no prompt de shell: sh ./setup.bin -i console No modo do console, aparecerá um prompt para digitar as informações linha por linha. Nota: Confirme que o comando java -version retorna 1.7 antes de iniciar o upgrade. IBM Java SDK 7.0 com JRE 1.7 é fornecido nas imagens do produto. 7. Na etapa Escolher Código de Idioma, digite o número de seu código de idioma na lista de códigos de idioma e pressione Enter. 8. Na etapa Introdução, revise as informações de Introdução e pressione Enter. 9. Na etapa Selecionar Tipo de Instalação, digite o número para a seleção de Atualização e pressione Enter. Isto indica que você deseja fazer upgrade do Integration Composer a partir da liberação anterior. Capítulo 13. Fazendo Upgrade do Integration Composer 75 10. Na etapa Escolher Pasta de Instalação, digite o local (caminho absoluto) no qual o Integration Composer está atualmente instalado e pressione Enter. Ou apenas pressione Enter para aceitar o caminho exibido. 11. Na etapa Local do IBM SDK , especifique o caminho do arquivo onde IBM Java SDK 7.0 está instalado, executando uma das seguintes ações: v Aceite o local padrão e pressione Enter. v Digite um caminho de arquivo diferente para o local e pressione Enter. 12. Na etapa Resumo de Pré-instalação, revise os detalhes de instalação e pressione Enter para começar a instalar o Integration Composer. A barra de progresso da instalação é exibida durante a instalação. Quando a instalação estiver concluída, a etapa de Conclusão da Instalação será exibida. 13. Na etapa de Conclusão da Instalação, pressione Enter. A instalação é feita e você é enviado de volta para o prompt de comandos. Fazendo upgrade dos adaptadores de integração Para esta liberação inicial do Control Desk, é recomendável seguir as instruções de configuração do adaptador para uma nova instalação. Processo de upgrade As instruções de configuração oferecem orientação para o processo de execução das seguintes tarefas: 1. Criação de uma origem de dados de origem 2. Criação de uma origem de dados de destino 3. Definição do mapeamento Qualquer customização feita para adaptadores anteriores pode ser aplicada ao novo mapeamento. É possível encontrar instruções de configuração nos seguintes locais: v Para ativos: Importando os dados v Para CIs: Importando dados do item de configuração Adaptadores suportados Para obter uma lista de adaptadores que são suportados na liberação inicial do Control Desk, consulte Ferramentas de Descoberta Suportadas na wiki do Control Desk. Informações adicionais para usuários dos adaptadores Tivoli Asset Discovery for Distributed Ao executar os adaptadores do Tivoli Asset Discovery for Distributed no Integration Composer, você deve executar o script .sql apropriado para sua versão do adaptador: Tabela 5. Tivoli Asset Discovery for Distributed versão 7.2 e 7.2.1 76 IBM Control Desk: Guia de Upgrade Script /data/dataschema/tad4d72/ updateTAD4D72_721views.sql Tabela 5. (continuação) Tivoli Asset Discovery for Distributed versão Script 7.2.2 updateTAD4D722views.sql 7.5 updateTAD4D75views.sql 7.5.0.1 updateTAD4D7501views.sql Os scripts estão localizados em /data/dataschema/<tad4d version>/ na estrutura de diretório do Integration Composer. Melhorando o desempenho do Integration Composer É possível aproveitar as opções para melhorar o desempenho do adaptador de CI Real. O adaptador de integração para dados de IC Real é usado para transformar os dados recebidos do TADDM para o formato necessário para serem usados pelos aplicativos Control Desk. Algumas opções estão disponíveis para melhorar o desempenho desse adaptador. Por padrão, essas opções não são ativadas em sistemas atualizados. Revise as opções e decida se elas devem ser ativadas no ambiente. A primeira opção diz respeito ao armazenamento em cache de chaves alternativas e primárias durante a recuperação de dados. É possível obter uma significativa melhoria de desempenho ao não armazenar essas chaves em cache. O arquivo fusion.properties, localizado no diretório Integration Composer\data\properties, contém propriedades que controlam o processo de mapeamento. Esse arquivo contém estas linhas: mxe.fusion.referencecache.Actual_Target_CI=1000,Guid,ALTERNATE_KEY mxe.fusion.referencecachesameas.Actual_CI=Actual_Target_CI mxe.fusion.referencecache.Actual_CI=1000,Guid,ALTERNATE_KEY Para desativar o armazenamento em cache de chaves alternativas e primárias, inclua o parâmetro NO_CACHE_LOAD nas duas propriedades referencecache, de forma que a aparência das linhas seja a seguinte: mxe.fusion.referencecache.Actual_Target_CI=1000,Guid,ALTERNATE_KEY,NO_CACHE_LOAD mxe.fusion.referencecachesameas.Actual_CI=Actual_Target_CI mxe.fusion.referencecache.Actual_CI=1000,Guid,ALTERNATE_KEY,NO_CACHE_LOAD Não inclua o parâmetro na propriedade referencecachesameas. Ao incluir o parâmetro NO_CACHE_LOAD, o adaptador de CI Real também usa o encadeamento ao importar dados do TADDM. O uso de encadeamentos melhora em até 50% o desempenho na execução do adaptador. O uso de encadeamentos faz com que o adaptador utilize mais memória, portanto, não é recomendado utilizá-lo sem o parâmetro NO_CACHE_LOAD. É possível controlar o comportamento relacionado a encadeamentos, usando as propriedades existentes no arquivo ccmdb.properties, localizado no diretório Integration Composer\data\properties\provider. A propriedade ccmdb.itic.num.of.threads usa dois valores numéricos. O primeiro valor é o número de encadeamentos a serem usados e o segundo valor é o número máximo de itens Capítulo 13. Fazendo Upgrade do Integration Composer 77 de configuração (CIs) enfileirados. Os valores padrão são 5:25 para sistemas operacionais de 32 bits e 10:50 para sistemas operacionais de 64 bits. Outra opção é importar apenas CIs reais que serão promovidas a CIs autorizadas. Essa opção usa os escopos de promoção que são definidos como parte do estaço de CI autorizado. O uso dessa opção evita a importação de dados relacionados a CIs que nunca se tornarão CIs autorizados. Para implementar essa opção, altere para 2 o valor da propriedade ccmdb.actualci.filtering.level no arquivo ccmdb.properties. Se um encadeamento não receber uma resposta do TADDM dentro de um período de tempo especificado, você verá uma mensagem como esta no arquivo fusion.log e saída padrão: Did not receive any TADDM data for GUID 7C386211D2403B02A769DD00B8797C32 after waiting for 100000 milliseconds. Error occurred during: Retrieving TADDM CI data for 7C386211D2403B02A769DD00B8797C32 Error occurred in: TADDMThreadManager.getTaddmData Quando esse erro ocorre, o Integration Composer para de funcionar. Ao ver essa mensagem, é possível modificar o arquivo ccmdb.properties para substituir o período de tempo que o encadeamento deve aguardar antes de falhar. Por padrão, essa propriedade não é definida no arquivo, mas é possível incluí-la. Inclua esta linha no arquivo: ccmdb.itic.thread.max.wait.time=200000 Isso duplica o tempo de espera, transformando-o de dez minutos em 20 minutos. Se você modificar arquivos de propriedades para implementar qualquer uma dessas opções, reinicie o servidor do Integration Composer para ativar as mudanças de propriedade. 78 IBM Control Desk: Guia de Upgrade Capítulo 14. Fazendo upgrade do Ambiente de Trabalho do Implementador O Ambiente de Trabalho do Implementador é um ambiente de trabalho baseado no Eclipse, instalado separadamente, que é a ferramenta de melhor prática para a criação de espaços de IC autorizado. Caso você já tenha instalado uma versão anterior do Ambiente de Trabalho do Implementador, atualize-a para que funcione com o Control Desk 7.6. Sobre Esta Tarefa É possível fazer upgrade do Ambiente de Trabalho do Implementador usando a barra de ativação do produto ou o instalador nativo. Em qualquer um dos casos, a imagem do DVD1 ou o DVD físico deve estar acessível a partir da estação de trabalho na qual o Ambiente de Trabalho do Implementador foi instalado. O processo de upgrade preserva os projetos do Ambiente de Trabalho do Implementador. Em seguida, o Ambiente de Trabalho do Implementador os atualiza para que funcionem que a nova versão do produto. Procedimento 1. Inicie o instalador do Ambiente de Trabalho do Implementador. Inicie a barra de ativação do produto e clique em Instalar Ambiente de Trabalho do Implementador ou, para usar o instalador nativo, altere para o diretório DW e execute install.exe. 2. O instalador do Ambiente de Trabalho do Implementador detecta que o Ambiente de Trabalho do Implementador já está instalado e pergunta se você deseja fazer upgrade para a nova versão. Clique em OK. 3. Você talvez veja uma mensagem dizendo que o Install Anywhere está preparando a instalação. Quando a tela Ambiente de Trabalho do Implementador for exibida, escolha o idioma na lista suspensa e clique em OK. 4. O instalador do Ambiente de Trabalho do Implementador pergunta se você deseja fazer upgrade dos projetos do Ambiente de Trabalho do Implementador para que fiquem compatíveis com a nova versão. Os upgrades incluem modificações feitas nas classificações autorizadas, para que correspondam às suportadas com o Control Desk 7.6. Faça upgrade de seus projetos para utilizá-los com a nova versão do produto. 5. Revise o resumo de pré-instalação. Clique em Anterior para fazer qualquer mudança. Clique em Upgrade para iniciar o upgrade. 6. Você verá uma barra de progresso, indicando o andamento do procedimento de upgrade. Após a conclusão do upgrade, clique em Pronto para sair do instalador. Neste ponto, o instalador fez upgrade do software do Ambiente de Trabalho do Implementador, mas não dos projetos existentes. Os projetos existentes na área de trabalho do Ambiente de Trabalho do Implementador serão automaticamente atualizados na próxima vez em que o Ambiente de Trabalho do Implementador for iniciado. Resultados Na inicialização, o Ambiente de Trabalho do Implementador verificará cada projeto, para ver se ele se qualifica para o upgrade. Em caso afirmativo, serão © Copyright IBM Corp. 1994, 2015 79 exibidos uma mensagem e um indicador de progresso, mostrando o andamento geral do upgrade. Em alguns casos, o upgrade pode solicitar uma resposta a uma pergunta relacionada à etapa de upgrade atual. Antes de fazer upgrade dos elementos no projeto, o Ambiente de Trabalho do Implementador fará um backup do projeto e colocará o arquivo de backup dentro do próprio projeto. Além disso, se você importar um projeto do Ambiente de Trabalho do Implementador que foi exportado de uma liberação anterior, esse mesmo procedimento de upgrade ocorrerá. 80 IBM Control Desk: Guia de Upgrade Capítulo 15. Tarefas pós-upgrade Várias tarefas devem ser concluídas após o upgrade bem-sucedido do Control Desk. Depois de fazer upgrade do Control Desk, execute as tarefas de pós-upgrade para concluir o upgrade. Lista de verificação para as tarefas de pós-upgrade Use esta lista de verificação como uma diretriz ao executar as tarefas de pós-upgrade depois de fazer upgrade do produto. Tabela 6. Lista de verificação para a execução de tarefas pós-upgrade Etapa Ação Descrição 1 Verifique programaticamente se a instalação foi bem-sucedida Consulte “Verificando Programaticamente se a Instalação Foi Bem-sucedida” 2 Revise as telas atualizadas Consulte “Revisando as telas atualizadas” na página 85 3 Revise domínios de tabela e domínios cruzados Consulte “Revisão de domínios de tabela e domínios cruzados” na página 86 4 Atualize os relatórios BIRT Consulte “Atualização de relatórios BIRT” na página 86 5 Atualize as estatísticas Consulte “Atualização de estatísticas” na página 86 Verificando Programaticamente se a Instalação Foi Bem-sucedida Depois de ter saído do programa de instalação do Control Desk sem encontrar qualquer erro, é possível verificar se a instalação foi concluída com êxito. A instalação é verificada programaticamente por meio do uso de utilitários de validação de pós-instalação. Antes de Iniciar A variável de ambiente JAVA_HOME deve ser configurada no sistema antes que possa usar os utilitários de verificação. Sobre Esta Tarefa Durante a instalação, o programa de instalação do Control Desk executa uma verificação de funcionamento simples. Esta verificação de funcionamento consiste em efetuar login no aplicativo para verificar a disponibilidade. Esta verificação de funcionamento pode não ser suficiente para verificar uma instalação bem-sucedida em todos os cenários de implementação. Por exemplo, se, durante a instalação, você selecionar a opção para implementar o arquivo EAR de aplicativo © Copyright IBM Corp. 1994, 2015 81 posteriormente, esta verificação de funcionamento não poderá verificar a instalação. Esta verificação de funcionamento simples também é insuficiente para verificar um upgrade. Um utilitário de validação de pós-instalação é disponibilizado após a implementação do produto. O utilitário installValidation é usado para validar a instalação do produto e do middleware. Esse utilitário de linha de comandos é usado para verificar a instalação e a configuração do produto de uma maneira mais completa. Esses utilitários também podem ser usados para verificar uma implementação existente quando são feitas mudanças no ambiente, como mudanças nos nomes de host, IDs de usuário e senhas. Os resultados do utilitário installValidation são registrados em GConfigurationError[yyyymmddHHmm], CTGConfigurationMessage[yyyymmddHHmm],CTGConfigurationSummary[yyyymmddHHmm] e CTGConfigurationTrace[yyyymmddHHmm]. Esses arquivos de log estão localizados no diretório \IBM\SMP\ConfigTool\logs na estação de trabalho administrativa. Procedimento 1. Efetue login no servidor usando o ID do usuário que foi usado para executar o programa de instalação. Se você pretende usar o utilitário installValidation, efetue login no servidor que hospeda o componente instalado. 2. Assegure-se de que a variável de ambiente JAVA_HOME esteja configurada corretamente para o local de uma instalação JRE 1.7. 3. Para verificar a instalação de middleware, na imagem de middleware, atualize o arquivo middleware.properties com os valores do parâmetro de instalação para componentes de middleware a serem verificados, altere o diretório para \HealthCheck e execute o middlewareValidate.[sh|bat]. Para verificar a instalação do produto, na estação de trabalho administrativa, altere o diretório para \IBM\SMP\ConfigTool\scripts e execute o comando installValidation.[sh|bat]. Para quaisquer comandos, use os parâmetros descritos abaixo: Tabela 7. Parâmetros de Utilitários de Verificação Programa Parâmetros de Sintaxe Entrada installValidation.[sh|bat] -action Use -action validate para iniciar a validação da instalação do produto. Use -actionvalidateMiddleware para iniciar a validação da instalação do middleware. O parâmetro -action é o único parâmetro obrigatório ao usar o utilitário installValidation. 82 IBM Control Desk: Guia de Upgrade Tabela 7. Parâmetros de Utilitários de Verificação (continuação) Programa Parâmetros de Sintaxe Entrada -trace As informações de progresso de verificação são gravadas na tela durante o processo de verificação. É possível modificar a saída usando o parâmetro -tracing. v minimal As informações de progresso são limitadas às informações de erro. v normal As informações incluem progresso de teste individual, resultados de teste individual e progresso geral do processo de verificação inteiro. Este é o modo padrão de rastreio. v verbose Além de fornecer informações de progresso normal, o rastreio detalhado inclui o nome da classe de teste, o nome do método de teste e as informações de ação corretiva. -confirm Você será avisado antes que cada teste seja iniciado. Você deve confirmar cada teste a ser executado. Não há entrada para este parâmetro. -component É possível fornecer uma lista delimitada por vírgulas de diretórios que contêm os objetos de teste para limitar o teste para um conjunto específico de testes. Esses objetos de teste devem estar localizados no diretório \ibm\smp\ HealthValidation\. Para o programa de instalação do produto, apenas a pasta CTGIN é fornecida. -dbuser Forneça o ID do usuário usado para acessar o banco de dados. Capítulo 15. Tarefas pós-upgrade 83 Tabela 7. Parâmetros de Utilitários de Verificação (continuação) Programa Parâmetros de Sintaxe Entrada -dbpwd Forneça a senha do ID do usuário usado para acessar o banco de dados. -wasuser Forneça o usuário do WebSphere Application Server Network Deployment. -waspwd Forneça a senha para o usuário WebSphere Application Server Network Deployment. -maxuser Forneça o ID do usuário administrador Control Desk. Por exemplo, maxadmin. -maxpwd Forneça a senha para o ID do usuário de administrador do Control Desk. -middlewareproperties Use -middlewareproperties file em que file é o local do arquivo middleware.properties. Por padrão, este arquivo está localizado na mídia de instalação de middleware no diretório \HealthCheck. O middleware.properties contém as propriedades de instalação de middleware, como locais de instalação e portas. Os nomes de usuário e senhas não estão armazenados no arquivo de texto simples. Algumas das propriedades comuns a todas as plataformas definiram os valores padrão, mas propriedades específicas de plataforma como os locais de instalação precisam ser atualizados neste arquivo antes de iniciar o utilitário middlewareValidate. O parâmetro -middlewareproperties é o único parâmetro obrigatório ao usar o utilitário middlewareValidate. -sourceDirectory 84 IBM Control Desk: Guia de Upgrade Forneça o diretório de instalação do software. Tabela 7. Parâmetros de Utilitários de Verificação (continuação) Programa Parâmetros de Sintaxe Entrada -trace As informações de progresso de verificação são gravadas na tela durante o processo de verificação. É possível modificar a saída usando o parâmetro -trace. v minimal As informações de progresso são limitadas às informações de erro. v normal As informações incluem progresso de teste individual, resultados de teste individual e progresso geral do processo de verificação inteiro. v verbose Além de fornecer informações de progresso normal, o rastreio detalhado inclui o nome da classe de teste, o nome do método de teste e as informações de ação corretiva. Se esta opção não for fornecida, por padrão, nenhuma saída será exibida. -bindDN Forneça o Nome Distinto da ligação. -bindPwd Forneça a senha para o Nome Distinto da ligação. Por exemplo, installValidation.bat -action validate Resultados Os resultados do utilitário de validação installValidation.bat são registrados em ctginstallvalidationtrace00.log. Esse log está localizado no diretório \IBM\SMP\ConfigTool\logs na estação de trabalho administrativa. Revisando as telas atualizadas Se você customizou as telas no Control Desk, essas customizações não são retidas durante o processo de upgrade. Efetue login no Control Desk versão 7.6 e revise as telas que foram customizadas anteriormente no Control Desk versão 7.5.x. É possível optar por manter as telas Capítulo 15. Tarefas pós-upgrade 85 padrão do Control Desk versão 7.6 ou reaplicar as customizações. Use o aplicativo Designer de Aplicativos no Control Desk versão 7.6 para fazer inclusões ou ajustes nas telas atualizadas. Revisão de domínios de tabela e domínios cruzados Revise todos os domínios cruzados e domínios de tabela customizados. Caso tenha incluído ou modificado domínios cruzados ou domínios de tabela, revise suas cláusulas WHERE. Assegure-se de que as cláusulas WHERE utilizam a versão 7.6 e nomes de coluna. Se necessário, use o aplicativo de Configuração do Banco de Dados para especificar novamente as informações de tabela e de coluna. Edite todos os domínios customizados que nomeiam qualquer uma das tabelas referenciadas na versão 7.5, mas que não existem na versão 7.6. Assegure-se de examinar todos os domínios cruzados e de tabela customizados. Atualização de relatórios BIRT Siga os procedimentos a seguir para atualizar os relatórios BIRT para o Control Desk versão 7.6. Gerando novamente as páginas de solicitação para os relatórios Após o upgrade, acesse o aplicativo de Administração de Relatórios e gere novamente as páginas de solicitação para todos os relatórios. Atualização de estatísticas No Oracle, as tarefas de administração do sistema incluem a análise de comandos da tabela. Analise todas as tabelas para assegurar que o Otimizador Oracle baseado em Custos tenha estatísticas atualizadas. 1. Registre-se no Control Desk. 2. Abra o aplicativo de Configuração do Banco de Dados. 3. No menu Selecionar Ação, selecione Atualizar Estatísticas e, em seguida, clique em OK para continuar. 86 IBM Control Desk: Guia de Upgrade Capítulo 16. Tópicos diversos Esses tópicos abrangem situações específicas que podem ser encontradas enquanto você planeja e executa seu upgrade. Fazendo integração de OSLC Se você implementou a integração de OSLC disponível para Service Request Manager 7.2.1 ou Control Desk 7.5, use esse procedimento para fazer upgrade de seu sistema, incluindo essa integração. Sobre Esta Tarefa IBM forneceu um pacote no ISM Library que permitiu que você integrasse Service Request Manager 7.2.1 ou Control Desk 7.5 com Rational Team Concert ou Rational ClearQuest usando OSLC . Se você tiver instalado e usado esse pacote, o processo de upgrade faz upgrade dos seguintes dados da integração original: v Terminal OAuth v Provedor OSLC v Vinculações de Problemas para defeitos em Rational Team Concert ou Rational ClearQuest A integração do aplicativo Problemas para essas outras ferramentas possui uma aparência atualizada em Control Desk 7.6. Procedimento 1. Faça upgrade do sua implementação anterior para Control Desk 7.6, seguindo o cenário que você escolheu na Parte 2 ou Parte 3 deste guia. Não faça a atualização do banco de dados ou implementação do arquivo EAR. 2. Ao executar o utilitário do Verificador de Integridade após executar o upgrade, não execute-o no modo de Reparo. O Verificador de Integridade emite mensagens de erro sobre os dados de OSLC que permanecem em seu banco de dados. Não tente corrigir esses erros. 3. Instale a Integração com o Rational Team Concert e a integração do Rational ClearQuest da barra de ativação do produto. 4. Abra o arquivo de propriedades de migração de OSLC: install_home/tools/ maximo/oslcmigration.properties. 5. Siga as instruções no arquivo de propriedades para atualizar cada propriedade com o valor correto para seu ambiente. Salve e feche o arquivo. 6. Pare todos os Servidores de Aplicativos executando o aplicativo maximo, por exemplo, MXServer. 7. Execute o instalador do produto para atualizar seu banco de dados com as mudanças pendentes acumuladas e para compilar os arquivos EAR do produto. 8. Na linha de comandos, execute o comando a seguir para migrar todos os dados para a nova integração: install_home/tools/maximo/internal/runscriptfile.bat -csccdoslc_pmp -fOslcMigration © Copyright IBM Corp. 1994, 2015 87 Use o runscriptfile.bat em Windows; use runscriptfile.sh em outros sistemas operacionais suportados. 9. Se ocorrer alguma falha, corrija-a e execute novamente o script. 10. Se você estiver usando o SSL para essa integração, leia “Configurando a integração de OSLC sobre SSL” na página 89 e execute as etapas antes de continuar. 11. Ao ensaiar seu upgrade em um ambiente de teste ou de desenvolvimento, execute essas etapas para validar as atualizações para os dados relacionados a OSLC em seu sistema. Ao fazer upgrade de seu ambiente de produção, é possível ignorar essas etapas para minimizar sua janela de manutenção. a. Implemente seus arquivos EAR em seu servidor J2EE. b. Reinicie o Servidor de Aplicativos em execução no aplicativo Maximo, por exemplo, MXServer. c. Efetue login no produto e verifique essas atualizações: v Em Integração > Terminais, abra o terminal (Rational Team Concert ou Rational ClearQuest) que corresponde ao produto que você integrou no sua implementação anterior. Verifique se o Token de Acesso, Token de Solicitação, Chave do Consumidor e URLs de Autorização estão corretos. Se algum valor não estiver correto, é possível corrigi-lo neste aplicativo. v Em Integração > Provedores OSLC, abra o provedor (Rational Team Concert ou Rational ClearQuest) que corresponde ao produto que você integrou no sua implementação anterior. Verifique se a URI Pública e a URI da Lista do Provedor de Serviços estão corretas. Se algum valor não estiver correto, é possível corrigi-lo neste aplicativo. v Em Central de Serviço > Problemas, abra um Problema que foi anteriormente vinculado a um defeito de Rational Team Concert ou de Rational ClearQuest. Verifique se é possível visualizar a visualização da IU para o link passando o mouse sobre o ícone próximo ao campo de URI. Você pode ser avisado para efetuar login ao Rational Team Concert ou Rational ClearQuest. d. Efetue logout do produto. Feche a janela do navegador. e. Pare todos os Servidores de Aplicativos executando o aplicativo maximo, por exemplo, MXServer. 12. Se, e somente se, você tiver verificado que a migração foi bem-sucedida, execute o seguinte script para remover os dados da integração 7.2.1 ou 7.5: install_home/tools/maximo/internal/runscriptfile.bat -csccdoslc_pmp -fOslcRemoveOld. 13. Execute o utilitário do Verificador de Integridade no modo de Relatório. Verifique se os erros relacionados para os dados de OSLC antigos não aparecem. Corrija quaisquer erros relatados pelo Verificador de Integridade. 14. Se você estiver fazendo upgrade do Control Desk 7.5, execute essas etapas adicionais: a. No install_home/bin execute esse comando: solutionInstaller -action uninstall -pkguuid 2A4E9D8E7E8E4EE58CFC13DE485CF111 -skipj2eecfg -skipdbcfg -wasuser WAS_username -waspwd password -wasrxauser OS Admin user name -wasrxapwd OS Admin password Esse comando desinstala o pacote OSLC 7.5. b. Mude o diretório para install_home\maximo\tools\maximo\en\ sccdoslc_pmp. Edite o arquivo OSLCRemoveOldClasses.bat (ou .sh se você estiver em uma plataforma não Windows). Localize a linha 88 IBM Control Desk: Guia de Upgrade MAXIMO_INSTALL_DIR=ReplaceThisWithMAXIMOInstallDirectory e mude ReplaceThisWithMAXIMOInstallDirectory para o local de seu diretório de instalação, tal como C:\ibm\smp. Salve o arquivo e execute-o. c. Reconstrua e reimplemente o arquivo maximo.ear. 15. Reinicie o Servidor de Aplicativos em execução no aplicativo Maximo, por exemplo, MXServer. Configurando a integração de OSLC sobre SSL Para usar uma integração de OSLC com um produto que utiliza o Secure Sockets Layer (SSL), importe o certificado SSL do produto. Sobre Esta Tarefa É possível usar o OSLC para se integrar ao Rational Team Concert ou Rational ClearQuest. Se o Rational Team Concert ou o servidor do Rational ClearQuest requer uma conexão de SSL, você deve importar o certificado SSL desse servidor em seu servidor do J2EE. Se você estiver fazendo upgrade no mesmo servidor do J2EE utilizado por você no sua implementação anterior, e já tiver importado o certificado, não será necessário importá-lo novamente. Importando o certificado SSL em um servidor WebSphere Procedimento 1. Efetue login no console administrativo do WebSphere Application Server. 2. Clique em Segurança > Certificado SSL e Gerenciamento de Chaves. 3. Selecione Armazenamentos de Chaves e Certificados. 4. 5. 6. 7. Selecione o armazenamento confiável, geralmente CellDefaultTrustStore. Selecione Certificados de Assinantes. Selecione Recuperar da Porta. Insira o host, a porta SSL e um nome para a entrada do certificado para o Rational Team Concert ou servidor do Rational ClearQuest. 8. Selecione Recuperar da Porta. Se as informações do certificado forem recuperadas com êxito, elas serão exibidas. 9. Selecione OK e salve a configuração. Importando o certificado SSL em um servidor WebLogic Procedimento 1. Recupere o arquivo de certificado do Rational Team Concert ou do servidor Rational ClearQuest, salve-o na estação de trabalho administrativa. Observe o local do arquivo de certificado para a próxima etapa. 2. Execute o comando a seguir no servidor WebLogic: weblogic_install_dir\jdk160_18\jre\bin\keytool.exe -import -alias alias -file certificate_file -keystore weblogic_install_dir\jdk160_18\jre\lib\security\cacerts 3. Insira a senha do keystore. A senha padrão é changeit. 4. Quando solicitado, insira y para optar por incluir o certificado no armazenamento confiável. 5. Reinicie o servidor WebLogic. Capítulo 16. Tópicos diversos 89 Fazendo upgrade dos fluxos de trabalho padrão para o Catálogo de Serviços Se você estiver fazendo upgrade da versão 7.5.0.x e tiver customizado os fluxos de trabalho padrão que são executados quando um usuário envia uma solicitação, você deve aplicar essas customizações ao novo fluxo de trabalho padrão. Sobre Esta Tarefa Em cada liberação do produto, novos fluxos de trabalho padrão são fornecidos para uso com o Catálogo de Serviços. Customizações que você fez para esses fluxos de trabalho padrão não são encaminhadas para a nova liberação. Se desejar reter as customizações, você deve aplicá-las aos novos fluxos de trabalho padrão. Você deve determinar se deseja usar as mesmas customizações com os fluxos de trabalho e os novos recursos que são fornecidos pela nova liberação. Se preferir, é possível optar por continuar a usar seus fluxos de trabalho customizados da liberação anterior. No entanto, se você escolher essa opção, as novas funções que são fornecidas no Catálogo de Serviços não estarão disponíveis. É possível optar por usar os fluxos de trabalho padrão antigos enquanto realiza a customização dos novos fluxos de trabalho padrão. Repita essas etapas para cada organização afetada. Procedimento 1. Abra o aplicativo Organizações: Administração > Organizações. 2. Escolha a ação Opções do Catálogo de Serviços > Opções de Fluxo de Trabalho para Catálogo de Serviços. 3. O campo Iniciar Fluxo de Trabalho no Envio da Solicitação de Catálogo contém o nome do fluxo de trabalho padrão que é executado quando um usuário envia uma solicitação. O novo fluxo de trabalho padrão para a versão 7.6 é PMSC_SR4. Clique no ícone próximo ao campo para visualizar os fluxos de trabalho padrão disponíveis e escolha o que deseja usar. 4. Teste algumas ofertas para verificar se você vê os resultados esperados. 90 IBM Control Desk: Guia de Upgrade Capítulo 17. Resolução de Problemas Se houver erros durante o processo de upgrade, pode ser necessário usar ferramentas e processos de resolução de problemas para que seja possível retomar o upgrade. Mensagens do verificador de integridade Este apêndice lista, em ordem numérica, as mensagens de erro e de aviso associadas ao verificador de integridade. Para cada mensagem são listadas a causa e uma ação para corrigir o problema. Mensagens informativas do verificador de integridade O objetivo das mensagens informativas é apenas informar. Elas não requerem nenhuma ação para continuar o processo de upgrade. INFORMATIONAL BMXAA0514I A definição de coluna está sendo reparada. INFORMATIONAL BMXAA0516I Todos os identificadores de linha nulos estão sendo preenchidos. INFORMATIONAL BMXAA0442I AVISO -- {0} INFORMATIONAL BMXAA7211I A tabela importada {0} contém uma coluna {1} que possui dados nativos compatíveis do tipo BIGINT. Mensagens de aviso do verificador de integridade As mensagens de aviso não impedem a aprovação bem-sucedida do utilitário verificador de integridade, mas é necessário investigar e corrigir as causas das mensagens de aviso. AVISO BMXAA0452W Estes usuários devem ser removidos das tabelas de segurança, pois não são usuários do banco de dados: AVISO BMXAA0454W Os seguintes Grupos de Segurança não possuem Usuários. Isto é apenas informativo, não é necessário executar nenhuma ação: © Copyright IBM Corp. 1994, 2015 91 AVISO BMXAA0460W Algumas mudanças feitas no banco de dados não foram aplicadas. Assegure-se de que as mudanças sejam aplicadas no aplicativo de Configuração do Banco de Dados. AVISO BMXAA0461W Os índices originais a seguir estão ausentes. Acesse o aplicativo de Configuração do Banco de Dados e redefina os índices ausentes. Causa Índices que foram definidos anteriormente estão ausentes. AVISO BMXAA0463W O banco de dados possui uma propriedade CLUSTERED diferente para a(s) seguinte(s) definição(ões) de índice(s) original(is): AVISO BMXAA0469W Nenhum índice exclusivo foi localizado para a sequência de chave primária na tabela. Determine se a tabela requer um índice para a sequência de coluna de chave primária. AVISO BMXAA0471W Não há nenhuma sequência de chave primária definida na tabela. Revise a tabela e decida se é necessário definir uma sequência de chave primária. AVISO BMXAA0473W Nenhum índice exclusivo foi localizado para o ID de coluna exclusivo nas tabelas. AVISO BMXAA0475W As seguintes tabelas de banco de dados do Maximo devem ser removidas do banco de dados, pois não existem no esquema: AVISO BMXAA0498W As colunas a seguir estão definidas para serem ’’same-as’’, mas possuem configurações must-be diferentes. Acesse o aplicativo de Configuração do Banco de Dados e corrija a incompatibilidade. Causa Há uma incompatibilidade entre os valores "must-be" para as colunas marcadas como "same-as" AVISO BMXAA0507W Este utilitário não pode reparar a coluna. Ele está definido como ’’Same As’’ em alguma outra coluna. AVISO BMXAA0508W Este utilitário não pode reparar a coluna, pois está definido como ’’Must Be’’. 92 IBM Control Desk: Guia de Upgrade AVISO BMXAA0509W Este utilitário não pode reparar a coluna. Ele é a coluna ’’Root’’ para outra coluna. AVISO BMXAA0510W Este utilitário não pode reparar a coluna. Ele não pode diminuir o tamanho de uma coluna. AVISO BMXAA0511W Este utilitário não pode reparar a coluna. Os dados existentes podem violar a definição. AVISO BMXAA0512W Este utilitário não pode reparar a coluna, pois há uma lista de valores associada a ela. O tipo de dados da lista de valores não corresponde ao tipo de dados da coluna raiz. AVISO BMXAA0519W As chaves automáticas a seguir devem ser removidas da tabela de sistema AUTOKEY pois não são referenciadas por uma coluna. AVISO BMXAA0520W Mais de um aplicativo está mapeado para a mesma posição em um módulo. AVISO BMXAA0521W Todos os aplicativos devem ser mapeados para uma tabela. Os aplicativos a seguir não estão mapeados. AVISO BMXAA0528W As tabelas de backup descritas a seguir existem. Se os dados foram restaurados e as tabelas não forem necessárias, elas devem ser excluídas. AVISO BMXAA0531W Esta coluna contém valores que não estão definidos no domínio, Coluna {0} Domínio {1}. Atualize os dados para sincronizá-los com o domínio ou com a lista de valores definida para a coluna. AVISO BMXAA0535W O domínio {0} está definido para ser o tipo de domínio {1}, mas não há valores no domínio {1}. AVISO BMXAA7114W O valor da escala definida para esta coluna é inválido. Acesse o aplicativo de Configuração do Banco de Dados e corrija os valores incompatíveis. Capítulo 17. Resolução de Problemas 93 AVISO BMXAA7113W O valor definido para o comprimento desta coluna é inválido. Acesse o aplicativo de Configuração do Banco de Dados e corrija a discrepância. AVISO BMXAA7115W As seguintes colunas persistentes do Maximo pertencem a tabelas não persistentes do Maximo: AVISO BMXAA7110W A sequência de chave primária na tabela não é sequencial. Revise a sequência de chave primária e assegure-se de que ela siga uma ordem sequencial e não contenha espaços. AVISO BMXAA7726W O ID de coluna exclusivo não possui o maxtype BIGINT nas seguintes tabelas: AVISO BMXAA7109W A coluna {0} está mapeada para o domínio {2}, mas não está definida da mesma maneira; {0} é {1}. {2} é {3}. Corrija os dados e tente novamente. AVISO BMXAA7112W A definição {0} é diferente de {1} para {2};{0}.{3}={4}{1}.{3}={5}. Use o aplicativo de Configuração do Banco de Dados para corrigir os metadados de configuração. AVISO BMXAA7253W Tipo de domínio não padrão localizado; dados não validados neste domínio. ID do Domínio = {0}, Tipo de Domínio = {1}. AVISO BMXAA6259W O Processo {0} contém um Subprocesso {1}, que possui um processo que cria um loop. Mensagens de erro do verificador de integridade A existência de erros impede a aprovação bem-sucedida do utilitário verificador de integridade. Todos os erros devem ser corrigidos. A seguir, há um subconjunto das possíveis mensagens de erro que podem surgir ao utilizar o verificador de integridade. ERRO BMXAA0333E Existem nomes de índices nativos com mais de 30 caracteres de comprimento. Antes de executar ConfigDB, identifique e renomeie manualmente esses índices nativos. Causa O banco de dados do Control Desk requer que os nomes do índice 94 IBM Control Desk: Guia de Upgrade possuam um comprimento máximo de 18 caracteres. A restrição foi ignorada no backend do banco de dados e criou-se um nome de índice contendo mais de 18 caracteres. Ação Qualquer índice cujo nome tenha mais de 18 caracteres deve ser eliminado do backend do banco de dados. Use um editor de SQL para eliminar o índice. Caso o índice seja necessário, é possível usar o aplicativo de Configuração do Banco de Dados para recriá-lo. Consulte o Guia de Referência Técnica para obter mais detalhes. Se precisar de ajuda adicional, entre em contato com seu administrador de banco de dados do Control Desk ou suporte IBM. ERRO BMXAA0451E Existem tabelas cujos dados de backup não foram restaurados. Execute RestoreFromBackup para poder executar Upgrade. Causa Quando as tabelas de banco de dados forem configuradas usando o aplicativo de Configuração do Banco de Dados, o Control Desk faz cópias de backup das tabelas, em seguida, aplica as mudanças nas tabelas originais. Após a conclusão desse processo, execute o novamente o aplicativo de Configuração do Banco de Dados e restaure os dados a partir das tabelas de backup. Se essa restauração de dados não for executada, o verificador de integridade para o processo com essa mensagem de erro, pois pode haver sérias implicações para o upgrade geral do banco de dados do Control Desk. Ação Para obter a aprovação do verificador de integridade, execute o aplicativo de Configuração do Banco de Dados e selecione a opção para a restauração a partir das tabelas de backup. Então, você terá a opção de manter ou eliminar as tabelas de backup após a restauração. Geralmente, recomenda-se eliminar as tabelas de backup, pois isso economiza o espaço em disco. No entanto, a eliminação das tabelas de backup não é obrigatória. Se precisar de ajuda adicional, entre em contato com o suporte IBM. ERRO BMXAA0453E Os grupos a seguir devem ser removidos do banco de dados, pois não possuem privilégios adequados definidos. Use o aplicativo de Grupos de Segurança para remover os grupos ou definir privilégios para eles. Causa Os grupos de usuários são armazenados centralmente em uma tabela do banco de dados do Control Desk denominada MAXGROUPS; os usuários são armazenados em MAXUSERGROUPS. Se uma entrada do usuário ou grupo não estiver presente nessas tabelas, isso poderá causar problemas ao usar o Control Desk. O banco de dados foi modificado por meio do backend e da consistência de dados entre essas tabelas e todas as outras tabelas de segurança do Control Desk foram comprometidas. Ação Execute o verificador de integridade no modo de reparo. ERRO BMXAA0455E Os usuários a seguir devem ser removidos, pois não estão autorizados. Para corrigir esse erro, execute o Verificador de Integridade no modo de reparo. Causa Os grupos de usuários são armazenados centralmente em uma tabela do banco de dados do Control Desk denominada MAXGROUPS; os usuários Capítulo 17. Resolução de Problemas 95 são armazenados em MAXUSERGROUPS. Se uma entrada do usuário ou grupo não estiver presente nessas tabelas, isso poderá causar problemas ao usar o Control Desk. O banco de dados foi modificado por meio do backend e da consistência de dados entre essas tabelas e todas as outras tabelas de segurança do Control Desk foram comprometidas. Ação Execute o verificador de integridade no modo de reparo. ERRO BMXAA0456E Os seguintes usuários devem ser removidos das tabelas de segurança, pois não são usuários válidos: {0}. Os dados para esses usuários estão na tabela GroupUser, mas não há registros-pai na tabela MaxUser. Para remover esses usuários, execute a Verificação de Integridade no modo de reparo. Causa Os grupos de usuários são armazenados centralmente em uma tabela do banco de dados do Control Desk denominada MAXGROUPS; os usuários são armazenados em MAXUSERGROUPS. Se uma entrada do usuário ou grupo não estiver presente nessas tabelas, isso poderá causar problemas ao usar o Control Desk. O banco de dados foi modificado por meio do backend e da consistência de dados entre essas tabelas e todas as outras tabelas de segurança do Control Desk foram comprometidas. Ação Execute o verificador de integridade no modo de reparo. ERRO BMXAA0458E Os grupos de usuários a seguir não foram localizados na tabela MAXGROUPS. Execute o Verificador de Integridade no modo de reparo. Causa Os grupos de usuários são armazenados centralmente em uma tabela do banco de dados do Control Desk denominada MAXGROUPS; os usuários são armazenados em MAXUSERGROUPS. Se uma entrada do usuário ou grupo não estiver presente nessas tabelas, isso poderá causar problemas ao usar o Control Desk. O banco de dados foi modificado por meio do backend e da consistência de dados entre essas tabelas e todas as outras tabelas de segurança do Control Desk foram comprometidas. Ação Execute o verificador de integridade no modo de reparo. ERRO BMXAA0459E Este grupo está definido como um usuário nas tabelas de segurança {0}. Um grupo de segurança também deve ser definido como um usuário. Execute o Verificador de Integridade no modo de reparo. Causa Os grupos de usuários são armazenados centralmente em uma tabela do banco de dados do Control Desk denominada MAXGROUPS; os usuários são armazenados em MAXUSERGROUPS. Se uma entrada do usuário ou grupo não estiver presente nessas tabelas, isso poderá causar problemas ao usar o Control Desk. O banco de dados foi modificado por meio do backend e da consistência de dados entre essas tabelas e todas as outras tabelas de segurança do Control Desk foram comprometidas. Ação 96 Execute o verificador de integridade no modo de reparo. IBM Control Desk: Guia de Upgrade ERRO BMXAA0462E O banco de dados possui uma propriedade UNIQUE diferente para as definições de índices originais a seguir. Use o aplicativo de Configuração do Banco de Dados para corrigir as definições de índices. Causa Diversos índices foram originalmente definidos no banco de dados do Control Desk para um melhor desempenho. Os índices originais foram modificados (provavelmente por meio do backend). Ação É possível melhorar potencialmente o desempenho do Control Desk recriando quaisquer índices exclusivos. ERRO BMXAA0470E A sequência de chave primária nas tabelas de banco de dados não é sequencial. Corrija os atributos usando o aplicativo de Configuração do Banco de Dados. Causa Toda a tabela do Control Desk deve possui uma sequência de colunas da chave primária, definida pelo MAXATTRIBUTE.PrimaryKeyColSeq. Os valores de PrimaryKeyColSeq devem ser consecutivos e sequenciais. Para essas tabelas, a sequência de chave primária não é consecutiva ou não é sequencial. Ação Para as definições dessas tabelas, verifique e, se necessário, ajuste os valores de PrimaryKeyColSeq em MAXATTRIBUTE e MAXATTRIBUTECFG. A sequência de chave primária deve ter um índice exclusivo correspondente. ERRO BMXAA0474E As tabelas a seguir devem ser removidas, pois não existem no banco de dados. Para remover essas tabelas, execute o Verificador de Integridade no modo de reparo. Causa Um ou mais nomes de tabela estão definidos como tabelas persistentes em MAXTABLE, mas não existem no banco de dados do Control Desk. Todas as tabelas de banco de dados do Control Desk devem ser definidas na tabela MAXTABLE. Elas também podem aparecer em outras tabelas do Control Desk, incluindo as seguintes tabelas: v AUTOKEY v MAXATTRIBUTE v MAXATTRIBUTECFG v MAXSYSINDEXES Ação Se você selecionou a opção de tempo de execução do modo de reparo e concluiu que a tabela é necessária, recrie a tabela. Use o backup, se disponível, para restaurar os dados na tabela. Se a tabela não for necessária, remova a entrada do nome da tabela de todas as tabelas do Control Desk listadas na seção Causa. Por exemplo, exclua-a de MAXTABLE, em que tbname = ‘.....'. Se você selecionar a opção de reparo, a entrada do nome da tabela e a entrada do aplicativo (se a entrada do nome da tabela for para um aplicativo customizado) serão removidas das tabelas em que estiverem Capítulo 17. Resolução de Problemas 97 listadas. No modo de reparo, não é possível manter essas entradas relevantes e restaurar a tabela a partir do backup. ERRO BMXAA0476E As tabelas a seguir possuem colunas, mas não estão definidas como tabelas. Execute o Verificador de Integridade no modo de reparo. Causa Uma entrada de nome de tabela foi localizada em MAXATTRIBUTE, mas a tabela não está definida na tabela MAXTABLE. Os nomes de todas as tabelas de bancos de dados do Control Desk devem ser inseridos na tabela MAXTABLE. Cada nome de tabela também aparece na tabela MAXATTRIBUTE, juntamente com os nomes de todas as colunas existentes nessa tabela. O nome da tabela também pode ser localizado em uma ou mais das seguintes tabelas: v AUTOKEY v MAXATTRIBUTECFG v MAXSYSINDEXES Ação Se você selecionou a opção de modo de relatório e a tabela existir no banco de dados, entre em contato com o suporte IBM. Se você selecionou a opção de modo de relatório e a tabela não existir no banco de dados, remova as entradas de nome da tabela de todas as tabelas do Control Desk listadas na seção Causa, incluindo MAXATTRIBUTE. Por exemplo, exclua * de MAXATTRIBUTE, em que tbname = ‘.....'. Se você selecionou a opção de reparo e a tabela existe no banco de dados, o problema não pode ser reparado automaticamente. Entre em contato com o Suporte da IBM. Se você selecionar a opção de reparo e a tabela não existir no banco de dados, a entrada de nome da tabela será removida de todas as tabelas do Control Desk listadas na seção Causa, incluindo MAXATTRIBUTE. ERRO BMXAA0477E Os objetos listados estão definidos como tabelas, mas não contêm colunas. Execute o modo de reparo para resolver o problema. Causa Um nome de tabela está ausente de MAXATTRIBUTE, embora o nome esteja presente na tabela MAXTABLE. Os nomes de todas as tabelas de bancos de dados do Control Desk devem ser inseridos na tabela MAXTABLE. Cada nome de tabela também aparece na tabela MAXATTRIBUTE, juntamente com os nomes de todas as colunas existentes nessa tabela. O nome da tabela também pode ser localizado em uma ou mais das seguintes tabelas: v AUTOKEY v MAXATTRIBUTECFG v MAXSYSINDEXES Ação Se você selecionou a opção de modo de relatório e a tabela existir no banco de dados, entre em contato com o suporte IBM. 98 IBM Control Desk: Guia de Upgrade Se você selecionou a opção de modo de relatório e a tabela não existir no banco de dados, você deve remover o nome da tabela de todas as tabelas do Control Desk listadas na seção Causa, incluindo a tabela MAXTABLE. Por exemplo: exclua * de MAXTABLE, em que tbname = ‘.....'. Se você selecionou a opção de reparo e a tabela existe no banco de dados, o problema não pode ser reparado automaticamente. Entre em contato com o Suporte da IBM. Se você selecionar a opção de reparo e a tabela não existir no banco de dados, a entrada de nome da tabela será removida de todas as tabelas do Control Desk listadas na seção Causa, incluindo MAXATTRIBUTE. ERRO BMXAA0478E O acionador ROWSTAMP não foi localizado para as seguintes tabelas: <table> Causa A tabela está ausente em um acionador identificador de linha. Isso pode ter sido causado pela instalação do gateway de integração. Ação Recrie o acionador ou execute o verificador de integridade no modo de reparo para fornecer automaticamente o acionador ausente. ERRO BMXAA0479E Descobriu-se que o acionador ROWSTAMP está DISABLED nas seguintes tabelas: <table> Causa O acionador identificador de linha foi desativado de forma intencional ou não intencional. Ação Reative o acionador. ERRO BMXAA0480E Nas tabelas a seguir foram localizadas linhas que possuem valores nulos para Rowstamp. Execute o Verificador de Integridade no modo de reparo. Causa Um identificador de linha é um identificador exclusivo para uma linha de dados. Ele nunca deve ser nulo. As tabelas listadas para esse erro contêm identificadores de linha nulos. Isso pode ter sido causado devido à transmissão do banco de dados em vários upgrades. Ação Atualize os identificadores de linha que estiverem nulos, designando a eles um valor exclusivo de identificador de linha. ERRO BMXAA0490E A coluna {0} deve ser removida, pois não existe no banco de dados. Para remover a coluna, execute o Verificador de Integridade no modo de reparo. Causa Existe uma incompatibilidade entre a definição de coluna no catálogo do sistema de banco de dados e o catálogo do Control Desk (a tabela MAXATTRIBUTE). Todas as colunas do Control Desk devem ser definidas como colunas no catálogo do sistema de banco de dados. Esta coluna não está definida no catálogo do sistema. Ação Capítulo 17. Resolução de Problemas 99 Se você selecionou a opção de modo de relatório, recrie a coluna no catálogo do sistema ou exclua todas as ocorrências da coluna nas tabelas MAXATTRIBUTE e MAXATTRIBUTECFG. Se necessário, entre em contato com o suporte IBM para corrigir essa situação. Se você selecionar a opção de reparo, todas as entradas desse nome de coluna serão removidas das tabelas MAXATTRIBUTE e MAXATTRIBUTECFG. Se a coluna for must-be, same-as (igual à coluna raiz) ou raiz (outras colunas são iguais a essa coluna), este problema não poderá ser reparado automaticamente. Entre em contato com o Suporte da IBM. ERRO BMXAA0493E As colunas a seguir devem ser removidas do banco de dados, pois não existem no esquema do produto. Use ConfigDB para incluir as colunas no esquema do produto ou descarte-as do banco de dados. Causa Uma coluna da tabela do Control Desk não possui uma entrada correspondente em MAXATTRIBUTE. Essa mensagem pode indicar que a tabela de banco de dados possui um problema que não pode ser corrigido automaticamente. Para que seja possível continuar, esse erro deve ser resolvido. Se, durante um upgrade, esse erro for ignorado, isso pode resultar em um upgrade com falha, o que pode impedir a execução adequada do aplicativo. Ação As colunas de tabela listadas devem ser manualmente inseridas ou excluídas da tabela MAXATTRIBUTE. Consulte a Guia de Referência Técnica e o seu guia da Linguagem SQL ou entre em contato com o suporte IBM. ERRO BMXAA0494E A definição dessa coluna não corresponde à coluna real. A definição de coluna nativa não corresponde aos metadados do servidor. Execute o Verificador de Integridade no modo de reparo. Causa Existe um incompatibilidade entre a definição de coluna no catálogo do sistema de banco de dados e o catálogo do Control Desk. Ação Determine qual definição de coluna está correta e redefina a definição de coluna incorreta, para que corresponda à correta. Se você não tiver certeza sobre qual definição está correta, entre em contato com o suporte IBM. A opção de modo de reparo do verificador de integridade modifica a definição de coluna do Control Desk para que ela corresponda à definição do banco de dados. Se a coluna for must-be, same-as (igual à coluna raiz) ou raiz (outras colunas são iguais a essa coluna), a incompatibilidade não será reparada. Nesse caso, você deve entrar em contato com o suporte IBM ou usar o aplicativo de Configuração do Banco de Dados para corrigir as definições de coluna incompatíveis. 100 IBM Control Desk: Guia de Upgrade ERRO BMXAA0495E A propriedade ’’nulable’’ dessa coluna não corresponde à definição de coluna real. Execute o Verificador de Integridade no modo de reparo. Causa Os valores NULLS da coluna do Control Desk são diferentes dos valores NULLS da coluna do sistema. Algumas colunas em um banco de dados do Control Desk podem ser nulas, o que significa que a coluna não possui nenhum valor. O valor NULLS de uma coluna define se essa coluna pode ser nula. Ação Se você selecionou a opção de modo de relatório, modifique manualmente o valor NULLS. Se um valor nulo for adequado para essa coluna, altere REQUIRED para 0 no banco de dados e em MAXATTRIBUTE. Caso essa coluna nunca deva ser nula, altere REQUIRED para 1 no banco de dados e em MAXATTRIBUTE. É possível fazer essa mudança por meio do backend do banco de dados. Se precisar de ajuda adicional, entre em contato com o suporte IBM. Se você selecionou a opção de reparo, a coluna na tabela MAXATTRIBUTE do Control Desk será modificada para corresponder à coluna na tabela de sistema. ERRO BMXAA0496E Esta coluna está definida para ser ’’same-as’’ em relação a uma coluna que não existe. Execute o Verificador de Integridade no modo de reparo. Causa Determinadas colunas nas tabelas de banco de dados do Control Desk devem ser iguais a - ser do mesmo tipo e tamanho - a outra coluna, denominada de coluna raiz. A coluna raiz e a coluna same-as devem ter o mesmo tipo de dados, comprimento e escala. A coluna indicada foi definida para ser igual a uma coluna raiz, mas essa coluna raiz não existe. Ação Redefina o relacionamento same-as para que ele especifique uma coluna raiz que existe no banco de dados do Control Desk. Talvez seja necessário incluir a coluna ausente na tabela de banco de dados base do Control Desk. Se necessário, entre em contato com o suporte IBM. ERRO BMXAA0497E As colunas a seguir estão definidas para serem ’’same-as’’, mas possuem definições diferentes para <table.column> <table.column> Causa Determinadas colunas nas tabelas de banco de dados do Control Desk devem ser iguais a - ser do mesmo tipo e tamanho - a outra coluna, denominada de coluna raiz. A coluna raiz e a coluna same-as devem ter o mesmo tipo de dados, comprimento e escala. Esse relacionamento same-as foi rompido pela modificação da definição de uma das colunas. Ação Se você selecionou a opção de modo de relatório, entre em contato com o suporte IBM para reparar o erro. Se você selecionar o modo de reparo e o tipo de dados não for correspondente, o modo de reparo alterará o tipo de dados da coluna Capítulo 17. Resolução de Problemas 101 same-as, para que corresponda ao tipo de dados da coluna raiz. Execute o aplicativo de Configuração do Banco de Dados do Control Desk para que as mudanças entrem em vigor. Em seguida, execute novamente o utilitário verificador de integridade. Observe as seguintes limitações: v Se a coluna same-as estiver configurada como must-be, ela não poderá ser reparada pelo modo de reparo. Entre em contato com o Suporte da IBM. v Se a coluna same-as tiver uma lista de valores associada a ela, e o tipo de dados da lista de valores não corresponder ao tipo de dados de coluna raiz, e o tipo de lista de valores é 3 ou 4 (lista de valores definidos de Control Desk) e a versão de liberação do Control Desk é 4.0 ou superior, esse erro não pode ser reparado pelo modo de reparo. Entre em contato com o Suporte da IBM. v Se houver um domínio associado à coluna same-as e o tipo de dados do domínio não corresponder ao tipo de dados da coluna de raiz, esse erro não poderá ser reparado pelo modo de reparo. Entre em contato com o Suporte da IBM. Se o comprimento não for correspondente, o modo de reparo comparará todas as colunas que são iguais à coluna raiz. O modo de reparo alterará os comprimentos das colunas para que correspondam ao da coluna mais longa. Esse resultado evita a perda de dados do usuário e mantém o relacionamento same-as. Execute o aplicativo de Configuração do Banco de Dados do Control Desk para que as mudanças entrem em vigor, em seguida, execute novamente o verificador de integridade. ERRO BMXAA0513E Esta coluna é uma coluna raiz e está vinculada como same-as a outra coluna. Use o aplicativo de Configuração do Banco de Dados para alterar o filho same-as da coluna, para que o pai same-as do filho seja igual a esse pai same-as da coluna. Causa Uma coluna que é referenciada como uma coluna raiz em um relacionamento same-as está se referindo a outra coluna como a coluna raiz em um relacionamento same-as. Pode existir apenas uma referência same-as entre as colunas. Ação Execute o verificador de integridade no modo de reparo para resolver a existência de vários relacionamentos same-as entre as colunas. ERRO BMXAA0527E Os grupos de segurança a seguir não possuem privilégios nas tabelas de segurança. Remova os grupos de segurança ou execute o Verificador de Integridade no modo de reparo. Causa Os grupos de usuários são armazenados centralmente em uma tabela do banco de dados do Control Desk denominada MAXGROUPS; os usuários são armazenados em MAXUSERGROUPS. Se uma entrada do usuário ou grupo não estiver presente nessas tabelas, isso poderá causar problemas ao usar o Control Desk. O banco de dados foi modificado por meio do backend e da consistência de dados entre essas tabelas e todas as outras tabelas de segurança do Control Desk foram comprometidas. Ação 102 Execute o verificador de integridade no modo de reparo. IBM Control Desk: Guia de Upgrade ERRO BMXAA0328E O nome da classe na coluna de código de idioma não está correto: Atributo {0} Classe {1} Causa Foi especificado o nome de classe incorreto para a coluna de código de idioma. Ação Use o aplicativo de Configuração do Banco de Dados para especificar o nome de classe correto, por exemplo, psdi.app.system.FldLangCode. ERRO BMXAA0329E A tabela maxviewcolumncfg contém uma linha que não possui uma coluna correspondente na tabela maxviewcolumn. Visualização {0} Coluna {1}. Se houver mudanças pendentes na configuração do banco de dados, execute o utilitário ConfigDB. Se não houver mudanças de configuração pendentes, exclua essa linha da tabela maxviewcolumn, usando um utilitário SQL. Causa Existe uma linha na tabela maxviewcolumncfg, mas não há uma linha correspondente em maxviewcolumn. O parâmetro {0} é o nome da Visualização e o parâmetro {1} é o nome da coluna. Ação Se houver mudanças pendentes na configuração do banco de dados, execute o utilitário ConfigDB. Se não houver mudanças de configuração pendentes, exclua essa linha da tabela maxviewcolumn, usando um utilitário SQL. ERRO BMXAA0430E O nome do usuário {0} não pôde ser excluído da tabela MAXUSERGROUPS ou GROUPUSER. Tente a operação novamente ou exclua o nome do usuário manualmente. ERRO BMXAA0431E O nome do grupo {0} não pôde ser excluído da tabela MAXGROUP ou MAXGROUPS. Tente a operação novamente ou exclua o nome do grupo manualmente. ERRO BMXAA0432E Os dados relacionados à segurança para o nome de usuário {0} não puderam ser excluídos. Tente a operação novamente ou exclua os dados relacionados à segurança manualmente. ERRO BMXAA0433E Os dados relacionados ao grupo de segurança para o nome de grupo {0} não puderam ser excluídos. Tente a operação novamente ou exclua os dados relacionados à segurança do grupo manualmente. ERRO BMXAA0440E É necessário especificar a Verificação de Integridade (-i) ou a Validação (-v) Capítulo 17. Resolução de Problemas 103 ERRO BMXAA0441E Ocorreu o seguinte erro de SQL: {0} {1}. ERRO BMXAA0443E Erro - {0} ERRO BMXAA0444E Não foi possível inserir a maxvar INTEGRITYCHECK no banco de dados. Causa O verificador de integridade localizou erros, mas não pôde inserir a maxvar INTEGRITYCHECK com um valor FAIL. ERRO BMXAA0445E A versão do banco de dados {0} não foi reconhecida. O registro de versão em maxvars para a varname MAXUPG deve ter o formato Vnnn[-mmm], em que nnn é a versão do banco de dados (por exemplo, 7116) e -mmm é uma construção ou correção opcional. ERRO BMXAA0464E Os nomes das entidades de tabela e coluna não correspondem para {0}. O valor de MaxAttribute.EntityName é {1}. O valor de MaxObject.EntityName é {2}. Corrija o nome da entidade da coluna, usando o aplicativo de Configuração do Banco de Dados. Causa Existe uma discrepância entre os nomes das entidades na tabela MaxAttribute e na tabela MaxObject. Os nomes das entidades devem ser iguais em ambas as tabelas. ERRO BMXAA0465E Os índices a seguir estão ausentes do banco de dados. Use o aplicativo de Configuração do Banco de Dados para remover a definição de índice. Causa Há alguns índices definidos nos metadados, mas o índice real não existe no banco de dados. Ação Use o aplicativo de Configuração do Banco de Dados para remover a definição de índice. ERRO BMXAA0467E O banco de dados possui uma propriedade UNIQUE diferente para os índices a seguir. Use o aplicativo de Configuração do Banco de Dados para redefinir o índice. Causa A propriedade UNIQUE definida nos metadados não corresponde à propriedade UNIQUE contida no banco de dados. Esses valores de propriedades devem ser correspondentes. Ação 104 Use o aplicativo de Configuração do Banco de Dados para redefinir o índice. IBM Control Desk: Guia de Upgrade ERRO BMXAA0468E O banco de dados possui uma propriedade CLUSTERED diferente para os índices a seguir. Use o aplicativo de Configuração do Banco de Dados para redefinir o índice. Causa A propriedade CLUSTERED definida nos metadados não corresponde à propriedade CLUSTERED real definida no banco de dados. Esses valores de propriedades devem ser correspondentes. Ação Use o aplicativo de Configuração do Banco de Dados para redefinir o índice. ERRO BMXAA0472E É necessário definir um ID de coluna exclusivo para a(s) tabela(s): ERRO BMXAA0491E As colunas persistentes a seguir pertencem a tabelas não persistentes. As tabelas não persistentes podem conter apenas atributos não persistentes. Para corrigir esse erro, execute o Verificador de Integridade no modo de reparo. ERRO BMXAA0500E O comprimento definido para essa coluna está incorreto. Altere o tipo de dados da coluna para DECIMAL ou altere seu comprimento para que corresponda ao comprimento de AMOUNT. Causa O tipo de dados maxtype dessa coluna é AMOUNT, mas seu comprimento é diferente do comprimento de Quantia padrão definido pela maxvar AMTLENGTH. ERRO BMXAA0501E A escala dessa coluna é inválida. Se o maxtype da coluna for AMOUNT, a escala deve ser igual à maxvar AMTSCALE; caso contrário, a escala deve ser 0. Causa O tipo de dados maxtype da coluna requer uma escala zero ou a coluna possui o maxtype AMOUNT e sua escala não é igual ao valor definido no maxvar AMTSCALE. Ação Corrija a definição de escala. O modo de reparo do Verificador de Integridade não corrige esse erro. ERRO BMXAA0506E A verificação de integridade falhou. Consulte o log para obter uma lista de erros detalhada. ERRO BMXAA0530E A coluna {0} está mapeada para o domínio {1}, mas o domínio não existe. Configure o domínio do atributo com um valor diferente, usando o aplicativo de Configuração do Banco de Dados, ou defina o domínio, usando o aplicativo de Domínios. Capítulo 17. Resolução de Problemas 105 Causa A coluna especificada no parâmetro 0 possui um domínio (especificado no parâmetro 1) definido em relação a ela, mas o domínio em si não existe. Ação Configure o domínio do atributo com um valor diferente, usando o aplicativo de Configuração do Banco de Dados, ou defina o domínio, usando o aplicativo de Domínios. ERRO BMXAA0532E A coluna {0} está mapeada para o domínio {2}, mas não está definida da mesma forma. {0} é {1}. {2} é {3}. Altere o atributo, usando o aplicativo de Configuração do Banco de Dados, ou altere o domínio, usando o aplicativo de Domínios. Causa O tipo de dados, o comprimento e a escala do atributo são inconsistentes com o tipo de dados, o comprimento e a escala do domínio. Ação Altere o atributo, usando o aplicativo de Configuração do Banco de Dados, ou altere o domínio, usando o aplicativo de Domínios. ERRO BMXAA0534E Um domínio do tipo {0} deve ter um tipo de dados e um comprimento válidos. O Domínio {1} possui um maxtype {2} e um comprimento {3}. ERRO BMXAA0537E A definição de {0} é diferente de {1} para {2}.,{0}.{3}={4}{1}.{3}={5}. Use o aplicativo de Configuração do Banco de Dados para corrigir os metadados de configuração. Causa Os metadados de configuração pendentes (MaxObjectCfg, MaxTableCfg, MaxAttributeCfg) não correspondem aos metadados ativos (MaxObject, MaxTable, MaxAttribute). Ação Use o aplicativo de Configuração do Banco de Dados para corrigir os metadados de configuração. ERRO BMXAA0538E Esta coluna está mapeada para uma Chave Automática, mas a Chave Automática não existe. Coluna {0} Chave Automática {1}. Execute o Verificador de Integridade no modo de reparo. Causa A coluna especificada no parâmetro 0 está mapeada para uma Chave Automática (especificada no parâmetro 1), mas a Chave Automática em si não existe. Ação Execute o Verificador de Integridade no modo de reparo. ERRO BMXAA6233E Os seguintes índices obrigatórios do Maximo estão ausentes do Maximo: ERRO BMXAA6238E Essas visualizações devem ser removidas, pois não existem no banco de dados. Remova essas visualizações usando o aplicativo de Configuração do Banco de Dados. 106 IBM Control Desk: Guia de Upgrade ERRO BMXAA6284E Essas visualizações devem ser eliminadas do banco de dados, pois não existem no esquema do produto: ERRO BMXAA4191E O valor {1} não é válido para {0}. Especifique um valor válido para {0}. ERRO BMXAA4195E O campo {0} requer um valor. ERRO BMXAA6290E O Tipo de Procura deve ser WILDCARD para os atributos em que SEARCHTYPE é TEXT, mas TEXTSEARCHENABLED é FALSE. Execute o modo de reparo para corrigir. ERRO BMXAA6286E O Tipo de Procura deve ser NONE para atributos que são não persistentes, CRYPTO ou BLOB. Execute o modo de reparo para corrigir. ERRO BMXAA6287E O Tipo de Procura deve ser TEXT para atributos de descrição detalhada que são não persistentes, CRYPTO ou BLOB. Execute o modo de reparo para corrigir. ERRO BMXAA6288E O Tipo de Procura deve ser EXACT ou NONE para atributos numéricos, de data/hora e YORN. Execute o modo de reparo para corrigir. ERRO BMXAA6289E O Tipo de Procura deve ser TEXT para atributos de descrição detalhada que não estão em tabelas de auditoria. Execute o modo de reparo para corrigir. ERRO BMXAA6315E A procura de texto nativa não está ativada para os atributos a seguir, mesmo que eles tenham o tipo de procura TEXT. ERRO BMXAA6234E A coluna {0} não é suficientemente grande para os valores definidos no domínio {1}. Aumente o comprimento da coluna, usando o aplicativo de Configuração do Banco de Dados. ERRO BMXAA6293E As chaves automáticas do nível de organização mostradas a seguir estão ausentes da tabela AUTOKEY. Execute o modo de reparo para corrigir. Capítulo 17. Resolução de Problemas 107 ERRO BMXAA4116E O tipo de Maxvar não é válido. Ele não foi especificado ou não é "SYSTEM", "ORG" ou "SITE". Atualize a tabela de MAXVAR, assegurando-se de que a MAXVAR especificada seja do nível de maxvar SYSTEM, ORG ou SITE. ERRO BMXAA4168E Organização e Site devem ficar em branco, porque o objeto MAXVAR está no nível do sistema. Remova os valores de Organização e Site ERRO BMXAA4166E O campo Site deve ficar vazio. Esse registro deve ter um site vazio, porque o objeto MAXVAR está no nível da organização. Remova o valor do Site. ERRO BMXAA4167E A Organização deve ficar em branco. ERRO BMXAA0504E A verificação de integridade foi aprovada com avisos. ERRO BMXAA0505E A verificação de integridade foi aprovada. ERRO BMXAA6283E Não é possível incluir Maxrelationship, pois ele já existe no banco de dados: ERRO BMXAA6328E O upgrade não pode incluir novos aplicativos, pois eles já existem em MaxApps: ERRO BMXAA0437E Validar -- Verificação e reparo de integridade solicitados. ERRO BMXAA6292E Existem registros na tabela Wogen que precisam ser excluídos. Execute o modo de reparo para excluir registros da tabela. ERRO BMXAA4169E Nenhum registro localizado na tabela de maxvars para a maxvar {0}. ERRO BMXAA0687E O Nome da Entidade deve ser especificado quando o objeto for persistente. 108 IBM Control Desk: Guia de Upgrade ERRO BMXAA0689E Este objeto é uma visualização, mas o Objeto de Extensão não foi especificado. ERRO BMXAA5617E Quando a procura de texto for ativada, deve-se especificar um nome de coluna de idioma. ERRO BMXAA0686E Este objeto é ativado por auditoria, mas o nome da tabela de auditoria não foi especificado. ERRO BMXAA0692E Quando a Seleção Automática não estiver selecionada, deve-se inserir um valor para Visualizar De. ERRO BMXAA0693E Quando a Seleção Automática não estiver selecionada, deve-se inserir um valor para Selecionar Visualização. ERRO BMXAA0582E Quando um objeto é sinalizado para a procura de texto, pelo menos um atributo deve ser sinalizado para a procura de texto. ERRO BMXAA0688E O Nome da Entidade e o Nome da Coluna devem ser especificados quando o atributo for persistente. ERRO BMXAA0700E A Tabela Same As e a Coluna Same As devem ser ambas nulas ou não nulas. ERRO BMXAA0680E A coluna do idioma deve ter um tipo de dados UPPER e um comprimento de 4. ERRO BMXAA0600E O valor padrão para o atributo {0} indica a numeração automática, mas o nome da numeração automática está em branco. ERRO BMXAA5613E O valor padrão para o atributo {0} indica o sequenciamento, mas o nome da sequência está em branco. ERRO BMXAA0708E O Nome da Sequência não pode ser nulo para a coluna de ID exclusiva. Capítulo 17. Resolução de Problemas 109 ERRO BMXAA8088E O Objeto de Extensões deve ser nulo se o objeto não for uma visualização. ERRO BMXAA7946E A coluna {1} da tabela {0} foi definida como {2}, mas não está definida corretamente na tabela de banco de dados. ERRO BMXAA8269E Registro de revisão ausente para o Processo {0} chamado pelo processo principal {1}. Efetuando bypass de requisito de DNS do Control Desk versão 7.6 durante a instalação Ao executar o programa de instalação da versão 7.6, o comando <nome completo do host> é executado para verificar se o sistema usa um nome completo do host. O comando requer um servidor DNS ativo. Sobre Esta Tarefa Se o computador que está sendo usado não tiver um servidor DNS ativo, será possível remover esse requisito configurando o parâmetro BYPASS_PRS como true, conforme descrito nas etapas seguintes. Procedimento 1. Execute os seguintes scripts de instalação no computador: yum -y install ksh yum -y install libstdc++.i686 yum -y install libstdc++.x86_64 yum -y install compat-libstdc++-33.x86_64 yum -y install compat-libstdc++-33.i686 2. Após a instalação, no computador a partir do qual planeja executar o instalador do IBM Control Desk, execute os seguintes comandos: ulimit -n 8192 ulimit -f unlimited export BYPASS_PRS=True Reinicialização de updatedb Reinicialização do comando updatedb após uma falha de configuração. A ferramenta de configuração do Control Desk versão 7.6 executa o comando updatedb durante o processo de configuração. O comando updatedb executa tarefas de atualização do banco de dados durante um upgrade. Esse comando mantém um registro de qual foi a última instrução de atualização do banco de dados bem-sucedida. Se houver uma falha durante a configuração, é possível corrigir o erro, reiniciar a ferramenta de configuração e continuar a partir da última tarefa concluída com êxito. 110 IBM Control Desk: Guia de Upgrade Ao modificar um arquivo de mudança do banco de dados para corrigir um problema, pode ser necessário executar a ferramenta de configuração para executar novamente todas as tarefas de atualização do banco de dados, em vez de apenas continuar. Por exemplo, se uma nova instrução for incluída antes da última instrução bem-sucedida, updatedb pode não ser capaz de retomar a configuração com êxito. Nesse cenário, use os comandos SQL a seguir para limpar as variáveis usadas para identificar a última instrução bem-sucedida antes da reinicialização da ferramenta de configuração. delete from maxvars where varname in (’BMXLASTATEMENT’,’BMXLGFFLINE’) delete from maxvartype where varname in (’BMXLASTATEMENT’,’BMXLGFFLINE’) Erro de validação CTGIN5398E Ao fazer upgrade de uma implementação do Control Desk que utiliza Oracle, é possível encontrar um erro de validação do banco de dados. Durante a fase de configuração do upgrade, é possível encontrar um erro CTGIN5398E durante a validação do banco de dados Oracle. CTGIN5398E:Unable to connect to the database. The userid your_user_name and password combination were not accepted by the database system. Se ocorrer durante a validação, esta mensagem de erro pode ser ignorada com segurança, se a validação for concluída com êxito com a seguinte mensagem. Apply Deployment Operations-Database parameter validation successful. Se o erro ocorrer e a validação não for concluída com êxito, assegure-se de que as credenciais inseridas estão corretas e o servidor de banco de dados esteja disponível antes de tentar novamente a operação. Incluindo a fila intjmsacterr para IBM Control Desk Ao fazer upgrade para IBM Control Desk, inclua a fila intjmsacterr. Essa fila é necessária para IBM Control Desk 7.6. Sobre Esta Tarefa Conclua as etapas a seguir para criar o intjmsacterr manualmente. Procedimento 1. Efetue login para o console do WebSphere Application Server: https://<hostname>:9043/ibm/console 2. No painel à esquerda, selecione Recursos > JMS > Especificações de ativação. 3. Selecionar escopo: Node =ctgNode01, Server=MXServer. 4. Selecione "Novo" [x] Provedor de sistemas de mensagens [ok]. 5. Nos campos Nome e JNDI, insira intjmsacterr. 6. 7. 8. 9. No campo Tipo de destino, insira jms/maximo/int/queues/cqinerr. Selecione barramento e especifique intjmsbus no campo Nome do barramento. Use os valores WebSphere Application Server padrão nos campos restantes. Clique em Aplicar e salve as mudanças. Capítulo 17. Resolução de Problemas 111 112 IBM Control Desk: Guia de Upgrade Índice Remissivo A arquivo ccmdb.properties 77 arquivo fusion.properties 77 atualizar antes de começar 13 desempenho 18 migração da configuração do WebSphere 45 tarefas pós-upgrade 81 usando o Oracle WebLogic Server visão geral 13 colocação 18 comando tar AIX 30 CTGIN5398E 111 customizações migrar 41, 57, 68 O OSLC 61 87 P R roteiros de implementação D dados de middleware migração 38, 54, 65 desempenho Integration Composer diretório global 23 15 S 77 E encadeamento WebSphere Application Server Network Deployment v8.5.5 instalando 36, 49 permissões 30 portlet 29 Primavera 26 Processamento de terminais de tabelas de interface 22 processamento do Canal de Publicação 22 C Serviços da web 20 servidores WebSphere Application Server Network Deployment preparando a configuração do Maximo Asset Management 37 sistema de arquivos 23 77 T F filas JMS Maximo Asset Management (continuação) instalando a versão 7.6 39, 55, 66 Maximo Integration Framework 20 modo de compatibilidade 30 Tivoli Integration Composer atualizar 73 21 I U instalação Tivoli Integration Composer 73 Integration Composer instalando com o pacote de instalação de soluções de processos 74 sistemas não Windows 74 updatedb reinicialização 110 Upgrade manual de mensagens L latência de rede 26 V verificador de integridade 34, 43, 48, 59, 63, 70 verificando a instalação programaticamente 81 18 M Maximo Asset Management configurando com o programa de configuração do Maximo Asset Management 42, 58, 69 © Copyright IBM Corp. 1994, 2015 W WebSphere Application Manager migração de informações de configuração 51 113 114 IBM Control Desk: Guia de Upgrade Comentários do Leitor IBM Control Desk Guia de Upgrade Versão 7 Release 6 Publicação Nº BA21-8475-00 Neste formulário, faça-nos saber sua opinião sobre este manual. Utilize-o se encontrar algum erro, ou se quiser externar qualquer opinião a respeito (tal como organização, assunto, aparência...) ou fazer sugestões para melhorá-lo. Para pedir publicações extras, fazer perguntas ou tecer comentários sobre as funções de produtos ou sistemas IBM, fale com o seu representante IBM. Quando você envia seus comentários, concede direitos, não exclusivos, à IBM para usá-los ou distribuí-los da maneira que achar conveniente, sem que isso implique em qualquer compromisso ou obrigação para com você. Não se esqueça de preencher seu nome e seu endereço abaixo, se deseja resposta. Comentários: Nome Companhia ou Empresa Telefone Endereço Comentários do Leitor BA21-8475-00 IBM ATTN: Dept 542 3905 37th Street NW Rochester, MN USA BA21-8475-00 Número da Peça: 99F1234 Número do Programa: 1234-SS1 BA21-8475-00 (1P) P/N: 99F1234 Impresso no Brasil