Upgrade Tool: An Overview

Use the Upgrade Tool to transfer configuration information from a Sun JavaTM System Application Server 7.x (formerly Sun ONETM Application Server 7.x) or a Sun Java System Application Server 8.x Platform Edition installation to a Sun Java System Application Server 8.1 Platform Edition or Enterprise Edition (hereafter called Application Server) installation. Information that is transferred includes data about deployed applications, the file realm, security certificates, and other resource and server configuration settings.

The following table shows supported Sun Java System Application Server upgrades, where PE indicates Platform Edition and EE indicates Enterprise Edition.


Target Installation
Source Installation
8.1 Platform Edition
8.1 Enterprise Edition
7.x PE
X
X
7.x SE

X
7.x EE

X
8.0 PE
X
X
8.1 PE

X

The tool automatically detects the version of the specified source server installation.

Note: Before starting the upgrade process, make sure that both the source server (the server from which you are upgrading) and the target server (the server to which you are upgrading) are stopped.

The Upgrade Tool can be used in Graphical User Interface (GUI) mode or in Command Line Interface (CLI) mode.

If the Upgrade checkbox was selected during the Application Server installation process, the Upgrade Wizard screen will automatically display after the installation completes.

From the Upgrade Wizard screen:

  1. In the Source Installation Directory field, enter the location of the Sun Java System Application Server 7 (formerly Sun ONETM Application Server 7) or Sun Java System Application Server 8.x installation from which to import the configuration.
  2. In the Target Installation Directory field, enter the location of the Application Server installation to which to transfer the configuration.

    If the upgrade wizard was started from the installation (the Upgrade from Previous Version checkbox was checked during the Application Server installation), the default value for this field will be the directory to which the Application Server software was just installed.

  3. If no security certificates need to be transferred, press the Next button and continue with Step 10 a Sun Java System Application Server 7.1 Enterprise Edition installation is being upgraded to Sun Java Systems Application Server 8.1 Enterprise Edition. All other upgrades without certificates continue with Step 12.
  4. If the source installation has security certificates that must be transferred, check the Transfer Security Certificates checkbox, press the Next button, and the Transfer Security Certificates screen displays.
  5. From the Transfer Security Certificates screen , press the Add Domain button to add domains with certificates to be transferred. The Add Domain dialog displays.
  6. From the Add Domain dialog, select the domain name that contains the security certificates to migrate and enter the appropriate passwords.
  7. Click the OK button when done. The Transfer Security Certificates screen will be redisplayed.
  8. Repeat Step 5 and Step 6 until all the domains that have certificates to be transferred have been added.
  9. After all of the domains that contain certificates to be transferred have been added, press the Next button and continue with Step 12 or with Step 10 cluster configuration information needs to be transferred.
  10. If a Sun Java Systems Application Server 7.1 Enterprise Edition installation with clusters is being upgraded to Sun Java Systems Application Server 8.1 Enterprise Edition, the Transfer Cluster Configurations screen will be displayed. Press the Add Cluster button to highlight the Cluster File Name field.
  11. Enter the cluster file name, which contains the cluster configuration information to be migrated. Repeat this process until all the cluster configuration files that need to be migrated have been added, then press the Next button.
  12. The Upgrade Results screen displays, showing the status of the upgrade operation in the Results field.
  13. Click the Finish button to close the Upgrade Tool when the upgrade process is complete.

Legal Notices