Resolução de Problemas da Instalação

Como resolver o problema de uma instalação sem êxito do WebSphere Process Server.

Por Que e Quando Desempenhar Esta Tarefa

Utilize este tópico para diagnosticar possíveis problemas quando a instalação não é bem-sucedida. O programa instalador registra os seguintes indicadores de êxito no final do arquivo de registro primário, que pode ser localizado em install_root/logs/wbi/log.txt nas plataformas Linux e UNIX ou em install_root\logs\wbi\log.txt nas plataformas Windows: Se o resultado for INSTCONFPARTIALSUCCESS ou INSTCONFFAILED, continue a analisar o problema seguindo estas etapas.

Etapas para Esta Tarefa

  1. O processo de instalação pode exibir mensagens de erro.

    Consulte o tópico a seguir para obter uma explicação: Mensagens de Erro: Instalação e Criação e Aprimoramento de Perfil. Se a mensagem corresponde a qualquer uma das descritas, corrija o problema, limpe as partes instaladas e tente a reinstalação.

    Para obter detalhes sobre como desinstalar as partes instaladas antes de reinstalar, consulte Preparando para a Reinstalação após uma Desinstalação em Falha.

  2. Determine se a instalação do WebSphere Application Server Network Deployment foi bem-sucedida. (Se ela foi mal-sucedida e o WebSphere Application Server Network Deployment foi instalado como parte da instalação do WebSphere Process Server, o processo de instalação não continuará e uma mensagem de erro será exibida.) Se a instalação do WebSphere Process Server não tiver sido bem-sucedida, primeiro verifique install_root/logs/log.txt, nas plataformas Linux e UNIX, ou install_root\logs\log.txt, nas plataformas Windows, a ocorrência de erros para determinar se a instalação do WebSphere Application Network Deployment foi bem-sucedida.

    Se a instalação do WebSphere Application Server Network Deployment falhou, consulte o tópico Resolução de Problemas da Instalação no centro de informações do WebSphere Application Server Network Deployment, versão 6.0, e utilize as informações localizadas lá para corrigir os problemas antes de tentar reinstalar o WebSphere Process Server.

    Se a instalação do WebSphere Application Server Network Deployment tiver sido bem-sucedida e a instalação do WebSphere Process Server tiver falhado, utilize as informações de resolução de problemas abaixo para corrigir os problemas.

  3. Verifique nos arquivos de registro da instalação do WebSphere Process Server a ocorrência de erros após a instalação.

    Consulte Arquivos de Log para obter os nomes, locais e descrições dos vários arquivos de log criados.

    Verifique os arquivos de registro nesta seqüência:

    Ícone indicando plataformas Linux Ícone indicando plataformas UNIX Nas plataformas Linux e UNIX:
    1. install_root/logs/wbi
    2. %tmp% se nenhum arquivo for localizado em install_root/logs/wbi
    3. install_root/logs/wasprofile/wasprofile_create_ profile_name.log ou install_root/logs/wasprofile/wasprofile_augment_ profile_name.log. Se você tiver executado uma instalação Completa, que cria um servidor independente denominado default, o valor para profile_name será default.
    4. Quaisquer arquivos de registro ou de rastreio gerados pelas ações de instalação. Procure no install_root/logs/wbi os arquivos de rastreio gerados durante o processo de instalação (ou desinstalação). Procure em profile_root/logs aqueles gerados pela criação ou alteração do perfil, em que profile_root representa o local da instalação do perfil do WebSphere Process Server (por padrão, install_root/profiles/profile_name nas plataformas Linux e UNIX). Esses arquivos são direcionados principalmente para utilização pelo suporte técnico da IBM.
    Ícone indicando plataformas Windows Nas plataformas Windows:
    1. install_root\logs\wbi
    2. %tmp% se nenhum arquivo for localizado em install_root\logs\wbi
    3. install_root\logs\wasprofile\wasprofile_create_ profile_name.log ou install_root\logs\wasprofile\wasprofile_augment_ profile_name.log. Se você tiver executado uma instalação Completa, que cria um servidor independente denominado default, o valor para profile_name será default.
    4. Quaisquer arquivos de registro adicionais gerados pelas ações de instalação. Procure no install_root\logs\wbi os arquivos de rastreio gerados durante o processo de instalação (ou desinstalação). Procure em profile_root\logs aqueles gerados pela criação ou alteração do perfil, em que profile_root representa o local da instalação do perfil do WebSphere Process Server (por padrão, install_root\profiles\profile_name nas plataformas Windows). Esses arquivos são direcionados principalmente para utilização pelo suporte técnico da IBM.
  4. Se não houver nenhuma informação nos registros de instalação, utilize o parâmetro -log com um arquivo de resposta.
    Determinados eventos (como não ter espaço suficiente em disco) podem impedir que o ISMP (InstallShield para Multiplataformas) inicie o Assistente de Instalação. Se sua instalação falhar e não houver nenhuma informação nos logs de instalação, utilize o parâmetro -log com um arquivo de resposta para registrar entradas para eventos que fazem com que o programa ISMP falhe em iniciar o Assistente de Instalação. Isso funcionará com qualquer um dos arquivos de resposta a seguir:
    • responsefile.wps.txt
    • responsefile.pcaw.standAloneProfile.txt
    • responsefile.pcaw.dmgrProfile.txt
    • responsefile.pcaw.managedProfile.txt

    Para obter informações adicionais sobre os arquivos de resposta, consulte Instalando Silenciosamente o WebSphere Process Server ou o Cliente.

    Será necessário copiar um arquivo de resposta do CD 1 do WebSphere Process Server para sua unidade de disco rígido do sistema para utilizá-lo. A sintaxe do comando install para registrar tais eventos é a dos exemplos a seguir (seus caminhos para o arquivo de resposta e o arquivo de registro, além do nome real do arquivo de resposta podem diferir):

    Ícone indicando plataformas AIX Nas Plataformas AIX:
    install -options "/usr/IBM/WebSphere/silentFiles/myresponsefile.txt"
            -silent -log # !/usr/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    Ícone indicando plataformas HP-UX Ícone indicando plataformas Solaris Nas plataformas HP-UX e Solaris:
    install -options "/opt/IBM/WebSphere/silentFiles/myresponsefile.txt"
            -silent -log # !/opt/IBM/WebSphere/myOptionFiles/log.txt  @ALL
    Ícone indicando plataformas Linux Nas plataformas Linux:
    install -options "/opt/ibm/WebSphere/silentFiles/myresponsefile.txt"
            -silent -log # !/opt/ibm/WebSphere/myOptionFiles/log.txt  @ALL
    Ícone indicando plataformas Windows Nas plataformas Windows:
    install.exe -options
                "C:\Arquivos de Programas\IBM\WebSphere\silentFiles
                \myresponsefile.txt"
                -silent -log #
                !C:\Arquivos de Programas\IBM\WebSphere\silentFiles\log.txt
                 @ALL
  5. Determine se o problema de instalação é causado por um script de configuração que falhou.

    O arquivo install_root/logs/wbi/instconfig.log nas plataformas Linux e UNIX ou o arquivo install_root\logs\wbi\instconfig.log nas plataformas Windows indica problemas de configuração que podem evitar que o produto funcione corretamente. Procure na cadeia action failed para localizar o nome do script de configuração que falhou.

  6. Verifique se não existem arquivos no diretório install_root/classes.

    O Suporte IBM às vezes coloca em fila o trabalho para clientes e fornece correções de depuração ou testes. Um local comum para as correções é no diretório install_root/classes.

    Por padrão, o diretório install_root/classes é escolhido primeiro no caminho de classe do WebSphere Process Server para que substitua outras classes.

    Colocar uma correção no diretório permite verificar se a correção realmente soluciona seu problema. Após verificar se a correção soluciona o problema, você deve excluir a correção do diretório install_root/classes para retornar o sistema a um estado de funcionamento.

    Se você não remover tais correções do diretório install_root/classes, poderão ocorrer erros.

  7. Desinstale o produto, limpe os arquivos de registro ou outros artefatos deixados para trás e reinstale após ativar o rastreio se os registros de erros não contiverem informações suficientes para determinar a causa do problema.
    • Reporte os logs stdout e stderr para a janela do console, incluindo o parâmetro -is:javaconsole no comando install:
      • Ícone indicando plataformas Linux Ícone indicando plataformas UNIX Nas plataformas Linux e UNIX:
        install -is:javaconsole
        Capture o fluxo em um arquivo com os seguintes comandos:
        install -is:javaconsole > captureFileName.txt 2>&1
      • Ícone indicando plataformas Windows Nas plataformas Windows:
        install.exe -is:javaconsole
        Capture o fluxo em um arquivo com os seguintes comandos:
        install.exe -is:javaconsole > drive:\captureFileName.txt
    • Capture informações adicionais em um log de sua escolha com a opção -is:log file_name.
    • Ative o registro de instalação adicional transmitindo o parâmetro -W Setup.product.install.logAllEvents="true" ao comando install:
      • Ícone indicando plataformas Linux Ícone indicando plataformas UNIX Nas plataformas Linux e UNIX:
        install -W Setup.product.install.logAllEvents="true"
      • Ícone indicando plataformas Windows Nas plataformas Windows:
        install.exe -W Setup.product.install.logAllEvents="true"
  8. Se você tiver criado com êxito um perfil do servidor de processos, utilize o console do First Steps ou o método da linha de comandos para iniciar o servidor de processos.
    Inicie o console do First Steps para um nó específico (em que profile_root representa o local da instalação do perfil do WebSphere Process Server (por padrão, install_root/profiles/profile_name nas plataformas Linux e UNIX e install_root\profiles\profile_name nas plataformas Windows):
    • Ícone indicando plataformas Linux Ícone indicando plataformas UNIX Nas plataformas Linux e UNIX: profile_root/firststeps/wbi/firststeps.sh
    • Ícone indicando plataformas Windows Nas plataformas Windows: profile_root\firststeps\wbi\firststeps.bat
    Inicie o servidor a partir da linha de comandos:
    1. Vá para o diretório profile_root/bin do perfil.
    2. Inicie o processo do servidor.
      • Ícone indicando plataformas Linux Ícone indicando plataformas UNIX Nas plataformas Linux e UNIX: ./startServer.sh server_name
      • Ícone indicando plataformas Windows Nas plataformas Windows: startServer.bat server_name
  9. Verifique se o servidor inicia e carrega corretamente, procurando um processo Java em execução e a mensagem Aberto para e-business nos arquivos SystemOut.log e SystemErr.log.

    Se não houver nenhum processo Java ou se a mensagem não for exibida, examine a ocorrência de erros variados nos mesmos logs. Corrija os erros e tente novamente.

    É possível localizar os arquivos SystemOut.log e SystemErr.log nos seguintes diretórios específicos de plataforma:
    • Ícone indicando plataformas Linux Ícone indicando plataformas UNIX Nas plataformas Linux e UNIX: profile_root/profiles/logs/server_name
    • Ícone indicando plataformas Windows Nas plataformas Windows: profile_root\profiles\logs\server_name
  10. Utilize o console do First Steps ou o método da linha de comandos para parar o servidor de processos server_name, se ele estiver em execução, e para iniciar o gerenciador de implementação, se existir algum.
    Para parar o server_name a partir da linha de comandos:
    • Ícone indicando plataformas Linux Ícone indicando plataformas UNIX Nas plataformas Linux e UNIX: profile_root/bin/stopServer.sh server_name
    • Ícone indicando plataformas Windows Nas plataformas Windows: profile_root\bin\stopServer.bat server_name
    Se você ativar a segurança, especifique os parâmetros -user e -password do comando.
    Para iniciar o gerenciador de implementação a partir da linha de comandos:
    • Ícone indicando plataformas Linux Ícone indicando plataformas UNIX Nas plataformas Linux e UNIX: profile_root/bin/startManager.sh
    • Ícone indicando plataformas Windows Nas plataformas Windows: profile_root\bin\startManager.bat
  11. Verifique se o servidor é iniciado e carregado corretamente procurando um processo Java em execução e a mensagem Servidor dmgr aberto para e-business no arquivo profile_root/logs/server_name/SystemOut.log.
    Ícone indicando plataformas Linux Ícone indicando plataformas UNIX Nas plataformas Linux e UNIX: Abra uma janela de comandos e emita o comando top para ver uma exibição dos processos em execução. Se o comando top não estiver disponível em seu sistema, utilize o comando ps:
    ps -ef | grep java

    Ícone indicando plataformas Windows Nas plataformas Windows: Pressione Ctrl+Alt+Delete e digite T para abrir o Gerenciador de Tarefas. Clique na guia Processos e no cabeçalho da coluna Nome da Imagem para classificar por nome de imagem. Procure processos denominados java.exe.

    Se não houver nenhum processo Java ou se a mensagem não for exibida, examine a ocorrência de erros variados nos mesmos logs. Corrija os erros e tente novamente iniciar o gerenciador de implementação.

O que fazer em seguida

Estão disponíveis informações atuais sobre problemas conhecidos e suas resoluções, bem como documentos que podem economizar seu tempo ao reunir as informações necessárias para resolver um problema. Antes de abrir um PMR, consulte a página Suporte do IBM WebSphere Process Server.


(c) Copyright IBM Corporation 2005, 2006.
Este centro de informações é desenvolvido em tecnologia Eclipse (http://www.eclipse.org)