Sun Java logo

 Sun logo
Upgrading from Sun Java System Application Server Platform Edition 8 to Update 1 

Upgrading from Application Server Platform Edition 8 to Update 1

Part Number: 817-7740

This document describes how to upgrade from Sun Java™ System Application Server Platform Edition 8 to Sun Java™ System Application Server Platform Edition 8 Update 1 and preserve server configuration and deployed applications. The following topics are discussed:

Stopping the Domain

Stopping the domain shuts down its administration server and Application Server instance. When you stop a domain, the Application Server instance stops accepting new connections and then waits for all outstanding connections to complete. It may take a few seconds for the server instance to complete its shut-down process.

Stopping the Domain Using the asadmin stop-domain Command

To stop a domain, you type the asadmin stop-domain command and specify the domain name. For example, to stop the default domain (domain1), you type the following:

asadmin stop-domain domain1

If there is only one domain, then the domain name is optional. For the full syntax, type asadmin help stop-domain..

Note

If you created and used additonal server domains other than the default one, you must stop each server domain before proceeding.

Stopping the Domain Using the Admin Console

  1. In the tree component, select the Application Server node.
  2. Select the General tab.
  3. On the General Information page, click Stop Server.

Stopping the Domain Using the Windows Start Menu

On Windows, stop the default domain by selecting Start Programs Sun Microsystems Application Server Stop Default Server.

Note

If you created and used additonal server domains other than the default one, you must stop each server domain before proceeding.

  1. Close any applications accessing Application Server files.

Backing up the Domain Configuration

  1. Create a backup copy of the domain configuration directory.

Uninstalling Application Server Platform Edition 8

  1. Invoke the uninstall program as follows:
    • On UNIX, type one of the following commands at the command prompt:
      • To use the uninstall that has a graphical interface:

        • ./uninstall

      • To use the uninstall that has a command-line interface:

        • ./uninstall -console

    • On Windows, select Start Programs Sun Microsystems Application Server Uninstall.
    • On Windows, you can also invoke the uninstall program through the Control Panel:
      1. Select Start Control Panel.
      2. Select Add/Remove Programs.
      3. Select Java 2 Platform, Enterprise Edition 1.4 SDK from the list of installed programs.
      4. Click Remove.

Installing Application Server Platform Edition 8 Update 1

Installing on Unix

  1. Navigate to the Application Server 8 Update 1 installation directory.
  2. Run the installation program.

    3. In the Installation Directory Selection dialog, enter the directory of the Sun Java System Application Server Platform Edition 8 installation.

    In the Server Configuration dialog, enter the same admin username, password, and port numbers as those used in the Sun Java System Application Server Platform Edition 8 installation.

  3. Proceed with the rest of the installation.

Installing on Windows

  1. Navigate to the Application Server installation directory.
  2. Double click the .exe file to start the installation program.
  3. Follow the instructions on the wizard screens of the installation program.

    4. In the Installation Directory Selection dialog, enter the directory of the Sun Java System Application Server Platform Edition 8 installation.

    In the Server Configuration Dialog, enter same admin username, password, and port numbers as those used in the Sun Java System Application Server Platform Edition 8 installation.

  4. Proceed with the rest of the installation.

Restoring Domain Configuration

  1. Rename newly created install_dir/domains directory to install_dir/domains_new.
  2. Copy the backup domains directory from the backup location to the install_dir.

Starting a Domain

When you start a domain, you start its administration server and application server instance. Once the Application Server instance is started it runs constantly, listening for and accepting requests. Each domain must be started separately. To start a domain, use one of the following methods.

Starting the Domain Using the asadmin start-domain Command

To start a domain, you type the asadmin start-domain command and specify the domain name. For example, to start the default domain (domain1), you type the following:

asadmin start-domain domain1

If there is only one domain, you may omit the domain name. For the full command syntax, type asadmin help start-domain.

Starting the Domain Using the Windows Start Menu

On Windows, you can start the default domain by selecting Start Programs Sun Microsystems s Application Server Start Default Server.

Verifying the Upgraded Installation

To verify the upgraded installation, access applications which were deployed on the Application Server prior to installing Sun Java System Application Server Platform Edition 8 Upgrade 1.



Copyright 2004 Sun Microsystems, Inc. All rights reserved.