![]() |
Sun ONE Application Server 7, Update 1 安装指南 |
升级 Sun ONE Application Server 软件本模块介绍如何升级 Sun Open Net Environment (Sun ONE) Application Server 7 软件的现有安装。
本文包括以下主题:
准备升级
Sun ONE Application Server 升级程序使您可以升级 Sun ONE Application Server 7 的现有安装,而无需重新安装全部产品。升级功能适用于基于软件包的安装以及 tar 或 zip 安装,具体情况取决于操作系统的特定机制。
本节包括以下主题:
升级组件
Sun ONE Application Server 7 Update 1 升级组件是作为一个压缩的归档文件提供的,其中包含 setup 文件、README 文件、供升级程序使用的配置文件、日志文件以及要升级的 Sun ONE Application Server 软件包。
要求和限制
- 访问特权
- 管理服务器和实例 — 管理服务器和应用程序服务器实例在升级进行期间无法运行。如果它们正在运行,将被升级程序停止。
- 升级位置 — 在上一次安装中如果未安装默认位置,则需要编辑 config_01 文件以指定正确位置。
- 配置文件 — 升级过程中不能修改 Sun ONE Application Server 配置文件。否则,当配置文件复制回其安装位置时,这些修改将被覆盖。
- 解压缩公用程序,并且 pkgadd 必须存在于 PATH 环境变量中。
- 系统上必须安装有 Perl(最低 5.0.0)。
- JDK 和 Sun ONE Message Queue — 升级程序不会升级任何现有 JavaTM 开发工具包 (JDK) 或 Sun ONE Message Queue 软件。这些软件被认为是共享资源,因此应由客户自己根据需要升级这些软件。
- NSS/NSPR 软件包 — 要进行升级,现有的 Sun ONE Application Server 中必须存在 Netscape Security Services (NSS) 和 Netscape Portable Runtime (NSPR) 软件包。如果 NSS/NSPR 软件包不存在,则不应继续升级。因为这表明 Sun ONE Application Server 要么未安装,要么已经毁坏。无论是哪种情况,您都必须完整地安装 Sun ONE Application Server 软件。
- 当升级进程运行时,请勿修改以下文件:
- 中断升级 — 如果需要中断升级,可以执行此操作,然后从中断位置重新启动升级。但是,在完成升级之前,所升级的服务器实例将处于一种不一致的状态。因此,您应当完成已启动的升级,这一点很重要。
- JDK 和 Sun ONE Message Queue — 升级程序不升级任何现有的 Java Developers Kit (JDK) 或 Sun ONE Message Queue 软件。这些软件被认为是共享资源,因此应由客户自己根据需要升级这些软件。为方便起见,Sun ONE Application Server 7 Update 1 下载归档文件的 /imq 目录下提供了 Sun ONE Message Queue 的最新支持版本。有关说明包含在该目录下的 README 中。
升级程序如何工作
升级程序是一个 Perl 脚本,它使用一个输入文件和一个软件包列表文件来确定升级的参数。对于基于软件包的安装,package-list 文件中包含了一个需要升级的软件包列表。
本节包括以下主题:
升级输入文件
config_01 文件包含升级程序升级 Sun ONE Application Server 软件所需的位置。config_01 文件中的条目指定了以下位置:
- ASINSTDIR — Sun ONE Application Server 安装目录。这是 Sun ONE Application Server 二进制文件所在的位置。
- ASCONFDIR — Sun ONE Application Server 配置文件目录。这是 domains.bin、ppserv.lic 和 asenv.conf 文件所在的位置。
- ASDOMAINSDIR — Sun ONE Application Server 域目录。这是文件夹域所在的位置。
- ASLOCALE — Sun ONE Application Server 语言环境。如果不确定此位置,请检查 ASCONFDIR/asenv.conf 文件中的 AS_LOCALE。
- ASJAVADIR — Sun ONE Application Server 使用的 JDK 目录的位置。
如果在初始安装过程中选择了默认安装位置,输入文件中的位置将是正确的,并且不需要编辑该文件。
如果未接受默认安装位置,则需要编辑输入文件。
默认输入文件示例
config_01
BASEDIR = /opt
ASINSTDIR=/opt/SUNWappserver7
ASCONFDIR=/etc/opt/SUNWappserver7
ASDOMAINSDIR = /var/opt/SUNWappserver7
ASLOCALE = en_US
ASJAVADIR = /usr/j2sepackage-list
SUNWasacmo
SUNWasro
SUNWasaco
SUNWjaxp
SUNWxrpcrt
SUNWaso
.version
7.0.0_01升级进程
升级进程分为三个阶段:备份、安装和重新配置。系统提供了日志文件,用于在这三个阶段中监视升级进程并提供疑难解答。
本节包括以下主题:
备份阶段
升级进程开始时,升级程序将 Sun ONE Application Server 配置文件复制到一个单独位置,以使其不会受到升级进程的影响。在升级结束时的重新配置阶段,这些文件将被复制回它们原来的位置。
备份目录位于在其中解压缩和展开升级文件的目录下。
安装阶段
在安装阶段,升级程序将验证具有足够的磁盘空间用于相关软件包的升级,然后在系统上安装升级组件。
如果安装阶段失败,则调用升级脚本时将在最后一个完全安装的软件包之后重新启动安装。升级程序将查看审计文件以确定升级进程的中断位置,然后在适当位置处重新启动。例如,如果五个软件包中有三个已经安装,但在安装第四个软件包时发生错误,则重新启动操作将重新开始安装第四个软件包。
重新配置阶段
在重新配置阶段,原来的 Sun ONE Application Server 配置文件将被复制回安装位置。
您可以决定是否在升级期间禁止他人修改 Sun ONE Application Server 配置文件;升级程序本身没有提供这种机制。
日志文件
升级程序的事件、错误和状态被记录到以下文件中:
升级日志文件
在活动的升级进程中,升级事件和错误被捕获到 upgrade.log 文件中。对于常见错误,此文件包含了最可能需要执行的操作,以便于您参考。
审计文件
审计文件 .audit_upgrade 用于维护升级的状态。如果发生故障并重新启动升级进程,则可能需要使用此文件。使用审计文件,可以通过在最后一个完全安装的组件之后重新启动升级来恢复升级进程。
审计文件位于在其中解压缩和展开升级文件的目录下。
注意 不能编辑 .audit_upgrade 文件。否则,任何重新启动都将失败。
升级 Sun ONE Application Server
Sun ONE Application Server 升级文件可在以下位置获得:
在下载站点,您将看到一些可用归档文件。例如,Sun ONE Application Server 7 Update 1 归档文件的版本是 7.0.0_01。
请执行以下步骤升级 Sun ONE Application Server 软件:
- 确保您已查看了“要求和限制”中介绍的信息。
- 验证 Netscape Security Services (NSS) 和 Netscape Portable Runtime (NSPR) 软件包是否存在。有关这些软件包的信息和说明,请参见“所需的 Solaris 修补程序”。
- 将压缩的升级版本归档文件下载到目标计算机上(XX 表示版本)。
对于 Solaris — sun-appserver7-upgrade01-sol-sparc.tar.gz
对于 Microsoft Windows — sun-appserver7-upgrade01-win.zip
- 解压缩并展开升级版本归档文件。您将看到以下升级组件:
SUNWaso、SUNWascmno、SUNWasro、SUNWjaxp、SUNWasaco、SUNWxrpcrt
- 如果在安装过程中未接受默认安装位置,请编辑 config_01 输入文件,使其包含以下条目。如果接受了默认位置,可以跳过此步骤。也就是说,此文件必须反映您的实际位置。
ASINSTDIR=/opt/SUNWappserver7
ASCONFDIR=/etc/opt/SUNWappserver7
ASDOMAINSDIR=/var/opt/SUNappserver7
ASLOCALE=en_US
ASJAVADIR=/usr/j2se
- 如下所示调用升级脚本:
./setup
升级程序将验证当前安装的 Sun ONE Application Server 的配置文件(版本号、是否基于软件包)。如果此配置文件对于所选升级不是正确的配置文件,将显示一条错误消息。
请解决问题并重新启动升级。
升级程序将确定是否有足够的可用空间进行升级。如果空间不足,将显示一条错误消息。
请解决问题并重新启动升级。
升级程序将检测任何正在运行的 Sun ONE Application Server 进程,并在继续升级之前停止这些进程。
- 升级程序将针对您所选择的升级类型提出相应的问题。
请根据您的站点情况对提示进行响应。
- 升级组件将安装到您在升级输入文件中指定的位置。
- 升级完成后,启动管理服务器和应用程序服务器实例。有关说明,请参见“启动和停止服务器”。
- 通过运行 asadmin version 命令,验证升级是否成功。您应当看到新的 Sun ONE Application Server 升级版本。
疑难解答
本节介绍升级过程中可能遇到的问题,并提供了一些建议的解决方案。
重新启动或中断升级
- 重新启动和升级 — 因为任何原因要重新启动升级进程时,先删除 setup 脚本所在目录下的 .audit_upgrade 文件,然后重新启动升级。
- 中断升级 — 如果需要中断升级,可以执行此操作,然后从中断位置重新启动升级。但是,在完成升级之前,所升级的服务器实例将处于一种不一致的状态。因此,您应当完成已启动的升级,这一点很重要。
错误情况
- 如果是特定于系统的错误 — 例如,如果基于软件包的安装总是失败,请检查软件包安装日志。
- 如果是特定于为备份指定的位置的错误 — 请检查您对指定目录的访问权限。
- 如果是特定于用户 ID 的错误(在 Tarball 安装情况下)— 请检查您对安装目录和备份目录的权限。
- 如果在备份阶段发生错误 — 可以重新启动升级脚本。此阶段最可能发生的错误与空间限制有关。解决所有问题后,可以在中断的位置重新启动升级程序。
- 如果在重新配置阶段发生错误,则问题通常是由系统崩溃或其它中断所致。解决所有问题后,可以在中断的位置重新启动升级程序。