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

计划卸载

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

本节包含以下各小节:

检查已安装的 Java ES 软件

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

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

  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. 查看已安装产品组件的列表之后,请退出卸载程序。

    未卸载任何软件。

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

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

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

    prodreg

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

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

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


注 –

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


本节包含以下各小节:

Access Manager 卸载行为

表 8–2 Access Manager 卸载详细信息

主题 

详细信息 

配置数据 

不会移除 Directory Server 中的任何条目(包括 Access Manager 特有的数据)。 

此组件需要的其他安装组件 

Directory Server 

Web 容器 

需要此安装的产品 

Portal Server(必须与 Access Manager SDK 驻留在同一台主机上)。 

卸载前的任务 

使用此文件移除该模式: 

Solaris OS: /etc/opt/SUNWam/config/ldif/ds_remote_schema_uninstall.ldif

Linux 和 HP-UX: /etc/opt/sun/identity/config/ldif/ds_remote_schema_uninstall.ldif

卸载后的任务 

仅对于 Web Server 或 Application Server 上的完全安装,卸载时才会取消配置 Web 容器中的 Access Manager。不会取消配置第三方 Web 容器中的 Access Manager。卸载也不会将任何 Web 容器上的 SDK 取消配置。 

另外,还要移除目录 /var/sadm/install 中的以下文件(如果存在):

.lockfile.pkg.lock

有关其他卸载后问题的信息,参阅Access Manager 卸载后的问题

Application Server 卸载行为

表 8–3 Application Server 卸载详细信息

主题 

详细信息 

配置数据和用户数据(仅限 Solaris OS 和 Linux) 

  • 在安装期间创建的默认域在卸载期间将被移除。

  • 在卸载期间不会移除用户创建的域,包括所有管理服务器和 Application Server 实例。

  • 所有 Administration Server 和 Application Server 实例将在卸载完成之前停止。

此组件需要的其他安装组件 

要求 Message Queue 位于同一系统上。 

需要此安装的产品 

配置为将 Application Server 用作 Web 容器的组件。 

卸载前的任务 

要保留配置数据,请生成一份管理域目录的副本。 

卸载后的任务 

要从系统上完全移除 Application Server,请移除遗留的所有 Application Server 日志文件和目录。Application Server 目录的默认位置是: 

Solaris OS: 

/var/opt/SUNWappserver

/opt/SUNWappserver/appserverApplicationServer-base

Linux 和 HP-UX: 

/var/opt/sun/appserver

/opt/sun/appserver

有关 Message Queue 卸载后任务的信息,参阅Message Queue 卸载行为

Directory Proxy Server 卸载行为

表 8–4 Directory Proxy Server 卸载详细信息

主题 

详细信息 

配置数据 

您要卸载的 Directory Proxy Server 实例的配置数据在卸载过程将被移除。 

卸载后将保留若干个 Directory Proxy Server 实例共享的配置数据。 

Directory Proxy Server 没有用户数据。 

此组件需要的其他安装组件 

Directory Proxy Server 对本地或远程 Directory Server 具有逻辑依赖性。 

需要此安装的产品 

无 

卸载前的任务 

无 

卸载后的任务 

无 

Directory Server 卸载行为

表 8–5 Directory Server 卸载详细信息

主题 

详细信息 

配置数据和用户数据 

如果要卸载用户数据所在的 Directory Server 实例,则卸载过程将移除 Directory Server LDAP 数据库。 

注意:为避免丢失数据,请确保在卸载前备份 Directory Server 信息。Directory Server 提供了多种备份 Directory Server 以及移植配置数据的工具和实用程序。有关更多信息,参阅位于 http://docs.sun.com/coll/1224.1http://docs.sun.com/coll/1606.1 的 Directory Server 文档。

此组件需要的其他安装组件 

无 

需要此安装的产品 

  • Access Manager

  • Portal Server

卸载前的任务 

  • 根据需要备份 Directory Server LDAP 数据库。

  • 确保可以提供 Directory Server 实例路径。

卸载后的任务 

如果以后在同一位置安装 Directory Server,必须删除安装目录。在重新安装到同一位置之前,可能需要手动移除安装目录及任何自定义配置文件。 

HADB 卸载行为

表 8–6 HADB 卸载详细信息

主题 

详细信息 

配置数据和用户数据 

在卸载过程中不会移除配置和用户数据。默认情况下,此数据位于以下位置: 

  • Solaris OS 和 Linux:/etc/opt/SUNWhadb /var/opt/SUNWhadb

  • HP-UX:/etc/opt/sun-hadb/var/opt/sun-hadb

此组件需要的其他安装组件 

无 

需要此安装的产品 

如果 Application Server 配置为将 HADB 用于高可用性会话持久性,则需要进行此安装。 

卸载前的任务 

如果计划升级 HADB 并重复使用配置数据,参阅《适用于 UNIX 的 Sun Java Enterprise System 5 升级指南》中有关 High Availability Session Store 的那一章。

卸载后的任务 

移除不再需要的配置和用户数据。 

Message Queue 卸载行为

表 8–7 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 注册表。有关更多信息,参见《适用于 UNIX 的 Sun Java Enterprise System 5 升级指南》

卸载后的任务 

如果不打算重新安装 Message Queue,请使用产品组件文档中的命令清理系统。 

Monitoring Console 卸载行为

表 8–8 Monitoring Console 卸载详细信息

主题 

详细信息 

配置数据 

卸载后用户数据继续保留,但会在任何重新安装前被移除。 

此组件需要的其他安装组件 

无 

需要此安装的其他产品 

无 

卸载前的任务 

无 

卸载后的任务 

要保留数据,请将以下文件复制到一个持久不变的位置,然后在重新安装后将其复制回原位置: 

对于 Solaris OS: 

/etc/opt/SUNWmfwk/config/mfwk.properties

/etc/opt/SUNWmfwk/config/masteragent.properties

/etc/opt/SUNWmfwk/config/nodelist

/var/opt/SUNWmfwk/persistence/

/var/opt/SUNWmfwk/alarms/

对于 Linux 和 HP-UX: 

/etc/opt/sun/mfwk/config/mfwk.properties

/etc/opt/sun/mfwk/config/masteragent.properties

/etc/opt/sun/mfwk/config/nodelist

/var/opt/sun/mfwk/persistence/

/var/opt/sun/mfwk/alarms/

Portal Server 卸载行为

表 8–9 Portal Server 卸载详细信息

主题 

详细信息 

配置数据和用户数据 

  • 卸载过程中将移除配置数据。取消配置包括移除 Portal Server 在 Access Manager 中创建的服务。

  • 用户频道的提供程序在安装过程中不会被移除,并且可在后续安装中重复使用。

  • 卸载程序不会移除定制的配置数据(显示配置文件、属性文件、资源字符串以及其他定制内容)。仅当使用相同配置将 Portal Server 重新安装到同一台主机时,才可以在后续安装时重复使用这些数据。

此组件需要的其他安装组件 

  • Directory Server

  • Application Server 或 Web Server(也可以配置为依赖于 Solaris OS 上的 IBM WebSphere 或 BEA WebLogic。)

  • Access Manager

  • Service Registry

需要此安装的产品 

无 

卸载前的任务 

检验 Directory Server 和 Web 容器是否在运行。如果 Web 容器是 Web Server,则 Web Server 管理服务器必须处于运行状态。 

卸载后的任务 

  • 如果要在 Web Server 中运行 Portal Server,并且选择只移除 Portal Server,则必须重新启动 Access Manager。有关更多信息,参阅Access Manager 卸载后的问题

  • 如果将 Portal Server 部署到 IBM WebSphere Web 容器中,则可能会有其他卸载任务。

Portal Server Secure Remote Access 卸载行为

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

主题 

详细信息 

配置数据 

  • 卸载期间会移除 Portal Server Secure Remote Access 核心产品组件的所有配置数据。

  • 取消部署所有已部署的 Web 应用程序。

  • 用户无权访问 Portal Server Secure Remote Access Gateway、Netlet Proxy 及 Rewriter Proxy 子组件的配置数据。

此组件需要的其他安装组件 

  • Portal Server Secure Remote Access Gateway、Netlet Proxy 和 Rewriter Proxy 依赖于 Portal Server。不能移除 Portal Server 并要保留 Gateway、Netlet Proxy 和 Rewriter Proxy。

  • Portal Server Secure Remote Access Gateway、Netlet Proxy 和 Rewriter Proxy 子组件依赖于 Access Manager SDK。

  • Access Manager SDK 必须与 Gateway、Netlet Proxy 和 Rewriter Proxy 驻留于同一台主机上。Gateway、Netlet Proxy 和 Rewriter Proxy 不能在同一个目录中。

  • 您可移除任何 Portal Server Secure Remote Access 产品组件,无需移除任何依赖产品组件。

  • 可以移除 Gateway 而将 Access Manager SDK 留在主机上。

需要此安装的产品 

无 

卸载前的任务 

无 

卸载后的任务 

无 

Service Registry 卸载行为

表 8–11 Service Registry 的卸载详细信息

主题 

详细信息 

配置数据 

在 Registry 配置过程中会将 Registry 数据库域和服务器密钥库安装在以下目录中: 

  • Solaris OS:/var/opt/SUNWsrvc-registry

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

卸载 Service Registry 时,不会移除该目录。这样您便可以根据需要保留数据库以用于未来的安装或发行版。 

此组件需要的其他安装组件 

Application Server(Domain Administration Server 和 Command-Line Administration Tool) 

HADB 

Message Queue 

需要此安装的产品 

无 

卸载前的任务 

1. 导航至 ServiceRegistry–base /install 目录。

2. 按以下所示停止 Service Registry 域: 

.../ant -f build-install.xml appserver.domain.stop

3. 按以下所示删除 Service Registry 域: 

.../ant —f build-install.xml appserver.domain.delete

如果希望保留此 Registry 数据库以备将来使用,请在重新安装 Registry 之前将 /var/opt/SUNWsrvc-registry/3.0 目录(在 Solaris OS 中)或 /var/opt/sun/srvc-registry/3.0 (在 Linux 和 HP-UX 中)目录复制到另一个位置。

卸载后的任务 

有关某些可选任务的信息,参阅Service Registry 卸载后的任务

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

表 8–12 Sun Cluster 和 Sun Cluster Geographic Edition 的卸载详细信息

主题 

详细信息 

配置数据 

请勿使用 Java Enterprise System 卸载程序移除 Sun Cluster 软件,除非软件在安装后从未用于配置群集节点,方可以此方式将其移除。有关更多信息,参阅卸载 Sun Cluster 软件

此组件需要的其他安装组件 

必须将包含 Sun Cluster Geographic Edition 组件的每台主机上的 Sun Cluster Geographic Edition 软件移除。有关更多信息,参阅《Sun Cluster Geographic Edition Installation Guide》中的第 5  章 “Uninstalling the Sun Cluster Geographic Edition Software”

必须同时移除 Sun Cluster 核心组件和 Sun Cluster 的代理。 

需要此安装的产品 

无 

卸载前的任务 

仅能使用安装 Sun Cluster 时提供的实用程序卸载 Sun Cluster 软件。 

注:必须在删除 Sun Cluster 软件之前先删除 Sun Cluster Geographic Edition 软件。 

卸载后的任务 

可能需要在卸载 Sun Cluster 软件后更新产品注册表。有关更多信息,参阅卸载 Sun Cluster 软件

Web Proxy Server 卸载行为

表 8–13 Web Proxy Server 卸载详细信息

主题 

详细信息 

配置数据 

仅保留安装位置下别名目录中的证书数据库文件。其他所有文件都将被移除。 

依赖性 

Directory Server(可选)如果已选择了外部 LDAP 访问控制。 

卸载前的任务 

停止 Web Proxy Server 的所有实例。 

卸载后的任务 

证书数据库保留在 WebProxyServer-base /alias 目录下。重新安装前,移动证书数据库并删除旧的安装目录。

Web Server 卸载行为

表 8–14 Web Server 卸载详细信息

主题 

详细信息 

配置数据和用户数据 

  • 卸载过程中,不会移除用户数据,但是会移除配置数据。

  • 将会移除 Web Server 管理服务器实例目录和已配置的 Web Server 实例目录。不会移除初始配置的文档根目录。

  • Web Server 管理服务器和 Web Server 实例会在卸载完成前被中止。

此组件需要的其他安装组件 

无 

需要此安装的产品 

可配置为将 Web Server 用作 Web 容器的组件(如 Access Manager 和 Portal Server)。还有 Application Server Load Balancing Plugin(如果 Application Server 将 Web Server 用作其 Web 容器)。 

卸载前的任务 

确保可以提供 Web 容器的管理员密码。 

卸载后的任务 

要保留配置数据,请在安装位置备份 Administrative Server 和 Web Server 实例目录。 

如果在同一位置重新安装 Web Server,必须删除安装目录。在重新安装到同一位置之前,可能需要手动移除安装目录及任何自定义配置文件。 

有关其他卸载后问题的信息,参阅Web Server 卸载后的任务(Web Server 未卸载)

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

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

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

表 8–15 所需的管理信息

标签和状态文件参数 

说明 

Access Manager

 

管理员用户 ID 

IS_IAS81_ADMIN

Application Server 管理员的用户 ID。 

管理员密码 

IS_IAS81_ADMINPASSWD

Application Server 管理员的密码。 

目录管理员 DN 

IS_DIRMGRDN

对 Directory Server 具有无限制访问权限的用户的标识名 (DN)。 

默认值为 cn=Directory Manager

目录管理员密码 

IS_DIRMGRPASSWD

目录管理员的密码。 

Directory Server

 

管理员用户 ID 

CONFIG_DIR_ADM_USER

对配置目录具有管理员权限的用户。此用户可修改 Directory Server 配置,包括创建和移除后缀。但要受访问控制的限制。 

管理员密码 

CONFIG_DIR_ADM_PASSWD

管理员的密码。 

Portal Server

 

管理员密码 

PS_DEPLOY_ADMIN_PASSWORD

Portal Server 以管理员身份访问 Web 容器时使用的密码。 

Access Manager 管理员密码 

PS_IS_ADMIN_PASSWORD

 

Directory Server 管理员密码 

PS_DS_DIRMGR_PASSWORD

 

Directory Server 管理员域 

PS_DS_DIRMGR_DN