Sun Java logo     Previous      Contents      Next     

Sun logo
Sun Java System Application Server Platform Edition 8 Installation Guide 

Chapter  2
Upgrading an Application Server 7 Installation

You can use the upgrade wizard to transfer configuration information from a Sun Application Server version 7 Platform Edition (AS7.0PE) installation to a Sun Java System Application Server 8 Platform Edition installation. Information that is transferred includes data about deployed applications, the file realm, security certificates, and other resource and server configuration settings. The upgrade wizard can used in Graphical User Interface (GUI) mode or in Command Line Interface (CLI) mode.

You can start the upgrade wizard in GUI mode from the command line or from the desktop:

If you selected the Upgrade checkbox during the Application Server installation process, the wizard will automatically display after the installation completes.

Upgrading through the Wizard

From the Application Server Upgrade Wizard screen:

  1. In the Version 7.x Installation Directory field, enter the location of the Sun Application Server version 7.x Platform Edition installation from which to import the configuration.
  2. In the Application Server Installation Directory field, Enter the location of the Application Server installation to which you want to transfer the configuration.
  1. If you do not have any security certificates to transfer, click the Next button and continue with Step 8.
  2. If you have security certificates that must be transferred, check the Transfer Security Certificates checkbox, click the Next button and the Transfer Security Certificates screen displays.
  3. From the Transfer Security Certificates screen , press the Add Domain button to add domains with certificates to be transferred.
  4. From the Add Domain dialog, you select the domain name and the source and target certificate passwords:
    1. Click on the Source Domain pulldown and select the domain that contains the security certificates to migrate. .In the Passwords panel, enter the password for the Source Certificate File, which is used for NSS trusted database cert7.db and key3.db files.
    2. Enter the password for the Target User Key Database, which is used for the JSSE keystore.jks file that contains user keypair certificates.
    3. Enter the password for the Target Certificate Authority Database, which is used for the JSSE cacerts.jks file that contains certificate authority certificates.
    4. Click the OK button when done.
  5. Repeat Step 5 and Step 6 until you have added all the domains with certificates you want transferred. When you are done adding domains, click the Next button and continue with Step 8.
  6. The Upgrade Results screen displays, showing the status of the upgrade operation in the Results field.
  7. Click the Finish button to close the wizard when upgrading is done.

Upgrading through the Command Line

The Upgrade Wizard can also be run from the command line using the following syntax:

asupgrade [-c] [--help] --source S1AS7.x_installation
[--domain domain_name --nsspwdfile nss_pwd_file_path
--jkspwdfile jks_pwd_file_path --capwdfile ca_pwd_file]...

The following table describes the command options.

Table 1: Options of the asupgrade Tool




Command line utility will be invoked for upgrade


Installation root directory of the S1AS7.0 server


Installation root directory of the J2EE 1.4 Application Server


Destination domain name for migrated certificates


Path to NSS password file


Path to JKS password file


Path to CA certificate password file

Previous      Contents      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.