将此过程与卸载向导图形用户界面(GUI)配合使用来卸载 IBM WebSphere ESB
和 WebSphere Application Server
Network Deployment 的底层副本。
在开始之前
在使用此过程卸载
WebSphere ESB
之前,确保:
- 您想要以交互方式卸载 WebSphere ESB。
- 当您卸载 WebSphere ESB 时,您知道是否要卸载底层
WebSphere Application Server Network Deployment 产品。
- 如果选择卸载底层 WebSphere Application Server Network Deployment
产品,则卸载程序还会除去所有概要文件,包括每个概要文件中的所有配置数据和应用程序。
- 如果选择不卸载底层 WebSphere Application Server Network Deployment
产品,则已经创建或扩充的所有 WebSphere ESB
概要文件将取消扩充并回复至 WebSphere Application Server Network Deployment
概要文件(如果在 WebSphere ESB
之后没有任何其他产品扩充概要文件的话)。
- 备份每个概要文件的 config 文件夹、installableApps 文件夹和
installedApps 文件夹(如果必要的话)。备份未另外存储的所有应用程序。
- 以该顺序除去事件消息传递企业应用程序、事件数据库和 Common Event Infrastructure 应用程序配置。有关除去这些应用程序和数据库的信息,请参阅除去 Common Event Infrastructure 配置
- 在 Linux 或 UNIX 系统上作为 root 用户卸载该产品,或在 Windows 系统上作为 Administrator 组的成员卸载该产品。
限制: 卸载向导不会执行部分、定制或递增卸载。
限制:
在 Windows 平台上:Windows
平台的文件路径的最大长度为 256 个字符。如果概要文件目录的文件路径过长,则卸载向导将无法除去该目录。文件路径可能会因为
profile_root 目录名、单元名、进程服务器名称过长而过长,也可能因为用作概要文件目录中的文件夹名称的名称过长而过长。尽管
Windows 平台允许创建长文件路径,但操作系统不允许删除长文件路径,即使尝试手工删除也不行。要在遇到此问题时启用卸载,重命名文件的目录和子目录以减少名称的字符数。然后手工删除这些目录。
执行此任务的目的和时间
卸载程序是在安装产品时创建的。它是针对每个产品安装定制的,具有特定的磁盘位置和用于除去已安装功能的例程。
估计卸载所需的时间:卸载所需的时间取决于机器的处理速度。一般来说,卸载 WebSphere ESB、WebSphere Application Server
Network Deployment 和一个概要文件大概需要 20 分钟。
要卸载 WebSphere ESB,执行下列步骤。
完成此任务需要执行的步骤
- 在 Linux 或 UNIX 系统上以 root 用户的身份登录,或在 Windows 系统上以隶属于 Administrator 组用户的身份登录。
- 如果要卸载底层 WebSphere Application Server
Network Deployment 产品,则对 WebSphere Application Server
的 Web 服务器插件运行卸载程序。
如果系统包括配置为与 WebSphere Application Server
Network Deployment 一起运行的 Web 服务器,则卸载这些插件以从 Web 服务器除去该配置。请参阅
WebSphere Application Server
Network Deployment 信息中心(网址为 http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp)中有关此产品的卸载过程。
- 如果已安装部署管理器,则使用 stopManager 命令停止部署管理器 dmgr 进程。
停止机器上正在运行的所有
dmgr 进程。例如,根据平台的不同发出下列其中一个命令(其中
profile_root
表示部署管理器概要文件的安装目录):
在 Linux 和 UNIX 平台上:profile_root/bin/stopManager.sh
-user user_ID -password password
在 Windows 平台上:profile_root\bin\stopManager.bat
-user user_ID -password password
- 使用 stopNode 命令停止节点代理程序进程。
如果节点联合至系统上的部署管理器,则停止可能在带有联合节点的每台机器上运行的节点代理进程。例如,根据平台的不同发出下列其中一个命令(其中
profile_root
表示联合节点的安装目录)以停止节点代理进程:
在 Linux 和 UNIX 平台上: profile_root/bin/stopNode.sh
在 Windows 平台上: profile_root\bin\stopNode.bat
- 使用 stopServer 命令停止正在运行的每个服务器。
停止机器上的所有概要文件中的所有服务器进程。例如,根据平台的不同发出下列其中一个命令来停止概要文件中的服务器
server1。在此示例中,
profile_root 表示概要文件的安装位置:
在 Linux 和 UNIX 平台上: profile_root/bin/stopServer.sh
server1
在 Windows 平台上: profile_root\bin\stopServer.bat
server1
- 可选: 备份配置文件和日志文件以便以后必要时进行参考。
卸载程序不会除去
install_root 目录中的日志文件。如果选择卸载底层 WebSphere Application Server Network Deployment
产品,则它会确实除去所有概要文件及所有概要文件中的所有数据。
备份每个概要文件的
config 文件夹和 logs
文件夹以便以后必要时进行参考。因为不能重复使用概要文件,所以没有必要备份整个概要文件。
- 从命令行发出 uninstall 命令。
卸载向导将启动并显示“欢迎”面板。
- 在“欢迎”面板中,选择在卸载 WebSphere ESB
时是否卸载底层 WebSphere Application Server
Network Deployment 产品。然后单击下一步。 将显示下列四个面板的其中一个:
- 如果系统上有任何服务器在运行,将出现一个警告面板以提醒您关闭这些服务器并重新启动卸载程序。取消卸载并停止正在运行的服务器。
- 如果没有服务器在运行并且您未选择卸载底层
WebSphere Application Server
Network Deployment 产品,同时卸载程序确定概要文件可以成功地取消扩充并回复至 WebSphere Application Server
概要文件,则将显示“卸载摘要”面板。继续以下步骤:10。
- 如果没有服务器在运行并且未选择卸载底层
WebSphere Application Server
Network Deployment 产品,同时卸载程序确定概要文件不能成功地取消扩充,则将显示“警告”面板,它会提醒您
WebSphere ESB
概要文件将不可用。继续以下步骤:9。
- 如果没有服务器在运行并且确实选择了卸载底层 WebSphere Application Server
Network Deployment 产品,则将显示“警告”面板,它会提醒您将删除 WebSphere ESB
概要文件。继续以下步骤:9。
- 从“警告”面板中选择是否继续进行卸载。如果要继续卸载,则单击下一步,或者如果想要重新考虑卸载产品的问题,则单击上一步。此示例过程假定您想要继续卸载。 将显示“卸载摘要”面板。
- 复查要卸载的产品和功能的摘要。
如果要继续卸载产品,则单击下一步,或者如果想要重新考虑卸载产品的问题,则单击上一步。此示例过程假定您想要继续卸载。
产品卸载开始。如果选择卸载底层
WebSphere Application Server
Network Deployment 产品,则卸载程序将按下列顺序执行下列任务:- 取消扩充 WebSphere ESB
上次扩充的概要文件。
- 卸载 WebSphere ESB。
- 卸载 WebSphere Application Server Network Deployment,这将删除这些概要文件。
将显示“卸载完成”面板。
- 单击完成以关闭卸载向导。
- 除去受管节点中描述已删除部署管理器的配置条目。
常用拓扑是在多台机器上安装核心产品文件。一台机器安装部署管理器,而其他机器为定制概要文件创建受管节点。如果删除的安装就是您在其中创建定制概要文件的安装并且您将节点联合至另一安装中的部署管理器单元,则必须从部署管理器中除去该配置。
对受管节点中的节点配置问题的支持的正式声明为:在初始安装后使用
backupConfig 命令。每次对配置作出必须保存的重大更改后,应再次使用该命令。借助有效的配置备份,您总是可以使用 restoreConfig
命令来回复配置中的先前存在状态。
还可在带有受管节点的机器上使用下列其中一个命令以在部署管理器未运行的情况下除去该节点。在此示例中,
profile_root
表示受管节点概要文件的安装目录:
在 Linux 和 UNIX 平台上: profile_root/bin
removeNode.sh -force
在 Windows 平台上: profile_root\bin
removeNode.bat -force
如果必须手工清除受管节点上的配置,可尝试以下不支持的过程:
- 如果当前名称不是原始名称,则将节点的 cell_name 目录重命名为原始名称。
转至下列其中一个目录,然后将
cell_name 目录重命名为原始名称。在此示例中,
profile_root 表示节点概要文件的安装目录:
在 Linux 和 UNIX 平台上: profile_root/config/cells/
在 Windows 平台上: profile_root\config\cells\
- 如果 dmgr_node_name 目录存在,则删除它。
转至下列其中一个目录以查找必须删除的
dmgr_node_name 目录。在此示例中,
profile_root 表示节点概要文件的安装目录:
在 Linux 和 UNIX 平台上: profile_root/config/cells/original_cell_name/nodes
在 Windows 平台上: profile_root\config\cells\original_cell_name\nodes
- 在 Linux 或 UNIX 操作系统上编辑 setupCmdLine.sh 文件,或在
Windows 系统上编辑 setupCmdLine.bat 文件并将单元名更改为原始单元名。
根据平台的不同,该文件在下列其中一个目录中。在此示例中,
profile_root 表示节点概要文件的安装目录:
在 Linux 和 UNIX 平台上: profile_root/bin
在 Windows 平台上: profile_root\bin
将
WAS_CELL 变量的值更改为原始单元名。
- 除去部署管理器中描述已删除受管节点的所有配置条目。
打开部署管理器的管理控制台,然后单击系统管理 > 节点。选择希望删除的节点旁的复选框,然后选择除去节点。
对部署管理器中的节点配置问题的支持的正式声明为:在初始安装后使用
backupConfig 命令。每次对配置作出必须保存的重大更改后,应再次使用该命令。借助有效的配置备份,您总是可以使用 restoreConfig
命令来回复配置中的先前存在状态。
如果必须手工清除该配置,可尝试以下不支持的过程:
- 在部署管理器的 nodes 目录中除去已删除节点的配置目录。
转至下列其中一个目录以查找
deleted_node_name 文件。在此示例中,
profile_root
表示部署管理器概要文件的安装目录:
在 Linux 和 UNIX 平台上: profile_root/config/cells/cell_name/nodes
在 Windows 平台上: profile_root\config\cells\cell_name\nodes
- 在部署管理器的 buses 目录中除去已删除节点的配置目录。
转至下列其中一个目录以查找
deleted_node_name 文件。在此示例中,
profile_root
表示部署管理器概要文件的安装目录:
在 Linux 和 UNIX 平台上: profile_root/config/cells/cell_name/buses
在 Windows 平台上: profile_root\config\cells\cell_name\buses
- 在部署管理器的 coregroups 目录的每个子目录中编辑
coregroup.xml 文件。查找类型为 coreGroupServers 的元素。除去引用已删除节点的所有
coreGroupServers 元素。
转至下列其中一个目录以查找该文件。在此示例中,
profile_root
表示部署管理器概要文件的安装目录:
在 Linux 和 UNIX 平台上: profile_root/config/cells/cell_name/coregroups/deleted_node_name
在 Windows 平台上: profile_root\config\cells\cell_name\coregroups\deleted_node_name
- 在部署管理器的 nodegroups 目录的每个子目录中编辑
nodegroup.xml 文件。查找类型为 members 的元素。除去引用已删除节点的所有 members 元素。
转至下列其中一个目录以查找该文件。在此示例中,
profile_root
表示部署管理器概要文件的安装目录:
在 Linux 和 UNIX 平台上: profile_root/config/cells/cell_name/coregroups/deleted_node_name
在 Windows 平台上: profile_root\config\cells\cell_name\coregroups\deleted_node_name
结果
此过程将卸载 WebSphere ESB
和(如果选择了的话) WebSphere Application Server Network Deployment。在运行卸载向导后,目录结构只留下包括 logs 目录在内的很少几个目录。
uninstlog.txt 文件记录文件系统或其他不寻常的错误。在日志中查找
INSTCONFSUCCESS 指示符(表示成功):
Uninstall, com.ibm.ws.install.ni.ismp.actions.
ISMPLogSuccessMessageAction, msg1,
INSTCONFSUCCESS
下一步做什么?
如果打算将产品重新安装到同一安装根目录中,则根据卸载成功与否,您必须执行下列其中一个操作:
有关本主题中提到的命令的更多信息,请参阅 WebSphere Application Server Network Deployment V6.0 信息中心(网址为
http://publib.boulder.ibm.com/infocenter/ws60help/index.jsp)。