Utilize este procedimento para desinstalar o IBM WebSphere ESB e a cópia subjacente do WebSphere Application Server Network Deployment com a GUI do Assistente de Desinstalação.
Antes de iniciar
Antes de desinstalar o
WebSphere ESB utilizando este procedimento, é necessário:
- Saber se você deseja desinstalar o WebSphere ESB no modo interativo.
- Saber se você deseja desinstalar a cópia subjacente do produto WebSphere Application Server Network Deployment quando estiver desinstalando o WebSphere ESB.
- Se você optar por desinstalar o produto WebSphere Application Server Network Deployment Network Deployment subjacente, o programa desinstalador removerá também todos os perfis, incluindo todos os dados de configuração e aplicativos em cada perfil.
- Se você optar por não desinstalar o produto WebSphere Application Server Network Deployment subjacente, qualquer perfil do WebSphere ESB que tenha sido criado ou estendido será reduzido de volta para os perfis do WebSphere Application Server Network Deployment, se nenhum outro produto tiver estendido os perfis depois do WebSphere ESB.
- Fazer backup das pastas config, installableApps e installedApps de cada perfil, se necessário.
Fazer backup de todos os aplicativos que não estão armazenados em outro local.
- Remover o aplicativo corporativo do sistema de mensagens de eventos, o banco de dados de eventos e a configuração do aplicativo Common Event Infrastructure, nesta ordem. Para obter informações sobre como remover esses aplicativos e o banco de dados, consulte Removendo a Configuração do Common Event Infrastructure
- Desinstalar o produto como o usuário root em um sistema Linux ou UNIX, ou como um membro do grupo Administrador, em um sistema Windows.
Restrição: O Assistente de Desinstalação não desempenha instalações parciais, personalizadas ou incrementais.
Restrição:
Em plataformas Windows: as plataformas Windows têm um comprimento máximo de 256 caracteres para caminhos de arquivos. Se um caminho de arquivo para um diretório de perfil
for muito longo, o Assistente de Desinstalação não poderá remover o diretório.
O caminho de arquivo pode ser muito longo devido a um nome de diretório
profile_root longo,
um nome de célula longo e nomes do servidor de processo longos, ou outros nomes
longos utilizados como nomes de pastas de arquivos em diretórios no perfil.
Embora as plataformas Windows permitam a criação de caminhos longos de arquivos, os sistemas operacionais não permitem a exclusão de caminhos longos de arquivos, mesmo que se tente fazer uma exclusão manual. Para ativar a desinstalação
se encontrar este problema, renomeie os diretórios e subdiretórios
para os arquivos que ficaram atrás dos nomes que possuem menos caracteres. Em seguida,
exclua manualmente os diretórios.
Por Que e Quando Desempenhar Esta Tarefa
O programa de desinstalação é criado durante a instalação
do produto. Ele é customizado para cada instalação do produto, com locais de disco
e rotinas específicos para remoção de recursos instalados.
Estimando o
Tempo Requerido para Desinstalação: O tempo requerido para a desinstalação
depende da velocidade de processamento de sua máquina. Em linhas gerais, a desinstalação do WebSphere ESB, WebSphere Application Server Network Deployment e de um perfil, leva aproximadamente 20 minutos.
Para desinstalar o WebSphere ESB, desempenhe as seguintes etapas:
Etapas para Esta Tarefa
- Efetue logon como o usuário root em um sistem Linux ou UNIX, ou como um usuário pertencente ao grupo Administrador em um sistema Windows.
- Se você estiver desinstalando o produto WebSphere Application Server Network Deployment subjacente, execute o programa de desinstalação dos plug-ins de servidores da Web do WebSphere Application Server.
Se o seu sistema inclui um servidor da Web configurado para ser executado com o WebSphere Application ServerNetwork
Deployment, desinstale os plug-ins para remover a configuração do servidor da Web. Consulte o procedimento de desinstalação desse produto no centro de informações do WebSphere Application Server Network Deployment, no endereço http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp.
- Se você tiver um gerenciador de implementação instalado, pare o
processo dmgr do gerenciador de implementação com o comando stopManager.
Pare todos os processos
dmgr que estejam em execução na
máquina. Por exemplo, emita um dos seguintes comandos, dependendo da
plataforma (em que
profile_root representa o diretório de instalação
do perfil do Deployment Manager):
Em plataformas Linux e UNIX: profile_root/bin/stopManager.sh
-user user_ID -password password
Em plataformas Windows: profile_root\bin\stopManager.bat
-user user_ID -password password
- Pare o processo nodeagent com o comando stopNode.
Se você tiver nós federados para um gerenciador de implementação em seu
sistema, pare o processo nodeagent em execução em
cada máquina com um nó federado. Por exemplo, emita um dos seguintes comandos para parar
o processo nodeagent, dependendo da plataforma
(em que
profile_root representa o diretório de instalação
do nó federado):
Em plataformas Linux e UNIX: profile_root/bin/stopNode.sh
Em plataformas Windows: profile_root\bin\stopNode.bat
- Pare cada servidor em execução com o comando stopServer.
Pare todos os processos do servidor
em todos os perfis da máquina. Por exemplo, emita um dos seguintes comandos para parar o servidor
server1
no perfil, dependendo da plataforma. Neste exemplo,
profile_root representa
o local da instalação do perfil:
Em plataformas Linux e UNIX: profile_root/bin/stopServer.sh
server1
Em plataformas Windows: profile_root\bin\stopServer.bat
server1
- Opcional: Faça backup dos arquivos de configuração e dos arquivos de log para fazer referência a eles posteriormente, se necessário.
O programa de desinstalação não remove os arquivos de registro
do diretório install_root. Se você optar por desinstalar o produto WebSphere Application Server Network Deployment subjacente, ele removerá todos os perfis e todos os dados dos perfis.
Faça o backup das pastas config e logs de cada perfil para uma possível consulta futura, se necessário. Não é possível reutilizar perfis, portanto, não há necessidade de fazer backup de um perfil inteiro.
- Emita o comando uninstall a partir de uma linha de comandos.
O Assistente de Desinstalação é iniciado e o painel de Boas-vindas é exibido.
- No painel de Boas-vindas, selecione se é para desinstalar o produto WebSphere Application Server Network Deployment subjacente durante a desinstalação do WebSphere ESB.
Em seguida, clique em Avançar. É
exibido um de quatro painéis:
- Se algum dos servidores
estiver em execução em seu sistema, um painel de aviso o alertará para encerrá-lo
e reiniciar a desinstalação. Cancele a desinstalação e pare de executar os servidores.
- Se não houver nenhum servidor sendo executado e você não optou por desinstalar o produto WebSphere Application Server Network Deployment subjacente e se o desinstalador determinar que os perfis podem ser reduzidos com êxito para os perfis do WebSphere Application Server, será exibido o painel Resumo da Desinstalação. Prossiga com a etapa 10.
- Se não houver nenhum servidor sendo executado e você não optou por desinstalar o produto WebSphere Application Server Network Deployment subjacente e se o desinstalador determinar que os perfis não podem ser reduzidos com êxito, será exibido um painel de Aviso alertando que os perfis do WebSphere ESB ficarão inutilizáveis. Prossiga com a etapa 9.
- Se não houver nenhum servidor sendo executado e você optou por desinstalar o produto WebSphere Application Server Network Deployment subjacente, será exibido um painel de Aviso alertando que os perfis do WebSphere ESB serão excluídos. Prossiga com a etapa 9.
- No painel de Aviso, selecione se deseja continuar com a desinstalação. Clique em Avançar para continuar com a desinstalação ou em Voltar, se deseja reconsiderar a desinstalação do produto.
Este procedimento de exemplo assume que você deseja
continuar com a desinstalação. O painel Resumo da Desinstalação é exibido.
- Reveja o resumo do produto e os recursos que estão sendo desinstalados.
Clique em Avançar para continuar com a desinstalação do produto ou selecione Voltar, se deseja reconsiderar a desinstalação.
Este procedimento de exemplo assume que você deseja
continuar com a desinstalação.
É iniciada a desinstalação do produto. Se você optou por desinstalar o produto WebSphere Application Server Network Deployment subjacente, o desinstalador desempenhará as seguintes tarefas, na seguinte ordem: - Reduzirá os perfis que foram estendidos por último pelo WebSphere ESB.
- Desinstalará o WebSphere ESB.
- Desinstalará o WebSphere Application Server Network Deployment, o qual exclui os perfis.
O painel Desinstalação Concluída é exibido.
- Clique em Concluir para fechar o Assistente de Desinstalação.
- Remova as entradas de configuração do nó gerenciado que descrevem um
gerenciador de implementação excluído.
Uma topologia comum é instalar
os arquivos do produto principal em várias máquinas. Uma máquina tem o Deployment Manager
e outras máquinas têm nós gerenciados criados a partir de perfis customizados.
Se você excluir uma instalação na qual criou um perfil customizado
e federou o nó para uma célula do Deployment Manager em outra instalação,
deverá remover a configuração do Deployment Manager.
A instrução oficial de suporte para um problema de configuração de nó no nó gerenciado é
que você utilize o comando backupConfig após a instalação inicial.
Utilize o comando novamente sempre que fizer alterações significativas na configuração que você deve salvar. Com um backup válido da configuração, você sempre pode
utilizar o comando restoreConfig para voltar a um estado anteriormente
existente na configuração.
Também é possível utilizar um dos
seguintes comandos na máquina com o nó gerenciado para remover
o nó quando o Deployment Manager não estiver em execução.
Neste exemplo,
profile_root representa o diretório de instalação
do perfil do nó gerenciado:
Em
plataformas Linux e UNIX: profile_root/bin removeNode.sh
-force
Em plataformas Windows: profile_root\bin
removeNode.bat -force
Se você deve limpar manualmente a configuração no nó gerenciado,
você pode tentar o seguinte procedimento não suportado:
- Renomeie o diretório cell_name para o nó para o nome
original se o nome atual não for o nome original.
Vá para um dos seguintes
diretórios e renomeie o diretório
cell_name para o nome
original. Neste exemplo,
profile_root representa
o diretório de instalação do perfil do nó:
Em plataformas Linux e UNIX: profile_root/config/cells/
Em plataformas Windows: profile_root\config\cells\
- Exclua o diretório dmgr_node_name se ele existir.
Vá para um dos seguintes diretórios para procurar o diretório
dmgr_node_name
que deve ser excluído. Neste exemplo,
profile_root representa
o diretório de instalação do perfil do nó:
Em plataformas Linux e UNIX: profile_root/config/cells/original_cell_name/nodes
Em plataformas Windows: profile_root\config\cells\original_cell_name\nodes
- Edite o arquivo setupCmdLine.sh em um sistema operacional Linux
ou UNIX ou o arquivo setupCmdLine.bat em um sistema
Windows e altere o nome da célula para o nome da célula original.
O arquivo estará em um dos seguintes diretórios, dependendo
da plataforma. Neste exemplo,
profile_root representa
o diretório de instalação do perfil do nó:
Em plataformas Linux e UNIX: profile_root/bin
Em plataformas Windows: profile_root\bin
Altere o valor da variável
WAS_CELL para o nome original
da célula.
- Remova as entradas de configuração do gerenciador de implementação que
descreve um nó gerenciado excluído.
Abra o console administrativo do gerenciador de implementação e clique em Administração do Sistema > Nós.
Selecione a caixa de opções ao lado do nó que deseja excluir e selecione Remover Nó.
A instrução oficial de suporte para um problema de configuração de nó no gerenciador de implementação é que você utilize o comando backupConfig após a
instalação inicial. Utilize o comando novamente sempre que fizer alterações significativas na configuração que você deve salvar. Com um backup válido da configuração, você sempre pode
utilizar o comando restoreConfig para voltar a um estado anteriormente
existente na configuração.
Se deve limpar manualmente a configuração,
você pode tentar o seguinte procedimento não suportado:
- No diretório nodes do gerenciador de implementação,
remova o diretório configuration do nó excluído.
Vá para um dos seguintes diretórios para localizar o arquivo
deleted_node_name.
Neste exemplo,
profile_root representa o diretório de instalação
do perfil do Deployment Manager:
Em plataformas Linux e UNIX: profile_root/config/cells/cell_name/nodes
Em plataformas Windows: profile_root\config\cells\cell_name\nodes
- No diretório buses do gerenciador de implementação,
remova o diretório configuration do nó excluído.
Vá para um dos seguintes diretórios para localizar o arquivo
deleted_node_name.
Neste exemplo,
profile_root representa o diretório de instalação
do perfil do Deployment Manager:
Em plataformas Linux e UNIX: profile_root/config/cells/cell_name/buses
Em plataformas Windows: profile_root\config\cells\cell_name\buses
- Edite o arquivo coregroup.xml de cada subdiretório do diretório
coregroups do gerenciador de implementação. Procure elementos do tipo
coreGroupServers. Remova os elementos coreGroupServers que
possuem uma referência ao nó excluído.
Vá para um dos seguintes diretórios para localizar o arquivo.
Neste exemplo,
profile_root representa o diretório de instalação
do perfil do Deployment Manager:
Em plataformas Linux e UNIX: profile_root/config/cells/cell_name/coregroups/deleted_node_name
Em plataformas Windows: profile_root\config\cells\cell_name\coregroups\deleted_node_name
- Edite o arquivo nodegroup.xml de cada subdiretório do
diretório nodegroups do gerenciador de implementação. Procure elementos
do tipo members. Remova os elementos members que têm uma referência
ao nó excluído.
Vá para um dos seguintes diretórios para localizar o arquivo.
Neste exemplo,
profile_root representa o diretório de instalação
do perfil do Deployment Manager:
Em plataformas Linux e UNIX: profile_root/config/cells/cell_name/coregroups/deleted_node_name
Em plataformas Windows: profile_root\config\cells\cell_name\coregroups\deleted_node_name
Resultado
Este procedimento desinstala o WebSphere ESB e, se estiver selecionado, o WebSphere Application Server Network Deployment. Depois de executar o Assistente de Desinstalação, a estrutura de diretórios ficará somente com alguns diretórios, incluindo o diretório logs.
O arquivo
uninstlog.txt registra erros do sistema de arquivo
ou outros erros incomuns. Procure o indicador de êxito INSTCONFSUCCESS no log:
Uninstall, com.ibm.ws.install.ni.ismp.actions.
ISMPLogSuccessMessageAction, msg1,
INSTCONFSUCCESS
O que fazer em seguida
Se você pretende reinstalar o produto no mesmo diretório raiz da instalação,
deverá proceder de uma das seguintes formas, dependendo
do êxito da desinstalação:
- Se a desinstalação tiver sido bem-sucedida, será necessário
remover manualmente o diretório install_root.
Importante: Para evitar problemas de instalação, você deve desinstalar o WebSphere ESB e o produto WebSphere Application Server Network Deployment subjacente, se estiver planejando reinstalar o WebSphere ESB no mesmo diretório. Portanto, o diretório install_root, que deve ser removido manualmente,
deve estar vazio.
- Se a desinstalação tiver sido malsucedida, será necessário desinstalar manualmente
os artefatos restantes do produto. Consulte o Preparando a Reinstalação após uma Desinstalação com Falha para obter informações adicionais. Se você não planeja
reinstalar, não será necessário desempenhar esta tarefa.
Para obter mais informações sobre os comandos mencionados neste tópico, consulte o centro de informações do WebSphere Application Server Network Deployment, Versão 6.0, no endereço http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp.