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:

To start the wizard in GUI mode from the command line, change to the install_dir/bin directory and type asupgrade.

On Windows, to start the wizard from the desktop, double-click the asupgrade icon in the install_dir/bin directory.

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

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.

In the Application Server Installation Directory field, Enter the location of the Application Server installation to which you want to transfer the configuration.

If you do not have any security certificates to transfer, click the Next button and continue with Step 8.

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.

From the Transfer Security Certificates screen , press the Add Domain button to add domains with certificates to be transferred.

From the Add Domain dialog, you select the domain name and the source and target certificate passwords:

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.

Enter the password for the Target User Key Database, which is used for the JSSE keystore.jks file that contains user keypair certificates.

Enter the password for the Target Certificate Authority Database, which is used for the JSSE cacerts.jks file that contains certificate authority certificates.

Click the OK button when done.

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.

The Upgrade Results screen displays, showing the status of the upgrade operation in the Results field.

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
--target J2EE1.4_installation
[--domain domain_name --nsspwdfile nss_pwd_file_path
--jkspwdfile jks_pwd_file_path --capwdfile ca_pwd_file]...

Table 1: Options of the asupgrade Tool
Option	Description
-c	Command line utility will be invoked for upgrade
--source	Installation root directory of the S1AS7.0 server
--target	Installation root directory of the J2EE 1.4 Application Server
--domain	Destination domain name for migrated certificates
--nsspwdfile	Path to NSS password file
--jkspwdfile	Path to JKS password file
--capwdfile	Path to CA certificate password file

Previous Contents Next
Sun Java System Application Server Platform Edition 8 Installation Guide