Utilice este procedimiento para desinstalar IBM
WebSphere ESB y
la copia subyacente de WebSphere Application Server Network Deployment con
la interfaz gráfica de usuario (GUI) del asistente de desinstalación.
Antes de empezar
Antes de desinstalar
WebSphere ESB
utilizando este procedimiento, asegúrese de lo siguiente:
- Desea desinstalar WebSphere ESB
interactivamente.
- Sabe si desea desinstalar el producto
WebSphere Application Server Network Deployment
subyacente al desinstalar WebSphere ESB.
- Si elige desinstalar el producto
WebSphere Application Server Network Deployment
subyacente, el programa de desinstalación también elimina todos los perfiles,
incluidos todos los datos de configuración y las aplicaciones de cada perfil.
- Si elige no desinstalar el producto
WebSphere Application Server Network Deployment
subyacente, los perfiles de
WebSphere ESB
creados o aumentados se volverán a reducir a perfiles de
WebSphere Application Server Network Deployment si
ningún otro producto ha aumentado los perfiles después de WebSphere ESB.
- Debe hacer una copia de seguridad de la carpeta config, la
carpeta installableApps y la carpeta installedApps
de cada perfil, si es necesario. Haga una copia de seguridad de todas las
aplicaciones que no se hayan almacenado en otra ubicación.
- Elimine la aplicación empresarial de mensajería de sucesos, la base de datos de
sucesos y la configuración de la aplicación Common Event Infrastructure, en este
orden. Para obtener información sobre cómo eliminar estas aplicaciones y la base de
datos, consulte Eliminación de la configuración de Common Event Infrastructure
- Desinstale el producto como usuario root en un sistema Linux o UNIX o un miembro
del grupo Administrador en un sistema Windows.
Restricción: El asistente de desinstalación no realiza
desinstalaciones parciales, personalizadas ni incrementales.
Restricción:
En plataformas Windows: las plataformas Windows tienen
una longitud máxima para vías de acceso de archivo de 256 caracteres. Si la vía de
acceso de archivo de un directorio de perfiles es demasiado larga, el asistente de
desinstalación no podrá eliminar el directorio. La vía de acceso de archivo puede
ser demasiado larga debido a un nombre de directorio
raíz_perfil largo, un
nombre de celda largo, nombres de servidores de procesos largos u otros nombres
largos utilizados como nombres de carpetas de archivos en directorios en este
perfil. Aunque las plataformas Windows permiten la creación de vías de acceso de
archivo largas, los sistemas operativos no permiten la supresión de vías de acceso
largas, incluso al intentar una supresión manual. Para habilitar la desinstalación
si detecta este problema, cambie los directorios y subdirectorios de los archivos
descartados por nombres con menos caracteres. A continuación, suprima manualmente
los directorios.
Por qué y cuándo se efectúa esta tarea
El programa de desinstalación se crea durante la instalación del
producto. Se personaliza para cada instalación del producto, con ubicaciones de
disco y rutinas específicas para eliminar las características instaladas.
Estimación
del tiempo necesario para la desinstalación: el tiempo necesario para la
desinstalación depende de la velocidad de proceso de su máquina. A modo orientativo,
la desinstalación de WebSphere ESB, WebSphere Application Server Network
Deployment y un perfil tarda aproximadamente 20 minutos.
Para desinstalar
WebSphere ESB, lleve a
cabo los pasos siguientes.
Pasos para realizar esta tarea
- Inicie la sesión como usuario root en un sistema Linux o UNIX, o como un
usuario que pertenezca al grupo Administrador en un sistema Windows.
- Si desinstalar el producto
WebSphere Application Server
Network Deployment subyacente, ejecute el programa de desinstalación para los
conectores del servidor web para
WebSphere Application Server.
Si su sistema incluye un servidor web configurado para su ejecución con
WebSphere Application Server
Network Deployment, desinstale los conectores para eliminar al configuración del
servidor web. Consulte el procedimiento de desinstalación de este producto en el centro de información de
WebSphere Application Server Network Deployment en
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp.
- Si tiene un gestor de despliegue instalado, detenga el proceso
dmgr del gestor de despliegue con el mandato stopManager.
Detenga
todos los procesos
dmgr que se ejecuten en la máquina. Por ejemplo,
emita uno de los mandatos siguientes en función de la plataforma (donde
raíz_perfil representa el directorio de instalación del perfil del gestor de
despliegue):
En plataformas Linux y UNIX:
raíz_perfil/bin/stopManager.sh -user ID_usuario -password
contraseña
En plataformas Windows:
raíz_perfil\bin\stopManager.bat -user ID_usuario -password
contraseña
- Detenga el proceso del agente de nodo con el mandato stopNode.
Si tiene nodos federados en un gestor de despliegue en su sistema, detenga
el proceso del agente de nodo que pueda estar en ejecución en cada máquina con un nodo
federado. Por ejemplo, emita uno de los mandatos siguientes para detener el proceso
de agente de nodo en función de la plataforma (donde
raíz_perfil representa el
directorio de instalación del nodo federado):
En plataformas Linux y UNIX: raíz_perfil/bin/stopNode.sh
En plataformas Windows: raíz_perfil\bin\stopNode.bat
- Detenga cada servidor en ejecución con el mandato stopServer.
Detenga todos los procesos del servidor en todos los perfiles de la
máquina. Por ejemplo, emita uno de los mandatos siguientes para detener el servidor
server1 en el perfil, en función de la plataforma. En este ejemplo,
raíz_perfil representa la ubicación de instalación del perfil:
En plataformas Linux y UNIX:
raíz_perfil/bin/stopServer.sh server1
En plataformas Windows: raíz_perfil\bin\stopServer.bat server1
- Opcional: Haga una copia de seguridad de los archivos de
configuración y de registro para consultarlos más tarde si es necesario.
El
programa de desinstalación no elimina archivos de registro en el directorio
raíz_instalación. Si elige desinstalar el producto
WebSphere Application Server Network Deployment
subyacente, se eliminarán todos los perfiles y todos los datos de los perfiles.
Haga
una copia de seguridad de la carpeta config y la carpeta
logs de cada perfil para consultarlas más tarde si es necesario. No
puede reutilizar perfiles, de modo que no es necesario hacer una copia de seguridad
de todo el perfil.
- Emita el mandato uninstall desde la línea de mandatos.
El asistente de desinstalación se inicia y se visualiza
el panel de bienvenida.
- En el panel de bienvenida, seleccione si desea desinstalar el producto WebSphere Application Server Network
Deployment subyacente al desinstalar WebSphere ESB.
A continuación, pulse Siguiente. Se visualiza uno de estos cuatro paneles:
- Si hay servidores en ejecución en el sistema, un panel de aviso le advertirá de
concluir y reiniciar la desinstalación. Cancele la desinstalación y detenga los
servidores en ejecución.
- Si no hay servidores en ejecución y no ha elegido desinstalar el producto
WebSphere Application Server Network
Deployment subyacente y el programa de desinstalación determina que los
perfiles pueden reducirse correctamente en perfiles
WebSphere Application Server, se
visualiza el panel de resumen de la desinstalación. Continúe en el paso 10.
- Si no hay servidores en ejecución y no elige desinstalar el producto WebSphere Application Server Network
Deployment subyacente y el programa de desinstalación determina que los perfiles
no pueden reducirse correctamente, se visualizará un panel de aviso que le
avisará de que los perfiles de
WebSphere ESB
quedarán inutilizables. Continúe en el paso
9.
- Si no hay servidores en ejecución y sí que ha elegido desinstalar el
producto WebSphere Application Server Network
Deployment subyacente, se visualizará un panel de aviso que le advertirá de que
los perfiles WebSphere ESB se
suprimirán. Continúe en el paso
9.
- En el panel de aviso, seleccione si
desea continuar la desinstalación. Pulse Siguiente para continuar la
desinstalación o Anterior si desea reconsiderar la desinstalación del producto. Este
procedimiento de ejemplo da por supuesto que desea continuar la desinstalación. Se visualiza el panel de resumen de desinstalación.
- Revise el resumen del producto y las
características que está desinstalando.
Pulse Siguiente para
continuar la desinstalación del producto o seleccione Anterior si desea
reconsiderar la desinstalación del producto. Este procedimiento de ejemplo da por
supuesto que desea continuar la desinstalación.
Se
inicia la desinstalación del producto. Si ha seleccionado desinstalar el producto
WebSphere Application Server Network
Deployment subyacente, el programa de desinstalación lleva a cabo las tareas
siguientes en el orden siguiente: - Reduce los perfiles que ha aumentado
WebSphere ESB
por última vez.
- Desinstala WebSphere ESB.
- Desinstala WebSphere Application Server Network Deployment,
lo que suprime los perfiles.
Se visualiza el panel de desinstalación completa.
- Pulse Finalizar para cerrar el asistente de desinstalación.
- Elimine las entradas de configuración del nodo gestionado que
describan el gestor de despliegue suprimido.
Una topología habitual
consiste en instalar los archivos básicos del producto en varias máquinas. Una
máquina tiene el gestor de despliegue y las otras máquinas tienen nodos gestionados
creados a partir perfiles personalizados.
Si suprime una instalación en la que ha creado un perfil personalizado y ha federado
el nodo en una celda del gestor de despliegue en otra instalación, debe eliminar la
configuración del gestor de despliegue.
La recomendación oficial de
soporte para un problema de configuración del nodo en un nodo
gestionado es utilizar el mandato backupConfig después de la instalación
inicial. Utilice el mandato de nuevo al realizar cambios significativos en la
configuración que debe guardar. Con una copia de seguridad válida de la
configuración, puede usar siempre el mandato restoreConfig para volver a un
estado previamente existente en la configuración.
También puede usar uno de
los mandatos siguientes en la máquina con el nodo gestionado para eliminar el nodo
cuando el gestor de despliegue no se encuentre en ejecución. En este ejemplo,
raíz_perfil representa el directorio de instalación del perfil del nodo
gestionado:
En plataformas Linux y UNIX: raíz_perfil/bin removeNode.sh -force
En plataformas Windows: raíz_perfil\bin removeNode.bat -force
Si debe limpiar manualmente la configuración en el nodo gestionado,
puede intentar el procedimiento no soportado siguiente:
- Cambie el nombre del directorio nombre_celda por el nombre
original si el nombre actual no es el nombre original.
Vaya a uno de
los directorios siguientes y cambie el nombre del directorio
nombre_celda por el nombre original. En este ejemplo,
raíz_perfil representa el directorio de instalación del perfil del nodo:
En plataformas Linux y UNIX: raíz_perfil/config/cells/
En plataformas Windows: raíz_perfil\config\cells\
- Suprima el directorio dmgr_node_name si existe.
Vaya a uno de los directorios siguientes para buscar el directorio
dmgr_node_name que debe suprimir. En este ejemplo,
raíz_perfil
representa el directorio de instalación del perfil del nodo:
En plataformas Linux y UNIX:
raíz_perfil/config/cells/nombre_celda_original/nodes
En plataformas Windows:
raíz_perfil\config\cells\nombre_celda_original\nodes
- Edite el archivo setupCmdLine.sh en un sistema
operativo Linux o UNIX o el archivo setupCmdLine.bat en un sistema
Windows y cambie el nombre de celda por su nombre original.
El
archivo se encuentra en uno de los directorios siguientes en función de la
plataforma. En este ejemplo,
raíz_perfil representa el directorio de
instalación del perfil del nodo:
En plataformas Linux y UNIX: raíz_perfil/bin
En plataformas Windows: raíz_perfil\bin
Cambie el valor de la variable
WAS_CELL por el nombre de celda original.
- Elimine las entradas de configuración del gestor de despliegue que
describan un nodo gestionado suprimido.
Abra la consola administrativa del gestor de despliegue y pulse Administración del sistema > Nodos. Seleccione los recuadros de selección al lado del nodo que desea suprimir
y, a continuación, seleccione Eliminar nodo.
La recomendación oficial de soporte para un problema de configuración
del nodo en el gestor de despliegue es utilizar el mandato backupConfig después de
la instalación inicial. Utilice el mandato de nuevo al realizar cambios
significativos en la configuración que debe guardar. Con una copia de seguridad
válida de la configuración, puede usar siempre el mandato restoreConfig para
volver a un estado previamente existente en la configuración.
Si debe limpiar
manualmente la configuración, puede intentar el procedimiento no soportado siguiente:
- En el directorio nodos del gestor de despliegue,
elimine el directorio de configuración del nodo que ha suprimido.
Vaya a uno de los directorios siguientes para buscar el archivo
nombre_nodo_suprimido. En este ejemplo,
raíz_perfil
representa el directorio de instalación del perfil del gestor de despliegue:
En plataformas Linux y UNIX:
raíz_perfil/config/cells/nombre_celda/nodes
En plataformas Windows:
raíz_perfil\config\cells\nombre_celda\nodes
- En el directorio buses del gestor de despliegue,
elimine el directorio de configuración del nodo que haya suprimido.
Vaya a uno de los directorios siguientes para buscar el archivo
nombre_nodo_suprimido. En este ejemplo,
raíz_perfil representa el
directorio de instalación del perfil del gestor de despliegue:
En plataformas Linux y UNIX:
raíz_perfil/config/cells/nombre_celda/buses
En plataforma Windows:
raíz_perfil\config\cells\nombre_celda\buses
- Edite el archivo coregroup.xml en cada subdirectorio
del directorio coregroups del gestor de despliegue. Busque
elementos de tipo coreGroupServers. Elimine los elementos coreGroupServers
que tengan referencias al nodo que ha suprimido.
Vaya a uno de
directorios siguientes para buscar el archivo. En este ejemplo,
raíz_perfil
representa el directorio de instalación del perfil del gestor de despliegue:
En plataformas Linux y UNIX:
raíz_perfil/config/cells/nombre_celda/coregroups/nombre_nodo_suprimido
En plataformas Windows:
raíz_perfil\config\cells\nombre_celda\coregroups\nombre_nodo_suprimido
- Edite el archivo nodegroup.xml en cada subdirectorio
del directorio nodegroups del gestor de despliegue. Busque
elementos de tipo members. Elimine los elementos members que
tengan referencias al nodo que ha suprimido.
Vaya a uno de
directorios siguientes para buscar el archivo. En este ejemplo,
raíz_perfil
representa el directorio de instalación del perfil del gestor de despliegue:
En plataformas Linux y UNIX:
raíz_perfil/config/cells/nombre_celda/coregroups/nombre_nodo_suprimido
En plataformas Windows:
raíz_perfil\config\cells\nombre_celda\coregroups\nombre_nodo_suprimido
Resultado
Este procedimiento desinstala WebSphere ESB
y, si está seleccionado, WebSphere Application Server Network
Deployment. Después de ejecutar el asistente de desinstalación, la estructura de
directorios sólo tiene unos pocos directorios restantes, incluido el directorio
logs.
El archivo
uninstlog.txt registra
errores del sistema de archivos y otros errores no habituales. Busque el indicador
de operación correcta INSTCONFSUCCESS en el registro:
Uninstall, com.ibm.ws.install.ni.ismp.actions.
ISMPLogSuccessMessageAction, msg1,
INSTCONFSUCCESS
Qué hacer a continuación
Si tiene previsto reinstalar el producto en la mismo directorio raíz de
instalación, debe llevar a cabo una de las acciones siguientes en función del éxito
de la desinstalación:
- Si la desinstalación no se ha realizado correctamente, debe eliminar manualmente
el directorio raíz_instalación.
Importante: Para evitar problemas de desinstalación, debe desinstalar tanto
WebSphere ESB
como el producto WebSphere Application Server Network
Deployment subyacente si tiene previsto reinstalar
WebSphere ESB
en el mismo directorio. Por tanto, el directorio raíz_instalación que debe
eliminar manualmente debe estar vacío.
- Si la desinstalación no se realiza correctamente, debe desinstalar manualmente
los artefactos restantes del producto. Consulte el apartado
Preparación para una nueva instalación tras una desinstalación con errores para obtener más información. Si
no tiene previsto reinstalarlo, no es necesario realizar esta tarea.
Para obtener más información sobre los mandatos mencionados en este
tema, consulte el centro de información de WebSphere Application Server Network Deployment, versión 6.0, en
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp.