适用于 Microsoft Windows 的 Sun Java Enterprise System 5 安装指南

第 7 章卸载 Java ES 组件

本章说明如何卸载使用 Java ES 安装程序所安装的 Sun Java Enterprise System (Java ES) 组件。

本章包括以下各节：

卸载程序的工作原理

Java ES 提供了一个卸载程序，用于删除使用 Java ES 安装程序安装在系统上的 Java ES 组件。

卸载程序的限制

与 Java ES 安装程序一样，卸载程序可以在图形模式或无提示模式下运行。

卸载程序仅删除由 Java ES 安装程序所安装的那些 Java ES 组件。要删除不是由 Java ES 安装程序所安装的那些 Java ES 组件，请按照相应 Java ES 组件文档中的说明进行操作。
必须在包含 Java ES 组件的每台主机上分别运行卸载程序。不支持远程卸载。对于每台主机，可选择删除一个或多个 Java ES 组件。
卸载程序可能会删除配置和用户数据文件。这些文件对于各组件而言有所不同。

卸载过程完成后，您可能需要删除某些其他的文件和目录。有关逐个产品的信息，参阅查看 Java ES 组件的卸载行为。
卸载程序仅为其运行时所在的系统检查 Java ES 组件依赖性，并在发现依赖性时发出警告。

处理相互依赖性

根据您所安装的 Java ES 组件以及它们之间的相互关系，卸载程序的行为方式可能会不同。

卸载程序会识别在同一台主机上安装的产品之间的依赖性。如果安装在主机上的产品依赖于您试图卸载的 Java ES 组件，卸载程序将发出警告。

例如，如果试图从同时装有 Portal Server 的主机中卸载 Access Manager，则卸载程序会警告您：没有 Access Manager，Portal Server 将无法发挥作用。
在大多数情况下，如果其他 Java ES 组件都不依赖于某个 Java ES 组件，就可以卸载该组件。

例如，Portal Server 依赖于 Access Manager，但是 Access Manager 不依赖 Portal Server。如果尝试卸载 Portal Server，卸载程序不会发出警告，因为 Access Manager 可以在没有 Portal Server 的情况下发挥作用。

注意 –

卸载某个 Java ES 组件时，必须确定为该 Java ES 组件配置了哪些产品（可能需要进行一些另外的配置）。否则，系统中可能会有这样一些 Java ES 组件，它们被配置为支持不再存在的产品。

卸载程序无法识别以下相互依赖性：

远程主机上的依赖性
由配置引起的依赖性

远程主机上的 Java ES 组件依赖性

一些 Java ES 组件依赖性可通过部署在远程主机上的 Java ES 组件来满足。卸载程序不会识别这些依赖关系。

例如，如果卸载 Directory Server，卸载程序不会警告您 Access Manager 依赖于 Directory Server，即使这两个产品部署在同一主机上也是如此。这是因为另一主机上的另一个 Directory Server 实例可以支持 Access Manager。

由配置引起的 Java ES 组件依赖性

卸载程序无法识别由安装后配置所引起的 Java ES 组件依赖性。

检验先决条件

下表列出了卸载之前应当执行的任务。有些任务可能不适用于您的具体情况。

左列列出了任务应采取的执行顺序，右列包含其他有用信息以及相应指导说明所在位置。

表 7–1 核对表


任务说明	说明或帮助信息
1. 查看计划卸载的每个 Java ES 组件的需求和行为。	查看 Java ES 组件的卸载行为
2. 确定由配置引起的组件依赖性并采取相应的措施，如备份数据、从 Java ES 支持组件中取消配置依赖的 Java ES 组件或者按照正确的顺序卸载 Java ES 组件。	处理相互依赖性
3. 对于将要卸载的 Java ES 组件的配置数据或用户数据，如果您计划在随后的安装中再次使用这些数据，请对这些数据进行备份或归档。	查看 Java ES 组件的卸载行为
4. 确保托管配置目录的 Directory Server 实例处于运行状态。注：在大多数情况下，在卸载之前，Web 容器和 Directory Server 应该一直处于运行状态，而其他服务器应该关闭。	此 Directory Server 实例只有处于运行状态，卸载程序才能取消配置您要卸载的 Java ES 组件。

查看 Java ES 组件的卸载行为

查看本节中的相关表格，以了解卸载程序对 Java ES 组件所执行的操作。请规划为防止丢失数据或丢失相互依赖性连接而可能必须执行的步骤。

本节包含以下各小节：

Access Manager 的卸载行为

表 7–2 Access Manager 的卸载详细信息


主题	详细信息
配置数据	不会删除 Directory Server 中的任何条目（包括 Access Manager 特有的数据）。
此组件需要的其他安装	Directory Server Web 容器
需要此安装的产品	Portal Server（必须与 Access Manager SDK 驻留在同一台主机上）
卸载前的任务	无
卸载后的任务	仅对于 Web Server 或 Application Server 上的完全安装，卸载时才会取消配置 Web 容器中的 Access Manager。

Application Server 的卸载行为

表 7–3 Application Server 的卸载详细信息


主题	详细信息
配置数据和用户数据	在安装期间创建的默认域在卸载期间将被删除。在卸载期间不会删除用户创建的域，包括所有管理服务器和 Application Server 实例。所有 Administration Server 和 Application Server 实例将在卸载完成之前停止。
依赖性	要求 Message Queue 位于同一系统上。
需要此安装的产品	配置为将 Application Server 用作 Web 容器的组件：Access Manager 和 Portal Server。
卸载前的任务	要保留配置数据，请生成一份管理域目录的副本。
卸载后的任务	要从系统上完全删除 Application Server，请删除残留的所有 Application Server 日志文件和目录。Application Server 目录的默认位置为 `\JavaES-Install-Dir\appserver`。有关 Message Queue 卸载后任务的信息，参阅Message Queue 的卸载行为。

Directory Server 的卸载行为

表 7–4 Directory Server 的卸载详细信息


主题	详细信息
配置数据和用户数据	如果要卸载用户数据所在的 Directory Server 实例，则卸载过程将删除 Directory Server LDAP 数据库。注意：为避免丢失数据，请确保在卸载前备份 Directory Server 信息。Directory Server 提供了多种工具和实用程序，用以备份 Directory Server 以及迁移配置数据。
依赖性	无
需要此安装的产品	Access Manager Portal Server
卸载前的任务	根据需要备份 Directory Server LDAP 数据库。
卸载后的任务	如果随后要在同一位置安装 Directory Server，该安装目录不得存在。在重新安装到同一位置之前，您可能需要手动删除安装目录及任何自定义配置文件。

Message Queue 的卸载行为

表 7–5 Message Queue 的卸载详细信息


主题	详细信息
配置数据	卸载后实例特有的配置数据、用户信息库及存取控制文件仍得到保留，可在以后重新安装时重复使用它们。
此组件需要的其他安装	Directory Server（可选）
需要此安装的产品	Application Server（必须与 Message Queue 驻留在同一台主机上）
卸载前的任务	停止运行任何代理。将提示您输入用户名（管理员）和密码：`imqcmd shutdown bkr` [ `-b` `hostName:port`] 如果不打算重新安装 Message Queue，因此想要删除动态数据、平面文件用户系统信息库以及与每个代理实例相关联的访问控制文件，请使用以下命令删除这些数据。`imqbrokerd -name` `instanceName` `-remove` `instance` 如果使用 Message Queue 升级脚本升级 Message Queue，请记录您的进程。升级脚本不会将安装信息写入到 Java ES 注册表中。
卸载后的任务	如果不打算重新安装 Message Queue，请使用 Java ES 组件文档中的命令清理系统。

Monitoring Console 的卸载行为

表 7–6 Monitoring Console 的卸载详细信息


主题	详细信息
配置数据	卸载后，用户数据仍会保留。但要在执行任何重新安装之前删除这些数据。
依赖性	无
需要此安装的其他产品	无
卸载前的任务	无
卸载后的任务

Portal Server 的卸载行为

表 7–7 Portal Server 的卸载详细信息


主题	详细信息
配置数据和用户数据	卸载过程中将删除配置数据。取消配置包括删除 Portal Server 在 Access Manager 中创建的服务。用户频道的提供者在安装过程中不会被删除，并可在后续安装中再次使用。卸载程序不会删除自定义配置数据（显示配置文件、属性文件、资源字符串以及其他自定义内容）。在后续安装中，仅当使用相同的配置在同一台主机上重新安装 Portal Server 时，才能够再次使用这些配置数据。
此组件需要的其他安装	Directory Server Application Server 或 Web Server Access Manager Service Registry
需要此安装的产品	无
卸载前的任务	检验 Directory Server 和 Web 容器是否在运行。
卸载后的任务	如果要在 Web Server 中运行 Portal Server，并且选择只删除 Portal Server，则必须重新启动 Access Manager。有关更多信息，参阅Access Manager 的卸载行为。

Portal Server Secure Remote Access 的卸载行为

表 7–8 Portal Server Secure Remote Access 的卸载详细信息


主题	详细信息
配置数据	卸载过程中会删除 Portal Server Secure Remote Access Core 组件的所有配置数据。取消部署所有已部署的 Web 应用程序。用户无权访问 Portal Server Secure Remote Access Gateway、Netlet Proxy 及 Rewriter Proxy 子组件的配置数据。
此组件需要的其他安装	Portal Server Secure Remote Access 依赖于 Portal Server，且不能与 Portal Server 分开卸载。 Portal Server Secure Remote Access Gateway、Netlet Proxy 和 Rewriter Proxy 子组件依赖于 Access Manager SDK。 Portal Server 和 Portal Server Secure Remote Access Support 必须驻留在同一台主机的同一个目录中。 Access Manager SDK 必须与 Gateway、Netlet Proxy 和 Rewriter Proxy 驻留于同一台主机上。Gateway、Netlet Proxy 和 Rewriter Proxy 不能在同一个目录中。您可删除任何 Portal Server Secure Remote Access 组件而不删除任何依赖 Java ES 组件。可以删除 Gateway 而将 Access Manager SDK 留在主机上。
需要此安装的产品	无
卸载前的任务	无
卸载后的任务	无

如果 SRA 进行了配置，则首先使用 psadmin 命令手动卸载 SRA 组件。

卸载 SRA 组件：

停止 SRA 实例。

stop-sra-instance --adminuser userid --passwordfile password-filename --name sra-instance-name --type instance-type --hostname instance-hostname

删除 SRA 实例。

psadmin delete-sra-instance --adminuser userid --passwordfile password-filename --name sra-instance-name --type instance-type --hostname instance-hostname

注 –
经过配置的 SRA 组件不能通过卸载程序进行卸载。因此，需要手动卸载已经配置的 SRA 组件。如果手动卸载失败，则会导致在同一台主机上执行后续一连串安装时出现问题。

Service Registry 的卸载行为

表 7–9 Service Registry 的卸载详细信息


主题	详细信息
配置数据	Registry 配置进程会将 Registry 数据库域和服务器密钥库安装在 `JavaES-install-dir` 目录中。卸载 Service Registry 时，不会删除该目录。通过此安全机制，您可以根据需要保留该数据库以用于将来的安装或发行版本。
此组件需要的其他安装	Application Server（Domain Administration Server 和 Command-Line Administration Tool） HADB Message Queue
需要此安装的产品	无
卸载前的任务	1. 如下所示停止 Service Registry 域： `JavaES-install-dir\share\ant\bin\ant.bat -f build-install.xml appserver.domain.stop` 2. 如下所示删除 Service Registry 域： `JavaES-install-dir\share\ant\bin\ant.bat -f build-install.xml appserver.domain.delete` 如果要保留 Registry 数据库以供将来使用，则在重新安装 Registry 之前，将 `ServiceRegistry-base` 目录复制到其他位置。
卸载后的任务	如果制作了 Registry 数据库的副本，则在重新安装之后，重新复制该数据库。在恢复数据库和密钥库文件（存储于 3.0 目录中）后，通过使用特定于平台的变量运行以下命令： `JavaES-install-dir\share\ant\bin\ant.bat -f build-install.xml appserver.domain.stop export.registryOperatorCert install.cacerts appserver.domain.start` 此命令使现有用户可以继续使用 Service Registry Web Console。

Web Proxy Server 的卸载行为

表 7–10 Web Proxy Server 的卸载详细信息


主题	详细信息
配置数据	仅保留安装位置下别名目录中的证书数据库文件。其他所有文件都将被删除。
依赖性	Directory Server（可选），如果已选择了外部 LDAP 访问控制。
卸载前的任务	停止 Web Proxy Server 的所有实例。
卸载后的任务	证书数据库保留在 `WebProxyServer-base\alias` 目录下。在重新安装之前，需要移动证书数据库并删除旧的安装目录。

Web Server 的卸载行为

表 7–11 Web Server 的卸载详细信息


主题	详细信息
配置数据和用户数据	完成卸载之前，Web Server 管理服务器和 Web Server 实例已停止。卸载程序只有处于运行状态，才能删除 Web Server 安装目录或实例目录。
此组件需要的其他安装	无
需要此安装的产品	配置为将 Web Server 用作 Web 容器的组件：Access Manager 和 Portal Server。还有 Application Server Load Balancing Plug-in（如果 Application Server 将 Web Server 用作其 Web 容器）。
卸载前的任务	无
卸载后的任务	要保留配置数据，请在安装位置备份 Administrative Server 和 Web Server 实例目录。如果随后要在同一位置安装 Web Server，该安装目录不得存在。在重新安装到同一位置之前，您可能需要手动删除安装目录及任何自定义配置文件。

在图形模式下运行卸载程序

完成检验先决条件中的相关任务后，即可运行卸载程序。

启动 Windows 向导/图形卸载程序

选择“开始”>“设置”>“控制面板”。

双击“添加/删除程序”。

选择 "Sun Java Enterprise Systems"。

单击“更改/删除”。

将出现修改或删除该程序的“欢迎”页面。

修改当前安装

在 Install Shield 向导中选择“修改”，以添加新的程序功能或删除当前安装的功能。

单击“下一步”。

将出现“组件选择”页面。

检查组件。
- 已安装在系统中的组件处于启用状态并且可以进行选择。未安装在系统中的组件处于禁用状态并且无法进行选择。
  - 某些组件包含子组件。展开这些组件可以查看子组件。
  - 如果取消选择一个包含子组件的组件，则展开该组件以检验子组件列表。

选择要安装的组件，取消选择要卸载的组件。单击“下一步”。

卸载程序即会修改软件。

删除所有已安装的组件

在 Install Shield 向导中选择“删除”。

单击“下一步”。

将显示确认对话框。

单击“是”以确认删除。

将显示“安装状态”页面，随后显示“取消配置”对话框。

单击“是”以确认取消配置 Java ES 组件。

将取消产品的配置，并停止和删除服务器。

将显示向导的“完成”页面。可单击“查看摘要”按钮来查看安装或卸载的详细信息摘要。

单击“完成”以退出卸载向导。

在无提示模式下运行卸载程序

对于卸载那些安装在共享类似配置的多台主机上的 Java ES 组件，无提示卸载非常有用。无提示模式下的卸载过程与无提示模式下的安装过程（如第 4 章，以无提示模式安装中所述）相类似。

在无提示模式下执行卸载

切换到安装程序所在的目录：

cd JavaES-install-dir

使用 Setup.bat/r 命令创建响应文件。

使用 /f1 选项来指定响应文件的创建位置并提供一个名称。为避免出现无法预料的结果，为扩展名为 .iss 的文件指定一个绝对路径。例如，键入：

Setup.bat /r /f1"C:\Temp\UninstallExample.iss"

键入的所有数据和选定的选项会记录在 .iss 文件中。

响应文件已准备就绪，可以用于在记录卸载期间所选择的选项。可手动编辑响应文件来修改所记录的选项。

现在便可使用响应文件来启动无提示卸载。

切换到安装程序所在的目录。

cd JavaES-install-dir

键入命令 Setup.bat/s 选项来启动无提示模式卸载进程。

使用 /f1 选项指定 .iss 文件位置。为避免出现无法预料的结果，请指定一个绝对路径。例如，键入：

Setup.bat /s /f1" C:\Temp\UninstallExample.iss"。

（可选的）使用 /f2 选项来指定日志文件的替代名称和位置。为避免出现无法预料的结果，为该文件指定一个绝对路径。例如，键入：

Setup.bat /s /f1"C:\Temp\UninstallExample.iss /f2" C:\Setup.log"。

卸载程序运行过程中，可通过检查安装日志的变化来监视卸载进度。

第 7 章 卸载 Java ES 组件