Sun ONE logo      Previous      Contents      Index      Next     

Sun ONE Application Server 7 Installation Guide

Chapter 6
Upgrading the Sun ONE Application Server Software

This chapter contains instructions for upgrading an existing installation of the Sun™ Open Net Environment (Sun ONE) Application Server 7 software.

The following topics are addressed here:

Preparing to Upgrade

The Sun ONE Application Server upgrade program allows you to upgrade an existing Sun ONE Application Server 7 installation without needing to re-install the complete product. The upgrade functionality works for package-based installations as well as tar or zip installations, relying on operating system-specific mechanisms wherever necessary.

This section addresses the following topics:

Upgrade Components

The Sun ONE Application Server 7 Update 1 upgrade is distributed as a compressed archive which contains the setup file, a README file, configuration files used by the upgrade program, log files, and the Sun ONE Application Server packages to be upgraded.

Requirements and Restrictions

How the Upgrade Program Works

The upgrade program is a Perl script that uses an input file and a package list file to determine the parameters of your upgrade. For a package-based installation, a list of packages that need to be upgraded is contained in the package-list file.

The following topics are discussed in this section:

Upgrade Input File

The config_01 file contains the locations that the upgrade program will need to upgrade your Sun ONE Application Server software. The entries in the config_01 file specify the following locations:

If you selected the default installation locations during your initial installation, the locations in the input file will be correct and you do not need to edit the file.

If you did not accept the default installation locations, you will need to edit the input file.

Example Default Input File


BASEDIR = /opt
ASINSTDIR = /opt/SUNWappserver7
ASCONFDIR = /etc/opt/SUNWappserver7
ASDOMAINSDIR = /var/opt/SUNWappserver7
ASJAVADIR = /usr/j2se



Upgrade Process

The upgrade process consists of three phases: backup, installation, and reconfiguration. Log files are provided for monitoring and troubleshooting the upgrade process through these phases.

This section discusses the following topics:

Backup Phase

At the start of the upgrade process, the upgrade program copies your Sun ONE Application Server configuration files to a separate location so they will not be affected by the upgrade process. In the reconfiguration phase at the end of the upgrade, these files are copied back to their original locations.

The backup directory is located under the directory where you uncompressed and expanded the upgrade files.

Installation Phase

During the installation phase, the upgrade program verifies that there is enough disk space available to do an upgrade of the relevant packages and then installs the upgrade components on the system.

If the installation phase fails, invoking the upgrade script will restart the installation after the last fully-installed package. The upgrade program refers to the audit file to see where the upgrade process was interrupted, and restarts appropriately. For example, if three out of five packages are already installed and an error occurs during installation of the fourth package, a restart would initiate a complete installation of the fourth package.

Reconfiguration Phase

In the reconfiguration phase, your original Sun ONE Application Server configuration files are copied back to the installation location.

It is up to you to prevent others from modifying the Sun ONE Application Server configuration files during upgrade; the upgrade program has no mechanism for preventing this.

Log Files

The events, errors, and status of the upgrade program are logged to the following files:

Upgrade Log File

Upgrade events and errors are captured in the upgrade.log, file during the active upgrade process. For commonly-encountered errors, the most likely action needed is included in this file for your convenience.

Audit File

An audit file,.audit_upgrade, is used to maintain the state of the upgrade, which might be needed if failure occurs and the upgrade process is restarted. Using the audit file, the upgrade process can recover by restarting the upgrade after the last fully-installed component.

The audit file is located under the directory where you uncompress and expand the upgrade files.


The .audit_upgrade file must not be edited. If it is, any restart will fail.

Upgrading the Sun ONE Application Server

Sun ONE Application Server upgrade downloads are available at the following location:

At the download site, you will see a number of available archives. For example, the Sun ONE Application Server 7, Update 1 archive is version 7.0.0_01.

Perform the following steps to upgrade your Sun ONE Application Server software:

  1. Verify that you have reviewed the information discussed in "Requirements and Restrictions".
  2. Verify the presence of the Netscape Security Services (NSS) and Netscape Portable Runtime (NSPR) packages. Refer to "Solaris Patches Required" for information and guidelines on these packages.
  3. Download the compressed upgrade release archive to the target machine (XX indicates the version).
    • For Solaris—sun-appserver7-upgrade01-sol-sparc.tar.gz
    • For Microsoft Windows—
  4. Uncompress and expand the upgrade release archive. You will see the following upgrade components:
    • setup
    • README.txt
    • config_01
    • package-list
    • .version
    • SUNWaso, SUNWascmno, SUNWasro, SUNWjaxp, SUNWasaco, SUNWxrpcrt
  5. If the default installation locations were not accepted during installation, edit the config_01 input file to contain the following entries. If you accepted the default locations, you can skip this step. In other words, this file must reflect the your actual locations.
  6. ASINSTDIR=/opt/SUNWappserver7

  7. Invoke the upgrade script as follows:
  8. ./setup

    1. The upgrade program verifies the profile (version number, package-based or not) of your currently-installed Sun ONE Application Server. If it is not correct for the upgrade you selected, an error message displays.
      • Resolve the problem and restart the upgrade.
    2. The upgrade program determines if you have enough free space to perform the upgrade. If you do not, an error message displays.
      • Resolve the problem and restart the upgrade.
    3. The upgrade program detects any running Sun ONE Application Server processes and stops them before continuing to upgrade.
  9. The upgrade program presents you with queries appropriate to the type of upgrade you selected.
  10. Respond to the prompts as appropriate for your site.

  11. The upgrade components will be installed in the locations specified in the upgrade input file.
  12. After the upgrade is complete, start the Admin Server and the application server instances. Instructions can be found in “Starting and Stopping the Server” on page 95.
  13. Verify that the upgrade succeeded by running the asadmin version command. You should see the new upgraded version of the Sun ONE Application Server.


This section discusses possible problems that can occur during the upgrade process, and provides some suggested solutions.

To Restart or Interrupt an Upgrade

Error Situations

Previous      Contents      Index      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.