第 8 章 卸载

本章提供卸载 Sun Java^TM Enterprise System (Java ES) 产品组件软件或在 Java ES 安装期间安装的其他 Java ES 相关实用程序的说明。

本章包括以下各节：

• 卸载程序的工作原理

• 检验先决条件

• 计划卸载

• 运行卸载程序

• 卸载 Java ES Reporter

• 卸载 Sun Cluster 软件

• 完成卸载后的任务

卸载程序的工作原理

本节包含以下各小节：

• 卸载程序的限制

• 处理相互依赖性

Java ES 提供了一个卸载程序，用于移除系统中使用 Java ES 安装程序安装的产品组件。与 Java ES 安装程序一样，卸载程序可以在图形模式、基于文本的模式或无提示模式下运行。

安装过程中，Java ES 安装程序会将 Java ES 卸载程序置于以下位置：

• Solaris OS：/var/sadm/prod/SUNWentsys5

• Linux 和 HP-UX：/var/sadm/prod/sun-entsys5

可以使用可选的 -no 参数，在不卸载任何软件的情况下运行卸载程序。此选项有助于您熟悉卸载程序并为随后的无提示卸载创建状态文件。

卸载程序的限制

• 卸载程序只移除由 Java ES 安装程序安装的产品组件。要移除不是由 Java ES 安装程序安装的产品组件，请按照相应产品组件文档中的说明进行操作。

• 卸载程序不会移除 Java ES 共享组件。

• 必须在包含 Java ES 产品组件的每台主机上单独运行卸载程序。不支持远程卸载。对于每个主机，可选择一个或多个产品组件进行移除。

• 卸载程序可能会移除配置和用户数据文件。这些文件对于各组件而言有所不同。卸载过程完成后，您可能需要删除某些其他文件和目录。有关逐个产品的信息，参阅查看 Java ES 产品组件的卸载行为。

• 卸载程序会视多会话卸载的需要为产品组件提供未配置的页面。

• 卸载程序不会取消配置第三方 Web 容器上的安装。

• 卸载程序不会取消配置任何 Web 容器上所安装的 Access Manager SDK。必须手动重新配置 Web 容器（例如，恢复原始类路径）。

请勿使用卸载程序移除 Sun Cluster 软件，除非 Sun Cluster 软件在安装后从未用于配置群集节点。有关更多信息，参见卸载 Sun Cluster 软件。

处理相互依赖性

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

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

  例如，如果试图从同时装有 Portal Server 的主机中卸载 Access Manager，则卸载程序会警告您：没有 Access Manager，Portal Server 将无法发挥作用。

• 大多数情况下，如果没有其他任何产品组件依赖于某个产品组件，则可卸载该产品组件。

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

卸载产品组件时，必须确定为该产品组件所配置的产品（可能需要一些附加配置）。否则，系统中的一些产品组件可能会被配置为支持不再存在的产品。

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

• 远程主机上的依赖性

• 由配置引起的依赖性

远程主机上的产品组件依赖性

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

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

因配置而产生的产品组件依赖性

卸载程序无法识别因安装后配置而产生的产品组件依赖性。

例如，假定您在同一主机上安装 Portal Server 和 Calendar Server，然后配置 Portal Server 以将 Calendar Server 用于 Portal Server 日历频道。在此配置后，Portal Server 依赖于 Calendar Server。但是，如果您在随后卸载 Calendar Server，卸载程序不会警告您 Portal Server 依赖于 Calendar Server，因为卸载程序并不熟悉安装后配置的情况。

检验先决条件

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

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

计划卸载

使用卸载程序前，应检查您的安装并计划可能需要执行的步骤，以防止丢失数据或相关性连接。了解各种 Java ES 产品组件在卸载时的行为方式非常重要。

本节包含以下各小节：

• 检查已安装的 Java ES 软件

• 查看 Java ES 产品组件的卸载行为

• 授予管理员访问卸载程序的权限

检查已安装的 Java ES 软件

执行以下过程之一，查看已安装在每台主机上的 Java ES 产品组件软件。

使用卸载程序查看已安装的软件

1. 以超级用户身份导航到卸载程序所在的目录：

   • Solaris OS：/var/sadm/prod/SUNWentsys5

   • Linux 和 HP-UX：/var/sadm/prod/sun-entsys5

2. 要检查本地主机，运行卸载程序但不卸载软件。

   对于图形模式：

   ./uninstall -no

   对于基于文本的模式：

   ./uninstall -no -nodisplay

   要查看 uninstall 命令的完整语法，参阅 uninstall 命令。

3. 继续执行卸载程序的页面，直至看到已安装产品的列表。

4. 查看已安装产品组件的列表之后，请退出卸载程序。

   未卸载任何软件。

使用 Solaris prodreg 实用程序查看已安装的软件

使用 prodreg 实用程序查看系统中安装的所有软件包（包括 Java ES 产品组件）的相关信息。

这些信息在检查产品组件依赖性时非常有用。prodreg 实用程序还会指出不完整且可能需要特殊处理的软件包。在 Solaris 10 和 Solaris 9 操作系统中，按以下方式运行实用程序：

prodreg

有关更多信息，参见 prodreg 手册页。

查看 Java ES 产品组件的卸载行为

查看本节中的相关表格，以了解卸载程序对每个 Java ES 产品组件执行的操作。计划可能需要执行的步骤，以防止丢失数据或失去相关性连接。

在某些情况下，卸载后会遗留一些组件文件，这些文件可能导致随后的安装失败。如果出现这种情况，参阅由于卸载期间遗留文件导致安装失败以了解有关解决方案的指导。

本节包含以下各小节：

• Access Manager 卸载行为

• Application Server 卸载行为

• Directory Proxy Server 卸载行为

• Directory Server 卸载行为

• HADB 卸载行为

• Message Queue 卸载行为

• Monitoring Console 卸载行为

• Portal Server 卸载行为

• Portal Server Secure Remote Access 卸载行为

• Service Registry 卸载行为

• Sun Cluster 软件和 Sun Cluster Geographic Edition 的卸载行为

• Web Proxy Server 卸载行为

• Web Server 卸载行为

Access Manager 卸载行为

Application Server 卸载行为

Directory Proxy Server 卸载行为

Directory Server 卸载行为

HADB 卸载行为

Message Queue 卸载行为

Monitoring Console 卸载行为

Portal Server 卸载行为

Portal Server Secure Remote Access 卸载行为

Service Registry 卸载行为

Sun Cluster 软件和 Sun Cluster Geographic Edition 的卸载行为

Web Proxy Server 卸载行为

Web Server 卸载行为

授予管理员访问卸载程序的权限

根据用户选择卸载的产品组件，可能需要授予卸载程序对 Access Manager 和 Directory Server 的管理员访问权限。

• 从 Application Server 取消部署 Access Manager Web 应用程序以及移除 Access Manager 模式时，需要具有 Access Manager 管理员访问权限。

• 要在卸载过程中管理配置目录，需要具有 Directory Server 管理员访问权限。

下表介绍了卸载程序在授予管理员访问权限时所需要的信息。每张表的左侧列列出了用户必须提供的信息的图形模式标签和状态文件参数。右侧列提供了附加信息。

运行卸载程序

完成检验先决条件中的相关任务并为组件卸载行为做好规划后，便可运行卸载程序。本节将对卸载程序的三种使用方法进行介绍。

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

• 在基于文本的模式下运行卸载程序

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

可在附录 B，安装命令 中找到有关 uninstall 命令语法的信息。

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

本节提供有关使用交互式图形界面卸载 Java ES 产品组件的说明。

启动图形卸载程序

1. （可选）提供对本地显示的访问。

   如果您要登录到远程计算机，请确保将 DISPLAY 环境变量正确设置为本地显示。如果没有正确设置 DISPLAY 变量，则安装程序将在基于文本的模式下运行。

   • C Shell 示例（机器名 myhost）：

     setenv DISPLAY myhost:0.0

   • Korn Shell 示例（机器名 myhost）：

     DISPLAY=myhost:0.0

     要在本地显示中运行安装程序，可能需要授予显示权限。例如，可以使用以下命令从 myhost 向 serverhost 上的超级用户授予显示权限：

     myhost\> xauth extract - myhost:0.0|rsh -l root serverhost xauth merge -

   ---

   注 –

   有关安全授予此类权限的完整说明，参阅Solaris X Window System Developer's Guide中的 "Manipulating Access to the Server" 一章。

   ---

2. 如果未以 root 身份登录，请成为超级用户。

3. 导航到卸载程序所在的目录：

   • Solaris OS：/var/sadm/prod/SUNWentsys5

   • Linux 和 HP-UX：/var/sadm/prod/sun-entsys5

4. 启动图形卸载程序：

   ./uninstall

   显示“欢迎”页面。

5. 请单击“下一步”继续。

   将显示“组件选择”页面。

选择要卸载的产品组件

1. 检查产品组件并选择要卸载的产品组件。

   • 将启用安装在您系统中的产品组件，并可以选择这些组件。系统上未安装的产品组件会被禁用。

   • 某些产品组件包含子组件。展开这些产品组件以查看子组件。

2. 如果您满意所作的选择，请单击“下一步”。

3. 解决配置或依存关系问题。

   如果卸载程序在选定产品中检测到任何可识别的产品组件依赖性或可能会发生的配置数据丢失，则将显示警告。您可选择：

   1. 单击“继续”，继续卸载。

   2. 单击“关闭”返回到“选择软件组件”页面。

4. 如果显示未配置的页面，则为产品组件输入请求的信息。

授予管理员访问权限

根据您选择要移除的产品组件，卸载程序会提示您输入管理员 ID 和密码。有关必须为卸载程序所提供信息的详细信息，参阅授予管理员访问卸载程序的权限。

此外，卸载程序可能还会提示您输入端口号或主机名。

1. 请提供所需的管理员信息。

2. 单击“下一步”进入“准备卸载”页面。

卸载软件

从系统中移除软件之前，卸载程序会列出已选择要移除的产品组件以及将回收的磁盘空间总量。

1. 查看所进行的卸载选择并按如下所述进行任何必要的更改：

   1. 连续单击页面中的“返回”，直到显示“选择组件”页面为止。

   2. 在此页面上进行必要的更改。

   3. 再次单击“下一步”，以继续进行卸载程序的各个页面。

      卸载程序会记住以前指定的值。您可以修改以前指定的任何值。

2. 当您对所做选择满意时，单击“下一步”。

   卸载程序开始从系统中移除软件并显示如下信息：

   • 显示总完成百分比的进度条

   • 当前正在移除的软件包的名称

   • 删除所有产品组件软件之后，会显示“卸载完成”页面

3. 要了解卸载的有关信息，请单击“查看摘要”或“查看日志”。

   • 卸载摘要。显示已卸载的产品组件以及产品组件的配置信息列表。

   • 卸载日志。显示卸载过程中由卸载程序生成的所有消息。

   • 还可以查看卸载摘要和日志文件：

     Solaris OS：/var/sadm/install/logsLinux 和 HP-UX：/var/opt/sun/install/logs

4. 单击“关闭”退出卸载程序。

5. 如果卸载了 Access Manager 或 Service Registry，转至完成卸载后的任务。

在基于文本的模式下运行卸载程序

基于文本的界面允许您通过响应终端窗口中显示的提示来直接从中运行卸载程序。有关使用指导，参阅如何使用基于文本的界面。

如果在卸载过程中遇到问题，参阅第 9 章，错误诊断。

在基于文本模式下启动卸载程序

1. 如果未以 root 身份登录，请成为超级用户。

2. 导航到卸载程序所在的目录：

   • Solaris OS：/var/sadm/prod/SUNWentsys5

   • Linux 和 HP-UX：/var/sadm/prod/sun-entsys5

3. 运行卸载程序：

   ./uninstall -nodisplay

   将显示“欢迎”消息，随后是系统中所有可能存在的 Java ES 产品组件的列表。

选择要卸载的产品组件

卸载程序通过列出与已安装产品组件对应的号码，选择它在系统中找到的任何要移除的 Java ES 产品组件。未在系统中安装的产品组件将被禁用，并且无法选择这些产品组件。您可以选择卸载所有已安装的组件，也可以选择仅卸载一部分已安装的组件。

1. 选择要卸载的产品组件。

   • 要卸载所有已安装的产品组件，按回车键。

   • 要选择特定产品组件，键入与要卸载的产品组件对应的以逗号分隔的号码列表，然后按回车键。

2. 解决配置或依存关系问题。

   如果卸载程序在选择要移除的产品中检测到产品组件依赖性，则将显示有关可能丢失配置数据的警告。您可选择：

   1. 键入 Yes 并按回车键，继续卸载。

   2. 键入 No 并按回车键，返回到“产品选择”。

   3. 键入字符 ! 并按回车键，退出卸载程序。

3. 如果显示未配置的页面，则为产品组件输入请求的信息。

授予管理员访问权限

如果您选择了卸载程序需要相应管理 ID 或密码的产品组件，则卸载程序将提示您输入管理员 ID 和密码。

有关必须为卸载程序所提供信息的详细信息，参阅授予管理员访问卸载程序的权限。

---

注 –

根据选择要移除的产品组件，卸载程序还可能提示您输入端口号或主机名。

---

卸载软件

从系统中移除软件之前，卸载程序会显示一个摘要页，其中显示选定要移除的产品组件。

1. 请查看您的选择。

   1. 如果需要更改，请键入 < 字符并按回车键，依次返回前面各页，直到显示“产品选择”列表。

   2. 在“产品选择”列表上进行必要的更改。

   3. 重新继续卸载程序的各个屏幕。

2. 当您对所做选择感到满意时，请键入数字 1 并按回车键。

   卸载程序开始从系统上移除软件。卸载过程中，卸载程序将显示一个显示总安装完成百分比的进度条。

   移除所有产品组件软件后，可查看卸载摘要和日志。

3. 键入 1 或 2 并按回车键，查看有关卸载的信息。

   • 卸载摘要。键入 1 可查看已卸载的产品组件以及产品组件的配置信息列表。

   • 卸载日志。键入 2 可列出卸载程序在卸载过程中生成的所有消息。

     还可以查看卸载摘要和日志文件：

     Solaris OS：/var/sadm/install/logsLinux 和 HP-UX：/var/opt/sun/install/logs

4. 键入字符 !，退出卸载程序。

   如果卸载了 Access Manager 或 Service Registry，转至完成卸载后的任务。

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

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

创建状态文件

要执行无提示卸载，首先必须通过在图形模式或基于文本的模式下运行交互式卸载会话来生成状态文件。有关更多信息，参阅生成初始状态文件。

1. 如果未以 root 身份登录，请成为超级用户。

2. 导航到卸载程序所在的目录：

   • Solaris OS：/var/sadm/prod/SUNWentsys5

   • Linux 和 HP-UX：/var/sadm/prod/sun-entsys5

3. 如果要使用卸载程序的图形界面，可能需要提供对本地显示的访问权限。参见在图形模式下运行卸载程序。

4. 运行无提示卸载程序。例如：

   ---

   提示 –

   如果不希望在此会话中卸载软件，加入 –no 选项。

   ---

   图形模式：

   ./uninstall -saveState statefile_path

   基于文本的模式，不卸载软件：

   ./uninstall -no -nodisplay -saveState statefile_path

   要查看 uninstall 命令的完整语法，参阅uninstall 命令。

5. 继续运行卸载程序直到完成。

   在您响应提示时，卸载程序会将您的回答记录在指定的状态文件中。完成卸载后，即可在您指定的位置找到该状态文件。如果使用了 –no 选项，则不会卸载任何软件。

6. 对于要在其中执行无提示卸载的每个主机，制作一份状态文件的副本。

7. 编辑其中包含特定于您运行该无提示卸载所在主机的信息的每个文件。

   有关编辑状态文件的指导原则，参阅编辑状态文件。编辑状态文件可能还包括生成状态文件 ID，如创建合乎平台的状态文件 ID中所述。

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

1. 核实已为要从中卸载 Java ES 产品组件的主机正确准备并编辑了相应的状态文件。

2. 如果未以 root 身份登录，请成为超级用户。

3. 导航到卸载程序所在的目录：

   • Solaris OS：/var/sadm/prod/SUNWentsys5

   • Linux 和 HP-UX：/var/sadm/prod/sun-entsys5

4. 启动卸载程序。例如：

   ./uninstall -noconsole -state statefile_path

   要查看 uninstall 命令的完整语法，参阅uninstall 命令。

监视无提示卸载的进度

1. 在终端窗口中，导航到日志文件目录：

   Solaris OS：/var/sadm/install/logsLinux 和 HP-UX：/var/opt/sun/install/logs

2. 找到当前卸载的日志文件。您要监视的日志文件是：

   Java_Enterprise_System_5_uninstall.Btimestamp

   timestamp 变量表示创建日志的时间。变量格式为 MMddhhmm，其中：

   MM

   指定月份

   dd

   指定日期

   hh

   指定小时

   mm

   指定分钟

3. 使用 tail 命令，在将消息写入日志时对其进行观察。例如：

   tail -f logfile_name

   要退出 tail 程序，按 Ctrl+C 键。

卸载 Java ES Reporter

Java ES Reporter 不是由 Java ES 安装程序管理的组件，因此不能使用卸载程序删除 Reporter。

卸载 Java ES Reporter

1. 禁用 Java ES Reporter

   遵照Java ES Reporter 安装后配置中包含的说明。

2. 以超级用户身份删除以下文件：

   Solaris OS	/opt/SUNWmfwk/lib/commons-codec-1.3.jar /opt/SUNWmfwk/lib/commons-httpcclient-3.0.jar /opt/SUNWmfwk/lib/mfwk_reporter.jar /etc/opt/SUNWmfwk/config/reporter/config.properties /var/opt/SUNWmfwk/jobtool/reporter/job_measurement_reporter.xml /etc/cacao/instances/default/modules/com.sun.mjwk.reporter.xml /etc/opt/SUNWmfwk/config/reporter/config_state.properties
   Linux 和 HP-UX	/opt/sun/mfwk/share/lib/commons-codec-1.3.jar /opt/sun/mfwk/share/lib/commons-httpcclient-3.0.jar /opt/sun/mfwk/share/lib/mfwk_reporter.jar /etc/opt/sun/mfwk/config/reporter/config.properties /var/opt/sun/mfwk/jobtool/reporter/job_measurement_reporter.xml /etc/opt/sun/cacao/instances/default/modules/com.sun.mjwk.reporter.xml /etc/opt/sun/mfwk/config/reporter/config_state.properties

卸载 Sun Cluster 软件

请勿使用 Java ES 卸载程序移除 Sun Cluster 软件，除非 Sun Cluster 软件在安装后从未用于配置群集节点。应使用 Sun Cluster 软件所附带的实用程序卸载 Sun Cluster 软件。必须同时移除 Sun Cluster Core 和用于 Sun Java System 的 Sun Cluster 代理。必须在移除 Sun Cluster 软件之前移除 Sun Cluster Geographic Edition 软件。有关取消配置和卸载 Sun Cluster 软件的更多信息，参阅《Sun Cluster Software Installation Guide for Solaris OS》。

手动卸载 Sun Cluster 软件后，运行 Java ES 卸载程序以从产品注册表中删除 Sun Cluster 组件。

完成卸载后的任务

本节将对从系统中卸载 Java ES 产品组件之后可能需要执行的任务进行说明。实际需要执行的任务取决于选择要卸载的产品组件。

• Access Manager 卸载后的问题

• Access Manager 卸载后的任务（不卸载 Application Server）

• Service Registry 卸载后的任务

• Web Server 卸载后的任务（Web Server 未卸载）

Access Manager 卸载后的问题

如果卸载的是 Access Manager 而非其 Web 容器（Application Server 或 Web Server），需要将配置更改应用于部署了 Access Manager 的实例。

某些情况下，卸载程序可能无法移除某些或全部 Access Manager 文件。在这种情况下，通过删除以下默认目录及其中的内容来进行最后清除：

• 对于 Solaris OS： /opt/SUNWam

• 对于 Linux 和 HP-UX：/opt/sun/identity

或者，如果 Access Manager 未安装在默认位置：

AccessManager_base/identity

Access Manager 卸载后的任务（不卸载 Application Server）

如果卸载的是 Access Manager 而非其部署在的 Application Server，则必须完成以下过程：

卸载 Access Manager 后重新启动 Application Server

1. 如果需要，启动 Application Server 管理实例。例如，在 Solaris 主机上：

   cd /opt/SUNWappserver/appserver/bin ./asadmin start-domain --user admin_user --passwordfile path_to_admin-password_file domainname

2. 在浏览器窗口中，转到 Application Server 管理控制台。默认 URL 为 https://hostname :4849。

3. 在左侧窗格中，单击“Application Server 实例”左侧的图标。

4. 选择在其中部署了 Access Manager 的服务器或 Application Server 实例的名称。

5. 单击“应用更改”。

Service Registry 卸载后的任务

某些情况下，卸载程序可能无法删除某些或全部安装文件。要进行最后清除，删除以下位置处的 ServiceRegistry-base 目录及其内容：

• Solaris OS：/opt/SUNWsrvc-registry

• Linux 和 HP-UX：/opt/sun/srvc-registry

卸载 Registry 时，不会移除包含 Service Registry 数据库、域以及密钥库的目录：

• Solaris OS：/var/opt/SUNWsrcv-registry

• Linux 和 HP-UX：/var/opt/sun/srvc-registsry

如果需要，可以手动将其移除。但是，要保留数据库以备在将来的安装或发行版本中使用，请在重新安装 Registry 之前将以下目录复制到另一位置，然后在重新安装之后将其复制回原位置：

• Solaris OS：/var/opt/SUNWsrvc-registry/3.0

• Linux 和 HP-UX：/var/opt/sun/srvc-registry/3.0

如果是重新安装，如果在安装 Service Registry 之前建立了 Registry 数据库的副本，在重新安装后将其复制回来。在恢复数据库和密钥库文件（存储于 3.0 目录中）后，通过使用特定于平台的变量运行以下命令：

.../ant —f build-install.xml appserver.domain.stop export.registryOperatorCert install.cacerts \
appserver.domain.start

这使现有用户可以继续使用 Service Registry Web Console。

Web Server 卸载后的任务（Web Server 未卸载）

如果卸载的是 Access Manager 而非其部署于其中的 Web Server，则必须完成以下过程。

卸载 Access Manager 后重新启动 Web Server

1. 如果需要，请启动 Web Server 管理实例。参阅启动 Web Server 。

2. 访问 Web Server 管理控制台。例如：

   /var/opt/SUNWwbsvr7 instance-config-root /admin-server/bin/startserv

3. 单击“应用更改”重新启动 Web 容器。