O Assistente de Perfil pode encontrar falhas ao criar perfis novos ou
alterar os existentes. O mesmo pode ocorrer utilizando o comando manageprofiles. Se tal falha ocorrer, primeiro verifique os arquivos de log, conforme descrito neste tópico e, em seguida, siga as instruções de recuperação descritas, dependendo da situação.
Arquivos de Log
Consulte os arquivos de log a seguir na ordem fornecida.
Cada arquivo de registro deve conter a entrada
"INSTCONFSUCCESS." Se um arquivo não incluir essa entrada, uma falha foi detectada. Examine os arquivos de registro para determinar por que uma falha foi encontrada e uma solução.
- O arquivo de log criado pelo Assistente de Perfil.
Nota: Se tiver utilizado o comando manageprofiles e ocorreram falhas, não procure esse arquivo.
O nome do arquivo baseia-se parcialmente em um timestamp e está no formato
pcatLogNNNNNNNNNNNNN.txt,
em que
NNNNNNNNNNNNN é um número. Esse arquivo pode estar localizado no diretório
profile_root/logs nos sistemas Linux e UNIX e
profile_root\logs nos sistemas Microsoft Windows (em que
profile_root é o local de instalação do perfil). Se você não puder determinar a causa da falha, reveja os arquivos de registro descritos nas seguintes opções.
Nota: Se
você tiver executado o Assistente de Perfil várias vezes para um perfil, poderá existir mais de um
desses arquivos. Sempre consulte o arquivo mais recente.
- O arquivo de log wasprofile_create_profile_name.log (onde profile_name é o nome do perfil).
Nota: Consulte esse arquivo somente se estava criando um novo perfil, não aprimorando um existente.
Esse arquivo de log está localizado no diretório install_root/logs/wasprofile nos sistemas Linux e UNIX e install_root\logs\wasprofile nos sistemas Windows (onde install_root é o local da raiz da instalação do WebSphere Process Server).
Procure o texto "Resultado da Execução" e verifique se cada ocorrência termina em "true." Cada valor
true ou false resulta da execução de um script .ant de ação de configuração de modelo de perfil. Por exemplo:
<message>Result of executing
E:\o0536.15\profileTemplates\default\actions\first was: true</messages>
Um valor "false" nesse arquivo pode indicar a origem da falha.
Nota: Podem ocorrer várias ocorrências de "false". Investigue e remedie cada um. Além disso, revise os arquivos de registro descritos nas seguintes opções, se o perfil foi criado.
- O arquivo de log wasprofile_augment_profile_name.log (onde profile_name é o nome do perfil).
Esse arquivo de log está localizado no diretório install_root/logs/wasprofile nos sistemas Linux e UNIX e install_root\logs\wasprofile nos sistemas Windows (onde install_root é o local da raiz da instalação do WebSphere Process Server). Procure o texto "Resultado da Execução" e verifique se cada ocorrência termina em "true." Cada valor
true ou false resulta da execução de um script .ant de ação de configuração de modelo de perfil. Por exemplo:
<messages>Result of executing
E:\o0536.15\profileTemplates\default.wbicore\actions\saveParamsWbiCore.ant
was:true</messages>
Um valor "false" nesse arquivo pode indicar a origem da falha. Além disso, revise os arquivos de registro descritos na seguinte opção.
Nota: Podem ocorrer várias ocorrências de "false". Investigue e remedie cada um.
- Arquivos de registro de ação de gabarito de perfil individual.
Se descobrir valores false nos arquivos de log descritos nas opções anteriores, revise os arquivos de log no diretório profile_root/logs em sistemas Linux e UNIX e profile_root\logs em sistemas
Windows (onde profile_root é o local da instalação do perfil).
Esses arquivos de log não seguem uma convenção de nomenclatura consistente, mas geralmente cada um tem o nome do script .ant que falhou seguido por .log. Por exemplo, suponhamos que a seguinte entrada esteja no arquivo wasprofile_augment_profile_name.log:
<messages>Result of executing
E:\o0536.15\profileTemplates\default.wbicore\actions\saveParamsWbiCore.ant
was:false</messages>
Primeiro, consulte as entradas adjacentes no arquivo wasprofile_augment_profile_name.log.
Se não for possível determinar a causa da falha a partir das entradas adjacentes, procure no arquivo de log correspondente alguma entrada do script .ant em falha.
Nesse caso, o arquivo de log criado pelo script saveParamsWbiCore.ant é
saveParamsWbiCore.ant.log. Examine esse arquivo para investigar a causa da falha ocorrida.
Recuperação para Falha de Criação
Depois de determinar por que a criação do perfil falhou e solucionar a causa da falha, você poderá tentar criar o perfil novamente.
Nota: Quando você cria um perfil, é necessário criar um perfil do WebSphere Application Server inicialmente e, então, alterá-lo com gabaritos de perfil do WebSphere Process Server para criar um perfil do WebSphere Process Server.
Mesmo que você tenha encontrado uma falha na criação de perfil, o perfil existente pode não ter todas as alterações necessárias (presumivelmente devido à falha).
Para determinar se o perfil existe, execute o comando install
root/bin/wasprofile.sh -listProfiles nos sistemas Linux e UNIX ou o comando install_root\bin\wasprofile.bat
-listProfiles nos sistemas Windows (em que install_root é o local raiz da instalação do WebSphere Process Server). Se o nome do perfil utilizado para a criação não existir, você poderá recriar o perfil. Se o nome do perfil utilizado para a criação existir, então, o perfil foi criado e você encontrou uma falha de alteração. Para obter dicas sobre como recuperar de uma falha de aprimoramento, consulte Recuperação de Falha de Alteração.
Caso
o perfil tenha sido criado, mas as alterações falharem ao utilizar o comando manageprofiles,
recomenda-se que você conclua as alterações restantes com o Assistente de
Perfil.
Recuperação de Falha de Alteração
Após determinar a razão da falha do aprimoramento do perfil e abordar a causa da falha, é possível tentar aprimorar o perfil existente novamente para criar um perfil completo do WebSphere Process Server com êxito, seguindo estas etapas:
- Inicie o Assistente de Perfil e, em vez de criar um novo perfil, escolha para
alterar um perfil existente.
- Escolha o perfil com o qual estava trabalhando e digite as informações corretas para ele.
Nota: Algumas das alterações podem ter sido concluídas com êxito
na primeira vez em que você executou o Assistente de Perfil. Como resultado, você pode não ver todos os painéis vistos na primeira tentativa de criação do perfil.
Isso ocorre porque o Assistente de Perfil detecta quais alterações restantes devem
ser concluídas e exibe apenas os painéis necessários.
Atenção: Caso
escolha para excluir manualmente o perfil antes de tentar novamente, você deverá remover
todas as alterações do perfil antes de excluí-lo, ou problemas poderão ocorrer.
Isso inclui alterações no perfil original do WebSphere Application Server
ou WebSphere Application Server Network Deployment que foram feitas
pelo Assistente de Perfil do
WebSphere Process Server
para alterá-lo para um perfil do
WebSphere Process Server
e alterações que foram feitas por outros modelos de perfis. Consulte
Excluindo Alterações para obter informações adicionais.
Excluindo Alterações
Para remover alterações
de um perfil do
WebSphere Process Server que
foram feitas originalmente pelo Assistente de Perfil do
WebSphere Process Server,
siga estas etapas:
- Verifique se não há servidores em execução para o perfil.
- Localize a entrada para o perfil no arquivo install_root/properties/profileRegistry.xml (em
plataformas Linux e UNIX) ou install_root\properties\profileRegistry.xml (em
plataformas Windows) e determine quantas alterações do WebSphere Process Server
ele possui.
- Remova cada alteração do WebSphere Process Server
para o perfil utilizando o comando wasprofile -unaugment.
- Cada chamada remove o último modelo alterado para o perfil. Verifique
se cada comando de remoção de alteração que você executou foi concluído com êxito.
- Exclua o perfil utilizando o comando wasprofile -delete.
Nota: Não altere o conteúdo do arquivo profileRegistry.xml de
nenhuma outra maneira que não seja utilizando o comando wasprofile.
Para remover
alterações causadas por modelos de perfis para produtos diferentes do
WebSphere Process Server, consulte
a documentação desses outros produtos para assegurar que você esteja removendo as alterações dos
modelos apropriadamente.
Para obter informações adicionais sobre como excluir manualmente as alterações,
consulte a Nota Técnica IBM 1218704, "Remover Alterações Antes
de Excluir Manualmente um Perfil Usando o Utilitário de Linha de Comandos wasprofile."